usr.sbin/ypbind/ypbind.8

   1 .\"     $NetBSD: ypbind.8,v 1.17 2005/12/03 11:24:02 wiz Exp $
   2 .\"
   3 .\" Copyright (c) 1996 The NetBSD Foundation, Inc.
   4 .\" All rights reserved.
   5 .\"
   6 .\" This code is derived from software contributed to The NetBSD Foundation
   7 .\" by Jason R. Thorpe.
   8 .\"
   9 .\" Redistribution and use in source and binary forms, with or without
  10 .\" modification, are permitted provided that the following conditions
  11 .\" are met:
  12 .\" 1. Redistributions of source code must retain the above copyright
  13 .\"    notice, this list of conditions and the following disclaimer.
  14 .\" 2. Redistributions in binary form must reproduce the above copyright
  15 .\"    notice, this list of conditions and the following disclaimer in the
  16 .\"    documentation and/or other materials provided with the distribution.
  17 .\"
  18 .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
  19 .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  20 .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  21 .\" PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
  22 .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  23 .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  24 .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  25 .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  26 .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  27 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  28 .\" POSSIBILITY OF SUCH DAMAGE.
  29 .\"
  30 .Dd February 26, 2005
  31 .Dt YPBIND 8
  32 .Os
  33 .Sh NAME
  34 .Nm ypbind
  35 .Nd create and maintain a binding to a NIS server
  36 .Sh SYNOPSIS
  37 .Nm
  38 .Op Fl broadcast
  39 .Op Fl insecure
  40 .Op Fl ypset
  41 .Op Fl ypsetme
  42 .Sh DESCRIPTION
  43 .Nm
  44 finds the server for a particular
  45 .Tn NIS
  46 domain and stores information about it
  47 in a
  48 .Dq binding file .
  49 This binding information includes the IP address of the server associated with
  50 that particular domain and which port the server is using.
  51 This information is stored in the directory
  52 .Pa /var/yp/binding
  53 in a file named with the convention
  54 .Pa \*[Lt]domain\*[Gt].version ,
  55 where
  56 .Aq domain
  57 is the relevant domain.
  58 The
  59 .Tn NIS
  60 system only supplies information on version 2.
  61 .Pp
  62 If
  63 .Nm
  64 is started without the
  65 .Fl broadcast
  66 option,
  67 .Nm
  68 steps through the list of
  69 .Tn NIS
  70 servers specified in
  71 .Pa /var/yp/binding/\*[Lt]domain\*[Gt].ypservers
  72 and contacts each in turn attempting to bind to that server.
  73 It is strongly recommended that these hosts are in the local
  74 hosts file, and that hosts are looked up in local files before
  75 the
  76 .Tn NIS
  77 hosts map.
  78 .Pp
  79 If
  80 .Nm
  81 is started with the
  82 .Fl broadcast
  83 option, or if
  84 .Pa /var/yp/binding/\*[Lt]domain\*[Gt].ypservers
  85 does not exist,
  86 .Nm
  87 broadcasts to find a process willing to serve maps for the
  88 client's domain.
  89 .Pp
  90 Once a binding is established,
  91 .Nm
  92 maintains this binding by periodically communicating with the server to which
  93 it is bound.
  94 If the binding is somehow lost, e.g by server reboot,
  95 .Nm
  96 marks the domain as unbound and attempts to re-establish the binding.
  97 When the binding is once again successful,
  98 .Nm
  99 marks the domain as bound and resumes its periodic check.
 100 .Pp
 101 The options are as follows:
 102 .Bl -tag -width "-broadcast"
 103 .It Fl broadcast
 104 sends a broadcast requesting a
 105 .Tn NIS
 106 server to which to bind.
 107 .It Fl insecure
 108 do not require that the server is running on a reserved port.
 109 This may be necessary when connecting to
 110 .Tn SunOS 3.x
 111 or
 112 .Tn ULTRIX
 113 .Tn NIS
 114 servers.
 115 .It Fl ypset
 116 .Xr ypset 8
 117 may be used to change the server to which a domain is bound.
 118 .It Fl ypsetme
 119 .Xr ypset 8
 120 may be used only from this machine to change the server
 121 to which a domain is bound.
 122 .El
 123 .Pp
 124 The
 125 .Fl broadcast
 126 .Fl ypset ,
 127 and
 128 .Fl ypsetme ,
 129 options are inherently insecure and should be avoided.
 130 .Sh FILES
 131 .Pa /var/yp/binding/\*[Lt]domain\*[Gt].version
 132 - binding file for \*[Lt]domain\*[Gt].
 133 .Pa /var/yp/binding/\*[Lt]domain\*[Gt].ypservers
 134 - explicit list of servers to bind to for \*[Lt]domain\*[Gt].
 135 .Sh DIAGNOSTICS
 136 Messages are sent to
 137 .Xr syslogd 8
 138 using the
 139 .Dv LOG_DAEMON
 140 facility.
 141 .Sh SEE ALSO
 142 .Xr domainname 1 ,
 143 .Xr ypcat 1 ,
 144 .Xr ypmatch 1 ,
 145 .Xr ypwhich 1 ,
 146 .Xr nis 8 ,
 147 .Xr yppoll 8 ,
 148 .Xr ypset 8
 149 .Sh AUTHORS
 150 This version of
 151 .Nm
 152 was originally implemented by Theo de Raadt.
 153 The ypservers support was implemented by Luke Mewburn.