Commit | Line | Data |
---|---|---|
920dae64 AT |
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 |