yppush(1M)




NAME

     yppush - force propagation of changed NIS map


SYNOPSIS

     /usr/lib/netsvc/yp/yppush  [-v]  [-h host]  [-d domain]   [-
     p #parallel-xfrs] mapname


DESCRIPTION

     yppush copies a new version of a  Network  Information  Ser-
     vice  (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  /var/yp  after  the  master databases are
     changed. It first constructs a list of NIS server  hosts  by
     reading the NIS ypservers map within the domain. Keys within
     the ypservers map 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 that 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  mes-
     sage,  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(1M) for an  overview  of  the
     NIS service.


OPTIONS

     The following options are supported:

     -d domain
           Specifies a domain.

     -h host
           Propagates only to the named host.

     -p #parallel-xfrs
           Allows the specified number of map transfers to  occur
           in parallel.

     -v    Verbose.  This prints messages  when  each  server  is
           called,  and  for each response. If this flag is omit-
           ted, only error messages are printed.


FILES

     /var/yp
           Directory where NIS configuration files reside.

     /var/yp/domain/ypservers.{dir, pag}
           Map containing list of  NIS servers to  bind  to  when
           running in server mode.


ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    | ATTRIBUTE TYPE              | ATTRIBUTE VALUE             |
    |_____________________________|_____________________________|
    | Availability                | SUNWypu                     |
    |_____________________________|_____________________________|


SEE ALSO

     ypserv(1M), ypxfr(1M), ypfiles(4), attributes(5)


NOTES

     The Network Information Service (NIS) was formerly known  as
     Sun  Yellow Pages (YP). The functionality of the two remains
     the same; only the name has changed. The name  Yellow  Pages
     is  a  registered trademark in the United Kingdom of British
     Telecommunications PLC, and must not be used without permis-
     sion.


BUGS

     In the current implementation (version 2 NIS protocol),  the
     transfer  agent is ypxfr(1M), 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 is performed for version 1 servers.  yppush
     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.


Man(1) output converted with man2html