yppush(1M)                                                       yppush(1M)

NAME
     yppush - copy a NIS file to the slave servers

SYNOPSIS
     /usr/sbin/yppush [-v] [-d domain] mname

DESCRIPTION
     The network administrator uses this command to instruct the slaves to
     copy the NIS files from the master.

     This becomes necessary if a NIS file on the master is modified. By
     copying the file to the slaves, the network administrator can ensure
     that the data in the NIS files on the slaves is always up-to-date.

     If the modifications are made in the menu system or with the standard
     makefile in the directory /var/yp, the yppush command is executed
     automatically.

     The yppush command needs the NIS file ypservers so that it can deter-
     mine which hosts are the slaves.

     First, the command generates a list of all the slaves in the domain.
     ypserv then starts a ypxfr, which fetches the NIS files, for each of
     these slaves. ypxfr uses the NIS master entered in its current NIS
     files. This mechanism prevents slaves from receiving NIS files from a
     self-appointed master server.

     When the transfer attempt has been completed, a status message is sent
     to the yppush command. yppush outputs the contents of the message,
     i.e. whether the transfer was successful or unsuccessful, to standard
     output.

     Files are only copied if the version number of the NIS file on the
     master is larger than the version number on the slave.

OPTIONS
     -v   causes a message to be output to standard output when each slave
          is called, and for each response.

          If this argument is omitted, only error messages are output.

     -d domain
          is specified if the modified NIS file is to be copied to the
          slaves of a domain other than the current domain. domain is the
          name of this other domain.

          The default value is the name output when the domainname(1) com-
          mand is issued.

     mname
          is the name of the NIS file that is to be copied.




Page 1                       Reliant UNIX 5.44                Printed 11/98

yppush(1M)                                                       yppush(1M)

     You will find an overview of the standard NIS files under the descrip-
     tion of the ypcat(1) command.

EXAMPLES
     The NIS file passwd.byname is to be copied to the slaves and the
     transfer logged:

     Input:

     yppush -v passwd.byname

     Output:

     Finding YP servers: mountainview detroit athens
     athens has been called.
     detroit has been called.
     Status received from ypxfr on detroit:
     Transfer not done: master's version isn't newer.

     The yppush command found three slaves.

     On the host athens the NIS file passwd.byname is transmitted.

     The NIS file was not copied to the host detroit because the version
     was not more recent.

     The NIS file was not copied to the host mountainview because it is the
     master and should always have the latest version of a NIS file.

     The NIS file passwd.byname has been modified and is to be copied to
     the slaves.

     Input:

     yppush -v passwd.byname

     Output:

     Finding YP servers: mountainview boston
     boston has been called.

     This time the NIS file passwd.byname was copied to the host boston
     because the version on the master was more recent.

     We recommend that you transfer NIS files from the master to the slaves
     using the menu system.

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

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


Page 2                       Reliant UNIX 5.44                Printed 11/98

yppush(1M)                                                       yppush(1M)

     ypservers(4).





















































Page 3                       Reliant UNIX 5.44                Printed 11/98