Knowledge Center         Contents    Previous  Next    
Platform Computing Corp.

ls_setstdin()

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

DESCRIPTION

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.

SYNOPSIS

#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.

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_stdinmodel()

ls_getstdin()

ls_initrex()

Equivalent line command

none

Files

${LSF_ENVDIR-/etc}/lsf.conf


Platform Computing Inc.
www.platform.com
Knowledge Center         Contents    Previous  Next