QDBusConnectionInterface¶

PyQt5.QtDBus.QDBusConnectionInterface: Inherits from QDBusAbstractInterface.

Description¶

The QDBusConnectionInterface class provides access to the D-Bus bus daemon service.

The D-Bus bus server daemon provides one special interface org.freedesktop.DBus that allows clients to access certain properties of the bus, such as the current list of clients connected. The QDBusConnectionInterface class provides access to that interface.

The most common uses of this class are to register and unregister service names on the bus using the registerService() and unregisterService() functions, query about existing names using the isServiceRegistered(), registeredServiceNames() and serviceOwner() functions, and to receive notification that a client has registered or de-registered through the serviceRegistered, serviceUnregistered and serviceOwnerChanged signals.

Enums¶

RegisterServiceReply

TODO

Member	Value	Description
ServiceNotRegistered	TODO	TODO
ServiceQueued	TODO	TODO
ServiceRegistered	TODO	TODO

ServiceQueueOptions

Flags for determining how a service registration should behave, in case the service name is already registered.

Methods¶

activatableServiceNames() → QDBusReply: TODO

connectNotify(QMetaMethod): TODO

disconnectNotify(QMetaMethod): TODO

isServiceRegistered(str) → QDBusReply: Returns true if the service name serviceName has is currently registered.

registeredServiceNames() → QDBusReply: TODO

registerService(str, qoption: ServiceQueueOptions = DontQueueService, roption: ServiceReplacementOptions = DontAllowReplacement) → QDBusReply: TODO

serviceOwner(str) → QDBusReply: Returns the unique connection name of the primary owner of the name name. If the requested name doesn’t have an owner, returns a org.freedesktop.DBus.Error.NameHasNoOwner error.

servicePid(str) → QDBusReply: Returns the Unix Process ID (PID) for the process currently holding the bus service serviceName.

serviceUid(str) → QDBusReply: Returns the Unix User ID (UID) for the process currently holding the bus service serviceName.

startService(str) → QDBusReply: Requests that the bus start the service given by the name name.

unregisterService(str) → QDBusReply: Releases the claim on the bus service name serviceName, that had been previously registered with registerService(). If this application had ownership of the name, it will be released for other applications to claim. If it only had the name queued, it gives up its position in the queue.

Signals¶

callWithCallbackFailed(QDBusError, QDBusMessage): TODO

serviceOwnerChanged(str, str, str): TODO

serviceRegistered(str): TODO

serviceUnregistered(str): TODO

Member	Value	Description
DontQueueService	0	If an application requests a name that is already owned, no queueing will be performed. The registeredService() call will simply fail. This is the default.
QueueService	1	Attempts to register the requested service, but do not try to replace it if another application already has it registered. Instead, simply put this application in queue, until it is given up. The serviceRegistered signal will be emitted when that happens.
ReplaceExistingService	2	If another application already has the service name registered, attempt to replace it.