aboutsummaryrefslogtreecommitdiffstats
path: root/guide
diff options
context:
space:
mode:
authorLoïc Hoguin <[email protected]>2013-01-17 18:26:14 +0100
committerLoïc Hoguin <[email protected]>2013-01-17 18:26:14 +0100
commit81757b2bced82850d1b72020a26d8fca1b709bde (patch)
tree462303bcf9dc7c66943dd1419f952d709400b5e1 /guide
parentd20989e722c50afea4ed510f372bbbd9221b9048 (diff)
downloadranch-81757b2bced82850d1b72020a26d8fca1b709bde.tar.gz
ranch-81757b2bced82850d1b72020a26d8fca1b709bde.tar.bz2
ranch-81757b2bced82850d1b72020a26d8fca1b709bde.zip
Add section about platform-specific TCP features to the guide
Diffstat (limited to 'guide')
-rw-r--r--guide/internals.md43
-rw-r--r--guide/toc.md3
2 files changed, 35 insertions, 11 deletions
diff --git a/guide/internals.md b/guide/internals.md
index cb1f955..35fd39b 100644
--- a/guide/internals.md
+++ b/guide/internals.md
@@ -5,6 +5,12 @@ This chapter may not apply to embedded Ranch as embedding allows you
to use an architecture specific to your application, which may or may
not be compatible with the description of the Ranch application.
+Note that for everything related to efficiency and performance,
+you should perform the benchmarks yourself to get the numbers that
+matter to you. Generic benchmarks found on the web may or may not
+be of use to you, you can never know until you benchmark your own
+system.
+
Architecture
------------
@@ -47,16 +53,8 @@ sockets. Protocol handlers start a new process, which receives socket
ownership, with no requirements on how the code should be written inside
that new process.
-Efficiency considerations
--------------------------
-
-Note that for everything related to efficiency and performance,
-you should perform the benchmarks yourself to get the numbers that
-matter to you. Generic benchmarks found on the web may or may not
-be of use to you, you can never know until you benchmark your own
-system.
-
-* * *
+Number of acceptors
+-------------------
The second argument to `ranch:start_listener/6` is the number of
processes that will be accepting connections. Care should be taken
@@ -78,3 +76,28 @@ Our observations suggest that using 100 acceptors on modern hardware
is a good solution, as it's big enough to always have acceptors ready
and it's low enough that it doesn't have a negative impact on the
system's performances.
+
+Platform-specific TCP features
+------------------------------
+
+Some socket options are platform-specific and not supported by `inet`.
+They can be of interest because they generally are related to
+optimizations provided by the underlying OS. They can still be enabled
+thanks to the `raw` option, for which we will see an example.
+
+One of these features is `TCP_DEFER_ACCEPT` on Linux. It is a simplified
+accept mechanism which will wait for application data to come in before
+handing out the connection to the Erlang process.
+
+This is especially useful if you expect many connections to be mostly
+idle, perhaps part of a connection pool. They can be handled by the
+kernel directly until they send any real data, instead of allocating
+resources to idle connections.
+
+To enable this mechanism, the following option can be used.
+
+``` erlang
+ {raw, 6, 9, << 30:32/native >>}
+```
+
+It means go on layer 6, turn on option 9 with the given integer parameter.
diff --git a/guide/toc.md b/guide/toc.md
index 3cbdbcf..34500e1 100644
--- a/guide/toc.md
+++ b/guide/toc.md
@@ -31,4 +31,5 @@ Ranch User Guide
* Embedding
* [Internals](internals.md)
* Architecture
- * Efficiency considerations
+ * Number of acceptors
+ * Platform-specific TCP features