  
    
index.htmlMain Page     
modules.htmlModules     
annotated.htmlData Structures     
files.htmlFiles     
pages.htmlRelated Pages   
HAL convenience library
A convenience library used to communicate with the HAL daemon using D-BUS.  
#_detailsMore... Data Structures
struct  structLibHalPropertySet__s.htmlLibHalPropertySet_s  Represents a set of properties.  structLibHalPropertySet__s.html#_detailsMore... struct  structLibHalProperty__s.htmlLibHalProperty_s  Device property class.  structLibHalProperty__s.html#_detailsMore... struct  structLibHalContext__s.htmlLibHalContext_s  Context for connection to the HAL daemon.  structLibHalContext__s.html#_detailsMore... struct  structLibHalPropertySetIterator__s.htmlLibHalPropertySetIterator_s  Iterator for inspecting all properties.  structLibHalPropertySetIterator__s.html#_detailsMore... Typedefs
typedef void(* group__LibHal.html#g894f0989786d813664bf82749153bfb1LibHalIntegrateDBusIntoMainLoop  )(LibHalContext *ctx, DBusConnection *dbus_connection)  Type for function in application code that integrates a DBusConnection object into its own mainloop.  #g894f0989786d813664bf82749153bfb1 typedef void(* group__LibHal.html#gae0a349979b2facc33cffaefa5ecb854LibHalDeviceAdded  )(LibHalContext *ctx, const char *udi)  Type for callback when a device is added.  #gae0a349979b2facc33cffaefa5ecb854 typedef void(* group__LibHal.html#g86ae1246b009d898ffc9dfdeed0ca623LibHalDeviceRemoved  )(LibHalContext *ctx, const char *udi)  Type for callback when a device is removed.  #g86ae1246b009d898ffc9dfdeed0ca623 typedef void(* group__LibHal.html#gbf3956b6ea6197cb387e26cdd0e8d8c6LibHalDeviceNewCapability  )(LibHalContext *ctx, const char *udi, const char *capability)  Type for callback when a device gains a new capability.  #gbf3956b6ea6197cb387e26cdd0e8d8c6 typedef void(* group__LibHal.html#gca727978472d133604830e138201c83aLibHalDeviceLostCapability  )(LibHalContext *ctx, const char *udi, const char *capability)  Type for callback when a device loses a capability.  #gca727978472d133604830e138201c83a typedef void(* group__LibHal.html#gaa8e717584c94defb20c375bfacd78f8LibHalDevicePropertyModified  )(LibHalContext *ctx, const char *udi, const char *key, dbus_bool_t is_removed, dbus_bool_t is_added)  Type for callback when a property of a device changes.  #gaa8e717584c94defb20c375bfacd78f8 typedef void(* group__LibHal.html#g486e784757f222a608eb484f35f8db69LibHalDeviceCondition  )(LibHalContext *ctx, const char *udi, const char *condition_name, const char *condition_detail)  Type for callback when a non-continuous condition occurs on a device.  #g486e784757f222a608eb484f35f8db69 Enumerations
enum  group__LibHal.html#g5e5a8a56bd7ac6141dd67fdefb14f0e6LibHalPropertyType  {   
group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e619b26670d27f9a7fe91dcb441b040c68LIBHAL_PROPERTY_TYPE_INVALID  =  DBUS_TYPE_INVALID, 
group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e6c3a42b401b3833e88ec4aa4c631f96e6LIBHAL_PROPERTY_TYPE_INT32  =  DBUS_TYPE_INT32, 
group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e69b9b049650db0d7c0e90ad6d4a4a67dfLIBHAL_PROPERTY_TYPE_UINT64  =  DBUS_TYPE_UINT64, 
group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e66fff949a9f9ac721a21f8d33a3dfe107LIBHAL_PROPERTY_TYPE_DOUBLE  =  DBUS_TYPE_DOUBLE, 
  
group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e6ddf1c8c88ff976b5440c73eea63edd47LIBHAL_PROPERTY_TYPE_BOOLEAN  =  DBUS_TYPE_BOOLEAN, 
group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e665a50adaddc694a6b4dafa40c8ef6bb8LIBHAL_PROPERTY_TYPE_STRING  =  DBUS_TYPE_STRING, 
group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e65bd27c02eb7c7ecda103daf0da715c30LIBHAL_PROPERTY_TYPE_STRLIST  =  ((int) (DBUS_TYPE_STRING<<8)+('l'))
 }
 Possible types for properties on hal device objects.  group__LibHal.html#g5e5a8a56bd7ac6141dd67fdefb14f0e6More... Functions
void group__LibHal.html#g588e0fe84f2982df4d4e7e99254bcd87libhal_free_string_array  (char **str_array)  Frees a NULL-terminated array of strings.  #g588e0fe84f2982df4d4e7e99254bcd87 static char ** group__LibHal.html#gc3a7699c9f0934c8787459222ae5d703libhal_get_string_array_from_iter  (DBusMessageIter *iter, int *num_elements)  Creates a NULL terminated array of strings from a dbus message iterator.  #gc3a7699c9f0934c8787459222ae5d703 void group__LibHal.html#g848151fe424e9b88eb43bf097cc864a9libhal_free_string  (char *str)  Frees a nul-terminated string.  #g848151fe424e9b88eb43bf097cc864a9 dbus_bool_t group__LibHal.html#gbeb2726ca69a0a04958a9cff8e2d3157libhal_ctx_set_user_data  (LibHalContext *ctx, void *user_data)  Set user data for the context.  #gbeb2726ca69a0a04958a9cff8e2d3157 void * group__LibHal.html#ge39c55292f5e3a5c483101173fb2b416libhal_ctx_get_user_data  (LibHalContext *ctx)  Get user data for the context.  #ge39c55292f5e3a5c483101173fb2b416 static dbus_bool_t group__LibHal.html#g2ed199a1a948140cdcee22c985327c37libhal_property_fill_value_from_variant  (LibHalProperty *p, DBusMessageIter *var_iter)  Fills in the value for the LibHalProperty given a variant iterator.  #g2ed199a1a948140cdcee22c985327c37 LibHalPropertySet * group__LibHal.html#g5dbaa81c388a097396cc4e79866f5f45libhal_device_get_all_properties  (LibHalContext *ctx, const char *udi, DBusError *error)  Retrieve all the properties on a device.  #g5dbaa81c388a097396cc4e79866f5f45 void group__LibHal.html#g22b659f4c4ae06779ed22ef32e510044libhal_free_property_set  (LibHalPropertySet *set)  Free a property set earlier obtained with group__LibHal.html#g5dbaa81c388a097396cc4e79866f5f45libhal_device_get_all_properties() .  #g22b659f4c4ae06779ed22ef32e510044 unsigned int group__LibHal.html#ge7049a1124105f5321663bd71befb65dlibhal_property_set_get_num_elems  (LibHalPropertySet *set)  Get the number of properties in a property set.  #ge7049a1124105f5321663bd71befb65d void group__LibHal.html#gb754976b6dbe4cfea0d7a18024e3ae4flibhal_psi_init  (LibHalPropertySetIterator *iter, LibHalPropertySet *set)  Initialize a property set iterator.  #gb754976b6dbe4cfea0d7a18024e3ae4f dbus_bool_t group__LibHal.html#g8c985761b2909c7bdc49e49a3020abc9libhal_psi_has_more  (LibHalPropertySetIterator *iter)  Determine whether there are more properties to iterate over.  #g8c985761b2909c7bdc49e49a3020abc9 void group__LibHal.html#g8e628cb8aac74bd4fd307c133dc3fa92libhal_psi_next  (LibHalPropertySetIterator *iter)  Advance iterator to next property.  #g8e628cb8aac74bd4fd307c133dc3fa92 group__LibHal.html#g5e5a8a56bd7ac6141dd67fdefb14f0e6LibHalPropertyType  group__LibHal.html#g3df57f4bddd14e70a9237ac5ea16e18flibhal_psi_get_type  (LibHalPropertySetIterator *iter)  Get type of property.  #g3df57f4bddd14e70a9237ac5ea16e18f char * group__LibHal.html#gad021d85a856bad5653a61c82ec0f639libhal_psi_get_key  (LibHalPropertySetIterator *iter)  Get the key of a property.  #gad021d85a856bad5653a61c82ec0f639 char * group__LibHal.html#g4ed11ffe50e9e62ecaa58e49134f9363libhal_psi_get_string  (LibHalPropertySetIterator *iter)  Get the value of a property of type string.  #g4ed11ffe50e9e62ecaa58e49134f9363 dbus_int32_t group__LibHal.html#ga743b4a7eab85fc493d27cfea2e91099libhal_psi_get_int  (LibHalPropertySetIterator *iter)  Get the value of a property of type signed integer.  #ga743b4a7eab85fc493d27cfea2e91099 dbus_uint64_t group__LibHal.html#gc644fbe5c10e22607c6f888333561374libhal_psi_get_uint64  (LibHalPropertySetIterator *iter)  Get the value of a property of type unsigned integer.  #gc644fbe5c10e22607c6f888333561374 double group__LibHal.html#gc4a16711253ae21e9a99d18ca1644e30libhal_psi_get_double  (LibHalPropertySetIterator *iter)  Get the value of a property of type double.  #gc4a16711253ae21e9a99d18ca1644e30 dbus_bool_t group__LibHal.html#gc4a14b72e53feef0a6fe809790c00e53libhal_psi_get_bool  (LibHalPropertySetIterator *iter)  Get the value of a property of type bool.  #gc4a14b72e53feef0a6fe809790c00e53 char ** group__LibHal.html#g08cb49fc20f19674891a6314651cb0e9libhal_psi_get_strlist  (LibHalPropertySetIterator *iter)  Get the value of a property of type string list.  #g08cb49fc20f19674891a6314651cb0e9 char ** group__LibHal.html#g266be22c5155a92d031fbbead26b2da6libhal_get_all_devices  (LibHalContext *ctx, int *num_devices, DBusError *error)  Get all devices in the Global Device List (GDL).  #g266be22c5155a92d031fbbead26b2da6 group__LibHal.html#g5e5a8a56bd7ac6141dd67fdefb14f0e6LibHalPropertyType  group__LibHal.html#g7934d60a97845aea5a9d5575095b3a3alibhal_device_get_property_type  (LibHalContext *ctx, const char *udi, const char *key, DBusError *error)  Query a property type of a device.  #g7934d60a97845aea5a9d5575095b3a3a char ** group__LibHal.html#g00a326eb75e3bca19a69e7adc666bb0dlibhal_device_get_property_strlist  (LibHalContext *ctx, const char *udi, const char *key, DBusError *error)  Get the value of a property of type string list.  #g00a326eb75e3bca19a69e7adc666bb0d char * group__LibHal.html#g066ef29ec76a3389801c7e5980737657libhal_device_get_property_string  (LibHalContext *ctx, const char *udi, const char *key, DBusError *error)  Get the value of a property of type string.  #g066ef29ec76a3389801c7e5980737657 dbus_int32_t group__LibHal.html#g19c851422023ac683db0ff5ef9b118e3libhal_device_get_property_int  (LibHalContext *ctx, const char *udi, const char *key, DBusError *error)  Get the value of a property of type integer.  #g19c851422023ac683db0ff5ef9b118e3 dbus_uint64_t group__LibHal.html#g6b23bf729d1e61e50766394a2be51353libhal_device_get_property_uint64  (LibHalContext *ctx, const char *udi, const char *key, DBusError *error)  Get the value of a property of type signed integer.  #g6b23bf729d1e61e50766394a2be51353 double group__LibHal.html#g482a8d663dd23bab9c2246b423a0f395libhal_device_get_property_double  (LibHalContext *ctx, const char *udi, const char *key, DBusError *error)  Get the value of a property of type double.  #g482a8d663dd23bab9c2246b423a0f395 dbus_bool_t group__LibHal.html#ge8ebd0da6bf3112b522d92a5fe0fcc7flibhal_device_get_property_bool  (LibHalContext *ctx, const char *udi, const char *key, DBusError *error)  Get the value of a property of type bool.  #ge8ebd0da6bf3112b522d92a5fe0fcc7f static dbus_bool_t group__LibHal.html#g85a7c2ab4210e180eef594066e172c6alibhal_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) dbus_bool_t group__LibHal.html#gadd157e098efc40f1827ce5d05e69db2libhal_device_set_property_string  (LibHalContext *ctx, const char *udi, const char *key, const char *value, DBusError *error)  Set a property of type string.  #gadd157e098efc40f1827ce5d05e69db2 dbus_bool_t group__LibHal.html#g2aba1a83610f6c1ebbaaf27d1ddf6113libhal_device_set_property_int  (LibHalContext *ctx, const char *udi, const char *key, dbus_int32_t value, DBusError *error)  Set a property of type signed integer.  #g2aba1a83610f6c1ebbaaf27d1ddf6113 dbus_bool_t group__LibHal.html#g84726584e834b64d487c6961225686a0libhal_device_set_property_uint64  (LibHalContext *ctx, const char *udi, const char *key, dbus_uint64_t value, DBusError *error)  Set a property of type unsigned integer.  #g84726584e834b64d487c6961225686a0 dbus_bool_t group__LibHal.html#gcae2cb49002a001d8488ff8a8970fb2blibhal_device_set_property_double  (LibHalContext *ctx, const char *udi, const char *key, double value, DBusError *error)  Set a property of type double.  #gcae2cb49002a001d8488ff8a8970fb2b dbus_bool_t group__LibHal.html#gd2aeb19524c48b1adbf0136b66773ee8libhal_device_set_property_bool  (LibHalContext *ctx, const char *udi, const char *key, dbus_bool_t value, DBusError *error)  Set a property of type bool.  #gd2aeb19524c48b1adbf0136b66773ee8 dbus_bool_t group__LibHal.html#g9867552685ac98d6883c4859c9e28834libhal_device_remove_property  (LibHalContext *ctx, const char *udi, const char *key, DBusError *error)  Remove a property.  #g9867552685ac98d6883c4859c9e28834 dbus_bool_t group__LibHal.html#gbf07ef68a656f0688674b81e93c81e7clibhal_device_property_strlist_append  (LibHalContext *ctx, const char *udi, const char *key, const char *value, DBusError *error)  Append to a property of type strlist.  #gbf07ef68a656f0688674b81e93c81e7c dbus_bool_t group__LibHal.html#gb776e01e9b35b56494610546c1beda46libhal_device_property_strlist_prepend  (LibHalContext *ctx, const char *udi, const char *key, const char *value, DBusError *error)  Prepend to a property of type strlist.  #gb776e01e9b35b56494610546c1beda46 dbus_bool_t group__LibHal.html#g6eef668b485c1be2d41fe80ecdd84339libhal_device_property_strlist_remove_index  (LibHalContext *ctx, const char *udi, const char *key, unsigned int index, DBusError *error)  Remove a specified string from a property of type strlist.  #g6eef668b485c1be2d41fe80ecdd84339 dbus_bool_t group__LibHal.html#g66655fe0f17d18398c4ba845c397ba3flibhal_device_property_strlist_remove  (LibHalContext *ctx, const char *udi, const char *key, const char *value, DBusError *error)  Remove a specified string from a property of type strlist.  #g66655fe0f17d18398c4ba845c397ba3f dbus_bool_t group__LibHal.html#ge8e59102621c40fb7e3752d82e0f9c69libhal_device_lock  (LibHalContext *ctx, const char *udi, const char *reason_to_lock, char **reason_why_locked, DBusError *error)  Take an advisory lock on the device.  #ge8e59102621c40fb7e3752d82e0f9c69 dbus_bool_t group__LibHal.html#gac5ce16198a137c08bc9c14bdcff3e54libhal_device_unlock  (LibHalContext *ctx, const char *udi, DBusError *error)  Release an advisory lock on the device.  #gac5ce16198a137c08bc9c14bdcff3e54 char * group__LibHal.html#g0296ccbb340bb4f2adff509aa04604a4libhal_new_device  (LibHalContext *ctx, DBusError *error)  Create a new device object which will be hidden from applications until the CommitToGdl(), ie.  #g0296ccbb340bb4f2adff509aa04604a4 dbus_bool_t group__LibHal.html#g59038b98ab8c170e45af95aea3362a0dlibhal_device_commit_to_gdl  (LibHalContext *ctx, const char *temp_udi, const char *udi, DBusError *error)  When a hidden device has been built using the NewDevice method, ie.  #g59038b98ab8c170e45af95aea3362a0d dbus_bool_t group__LibHal.html#gbea3640ca3da909d0b996a3475c76145libhal_remove_device  (LibHalContext *ctx, const char *udi, DBusError *error)  This method can be invoked when a device is removed.  #gbea3640ca3da909d0b996a3475c76145 dbus_bool_t group__LibHal.html#g3fd17b23cd1ccc7a16072c4e94bfbfb3libhal_device_exists  (LibHalContext *ctx, const char *udi, DBusError *error)  Determine if a device exists.  #g3fd17b23cd1ccc7a16072c4e94bfbfb3 dbus_bool_t group__LibHal.html#g9c423145ebe05084f4a5f1e51a7c19f1libhal_device_property_exists  (LibHalContext *ctx, const char *udi, const char *key, DBusError *error)  Determine if a property on a device exists.  #g9c423145ebe05084f4a5f1e51a7c19f1 dbus_bool_t group__LibHal.html#g9f7dfefe5d8fae2e0f20c2382a4694fflibhal_merge_properties  (LibHalContext *ctx, const char *target_udi, const char *source_udi, DBusError *error)  Merge properties from one device to another.  #g9f7dfefe5d8fae2e0f20c2382a4694ff dbus_bool_t group__LibHal.html#g38c79be0409c7962fc0a36462429d90dlibhal_device_matches  (LibHalContext *ctx, const char *udi1, const char *udi2, const char *property_namespace, DBusError *error)  Check a set of properties for two devices matches.  #g38c79be0409c7962fc0a36462429d90d dbus_bool_t group__LibHal.html#g92eae8c7e513a0da01b8a54a6176f0dalibhal_device_print  (LibHalContext *ctx, const char *udi, DBusError *error)  Print a device to stdout; useful for debugging.  #g92eae8c7e513a0da01b8a54a6176f0da char ** group__LibHal.html#g06a613466c9e59ae7d5ba0406a031a3flibhal_manager_find_device_string_match  (LibHalContext *ctx, const char *key, const char *value, int *num_devices, DBusError *error)  Find a device in the GDL where a single string property matches a given value.  #g06a613466c9e59ae7d5ba0406a031a3f dbus_bool_t group__LibHal.html#gb299138b688751ab1e07ea78568a1a57libhal_device_add_capability  (LibHalContext *ctx, const char *udi, const char *capability, DBusError *error)  Assign a capability to a device.  #gb299138b688751ab1e07ea78568a1a57 dbus_bool_t group__LibHal.html#gd817c044708a4749a44d180bf36dc04flibhal_device_query_capability  (LibHalContext *ctx, const char *udi, const char *capability, DBusError *error)  Check if a device has a capability.  #gd817c044708a4749a44d180bf36dc04f char ** group__LibHal.html#gcd36d04ce7bb118cb3b93d2b156754a1libhal_find_device_by_capability  (LibHalContext *ctx, const char *capability, int *num_devices, DBusError *error)  Find devices with a given capability.  #gcd36d04ce7bb118cb3b93d2b156754a1 dbus_bool_t group__LibHal.html#g088e20ae9bc64da0c56686914cca779alibhal_device_property_watch_all  (LibHalContext *ctx, DBusError *error)  Watch all devices, ie.  #g088e20ae9bc64da0c56686914cca779a dbus_bool_t group__LibHal.html#g3c2c7e729c04d06235f9bfb2c0121773libhal_device_add_property_watch  (LibHalContext *ctx, const char *udi, DBusError *error)  Add a watch on a device, so the device_property_changed callback is invoked when the properties on the given device changes.  #g3c2c7e729c04d06235f9bfb2c0121773 dbus_bool_t group__LibHal.html#gccc89d8c9b9b4c702427c5e3f44ad989libhal_device_remove_property_watch  (LibHalContext *ctx, const char *udi, DBusError *error)  Remove a watch on a device.  #gccc89d8c9b9b4c702427c5e3f44ad989 LibHalContext * group__LibHal.html#gb424ee1341182290f98a54490f1c6512libhal_ctx_new  (void)  Create a new LibHalContext.  #gb424ee1341182290f98a54490f1c6512 dbus_bool_t group__LibHal.html#g36823cdb437cf58e6a0acf4ce0ecbe49libhal_ctx_set_cache  (LibHalContext *ctx, dbus_bool_t use_cache)  Enable or disable caching.  #g36823cdb437cf58e6a0acf4ce0ecbe49 dbus_bool_t group__LibHal.html#g27ba5c46b35e171ce03ffbd003878157libhal_ctx_set_dbus_connection  (LibHalContext *ctx, DBusConnection *conn)  Set DBus connection to use to talk to hald.  #g27ba5c46b35e171ce03ffbd003878157 dbus_bool_t group__LibHal.html#g2376b4debf5a4a65ae35dec397846846libhal_ctx_init  (LibHalContext *ctx, DBusError *error)  Initialize the connection to hald.  #g2376b4debf5a4a65ae35dec397846846 LibHalContext * group__LibHal.html#gac5e017f5a339cf4904c8d3ccf03bdd9libhal_ctx_init_direct  (DBusError *error)  Create an already initialized connection to hald.  #gac5e017f5a339cf4904c8d3ccf03bdd9 dbus_bool_t group__LibHal.html#gc898742f7853a8b7d70569886b8b2a3alibhal_ctx_shutdown  (LibHalContext *ctx, DBusError *error)  Shut down a connection to hald.  #gc898742f7853a8b7d70569886b8b2a3a dbus_bool_t group__LibHal.html#g438a1cbf67b357979b903be9fe23b652libhal_ctx_free  (LibHalContext *ctx)  Free a LibHalContext resource.  #g438a1cbf67b357979b903be9fe23b652 dbus_bool_t group__LibHal.html#g515dc39e668b7737dda9c2c340c5788elibhal_ctx_set_device_added  (LibHalContext *ctx, group__LibHal.html#gae0a349979b2facc33cffaefa5ecb854LibHalDeviceAdded  callback)  Set the callback for when a device is added.  #g515dc39e668b7737dda9c2c340c5788e dbus_bool_t group__LibHal.html#g9b47944eb3514325abfd7698f4cd7fd9libhal_ctx_set_device_removed  (LibHalContext *ctx, group__LibHal.html#g86ae1246b009d898ffc9dfdeed0ca623LibHalDeviceRemoved  callback)  Set the callback for when a device is removed.  #g9b47944eb3514325abfd7698f4cd7fd9 dbus_bool_t group__LibHal.html#ga3c245e6b37f716541639a321222a3b7libhal_ctx_set_device_new_capability  (LibHalContext *ctx, group__LibHal.html#gbf3956b6ea6197cb387e26cdd0e8d8c6LibHalDeviceNewCapability  callback)  Set the callback for when a device gains a new capability.  #ga3c245e6b37f716541639a321222a3b7 dbus_bool_t group__LibHal.html#gc902a0065183c7cafd53b8634693c527libhal_ctx_set_device_lost_capability  (LibHalContext *ctx, group__LibHal.html#gca727978472d133604830e138201c83aLibHalDeviceLostCapability  callback)  Set the callback for when a device loses a capability.  #gc902a0065183c7cafd53b8634693c527 dbus_bool_t group__LibHal.html#gdd2847764061001993e4ecb3c1ef9d13libhal_ctx_set_device_property_modified  (LibHalContext *ctx, group__LibHal.html#gaa8e717584c94defb20c375bfacd78f8LibHalDevicePropertyModified  callback)  Set the callback for when a property is modified on a device.  #gdd2847764061001993e4ecb3c1ef9d13 dbus_bool_t group__LibHal.html#g5d10b018ee9c4876c4b4ec995c98b20clibhal_ctx_set_device_condition  (LibHalContext *ctx, group__LibHal.html#g486e784757f222a608eb484f35f8db69LibHalDeviceCondition  callback)  Set the callback for when a device emits a condition.  #g5d10b018ee9c4876c4b4ec995c98b20c unsigned int group__LibHal.html#g20d34c56df67cce6d3acba353b16544clibhal_string_array_length  (char **str_array)  Get the length of an array of strings.  #g20d34c56df67cce6d3acba353b16544c dbus_bool_t 
group__LibHal.html#gbdf821add21f86d5a9309f4f09d3aca5libhal_device_rescan  (LibHalContext *ctx, const char *udi, DBusError *error) dbus_bool_t 
group__LibHal.html#g7a2190fa06020ee3eb0dec6623ec495dlibhal_device_reprobe  (LibHalContext *ctx, const char *udi, DBusError *error) dbus_bool_t group__LibHal.html#g502be45f68713bdf62e8447bbfc53872libhal_device_emit_condition  (LibHalContext *ctx, const char *udi, const char *condition_name, const char *condition_details, DBusError *error)  Emit a condition from a device.  #g502be45f68713bdf62e8447bbfc53872 Variables
static dbus_bool_t 
group__LibHal.html#g66aa14ec352ba52d12d0aa2508cca17dlibhal_already_initialized_once  = FALSE Detailed Description
A convenience library used to communicate with the HAL daemon using D-BUS. 
Typedef Documentation
  
    
      
        
          
typedef void(* group__LibHal.html#gae0a349979b2facc33cffaefa5ecb854LibHalDeviceAdded )(LibHalContext *ctx, const char *udi)                  
      
    
  
  
    
       
    
    
Type for callback when a device is added. 
Parameters:  
    
ctx Context for connection to hald     
udi Unique Device Id   
Definition at line 
libhal_8h-source.html#l0009797  of file libhal_8h-source.htmllibhal.h .      
  
    
      
        
          
typedef void(* group__LibHal.html#g486e784757f222a608eb484f35f8db69LibHalDeviceCondition )(LibHalContext *ctx, const char *udi, const char *condition_name, const char *condition_detail)                  
      
    
  
  
    
       
    
    
Type for callback when a non-continuous condition occurs on a device. 
Parameters:  
    
ctx Context for connection to hald     
udi Unique Device Id     
condition_name Name of the condition, e.g. ProcessorOverheating. Consult the HAL spec for possible conditions     
condition_detail User-readable details of condition   
Definition at line 
libhal_8h-source.html#l00151151  of file libhal_8h-source.htmllibhal.h .      
  
    
      
        
          
typedef void(* group__LibHal.html#gca727978472d133604830e138201c83aLibHalDeviceLostCapability )(LibHalContext *ctx, const char *udi, const char *capability)                  
      
    
  
  
    
       
    
    
Type for callback when a device loses a capability. 
Parameters:  
    
ctx Context for connection to hald     
udi Unique Device Id     
capability Capability of the device   
Definition at line 
libhal_8h-source.html#l00124124  of file libhal_8h-source.htmllibhal.h .      
  
    
      
        
          
typedef void(* group__LibHal.html#gbf3956b6ea6197cb387e26cdd0e8d8c6LibHalDeviceNewCapability )(LibHalContext *ctx, const char *udi, const char *capability)                  
      
    
  
  
    
       
    
    
Type for callback when a device gains a new capability. 
Parameters:  
    
ctx Context for connection to hald     
udi Unique Device Id     
capability Capability of the device   
Definition at line 
libhal_8h-source.html#l00114114  of file libhal_8h-source.htmllibhal.h .      
  
    
      
        
          
typedef void(* group__LibHal.html#gaa8e717584c94defb20c375bfacd78f8LibHalDevicePropertyModified )(LibHalContext *ctx, const char *udi, const char *key, dbus_bool_t is_removed, dbus_bool_t is_added)                  
      
    
  
  
    
       
    
    
Type for callback when a property of a device changes. 
Parameters:  
    
ctx Context for connection to hald     
udi Unique Device Id     
key Name of the property that has changed     
is_removed Whether or not property was removed     
is_added Whether or not property was added   
Definition at line 
libhal_8h-source.html#l00136136  of file libhal_8h-source.htmllibhal.h .      
  
    
      
        
          
typedef void(* group__LibHal.html#g86ae1246b009d898ffc9dfdeed0ca623LibHalDeviceRemoved )(LibHalContext *ctx, const char *udi)                  
      
    
  
  
    
       
    
    
Type for callback when a device is removed. 
Parameters:  
    
ctx Context for connection to hald     
udi Unique Device Id   
Definition at line 
libhal_8h-source.html#l00105105  of file libhal_8h-source.htmllibhal.h .      
  
    
      
        
          
typedef void(* group__LibHal.html#g894f0989786d813664bf82749153bfb1LibHalIntegrateDBusIntoMainLoop )(LibHalContext *ctx, DBusConnection *dbus_connection)                  
      
    
  
  
    
       
    
    
Type for function in application code that integrates a DBusConnection object into its own mainloop. 
Parameters:  
    
ctx Context for connection to hald     
dbus_connection DBus connection to use in ctx   
Definition at line 
libhal_8h-source.html#l0008989  of file libhal_8h-source.htmllibhal.h .      
Enumeration Type Documentation
  
    
      
        
          
enum group__LibHal.html#g5e5a8a56bd7ac6141dd67fdefb14f0e6LibHalPropertyType                   
      
    
  
  
    
       
    
    
Possible types for properties on hal device objects. 
Enumerator: LIBHAL_PROPERTY_TYPE_INVALID Used to report error condition. 
LIBHAL_PROPERTY_TYPE_INT32 Type for 32-bit signed integer property. 
LIBHAL_PROPERTY_TYPE_UINT64 Type for 64-bit unsigned integer property. 
LIBHAL_PROPERTY_TYPE_DOUBLE Type for double precision floating point property. 
LIBHAL_PROPERTY_TYPE_BOOLEAN Type for boolean property. 
LIBHAL_PROPERTY_TYPE_STRING Type for UTF-8 string property. 
LIBHAL_PROPERTY_TYPE_STRLIST Type for list of UTF-8 strings property. 
Definition at line 
libhal_8h-source.html#l0005656  of file libhal_8h-source.htmllibhal.h .      
Function Documentation
  
    
      
        
          
dbus_bool_t libhal_ctx_free                     
(           
LibHalContext *           
 ctx                    
 )           
        
      
    
  
  
    
       
    
    
Free a LibHalContext resource. 
Parameters:  
    
ctx Pointer to a LibHalContext   
Returns:TRUE Definition at line 
libhal_8c-source.html#l030643064  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02985libhal_ctx_init_direct() .      
  
    
      
        
          
void * libhal_ctx_get_user_data                     
(           
LibHalContext *           
 ctx                    
 )           
        
      
    
  
  
    
       
    
    
Get user data for the context. 
Parameters:  
    
ctx The context for the connection to hald   
Returns:Opaque pointer stored through libhal_ctx_set_user_data or NULL if not set Definition at line 
libhal_8c-source.html#l00240240  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_ctx_init                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Initialize the connection to hald. 
Parameters:  
    
ctx Context for connection to hald (connection should be set with libhal_ctx_set_dbus_connection)     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if initialization succeeds, FALSE otherwise Definition at line 
libhal_8c-source.html#l029372937  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
LibHalContext * libhal_ctx_init_direct                     
(           
DBusError *           
 error                    
 )           
        
      
    
  
  
    
       
    
    
Create an already initialized connection to hald. 
Parameters:  
    
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:A pointer to an already initialized LibHalContext Definition at line 
libhal_8c-source.html#l029852985  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l03064libhal_ctx_free() , and libhal_8c-source.html#l02864libhal_ctx_new() .      
  
    
      
        
          
LibHalContext * libhal_ctx_new                     
(           
void           
                    
 )           
        
      
    
  
  
    
       
    
    
Create a new LibHalContext. 
Returns:a new uninitialized LibHalContext Definition at line 
libhal_8c-source.html#l028642864  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l00761libhal_already_initialized_once .
Referenced by 
libhal_8c-source.html#l02985libhal_ctx_init_direct() .      
  
    
      
        
          
dbus_bool_t libhal_ctx_set_cache                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
dbus_bool_t           
 use_cache         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Enable or disable caching. 
Note:Cache is not actually implemented yet.Parameters:  
    
ctx Context to enable/disable cache for     
use_cache Whether or not to use cache   
Returns:TRUE if cache was successfully enabled/disabled, FALSE otherwise Definition at line 
libhal_8c-source.html#l029012901  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_ctx_set_dbus_connection                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
DBusConnection *           
 conn         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set DBus connection to use to talk to hald. 
Parameters:  
    
ctx Context to set connection for     
conn DBus connection to use   
Returns:TRUE if connection was successfully set, FALSE otherwise Definition at line 
libhal_8c-source.html#l029172917  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_ctx_set_device_added                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
group__LibHal.html#gae0a349979b2facc33cffaefa5ecb854LibHalDeviceAdded            
 callback         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set the callback for when a device is added. 
Parameters:  
    
ctx The context for the connection to hald     
callback The function to call when a device is added   
Returns:TRUE if callback was successfully set, FALSE otherwise Definition at line 
libhal_8c-source.html#l030783078  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_ctx_set_device_condition                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
group__LibHal.html#g486e784757f222a608eb484f35f8db69LibHalDeviceCondition            
 callback         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set the callback for when a device emits a condition. 
Parameters:  
    
ctx The context for the connection to hald     
callback The function to call when a device emits a condition   
Returns:TRUE if callback was successfully set, FALSE otherwise Definition at line 
libhal_8c-source.html#l031613161  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_ctx_set_device_lost_capability                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
group__LibHal.html#gca727978472d133604830e138201c83aLibHalDeviceLostCapability            
 callback         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set the callback for when a device loses a capability. 
Parameters:  
    
ctx The context for the connection to hald     
callback The function to call when a device loses a capability   
Returns:TRUE if callback was successfully set, FALSE otherwise Definition at line 
libhal_8c-source.html#l031283128  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_ctx_set_device_new_capability                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
group__LibHal.html#gbf3956b6ea6197cb387e26cdd0e8d8c6LibHalDeviceNewCapability            
 callback         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set the callback for when a device gains a new capability. 
Parameters:  
    
ctx The context for the connection to hald     
callback The function to call when a device gains a new capability   
Returns:TRUE if callback was successfully set, FALSE otherwise Definition at line 
libhal_8c-source.html#l031113111  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_ctx_set_device_property_modified                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
group__LibHal.html#gaa8e717584c94defb20c375bfacd78f8LibHalDevicePropertyModified            
 callback         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set the callback for when a property is modified on a device. 
Parameters:  
    
ctx The context for the connection to hald     
callback The function to call when a property is modified on a device   
Returns:TRUE if callback was successfully set, FALSE otherwise Definition at line 
libhal_8c-source.html#l031453145  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_ctx_set_device_removed                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
group__LibHal.html#g86ae1246b009d898ffc9dfdeed0ca623LibHalDeviceRemoved            
 callback         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set the callback for when a device is removed. 
Parameters:  
    
ctx The context for the connection to hald     
callback The function to call when a device is removed   
Returns:TRUE if callback was successfully set, FALSE otherwise Definition at line 
libhal_8c-source.html#l030943094  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_ctx_set_user_data                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
void *           
 user_data         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set user data for the context. 
Parameters:  
    
ctx The context for the connection to hald     
user_data Opaque pointer   
Returns:TRUE if user data was successfully set, FALSE if otherwise Definition at line 
libhal_8c-source.html#l00226226  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_ctx_shutdown                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Shut down a connection to hald. 
Parameters:  
    
ctx Context for connection to hald     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if connection successfully shut down, FALSE otherwise todo.html#_todo000007Todo: clean up Definition at line 
libhal_8c-source.html#l030263026  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_add_capability                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 capability,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Assign a capability to a device. 
Parameters:  
    
ctx The context for the connection to hald     
udi Unique Device Id     
capability Capability name     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if the capability was added, FALSE if the device didn't exist Definition at line 
libhal_8c-source.html#l026302630  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_add_property_watch                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
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.
Parameters:  
    
ctx The context for the connection to hald     
udi Unique Device Id     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE only if the operation succeeded Definition at line 
libhal_8c-source.html#l028122812  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_commit_to_gdl                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 temp_udi,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
When a hidden device has been built using the NewDevice method, ie. 
group__LibHal.html#g0296ccbb340bb4f2adff509aa04604a4libhal_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.
Parameters:  
    
ctx The context for the connection to hald     
temp_udi The temporary unique device id as returned by group__LibHal.html#g0296ccbb340bb4f2adff509aa04604a4libhal_new_device()      
udi The new unique device id.     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:FALSE if the given unique device id is already in use. Definition at line 
libhal_8c-source.html#l021012101  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_emit_condition                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 condition_name,         
        
          
          
          
const char *           
 condition_details,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Emit a condition from a device. 
Parameters:  
    
ctx Context for connection to hald     
udi 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   
Returns:TRUE if condition successfully emitted, FALSE otherwise Definition at line 
libhal_8c-source.html#l032983298  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_exists                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Determine if a device exists. 
Parameters:  
    
ctx The context for the connection to hald     
udi Unique device id.     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if the device exists Definition at line 
libhal_8c-source.html#l022062206  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
LibHalPropertySet * libhal_device_get_all_properties                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Retrieve all the properties on a device. 
Parameters:  
    
ctx The context for the connection to hald     
udi Unique id of device     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:An object represent all properties. Must be freed with libhal_free_property_set todo.html#_todo000003Todo: FIXME cleanup Definition at line 
libhal_8c-source.html#l00342342  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l00253libhal_property_fill_value_from_variant() .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() , libhal-storage_8c-source.html#l00822libhal_drive_from_udi() , libhal-storage_8c-source.html#l01005libhal_volume_from_udi() , and libhal-storage_8c-source.html#l01588mopts_collect() .      
  
    
      
        
          
dbus_bool_t libhal_device_get_property_bool                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Get the value of a property of type bool. 
Parameters:  
    
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   
Returns:Property value (boolean) Definition at line 
libhal_8c-source.html#l013921392  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal-storage_8c-source.html#l01529libhal_drive_policy_default_use_managed_keyword() .      
  
    
      
        
          
double libhal_device_get_property_double                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Get the value of a property of type double. 
Parameters:  
    
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   
Returns:Property value (IEEE754 double precision float) Definition at line 
libhal_8c-source.html#l013241324  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_int32_t libhal_device_get_property_int                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Get the value of a property of type integer. 
Parameters:  
    
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   
Returns:Property value (32-bit signed integer) Definition at line 
libhal_8c-source.html#l011871187  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
char * libhal_device_get_property_string                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Get the value of a property of type string. 
Parameters:  
    
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   
Returns:UTF8 nul-terminated string. The caller is responsible for freeing this string with the function group__LibHal.html#g848151fe424e9b88eb43bf097cc864a9libhal_free_string() . Returns NULL if the property didn't exist or we are OOM todo.html#_todo000004Todo: FIXME cleanup Definition at line 
libhal_8c-source.html#l011121112  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal-storage_8c-source.html#l01155libhal_drive_from_device_file() , libhal-storage_8c-source.html#l01541libhal_drive_policy_default_get_managed_keyword_primary() , libhal-storage_8c-source.html#l01553libhal_drive_policy_default_get_managed_keyword_secondary() , and libhal-storage_8c-source.html#l01517libhal_drive_policy_default_get_mount_root() .      
  
    
      
        
          
char ** libhal_device_get_property_strlist                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Get the value of a property of type string list. 
Parameters:  
    
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   
Returns:Array of pointers to UTF8 nul-terminated strings terminated by NULL. The caller is responsible for freeing this string array with the function group__LibHal.html#g588e0fe84f2982df4d4e7e99254bcd87libhal_free_string_array() . Returns NULL if the property didn't exist or we are OOM Definition at line 
libhal_8c-source.html#l010431043  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l00096libhal_get_string_array_from_iter() .
Referenced by 
libhal_8c-source.html#l02683libhal_device_query_capability() .      
  
    
      
        
          
group__LibHal.html#g5e5a8a56bd7ac6141dd67fdefb14f0e6LibHalPropertyType  libhal_device_get_property_type                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Query a property type of a device. 
Parameters:  
    
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   
Returns:One of LIBHAL_PROPERTY_TYPE_INT32, LIBHAL_PROPERTY_TYPE_UINT64, LIBHAL_PROPERTY_TYPE_DOUBLE, LIBHAL_PROPERTY_TYPE_BOOLEAN, LIBHAL_PROPERTY_TYPE_STRING, LIBHAL_PROPERTY_TYPE_STRLIST or LIBHAL_PROPERTY_TYPE_INVALID if property doesn't exist. Definition at line 
libhal_8c-source.html#l00982982  of file libhal_8c-source.htmllibhal.c .
References 
group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e619b26670d27f9a7fe91dcb441b040c68LIBHAL_PROPERTY_TYPE_INVALID .      
  
    
      
        
          
dbus_uint64_t libhal_device_get_property_uint64                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Get the value of a property of type signed integer. 
Parameters:  
    
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   
Returns:Property value (64-bit unsigned integer) Definition at line 
libhal_8c-source.html#l012561256  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_lock                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 reason_to_lock,         
        
          
          
          
char **           
 reason_why_locked,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Take an advisory lock on the device. 
Parameters:  
    
ctx The context for the connection to hald     
udi 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   
Returns:TRUE if the lock was obtained, FALSE otherwise Definition at line 
libhal_8c-source.html#l018961896  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_matches                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi1,         
        
          
          
          
const char *           
 udi2,         
        
          
          
          
const char *           
 property_namespace,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
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.
Parameters:  
    
ctx The context for the connection to hald     
udi1 Unique Device Id for device 1     
udi2 Unique Device Id for device 2     
property_namespace Namespace for set of devices, e.g. "usb"     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if all properties starting with the given namespace parameter from one device is in the other and have the same value. Definition at line 
libhal_8c-source.html#l024052405  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_print                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Print a device to stdout; useful for debugging. 
Parameters:  
    
ctx The context for the connection to hald     
udi Unique Device Id     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if device's information could be obtained, FALSE otherwise Definition at line 
libhal_8c-source.html#l024762476  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l00342libhal_device_get_all_properties() , group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e6ddf1c8c88ff976b5440c73eea63edd47LIBHAL_PROPERTY_TYPE_BOOLEAN , group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e66fff949a9f9ac721a21f8d33a3dfe107LIBHAL_PROPERTY_TYPE_DOUBLE , group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e6c3a42b401b3833e88ec4aa4c631f96e6LIBHAL_PROPERTY_TYPE_INT32 , group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e665a50adaddc694a6b4dafa40c8ef6bb8LIBHAL_PROPERTY_TYPE_STRING , group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e65bd27c02eb7c7ecda103daf0da715c30LIBHAL_PROPERTY_TYPE_STRLIST , group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e69b9b049650db0d7c0e90ad6d4a4a67dfLIBHAL_PROPERTY_TYPE_UINT64 , libhal_8c-source.html#l00636libhal_psi_get_bool() , libhal_8c-source.html#l00625libhal_psi_get_double() , libhal_8c-source.html#l00603libhal_psi_get_int() , libhal_8c-source.html#l00578libhal_psi_get_key() , libhal_8c-source.html#l00592libhal_psi_get_string() , libhal_8c-source.html#l00647libhal_psi_get_strlist() , libhal_8c-source.html#l00564libhal_psi_get_type() , libhal_8c-source.html#l00614libhal_psi_get_uint64() , libhal_8c-source.html#l00542libhal_psi_has_more() , libhal_8c-source.html#l00524libhal_psi_init() , and libhal_8c-source.html#l00552libhal_psi_next() .      
  
    
      
        
          
dbus_bool_t libhal_device_property_exists                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Determine if a property on a device exists. 
Parameters:  
    
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   
Returns:TRUE if the device exists, FALSE otherwise Definition at line 
libhal_8c-source.html#l022742274  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_property_strlist_append                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
const char *           
 value,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Append to a property of type strlist. 
Parameters:  
    
ctx The context for the connection to hald     
udi 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   
Returns:TRUE if the value was appended, FALSE if the device didn't exist or the property had a different type. Definition at line 
libhal_8c-source.html#l016861686  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_property_strlist_prepend                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
const char *           
 value,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Prepend to a property of type strlist. 
Parameters:  
    
ctx The context for the connection to hald     
udi 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   
Returns:TRUE if the value was prepended, FALSE if the device didn't exist or the property had a different type. Definition at line 
libhal_8c-source.html#l017381738  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_property_strlist_remove                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
const char *           
 value,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Remove a specified string from a property of type strlist. 
Parameters:  
    
ctx The context for the connection to hald     
udi Unique Device Id     
key Name of the property     
value The string to search for and remove     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if the string was removed, FALSE if the device didn't exist or the property had a different type. Definition at line 
libhal_8c-source.html#l018421842  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_property_strlist_remove_index                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
unsigned int           
 index,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Remove a specified string from a property of type strlist. 
Parameters:  
    
ctx The context for the connection to hald     
udi Unique Device Id     
key Name of the property     
index Index of string to remove in the strlist     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if the string was removed, FALSE if the device didn't exist or the property had a different type. Definition at line 
libhal_8c-source.html#l017901790  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_property_watch_all                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Watch all devices, ie. 
the device_property_changed callback is invoked when the properties on any device changes.
Parameters:  
    
ctx The context for the connection to hald     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE only if the operation succeeded Definition at line 
libhal_8c-source.html#l027842784  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_query_capability                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 capability,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Check if a device has a capability. 
The result is undefined if the device doesn't exist.
Parameters:  
    
ctx The context for the connection to hald     
udi Unique Device Id     
capability Capability name     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if the device has the capability, otherwise FALSE Definition at line 
libhal_8c-source.html#l026832683  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l01043libhal_device_get_property_strlist() .
Referenced by 
libhal-storage_8c-source.html#l01155libhal_drive_from_device_file() , libhal-storage_8c-source.html#l00822libhal_drive_from_udi() , libhal-storage_8c-source.html#l01214libhal_volume_from_device_file() , and libhal-storage_8c-source.html#l01005libhal_volume_from_udi() .      
  
    
      
        
          
dbus_bool_t libhal_device_remove_property                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Remove a property. 
Parameters:  
    
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   
Returns:TRUE if the property was set, FALSE if the device didn't exist Definition at line 
libhal_8c-source.html#l016651665  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l01453libhal_device_set_property_helper() .      
  
    
      
        
          
dbus_bool_t libhal_device_remove_property_watch                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Remove a watch on a device. 
Parameters:  
    
ctx The context for the connection to hald     
udi Unique Device Id     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE only if the operation succeeded Definition at line 
libhal_8c-source.html#l028402840  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_device_set_property_bool                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
dbus_bool_t           
 value,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set a property of type bool. 
Parameters:  
    
ctx The context for the connection to hald     
udi 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   
Returns:TRUE if the property was set, FALSE if the device didn't exist or the property had a different type. Definition at line 
libhal_8c-source.html#l016451645  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l01453libhal_device_set_property_helper() .      
  
    
      
        
          
dbus_bool_t libhal_device_set_property_double                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
double           
 value,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set a property of type double. 
Parameters:  
    
ctx The context for the connection to hald     
udi 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   
Returns:TRUE if the property was set, FALSE if the device didn't exist or the property had a different type. Definition at line 
libhal_8c-source.html#l016241624  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l01453libhal_device_set_property_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         
        
          
          
)           
 [static]         
      
    
  
  
    
       
    
    
todo.html#_todo000005Todo: sanity check incoming params Definition at line 
libhal_8c-source.html#l014531453  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l01665libhal_device_remove_property() , libhal_8c-source.html#l01645libhal_device_set_property_bool() , libhal_8c-source.html#l01624libhal_device_set_property_double() , libhal_8c-source.html#l01582libhal_device_set_property_int() , libhal_8c-source.html#l01558libhal_device_set_property_string() , and libhal_8c-source.html#l01603libhal_device_set_property_uint64() .      
  
    
      
        
          
dbus_bool_t libhal_device_set_property_int                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
dbus_int32_t           
 value,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set a property of type signed integer. 
Parameters:  
    
ctx The context for the connection to hald     
udi 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   
Returns:TRUE if the property was set, FALSE if the device didn't exist or the property had a different type. Definition at line 
libhal_8c-source.html#l015821582  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l01453libhal_device_set_property_helper() .      
  
    
      
        
          
dbus_bool_t libhal_device_set_property_string                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
const char *           
 value,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set a property of type string. 
Parameters:  
    
ctx The context for the connection to hald     
udi 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   
Returns:TRUE if the property was set, FALSE if the device didn't exist or the property had a different type. Definition at line 
libhal_8c-source.html#l015581558  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l01453libhal_device_set_property_helper() .      
  
    
      
        
          
dbus_bool_t libhal_device_set_property_uint64                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
const char *           
 key,         
        
          
          
          
dbus_uint64_t           
 value,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Set a property of type unsigned integer. 
Parameters:  
    
ctx The context for the connection to hald     
udi 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   
Returns:TRUE if the property was set, FALSE if the device didn't exist or the property had a different type. Definition at line 
libhal_8c-source.html#l016031603  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l01453libhal_device_set_property_helper() .      
  
    
      
        
          
dbus_bool_t libhal_device_unlock                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Release an advisory lock on the device. 
Parameters:  
    
ctx The context for the connection to hald     
udi Unique Device Id     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if the device was successfully unlocked, FALSE otherwise Definition at line 
libhal_8c-source.html#l019641964  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
char ** libhal_find_device_by_capability                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 capability,         
        
          
          
          
int *           
 num_devices,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Find devices with a given capability. 
Parameters:  
    
ctx The context for the connection to hald     
capability Capability name     
num_devices Pointer to store number of devices     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:UDI of devices; free with group__LibHal.html#g588e0fe84f2982df4d4e7e99254bcd87libhal_free_string_array()  Definition at line 
libhal_8c-source.html#l027182718  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l00096libhal_get_string_array_from_iter() .      
  
    
      
        
          
void libhal_free_property_set                     
(           
LibHalPropertySet *           
 set                    
 )           
        
      
    
  
  
    
       
    
    
Free a property set earlier obtained with 
group__LibHal.html#g5dbaa81c388a097396cc4e79866f5f45libhal_device_get_all_properties() . 
Parameters:  
    
set Property-set to free   
Definition at line 
libhal_8c-source.html#l00476476  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l00076libhal_free_string_array() , and group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e65bd27c02eb7c7ecda103daf0da715c30LIBHAL_PROPERTY_TYPE_STRLIST .      
  
    
      
        
          
void libhal_free_string                     
(           
char *           
 str                    
 )           
        
      
    
  
  
    
       
    
    
Frees a nul-terminated string. 
Parameters:  
    
str The nul-terminated sting to free   
todo.html#_todo000001Todo: implement for UTF8 Definition at line 
libhal_8c-source.html#l00151151  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal-storage_8c-source.html#l00740libhal_drive_free() , libhal-storage_8c-source.html#l01155libhal_drive_from_device_file() , and libhal-storage_8c-source.html#l00764libhal_volume_free() .      
  
    
      
        
          
void libhal_free_string_array                     
(           
char **           
 str_array                    
 )           
        
      
    
  
  
    
       
    
    
Frees a NULL-terminated array of strings. 
If passed NULL, does nothing.
Parameters:  
    
str_array The array to be freed   
Definition at line 
libhal_8c-source.html#l0007676  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal-storage_8c-source.html#l00740libhal_drive_free() , and libhal_8c-source.html#l00476libhal_free_property_set() .      
  
    
      
        
          
char ** libhal_get_all_devices                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
int *           
 num_devices,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Get all devices in the Global Device List (GDL). 
Parameters:  
    
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   
Returns:An array of device identifiers terminated with NULL. It is the responsibility of the caller to free with group__LibHal.html#g588e0fe84f2982df4d4e7e99254bcd87libhal_free_string_array() . If an error occurs NULL is returned. Definition at line 
libhal_8c-source.html#l00916916  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l00096libhal_get_string_array_from_iter() .      
  
    
      
        
          
static char ** libhal_get_string_array_from_iter                     
(           
DBusMessageIter *           
 iter,         
        
          
          
          
int *           
 num_elements         
        
          
          
)           
 [static]         
      
    
  
  
    
       
    
    
Creates a NULL terminated array of strings from a dbus message iterator. 
Parameters:  
    
iter The message iterator to extract the strings from     
num_elements Pointer to an integer where to store number of elements (can be NULL)   
Returns:Pointer to the string array Definition at line 
libhal_8c-source.html#l0009696  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l01043libhal_device_get_property_strlist() , libhal_8c-source.html#l02718libhal_find_device_by_capability() , libhal_8c-source.html#l00916libhal_get_all_devices() , libhal_8c-source.html#l02559libhal_manager_find_device_string_match() , and libhal_8c-source.html#l00253libhal_property_fill_value_from_variant() .      
  
    
      
        
          
char ** libhal_manager_find_device_string_match                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 key,         
        
          
          
          
const char *           
 value,         
        
          
          
          
int *           
 num_devices,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Find a device in the GDL where a single string property matches a given value. 
Parameters:  
    
ctx The context for the connection to hald     
key Name of the property     
value Value to match     
num_devices Pointer to store number of devices     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:UDI of devices; free with group__LibHal.html#g588e0fe84f2982df4d4e7e99254bcd87libhal_free_string_array()  Definition at line 
libhal_8c-source.html#l025592559  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l00096libhal_get_string_array_from_iter() .
Referenced by 
libhal-storage_8c-source.html#l01470libhal_drive_find_all_volumes() , libhal-storage_8c-source.html#l01155libhal_drive_from_device_file() , and libhal-storage_8c-source.html#l01214libhal_volume_from_device_file() .      
  
    
      
        
          
dbus_bool_t libhal_merge_properties                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 target_udi,         
        
          
          
          
const char *           
 source_udi,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Merge properties from one device to another. 
Parameters:  
    
ctx The context for the connection to hald     
target_udi Unique device id of target device to merge to     
source_udi Unique device id of device to merge from     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if the properties were merged, FALSE otherwise Definition at line 
libhal_8c-source.html#l023412341  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
char * libhal_new_device                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Create a new device object which will be hidden from applications until the CommitToGdl(), ie. 
group__LibHal.html#g59038b98ab8c170e45af95aea3362a0dlibhal_device_commit_to_gdl() , method is called.Note that the program invoking this method needs to run with super user privileges.
Parameters:  
    
ctx The context for the connection to hald     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:Temporary device unique id or NULL if there was a problem. This string must be freed by the caller. todo.html#_todo000006Todo: FIXME cleanup Definition at line 
libhal_8c-source.html#l020192019  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
static dbus_bool_t libhal_property_fill_value_from_variant                     
(           
LibHalProperty *           
 p,         
        
          
          
          
DBusMessageIter *           
 var_iter         
        
          
          
)           
 [static]         
      
    
  
  
    
       
    
    
Fills in the value for the LibHalProperty given a variant iterator. 
Parameters:  
    
p The property to fill in     
var_iter Varient iterator to extract the value from   
todo.html#_todo000002Todo: report error Definition at line 
libhal_8c-source.html#l00253253  of file libhal_8c-source.htmllibhal.c .
References 
libhal_8c-source.html#l00096libhal_get_string_array_from_iter() , group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e6ddf1c8c88ff976b5440c73eea63edd47LIBHAL_PROPERTY_TYPE_BOOLEAN , group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e66fff949a9f9ac721a21f8d33a3dfe107LIBHAL_PROPERTY_TYPE_DOUBLE , group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e6c3a42b401b3833e88ec4aa4c631f96e6LIBHAL_PROPERTY_TYPE_INT32 , group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e665a50adaddc694a6b4dafa40c8ef6bb8LIBHAL_PROPERTY_TYPE_STRING , group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e65bd27c02eb7c7ecda103daf0da715c30LIBHAL_PROPERTY_TYPE_STRLIST , and group__LibHal.html#gg5e5a8a56bd7ac6141dd67fdefb14f0e69b9b049650db0d7c0e90ad6d4a4a67dfLIBHAL_PROPERTY_TYPE_UINT64 .
Referenced by 
libhal_8c-source.html#l00342libhal_device_get_all_properties() .      
  
    
      
        
          
unsigned int libhal_property_set_get_num_elems                     
(           
LibHalPropertySet *           
 set                    
 )           
        
      
    
  
  
    
       
    
    
Get the number of properties in a property set. 
Parameters:  
    
set Property set to consider   
Returns:Number of properties in given property set Definition at line 
libhal_8c-source.html#l00502502  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
dbus_bool_t libhal_psi_get_bool                     
(           
LibHalPropertySetIterator *           
 iter                    
 )           
        
      
    
  
  
    
       
    
    
Get the value of a property of type bool. 
Parameters:  
    
iter Iterator object   
Returns:Property value (bool) Definition at line 
libhal_8c-source.html#l00636636  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() , and libhal-storage_8c-source.html#l01588mopts_collect() .      
  
    
      
        
          
double libhal_psi_get_double                     
(           
LibHalPropertySetIterator *           
 iter                    
 )           
        
      
    
  
  
    
       
    
    
Get the value of a property of type double. 
Parameters:  
    
iter Iterator object   
Returns:Property value (IEEE754 double precision float) Definition at line 
libhal_8c-source.html#l00625625  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() .      
  
    
      
        
          
dbus_int32_t libhal_psi_get_int                     
(           
LibHalPropertySetIterator *           
 iter                    
 )           
        
      
    
  
  
    
       
    
    
Get the value of a property of type signed integer. 
Parameters:  
    
iter Iterator object   
Returns:Property value (32-bit signed integer) Definition at line 
libhal_8c-source.html#l00603603  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() .      
  
    
      
        
          
char * libhal_psi_get_key                     
(           
LibHalPropertySetIterator *           
 iter                    
 )           
        
      
    
  
  
    
       
    
    
Get the key of a property. 
Parameters:  
    
iter Iterator object   
Returns:ASCII nul-terminated string. This pointer is only valid until group__LibHal.html#g22b659f4c4ae06779ed22ef32e510044libhal_free_property_set()  is invoked on the property set this property belongs to Definition at line 
libhal_8c-source.html#l00578578  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() , libhal-storage_8c-source.html#l00822libhal_drive_from_udi() , libhal-storage_8c-source.html#l01005libhal_volume_from_udi() , and libhal-storage_8c-source.html#l01588mopts_collect() .      
  
    
      
        
          
char * libhal_psi_get_string                     
(           
LibHalPropertySetIterator *           
 iter                    
 )           
        
      
    
  
  
    
       
    
    
Get the value of a property of type string. 
Parameters:  
    
iter Iterator object   
Returns:UTF8 nul-terminated string. This pointer is only valid until group__LibHal.html#g22b659f4c4ae06779ed22ef32e510044libhal_free_property_set()  is invoked on the property set this property belongs to Definition at line 
libhal_8c-source.html#l00592592  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() .      
  
    
      
        
          
char ** libhal_psi_get_strlist                     
(           
LibHalPropertySetIterator *           
 iter                    
 )           
        
      
    
  
  
    
       
    
    
Get the value of a property of type string list. 
Parameters:  
    
iter Iterator object   
Returns:Pointer to array of strings Definition at line 
libhal_8c-source.html#l00647647  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() .      
  
    
      
        
          
group__LibHal.html#g5e5a8a56bd7ac6141dd67fdefb14f0e6LibHalPropertyType  libhal_psi_get_type                     
(           
LibHalPropertySetIterator *           
 iter                    
 )           
        
      
    
  
  
    
       
    
    
Get type of property. 
Parameters:  
    
iter Iterator object   
Returns:The property type at the iterator's position Definition at line 
libhal_8c-source.html#l00564564  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() , libhal-storage_8c-source.html#l00822libhal_drive_from_udi() , libhal-storage_8c-source.html#l01005libhal_volume_from_udi() , and libhal-storage_8c-source.html#l01588mopts_collect() .      
  
    
      
        
          
dbus_uint64_t libhal_psi_get_uint64                     
(           
LibHalPropertySetIterator *           
 iter                    
 )           
        
      
    
  
  
    
       
    
    
Get the value of a property of type unsigned integer. 
Parameters:  
    
iter Iterator object   
Returns:Property value (64-bit unsigned integer) Definition at line 
libhal_8c-source.html#l00614614  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() .      
  
    
      
        
          
dbus_bool_t libhal_psi_has_more                     
(           
LibHalPropertySetIterator *           
 iter                    
 )           
        
      
    
  
  
    
       
    
    
Determine whether there are more properties to iterate over. 
Parameters:  
    
iter Iterator object   
Returns:TRUE if there are more properties, FALSE otherwise Definition at line 
libhal_8c-source.html#l00542542  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() , libhal-storage_8c-source.html#l00822libhal_drive_from_udi() , libhal-storage_8c-source.html#l01005libhal_volume_from_udi() , and libhal-storage_8c-source.html#l01588mopts_collect() .      
  
    
      
        
          
void libhal_psi_init                     
(           
LibHalPropertySetIterator *           
 iter,         
        
          
          
          
LibHalPropertySet *           
 set         
        
          
          
)           
        
      
    
  
  
    
       
    
    
Initialize a property set iterator. 
Parameters:  
    
iter Iterator object     
set Property set to iterate over   
Definition at line 
libhal_8c-source.html#l00524524  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() , libhal-storage_8c-source.html#l00822libhal_drive_from_udi() , libhal-storage_8c-source.html#l01005libhal_volume_from_udi() , and libhal-storage_8c-source.html#l01588mopts_collect() .      
  
    
      
        
          
void libhal_psi_next                     
(           
LibHalPropertySetIterator *           
 iter                    
 )           
        
      
    
  
  
    
       
    
    
Advance iterator to next property. 
Parameters:  
    
iter Iterator object   
Definition at line 
libhal_8c-source.html#l00552552  of file libhal_8c-source.htmllibhal.c .
Referenced by 
libhal_8c-source.html#l02476libhal_device_print() , libhal-storage_8c-source.html#l00822libhal_drive_from_udi() , libhal-storage_8c-source.html#l01005libhal_volume_from_udi() , and libhal-storage_8c-source.html#l01588mopts_collect() .      
  
    
      
        
          
dbus_bool_t libhal_remove_device                     
(           
LibHalContext *           
 ctx,         
        
          
          
          
const char *           
 udi,         
        
          
          
          
DBusError *           
 error         
        
          
          
)           
        
      
    
  
  
    
       
    
    
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.
Parameters:  
    
ctx The context for the connection to hald     
udi The new unique device id.     
error Pointer to an initialized dbus error object for returning errors or NULL   
Returns:TRUE if the device was removed, FALSE otherwise Definition at line 
libhal_8c-source.html#l021572157  of file libhal_8c-source.htmllibhal.c .      
  
    
      
        
          
unsigned int libhal_string_array_length                     
(           
char **           
 str_array                    
 )           
        
      
    
  
  
    
       
    
    
Get the length of an array of strings. 
Parameters:  
    
str_array Array of strings to consider   
Returns:Amount of strings in array Definition at line 
libhal_8c-source.html#l031743174  of file libhal_8c-source.htmllibhal.c .      
Generated on Tue May 2 08:40:16 2006 for HAL by 
http://www.doxygen.org/index.htmldoxygen  1.4.6 