Knowledge Center Contents Previous Next |
ls_getstdin()
Allows an application program to query and specify how stdin is assigned to remote tasks.
DESCRIPTION
ls_getstdin() gives an application program the ability to query and specify how stdin is assigned to remote tasks. It allows you to assign stdin to to all remote tasks. You can change this setting at any time.
ls_getstdin() gets the list of remote task IDs that receive (or do not receive) standard input. If on is non-zero, the task IDs of the remote tasks that are enabled to receive standard input are stored in tidlist. maxlen is the size of the tidlist array. If on is zero, then the IDs of remote tasks whose standard input is disabled are returned. The ID of a task is assigned by the LSLIB when ls_rtask() is called.
Upon success, ls_getstdin() returns the number of entries stored in tidlist. On failure, -1 is returned, and the error code is stored in lserrno. In particular, if there are more than maxlen remote task IDs to be returned, lserrno is set to LSE_RPIDLISTLEN.
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_getstdin(int on, int *tidlist, int *maxlen)PARAMETERS
on
If on is non-zero, the task IDs of the remote tasks that are enabled to receive standard input are stored in tidlist. If on is zero, then the IDs of remote tasks whose standard input is disabled are returned. The ID of a task is assigned by the LSLIB when ls_rtask() is called.
*tidlist
*maxlen
The size of the tidlist array.
RETURN VALUES
integer:# of Entries Stored
The function was successful.
integer:-1
Function failed.
ERRORS
If the function fails, lserrno is set to indicate the error. If there are more than maxlen remote task IDs to be returned, lserrno is set to LSE_RPIDLISTLEN.
SEE ALSO
Related APIs
ls_stdinmodel()
ls_setstdin()
ls_initrex()
Equivalent line command
none
Files
${LSF_ENVDIR-/etc}/lsf.conf
Platform Computing Inc.
www.platform.com |
Knowledge Center Contents Previous Next |