doc/upwgen.1



    1 .TH UPWGEN 1 "{{ RELDATE }}" "pwgen version {{ VERSTR }}"
    2 .SH NAME
    3 upwgen \- generate international (utf-8) passwords
    4 .SH SYNOPSIS
    5 .B upwgen
    6 [
    7 .I OPTIONS
    8 ]
    9 [
   10 .I pw_length
   11 ]
   12 .SH DESCRIPTION
   13 The
   14 .B upwgen
   15 program generates passwords which include international characters,
   16 significantly increasing password complexity. These passwords are not only
   17 designed to be difficult to memorize, but are also nearly impossible to type as
   18 they will usually span multiple character sets, requiring multiple keyboard
   19 locales. By design, the passwords generated by upwgen are intended to be copied
   20 and pasted.
   21 
   22 The default mode of operation if no arguments are specified is to print a
   23 password of 32 characters long, selected from the printable English ascii
   24 character pool (94 characters total).
   25 .B
   26 .SH OPTIONS
   27 .TP
   28 .B \-0,--no-numerals
   29 Include at least one numeral in the password
   30 .TP
   31 .B \-A,--no-capitalize
   32 Include at least one numeral in the password
   33 .TP
   34 .B \-c, --capitalize
   35 Include at least one capital letter in the password.
   36 .TP
   37 .B \-l, --lower
   38 Include at least one lower case letter in the password.
   39 .TP
   40 .B \-n, --numerals
   41 Include at least one number in the password.
   42 .TP
   43 .B \-y, --symbols
   44 Include at least one special character in the password. 
   45 .TP
   46 .B \-1
   47 Include chars from the most used scripts in the world
   48 .TP
   49 .B \-2
   50 Include chars from the second most used scripts in the world
   51 .TP
   52 .B \-3
   53 Include chars from the third most used scripts in the world
   54 .TP
   55 .B \-4
   56 Include chars from the forth most used scripts in the world
   57 .TP
   58 .B \-i, --i18n
   59 Include all supported international characters (same as -1 -2 -3 -4)
   60 .TP
   61 .B \-h, --help
   62 Print the help text
   63 .TP
   64 .B \-V, --version
   65 Print the version
   66 .TP
   67 .B \-d, --debug
   68 Enable debug mode (prints entire selected character pool)
   69 .SH AUTHOR
   70 .B Upwgen
   71 was written by Aaron Ball <nullspoon@oper.io>.  
   72 It is modelled after pwgen, a program written by Theodore Ts'o.
   73 .SH SEE ALSO
   74 .BR passwd (1)
   75 .BR pwgen (1)