DOC: quic: add note on performance issue with listener contention

Complete quic4/quic6 bind lines by a note on performance issues due to
receiver socket contention. Suggest to use sharding to improve the
situation.

This should be backported up to 2.6.
This commit is contained in:
Amaury Denoyelle 2022-11-22 11:26:16 +01:00
parent 5ec79f1a04
commit 7078fb1f3a

View File

@ -4563,9 +4563,15 @@ bind /<path> [, ...] [param*]
to receive a FD over the unix socket and uses it as if it
was the FD of an accept(). Should be used carefully.
- 'quic4@' -> address is resolved as IPv4 and protocol UDP
is used.
is used. Note that QUIC connections attached to a
listener will be multiplexed over the listener socket.
With a large traffic this has a noticeable impact on
performance and CPU consumption. To improve this, you
should duplicate QUIC listener instances over several
threads, for example using "shards" keyword.
- 'quic6@' -> address is resolved as IPv6 and protocol UDP
is used.
is used. The performance note for QUIC over IPv4 applies
as well.
You may want to reference some environment variables in the
address parameter, see section 2.3 about environment