SLURM Reference Manual for HP XC System Software
Table Of Contents
- Preface
- Introduction
- SLURM Goals and Roles
- SLURM Features
- SLURM Operation
- SLURM Utilities
- SRUN (Submit Jobs)
- SQUEUE (List Jobs)
- SINFO (List Nodes)
- SMAP (Show Job Geometry)
- SCONTROL (Manage Configurations)
- Disclaimer
- Keyword Index
- Alphabetical List of Keywords
- Date and Revisions
I/O Redirection Alternatives
SRUN I/O options (page 33) -i (--input), -o (--output), and -e (--error) all take as arguments any of
five I/O redirection alternatives ("modes") summarized in this table and explained in more detail below it:
I/O Goes
To or From
Tasks
Covered
File-Naming
Subchoices
Redirection
Alternatives
SRUN (terminal)all tasksall [default]
/dev/null (ignored)all tasksnone
SRUN (terminal)one selected tasktaskid
one specified fileall tasksfilename
many separate files:many separate tasks:fstring
1 file per jobid.stepidall with jobid.stepid%J [uc]
1 file per jobidall with jobid%j [lc]
1 file per stepidall with stepid%s [lc]
1 file per nodeall on hostname%N [uc]
1 file per nodeall on node n%n [lc]
1 file per taskeach separate task%t [lc]
The I/O redirection alternatives compared in the table work in detail as follows:
all redirects STDOUT and STDERR from all job tasks to SRUN (and hence to the
attached terminal), and broadcasts STDIN from SRUN (the terminal) to all remote
tasks (this is SRUN's default behavior for handling I/O).
none redirects STDOUT and STDERR from all job tasks to /dev/null (i.e., SRUN receives
no I/O from any task), and sends no STDIN to any task (closes STDIN).
taskid redirects to SRUN (and hence to the attached terminal) STDOUT and STDERR from
the single specified task whose relative ID is taskid, where the range for integer taskid
starts at 0 (the first task) and runs through the total number of tasks in the current job
step. This choice also redirects STDIN from SRUN (the terminal) to this single
specified task.
filename redirects STDOUT and STDERR from all job tasks into a single file called filename,
and broadcasts STDIN from that same file to all remote tasks. To subdivide the I/O
among separate files, use the fstring alternative below.
fstring ["format string"]
uses a parameterized "format string" to systematically generate unique names for
(usually) multiple I/O files, each of which receives some job I/O depending on the
naming scheme that you choose. You can subdivide the received I/O into separate
files by job ID, step ID, node (name or sequence number), or individual task. In each
case, SRUN opens the appropriate number of files and associates each with the
appropriate subset of tasks.
SLURM Reference Manual - 34