NAME
ypset — bind to particular Network Information Service server
SYNOPSIS
/usr/sbin/ypset
[-V1]
[-h
host]
[-d
domain]
server
Remarks
The Network Information Service (NIS) was formerly known as Yellow Pages (yp).
Although the name has changed, the functionality of the
service remains the same.
DESCRIPTION
ypset
tells
ypbind
to get Network Information Service
(NIS)
services for the specified
domain
from the
ypserv
process running on
server
(see
ypserv(1M)
and
ypbind(1M)).
server
is the
NIS
server that the
NIS
client binds to, and is specified as either a host name or an
IP
address.
If
server
is down or is not running
ypserv,
this is not discovered until a local
NIS
client process tries to obtain a binding for the domain.
The
ypbind
daemon then tests the binding set by
ypset.
If the binding cannot be made to the requested server,
ypbind
attempts to rebind to another server in the same domain.
The
ypset
command is useful for binding a client node
that is not on a broadcast network,
since broadcasting is the method by which
ypbind
locates a
NIS
server.
If a client node exists on a broadcast network which has no
NIS
server running, and if there is a network with one running
that is available via a gateway,
ypset
can establish a binding through that gateway.
It is also useful for debugging
NIS
client applications such as when a
NIS
map exists only at a single
NIS
server.
In cases where several hosts on the local net are supplying
NIS
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, typing
ypset host1
followed by
ypwhich
and receiving the reply
host2
may be confusing.
It could occur when
host1
does not respond to
ypbind
because its
ypserv
process is not running or is overloaded, and
host2,
running
ypserv,
gets the binding.
Refer to
ypfiles(4)
and
ypserv(1M)
for an overview of the Network Information Service.
Options
ypset
recognizes the following options and command-line arguments:
- -V1
Bind
server
for the (old) Version 1
NIS
protocol.
- -h host
Set the binding on
host
instead of locally.
host
can be specified as a host name or an
IP
address.
- -d domain
Use
domain
instead of the default domain returned by
domainname
(see
domainname(1)).
DIAGNOTICS
- Sorry, ypbind on host 'name' has rejected your request.
The user is not root, or ypbind was run without the
-ypset
flags.
See
ypserv(1M)
for explanations of the
-ypset
flags.
- Sorry, I couldn't send my rpc message to ypbind on host 'name'.
The user is not root, or ypbind was run without one of the
-ypset
flags. See
ypserv(1M)
for explanations of the
-ypset
flags.
WARNINGS
The
server
is the
NIS
server to bind to, specified as either a host name or an IP address.
If
server
is a host name,
ypset
uses the
NIS
services'
hosts
database (built from
/etc/hosts
on the master server) to resolve the name to an IP address.
This process works only if the node currently has a valid binding
for the domain in question.
In most cases,
server
should be specified as an
IP
address.
The NIS Version 1 protocol will not be available
in a future HP-UX release.
HP recommends that you use the next version of this protocol.
AUTHOR
ypset
was developed by Sun Microsystems, Inc.
Printable version
