Running an HTTP/2 client over TLS (over TCP). ALPN is "h2".

Running an HTTP/2 client over TLS (over TCP). ALPN is "h2".

Running an HTTP/2 client over TCP.

Running an HTTP/2 client over TCP.

Server type. Server takes a HTTP request, should generate a HTTP response and push promises, then should give them to the sending function. The sending function would throw exceptions so that they can be logged.

The sending function must only be called once.

Either a host name e.g., "haskell.org" or a numeric host address string consisting of a dotted decimal IPv4 address or an IPv6 address e.g., "192.168.0.1".

Port number. Use the Num instance (i.e. use a literal) to create a PortNumber value.

>>> 1 :: PortNumber
1
>>> read "1" :: PortNumber
1
>>> show (12345 :: PortNumber)
"12345"
>>> 50000 < (51000 :: PortNumber)
True
>>> 50000 < (52000 :: PortNumber)
True
>>> 50000 + (10000 :: PortNumber)
60000

Running a TLS client. IOBackend provides sending and receiving functions with timeout based on Settings.

Running a TLS client. IOBackend provides sending and receiving functions with timeout based on Settings.

Default settings.

Timeout in seconds. (All)

>>> settingsTimeout defaultSettings
30

Send buffer size. (H2 and H2c)

>>> settingsSendBufferSize defaultSettings
4096

If the size of receiving data is less than or equal, the timeout is not reset. (All)

>>> settingsSlowlorisSize defaultSettings
50

When the size of a read buffer is lower than this limit, the buffer is thrown awany (and is eventually freed). Then a new buffer is allocated. (All)

>>> settingsReadBufferSize defaultSettings
16384

The allocation size for a read buffer. (All)

>>> settingsReadBufferLowerLimit defaultSettings
2048

Key logger.

Applications may wish to set this depending on the SSLKEYLOGFILE environment variable. The default is do nothing.

Default: do nothing

The http2 library now spawns a thread for each connection. Its limit is based on settingsConcurrentStreams.

The maximum number of incoming streams on the net (H2 and H2c)

>>> settingsConcurrentStreams defaultSettings
64

The window size of a connection (H2 and H2c)

>>> settingsConnectionWindowSize defaultSettings
1048575

The window size of incoming streams (H2 and H2c)

>>> settingsStreamWindowSize defaultSettings
262144

TLS session manager (H2 and TLS)

Default: noSessionManager

The max size of early data (0-RTT) to be accepted. (H2 and TLS) 0 means that early data is not accepted.

>>> settingsEarlyDataSize defaultSettings
0

Maximum number of pings allowed per second (CVE-2019-9512)

>>> settingsPingRateLimit defaultSettings
10

Maximum number of empty data frames allowed per second (CVE-2019-9518)

>>> settingsEmptyFrameRateLimit defaultSettings
4

Maximum number of settings frames allowed per second (CVE-2019-9515)

>>> settingsSettingsRateLimit defaultSettings
4

Maximum number of reset frames allowed per second (CVE-2023-44487)

>>> settingsRstRateLimit
4

Sending and receiving functions. Tiemout is reset when they return. One exception is the slowloris attach prevention. See settingsSlowlorisSize.

Sending.

Sending many.

Receiving.

The socket for the request