source: udev-lfs/gudev/GUdevClient.html@ d736904

10.0 10.0-rc1 10.1 10.1-rc1 11.0 11.0-rc1 11.0-rc2 11.0-rc3 11.1 11.1-rc1 11.2 11.2-rc1 11.3 11.3-rc1 12.0 12.0-rc1 12.1 12.1-rc1 7.4 7.5 7.6 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 arm bdubbs/gcc13 ml-11.0 multilib renodr/libudev-from-systemd s6-init trunk xry111/arm64 xry111/arm64-12.0 xry111/clfs-ng xry111/lfs-next xry111/loongarch xry111/loongarch-12.0 xry111/loongarch-12.1 xry111/mips64el xry111/pip3 xry111/rust-wip-20221008 xry111/update-glibc
Last change on this file since d736904 was d736904, checked in by Bruce Dubbs <bdubbs@…>, 11 years ago

Update udev-lfs-199 for man pages and html docs

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@10227 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689
  • Property mode set to 100644
File size: 27.1 KB
Line 
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>;
47struct <a class="link" href="GUdevClient.html#GUdevClientClass" title="struct GUdevClientClass">GUdevClientClass</a>;
48enum <a class="link" href="GUdevClient.html#GUdevDeviceType-enum" title="enum GUdevDeviceType">GUdevDeviceType</a>;
49typedef <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
94system from the Linux kernel and the udev device
95manager.
96</p>
97<p>
98Device 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
103memory) and as such there are no asynchronous versions of the
104provided methods.
105</p>
106<p>
107To 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>
113or the <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> type.
114</p>
115<p>
116To 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>
125The <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>
141Class 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>
170Enumeration 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>
202Corresponds to the standard <span class="type">dev_t</span> type as defined by POSIX (Until
203bug 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>
211Constructs a <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> object that can be used to query
212information about devices. Connect to the <a class="link" href="GUdevClient.html#GUdevClient-uevent" title='The "uevent" signal'><span class="type">"uevent"</span></a>
213signal to listen for uevents. Note that signals are emitted in the
214thread-default main loop
215of 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>
241Gets 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>
274Looks 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>
308Looks 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>
338Looks 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>
370Looks 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>
405The subsystems to listen for uevents on.
406</p>
407<p>
408To listen for only a specific DEVTYPE for a given SUBSYSTEM, use
409"subsystem/devtype". For example, to only listen for uevents
410where SUBSYSTEM is usb and DEVTYPE is usb_interface, use
411"usb/usb_interface".
412</p>
413<p>
414If this property is <code class="literal">NULL</code>, then no events will be reported. If
415it's the empty array, events from all subsystems will be
416reported.
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>
429Emitted when <em class="parameter"><code>client</code></em> receives an uevent.
430</p>
431<p>
432This signal is emitted in the
433thread-default main loop
434of 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>
Note: See TracBrowser for help on using the repository browser.