/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-13 15:36:18 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080913153618-atp386q2bqj0ku99
* Makefile (install-client-nokey): Do "&&" instead of ";" to catch
                                   errors.

* README: Kill the straight quotes.  Add copyright notice.

* overview.xml: Improved wording.

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 "2008-12-28">
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"/>.
240
 
        </listitem>
241
 
      </varlistentry>
242
230
    </variablelist>
243
231
  </refsect1>
244
232
  
334
322
    </para>
335
323
  </refsect1>
336
324
  
337
 
  <refsect1 id="dbus">
338
 
    <title>D-BUS INTERFACE</title>
339
 
    <para>
340
 
      The server will by default provide a D-Bus system bus interface.
341
 
      This interface will only be accessible by the root user or a
342
 
      Mandos-specific user, if such a user exists.
343
 
      <!-- XXX -->
344
 
    </para>
345
 
  </refsect1>
346
 
 
347
325
  <refsect1 id="exit_status">
348
326
    <title>EXIT STATUS</title>
349
327
    <para>
372
350
    </variablelist>
373
351
  </refsect1>
374
352
  
375
 
  <refsect1 id="files">
 
353
  <refsect1 id="file">
376
354
    <title>FILES</title>
377
355
    <para>
378
356
      Use the <option>--configdir</option> option to change where
442
420
      Currently, if a client is declared <quote>invalid</quote> due to
443
421
      having timed out, the server does not record this fact onto
444
422
      permanent storage.  This has some security implications, see
445
 
      <xref linkend="clients"/>.
 
423
      <xref linkend="CLIENTS"/>.
446
424
    </para>
447
425
    <para>
448
426
      There is currently no way of querying the server of the current
504
482
  
505
483
  <refsect1 id="security">
506
484
    <title>SECURITY</title>
507
 
    <refsect2 id="server">
 
485
    <refsect2 id="SERVER">
508
486
      <title>SERVER</title>
509
487
      <para>
510
488
        Running this <command>&COMMANDNAME;</command> server program
513
491
        soon after startup.
514
492
      </para>
515
493
    </refsect2>
516
 
    <refsect2 id="clients">
 
494
    <refsect2 id="CLIENTS">
517
495
      <title>CLIENTS</title>
518
496
      <para>
519
497
        The server only gives out its stored data to clients which
526
504
        <citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
527
505
        <manvolnum>5</manvolnum></citerefentry>)
528
506
        <emphasis>must</emphasis> be made non-readable by anyone
529
 
        except the user starting the server (usually root).
 
507
        except the user running the server.
530
508
      </para>
531
509
      <para>
532
510
        As detailed in <xref linkend="checking"/>, the status of all