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