GUdevEnumerator.html 31 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493
  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.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="GUdevDevice.html" title="GUdevDevice">
  10. <link rel="next" href="gudev-hierarchy.html" title="Object Hierarchy">
  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="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.18</div>
  492. </body>
  493. </html>