/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to mandos-keygen.xml

  • Committer: Teddy Hogeborn
  • Date: 2008-09-05 07:11:24 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080905071124-9dq11jq5rfd6zfxf
* Makefile: Changed to use symbolic instead of octal modes throughout.
  (KEYDIR): New variable for the key directory.
  (install-server): Bug fix: remove "--parents" from install args.
  (install-client): Bug fix: - '' -  Also create key directory.  Do
                    not chmod plugin dir.  Create custom plugin directory
                    if not the same as normal plugin directory.  Add
                    "--dir" option to "mandos-keygen".  Add note about
                    running "mandos-keygen --password".
  (uninstall-server): Do not depend on the installed server binary,
                      since this made it impossible to do a purge
                      after an uninstall.
  (purge-client): Shred seckey.txt.  Use $(KEYDIR).

* README: Improved wording.

* initramfs-tools-hook: Use a loop to find prefix.  Also find keydir.
                        Remove "${DESTDIR}" from "copy_exec".  Do not
                        try to copy literal "*" if no custom plugins
                        are found.  Copy key files from keydir, not
                        config dir.  Only repair mode on directories
                        that actually exist.  Do not run chmod if
                        nothing needs repairing.

* plugin-runner.conf: New file.

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
        "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4
4
<!ENTITY VERSION "1.0">
5
5
<!ENTITY COMMANDNAME "mandos-keygen">
6
 
<!ENTITY TIMESTAMP "2008-09-12">
 
6
<!ENTITY TIMESTAMP "2008-09-03">
7
7
]>
8
8
 
9
9
<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
36
36
    </copyright>
37
37
    <xi:include href="legalnotice.xml"/>
38
38
  </refentryinfo>
39
 
  
 
39
 
40
40
  <refmeta>
41
41
    <refentrytitle>&COMMANDNAME;</refentrytitle>
42
42
    <manvolnum>8</manvolnum>
48
48
      Generate key and password for Mandos client and server.
49
49
    </refpurpose>
50
50
  </refnamediv>
51
 
  
 
51
 
52
52
  <refsynopsisdiv>
53
53
    <cmdsynopsis>
54
54
      <command>&COMMANDNAME;</command>
159
159
    <para>
160
160
      <command>&COMMANDNAME;</command> is a program to generate the
161
161
      OpenPGP key used by
162
 
      <citerefentry><refentrytitle>mandos-client</refentrytitle>
 
162
      <citerefentry><refentrytitle>password-request</refentrytitle>
163
163
      <manvolnum>8mandos</manvolnum></citerefentry>.  The key is
164
164
      normally written to /etc/mandos for later installation into the
165
165
      initrd image, but this, and most other things, can be changed
197
197
          </para>
198
198
        </listitem>
199
199
      </varlistentry>
200
 
      
 
200
 
201
201
      <varlistentry>
202
202
        <term><option>--dir
203
203
        <replaceable>DIRECTORY</replaceable></option></term>
210
210
          </para>
211
211
        </listitem>
212
212
      </varlistentry>
213
 
      
 
213
 
214
214
      <varlistentry>
215
215
        <term><option>--type
216
216
        <replaceable>TYPE</replaceable></option></term>
222
222
          </para>
223
223
        </listitem>
224
224
      </varlistentry>
225
 
      
 
225
 
226
226
      <varlistentry>
227
227
        <term><option>--length
228
228
        <replaceable>BITS</replaceable></option></term>
234
234
          </para>
235
235
        </listitem>
236
236
      </varlistentry>
237
 
      
 
237
 
238
238
      <varlistentry>
239
239
        <term><option>--subtype
240
240
        <replaceable>KEYTYPE</replaceable></option></term>
247
247
          </para>
248
248
        </listitem>
249
249
      </varlistentry>
250
 
      
 
250
 
251
251
      <varlistentry>
252
252
        <term><option>--sublength
253
253
        <replaceable>BITS</replaceable></option></term>
259
259
          </para>
260
260
        </listitem>
261
261
      </varlistentry>
262
 
      
 
262
 
263
263
      <varlistentry>
264
264
        <term><option>--email
265
265
        <replaceable>ADDRESS</replaceable></option></term>
271
271
          </para>
272
272
        </listitem>
273
273
      </varlistentry>
274
 
      
 
274
 
275
275
      <varlistentry>
276
276
        <term><option>--comment
277
277
        <replaceable>TEXT</replaceable></option></term>
284
284
          </para>
285
285
        </listitem>
286
286
      </varlistentry>
287
 
      
 
287
 
288
288
      <varlistentry>
289
289
        <term><option>--expire
290
290
        <replaceable>TIME</replaceable></option></term>
298
298
          </para>
299
299
        </listitem>
300
300
      </varlistentry>
301
 
      
 
301
 
302
302
      <varlistentry>
303
303
        <term><option>--force</option></term>
304
304
        <term><option>-f</option></term>
328
328
      </varlistentry>
329
329
    </variablelist>
330
330
  </refsect1>
331
 
  
 
331
 
332
332
  <refsect1 id="overview">
333
333
    <title>OVERVIEW</title>
334
334
    <xi:include href="overview.xml"/>
338
338
      <filename>clients.conf</filename> on the server.
339
339
    </para>
340
340
  </refsect1>
341
 
  
 
341
 
342
342
  <refsect1 id="exit_status">
343
343
    <title>EXIT STATUS</title>
344
344
    <para>
401
401
      </varlistentry>
402
402
    </variablelist>
403
403
  </refsect1>
404
 
  
 
404
 
405
405
<!--   <refsect1 id="bugs"> -->
406
406
<!--     <title>BUGS</title> -->
407
407
<!--     <para> -->
408
408
<!--     </para> -->
409
409
<!--   </refsect1> -->
410
 
  
 
410
 
411
411
  <refsect1 id="example">
412
412
    <title>EXAMPLE</title>
413
413
    <informalexample>
454
454
      </para>
455
455
    </informalexample>
456
456
  </refsect1>
457
 
  
 
457
 
458
458
  <refsect1 id="security">
459
459
    <title>SECURITY</title>
460
460
    <para>
469
469
      <manvolnum>8</manvolnum></citerefentry>.
470
470
    </para>
471
471
  </refsect1>
472
 
  
 
472
 
473
473
  <refsect1 id="see_also">
474
474
    <title>SEE ALSO</title>
475
475
    <para>
479
479
      <manvolnum>5</manvolnum></citerefentry>,
480
480
      <citerefentry><refentrytitle>mandos</refentrytitle>
481
481
      <manvolnum>8</manvolnum></citerefentry>,
482
 
      <citerefentry><refentrytitle>mandos-client</refentrytitle>
 
482
      <citerefentry><refentrytitle>password-request</refentrytitle>
483
483
      <manvolnum>8mandos</manvolnum></citerefentry>
484
484
    </para>
485
485
  </refsect1>