[v4,1/5] util: add socket_set_fast_reuse function which will replace setting SO_REUSEADDR

Message ID 1379319907-14950-2-git-send-email-ottlik@fzi.de
State New
Headers show

Commit Message

Sebastian Ottlik Sept. 16, 2013, 8:25 a.m.
If a socket is closed it remains in TIME_WAIT state for some time. On operating
systems using BSD sockets the endpoint of the socket may not be reused while in
this state unless SO_REUSEADDR was set on the socket. On windows on the other
hand the default behaviour is to allow reuse (i.e. identical to SO_REUSEADDR on
other operating systems) and setting SO_REUSEADDR on a socket allows it to be
bound to a endpoint even if the endpoint is already used by another socket
independently of the other sockets state. This can even result in undefined

Many sockets used by QEMU should not block the use of their endpoint after being
closed while they are still in TIME_WAIT state. Currently QEMU sets SO_REUSEADDR
for such sockets, which can lead to problems on Windows. This patch introduces
the function socket_set_fast_reuse that should be used instead of setting
SO_REUSEADDR when fast socket reuse is desired and behaves correctly on all
operating systems.

Leaving the existing error reporting to the call site of socket_set_fast_reuse
would result in bad code or a need to change the way errors are reported, so
error reporting has been moved to socket_set_fast_reuse. As some places setting
SO_REUSEADDR do not report errors, this behaviour can be controlled with the
silent flag.

Signed-off-by: Sebastian Ottlik <ottlik@fzi.de>
 include/qemu/sockets.h |    1 +
 util/oslib-posix.c     |   14 ++++++++++++++
 util/oslib-win32.c     |   10 ++++++++++
 3 files changed, 25 insertions(+)


diff --git a/include/qemu/sockets.h b/include/qemu/sockets.h
index c5174d7..fcbdb2d 100644
--- a/include/qemu/sockets.h
+++ b/include/qemu/sockets.h
@@ -39,6 +39,7 @@  int socket_set_cork(int fd, int v);
 int socket_set_nodelay(int fd);
 void qemu_set_block(int fd);
 void qemu_set_nonblock(int fd);
+int socket_set_fast_reuse(int fd, bool silent);
 int send_all(int fd, const void *buf, int len1);
 int recv_all(int fd, void *buf, int len1, bool single_read);
diff --git a/util/oslib-posix.c b/util/oslib-posix.c
index 3dc8b1b..3beb341 100644
--- a/util/oslib-posix.c
+++ b/util/oslib-posix.c
@@ -159,6 +159,20 @@  void qemu_set_nonblock(int fd)
     fcntl(fd, F_SETFL, f | O_NONBLOCK);
+int socket_set_fast_reuse(int fd, bool silent)
+    int val = 1, ret;
+    ret = setsockopt(fd, SOL_SOCKET, SO_REUSEADDR,
+                     (const char *)&val, sizeof(val));
+    if (ret < 0 && !silent) {
+        perror("setsockopt(SOL_SOCKET, SO_REUSEADDR)");
+    }
+    return ret;
 void qemu_set_cloexec(int fd)
     int f;
diff --git a/util/oslib-win32.c b/util/oslib-win32.c
index 961fbf5..4e13aba 100644
--- a/util/oslib-win32.c
+++ b/util/oslib-win32.c
@@ -127,6 +127,16 @@  void qemu_set_nonblock(int fd)
+int socket_set_fast_reuse(int fd, bool silent)
+    /* Enabling the reuse of an endpoint that was used by a socket still in
+     * TIME_WAIT state is usually performed by setting SO_REUSEADDR. On Windows
+     * fast reuse is the default and SO_REUSEADDR does strange things. So we
+     * don't have to do anything here. More info can be found at:
+     * http://msdn.microsoft.com/en-us/library/windows/desktop/ms740621.aspx */
+    return 0;
 int inet_aton(const char *cp, struct in_addr *ia)
     uint32_t addr = inet_addr(cp);