ls_stoprex

Stops the Networks I/O Server and restores the local tty environment.

ls_stoprex stops the Network I/O Server (NIOS) and restores the local tty environment. This routine is necessary only for those LSF applications that explicitly catch job control signals (that is, SIGTSTP) and eventually suspend themselves. For most applications, the default SIGTSTP handler in the LSF library provides the desired behavior, without the requirement of calling this routine.

When NIOS receives a SIGTSTP signal, it sends the signal to all its remote tasks. If the local client also needs to be stopped, then ls_stoprex must be called to stop the NIOS and restore the tty environment for the parent application first.

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>

int ls_stoprex(void)

Parameters:

none

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_initrex