Manual Pages for UNIX Operating System command usage for man yppush

System Administration Commands                         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 omitted, only
                          error messages are printed.





SunOS 5.11          Last change: 26 Aug 1999                    1






System Administration Commands                         yppush(1M)



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 run-
         ning in server mode.


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



     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | service/network/nis         |
    |_____________________________|_____________________________|


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.








SunOS 5.11          Last change: 26 Aug 1999                    2