class QDBusConnectionInterface#

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

Synopsis#

Methods#

def activatableServiceNames()
def isServiceRegistered()
def registerService()
def registeredServiceNames()
def serviceOwner()
def servicePid()
def serviceUid()
def startService()
def unregisterService()

Note

This documentation may contain snippets that were automatically translated from C++ to Python. We always welcome contributions to the snippet translation. If you see an issue with the translation, you can also let us know by creating a ticket on https:/bugreports.qt.io/projects/PYSIDE

Detailed Description#

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.

class ServiceQueueOptions#

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

Constant

Description

QDBusConnectionInterface.DontQueueService

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.

QDBusConnectionInterface.QueueService

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.

QDBusConnectionInterface.ReplaceExistingService

If another application already has the service name registered, attempt to replace it.

See also

ServiceReplacementOptions

Constant	Description
QDBusConnectionInterface.DontQueueService	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.
QDBusConnectionInterface.QueueService	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.
QDBusConnectionInterface.ReplaceExistingService	If another application already has the service name registered, attempt to replace it.

class ServiceReplacementOptions#

Flags for determining if the D-Bus server should allow another application to replace a name that this application has registered with the ReplaceExistingService option.

The possible values are:

Constant

Description

QDBusConnectionInterface.DontAllowReplacement

Do not allow another application to replace us. The service must be explicitly unregistered with unregisterService() for another application to acquire it. This is the default.

QDBusConnectionInterface.AllowReplacement

Allow other applications to replace us with the ReplaceExistingService option to registerService() without intervention. If that happens, the serviceUnregistered() signal will be emitted.

See also

ServiceQueueOptions

Constant	Description
QDBusConnectionInterface.DontAllowReplacement	Do not allow another application to replace us. The service must be explicitly unregistered with `unregisterService()` for another application to acquire it. This is the default.
QDBusConnectionInterface.AllowReplacement	Allow other applications to replace us with the `ReplaceExistingService` option to `registerService()` without intervention. If that happens, the `serviceUnregistered()` signal will be emitted.

class RegisterServiceReply#

The possible return values from registerService() :

Constant

Description

QDBusConnectionInterface.ServiceNotRegistered

The call failed and the service name was not registered.

QDBusConnectionInterface.ServiceRegistered

The caller is now the owner of the service name.

QDBusConnectionInterface.ServiceQueued

The caller specified the QueueService flag and the service was already registered, so we are in queue.

Constant	Description
QDBusConnectionInterface.ServiceNotRegistered	The call failed and the service name was not registered.
QDBusConnectionInterface.ServiceRegistered	The caller is now the owner of the service name.
QDBusConnectionInterface.ServiceQueued	The caller specified the `QueueService` flag and the service was already registered, so we are in queue.

The serviceRegistered() signal will be emitted when the service is acquired by this application.

NameAcquired(arg__1)#

Parameters:: arg__1 – str

NameLost(arg__1)#

Parameters:: arg__1 – str

NameOwnerChanged(arg__1, arg__2, arg__3)#

Parameters:

arg__1 – str
arg__2 – str
arg__3 – str

activatableServiceNames()#

Return type:: QDBusReply

callWithCallbackFailed(error, call)#

Parameters:

error – QDBusError
call – QDBusMessage

This signal is emitted when there is an error during a callWithCallback() . error specifies the error. call is the message that couldn’t be delivered.

See also

callWithCallback()

isServiceRegistered(arg__1)#

Parameters:: arg__1 – str
Return type:: QDBusReply

Returns true if the service name serviceName has is currently registered.

registerService(arg__1, arg__2, arg__3)#

Parameters:

arg__1 – str
arg__2 – ServiceQueueOptions
arg__3 – ServiceReplacementOptions

Return type:

QDBusReply

Requests to register the service name serviceName on the bus. The qoption flag specifies how the D-Bus server should behave if serviceName is already registered. The roption flag specifies if the server should allow another application to replace our registered name.

If the service registration succeeds, the serviceRegistered() signal will be emitted. If we are placed in queue, the signal will be emitted when we obtain the name. If roption is AllowReplacement , the serviceUnregistered() signal will be emitted if another application replaces this one.

See also

unregisterService()

registeredServiceNames()#

Return type:: QDBusReply

serviceOwner(arg__1)#

Parameters:: arg__1 – str
Return type:: 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.

serviceOwnerChanged(name, oldOwner, newOwner)#

Parameters:

name – str
oldOwner – str
newOwner – str

Use QDBusServiceWatcher instead.

This signal is emitted by the D-Bus server whenever a service ownership change happens in the bus, including apparition and disparition of names.

This signal means the application oldOwner lost ownership of bus name name to application newOwner. If oldOwner is an empty string, it means the name name has just been created; if newOwner is empty, the name name has no current owner and is no longer available.

Note

connecting to this signal will make the application listen for and receive every single service ownership change on the bus. Depending on how many services are running, this make the application be activated to receive more signals than it needs. To avoid this problem, use the QDBusServiceWatcher class, which can listen for specific changes.

servicePid(arg__1)#

Parameters:: arg__1 – str
Return type:: QDBusReply

Returns the Unix Process ID (PID) for the process currently holding the bus service serviceName.

serviceRegistered(service)#

Parameters:: service – str

This signal is emitted by the D-Bus server when the bus service name (unique connection name or well-known service name) given by service is acquired by this application.

Acquisition happens after this application has requested a name using registerService() .

serviceUid(arg__1)#

Parameters:: arg__1 – str
Return type:: QDBusReply

Returns the Unix User ID (UID) for the process currently holding the bus service serviceName.

serviceUnregistered(service)#

Parameters:: service – str

This signal is emitted by the D-Bus server when this application loses ownership of the bus service name given by service.

startService(arg__1)#

Parameters:: arg__1 – str
Return type:: QDBusReply

Requests that the bus start the service given by the name name.

unregisterService(arg__1)#

Parameters:: arg__1 – str
Return type:: 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.