2 This file is part of systemd.
4 Copyright Tom Gundersen <teg@jklm.no>
6 systemd is free software; you can redistribute it and/or modify it
7 under the terms of the GNU Lesser General Public License as published by
8 the Free Software Foundation; either version 2.1 of the License, or
9 (at your option) any later version.
11 systemd is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Lesser General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License
17 along with systemd; If not, see <http://www.gnu.org/licenses/>.
22 #include "alloc-util.h"
23 #include "hwdb-util.h"
24 #include "libudev-private.h"
27 * SECTION:libudev-hwdb
28 * @short_description: retrieve properties from the hardware database
30 * Libudev hardware database interface.
36 * Opaque object representing the hardware database.
44 struct udev_list properties_list
;
49 * @udev: udev library context
51 * Create a hardware database context to query properties for devices.
53 * Returns: a hwdb context.
55 _public_
struct udev_hwdb
*udev_hwdb_new(struct udev
*udev
) {
56 _cleanup_(sd_hwdb_unrefp
) sd_hwdb
*hwdb_internal
= NULL
;
57 struct udev_hwdb
*hwdb
;
60 assert_return(udev
, NULL
);
62 r
= sd_hwdb_new(&hwdb_internal
);
66 hwdb
= new0(struct udev_hwdb
, 1);
71 hwdb
->hwdb
= hwdb_internal
;
74 udev_list_init(udev
, &hwdb
->properties_list
, true);
83 * Take a reference of a hwdb context.
85 * Returns: the passed enumeration context
87 _public_
struct udev_hwdb
*udev_hwdb_ref(struct udev_hwdb
*hwdb
) {
98 * Drop a reference of a hwdb context. If the refcount reaches zero,
99 * all resources of the hwdb context will be released.
103 _public_
struct udev_hwdb
*udev_hwdb_unref(struct udev_hwdb
*hwdb
) {
107 if (hwdb
->refcount
> 0)
109 sd_hwdb_unref(hwdb
->hwdb
);
110 udev_list_cleanup(&hwdb
->properties_list
);
116 * udev_hwdb_get_properties_list_entry:
118 * @modalias: modalias string
121 * Lookup a matching device in the hardware database. The lookup key is a
122 * modalias string, whose formats are defined for the Linux kernel modules.
123 * Examples are: pci:v00008086d00001C2D*, usb:v04F2pB221*. The first entry
124 * of a list of retrieved properties is returned.
126 * Returns: a udev_list_entry.
128 _public_
struct udev_list_entry
*udev_hwdb_get_properties_list_entry(struct udev_hwdb
*hwdb
, const char *modalias
, unsigned int flags
) {
129 const char *key
, *value
;
131 if (!hwdb
|| !modalias
) {
136 udev_list_cleanup(&hwdb
->properties_list
);
138 SD_HWDB_FOREACH_PROPERTY(hwdb
->hwdb
, modalias
, key
, value
) {
139 if (udev_list_entry_add(&hwdb
->properties_list
, key
, value
) == NULL
) {
145 return udev_list_get_entry(&hwdb
->properties_list
);