-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathmakepasswd.xml
231 lines (231 loc) · 8.24 KB
/
makepasswd.xml
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
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
<?xml version="1.0" encoding="UTF-8"?>
<!-- $Id$ -->
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY firstname "Pierre">
<!ENTITY surname "Pronchery">
<!ENTITY username "khorben">
<!ENTITY email "[email protected]">
<!ENTITY section "1">
<!ENTITY title "makepasswd User Manual">
<!ENTITY package "makepasswd">
<!ENTITY name "makepasswd">
<!ENTITY purpose "Generates (pseudo-)random passwords and hashes">
]>
<refentry>
<refentryinfo>
<title>&title;</title>
<productname>&package;</productname>
<authorgroup>
<author>
<firstname>&firstname;</firstname>
<surname>&surname;</surname>
<contrib>Code and documentation.</contrib>
<address>
<email>&email;</email>
</address>
</author>
<author>
<firstname>Gabor Z.</firstname>
<surname>papp</surname>
<contrib>Testing.</contrib>
<address>
<email>[email protected]</email>
</address>
</author>
</authorgroup>
<copyright>
<year>2012</year>
<year>2013</year>
<holder>&firstname; &surname; <&email;></holder>
</copyright>
<legalnotice>
<para>This manual page was written for the DeforaOS project (and may be
used by others).</para>
<para>Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU General Public License,
Version 3 as published by the Free Software Foundation.</para>
</legalnotice>
</refentryinfo>
<refmeta>
<refentrytitle>&name;</refentrytitle>
<manvolnum>§ion;</manvolnum>
</refmeta>
<refnamediv>
<refname>&name;</refname>
<refpurpose>&purpose;</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>&name;</command>
<arg choice="opt"><option>-c</option>
<replaceable>string</replaceable></arg>
<arg choice="opt"><option>-e</option>
<replaceable>algorithm</replaceable></arg>
<arg choice="opt"><option>-i</option>
<replaceable>iterations</replaceable></arg>
<arg choice="opt"><option>-l</option>
<replaceable>length</replaceable></arg>
<arg choice="opt"><option>-M</option>
<replaceable>maximum length</replaceable></arg>
<arg choice="opt"><option>-m</option>
<replaceable>minimum length</replaceable></arg>
<arg choice="opt"><option>-n</option>
<replaceable>count</replaceable></arg>
<arg choice="opt"><option>-p</option>
<replaceable>password</replaceable></arg>
<arg choice="opt"><option>-S</option></arg>
<arg choice="opt"><option>-s</option>
<replaceable>salt</replaceable></arg>
</cmdsynopsis>
<cmdsynopsis>
<command>&name;</command>
<arg choice="opt"><option>-E</option></arg>
<arg choice="opt"><option>-c</option>
<replaceable>string</replaceable></arg>
<arg choice="opt"><option>-e</option>
<replaceable>algorithm</replaceable></arg>
<arg choice="opt"><option>-i</option>
<replaceable>iterations</replaceable></arg>
<arg choice="opt"><option>-l</option>
<replaceable>length</replaceable></arg>
<arg choice="opt"><option>-M</option>
<replaceable>maximum length</replaceable></arg>
<arg choice="opt"><option>-m</option>
<replaceable>minimum length</replaceable></arg>
<arg choice="opt"><option>-n</option>
<replaceable>count</replaceable></arg>
<arg choice="opt"><option>-S</option></arg>
<arg choice="opt"><option>-s</option>
<replaceable>salt</replaceable></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 id="description">
<title>Description</title>
<para><command>&name;</command> is a program that generates pseudo-random
passwords of a desired length and, if so desired, along with their
corresponding hashes for a given encryption algorithm.</para>
</refsect1>
<refsect1 id="options">
<title>Options</title>
<para>The following options are available:</para>
<variablelist>
<varlistentry>
<term><option>-E</option></term>
<listitem>
<para>In this operation mode, <command>&name;</command>
enumerates through all possible values for a password,
given the list of characters allowed and the length
specified.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-c <replaceable>string</replaceable></option></term>
<listitem>
<para>Sets the string of characters allowed within passwords, when
generating them randomly.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-e</option></term>
<listitem>
<para>Apply a specific hashing algorithm to the password
generated. The list of passwords currently supported
is:<itemizedlist>
<listitem><para>base64 (always supported)</para></listitem>
<listitem><para>blowfish (Blowfish)</para></listitem>
<listitem><para>des (single DES)</para></listitem>
<listitem><para>md5 (MD5, always supported)</para></listitem>
<listitem><para>sha1 (SHA-1)</para></listitem>
<listitem><para>sha256 (SHA-256)</para></listitem>
<listitem><para>shmd5 (shadow MD5)</para></listitem>
<listitem><para>none (always supported)</para></listitem>
</itemizedlist></para>
<para>For the algorithms not explicitly mentioned as always supported,
their availability depends on the implementation of the
<citerefentry> <refentrytitle>crypt</refentrytitle>
<manvolnum>3</manvolnum> </citerefentry> library on the system
where <command>&name;</command> was compiled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-i</option></term>
<listitem>
<para>Force a number of iterations to be performed when hashing
passwords, for algorithms effectively supporting it. It otherwise
defaults to a random value, in a range considered reasonable for the
hashing algorithm selected.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-l</option></term>
<listitem>
<para>Force the passwords generated to be of a fixed length.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-M</option></term>
<listitem>
<para>Maximum length for the passwords generated.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-m</option></term>
<listitem>
<para>Minimum length for the passwords generated.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-n</option></term>
<listitem>
<para>Total number of passwords to generate. When not set, it defaults
to only one, except in enumeration mode where it processes the
complete range of possibilities until exhaustion.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-p</option></term>
<listitem>
<para>Force a given value for the password generated. This is useful
when generating hashes for pre-determined passwords.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-S</option></term>
<listitem>
<para>Do not seed the PRNG (pseudo-random number generator) ourselves.
With this option <emphasis>set</emphasis>, the entropy pool is often
<emphasis>not</emphasis> initialized, and the passwords generated
<emphasis>predictable</emphasis> as a result.</para>
<para>Use this option carefully, when you know that either the system does
provide better entropy than <command>&name;</command>, or that it hurts
performance in a situation where entropy is not required.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-s</option></term>
<listitem>
<para>Force a given value when salting the resulting password hash.
This is only useful when selecting a hashing algorithm that
effectively uses salt.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id="bugs">
<title>Bugs</title>
<para>Issues can be listed and reported at <ulink
url="http://www.defora.org/os/project/bug_list/117/makepasswd"/>.</para>
</refsect1>
<refsect1 id="see_also">
<title>See also</title>
<para><citerefentry>
<refentrytitle>login</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>, <citerefentry>
<refentrytitle>passwd</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry></para>
</refsect1>
</refentry>
<!-- vim: set noet ts=1 sw=1 sts=1 tw=80: -->