ferrings 0.2.0 → 0.2.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (9) hide show
  1. package/README.md +102 -115
  2. package/benchmark/compare.js +7 -3
  3. package/benchmark/first-slice.js +17 -2
  4. package/benchmark/high-concurrency.js +8 -2
  5. package/benchmark/syscalls.js +48 -28
  6. package/benchmark/tcp-echo.js +177 -69
  7. package/ferrings.linux-x64-gnu.node +0 -0
  8. package/native.js +52 -52
  9. package/package.json +7 -7
package/README.md CHANGED
@@ -3,80 +3,40 @@
3
3
  [![CI](https://github.com/avifenesh/ferrings/actions/workflows/ci.yml/badge.svg)](https://github.com/avifenesh/ferrings/actions/workflows/ci.yml)
4
4
  [![Release](https://github.com/avifenesh/ferrings/actions/workflows/release.yml/badge.svg)](https://github.com/avifenesh/ferrings/actions/workflows/release.yml)
5
5
  [![npm](https://img.shields.io/npm/v/ferrings)](https://www.npmjs.com/package/ferrings)
6
- ![Node.js >=20](https://img.shields.io/badge/node-%3E%3D20-339933)
6
+ ![Node.js >=22](https://img.shields.io/badge/node-%3E%3D22-339933)
7
7
  ![License](https://img.shields.io/badge/license-MIT%20OR%20Apache--2.0-blue)
8
8
 
9
- Linux `io_uring` TCP transport for Node.js, built with Rust and napi-rs for high-concurrency server outside libuv's networking loop.
9
+ Linux `io_uring` TCP transport for Node.js services, built with Rust and napi-rs.
10
10
 
11
- ferrings exposes Node-friendly TCP and fixed-response HTTP APIs backed by a native `io_uring` worker: multishot accept/recv, provided buffer rings, recv-bundle, zero-copy send, and an optional ZCRX path for capable NICs. It is published on npm as a root package plus target-specific optional native packages, so users install `ferrings` and npm resolves the matching Linux binding for their machine.
11
+ ferrings gives Node applications a native Linux TCP path outside libuv's networking loop: multishot accept/recv, provided buffer rings, recv-bundle, zero-copy send, registered-buffer send probes, and an optional ZCRX fast path for capable NICs. It installs as one npm package; npm resolves the matching native binding for your Linux target.
12
12
 
13
13
  ```bash
14
14
  npm install ferrings
15
15
  ```
16
16
 
17
- ```js
18
- const net = require('node:net');
19
- const { createTcpServer } = require('ferrings');
20
-
21
- const server = createTcpServer((connection) => {
22
- connection.on('data', (data) => connection.end(`ferrings:${data}`));
23
- });
24
-
25
- server.listen(0, '127.0.0.1', (info) => {
26
- const client = net.createConnection(info.port, info.host, () => client.write('ping'));
27
- client.on('data', (data) => {
28
- console.log(data.toString());
29
- server.close();
30
- });
31
- });
32
- ```
33
-
34
- Save the example as `quickstart.js` and run it with `node quickstart.js`; it prints `ferrings:ping`.
17
+ ## Benchmark Snapshot
35
18
 
36
- ## Quick proof signals
19
+ Measured on 2026-06-28 on an Intel Core Ultra 9 275HX laptop, Linux `7.0.0-22-generic`, Node `v25.9.0`, npm `11.12.1`, Rust `1.96.0`, with the default 8 MiB locked-memory limit. This is loopback under `strace -f -c`, not a NIC or ZCRX benchmark, so use the ratios more than the absolute numbers.
37
20
 
38
- - Published on npm as [`ferrings`](https://www.npmjs.com/package/ferrings) for Node.js `>=20` on Linux.
39
- - CI builds and tests Node 20, 22, and 24 on Linux.
40
- - Uses the napi-rs root-package + optional-native-package pattern: one JS API package for users, matrix-built native packages underneath.
41
- - `npm run check:release-ready -- --full --strict` verifies the local release gates; ZCRX hardware proof is optional unless `--require-zcrx` is set.
42
- - Package install smoke tests pack the tarball, install it in a temporary app, start a TCP server through `require('ferrings')`, and run the installed CLI.
21
+ | Case | req/s | p99 ms | server syscalls/conn | Fast path |
22
+ | --- | ---: | ---: | ---: | --- |
23
+ | Node `http` | 2,689 | 75.987 | 11.620 | libuv/epoll |
24
+ | ferrings HTTP | 5,547 | 33.123 | 5.645 | multishot accept/recv + provided buffer ring |
25
+ | Node `net` TCP echo | 4,086 | 26.649 | 10.987 | libuv/epoll |
26
+ | ferrings native TCP echo | 8,128 | 20.422 | 5.842 | native echo worker + provided buffer ring |
27
+ | ferrings TCP facade batch send | 8,451 | 28.451 | 7.143 | JS facade + batched native events/sends |
43
28
 
44
- ## Why this project
45
-
46
- - Use this when you want to compare Node's `net` / `http` servers with a modern Linux `io_uring` TCP path.
47
- - Use this when you need a Node API over a Rust-native networking worker for high-concurrency Linux experiments.
48
- - Use this when you want runtime visibility into kernel features such as multishot recv, provided buffer rings, recv-bundle, zero-copy send, and ZCRX readiness.
49
- - Use this when you want to benchmark syscall counts, tail latency, and queue behavior without building a native addon from scratch.
50
- - Use this when you are exploring ZCRX, but want the broadly usable core to work on machines without ZCRX-capable NIC hardware.
51
-
52
- ## Installation
53
-
54
- Install the published package:
55
-
56
- ```bash
57
- npm install ferrings
58
- ```
59
-
60
- The base package is Linux-only. It depends on target-specific optional native packages, but a normal install picks the one package that matches the current machine. The release build still produces all supported targets through CI matrix jobs. For source development:
61
-
62
- ```bash
63
- git clone https://github.com/avifenesh/ferrings.git
64
- cd ferrings
65
- npm install
66
- npm test
67
- ```
29
+ In this snapshot, ferrings roughly halves server syscalls per completed connection and about doubles throughput versus stock Node `http` / `net` servers on the same machine. The Node-style TCP facade still crosses into JavaScript, but batching keeps it ahead of the baseline in this workload.
68
30
 
69
- ## Quick start
31
+ ## Quick Start
70
32
 
71
- After `npm install ferrings`, create `quickstart.js`:
33
+ Create `quickstart.js`:
72
34
 
73
35
  ```js
74
36
  'use strict';
75
37
 
76
38
  const net = require('node:net');
77
- const { createTcpServer, capabilities } = require('ferrings');
78
-
79
- console.log(capabilities());
39
+ const { createTcpServer } = require('ferrings');
80
40
 
81
41
  const server = createTcpServer((connection) => {
82
42
  connection.on('data', (data) => {
@@ -93,8 +53,6 @@ server.listen(
93
53
  useZeroCopySend: true
94
54
  },
95
55
  (info) => {
96
- console.log(`listening on tcp://${info.host}:${info.port}`);
97
-
98
56
  const client = net.createConnection({ host: info.host, port: info.port }, () => {
99
57
  client.write('hello');
100
58
  });
@@ -117,43 +75,40 @@ Run it:
117
75
  node quickstart.js
118
76
  ```
119
77
 
120
- What happened:
78
+ It prints `echo:hello`. `createTcpServer()` exposes a familiar Node-style TCP server while the accept, receive, send, and shutdown work run on a Rust `io_uring` worker.
79
+
80
+ ## Quick Proof Signals
121
81
 
122
- - `createTcpServer()` created a Node-style TCP server backed by a native `io_uring` worker.
123
- - `capabilities()` printed the active kernel probes for this host.
124
- - `useRecvBundle` and `useZeroCopySend` were requested, but remain capability-gated by the native addon.
125
- - The client received `echo:hello` and the server shut down.
82
+ - Published on npm as [`ferrings`](https://www.npmjs.com/package/ferrings) for Linux Node.js `>=22`.
83
+ - CI builds and tests Node 22, 24, and 26 on Linux.
84
+ - Release CI builds four native packages: `linux-x64-gnu`, `linux-x64-musl`, `linux-arm64-gnu`, and `linux-arm64-musl`.
85
+ - Package install smoke tests install the packed tarball in a temporary app, start a TCP server through `require('ferrings')`, and run the installed CLI.
86
+ - `npm run check:release-ready -- --full --strict` verifies package metadata, npm version availability, install smoke tests, dry-run publish checks, GitHub repository metadata, and the `NPM_TOKEN` secret.
126
87
 
127
- ## Core concepts
88
+ ## When To Use It
128
89
 
129
- ferrings is not a wrapper around Node's libuv TCP implementation. It creates the listening socket directly with `socket`, `bind`, and `listen`, then drives accepts, receives, sends, and shutdown from a Rust worker thread with `io_uring`.
90
+ - Use ferrings when you want a real Node TCP server API backed by Linux `io_uring` instead of libuv's epoll networking path.
91
+ - Use ferrings when syscall count, tail latency, and connection concurrency matter enough to justify a Linux-only native dependency.
92
+ - Use ferrings when you want runtime visibility into multishot recv, provided buffer rings, recv-bundle, zero-copy send, registered-buffer send, and ZCRX readiness.
93
+ - Use ferrings when you need a Rust-native networking worker but still want application code, callbacks, and deployment to stay in Node.js.
94
+ - Use ferrings when you are preparing for ZCRX-capable NICs but need the broadly useful multishot/provided-buffer core to work on ordinary recent kernels.
130
95
 
131
- JavaScript stays in control of the application API:
96
+ ## Mental Model
132
97
 
133
- - Native to JS events are delivered through NAPI thread-safe callbacks.
134
- - JS to native writes go through a bounded command queue and an `eventfd` wakeup.
135
- - Server counters are exposed through `info()` and the initial `ServerInfo` returned by `start()` / `listen()`.
136
- - Kernel-specific features are probed at runtime instead of assumed.
98
+ ferrings is not a wrapper around Node's `net.Server`. It creates the listening socket directly with `socket`, `bind`, and `listen`, then drives accepts, receives, sends, and shutdown from a Rust worker thread with `io_uring`.
137
99
 
138
- The broad core path is multishot accept + multishot recv + provided buffers. ZCRX is intentionally separate: it requires kernel support, NIC header/data split, flow steering/RSS isolation, permissions, and a capable RX queue.
100
+ JavaScript still owns the application surface:
139
101
 
140
- ## Features
102
+ - Native-to-JS events are delivered through NAPI thread-safe callbacks.
103
+ - JS-to-native writes go through a bounded command queue and an `eventfd` wakeup.
104
+ - The Node-style facade exposes `connection`, `data`, `close`, `write()`, `end()`, `destroy()`, `address()`, and `getConnections()`.
105
+ - Lower-level APIs expose connection IDs, batched events, batched sends, server counters, and active capability probes.
141
106
 
142
- - Node-style TCP server facade with `connection`, `data`, `close`, `write()`, `end()`, `destroy()`, `address()`, and `getConnections()`.
143
- - Raw `UringTcpServer` for lower-level event handling, batched event delivery, and batched sends.
144
- - `UringTcpEchoServer` for native TCP echo benchmarks without per-connection JS callbacks.
145
- - `UringHttpServer` for fixed-response HTTP benchmarks on the cleanest `io_uring` path.
146
- - Multishot accept and recv for fewer per-operation submissions on supported kernels.
147
- - Provided buffer rings first, with `IORING_OP_PROVIDE_BUFFERS` fallback when registration is rejected.
148
- - Optional recv-bundle mode using `IORING_FEAT_RECVSEND_BUNDLE` when the kernel advertises it.
149
- - Optional zero-copy send using `IORING_OP_SEND_ZC`, with counters for requests, notifications, copied fallback, and errors.
150
- - Optional registered-buffer send path, guarded by an active startup probe.
151
- - Optional ZCRX path with `zcrxProbe()`, CLI diagnostics, active IFQ registration probe, and hardware smoke tests.
152
- - Bounded command, event, and per-connection send queues so overload is reported instead of growing memory without bound.
107
+ The core receive path is multishot accept + multishot recv + provided buffers. ZCRX is separate and explicitly gated because it requires kernel support, NIC header/data split, RX queue setup, flow steering or RSS isolation, and permissions.
153
108
 
154
- ## API and usage patterns
109
+ ## APIs
155
110
 
156
- ### Node-style TCP
111
+ ### Node-Style TCP
157
112
 
158
113
  ```js
159
114
  const { createTcpServer } = require('ferrings');
@@ -167,9 +122,9 @@ server.listen(0, '127.0.0.1', (info) => {
167
122
  });
168
123
  ```
169
124
 
170
- Use this path when you want a familiar Node server shape over the native transport.
125
+ Use this when you want a familiar server shape over the native transport.
171
126
 
172
- ### Raw TCP events
127
+ ### Raw TCP Events
173
128
 
174
129
  ```js
175
130
  const { UringTcpServer } = require('ferrings');
@@ -190,9 +145,9 @@ const info = server.start((event) => {
190
145
  console.log(`tcp://${info.host}:${info.port}`);
191
146
  ```
192
147
 
193
- Use this path when you want direct event objects and explicit connection IDs.
148
+ Use this when you want direct event objects and explicit connection IDs.
194
149
 
195
- ### Batched TCP events and sends
150
+ ### Batched TCP Events And Sends
196
151
 
197
152
  ```js
198
153
  const { UringTcpServer } = require('ferrings');
@@ -214,9 +169,9 @@ const info = server.startBatch((events) => {
214
169
  console.log(`tcp://${info.host}:${info.port}`);
215
170
  ```
216
171
 
217
- Use this path when JS callback overhead matters and events can be processed in batches.
172
+ Use this when JS callback overhead matters and events can be processed in batches.
218
173
 
219
- ### Fixed-response HTTP
174
+ ### Fixed-Response HTTP
220
175
 
221
176
  ```js
222
177
  const { UringHttpServer } = require('ferrings');
@@ -232,9 +187,9 @@ const info = server.start();
232
187
  console.log(`http://${info.host}:${info.port}`);
233
188
  ```
234
189
 
235
- `UringHttpServer` is a benchmark server, not a general HTTP framework.
190
+ `UringHttpServer` is useful for fixed-response servers and transport benchmarking. It is not a general HTTP framework.
236
191
 
237
- ### Native echo benchmark server
192
+ ### Native TCP Echo
238
193
 
239
194
  ```js
240
195
  const { UringTcpEchoServer } = require('ferrings');
@@ -249,9 +204,9 @@ const info = server.start();
249
204
  console.log(`tcp://${info.host}:${info.port}`);
250
205
  ```
251
206
 
252
- Use this to isolate the native TCP echo path from JavaScript event delivery.
207
+ Use this to isolate the native TCP path from JavaScript event delivery.
253
208
 
254
- ### Capability and ZCRX probes
209
+ ### Capability And ZCRX Probes
255
210
 
256
211
  ```js
257
212
  const { capabilities, zcrxProbe } = require('ferrings');
@@ -282,8 +237,8 @@ Common server options:
282
237
  | `host` | `127.0.0.1` | all servers | Bind address. |
283
238
  | `port` | `0` | all servers | Bind port; `0` asks the kernel for a free port. |
284
239
  | `backlog` | `1024` | all servers | Passed to `listen(2)`, subject to host `somaxconn`. |
285
- | `queueDepth` | `1024` | all servers | `io_uring` queue depth. |
286
- | `bufferCount` | `4096` | all servers | Receive buffer slots. |
240
+ | `queueDepth` | `64` | all servers | `io_uring` queue depth. |
241
+ | `bufferCount` | `512` | all servers | Receive buffer slots. |
287
242
  | `bufferSize` | `2048` | all servers | Size of each receive buffer. |
288
243
  | `maxConnections` | `0` | all servers | `0` means unlimited tracked active connections. |
289
244
  | `idleTimeoutMs` | `0` | all servers | `0` disables native idle eviction. |
@@ -310,9 +265,29 @@ TCP-only queue options:
310
265
 
311
266
  All servers expose live counters through `ServerInfo`, including accepted/closed/rejected connections, bytes sent/received, queue drops, receive buffer starvations, recv-bundle counters, zero-copy send counters, fixed-send misses, and ZCRX packet counters.
312
267
 
313
- ## Performance and benchmarks
268
+ ## Full Benchmark Details
269
+
270
+ Run the README snapshot:
271
+
272
+ ```bash
273
+ REQUESTS=1000 CONCURRENCY=64 QUEUE_DEPTH=64 BUFFER_COUNT=512 BUFFER_SIZE=2048 \
274
+ CASES=node-http,ferrings-http,node-tcp,ferrings-native-tcp,ferrings-tcp-facade,ferrings-tcp-facade-batch \
275
+ REPORT_PATH=artifacts/benchmark-readme-2026-06-28.json \
276
+ npm run bench:syscalls
277
+ ```
278
+
279
+ Full result table:
280
+
281
+ | Case | req/s | p50 ms | p95 ms | p99 ms | server syscalls/conn | Fast path |
282
+ | --- | ---: | ---: | ---: | ---: | ---: | --- |
283
+ | Node `http` | 2,689 | 19.536 | 63.368 | 75.987 | 11.620 | libuv/epoll |
284
+ | ferrings HTTP | 5,547 | 10.480 | 28.965 | 33.123 | 5.645 | multishot accept/recv + provided buffer ring |
285
+ | Node `net` TCP echo | 4,086 | 14.881 | 19.244 | 26.649 | 10.987 | libuv/epoll |
286
+ | ferrings native TCP echo | 8,128 | 6.353 | 16.562 | 20.422 | 5.842 | native echo worker + provided buffer ring |
287
+ | ferrings TCP facade | 7,001 | 7.199 | 30.371 | 33.890 | 8.149 | JS facade + batched native events |
288
+ | ferrings TCP facade batch send | 8,451 | 6.188 | 24.787 | 28.451 | 7.143 | JS facade + batched native events/sends |
314
289
 
315
- The repository includes benchmark drivers, but the README does not publish benchmark numbers because results depend on kernel, CPU, NIC, limits, and benchmark shape.
290
+ Other benchmark commands:
316
291
 
317
292
  ```bash
318
293
  npm run bench
@@ -328,9 +303,9 @@ Benchmark scripts:
328
303
  - `benchmark/tcp-echo.js` compares Node TCP, the ferrings TCP facade, raw TCP, native echo, recv-bundle, and zero-copy-send variants when available.
329
304
  - `benchmark/high-concurrency.js` runs HTTP and TCP cases with higher concurrency defaults.
330
305
  - `benchmark/syscalls.js` uses `strace -f -c` when installed to report server-side syscalls per completed connection.
331
- - `benchmark/first-slice.js` writes one compact validation report for the first useful slice across capabilities, HTTP, TCP, and syscall cases.
306
+ - `benchmark/first-slice.js` writes one compact validation report across capabilities, HTTP, TCP, and syscall cases.
332
307
 
333
- Set `REPORT_PATH=artifacts/<name>.json` to keep machine-readable reports.
308
+ Set `REPORT_PATH=artifacts/<name>.json` to keep machine-readable reports. Useful knobs include `DURATION_MS`, `REQUESTS`, `CONCURRENCY`, `QUEUE_DEPTH`, `BUFFER_COUNT`, `BUFFER_SIZE`, `CASES`, and `SYSCALL_CASES`. If you raise `BUFFER_COUNT`, `QUEUE_DEPTH`, or fixed send-buffer counts, raise `ulimit -l` / `RLIMIT_MEMLOCK` too.
334
309
 
335
310
  ## ZCRX
336
311
 
@@ -345,18 +320,30 @@ ZCRX_INTERFACE=eth0 ZCRX_CONNECT_HOST=<nic-routed-host> npm run test:zcrx
345
320
 
346
321
  For a real NIC receive proof, avoid `127.0.0.1`; route packets through the selected NIC queue, usually from a second host or a network namespace.
347
322
 
348
- ## Release and package layout
323
+ ## Installation And Supported Targets
324
+
325
+ The base package is Linux-only and depends on target-specific optional native packages. A normal install picks the one package that matches the current machine.
326
+
327
+ Published packages:
328
+
329
+ - `ferrings`
330
+ - `ferrings-linux-x64-gnu`
331
+ - `ferrings-linux-x64-musl`
332
+ - `ferrings-linux-arm64-gnu`
333
+ - `ferrings-linux-arm64-musl`
334
+
335
+ Source development:
349
336
 
350
- The release flow follows napi-rs native package conventions, the same shape used by projects such as Glide: CI builds every supported target in a matrix, publishes one small native package per target, and keeps `ferrings` as the single package users install.
337
+ ```bash
338
+ git clone https://github.com/avifenesh/ferrings.git
339
+ cd ferrings
340
+ npm install
341
+ npm test
342
+ ```
351
343
 
352
- - Root package: `ferrings`
353
- - Published native packages:
354
- - `ferrings-linux-x64-gnu`
355
- - `ferrings-linux-x64-musl`
356
- - `ferrings-linux-arm64-gnu`
357
- - `ferrings-linux-arm64-musl`
344
+ ## Release Checks
358
345
 
359
- Useful release checks:
346
+ Useful checks before cutting a release:
360
347
 
361
348
  ```bash
362
349
  npm run check:native-packages
@@ -368,19 +355,19 @@ npm run check:release-ready -- --full --require-zcrx
368
355
 
369
356
  Tag pushes that match the package version build all native artifacts, run package checks, and publish to npm with the repository `NPM_TOKEN` secret. Manual `workflow_dispatch` runs can also publish when `publish=true`. For a new release, bump the package version first; npm versions are immutable after publication.
370
357
 
371
- ## Limitations and tradeoffs
358
+ ## Limitations And Tradeoffs
372
359
 
373
360
  - Linux only; there is no macOS or Windows transport.
374
- - Node.js `>=20` is required.
361
+ - Node.js `>=22` is required.
375
362
  - This is a native addon, so kernel support and process limits affect which fast paths are active.
376
- - The TCP facade is intentionally similar to Node's server shape, but it is not a drop-in replacement for every `net.Server` behavior.
377
- - `UringHttpServer` is a fixed-response benchmark server, not an HTTP application framework.
363
+ - The TCP facade intentionally follows the common Node server shape, but it is not a drop-in replacement for every `net.Server` behavior.
364
+ - `UringHttpServer` is a fixed-response server, not an HTTP application framework.
378
365
  - TLS is not implemented.
379
366
  - ZCRX requires specific NIC hardware, kernel support, queue setup, permissions, and routed traffic through the selected RX queue.
380
367
  - Registered-buffer send can be unavailable even when the kernel supports other modern `io_uring` networking features; ferrings reports that through `capabilities().registeredSendBuffer`.
381
368
  - APIs are still early and may change between 0.x releases.
382
369
 
383
- ## Docs, examples, and project health
370
+ ## Project Health
384
371
 
385
372
  - Examples: [`examples/http-fixed.js`](examples/http-fixed.js), [`examples/tcp-echo.js`](examples/tcp-echo.js)
386
373
  - Benchmarks: [`benchmark/`](benchmark/)
package/benchmark/compare.js CHANGED
@@ -10,6 +10,8 @@ const BODY = 'ok\n';
10
10
  const DURATION_MS = Number(process.env.DURATION_MS || 5000);
11
11
  const CONCURRENCY = Number(process.env.CONCURRENCY || 128);
12
12
  const QUEUE_DEPTH = Number(process.env.QUEUE_DEPTH || 256);
13
+ const BUFFER_COUNT = Number(process.env.BUFFER_COUNT || 512);
14
+ const BUFFER_SIZE = Number(process.env.BUFFER_SIZE || 2048);
13
15
  const REPORT_PATH = process.env.REPORT_PATH;
14
16
 
15
17
  function requestOnce(port) {
@@ -76,8 +78,8 @@ async function withUringServer() {
76
78
  port: 0,
77
79
  queueDepth: QUEUE_DEPTH,
78
80
  responseBody: BODY,
79
- bufferCount: 4096,
80
- bufferSize: 2048
81
+ bufferCount: BUFFER_COUNT,
82
+ bufferSize: BUFFER_SIZE
81
83
  });
82
84
 
83
85
  const info = server.start();
@@ -131,7 +133,9 @@ function baseReport() {
131
133
  config: {
132
134
  durationMs: DURATION_MS,
133
135
  concurrency: CONCURRENCY,
134
- queueDepth: QUEUE_DEPTH
136
+ queueDepth: QUEUE_DEPTH,
137
+ bufferCount: BUFFER_COUNT,
138
+ bufferSize: BUFFER_SIZE
135
139
  },
136
140
  results: [],
137
141
  error: null
package/benchmark/first-slice.js CHANGED
@@ -9,6 +9,9 @@ const { capabilities } = require('../');
9
9
  const DURATION_MS = String(process.env.DURATION_MS || 1000);
10
10
  const CONCURRENCY = String(process.env.CONCURRENCY || 128);
11
11
  const QUEUE_DEPTH = String(process.env.QUEUE_DEPTH || 256);
12
+ const BUFFER_COUNT = String(process.env.BUFFER_COUNT || 512);
13
+ const BUFFER_SIZE = String(process.env.BUFFER_SIZE || 2048);
14
+ const TCP_CASES = process.env.TCP_CASES || '';
12
15
  const SYSCALL_REQUESTS = String(process.env.SYSCALL_REQUESTS || 200);
13
16
  const SYSCALL_CONCURRENCY = String(process.env.SYSCALL_CONCURRENCY || 32);
14
17
  const SYSCALL_CASES =
@@ -25,6 +28,11 @@ const report = {
25
28
  durationMs: Number(DURATION_MS),
26
29
  concurrency: Number(CONCURRENCY),
27
30
  queueDepth: Number(QUEUE_DEPTH),
31
+ bufferCount: Number(BUFFER_COUNT),
32
+ bufferSize: Number(BUFFER_SIZE),
33
+ tcpCases: TCP_CASES
34
+ ? TCP_CASES.split(',').map((name) => name.trim()).filter(Boolean)
35
+ : null,
28
36
  syscallRequests: Number(SYSCALL_REQUESTS),
29
37
  syscallConcurrency: Number(SYSCALL_CONCURRENCY),
30
38
  syscallCases: SYSCALL_CASES.split(',').map((name) => name.trim()).filter(Boolean)
@@ -41,14 +49,19 @@ try {
41
49
  runBenchmark('HTTP fixed response latency', 'compare.js', {
42
50
  DURATION_MS,
43
51
  CONCURRENCY,
44
- QUEUE_DEPTH
52
+ QUEUE_DEPTH,
53
+ BUFFER_COUNT,
54
+ BUFFER_SIZE
45
55
  })
46
56
  );
47
57
  report.results.push(
48
58
  runBenchmark('TCP echo latency matrix', 'tcp-echo.js', {
49
59
  DURATION_MS,
50
60
  CONCURRENCY,
51
- QUEUE_DEPTH
61
+ QUEUE_DEPTH,
62
+ BUFFER_COUNT,
63
+ BUFFER_SIZE,
64
+ ...(TCP_CASES ? { CASES: TCP_CASES } : {})
52
65
  })
53
66
  );
54
67
  report.results.push(runSyscallBenchmark());
@@ -81,6 +94,8 @@ function runSyscallBenchmark() {
81
94
  REQUESTS: SYSCALL_REQUESTS,
82
95
  CONCURRENCY: SYSCALL_CONCURRENCY,
83
96
  QUEUE_DEPTH,
97
+ BUFFER_COUNT,
98
+ BUFFER_SIZE,
84
99
  CASES: SYSCALL_CASES
85
100
  });
86
101
  }
package/benchmark/high-concurrency.js CHANGED
@@ -8,13 +8,17 @@ const path = require('node:path');
8
8
  const DEFAULT_DURATION_MS = '10000';
9
9
  const DEFAULT_CONCURRENCY = '512';
10
10
  const DEFAULT_QUEUE_DEPTH = '1024';
11
+ const DEFAULT_BUFFER_COUNT = '512';
12
+ const DEFAULT_BUFFER_SIZE = '2048';
11
13
  const REPORT_PATH = process.env.REPORT_PATH;
12
14
 
13
15
  const env = {
14
16
  ...process.env,
15
17
  DURATION_MS: process.env.DURATION_MS || DEFAULT_DURATION_MS,
16
18
  CONCURRENCY: process.env.CONCURRENCY || DEFAULT_CONCURRENCY,
17
- QUEUE_DEPTH: process.env.QUEUE_DEPTH || DEFAULT_QUEUE_DEPTH
19
+ QUEUE_DEPTH: process.env.QUEUE_DEPTH || DEFAULT_QUEUE_DEPTH,
20
+ BUFFER_COUNT: process.env.BUFFER_COUNT || DEFAULT_BUFFER_COUNT,
21
+ BUFFER_SIZE: process.env.BUFFER_SIZE || DEFAULT_BUFFER_SIZE
18
22
  };
19
23
 
20
24
  const report = {
@@ -25,7 +29,9 @@ const report = {
25
29
  config: {
26
30
  durationMs: Number(env.DURATION_MS),
27
31
  concurrency: Number(env.CONCURRENCY),
28
- queueDepth: Number(env.QUEUE_DEPTH)
32
+ queueDepth: Number(env.QUEUE_DEPTH),
33
+ bufferCount: Number(env.BUFFER_COUNT),
34
+ bufferSize: Number(env.BUFFER_SIZE)
29
35
  },
30
36
  results: [],
31
37
  error: null
package/benchmark/syscalls.js CHANGED
@@ -22,10 +22,12 @@ const TCP_RESPONSE = Buffer.from('pong');
22
22
  const REQUESTS = Number(process.env.REQUESTS || 1000);
23
23
  const CONCURRENCY = Number(process.env.CONCURRENCY || 32);
24
24
  const QUEUE_DEPTH = Number(process.env.QUEUE_DEPTH || 256);
25
+ const BUFFER_COUNT = Number(process.env.BUFFER_COUNT || 512);
26
+ const BUFFER_SIZE = Number(process.env.BUFFER_SIZE || 2048);
25
27
  const BUNDLE_REQUEST_SIZE = Number(process.env.BUNDLE_REQUEST_SIZE || 4096);
26
28
  const BUNDLE_REQUEST = payload(BUNDLE_REQUEST_SIZE);
27
- const CAPS = capabilities();
28
- const DEFAULT_CASES = [
29
+ let capsCache = null;
30
+ const BASE_DEFAULT_CASES = [
29
31
  'node-http',
30
32
  'ferrings-http',
31
33
  'node-tcp',
@@ -34,22 +36,10 @@ const DEFAULT_CASES = [
34
36
  'ferrings-tcp-facade-batch',
35
37
  'ferrings-native-tcp'
36
38
  ];
37
- if (CAPS.sendZc) {
38
- DEFAULT_CASES.push(
39
- 'ferrings-http-zc',
40
- 'ferrings-tcp-zc',
41
- 'ferrings-tcp-facade-zc',
42
- 'ferrings-tcp-facade-batch-zc',
43
- 'ferrings-native-tcp-zc'
44
- );
45
- }
46
- if (CAPS.recvBundle) {
47
- DEFAULT_CASES.push('ferrings-native-tcp-recv-bundle');
48
- if (CAPS.sendZc) {
49
- DEFAULT_CASES.push('ferrings-native-tcp-zc-recv-bundle');
50
- }
51
- }
52
- const CASES = (process.env.CASES || DEFAULT_CASES.join(','))
39
+ const CASE_SOURCE =
40
+ process.env.CASES ||
41
+ (process.argv[2] === '--serve' ? process.argv[3] : defaultCases().join(','));
42
+ const CASES = CASE_SOURCE
53
43
  .split(',')
54
44
  .map((name) => name.trim())
55
45
  .filter(Boolean);
@@ -102,10 +92,12 @@ function baseReport() {
102
92
  requests: REQUESTS,
103
93
  concurrency: CONCURRENCY,
104
94
  queueDepth: QUEUE_DEPTH,
95
+ bufferCount: BUFFER_COUNT,
96
+ bufferSize: BUFFER_SIZE,
105
97
  bundleRequestSize: BUNDLE_REQUEST_SIZE,
106
98
  cases: CASES
107
99
  },
108
- capabilities: CAPS,
100
+ capabilities: caps(),
109
101
  results: [],
110
102
  error: null
111
103
  };
@@ -126,6 +118,34 @@ function errorForReport(error) {
126
118
  };
127
119
  }
128
120
 
121
+ function caps() {
122
+ if (!capsCache) {
123
+ capsCache = capabilities();
124
+ }
125
+ return capsCache;
126
+ }
127
+
128
+ function defaultCases() {
129
+ const defaults = [...BASE_DEFAULT_CASES];
130
+ const currentCaps = caps();
131
+ if (currentCaps.sendZc) {
132
+ defaults.push(
133
+ 'ferrings-http-zc',
134
+ 'ferrings-tcp-zc',
135
+ 'ferrings-tcp-facade-zc',
136
+ 'ferrings-tcp-facade-batch-zc',
137
+ 'ferrings-native-tcp-zc'
138
+ );
139
+ }
140
+ if (currentCaps.recvBundle) {
141
+ defaults.push('ferrings-native-tcp-recv-bundle');
142
+ if (currentCaps.sendZc) {
143
+ defaults.push('ferrings-native-tcp-zc-recv-bundle');
144
+ }
145
+ }
146
+ return defaults;
147
+ }
148
+
129
149
  async function traceServerCase(caseName) {
130
150
  const summaryPath = path.join(
131
151
  os.tmpdir(),
@@ -228,8 +248,8 @@ async function startServer(caseName) {
228
248
  port: 0,
229
249
  queueDepth: QUEUE_DEPTH,
230
250
  responseBody: BODY,
231
- bufferCount: 4096,
232
- bufferSize: 2048,
251
+ bufferCount: BUFFER_COUNT,
252
+ bufferSize: BUFFER_SIZE,
233
253
  useZeroCopySend: caseName === 'ferrings-http-zc'
234
254
  });
235
255
  const info = server.start();
@@ -260,8 +280,8 @@ async function startServer(caseName) {
260
280
  host: '127.0.0.1',
261
281
  port: 0,
262
282
  queueDepth: QUEUE_DEPTH,
263
- bufferCount: 4096,
264
- bufferSize: 2048,
283
+ bufferCount: BUFFER_COUNT,
284
+ bufferSize: BUFFER_SIZE,
265
285
  useZeroCopySend: caseName === 'ferrings-tcp-zc',
266
286
  sendBufferCount: 512,
267
287
  sendBufferSize: 2048
@@ -287,8 +307,8 @@ async function startServer(caseName) {
287
307
  host: '127.0.0.1',
288
308
  port: 0,
289
309
  queueDepth: QUEUE_DEPTH,
290
- bufferCount: 4096,
291
- bufferSize: 2048,
310
+ bufferCount: BUFFER_COUNT,
311
+ bufferSize: BUFFER_SIZE,
292
312
  useZeroCopySend,
293
313
  sendBufferCount: 512,
294
314
  sendBufferSize: 2048
@@ -320,7 +340,7 @@ async function startServer(caseName) {
320
340
  const useZeroCopySend =
321
341
  caseName === 'ferrings-native-tcp-zc' ||
322
342
  caseName === 'ferrings-native-tcp-zc-recv-bundle';
323
- if (useRecvBundle && !CAPS.recvBundle) {
343
+ if (useRecvBundle && !caps().recvBundle) {
324
344
  throw new Error(
325
345
  `${caseName} requires IORING_FEAT_RECVSEND_BUNDLE but capabilities().recvBundle is false`
326
346
  );
@@ -329,8 +349,8 @@ async function startServer(caseName) {
329
349
  host: '127.0.0.1',
330
350
  port: 0,
331
351
  queueDepth: QUEUE_DEPTH,
332
- bufferCount: 4096,
333
- bufferSize: useRecvBundle ? 512 : 2048,
352
+ bufferCount: BUFFER_COUNT,
353
+ bufferSize: useRecvBundle ? 512 : BUFFER_SIZE,
334
354
  useRecvBundle,
335
355
  useZeroCopySend,
336
356
  sendBufferCount: 512,
package/benchmark/tcp-echo.js CHANGED
@@ -2,7 +2,9 @@
2
2
 
3
3
  const fs = require('node:fs');
4
4
  const net = require('node:net');
5
+ const os = require('node:os');
5
6
  const path = require('node:path');
7
+ const { spawnSync } = require('node:child_process');
6
8
  const { performance } = require('node:perf_hooks');
7
9
  const {
8
10
  UringTcpEchoServer,
@@ -16,11 +18,57 @@ const RESPONSE = Buffer.from('pong');
16
18
  const DURATION_MS = Number(process.env.DURATION_MS || 5000);
17
19
  const CONCURRENCY = Number(process.env.CONCURRENCY || 128);
18
20
  const QUEUE_DEPTH = Number(process.env.QUEUE_DEPTH || 256);
21
+ const BUFFER_COUNT = Number(process.env.BUFFER_COUNT || 512);
22
+ const BUFFER_SIZE = Number(process.env.BUFFER_SIZE || 2048);
19
23
  const BUNDLE_REQUEST_SIZE = Number(process.env.BUNDLE_REQUEST_SIZE || 4096);
20
24
  const BUNDLE_REQUEST = payload(BUNDLE_REQUEST_SIZE);
21
- const CAPS = capabilities();
25
+ let capsCache = null;
26
+ const DEFAULT_CASES = [
27
+ 'node:net echo',
28
+ 'ferrings native tcp echo',
29
+ 'ferrings native tcp echo recv-bundle',
30
+ 'ferrings tcp echo',
31
+ 'ferrings tcp echo batch',
32
+ 'ferrings tcp echo full batch',
33
+ 'ferrings tcp facade echo',
34
+ 'ferrings tcp facade batch echo',
35
+ 'ferrings tcp echo zc',
36
+ 'ferrings native tcp echo zc',
37
+ 'ferrings native tcp echo zc recv-bundle',
38
+ 'ferrings tcp echo batch zc',
39
+ 'ferrings tcp echo full batch zc',
40
+ 'ferrings tcp facade echo zc',
41
+ 'ferrings tcp facade batch echo zc'
42
+ ];
43
+ const CASES = (process.env.CASES || DEFAULT_CASES.join(','))
44
+ .split(',')
45
+ .map((name) => name.trim())
46
+ .filter(Boolean);
47
+ const CASE_ISOLATION = process.env.CASE_ISOLATION !== '0';
48
+ const CASE_REPORT_PATH = process.env.CASE_REPORT_PATH;
22
49
  const REPORT_PATH = process.env.REPORT_PATH;
23
50
 
51
+ if (process.argv[2] === '--case') {
52
+ runCase(process.argv[3])
53
+ .then((result) => {
54
+ if (CASE_REPORT_PATH) {
55
+ fs.mkdirSync(path.dirname(CASE_REPORT_PATH), { recursive: true });
56
+ fs.writeFileSync(CASE_REPORT_PATH, `${JSON.stringify(result, null, 2)}\n`);
57
+ } else {
58
+ console.log(JSON.stringify(result));
59
+ }
60
+ })
61
+ .catch((error) => {
62
+ console.error(error);
63
+ process.exitCode = 1;
64
+ });
65
+ } else {
66
+ main().catch((error) => {
67
+ console.error(error);
68
+ process.exitCode = 1;
69
+ });
70
+ }
71
+
24
72
  function payload(size) {
25
73
  const data = Buffer.alloc(size);
26
74
  for (let index = 0; index < data.length; index += 1) {
@@ -29,6 +77,13 @@ function payload(size) {
29
77
  return data;
30
78
  }
31
79
 
80
+ function caps() {
81
+ if (!capsCache) {
82
+ capsCache = capabilities();
83
+ }
84
+ return capsCache;
85
+ }
86
+
32
87
  function echoOnce(port, request = REQUEST, expected = RESPONSE) {
33
88
  const startedAt = performance.now();
34
89
  return new Promise((resolve, reject) => {
@@ -101,8 +156,8 @@ async function withUringNativeEchoServer(options = {}, request = REQUEST) {
101
156
  host: '127.0.0.1',
102
157
  port: 0,
103
158
  queueDepth: QUEUE_DEPTH,
104
- bufferCount: 4096,
105
- bufferSize: 2048,
159
+ bufferCount: BUFFER_COUNT,
160
+ bufferSize: BUFFER_SIZE,
106
161
  ...options
107
162
  });
108
163
 
@@ -122,8 +177,8 @@ async function withUringServer(options = {}) {
122
177
  host: '127.0.0.1',
123
178
  port: 0,
124
179
  queueDepth: QUEUE_DEPTH,
125
- bufferCount: 4096,
126
- bufferSize: 2048,
180
+ bufferCount: BUFFER_COUNT,
181
+ bufferSize: BUFFER_SIZE,
127
182
  ...options
128
183
  });
129
184
 
@@ -148,8 +203,8 @@ async function withUringBatchServer(options = {}) {
148
203
  host: '127.0.0.1',
149
204
  port: 0,
150
205
  queueDepth: QUEUE_DEPTH,
151
- bufferCount: 4096,
152
- bufferSize: 2048,
206
+ bufferCount: BUFFER_COUNT,
207
+ bufferSize: BUFFER_SIZE,
153
208
  ...options
154
209
  });
155
210
 
@@ -176,8 +231,8 @@ async function withUringFullBatchServer(options = {}) {
176
231
  host: '127.0.0.1',
177
232
  port: 0,
178
233
  queueDepth: QUEUE_DEPTH,
179
- bufferCount: 4096,
180
- bufferSize: 2048,
234
+ bufferCount: BUFFER_COUNT,
235
+ bufferSize: BUFFER_SIZE,
181
236
  ...options
182
237
  });
183
238
 
@@ -209,8 +264,8 @@ async function withTcpFacadeServer(options = {}) {
209
264
  host: '127.0.0.1',
210
265
  port: 0,
211
266
  queueDepth: QUEUE_DEPTH,
212
- bufferCount: 4096,
213
- bufferSize: 2048,
267
+ bufferCount: BUFFER_COUNT,
268
+ bufferSize: BUFFER_SIZE,
214
269
  ...options
215
270
  },
216
271
  (connection) => {
@@ -237,8 +292,8 @@ async function withTcpFacadeBatchServer(options = {}) {
237
292
  host: '127.0.0.1',
238
293
  port: 0,
239
294
  queueDepth: QUEUE_DEPTH,
240
- bufferCount: 4096,
241
- bufferSize: 2048,
295
+ bufferCount: BUFFER_COUNT,
296
+ bufferSize: BUFFER_SIZE,
242
297
  ...options
243
298
  });
244
299
 
@@ -265,16 +320,27 @@ function percentile(values, quantile) {
265
320
  }
266
321
 
267
322
  async function maybeRecvBundle(label, runner) {
268
- if (!CAPS.recvBundle) {
323
+ if (!caps().recvBundle) {
269
324
  const result = {
270
325
  skipped: 'kernel does not report IORING_FEAT_RECVSEND_BUNDLE'
271
326
  };
272
327
  console.log(label, result);
273
328
  return result;
274
329
  }
275
- const result = await runner();
276
- console.log(label, result);
277
- return result;
330
+ try {
331
+ const result = await runner();
332
+ console.log(label, result);
333
+ return result;
334
+ } catch (error) {
335
+ if (/provided-buffer-ring setup was unavailable|Cannot allocate memory/i.test(error.message)) {
336
+ const result = {
337
+ skipped: error.message
338
+ };
339
+ console.log(label, result);
340
+ return result;
341
+ }
342
+ throw error;
343
+ }
278
344
  }
279
345
 
280
346
  function summarizeServerInfo(info) {
@@ -318,9 +384,12 @@ function baseReport() {
318
384
  durationMs: DURATION_MS,
319
385
  concurrency: CONCURRENCY,
320
386
  queueDepth: QUEUE_DEPTH,
321
- bundleRequestSize: BUNDLE_REQUEST_SIZE
387
+ bufferCount: BUFFER_COUNT,
388
+ bufferSize: BUFFER_SIZE,
389
+ bundleRequestSize: BUNDLE_REQUEST_SIZE,
390
+ cases: CASES
322
391
  },
323
- capabilities: CAPS,
392
+ capabilities: caps(),
324
393
  results: [],
325
394
  error: null
326
395
  };
@@ -341,21 +410,55 @@ function errorForReport(error) {
341
410
  };
342
411
  }
343
412
 
344
- async function record(report, caseName, runner) {
345
- const result = await runner();
413
+ async function record(report, caseName) {
414
+ const result = CASE_ISOLATION ? runIsolatedCase(caseName) : await runCase(caseName);
346
415
  report.results.push({ caseName, result });
347
416
  console.log(caseName, result);
348
417
  }
349
418
 
350
- (async () => {
351
- const report = baseReport();
419
+ function runIsolatedCase(caseName) {
420
+ const caseReportPath = path.join(
421
+ os.tmpdir(),
422
+ `ferrings-tcp-case-${process.pid}-${Date.now()}-${caseName.replace(/[^a-z0-9]+/gi, '-')}.json`
423
+ );
424
+ const result = spawnSync(process.execPath, [__filename, '--case', caseName], {
425
+ cwd: path.join(__dirname, '..'),
426
+ env: {
427
+ ...process.env,
428
+ CASE_ISOLATION: '0',
429
+ CASE_REPORT_PATH: caseReportPath,
430
+ REPORT_PATH: ''
431
+ },
432
+ stdio: 'inherit'
433
+ });
434
+ if (result.error) {
435
+ throw result.error;
436
+ }
437
+ if (result.status !== 0) {
438
+ const error = new Error(`${caseName} exited with status ${result.status ?? 1}`);
439
+ error.caseResult = readCaseReport(caseReportPath);
440
+ throw error;
441
+ }
442
+ return readCaseReport(caseReportPath);
443
+ }
444
+
445
+ function readCaseReport(caseReportPath) {
352
446
  try {
353
- console.log(report.config);
354
- await record(report, 'node:net echo', withNodeServer);
355
- await record(report, 'ferrings native tcp echo', withUringNativeEchoServer);
356
- report.results.push({
357
- caseName: 'ferrings native tcp echo recv-bundle',
358
- result: await maybeRecvBundle('ferrings native tcp echo recv-bundle', () =>
447
+ if (!fs.existsSync(caseReportPath)) return null;
448
+ return JSON.parse(fs.readFileSync(caseReportPath, 'utf8'));
449
+ } finally {
450
+ fs.rmSync(caseReportPath, { force: true });
451
+ }
452
+ }
453
+
454
+ async function runCase(caseName) {
455
+ switch (caseName) {
456
+ case 'node:net echo':
457
+ return withNodeServer();
458
+ case 'ferrings native tcp echo':
459
+ return withUringNativeEchoServer();
460
+ case 'ferrings native tcp echo recv-bundle':
461
+ return maybeRecvBundle(caseName, () =>
359
462
  withUringNativeEchoServer(
360
463
  {
361
464
  bufferSize: 512,
@@ -363,30 +466,31 @@ async function record(report, caseName, runner) {
363
466
  },
364
467
  BUNDLE_REQUEST
365
468
  )
366
- )
367
- });
368
- await record(report, 'ferrings tcp echo', withUringServer);
369
- await record(report, 'ferrings tcp echo batch', withUringBatchServer);
370
- await record(report, 'ferrings tcp echo full batch', withUringFullBatchServer);
371
- await record(report, 'ferrings tcp facade echo', withTcpFacadeServer);
372
- await record(report, 'ferrings tcp facade batch echo', withTcpFacadeBatchServer);
373
- await record(report, 'ferrings tcp echo zc', () =>
374
- withUringServer({
469
+ );
470
+ case 'ferrings tcp echo':
471
+ return withUringServer();
472
+ case 'ferrings tcp echo batch':
473
+ return withUringBatchServer();
474
+ case 'ferrings tcp echo full batch':
475
+ return withUringFullBatchServer();
476
+ case 'ferrings tcp facade echo':
477
+ return withTcpFacadeServer();
478
+ case 'ferrings tcp facade batch echo':
479
+ return withTcpFacadeBatchServer();
480
+ case 'ferrings tcp echo zc':
481
+ return withUringServer({
375
482
  useZeroCopySend: true,
376
483
  sendBufferCount: 512,
377
484
  sendBufferSize: 2048
378
- })
379
- );
380
- await record(report, 'ferrings native tcp echo zc', () =>
381
- withUringNativeEchoServer({
485
+ });
486
+ case 'ferrings native tcp echo zc':
487
+ return withUringNativeEchoServer({
382
488
  useZeroCopySend: true,
383
489
  sendBufferCount: 512,
384
490
  sendBufferSize: 2048
385
- })
386
- );
387
- report.results.push({
388
- caseName: 'ferrings native tcp echo zc recv-bundle',
389
- result: await maybeRecvBundle('ferrings native tcp echo zc recv-bundle', () =>
491
+ });
492
+ case 'ferrings native tcp echo zc recv-bundle':
493
+ return maybeRecvBundle(caseName, () =>
390
494
  withUringNativeEchoServer(
391
495
  {
392
496
  bufferSize: 512,
@@ -397,36 +501,43 @@ async function record(report, caseName, runner) {
397
501
  },
398
502
  BUNDLE_REQUEST
399
503
  )
400
- )
401
- });
402
- await record(report, 'ferrings tcp echo batch zc', () =>
403
- withUringBatchServer({
504
+ );
505
+ case 'ferrings tcp echo batch zc':
506
+ return withUringBatchServer({
404
507
  useZeroCopySend: true,
405
508
  sendBufferCount: 512,
406
509
  sendBufferSize: 2048
407
- })
408
- );
409
- await record(report, 'ferrings tcp echo full batch zc', () =>
410
- withUringFullBatchServer({
510
+ });
511
+ case 'ferrings tcp echo full batch zc':
512
+ return withUringFullBatchServer({
411
513
  useZeroCopySend: true,
412
514
  sendBufferCount: 512,
413
515
  sendBufferSize: 2048
414
- })
415
- );
416
- await record(report, 'ferrings tcp facade echo zc', () =>
417
- withTcpFacadeServer({
516
+ });
517
+ case 'ferrings tcp facade echo zc':
518
+ return withTcpFacadeServer({
418
519
  useZeroCopySend: true,
419
520
  sendBufferCount: 512,
420
521
  sendBufferSize: 2048
421
- })
422
- );
423
- await record(report, 'ferrings tcp facade batch echo zc', () =>
424
- withTcpFacadeBatchServer({
522
+ });
523
+ case 'ferrings tcp facade batch echo zc':
524
+ return withTcpFacadeBatchServer({
425
525
  useZeroCopySend: true,
426
526
  sendBufferCount: 512,
427
527
  sendBufferSize: 2048
428
- })
429
- );
528
+ });
529
+ default:
530
+ throw new Error(`unknown TCP benchmark case: ${caseName}`);
531
+ }
532
+ }
533
+
534
+ async function main() {
535
+ const report = baseReport();
536
+ try {
537
+ console.log(report.config);
538
+ for (const caseName of CASES) {
539
+ await record(report, caseName);
540
+ }
430
541
  report.status = 'passed';
431
542
  } catch (error) {
432
543
  report.status = 'failed';
@@ -436,7 +547,4 @@ async function record(report, caseName, runner) {
436
547
  report.finishedAt = new Date().toISOString();
437
548
  writeReport(report);
438
549
  }
439
- })().catch((error) => {
440
- console.error(error);
441
- process.exitCode = 1;
442
- });
550
+ }
package/ferrings.linux-x64-gnu.node CHANGED
Binary file
package/native.js CHANGED
@@ -77,8 +77,8 @@ function requireNative() {
77
77
  try {
78
78
  const binding = require('ferrings-android-arm64')
79
79
  const bindingPackageVersion = require('ferrings-android-arm64/package.json').version
80
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
81
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
80
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
81
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
82
82
  }
83
83
  return binding
84
84
  } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
93
93
  try {
94
94
  const binding = require('ferrings-android-arm-eabi')
95
95
  const bindingPackageVersion = require('ferrings-android-arm-eabi/package.json').version
96
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
97
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
96
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
97
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
98
98
  }
99
99
  return binding
100
100
  } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
114
114
  try {
115
115
  const binding = require('ferrings-win32-x64-gnu')
116
116
  const bindingPackageVersion = require('ferrings-win32-x64-gnu/package.json').version
117
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
118
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
117
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
118
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
119
119
  }
120
120
  return binding
121
121
  } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
130
130
  try {
131
131
  const binding = require('ferrings-win32-x64-msvc')
132
132
  const bindingPackageVersion = require('ferrings-win32-x64-msvc/package.json').version
133
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
134
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
133
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
134
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
135
135
  }
136
136
  return binding
137
137
  } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
147
147
  try {
148
148
  const binding = require('ferrings-win32-ia32-msvc')
149
149
  const bindingPackageVersion = require('ferrings-win32-ia32-msvc/package.json').version
150
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
151
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
150
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
151
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
152
152
  }
153
153
  return binding
154
154
  } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
163
163
  try {
164
164
  const binding = require('ferrings-win32-arm64-msvc')
165
165
  const bindingPackageVersion = require('ferrings-win32-arm64-msvc/package.json').version
166
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
167
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
166
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
167
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
168
168
  }
169
169
  return binding
170
170
  } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
182
182
  try {
183
183
  const binding = require('ferrings-darwin-universal')
184
184
  const bindingPackageVersion = require('ferrings-darwin-universal/package.json').version
185
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
186
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
185
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
186
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
187
187
  }
188
188
  return binding
189
189
  } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
198
198
  try {
199
199
  const binding = require('ferrings-darwin-x64')
200
200
  const bindingPackageVersion = require('ferrings-darwin-x64/package.json').version
201
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
202
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
201
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
202
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
203
203
  }
204
204
  return binding
205
205
  } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
214
214
  try {
215
215
  const binding = require('ferrings-darwin-arm64')
216
216
  const bindingPackageVersion = require('ferrings-darwin-arm64/package.json').version
217
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
218
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
217
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
218
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
219
219
  }
220
220
  return binding
221
221
  } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
234
234
  try {
235
235
  const binding = require('ferrings-freebsd-x64')
236
236
  const bindingPackageVersion = require('ferrings-freebsd-x64/package.json').version
237
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
238
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
237
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
238
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
239
239
  }
240
240
  return binding
241
241
  } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
250
250
  try {
251
251
  const binding = require('ferrings-freebsd-arm64')
252
252
  const bindingPackageVersion = require('ferrings-freebsd-arm64/package.json').version
253
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
254
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
253
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
254
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
255
255
  }
256
256
  return binding
257
257
  } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
271
271
  try {
272
272
  const binding = require('ferrings-linux-x64-musl')
273
273
  const bindingPackageVersion = require('ferrings-linux-x64-musl/package.json').version
274
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
275
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
274
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
275
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
276
276
  }
277
277
  return binding
278
278
  } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
287
287
  try {
288
288
  const binding = require('ferrings-linux-x64-gnu')
289
289
  const bindingPackageVersion = require('ferrings-linux-x64-gnu/package.json').version
290
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
291
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
290
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
291
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
292
292
  }
293
293
  return binding
294
294
  } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
305
305
  try {
306
306
  const binding = require('ferrings-linux-arm64-musl')
307
307
  const bindingPackageVersion = require('ferrings-linux-arm64-musl/package.json').version
308
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
309
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
308
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
309
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
310
310
  }
311
311
  return binding
312
312
  } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
321
321
  try {
322
322
  const binding = require('ferrings-linux-arm64-gnu')
323
323
  const bindingPackageVersion = require('ferrings-linux-arm64-gnu/package.json').version
324
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
325
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
324
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
325
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
326
326
  }
327
327
  return binding
328
328
  } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
339
339
  try {
340
340
  const binding = require('ferrings-linux-arm-musleabihf')
341
341
  const bindingPackageVersion = require('ferrings-linux-arm-musleabihf/package.json').version
342
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
343
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
342
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
343
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
344
344
  }
345
345
  return binding
346
346
  } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
355
355
  try {
356
356
  const binding = require('ferrings-linux-arm-gnueabihf')
357
357
  const bindingPackageVersion = require('ferrings-linux-arm-gnueabihf/package.json').version
358
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
359
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
358
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
359
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
360
360
  }
361
361
  return binding
362
362
  } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
373
373
  try {
374
374
  const binding = require('ferrings-linux-loong64-musl')
375
375
  const bindingPackageVersion = require('ferrings-linux-loong64-musl/package.json').version
376
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
377
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
376
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
377
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
378
378
  }
379
379
  return binding
380
380
  } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
389
389
  try {
390
390
  const binding = require('ferrings-linux-loong64-gnu')
391
391
  const bindingPackageVersion = require('ferrings-linux-loong64-gnu/package.json').version
392
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
393
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
392
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
393
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
394
394
  }
395
395
  return binding
396
396
  } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
407
407
  try {
408
408
  const binding = require('ferrings-linux-riscv64-musl')
409
409
  const bindingPackageVersion = require('ferrings-linux-riscv64-musl/package.json').version
410
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
411
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
410
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
411
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
412
412
  }
413
413
  return binding
414
414
  } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
423
423
  try {
424
424
  const binding = require('ferrings-linux-riscv64-gnu')
425
425
  const bindingPackageVersion = require('ferrings-linux-riscv64-gnu/package.json').version
426
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
427
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
426
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
427
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
428
428
  }
429
429
  return binding
430
430
  } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
440
440
  try {
441
441
  const binding = require('ferrings-linux-ppc64-gnu')
442
442
  const bindingPackageVersion = require('ferrings-linux-ppc64-gnu/package.json').version
443
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
444
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
443
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
444
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
445
445
  }
446
446
  return binding
447
447
  } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
456
456
  try {
457
457
  const binding = require('ferrings-linux-s390x-gnu')
458
458
  const bindingPackageVersion = require('ferrings-linux-s390x-gnu/package.json').version
459
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
460
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
459
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
460
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
461
461
  }
462
462
  return binding
463
463
  } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
476
476
  try {
477
477
  const binding = require('ferrings-openharmony-arm64')
478
478
  const bindingPackageVersion = require('ferrings-openharmony-arm64/package.json').version
479
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
480
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
479
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
480
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
481
481
  }
482
482
  return binding
483
483
  } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
492
492
  try {
493
493
  const binding = require('ferrings-openharmony-x64')
494
494
  const bindingPackageVersion = require('ferrings-openharmony-x64/package.json').version
495
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
496
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
495
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
496
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
497
497
  }
498
498
  return binding
499
499
  } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
508
508
  try {
509
509
  const binding = require('ferrings-openharmony-arm')
510
510
  const bindingPackageVersion = require('ferrings-openharmony-arm/package.json').version
511
- if (bindingPackageVersion !== '0.2.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
512
- throw new Error(`Native binding package version mismatch, expected 0.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
511
+ if (bindingPackageVersion !== '0.2.2' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
512
+ throw new Error(`Native binding package version mismatch, expected 0.2.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
513
513
  }
514
514
  return binding
515
515
  } catch (e) {
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "ferrings",
3
- "version": "0.2.0",
4
- "description": "Linux io_uring TCP transport experiments for Node.js",
3
+ "version": "0.2.2",
4
+ "description": "Linux io_uring TCP transport for Node.js services",
5
5
  "main": "index.js",
6
6
  "types": "index.d.ts",
7
7
  "bin": {
@@ -68,10 +68,10 @@
68
68
  "@napi-rs/cli": "^3.7.2"
69
69
  },
70
70
  "optionalDependencies": {
71
- "ferrings-linux-arm64-gnu": "0.2.0",
72
- "ferrings-linux-arm64-musl": "0.2.0",
73
- "ferrings-linux-x64-gnu": "0.2.0",
74
- "ferrings-linux-x64-musl": "0.2.0"
71
+ "ferrings-linux-arm64-gnu": "0.2.2",
72
+ "ferrings-linux-arm64-musl": "0.2.2",
73
+ "ferrings-linux-x64-gnu": "0.2.2",
74
+ "ferrings-linux-x64-musl": "0.2.2"
75
75
  },
76
76
  "napi": {
77
77
  "binaryName": "ferrings",
@@ -83,7 +83,7 @@
83
83
  ]
84
84
  },
85
85
  "engines": {
86
- "node": ">=20"
86
+ "node": ">=22"
87
87
  },
88
88
  "os": [
89
89
  "linux"