ypset(8)                            CLIX                            ypset(8)



  NAME

    ypset - Points ypbind to a particular NIS server

  SYNOPSIS

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

  FLAGS

    -V1         Binds server for the (old) version 1 NIS protocol.

    -V2         Binds server for the (current) version 2 NIS protocol.

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

    -h host     Sets the ypbind binding on host instead of locally.  The host
                parameter can be specified as a name or as an IP address.

    -d domain   Uses domain instead of the default domain.

  DESCRIPTION

    The ypset command tells ypbind to obtain Network Information Service (NIS)
    services for the specified domain from the ypserv process running on
    server.  A server that is down or not running ypserv is not discovered
    until a NIS client process tries to get a binding for the domain.  At this
    point, the binding set by ypset is tested by ypbind.  If the binding is
    invalid, ypbind attempts to rebind for the same domain.

    The ypset command is useful for binding a client node not on a broadcast
    network, or on a broadcast network not running an NIS server host.  It
    also is useful for debugging NIS client applications (for instance, where
    a NIS map only exists at a single NIS server host).  Only root is allowed
    to execute ypset.  Also, root is allowed to alter bindings, subject to
    permission by the ypbind daemon.

    When several hosts on the local net are supplying NIS services, it is
    possible for ypbind to rebind to another host even while attempting to
    find out if the ypset operation succeeded.  That is, ypset host1 can be
    typed, and then ypwhich which replies host2.  This reply can be confusing.
    This is a function of the NIS subsystem's attempt to load-balance among
    the available NIS servers and occurs when host1 does not respond to ypbind
    because it is not running ypserv (or is overloaded), and host2, running
    ypserv, gets the binding.

    The server parameter indicates the NIS server to bind to, and can be
    specified as a name or an Internet Protocol (IP) address.  If specified as



  2/94 - Intergraph Corporation                                              1

  ypset(8)                            CLIX                            ypset(8)



    a name, ypset attempts to use NIS services to resolve the name to an IP
    address.  This works 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(4) and ypserv(8) for an overview of NIS.

  EXAMPLES

    To tell ypbind on node sys3 to obtain NIS services from node NISmaster,
    enter:

    /etc/ypset -h sys3 NISmaster


  NOTES

    Because of new security features in the 06.00 release, a client machine
    running the 05.00 NFS software will not be able to set bindings using
    ypset on a machine running 06.00 NFS software.

  DIAGNOSTICS

    Diagnostic messages are self-explanatory.

  EXIT VALUES

    The ypset command exits with a value of 0 if successful.  If unsuccessful,
    it exits with a value of 1.

  RELATED INFORMATION

    Commands:  ypwhich(8), ypserv(8)

    Files:  ypfiles(4)



















  2                                              Intergraph Corporation - 2/94