timeout 命令 #

timeout命令用于在指定的时间后终止命令的执行。它对于限制长时间运行的进程、防止进程无限期运行或实现简单的定时任务非常有用。

语法 #

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

常用选项 #

持续时间格式 #

持续时间可以是一个正整数，后跟以下单位之一：

• s：秒（默认）
• m：分钟
• h：小时
• d：天

如果未指定单位，则默认为秒。

常见用法 #

1. 基本用法 #

timeout 10s command

这将运行command，如果10秒后仍在运行，则终止它。

2. 使用不同的时间单位 #

timeout 2m command

这将在2分钟后终止命令。

timeout 1h command

这将在1小时后终止命令。

3. 指定要发送的信号 #

timeout -s KILL 30s command

这将在30秒后发送KILL信号（而不是默认的TERM信号）。

4. 如果进程不响应TERM信号，发送KILL信号 #

timeout -k 5s 30s command

这将在30秒后发送TERM信号，如果进程在额外的5秒后仍在运行，则发送KILL信号。

5. 保留命令的退出状态 #

timeout --preserve-status 10s command

如果命令在超时前完成，timeout将返回命令的退出状态，而不是因超时而返回的状态码。

6. 允许后台命令访问终端 #

timeout --foreground 10s command

这在timeout运行在后台时很有用，可以确保命令仍能访问终端。

退出状态 #

timeout命令的退出状态如下：

• 0：命令在超时前正常退出，退出状态为0
• 124：命令因超时而被终止
• 125：timeout命令本身出错
• 126：找到了指定的命令，但无法执行
• 127：找不到指定的命令
• 其他值：如果命令在超时前退出，且退出状态非零，则返回命令的退出状态（除非使用了--preserve-status选项）

实用示例 #

1. 限制网络请求的时间 #

timeout 5s curl -s http://example.com

这将在5秒后终止curl命令，防止网络请求挂起。

2. 限制脚本执行时间 #

timeout 30m ./long_running_script.sh

这将确保脚本不会运行超过30分钟。

3. 测试服务响应时间 #

timeout 2s nc -z example.com 80 && echo "Service is responding" || echo "Service timed out"

这将测试服务是否在2秒内响应。

4. 在超时后执行清理操作 #

if ! timeout 10s ./task.sh; then
    if [ $? -eq 124 ]; then
        echo "Task timed out, performing cleanup..."
        ./cleanup.sh
    fi
fi

这将在任务超时后执行清理操作。

5. 限制CPU密集型操作 #

timeout 1m find / -name "*.log"

这将限制find命令的执行时间为1分钟。

6. 创建简单的闹钟 #

timeout 8h sleep infinity && echo "Wake up!" | espeak

这将在8小时后发出提醒（需要安装espeak）。

7. 限制数据库查询时间 #

timeout 30s mysql -u user -p database -e "SELECT * FROM large_table"

这将确保数据库查询不会运行超过30秒。

8. 在超时后强制终止进程 #

timeout -k 1s 10s ./potentially_hanging_process

这将在10秒后尝试终止进程，如果进程在额外的1秒后仍在运行，则强制终止它。

9. 限制备份操作时间 #

timeout 4h rsync -av /source /destination

这将确保备份操作不会运行超过4小时。

10. 在脚本中使用timeout #

#!/bin/bash
for cmd in command1 command2 command3; do
    echo "Running $cmd with a 5-minute timeout"
    if timeout 5m $cmd; then
        echo "$cmd completed successfully"
    else
        exit_code=$?
        if [ $exit_code -eq 124 ]; then
            echo "$cmd timed out"
        else
            echo "$cmd failed with exit code $exit_code"
        fi
    fi
done

高级用法 #

1. 结合watch命令 #

watch -n 60 'timeout 50s ./check_status.sh'

这将每60秒运行一次check_status.sh脚本，确保每次执行不超过50秒。

2. 使用不同的信号终止进程 #

timeout -s SIGINT 10s ./program

这将在10秒后发送SIGINT信号（相当于按Ctrl+C）。

3. 创建级联超时 #

timeout 1h timeout 30m timeout 5m command

这将创建多级超时：5分钟、30分钟和1小时。

4. 超时后重试 #

max_attempts=3
attempt=1
while [ $attempt -le $max_attempts ]; do
    echo "Attempt $attempt of $max_attempts"
    if timeout 30s ./task.sh; then
        echo "Task completed successfully"
        break
    elif [ $? -eq 124 ]; then
        echo "Task timed out"
    else
        echo "Task failed"
    fi
    attempt=$((attempt + 1))
    sleep 5
done

这将在任务超时后最多重试3次。

5. 结合xargs进行并行处理 #

find . -name "*.log" | xargs -I{} -P4 timeout 10s gzip {}

这将并行压缩日志文件，每个压缩操作限制为10秒。

与其他命令的比较 #

提示 #

• 使用适当的信号：对于大多数程序，默认的TERM信号足够了，但有些程序可能需要特定的信号才能正常终止
• 对于不响应TERM信号的进程，使用-k选项在一段时间后发送KILL信号
• 检查timeout命令的退出状态可以确定命令是正常完成还是因超时而终止
• 对于需要清理资源的程序，考虑捕获TERM信号并实现适当的清理处理
• 在脚本中使用timeout可以防止因某个命令挂起而导致整个脚本无限期运行
• 对于网络操作，使用timeout可以防止因网络问题导致的长时间等待
• 在测试或调试时，timeout可以帮助快速识别性能问题或死锁
• 对于定期运行的任务，结合cron和timeout可以确保任务不会重叠或超出预期时间窗口
• 使用--preserve-status选项可以更准确地反映命令的实际退出状态
• 在处理大量数据或复杂操作时，设置合理的超时时间可以防止资源耗尽