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

  • Committer: Teddy Hogeborn
  • Date: 2008-09-19 13:50:22 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080919135022-214t21hetv8jgv0y
* debian/mandos-client.docs: New.  Add README and TODO file.
* debian/mandos.docs: - '' -

* debian/mandos-client.links: New.  Create plugin-runner.conf(5) link.

* debian/rules (DH_VERBOSE): Commented out.
               Removed commented-out unused dh_* stuff.  Removed
               "dh_makeshlibs".

Show diffs side-by-side

added added

removed removed

Lines of Context:
mandos.xml
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">
4
5
<!ENTITY COMMANDNAME "mandos">
5
 
<!ENTITY TIMESTAMP "2009-01-04">
6
 
<!ENTITY % common SYSTEM "common.ent">
7
 
%common;
 
6
<!ENTITY TIMESTAMP "2008-09-12">
8
7
]>
9
8
 
10
9
<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
11
 
   <refentryinfo>
 
10
  <refentryinfo>
12
11
    <title>Mandos Manual</title>
13
12
    <!-- NWalsh’s docbook scripts use this to generate the footer: -->
14
13
    <productname>Mandos</productname>
15
 
    <productnumber>&version;</productnumber>
 
14
    <productnumber>&VERSION;</productnumber>
16
15
    <date>&TIMESTAMP;</date>
17
16
    <authorgroup>
18
17
      <author>
84
83
      <replaceable>DIRECTORY</replaceable></option></arg>
85
84
      <sbr/>
86
85
      <arg><option>--debug</option></arg>
87
 
      <sbr/>
88
 
      <arg><option>--no-dbus</option></arg>
89
86
    </cmdsynopsis>
90
87
    <cmdsynopsis>
91
88
      <command>&COMMANDNAME;</command>
230
227
          </para>
231
228
        </listitem>
232
229
      </varlistentry>
233
 
      
234
 
      <varlistentry>
235
 
        <term><option>--no-dbus</option></term>
236
 
        <listitem>
237
 
          <xi:include href="mandos-options.xml" xpointer="dbus"/>
238
 
          <para>
239
 
            See also <xref linkend="dbus_interface"/>.
240
 
          </para>
241
 
        </listitem>
242
 
      </varlistentry>
243
230
    </variablelist>
244
231
  </refsect1>
245
232
  
335
322
    </para>
336
323
  </refsect1>
337
324
  
338
 
  <refsect1 id="dbus_interface">
339
 
    <title>D-BUS INTERFACE</title>
340
 
    <para>
341
 
      The server will by default provide a D-Bus system bus interface.
342
 
      This interface will only be accessible by the root user or a
343
 
      Mandos-specific user, if such a user exists.
344
 
      <!-- XXX -->
345
 
    </para>
346
 
  </refsect1>
347
 
 
348
325
  <refsect1 id="exit_status">
349
326
    <title>EXIT STATUS</title>
350
327
    <para>
373
350
    </variablelist>
374
351
  </refsect1>
375
352
  
376
 
  <refsect1 id="files">
 
353
  <refsect1 id="file">
377
354
    <title>FILES</title>
378
355
    <para>
379
356
      Use the <option>--configdir</option> option to change where
443
420
      Currently, if a client is declared <quote>invalid</quote> due to
444
421
      having timed out, the server does not record this fact onto
445
422
      permanent storage.  This has some security implications, see
446
 
      <xref linkend="clients"/>.
 
423
      <xref linkend="CLIENTS"/>.
447
424
    </para>
448
425
    <para>
449
426
      There is currently no way of querying the server of the current
505
482
  
506
483
  <refsect1 id="security">
507
484
    <title>SECURITY</title>
508
 
    <refsect2 id="server">
 
485
    <refsect2 id="SERVER">
509
486
      <title>SERVER</title>
510
487
      <para>
511
488
        Running this <command>&COMMANDNAME;</command> server program
514
491
        soon after startup.
515
492
      </para>
516
493
    </refsect2>
517
 
    <refsect2 id="clients">
 
494
    <refsect2 id="CLIENTS">
518
495
      <title>CLIENTS</title>
519
496
      <para>
520
497
        The server only gives out its stored data to clients which
527
504
        <citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
528
505
        <manvolnum>5</manvolnum></citerefentry>)
529
506
        <emphasis>must</emphasis> be made non-readable by anyone
530
 
        except the user starting the server (usually root).
 
507
        except the user running the server.
531
508
      </para>
532
509
      <para>
533
510
        As detailed in <xref linkend="checking"/>, the status of all