| 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 |