Bug#546472: ucarp man page should mention signals

[Thomas Stewart]

Package: ucarp
Version: 1.5.1-1
Severity: wishlist
Tags: patch

Hi,

Although signals are mentioned in the other documentation, it would be
nice if they were documented in the man page too. Something like this:

--- debian/ucarp.8.sgml.orig    2009-09-13 13:04:20.000000000 +0100
+++ debian/ucarp.8.sgml 2009-09-13 13:17:37.000000000 +0100
@@ -19,7 +19,7 @@
   <!ENTITY dhfirstname "<firstname>Eric</firstname>">
   <!ENTITY dhsurname   "<surname>Evans</surname>">
   <!-- Please adjust the date whenever revising the manpage. -->
-  <!ENTITY dhdate      "<date>April 2, 2008</date>">
+  <!ENTITY dhdate      "<date>September 13, 2009</date>">
   <!ENTITY dhsection   "<manvolnum>8</manvolnum>">
   <!ENTITY dhemail     "<email>eev...@debian.org</email>">
   <!ENTITY dhusername  "Eric Evans">
@@ -269,6 +269,19 @@
   </refsect1>
 
   <refsect1>
+    <title>SIGNALS</title>
+    <para>Sending the ucarp process a SIGUSR1 will have it log a status line to
+    syslog, eg "Sep 13 12:59:56 localhost ucarp[2654]: [INFO] MASTER on eth0 
id 1" or "Sep 13 13:00:25 localhost ucarp[2644]: [INFO] BACKUP on eth0 id 1"
+    </para>
+    <para>Sending the ucarp process a SIGUSR2 will demote itself from master to
+    backup, pause 3 seconds, then proceed as usual to listen for other masters
+    and promote itself if necessary. This could be useful if you wish another
+    node to take over master.
+    </para>
+
+  </refsect1>
+
+  <refsect1>
     <title>AUTHOR</title>
     <para>&dhpackage; was written by Frank Denis, 
&lt;j...@ucarp.org&gt;.</para>
 
Regards
--
Tom

-- System Information:
Debian Release: squeeze/sid
  APT prefers testing
  APT policy: (400, 'testing'), (300, 'unstable')
Architecture: i386 (i686)

Kernel: Linux 2.6.26-2-686 (SMP w/1 CPU core)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages ucarp depends on:
ii  libc6                         2.9-23     GNU C Library: Shared libraries
ii  libpcap0.8                    1.0.0-2    system interface for user-level pa

Versions of packages ucarp recommends:
ii  iproute                       20090324-1 networking and traffic control too

ucarp suggests no packages.

-- no debconf information



-- 
To UNSUBSCRIBE, email to debian-bugs-dist-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org