release

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

.\"  <!-- $Id: authpasswd.sgml,v 1.6 2008/12/06 14:31:51 mrsam Exp $ -->
.\"  <!-- Copyright 2004-2008 Double Precision, Inc.  See COPYING for -->
.\"  <!-- distribution information. -->
.\"     Title: authpasswd
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.73.2 <http://docbook.sf.net/>
.\"      Date: 12/06/2008
.\"    Manual: Double Precision, Inc.
.\"    Source: Double Precision, Inc.
.\"
.TH "AUTHPASSWD" "1" "12/06/2008" "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 generates 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 a base64\-encoded
MD5
password hash\.
.RE
.PP
md5raw
.RS 4
Compute a hexadecimal\-encoded
MD5
password hash\.
.RE
.PP
sha1
.RS 4
Compute a
SHA1
password hash\.
.RE
.PP
ssha
.RS 4
Compute a salted
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)\.