lsltasks

Displays or updates a local task list.

Synopsis

lsltasks [+ task_name ... | task_name ...]
lsltasks [-h | -V]

Description

Displays or updates a user local task list in the $HOME/.lsftask file.

When no options are specified, displays tasks that are listed in the system task file lsf.task and the user task file .lsftask.

If the system task file lsf.task conflicts with the user task file .lsftask, the user task file overrides the system task file.

Tasks in the local task list are not eligible for remote execution, either because they are trivial tasks or because they need resources on the local host.

Options

+ task_name
If a plus sign (+) is specified and the specified task names are not already in the user task file (.lsftask), adds the task names to the file with a plus sign (+) preceding them.

If any of the task names are already in the .lsftask file, the actual action depends on the entry in the file. If the entry starts with a + or nothing, replaces the entry with the specified content; if the entry starts with a minus sign (-), deletes the entry from the .lsftask file.

- task_name
If a minus sign () is specified and specified task names are not already in the user .lsftask file, adds the task names to the file with a preceding the task name.

If any of the task names are already in the .lsftask file, the actual action depends on the entry in the file. If the entry starts with a , no operation is done; if the entry starts with a +, deletes the entry from the .lsftask file.

-h
Prints command usage to stderr and exits.
-V

Prints LSF release version to stderr and exits.

Examples

lsltasks + foo

Adds the command foo to the local task list.

Files

Reads the system task file lsf.task, and the user .lsftask file.

The system and user task files contain two sections, one for the remote task list, the other for the local task list. The local tasks section starts with Begin LocalTasks and ends with End LocalTasks. Each line in the section is a task name.

A plus sign (+) or a minus sign () can optionally precede each entry. If no + or is specified, then + is assumed.

See also

lseligible, lsrtasks, lsf.task, ls_eligible, ls_task