From 9b5e5f7883ef59201d17343680d109c1f9d5ae9b Mon Sep 17 00:00:00 2001
From: Matthias Schiffer <mschiffer@universe-factory.net>
Date: Tue, 27 May 2014 05:00:11 +0200
Subject: poll: document the poll API

---
 src/poll.c | 6 ++----
 1 file changed, 2 insertions(+), 4 deletions(-)

(limited to 'src/poll.c')

diff --git a/src/poll.c b/src/poll.c
index e57d349..911fc2e 100644
--- a/src/poll.c
+++ b/src/poll.c
@@ -24,7 +24,7 @@
 */
 
 /**
-   \file poll.h
+   \file poll.c
 
    Portable polling API implementations
 */
@@ -41,6 +41,7 @@
 #endif
 
 
+/** Returns the time to the next handshake or -1 */
 static inline int handshake_timeout(void) {
 	if (!ctx.handshake_queue.next)
 		return -1;
@@ -61,7 +62,6 @@ static inline int handshake_timeout(void) {
 #include <sys/epoll.h>
 
 
-/** Initializes the poll interface */
 void fastd_poll_init(void) {
 	ctx.epoll_fd = epoll_create1(0);
 	if (ctx.epoll_fd < 0)
@@ -75,13 +75,11 @@ void fastd_poll_init(void) {
 		exit_errno("epoll_ctl");
 }
 
-/** Frees the poll interface */
 void fastd_poll_free(void) {
 	if (close(ctx.epoll_fd))
 		pr_warn_errno("closing EPOLL: close");
 }
 
-
 void fastd_poll_set_fd_tuntap(void) {
 	struct epoll_event event = {
 		.events = EPOLLIN,
-- 
cgit v1.2.3