NAME

ypset - point ypbind at a particular server

SYNOPSIS

/usr/sbin/ypset [ -d ypdomain ] [ -h host ] server

DESCRIPTION

In order to run ypset, ypbind must  be  initiated  with  the
-ypset  or  -ypsetme  options.  See ypserv(1M).  ypset tells
ypbind to get YP services for the  specified  ypdomain  from
the ypserv process running on server.  If server is down, or
is not running ypserv, this is not  discovered  until  a  YP
client  process  tries  to get a binding for the domain.  At
this point, the binding set  by  ypset  will  be  tested  by
ypbind.   If  the binding is invalid, ypbind will attempt to
rebind for the same domain.  ypset is useful for  binding  a
client  node  which  is  not  on a broadcast net, or is on a
broadcast net which is not running a  YP  server  host.   It
also  is  useful  for  debugging YP client applications, for
instance where a YP map only exists at a  single  YP  server
host.   In  cases  where  several hosts on the local net are
supplying YP services, it is possible for ypbind  to  rebind
to  another  host  even while you attempt to find out if the
ypset operation succeeded. For example, you can type:
     % ypset host1
     % ypwhich
     host2
which can be confusing.   This  is  a  function  of  the  YP
subsystem's  attempt  to load-balance among the available YP
servers, and occurs when host1 does not  respond  to  ypbind
because  it  is  not  running ypserv (or is overloaded), and
host2, running ypserv, gets the binding.   server  indicates
the  YP  server to bind to, and must be specified as a name.
This will work only if the node has a current valid  binding
for the domain in question, and ypbind has been set to allow
use of ypset.  In most cases, server should be specified  as
an  IP  address.  ypset tries to bind ypbind over a datagram
transport first.  Datagram Transports  are  recommended  for
higher   performance.   The  YP  library  calls,  yp_enum(),
yp_all(), yp_next(), and yp_first() use  circuit  transports
regardless  of  the  "main"  transport being used.  Refer to
ypfiles(4) and ypserv(1M) for an overview  of  the  YP  name
service.  The following options are available:

-h host Set ypbind's binding on host,  instead  of  locally.
        host must be specified as a name.

-d ypdomain

Use ypdomain , instead of the default domain.

SEE ALSO

ypserv(1M), ypwhich(1), ypfiles(4)