1
1
<?xml version="1.0" encoding="UTF-8"?>
2
2
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3
3
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
<!ENTITY VERSION "1.0">
4
5
<!ENTITY COMMANDNAME "mandos-keygen">
5
<!ENTITY TIMESTAMP "2013-08-27">
6
<!ENTITY % common SYSTEM "common.ent">
6
<!ENTITY TIMESTAMP "2008-08-31">
10
9
<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
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>
38
34
<holder>Teddy Hogeborn</holder>
39
35
<holder>Björn Påhlsson</holder>
41
<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/"/>.
45
63
<refentrytitle>&COMMANDNAME;</refentrytitle>
46
64
<manvolnum>8</manvolnum>
126
144
<group choice="req">
127
145
<arg choice="plain"><option>--password</option></arg>
128
146
<arg choice="plain"><option>-p</option></arg>
129
<arg choice="plain"><option>--passfile
130
<replaceable>FILE</replaceable></option></arg>
131
<arg choice="plain"><option>-F</option>
132
<replaceable>FILE</replaceable></arg>
168
182
<command>&COMMANDNAME;</command> is a program to generate the
169
183
OpenPGP key used by
170
<citerefentry><refentrytitle>mandos-client</refentrytitle>
184
<citerefentry><refentrytitle>password-request</refentrytitle>
171
185
<manvolnum>8mandos</manvolnum></citerefentry>. The key is
172
186
normally written to /etc/mandos for later installation into the
173
187
initrd image, but this, and most other things, can be changed
177
191
This program can also be used with the
178
<option>--password</option> or <option>--passfile</option>
179
options to generate a ready-made section for
180
<filename>clients.conf</filename> (see
192
<option>--password</option> option to generate a ready-made
193
section for <filename>clients.conf</filename> (see
181
194
<citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
182
195
<manvolnum>5</manvolnum></citerefentry>).
251
264
<replaceable>KEYTYPE</replaceable></option></term>
254
Subkey type. Default is <quote>RSA</quote> (Elgamal
267
Subkey type. Default is <quote>ELG-E</quote> (Elgamal
255
268
encryption-only).
261
274
<term><option>--sublength
262
275
<replaceable>BITS</replaceable></option></term>
339
<term><option>--passfile
340
<replaceable>FILE</replaceable></option></term>
342
<replaceable>FILE</replaceable></option></term>
345
The same as <option>--password</option>, but read from
346
<replaceable>FILE</replaceable>, not the terminal.
353
354
<refsect1 id="overview">
354
355
<title>OVERVIEW</title>
355
356
<xi:include href="overview.xml"/>
453
455
</informalexample>
454
456
<informalexample>
456
Prompt for a password, encrypt it with the key in <filename
457
class="directory">/etc/mandos</filename> and output a section
458
suitable for <filename>clients.conf</filename>.
458
Prompt for a password, encrypt it with the key in
459
<filename>/etc/mandos</filename> and output a section suitable
460
for <filename>clients.conf</filename>.
461
463
<userinput>&COMMANDNAME; --password</userinput>
490
492
<manvolnum>8</manvolnum></citerefentry>.
494
496
<refsect1 id="see_also">
495
497
<title>SEE ALSO</title>
497
<citerefentry><refentrytitle>intro</refentrytitle>
498
<manvolnum>8mandos</manvolnum></citerefentry>,
499
499
<citerefentry><refentrytitle>gpg</refentrytitle>
500
500
<manvolnum>1</manvolnum></citerefentry>,
501
501
<citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
502
502
<manvolnum>5</manvolnum></citerefentry>,
503
503
<citerefentry><refentrytitle>mandos</refentrytitle>
504
504
<manvolnum>8</manvolnum></citerefentry>,
505
<citerefentry><refentrytitle>mandos-client</refentrytitle>
505
<citerefentry><refentrytitle>password-request</refentrytitle>
506
506
<manvolnum>8mandos</manvolnum></citerefentry>