tree-wide: introduce free_and_replace helper

[elogind.git] / src / basic / io-util.c

diff --git a/src/basic/io-util.c b/src/basic/io-util.c
index 0037a37f2a458151bb62d1ec77202ac64bb76c92..cc6dfa8c1b94a29bcaf36cdb139be8dc09467178 100644 (file)
--- a/src/basic/io-util.c
+++ b/src/basic/io-util.c
@@ -33,6 +33,11 @@ int flush_fd(int fd) {
                 .events = POLLIN,
         };
 
+        /* Read from the specified file descriptor, until POLLIN is not set anymore, throwing away everything
+         * read. Note that some file descriptors (notable IP sockets) will trigger POLLIN even when no data can be read
+         * (due to IP packet checksum mismatches), hence this function is only safe to be non-blocking if the fd used
+         * was set to non-blocking too. */
+
         for (;;) {
                 char buf[LINE_MAX];
                 ssize_t l;