xref: /netbsd/usr.sbin/ypserv/ypxfr/ypxfr.8 (revision bf9ec67e)
1.\"	$NetBSD: ypxfr.8,v 1.8 2002/03/05 15:12:35 wiz Exp $
2.\"
3.\" Copyright (c) 1994 Mats O Jansson <moj@stacken.kth.se>
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 Mats O Jansson
17.\" 4. 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
21.\" OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
22.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
23.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY
24.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
25.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
26.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
27.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
28.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
29.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30.\" SUCH DAMAGE.
31.\"
32.Dd August 18, 1994
33.Dt YPXFR 8
34.Os
35.Sh NAME
36.Nm ypxfr
37.Nd get a YP map from YP server
38.Sh SYNOPSIS
39.Nm ""
40.Op Fl bcf
41.Bk -words
42.Op Fl C Ar tid prog ipadd port
43.Ek
44.Bk -words
45.Op Fl d Ar domain
46.Ek
47.Bk -words
48.Op Fl h Ar host
49.Ek
50.Bk -words
51.Op Fl s Ar domain
52.Ek
53.Ar mapname
54.Sh DESCRIPTION
55.Nm
56is the utility in
57.Tn YP
58that transfers maps to the local host.
59.Pp
60The options are as follows:
61.Bl -tag -width indent
62.It Fl b
63Preserve the entry in the database informing a
64.Tn YP
65server to use
66DNS to get information about unknown hosts. This option will only have
67effect on the maps
68.Pa hosts.byname
69and
70.Pa hosts.byaddr .
71.It Fl c
72Don't send a "Clear current map" to local
73.Nm ypserv
74process. Useful if
75.Nm ypserv
76isn't running locally to avoid timeout message.
77.It Fl C Ar tid prog ipadd port
78This option is only used by
79.Nm ypserv .
80This is to open communication with
81.Nm yppush
82on another host.
83.It Fl d Ar domain
84Don't use default domain, use the specified domain.
85.It Fl f
86Force map transfer, even if the master's version is older than the local copy.
87.It Fl h Ar host
88Get map from host insteed of the maps master host.
89.It Fl s Ar domain
90Specify a source domain other than the target domain.
91.El
92.Sh SEE ALSO
93.Xr yp 8 ,
94.Xr yppush 8 ,
95.Xr ypserv 8
96.Sh AUTHORS
97.An Mats O Jansson Aq moj@stacken.kth.se
98