libudev: add library to access udev information
authorKay Sievers <kay.sievers@vrfy.org>
Wed, 27 Aug 2008 15:11:58 +0000 (17:11 +0200)
committerKay Sievers <kay.sievers@vrfy.org>
Wed, 27 Aug 2008 15:11:58 +0000 (17:11 +0200)
12 files changed:
NEWS
TODO
configure.ac
udev/Makefile.am
udev/lib/.gitignore [new file with mode: 0644]
udev/lib/Makefile.am [new file with mode: 0644]
udev/lib/exported_symbols [new file with mode: 0644]
udev/lib/libudev-private.h [new file with mode: 0644]
udev/lib/libudev.c [new file with mode: 0644]
udev/lib/libudev.h [new file with mode: 0644]
udev/lib/libudev.pc.in [new file with mode: 0644]
udev/lib/test-libudev.c [new file with mode: 0644]

diff --git a/NEWS b/NEWS
index f0615d5..016ec19 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,3 +1,7 @@
+udev 127
+========
+Bugfixes.
+
 udev 126
 ========
 We use ./configure now. See INSTALL for details. Current
diff --git a/TODO b/TODO
index 88d3e59..5afde0c 100644 (file)
--- a/TODO
+++ b/TODO
@@ -1,7 +1,10 @@
 These things would be nice to have:
   o get all distros to agree on a default set of rules
+  o fix (non important) memleak in udevinfo at udev_device_init() loop
+  o rework rules to a match-action list, instead of a rules array
 
 These things will change in future udev versions:
   o --device-id-of-file will print '5:8' instead of '5 8'
 
 These things are deprecated and scheduled for removal in a future udev version:
+  o DEVTYPE for disks is set by the kernel, remove it from the rules
index eb22a5c..4be3ed5 100644 (file)
@@ -9,6 +9,14 @@ AC_DISABLE_STATIC
 AC_SYS_LARGEFILE
 AC_PROG_LIBTOOL
 
+dnl /* libudev version */
+LIBUDEV_LT_CURRENT=0
+LIBUDEV_LT_REVISION=0
+LIBUDEV_LT_AGE=0
+AC_SUBST(LIBUDEV_LT_CURRENT)
+AC_SUBST(LIBUDEV_LT_REVISION)
+AC_SUBST(LIBUDEV_LT_AGE)
+
 dnl /* libvolume_id version */
 VOLID_LT_CURRENT=0
 VOLID_LT_REVISION=86
@@ -74,6 +82,8 @@ AC_CONFIG_HEADERS(config.h)
 AC_CONFIG_FILES([
        Makefile
        udev/Makefile
+       udev/lib/Makefile
+       udev/lib/libudev.pc
        rules/Makefile
        extras/Makefile
        extras/ata_id/Makefile
index 3d28546..d9f1405 100644 (file)
@@ -1,3 +1,6 @@
+SUBDIRS = \
+       lib
+
 sbin_PROGRAMS = \
        udevd \
        udevadm
diff --git a/udev/lib/.gitignore b/udev/lib/.gitignore
new file mode 100644 (file)
index 0000000..74a5f1d
--- /dev/null
@@ -0,0 +1,4 @@
+test-libudev
+libudev.pc
+libudev.so*
+
diff --git a/udev/lib/Makefile.am b/udev/lib/Makefile.am
new file mode 100644 (file)
index 0000000..791191c
--- /dev/null
@@ -0,0 +1,63 @@
+AM_CPPFLAGS = \
+       -DSYSCONFDIR=\""$(sysconfdir)"\" \
+       -DUDEV_PREFIX=\""$(udev_prefix)"\"
+
+noinst_PROGRAMS = \
+       test-libudev
+
+test_libudev_SOURCES = \
+       test-libudev.c
+
+test_libudev_LDADD = \
+       libudev.la
+
+rootlibdir = $(exec_prefix)/$(libdir_name)
+rootlib_LTLIBRARIES = \
+       libudev.la
+
+include_HEADERS =\
+       libudev.h
+
+libudev_la_SOURCES =\
+       libudev-private.h \
+       libudev.c \
+       ../list.h \
+       ../udev.h \
+       ../udev_utils.c \
+       ../udev_utils_string.c \
+       ../udev_utils_file.c \
+       ../udev_sysfs.c \
+       ../udev_node.c \
+       ../udev_device.c \
+       ../udev_config.c \
+       ../udev_rules.c \
+       ../udev_rules_parse.c \
+       ../udev_db.c \
+       ../udev_sysdeps.c
+
+libudev_la_LDFLAGS = \
+       -version-info $(LIBUDEV_LT_CURRENT):$(LIBUDEV_LT_REVISION):$(LIBUDEV_LT_AGE) \
+       -export-symbols $(top_srcdir)/udev/lib/exported_symbols
+
+pkgconfigdir = $(prefix)/$(libdir_name)/pkgconfig
+pkgconfig_DATA = libudev.pc
+
+EXTRA_DIST = \
+       exported_symbols
+
+# move devel files to $(prefix)$(libdir_name) if needed
+install-data-hook:
+       rm  $(DESTDIR)$(rootlibdir)/libudev.la
+       if test "$(prefix)" != "$(exec_prefix)"; then \
+               mkdir -p $(DESTDIR)$(prefix)/$(libdir_name); \
+               mv $(DESTDIR)$(rootlibdir)/libudev.a $(DESTDIR)$(prefix)/$(libdir_name)/; \
+               so_img_name=$$(readlink $(DESTDIR)$(rootlibdir)/libudev.so); \
+               rm $(DESTDIR)$(rootlibdir)/libudev.so; \
+               so_img_rel_target_prefix=$$(echo $(prefix)/$(libdir_name) | sed 's,\(^/\|\)[^/][^/]*,..,g'); \
+               ln -sf  $$so_img_rel_target_prefix$(exec_prefix)/$(libdir_name)/$$so_img_name \
+                       $(DESTDIR)$(prefix)/$(libdir_name)/libudev.so; \
+       fi
+
+uninstall-hook:
+       rm -f $(DESTDIR)$(prefix)/$(libdir_name)/libudev.a
+       rm -f $(DESTDIR)$(prefix)/$(libdir_name)/libudev.so*
diff --git a/udev/lib/exported_symbols b/udev/lib/exported_symbols
new file mode 100644 (file)
index 0000000..c3a7caf
--- /dev/null
@@ -0,0 +1,17 @@
+udev_log_fn
+udev_new
+udev_ref
+udev_unref
+udev_set_log_fn
+udev_get_sys_path
+udev_get_dev_path
+udev_device_new_from_devpath
+udev_device_ref
+udev_device_unref
+udev_device_get_udev
+udev_device_get_devpath
+udev_device_get_devname
+udev_device_get_subsystem
+udev_device_get_devlinks
+udev_device_get_properties
+udev_devices_enumerate
diff --git a/udev/lib/libudev-private.h b/udev/lib/libudev-private.h
new file mode 100644 (file)
index 0000000..8f7e247
--- /dev/null
@@ -0,0 +1,60 @@
+/*
+ * libudev - interface to udev device information
+ *
+ * Copyright (C) 2008 Kay Sievers <kay.sievers@vrfy.org>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef _LIBUDEV_PRIVATE_H_
+#define _LIBUDEV_PRIVATE_H_
+
+#include "libudev.h"
+#include "../udev.h"
+
+struct udev {
+       int refcount;
+       void (*log_fn)(struct udev *udev,
+                      int priority, const char *file, int line, const char *fn,
+                      const char *format, va_list args);
+};
+
+struct udev_device {
+       int refcount;
+       struct udev *udev;
+       struct udevice *udevice;
+};
+
+#ifdef USE_LOG
+#define log_dbg(udev, arg...) \
+       udev_log(udev, LOG_DEBUG, __FILE__, __LINE__, __FUNCTION__, ## arg)
+
+#define log_info(udev, arg...) \
+       udev_log(udev, LOG_INFO, __FILE__, __LINE__, __FUNCTION__, ## arg)
+
+#define log_err(udev, arg...) \
+       udev_log(udev, LOG_ERR, __FILE__, __LINE__, __FUNCTION__, ## arg)
+
+void udev_log(struct udev *udev,
+             int priority, const char *file, int line, const char *fn,
+             const char *format, ...)
+             __attribute__ ((format(printf, 6, 7)));
+#else
+static inline void udev_log(struct udev *udev,
+             int priority, const char *file, int line, const char *fn,
+             const char *format, ...)
+             __attribute__ ((format(printf, 6, 7))) {}
+#endif
+
+#endif
diff --git a/udev/lib/libudev.c b/udev/lib/libudev.c
new file mode 100644 (file)
index 0000000..098ca8f
--- /dev/null
@@ -0,0 +1,583 @@
+/*
+ * libudev - interface to udev device information
+ *
+ * Copyright (C) 2008 Kay Sievers <kay.sievers@vrfy.org>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "config.h"
+
+#include <stdio.h>
+#include <stdlib.h>
+#include <stddef.h>
+#include <unistd.h>
+#include <errno.h>
+#include <string.h>
+#include <dirent.h>
+#include <sys/stat.h>
+
+#include "libudev.h"
+#include "libudev-private.h"
+#include "../udev.h"
+
+void udev_log(struct udev *udev,
+             int priority, const char *file, int line, const char *fn,
+             const char *format, ...)
+{
+       va_list args;
+
+       va_start(args, format);
+       udev->log_fn(udev, priority, file, line, fn, format, args);
+       va_end(args);
+}
+
+static void log_stderr(struct udev *udev,
+                      int priority, const char *file, int line, const char *fn,
+                      const char *format, va_list args)
+{
+       static int log = -1;
+
+       if (log == -1) {
+               if (getenv("LIBUDEV_DEBUG") != NULL)
+                       log = 1;
+               else
+                       log = 0;
+       }
+
+       if (log == 1) {
+               fprintf(stderr, "libudev: %s: ", fn);
+               vfprintf(stderr, format, args);
+       }
+}
+
+/* glue to udev logging, needed until udev logging code is "fixed" */
+#ifdef USE_LOG
+void log_message(int priority, const char *format, ...)
+{
+       va_list args;
+
+       va_start(args, format);
+       log_stderr(NULL, priority, NULL, 0, "", format, args);
+       va_end(args);
+}
+#endif
+
+static ssize_t get_subsystem(struct udev *udev, const char *devpath, char *subsystem, size_t size)
+{
+       char path[PATH_SIZE];
+       ssize_t len;
+       const char *pos;
+
+       strlcpy(path, udev_get_sys_path(udev), sizeof(path));
+       strlcat(path, devpath, sizeof(path));
+       strlcat(path, "/subsystem", sizeof(path));
+       len = readlink(path, path, sizeof(path));
+       if (len < 0 || len >= (ssize_t) sizeof(path))
+               return -1;
+       path[len] = '\0';
+       pos = strrchr(path, '/');
+       if (pos == NULL)
+               return -1;
+       pos = &pos[1];
+       return strlcpy(subsystem, pos, size);
+}
+
+/**
+ * udev_new:
+ *
+ * Create udev library context.
+ *
+ * The initial refcount is 1, and needs to be decremented to
+ * release the ressources of the udev library context.
+ *
+ * Returns: a new udev library context
+ **/
+struct udev *udev_new(void)
+{
+       struct udev *udev;
+
+       udev = malloc(sizeof(struct udev));
+       if (udev == NULL)
+               return NULL;
+       memset(udev, 0x00, (sizeof(struct udev)));
+       udev->refcount = 1;
+       udev->log_fn = log_stderr;
+       udev_config_init();
+       sysfs_init();
+       log_info(udev, "context %p created\n", udev);
+       return udev;
+}
+
+/**
+ * udev_ref:
+ * @udev: udev library context
+ *
+ * Take a reference of the udev library context.
+ *
+ * Returns: the passed udev library context
+ **/
+struct udev *udev_ref(struct udev *udev)
+{
+       udev->refcount++;
+       return udev;
+}
+
+/**
+ * udev_unref:
+ * @udev: udev library context
+ *
+ * Drop a reference of the udev library context. If the refcount
+ * reaches zero, the ressources of the context will be released.
+ *
+ **/
+void udev_unref(struct udev *udev)
+{
+       udev->refcount--;
+       if (udev->refcount > 0)
+               return;
+       sysfs_cleanup();
+       log_info(udev, "context %p released\n", udev);
+       free(udev);
+}
+
+/**
+ * udev_set_log_fn:
+ * @udev: udev library context
+ * @log_fn: function to be called for logging messages
+ *
+ * The built-in logging, which writes to stderr if the
+ * LIBUDEV_DEBUG environment variable is set, can be
+ * overridden by a custom function, to plug log messages
+ * into the users logging functionality.
+ *
+ **/
+void udev_set_log_fn(struct udev *udev,
+                    void (*log_fn)(struct udev *udev,
+                                   int priority, const char *file, int line, const char *fn,
+                                   const char *format, va_list args))
+{
+       udev->log_fn = log_fn;
+       log_info(udev, "custom logging function %p registered\n", udev);
+}
+
+/**
+ * udev_get_sys_path:
+ * @udev: udev library context
+ *
+ * Retrieve the sysfs mount point. The default is "/sys". For
+ * testing purposes, it can be overridden with the environment
+ * variable SYSFS_PATH.
+ *
+ * Returns: the sys mount point
+ **/
+const char *udev_get_sys_path(struct udev *udev)
+{
+       return sysfs_path;
+}
+
+/**
+ * udev_get_dev_path:
+ * @udev: udev library context
+ *
+ * Retrieve the device directory path. The default value is "/dev",
+ * the actual value may be overridden in the udev configuration
+ * file.
+ *
+ * Returns: the device directory path
+ **/
+const char *udev_get_dev_path(struct udev *udev)
+{
+       return udev_root;
+}
+
+static struct udev_device *device_init(struct udev *udev)
+{
+       struct udev_device *udev_device;
+
+       udev_device = malloc(sizeof(struct udev_device));
+       if (udev_device == NULL)
+               return NULL;
+       memset(udev_device, 0x00, sizeof(struct udev_device));
+       udev_device->refcount = 1;
+       udev_device->udev = udev;
+       return udev_device;
+}
+
+/**
+ * udev_device_new_from_devpath:
+ * @udev: udev library context
+ * @devpath: sys device path
+ *
+ * Create new udev device, and fill in information from the sysfs
+ * device and the udev database entry. The devpath must not contain
+ * the sysfs mount path, and must contain a leading '/'.
+ *
+ * The initial refcount is 1, and needs to be decremented to
+ * release the ressources of the udev device.
+ *
+ * Returns: a new udev device, or #NULL, if it does not exist
+ **/
+struct udev_device *udev_device_new_from_devpath(struct udev *udev, const char *devpath)
+{
+       char path[PATH_SIZE];
+       struct stat statbuf;
+       struct udev_device *udev_device;
+       int err;
+
+       strlcpy(path, udev_get_sys_path(udev), sizeof(path));
+       strlcat(path, devpath, sizeof(path));
+       if (stat(path, &statbuf) != 0)
+               return NULL;
+       if (!S_ISDIR(statbuf.st_mode))
+               return NULL;
+
+       udev_device = device_init(udev);
+       if (udev_device == NULL)
+               return NULL;
+
+       udev_device->udevice = udev_device_init(NULL);
+       if (udev_device->udevice == NULL) {
+               free(udev_device);
+               return NULL;
+       }
+       log_info(udev, "device %p created\n", udev_device);
+
+       strlcpy(path, devpath, sizeof(path));
+       sysfs_resolve_link(path, sizeof(path));
+
+       err = udev_db_get_device(udev_device->udevice, path);
+       if (err >= 0)
+               log_info(udev, "device %p filled with udev database data\n", udev_device);
+       log_info(udev, "device %p filled with %s data\n", udev_device, udev_device_get_devpath(udev_device));
+       return udev_device;
+}
+
+/**
+ * udev_device_get_udev:
+ *
+ * Retrieve the udev library context the device was created with.
+ *
+ * Returns: the udev library context
+ **/
+struct udev *udev_device_get_udev(struct udev_device *udev_device)
+{
+       return udev_device->udev;
+}
+
+/**
+ * udev_device_ref:
+ * @udev_device: udev device
+ *
+ * Take a reference of a udev device.
+ *
+ * Returns: the passed udev device
+ **/
+struct udev_device *udev_device_ref(struct udev_device *udev_device)
+{
+       udev_device->refcount++;
+       return udev_device;
+}
+
+/**
+ * udev_device_unref:
+ * @udev_device: udev device
+ *
+ * Drop a reference of a udev device. If the refcount reaches zero,
+ * the ressources of the device will be released.
+ *
+ **/
+void udev_device_unref(struct udev_device *udev_device)
+{
+       udev_device->refcount--;
+       if (udev_device->refcount > 0)
+               return;
+       udev_device_cleanup(udev_device->udevice);
+       free(udev_device);
+}
+
+/**
+ * udev_device_get_devpath:
+ * @udev_device: udev device
+ *
+ * Retrieve the sys path of the udev device. The path does not contain
+ * the sys mount point.
+ *
+ * Returns: the sys path of the udev device
+ **/
+const char *udev_device_get_devpath(struct udev_device *udev_device)
+{
+       return udev_device->udevice->dev->devpath;
+}
+
+/**
+ * udev_device_get_devname:
+ * @udev_device: udev device
+ *
+ * Retrieve the device node file name belonging to the udev device.
+ * The path does not contain the device directory, and does not contain
+ * a leading '/'.
+ *
+ * Returns: the device node file name of the udev device, or #NULL if no device node exists
+ **/
+const char *udev_device_get_devname(struct udev_device *udev_device)
+{
+       if (udev_device->udevice->name[0] == '\0')
+               return NULL;
+       return udev_device->udevice->name;
+}
+
+/**
+ * udev_device_get_subsystem:
+ * @udev_device: udev device
+ *
+ * Retrieve the subsystem string of the udev device. The string does not
+ * contain any "/".
+ *
+ * Returns: the subsystem name of the udev device, or #NULL if it can not be determined
+ **/
+const char *udev_device_get_subsystem(struct udev_device *udev_device)
+{
+       struct sysfs_device *dev = udev_device->udevice->dev;
+       if (dev->subsystem[0] != '\0')
+               return dev->subsystem;
+       if (get_subsystem(udev_device->udev, dev->devpath,
+                         dev->subsystem, sizeof(dev->subsystem)) < 2)
+               return NULL;
+       return dev->subsystem;
+}
+
+/**
+ * udev_device_get_devlinks:
+ * @udev_device: udev device
+ * @cb: function to be called for every device link found
+ * @data: data to be passed to the function
+ *
+ * Retrieve the device links pointing to the device file of the
+ * udev device. For every device link, the passed function will be
+ * called with the device link string. If the function returns 1,
+ * remaning device links will be ignored. The device link path
+ * does not contain the device directory, and does not contain
+ * a leading '/'.
+ *
+ * Returns: the number of device links passed to the caller, or a negative value on error
+ **/
+int udev_device_get_devlinks(struct udev_device *udev_device,
+                             int (*cb)(struct udev_device *udev_device, const char *value, void *data),
+                             void *data)
+{
+       struct name_entry *name_loop;
+       int count = 0;
+
+       list_for_each_entry(name_loop, &udev_device->udevice->symlink_list, node) {
+               count++;
+               if (cb(udev_device, name_loop->name, data) != 0)
+                       break;
+       }
+       return count;
+}
+
+/**
+ * udev_device_get_properties:
+ * @udev_device: udev device
+ * @cb: function to be called for every property found
+ * @data: data to be passed to the function
+ *
+ * Retrieve the property key/value pairs belonging to the
+ * udev device. For every key/value pair, the passed function will be
+ * called. If the function returns 1, remaning properties will be
+ * ignored.
+ *
+ * Returns: the number of properties passed to the caller, or a negative value on error
+ **/
+int udev_device_get_properties(struct udev_device *udev_device,
+                               int (*cb)(struct udev_device *udev_device, const char *key, const char *value, void *data),
+                               void *data)
+{
+       struct name_entry *name_loop;
+       int count = 0;
+
+       list_for_each_entry(name_loop, &udev_device->udevice->env_list, node) {
+               char name[PATH_SIZE];
+               char *val;
+
+               strncpy(name, name_loop->name, PATH_SIZE);
+               name[PATH_SIZE-1] = '\0';
+               val = strchr(name, '=');
+               if (val == NULL)
+                       continue;
+               val[0] = '\0';
+               val = &val[1];
+               if (cb(udev_device, name, val, data) != 0)
+                       break;
+       }
+       return count;
+}
+
+static int devices_scan_subsystem(struct udev *udev,
+                                 const char *basedir, const char *subsystem, const char *subdir,
+                                 struct list_head *device_list)
+{
+       char path[PATH_SIZE];
+       DIR *dir;
+       struct dirent *dent;
+       size_t len;
+
+       len = strlcpy(path, udev_get_sys_path(udev), sizeof(path));
+       strlcat(path, basedir, sizeof(path));
+       strlcat(path, "/", sizeof(path));
+       strlcat(path, subsystem, sizeof(path));
+       if (subdir != NULL)
+               strlcat(path, subdir, sizeof(path));
+       dir = opendir(path);
+       if (dir == NULL)
+               return -1;
+       for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
+               char devpath[PATH_SIZE];
+
+               if (dent->d_name[0] == '.')
+                       continue;
+               strlcpy(devpath, &path[len], sizeof(devpath));
+               strlcat(devpath, "/", sizeof(devpath));
+               strlcat(devpath, dent->d_name, sizeof(devpath));
+               sysfs_resolve_link(devpath, sizeof(devpath));
+               name_list_add(device_list, devpath, 1);
+       }
+       closedir(dir);
+       return 0;
+}
+
+static int devices_scan_subsystems(struct udev *udev,
+                                  const char *basedir, const char *subsystem, const char *subdir,
+                                  struct list_head *device_list)
+{
+       char path[PATH_SIZE];
+       DIR *dir;
+       struct dirent *dent;
+
+       if (subsystem != NULL)
+               return devices_scan_subsystem(udev, basedir, subsystem, subdir, device_list);
+
+       strlcpy(path, udev_get_sys_path(udev), sizeof(path));
+       strlcat(path, basedir, sizeof(path));
+       dir = opendir(path);
+       if (dir == NULL)
+               return -1;
+       for (dent = readdir(dir); dent != NULL; dent = readdir(dir)) {
+               if (dent->d_name[0] == '.')
+                       continue;
+               devices_scan_subsystem(udev, basedir, dent->d_name, subdir, device_list);
+       }
+       closedir(dir);
+       return 0;
+}
+
+static int devices_delay(struct udev *udev, const char *devpath)
+{
+       static const char *delay_device_list[] = {
+               "/block/md",
+               "/block/dm-",
+               NULL
+       };
+       int i;
+
+       for (i = 0; delay_device_list[i] != NULL; i++) {
+               if (strstr(devpath, delay_device_list[i]) != NULL) {
+                       log_info(udev, "delaying: %s\n", devpath);
+                       return 1;
+               }
+       }
+       return 0;
+}
+
+static int devices_call(struct udev *udev, const char *devpath,
+                       int (*cb)(struct udev *udev,
+                                 const char *devpath, const char *subsystem, const char *name,
+                                 void *data),
+                       void *data,
+                       int *cb_rc)
+{
+       char subsystem[NAME_SIZE];
+       const char *name;
+
+       name = strrchr(devpath, '/');
+       if (name == NULL)
+               return -1;
+       name++;
+
+       if (get_subsystem(udev, devpath, subsystem, sizeof(subsystem)) < 2)
+               return -1;
+       *cb_rc = cb(udev, devpath, subsystem, name, data);
+       return 0;
+}
+
+/**
+ * udev_devices_enumerate:
+ * @udev_device: udev device
+ * @cb: function to be called for every property found
+ * @data: data to be passed to the function
+ *
+ * Retrieve the property key/value pairs belonging to the
+ * udev device. For every key/value pair, the passed function will be
+ * called. If the function returns 1, remaning properties will be
+ * ignored.
+ *
+ * Returns: the number of properties passed to the caller, or a negative value on error
+ **/
+int udev_devices_enumerate(struct udev *udev, const char *subsystem,
+                          int (*cb)(struct udev *udev,
+                                    const char *devpath, const char *subsystem, const char *name, void *data),
+                          void *data)
+{
+       char base[PATH_SIZE];
+       struct stat statbuf;
+       struct list_head device_list;
+       struct name_entry *loop_device;
+       struct name_entry *tmp_device;
+       int cb_rc = 0;
+       int count = 0;
+
+       INIT_LIST_HEAD(&device_list);
+
+       /* if we have /sys/subsystem/, forget all the old stuff */
+       strlcpy(base, sysfs_path, sizeof(base));
+       strlcat(base, "/subsystem", sizeof(base));
+       if (stat(base, &statbuf) == 0) {
+               devices_scan_subsystems(udev, "/subsystem", subsystem, "/devices", &device_list);
+       } else {
+               devices_scan_subsystems(udev, "/bus", subsystem, "/devices", &device_list);
+               devices_scan_subsystems(udev, "/class", subsystem, NULL, &device_list);
+       }
+
+       list_for_each_entry_safe(loop_device, tmp_device, &device_list, node) {
+               if (devices_delay(udev, loop_device->name))
+                       continue;
+               if (cb_rc == 0)
+                       if (devices_call(udev, loop_device->name, cb, data, &cb_rc) == 0)
+                               count++;
+               list_del(&loop_device->node);
+               free(loop_device);
+       }
+
+       /* handle remaining delayed devices */
+       list_for_each_entry_safe(loop_device, tmp_device, &device_list, node) {
+               if (cb_rc == 0)
+                       if (devices_call(udev, loop_device->name, cb, data, &cb_rc) == 0)
+                               count++;
+               list_del(&loop_device->node);
+               free(loop_device);
+       }
+
+       return count;
+}
diff --git a/udev/lib/libudev.h b/udev/lib/libudev.h
new file mode 100644 (file)
index 0000000..e740f36
--- /dev/null
@@ -0,0 +1,57 @@
+/*
+ * libudev - interface to udev device information
+ *
+ * Copyright (C) 2008 Kay Sievers <kay.sievers@vrfy.org>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#ifndef _LIBUDEV_H_
+#define _LIBUDEV_H_
+
+struct udev;
+struct udev_device;
+
+extern struct udev *udev_new(void);
+extern struct udev *udev_ref(struct udev *udev);
+extern void udev_unref(struct udev *udev);
+extern void udev_set_log_fn(struct udev *udev,
+                           void (*log_fn)(struct udev *udev,
+                                          int priority, const char *file, int line, const char *fn,
+                                          const char *format, va_list args));
+extern const char *udev_get_sys_path(struct udev *udev);
+extern const char *udev_get_dev_path(struct udev *udev);
+
+extern struct udev_device *udev_device_new_from_devpath(struct udev *udev, const char *devpath);
+extern struct udev_device *udev_device_ref(struct udev_device *udev_device);
+extern void udev_device_unref(struct udev_device *udev_device);
+extern struct udev *udev_device_get_udev(struct udev_device *udev_device);
+extern const char *udev_device_get_devpath(struct udev_device *udev_device);
+extern const char *udev_device_get_devname(struct udev_device *udev_device);
+extern const char *udev_device_get_subsystem(struct udev_device *udev_device);
+extern int udev_device_get_devlinks(struct udev_device *udev_device,
+                                   int (*cb)(struct udev_device *udev_device,
+                                             const char *value, void *data),
+                                   void *data);
+extern int udev_device_get_properties(struct udev_device *udev_device,
+                                     int (*cb)(struct udev_device *udev_device,
+                                               const char *key, const char *value, void *data),
+                                     void *data);
+
+extern int udev_devices_enumerate(struct udev *udev, const char *subsystem,
+                                 int (*cb)(struct udev *udev,
+                                           const char *devpath, const char *subsystem, const char *name, void *data),
+                                 void *data);
+
+#endif
diff --git a/udev/lib/libudev.pc.in b/udev/lib/libudev.pc.in
new file mode 100644 (file)
index 0000000..4d5a1d2
--- /dev/null
@@ -0,0 +1,10 @@
+prefix=@prefix@
+exec_prefix=@prefix@
+libdir=@prefix@/@libdir_name@
+includedir=@prefix@/include
+
+Name: libudev
+Description: Library to access udev device information
+Version: @VERSION@
+Libs: -L${libdir} -ludev
+Cflags: -I${includedir}
diff --git a/udev/lib/test-libudev.c b/udev/lib/test-libudev.c
new file mode 100644 (file)
index 0000000..e86c660
--- /dev/null
@@ -0,0 +1,107 @@
+/*
+ * test-libudev
+ *
+ * Copyright (C) 2008 Kay Sievers <kay.sievers@vrfy.org>
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+#include "config.h"
+
+#include <stdio.h>
+#include <stdarg.h>
+#include "libudev.h"
+
+static void log_fn(struct udev *udev,
+                  int priority, const char *file, int line, const char *fn,
+                  const char *format, va_list args)
+{
+       printf("test-libudev: %s %s:%d ", fn, file, line);
+       vprintf(format, args);
+}
+
+static int devlinks_cb(struct udev_device *udev_device, const char *value, void *data)
+{
+       printf("link: %s\n", value);
+       return 0;
+}
+
+static int devices_enum_cb(struct udev *udev,
+                          const char *devpath, const char *subsystem, const char *name,
+                          void *data)
+{
+       printf("device: %s (%s) %s\n", devpath, subsystem, name);
+       return 0;
+}
+
+static int properties_cb(struct udev_device *udev_device, const char *key, const char *value, void *data)
+{
+       printf("property: %s=%s\n", key, value);
+       return 0;
+}
+
+int main(int argc, char *argv[], char *envp[])
+{
+       struct udev *udev;
+       struct udev_device *device;
+       const char *str;
+       const char *devpath = "/devices/virtual/mem/null";
+       const char *subsystem = NULL;
+
+       if (argv[1] != NULL) {
+               devpath = argv[1];
+               if (argv[2] != NULL)
+                       subsystem = argv[2];
+       }
+
+       udev = udev_new();
+       printf("context: %p\n", udev);
+       if (udev == NULL) {
+               printf("no context\n");
+               return 1;
+       }
+       udev_set_log_fn(udev, log_fn);
+       printf("set log: %p\n", log_fn);
+
+       str = udev_get_sys_path(udev);
+       printf("sys_path: %s\n", str);
+       str = udev_get_dev_path(udev);
+       printf("dev_path: %s\n", str);
+
+       printf("looking at device: %s\n", devpath);
+       device = udev_device_new_from_devpath(udev, devpath);
+       printf("device: %p\n", device);
+       if (device == NULL) {
+               printf("no device\n");
+               return 1;
+       }
+       str = udev_device_get_devpath(device);
+       printf("devpath: %s\n", str);
+       str = udev_device_get_subsystem(device);
+       printf("subsystem: %s\n", str);
+       str = udev_device_get_devname(device);
+       printf("devname: %s\n", str);
+       udev_device_get_devlinks(device, devlinks_cb, NULL);
+       udev_device_get_properties(device, properties_cb, NULL);
+       udev_device_unref(device);
+
+       if (subsystem == NULL)
+               printf("enumerating devices from all subsystems\n");
+       else
+               printf("enumerating devices from subsystem: %s\n", subsystem);
+       udev_devices_enumerate(udev, subsystem, devices_enum_cb, NULL);
+
+       udev_unref(udev);
+       return 0;
+}