1 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
---|
2 | <html>
|
---|
3 | <head>
|
---|
4 | <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
---|
5 | <title>GUdevClient</title>
|
---|
6 | <meta name="generator" content="DocBook XSL Stylesheets V1.77.1">
|
---|
7 | <link rel="home" href="index.html" title="GUdev Reference Manual">
|
---|
8 | <link rel="up" href="ref-API.html" title="API Reference">
|
---|
9 | <link rel="prev" href="ref-API.html" title="API Reference">
|
---|
10 | <link rel="next" href="GUdevDevice.html" title="GUdevDevice">
|
---|
11 | <meta name="generator" content="GTK-Doc V1.18 (XML mode)">
|
---|
12 | <link rel="stylesheet" href="style.css" type="text/css">
|
---|
13 | </head>
|
---|
14 | <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
---|
15 | <table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="2">
|
---|
16 | <tr valign="middle">
|
---|
17 | <td><a accesskey="p" href="ref-API.html"><img src="left.png" width="24" height="24" border="0" alt="Prev"></a></td>
|
---|
18 | <td><a accesskey="u" href="ref-API.html"><img src="up.png" width="24" height="24" border="0" alt="Up"></a></td>
|
---|
19 | <td><a accesskey="h" href="index.html"><img src="home.png" width="24" height="24" border="0" alt="Home"></a></td>
|
---|
20 | <th width="100%" align="center">GUdev Reference Manual</th>
|
---|
21 | <td><a accesskey="n" href="GUdevDevice.html"><img src="right.png" width="24" height="24" border="0" alt="Next"></a></td>
|
---|
22 | </tr>
|
---|
23 | <tr><td colspan="5" class="shortcuts">
|
---|
24 | <a href="#GUdevClient.synopsis" class="shortcut">Top</a>
|
---|
25 | |
|
---|
26 | <a href="#GUdevClient.description" class="shortcut">Description</a>
|
---|
27 | |
|
---|
28 | <a href="#GUdevClient.object-hierarchy" class="shortcut">Object Hierarchy</a>
|
---|
29 | |
|
---|
30 | <a href="#GUdevClient.properties" class="shortcut">Properties</a>
|
---|
31 | |
|
---|
32 | <a href="#GUdevClient.signals" class="shortcut">Signals</a>
|
---|
33 | </td></tr>
|
---|
34 | </table>
|
---|
35 | <div class="refentry">
|
---|
36 | <a name="GUdevClient"></a><div class="titlepage"></div>
|
---|
37 | <div class="refnamediv"><table width="100%"><tr>
|
---|
38 | <td valign="top">
|
---|
39 | <h2><span class="refentrytitle"><a name="GUdevClient.top_of_page"></a>GUdevClient</span></h2>
|
---|
40 | <p>GUdevClient — Query devices and listen to uevents</p>
|
---|
41 | </td>
|
---|
42 | <td valign="top" align="right"></td>
|
---|
43 | </tr></table></div>
|
---|
44 | <div class="refsynopsisdiv">
|
---|
45 | <a name="GUdevClient.synopsis"></a><h2>Synopsis</h2>
|
---|
46 | <a name="GUdevDeviceType"></a><pre class="synopsis"> <a class="link" href="GUdevClient.html#GUdevClient-struct" title="GUdevClient">GUdevClient</a>;
|
---|
47 | struct <a class="link" href="GUdevClient.html#GUdevClientClass" title="struct GUdevClientClass">GUdevClientClass</a>;
|
---|
48 | enum <a class="link" href="GUdevClient.html#GUdevDeviceType-enum" title="enum GUdevDeviceType">GUdevDeviceType</a>;
|
---|
49 | typedef <a class="link" href="GUdevClient.html#GUdevDeviceNumber" title="GUdevDeviceNumber">GUdevDeviceNumber</a>;
|
---|
50 | <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="returnvalue">GUdevClient</span></a> * <a class="link" href="GUdevClient.html#g-udev-client-new" title="g_udev_client_new ()">g_udev_client_new</a> (<em class="parameter"><code>const <span class="type">gchar</span> * const *subsystems</code></em>);
|
---|
51 | <span class="returnvalue">GList</span> * <a class="link" href="GUdevClient.html#g-udev-client-query-by-subsystem" title="g_udev_client_query_by_subsystem ()">g_udev_client_query_by_subsystem</a> (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>,
|
---|
52 | <em class="parameter"><code>const <span class="type">gchar</span> *subsystem</code></em>);
|
---|
53 | <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="returnvalue">GUdevDevice</span></a> * <a class="link" href="GUdevClient.html#g-udev-client-query-by-device-number" title="g_udev_client_query_by_device_number ()">g_udev_client_query_by_device_number</a>
|
---|
54 | (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>,
|
---|
55 | <em class="parameter"><code><a class="link" href="GUdevClient.html#GUdevDeviceType"><span class="type">GUdevDeviceType</span></a> type</code></em>,
|
---|
56 | <em class="parameter"><code><a class="link" href="GUdevClient.html#GUdevDeviceNumber" title="GUdevDeviceNumber"><span class="type">GUdevDeviceNumber</span></a> number</code></em>);
|
---|
57 | <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="returnvalue">GUdevDevice</span></a> * <a class="link" href="GUdevClient.html#g-udev-client-query-by-device-file" title="g_udev_client_query_by_device_file ()">g_udev_client_query_by_device_file</a> (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>,
|
---|
58 | <em class="parameter"><code>const <span class="type">gchar</span> *device_file</code></em>);
|
---|
59 | <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="returnvalue">GUdevDevice</span></a> * <a class="link" href="GUdevClient.html#g-udev-client-query-by-sysfs-path" title="g_udev_client_query_by_sysfs_path ()">g_udev_client_query_by_sysfs_path</a> (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>,
|
---|
60 | <em class="parameter"><code>const <span class="type">gchar</span> *sysfs_path</code></em>);
|
---|
61 | <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="returnvalue">GUdevDevice</span></a> * <a class="link" href="GUdevClient.html#g-udev-client-query-by-subsystem-and-name" title="g_udev_client_query_by_subsystem_and_name ()">g_udev_client_query_by_subsystem_and_name</a>
|
---|
62 | (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>,
|
---|
63 | <em class="parameter"><code>const <span class="type">gchar</span> *subsystem</code></em>,
|
---|
64 | <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);
|
---|
65 | </pre>
|
---|
66 | </div>
|
---|
67 | <div class="refsect1">
|
---|
68 | <a name="GUdevClient.object-hierarchy"></a><h2>Object Hierarchy</h2>
|
---|
69 | <pre class="synopsis">
|
---|
70 | GObject
|
---|
71 | +----GUdevClient
|
---|
72 | </pre>
|
---|
73 | <pre class="synopsis">
|
---|
74 | GEnum
|
---|
75 | +----GUdevDeviceType
|
---|
76 | </pre>
|
---|
77 | </div>
|
---|
78 | <div class="refsect1">
|
---|
79 | <a name="GUdevClient.properties"></a><h2>Properties</h2>
|
---|
80 | <pre class="synopsis">
|
---|
81 | "<a class="link" href="GUdevClient.html#GUdevClient--subsystems" title='The "subsystems" property'>subsystems</a>" <span class="type">GStrv</span> : Read / Write / Construct Only
|
---|
82 | </pre>
|
---|
83 | </div>
|
---|
84 | <div class="refsect1">
|
---|
85 | <a name="GUdevClient.signals"></a><h2>Signals</h2>
|
---|
86 | <pre class="synopsis">
|
---|
87 | "<a class="link" href="GUdevClient.html#GUdevClient-uevent" title='The "uevent" signal'>uevent</a>" : <code class="literal">Run Last</code>
|
---|
88 | </pre>
|
---|
89 | </div>
|
---|
90 | <div class="refsect1">
|
---|
91 | <a name="GUdevClient.description"></a><h2>Description</h2>
|
---|
92 | <p>
|
---|
93 | <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> is used to query information about devices on a Linux
|
---|
94 | system from the Linux kernel and the udev device
|
---|
95 | manager.
|
---|
96 | </p>
|
---|
97 | <p>
|
---|
98 | Device information is retrieved from the kernel (through the
|
---|
99 | <code class="literal">sysfs</code> filesystem) and the udev daemon (through a
|
---|
100 | <code class="literal">tmpfs</code> filesystem) and presented through
|
---|
101 | <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="type">GUdevDevice</span></a> objects. This means that no blocking IO ever happens
|
---|
102 | (in both cases, we are essentially just reading data from kernel
|
---|
103 | memory) and as such there are no asynchronous versions of the
|
---|
104 | provided methods.
|
---|
105 | </p>
|
---|
106 | <p>
|
---|
107 | To get <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="type">GUdevDevice</span></a> objects, use
|
---|
108 | <a class="link" href="GUdevClient.html#g-udev-client-query-by-subsystem" title="g_udev_client_query_by_subsystem ()"><code class="function">g_udev_client_query_by_subsystem()</code></a>,
|
---|
109 | <a class="link" href="GUdevClient.html#g-udev-client-query-by-device-number" title="g_udev_client_query_by_device_number ()"><code class="function">g_udev_client_query_by_device_number()</code></a>,
|
---|
110 | <a class="link" href="GUdevClient.html#g-udev-client-query-by-device-file" title="g_udev_client_query_by_device_file ()"><code class="function">g_udev_client_query_by_device_file()</code></a>,
|
---|
111 | <a class="link" href="GUdevClient.html#g-udev-client-query-by-sysfs-path" title="g_udev_client_query_by_sysfs_path ()"><code class="function">g_udev_client_query_by_sysfs_path()</code></a>,
|
---|
112 | <a class="link" href="GUdevClient.html#g-udev-client-query-by-subsystem-and-name" title="g_udev_client_query_by_subsystem_and_name ()"><code class="function">g_udev_client_query_by_subsystem_and_name()</code></a>
|
---|
113 | or the <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> type.
|
---|
114 | </p>
|
---|
115 | <p>
|
---|
116 | To listen to uevents, connect to the <a class="link" href="GUdevClient.html#GUdevClient-uevent" title='The "uevent" signal'><span class="type">"uevent"</span></a> signal.
|
---|
117 | </p>
|
---|
118 | </div>
|
---|
119 | <div class="refsect1">
|
---|
120 | <a name="GUdevClient.details"></a><h2>Details</h2>
|
---|
121 | <div class="refsect2">
|
---|
122 | <a name="GUdevClient-struct"></a><h3>GUdevClient</h3>
|
---|
123 | <pre class="programlisting">typedef struct _GUdevClient GUdevClient;</pre>
|
---|
124 | <p>
|
---|
125 | The <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> struct is opaque and should not be accessed directly.
|
---|
126 | </p>
|
---|
127 | </div>
|
---|
128 | <hr>
|
---|
129 | <div class="refsect2">
|
---|
130 | <a name="GUdevClientClass"></a><h3>struct GUdevClientClass</h3>
|
---|
131 | <pre class="programlisting">struct GUdevClientClass {
|
---|
132 | GObjectClass parent_class;
|
---|
133 |
|
---|
134 | /* signals */
|
---|
135 | void (*uevent) (GUdevClient *client,
|
---|
136 | const gchar *action,
|
---|
137 | GUdevDevice *device);
|
---|
138 | };
|
---|
139 | </pre>
|
---|
140 | <p>
|
---|
141 | Class structure for <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a>.
|
---|
142 | </p>
|
---|
143 | <div class="variablelist"><table border="0" class="variablelist">
|
---|
144 | <colgroup>
|
---|
145 | <col align="left" valign="top">
|
---|
146 | <col>
|
---|
147 | </colgroup>
|
---|
148 | <tbody>
|
---|
149 | <tr>
|
---|
150 | <td><p><span class="term"><span class="type">GObjectClass</span> <em class="structfield"><code><a name="GUdevClientClass.parent-class"></a>parent_class</code></em>;</span></p></td>
|
---|
151 | <td>Parent class.</td>
|
---|
152 | </tr>
|
---|
153 | <tr>
|
---|
154 | <td><p><span class="term"><em class="structfield"><code><a name="GUdevClientClass.uevent"></a>uevent</code></em> ()</span></p></td>
|
---|
155 | <td>Signal class handler for the <a class="link" href="GUdevClient.html#GUdevClient-uevent" title='The "uevent" signal'><span class="type">"uevent"</span></a> signal.</td>
|
---|
156 | </tr>
|
---|
157 | </tbody>
|
---|
158 | </table></div>
|
---|
159 | </div>
|
---|
160 | <hr>
|
---|
161 | <div class="refsect2">
|
---|
162 | <a name="GUdevDeviceType-enum"></a><h3>enum GUdevDeviceType</h3>
|
---|
163 | <pre class="programlisting">typedef enum {
|
---|
164 | G_UDEV_DEVICE_TYPE_NONE = 0,
|
---|
165 | G_UDEV_DEVICE_TYPE_BLOCK = 'b',
|
---|
166 | G_UDEV_DEVICE_TYPE_CHAR = 'c',
|
---|
167 | } GUdevDeviceType;
|
---|
168 | </pre>
|
---|
169 | <p>
|
---|
170 | Enumeration used to specify a the type of a device.
|
---|
171 | </p>
|
---|
172 | <div class="variablelist"><table border="0" class="variablelist">
|
---|
173 | <colgroup>
|
---|
174 | <col align="left" valign="top">
|
---|
175 | <col>
|
---|
176 | </colgroup>
|
---|
177 | <tbody>
|
---|
178 | <tr>
|
---|
179 | <td><p><a name="G-UDEV-DEVICE-TYPE-NONE:CAPS"></a><span class="term"><code class="literal">G_UDEV_DEVICE_TYPE_NONE</code></span></p></td>
|
---|
180 | <td>Device does not have a device file.
|
---|
181 | </td>
|
---|
182 | </tr>
|
---|
183 | <tr>
|
---|
184 | <td><p><a name="G-UDEV-DEVICE-TYPE-BLOCK:CAPS"></a><span class="term"><code class="literal">G_UDEV_DEVICE_TYPE_BLOCK</code></span></p></td>
|
---|
185 | <td>Device is a block device.
|
---|
186 | </td>
|
---|
187 | </tr>
|
---|
188 | <tr>
|
---|
189 | <td><p><a name="G-UDEV-DEVICE-TYPE-CHAR:CAPS"></a><span class="term"><code class="literal">G_UDEV_DEVICE_TYPE_CHAR</code></span></p></td>
|
---|
190 | <td>Device is a character device.
|
---|
191 | </td>
|
---|
192 | </tr>
|
---|
193 | </tbody>
|
---|
194 | </table></div>
|
---|
195 | </div>
|
---|
196 | <hr>
|
---|
197 | <div class="refsect2">
|
---|
198 | <a name="GUdevDeviceNumber"></a><h3>GUdevDeviceNumber</h3>
|
---|
199 | <pre class="programlisting">typedef guint64 GUdevDeviceNumber; /* __UQUAD_TYPE */
|
---|
200 | </pre>
|
---|
201 | <p>
|
---|
202 | Corresponds to the standard <span class="type">dev_t</span> type as defined by POSIX (Until
|
---|
203 | bug 584517 is resolved this work-around is needed).
|
---|
204 | </p>
|
---|
205 | </div>
|
---|
206 | <hr>
|
---|
207 | <div class="refsect2">
|
---|
208 | <a name="g-udev-client-new"></a><h3>g_udev_client_new ()</h3>
|
---|
209 | <pre class="programlisting"><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="returnvalue">GUdevClient</span></a> * g_udev_client_new (<em class="parameter"><code>const <span class="type">gchar</span> * const *subsystems</code></em>);</pre>
|
---|
210 | <p>
|
---|
211 | Constructs a <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> object that can be used to query
|
---|
212 | information about devices. Connect to the <a class="link" href="GUdevClient.html#GUdevClient-uevent" title='The "uevent" signal'><span class="type">"uevent"</span></a>
|
---|
213 | signal to listen for uevents. Note that signals are emitted in the
|
---|
214 | thread-default main loop
|
---|
215 | of the thread that you call this constructor from.
|
---|
216 | </p>
|
---|
217 | <div class="variablelist"><table border="0" class="variablelist">
|
---|
218 | <colgroup>
|
---|
219 | <col align="left" valign="top">
|
---|
220 | <col>
|
---|
221 | </colgroup>
|
---|
222 | <tbody>
|
---|
223 | <tr>
|
---|
224 | <td><p><span class="term"><em class="parameter"><code>subsystems</code></em> :</span></p></td>
|
---|
225 | <td>A <code class="literal">NULL</code> terminated string array of subsystems to listen for uevents on, <code class="literal">NULL</code> to not listen on uevents at all, or an empty array to listen to uevents on all subsystems. See the documentation for the <a class="link" href="GUdevClient.html#GUdevClient--subsystems" title='The "subsystems" property'><span class="type">"subsystems"</span></a> property for details on this parameter. <span class="annotation">[<acronym title="Parameter points to an array of items."><span class="acronym">array</span></acronym> zero-terminated=1][<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> utf8][<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>][<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
|
---|
226 | </td>
|
---|
227 | </tr>
|
---|
228 | <tr>
|
---|
229 | <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
---|
230 | <td>A new <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> object. Free with <code class="function">g_object_unref()</code>.</td>
|
---|
231 | </tr>
|
---|
232 | </tbody>
|
---|
233 | </table></div>
|
---|
234 | </div>
|
---|
235 | <hr>
|
---|
236 | <div class="refsect2">
|
---|
237 | <a name="g-udev-client-query-by-subsystem"></a><h3>g_udev_client_query_by_subsystem ()</h3>
|
---|
238 | <pre class="programlisting"><span class="returnvalue">GList</span> * g_udev_client_query_by_subsystem (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>,
|
---|
239 | <em class="parameter"><code>const <span class="type">gchar</span> *subsystem</code></em>);</pre>
|
---|
240 | <p>
|
---|
241 | Gets all devices belonging to <em class="parameter"><code>subsystem</code></em>.
|
---|
242 | </p>
|
---|
243 | <div class="variablelist"><table border="0" class="variablelist">
|
---|
244 | <colgroup>
|
---|
245 | <col align="left" valign="top">
|
---|
246 | <col>
|
---|
247 | </colgroup>
|
---|
248 | <tbody>
|
---|
249 | <tr>
|
---|
250 | <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
|
---|
251 | <td>A <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a>.</td>
|
---|
252 | </tr>
|
---|
253 | <tr>
|
---|
254 | <td><p><span class="term"><em class="parameter"><code>subsystem</code></em> :</span></p></td>
|
---|
255 | <td>The subsystem to get devices for or <code class="literal">NULL</code> to get all devices. <span class="annotation">[<acronym title="NULL is ok, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span>
|
---|
256 | </td>
|
---|
257 | </tr>
|
---|
258 | <tr>
|
---|
259 | <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
---|
260 | <td>A list of <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="type">GUdevDevice</span></a> objects. The caller should free the result by using <code class="function">g_object_unref()</code> on each element in the list and then <code class="function">g_list_free()</code> on the list. <span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GUdevDevice][<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
---|
261 | </td>
|
---|
262 | </tr>
|
---|
263 | </tbody>
|
---|
264 | </table></div>
|
---|
265 | </div>
|
---|
266 | <hr>
|
---|
267 | <div class="refsect2">
|
---|
268 | <a name="g-udev-client-query-by-device-number"></a><h3>g_udev_client_query_by_device_number ()</h3>
|
---|
269 | <pre class="programlisting"><a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="returnvalue">GUdevDevice</span></a> * g_udev_client_query_by_device_number
|
---|
270 | (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>,
|
---|
271 | <em class="parameter"><code><a class="link" href="GUdevClient.html#GUdevDeviceType"><span class="type">GUdevDeviceType</span></a> type</code></em>,
|
---|
272 | <em class="parameter"><code><a class="link" href="GUdevClient.html#GUdevDeviceNumber" title="GUdevDeviceNumber"><span class="type">GUdevDeviceNumber</span></a> number</code></em>);</pre>
|
---|
273 | <p>
|
---|
274 | Looks up a device for a type and device number.
|
---|
275 | </p>
|
---|
276 | <div class="variablelist"><table border="0" class="variablelist">
|
---|
277 | <colgroup>
|
---|
278 | <col align="left" valign="top">
|
---|
279 | <col>
|
---|
280 | </colgroup>
|
---|
281 | <tbody>
|
---|
282 | <tr>
|
---|
283 | <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
|
---|
284 | <td>A <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a>.</td>
|
---|
285 | </tr>
|
---|
286 | <tr>
|
---|
287 | <td><p><span class="term"><em class="parameter"><code>type</code></em> :</span></p></td>
|
---|
288 | <td>A value from the <a class="link" href="GUdevClient.html#GUdevDeviceType"><span class="type">GUdevDeviceType</span></a> enumeration.</td>
|
---|
289 | </tr>
|
---|
290 | <tr>
|
---|
291 | <td><p><span class="term"><em class="parameter"><code>number</code></em> :</span></p></td>
|
---|
292 | <td>A device number.</td>
|
---|
293 | </tr>
|
---|
294 | <tr>
|
---|
295 | <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
---|
296 | <td>A <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="type">GUdevDevice</span></a> object or <code class="literal">NULL</code> if the device was not found. Free with <code class="function">g_object_unref()</code>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
---|
297 | </td>
|
---|
298 | </tr>
|
---|
299 | </tbody>
|
---|
300 | </table></div>
|
---|
301 | </div>
|
---|
302 | <hr>
|
---|
303 | <div class="refsect2">
|
---|
304 | <a name="g-udev-client-query-by-device-file"></a><h3>g_udev_client_query_by_device_file ()</h3>
|
---|
305 | <pre class="programlisting"><a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="returnvalue">GUdevDevice</span></a> * g_udev_client_query_by_device_file (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>,
|
---|
306 | <em class="parameter"><code>const <span class="type">gchar</span> *device_file</code></em>);</pre>
|
---|
307 | <p>
|
---|
308 | Looks up a device for a device file.
|
---|
309 | </p>
|
---|
310 | <div class="variablelist"><table border="0" class="variablelist">
|
---|
311 | <colgroup>
|
---|
312 | <col align="left" valign="top">
|
---|
313 | <col>
|
---|
314 | </colgroup>
|
---|
315 | <tbody>
|
---|
316 | <tr>
|
---|
317 | <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
|
---|
318 | <td>A <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a>.</td>
|
---|
319 | </tr>
|
---|
320 | <tr>
|
---|
321 | <td><p><span class="term"><em class="parameter"><code>device_file</code></em> :</span></p></td>
|
---|
322 | <td>A device file.</td>
|
---|
323 | </tr>
|
---|
324 | <tr>
|
---|
325 | <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
---|
326 | <td>A <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="type">GUdevDevice</span></a> object or <code class="literal">NULL</code> if the device was not found. Free with <code class="function">g_object_unref()</code>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
---|
327 | </td>
|
---|
328 | </tr>
|
---|
329 | </tbody>
|
---|
330 | </table></div>
|
---|
331 | </div>
|
---|
332 | <hr>
|
---|
333 | <div class="refsect2">
|
---|
334 | <a name="g-udev-client-query-by-sysfs-path"></a><h3>g_udev_client_query_by_sysfs_path ()</h3>
|
---|
335 | <pre class="programlisting"><a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="returnvalue">GUdevDevice</span></a> * g_udev_client_query_by_sysfs_path (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>,
|
---|
336 | <em class="parameter"><code>const <span class="type">gchar</span> *sysfs_path</code></em>);</pre>
|
---|
337 | <p>
|
---|
338 | Looks up a device for a sysfs path.
|
---|
339 | </p>
|
---|
340 | <div class="variablelist"><table border="0" class="variablelist">
|
---|
341 | <colgroup>
|
---|
342 | <col align="left" valign="top">
|
---|
343 | <col>
|
---|
344 | </colgroup>
|
---|
345 | <tbody>
|
---|
346 | <tr>
|
---|
347 | <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
|
---|
348 | <td>A <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a>.</td>
|
---|
349 | </tr>
|
---|
350 | <tr>
|
---|
351 | <td><p><span class="term"><em class="parameter"><code>sysfs_path</code></em> :</span></p></td>
|
---|
352 | <td>A sysfs path.</td>
|
---|
353 | </tr>
|
---|
354 | <tr>
|
---|
355 | <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
---|
356 | <td>A <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="type">GUdevDevice</span></a> object or <code class="literal">NULL</code> if the device was not found. Free with <code class="function">g_object_unref()</code>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
---|
357 | </td>
|
---|
358 | </tr>
|
---|
359 | </tbody>
|
---|
360 | </table></div>
|
---|
361 | </div>
|
---|
362 | <hr>
|
---|
363 | <div class="refsect2">
|
---|
364 | <a name="g-udev-client-query-by-subsystem-and-name"></a><h3>g_udev_client_query_by_subsystem_and_name ()</h3>
|
---|
365 | <pre class="programlisting"><a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="returnvalue">GUdevDevice</span></a> * g_udev_client_query_by_subsystem_and_name
|
---|
366 | (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>,
|
---|
367 | <em class="parameter"><code>const <span class="type">gchar</span> *subsystem</code></em>,
|
---|
368 | <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
|
---|
369 | <p>
|
---|
370 | Looks up a device for a subsystem and name.
|
---|
371 | </p>
|
---|
372 | <div class="variablelist"><table border="0" class="variablelist">
|
---|
373 | <colgroup>
|
---|
374 | <col align="left" valign="top">
|
---|
375 | <col>
|
---|
376 | </colgroup>
|
---|
377 | <tbody>
|
---|
378 | <tr>
|
---|
379 | <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
|
---|
380 | <td>A <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a>.</td>
|
---|
381 | </tr>
|
---|
382 | <tr>
|
---|
383 | <td><p><span class="term"><em class="parameter"><code>subsystem</code></em> :</span></p></td>
|
---|
384 | <td>A subsystem name.</td>
|
---|
385 | </tr>
|
---|
386 | <tr>
|
---|
387 | <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
|
---|
388 | <td>The name of the device.</td>
|
---|
389 | </tr>
|
---|
390 | <tr>
|
---|
391 | <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
|
---|
392 | <td>A <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="type">GUdevDevice</span></a> object or <code class="literal">NULL</code> if the device was not found. Free with <code class="function">g_object_unref()</code>. <span class="annotation">[<acronym title="Free data after the code is done."><span class="acronym">transfer full</span></acronym>]</span>
|
---|
393 | </td>
|
---|
394 | </tr>
|
---|
395 | </tbody>
|
---|
396 | </table></div>
|
---|
397 | </div>
|
---|
398 | </div>
|
---|
399 | <div class="refsect1">
|
---|
400 | <a name="GUdevClient.property-details"></a><h2>Property Details</h2>
|
---|
401 | <div class="refsect2">
|
---|
402 | <a name="GUdevClient--subsystems"></a><h3>The <code class="literal">"subsystems"</code> property</h3>
|
---|
403 | <pre class="programlisting"> "subsystems" <span class="type">GStrv</span> : Read / Write / Construct Only</pre>
|
---|
404 | <p>
|
---|
405 | The subsystems to listen for uevents on.
|
---|
406 | </p>
|
---|
407 | <p>
|
---|
408 | To listen for only a specific DEVTYPE for a given SUBSYSTEM, use
|
---|
409 | "subsystem/devtype". For example, to only listen for uevents
|
---|
410 | where SUBSYSTEM is usb and DEVTYPE is usb_interface, use
|
---|
411 | "usb/usb_interface".
|
---|
412 | </p>
|
---|
413 | <p>
|
---|
414 | If this property is <code class="literal">NULL</code>, then no events will be reported. If
|
---|
415 | it's the empty array, events from all subsystems will be
|
---|
416 | reported.
|
---|
417 | </p>
|
---|
418 | </div>
|
---|
419 | </div>
|
---|
420 | <div class="refsect1">
|
---|
421 | <a name="GUdevClient.signal-details"></a><h2>Signal Details</h2>
|
---|
422 | <div class="refsect2">
|
---|
423 | <a name="GUdevClient-uevent"></a><h3>The <code class="literal">"uevent"</code> signal</h3>
|
---|
424 | <pre class="programlisting"><span class="returnvalue">void</span> user_function (<a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client,
|
---|
425 | <span class="type">gchar</span> *action,
|
---|
426 | <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="type">GUdevDevice</span></a> *device,
|
---|
427 | <span class="type">gpointer</span> user_data) : <code class="literal">Run Last</code></pre>
|
---|
428 | <p>
|
---|
429 | Emitted when <em class="parameter"><code>client</code></em> receives an uevent.
|
---|
430 | </p>
|
---|
431 | <p>
|
---|
432 | This signal is emitted in the
|
---|
433 | thread-default main loop
|
---|
434 | of the thread that <em class="parameter"><code>client</code></em> was created in.
|
---|
435 | </p>
|
---|
436 | <div class="variablelist"><table border="0" class="variablelist">
|
---|
437 | <colgroup>
|
---|
438 | <col align="left" valign="top">
|
---|
439 | <col>
|
---|
440 | </colgroup>
|
---|
441 | <tbody>
|
---|
442 | <tr>
|
---|
443 | <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
|
---|
444 | <td>The <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> receiving the event.</td>
|
---|
445 | </tr>
|
---|
446 | <tr>
|
---|
447 | <td><p><span class="term"><em class="parameter"><code>action</code></em> :</span></p></td>
|
---|
448 | <td>The action for the uevent e.g. "add", "remove", "change", "move", etc.</td>
|
---|
449 | </tr>
|
---|
450 | <tr>
|
---|
451 | <td><p><span class="term"><em class="parameter"><code>device</code></em> :</span></p></td>
|
---|
452 | <td>Details about the <a class="link" href="GUdevDevice.html" title="GUdevDevice"><span class="type">GUdevDevice</span></a> the event is for.</td>
|
---|
453 | </tr>
|
---|
454 | <tr>
|
---|
455 | <td><p><span class="term"><em class="parameter"><code>user_data</code></em> :</span></p></td>
|
---|
456 | <td>user data set when the signal handler was connected.</td>
|
---|
457 | </tr>
|
---|
458 | </tbody>
|
---|
459 | </table></div>
|
---|
460 | </div>
|
---|
461 | </div>
|
---|
462 | </div>
|
---|
463 | <div class="footer">
|
---|
464 | <hr>
|
---|
465 | Generated by GTK-Doc V1.18</div>
|
---|
466 | </body>
|
---|
467 | </html> |
---|