Annotation of src/usr.bin/encrypt/encrypt.1, Revision 1.12
1.12 ! aaron 1: .\" $OpenBSD: encrypt.1,v 1.11 1999/06/05 01:21:23 aaron Exp $
1.1 downsj 2: .\"
3: .\" Copyright (c) 1996, Jason Downs. All rights reserved.
4: .\"
5: .\" Redistribution and use in source and binary forms, with or without
6: .\" modification, are permitted provided that the following conditions
7: .\" are met:
8: .\" 1. Redistributions of source code must retain the above copyright
9: .\" notice, this list of conditions and the following disclaimer.
10: .\" 2. Redistributions in binary form must reproduce the above copyright
11: .\" notice, this list of conditions and the following disclaimer in the
12: .\" documentation and/or other materials provided with the distribution.
13: .\"
14: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR(S) ``AS IS'' AND ANY EXPRESS
15: .\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
16: .\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
17: .\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR(S) BE LIABLE FOR ANY DIRECT,
18: .\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
19: .\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
20: .\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
21: .\" CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
22: .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
23: .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
24: .\" SUCH DAMAGE.
25: .\"
1.10 alex 26: .Dd May 18, 1999
1.1 downsj 27: .Dt ENCRYPT 1
1.11 aaron 28: .Os
1.1 downsj 29: .Sh NAME
30: .Nm encrypt
1.4 downsj 31: .Nd encrypt passwords from the command line or standard input
1.1 downsj 32: .Sh SYNOPSIS
33: .Nm encrypt
1.4 downsj 34: .Op Fl k
1.5 provos 35: .Op Fl b Ar rounds
1.1 downsj 36: .Op Fl m
37: .Op Fl s Ar salt
1.10 alex 38: .Op Fl p | Ar string
1.4 downsj 39: .Nm makekey
1.1 downsj 40: .Sh DESCRIPTION
1.12 ! aaron 41: .Nm
1.1 downsj 42: prints the encrypted form of
43: .Ar string
44: to the standard output. This is mostly useful for encrypting passwords
1.4 downsj 45: from within scripts.
1.1 downsj 46: .Pp
47: The following options are supported:
1.5 provos 48: .Bl -tag -width XxXXXXXXX
1.4 downsj 49: .It Fl k
50: Run in
51: .Nm makekey
52: compatible mode; a single combined key and salt are read from standard
53: input and the DES encrypted result is written to standard output without a
54: terminating newline.
1.5 provos 55: .It Fl b Ar rounds
56: Encrypt the string using Blowfish hashing with the specified
57: .Ar rounds .
1.1 downsj 58: .It Fl m
59: Encrypt the string using MD5.
1.10 alex 60: .It Fl p
61: Prompt for a single string with echo turned off.
1.1 downsj 62: .It Fl s Ar salt
63: Encrypt the string using DES, with the specified
64: .Ar salt .
65: .El
66: .Pp
67: If no
68: .Ar string
69: is specified,
1.12 ! aaron 70: .Nm
1.7 deraadt 71: reads one string per line from standard input, encrypting each one
1.5 provos 72: with the chosen algorithm from above. In case that no specific algorithm
1.8 aaron 73: was given as a command line option, the default will be looked up from
1.9 aaron 74: .Pa /etc/passwd.conf .
1.5 provos 75: .Pp
76: For MD5 and Blowfish a new random salt is automatically generated for each
77: password.
78: .Pp
1.11 aaron 79: Specifying the
1.3 downsj 80: .Ar string
81: on the command line should be discouraged; using the
82: standard input is more secure.
1.5 provos 83: .Sh FILES
84: .Bl -tag -width /etc/passwd.conf -compact
85: .It Pa /etc/passwd.conf
86: .El
1.1 downsj 87: .Sh SEE ALSO
1.5 provos 88: .Xr crypt 3 ,
1.8 aaron 89: .Xr pw_getconf 3 ,
90: .Xr passwd.conf 5
1.1 downsj 91: .Sh HISTORY
1.12 ! aaron 92: .Nm
1.6 millert 93: first appeared in
94: .Ox 1.2 .
1.4 downsj 95: .Pp
96: A
97: .Nm makekey
1.11 aaron 98: command appeared in
1.4 downsj 99: .At v7 .