ZeroTermux 内置命令手册:who 命令详解与源码级实现剖析

原创2026-10-13 20:53:192,276 阅读
文章标签:移动开发开发工具CLI

ZeroTermux 内置命令手册:who 命令详解与源码级实现剖析

导读

who 是 Linux/Unix 系统中用于查询当前登录用户信息的基础命令,也是 ZeroTermux 内置的 600+ 条 Linux 命令离线手册(app/src/main/assets/cmd/)中的一员。本文以 who 命令手册(who.md)为核心,完整讲解其语法、选项、参数与真实运行输出,并深入 ZeroTermux 源码,剖析该离线手册在 App 内的加载、渲染与交互实现,帮助你既能熟练掌握 who 命令,也能理解 ZeroTermux 内置命令手册的底层工作方式。

who 命令概述

who 命令用于显示目前登录系统的用户信息。单独执行 who 时,它会列出登入系统的账号、使用的终端机(TTY)、登入时间,以及从何处登入(远程 IP 地址或正在使用的 X 显示器)。

该命令常见于多用户服务器环境,用于快速查看"当前有哪些人在线、从哪里登录"。在 Android 的 Termux 环境中(如 ZeroTermux 的终端模拟器),当你通过 SSH 或本地会话登录后,同样可以用 who 观察当前会话状态。

语法

who(选项)(参数)

选项详解

选项 长选项 作用
-H --heading 显示各栏位的标题信息列(如 NAME、LINE、time、COMMENT)
-i -u / --idle 显示闲置时间:若用户在前一分钟内有任何动作,标示为 . 号;若超过 24 小时无任何动作,则标示为 old 字符串
-m — 此参数效果与指定 am i 字符串相同,仅显示当前终端对应的登录信息
-q --count 只显示登入系统的账号名称和总人数
-s — 忽略不予处理,仅负责解决 who 指令其他版本的兼容性问题
-w -T / --mesg / --message / --writable 显示用户的信息状态栏(+、- 或 ? 等状态标记)
--help — 在线帮助
--version — 显示版本信息

参数说明

who 命令支持一个可选参数:

  • 文件:指定查询文件。默认查询 /var/run/utmp(或 /var/log/wtmp)中的登录记录,也可手动指定其他 utmp/wtmp 文件来查询历史登录信息。

实战示例

基本用法:列出当前登录用户

[root@localhost ~]# who
root     pts/0        2013-08-19 15:04 (192.168.0.134)
root     pts/1        2013-12-20 10:37 (180.111.155.40)

输出四列分别为:登录账号(root)、终端行(pts/0、pts/1)、登录时间(2013-08-19 15:04)与来源地址(192.168.0.134)。

只统计在线人数:-q / --count

[root@localhost ~]# who -q
root root
# users=2

仅输出登录账号名列表与总人数 # users=2。

显示表头:-H / --heading

[root@localhost ~]# who -H
NAME     LINE         time             COMMENT
root     pts/0        2013-08-19 15:04 (192.168.0.134)
root     pts/1        2013-12-20 10:37 (180.111.155.40)

加上 -H 后,输出首行会显示各栏位标题:NAME、LINE、time、COMMENT。

显示信息状态栏:-w / -T / --writable

[root@localhost ~]# who -w
root     + pts/0        2013-08-19 15:04 (192.168.0.134)
root     + pts/1        2013-12-20 10:37 (180.111.155.40)

LINE 前的 + 表示该用户的终端允许接收 write/mesg 消息(即可写状态);若为 - 则表示禁止接收消息,? 表示无法确定状态。

结合 whoami 确认当前身份

who 关注的是"系统上有谁登录",而 whoami 关注的是"当前有效用户是谁"。在 whoami.md 中,whoami 相当于执行 id -un,输出当前用户名:

[root@localhost ~]# whoami
root

[root@localhost ~]# id -un
root

两个命令互补:排查会话归属用 who,确认自身权限身份用 whoami。

源码级剖析:who.md 如何在 ZeroTermux 内呈现

ZeroTermux 将 who.md 等命令手册以 Markdown 文件形式打包进 APK 的 assets 资源目录(app/src/main/assets/cmd/),并在 App 内提供"命令手册"浏览功能。其核心实现位于 CommandDialog.java。

入口:悬浮窗中的"命令"入口

从源码结构看,CommandDialog 的实例化入口位于 BoomWindow.java:点击悬浮窗中的"命令"按钮时,创建 CommandDialog 并 show() 展示,同时 setCancelable(false) 防止误触关闭:

CommandDialog commandDialog = new CommandDialog(termuxActivity);
commandDialog.show();
commandDialog.setCancelable(false);

加载命令列表:AssetManager 读取 assets/cmd 目录

CommandDialog 初始化时通过 AssetManager.list("cmd") 一次性读取 assets 下 cmd/ 目录内的全部文件名(即命令手册列表),构建 cmdList:

cmdList.addAll(Arrays.asList(assetManager.list("cmd")));

随后用 LinearLayoutManager 放入 RecyclerView,并以 CommandAdapter 展示每条命令名称。

实时搜索过滤

对话框顶部提供了 EditText 搜索框,通过 TextWatcher 监听输入,在子线程中按包含匹配过滤 cmdList,并对结果按字母序(忽略大小写)排序后刷新列表:

if (cmdList.get(i).contains(s)) {
    cmdListTemp.add(cmdList.get(i));
    cmdListTemp.sort((o1, o2) -> ((String) o1).toUpperCase().compareTo(((String) o2).toUpperCase()));
}

这意味着你在 ZeroTermux 中直接输入 who 即可快速定位 who.md 手册条目。

Markdown → HTML 渲染:commonmark 管线

点击某条命令后,showCmdDetail() 通过 assetManager.open("cmd/" + cmd) 打开对应的 .md 文件,用 commonmark 的 Parser 解析 Markdown 文档树,再用 HtmlRenderer 渲染为 HTML,最后通过 WebView.loadData 展示:

InputStreamReader reader = new InputStreamReader(assetManager.open(String.format("cmd/%s", cmd)));
Parser parser = Parser.builder().build();
Node document = parser.parseReader(reader);
HtmlRenderer renderer = HtmlRenderer.builder().build();
web_view.loadData(renderer.render(document), "text/html; charset=UTF-8", null);

WebView 阅读体验配置

为适配手机屏幕阅读手册,WebView 启用了 SINGLE_COLUMN 单列排版布局算法,并支持双指缩放(setSupportZoom(true) + setBuiltInZoomControls(true)),同时隐藏系统缩放控制条(setDisplayZoomControls(false))。阅读完毕可通过"返回"按钮(fanhui)从详情页回到命令列表,或通过关闭按钮(close_img)关闭整个对话框。

窗口呈现:BaseDialogCentre

CommandDialog 继承自 BaseDialogCentre.java,其 show() 方法对对话框窗口做居中与宽度适配:宽度为屏幕宽度减 300px,高度在未指定时使用 WRAP_CONTENT,并设置背景变暗程度 dimAmount——这是命令手册弹窗在手机屏幕上居中、清晰可读的布局基础。

常见问题与使用提示

  1. who 输出为空? 若系统没有登录记录文件或当前环境非多用户登录场景,who 可能没有输出;可尝试 who -H 确认表头,或使用 who -q 查看是否存在统计行。
  2. -m 与 am i 的关系:who -m 等价于 who am i,只显示当前终端对应的登录者信息,适合快速确认"我是谁、从哪登录"。
  3. 闲置时间标记含义:-u 输出的 . 表示用户 1 分钟内有活动,old 表示超过 24 小时无活动,中间状态会显示具体闲置分钟数。
  4. 离线可用:cmd/ 目录中的手册全部随 APK 内置,who.md 与 whoami.md 等 600+ 条手册无需联网即可在 ZeroTermux 内随时查阅。

参考资源

登录后查看全文
ZeroTermux