sattach - Attach to a Slurm job step.
sattach [ options
sattach attaches to a running Slurm job step. By attaching, it makes available
the IO streams of all of the tasks of a running Slurm job step. It also
suitable for use with a parallel debugger like TotalView.
- -h, --help
- Display help information and exit.
- --input-filter[=]<task number>
- --output-filter[=]<task number>
- --error-filter[=]<task number>
- Only transmit standard input to a single task, or print the standard
output or standard error from a single task. The filtering is performed
locally in sattach.
- -l, --label
- Prepend each line of task standard output or standard error with the task
number of its origin.
- Contacts the slurmctld to obtain the task layout information for the job
step, prints the task layout information, and then exits without attaching
to the job step.
- Execute task zero in pseudo terminal. Not compatible with the
--input-filter, --output-filter, or --error-filter
options. Notes: The terminal size and resize events are ignored by
sattach. Proper operation requires that the job step be initiated by srun
using the --pty option.
- -Q, --quiet
- Suppress informational messages from sattach. Errors will still be
- -u, --usage
- Display brief usage message and exit.
- -V, --version
- Display Slurm version number and exit.
- -v, --verbose
- Increase the verbosity of sattach's informational messages. Multiple
-v's will further increase sattach's verbosity.
Upon startup, salloc will read and handle the options set in the following
environment variables. Note: Command line options always override environment
- The location of the Slurm configuration file.
- Specifies the exit code generated when a Slurm error occurs (e.g. invalid
options). This can be used by a script to distinguish application exit
codes from various Slurm error conditions.
sattach --output-filter 5 65386.15
Copyright (C) 2006-2007 The Regents of the University of California. Produced at
Lawrence Livermore National Laboratory (cf, DISCLAIMER).
Copyright (C) 2008-2009 Lawrence Livermore National Security.
Copyright (C) 2010-2013 SchedMD LLC.
This file is part of Slurm, a resource management program. For details, see
Slurm is free software; you can redistribute it and/or modify it under the terms
of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
Slurm is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR
A PARTICULAR PURPOSE. See the GNU General Public License for more details.