summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man3/sd_event_add_io.3
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/debian-unstable/man3/sd_event_add_io.3')
-rw-r--r--upstream/debian-unstable/man3/sd_event_add_io.330
1 files changed, 8 insertions, 22 deletions
diff --git a/upstream/debian-unstable/man3/sd_event_add_io.3 b/upstream/debian-unstable/man3/sd_event_add_io.3
index 4cf99760..c844d100 100644
--- a/upstream/debian-unstable/man3/sd_event_add_io.3
+++ b/upstream/debian-unstable/man3/sd_event_add_io.3
@@ -1,5 +1,5 @@
'\" t
-.TH "SD_EVENT_ADD_IO" "3" "" "systemd 255" "sd_event_add_io"
+.TH "SD_EVENT_ADD_IO" "3" "" "systemd 256~rc3" "sd_event_add_io"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -169,12 +169,14 @@ retrieves the UNIX file descriptor of an event source created previously with
.PP
\fBsd_event_source_set_io_fd()\fR
changes the UNIX file descriptor of an I/O event source created previously with
-\fBsd_event_add_io()\fR\&. It takes the event source object and the new file descriptor\&.
+\fBsd_event_add_io()\fR\&. It takes the event source object and the new file descriptor as parameters\&. If the event source owned the previous file descriptor, that is if
+\fBsd_event_source_set_io_fd_own()\fR
+had been called for the event source with a non\-zero value, then the previous file descriptor will be closed and the event source will also take the ownership of the new file descriptor on success\&.
.PP
\fBsd_event_source_set_io_fd_own()\fR
-controls whether the file descriptor of the event source shall be closed automatically when the event source is freed, i\&.e\&. whether it shall be considered \*(Aqowned\*(Aq by the event source object\&. By default it is not closed automatically, and the application has to do this on its own\&. The
-\fIb\fR
-parameter is a boolean parameter: if zero, the file descriptor is not closed automatically when the event source is freed, otherwise it is closed\&.
+controls whether the file descriptor of the event source shall take ownership of the file descriptor\&. Takes a boolean parameter
+\fIb\fR\&. When true (nonzero), the file descriptor will be closed automatically when the event source is freed or when the file descriptor is replaced by
+\fBsd_event_source_set_io_fd()\fR\&. By default the descriptor is not owned by the event source, and the application has to do close it on its own if needed\&.
.PP
\fBsd_event_source_get_io_fd_own()\fR
may be used to query the current setting of the file descriptor ownership boolean flag as set with
@@ -250,20 +252,4 @@ and
were added in version 239\&.
.SH "SEE ALSO"
.PP
-\fBsystemd\fR(1),
-\fBsd-event\fR(3),
-\fBsd_event_new\fR(3),
-\fBsd_event_now\fR(3),
-\fBsd_event_add_time\fR(3),
-\fBsd_event_add_signal\fR(3),
-\fBsd_event_add_child\fR(3),
-\fBsd_event_add_inotify\fR(3),
-\fBsd_event_add_defer\fR(3),
-\fBsd_event_source_set_enabled\fR(3),
-\fBsd_event_source_set_priority\fR(3),
-\fBsd_event_source_set_userdata\fR(3),
-\fBsd_event_source_set_description\fR(3),
-\fBsd_event_source_get_pending\fR(3),
-\fBsd_event_source_set_floating\fR(3),
-\fBepoll_ctl\fR(2),
-\fBepoll\fR(7)
+\fBsystemd\fR(1), \fBsd-event\fR(3), \fBsd_event_new\fR(3), \fBsd_event_now\fR(3), \fBsd_event_add_time\fR(3), \fBsd_event_add_signal\fR(3), \fBsd_event_add_child\fR(3), \fBsd_event_add_inotify\fR(3), \fBsd_event_add_defer\fR(3), \fBsd_event_source_set_enabled\fR(3), \fBsd_event_source_set_priority\fR(3), \fBsd_event_source_set_userdata\fR(3), \fBsd_event_source_set_description\fR(3), \fBsd_event_source_get_pending\fR(3), \fBsd_event_source_set_floating\fR(3), \fBepoll_ctl\fR(2), \fBepoll\fR(7)