Qt D-Bus Descripción general
D-Bus es un mecanismo de comunicación entre procesos (IPC) y de llamada a procedimientos remotos (RPC) desarrollado originalmente para Linux con el fin de sustituir las soluciones de IPC existentes y competidoras por un único protocolo unificado. También se diseñó para permitir la comunicación entre procesos a nivel del sistema (como los servicios de impresoras y controladores de hardware) y los procesos normales de los usuarios.
Utiliza un protocolo rápido de paso de mensajes binarios, adecuado para la comunicación dentro de una misma máquina gracias a su baja latencia y su reducida sobrecarga. Su especificación está definida actualmente por el proyecto freedesktop.org y está disponible para todas las partes.
La comunicación, en general, se produce a través de una aplicación de servidor central denominada «bus» (de ahí su nombre), aunque también es posible la comunicación directa entre aplicaciones. Al comunicarse a través del bus, las aplicaciones pueden consultar qué otras aplicaciones y servicios están disponibles, así como activar uno de ellos bajo demanda.
Los buses
Los buses de D-Bus se utilizan cuando se desea una comunicación «muchos a muchos». Para lograrlo, se inicia un servidor central antes de que ninguna aplicación pueda conectarse al bus. Este servidor se encarga de realizar un seguimiento de las aplicaciones conectadas y de enrutar correctamente los mensajes desde su origen hasta su destino.
Además, D-Bus define dos buses muy conocidos, denominados «bus del sistema» y «bus de sesión». Estos buses son especiales en el sentido de que tienen una semántica bien definida: algunos servicios están definidos para encontrarse en uno de estos buses o en ambos.
Por ejemplo, una aplicación que desee consultar la lista de dispositivos de hardware conectados al ordenador probablemente se comunicará con un servicio disponible en el bus del sistema, mientras que el servicio que permite abrir el navegador web del usuario probablemente se encontrará en el bus de sesión.
En el bus del sistema, también cabe esperar que existan restricciones sobre qué servicios puede ofrecer cada aplicación. Por lo tanto, se puede estar razonablemente seguro de que, si un determinado servicio está presente, lo ofrece una aplicación de confianza.
Conceptos
Mensajes
A bajo nivel, las aplicaciones se comunican a través de D-Bus enviándose mensajes entre sí. Los mensajes se utilizan para transmitir las llamadas a procedimientos remotos, así como las respuestas y los errores asociados a ellas. Cuando se utilizan a través de un bus, los mensajes tienen un destino, lo que significa que se enrutan únicamente a las partes interesadas, evitando así la congestión debida al «swarming» o a la difusión generalizada.
Sin embargo, un tipo especial de mensaje denominado «mensaje de señal» (un concepto basado en el mecanismo de señales y ranuras de Qt) no tiene un destino predefinido. Dado que su finalidad es utilizarse en un contexto de uno a muchos, los mensajes de señal están diseñados para funcionar mediante un mecanismo de «opt-in».
El módulo Qt D-Bus encapsula por completo el concepto de bajo nivel de los mensajes en un enfoque más sencillo y orientado a objetos, con el que están familiarizados los desarrolladores de Qt. En la mayoría de los casos, el desarrollador no tiene que preocuparse por el envío o la recepción de mensajes.
Nombres de servicio
Al comunicarse a través de un bus, las aplicaciones obtienen lo que se denomina un «nombre de servicio»: es la forma en que esa aplicación decide darse a conocer a otras aplicaciones del mismo bus. Los nombres de servicio son gestionados por el demonio del bus D-Bus y se utilizan para enrutar mensajes de una aplicación a otra. Un concepto análogo a los nombres de servicio son las direcciones IP y los nombres de host: un ordenador suele tener una dirección IP y puede tener uno o más nombres de host asociados, según los servicios que preste a la red.
Por otro lado, si no se utiliza un bus, tampoco se utilizan los nombres de servicio. Si volvemos a comparar esto con una red de ordenadores, equivaldría a una red punto a punto: dado que se conoce al par, no hay necesidad de utilizar nombres de host para encontrarlo ni su dirección IP.
El formato de un nombre de servicio de D-Bus es, de hecho, muy similar al de un nombre de host: se trata de una secuencia de letras y dígitos separados por puntos. La práctica habitual es incluso nombrar el servicio según el nombre de dominio de la organización que lo definió.
Por ejemplo, el servicio D-Bus está definido por freedesktop.org y se puede encontrar en el bus con el nombre de servicio:
org.freedesktop.DBusRutas de objetos
Al igual que los hosts de red, las aplicaciones proporcionan servicios específicos a otras aplicaciones mediante la exportación de objetos. Dichos objetos están organizados jerárquicamente, de forma muy similar a la relación padre-hijo que poseen las clases derivadas de QObject. Sin embargo, una diferencia es que existe el concepto de «objeto raíz», que todos los objetos tienen como padre último.
Si continuamos con nuestra analogía con los servicios web, las rutas de objetos equivalen a la parte de la ruta de una URL:

Al igual que estos, las rutas de objetos en D-Bus se forman de manera similar a los nombres de ruta del sistema de archivos: son etiquetas separadas por barras, cada una de las cuales consta de letras, dígitos y el carácter de subrayado («_»). Deben comenzar siempre con una barra y no deben terminar con ella.
Interfaces
Las interfaces son similares a las clases abstractas de C++ y a la palabra clave « interface » de Java, y declaran el «contrato» que se establece entre el llamante y el llamado. Es decir, establecen los nombres de los métodos, señales y propiedades que están disponibles, así como el comportamiento que se espera de ambas partes cuando se establece la comunicación.
Qt utiliza un mecanismo muy similar en su sistema de complementos: las clases base en C++ se asocian a un identificador único mediante la macro Q_DECLARE_INTERFACE().
Los nombres de las interfaces de Qt D-Bus, de hecho, se denominan de manera similar a lo que sugiere el sistema de complementos de Qt: un identificador construido normalmente a partir del nombre de dominio de la entidad que definió dicha interfaz.
Hoja de referencia
Para facilitar el recuerdo de los formatos de nomenclatura y sus finalidades, se puede utilizar la siguiente tabla:
| Concepto de D-Bus | Analogía | Formato del nombre |
|---|---|---|
| Nombre del servicio | Nombres de host de red | Separados por puntos («parece un nombre de host») |
| Ruta del objeto | Componente de ruta de la URL | Separados por barras («parece una ruta») |
| Interfaz | Identificador de complemento | Separado por puntos |
Depuración
Al desarrollar aplicaciones que utilizan D-Bus, a veces resulta útil poder ver información sobre los mensajes que envía y recibe cada aplicación a través del bus.
Esta función se puede activar para cada aplicación configurando la variable de entorno ` QDBUS_DEBUG ` antes de ejecutar cada aplicación. Por ejemplo, podemos activar la depuración solo para el coche en el ejemplo «Coche teledirigido con D-Bus» ejecutando el controlador y el coche de la siguiente manera:
examples/dbus/remotecontrolledcar/controller/controller &
QDBUS_DEBUG=1 examples/dbus/remotecontrolledcar/car/car &La información sobre los mensajes se mostrará en la consola desde la que se haya iniciado la aplicación.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.