nisping(1M)
NAME
nisping − send ping to NIS+ servers
SYNOPSIS
/usr/lib/nis/nisping [ −uf ] [ −H hostname ] [ directory ]
/usr/lib/nis/nisping −C [ −H hostname ] [ directory ]
DESCRIPTION
The nisping command sends a “ping” to all replicas of a NIS+ directory. Once a replica receives a ping, it will check with the master server for the directory to get updates. Prior to pinging the replicas, this command attempts to determine the last update "seen" by a replica and the last update logged by the master. If these two timestamps are the same, the ping is not sent. The −f (force) option will override this feature.
OPTIONS
−u Specify that only the time of the last update is to be read; no servers are sent a ping.
−f Force a ping, even though the timestamps indicate there is no reason to do so. This option is useful for debugging.
−C Send a request to checkpoint, rather than a ping, to each server. The servers schedule to commit all the transactions to stable storage.
−H hostname Only the host hostname is sent the ping, checked for an update time, or checkpointed.
RETURN VALUES
−1 No servers were contacted, or the server specified by the −H switch could not be contacted.
0 Success.
1 Some, but not all, servers were successfully contacted.
EXAMPLES
This example pings all replicas of the default domain:
example% nisping
Note: This example will not ping the the org_dir and group_dir subdirectories within this domain.
This example pings the server example which is a replica of the org_dir.foo.com. directory:
example% nisping −H example org_dir.foo.com.
This example checkpoints all servers of the org_dir.bar.com. directory.
example% nisping −C org_dir.bar.com.
ENVIRONMENT
NIS_PATH If this variable is set, and the NIS+ directory name is not fully qualified, each directory specified will be searched until the directory is found.
NOTES
If the server specified by the −H option does not serve the directory then no ping is sent.
SEE ALSO
SunOS 5.1/SPARC — Last change: 26 Sep 1992