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.
23 #include "libudev-private.h"
27 * @short_description: libudev context
29 * The context contains the default values read from the udev config file,
30 * and is passed to all library operations.
36 * Opaque object representing the library context.
40 void (*log_fn)(struct udev *udev,
41 int priority, const char *file, int line, const char *fn,
42 const char *format, va_list args);
47 unsigned long long rules_path_ts[4];
50 struct udev_list properties_list;
54 void udev_log(struct udev *udev,
55 int priority, const char *file, int line, const char *fn,
56 const char *format, ...)
60 va_start(args, format);
61 udev->log_fn(udev, priority, file, line, fn, format, args);
65 static void log_stderr(struct udev *udev,
66 int priority, const char *file, int line, const char *fn,
67 const char *format, va_list args)
69 fprintf(stderr, "libudev: %s: ", fn);
70 vfprintf(stderr, format, args);
75 * @udev: udev library context
77 * Retrieve stored data pointer from library context. This might be useful
78 * to access from callbacks like a custom logging function.
80 * Returns: stored userdata
82 UDEV_EXPORT void *udev_get_userdata(struct udev *udev)
86 return udev->userdata;
91 * @udev: udev library context
92 * @userdata: data pointer
94 * Store custom @userdata in the library context.
96 UDEV_EXPORT void udev_set_userdata(struct udev *udev, void *userdata)
100 udev->userdata = userdata;
103 static char *set_value(char **s, const char *v)
107 util_remove_trailing_chars(*s, '/');
114 * Create udev library context. This reads the udev configuration
115 * file, and fills in the default values.
117 * The initial refcount is 1, and needs to be decremented to
118 * release the resources of the udev library context.
120 * Returns: a new udev library context
122 UDEV_EXPORT struct udev *udev_new(void)
126 char *config_file = NULL;
129 udev = calloc(1, sizeof(struct udev));
133 udev->log_fn = log_stderr;
134 udev->log_priority = LOG_ERR;
135 udev_list_init(udev, &udev->properties_list, true);
137 /* custom config file */
138 env = getenv("UDEV_CONFIG_FILE");
140 if (set_value(&config_file, env) == NULL)
142 udev_add_property(udev, "UDEV_CONFIG_FILE", config_file);
145 /* default config file */
146 if (config_file == NULL)
147 config_file = strdup(SYSCONFDIR "/udev/udev.conf");
148 if (config_file == NULL)
151 f = fopen(config_file, "re");
153 char line[UTIL_LINE_SIZE];
156 while (fgets(line, sizeof(line), f)) {
165 while (isspace(key[0]))
168 /* comment or empty line */
169 if (key[0] == '#' || key[0] == '\0')
172 /* split key/value */
173 val = strchr(key, '=');
175 err(udev, "missing <key>=<value> in '%s'[%i], skip line\n", config_file, line_nr);
182 while (isspace(val[0]))
189 while (isspace(key[len-1]))
193 /* terminate value */
197 while (isspace(val[len-1]))
205 if (val[0] == '"' || val[0] == '\'') {
206 if (val[len-1] != val[0]) {
207 err(udev, "inconsistent quoting in '%s'[%i], skip line\n", config_file, line_nr);
214 if (strcmp(key, "udev_log") == 0) {
215 udev_set_log_priority(udev, util_log_priority(val));
218 if (strcmp(key, "udev_root") == 0) {
219 set_value(&udev->dev_path, val);
222 if (strcmp(key, "udev_run") == 0) {
223 set_value(&udev->run_path, val);
226 if (strcmp(key, "udev_rules") == 0) {
227 set_value(&udev->rules_path[0], val);
228 udev->rules_path_count = 1;
235 /* environment overwrites config */
236 env = getenv("UDEV_LOG");
238 udev_set_log_priority(udev, util_log_priority(env));
240 env = getenv("UDEV_ROOT");
242 set_value(&udev->dev_path, env);
243 udev_add_property(udev, "UDEV_ROOT", udev->dev_path);
246 env = getenv("SYSFS_PATH");
248 set_value(&udev->sys_path, env);
249 udev_add_property(udev, "SYSFS_PATH", udev->sys_path);
253 if (udev->dev_path == NULL)
254 if (set_value(&udev->dev_path, "/dev") == NULL)
257 if (udev->sys_path == NULL)
258 if (set_value(&udev->sys_path, "/sys") == NULL)
261 if (udev->run_path == NULL)
262 if (set_value(&udev->run_path, "/run/udev") == NULL)
265 if (udev->rules_path[0] == NULL) {
266 /* /usr/lib/udev -- system rules */
267 udev->rules_path[0] = strdup(LIBEXECDIR "/rules.d");
268 if (!udev->rules_path[0])
271 /* /etc/udev -- local administration rules */
272 udev->rules_path[1] = strdup(SYSCONFDIR "/udev/rules.d");
273 if (!udev->rules_path[1])
276 /* /run/udev -- runtime rules */
277 if (asprintf(&udev->rules_path[2], "%s/rules.d", udev->run_path) < 0)
280 udev->rules_path_count = 3;
283 dbg(udev, "context %p created\n", udev);
284 dbg(udev, "log_priority=%d\n", udev->log_priority);
285 dbg(udev, "config_file='%s'\n", config_file);
286 dbg(udev, "dev_path='%s'\n", udev->dev_path);
287 dbg(udev, "sys_path='%s'\n", udev->sys_path);
288 dbg(udev, "run_path='%s'\n", udev->run_path);
289 dbg(udev, "rules_path='%s':'%s':'%s'\n", udev->rules_path[0], udev->rules_path[1], udev->rules_path[2]);
294 err(udev, "context creation failed\n");
301 * @udev: udev library context
303 * Take a reference of the udev library context.
305 * Returns: the passed udev library context
307 UDEV_EXPORT struct udev *udev_ref(struct udev *udev)
317 * @udev: udev library context
319 * Drop a reference of the udev library context. If the refcount
320 * reaches zero, the resources of the context will be released.
323 UDEV_EXPORT void udev_unref(struct udev *udev)
328 if (udev->refcount > 0)
330 udev_list_cleanup(&udev->properties_list);
331 free(udev->dev_path);
332 free(udev->sys_path);
333 free(udev->rules_path[0]);
334 free(udev->rules_path[1]);
335 free(udev->rules_path[2]);
336 free(udev->run_path);
337 dbg(udev, "context %p released\n", udev);
343 * @udev: udev library context
344 * @log_fn: function to be called for logging messages
346 * The built-in logging writes to stderr. It can be
347 * overridden by a custom function, to plug log messages
348 * into the users' logging functionality.
351 UDEV_EXPORT void udev_set_log_fn(struct udev *udev,
352 void (*log_fn)(struct udev *udev,
353 int priority, const char *file, int line, const char *fn,
354 const char *format, va_list args))
356 udev->log_fn = log_fn;
357 info(udev, "custom logging function %p registered\n", log_fn);
361 * udev_get_log_priority:
362 * @udev: udev library context
364 * The initial logging priority is read from the udev config file
367 * Returns: the current logging priority
369 UDEV_EXPORT int udev_get_log_priority(struct udev *udev)
371 return udev->log_priority;
375 * udev_set_log_priority:
376 * @udev: udev library context
377 * @priority: the new logging priority
379 * Set the current logging priority. The value controls which messages
382 UDEV_EXPORT void udev_set_log_priority(struct udev *udev, int priority)
386 udev->log_priority = priority;
387 snprintf(num, sizeof(num), "%u", udev->log_priority);
388 udev_add_property(udev, "UDEV_LOG", num);
391 int udev_get_rules_path(struct udev *udev, char **path[], unsigned long long *stamp_usec[])
393 *path = udev->rules_path;
395 *stamp_usec = udev->rules_path_ts;
396 return udev->rules_path_count;
401 * @udev: udev library context
403 * Retrieve the sysfs mount point. The default is "/sys". For
404 * testing purposes, it can be overridden with the environment
405 * variable SYSFS_PATH.
407 * Returns: the sys mount point
409 UDEV_EXPORT const char *udev_get_sys_path(struct udev *udev)
413 return udev->sys_path;
418 * @udev: udev library context
420 * Retrieve the device directory path. The default value is "/dev",
421 * the actual value may be overridden in the udev configuration
424 * Returns: the device directory path
426 UDEV_EXPORT const char *udev_get_dev_path(struct udev *udev)
430 return udev->dev_path;
435 * @udev: udev library context
437 * Retrieve the udev runtime directory path. The default is "/run/udev".
439 * Returns: the runtime directory path
441 UDEV_EXPORT const char *udev_get_run_path(struct udev *udev)
445 return udev->run_path;
448 struct udev_list_entry *udev_add_property(struct udev *udev, const char *key, const char *value)
451 struct udev_list_entry *list_entry;
453 list_entry = udev_get_properties_list_entry(udev);
454 list_entry = udev_list_entry_get_by_name(list_entry, key);
455 if (list_entry != NULL)
456 udev_list_entry_delete(list_entry);
459 return udev_list_entry_add(&udev->properties_list, key, value);
462 struct udev_list_entry *udev_get_properties_list_entry(struct udev *udev)
464 return udev_list_get_entry(&udev->properties_list);