2 * Copyright (C) 2004-2009 Kay Sievers <kay@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 "string-util.h"
31 #include "udev-util.h"
33 #include "udevadm-util.h"
35 static bool skip_attribute(const char *name
) {
36 static const char* const skip
[] = {
47 for (i
= 0; i
< ELEMENTSOF(skip
); i
++)
48 if (streq(name
, skip
[i
]))
53 static void print_all_attributes(struct udev_device
*device
, const char *key
) {
54 struct udev_list_entry
*sysattr
;
56 udev_list_entry_foreach(sysattr
, udev_device_get_sysattr_list_entry(device
)) {
61 name
= udev_list_entry_get_name(sysattr
);
62 if (skip_attribute(name
))
65 value
= udev_device_get_sysattr_value(device
, name
);
69 /* skip any values that look like a path */
73 /* skip nonprintable attributes */
75 while (len
> 0 && isprint(value
[len
-1]))
80 printf(" %s{%s}==\"%s\"\n", key
, name
, value
);
85 static int print_device_chain(struct udev_device
*device
) {
86 struct udev_device
*device_parent
;
90 "Udevadm info starts with the device specified by the devpath and then\n"
91 "walks up the chain of parent devices. It prints for every device\n"
92 "found, all possible attributes in the udev rules key format.\n"
93 "A rule to match, can be composed by the attributes of the device\n"
94 "and the attributes from one single parent device.\n"
97 printf(" looking at device '%s':\n", udev_device_get_devpath(device
));
98 printf(" KERNEL==\"%s\"\n", udev_device_get_sysname(device
));
99 str
= udev_device_get_subsystem(device
);
102 printf(" SUBSYSTEM==\"%s\"\n", str
);
103 str
= udev_device_get_driver(device
);
106 printf(" DRIVER==\"%s\"\n", str
);
107 print_all_attributes(device
, "ATTR");
109 device_parent
= device
;
111 device_parent
= udev_device_get_parent(device_parent
);
112 if (device_parent
== NULL
)
114 printf(" looking at parent device '%s':\n", udev_device_get_devpath(device_parent
));
115 printf(" KERNELS==\"%s\"\n", udev_device_get_sysname(device_parent
));
116 str
= udev_device_get_subsystem(device_parent
);
119 printf(" SUBSYSTEMS==\"%s\"\n", str
);
120 str
= udev_device_get_driver(device_parent
);
123 printf(" DRIVERS==\"%s\"\n", str
);
124 print_all_attributes(device_parent
, "ATTRS");
125 } while (device_parent
!= NULL
);
130 static void print_record(struct udev_device
*device
) {
133 struct udev_list_entry
*list_entry
;
135 printf("P: %s\n", udev_device_get_devpath(device
));
137 str
= udev_device_get_devnode(device
);
139 printf("N: %s\n", str
+ strlen("/dev/"));
141 i
= udev_device_get_devlink_priority(device
);
143 printf("L: %i\n", i
);
145 udev_list_entry_foreach(list_entry
, udev_device_get_devlinks_list_entry(device
))
146 printf("S: %s\n", udev_list_entry_get_name(list_entry
) + strlen("/dev/"));
148 udev_list_entry_foreach(list_entry
, udev_device_get_properties_list_entry(device
))
150 udev_list_entry_get_name(list_entry
),
151 udev_list_entry_get_value(list_entry
));
155 static int stat_device(const char *name
, bool export
, const char *prefix
) {
158 if (stat(name
, &statbuf
) != 0)
164 printf("%sMAJOR=%u\n"
166 prefix
, major(statbuf
.st_dev
),
167 prefix
, minor(statbuf
.st_dev
));
169 printf("%u:%u\n", major(statbuf
.st_dev
), minor(statbuf
.st_dev
));
173 static int export_devices(struct udev
*udev
) {
174 struct udev_enumerate
*udev_enumerate
;
175 struct udev_list_entry
*list_entry
;
177 udev_enumerate
= udev_enumerate_new(udev
);
178 if (udev_enumerate
== NULL
)
180 udev_enumerate_scan_devices(udev_enumerate
);
181 udev_list_entry_foreach(list_entry
, udev_enumerate_get_list_entry(udev_enumerate
)) {
182 struct udev_device
*device
;
184 device
= udev_device_new_from_syspath(udev
, udev_list_entry_get_name(list_entry
));
185 if (device
!= NULL
) {
186 print_record(device
);
187 udev_device_unref(device
);
190 udev_enumerate_unref(udev_enumerate
);
194 static void cleanup_dir(DIR *dir
, mode_t mask
, int depth
) {
200 for (dent
= readdir(dir
); dent
!= NULL
; dent
= readdir(dir
)) {
203 if (dent
->d_name
[0] == '.')
205 if (fstatat(dirfd(dir
), dent
->d_name
, &stats
, AT_SYMLINK_NOFOLLOW
) != 0)
207 if ((stats
.st_mode
& mask
) != 0)
209 if (S_ISDIR(stats
.st_mode
)) {
210 _cleanup_closedir_
DIR *dir2
;
212 dir2
= fdopendir(openat(dirfd(dir
), dent
->d_name
, O_RDONLY
|O_NONBLOCK
|O_DIRECTORY
|O_CLOEXEC
));
214 cleanup_dir(dir2
, mask
, depth
-1);
216 (void) unlinkat(dirfd(dir
), dent
->d_name
, AT_REMOVEDIR
);
218 (void) unlinkat(dirfd(dir
), dent
->d_name
, 0);
222 static void cleanup_db(struct udev
*udev
) {
225 unlink("/run/udev/queue.bin");
227 dir
= opendir("/run/udev/data");
229 cleanup_dir(dir
, S_ISVTX
, 1);
233 dir
= opendir("/run/udev/links");
235 cleanup_dir(dir
, 0, 2);
239 dir
= opendir("/run/udev/tags");
241 cleanup_dir(dir
, 0, 2);
245 dir
= opendir("/run/udev/static_node-tags");
247 cleanup_dir(dir
, 0, 2);
251 dir
= opendir("/run/udev/watch");
253 cleanup_dir(dir
, 0, 1);
258 static void help(void) {
260 printf("%s info [OPTIONS] [DEVPATH|FILE]\n\n"
261 "Query sysfs or the udev database.\n\n"
262 " -h --help Print this message\n"
263 " --version Print version of the program\n"
264 " -q --query=TYPE Query device information:\n"
265 " name Name of device node\n"
266 " symlink Pointing to node\n"
267 " path sysfs device path\n"
268 " property The device properties\n"
270 " -p --path=SYSPATH sysfs device path used for query or attribute walk\n"
271 " -n --name=NAME Node or symlink name used for query or attribute walk\n"
272 " -r --root Prepend dev directory to path names\n"
273 " -a --attribute-walk Print all key matches walking along the chain\n"
274 " of parent devices\n"
275 " -d --device-id-of-file=FILE Print major:minor of device containing this file\n"
276 " -x --export Export key/value pairs\n"
277 " -P --export-prefix Export the key name with a prefix\n"
278 " -e --export-db Export the content of the udev database\n"
279 " -c --cleanup-db Clean up the udev database\n"
280 , program_invocation_short_name
);
283 static int uinfo(struct udev
*udev
, int argc
, char *argv
[]) {
284 _cleanup_udev_device_unref_
struct udev_device
*device
= NULL
;
287 const char *export_prefix
= NULL
;
288 char name
[UTIL_PATH_SIZE
];
289 struct udev_list_entry
*list_entry
;
292 static const struct option options
[] = {
293 { "name", required_argument
, NULL
, 'n' },
294 { "path", required_argument
, NULL
, 'p' },
295 { "query", required_argument
, NULL
, 'q' },
296 { "attribute-walk", no_argument
, NULL
, 'a' },
297 { "cleanup-db", no_argument
, NULL
, 'c' },
298 { "export-db", no_argument
, NULL
, 'e' },
299 { "root", no_argument
, NULL
, 'r' },
300 { "device-id-of-file", required_argument
, NULL
, 'd' },
301 { "export", no_argument
, NULL
, 'x' },
302 { "export-prefix", required_argument
, NULL
, 'P' },
303 { "version", no_argument
, NULL
, 'V' },
304 { "help", no_argument
, NULL
, 'h' },
310 ACTION_ATTRIBUTE_WALK
,
311 ACTION_DEVICE_ID_FILE
,
312 } action
= ACTION_QUERY
;
322 while ((c
= getopt_long(argc
, argv
, "aced:n:p:q:rxP:RVh", options
, NULL
)) >= 0)
325 if (device
!= NULL
) {
326 fprintf(stderr
, "device already specified\n");
330 device
= find_device(udev
, optarg
, "/dev/");
331 if (device
== NULL
) {
332 fprintf(stderr
, "device node not found\n");
338 if (device
!= NULL
) {
339 fprintf(stderr
, "device already specified\n");
343 device
= find_device(udev
, optarg
, "/sys");
344 if (device
== NULL
) {
345 fprintf(stderr
, "syspath not found\n");
350 action
= ACTION_QUERY
;
351 if (streq(optarg
, "property") || streq(optarg
, "env"))
352 query
= QUERY_PROPERTY
;
353 else if (streq(optarg
, "name"))
355 else if (streq(optarg
, "symlink"))
356 query
= QUERY_SYMLINK
;
357 else if (streq(optarg
, "path"))
359 else if (streq(optarg
, "all"))
362 fprintf(stderr
, "unknown query type\n");
370 action
= ACTION_DEVICE_ID_FILE
;
371 strscpy(name
, sizeof(name
), optarg
);
374 action
= ACTION_ATTRIBUTE_WALK
;
377 export_devices(udev
);
386 export_prefix
= optarg
;
389 printf("%s\n", VERSION
);
405 device
= find_device(udev
, argv
[optind
], NULL
);
407 fprintf(stderr
, "Unknown device, --name=, --path=, or absolute path in /dev/ or /sys expected.\n");
414 const char *node
= udev_device_get_devnode(device
);
417 fprintf(stderr
, "no device node found\n");
422 printf("%s\n", udev_device_get_devnode(device
));
424 printf("%s\n", udev_device_get_devnode(device
) + strlen("/dev/"));
428 list_entry
= udev_device_get_devlinks_list_entry(device
);
429 while (list_entry
!= NULL
) {
431 printf("%s", udev_list_entry_get_name(list_entry
));
433 printf("%s", udev_list_entry_get_name(list_entry
) + strlen("/dev/"));
434 list_entry
= udev_list_entry_get_next(list_entry
);
435 if (list_entry
!= NULL
)
441 printf("%s\n", udev_device_get_devpath(device
));
444 list_entry
= udev_device_get_properties_list_entry(device
);
445 while (list_entry
!= NULL
) {
447 const char *prefix
= export_prefix
;
451 printf("%s%s='%s'\n", prefix
,
452 udev_list_entry_get_name(list_entry
),
453 udev_list_entry_get_value(list_entry
));
455 printf("%s=%s\n", udev_list_entry_get_name(list_entry
), udev_list_entry_get_value(list_entry
));
457 list_entry
= udev_list_entry_get_next(list_entry
);
461 print_record(device
);
464 assert_not_reached("unknown query type");
467 case ACTION_ATTRIBUTE_WALK
:
468 if (!device
&& argv
[optind
]) {
469 device
= find_device(udev
, argv
[optind
], NULL
);
471 fprintf(stderr
, "Unknown device, absolute path in /dev/ or /sys expected.\n");
476 fprintf(stderr
, "Unknown device, --name=, --path=, or absolute path in /dev/ or /sys expected.\n");
479 print_device_chain(device
);
481 case ACTION_DEVICE_ID_FILE
:
482 if (stat_device(name
, export
, export_prefix
) != 0)
490 const struct udevadm_cmd udevadm_info
= {
493 .help
= "Query sysfs or the udev database",