From 4e0d4441bb5613fb09cf772f7bcf7beb15337443 Mon Sep 17 00:00:00 2001
From: Thomas Voss <mail@thomasvoss.com>
Date: Tue, 22 Aug 2023 16:14:23 +0300
Subject: Genesis commit

---
 mkpass.1 | 61 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 61 insertions(+)
 create mode 100644 mkpass.1

(limited to 'mkpass.1')

diff --git a/mkpass.1 b/mkpass.1
new file mode 100644
index 0000000..84c269f
--- /dev/null
+++ b/mkpass.1
@@ -0,0 +1,61 @@
+.Dd $Mdocdate: August 22 2023 $
+.Dt MKPASS 1
+.Os
+.Sh NAME
+.Nm mkpass
+.Nd make a password
+.Sh SYNOPSIS
+.Nm
+.Op Fl n
+.Op Fl l Ar length
+.Op Ar chars
+.Sh DESCRIPTION
+The
+.Nm
+utility allows you to easily create randomly\-generated passwords from the
+command\-line.
+By default,
+.Nm
+generates a 64\-character long password of printable characters.
+If specified, the generated password will only contain characters found in
+.Ar chars .
+You may use
+.Xr tr 1
+range syntax, as shown in the
+.Sx EXAMPLES
+section.
+.Pp
+The options are as follows:
+.Bl -tag width Ds
+.It Fl n
+Do not print a trailing newline after the generated password.
+.It Fl l Ar length
+Generate a password
+.Ar length
+characters in length.
+.El
+.Sh EXIT STATUS
+.Ex -std
+.Sh EXAMPLES
+.Pp
+Generate a password:
+.Pp
+.Dl $ mkpass
+.Pp
+Generate a password with a length of 40:
+.Pp
+.Dl $ mkpass -l 40
+.Pp
+Generate an alphanumeric password:
+.Pp
+.Dl $ mkpass '[:alnum:]'
+.Pp
+Generate a password containing only the lowercase letters of the latin alphabet:
+.Pp
+.Dl $ mkpass a-z
+.Sh SEE ALSO
+.Xr head 1 ,
+.Xr totp 1 ,
+.Xr tr 1
+.Sh AUTHORS
+.An Thomas Voss Aq Mt mail@thomasvoss.com
-- 
cgit v1.2.3