ypset(NADM)                     19 June 1992                     ypset(NADM)


 Name

    ypset - point ypbind at a particular server

 Syntax

    ypset [ -V1|-V2 ] [ -h host ] [ -d domain ] server

 Description

    ypset tells ypbind to get network information service (NIS) services for
    the specified domain from the ypserv process running on server.  If
    server is down or is not running ypserv, this is not discovered until an
    NIS client process tries to get a binding for the domain.  At this point,
    the binding set by ypset will be tested by ypbind.  If the binding is
    invalid, ypbind will attempt to rebind for the same domain.


    ypset is useful for binding a client node which is either not on a broad-
    cast net or is on a broadcast net that is not running an NIS server host.
    It also is useful for debugging NIS client applications, for instance
    where an NIS map only exists at a single NIS server host.


    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.  That is, you can
    type ypset host1, and then ypwhich, and then receive the reply: host2,
    which can be confusing.  This is a function of the NIS subsystem's
    attempt to load-balance among the available NIS servers. It occurs when
    host1 does not respond to ypbind (because it is not running ypserv or is
    overloaded) and host2 (which is running ypserv) gets the binding.


    server indicates the NIS server to bind to and can be specified as a name
    or an IP address.  If specified as a name, ypset will attempt to use NIS
    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, server should be specified as an IP address.


    Refer to ypfiles(NF) and ypserv(NADM) for an overview of the network in-
    formation service.


 Options


    -V1     bind server for the (old) v.1 NIS protocol

    -V2     bind server for the (current) v.2 NIS protocol

            If no version parameter is supplied, ypset first attempts to set
            the domain for the (current) v.2 protocol.  If this attempt
            fails, ypset then attempts to set the domain for the (old) v.1
            protocol.

    -h host set ypbind's binding on host, instead of locally. host can be
            specified as a name or as an IP address.

    -d domain
            use domain instead of the default domain.

 See also

    ypwhich(NADM), ypserv(NADM), ypfiles(NF)

 Notes

    ypset cannot send RPC messages to ypbind on a host where ypbind is not
    running without one of the -ypset options. See ypserv(NADM) for explana-
    tions of the -ypset options.