Debian Codegraph @

upstream/mageia-cauldron/man3/udev_list_entry.3

raw
1 '\" t
2 .TH "UDEV_LIST_ENTRY" "3" "" "systemd 258.7" "udev_list_entry"
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_list_entry, udev_list_entry_get_next, udev_list_entry_get_by_name, udev_list_entry_get_name, udev_list_entry_get_value \- Iterate and access udev lists
24 .SH "SYNOPSIS"
25 .sp
26 .ft B
27 .nf
28 #include <libudev\&.h>
29 .fi
30 .ft
31 .HP \w'struct\ udev_list_entry\ *udev_list_entry_get_next('u
32 .BI "struct udev_list_entry *udev_list_entry_get_next(struct\ udev_list_entry\ *" "list_entry" ");"
33 .HP \w'struct\ udev_list_entry\ *udev_list_entry_get_by_name('u
34 .BI "struct udev_list_entry *udev_list_entry_get_by_name(struct\ udev_list_entry\ *" "list_entry" ", const\ char\ *" "name" ");"
35 .HP \w'const\ char\ *udev_list_entry_get_name('u
36 .BI "const char *udev_list_entry_get_name(struct\ udev_list_entry\ *" "list_entry" ");"
37 .HP \w'const\ char\ *udev_list_entry_get_value('u
38 .BI "const char *udev_list_entry_get_value(struct\ udev_list_entry\ *" "list_entry" ");"
39 .SH "RETURN VALUE"
40 .PP
41 On success,
42 \fBudev_list_entry_get_next()\fR
43 and
44 \fBudev_list_entry_get_by_name()\fR
45 return a pointer to the requested list entry\&. If no such entry can be found, or on failure,
46 \fBNULL\fR
47 is returned\&.
48 .PP
49 On success,
50 \fBudev_list_entry_get_name()\fR
51 and
52 \fBudev_list_entry_get_value()\fR
53 return a pointer to a constant string representing the requested value\&. The string is bound to the lifetime of the list entry itself\&. On failure,
54 \fBNULL\fR
55 is returned\&.
56 .SH "HISTORY"
57 .PP
58 \fBudev_list_entry_get_next()\fR,
59 \fBudev_list_entry_get_by_name()\fR,
60 \fBudev_list_entry_get_name()\fR, and
61 \fBudev_list_entry_get_value()\fR
62 were added in version 221\&.
63 .SH "SEE ALSO"
64 .PP
65 \fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBsystemd\fR(1)