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

  • Committer: Teddy Hogeborn
  • Date: 2008-08-29 05:53:59 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080829055359-wkdasnyxtylmnxus
* mandos.xml (EXAMPLE): Replaced all occurences of command name with
                        "&COMMANDNAME;".

* plugins.d/password-prompt.c (main): Improved some documentation
                                      strings.  Do perror() of
                                      tcgetattr() fails.  Add debug
                                      output if interrupted by signal.
                                      Loop over write() instead of
                                      using fwrite() when outputting
                                      password.  Add debug output if
                                      getline() returns 0, unless it
                                      was caused by a signal.  Add
                                      exit status code to debug
                                      output.

* plugins.d/password-prompt.xml: Changed all single quotes to double
                                 quotes for consistency.  Removed
                                 <?xml-stylesheet>.
  (ENTITY TIMESTAMP): New.  Automatically updated by Emacs time-stamp
                      by using Emacs local variables.
  (/refentry/refentryinfo/title): Changed to "Mandos Manual".
  (/refentry/refentryinfo/productname): Changed to "Mandos".
  (/refentry/refentryinfo/date): New; set to "&TIMESTAMP;".
  (/refentry/refentryinfo/copyright): Split copyright holders.
  (/refentry/refnamediv/refpurpose): Improved wording.
  (SYNOPSIS): Fix to use correct markup.  Add short options.
  (DESCRIPTION, OPTIONS): Improved wording.
  (OPTIONS): Improved wording.  Use more correct markup.  Document
             short options.
  (EXIT STATUS): Add text.
  (ENVIRONMENT): Document use of "cryptsource" and "crypttarget".
  (FILES): REMOVED.
  (BUGS): Add text.
  (EXAMPLE): Added some examples.
  (SECURITY): Added text.
  (SEE ALSO): Remove reference to mandos(8).  Add reference to
              crypttab(5).

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
<?xml version="1.0" encoding="UTF-8"?>
 
2
<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
 
3
        "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd">
 
4
 
 
5
<!--
 
6
This file is used by both mandos(8) and mandos.conf(5), since these
 
7
options can be used both on the command line and in the config file.
 
8
-->
 
9
 
 
10
<section>
 
11
  <title/>
 
12
  
 
13
  <para id="interface">
 
14
    If this is specified, the server will only announce the service
 
15
    and listen to requests on the specified network interface.
 
16
    Default is to use all available interfaces.  <emphasis
 
17
    >Note:</emphasis> a failure to bind to the specified
 
18
    interface is not considered critical, and the server does not
 
19
    exit, but will instead continue normally.
 
20
  </para>
 
21
  
 
22
  <para id="address">
 
23
    If this option is used, the server will only listen to the
 
24
    specified IPv6 address.  If a link-local address is specified, an
 
25
    interface should be set, since a link-local address is only valid
 
26
    on a single interface.  By default, the server will listen to all
 
27
    available addresses.  If set, this must be an IPv6 address; an
 
28
    IPv4 address can only be specified using IPv4-mapped IPv6 address
 
29
    syntax: <quote><systemitem class="ipaddress"
 
30
    >::FFFF:192.0.2.3</systemitem ></quote>.
 
31
  </para>
 
32
  
 
33
  <para id="port">
 
34
    If this option is used, the server will bind to that port. By
 
35
    default, the server will listen to an arbitrary port given by the
 
36
    operating system.
 
37
  </para>
 
38
  
 
39
  <para id="debug">
 
40
    If the server is run in debug mode, it will run in the foreground
 
41
    and print a lot of debugging information.  The default is to
 
42
    <emphasis>not</emphasis> run in debug mode.
 
43
  </para>
 
44
  
 
45
  <para id="priority">
 
46
    GnuTLS priority string for the TLS handshake with the clients.
 
47
    The default is
 
48
    <quote><literal>SECURE256:!CTYPE-X.509:+CTYPE-OPENPGP</literal></quote>.
 
49
    See <citerefentry><refentrytitle>gnutls_priority_init
 
50
    </refentrytitle><manvolnum>3</manvolnum></citerefentry> for the
 
51
    syntax.  <emphasis>Warning</emphasis>: changing this may make the
 
52
    TLS handshake fail, making communication with clients impossible.
 
53
  </para>
 
54
  
 
55
  <para id="servicename">
 
56
    Zeroconf service name.  The default is
 
57
    <quote><literal>Mandos</literal></quote>.  This only needs to be
 
58
    changed this if it, for some reason, is necessary to run more than
 
59
    one server on the same <emphasis>host</emphasis>, which would not
 
60
    normally be useful.  If there are name collisions on the same
 
61
    <emphasis>network</emphasis>, the newer server will automatically
 
62
    rename itself to <quote><literal>Mandos #2</literal></quote>, and
 
63
    so on; therefore, this option is not needed in that case.
 
64
  </para>
 
65
  
 
66
</section>