Debian Codegraph @

upstream/fedora-44/man3/udev_monitor_receive_device.3

raw
1 '\" t
2 .TH "UDEV_MONITOR_RECEIVE_DEVICE" "3" "" "systemd 259.5" "udev_monitor_receive_device"
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_monitor_receive_device, udev_monitor_enable_receiving, udev_monitor_set_receive_buffer_size, udev_monitor_get_fd, udev_monitor_get_udev \- Query and modify device monitor
24 .SH "SYNOPSIS"
25 .sp
26 .ft B
27 .nf
28 #include <libudev\&.h>
29 .fi
30 .ft
31 .HP \w'struct\ udev_device\ *udev_monitor_receive_device('u
32 .BI "struct udev_device *udev_monitor_receive_device(struct\ udev_monitor\ *" "udev_monitor" ");"
33 .HP \w'int\ udev_monitor_enable_receiving('u
34 .BI "int udev_monitor_enable_receiving(struct\ udev_monitor\ *" "udev_monitor" ");"
35 .HP \w'int\ udev_monitor_set_receive_buffer_size('u
36 .BI "int udev_monitor_set_receive_buffer_size(struct\ udev_monitor\ *" "udev_monitor" ", int\ " "size" ");"
37 .HP \w'int\ udev_monitor_get_fd('u
38 .BI "int udev_monitor_get_fd(struct\ udev_monitor\ *" "udev_monitor" ");"
39 .HP \w'struct\ udev\ *udev_monitor_get_udev('u
40 .BI "struct udev *udev_monitor_get_udev(struct\ udev_monitor\ *" "udev_monitor" ");"
41 .SH "RETURN VALUE"
42 .PP
43 On success,
44 \fBudev_monitor_receive_device()\fR
45 returns a pointer to a newly referenced device that was received via the monitor\&. The caller is responsible to drop this reference when done\&. On failure,
46 \fBNULL\fR
47 is returned\&.
48 .PP
49 On success,
50 \fBudev_monitor_enable_receiving()\fR
51 and
52 \fBudev_monitor_set_receive_buffer_size()\fR
53 return an integer greater than, or equal to,
54 \fB0\fR\&. On failure, a negative error code is returned\&.
55 .PP
56 On success,
57 \fBudev_monitor_get_fd()\fR
58 returns the file descriptor used by this monitor\&. On failure, a negative error code is returned\&.
59 .PP
60 \fBudev_monitor_get_udev()\fR
61 always returns a pointer to the udev context that this monitor is associated with\&.
62 .SH "HISTORY"
63 .PP
64 \fBudev_monitor_receive_device()\fR,
65 \fBudev_monitor_enable_receiving()\fR,
66 \fBudev_monitor_set_receive_buffer_size()\fR,
67 \fBudev_monitor_get_fd()\fR, and
68 \fBudev_monitor_get_udev()\fR
69 were added in version 221\&.
70 .SH "SEE ALSO"
71 .PP
72 \fBudev_new\fR(3), \fBudev_device_new_from_syspath\fR(3), \fBudev_enumerate_new\fR(3), \fBudev_monitor_new_from_netlink\fR(3), \fBudev_monitor_filter_update\fR(3), \fBudev_list_entry\fR(3), \fBsystemd\fR(1)