NAME

ypset - bind to a particular Yellow Pages server

SYNOPSIS

/usr/etc/yp/ypset [ −V1|−V2 ] [ -h host ] [ -d domain ] \
                  server

DESCRIPTION

The ypset command tells ypbind(1M) to get Yellow Pages (YP) services for the specified domain from the ypserv(1M) process running on server. The server is the YP server which the YP client binds to and is specified as either a host name or an IP address.  If server is down or is not running ypserv(1M), this is not discovered until a local YP client process tries to obtain a binding for the domain.  The ypbind(1M) daemon will then test the binding set by ypset. If the binding cannot be made to the requested server, ypbind(1M) will attempt to rebind to another server in the same domain.

The ypset command is useful for binding a client node which is not on a broadcast network, since broadcasting is the method by which ypbind(1M) locates a YP server. If a client node exists on a broadcast network which has no YP server running, and if there is a network which has one running and is available via a gateway, ypset can establish a binding through that gateway.  It is also useful for debugging YP client applications, for instance, when a YP map exists only at a single YP server. 

In cases where several hosts on the local net are supplying YP services, it is possible for ypbind(1M) 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(1M) because its ypserv(1M) process is not running or is overloaded, and host2, running ypserv(1M), gets the binding.

Refer to ypfiles(4) and ypserv(1M) for an overview of the YP.

Options

−V1Bind server for the (old) Version 1 YP protocol. 

−V2Bind server for the (current) Version 2 YP protocol. 

If neither version is supplied, ypset first attempts to set the binding for the Version 2 protocol.  If this fails, ypset then attempts to set the binding for the Version 1 protocol. 

−h hostSet the binding on host instead of locally.  The host can be specified as a host name or an IP address. 

−d domainUse domain instead of the default domain, which is returned by domainname(1).

WARNINGS

The server is the YP server to bind to, specified as either a host name or an IP address.  If server is a host name, ypset uses the YP 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. 

AUTHOR

Sun Microsystems, Inc. 

SEE ALSO

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

INTERNATIONAL SUPPORT

8-bit data, messages

Hewlett-Packard Company  —  May 11, 2021