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

First version of a somewhat complete D-Bus server interface.  Also
change user/group name to "_mandos".

* debian/mandos.postinst: Rename old "mandos" user and group to
                          "_mandos"; create "_mandos" user and group
                          if none exist.
* debian/mandos-client.postinst: - '' -

* initramfs-tools-hook: Try "_mandos" before "mandos" as user and
                        group name.

* mandos (_datetime_to_dbus_struct): New; was previously local.
  (Client.started): Renamed to "last_started".  All users changed.
  (Client.started): New; boolean.
  (Client.dbus_object_path): New.
  (Client.check_command): Renamed to "checker_command".  All users
                          changed.
  (Client.__init__): Set and use "self.dbus_object_path".  Set
                     "self.started".
  (Client.start): Update "self.started".  Emit "self.PropertyChanged"
                  signals for both "started" and "last_started".
  (Client.stop): Update "self.started".  Emit "self.PropertyChanged"
                 signal for "started".
  (Client.checker_callback): Take additional "command" argument.  All
                             callers changed. Emit
                             "self.PropertyChanged" signal.
  (Client.bump_timeout): Emit "self.PropertyChanged" signal for
                         "last_checked_ok".
  (Client.start_checker): Emit "self.PropertyChanged" signal for
                          "checker_running".
  (Client.stop_checker): Emit "self.PropertyChanged" signal for
                         "checker_running".
  (Client.still_valid): Bug fix: use "getattr(self, started, False)"
                        instead of "self.started" in case this client
                        object is so new that the "started" attribute
                        has not been created yet.
  (Client.IntervalChanged, Client.CheckerIsRunning, Client.GetChecker,
  Client.GetCreated, Client.GetFingerprint, Client.GetHost,
  Client.GetInterval, Client.GetName, Client.GetStarted,
  Client.GetTimeout, Client.StateChanged, Client.TimeoutChanged):
  Removed; all callers changed.
  (Client.CheckerCompleted): Add "condition" and "command" arguments.
                             All callers changed.
  (Client.GetAllProperties, Client.PropertyChanged): New.
  (Client.StillValid): Renamed to "IsStillValid".
  (Client.StartChecker): Changed to its own function to avoid the
                         return value from "Client.start_checker()".
  (Client.Stop): Changed to its own function to avoid the return value
                 from "Client.stop()".
  (main): Try "_mandos" before "mandos" as user and group name.
          Removed inner function "remove_from_clients".  New inner
          class "MandosServer".

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
<?xml version="1.0" encoding="UTF-8"?>
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
 
<!ENTITY VERSION "1.0">
5
4
<!ENTITY CONFNAME "mandos.conf">
6
5
<!ENTITY CONFPATH "<filename>/etc/mandos/mandos.conf</filename>">
7
 
<!ENTITY TIMESTAMP "2008-08-31">
 
6
<!ENTITY TIMESTAMP "2008-09-30">
 
7
<!ENTITY % common SYSTEM "common.ent">
 
8
%common;
8
9
]>
9
10
 
10
11
<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
12
13
    <title>Mandos Manual</title>
13
14
    <!-- NWalsh’s docbook scripts use this to generate the footer: -->
14
15
    <productname>Mandos</productname>
15
 
    <productnumber>&VERSION;</productnumber>
 
16
    <productnumber>&version;</productnumber>
16
17
    <date>&TIMESTAMP;</date>
17
18
    <authorgroup>
18
19
      <author>
35
36
      <holder>Teddy Hogeborn</holder>
36
37
      <holder>Björn Påhlsson</holder>
37
38
    </copyright>
38
 
    <legalnotice>
39
 
      <para>
40
 
        This manual page is free software: you can redistribute it
41
 
        and/or modify it under the terms of the GNU General Public
42
 
        License as published by the Free Software Foundation,
43
 
        either version 3 of the License, or (at your option) any
44
 
        later version.
45
 
      </para>
46
 
 
47
 
      <para>
48
 
        This manual page is distributed in the hope that it will
49
 
        be useful, but WITHOUT ANY WARRANTY; without even the
50
 
        implied warranty of MERCHANTABILITY or FITNESS FOR A
51
 
        PARTICULAR PURPOSE.  See the GNU General Public License
52
 
        for more details.
53
 
      </para>
54
 
 
55
 
      <para>
56
 
        You should have received a copy of the GNU General Public
57
 
        License along with this program; If not, see
58
 
        <ulink url="http://www.gnu.org/licenses/"/>.
59
 
      </para>
60
 
    </legalnotice>
 
39
    <xi:include href="legalnotice.xml"/>
61
40
  </refentryinfo>
62
 
 
 
41
  
63
42
  <refmeta>
64
43
    <refentrytitle>&CONFNAME;</refentrytitle>
65
44
    <manvolnum>5</manvolnum>
71
50
      Configuration file for the Mandos server
72
51
    </refpurpose>
73
52
  </refnamediv>
74
 
 
 
53
  
75
54
  <refsynopsisdiv>
76
55
    <synopsis>&CONFPATH;</synopsis>
77
56
  </refsynopsisdiv>
78
 
 
 
57
  
79
58
  <refsect1 id="description">
80
59
    <title>DESCRIPTION</title>
81
60
    <para>
93
72
      <quote>#</quote> or <quote>;</quote> are ignored and may be used
94
73
      to provide comments.
95
74
    </para>
96
 
 
 
75
    
97
76
  </refsect1>
98
77
  <refsect1>
99
78
    <title>OPTIONS</title>
106
85
          <xi:include href="mandos-options.xml" xpointer="interface"/>
107
86
        </listitem>
108
87
      </varlistentry>
109
 
 
 
88
      
110
89
      <varlistentry>
111
90
        <term><option>address<literal> = </literal><replaceable
112
91
          >ADDRESS</replaceable></option></term>
114
93
          <xi:include href="mandos-options.xml" xpointer="address"/>
115
94
        </listitem>
116
95
      </varlistentry>
117
 
 
 
96
      
118
97
      <varlistentry>
119
98
        <term><option>port<literal> = </literal><replaceable
120
99
        >NUMBER</replaceable></option></term>
122
101
          <xi:include href="mandos-options.xml" xpointer="port"/>
123
102
        </listitem>
124
103
      </varlistentry>
125
 
 
 
104
      
126
105
      <varlistentry>
127
106
        <term><option>debug<literal> = </literal>{ <literal
128
107
          >1</literal> | <literal>yes</literal> | <literal
133
112
          <xi:include href="mandos-options.xml" xpointer="debug"/>
134
113
        </listitem>
135
114
      </varlistentry>
136
 
 
 
115
      
137
116
      <varlistentry>
138
117
        <term><option>priority<literal> = </literal><replaceable
139
118
        >STRING</replaceable></option></term>
141
120
          <xi:include href="mandos-options.xml" xpointer="priority"/>
142
121
        </listitem>
143
122
      </varlistentry>
144
 
 
 
123
      
145
124
      <varlistentry>
146
125
        <term><option>servicename<literal> = </literal
147
126
        ><replaceable>NAME</replaceable></option></term>
166
145
    <para>
167
146
      The <literal>[DEFAULT]</literal> is necessary because the Python
168
147
      built-in module <systemitem class="library">ConfigParser</systemitem>
169
 
      requres it.
 
148
      requires it.
170
149
    </para>
171
150
  </refsect1>
172
151
  
207
186
      <citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
208
187
      <manvolnum>5</manvolnum></citerefentry>
209
188
    </para>
210
 
 
 
189
    
211
190
    <variablelist>
212
191
      <varlistentry>
213
192
        <term>