DBUS 配置文件

Posted 2023-05-06

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了DBUS 配置文件相关的知识，希望对你有一定的参考价值。

参考技术A 一个dbus daemon都一个配置文件来指定建立什么类型的dbus daemon，比如sysetm或者session类型，配置文件还会有一些资源限制，安全相关的参数设置等等

我系统中的session的配置文件选项列出来

地址：　/etc/dbus-1/session.conf

配置文件是xml格式

xxx@xxx:/etc/dbus-1$ cat session.conf

前提条件:

xxx@xxx:~/document/comb gcc client.c -ldbus-1 -I/usr/include/dbus-1.0 -o client
xxx@xxx:~/document/comb

$ dbus-daemon --session --print-address --fork --print-pid
unix:abstract=/tmp/dbus-CSy0dphkTM,guid=24e009e82bece7928f58cc4b5b39c4f6
2900

关键的一步，需要把监听的address　export出来（为什么要这么做呢，因为dbus_bus_get()获取连接的时候，会去找这个环境变量，来获取监听地址）

$ export DBUS_SESSION_BUS_ADDRESS=unix:abstract=/tmp/dbus-CSy0dphkTM,guid=24e009e82bece7928f58cc4b5b39c4f6

禁止发送到特定的目的bus name
编写/etc/dbus-1/session.conf

发送SIGHUP信号到dbus-daemon，可以其重新加载配置，在DBus daemon 启动中提到过

在这里禁止发送消息到hello.world.service,那不管是signal还是method都将失败．

如果想看spec文档，请访问：spec文档网址

dbus-send

行工具dbus-send ，是freedesktoop提供的dbus包配套的命令客户端工具，可用于发送dbus消息。

GDbus GLib实现的dbus工具。较与 dbus-send，拥有更完整的功能。

dbus有两种消息总线（message bus）：system bus 和 session bus，通过使用 --system和 --session 选项来通过dbus-send 向系统总线或会话总线发送消息。如果两者都未指定，默认为**session bus*.

System Bus:
- 在桌面上，为所有用户提供一条总线.
- 专用于系统服务。
- 有关于低级时间，例如网络连接，USB设备。
- 在嵌入式Linux系统中，system bus是唯一D-Bus类型。
Session Bus:
- 每个用户会话一个实例
- 为用户应用提供那个桌面服务。
- 连接到 X-session
- --dest=NAME : 这个是必选的参数，指定要接收消息的接口名称。例如 org.freedesktop.ExampleName 。
  
  --print-reply: 打印回复消息。
  
  --print-reply=literal: 如选项一样，打印回复正文。如有特殊字符，如对象或 object 则按字面打印，没有标点符号、转义字符等。
  
  --reply-timeout= : 可选参数，等待回复的超时时长，单位为毫秒。
  
  --system|--session: 发送的消息是system bus还是session bus，默认为 session bus.
  
  --type=method_call|signal: 调用的方法：默认为signal。
  
  必须始终指定要发送的消息的对象路径和名称。以下参数（如果有）是消息内容（消息参数）。这些值作为类型指定的值给出，可能包括如下所述的容器（数组、dict和变体）。
  
  支持参数
  
  dbus-send 发送的消息，在调用方法需要传参数时，必须将这些值给出。dbus-send 支持传入的参数的类型，并不为D-Bus支持的所有的数据类型，仅为一些简单的类型：如
  - Type: 这里type 仅仅为简单的数据类型，即 type:content ,支持的内容如下： string | int16 | uint16 | int32 | uint32 | int64 | uint64 | double | byte | boolean | objpath。
  - 数组：array = array:<type>:<value>[,<value>...]
  - 词典: dict = dict:<type>:<type>:<key>,<value>[,<key>,<value>...]。
  - 变体：variant = variant:<type>:<value>。
  根据官网的解析出来后如上述集中数据类型，更详细的描述可以根据官方 dbus-send 进行参考。
  
  可以通过一张图来理解 dbus-send 发送一个消息所需的几个必须参数
  
  通过简单的命令，来了解一个 dbus-send 命令如何传入参数
```
 dbus-send --dest=org.freedesktop.ExampleName \\  # service
   /org/freedesktop/sample/object/name \\  # object
   org.freedesktop.ExampleInterface.ExampleMethod \\ # interface.method
   int32:47 string:\'hello world\' double:65.32	\\ # param int
   array:string:"1st item","next item","last item" \\ # param array
   dict:string:int32:"one",1,"two",2,"three",3 \\ # param dict
   variant:int32:-8 \\ # param variant
   objpath:/org/freedesktop/sample/object/name # param object_path
```
  使用案例
  
  如列出所有总线接口
```
dbus-send --session \\
  --dest=org.freedesktop.DBus \\
  --type=method_call \\
  --print-reply \\
  /org/freedesktop/DBus \\
  org.freedesktop.DBus.ListNames
```
  查看对方总线所支持的对象接口，org.freedesktop.DBus.Introspectable 、org.freedesktop.DBus.Properties 和 org.freedesktop.PowerManagement。每个接口实现一些方法和信号。这些是你可以与之互动的东西。
```
dbus-send --session \\
	--type=method_call \\
	--print-reply \\
	--dest=org.freedesktop.DBus \\ 
	/ \\
	org.freedesktop.DBus.Introspectable.Introspect
```
  dbus-send，也支持调用远程总线接口，通过默认通过 DBUS_SESSION_BUS_ADDRESS 或 DBUS_SYSTEM_BUS_ADDRESS，来指定远程的总线。
```
DBUS_SESSION_BUS_ADDRESS=""
dbus-send --session \\
	--type=method_call \\
	--print-reply \\
	--dest=org.freedesktop.DBus \\ 
	/ \\
	org.freedesktop.DBus.Introspectable.Introspect
```
  gdbus
  
  gdbus是 GLib实现的dbus工具。较与 dbus-send，拥有更完整的功能。
  
  introspect : 可以打印出对象的接口和属性值。对应对象的所有者需要实现org.freedesktop.DBus.Introspectable 的接口。使用 --xml选项，将打印返回的xml 格式。--recurse 选项可将其子级等打印，--only 选项仅打印具有属性的接口。
  
  monitor: 类似于 dbus-monitor
  
  call: 调用一个方法，传入的必须为 GVariant ,而相应的也为GVariant。
  
  emit: 发出信号。信号中包含的每个参数除字符串外都必须序列化为GVariant。
  
  使用案例
```
gdbus introspect --system \\
	--dest org.freedesktop.UPower \\
	--object-path \\
	/ \\
	--recurse  \\
	--only-properties 
```
  通过call 来向一个dbus service发送信息
```
gdbus call --session \\
             --dest org.freedesktop.Notifications \\
             --object-path /org/freedesktop/Notifications \\
             --method org.freedesktop.Notifications.Notify \\
             my_app_name \\
             42 \\
             gtk-dialog-info \\
             "The Summary" \\
             "Here\'s the body of the notification" \\
             [] \\
              \\
             5000
(uint32 12,)
```
  监听一个服务的对象
```
gdbus monitor \\
	--system \\
	--dest org.freedesktop.NetworkManager \\
	--object-path /org/freedesktop/NetworkManager/AccessPoint/4141
```
  发送信号
```
gdbus emit --session \\
	--object-path /foo \\
	--signal org.bar.Foo "[\'foo\', \'bar\', \'baz\']"
```
  想特定进程发送信号，`--dest 为指定进程。
```
 gdbus emit \\
 	--session \\
 	--object-path /bar \\
 	--signal org.bar.Bar someString \\
 	--dest :1.42
```

以上是关于DBUS 配置文件的主要内容，如果未能解决你的问题，请参考以下文章

Bluez DBUS api NewConnection 方法给出了错误的文件描述符

如何使用 CMake 配置 DBus 依赖项

通过 Dbus 联系 Pulse Audio

dbus-daemon - session.conf - noncefile 的 Windows 配置问题

通过 bluez 浏览文件

Linux DBus 通信

DBUS 配置文件

dbus-send

支持参数

使用案例

gdbus