/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 00:54:24 UTC
  • mto: This revision was merged to the branch mainline in revision 188.
  • Revision ID: teddy@fukt.bsnet.se-20080919005424-2kw5e1h9pjygj4ug
* debian/mandos.postinst: New. Create mandos user and group.

* debian/mandos.postrm: New.  Delete mandos user and group.

* initramfs-tools-hook: Add "--userid" and "--groupid" to
                        "plugin-runner.conf" if necessary.

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>
32
31
    </authorgroup>
33
32
    <copyright>
34
33
      <year>2008</year>
35
 
      <year>2009</year>
36
34
      <holder>Teddy Hogeborn</holder>
37
35
      <holder>Björn Påhlsson</holder>
38
36
    </copyright>
85
83
      <replaceable>DIRECTORY</replaceable></option></arg>
86
84
      <sbr/>
87
85
      <arg><option>--debug</option></arg>
88
 
      <sbr/>
89
 
      <arg><option>--no-dbus</option></arg>
90
86
    </cmdsynopsis>
91
87
    <cmdsynopsis>
92
88
      <command>&COMMANDNAME;</command>
231
227
          </para>
232
228
        </listitem>
233
229
      </varlistentry>
234
 
      
235
 
      <varlistentry>
236
 
        <term><option>--no-dbus</option></term>
237
 
        <listitem>
238
 
          <xi:include href="mandos-options.xml" xpointer="dbus"/>
239
 
          <para>
240
 
            See also <xref linkend="dbus_interface"/>.
241
 
          </para>
242
 
        </listitem>
243
 
      </varlistentry>
244
230
    </variablelist>
245
231
  </refsect1>
246
232
  
336
322
    </para>
337
323
  </refsect1>
338
324
  
339
 
  <refsect1 id="dbus_interface">
340
 
    <title>D-BUS INTERFACE</title>
341
 
    <para>
342
 
      The server will by default provide a D-Bus system bus interface.
343
 
      This interface will only be accessible by the root user or a
344
 
      Mandos-specific user, if such a user exists.
345
 
      <!-- XXX -->
346
 
    </para>
347
 
  </refsect1>
348
 
 
349
325
  <refsect1 id="exit_status">
350
326
    <title>EXIT STATUS</title>
351
327
    <para>
374
350
    </variablelist>
375
351
  </refsect1>
376
352
  
377
 
  <refsect1 id="files">
 
353
  <refsect1 id="file">
378
354
    <title>FILES</title>
379
355
    <para>
380
356
      Use the <option>--configdir</option> option to change where
444
420
      Currently, if a client is declared <quote>invalid</quote> due to
445
421
      having timed out, the server does not record this fact onto
446
422
      permanent storage.  This has some security implications, see
447
 
      <xref linkend="clients"/>.
 
423
      <xref linkend="CLIENTS"/>.
448
424
    </para>
449
425
    <para>
450
426
      There is currently no way of querying the server of the current
506
482
  
507
483
  <refsect1 id="security">
508
484
    <title>SECURITY</title>
509
 
    <refsect2 id="server">
 
485
    <refsect2 id="SERVER">
510
486
      <title>SERVER</title>
511
487
      <para>
512
488
        Running this <command>&COMMANDNAME;</command> server program
515
491
        soon after startup.
516
492
      </para>
517
493
    </refsect2>
518
 
    <refsect2 id="clients">
 
494
    <refsect2 id="CLIENTS">
519
495
      <title>CLIENTS</title>
520
496
      <para>
521
497
        The server only gives out its stored data to clients which
528
504
        <citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
529
505
        <manvolnum>5</manvolnum></citerefentry>)
530
506
        <emphasis>must</emphasis> be made non-readable by anyone
531
 
        except the user starting the server (usually root).
 
507
        except the user running the server.
532
508
      </para>
533
509
      <para>
534
510
        As detailed in <xref linkend="checking"/>, the status of all