NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       yppush [-d domain] [-v] mapname

OPTIONS    [Toc]    [Back]

       Specify a domain.  Verbose. This  causes  messages  to  be
       printed when each server is called, and for each response.
       Without this option, only error messages are printed.

DESCRIPTION    [Toc]    [Back]

       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  make  utility  accessing the
       /var/yp/Makefile after the master NIS databases have  been
       changed.  When  invoked, yppush 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 is sent to the NIS 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  command. When the attempt has completed
       (successfully or not), and the  transfer  agent  has  sent
       yppush  a  status  message,  the results can 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(8) for an overview of NIS.

RESTRICTIONS    [Toc]    [Back]

       In the current implementation (version  2  NIS  protocol),
       the  transfer  agent  is  ypxfr,  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 YPPROC_GET request and  issues  a
       message  to that effect. Unfortunately, there is no way of
       knowing if or when the map transfer was performed for version
 1 servers. The yppush command prints 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.

ERRORS    [Toc]    [Back]

       Map xxx no such map in server's domain -- using ypservers

              Explanation:

              This is an  informational  message  that  indicates
              that  the  yppush command will push the maps to all
              servers listed in the ypservers map.

FILES    [Toc]    [Back]

SEE ALSO
       Commands: ypserv(8), ypxfr(8)

       Files: ypfiles(4)



                                                        yppush(8)