/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
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
4
<!ENTITY COMMANDNAME "mandos-keygen">
5
 
<!ENTITY TIMESTAMP "2008-09-30">
 
5
<!ENTITY TIMESTAMP "2015-07-20">
6
6
<!ENTITY % common SYSTEM "common.ent">
7
7
%common;
8
8
]>
19
19
        <firstname>Björn</firstname>
20
20
        <surname>Påhlsson</surname>
21
21
        <address>
22
 
          <email>belorn@fukt.bsnet.se</email>
 
22
          <email>belorn@recompile.se</email>
23
23
        </address>
24
24
      </author>
25
25
      <author>
26
26
        <firstname>Teddy</firstname>
27
27
        <surname>Hogeborn</surname>
28
28
        <address>
29
 
          <email>teddy@fukt.bsnet.se</email>
 
29
          <email>teddy@recompile.se</email>
30
30
        </address>
31
31
      </author>
32
32
    </authorgroup>
33
33
    <copyright>
34
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>
35
42
      <holder>Teddy Hogeborn</holder>
36
43
      <holder>Björn Påhlsson</holder>
37
44
    </copyright>
116
123
        <replaceable>TIME</replaceable></option></arg>
117
124
      </group>
118
125
      <sbr/>
119
 
      <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>
120
130
    </cmdsynopsis>
121
131
    <cmdsynopsis>
122
132
      <command>&COMMANDNAME;</command>
142
152
        <arg choice="plain"><option>-n
143
153
        <replaceable>NAME</replaceable></option></arg>
144
154
      </group>
 
155
      <group>
 
156
        <arg choice="plain"><option>--no-ssh</option></arg>
 
157
        <arg choice="plain"><option>-S</option></arg>
 
158
      </group>
145
159
    </cmdsynopsis>
146
160
    <cmdsynopsis>
147
161
      <command>&COMMANDNAME;</command>
212
226
        <listitem>
213
227
          <para>
214
228
            Target directory for key files.  Default is
215
 
            <filename>/etc/mandos</filename>.
 
229
            <filename class="directory">/etc/mandos</filename>.
216
230
          </para>
217
231
        </listitem>
218
232
      </varlistentry>
224
238
        <replaceable>TYPE</replaceable></option></term>
225
239
        <listitem>
226
240
          <para>
227
 
            Key type.  Default is <quote>DSA</quote>.
 
241
            Key type.  Default is <quote>RSA</quote>.
228
242
          </para>
229
243
        </listitem>
230
244
      </varlistentry>
236
250
        <replaceable>BITS</replaceable></option></term>
237
251
        <listitem>
238
252
          <para>
239
 
            Key length in bits.  Default is 2048.
 
253
            Key length in bits.  Default is 4096.
240
254
          </para>
241
255
        </listitem>
242
256
      </varlistentry>
248
262
        <replaceable>KEYTYPE</replaceable></option></term>
249
263
        <listitem>
250
264
          <para>
251
 
            Subkey type.  Default is <quote>ELG-E</quote> (Elgamal
 
265
            Subkey type.  Default is <quote>RSA</quote> (Elgamal
252
266
            encryption-only).
253
267
          </para>
254
268
        </listitem>
261
275
        <replaceable>BITS</replaceable></option></term>
262
276
        <listitem>
263
277
          <para>
264
 
            Subkey length in bits.  Default is 2048.
 
278
            Subkey length in bits.  Default is 4096.
265
279
          </para>
266
280
        </listitem>
267
281
      </varlistentry>
285
299
        <replaceable>TEXT</replaceable></option></term>
286
300
        <listitem>
287
301
          <para>
288
 
            Comment field for key.  The default value is
289
 
            <quote><literal>Mandos client key</literal></quote>.
 
302
            Comment field for key.  Default is empty.
290
303
          </para>
291
304
        </listitem>
292
305
      </varlistentry>
344
357
          </para>
345
358
        </listitem>
346
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>
347
376
    </variablelist>
348
377
  </refsect1>
349
378
  
382
411
    </variablelist>
383
412
  </refsect1>
384
413
  
385
 
  <refsect1 id="file">
 
414
  <refsect1 id="files">
386
415
    <title>FILES</title>
387
416
    <para>
388
417
      Use the <option>--dir</option> option to change where
409
438
        </listitem>
410
439
      </varlistentry>
411
440
      <varlistentry>
412
 
        <term><filename>/tmp</filename></term>
 
441
        <term><filename class="directory">/tmp</filename></term>
413
442
        <listitem>
414
443
          <para>
415
444
            Temporary files will be written here if
450
479
    </informalexample>
451
480
    <informalexample>
452
481
      <para>
453
 
        Prompt for a password, encrypt it with the key in
454
 
        <filename>/etc/mandos</filename> and output a section suitable
455
 
        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>.
456
485
      </para>
457
486
      <para>
458
487
        <userinput>&COMMANDNAME; --password</userinput>
491
520
  <refsect1 id="see_also">
492
521
    <title>SEE ALSO</title>
493
522
    <para>
 
523
      <citerefentry><refentrytitle>intro</refentrytitle>
 
524
      <manvolnum>8mandos</manvolnum></citerefentry>,
494
525
      <citerefentry><refentrytitle>gpg</refentrytitle>
495
526
      <manvolnum>1</manvolnum></citerefentry>,
496
527
      <citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
498
529
      <citerefentry><refentrytitle>mandos</refentrytitle>
499
530
      <manvolnum>8</manvolnum></citerefentry>,
500
531
      <citerefentry><refentrytitle>mandos-client</refentrytitle>
501
 
      <manvolnum>8mandos</manvolnum></citerefentry>
 
532
      <manvolnum>8mandos</manvolnum></citerefentry>,
 
533
      <citerefentry><refentrytitle>ssh-keyscan</refentrytitle>
 
534
      <manvolnum>1</manvolnum></citerefentry>
502
535
    </para>
503
536
  </refsect1>
504
537