yppush(1M)                                             yppush(1M)



NAME
     yppush -  propagates  changed  Network  Information  Service
     (NIS) maps

SYNOPSIS
     yppush [-d domain-name] [-v] mapname

ARGUMENTS
     -d domain-name
          Specifies the name of a domain.

     mapname
          Specifies the name of the NIS map.

     -v   Specifies verbose mode, which causes a message to be
          displayed when each server is called and when each
          server responds.  If you do not use this option, yppush
          only displays error messages.

DESCRIPTION
     yppush notifies slave servers when a new version of an NIS
     map is available on the NIS master server. You usually make
     new versions of NIS maps by running make in the directory
     /etc/yp.  By default, the Makefile in that directory runs
     yppush after the master databases are updated.

     The yppush command first constructs a list of NIS slave
     servers by reading the NIS map ypsrvs in the directory
     /etc/yp/domain-name, where domain-name is the value returned
     by domainname or is the domain name specified by the -d
     option.  The keys in the ypsrvs map are the ASCII names of
     the slave servers in the domain.

     The yppush command then sends a ``transfer map'' request to
     the ypserv daemon on each slave server, along with the
     information needed to transfer the maps.  The ypserv daemon
     runs ypxfr to call back yppush and make the transfer. If the
     request message is undeliverable, or if the timeout period
     on responses expires, yppush displays an error message.

LIMITATIONS
     In the current implementation (version 2 NIS protocol),
     ypxfr transfers maps. If yppush determines that it is
     working with an earlier implementation (version 1 NIS
     protocol) server, it uses the older protocol, sending a
     version 1 YPPROC_GET request, and displays a message that an
     ``old-style'' message has been sent.  When working with a
     version 1 server, there is no way of knowing if or when the
     map transfer is performed.  You should check later that the
     transfer has actually taken place.





January 1992                                                    1

yppush(1M)                                             yppush(1M)



FILES
     /etc/yp/domainname/ypsrvs.dir
          File containing a portion of the slave server map
     /etc/yp/domainname/ypsrvs.pag
          File containing a portion of the slave server map
     /etc/yp/yppush
          Executable file

SEE ALSO
     ypserv(1M), ypxfr(1M)

     domainname(1) in A/UX Command Reference

     ypfiles(4) in A/UX Programmer's Reference

     Chapter 4, ``Setting Up the Network Information Service,''
     in A/UX Network System Administration






































2                                                    January 1992