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/>.
30 #include "libudev-private.h"
32 struct udev_enumerate {
35 struct list_node devices_list;
38 struct udev_enumerate *udev_enumerate_ref(struct udev_enumerate *udev_enumerate)
40 if (udev_enumerate == NULL)
42 udev_enumerate->refcount++;
43 return udev_enumerate;
46 void udev_enumerate_unref(struct udev_enumerate *udev_enumerate)
48 if (udev_enumerate == NULL)
50 udev_enumerate->refcount--;
51 if (udev_enumerate->refcount > 0)
53 list_cleanup(udev_enumerate->udev, &udev_enumerate->devices_list);
57 struct udev *udev_enumerate_get_udev(struct udev_enumerate *udev_enumerate)
59 if (udev_enumerate == NULL)
61 return udev_enumerate->udev;
64 struct udev_list_entry *udev_enumerate_get_list_entry(struct udev_enumerate *udev_enumerate)
66 if (udev_enumerate == NULL)
68 return list_get_entry(&udev_enumerate->devices_list);
71 static int devices_scan_subsystem(struct udev *udev,
72 const char *basedir, const char *subsystem, const char *subdir,
73 struct list_node *devices_list)
75 char path[UTIL_PATH_SIZE];
79 util_strlcpy(path, udev_get_sys_path(udev), sizeof(path));
80 util_strlcat(path, basedir, sizeof(path));
81 if (subsystem != NULL) {
82 util_strlcat(path, "/", sizeof(path));
83 util_strlcat(path, subsystem, sizeof(path));
86 util_strlcat(path, subdir, sizeof(path));
90 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
91 char syspath[UTIL_PATH_SIZE];
92 char filename[UTIL_PATH_SIZE];
95 if (dent->d_name[0] == '.')
97 util_strlcpy(syspath, path, sizeof(syspath));
98 util_strlcat(syspath, "/", sizeof(syspath));
99 util_strlcat(syspath, dent->d_name, sizeof(syspath));
100 util_strlcpy(filename, syspath, sizeof(filename));
101 util_strlcat(filename, "/uevent", sizeof(filename));
102 if (stat(filename, &statbuf) != 0)
104 util_resolve_sys_link(udev, syspath, sizeof(syspath));
105 list_entry_add(udev, devices_list, syspath, NULL, 1, 1);
111 static int devices_scan_subsystems(struct udev *udev,
112 const char *basedir, const char *subdir,
113 struct udev_list_entry *subsystem_include_list,
114 struct udev_list_entry *subsystem_exclude_list,
115 struct list_node *devices_list)
117 if (subsystem_include_list != NULL) {
118 struct udev_list_entry *list_entry;
120 /* if list of subsystems to scan is given, just use this list */
121 udev_list_entry_foreach(list_entry, subsystem_include_list) {
122 if (udev_list_entry_get_by_name(subsystem_exclude_list, udev_list_entry_get_name(list_entry)) != NULL)
124 devices_scan_subsystem(udev, basedir, udev_list_entry_get_name(list_entry), subdir, devices_list);
127 char path[UTIL_PATH_SIZE];
131 /* if no list of subsystems to scan is given, scan all, and possible exclude some subsystems */
132 util_strlcpy(path, udev_get_sys_path(udev), sizeof(path));
133 util_strlcat(path, basedir, sizeof(path));
137 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
138 if (dent->d_name[0] == '.')
140 if (udev_list_entry_get_by_name(subsystem_exclude_list, dent->d_name) != NULL)
142 devices_scan_subsystem(udev, basedir, dent->d_name, subdir, devices_list);
149 static int devices_delay(struct udev *udev, const char *syspath)
151 static const char *delay_device_list[] = {
159 len = strlen(udev_get_sys_path(udev));
161 for (i = 0; delay_device_list[i] != NULL; i++) {
162 if (strstr(&syspath[len], delay_device_list[i]) != NULL) {
163 info(udev, "delaying: %s\n", syspath);
171 * udev_enumerate_new:
172 * @udev: udev library context
174 * Returns: an enumeration context
176 struct udev_enumerate *udev_enumerate_new(struct udev *udev)
178 struct udev_enumerate *udev_enumerate;
180 udev_enumerate = malloc(sizeof(struct udev_enumerate));
181 if (udev_enumerate == NULL)
183 memset(udev_enumerate, 0x00, (sizeof(struct udev_enumerate)));
184 udev_enumerate->refcount = 1;
185 udev_enumerate->udev = udev;
186 list_init(&udev_enumerate->devices_list);
187 return udev_enumerate;
191 * udev_enumerate_scan_devices:
192 * @udev_enumerate: udev enumeration context
193 * @subsystem: the list of names of subsystems to look for devices
195 * Returns: 0 on success.
197 int udev_enumerate_scan_devices(struct udev_enumerate *udev_enumerate, const char *subsystem, ...)
199 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
202 char base[UTIL_PATH_SIZE];
204 struct list_node subsystem_include_list;
205 struct list_node subsystem_exclude_list;
206 struct udev_list_entry *list_entry;
208 if (udev_enumerate == NULL)
211 va_start(vargs, subsystem);
212 list_init(&subsystem_include_list);
213 list_init(&subsystem_exclude_list);
214 for (arg = subsystem; arg != NULL; arg = va_arg(vargs, const char *)) {
216 list_entry_add(udev, &subsystem_include_list, arg, NULL, 1, 0);
218 list_entry_add(udev, &subsystem_exclude_list, &arg[1], NULL, 1, 0);
222 util_strlcpy(base, udev_get_sys_path(udev), sizeof(base));
223 util_strlcat(base, "/subsystem", sizeof(base));
224 if (stat(base, &statbuf) == 0) {
225 /* we have /subsystem/, forget all the old stuff */
226 info(udev, "searching '/subsystem/*/devices/*' dir\n");
227 devices_scan_subsystems(udev, "/subsystem", "/devices",
228 list_get_entry(&subsystem_include_list),
229 list_get_entry(&subsystem_exclude_list),
230 &udev_enumerate->devices_list);
232 info(udev, "searching '/bus/*/devices/*' dir\n");
233 devices_scan_subsystems(udev, "/bus", "/devices",
234 list_get_entry(&subsystem_include_list),
235 list_get_entry(&subsystem_exclude_list),
236 &udev_enumerate->devices_list);
237 info(udev, "searching '/class/*' dir\n");
238 devices_scan_subsystems(udev, "/class", NULL,
239 list_get_entry(&subsystem_include_list),
240 list_get_entry(&subsystem_exclude_list),
241 &udev_enumerate->devices_list);
242 /* if block isn't a class, scan /block/ */
243 util_strlcpy(base, udev_get_sys_path(udev), sizeof(base));
244 util_strlcat(base, "/class/block", sizeof(base));
245 if (stat(base, &statbuf) != 0) {
246 struct udev_list_entry *include_list = list_get_entry(&subsystem_include_list);
247 struct udev_list_entry *exclude_list = list_get_entry(&subsystem_exclude_list);
248 int include_block = (include_list == NULL || udev_list_entry_get_by_name(include_list, "block") != NULL);
249 int exclude_block = (udev_list_entry_get_by_name(exclude_list, "block") != NULL);
251 if (include_block && !exclude_block) {
252 info(udev, "searching '/block/*' dir\n");
254 devices_scan_subsystem(udev, "/block", NULL, NULL, &udev_enumerate->devices_list);
255 /* scan partitions */
256 info(udev, "searching '/block/*/*' dir\n");
257 devices_scan_subsystems(udev, "/block", NULL,
259 &udev_enumerate->devices_list);
264 list_cleanup(udev, &subsystem_include_list);
265 list_cleanup(udev, &subsystem_exclude_list);
267 /* sort delayed devices to the end of the list */
268 udev_list_entry_foreach(list_entry, list_get_entry(&udev_enumerate->devices_list)) {
269 if (devices_delay(udev, udev_list_entry_get_name(list_entry)))
270 list_entry_move_to_end(list_entry);
276 * udev_enumerate_scan_subsystems:
277 * @udev_enumerate: udev enumeration context
279 * Returns: 0 on success.
281 int udev_enumerate_scan_subsystems(struct udev_enumerate *udev_enumerate)
283 struct udev *udev = udev_enumerate_get_udev(udev_enumerate);
284 char base[UTIL_PATH_SIZE];
286 const char *subsysdir;
288 if (udev_enumerate == NULL)
291 util_strlcpy(base, udev_get_sys_path(udev), sizeof(base));
292 util_strlcat(base, "/subsystem", sizeof(base));
293 if (stat(base, &statbuf) == 0)
294 subsysdir = "/subsystem";
297 info(udev, "searching '%s/*' dir\n", subsysdir);
298 devices_scan_subsystem(udev, subsysdir, NULL, NULL, &udev_enumerate->devices_list);
299 info(udev, "searching '%s/*/drivers/*' dir\n", subsysdir);
300 devices_scan_subsystems(udev, subsysdir, "/drivers",
302 &udev_enumerate->devices_list);