xref: /openbsd/usr.sbin/ypset/ypset.8 (revision cecf84d4)
1.\"	$OpenBSD: ypset.8,v 1.10 2014/09/08 01:27:56 schwarze Exp $
2.\"	$NetBSD: ypset.8,v 1.2 1996/02/28 01:25:08 thorpej Exp $
3.\"
4.\" Copyright (c) 1996 The NetBSD Foundation, Inc.
5.\" All rights reserved.
6.\"
7.\" This code is derived from software contributed to The NetBSD Foundation
8.\" by Jason R. Thorpe.
9.\"
10.\" Redistribution and use in source and binary forms, with or without
11.\" modification, are permitted provided that the following conditions
12.\" are met:
13.\" 1. Redistributions of source code must retain the above copyright
14.\"    notice, this list of conditions and the following disclaimer.
15.\" 2. Redistributions in binary form must reproduce the above copyright
16.\"    notice, this list of conditions and the following disclaimer in the
17.\"    documentation and/or other materials provided with the distribution.
18.\"
19.\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22.\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE
23.\" LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29.\" POSSIBILITY OF SUCH DAMAGE.
30.\"
31.Dd $Mdocdate: September 8 2014 $
32.Dt YPSET 8
33.Os
34.Sh NAME
35.Nm ypset
36.Nd tell
37.Xr ypbind 8
38which YP server process to use
39.Sh SYNOPSIS
40.Nm ypset
41.Op Fl d Ar domain
42.Op Fl h Ar host
43.Ar server
44.Sh DESCRIPTION
45.Nm
46tells the
47.Xr ypbind 8
48process on the current machine which YP server process to communicate with.
49If
50.Ar server
51is down or is not running a YP server process, it is not discovered until
52a YP client process attempts to access a YP map, at which time
53.Xr ypbind 8
54tests the binding and takes appropriate action.
55.Pp
56.Nm
57is most useful for binding a YP client that is not on the same broadcast
58network as the closest YP server, but can also be used for debugging
59a local network's YP configuration, testing specific YP client
60programs, or binding to a specific server when there are many servers on
61the local network supplying YP maps.
62.Pp
63The options are as follows:
64.Bl -tag -width Ds
65.It Fl d Ar domain
66Use the YP domain
67.Ar domain
68instead of the default domain as returned by
69.Xr domainname 1 .
70.It Fl h Ar host
71Set the YP binding on
72.Ar host
73instead of the local machine.
74.El
75.Sh SEE ALSO
76.Xr domainname 1 ,
77.Xr ypcat 1 ,
78.Xr ypmatch 1 ,
79.Xr ypwhich 1 ,
80.Xr yp 8 ,
81.Xr ypbind 8 ,
82.Xr yppoll 8
83.Sh AUTHORS
84.An Theo de Raadt
85