Imported Debian patch 0.59.3-1
[hcoop/debian/courier-authlib.git] / authpasswd.1
1 .\" <!-- $Id: authpasswd.sgml,v 1.4 2007/04/22 15:05:16 mrsam Exp $ -->
2 .\" <!-- Copyright 2004 Double Precision, Inc. See COPYING for -->
3 .\" <!-- distribution information. -->
4 .\" Title: authpasswd
5 .\" Author:
6 .\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
7 .\" Date: 04/22/2007
8 .\" Manual: Double Precision, Inc.
9 .\" Source: Double Precision, Inc.
10 .\"
11 .TH "AUTHPASSWD" "1" "04/22/2007" "Double Precision, Inc." "Double Precision, Inc."
12 .\" disable hyphenation
13 .nh
14 .\" disable justification (adjust text to left margin only)
15 .ad l
16 .SH "NAME"
17 authpasswd \- Generate login passwords
18 .SH "SYNOPSIS"
19 .HP 11
20 \fBauthpasswd\fR [method]
21 .SH "DESCRIPTION"
22 .PP
23
24 \fBauthpasswd\fR
25 is a helper utility that generated encrypted passwords for the Courier authentication library. The Courier authentication library is capable of using several different encryption methods for storing passwords.
26 \fBauthpasswd\fR
27 issues a password prompt. Enter the same password twice (for verification purposes).
28 \fBauthpasswd\fR
29 computes and prints the encrypted password. The encrypted password can be inserted verbatim into the appropriate account record that's processed by the authentication library's
30 authmysql,
31 authpgsql, or
32 authldap
33 module.
34 .PP
35
36 \fImethod\fR
37 may be set to one of the following literals:
38 .PP
39 crypt
40 .RS 4
41 Use the traditional
42 DES\-based encrypted password.
43 .RE
44 .PP
45 md5
46 .RS 4
47 Compute an
48 MD5
49 password hash.
50 .RE
51 .PP
52 sha1
53 .RS 4
54 Compute a
55 SHA1
56 password hash.
57 .RE
58 .PP
59 sha256
60 .RS 4
61 Compute a
62 SHA256
63 password hash.
64 .RE
65 .PP
66 If not specified,
67 \fImethod\fR
68 defaults to the modified\-MD5
69 password encryption algorithm that's used in Linux (note that this is different from the
70 \(lqmd5\(rq
71 password hash method).