Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

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