2 * libudev - interface to udev device information
4 * Copyright (C) 2008-2010 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.
22 #include <sys/param.h>
25 #include "libudev-private.h"
28 * SECTION:libudev-enumerate
29 * @short_description: lookup and sort sys devices
31 * Lookup devices in the sys filesystem, filter devices by properties,
32 * and return a sorted list of devices.
43 * Opaque object representing one device lookup/sort context.
45 struct udev_enumerate {
48 struct udev_list_node sysattr_match_list;
49 struct udev_list_node sysattr_nomatch_list;
50 struct udev_list_node subsystem_match_list;
51 struct udev_list_node subsystem_nomatch_list;
52 struct udev_list_node sysname_match_list;
53 struct udev_list_node properties_match_list;
54 struct udev_list_node tags_match_list;
55 struct udev_device *parent_match;
56 struct udev_list_node devices_list;
57 struct syspath *devices;
58 unsigned int devices_cur;
59 unsigned int devices_max;
60 bool devices_uptodate:1;
61 bool match_is_initialized;
66 * @udev: udev library context
68 * Returns: an enumeration context
70 UDEV_EXPORT struct udev_enumerate *udev_enumerate_new(struct udev *udev)
72 struct udev_enumerate *udev_enumerate;
74 udev_enumerate = calloc(1, sizeof(struct udev_enumerate));
75 if (udev_enumerate == NULL)
77 udev_enumerate->refcount = 1;
78 udev_enumerate->udev = udev;
79 udev_list_init(&udev_enumerate->sysattr_match_list);
80 udev_list_init(&udev_enumerate->sysattr_nomatch_list);
81 udev_list_init(&udev_enumerate->subsystem_match_list);
82 udev_list_init(&udev_enumerate->subsystem_nomatch_list);
83 udev_list_init(&udev_enumerate->sysname_match_list);
84 udev_list_init(&udev_enumerate->properties_match_list);
85 udev_list_init(&udev_enumerate->tags_match_list);
86 udev_list_init(&udev_enumerate->devices_list);
87 return udev_enumerate;
92 * @udev_enumerate: context
94 * Take a reference of a enumeration context.
96 * Returns: the passed enumeration context
98 UDEV_EXPORT struct udev_enumerate *udev_enumerate_ref(struct udev_enumerate *udev_enumerate)
100 if (udev_enumerate == NULL)
102 udev_enumerate->refcount++;
103 return udev_enumerate;
107 * udev_enumerate_unref:
108 * @udev_enumerate: context
110 * Drop a reference of an enumeration context. If the refcount reaches zero,
111 * all resources of the enumeration context will be released.
113 UDEV_EXPORT void udev_enumerate_unref(struct udev_enumerate *udev_enumerate)
117 if (udev_enumerate == NULL)
119 udev_enumerate->refcount--;
120 if (udev_enumerate->refcount > 0)
122 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->sysattr_match_list);
123 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->sysattr_nomatch_list);
124 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->subsystem_match_list);
125 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->subsystem_nomatch_list);
126 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->sysname_match_list);
127 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->properties_match_list);
128 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->tags_match_list);
129 udev_device_unref(udev_enumerate->parent_match);
130 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->devices_list);
131 for (i = 0; i < udev_enumerate->devices_cur; i++)
132 free(udev_enumerate->devices[i].syspath);
133 free(udev_enumerate->devices);
134 free(udev_enumerate);
138 * udev_enumerate_get_udev:
139 * @udev_enumerate: context
141 * Returns: the udev library context.
143 UDEV_EXPORT struct udev *udev_enumerate_get_udev(struct udev_enumerate *udev_enumerate)
145 if (udev_enumerate == NULL)
147 return udev_enumerate->udev;
150 static int syspath_add(struct udev_enumerate *udev_enumerate, const char *syspath)
153 struct syspath *entry;
155 /* double array size if needed */
156 if (udev_enumerate->devices_cur >= udev_enumerate->devices_max) {
160 add = udev_enumerate->devices_max;
163 buf = realloc(udev_enumerate->devices, (udev_enumerate->devices_max + add) * sizeof(struct syspath));
166 udev_enumerate->devices = buf;
167 udev_enumerate->devices_max += add;
170 path = strdup(syspath);
173 entry = &udev_enumerate->devices[udev_enumerate->devices_cur];
174 entry->syspath = path;
175 entry->len = strlen(path);
176 udev_enumerate->devices_cur++;
177 udev_enumerate->devices_uptodate = false;
181 static int syspath_cmp(const void *p1, const void *p2)
183 const struct syspath *path1 = p1;
184 const struct syspath *path2 = p2;
188 len = MIN(path1->len, path2->len);
189 ret = memcmp(path1->syspath, path2->syspath, len);
191 if (path1->len < path2->len)
193 else if (path1->len > path2->len)
199 /* For devices that should be moved to the absolute end of the list */
200 static bool devices_delay_end(struct udev *udev, const char *syspath)
202 static const char *delay_device_list[] = {
210 len = strlen(udev_get_sys_path(udev));
211 for (i = 0; delay_device_list[i] != NULL; i++) {
212 if (strstr(&syspath[len], delay_device_list[i]) != NULL) {
213 dbg(udev, "delaying: %s\n", syspath);
220 /* For devices that should just be moved a little bit later, just
221 * before the point where some common path prefix changes. Returns the
222 * number of characters that make up that common prefix */
223 static size_t devices_delay_later(struct udev *udev, const char *syspath)
227 /* For sound cards the control device must be enumerated last
228 * to make sure it's the final device node that gets ACLs
229 * applied. Applications rely on this fact and use ACL changes
230 * on the control node as an indicator that the ACL change of
231 * the entire sound card completed. The kernel makes this
232 * guarantee when creating those devices, and hence we should
233 * too when enumerating them. */
235 if ((c = strstr(syspath, "/sound/card"))) {
237 c += strcspn(c, "/");
239 if (strncmp(c, "/controlC", 9) == 0)
240 return c - syspath + 1;
247 * udev_enumerate_get_list_entry:
248 * @udev_enumerate: context
250 * Returns: the first entry of the sorted list of device paths.
252 UDEV_EXPORT struct udev_list_entry *udev_enumerate_get_list_entry(struct udev_enumerate *udev_enumerate)
254 if (udev_enumerate == NULL)
256 if (!udev_enumerate->devices_uptodate) {
259 struct syspath *prev = NULL, *move_later = NULL;
260 size_t move_later_prefix = 0;
262 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->devices_list);
263 qsort(udev_enumerate->devices, udev_enumerate->devices_cur, sizeof(struct syspath), syspath_cmp);
265 max = udev_enumerate->devices_cur;
266 for (i = 0; i < max; i++) {
267 struct syspath *entry = &udev_enumerate->devices[i];
269 /* skip duplicated entries */
271 entry->len == prev->len &&
272 memcmp(entry->syspath, prev->syspath, entry->len) == 0)
276 /* skip to be delayed devices, and add them to the end of the list */
277 if (devices_delay_end(udev_enumerate->udev, entry->syspath)) {
278 syspath_add(udev_enumerate, entry->syspath);
279 /* need to update prev here for the case realloc() gives a different address */
280 prev = &udev_enumerate->devices[i];
284 /* skip to be delayed devices, and move the to
285 * the point where the prefix changes. We can
286 * only move one item at a time. */
288 move_later_prefix = devices_delay_later(udev_enumerate->udev, entry->syspath);
290 if (move_later_prefix > 0) {
297 strncmp(entry->syspath, move_later->syspath, move_later_prefix) != 0) {
299 udev_list_entry_add(udev_enumerate->udev, &udev_enumerate->devices_list,
300 move_later->syspath, NULL, 0);
304 udev_list_entry_add(udev_enumerate->udev, &udev_enumerate->devices_list,
305 entry->syspath, NULL, 0);
309 udev_list_entry_add(udev_enumerate->udev, &udev_enumerate->devices_list,
310 move_later->syspath, NULL, 0);
312 /* add and cleanup delayed devices from end of list */
313 for (i = max; i < udev_enumerate->devices_cur; i++) {
314 struct syspath *entry = &udev_enumerate->devices[i];
316 udev_list_entry_add(udev_enumerate->udev, &udev_enumerate->devices_list,
317 entry->syspath, NULL, 0);
318 free(entry->syspath);
320 udev_enumerate->devices_cur = max;
322 udev_enumerate->devices_uptodate = true;
324 return udev_list_get_entry(&udev_enumerate->devices_list);
328 * udev_enumerate_add_match_subsystem:
329 * @udev_enumerate: context
330 * @subsystem: filter for a subsystem of the device to include in the list
332 * Returns: 0 on success, otherwise a negative error value.
334 UDEV_EXPORT int udev_enumerate_add_match_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
336 if (udev_enumerate == NULL)
338 if (subsystem == NULL)
340 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
341 &udev_enumerate->subsystem_match_list, subsystem, NULL, UDEV_LIST_UNIQUE) == NULL)
347 * udev_enumerate_add_nomatch_subsystem:
348 * @udev_enumerate: context
349 * @subsystem: filter for a subsystem of the device to exclude from the list
351 * Returns: 0 on success, otherwise a negative error value.
353 UDEV_EXPORT int udev_enumerate_add_nomatch_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
355 if (udev_enumerate == NULL)
357 if (subsystem == NULL)
359 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
360 &udev_enumerate->subsystem_nomatch_list, subsystem, NULL, UDEV_LIST_UNIQUE) == NULL)
366 * udev_enumerate_add_match_sysattr:
367 * @udev_enumerate: context
368 * @sysattr: filter for a sys attribute at the device to include in the list
369 * @value: optional value of the sys attribute
371 * Returns: 0 on success, otherwise a negative error value.
373 UDEV_EXPORT int udev_enumerate_add_match_sysattr(struct udev_enumerate *udev_enumerate, const char *sysattr, const char *value)
375 if (udev_enumerate == NULL)
379 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
380 &udev_enumerate->sysattr_match_list, sysattr, value, 0) == NULL)
386 * udev_enumerate_add_nomatch_sysattr:
387 * @udev_enumerate: context
388 * @sysattr: filter for a sys attribute at the device to exclude from the list
389 * @value: optional value of the sys attribute
391 * Returns: 0 on success, otherwise a negative error value.
393 UDEV_EXPORT int udev_enumerate_add_nomatch_sysattr(struct udev_enumerate *udev_enumerate, const char *sysattr, const char *value)
395 if (udev_enumerate == NULL)
399 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
400 &udev_enumerate->sysattr_nomatch_list, sysattr, value, 0) == NULL)
405 static int match_sysattr_value(struct udev_device *dev, const char *sysattr, const char *match_val)
407 const char *val = NULL;
410 val = udev_device_get_sysattr_value(dev, sysattr);
413 if (match_val == NULL) {
417 if (fnmatch(match_val, val, 0) == 0) {
426 * udev_enumerate_add_match_property:
427 * @udev_enumerate: context
428 * @property: filter for a property of the device to include in the list
429 * @value: value of the property
431 * Returns: 0 on success, otherwise a negative error value.
433 UDEV_EXPORT int udev_enumerate_add_match_property(struct udev_enumerate *udev_enumerate, const char *property, const char *value)
435 if (udev_enumerate == NULL)
437 if (property == NULL)
439 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
440 &udev_enumerate->properties_match_list, property, value, 0) == NULL)
446 * udev_enumerate_add_match_tag:
447 * @udev_enumerate: context
448 * @tag: filter for a tag of the device to include in the list
450 * Returns: 0 on success, otherwise a negative error value.
452 UDEV_EXPORT int udev_enumerate_add_match_tag(struct udev_enumerate *udev_enumerate, const char *tag)
454 if (udev_enumerate == NULL)
458 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
459 &udev_enumerate->tags_match_list, tag, NULL, UDEV_LIST_UNIQUE) == NULL)
465 * udev_enumerate_add_match_parent:
466 * @udev_enumerate: context
467 * @parent: filter for the parent device
469 * Return only the children of a given device.
471 * A reference for the device is held until the udev_enumerate context
474 * Returns: 0 on success, otherwise a negative error value.
476 UDEV_EXPORT int udev_enumerate_add_match_parent(struct udev_enumerate *udev_enumerate, struct udev_device *parent)
478 if (udev_enumerate == NULL)
482 if (udev_enumerate->parent_match != NULL)
483 udev_device_unref(udev_enumerate->parent_match);
484 udev_enumerate->parent_match = udev_device_ref(parent);
489 * udev_enumerate_add_match_is_initialized:
490 * @udev_enumerate: context
492 * Match only devices which udev has set up already. This makes
493 * sure, that the device node permissions and context are properly set
494 * and that network devices are fully renamed.
496 * Usually, devices which are found in the kernel but not already
497 * handled by udev, have still pending events. Services should subscribe
498 * to monitor events and wait for these devices to become ready, instead
499 * of using uninitialized devices.
501 * For now, this will not affect devices which do not have a device node
502 * and are not network interfaces.
504 * Returns: 0 on success, otherwise a negative error value.
506 UDEV_EXPORT int udev_enumerate_add_match_is_initialized(struct udev_enumerate *udev_enumerate)
508 if (udev_enumerate == NULL)
510 udev_enumerate->match_is_initialized = true;
515 * udev_enumerate_add_match_sysname:
516 * @udev_enumerate: context
517 * @sysname: filter for the name of the device to include in the list
519 * Returns: 0 on success, otherwise a negative error value.
521 UDEV_EXPORT int udev_enumerate_add_match_sysname(struct udev_enumerate *udev_enumerate, const char *sysname)
523 if (udev_enumerate == NULL)
527 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
528 &udev_enumerate->sysname_match_list, sysname, NULL, UDEV_LIST_UNIQUE) == NULL)
533 static bool match_sysattr(struct udev_enumerate *udev_enumerate, struct udev_device *dev)
535 struct udev_list_entry *list_entry;
538 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->sysattr_nomatch_list)) {
539 if (match_sysattr_value(dev, udev_list_entry_get_name(list_entry),
540 udev_list_entry_get_value(list_entry)))
544 if (udev_list_get_entry(&udev_enumerate->sysattr_match_list) != NULL) {
545 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->sysattr_match_list)) {
546 /* anything that does not match, will make it FALSE */
547 if (!match_sysattr_value(dev, udev_list_entry_get_name(list_entry),
548 udev_list_entry_get_value(list_entry)))
556 static bool match_property(struct udev_enumerate *udev_enumerate, struct udev_device *dev)
558 struct udev_list_entry *list_entry;
561 /* no match always matches */
562 if (udev_list_get_entry(&udev_enumerate->properties_match_list) == NULL)
565 /* loop over matches */
566 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->properties_match_list)) {
567 const char *match_key = udev_list_entry_get_name(list_entry);
568 const char *match_value = udev_list_entry_get_value(list_entry);
569 struct udev_list_entry *property_entry;
571 /* loop over device properties */
572 udev_list_entry_foreach(property_entry, udev_device_get_properties_list_entry(dev)) {
573 const char *dev_key = udev_list_entry_get_name(property_entry);
574 const char *dev_value = udev_list_entry_get_value(property_entry);
576 if (fnmatch(match_key, dev_key, 0) != 0)
578 if (match_value == NULL && dev_value == NULL) {
582 if (match_value == NULL || dev_value == NULL)
584 if (fnmatch(match_value, dev_value, 0) == 0) {
594 static bool match_tag(struct udev_enumerate *udev_enumerate, struct udev_device *dev)
596 struct udev_list_entry *list_entry;
598 /* no match always matches */
599 if (udev_list_get_entry(&udev_enumerate->tags_match_list) == NULL)
602 /* loop over matches */
603 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->tags_match_list))
604 if (!udev_device_has_tag(dev, udev_list_entry_get_name(list_entry)))
610 static bool match_parent(struct udev_enumerate *udev_enumerate, struct udev_device *dev)
614 if (udev_enumerate->parent_match == NULL)
617 parent = udev_device_get_devpath(udev_enumerate->parent_match);
618 return strncmp(parent, udev_device_get_devpath(dev), strlen(parent)) == 0;
621 static bool match_sysname(struct udev_enumerate *udev_enumerate, const char *sysname)
623 struct udev_list_entry *list_entry;
625 if (udev_list_get_entry(&udev_enumerate->sysname_match_list) == NULL)
628 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->sysname_match_list)) {
629 if (fnmatch(udev_list_entry_get_name(list_entry), sysname, 0) != 0)
636 static int scan_dir_and_add_devices(struct udev_enumerate *udev_enumerate,
637 const char *basedir, const char *subdir1, const char *subdir2)
639 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
640 char path[UTIL_PATH_SIZE];
647 l = util_strpcpyl(&s, sizeof(path), udev_get_sys_path(udev), "/", basedir, NULL);
649 l = util_strpcpyl(&s, l, "/", subdir1, NULL);
651 util_strpcpyl(&s, l, "/", subdir2, NULL);
655 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
656 char syspath[UTIL_PATH_SIZE];
657 struct udev_device *dev;
659 if (dent->d_name[0] == '.')
662 if (!match_sysname(udev_enumerate, dent->d_name))
665 util_strscpyl(syspath, sizeof(syspath), path, "/", dent->d_name, NULL);
666 dev = udev_device_new_from_syspath(udev_enumerate->udev, syspath);
670 if (udev_enumerate->match_is_initialized) {
672 * All devices with a device node or network interfaces
673 * possibly need udev to adjust the device node permission
674 * or context, or rename the interface before it can be
675 * reliably used from other processes.
677 * For now, we can only check these types of devices, we
678 * might not store a database, and have no way to find out
679 * for all other types of devices.
681 if (!udev_device_get_is_initialized(dev) &&
682 (major(udev_device_get_devnum(dev)) > 0 || udev_device_get_ifindex(dev) > 0))
685 if (!match_parent(udev_enumerate, dev))
687 if (!match_tag(udev_enumerate, dev))
689 if (!match_property(udev_enumerate, dev))
691 if (!match_sysattr(udev_enumerate, dev))
694 syspath_add(udev_enumerate, udev_device_get_syspath(dev));
696 udev_device_unref(dev);
702 static bool match_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
704 struct udev_list_entry *list_entry;
706 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->subsystem_nomatch_list)) {
707 if (fnmatch(udev_list_entry_get_name(list_entry), subsystem, 0) == 0)
710 if (udev_list_get_entry(&udev_enumerate->subsystem_match_list) != NULL) {
711 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->subsystem_match_list)) {
712 if (fnmatch(udev_list_entry_get_name(list_entry), subsystem, 0) == 0)
720 static int scan_dir(struct udev_enumerate *udev_enumerate, const char *basedir, const char *subdir, const char *subsystem)
722 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
724 char path[UTIL_PATH_SIZE];
728 util_strscpyl(path, sizeof(path), udev_get_sys_path(udev), "/", basedir, NULL);
732 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
733 if (dent->d_name[0] == '.')
735 if (!match_subsystem(udev_enumerate, subsystem != NULL ? subsystem : dent->d_name))
737 scan_dir_and_add_devices(udev_enumerate, basedir, dent->d_name, subdir);
744 * udev_enumerate_add_syspath:
745 * @udev_enumerate: context
746 * @syspath: path of a device
748 * Add a device to the list of devices, to retrieve it back sorted in dependency order.
750 * Returns: 0 on success, otherwise a negative error value.
752 UDEV_EXPORT int udev_enumerate_add_syspath(struct udev_enumerate *udev_enumerate, const char *syspath)
754 struct udev_device *udev_device;
756 if (udev_enumerate == NULL)
760 /* resolve to real syspath */
761 udev_device = udev_device_new_from_syspath(udev_enumerate->udev, syspath);
762 if (udev_device == NULL)
764 syspath_add(udev_enumerate, udev_device_get_syspath(udev_device));
765 udev_device_unref(udev_device);
769 static int scan_devices_tags(struct udev_enumerate *udev_enumerate)
771 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
772 struct udev_list_entry *list_entry;
774 /* scan only tagged devices, use tags reverse-index, instead of searching all devices in /sys */
775 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->tags_match_list)) {
778 char path[UTIL_PATH_SIZE];
780 util_strscpyl(path, sizeof(path), udev_get_run_path(udev), "/tags/",
781 udev_list_entry_get_name(list_entry), NULL);
785 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
786 struct udev_device *dev;
788 if (dent->d_name[0] == '.')
791 dev = udev_device_new_from_id_filename(udev_enumerate->udev, dent->d_name);
795 if (!match_subsystem(udev_enumerate, udev_device_get_subsystem(dev)))
797 if (!match_sysname(udev_enumerate, udev_device_get_sysname(dev)))
799 if (!match_parent(udev_enumerate, dev))
801 if (!match_property(udev_enumerate, dev))
803 if (!match_sysattr(udev_enumerate, dev))
806 syspath_add(udev_enumerate, udev_device_get_syspath(dev));
808 udev_device_unref(dev);
815 static int parent_add_child(struct udev_enumerate *enumerate, const char *path)
817 struct udev_device *dev;
819 dev = udev_device_new_from_syspath(enumerate->udev, path);
823 if (!match_subsystem(enumerate, udev_device_get_subsystem(dev)))
825 if (!match_sysname(enumerate, udev_device_get_sysname(dev)))
827 if (!match_property(enumerate, dev))
829 if (!match_sysattr(enumerate, dev))
832 syspath_add(enumerate, udev_device_get_syspath(dev));
833 udev_device_unref(dev);
837 static int parent_crawl_children(struct udev_enumerate *enumerate, const char *path, int maxdepth)
846 for (dent = readdir(d); dent != NULL; dent = readdir(d)) {
849 if (dent->d_name[0] == '.')
851 if (dent->d_type != DT_DIR)
853 if (asprintf(&child, "%s/%s", path, dent->d_name) < 0)
855 parent_add_child(enumerate, child);
857 parent_crawl_children(enumerate, child, maxdepth-1);
865 static int scan_devices_all(struct udev_enumerate *udev_enumerate)
867 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
868 char base[UTIL_PATH_SIZE];
871 util_strscpyl(base, sizeof(base), udev_get_sys_path(udev), "/subsystem", NULL);
872 if (stat(base, &statbuf) == 0) {
873 /* we have /subsystem/, forget all the old stuff */
874 dbg(udev, "searching '/subsystem/*/devices/*' dir\n");
875 scan_dir(udev_enumerate, "subsystem", "devices", NULL);
877 dbg(udev, "searching '/bus/*/devices/*' dir\n");
878 scan_dir(udev_enumerate, "bus", "devices", NULL);
879 dbg(udev, "searching '/class/*' dir\n");
880 scan_dir(udev_enumerate, "class", NULL, NULL);
886 * udev_enumerate_scan_devices:
887 * @udev_enumerate: udev enumeration context
889 * Returns: 0 on success, otherwise a negative error value.
891 UDEV_EXPORT int udev_enumerate_scan_devices(struct udev_enumerate *udev_enumerate)
893 if (udev_enumerate == NULL)
896 if (udev_list_get_entry(&udev_enumerate->tags_match_list) != NULL)
897 return scan_devices_tags(udev_enumerate);
899 if (udev_enumerate->parent_match != NULL)
900 return parent_crawl_children(udev_enumerate, udev_device_get_syspath(udev_enumerate->parent_match), 256);
902 return scan_devices_all(udev_enumerate);
906 * udev_enumerate_scan_subsystems:
907 * @udev_enumerate: udev enumeration context
909 * Returns: 0 on success, otherwise a negative error value.
911 UDEV_EXPORT int udev_enumerate_scan_subsystems(struct udev_enumerate *udev_enumerate)
913 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
914 char base[UTIL_PATH_SIZE];
916 const char *subsysdir;
918 if (udev_enumerate == NULL)
921 /* all kernel modules */
922 if (match_subsystem(udev_enumerate, "module")) {
923 dbg(udev, "searching '%s/modules/*' dir\n", subsysdir);
924 scan_dir_and_add_devices(udev_enumerate, "module", NULL, NULL);
927 util_strscpyl(base, sizeof(base), udev_get_sys_path(udev), "/subsystem", NULL);
928 if (stat(base, &statbuf) == 0)
929 subsysdir = "subsystem";
933 /* all subsystems (only buses support coldplug) */
934 if (match_subsystem(udev_enumerate, "subsystem")) {
935 dbg(udev, "searching '%s/*' dir\n", subsysdir);
936 scan_dir_and_add_devices(udev_enumerate, subsysdir, NULL, NULL);
939 /* all subsystem drivers */
940 if (match_subsystem(udev_enumerate, "drivers")) {
941 dbg(udev, "searching '%s/*/drivers/*' dir\n", subsysdir);
942 scan_dir(udev_enumerate, subsysdir, "drivers", "drivers");