]> git.proxmox.com Git - systemd.git/blob - docs/gudev/html/GUdevEnumerator.html
Imported Upstream version 208
[systemd.git] / docs / gudev / html / GUdevEnumerator.html
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>GUdevEnumerator</title>
6 <meta name="generator" content="DocBook XSL Stylesheets V1.78.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="GUdevDevice.html" title="GUdevDevice">
10 <link rel="next" href="gudev-hierarchy.html" title="Object Hierarchy">
11 <meta name="generator" content="GTK-Doc V1.19 (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="GUdevDevice.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="gudev-hierarchy.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="#GUdevEnumerator.synopsis" class="shortcut">Top</a>
25  | 
26 <a href="#GUdevEnumerator.description" class="shortcut">Description</a>
27  | 
28 <a href="#GUdevEnumerator.object-hierarchy" class="shortcut">Object Hierarchy</a>
29  | 
30 <a href="#GUdevEnumerator.properties" class="shortcut">Properties</a>
31 </td></tr>
32 </table>
33 <div class="refentry">
34 <a name="GUdevEnumerator"></a><div class="titlepage"></div>
35 <div class="refnamediv"><table width="100%"><tr>
36 <td valign="top">
37 <h2><span class="refentrytitle"><a name="GUdevEnumerator.top_of_page"></a>GUdevEnumerator</span></h2>
38 <p>GUdevEnumerator — Lookup and sort devices</p>
39 </td>
40 <td valign="top" align="right"></td>
41 </tr></table></div>
42 <div class="refsynopsisdiv">
43 <a name="GUdevEnumerator.synopsis"></a><h2>Synopsis</h2>
44 <pre class="synopsis"> <a class="link" href="GUdevEnumerator.html#GUdevEnumerator-struct" title="GUdevEnumerator">GUdevEnumerator</a>;
45 struct <a class="link" href="GUdevEnumerator.html#GUdevEnumeratorClass" title="struct GUdevEnumeratorClass">GUdevEnumeratorClass</a>;
46 <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-new" title="g_udev_enumerator_new ()">g_udev_enumerator_new</a> (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>);
47 <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-add-match-subsystem" title="g_udev_enumerator_add_match_subsystem ()">g_udev_enumerator_add_match_subsystem</a>
48 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
49 <em class="parameter"><code>const <span class="type">gchar</span> *subsystem</code></em>);
50 <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-add-nomatch-subsystem" title="g_udev_enumerator_add_nomatch_subsystem ()">g_udev_enumerator_add_nomatch_subsystem</a>
51 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
52 <em class="parameter"><code>const <span class="type">gchar</span> *subsystem</code></em>);
53 <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-add-match-sysfs-attr" title="g_udev_enumerator_add_match_sysfs_attr ()">g_udev_enumerator_add_match_sysfs_attr</a>
54 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
55 <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
56 <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);
57 <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-add-nomatch-sysfs-attr" title="g_udev_enumerator_add_nomatch_sysfs_attr ()">g_udev_enumerator_add_nomatch_sysfs_attr</a>
58 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
59 <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
60 <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);
61 <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-add-match-property" title="g_udev_enumerator_add_match_property ()">g_udev_enumerator_add_match_property</a>
62 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
63 <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
64 <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);
65 <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-add-match-name" title="g_udev_enumerator_add_match_name ()">g_udev_enumerator_add_match_name</a> (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
66 <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);
67 <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-add-match-tag" title="g_udev_enumerator_add_match_tag ()">g_udev_enumerator_add_match_tag</a> (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
68 <em class="parameter"><code>const <span class="type">gchar</span> *tag</code></em>);
69 <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-add-match-is-initialized" title="g_udev_enumerator_add_match_is_initialized ()">g_udev_enumerator_add_match_is_initialized</a>
70 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>);
71 <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-add-sysfs-path" title="g_udev_enumerator_add_sysfs_path ()">g_udev_enumerator_add_sysfs_path</a> (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
72 <em class="parameter"><code>const <span class="type">gchar</span> *sysfs_path</code></em>);
73 <span class="returnvalue">GList</span> * <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-execute" title="g_udev_enumerator_execute ()">g_udev_enumerator_execute</a> (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>);
74 </pre>
75 </div>
76 <div class="refsect1">
77 <a name="GUdevEnumerator.object-hierarchy"></a><h2>Object Hierarchy</h2>
78 <pre class="synopsis">
79 GObject
80 +----GUdevEnumerator
81 </pre>
82 </div>
83 <div class="refsect1">
84 <a name="GUdevEnumerator.properties"></a><h2>Properties</h2>
85 <pre class="synopsis">
86 "<a class="link" href="GUdevEnumerator.html#GUdevEnumerator--client" title='The "client" property'>client</a>" <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a>* : Read / Write / Construct Only
87 </pre>
88 </div>
89 <div class="refsect1">
90 <a name="GUdevEnumerator.description"></a><h2>Description</h2>
91 <p>
92 <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> is used to lookup and sort devices.
93 </p>
94 </div>
95 <div class="refsect1">
96 <a name="GUdevEnumerator.details"></a><h2>Details</h2>
97 <div class="refsect2">
98 <a name="GUdevEnumerator-struct"></a><h3>GUdevEnumerator</h3>
99 <pre class="programlisting">typedef struct _GUdevEnumerator GUdevEnumerator;</pre>
100 <p>
101 The <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> struct is opaque and should not be accessed directly.
102 </p>
103 <p class="since">Since 165</p>
104 </div>
105 <hr>
106 <div class="refsect2">
107 <a name="GUdevEnumeratorClass"></a><h3>struct GUdevEnumeratorClass</h3>
108 <pre class="programlisting">struct GUdevEnumeratorClass {
109 GObjectClass parent_class;
110 };
111 </pre>
112 <p>
113 Class structure for <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a>.
114 </p>
115 <div class="variablelist"><table border="0" class="variablelist">
116 <colgroup>
117 <col align="left" valign="top">
118 <col>
119 </colgroup>
120 <tbody><tr>
121 <td><p><span class="term"><span class="type">GObjectClass</span> <em class="structfield"><code><a name="GUdevEnumeratorClass.parent-class"></a>parent_class</code></em>;</span></p></td>
122 <td>Parent class.</td>
123 </tr></tbody>
124 </table></div>
125 <p class="since">Since 165</p>
126 </div>
127 <hr>
128 <div class="refsect2">
129 <a name="g-udev-enumerator-new"></a><h3>g_udev_enumerator_new ()</h3>
130 <pre class="programlisting"><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * g_udev_enumerator_new (<em class="parameter"><code><a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> *client</code></em>);</pre>
131 <p>
132 Constructs a <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> object that can be used to enumerate
133 and sort devices. Use the add_match_*() and add_nomatch_*() methods
134 and execute the query to get a list of devices with
135 <a class="link" href="GUdevEnumerator.html#g-udev-enumerator-execute" title="g_udev_enumerator_execute ()"><code class="function">g_udev_enumerator_execute()</code></a>.
136 </p>
137 <div class="variablelist"><table border="0" class="variablelist">
138 <colgroup>
139 <col align="left" valign="top">
140 <col>
141 </colgroup>
142 <tbody>
143 <tr>
144 <td><p><span class="term"><em class="parameter"><code>client</code></em> :</span></p></td>
145 <td>A <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> to enumerate devices from.</td>
146 </tr>
147 <tr>
148 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
149 <td>A new <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> object. Free with <code class="function">g_object_unref()</code>.</td>
150 </tr>
151 </tbody>
152 </table></div>
153 <p class="since">Since 165</p>
154 </div>
155 <hr>
156 <div class="refsect2">
157 <a name="g-udev-enumerator-add-match-subsystem"></a><h3>g_udev_enumerator_add_match_subsystem ()</h3>
158 <pre class="programlisting"><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * g_udev_enumerator_add_match_subsystem
159 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
160 <em class="parameter"><code>const <span class="type">gchar</span> *subsystem</code></em>);</pre>
161 <p>
162 All returned devices will match the given <em class="parameter"><code>subsystem</code></em>.
163 </p>
164 <div class="variablelist"><table border="0" class="variablelist">
165 <colgroup>
166 <col align="left" valign="top">
167 <col>
168 </colgroup>
169 <tbody>
170 <tr>
171 <td><p><span class="term"><em class="parameter"><code>enumerator</code></em> :</span></p></td>
172 <td>A <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a>.</td>
173 </tr>
174 <tr>
175 <td><p><span class="term"><em class="parameter"><code>subsystem</code></em> :</span></p></td>
176 <td>Wildcard for subsystem name e.g. 'scsi' or 'a*'.</td>
177 </tr>
178 <tr>
179 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
180 <td>The passed in <em class="parameter"><code>enumerator</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
181 </td>
182 </tr>
183 </tbody>
184 </table></div>
185 <p class="since">Since 165</p>
186 </div>
187 <hr>
188 <div class="refsect2">
189 <a name="g-udev-enumerator-add-nomatch-subsystem"></a><h3>g_udev_enumerator_add_nomatch_subsystem ()</h3>
190 <pre class="programlisting"><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * g_udev_enumerator_add_nomatch_subsystem
191 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
192 <em class="parameter"><code>const <span class="type">gchar</span> *subsystem</code></em>);</pre>
193 <p>
194 All returned devices will not match the given <em class="parameter"><code>subsystem</code></em>.
195 </p>
196 <div class="variablelist"><table border="0" class="variablelist">
197 <colgroup>
198 <col align="left" valign="top">
199 <col>
200 </colgroup>
201 <tbody>
202 <tr>
203 <td><p><span class="term"><em class="parameter"><code>enumerator</code></em> :</span></p></td>
204 <td>A <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a>.</td>
205 </tr>
206 <tr>
207 <td><p><span class="term"><em class="parameter"><code>subsystem</code></em> :</span></p></td>
208 <td>Wildcard for subsystem name e.g. 'scsi' or 'a*'.</td>
209 </tr>
210 <tr>
211 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
212 <td>The passed in <em class="parameter"><code>enumerator</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
213 </td>
214 </tr>
215 </tbody>
216 </table></div>
217 <p class="since">Since 165</p>
218 </div>
219 <hr>
220 <div class="refsect2">
221 <a name="g-udev-enumerator-add-match-sysfs-attr"></a><h3>g_udev_enumerator_add_match_sysfs_attr ()</h3>
222 <pre class="programlisting"><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * g_udev_enumerator_add_match_sysfs_attr
223 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
224 <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
225 <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
226 <p>
227 All returned devices will have a sysfs attribute matching the given <em class="parameter"><code>name</code></em> and <em class="parameter"><code>value</code></em>.
228 </p>
229 <div class="variablelist"><table border="0" class="variablelist">
230 <colgroup>
231 <col align="left" valign="top">
232 <col>
233 </colgroup>
234 <tbody>
235 <tr>
236 <td><p><span class="term"><em class="parameter"><code>enumerator</code></em> :</span></p></td>
237 <td>A <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a>.</td>
238 </tr>
239 <tr>
240 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
241 <td>Wildcard filter for sysfs attribute key.</td>
242 </tr>
243 <tr>
244 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
245 <td>Wildcard filter for sysfs attribute value.</td>
246 </tr>
247 <tr>
248 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
249 <td>The passed in <em class="parameter"><code>enumerator</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
250 </td>
251 </tr>
252 </tbody>
253 </table></div>
254 <p class="since">Since 165</p>
255 </div>
256 <hr>
257 <div class="refsect2">
258 <a name="g-udev-enumerator-add-nomatch-sysfs-attr"></a><h3>g_udev_enumerator_add_nomatch_sysfs_attr ()</h3>
259 <pre class="programlisting"><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * g_udev_enumerator_add_nomatch_sysfs_attr
260 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
261 <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
262 <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
263 <p>
264 All returned devices will not have a sysfs attribute matching the given <em class="parameter"><code>name</code></em> and <em class="parameter"><code>value</code></em>.
265 </p>
266 <div class="variablelist"><table border="0" class="variablelist">
267 <colgroup>
268 <col align="left" valign="top">
269 <col>
270 </colgroup>
271 <tbody>
272 <tr>
273 <td><p><span class="term"><em class="parameter"><code>enumerator</code></em> :</span></p></td>
274 <td>A <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a>.</td>
275 </tr>
276 <tr>
277 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
278 <td>Wildcard filter for sysfs attribute key.</td>
279 </tr>
280 <tr>
281 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
282 <td>Wildcard filter for sysfs attribute value.</td>
283 </tr>
284 <tr>
285 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
286 <td>The passed in <em class="parameter"><code>enumerator</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
287 </td>
288 </tr>
289 </tbody>
290 </table></div>
291 <p class="since">Since 165</p>
292 </div>
293 <hr>
294 <div class="refsect2">
295 <a name="g-udev-enumerator-add-match-property"></a><h3>g_udev_enumerator_add_match_property ()</h3>
296 <pre class="programlisting"><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * g_udev_enumerator_add_match_property
297 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
298 <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
299 <em class="parameter"><code>const <span class="type">gchar</span> *value</code></em>);</pre>
300 <p>
301 All returned devices will have a property matching the given <em class="parameter"><code>name</code></em> and <em class="parameter"><code>value</code></em>.
302 </p>
303 <div class="variablelist"><table border="0" class="variablelist">
304 <colgroup>
305 <col align="left" valign="top">
306 <col>
307 </colgroup>
308 <tbody>
309 <tr>
310 <td><p><span class="term"><em class="parameter"><code>enumerator</code></em> :</span></p></td>
311 <td>A <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a>.</td>
312 </tr>
313 <tr>
314 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
315 <td>Wildcard filter for property name.</td>
316 </tr>
317 <tr>
318 <td><p><span class="term"><em class="parameter"><code>value</code></em> :</span></p></td>
319 <td>Wildcard filter for property value.</td>
320 </tr>
321 <tr>
322 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
323 <td>The passed in <em class="parameter"><code>enumerator</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
324 </td>
325 </tr>
326 </tbody>
327 </table></div>
328 <p class="since">Since 165</p>
329 </div>
330 <hr>
331 <div class="refsect2">
332 <a name="g-udev-enumerator-add-match-name"></a><h3>g_udev_enumerator_add_match_name ()</h3>
333 <pre class="programlisting"><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * g_udev_enumerator_add_match_name (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
334 <em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>);</pre>
335 <p>
336 All returned devices will match the given <em class="parameter"><code>name</code></em>.
337 </p>
338 <div class="variablelist"><table border="0" class="variablelist">
339 <colgroup>
340 <col align="left" valign="top">
341 <col>
342 </colgroup>
343 <tbody>
344 <tr>
345 <td><p><span class="term"><em class="parameter"><code>enumerator</code></em> :</span></p></td>
346 <td>A <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a>.</td>
347 </tr>
348 <tr>
349 <td><p><span class="term"><em class="parameter"><code>name</code></em> :</span></p></td>
350 <td>Wildcard filter for kernel name e.g. "sda*".</td>
351 </tr>
352 <tr>
353 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
354 <td>The passed in <em class="parameter"><code>enumerator</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
355 </td>
356 </tr>
357 </tbody>
358 </table></div>
359 <p class="since">Since 165</p>
360 </div>
361 <hr>
362 <div class="refsect2">
363 <a name="g-udev-enumerator-add-match-tag"></a><h3>g_udev_enumerator_add_match_tag ()</h3>
364 <pre class="programlisting"><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * g_udev_enumerator_add_match_tag (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
365 <em class="parameter"><code>const <span class="type">gchar</span> *tag</code></em>);</pre>
366 <p>
367 All returned devices will match the given <em class="parameter"><code>tag</code></em>.
368 </p>
369 <div class="variablelist"><table border="0" class="variablelist">
370 <colgroup>
371 <col align="left" valign="top">
372 <col>
373 </colgroup>
374 <tbody>
375 <tr>
376 <td><p><span class="term"><em class="parameter"><code>enumerator</code></em> :</span></p></td>
377 <td>A <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a>.</td>
378 </tr>
379 <tr>
380 <td><p><span class="term"><em class="parameter"><code>tag</code></em> :</span></p></td>
381 <td>A udev tag e.g. "udev-acl".</td>
382 </tr>
383 <tr>
384 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
385 <td>The passed in <em class="parameter"><code>enumerator</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
386 </td>
387 </tr>
388 </tbody>
389 </table></div>
390 <p class="since">Since 165</p>
391 </div>
392 <hr>
393 <div class="refsect2">
394 <a name="g-udev-enumerator-add-match-is-initialized"></a><h3>g_udev_enumerator_add_match_is_initialized ()</h3>
395 <pre class="programlisting"><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * g_udev_enumerator_add_match_is_initialized
396 (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>);</pre>
397 <p>
398 All returned devices will be initialized.
399 </p>
400 <div class="variablelist"><table border="0" class="variablelist">
401 <colgroup>
402 <col align="left" valign="top">
403 <col>
404 </colgroup>
405 <tbody>
406 <tr>
407 <td><p><span class="term"><em class="parameter"><code>enumerator</code></em> :</span></p></td>
408 <td>A <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a>.</td>
409 </tr>
410 <tr>
411 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
412 <td>The passed in <em class="parameter"><code>enumerator</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
413 </td>
414 </tr>
415 </tbody>
416 </table></div>
417 <p class="since">Since 165</p>
418 </div>
419 <hr>
420 <div class="refsect2">
421 <a name="g-udev-enumerator-add-sysfs-path"></a><h3>g_udev_enumerator_add_sysfs_path ()</h3>
422 <pre class="programlisting"><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="returnvalue">GUdevEnumerator</span></a> * g_udev_enumerator_add_sysfs_path (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>,
423 <em class="parameter"><code>const <span class="type">gchar</span> *sysfs_path</code></em>);</pre>
424 <p>
425 Add a device to the list of devices, to retrieve it back sorted in dependency order.
426 </p>
427 <div class="variablelist"><table border="0" class="variablelist">
428 <colgroup>
429 <col align="left" valign="top">
430 <col>
431 </colgroup>
432 <tbody>
433 <tr>
434 <td><p><span class="term"><em class="parameter"><code>enumerator</code></em> :</span></p></td>
435 <td>A <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a>.</td>
436 </tr>
437 <tr>
438 <td><p><span class="term"><em class="parameter"><code>sysfs_path</code></em> :</span></p></td>
439 <td>A sysfs path, e.g. "/sys/devices/pci0000:00/0000:00:1f.2/host0/target0:0:0/0:0:0:0/block/sda"</td>
440 </tr>
441 <tr>
442 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
443 <td>The passed in <em class="parameter"><code>enumerator</code></em>. <span class="annotation">[<acronym title="Don't free data after the code is done."><span class="acronym">transfer none</span></acronym>]</span>
444 </td>
445 </tr>
446 </tbody>
447 </table></div>
448 <p class="since">Since 165</p>
449 </div>
450 <hr>
451 <div class="refsect2">
452 <a name="g-udev-enumerator-execute"></a><h3>g_udev_enumerator_execute ()</h3>
453 <pre class="programlisting"><span class="returnvalue">GList</span> * g_udev_enumerator_execute (<em class="parameter"><code><a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a> *enumerator</code></em>);</pre>
454 <p>
455 Executes the query in <em class="parameter"><code>enumerator</code></em>.
456 </p>
457 <div class="variablelist"><table border="0" class="variablelist">
458 <colgroup>
459 <col align="left" valign="top">
460 <col>
461 </colgroup>
462 <tbody>
463 <tr>
464 <td><p><span class="term"><em class="parameter"><code>enumerator</code></em> :</span></p></td>
465 <td>A <a class="link" href="GUdevEnumerator.html" title="GUdevEnumerator"><span class="type">GUdevEnumerator</span></a>.</td>
466 </tr>
467 <tr>
468 <td><p><span class="term"><span class="emphasis"><em>Returns</em></span> :</span></p></td>
469 <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>
470 </td>
471 </tr>
472 </tbody>
473 </table></div>
474 <p class="since">Since 165</p>
475 </div>
476 </div>
477 <div class="refsect1">
478 <a name="GUdevEnumerator.property-details"></a><h2>Property Details</h2>
479 <div class="refsect2">
480 <a name="GUdevEnumerator--client"></a><h3>The <code class="literal">"client"</code> property</h3>
481 <pre class="programlisting"> "client" <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a>* : Read / Write / Construct Only</pre>
482 <p>
483 The <a class="link" href="GUdevClient.html" title="GUdevClient"><span class="type">GUdevClient</span></a> to enumerate devices from.
484 </p>
485 <p class="since">Since 165</p>
486 </div>
487 </div>
488 </div>
489 <div class="footer">
490 <hr>
491 Generated by GTK-Doc V1.19</div>
492 </body>
493 </html>