From 32eb4a205eeb6c20a16e43496a7e4229641889cc Mon Sep 17 00:00:00 2001 From: Stefan Kreutz Date: Tue, 12 Oct 2021 15:07:02 +0200 Subject: Add initial implementation --- jotpass.1 | 78 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 jotpass.1 (limited to 'jotpass.1') diff --git a/jotpass.1 b/jotpass.1 new file mode 100644 index 0000000..2aa9bf6 --- /dev/null +++ b/jotpass.1 @@ -0,0 +1,78 @@ +.\" Copyright (c) 2021 Stefan Kreutz +.\" +.\" 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 -- cgit v1.2.3