2 This file is part of systemd.
4 Copyright 2008-2012 Kay Sievers <kay@vrfy.org>
6 systemd is free software; you can redistribute it and/or modify it
7 under the terms of the GNU Lesser General Public License as published by
8 the Free Software Foundation; either version 2.1 of the License, or
9 (at your option) any later version.
11 systemd is distributed in the hope that it will be useful, but
12 WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 Lesser General Public License for more details.
16 You should have received a copy of the GNU Lesser General Public License
17 along with systemd; If not, see <http://www.gnu.org/licenses/>.
31 #include "libudev-private.h"
36 * @short_description: libudev context
38 * The context contains the default values read from the udev config file,
39 * and is passed to all library operations.
45 * Opaque object representing the library context.
49 void (*log_fn)(struct udev *udev,
50 int priority, const char *file, int line, const char *fn,
51 const char *format, va_list args);
53 struct udev_list properties_list;
57 void udev_log(struct udev *udev,
58 int priority, const char *file, int line, const char *fn,
59 const char *format, ...)
63 va_start(args, format);
64 udev->log_fn(udev, priority, file, line, fn, format, args);
68 static void log_stderr(struct udev *udev,
69 int priority, const char *file, int line, const char *fn,
70 const char *format, va_list args)
72 fprintf(stderr, "libudev: %s: ", fn);
73 vfprintf(stderr, format, args);
78 * @udev: udev library context
80 * Retrieve stored data pointer from library context. This might be useful
81 * to access from callbacks like a custom logging function.
83 * Returns: stored userdata
85 _public_ void *udev_get_userdata(struct udev *udev)
89 return udev->userdata;
94 * @udev: udev library context
95 * @userdata: data pointer
97 * Store custom @userdata in the library context.
99 _public_ void udev_set_userdata(struct udev *udev, void *userdata)
103 udev->userdata = userdata;
109 * Create udev library context. This reads the udev configuration
110 * file, and fills in the default values.
112 * The initial refcount is 1, and needs to be decremented to
113 * release the resources of the udev library context.
115 * Returns: a new udev library context
117 _public_ struct udev *udev_new(void)
123 udev = calloc(1, sizeof(struct udev));
127 udev->log_fn = log_stderr;
128 udev->log_priority = LOG_ERR;
129 udev_list_init(udev, &udev->properties_list, true);
131 f = fopen("/etc/udev/udev.conf", "re");
133 char line[UTIL_LINE_SIZE];
136 while (fgets(line, sizeof(line), f)) {
145 while (isspace(key[0]))
148 /* comment or empty line */
149 if (key[0] == '#' || key[0] == '\0')
152 /* split key/value */
153 val = strchr(key, '=');
155 udev_err(udev, "missing <key>=<value> in /etc/udev/udev.conf[%i]; skip line\n", line_nr);
162 while (isspace(val[0]))
169 while (isspace(key[len-1]))
173 /* terminate value */
177 while (isspace(val[len-1]))
185 if (val[0] == '"' || val[0] == '\'') {
186 if (val[len-1] != val[0]) {
187 udev_err(udev, "inconsistent quoting in /etc/udev/udev.conf[%i]; skip line\n", line_nr);
194 if (streq(key, "udev_log")) {
195 udev_set_log_priority(udev, util_log_priority(val));
202 /* environment overrides config */
203 env = secure_getenv("UDEV_LOG");
205 udev_set_log_priority(udev, util_log_priority(env));
212 * @udev: udev library context
214 * Take a reference of the udev library context.
216 * Returns: the passed udev library context
218 _public_ struct udev *udev_ref(struct udev *udev)
228 * @udev: udev library context
230 * Drop a reference of the udev library context. If the refcount
231 * reaches zero, the resources of the context will be released.
233 * Returns: the passed udev library context if it has still an active reference, or #NULL otherwise.
235 _public_ struct udev *udev_unref(struct udev *udev)
240 if (udev->refcount > 0)
242 udev_list_cleanup(&udev->properties_list);
249 * @udev: udev library context
250 * @log_fn: function to be called for logging messages
252 * The built-in logging writes to stderr. It can be
253 * overridden by a custom function, to plug log messages
254 * into the users' logging functionality.
257 _public_ void udev_set_log_fn(struct udev *udev,
258 void (*log_fn)(struct udev *udev,
259 int priority, const char *file, int line, const char *fn,
260 const char *format, va_list args))
262 udev->log_fn = log_fn;
263 udev_dbg(udev, "custom logging function %p registered\n", log_fn);
267 * udev_get_log_priority:
268 * @udev: udev library context
270 * The initial logging priority is read from the udev config file
273 * Returns: the current logging priority
275 _public_ int udev_get_log_priority(struct udev *udev)
277 return udev->log_priority;
281 * udev_set_log_priority:
282 * @udev: udev library context
283 * @priority: the new logging priority
285 * Set the current logging priority. The value controls which messages
288 _public_ void udev_set_log_priority(struct udev *udev, int priority)
292 udev->log_priority = priority;
293 snprintf(num, sizeof(num), "%u", udev->log_priority);
294 udev_add_property(udev, "UDEV_LOG", num);
297 struct udev_list_entry *udev_add_property(struct udev *udev, const char *key, const char *value)
300 struct udev_list_entry *list_entry;
302 list_entry = udev_get_properties_list_entry(udev);
303 list_entry = udev_list_entry_get_by_name(list_entry, key);
304 if (list_entry != NULL)
305 udev_list_entry_delete(list_entry);
308 return udev_list_entry_add(&udev->properties_list, key, value);
311 struct udev_list_entry *udev_get_properties_list_entry(struct udev *udev)
313 return udev_list_get_entry(&udev->properties_list);