TCP Fast Open (TFO) mechanism is described in https://tools.ietf.org/html/draft-ietf-tcpm-fastopen-10.
Other considerations can be found in this white paper.
TFO is currently only available on Linux.
Patches for ldns, NSD and Unbound can be found in our Stash repo:
Note also that the upcoming 0.1.5 release of getdns will have support for TCP Fast Open via configure option.
To use these patches:
- Download the source code from the relevant repository
- Apply the relevant patch
- IMPORTANT! Run autoreconf
- Add --enable-tcp-fastopen to the configure options
- make & make install as normal
TCP fastopen [I-D.ietf-tcpm-fastopen] (TFO) allows data to be carried in the SYN packet. It also saves up to one RTT compared to standard TCP. TFO clients request a server cookie in the initial SYN packet at the
start of a new connection. The server returns a cookie in its SYN-ACK. The client caches the cookie and reuses it when opening subsequent connections to the same server. The cookie is stored by the client's TCP stack (kernel) and persists if either the client or server processes are restarted. TFO also falls back to a regular TCP handshake gracefully.
Requesting Fast Open Cookie in connection 1: TCP A (Client) TCP B(Server) ______________ _____________ CLOSED LISTEN #1 SYN-SENT ----- <SYN,CookieOpt=NIL> ----------> SYN-RCVD #2 ESTABLISHED <---- <SYN,ACK,CookieOpt=C> ---------- SYN-RCVD (caches cookie C) Performing TCP Fast Open in connection 2: TCP A (Client) TCP B(Server) ______________ _____________ CLOSED LISTEN #1 SYN-SENT ----- <SYN=x,CookieOpt=C,DATA_A> ----> SYN-RCVD #2 ESTABLISHED <---- <SYN=y,ACK=x+len(DATA_A)+1> ---- SYN-RCVD #3 ESTABLISHED <---- <ACK=x+len(DATA_A)+1,DATA_B>---- SYN-RCVD #4 ESTABLISHED ----- <ACK=y+1>--------------------> ESTABLISHED #5 ESTABLISHED --- <ACK=y+len(DATA_B)+1>----------> ESTABLISHED
Adding support for this to existing name server implementations is relatively easy, but does require source code modifications. It is also controlled via the kernel parameter net.ipv4.tcp_fastopen, which is set to 1 by default which enables only client mode TFO. The changes required to support TFO are:
- On the client, the call to connect() is replaced with a call to sendmsg() or sendto() with the flags parameter set to MSG_FASTOPEN.
- For blocking sockets this performs both the handshake and sends the data before returning.
- For non-blocking socket it returns the number of bytes buffered and sent in the SYN packet.
- If the cookie is available it will send the data before returning.
- If the cookie is not available locally, it returns -1 with errno EINPROGRESS, and sends a SYN with TFO cookie request automatically. The caller needs to write the data again when the socket is connected with a call to send() or similar.
- Subsequent writes on this socket must also be done with send() or similar. A subsequent call with sendto() will return the error EISCONN.
On the server hosting the nameserver, TFO must be switched into server mode by changing the kernel parameter net.ipv4.tcp_fastopen to enable the server bit. To act in pure server mode, set the integer value to 2. To enable both client and server mode, set it to 3.
In our implementation we have chosen to leave this as a manual act to be performed on the server, rather than attempting this programatically. The change can be made with the following command:
Also the TCP_FASTOPEN socket option must be set between the bind() and listen() calls.
Google open resolvers
Note that the Google open resolver support TCP Fast Open so you can use a patched version of ldns/drill to test against them to see it in action!
As of Linux kernel 3.16 there is support for TFO IPv6 servers but not clients: