1 ee89c9f1 2022-12-03 op .\" Copyright (c) 2021, 2022 Omar Polo <op@omarpolo.com>
 2 ee89c9f1 2022-12-03 op .\"
 3 ee89c9f1 2022-12-03 op .\" Permission to use, copy, modify, and distribute this software for any
 4 ee89c9f1 2022-12-03 op .\" purpose with or without fee is hereby granted, provided that the above
 5 ee89c9f1 2022-12-03 op .\" copyright notice and this permission notice appear in all copies.
 6 ee89c9f1 2022-12-03 op .\"
 7 ee89c9f1 2022-12-03 op .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 8 ee89c9f1 2022-12-03 op .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 9 ee89c9f1 2022-12-03 op .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 ee89c9f1 2022-12-03 op .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 ee89c9f1 2022-12-03 op .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 ee89c9f1 2022-12-03 op .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 ee89c9f1 2022-12-03 op .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 3486f5fc 2023-01-21 op .Dd January 21, 2023
15 ee89c9f1 2022-12-03 op .Dt PWG 1
16 ee89c9f1 2022-12-03 op .Os
17 ee89c9f1 2022-12-03 op .Sh NAME
18 ee89c9f1 2022-12-03 op .Nm pwg
19 ee89c9f1 2022-12-03 op .Nd password generator
20 ee89c9f1 2022-12-03 op .Sh SYNOPSIS
21 ee89c9f1 2022-12-03 op .Nm
22 ee89c9f1 2022-12-03 op .Op Fl an
23 ee89c9f1 2022-12-03 op .Op Fl w Ar wordlist
24 ee89c9f1 2022-12-03 op .Op Ar length
25 ee89c9f1 2022-12-03 op .Sh DESCRIPTION
26 ee89c9f1 2022-12-03 op .Nm
27 3486f5fc 2023-01-21 op is a password and passphrase generator.
28 3486f5fc 2023-01-21 op It generates a random string of characters or a diceware-style pass
29 ee89c9f1 2022-12-03 op phrase.
30 ee89c9f1 2022-12-03 op The random properties are the ones provided by the operating system'
31 ee89c9f1 2022-12-03 op .Pa /dev/urandom
32 ee89c9f1 2022-12-03 op and
33 ee89c9f1 2022-12-03 op .Xr sort 1
34 ee89c9f1 2022-12-03 op .Fl R .
35 ee89c9f1 2022-12-03 op .Pp
36 ee89c9f1 2022-12-03 op The options are as follows:
37 ee89c9f1 2022-12-03 op .Bl -tag -width Ds
38 ee89c9f1 2022-12-03 op .It Fl a
39 ee89c9f1 2022-12-03 op use only alphanumeric characters.
40 ee89c9f1 2022-12-03 op .It Fl n
41 ee89c9f1 2022-12-03 op use only numbers.
42 ee89c9f1 2022-12-03 op .It Fl w Ar wordlist
43 ee89c9f1 2022-12-03 op generate a passphrase using words from the
44 ee89c9f1 2022-12-03 op .Ar wordlist
45 ee89c9f1 2022-12-03 op file.
46 ee89c9f1 2022-12-03 op .El
47 ee89c9f1 2022-12-03 op .Pp
48 ee89c9f1 2022-12-03 op If no
49 ee89c9f1 2022-12-03 op .Ar length
50 3486f5fc 2023-01-21 op is given, an appropriate one is used.
51 ee89c9f1 2022-12-03 op .Sh EXIT STATUS
52 ee89c9f1 2022-12-03 op .Ex -std
53 ee89c9f1 2022-12-03 op .Sh EXAMPLES
54 ee89c9f1 2022-12-03 op Generate a passphrase using the EFF
55 ee89c9f1 2022-12-03 op .Dq large
56 ee89c9f1 2022-12-03 op wordlist:
57 ee89c9f1 2022-12-03 op .Bd -literal
58 ee89c9f1 2022-12-03 op $ ftp \-o\- https://www.eff.org/files/2016/07/18/eff_large_wordlist.txt \e
59 ee89c9f1 2022-12-03 op 	| awk '{print $2}' >~/wordlist
60 ee89c9f1 2022-12-03 op $ pwg \-w ~/wordlist
61 ee89c9f1 2022-12-03 op elm retouch disclose snaking pregame bonfire
62 ee89c9f1 2022-12-03 op .Ed
63 ee89c9f1 2022-12-03 op .Sh AUTHORS
64 ee89c9f1 2022-12-03 op .An -nosplit
65 ee89c9f1 2022-12-03 op The
66 ee89c9f1 2022-12-03 op .Nm
67 ee89c9f1 2022-12-03 op utility was written by
68 ee89c9f1 2022-12-03 op .An Omar Polo Aq Mt op@omarpolo.com .