LDP: Update original to LDP v3.79

[linuxjm/LDP_man-pages.git] / original / man7 / epoll.7

diff --git a/original/man7/epoll.7 b/original/man7/epoll.7
index 4099295..c1dab45 100644 (file)
--- a/original/man7/epoll.7
+++ b/original/man7/epoll.7
@@ -18,7 +18,7 @@
 .\"
 .\"  Davide Libenzi <davidel@xmailserver.org>
 .\"
-.TH EPOLL 7 2012-04-17 "Linux" "Linux Programmer's Manual"
+.TH EPOLL 7 2015-01-10 "Linux" "Linux Programmer's Manual"
 .SH NAME
 epoll \- I/O event notification facility
 .SH SYNOPSIS
@@ -173,6 +173,37 @@ it is the caller's responsibility to rearm the file descriptor using
 .BR epoll_ctl (2)
 with
 .BR EPOLL_CTL_MOD .
+.SS Interaction with autosleep
+If the system is in
+.B autosleep
+mode via
+.I /sys/power/autosleep
+and an event happens which wakes the device from sleep, the device
+driver will keep the device awake only until that event is queued.
+To keep the device awake until the event has been processed,
+it is necessary to use the
+.BR epoll (7)
+.B EPOLLWAKEUP
+flag.
+
+When the
+.B EPOLLWAKEUP
+flag is set in the
+.B events
+field for a
+.IR "struct epoll_event" ,
+the system will be kept awake from the moment the event is queued,
+through the
+.BR epoll_wait (2)
+call which returns the event until the subsequent
+.BR epoll_wait (2)
+call.
+If the event should keep the system awake beyond that time,
+then a separate
+.I wake_lock
+should be taken before the second
+.BR epoll_wait (2)
+call.
 .SS /proc interfaces
 The following interfaces can be used to limit the amount of
 kernel memory consumed by epoll:
@@ -231,12 +262,12 @@ from where it stopped before.
 struct epoll_event ev, events[MAX_EVENTS];
 int listen_sock, conn_sock, nfds, epollfd;
 
-/* Set up listening socket, \(aqlisten_sock\(aq (socket(),
-   bind(), listen()) */
+/* Code to set up listening socket, \(aqlisten_sock\(aq,
+   (socket(), bind(), listen()) omitted */
 
-epollfd = epoll_create(10);
+epollfd = epoll_create1(0);
 if (epollfd == \-1) {
-    perror("epoll_create");
+    perror("epoll_create1");
     exit(EXIT_FAILURE);
 }
 
@@ -549,7 +580,7 @@ and Solaris has
 .BR epoll_ctl (2),
 .BR epoll_wait (2)
 .SH COLOPHON
-This page is part of release 3.68 of the Linux
+This page is part of release 3.79 of the Linux
 .I man-pages
 project.
 A description of the project,