ded/cpp-httplib
1
0
Fork 0
mirror of https://github.com/yhirose/cpp-httplib.git synced 2026-04-11 19:28:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

Update README-websocket.md and justfile

Browse Source
This commit is contained in:
yhirose
2026-02-14 17:59:15 -05:00
parent 464867a9ce
commit b2430249d2
2 changed files with 14 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
README-websocket.md
View File

@@ -355,21 +355,21 @@ if (ws.connect()) {
## Threading Model
WebSocket connections share the same thread pool as HTTP requests. Each WebSocket connection occupies one thread for its entire lifetime. The default thread pool size is `CPPHTTPLIB_THREAD_POOL_COUNT` (8).
WebSocket connections share the same thread pool as HTTP requests. Each WebSocket connection occupies one thread for its entire lifetime.
This means that if you have 8 simultaneous WebSocket connections with the default settings, **no more HTTP requests can be processed** until a WebSocket connection closes and frees up a thread.
The default thread pool uses dynamic scaling: it maintains a base thread count of `CPPHTTPLIB_THREAD_POOL_COUNT` (8 or `std::thread::hardware_concurrency() - 1`, whichever is greater) and can scale up to 4x that count under load (`CPPHTTPLIB_THREAD_POOL_MAX_COUNT`). When all base threads are busy, temporary threads are spawned automatically up to the maximum. These dynamic threads exit after an idle timeout (`CPPHTTPLIB_THREAD_POOL_IDLE_TIMEOUT`, default 3 seconds).
If your application uses WebSocket, you should increase the thread pool size:
This dynamic scaling helps accommodate WebSocket connections alongside HTTP requests. However, if you expect many simultaneous WebSocket connections, you should configure the thread pool accordingly:
```cpp
httplib::Server svr;
svr.new_task_queue = [] {
return new httplib::ThreadPool(128); // Increase from default 8
return new httplib::ThreadPool(/*base_threads=*/8, /*max_threads=*/128);
};
```
Choose a size that accounts for both your expected HTTP load and the maximum number of simultaneous WebSocket connections.
Choose sizes that account for both your expected HTTP load and the maximum number of simultaneous WebSocket connections.
## Protocol

9
justfile
View File

@@ -28,6 +28,15 @@ no_tls_parallel:
fuzz:
@(cd test && make fuzz_test)
proxy:
@(cd test && make proxy)
websocket_heartbeat:
@(cd test && make test_websocket_heartbeat && ./test_websocket_heartbeat)
thread_pool:
@(cd test && make test_thread_pool && ./test_thread_pool)
build:
@(cd test && make test_split)
@(cd test && make test_split_mbedtls)