ls_unlockhost

Unlocks a locked local host.

ls_unlockhost unlocks a host locked by ls_lockhost. On success, ls_unlockhost changes the status of the local host to indicate that it is no longer locked by the user.

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_unlockhost(void)

Parameters:

none

Data Structures:

none

Define Statements:

none

Returns:

int:0
The function was successful.

int:-1
The function failed.

Errors:

If the function fails, lserrno is set to indicate the error. In particular, ls_unlockhost sets lserrno to LSE_LIM_NLOCKED if the host is not locked.

Equivalent line commands:

lsadmin limunlock

Files:

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

See also:

ls_limcontrol

ls_lockhost