mirror of
https://git.proxmox.com/git/systemd
synced 2025-07-25 07:10:38 +00:00
231 lines
9.6 KiB
HTML
231 lines
9.6 KiB
HTML
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
<html>
|
||
<head>
|
||
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
|
||
<title>libudev Reference Manual: udev_hwdb</title>
|
||
<meta name="generator" content="DocBook XSL Stylesheets V1.78.1">
|
||
<link rel="home" href="index.html" title="libudev Reference Manual">
|
||
<link rel="up" href="ch01.html" title="API Reference">
|
||
<link rel="prev" href="libudev-udev-queue.html" title="udev_queue">
|
||
<link rel="next" href="libudev-udev-util.html" title="udev_util">
|
||
<meta name="generator" content="GTK-Doc V1.21 (XML mode)">
|
||
<link rel="stylesheet" href="style.css" type="text/css">
|
||
</head>
|
||
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
|
||
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
|
||
<td width="100%" align="left" class="shortcuts">
|
||
<a href="#" class="shortcut">Top</a><span id="nav_description"> <span class="dim">|</span>
|
||
<a href="#libudev-udev-hwdb.description" class="shortcut">Description</a></span>
|
||
</td>
|
||
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
|
||
<td><a accesskey="u" href="ch01.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
|
||
<td><a accesskey="p" href="libudev-udev-queue.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
|
||
<td><a accesskey="n" href="libudev-udev-util.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
|
||
</tr></table>
|
||
<div class="refentry">
|
||
<a name="libudev-udev-hwdb"></a><div class="titlepage"></div>
|
||
<div class="refnamediv"><table width="100%"><tr>
|
||
<td valign="top">
|
||
<h2><span class="refentrytitle"><a name="libudev-udev-hwdb.top_of_page"></a>udev_hwdb</span></h2>
|
||
<p>udev_hwdb — retrieve properties from the hardware database</p>
|
||
</td>
|
||
<td class="gallery_image" valign="top" align="right"></td>
|
||
</tr></table></div>
|
||
<div class="refsect1">
|
||
<a name="libudev-udev-hwdb.functions"></a><h2>Functions</h2>
|
||
<div class="informaltable"><table width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="functions_return">
|
||
<col class="functions_name">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="function_type">struct <a class="link" href="libudev-udev-hwdb.html#udev-hwdb" title="struct udev_hwdb"><span class="returnvalue">udev_hwdb</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="libudev-udev-hwdb.html#udev-hwdb-ref" title="udev_hwdb_ref ()">udev_hwdb_ref</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">struct <a class="link" href="libudev-udev-hwdb.html#udev-hwdb" title="struct udev_hwdb"><span class="returnvalue">udev_hwdb</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="libudev-udev-hwdb.html#udev-hwdb-unref" title="udev_hwdb_unref ()">udev_hwdb_unref</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">struct <a class="link" href="libudev-udev-hwdb.html#udev-hwdb" title="struct udev_hwdb"><span class="returnvalue">udev_hwdb</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="libudev-udev-hwdb.html#udev-hwdb-new" title="udev_hwdb_new ()">udev_hwdb_new</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
<tr>
|
||
<td class="function_type">struct <a class="link" href="libudev-udev-list.html#udev-list-entry" title="struct udev_list_entry"><span class="returnvalue">udev_list_entry</span></a> *
|
||
</td>
|
||
<td class="function_name">
|
||
<a class="link" href="libudev-udev-hwdb.html#udev-hwdb-get-properties-list-entry" title="udev_hwdb_get_properties_list_entry ()">udev_hwdb_get_properties_list_entry</a> <span class="c_punctuation">()</span>
|
||
</td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="libudev-udev-hwdb.other"></a><h2>Types and Values</h2>
|
||
<div class="informaltable"><table width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="name">
|
||
<col class="description">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="datatype_keyword">struct</td>
|
||
<td class="function_name"><a class="link" href="libudev-udev-hwdb.html#udev-hwdb" title="struct udev_hwdb">udev_hwdb</a></td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="libudev-udev-hwdb.description"></a><h2>Description</h2>
|
||
<p>Libudev hardware database interface.</p>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="libudev-udev-hwdb.functions_details"></a><h2>Functions</h2>
|
||
<div class="refsect2">
|
||
<a name="udev-hwdb-ref"></a><h3>udev_hwdb_ref ()</h3>
|
||
<pre class="programlisting">struct <a class="link" href="libudev-udev-hwdb.html#udev-hwdb" title="struct udev_hwdb"><span class="returnvalue">udev_hwdb</span></a> *
|
||
udev_hwdb_ref (<em class="parameter"><code><span class="type">struct udev_hwdb</span> *hwdb</code></em>);</pre>
|
||
<p>Take a reference of a hwdb context.</p>
|
||
<div class="refsect3">
|
||
<a name="id-1.2.8.6.2.5"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>hwdb</p></td>
|
||
<td class="parameter_description"><p>context</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="id-1.2.8.6.2.6"></a><h4>Returns</h4>
|
||
<p> the passed enumeration context</p>
|
||
<p></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="udev-hwdb-unref"></a><h3>udev_hwdb_unref ()</h3>
|
||
<pre class="programlisting">struct <a class="link" href="libudev-udev-hwdb.html#udev-hwdb" title="struct udev_hwdb"><span class="returnvalue">udev_hwdb</span></a> *
|
||
udev_hwdb_unref (<em class="parameter"><code><span class="type">struct udev_hwdb</span> *hwdb</code></em>);</pre>
|
||
<p>Drop a reference of a hwdb context. If the refcount reaches zero,
|
||
all resources of the hwdb context will be released.</p>
|
||
<div class="refsect3">
|
||
<a name="id-1.2.8.6.3.5"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>hwdb</p></td>
|
||
<td class="parameter_description"><p>context</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="id-1.2.8.6.3.6"></a><h4>Returns</h4>
|
||
<p> <span class="type">NULL</span></p>
|
||
<p></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="udev-hwdb-new"></a><h3>udev_hwdb_new ()</h3>
|
||
<pre class="programlisting">struct <a class="link" href="libudev-udev-hwdb.html#udev-hwdb" title="struct udev_hwdb"><span class="returnvalue">udev_hwdb</span></a> *
|
||
udev_hwdb_new (<em class="parameter"><code><span class="type">struct udev</span> *udev</code></em>);</pre>
|
||
<p>Create a hardware database context to query properties for devices.</p>
|
||
<div class="refsect3">
|
||
<a name="id-1.2.8.6.4.5"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody><tr>
|
||
<td class="parameter_name"><p>udev</p></td>
|
||
<td class="parameter_description"><p>udev library context</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr></tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="id-1.2.8.6.4.6"></a><h4>Returns</h4>
|
||
<p> a hwdb context.</p>
|
||
<p></p>
|
||
</div>
|
||
</div>
|
||
<hr>
|
||
<div class="refsect2">
|
||
<a name="udev-hwdb-get-properties-list-entry"></a><h3>udev_hwdb_get_properties_list_entry ()</h3>
|
||
<pre class="programlisting">struct <a class="link" href="libudev-udev-list.html#udev-list-entry" title="struct udev_list_entry"><span class="returnvalue">udev_list_entry</span></a> *
|
||
udev_hwdb_get_properties_list_entry (<em class="parameter"><code><span class="type">struct udev_hwdb</span> *hwdb</code></em>,
|
||
<em class="parameter"><code>const <span class="type">char</span> *modalias</code></em>,
|
||
<em class="parameter"><code>unsigned <span class="type">int</span> flags</code></em>);</pre>
|
||
<p>Lookup a matching device in the hardware database. The lookup key is a
|
||
modalias string, whose formats are defined for the Linux kernel modules.
|
||
Examples are: pci:v00008086d00001C2D*, usb:v04F2pB221*. The first entry
|
||
of a list of retrieved properties is returned.</p>
|
||
<div class="refsect3">
|
||
<a name="id-1.2.8.6.5.5"></a><h4>Parameters</h4>
|
||
<div class="informaltable"><table width="100%" border="0">
|
||
<colgroup>
|
||
<col width="150px" class="parameters_name">
|
||
<col class="parameters_description">
|
||
<col width="200px" class="parameters_annotations">
|
||
</colgroup>
|
||
<tbody>
|
||
<tr>
|
||
<td class="parameter_name"><p>hwdb</p></td>
|
||
<td class="parameter_description"><p>context</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>modalias</p></td>
|
||
<td class="parameter_description"><p>modalias string</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
<tr>
|
||
<td class="parameter_name"><p>flags</p></td>
|
||
<td class="parameter_description"><p>(unused)</p></td>
|
||
<td class="parameter_annotations"> </td>
|
||
</tr>
|
||
</tbody>
|
||
</table></div>
|
||
</div>
|
||
<div class="refsect3">
|
||
<a name="id-1.2.8.6.5.6"></a><h4>Returns</h4>
|
||
<p> a udev_list_entry.</p>
|
||
<p></p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="refsect1">
|
||
<a name="libudev-udev-hwdb.other_details"></a><h2>Types and Values</h2>
|
||
<div class="refsect2">
|
||
<a name="udev-hwdb"></a><h3>struct udev_hwdb</h3>
|
||
<pre class="programlisting">struct udev_hwdb;</pre>
|
||
<p>Opaque object representing the hardware database.</p>
|
||
</div>
|
||
</div>
|
||
</div>
|
||
<div class="footer">
|
||
<hr>
|
||
Generated by GTK-Doc V1.21</div>
|
||
</body>
|
||
</html> |