org.freedesktop.dbus.interfaces.DBus Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of dbus-java-core Show documentation
Show all versions of dbus-java-core Show documentation
Improved version of the DBus-Java library provided by freedesktop.org (https://dbus.freedesktop.org/doc/dbus-java/).
package org.freedesktop.dbus.interfaces;
import java.util.Map;
import org.freedesktop.dbus.annotations.DBusInterfaceName;
import org.freedesktop.dbus.errors.MatchRuleInvalid;
import org.freedesktop.dbus.exceptions.DBusException;
import org.freedesktop.dbus.messages.DBusSignal;
import org.freedesktop.dbus.types.UInt32;
import org.freedesktop.dbus.types.Variant;
//CHECKSTYLE:OFF
@DBusInterfaceName("org.freedesktop.DBus")
public interface DBus extends DBusInterface {
int DBUS_NAME_FLAG_ALLOW_REPLACEMENT = 0x01;
int DBUS_NAME_FLAG_REPLACE_EXISTING = 0x02;
int DBUS_NAME_FLAG_DO_NOT_QUEUE = 0x04;
int DBUS_REQUEST_NAME_REPLY_PRIMARY_OWNER = 1;
int DBUS_REQUEST_NAME_REPLY_IN_QUEUE = 2;
int DBUS_REQUEST_NAME_REPLY_EXISTS = 3;
int DBUS_REQUEST_NAME_REPLY_ALREADY_OWNER = 4;
int DBUS_RELEASE_NAME_REPLY_RELEASED = 1;
int DBUS_RELEASE_NAME_REPLY_NON_EXISTANT = 2;
int DBUS_RELEASE_NAME_REPLY_NOT_OWNER = 3;
int DBUS_START_REPLY_SUCCESS = 1;
int DBUS_START_REPLY_ALREADY_RUNNING = 2;
/**
* Initial message to register ourselves on the Bus.
* @return The unique name of this connection to the Bus.
*/
String Hello();
/**
* Request a name on the bus.
* @param name The name to request.
* @param flags DBUS_NAME flags.
* @return DBUS_REQUEST_NAME_REPLY constants.
*/
UInt32 RequestName(String name, UInt32 flags);
/**
* Release a name on the bus.
* @param name The name to release.
* @return DBUS_RELEASE_NAME_REPLY constants.
*/
UInt32 ReleaseName(String name);
/**
* List the connections currently queued for a name.
* @param name The name to query
* @return A list of unique connection IDs.
*/
String[] ListQueuedOwners(String name);
/**
* Lists all connected names on the Bus.
* @return An array of all connected names.
*/
String[] ListNames();
/**
* Returns a list of all names that can be activated on the bus.
* @return Array of strings where each string is a bus name
*/
String[] ListActivatableNames();
/**
* Determine if a name has an owner.
* @param name The name to query.
* @return true if the name has an owner.
*/
boolean NameHasOwner(String name);
/**
* Signal sent when the owner of a name changes
*/
class NameOwnerChanged extends DBusSignal {
public final String name;
public final String oldOwner;
public final String newOwner;
public NameOwnerChanged(String path, String _name, String _oldOwner, String _newOwner) throws DBusException {
super(path, new Object[] {
_name, _oldOwner, _newOwner
});
this.name = _name;
this.oldOwner = _oldOwner;
this.newOwner = _newOwner;
}
}
/**
* Signal sent to a connection when it loses a name
*/
class NameLost extends DBusSignal {
public final String name;
public NameLost(String path, String _name) throws DBusException {
super(path, _name);
this.name = _name;
}
}
/**
* Signal sent to a connection when it aquires a name
*/
class NameAcquired extends DBusSignal {
public final String name;
public NameAcquired(String _path, String _name) throws DBusException {
super(_path, _name);
this.name = _name;
}
}
/**
* 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.
* @param name The service name to start.
* @param flags Unused.
* @return DBUS_START_REPLY constants.
*/
UInt32 StartServiceByName(String name, UInt32 flags);
/**
* 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.
*
* @param environment Environment to add or update
*/
void UpdateActivationEnvironment(Map[] environment);
/**
* Get the connection unique name that owns the given name.
* @param name The name to query.
* @return The connection which owns the name.
*/
String GetNameOwner(String name);
/**
* Get the Unix UID that owns a connection name.
* @param connection_name The connection name.
* @return The Unix UID that owns it.
*/
UInt32 GetConnectionUnixUser(String connection_name);
/**
* Returns the proccess ID associated with a connection.
* @param connection_name The name of the connection
* @return The PID of the connection.
*/
UInt32 GetConnectionUnixProcessID(String connection_name);
/**
* 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.
*
*
* @param busName Unique or well-known bus name of the connection to query, such as :12.34 or com.example.tea
* @return Credentials
*/
Map> GetConnectionCredentials(String busName);
/**
* 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.
*
* @param busName Unique or well-known bus name of the connection to query, such as :12.34 or com.example.tea
* @return auditing data as returned by adt_export_session_data()
*/
Byte[] GetAdtAuditSessionData(String busName);
/**
* 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.
*
* @param busName Unique or well-known bus name of the connection to query, such as :12.34 or com.example.tea
*
* @return some sort of string of bytes, not necessarily UTF-8, not including '\0'
*/
Byte[] GetConnectionSELinuxSecurityContext(String busName);
/**
* Add a match rule.
* Will cause you to receive messages that aren't directed to you which
* match this rule.
* @param matchrule The Match rule as a string. Format Undocumented.
*/
void AddMatch(String matchrule) throws MatchRuleInvalid;
/**
* Remove a match rule.
* Will cause you to stop receiving messages that aren't directed to you which
* match this rule.
* @param matchrule The Match rule as a string. Format Undocumented.
*/
void RemoveMatch(String matchrule) throws MatchRuleInvalid;
/**
* 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.
*
* @return id Unique ID identifying the bus daemon
*/
String GetId();
}
//CHECKSTYLE:ON