dbus-1.14.0
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).
![[Note]](../images/note.png)
Note
Development versions of BLFS may not build or run some packages
properly if dependencies have been updated since the most recent
stable versions of the book.
Informations sur le paquet
-
Téléchargement (HTTP) :
https://dbus.freedesktop.org/releases/dbus/dbus-1.14.0.tar.xz
-
Téléchargement (FTP) :
-
Somme de contrôle MD5 : ddd5570aff05191dbee8e42d751f1b7d
-
Taille du téléchargement : 1,3 Mo
-
Estimation de l'espace disque requis : 21 Mo (plus 18 Mo
pour les tests)
-
Estimation du temps de construction : 0,3 SBU (plus 8,0
SBU pour les tests)
Dépendances de D-Bus
Recommandées
Bibliothèques Xorg (pour le programme
dubs-launch)
et elogind-246.10 (il y a une dépendance
circulaire. Construisez d'abord sans cette dépendance, puis de
nouveau après l'installation des deux paquets)
Facultatives
Pour les tests : dbus-glib-0.112, D-Bus
Python-1.2.18, PyGObject-3.42.2 et Valgrind-3.19.0 ;
pour la documentation : Doxygen-1.9.4, xmlto-0.0.28,
Ducktype et
Yelp Tools
Notes utilisateur : https://wiki.linuxfromscratch.org/blfs/wiki/dbus
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 \
--enable-user-session \
--disable-doxygen-docs \
--disable-xml-docs \
--disable-static \
--with-systemduserunitdir=no \
--with-systemdsystemunitdir=no \
--docdir=/usr/share/doc/dbus-1.14.0 \
--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-246.10, créez un lien symbolique vers
le fichier /var/lib/dbus/machine-id :
ln -sv /var/lib/dbus/machine-id /etc
Les tests de dbus ne peuvent pas être lancés avant l'installation
de dbus-glib-0.112. 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
Il y a 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.
--enable-user-session : Ce
paramètre active les sessions utilisateurs DBus avec elogind.
--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-pid-file=/run/dbus/pid :
Ce paramètre spécifie l'endroit pour le fichier PID.
--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-20220722.
make install-dbus
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.
-
L'exemple montré précédemment utilise dbus-launch pour
spécifier un programme à exécuter. Ceci a le bénéfice
(quand on utilise également le paramètre --exit-with-session) 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
Contenu
Programmes installés:
dbus-cleanup-sockets, dbus-daemon,
dbus-launch, dbus-monitor, dbus-run-session, dbus-send,
dbus-test-tool, dbus-update-activation-environment et
dbus-uuidgen
Bibliothèque installée:
libdbus-1.so
Répertoires installés:
/etc/dbus-1, /usr/{include,lib}/dbus-1.0,
/usr/lib/cmake/DBus1, /usr/share/dbus-1, /usr/share/xml/dbus-1,
/usr/share/doc/dbus-1.14.0, et /var/{lib,run}/dbus
Descriptions courtes
|
dbus-cleanup-sockets
|
nettoie les sockets superflus dans un répertoire
|
|
dbus-daemon
|
est le démon de bus de messages D-Bus
|
|
dbus-launch
|
est utilisé pour démarrer dbus-daemon depuis un
script shell. Il est en principe appelé par des scripts
de connexion d'un utilisateur
|
|
dbus-monitor
|
est utilisé pour surveiller les messages à travers un bus
de messages D-Bus
|
|
dbus-run-session
|
démarre un processus comme une nouvelle session
D-Bus
|
|
dbus-send
|
est utilisé pour envoyer un message à un bus de messages
D-Bus
|
|
dbus-test-tool
|
est un générateur de trafic D-Bus et un outil de tests ;
c'est un outil multi-usage pour le débogage et le
profilage de D-Bus
|
|
dbus-update-activation-environment
|
est utilisé pour mettre à jour l'environnement utilisé
pour les services de session de D-Bus ; il met à jour la liste
des variables d'environnement utilisées par dbus-daemon --session
quand il active les services de session sans utiliser
systemd
|
|
dbus-uuidgen
|
est utilisé pour générer ou lire un ID universellement
unique
|
|
libdbus-1.so
|
contient les fonctions de l'API utilisées par le démon de
messages D-Bus.
D-Bus est d'abord une
bibliothèque qui fournit une communication directe entre
deux applications ; dbus-daemon est une
application qui utilise cette bibliothèque pour
implémenter un démon de bus de message
|
Last updated on