2 * libudev - interface to udev device information
4 * Copyright (C) 2008 Kay Sievers <kay.sievers@vrfy.org>
6 * This library is free software; you can redistribute it and/or
7 * modify it under the terms of the GNU Lesser General Public
8 * License as published by the Free Software Foundation; either
9 * version 2.1 of the License, or (at your option) any later version.
23 #include "libudev-private.h"
25 static int devices_sort(struct udev_enumerate *udev_enumerate);
27 struct udev_enumerate {
30 struct udev_list_node sysattr_match_list;
31 struct udev_list_node sysattr_nomatch_list;
32 struct udev_list_node subsystem_match_list;
33 struct udev_list_node subsystem_nomatch_list;
34 struct udev_list_node properties_match_list;
35 struct udev_list_node devices_list;
41 * @udev: udev library context
43 * Returns: an enumeration context
45 struct udev_enumerate *udev_enumerate_new(struct udev *udev)
47 struct udev_enumerate *udev_enumerate;
49 udev_enumerate = calloc(1, sizeof(struct udev_enumerate));
50 if (udev_enumerate == NULL)
52 udev_enumerate->refcount = 1;
53 udev_enumerate->udev = udev;
54 udev_list_init(&udev_enumerate->devices_list);
55 udev_list_init(&udev_enumerate->sysattr_match_list);
56 udev_list_init(&udev_enumerate->sysattr_nomatch_list);
57 udev_list_init(&udev_enumerate->subsystem_match_list);
58 udev_list_init(&udev_enumerate->subsystem_nomatch_list);
59 udev_list_init(&udev_enumerate->properties_match_list);
60 return udev_enumerate;
63 struct udev_enumerate *udev_enumerate_ref(struct udev_enumerate *udev_enumerate)
65 if (udev_enumerate == NULL)
67 udev_enumerate->refcount++;
68 return udev_enumerate;
71 void udev_enumerate_unref(struct udev_enumerate *udev_enumerate)
73 if (udev_enumerate == NULL)
75 udev_enumerate->refcount--;
76 if (udev_enumerate->refcount > 0)
78 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->devices_list);
79 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->sysattr_match_list);
80 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->sysattr_nomatch_list);
81 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->subsystem_match_list);
82 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->subsystem_nomatch_list);
83 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->properties_match_list);
87 struct udev *udev_enumerate_get_udev(struct udev_enumerate *udev_enumerate)
89 if (udev_enumerate == NULL)
91 return udev_enumerate->udev;
94 struct udev_list_entry *udev_enumerate_get_list_entry(struct udev_enumerate *udev_enumerate)
96 if (udev_enumerate == NULL)
98 if (!udev_enumerate->devices_sorted)
99 devices_sort(udev_enumerate);
100 return udev_list_get_entry(&udev_enumerate->devices_list);
103 int udev_enumerate_add_match_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
105 if (udev_enumerate == NULL)
107 if (subsystem == NULL)
109 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
110 &udev_enumerate->subsystem_match_list, subsystem, NULL, 1, 0) == NULL)
115 int udev_enumerate_add_nomatch_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
117 if (udev_enumerate == NULL)
119 if (subsystem == NULL)
121 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
122 &udev_enumerate->subsystem_nomatch_list, subsystem, NULL, 1, 0) == NULL)
127 int udev_enumerate_add_match_sysattr(struct udev_enumerate *udev_enumerate, const char *sysattr, const char *value)
129 if (udev_enumerate == NULL)
133 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
134 &udev_enumerate->sysattr_match_list, sysattr, value, 1, 0) == NULL)
139 int udev_enumerate_add_nomatch_sysattr(struct udev_enumerate *udev_enumerate, const char *sysattr, const char *value)
141 if (udev_enumerate == NULL)
145 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
146 &udev_enumerate->sysattr_nomatch_list, sysattr, value, 1, 0) == NULL)
151 static int match_sysattr_value(struct udev *udev, const char *syspath, const char *sysattr, const char *match_val)
153 struct udev_device *device;
154 const char *val = NULL;
157 device = udev_device_new_from_syspath(udev, syspath);
160 val = udev_device_get_sysattr_value(device, sysattr);
163 if (match_val == NULL) {
167 if (fnmatch(match_val, val, 0) == 0) {
172 udev_device_unref(device);
176 int udev_enumerate_add_match_property(struct udev_enumerate *udev_enumerate, const char *property, const char *value)
178 if (udev_enumerate == NULL)
180 if (property == NULL)
182 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
183 &udev_enumerate->properties_match_list, property, value, 1, 0) == NULL)
188 static int match_sysattr(struct udev_enumerate *udev_enumerate, const char *syspath)
190 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
191 struct udev_list_entry *list_entry;
194 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->sysattr_nomatch_list)) {
195 if (match_sysattr_value(udev, syspath,
196 udev_list_entry_get_name(list_entry),
197 udev_list_entry_get_value(list_entry)))
201 if (udev_list_get_entry(&udev_enumerate->sysattr_match_list) != NULL) {
202 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->sysattr_match_list)) {
203 /* anything that does not match, will make it FALSE */
204 if (!match_sysattr_value(udev, syspath,
205 udev_list_entry_get_name(list_entry),
206 udev_list_entry_get_value(list_entry)))
214 static int match_property(struct udev_enumerate *udev_enumerate, const char *syspath)
216 struct udev_device *dev;
217 struct udev_list_entry *list_entry;
220 /* no match always matches */
221 if (udev_list_get_entry(&udev_enumerate->properties_match_list) == NULL)
224 /* no device does not match */
225 dev = udev_device_new_from_syspath(udev_enumerate->udev, syspath);
229 /* loop over matches */
230 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->properties_match_list)) {
231 struct udev_list_entry *property_entry;
233 /* loop over device properties */
234 udev_list_entry_foreach(property_entry, udev_device_get_properties_list_entry(dev)) {
235 if (fnmatch(udev_list_entry_get_name(list_entry), udev_list_entry_get_name(property_entry), 0) == 0) {
236 const char *match_value;
237 const char *dev_value;
239 match_value = udev_list_entry_get_value(list_entry);
240 dev_value = udev_list_entry_get_value(property_entry);
241 if (match_value == NULL && dev_value == NULL) {
245 if (match_value == NULL || dev_value == NULL)
247 if (fnmatch(match_value, dev_value, 0) == 0) {
255 udev_device_unref(dev);
259 static int scan_dir_and_add_devices(struct udev_enumerate *udev_enumerate,
260 const char *basedir, const char *subdir1, const char *subdir2)
262 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
263 char path[UTIL_PATH_SIZE];
267 util_strlcpy(path, udev_get_sys_path(udev), sizeof(path));
268 util_strlcat(path, "/", sizeof(path));
269 util_strlcat(path, basedir, sizeof(path));
270 if (subdir1 != NULL) {
271 util_strlcat(path, "/", sizeof(path));
272 util_strlcat(path, subdir1, sizeof(path));
274 if (subdir2 != NULL) {
275 util_strlcat(path, "/", sizeof(path));
276 util_strlcat(path, subdir2, sizeof(path));
281 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
282 char syspath[UTIL_PATH_SIZE];
283 char filename[UTIL_PATH_SIZE];
286 if (dent->d_name[0] == '.')
288 util_strlcpy(syspath, path, sizeof(syspath));
289 util_strlcat(syspath, "/", sizeof(syspath));
290 util_strlcat(syspath, dent->d_name, sizeof(syspath));
291 if (lstat(syspath, &statbuf) != 0)
293 if (S_ISREG(statbuf.st_mode))
295 if (S_ISLNK(statbuf.st_mode))
296 util_resolve_sys_link(udev, syspath, sizeof(syspath));
297 util_strlcpy(filename, syspath, sizeof(filename));
298 util_strlcat(filename, "/uevent", sizeof(filename));
299 if (stat(filename, &statbuf) != 0)
301 if (!match_sysattr(udev_enumerate, syspath))
303 if (!match_property(udev_enumerate, syspath))
305 udev_list_entry_add(udev, &udev_enumerate->devices_list, syspath, NULL, 1, 1);
311 static int match_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
313 struct udev_list_entry *list_entry;
315 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->subsystem_nomatch_list)) {
316 if (fnmatch(udev_list_entry_get_name(list_entry), subsystem, 0) == 0)
319 if (udev_list_get_entry(&udev_enumerate->subsystem_match_list) != NULL) {
320 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->subsystem_match_list)) {
321 if (fnmatch(udev_list_entry_get_name(list_entry), subsystem, 0) == 0)
329 static int scan_dir(struct udev_enumerate *udev_enumerate, const char *basedir, const char *subdir, const char *subsystem)
331 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
333 char path[UTIL_PATH_SIZE];
337 util_strlcpy(path, udev_get_sys_path(udev), sizeof(path));
338 util_strlcat(path, "/", sizeof(path));
339 util_strlcat(path, basedir, sizeof(path));
343 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
344 if (dent->d_name[0] == '.')
346 if (!match_subsystem(udev_enumerate, subsystem != NULL ? subsystem : dent->d_name))
348 scan_dir_and_add_devices(udev_enumerate, basedir, dent->d_name, subdir);
354 static int devices_delay(struct udev *udev, const char *syspath)
356 static const char *delay_device_list[] = {
364 len = strlen(udev_get_sys_path(udev));
365 for (i = 0; delay_device_list[i] != NULL; i++) {
366 if (strstr(&syspath[len], delay_device_list[i]) != NULL) {
367 dbg(udev, "delaying: %s\n", syspath);
374 /* sort delayed devices to the end of the list */
375 static int devices_sort(struct udev_enumerate *udev_enumerate)
377 struct udev_list_entry *entry_loop;
378 struct udev_list_entry *entry_tmp;
379 struct udev_list_node devices_list;
381 udev_list_init(&devices_list);
382 /* move delayed to delay list */
383 udev_list_entry_foreach_safe(entry_loop, entry_tmp, udev_list_get_entry(&udev_enumerate->devices_list)) {
384 if (devices_delay(udev_enumerate->udev, udev_list_entry_get_name(entry_loop))) {
385 udev_list_entry_remove(entry_loop);
386 udev_list_entry_append(entry_loop, &devices_list);
389 /* move delayed back to end of list */
390 udev_list_entry_foreach_safe(entry_loop, entry_tmp, udev_list_get_entry(&devices_list)) {
391 udev_list_entry_remove(entry_loop);
392 udev_list_entry_append(entry_loop, &udev_enumerate->devices_list);
394 udev_enumerate->devices_sorted = 1;
398 int udev_enumerate_add_syspath(struct udev_enumerate *udev_enumerate, const char *syspath)
400 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
401 struct udev_device *udev_device;
403 if (udev_enumerate == NULL)
407 /* resolve to real syspath */
408 udev_device = udev_device_new_from_syspath(udev_enumerate->udev, syspath);
409 if (udev_device == NULL)
411 udev_list_entry_add(udev, &udev_enumerate->devices_list,
412 udev_device_get_syspath(udev_device), NULL, 1, 1);
413 udev_device_unref(udev_device);
418 * udev_enumerate_scan_devices:
419 * @udev_enumerate: udev enumeration context
421 * Returns: a negative value on error.
423 int udev_enumerate_scan_devices(struct udev_enumerate *udev_enumerate)
425 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
426 char base[UTIL_PATH_SIZE];
429 if (udev_enumerate == NULL)
431 util_strlcpy(base, udev_get_sys_path(udev), sizeof(base));
432 util_strlcat(base, "/subsystem", sizeof(base));
433 if (stat(base, &statbuf) == 0) {
434 /* we have /subsystem/, forget all the old stuff */
435 dbg(udev, "searching '/subsystem/*/devices/*' dir\n");
436 scan_dir(udev_enumerate, "subsystem", "devices", NULL);
438 dbg(udev, "searching '/bus/*/devices/*' dir\n");
439 scan_dir(udev_enumerate, "bus", "devices", NULL);
440 dbg(udev, "searching '/class/*' dir\n");
441 scan_dir(udev_enumerate, "class", NULL, NULL);
442 /* if block isn't a class, scan /block/ */
443 util_strlcpy(base, udev_get_sys_path(udev), sizeof(base));
444 util_strlcat(base, "/class/block", sizeof(base));
445 if (stat(base, &statbuf) != 0) {
446 if (match_subsystem(udev_enumerate, "block")) {
447 dbg(udev, "searching '/block/*' dir\n");
449 scan_dir_and_add_devices(udev_enumerate, "block", NULL, NULL);
450 /* scan partitions */
451 dbg(udev, "searching '/block/*/*' dir\n");
452 scan_dir(udev_enumerate, "block", NULL, "block");
460 * udev_enumerate_scan_subsystems:
461 * @udev_enumerate: udev enumeration context
463 * Returns: a negative value on error.
465 int udev_enumerate_scan_subsystems(struct udev_enumerate *udev_enumerate)
467 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
468 char base[UTIL_PATH_SIZE];
470 const char *subsysdir;
472 if (udev_enumerate == NULL)
474 util_strlcpy(base, udev_get_sys_path(udev), sizeof(base));
475 util_strlcat(base, "/subsystem", sizeof(base));
476 if (stat(base, &statbuf) == 0)
477 subsysdir = "subsystem";
480 if (match_subsystem(udev_enumerate, "subsystem")) {
481 dbg(udev, "searching '%s/*' dir\n", subsysdir);
482 scan_dir_and_add_devices(udev_enumerate, subsysdir, NULL, NULL);
484 if (match_subsystem(udev_enumerate, "drivers")) {
485 dbg(udev, "searching '%s/*/drivers/*' dir\n", subsysdir);
486 scan_dir(udev_enumerate, subsysdir, "drivers", "drivers");