ls_setstdin

Allows an application program to query and specify how stdin is assigned to a specific subset of remote tasks.

ls_setstdin gives an application program the ability to query and specify how stdin is assigned to remote tasks. It allows you to assign stdin to a specific subset of remote tasks. You can change this setting at any time.

ls_setstdin turns on or off the delivery of standard input to specific remote tasks. Other remote tasks are not affected by this call.

By default, a remote task is set to receive standard input. Note that remote tasks only receive standard input if the current stdin mode is remote. Hence, if the application is running in local stdin mode (see the description of ls_stdinmode), ls_setstdin is not effective.

Upon success, ls_setstdin returns zero. On failure, -1 is returned, and the error code is stored in lserrno.

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_setstdin(int on, int *tidlist, int len)

Parameters:

	on	If on is non-zero and the current stdin mode is remote, then the tasks given by tidlist receive the standard input. If on is zero, the tasks will not receive standard input.
	*tidlist	tidlist gives the list of task IDs of the remote tasks to be operated upon.
	len	The number of entries.

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_stdinmode

ls_getstdin

ls_initrex