[hcoop/debian/courier-authlib.git] / authpasswd.1

.\"  <!-- $Id: authpasswd.sgml,v 1.4 2007/04/22 15:05:16 mrsam Exp $ -->
.\"  <!-- Copyright 2004 Double Precision, Inc.  See COPYING for -->
.\"  <!-- distribution information. -->
.\"     Title: authpasswd
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.72.0 <http://docbook.sf.net/>
.\"      Date: 04/22/2007
.\"    Manual: Double Precision, Inc.
.\"    Source: Double Precision, Inc.
.\"
.TH "AUTHPASSWD" "1" "04/22/2007" "Double Precision, Inc." "Double Precision, Inc."
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
authpasswd \- Generate login passwords
.SH "SYNOPSIS"
.HP 11
\fBauthpasswd\fR [method]
.SH "DESCRIPTION"
.PP

\fBauthpasswd\fR
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.
\fBauthpasswd\fR
issues a password prompt. Enter the same password twice (for verification purposes).
\fBauthpasswd\fR
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
authmysql,
authpgsql, or
authldap
module.
.PP

\fImethod\fR
may be set to one of the following literals:
.PP
crypt
.RS 4
Use the traditional
DES\-based encrypted password.
.RE
.PP
md5
.RS 4
Compute an
MD5
password hash.
.RE
.PP
sha1
.RS 4
Compute a
SHA1
password hash.
.RE
.PP
sha256
.RS 4
Compute a
SHA256
password hash.
.RE
.PP
If not specified,
\fImethod\fR
defaults to the modified\-MD5
password encryption algorithm that's used in Linux (note that this is different from the
\(lqmd5\(rq
password hash method).
Commit	Line	Data
d9898ee8	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).