ls_getstdin

Allows an application program to query and specify how stdin is assigned to remote tasks.

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.

#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	tidlist gives the list of task IDs of the remote tasks to be operated upon.
	maxlen	The size of the tidlist array.

Data Structures:

none

Define Statements:

none

Returns:

int:Number of Entries Stored.
The function was successful.

int:-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.

Equivalent line commands:

none

Files:

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

See also:

ls_stdinmode

ls_setstdin

ls_initrex