> For the complete documentation index, see [llms.txt](https://book.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.bsdcn.org/man/man1/at.1.md). # at.1 `at` — 排队、查看或删除待稍后执行的作业 ## 名称 `at`, `batch`, `atq`, `atrm` ## 概要 `at [-q queue] [-f file] [-mldbv] time at [-q queue] [-f file] [-mldbv] -t [[CC ]YY]] MM DD hh mm [. SS] at -c job [job ...] at -l [job ...] at -l -q queue at -r job [job ...]` `atq [-q queue] [-v]` `atrm job [job ...]` `batch [-q queue] [-f file] [-mv] [time]` ## 描述 `at` 和 `batch` 实用程序从标准输入或指定文件读取命令，以便在稍后时间使用 [sh(1)](/man/man1/sh.1.md) 执行。 **`at`** 在指定时间执行命令； **`atq`** 列出用户的待处理作业，除非用户是超级用户；在那种情况下，列出所有人的作业； **`atrm`** 删除作业； **`batch`** 在系统负载水平允许时执行命令；换言之，当负载平均值降至活动 CPU 数量的 \_LOADAVG\_MX 倍以下，或在调用 `atrun` 时指定的值以下时执行。 `at` 实用程序允许一些中等复杂的 `time` 规范。它接受 `HHMM` 或 `HH:MM` 形式的时间，以在一天中的特定时刻运行作业。（如果该时间已过，则假定为第二天。）或者，可以指定以下关键字：`midnight`、`noon` 或 `teatime`（4pm），时间后可加 `AM` 或 `PM` 后缀以在上午或下午运行。运行作业的日期也可通过以 `month-name day` 形式给出日期（可选 `year`）来指定，或使用 `DD.MM.YYYY`、`DD.MM.YY`、`MM/DD/YYYY`、`MM/DD/YY`、`MMDDYYYY` 或 `MMDDYY` 形式的日期。日期的指定必须跟在时间指定之后。时间也可指定为：\[`now`] `+` `count time-units`，其中 time-units 可以是 `minutes`、`hours`、`days`、`weeks`、`months` 或 `years`，并且可以通过在时间后加 `today` 后缀告诉 `at` 今天运行作业，通过加 `tomorrow` 后缀告诉 `at` 明天运行作业。 `at` 实用程序还支持 POSIX 时间格式（参见 `-t` 选项）。 对于 `at` 和 `batch`，命令从标准输入或通过 `-f` 选项指定的文件中读取并执行。工作目录、环境（除 `TERM`、`TERMCAP`、`DISPLAY` 和 `_` 变量外）以及 `umask` 从调用时保留。从 [su(1)](/man/man1/su.1.md) shell 调用的 `batch` 或 `batch` 命令将保留当前用户 ID。如果命令产生了标准错误和标准输出，将通过邮件发送给用户。邮件使用 sendmail(8) 命令发送。如果 `batch` 从 [su(1)](/man/man1/su.1.md) shell 执行，登录 shell 的所有者将收到邮件。 超级用户在任何情况下都可以使用这些命令。对于其他用户，使用 `batch` 的权限由文件 **`_PERM_PATH/at.allow`** 和 **`_PERM_PATH/at.deny`** 决定。 如果文件 **`_PERM_PATH/at.allow`** 存在，则只有其中提及的用户名被允许使用 `batch`。在这两个文件中，只有当用户名在其所在行之前没有空格或其他字符、且名称后紧跟换行符（即使在文件末尾）时，才认为该用户已被列出。其他行被忽略，可用作注释。 如果 **`_PERM_PATH/at.allow`** 不存在，则检查 **`_PERM_PATH/at.deny`**，其中未提及的每个用户名都被允许使用 `batch`。 如果两者都不存在，则只有超级用户被允许使用 `batch`。这是默认配置。 ## 实现说明 注意，`batch` 通过 cron(8) 守护进程实现，每五分钟调用一次 atrun(8)。这意味着 `batch` 的粒度可能不适用于所有部署场景。如果需要更细的粒度，可以编辑 **`/etc/cron.d/at`** 文件，该文件会被系统 crontab 读取，并从中继承 `SHELL` 和 `PATH` 环境变量。 ## 选项 **`CC`** 年份的前两位数字（世纪）。 **`YY`** 年份的后两位数字。 **`MM`** 一年中的月份，从 1 到 12。 **`DD`** 一月中的日期，从 1 到 31。 **`hh`** 一天中的小时，从 0 到 23。 **`mm`** 一小时中的分钟，从 0 到 59。 **`SS`** 一分钟中的秒数，从 0 到 60。 **`-q`** `queue` 使用指定的队列。队列标识由单个字母组成；有效的队列标识范围为 `a` 到 `z` 和 `A` 到 `Z`。`_DEFAULT_AT_QUEUE` 队列是 `batch` 的默认队列，`_DEFAULT_BATCH_QUEUE` 队列是 `batch` 的默认队列。字母越靠后的队列以更高的 nice 值运行。如果作业被提交到以大写字母标识的队列，则被视为在当时提交到了 batch。如果给 `atq` 指定了特定队列，则仅显示该队列中待处理的作业。 **`-m`** 即使没有输出，也在作业完成时向用户发送邮件。 **`-f`** `file` 从 `file` 而非标准输入读取作业。 **`-l`** 不带参数时，列出调用用户的所有作业。如果给定一个或多个作业号，则仅列出那些作业。 **`-d`** 是 `atrm` 的别名（此选项已弃用；请改用 `-r`）。 **`-b`** 是 `batch` 的别名。 **`-v`** 对于 `atq`，显示队列中已完成但尚未删除的作业；否则显示作业将要执行的时间。 **`-c`** 将命令行上列出的作业输出到标准输出。 **`-r`** 删除指定的作业。 **`-t`** 使用时间格式指定作业时间。参数应为 \[\[`CC` ]`YY`]] `MM DD hh mm` \[. `SS`] 形式，其中每对字母代表以下含义：如果未指定 `CC` 和 `YY` 字母对，则值默认为当前年份。如果未指定 `SS` 字母对，则值默认为 0。 ## 文件 **`_ATJOB_DIR`** 包含作业文件的目录 **`_ATSPOOL_DIR`** 包含输出假脱机文件的目录 **`/var/run/utx.active`** 登录记录 **`_PERM_PATH/at.allow`** 允许权限控制 **`_PERM_PATH/at.deny`** 拒绝权限控制 **`_ATJOB_DIR/_LOCKFILE`** 作业创建锁文件 ## 实例 要在三天后的下午 4 点运行作业，使用： ```sh at 4pm + 3 days ``` 要在 7 月 31 日上午 10:00 运行作业，使用： ```sh at 10am Jul 31 ``` 要在明天凌晨 1 点运行作业，使用： ```sh at 1am tomorrow ``` ## 参见 [nice(1)](/man/man1/nice.1.md), [sh(1)](/man/man1/sh.1.md), umask(2), atrun(8), cron(8), sendmail(8) ## 作者 at 主要由 Thomas Koenig 编写。时间解析例程由 David Parsons 编写，Joe Halpin 做了少量增强。 ## 缺陷 如果文件 **`/var/run/utx.active`** 不可用或已损坏，或者在调用 `atq` 时用户未登录，则邮件将发送到环境变量 `LOGNAME` 中找到的用户 ID。如果该变量未定义或为空，则假定为当前用户 ID。 当前实现的 `at` 和 `batch` 实用程序在用户竞争资源时并不适用。如果是这种情况，其他批处理系统（如 *nqs*）可能更合适。 指定 2038 年之后的日期在某些系统上可能无法工作。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://book.bsdcn.org/man/man1/at.1.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.