Go to file
Chris Vest 56adab2743
TCP Fast Open for clients (#11006)
Support TCP Fast Open for clients and make SslHandler take advantage

Motivation:
- TCP Fast Open allow us to send a small amount of data along side the initial SYN packet when establishing a TCP connection.
- The TLS Client Hello packet is small enough to fit in there, and is also idempotent (another requirement for using TCP Fast Open), so if we can save a round-trip when establishing TLS connections when using TFO.

Modification:
- Add support for client-side TCP Fast Open for Epoll, and also lowers the Linux kernel version requirements to 3.6.
- When adding the SslHandler to a pipeline, if TCP Fast Open is enabled for the channel (and the channel is not already active) then start the handshake early by writing it to the outbound buffer.
- An important detail to note here, is that the outbound buffer is not flushed at this point, like it would for normal handshakes. The flushing happens later as part of establishing the TCP connection.

Result:
- It is now possible for clients (on epoll) to open connections with TCP Fast Open.
- The SslHandler automatically detects when this is the case, and now send its Client Hello message as part of the initial data in the TCP Fast Open flow when available, saving a round-trip when establishing TLS connections.

Co-authored-by: Colin Godsey <crgodsey@gmail.com>
2021-02-15 13:13:44 +01:00
.github Add workflow to cut releases (#11019) 2021-02-11 21:35:36 +01:00
.mvn Use latest maven release (#9820) 2019-11-27 14:45:28 +01:00
all [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
bom [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
buffer [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
codec [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
codec-dns [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
codec-haproxy [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
codec-http Simplity some code (#11000) 2021-02-11 08:42:01 +01:00
codec-http2 [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
codec-memcache [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
codec-mqtt Simplity some code (#11000) 2021-02-11 08:42:01 +01:00
codec-redis [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
codec-smtp [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
codec-socks [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
codec-stomp [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
codec-xml Simplity some code (#11000) 2021-02-11 08:42:01 +01:00
common Fix link in javadoc (#11022) 2021-02-12 14:40:24 +01:00
dev-tools [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
docker Add workflow to cut releases (#11019) 2021-02-11 21:35:36 +01:00
example [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
handler TCP Fast Open for clients (#11006) 2021-02-15 13:13:44 +01:00
handler-proxy [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
license Enable nohttp check during the build (#10708) 2020-10-23 14:44:18 +02:00
microbench [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
resolver [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
resolver-dns Allow blocking calls when parsing etcResolver/hosts files (#11009) 2021-02-11 11:03:20 +01:00
resolver-dns-native-macos [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
scripts Add workflow to cut releases (#11019) 2021-02-11 21:35:36 +01:00
tarball [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
testsuite TCP Fast Open for clients (#11006) 2021-02-15 13:13:44 +01:00
testsuite-autobahn [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
testsuite-http2 [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
testsuite-native [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
testsuite-native-image [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
testsuite-native-image-client [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
testsuite-native-image-client-runtime-init [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
testsuite-osgi [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
testsuite-shading [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
transport TCP Fast Open for clients (#11006) 2021-02-15 13:13:44 +01:00
transport-blockhound-tests Allow blocking calls when parsing etcResolver/hosts files (#11009) 2021-02-11 11:03:20 +01:00
transport-native-epoll TCP Fast Open for clients (#11006) 2021-02-15 13:13:44 +01:00
transport-native-kqueue [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
transport-native-unix-common TCP Fast Open for clients (#11006) 2021-02-15 13:13:44 +01:00
transport-native-unix-common-tests [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
transport-rxtx [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
transport-sctp [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
transport-udt [maven-release-plugin] prepare for next development iteration 2021-02-08 10:48:37 +00:00
.fbprefs Updated Find Bugs configuration 2009-03-04 10:33:09 +00:00
.gitattributes Include mvn wrapper to make setup of development env easier 2018-01-26 08:13:17 +01:00
.gitignore Ignore .shelf/ folder generated by IntelliJ IDEA (#10445) 2020-08-03 07:51:53 +02:00
.lgtm.yml Enables lgtm.com to process this project and create a CodeQL database 2020-01-17 11:05:53 +01:00
CONTRIBUTING.md Change the netty.io homepage scheme(http -> https) (#9344) 2019-07-09 21:09:42 +02:00
LICENSE.txt Enable nohttp check during the build (#10708) 2020-10-23 14:44:18 +02:00
mvnw Enable nohttp check during the build (#10708) 2020-10-23 14:44:18 +02:00
mvnw.cmd Enable nohttp check during the build (#10708) 2020-10-23 14:44:18 +02:00
nohttp-checkstyle-suppressions.xml Ensure Checkstyle suppression for dependency-reduced-pom.xml on Windows (#10899) 2021-01-01 19:30:13 +01:00
nohttp-checkstyle.xml Enable nohttp check during the build (#10708) 2020-10-23 14:44:18 +02:00
NOTICE.txt Fix License type of dnsinfo (#10773) 2020-11-04 10:40:43 +01:00
pom.xml Upgrade graalvm version to the latest version (#11012) 2021-02-11 13:29:05 +01:00
README.md Fix url in README.md (#10915) 2021-01-11 07:48:58 +01:00
run-example.sh Add DNS client examples for run-example.sh (#10283) 2020-05-14 12:10:32 +02:00
SECURITY.md Added a security policy (#10692) 2020-10-15 20:39:37 +02:00

Build project

Netty Project

Netty is an asynchronous event-driven network application framework for rapid development of maintainable high performance protocol servers & clients.

How to build

For the detailed information about building and developing Netty, please visit the developer guide. This page only gives very basic information.

You require the following to build Netty:

Note that this is build-time requirement. JDK 5 (for 3.x) or 6 (for 4.0+ / 4.1+) is enough to run your Netty-based application.

Branches to look

Development of all versions takes place in each branch whose name is identical to <majorVersion>.<minorVersion>. For example, the development of 3.9 and 4.1 resides in the branch '3.9' and the branch '4.1' respectively.

Usage with JDK 9+

Netty can be used in modular JDK9+ applications as a collection of automatic modules. The module names follow the reverse-DNS style, and are derived from subproject names rather than root packages due to historical reasons. They are listed below:

  • io.netty.all
  • io.netty.buffer
  • io.netty.codec
  • io.netty.codec.dns
  • io.netty.codec.haproxy
  • io.netty.codec.http
  • io.netty.codec.http2
  • io.netty.codec.memcache
  • io.netty.codec.mqtt
  • io.netty.codec.redis
  • io.netty.codec.smtp
  • io.netty.codec.socks
  • io.netty.codec.stomp
  • io.netty.codec.xml
  • io.netty.common
  • io.netty.handler
  • io.netty.handler.proxy
  • io.netty.resolver
  • io.netty.resolver.dns
  • io.netty.transport
  • io.netty.transport.epoll (native omitted - reserved keyword in Java)
  • io.netty.transport.kqueue (native omitted - reserved keyword in Java)
  • io.netty.transport.unix.common (native omitted - reserved keyword in Java)
  • io.netty.transport.rxtx
  • io.netty.transport.sctp
  • io.netty.transport.udt

Automatic modules do not provide any means to declare dependencies, so you need to list each used module separately in your module-info file.