玩转DBus命令行工具之dbus-send

最新推荐文章于 2026-06-04 20:13:42 发布
原创 最新推荐文章于 2026-06-04 20:13:42 发布 · 1k 阅读 ·
本内容遵循CC 4.0 BY-SA版权协议
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
GEO检测
cknow-ai KingRumn

cknow-ai 关注

标签
#linux #算法
分类 操作系统

dbus-send 使用指南

概述

dbus-send 是 D-Bus 最常用的命令行工具，用于发送方法调用和信号。它是 D-Bus 核心工具集的一部分，适用于快速测试和调试。

基本语法

dbus-send [--system|--session] [--print-reply] \
  --dest=服务名 对象路径 接口名.方法名 [参数]

发送方法调用

无参数方法调用

# 调用 ListNames 方法（列出所有服务名）
dbus-send --session --print-reply \
  --dest=org.freedesktop.DBus \
  /org/freedesktop/DBus \
  org.freedesktop.DBus.ListNames

带参数的方法调用

# 调用 RequestName 方法（请求服务名）
dbus-send --session --print-reply \
  --dest=org.freedesktop.DBus \
  /org/freedesktop/DBus \
  org.freedesktop.DBus.RequestName \
  string:"com.example.Service" \
  uint32:0

参数类型

  • string:"value"：字符串
  • int32:123：32位整数
  • uint32:123：无符号32位整数
  • int16:123：16位整数
  • uint16:123：无符号16位整数
  • int64:123：64位整数
  • uint64:123：无符号64位整数
  • double:3.14：双精度浮点数
  • boolean:true：布尔值
  • array:string:"a","b","c"：数组
  • dict:string:string:"key","value"：字典

调用自定义服务方法

# 假设有一个服务 com.example.Service，对象路径 /com/example/Object
# 接口 com.example.Interface，方法 GetData，参数为字符串
dbus-send --session --print-reply \
  --dest=com.example.Service \
  /com/example/Object \
  com.example.Interface.GetData \
  string:"parameter"

访问属性

属性访问通过 org.freedesktop.DBus.Properties 接口实现。

重要说明：org.freedesktop.DBus.Properties 接口需要服务端实现支持。如果服务端未实现此接口，调用会失败。

获取属性（Get）

# 获取属性值
dbus-send --session --print-reply \
  --dest=com.example.Service \
  /com/example/Object \
  org.freedesktop.DBus.Properties.Get \
  string:"com.example.Interface" \
  string:"PropertyName"

设置属性（Set）

# 设置属性值（需要将值包装在 variant 中）
# 注意：dbus-send 对 variant 支持有限，建议使用 gdbus
dbus-send --session --print-reply \
  --dest=com.example.Service \
  /com/example/Object \
  org.freedesktop.DBus.Properties.Set \
  string:"com.example.Interface" \
  string:"PropertyName" \
  variant:string:"new value"

获取所有属性（GetAll）

dbus-send --session --print-reply \
  --dest=com.example.Service \
  /com/example/Object \
  org.freedesktop.DBus.Properties.GetAll \
  string:"com.example.Interface"

内省对象

# 获取对象的 XML 描述
dbus-send --session --print-reply \
  --dest=com.example.Service \
  /com/example/Object \
  org.freedesktop.DBus.Introspectable.Introspect

重要说明：org.freedesktop.DBus.Introspectable 接口需要服务端实现支持。如果服务端未实现此接口，调用会失败。此接口允许客户端动态发现对象的接口、方法、信号和属性等信息。

对象管理（ObjectManager）

org.freedesktop.DBus.ObjectManager 接口用于管理对象的生命周期，允许客户端获取服务管理的所有对象及其接口和属性。

重要说明：此接口需要服务端实现支持。通常由服务在根对象路径（如 /）上实现。

获取所有管理的对象

# 获取服务管理的所有对象及其接口和属性
dbus-send --session --print-reply \
  --dest=com.example.Service \
  / \
  org.freedesktop.DBus.ObjectManager.GetManagedObjects

返回值：a{oa{sa{sv}}} 类型（嵌套字典）

  • 外层键：对象路径（object path）
  • 外层值：字典，键为接口名，值为属性字典

使用场景：

  • 发现服务管理的所有对象
  • 获取对象的接口和属性信息
  • 监控对象的添加和移除（通过监听信号）

对等接口（Peer）

org.freedesktop.DBus.Peer 接口提供基本的连接检查功能。

重要说明：此接口由 D-Bus 库自动提供，不需要服务端显式实现。所有通过 D-Bus 连接的对象都自动支持此接口。

Ping - 检查连接

# 检查服务是否可用（无参数，无返回值）
dbus-send --session --print-reply \
  --dest=com.example.Service \
  /com/example/Object \
  org.freedesktop.DBus.Peer.Ping

说明：如果服务可用，方法调用会成功返回；如果服务不可用，会返回错误。

GetMachineId - 获取机器ID

# 获取连接所在机器的唯一标识符
dbus-send --session --print-reply \
  --dest=com.example.Service \
  /com/example/Object \
  org.freedesktop.DBus.Peer.GetMachineId

返回值：s（string），机器的唯一标识符（UUID 格式）

使用场景：

  • 检查服务是否可用（Ping）
  • 获取机器标识符（GetMachineId）
  • 测试连接状态

发送信号

# 发送信号（不需要回复）
dbus-send --session \
  --type=signal \
  /com/example/Object \
  com.example.Interface.SignalName \
  string:"signal data"

参数说明：

  • --type=signal：指定消息类型为信号
  • 不需要 --dest 参数（信号是广播的）

服务管理

请求服务名

# 请求服务名（通常由服务程序自动完成）
dbus-send --session --print-reply \
  --dest=org.freedesktop.DBus \
  /org/freedesktop/DBus \
  org.freedesktop.DBus.RequestName \
  string:"com.example.Service" \
  uint32:4

标志位说明：

  • 0：默认
  • 1：DBUS_NAME_FLAG_ALLOW_REPLACEMENT：允许其他服务替换
  • 2：DBUS_NAME_FLAG_REPLACE_EXISTING：如果已存在则替换
  • 4：DBUS_NAME_FLAG_DO_NOT_QUEUE：如果已存在则不排队

释放服务名

# 释放服务名
dbus-send --session --print-reply \
  --dest=org.freedesktop.DBus \
  /org/freedesktop/DBus \
  org.freedesktop.DBus.ReleaseName \
  string:"com.example.Service"

检查服务是否存在

# 检查服务名是否有所有者
dbus-send --session --print-reply \
  --dest=org.freedesktop.DBus \
  /org/freedesktop/DBus \
  org.freedesktop.DBus.NameHasOwner \
  string:"com.example.Service"

获取服务所有者

# 获取服务名的所有者
dbus-send --session --print-reply \
  --dest=org.freedesktop.DBus \
  /org/freedesktop/DBus \
  org.freedesktop.DBus.GetNameOwner \
  string:"com.example.Service"

列出所有服务名

dbus-send --session --print-reply \
  --dest=org.freedesktop.DBus \
  /org/freedesktop/DBus \
  org.freedesktop.DBus.ListNames

列出可激活的服务

# 列出所有可激活的服务名
dbus-send --session --print-reply \
  --dest=org.freedesktop.DBus \
  /org/freedesktop/DBus \
  org.freedesktop.DBus.ListActivatableNames

实际应用示例

示例 1：查询 NetworkManager 状态

# 获取 NetworkManager 的连接状态
dbus-send --system --print-reply \
  --dest=org.freedesktop.NetworkManager \
  /org/freedesktop/NetworkManager \
  org.freedesktop.DBus.Properties.Get \
  string:"org.freedesktop.NetworkManager" \
  string:"NetworkingEnabled"

示例 2：控制媒体播放器

# 播放（假设使用 MPRIS 接口）
dbus-send --session --print-reply \
  --dest=org.mpris.MediaPlayer2.vlc \
  /org/mpris/MediaPlayer2 \
  org.mpris.MediaPlayer2.Player.Play

# 暂停
dbus-send --session --print-reply \
  --dest=org.mpris.MediaPlayer2.vlc \
  /org/mpris/MediaPlayer2 \
  org.mpris.MediaPlayer2.Player.Pause

常用选项

  • --system：使用系统总线
  • --session：使用会话总线（默认）
  • --print-reply：显示方法调用的返回值
  • --type=signal：发送信号而不是方法调用
  • --dest=服务名：指定目标服务

注意事项

  1. 返回值：dbus-send 默认不显示返回值，使用 --print-reply 查看
  2. variant 类型：dbus-send 对 variant 支持有限，复杂类型建议使用 gdbus
  3. 权限：系统总线操作通常需要 root 权限
  4. 服务名格式：服务名通常使用反向域名格式（如 com.example.Service）
  5. 标准接口支持：

    • 需要服务端实现的标准接口：

      • org.freedesktop.DBus.Properties：属性访问接口（Get、Set、GetAll）
      • org.freedesktop.DBus.Introspectable：内省接口（Introspect）
      • org.freedesktop.DBus.ObjectManager：对象管理接口（GetManagedObjects）

      如果服务端未实现这些接口，相应的调用会失败并返回错误。客户端在调用前应检查服务是否支持所需接口。

    • 自动提供的标准接口：

      • org.freedesktop.DBus.Peer：对等接口（Ping、GetMachineId）

      此接口由 D-Bus 库自动提供，所有通过 D-Bus 连接的对象都自动支持，无需服务端显式实现。

扩展阅读

点赞 点赞 20
评论 0
书签 书签 13
D-Bus：dbus-send和dbus-monitor
风静如云的博客
11-17 1371
dbus-send [--system | --session | --bus=ADDRESS | --peer=ADDRESS] [--dest=NAME] [--print-reply [=literal]] [--reply-timeout=MSEC] [--type=TYPE] 对象名 接口名.方法 参数类型:参数 ...一个method call实际上有两个消息，一个是call，另一个是return，可以通过serial=2以及reply_serial=2进行关联。sender=发送服务名。
dbus-glib编程3：消息和消息总线 dbus-send的使用
cyf15238622067的博客
09-02 2621
1、从例子开始 我写了一个最简单的dbus服务器，它通过dbus提供了一个加法的接口。 大家可以https://download.csdn.net/download/cyf15238622067/12797794这个例子。这是一个autotool工程，大家解包后，执行： ./autogen.sh ./configure make 然后在src目录运行： ./example-service 这时再运行d-feet，连接session bus，在“Bus Name”窗口会看到一个叫“org.f
dbus客户端使用指南
期待幸福
10-11 1483
DBus是Linux使用的进程间通信机制，允许各个进程互相访问，而不需要为每个其他组件实现自定义代码。即使对于系统管理员来说，这也是一个相当深奥的主题，但它确实有助于解释linux的另一部分是如何工作的。 这里主要介绍 dbus-send 与 GDbus cli工具，其他的还有QtDbus , d-feet… 命令行工具dbus-send ，是freedesktoop提供的dbus包配套的命令客户端工具，可用于发送dbus消息。 GDbus GLib实现的dbus工具。较与 dbus-send，拥有更完整的
Linux无头服务器上解决GSettings报错：手把手教你设置DBUS_SESSION_BUS_ADDRESS
weixin_30772105的博客
04-01 459
本文详细介绍了在Linux无头服务器上解决GSettings报错的方法，重点讲解了如何设置DBUS_SESSION_BUS_ADDRESS环境变量。从手动设置到自动化解决方案，包括systemd服务配置和cron作业处理，帮助开发者在无图形界面环境下顺利使用GSettings和dconf功能。
dbus-send和dbus-monitor命令详解
我是唐
07-26 6892
dbus-send和dbus-monitor命令详解
D-bus学习笔记一 基础知识篇
远行的蜗牛
02-16 2868
D-Bus是GNOME和KDE环境中广泛使用的进程间通信的软件，D-Bus允许用户做方法调用或者捕获从别的程序发送的信号，从而达到进程通信的目的。 Dbus 使用指南 1. dbus 是什么？ d-bus 是类unix 操作系统IPC 机制 可用于系统通知，桌面交互操作 低开销：使用二进制协议，需要类似XML 文本格式转换 易使用：使用 message 来通讯，开发者可 利用d-bus动态库使用d-bus已有的 object/type 系统开发 1.2dbus 类型 system bus 系统更新通知
玩转DBus命令行工具之qdbus使用
荒坡_KingRumn
12-29 766
qdbus是 Qt 提供的 D-Bus 命令行工具，功能类似于gdbus，但使用 Qt 的 D-Bus 实现。它提供了便捷的方法调用、属性访问和信号监听功能。
别再死磕libbluetooth了！用DBUS和gdbus玩转BlueZ 5.54（附君正X2000实战代码）
weixin_30561177的博客
06-04 384
本文详细介绍了从传统libbluetooth转向DBUS接口的BlueZ 5开发范式迁移，重点解析了DBUS架构的优势及在君正X2000平台上的实战应用。通过gdbus工具链和BLE串口服务实例，展示了现代蓝牙开发的高效方法，帮助开发者解决兼容性和权限问题，提升开发效率。
AntiMicroX终极指南：5分钟让你的手柄玩转所有PC游戏
最新发布
gitblog_00537的博客
06-04 382
还在为PC游戏不支持手柄而烦恼吗？想要在策略游戏中使用摇杆控制视角，却只能依赖鼠标键盘？AntiMicroX正是解决这些问题的**免费开源手柄映射工具**，它能将任何游戏手柄转换为键盘鼠标控制器，让每款PC游戏都能享受原生手柄支持的乐趣。无论你是Windows还是Linux用户，只需5分钟，你就能让手柄在原本不支持的游戏上大显身手。 ## 为什么选择AntiMicroX？解决手柄兼容性痛点 你
dbus-send和dbus-monitor简单使用及可视化工具
BlueShaw的专栏
12-08 9055
dbus参数类型 Character Code Data Type y 8-bit unsigned integer b boolean value n 16-bit signed integer q 16-bit unsigned integer i 32-bit signed integer u 32-bit unsigned integer x 64-bit signed integer t 64-bit unsigned integer d doubl
dbus学习 - dbus信息查看命令和d-feet工具
hjj801006的专栏
05-25 3104
dbus学习-dbus信息查看
Linux中的dbus-send命令
tecoes的博客
11-02 384
dbus-send是一个强大的工具，它允许我们与DBus服务进行交互，发送消息并获取响应。通过掌握dbus-send的使用，我们可以更好地利用Linux系统中的DBus机制，实现进程间的通信和数据共享。其中，--session和--system选项用于指定要与之通信的DBus类型，分别是会话级DBus和系统级DBus。在使用dbus-send之前，我们需要知道要与之通信的DBus服务的名称或地址。dbus-send命令是DBus的一个客户端工具，用于向DBus服务发送消息。二、dbus-send命令简介。
深入探索Linux中的dbus-send命令
听风的鱼鱼儿
06-09 1061
dbus-send是一个强大的工具，它允许我们与DBus服务进行交互，发送消息并获取响应。通过掌握dbus-send的使用，我们可以更好地利用Linux系统中的DBus机制，实现进程间的通信和数据共享。通过dbus-send，我们可以向DBus服务发送消息，从而触发特定的操作或获取信息。dbus-send命令是DBus的一个客户端工具，用于向DBus服务发送消息。在使用dbus-send之前，我们需要知道要与之通信的DBus服务的名称或地址。指定了消息的目标地址，即要与之通信的DBus服务的名称或地址。
dbus-send 命令介绍
dmgy110的博客
07-25 862
dbus-send命令用于在 D-Bus 消息总线上发送消息。D-Bus（Desktop Bus）是一种进程间通信（IPC）机制，允许不同的应用程序和服务相互通信。dbus-send是一个命令行工具，用于发送消息给 D-Bus 总线上的服务，进行一些基本的操作或查询信息。
dbus-send以及dbus-monitor工具的使用方法示例
热门推荐
刀刀的专栏
06-28 2万+
dbus-send以及dbus-monitor工具的使用方法示例。    dbus-send的详细用法可以参阅手册（$man dbus-send或者$dbus-send --help）。    调用远程方法的一般形式是： $ dbus-send [--system | --session] --type=method_call --print-reply --dest=连接名
dbus实例讲解（二下）：消息和消息总线
技术代码资料库
01-10 1204
2.3.2、ListActivatableNames和服务器的自动启动 运行： $ dbus-send --system --print-reply --dest=org.freedesktop.DBus / org.freedesktop.DBus.ListActivatableNames 和 $ dbus-send --session --print-reply --dest=org....
DBUS入门与C编程
爱她就要努力
02-15 1656
D-Bus最主要的用途是在 Linux 桌面环境为进程提供通信，同时能将 Linux 桌面环境和 Linux 内核事件作为消息传递到进程。D-Bus(其中D原先是代表桌面“Desktop” 的意思)，即：用于桌面操作系统的通信总线。D-Bus的主要概念为总线，注册后的进程可通过总线接收或传递消息，进程也可注册后等待内核事件响应，例如等待网络状态的转变或者计算机发出关机指令。D-Bus是为Linux系统开发的进程间通信。
linux / dbus
布袋和尚
10-17 1254
1、列出所有的 dbus 服务。2、如何列出系统服务的接口。
DBus客户端使用总结（d-feet，qdbus，dbus-send，gdbus)
啊渊的专栏
06-17 1974
目录d-feet客户端qdbus客户端​编辑gdbus客户端dbus-send客户端d-feet是比较好用的dbus工具,他使用python语言编写的,并且他有可视化界面,在d-feet工具内可以方便的看到系统dbus接口以及session的dbus接口,在查询dbus接口方面是非常不错的.缺点在于如果希望编写自动化脚本测试dbus接口,d-feet客户端就不行了(也许有方法我不知道)客户端安装 详细内容可以看：-> D-Feet的复杂类型使用攻略（DBUS）qdbus客户端是qt的开发客户端工具。使用
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值