From 325bca8de542e812b7d00fb32364dce40d3c275f Mon Sep 17 00:00:00 2001
From: yaworsky <yaworsky>
Date: Thu, 8 Dec 2005 03:32:45 +0000
Subject: Added section about multiple instances. Added spaces between option
 and its parameter.

---
 doc/src/syslogd.xml | 37 +++++++++++++++++++++++++++++++++----
 1 file 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>
-- 
cgit v1.2.3