12
11
<title>Mandos Manual</title>
13
12
<!-- NWalsh’s docbook scripts use this to generate the footer: -->
14
13
<productname>Mandos</productname>
15
<productnumber>&version;</productnumber>
14
<productnumber>&VERSION;</productnumber>
16
15
<date>&TIMESTAMP;</date>
19
18
<firstname>Björn</firstname>
20
19
<surname>Påhlsson</surname>
22
<email>belorn@recompile.se</email>
21
<email>belorn@fukt.bsnet.se</email>
26
25
<firstname>Teddy</firstname>
27
26
<surname>Hogeborn</surname>
29
<email>teddy@recompile.se</email>
28
<email>teddy@fukt.bsnet.se</email>
46
34
<holder>Teddy Hogeborn</holder>
47
35
<holder>Björn Påhlsson</holder>
49
<xi:include href="legalnotice.xml"/>
39
This manual page is free software: you can redistribute it
40
and/or modify it under the terms of the GNU General Public
41
License as published by the Free Software Foundation,
42
either version 3 of the License, or (at your option) any
47
This manual page is distributed in the hope that it will
48
be useful, but WITHOUT ANY WARRANTY; without even the
49
implied warranty of MERCHANTABILITY or FITNESS FOR A
50
PARTICULAR PURPOSE. See the GNU General Public License
55
You should have received a copy of the GNU General Public
56
License along with this program; If not, see
57
<ulink url="http://www.gnu.org/licenses/"/>.
53
63
<refentrytitle>&COMMANDNAME;</refentrytitle>
54
64
<manvolnum>8</manvolnum>
127
138
<replaceable>TIME</replaceable></option></arg>
131
<arg choice="plain"><option>--tls-keytype
132
<replaceable>KEYTYPE</replaceable></option></arg>
133
<arg choice="plain"><option>-T
134
<replaceable>KEYTYPE</replaceable></option></arg>
138
<arg choice="plain"><option>--force</option></arg>
139
<arg choice="plain"><option>-f</option></arg>
141
<arg><option>--force</option></arg>
143
144
<command>&COMMANDNAME;</command>
144
145
<group choice="req">
145
146
<arg choice="plain"><option>--password</option></arg>
146
147
<arg choice="plain"><option>-p</option></arg>
147
<arg choice="plain"><option>--passfile
148
<replaceable>FILE</replaceable></option></arg>
149
<arg choice="plain"><option>-F</option>
150
<replaceable>FILE</replaceable></arg>
185
178
</refsynopsisdiv>
187
180
<refsect1 id="description">
188
181
<title>DESCRIPTION</title>
190
183
<command>&COMMANDNAME;</command> is a program to generate the
191
TLS and OpenPGP keys used by
192
<citerefentry><refentrytitle>mandos-client</refentrytitle>
185
<citerefentry><refentrytitle>password-request</refentrytitle>
193
186
<manvolnum>8mandos</manvolnum></citerefentry>. The keys are
194
normally written to /etc/keys/mandos for later installation into
195
the initrd image, but this, and most other things, can be
196
changed with command line options.
187
normally written to /etc/mandos for later installation into the
188
initrd image, but this, like most things, can be changed with
189
command line options.
199
This program can also be used with the
200
<option>--password</option> or <option>--passfile</option>
201
options to generate a ready-made section for
202
<filename>clients.conf</filename> (see
192
It can also be used to generate ready-made sections for
203
193
<citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
204
<manvolnum>5</manvolnum></citerefentry>).
194
<manvolnum>5</manvolnum></citerefentry> using the
195
<option>--password</option> option.
208
199
<refsect1 id="purpose">
209
200
<title>PURPOSE</title>
211
203
The purpose of this is to enable <emphasis>remote and unattended
212
204
rebooting</emphasis> of client host computer with an
213
205
<emphasis>encrypted root file system</emphasis>. See <xref
214
206
linkend="overview"/> for details.
218
211
<refsect1 id="options">
219
212
<title>OPTIONS</title>
223
<term><option>--help</option></term>
224
<term><option>-h</option></term>
216
<term><literal>-h</literal>, <literal>--help</literal></term>
227
219
Show a help message and exit
234
<replaceable>DIRECTORY</replaceable></option></term>
236
<replaceable>DIRECTORY</replaceable></option></term>
239
Target directory for key files. Default is <filename
240
class="directory">/etc/keys/mandos</filename>.
247
<replaceable>TYPE</replaceable></option></term>
249
<replaceable>TYPE</replaceable></option></term>
252
OpenPGP key type. Default is <quote>RSA</quote>.
258
<term><option>--length
259
<replaceable>BITS</replaceable></option></term>
261
<replaceable>BITS</replaceable></option></term>
264
OpenPGP key length in bits. Default is 4096.
270
<term><option>--subtype
271
<replaceable>KEYTYPE</replaceable></option></term>
273
<replaceable>KEYTYPE</replaceable></option></term>
276
OpenPGP subkey type. Default is <quote>RSA</quote>
282
<term><option>--sublength
283
<replaceable>BITS</replaceable></option></term>
285
<replaceable>BITS</replaceable></option></term>
288
OpenPGP subkey length in bits. Default is 4096.
294
<term><option>--email
295
<replaceable>ADDRESS</replaceable></option></term>
297
<replaceable>ADDRESS</replaceable></option></term>
225
<term><literal>-d</literal>, <literal>--dir
226
<replaceable>directory</replaceable></literal></term>
229
Target directory for key files. Default is
230
<filename>/etc/mandos</filename>.
236
<term><literal>-t</literal>, <literal>--type
237
<replaceable>type</replaceable></literal></term>
240
Key type. Default is <quote>DSA</quote>.
246
<term><literal>-l</literal>, <literal>--length
247
<replaceable>bits</replaceable></literal></term>
250
Key length in bits. Default is 2048.
256
<term><literal>-s</literal>, <literal>--subtype
257
<replaceable>type</replaceable></literal></term>
260
Subkey type. Default is <quote>ELG-E</quote> (Elgamal
267
<term><literal>-L</literal>, <literal>--sublength
268
<replaceable>bits</replaceable></literal></term>
271
Subkey length in bits. Default is 2048.
277
<term><literal>-e</literal>, <literal>--email</literal>
278
<replaceable>address</replaceable></term>
300
281
Email address of key. Default is empty.
306
<term><option>--comment
307
<replaceable>TEXT</replaceable></option></term>
309
<replaceable>TEXT</replaceable></option></term>
287
<term><literal>-c</literal>, <literal>--comment</literal>
288
<replaceable>comment</replaceable></term>
312
Comment field for key. Default is empty.
291
Comment field for key. The default value is
292
<quote><literal>Mandos client key</literal></quote>.
318
<term><option>--expire
319
<replaceable>TIME</replaceable></option></term>
321
<replaceable>TIME</replaceable></option></term>
298
<term><literal>-x</literal>, <literal>--expire</literal>
299
<replaceable>time</replaceable></term>
324
302
Key expire time. Default is no expiration. See
332
<term><option>--tls-keytype
333
<replaceable>KEYTYPE</replaceable></option></term>
335
<replaceable>KEYTYPE</replaceable></option></term>
338
TLS key type. Default is <quote>ed25519</quote>
344
<term><option>--force</option></term>
345
<term><option>-f</option></term>
348
Force overwriting old key.
353
<term><option>--password</option></term>
354
<term><option>-p</option></term>
310
<term><literal>-f</literal>, <literal>--force</literal></term>
313
Force overwriting old keys.
318
<term><literal>-p</literal>, <literal>--password</literal
357
322
Prompt for a password and encrypt it with the key already
358
present in either <filename>/etc/keys/mandos</filename> or
359
the directory specified with the <option>--dir</option>
323
present in either <filename>/etc/mandos</filename> or the
324
directory specified with the <option>--dir</option>
360
325
option. Outputs, on standard output, a section suitable
361
326
for inclusion in <citerefentry><refentrytitle
362
327
>mandos-clients.conf</refentrytitle><manvolnum
363
328
>8</manvolnum></citerefentry>. The host name or the name
364
329
specified with the <option>--name</option> option is used
365
330
for the section header. All other options are ignored,
366
and no key is created.
371
<term><option>--passfile
372
<replaceable>FILE</replaceable></option></term>
374
<replaceable>FILE</replaceable></option></term>
377
The same as <option>--password</option>, but read from
378
<replaceable>FILE</replaceable>, not the terminal.
383
<term><option>--no-ssh</option></term>
384
<term><option>-S</option></term>
387
When <option>--password</option> or
388
<option>--passfile</option> is given, this option will
389
prevent <command>&COMMANDNAME;</command> from calling
390
<command>ssh-keyscan</command> to get an SSH fingerprint
391
for this host and, if successful, output suitable config
392
options to use this fingerprint as a
393
<option>checker</option> option in the output. This is
394
otherwise the default behavior.
331
and no keys are created.
401
338
<refsect1 id="overview">
402
339
<title>OVERVIEW</title>
403
340
<xi:include href="overview.xml"/>
405
This program is a small utility to generate new TLS and OpenPGP
406
keys for new Mandos clients, and to generate sections for
407
inclusion in <filename>clients.conf</filename> on the server.
342
This program is a small utility to generate new OpenPGP keys for
411
347
<refsect1 id="exit_status">
412
348
<title>EXIT STATUS</title>
414
The exit status will be 0 if a new key (or password, if the
415
<option>--password</option> option was used) was successfully
416
created, otherwise not.
350
The exit status will be 0 if new keys were successfully created,
516
437
</informalexample>
519
Prompt for a password, encrypt it with the keys in <filename
520
class="directory">/etc/keys/mandos</filename> and output a
521
section suitable for <filename>clients.conf</filename>.
524
<userinput>&COMMANDNAME; --password</userinput>
529
Prompt for a password, encrypt it with the keys in the
530
<filename>client-key</filename> directory and output a section
531
suitable for <filename>clients.conf</filename>.
535
<!-- do not wrap this line -->
536
<userinput>&COMMANDNAME; --password --dir client-key</userinput>
542
440
<refsect1 id="security">
543
441
<title>SECURITY</title>
545
443
The <option>--type</option>, <option>--length</option>,
546
444
<option>--subtype</option>, and <option>--sublength</option>
547
options can be used to create keys of low security. If in
548
doubt, leave them to the default values.
445
options can be used to create keys of insufficient security. If
446
in doubt, leave them to the default values.
551
The key expire time is <emphasis>not</emphasis> guaranteed to be
552
honored by <citerefentry><refentrytitle>mandos</refentrytitle>
449
The key expire time is not guaranteed to be honored by
450
<citerefentry><refentrytitle>mandos</refentrytitle>
553
451
<manvolnum>8</manvolnum></citerefentry>.
557
455
<refsect1 id="see_also">
558
456
<title>SEE ALSO</title>
560
<citerefentry><refentrytitle>intro</refentrytitle>
561
<manvolnum>8mandos</manvolnum></citerefentry>,
562
458
<citerefentry><refentrytitle>gpg</refentrytitle>
563
459
<manvolnum>1</manvolnum></citerefentry>,
564
<citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
565
<manvolnum>5</manvolnum></citerefentry>,
566
460
<citerefentry><refentrytitle>mandos</refentrytitle>
567
461
<manvolnum>8</manvolnum></citerefentry>,
568
<citerefentry><refentrytitle>mandos-client</refentrytitle>
569
<manvolnum>8mandos</manvolnum></citerefentry>,
570
<citerefentry><refentrytitle>ssh-keyscan</refentrytitle>
571
<manvolnum>1</manvolnum></citerefentry>
462
<citerefentry><refentrytitle>password-request</refentrytitle>
463
<manvolnum>8mandos</manvolnum></citerefentry>