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

  • Committer: Teddy Hogeborn
  • Date: 2008-07-20 06:33:48 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080720063348-jscgy5p0itrgvlo8
* mandos-clients.conf ([foo]): Uncommented.
  ([foo]/secret): New.
  ([foo]/secfile): Commented out.
  ([foo]/checker): Changed to "fping -q -- %%(fqdn)s".
  ([foo]/timeout): New.

* server.py: New modeline for Python and Emacs.  Set a logging format.
  (Client.__init__): Bug fix: Choose either the value from the options
                     object or pass the argument through string_to_delta
                     for both "timeout" and "interval".
  (Client.checker_callback): Bug fix: Do not log spurious "Checker for
                             <foo> failed" messages.
  (Client.start_checker): Moved "Starting checker" log message down to
                          just before actually starting the subprocess.
                          Do not redirect the subprocesses' stdout to a
                          pipe.
  (peer_certificate, fingerprint): Added docstrings.
  (entry_group_state_changed): Call "killme()" instead of
                               "main_loop.quit()".
  (daemon, killme): New functions.
  (exitstatus, main_loop_started): New global variables.
  (__main__): Removed the "--cert", "--key", "--ca", and "--crl"
              options.  Removed the sleep command from the default
              checker.  Add a console logger in debug mode.  Call
              "killme()" instead of "main_loop.quit()" when there are no
              more clients.  Call "daemon()" if not in debug mode.
              Register "cleanup()" to run at exit.  Ignore some
              signals.  Catch DBusException to detect another running
              server and exit cleanly.  Exit with "exitstatus".
  (cleanup): New function.

Show diffs side-by-side

added added

removed removed

Lines of Context:
mandos-options.xml
1
 
<?xml version="1.0" encoding="UTF-8"?>
2
 
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3
 
        "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
4
 
 
5
 
<!--
6
 
This file is used by both mandos(8) and mandos.conf(5), since these
7
 
options can be used both on the command line and in the config file.
8
 
-->
9
 
 
10
 
<section>
11
 
  <title/>
12
 
  
13
 
  <para id="interface">
14
 
    If this is specified, the server will only announce the service
15
 
    and listen to requests on network interface
16
 
    <replaceable>IF</replaceable>.  Default is to use all available
17
 
    interfaces.  <emphasis>Note:</emphasis> a failure to bind to the
18
 
    specified interface is not considered critical, and the server
19
 
    does not exit, but will instead continue starting normally.
20
 
  </para>
21
 
  
22
 
  <para id="address">
23
 
    If this option is used, the server will only listen to the
24
 
    specified IPv6 address.  If a link-local address is specified, an
25
 
    interface should be set, since a link-local address is only valid
26
 
    on a single interface.  By default, the server will listen to all
27
 
    available addresses.  If set, this must be an IPv6 address; an
28
 
    IPv4 address can only be specified using the <quote><systemitem
29
 
    class="ipaddress">::FFFF:192.0.2.3</systemitem ></quote> format.
30
 
  </para>
31
 
  
32
 
  <para id="port">
33
 
    If this option is used, the server will bind to that port. By
34
 
    default, the server will listen to an arbitrary port given by the
35
 
    operating system.
36
 
  </para>
37
 
  
38
 
  <para id="debug">
39
 
    If the server is run in debug mode, it will run in the foreground
40
 
    and print a lot of debugging information.  The default is
41
 
    <emphasis>not</emphasis> to run in debug mode.
42
 
  </para>
43
 
  
44
 
  <para id="priority">
45
 
    GnuTLS priority string for the TLS handshake with the clients.
46
 
    The default is
47
 
    <quote><literal>SECURE256:!CTYPE-X.509:+CTYPE-OPENPGP</literal></quote>.
48
 
    See <citerefentry><refentrytitle>gnutls_priority_init
49
 
    </refentrytitle><manvolnum>3</manvolnum></citerefentry> for the
50
 
    syntax.  <emphasis>Warning</emphasis>: changing this may make the
51
 
    TLS handshake fail, making communication with clients impossible.
52
 
  </para>
53
 
  
54
 
  <para id="servicename">
55
 
    Zeroconf service name.  The default is
56
 
    <quote><literal>Mandos</literal></quote>.  This only needs to be
57
 
    changed this if it, for some reason, is necessary to run more than
58
 
    one server on the same <emphasis>host</emphasis>, which would not
59
 
    normally be useful.  If there are name collisions on the same
60
 
    <emphasis>network</emphasis>, the newer server will automatically
61
 
    rename itself to <quote><literal>Mandos #2</literal></quote>, and
62
 
    so on; therefore, this option is not needed in that case.
63
 
  </para>
64
 
  
65
 
</section>