ypset.1m (2010 09)

y
ypset(1M) ypset(1M)
NAME
ypset - bind to particular Network Information Service server
SYNOPSIS
/usr/sbin/ypset
[-h host ][-d domain ][-V2
] 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 present in the
ypservers file.
NOTE: In order to run
ypset, ypbind
must be initiated with the -ypset or -ypsetme options.
For more information on how to initiate
ypbind, see ypbind (1M).
The
ypset command is useful for binding a client node that is not on a broadcast network. 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 exam-
ple, 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.
The server is the NIS server to bind to, specified as either a host name or an IP address.
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:
-V2 Bind server for the Version 2 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 domain-
name(1)).
DIAGNOSTICS
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 expla-
nations of the -ypset flags.
WARNINGS
Starting with ONCplus version B.11.31.02, the NIS Version 1 protocol is no longer available.
AUTHOR
ypset was developed by Sun Microsystems, Inc.
SEE ALSO
domainname(1), ypwhich(1), ypserv(1M), ypfiles(4).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1