[src/trunk]: src/usr.sbin/ypbind Document exponential backoff behavior and SI...

[dholland <dholland%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/ded6e73180fd
branches:  trunk
changeset: 796715:ded6e73180fd
user:      dholland <dholland%NetBSD.org@localhost>
date:      Sun Jun 15 01:37:48 2014 +0000

description:
Document exponential backoff behavior and SIGHUP support, plus a couple
other minor edits.

diffstat:

 usr.sbin/ypbind/ypbind.8 |  25 ++++++++++++++++++-------
 1 files changed, 18 insertions(+), 7 deletions(-)

diffs (64 lines):

diff -r be164a1ad3c2 -r ded6e73180fd usr.sbin/ypbind/ypbind.8
--- a/usr.sbin/ypbind/ypbind.8  Sat Jun 14 22:39:36 2014 +0000
+++ b/usr.sbin/ypbind/ypbind.8  Sun Jun 15 01:37:48 2014 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: ypbind.8,v 1.18 2008/04/30 13:11:03 martin Exp $
+.\"    $NetBSD: ypbind.8,v 1.19 2014/06/15 01:37:48 dholland Exp $
 .\"
 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd February 26, 2005
+.Dd June 14, 2014
 .Dt YPBIND 8
 .Os
 .Sh NAME
@@ -94,9 +94,9 @@
 If the binding is somehow lost, e.g by server reboot,
 .Nm
 marks the domain as unbound and attempts to re-establish the binding.
-When the binding is once again successful,
+If a binding cannot be re-established within 60 seconds,
 .Nm
-marks the domain as bound and resumes its periodic check.
+backs off exponentially to trying only once per hour.
 .Pp
 The options are as follows:
 .Bl -tag -width "-broadcast"
@@ -114,7 +114,7 @@
 servers.
 .It Fl ypset
 .Xr ypset 8
-may be used to change the server to which a domain is bound.
+may be used from anywhere to change the server to which a domain is bound.
 .It Fl ypsetme
 .Xr ypset 8
 may be used only from this machine to change the server
@@ -122,11 +122,22 @@
 .El
 .Pp
 The
-.Fl broadcast
+.Fl broadcast ,
 .Fl ypset ,
 and
-.Fl ypsetme ,
+.Fl ypsetme
 options are inherently insecure and should be avoided.
+.Sh SIGNALS
+.Nm
+responds to the following signals:
+.Bl -tag -width TERM -compact
+.It HUP
+causes
+.Nm
+to immediately retry any unbound domains that are currently in
+exponential backoff.
+Use this to resume immediately after a long network outage is
+resolved.
 .Sh FILES
 .Pa /var/yp/binding/\*[Lt]domain\*[Gt].version
 - binding file for \*[Lt]domain\*[Gt].