chslave Command

Purpose

Re-executes the ypinit command to retrieve maps from a master server and re-starts the ypserv daemon to change the slave server.

Syntax

/usr/etc/yp/chslave [ -C | -c] [ -O | -o ] [ -I | -B | -N ] Master

Description

The chslave command re-invokes the ypinit command to retrieve maps from the master server you specify on the command line. The ypserv daemon is re-started after the ypinit command has completed successfully. The Master parameter specifies the host name of the master server. The master server specified can be the master server currently in use or a new master server that is configured and running.

You could also use the System Management Interface Tool (SMIT) smit chslave fast path to run this command.

Flags

Item Description
-B Invokes the ypinit command and starts the ypserv daemon. If the ypserv daemon is already running, this flag will cause the ypinit command to kill the daemon and then restart it. This flag is the default.
-C Invokes the ypinit command with the -n flag. The chslave command continues on errors. This flag is the default.
-c Stops execution when errors occur.
-I Executes the ypinit command immediately but does not start or restart the ypserv daemon.
-O Overwrites any maps that exist in the domain.
-o Prevents the overwrite of maps that exist in the domain. This flag is the default.
-N Invokes the ypinit command and restarts the ypserv daemon.

Examples

To retrieve maps from the master server named host91, enter:

chslave -O -B host91

This will overwrite any existing maps for the current domain.

Files

Item Description
/etc/rc.nfs Contains the startup script for NFS and NIS daemons.
/var/yp/domainname Contains the NIS maps for the NIS domain.