Annotation of src/usr.bin/ypwhich/ypwhich.1, Revision 1.18
1.18 ! tedu 1: .\" $OpenBSD: ypwhich.1,v 1.17 2014/09/08 01:27:55 schwarze Exp $
1.2 deraadt 2: .\" $NetBSD: ypwhich.1,v 1.3 1996/05/13 02:43:46 thorpej Exp $
1.1 deraadt 3: .\"
4: .\" Copyright (c) 1994 Christopher G. Demetriou
5: .\" All rights reserved.
6: .\"
7: .\" Redistribution and use in source and binary forms, with or without
8: .\" modification, are permitted provided that the following conditions
9: .\" are met:
10: .\" 1. Redistributions of source code must retain the above copyright
11: .\" notice, this list of conditions and the following disclaimer.
12: .\" 2. Redistributions in binary form must reproduce the above copyright
13: .\" notice, this list of conditions and the following disclaimer in the
14: .\" documentation and/or other materials provided with the distribution.
15: .\" 3. All advertising materials mentioning features or use of this software
16: .\" must display the following acknowledgement:
17: .\" This product includes software developed by Christopher G. Demetriou.
18: .\" 3. The name of the author may not be used to endorse or promote products
19: .\" derived from this software without specific prior written permission
20: .\"
21: .\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
22: .\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
23: .\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
24: .\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
25: .\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
26: .\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
27: .\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
28: .\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
29: .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
30: .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
31: .\"
1.18 ! tedu 32: .Dd $Mdocdate: September 8 2014 $
1.1 deraadt 33: .Dt YPWHICH 1
34: .Os
35: .Sh NAME
36: .Nm ypwhich
1.12 millert 37: .Nd return hostname of YP server or map master
1.1 deraadt 38: .Sh SYNOPSIS
39: .Nm ypwhich
1.14 jmc 40: .Op Fl t
1.1 deraadt 41: .Op Fl d Ar domain
42: .Oo
1.14 jmc 43: .Op Fl h
44: .Ar host
45: .Oc
46: .Nm ypwhich
47: .Op Fl t
48: .Op Fl d Ar domain
1.7 maja 49: .Op Fl h Ar host
1.1 deraadt 50: .Fl m Op Ar mname
51: .Nm ypwhich
52: .Fl x
53: .Sh DESCRIPTION
1.8 aaron 54: .Nm
1.1 deraadt 55: tells which
56: .Tn YP
57: server supplies
58: .Tn YP
59: services to a client, or which is the master for a map.
60: If invoked without arguments, it gives the
61: .Tn YP
62: server for the local machine.
63: If
64: .Ar host
65: is specified, that machine is queried to find out
66: which
67: .Tn YP
68: server it is using.
69: .Pp
70: The options are as follows:
1.10 aaron 71: .Bl -tag -width Ds
1.1 deraadt 72: .It Fl d Ar domain
73: Specify a domain other than the default domain.
1.7 maja 74: .It Fl h Ar host
1.14 jmc 75: Specify which host to query.
1.1 deraadt 76: .It Fl m Op Ar mname
77: Find the master
78: .Tn YP
1.9 aaron 79: server for the named map.
1.14 jmc 80: The
1.1 deraadt 81: .Ar host
1.14 jmc 82: to query, if non-default,
83: must be specified using the
84: .Fl h
1.1 deraadt 85: option.
1.14 jmc 86: .Ar mname
1.9 aaron 87: can be a map name or nickname.
88: If
1.1 deraadt 89: .Ar mname
1.4 deraadt 90: is omitted,
1.8 aaron 91: .Nm
1.1 deraadt 92: will produce a list of available maps.
1.13 jmc 93: .It Fl t
94: Inhibit translation of map nicknames
95: to their corresponding map names.
1.1 deraadt 96: .It Fl x
97: Display the map nickname table.
98: .El
99: .Sh SEE ALSO
100: .Xr domainname 1 ,
101: .Xr ypcat 1 ,
102: .Xr ypmatch 1 ,
1.5 aaron 103: .Xr yp 8 ,
104: .Xr ypbind 8 ,
1.1 deraadt 105: .Xr yppoll 8 ,
1.5 aaron 106: .Xr ypset 8
1.11 aaron 107: .Sh AUTHORS
1.17 schwarze 108: .An Theo de Raadt