xref: /openbsd/usr.sbin/ypset/ypset.8 (revision f6aab3d8)
1.\"	$OpenBSD: ypset.8,v 1.11 2015/09/10 15:16:44 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 10 2015 $
32.Dt YPSET 8
33.Os
34.Sh NAME
35.Nm ypset
36.Nd tell ypbind(8) which YP server process to use
37.Sh SYNOPSIS
38.Nm ypset
39.Op Fl d Ar domain
40.Op Fl h Ar host
41.Ar server
42.Sh DESCRIPTION
43.Nm
44tells the
45.Xr ypbind 8
46process on the current machine which YP server process to communicate with.
47If
48.Ar server
49is down or is not running a YP server process, it is not discovered until
50a YP client process attempts to access a YP map, at which time
51.Xr ypbind 8
52tests the binding and takes appropriate action.
53.Pp
54.Nm
55is most useful for binding a YP client that is not on the same broadcast
56network as the closest YP server, but can also be used for debugging
57a local network's YP configuration, testing specific YP client
58programs, or binding to a specific server when there are many servers on
59the local network supplying YP maps.
60.Pp
61The options are as follows:
62.Bl -tag -width Ds
63.It Fl d Ar domain
64Use the YP domain
65.Ar domain
66instead of the default domain as returned by
67.Xr domainname 1 .
68.It Fl h Ar host
69Set the YP binding on
70.Ar host
71instead of the local machine.
72.El
73.Sh SEE ALSO
74.Xr domainname 1 ,
75.Xr ypcat 1 ,
76.Xr ypmatch 1 ,
77.Xr ypwhich 1 ,
78.Xr yp 8 ,
79.Xr ypbind 8 ,
80.Xr yppoll 8
81.Sh AUTHORS
82.An Theo de Raadt
83