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

  • Committer: Teddy Hogeborn
  • Date: 2008-08-29 05:53:59 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080829055359-wkdasnyxtylmnxus
* mandos.xml (EXAMPLE): Replaced all occurences of command name with
                        "&COMMANDNAME;".

* plugins.d/password-prompt.c (main): Improved some documentation
                                      strings.  Do perror() of
                                      tcgetattr() fails.  Add debug
                                      output if interrupted by signal.
                                      Loop over write() instead of
                                      using fwrite() when outputting
                                      password.  Add debug output if
                                      getline() returns 0, unless it
                                      was caused by a signal.  Add
                                      exit status code to debug
                                      output.

* plugins.d/password-prompt.xml: Changed all single quotes to double
                                 quotes for consistency.  Removed
                                 <?xml-stylesheet>.
  (ENTITY TIMESTAMP): New.  Automatically updated by Emacs time-stamp
                      by using Emacs local variables.
  (/refentry/refentryinfo/title): Changed to "Mandos Manual".
  (/refentry/refentryinfo/productname): Changed to "Mandos".
  (/refentry/refentryinfo/date): New; set to "&TIMESTAMP;".
  (/refentry/refentryinfo/copyright): Split copyright holders.
  (/refentry/refnamediv/refpurpose): Improved wording.
  (SYNOPSIS): Fix to use correct markup.  Add short options.
  (DESCRIPTION, OPTIONS): Improved wording.
  (OPTIONS): Improved wording.  Use more correct markup.  Document
             short options.
  (EXIT STATUS): Add text.
  (ENVIRONMENT): Document use of "cryptsource" and "crypttarget".
  (FILES): REMOVED.
  (BUGS): Add text.
  (EXAMPLE): Added some examples.
  (SECURITY): Added text.
  (SEE ALSO): Remove reference to mandos(8).  Add reference to
              crypttab(5).

Show diffs side-by-side

added added

removed removed

Lines of Context:
4
4
<!ENTITY VERSION "1.0">
5
5
<!ENTITY CONFNAME "mandos.conf">
6
6
<!ENTITY CONFPATH "<filename>/etc/mandos/mandos.conf</filename>">
7
 
<!ENTITY OVERVIEW SYSTEM "overview.xml">
8
7
]>
9
8
 
10
9
<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
83
82
      The file &CONFPATH; is a simple configuration file for
84
83
      <citerefentry><refentrytitle>mandos</refentrytitle>
85
84
      <manvolnum>8</manvolnum></citerefentry>, and is read by it at
86
 
      startup.  The configuration file starts with
87
 
      <quote><literal>[DEFAULT]</literal></quote> on a line by itself,
88
 
      followed by any number of
89
 
      <quote><varname><replaceable>option</replaceable></varname>=<replaceable>value</replaceable></quote>
90
 
      entries, with continuations in the style of RFC 822.
91
 
      <quote><varname><replaceable>option</replaceable></varname>:
92
 
      <replaceable>value</replaceable></quote> is also accepted.  Note
93
 
      that leading whitespace is removed from values.  Lines beginning
94
 
      with <quote>#</quote> or <quote>;</quote> are ignored and may be
95
 
      used to provide comments.
 
85
      startup.  The configuration file starts with <quote><literal
 
86
      >[DEFAULT]</literal></quote> on a line by itself, followed by
 
87
      any number of <quote><varname><replaceable>option</replaceable
 
88
      ></varname>=<replaceable>value</replaceable></quote> entries,
 
89
      with continuations in the style of RFC 822.  <quote><varname
 
90
      ><replaceable>option</replaceable></varname>: <replaceable
 
91
      >value</replaceable></quote> is also accepted.  Note that
 
92
      leading whitespace is removed from values.  Lines beginning with
 
93
      <quote>#</quote> or <quote>;</quote> are ignored and may be used
 
94
      to provide comments.
96
95
    </para>
97
96
 
98
97
  </refsect1>
104
103
        <term><varname>interface</varname></term>
105
104
        <listitem>
106
105
          <synopsis><literal>interface = </literal><replaceable
107
 
          >IF</replaceable>
 
106
          >NAME</replaceable>
108
107
          </synopsis>
109
108
          <xi:include href="mandos-options.xml" xpointer="interface"/>
110
109
        </listitem>
124
123
        <term><varname>port</varname></term>
125
124
        <listitem>
126
125
          <synopsis><literal>port = </literal><replaceable
127
 
          >PORT</replaceable>
 
126
          >NUMBER</replaceable>
128
127
          </synopsis>
129
128
          <xi:include href="mandos-options.xml" xpointer="port"/>
130
129
        </listitem>
147
146
        <term><varname>priority</varname></term>
148
147
        <listitem>
149
148
          <synopsis><literal>priority = </literal><replaceable
150
 
          >PRIORITY</replaceable>
 
149
          >STRING</replaceable>
151
150
          </synopsis>
152
151
          <xi:include href="mandos-options.xml" xpointer="priority"/>
153
152
        </listitem>
217
216
        <refentrytitle>mandos</refentrytitle>
218
217
        <manvolnum>8</manvolnum></citerefentry>, <citerefentry>
219
218
        <refentrytitle>mandos-clients.conf</refentrytitle>
220
 
        <manvolnum>5</manvolnum></citerefentry>
 
219
        <manvolnum>5</manvolnum></citerefentry>, <citerefentry>
 
220
        <refentrytitle>gnutls_priority_init</refentrytitle>
 
221
        <manvolnum>3</manvolnum></citerefentry>
221
222
    </para>
 
223
 
 
224
    <variablelist>
 
225
      <varlistentry>
 
226
        <term>
 
227
          RFC 4291: <citetitle>IP Version 6 Addressing
 
228
          Architecture</citetitle>
 
229
        </term>
 
230
        <listitem>
 
231
          <variablelist>
 
232
            <varlistentry>
 
233
              <term>Section 2.2: <citetitle>Text Representation of
 
234
              Addresses</citetitle></term>
 
235
              <listitem><para/></listitem>
 
236
            </varlistentry>
 
237
            <varlistentry>
 
238
              <term>Section 2.5.5.2: <citetitle>IPv4-Mapped IPv6
 
239
              Address</citetitle></term>
 
240
              <listitem><para/></listitem>
 
241
            </varlistentry>
 
242
            <varlistentry>
 
243
            <term>Section 2.5.6, <citetitle>Link-Local IPv6 Unicast
 
244
            Addresses</citetitle></term>
 
245
            <listitem>
 
246
              <para>
 
247
                The clients use IPv6 link-local addresses, which are
 
248
                immediately usable since a link-local addresses is
 
249
                automatically assigned to a network interfaces when it
 
250
                is brought up.
 
251
              </para>
 
252
            </listitem>
 
253
            </varlistentry>
 
254
          </variablelist>
 
255
        </listitem>
 
256
      </varlistentry>
 
257
      <varlistentry>
 
258
        <term>
 
259
          <ulink url="http://www.zeroconf.org/">Zeroconf</ulink>
 
260
        </term>
 
261
        <listitem>
 
262
          <para>
 
263
            Zeroconf is the network protocol standard used by clients
 
264
            for finding the Mandos server on the local network.
 
265
          </para>
 
266
        </listitem>
 
267
      </varlistentry>
 
268
    </variablelist>
222
269
  </refsect1>
223
270
</refentry>