Introduction à D-Bus
D-Bus est un système de bus de
messages, une manière simple pour les applications de parler entre
elles. D-Bus fournit un démon
système (pour des événements tels que « nouveau périphérique
ajouté » ou « queue de l'imprimante
modifiée ») et un démon par session utilisateur
(pour les besoins IPC généraux des applications de l'utilisateur).
Le bus de messages est aussi construit au dessus d'un environnement
de passage de messages biunivoques, qui peut être utilisé par deux
applications pour communiquer directement (sans passer par le démon
de bus de message).
Ce paquet est connu pour pouvoir être construit et fonctionner
correctement avec une plateform 12.2.
Informations sur le paquet
-
Téléchargement (HTTP) :
https://dbus.freedesktop.org/releases/dbus/dbus-1.14.10.tar.xz
-
Téléchargement (FTP) :
-
Somme de contrôle MD5 du téléchargement :
46070a3487817ff690981f8cd2ba9376
-
Taille du téléchargement : 1,3 Mo
-
Estimation de l'espace disque requis : 23 Mo (plus
25 Mo pour les tests)
-
Estimation du temps de construction : 0,2 SBU (plus
1,5 SBU pour les tests)
Dépendances de D-Bus
Recommandées
Bibliothèques Xorg (pour le programme
dbus-launch)
Facultatives
Pour les tests : D-Bus
Python-1.3.2, PyGObject-3.48.2 et Valgrind-3.23.0 ;
pour la documentation : Doxygen-1.12.0, xmlto-0.0.29,
Ducktype et
Yelp Tools
Installation de D-Bus
Installez D-Bus en exécutant les
commandes suivantes (vous pouvez d'abord souhaiter observer la
sortie de ./configure
--help et ajouter des paramètres désirés à la
commande configure
affichée ci-dessous) :
./configure --prefix=/usr \
--sysconfdir=/etc \
--localstatedir=/var \
--runstatedir=/run \
--disable-doxygen-docs \
--disable-xml-docs \
--disable-static \
--with-systemduserunitdir=no \
--with-systemdsystemunitdir=no \
--docdir=/usr/share/doc/dbus-1.14.10 \
--with-system-socket=/run/dbus/system_bus_socket &&
make
Voir ci-dessous pour les instructions de test.
Maintenant, en tant qu'utilisateur root
:
make install
Si vous utilisez une installation DESTDIR, dbus-daemon-launch-helper doit
être corrigé. Tapez en tant qu'utilisateur root
:
chown -v root:messagebus /usr/libexec/dbus-daemon-launch-helper &&
chmod -v 4750 /usr/libexec/dbus-daemon-launch-helper
Si vous construisez toujours votre système en chroot ou que vous
n'avez pas encore lancé le démon, mais que vous souhaitez compiler
certains paquets dépendant de D-Bus, générez l'UUID D-Bus afin d'éviter les avertissements lors de
la compilation de certains paquets à l'aide de la commande suivante
en tant qu'utilisateur root
:
dbus-uuidgen --ensure
Si vous utilisez elogind-255.5, créez un lien symbolique vers le
fichier /var/lib/dbus/machine-id
:
ln -sfv /var/lib/dbus/machine-id /etc
De nombreux tests sont désactivés à moins d'avoir installé à la
fois D-Bus Python-1.3.2 et PyGObject-3.48.2. Ils doivent être lancés en
tant qu'utilisateur non privilégié depuis une session locale avec
une adresse de bus. Pour lancer la suite de tests standard, lancez
make check.
Si vous voulez lancer les tests unitaires, des paramètres
supplémentaires doivent être passés à configure qui exposent des
fonctionnalités supplémentaires dans les fichiers binaires mais ne
sont pas destinées à être utilisées dans une construction de
production de D-Bus. Si vous
souhaitez lancer les tests, tapez les commandes suivantes (pour les
tests, vous n'avez pas besoin de construire la doc) :
make distclean &&
PYTHON=python3 ./configure --enable-tests \
--enable-asserts \
--disable-doxygen-docs \
--disable-xml-docs &&
make &&
make check
Un test, test-autolaunch, est connu pour échouer. Il y a également
un signalement indiquant que les tests peuvent échouer s'ils sont
lancés depuis un shell Midnight Commander. Il se peut vous ayez des
messages d'erreur de dépassement de mémoire lors des tests. Ils
sont normaux et vous pouvez sans problème les ignorer.
Explication des commandes
--disable-doxygen-docs
: Ce
paramètre désactive la construction de la documentation doxygen et
son installation, si vous avez installé doxygen. Si doxygen est installé et que vous souhaitez
construire et l'installer, effacez ce paramètre.
--disable-xml-docs
:
Ce paramètre désactive la construction et l'installation de la
documentation html si vous avez installé xmlto. Supprimez-le, si xmlto est installé et que vous souhaitiez la
construire et l'installer.
--disable-static
: Ce
paramètre empêche l'installation des versions statiques des
bibliothèques.
--with-systemd{user,system}unitdir=no
:
Ce paramètre désactive l'installation des unités systemd sur les
systèmes basés sur elogind.
--with-system-socket=/run/dbus/system_bus_socket
:
Ce paramètre spécifie l'emplacement du socket du bus système.
--enable-tests
:
Construit des parties supplémentaires du code pour tous les tests.
N'utilisez pas ce paramètre pour une construction de production.
--enable-embedded-tests
:
Construit des parties supplémentaires du code pour prendre en
charge seulement les tests unitaires. N'utilisez pas ce paramètres
pour une construction de production.
--enable-asserts
:
Active le code de débogage pour exécuter des déclarations
d'éléments supposées normalement vrais. Cela empêche un
avertissement selon lequel '--enable-tests
' n'est utile en
lui-même que pour le profilage et il pourrait ne pas donner de bons
résultats pour tous les tests, mais il ajoute sa propre remarque
selon laquelle cela ne devrait pas être utilisé dans une
construction de production.
Configuration de D-Bus
Fichiers de
configuration
/etc/dbus-1/session.conf
,
/etc/dbus-1/system.conf
et
/etc/dbus-1/system.d/*
Informations sur la configuration
On ne devrait probablement pas modifier les fichiers de
configuration listés ci-dessus. Si des modifications sont
requises, vous devriez créer /etc/dbus-1/session-local.conf
ou /etc/dbus-1/system-local.conf
et effectuer les
changements désirés dans ces fichiers.
Si un paquet installe un fichier .service
de D-Bus hors du répertoire /usr/share/dbus-1/services
standard, vous
devriez ajouter ce répertoire à la configuration de la session
locale. Par exemple, /usr/local/share/dbus-1/services
peut être
ajouté en effectuant les commandes suivantes en tant
qu'utilisateur root
:
cat > /etc/dbus-1/session-local.conf << "EOF"
<!DOCTYPE busconfig PUBLIC
"-//freedesktop//DTD D-BUS Bus Configuration 1.0//EN"
"http://www.freedesktop.org/standards/dbus/1.0/busconfig.dtd">
<busconfig>
<!-- Search for .service files in /usr/local -->
<servicedir>/usr/local/share/dbus-1/services</servicedir>
</busconfig>
EOF
Démon de Session
D-Bus
Pour démarrer automatiquement dbus-daemon quand on redémarre
le système, installez le script de démarrage /etc/rc.d/init.d/dbus
depuis le paquet
blfs-bootscripts-20240416.
make install-dbus
Si c'est la première installation de D-Bus sur le système et que vous ne
travaillez pas dans un environnement chroot, vous pouvez
immédiatement démarrer dbus-daemon sans redémarrer le
système :
/etc/init.d/dbus start
Remarquez que ce script de démarrage ne démarre que démon
D-Bus de tout le système. Chaque
utilisateur ayant besoin d'un accès aux services de D-Bus devront exécuter en plus un démon de
session. Il y a beaucoup de méthodes utilisables pour démarrer un
démon de session en utilisant la commande dbus-launch. Revoyez la page de
man de dbus-launch
pour des détails sur les paramètres et les options disponibles.
Voici quelques suggestions et exemples :
-
Ajouter dbus-launch à la ligne
dans le fichier ~/.xinitrc
qui démarre votre environnement graphique.
-
Si vous utilisez gdm ou un autre
gestionnaire d'affichage qui appelle le fichier
~/.xsession
, vous pouvez
ajouter dbus-launch à la ligne
dans votre fichier ~/.xsession
qui démarre votre
environnement graphique. La syntaxe ressemblerait à celle
de l'exemple dans le fichier ~/.xinitrc
.
-
Les exemples montrés précédemment utilisent dbus-launch pour
spécifier un programme à exécuter. Ceci a le bénéfice
(quand on utilise également le paramètre --exit-with-x11
) de stopper
le démon de la session quand le programme spécifié est
stoppé. Vous pouvez également démarrer le démon de la
session dans vos scripts de démarrage du système ou
personnels en ajoutant les lignes suivantes :
# Start the D-Bus session daemon
eval `dbus-launch`
export DBUS_SESSION_BUS_ADDRESS
Cette méthode n'arrêtera pas le démon de session quand vous
quittez votre shell, donc vous devriez ajouter la ligne
suivante à votre fichier ~/.bash_logout
:
# Kill the D-Bus session daemon
kill $DBUS_SESSION_BUS_PID