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 \-c, --capitalize
   29 Include at least one capital letter in the password.
   30 .TP
   31 .B \-l, --lower
   32 Include at least one lower case letter in the password.
   33 .TP
   34 .B \-n, --numerals
   35 Include at least one number in the password.
   36 .TP
   37 .B \-y, --symbols
   38 Include at least one special character in the password. 
   39 .TP
   40 .B \-1
   41 Include chars from the most used scripts in the world
   42 .TP
   43 .B \-2
   44 Include chars from the second most used scripts in the world
   45 .TP
   46 .B \-3
   47 Include chars from the third most used scripts in the world
   48 .TP
   49 .B \-4
   50 Include chars from the forth most used scripts in the world
   51 .TP
   52 .B \-i, --i18n
   53 Include all supported international characters (same as -1 -2 -3 -4)
   54 .TP
   55 .B \-h, --help
   56 Print the help text
   57 .TP
   58 .B \-V, --version
   59 Print the version
   60 .TP
   61 .B \-d, --debug
   62 Enable debug mode (prints entire selected character pool)
   63 .SH AUTHOR
   64 .B Upwgen
   65 was written by Aaron Ball <nullspoon@oper.io>.  
   66 It is modelled after pwgen, a program written by Theodore Ts'o.
   67 .SH SEE ALSO
   68 .BR passwd (1)
   69 .BR pwgen (1)