yppush(8) — CLIX 3.1r7.6.28



  yppush(8)                           CLIX                           yppush(8)



  NAME

    yppush - Forces propagation of a changed Network Information Service (NIS)
    map

  SYNOPSIS

    /etc/yp/yppush [-d domain] [-v] mapname

  FLAGS

    -d domain   Specifies a domain.

    -v          Turns on verbose mode, which causes messages to be displayed
                when each server is called and for each response.  If this
                flag is omitted, only error messages are displayed.

  DESCRIPTION

    The yppush command copies a new version of a Network Information Service
    (NIS) map from the master NIS server to the slave NIS servers.  It is
    normally run only on the master NIS server by the Makefile in /etc/yp/
    after the master databases are changed.  It first constructs a list of NIS
    server hosts by reading the NIS map ypservers within the domain.  Keys
    within the map ypservers are the ASCII names of the machines on which the
    NIS servers run.

    A ``transfer map'' request with the information needed by the transfer
    agent (the program that actually moves the map) is sent to the NIS server
    at each host to call back the yppush.  When the attempt is completed
    (successfully or not) and the transfer agent has sent yppush a status
    message, the results may be displayed to stdout.  Messages are also
    displayed when a transfer is not possible (for instance, when the request
    message is undeliverable or the timeout period on responses has expired).

    Refer to ypfiles(4) and ypserv(8) for an overview of NIS.

  FILES

    /etc/yp/domainname/ypservers.dir
    /etc/yp/domainname/ypservers.pag
           Together, these two files implement the ypservers NIS map on the
           master NIS server.

  NOTES

    Only abbreviated map names less than 10 characters may be used.

  CAUTIONS

    In the current implementation (version 2 NIS protocol), the transfer agent



  2/94 - Intergraph Corporation                                              1



  yppush(8)                           CLIX                           yppush(8)



    is ypxfr(8), which is started by the ypserv program.  If yppush detects
    that it is speaking to a version 1 NIS protocol server, it uses the older
    protocol, sending a version 1 NISPROC_GET request and issues a message to
    that effect.  Unfortunately, there is no way of knowing if or when the map
    transfer is performed for version 1 servers.  The yppush command displays
    a message saying that an ``old-style'' message has been sent.  The system
    administrator should later check to see that the transfer has actually
    taken place.

  EXAMPLES

    To propagate a changed passwd.nam map from a master NIS server to all
    slave NIS servers in the domain dmn, and turn on verbose mode, enter:

    yppush -v -d dmn passwd.nam


  DIAGNOSTICS

    Diagnostic messages are self-explanatory.

  EXIT VALUES

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

  RELATED INFORMATION

    Commands:  ypserv(8), ypxfr(8)

    Files: ypfiles(4), ypmapxlate(4)























  2                                              Intergraph Corporation - 2/94

Museum

Related Articles