2 * libudev - interface to udev device information
4 * Copyright (C) 2008 Kay Sievers <kay.sievers@vrfy.org>
6 * This program is free software: you can redistribute it and/or modify
7 * it under the terms of the GNU General Public License as published by
8 * the Free Software Foundation, either version 2 of the License, or
9 * (at your option) any later version.
11 * This program is distributed in the hope that it will be useful,
12 * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 * GNU General Public License for more details.
16 * You should have received a copy of the GNU General Public License
17 * along with this program. If not, see <http://www.gnu.org/licenses/>.
31 #include "libudev-private.h"
33 struct udev_enumerate {
36 struct list_node attr_match_list;
37 struct list_node attr_nomatch_list;
38 struct list_node subsystem_match_list;
39 struct list_node subsystem_nomatch_list;
40 struct list_node devices_list;
45 * @udev: udev library context
47 * Returns: an enumeration context
49 struct udev_enumerate *udev_enumerate_new(struct udev *udev)
51 struct udev_enumerate *udev_enumerate;
53 udev_enumerate = malloc(sizeof(struct udev_enumerate));
54 if (udev_enumerate == NULL)
56 memset(udev_enumerate, 0x00, (sizeof(struct udev_enumerate)));
57 udev_enumerate->refcount = 1;
58 udev_enumerate->udev = udev;
59 list_init(&udev_enumerate->devices_list);
60 list_init(&udev_enumerate->attr_match_list);
61 list_init(&udev_enumerate->attr_nomatch_list);
62 list_init(&udev_enumerate->subsystem_match_list);
63 list_init(&udev_enumerate->subsystem_nomatch_list);
64 return udev_enumerate;
67 struct udev_enumerate *udev_enumerate_ref(struct udev_enumerate *udev_enumerate)
69 if (udev_enumerate == NULL)
71 udev_enumerate->refcount++;
72 return udev_enumerate;
75 void udev_enumerate_unref(struct udev_enumerate *udev_enumerate)
77 if (udev_enumerate == NULL)
79 udev_enumerate->refcount--;
80 if (udev_enumerate->refcount > 0)
82 list_cleanup(udev_enumerate->udev, &udev_enumerate->devices_list);
83 list_cleanup(udev_enumerate->udev, &udev_enumerate->attr_match_list);
84 list_cleanup(udev_enumerate->udev, &udev_enumerate->attr_nomatch_list);
85 list_cleanup(udev_enumerate->udev, &udev_enumerate->subsystem_match_list);
86 list_cleanup(udev_enumerate->udev, &udev_enumerate->subsystem_nomatch_list);
90 struct udev *udev_enumerate_get_udev(struct udev_enumerate *udev_enumerate)
92 if (udev_enumerate == NULL)
94 return udev_enumerate->udev;
97 struct udev_list_entry *udev_enumerate_get_list_entry(struct udev_enumerate *udev_enumerate)
99 if (udev_enumerate == NULL)
101 return list_get_entry(&udev_enumerate->devices_list);
104 int udev_enumerate_add_match_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
106 if (udev_enumerate == NULL)
108 if (subsystem == NULL)
110 if (list_entry_add(udev_enumerate_get_udev(udev_enumerate),
111 &udev_enumerate->subsystem_match_list, subsystem, NULL, 1, 0) == NULL)
116 int udev_enumerate_add_nomatch_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
118 if (udev_enumerate == NULL)
120 if (subsystem == NULL)
122 if (list_entry_add(udev_enumerate_get_udev(udev_enumerate),
123 &udev_enumerate->subsystem_nomatch_list, subsystem, NULL, 1, 0) == NULL)
128 int udev_enumerate_add_match_attr(struct udev_enumerate *udev_enumerate, const char *attr, const char *value)
130 if (udev_enumerate == NULL)
134 if (list_entry_add(udev_enumerate_get_udev(udev_enumerate),
135 &udev_enumerate->attr_match_list, attr, value, 1, 0) == NULL)
140 int udev_enumerate_add_nomatch_attr(struct udev_enumerate *udev_enumerate, const char *attr, const char *value)
142 if (udev_enumerate == NULL)
146 if (list_entry_add(udev_enumerate_get_udev(udev_enumerate),
147 &udev_enumerate->attr_nomatch_list, attr, value, 1, 0) == NULL)
152 static int match_attr_value(struct udev *udev, const char *syspath, const char *attr, const char *match_val)
154 struct udev_device *device;
155 const char *val = NULL;
158 device = udev_device_new_from_syspath(udev, syspath);
161 val = udev_device_get_attr_value(device, attr);
164 if (match_val == NULL) {
168 if (fnmatch(match_val, val, 0) == 0) {
173 udev_device_unref(device);
177 static int match_attr(struct udev_enumerate *udev_enumerate, const char *syspath)
179 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
180 struct udev_list_entry *list_entry;
183 udev_list_entry_foreach(list_entry, list_get_entry(&udev_enumerate->attr_nomatch_list)) {
184 if (match_attr_value(udev, syspath,
185 udev_list_entry_get_name(list_entry),
186 udev_list_entry_get_value(list_entry)))
190 if (list_get_entry(&udev_enumerate->attr_match_list) != NULL) {
191 udev_list_entry_foreach(list_entry, list_get_entry(&udev_enumerate->attr_match_list)) {
192 /* anything that does not match, will make it FALSE */
193 if (!match_attr_value(udev, syspath,
194 udev_list_entry_get_name(list_entry),
195 udev_list_entry_get_value(list_entry)))
203 static int scan_dir_and_add_devices(struct udev_enumerate *udev_enumerate, const char *basedir, const char *subdir1, const char *subdir2)
205 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
206 char path[UTIL_PATH_SIZE];
210 util_strlcpy(path, udev_get_sys_path(udev), sizeof(path));
211 util_strlcat(path, "/", sizeof(path));
212 util_strlcat(path, basedir, sizeof(path));
213 if (subdir1 != NULL) {
214 util_strlcat(path, "/", sizeof(path));
215 util_strlcat(path, subdir1, sizeof(path));
217 if (subdir2 != NULL) {
218 util_strlcat(path, "/", sizeof(path));
219 util_strlcat(path, subdir2, sizeof(path));
224 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
225 char syspath[UTIL_PATH_SIZE];
226 char filename[UTIL_PATH_SIZE];
229 if (dent->d_name[0] == '.')
231 util_strlcpy(syspath, path, sizeof(syspath));
232 util_strlcat(syspath, "/", sizeof(syspath));
233 util_strlcat(syspath, dent->d_name, sizeof(syspath));
234 util_strlcpy(filename, syspath, sizeof(filename));
235 util_strlcat(filename, "/uevent", sizeof(filename));
236 if (stat(filename, &statbuf) != 0)
238 util_resolve_sys_link(udev, syspath, sizeof(syspath));
239 if (!match_attr(udev_enumerate, syspath))
241 list_entry_add(udev, &udev_enumerate->devices_list, syspath, NULL, 1, 1);
247 static int match_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
249 struct udev_list_entry *list_entry;
251 udev_list_entry_foreach(list_entry, list_get_entry(&udev_enumerate->subsystem_nomatch_list)) {
252 if (fnmatch(udev_list_entry_get_name(list_entry), subsystem, 0) == 0)
255 if (list_get_entry(&udev_enumerate->subsystem_match_list) != NULL) {
256 udev_list_entry_foreach(list_entry, list_get_entry(&udev_enumerate->subsystem_match_list)) {
257 if (fnmatch(udev_list_entry_get_name(list_entry), subsystem, 0) == 0)
265 static int scan_dir(struct udev_enumerate *udev_enumerate, const char *basedir, const char *subdir, const char *match)
267 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
269 char path[UTIL_PATH_SIZE];
273 util_strlcpy(path, udev_get_sys_path(udev), sizeof(path));
274 util_strlcat(path, "/", sizeof(path));
275 util_strlcat(path, basedir, sizeof(path));
279 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
280 if (dent->d_name[0] == '.')
282 if (!match_subsystem(udev_enumerate, match != NULL ? match : dent->d_name))
284 scan_dir_and_add_devices(udev_enumerate, basedir, dent->d_name, subdir);
290 static int devices_delay(struct udev *udev, const char *syspath)
292 static const char *delay_device_list[] = {
300 len = strlen(udev_get_sys_path(udev));
301 for (i = 0; delay_device_list[i] != NULL; i++) {
302 if (strstr(&syspath[len], delay_device_list[i]) != NULL) {
303 info(udev, "delaying: %s\n", syspath);
310 int udev_enumerate_add_device(struct udev_enumerate *udev_enumerate, struct udev_device *udev_device)
312 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
313 struct udev_list_entry *list_entry;
315 if (udev_enumerate == NULL)
317 if (udev_device == NULL)
320 &udev_enumerate->devices_list,
321 udev_device_get_syspath(udev_device), NULL, 1, 1);
322 /* sort delayed devices to the end of the list */
323 udev_list_entry_foreach(list_entry, list_get_entry(&udev_enumerate->devices_list)) {
324 if (devices_delay(udev, udev_list_entry_get_name(list_entry)))
325 list_entry_move_to_end(list_entry);
331 * udev_enumerate_scan_devices:
332 * @udev_enumerate: udev enumeration context
334 * Returns: a negative value on error.
336 int udev_enumerate_scan_devices(struct udev_enumerate *udev_enumerate)
338 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
339 char base[UTIL_PATH_SIZE];
341 struct udev_list_entry *list_entry;
343 if (udev_enumerate == NULL)
345 util_strlcpy(base, udev_get_sys_path(udev), sizeof(base));
346 util_strlcat(base, "/subsystem", sizeof(base));
347 if (stat(base, &statbuf) == 0) {
348 /* we have /subsystem/, forget all the old stuff */
349 info(udev, "searching '/subsystem/*/devices/*' dir\n");
350 scan_dir(udev_enumerate, "subsystem", "devices", NULL);
352 info(udev, "searching '/bus/*/devices/*' dir\n");
353 scan_dir(udev_enumerate, "bus", "devices", NULL);
354 info(udev, "searching '/class/*' dir\n");
355 scan_dir(udev_enumerate, "class", NULL, NULL);
356 /* if block isn't a class, scan /block/ */
357 util_strlcpy(base, udev_get_sys_path(udev), sizeof(base));
358 util_strlcat(base, "/class/block", sizeof(base));
359 if (stat(base, &statbuf) != 0) {
360 if (match_subsystem(udev_enumerate, "block")) {
361 info(udev, "searching '/block/*' dir\n");
363 scan_dir_and_add_devices(udev_enumerate, "block", NULL, NULL);
364 /* scan partitions */
365 info(udev, "searching '/block/*/*' dir\n");
366 scan_dir(udev_enumerate, "block", NULL, "block");
370 /* sort delayed devices to the end of the list */
371 udev_list_entry_foreach(list_entry, list_get_entry(&udev_enumerate->devices_list)) {
372 if (devices_delay(udev, udev_list_entry_get_name(list_entry)))
373 list_entry_move_to_end(list_entry);
379 * udev_enumerate_scan_subsystems:
380 * @udev_enumerate: udev enumeration context
382 * Returns: a negative value on error.
384 int udev_enumerate_scan_subsystems(struct udev_enumerate *udev_enumerate)
386 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
387 char base[UTIL_PATH_SIZE];
389 const char *subsysdir;
391 if (udev_enumerate == NULL)
393 util_strlcpy(base, udev_get_sys_path(udev), sizeof(base));
394 util_strlcat(base, "/subsystem", sizeof(base));
395 if (stat(base, &statbuf) == 0)
396 subsysdir = "subsystem";
399 if (match_subsystem(udev_enumerate, "subsystem")) {
400 info(udev, "searching '%s/*' dir\n", subsysdir);
401 scan_dir_and_add_devices(udev_enumerate, subsysdir, NULL, NULL);
403 info(udev, "searching '%s/*/drivers/*' dir\n", subsysdir);
404 scan_dir(udev_enumerate, subsysdir, "drivers", "drivers");