> For the complete documentation index, see [llms.txt](https://man.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://man.bsdcn.org/sys/acct.2.md).

# acct(2)

`acct` — 启用或禁用进程记账

## 名称

`acct`

## 库

Lb libc

## 概要

`#include <unistd.h>`

```c
int
acct(const char *file);
```

## 描述

`acct()` 系统调用启用或禁用系统记账记录的收集。如果参数 `file` 是空指针，则禁用记账。如果 `file` 是一个*已存在的*路径名（以空字符结尾），则启用记录收集；对于每个在正常条件下终止的进程，都会向 `file` 追加一条记账记录。异常终止条件包括重启或其他致命系统问题。对于从未终止的进程，`acct()` 无法产生记录。

有关 `acct()` 所用记录结构的更多信息，请参见

`#include <sys/acct.h>`

以及 [acct(5)](/man5/acct.5.md)。

此调用仅允许超级用户使用。

## 注释

当记账文件所在的文件系统空间耗尽时，记账会自动禁用；当空间再次可用时，记账会重新启用。控制此行为的值可以使用以下 [sysctl(8)](/man8/sysctl.8.md) 变量修改：

**`kern.acct_chkfreq`** 指定检查空闲磁盘空间的频率（以秒为单位）。

**`kern.acct_resume`** 空闲磁盘空间百分比高于此值时，进程记账将恢复。

**`kern.acct_suspend`** 空闲磁盘空间百分比低于此值时，进程记账将暂停。

## 返回值

出错时返回 -1。文件必须存在，且该调用仅能由超级用户执行。

## 错误

`acct()` 系统调用在以下任何一种情况为真时会失败：

**\[EPERM]** 调用者不是超级用户。

**\[ENOTDIR]** 路径前缀中的某个组件不是目录。

**\[ENAMETOOLONG]** 路径名的某个组件超过 255 个字符，或整个路径名超过 1023 个字符。

**\[ENOENT]** 指定的文件不存在。

**\[EACCES]** 路径前缀的某个组件拒绝搜索权限，或路径名不是常规文件。

**\[ELOOP]** 在转换路径名时遇到过多的符号链接。

**\[EROFS]** 指定的文件位于只读文件系统上。

**\[EFAULT]** `file` 参数指向进程分配地址空间之外。

**\[EIO]** 在对文件系统进行读写操作时发生 I/O 错误。

**\[EINTEGRITY]** 在从文件系统读取数据时检测到损坏的数据。

## 参见

[acct(5)](/man5/acct.5.md), accton(8), sa(8)

## 历史

`acct()` 函数首次出现于 Version 7 AT\&T UNIX。