unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



yppush(8)							    yppush(8)



NAME

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

SYNOPSIS

  yppush [-d domain] [-v] mapname

OPTIONS

  -d  Specify a	domain.

  -v  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

  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 nor-
  mally	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 com-
  pleted (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 mes-
  sage is undeliverable, or when the timeout period on responses has expired.

  Refer	to ypfiles(4) and ypserv(8) for	an overview of NIS.

RESTRICTIONS

  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 proto-
  col, 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 adminis-
  trator should	later check to see that	the transfer has actually taken
  place.






ERRORS

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

       Explanation:

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

FILES

  /var/yp/domainname/ypservers.{dir, pag}

SEE ALSO

  Commands: ypserv(8), ypxfr(8)

  Files: ypfiles(4)