sattach
Section: SLURM Commands (1)Updated: SLURM 2.2
Index
NAME
sattach - Attach to a SLURM job step.
SYNOPSIS
sattach [options] <jobid.stepid>
DESCRIPTION
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.
OPTIONS
- -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.
- --layout
- 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.
- --pty
- 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. Not currently supported on AIX platforms.
- -Q, --quiet
- Suppress informational messages from sattach. Errors will still be displayed.
- -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.
INPUT ENVIRONMENT VARIABLES
Upon startup, salloc will read and handle the options set in the following environment variables. Note: Command line options always override environment variables settings.
- SLURM_EXIT_ERROR
-
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.
EXAMPLES
sattach 15.0
sattach --output-filter 5 65386.15
COPYING
Copyright (C) 2006-2007 The Regents of the University of California. Copyright (C) 2008-2009 Lawrence Livermore National Security. Produced at Lawrence Livermore National Laboratory (cf, DISCLAIMER). CODE-OCEC-09-009. All rights reserved.This file is part of SLURM, a resource management program. For details, see <http://www.schedmd.com/slurmdocs/>.
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 version.
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.
SEE ALSO
sinfo(1), salloc(1), sbatch(1), squeue(1), scancel(1), scontrol(1), slurm.conf(5), sched_setaffinity (2), numa (3)
Index
This document was created by man2html using the manual pages.
Time: 16:48:28 GMT, March 28, 2013