/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

removed old/unspecified todo's

Show diffs side-by-side

added added

removed removed

Lines of Context:
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-02">
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>
39
37
    <xi:include href="legalnotice.xml"/>
40
38
  </refentryinfo>
41
 
  
 
39
 
42
40
  <refmeta>
43
41
    <refentrytitle>&COMMANDNAME;</refentrytitle>
44
42
    <manvolnum>8</manvolnum>
50
48
      Gives encrypted passwords to authenticated Mandos clients
51
49
    </refpurpose>
52
50
  </refnamediv>
53
 
  
 
51
 
54
52
  <refsynopsisdiv>
55
53
    <cmdsynopsis>
56
54
      <command>&COMMANDNAME;</command>
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>
104
100
      <arg choice="plain"><option>--check</option></arg>
105
101
    </cmdsynopsis>
106
102
  </refsynopsisdiv>
107
 
  
 
103
 
108
104
  <refsect1 id="description">
109
105
    <title>DESCRIPTION</title>
110
106
    <para>
190
186
          <xi:include href="mandos-options.xml" xpointer="debug"/>
191
187
        </listitem>
192
188
      </varlistentry>
193
 
      
 
189
 
194
190
      <varlistentry>
195
191
        <term><option>--priority <replaceable>
196
192
        PRIORITY</replaceable></option></term>
198
194
          <xi:include href="mandos-options.xml" xpointer="priority"/>
199
195
        </listitem>
200
196
      </varlistentry>
201
 
      
 
197
 
202
198
      <varlistentry>
203
199
        <term><option>--servicename
204
200
        <replaceable>NAME</replaceable></option></term>
207
203
                      xpointer="servicename"/>
208
204
        </listitem>
209
205
      </varlistentry>
210
 
      
 
206
 
211
207
      <varlistentry>
212
208
        <term><option>--configdir
213
209
        <replaceable>DIRECTORY</replaceable></option></term>
222
218
          </para>
223
219
        </listitem>
224
220
      </varlistentry>
225
 
      
 
221
 
226
222
      <varlistentry>
227
223
        <term><option>--version</option></term>
228
224
        <listitem>
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
 
247
233
  <refsect1 id="overview">
248
234
    <title>OVERVIEW</title>
249
235
    <xi:include href="overview.xml"/>
253
239
      <acronym>RAM</acronym> disk environment.
254
240
    </para>
255
241
  </refsect1>
256
 
  
 
242
 
257
243
  <refsect1 id="protocol">
258
244
    <title>NETWORK PROTOCOL</title>
259
245
    <para>
311
297
      </row>
312
298
    </tbody></tgroup></table>
313
299
  </refsect1>
314
 
  
 
300
 
315
301
  <refsect1 id="checking">
316
302
    <title>CHECKING</title>
317
303
    <para>
325
311
      <manvolnum>5</manvolnum></citerefentry>.
326
312
    </para>
327
313
  </refsect1>
328
 
  
 
314
 
329
315
  <refsect1 id="logging">
330
316
    <title>LOGGING</title>
331
317
    <para>
335
321
      and also show them on the console.
336
322
    </para>
337
323
  </refsect1>
338
 
  
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
324
 
349
325
  <refsect1 id="exit_status">
350
326
    <title>EXIT STATUS</title>
353
329
      critical error is encountered.
354
330
    </para>
355
331
  </refsect1>
356
 
  
 
332
 
357
333
  <refsect1 id="environment">
358
334
    <title>ENVIRONMENT</title>
359
335
    <variablelist>
373
349
      </varlistentry>
374
350
    </variablelist>
375
351
  </refsect1>
376
 
  
377
 
  <refsect1 id="files">
 
352
 
 
353
  <refsect1 id="file">
378
354
    <title>FILES</title>
379
355
    <para>
380
356
      Use the <option>--configdir</option> option to change where
403
379
        </listitem>
404
380
      </varlistentry>
405
381
      <varlistentry>
406
 
        <term><filename>/var/run/mandos.pid</filename></term>
 
382
        <term><filename>/var/run/mandos/mandos.pid</filename></term>
407
383
        <listitem>
408
384
          <para>
409
385
            The file containing the process id of
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
458
434
      Debug mode is conflated with running in the foreground.
459
435
    </para>
460
436
    <para>
461
 
      The console log messages does not show a time stamp.
462
 
    </para>
463
 
    <para>
464
 
      This server does not check the expire time of clients’ OpenPGP
465
 
      keys.
 
437
      The console log messages does not show a timestamp.
466
438
    </para>
467
439
  </refsect1>
468
440
  
503
475
      </para>
504
476
    </informalexample>
505
477
  </refsect1>
506
 
  
 
478
 
507
479
  <refsect1 id="security">
508
480
    <title>SECURITY</title>
509
 
    <refsect2 id="server">
 
481
    <refsect2 id="SERVER">
510
482
      <title>SERVER</title>
511
483
      <para>
512
484
        Running this <command>&COMMANDNAME;</command> server program
513
485
        should not in itself present any security risk to the host
514
 
        computer running it.  The program switches to a non-root user
515
 
        soon after startup.
 
486
        computer running it.  The program does not need any special
 
487
        privileges to run, and is designed to run as a non-root user.
516
488
      </para>
517
489
    </refsect2>
518
 
    <refsect2 id="clients">
 
490
    <refsect2 id="CLIENTS">
519
491
      <title>CLIENTS</title>
520
492
      <para>
521
493
        The server only gives out its stored data to clients which
528
500
        <citerefentry><refentrytitle>mandos-clients.conf</refentrytitle>
529
501
        <manvolnum>5</manvolnum></citerefentry>)
530
502
        <emphasis>must</emphasis> be made non-readable by anyone
531
 
        except the user starting the server (usually root).
 
503
        except the user running the server.
532
504
      </para>
533
505
      <para>
534
506
        As detailed in <xref linkend="checking"/>, the status of all
553
525
      </para>
554
526
      <para>
555
527
        For more details on client-side security, see
556
 
        <citerefentry><refentrytitle>mandos-client</refentrytitle>
 
528
        <citerefentry><refentrytitle>password-request</refentrytitle>
557
529
        <manvolnum>8mandos</manvolnum></citerefentry>.
558
530
      </para>
559
531
    </refsect2>
560
532
  </refsect1>
561
 
  
 
533
 
562
534
  <refsect1 id="see_also">
563
535
    <title>SEE ALSO</title>
564
536
    <para>
567
539
        <manvolnum>5</manvolnum></citerefentry>, <citerefentry>
568
540
        <refentrytitle>mandos.conf</refentrytitle>
569
541
        <manvolnum>5</manvolnum></citerefentry>, <citerefentry>
570
 
        <refentrytitle>mandos-client</refentrytitle>
 
542
        <refentrytitle>password-request</refentrytitle>
571
543
        <manvolnum>8mandos</manvolnum></citerefentry>, <citerefentry>
572
544
        <refentrytitle>sh</refentrytitle><manvolnum>1</manvolnum>
573
545
      </citerefentry>