Imported Upstream version 0.63.0
[hcoop/debian/courier-authlib.git] / authpasswd.1
1 .\" <!-- $Id: authpasswd.sgml,v 1.6 2008/12/06 14:31:51 mrsam Exp $ -->
2 .\" <!-- Copyright 2004-2008 Double Precision, Inc. See COPYING for -->
3 .\" <!-- distribution information. -->
4 .\" Title: authpasswd
5 .\" Author:
6 .\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
7 .\" Date: 12/06/2008
8 .\" Manual: Double Precision, Inc.
9 .\" Source: Double Precision, Inc.
10 .\"
11 .TH "AUTHPASSWD" "1" "12/06/2008" "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 generates 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 a base64\-encoded
48 MD5
49 password hash\.
50 .RE
51 .PP
52 md5raw
53 .RS 4
54 Compute a hexadecimal\-encoded
55 MD5
56 password hash\.
57 .RE
58 .PP
59 sha1
60 .RS 4
61 Compute a
62 SHA1
63 password hash\.
64 .RE
65 .PP
66 ssha
67 .RS 4
68 Compute a salted
69 SHA1
70 password hash\.
71 .RE
72 .PP
73 sha256
74 .RS 4
75 Compute a
76 SHA256
77 password hash\.
78 .RE
79 .PP
80 If not specified,
81 \fImethod\fR
82 defaults to the modified\-MD5
83 password encryption algorithm that\'s used in Linux (note that this is different from the
84 \(lqmd5\(rq
85 password hash method)\.