67
46
<refname><command>&COMMANDNAME;</command></refname>
69
Generate keys for <citerefentry><refentrytitle>password-request
70
</refentrytitle><manvolnum>8mandos</manvolnum></citerefentry>
48
Generate key and password for Mandos client and server.
76
54
<command>&COMMANDNAME;</command>
78
<arg choice="plain"><option>--dir</option>
79
<replaceable>directory</replaceable></arg>
82
<arg choice="plain"><option>--type</option>
83
<replaceable>type</replaceable></arg>
86
<arg choice="plain"><option>--length</option>
87
<replaceable>bits</replaceable></arg>
90
<arg choice="plain"><option>--name</option>
91
<replaceable>NAME</replaceable></arg>
94
<arg choice="plain"><option>--email</option>
95
<replaceable>EMAIL</replaceable></arg>
98
<arg choice="plain"><option>--comment</option>
99
<replaceable>COMMENT</replaceable></arg>
102
<arg choice="plain"><option>--expire</option>
103
<replaceable>TIME</replaceable></arg>
106
<arg choice="plain"><option>--force</option></arg>
110
<command>&COMMANDNAME;</command>
112
<arg choice="plain"><option>-d</option>
113
<replaceable>directory</replaceable></arg>
116
<arg choice="plain"><option>-t</option>
117
<replaceable>type</replaceable></arg>
120
<arg choice="plain"><option>-l</option>
121
<replaceable>bits</replaceable></arg>
124
<arg choice="plain"><option>-n</option>
125
<replaceable>NAME</replaceable></arg>
128
<arg choice="plain"><option>-e</option>
129
<replaceable>EMAIL</replaceable></arg>
132
<arg choice="plain"><option>-c</option>
133
<replaceable>COMMENT</replaceable></arg>
136
<arg choice="plain"><option>-x</option>
137
<replaceable>TIME</replaceable></arg>
140
<arg choice="plain"><option>-f</option></arg>
144
<command>&COMMANDNAME;</command>
146
<arg choice='plain'><option>-h</option></arg>
147
<arg choice='plain'><option>--help</option></arg>
151
<command>&COMMANDNAME;</command>
153
<arg choice='plain'><option>-v</option></arg>
154
<arg choice='plain'><option>--version</option></arg>
56
<arg choice="plain"><option>--dir
57
<replaceable>DIRECTORY</replaceable></option></arg>
58
<arg choice="plain"><option>-d
59
<replaceable>DIRECTORY</replaceable></option></arg>
63
<arg choice="plain"><option>--type
64
<replaceable>KEYTYPE</replaceable></option></arg>
65
<arg choice="plain"><option>-t
66
<replaceable>KEYTYPE</replaceable></option></arg>
70
<arg choice="plain"><option>--length
71
<replaceable>BITS</replaceable></option></arg>
72
<arg choice="plain"><option>-l
73
<replaceable>BITS</replaceable></option></arg>
77
<arg choice="plain"><option>--subtype
78
<replaceable>KEYTYPE</replaceable></option></arg>
79
<arg choice="plain"><option>-s
80
<replaceable>KEYTYPE</replaceable></option></arg>
84
<arg choice="plain"><option>--sublength
85
<replaceable>BITS</replaceable></option></arg>
86
<arg choice="plain"><option>-L
87
<replaceable>BITS</replaceable></option></arg>
91
<arg choice="plain"><option>--name
92
<replaceable>NAME</replaceable></option></arg>
93
<arg choice="plain"><option>-n
94
<replaceable>NAME</replaceable></option></arg>
98
<arg choice="plain"><option>--email
99
<replaceable>ADDRESS</replaceable></option></arg>
100
<arg choice="plain"><option>-e
101
<replaceable>ADDRESS</replaceable></option></arg>
105
<arg choice="plain"><option>--comment
106
<replaceable>TEXT</replaceable></option></arg>
107
<arg choice="plain"><option>-c
108
<replaceable>TEXT</replaceable></option></arg>
112
<arg choice="plain"><option>--expire
113
<replaceable>TIME</replaceable></option></arg>
114
<arg choice="plain"><option>-x
115
<replaceable>TIME</replaceable></option></arg>
118
<arg><option>--force</option></arg>
121
<command>&COMMANDNAME;</command>
123
<arg choice="plain"><option>--password</option></arg>
124
<arg choice="plain"><option>-p</option></arg>
128
<arg choice="plain"><option>--dir
129
<replaceable>DIRECTORY</replaceable></option></arg>
130
<arg choice="plain"><option>-d
131
<replaceable>DIRECTORY</replaceable></option></arg>
135
<arg choice="plain"><option>--name
136
<replaceable>NAME</replaceable></option></arg>
137
<arg choice="plain"><option>-n
138
<replaceable>NAME</replaceable></option></arg>
142
<command>&COMMANDNAME;</command>
144
<arg choice="plain"><option>--help</option></arg>
145
<arg choice="plain"><option>-h</option></arg>
149
<command>&COMMANDNAME;</command>
151
<arg choice="plain"><option>--version</option></arg>
152
<arg choice="plain"><option>-v</option></arg>
157
155
</refsynopsisdiv>
159
157
<refsect1 id="description">
160
158
<title>DESCRIPTION</title>
162
160
<command>&COMMANDNAME;</command> is a program to generate the
164
162
<citerefentry><refentrytitle>password-request</refentrytitle>
165
<manvolnum>8mandos</manvolnum></citerefentry>. The keys are
163
<manvolnum>8mandos</manvolnum></citerefentry>. The key is
166
164
normally written to /etc/mandos for later installation into the
167
initrd image, but this, like most things, can be changed with
168
command line options.
165
initrd image, but this, and most other things, can be changed
166
with command line options.
169
This program can also be used with the
170
<option>--password</option> option to generate a ready-made
171
section for <filename>clients.conf</filename> (see
172
<citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
173
<manvolnum>5</manvolnum></citerefentry>).
177
<refsect1 id="purpose">
178
<title>PURPOSE</title>
180
The purpose of this is to enable <emphasis>remote and unattended
181
rebooting</emphasis> of client host computer with an
182
<emphasis>encrypted root file system</emphasis>. See <xref
183
linkend="overview"/> for details.
172
187
<refsect1 id="options">
173
188
<title>OPTIONS</title>
177
<term><literal>-h</literal>, <literal>--help</literal></term>
192
<term><option>--help</option></term>
193
<term><option>-h</option></term>
180
196
Show a help message and exit
186
<term><literal>-d</literal>, <literal>--dir
187
<replaceable>directory</replaceable></literal></term>
190
Target directory for key files.
196
<term><literal>-t</literal>, <literal>--type
197
<replaceable>type</replaceable></literal></term>
200
Key type. Default is DSA.
206
<term><literal>-l</literal>, <literal>--length
207
<replaceable>bits</replaceable></literal></term>
210
Key length in bits. Default is 1024.
216
<term><literal>-e</literal>, <literal>--email</literal>
217
<replaceable>address</replaceable></term>
203
<replaceable>DIRECTORY</replaceable></option></term>
205
<replaceable>DIRECTORY</replaceable></option></term>
208
Target directory for key files. Default is
209
<filename>/etc/mandos</filename>.
216
<replaceable>TYPE</replaceable></option></term>
218
<replaceable>TYPE</replaceable></option></term>
221
Key type. Default is <quote>DSA</quote>.
227
<term><option>--length
228
<replaceable>BITS</replaceable></option></term>
230
<replaceable>BITS</replaceable></option></term>
233
Key length in bits. Default is 2048.
239
<term><option>--subtype
240
<replaceable>KEYTYPE</replaceable></option></term>
242
<replaceable>KEYTYPE</replaceable></option></term>
245
Subkey type. Default is <quote>ELG-E</quote> (Elgamal
252
<term><option>--sublength
253
<replaceable>BITS</replaceable></option></term>
255
<replaceable>BITS</replaceable></option></term>
258
Subkey length in bits. Default is 2048.
264
<term><option>--email
265
<replaceable>ADDRESS</replaceable></option></term>
267
<replaceable>ADDRESS</replaceable></option></term>
220
270
Email address of key. Default is empty.
249
<term><literal>-f</literal>, <literal>--force</literal></term>
252
Force overwriting old keys.
303
<term><option>--force</option></term>
304
<term><option>-f</option></term>
307
Force overwriting old key.
312
<term><option>--password</option></term>
313
<term><option>-p</option></term>
316
Prompt for a password and encrypt it with the key already
317
present in either <filename>/etc/mandos</filename> or the
318
directory specified with the <option>--dir</option>
319
option. Outputs, on standard output, a section suitable
320
for inclusion in <citerefentry><refentrytitle
321
>mandos-clients.conf</refentrytitle><manvolnum
322
>8</manvolnum></citerefentry>. The host name or the name
323
specified with the <option>--name</option> option is used
324
for the section header. All other options are ignored,
325
and no key is created.
332
<refsect1 id="overview">
333
<title>OVERVIEW</title>
334
<xi:include href="overview.xml"/>
336
This program is a small utility to generate new OpenPGP keys for
337
new Mandos clients, and to generate sections for inclusion in
338
<filename>clients.conf</filename> on the server.
259
342
<refsect1 id="exit_status">
260
343
<title>EXIT STATUS</title>
345
The exit status will be 0 if a new key (or password, if the
346
<option>--password</option> option was used) was successfully
347
created, otherwise not.
351
<refsect1 id="environment">
352
<title>ENVIRONMENT</title>
355
<term><envar>TMPDIR</envar></term>
358
If set, temporary files will be created here. See
359
<citerefentry><refentrytitle>mktemp</refentrytitle>
360
<manvolnum>1</manvolnum></citerefentry>.
265
367
<refsect1 id="file">
266
368
<title>FILES</title>
370
Use the <option>--dir</option> option to change where
371
<command>&COMMANDNAME;</command> will write the key files. The
372
default file names are shown here.
376
<term><filename>/etc/mandos/seckey.txt</filename></term>
379
OpenPGP secret key file which will be created or
385
<term><filename>/etc/mandos/pubkey.txt</filename></term>
388
OpenPGP public key file which will be created or
394
<term><filename>/tmp</filename></term>
397
Temporary files will be written here if
398
<varname>TMPDIR</varname> is not set.
271
405
<refsect1 id="bugs">
272
406
<title>BUGS</title>
408
None are known at this time.
277
<refsect1 id="examples">
278
<title>EXAMPLES</title>
412
<refsect1 id="example">
413
<title>EXAMPLE</title>
416
Normal invocation needs no options:
419
<userinput>&COMMANDNAME;</userinput>
424
Create key in another directory and of another type. Force
425
overwriting old key files:
429
<!-- do not wrap this line -->
430
<userinput>&COMMANDNAME; --dir ~/keydir --type RSA --force</userinput>
436
Prompt for a password, encrypt it with the key in
437
<filename>/etc/mandos</filename> and output a section suitable
438
for <filename>clients.conf</filename>.
441
<userinput>&COMMANDNAME; --password</userinput>
446
Prompt for a password, encrypt it with the key in the
447
<filename>client-key</filename> directory and output a section
448
suitable for <filename>clients.conf</filename>.
452
<!-- do not wrap this line -->
453
<userinput>&COMMANDNAME; --password --dir client-key</userinput>
283
459
<refsect1 id="security">
284
460
<title>SECURITY</title>
462
The <option>--type</option>, <option>--length</option>,
463
<option>--subtype</option>, and <option>--sublength</option>
464
options can be used to create keys of low security. If in
465
doubt, leave them to the default values.
468
The key expire time is <emphasis>not</emphasis> guaranteed to be
469
honored by <citerefentry><refentrytitle>mandos</refentrytitle>
470
<manvolnum>8</manvolnum></citerefentry>.
289
474
<refsect1 id="see_also">
290
475
<title>SEE ALSO</title>
292
<citerefentry><refentrytitle>password-request</refentrytitle>
293
<manvolnum>8mandos</manvolnum></citerefentry>,
477
<citerefentry><refentrytitle>gpg</refentrytitle>
478
<manvolnum>1</manvolnum></citerefentry>,
479
<citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
480
<manvolnum>5</manvolnum></citerefentry>,
294
481
<citerefentry><refentrytitle>mandos</refentrytitle>
295
<manvolnum>8</manvolnum></citerefentry>, and
296
<citerefentry><refentrytitle>gpg</refentrytitle>
297
<manvolnum>1</manvolnum></citerefentry>
482
<manvolnum>8</manvolnum></citerefentry>,
483
<citerefentry><refentrytitle>password-request</refentrytitle>
484
<manvolnum>8mandos</manvolnum></citerefentry>
489
<!-- Local Variables: -->
490
<!-- time-stamp-start: "<!ENTITY TIMESTAMP [\"']" -->
491
<!-- time-stamp-end: "[\"']>" -->
492
<!-- time-stamp-format: "%:y-%02m-%02d" -->