.\" $Id: epass.man,v 1.7 2012/02/29 18:45:19 ksb Exp $
.\" ksb's manual page for epass
.\" $Compile: Display%h
.\" $Display: ${groff:-groff} -Tascii -man %f | ${PAGER:-less}
.\" $Display(*): ${groff:-groff} -T%s -man %f
.\" $Install: %b -mDeinstall %o %f && cp %f $DESTDIR/usr/local/man/man1/epass.1
.\" $Deinstall: ${rm-rm} -f $DESTDIR/usr/local/man/[cm]a[nt]1/epass.1*
.TH EPASS 1 LOCAL
.SH NAME
epass - convert a password to a encrypted token
.SH SYNOPSIS
.ds PN "epass
\fI\*(PN\fP \fIpassword\fP [\fIsalt\fP]
.br
\fI\*(PN\fP \fB\-h\fP
.br
\fI\*(PN\fP \fB\-V\fP

.SH DESCRIPTION
This program is used in scripts when building accounts or the like.
.PP
The char* positional parameter \fIpassword\fP
provides the plain text password to encrypt.
The string positional parameter \fIsalt\fP
forces a specific two character salt for the encrypted password.
.PP
The \fIsalt\fP parameter defaults to a random value selected as a
function of the process id of the \fBepass\fP process.
.SH OPTIONS
If the program is called as \fI\*(PN\fP then no options are forced.
.TP
\fB\-h\fP
Print a brief help message.
.TP
\fB\-V\fP
Show version information.

.SH EXAMPLES
.TP
epass mmIsaB0b
Generate a encrypted token for the password whose mnemonic is "mm is a bob".
.TP
epass mmIsaB0b l7
Generate the same password's token with a forced salt of "l7".

.SH BUGS
None known.
.SH AUTHORS
K S Brausdorf, Mike MacKenzie
.br
SAC UNIX Support
.br
ksb@sac.fedex.com, mm@sac.fedex.com

.SH "SEE ALSO"
.hlm 0
sh(1), passwd(1)