TIMEOUT
Section: 用户命令 (1)
Updated: 2022年9月
查看本页索引
返回目录
名称
timeout - 在规定时限内运行一个命令
概述
timeout [
,选项列表/]
,持续时间 命令 /[
,参数列表/]...
timeout [
,选项列表/]
描述
运行所给命令,如果它超过指定时间后仍在运行,则杀死其进程。
必选参数对长短选项同时适用。
-
--preserve-status
-
将退出状态值设为与所运行指令的退出状态相同的值,即使
-
指令运行超时
-
--foreground
-
当不是直接在 shell 命令提示符下运行 timeout 的情况下使用,
-
允许所运行命令直接由 TTY 读取数据,并且接收 TTY 的信号;在这种模式下,所运行命令的子进程将不会被 timeout 的超时控制所考虑
-
-k, --kill-after=,持续时间/
-
如果初始信号已发出且再次等待了指定时间之后
-
所运行命令仍在运行则发出 KILL 信号
-
-s, --signal=,信号/
-
指定超时发生时应当送出的信号;
-
信号可以是类似“HUP”的信号名或是信号数;从“kill -l”的输出可获得信号的列表
- -v, --verbose
-
对任何超时后发送的信号,向标准错误输出诊断信息
- --help
-
显示此帮助信息并退出
- --version
-
显示版本信息并退出
持续时间应当是一个浮点数,后缀是可选的:“s”表示秒(默认值),“m”表示分钟,“h”表示小时,或者使用“d”表示天数。若持续时间为
0,将禁用所关联的超时配置。
超时以后,如果没有指定其他“信号”,则向给定“命令”发送 TERM 信号。TERM 信号将杀死没有阻塞或捕获该信号的进程。有时可能需要使用 KILL
信号,因为此信号无法被捕获。
退出状态:
- 124
-
如果指定“命令”超时,且未指定 --preserve-status 选项
- 125
-
如果 timeout 命令本身执行失败
- 126
-
如果找到了命令,但无法执行
- 127
-
如果未找到命令
- 137
-
如果命令(或 timeout 命令本身)收到了 KILL (9) 信号(即 128+9)
- -
-
其他情况下,退出状态是命令的退出状态
缺陷
某些平台目前不支持将超时时间设置为超过 2038 年。
作者
由 Padraig Brady 编写。
报告错误
GNU coreutils 的在线帮助: <https://www.gnu.org/software/coreutils/>
请向 <https://translationproject.org/team/zh_CN.html> 报告翻译错误。
版权
Copyright © 2022 Free Software Foundation, Inc. License GPLv3+: GNU GPL
version 3 or later <https://gnu.org/licenses/gpl.html>.
This is free software: you are free to change and redistribute it. There is
NO WARRANTY, to the extent permitted by law.
参见
kill(1)
完整文档请见: <https://www.gnu.org/software/coreutils/timeout>
或者在本地使用: info '(coreutils) timeout invocation'
本页面中文版由中文 man 手册页计划提供。
中文 man 手册页计划:https://github.com/man-pages-zh/manpages-zh
Index
- 名称
-
- 概述
-
- 描述
-
- 退出状态:
-
- 缺陷
-
- 作者
-
- 报告错误
-
- 版权
-
- 参见
-
-
This document was created by
man2html,
using the manual pages.
Time: 03:15:28 GMT, July 01, 2024