usr.sbin/ypserv/ypxfr/ypxfr.8

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