udev_new - Man Page

Create, acquire and release a udev context object

Synopsis

#include <libudev​.h>

struct udev *udev_new(void);

struct udev *udev_ref(struct udev *udev);

struct udev *udev_unref(struct udev *udev);

Description

udev_new() allocates a new udev context object and returns a pointer to it​. This object is opaque and must not be accessed by the caller via different means than functions provided by libudev​. Initially, the reference count of the context is 1​. You can acquire further references, and drop gained references via udev_ref() and udev_unref()​. Once the reference count hits 0, the context object is destroyed and freed​.

Return Value

On success, udev_new() returns a pointer to the allocated udev context​. On failure, NULL is returned​. udev_ref() returns the argument that it was passed, unmodified​. udev_unref() always returns NULL​.

History

udev_new(), udev_ref(), and udev_unref() were added in version 221​.

See Also

systemd(1), systemd-udevd.service(8)

Referenced By

libudev(3), systemd.directives(7), systemd.index(7), udev_device_get_syspath(3), udev_device_has_tag(3), udev_device_new_from_syspath(3), udev_enumerate_add_match_subsystem(3), udev_enumerate_new(3), udev_enumerate_scan_devices(3), udev_list_entry(3), udev_monitor_filter_update(3), udev_monitor_new_from_netlink(3), udev_monitor_receive_device(3).

The man pages udev_ref(3) and udev_unref(3) are aliases of udev_new(3).

systemd 262~rc2