/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: 2015-08-02 09:36:40 UTC
  • Revision ID: teddy@recompile.se-20150802093640-nc0n17rbmqlbaxuf
Add D-Bus annotations on a few properties on the Client object.

The D-Bus property "Secret" on the interface
"se.recompile.Mandos.Client" should have the annotation
"org.freedesktop.DBus.Property.EmitsChangedSignal" set to
"invalidates".  Also, the properties "Created", "Fingerprint", "Name",
and "ObjectPath" should have the same annotation set to "const".

* mandos (ClientDBus.Name_dbus_property): Set annotation
                    "org.freedesktop.DBus.Property.EmitsChangedSignal"
                    to "const".
  (ClientDBus.Fingerprint_dbus_property): - '' -
  (ClientDBus.Created_dbus_property): - '' -
  (ClientDBus.ObjectPath_dbus_property): - '' -
  (ClientDBus.Secret_dbus_property): Set annotation
                    "org.freedesktop.DBus.Property.EmitsChangedSignal"
                    to "invalidates".

Show diffs side-by-side

added added

removed removed

Lines of Context:
mandos-keygen.xml
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">
5
4
<!ENTITY COMMANDNAME "mandos-keygen">
6
 
<!ENTITY TIMESTAMP "2008-09-20">
 
5
<!ENTITY TIMESTAMP "2015-07-20">
 
6
<!ENTITY % common SYSTEM "common.ent">
 
7
%common;
7
8
]>
8
9
 
9
10
<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
11
12
    <title>Mandos Manual</title>
12
13
    <!-- NWalsh’s docbook scripts use this to generate the footer: -->
13
14
    <productname>Mandos</productname>
14
 
    <productnumber>&VERSION;</productnumber>
 
15
    <productnumber>&version;</productnumber>
15
16
    <date>&TIMESTAMP;</date>
16
17
    <authorgroup>
17
18
      <author>
18
19
        <firstname>Björn</firstname>
19
20
        <surname>Påhlsson</surname>
20
21
        <address>
21
 
          <email>belorn@fukt.bsnet.se</email>
 
22
          <email>belorn@recompile.se</email>
22
23
        </address>
23
24
      </author>
24
25
      <author>
25
26
        <firstname>Teddy</firstname>
26
27
        <surname>Hogeborn</surname>
27
28
        <address>
28
 
          <email>teddy@fukt.bsnet.se</email>
 
29
          <email>teddy@recompile.se</email>
29
30
        </address>
30
31
      </author>
31
32
    </authorgroup>
32
33
    <copyright>
33
34
      <year>2008</year>
 
35
      <year>2009</year>
 
36
      <year>2010</year>
 
37
      <year>2011</year>
 
38
      <year>2012</year>
 
39
      <year>2013</year>
 
40
      <year>2014</year>
 
41
      <year>2015</year>
34
42
      <holder>Teddy Hogeborn</holder>
35
43
      <holder>Björn Påhlsson</holder>
36
44
    </copyright>
115
123
        <replaceable>TIME</replaceable></option></arg>
116
124
      </group>
117
125
      <sbr/>
118
 
      <arg><option>--force</option></arg>
 
126
      <group>
 
127
        <arg choice="plain"><option>--force</option></arg>
 
128
        <arg choice="plain"><option>-f</option></arg>
 
129
      </group>
119
130
    </cmdsynopsis>
120
131
    <cmdsynopsis>
121
132
      <command>&COMMANDNAME;</command>
141
152
        <arg choice="plain"><option>-n
142
153
        <replaceable>NAME</replaceable></option></arg>
143
154
      </group>
 
155
      <group>
 
156
        <arg choice="plain"><option>--no-ssh</option></arg>
 
157
        <arg choice="plain"><option>-S</option></arg>
 
158
      </group>
144
159
    </cmdsynopsis>
145
160
    <cmdsynopsis>
146
161
      <command>&COMMANDNAME;</command>
211
226
        <listitem>
212
227
          <para>
213
228
            Target directory for key files.  Default is
214
 
            <filename>/etc/mandos</filename>.
 
229
            <filename class="directory">/etc/mandos</filename>.
215
230
          </para>
216
231
        </listitem>
217
232
      </varlistentry>
223
238
        <replaceable>TYPE</replaceable></option></term>
224
239
        <listitem>
225
240
          <para>
226
 
            Key type.  Default is <quote>DSA</quote>.
 
241
            Key type.  Default is <quote>RSA</quote>.
227
242
          </para>
228
243
        </listitem>
229
244
      </varlistentry>
235
250
        <replaceable>BITS</replaceable></option></term>
236
251
        <listitem>
237
252
          <para>
238
 
            Key length in bits.  Default is 2048.
 
253
            Key length in bits.  Default is 4096.
239
254
          </para>
240
255
        </listitem>
241
256
      </varlistentry>
247
262
        <replaceable>KEYTYPE</replaceable></option></term>
248
263
        <listitem>
249
264
          <para>
250
 
            Subkey type.  Default is <quote>ELG-E</quote> (Elgamal
 
265
            Subkey type.  Default is <quote>RSA</quote> (Elgamal
251
266
            encryption-only).
252
267
          </para>
253
268
        </listitem>
260
275
        <replaceable>BITS</replaceable></option></term>
261
276
        <listitem>
262
277
          <para>
263
 
            Subkey length in bits.  Default is 2048.
 
278
            Subkey length in bits.  Default is 4096.
264
279
          </para>
265
280
        </listitem>
266
281
      </varlistentry>
284
299
        <replaceable>TEXT</replaceable></option></term>
285
300
        <listitem>
286
301
          <para>
287
 
            Comment field for key.  The default value is
288
 
            <quote><literal>Mandos client key</literal></quote>.
 
302
            Comment field for key.  Default is empty.
289
303
          </para>
290
304
        </listitem>
291
305
      </varlistentry>
343
357
          </para>
344
358
        </listitem>
345
359
      </varlistentry>
 
360
      <varlistentry>
 
361
        <term><option>--no-ssh</option></term>
 
362
        <term><option>-S</option></term>
 
363
        <listitem>
 
364
          <para>
 
365
            When <option>--password</option> or
 
366
            <option>--passfile</option> is given, this option will
 
367
            prevent <command>&COMMANDNAME;</command> from calling
 
368
            <command>ssh-keyscan</command> to get an SSH fingerprint
 
369
            for this host and, if successful, output suitable config
 
370
            options to use this fingerprint as a
 
371
            <option>checker</option> option in the output.  This is
 
372
            otherwise the default behavior.
 
373
          </para>
 
374
        </listitem>
 
375
      </varlistentry>
346
376
    </variablelist>
347
377
  </refsect1>
348
378
  
381
411
    </variablelist>
382
412
  </refsect1>
383
413
  
384
 
  <refsect1 id="file">
 
414
  <refsect1 id="files">
385
415
    <title>FILES</title>
386
416
    <para>
387
417
      Use the <option>--dir</option> option to change where
408
438
        </listitem>
409
439
      </varlistentry>
410
440
      <varlistentry>
411
 
        <term><filename>/tmp</filename></term>
 
441
        <term><filename class="directory">/tmp</filename></term>
412
442
        <listitem>
413
443
          <para>
414
444
            Temporary files will be written here if
449
479
    </informalexample>
450
480
    <informalexample>
451
481
      <para>
452
 
        Prompt for a password, encrypt it with the key in
453
 
        <filename>/etc/mandos</filename> and output a section suitable
454
 
        for <filename>clients.conf</filename>.
 
482
        Prompt for a password, encrypt it with the key in <filename
 
483
        class="directory">/etc/mandos</filename> and output a section
 
484
        suitable for <filename>clients.conf</filename>.
455
485
      </para>
456
486
      <para>
457
487
        <userinput>&COMMANDNAME; --password</userinput>
490
520
  <refsect1 id="see_also">
491
521
    <title>SEE ALSO</title>
492
522
    <para>
 
523
      <citerefentry><refentrytitle>intro</refentrytitle>
 
524
      <manvolnum>8mandos</manvolnum></citerefentry>,
493
525
      <citerefentry><refentrytitle>gpg</refentrytitle>
494
526
      <manvolnum>1</manvolnum></citerefentry>,
495
527
      <citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
497
529
      <citerefentry><refentrytitle>mandos</refentrytitle>
498
530
      <manvolnum>8</manvolnum></citerefentry>,
499
531
      <citerefentry><refentrytitle>mandos-client</refentrytitle>
500
 
      <manvolnum>8mandos</manvolnum></citerefentry>
 
532
      <manvolnum>8mandos</manvolnum></citerefentry>,
 
533
      <citerefentry><refentrytitle>ssh-keyscan</refentrytitle>
 
534
      <manvolnum>1</manvolnum></citerefentry>
501
535
    </para>
502
536
  </refsect1>
503
537