ls_rkill

Signals a remote task

ls_rkill sends the signal sig to the remote task tid and all its children that belong to the same UNIX process group. tid is the remote task ID that is returned by ls_rtask or ls_rtaske. If sig is zero, then this call only polls the existence of the remote task tid.

Any program using this routine must call ls_initrex first.

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>
#include <signal.h>

int ls_rkill(int tid, int sig)

Parameters:

	sig	The signal sent to the tid.
	tid	The remote task ID returned by ls_rtask or ls_rtaske.

Data Structures:

none

Define Statements:

none

Returns:

int:0
Function was successful.

int:-1
Function failed.

Errors:

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

Equivalent line commands:

none

Files:

${LSF_ENVDIR:-/etc}/lsf.conf

See also:

ls_rtask

ls_rtaske