D-BUS-1.6.8

Introduction à D-BUS

D-BUS est un système bus de message, 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 aligné sur la session de l'utilisateur (pour les besoins IPC généraux des applications de l'utilisateur). Le bus de message est aussi construit au sommet d'un environnement de passage de message entre éléments général, 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 se construire correctement sur une plateforme LFS-7.2.

Informations sur le paquet

Dépendances de D-BUS

Requises

expat-2.1.0 ou libxml2-2.9.0

Recommandées

Facultatives

D-Bus GLib Bindings-0.100 (pour lancer les tests), Python-2.7.3 (pour lancer les tests) et Doxygen-1.8.2 (pour générer la documentation API)

Notez que le script configure regardera dans xmlto-0.0.25 mais il ne fait rien car la documentation XML/HTML est déjà incluse dans l'arborescence des sources.

Notes utilisateur : http://wiki.linuxfromscratch.org/blfs/wiki/dbus

Installation de D-BUS

En tant qu'utilisateur root, créez un utilisateur et un groupe systèmes pour gérer l'activité du bus de messages système :

groupadd -g 18 messagebus &&
useradd -c "D-BUS Message Daemon User" -d /var/run/dbus         -u 18 -g messagebus -s /bin/false messagebus

Installez D-BUS en lançant 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  \
    --libexecdir=/usr/lib/dbus-1.0   \
    --with-console-auth-dir=/run/console/    \
    --without-systemdsystemunitdir     \
    --disable-systemd  \
    --disable-static &&
 make

Voir ci-dessous pour les instructions de test.

Maintenant, en tant qu'utilisateur root :

make install &&
mv -v /usr/share/doc/dbus /usr/share/doc/dbus-1.6.8

Si vous construisez 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 paquet à l'aide de la commande suivante en utilisateur root :

dbus-uuidgen --ensure

Les tests dbus ne peuvent pas être lancé tant que D-Bus GLib Bindings-0.100 n'est pas installé. Les tests requierent de passer des paramètres supplémentaires à configure et d'avoir des fonctionnalités supplémentaires dans les fichiers binaires. Ces interfaces ne sont pas destinés à être utilisées dans une construction de production de D-BUS. Si vous souhaitez lancer la suite de tests, tapez les commandes suivantes :

make distclean &&
./configure --enable-tests --enable-asserts &&
make &&
make check &&
make distclean

Notez qu'il y a un rapport indiquant que les tests peuvent échouer s'ils sont lancés depuis un shell Midnight Commander. Il se peut vous 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

--with-console-auth-dir=/run/console/ : Ce paramètre specifit l'emplacement du répertoire d'authentification de ConsoleKit.

--without-systemdsystemunitdir : Ce switch empêche l'installation des fichiers de service de systemd.

--disable-systemd : Cette option désactive le support de systemd dans D-Bus

--disable-static : Ce paramètre empêche l'installation des versions statiques des bibliothèques.

--enable-tests : Construit des parties supplémentaires du code pour les tests. Configure se terminera avec un avertissement NOTE à ce propos.

--enable-asserts : Active le code de débogage pour exécuter des déclarations d'éléments supposées normalement vraies. 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 bon 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 dbus

Fichiers de configuration

/etc/dbus-1/session.conf, /etc/dbus-1/system.conf et /etc/dbus-1/system.d/*

Informations de 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 et/ou /etc/dbus-1/system-local.conf et faire les changements désirés à 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

Script de démarrage

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-20120828.

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 xdm 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édement utilise dbus-launch pour spécifier un programme à executer. Ceci à 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 commencer le démon de la session dans vos scripts de démarrage du système où personels 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
    
  • Une astuce a été écrite offrant des moyens de démarrer des scripts utilisant le gestionnaire de sessions KDM de KDE. Les concepts de cette astuce pourraient être éventuellement utilisés aussi avec d'autres gestionnaires de session. L'astuce se trouve sur http://www.linuxfromscratch.org/hints/downloads/files/execute-session-scripts-using-kdm.txt.

Contenu

Programmes installés: dbus-cleanup-sockets, dbus-daemon, dbus-launch, dbus-monitor, dbus-send et dbus-uuidgen
Bibliothèque installée: libdbus-1.so
Répertoires installés: /etc/dbus-1, /usr/include/dbus-1.0, /usr/lib/dbus-1.0, /usr/share/dbus-1, /usr/share/doc/dbus-1.6.8 et /var/lib/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-send

est utilisé pour envoyer un message à un bus de messages D-BUS.

dbus-uuidgen

est utilisé pour générer ou lire un ID unique universel.

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 messages.

Last updated on : 2012-07-23 17:22:48 +020