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