ls_listltask

Returns the contents of the user's local task list.

LSLIB library routine for manipulating task lists stored by LSLIB. Task lists contain information about the eligibility of tasks for remote execution and their resource requirement characteristics. LSLIB maintains two task lists: local and remote. The local list contains tasks (i.e. UNIX processes) that must be executed on the local host (for example, ps, uptime, hostname). The remote list contains tasks that are suitable for remote execution (for example, compress), together with their resource requirements.

Task lists are generated and stored in memory by reading the system task file() and the .lsftask file in the user's home directory. The task lists can be updated and displayed using the command lsltasks(). See the LSF User's Guide for detailed information on the use of task lists and resource requirements.

ls_listltask returns the contents of a user's local task list in tasklist. Memory for tasklist is allocated as needed and freed by the next call to ls_listltask. If sortflag is non-zero, then the returned task list is sorted alphabetically. Each of the returned tasks is a char string consisting of a task name optionally followed by `/' and the associated resource requirement string. ls_listltask return the number of items in the tasklist on success, -1 on error.

#include <lsf/lsf.h>
int ls_listltask(char ***taskList, int sortflag)

Parameters: