sattach

Section: Slurm 命令 (1)
更新: Slurm 命令
索引

名称

sattach - 附加到 Slurm 作业步骤。

sattach [选项] <jobid.stepid>

sattach 附加到正在运行的 Slurm 作业步骤。通过附加，它使所有正在运行的 Slurm 作业步骤的任务的 IO 流可用。它也适合与像 TotalView 这样的并行调试器一起使用。它不能直接附加到 extern 或批处理步骤，因为这些步骤的 IO 通道没有设置或直接转发到文件。

--error-filter[=]<任务编号>: 仅将标准输入传输到单个任务，或打印单个任务的标准输出或标准错误。过滤是在 sattach 中本地执行的。

-h, --help: 显示帮助信息并退出。

--input-filter[=]<任务编号>: 仅将标准输入传输到单个任务，或打印单个任务的标准输出或标准错误。过滤是在 sattach 中本地执行的。

-l, --label: 在任务标准输出或标准错误的每一行前面添加其来源的任务编号。

--layout: 联系 slurmctld 以获取作业步骤的任务布局信息，打印任务布局信息，然后在不附加到作业步骤的情况下退出。

--output-filter[=]<任务编号>: 仅将标准输入传输到单个任务，或打印单个任务的标准输出或标准错误。过滤是在 sattach 中本地执行的。

--pty: 在伪终端中执行任务零。与 --input-filter、--output-filter 或 --error-filter 选项不兼容。注意：终端大小和调整大小事件被 sattach 忽略。正常操作需要作业步骤由 srun 使用 --pty 选项启动。

-Q, --quiet: 抑制来自 sattach 的信息消息。错误仍将显示。

-u, --usage: 显示简要用法信息并退出。

-V, --version: 显示 Slurm 版本号并退出。

-v, --verbose: 增加 sattach 信息消息的详细程度。多个 -v 将进一步增加 sattach 的详细程度。

执行 sattach 会向 slurmctld 发送远程过程调用。如果来自 sattach 或其他向 slurmctld 守护进程发送远程过程调用的 Slurm 客户端命令的调用过多，可能会导致 slurmctld 守护进程的性能下降，可能导致服务拒绝。

请勿在 shell 脚本或其他程序的循环中运行 sattach 或其他向 slurmctld 发送远程过程调用的 Slurm 客户端命令。确保程序将对 sattach 的调用限制在收集信息所需的最小值。

启动时，salloc 将读取并处理以下环境变量中设置的选项。注意：命令行选项始终优先于环境变量设置。

SLURM_CONF: Slurm 配置文件的位置。

SLURM_DEBUG_FLAGS: 指定 sattach 使用的调试标志。有关完整的标志列表，请参见 slurm.conf(5) 手册页。环境变量优先于 slurm.conf 中的设置。

SLURM_EXIT_ERROR: 指定发生 Slurm 错误时生成的退出代码（例如，无效选项）。这可以被脚本用于区分应用程序退出代码与各种 Slurm 错误条件。

附加到作业 15，步骤 0:

$ sattach 15.0

将输出限制为作业 65386，步骤 15 的第 5 个任务:

$ sattach --output-filter 5 65386.15

此文件是 Slurm 的一部分，Slurm 是一个资源管理程序。有关详细信息，请参见 <https://slurm.schedmd.com/>。

Slurm 是自由软件；您可以根据自由软件基金会发布的 GNU 通用公共许可证的条款重新分发和/或修改它；许可证的第 2 版或（根据您的选择）任何更高版本。

Slurm 的分发是希望它会有用，但不提供任何担保；甚至不包括对适销性或特定用途适用性的隐含担保。有关更多详细信息，请参见 GNU 通用公共许可证。

sinfo(1), salloc(1), sbatch(1), squeue(1), scancel(1), scontrol(1), slurm.conf(5), sched_setaffinity (2), numa (3)

此文档由 man2html 使用手册页创建。
时间: 2025年7月2日 13:21:55 GMT