passwd.pod revision 325337 
1=pod
2
3=head1 NAME
4
5openssl-passwd,
6passwd - compute password hashes
7
8=head1 SYNOPSIS
9
10B<openssl passwd>
11[B<-crypt>]
12[B<-1>]
13[B<-apr1>]
14[B<-salt> I<string>]
15[B<-in> I<file>]
16[B<-stdin>]
17[B<-noverify>]
18[B<-quiet>]
19[B<-table>]
20{I<password>}
21
22=head1 DESCRIPTION
23
24The B<passwd> command computes the hash of a password typed at
25run-time or the hash of each password in a list.  The password list is
26taken from the named file for option B<-in file>, from stdin for
27option B<-stdin>, or from the command line, or from the terminal otherwise.
28The Unix standard algorithm B<crypt> and the MD5-based BSD password
29algorithm B<1> and its Apache variant B<apr1> are available.
30
31=head1 OPTIONS
32
33=over 4
34
35=item B<-crypt>
36
37Use the B<crypt> algorithm (default).
38
39=item B<-1>
40
41Use the MD5 based BSD password algorithm B<1>.
42
43=item B<-apr1>
44
45Use the B<apr1> algorithm (Apache variant of the BSD algorithm).
46
47=item B<-salt> I<string>
48
49Use the specified salt.
50When reading a password from the terminal, this implies B<-noverify>.
51
52=item B<-in> I<file>
53
54Read passwords from I<file>.
55
56=item B<-stdin>
57
58Read passwords from B<stdin>.
59
60=item B<-noverify>
61
62Don't verify when reading a password from the terminal.
63
64=item B<-quiet>
65
66Don't output warnings when passwords given at the command line are truncated.
67
68=item B<-table>
69
70In the output list, prepend the cleartext password and a TAB character
71to each password hash.
72
73=back
74
75=head1 EXAMPLES
76
77B<openssl passwd -crypt -salt xx password> prints B<xxj31ZMTZzkVA>.
78
79B<openssl passwd -1 -salt xxxxxxxx password> prints B<$1$xxxxxxxx$UYCIxa628.9qXjpQCjM4a.>.
80
81B<openssl passwd -apr1 -salt xxxxxxxx password> prints B<$apr1$xxxxxxxx$dxHfLAsjHkDRmG83UXe8K0>.
82
83=cut
84