org.freedesktop.dbus.bin

Class DBusDaemon.DBusServer

java.lang.Object

java.lang.Thread

org.freedesktop.dbus.bin.DBusDaemon.DBusServer

All Implemented Interfaces:

Runnable, DBus, DBusInterface, Introspectable, Peer

Enclosing class:

DBusDaemon

public class DBusDaemon.DBusServer
extends Thread
implements DBus, Introspectable, Peer

Nested Class Summary

Nested classes/interfaces inherited from class java.lang.Thread

Thread.State, Thread.UncaughtExceptionHandler

Nested classes/interfaces inherited from interface org.freedesktop.DBus

DBus.NameAcquired, DBus.NameLost, DBus.NameOwnerChanged

Field Summary

Fields

Modifier and Type	Field and Description
org.freedesktop.dbus.bin.DBusDaemon.Connstruct	c
Message	m

Fields inherited from class java.lang.Thread

MAX_PRIORITY, MIN_PRIORITY, NORM_PRIORITY

Fields inherited from interface org.freedesktop.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

Constructor and Description
DBusServer()

Method Summary

Modifier and Type	Method and Description
void	AddMatch(String matchrule) Add a match rule.
Byte[]	GetAdtAuditSessionData(String _busName) DBUS Specification: Returns auditing data used by Solaris ADT, in an unspecified binary format.
Map<String,Variant<?>>	GetConnectionCredentials(String _busName) DBUS Specification: Returns as many credentials as possible for the process connected to the server.
Byte[]	GetConnectionSELinuxSecurityContext(String a) DBUS Specification: Returns the security context used by SELinux, in an unspecified format.
UInt32	GetConnectionUnixProcessID(String connection_name) Returns the proccess ID associated with a connection.
UInt32	GetConnectionUnixUser(String connection_name) Get the Unix UID that owns a connection name.
String	GetId() DBUS Specification: Gets the unique ID of the bus.
String	GetMachineId()
String	GetNameOwner(String name) Get the connection unique name that owns the given name.
String	getObjectPath() Returns the path of this object.
String	Hello() Initial message to register ourselves on the Bus.
String	Introspect()
boolean	isRemote() Returns true on remote objects.
String[]	ListActivatableNames() Returns a list of all names that can be activated on the bus.
String[]	ListNames() Lists all connected names on the Bus.
String[]	ListQueuedOwners(String name) List the connections currently queued for a name.
boolean	NameHasOwner(String name) Determine if a name has an owner.
void	Ping()
UInt32	ReleaseName(String name) Release a name on the bus.
void	RemoveMatch(String matchrule) Remove a match rule.
UInt32	RequestName(String name, UInt32 flags) Request a name on the bus.
void	run()
UInt32	StartServiceByName(String name, UInt32 flags) Start a service.
void	UpdateActivationEnvironment(Map<String,String>[] _environment) DBUS Specification: Normally, session bus activated services inherit the environment of the bus daemon.

Methods inherited from class java.lang.Thread

activeCount, checkAccess, clone, countStackFrames, currentThread, destroy, dumpStack, enumerate, getAllStackTraces, getContextClassLoader, getDefaultUncaughtExceptionHandler, getId, getName, getPriority, getStackTrace, getState, getThreadGroup, getUncaughtExceptionHandler, holdsLock, interrupt, interrupted, isAlive, isDaemon, isInterrupted, join, join, join, resume, setContextClassLoader, setDaemon, setDefaultUncaughtExceptionHandler, setName, setPriority, setUncaughtExceptionHandler, sleep, sleep, start, stop, stop, suspend, toString, yield

Methods inherited from class java.lang.Object

equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

c

public org.freedesktop.dbus.bin.DBusDaemon.Connstruct c

m

public Message m

Constructor Detail

DBusServer

public DBusServer()

Method Detail

isRemote

public boolean isRemote()

Description copied from interface: DBusInterface

Returns true on remote objects. Local objects implementing this interface MUST return false.

Specified by:

isRemote in interface DBusInterface

Returns:

boolean

Hello

public String Hello()

Description copied from interface: DBus

Initial message to register ourselves on the Bus.

Specified by:

Hello in interface DBus

Returns:

The unique name of this connection to the Bus.

ListNames

public String[] ListNames()

Description copied from interface: DBus

Lists all connected names on the Bus.

Specified by:

ListNames in interface DBus

Returns:

An array of all connected names.

NameHasOwner

public boolean NameHasOwner(String name)

Description copied from interface: DBus

Determine if a name has an owner.

Specified by:

NameHasOwner in interface DBus

Parameters:

name - The name to query.

Returns:

true if the name has an owner.

GetNameOwner

public String GetNameOwner(String name)

Description copied from interface: DBus

Get the connection unique name that owns the given name.

Specified by:

GetNameOwner in interface DBus

Parameters:

name - The name to query.

Returns:

The connection which owns the name.

GetConnectionUnixUser

public UInt32 GetConnectionUnixUser(String connection_name)

Description copied from interface: DBus

Get the Unix UID that owns a connection name.

Specified by:

GetConnectionUnixUser in interface DBus

Parameters:

connection_name - The connection name.

Returns:

The Unix UID that owns it.

StartServiceByName

public UInt32 StartServiceByName(String name,
                                 UInt32 flags)

Description copied from interface: DBus

Start 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:

StartServiceByName in interface DBus

Parameters:

name - The service name to start.

flags - Unused.

Returns:

DBUS_START_REPLY constants.

RequestName

public UInt32 RequestName(String name,
                          UInt32 flags)

Description copied from interface: DBus

Request a name on the bus.

Specified by:

RequestName in interface DBus

Parameters:

name - The name to request.

flags - DBUS_NAME flags.

Returns:

DBUS_REQUEST_NAME_REPLY constants.

ReleaseName

public UInt32 ReleaseName(String name)

Description copied from interface: DBus

Release a name on the bus.

Specified by:

ReleaseName in interface DBus

Parameters:

name - The name to release.

Returns:

DBUS_RELEASE_NAME_REPLY constants.

AddMatch

public void AddMatch(String matchrule)
              throws MatchRuleInvalid

Description copied from interface: DBus

Add a match rule. Will cause you to receive messages that aren't directed to you which match this rule.

Specified by:

AddMatch in interface DBus

Parameters:

matchrule - The Match rule as a string. Format Undocumented.

Throws:

MatchRuleInvalid

RemoveMatch

public void RemoveMatch(String matchrule)
                 throws MatchRuleInvalid

Description copied from interface: DBus

Remove a match rule. Will cause you to stop receiving messages that aren't directed to you which match this rule.

Specified by:

RemoveMatch in interface DBus

Parameters:

matchrule - The Match rule as a string. Format Undocumented.

Throws:

MatchRuleInvalid

ListQueuedOwners

public String[] ListQueuedOwners(String name)

Description copied from interface: DBus

List the connections currently queued for a name.

Specified by:

ListQueuedOwners in interface DBus

Parameters:

name - The name to query

Returns:

A list of unique connection IDs.

GetConnectionUnixProcessID

public UInt32 GetConnectionUnixProcessID(String connection_name)

Description copied from interface: DBus

Returns the proccess ID associated with a connection.

Specified by:

GetConnectionUnixProcessID in interface DBus

Parameters:

connection_name - The name of the connection

Returns:

The PID of the connection.

GetConnectionSELinuxSecurityContext

public Byte[] GetConnectionSELinuxSecurityContext(String a)

Description copied from interface: DBus

DBUS 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:

GetConnectionSELinuxSecurityContext in interface DBus

Parameters:

a - 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

public String getObjectPath()

Description copied from interface: DBusInterface

Returns the path of this object.

Specified by:

getObjectPath in interface DBusInterface

Returns:

string

Introspect

public String Introspect()

Specified by:

Introspect in interface Introspectable

Returns:

The XML introspection data for this object

Ping

public void Ping()

Specified by:

Ping in interface Peer

run

public void run()

Specified by:

run in interface Runnable

Overrides:

run in class Thread

ListActivatableNames

public String[] ListActivatableNames()

Description copied from interface: DBus

Returns a list of all names that can be activated on the bus.

Specified by:

ListActivatableNames in interface DBus

Returns:

Array of strings where each string is a bus name

GetConnectionCredentials

public Map<String,Variant<?>> GetConnectionCredentials(String _busName)

Description copied from interface: DBus

DBUS 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:

GetConnectionCredentials in interface DBus

Parameters:

_busName - Unique or well-known bus name of the connection to query, such as :12.34 or com.example.tea

Returns:

Credentials

GetAdtAuditSessionData

public Byte[] GetAdtAuditSessionData(String _busName)

Description copied from interface: DBus

DBUS 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:

GetAdtAuditSessionData in interface DBus

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

public void UpdateActivationEnvironment(Map<String,String>[] _environment)

Description copied from interface: DBus

DBUS 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:

UpdateActivationEnvironment in interface DBus

Parameters:

_environment - Environment to add or update

GetId

public String GetId()

Description copied from interface: DBus

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

Specified by:

GetId in interface DBus

Returns:

id Unique ID identifying the bus daemon

GetMachineId

public String GetMachineId()

Specified by:

GetMachineId in interface Peer