~seirdy/moac

moac/doc/moac-pwgen.1.scd -rw-r--r-- 2.6 KiB
97035daeRohan Kumar Chore(deps): bump deps 12 days ago
                                                                                
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
moac-pwgen(1)

# NAME

moac-pwgen - generate passwords with the described strength

# SYNOPSIS

moac-pwgen [OPTIONS...] [CHARSETS...]

# OPTIONS

*-h*
	Display a brief help message and exit.

*-v*
	Print the version and exit.

*-q*
	Account for quantum computers using Grover's algorithm. Note that as of late
	2021, the viability of quantum computers capable of using Grover's Algorithm
	is unknown.

*-e* <energy>
	Maximum energy used by attacker (J).

*-s* <entropy>
	Desired assword entropy. Defaults to 256 bits.

*-m* <mass>
	Mass at attacker's disposal (kg). Used to compute mass-energy. Overrides the
	value of *-e* if the computed mass-energy is lower.
	Mass can also be used to calculate Bremermann's Limit.

*-g* <energy>
	Energy used per guess (J).

*-P* <power>
	Power available to the computer (W)

*-T* <temperature>
	The temperature of the system (K). Defaults to 273 kelvin. Used to calculate
	the Landauer limit.

	Temperature must be between 0 and the Planck Temperature, noninclusive.

*-t* <time>
	Time limit for brute-force attack (s).

*-G* <guesses>
	Guesses-per-second in a brute-force attack. Overridden by values computed from
	Bremermann's Limit and the Landauer limit if those are smaller or if unset.

*-l* <length>
	Minimum number of characters in generated password. Overrides value of *-s* if
	doing so would increase password length.

*-L* <length>
	Maximum number of characters in generated password. Overrides value of *-s* if
	doing so would decrease password length.

# DEFAULT VALUES

See the *DEFAULT VALUES* section in *moac*(1) for physical values.

The default charset is *ascii*.

# CHARSETS

Generated passwords contain at least one character from each charset specified.
Choose from the following charsets:

*lowercase*	[a-z]

*uppercase*	[A-Z]

*numbers*	[0-9]

*symbols*	!"#%&'()\*+,-./:;<=>?@[\\]^\_`{|}~$-

*latin1*	the "Latin-1" Unicode block

*latinExtendedA*	the "Latin Extended A" Unicode block

*latinExtendedB*	the "Latin Extended B" Unicode block

*ipaExtensions*	the "IPA Extensions" Unicode block

*ascii*	alias for "lowercase uppercase numbers symbols". This is the default.

*latin*	alias for "latin1 latinExtendedA latinExtendedB ipaExtensions"

Any argument after *[OPTIONS]* that is not listed above is assumed to be a
string containing characters of a charset. Generated passwords will only contain
printable characters, excluding marks. Grapheme clusters may be split apart.

*moac-pwgen* needs at least two unique characters with which to generate a
password.

# SEE ALSO

*moac*(1)

# AUTHOR

Maintained by Rohan Kumar <seirdy@seirdy.one>. For more information about moac
development, see https://sr.ht/~seirdy/MOAC