Main Page | Modules | Data Structures | File List | Data Fields | Related Pages

D-BUS interface org.freedesktop.Hal.AgentManager
[HAL daemon]

D-BUS interface for creating/destroying device objects. More...

Functions

DBusHandlerResult agent_manager_new_device (DBusConnection *connection, DBusMessage *message)
 Create a new device object which will be hidden from applications until the CommitToGdl() method is called.

DBusHandlerResult agent_manager_commit_to_gdl (DBusConnection *connection, DBusMessage *message)
 When a hidden device have been built (using the Device interface), a HAL agent can commit it to the global device list using this method.

DBusHandlerResult agent_manager_remove (DBusConnection *connection, DBusMessage *message)
 If a HAL agent determines that a device have been removed, this method can be called such that the HAL daemon can shutdown and possibly remove the device from the global device list (depending on the property Persistent).

DBusHandlerResult agent_merge_properties (DBusConnection *connection, DBusMessage *message)
 Merge properties one device to another.

DBusHandlerResult agent_device_matches (DBusConnection *connection, DBusMessage *message)
 Check a set of properties for two devices matches.

DBusHandlerResult filter_function (DBusConnection *connection, DBusMessage *message, void *user_data)
 Message handler for method invocations.

DBusConnection * hald_dbus_init (void)

Detailed Description

D-BUS interface for creating/destroying device objects.


Function Documentation

DBusHandlerResult agent_device_matches DBusConnection *  connection,
DBusMessage *  message
 

Check a set of properties for two devices matches.

Checks that all properties where keys, starting with a given value (namespace), of the first device is in the second device and that they got the same value and type.

Note that the other inclusion isn't tested, so there could be properties (from the given namespace) in the second device not present in the first device.

void AgentManager.DeviceMatches(object_reference device1, object_reference device, string namespace)

raises org.freedesktop.Hal.NoSuchDevice

Parameters:
connection D-BUS connection
message Message
Returns:
What to do with the message

Definition at line 1646 of file hald_dbus.c.

References DIE, raise_no_such_device(), and raise_syntax().

Referenced by filter_function().

DBusHandlerResult agent_manager_commit_to_gdl DBusConnection *  connection,
DBusMessage *  message
 

When a hidden device have been built (using the Device interface), a HAL agent can commit it to the global device list using this method.

This means that the device object will be visible to desktop applications and the HAL daemon will possibly attempt to boot the device (depending on the property RequireEnable).

The parameter given is the new unique-device-id, which should determined from bus-specific information.

void AgentManager.CommitToGdl(object_reference device, string new_object_name)

raises org.freedesktop.Hal.NoSuchDevice raises org.freedesktop.Hal.UdiInUse

Parameters:
connection D-BUS connection
message Message
Returns:
What to do with the message

Definition at line 1451 of file hald_dbus.c.

References DIE, raise_no_such_device(), raise_syntax(), and raise_udi_in_use().

Referenced by filter_function().

DBusHandlerResult agent_manager_new_device DBusConnection *  connection,
DBusMessage *  message
 

Create a new device object which will be hidden from applications until the CommitToGdl() method is called.

Returns an object that implements the org.freedesktop.Hal.Device interface.

object_reference AgentManager.NewDevice()

Parameters:
connection D-BUS connection
message Message
Returns:
What to do with the message

Definition at line 1398 of file hald_dbus.c.

References DIE.

Referenced by filter_function().

DBusHandlerResult agent_manager_remove DBusConnection *  connection,
DBusMessage *  message
 

If a HAL agent determines that a device have been removed, this method can be called such that the HAL daemon can shutdown and possibly remove the device from the global device list (depending on the property Persistent).

void AgentManager.Remove(object_reference device, string new_object_name)

raises org.freedesktop.Hal.NoSuchDevice

Parameters:
connection D-BUS connection
message Message
Returns:
What to do with the message

Definition at line 1518 of file hald_dbus.c.

References DIE, raise_no_such_device(), and raise_syntax().

Referenced by filter_function().

DBusHandlerResult agent_merge_properties DBusConnection *  connection,
DBusMessage *  message
 

Merge properties one device to another.

void AgentManager.MergeProperties(object_reference target, object_reference source)

raises org.freedesktop.Hal.NoSuchDevice

Parameters:
connection D-BUS connection
message Message
Returns:
What to do with the message

Definition at line 1576 of file hald_dbus.c.

References DIE, raise_no_such_device(), and raise_syntax().

Referenced by filter_function().

DBusHandlerResult filter_function DBusConnection *  connection,
DBusMessage *  message,
void *  user_data
[static]
 

Message handler for method invocations.

All invocations on any object or interface is routed through this function.

Parameters:
connection D-BUS connection
message Message
user_data User data
Returns:
What to do with the message

Definition at line 1708 of file hald_dbus.c.

References agent_device_matches(), agent_manager_commit_to_gdl(), agent_manager_new_device(), agent_manager_remove(), agent_merge_properties(), device_add_capability(), device_get_all_properties(), device_get_property(), device_get_property_type(), device_property_exists(), device_query_capability(), device_remove_property(), device_set_property(), manager_device_exists(), manager_find_device_by_capability(), manager_find_device_string_match(), manager_get_all_devices(), and osspec_filter_function().


Generated on Sat Apr 24 19:57:47 2004 for HAL by doxygen 1.3.6-20040222