Class DBusDaemon.DBusServer
java.lang.Object
org.freedesktop.dbus.bin.DBusDaemon.DBusServer
- All Implemented Interfaces:
DBus, DBusInterface, Introspectable, Peer
- Enclosing class:
DBusDaemon
-
Nested Class Summary
Nested classes/interfaces inherited from interface DBus
DBus.NameAcquired, DBus.NameLost, DBus.NameOwnerChanged -
Field Summary
Fields inherited from interface DBus
DBUS_NAME_FLAG_ALLOW_REPLACEMENT, DBUS_NAME_FLAG_DO_NOT_QUEUE, DBUS_NAME_FLAG_REPLACE_EXISTING, DBUS_RELEASE_NAME_REPLY_NON_EXISTANT, DBUS_RELEASE_NAME_REPLY_NOT_OWNER, DBUS_RELEASE_NAME_REPLY_RELEASED, DBUS_REQUEST_NAME_REPLY_ALREADY_OWNER, DBUS_REQUEST_NAME_REPLY_EXISTS, DBUS_REQUEST_NAME_REPLY_IN_QUEUE, DBUS_REQUEST_NAME_REPLY_PRIMARY_OWNER, DBUS_START_REPLY_ALREADY_RUNNING, DBUS_START_REPLY_SUCCESS -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidAdd a match rule.Byte[]GetAdtAuditSessionData(String _busName) GetConnectionCredentials(String _busName) DBUS Specification:
Returns as many credentials as possible for the process connected to the server.Byte[]GetConnectionUnixProcessID(String _connectionName) Returns the proccess ID associated with a connection.GetConnectionUnixUser(String _connectionName) Get the Unix UID that owns a connection name.GetId()DBUS Specification:
Gets the unique ID of the bus.GetNameOwner(String _name) Get the connection unique name that owns the given name.Returns the path of this object.Hello()Initial message to register ourselves on the Bus.booleanisRemote()Returns true on remote objects.String[]Returns a list of all names that can be activated on the bus.String[]Lists all connected names on the Bus.String[]ListQueuedOwners(String _name) List the connections currently queued for a name.booleanNameHasOwner(String _name) Determine if a name has an owner.voidPing()ReleaseName(String _name) Release a name on the bus.voidRemoveMatch(String _matchrule) Remove a match rule.RequestName(String _name, UInt32 _flags) Request a name on the bus.StartServiceByName(String _name, UInt32 _flags) Start a service.voidUpdateActivationEnvironment(Map<String, String>[] _environment) DBUS Specification:
Normally, session bus activated services inherit the environment of the bus daemon.
-
Constructor Details
-
DBusServer
public DBusServer()
-
-
Method Details
-
isRemote
public boolean isRemote()Description copied from interface:DBusInterfaceReturns true on remote objects. Local objects implementing this interface MUST return false.- Specified by:
isRemotein interfaceDBusInterface- Returns:
- boolean
-
Hello
-
ListNames
-
NameHasOwner
Description copied from interface:DBusDetermine if a name has an owner.- Specified by:
NameHasOwnerin interfaceDBus- Parameters:
_name- The name to query.- Returns:
- true if the name has an owner.
-
GetNameOwner
Description copied from interface:DBusGet the connection unique name that owns the given name.- Specified by:
GetNameOwnerin interfaceDBus- Parameters:
_name- The name to query.- Returns:
- The connection which owns the name.
-
GetConnectionUnixUser
Description copied from interface:DBusGet the Unix UID that owns a connection name.- Specified by:
GetConnectionUnixUserin interfaceDBus- Parameters:
_connectionName- The connection name.- Returns:
- The Unix UID that it.
-
StartServiceByName
Description copied from interface:DBusStart a service. If the given service is not provided by any application, it will be started according to the .service file for that service.- Specified by:
StartServiceByNamein interfaceDBus- Parameters:
_name- The service name to start._flags- Unused.- Returns:
- DBUS_START_REPLY constants.
-
RequestName
-
ReleaseName
Description copied from interface:DBusRelease a name on the bus.- Specified by:
ReleaseNamein interfaceDBus- Parameters:
_name- The name to release.- Returns:
- DBUS_RELEASE_NAME_REPLY constants.
-
AddMatch
Description copied from interface:DBusAdd a match rule. Will cause you to receive messages that aren't directed to you which match this rule.- Specified by:
AddMatchin interfaceDBus- Parameters:
_matchrule- The Match rule as a string. Format Undocumented.- Throws:
MatchRuleInvalid
-
RemoveMatch
Description copied from interface:DBusRemove a match rule. Will cause you to stop receiving messages that aren't directed to you which match this rule.- Specified by:
RemoveMatchin interfaceDBus- Parameters:
_matchrule- The Match rule as a string. Format Undocumented.- Throws:
MatchRuleInvalid
-
ListQueuedOwners
Description copied from interface:DBusList the connections currently queued for a name.- Specified by:
ListQueuedOwnersin interfaceDBus- Parameters:
_name- The name to query- Returns:
- A list of unique connection IDs.
-
GetConnectionUnixProcessID
Description copied from interface:DBusReturns the proccess ID associated with a connection.- Specified by:
GetConnectionUnixProcessIDin interfaceDBus- Parameters:
_connectionName- The name of the connection- Returns:
- The PID of the connection.
-
GetConnectionSELinuxSecurityContext
Description copied from interface:DBusDBUS Specification:
Returns the security context used by SELinux, in an unspecified
format. If you know what this means, please contribute
documentation via the D-Bus bug tracking system.
This method is on the core DBus interface for historical reasons;
the same information should be made available via
the section called "org.freedesktop.DBus.GetConnectionCredentials”
in future.- Specified by:
GetConnectionSELinuxSecurityContextin interfaceDBus- Parameters:
_args- Unique or well-known bus name of the connection to query, such as :12.34 or com.example.tea- Returns:
- some sort of string of bytes, not necessarily UTF-8, not including '\0'
-
getObjectPath
Description copied from interface:DBusInterfaceReturns the path of this object.- Specified by:
getObjectPathin interfaceDBusInterface- Returns:
- string
-
Introspect
- Specified by:
Introspectin interfaceIntrospectable- Returns:
- The XML introspection data for this object
-
Ping
-
ListActivatableNames
Description copied from interface:DBusReturns a list of all names that can be activated on the bus.- Specified by:
ListActivatableNamesin interfaceDBus- Returns:
- Array of strings where each string is a bus name
-
GetConnectionCredentials
Description copied from interface:DBusDBUS Specification:
Returns as many credentials as possible for the process connected to the server. If unable to determine certain credentials (for instance, because the process is not on the same machine as the bus daemon, or because this version of the bus daemon does not support a particular security framework), or if the values of those credentials cannot be represented as documented here, then those credentials are omitted.Keys in the returned dictionary not containing "." are defined by this specification. Bus daemon implementors supporting credentials frameworks not mentioned in this document should either contribute patches to this specification, or use keys containing "." and starting with a reversed domain name.
- Specified by:
GetConnectionCredentialsin interfaceDBus- Parameters:
_busName- Unique or well-known bus name of the connection to query, such as :12.34 or com.example.tea- Returns:
- Credentials
-
GetAdtAuditSessionData
Description copied from interface:DBusDBUS Specification:
Returns auditing data used by Solaris ADT, in an unspecified
binary format. If you know what this means, please contribute
documentation via the D-Bus bug tracking system.
This method is on the core DBus interface for historical reasons;
the same information should be made available via
the section called "org.freedesktop.DBus.GetConnectionCredentials"
in future.- Specified by:
GetAdtAuditSessionDatain interfaceDBus- Parameters:
_busName- Unique or well-known bus name of the connection to query, such as :12.34 or com.example.tea- Returns:
- auditing data as returned by adt_export_session_data()
-
UpdateActivationEnvironment
Description copied from interface:DBusDBUS Specification:
Normally, session bus activated services inherit the environment of the bus daemon. This method adds to or modifies that environment when activating services. Some bus instances, such as the standard system bus, may disable access to this method for some or all callers. Note, both the environment variable names and values must be valid UTF-8. There's no way to update the activation environment with data that is invalid UTF-8.- Specified by:
UpdateActivationEnvironmentin interfaceDBus- Parameters:
_environment- Environment to add or update
-
GetId
Description copied from interface:DBusDBUS Specification:
Gets the unique ID of the bus. The unique ID here is shared among all addresses the
bus daemon is listening on (TCP, UNIX domain socket, etc.) and its format is described in
the section called "UUIDs”.
Each address the bus is listening on also has its own unique
ID, as described in the section called "Server Addresses”. The per-bus and per-address IDs are not related.
There is also a per-machine ID, described in the section called "org.freedesktop.DBus.Peer” and returned by org.freedesktop.DBus.Peer.GetMachineId().
For a desktop session bus, the bus ID can be used as a way to uniquely identify a user's session. -
GetMachineId
- Specified by:
GetMachineIdin interfacePeer
-