Content-type: text/html Man page of yppush

yppush

Section: Maintenance Commands (8)
Index Return to Main Contents
 

NAME

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

SYNOPSIS

yppush [ -d domain ] [ -v ] mapname  

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

FLAGS

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

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

FILES

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

RELATED INFORMATION

ypfiles(4), ypserv(8), ypxfr(8) delim off


 

Index

NAME
SYNOPSIS
DESCRIPTION
FLAGS
RESTRICTIONS
FILES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:40:39 GMT, October 02, 2010