.\" Copyright (c) 2021 Stefan Kreutz <mail@skreutz.com>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.Dd $Mdocdate: October 12 2021 $
.Dt JOTPASS 1
.Os
.Sh NAME
.Nm jotpass
.Nd Print readable random passwords
.Sh SYNOPSIS
.Nm jotpass
.Op Fl v
.Op Fl a Ar alphabet
.Op Fl g Ar groups
.Op Fl w Ar width
.Op Fl s Ar separator
.Sh DESCRIPTION
The
.Nm
utility facilitates generating random passwords suitable for handwriting.
.Pp
The options are as follows:
.Bl -tag -width Ds
.It Fl v
Enable verbose mode.
Causes
.Nm
to print the entropy of the generated password to standard error.
.It Fl a Ar alphabet
Draw characters from the given
.Ar alphabet .
Defaults to alphanumeric ASCII characters, excluding 01klnuvIO
to improve legibility.
.It Fl g Ar groups
Set the number of
.Ar groups .
Defaults to 12.
.It Fl w Ar width
Set the
.Ar width
of the groups.
Defaults to 4 characters.
.It Fl s Ar separator
Set the group
.Ar separator
character.
Defaults to dash (-).
.El
.Sh EXIT STATUS
.Ex -std jotpass
.Sh EXAMPLES
Print a random password:
.Bd -literal -offset indent
$ jotpass
P6ji-4pRZ-Ze7m-q7Bp-Vpye-HCjr-hygF-6TwQ-oRJT-yx6p-SyMB-AwUm
.Ed
.Pp
Specify a custom format:
.Bd -literal -offset indent
$ jotpass -a 0123456789abcdef -g 8 -w 2 -s ' ' -v
49 1b 6e b0 e2 fc 16 b1
The generated password has an entropy of 64 bits.
.Ed
.Sh SEE ALSO
.Xr jot 1 ,
.Xr arc4random 3
.Sh AUTHORS
.An Stefan Kreutz Aq Mt mail@skreutz.com