Debian Codegraph @

upstream/fedora-44/man3/udev_enumerate_new.3

raw
1 '\" t
2 .TH "UDEV_ENUMERATE_NEW" "3" "" "systemd 259.5" "udev_enumerate_new"
3 .\" -----------------------------------------------------------------
4 .\" * Define some portability stuff
5 .\" -----------------------------------------------------------------
6 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
7 .\" http://bugs.debian.org/507673
8 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
9 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
10 .ie \n(.g .ds Aq \(aq
11 .el .ds Aq '
12 .\" -----------------------------------------------------------------
13 .\" * set default formatting
14 .\" -----------------------------------------------------------------
15 .\" disable hyphenation
16 .nh
17 .\" disable justification (adjust text to left margin only)
18 .ad l
19 .\" -----------------------------------------------------------------
20 .\" * MAIN CONTENT STARTS HERE *
21 .\" -----------------------------------------------------------------
22 .SH "NAME"
23 udev_enumerate_new, udev_enumerate_ref, udev_enumerate_unref \- Create, acquire and release a udev enumerate object
24 .SH "SYNOPSIS"
25 .sp
26 .ft B
27 .nf
28 #include <libudev\&.h>
29 .fi
30 .ft
31 .HP \w'struct\ udev_enumerate\ *udev_enumerate_new('u
32 .BI "struct udev_enumerate *udev_enumerate_new(struct\ udev\ *" "udev" ");"
33 .HP \w'struct\ udev_enumerate\ *udev_enumerate_ref('u
34 .BI "struct udev_enumerate *udev_enumerate_ref(struct\ udev_enumerate\ *" "udev_enumerate" ");"
35 .HP \w'struct\ udev_enumerate\ *udev_enumerate_unref('u
36 .BI "struct udev_enumerate *udev_enumerate_unref(struct\ udev_enumerate\ *" "udev_enumerate" ");"
37 .SH "DESCRIPTION"
38 .PP
39 \fBudev_enumerate_new()\fR
40 creates an enumeration context to scan
41 /sys/\&.
42 .PP
43 \fBudev_enumerate_ref()\fR
44 takes a reference of an enumeration context\&.
45 .PP
46 \fBudev_enumerate_unref()\fR
47 drops a reference of an enumeration context\&. If the refcount reaches zero, all resources of the enumeration context will be released\&.
48 .SH "RETURN VALUE"
49 .PP
50 On success,
51 \fBudev_enumerate_new()\fR
52 returns a pointer to the allocated enumeration object\&. On failure,
53 \fBNULL\fR
54 is returned\&.
55 \fBudev_enumerate_ref()\fR
56 returns the argument that it was passed, unmodified\&.
57 \fBudev_enumerate_unref()\fR
58 always returns
59 \fBNULL\fR\&.
60 .SH "HISTORY"
61 .PP
62 \fBudev_enumerate_new()\fR,
63 \fBudev_enumerate_ref()\fR, and
64 \fBudev_enumerate_unref()\fR
65 were added in version 221\&.
66 .SH "SEE ALSO"
67 .PP
68 \fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_enumerate_add_match_subsystem\fR(3), \fBudev_enumerate_scan_devices\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1)