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_list_node devices_list;
56 struct syspath *devices;
57 unsigned int devices_cur;
58 unsigned int devices_max;
59 bool devices_uptodate:1;
60 bool match_is_initialized;
65 * @udev: udev library context
67 * Returns: an enumeration context
69 struct udev_enumerate *udev_enumerate_new(struct udev *udev)
71 struct udev_enumerate *udev_enumerate;
73 udev_enumerate = calloc(1, sizeof(struct udev_enumerate));
74 if (udev_enumerate == NULL)
76 udev_enumerate->refcount = 1;
77 udev_enumerate->udev = udev;
78 udev_list_init(&udev_enumerate->sysattr_match_list);
79 udev_list_init(&udev_enumerate->sysattr_nomatch_list);
80 udev_list_init(&udev_enumerate->subsystem_match_list);
81 udev_list_init(&udev_enumerate->subsystem_nomatch_list);
82 udev_list_init(&udev_enumerate->sysname_match_list);
83 udev_list_init(&udev_enumerate->properties_match_list);
84 udev_list_init(&udev_enumerate->tags_match_list);
85 udev_list_init(&udev_enumerate->devices_list);
86 return udev_enumerate;
91 * @udev_enumerate: context
93 * Take a reference of a enumeration context.
95 * Returns: the passed enumeration context
97 struct udev_enumerate *udev_enumerate_ref(struct udev_enumerate *udev_enumerate)
99 if (udev_enumerate == NULL)
101 udev_enumerate->refcount++;
102 return udev_enumerate;
106 * udev_enumerate_unref:
107 * @udev_enumerate: context
109 * Drop a reference of an enumeration context. If the refcount reaches zero,
110 * all resources of the enumeration context will be released.
112 void udev_enumerate_unref(struct udev_enumerate *udev_enumerate)
116 if (udev_enumerate == NULL)
118 udev_enumerate->refcount--;
119 if (udev_enumerate->refcount > 0)
121 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->sysattr_match_list);
122 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->sysattr_nomatch_list);
123 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->subsystem_match_list);
124 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->subsystem_nomatch_list);
125 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->sysname_match_list);
126 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->properties_match_list);
127 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->tags_match_list);
128 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->devices_list);
129 for (i = 0; i < udev_enumerate->devices_cur; i++)
130 free(udev_enumerate->devices[i].syspath);
131 free(udev_enumerate->devices);
132 free(udev_enumerate);
136 * udev_enumerate_get_udev:
137 * @udev_enumerate: context
139 * Returns: the udev library context.
141 struct udev *udev_enumerate_get_udev(struct udev_enumerate *udev_enumerate)
143 if (udev_enumerate == NULL)
145 return udev_enumerate->udev;
148 static int syspath_add(struct udev_enumerate *udev_enumerate, const char *syspath)
151 struct syspath *entry;
153 /* double array size if needed */
154 if (udev_enumerate->devices_cur >= udev_enumerate->devices_max) {
158 add = udev_enumerate->devices_max;
161 buf = realloc(udev_enumerate->devices, (udev_enumerate->devices_max + add) * sizeof(struct syspath));
164 udev_enumerate->devices = buf;
165 udev_enumerate->devices_max += add;
168 path = strdup(syspath);
171 entry = &udev_enumerate->devices[udev_enumerate->devices_cur];
172 entry->syspath = path;
173 entry->len = strlen(path);
174 udev_enumerate->devices_cur++;
175 udev_enumerate->devices_uptodate = false;
179 static int syspath_cmp(const void *p1, const void *p2)
181 const struct syspath *path1 = p1;
182 const struct syspath *path2 = p2;
186 len = MIN(path1->len, path2->len);
187 ret = memcmp(path1->syspath, path2->syspath, len);
189 if (path1->len < path2->len)
191 else if (path1->len > path2->len)
197 /* For devices that should be moved to the absolute end of the list */
198 static bool devices_delay_end(struct udev *udev, const char *syspath)
200 static const char *delay_device_list[] = {
208 len = strlen(udev_get_sys_path(udev));
209 for (i = 0; delay_device_list[i] != NULL; i++) {
210 if (strstr(&syspath[len], delay_device_list[i]) != NULL) {
211 dbg(udev, "delaying: %s\n", syspath);
218 /* For devices that should just be moved a little bit later, just
219 * before the point where some common path prefix changes. Returns the
220 * number of characters that make up that common prefix */
221 static size_t devices_delay_later(struct udev *udev, const char *syspath)
225 /* For sound cards the control device must be enumerated last
226 * to make sure it's the final device node that gets ACLs
227 * applied. Applications rely on this fact and use ACL changes
228 * on the control node as an indicator that the ACL change of
229 * the entire sound card completed. The kernel makes this
230 * guarantee when creating those devices, and hence we should
231 * too when enumerating them. */
233 if ((c = strstr(syspath, "/sound/card"))) {
235 c += strcspn(c, "/");
237 if (strncmp(c, "/controlC", 9) == 0)
238 return c - syspath + 1;
245 * udev_enumerate_get_list_entry:
246 * @udev_enumerate: context
248 * Returns: the first entry of the sorted list of device paths.
250 struct udev_list_entry *udev_enumerate_get_list_entry(struct udev_enumerate *udev_enumerate)
252 if (udev_enumerate == NULL)
254 if (!udev_enumerate->devices_uptodate) {
257 struct syspath *prev = NULL, *move_later = NULL;
258 size_t move_later_prefix = 0;
260 udev_list_cleanup_entries(udev_enumerate->udev, &udev_enumerate->devices_list);
261 qsort(udev_enumerate->devices, udev_enumerate->devices_cur, sizeof(struct syspath), syspath_cmp);
263 max = udev_enumerate->devices_cur;
264 for (i = 0; i < max; i++) {
265 struct syspath *entry = &udev_enumerate->devices[i];
267 /* skip duplicated entries */
269 entry->len == prev->len &&
270 memcmp(entry->syspath, prev->syspath, entry->len) == 0)
274 /* skip to be delayed devices, and add them to the end of the list */
275 if (devices_delay_end(udev_enumerate->udev, entry->syspath)) {
276 syspath_add(udev_enumerate, entry->syspath);
277 /* need to update prev here for the case realloc() gives
278 a different address */
279 prev = &udev_enumerate->devices[i];
283 /* skip to be delayed devices, and move the to
284 * the point where the prefix changes. We can
285 * only move one item at a time. */
287 move_later_prefix = devices_delay_later(udev_enumerate->udev, entry->syspath);
289 if (move_later_prefix > 0) {
296 strncmp(entry->syspath, move_later->syspath, move_later_prefix) != 0) {
298 udev_list_entry_add(udev_enumerate->udev, &udev_enumerate->devices_list,
299 move_later->syspath, NULL, 0, 0);
303 udev_list_entry_add(udev_enumerate->udev, &udev_enumerate->devices_list,
304 entry->syspath, NULL, 0, 0);
308 udev_list_entry_add(udev_enumerate->udev, &udev_enumerate->devices_list,
309 move_later->syspath, NULL, 0, 0);
311 /* add and cleanup delayed devices from end of list */
312 for (i = max; i < udev_enumerate->devices_cur; i++) {
313 struct syspath *entry = &udev_enumerate->devices[i];
315 udev_list_entry_add(udev_enumerate->udev, &udev_enumerate->devices_list,
316 entry->syspath, NULL, 0, 0);
317 free(entry->syspath);
319 udev_enumerate->devices_cur = max;
321 udev_enumerate->devices_uptodate = true;
323 return udev_list_get_entry(&udev_enumerate->devices_list);
327 * udev_enumerate_add_match_subsystem:
328 * @udev_enumerate: context
329 * @subsystem: filter for a subsystem of the device to include in the list
331 * Returns: 0 on success, otherwise a negative error value.
333 int udev_enumerate_add_match_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
335 if (udev_enumerate == NULL)
337 if (subsystem == NULL)
339 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
340 &udev_enumerate->subsystem_match_list, subsystem, NULL, 1, 0) == NULL)
346 * udev_enumerate_add_nomatch_subsystem:
347 * @udev_enumerate: context
348 * @subsystem: filter for a subsystem of the device to exclude from the list
350 * Returns: 0 on success, otherwise a negative error value.
352 int udev_enumerate_add_nomatch_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
354 if (udev_enumerate == NULL)
356 if (subsystem == NULL)
358 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
359 &udev_enumerate->subsystem_nomatch_list, subsystem, NULL, 1, 0) == NULL)
365 * udev_enumerate_add_match_sysattr:
366 * @udev_enumerate: context
367 * @sysattr: filter for a sys attribute at the device to include in the list
368 * @value: optional value of the sys attribute
370 * Returns: 0 on success, otherwise a negative error value.
372 int udev_enumerate_add_match_sysattr(struct udev_enumerate *udev_enumerate, const char *sysattr, const char *value)
374 if (udev_enumerate == NULL)
378 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
379 &udev_enumerate->sysattr_match_list, sysattr, value, 0, 0) == NULL)
385 * udev_enumerate_add_nomatch_sysattr:
386 * @udev_enumerate: context
387 * @sysattr: filter for a sys attribute at the device to exclude from the list
388 * @value: optional value of the sys attribute
390 * Returns: 0 on success, otherwise a negative error value.
392 int udev_enumerate_add_nomatch_sysattr(struct udev_enumerate *udev_enumerate, const char *sysattr, const char *value)
394 if (udev_enumerate == NULL)
398 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
399 &udev_enumerate->sysattr_nomatch_list, sysattr, value, 0, 0) == NULL)
404 static int match_sysattr_value(struct udev_device *dev, const char *sysattr, const char *match_val)
406 const char *val = NULL;
409 val = udev_device_get_sysattr_value(dev, sysattr);
412 if (match_val == NULL) {
416 if (fnmatch(match_val, val, 0) == 0) {
425 * udev_enumerate_add_match_property:
426 * @udev_enumerate: context
427 * @property: filter for a property of the device to include in the list
428 * @value: value of the property
430 * Returns: 0 on success, otherwise a negative error value.
432 int udev_enumerate_add_match_property(struct udev_enumerate *udev_enumerate, const char *property, const char *value)
434 if (udev_enumerate == NULL)
436 if (property == NULL)
438 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
439 &udev_enumerate->properties_match_list, property, value, 0, 0) == NULL)
445 * udev_enumerate_add_match_tag:
446 * @udev_enumerate: context
447 * @tag: filter for a tag of the device to include in the list
449 * Returns: 0 on success, otherwise a negative error value.
451 int udev_enumerate_add_match_tag(struct udev_enumerate *udev_enumerate, const char *tag)
453 if (udev_enumerate == NULL)
457 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
458 &udev_enumerate->tags_match_list, tag, NULL, 1, 0) == NULL)
464 * udev_enumerate_add_match_is_initialized:
465 * @udev_enumerate: context
467 * Match only devices which udev has set up already. This makes
468 * sure, that the device node permissions and context are properly set
469 * and that network devices are fully renamed.
471 * Usually, devices which are found in the kernel but not already
472 * handled by udev, have still pending events. Services should subscribe
473 * to monitor events and wait for these devices to become ready, instead
474 * of using uninitialized devices.
476 * For now, this will not affect devices which do not have a device node
477 * and are not network interfaces.
479 * Returns: 0 on success, otherwise a negative error value.
481 int udev_enumerate_add_match_is_initialized(struct udev_enumerate *udev_enumerate)
483 if (udev_enumerate == NULL)
485 udev_enumerate->match_is_initialized = true;
490 * udev_enumerate_add_match_sysname:
491 * @udev_enumerate: context
492 * @sysname: filter for the name of the device to include in the list
494 * Returns: 0 on success, otherwise a negative error value.
496 int udev_enumerate_add_match_sysname(struct udev_enumerate *udev_enumerate, const char *sysname)
498 if (udev_enumerate == NULL)
502 if (udev_list_entry_add(udev_enumerate_get_udev(udev_enumerate),
503 &udev_enumerate->sysname_match_list, sysname, NULL, 1, 0) == NULL)
508 static bool match_sysattr(struct udev_enumerate *udev_enumerate, struct udev_device *dev)
510 struct udev_list_entry *list_entry;
513 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->sysattr_nomatch_list)) {
514 if (match_sysattr_value(dev, udev_list_entry_get_name(list_entry),
515 udev_list_entry_get_value(list_entry)))
519 if (udev_list_get_entry(&udev_enumerate->sysattr_match_list) != NULL) {
520 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->sysattr_match_list)) {
521 /* anything that does not match, will make it FALSE */
522 if (!match_sysattr_value(dev, udev_list_entry_get_name(list_entry),
523 udev_list_entry_get_value(list_entry)))
531 static bool match_property(struct udev_enumerate *udev_enumerate, struct udev_device *dev)
533 struct udev_list_entry *list_entry;
536 /* no match always matches */
537 if (udev_list_get_entry(&udev_enumerate->properties_match_list) == NULL)
540 /* loop over matches */
541 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->properties_match_list)) {
542 const char *match_key = udev_list_entry_get_name(list_entry);
543 const char *match_value = udev_list_entry_get_value(list_entry);
544 struct udev_list_entry *property_entry;
546 /* loop over device properties */
547 udev_list_entry_foreach(property_entry, udev_device_get_properties_list_entry(dev)) {
548 const char *dev_key = udev_list_entry_get_name(property_entry);
549 const char *dev_value = udev_list_entry_get_value(property_entry);
551 if (fnmatch(match_key, dev_key, 0) != 0)
553 if (match_value == NULL && dev_value == NULL) {
557 if (match_value == NULL || dev_value == NULL)
559 if (fnmatch(match_value, dev_value, 0) == 0) {
569 static bool match_tag(struct udev_enumerate *udev_enumerate, struct udev_device *dev)
571 struct udev_list_entry *list_entry;
573 /* no match always matches */
574 if (udev_list_get_entry(&udev_enumerate->tags_match_list) == NULL)
577 /* loop over matches */
578 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->tags_match_list))
579 if (!udev_device_has_tag(dev, udev_list_entry_get_name(list_entry)))
585 static bool match_sysname(struct udev_enumerate *udev_enumerate, const char *sysname)
587 struct udev_list_entry *list_entry;
589 if (udev_list_get_entry(&udev_enumerate->sysname_match_list) == NULL)
592 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->sysname_match_list)) {
593 if (fnmatch(udev_list_entry_get_name(list_entry), sysname, 0) != 0)
600 static int scan_dir_and_add_devices(struct udev_enumerate *udev_enumerate,
601 const char *basedir, const char *subdir1, const char *subdir2)
603 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
604 char path[UTIL_PATH_SIZE];
611 l = util_strpcpyl(&s, sizeof(path), udev_get_sys_path(udev), "/", basedir, NULL);
613 l = util_strpcpyl(&s, l, "/", subdir1, NULL);
615 util_strpcpyl(&s, l, "/", subdir2, NULL);
619 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
620 char syspath[UTIL_PATH_SIZE];
621 struct udev_device *dev;
623 if (dent->d_name[0] == '.')
626 if (!match_sysname(udev_enumerate, dent->d_name))
629 util_strscpyl(syspath, sizeof(syspath), path, "/", dent->d_name, NULL);
630 dev = udev_device_new_from_syspath(udev_enumerate->udev, syspath);
634 if (udev_enumerate->match_is_initialized) {
636 * All devices with a device node or network interfaces
637 * possibly need udev to adjust the device node permission
638 * or context, or rename the interface before it can be
639 * reliably used from other processes.
641 * For now, we can only check these types of devices, we
642 * might not store a database, and have no way to find out
643 * for all other types of devices.
645 if (!udev_device_get_is_initialized(dev) &&
646 (major(udev_device_get_devnum(dev)) > 0 || udev_device_get_ifindex(dev) > 0))
649 if (!match_tag(udev_enumerate, dev))
651 if (!match_property(udev_enumerate, dev))
653 if (!match_sysattr(udev_enumerate, dev))
656 syspath_add(udev_enumerate, udev_device_get_syspath(dev));
658 udev_device_unref(dev);
664 static bool match_subsystem(struct udev_enumerate *udev_enumerate, const char *subsystem)
666 struct udev_list_entry *list_entry;
668 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->subsystem_nomatch_list)) {
669 if (fnmatch(udev_list_entry_get_name(list_entry), subsystem, 0) == 0)
672 if (udev_list_get_entry(&udev_enumerate->subsystem_match_list) != NULL) {
673 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->subsystem_match_list)) {
674 if (fnmatch(udev_list_entry_get_name(list_entry), subsystem, 0) == 0)
682 static int scan_dir(struct udev_enumerate *udev_enumerate, const char *basedir, const char *subdir, const char *subsystem)
684 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
686 char path[UTIL_PATH_SIZE];
690 util_strscpyl(path, sizeof(path), udev_get_sys_path(udev), "/", basedir, NULL);
694 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
695 if (dent->d_name[0] == '.')
697 if (!match_subsystem(udev_enumerate, subsystem != NULL ? subsystem : dent->d_name))
699 scan_dir_and_add_devices(udev_enumerate, basedir, dent->d_name, subdir);
706 * udev_enumerate_add_syspath:
707 * @udev_enumerate: context
708 * @syspath: path of a device
710 * Add a device to the list of devices, to retrieve it back sorted in dependency order.
712 * Returns: 0 on success, otherwise a negative error value.
714 int udev_enumerate_add_syspath(struct udev_enumerate *udev_enumerate, const char *syspath)
716 struct udev_device *udev_device;
718 if (udev_enumerate == NULL)
722 /* resolve to real syspath */
723 udev_device = udev_device_new_from_syspath(udev_enumerate->udev, syspath);
724 if (udev_device == NULL)
726 syspath_add(udev_enumerate, udev_device_get_syspath(udev_device));
727 udev_device_unref(udev_device);
732 * udev_enumerate_scan_devices:
733 * @udev_enumerate: udev enumeration context
735 * Returns: 0 on success, otherwise a negative error value.
737 int udev_enumerate_scan_devices(struct udev_enumerate *udev_enumerate)
739 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
740 char base[UTIL_PATH_SIZE];
743 if (udev_enumerate == NULL)
746 if (udev_list_get_entry(&udev_enumerate->tags_match_list) != NULL) {
747 struct udev_list_entry *list_entry;
749 /* scan only tagged devices, use tags reverse-index, instead of searching all devices in /sys */
750 udev_list_entry_foreach(list_entry, udev_list_get_entry(&udev_enumerate->tags_match_list)) {
753 char path[UTIL_PATH_SIZE];
755 util_strscpyl(path, sizeof(path), udev_get_dev_path(udev), "/.udev/tags/",
756 udev_list_entry_get_name(list_entry), NULL);
760 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
761 struct udev_device *dev;
763 if (dent->d_name[0] == '.')
766 dev = udev_device_new_from_id_filename(udev_enumerate->udev, dent->d_name);
769 syspath_add(udev_enumerate, udev_device_get_syspath(dev));
770 udev_device_unref(dev);
775 util_strscpyl(base, sizeof(base), udev_get_sys_path(udev), "/subsystem", NULL);
776 if (stat(base, &statbuf) == 0) {
777 /* we have /subsystem/, forget all the old stuff */
778 dbg(udev, "searching '/subsystem/*/devices/*' dir\n");
779 scan_dir(udev_enumerate, "subsystem", "devices", NULL);
781 dbg(udev, "searching '/bus/*/devices/*' dir\n");
782 scan_dir(udev_enumerate, "bus", "devices", NULL);
783 dbg(udev, "searching '/class/*' dir\n");
784 scan_dir(udev_enumerate, "class", NULL, NULL);
792 * udev_enumerate_scan_subsystems:
793 * @udev_enumerate: udev enumeration context
795 * Returns: 0 on success, otherwise a negative error value.
797 int udev_enumerate_scan_subsystems(struct udev_enumerate *udev_enumerate)
799 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
800 char base[UTIL_PATH_SIZE];
802 const char *subsysdir;
804 if (udev_enumerate == NULL)
807 util_strscpyl(base, sizeof(base), udev_get_sys_path(udev), "/subsystem", NULL);
808 if (stat(base, &statbuf) == 0)
809 subsysdir = "subsystem";
812 if (match_subsystem(udev_enumerate, "subsystem")) {
813 dbg(udev, "searching '%s/*' dir\n", subsysdir);
814 scan_dir_and_add_devices(udev_enumerate, subsysdir, NULL, NULL);
816 if (match_subsystem(udev_enumerate, "drivers")) {
817 dbg(udev, "searching '%s/*/drivers/*' dir\n", subsysdir);
818 scan_dir(udev_enumerate, subsysdir, "drivers", "drivers");