gentoo dbus

source/linux/gentoo_linux/gentoo_dbus.rst

@@ -0,0 +1,100 @@
+.. _gentoo_dbus:
+
+=================
+Gentoo D-Bus
+=================
+
+安装 firefox 时发现需要 ``dbus`` USE flag支持，所以修订 :ref:`install_gentoo_on_mbp` 配置; 不过 chromium 安装没有这个需求 (我在考虑作为精简系统是否确实需要这个参数?)
+
+D-Bus
+=======
+
+D-Bus是应用程序的一个进程间通讯(interprocess communication, ``IPC`` )系统。软件使用D-Bus实现服务间通讯。
+
+.. note::
+
+   有两种不同的 D-Bus 总线:
+
+   - ``system bus`` : 和操作系统整体有关的消息总线，例如硬件连接和断开
+   - ``session bus`` : 和特定用户会话有关的消息，例如 X 或 Wayland session
+
+USE flags
+============
+
+全局 ``dbus`` USE flag 支持D-Bus。激活这个参数会自动拉取 ``sys-apps/dbus`` ，这也是 ``desktop`` profile默认激活的USE flag。(我在 :ref:`install_gentoo_on_mbp` 实践采用 ``no-multilib (stable)`` profile，构建轻量级服务器系统，则默认没有启用dbus)
+
+- 编辑 ``/etc/protage/make.conf`` 激活全局D-Bus
+
+.. literalinclude:: gentoo_dbus/dbus_make.conf
+   :caption: 全局激活 ``dbus`` 
+
+针对 ``sys-apps/dbus`` 应用有一些可能常用参数:
+
+- ``X`` : 支持X11
+- ``elogind`` : 登陆管理器增强版，用于提供 multiseat 增强，适合非 :ref:`systemd` 的init系统，但是也在KDE和GNOME环境中的一些流行程序中使用(例如可以实现普通用户关机和重启系统)
+- ``systemd`` : 和 ``sys-apps/systemd`` at_console 支持一起编译
+
+在修订了 ``dbus`` 全局参数之后，使用以下命令的 ``--changed-use`` 选项确保更新整个系统
+
+.. literalinclude:: gentoo_dbus/rebuild_world_after_change_use
+   :caption: 在修改了全局 USE flag 之后对整个系统进行更新
+
+配置
+======
+
+- 主要的配置文件有2个:
+
+  - ``/usr/share/dbus-1/system.conf `` 用于 system bus
+  - ``/usr/share/dbus-1/session.conf`` 用于 session bus
+
+system bus: ``dbus`` 服务
+===========================
+
+D-Bus服务，也就是 OpenRC服务配置的 ``dbus`` service，是只负责 system bus 但不负责 session bus。
+
+- 对于OpenRC，需要使用如下命令启动和激活 ``dbus`` 服务:
+
+.. literalinclude:: gentoo_dbus/openrc_dbus
+   :caption: 在OpenRC中激活和启动dbus服务
+
+session bus
+================
+
+对于 KDE 和 GNOME 桌面环境，需要自动启动一个session bus。不过，这个session bus一般没有自动启动，例如可能需要配置到 ``.xinitrc`` 中(假设终端登陆使用 ``startx`` 启动桌面)
+
+- 检查在X或Wayland session 是否启动了 session bus，可以在桌面环境中启动一个终端，然后执行以下命令检查:
+
+.. literalinclude:: gentoo_dbus/check_session_bus
+   :language: bash
+   :caption: 通过环境变量确认session bus是否支持
+
+如果支持 session bus，则会显示一个 ``unix:path=`` 开头的字符串
+
+- 为确保 X 或 Wayland 会话中具备了 D-Bus session，则可以通过 ``dbus-launch`` 来启动窗口管理器(例如 :ref:`i3` , bspwm 等)
+
+.. literalinclude:: gentoo_dbus/dbus-launch
+   :language: bash
+   :caption: 使用 ``dbus-launch`` 来加载窗口管理器，确保窗口管理器会话支持 session bus
+
+使用dbus案例
+=============
+
+- 一些有用的命令
+
+  - ``dbus-monitor --system`` 监控system bus的活动
+  - ``dbus-monitor --session`` 监控session bus的活动
+  - ``dbus-send <PARAMETER>`` 发送消息
+
+- 观察dbus服务::
+
+   dbus-send --print-reply --dest=org.freedesktop.DBus /org/freedesktop/DBus org.freedesktop.DBus.ListNames
+
+- 当使用elogind时候作为普通用户关机或重启系统::
+
+   dbus-send --system --print-reply --dest=org.freedesktop.login1 /org/freedesktop/login1 org.freedesktop.login1.Manager.PowerOff boolean:false
+   dbus-send --system --print-reply --dest=org.freedesktop.login1 /org/freedesktop/login1 org.freedesktop.login1.Manager.Reboot boolean:false
+
+参考
+=======
+
+- `gentoo wiki: D-Bus <https://wiki.gentoo.org/wiki/D-Bus>`_

source/linux/gentoo_linux/gentoo_dbus/check_session_bus

@@ -0,0 +1 @@
+echo $DBUS_SESSION_BUS_ADDRESS

source/linux/gentoo_linux/gentoo_dbus/dbus-launch

@@ -0,0 +1 @@
+exec dbus-launch --exit-with-session i3

source/linux/gentoo_linux/gentoo_dbus/dbus_make.conf

@@ -0,0 +1 @@
+USE="dbus"

source/linux/gentoo_linux/gentoo_dbus/openrc_dbus

@@ -0,0 +1,2 @@
+/etc/init.d/dbus start
+rc-update add dbus default

source/linux/gentoo_linux/gentoo_dbus/rebuild_world_after_change_use

@@ -0,0 +1 @@
+emerge --ask --changed-use --deep @world

source/linux/gentoo_linux/index.rst

@@ -10,6 +10,7 @@ Gentoo Linux
    intro_gentoo.rst
    install_gentoo_on_mbp.rst
    upgrade_gentoo.rst
+   gentoo_dbus.rst
    gentoo_nvidia.rst
    gentoo_mbp_wifi.rst
    gentoo_kernel.rst