'\" t .\" Title: dk-pwgen .\" Author: [see the "AUTHOR" section] .\" Generator: DocBook XSL Stylesheets v1.78.1 .\" Date: 02/08/2017 .\" Manual: \ \& .\" Source: \ \& .\" Language: English .\" .TH "DK\-PWGEN" "1" "02/08/2017" "\ \&" "\ \&" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" dk-pwgen \- Password, pin, hexadecimal key generator .SH "SYNOPSIS" .sp \fBdk\-pwgen\fR [\fIoptions\fR] .SH "DESCRIPTION" .sp The dk\-pwgen program generates passwords, pins or hexadecimal keys (i\&.e\&. used for WiFi)\&. The output type is one of the following: .PP \fBNormal user password\fR .RS 4 This is the default output type\&. Specify a range (or just a value) for password length, number of uppercase characters in the password, number of digits in the password and number of special characters in the password\&. The minimum password length must be at least the summary of uppercase, digits and special character maximum\&. .RE .PP \fBHard password\fR .RS 4 Use \-h to switch to hard passwords and specify the length (either value or range)\&. Characters are choosen in the range 0x33 to 0x7A (\*(Aq!\*(Aq to \*(Aqz\*(Aq)\&. .RE .PP \fBBinary random data\fR .RS 4 Use \-b to switch to binary data output and specify the length (either value or range)\&. This option is not available on Windows systems, use the dk\-rand program instead\&. .RE .PP \fBPin number\fR .RS 4 Use \-p to switch to pin numbers and specify the length (either value or range)\&. .RE .PP \fBHexadecimal key\fR .RS 4 Use \-x or \-X to switch to hexadecimal keys and specify the length (either value or range)\&. .RE .SH "OPTIONS" .PP \fB\-h\fR, \fB\-\-hard\fR .RS 4 Hard password instead of normal user passwords\&. .RE .PP \fB\-b\fR, \fB\-\-binary\fR .RS 4 Binary output instead of text output\&. This option is not available on Windows, use the dk\-rand program instead\&. .RE .PP \fB\-x\fR, \fB\-\-hex\fR .RS 4 Hexadecimal key using \*(Aqa\*(Aq \&... \*(Aqf\*(Aq for 10 \&... 15\&. .RE .PP \fB\-X\fR, \fB\-\-Hex\fR .RS 4 Hexadecimal key using \*(AqA\*(Aq \&... \*(AqF\*(Aq for 10 \&... 15\&. .RE .PP \fB\-p\fR, \fB\-\-pin\fR .RS 4 PIN number\&. .RE .PP \fB\-l\fR \fIrange\fR, \fB\-\-length=\fR\fIrange\fR .RS 4 Output length\&. Ranges are specified as \fImin\fR\-\fImax\fR, i\&.e\&. "6\-8"\&. .RE .PP \fB\-u\fR \fIrange\fR, \fB\-\-upper\-case=\fR\fIrange\fR .RS 4 Number of upper case characters for normal user passwords\&. .RE .PP \fB\-d\fR \fIrange\fR, \fB\-\-digits=\fR\fIrange\fR .RS 4 Number of digits for normal user passwords\&. .RE .PP \fB\-s\fR \fIrange\fR, \fB\-\-special=\fR\fIrange\fR .RS 4 Number of special characters for normal user passwords\&. .RE .PP \fB\-n\fR, \fB\-\-no\-newline\fR .RS 4 Suppress newline at end of output\&. .RE .PP \fB\-\-verbose\fR .RS 4 Show error message upon interrupt by SIGPIPE\&. .RE .SH "EXIT STATUS" .sp The program returns exit status code 0 on success, all other values indicate errors\&. .SH "NOTES" .sp This program uses DK libraries version 4\&. .SH "EXAMPLES" .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Create normal user password, 8 to 10 characters long, containing 1 to 3 upper case characters, 1 to 2 digits and 1 to 2 special characters: .sp dk\-pwgen \-l 8\-10 \-u 1\-3 \-d 1\-2 \-s 1\-2 .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Create a harder password, 8 to 10 characters long: .sp dk\-pwgen \-h \-l 8\-10 .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Create a numeric PIN, 6 characters long: .sp dk\-pwgen \-p \-l 6 .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Create a hexadecimal key for WiFi, 64 characters long: .sp dk\-pwgen \-x \-l 64 .RE .SH "AUTHOR" .sp Dirk Krause .SH "COPYRIGHT AND LICENSE" .sp Copyright (c) 2015\-2016, Dirk Krause .sp All rights reserved\&. .sp Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution\&. .RE .sp .RS 4 .ie n \{\ \h'-04'\(bu\h'+03'\c .\} .el \{\ .sp -1 .IP \(bu 2.3 .\} Neither the name of the copyright holder(s) nor the names of contributors may be used to endorse or promote products derived from this software without specific prior written permission\&. .RE .sp THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \(lqAS IS\(rq AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED\&. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE\&. .sp This product includes software developed by the OpenSSL Project for use in the OpenSSL Toolkit (http://www\&.openssl\&.org/)\&. This product includes cryptographic software written by Eric Young (eay@cryptsoft\&.com)\&. This product includes software written by Tim Hudson (tjh@cryptsoft\&.com)\&. .SH "SEE ALSO" .PP http://dktools\&.sourceforge\&.net .RS 4 Project homepage\&. .RE