xref: /dflybsd-src/usr.sbin/ypset/ypset.8 (revision 86d7f5d305c6adaa56ff4582ece9859d73106103)
186d7f5d3SJohn Marino.\"
286d7f5d3SJohn Marino.\" Copyright (c) 1994 Jason R. Thorpe
386d7f5d3SJohn Marino.\" All rights reserved.
486d7f5d3SJohn Marino.\"
586d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
686d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
786d7f5d3SJohn Marino.\" are met:
886d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
986d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
1086d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
1186d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
1286d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
1386d7f5d3SJohn Marino.\" 3. All advertising materials mentioning features or use of this software
1486d7f5d3SJohn Marino.\"    must display the following acknowledgement:
1586d7f5d3SJohn Marino.\"	This product includes software developed by Jason Thorpe.
1686d7f5d3SJohn Marino.\" 4. Neither the name of the author nor the names of its contributors
1786d7f5d3SJohn Marino.\"    may be used to endorse or promote products derived from this software
1886d7f5d3SJohn Marino.\"    without specific prior written permission.
1986d7f5d3SJohn Marino.\"
2086d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
2186d7f5d3SJohn Marino.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
2286d7f5d3SJohn Marino.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
2386d7f5d3SJohn Marino.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE
2486d7f5d3SJohn Marino.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
2586d7f5d3SJohn Marino.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
2686d7f5d3SJohn Marino.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
2786d7f5d3SJohn Marino.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
2886d7f5d3SJohn Marino.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
2986d7f5d3SJohn Marino.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
3086d7f5d3SJohn Marino.\" SUCH DAMAGE.
3186d7f5d3SJohn Marino.\"
3286d7f5d3SJohn Marino.\" $FreeBSD: src/usr.sbin/ypset/ypset.8,v 1.7.2.3 2003/03/11 22:31:35 trhodes Exp $
3386d7f5d3SJohn Marino.\" $DragonFly: src/usr.sbin/ypset/ypset.8,v 1.2 2003/06/17 04:30:05 dillon Exp $
3486d7f5d3SJohn Marino.\"
3586d7f5d3SJohn Marino.Dd October 25, 1994
3686d7f5d3SJohn Marino.Dt YPSET 8
3786d7f5d3SJohn Marino.Os
3886d7f5d3SJohn Marino.Sh NAME
3986d7f5d3SJohn Marino.Nm ypset
4086d7f5d3SJohn Marino.Nd tell
4186d7f5d3SJohn Marino.Xr ypbind 8
4286d7f5d3SJohn Marinowhich YP server process to use
4386d7f5d3SJohn Marino.Sh SYNOPSIS
4486d7f5d3SJohn Marino.Nm
4586d7f5d3SJohn Marino.Op Fl h Ar host
4686d7f5d3SJohn Marino.Op Fl d Ar domain
4786d7f5d3SJohn Marino.Ar server
4886d7f5d3SJohn Marino.Sh DESCRIPTION
4986d7f5d3SJohn MarinoThe
5086d7f5d3SJohn Marino.Nm
5186d7f5d3SJohn Marinoutility tells the
5286d7f5d3SJohn Marino.Xr ypbind 8
5386d7f5d3SJohn Marinoprocess on the current machine which YP server process to communicate with.
5486d7f5d3SJohn MarinoIf
5586d7f5d3SJohn Marino.Ar server
5686d7f5d3SJohn Marinois down or is not running a YP server process, it is not discovered until
5786d7f5d3SJohn Marinoa YP client process attempts to access a YP map, at which time
5886d7f5d3SJohn Marino.Xr ypbind 8
5986d7f5d3SJohn Marinotests the binding and takes appropriate action.
6086d7f5d3SJohn Marino.Pp
6186d7f5d3SJohn MarinoThe
6286d7f5d3SJohn Marino.Nm
6386d7f5d3SJohn Marinoutility
6486d7f5d3SJohn Marinois most useful for binding a YP client that is not on the same broadcast
6586d7f5d3SJohn Marinonetwork as the closest YP server, but can also be used for debugging
6686d7f5d3SJohn Marinoa local network's YP configuration, testing specific YP client
6786d7f5d3SJohn Marinoprograms, or binding to a specific server when there are many servers on
6886d7f5d3SJohn Marinothe local network supplying YP maps.
6986d7f5d3SJohn Marino.Pp
7086d7f5d3SJohn MarinoThe options are as follows:
7186d7f5d3SJohn Marino.Bl -tag -width indent
7286d7f5d3SJohn Marino.It Fl h Ar host
7386d7f5d3SJohn MarinoSet the YP binding on
7486d7f5d3SJohn Marino.Ar host
7586d7f5d3SJohn Marinoinstead of the local machine.
7686d7f5d3SJohn Marino.It Fl d Ar domain
7786d7f5d3SJohn MarinoUse the YP domain
7886d7f5d3SJohn Marino.Ar domain
7986d7f5d3SJohn Marinoinstead of the default domain as returned by
8086d7f5d3SJohn Marino.Xr domainname 1 .
8186d7f5d3SJohn Marino.El
8286d7f5d3SJohn Marino.Sh SEE ALSO
8386d7f5d3SJohn Marino.Xr domainname 1 ,
8486d7f5d3SJohn Marino.Xr ypcat 1 ,
8586d7f5d3SJohn Marino.Xr ypmatch 1 ,
8686d7f5d3SJohn Marino.Xr yp 8 ,
8786d7f5d3SJohn Marino.Xr ypbind 8
8886d7f5d3SJohn Marino.Sh AUTHORS
8986d7f5d3SJohn Marino.An Theo De Raadt
90