ls_limcontrol

Shuts down or reboots a host's LIM.

To remove a host from a cluster, use ls_limcontrol to shut down the host's LIM. Next, to return a removed host to a cluster, use ls_limcontrol to reboot its LIM. When you reboot the LIM, the configuration files are read again and the previous LIM status of the host is lost.

The use of ls_limcontrol is restricted to root and the LSF administrator as defined in the file LSF_CONFDIR/lsf.cluster.cluster_name.

Any program using this API must be setuid to root if LSF_AUTH is not defined in the lsf.conf file.

#include <lsf/lsf.h>
int ls_limcontrol(char *hname, int opCode)

Parameters:

	*hname	Specifies the host
	opCode	defs_ls_limcontrol Specifies the shutdown or reboot LIM command.

Data Structures:

none

Define Statements:

defs_ls_limcontrol

Returns:

int:0
The function was successful.

int:-1
The function failed.

Errors:

If the function fails, lserrno is set to indicate the error.

Equivalent line commands:

lsadmin limstartup
lsadmin limshutdown
lsadmin limrestart

Files:

${LSF_ENVDIR:-/etc}/lsf.conf
$LSF_CONFDIR/lsf.shared
$LSF_CONFDIR/lsf.cluster.cluster_name

See also:

ls_lockhost

ls_unlockhost