• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1=pod
2
3=head1 NAME
4
5openssl-passwd,
6passwd - compute password hashes
7
8=head1 SYNOPSIS
9
10B<openssl passwd>
11[B<-help>]
12[B<-crypt>]
13[B<-1>]
14[B<-apr1>]
15[B<-aixmd5>]
16[B<-5>]
17[B<-6>]
18[B<-salt> I<string>]
19[B<-in> I<file>]
20[B<-stdin>]
21[B<-noverify>]
22[B<-quiet>]
23[B<-table>]
24[B<-rand file...>]
25[B<-writerand file>]
26{I<password>}
27
28=head1 DESCRIPTION
29
30The B<passwd> command computes the hash of a password typed at
31run-time or the hash of each password in a list.  The password list is
32taken from the named file for option B<-in file>, from stdin for
33option B<-stdin>, or from the command line, or from the terminal otherwise.
34
35=head1 OPTIONS
36
37=over 4
38
39=item B<-help>
40
41Print out a usage message.
42
43=item B<-crypt>
44
45Use the B<crypt> algorithm (default).
46
47=item B<-1>
48
49Use the MD5 based BSD password algorithm B<1>.
50
51=item B<-apr1>
52
53Use the B<apr1> algorithm (Apache variant of the BSD algorithm).
54
55=item B<-aixmd5>
56
57Use the B<AIX MD5> algorithm (AIX variant of the BSD algorithm).
58
59=item B<-5>
60
61=item B<-6>
62
63Use the B<SHA256> / B<SHA512> based algorithms defined by Ulrich Drepper.
64See L<https://www.akkadia.org/drepper/SHA-crypt.txt>.
65
66=item B<-salt> I<string>
67
68Use the specified salt.
69When reading a password from the terminal, this implies B<-noverify>.
70
71=item B<-in> I<file>
72
73Read passwords from I<file>.
74
75=item B<-stdin>
76
77Read passwords from B<stdin>.
78
79=item B<-noverify>
80
81Don't verify when reading a password from the terminal.
82
83=item B<-quiet>
84
85Don't output warnings when passwords given at the command line are truncated.
86
87=item B<-table>
88
89In the output list, prepend the cleartext password and a TAB character
90to each password hash.
91
92=item B<-rand file...>
93
94A file or files containing random data used to seed the random number
95generator.
96Multiple files can be specified separated by an OS-dependent character.
97The separator is B<;> for MS-Windows, B<,> for OpenVMS, and B<:> for
98all others.
99
100=item [B<-writerand file>]
101
102Writes random data to the specified I<file> upon exit.
103This can be used with a subsequent B<-rand> flag.
104
105=back
106
107=head1 EXAMPLES
108
109  % openssl passwd -crypt -salt xx password
110  xxj31ZMTZzkVA
111
112  % openssl passwd -1 -salt xxxxxxxx password
113  $1$xxxxxxxx$UYCIxa628.9qXjpQCjM4a.
114
115  % openssl passwd -apr1 -salt xxxxxxxx password
116  $apr1$xxxxxxxx$dxHfLAsjHkDRmG83UXe8K0
117
118  % openssl passwd -aixmd5 -salt xxxxxxxx password
119  xxxxxxxx$8Oaipk/GPKhC64w/YVeFD/
120
121=head1 COPYRIGHT
122
123Copyright 2000-2021 The OpenSSL Project Authors. All Rights Reserved.
124
125Licensed under the OpenSSL license (the "License").  You may not use
126this file except in compliance with the License.  You can obtain a copy
127in the file LICENSE in the source distribution or at
128L<https://www.openssl.org/source/license.html>.
129
130=cut
131