/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-11-09 06:40:29 UTC
  • mto: (237.2.1 mandos) (24.1.113 mandos)
  • mto: This revision was merged to the branch mainline in revision 238.
  • Revision ID: teddy@fukt.bsnet.se-20081109064029-df71jpoce308cq3v
First steps of a D-Bus interface to the server.

* mandos: Also import "dbus.service".
  (Client): Inherit from "dbus.service.Object", which is a new-style
            class, so inheriting from "object" is no longer necessary.
  (Client.interface): New temporary variable which only exists during
                     class definition.

  (Client.getName, Client.getFingerprint): New D-Bus getter methods.
  (Client.setSecret): New D-Bus setter method.
  (Client._set_timeout): Emit D-Bus signal "TimeoutChanged".
  (Client.getTimeout): New D-Bus getter method.
  (Client.TimeoutChanged): New D-Bus signal.
  (Client._set_interval): Emit D-Bus signal "IntervalChanged".
  (Client.getInterval): New D-Bus getter method.
  (Client.intervalChanged): New D-Bus signal.
  (Client.__init__): Also call "dbus.service.Object.__init__".
  (Client.started): New boolean attribute.
  (Client.start, Client.stop): Update "self.started", and emit D-Bus
                               signal "StateChanged".
  (Client.StateChanged): New D-Bus signal.
  (Client.stop): Use "self.started" instead of misusing "self.secret".
                 Also simplify code by using "getattr" instead of
                 "hasattr".
  (Client.checker_callback): Emit D-Bus signal "CheckerCompleted".
  (Client.CheckerCompleted): New D-Bus signal.
  (Client.bumpTimeout): D-Bus method name for "bump_timeout".
  (Client.start_checker): Emit D-Bus signal "CheckerStarted".
  (Client.CheckerStarted): New D-Bus signal.
  (Client.checkerIsRunning): New D-Bus method.
  (Client.StopChecker): D-Bus method name for "stop_checker".
  (Client.still_valid): First check "self.started".
  (Client.stillValid): D-Bus method name for "still_valid".

Show diffs side-by-side

added added

removed removed

Lines of Context:
26
26
    specified IPv6 address.  If a link-local address is specified, an
27
27
    interface should be set, since a link-local address is only valid
28
28
    on a single interface.  By default, the server will listen to all
29
 
    available addresses.  If set, this must normally be an IPv6
30
 
    address; an IPv4 address can only be specified using IPv4-mapped
31
 
    IPv6 address syntax: <quote><systemitem class="ipaddress"
32
 
    >::FFFF:192.0.2.3</systemitem ></quote>.  (Only if IPv6 usage is
33
 
    <emphasis>disabled</emphasis> (see below) must this be an IPv4
34
 
    address.)
 
29
    available addresses.  If set, this must be an IPv6 address; an
 
30
    IPv4 address can only be specified using IPv4-mapped IPv6 address
 
31
    syntax: <quote><systemitem class="ipaddress"
 
32
    >::FFFF:192.0.2.3</systemitem ></quote>.
35
33
  </para>
36
34
  
37
35
  <para id="port">
68
66
    so on; therefore, this option is not needed in that case.
69
67
  </para>
70
68
  
71
 
  <para id="dbus">
72
 
    This option controls whether the server will provide a D-Bus
73
 
    system bus interface.  The default is to provide such an
74
 
    interface.
75
 
  </para>
76
 
  
77
 
  <para id="ipv6">
78
 
    This option controls whether the server will use IPv6 sockets and
79
 
    addresses.  The default is to use IPv6.  This option should
80
 
    <emphasis>never</emphasis> normally be turned off, <emphasis>even in
81
 
    IPv4-only environments</emphasis>.  This is because <citerefentry>
82
 
    <refentrytitle>mandos-client</refentrytitle>
83
 
    <manvolnum>8mandos</manvolnum></citerefentry> will normally use
84
 
    IPv6 link-local addresses, and will not be able to find or connect
85
 
    to the server if this option is turned off.  <emphasis>Only
86
 
    advanced users should consider changing this option</emphasis>.
87
 
  </para>
88
 
  
89
 
  <para id="restore">
90
 
    This option controls whether the server will restore its state
91
 
    from the last time it ran.  Default is to restore last state.
92
 
  </para>
93
 
  
94
 
  <para id="statedir">
95
 
    Directory to save (and restore) state in.  Default is
96
 
    <quote><filename
97
 
    class="directory">/var/lib/mandos</filename></quote>.
98
 
  </para>
99
 
  
100
69
</section>