xref: /dragonfly/usr.sbin/ypset/ypset.8 (revision 86d7f5d3)
1*86d7f5d3SJohn Marino.\"
2*86d7f5d3SJohn Marino.\" Copyright (c) 1994 Jason R. Thorpe
3*86d7f5d3SJohn Marino.\" All rights reserved.
4*86d7f5d3SJohn Marino.\"
5*86d7f5d3SJohn Marino.\" Redistribution and use in source and binary forms, with or without
6*86d7f5d3SJohn Marino.\" modification, are permitted provided that the following conditions
7*86d7f5d3SJohn Marino.\" are met:
8*86d7f5d3SJohn Marino.\" 1. Redistributions of source code must retain the above copyright
9*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer.
10*86d7f5d3SJohn Marino.\" 2. Redistributions in binary form must reproduce the above copyright
11*86d7f5d3SJohn Marino.\"    notice, this list of conditions and the following disclaimer in the
12*86d7f5d3SJohn Marino.\"    documentation and/or other materials provided with the distribution.
13*86d7f5d3SJohn Marino.\" 3. All advertising materials mentioning features or use of this software
14*86d7f5d3SJohn Marino.\"    must display the following acknowledgement:
15*86d7f5d3SJohn Marino.\"	This product includes software developed by Jason Thorpe.
16*86d7f5d3SJohn Marino.\" 4. Neither the name of the author nor the names of its contributors
17*86d7f5d3SJohn Marino.\"    may be used to endorse or promote products derived from this software
18*86d7f5d3SJohn Marino.\"    without specific prior written permission.
19*86d7f5d3SJohn Marino.\"
20*86d7f5d3SJohn Marino.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND
21*86d7f5d3SJohn Marino.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
22*86d7f5d3SJohn Marino.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23*86d7f5d3SJohn Marino.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE
24*86d7f5d3SJohn Marino.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25*86d7f5d3SJohn Marino.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26*86d7f5d3SJohn Marino.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27*86d7f5d3SJohn Marino.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28*86d7f5d3SJohn Marino.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29*86d7f5d3SJohn Marino.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30*86d7f5d3SJohn Marino.\" SUCH DAMAGE.
31*86d7f5d3SJohn Marino.\"
32*86d7f5d3SJohn Marino.\" $FreeBSD: src/usr.sbin/ypset/ypset.8,v 1.7.2.3 2003/03/11 22:31:35 trhodes Exp $
33*86d7f5d3SJohn Marino.\" $DragonFly: src/usr.sbin/ypset/ypset.8,v 1.2 2003/06/17 04:30:05 dillon Exp $
34*86d7f5d3SJohn Marino.\"
35*86d7f5d3SJohn Marino.Dd October 25, 1994
36*86d7f5d3SJohn Marino.Dt YPSET 8
37*86d7f5d3SJohn Marino.Os
38*86d7f5d3SJohn Marino.Sh NAME
39*86d7f5d3SJohn Marino.Nm ypset
40*86d7f5d3SJohn Marino.Nd tell
41*86d7f5d3SJohn Marino.Xr ypbind 8
42*86d7f5d3SJohn Marinowhich YP server process to use
43*86d7f5d3SJohn Marino.Sh SYNOPSIS
44*86d7f5d3SJohn Marino.Nm
45*86d7f5d3SJohn Marino.Op Fl h Ar host
46*86d7f5d3SJohn Marino.Op Fl d Ar domain
47*86d7f5d3SJohn Marino.Ar server
48*86d7f5d3SJohn Marino.Sh DESCRIPTION
49*86d7f5d3SJohn MarinoThe
50*86d7f5d3SJohn Marino.Nm
51*86d7f5d3SJohn Marinoutility tells the
52*86d7f5d3SJohn Marino.Xr ypbind 8
53*86d7f5d3SJohn Marinoprocess on the current machine which YP server process to communicate with.
54*86d7f5d3SJohn MarinoIf
55*86d7f5d3SJohn Marino.Ar server
56*86d7f5d3SJohn Marinois down or is not running a YP server process, it is not discovered until
57*86d7f5d3SJohn Marinoa YP client process attempts to access a YP map, at which time
58*86d7f5d3SJohn Marino.Xr ypbind 8
59*86d7f5d3SJohn Marinotests the binding and takes appropriate action.
60*86d7f5d3SJohn Marino.Pp
61*86d7f5d3SJohn MarinoThe
62*86d7f5d3SJohn Marino.Nm
63*86d7f5d3SJohn Marinoutility
64*86d7f5d3SJohn Marinois most useful for binding a YP client that is not on the same broadcast
65*86d7f5d3SJohn Marinonetwork as the closest YP server, but can also be used for debugging
66*86d7f5d3SJohn Marinoa local network's YP configuration, testing specific YP client
67*86d7f5d3SJohn Marinoprograms, or binding to a specific server when there are many servers on
68*86d7f5d3SJohn Marinothe local network supplying YP maps.
69*86d7f5d3SJohn Marino.Pp
70*86d7f5d3SJohn MarinoThe options are as follows:
71*86d7f5d3SJohn Marino.Bl -tag -width indent
72*86d7f5d3SJohn Marino.It Fl h Ar host
73*86d7f5d3SJohn MarinoSet the YP binding on
74*86d7f5d3SJohn Marino.Ar host
75*86d7f5d3SJohn Marinoinstead of the local machine.
76*86d7f5d3SJohn Marino.It Fl d Ar domain
77*86d7f5d3SJohn MarinoUse the YP domain
78*86d7f5d3SJohn Marino.Ar domain
79*86d7f5d3SJohn Marinoinstead of the default domain as returned by
80*86d7f5d3SJohn Marino.Xr domainname 1 .
81*86d7f5d3SJohn Marino.El
82*86d7f5d3SJohn Marino.Sh SEE ALSO
83*86d7f5d3SJohn Marino.Xr domainname 1 ,
84*86d7f5d3SJohn Marino.Xr ypcat 1 ,
85*86d7f5d3SJohn Marino.Xr ypmatch 1 ,
86*86d7f5d3SJohn Marino.Xr yp 8 ,
87*86d7f5d3SJohn Marino.Xr ypbind 8
88*86d7f5d3SJohn Marino.Sh AUTHORS
89*86d7f5d3SJohn Marino.An Theo De Raadt
90