【日常记录-Linux】timeout指令

Author：赵志乾
Date：2024-08-30
Declaration：All Right Reserved！！！

1. 简介

        在Linux系统中，timeout是一个常用的命令行工具，用于在指定时间后终止一个命令的执行。该命令通常包含在GNU coreutils包中，故大多数Linux发行版都默认安装了它。

2. 基本语法

timeout [选项] 持续时间 [命令 [参数]...]

• 持续时间：指定命令运行的最大时间，默认为秒，也可以指定其他单位，分钟(m)、小时(h)、天(d)，例如，5表示5秒，1m表示1分钟；
• 命令：要执行的命令及其参数；

        若命令在指定的时间内完成，则timeout会以0状态码退出，表示成功。若命令超时，timeout会发送一个TERM信号（默认情况下）给命令，尝试终止它，并以124状态码退出，表示命令因超时而被杀死。

3. 示例

  3.1 让命令在5秒后超时

timeout 5s sleep 10

        该命令会尝试执行sleep 10，但由于sleep 10会持续10秒，所以timeout 5s 会在5秒后终止它。

  3.2 发送不同的信号

        默认情况下，timeout发送TERM信号(即SIGTERM，信号15)给超时的命令，但可以使用-s选项来指定发送其他信号，比如KILL信号（SIGKILL，信号9）；

timeout -s KILL 5s your-command

        这将在5秒后发送KILL信号给your-command，强制终止它，而不给它清理或保存状态的机会。