/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-clients.conf.xml

  • Committer: Teddy Hogeborn
  • Date: 2011-07-16 00:29:19 UTC
  • Revision ID: teddy@fukt.bsnet.se-20110716002919-r77yikuiulj42o40
* initramfs-tools-script: Abort if plugin-runner is missing.  Removed
                          workaround for Debian bug #633582; the
                          workaround required getopt, which can not be
                          guaranteed.
* plugin-runner.c (main): Work around Debian bug #633582.
* plugins.d/mandos-client.c (main): - '' -

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 CONFNAME "mandos-clients.conf">
5
5
<!ENTITY CONFPATH "<filename>/etc/mandos/clients.conf</filename>">
6
 
<!ENTITY TIMESTAMP "2011-11-26">
 
6
<!ENTITY TIMESTAMP "2011-02-27">
7
7
<!ENTITY % common SYSTEM "common.ent">
8
8
%common;
9
9
]>
20
20
        <firstname>Björn</firstname>
21
21
        <surname>Påhlsson</surname>
22
22
        <address>
23
 
          <email>belorn@recompile.se</email>
 
23
          <email>belorn@fukt.bsnet.se</email>
24
24
        </address>
25
25
      </author>
26
26
      <author>
27
27
        <firstname>Teddy</firstname>
28
28
        <surname>Hogeborn</surname>
29
29
        <address>
30
 
          <email>teddy@recompile.se</email>
 
30
          <email>teddy@fukt.bsnet.se</email>
31
31
        </address>
32
32
      </author>
33
33
    </authorgroup>
182
182
      </varlistentry>
183
183
      
184
184
      <varlistentry>
185
 
        <term><option>extended_timeout<literal> = </literal><replaceable
186
 
        >TIME</replaceable></option></term>
187
 
        <listitem>
188
 
          <para>
189
 
            This option is <emphasis>optional</emphasis>.
190
 
          </para>
191
 
          <para>
192
 
            Extended timeout is an added timeout that is given once
193
 
            after a password has been sent successfully to a client.
194
 
            The timeout is by default longer than the normal timeout,
195
 
            and is used for handling the extra long downtime while a
196
 
            machine is booting up.  Time to take into consideration
197
 
            when changing this value is file system checks and quota
198
 
            checks.  The default value is 15 minutes.
199
 
          </para>
200
 
          <para>
201
 
            The format of <replaceable>TIME</replaceable> is the same
202
 
            as for <varname>timeout</varname> below.
203
 
          </para>
204
 
        </listitem>
205
 
      </varlistentry>
206
 
      
207
 
      <varlistentry>
208
185
        <term><option>fingerprint<literal> = </literal
209
186
        ><replaceable>HEXSTRING</replaceable></option></term>
210
187
        <listitem>
252
229
            will wait for a checker to complete until the below
253
230
            <quote><varname>timeout</varname></quote> occurs, at which
254
231
            time the client will be disabled, and any running checker
255
 
            killed.  The default interval is 2 minutes.
 
232
            killed.  The default interval is 5 minutes.
256
233
          </para>
257
234
          <para>
258
235
            The format of <replaceable>TIME</replaceable> is the same
322
299
            This option is <emphasis>optional</emphasis>.
323
300
          </para>
324
301
          <para>
325
 
            The timeout is how long the server will wait, after a
326
 
            successful checker run, until a client is disabled and not
327
 
            allowed to get the data this server holds.  By default
328
 
            Mandos will use 5 minutes.  See also the
329
 
            <option>extended_timeout</option> option.
 
302
            The timeout is how long the server will wait (for either a
 
303
            successful checker run or a client receiving its secret)
 
304
            until a client is disabled and not allowed to get the data
 
305
            this server holds.  By default Mandos will use 1 hour.
330
306
          </para>
331
307
          <para>
332
308
            The <replaceable>TIME</replaceable> is specified as a
344
320
        </listitem>
345
321
      </varlistentry>
346
322
      
347
 
      <varlistentry>
348
 
        <term><option>enabled<literal> = </literal>{ <literal
349
 
        >1</literal> | <literal>yes</literal> | <literal>true</literal
350
 
        > | <literal >on</literal> | <literal>0</literal> | <literal
351
 
        >no</literal> | <literal>false</literal> | <literal
352
 
        >off</literal> }</option></term>
353
 
        <listitem>
354
 
          <para>
355
 
            Whether this client should be enabled by default.  The
356
 
            default is <quote>true</quote>.
357
 
          </para>
358
 
        </listitem>
359
 
      </varlistentry>
360
 
      
361
323
    </variablelist>
362
324
  </refsect1>
363
325
  
458
420
    <informalexample>
459
421
      <programlisting>
460
422
[DEFAULT]
461
 
timeout = 5m
462
 
interval = 2m
 
423
timeout = 1h
 
424
interval = 5m
463
425
checker = fping -q -- %%(host)s
464
426
 
465
427
# Client "foo"
498
460
  <refsect1 id="see_also">
499
461
    <title>SEE ALSO</title>
500
462
    <para>
501
 
      <citerefentry><refentrytitle>intro</refentrytitle>
502
 
      <manvolnum>8mandos</manvolnum></citerefentry>,
503
463
      <citerefentry><refentrytitle>mandos-keygen</refentrytitle>
504
464
      <manvolnum>8</manvolnum></citerefentry>,
505
465
      <citerefentry><refentrytitle>mandos.conf</refentrytitle>