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

  • Committer: teddy at bsnet
  • Date: 2010-08-10 19:08:24 UTC
  • mto: (237.2.182 mandos-local)
  • mto: This revision was merged to the branch mainline in revision 270.
  • Revision ID: teddy@fukt.bsnet.se-20100810190824-5yquozxy4kh6py3f
* plugins.d/mandos-client.c: An empty interface name now means to
                             autodetect an interface; to specify no
                             particular interface, use "none".
  (sys_class_net): New global variable for the "/sys/class/net" path.
  (good_interface): New function to determine the suitability of an
                    interface.  Used by a scandir() call in main().
  (main): Changed default value for "interface" to the empty string.
          Moved "connect_to" to be a global variable.  Only take down
          and up interface if its name is not "none".
* plugins.d/mandos-client.xml (OPTIONS): Update documentation for the
                                         "--interface" option.

Show diffs side-by-side

added added

removed removed

Lines of Context:
mandos.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">
5
 
<!ENTITY TIMESTAMP "2008-09-30">
 
5
<!ENTITY TIMESTAMP "2009-09-17">
6
6
<!ENTITY % common SYSTEM "common.ent">
7
7
%common;
8
8
]>
32
32
    </authorgroup>
33
33
    <copyright>
34
34
      <year>2008</year>
 
35
      <year>2009</year>
35
36
      <holder>Teddy Hogeborn</holder>
36
37
      <holder>Björn Påhlsson</holder>
37
38
    </copyright>
84
85
      <replaceable>DIRECTORY</replaceable></option></arg>
85
86
      <sbr/>
86
87
      <arg><option>--debug</option></arg>
 
88
      <sbr/>
 
89
      <arg><option>--no-ipv6</option></arg>
87
90
    </cmdsynopsis>
88
91
    <cmdsynopsis>
89
92
      <command>&COMMANDNAME;</command>
228
231
          </para>
229
232
        </listitem>
230
233
      </varlistentry>
 
234
      
 
235
      <varlistentry>
 
236
        <term><option>--no-ipv6</option></term>
 
237
        <listitem>
 
238
          <xi:include href="mandos-options.xml" xpointer="ipv6"/>
 
239
        </listitem>
 
240
      </varlistentry>
231
241
    </variablelist>
232
242
  </refsect1>
233
243
  
305
315
      The server will, by default, continually check that the clients
306
316
      are still up.  If a client has not been confirmed as being up
307
317
      for some time, the client is assumed to be compromised and is no
308
 
      longer eligible to receive the encrypted password.  The timeout,
 
318
      longer eligible to receive the encrypted password.  (Manual
 
319
      intervention is required to re-enable a client.)  The timeout,
309
320
      checker program, and interval between checks can be configured
310
321
      both globally and per client; see <citerefentry>
311
322
      <refentrytitle>mandos-clients.conf</refentrytitle>
312
 
      <manvolnum>5</manvolnum></citerefentry>.
 
323
      <manvolnum>5</manvolnum></citerefentry>.  A client successfully
 
324
      receiving its password will also be treated as a successful
 
325
      checker run.
313
326
    </para>
314
327
  </refsect1>
315
328
  
351
364
    </variablelist>
352
365
  </refsect1>
353
366
  
354
 
  <refsect1 id="file">
 
367
  <refsect1 id="files">
355
368
    <title>FILES</title>
356
369
    <para>
357
370
      Use the <option>--configdir</option> option to change where
421
434
      Currently, if a client is declared <quote>invalid</quote> due to
422
435
      having timed out, the server does not record this fact onto
423
436
      permanent storage.  This has some security implications, see
424
 
      <xref linkend="CLIENTS"/>.
 
437
      <xref linkend="clients"/>.
425
438
    </para>
426
439
    <para>
427
440
      There is currently no way of querying the server of the current
435
448
      Debug mode is conflated with running in the foreground.
436
449
    </para>
437
450
    <para>
438
 
      The console log messages does not show a time stamp.
 
451
      The console log messages do not show a time stamp.
439
452
    </para>
440
453
    <para>
441
454
      This server does not check the expire time of clients’ OpenPGP
483
496
  
484
497
  <refsect1 id="security">
485
498
    <title>SECURITY</title>
486
 
    <refsect2 id="SERVER">
 
499
    <refsect2 id="server">
487
500
      <title>SERVER</title>
488
501
      <para>
489
502
        Running this <command>&COMMANDNAME;</command> server program
492
505
        soon after startup.
493
506
      </para>
494
507
    </refsect2>
495
 
    <refsect2 id="CLIENTS">
 
508
    <refsect2 id="clients">
496
509
      <title>CLIENTS</title>
497
510
      <para>
498
511
        The server only gives out its stored data to clients which