manual/yp-tools/original/man8/ypset.8

   1 .\" -*- nroff -*-
   2 .\" Copyright (C) 1998, 1999, 2001, 2002 Thorsten Kukuk
   3 .\" This file is part of the yp-tools.
   4 .\" Author: Thorsten Kukuk <kukuk@suse.de>
   5 .\"
   6 .\" This program is free software; you can redistribute it and/or modify
   7 .\" it under the terms of the GNU General Public License version 2 as
   8 .\" published by the Free Software Foundation.
   9 .\"
  10 .\" This program is distributed in the hope that it will be useful,
  11 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 .\" GNU General Public License for more details.
  14 .\"
  15 .\" You should have received a copy of the GNU General Public License
  16 .\" along with this program; if not, write to the Free Software Foundation,
  17 .\" Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
  18 .\"
  19 .TH ypset 8 "May 1998" "YP Tools 2.8"
  20 .SH NAME
  21 ypset - bind ypbind to a particular NIS server
  22 .SH SYNOPSYS
  23 .B ypset
  24 [
  25 .BI \-d " domain"
  26 ]
  27 [
  28 .BI \-h " hostname"
  29 ]
  30 .I server
  31 .LP
  32 .SH DESCRIPTION
  33 In  order  to run
  34 .BR ypset,
  35 .B ypbind
  36 must be initiated with the
  37 .B -ypset
  38 or
  39 .B -ypsetme
  40 options.  See
  41 .BR ypbind (8).
  42 .B ypset
  43 tells
  44 .B ypbind
  45 to get NIS services for the specified
  46 .I domain
  47 from the
  48 .BR ypserv (8)
  49 process running on
  50 .IR server.
  51 .LP
  52 In cases where several hosts on the local net are supplying NIS services,
  53 it is possible for
  54 .B ypbind
  55 to rebind to another host even while you attempt to find out if the
  56 .B ypset
  57 operation succeeded. For example, you can type:
  58 .TP 25
  59 .PD 0
  60 .TP
  61 \f3example% ypset host1
  62 .TP
  63 \f3example% ypwhich
  64 .TP
  65 \f3host2
  66 .LP
  67
  68 which can be confusing. This is a function of the NIS subsystem's
  69 attempt to know always a running NIS server, and occurs when host1
  70 does not respond to ypbind because it is not running ypserv (or is
  71 overloaded), and host2, running ypserv, gets the binding.
  72 .LP
  73
  74 .I Server
  75 indicates the NIS server to bind to,  and must be specified as a name
  76 or an IP address. This will work only if the node has a current valid
  77 binding for the domain in question, and
  78 .B ypbind
  79 has been set to allow use of
  80 .BR ypset.
  81 In most  cases,
  82 .I server
  83 should be specified as an IP address.
  84 .LP
  85 .SH OPTIONS
  86 .TP
  87 .BI \-d " domain"
  88 Specify a domain other than the default domain as returned by
  89 .BR domainname (1).
  90 .TP
  91 .BI \-h " hostname"
  92 Set the NIS binding on host
  93 .I hostname
  94  instead of the local machine.
  95 .SH "SEE ALSO"
  96 .BR domainname (8),
  97 .BR ypbind (8),
  98 .BR ypcat (8),
  99 .BR ypmatch (1),
 100 .BR ypserv (8),
 101 .BR yppoll (8),
 102 .BR ypwhich (1)
 103 .LP
 104 .SH AUTHOR
 105 .B ypset
 106 is part of the
 107 .B yp-tools
 108 package, which was written by Thorsten Kukuk <kukuk@suse.de>.