1 .\" Copyright (c) 2022 Alex Arx <aa@manpager.org>
2 .\"
3 .\" Permission to use, copy, modify, and distribute this software for any
4 .\" purpose with or without fee is hereby granted, provided that the above
5 .\" copyright notice and this permission notice appear in all copies.
6 .\"
7 .\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
8 .\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
9 .\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
10 .\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
11 .\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
12 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
13 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
14 .\"
15 .Dd November 17, 2024
16 .Dt GPASS 1
17 .Os
18 .Sh NAME
19 .Nm gpass
20 .Nd generate passphrases
21 .Sh SYNOPSIS
22 .Nm
23 .Op Fl a
24 .Op Fl d Ar dict
25 .Op Fl e Ar bits
26 .Op Fl n Ar num
27 .Sh DESCRIPTION
28 The utility
29 .Nm
30 outputs a secure passphrase by randomly choosing an appropriate number of lines
31 from a dictionary file, containing whitespace-separated words.
32 The options are as follows:
33 .Bl -tag -width Ds
34 .It Fl a
35 Instead of generating a passphrases from the wordlist, generate strings of
36 random alphanumeric characters.
37 .It Fl d Ar dict
38 Use the dictionary
39 .Ar dict .
40 .It Fl e Ar bits
41 Generate a passphrase with at least the specified number of
42 .Ar bits
43 of entropy.
44 Default is 70.
45 .It Fl l Ar length
46 Generate a passphrase of
47 .Ar length
48 words, or characters if
49 .Fl a
50 is used.
51 Overrides
52 .Fl e .
53 .It Fl n Ar num
54 Generate
55 .Ar num
56 passphrases instead of just one.
57 .El
58 .Sh ENVIRONMENT
59 .Bl -tag -width GPASS_DIC
60 .It Ev GPASS_DIC
61 Path to the dictionary file to use unless the option
62 .Fl d
63 is specified.
64 .El
65 .Sh FILES
66 .Bl -tag -width Ds -compact
67 .It Pa $XDG_DATA_HOME/gpass.dic
68 .It Pa $HOME/.gpass.dic
69 .It Pa /usr/share/gpass.dic
70 .It Pa /usr/local/share/gpass.dic
71 Paths searched for the default dictionary file.
72 Only searched if
73 .Ev GPASS_DIC
74 is not set or empty, and
75 .Fl d
76 is not used.
77 First to be found is used.
78 .Pa $HOME/.gpass.dic
79 is only used when
80 .Ev XDG_DATA_HOME
81 is not set.
82 .El
83 .Sh EXIT STATUS
84 .Ex -std
85 .Sh AUTHORS
86 .An Alex Arx Aq Mt aa@manpager.net .