Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
NetBSD/usr.sbin/ypbind/ypbind.8

157 lines
4.6 KiB
Groff
Raw Normal View History

note that messages are send to syslog daemon using facility LOG_DAEMON.
1998-08-21 13:39:32 +04:00
.\" $NetBSD: ypbind.8,v 1.11 1998/08/21 09:39:32 bouyer Exp $
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
.\"
Copyright assigned to The NetBSD Foundation.
1996-02-28 04:13:20 +03:00
.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
.\" All rights reserved.
.\"
Copyright assigned to The NetBSD Foundation.
1996-02-28 04:13:20 +03:00
.\" This code is derived from software contributed to The NetBSD Foundation
.\" by Jason R. Thorpe.
.\"
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
.\" 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.
.\" 3. All advertising materials mentioning features or use of this software
.\" must display the following acknowledgement:
Copyright assigned to The NetBSD Foundation.
1996-02-28 04:13:20 +03:00
.\" This product includes software developed by the NetBSD
.\" Foundation, Inc. and its contributors.
.\" 4. Neither the name of The NetBSD Foundation nor the names of its
.\" contributors may be used to endorse or promote products derived
.\" from this software without specific prior written permission.
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
.\"
Copyright assigned to The NetBSD Foundation.
1996-02-28 04:13:20 +03:00
.\" 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
Fix files using old TNF copyright notice
1997-07-31 02:53:50 +04:00
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
Copyright assigned to The NetBSD Foundation.
1996-02-28 04:13:20 +03:00
.\" 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.
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
.\"
* use _yp_invalid_domain() (from libc) to validate the domainnames * cleanup for -Wall * use __RCSID the following were inspired by openbsd: * only allow connections from reserved ports * implement -insecure, which turns off the above restriction (required for sunos 3.x and ultrix) * prevent more than 100 domains from being bound at once, preventing a denial of service attacks
1997-07-07 06:27:05 +04:00
.Dd July 7, 1997
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
.Dt YPBIND 8
.Os
.Sh NAME
.Nm ypbind
.Nd create and maintain a binding to a YP server
.Sh SYNOPSIS
* use _yp_invalid_domain() (from libc) to validate the domainnames * cleanup for -Wall * use __RCSID the following were inspired by openbsd: * only allow connections from reserved ports * implement -insecure, which turns off the above restriction (required for sunos 3.x and ultrix) * prevent more than 100 domains from being bound at once, preventing a denial of service attacks
1997-07-07 06:27:05 +04:00
.Nm
.Op Fl broadcast
.Op Fl insecure
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
.Op Fl ypset
.Op Fl ypsetme
.Sh DESCRIPTION
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
.Nm
* -insecure is for binding to insecure *servers*, not insecure *clients*. noted by Bill Studenmund <skippy@macro.stanford.edu>. * use .Tn YP instead of YP
1998-01-23 16:36:57 +03:00
finds the server for a particular
.Tn YP
domain and stores information about it
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
in a
.Pa 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
clarify that "domainname" in various pathnames is the actual domain name
1997-10-06 05:20:15 +04:00
.Pa <domain>.version ,
where
.Aq domain
is the relevant domain.
* -insecure is for binding to insecure *servers*, not insecure *clients*. noted by Bill Studenmund <skippy@macro.stanford.edu>. * use .Tn YP instead of YP
1998-01-23 16:36:57 +03:00
The
.Tn YP
system only supplies information on version 2.
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
.Pp
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
If
.Nm
is started without the
.Fl broadcast
option,
.Nm
* -insecure is for binding to insecure *servers*, not insecure *clients*. noted by Bill Studenmund <skippy@macro.stanford.edu>. * use .Tn YP instead of YP
1998-01-23 16:36:57 +03:00
steps through the list of
.Tn YP
servers specified in
clarify that "domainname" in various pathnames is the actual domain name
1997-10-06 05:20:15 +04:00
.Pa /var/yp/binding/<domain>.ypservers
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
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
* -insecure is for binding to insecure *servers*, not insecure *clients*. noted by Bill Studenmund <skippy@macro.stanford.edu>. * use .Tn YP instead of YP
1998-01-23 16:36:57 +03:00
the
.Tn YP
hosts map.
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
.Pp
If
.Nm
is started with the
.Fl broadcast
option, or if
clarify that "domainname" in various pathnames is the actual domain name
1997-10-06 05:20:15 +04:00
.Pa /var/yp/binding/<domain>.ypservers
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
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
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
maintains this binding by periodically communicating with the server to which
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
it is bound.
If the binding is somehow lost, e.g by server reboot,
.Nm
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
marks the domain as unbound and attempts to re-establish the binding.
When the binding is once again successful,
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
.Nm
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
marks the domain as bound and resumes its periodic check.
.Pp
The options are as follows:
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
.Bl -tag -width "-broadcast"
* use _yp_invalid_domain() (from libc) to validate the domainnames * cleanup for -Wall * use __RCSID the following were inspired by openbsd: * only allow connections from reserved ports * implement -insecure, which turns off the above restriction (required for sunos 3.x and ultrix) * prevent more than 100 domains from being bound at once, preventing a denial of service attacks
1997-07-07 06:27:05 +04:00
.It Fl broadcast
* -insecure is for binding to insecure *servers*, not insecure *clients*. noted by Bill Studenmund <skippy@macro.stanford.edu>. * use .Tn YP instead of YP
1998-01-23 16:36:57 +03:00
sends a broadcast requesting a
.Tn YP
server to which to bind.
* use _yp_invalid_domain() (from libc) to validate the domainnames * cleanup for -Wall * use __RCSID the following were inspired by openbsd: * only allow connections from reserved ports * implement -insecure, which turns off the above restriction (required for sunos 3.x and ultrix) * prevent more than 100 domains from being bound at once, preventing a denial of service attacks
1997-07-07 06:27:05 +04:00
.It Fl insecure
* -insecure is for binding to insecure *servers*, not insecure *clients*. noted by Bill Studenmund <skippy@macro.stanford.edu>. * use .Tn YP instead of YP
1998-01-23 16:36:57 +03:00
do not require that the server is running on a reserved port.
This may be necessary when connecting to
* use _yp_invalid_domain() (from libc) to validate the domainnames * cleanup for -Wall * use __RCSID the following were inspired by openbsd: * only allow connections from reserved ports * implement -insecure, which turns off the above restriction (required for sunos 3.x and ultrix) * prevent more than 100 domains from being bound at once, preventing a denial of service attacks
1997-07-07 06:27:05 +04:00
.Tn SunOS 3.x
or
.Tn ULTRIX
* -insecure is for binding to insecure *servers*, not insecure *clients*. noted by Bill Studenmund <skippy@macro.stanford.edu>. * use .Tn YP instead of YP
1998-01-23 16:36:57 +03:00
.Tn YP
servers.
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
.It Fl ypset
.Xr ypset 8
may be used 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
* use _yp_invalid_domain() (from libc) to validate the domainnames * cleanup for -Wall * use __RCSID the following were inspired by openbsd: * only allow connections from reserved ports * implement -insecure, which turns off the above restriction (required for sunos 3.x and ultrix) * prevent more than 100 domains from being bound at once, preventing a denial of service attacks
1997-07-07 06:27:05 +04:00
.Fl broadcast
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
.Fl ypset ,
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
and
* use _yp_invalid_domain() (from libc) to validate the domainnames * cleanup for -Wall * use __RCSID the following were inspired by openbsd: * only allow connections from reserved ports * implement -insecure, which turns off the above restriction (required for sunos 3.x and ultrix) * prevent more than 100 domains from being bound at once, preventing a denial of service attacks
1997-07-07 06:27:05 +04:00
.Fl ypsetme ,
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
options are inherently insecure and should be avoided.
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
.Sh FILES
clarify that "domainname" in various pathnames is the actual domain name
1997-10-06 05:20:15 +04:00
.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>.
note that messages are send to syslog daemon using facility LOG_DAEMON.
1998-08-21 13:39:32 +04:00
.Sh DIAGNOSTICS
Messages are send to syslog daemon using facility LOG_DAEMON.
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
.Sh SEE ALSO
.Xr domainname 1 ,
.Xr ypcat 1 ,
.Xr ypmatch 1 ,
.Xr yppoll 8 ,
.Xr ypset 8 ,
.Xr ypwhich 1 ,
.Xr yp 8
.Sh AUTHOR
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
This version of
* use _yp_invalid_domain() (from libc) to validate the domainnames * cleanup for -Wall * use __RCSID the following were inspired by openbsd: * only allow connections from reserved ports * implement -insecure, which turns off the above restriction (required for sunos 3.x and ultrix) * prevent more than 100 domains from being bound at once, preventing a denial of service attacks
1997-07-07 06:27:05 +04:00
.Nm
.ypservers -> ypservers, to match Solaris 2.5
1996-10-01 05:37:58 +04:00
was originally implemented by Theo de Raadt. The ypservers support was
Add Luke Mewburn's support for a .ypservers file, which contains a list of YP servers a client should bind to, mostly verbatim, but slightly modified for better semantics when nagging servers if a ypset has been issued. Default to broadcast mode if no .ypservers file is present. Documentation changes to match, slightly tweaked by Scott Reynolds and myself. Closes PR #1759.
1996-10-01 04:22:27 +04:00
implemented by Luke Mewburn.