Knowledge Center Contents Previous Next |
ls_stoprex()
Stops the Networks I/O Server and restores the local tty environment.
DESCRIPTION
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.
SYNOPSIS
#include <lsf/lsf.h> int ls_stoprex(void)RETURN VALUES
integer:0
The function was successful.
integer:-1
Function failed.
ERRORS
If the function fails, lserrno is set to indicate the error.
SEE ALSO
Related APIs
ls_initrex()
Equivalent line command
none
Files
${LSF_ENVDIR-/etc}/lsf.conf
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |