diff options
| author | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:55:15 -0400 |
|---|---|---|
| committer | Jacob McDonnell <jacob@jacobmcdonnell.com> | 2026-04-25 19:55:15 -0400 |
| commit | 253e67c8b3a72b3a4757fdbc5845297628db0a4a (patch) | |
| tree | adf53b66087aa30dfbf8bf391a1dadb044c3bf4d /static/netbsd/man8/ypbind.8 | |
| parent | a9157ce950dfe2fc30795d43b9d79b9d1bffc48b (diff) | |
docs: Added All NetBSD Manuals
Diffstat (limited to 'static/netbsd/man8/ypbind.8')
| -rw-r--r-- | static/netbsd/man8/ypbind.8 | 168 |
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 . |
