aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--doc/src/syslogd.xml37
1 files changed, 33 insertions, 4 deletions
diff --git a/doc/src/syslogd.xml b/doc/src/syslogd.xml
index 4ac4535..66b7b4e 100644
--- a/doc/src/syslogd.xml
+++ b/doc/src/syslogd.xml
@@ -20,8 +20,8 @@
<group choice="opt"><arg>-c</arg><arg>--conf</arg></group>
<group choice="opt"><arg>-h</arg><arg>--help</arg></group>
<group choice="opt"><arg>-i</arg><arg>--install</arg></group>
-<group choice="opt"><arg>-I</arg><arg>--instance</arg><replaceable>name</replaceable></group>
-<group choice="opt"><arg>-p</arg><arg>--priority</arg><replaceable>name</replaceable></group>
+<group choice="opt"><arg>-I</arg><arg>--instance</arg><replaceable>&nbsp;name</replaceable></group>
+<group choice="opt"><arg>-p</arg><arg>--priority</arg><replaceable>&nbsp;name</replaceable></group>
<group choice="opt"><arg>-r</arg><arg>--remove</arg></group>
<arg choice="opt">--restart</arg>
<group choice="opt"><arg>-s</arg><arg>--shutdown</arg></group>
@@ -67,7 +67,7 @@ Install and start service.
</varlistentry>
<varlistentry>
<term>
-<option>-I</option> | <option>--instance</option><replaceable>name</replaceable>
+<option>-I</option> | <option>--instance</option><replaceable>&nbsp;name</replaceable>
</term>
<listitem>
<para>
@@ -78,7 +78,7 @@ This option is useful to install and run multiple daemons in the system.
</varlistentry>
<varlistentry>
<term>
-<option>-p</option> | <option>--priority</option><replaceable>name</replaceable>
+<option>-p</option> | <option>--priority</option><replaceable>&nbsp;name</replaceable>
</term>
<listitem>
<para>
@@ -153,4 +153,33 @@ Display version.
</para>
</refsect1>
+ <refsect1>
+ <title>Multiple instances</title>
+ <para>
+It is possible to have multiple instances of the daemon in the system.
+Each instance should use its own configuration file.
+This could be done specifying <option>--conf</option> option or just placing
+instances in different directories.
+ </para>
+ <para>
+Each instance should be configured to listen on its own interface and/or port
+and to write messages into its own log files.
+ </para>
+ <para>
+If option <option>--instance</option> is not specified, the instance is default.
+Otherwise, all other options will apply to the specified instance.
+For example, to install a different instance with name <quote>test</quote> and
+high priority issue the following command:
+ <screen>
+syslogd --install --instance test --conf another.conf.file --priority high</screen>
+Examples of control commands:
+ <screen>
+syslogd --shutdown --instance test
+syslogd --start --instance test</screen>
+To remove instance the following command should be issued:
+ <screen>
+syslogd --remove --instance test</screen>
+ </para>
+ </refsect1>
+
</refentry>