4.3BSD-UWisc/man/cat8/ypset.8
YPSET(8) UNIX Programmer's Manual YPSET(8)
NAME
ypset - point ypbind at a particular server
SYNOPSIS
ypset [ -V1|-V2 ] [ -h _h_o_s_t ] [ -d _d_o_m_a_i_n ] _s_e_r_v_e_r
DESCRIPTION
_y_p_s_e_t tells _y_p_b_i_n_d to get YP services for the specified
_d_o_m_a_i_n from the _y_p_s_e_r_v process running on _s_e_r_v_e_r. If _s_e_r_v_e_r
is down, or isn't running _y_p_s_e_r_v, this is not discovered
until a YP client process tries to get a binding for the
domain. At this point, the binding set by _y_p_s_e_t will be
tested by _y_p_b_i_n_d. If the binding is invalid, _y_p_b_i_n_d will
attempt to rebind for the same domain.
_y_p_s_e_t is useful for binding a client node which is not on a
broadcast net, or is on a broadcast net which isn't 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 _y_p_b_i_n_d to rebind to another
host even while you attempt to find out if the _y_p_s_e_t opera-
tion succeeded. That is, you can type "ypset host1", and
then "ypwhich", which replies: "host2", which can be confus-
ing. This is a function of the YP subsystem's attempt to
load-balance among the available YP servers, and occurs when
_h_o_s_t_1 does not respond to _y_p_b_i_n_d because it is not running
_y_p_s_e_r_v (or is overloaded), and _h_o_s_t_2, running _y_p_s_e_r_v, gets
the binding.
_s_e_r_v_e_r indicates the YP server to bind to, and can be speci-
fied as a name or an IP address. If specified as a name,
_y_p_s_e_t will attempt to use YP services to resolve the name to
an IP address. This will work only if the node has a current
valid binding for the domain in question. In most cases,
_s_e_r_v_e_r should be specified as an IP address.
Refer to ypfiles(5) and ypserv(8) for an overview of the
yellow pages.
OPTIONS
-V1 Bind _s_e_r_v_e_r for the (old) v.1 YP protocol.
-V2 Bind _s_e_r_v_e_r for the (current) v.2 YP protocol.
If no version is supplied, _y_p_s_e_t, first attempts to
set the domain for the (current) v.2 protocol. If
this attempt fails, _y_p_s_e_t, then attempts to set the
domain for the (old) v.1 protocol.
Printed 12/27/86 13 September 1985 1
YPSET(8) UNIX Programmer's Manual YPSET(8)
-h _h_o_s_t Set ypbind's binding on _h_o_s_t, instead of locally.
_h_o_s_t can be specified as a name or as an IP address.
-d _d_o_m_a_i_n
Use _d_o_m_a_i_n , instead of the default domain.
SEE ALSO
ypwhich(1), ypserv(8), ypfiles(5)
Printed 12/27/86 13 September 1985 2