ypset(1M)

Requires Optional NFS Services Software

NAME

ypset − bind to particular Network Information Service server

SYNOPSIS

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

DESCRIPTION

ypset tells ypbind(1M) to get Network Information Service (NIS) services for the specified domain from the ypserv(1M) process running on server. 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(1M), this is not discovered until a local NIS client process tries to obtain a binding for the domain. The ypbind(1M) daemon then tests the binding set by ypset. If the binding cannot be made to the requested server, ypbind(1M) 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(1M) 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(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 Network Information Service.

Options

−V1 Bind server for the (old) Version 1 NIS protocol.

−V2 Bind server for the (current) Version 2 NIS 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 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(1).

EXTERNAL INFLUENCES

International Code Set Support

Single-byte character codes sets are supported.

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.

AUTHOR

ypset was developed by Sun Microsystems, Inc.

Museum

Related Articles