manual/expect/original/man1/mkpasswd.1

   1 .TH MKPASSWD 1 "22 August 1994"
   2 .SH NAME
   3 mkpasswd \- generate new password, optionally apply it to a user
   4 .SH SYNOPSIS
   5 .B mkpasswd
   6 .I
   7 [
   8 .I args
   9 ]
  10 [
  11 .I user
  12 ]
  13 .SH INTRODUCTION
  14 .B mkpasswd
  15 generates passwords and can apply them automatically to users.
  16 mkpasswd is based on the code from Chapter 23 of the O'Reilly book
  17 "Exploring Expect".
  18 .SH USAGE
  19 With no arguments,
  20 .B mkpasswd
  21 returns a new password.
  22
  23         mkpasswd
  24
  25 With a user name,
  26 .B mkpasswd
  27 assigns a new password to the user.
  28
  29         mkpasswd don
  30
  31 The passwords are randomly generated according to the flags below.
  32
  33 .SH FLAGS
  34 The
  35 .B \-l
  36 flag defines the length of the password.  The default is 9.
  37 The following example creates a 20 character password.
  38
  39         mkpasswd -l 20
  40
  41 The
  42 .B \-d
  43 flag defines the minimum number of digits that must be in the password.
  44 The default is 2.  The following example creates a password with at least
  45 3 digits.
  46
  47         mkpasswd -d 3
  48
  49 The
  50 .B \-c
  51 flag defines the minimum number of lowercase alphabetic characters that must be in the password.
  52 The default is 2.
  53
  54 The
  55 .B \-C
  56 flag defines the minimum number of uppercase alphabetic characters that must be in the password.
  57 The default is 2.
  58
  59 The
  60 .B \-s
  61 flag defines the minimum number of special characters that must be in the password.
  62 The default is 1.
  63
  64 The
  65 .B \-p
  66 flag names a program to set the password.
  67 By default, /etc/yppasswd is used if present, otherwise /bin/passwd is used.
  68
  69 The
  70 .B \-2
  71 flag causes characters to be chosen so that they alternate between
  72 right and left hands (qwerty-style), making it harder for anyone
  73 watching passwords being entered.  This can also make it easier for
  74 a password-guessing program.
  75
  76 The
  77 .B \-v
  78 flag causes the password-setting interaction to be visible.
  79 By default, it is suppressed.
  80
  81 .SH EXAMPLE
  82 The following example creates a 15-character password
  83 that contains at least 3 digits and 5 uppercase characters.
  84
  85         mkpasswd -l 15 -d 3 -C 5
  86
  87 .SH SEE ALSO
  88 .I
  89 "Exploring Expect: A Tcl-Based Toolkit for Automating Interactive Programs"
  90 \fRby Don Libes,
  91 O'Reilly and Associates, January 1995.
  92 .SH AUTHOR
  93 Don Libes, National Institute of Standards and Technology
  94
  95 .B mkpasswd
  96 is in the public domain.
  97 NIST and I would
  98 appreciate credit if this program or parts of it are used.
  99
 100