Debian Codegraph @

upstream/debian-unstable/man1/mkpasswd.1

raw
1 .TH MKPASSWD 1 "2019-12-30" "Marco d'Itri" "Debian GNU/Linux"
2 .SH NAME
3 mkpasswd \- Overfeatured front end to crypt(3)
4 .SH SYNOPSIS
5 .B mkpasswd
6 .I PASSWORD
7 .RI [ SALT ]
8 .SH DESCRIPTION
9 .B mkpasswd
10 encrypts the given password with the
11 .BR crypt (3)
12 libc function, using the given salt.
13 .SH OPTIONS
14 .TP
15 .BR \-S " STRING\fR, \fP" \-\-salt= \fISTRING\fP
16 Use the
17 .I STRING
18 as salt.
19 If it begins with
20 .I $
21 then it will be passed straight to
22 .BR crypt (3)
23 without any checks.
24 .TP
25 .BR \-R " NUMBER\fR, \fP" \-\-rounds= \fINUMBER\fP
26 Use
27 .I NUMBER
28 rounds.
29 This argument is ignored if the method chosen
30 does not support variable rounds.
31 For the OpenBSD Blowfish method this is
32 the logarithm of the number of rounds.
33 The behavior is undefined if this option is used without
34 .IR \-\-method .
35 .TP
36 .BR \-m " TYPE\fR, \fP" \-\-method= \fITYPE\fP
37 Compute the password using the
38 .I TYPE
39 method.
40 If
41 .I TYPE
42 is
43 .I help
44 then the list of available methods is printed.
45 If
46 .I TYPE
47 begins and end with
48 .I $
49 characters then the string is passed to
50 .BR crypt_gensalt (3)
51 as-is.
52 .TP
53 .B \-5
54 Like
55 .IR \-\-method=md5crypt .
56 .TP
57 .BI \-P " NUM\fR, \fP" \-\-password-fd= NUM
58 Read the password from file descriptor
59 .I NUM
60 instead of using
61 .BR getpass (3).
62 If the file descriptor is not connected to a tty then no other text
63 than the hashed password is printed on stdout.
64 .TP
65 .BR \-s ", " \-\-stdin
66 Like
67 .IR \-\-password-fd=0 .
68 .SH ENVIRONMENT
69 .IP "MKPASSWD_OPTIONS"
70 A list of options which will be evaluated before the ones specified on the
71 command line.
72 .SH BUGS
73 If the
74 .I \-\-stdin
75 option is used then passwords containing some control
76 characters may not be read correctly.
77 .P
78 This program suffers of a bad case of featuritis.
79 .SH "SEE ALSO"
80 .BR passwd (1),
81 .BR passwd (5),
82 .BR crypt (3),
83 .BR crypt (5),
84 .BR crypt_gensalt (3),
85 .BR getpass (3).
86 .SH AUTHOR
87 .B mkpasswd
88 and this man page were written by Marco d'Itri
89 .RI < [email protected] >
90 and are licensed under the terms of the GNU General Public License,
91 version 2 or later.
92 .\" SPDX-License-Identifier: GPL-2.0-or-later