Lines Matching +full:open +full:- +full:pull +full:- +full:requests +full:- +full:limit
7 user callback found in test-server.c / test-server-http.c.
34 So it if highly recommended you put your protocol-specific code into the
36 use it dynamically-loaded.
47 - `lws_callback_on_writable(wsi)` for a specific `wsi`, or
49 - `lws_callback_on_writable_all_protocol(protocol)` for all connections
75 You will receive a message about "Illegal back-to-back write of ... detected"
82 and be buffered for completion by lws; it will be auto-completed by the
90 @section otherwr Do not rely on only your own WRITEABLE requests appearing
117 allowed to open (1024 on Fedora for example). It then allocates arrays that
129 at one time. You can choose to limit these at context creation time, using
132 Note that although the ah limit is 'soft', ie, the connection will just wait
133 until the IP is under the ah limit again before attaching a new ah, the
134 wsi limit is 'hard', lws will drop any additional connections from the
135 IP until it's under the limit again.
146 libraries that also take this locking-free, nonblocking event loop approach that
187 This will take a platform-specific action to wake the lws event loop thread wait,
191 message to every vhost-protocol instantiation, so you can handle this callback,
204 it again to re-enable it on the incoming wsi.
228 pvo (per-vhost option) to the
232 * this sets a per-vhost, per-protocol option name:value pair
247 "my-protocol",
258 Will select "my-protocol" from your protocol list (even if it came
264 When you want to close a connection, you do it by returning `-1` from a
268 the wsi, then notice in the callback you want to close it and just return -1.
270 -1 is simple.
287 simply send the gzip-compressed file from inside the zip file with no further
299 `libwebsockets-test-server-v2.0` includes a mount using this technology
303 inside a .zip file in /usr/[local/]share-libwebsockets-test-server/candide.zip
306 eg, "/ziptest" -> "mypath/test.zip", then URLs like `/ziptest/index.html` will be
323 if (client->HasFragments()) {
324 client->AppendMessageFragment(in, len, 0);
325 in = (void *)client->GetMessage();
326 len = client->GetMessageLength();
329 client->ProcessMessage((char *)in, len, wsi);
330 client->ResetMessage();
332 client->AppendMessageFragment(in, len, remaining);
337 The test app libwebsockets-test-fraggle sources also show how to
348 Sanitizer, using `cmake .. -DCMAKE_BUILD_TYPE=DEBUG -DLWS_WITH_ASAN=1`. LWS is routinely run durin…
375 So you can let **libwebsockets** try and if `pollfd->revents` is nonzero on return,
382 - be sure you set .events to .revents value as well in the synthesized pollfd
384 - check the built-in support for the event loop if possible (eg, ./lib/libuv.c)
387 - use LWS_POLLHUP / LWS_POLLIN / LWS_POLLOUT from libwebsockets.h to avoid
400 `lws_service_tsi(context, -1, tsi)`, again normally tsi is 0.
408 An example of handling it is shown in the test-server code specific to
417 $ cp test-apps/test-server.c test.cpp
423 $ g++ -DINSTALL_DATADIR=\"/usr/share\" -ocpptest test.cpp -lwebsockets
447 when you want to enable -DLWS_WITH_HTTP2=1.
469 - observe the LWS_PRE buffer requirement mentioned above
471 - Use `lws_add_http_header_status()` to add the transaction status (200 etc)
473 - use lws apis `lws_add_http_header_by_name()` and `lws_add_http_header_by_token()`
477 - use the `lws api lws_finalize_http_header()` api after adding the last
480 - write the header using lws_write(..., `LWS_WRITE_HTTP_HEADERS`);
482 3) http/2 introduces per-stream transmit credit... how much more you can send
487 more credit for the stream appears, and lws built-in file serving (via mounts
491 For http/1, it will always return (size_t)-1, ie, no limit.
505 your header name strings to lower-case to be compatible both ways.
507 5) Chunked Transfer-encoding is illegal in http/2, http/2 peers will actively
534 Note that BSDs don't support keepalive time / probes / interval per-socket
544 context-creation time.
549 `"RC4-MD5:RC4-SHA:AES128-SHA:AES256-SHA:HIGH:!DSS:!aNULL"`
583 After attempting the connection and getting back a non-`NULL` `wsi` you should
586 As usual, see [test-client.c](../test-apps/test-client.c) for example code.
600 @section fileapi Lws platform-independent file access apis
603 both used by user code to make it platform-agnostic, and be overridden or
610 The test server shows how to use it, basically the platform-specific part of
620 and then can use helpers to also leverage these platform-independent
670 1) Pre-2.2 fops directly used platform file descriptors. Current fops returns and accepts a wrappe…
672 …-2.2 fops bound the fops to a wsi. This is completely removed, you just give a pointer to the fop…
674 3) Everything is wrapped in typedefs. See lws-plat-unix.c for examples of how to implement.
676 4) Position in the file, File Length, and a copy of Flags left after open are now generically held …
677 …n must set and manage this generic information now. See the implementations in lws-plat-unix.c for
680 5) The file length is no longer set at a pointer provided by the open() fop. The api `lws_vfs_get_…
681 get the file length after open.
684 on the flags during open.
686 …ional `mod_time` uint32_t member in the generic fop_fd. If you are able to set it during open, you
693 Open your fd normally and then
701 "protocol-name-to-bind-to",
721 The minimal example `raw/minimal-raw-file` demonstrates how to use it.
723 `protocol-lws-raw-test` plugin also provides a method for testing this with
724 `libwebsockets-test-server-v2.0`:
726 The plugin creates a FIFO on your system called "/tmp/lws-test-raw"
731 $ sudo sh -c "echo hello > /tmp/lws-test-raw"
745 `.listen_accept_role` to `"raw-skt"` when creating the vhost.
760 `protocol-lws-raw-test` plugin provides a method for testing this with
761 `libwebsockets-test-server-v2.0`:
763 Run libwebsockets-test-server-v2.0 and connect to it by telnet, eg
777 You can now also open RAW socket connections in client mode.
784 The libwebsockets-test-client supports this using raw:// URLS. To
785 test, open a netcat listener in one window
788 $ nc -l 9999
794 $ libwebsockets-test-client raw://127.0.0.1:9999
844 cmake .. -DLWS_SSL_SERVER_WITH_ECDH_CERT=1
846 **and** the info->options flag
874 -S -s on `libwebsockets-test-server-v2.0`.
881 very simple to use, libwebsockets-test-server-pthread shows how to do it,
882 use -j n argument there to control the number of service threads up to 32.
901 associated to a specific tsi (Thread Service Index, 0 .. n - 1). See
902 the libwebsockets-test-server-pthread for how to do.
904 If you leave fd_limit_per_thread at 0, then the process limit of fds is shared
909 the overall supported fd limit is less than the process allowance.
912 using -DLWS_MAX_SMP=, if not given it's set to 1. The serv_buf allocation
915 Because lws will limit the requested number of actual threads supported
919 See the test-server-pthreads.c sample for how to use.
955 -DLWS_WITH_LIBEV=1
956 -DLWS_WITH_LIBUV=1
957 -DLWS_WITH_LIBEVENT=1
959 at cmake configure-time. The user application may use one of the
984 We worked around this problem by disabling -Werror on the parts of lws that
995 User code may set per-connection extension options now, using a new api
1000 lws_set_extension_option(wsi, "permessage-deflate",
1006 just returns -1. Otherwise the connection's extension has its
1010 example above permessage-deflate restricts the size of his rx
1016 You may open a generic http client connection using the same
1039 int lenx = sizeof(buffer) - LWS_PRE;
1051 return -1;
1052 while (lenx--)
1063 @section clipipe Pipelining Client Requests to same host
1065 If you are opening more client requests to the same host and port, you
1071 That is fast, but resource-intensive.
1075 first connection that pipelining / keep-alive is supported by the server,
1077 of time to create a pipeline of requests on the server side.
1096 `-DLWS_WITH_HTTP2=1` or giving the `LCCSCF_NOT_H2` flag in the client
1200 - LWSMPRO_FILE is used for mapping url namespace to a filesystem directory and
1203 - LWSMPRO_CGI associates the url namespace with the given CGI executable, which
1206 - LWSMPRO_REDIR_HTTP and LWSMPRO_REDIR_HTTPS auto-redirect clients to the given
1209 - LWSMPRO_CALLBACK causes the http connection to attach to the callback
1219 in test-server-v2.0.c, the URL area "/formtest" is associated with the plugin
1220 providing "protocol-post-demo" like this
1224 NULL, /* linked-list pointer to next*/
1226 "protocol-post-demo", /* handler */
1244 protocol-post-demo deals with accepting and responding to the html form that
1272 This Linux-only feature requires SO_BIND_TO_DEVICE, which in turn
1286 $ sudo /usr/local/bin/libwebsockets-test-server -u agreen -i eno1 -k
1306 - include lws-common.js from your HEAD section
1308 \<script src="/lws-common.js">\</script>
1310 - dim the page during initialization, in a script section on your page
1314 - in your ws onOpen(), remove the dimming
1318 - in your ws onClose(), reapply the dimming
1329 `.error_document_404`... if non-null the client is redirected to this string.
1332 the user-selected text message and attempts to pull in `/error.css` for styling.