busctl - 云端在线

程序：

您的姓名

busctl - 内省总线

概要

总线控制 [选项...] [命令] [您的姓名...]

商品描述

总线控制 可用于自省和监控 D-Bus 总线。

配置

理解以下选项：

--地址=地址
连接到指定的总线 地址 而不是使用合适的默认值
系统或用户总线（见 - 系统 和 - 用户 选项）。

--显示机
在显示对等点列表时，显示一列包含它们的容器名称
属于。 看 systemd-machined.service（8）。

- 独特的
显示对等点列表时，仅显示“唯一”名称（形式为
":数.数“）。

--获得
相反的 - 独特的 — 只会显示“众所周知”的名字。

--可激活
显示对等点列表时，仅显示实际上尚未激活的对等点
尚未，但可能会在访问时自动启动。

--匹配=MATCH
显示正在交换的消息时，仅显示匹配的子集 MATCH.

--大小=
当与 捕获 命令，指定要捕获的最大总线消息大小
（“snaplen”）。 默认为 4096 字节。

- 列表
当与 树 命令，显示对象路径的平面列表而不是树。

- 安静的
当与 呼叫 命令，禁止显示响应消息有效负载。
请注意，即使指定了此选项，仍会打印返回的错误并
该工具将通过进程退出代码指示成功或失败。

--详细
当与 呼叫 or 获得财产 命令，以更详细的方式显示输出
格式。

--期待回复=BOOL
当与 呼叫 命令，指定是否 总线控制 将等待完成
方法调用，输出返回的方法响应数据，返回成功或
通过进程退出代码失败。 如果设置为“no”，方法调用将是
发出但预计没有响应，该工具立即终止，因此没有
可以显示响应，并且不会通过退出代码返回成功或失败。 到
只抑制回复消息有效负载的输出，使用 - 安静的 以上。 默认为
“是的”。

--自动启动=BOOL
当与 呼叫 命令，指定方法调用是否应该隐式
激活被调用的服务，如果它尚未运行但配置为
自动启动。 默认为“是”。

--允许交互授权=BOOL
当与 呼叫 命令，指定服务是否可以强制执行
执行操作时的交互式授权，如果安全策略是
为此配置。 默认为“是”。

--超时=SECS
当与 呼叫 命令，指定等待方法调用的最长时间
完成。 如果未指定时间单位，则假定为秒。 通常的其他单位是
也可以理解（ms、us、s、min、h、d、w、month、y）。 请注意，此超时不会
申请如果 --期望回复=否 使用，因为该工具不等待任何回复消息
然后。 当未指定或设置为 0 时，默认为“25s”。

--增强信用=BOOL
控制凭证数据是否由 名单 or 状态 应增加
来自 /proc 的数据。 当它打开时，显示的数据可能不一致，因为
读取的数据 / proc中 可能比凭证的其余部分更新
信息。 默认为“是”。

- 用户
与调用用户的服务经理交谈，而不是与用户的服务经理交谈
系统。

- 系统
与系统的服务经理交谈。 这是隐含的默认值。

-H, --主机=
远程执行操作。 指定主机名，或用户名和主机名
以“@”分隔，连接到。 主机名可以选择后缀
容器名称，以“:”分隔，直接连接到特定容器
指定的主机。 这将使用 SSH 与远程机器管理器实例通信。
容器名称可以枚举为 机器控制 -H HOST.

-M, --机器=
在本地容器上执行操作。 指定要连接的容器名称。

--无寻呼机
不要将输出通过管道传送到寻呼机。

--无图例
不要打印图例，即列标题和带有提示的页脚。

-h, - 帮帮我
打印简短的帮助文本并退出。

- 版
打印一个简短的版本字符串并退出。

指令

理解如下命令：

名单
按服务名称显示总线上的所有对等点。 默认情况下，显示唯一的和
众所周知的名字，但这可能会随着 - 独特的 和 --获得 开关。
如果未指定命令，则这是默认操作。

状态 [服务]
显示总线服务的进程信息和凭据（如果它的
唯一或众所周知的名称）、进程（如果一个进程由其数字 PID 指定），或
总线的所有者（如果未指定参数）。

监控 [服务...]
正在交换的转储消息。 如果 服务 指定，显示消息到或从这里
对等点，由其众所周知的或唯一的名称标识。 否则，显示所有消息
公共汽车。 使用 Ctrl-C 终止转储。

捕获 [服务...]
像 监控 但以 pcap 格式写入输出（有关详细信息，请参阅 libpcap
文件 格式[1] 说明。 确保将输出重定向到 STDOUT 到文件。
像工具一样 Wireshark的(1) 可用于剖析和查看生成的文件。

树 [服务...]
显示一个或多个服务的对象树。 如果 服务 被指定，显示对象
仅指定服务的树。 否则，显示所有服务的所有对象树
在获得至少一个知名名字的公共汽车上。

内省 服务 宾语 [接口]
显示指定对象的接口、方法、属性和信号（已识别
通过其路径）在指定的服务上。 如果传递了接口参数，则输出
仅限于指定接口的成员。

呼叫 服务 宾语 接口 方法 [推荐主打 [论据...]]]
调用一个方法并显示响应。 获取服务名称、对象路径、接口
名称和方法名称。 如果将参数传递给方法调用，则签名
string 是必需的，后跟参数，单独格式化为字符串。 为了
有关所用格式的详细信息，请参见下文。 为了抑制返回数据的输出，
使用 - 安静的 选项。

获得财产 服务 宾语 接口 物业...
检索一个或多个对象属性的当前值。 取一个服务名称，
对象路径、接口名称和属性名称。 可以在以下位置指定多个属性
一次，在这种情况下，它们的值将一个接一个地显示，由
换行符。 默认情况下，输出采用简洁格式。 用 --详细 更多
精心制作的输出格式。

设置属性 服务 宾语 接口 物业 推荐主打 论据...
设置对象属性的当前值。 获取服务名称、对象路径、
接口名称、属性名称、属性签名，后跟参数列表
格式化为字符串。

帮助
显示命令语法帮助。

参数 格式化

呼叫 和 设置属性 命令采用签名字符串后跟一个列表
参数格式化为字符串（有关 D-Bus 签名字符串的详细信息，请参阅 Type
系统 章 of 此 公交车 规范[2]）。 对于简单类型，每个参数跟随
签名应该只是格式化为字符串的参数值。 正布尔值
值的格式可以为“true”、“yes”、“on”或“1”； 负布尔值可能是
指定为“false”、“no”、“off”或“0”。 对于数组，数字的数字参数
应指定条目的数量，然后是条目。 对于变体，签名
应指定内容，然后是内容。 对于字典和结构，
其内容应直接规定。

例如，

下巴

是单个字符串“jawoll”的格式。

作为 3 hello world foobar

是具有三个条目“hello”、“world”和“foobar”的字符串数组的格式。

a{sv} 3 One s Eins 2 u XNUMX 是 b 真

是将字符串映射到变体的字典数组的格式，由三个组成
条目。 字符串“One”被分配了字符串“Eins”。 字符串“Two”被分配
32 位无符号整数 2. 字符串“Yes”被分配一个正布尔值。

请注意 呼叫, 获得财产, 内省 命令也将在此生成输出
返回数据的格式。 由于这种格式有时过于简洁而不容易
据了解， 呼叫 和 获得财产 命令可能会生成更冗长的多行
通过时输出 --详细 选项。

示例

例如： 1. 填写 和 阅读 a 以高

下面两个命令先写一个属性，然后再读回来。 该物业是
在“org.freedesktop.systemd1”服务的“/org/freedesktop/systemd1”对象上找到。
属性的名称是“org.freedesktop.systemd1.Manager”上的“LogLevel”
界面。 该属性包含一个字符串：

# busctl set-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager LogLevel s 调试
# busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager 日志级别
“调试”

例如： 2. 简洁 和 详细 输出

以下两个命令读取一个包含字符串数组的属性，首先
以简洁的格式显示，然后是详细的格式：

$ busctl get-property org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager 环境
作为 2 "LANG=en_US.UTF-8" "PATH=/ usr / local / sbin:在/ usr / local / bin目录:/ usr / sbin:/ usr / bin"
$ busctl get-property --verbose org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager 环境
数组“s”{
STRING "LANG=en_US.UTF-8";
字符串“路径=/ usr / local / sbin:在/ usr / local / bin目录:/ usr / sbin:/ usr / bin";
};

例如： 3. 调用中 a 付款方式

以下命令调用“StartUnit”方法
“/org/freedesktop/systemd1”对象的“org.freedesktop.systemd1.Manager”接口
“org.freedesktop.systemd1”服务，并传递两个字符串“cups.service”和
“代替”。 作为方法调用的结果，接收到单个对象路径参数并
图所示：

# busctl call org.freedesktop.systemd1 /org/freedesktop/systemd1 org.freedesktop.systemd1.Manager StartUnit ss "cups.service" "replace"
o "/org/freedesktop/systemd1/job/42684"

使用 onworks.net 服务在线使用 busctl