summaryrefslogtreecommitdiff
path: root/static/netbsd/man8/ypbind.8
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:55:15 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:55:15 -0400
commit253e67c8b3a72b3a4757fdbc5845297628db0a4a (patch)
treeadf53b66087aa30dfbf8bf391a1dadb044c3bf4d /static/netbsd/man8/ypbind.8
parenta9157ce950dfe2fc30795d43b9d79b9d1bffc48b (diff)
docs: Added All NetBSD Manuals
Diffstat (limited to 'static/netbsd/man8/ypbind.8')
-rw-r--r--static/netbsd/man8/ypbind.8168
1 files changed, 168 insertions, 0 deletions
diff --git a/static/netbsd/man8/ypbind.8 b/static/netbsd/man8/ypbind.8
new file mode 100644
index 00000000..c5f4e4c9
--- /dev/null
+++ b/static/netbsd/man8/ypbind.8
@@ -0,0 +1,168 @@
+.\" $NetBSD: ypbind.8,v 1.22 2017/07/03 21:35:32 wiz Exp $
+.\"
+.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
+.\" All rights reserved.
+.\"
+.\" This code is derived from software contributed to The NetBSD Foundation
+.\" by Jason R. Thorpe.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
+.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
+.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
+.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd June 14, 2014
+.Dt YPBIND 8
+.Os
+.Sh NAME
+.Nm ypbind
+.Nd create and maintain a binding to a NIS server
+.Sh SYNOPSIS
+.Nm
+.Op Fl broadcast
+.Op Fl insecure
+.Op Fl ypset
+.Op Fl ypsetme
+.Sh DESCRIPTION
+.Nm
+finds the server for a particular
+.Tn NIS
+domain and stores information about it
+in a
+.Dq binding file .
+This binding information includes the IP address of the server associated with
+that particular domain and which port the server is using.
+This information is stored in the directory
+.Pa /var/yp/binding
+in a file named with the convention
+.Pa <domain>.version ,
+where
+.Aq domain
+is the relevant domain.
+The
+.Tn NIS
+system only supplies information on version 2.
+.Pp
+If
+.Nm
+is started without the
+.Fl broadcast
+option,
+.Nm
+steps through the list of
+.Tn NIS
+servers specified in
+.Pa /var/yp/binding/<domain>.ypservers
+and contacts each in turn attempting to bind to that server.
+It is strongly recommended that these hosts are in the local
+hosts file, and that hosts are looked up in local files before
+the
+.Tn NIS
+hosts map.
+.Pp
+If
+.Nm
+is started with the
+.Fl broadcast
+option, or if
+.Pa /var/yp/binding/<domain>.ypservers
+does not exist,
+.Nm
+broadcasts to find a process willing to serve maps for the
+client's domain.
+.Pp
+Once a binding is established,
+.Nm
+maintains this binding by periodically communicating with the server to which
+it is bound.
+If the binding is somehow lost, e.g by server reboot,
+.Nm
+marks the domain as unbound and attempts to re-establish the binding.
+If a binding cannot be re-established within 60 seconds,
+.Nm
+backs off exponentially to trying only once per hour.
+.Pp
+The options are as follows:
+.Bl -tag -width "-broadcast"
+.It Fl broadcast
+sends a broadcast requesting a
+.Tn NIS
+server to which to bind.
+.It Fl insecure
+do not require that the server is running on a reserved port.
+This may be necessary when connecting to
+.Tn SunOS 3.x
+or
+.Tn ULTRIX
+.Tn NIS
+servers.
+.It Fl ypset
+.Xr ypset 8
+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
+to which a domain is bound.
+.El
+.Pp
+The
+.Fl broadcast ,
+.Fl ypset ,
+and
+.Fl ypsetme
+options are inherently insecure and should be avoided.
+.Sh SIGNALS
+.Nm
+responds to the following signals:
+.Bl -tag -width TERM -compact
+.It Dv 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.
+.El
+.Sh FILES
+.Pa /var/yp/binding/<domain>.version
+- binding file for <domain>.
+.Pa /var/yp/binding/<domain>.ypservers
+- explicit list of servers to bind to for <domain>.
+.Sh DIAGNOSTICS
+Messages are sent to
+.Xr syslogd 8
+using the
+.Dv LOG_DAEMON
+facility.
+.Sh SEE ALSO
+.Xr domainname 1 ,
+.Xr ypcat 1 ,
+.Xr ypmatch 1 ,
+.Xr ypwhich 1 ,
+.Xr nis 8 ,
+.Xr yppoll 8 ,
+.Xr ypset 8
+.Sh AUTHORS
+.An -nosplit
+This version of
+.Nm
+was originally implemented by
+.An Theo de Raadt .
+The ypservers support was implemented by
+.An Luke Mewburn .