yppush(1M)                                                       yppush(1M)


   NAME
         yppush - force propagation of a changed YP map

   SYNOPSIS
         /usr/sbin/yppush [ -v ] [ -d ypdomain ] mapname

   DESCRIPTION
         yppush copies a new version of a YP name service map from the master
         YP server to the slave YP servers.  It is normally run only on the
         master YP server by the Makefile in /var/yp after the master
         databases are changed.  It first constructs a list of YP server hosts
         by reading the YP map ypservers within the ypdomain, or if the map is
         not set up, the local file is used.  Keys within the map ypservers
         are the ASCII names of the machines on which the YP servers run.

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

         Refer to ypfiles(4) and ypserv(1M) for an overview of the YP name
         service.

         The following optionas are available:

         -v    Verbose.  Print messages when each server is called, and for
               each response.  If this flag is omitted, only error messages
               are printed.

         -d ypdomain
               Specify a ypdomain other than the default domain.

   FILES
         /var/yp/ypdomain/ypservers.{dir,pag}
         /var/yp

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











   7/91                                                                 Page 1