/mandos/release

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

« back to all changes in this revision

Viewing changes to plugins.d/mandos-client.xml

* plugins.d/mandos-client.xml (DESCRIPTION): Mention the bringing up
                                             of a network interface.

Show diffs side-by-side

added added

removed removed

Lines of Context:
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 "2010-09-26">
 
5
<!ENTITY TIMESTAMP "2009-01-24">
6
6
<!ENTITY % common SYSTEM "../common.ent">
7
7
%common;
8
8
]>
93
93
      </arg>
94
94
      <sbr/>
95
95
      <arg>
96
 
        <option>--delay <replaceable>SECONDS</replaceable></option>
97
 
      </arg>
98
 
      <sbr/>
99
 
      <arg>
100
 
        <option>--retry <replaceable>SECONDS</replaceable></option>
101
 
      </arg>
102
 
      <sbr/>
103
 
      <arg>
104
96
        <option>--debug</option>
105
97
      </arg>
106
98
    </cmdsynopsis>
130
122
      <command>&COMMANDNAME;</command> is a client program that
131
123
      communicates with <citerefentry><refentrytitle
132
124
      >mandos</refentrytitle><manvolnum>8</manvolnum></citerefentry>
133
 
      to get a password.  In slightly more detail, this client program
134
 
      brings up a network interface, uses the interface’s IPv6
135
 
      link-local address to get network connectivity, uses Zeroconf to
136
 
      find servers on the local network, and communicates with servers
137
 
      using TLS with an OpenPGP key to ensure authenticity and
138
 
      confidentiality.  This client program keeps running, trying all
139
 
      servers on the network, until it receives a satisfactory reply
140
 
      or a TERM signal is received.  If no servers are found, or after
141
 
      all servers have been tried, it waits indefinitely for new
142
 
      servers to appear.
 
125
      to get a password.  It brings up a network interface, uses its
 
126
      IPv6 link-local address to get network connectivity, uses
 
127
      Zeroconf to find servers, and uses TLS with an OpenPGP key to
 
128
      ensure authenticity and confidentiality.  It keeps running,
 
129
      trying all servers on the network, until it receives a
 
130
      satisfactory reply or a TERM signal is received.
143
131
    </para>
144
132
    <para>
145
133
      This program is not meant to be run directly; it is really meant
199
187
      </varlistentry>
200
188
      
201
189
      <varlistentry>
202
 
        <term><option>--interface=<replaceable
203
 
        >NAME</replaceable></option></term>
 
190
        <term><option>--interface=
 
191
        <replaceable>NAME</replaceable></option></term>
204
192
        <term><option>-i
205
193
        <replaceable>NAME</replaceable></option></term>
206
194
        <listitem>
207
195
          <para>
208
196
            Network interface that will be brought up and scanned for
209
 
            Mandos servers to connect to.  The default is the empty
210
 
            string, which will automatically choose an appropriate
211
 
            interface.
 
197
            Mandos servers to connect to.  The default it
 
198
            <quote><literal>eth0</literal></quote>.
212
199
          </para>
213
200
          <para>
214
201
            If the <option>--connect</option> option is used, this
215
202
            specifies the interface to use to connect to the address
216
203
            given.
217
204
          </para>
218
 
          <para>
219
 
            Note that since this program will normally run in the
220
 
            initial RAM disk environment, the interface must be an
221
 
            interface which exists at that stage.  Thus, the interface
222
 
            can not be a pseudo-interface such as <quote>br0</quote>
223
 
            or <quote>tun0</quote>; such interfaces will not exist
224
 
            until much later in the boot process, and can not be used
225
 
            by this program.
226
 
          </para>
227
 
          <para>
228
 
            <replaceable>NAME</replaceable> can be the string
229
 
            <quote><literal>none</literal></quote>; this will not use
230
 
            any specific interface, and will not bring up an interface
231
 
            on startup.  This is not recommended, and only meant for
232
 
            advanced users.
233
 
          </para>
234
205
        </listitem>
235
206
      </varlistentry>
236
207
      
281
252
          </para>
282
253
        </listitem>
283
254
      </varlistentry>
284
 
 
285
 
      <varlistentry>
286
 
        <term><option>--delay=<replaceable
287
 
        >SECONDS</replaceable></option></term>
288
 
        <listitem>
289
 
          <para>
290
 
            After bringing the network interface up, the program waits
291
 
            for the interface to arrive in a <quote>running</quote>
292
 
            state before proceeding.  During this time, the kernel log
293
 
            level will be lowered to reduce clutter on the system
294
 
            console, alleviating any other plugins which might be
295
 
            using the system console.  This option sets the upper
296
 
            limit of seconds to wait.  The default is 2.5 seconds.
297
 
          </para>
298
 
        </listitem>
299
 
      </varlistentry>
300
 
 
301
 
      <varlistentry>
302
 
        <term><option>--retry=<replaceable
303
 
        >SECONDS</replaceable></option></term>
304
 
        <listitem>
305
 
          <para>
306
 
            All Mandos servers servers are tried repeatedly until a
307
 
            password is received.  This value specifies, in seconds,
308
 
            how long between each successive try <emphasis>for the
309
 
            same server</emphasis>.  The default is 10 seconds.
310
 
          </para>
311
 
        </listitem>
312
 
      </varlistentry>
313
255
      
314
256
      <varlistentry>
315
257
        <term><option>--debug</option></term>
471
413
    <informalexample>
472
414
      <para>
473
415
        Run in debug mode, with a custom key, and do not use Zeroconf
474
 
        to locate a server; connect directly to the IPv6 link-local
475
 
        address <quote><systemitem class="ipaddress"
476
 
        >fe80::aede:48ff:fe71:f6f2</systemitem></quote>, port 4711,
477
 
        using interface eth2:
 
416
        to locate a server; connect directly to the IPv6 address
 
417
        <quote><systemitem class="ipaddress"
 
418
        >2001:db8:f983:bd0b:30de:ae4a:71f2:f672</systemitem></quote>,
 
419
        port 4711, using interface eth2:
478
420
      </para>
479
421
      <para>
480
422
 
481
423
<!-- do not wrap this line -->
482
 
<userinput>&COMMANDNAME; --debug --pubkey keydir/pubkey.txt --seckey keydir/seckey.txt --connect fe80::aede:48ff:fe71:f6f2:4711 --interface eth2</userinput>
 
424
<userinput>&COMMANDNAME; --debug --pubkey keydir/pubkey.txt --seckey keydir/seckey.txt --connect 2001:db8:f983:bd0b:30de:ae4a:71f2:f672:4711 --interface eth2</userinput>
483
425
 
484
426
      </para>
485
427
    </informalexample>