/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 plugins.d/mandos-client.xml

  • Committer: Teddy Hogeborn
  • Date: 2015-08-10 07:34:37 UTC
  • Revision ID: teddy@recompile.se-20150810073437-3m8jgt13nqric6vf
Revert change to D-Bus API.

The D-Bus API signal CheckerCompleted is documented to provide a
wait(2) status value.  Since the server switched to using subprocess
to run checkers, it no longer has access to a wait(2) status value.  A
previous change to work around this made the D-Bus API incompatible.
Revert this change by constructing a fake wait(2) status value; this
keeps the D-Bus API stable.

* DBUS-API (CheckerCompleted): Revert incompatible change.
* mandos (ClientDBus.checker_callback): Construct fake wait(2) status.
* mandos-monitor (MandosClientWidget.checker_completed): Revert to
                                                         using
                                                         original API
                                                         with wait(2)
                                                         condition
                                                         value.

Show diffs side-by-side

added added

removed removed

Lines of Context:
plugins.d/mandos-client.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-client">
5
 
<!ENTITY TIMESTAMP "2012-06-13">
 
5
<!ENTITY TIMESTAMP "2015-07-20">
6
6
<!ENTITY % common SYSTEM "../common.ent">
7
7
%common;
8
8
]>
33
33
    <copyright>
34
34
      <year>2008</year>
35
35
      <year>2009</year>
 
36
      <year>2010</year>
 
37
      <year>2011</year>
36
38
      <year>2012</year>
 
39
      <year>2013</year>
 
40
      <year>2014</year>
 
41
      <year>2015</year>
37
42
      <holder>Teddy Hogeborn</holder>
38
43
      <holder>Björn Påhlsson</holder>
39
44
    </copyright>
96
101
      </arg>
97
102
      <sbr/>
98
103
      <arg>
 
104
        <option>--dh-params <replaceable>FILE</replaceable></option>
 
105
      </arg>
 
106
      <sbr/>
 
107
      <arg>
99
108
        <option>--delay <replaceable>SECONDS</replaceable></option>
100
109
      </arg>
101
110
      <sbr/>
218
227
            assumed to separate the address from the port number.
219
228
          </para>
220
229
          <para>
221
 
            This option is normally only useful for testing and
222
 
            debugging.
 
230
            Normally, Zeroconf would be used to locate Mandos servers,
 
231
            in which case this option would only be used when testing
 
232
            and debugging.
223
233
          </para>
224
234
        </listitem>
225
235
      </varlistentry>
226
236
      
227
237
      <varlistentry>
228
238
        <term><option>--interface=<replaceable
229
 
        >NAME</replaceable></option></term>
 
239
        >NAME</replaceable><arg rep='repeat'>,<replaceable
 
240
        >NAME</replaceable></arg></option></term>
230
241
        <term><option>-i
231
 
        <replaceable>NAME</replaceable></option></term>
 
242
        <replaceable>NAME</replaceable><arg rep='repeat'>,<replaceable
 
243
        >NAME</replaceable></arg></option></term>
232
244
        <listitem>
233
245
          <para>
234
246
            Comma separated list of network interfaces that will be
237
249
            use all appropriate interfaces.
238
250
          </para>
239
251
          <para>
240
 
            If the <option>--connect</option> option is used, this
241
 
            specifies the interface to use to connect to the address
242
 
            given.
 
252
            If the <option>--connect</option> option is used, and
 
253
            exactly one interface name is specified (except
 
254
            <quote><literal>none</literal></quote>), this specifies
 
255
            the interface to use to connect to the address given.
243
256
          </para>
244
257
          <para>
245
258
            Note that since this program will normally run in the
254
267
          </para>
255
268
          <para>
256
269
            <replaceable>NAME</replaceable> can be the string
257
 
            <quote><literal>none</literal></quote>; this will not use
258
 
            any specific interface, and will not bring up an interface
259
 
            on startup.  This is not recommended, and only meant for
260
 
            advanced users.
 
270
            <quote><literal>none</literal></quote>; this will make
 
271
            <command>&COMMANDNAME;</command> only bring up interfaces
 
272
            specified <emphasis>before</emphasis> this string.  This
 
273
            is not recommended, and only meant for advanced users.
261
274
          </para>
262
275
        </listitem>
263
276
      </varlistentry>
305
318
        <listitem>
306
319
          <para>
307
320
            Sets the number of bits to use for the prime number in the
308
 
            TLS Diffie-Hellman key exchange.  Default is 1024.
 
321
            TLS Diffie-Hellman key exchange.  The default value is
 
322
            selected automatically based on the OpenPGP key.  Note
 
323
            that if the <option>--dh-params</option> option is used,
 
324
            the values from that file will be used instead.
 
325
          </para>
 
326
        </listitem>
 
327
      </varlistentry>
 
328
      
 
329
      <varlistentry>
 
330
        <term><option>--dh-params=<replaceable
 
331
        >FILE</replaceable></option></term>
 
332
        <listitem>
 
333
          <para>
 
334
            Specifies a PEM-encoded PKCS#3 file to read the parameters
 
335
            needed by the TLS Diffie-Hellman key exchange from.  If
 
336
            this option is not given, or if the file for some reason
 
337
            could not be used, the parameters will be generated on
 
338
            startup, which will take some time and processing power.
 
339
            Those using servers running under time, power or processor
 
340
            constraints may want to generate such a file in advance
 
341
            and use this option.
309
342
          </para>
310
343
        </listitem>
311
344
      </varlistentry>
438
471
  
439
472
  <refsect1 id="environment">
440
473
    <title>ENVIRONMENT</title>
 
474
    <variablelist>
 
475
      <varlistentry>
 
476
        <term><envar>MANDOSPLUGINHELPERDIR</envar></term>
 
477
        <listitem>
 
478
          <para>
 
479
            This environment variable will be assumed to contain the
 
480
            directory containing any helper executables.  The use and
 
481
            nature of these helper executables, if any, is
 
482
            purposefully not documented.
 
483
        </para>
 
484
        </listitem>
 
485
      </varlistentry>
 
486
    </variablelist>
441
487
    <para>
442
 
      This program does not use any environment variables, not even
443
 
      the ones provided by <citerefentry><refentrytitle
 
488
      This program does not use any other environment variables, not
 
489
      even the ones provided by <citerefentry><refentrytitle
444
490
      >cryptsetup</refentrytitle><manvolnum>8</manvolnum>
445
491
    </citerefentry>.
446
492
    </para>
508
554
              It is not necessary to print any non-executable files
509
555
              already in the network hook directory, these will be
510
556
              copied implicitly if they otherwise satisfy the name
511
 
              requirement.
 
557
              requirements.
512
558
            </para>
513
559
          </listitem>
514
560
        </varlistentry>
662
708
    </para>
663
709
    <informalexample>
664
710
      <para>
665
 
        Normal invocation needs no options, if the network interface
 
711
        Normal invocation needs no options, if the network interfaces
666
712
        can be automatically determined:
667
713
      </para>
668
714
      <para>
671
717
    </informalexample>
672
718
    <informalexample>
673
719
      <para>
674
 
        Search for Mandos servers (and connect to them) using another
675
 
        interface:
 
720
        Search for Mandos servers (and connect to them) using one
 
721
        specific interface:
676
722
      </para>
677
723
      <para>
678
724
        <!-- do not wrap this line -->
742
788
    <para>
743
789
      It will also help if the checker program on the server is
744
790
      configured to request something from the client which can not be
745
 
      spoofed by someone else on the network, unlike unencrypted
746
 
      <acronym>ICMP</acronym> echo (<quote>ping</quote>) replies.
 
791
      spoofed by someone else on the network, like SSH server key
 
792
      fingerprints, and unlike unencrypted <acronym>ICMP</acronym>
 
793
      echo (<quote>ping</quote>) replies.
747
794
    </para>
748
795
    <para>
749
796
      <emphasis>Note</emphasis>: This makes it completely insecure to
842
889
              <para>
843
890
                This client uses IPv6 link-local addresses, which are
844
891
                immediately usable since a link-local addresses is
845
 
                automatically assigned to a network interfaces when it
 
892
                automatically assigned to a network interface when it
846
893
                is brought up.
847
894
              </para>
848
895
            </listitem>