2 * Copyright (C) 2004-2009 Kay Sievers <kay.sievers@vrfy.org>
4 * This program is free software: you can redistribute it and/or modify
5 * it under the terms of the GNU General Public License as published by
6 * the Free Software Foundation, either version 2 of the License, or
7 * (at your option) any later version.
9 * This program is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12 * GNU General Public License for more details.
14 * You should have received a copy of the GNU General Public License
15 * along with this program. If not, see <http://www.gnu.org/licenses/>.
30 #include <sys/types.h>
34 static bool skip_attribute(const char *name)
36 static const char const *skip[] = {
47 for (i = 0; i < ELEMENTSOF(skip); i++)
48 if (strcmp(name, skip[i]) == 0)
53 static void print_all_attributes(struct udev_device *device, const char *key)
55 struct udev_list_entry *sysattr;
57 udev_list_entry_foreach(sysattr, udev_device_get_sysattr_list_entry(device)) {
62 name = udev_list_entry_get_name(sysattr);
63 if (skip_attribute(name))
66 value = udev_device_get_sysattr_value(device, name);
70 /* skip any values that look like a path */
74 /* skip nonprintable attributes */
76 while (len > 0 && isprint(value[len-1]))
81 printf(" %s{%s}==\"%s\"\n", key, name, value);
86 static int print_device_chain(struct udev_device *device)
88 struct udev_device *device_parent;
92 "Udevadm info starts with the device specified by the devpath and then\n"
93 "walks up the chain of parent devices. It prints for every device\n"
94 "found, all possible attributes in the udev rules key format.\n"
95 "A rule to match, can be composed by the attributes of the device\n"
96 "and the attributes from one single parent device.\n"
99 printf(" looking at device '%s':\n", udev_device_get_devpath(device));
100 printf(" KERNEL==\"%s\"\n", udev_device_get_sysname(device));
101 str = udev_device_get_subsystem(device);
104 printf(" SUBSYSTEM==\"%s\"\n", str);
105 str = udev_device_get_driver(device);
108 printf(" DRIVER==\"%s\"\n", str);
109 print_all_attributes(device, "ATTR");
111 device_parent = device;
113 device_parent = udev_device_get_parent(device_parent);
114 if (device_parent == NULL)
116 printf(" looking at parent device '%s':\n", udev_device_get_devpath(device_parent));
117 printf(" KERNELS==\"%s\"\n", udev_device_get_sysname(device_parent));
118 str = udev_device_get_subsystem(device_parent);
121 printf(" SUBSYSTEMS==\"%s\"\n", str);
122 str = udev_device_get_driver(device_parent);
125 printf(" DRIVERS==\"%s\"\n", str);
126 print_all_attributes(device_parent, "ATTRS");
127 } while (device_parent != NULL);
132 static void print_record(struct udev_device *device)
136 struct udev_list_entry *list_entry;
138 printf("P: %s\n", udev_device_get_devpath(device));
140 str = udev_device_get_devnode(device);
142 printf("N: %s\n", str + strlen("/dev/"));
144 i = udev_device_get_devlink_priority(device);
146 printf("L: %i\n", i);
148 udev_list_entry_foreach(list_entry, udev_device_get_devlinks_list_entry(device))
149 printf("S: %s\n", udev_list_entry_get_name(list_entry) + strlen("/dev/"));
151 udev_list_entry_foreach(list_entry, udev_device_get_properties_list_entry(device))
153 udev_list_entry_get_name(list_entry),
154 udev_list_entry_get_value(list_entry));
158 static int stat_device(const char *name, bool export, const char *prefix)
162 if (stat(name, &statbuf) != 0)
168 printf("%sMAJOR=%d\n"
170 prefix, major(statbuf.st_dev),
171 prefix, minor(statbuf.st_dev));
173 printf("%d:%d\n", major(statbuf.st_dev), minor(statbuf.st_dev));
177 static int export_devices(struct udev *udev)
179 struct udev_enumerate *udev_enumerate;
180 struct udev_list_entry *list_entry;
182 udev_enumerate = udev_enumerate_new(udev);
183 if (udev_enumerate == NULL)
185 udev_enumerate_scan_devices(udev_enumerate);
186 udev_list_entry_foreach(list_entry, udev_enumerate_get_list_entry(udev_enumerate)) {
187 struct udev_device *device;
189 device = udev_device_new_from_syspath(udev, udev_list_entry_get_name(list_entry));
190 if (device != NULL) {
191 print_record(device);
192 udev_device_unref(device);
195 udev_enumerate_unref(udev_enumerate);
199 static void cleanup_dir(DIR *dir, mode_t mask, int depth)
206 for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
209 if (dent->d_name[0] == '.')
211 if (fstatat(dirfd(dir), dent->d_name, &stats, AT_SYMLINK_NOFOLLOW) != 0)
213 if ((stats.st_mode & mask) != 0)
215 if (S_ISDIR(stats.st_mode)) {
218 dir2 = fdopendir(openat(dirfd(dir), dent->d_name, O_RDONLY|O_NONBLOCK|O_DIRECTORY|O_CLOEXEC));
220 cleanup_dir(dir2, mask, depth-1);
223 unlinkat(dirfd(dir), dent->d_name, AT_REMOVEDIR);
225 unlinkat(dirfd(dir), dent->d_name, 0);
230 static void cleanup_db(struct udev *udev)
234 unlink("/run/udev/queue.bin");
236 dir = opendir("/run/udev/data");
238 cleanup_dir(dir, S_ISVTX, 1);
242 dir = opendir("/run/udev/links");
244 cleanup_dir(dir, 0, 2);
248 dir = opendir("/run/udev/tags");
250 cleanup_dir(dir, 0, 2);
254 dir = opendir("/run/udev/watch");
256 cleanup_dir(dir, 0, 1);
260 dir = opendir("/run/udev/firmware-missing");
262 cleanup_dir(dir, 0, 1);
267 static int uinfo(struct udev *udev, int argc, char *argv[])
269 struct udev_device *device = NULL;
272 const char *export_prefix = NULL;
273 char path[UTIL_PATH_SIZE];
274 char name[UTIL_PATH_SIZE];
275 struct udev_list_entry *list_entry;
278 static const struct option options[] = {
279 { "name", required_argument, NULL, 'n' },
280 { "path", required_argument, NULL, 'p' },
281 { "query", required_argument, NULL, 'q' },
282 { "attribute-walk", no_argument, NULL, 'a' },
283 { "cleanup-db", no_argument, NULL, 'c' },
284 { "export-db", no_argument, NULL, 'e' },
285 { "root", no_argument, NULL, 'r' },
286 { "run", no_argument, NULL, 'R' },
287 { "device-id-of-file", required_argument, NULL, 'd' },
288 { "export", no_argument, NULL, 'x' },
289 { "export-prefix", required_argument, NULL, 'P' },
290 { "version", no_argument, NULL, 'V' },
291 { "help", no_argument, NULL, 'h' },
298 ACTION_ATTRIBUTE_WALK,
300 ACTION_DEVICE_ID_FILE,
301 } action = ACTION_NONE;
310 } query = QUERY_NONE;
316 option = getopt_long(argc, argv, "aced:n:p:q:rxP:RVh", options, NULL);
322 if (device != NULL) {
323 fprintf(stderr, "device already specified\n");
327 /* add /dev if not given */
328 if (!startswith(optarg, "/dev"))
329 util_strscpyl(name, sizeof(name), "/dev/", optarg, NULL);
331 util_strscpy(name, sizeof(name), optarg);
332 util_remove_trailing_chars(name, '/');
333 if (stat(name, &statbuf) < 0) {
334 fprintf(stderr, "device node not found\n");
340 if (S_ISBLK(statbuf.st_mode)) {
342 } else if (S_ISCHR(statbuf.st_mode)) {
345 fprintf(stderr, "device node has wrong file type\n");
349 device = udev_device_new_from_devnum(udev, type, statbuf.st_rdev);
350 if (device == NULL) {
351 fprintf(stderr, "device node not found\n");
358 if (device != NULL) {
359 fprintf(stderr, "device already specified\n");
363 /* add sys dir if needed */
364 if (!startswith(optarg, "/sys"))
365 util_strscpyl(path, sizeof(path), "/sys", optarg, NULL);
367 util_strscpy(path, sizeof(path), optarg);
368 util_remove_trailing_chars(path, '/');
369 device = udev_device_new_from_syspath(udev, path);
370 if (device == NULL) {
371 fprintf(stderr, "device path not found\n");
377 action = ACTION_QUERY;
378 if (strcmp(optarg, "property") == 0 || strcmp(optarg, "env") == 0) {
379 query = QUERY_PROPERTY;
380 } else if (strcmp(optarg, "name") == 0) {
382 } else if (strcmp(optarg, "symlink") == 0) {
383 query = QUERY_SYMLINK;
384 } else if (strcmp(optarg, "path") == 0) {
386 } else if (strcmp(optarg, "all") == 0) {
389 fprintf(stderr, "unknown query type\n");
395 if (action == ACTION_NONE)
396 action = ACTION_ROOT;
400 printf("/run/udev\n");
403 action = ACTION_DEVICE_ID_FILE;
404 util_strscpy(name, sizeof(name), optarg);
407 action = ACTION_ATTRIBUTE_WALK;
410 export_devices(udev);
419 export_prefix = optarg;
422 printf("%s\n", VERSION);
425 printf("Usage: udevadm info OPTIONS\n"
426 " --query=<type> query device information:\n"
427 " name name of device node\n"
428 " symlink pointing to node\n"
429 " path sys device path\n"
430 " property the device properties\n"
432 " --path=<syspath> sys device path used for query or attribute walk\n"
433 " --name=<name> node or symlink name used for query or attribute walk\n"
434 " --root prepend dev directory to path names\n"
435 " --attribute-walk print all key matches while walking along the chain\n"
436 " of parent devices\n"
437 " --device-id-of-file=<file> print major:minor of device containing this file\n"
438 " --export export key/value pairs\n"
439 " --export-prefix export the key name with a prefix\n"
440 " --export-db export the content of the udev database\n"
441 " --cleanup-db cleanup the udev database\n"
452 if (device == NULL) {
453 fprintf(stderr, "query needs a valid device specified by --path= or --name=\n");
460 const char *node = udev_device_get_devnode(device);
463 fprintf(stderr, "no device node found\n");
469 printf("%s\n", udev_device_get_devnode(device));
471 printf("%s\n", udev_device_get_devnode(device) + strlen("/dev/"));
475 list_entry = udev_device_get_devlinks_list_entry(device);
476 while (list_entry != NULL) {
478 printf("%s", udev_list_entry_get_name(list_entry));
480 printf("%s", udev_list_entry_get_name(list_entry) + strlen("/dev/"));
481 list_entry = udev_list_entry_get_next(list_entry);
482 if (list_entry != NULL)
488 printf("%s\n", udev_device_get_devpath(device));
491 list_entry = udev_device_get_properties_list_entry(device);
492 while (list_entry != NULL) {
494 const char *prefix = export_prefix;
498 printf("%s%s='%s'\n", prefix,
499 udev_list_entry_get_name(list_entry),
500 udev_list_entry_get_value(list_entry));
502 printf("%s=%s\n", udev_list_entry_get_name(list_entry), udev_list_entry_get_value(list_entry));
504 list_entry = udev_list_entry_get_next(list_entry);
508 print_record(device);
511 fprintf(stderr, "unknown query type\n");
515 case ACTION_ATTRIBUTE_WALK:
516 if (device == NULL) {
517 fprintf(stderr, "query needs a valid device specified by --path= or --name=\n");
521 print_device_chain(device);
523 case ACTION_DEVICE_ID_FILE:
524 if (stat_device(name, export, export_prefix) != 0)
531 fprintf(stderr, "missing option\n");
537 udev_device_unref(device);
541 const struct udevadm_cmd udevadm_info = {
544 .help = "query sysfs or the udev database",