Man Linux: Main Page and Category List

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.

       -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 <https://computing.llnl.gov/linux/slurm/>.

       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)