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

141 lines
4.4 KiB
Groff
Raw Normal View History

* 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
.\" $NetBSD: ypbind.8,v 1.6 1997/07/07 02:27:06 lukem 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
.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS 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.
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
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
finds the server for a particular YP domain and stores information about it
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
.Pa domainname.version.
(The YP system only supplies information on version 2.)
.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
steps through the list of YP servers specified in
Change name of ypservers file to /var/yp/binding/domain.ypservers. This is a compromise between the Solaris 2.5 naming of this file (/var/yp/binding/domain/ypservers and /var/yp/binding/domain/vers) and traditional NetBSD naming (/var/yp/binding/domain.vers). Changing to the Solaris naming makes the C library incompatible with ypbind. While it's easy to change the C library, I don't feel right about introducing a gratuitous incompatibility. The current name (/var/yp/domain/ypservers) conflicts with the name of the YP map listing slave servers for a domain. Per discussion w/ Chris Demetriou and Luke Mewburn.
1996-10-02 09:55:05 +04:00
.Pa /var/yp/binding/domainname.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
the YP hosts map.
.Pp
If
.Nm
is started with the
.Fl broadcast
option, or if
Change name of ypservers file to /var/yp/binding/domain.ypservers. This is a compromise between the Solaris 2.5 naming of this file (/var/yp/binding/domain/ypservers and /var/yp/binding/domain/vers) and traditional NetBSD naming (/var/yp/binding/domain.vers). Changing to the Solaris naming makes the C library incompatible with ypbind. While it's easy to change the C library, I don't feel right about introducing a gratuitous incompatibility. The current name (/var/yp/domain/ypservers) conflicts with the name of the YP map listing slave servers for a domain. Per discussion w/ Chris Demetriou and Luke Mewburn.
1996-10-02 09:55:05 +04:00
.Pa /var/yp/binding/domainname.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
sends a broadcast requesting a YP server to which to bind.
.It Fl insecure
do not require that clients make requests from reserved ports.
This may be necessary for
.Tn SunOS 3.x
or
.Tn ULTRIX
clients.
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
Change name of ypservers file to /var/yp/binding/domain.ypservers. This is a compromise between the Solaris 2.5 naming of this file (/var/yp/binding/domain/ypservers and /var/yp/binding/domain/vers) and traditional NetBSD naming (/var/yp/binding/domain.vers). Changing to the Solaris naming makes the C library incompatible with ypbind. While it's easy to change the C library, I don't feel right about introducing a gratuitous incompatibility. The current name (/var/yp/domain/ypservers) conflicts with the name of the YP map listing slave servers for a domain. Per discussion w/ Chris Demetriou and Luke Mewburn.
1996-10-02 09:55:05 +04:00
.Pa /var/yp/binding/domainname.version
man page from Jason Thorpe
1994-10-28 19:46:57 +03:00
- binding file for domainname
Change name of ypservers file to /var/yp/binding/domain.ypservers. This is a compromise between the Solaris 2.5 naming of this file (/var/yp/binding/domain/ypservers and /var/yp/binding/domain/vers) and traditional NetBSD naming (/var/yp/binding/domain.vers). Changing to the Solaris naming makes the C library incompatible with ypbind. While it's easy to change the C library, I don't feel right about introducing a gratuitous incompatibility. The current name (/var/yp/domain/ypservers) conflicts with the name of the YP map listing slave servers for a domain. Per discussion w/ Chris Demetriou and Luke Mewburn.
1996-10-02 09:55:05 +04:00
.Pa /var/yp/binding/domainname.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
- explicit servers to bind to.
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.