/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-30 07:23:39 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080930072339-jn15gyrtfpdk2dhx
* .bzrignore: Added "man" directory (created by "make install-html").

* Makefile: Add "common.ent" dependency to all manual pages.
  (htmldir, version, SED): New variables.
  (CFLAGS): Add -D option to define VERSION to $(version).
  (MANPOST, HTMLPOST): Use $(SED).
  (PROGS): Use $(CPROGS)
  (CPROGS): New; C-only programs.
  (objects): Use $(CPROGS).
  (common.ent, mandos, mandos-keygen): New targets; update version
                                       number to $(version).
  (clean): Use $(CPROGS).
  (check): Depend on "all".
  (install-html): Install to $(htmldir).

* common.ent: New file with "version" entity.

* mandos-clients.conf.xml: Use "common.ent".
* mandos-keygen.xml: - '' -
* mandos.conf.xml: - '' -
* mandos.xml: - '' -
* plugin-runner.xml: - '' -
* plugins.d/mandos-client.xml: - '' -
* plugins.d/password-prompt.xml: - '' -

* plugin-runner.c (argp_program_version): Use VERSION.
* plugins.d/mandos-client.c (argp_program_version): - '' -
* plugins.d/password-prompt.c (argp_program_version): - '' -

Show diffs side-by-side

added added

removed removed

Lines of Context:
mandos.xml
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
4
<!ENTITY COMMANDNAME "mandos">
5
 
<!ENTITY TIMESTAMP "2009-02-15">
 
5
<!ENTITY TIMESTAMP "2008-09-30">
6
6
<!ENTITY % common SYSTEM "common.ent">
7
7
%common;
8
8
]>
32
32
    </authorgroup>
33
33
    <copyright>
34
34
      <year>2008</year>
35
 
      <year>2009</year>
36
35
      <holder>Teddy Hogeborn</holder>
37
36
      <holder>Björn Påhlsson</holder>
38
37
    </copyright>
85
84
      <replaceable>DIRECTORY</replaceable></option></arg>
86
85
      <sbr/>
87
86
      <arg><option>--debug</option></arg>
88
 
      <sbr/>
89
 
      <arg><option>--no-dbus</option></arg>
90
 
      <sbr/>
91
 
      <arg><option>--no-ipv6</option></arg>
92
87
    </cmdsynopsis>
93
88
    <cmdsynopsis>
94
89
      <command>&COMMANDNAME;</command>
233
228
          </para>
234
229
        </listitem>
235
230
      </varlistentry>
236
 
      
237
 
      <varlistentry>
238
 
        <term><option>--no-dbus</option></term>
239
 
        <listitem>
240
 
          <xi:include href="mandos-options.xml" xpointer="dbus"/>
241
 
          <para>
242
 
            See also <xref linkend="dbus_interface"/>.
243
 
          </para>
244
 
        </listitem>
245
 
      </varlistentry>
246
 
      
247
 
      <varlistentry>
248
 
        <term><option>--no-ipv6</option></term>
249
 
        <listitem>
250
 
          <xi:include href="mandos-options.xml" xpointer="ipv6"/>
251
 
        </listitem>
252
 
      </varlistentry>
253
231
    </variablelist>
254
232
  </refsect1>
255
233
  
345
323
    </para>
346
324
  </refsect1>
347
325
  
348
 
  <refsect1 id="dbus_interface">
349
 
    <title>D-BUS INTERFACE</title>
350
 
    <para>
351
 
      The server will by default provide a D-Bus system bus interface.
352
 
      This interface will only be accessible by the root user or a
353
 
      Mandos-specific user, if such a user exists.
354
 
      <!-- XXX -->
355
 
    </para>
356
 
  </refsect1>
357
 
  
358
326
  <refsect1 id="exit_status">
359
327
    <title>EXIT STATUS</title>
360
328
    <para>
383
351
    </variablelist>
384
352
  </refsect1>
385
353
  
386
 
  <refsect1 id="files">
 
354
  <refsect1 id="file">
387
355
    <title>FILES</title>
388
356
    <para>
389
357
      Use the <option>--configdir</option> option to change where
453
421
      Currently, if a client is declared <quote>invalid</quote> due to
454
422
      having timed out, the server does not record this fact onto
455
423
      permanent storage.  This has some security implications, see
456
 
      <xref linkend="clients"/>.
 
424
      <xref linkend="CLIENTS"/>.
457
425
    </para>
458
426
    <para>
459
427
      There is currently no way of querying the server of the current
467
435
      Debug mode is conflated with running in the foreground.
468
436
    </para>
469
437
    <para>
470
 
      The console log messages do not show a time stamp.
 
438
      The console log messages does not show a time stamp.
471
439
    </para>
472
440
    <para>
473
441
      This server does not check the expire time of clients’ OpenPGP
515
483
  
516
484
  <refsect1 id="security">
517
485
    <title>SECURITY</title>
518
 
    <refsect2 id="server">
 
486
    <refsect2 id="SERVER">
519
487
      <title>SERVER</title>
520
488
      <para>
521
489
        Running this <command>&COMMANDNAME;</command> server program
524
492
        soon after startup.
525
493
      </para>
526
494
    </refsect2>
527
 
    <refsect2 id="clients">
 
495
    <refsect2 id="CLIENTS">
528
496
      <title>CLIENTS</title>
529
497
      <para>
530
498
        The server only gives out its stored data to clients which