path: root/sys/sys/filio.h
diff options
authorPoul-Henning Kamp <phk@FreeBSD.org>2009-06-28 11:28:14 +0000
committerPoul-Henning Kamp <phk@FreeBSD.org>2009-06-28 11:28:14 +0000
commitbb520069caf7772294f4aa0f1462ac38ea9a3f20 (patch)
tree12880e3a07e15788493652721212c558d8c339f1 /sys/sys/filio.h
parentc92033c874bb142cb6f94119db9a2b3618546c3f (diff)
There are a number of ways an application can check if there are
inbound data waiting on a filedescriptor, such as a pipe or a socket, for instance by using select(2), poll(2), kqueue(2), ioctl(FIONREAD) etc. But we have no way of finding out if written data have yet to be disposed of, for instance, transmitted (and ack'ed!) to some remote host, or read by the applicantion at the far end of the pipe. The closest we get, is calling shutdown(2) on a TCP socket in non-blocking mode, but this has the undesirable sideeffect of preventing future communication. Add a complement to FIONREAD, called FIONWRITE, which returns the number of bytes not yet properly disposed of. Implement it for all sockets. Background: A HTTP server will want to time out connections, if no new request arrives within a certain period after the last transmitted response has actually been sent (and ack'ed). For a busy HTTP server, this timeout can be subsecond duration. In order to signal to a load-balancer that the connection is truly dead, TCP_RST will be the preferred method, as this avoids the need for a RTT delay for FIN handshaking, with a client which, surprisingly often, no longer at the remote IP number. If a slow, distant client is being served a response which is big enough to fill the window, but small enough to fit in the socket buffer, the write(2) call will return immediately. If the session timeout is armed at that time, all bytes in the response may not have been transmitted by the time it fires. FIONWRITE allows the timeout to check that no data is outstanding on the connection, before it TCP_RST's it. Input & Idea from: rwatson Approved by: re (kib)
Notes: svn path=/head/; revision=195134
Diffstat (limited to 'sys/sys/filio.h')
1 files changed, 1 insertions, 0 deletions
diff --git a/sys/sys/filio.h b/sys/sys/filio.h
index 5f13288b70ce..68e7852a4ceb 100644
--- a/sys/sys/filio.h
+++ b/sys/sys/filio.h
@@ -55,6 +55,7 @@ struct fiodgname_arg {
void *buf;
#define FIODGNAME _IOW('f', 120, struct fiodgname_arg) /* get dev. name */
+#define FIONWRITE _IOR('f', 119, int) /* get # bytes (yet) to write */
/* Handle lseek SEEK_DATA and SEEK_HOLE for holey file knowledge. */
#define FIOSEEKDATA _IOWR('f', 97, off_t) /* SEEK_DATA */
#define FIOSEEKHOLE _IOWR('f', 98, off_t) /* SEEK_HOLE */