~ubuntu-branches/debian/sid/hal/sid

« back to all changes in this revision

Viewing changes to doc/api/libhal/html/libhal-libhal.html

  • Committer: Bazaar Package Importer
  • Author(s): Martin Pitt
  • Date: 2007-10-23 12:33:58 UTC
  • Revision ID: james.westby@ubuntu.com-20071023123358-xaf8mjc5n84d5gtz
Tags: upstream-0.5.10
ImportĀ upstreamĀ versionĀ 0.5.10

Show diffs side-by-side

added added

removed removed

Lines of Context:
3
3
<head>
4
4
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
5
5
<title>libhal</title>
6
 
<meta name="generator" content="DocBook XSL Stylesheets V1.72.0">
 
6
<meta name="generator" content="DocBook XSL Stylesheets V1.73.2">
7
7
<link rel="start" href="index.html" title="HAL Client Library Reference Manual">
8
8
<link rel="up" href="rn01.html" title="API Reference">
9
9
<link rel="prev" href="rn01.html" title="API Reference">
23
23
<th width="100%" align="center">HAL Client Library Reference Manual</th>
24
24
<td><a accesskey="n" href="ix01.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
25
25
</tr>
26
 
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2608438" class="shortcut">Top</a>
 
26
<tr><td colspan="5" class="shortcuts"><nobr><a href="#id2919407" class="shortcut">Top</a>
27
27
                  &#160;|&#160;
28
 
                  <a href="#id2652940" class="shortcut">Description</a></nobr></td></tr>
 
28
                  <a href="#id2965876" class="shortcut">Description</a></nobr></td></tr>
29
29
</table>
30
30
<div class="refentry" lang="en">
31
31
<a name="libhal-libhal"></a><div class="titlepage"></div>
32
32
<div class="refnamediv"><table width="100%"><tr>
33
33
<td valign="top">
34
34
<h2>
35
 
<a name="id2608438"></a><span class="refentrytitle">libhal</span>
 
35
<a name="id2919407"></a><span class="refentrytitle">libhal</span>
36
36
</h2>
37
37
<p>libhal</p>
38
38
</td>
44
44
 
45
45
 
46
46
 
47
 
#define             <a href="libhal-libhal.html#LIBHAL-DEPRECATED:CAPS">LIBHAL_DEPRECATED</a>
48
 
#define             <a href="libhal-libhal.html#LIBHAL-FREE-DBUS-ERROR:CAPS">LIBHAL_FREE_DBUS_ERROR</a>              (_dbus_error_)
49
 
#define             <a href="libhal-libhal.html#LIBHAL-CHECK-LIBHALCONTEXT:CAPS">LIBHAL_CHECK_LIBHALCONTEXT</a>          (_ctx_, _ret_)
50
 
enum                <a href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>;
51
 
typedef             <a href="libhal-libhal.html#LibHalContext">LibHalContext</a>;
52
 
void                (<a href="libhal-libhal.html#LibHalIntegrateDBusIntoMainLoop">*LibHalIntegrateDBusIntoMainLoop</a>)  (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
47
#define             <a class="link" href="libhal-libhal.html#DBUS-API-SUBJECT-TO-CHANGE:CAPS">DBUS_API_SUBJECT_TO_CHANGE</a>
 
48
#define             <a class="link" href="libhal-libhal.html#LIBHAL-DEPRECATED:CAPS">LIBHAL_DEPRECATED</a>
 
49
#define             <a class="link" href="libhal-libhal.html#LIBHAL-FREE-DBUS-ERROR:CAPS">LIBHAL_FREE_DBUS_ERROR</a>              (_dbus_error_)
 
50
#define             <a class="link" href="libhal-libhal.html#LIBHAL-CHECK-LIBHALCONTEXT:CAPS">LIBHAL_CHECK_LIBHALCONTEXT</a>          (_ctx_, _ret_)
 
51
enum                <a class="link" href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>;
 
52
typedef             <a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a>;
 
53
typedef             <a class="link" href="libhal-libhal.html#LibHalProperty">LibHalProperty</a>;
 
54
typedef             <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a>;
 
55
void                (<a class="link" href="libhal-libhal.html#LibHalIntegrateDBusIntoMainLoop">*LibHalIntegrateDBusIntoMainLoop</a>)  (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
53
56
                                                         DBusConnection *dbus_connection);
54
 
void                (<a href="libhal-libhal.html#LibHalDeviceAdded">*LibHalDeviceAdded</a>)                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
55
 
                                                         const char *udi);
56
 
void                (<a href="libhal-libhal.html#LibHalDeviceRemoved">*LibHalDeviceRemoved</a>)              (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
57
 
                                                         const char *udi);
58
 
void                (<a href="libhal-libhal.html#LibHalDeviceNewCapability">*LibHalDeviceNewCapability</a>)        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
59
 
                                                         const char *udi,
60
 
                                                         const char *capability);
61
 
void                (<a href="libhal-libhal.html#LibHalDeviceLostCapability">*LibHalDeviceLostCapability</a>)       (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
62
 
                                                         const char *udi,
63
 
                                                         const char *capability);
64
 
void                (<a href="libhal-libhal.html#LibHalDevicePropertyModified">*LibHalDevicePropertyModified</a>)     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
57
void                (<a class="link" href="libhal-libhal.html#LibHalDeviceAdded">*LibHalDeviceAdded</a>)                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
58
                                                         const char *udi);
 
59
void                (<a class="link" href="libhal-libhal.html#LibHalDeviceRemoved">*LibHalDeviceRemoved</a>)              (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
60
                                                         const char *udi);
 
61
void                (<a class="link" href="libhal-libhal.html#LibHalDeviceNewCapability">*LibHalDeviceNewCapability</a>)        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
62
                                                         const char *udi,
 
63
                                                         const char *capability);
 
64
void                (<a class="link" href="libhal-libhal.html#LibHalDeviceLostCapability">*LibHalDeviceLostCapability</a>)       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
65
                                                         const char *udi,
 
66
                                                         const char *capability);
 
67
void                (<a class="link" href="libhal-libhal.html#LibHalDevicePropertyModified">*LibHalDevicePropertyModified</a>)     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
65
68
                                                         const char *udi,
66
69
                                                         const char *key,
67
70
                                                         dbus_bool_t is_removed,
68
71
                                                         dbus_bool_t is_added);
69
 
void                (<a href="libhal-libhal.html#LibHalDeviceCondition">*LibHalDeviceCondition</a>)            (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
72
void                (<a class="link" href="libhal-libhal.html#LibHalDeviceCondition">*LibHalDeviceCondition</a>)            (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
70
73
                                                         const char *udi,
71
74
                                                         const char *condition_name,
72
75
                                                         const char *condition_detail);
73
 
void                (<a href="libhal-libhal.html#LibHalGlobalInterfaceLockAcquired">*LibHalGlobalInterfaceLockAcquired</a>)
74
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
75
 
                                                         const char *interface_name,
76
 
                                                         const char *lock_owner,
77
 
                                                         int num_locks);
78
 
void                (<a href="libhal-libhal.html#LibHalGlobalInterfaceLockReleased">*LibHalGlobalInterfaceLockReleased</a>)
79
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
80
 
                                                         const char *interface_name,
81
 
                                                         const char *lock_owner,
82
 
                                                         int num_locks);
83
 
void                (<a href="libhal-libhal.html#LibHalInterfaceLockAcquired">*LibHalInterfaceLockAcquired</a>)      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
84
 
                                                         const char *udi,
85
 
                                                         const char *interface_name,
86
 
                                                         const char *lock_owner,
87
 
                                                         int num_locks);
88
 
void                (<a href="libhal-libhal.html#LibHalInterfaceLockReleased">*LibHalInterfaceLockReleased</a>)      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
89
 
                                                         const char *udi,
90
 
                                                         const char *interface_name,
91
 
                                                         const char *lock_owner,
92
 
                                                         int num_locks);
93
 
<a href="libhal-libhal.html#LibHalContext">LibHalContext</a>*      <a href="libhal-libhal.html#libhal-ctx-new">libhal_ctx_new</a>                      (void);
94
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-cache">libhal_ctx_set_cache</a>                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
76
void                (<a class="link" href="libhal-libhal.html#LibHalGlobalInterfaceLockAcquired">*LibHalGlobalInterfaceLockAcquired</a>)
 
77
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
78
                                                         const char *interface_name,
 
79
                                                         const char *lock_owner,
 
80
                                                         int num_locks);
 
81
void                (<a class="link" href="libhal-libhal.html#LibHalGlobalInterfaceLockReleased">*LibHalGlobalInterfaceLockReleased</a>)
 
82
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
83
                                                         const char *interface_name,
 
84
                                                         const char *lock_owner,
 
85
                                                         int num_locks);
 
86
void                (<a class="link" href="libhal-libhal.html#LibHalInterfaceLockAcquired">*LibHalInterfaceLockAcquired</a>)      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
87
                                                         const char *udi,
 
88
                                                         const char *interface_name,
 
89
                                                         const char *lock_owner,
 
90
                                                         int num_locks);
 
91
void                (<a class="link" href="libhal-libhal.html#LibHalInterfaceLockReleased">*LibHalInterfaceLockReleased</a>)      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
92
                                                         const char *udi,
 
93
                                                         const char *interface_name,
 
94
                                                         const char *lock_owner,
 
95
                                                         int num_locks);
 
96
void                (<a class="link" href="libhal-libhal.html#LibHalSingletonDeviceAdded">*LibHalSingletonDeviceAdded</a>)       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
97
                                                         const char *udi,
 
98
                                                         const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *properties);
 
99
void                (<a class="link" href="libhal-libhal.html#LibHalSingletonDeviceRemoved">*LibHalSingletonDeviceRemoved</a>)     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
100
                                                         const char *udi,
 
101
                                                         const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *properties);
 
102
<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a>*      <a class="link" href="libhal-libhal.html#libhal-ctx-new">libhal_ctx_new</a>                      (void);
 
103
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-cache">libhal_ctx_set_cache</a>                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
95
104
                                                         dbus_bool_t use_cache);
96
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-dbus-connection">libhal_ctx_set_dbus_connection</a>      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
105
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-dbus-connection">libhal_ctx_set_dbus_connection</a>      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
97
106
                                                         DBusConnection *conn);
98
 
DBusConnection*     <a href="libhal-libhal.html#libhal-ctx-get-dbus-connection">libhal_ctx_get_dbus_connection</a>      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);
99
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-user-data">libhal_ctx_set_user_data</a>            (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
107
DBusConnection*     <a class="link" href="libhal-libhal.html#libhal-ctx-get-dbus-connection">libhal_ctx_get_dbus_connection</a>      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);
 
108
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-user-data">libhal_ctx_set_user_data</a>            (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
100
109
                                                         void *user_data);
101
 
void*               <a href="libhal-libhal.html#libhal-ctx-get-user-data">libhal_ctx_get_user_data</a>            (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);
102
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-device-added">libhal_ctx_set_device_added</a>         (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
103
 
                                                         <a href="libhal-libhal.html#LibHalDeviceAdded">LibHalDeviceAdded</a> callback);
104
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-device-removed">libhal_ctx_set_device_removed</a>       (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
105
 
                                                         <a href="libhal-libhal.html#LibHalDeviceRemoved">LibHalDeviceRemoved</a> callback);
106
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-device-new-capability">libhal_ctx_set_device_new_capability</a>
107
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
108
 
                                                         <a href="libhal-libhal.html#LibHalDeviceNewCapability">LibHalDeviceNewCapability</a> callback);
109
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-device-lost-capability">libhal_ctx_set_device_lost_capability</a>
110
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
111
 
                                                         <a href="libhal-libhal.html#LibHalDeviceLostCapability">LibHalDeviceLostCapability</a> callback);
112
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-device-property-modified">libhal_ctx_set_device_property_modified</a>
113
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
114
 
                                                         <a href="libhal-libhal.html#LibHalDevicePropertyModified">LibHalDevicePropertyModified</a> callback);
115
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-device-condition">libhal_ctx_set_device_condition</a>     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
116
 
                                                         <a href="libhal-libhal.html#LibHalDeviceCondition">LibHalDeviceCondition</a> callback);
117
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-global-interface-lock-acquired">libhal_ctx_set_global_interface_lock_acquired</a>
118
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
119
 
                                                         <a href="libhal-libhal.html#LibHalGlobalInterfaceLockAcquired">LibHalGlobalInterfaceLockAcquired</a> callback);
120
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-global-interface-lock-released">libhal_ctx_set_global_interface_lock_released</a>
121
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
122
 
                                                         <a href="libhal-libhal.html#LibHalGlobalInterfaceLockReleased">LibHalGlobalInterfaceLockReleased</a> callback);
123
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-interface-lock-acquired">libhal_ctx_set_interface_lock_acquired</a>
124
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
125
 
                                                         <a href="libhal-libhal.html#LibHalInterfaceLockAcquired">LibHalInterfaceLockAcquired</a> callback);
126
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-set-interface-lock-released">libhal_ctx_set_interface_lock_released</a>
127
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
128
 
                                                         <a href="libhal-libhal.html#LibHalInterfaceLockReleased">LibHalInterfaceLockReleased</a> callback);
129
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-init">libhal_ctx_init</a>                     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
130
 
                                                         DBusError *error);
131
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-shutdown">libhal_ctx_shutdown</a>                 (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
132
 
                                                         DBusError *error);
133
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-ctx-free">libhal_ctx_free</a>                     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);
134
 
<a href="libhal-libhal.html#LibHalContext">LibHalContext</a>*      <a href="libhal-libhal.html#libhal-ctx-init-direct">libhal_ctx_init_direct</a>              (DBusError *error);
135
 
char**              <a href="libhal-libhal.html#libhal-get-all-devices">libhal_get_all_devices</a>              (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
110
void*               <a class="link" href="libhal-libhal.html#libhal-ctx-get-user-data">libhal_ctx_get_user_data</a>            (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);
 
111
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-device-added">libhal_ctx_set_device_added</a>         (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
112
                                                         <a class="link" href="libhal-libhal.html#LibHalDeviceAdded">LibHalDeviceAdded</a> callback);
 
113
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-device-removed">libhal_ctx_set_device_removed</a>       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
114
                                                         <a class="link" href="libhal-libhal.html#LibHalDeviceRemoved">LibHalDeviceRemoved</a> callback);
 
115
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-device-new-capability">libhal_ctx_set_device_new_capability</a>
 
116
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
117
                                                         <a class="link" href="libhal-libhal.html#LibHalDeviceNewCapability">LibHalDeviceNewCapability</a> callback);
 
118
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-device-lost-capability">libhal_ctx_set_device_lost_capability</a>
 
119
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
120
                                                         <a class="link" href="libhal-libhal.html#LibHalDeviceLostCapability">LibHalDeviceLostCapability</a> callback);
 
121
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-device-property-modified">libhal_ctx_set_device_property_modified</a>
 
122
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
123
                                                         <a class="link" href="libhal-libhal.html#LibHalDevicePropertyModified">LibHalDevicePropertyModified</a> callback);
 
124
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-device-condition">libhal_ctx_set_device_condition</a>     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
125
                                                         <a class="link" href="libhal-libhal.html#LibHalDeviceCondition">LibHalDeviceCondition</a> callback);
 
126
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-global-interface-lock-acquired">libhal_ctx_set_global_interface_lock_acquired</a>
 
127
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
128
                                                         <a class="link" href="libhal-libhal.html#LibHalGlobalInterfaceLockAcquired">LibHalGlobalInterfaceLockAcquired</a> callback);
 
129
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-global-interface-lock-released">libhal_ctx_set_global_interface_lock_released</a>
 
130
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
131
                                                         <a class="link" href="libhal-libhal.html#LibHalGlobalInterfaceLockReleased">LibHalGlobalInterfaceLockReleased</a> callback);
 
132
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-interface-lock-acquired">libhal_ctx_set_interface_lock_acquired</a>
 
133
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
134
                                                         <a class="link" href="libhal-libhal.html#LibHalInterfaceLockAcquired">LibHalInterfaceLockAcquired</a> callback);
 
135
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-interface-lock-released">libhal_ctx_set_interface_lock_released</a>
 
136
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
137
                                                         <a class="link" href="libhal-libhal.html#LibHalInterfaceLockReleased">LibHalInterfaceLockReleased</a> callback);
 
138
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-singleton-device-added">libhal_ctx_set_singleton_device_added</a>
 
139
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
140
                                                         <a class="link" href="libhal-libhal.html#LibHalSingletonDeviceAdded">LibHalSingletonDeviceAdded</a> callback);
 
141
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-set-singleton-device-removed">libhal_ctx_set_singleton_device_removed</a>
 
142
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
143
                                                         <a class="link" href="libhal-libhal.html#LibHalSingletonDeviceRemoved">LibHalSingletonDeviceRemoved</a> callback);
 
144
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-init">libhal_ctx_init</a>                     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
145
                                                         DBusError *error);
 
146
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-shutdown">libhal_ctx_shutdown</a>                 (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
147
                                                         DBusError *error);
 
148
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ctx-free">libhal_ctx_free</a>                     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);
 
149
<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a>*      <a class="link" href="libhal-libhal.html#libhal-ctx-init-direct">libhal_ctx_init_direct</a>              (DBusError *error);
 
150
char**              <a class="link" href="libhal-libhal.html#libhal-get-all-devices">libhal_get_all_devices</a>              (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
136
151
                                                         int *num_devices,
137
152
                                                         DBusError *error);
138
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-exists">libhal_device_exists</a>                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
139
 
                                                         const char *udi,
140
 
                                                         DBusError *error);
141
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-print">libhal_device_print</a>                 (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
142
 
                                                         const char *udi,
143
 
                                                         DBusError *error);
144
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-property-exists">libhal_device_property_exists</a>       (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
145
 
                                                         const char *udi,
146
 
                                                         const char *key,
147
 
                                                         DBusError *error);
148
 
char*               <a href="libhal-libhal.html#libhal-device-get-property-string">libhal_device_get_property_string</a>   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
149
 
                                                         const char *udi,
150
 
                                                         const char *key,
151
 
                                                         DBusError *error);
152
 
dbus_int32_t        <a href="libhal-libhal.html#libhal-device-get-property-int">libhal_device_get_property_int</a>      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
153
 
                                                         const char *udi,
154
 
                                                         const char *key,
155
 
                                                         DBusError *error);
156
 
dbus_uint64_t       <a href="libhal-libhal.html#libhal-device-get-property-uint64">libhal_device_get_property_uint64</a>   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
157
 
                                                         const char *udi,
158
 
                                                         const char *key,
159
 
                                                         DBusError *error);
160
 
double              <a href="libhal-libhal.html#libhal-device-get-property-double">libhal_device_get_property_double</a>   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
161
 
                                                         const char *udi,
162
 
                                                         const char *key,
163
 
                                                         DBusError *error);
164
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-get-property-bool">libhal_device_get_property_bool</a>     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
165
 
                                                         const char *udi,
166
 
                                                         const char *key,
167
 
                                                         DBusError *error);
168
 
char**              <a href="libhal-libhal.html#libhal-device-get-property-strlist">libhal_device_get_property_strlist</a>  (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
169
 
                                                         const char *udi,
170
 
                                                         const char *key,
171
 
                                                         DBusError *error);
172
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-set-property-string">libhal_device_set_property_string</a>   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
153
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-exists">libhal_device_exists</a>                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
154
                                                         const char *udi,
 
155
                                                         DBusError *error);
 
156
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-print">libhal_device_print</a>                 (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
157
                                                         const char *udi,
 
158
                                                         DBusError *error);
 
159
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-property-exists">libhal_device_property_exists</a>       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
160
                                                         const char *udi,
 
161
                                                         const char *key,
 
162
                                                         DBusError *error);
 
163
char*               <a class="link" href="libhal-libhal.html#libhal-device-get-property-string">libhal_device_get_property_string</a>   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
164
                                                         const char *udi,
 
165
                                                         const char *key,
 
166
                                                         DBusError *error);
 
167
dbus_int32_t        <a class="link" href="libhal-libhal.html#libhal-device-get-property-int">libhal_device_get_property_int</a>      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
168
                                                         const char *udi,
 
169
                                                         const char *key,
 
170
                                                         DBusError *error);
 
171
dbus_uint64_t       <a class="link" href="libhal-libhal.html#libhal-device-get-property-uint64">libhal_device_get_property_uint64</a>   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
172
                                                         const char *udi,
 
173
                                                         const char *key,
 
174
                                                         DBusError *error);
 
175
double              <a class="link" href="libhal-libhal.html#libhal-device-get-property-double">libhal_device_get_property_double</a>   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
176
                                                         const char *udi,
 
177
                                                         const char *key,
 
178
                                                         DBusError *error);
 
179
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-get-property-bool">libhal_device_get_property_bool</a>     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
180
                                                         const char *udi,
 
181
                                                         const char *key,
 
182
                                                         DBusError *error);
 
183
char**              <a class="link" href="libhal-libhal.html#libhal-device-get-property-strlist">libhal_device_get_property_strlist</a>  (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
184
                                                         const char *udi,
 
185
                                                         const char *key,
 
186
                                                         DBusError *error);
 
187
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-set-property-string">libhal_device_set_property_string</a>   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
173
188
                                                         const char *udi,
174
189
                                                         const char *key,
175
190
                                                         const char *value,
176
191
                                                         DBusError *error);
177
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-set-property-int">libhal_device_set_property_int</a>      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
192
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-set-property-int">libhal_device_set_property_int</a>      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
178
193
                                                         const char *udi,
179
194
                                                         const char *key,
180
195
                                                         dbus_int32_t value,
181
196
                                                         DBusError *error);
182
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-set-property-uint64">libhal_device_set_property_uint64</a>   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
197
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-set-property-uint64">libhal_device_set_property_uint64</a>   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
183
198
                                                         const char *udi,
184
199
                                                         const char *key,
185
200
                                                         dbus_uint64_t value,
186
201
                                                         DBusError *error);
187
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-set-property-double">libhal_device_set_property_double</a>   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
202
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-set-property-double">libhal_device_set_property_double</a>   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
188
203
                                                         const char *udi,
189
204
                                                         const char *key,
190
205
                                                         double value,
191
206
                                                         DBusError *error);
192
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-set-property-bool">libhal_device_set_property_bool</a>     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
207
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-set-property-bool">libhal_device_set_property_bool</a>     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
193
208
                                                         const char *udi,
194
209
                                                         const char *key,
195
210
                                                         dbus_bool_t value,
196
211
                                                         DBusError *error);
197
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-property-strlist-append">libhal_device_property_strlist_append</a>
198
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
199
 
                                                         const char *udi,
200
 
                                                         const char *key,
201
 
                                                         const char *value,
202
 
                                                         DBusError *error);
203
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-property-strlist-prepend">libhal_device_property_strlist_prepend</a>
204
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
205
 
                                                         const char *udi,
206
 
                                                         const char *key,
207
 
                                                         const char *value,
208
 
                                                         DBusError *error);
209
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-property-strlist-remove-index">libhal_device_property_strlist_remove_index</a>
210
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
212
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-property-strlist-append">libhal_device_property_strlist_append</a>
 
213
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
214
                                                         const char *udi,
 
215
                                                         const char *key,
 
216
                                                         const char *value,
 
217
                                                         DBusError *error);
 
218
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-property-strlist-prepend">libhal_device_property_strlist_prepend</a>
 
219
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
220
                                                         const char *udi,
 
221
                                                         const char *key,
 
222
                                                         const char *value,
 
223
                                                         DBusError *error);
 
224
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-property-strlist-remove-index">libhal_device_property_strlist_remove_index</a>
 
225
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
211
226
                                                         const char *udi,
212
227
                                                         const char *key,
213
228
                                                         unsigned int idx,
214
229
                                                         DBusError *error);
215
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-property-strlist-remove">libhal_device_property_strlist_remove</a>
216
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
230
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-property-strlist-remove">libhal_device_property_strlist_remove</a>
 
231
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
217
232
                                                         const char *udi,
218
233
                                                         const char *key,
219
234
                                                         const char *value,
220
235
                                                         DBusError *error);
221
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-remove-property">libhal_device_remove_property</a>       (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
222
 
                                                         const char *udi,
223
 
                                                         const char *key,
224
 
                                                         DBusError *error);
225
 
<a href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>  <a href="libhal-libhal.html#libhal-device-get-property-type">libhal_device_get_property_type</a>     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
226
 
                                                         const char *udi,
227
 
                                                         const char *key,
228
 
                                                         DBusError *error);
229
 
struct              <a href="libhal-libhal.html#LibHalChangeSet-s">LibHalChangeSet_s</a>;
230
 
typedef             <a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a>;
231
 
<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a>*    <a href="libhal-libhal.html#libhal-device-new-changeset">libhal_device_new_changeset</a>         (const char *udi);
232
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-changeset-set-property-string">libhal_changeset_set_property_string</a>
233
 
                                                        (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
236
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-remove-property">libhal_device_remove_property</a>       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
237
                                                         const char *udi,
 
238
                                                         const char *key,
 
239
                                                         DBusError *error);
 
240
<a class="link" href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>  <a class="link" href="libhal-libhal.html#libhal-device-get-property-type">libhal_device_get_property_type</a>     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
241
                                                         const char *udi,
 
242
                                                         const char *key,
 
243
                                                         DBusError *error);
 
244
struct              <a class="link" href="libhal-libhal.html#LibHalChangeSet-s">LibHalChangeSet_s</a>;
 
245
typedef             <a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a>;
 
246
<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a>*    <a class="link" href="libhal-libhal.html#libhal-device-new-changeset">libhal_device_new_changeset</a>         (const char *udi);
 
247
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-changeset-set-property-string">libhal_changeset_set_property_string</a>
 
248
                                                        (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
234
249
                                                         const char *key,
235
250
                                                         const char *value);
236
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-changeset-set-property-int">libhal_changeset_set_property_int</a>   (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
251
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-changeset-set-property-int">libhal_changeset_set_property_int</a>   (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
237
252
                                                         const char *key,
238
253
                                                         dbus_int32_t value);
239
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-changeset-set-property-uint64">libhal_changeset_set_property_uint64</a>
240
 
                                                        (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
254
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-changeset-set-property-uint64">libhal_changeset_set_property_uint64</a>
 
255
                                                        (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
241
256
                                                         const char *key,
242
257
                                                         dbus_uint64_t value);
243
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-changeset-set-property-double">libhal_changeset_set_property_double</a>
244
 
                                                        (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
258
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-changeset-set-property-double">libhal_changeset_set_property_double</a>
 
259
                                                        (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
245
260
                                                         const char *key,
246
261
                                                         double value);
247
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-changeset-set-property-bool">libhal_changeset_set_property_bool</a>  (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
262
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-changeset-set-property-bool">libhal_changeset_set_property_bool</a>  (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
248
263
                                                         const char *key,
249
264
                                                         dbus_bool_t value);
250
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-changeset-set-property-strlist">libhal_changeset_set_property_strlist</a>
251
 
                                                        (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
265
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-changeset-set-property-strlist">libhal_changeset_set_property_strlist</a>
 
266
                                                        (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
252
267
                                                         const char *key,
253
268
                                                         const char **value);
254
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-commit-changeset">libhal_device_commit_changeset</a>      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
255
 
                                                         <a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
269
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-commit-changeset">libhal_device_commit_changeset</a>      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
270
                                                         <a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
256
271
                                                         DBusError *error);
257
 
void                <a href="libhal-libhal.html#libhal-device-free-changeset">libhal_device_free_changeset</a>        (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset);
258
 
struct              <a href="libhal-libhal.html#LibHalProperty-s">LibHalProperty_s</a>;
259
 
typedef             <a href="libhal-libhal.html#LibHalProperty">LibHalProperty</a>;
260
 
struct              <a href="libhal-libhal.html#LibHalPropertySet-s">LibHalPropertySet_s</a>;
261
 
typedef             <a href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a>;
262
 
<a href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a>*  <a href="libhal-libhal.html#libhal-device-get-all-properties">libhal_device_get_all_properties</a>    (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
272
void                <a class="link" href="libhal-libhal.html#libhal-device-free-changeset">libhal_device_free_changeset</a>        (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset);
 
273
<a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a>*  <a class="link" href="libhal-libhal.html#libhal-device-get-all-properties">libhal_device_get_all_properties</a>    (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
263
274
                                                         const char *udi,
264
275
                                                         DBusError *error);
265
 
void                <a href="libhal-libhal.html#libhal-property-set-sort">libhal_property_set_sort</a>            (<a href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);
266
 
void                <a href="libhal-libhal.html#libhal-free-property-set">libhal_free_property_set</a>            (<a href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);
267
 
unsigned int        <a href="libhal-libhal.html#libhal-property-set-get-num-elems">libhal_property_set_get_num_elems</a>   (<a href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);
268
 
struct              <a href="libhal-libhal.html#LibHalPropertySetIterator-s">LibHalPropertySetIterator_s</a>;
269
 
typedef             <a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a>;
270
 
void                <a href="libhal-libhal.html#libhal-psi-init">libhal_psi_init</a>                     (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter,
271
 
                                                         <a href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);
272
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-psi-has-more">libhal_psi_has_more</a>                 (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
273
 
void                <a href="libhal-libhal.html#libhal-psi-next">libhal_psi_next</a>                     (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
274
 
<a href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>  <a href="libhal-libhal.html#libhal-psi-get-type">libhal_psi_get_type</a>                 (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
275
 
char*               <a href="libhal-libhal.html#libhal-psi-get-key">libhal_psi_get_key</a>                  (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
276
 
char*               <a href="libhal-libhal.html#libhal-psi-get-string">libhal_psi_get_string</a>               (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
277
 
dbus_int32_t        <a href="libhal-libhal.html#libhal-psi-get-int">libhal_psi_get_int</a>                  (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
278
 
dbus_uint64_t       <a href="libhal-libhal.html#libhal-psi-get-uint64">libhal_psi_get_uint64</a>               (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
279
 
double              <a href="libhal-libhal.html#libhal-psi-get-double">libhal_psi_get_double</a>               (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
280
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-psi-get-bool">libhal_psi_get_bool</a>                 (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
281
 
char**              <a href="libhal-libhal.html#libhal-psi-get-strlist">libhal_psi_get_strlist</a>              (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
282
 
unsigned int        <a href="libhal-libhal.html#libhal-string-array-length">libhal_string_array_length</a>          (char **str_array);
283
 
void                <a href="libhal-libhal.html#libhal-free-string-array">libhal_free_string_array</a>            (char **str_array);
284
 
void                <a href="libhal-libhal.html#libhal-free-string">libhal_free_string</a>                  (char *str);
285
 
char*               <a href="libhal-libhal.html#libhal-new-device">libhal_new_device</a>                   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
276
void                <a class="link" href="libhal-libhal.html#libhal-property-set-sort">libhal_property_set_sort</a>            (<a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);
 
277
void                <a class="link" href="libhal-libhal.html#libhal-free-property-set">libhal_free_property_set</a>            (<a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);
 
278
unsigned int        <a class="link" href="libhal-libhal.html#libhal-property-set-get-num-elems">libhal_property_set_get_num_elems</a>   (<a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);
 
279
<a class="link" href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>  <a class="link" href="libhal-libhal.html#libhal-ps-get-type">libhal_ps_get_type</a>                  (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
280
                                                         const char *key);
 
281
const char*         <a class="link" href="libhal-libhal.html#libhal-ps-get-string">libhal_ps_get_string</a>                (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
282
                                                         const char *key);
 
283
dbus_int32_t        <a class="link" href="libhal-libhal.html#libhal-ps-get-int32">libhal_ps_get_int32</a>                 (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
284
                                                         const char *key);
 
285
dbus_uint64_t       <a class="link" href="libhal-libhal.html#libhal-ps-get-uint64">libhal_ps_get_uint64</a>                (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
286
                                                         const char *key);
 
287
double              <a class="link" href="libhal-libhal.html#libhal-ps-get-double">libhal_ps_get_double</a>                (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
288
                                                         const char *key);
 
289
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-ps-get-bool">libhal_ps_get_bool</a>                  (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
290
                                                         const char *key);
 
291
struct              <a class="link" href="libhal-libhal.html#LibHalPropertySetIterator-s">LibHalPropertySetIterator_s</a>;
 
292
typedef             <a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a>;
 
293
void                <a class="link" href="libhal-libhal.html#libhal-psi-init">libhal_psi_init</a>                     (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter,
 
294
                                                         <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);
 
295
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-psi-has-more">libhal_psi_has_more</a>                 (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
 
296
void                <a class="link" href="libhal-libhal.html#libhal-psi-next">libhal_psi_next</a>                     (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
 
297
<a class="link" href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>  <a class="link" href="libhal-libhal.html#libhal-psi-get-type">libhal_psi_get_type</a>                 (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
 
298
char*               <a class="link" href="libhal-libhal.html#libhal-psi-get-key">libhal_psi_get_key</a>                  (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
 
299
char*               <a class="link" href="libhal-libhal.html#libhal-psi-get-string">libhal_psi_get_string</a>               (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
 
300
dbus_int32_t        <a class="link" href="libhal-libhal.html#libhal-psi-get-int">libhal_psi_get_int</a>                  (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
 
301
dbus_uint64_t       <a class="link" href="libhal-libhal.html#libhal-psi-get-uint64">libhal_psi_get_uint64</a>               (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
 
302
double              <a class="link" href="libhal-libhal.html#libhal-psi-get-double">libhal_psi_get_double</a>               (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
 
303
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-psi-get-bool">libhal_psi_get_bool</a>                 (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
 
304
char**              <a class="link" href="libhal-libhal.html#libhal-psi-get-strlist">libhal_psi_get_strlist</a>              (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);
 
305
unsigned int        <a class="link" href="libhal-libhal.html#libhal-string-array-length">libhal_string_array_length</a>          (char **str_array);
 
306
void                <a class="link" href="libhal-libhal.html#libhal-free-string-array">libhal_free_string_array</a>            (char **str_array);
 
307
void                <a class="link" href="libhal-libhal.html#libhal-free-string">libhal_free_string</a>                  (char *str);
 
308
char*               <a class="link" href="libhal-libhal.html#libhal-new-device">libhal_new_device</a>                   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
286
309
                                                         DBusError *error);
287
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-commit-to-gdl">libhal_device_commit_to_gdl</a>         (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
310
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-commit-to-gdl">libhal_device_commit_to_gdl</a>         (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
288
311
                                                         const char *temp_udi,
289
312
                                                         const char *udi,
290
313
                                                         DBusError *error);
291
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-remove-device">libhal_remove_device</a>                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
314
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-remove-device">libhal_remove_device</a>                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
292
315
                                                         const char *udi,
293
316
                                                         DBusError *error);
294
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-merge-properties">libhal_merge_properties</a>             (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
317
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-merge-properties">libhal_merge_properties</a>             (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
295
318
                                                         const char *target_udi,
296
319
                                                         const char *source_udi,
297
320
                                                         DBusError *error);
298
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-matches">libhal_device_matches</a>               (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
321
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-matches">libhal_device_matches</a>               (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
299
322
                                                         const char *udi1,
300
323
                                                         const char *udi2,
301
324
                                                         const char *property_namespace,
302
325
                                                         DBusError *error);
303
 
char**              <a href="libhal-libhal.html#libhal-manager-find-device-string-match">libhal_manager_find_device_string_match</a>
304
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
326
char**              <a class="link" href="libhal-libhal.html#libhal-manager-find-device-string-match">libhal_manager_find_device_string_match</a>
 
327
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
305
328
                                                         const char *key,
306
329
                                                         const char *value,
307
330
                                                         int *num_devices,
308
331
                                                         DBusError *error);
309
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-add-capability">libhal_device_add_capability</a>        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
310
 
                                                         const char *udi,
311
 
                                                         const char *capability,
312
 
                                                         DBusError *error);
313
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-query-capability">libhal_device_query_capability</a>      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
314
 
                                                         const char *udi,
315
 
                                                         const char *capability,
316
 
                                                         DBusError *error);
317
 
char**              <a href="libhal-libhal.html#libhal-find-device-by-capability">libhal_find_device_by_capability</a>    (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
332
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-add-capability">libhal_device_add_capability</a>        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
333
                                                         const char *udi,
 
334
                                                         const char *capability,
 
335
                                                         DBusError *error);
 
336
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-query-capability">libhal_device_query_capability</a>      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
337
                                                         const char *udi,
 
338
                                                         const char *capability,
 
339
                                                         DBusError *error);
 
340
char**              <a class="link" href="libhal-libhal.html#libhal-find-device-by-capability">libhal_find_device_by_capability</a>    (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
318
341
                                                         const char *capability,
319
342
                                                         int *num_devices,
320
343
                                                         DBusError *error);
321
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-property-watch-all">libhal_device_property_watch_all</a>    (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
322
 
                                                         DBusError *error);
323
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-add-property-watch">libhal_device_add_property_watch</a>    (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
324
 
                                                         const char *udi,
325
 
                                                         DBusError *error);
326
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-remove-property-watch">libhal_device_remove_property_watch</a> (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
327
 
                                                         const char *udi,
328
 
                                                         DBusError *error);
329
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-lock">libhal_device_lock</a>                  (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
344
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-property-watch-all">libhal_device_property_watch_all</a>    (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
345
                                                         DBusError *error);
 
346
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-add-property-watch">libhal_device_add_property_watch</a>    (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
347
                                                         const char *udi,
 
348
                                                         DBusError *error);
 
349
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-remove-property-watch">libhal_device_remove_property_watch</a> (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
350
                                                         const char *udi,
 
351
                                                         DBusError *error);
 
352
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-lock">libhal_device_lock</a>                  (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
330
353
                                                         const char *udi,
331
354
                                                         const char *reason_to_lock,
332
355
                                                         char **reason_why_locked,
333
356
                                                         DBusError *error);
334
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-unlock">libhal_device_unlock</a>                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
335
 
                                                         const char *udi,
336
 
                                                         DBusError *error);
337
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-rescan">libhal_device_rescan</a>                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
338
 
                                                         const char *udi,
339
 
                                                         DBusError *error);
340
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-reprobe">libhal_device_reprobe</a>               (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
341
 
                                                         const char *udi,
342
 
                                                         DBusError *error);
343
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-emit-condition">libhal_device_emit_condition</a>        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
357
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-unlock">libhal_device_unlock</a>                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
358
                                                         const char *udi,
 
359
                                                         DBusError *error);
 
360
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-rescan">libhal_device_rescan</a>                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
361
                                                         const char *udi,
 
362
                                                         DBusError *error);
 
363
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-reprobe">libhal_device_reprobe</a>               (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
364
                                                         const char *udi,
 
365
                                                         DBusError *error);
 
366
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-emit-condition">libhal_device_emit_condition</a>        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
344
367
                                                         const char *udi,
345
368
                                                         const char *condition_name,
346
369
                                                         const char *condition_details,
347
370
                                                         DBusError *error);
348
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-claim-interface">libhal_device_claim_interface</a>       (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
371
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-claim-interface">libhal_device_claim_interface</a>       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
349
372
                                                         const char *udi,
350
373
                                                         const char *interface_name,
351
374
                                                         const char *introspection_xml,
352
375
                                                         DBusError *error);
353
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-addon-is-ready">libhal_device_addon_is_ready</a>        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
354
 
                                                         const char *udi,
355
 
                                                         DBusError *error);
356
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-acquire-interface-lock">libhal_device_acquire_interface_lock</a>
357
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
358
 
                                                         const char *udi,
359
 
                                                         const char *interface,
360
 
                                                         dbus_bool_t exclusive,
361
 
                                                         DBusError *error);
362
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-release-interface-lock">libhal_device_release_interface_lock</a>
363
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
364
 
                                                         const char *udi,
365
 
                                                         const char *interface,
366
 
                                                         DBusError *error);
367
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-acquire-global-interface-lock">libhal_acquire_global_interface_lock</a>
368
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
369
 
                                                         const char *interface,
370
 
                                                         dbus_bool_t exclusive,
371
 
                                                         DBusError *error);
372
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-release-global-interface-lock">libhal_release_global_interface_lock</a>
373
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
374
 
                                                         const char *interface,
375
 
                                                         DBusError *error);
376
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-is-caller-locked-out">libhal_device_is_caller_locked_out</a>  (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
377
 
                                                         const char *udi,
378
 
                                                         const char *interface,
379
 
                                                         const char *caller,
380
 
                                                         DBusError *error);
381
 
dbus_bool_t         <a href="libhal-libhal.html#libhal-device-is-locked-by-others">libhal_device_is_locked_by_others</a>   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
382
 
                                                         const char *udi,
383
 
                                                         const char *interface,
384
 
                                                         DBusError *error);
385
 
</pre>
386
 
</div>
387
 
<div class="refsect1" lang="en">
388
 
<a name="id2652940"></a><h2>Description</h2>
389
 
<p>
390
 
 
391
 
</p>
392
 
</div>
393
 
<div class="refsect1" lang="en">
394
 
<a name="id2652953"></a><h2>Details</h2>
395
 
<div class="refsect2" lang="en">
396
 
<a name="id2652963"></a><h3>
 
376
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-addon-is-ready">libhal_device_addon_is_ready</a>        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
377
                                                         const char *udi,
 
378
                                                         DBusError *error);
 
379
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-singleton-addon-is-ready">libhal_device_singleton_addon_is_ready</a>
 
380
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
381
                                                         const char *command_line,
 
382
                                                         DBusError *error);
 
383
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-acquire-interface-lock">libhal_device_acquire_interface_lock</a>
 
384
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
385
                                                         const char *udi,
 
386
                                                         const char *interface,
 
387
                                                         dbus_bool_t exclusive,
 
388
                                                         DBusError *error);
 
389
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-release-interface-lock">libhal_device_release_interface_lock</a>
 
390
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
391
                                                         const char *udi,
 
392
                                                         const char *interface,
 
393
                                                         DBusError *error);
 
394
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-acquire-global-interface-lock">libhal_acquire_global_interface_lock</a>
 
395
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
396
                                                         const char *interface,
 
397
                                                         dbus_bool_t exclusive,
 
398
                                                         DBusError *error);
 
399
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-release-global-interface-lock">libhal_release_global_interface_lock</a>
 
400
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
401
                                                         const char *interface,
 
402
                                                         DBusError *error);
 
403
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-is-caller-locked-out">libhal_device_is_caller_locked_out</a>  (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
404
                                                         const char *udi,
 
405
                                                         const char *interface,
 
406
                                                         const char *caller,
 
407
                                                         DBusError *error);
 
408
dbus_bool_t         <a class="link" href="libhal-libhal.html#libhal-device-is-locked-by-others">libhal_device_is_locked_by_others</a>   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
409
                                                         const char *udi,
 
410
                                                         const char *interface,
 
411
                                                         DBusError *error);
 
412
char*               <a class="link" href="libhal-libhal.html#libhal-device-is-caller-privileged">libhal_device_is_caller_privileged</a>  (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
413
                                                         const char *udi,
 
414
                                                         const char *action,
 
415
                                                         const char *caller,
 
416
                                                         DBusError *error);
 
417
</pre>
 
418
</div>
 
419
<div class="refsect1" lang="en">
 
420
<a name="id2965876"></a><h2>Description</h2>
 
421
<p>
 
422
 
 
423
</p>
 
424
</div>
 
425
<div class="refsect1" lang="en">
 
426
<a name="id2965890"></a><h2>Details</h2>
 
427
<div class="refsect2" lang="en">
 
428
<a name="id2965899"></a><h3>
 
429
<a name="DBUS-API-SUBJECT-TO-CHANGE:CAPS"></a>DBUS_API_SUBJECT_TO_CHANGE</h3>
 
430
<a class="indexterm" name="id2965912"></a><pre class="programlisting">#define DBUS_API_SUBJECT_TO_CHANGE 
 
431
</pre>
 
432
<p>
 
433
 
 
434
</p>
 
435
</div>
 
436
<hr>
 
437
<div class="refsect2" lang="en">
 
438
<a name="id2965926"></a><h3>
397
439
<a name="LIBHAL-DEPRECATED:CAPS"></a>LIBHAL_DEPRECATED</h3>
398
 
<a class="indexterm" name="id2652973"></a><pre class="programlisting">#define             LIBHAL_DEPRECATED</pre>
 
440
<a class="indexterm" name="id2965937"></a><pre class="programlisting">#define             LIBHAL_DEPRECATED</pre>
399
441
<p>
400
442
 
401
443
</p>
402
444
</div>
403
445
<hr>
404
446
<div class="refsect2" lang="en">
405
 
<a name="id2652988"></a><h3>
 
447
<a name="id2965951"></a><h3>
406
448
<a name="LIBHAL-FREE-DBUS-ERROR:CAPS"></a>LIBHAL_FREE_DBUS_ERROR()</h3>
407
 
<a class="indexterm" name="id2652998"></a><pre class="programlisting">#define             LIBHAL_FREE_DBUS_ERROR(_dbus_error_)</pre>
 
449
<a class="indexterm" name="id2965961"></a><pre class="programlisting">#define             LIBHAL_FREE_DBUS_ERROR(_dbus_error_)</pre>
408
450
<p>
409
451
 
410
452
</p>
411
453
<div class="variablelist"><table border="0">
412
454
<col align="left" valign="top">
413
455
<tbody><tr>
414
 
<td><span class="term"><em class="parameter"><code>_dbus_error_</code></em>&#160;:</span></td>
 
456
<td><p><span class="term"><em class="parameter"><code>_dbus_error_</code></em>&#160;:</span></p></td>
415
457
<td>
416
458
 
417
459
 
421
463
</div>
422
464
<hr>
423
465
<div class="refsect2" lang="en">
424
 
<a name="id2653029"></a><h3>
 
466
<a name="id2965993"></a><h3>
425
467
<a name="LIBHAL-CHECK-LIBHALCONTEXT:CAPS"></a>LIBHAL_CHECK_LIBHALCONTEXT()</h3>
426
 
<a class="indexterm" name="id2653042"></a><pre class="programlisting">#define             LIBHAL_CHECK_LIBHALCONTEXT(_ctx_, _ret_)</pre>
 
468
<a class="indexterm" name="id2966005"></a><pre class="programlisting">#define             LIBHAL_CHECK_LIBHALCONTEXT(_ctx_, _ret_)</pre>
427
469
<p>
428
470
Handy macro for checking whether a context is valid.</p>
429
471
<p>
433
475
<col align="left" valign="top">
434
476
<tbody>
435
477
<tr>
436
 
<td><span class="term"><em class="parameter"><code>_ctx_</code></em>&#160;:</span></td>
 
478
<td><p><span class="term"><em class="parameter"><code>_ctx_</code></em>&#160;:</span></p></td>
437
479
<td> the context
438
480
</td>
439
481
</tr>
440
482
<tr>
441
 
<td><span class="term"><em class="parameter"><code>_ret_</code></em>&#160;:</span></td>
 
483
<td><p><span class="term"><em class="parameter"><code>_ret_</code></em>&#160;:</span></p></td>
442
484
<td> what to use for return value if context is invalid
443
485
</td>
444
486
</tr>
447
489
</div>
448
490
<hr>
449
491
<div class="refsect2" lang="en">
450
 
<a name="id2653091"></a><h3>
 
492
<a name="id2966054"></a><h3>
451
493
<a name="LibHalPropertyType"></a>enum LibHalPropertyType</h3>
452
 
<a class="indexterm" name="id2653102"></a><pre class="programlisting">typedef enum {
 
494
<a class="indexterm" name="id2966065"></a><pre class="programlisting">typedef enum {
453
495
        /** Used to report error condition */
454
496
        LIBHAL_PROPERTY_TYPE_INVALID =    DBUS_TYPE_INVALID,
455
497
 
480
522
</div>
481
523
<hr>
482
524
<div class="refsect2" lang="en">
483
 
<a name="id2653132"></a><h3>
 
525
<a name="id2966095"></a><h3>
484
526
<a name="LibHalContext"></a>LibHalContext</h3>
485
 
<a class="indexterm" name="id2653143"></a><pre class="programlisting">typedef struct LibHalContext_s LibHalContext;
 
527
<a class="indexterm" name="id2966106"></a><pre class="programlisting">typedef struct LibHalContext_s LibHalContext;
486
528
</pre>
487
529
<p>
488
530
Context for connection to the HAL daemon. Opaque, use the
493
535
</div>
494
536
<hr>
495
537
<div class="refsect2" lang="en">
496
 
<a name="id2653162"></a><h3>
 
538
<a name="id2966125"></a><h3>
 
539
<a name="LibHalProperty"></a>LibHalProperty</h3>
 
540
<a class="indexterm" name="id2966136"></a><pre class="programlisting">typedef struct LibHalProperty_s LibHalProperty;
 
541
</pre>
 
542
<p>
 
543
Represents a property. Opaque.</p>
 
544
<p>
 
545
 
 
546
</p>
 
547
</div>
 
548
<hr>
 
549
<div class="refsect2" lang="en">
 
550
<a name="id2966155"></a><h3>
 
551
<a name="LibHalPropertySet"></a>LibHalPropertySet</h3>
 
552
<a class="indexterm" name="id2966168"></a><pre class="programlisting">typedef struct LibHalPropertySet_s LibHalPropertySet;
 
553
</pre>
 
554
<p>
 
555
Represents a set of properties. Opaque; use the
 
556
libhal_property_set_*() family of functions to access it.</p>
 
557
<p>
 
558
 
 
559
</p>
 
560
</div>
 
561
<hr>
 
562
<div class="refsect2" lang="en">
 
563
<a name="id2966190"></a><h3>
497
564
<a name="LibHalIntegrateDBusIntoMainLoop"></a>LibHalIntegrateDBusIntoMainLoop ()</h3>
498
 
<a class="indexterm" name="id2653175"></a><pre class="programlisting">void                (*LibHalIntegrateDBusIntoMainLoop)  (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
565
<a class="indexterm" name="id2966203"></a><pre class="programlisting">void                (*LibHalIntegrateDBusIntoMainLoop)  (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
499
566
                                                         DBusConnection *dbus_connection);</pre>
500
567
<p>
501
568
Type for function in application code that integrates a
507
574
<col align="left" valign="top">
508
575
<tbody>
509
576
<tr>
510
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
577
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
511
578
<td> context for connection to hald
512
579
</td>
513
580
</tr>
514
581
<tr>
515
 
<td><span class="term"><em class="parameter"><code>dbus_connection</code></em>&#160;:</span></td>
 
582
<td><p><span class="term"><em class="parameter"><code>dbus_connection</code></em>&#160;:</span></p></td>
516
583
<td> DBus connection to use in ctx
517
584
</td>
518
585
</tr>
521
588
</div>
522
589
<hr>
523
590
<div class="refsect2" lang="en">
524
 
<a name="id2653242"></a><h3>
 
591
<a name="id2966278"></a><h3>
525
592
<a name="LibHalDeviceAdded"></a>LibHalDeviceAdded ()</h3>
526
 
<a class="indexterm" name="id2653252"></a><pre class="programlisting">void                (*LibHalDeviceAdded)                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
593
<a class="indexterm" name="id2966291"></a><pre class="programlisting">void                (*LibHalDeviceAdded)                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
527
594
                                                         const char *udi);</pre>
528
595
<p>
529
596
Type for callback when a device is added.</p>
534
601
<col align="left" valign="top">
535
602
<tbody>
536
603
<tr>
537
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
604
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
538
605
<td> context for connection to hald
539
606
</td>
540
607
</tr>
541
608
<tr>
542
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
609
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
543
610
<td> the Unique Device Id
544
611
</td>
545
612
</tr>
548
615
</div>
549
616
<hr>
550
617
<div class="refsect2" lang="en">
551
 
<a name="id2653317"></a><h3>
 
618
<a name="id2966364"></a><h3>
552
619
<a name="LibHalDeviceRemoved"></a>LibHalDeviceRemoved ()</h3>
553
 
<a class="indexterm" name="id2653327"></a><pre class="programlisting">void                (*LibHalDeviceRemoved)              (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
620
<a class="indexterm" name="id2966377"></a><pre class="programlisting">void                (*LibHalDeviceRemoved)              (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
554
621
                                                         const char *udi);</pre>
555
622
<p>
556
623
Type for callback when a device is removed.</p>
561
628
<col align="left" valign="top">
562
629
<tbody>
563
630
<tr>
564
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
631
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
565
632
<td> context for connection to hald
566
633
</td>
567
634
</tr>
568
635
<tr>
569
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
636
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
570
637
<td> the Unique Device Id
571
638
</td>
572
639
</tr>
575
642
</div>
576
643
<hr>
577
644
<div class="refsect2" lang="en">
578
 
<a name="id2653392"></a><h3>
 
645
<a name="id2966449"></a><h3>
579
646
<a name="LibHalDeviceNewCapability"></a>LibHalDeviceNewCapability ()</h3>
580
 
<a class="indexterm" name="id2653403"></a><pre class="programlisting">void                (*LibHalDeviceNewCapability)        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
647
<a class="indexterm" name="id2966463"></a><pre class="programlisting">void                (*LibHalDeviceNewCapability)        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
581
648
                                                         const char *udi,
582
649
                                                         const char *capability);</pre>
583
650
<p>
589
656
<col align="left" valign="top">
590
657
<tbody>
591
658
<tr>
592
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
659
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
593
660
<td> context for connection to hald
594
661
</td>
595
662
</tr>
596
663
<tr>
597
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
664
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
598
665
<td> the Unique Device Id
599
666
</td>
600
667
</tr>
601
668
<tr>
602
 
<td><span class="term"><em class="parameter"><code>capability</code></em>&#160;:</span></td>
 
669
<td><p><span class="term"><em class="parameter"><code>capability</code></em>&#160;:</span></p></td>
603
670
<td> capability of the device
604
671
</td>
605
672
</tr>
608
675
</div>
609
676
<hr>
610
677
<div class="refsect2" lang="en">
611
 
<a name="id2653487"></a><h3>
 
678
<a name="id2966558"></a><h3>
612
679
<a name="LibHalDeviceLostCapability"></a>LibHalDeviceLostCapability ()</h3>
613
 
<a class="indexterm" name="id2653498"></a><pre class="programlisting">void                (*LibHalDeviceLostCapability)       (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
680
<a class="indexterm" name="id2966572"></a><pre class="programlisting">void                (*LibHalDeviceLostCapability)       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
614
681
                                                         const char *udi,
615
682
                                                         const char *capability);</pre>
616
683
<p>
622
689
<col align="left" valign="top">
623
690
<tbody>
624
691
<tr>
625
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
692
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
626
693
<td> context for connection to hald
627
694
</td>
628
695
</tr>
629
696
<tr>
630
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
697
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
631
698
<td> the Unique Device Id
632
699
</td>
633
700
</tr>
634
701
<tr>
635
 
<td><span class="term"><em class="parameter"><code>capability</code></em>&#160;:</span></td>
 
702
<td><p><span class="term"><em class="parameter"><code>capability</code></em>&#160;:</span></p></td>
636
703
<td> capability of the device
637
704
</td>
638
705
</tr>
641
708
</div>
642
709
<hr>
643
710
<div class="refsect2" lang="en">
644
 
<a name="id2653582"></a><h3>
 
711
<a name="id2966666"></a><h3>
645
712
<a name="LibHalDevicePropertyModified"></a>LibHalDevicePropertyModified ()</h3>
646
 
<a class="indexterm" name="id2653595"></a><pre class="programlisting">void                (*LibHalDevicePropertyModified)     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
713
<a class="indexterm" name="id2966680"></a><pre class="programlisting">void                (*LibHalDevicePropertyModified)     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
647
714
                                                         const char *udi,
648
715
                                                         const char *key,
649
716
                                                         dbus_bool_t is_removed,
657
724
<col align="left" valign="top">
658
725
<tbody>
659
726
<tr>
660
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
727
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
661
728
<td> context for connection to hald
662
729
</td>
663
730
</tr>
664
731
<tr>
665
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
732
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
666
733
<td> the Unique Device Id
667
734
</td>
668
735
</tr>
669
736
<tr>
670
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
737
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
671
738
<td> name of the property that has changed
672
739
</td>
673
740
</tr>
674
741
<tr>
675
 
<td><span class="term"><em class="parameter"><code>is_removed</code></em>&#160;:</span></td>
 
742
<td><p><span class="term"><em class="parameter"><code>is_removed</code></em>&#160;:</span></p></td>
676
743
<td> whether or not property was removed
677
744
</td>
678
745
</tr>
679
746
<tr>
680
 
<td><span class="term"><em class="parameter"><code>is_added</code></em>&#160;:</span></td>
 
747
<td><p><span class="term"><em class="parameter"><code>is_added</code></em>&#160;:</span></p></td>
681
748
<td> whether or not property was added
682
749
</td>
683
750
</tr>
686
753
</div>
687
754
<hr>
688
755
<div class="refsect2" lang="en">
689
 
<a name="id2653720"></a><h3>
 
756
<a name="id2966818"></a><h3>
690
757
<a name="LibHalDeviceCondition"></a>LibHalDeviceCondition ()</h3>
691
 
<a class="indexterm" name="id2653731"></a><pre class="programlisting">void                (*LibHalDeviceCondition)            (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
758
<a class="indexterm" name="id2966832"></a><pre class="programlisting">void                (*LibHalDeviceCondition)            (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
692
759
                                                         const char *udi,
693
760
                                                         const char *condition_name,
694
761
                                                         const char *condition_detail);</pre>
701
768
<col align="left" valign="top">
702
769
<tbody>
703
770
<tr>
704
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
771
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
705
772
<td> context for connection to hald
706
773
</td>
707
774
</tr>
708
775
<tr>
709
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
776
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
710
777
<td> the Unique Device Id
711
778
</td>
712
779
</tr>
713
780
<tr>
714
 
<td><span class="term"><em class="parameter"><code>condition_name</code></em>&#160;:</span></td>
 
781
<td><p><span class="term"><em class="parameter"><code>condition_name</code></em>&#160;:</span></p></td>
715
782
<td> name of the condition, e.g. ProcessorOverheating. Consult the HAL spec for details
716
783
</td>
717
784
</tr>
718
785
<tr>
719
 
<td><span class="term"><em class="parameter"><code>condition_detail</code></em>&#160;:</span></td>
 
786
<td><p><span class="term"><em class="parameter"><code>condition_detail</code></em>&#160;:</span></p></td>
720
787
<td> detail of condition
721
788
</td>
722
789
</tr>
725
792
</div>
726
793
<hr>
727
794
<div class="refsect2" lang="en">
728
 
<a name="id2653836"></a><h3>
 
795
<a name="id2966950"></a><h3>
729
796
<a name="LibHalGlobalInterfaceLockAcquired"></a>LibHalGlobalInterfaceLockAcquired ()</h3>
730
 
<a class="indexterm" name="id2653849"></a><pre class="programlisting">void                (*LibHalGlobalInterfaceLockAcquired)
731
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
797
<a class="indexterm" name="id2966964"></a><pre class="programlisting">void                (*LibHalGlobalInterfaceLockAcquired)
 
798
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
732
799
                                                         const char *interface_name,
733
800
                                                         const char *lock_owner,
734
801
                                                         int num_locks);</pre>
741
808
<col align="left" valign="top">
742
809
<tbody>
743
810
<tr>
744
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
811
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
745
812
<td> context for connection to hald
746
813
</td>
747
814
</tr>
748
815
<tr>
749
 
<td><span class="term"><em class="parameter"><code>interface_name</code></em>&#160;:</span></td>
 
816
<td><p><span class="term"><em class="parameter"><code>interface_name</code></em>&#160;:</span></p></td>
750
817
<td> the name of the interface
751
818
</td>
752
819
</tr>
753
820
<tr>
754
 
<td><span class="term"><em class="parameter"><code>lock_owner</code></em>&#160;:</span></td>
 
821
<td><p><span class="term"><em class="parameter"><code>lock_owner</code></em>&#160;:</span></p></td>
755
822
<td> what service acquired the lock
756
823
</td>
757
824
</tr>
758
825
<tr>
759
 
<td><span class="term"><em class="parameter"><code>num_locks</code></em>&#160;:</span></td>
 
826
<td><p><span class="term"><em class="parameter"><code>num_locks</code></em>&#160;:</span></p></td>
760
827
<td> number of locks on the interface
761
828
</td>
762
829
</tr>
765
832
</div>
766
833
<hr>
767
834
<div class="refsect2" lang="en">
768
 
<a name="id2653955"></a><h3>
 
835
<a name="id2967082"></a><h3>
769
836
<a name="LibHalGlobalInterfaceLockReleased"></a>LibHalGlobalInterfaceLockReleased ()</h3>
770
 
<a class="indexterm" name="id2653968"></a><pre class="programlisting">void                (*LibHalGlobalInterfaceLockReleased)
771
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
837
<a class="indexterm" name="id2967096"></a><pre class="programlisting">void                (*LibHalGlobalInterfaceLockReleased)
 
838
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
772
839
                                                         const char *interface_name,
773
840
                                                         const char *lock_owner,
774
841
                                                         int num_locks);</pre>
781
848
<col align="left" valign="top">
782
849
<tbody>
783
850
<tr>
784
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
851
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
785
852
<td> context for connection to hald
786
853
</td>
787
854
</tr>
788
855
<tr>
789
 
<td><span class="term"><em class="parameter"><code>interface_name</code></em>&#160;:</span></td>
 
856
<td><p><span class="term"><em class="parameter"><code>interface_name</code></em>&#160;:</span></p></td>
790
857
<td> the name of the interface
791
858
</td>
792
859
</tr>
793
860
<tr>
794
 
<td><span class="term"><em class="parameter"><code>lock_owner</code></em>&#160;:</span></td>
 
861
<td><p><span class="term"><em class="parameter"><code>lock_owner</code></em>&#160;:</span></p></td>
795
862
<td> what service released the lock
796
863
</td>
797
864
</tr>
798
865
<tr>
799
 
<td><span class="term"><em class="parameter"><code>num_locks</code></em>&#160;:</span></td>
 
866
<td><p><span class="term"><em class="parameter"><code>num_locks</code></em>&#160;:</span></p></td>
800
867
<td> number of locks on the interface
801
868
</td>
802
869
</tr>
805
872
</div>
806
873
<hr>
807
874
<div class="refsect2" lang="en">
808
 
<a name="id2654074"></a><h3>
 
875
<a name="id2967214"></a><h3>
809
876
<a name="LibHalInterfaceLockAcquired"></a>LibHalInterfaceLockAcquired ()</h3>
810
 
<a class="indexterm" name="id2654085"></a><pre class="programlisting">void                (*LibHalInterfaceLockAcquired)      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
877
<a class="indexterm" name="id2967228"></a><pre class="programlisting">void                (*LibHalInterfaceLockAcquired)      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
811
878
                                                         const char *udi,
812
879
                                                         const char *interface_name,
813
880
                                                         const char *lock_owner,
821
888
<col align="left" valign="top">
822
889
<tbody>
823
890
<tr>
824
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
891
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
825
892
<td> context for connection to hald
826
893
</td>
827
894
</tr>
828
895
<tr>
829
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
896
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
830
897
<td> the Unique Device Id
831
898
</td>
832
899
</tr>
833
900
<tr>
834
 
<td><span class="term"><em class="parameter"><code>interface_name</code></em>&#160;:</span></td>
 
901
<td><p><span class="term"><em class="parameter"><code>interface_name</code></em>&#160;:</span></p></td>
835
902
<td> the name of the interface
836
903
</td>
837
904
</tr>
838
905
<tr>
839
 
<td><span class="term"><em class="parameter"><code>lock_owner</code></em>&#160;:</span></td>
 
906
<td><p><span class="term"><em class="parameter"><code>lock_owner</code></em>&#160;:</span></p></td>
840
907
<td> what service acquired the lock
841
908
</td>
842
909
</tr>
843
910
<tr>
844
 
<td><span class="term"><em class="parameter"><code>num_locks</code></em>&#160;:</span></td>
 
911
<td><p><span class="term"><em class="parameter"><code>num_locks</code></em>&#160;:</span></p></td>
845
912
<td> number of locks on the interface
846
913
</td>
847
914
</tr>
850
917
</div>
851
918
<hr>
852
919
<div class="refsect2" lang="en">
853
 
<a name="id2654209"></a><h3>
 
920
<a name="id2967366"></a><h3>
854
921
<a name="LibHalInterfaceLockReleased"></a>LibHalInterfaceLockReleased ()</h3>
855
 
<a class="indexterm" name="id2654220"></a><pre class="programlisting">void                (*LibHalInterfaceLockReleased)      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
922
<a class="indexterm" name="id2967380"></a><pre class="programlisting">void                (*LibHalInterfaceLockReleased)      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
856
923
                                                         const char *udi,
857
924
                                                         const char *interface_name,
858
925
                                                         const char *lock_owner,
866
933
<col align="left" valign="top">
867
934
<tbody>
868
935
<tr>
869
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
936
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
870
937
<td> context for connection to hald
871
938
</td>
872
939
</tr>
873
940
<tr>
874
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
941
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
875
942
<td> the Unique Device Id
876
943
</td>
877
944
</tr>
878
945
<tr>
879
 
<td><span class="term"><em class="parameter"><code>interface_name</code></em>&#160;:</span></td>
 
946
<td><p><span class="term"><em class="parameter"><code>interface_name</code></em>&#160;:</span></p></td>
880
947
<td> the name of the interface
881
948
</td>
882
949
</tr>
883
950
<tr>
884
 
<td><span class="term"><em class="parameter"><code>lock_owner</code></em>&#160;:</span></td>
 
951
<td><p><span class="term"><em class="parameter"><code>lock_owner</code></em>&#160;:</span></p></td>
885
952
<td> what service released the lock
886
953
</td>
887
954
</tr>
888
955
<tr>
889
 
<td><span class="term"><em class="parameter"><code>num_locks</code></em>&#160;:</span></td>
 
956
<td><p><span class="term"><em class="parameter"><code>num_locks</code></em>&#160;:</span></p></td>
890
957
<td> number of locks on the interface
891
958
</td>
892
959
</tr>
895
962
</div>
896
963
<hr>
897
964
<div class="refsect2" lang="en">
898
 
<a name="id2654358"></a><h3>
 
965
<a name="id2967518"></a><h3>
 
966
<a name="LibHalSingletonDeviceAdded"></a>LibHalSingletonDeviceAdded ()</h3>
 
967
<a class="indexterm" name="id2967532"></a><pre class="programlisting">void                (*LibHalSingletonDeviceAdded)       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
968
                                                         const char *udi,
 
969
                                                         const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *properties);</pre>
 
970
<p>
 
971
Type for callback for addon singletons when a device is added</p>
 
972
<p>
 
973
 
 
974
</p>
 
975
<div class="variablelist"><table border="0">
 
976
<col align="left" valign="top">
 
977
<tbody>
 
978
<tr>
 
979
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
 
980
<td> context for connection to hald
 
981
</td>
 
982
</tr>
 
983
<tr>
 
984
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
 
985
<td> the Unique Device Id
 
986
</td>
 
987
</tr>
 
988
<tr>
 
989
<td><p><span class="term"><em class="parameter"><code>properties</code></em>&#160;:</span></p></td>
 
990
<td> the device's properties
 
991
</td>
 
992
</tr>
 
993
</tbody>
 
994
</table></div>
 
995
</div>
 
996
<hr>
 
997
<div class="refsect2" lang="en">
 
998
<a name="id2967626"></a><h3>
 
999
<a name="LibHalSingletonDeviceRemoved"></a>LibHalSingletonDeviceRemoved ()</h3>
 
1000
<a class="indexterm" name="id2967640"></a><pre class="programlisting">void                (*LibHalSingletonDeviceRemoved)     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1001
                                                         const char *udi,
 
1002
                                                         const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *properties);</pre>
 
1003
<p>
 
1004
Type for callback for addon singletons when a device is added</p>
 
1005
<p>
 
1006
 
 
1007
</p>
 
1008
<div class="variablelist"><table border="0">
 
1009
<col align="left" valign="top">
 
1010
<tbody>
 
1011
<tr>
 
1012
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
 
1013
<td> context for connection to hald
 
1014
</td>
 
1015
</tr>
 
1016
<tr>
 
1017
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
 
1018
<td> the Unique Device Id
 
1019
</td>
 
1020
</tr>
 
1021
<tr>
 
1022
<td><p><span class="term"><em class="parameter"><code>properties</code></em>&#160;:</span></p></td>
 
1023
<td> the device's properties
 
1024
</td>
 
1025
</tr>
 
1026
</tbody>
 
1027
</table></div>
 
1028
</div>
 
1029
<hr>
 
1030
<div class="refsect2" lang="en">
 
1031
<a name="id2967736"></a><h3>
899
1032
<a name="libhal-ctx-new"></a>libhal_ctx_new ()</h3>
900
 
<a class="indexterm" name="id2654371"></a><pre class="programlisting"><a href="libhal-libhal.html#LibHalContext">LibHalContext</a>*      libhal_ctx_new                      (void);</pre>
 
1033
<a class="indexterm" name="id2967748"></a><pre class="programlisting"><a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a>*      libhal_ctx_new                      (void);</pre>
901
1034
<p>
902
1035
Create a new LibHalContext</p>
903
1036
<p>
906
1039
<div class="variablelist"><table border="0">
907
1040
<col align="left" valign="top">
908
1041
<tbody><tr>
909
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1042
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
910
1043
<td> a new uninitialized LibHalContext object
911
1044
</td>
912
1045
</tr></tbody>
914
1047
</div>
915
1048
<hr>
916
1049
<div class="refsect2" lang="en">
917
 
<a name="id2654412"></a><h3>
 
1050
<a name="id2967790"></a><h3>
918
1051
<a name="libhal-ctx-set-cache"></a>libhal_ctx_set_cache ()</h3>
919
 
<a class="indexterm" name="id2654426"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_cache                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1052
<a class="indexterm" name="id2967803"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_cache                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
920
1053
                                                         dbus_bool_t use_cache);</pre>
921
1054
<p>
922
1055
Enable or disable caching. Note: Caching is not actually
928
1061
<col align="left" valign="top">
929
1062
<tbody>
930
1063
<tr>
931
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1064
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
932
1065
<td> context to enable/disable cache for
933
1066
</td>
934
1067
</tr>
935
1068
<tr>
936
 
<td><span class="term"><em class="parameter"><code>use_cache</code></em>&#160;:</span></td>
 
1069
<td><p><span class="term"><em class="parameter"><code>use_cache</code></em>&#160;:</span></p></td>
937
1070
<td> whether or not to use cache
938
1071
</td>
939
1072
</tr>
940
1073
<tr>
941
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1074
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
942
1075
<td> TRUE if cache was successfully enabled/disabled, FALSE otherwise
943
1076
</td>
944
1077
</tr>
947
1080
</div>
948
1081
<hr>
949
1082
<div class="refsect2" lang="en">
950
 
<a name="id2654511"></a><h3>
 
1083
<a name="id2967888"></a><h3>
951
1084
<a name="libhal-ctx-set-dbus-connection"></a>libhal_ctx_set_dbus_connection ()</h3>
952
 
<a class="indexterm" name="id2654524"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_dbus_connection      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1085
<a class="indexterm" name="id2967902"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_dbus_connection      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
953
1086
                                                         DBusConnection *conn);</pre>
954
1087
<p>
955
1088
Set DBus connection to use to talk to hald.</p>
960
1093
<col align="left" valign="top">
961
1094
<tbody>
962
1095
<tr>
963
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1096
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
964
1097
<td> context to set connection for
965
1098
</td>
966
1099
</tr>
967
1100
<tr>
968
 
<td><span class="term"><em class="parameter"><code>conn</code></em>&#160;:</span></td>
 
1101
<td><p><span class="term"><em class="parameter"><code>conn</code></em>&#160;:</span></p></td>
969
1102
<td> DBus connection to use
970
1103
</td>
971
1104
</tr>
972
1105
<tr>
973
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1106
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
974
1107
<td> TRUE if connection was successfully set, FALSE otherwise
975
1108
</td>
976
1109
</tr>
979
1112
</div>
980
1113
<hr>
981
1114
<div class="refsect2" lang="en">
982
 
<a name="id2654609"></a><h3>
 
1115
<a name="id2967986"></a><h3>
983
1116
<a name="libhal-ctx-get-dbus-connection"></a>libhal_ctx_get_dbus_connection ()</h3>
984
 
<a class="indexterm" name="id2654623"></a><pre class="programlisting">DBusConnection*     libhal_ctx_get_dbus_connection      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);</pre>
 
1117
<a class="indexterm" name="id2968000"></a><pre class="programlisting">DBusConnection*     libhal_ctx_get_dbus_connection      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);</pre>
985
1118
<p>
986
1119
Get DBus connection used for talking to hald.</p>
987
1120
<p>
991
1124
<col align="left" valign="top">
992
1125
<tbody>
993
1126
<tr>
994
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1127
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
995
1128
<td> context to get connection for
996
1129
</td>
997
1130
</tr>
998
1131
<tr>
999
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1132
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1000
1133
<td> DBus connection to use or NULL
1001
1134
</td>
1002
1135
</tr>
1005
1138
</div>
1006
1139
<hr>
1007
1140
<div class="refsect2" lang="en">
1008
 
<a name="id2654685"></a><h3>
 
1141
<a name="id2968063"></a><h3>
1009
1142
<a name="libhal-ctx-set-user-data"></a>libhal_ctx_set_user_data ()</h3>
1010
 
<a class="indexterm" name="id2654699"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_user_data            (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1143
<a class="indexterm" name="id2968076"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_user_data            (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1011
1144
                                                         void *user_data);</pre>
1012
1145
<p>
1013
1146
Set user data for the context.</p>
1018
1151
<col align="left" valign="top">
1019
1152
<tbody>
1020
1153
<tr>
1021
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1154
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1022
1155
<td> the context for the connection to hald
1023
1156
</td>
1024
1157
</tr>
1025
1158
<tr>
1026
 
<td><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></td>
 
1159
<td><p><span class="term"><em class="parameter"><code>user_data</code></em>&#160;:</span></p></td>
1027
1160
<td> user data
1028
1161
</td>
1029
1162
</tr>
1030
1163
<tr>
1031
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1164
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1032
1165
<td> TRUE if user data was successfully set, FALSE if otherwise
1033
1166
</td>
1034
1167
</tr>
1037
1170
</div>
1038
1171
<hr>
1039
1172
<div class="refsect2" lang="en">
1040
 
<a name="id2654783"></a><h3>
 
1173
<a name="id2968160"></a><h3>
1041
1174
<a name="libhal-ctx-get-user-data"></a>libhal_ctx_get_user_data ()</h3>
1042
 
<a class="indexterm" name="id2654796"></a><pre class="programlisting">void*               libhal_ctx_get_user_data            (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);</pre>
 
1175
<a class="indexterm" name="id2968173"></a><pre class="programlisting">void*               libhal_ctx_get_user_data            (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);</pre>
1043
1176
<p>
1044
1177
Get user data for the context.</p>
1045
1178
<p>
1049
1182
<col align="left" valign="top">
1050
1183
<tbody>
1051
1184
<tr>
1052
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1185
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1053
1186
<td> the context for the connection to hald
1054
1187
</td>
1055
1188
</tr>
1056
1189
<tr>
1057
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
1058
 
<td> opaque pointer stored through <a href="libhal-libhal.html#libhal-ctx-set-user-data"><code class="function">libhal_ctx_set_user_data()</code></a> or NULL if not set.
 
1190
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1191
<td> opaque pointer stored through <a class="link" href="libhal-libhal.html#libhal-ctx-set-user-data"><code class="function">libhal_ctx_set_user_data()</code></a> or NULL if not set.
1059
1192
</td>
1060
1193
</tr>
1061
1194
</tbody>
1063
1196
</div>
1064
1197
<hr>
1065
1198
<div class="refsect2" lang="en">
1066
 
<a name="id2654868"></a><h3>
 
1199
<a name="id2968246"></a><h3>
1067
1200
<a name="libhal-ctx-set-device-added"></a>libhal_ctx_set_device_added ()</h3>
1068
 
<a class="indexterm" name="id2654882"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_added         (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1069
 
                                                         <a href="libhal-libhal.html#LibHalDeviceAdded">LibHalDeviceAdded</a> callback);</pre>
 
1201
<a class="indexterm" name="id2968260"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_added         (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1202
                                                         <a class="link" href="libhal-libhal.html#LibHalDeviceAdded">LibHalDeviceAdded</a> callback);</pre>
1070
1203
<p>
1071
1204
Set the callback for when a device is added</p>
1072
1205
<p>
1076
1209
<col align="left" valign="top">
1077
1210
<tbody>
1078
1211
<tr>
1079
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1212
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1080
1213
<td> the context for the connection to hald
1081
1214
</td>
1082
1215
</tr>
1083
1216
<tr>
1084
 
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
1217
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
1085
1218
<td> the function to call when a device is added
1086
1219
</td>
1087
1220
</tr>
1088
1221
<tr>
1089
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1222
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1090
1223
<td> TRUE if callback was successfully set, FALSE otherwise
1091
1224
</td>
1092
1225
</tr>
1095
1228
</div>
1096
1229
<hr>
1097
1230
<div class="refsect2" lang="en">
1098
 
<a name="id2654967"></a><h3>
 
1231
<a name="id2968344"></a><h3>
1099
1232
<a name="libhal-ctx-set-device-removed"></a>libhal_ctx_set_device_removed ()</h3>
1100
 
<a class="indexterm" name="id2654980"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_removed       (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1101
 
                                                         <a href="libhal-libhal.html#LibHalDeviceRemoved">LibHalDeviceRemoved</a> callback);</pre>
 
1233
<a class="indexterm" name="id2968358"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_removed       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1234
                                                         <a class="link" href="libhal-libhal.html#LibHalDeviceRemoved">LibHalDeviceRemoved</a> callback);</pre>
1102
1235
<p>
1103
1236
Set the callback for when a device is removed.</p>
1104
1237
<p>
1108
1241
<col align="left" valign="top">
1109
1242
<tbody>
1110
1243
<tr>
1111
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1244
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1112
1245
<td> the context for the connection to hald
1113
1246
</td>
1114
1247
</tr>
1115
1248
<tr>
1116
 
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
1249
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
1117
1250
<td> the function to call when a device is removed
1118
1251
</td>
1119
1252
</tr>
1120
1253
<tr>
1121
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1254
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1122
1255
<td> TRUE if callback was successfully set, FALSE otherwise
1123
1256
</td>
1124
1257
</tr>
1127
1260
</div>
1128
1261
<hr>
1129
1262
<div class="refsect2" lang="en">
1130
 
<a name="id2655066"></a><h3>
 
1263
<a name="id2968443"></a><h3>
1131
1264
<a name="libhal-ctx-set-device-new-capability"></a>libhal_ctx_set_device_new_capability ()</h3>
1132
 
<a class="indexterm" name="id2655080"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_new_capability
1133
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1134
 
                                                         <a href="libhal-libhal.html#LibHalDeviceNewCapability">LibHalDeviceNewCapability</a> callback);</pre>
 
1265
<a class="indexterm" name="id2968457"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_new_capability
 
1266
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1267
                                                         <a class="link" href="libhal-libhal.html#LibHalDeviceNewCapability">LibHalDeviceNewCapability</a> callback);</pre>
1135
1268
<p>
1136
1269
Set the callback for when a device gains a new capability.</p>
1137
1270
<p>
1141
1274
<col align="left" valign="top">
1142
1275
<tbody>
1143
1276
<tr>
1144
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1277
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1145
1278
<td> the context for the connection to hald
1146
1279
</td>
1147
1280
</tr>
1148
1281
<tr>
1149
 
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
1282
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
1150
1283
<td> the function to call when a device gains a new capability
1151
1284
</td>
1152
1285
</tr>
1153
1286
<tr>
1154
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1287
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1155
1288
<td> TRUE if callback was successfully set, FALSE otherwise
1156
1289
</td>
1157
1290
</tr>
1160
1293
</div>
1161
1294
<hr>
1162
1295
<div class="refsect2" lang="en">
1163
 
<a name="id2655166"></a><h3>
 
1296
<a name="id2968544"></a><h3>
1164
1297
<a name="libhal-ctx-set-device-lost-capability"></a>libhal_ctx_set_device_lost_capability ()</h3>
1165
 
<a class="indexterm" name="id2655180"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_lost_capability
1166
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1167
 
                                                         <a href="libhal-libhal.html#LibHalDeviceLostCapability">LibHalDeviceLostCapability</a> callback);</pre>
 
1298
<a class="indexterm" name="id2968558"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_lost_capability
 
1299
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1300
                                                         <a class="link" href="libhal-libhal.html#LibHalDeviceLostCapability">LibHalDeviceLostCapability</a> callback);</pre>
1168
1301
<p>
1169
1302
Set the callback for when a device loses a capability</p>
1170
1303
<p>
1174
1307
<col align="left" valign="top">
1175
1308
<tbody>
1176
1309
<tr>
1177
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1310
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1178
1311
<td> the context for the connection to hald
1179
1312
</td>
1180
1313
</tr>
1181
1314
<tr>
1182
 
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
1315
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
1183
1316
<td> the function to call when a device loses a capability
1184
1317
</td>
1185
1318
</tr>
1186
1319
<tr>
1187
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1320
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1188
1321
<td> TRUE if callback was successfully set, FALSE otherwise
1189
1322
</td>
1190
1323
</tr>
1193
1326
</div>
1194
1327
<hr>
1195
1328
<div class="refsect2" lang="en">
1196
 
<a name="id2655267"></a><h3>
 
1329
<a name="id2968644"></a><h3>
1197
1330
<a name="libhal-ctx-set-device-property-modified"></a>libhal_ctx_set_device_property_modified ()</h3>
1198
 
<a class="indexterm" name="id2655281"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_property_modified
1199
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1200
 
                                                         <a href="libhal-libhal.html#LibHalDevicePropertyModified">LibHalDevicePropertyModified</a> callback);</pre>
 
1331
<a class="indexterm" name="id2968659"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_property_modified
 
1332
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1333
                                                         <a class="link" href="libhal-libhal.html#LibHalDevicePropertyModified">LibHalDevicePropertyModified</a> callback);</pre>
1201
1334
<p>
1202
1335
Set the callback for when a property is modified on a device.</p>
1203
1336
<p>
1207
1340
<col align="left" valign="top">
1208
1341
<tbody>
1209
1342
<tr>
1210
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1343
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1211
1344
<td> the context for the connection to hald
1212
1345
</td>
1213
1346
</tr>
1214
1347
<tr>
1215
 
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
1348
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
1216
1349
<td> the function to call when a property is modified on a device
1217
1350
</td>
1218
1351
</tr>
1219
1352
<tr>
1220
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1353
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1221
1354
<td> TRUE if callback was successfully set, FALSE otherwise
1222
1355
</td>
1223
1356
</tr>
1226
1359
</div>
1227
1360
<hr>
1228
1361
<div class="refsect2" lang="en">
1229
 
<a name="id2655368"></a><h3>
 
1362
<a name="id2968746"></a><h3>
1230
1363
<a name="libhal-ctx-set-device-condition"></a>libhal_ctx_set_device_condition ()</h3>
1231
 
<a class="indexterm" name="id2655382"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_condition     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1232
 
                                                         <a href="libhal-libhal.html#LibHalDeviceCondition">LibHalDeviceCondition</a> callback);</pre>
 
1364
<a class="indexterm" name="id2968760"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_device_condition     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1365
                                                         <a class="link" href="libhal-libhal.html#LibHalDeviceCondition">LibHalDeviceCondition</a> callback);</pre>
1233
1366
<p>
1234
1367
Set the callback for when a device emits a condition</p>
1235
1368
<p>
1239
1372
<col align="left" valign="top">
1240
1373
<tbody>
1241
1374
<tr>
1242
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1375
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1243
1376
<td> the context for the connection to hald
1244
1377
</td>
1245
1378
</tr>
1246
1379
<tr>
1247
 
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
1380
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
1248
1381
<td> the function to call when a device emits a condition
1249
1382
</td>
1250
1383
</tr>
1251
1384
<tr>
1252
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1385
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1253
1386
<td> TRUE if callback was successfully set, FALSE otherwise
1254
1387
</td>
1255
1388
</tr>
1258
1391
</div>
1259
1392
<hr>
1260
1393
<div class="refsect2" lang="en">
1261
 
<a name="id2655468"></a><h3>
 
1394
<a name="id2968845"></a><h3>
1262
1395
<a name="libhal-ctx-set-global-interface-lock-acquired"></a>libhal_ctx_set_global_interface_lock_acquired ()</h3>
1263
 
<a class="indexterm" name="id2655482"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_global_interface_lock_acquired
1264
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1265
 
                                                         <a href="libhal-libhal.html#LibHalGlobalInterfaceLockAcquired">LibHalGlobalInterfaceLockAcquired</a> callback);</pre>
 
1396
<a class="indexterm" name="id2968860"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_global_interface_lock_acquired
 
1397
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1398
                                                         <a class="link" href="libhal-libhal.html#LibHalGlobalInterfaceLockAcquired">LibHalGlobalInterfaceLockAcquired</a> callback);</pre>
1266
1399
<p>
1267
1400
Set the callback for when a global interface lock is acquired.</p>
1268
1401
<p>
1272
1405
<col align="left" valign="top">
1273
1406
<tbody>
1274
1407
<tr>
1275
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1408
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1276
1409
<td> the context for the connection to hald
1277
1410
</td>
1278
1411
</tr>
1279
1412
<tr>
1280
 
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
1413
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
1281
1414
<td> the callback
1282
1415
</td>
1283
1416
</tr>
1284
1417
<tr>
1285
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1418
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1286
1419
<td> TRUE if callback was successfully set, FALSE otherwise
1287
1420
</td>
1288
1421
</tr>
1291
1424
</div>
1292
1425
<hr>
1293
1426
<div class="refsect2" lang="en">
1294
 
<a name="id2655569"></a><h3>
 
1427
<a name="id2968946"></a><h3>
1295
1428
<a name="libhal-ctx-set-global-interface-lock-released"></a>libhal_ctx_set_global_interface_lock_released ()</h3>
1296
 
<a class="indexterm" name="id2655584"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_global_interface_lock_released
1297
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1298
 
                                                         <a href="libhal-libhal.html#LibHalGlobalInterfaceLockReleased">LibHalGlobalInterfaceLockReleased</a> callback);</pre>
 
1429
<a class="indexterm" name="id2968961"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_global_interface_lock_released
 
1430
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1431
                                                         <a class="link" href="libhal-libhal.html#LibHalGlobalInterfaceLockReleased">LibHalGlobalInterfaceLockReleased</a> callback);</pre>
1299
1432
<p>
1300
1433
Set the callback for when a global interface lock is released.</p>
1301
1434
<p>
1305
1438
<col align="left" valign="top">
1306
1439
<tbody>
1307
1440
<tr>
1308
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1441
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1309
1442
<td> the context for the connection to hald
1310
1443
</td>
1311
1444
</tr>
1312
1445
<tr>
1313
 
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
1446
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
1314
1447
<td> the callback
1315
1448
</td>
1316
1449
</tr>
1317
1450
<tr>
1318
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1451
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1319
1452
<td> TRUE if callback was successfully set, FALSE otherwise
1320
1453
</td>
1321
1454
</tr>
1324
1457
</div>
1325
1458
<hr>
1326
1459
<div class="refsect2" lang="en">
1327
 
<a name="id2655670"></a><h3>
 
1460
<a name="id2969048"></a><h3>
1328
1461
<a name="libhal-ctx-set-interface-lock-acquired"></a>libhal_ctx_set_interface_lock_acquired ()</h3>
1329
 
<a class="indexterm" name="id2655684"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_interface_lock_acquired
1330
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1331
 
                                                         <a href="libhal-libhal.html#LibHalInterfaceLockAcquired">LibHalInterfaceLockAcquired</a> callback);</pre>
 
1462
<a class="indexterm" name="id2969062"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_interface_lock_acquired
 
1463
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1464
                                                         <a class="link" href="libhal-libhal.html#LibHalInterfaceLockAcquired">LibHalInterfaceLockAcquired</a> callback);</pre>
1332
1465
<p>
1333
1466
Set the callback for when an interface lock is acquired.</p>
1334
1467
<p>
1338
1471
<col align="left" valign="top">
1339
1472
<tbody>
1340
1473
<tr>
1341
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1474
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1342
1475
<td> the context for the connection to hald
1343
1476
</td>
1344
1477
</tr>
1345
1478
<tr>
1346
 
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
1479
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
1347
1480
<td> the callback
1348
1481
</td>
1349
1482
</tr>
1350
1483
<tr>
1351
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1484
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1352
1485
<td> TRUE if callback was successfully set, FALSE otherwise
1353
1486
</td>
1354
1487
</tr>
1357
1490
</div>
1358
1491
<hr>
1359
1492
<div class="refsect2" lang="en">
1360
 
<a name="id2655770"></a><h3>
 
1493
<a name="id2969148"></a><h3>
1361
1494
<a name="libhal-ctx-set-interface-lock-released"></a>libhal_ctx_set_interface_lock_released ()</h3>
1362
 
<a class="indexterm" name="id2655784"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_interface_lock_released
1363
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1364
 
                                                         <a href="libhal-libhal.html#LibHalInterfaceLockReleased">LibHalInterfaceLockReleased</a> callback);</pre>
 
1495
<a class="indexterm" name="id2969162"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_interface_lock_released
 
1496
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1497
                                                         <a class="link" href="libhal-libhal.html#LibHalInterfaceLockReleased">LibHalInterfaceLockReleased</a> callback);</pre>
1365
1498
<p>
1366
1499
Set the callback for when an interface lock is released.</p>
1367
1500
<p>
1371
1504
<col align="left" valign="top">
1372
1505
<tbody>
1373
1506
<tr>
1374
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1507
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1375
1508
<td> the context for the connection to hald
1376
1509
</td>
1377
1510
</tr>
1378
1511
<tr>
1379
 
<td><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></td>
 
1512
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
1380
1513
<td> the callback
1381
1514
</td>
1382
1515
</tr>
1383
1516
<tr>
1384
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
1385
 
<td> TRUE if callback was successfully set, FALSE otherwise
1386
 
</td>
1387
 
</tr>
1388
 
</tbody>
1389
 
</table></div>
1390
 
</div>
1391
 
<hr>
1392
 
<div class="refsect2" lang="en">
1393
 
<a name="id2655870"></a><h3>
 
1517
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1518
<td> TRUE if callback was successfully set, FALSE otherwise
 
1519
</td>
 
1520
</tr>
 
1521
</tbody>
 
1522
</table></div>
 
1523
</div>
 
1524
<hr>
 
1525
<div class="refsect2" lang="en">
 
1526
<a name="id2969248"></a><h3>
 
1527
<a name="libhal-ctx-set-singleton-device-added"></a>libhal_ctx_set_singleton_device_added ()</h3>
 
1528
<a class="indexterm" name="id2969262"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_singleton_device_added
 
1529
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1530
                                                         <a class="link" href="libhal-libhal.html#LibHalSingletonDeviceAdded">LibHalSingletonDeviceAdded</a> callback);</pre>
 
1531
<p>
 
1532
Set the callback for when a singleton should handle a new device</p>
 
1533
<p>
 
1534
 
 
1535
</p>
 
1536
<div class="variablelist"><table border="0">
 
1537
<col align="left" valign="top">
 
1538
<tbody>
 
1539
<tr>
 
1540
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
 
1541
<td> the context for the connection to hald
 
1542
</td>
 
1543
</tr>
 
1544
<tr>
 
1545
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
 
1546
<td> the function to call when a device emits a condition
 
1547
</td>
 
1548
</tr>
 
1549
<tr>
 
1550
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1551
<td> TRUE if callback was successfully set, FALSE otherwise
 
1552
</td>
 
1553
</tr>
 
1554
</tbody>
 
1555
</table></div>
 
1556
</div>
 
1557
<hr>
 
1558
<div class="refsect2" lang="en">
 
1559
<a name="id2969349"></a><h3>
 
1560
<a name="libhal-ctx-set-singleton-device-removed"></a>libhal_ctx_set_singleton_device_removed ()</h3>
 
1561
<a class="indexterm" name="id2969363"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_set_singleton_device_removed
 
1562
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1563
                                                         <a class="link" href="libhal-libhal.html#LibHalSingletonDeviceRemoved">LibHalSingletonDeviceRemoved</a> callback);</pre>
 
1564
<p>
 
1565
Set the callback for when a singleton should discard a device</p>
 
1566
<p>
 
1567
 
 
1568
</p>
 
1569
<div class="variablelist"><table border="0">
 
1570
<col align="left" valign="top">
 
1571
<tbody>
 
1572
<tr>
 
1573
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
 
1574
<td> the context for the connection to hald
 
1575
</td>
 
1576
</tr>
 
1577
<tr>
 
1578
<td><p><span class="term"><em class="parameter"><code>callback</code></em>&#160;:</span></p></td>
 
1579
<td> the function to call when a device emits a condition
 
1580
</td>
 
1581
</tr>
 
1582
<tr>
 
1583
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
1584
<td> TRUE if callback was successfully set, FALSE otherwise
 
1585
</td>
 
1586
</tr>
 
1587
</tbody>
 
1588
</table></div>
 
1589
</div>
 
1590
<hr>
 
1591
<div class="refsect2" lang="en">
 
1592
<a name="id2969450"></a><h3>
1394
1593
<a name="libhal-ctx-init"></a>libhal_ctx_init ()</h3>
1395
 
<a class="indexterm" name="id2655884"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_init                     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1594
<a class="indexterm" name="id2969463"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_init                     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1396
1595
                                                         DBusError *error);</pre>
1397
1596
<p>
1398
1597
Initialize the connection to hald.</p>
1403
1602
<col align="left" valign="top">
1404
1603
<tbody>
1405
1604
<tr>
1406
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1605
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1407
1606
<td> Context for connection to hald (D-BUS connection should be set with libhal_ctx_set_dbus_connection)
1408
1607
</td>
1409
1608
</tr>
1410
1609
<tr>
1411
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
1610
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1412
1611
<td> pointer to an initialized dbus error object for returning errors or NULL
1413
1612
</td>
1414
1613
</tr>
1415
1614
<tr>
1416
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1615
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1417
1616
<td> TRUE if initialization succeeds, FALSE otherwise
1418
1617
</td>
1419
1618
</tr>
1422
1621
</div>
1423
1622
<hr>
1424
1623
<div class="refsect2" lang="en">
1425
 
<a name="id2655970"></a><h3>
 
1624
<a name="id2969549"></a><h3>
1426
1625
<a name="libhal-ctx-shutdown"></a>libhal_ctx_shutdown ()</h3>
1427
 
<a class="indexterm" name="id2655984"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_shutdown                 (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1626
<a class="indexterm" name="id2969563"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_shutdown                 (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1428
1627
                                                         DBusError *error);</pre>
1429
1628
<p>
1430
1629
Shut down a connection to hald.</p>
1435
1634
<col align="left" valign="top">
1436
1635
<tbody>
1437
1636
<tr>
1438
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1637
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1439
1638
<td> the context for the connection to hald
1440
1639
</td>
1441
1640
</tr>
1442
1641
<tr>
1443
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
1642
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1444
1643
<td> pointer to an initialized dbus error object for returning errors or NULL
1445
1644
</td>
1446
1645
</tr>
1447
1646
<tr>
1448
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1647
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1449
1648
<td> TRUE if connection successfully shut down, FALSE otherwise
1450
1649
</td>
1451
1650
</tr>
1454
1653
</div>
1455
1654
<hr>
1456
1655
<div class="refsect2" lang="en">
1457
 
<a name="id2656068"></a><h3>
 
1656
<a name="id2969647"></a><h3>
1458
1657
<a name="libhal-ctx-free"></a>libhal_ctx_free ()</h3>
1459
 
<a class="indexterm" name="id2656081"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_free                     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);</pre>
 
1658
<a class="indexterm" name="id2969660"></a><pre class="programlisting">dbus_bool_t         libhal_ctx_free                     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx);</pre>
1460
1659
<p>
1461
1660
Free a LibHalContext resource.</p>
1462
1661
<p>
1466
1665
<col align="left" valign="top">
1467
1666
<tbody>
1468
1667
<tr>
1469
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1668
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1470
1669
<td> pointer to a LibHalContext
1471
1670
</td>
1472
1671
</tr>
1473
1672
<tr>
1474
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1673
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1475
1674
<td> TRUE
1476
1675
</td>
1477
1676
</tr>
1480
1679
</div>
1481
1680
<hr>
1482
1681
<div class="refsect2" lang="en">
1483
 
<a name="id2656142"></a><h3>
 
1682
<a name="id2969722"></a><h3>
1484
1683
<a name="libhal-ctx-init-direct"></a>libhal_ctx_init_direct ()</h3>
1485
 
<a class="indexterm" name="id2656156"></a><pre class="programlisting"><a href="libhal-libhal.html#LibHalContext">LibHalContext</a>*      libhal_ctx_init_direct              (DBusError *error);</pre>
 
1684
<a class="indexterm" name="id2969735"></a><pre class="programlisting"><a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a>*      libhal_ctx_init_direct              (DBusError *error);</pre>
1486
1685
<p>
1487
1686
Create an already initialized connection to hald. This function should only be used by HAL helpers.</p>
1488
1687
<p>
1492
1691
<col align="left" valign="top">
1493
1692
<tbody>
1494
1693
<tr>
1495
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
1694
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1496
1695
<td> pointer to an initialized dbus error object for returning errors or NULL
1497
1696
</td>
1498
1697
</tr>
1499
1698
<tr>
1500
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1699
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1501
1700
<td> A pointer to an already initialized LibHalContext
1502
1701
</td>
1503
1702
</tr>
1506
1705
</div>
1507
1706
<hr>
1508
1707
<div class="refsect2" lang="en">
1509
 
<a name="id2656220"></a><h3>
 
1708
<a name="id2969799"></a><h3>
1510
1709
<a name="libhal-get-all-devices"></a>libhal_get_all_devices ()</h3>
1511
 
<a class="indexterm" name="id2656233"></a><pre class="programlisting">char**              libhal_get_all_devices              (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1710
<a class="indexterm" name="id2969813"></a><pre class="programlisting">char**              libhal_get_all_devices              (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1512
1711
                                                         int *num_devices,
1513
1712
                                                         DBusError *error);</pre>
1514
1713
<p>
1520
1719
<col align="left" valign="top">
1521
1720
<tbody>
1522
1721
<tr>
1523
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1722
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1524
1723
<td> the context for the connection to hald
1525
1724
</td>
1526
1725
</tr>
1527
1726
<tr>
1528
 
<td><span class="term"><em class="parameter"><code>num_devices</code></em>&#160;:</span></td>
 
1727
<td><p><span class="term"><em class="parameter"><code>num_devices</code></em>&#160;:</span></p></td>
1529
1728
<td> the number of devices will be stored here
1530
1729
</td>
1531
1730
</tr>
1532
1731
<tr>
1533
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
1732
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1534
1733
<td> pointer to an initialized dbus error object for returning errors or NULL
1535
1734
</td>
1536
1735
</tr>
1537
1736
<tr>
1538
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1737
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1539
1738
<td> An array of device identifiers terminated with NULL. It is
1540
1739
the responsibility of the caller to free with
1541
 
<a href="libhal-libhal.html#libhal-free-string-array"><code class="function">libhal_free_string_array()</code></a>. If an error occurs NULL is returned.
 
1740
<a class="link" href="libhal-libhal.html#libhal-free-string-array"><code class="function">libhal_free_string_array()</code></a>. If an error occurs NULL is returned.
1542
1741
</td>
1543
1742
</tr>
1544
1743
</tbody>
1546
1745
</div>
1547
1746
<hr>
1548
1747
<div class="refsect2" lang="en">
1549
 
<a name="id2656351"></a><h3>
 
1748
<a name="id2969931"></a><h3>
1550
1749
<a name="libhal-device-exists"></a>libhal_device_exists ()</h3>
1551
 
<a class="indexterm" name="id2656365"></a><pre class="programlisting">dbus_bool_t         libhal_device_exists                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1750
<a class="indexterm" name="id2969945"></a><pre class="programlisting">dbus_bool_t         libhal_device_exists                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1552
1751
                                                         const char *udi,
1553
1752
                                                         DBusError *error);</pre>
1554
1753
<p>
1560
1759
<col align="left" valign="top">
1561
1760
<tbody>
1562
1761
<tr>
1563
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1762
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1564
1763
<td> the context for the connection to hald
1565
1764
</td>
1566
1765
</tr>
1567
1766
<tr>
1568
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
1767
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
1569
1768
<td> the Unique device id.
1570
1769
</td>
1571
1770
</tr>
1572
1771
<tr>
1573
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
1772
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1574
1773
<td> pointer to an initialized dbus error object for returning errors or NULL
1575
1774
</td>
1576
1775
</tr>
1577
1776
<tr>
1578
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1777
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1579
1778
<td> TRUE if the device exists
1580
1779
</td>
1581
1780
</tr>
1584
1783
</div>
1585
1784
<hr>
1586
1785
<div class="refsect2" lang="en">
1587
 
<a name="id2656471"></a><h3>
 
1786
<a name="id2970051"></a><h3>
1588
1787
<a name="libhal-device-print"></a>libhal_device_print ()</h3>
1589
 
<a class="indexterm" name="id2656485"></a><pre class="programlisting">dbus_bool_t         libhal_device_print                 (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1788
<a class="indexterm" name="id2970064"></a><pre class="programlisting">dbus_bool_t         libhal_device_print                 (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1590
1789
                                                         const char *udi,
1591
1790
                                                         DBusError *error);</pre>
1592
1791
<p>
1598
1797
<col align="left" valign="top">
1599
1798
<tbody>
1600
1799
<tr>
1601
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1800
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1602
1801
<td> the context for the connection to hald
1603
1802
</td>
1604
1803
</tr>
1605
1804
<tr>
1606
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
1805
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
1607
1806
<td> the Unique Device Id
1608
1807
</td>
1609
1808
</tr>
1610
1809
<tr>
1611
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
1810
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1612
1811
<td> pointer to an initialized dbus error object for returning errors or NULL
1613
1812
</td>
1614
1813
</tr>
1615
1814
<tr>
1616
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1815
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1617
1816
<td> TRUE if device's information could be obtained, FALSE otherwise
1618
1817
</td>
1619
1818
</tr>
1622
1821
</div>
1623
1822
<hr>
1624
1823
<div class="refsect2" lang="en">
1625
 
<a name="id2656591"></a><h3>
 
1824
<a name="id2970170"></a><h3>
1626
1825
<a name="libhal-device-property-exists"></a>libhal_device_property_exists ()</h3>
1627
 
<a class="indexterm" name="id2656605"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_exists       (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1826
<a class="indexterm" name="id2970184"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_exists       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1628
1827
                                                         const char *udi,
1629
1828
                                                         const char *key,
1630
1829
                                                         DBusError *error);</pre>
1637
1836
<col align="left" valign="top">
1638
1837
<tbody>
1639
1838
<tr>
1640
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1839
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1641
1840
<td> the context for the connection to hald
1642
1841
</td>
1643
1842
</tr>
1644
1843
<tr>
1645
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
1844
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
1646
1845
<td> the Unique device id.
1647
1846
</td>
1648
1847
</tr>
1649
1848
<tr>
1650
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
1849
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
1651
1850
<td> name of the property
1652
1851
</td>
1653
1852
</tr>
1654
1853
<tr>
1655
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
1854
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1656
1855
<td> pointer to an initialized dbus error object for returning errors or NULL
1657
1856
</td>
1658
1857
</tr>
1659
1858
<tr>
1660
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1859
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1661
1860
<td> TRUE if the device exists, FALSE otherwise
1662
1861
</td>
1663
1862
</tr>
1666
1865
</div>
1667
1866
<hr>
1668
1867
<div class="refsect2" lang="en">
1669
 
<a name="id2656733"></a><h3>
 
1868
<a name="id2970312"></a><h3>
1670
1869
<a name="libhal-device-get-property-string"></a>libhal_device_get_property_string ()</h3>
1671
 
<a class="indexterm" name="id2656747"></a><pre class="programlisting">char*               libhal_device_get_property_string   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1870
<a class="indexterm" name="id2970327"></a><pre class="programlisting">char*               libhal_device_get_property_string   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1672
1871
                                                         const char *udi,
1673
1872
                                                         const char *key,
1674
1873
                                                         DBusError *error);</pre>
1681
1880
<col align="left" valign="top">
1682
1881
<tbody>
1683
1882
<tr>
1684
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1883
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1685
1884
<td> the context for the connection to hald
1686
1885
</td>
1687
1886
</tr>
1688
1887
<tr>
1689
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
1888
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
1690
1889
<td> the Unique Device Id
1691
1890
</td>
1692
1891
</tr>
1693
1892
<tr>
1694
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
1893
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
1695
1894
<td> the name of the property
1696
1895
</td>
1697
1896
</tr>
1698
1897
<tr>
1699
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
1898
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1700
1899
<td> pointer to an initialized dbus error object for returning errors or NULL
1701
1900
</td>
1702
1901
</tr>
1703
1902
<tr>
1704
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1903
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1705
1904
<td> UTF8 nul-terminated string. The caller is responsible for
1706
 
freeing this string with the function <a href="libhal-libhal.html#libhal-free-string"><code class="function">libhal_free_string()</code></a>. Returns
 
1905
freeing this string with the function <a class="link" href="libhal-libhal.html#libhal-free-string"><code class="function">libhal_free_string()</code></a>. Returns
1707
1906
NULL if the property didn't exist or we are OOM.
1708
1907
</td>
1709
1908
</tr>
1712
1911
</div>
1713
1912
<hr>
1714
1913
<div class="refsect2" lang="en">
1715
 
<a name="id2656886"></a><h3>
 
1914
<a name="id2970466"></a><h3>
1716
1915
<a name="libhal-device-get-property-int"></a>libhal_device_get_property_int ()</h3>
1717
 
<a class="indexterm" name="id2656900"></a><pre class="programlisting">dbus_int32_t        libhal_device_get_property_int      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1916
<a class="indexterm" name="id2970480"></a><pre class="programlisting">dbus_int32_t        libhal_device_get_property_int      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1718
1917
                                                         const char *udi,
1719
1918
                                                         const char *key,
1720
1919
                                                         DBusError *error);</pre>
1727
1926
<col align="left" valign="top">
1728
1927
<tbody>
1729
1928
<tr>
1730
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1929
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1731
1930
<td> the context for the connection to hald
1732
1931
</td>
1733
1932
</tr>
1734
1933
<tr>
1735
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
1934
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
1736
1935
<td> the Unique Device Id
1737
1936
</td>
1738
1937
</tr>
1739
1938
<tr>
1740
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
1939
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
1741
1940
<td> name of the property
1742
1941
</td>
1743
1942
</tr>
1744
1943
<tr>
1745
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
1944
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1746
1945
<td> pointer to an initialized dbus error object for returning errors or NULL
1747
1946
</td>
1748
1947
</tr>
1749
1948
<tr>
1750
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1949
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1751
1950
<td> Property value (32-bit signed integer)
1752
1951
</td>
1753
1952
</tr>
1756
1955
</div>
1757
1956
<hr>
1758
1957
<div class="refsect2" lang="en">
1759
 
<a name="id2657029"></a><h3>
 
1958
<a name="id2970608"></a><h3>
1760
1959
<a name="libhal-device-get-property-uint64"></a>libhal_device_get_property_uint64 ()</h3>
1761
 
<a class="indexterm" name="id2657043"></a><pre class="programlisting">dbus_uint64_t       libhal_device_get_property_uint64   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
1960
<a class="indexterm" name="id2970623"></a><pre class="programlisting">dbus_uint64_t       libhal_device_get_property_uint64   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1762
1961
                                                         const char *udi,
1763
1962
                                                         const char *key,
1764
1963
                                                         DBusError *error);</pre>
1771
1970
<col align="left" valign="top">
1772
1971
<tbody>
1773
1972
<tr>
1774
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
1973
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1775
1974
<td> the context for the connection to hald
1776
1975
</td>
1777
1976
</tr>
1778
1977
<tr>
1779
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
1978
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
1780
1979
<td> the Unique Device Id
1781
1980
</td>
1782
1981
</tr>
1783
1982
<tr>
1784
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
1983
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
1785
1984
<td> name of the property
1786
1985
</td>
1787
1986
</tr>
1788
1987
<tr>
1789
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
1988
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1790
1989
<td> pointer to an initialized dbus error object for returning errors or NULL
1791
1990
</td>
1792
1991
</tr>
1793
1992
<tr>
1794
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
1993
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1795
1994
<td> Property value (64-bit unsigned integer)
1796
1995
</td>
1797
1996
</tr>
1800
1999
</div>
1801
2000
<hr>
1802
2001
<div class="refsect2" lang="en">
1803
 
<a name="id2657171"></a><h3>
 
2002
<a name="id2970750"></a><h3>
1804
2003
<a name="libhal-device-get-property-double"></a>libhal_device_get_property_double ()</h3>
1805
 
<a class="indexterm" name="id2657186"></a><pre class="programlisting">double              libhal_device_get_property_double   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2004
<a class="indexterm" name="id2970766"></a><pre class="programlisting">double              libhal_device_get_property_double   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1806
2005
                                                         const char *udi,
1807
2006
                                                         const char *key,
1808
2007
                                                         DBusError *error);</pre>
1815
2014
<col align="left" valign="top">
1816
2015
<tbody>
1817
2016
<tr>
1818
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2017
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1819
2018
<td> the context for the connection to hald
1820
2019
</td>
1821
2020
</tr>
1822
2021
<tr>
1823
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2022
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
1824
2023
<td> the Unique Device Id
1825
2024
</td>
1826
2025
</tr>
1827
2026
<tr>
1828
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2027
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
1829
2028
<td> name of the property
1830
2029
</td>
1831
2030
</tr>
1832
2031
<tr>
1833
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2032
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1834
2033
<td> pointer to an initialized dbus error object for returning errors or NULL
1835
2034
</td>
1836
2035
</tr>
1837
2036
<tr>
1838
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2037
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1839
2038
<td> Property value (IEEE754 double precision float)
1840
2039
</td>
1841
2040
</tr>
1844
2043
</div>
1845
2044
<hr>
1846
2045
<div class="refsect2" lang="en">
1847
 
<a name="id2657314"></a><h3>
 
2046
<a name="id2970893"></a><h3>
1848
2047
<a name="libhal-device-get-property-bool"></a>libhal_device_get_property_bool ()</h3>
1849
 
<a class="indexterm" name="id2657328"></a><pre class="programlisting">dbus_bool_t         libhal_device_get_property_bool     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2048
<a class="indexterm" name="id2970907"></a><pre class="programlisting">dbus_bool_t         libhal_device_get_property_bool     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1850
2049
                                                         const char *udi,
1851
2050
                                                         const char *key,
1852
2051
                                                         DBusError *error);</pre>
1859
2058
<col align="left" valign="top">
1860
2059
<tbody>
1861
2060
<tr>
1862
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2061
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1863
2062
<td> the context for the connection to hald
1864
2063
</td>
1865
2064
</tr>
1866
2065
<tr>
1867
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2066
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
1868
2067
<td> the Unique Device Id
1869
2068
</td>
1870
2069
</tr>
1871
2070
<tr>
1872
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2071
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
1873
2072
<td> name of the property
1874
2073
</td>
1875
2074
</tr>
1876
2075
<tr>
1877
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2076
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1878
2077
<td> pointer to an initialized dbus error object for returning errors or NULL
1879
2078
</td>
1880
2079
</tr>
1881
2080
<tr>
1882
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2081
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1883
2082
<td> Property value (boolean)
1884
2083
</td>
1885
2084
</tr>
1888
2087
</div>
1889
2088
<hr>
1890
2089
<div class="refsect2" lang="en">
1891
 
<a name="id2657456"></a><h3>
 
2090
<a name="id2971035"></a><h3>
1892
2091
<a name="libhal-device-get-property-strlist"></a>libhal_device_get_property_strlist ()</h3>
1893
 
<a class="indexterm" name="id2657471"></a><pre class="programlisting">char**              libhal_device_get_property_strlist  (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2092
<a class="indexterm" name="id2971050"></a><pre class="programlisting">char**              libhal_device_get_property_strlist  (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1894
2093
                                                         const char *udi,
1895
2094
                                                         const char *key,
1896
2095
                                                         DBusError *error);</pre>
1903
2102
<col align="left" valign="top">
1904
2103
<tbody>
1905
2104
<tr>
1906
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2105
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1907
2106
<td> the context for the connection to hald
1908
2107
</td>
1909
2108
</tr>
1910
2109
<tr>
1911
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2110
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
1912
2111
<td> unique Device Id
1913
2112
</td>
1914
2113
</tr>
1915
2114
<tr>
1916
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2115
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
1917
2116
<td> name of the property
1918
2117
</td>
1919
2118
</tr>
1920
2119
<tr>
1921
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2120
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1922
2121
<td> pointer to an initialized dbus error object for returning errors or NULL
1923
2122
</td>
1924
2123
</tr>
1925
2124
<tr>
1926
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2125
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1927
2126
<td> Array of pointers to UTF8 nul-terminated strings
1928
2127
terminated by NULL. The caller is responsible for freeing this
1929
 
string array with the function <a href="libhal-libhal.html#libhal-free-string-array"><code class="function">libhal_free_string_array()</code></a>. Returns
 
2128
string array with the function <a class="link" href="libhal-libhal.html#libhal-free-string-array"><code class="function">libhal_free_string_array()</code></a>. Returns
1930
2129
NULL if the property didn't exist or we are OOM
1931
2130
</td>
1932
2131
</tr>
1935
2134
</div>
1936
2135
<hr>
1937
2136
<div class="refsect2" lang="en">
1938
 
<a name="id2657611"></a><h3>
 
2137
<a name="id2971190"></a><h3>
1939
2138
<a name="libhal-device-set-property-string"></a>libhal_device_set_property_string ()</h3>
1940
 
<a class="indexterm" name="id2657626"></a><pre class="programlisting">dbus_bool_t         libhal_device_set_property_string   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2139
<a class="indexterm" name="id2971205"></a><pre class="programlisting">dbus_bool_t         libhal_device_set_property_string   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1941
2140
                                                         const char *udi,
1942
2141
                                                         const char *key,
1943
2142
                                                         const char *value,
1951
2150
<col align="left" valign="top">
1952
2151
<tbody>
1953
2152
<tr>
1954
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2153
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
1955
2154
<td> the context for the connection to hald
1956
2155
</td>
1957
2156
</tr>
1958
2157
<tr>
1959
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2158
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
1960
2159
<td> the Unique Device Id
1961
2160
</td>
1962
2161
</tr>
1963
2162
<tr>
1964
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2163
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
1965
2164
<td> name of the property
1966
2165
</td>
1967
2166
</tr>
1968
2167
<tr>
1969
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2168
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
1970
2169
<td> value of the property; a UTF8 string
1971
2170
</td>
1972
2171
</tr>
1973
2172
<tr>
1974
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2173
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
1975
2174
<td> pointer to an initialized dbus error object for returning errors or NULL
1976
2175
</td>
1977
2176
</tr>
1978
2177
<tr>
1979
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2178
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
1980
2179
<td> TRUE if the property was set, FALSE if the device didn't
1981
2180
exist or the property had a different type.
1982
2181
</td>
1986
2185
</div>
1987
2186
<hr>
1988
2187
<div class="refsect2" lang="en">
1989
 
<a name="id2657776"></a><h3>
 
2188
<a name="id2971355"></a><h3>
1990
2189
<a name="libhal-device-set-property-int"></a>libhal_device_set_property_int ()</h3>
1991
 
<a class="indexterm" name="id2657790"></a><pre class="programlisting">dbus_bool_t         libhal_device_set_property_int      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2190
<a class="indexterm" name="id2971369"></a><pre class="programlisting">dbus_bool_t         libhal_device_set_property_int      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
1992
2191
                                                         const char *udi,
1993
2192
                                                         const char *key,
1994
2193
                                                         dbus_int32_t value,
2002
2201
<col align="left" valign="top">
2003
2202
<tbody>
2004
2203
<tr>
2005
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2204
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2006
2205
<td> the context for the connection to hald
2007
2206
</td>
2008
2207
</tr>
2009
2208
<tr>
2010
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2209
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2011
2210
<td> the Unique Device Id
2012
2211
</td>
2013
2212
</tr>
2014
2213
<tr>
2015
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2214
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2016
2215
<td> name of the property
2017
2216
</td>
2018
2217
</tr>
2019
2218
<tr>
2020
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2219
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2021
2220
<td> value of the property
2022
2221
</td>
2023
2222
</tr>
2024
2223
<tr>
2025
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2224
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2026
2225
<td> pointer to an initialized dbus error object for returning errors or NULL
2027
2226
</td>
2028
2227
</tr>
2029
2228
<tr>
2030
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2229
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2031
2230
<td> TRUE if the property was set, FALSE if the device didn't
2032
2231
exist or the property had a different type.
2033
2232
</td>
2037
2236
</div>
2038
2237
<hr>
2039
2238
<div class="refsect2" lang="en">
2040
 
<a name="id2657940"></a><h3>
 
2239
<a name="id2971520"></a><h3>
2041
2240
<a name="libhal-device-set-property-uint64"></a>libhal_device_set_property_uint64 ()</h3>
2042
 
<a class="indexterm" name="id2657955"></a><pre class="programlisting">dbus_bool_t         libhal_device_set_property_uint64   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2241
<a class="indexterm" name="id2971534"></a><pre class="programlisting">dbus_bool_t         libhal_device_set_property_uint64   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
2043
2242
                                                         const char *udi,
2044
2243
                                                         const char *key,
2045
2244
                                                         dbus_uint64_t value,
2053
2252
<col align="left" valign="top">
2054
2253
<tbody>
2055
2254
<tr>
2056
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2255
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2057
2256
<td> the context for the connection to hald
2058
2257
</td>
2059
2258
</tr>
2060
2259
<tr>
2061
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2260
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2062
2261
<td> the Unique Device Id
2063
2262
</td>
2064
2263
</tr>
2065
2264
<tr>
2066
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2265
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2067
2266
<td> name of the property
2068
2267
</td>
2069
2268
</tr>
2070
2269
<tr>
2071
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2270
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2072
2271
<td> value of the property
2073
2272
</td>
2074
2273
</tr>
2075
2274
<tr>
2076
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2275
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2077
2276
<td> pointer to an initialized dbus error object for returning errors or NULL
2078
2277
</td>
2079
2278
</tr>
2080
2279
<tr>
2081
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2280
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2082
2281
<td> TRUE if the property was set, FALSE if the device didn't
2083
2282
exist or the property had a different type.
2084
2283
</td>
2088
2287
</div>
2089
2288
<hr>
2090
2289
<div class="refsect2" lang="en">
2091
 
<a name="id2658105"></a><h3>
 
2290
<a name="id2971684"></a><h3>
2092
2291
<a name="libhal-device-set-property-double"></a>libhal_device_set_property_double ()</h3>
2093
 
<a class="indexterm" name="id2658120"></a><pre class="programlisting">dbus_bool_t         libhal_device_set_property_double   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2292
<a class="indexterm" name="id2971699"></a><pre class="programlisting">dbus_bool_t         libhal_device_set_property_double   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
2094
2293
                                                         const char *udi,
2095
2294
                                                         const char *key,
2096
2295
                                                         double value,
2104
2303
<col align="left" valign="top">
2105
2304
<tbody>
2106
2305
<tr>
2107
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2306
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2108
2307
<td> the context for the connection to hald
2109
2308
</td>
2110
2309
</tr>
2111
2310
<tr>
2112
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2311
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2113
2312
<td> the Unique Device Id
2114
2313
</td>
2115
2314
</tr>
2116
2315
<tr>
2117
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2316
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2118
2317
<td> name of the property
2119
2318
</td>
2120
2319
</tr>
2121
2320
<tr>
2122
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2321
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2123
2322
<td> value of the property
2124
2323
</td>
2125
2324
</tr>
2126
2325
<tr>
2127
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2326
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2128
2327
<td> pointer to an initialized dbus error object for returning errors or NULL
2129
2328
</td>
2130
2329
</tr>
2131
2330
<tr>
2132
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2331
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2133
2332
<td> TRUE if the property was set, FALSE if the device didn't
2134
2333
exist or the property had a different type.
2135
2334
</td>
2139
2338
</div>
2140
2339
<hr>
2141
2340
<div class="refsect2" lang="en">
2142
 
<a name="id2658269"></a><h3>
 
2341
<a name="id2971849"></a><h3>
2143
2342
<a name="libhal-device-set-property-bool"></a>libhal_device_set_property_bool ()</h3>
2144
 
<a class="indexterm" name="id2658284"></a><pre class="programlisting">dbus_bool_t         libhal_device_set_property_bool     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2343
<a class="indexterm" name="id2971863"></a><pre class="programlisting">dbus_bool_t         libhal_device_set_property_bool     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
2145
2344
                                                         const char *udi,
2146
2345
                                                         const char *key,
2147
2346
                                                         dbus_bool_t value,
2155
2354
<col align="left" valign="top">
2156
2355
<tbody>
2157
2356
<tr>
2158
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2357
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2159
2358
<td> the context for the connection to hald
2160
2359
</td>
2161
2360
</tr>
2162
2361
<tr>
2163
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2362
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2164
2363
<td> the Unique Device Id
2165
2364
</td>
2166
2365
</tr>
2167
2366
<tr>
2168
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2367
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2169
2368
<td> name of the property
2170
2369
</td>
2171
2370
</tr>
2172
2371
<tr>
2173
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2372
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2174
2373
<td> value of the property
2175
2374
</td>
2176
2375
</tr>
2177
2376
<tr>
2178
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2377
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2179
2378
<td> pointer to an initialized dbus error object for returning errors or NULL
2180
2379
</td>
2181
2380
</tr>
2182
2381
<tr>
2183
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2382
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2184
2383
<td> TRUE if the property was set, FALSE if the device didn't
2185
2384
exist or the property had a different type.
2186
2385
</td>
2190
2389
</div>
2191
2390
<hr>
2192
2391
<div class="refsect2" lang="en">
2193
 
<a name="id2658434"></a><h3>
 
2392
<a name="id2972013"></a><h3>
2194
2393
<a name="libhal-device-property-strlist-append"></a>libhal_device_property_strlist_append ()</h3>
2195
 
<a class="indexterm" name="id2658448"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_strlist_append
2196
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2394
<a class="indexterm" name="id2972028"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_strlist_append
 
2395
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
2197
2396
                                                         const char *udi,
2198
2397
                                                         const char *key,
2199
2398
                                                         const char *value,
2207
2406
<col align="left" valign="top">
2208
2407
<tbody>
2209
2408
<tr>
2210
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2409
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2211
2410
<td> the context for the connection to hald
2212
2411
</td>
2213
2412
</tr>
2214
2413
<tr>
2215
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2414
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2216
2415
<td> the Unique Device Id
2217
2416
</td>
2218
2417
</tr>
2219
2418
<tr>
2220
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2419
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2221
2420
<td> name of the property
2222
2421
</td>
2223
2422
</tr>
2224
2423
<tr>
2225
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2424
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2226
2425
<td> value to append to property
2227
2426
</td>
2228
2427
</tr>
2229
2428
<tr>
2230
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2429
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2231
2430
<td> pointer to an initialized dbus error object for returning errors or NULL
2232
2431
</td>
2233
2432
</tr>
2234
2433
<tr>
2235
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2434
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2236
2435
<td> TRUE if the value was appended, FALSE if the device didn't
2237
2436
exist or the property had a different type.
2238
2437
</td>
2242
2441
</div>
2243
2442
<hr>
2244
2443
<div class="refsect2" lang="en">
2245
 
<a name="id2658600"></a><h3>
 
2444
<a name="id2972179"></a><h3>
2246
2445
<a name="libhal-device-property-strlist-prepend"></a>libhal_device_property_strlist_prepend ()</h3>
2247
 
<a class="indexterm" name="id2658614"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_strlist_prepend
2248
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2446
<a class="indexterm" name="id2972194"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_strlist_prepend
 
2447
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
2249
2448
                                                         const char *udi,
2250
2449
                                                         const char *key,
2251
2450
                                                         const char *value,
2259
2458
<col align="left" valign="top">
2260
2459
<tbody>
2261
2460
<tr>
2262
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2461
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2263
2462
<td> the context for the connection to hald
2264
2463
</td>
2265
2464
</tr>
2266
2465
<tr>
2267
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2466
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2268
2467
<td> the Unique Device Id
2269
2468
</td>
2270
2469
</tr>
2271
2470
<tr>
2272
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2471
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2273
2472
<td> name of the property
2274
2473
</td>
2275
2474
</tr>
2276
2475
<tr>
2277
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2476
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2278
2477
<td> value to prepend to property
2279
2478
</td>
2280
2479
</tr>
2281
2480
<tr>
2282
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2481
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2283
2482
<td> pointer to an initialized dbus error object for returning errors or NULL
2284
2483
</td>
2285
2484
</tr>
2286
2485
<tr>
2287
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2486
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2288
2487
<td> TRUE if the value was prepended, FALSE if the device
2289
2488
didn't exist or the property had a different type.
2290
2489
</td>
2294
2493
</div>
2295
2494
<hr>
2296
2495
<div class="refsect2" lang="en">
2297
 
<a name="id2658766"></a><h3>
 
2496
<a name="id2972345"></a><h3>
2298
2497
<a name="libhal-device-property-strlist-remove-index"></a>libhal_device_property_strlist_remove_index ()</h3>
2299
 
<a class="indexterm" name="id2658782"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_strlist_remove_index
2300
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2498
<a class="indexterm" name="id2972361"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_strlist_remove_index
 
2499
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
2301
2500
                                                         const char *udi,
2302
2501
                                                         const char *key,
2303
2502
                                                         unsigned int idx,
2311
2510
<col align="left" valign="top">
2312
2511
<tbody>
2313
2512
<tr>
2314
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2513
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2315
2514
<td> the context for the connection to hald
2316
2515
</td>
2317
2516
</tr>
2318
2517
<tr>
2319
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2518
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2320
2519
<td> the Unique Device Id
2321
2520
</td>
2322
2521
</tr>
2323
2522
<tr>
2324
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2523
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2325
2524
<td> name of the property
2326
2525
</td>
2327
2526
</tr>
2328
2527
<tr>
2329
 
<td><span class="term"><em class="parameter"><code>idx</code></em>&#160;:</span></td>
 
2528
<td><p><span class="term"><em class="parameter"><code>idx</code></em>&#160;:</span></p></td>
2330
2529
<td> index of string to remove in the strlist
2331
2530
</td>
2332
2531
</tr>
2333
2532
<tr>
2334
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2533
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2335
2534
<td> pointer to an initialized dbus error object for returning errors or NULL
2336
2535
</td>
2337
2536
</tr>
2338
2537
<tr>
2339
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2538
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2340
2539
<td> TRUE if the string was removed, FALSE if the device didn't
2341
2540
exist or the property had a different type.
2342
2541
</td>
2346
2545
</div>
2347
2546
<hr>
2348
2547
<div class="refsect2" lang="en">
2349
 
<a name="id2658933"></a><h3>
 
2548
<a name="id2972513"></a><h3>
2350
2549
<a name="libhal-device-property-strlist-remove"></a>libhal_device_property_strlist_remove ()</h3>
2351
 
<a class="indexterm" name="id2658947"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_strlist_remove
2352
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2550
<a class="indexterm" name="id2972527"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_strlist_remove
 
2551
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
2353
2552
                                                         const char *udi,
2354
2553
                                                         const char *key,
2355
2554
                                                         const char *value,
2363
2562
<col align="left" valign="top">
2364
2563
<tbody>
2365
2564
<tr>
2366
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2565
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2367
2566
<td> the context for the connection to hald
2368
2567
</td>
2369
2568
</tr>
2370
2569
<tr>
2371
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2570
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2372
2571
<td> the Unique Device Id
2373
2572
</td>
2374
2573
</tr>
2375
2574
<tr>
2376
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2575
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2377
2576
<td> name of the property
2378
2577
</td>
2379
2578
</tr>
2380
2579
<tr>
2381
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2580
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2382
2581
<td> the string to remove
2383
2582
</td>
2384
2583
</tr>
2385
2584
<tr>
2386
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2585
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2387
2586
<td> pointer to an initialized dbus error object for returning errors or NULL
2388
2587
</td>
2389
2588
</tr>
2390
2589
<tr>
2391
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2590
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2392
2591
<td> TRUE if the string was removed, FALSE if the device didn't
2393
2592
exist or the property had a different type.
2394
2593
</td>
2398
2597
</div>
2399
2598
<hr>
2400
2599
<div class="refsect2" lang="en">
2401
 
<a name="id2659099"></a><h3>
 
2600
<a name="id2972679"></a><h3>
2402
2601
<a name="libhal-device-remove-property"></a>libhal_device_remove_property ()</h3>
2403
 
<a class="indexterm" name="id2659113"></a><pre class="programlisting">dbus_bool_t         libhal_device_remove_property       (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2602
<a class="indexterm" name="id2972692"></a><pre class="programlisting">dbus_bool_t         libhal_device_remove_property       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
2404
2603
                                                         const char *udi,
2405
2604
                                                         const char *key,
2406
2605
                                                         DBusError *error);</pre>
2413
2612
<col align="left" valign="top">
2414
2613
<tbody>
2415
2614
<tr>
2416
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2615
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2417
2616
<td> the context for the connection to hald
2418
2617
</td>
2419
2618
</tr>
2420
2619
<tr>
2421
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2620
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2422
2621
<td> the Unique Device Id
2423
2622
</td>
2424
2623
</tr>
2425
2624
<tr>
2426
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2625
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2427
2626
<td> name of the property
2428
2627
</td>
2429
2628
</tr>
2430
2629
<tr>
2431
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2630
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2432
2631
<td> pointer to an initialized dbus error object for returning errors or NULL
2433
2632
</td>
2434
2633
</tr>
2435
2634
<tr>
2436
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2635
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2437
2636
<td> TRUE if the property was set, FALSE if the device didn't
2438
2637
exist
2439
2638
</td>
2443
2642
</div>
2444
2643
<hr>
2445
2644
<div class="refsect2" lang="en">
2446
 
<a name="id2659241"></a><h3>
 
2645
<a name="id2972820"></a><h3>
2447
2646
<a name="libhal-device-get-property-type"></a>libhal_device_get_property_type ()</h3>
2448
 
<a class="indexterm" name="id2659255"></a><pre class="programlisting"><a href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>  libhal_device_get_property_type     (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2647
<a class="indexterm" name="id2972834"></a><pre class="programlisting"><a class="link" href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>  libhal_device_get_property_type     (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
2449
2648
                                                         const char *udi,
2450
2649
                                                         const char *key,
2451
2650
                                                         DBusError *error);</pre>
2458
2657
<col align="left" valign="top">
2459
2658
<tbody>
2460
2659
<tr>
2461
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2660
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2462
2661
<td> the context for the connection to hald
2463
2662
</td>
2464
2663
</tr>
2465
2664
<tr>
2466
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2665
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2467
2666
<td> the Unique Device Id
2468
2667
</td>
2469
2668
</tr>
2470
2669
<tr>
2471
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2670
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2472
2671
<td> name of the property
2473
2672
</td>
2474
2673
</tr>
2475
2674
<tr>
2476
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2675
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2477
2676
<td> pointer to an initialized dbus error object for returning errors or NULL
2478
2677
</td>
2479
2678
</tr>
2480
2679
<tr>
2481
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2680
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2482
2681
<td> A LibHalPropertyType. LIBHAL_PROPERTY_TYPE_INVALID is
2483
2682
return if the property doesn't exist.
2484
2683
</td>
2488
2687
</div>
2489
2688
<hr>
2490
2689
<div class="refsect2" lang="en">
2491
 
<a name="id2659384"></a><h3>
 
2690
<a name="id2972963"></a><h3>
2492
2691
<a name="LibHalChangeSet-s"></a>struct LibHalChangeSet_s</h3>
2493
 
<a class="indexterm" name="id2659397"></a><pre class="programlisting">struct LibHalChangeSet_s;</pre>
 
2692
<a class="indexterm" name="id2972977"></a><pre class="programlisting">struct LibHalChangeSet_s;</pre>
2494
2693
<p>
2495
2694
 
2496
2695
</p>
2497
2696
</div>
2498
2697
<hr>
2499
2698
<div class="refsect2" lang="en">
2500
 
<a name="id2659413"></a><h3>
 
2699
<a name="id2972993"></a><h3>
2501
2700
<a name="LibHalChangeSet"></a>LibHalChangeSet</h3>
2502
 
<a class="indexterm" name="id2659426"></a><pre class="programlisting">typedef struct LibHalChangeSet_s LibHalChangeSet;
 
2701
<a class="indexterm" name="id2973006"></a><pre class="programlisting">typedef struct LibHalChangeSet_s LibHalChangeSet;
2503
2702
</pre>
2504
2703
<p>
2505
2704
 
2507
2706
</div>
2508
2707
<hr>
2509
2708
<div class="refsect2" lang="en">
2510
 
<a name="id2659443"></a><h3>
 
2709
<a name="id2973023"></a><h3>
2511
2710
<a name="libhal-device-new-changeset"></a>libhal_device_new_changeset ()</h3>
2512
 
<a class="indexterm" name="id2659457"></a><pre class="programlisting"><a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a>*    libhal_device_new_changeset         (const char *udi);</pre>
 
2711
<a class="indexterm" name="id2973037"></a><pre class="programlisting"><a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a>*    libhal_device_new_changeset         (const char *udi);</pre>
2513
2712
<p>
2514
2713
Request a new changeset object. Used for changing multiple properties at once. Useful when
2515
2714
performance is critical and also for atomically updating several properties.</p>
2520
2719
<col align="left" valign="top">
2521
2720
<tbody>
2522
2721
<tr>
2523
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
2722
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2524
2723
<td> unique device identifier
2525
2724
</td>
2526
2725
</tr>
2527
2726
<tr>
2528
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2727
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2529
2728
<td> A new changeset object or NULL on error
2530
2729
</td>
2531
2730
</tr>
2534
2733
</div>
2535
2734
<hr>
2536
2735
<div class="refsect2" lang="en">
2537
 
<a name="id2659520"></a><h3>
 
2736
<a name="id2973100"></a><h3>
2538
2737
<a name="libhal-changeset-set-property-string"></a>libhal_changeset_set_property_string ()</h3>
2539
 
<a class="indexterm" name="id2659534"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_string
2540
 
                                                        (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
2738
<a class="indexterm" name="id2973114"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_string
 
2739
                                                        (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
2541
2740
                                                         const char *key,
2542
2741
                                                         const char *value);</pre>
2543
2742
<p>
2549
2748
<col align="left" valign="top">
2550
2749
<tbody>
2551
2750
<tr>
2552
 
<td><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></td>
 
2751
<td><p><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></p></td>
2553
2752
<td> the changeset
2554
2753
</td>
2555
2754
</tr>
2556
2755
<tr>
2557
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2756
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2558
2757
<td> key of property 
2559
2758
</td>
2560
2759
</tr>
2561
2760
<tr>
2562
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2761
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2563
2762
<td> the value to set
2564
2763
</td>
2565
2764
</tr>
2566
2765
<tr>
2567
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2766
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2568
2767
<td> FALSE on OOM
2569
2768
</td>
2570
2769
</tr>
2573
2772
</div>
2574
2773
<hr>
2575
2774
<div class="refsect2" lang="en">
2576
 
<a name="id2659640"></a><h3>
 
2775
<a name="id2973220"></a><h3>
2577
2776
<a name="libhal-changeset-set-property-int"></a>libhal_changeset_set_property_int ()</h3>
2578
 
<a class="indexterm" name="id2659654"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_int   (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
2777
<a class="indexterm" name="id2973234"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_int   (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
2579
2778
                                                         const char *key,
2580
2779
                                                         dbus_int32_t value);</pre>
2581
2780
<p>
2587
2786
<col align="left" valign="top">
2588
2787
<tbody>
2589
2788
<tr>
2590
 
<td><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></td>
 
2789
<td><p><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></p></td>
2591
2790
<td> the changeset
2592
2791
</td>
2593
2792
</tr>
2594
2793
<tr>
2595
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2794
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2596
2795
<td> key of property 
2597
2796
</td>
2598
2797
</tr>
2599
2798
<tr>
2600
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2799
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2601
2800
<td> the value to set
2602
2801
</td>
2603
2802
</tr>
2604
2803
<tr>
2605
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2804
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2606
2805
<td> FALSE on OOM
2607
2806
</td>
2608
2807
</tr>
2611
2810
</div>
2612
2811
<hr>
2613
2812
<div class="refsect2" lang="en">
2614
 
<a name="id2659758"></a><h3>
 
2813
<a name="id2973338"></a><h3>
2615
2814
<a name="libhal-changeset-set-property-uint64"></a>libhal_changeset_set_property_uint64 ()</h3>
2616
 
<a class="indexterm" name="id2659772"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_uint64
2617
 
                                                        (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
2815
<a class="indexterm" name="id2973352"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_uint64
 
2816
                                                        (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
2618
2817
                                                         const char *key,
2619
2818
                                                         dbus_uint64_t value);</pre>
2620
2819
<p>
2626
2825
<col align="left" valign="top">
2627
2826
<tbody>
2628
2827
<tr>
2629
 
<td><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></td>
 
2828
<td><p><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></p></td>
2630
2829
<td> the changeset
2631
2830
</td>
2632
2831
</tr>
2633
2832
<tr>
2634
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2833
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2635
2834
<td> key of property 
2636
2835
</td>
2637
2836
</tr>
2638
2837
<tr>
2639
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2838
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2640
2839
<td> the value to set
2641
2840
</td>
2642
2841
</tr>
2643
2842
<tr>
2644
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2843
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2645
2844
<td> FALSE on OOM
2646
2845
</td>
2647
2846
</tr>
2650
2849
</div>
2651
2850
<hr>
2652
2851
<div class="refsect2" lang="en">
2653
 
<a name="id2659878"></a><h3>
 
2852
<a name="id2973458"></a><h3>
2654
2853
<a name="libhal-changeset-set-property-double"></a>libhal_changeset_set_property_double ()</h3>
2655
 
<a class="indexterm" name="id2659892"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_double
2656
 
                                                        (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
2854
<a class="indexterm" name="id2973472"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_double
 
2855
                                                        (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
2657
2856
                                                         const char *key,
2658
2857
                                                         double value);</pre>
2659
2858
<p>
2665
2864
<col align="left" valign="top">
2666
2865
<tbody>
2667
2866
<tr>
2668
 
<td><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></td>
 
2867
<td><p><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></p></td>
2669
2868
<td> the changeset
2670
2869
</td>
2671
2870
</tr>
2672
2871
<tr>
2673
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2872
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2674
2873
<td> key of property 
2675
2874
</td>
2676
2875
</tr>
2677
2876
<tr>
2678
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2877
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2679
2878
<td> the value to set
2680
2879
</td>
2681
2880
</tr>
2682
2881
<tr>
2683
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2882
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2684
2883
<td> FALSE on OOM
2685
2884
</td>
2686
2885
</tr>
2689
2888
</div>
2690
2889
<hr>
2691
2890
<div class="refsect2" lang="en">
2692
 
<a name="id2659998"></a><h3>
 
2891
<a name="id2973578"></a><h3>
2693
2892
<a name="libhal-changeset-set-property-bool"></a>libhal_changeset_set_property_bool ()</h3>
2694
 
<a class="indexterm" name="id2660012"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_bool  (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
2893
<a class="indexterm" name="id2973592"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_bool  (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
2695
2894
                                                         const char *key,
2696
2895
                                                         dbus_bool_t value);</pre>
2697
2896
<p>
2703
2902
<col align="left" valign="top">
2704
2903
<tbody>
2705
2904
<tr>
2706
 
<td><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></td>
 
2905
<td><p><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></p></td>
2707
2906
<td> the changeset
2708
2907
</td>
2709
2908
</tr>
2710
2909
<tr>
2711
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2910
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2712
2911
<td> key of property 
2713
2912
</td>
2714
2913
</tr>
2715
2914
<tr>
2716
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2915
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2717
2916
<td> the value to set
2718
2917
</td>
2719
2918
</tr>
2720
2919
<tr>
2721
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2920
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2722
2921
<td> FALSE on OOM
2723
2922
</td>
2724
2923
</tr>
2727
2926
</div>
2728
2927
<hr>
2729
2928
<div class="refsect2" lang="en">
2730
 
<a name="id2660116"></a><h3>
 
2929
<a name="id2973696"></a><h3>
2731
2930
<a name="libhal-changeset-set-property-strlist"></a>libhal_changeset_set_property_strlist ()</h3>
2732
 
<a class="indexterm" name="id2660130"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_strlist
2733
 
                                                        (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
2931
<a class="indexterm" name="id2973710"></a><pre class="programlisting">dbus_bool_t         libhal_changeset_set_property_strlist
 
2932
                                                        (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
2734
2933
                                                         const char *key,
2735
2934
                                                         const char **value);</pre>
2736
2935
<p>
2742
2941
<col align="left" valign="top">
2743
2942
<tbody>
2744
2943
<tr>
2745
 
<td><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></td>
 
2944
<td><p><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></p></td>
2746
2945
<td> the changeset
2747
2946
</td>
2748
2947
</tr>
2749
2948
<tr>
2750
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
2949
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
2751
2950
<td> key of property 
2752
2951
</td>
2753
2952
</tr>
2754
2953
<tr>
2755
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
2954
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
2756
2955
<td> the value to set - NULL terminated array of strings
2757
2956
</td>
2758
2957
</tr>
2759
2958
<tr>
2760
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2959
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2761
2960
<td> FALSE on OOM
2762
2961
</td>
2763
2962
</tr>
2766
2965
</div>
2767
2966
<hr>
2768
2967
<div class="refsect2" lang="en">
2769
 
<a name="id2660236"></a><h3>
 
2968
<a name="id2973816"></a><h3>
2770
2969
<a name="libhal-device-commit-changeset"></a>libhal_device_commit_changeset ()</h3>
2771
 
<a class="indexterm" name="id2660250"></a><pre class="programlisting">dbus_bool_t         libhal_device_commit_changeset      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
2772
 
                                                         <a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
 
2970
<a class="indexterm" name="id2973830"></a><pre class="programlisting">dbus_bool_t         libhal_device_commit_changeset      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
2971
                                                         <a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset,
2773
2972
                                                         DBusError *error);</pre>
2774
2973
<p>
2775
2974
Commit a changeset to the daemon.</p>
2780
2979
<col align="left" valign="top">
2781
2980
<tbody>
2782
2981
<tr>
2783
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
2982
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2784
2983
<td> the context for the connection to hald
2785
2984
</td>
2786
2985
</tr>
2787
2986
<tr>
2788
 
<td><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></td>
 
2987
<td><p><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></p></td>
2789
2988
<td> the changeset to commit
2790
2989
</td>
2791
2990
</tr>
2792
2991
<tr>
2793
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
2992
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2794
2993
<td> pointer to an initialized dbus error object for returning errors or NULL
2795
2994
</td>
2796
2995
</tr>
2797
2996
<tr>
2798
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
2997
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2799
2998
<td> True if the changeset was committed on the daemon side
2800
2999
</td>
2801
3000
</tr>
2804
3003
</div>
2805
3004
<hr>
2806
3005
<div class="refsect2" lang="en">
2807
 
<a name="id2660357"></a><h3>
 
3006
<a name="id2973937"></a><h3>
2808
3007
<a name="libhal-device-free-changeset"></a>libhal_device_free_changeset ()</h3>
2809
 
<a class="indexterm" name="id2660371"></a><pre class="programlisting">void                libhal_device_free_changeset        (<a href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset);</pre>
 
3008
<a class="indexterm" name="id2973951"></a><pre class="programlisting">void                libhal_device_free_changeset        (<a class="link" href="libhal-libhal.html#LibHalChangeSet">LibHalChangeSet</a> *changeset);</pre>
2810
3009
<p>
2811
3010
Free a changeset.</p>
2812
3011
<p>
2815
3014
<div class="variablelist"><table border="0">
2816
3015
<col align="left" valign="top">
2817
3016
<tbody><tr>
2818
 
<td><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></td>
 
3017
<td><p><span class="term"><em class="parameter"><code>changeset</code></em>&#160;:</span></p></td>
2819
3018
<td> the changeset to free
2820
3019
</td>
2821
3020
</tr></tbody>
2823
3022
</div>
2824
3023
<hr>
2825
3024
<div class="refsect2" lang="en">
2826
 
<a name="id2660422"></a><h3>
2827
 
<a name="LibHalProperty-s"></a>struct LibHalProperty_s</h3>
2828
 
<a class="indexterm" name="id2660435"></a><pre class="programlisting">struct LibHalProperty_s;</pre>
2829
 
<p>
2830
 
 
2831
 
</p>
2832
 
</div>
2833
 
<hr>
2834
 
<div class="refsect2" lang="en">
2835
 
<a name="id2660451"></a><h3>
2836
 
<a name="LibHalProperty"></a>LibHalProperty</h3>
2837
 
<a class="indexterm" name="id2660464"></a><pre class="programlisting">typedef struct LibHalProperty_s LibHalProperty;
2838
 
</pre>
2839
 
<p>
2840
 
Represents a property. Opaque.</p>
2841
 
<p>
2842
 
 
2843
 
</p>
2844
 
</div>
2845
 
<hr>
2846
 
<div class="refsect2" lang="en">
2847
 
<a name="id2660485"></a><h3>
2848
 
<a name="LibHalPropertySet-s"></a>struct LibHalPropertySet_s</h3>
2849
 
<a class="indexterm" name="id2660498"></a><pre class="programlisting">struct LibHalPropertySet_s;</pre>
2850
 
<p>
2851
 
 
2852
 
</p>
2853
 
</div>
2854
 
<hr>
2855
 
<div class="refsect2" lang="en">
2856
 
<a name="id2660514"></a><h3>
2857
 
<a name="LibHalPropertySet"></a>LibHalPropertySet</h3>
2858
 
<a class="indexterm" name="id2660527"></a><pre class="programlisting">typedef struct LibHalPropertySet_s LibHalPropertySet;
2859
 
</pre>
2860
 
<p>
2861
 
Represents a set of properties. Opaque; use the
2862
 
libhal_property_set_*() family of functions to access it.</p>
2863
 
<p>
2864
 
 
2865
 
</p>
2866
 
</div>
2867
 
<hr>
2868
 
<div class="refsect2" lang="en">
2869
 
<a name="id2660549"></a><h3>
 
3025
<a name="id2974002"></a><h3>
2870
3026
<a name="libhal-device-get-all-properties"></a>libhal_device_get_all_properties ()</h3>
2871
 
<a class="indexterm" name="id2660562"></a><pre class="programlisting"><a href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a>*  libhal_device_get_all_properties    (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
3027
<a class="indexterm" name="id2974015"></a><pre class="programlisting"><a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a>*  libhal_device_get_all_properties    (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
2872
3028
                                                         const char *udi,
2873
3029
                                                         DBusError *error);</pre>
2874
3030
<p>
2880
3036
<col align="left" valign="top">
2881
3037
<tbody>
2882
3038
<tr>
2883
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
3039
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
2884
3040
<td> the context for the connection to hald
2885
3041
</td>
2886
3042
</tr>
2887
3043
<tr>
2888
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
3044
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
2889
3045
<td> the Unique id of device
2890
3046
</td>
2891
3047
</tr>
2892
3048
<tr>
2893
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
3049
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
2894
3050
<td> pointer to an initialized dbus error object for returning errors or NULL
2895
3051
</td>
2896
3052
</tr>
2897
3053
<tr>
2898
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
2899
 
<td> An object represent all properties. Must be freed with <a href="libhal-libhal.html#libhal-free-property-set"><code class="function">libhal_free_property_set()</code></a>.
 
3054
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
3055
<td> An object represent all properties. Must be freed with <a class="link" href="libhal-libhal.html#libhal-free-property-set"><code class="function">libhal_free_property_set()</code></a>.
2900
3056
</td>
2901
3057
</tr>
2902
3058
</tbody>
2904
3060
</div>
2905
3061
<hr>
2906
3062
<div class="refsect2" lang="en">
2907
 
<a name="id2660679"></a><h3>
 
3063
<a name="id2974132"></a><h3>
2908
3064
<a name="libhal-property-set-sort"></a>libhal_property_set_sort ()</h3>
2909
 
<a class="indexterm" name="id2660692"></a><pre class="programlisting">void                libhal_property_set_sort            (<a href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);</pre>
 
3065
<a class="indexterm" name="id2974145"></a><pre class="programlisting">void                libhal_property_set_sort            (<a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);</pre>
2910
3066
<p>
2911
3067
Sort all properties according to property name.</p>
2912
3068
<p>
2915
3071
<div class="variablelist"><table border="0">
2916
3072
<col align="left" valign="top">
2917
3073
<tbody><tr>
2918
 
<td><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></td>
 
3074
<td><p><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></p></td>
2919
3075
<td> property-set to sort
2920
3076
</td>
2921
3077
</tr></tbody>
2923
3079
</div>
2924
3080
<hr>
2925
3081
<div class="refsect2" lang="en">
2926
 
<a name="id2660744"></a><h3>
 
3082
<a name="id2974197"></a><h3>
2927
3083
<a name="libhal-free-property-set"></a>libhal_free_property_set ()</h3>
2928
 
<a class="indexterm" name="id2660757"></a><pre class="programlisting">void                libhal_free_property_set            (<a href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);</pre>
 
3084
<a class="indexterm" name="id2974210"></a><pre class="programlisting">void                libhal_free_property_set            (<a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);</pre>
2929
3085
<p>
2930
 
Free a property set earlier obtained with <a href="libhal-libhal.html#libhal-device-get-all-properties"><code class="function">libhal_device_get_all_properties()</code></a>.</p>
 
3086
Free a property set earlier obtained with <a class="link" href="libhal-libhal.html#libhal-device-get-all-properties"><code class="function">libhal_device_get_all_properties()</code></a>.</p>
2931
3087
<p>
2932
3088
 
2933
3089
</p>
2934
3090
<div class="variablelist"><table border="0">
2935
3091
<col align="left" valign="top">
2936
3092
<tbody><tr>
2937
 
<td><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></td>
 
3093
<td><p><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></p></td>
2938
3094
<td> property-set to free
2939
3095
</td>
2940
3096
</tr></tbody>
2942
3098
</div>
2943
3099
<hr>
2944
3100
<div class="refsect2" lang="en">
2945
 
<a name="id2660818"></a><h3>
 
3101
<a name="id2974271"></a><h3>
2946
3102
<a name="libhal-property-set-get-num-elems"></a>libhal_property_set_get_num_elems ()</h3>
2947
 
<a class="indexterm" name="id2660833"></a><pre class="programlisting">unsigned int        libhal_property_set_get_num_elems   (<a href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);</pre>
 
3103
<a class="indexterm" name="id2974286"></a><pre class="programlisting">unsigned int        libhal_property_set_get_num_elems   (<a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);</pre>
2948
3104
<p>
2949
3105
Get the number of properties in a property set.</p>
2950
3106
<p>
2954
3110
<col align="left" valign="top">
2955
3111
<tbody>
2956
3112
<tr>
2957
 
<td><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></td>
 
3113
<td><p><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></p></td>
2958
3114
<td> property set to consider
2959
3115
</td>
2960
3116
</tr>
2961
3117
<tr>
2962
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3118
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
2963
3119
<td> number of properties in given property set
2964
3120
</td>
2965
3121
</tr>
2968
3124
</div>
2969
3125
<hr>
2970
3126
<div class="refsect2" lang="en">
2971
 
<a name="id2660896"></a><h3>
 
3127
<a name="id2974349"></a><h3>
 
3128
<a name="libhal-ps-get-type"></a>libhal_ps_get_type ()</h3>
 
3129
<a class="indexterm" name="id2974362"></a><pre class="programlisting"><a class="link" href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>  libhal_ps_get_type                  (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
3130
                                                         const char *key);</pre>
 
3131
<p>
 
3132
Get the type of a given property.</p>
 
3133
<p>
 
3134
 
 
3135
</p>
 
3136
<div class="variablelist"><table border="0">
 
3137
<col align="left" valign="top">
 
3138
<tbody>
 
3139
<tr>
 
3140
<td><p><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></p></td>
 
3141
<td> property set
 
3142
</td>
 
3143
</tr>
 
3144
<tr>
 
3145
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
 
3146
<td> name of property to inspect
 
3147
</td>
 
3148
</tr>
 
3149
<tr>
 
3150
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
3151
<td> the <a class="link" href="libhal-libhal.html#LibHalPropertyType"><span class="type">LibHalPropertyType</span></a> of the given property, 
 
3152
LIBHAL_PROPERTY_TYPE_INVALID if property is not in the set
 
3153
</td>
 
3154
</tr>
 
3155
</tbody>
 
3156
</table></div>
 
3157
</div>
 
3158
<hr>
 
3159
<div class="refsect2" lang="en">
 
3160
<a name="id2974454"></a><h3>
 
3161
<a name="libhal-ps-get-string"></a>libhal_ps_get_string ()</h3>
 
3162
<a class="indexterm" name="id2974467"></a><pre class="programlisting">const char*         libhal_ps_get_string                (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
3163
                                                         const char *key);</pre>
 
3164
<p>
 
3165
Get the value of a property of type string.</p>
 
3166
<p>
 
3167
 
 
3168
</p>
 
3169
<div class="variablelist"><table border="0">
 
3170
<col align="left" valign="top">
 
3171
<tbody>
 
3172
<tr>
 
3173
<td><p><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></p></td>
 
3174
<td> property set
 
3175
</td>
 
3176
</tr>
 
3177
<tr>
 
3178
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
 
3179
<td> name of property to inspect
 
3180
</td>
 
3181
</tr>
 
3182
<tr>
 
3183
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
3184
<td> UTF8 nul-terminated string. This pointer is only valid
 
3185
until <a class="link" href="libhal-libhal.html#libhal-free-property-set"><code class="function">libhal_free_property_set()</code></a> is invoked on the property set
 
3186
this property belongs to. NULL if property is not in the set or not a string
 
3187
</td>
 
3188
</tr>
 
3189
</tbody>
 
3190
</table></div>
 
3191
</div>
 
3192
<hr>
 
3193
<div class="refsect2" lang="en">
 
3194
<a name="id2974564"></a><h3>
 
3195
<a name="libhal-ps-get-int32"></a>libhal_ps_get_int32 ()</h3>
 
3196
<a class="indexterm" name="id2974578"></a><pre class="programlisting">dbus_int32_t        libhal_ps_get_int32                 (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
3197
                                                         const char *key);</pre>
 
3198
<p>
 
3199
 
 
3200
</p>
 
3201
<div class="variablelist"><table border="0">
 
3202
<col align="left" valign="top">
 
3203
<tbody>
 
3204
<tr>
 
3205
<td><p><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></p></td>
 
3206
<td>
 
3207
</td>
 
3208
</tr>
 
3209
<tr>
 
3210
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
 
3211
<td>
 
3212
</td>
 
3213
</tr>
 
3214
<tr>
 
3215
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
3216
<td>
 
3217
 
 
3218
 
 
3219
</td>
 
3220
</tr>
 
3221
</tbody>
 
3222
</table></div>
 
3223
</div>
 
3224
<hr>
 
3225
<div class="refsect2" lang="en">
 
3226
<a name="id2974656"></a><h3>
 
3227
<a name="libhal-ps-get-uint64"></a>libhal_ps_get_uint64 ()</h3>
 
3228
<a class="indexterm" name="id2974669"></a><pre class="programlisting">dbus_uint64_t       libhal_ps_get_uint64                (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
3229
                                                         const char *key);</pre>
 
3230
<p>
 
3231
Get the value of a property of type unsigned integer.</p>
 
3232
<p>
 
3233
 
 
3234
</p>
 
3235
<div class="variablelist"><table border="0">
 
3236
<col align="left" valign="top">
 
3237
<tbody>
 
3238
<tr>
 
3239
<td><p><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></p></td>
 
3240
<td> property set
 
3241
</td>
 
3242
</tr>
 
3243
<tr>
 
3244
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
 
3245
<td> name of property to inspect
 
3246
</td>
 
3247
</tr>
 
3248
<tr>
 
3249
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
3250
<td> property value (64-bit unsigned integer)
 
3251
</td>
 
3252
</tr>
 
3253
</tbody>
 
3254
</table></div>
 
3255
</div>
 
3256
<hr>
 
3257
<div class="refsect2" lang="en">
 
3258
<a name="id2974754"></a><h3>
 
3259
<a name="libhal-ps-get-double"></a>libhal_ps_get_double ()</h3>
 
3260
<a class="indexterm" name="id2974768"></a><pre class="programlisting">double              libhal_ps_get_double                (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
3261
                                                         const char *key);</pre>
 
3262
<p>
 
3263
Get the value of a property of type double.</p>
 
3264
<p>
 
3265
 
 
3266
</p>
 
3267
<div class="variablelist"><table border="0">
 
3268
<col align="left" valign="top">
 
3269
<tbody>
 
3270
<tr>
 
3271
<td><p><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></p></td>
 
3272
<td> property set
 
3273
</td>
 
3274
</tr>
 
3275
<tr>
 
3276
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
 
3277
<td> name of property to inspect
 
3278
</td>
 
3279
</tr>
 
3280
<tr>
 
3281
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
3282
<td> property value (IEEE754 double precision float)
 
3283
</td>
 
3284
</tr>
 
3285
</tbody>
 
3286
</table></div>
 
3287
</div>
 
3288
<hr>
 
3289
<div class="refsect2" lang="en">
 
3290
<a name="id2974852"></a><h3>
 
3291
<a name="libhal-ps-get-bool"></a>libhal_ps_get_bool ()</h3>
 
3292
<a class="indexterm" name="id2974865"></a><pre class="programlisting">dbus_bool_t         libhal_ps_get_bool                  (const <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set,
 
3293
                                                         const char *key);</pre>
 
3294
<p>
 
3295
Get the value of a property of type bool.</p>
 
3296
<p>
 
3297
 
 
3298
</p>
 
3299
<div class="variablelist"><table border="0">
 
3300
<col align="left" valign="top">
 
3301
<tbody>
 
3302
<tr>
 
3303
<td><p><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></p></td>
 
3304
<td> property set
 
3305
</td>
 
3306
</tr>
 
3307
<tr>
 
3308
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
 
3309
<td> name of property to inspect
 
3310
</td>
 
3311
</tr>
 
3312
<tr>
 
3313
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
3314
<td> property value (bool)
 
3315
</td>
 
3316
</tr>
 
3317
</tbody>
 
3318
</table></div>
 
3319
</div>
 
3320
<hr>
 
3321
<div class="refsect2" lang="en">
 
3322
<a name="id2974948"></a><h3>
2972
3323
<a name="LibHalPropertySetIterator-s"></a>struct LibHalPropertySetIterator_s</h3>
2973
 
<a class="indexterm" name="id2660910"></a><pre class="programlisting">struct LibHalPropertySetIterator_s {
 
3324
<a class="indexterm" name="id2974962"></a><pre class="programlisting">struct LibHalPropertySetIterator_s {
2974
3325
        LibHalPropertySet *set;    /**&lt; Property set we are iterating over */
2975
3326
        unsigned int idx;          /**&lt; Index into current element */
2976
3327
        LibHalProperty *cur_prop;  /**&lt; Current property being visited */
2984
3335
</div>
2985
3336
<hr>
2986
3337
<div class="refsect2" lang="en">
2987
 
<a name="id2660931"></a><h3>
 
3338
<a name="id2974983"></a><h3>
2988
3339
<a name="LibHalPropertySetIterator"></a>LibHalPropertySetIterator</h3>
2989
 
<a class="indexterm" name="id2660944"></a><pre class="programlisting">typedef struct LibHalPropertySetIterator_s LibHalPropertySetIterator;
 
3340
<a class="indexterm" name="id2974997"></a><pre class="programlisting">typedef struct LibHalPropertySetIterator_s LibHalPropertySetIterator;
2990
3341
</pre>
2991
3342
<p>
2992
3343
Iterator for inspecting all properties. Do not access any members;
2997
3348
</div>
2998
3349
<hr>
2999
3350
<div class="refsect2" lang="en">
3000
 
<a name="id2660967"></a><h3>
 
3351
<a name="id2975019"></a><h3>
3001
3352
<a name="libhal-psi-init"></a>libhal_psi_init ()</h3>
3002
 
<a class="indexterm" name="id2660980"></a><pre class="programlisting">void                libhal_psi_init                     (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter,
3003
 
                                                         <a href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);</pre>
 
3353
<a class="indexterm" name="id2975032"></a><pre class="programlisting">void                libhal_psi_init                     (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter,
 
3354
                                                         <a class="link" href="libhal-libhal.html#LibHalPropertySet">LibHalPropertySet</a> *set);</pre>
3004
3355
<p>
3005
3356
Initialize a property set iterator.</p>
3006
3357
<p>
3010
3361
<col align="left" valign="top">
3011
3362
<tbody>
3012
3363
<tr>
3013
 
<td><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></td>
 
3364
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
3014
3365
<td> iterator object
3015
3366
</td>
3016
3367
</tr>
3017
3368
<tr>
3018
 
<td><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></td>
 
3369
<td><p><span class="term"><em class="parameter"><code>set</code></em>&#160;:</span></p></td>
3019
3370
<td> property set to iterate over
3020
3371
</td>
3021
3372
</tr>
3024
3375
</div>
3025
3376
<hr>
3026
3377
<div class="refsect2" lang="en">
3027
 
<a name="id2661053"></a><h3>
 
3378
<a name="id2975105"></a><h3>
3028
3379
<a name="libhal-psi-has-more"></a>libhal_psi_has_more ()</h3>
3029
 
<a class="indexterm" name="id2661066"></a><pre class="programlisting">dbus_bool_t         libhal_psi_has_more                 (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
 
3380
<a class="indexterm" name="id2975119"></a><pre class="programlisting">dbus_bool_t         libhal_psi_has_more                 (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
3030
3381
<p>
3031
3382
Determine whether there are more properties to iterate over.</p>
3032
3383
<p>
3036
3387
<col align="left" valign="top">
3037
3388
<tbody>
3038
3389
<tr>
3039
 
<td><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></td>
 
3390
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
3040
3391
<td> iterator object
3041
3392
</td>
3042
3393
</tr>
3043
3394
<tr>
3044
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3395
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3045
3396
<td> TRUE if there are more properties, FALSE otherwise.
3046
3397
</td>
3047
3398
</tr>
3050
3401
</div>
3051
3402
<hr>
3052
3403
<div class="refsect2" lang="en">
3053
 
<a name="id2661129"></a><h3>
 
3404
<a name="id2975181"></a><h3>
3054
3405
<a name="libhal-psi-next"></a>libhal_psi_next ()</h3>
3055
 
<a class="indexterm" name="id2661142"></a><pre class="programlisting">void                libhal_psi_next                     (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
 
3406
<a class="indexterm" name="id2975194"></a><pre class="programlisting">void                libhal_psi_next                     (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
3056
3407
<p>
3057
3408
Advance iterator to next property.</p>
3058
3409
<p>
3061
3412
<div class="variablelist"><table border="0">
3062
3413
<col align="left" valign="top">
3063
3414
<tbody><tr>
3064
 
<td><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></td>
 
3415
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
3065
3416
<td> iterator object
3066
3417
</td>
3067
3418
</tr></tbody>
3069
3420
</div>
3070
3421
<hr>
3071
3422
<div class="refsect2" lang="en">
3072
 
<a name="id2661192"></a><h3>
 
3423
<a name="id2975245"></a><h3>
3073
3424
<a name="libhal-psi-get-type"></a>libhal_psi_get_type ()</h3>
3074
 
<a class="indexterm" name="id2661206"></a><pre class="programlisting"><a href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>  libhal_psi_get_type                 (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
 
3425
<a class="indexterm" name="id2975258"></a><pre class="programlisting"><a class="link" href="libhal-libhal.html#LibHalPropertyType">LibHalPropertyType</a>  libhal_psi_get_type                 (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
3075
3426
<p>
3076
3427
Get type of property.</p>
3077
3428
<p>
3081
3432
<col align="left" valign="top">
3082
3433
<tbody>
3083
3434
<tr>
3084
 
<td><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></td>
 
3435
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
3085
3436
<td> iterator object
3086
3437
</td>
3087
3438
</tr>
3088
3439
<tr>
3089
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3440
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3090
3441
<td> the property type at the iterator's position
3091
3442
</td>
3092
3443
</tr>
3095
3446
</div>
3096
3447
<hr>
3097
3448
<div class="refsect2" lang="en">
3098
 
<a name="id2661268"></a><h3>
 
3449
<a name="id2975320"></a><h3>
3099
3450
<a name="libhal-psi-get-key"></a>libhal_psi_get_key ()</h3>
3100
 
<a class="indexterm" name="id2661281"></a><pre class="programlisting">char*               libhal_psi_get_key                  (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
 
3451
<a class="indexterm" name="id2975334"></a><pre class="programlisting">char*               libhal_psi_get_key                  (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
3101
3452
<p>
3102
3453
Get the key of a property.</p>
3103
3454
<p>
3107
3458
<col align="left" valign="top">
3108
3459
<tbody>
3109
3460
<tr>
3110
 
<td><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></td>
 
3461
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
3111
3462
<td> iterator object
3112
3463
</td>
3113
3464
</tr>
3114
3465
<tr>
3115
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3466
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3116
3467
<td> ASCII nul-terminated string. This pointer is only valid
3117
 
until <a href="libhal-libhal.html#libhal-free-property-set"><code class="function">libhal_free_property_set()</code></a> is invoked on the property set
 
3468
until <a class="link" href="libhal-libhal.html#libhal-free-property-set"><code class="function">libhal_free_property_set()</code></a> is invoked on the property set
3118
3469
this property belongs to.
3119
3470
</td>
3120
3471
</tr>
3123
3474
</div>
3124
3475
<hr>
3125
3476
<div class="refsect2" lang="en">
3126
 
<a name="id2661354"></a><h3>
 
3477
<a name="id2975406"></a><h3>
3127
3478
<a name="libhal-psi-get-string"></a>libhal_psi_get_string ()</h3>
3128
 
<a class="indexterm" name="id2661367"></a><pre class="programlisting">char*               libhal_psi_get_string               (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
 
3479
<a class="indexterm" name="id2975420"></a><pre class="programlisting">char*               libhal_psi_get_string               (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
3129
3480
<p>
3130
3481
Get the value of a property of type string.</p>
3131
3482
<p>
3135
3486
<col align="left" valign="top">
3136
3487
<tbody>
3137
3488
<tr>
3138
 
<td><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></td>
 
3489
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
3139
3490
<td> iterator object
3140
3491
</td>
3141
3492
</tr>
3142
3493
<tr>
3143
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3494
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3144
3495
<td> UTF8 nul-terminated string. This pointer is only valid
3145
 
until <a href="libhal-libhal.html#libhal-free-property-set"><code class="function">libhal_free_property_set()</code></a> is invoked on the property set
 
3496
until <a class="link" href="libhal-libhal.html#libhal-free-property-set"><code class="function">libhal_free_property_set()</code></a> is invoked on the property set
3146
3497
this property belongs to.
3147
3498
</td>
3148
3499
</tr>
3151
3502
</div>
3152
3503
<hr>
3153
3504
<div class="refsect2" lang="en">
3154
 
<a name="id2661441"></a><h3>
 
3505
<a name="id2975493"></a><h3>
3155
3506
<a name="libhal-psi-get-int"></a>libhal_psi_get_int ()</h3>
3156
 
<a class="indexterm" name="id2661454"></a><pre class="programlisting">dbus_int32_t        libhal_psi_get_int                  (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
 
3507
<a class="indexterm" name="id2975507"></a><pre class="programlisting">dbus_int32_t        libhal_psi_get_int                  (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
3157
3508
<p>
3158
3509
Get the value of a property of type signed integer.</p>
3159
3510
<p>
3163
3514
<col align="left" valign="top">
3164
3515
<tbody>
3165
3516
<tr>
3166
 
<td><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></td>
 
3517
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
3167
3518
<td> iterator object
3168
3519
</td>
3169
3520
</tr>
3170
3521
<tr>
3171
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3522
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3172
3523
<td> property value (32-bit signed integer)
3173
3524
</td>
3174
3525
</tr>
3177
3528
</div>
3178
3529
<hr>
3179
3530
<div class="refsect2" lang="en">
3180
 
<a name="id2661516"></a><h3>
 
3531
<a name="id2975569"></a><h3>
3181
3532
<a name="libhal-psi-get-uint64"></a>libhal_psi_get_uint64 ()</h3>
3182
 
<a class="indexterm" name="id2661530"></a><pre class="programlisting">dbus_uint64_t       libhal_psi_get_uint64               (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
 
3533
<a class="indexterm" name="id2975582"></a><pre class="programlisting">dbus_uint64_t       libhal_psi_get_uint64               (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
3183
3534
<p>
3184
3535
Get the value of a property of type unsigned integer.</p>
3185
3536
<p>
3189
3540
<col align="left" valign="top">
3190
3541
<tbody>
3191
3542
<tr>
3192
 
<td><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></td>
 
3543
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
3193
3544
<td> iterator object
3194
3545
</td>
3195
3546
</tr>
3196
3547
<tr>
3197
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3548
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3198
3549
<td> property value (64-bit unsigned integer)
3199
3550
</td>
3200
3551
</tr>
3203
3554
</div>
3204
3555
<hr>
3205
3556
<div class="refsect2" lang="en">
3206
 
<a name="id2661593"></a><h3>
 
3557
<a name="id2975645"></a><h3>
3207
3558
<a name="libhal-psi-get-double"></a>libhal_psi_get_double ()</h3>
3208
 
<a class="indexterm" name="id2661606"></a><pre class="programlisting">double              libhal_psi_get_double               (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
 
3559
<a class="indexterm" name="id2975658"></a><pre class="programlisting">double              libhal_psi_get_double               (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
3209
3560
<p>
3210
3561
Get the value of a property of type double.</p>
3211
3562
<p>
3215
3566
<col align="left" valign="top">
3216
3567
<tbody>
3217
3568
<tr>
3218
 
<td><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></td>
 
3569
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
3219
3570
<td> iterator object
3220
3571
</td>
3221
3572
</tr>
3222
3573
<tr>
3223
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3574
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3224
3575
<td> property value (IEEE754 double precision float)
3225
3576
</td>
3226
3577
</tr>
3229
3580
</div>
3230
3581
<hr>
3231
3582
<div class="refsect2" lang="en">
3232
 
<a name="id2661668"></a><h3>
 
3583
<a name="id2975721"></a><h3>
3233
3584
<a name="libhal-psi-get-bool"></a>libhal_psi_get_bool ()</h3>
3234
 
<a class="indexterm" name="id2661682"></a><pre class="programlisting">dbus_bool_t         libhal_psi_get_bool                 (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
 
3585
<a class="indexterm" name="id2975734"></a><pre class="programlisting">dbus_bool_t         libhal_psi_get_bool                 (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
3235
3586
<p>
3236
3587
Get the value of a property of type bool.</p>
3237
3588
<p>
3241
3592
<col align="left" valign="top">
3242
3593
<tbody>
3243
3594
<tr>
3244
 
<td><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></td>
 
3595
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
3245
3596
<td> iterator object
3246
3597
</td>
3247
3598
</tr>
3248
3599
<tr>
3249
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3600
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3250
3601
<td> property value (bool)
3251
3602
</td>
3252
3603
</tr>
3255
3606
</div>
3256
3607
<hr>
3257
3608
<div class="refsect2" lang="en">
3258
 
<a name="id2661743"></a><h3>
 
3609
<a name="id2975796"></a><h3>
3259
3610
<a name="libhal-psi-get-strlist"></a>libhal_psi_get_strlist ()</h3>
3260
 
<a class="indexterm" name="id2661757"></a><pre class="programlisting">char**              libhal_psi_get_strlist              (<a href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
 
3611
<a class="indexterm" name="id2975809"></a><pre class="programlisting">char**              libhal_psi_get_strlist              (<a class="link" href="libhal-libhal.html#LibHalPropertySetIterator">LibHalPropertySetIterator</a> *iter);</pre>
3261
3612
<p>
3262
3613
Get the value of a property of type string list.</p>
3263
3614
<p>
3267
3618
<col align="left" valign="top">
3268
3619
<tbody>
3269
3620
<tr>
3270
 
<td><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></td>
 
3621
<td><p><span class="term"><em class="parameter"><code>iter</code></em>&#160;:</span></p></td>
3271
3622
<td> iterator object
3272
3623
</td>
3273
3624
</tr>
3274
3625
<tr>
3275
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3626
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3276
3627
<td> pointer to array of strings
3277
3628
</td>
3278
3629
</tr>
3281
3632
</div>
3282
3633
<hr>
3283
3634
<div class="refsect2" lang="en">
3284
 
<a name="id2661819"></a><h3>
 
3635
<a name="id2975872"></a><h3>
3285
3636
<a name="libhal-string-array-length"></a>libhal_string_array_length ()</h3>
3286
 
<a class="indexterm" name="id2661834"></a><pre class="programlisting">unsigned int        libhal_string_array_length          (char **str_array);</pre>
 
3637
<a class="indexterm" name="id2975886"></a><pre class="programlisting">unsigned int        libhal_string_array_length          (char **str_array);</pre>
3287
3638
<p>
3288
3639
Get the length of an array of strings.</p>
3289
3640
<p>
3293
3644
<col align="left" valign="top">
3294
3645
<tbody>
3295
3646
<tr>
3296
 
<td><span class="term"><em class="parameter"><code>str_array</code></em>&#160;:</span></td>
 
3647
<td><p><span class="term"><em class="parameter"><code>str_array</code></em>&#160;:</span></p></td>
3297
3648
<td> array of strings to consider
3298
3649
</td>
3299
3650
</tr>
3300
3651
<tr>
3301
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3652
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3302
3653
<td> Number of strings in array
3303
3654
</td>
3304
3655
</tr>
3307
3658
</div>
3308
3659
<hr>
3309
3660
<div class="refsect2" lang="en">
3310
 
<a name="id2661896"></a><h3>
 
3661
<a name="id2975949"></a><h3>
3311
3662
<a name="libhal-free-string-array"></a>libhal_free_string_array ()</h3>
3312
 
<a class="indexterm" name="id2661910"></a><pre class="programlisting">void                libhal_free_string_array            (char **str_array);</pre>
 
3663
<a class="indexterm" name="id2975962"></a><pre class="programlisting">void                libhal_free_string_array            (char **str_array);</pre>
3313
3664
<p>
3314
3665
Frees a NULL-terminated array of strings. If passed NULL, does nothing.</p>
3315
3666
<p>
3318
3669
<div class="variablelist"><table border="0">
3319
3670
<col align="left" valign="top">
3320
3671
<tbody><tr>
3321
 
<td><span class="term"><em class="parameter"><code>str_array</code></em>&#160;:</span></td>
 
3672
<td><p><span class="term"><em class="parameter"><code>str_array</code></em>&#160;:</span></p></td>
3322
3673
<td> the array to be freed
3323
3674
</td>
3324
3675
</tr></tbody>
3326
3677
</div>
3327
3678
<hr>
3328
3679
<div class="refsect2" lang="en">
3329
 
<a name="id2661961"></a><h3>
 
3680
<a name="id2976014"></a><h3>
3330
3681
<a name="libhal-free-string"></a>libhal_free_string ()</h3>
3331
 
<a class="indexterm" name="id2661975"></a><pre class="programlisting">void                libhal_free_string                  (char *str);</pre>
 
3682
<a class="indexterm" name="id2976028"></a><pre class="programlisting">void                libhal_free_string                  (char *str);</pre>
3332
3683
<p>
3333
3684
Used to free strings returned by libhal.</p>
3334
3685
<p>
3337
3688
<div class="variablelist"><table border="0">
3338
3689
<col align="left" valign="top">
3339
3690
<tbody><tr>
3340
 
<td><span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></td>
 
3691
<td><p><span class="term"><em class="parameter"><code>str</code></em>&#160;:</span></p></td>
3341
3692
<td> the nul-terminated sting to free
3342
3693
</td>
3343
3694
</tr></tbody>
3345
3696
</div>
3346
3697
<hr>
3347
3698
<div class="refsect2" lang="en">
3348
 
<a name="id2662026"></a><h3>
 
3699
<a name="id2976078"></a><h3>
3349
3700
<a name="libhal-new-device"></a>libhal_new_device ()</h3>
3350
 
<a class="indexterm" name="id2662040"></a><pre class="programlisting">char*               libhal_new_device                   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
3701
<a class="indexterm" name="id2976092"></a><pre class="programlisting">char*               libhal_new_device                   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3351
3702
                                                         DBusError *error);</pre>
3352
3703
<p>
3353
3704
Create a new device object which will be hidden from applications
3354
 
until the <code class="function">CommitToGdl()</code>, ie. <a href="libhal-libhal.html#libhal-device-commit-to-gdl"><code class="function">libhal_device_commit_to_gdl()</code></a>, method
 
3705
until the <code class="function">CommitToGdl()</code>, ie. <a class="link" href="libhal-libhal.html#libhal-device-commit-to-gdl"><code class="function">libhal_device_commit_to_gdl()</code></a>, method
3355
3706
is called. Note that the program invoking this method needs to run
3356
3707
with super user privileges.</p>
3357
3708
<p>
3361
3712
<col align="left" valign="top">
3362
3713
<tbody>
3363
3714
<tr>
3364
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
3715
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3365
3716
<td> the context for the connection to hald
3366
3717
</td>
3367
3718
</tr>
3368
3719
<tr>
3369
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
3720
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3370
3721
<td> pointer to an initialized dbus error object for returning errors or NULL
3371
3722
</td>
3372
3723
</tr>
3373
3724
<tr>
3374
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3725
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3375
3726
<td> Temporary device unique id or NULL if there was a
3376
3727
problem. This string must be freed by the caller.
3377
3728
</td>
3381
3732
</div>
3382
3733
<hr>
3383
3734
<div class="refsect2" lang="en">
3384
 
<a name="id2662147"></a><h3>
 
3735
<a name="id2976199"></a><h3>
3385
3736
<a name="libhal-device-commit-to-gdl"></a>libhal_device_commit_to_gdl ()</h3>
3386
 
<a class="indexterm" name="id2662161"></a><pre class="programlisting">dbus_bool_t         libhal_device_commit_to_gdl         (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
3737
<a class="indexterm" name="id2976214"></a><pre class="programlisting">dbus_bool_t         libhal_device_commit_to_gdl         (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3387
3738
                                                         const char *temp_udi,
3388
3739
                                                         const char *udi,
3389
3740
                                                         DBusError *error);</pre>
3390
3741
<p>
3391
3742
When a hidden device has been built using the NewDevice method,
3392
 
ie. <a href="libhal-libhal.html#libhal-new-device"><code class="function">libhal_new_device()</code></a>, and the org.freedesktop.Hal.Device
 
3743
ie. <a class="link" href="libhal-libhal.html#libhal-new-device"><code class="function">libhal_new_device()</code></a>, and the org.freedesktop.Hal.Device
3393
3744
interface this function will commit it to the global device list.
3394
3745
</p>
3395
3746
<p>
3407
3758
<col align="left" valign="top">
3408
3759
<tbody>
3409
3760
<tr>
3410
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
3761
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3411
3762
<td> the context for the connection to hald
3412
3763
</td>
3413
3764
</tr>
3414
3765
<tr>
3415
 
<td><span class="term"><em class="parameter"><code>temp_udi</code></em>&#160;:</span></td>
3416
 
<td> the temporary unique device id as returned by <a href="libhal-libhal.html#libhal-new-device"><code class="function">libhal_new_device()</code></a>
 
3766
<td><p><span class="term"><em class="parameter"><code>temp_udi</code></em>&#160;:</span></p></td>
 
3767
<td> the temporary unique device id as returned by <a class="link" href="libhal-libhal.html#libhal-new-device"><code class="function">libhal_new_device()</code></a>
3417
3768
</td>
3418
3769
</tr>
3419
3770
<tr>
3420
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
3771
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
3421
3772
<td> the new unique device id.
3422
3773
</td>
3423
3774
</tr>
3424
3775
<tr>
3425
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
3776
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3426
3777
<td> pointer to an initialized dbus error object for returning errors or NULL
3427
3778
</td>
3428
3779
</tr>
3429
3780
<tr>
3430
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3781
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3431
3782
<td> FALSE if the given unique device id is already in use.
3432
3783
</td>
3433
3784
</tr>
3436
3787
</div>
3437
3788
<hr>
3438
3789
<div class="refsect2" lang="en">
3439
 
<a name="id2662322"></a><h3>
 
3790
<a name="id2976374"></a><h3>
3440
3791
<a name="libhal-remove-device"></a>libhal_remove_device ()</h3>
3441
 
<a class="indexterm" name="id2662336"></a><pre class="programlisting">dbus_bool_t         libhal_remove_device                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
3792
<a class="indexterm" name="id2976388"></a><pre class="programlisting">dbus_bool_t         libhal_remove_device                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3442
3793
                                                         const char *udi,
3443
3794
                                                         DBusError *error);</pre>
3444
3795
<p>
3456
3807
<col align="left" valign="top">
3457
3808
<tbody>
3458
3809
<tr>
3459
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
3810
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3460
3811
<td> the context for the connection to hald
3461
3812
</td>
3462
3813
</tr>
3463
3814
<tr>
3464
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
3815
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
3465
3816
<td> the Unique device id.
3466
3817
</td>
3467
3818
</tr>
3468
3819
<tr>
3469
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
3820
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3470
3821
<td> pointer to an initialized dbus error object for returning errors or NULL
3471
3822
</td>
3472
3823
</tr>
3473
3824
<tr>
3474
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3825
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3475
3826
<td> TRUE if the device was removed, FALSE otherwise
3476
3827
</td>
3477
3828
</tr>
3480
3831
</div>
3481
3832
<hr>
3482
3833
<div class="refsect2" lang="en">
3483
 
<a name="id2662450"></a><h3>
 
3834
<a name="id2976502"></a><h3>
3484
3835
<a name="libhal-merge-properties"></a>libhal_merge_properties ()</h3>
3485
 
<a class="indexterm" name="id2662463"></a><pre class="programlisting">dbus_bool_t         libhal_merge_properties             (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
3836
<a class="indexterm" name="id2976516"></a><pre class="programlisting">dbus_bool_t         libhal_merge_properties             (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3486
3837
                                                         const char *target_udi,
3487
3838
                                                         const char *source_udi,
3488
3839
                                                         DBusError *error);</pre>
3495
3846
<col align="left" valign="top">
3496
3847
<tbody>
3497
3848
<tr>
3498
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
3849
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3499
3850
<td> the context for the connection to hald
3500
3851
</td>
3501
3852
</tr>
3502
3853
<tr>
3503
 
<td><span class="term"><em class="parameter"><code>target_udi</code></em>&#160;:</span></td>
 
3854
<td><p><span class="term"><em class="parameter"><code>target_udi</code></em>&#160;:</span></p></td>
3504
3855
<td> the Unique device id of target device to merge to
3505
3856
</td>
3506
3857
</tr>
3507
3858
<tr>
3508
 
<td><span class="term"><em class="parameter"><code>source_udi</code></em>&#160;:</span></td>
 
3859
<td><p><span class="term"><em class="parameter"><code>source_udi</code></em>&#160;:</span></p></td>
3509
3860
<td> the Unique device id of device to merge from
3510
3861
</td>
3511
3862
</tr>
3512
3863
<tr>
3513
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
3864
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3514
3865
<td> pointer to an initialized dbus error object for returning errors or NULL
3515
3866
</td>
3516
3867
</tr>
3517
3868
<tr>
3518
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3869
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3519
3870
<td> TRUE if the properties were merged, FALSE otherwise
3520
3871
</td>
3521
3872
</tr>
3524
3875
</div>
3525
3876
<hr>
3526
3877
<div class="refsect2" lang="en">
3527
 
<a name="id2662593"></a><h3>
 
3878
<a name="id2976645"></a><h3>
3528
3879
<a name="libhal-device-matches"></a>libhal_device_matches ()</h3>
3529
 
<a class="indexterm" name="id2662606"></a><pre class="programlisting">dbus_bool_t         libhal_device_matches               (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
3880
<a class="indexterm" name="id2976658"></a><pre class="programlisting">dbus_bool_t         libhal_device_matches               (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3530
3881
                                                         const char *udi1,
3531
3882
                                                         const char *udi2,
3532
3883
                                                         const char *property_namespace,
3550
3901
<col align="left" valign="top">
3551
3902
<tbody>
3552
3903
<tr>
3553
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
3904
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3554
3905
<td> the context for the connection to hald
3555
3906
</td>
3556
3907
</tr>
3557
3908
<tr>
3558
 
<td><span class="term"><em class="parameter"><code>udi1</code></em>&#160;:</span></td>
 
3909
<td><p><span class="term"><em class="parameter"><code>udi1</code></em>&#160;:</span></p></td>
3559
3910
<td> the Unique Device Id for device 1
3560
3911
</td>
3561
3912
</tr>
3562
3913
<tr>
3563
 
<td><span class="term"><em class="parameter"><code>udi2</code></em>&#160;:</span></td>
 
3914
<td><p><span class="term"><em class="parameter"><code>udi2</code></em>&#160;:</span></p></td>
3564
3915
<td> the Unique Device Id for device 2
3565
3916
</td>
3566
3917
</tr>
3567
3918
<tr>
3568
 
<td><span class="term"><em class="parameter"><code>property_namespace</code></em>&#160;:</span></td>
 
3919
<td><p><span class="term"><em class="parameter"><code>property_namespace</code></em>&#160;:</span></p></td>
3569
3920
<td> the namespace for set of devices, e.g. "usb"
3570
3921
</td>
3571
3922
</tr>
3572
3923
<tr>
3573
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
3924
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3574
3925
<td> pointer to an initialized dbus error object for returning errors or NULL
3575
3926
</td>
3576
3927
</tr>
3577
3928
<tr>
3578
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
3929
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3579
3930
<td> TRUE if all properties starting with the given namespace
3580
3931
parameter from one device is in the other and have the same value.
3581
3932
</td>
3585
3936
</div>
3586
3937
<hr>
3587
3938
<div class="refsect2" lang="en">
3588
 
<a name="id2662771"></a><h3>
 
3939
<a name="id2976823"></a><h3>
3589
3940
<a name="libhal-manager-find-device-string-match"></a>libhal_manager_find_device_string_match ()</h3>
3590
 
<a class="indexterm" name="id2662785"></a><pre class="programlisting">char**              libhal_manager_find_device_string_match
3591
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
3941
<a class="indexterm" name="id2976837"></a><pre class="programlisting">char**              libhal_manager_find_device_string_match
 
3942
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3592
3943
                                                         const char *key,
3593
3944
                                                         const char *value,
3594
3945
                                                         int *num_devices,
3603
3954
<col align="left" valign="top">
3604
3955
<tbody>
3605
3956
<tr>
3606
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
3957
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3607
3958
<td> the context for the connection to hald
3608
3959
</td>
3609
3960
</tr>
3610
3961
<tr>
3611
 
<td><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></td>
 
3962
<td><p><span class="term"><em class="parameter"><code>key</code></em>&#160;:</span></p></td>
3612
3963
<td> name of the property
3613
3964
</td>
3614
3965
</tr>
3615
3966
<tr>
3616
 
<td><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></td>
 
3967
<td><p><span class="term"><em class="parameter"><code>value</code></em>&#160;:</span></p></td>
3617
3968
<td> the value to match
3618
3969
</td>
3619
3970
</tr>
3620
3971
<tr>
3621
 
<td><span class="term"><em class="parameter"><code>num_devices</code></em>&#160;:</span></td>
 
3972
<td><p><span class="term"><em class="parameter"><code>num_devices</code></em>&#160;:</span></p></td>
3622
3973
<td> pointer to store number of devices
3623
3974
</td>
3624
3975
</tr>
3625
3976
<tr>
3626
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
3977
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3627
3978
<td> pointer to an initialized dbus error object for returning errors or NULL
3628
3979
</td>
3629
3980
</tr>
3630
3981
<tr>
3631
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
3632
 
<td> UDI of devices; free with <a href="libhal-libhal.html#libhal-free-string-array"><code class="function">libhal_free_string_array()</code></a>
 
3982
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
3983
<td> UDI of devices; free with <a class="link" href="libhal-libhal.html#libhal-free-string-array"><code class="function">libhal_free_string_array()</code></a>
3633
3984
</td>
3634
3985
</tr>
3635
3986
</tbody>
3637
3988
</div>
3638
3989
<hr>
3639
3990
<div class="refsect2" lang="en">
3640
 
<a name="id2662946"></a><h3>
 
3991
<a name="id2976999"></a><h3>
3641
3992
<a name="libhal-device-add-capability"></a>libhal_device_add_capability ()</h3>
3642
 
<a class="indexterm" name="id2662960"></a><pre class="programlisting">dbus_bool_t         libhal_device_add_capability        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
3993
<a class="indexterm" name="id2977013"></a><pre class="programlisting">dbus_bool_t         libhal_device_add_capability        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3643
3994
                                                         const char *udi,
3644
3995
                                                         const char *capability,
3645
3996
                                                         DBusError *error);</pre>
3652
4003
<col align="left" valign="top">
3653
4004
<tbody>
3654
4005
<tr>
3655
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4006
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3656
4007
<td> the context for the connection to hald
3657
4008
</td>
3658
4009
</tr>
3659
4010
<tr>
3660
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4011
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
3661
4012
<td> the Unique Device Id
3662
4013
</td>
3663
4014
</tr>
3664
4015
<tr>
3665
 
<td><span class="term"><em class="parameter"><code>capability</code></em>&#160;:</span></td>
 
4016
<td><p><span class="term"><em class="parameter"><code>capability</code></em>&#160;:</span></p></td>
3666
4017
<td> the capability name to add
3667
4018
</td>
3668
4019
</tr>
3669
4020
<tr>
3670
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4021
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3671
4022
<td> pointer to an initialized dbus error object for returning errors or NULL
3672
4023
</td>
3673
4024
</tr>
3674
4025
<tr>
3675
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4026
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3676
4027
<td> TRUE if the capability was added, FALSE if the device didn't exist
3677
4028
</td>
3678
4029
</tr>
3681
4032
</div>
3682
4033
<hr>
3683
4034
<div class="refsect2" lang="en">
3684
 
<a name="id2663089"></a><h3>
 
4035
<a name="id2977142"></a><h3>
3685
4036
<a name="libhal-device-query-capability"></a>libhal_device_query_capability ()</h3>
3686
 
<a class="indexterm" name="id2663103"></a><pre class="programlisting">dbus_bool_t         libhal_device_query_capability      (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4037
<a class="indexterm" name="id2977155"></a><pre class="programlisting">dbus_bool_t         libhal_device_query_capability      (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3687
4038
                                                         const char *udi,
3688
4039
                                                         const char *capability,
3689
4040
                                                         DBusError *error);</pre>
3697
4048
<col align="left" valign="top">
3698
4049
<tbody>
3699
4050
<tr>
3700
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4051
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3701
4052
<td> the context for the connection to hald
3702
4053
</td>
3703
4054
</tr>
3704
4055
<tr>
3705
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4056
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
3706
4057
<td> the Unique Device Id
3707
4058
</td>
3708
4059
</tr>
3709
4060
<tr>
3710
 
<td><span class="term"><em class="parameter"><code>capability</code></em>&#160;:</span></td>
 
4061
<td><p><span class="term"><em class="parameter"><code>capability</code></em>&#160;:</span></p></td>
3711
4062
<td> the capability name
3712
4063
</td>
3713
4064
</tr>
3714
4065
<tr>
3715
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4066
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3716
4067
<td> pointer to an initialized dbus error object for returning errors or NULL
3717
4068
</td>
3718
4069
</tr>
3719
4070
<tr>
3720
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4071
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3721
4072
<td> TRUE if the device has the capability, otherwise FALSE
3722
4073
</td>
3723
4074
</tr>
3726
4077
</div>
3727
4078
<hr>
3728
4079
<div class="refsect2" lang="en">
3729
 
<a name="id2663232"></a><h3>
 
4080
<a name="id2977284"></a><h3>
3730
4081
<a name="libhal-find-device-by-capability"></a>libhal_find_device_by_capability ()</h3>
3731
 
<a class="indexterm" name="id2663246"></a><pre class="programlisting">char**              libhal_find_device_by_capability    (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4082
<a class="indexterm" name="id2977299"></a><pre class="programlisting">char**              libhal_find_device_by_capability    (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3732
4083
                                                         const char *capability,
3733
4084
                                                         int *num_devices,
3734
4085
                                                         DBusError *error);</pre>
3741
4092
<col align="left" valign="top">
3742
4093
<tbody>
3743
4094
<tr>
3744
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4095
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3745
4096
<td> the context for the connection to hald
3746
4097
</td>
3747
4098
</tr>
3748
4099
<tr>
3749
 
<td><span class="term"><em class="parameter"><code>capability</code></em>&#160;:</span></td>
 
4100
<td><p><span class="term"><em class="parameter"><code>capability</code></em>&#160;:</span></p></td>
3750
4101
<td> the capability name
3751
4102
</td>
3752
4103
</tr>
3753
4104
<tr>
3754
 
<td><span class="term"><em class="parameter"><code>num_devices</code></em>&#160;:</span></td>
 
4105
<td><p><span class="term"><em class="parameter"><code>num_devices</code></em>&#160;:</span></p></td>
3755
4106
<td> pointer to store number of devices
3756
4107
</td>
3757
4108
</tr>
3758
4109
<tr>
3759
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4110
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3760
4111
<td> pointer to an initialized dbus error object for returning errors or NULL
3761
4112
</td>
3762
4113
</tr>
3763
4114
<tr>
3764
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
3765
 
<td> UDI of devices; free with <a href="libhal-libhal.html#libhal-free-string-array"><code class="function">libhal_free_string_array()</code></a>
 
4115
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
4116
<td> UDI of devices; free with <a class="link" href="libhal-libhal.html#libhal-free-string-array"><code class="function">libhal_free_string_array()</code></a>
3766
4117
</td>
3767
4118
</tr>
3768
4119
</tbody>
3770
4121
</div>
3771
4122
<hr>
3772
4123
<div class="refsect2" lang="en">
3773
 
<a name="id2663384"></a><h3>
 
4124
<a name="id2977437"></a><h3>
3774
4125
<a name="libhal-device-property-watch-all"></a>libhal_device_property_watch_all ()</h3>
3775
 
<a class="indexterm" name="id2663399"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_watch_all    (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4126
<a class="indexterm" name="id2977451"></a><pre class="programlisting">dbus_bool_t         libhal_device_property_watch_all    (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3776
4127
                                                         DBusError *error);</pre>
3777
4128
<p>
3778
4129
Watch all devices, ie. the device_property_changed callback is
3784
4135
<col align="left" valign="top">
3785
4136
<tbody>
3786
4137
<tr>
3787
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4138
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3788
4139
<td> the context for the connection to hald
3789
4140
</td>
3790
4141
</tr>
3791
4142
<tr>
3792
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4143
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3793
4144
<td> pointer to an initialized dbus error object for returning errors or NULL
3794
4145
</td>
3795
4146
</tr>
3796
4147
<tr>
3797
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4148
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3798
4149
<td> TRUE only if the operation succeeded
3799
4150
</td>
3800
4151
</tr>
3803
4154
</div>
3804
4155
<hr>
3805
4156
<div class="refsect2" lang="en">
3806
 
<a name="id2663485"></a><h3>
 
4157
<a name="id2977537"></a><h3>
3807
4158
<a name="libhal-device-add-property-watch"></a>libhal_device_add_property_watch ()</h3>
3808
 
<a class="indexterm" name="id2663498"></a><pre class="programlisting">dbus_bool_t         libhal_device_add_property_watch    (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4159
<a class="indexterm" name="id2977551"></a><pre class="programlisting">dbus_bool_t         libhal_device_add_property_watch    (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3809
4160
                                                         const char *udi,
3810
4161
                                                         DBusError *error);</pre>
3811
4162
<p>
3822
4173
<col align="left" valign="top">
3823
4174
<tbody>
3824
4175
<tr>
3825
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4176
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3826
4177
<td> the context for the connection to hald
3827
4178
</td>
3828
4179
</tr>
3829
4180
<tr>
3830
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4181
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
3831
4182
<td> the Unique Device Id
3832
4183
</td>
3833
4184
</tr>
3834
4185
<tr>
3835
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4186
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3836
4187
<td> pointer to an initialized dbus error object for returning errors or NULL
3837
4188
</td>
3838
4189
</tr>
3839
4190
<tr>
3840
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4191
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3841
4192
<td> TRUE only if the operation succeeded
3842
4193
</td>
3843
4194
</tr>
3846
4197
</div>
3847
4198
<hr>
3848
4199
<div class="refsect2" lang="en">
3849
 
<a name="id2663612"></a><h3>
 
4200
<a name="id2977664"></a><h3>
3850
4201
<a name="libhal-device-remove-property-watch"></a>libhal_device_remove_property_watch ()</h3>
3851
 
<a class="indexterm" name="id2663627"></a><pre class="programlisting">dbus_bool_t         libhal_device_remove_property_watch (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4202
<a class="indexterm" name="id2977679"></a><pre class="programlisting">dbus_bool_t         libhal_device_remove_property_watch (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3852
4203
                                                         const char *udi,
3853
4204
                                                         DBusError *error);</pre>
3854
4205
<p>
3860
4211
<col align="left" valign="top">
3861
4212
<tbody>
3862
4213
<tr>
3863
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4214
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3864
4215
<td> the context for the connection to hald
3865
4216
</td>
3866
4217
</tr>
3867
4218
<tr>
3868
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4219
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
3869
4220
<td> the Unique Device Id
3870
4221
</td>
3871
4222
</tr>
3872
4223
<tr>
3873
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4224
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3874
4225
<td> pointer to an initialized dbus error object for returning errors or NULL
3875
4226
</td>
3876
4227
</tr>
3877
4228
<tr>
3878
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4229
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3879
4230
<td> TRUE only if the operation succeeded
3880
4231
</td>
3881
4232
</tr>
3884
4235
</div>
3885
4236
<hr>
3886
4237
<div class="refsect2" lang="en">
3887
 
<a name="id2663732"></a><h3>
 
4238
<a name="id2977785"></a><h3>
3888
4239
<a name="libhal-device-lock"></a>libhal_device_lock ()</h3>
3889
 
<a class="indexterm" name="id2663746"></a><pre class="programlisting">dbus_bool_t         libhal_device_lock                  (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4240
<a class="indexterm" name="id2977798"></a><pre class="programlisting">dbus_bool_t         libhal_device_lock                  (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3890
4241
                                                         const char *udi,
3891
4242
                                                         const char *reason_to_lock,
3892
4243
                                                         char **reason_why_locked,
3900
4251
<col align="left" valign="top">
3901
4252
<tbody>
3902
4253
<tr>
3903
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4254
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3904
4255
<td> the context for the connection to hald
3905
4256
</td>
3906
4257
</tr>
3907
4258
<tr>
3908
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4259
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
3909
4260
<td> the Unique Device Id
3910
4261
</td>
3911
4262
</tr>
3912
4263
<tr>
3913
 
<td><span class="term"><em class="parameter"><code>reason_to_lock</code></em>&#160;:</span></td>
 
4264
<td><p><span class="term"><em class="parameter"><code>reason_to_lock</code></em>&#160;:</span></p></td>
3914
4265
<td> a user-presentable reason why the device is locked.
3915
4266
</td>
3916
4267
</tr>
3917
4268
<tr>
3918
 
<td><span class="term"><em class="parameter"><code>reason_why_locked</code></em>&#160;:</span></td>
 
4269
<td><p><span class="term"><em class="parameter"><code>reason_why_locked</code></em>&#160;:</span></p></td>
3919
4270
<td> a pointer to store the reason why the device cannot be locked on failure, or NULL
3920
4271
</td>
3921
4272
</tr>
3922
4273
<tr>
3923
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4274
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3924
4275
<td> pointer to an initialized dbus error object for returning errors or NULL
3925
4276
</td>
3926
4277
</tr>
3927
4278
<tr>
3928
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4279
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3929
4280
<td> TRUE if the lock was obtained, FALSE otherwise
3930
4281
</td>
3931
4282
</tr>
3934
4285
</div>
3935
4286
<hr>
3936
4287
<div class="refsect2" lang="en">
3937
 
<a name="id2663897"></a><h3>
 
4288
<a name="id2977949"></a><h3>
3938
4289
<a name="libhal-device-unlock"></a>libhal_device_unlock ()</h3>
3939
 
<a class="indexterm" name="id2663910"></a><pre class="programlisting">dbus_bool_t         libhal_device_unlock                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4290
<a class="indexterm" name="id2977962"></a><pre class="programlisting">dbus_bool_t         libhal_device_unlock                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3940
4291
                                                         const char *udi,
3941
4292
                                                         DBusError *error);</pre>
3942
4293
<p>
3948
4299
<col align="left" valign="top">
3949
4300
<tbody>
3950
4301
<tr>
3951
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4302
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3952
4303
<td> the context for the connection to hald
3953
4304
</td>
3954
4305
</tr>
3955
4306
<tr>
3956
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4307
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
3957
4308
<td> the Unique Device Id
3958
4309
</td>
3959
4310
</tr>
3960
4311
<tr>
3961
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4312
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
3962
4313
<td> pointer to an initialized dbus error object for returning errors or NULL
3963
4314
</td>
3964
4315
</tr>
3965
4316
<tr>
3966
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4317
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
3967
4318
<td> TRUE if the device was successfully unlocked,
3968
4319
                             FALSE otherwise
3969
4320
</td>
3973
4324
</div>
3974
4325
<hr>
3975
4326
<div class="refsect2" lang="en">
3976
 
<a name="id2664017"></a><h3>
 
4327
<a name="id2978070"></a><h3>
3977
4328
<a name="libhal-device-rescan"></a>libhal_device_rescan ()</h3>
3978
 
<a class="indexterm" name="id2664031"></a><pre class="programlisting">dbus_bool_t         libhal_device_rescan                (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4329
<a class="indexterm" name="id2978083"></a><pre class="programlisting">dbus_bool_t         libhal_device_rescan                (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
3979
4330
                                                         const char *udi,
3980
4331
                                                         DBusError *error);</pre>
3981
4332
<p>
3987
4338
<col align="left" valign="top">
3988
4339
<tbody>
3989
4340
<tr>
3990
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4341
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
3991
4342
<td> the context for the connection to hald
3992
4343
</td>
3993
4344
</tr>
3994
4345
<tr>
3995
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4346
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
3996
4347
<td> the Unique id of device
3997
4348
</td>
3998
4349
</tr>
3999
4350
<tr>
4000
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4351
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
4001
4352
<td> pointer to an initialized dbus error object for returning errors or NULL
4002
4353
</td>
4003
4354
</tr>
4004
4355
<tr>
4005
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4356
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
4006
4357
<td> Whether the operation succeeded
4007
4358
</td>
4008
4359
</tr>
4011
4362
</div>
4012
4363
<hr>
4013
4364
<div class="refsect2" lang="en">
4014
 
<a name="id2664136"></a><h3>
 
4365
<a name="id2978189"></a><h3>
4015
4366
<a name="libhal-device-reprobe"></a>libhal_device_reprobe ()</h3>
4016
 
<a class="indexterm" name="id2664150"></a><pre class="programlisting">dbus_bool_t         libhal_device_reprobe               (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4367
<a class="indexterm" name="id2978203"></a><pre class="programlisting">dbus_bool_t         libhal_device_reprobe               (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
4017
4368
                                                         const char *udi,
4018
4369
                                                         DBusError *error);</pre>
4019
4370
<p>
4025
4376
<col align="left" valign="top">
4026
4377
<tbody>
4027
4378
<tr>
4028
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4379
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
4029
4380
<td> the context for the connection to hald
4030
4381
</td>
4031
4382
</tr>
4032
4383
<tr>
4033
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4384
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
4034
4385
<td> the Unique id of device
4035
4386
</td>
4036
4387
</tr>
4037
4388
<tr>
4038
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4389
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
4039
4390
<td> pointer to an initialized dbus error object for returning errors or NULL
4040
4391
</td>
4041
4392
</tr>
4042
4393
<tr>
4043
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4394
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
4044
4395
<td> Whether the operation succeeded
4045
4396
</td>
4046
4397
</tr>
4049
4400
</div>
4050
4401
<hr>
4051
4402
<div class="refsect2" lang="en">
4052
 
<a name="id2664256"></a><h3>
 
4403
<a name="id2978308"></a><h3>
4053
4404
<a name="libhal-device-emit-condition"></a>libhal_device_emit_condition ()</h3>
4054
 
<a class="indexterm" name="id2664270"></a><pre class="programlisting">dbus_bool_t         libhal_device_emit_condition        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4405
<a class="indexterm" name="id2978323"></a><pre class="programlisting">dbus_bool_t         libhal_device_emit_condition        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
4055
4406
                                                         const char *udi,
4056
4407
                                                         const char *condition_name,
4057
4408
                                                         const char *condition_details,
4065
4416
<col align="left" valign="top">
4066
4417
<tbody>
4067
4418
<tr>
4068
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4419
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
4069
4420
<td> the context for the connection to hald
4070
4421
</td>
4071
4422
</tr>
4072
4423
<tr>
4073
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4424
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
4074
4425
<td> the Unique Device Id
4075
4426
</td>
4076
4427
</tr>
4077
4428
<tr>
4078
 
<td><span class="term"><em class="parameter"><code>condition_name</code></em>&#160;:</span></td>
 
4429
<td><p><span class="term"><em class="parameter"><code>condition_name</code></em>&#160;:</span></p></td>
4079
4430
<td> user-readable name of condition
4080
4431
</td>
4081
4432
</tr>
4082
4433
<tr>
4083
 
<td><span class="term"><em class="parameter"><code>condition_details</code></em>&#160;:</span></td>
 
4434
<td><p><span class="term"><em class="parameter"><code>condition_details</code></em>&#160;:</span></p></td>
4084
4435
<td> user-readable details of condition
4085
4436
</td>
4086
4437
</tr>
4087
4438
<tr>
4088
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4439
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
4089
4440
<td> pointer to an initialized dbus error object for returning errors or NULL
4090
4441
</td>
4091
4442
</tr>
4092
4443
<tr>
4093
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4444
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
4094
4445
<td> TRUE if condition successfully emitted,
4095
4446
                             FALSE otherwise
4096
4447
</td>
4100
4451
</div>
4101
4452
<hr>
4102
4453
<div class="refsect2" lang="en">
4103
 
<a name="id2664422"></a><h3>
 
4454
<a name="id2978475"></a><h3>
4104
4455
<a name="libhal-device-claim-interface"></a>libhal_device_claim_interface ()</h3>
4105
 
<a class="indexterm" name="id2664436"></a><pre class="programlisting">dbus_bool_t         libhal_device_claim_interface       (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4456
<a class="indexterm" name="id2978488"></a><pre class="programlisting">dbus_bool_t         libhal_device_claim_interface       (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
4106
4457
                                                         const char *udi,
4107
4458
                                                         const char *interface_name,
4108
4459
                                                         const char *introspection_xml,
4118
4469
<col align="left" valign="top">
4119
4470
<tbody>
4120
4471
<tr>
4121
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4472
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
4122
4473
<td> the context for the connection to hald
4123
4474
</td>
4124
4475
</tr>
4125
4476
<tr>
4126
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4477
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
4127
4478
<td> the Unique Device Id
4128
4479
</td>
4129
4480
</tr>
4130
4481
<tr>
4131
 
<td><span class="term"><em class="parameter"><code>interface_name</code></em>&#160;:</span></td>
 
4482
<td><p><span class="term"><em class="parameter"><code>interface_name</code></em>&#160;:</span></p></td>
4132
4483
<td> Name of interface to claim, e.g. org.freedesktop.Hal.Device.FoobarKindOfThing
4133
4484
</td>
4134
4485
</tr>
4135
4486
<tr>
4136
 
<td><span class="term"><em class="parameter"><code>introspection_xml</code></em>&#160;:</span></td>
 
4487
<td><p><span class="term"><em class="parameter"><code>introspection_xml</code></em>&#160;:</span></p></td>
4137
4488
<td> Introspection XML containing what would be inside the interface XML tag
4138
4489
</td>
4139
4490
</tr>
4140
4491
<tr>
4141
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4492
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
4142
4493
<td> pointer to an initialized dbus error object for returning errors or NULL
4143
4494
</td>
4144
4495
</tr>
4145
4496
<tr>
4146
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4497
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
4147
4498
<td> TRUE if interface was claimed, FALSE otherwise
4148
4499
</td>
4149
4500
</tr>
4152
4503
</div>
4153
4504
<hr>
4154
4505
<div class="refsect2" lang="en">
4155
 
<a name="id2664590"></a><h3>
 
4506
<a name="id2978642"></a><h3>
4156
4507
<a name="libhal-device-addon-is-ready"></a>libhal_device_addon_is_ready ()</h3>
4157
 
<a class="indexterm" name="id2664604"></a><pre class="programlisting">dbus_bool_t         libhal_device_addon_is_ready        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4508
<a class="indexterm" name="id2978656"></a><pre class="programlisting">dbus_bool_t         libhal_device_addon_is_ready        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
4158
4509
                                                         const char *udi,
4159
4510
                                                         DBusError *error);</pre>
4160
4511
<p>
4170
4521
<col align="left" valign="top">
4171
4522
<tbody>
4172
4523
<tr>
4173
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
4174
 
<td> the context for the connection to hald
4175
 
</td>
4176
 
</tr>
4177
 
<tr>
4178
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
4179
 
<td> the Unique Device Id
4180
 
</td>
4181
 
</tr>
4182
 
<tr>
4183
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
4184
 
<td> pointer to an initialized dbus error object for returning errors or NULL
4185
 
</td>
4186
 
</tr>
4187
 
<tr>
4188
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
4189
 
<td> TRUE if the HAL daemon received the message, FALSE otherwise
4190
 
</td>
4191
 
</tr>
4192
 
</tbody>
4193
 
</table></div>
4194
 
</div>
4195
 
<hr>
4196
 
<div class="refsect2" lang="en">
4197
 
<a name="id2664717"></a><h3>
 
4524
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
 
4525
<td> the context for the connection to hald
 
4526
</td>
 
4527
</tr>
 
4528
<tr>
 
4529
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
 
4530
<td> the Unique Device Id this addon is handling
 
4531
</td>
 
4532
</tr>
 
4533
<tr>
 
4534
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
 
4535
<td> pointer to an initialized dbus error object for returning errors or NULL
 
4536
</td>
 
4537
</tr>
 
4538
<tr>
 
4539
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
4540
<td> TRUE if the HAL daemon received the message, FALSE otherwise
 
4541
</td>
 
4542
</tr>
 
4543
</tbody>
 
4544
</table></div>
 
4545
</div>
 
4546
<hr>
 
4547
<div class="refsect2" lang="en">
 
4548
<a name="id2978770"></a><h3>
 
4549
<a name="libhal-device-singleton-addon-is-ready"></a>libhal_device_singleton_addon_is_ready ()</h3>
 
4550
<a class="indexterm" name="id2978784"></a><pre class="programlisting">dbus_bool_t         libhal_device_singleton_addon_is_ready
 
4551
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4552
                                                         const char *command_line,
 
4553
                                                         DBusError *error);</pre>
 
4554
<p>
 
4555
HAL singleton addon's must call this method when they are done initializing the device object. The HAL
 
4556
daemon will wait for all addon's to call this.
 
4557
</p>
 
4558
<p>
 
4559
Can only be used from hald helpers.</p>
 
4560
<p>
 
4561
 
 
4562
</p>
 
4563
<div class="variablelist"><table border="0">
 
4564
<col align="left" valign="top">
 
4565
<tbody>
 
4566
<tr>
 
4567
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
 
4568
<td> the context for the connection to hald
 
4569
</td>
 
4570
</tr>
 
4571
<tr>
 
4572
<td><p><span class="term"><em class="parameter"><code>command_line</code></em>&#160;:</span></p></td>
 
4573
<td> commandline singleton was started with
 
4574
</td>
 
4575
</tr>
 
4576
<tr>
 
4577
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
 
4578
<td> pointer to an initialized dbus error object for returning errors or NULL
 
4579
</td>
 
4580
</tr>
 
4581
<tr>
 
4582
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
4583
<td> TRUE if the HAL daemon received the message, FALSE otherwise
 
4584
</td>
 
4585
</tr>
 
4586
</tbody>
 
4587
</table></div>
 
4588
</div>
 
4589
<hr>
 
4590
<div class="refsect2" lang="en">
 
4591
<a name="id2978899"></a><h3>
4198
4592
<a name="libhal-device-acquire-interface-lock"></a>libhal_device_acquire_interface_lock ()</h3>
4199
 
<a class="indexterm" name="id2664731"></a><pre class="programlisting">dbus_bool_t         libhal_device_acquire_interface_lock
4200
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4593
<a class="indexterm" name="id2978913"></a><pre class="programlisting">dbus_bool_t         libhal_device_acquire_interface_lock
 
4594
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
4201
4595
                                                         const char *udi,
4202
4596
                                                         const char *interface,
4203
4597
                                                         dbus_bool_t exclusive,
4211
4605
<col align="left" valign="top">
4212
4606
<tbody>
4213
4607
<tr>
4214
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4608
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
4215
4609
<td> the context for the connection to hald
4216
4610
</td>
4217
4611
</tr>
4218
4612
<tr>
4219
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4613
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
4220
4614
<td> the Unique id of device
4221
4615
</td>
4222
4616
</tr>
4223
4617
<tr>
4224
 
<td><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></td>
 
4618
<td><p><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></p></td>
4225
4619
<td> the intername name to lock
4226
4620
</td>
4227
4621
</tr>
4228
4622
<tr>
4229
 
<td><span class="term"><em class="parameter"><code>exclusive</code></em>&#160;:</span></td>
 
4623
<td><p><span class="term"><em class="parameter"><code>exclusive</code></em>&#160;:</span></p></td>
4230
4624
<td> whether the lock should be exclusive
4231
4625
</td>
4232
4626
</tr>
4233
4627
<tr>
4234
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4628
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
4235
4629
<td> pointer to an initialized dbus error object for returning errors
4236
4630
</td>
4237
4631
</tr>
4238
4632
<tr>
4239
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4633
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
4240
4634
<td> TRUE iff the lock was acquired
4241
4635
</td>
4242
4636
</tr>
4245
4639
</div>
4246
4640
<hr>
4247
4641
<div class="refsect2" lang="en">
4248
 
<a name="id2664883"></a><h3>
 
4642
<a name="id2979065"></a><h3>
4249
4643
<a name="libhal-device-release-interface-lock"></a>libhal_device_release_interface_lock ()</h3>
4250
 
<a class="indexterm" name="id2664897"></a><pre class="programlisting">dbus_bool_t         libhal_device_release_interface_lock
4251
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4644
<a class="indexterm" name="id2979079"></a><pre class="programlisting">dbus_bool_t         libhal_device_release_interface_lock
 
4645
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
4252
4646
                                                         const char *udi,
4253
4647
                                                         const char *interface,
4254
4648
                                                         DBusError *error);</pre>
4261
4655
<col align="left" valign="top">
4262
4656
<tbody>
4263
4657
<tr>
4264
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4658
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
4265
4659
<td> the context for the connection to hald
4266
4660
</td>
4267
4661
</tr>
4268
4662
<tr>
4269
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4663
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
4270
4664
<td> the Unique id of device
4271
4665
</td>
4272
4666
</tr>
4273
4667
<tr>
4274
 
<td><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></td>
 
4668
<td><p><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></p></td>
4275
4669
<td> the intername name to unlock
4276
4670
</td>
4277
4671
</tr>
4278
4672
<tr>
4279
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4673
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
4280
4674
<td> pointer to an initialized dbus error object for returning errors
4281
4675
</td>
4282
4676
</tr>
4283
4677
<tr>
4284
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4678
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
4285
4679
<td> TRUE iff the lock was released.
4286
4680
</td>
4287
4681
</tr>
4290
4684
</div>
4291
4685
<hr>
4292
4686
<div class="refsect2" lang="en">
4293
 
<a name="id2665026"></a><h3>
 
4687
<a name="id2979208"></a><h3>
4294
4688
<a name="libhal-acquire-global-interface-lock"></a>libhal_acquire_global_interface_lock ()</h3>
4295
 
<a class="indexterm" name="id2665040"></a><pre class="programlisting">dbus_bool_t         libhal_acquire_global_interface_lock
4296
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4689
<a class="indexterm" name="id2979222"></a><pre class="programlisting">dbus_bool_t         libhal_acquire_global_interface_lock
 
4690
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
4297
4691
                                                         const char *interface,
4298
4692
                                                         dbus_bool_t exclusive,
4299
4693
                                                         DBusError *error);</pre>
4306
4700
<col align="left" valign="top">
4307
4701
<tbody>
4308
4702
<tr>
4309
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4703
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
4310
4704
<td> the context for the connection to hald
4311
4705
</td>
4312
4706
</tr>
4313
4707
<tr>
4314
 
<td><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></td>
 
4708
<td><p><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></p></td>
4315
4709
<td> the intername name to lock
4316
4710
</td>
4317
4711
</tr>
4318
4712
<tr>
4319
 
<td><span class="term"><em class="parameter"><code>exclusive</code></em>&#160;:</span></td>
 
4713
<td><p><span class="term"><em class="parameter"><code>exclusive</code></em>&#160;:</span></p></td>
4320
4714
<td> whether the lock should be exclusive
4321
4715
</td>
4322
4716
</tr>
4323
4717
<tr>
4324
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4718
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
4325
4719
<td> pointer to an initialized dbus error object for returning errors
4326
4720
</td>
4327
4721
</tr>
4328
4722
<tr>
4329
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4723
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
4330
4724
<td> TRUE iff the lock was acquired
4331
4725
</td>
4332
4726
</tr>
4335
4729
</div>
4336
4730
<hr>
4337
4731
<div class="refsect2" lang="en">
4338
 
<a name="id2665170"></a><h3>
 
4732
<a name="id2979352"></a><h3>
4339
4733
<a name="libhal-release-global-interface-lock"></a>libhal_release_global_interface_lock ()</h3>
4340
 
<a class="indexterm" name="id2665184"></a><pre class="programlisting">dbus_bool_t         libhal_release_global_interface_lock
4341
 
                                                        (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4734
<a class="indexterm" name="id2979366"></a><pre class="programlisting">dbus_bool_t         libhal_release_global_interface_lock
 
4735
                                                        (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
4342
4736
                                                         const char *interface,
4343
4737
                                                         DBusError *error);</pre>
4344
4738
<p>
4350
4744
<col align="left" valign="top">
4351
4745
<tbody>
4352
4746
<tr>
4353
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4747
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
4354
4748
<td> the context for the connection to hald
4355
4749
</td>
4356
4750
</tr>
4357
4751
<tr>
4358
 
<td><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></td>
 
4752
<td><p><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></p></td>
4359
4753
<td> the intername name to unlock
4360
4754
</td>
4361
4755
</tr>
4362
4756
<tr>
4363
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4757
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
4364
4758
<td> pointer to an initialized dbus error object for returning errors
4365
4759
</td>
4366
4760
</tr>
4367
4761
<tr>
4368
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4762
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
4369
4763
<td> TRUE iff the lock was released
4370
4764
</td>
4371
4765
</tr>
4374
4768
</div>
4375
4769
<hr>
4376
4770
<div class="refsect2" lang="en">
4377
 
<a name="id2665292"></a><h3>
 
4771
<a name="id2979473"></a><h3>
4378
4772
<a name="libhal-device-is-caller-locked-out"></a>libhal_device_is_caller_locked_out ()</h3>
4379
 
<a class="indexterm" name="id2665307"></a><pre class="programlisting">dbus_bool_t         libhal_device_is_caller_locked_out  (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4773
<a class="indexterm" name="id2979488"></a><pre class="programlisting">dbus_bool_t         libhal_device_is_caller_locked_out  (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
4380
4774
                                                         const char *udi,
4381
4775
                                                         const char *interface,
4382
4776
                                                         const char *caller,
4392
4786
<col align="left" valign="top">
4393
4787
<tbody>
4394
4788
<tr>
4395
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4789
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
4396
4790
<td> the context for the connection to hald
4397
4791
</td>
4398
4792
</tr>
4399
4793
<tr>
4400
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4794
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
4401
4795
<td> the Unique id of device
4402
4796
</td>
4403
4797
</tr>
4404
4798
<tr>
4405
 
<td><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></td>
 
4799
<td><p><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></p></td>
4406
4800
<td> the intername name to check
4407
4801
</td>
4408
4802
</tr>
4409
4803
<tr>
4410
 
<td><span class="term"><em class="parameter"><code>caller</code></em>&#160;:</span></td>
 
4804
<td><p><span class="term"><em class="parameter"><code>caller</code></em>&#160;:</span></p></td>
4411
4805
<td> the caller to check for
4412
4806
</td>
4413
4807
</tr>
4414
4808
<tr>
4415
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4809
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
4416
4810
<td> pointer to an initialized dbus error object for returning errors
4417
4811
</td>
4418
4812
</tr>
4419
4813
<tr>
4420
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4814
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
4421
4815
<td> Whether the given caller is locked out
4422
4816
</td>
4423
4817
</tr>
4426
4820
</div>
4427
4821
<hr>
4428
4822
<div class="refsect2" lang="en">
4429
 
<a name="id2665458"></a><h3>
 
4823
<a name="id2979639"></a><h3>
4430
4824
<a name="libhal-device-is-locked-by-others"></a>libhal_device_is_locked_by_others ()</h3>
4431
 
<a class="indexterm" name="id2665472"></a><pre class="programlisting">dbus_bool_t         libhal_device_is_locked_by_others   (<a href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4825
<a class="indexterm" name="id2979654"></a><pre class="programlisting">dbus_bool_t         libhal_device_is_locked_by_others   (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
4432
4826
                                                         const char *udi,
4433
4827
                                                         const char *interface,
4434
4828
                                                         DBusError *error);</pre>
4441
4835
<col align="left" valign="top">
4442
4836
<tbody>
4443
4837
<tr>
4444
 
<td><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></td>
 
4838
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
4445
4839
<td> the context for the connection to hald
4446
4840
</td>
4447
4841
</tr>
4448
4842
<tr>
4449
 
<td><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></td>
 
4843
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
4450
4844
<td> the Unique id of device
4451
4845
</td>
4452
4846
</tr>
4453
4847
<tr>
4454
 
<td><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></td>
 
4848
<td><p><span class="term"><em class="parameter"><code>interface</code></em>&#160;:</span></p></td>
4455
4849
<td> the intername name to check
4456
4850
</td>
4457
4851
</tr>
4458
4852
<tr>
4459
 
<td><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></td>
 
4853
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
4460
4854
<td> pointer to an initialized dbus error object for returning errors or NULL
4461
4855
</td>
4462
4856
</tr>
4463
4857
<tr>
4464
 
<td><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></td>
 
4858
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
4465
4859
<td> If another process is holding a lock on the device
4466
4860
</td>
4467
4861
</tr>
4468
4862
</tbody>
4469
4863
</table></div>
4470
4864
</div>
 
4865
<hr>
 
4866
<div class="refsect2" lang="en">
 
4867
<a name="id2979783"></a><h3>
 
4868
<a name="libhal-device-is-caller-privileged"></a>libhal_device_is_caller_privileged ()</h3>
 
4869
<a class="indexterm" name="id2979798"></a><pre class="programlisting">char*               libhal_device_is_caller_privileged  (<a class="link" href="libhal-libhal.html#LibHalContext">LibHalContext</a> *ctx,
 
4870
                                                         const char *udi,
 
4871
                                                         const char *action,
 
4872
                                                         const char *caller,
 
4873
                                                         DBusError *error);</pre>
 
4874
<p>
 
4875
Determines if a given caller have a given privilege on a given
 
4876
device. Will always error out if HAL is not built with PolicyKit
 
4877
support.</p>
 
4878
<p>
 
4879
 
 
4880
</p>
 
4881
<div class="variablelist"><table border="0">
 
4882
<col align="left" valign="top">
 
4883
<tbody>
 
4884
<tr>
 
4885
<td><p><span class="term"><em class="parameter"><code>ctx</code></em>&#160;:</span></p></td>
 
4886
<td> the context for the connection to hald
 
4887
</td>
 
4888
</tr>
 
4889
<tr>
 
4890
<td><p><span class="term"><em class="parameter"><code>udi</code></em>&#160;:</span></p></td>
 
4891
<td> the Unique id of device
 
4892
</td>
 
4893
</tr>
 
4894
<tr>
 
4895
<td><p><span class="term"><em class="parameter"><code>action</code></em>&#160;:</span></p></td>
 
4896
<td> the action to check for
 
4897
</td>
 
4898
</tr>
 
4899
<tr>
 
4900
<td><p><span class="term"><em class="parameter"><code>caller</code></em>&#160;:</span></p></td>
 
4901
<td> the caller to check for
 
4902
</td>
 
4903
</tr>
 
4904
<tr>
 
4905
<td><p><span class="term"><em class="parameter"><code>error</code></em>&#160;:</span></p></td>
 
4906
<td> pointer to an initialized dbus error object for returning errors
 
4907
</td>
 
4908
</tr>
 
4909
<tr>
 
4910
<td><p><span class="term"><span class="emphasis"><em>Returns</em></span>&#160;:</span></p></td>
 
4911
<td> The textual reply from PolicyKit. See the <span class="type">PolicyKitResult</span>
 
4912
enumeration in the PolicyKit documentation for details. The caller
 
4913
is responsible for freeing this string with the function
 
4914
<a class="link" href="libhal-libhal.html#libhal-free-string"><code class="function">libhal_free_string()</code></a>.
 
4915
</td>
 
4916
</tr>
 
4917
</tbody>
 
4918
</table></div>
 
4919
</div>
4471
4920
</div>
4472
4921
</div>
4473
4922
</body>