.Dd $Mdocdate$
.Dt pw 1
.Os
.Sh NAME
.Nm pw
.Nd Password generator
.\" .Sh LIBRARY
.\" For sections 2, 3, and 9	only.
.\" Not used in OpenBSD.
.Sh SYNOPSIS
.Nm
.Fl h | v
.Nm
.Op Fl d
.Op Fl l
.Op Fl u
.Op Fl s
.Op Fl c Ar length
.Sh DESCRIPTION
The
.Nm
command generates a random password and prints it on the standard output.
If no flags for specifying which characters are allowed are given,
.Nm
acts as if all had been specified.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl h, \-help
Print help text and exit.
.It Fl \-version
Print version info and exit.
.It Fl d, \-digit
Allow digits.
.It Fl l, \-lower
Allow lower case letters.
.It Fl u, \-upper
Allow upper case letters.
.It Fl s, \-symbol
Allow symbols and punctuation form the following list: _-=+<>,.!@#$%^&*.
.It Fl c Ar length
Specify the password length.
Default is 24 characters.
.El
.\" .Sh CONTEXT
.\" For section 9 functions only.
.\" .Sh IMPLEMENTATION NOTES
.\" Not used in OpenBSD.
.\" .Sh RETURN VALUES
.\" For sections 2, 3, and 9 function return values only.
.\" .Sh ENVIRONMENT
.\" For sections 1, 6, 7, and 8 only.
.\" .Sh FILES
.Sh EXIT STATUS
.\" For sections 1, 6, and 8 only.
.Nm
exits 0 on success, and 1 if an error occurs.
.\" .Sh EXAMPLES
.\" .Sh DIAGNOSTICS
.\" For sections 1, 4, 6, 7, 8, and 9 printf/stderr messages only.
.\" .Sh ERRORS
.\" For sections 2, 3, 4, and 9 errno settings only.
.\" .Sh SEE ALSO
.\" .Xr foobar 1
.\" .Sh STANDARDS
.\" .Sh HISTORY
.Sh AUTHORS
Bob Polis
.\" .Sh CAVEATS
.\" .Sh BUGS
.\" .Sh SECURITY CONSIDERATIONS
.\" Not used in OpenBSD.