Skip to content

Add the Roadrunner (Erlang) server - #159

Draft
williamthome wants to merge 2 commits into
MDA2AV:mainfrom
williamthome:feat/roadrunner
Draft

williamthome wants to merge 2 commits into
MDA2AV:mainfrom
williamthome:feat/roadrunner

Conversation

@williamthome

Copy link
Copy Markdown

Adds src/Servers/RoadrunnerServer/ (Dockerfile, probe.json, rebar.config, rebar.lock and the Erlang sources) and docs/content/servers/roadrunner.md. Roadrunner is a pure-Erlang HTTP/1.1, HTTP/2, HTTP/3 and WebSocket server; the entry runs roadrunner 0.10.1 from Hex as an OTP release, with one HTTP/1.1 listener on port 8080 using the server's default options. HEAD and the unread-body handling are roadrunner's own behaviour: the handler only serves /echo, /cookie (echoing the cookies roadrunner parsed) and a catch-all that echoes a POST body.

Measured locally against the image this Dockerfile builds, run with --network host and this repo's CLI: 156/159, 0 errors, 213 tests. The three scored failures are deliberate status choices where roadrunner follows the RFC rather than the expected 400:

  • MAL-LONG-METHOD: a 100 KB method gets 501, which RFC 9112 §3 asks for a method longer than any the server implements
  • MAL-CL-OVERFLOW and MAL-CHUNK-SIZE-OVERFLOW: a Content-Length of 99999999999999999999 and a chunk size of FFFFFFFFFFFFFFFF0 are valid syntax that Erlang integers parse without overflow, so they get 413 Content Too Large

web/assets/grid.js: Roadrunner joins the Emerging tier.

README.md: recounted to 47 reference servers in 14 languages. The line said 42 and 12, but main already had 46 server directories in 13 languages before this entry.

@sonarqubecloud

Copy link
Copy Markdown

@github-actions

Copy link
Copy Markdown

Http11Probe — Compliance Comparison

Server Score
Roadrunner 156/159 ████████████████████ 98%

✅ Baseline Passed

Compliance

Test Expected Roadrunner
BASELINE 2xx ✅200
BARE-LF-REQUEST-LINE 400 or close (pass), 2xx (warn) ✅400
BARE-LF-HEADER 400 or close (pass), 2xx (warn) ✅400
OBS-FOLD 400 ✅400
SP-BEFORE-COLON 400 ✅400
MULTI-SP-REQUEST-LINE 400 or 2xx; close/timeout = warn ✅400
MISSING-HOST 400 ✅400
INVALID-VERSION 400/505, close, or timeout = warn ✅400
EMPTY-HEADER-NAME 400 or close ✅400
CR-ONLY-LINE-ENDING 400, close, or timeout = warn ✅400
MISSING-TARGET 400, close, or timeout = warn ✅400
FRAGMENT-IN-TARGET 400 or 2xx; 404 = warn ✅400
HTTP09-REQUEST 400/close/timeout ✅400
INVALID-HEADER-NAME 400 or close ✅400
HEADER-NO-COLON 400 or close ✅400
DUPLICATE-HOST 400 ✅400
CL-NON-NUMERIC 400 or close ✅400
CL-PLUS-SIGN 400 or close ✅400
WHITESPACE-BEFORE-HEADERS 400 or close ✅400
DUPLICATE-HOST-SAME 400 ✅400
HOST-WITH-USERINFO 400 or close ✅400
HOST-WITH-PATH 400 or close ✅400
ASTERISK-WITH-GET 400, close, or timeout = warn ✅400
OPTIONS-STAR 2xx or 405; close/timeout = warn ✅200
UNKNOWN-TE-501 400/501 or close ✅400
LEADING-CRLF 400 or 2xx; close/timeout = warn ✅400
ABSOLUTE-FORM 2xx preferred; 400/close/timeout = warn ✅200
METHOD-CASE 400/405/501 or 2xx; close/timeout = warn ✅400
POST-CL-BODY 2xx + echo ✅200
POST-CL-ZERO 2xx or close ✅200
POST-NO-CL-NO-TE 2xx or close ✅200
POST-CL-UNDERSEND 400/close/timeout ✅TimedOut
CHUNKED-BODY 2xx + echo ✅200
CHUNKED-MULTI 2xx + echo ✅200
CHUNKED-EMPTY 2xx or close ✅200
CHUNKED-NO-FINAL 400/close/timeout ✅TimedOut
METHOD-CONNECT 400/405/501 or close ✅501
EXPECT-UNKNOWN 417 or 2xx ⚠️200
GET-WITH-CL-BODY 400 or 2xx ⚠️200
CHUNKED-EXTENSION 2xx preferred; 400 warns ✅200
METHOD-TRACE 405/501 or 2xx ⚠️200
HOST-EMPTY-VALUE 400 or close ✅400
REQUEST-LINE-TAB 400 or 2xx; close/timeout = warn ✅400
VERSION-MISSING-MINOR 400, close, or timeout = warn ✅400
VERSION-LEADING-ZEROS 400, close, or timeout = warn ✅400
VERSION-WHITESPACE 400, close, or timeout = warn ✅400
CONNECTION-CLOSE 2xx + close ✅200
HTTP10-DEFAULT-CLOSE 2xx + close ✅200
HTTP10-NO-HOST 200 or 400 ⚠️200
HTTP12-VERSION 200 or 505 ❌400
TRACE-WITH-BODY 400/405 or 200 ⚠️200
CHUNKED-TRAILER-VALID 2xx + echo ✅200
CHUNKED-HEX-UPPERCASE 2xx + echo ✅200
RANGE-POST 2xx (Range ignored) ✅200
HEAD-NO-BODY 2xx with no body ✅200
UNKNOWN-METHOD 501/405/400 or close ⚠️200
DATE-HEADER 2xx with Date header ✅200
DATE-FORMAT IMF-fixdate format ✅200
NO-1XX-HTTP10 non-1xx response ✅200
OPTIONS-ALLOW 2xx with Allow header, or 405 ⚠️200
CONTENT-TYPE 2xx with Content-Type ✅200
VERSION-CASE 400, close, or timeout = warn ✅400
LONG-URL-OK not 414; close/timeout = warn ✅200
SPACE-IN-TARGET 400, close, or timeout = warn ✅400
DUPLICATE-CT 400 or 2xx ✅400
TRACE-SENSITIVE 405/501, or 200 without Auth ✅200
RANGE-INVALID 200 or 416 ✅200
ACCEPT-NONSENSE 406 or 2xx ⚠️200
POST-UNSUPPORTED-CT 415 or 2xx ✅200

Smuggling

Test Expected Roadrunner
CL-TE-BOTH 400 or 2xx ✅400
DUPLICATE-CL 400 or close ✅400
CL-LEADING-ZEROS 400 or 2xx ⚠️200
TE-XCHUNKED 400/501 or close ✅400
TE-TRAILING-SPACE 400/501 or 2xx+close ✅400
TE-SP-BEFORE-COLON 400 or close ✅400
CL-NEGATIVE 400 or close ✅400
CLTE-PIPELINE 400 or close preferred; 2xx acceptable ✅400
TECL-PIPELINE 400 or close preferred; 2xx acceptable ✅400
CL-TRAILING-SPACE 400 or 2xx ⚠️200
TE-DOUBLE-CHUNKED 400 or 2xx ✅400
CL-EXTRA-LEADING-SP 400 or 2xx ⚠️200
TE-CASE-MISMATCH 400 or 2xx ✅400
CL-COMMA-DIFFERENT 400 or close ✅400
TE-NOT-FINAL-CHUNKED 400 or close ✅400
TE-HTTP10 400 or close ✅400
CHUNK-BARE-SEMICOLON 400 or close ✅400
CHUNK-EXT-INVALID-TOKEN 400 or close ✅400
BARE-CR-HEADER-VALUE 400 or close ✅400
CL-OCTAL 400 or close ✅400
CHUNK-UNDERSCORE 400 or close ✅400
TE-EMPTY-VALUE 400 or close ✅400
TE-LEADING-COMMA 400 or 2xx ✅400
TE-DUPLICATE-HEADERS 400 or close ✅400
CHUNK-HEX-PREFIX 400 or close ✅400
CHUNK-SIZE-PLUS 400 or close ✅400
CHUNK-SIZE-TRAILING-OWS 400 or close ✅400
CL-HEX-PREFIX 400 or close ✅400
CL-INTERNAL-SPACE 400 or close ✅400
CHUNK-LEADING-SP 400 or close ✅400
CHUNK-MISSING-TRAILING-CRLF 400 or close ✅400
CHUNK-EXT-LF 400 or 2xx ✅400
CHUNK-SPILL 400 or close ✅400
CHUNK-LF-TERM 400 or 2xx ✅400
CHUNK-EXT-CTRL 400 or close ✅400
CHUNK-EXT-CR 400 or close ✅400
TE-VTAB 400 or close ✅400
TE-FORMFEED 400 or close ✅400
TE-NULL 400 or close ✅400
CHUNK-LF-TRAILER 400 or 2xx ✅400
TE-IDENTITY 400/501 or close ✅400
CHUNK-NEGATIVE 400 or close ✅400
TRANSFER_ENCODING 400 or 2xx ⚠️200
CL-COMMA-SAME 400 or 2xx ✅400
CL-COMMA-TRIPLE 400 or 2xx ✅400
CHUNKED-WITH-PARAMS 400 or 2xx ✅400
EXPECT-100-CL 100, 400 or 2xx ⚠️200
TRAILER-CL 400 or 2xx ⚠️200
TRAILER-TE 400 or 2xx ⚠️200
TRAILER-HOST 400 or 2xx ⚠️200
TRAILER-AUTH 400 or 2xx ⚠️200
HEAD-CL-BODY 400 or 2xx ⚠️200
OPTIONS-CL-BODY 400/405 or 2xx ⚠️200
CL-UNDERSCORE 400 or close ✅400
CL-NEGATIVE-ZERO 400 or close ✅400
CL-DOUBLE-ZERO 400 or 2xx ⚠️200
CL-LEADING-ZEROS-OCTAL 400 or 2xx ⚠️200
TE-OBS-FOLD 400 or 2xx+close ✅400
TE-TRAILING-COMMA 400 or 2xx ✅400
TE-TAB-BEFORE-VALUE 400 or 2xx ✅400
ABSOLUTE-URI-HOST-MISMATCH 400 or 2xx ⚠️200
MULTIPLE-HOST-COMMA 400 or close ✅400
CHUNK-BARE-CR-TERM 400 or close ✅400
TRAILER-CONTENT-TYPE 400 or 2xx ⚠️200
CLTE-CONN-CLOSE 400, or 2xx + close ✅400
TECL-CONN-CLOSE 400, or 2xx + close ✅400
CLTE-DESYNC 400, or close ✅400
CLTE-SMUGGLED-GET 400, or close (no extra response) ✅400
CLTE-SMUGGLED-GET-CL-PLUS 400, or close (no extra response) ✅400
CLTE-SMUGGLED-GET-CL-NON-NUMERIC 400, or close (no extra response) ✅400
CLTE-SMUGGLED-GET-TE-OBS-FOLD 400, or close (no extra response) ✅400
CLTE-SMUGGLED-HEAD 400, or close (no extra response) ✅400
CLTE-SMUGGLED-GET-TE-TRAILING-SPACE 400, or close (no extra response) ✅400
CLTE-SMUGGLED-GET-TE-LEADING-COMMA 400, or close (no extra response) ✅400
CLTE-SMUGGLED-GET-TE-CASE-MISMATCH 400, or close (no extra response) ✅400
TE-DUPLICATE-HEADERS-SMUGGLED-GET 400, or close (no extra response) ✅400
TECL-SMUGGLED-GET 400, or close (no extra response) ✅400
DUPLICATE-CL-SMUGGLED-GET 400, or close (no extra response) ✅400
GET-CL-PREFIX-DESYNC 400/close preferred; extra response on step 2 = warn ✅200
TECL-DESYNC 400, or close ✅400
CL0-BODY-POISON 400/close preferred; poisoned follow-up = warn ⚠️200
GET-CL-BODY-DESYNC 400/close/pass-through; poisoned follow-up = warn ✅200
OPTIONS-CL-BODY-DESYNC 400/close/pass-through; poisoned follow-up = warn ✅200
EXPECT-100-CL-DESYNC 417/400/close preferred; poisoned follow-up = warn ✅200
OPTIONS-TE-OBS-FOLD 400, or 2xx + close ✅400
CHUNK-INVALID-SIZE-DESYNC 400, or close ✅400
PIPELINE-SAFE 2xx + 2xx ✅200

Malformed Input

Test Expected Roadrunner
BINARY-GARBAGE 400/close/timeout ✅400
LONG-URL 400/414/431 or close ✅414
LONG-HEADER-VALUE 400/431 or close ✅431
MANY-HEADERS 400/431 or close ✅431
NUL-IN-URL 400 or close ✅400
CONTROL-CHARS-HEADER 400 or close ✅400
INCOMPLETE-REQUEST 400/close/timeout ✅TimedOut
EMPTY-REQUEST 400/close/timeout ✅TimedOut
LONG-HEADER-NAME 400/431 or close ✅431
LONG-METHOD 400 or close ❌501
NON-ASCII-HEADER-NAME 400 or close ✅400
NON-ASCII-URL 400 or close ✅400
CL-OVERFLOW 400 or close ❌413
WHITESPACE-ONLY-LINE 400/close/timeout ✅400
NUL-IN-HEADER-VALUE 400 or close ✅400
CHUNK-SIZE-OVERFLOW 400 or close ❌413
H2-PREFACE 400/505/close/timeout ✅400
CL-EMPTY 400 or close ✅400
CL-TAB-BEFORE-VALUE 400 or 2xx ⚠️200
URL-BACKSLASH 400 or 2xx/404 ✅400
URL-OVERLONG-UTF8 400 or close ✅400
URL-PERCENT-NULL 400 or 2xx/404 ⚠️200
URL-PERCENT-CRLF 400 or 2xx/404 ⚠️200
CHUNK-EXT-64K 400 or 2xx ✅400
RANGE-OVERLAPPING 200/206/400/416 ⚠️200
POST-CL-HUGE-NO-BODY 400/413/close/timeout ✅413

Header Normalization

Test Expected Roadrunner
UNDERSCORE-CL Reject/drop (pass), normalize (fail), preserve (warn) ⚠️200
SP-BEFORE-COLON-CL Reject/drop (pass), normalize (fail), preserve (warn) ✅400
TAB-IN-NAME Reject/drop (pass), normalize (fail), preserve (warn) ✅400
CASE-TE Reject/drop (pass), normalize casing (fail), preserve (warn) ✅400
UNDERSCORE-TE Reject/drop (pass), normalize (fail), preserve (warn) ⚠️200

Commit: 3e075b9

@williamthome
williamthome marked this pull request as draft October 15, 2026 13:17
@williamthome

Copy link
Copy Markdown
Author

Moving this to draft for now: a roadrunner patch release with a few more fixes is coming soon, and I'll update this PR to it once it's out.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant