Hardware authentication for Linux using ordinary USB Flash Drives.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 

5228 lines
135 KiB

/***************************************************************************
* CVSID: $Id$
*
* libhal.c : HAL daemon C convenience library
*
* Copyright (C) 2003 David Zeuthen, <david@fubar.dk>
* Copyright (C) 2006 Sjoerd Simons, <sjoerd@luon.net>
* Copyright (C) 2007 Codethink Ltd. Author Rob Taylor <rob.taylor@codethink.co.uk>
*
* Licensed under the Academic Free License version 2.1
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
*
**************************************************************************/
#ifdef HAVE_CONFIG_H
# include <config.h>
#endif
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <dbus/dbus.h>
#include "uthash.h"
#include "libhal.h"
#ifdef ENABLE_NLS
# include <libintl.h>
# define _(String) dgettext (GETTEXT_PACKAGE, String)
# ifdef gettext_noop
# define N_(String) gettext_noop (String)
# else
# define N_(String) (String)
# endif
#else
/* Stubs that do something close enough. */
# define textdomain(String) (String)
# define gettext(String) (String)
# define dgettext(Domain,Message) (Message)
# define dcgettext(Domain,Message,Type) (Message)
# define bindtextdomain(Domain,Directory) (Domain)
# define _(String)
# define N_(String) (String)
#endif
/**
* LIBHAL_CHECK_PARAM_VALID:
* @_param_: the prameter to check for
* @_name_: the name of the prameter (for debug output)
* @_ret_: what to use for return value if the prameter is NULL
*
* Handy macro for checking whether a parameter is valid and not NULL.
*/
#define LIBHAL_CHECK_PARAM_VALID(_param_,_name_,_ret_) \
do { \
if (_param_ == NULL) { \
fprintf (stderr, \
"%s %d : invalid paramater. %s is NULL.\n", \
__FILE__, __LINE__, _name_); \
return _ret_; \
} \
} while(0)
/**
* LIBHAL_CHECK_UDI_VALID:
* @_udi_: the UID to check for
* @_ret_: what to use for return value if udi is invalid
*
* Handy macro for checking whether a UID is valid and not NULL.
*/
#define LIBHAL_CHECK_UDI_VALID(_udi_,_ret_) \
do { \
if (_udi_ == NULL) { \
fprintf (stderr, \
"%s %d : invalid udi %s. udi is NULL.\n", \
__FILE__, __LINE__, _udi_); \
return _ret_; \
} else { \
if(strncmp(_udi_, "/org/freedesktop/Hal/devices/", 29) != 0) { \
fprintf (stderr, \
"%s %d : invalid udi: %s doesn't start" \
"with '/org/freedesktop/Hal/devices/'. \n", \
__FILE__, __LINE__, _udi_); \
return _ret_; \
} \
} \
} while(0)
static char **libhal_get_string_array_from_iter (DBusMessageIter *iter, int *num_elements);
static dbus_bool_t libhal_property_fill_value_from_variant (LibHalProperty *p, DBusMessageIter *var_iter);
/**
* libhal_free_string_array:
* @str_array: the array to be freed
*
* Frees a NULL-terminated array of strings. If passed NULL, does nothing.
*/
void
libhal_free_string_array (char **str_array)
{
if (str_array != NULL) {
int i;
for (i = 0; str_array[i] != NULL; i++) {
free (str_array[i]);
str_array[i] = NULL;
}
free (str_array);
str_array = NULL;
}
}
/**
* libhal_get_string_array_from_iter:
* @iter: the message iterator to extract the strings from
* @num_elements: pointer to an integer where to store number of elements (can be NULL)
*
* Creates a NULL terminated array of strings from a dbus message iterator.
*
* Returns: pointer to the string array
*/
static char **
libhal_get_string_array_from_iter (DBusMessageIter *iter, int *num_elements)
{
int count;
char **buffer;
char **t;
count = 0;
buffer = (char **)malloc (sizeof (char *) * 8);
if (buffer == NULL)
goto oom;
buffer[0] = NULL;
while (dbus_message_iter_get_arg_type (iter) == DBUS_TYPE_STRING) {
const char *value;
char *str;
if ((count % 8) == 0 && count != 0) {
t = realloc (buffer, sizeof (char *) * (count + 8));
if (t == NULL)
goto oom;
else
buffer = t;
}
dbus_message_iter_get_basic (iter, &value);
str = strdup (value);
if (str == NULL)
goto oom;
buffer[count] = str;
dbus_message_iter_next(iter);
count++;
}
if ((count % 8) == 0) {
t = realloc (buffer, sizeof (char *) * (count + 1));
if (t == NULL)
goto oom;
else
buffer = t;
}
buffer[count] = NULL;
if (num_elements != NULL)
*num_elements = count;
return buffer;
oom:
if (buffer != NULL)
free (buffer);
fprintf (stderr, "%s %d : error allocating memory\n", __FILE__, __LINE__);
return NULL;
}
/**
* libhal_free_string:
* @str: the nul-terminated sting to free
*
* Used to free strings returned by libhal.
*/
void
libhal_free_string (char *str)
{
if (str != NULL) {
free (str);
str = NULL;
}
}
/**
* LibHalPropertySet:
*
* Represents a set of properties. Opaque; use the
* libhal_property_set_*() family of functions to access it.
*/
struct LibHalPropertySet_s {
LibHalProperty *properties;
};
/**
* LibHalProperty:
*
* Represents a property. Opaque.
*/
struct LibHalProperty_s {
LibHalPropertyType type; /**< Type of property */
char *key; /**< ASCII string */
/** Possible values of the property */
union {
char *str_value; /**< UTF-8 zero-terminated string */
dbus_int32_t int_value; /**< 32-bit signed integer */
dbus_uint64_t uint64_value; /**< 64-bit unsigned integer */
double double_value; /**< IEEE754 double precision float */
dbus_bool_t bool_value; /**< Truth value */
char **strlist_value; /**< List of UTF-8 zero-terminated strings */
} v;
UT_hash_handle hh; /*makes this hashable*/
};
/**
* LibHalContext:
*
* Context for connection to the HAL daemon. Opaque, use the
* libhal_ctx_*() family of functions to access it.
*/
struct LibHalContext_s {
DBusConnection *connection; /**< D-BUS connection */
dbus_bool_t is_initialized; /**< Are we initialised */
dbus_bool_t is_shutdown; /**< Have we been shutdown */
dbus_bool_t cache_enabled; /**< Is the cache enabled */
dbus_bool_t is_direct; /**< Whether the connection to hald is direct */
/** Device added */
LibHalDeviceAdded device_added;
/** Device removed */
LibHalDeviceRemoved device_removed;
/** Device got a new capability */
LibHalDeviceNewCapability device_new_capability;
/** Device got a new capability */
LibHalDeviceLostCapability device_lost_capability;
/** A property of a device changed */
LibHalDevicePropertyModified device_property_modified;
/** A non-continous event on the device occured */
LibHalDeviceCondition device_condition;
/** A global interface lock is acquired */
LibHalGlobalInterfaceLockAcquired global_interface_lock_acquired;
/** A global interface lock is released */
LibHalGlobalInterfaceLockReleased global_interface_lock_released;
/** An interface lock is acquired */
LibHalInterfaceLockAcquired interface_lock_acquired;
/** An interface lock is released */
LibHalInterfaceLockReleased interface_lock_released;
/** Singleton device added */
LibHalSingletonDeviceAdded singleton_device_added;
/** Singleton device removed*/
LibHalSingletonDeviceRemoved singleton_device_removed;
void *user_data; /**< User data */
};
/**
* libhal_ctx_set_user_data:
* @ctx: the context for the connection to hald
* @user_data: user data
*
* Set user data for the context.
*
* Returns: TRUE if user data was successfully set, FALSE if otherwise
*/
dbus_bool_t
libhal_ctx_set_user_data(LibHalContext *ctx, void *user_data)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
ctx->user_data = user_data;
return TRUE;
}
/**
* libhal_ctx_get_user_data:
* @ctx: the context for the connection to hald
*
* Get user data for the context.
*
* Returns: opaque pointer stored through libhal_ctx_set_user_data() or NULL if not set.
*/
void*
libhal_ctx_get_user_data(LibHalContext *ctx)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, NULL);
return ctx->user_data;
}
/**
* libhal_property_fill_value_from_variant:
* @p: the property to fill in
* @var_iter: variant iterator to extract the value from
*
* Fills in the value for the LibHalProperty given a variant iterator.
*
* Returns: Whether the value was put in.
*/
static dbus_bool_t
libhal_property_fill_value_from_variant (LibHalProperty *p, DBusMessageIter *var_iter)
{
DBusMessageIter iter_array;
LIBHAL_CHECK_PARAM_VALID(p, "LibHalProperty *p", FALSE);
LIBHAL_CHECK_PARAM_VALID(var_iter, "DBusMessageIter *var_iter", FALSE);
switch (p->type) {
case DBUS_TYPE_ARRAY:
if (dbus_message_iter_get_element_type (var_iter) != DBUS_TYPE_STRING)
return FALSE;
dbus_message_iter_recurse (var_iter, &iter_array);
p->v.strlist_value = libhal_get_string_array_from_iter (&iter_array, NULL);
p->type = LIBHAL_PROPERTY_TYPE_STRLIST;
break;
case DBUS_TYPE_STRING:
{
const char *v;
dbus_message_iter_get_basic (var_iter, &v);
p->v.str_value = strdup (v);
if (p->v.str_value == NULL)
return FALSE;
p->type = LIBHAL_PROPERTY_TYPE_STRING;
break;
}
case DBUS_TYPE_INT32:
{
dbus_int32_t v;
dbus_message_iter_get_basic (var_iter, &v);
p->v.int_value = v;
p->type = LIBHAL_PROPERTY_TYPE_INT32;
break;
}
case DBUS_TYPE_UINT64:
{
dbus_uint64_t v;
dbus_message_iter_get_basic (var_iter, &v);
p->v.uint64_value = v;
p->type = LIBHAL_PROPERTY_TYPE_UINT64;
break;
}
case DBUS_TYPE_DOUBLE:
{
double v;
dbus_message_iter_get_basic (var_iter, &v);
p->v.double_value = v;
p->type = LIBHAL_PROPERTY_TYPE_DOUBLE;
break;
}
case DBUS_TYPE_BOOLEAN:
{
double v;
dbus_message_iter_get_basic (var_iter, &v);
p->v.double_value = v;
p->type = LIBHAL_PROPERTY_TYPE_BOOLEAN;
break;
}
default:
/** @todo report error */
break;
}
return TRUE;
}
static LibHalPropertySet *
get_property_set (DBusMessageIter *iter)
{
LibHalPropertySet *result;
DBusMessageIter dict_iter;
result = malloc (sizeof (LibHalPropertySet));
if (result == NULL)
goto oom;
/*
result->properties = malloc(sizeof(LibHalProperty)*result->num_properties);
if( result->properties==NULL )
{
/// @todo cleanup
return NULL;
}
*/
result->properties = NULL;
if (dbus_message_iter_get_arg_type (iter) != DBUS_TYPE_ARRAY &&
dbus_message_iter_get_element_type (iter) != DBUS_TYPE_DICT_ENTRY) {
fprintf (stderr, "%s %d : error, expecting an array of dict entries\n",
__FILE__, __LINE__);
free (result);
return NULL;
}
dbus_message_iter_recurse (iter, &dict_iter);
while (dbus_message_iter_get_arg_type (&dict_iter) == DBUS_TYPE_DICT_ENTRY)
{
DBusMessageIter dict_entry_iter, var_iter;
const char *key;
LibHalProperty *p;
dbus_message_iter_recurse (&dict_iter, &dict_entry_iter);
dbus_message_iter_get_basic (&dict_entry_iter, &key);
p = malloc (sizeof (LibHalProperty));
if (p == NULL)
goto oom;
p->key = strdup (key);
if (p->key == NULL) {
free (p);
goto oom;
}
dbus_message_iter_next (&dict_entry_iter);
dbus_message_iter_recurse (&dict_entry_iter, &var_iter);
p->type = (LibHalPropertyType) dbus_message_iter_get_arg_type (&var_iter);
if (!libhal_property_fill_value_from_variant (p, &var_iter)) {
free (p);
goto oom;
}
HASH_ADD_KEYPTR (hh, result->properties, p->key, strlen (p->key), p);
dbus_message_iter_next (&dict_iter);
}
return result;
oom:
if (result != NULL)
libhal_free_property_set (result);
fprintf (stderr,
"%s %d : error allocating memory\n",
__FILE__, __LINE__);
return NULL;
}
/**
* libhal_device_get_all_properties:
* @ctx: the context for the connection to hald
* @udi: the Unique id of device
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Retrieve all the properties on a device.
*
* Returns: An object represent all properties. Must be freed with libhal_free_property_set().
*/
LibHalPropertySet *
libhal_device_get_all_properties (LibHalContext *ctx, const char *udi, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter reply_iter;
LibHalPropertySet *result;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, NULL);
LIBHAL_CHECK_UDI_VALID(udi, NULL);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"GetAllProperties");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return NULL;
}
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
fprintf (stderr,
"%s %d : %s\n",
__FILE__, __LINE__, error->message);
return NULL;
}
if (reply == NULL) {
return NULL;
}
dbus_message_iter_init (reply, &reply_iter);
result = get_property_set (&reply_iter);
dbus_message_unref (reply);
return result;
}
static int
key_sort (LibHalProperty *a, LibHalProperty *b)
{
return strcmp (a->key, b->key);
}
/**
* libhal_property_set_sort:
* @set: property-set to sort
*
* Sort all properties according to property name.
*/
void
libhal_property_set_sort (LibHalPropertySet *set)
{
if (set == NULL)
return;
HASH_SORT (set->properties, key_sort);
}
/**
* libhal_free_property_set:
* @set: property-set to free
*
* Free a property set earlier obtained with libhal_device_get_all_properties().
*/
void
libhal_free_property_set (LibHalPropertySet * set)
{
LibHalProperty *p, *p_old;
if (set == NULL)
return;
for (p = set->properties; p != NULL;) {
HASH_DELETE (hh, set->properties, p);
free (p->key);
if (p->type == DBUS_TYPE_STRING)
free (p->v.str_value);
if (p->type == LIBHAL_PROPERTY_TYPE_STRLIST)
libhal_free_string_array (p->v.strlist_value);
p_old = p;
p = p->hh.next;
free (p_old);
}
free (set);
}
/**
* libhal_property_set_get_num_elems:
* @set: property set to consider
*
* Get the number of properties in a property set.
*
* Returns: number of properties in given property set
*/
unsigned int
libhal_property_set_get_num_elems (LibHalPropertySet *set)
{
unsigned int num_elems;
LibHalProperty *p;
LIBHAL_CHECK_PARAM_VALID(set, "*set", 0);
num_elems = 0;
for (p = set->properties; p != NULL; p = p->hh.next)
num_elems++;
return num_elems;
}
static LibHalProperty *
property_set_lookup (const LibHalPropertySet *set, const char *key)
{
LibHalProperty *p;
LIBHAL_CHECK_PARAM_VALID(set, "*set", NULL);
LIBHAL_CHECK_PARAM_VALID(key, "*key", NULL);
HASH_FIND_STR (set->properties, key, p);
return p;
}
/**
* libhal_ps_get_type:
* @set: property set
* @key: name of property to inspect
*
* Get the type of a given property.
*
* Returns: the #LibHalPropertyType of the given property,
* LIBHAL_PROPERTY_TYPE_INVALID if property is not in the set
*/
LibHalPropertyType
libhal_ps_get_type (const LibHalPropertySet *set, const char *key)
{
LibHalProperty *p;
LIBHAL_CHECK_PARAM_VALID(set, "*set", LIBHAL_PROPERTY_TYPE_INVALID);
LIBHAL_CHECK_PARAM_VALID(key, "*key", LIBHAL_PROPERTY_TYPE_INVALID);
p = property_set_lookup (set, key);
if (p) return p->type;
else return LIBHAL_PROPERTY_TYPE_INVALID;
}
/**
* libhal_ps_get_string:
* @set: property set
* @key: name of property to inspect
*
* Get the value of a property of type string.
*
* Returns: UTF8 nul-terminated string. This pointer is only valid
* until libhal_free_property_set() is invoked on the property set
* this property belongs to. NULL if property is not in the set or not a string
*/
const char *
libhal_ps_get_string (const LibHalPropertySet *set, const char *key)
{
LibHalProperty *p;
LIBHAL_CHECK_PARAM_VALID(set, "*set", NULL);
LIBHAL_CHECK_PARAM_VALID(key, "*key", NULL);
p = property_set_lookup (set, key);
if (p && p->type == LIBHAL_PROPERTY_TYPE_STRING)
return p->v.str_value;
else return NULL;
}
/**
* libhal_ps_get_int:
* @set: property set
* @key: name of property to inspect
*
* Get the value of a property of type signed integer.
*
* Returns: property value (32-bit signed integer)
*/
dbus_int32_t
libhal_ps_get_int32 (const LibHalPropertySet *set, const char *key)
{
LibHalProperty *p;
LIBHAL_CHECK_PARAM_VALID(set, "*set", 0);
LIBHAL_CHECK_PARAM_VALID(key, "*key", 0);
p = property_set_lookup (set, key);
if (p && p->type == LIBHAL_PROPERTY_TYPE_INT32)
return p->v.int_value;
else return 0;
}
/**
* libhal_ps_get_uint64:
* @set: property set
* @key: name of property to inspect
*
* Get the value of a property of type unsigned integer.
*
* Returns: property value (64-bit unsigned integer)
*/
dbus_uint64_t
libhal_ps_get_uint64 (const LibHalPropertySet *set, const char *key)
{
LibHalProperty *p;
LIBHAL_CHECK_PARAM_VALID(set, "*set", 0);
LIBHAL_CHECK_PARAM_VALID(key, "*key", 0);
p = property_set_lookup (set, key);
if (p && p->type == LIBHAL_PROPERTY_TYPE_UINT64)
return p->v.uint64_value;
else return 0;
}
/**
* libhal_ps_get_double:
* @set: property set
* @key: name of property to inspect
*
* Get the value of a property of type double.
*
* Returns: property value (IEEE754 double precision float)
*/
double
libhal_ps_get_double (const LibHalPropertySet *set, const char *key)
{
LibHalProperty *p;
LIBHAL_CHECK_PARAM_VALID(set, "*set", 0.0);
LIBHAL_CHECK_PARAM_VALID(key, "*key", 0.0);
p = property_set_lookup (set, key);
if (p && p->type == LIBHAL_PROPERTY_TYPE_DOUBLE)
return p->v.double_value;
else return 0.0;
}
/**
* libhal_ps_get_bool:
* @set: property set
* @key: name of property to inspect
*
* Get the value of a property of type bool.
*
* Returns: property value (bool)
*/
dbus_bool_t
libhal_ps_get_bool (const LibHalPropertySet *set, const char *key)
{
LibHalProperty *p;
LIBHAL_CHECK_PARAM_VALID(set, "*set", FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
p = property_set_lookup (set, key);
if (p && p->type == LIBHAL_PROPERTY_TYPE_BOOLEAN)
return p->v.bool_value;
else return FALSE;
}
/**
* libhal_ps_get_strlist:
* @set: property set
* @key: name of property to inspect
*
* Get the value of a property of type string list.
*
* Returns: pointer to array of strings, this is owned by the property set
*/
const char *const *
libhal_ps_get_strlist (const LibHalPropertySet *set, const char *key)
{
LibHalProperty *p;
LIBHAL_CHECK_PARAM_VALID(set, "*set", NULL);
LIBHAL_CHECK_PARAM_VALID(key, "*key", NULL);
p = property_set_lookup (set, key);
if (p && p->type == LIBHAL_PROPERTY_TYPE_STRLIST)
return (const char *const *) p->v.strlist_value;
else return NULL;
}
/**
* libhal_psi_init:
* @iter: iterator object
* @set: property set to iterate over
*
* Initialize a property set iterator.
*
*/
void
libhal_psi_init (LibHalPropertySetIterator * iter, LibHalPropertySet * set)
{
if (set == NULL)
return;
iter->set = set;
iter->idx = -1; //deprecated
iter->cur_prop = set->properties;
}
/**
* libhal_psi_has_more:
* @iter: iterator object
*
* Determine whether there are more properties to iterate over.
*
* Returns: TRUE if there are more properties, FALSE otherwise.
*/
dbus_bool_t
libhal_psi_has_more (LibHalPropertySetIterator * iter)
{
return (iter->cur_prop != NULL);
}
/**
* libhal_psi_next:
* @iter: iterator object
*
* Advance iterator to next property.
*/
void
libhal_psi_next (LibHalPropertySetIterator * iter)
{
iter->cur_prop = iter->cur_prop->hh.next;
}
/**
* libhal_psi_get_type:
* @iter: iterator object
*
* Get type of property.
*
* Returns: the property type at the iterator's position
*/
LibHalPropertyType
libhal_psi_get_type (LibHalPropertySetIterator * iter)
{
return iter->cur_prop->type;
}
/**
* libhal_psi_get_key:
* @iter: iterator object
*
* Get the key of a property.
*
* Returns: ASCII nul-terminated string. This pointer is only valid
* until libhal_free_property_set() is invoked on the property set
* this property belongs to.
*/
char *
libhal_psi_get_key (LibHalPropertySetIterator * iter)
{
return iter->cur_prop->key;
}
/**
* libhal_psi_get_string:
* @iter: iterator object
*
* Get the value of a property of type string.
*
* Returns: UTF8 nul-terminated string. This pointer is only valid
* until libhal_free_property_set() is invoked on the property set
* this property belongs to.
*/
char *
libhal_psi_get_string (LibHalPropertySetIterator * iter)
{
return iter->cur_prop->v.str_value;
}
/**
* libhal_psi_get_int:
* @iter: iterator object
*
* Get the value of a property of type signed integer.
*
* Returns: property value (32-bit signed integer)
*/
dbus_int32_t
libhal_psi_get_int (LibHalPropertySetIterator * iter)
{
return iter->cur_prop->v.int_value;
}
/**
* libhal_psi_get_uint64:
* @iter: iterator object
*
* Get the value of a property of type unsigned integer.
*
* Returns: property value (64-bit unsigned integer)
*/
dbus_uint64_t
libhal_psi_get_uint64 (LibHalPropertySetIterator * iter)
{
return iter->cur_prop->v.uint64_value;
}
/**
* libhal_psi_get_double:
* @iter: iterator object
*
* Get the value of a property of type double.
*
* Returns: property value (IEEE754 double precision float)
*/
double
libhal_psi_get_double (LibHalPropertySetIterator * iter)
{
return iter->cur_prop->v.double_value;
}
/**
* libhal_psi_get_bool:
* @iter: iterator object
*
* Get the value of a property of type bool.
*
* Returns: property value (bool)
*/
dbus_bool_t
libhal_psi_get_bool (LibHalPropertySetIterator * iter)
{
return iter->cur_prop->v.bool_value;
}
/**
* libhal_psi_get_strlist:
* @iter: iterator object
*
* Get the value of a property of type string list.
*
* Returns: pointer to array of strings
*/
char **
libhal_psi_get_strlist (LibHalPropertySetIterator * iter)
{
return iter->cur_prop->v.strlist_value;
}
static DBusHandlerResult
singleton_device_changed (LibHalContext *ctx, DBusConnection *connection, DBusMessage *msg, dbus_bool_t added)
{
DBusMessage *reply;
DBusMessageIter iter;
LibHalPropertySet *set;
const char *udi;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, DBUS_HANDLER_RESULT_NOT_YET_HANDLED);
dbus_message_iter_init (msg, &iter);
/* First should be the device UDI */
if (dbus_message_iter_get_arg_type (&iter) != DBUS_TYPE_STRING)
goto malformed;
dbus_message_iter_get_basic (&iter, &udi);
dbus_message_iter_next (&iter);
/* then the property set*/
set = get_property_set (&iter);
if (!set)
goto malformed;
if (added)
(ctx->singleton_device_added)(ctx, udi, set);
else
(ctx->singleton_device_removed)(ctx, udi, set);
libhal_free_property_set (set);
reply = dbus_message_new_method_return (msg);
if (reply == NULL)
goto oom;
if (!dbus_connection_send (connection, reply, NULL)) {
dbus_message_unref (reply);
goto oom;
}
dbus_message_unref (reply);
return DBUS_HANDLER_RESULT_HANDLED;
malformed:
fprintf (stderr, "%s %d : singlton device changed message malformed\n", __FILE__, __LINE__);
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
oom:
fprintf (stderr, "%s %d : error allocating memory\n", __FILE__, __LINE__);
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
}
static DBusHandlerResult
filter_func (DBusConnection * connection,
DBusMessage * message, void *user_data)
{
const char *object_path;
DBusError error;
LibHalContext *ctx = (LibHalContext *) user_data;
if (ctx->is_shutdown)
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
dbus_error_init (&error);
object_path = dbus_message_get_path (message);
/*fprintf (stderr, "*** libhal filer_func: connection=%p obj_path=%s interface=%s method=%s\n",
connection,
dbus_message_get_path (message),
dbus_message_get_interface (message),
dbus_message_get_member (message));
*/
if (dbus_message_is_signal (message, "org.freedesktop.Hal.Manager",
"DeviceAdded")) {
char *udi;
if (dbus_message_get_args (message, &error,
DBUS_TYPE_STRING, &udi,
DBUS_TYPE_INVALID)) {
if (ctx->device_added != NULL) {
ctx->device_added (ctx, udi);
}
} else {
LIBHAL_FREE_DBUS_ERROR(&error);
}
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
} else if (dbus_message_is_signal (message, "org.freedesktop.Hal.Manager", "DeviceRemoved")) {
char *udi;
if (dbus_message_get_args (message, &error,
DBUS_TYPE_STRING, &udi,
DBUS_TYPE_INVALID)) {
if (ctx->device_removed != NULL) {
ctx->device_removed (ctx, udi);
}
} else {
LIBHAL_FREE_DBUS_ERROR(&error);
}
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
} else if (dbus_message_is_signal (message, "org.freedesktop.Hal.Manager","NewCapability")) {
char *udi;
char *capability;
if (dbus_message_get_args (message, &error,
DBUS_TYPE_STRING, &udi,
DBUS_TYPE_STRING, &capability,
DBUS_TYPE_INVALID)) {
if (ctx->device_new_capability != NULL) {
ctx->device_new_capability (ctx, udi, capability);
}
} else {
LIBHAL_FREE_DBUS_ERROR(&error);
}
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
} else if (dbus_message_is_signal (message, "org.freedesktop.Hal.Manager","GlobalInterfaceLockAcquired")) {
char *lock_name;
char *lock_owner;
int num_locks;
if (dbus_message_get_args (message, &error,
DBUS_TYPE_STRING, &lock_name,
DBUS_TYPE_STRING, &lock_owner,
DBUS_TYPE_INT32, &num_locks,
DBUS_TYPE_INVALID)) {
if (ctx->global_interface_lock_acquired != NULL) {
ctx->global_interface_lock_acquired (ctx, lock_name, lock_owner, num_locks);
}
} else {
LIBHAL_FREE_DBUS_ERROR(&error);
}
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
} else if (dbus_message_is_signal (message, "org.freedesktop.Hal.Manager","GlobalInterfaceLockReleased")) {
char *lock_name;
char *lock_owner;
int num_locks;
if (dbus_message_get_args (message, &error,
DBUS_TYPE_STRING, &lock_name,
DBUS_TYPE_STRING, &lock_owner,
DBUS_TYPE_INT32, &num_locks,
DBUS_TYPE_INVALID)) {
if (ctx->global_interface_lock_released != NULL) {
ctx->global_interface_lock_released (ctx, lock_name, lock_owner, num_locks);
}
} else {
LIBHAL_FREE_DBUS_ERROR(&error);
}
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
} else if (dbus_message_is_signal (message, "org.freedesktop.Hal.Device", "Condition")) {
char *condition_name;
char *condition_detail;
if (dbus_message_get_args (message, &error,
DBUS_TYPE_STRING, &condition_name,
DBUS_TYPE_STRING, &condition_detail,
DBUS_TYPE_INVALID)) {
if (ctx->device_condition != NULL) {
ctx->device_condition (ctx, object_path, condition_name, condition_detail);
}
} else {
LIBHAL_FREE_DBUS_ERROR(&error);
}
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
} else if (dbus_message_is_signal (message, "org.freedesktop.Hal.Device","InterfaceLockAcquired")) {
char *lock_name;
char *lock_owner;
int num_locks;
if (dbus_message_get_args (message, &error,
DBUS_TYPE_STRING, &lock_name,
DBUS_TYPE_STRING, &lock_owner,
DBUS_TYPE_INT32, &num_locks,
DBUS_TYPE_INVALID)) {
if (ctx->interface_lock_acquired != NULL) {
ctx->interface_lock_acquired (ctx, object_path, lock_name, lock_owner, num_locks);
}
} else {
LIBHAL_FREE_DBUS_ERROR(&error);
}
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
} else if (dbus_message_is_signal (message, "org.freedesktop.Hal.Device","InterfaceLockReleased")) {
char *lock_name;
char *lock_owner;
int num_locks;
if (dbus_message_get_args (message, &error,
DBUS_TYPE_STRING, &lock_name,
DBUS_TYPE_STRING, &lock_owner,
DBUS_TYPE_INT32, &num_locks,
DBUS_TYPE_INVALID)) {
if (ctx->interface_lock_released != NULL) {
ctx->interface_lock_released (ctx, object_path, lock_name, lock_owner, num_locks);
}
} else {
LIBHAL_FREE_DBUS_ERROR(&error);
}
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
} else if (dbus_message_is_signal (message, "org.freedesktop.Hal.Device", "PropertyModified")) {
if (ctx->device_property_modified != NULL) {
int i;
char *key;
dbus_bool_t removed;
dbus_bool_t added;
int num_modifications;
DBusMessageIter iter;
DBusMessageIter iter_array;
dbus_message_iter_init (message, &iter);
dbus_message_iter_get_basic (&iter, &num_modifications);
dbus_message_iter_next (&iter);
dbus_message_iter_recurse (&iter, &iter_array);
for (i = 0; i < num_modifications; i++) {
DBusMessageIter iter_struct;
dbus_message_iter_recurse (&iter_array, &iter_struct);
dbus_message_iter_get_basic (&iter_struct, &key);
dbus_message_iter_next (&iter_struct);
dbus_message_iter_get_basic (&iter_struct, &removed);
dbus_message_iter_next (&iter_struct);
dbus_message_iter_get_basic (&iter_struct, &added);
ctx->device_property_modified (ctx,
object_path,
key, removed,
added);
dbus_message_iter_next (&iter_array);
}
}
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
} else if (dbus_message_is_method_call (message,
"org.freedesktop.Hal.SingletonAddon",
"DeviceAdded") &&
strcmp (dbus_message_get_path (message),
"/org/freedesktop/Hal/SingletonAddon") == 0) {
return singleton_device_changed (ctx, connection, message, TRUE);
} else if (dbus_message_is_method_call (message,
"org.freedesktop.Hal.SingletonAddon",
"DeviceRemoved") &&
strcmp (dbus_message_get_path (message),
"/org/freedesktop/Hal/SingletonAddon") == 0) {
return singleton_device_changed (ctx, connection, message, FALSE);
}
return DBUS_HANDLER_RESULT_NOT_YET_HANDLED;
}
/**
* libhal_get_all_devices:
* @ctx: the context for the connection to hald
* @num_devices: the number of devices will be stored here
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Get all devices in the Global Device List (GDL).
*
* Returns: An array of device identifiers terminated with NULL. It is
* the responsibility of the caller to free with
* libhal_free_string_array(). If an error occurs NULL is returned.
*/
char **
libhal_get_all_devices (LibHalContext *ctx, int *num_devices, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter_array, reply_iter;
char **hal_device_names;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, NULL);
*num_devices = 0;
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"GetAllDevices");
if (message == NULL) {
fprintf (stderr, "%s %d : Could not allocate D-BUS message\n", __FILE__, __LINE__);
return NULL;
}
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection, message, -1, &_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return NULL;
}
if (reply == NULL) {
return NULL;
}
/* now analyze reply */
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_ARRAY) {
fprintf (stderr, "%s %d : wrong reply from hald. Expecting an array.\n", __FILE__, __LINE__);
dbus_message_unref (reply);
return NULL;
}
dbus_message_iter_recurse (&reply_iter, &iter_array);
hal_device_names = libhal_get_string_array_from_iter (&iter_array, num_devices);
dbus_message_unref (reply);
return hal_device_names;
}
/**
* libhal_device_get_property_type:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Query a property type of a device.
*
* Returns: A LibHalPropertyType. LIBHAL_PROPERTY_TYPE_INVALID is
* return if the property doesn't exist.
*/
LibHalPropertyType
libhal_device_get_property_type (LibHalContext *ctx, const char *udi, const char *key, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, reply_iter;
LibHalPropertyType type;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, LIBHAL_PROPERTY_TYPE_INVALID); /* or return NULL? */
LIBHAL_CHECK_UDI_VALID(udi, LIBHAL_PROPERTY_TYPE_INVALID);
LIBHAL_CHECK_PARAM_VALID(key, "*key", LIBHAL_PROPERTY_TYPE_INVALID);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"GetPropertyType");
if (message == NULL) {
fprintf (stderr, "%s %d : Couldn't allocate D-BUS message\n", __FILE__, __LINE__);
return LIBHAL_PROPERTY_TYPE_INVALID;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return LIBHAL_PROPERTY_TYPE_INVALID;
}
if (reply == NULL) {
return LIBHAL_PROPERTY_TYPE_INVALID;
}
dbus_message_iter_init (reply, &reply_iter);
dbus_message_iter_get_basic (&reply_iter, &type);
dbus_message_unref (reply);
return type;
}
/**
* libhal_device_get_property_strlist:
* @ctx: the context for the connection to hald
* @udi: unique Device Id
* @key: name of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Get the value of a property of type string list.
*
* Returns: Array of pointers to UTF8 nul-terminated strings
* terminated by NULL. The caller is responsible for freeing this
* string array with the function libhal_free_string_array(). Returns
* NULL if the property didn't exist or we are OOM
*/
char **
libhal_device_get_property_strlist (LibHalContext *ctx, const char *udi, const char *key, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, iter_array, reply_iter;
char **our_strings;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, NULL);
LIBHAL_CHECK_UDI_VALID(udi, NULL);
LIBHAL_CHECK_PARAM_VALID(key, "*key", NULL);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"GetPropertyStringList");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return NULL;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return NULL;
}
if (reply == NULL) {
return NULL;
}
/* now analyse reply */
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_ARRAY) {
fprintf (stderr, "%s %d : wrong reply from hald. Expecting an array.\n", __FILE__, __LINE__);
dbus_message_unref (reply);
return NULL;
}
dbus_message_iter_recurse (&reply_iter, &iter_array);
our_strings = libhal_get_string_array_from_iter (&iter_array, NULL);
dbus_message_unref (reply);
return our_strings;
}
/**
* libhal_device_get_property_string:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: the name of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Get the value of a property of type string.
*
* Returns: UTF8 nul-terminated string. The caller is responsible for
* freeing this string with the function libhal_free_string(). Returns
* NULL if the property didn't exist or we are OOM.
*/
char *
libhal_device_get_property_string (LibHalContext *ctx,
const char *udi, const char *key, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, reply_iter;
char *value;
char *dbus_str;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, NULL);
LIBHAL_CHECK_UDI_VALID(udi, NULL);
LIBHAL_CHECK_PARAM_VALID(key, "*key", NULL);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"GetPropertyString");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return NULL;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return NULL;
}
if (reply == NULL) {
return NULL;
}
dbus_message_iter_init (reply, &reply_iter);
/* now analyze reply */
if (dbus_message_iter_get_arg_type (&reply_iter) !=
DBUS_TYPE_STRING) {
dbus_message_unref (reply);
return NULL;
}
dbus_message_iter_get_basic (&reply_iter, &dbus_str);
value = (char *) ((dbus_str != NULL) ? strdup (dbus_str) : NULL);
if (value == NULL) {
fprintf (stderr, "%s %d : error allocating memory\n",
__FILE__, __LINE__);
}
dbus_message_unref (reply);
return value;
}
/**
* libhal_device_get_property_int:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Get the value of a property of type integer.
*
* Returns: Property value (32-bit signed integer)
*/
dbus_int32_t
libhal_device_get_property_int (LibHalContext *ctx,
const char *udi, const char *key, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, reply_iter;
dbus_int32_t value;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, -1);
LIBHAL_CHECK_UDI_VALID(udi, -1);
LIBHAL_CHECK_PARAM_VALID(key, "*key", -1);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"GetPropertyInteger");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return -1;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return -1;
}
if (reply == NULL) {
return -1;
}
dbus_message_iter_init (reply, &reply_iter);
/* now analyze reply */
if (dbus_message_iter_get_arg_type (&reply_iter) !=
DBUS_TYPE_INT32) {
fprintf (stderr,
"%s %d : property '%s' for device '%s' is not "
"of type integer\n", __FILE__, __LINE__, key,
udi);
dbus_message_unref (reply);
return -1;
}
dbus_message_iter_get_basic (&reply_iter, &value);
dbus_message_unref (reply);
return value;
}
/**
* libhal_device_get_property_uint64:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Get the value of a property of type signed integer.
*
* Returns: Property value (64-bit unsigned integer)
*/
dbus_uint64_t
libhal_device_get_property_uint64 (LibHalContext *ctx,
const char *udi, const char *key, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, reply_iter;
dbus_uint64_t value;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, -1);
LIBHAL_CHECK_UDI_VALID(udi, -1);
LIBHAL_CHECK_PARAM_VALID(key, "*key", -1);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"GetPropertyInteger");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return -1;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return -1;
}
if (reply == NULL) {
return -1;
}
dbus_message_iter_init (reply, &reply_iter);
/* now analyze reply */
if (dbus_message_iter_get_arg_type (&reply_iter) !=
DBUS_TYPE_UINT64) {
fprintf (stderr,
"%s %d : property '%s' for device '%s' is not "
"of type integer\n", __FILE__, __LINE__, key,
udi);
dbus_message_unref (reply);
return -1;
}
dbus_message_iter_get_basic (&reply_iter, &value);
dbus_message_unref (reply);
return value;
}
/**
* libhal_device_get_property_double:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Get the value of a property of type double.
*
* Returns: Property value (IEEE754 double precision float)
*/
double
libhal_device_get_property_double (LibHalContext *ctx,
const char *udi, const char *key, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, reply_iter;
double value;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, -1.0);
LIBHAL_CHECK_UDI_VALID(udi, -1.0);
LIBHAL_CHECK_PARAM_VALID(key, "*key", -1.0);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"GetPropertyDouble");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return -1.0f;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return -1.0f;
}
if (reply == NULL) {
return -1.0f;
}
dbus_message_iter_init (reply, &reply_iter);
/* now analyze reply */
if (dbus_message_iter_get_arg_type (&reply_iter) !=
DBUS_TYPE_DOUBLE) {
fprintf (stderr,
"%s %d : property '%s' for device '%s' is not "
"of type double\n", __FILE__, __LINE__, key, udi);
dbus_message_unref (reply);
return -1.0f;
}
dbus_message_iter_get_basic (&reply_iter, &value);
dbus_message_unref (reply);
return (double) value;
}
/**
* libhal_device_get_property_bool:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Get the value of a property of type bool.
*
* Returns: Property value (boolean)
*/
dbus_bool_t
libhal_device_get_property_bool (LibHalContext *ctx,
const char *udi, const char *key, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, reply_iter;
dbus_bool_t value;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"GetPropertyBoolean");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_iter_init (reply, &reply_iter);
/* now analyze reply */
if (dbus_message_iter_get_arg_type (&reply_iter) !=
DBUS_TYPE_BOOLEAN) {
fprintf (stderr,
"%s %d : property '%s' for device '%s' is not "
"of type bool\n", __FILE__, __LINE__, key, udi);
dbus_message_unref (reply);
return FALSE;
}
dbus_message_iter_get_basic (&reply_iter, &value);
dbus_message_unref (reply);
return value;
}
/* generic helper */
static dbus_bool_t
libhal_device_set_property_helper (LibHalContext *ctx,
const char *udi,
const char *key,
int type,
const char *str_value,
dbus_int32_t int_value,
dbus_uint64_t uint64_value,
double double_value,
dbus_bool_t bool_value,
DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter;
char *method_name = NULL;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
/** @todo sanity check incoming params */
switch (type) {
case DBUS_TYPE_INVALID:
method_name = "RemoveProperty";
break;
case DBUS_TYPE_STRING:
method_name = "SetPropertyString";
break;
case DBUS_TYPE_INT32:
case DBUS_TYPE_UINT64:
method_name = "SetPropertyInteger";
break;
case DBUS_TYPE_DOUBLE:
method_name = "SetPropertyDouble";
break;
case DBUS_TYPE_BOOLEAN:
method_name = "SetPropertyBoolean";
break;
default:
/* cannot happen; is not callable from outside this file */
break;
}
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
method_name);
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
switch (type) {
case DBUS_TYPE_STRING:
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &str_value);
break;
case DBUS_TYPE_INT32:
dbus_message_iter_append_basic (&iter, DBUS_TYPE_INT32, &int_value);
break;
case DBUS_TYPE_UINT64:
dbus_message_iter_append_basic (&iter, DBUS_TYPE_UINT64, &uint64_value);
break;
case DBUS_TYPE_DOUBLE:
dbus_message_iter_append_basic (&iter, DBUS_TYPE_DOUBLE, &double_value);
break;
case DBUS_TYPE_BOOLEAN:
dbus_message_iter_append_basic (&iter, DBUS_TYPE_BOOLEAN, &bool_value);
break;
}
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_set_property_string:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @value: value of the property; a UTF8 string
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Set a property of type string.
*
* Returns: TRUE if the property was set, FALSE if the device didn't
* exist or the property had a different type.
*/
dbus_bool_t
libhal_device_set_property_string (LibHalContext *ctx,
const char *udi,
const char *key,
const char *value,
DBusError *error)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
LIBHAL_CHECK_PARAM_VALID(value, "*value", FALSE);
return libhal_device_set_property_helper (ctx, udi, key,
DBUS_TYPE_STRING,
value, 0, 0, 0.0f, FALSE, error);
}
/**
* libhal_device_set_property_int:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @value: value of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Set a property of type signed integer.
*
* Returns: TRUE if the property was set, FALSE if the device didn't
* exist or the property had a different type.
*/
dbus_bool_t
libhal_device_set_property_int (LibHalContext *ctx, const char *udi,
const char *key, dbus_int32_t value, DBusError *error)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
return libhal_device_set_property_helper (ctx, udi, key,
DBUS_TYPE_INT32,
NULL, value, 0, 0.0f, FALSE, error);
}
/**
* libhal_device_set_property_uint64:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @value: value of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Set a property of type unsigned integer.
*
* Returns: TRUE if the property was set, FALSE if the device didn't
* exist or the property had a different type.
*/
dbus_bool_t
libhal_device_set_property_uint64 (LibHalContext *ctx, const char *udi,
const char *key, dbus_uint64_t value, DBusError *error)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
return libhal_device_set_property_helper (ctx, udi, key,
DBUS_TYPE_UINT64,
NULL, 0, value, 0.0f, FALSE, error);
}
/**
* libhal_device_set_property_double:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @value: value of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Set a property of type double.
*
* Returns: TRUE if the property was set, FALSE if the device didn't
* exist or the property had a different type.
*/
dbus_bool_t
libhal_device_set_property_double (LibHalContext *ctx, const char *udi,
const char *key, double value, DBusError *error)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
return libhal_device_set_property_helper (ctx, udi, key,
DBUS_TYPE_DOUBLE,
NULL, 0, 0, value, FALSE, error);
}
/**
* libhal_device_set_property_bool:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @value: value of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Set a property of type bool.
*
* Returns: TRUE if the property was set, FALSE if the device didn't
* exist or the property had a different type.
*/
dbus_bool_t
libhal_device_set_property_bool (LibHalContext *ctx, const char *udi,
const char *key, dbus_bool_t value, DBusError *error)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
return libhal_device_set_property_helper (ctx, udi, key,
DBUS_TYPE_BOOLEAN,
NULL, 0, 0, 0.0f, value, error);
}
/**
* libhal_device_remove_property:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Remove a property.
*
* Returns: TRUE if the property was set, FALSE if the device didn't
* exist
*/
dbus_bool_t
libhal_device_remove_property (LibHalContext *ctx,
const char *udi, const char *key, DBusError *error)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
return libhal_device_set_property_helper (ctx, udi, key, DBUS_TYPE_INVALID,
/* DBUS_TYPE_INVALID means remove */
NULL, 0, 0, 0.0f, FALSE, error);
}
/**
* libhal_device_property_strlist_append:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @value: value to append to property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Append to a property of type strlist.
*
* Returns: TRUE if the value was appended, FALSE if the device didn't
* exist or the property had a different type.
*/
dbus_bool_t
libhal_device_property_strlist_append (LibHalContext *ctx,
const char *udi,
const char *key,
const char *value,
DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
LIBHAL_CHECK_PARAM_VALID(value, "*value", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"StringListAppend");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &value);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_property_strlist_prepend:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @value: value to prepend to property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Prepend to a property of type strlist.
*
* Returns: TRUE if the value was prepended, FALSE if the device
* didn't exist or the property had a different type.
*/
dbus_bool_t
libhal_device_property_strlist_prepend (LibHalContext *ctx,
const char *udi,
const char *key,
const char *value,
DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
LIBHAL_CHECK_PARAM_VALID(value, "*value", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"StringListPrepend");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &value);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_property_strlist_remove_index:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @idx: index of string to remove in the strlist
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Remove a specified string from a property of type strlist.
*
* Returns: TRUE if the string was removed, FALSE if the device didn't
* exist or the property had a different type.
*/
dbus_bool_t
libhal_device_property_strlist_remove_index (LibHalContext *ctx,
const char *udi,
const char *key,
unsigned int idx,
DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"StringListRemoveIndex");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_UINT32, &idx);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_property_strlist_remove:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @key: name of the property
* @value: the string to remove
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Remove a specified string from a property of type strlist.
*
* Returns: TRUE if the string was removed, FALSE if the device didn't
* exist or the property had a different type.
*/
dbus_bool_t
libhal_device_property_strlist_remove (LibHalContext *ctx,
const char *udi,
const char *key,
const char *value, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
LIBHAL_CHECK_PARAM_VALID(value, "*value", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"StringListRemove");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &value);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_lock:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @reason_to_lock: a user-presentable reason why the device is locked.
* @reason_why_locked: a pointer to store the reason why the device cannot be locked on failure, or NULL
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Take an advisory lock on the device.
*
* Returns: TRUE if the lock was obtained, FALSE otherwise
*/
dbus_bool_t
libhal_device_lock (LibHalContext *ctx,
const char *udi,
const char *reason_to_lock,
char **reason_why_locked, DBusError *error)
{
DBusMessage *message;
DBusMessageIter iter;
DBusMessage *reply;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
if (reason_why_locked != NULL)
*reason_why_locked = NULL;
message = dbus_message_new_method_call ("org.freedesktop.Hal",
udi,
"org.freedesktop.Hal.Device",
"Lock");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &reason_to_lock);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
if (strcmp (error->name,
"org.freedesktop.Hal.DeviceAlreadyLocked") == 0) {
if (reason_why_locked != NULL) {
*reason_why_locked =
dbus_malloc0 (strlen (error->message) + 1);
if (*reason_why_locked == NULL)
return FALSE;
strcpy (*reason_why_locked, error->message);
}
}
return FALSE;
}
if (reply == NULL)
return FALSE;
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_unlock:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Release an advisory lock on the device.
*
* Returns: TRUE if the device was successfully unlocked,
* FALSE otherwise
*/
dbus_bool_t
libhal_device_unlock (LibHalContext *ctx,
const char *udi, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
udi,
"org.freedesktop.Hal.Device",
"Unlock");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL)
return FALSE;
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_new_device:
* @ctx: the context for the connection to hald
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Create a new device object which will be hidden from applications
* until the CommitToGdl(), ie. libhal_device_commit_to_gdl(), method
* is called. Note that the program invoking this method needs to run
* with super user privileges.
*
* Returns: Temporary device unique id or NULL if there was a
* problem. This string must be freed by the caller.
*/
char *
libhal_new_device (LibHalContext *ctx, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter reply_iter;
char *value;
char *dbus_str;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, NULL);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"NewDevice");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return NULL;
}
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return NULL;
}
if (reply == NULL) {
return NULL;
}
dbus_message_iter_init (reply, &reply_iter);
/* now analyze reply */
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_STRING) {
fprintf (stderr,
"%s %d : expected a string in reply to NewDevice\n",
__FILE__, __LINE__);
dbus_message_unref (reply);
return NULL;
}
dbus_message_iter_get_basic (&reply_iter, &dbus_str);
value = (char *) ((dbus_str != NULL) ? strdup (dbus_str) : NULL);
if (value == NULL) {
fprintf (stderr, "%s %d : error allocating memory\n",
__FILE__, __LINE__);
}
dbus_message_unref (reply);
return value;
}
/**
* libhal_device_commit_to_gdl:
* @ctx: the context for the connection to hald
* @temp_udi: the temporary unique device id as returned by libhal_new_device()
* @udi: the new unique device id.
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* When a hidden device has been built using the NewDevice method,
* ie. libhal_new_device(), and the org.freedesktop.Hal.Device
* interface this function will commit it to the global device list.
*
* This means that the device object will be visible to applications
* and the HAL daemon will possibly attempt to boot the device
* (depending on the property RequireEnable).
*
* Note that the program invoking this method needs to run with super
* user privileges.
*
* Returns: FALSE if the given unique device id is already in use.
*/
dbus_bool_t
libhal_device_commit_to_gdl (LibHalContext *ctx,
const char *temp_udi, const char *udi, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(temp_udi, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"CommitToGdl");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &temp_udi);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &udi);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_remove_device:
* @ctx: the context for the connection to hald
* @udi: the Unique device id.
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* This method can be invoked when a device is removed. The HAL daemon
* will shut down the device. Note that the device may still be in the
* device list if the Persistent property is set to true.
*
* Note that the program invoking this method needs to run with super
* user privileges.
*
* Returns: TRUE if the device was removed, FALSE otherwise
*/
dbus_bool_t
libhal_remove_device (LibHalContext *ctx, const char *udi, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"Remove");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &udi);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_exists:
* @ctx: the context for the connection to hald
* @udi: the Unique device id.
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Determine if a device exists.
*
* Returns: TRUE if the device exists
*/
dbus_bool_t
libhal_device_exists (LibHalContext *ctx, const char *udi, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, reply_iter;
dbus_bool_t value;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"DeviceExists");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &udi);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_iter_init (reply, &reply_iter);
/* now analyze reply */
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_BOOLEAN) {
fprintf (stderr,
"%s %d : expected a bool in reply to DeviceExists\n",
__FILE__, __LINE__);
dbus_message_unref (reply);
return FALSE;
}
dbus_message_iter_get_basic (&reply_iter, &value);
dbus_message_unref (reply);
return value;
}
/**
* libhal_device_property_exists:
* @ctx: the context for the connection to hald
* @udi: the Unique device id.
* @key: name of the property
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Determine if a property on a device exists.
*
* Returns: TRUE if the device exists, FALSE otherwise
*/
dbus_bool_t
libhal_device_property_exists (LibHalContext *ctx,
const char *udi, const char *key, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, reply_iter;
dbus_bool_t value;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"PropertyExists");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_iter_init (reply, &reply_iter);
/* now analyse reply */
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_BOOLEAN) {
fprintf (stderr, "%s %d : expected a bool in reply to "
"PropertyExists\n", __FILE__, __LINE__);
dbus_message_unref (reply);
return FALSE;
}
dbus_message_iter_get_basic (&reply_iter, &value);
dbus_message_unref (reply);
return value;
}
/**
* libhal_merge_properties:
* @ctx: the context for the connection to hald
* @target_udi: the Unique device id of target device to merge to
* @source_udi: the Unique device id of device to merge from
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Merge properties from one device to another.
*
* Returns: TRUE if the properties were merged, FALSE otherwise
*/
dbus_bool_t
libhal_merge_properties (LibHalContext *ctx,
const char *target_udi, const char *source_udi, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(target_udi, FALSE);
LIBHAL_CHECK_UDI_VALID(source_udi, FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"MergeProperties");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &target_udi);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &source_udi);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_matches:
* @ctx: the context for the connection to hald
* @udi1: the Unique Device Id for device 1
* @udi2: the Unique Device Id for device 2
* @property_namespace: the namespace for set of devices, e.g. "usb"
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* 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.
*
* Returns: TRUE if all properties starting with the given namespace
* parameter from one device is in the other and have the same value.
*/
dbus_bool_t
libhal_device_matches (LibHalContext *ctx,
const char *udi1, const char *udi2,
const char *property_namespace, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, reply_iter;
dbus_bool_t value;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi1, FALSE);
LIBHAL_CHECK_UDI_VALID(udi2, FALSE);
LIBHAL_CHECK_PARAM_VALID(property_namespace, "*property_namespace", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"DeviceMatches");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, udi1);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, udi2);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, property_namespace);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
/* now analyse reply */
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_BOOLEAN) {
fprintf (stderr,
"%s %d : expected a bool in reply to DeviceMatches\n",
__FILE__, __LINE__);
dbus_message_unref (reply);
return FALSE;
}
dbus_message_iter_get_basic (&reply_iter, &value);
dbus_message_unref (reply);
return value;
}
/**
* libhal_device_print:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Print a device to stdout; useful for debugging.
*
* Returns: TRUE if device's information could be obtained, FALSE otherwise
*/
dbus_bool_t
libhal_device_print (LibHalContext *ctx, const char *udi, DBusError *error)
{
int type;
char *key;
LibHalPropertySet *pset;
LibHalPropertySetIterator i;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
printf ("device_id = %s\n", udi);
if ((pset = libhal_device_get_all_properties (ctx, udi, error)) == NULL)
return FALSE;
for (libhal_psi_init (&i, pset); libhal_psi_has_more (&i);
libhal_psi_next (&i)) {
type = libhal_psi_get_type (&i);
key = libhal_psi_get_key (&i);
switch (type) {
case LIBHAL_PROPERTY_TYPE_STRING:
printf (" %s = '%s' (string)\n", key,
libhal_psi_get_string (&i));
break;
case LIBHAL_PROPERTY_TYPE_INT32:
printf (" %s = %d = 0x%x (int)\n", key,
libhal_psi_get_int (&i),
libhal_psi_get_int (&i));
break;
case LIBHAL_PROPERTY_TYPE_UINT64:
printf (" %s = %llu = 0x%llx (uint64)\n", key,
(long long unsigned int) libhal_psi_get_uint64 (&i),
(long long unsigned int) libhal_psi_get_uint64 (&i));
break;
case LIBHAL_PROPERTY_TYPE_BOOLEAN:
printf (" %s = %s (bool)\n", key,
(libhal_psi_get_bool (&i) ? "true" :
"false"));
break;
case LIBHAL_PROPERTY_TYPE_DOUBLE:
printf (" %s = %g (double)\n", key,
libhal_psi_get_double (&i));
break;
case LIBHAL_PROPERTY_TYPE_STRLIST:
{
unsigned int j;
char **str_list;
str_list = libhal_psi_get_strlist (&i);
printf (" %s = [", key);
for (j = 0; str_list[j] != NULL; j++) {
printf ("'%s'", str_list[j]);
if (str_list[j+1] != NULL)
printf (", ");
}
printf ("] (string list)\n");
break;
}
default:
printf (" *** unknown type for key %s\n", key);
break;
}
}
libhal_free_property_set (pset);
return TRUE;
}
/**
* libhal_manager_find_device_string_match:
* @ctx: the context for the connection to hald
* @key: name of the property
* @value: the value to match
* @num_devices: pointer to store number of devices
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Find a device in the GDL where a single string property matches a
* given value.
*
* Returns: UDI of devices; free with libhal_free_string_array()
*/
char **
libhal_manager_find_device_string_match (LibHalContext *ctx,
const char *key,
const char *value, int *num_devices, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, iter_array, reply_iter;
char **hal_device_names;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, NULL);
LIBHAL_CHECK_PARAM_VALID(key, "*key", NULL);
LIBHAL_CHECK_PARAM_VALID(value, "*value", NULL);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"FindDeviceStringMatch");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return NULL;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &key);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &value);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return NULL;
}
if (reply == NULL) {
return NULL;
}
/* now analyse reply */
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_ARRAY) {
fprintf (stderr, "%s %d : wrong reply from hald. Expecting an array.\n", __FILE__, __LINE__);
return NULL;
}
dbus_message_iter_recurse (&reply_iter, &iter_array);
hal_device_names = libhal_get_string_array_from_iter (&iter_array, num_devices);
dbus_message_unref (reply);
return hal_device_names;
}
/**
* libhal_device_add_capability:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @capability: the capability name to add
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Assign a capability to a device.
*
* Returns: TRUE if the capability was added, FALSE if the device didn't exist
*/
dbus_bool_t
libhal_device_add_capability (LibHalContext *ctx,
const char *udi, const char *capability, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(capability, "*capability", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"AddCapability");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &capability);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_query_capability:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @capability: the capability name
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Check if a device has a capability. The result is undefined if the
* device doesn't exist.
*
* Returns: TRUE if the device has the capability, otherwise FALSE
*/
dbus_bool_t
libhal_device_query_capability (LibHalContext *ctx, const char *udi, const char *capability, DBusError *error)
{
char **caps;
unsigned int i;
dbus_bool_t ret;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(capability, "*capability", FALSE);
ret = FALSE;
caps = libhal_device_get_property_strlist (ctx, udi, "info.capabilities", error);
if (caps != NULL) {
for (i = 0; caps[i] != NULL; i++) {
if (strcmp (caps[i], capability) == 0) {
ret = TRUE;
break;
}
}
libhal_free_string_array (caps);
}
return ret;
}
/**
* libhal_find_device_by_capability:
* @ctx: the context for the connection to hald
* @capability: the capability name
* @num_devices: pointer to store number of devices
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Find devices with a given capability.
*
* Returns: UDI of devices; free with libhal_free_string_array()
*/
char **
libhal_find_device_by_capability (LibHalContext *ctx,
const char *capability, int *num_devices, DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter, iter_array, reply_iter;
char **hal_device_names;
DBusError _error;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, NULL);
LIBHAL_CHECK_PARAM_VALID(capability, "*capability", NULL);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"FindDeviceByCapability");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return NULL;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &capability);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return NULL;
}
if (reply == NULL) {
return NULL;
}
/* now analyse reply */
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_ARRAY) {
fprintf (stderr, "%s %d : wrong reply from hald. Expecting an array.\n", __FILE__, __LINE__);
return NULL;
}
dbus_message_iter_recurse (&reply_iter, &iter_array);
hal_device_names = libhal_get_string_array_from_iter (&iter_array, num_devices);
dbus_message_unref (reply);
return hal_device_names;
}
/**
* libhal_device_property_watch_all:
* @ctx: the context for the connection to hald
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Watch all devices, ie. the device_property_changed callback is
* invoked when the properties on any device changes.
*
* Returns: TRUE only if the operation succeeded
*/
dbus_bool_t
libhal_device_property_watch_all (LibHalContext *ctx, DBusError *error)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
dbus_bus_add_match (ctx->connection,
"type='signal',"
"interface='org.freedesktop.Hal.Device',"
"sender='org.freedesktop.Hal'", error);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
return TRUE;
}
dbus_bool_t
libhal_device_property_remove_watch_all (LibHalContext *ctx, DBusError *error)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
dbus_bus_remove_match (ctx->connection,
"type='signal',"
"interface='org.freedesktop.Hal.Device',"
"sender='org.freedesktop.Hal'", error);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
return TRUE;
}
/**
* libhal_device_add_property_watch:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Add a watch on a device, so the device_property_changed callback is
* invoked when the properties on the given device changes.
*
* The application itself is responsible for deleting the watch, using
* libhal_device_remove_property_watch, if the device is removed.
*
* Returns: TRUE only if the operation succeeded
*/
dbus_bool_t
libhal_device_add_property_watch (LibHalContext *ctx, const char *udi, DBusError *error)
{
char buf[512];
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
snprintf (buf, 512,
"type='signal',"
"interface='org.freedesktop.Hal.Device',"
"sender='org.freedesktop.Hal'," "path=%s", udi);
dbus_bus_add_match (ctx->connection, buf, error);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
return TRUE;
}
/**
* libhal_device_remove_property_watch:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Remove a watch on a device.
*
* Returns: TRUE only if the operation succeeded
*/
dbus_bool_t
libhal_device_remove_property_watch (LibHalContext *ctx, const char *udi, DBusError *error)
{
char buf[512];
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
snprintf (buf, 512,
"type='signal',"
"interface='org.freedesktop.Hal.Device',"
"sender='org.freedesktop.Hal'," "path=%s", udi);
dbus_bus_remove_match (ctx->connection, buf, error);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
return TRUE;
}
/**
* libhal_ctx_new:
*
* Create a new LibHalContext
*
* Returns: a new uninitialized LibHalContext object
*/
LibHalContext *
libhal_ctx_new (void)
{
LibHalContext *ctx;
ctx = calloc (1, sizeof (LibHalContext));
if (ctx == NULL) {
fprintf (stderr,
"%s %d : Failed to allocate %lu bytes\n",
__FILE__, __LINE__, (unsigned long) sizeof (LibHalContext));
return NULL;
}
ctx->is_initialized = FALSE;
ctx->is_shutdown = FALSE;
ctx->connection = NULL;
ctx->is_direct = FALSE;
return ctx;
}
/**
* libhal_ctx_set_cache:
* @ctx: context to enable/disable cache for
* @use_cache: whether or not to use cache
*
* Enable or disable caching. Note: Caching is not actually
* implemented yet.
*
* Returns: TRUE if cache was successfully enabled/disabled, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_cache (LibHalContext *ctx, dbus_bool_t use_cache)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
ctx->cache_enabled = use_cache;
return TRUE;
}
/**
* libhal_ctx_set_dbus_connection:
* @ctx: context to set connection for
* @conn: DBus connection to use
*
* Set DBus connection to use to talk to hald.
*
* Returns: TRUE if connection was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_dbus_connection (LibHalContext *ctx, DBusConnection *conn)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
if (conn == NULL)
return FALSE;
ctx->connection = conn;
return TRUE;
}
/**
* libhal_ctx_get_dbus_connection:
* @ctx: context to get connection for
*
* Get DBus connection used for talking to hald.
*
* Returns: DBus connection to use or NULL
*/
DBusConnection *
libhal_ctx_get_dbus_connection (LibHalContext *ctx)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, NULL);
return ctx->connection;
}
/**
* libhal_ctx_init:
* @ctx: Context for connection to hald (D-BUS connection should be set with libhal_ctx_set_dbus_connection)
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Initialize the connection to hald.
*
* Returns: TRUE if initialization succeeds, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_init (LibHalContext *ctx, DBusError *error)
{
DBusError _error;
dbus_bool_t hald_exists;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
if (ctx->connection == NULL)
return FALSE;
dbus_error_init (&_error);
hald_exists = dbus_bus_name_has_owner (ctx->connection, "org.freedesktop.Hal", &_error);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (!hald_exists) {
return FALSE;
}
if (!dbus_connection_add_filter (ctx->connection, filter_func, ctx, NULL)) {
return FALSE;
}
dbus_bus_add_match (ctx->connection,
"type='signal',"
"interface='org.freedesktop.Hal.Manager',"
"sender='org.freedesktop.Hal',"
"path='/org/freedesktop/Hal/Manager'", &_error);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
ctx->is_initialized = TRUE;
ctx->is_direct = FALSE;
return TRUE;
}
/**
* libhal_ctx_init_direct:
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Create an already initialized connection to hald. This function should only be used by HAL helpers.
*
* Returns: A pointer to an already initialized LibHalContext
*/
LibHalContext *
libhal_ctx_init_direct (DBusError *error)
{
char *hald_addr;
LibHalContext *ctx;
DBusError _error;
ctx = libhal_ctx_new ();
if (ctx == NULL)
goto out;
if (((hald_addr = getenv ("HALD_DIRECT_ADDR"))) == NULL) {
libhal_ctx_free (ctx);
ctx = NULL;
goto out;
}
dbus_error_init (&_error);
ctx->connection = dbus_connection_open (hald_addr, &_error);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
libhal_ctx_free (ctx);
ctx = NULL;
goto out;
}
if (!dbus_connection_add_filter (ctx->connection, filter_func, ctx, NULL)) {
libhal_ctx_free (ctx);
ctx = NULL;
goto out;
}
ctx->is_initialized = TRUE;
ctx->is_direct = TRUE;
out:
return ctx;
}
/**
* libhal_ctx_shutdown:
* @ctx: the context for the connection to hald
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Shut down a connection to hald.
*
* Returns: TRUE if connection successfully shut down, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_shutdown (LibHalContext *ctx, DBusError *error)
{
DBusError myerror;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
if (ctx->is_direct) {
/* for some reason dbus_connection_set_exit_on_disconnect doesn't work yet so don't unref */
/*dbus_connection_unref (ctx->connection);*/
} else {
dbus_error_init (&myerror);
dbus_bus_remove_match (ctx->connection,
"type='signal',"
"interface='org.freedesktop.Hal.Manager',"
"sender='org.freedesktop.Hal',"
"path='/org/freedesktop/Hal/Manager'", &myerror);
dbus_move_error (&myerror, error);
if (error != NULL && dbus_error_is_set (error)) {
fprintf (stderr, "%s %d : Error unsubscribing to signals, error=%s\n",
__FILE__, __LINE__, error->message);
/** @todo clean up */
}
/* TODO: remove other matches */
dbus_connection_remove_filter (ctx->connection, filter_func, ctx);
}
ctx->is_initialized = FALSE;
return TRUE;
}
/**
* libhal_ctx_free:
* @ctx: pointer to a LibHalContext
*
* Free a LibHalContext resource.
*
* Returns: TRUE
*/
dbus_bool_t
libhal_ctx_free (LibHalContext *ctx)
{
free (ctx);
return TRUE;
}
/**
* libhal_ctx_set_device_added:
* @ctx: the context for the connection to hald
* @callback: the function to call when a device is added
*
* Set the callback for when a device is added
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_device_added (LibHalContext *ctx, LibHalDeviceAdded callback)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
ctx->device_added = callback;
return TRUE;
}
/**
* libhal_ctx_set_device_removed:
* @ctx: the context for the connection to hald
* @callback: the function to call when a device is removed
*
* Set the callback for when a device is removed.
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_device_removed (LibHalContext *ctx, LibHalDeviceRemoved callback)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
ctx->device_removed = callback;
return TRUE;
}
/**
* libhal_ctx_set_device_new_capability:
* @ctx: the context for the connection to hald
* @callback: the function to call when a device gains a new capability
*
* Set the callback for when a device gains a new capability.
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_device_new_capability (LibHalContext *ctx, LibHalDeviceNewCapability callback)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
ctx->device_new_capability = callback;
return TRUE;
}
/**
* libhal_ctx_set_device_lost_capability:
* @ctx: the context for the connection to hald
* @callback: the function to call when a device loses a capability
*
* Set the callback for when a device loses a capability
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_device_lost_capability (LibHalContext *ctx, LibHalDeviceLostCapability callback)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
ctx->device_lost_capability = callback;
return TRUE;
}
/**
* libhal_ctx_set_device_property_modified:
* @ctx: the context for the connection to hald
* @callback: the function to call when a property is modified on a device
*
* Set the callback for when a property is modified on a device.
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_device_property_modified (LibHalContext *ctx, LibHalDevicePropertyModified callback)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
ctx->device_property_modified = callback;
return TRUE;
}
/**
* libhal_ctx_set_device_condition:
* @ctx: the context for the connection to hald
* @callback: the function to call when a device emits a condition
*
* Set the callback for when a device emits a condition
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_device_condition (LibHalContext *ctx, LibHalDeviceCondition callback)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
ctx->device_condition = callback;
return TRUE;
}
/**
* libhal_ctx_set_singleton_device_added:
* @ctx: the context for the connection to hald
* @callback: the function to call when a device emits a condition
*
* Set the callback for when a singleton should handle a new device
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_singleton_device_added (LibHalContext *ctx, LibHalSingletonDeviceAdded callback)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
ctx->singleton_device_added = callback;
return TRUE;
}
/**
* libhal_ctx_set_singleton_device_removed:
* @ctx: the context for the connection to hald
* @callback: the function to call when a device emits a condition
*
* Set the callback for when a singleton should discard a device
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_singleton_device_removed (LibHalContext *ctx, LibHalSingletonDeviceRemoved callback)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
ctx->singleton_device_removed = callback;
return TRUE;
}
/**
* libhal_string_array_length:
* @str_array: array of strings to consider
*
* Get the length of an array of strings.
*
* Returns: Number of strings in array
*/
unsigned int
libhal_string_array_length (char **str_array)
{
unsigned int i;
if (str_array == NULL)
return 0;
for (i = 0; str_array[i] != NULL; i++)
;
return i;
}
/**
* libhal_device_rescan:
* @ctx: the context for the connection to hald
* @udi: the Unique id of device
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* TODO document me.
*
* Returns: Whether the operation succeeded
*/
dbus_bool_t
libhal_device_rescan (LibHalContext *ctx, const char *udi, DBusError *error)
{
DBusMessage *message;
DBusMessageIter reply_iter;
DBusMessage *reply;
dbus_bool_t result;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal", udi,
"org.freedesktop.Hal.Device",
"Rescan");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL)
return FALSE;
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) !=
DBUS_TYPE_BOOLEAN) {
dbus_message_unref (reply);
return FALSE;
}
dbus_message_iter_get_basic (&reply_iter, &result);
dbus_message_unref (reply);
return result;
}
/**
* libhal_device_reprobe:
* @ctx: the context for the connection to hald
* @udi: the Unique id of device
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* TODO document me.
*
* Returns: Whether the operation succeeded
*/
dbus_bool_t
libhal_device_reprobe (LibHalContext *ctx, const char *udi, DBusError *error)
{
DBusMessage *message;
DBusMessageIter reply_iter;
DBusMessage *reply;
dbus_bool_t result;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
udi,
"org.freedesktop.Hal.Device",
"Reprobe");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL)
return FALSE;
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) !=
DBUS_TYPE_BOOLEAN) {
dbus_message_unref (reply);
return FALSE;
}
dbus_message_iter_get_basic (&reply_iter, &result);
dbus_message_unref (reply);
return result;
}
/**
* libhal_device_emit_condition:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @condition_name: user-readable name of condition
* @condition_details: user-readable details of condition
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Emit a condition from a device. Can only be used from hald helpers.
*
* Returns: TRUE if condition successfully emitted,
* FALSE otherwise
*/
dbus_bool_t libhal_device_emit_condition (LibHalContext *ctx,
const char *udi,
const char *condition_name,
const char *condition_details,
DBusError *error)
{
DBusMessage *message;
DBusMessageIter iter;
DBusMessageIter reply_iter;
DBusMessage *reply;
dbus_bool_t result;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(condition_name, "*condition_name", FALSE);
LIBHAL_CHECK_PARAM_VALID(condition_details, "*condition_details", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
udi,
"org.freedesktop.Hal.Device",
"EmitCondition");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &condition_name);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &condition_details);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
fprintf (stderr,
"%s %d : Failure sending D-BUS message: %s: %s\n",
__FILE__, __LINE__, error->name, error->message);
return FALSE;
}
if (reply == NULL) {
fprintf (stderr,
"%s %d : Got no reply\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) !=
DBUS_TYPE_BOOLEAN) {
dbus_message_unref (reply);
fprintf (stderr,
"%s %d : Malformed reply\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_get_basic (&reply_iter, &result);
dbus_message_unref (reply);
return result;
}
static dbus_bool_t
addon_is_ready(LibHalContext *ctx, const char *identifier,
dbus_bool_t singleton, DBusError *error)
{
DBusMessage *message;
DBusMessageIter iter;
DBusMessage *reply;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_PARAM_VALID(identifier, "*identifier", FALSE);
if (singleton) {
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"SingletonAddonIsReady");
} else {
message = dbus_message_new_method_call ("org.freedesktop.Hal",
identifier,
"org.freedesktop.Hal.Device",
"AddonIsReady");
}
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &identifier);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL)
return FALSE;
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_addon_is_ready:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id this addon is handling
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* HAL addon's must call this method when they are done initializing the device object. The HAL
* daemon will wait for all addon's to call this.
*
* Can only be used from hald helpers.
*
* Returns: TRUE if the HAL daemon received the message, FALSE otherwise
*/
dbus_bool_t
libhal_device_addon_is_ready (LibHalContext *ctx,
const char *udi,
DBusError *error)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
return addon_is_ready (ctx, udi, FALSE, error);
}
/**
* libhal_device_singleton_addon_is_ready:
* @ctx: the context for the connection to hald
* @command_line: commandline singleton was started with
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* HAL singleton addon's must call this method when they are done initializing the device object. The HAL
* daemon will wait for all addon's to call this.
*
* Can only be used from hald helpers.
*
* Returns: TRUE if the HAL daemon received the message, FALSE otherwise
*/
dbus_bool_t
libhal_device_singleton_addon_is_ready (LibHalContext *ctx,
const char *command_line,
DBusError *error)
{
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_PARAM_VALID(command_line, "*command_line", FALSE);
return addon_is_ready (ctx, command_line, TRUE, error);
}
/**
* libhal_device_claim_interface:
* @ctx: the context for the connection to hald
* @udi: the Unique Device Id
* @interface_name: Name of interface to claim, e.g. org.freedesktop.Hal.Device.FoobarKindOfThing
* @introspection_xml: Introspection XML containing what would be inside the interface XML tag
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Claim an interface for a device. All messages to this interface
* will be forwarded to the helper. Can only be used from hald
* helpers.
*
* Returns: TRUE if interface was claimed, FALSE otherwise
*/
dbus_bool_t
libhal_device_claim_interface (LibHalContext *ctx,
const char *udi,
const char *interface_name,
const char *introspection_xml,
DBusError *error)
{
DBusMessage *message;
DBusMessageIter iter;
DBusMessageIter reply_iter;
DBusMessage *reply;
dbus_bool_t result;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(interface_name, "*interface_name", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
udi,
"org.freedesktop.Hal.Device",
"ClaimInterface");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &interface_name);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &introspection_xml);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL)
return FALSE;
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) !=
DBUS_TYPE_BOOLEAN) {
dbus_message_unref (reply);
return FALSE;
}
dbus_message_iter_get_basic (&reply_iter, &result);
dbus_message_unref (reply);
return result;
}
struct LibHalChangeSetElement_s;
typedef struct LibHalChangeSetElement_s LibHalChangeSetElement;
struct LibHalChangeSetElement_s {
char *key;
int change_type;
union {
char *val_str;
dbus_int32_t val_int;
dbus_uint64_t val_uint64;
double val_double;
dbus_bool_t val_bool;
char **val_strlist;
} value;
LibHalChangeSetElement *next;
LibHalChangeSetElement *prev;
};
struct LibHalChangeSet_s {
char *udi;
LibHalChangeSetElement *head;
LibHalChangeSetElement *tail;
};
/**
* libhal_device_new_changeset:
* @udi: unique device identifier
*
* Request a new changeset object. Used for changing multiple properties at once. Useful when
* performance is critical and also for atomically updating several properties.
*
* Returns: A new changeset object or NULL on error
*/
LibHalChangeSet *
libhal_device_new_changeset (const char *udi)
{
LibHalChangeSet *changeset;
LIBHAL_CHECK_UDI_VALID(udi, NULL);
changeset = calloc (1, sizeof (LibHalChangeSet));
if (changeset == NULL)
goto out;
changeset->udi = strdup (udi);
if (changeset->udi == NULL) {
free (changeset);
changeset = NULL;
goto out;
}
changeset->head = NULL;
changeset->tail = NULL;
out:
return changeset;
}
static void
libhal_changeset_append (LibHalChangeSet *changeset, LibHalChangeSetElement *elem)
{
LIBHAL_CHECK_PARAM_VALID(changeset, "*changeset", (void) NULL );
LIBHAL_CHECK_PARAM_VALID(elem, "*elem", (void) NULL);
if (changeset->head == NULL) {
changeset->head = elem;
changeset->tail = elem;
elem->next = NULL;
elem->prev = NULL;
} else {
elem->prev = changeset->tail;
elem->next = NULL;
elem->prev->next = elem;
changeset->tail = elem;
}
}
/**
* libhal_changeset_set_property_string:
* @changeset: the changeset
* @key: key of property
* @value: the value to set
*
* Set a property.
*
* Returns: FALSE on OOM
*/
dbus_bool_t
libhal_changeset_set_property_string (LibHalChangeSet *changeset, const char *key, const char *value)
{
LibHalChangeSetElement *elem;
LIBHAL_CHECK_PARAM_VALID(changeset, "*changeset", FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
LIBHAL_CHECK_PARAM_VALID(value, "*value", FALSE);
elem = calloc (1, sizeof (LibHalChangeSetElement));
if (elem == NULL)
goto out;
elem->key = strdup (key);
if (elem->key == NULL) {
free (elem);
elem = NULL;
goto out;
}
elem->change_type = LIBHAL_PROPERTY_TYPE_STRING;
elem->value.val_str = strdup (value);
if (elem->value.val_str == NULL) {
free (elem->key);
free (elem);
elem = NULL;
goto out;
}
libhal_changeset_append (changeset, elem);
out:
return elem != NULL;
}
/**
* libhal_changeset_set_property_int:
* @changeset: the changeset
* @key: key of property
* @value: the value to set
*
* Set a property.
*
* Returns: FALSE on OOM
*/
dbus_bool_t
libhal_changeset_set_property_int (LibHalChangeSet *changeset, const char *key, dbus_int32_t value)
{
LibHalChangeSetElement *elem;
LIBHAL_CHECK_PARAM_VALID(changeset, "*changeset", FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
elem = calloc (1, sizeof (LibHalChangeSetElement));
if (elem == NULL)
goto out;
elem->key = strdup (key);
if (elem->key == NULL) {
free (elem);
elem = NULL;
goto out;
}
elem->change_type = LIBHAL_PROPERTY_TYPE_INT32;
elem->value.val_int = value;
libhal_changeset_append (changeset, elem);
out:
return elem != NULL;
}
/**
* libhal_changeset_set_property_uint64:
* @changeset: the changeset
* @key: key of property
* @value: the value to set
*
* Set a property.
*
* Returns: FALSE on OOM
*/
dbus_bool_t
libhal_changeset_set_property_uint64 (LibHalChangeSet *changeset, const char *key, dbus_uint64_t value)
{
LibHalChangeSetElement *elem;
LIBHAL_CHECK_PARAM_VALID(changeset, "*changeset", FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
elem = calloc (1, sizeof (LibHalChangeSetElement));
if (elem == NULL)
goto out;
elem->key = strdup (key);
if (elem->key == NULL) {
free (elem);
elem = NULL;
goto out;
}
elem->change_type = LIBHAL_PROPERTY_TYPE_UINT64;
elem->value.val_uint64 = value;
libhal_changeset_append (changeset, elem);
out:
return elem != NULL;
}
/**
* libhal_changeset_set_property_double:
* @changeset: the changeset
* @key: key of property
* @value: the value to set
*
* Set a property.
*
* Returns: FALSE on OOM
*/
dbus_bool_t
libhal_changeset_set_property_double (LibHalChangeSet *changeset, const char *key, double value)
{
LibHalChangeSetElement *elem;
LIBHAL_CHECK_PARAM_VALID(changeset, "*changeset", FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
elem = calloc (1, sizeof (LibHalChangeSetElement));
if (elem == NULL)
goto out;
elem->key = strdup (key);
if (elem->key == NULL) {
free (elem);
elem = NULL;
goto out;
}
elem->change_type = LIBHAL_PROPERTY_TYPE_DOUBLE;
elem->value.val_double = value;
libhal_changeset_append (changeset, elem);
out:
return elem != NULL;
}
/**
* libhal_changeset_set_property_bool:
* @changeset: the changeset
* @key: key of property
* @value: the value to set
*
* Set a property.
*
* Returns: FALSE on OOM
*/
dbus_bool_t
libhal_changeset_set_property_bool (LibHalChangeSet *changeset, const char *key, dbus_bool_t value)
{
LibHalChangeSetElement *elem;
LIBHAL_CHECK_PARAM_VALID(changeset, "*changeset", FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
elem = calloc (1, sizeof (LibHalChangeSetElement));
if (elem == NULL)
goto out;
elem->key = strdup (key);
if (elem->key == NULL) {
free (elem);
elem = NULL;
goto out;
}
elem->change_type = LIBHAL_PROPERTY_TYPE_BOOLEAN;
elem->value.val_bool = value;
libhal_changeset_append (changeset, elem);
out:
return elem != NULL;
}
/**
* libhal_changeset_set_property_strlist:
* @changeset: the changeset
* @key: key of property
* @value: the value to set - NULL terminated array of strings
*
* Set a property.
*
* Returns: FALSE on OOM
*/
dbus_bool_t
libhal_changeset_set_property_strlist (LibHalChangeSet *changeset, const char *key, const char **value)
{
LibHalChangeSetElement *elem;
char **value_copy;
int len;
int i, j;
LIBHAL_CHECK_PARAM_VALID(changeset, "*changeset", FALSE);
LIBHAL_CHECK_PARAM_VALID(key, "*key", FALSE);
elem = calloc (1, sizeof (LibHalChangeSetElement));
if (elem == NULL)
goto out;
elem->key = strdup (key);
if (elem->key == NULL) {
free (elem);
elem = NULL;
goto out;
}
for (i = 0; value[i] != NULL; i++)
;
len = i;
value_copy = calloc (len + 1, sizeof (char *));
if (value_copy == NULL) {
free (elem->key);
free (elem);
elem = NULL;
goto out;
}
for (i = 0; i < len; i++) {
value_copy[i] = strdup (value[i]);
if (value_copy[i] == NULL) {
for (j = 0; j < i; j++) {
free (value_copy[j]);
}
free (value_copy);
free (elem->key);
free (elem);
elem = NULL;
goto out;
}
}
value_copy[i] = NULL;
elem->change_type = LIBHAL_PROPERTY_TYPE_STRLIST;
elem->value.val_strlist = value_copy;
libhal_changeset_append (changeset, elem);
out:
return elem != NULL;
}
/**
* libhal_device_commit_changeset:
* @ctx: the context for the connection to hald
* @changeset: the changeset to commit
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Commit a changeset to the daemon.
*
* Returns: True if the changeset was committed on the daemon side
*/
dbus_bool_t
libhal_device_commit_changeset (LibHalContext *ctx, LibHalChangeSet *changeset, DBusError *error)
{
LibHalChangeSetElement *elem;
DBusMessage *message;
DBusMessage *reply;
DBusError _error;
DBusMessageIter iter;
DBusMessageIter sub;
DBusMessageIter sub2;
DBusMessageIter sub3;
DBusMessageIter sub4;
int i;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(changeset->udi, FALSE);
if (changeset->head == NULL) {
return TRUE;
}
message = dbus_message_new_method_call ("org.freedesktop.Hal", changeset->udi,
"org.freedesktop.Hal.Device",
"SetMultipleProperties");
if (message == NULL) {
fprintf (stderr, "%s %d : Couldn't allocate D-BUS message\n", __FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_open_container (&iter,
DBUS_TYPE_ARRAY,
DBUS_DICT_ENTRY_BEGIN_CHAR_AS_STRING
DBUS_TYPE_STRING_AS_STRING
DBUS_TYPE_VARIANT_AS_STRING
DBUS_DICT_ENTRY_END_CHAR_AS_STRING,
&sub);
for (elem = changeset->head; elem != NULL; elem = elem->next) {
dbus_message_iter_open_container (&sub,
DBUS_TYPE_DICT_ENTRY,
NULL,
&sub2);
dbus_message_iter_append_basic (&sub2, DBUS_TYPE_STRING, &(elem->key));
switch (elem->change_type) {
case LIBHAL_PROPERTY_TYPE_STRING:
dbus_message_iter_open_container (&sub2, DBUS_TYPE_VARIANT, DBUS_TYPE_STRING_AS_STRING, &sub3);
dbus_message_iter_append_basic (&sub3, DBUS_TYPE_STRING, &(elem->value.val_str));
dbus_message_iter_close_container (&sub2, &sub3);
break;
case LIBHAL_PROPERTY_TYPE_STRLIST:
dbus_message_iter_open_container (&sub2, DBUS_TYPE_VARIANT,
DBUS_TYPE_ARRAY_AS_STRING DBUS_TYPE_STRING_AS_STRING, &sub3);
dbus_message_iter_open_container (&sub3, DBUS_TYPE_ARRAY,
DBUS_TYPE_STRING_AS_STRING, &sub4);
for (i = 0; elem->value.val_strlist[i] != NULL; i++) {
dbus_message_iter_append_basic (&sub4, DBUS_TYPE_STRING,
&(elem->value.val_strlist[i]));
}
dbus_message_iter_close_container (&sub3, &sub4);
dbus_message_iter_close_container (&sub2, &sub3);
break;
case LIBHAL_PROPERTY_TYPE_INT32:
dbus_message_iter_open_container (&sub2, DBUS_TYPE_VARIANT, DBUS_TYPE_INT32_AS_STRING, &sub3);
dbus_message_iter_append_basic (&sub3, DBUS_TYPE_INT32, &(elem->value.val_int));
dbus_message_iter_close_container (&sub2, &sub3);
break;
case LIBHAL_PROPERTY_TYPE_UINT64:
dbus_message_iter_open_container (&sub2, DBUS_TYPE_VARIANT, DBUS_TYPE_UINT64_AS_STRING, &sub3);
dbus_message_iter_append_basic (&sub3, DBUS_TYPE_UINT64, &(elem->value.val_uint64));
dbus_message_iter_close_container (&sub2, &sub3);
break;
case LIBHAL_PROPERTY_TYPE_DOUBLE:
dbus_message_iter_open_container (&sub2, DBUS_TYPE_VARIANT, DBUS_TYPE_DOUBLE_AS_STRING, &sub3);
dbus_message_iter_append_basic (&sub3, DBUS_TYPE_DOUBLE, &(elem->value.val_double));
dbus_message_iter_close_container (&sub2, &sub3);
break;
case LIBHAL_PROPERTY_TYPE_BOOLEAN:
dbus_message_iter_open_container (&sub2, DBUS_TYPE_VARIANT, DBUS_TYPE_BOOLEAN_AS_STRING,&sub3);
dbus_message_iter_append_basic (&sub3, DBUS_TYPE_BOOLEAN, &(elem->value.val_bool));
dbus_message_iter_close_container (&sub2, &sub3);
break;
default:
fprintf (stderr, "%s %d : unknown change_type %d\n", __FILE__, __LINE__, elem->change_type);
break;
}
dbus_message_iter_close_container (&sub, &sub2);
}
dbus_message_iter_close_container (&iter, &sub);
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
&_error);
dbus_message_unref (message);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
fprintf (stderr,
"%s %d : %s\n",
__FILE__, __LINE__, error->message);
return FALSE;
}
if (reply == NULL) {
return FALSE;
}
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_free_changeset:
* @changeset: the changeset to free
*
* Free a changeset.
*/
void
libhal_device_free_changeset (LibHalChangeSet *changeset)
{
LibHalChangeSetElement *elem;
LibHalChangeSetElement *elem2;
for (elem = changeset->head; elem != NULL; elem = elem2) {
elem2 = elem->next;
switch (elem->change_type) {
case LIBHAL_PROPERTY_TYPE_STRING:
free (elem->value.val_str);
break;
case LIBHAL_PROPERTY_TYPE_STRLIST:
libhal_free_string_array (elem->value.val_strlist);
break;
/* explicit fallthrough */
case LIBHAL_PROPERTY_TYPE_INT32:
case LIBHAL_PROPERTY_TYPE_UINT64:
case LIBHAL_PROPERTY_TYPE_DOUBLE:
case LIBHAL_PROPERTY_TYPE_BOOLEAN:
break;
default:
fprintf (stderr, "%s %d : unknown change_type %d\n", __FILE__, __LINE__, elem->change_type);
break;
}
free (elem->key);
free (elem);
}
free (changeset->udi);
free (changeset);
}
/**
* libhal_device_acquire_interface_lock:
* @ctx: the context for the connection to hald
* @udi: the Unique id of device
* @interface: the intername name to lock
* @exclusive: whether the lock should be exclusive
* @error: pointer to an initialized dbus error object for returning errors
*
* Releases a lock on an interface for a specific device.
*
* Returns: TRUE iff the lock was acquired
**/
dbus_bool_t
libhal_device_acquire_interface_lock (LibHalContext *ctx,
const char *udi,
const char *interface,
dbus_bool_t exclusive,
DBusError *error)
{
DBusMessage *message;
DBusMessageIter iter;
DBusMessage *reply;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(interface, "*interface", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
udi,
"org.freedesktop.Hal.Device",
"AcquireInterfaceLock");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &interface);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_BOOLEAN, &exclusive);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL)
return FALSE;
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_release_interface_lock:
* @ctx: the context for the connection to hald
* @udi: the Unique id of device
* @interface: the intername name to unlock
* @error: pointer to an initialized dbus error object for returning errors
*
* Acquires a lock on an interface for a specific device.
*
* Returns: TRUE iff the lock was released.
**/
dbus_bool_t libhal_device_release_interface_lock (LibHalContext *ctx,
const char *udi,
const char *interface,
DBusError *error)
{
DBusMessage *message;
DBusMessageIter iter;
DBusMessage *reply;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_UDI_VALID(udi, FALSE);
LIBHAL_CHECK_PARAM_VALID(interface, "*interface", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
udi,
"org.freedesktop.Hal.Device",
"ReleaseInterfaceLock");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &interface);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL)
return FALSE;
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_acquire_global_interface_lock:
* @ctx: the context for the connection to hald
* @interface: the intername name to lock
* @exclusive: whether the lock should be exclusive
* @error: pointer to an initialized dbus error object for returning errors
*
* Acquires a global lock on an interface.
*
* Returns: TRUE iff the lock was acquired
**/
dbus_bool_t libhal_acquire_global_interface_lock (LibHalContext *ctx,
const char *interface,
dbus_bool_t exclusive,
DBusError *error)
{
DBusMessage *message;
DBusMessageIter iter;
DBusMessage *reply;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_PARAM_VALID(interface, "*interface", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"AcquireGlobalInterfaceLock");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &interface);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_BOOLEAN, &exclusive);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL)
return FALSE;
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_release_global_interface_lock:
* @ctx: the context for the connection to hald
* @interface: the intername name to unlock
* @error: pointer to an initialized dbus error object for returning errors
*
* Releases a global lock on an interface.
*
* Returns: TRUE iff the lock was released
**/
dbus_bool_t libhal_release_global_interface_lock (LibHalContext *ctx,
const char *interface,
DBusError *error)
{
DBusMessage *message;
DBusMessageIter iter;
DBusMessage *reply;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, FALSE);
LIBHAL_CHECK_PARAM_VALID(interface, "*interface", FALSE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"ReleaseGlobalInterfaceLock");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return FALSE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &interface);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return FALSE;
}
if (reply == NULL)
return FALSE;
dbus_message_unref (reply);
return TRUE;
}
/**
* libhal_device_is_caller_locked_out:
* @ctx: the context for the connection to hald
* @udi: the Unique id of device
* @interface: the intername name to check
* @caller: the caller to check for
* @error: pointer to an initialized dbus error object for returning errors
*
* Determines whether a given process on the system message bus is
* locked out from an interface on a specific device. Only HAL helpers
* are privileged to use this method.
*
* Returns: Whether the given caller is locked out
**/
dbus_bool_t
libhal_device_is_caller_locked_out (LibHalContext *ctx,
const char *udi,
const char *interface,
const char *caller,
DBusError *error)
{
DBusMessage *message;
DBusMessageIter iter;
DBusMessage *reply;
DBusMessageIter reply_iter;
dbus_bool_t value;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, TRUE);
LIBHAL_CHECK_UDI_VALID(udi, TRUE);
LIBHAL_CHECK_PARAM_VALID(interface, "*interface", TRUE);
LIBHAL_CHECK_PARAM_VALID(caller, "*caller", TRUE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
udi,
"org.freedesktop.Hal.Device",
"IsCallerLockedOut");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return TRUE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &interface);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &caller);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return TRUE;
}
if (reply == NULL)
return TRUE;
/* now analyze reply */
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_BOOLEAN) {
dbus_message_unref (reply);
return TRUE;
}
dbus_message_iter_get_basic (&reply_iter, &value);
dbus_message_unref (reply);
return value;
}
/**
* libhal_ctx_set_global_interface_lock_acquired:
* @ctx: the context for the connection to hald
* @callback: the callback
*
* Set the callback for when a global interface lock is acquired.
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_global_interface_lock_acquired (LibHalContext *ctx, LibHalGlobalInterfaceLockAcquired callback)
{
LIBHAL_CHECK_LIBHALCONTEXT (ctx, FALSE);
ctx->global_interface_lock_acquired = callback;
return TRUE;
}
/**
* libhal_ctx_set_global_interface_lock_released:
* @ctx: the context for the connection to hald
* @callback: the callback
*
* Set the callback for when a global interface lock is released.
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_global_interface_lock_released (LibHalContext *ctx, LibHalGlobalInterfaceLockReleased callback)
{
LIBHAL_CHECK_LIBHALCONTEXT (ctx, FALSE);
ctx->global_interface_lock_released = callback;
return TRUE;
}
/**
* libhal_ctx_set_interface_lock_acquired:
* @ctx: the context for the connection to hald
* @callback: the callback
*
* Set the callback for when an interface lock is acquired.
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_interface_lock_acquired (LibHalContext *ctx, LibHalInterfaceLockAcquired callback)
{
LIBHAL_CHECK_LIBHALCONTEXT (ctx, FALSE);
ctx->interface_lock_acquired = callback;
return TRUE;
}
/**
* libhal_ctx_set_interface_lock_released:
* @ctx: the context for the connection to hald
* @callback: the callback
*
* Set the callback for when an interface lock is released.
*
* Returns: TRUE if callback was successfully set, FALSE otherwise
*/
dbus_bool_t
libhal_ctx_set_interface_lock_released (LibHalContext *ctx, LibHalInterfaceLockReleased callback)
{
LIBHAL_CHECK_LIBHALCONTEXT (ctx, FALSE);
ctx->interface_lock_released = callback;
return TRUE;
}
/**
* libhal_device_is_locked_by_others:
* @ctx: the context for the connection to hald
* @udi: the Unique id of device
* @interface: the intername name to check
* @error: pointer to an initialized dbus error object for returning errors or NULL
*
* Determines whether a determines other processes than the caller holds a lock on the given device.
*
* Returns: If another process is holding a lock on the device
**/
dbus_bool_t
libhal_device_is_locked_by_others (LibHalContext *ctx,
const char *udi,
const char *interface,
DBusError *error)
{
DBusMessage *message;
DBusMessageIter iter;
DBusMessage *reply;
DBusMessageIter reply_iter;
dbus_bool_t value;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, TRUE);
LIBHAL_CHECK_UDI_VALID(udi, TRUE);
LIBHAL_CHECK_PARAM_VALID(interface, "*interface", TRUE);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
udi,
"org.freedesktop.Hal.Device",
"IsLockedByOthers");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return TRUE;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &interface);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return TRUE;
}
if (reply == NULL)
return TRUE;
/* now analyze reply */
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_BOOLEAN) {
dbus_message_unref (reply);
return TRUE;
}
dbus_message_iter_get_basic (&reply_iter, &value);
dbus_message_unref (reply);
return value;
}
/**
* libhal_device_is_caller_privileged:
* @ctx: the context for the connection to hald
* @udi: the Unique id of device
* @action: the action to check for
* @caller: the caller to check for
* @error: pointer to an initialized dbus error object for returning errors
*
* Determines if a given caller have a given privilege on a given
* device. Will always error out if HAL is not built with PolicyKit
* support.
*
* Returns: The textual reply from PolicyKit. See the #PolicyKitResult
* enumeration in the PolicyKit documentation for details. The caller
* is responsible for freeing this string with the function
* libhal_free_string().
**/
char*
libhal_device_is_caller_privileged (LibHalContext *ctx,
const char *udi,
const char *action,
const char *caller,
DBusError *error)
{
DBusMessage *message;
DBusMessageIter iter;
DBusMessage *reply;
DBusMessageIter reply_iter;
char *dbus_str;
char *value;
LIBHAL_CHECK_LIBHALCONTEXT(ctx, NULL);
LIBHAL_CHECK_UDI_VALID(udi, NULL);
LIBHAL_CHECK_PARAM_VALID(action, "*action", NULL);
LIBHAL_CHECK_PARAM_VALID(caller, "*caller", NULL);
message = dbus_message_new_method_call ("org.freedesktop.Hal",
udi,
"org.freedesktop.Hal.Device",
"IsCallerPrivileged");
if (message == NULL) {
fprintf (stderr,
"%s %d : Couldn't allocate D-BUS message\n",
__FILE__, __LINE__);
return NULL;
}
dbus_message_iter_init_append (message, &iter);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &action);
dbus_message_iter_append_basic (&iter, DBUS_TYPE_STRING, &caller);
reply = dbus_connection_send_with_reply_and_block (ctx->connection,
message, -1,
error);
dbus_message_unref (message);
if (error != NULL && dbus_error_is_set (error)) {
return NULL;
}
if (reply == NULL)
return NULL;
/* now analyze reply */
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_STRING) {
dbus_message_unref (reply);
return NULL;
}
dbus_message_iter_get_basic (&reply_iter, &dbus_str);
value = (char *) ((dbus_str != NULL) ? strdup (dbus_str) : NULL);
if (value == NULL) {
fprintf (stderr, "%s %d : error allocating memory\n", __FILE__, __LINE__);
}
dbus_message_unref (reply);
return value;
}
/**
* libhal_get_all_devices_with_properties:
* @out_num_devices: Return location for number of devices
* @out_udi: Return location for array of of udi's. Caller should free this with libhal_free_string_array() when done with it.
* @out_properties: Return location for array of #LibHalPropertySet objects. Caller should free each one of them with libhal_free_property_set() when done with it
* @error: Return location for error
*
* Get all devices in the hal database as well as all properties for each device.
*
* Return: %TRUE if success; %FALSE and @error will be set.
**/
dbus_bool_t libhal_get_all_devices_with_properties (LibHalContext *ctx,
int *out_num_devices,
char ***out_udi,
LibHalPropertySet ***out_properties,
DBusError *error)
{
DBusMessage *message;
DBusMessage *reply;
DBusMessageIter iter_array, reply_iter;
DBusError _error;
char **udi_array;
char **_udi_array;
LibHalPropertySet **prop_array;
LibHalPropertySet **_prop_array;
size_t count;
unsigned int n;
LIBHAL_CHECK_LIBHALCONTEXT (ctx, FALSE);
LIBHAL_CHECK_PARAM_VALID (out_num_devices, "*out_num_devices",FALSE);
LIBHAL_CHECK_PARAM_VALID (out_udi, "***out_udi", FALSE);
LIBHAL_CHECK_PARAM_VALID (out_properties, "***out_properties", FALSE);
*out_num_devices = 0;
*out_udi = NULL;
*out_properties = NULL;
count = 0;
udi_array = NULL;
prop_array = NULL;
message = dbus_message_new_method_call ("org.freedesktop.Hal",
"/org/freedesktop/Hal/Manager",
"org.freedesktop.Hal.Manager",
"GetAllDevicesWithProperties");
if (message == NULL) {
fprintf (stderr, "%s %d : Could not allocate D-BUS message\n", __FILE__, __LINE__);
goto fail;
}
dbus_error_init (&_error);
reply = dbus_connection_send_with_reply_and_block (ctx->connection, message, -1, &_error);
dbus_move_error (&_error, error);
if (error != NULL && dbus_error_is_set (error)) {
dbus_message_unref (message);
goto fail;
}
if (reply == NULL) {
dbus_message_unref (message);
goto fail;
}
/* now analyze reply */
dbus_message_iter_init (reply, &reply_iter);
if (dbus_message_iter_get_arg_type (&reply_iter) != DBUS_TYPE_ARRAY) {
fprintf (stderr, "%s %d : wrong reply from hald. Expecting an array.\n", __FILE__, __LINE__);
goto fail;
}
dbus_message_iter_recurse (&reply_iter, &iter_array);
#define _BLOCK_SIZE 32
udi_array = (char **) malloc (sizeof (char*) * _BLOCK_SIZE);
if (udi_array == NULL)
goto fail;
prop_array = (LibHalPropertySet **) malloc (sizeof (void*) * _BLOCK_SIZE);
if (prop_array == NULL)
goto fail;
while (dbus_message_iter_get_arg_type (&iter_array) == DBUS_TYPE_STRUCT) {
DBusMessageIter iter_struct;
const char *value;
LibHalPropertySet *pset;
char *udi;
if ((count % _BLOCK_SIZE) == 0 && count > 0) {
_udi_array = (char **) realloc (udi_array, sizeof (char*) * (count + _BLOCK_SIZE));
_prop_array = (LibHalPropertySet **) realloc (prop_array, sizeof (void*) * (count+_BLOCK_SIZE));
if (_udi_array == NULL || _prop_array == NULL)
goto fail;
udi_array = _udi_array;
prop_array = _prop_array;
}
dbus_message_iter_recurse (&iter_array, &iter_struct);
dbus_message_iter_get_basic (&iter_struct, &value);
udi = strdup (value);
if (udi == NULL)
goto fail;
dbus_message_iter_next(&iter_struct);
pset = get_property_set (&iter_struct);
udi_array[count] = udi;
prop_array[count] = pset;
count++;
dbus_message_iter_next (&iter_array);
}
if ((count % _BLOCK_SIZE) == 0 && count > 0) {
_udi_array = (char **) realloc (udi_array, sizeof (char*) * (count + _BLOCK_SIZE));
_prop_array = (LibHalPropertySet **) realloc (prop_array, sizeof (void*) * (count + _BLOCK_SIZE));
if (_udi_array == NULL || _prop_array == NULL)
goto fail;
udi_array = _udi_array;
prop_array = _prop_array;
}
udi_array[count] = NULL;
prop_array[count] = NULL;
*out_num_devices = count;
*out_udi = udi_array;
*out_properties = prop_array;
dbus_message_unref (reply);
dbus_message_unref (message);
return TRUE;
fail:
if (udi_array != NULL) {
for (n = 0; n < count; n++) {
free (udi_array[n]);
}
free (udi_array);
}
if (prop_array != NULL) {
for (n = 0; n < count; n++) {
free (prop_array[n]);
}
free (prop_array);
}
return FALSE;
}