Import OpenSSL-0.9.8i.
[dragonfly.git] / crypto / openssl-0.9.7e / doc / apps / passwd.pod
blobf44982549bf1a2d22fb2516998277e4346350c3f
1 =pod
3 =head1 NAME
5 passwd - compute password hashes
7 =head1 SYNOPSIS
9 B<openssl passwd>
10 [B<-crypt>]
11 [B<-1>]
12 [B<-apr1>]
13 [B<-salt> I<string>]
14 [B<-in> I<file>]
15 [B<-stdin>]
16 [B<-noverify>]
17 [B<-quiet>]
18 [B<-table>]
19 {I<password>}
21 =head1 DESCRIPTION
23 The B<passwd> command computes the hash of a password typed at
24 run-time or the hash of each password in a list.  The password list is
25 taken from the named file for option B<-in file>, from stdin for
26 option B<-stdin>, or from the command line, or from the terminal otherwise.
27 The Unix standard algorithm B<crypt> and the MD5-based BSD password
28 algorithm B<1> and its Apache variant B<apr1> are available.
30 =head1 OPTIONS
32 =over 4
34 =item B<-crypt>
36 Use the B<crypt> algorithm (default).
38 =item B<-1>
40 Use the MD5 based BSD password algorithm B<1>.
42 =item B<-apr1>
44 Use the B<apr1> algorithm (Apache variant of the BSD algorithm).
46 =item B<-salt> I<string>
48 Use the specified salt.
49 When reading a password from the terminal, this implies B<-noverify>.
51 =item B<-in> I<file>
53 Read passwords from I<file>.
55 =item B<-stdin>
57 Read passwords from B<stdin>.
59 =item B<-noverify>
61 Don't verify when reading a password from the terminal.
63 =item B<-quiet>
65 Don't output warnings when passwords given at the command line are truncated.
67 =item B<-table>
69 In the output list, prepend the cleartext password and a TAB character
70 to each password hash.
72 =back
74 =head1 EXAMPLES
76 B<openssl passwd -crypt -salt xx password> prints B<xxj31ZMTZzkVA>.
78 B<openssl passwd -1 -salt xxxxxxxx password> prints B<$1$xxxxxxxx$UYCIxa628.9qXjpQCjM4a.>.
80 B<openssl passwd -apr1 -salt xxxxxxxx password> prints B<$apr1$xxxxxxxx$dxHfLAsjHkDRmG83UXe8K0>.
82 =cut