Extended manual page to reflect SIGHUP as a gentle "please go away"

diff --git a/sipproxy64.man b/sipproxy64.man
index 3a54ab2..e678ded 100644 (file)
--- a/sipproxy64.man
+++ b/sipproxy64.man
@@ -86,6 +86,20 @@ assign an IPv6 proxy address to an IPv4-only phone or PBX.  Note that the
 local address must already exist.  Any number of these parameters can be
 supplied, including even zero (in which case a simple proxy mode is assumed,
 meaning that \fB\-u\fR and \fB\-U\fR are required).
+.SH SIGNALS
+.PP
+It is possible to send a \fBHUP\fR signal to \fBSIPproxy64\fR, after
+which it will unbind from its SIP ports.  This makes it possible for
+a new instance of \fBSIPproxy64\fR to bind to those ports, or perhaps
+to others if the configuration has changed.  Since the transport used
+is UDP, no client should notice a quick changeover done this way.
+To further smoothe the changeover, any \fBRTPproxy64\fR services in
+progress will continue to keep the hung up \fBSIPproxy64\fR alive
+until they terminate.  With SIP signaling not being processed anymore,
+the only way for such termination of RTP traffic will be a delay of
+60 seconds without data.  In short, sending \fBHUP\fR to \fBSIPproxy64\fR
+will ask it to gently go away, and immediately make place for a new
+incarnation of itself.
 .SH EXAMPLES
 .PP
 A home router's SIP service may be exported over IPv6.  To be able