NAME[名 称 ]
utmp, wtmp - 登 录 记 录 （ login records）
SYNOPSIS[总 览 ]
#include
DESCRIPTION[描 述 ]
utmp 文 件 用 于 记 录 当 前 系 统 用 户 是 哪 些 人 。 但 是 实 际 的 人 数 可 能 比 这 个 数 目 要 多 ， 因 为 并 非 所 有 用 户 都 用 utmp 登 录 。 警 告 : utmp 必 须 置 为 不 可 写 ， 因 为 很 多 系 统 程 序 （ 有 点 傻 的 那 种 ） 依 赖 于 它 。 如 果 你 将 它 置 为 可 写 ， 其 他 用 户 可 能 会 修 改 它 （ //* 导 致 程 序 运 行 出 错 ） 。 （ //* （ //* ） 中 为 译 者 注 ） 文 件 中 是 一 些 条 目 的 列 表 ， 条 目 的 结 构 （ 在 utmp.h 中 进 行 了 声 明 ） 见 下 ( 注 意 这 里 只 列 出 了 一 部 分 ； 细 节 依 libc 的 版 本 有 所 不 同 ） ：
#define
UT_UNKNOWN 0
#define RUN_LVL 1
#define BOOT_TIME 2
#define NEW_TIME 3
#define OLD_TIME 4
#define INIT_PROCESS 5
#define LOGIN_PROCESS 6
#define USER_PROCESS 7
#define DEAD_PROCESS 8
#define ACCOUNTING 9
#define
UT_LINESIZE 12
#define UT_NAMESIZE 32
#define UT_HOSTSIZE 256
struct
exit_status {
short int e_termination; /* process termination status. */
short int e_exit; /* process exit status. */ };
struct utmp {
short ut_type; /* type of login */
pid_t ut_pid; /* pid of login process */
char ut_line[UT_LINESIZE]; /* device name of tty -
"/dev/" */
char ut_id[4]; /* init id or abbrev. ttyname */
char ut_user[UT_NAMESIZE]; /* user name */
char ut_host[UT_HOSTSIZE]; /* hostname for remote login */
struct exit_status ut_exit; /* The exit status of a process
marked as DEAD_PROCESS. */
long ut_session; /* session ID, used for windowing*/
struct timeval ut_tv; /* time entry was made. */
int32_t ut_addr_v6[4]; /* IP address of remote host. */
char pad[20]; /* Reserved for future use. */ };
/* Backwards
compatibility hacks. */
#define ut_name ut_user
#ifndef _NO_UT_TIME
#define ut_time ut_tv.tv_sec
#endif
#define ut_xtime ut_tv.tv_sec
#define ut_addr ut_addr_v6[0] 这 个 结
构 给 出 了 与 用
户 终 端 联 系 的
文 件 ， 用 户 的
登 录 名 ， 记 录
于 time(2) 表 中 的 登
录 时 间 。 字 符
串 如 果 比 给 定
的 大 小 小 的 话
， 则 以 ’\0’ 结
束 之 。 第 一 个
条 目 由 init(8) 执 行
inittab(5)而 产 生 。
然 而 ， 在 产 生
条 目 以 前 ， init(8)
先 将 utmp 清 空 （ 通
过 设 定 ut_type 为
DEAD_PROCESS来 实 现 . 当
ut_type 不 是 DEAD_PROCESS
或 RUN_LVL 并 且 不 存
在 进 程 号 为 ut_pid
的 进 程 时 ,通 过
用 空 串 清 空 ut_user,
ut_host 和 ut_time 来 实
现 。 如 果 不 存
在 ut_id 的 空 记 录 ,
init（ 初 始 化 时 ）
会 创 建 一 个 。
它 将 会 依 据 inittab
来 设 置 ut_id , 设 置
ut_pid 和 ut_time 为 当
前 值 ， 设 置 ut_type
到 INIT_PROCESS.
getty(8) 依 据 进 程 号 定 位 条 目 , 将 ut_type 改 为 LOGIN_PROCESS, 改 变 ut_time, 设 定 ut_line ， 然 后 等 待 连 接 建 立 。 login(8), 在 鉴 别 完 用 户 后 , 将 ut_type 改 为 USER_PROCESS, 改 变 ut_time 并 设 定 ut_host 和 ut_addr. 根 据 getty(8) 和 login(8)完 成 的 功 能 , 可 以 用 ut_line 来 定 位 记 录 ， 虽 然 用 ut_pid 可 能 更 好 些 。 当 init(8) 发 现 有 进 程 存 在 时 , 它 通 过 ut_pid 来 定 位 它 的 utmp 条 目 , 设 定 ut_type 为 DEAD_PROCESS ， 然 后 用 零 字 节 清 空 ut_user, ut_host 和 ut_time 。
xterm(1) 和 其 他 终 端 仿 真 器 直 接 创 建 USER_PROCESS 记 录 并 通 过 使 用 /dev/ttyp%c 的 最 后 两 个 字 母 或 用 p%d （ /dev/pts/%d） 来 产 生 ut_id 。 如 果 它 们 找 到 这 个 id 的 DEAD_PROCESS , 它 们 就 使 用 它 ， 否 则 就 创 建 一 个 新 的 条 目 . 如 果 可 能 ， 它 们 将 它 标 记 为 DEAD_PROCESS 并 将 ut_line, ut_time, ut_user 和 ut_host 置 为 null。
xdm(8) 不 会 创 建 utmp 记 录 , 因 为 没 有 终 端 与 它 相 连 . 试 图 用 它 产 生 utmp 记 录 会 引 起 如 下 错 误 ： finger: can not stat /dev/machine.dom. 它 应 该 用 于 创 建 wtmp 条 目 , 和 ftpd(8) 相 似 .
telnetd(8) 设 定 LOGIN_PROCESS 条 目 并 把 其 他 的 的 留 给 login(8) 去 做 。 telnet 任 务 结 束 后 , telnetd(8) cleans up utmp in the described way.（ ？ ？ ）
wtmp 文 件 记 录 了 所 有 的 登 录 和 退 出 。 它 的 格 式 与 utmp 几 乎 完 全 一 样 （ 例 外 是 ： 用 空 用 户 名 来 表 示 在 相 关 终 端 上 的 退 出 ） 。 除 此 以 外 ， 用 终 端 名 "~" 和 用 户 名 "shutdown" 或 "reboot" 表 示 系 统 关 机 或 重 启 ， the pair of terminal names "|"/"}" logs the old/new system time when date(1) changes it. wtmp 由 login(1), 和 init(1) 以 及 某 些 版 本 的 getty(1) 使 用 . 但 是 这 些 程 序 并 不 创 建 它 ,所 以 如 果 将 它 删 除 的 话 您 就 得 不 到 记 录 了 。
FILES[相 关 文 件 ]
/var/run/utmp
/var/log/wtmp
CONFORMING TO[遵 循 ]
Linux utmp 既 不 遵 循 v7/BSD 也 不 遵 循 SYSV: 它 实 际 是 两 者 的 混 合 . v7/BSD 中 域 比 较 少 ; 最 重 要 的 是 它 没 有 ut_type (ut_type 可 以 使 本 地 的 v7/BSD-类 的 程 序 显 示 (以 次 为 例 ) dead 或 login 条 目 .而 且 ,没 有 为 任 务 分 配 通 道 的 文 件 . BSD 则 相 反 (BSD does so), 因 为 它 缺 少 的 是 ut_id 域 . 在 Linux 中 (SYSV 中 也 一 样 ), 记 录 的 ut_id 域 一 旦 设 定 就 不 再 改 变 ,它 保 留 通 道 而 不 需 要 什 么 配 置 文 件 . 清 除 ut_id 可 能 会 引 起 race conditions 从 而 导 致 安 全 漏 洞 . 就 SYSV 的 要 求 来 讲 ,用 空 字 节 填 充 的 方 式 来 清 空 上 面 提 到 的 各 个 域 不 是 必 须 的 ,但 是 这 样 做 使 得 运 行 采 用 BSD 语 法 而 又 不 改 变 utmp 的 程 序 成 为 可 能 . 正 如 上 面 所 写 的 ,Linux 在 句 子 中 使 用 BSD 的 惯 例 .
SYSV 在 句 子 中 仅 使 用 类 型 域 去 标 识 它 们 或 是 登 录 信 息 (例 如 :. "new time"). UT_UNKNOWN 只 在 Linux 中 有 . SYSV 没 有 ut_host 和 ut_addr_v6 域 . 不 象 其 它 各 种 系 统 , 您 可 以 通 过 删 除 文 件 来 禁 止 utmp , 在 Linux 中 utmp 必 须 一 直 存 在 . 如 果 你 要 禁 止 who(1) 命 令 ,您 需 要 使 整 个 utmp 不 可 读 . 需 要 注 意 的 是 在 libc5 和 libc6 中 utmp 的 结 构 是 不 同 的 .因 此 使 用 旧 结 构 的 程 序 会 破 坏 /var/run/utmp 和 /or /var/log/wtmp. Debian 系 统 包 含 一 个 修 补 过 的 libc5 它 可 以 使 用 新 的 格 式 . 但 对 wtmp, 问 题 依 然 存 在 因 为 它 直 接 对 libc5 进 行 存 取 .
RESTRICTIONS[限 制 ]
文 件 格 式 依 机 器 而 不 同 , 因 此 推 荐 的 做 法 是 :在 创 建 它 的 机 器 上 使 用 它 .
BUGS[缺 憾 ]
本 手 册 页 基 于 libc5 , 现 在 可 能 情 况 已 有 不 同 了 .
SEE ALSO[另 见 ]
ac(1), date(1), getutent(3), init(8), last(1), login(1), updwtmp(3), who(1)
[中 文 版 维 护 人 ]
Redcandle <redcandle51 [AT] chinaren.com>
[中 文 版 最 新 更 新 ]
2001.11.08
《 中 国 linux论 坛 man手 册 页 翻 译 计 划 》 :
跋
本 页 面 中 文 版 由 中 文 man 手 册 页 计 划 提 供 。 中 文 man 手 册 页 计 划 ： https://github.com/man-pages-zh/manpages-zh