Logo ROOT  
Reference Guide
 
Loading...
Searching...
No Matches
civetweb.h
Go to the documentation of this file.
1/* Copyright (c) 2013-2021 the Civetweb developers
2 * Copyright (c) 2004-2013 Sergey Lyubka
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a copy
5 * of this software and associated documentation files (the "Software"), to deal
6 * in the Software without restriction, including without limitation the rights
7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
8 * copies of the Software, and to permit persons to whom the Software is
9 * furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included in
12 * all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
17 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
20 * THE SOFTWARE.
21 */
22
23#ifndef CIVETWEB_HEADER_INCLUDED
24#define CIVETWEB_HEADER_INCLUDED
25
26#define CIVETWEB_VERSION "1.15"
27#define CIVETWEB_VERSION_MAJOR (1)
28#define CIVETWEB_VERSION_MINOR (15)
29#define CIVETWEB_VERSION_PATCH (0)
30
31#ifndef CIVETWEB_API
32#if defined(_WIN32)
33#if defined(CIVETWEB_DLL_EXPORTS)
34#define CIVETWEB_API __declspec(dllexport)
35#elif defined(CIVETWEB_DLL_IMPORTS)
36#define CIVETWEB_API __declspec(dllimport)
37#else
38#define CIVETWEB_API
39#endif
40#elif __GNUC__ >= 4
41#define CIVETWEB_API __attribute__((visibility("default")))
42#else
43#define CIVETWEB_API
44#endif
45#endif
46
47#include <stddef.h>
48#include <stdio.h>
49
50#ifdef __cplusplus
51extern "C" {
52#endif /* __cplusplus */
53
54
55/* Init Features */
56enum {
58
59 /* Support files from local directories */
60 /* Will only work, if NO_FILES is not set. */
62
63 /* Support transport layer security (TLS). */
64 /* SSL is still often used synonymously for TLS. */
65 /* Will only work, if NO_SSL is not set. */
68
69 /* Support common gateway interface (CGI). */
70 /* Will only work, if NO_CGI is not set. */
72
73 /* Support IPv6. */
74 /* Will only work, if USE_IPV6 is set. */
76
77 /* Support WebSocket protocol. */
78 /* Will only work, if USE_WEBSOCKET is set. */
80
81 /* Support server side Lua scripting. */
82 /* Will only work, if USE_LUA is set. */
84
85 /* Support server side JavaScript scripting. */
86 /* Will only work, if USE_DUKTAPE is set. */
88
89 /* Provide data required for caching files. */
90 /* Will only work, if NO_CACHING is not set. */
92
93 /* Collect server status information. */
94 /* Will only work, if USE_SERVER_STATS is set. */
96
97 /* Support on-the-fly compression. */
98 /* Will only work, if USE_ZLIB is set. */
100
101 /* HTTP/2 support enabled. */
103
104 /* Support unix domain sockets. */
106
107 /* Bit mask for all feature defines. */
108 MG_FEATURES_ALL = 0xFFFFu
110
111
112/* Initialize this library. This should be called once before any other
113 * function from this library. This function is not guaranteed to be
114 * thread safe.
115 * Parameters:
116 * features: bit mask for features to be initialized.
117 * Note: The TLS libraries (like OpenSSL) is initialized
118 * only if the MG_FEATURES_TLS bit is set.
119 * Currently the other bits do not influence
120 * initialization, but this may change in future
121 * versions.
122 * Return value:
123 * initialized features
124 * 0: error
125 */
126CIVETWEB_API unsigned mg_init_library(unsigned features);
127
128
129/* Un-initialize this library.
130 * Return value:
131 * 0: error
132 */
133CIVETWEB_API unsigned mg_exit_library(void);
134
135
136struct mg_context; /* Handle for the HTTP service itself */
137struct mg_connection; /* Handle for the individual connection */
138
139
140/* Maximum number of headers */
141#define MG_MAX_HEADERS (64)
142
143struct mg_header {
144 const char *name; /* HTTP header name */
145 const char *value; /* HTTP header value */
146};
147
148
149/* This structure contains information about the HTTP request. */
151 const char *request_method; /* "GET", "POST", etc */
152 const char *request_uri; /* URL-decoded URI (absolute or relative,
153 * as in the request) */
154 const char *local_uri_raw; /* URL-decoded URI (relative). Can be NULL
155 * if the request_uri does not address a
156 * resource at the server host. */
157 const char *local_uri; /* Same as local_uri_raw, however, cleaned
158 * so a path like
159 * allowed_dir/../forbidden_file
160 * is not possible. */
161 const char *http_version; /* E.g. "1.0", "1.1" */
162 const char *query_string; /* URL part after '?', not including '?', or
163 NULL */
164 const char *remote_user; /* Authenticated user, or NULL if no auth
165 used */
166 char remote_addr[48]; /* Client's IP address as a string. */
167
168 long long content_length; /* Length (in bytes) of the request body,
169 can be -1 if no length was given. */
170 int remote_port; /* Port at client side */
171 int server_port; /* Port at server side (one of the listening
172 ports) */
173 int is_ssl; /* 1 if HTTPS or WS is used (SSL/TLS used),
174 0 if not */
175 void *user_data; /* User data pointer passed to mg_start() */
176 void *conn_data; /* Connection-specific user data */
177
178 int num_headers; /* Number of HTTP headers */
179 struct mg_header
180 http_headers[MG_MAX_HEADERS]; /* Allocate maximum headers */
181
182 struct mg_client_cert *client_cert; /* Client certificate information */
183
184 const char *acceptedWebSocketSubprotocol; /* websocket subprotocol,
185 * accepted during handshake */
186};
187
188
189/* This structure contains information about the HTTP request. */
190/* This structure may be extended in future versions. */
192 int status_code; /* E.g. 200 */
193 const char *status_text; /* E.g. "OK" */
194 const char *http_version; /* E.g. "1.0", "1.1" */
195
196 long long content_length; /* Length (in bytes) of the request body,
197 can be -1 if no length was given. */
198
199 int num_headers; /* Number of HTTP headers */
200 struct mg_header
201 http_headers[MG_MAX_HEADERS]; /* Allocate maximum headers */
202};
203
204
205/* Client certificate information (part of mg_request_info) */
208 const char *subject;
209 const char *issuer;
210 const char *serial;
211 const char *finger;
212};
213
214
215/* This structure needs to be passed to mg_start(), to let civetweb know
216 which callbacks to invoke. For a detailed description, see
217 https://github.com/civetweb/civetweb/blob/master/docs/UserManual.md */
219 /* Called when civetweb has received new HTTP request.
220 If the callback returns one, it must process the request
221 by sending valid HTTP headers and a body. Civetweb will not do
222 any further processing. Otherwise it must return zero.
223 Note that since V1.7 the "begin_request" function is called
224 before an authorization check. If an authorization check is
225 required, use a request_handler instead.
226 Return value:
227 0: civetweb will process the request itself. In this case,
228 the callback must not send any data to the client.
229 1-999: callback already processed the request. Civetweb will
230 not send any data after the callback returned. The
231 return code is stored as a HTTP status code for the
232 access log. */
234
235 /* Called when civetweb has finished processing request. */
236 void (*end_request)(const struct mg_connection *, int reply_status_code);
237
238 /* Called when civetweb is about to log a message. If callback returns
239 non-zero, civetweb does not log anything. */
240 int (*log_message)(const struct mg_connection *, const char *message);
241
242 /* Called when civetweb is about to log access. If callback returns
243 non-zero, civetweb does not log anything. */
244 int (*log_access)(const struct mg_connection *, const char *message);
245
246 /* Called when civetweb initializes SSL library.
247 Parameters:
248 ssl_ctx: SSL_CTX pointer.
249 user_data: parameter user_data passed when starting the server.
250 Return value:
251 0: civetweb will set up the SSL certificate.
252 1: civetweb assumes the callback already set up the certificate.
253 -1: initializing ssl fails. */
254 int (*init_ssl)(void *ssl_ctx, void *user_data);
255
256 /* Called when civetweb initializes SSL library for a domain.
257 Parameters:
258 server_domain: authentication_domain from the domain config.
259 ssl_ctx: SSL_CTX pointer.
260 user_data: parameter user_data passed when starting the server.
261 Return value:
262 0: civetweb will set up the SSL certificate.
263 1: civetweb assumes the callback already set up the certificate.
264 -1: initializing ssl fails. */
265 int (*init_ssl_domain)(const char *server_domain,
266 void *ssl_ctx,
267 void *user_data);
268
269 /* Called when civetweb is about to create or free a SSL_CTX.
270 Parameters:
271 ssl_ctx: SSL_CTX pointer. NULL at creation time, Not NULL when
272 mg_context will be freed user_data: parameter user_data passed when starting
273 the server. Return value: 0: civetweb will continue to create the context,
274 just as if the callback would not be present. The value in *ssl_ctx when the
275 function returns is ignored. 1: civetweb will copy the value from *ssl_ctx
276 to the civetweb context and doesn't create its own. -1: initializing ssl
277 fails.*/
278 int (*external_ssl_ctx)(void **ssl_ctx, void *user_data);
279
280 /* Called when civetweb is about to create or free a SSL_CTX for a domain.
281 Parameters:
282 server_domain: authentication_domain from the domain config.
283 ssl_ctx: SSL_CTX pointer. NULL at creation time, Not NULL when
284 mg_context will be freed user_data: parameter user_data passed when starting
285 the server. Return value: 0: civetweb will continue to create the context,
286 just as if the callback would not be present. The value in *ssl_ctx when the
287 function returns is ignored. 1: civetweb will copy the value from *ssl_ctx
288 to the civetweb context and doesn't create its own. -1: initializing ssl
289 fails.*/
290 int (*external_ssl_ctx_domain)(const char *server_domain,
291 void **ssl_ctx,
292 void *user_data);
293
294#if defined(MG_EXPERIMENTAL_INTERFACES) /* 2019-11-03 */
295 /* Called when data frame has been received from the peer.
296 Parameters:
297 bits: first byte of the websocket frame, see websocket RFC at
298 http://tools.ietf.org/html/rfc6455, section 5.2
299 data, data_len: payload, with mask (if any) already applied.
300 Return value:
301 1: keep this websocket connection open.
302 0: close this websocket connection.
303 This callback is deprecated: Use mg_set_websocket_handler instead. */
304 int (*websocket_data)(struct mg_connection *,
305 int bits,
306 char *data,
307 size_t data_len);
308#endif /* MG_LEGACY_INTERFACE */
309
310 /* Called when civetweb is closing a connection. The per-context mutex is
311 locked when this is invoked.
312
313 Websockets:
314 Before mg_set_websocket_handler has been added, it was primarily useful
315 for noting when a websocket is closing, and used to remove it from any
316 application-maintained list of clients.
317 Using this callback for websocket connections is deprecated: Use
318 mg_set_websocket_handler instead.
319 */
320 void (*connection_close)(const struct mg_connection *);
321
322 /* Called after civetweb has closed a connection. The per-context mutex is
323 locked when this is invoked.
324
325 Connection specific data:
326 If memory has been allocated for the connection specific user data
327 (mg_request_info->conn_data, mg_get_user_connection_data),
328 this is the last chance to free it.
329 */
330 void (*connection_closed)(const struct mg_connection *);
331
332
333 /* init_lua is called when civetweb is about to serve Lua server page.
334 exit_lua is called when the Lua processing is complete.
335 Both will work only if Lua support is enabled.
336 Parameters:
337 conn: current connection.
338 lua_context: "lua_State *" pointer.
339 context_flags: context type information as bitmask:
340 context_flags & 0x0F: (0-15) Lua environment type
341 */
342 void (*init_lua)(const struct mg_connection *conn,
343 void *lua_context,
344 unsigned context_flags);
345 void (*exit_lua)(const struct mg_connection *conn,
346 void *lua_context,
347 unsigned context_flags);
348
349
350 /* Called when civetweb is about to send HTTP error to the client.
351 Implementing this callback allows to create custom error pages.
352 Parameters:
353 conn: current connection.
354 status: HTTP error status code.
355 errmsg: error message text.
356 Return value:
357 1: run civetweb error handler.
358 0: callback already handled the error. */
359 int (*http_error)(struct mg_connection *conn,
360 int status,
361 const char *errmsg);
362
363 /* Called after civetweb context has been created, before requests
364 are processed.
365 Parameters:
366 ctx: context handle */
367 void (*init_context)(const struct mg_context *ctx);
368
369 /* Called when civetweb context is deleted.
370 Parameters:
371 ctx: context handle */
372 void (*exit_context)(const struct mg_context *ctx);
373
374 /* Called when a new worker thread is initialized.
375 * It is always called from the newly created thread and can be used to
376 * initialize thread local storage data.
377 * Parameters:
378 * ctx: context handle
379 * thread_type:
380 * 0 indicates the master thread
381 * 1 indicates a worker thread handling client connections
382 * 2 indicates an internal helper thread (timer thread)
383 * Return value:
384 * This function returns a user supplied pointer. The pointer is assigned
385 * to the thread and can be obtained from the mg_connection object using
386 * mg_get_thread_pointer in all server callbacks. Note: A connection and
387 * a thread are not directly related. Threads will serve several different
388 * connections, and data from a single connection may call different
389 * callbacks using different threads. The thread pointer can be obtained
390 * in a callback handler, but should not be stored beyond the scope of
391 * one call to one callback.
392 */
393 void *(*init_thread)(const struct mg_context *ctx, int thread_type);
394
395 /* Called when a worker exits.
396 * The parameters "ctx" and "thread_type" correspond to the "init_thread"
397 * call. The "thread_pointer" parameter is the value returned by
398 * "init_thread".
399 */
400 void (*exit_thread)(const struct mg_context *ctx,
401 int thread_type,
402 void *thread_pointer);
403
404 /* Called when initializing a new connection object.
405 * Can be used to initialize the connection specific user data
406 * (mg_request_info->conn_data, mg_get_user_connection_data).
407 * When the callback is called, it is not yet known if a
408 * valid HTTP(S) request will be made.
409 * Parameters:
410 * conn: not yet fully initialized connection object
411 * conn_data: output parameter, set to initialize the
412 * connection specific user data
413 * Return value:
414 * must be 0
415 * Otherwise, the result is undefined
416 */
417 int (*init_connection)(const struct mg_connection *conn, void **conn_data);
418};
419
420
421/* Start web server.
422
423 Parameters:
424 callbacks: mg_callbacks structure with user-defined callbacks.
425 options: NULL terminated list of option_name, option_value pairs that
426 specify Civetweb configuration parameters.
427
428 Side-effects: on UNIX, ignores SIGCHLD and SIGPIPE signals. If custom
429 processing is required for these, signal handlers must be set up
430 after calling mg_start().
431
432
433 Example:
434 const char *options[] = {
435 "document_root", "/var/www",
436 "listening_ports", "80,443s",
437 NULL
438 };
439 struct mg_context *ctx = mg_start(&my_func, NULL, options);
440
441 Refer to https://github.com/civetweb/civetweb/blob/master/docs/UserManual.md
442 for the list of valid option and their possible values.
443
444 Return:
445 web server context, or NULL on error. */
447 void *user_data,
448 const char **configuration_options);
449
450
451/* Stop the web server.
452
453 Must be called last, when an application wants to stop the web server and
454 release all associated resources. This function blocks until all Civetweb
455 threads are stopped. Context pointer becomes invalid. */
456CIVETWEB_API void mg_stop(struct mg_context *);
457
458
459/* Add an additional domain to an already running web server.
460 *
461 * Parameters:
462 * ctx: Context handle of a server started by mg_start.
463 * options: NULL terminated list of option_name, option_value pairs that
464 * specify CivetWeb configuration parameters.
465 *
466 * Return:
467 * < 0 in case of an error
468 * -1 for a parameter error
469 * -2 invalid options
470 * -3 initializing SSL failed
471 * -4 mandatory domain option missing
472 * -5 duplicate domain
473 * -6 out of memory
474 * > 0 index / handle of a new domain
475 */
477 const char **configuration_options);
478
479
480/* mg_request_handler
481
482 Called when a new request comes in. This callback is URI based
483 and configured with mg_set_request_handler().
484
485 Parameters:
486 conn: current connection information.
487 cbdata: the callback data configured with mg_set_request_handler().
488 Returns:
489 0: the handler could not handle the request, so fall through.
490 1 - 999: the handler processed the request. The return code is
491 stored as a HTTP status code for the access log. */
492typedef int (*mg_request_handler)(struct mg_connection *conn, void *cbdata);
493
494
495/* mg_set_request_handler
496
497 Sets or removes a URI mapping for a request handler.
498 This function waits until a removing/updating handler becomes unused, so
499 do not call from the handler itself.
500
501 URI's are ordered and prefixed URI's are supported. For example,
502 consider two URIs: /a/b and /a
503 /a matches /a
504 /a/b matches /a/b
505 /a/c matches /a
506
507 Parameters:
508 ctx: server context
509 uri: the URI (exact or pattern) for the handler
510 handler: the callback handler to use when the URI is requested.
511 If NULL, an already registered handler for this URI will
512 be removed.
513 The URI used to remove a handler must match exactly the
514 one used to register it (not only a pattern match).
515 cbdata: the callback data to give to the handler when it is called. */
517 const char *uri,
518 mg_request_handler handler,
519 void *cbdata);
520
521
522/* Callback types for websocket handlers in C/C++.
523
524 mg_websocket_connect_handler
525 Is called when the client intends to establish a websocket connection,
526 before websocket handshake.
527 Return value:
528 0: civetweb proceeds with websocket handshake.
529 1: connection is closed immediately.
530
531 mg_websocket_ready_handler
532 Is called when websocket handshake is successfully completed, and
533 connection is ready for data exchange.
534
535 mg_websocket_data_handler
536 Is called when a data frame has been received from the client.
537 Parameters:
538 bits: first byte of the websocket frame, see websocket RFC at
539 http://tools.ietf.org/html/rfc6455, section 5.2
540 data, data_len: payload, with mask (if any) already applied.
541 Return value:
542 1: keep this websocket connection open.
543 0: close this websocket connection.
544
545 mg_connection_close_handler
546 Is called, when the connection is closed.*/
548 void *);
549typedef void (*mg_websocket_ready_handler)(struct mg_connection *, void *);
551 int,
552 char *,
553 size_t,
554 void *);
555typedef void (*mg_websocket_close_handler)(const struct mg_connection *,
556 void *);
557
558/* struct mg_websocket_subprotocols
559 *
560 * List of accepted subprotocols
561 */
564 const char **subprotocols;
565};
566
567/* mg_set_websocket_handler
568
569 Set or remove handler functions for websocket connections.
570 This function works similar to mg_set_request_handler - see there. */
571CIVETWEB_API void
573 const char *uri,
574 mg_websocket_connect_handler connect_handler,
575 mg_websocket_ready_handler ready_handler,
576 mg_websocket_data_handler data_handler,
577 mg_websocket_close_handler close_handler,
578 void *cbdata);
579
580/* mg_set_websocket_handler
581
582 Set or remove handler functions for websocket connections.
583 This function works similar to mg_set_request_handler - see there. */
585 struct mg_context *ctx,
586 const char *uri,
587 struct mg_websocket_subprotocols *subprotocols,
588 mg_websocket_connect_handler connect_handler,
589 mg_websocket_ready_handler ready_handler,
590 mg_websocket_data_handler data_handler,
591 mg_websocket_close_handler close_handler,
592 void *cbdata);
593
594
595/* mg_authorization_handler
596
597 Callback function definition for mg_set_auth_handler
598
599 Parameters:
600 conn: current connection information.
601 cbdata: the callback data configured with mg_set_request_handler().
602 Returns:
603 0: access denied
604 1: access granted
605 */
607 void *cbdata);
608
609
610/* mg_set_auth_handler
611
612 Sets or removes a URI mapping for an authorization handler.
613 This function works similar to mg_set_request_handler - see there. */
615 const char *uri,
617 void *cbdata);
618
619
620/* Get the value of particular configuration parameter.
621 The value returned is read-only. Civetweb does not allow changing
622 configuration at run time.
623 If given parameter name is not valid, NULL is returned. For valid
624 names, return value is guaranteed to be non-NULL. If parameter is not
625 set, zero-length string is returned. */
626CIVETWEB_API const char *mg_get_option(const struct mg_context *ctx,
627 const char *name);
628
629
630/* Get context from connection. */
632mg_get_context(const struct mg_connection *conn);
633
634
635/* Get user data passed to mg_start from context. */
636CIVETWEB_API void *mg_get_user_data(const struct mg_context *ctx);
637
638
639/* Get user data passed to mg_start from connection. */
640CIVETWEB_API void *mg_get_user_context_data(const struct mg_connection *conn);
641
642
643/* Get user defined thread pointer for server threads (see init_thread). */
644CIVETWEB_API void *mg_get_thread_pointer(const struct mg_connection *conn);
645
646
647/* Set user data for the current connection. */
648/* Note: CivetWeb callbacks use "struct mg_connection *conn" as input
649 when mg_read/mg_write callbacks are allowed in the callback,
650 while "const struct mg_connection *conn" is used as input in case
651 calling mg_read/mg_write is not allowed.
652 Setting the user connection data will modify the connection
653 object represented by mg_connection *, but it will not read from
654 or write to the connection. */
655/* Note: An alternative is to use the init_connection callback
656 instead to initialize the user connection data pointer. It is
657 reccomended to supply a pointer to some user defined data structure
658 as conn_data initializer in init_connection. In case it is required
659 to change some data after the init_connection call, store another
660 data pointer in the user defined data structure and modify that
661 pointer. In either case, after the init_connection callback, only
662 calls to mg_get_user_connection_data should be required. */
664 void *data);
665
666
667/* Get user data set for the current connection. */
668CIVETWEB_API void *
670
671
672/* Get a formatted link corresponding to the current request
673
674 Parameters:
675 conn: current connection information.
676 buf: string buffer (out)
677 buflen: length of the string buffer
678 Returns:
679 <0: error
680 >=0: ok */
681CIVETWEB_API int
682mg_get_request_link(const struct mg_connection *conn, char *buf, size_t buflen);
683
684
685struct mg_option {
686 const char *name;
687 int type;
688 const char *default_value;
689};
690
691
692/* Configuration types */
693enum {
705
706/* Return array of struct mg_option, representing all valid configuration
707 options of civetweb.c.
708 The array is terminated by a NULL name option. */
710
711
713 int protocol; /* 1 = IPv4, 2 = IPv6, 3 = both */
714 int port; /* port number */
715 int is_ssl; /* https port: 0 = no, 1 = yes */
716 int is_redirect; /* redirect all requests: 0 = no, 1 = yes */
721};
722
723/* Legacy name */
724#define mg_server_ports mg_server_port
725
726
727/* Get the list of ports that civetweb is listening on.
728 The parameter size is the size of the ports array in elements.
729 The caller is responsibility to allocate the required memory.
730 This function returns the number of struct mg_server_port elements
731 filled in, or <0 in case of an error. */
732CIVETWEB_API int mg_get_server_ports(const struct mg_context *ctx,
733 int size,
734 struct mg_server_port *ports);
735
736
737/* Add, edit or delete the entry in the passwords file.
738 *
739 * This function allows an application to manipulate .htpasswd files on the
740 * fly by adding, deleting and changing user records. This is one of the
741 * several ways of implementing authentication on the server side. For another,
742 * cookie-based way please refer to the examples/chat in the source tree.
743 *
744 * Parameter:
745 * passwords_file_name: Path and name of a file storing multiple passwords
746 * realm: HTTP authentication realm (authentication domain) name
747 * user: User name
748 * password:
749 * If password is not NULL, entry modified or added.
750 * If password is NULL, entry is deleted.
751 *
752 * Return:
753 * 1 on success, 0 on error.
754 */
755CIVETWEB_API int mg_modify_passwords_file(const char *passwords_file_name,
756 const char *realm,
757 const char *user,
758 const char *password);
759
760
761/* Same as mg_modify_passwords_file, but instead of the plain-text
762 * password, the HA1 hash is specified. The plain-text password is
763 * not made known to civetweb.
764 *
765 * The HA1 hash is the MD5 checksum of a "user:realm:password" string
766 * in lower-case hex format. For example, if the user name is "myuser",
767 * the realm is "myrealm", and the password is "secret", then the HA1 is
768 * e67fd3248b58975c3e89ff18ecb75e2f.
769 */
770CIVETWEB_API int mg_modify_passwords_file_ha1(const char *passwords_file_name,
771 const char *realm,
772 const char *user,
773 const char *ha1);
774
775
776/* Return information associated with the request.
777 * Use this function to implement a server and get data about a request
778 * from a HTTP/HTTPS client.
779 * Note: Before CivetWeb 1.10, this function could be used to read
780 * a response from a server, when implementing a client, although the
781 * values were never returned in appropriate mg_request_info elements.
782 * It is strongly advised to use mg_get_response_info for clients.
783 */
784CIVETWEB_API const struct mg_request_info *
785mg_get_request_info(const struct mg_connection *);
786
787
788/* Return information associated with a HTTP/HTTPS response.
789 * Use this function in a client, to check the response from
790 * the server. */
791CIVETWEB_API const struct mg_response_info *
792mg_get_response_info(const struct mg_connection *);
793
794
795/* Send data to the client.
796 Return:
797 0 when the connection has been closed
798 -1 on error
799 >0 number of bytes written on success */
800CIVETWEB_API int mg_write(struct mg_connection *, const void *buf, size_t len);
801
802
803/* Send data to a websocket client wrapped in a websocket frame. Uses
804 mg_lock_connection to ensure that the transmission is not interrupted,
805 i.e., when the application is proactively communicating and responding to
806 a request simultaneously.
807
808 Send data to a websocket client wrapped in a websocket frame.
809 This function is available when civetweb is compiled with -DUSE_WEBSOCKET
810
811 Return:
812 0 when the connection has been closed
813 -1 on error
814 >0 number of bytes written on success */
816 int opcode,
817 const char *data,
818 size_t data_len);
819
820
821/* Send data to a websocket server wrapped in a masked websocket frame. Uses
822 mg_lock_connection to ensure that the transmission is not interrupted,
823 i.e., when the application is proactively communicating and responding to
824 a request simultaneously.
825
826 Send data to a websocket server wrapped in a masked websocket frame.
827 This function is available when civetweb is compiled with -DUSE_WEBSOCKET
828
829 Return:
830 0 when the connection has been closed
831 -1 on error
832 >0 number of bytes written on success */
834 int opcode,
835 const char *data,
836 size_t data_len);
837
838
839/* Blocks until unique access is obtained to this connection. Intended for use
840 with websockets only.
841 Invoke this before mg_write or mg_printf when communicating with a
842 websocket if your code has server-initiated communication as well as
843 communication in direct response to a message.
844 Do not acquire this lock while holding mg_lock_context(). */
847
848
849/* Lock server context. This lock may be used to protect resources
850 that are shared between different connection/worker threads.
851 If the given context is not server, these functions do nothing. */
852CIVETWEB_API void mg_lock_context(struct mg_context *ctx);
854
855
856/* WebSocket OpcCodes, from http://tools.ietf.org/html/rfc6455 */
857enum {
865
866
867/* Macros for enabling compiler-specific checks for printf-like arguments. */
868#undef PRINTF_FORMAT_STRING
869#if defined(_MSC_VER) && _MSC_VER >= 1400
870#include <sal.h>
871#if defined(_MSC_VER) && _MSC_VER > 1400
872#define PRINTF_FORMAT_STRING(s) _Printf_format_string_ s
873#else
874#define PRINTF_FORMAT_STRING(s) __format_string s
875#endif
876#else
877#define PRINTF_FORMAT_STRING(s) s
878#endif
879
880#ifdef __GNUC__
881#define PRINTF_ARGS(x, y) __attribute__((format(printf, x, y)))
882#else
883#define PRINTF_ARGS(x, y)
884#endif
885
886
887/* Send data to the client using printf() semantics.
888 Works exactly like mg_write(), but allows to do message formatting. */
890 PRINTF_FORMAT_STRING(const char *fmt),
891 ...) PRINTF_ARGS(2, 3);
892
893
894/* Send a part of the message body, if chunked transfer encoding is set.
895 * Only use this function after sending a complete HTTP request or response
896 * header with "Transfer-Encoding: chunked" set. */
898 const char *chunk,
899 unsigned int chunk_len);
900
901
902/* Send contents of the entire file together with HTTP headers.
903 * Parameters:
904 * conn: Current connection information.
905 * path: Full path to the file to send.
906 * This function has been superseded by mg_send_mime_file
907 */
908CIVETWEB_API void mg_send_file(struct mg_connection *conn, const char *path);
909
910
911/* Send contents of the file without HTTP headers.
912 * The code must send a valid HTTP response header before using this function.
913 *
914 * Parameters:
915 * conn: Current connection information.
916 * path: Full path to the file to send.
917 *
918 * Return:
919 * < 0 Error
920 */
922 const char *path);
923
924
925/* Send HTTP error reply. */
927 int status_code,
928 PRINTF_FORMAT_STRING(const char *fmt),
929 ...) PRINTF_ARGS(3, 4);
930
931
932/* Send "HTTP 200 OK" response header.
933 * After calling this function, use mg_write or mg_send_chunk to send the
934 * response body.
935 * Parameters:
936 * conn: Current connection handle.
937 * mime_type: Set Content-Type for the following content.
938 * content_length: Size of the following content, if content_length >= 0.
939 * Will set transfer-encoding to chunked, if set to -1.
940 * Return:
941 * < 0 Error
942 */
944 const char *mime_type,
945 long long content_length);
946
947
948/* Send "HTTP 30x" redirect response.
949 * The response has content-size zero: do not send any body data after calling
950 * this function.
951 * Parameters:
952 * conn: Current connection handle.
953 * target_url: New location.
954 * redirect_code: HTTP redirect type. Could be 301, 302, 303, 307, 308.
955 * Return:
956 * < 0 Error (-1 send error, -2 parameter error)
957 */
959 const char *target_url,
960 int redirect_code);
961
962
963/* Send HTTP digest access authentication request.
964 * Browsers will send a user name and password in their next request, showing
965 * an authentication dialog if the password is not stored.
966 * Parameters:
967 * conn: Current connection handle.
968 * realm: Authentication realm. If NULL is supplied, the sever domain
969 * set in the authentication_domain configuration is used.
970 * Return:
971 * < 0 Error
972 */
973CIVETWEB_API int
975 const char *realm);
976
977
978/* Check if the current request has a valid authentication token set.
979 * A file is used to provide a list of valid user names, realms and
980 * password hashes. The file can be created and modified using the
981 * mg_modify_passwords_file API function.
982 * Parameters:
983 * conn: Current connection handle.
984 * realm: Authentication realm. If NULL is supplied, the sever domain
985 * set in the authentication_domain configuration is used.
986 * filename: Path and name of a file storing multiple password hashes.
987 * Return:
988 * > 0 Valid authentication
989 * 0 Invalid authentication
990 * < 0 Error (all values < 0 should be considered as invalid
991 * authentication, future error codes will have negative
992 * numbers)
993 * -1 Parameter error
994 * -2 File not found
995 */
996CIVETWEB_API int
998 const char *realm,
999 const char *filename);
1000
1001
1002/* Send contents of the entire file together with HTTP headers.
1003 * Parameters:
1004 * conn: Current connection handle.
1005 * path: Full path to the file to send.
1006 * mime_type: Content-Type for file. NULL will cause the type to be
1007 * looked up by the file extension.
1008 */
1010 const char *path,
1011 const char *mime_type);
1012
1013
1014/* Send contents of the entire file together with HTTP headers.
1015 Parameters:
1016 conn: Current connection information.
1017 path: Full path to the file to send.
1018 mime_type: Content-Type for file. NULL will cause the type to be
1019 looked up by the file extension.
1020 additional_headers: Additional custom header fields appended to the header.
1021 Each header should start with an X-, to ensure it is
1022 not included twice.
1023 NULL does not append anything.
1024*/
1026 const char *path,
1027 const char *mime_type,
1028 const char *additional_headers);
1029
1030
1031/* Store body data into a file. */
1032CIVETWEB_API long long mg_store_body(struct mg_connection *conn,
1033 const char *path);
1034/* Read entire request body and store it in a file "path".
1035 Return:
1036 < 0 Error
1037 >= 0 Number of bytes stored in file "path".
1038*/
1039
1040
1041/* Read data from the remote end, return number of bytes read.
1042 Return:
1043 0 connection has been closed by peer. No more data could be read.
1044 < 0 read error. No more data could be read from the connection.
1045 > 0 number of bytes read into the buffer. */
1046CIVETWEB_API int mg_read(struct mg_connection *, void *buf, size_t len);
1047
1048
1049/* Get the value of particular HTTP header.
1050
1051 This is a helper function. It traverses request_info->http_headers array,
1052 and if the header is present in the array, returns its value. If it is
1053 not present, NULL is returned. */
1054CIVETWEB_API const char *mg_get_header(const struct mg_connection *,
1055 const char *name);
1056
1057
1058/* Get a value of particular form variable.
1059
1060 Parameters:
1061 data: pointer to form-uri-encoded buffer. This could be either POST data,
1062 or request_info.query_string.
1063 data_len: length of the encoded data.
1064 var_name: variable name to decode from the buffer
1065 dst: destination buffer for the decoded variable
1066 dst_len: length of the destination buffer
1067
1068 Return:
1069 On success, length of the decoded variable.
1070 On error:
1071 -1 (variable not found).
1072 -2 (destination buffer is NULL, zero length or too small to hold the
1073 decoded variable).
1074
1075 Destination buffer is guaranteed to be '\0' - terminated if it is not
1076 NULL or zero length. */
1077CIVETWEB_API int mg_get_var(const char *data,
1078 size_t data_len,
1079 const char *var_name,
1080 char *dst,
1081 size_t dst_len);
1082
1083
1084/* Get a value of particular form variable.
1085
1086 Parameters:
1087 data: pointer to form-uri-encoded buffer. This could be either POST data,
1088 or request_info.query_string.
1089 data_len: length of the encoded data.
1090 var_name: variable name to decode from the buffer
1091 dst: destination buffer for the decoded variable
1092 dst_len: length of the destination buffer
1093 occurrence: which occurrence of the variable, 0 is the 1st, 1 the 2nd, ...
1094 this makes it possible to parse a query like
1095 b=x&a=y&a=z which will have occurrence values b:0, a:0 and a:1
1096
1097 Return:
1098 On success, length of the decoded variable.
1099 On error:
1100 -1 (variable not found).
1101 -2 (destination buffer is NULL, zero length or too small to hold the
1102 decoded variable).
1103
1104 Destination buffer is guaranteed to be '\0' - terminated if it is not
1105 NULL or zero length. */
1106CIVETWEB_API int mg_get_var2(const char *data,
1107 size_t data_len,
1108 const char *var_name,
1109 char *dst,
1110 size_t dst_len,
1111 size_t occurrence);
1112
1113
1114/* Split form encoded data into a list of key value pairs.
1115 A form encoded input might be a query string, the body of a
1116 x-www-form-urlencoded POST request or any other data with this
1117 structure: "keyName1=value1&keyName2=value2&keyName3=value3".
1118 Values might be percent-encoded - this function will transform
1119 them to the unencoded characters.
1120 The input string is modified by this function: To split the
1121 "query_string" member of struct request_info, create a copy first
1122 (e.g., using strdup).
1123 The function itself does not allocate memory. Thus, it is not
1124 required to free any pointer returned from this function.
1125 The output list of is limited to MG_MAX_FORM_FIELDS name-value-
1126 pairs. The default value is reasonably oversized for typical
1127 applications, however, for special purpose systems it might be
1128 required to increase this value at compile time.
1129
1130 Parameters:
1131 data: form encoded iput string. Will be modified by this function.
1132 form_fields: output list of name/value-pairs. A buffer with a size
1133 specified by num_form_fields must be provided by the
1134 caller.
1135 num_form_fields: Size of provided form_fields buffer in number of
1136 "struct mg_header" elements.
1137
1138 Return:
1139 On success: number of form_fields filled
1140 On error:
1141 -1 (parameter error). */
1143 struct mg_header *form_fields,
1144 unsigned num_form_fields);
1145
1146
1147/* Fetch value of certain cookie variable into the destination buffer.
1148
1149 Destination buffer is guaranteed to be '\0' - terminated. In case of
1150 failure, dst[0] == '\0'. Note that RFC allows many occurrences of the same
1151 parameter. This function returns only first occurrence.
1152
1153 Return:
1154 On success, value length.
1155 On error:
1156 -1 (either "Cookie:" header is not present at all or the requested
1157 parameter is not found).
1158 -2 (destination buffer is NULL, zero length or too small to hold the
1159 value). */
1160CIVETWEB_API int mg_get_cookie(const char *cookie,
1161 const char *var_name,
1162 char *buf,
1163 size_t buf_len);
1164
1165
1166/* Download data from the remote web server.
1167 host: host name to connect to, e.g. "foo.com", or "10.12.40.1".
1168 port: port number, e.g. 80.
1169 use_ssl: whether to use SSL connection.
1170 error_buffer, error_buffer_size: error message placeholder.
1171 request_fmt,...: HTTP request.
1172 Return:
1173 On success, valid pointer to the new connection, suitable for mg_read().
1174 On error, NULL. error_buffer contains error message.
1175 Example:
1176 char ebuf[100];
1177 struct mg_connection *conn;
1178 conn = mg_download("google.com", 80, 0, ebuf, sizeof(ebuf),
1179 "%s", "GET / HTTP/1.0\r\nHost: google.com\r\n\r\n");
1180
1181 mg_download is equivalent to calling mg_connect_client followed by
1182 mg_printf and mg_get_response. Using these three functions directly may
1183 allow more control as compared to using mg_download.
1184 */
1186mg_download(const char *host,
1187 int port,
1188 int use_ssl,
1189 char *error_buffer,
1190 size_t error_buffer_size,
1191 PRINTF_FORMAT_STRING(const char *request_fmt),
1192 ...) PRINTF_ARGS(6, 7);
1193
1194
1195/* Close the connection opened by mg_download(). */
1197
1198
1199/* This structure contains callback functions for handling form fields.
1200 It is used as an argument to mg_handle_form_request. */
1202 /* This callback function is called, if a new field has been found.
1203 * The return value of this callback is used to define how the field
1204 * should be processed.
1205 *
1206 * Parameters:
1207 * key: Name of the field ("name" property of the HTML input field).
1208 * filename: Name of a file to upload, at the client computer.
1209 * Only set for input fields of type "file", otherwise NULL.
1210 * path: Output parameter: File name (incl. path) to store the file
1211 * at the server computer. Only used if FORM_FIELD_STORAGE_STORE
1212 * is returned by this callback. Existing files will be
1213 * overwritten.
1214 * pathlen: Length of the buffer for path.
1215 * user_data: Value of the member user_data of mg_form_data_handler
1216 *
1217 * Return value:
1218 * The callback must return the intended storage for this field
1219 * (See FORM_FIELD_STORAGE_*).
1220 */
1221 int (*field_found)(const char *key,
1222 const char *filename,
1223 char *path,
1224 size_t pathlen,
1225 void *user_data);
1226
1227 /* If the "field_found" callback returned FORM_FIELD_STORAGE_GET,
1228 * this callback will receive the field data.
1229 *
1230 * Parameters:
1231 * key: Name of the field ("name" property of the HTML input field).
1232 * value: Value of the input field.
1233 * user_data: Value of the member user_data of mg_form_data_handler
1234 *
1235 * Return value:
1236 * The return code determines how the server should continue processing
1237 * the current request (See MG_FORM_FIELD_HANDLE_*).
1238 */
1239 int (*field_get)(const char *key,
1240 const char *value,
1241 size_t valuelen,
1242 void *user_data);
1243
1244 /* If the "field_found" callback returned FORM_FIELD_STORAGE_STORE,
1245 * the data will be stored into a file. If the file has been written
1246 * successfully, this callback will be called. This callback will
1247 * not be called for only partially uploaded files. The
1248 * mg_handle_form_request function will either store the file completely
1249 * and call this callback, or it will remove any partial content and
1250 * not call this callback function.
1251 *
1252 * Parameters:
1253 * path: Path of the file stored at the server.
1254 * file_size: Size of the stored file in bytes.
1255 * user_data: Value of the member user_data of mg_form_data_handler
1256 *
1257 * Return value:
1258 * The return code determines how the server should continue processing
1259 * the current request (See MG_FORM_FIELD_HANDLE_*).
1260 */
1261 int (*field_store)(const char *path, long long file_size, void *user_data);
1262
1263 /* User supplied argument, passed to all callback functions. */
1265};
1266
1267
1268/* Return values definition for the "field_found" callback in
1269 * mg_form_data_handler. */
1270enum {
1271 /* Skip this field (neither get nor store it). Continue with the
1272 * next field. */
1274 /* Get the field value. */
1276 /* Store the field value into a file. */
1278 /* Stop parsing this request. Skip the remaining fields. */
1281
1282/* Return values for "field_get" and "field_store" */
1283enum {
1284 /* Only "field_get": If there is more data in this field, get the next
1285 * chunk. Otherwise: handle the next field. */
1287 /* Handle the next field */
1289 /* Stop parsing this request */
1292
1293
1294/* Process form data.
1295 * Returns the number of fields handled, or < 0 in case of an error.
1296 * Note: It is possible that several fields are already handled successfully
1297 * (e.g., stored into files), before the request handling is stopped with an
1298 * error. In this case a number < 0 is returned as well.
1299 * In any case, it is the duty of the caller to remove files once they are
1300 * no longer required. */
1302 struct mg_form_data_handler *fdh);
1303
1304
1305/* Convenience function -- create detached thread.
1306 Return: 0 on success, non-0 on error. */
1307typedef void *(*mg_thread_func_t)(void *);
1309
1310
1311/* Return builtin mime type for the given file name.
1312 For unrecognized extensions, "text/plain" is returned. */
1313CIVETWEB_API const char *mg_get_builtin_mime_type(const char *file_name);
1314
1315
1316/* Get text representation of HTTP status code. */
1317CIVETWEB_API const char *
1318mg_get_response_code_text(const struct mg_connection *conn, int response_code);
1319
1320
1321/* Return CivetWeb version. */
1322CIVETWEB_API const char *mg_version(void);
1323
1324
1325/* URL-decode input buffer into destination buffer.
1326 0-terminate the destination buffer.
1327 form-url-encoded data differs from URI encoding in a way that it
1328 uses '+' as character for space, see RFC 1866 section 8.2.1
1329 http://ftp.ics.uci.edu/pub/ietf/html/rfc1866.txt
1330 Return: length of the decoded data, or -1 if dst buffer is too small. */
1331CIVETWEB_API int mg_url_decode(const char *src,
1332 int src_len,
1333 char *dst,
1334 int dst_len,
1335 int is_form_url_encoded);
1336
1337
1338/* URL-encode input buffer into destination buffer.
1339 returns the length of the resulting buffer or -1
1340 is the buffer is too small. */
1341CIVETWEB_API int mg_url_encode(const char *src, char *dst, size_t dst_len);
1342
1343
1344/* MD5 hash given strings.
1345 Buffer 'buf' must be 33 bytes long. Varargs is a NULL terminated list of
1346 ASCIIz strings. When function returns, buf will contain human-readable
1347 MD5 hash. Example:
1348 char buf[33];
1349 mg_md5(buf, "aa", "bb", NULL); */
1350CIVETWEB_API char *mg_md5(char buf[33], ...);
1351
1352
1353/* Print error message to the opened error log stream.
1354 This utilizes the provided logging configuration.
1355 conn: connection (not used for sending data, but to get perameters)
1356 fmt: format string without the line return
1357 ...: variable argument list
1358 Example:
1359 mg_cry(conn,"i like %s", "logging"); */
1360CIVETWEB_API void mg_cry(const struct mg_connection *conn,
1361 PRINTF_FORMAT_STRING(const char *fmt),
1362 ...) PRINTF_ARGS(2, 3);
1363
1364
1365/* utility methods to compare two buffers, case insensitive. */
1366CIVETWEB_API int mg_strcasecmp(const char *s1, const char *s2);
1367CIVETWEB_API int mg_strncasecmp(const char *s1, const char *s2, size_t len);
1368
1369
1370/* Connect to a websocket as a client
1371 Parameters:
1372 host: host to connect to, i.e. "echo.websocket.org" or "192.168.1.1" or
1373 "localhost"
1374 port: server port
1375 use_ssl: make a secure connection to server
1376 error_buffer, error_buffer_size: buffer for an error message
1377 path: server path you are trying to connect to, i.e. if connection to
1378 localhost/app, path should be "/app"
1379 origin: value of the Origin HTTP header
1380 data_func: callback that should be used when data is received from the
1381 server
1382 user_data: user supplied argument
1383
1384 Return:
1385 On success, valid mg_connection object.
1386 On error, NULL. Se error_buffer for details.
1387*/
1389mg_connect_websocket_client(const char *host,
1390 int port,
1391 int use_ssl,
1392 char *error_buffer,
1393 size_t error_buffer_size,
1394 const char *path,
1395 const char *origin,
1396 mg_websocket_data_handler data_func,
1397 mg_websocket_close_handler close_func,
1398 void *user_data);
1399
1402 int port,
1403 int use_ssl,
1404 char *error_buffer,
1405 size_t error_buffer_size,
1406 const char *path,
1407 const char *origin,
1408 const char *extensions,
1409 mg_websocket_data_handler data_func,
1410 mg_websocket_close_handler close_func,
1411 void *user_data);
1412
1413
1414/* Connect to a TCP server as a client (can be used to connect to a HTTP server)
1415 Parameters:
1416 host: host to connect to, i.e. "www.wikipedia.org" or "192.168.1.1" or
1417 "localhost"
1418 port: server port
1419 use_ssl: make a secure connection to server
1420 error_buffer, error_buffer_size: buffer for an error message
1421
1422 Return:
1423 On success, valid mg_connection object.
1424 On error, NULL. Se error_buffer for details.
1425*/
1426CIVETWEB_API struct mg_connection *mg_connect_client(const char *host,
1427 int port,
1428 int use_ssl,
1429 char *error_buffer,
1430 size_t error_buffer_size);
1431
1432
1434 const char *host;
1435 int port;
1436 const char *client_cert;
1437 const char *server_cert;
1438 const char *host_name;
1439 /* TODO: add more data */
1440};
1441
1442
1444mg_connect_client_secure(const struct mg_client_options *client_options,
1445 char *error_buffer,
1446 size_t error_buffer_size);
1447
1448
1450 const struct mg_client_options *client_options,
1451 char *error_buffer,
1452 size_t error_buffer_size,
1453 const char *path,
1454 const char *origin,
1455 mg_websocket_data_handler data_func,
1456 mg_websocket_close_handler close_func,
1457 void *user_data);
1458
1461 const struct mg_client_options *client_options,
1462 char *error_buffer,
1463 size_t error_buffer_size,
1464 const char *path,
1465 const char *origin,
1466 const char *extensions,
1467 mg_websocket_data_handler data_func,
1468 mg_websocket_close_handler close_func,
1469 void *user_data);
1470
1471#if defined(MG_LEGACY_INTERFACE) /* 2019-11-02 */
1472enum { TIMEOUT_INFINITE = -1 };
1473#endif
1475
1476
1477/* Wait for a response from the server
1478 Parameters:
1479 conn: connection
1480 ebuf, ebuf_len: error message placeholder.
1481 timeout: time to wait for a response in milliseconds (if < 0 then wait
1482 forever)
1483
1484 Return:
1485 On success, >= 0
1486 On error/timeout, < 0
1487*/
1489 char *ebuf,
1490 size_t ebuf_len,
1491 int timeout);
1492
1493
1494/* mg_response_header_* functions can be used from server callbacks
1495 * to prepare HTTP server response headers. Using this function will
1496 * allow a callback to work with HTTP/1.x and HTTP/2.
1497 */
1498
1499/* Initialize a new HTTP response
1500 * Parameters:
1501 * conn: Current connection handle.
1502 * status: HTTP status code (e.g., 200 for "OK").
1503 * Return:
1504 * 0: ok
1505 * -1: parameter error
1506 * -2: invalid connection type
1507 * -3: invalid connection status
1508 */
1510 int status);
1511
1512
1513/* Add a new HTTP response header line
1514 * Parameters:
1515 * conn: Current connection handle.
1516 * header: Header name.
1517 * value: Header value.
1518 * value_len: Length of header value, excluding the terminating zero.
1519 * Use -1 for "strlen(value)".
1520 * Return:
1521 * 0: ok
1522 * -1: parameter error
1523 * -2: invalid connection type
1524 * -3: invalid connection status
1525 * -4: too many headers
1526 * -5: out of memory
1527 */
1529 const char *header,
1530 const char *value,
1531 int value_len);
1532
1533
1534/* Add a complete header string (key + value).
1535 * This function is less efficient as compared to mg_response_header_add,
1536 * and should only be used to convert complete HTTP/1.x header lines.
1537 * Parameters:
1538 * conn: Current connection handle.
1539 * http1_headers: Header line(s) in the form "name: value\r\n".
1540 * Return:
1541 * >=0: no error, number of header lines added
1542 * -1: parameter error
1543 * -2: invalid connection type
1544 * -3: invalid connection status
1545 * -4: too many headers
1546 * -5: out of memory
1547 */
1549 const char *http1_headers);
1550
1551
1552/* Send http response
1553 * Parameters:
1554 * conn: Current connection handle.
1555 * Return:
1556 * 0: ok
1557 * -1: parameter error
1558 * -2: invalid connection type
1559 * -3: invalid connection status
1560 */
1562
1563
1564/* Check which features where set when the civetweb library has been compiled.
1565 The function explicitly addresses compile time defines used when building
1566 the library - it does not mean, the feature has been initialized using a
1567 mg_init_library call.
1568 mg_check_feature can be called anytime, even before mg_init_library has
1569 been called.
1570
1571 Parameters:
1572 feature: specifies which feature should be checked
1573 The value is a bit mask. The individual bits are defined as:
1574 1 serve files (NO_FILES not set)
1575 2 support HTTPS (NO_SSL not set)
1576 4 support CGI (NO_CGI not set)
1577 8 support IPv6 (USE_IPV6 set)
1578 16 support WebSocket (USE_WEBSOCKET set)
1579 32 support Lua scripts and Lua server pages (USE_LUA is set)
1580 64 support server side JavaScript (USE_DUKTAPE is set)
1581 128 support caching (NO_CACHING not set)
1582 256 support server statistics (USE_SERVER_STATS is set)
1583 512 support for on the fly compression (USE_ZLIB is set)
1584
1585 These values are defined as MG_FEATURES_*
1586
1587 The result is undefined, if bits are set that do not represent a
1588 defined feature (currently: feature >= 1024).
1589 The result is undefined, if no bit is set (feature == 0).
1590
1591 Return:
1592 If a feature is available, the corresponding bit is set
1593 If a feature is not available, the bit is 0
1594*/
1595CIVETWEB_API unsigned mg_check_feature(unsigned feature);
1596
1597
1598/* Get information on the system. Useful for support requests.
1599 Parameters:
1600 buffer: Store system information as string here.
1601 buflen: Length of buffer (including a byte required for a terminating 0).
1602 Return:
1603 Available size of system information, exluding a terminating 0.
1604 The information is complete, if the return value is smaller than buflen.
1605 The result is a JSON formatted string, the exact content may vary.
1606 Note:
1607 It is possible to determine the required buflen, by first calling this
1608 function with buffer = NULL and buflen = NULL. The required buflen is
1609 one byte more than the returned value.
1610*/
1611CIVETWEB_API int mg_get_system_info(char *buffer, int buflen);
1612
1613
1614/* Get context information. Useful for server diagnosis.
1615 Parameters:
1616 ctx: Context handle
1617 buffer: Store context information here.
1618 buflen: Length of buffer (including a byte required for a terminating 0).
1619 Return:
1620 Available size of system information, exluding a terminating 0.
1621 The information is complete, if the return value is smaller than buflen.
1622 The result is a JSON formatted string, the exact content may vary.
1623 Note:
1624 It is possible to determine the required buflen, by first calling this
1625 function with buffer = NULL and buflen = NULL. The required buflen is
1626 one byte more than the returned value. However, since the available
1627 context information changes, you should allocate a few bytes more.
1628*/
1629CIVETWEB_API int
1630mg_get_context_info(const struct mg_context *ctx, char *buffer, int buflen);
1631
1632
1633/* Disable HTTP keep-alive on a per-connection basis.
1634 Reference: https://github.com/civetweb/civetweb/issues/727
1635 Parameters:
1636 conn: Current connection handle.
1637*/
1639
1640
1641#if defined(MG_EXPERIMENTAL_INTERFACES)
1642/* Get connection information. Useful for server diagnosis.
1643 Parameters:
1644 ctx: Context handle
1645 idx: Connection index
1646 buffer: Store context information here.
1647 buflen: Length of buffer (including a byte required for a terminating 0).
1648 Return:
1649 Available size of system information, exluding a terminating 0.
1650 The information is complete, if the return value is smaller than buflen.
1651 The result is a JSON formatted string, the exact content may vary.
1652 Note:
1653 It is possible to determine the required buflen, by first calling this
1654 function with buffer = NULL and buflen = NULL. The required buflen is
1655 one byte more than the returned value. However, since the available
1656 context information changes, you should allocate a few bytes more.
1657*/
1658CIVETWEB_API int mg_get_connection_info(const struct mg_context *ctx,
1659 int idx,
1660 char *buffer,
1661 int buflen);
1662#endif
1663
1664
1665/* New APIs for enhanced option and error handling.
1666 These mg_*2 API functions have the same purpose as their original versions,
1667 but provide additional options and/or provide improved error diagnostics.
1668
1669 Note: Experimental interfaces may change
1670*/
1672 unsigned *code; /* error code (number) */
1673 char *text; /* buffer for error text */
1674 size_t text_buffer_size; /* size of buffer of "text" */
1675};
1676
1678 const struct mg_callbacks *callbacks; /* callback function pointer */
1679 void *user_data; /* data */
1681};
1682
1683
1684#if defined(MG_EXPERIMENTAL_INTERFACES)
1685
1687mg_connect_client2(const char *host,
1688 const char *protocol,
1689 int port,
1690 const char *path,
1691 struct mg_init_data *init,
1692 struct mg_error_data *error);
1693
1694CIVETWEB_API int mg_get_response2(struct mg_connection *conn,
1695 struct mg_error_data *error,
1696 int timeout);
1697#endif
1698
1699
1700CIVETWEB_API struct mg_context *mg_start2(struct mg_init_data *init,
1701 struct mg_error_data *error);
1702
1704 const char **configuration_options,
1705 struct mg_error_data *error);
1706
1707
1708#ifdef __cplusplus
1709}
1710#endif /* __cplusplus */
1711
1712#endif /* CIVETWEB_HEADER_INCLUDED */
#define f(i)
Definition RSha256.hxx:104
#define s1(x)
Definition RSha256.hxx:91
size_t size(const MatrixT &matrix)
retrieve the size of a square matrix
winID h TVirtualViewer3D TVirtualGLPainter p
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t Int_t Int_t Window_t TString Int_t GCValues_t GetPrimarySelectionOwner GetDisplay GetScreen GetColormap GetNativeEvent const char const char dpyName wid window const char font_name cursor keysym reg const char only_if_exist regb h Point_t winding char text const char depth char const char Int_t count const char ColorStruct_t color const char filename
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void data
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void value
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t WindowAttributes_t Float_t Float_t Float_t Int_t Int_t UInt_t UInt_t Rectangle_t Int_t Int_t Window_t TString Int_t GCValues_t GetPrimarySelectionOwner GetDisplay GetScreen GetColormap GetNativeEvent const char const char dpyName wid window const char font_name cursor keysym reg const char only_if_exist regb h Point_t winding char text const char depth char const char Int_t count const char ColorStruct_t color const char Pixmap_t Pixmap_t PictureAttributes_t attr const char char ret_data h unsigned char height h Atom_t Int_t ULong_t ULong_t unsigned char prop_list Atom_t Atom_t Atom_t Time_t UChar_t len
Option_t Option_t TPoint TPoint const char GetTextMagnitude GetFillStyle GetLineColor GetLineWidth GetMarkerStyle GetTextAlign GetTextColor GetTextSize void char Point_t Rectangle_t src
char name[80]
Definition TGX11.cxx:110
const char * mime_type
Definition civetweb.c:8028
#define mg_get_option
Definition civetweb.c:3150
#define mg_cry
Definition civetweb.c:3477
void mg_send_mime_file2(struct mg_connection *conn, const char *path, const char *mime_type, const char *additional_headers)
Definition civetweb.c:10222
int mg_websocket_client_write(struct mg_connection *conn, int opcode, const char *data, size_t data_len)
int mg_strncasecmp(const char *s1, const char *s2, size_t len)
Definition civetweb.c:2984
#define MG_MAX_HEADERS
Definition civetweb.h:141
int mg_read(struct mg_connection *, void *buf, size_t len)
Definition civetweb.c:6588
void mg_unlock_connection(struct mg_connection *conn)
Definition civetweb.c:12315
const struct mg_option * mg_get_valid_options(void)
Definition civetweb.c:2798
int mg_response_header_add(struct mg_connection *conn, const char *header, const char *value, int value_len)
Definition response.inl:120
void *(* mg_thread_func_t)(void *)
Definition civetweb.h:1307
int mg_write(struct mg_connection *, const void *buf, size_t len)
Definition civetweb.c:6696
void mg_lock_context(struct mg_context *ctx)
Definition civetweb.c:12323
int mg_response_header_send(struct mg_connection *conn)
Definition response.inl:259
const struct mg_request_info * mg_get_request_info(const struct mg_connection *)
Definition civetweb.c:3488
int mg_send_http_redirect(struct mg_connection *conn, const char *target_url, int redirect_code)
Definition civetweb.c:4592
int mg_websocket_write(struct mg_connection *conn, int opcode, const char *data, size_t data_len)
struct mg_connection * mg_connect_websocket_client_secure(const struct mg_client_options *client_options, char *error_buffer, size_t error_buffer_size, const char *path, const char *origin, mg_websocket_data_handler data_func, mg_websocket_close_handler close_func, void *user_data)
Definition civetweb.c:18395
#define PRINTF_FORMAT_STRING(s)
Definition civetweb.h:877
int mg_get_server_ports(const struct mg_context *ctx, int size, struct mg_server_port *ports)
Definition civetweb.c:3213
int mg_get_var2(const char *data, size_t data_len, const char *var_name, char *dst, size_t dst_len, size_t occurrence)
Definition civetweb.c:7002
void mg_disable_connection_keep_alive(struct mg_connection *conn)
Definition civetweb.c:21110
struct mg_connection * mg_connect_client_secure(const struct mg_client_options *client_options, char *error_buffer, size_t error_buffer_size)
Definition civetweb.c:17414
int mg_send_http_ok(struct mg_connection *conn, const char *mime_type, long long content_length)
Definition civetweb.c:4551
void mg_send_file(struct mg_connection *conn, const char *path)
Definition civetweb.c:10206
int(* mg_authorization_handler)(struct mg_connection *conn, void *cbdata)
Definition civetweb.h:606
const char * mg_get_response_code_text(const struct mg_connection *conn, int response_code)
Definition civetweb.c:4152
const char * mg_get_header(const struct mg_connection *, const char *name)
Definition civetweb.c:3802
int mg_send_http_error(struct mg_connection *conn, int status_code, const char *fmt,...)
Definition civetweb.c:4537
@ MG_CONFIG_TYPE_UNKNOWN
Definition civetweb.h:694
@ MG_CONFIG_TYPE_FILE
Definition civetweb.h:697
@ MG_CONFIG_TYPE_STRING
Definition civetweb.h:696
@ MG_CONFIG_TYPE_DIRECTORY
Definition civetweb.h:698
@ MG_CONFIG_TYPE_EXT_PATTERN
Definition civetweb.h:700
@ MG_CONFIG_TYPE_STRING_MULTILINE
Definition civetweb.h:702
@ MG_CONFIG_TYPE_STRING_LIST
Definition civetweb.h:701
@ MG_CONFIG_TYPE_YES_NO_OPTIONAL
Definition civetweb.h:703
@ MG_CONFIG_TYPE_NUMBER
Definition civetweb.h:695
@ MG_CONFIG_TYPE_BOOLEAN
Definition civetweb.h:699
@ MG_FEATURES_HTTP2
Definition civetweb.h:102
@ MG_FEATURES_ALL
Definition civetweb.h:108
@ MG_FEATURES_STATS
Definition civetweb.h:95
@ MG_FEATURES_CACHE
Definition civetweb.h:91
@ MG_FEATURES_FILES
Definition civetweb.h:61
@ MG_FEATURES_CGI
Definition civetweb.h:71
@ MG_FEATURES_IPV6
Definition civetweb.h:75
@ MG_FEATURES_DEFAULT
Definition civetweb.h:57
@ MG_FEATURES_TLS
Definition civetweb.h:66
@ MG_FEATURES_X_DOMAIN_SOCKET
Definition civetweb.h:105
@ MG_FEATURES_SSL
Definition civetweb.h:67
@ MG_FEATURES_LUA
Definition civetweb.h:83
@ MG_FEATURES_WEBSOCKET
Definition civetweb.h:79
@ MG_FEATURES_SSJS
Definition civetweb.h:87
@ MG_FEATURES_COMPRESSION
Definition civetweb.h:99
struct mg_context * mg_start2(struct mg_init_data *init, struct mg_error_data *error)
Definition civetweb.c:19613
void * mg_get_user_context_data(const struct mg_connection *conn)
Definition civetweb.c:3167
long long mg_store_body(struct mg_connection *conn, const char *path)
Definition civetweb.c:10318
int mg_get_response(struct mg_connection *conn, char *ebuf, size_t ebuf_len, int timeout)
Definition civetweb.c:17980
@ MG_WEBSOCKET_OPCODE_CONNECTION_CLOSE
Definition civetweb.h:861
@ MG_WEBSOCKET_OPCODE_BINARY
Definition civetweb.h:860
@ MG_WEBSOCKET_OPCODE_PONG
Definition civetweb.h:863
@ MG_WEBSOCKET_OPCODE_TEXT
Definition civetweb.h:859
@ MG_WEBSOCKET_OPCODE_CONTINUATION
Definition civetweb.h:858
@ MG_WEBSOCKET_OPCODE_PING
Definition civetweb.h:862
unsigned mg_check_feature(unsigned feature)
Definition civetweb.c:20497
void(* mg_websocket_ready_handler)(struct mg_connection *, void *)
Definition civetweb.h:549
#define CIVETWEB_API
Definition civetweb.h:43
@ MG_TIMEOUT_INFINITE
Definition civetweb.h:1474
void mg_set_websocket_handler(struct mg_context *ctx, const char *uri, mg_websocket_connect_handler connect_handler, mg_websocket_ready_handler ready_handler, mg_websocket_data_handler data_handler, mg_websocket_close_handler close_handler, void *cbdata)
Definition civetweb.c:13797
int mg_get_var(const char *data, size_t data_len, const char *var_name, char *dst, size_t dst_len)
Definition civetweb.c:6991
int mg_start_thread(mg_thread_func_t f, void *p)
Definition civetweb.c:5671
void mg_unlock_context(struct mg_context *ctx)
Definition civetweb.c:12331
unsigned mg_init_library(unsigned features)
Definition civetweb.c:21374
struct mg_connection * mg_connect_client(const char *host, int port, int use_ssl, char *error_buffer, size_t error_buffer_size)
Definition civetweb.c:17426
int mg_response_header_add_lines(struct mg_connection *conn, const char *http1_headers)
Definition response.inl:209
int mg_start_domain2(struct mg_context *ctx, const char **configuration_options, struct mg_error_data *error)
Definition civetweb.c:20300
void mg_send_mime_file(struct mg_connection *conn, const char *path, const char *mime_type)
Definition civetweb.c:10213
int mg_handle_form_request(struct mg_connection *conn, struct mg_form_data_handler *fdh)
int mg_split_form_urlencoded(char *data, struct mg_header *form_fields, unsigned num_form_fields)
Definition civetweb.c:7060
void mg_set_user_connection_data(const struct mg_connection *conn, void *data)
Definition civetweb.c:3190
const struct mg_response_info * mg_get_response_info(const struct mg_connection *)
Definition civetweb.c:3528
unsigned mg_exit_library(void)
Definition civetweb.c:21478
int mg_send_digest_access_authentication_request(struct mg_connection *conn, const char *realm)
Definition civetweb.c:8773
struct mg_connection * mg_connect_websocket_client(const char *host, int port, int use_ssl, char *error_buffer, size_t error_buffer_size, const char *path, const char *origin, mg_websocket_data_handler data_func, mg_websocket_close_handler close_func, void *user_data)
Definition civetweb.c:18365
struct mg_context * mg_start(const struct mg_callbacks *callbacks, void *user_data, const char **configuration_options)
Definition civetweb.c:20285
char * mg_md5(char buf[33],...)
Definition civetweb.c:8208
int mg_get_request_link(const struct mg_connection *conn, char *buf, size_t buflen)
Definition civetweb.c:3689
int mg_url_encode(const char *src, char *dst, size_t dst_len)
Definition civetweb.c:9262
struct mg_connection * mg_connect_websocket_client_extensions(const char *host, int port, int use_ssl, char *error_buffer, size_t error_buffer_size, const char *path, const char *origin, const char *extensions, mg_websocket_data_handler data_func, mg_websocket_close_handler close_func, void *user_data)
Definition civetweb.c:18421
int mg_url_decode(const char *src, int src_len, char *dst, int dst_len, int is_form_url_encoded)
Definition civetweb.c:6951
int mg_start_domain(struct mg_context *ctx, const char **configuration_options)
Definition civetweb.c:20489
#define PRINTF_ARGS(x, y)
Definition civetweb.h:883
struct mg_connection * mg_connect_websocket_client_secure_extensions(const struct mg_client_options *client_options, char *error_buffer, size_t error_buffer_size, const char *path, const char *origin, const char *extensions, mg_websocket_data_handler data_func, mg_websocket_close_handler close_func, void *user_data)
Definition civetweb.c:18451
@ MG_FORM_FIELD_STORAGE_GET
Definition civetweb.h:1275
@ MG_FORM_FIELD_STORAGE_ABORT
Definition civetweb.h:1279
@ MG_FORM_FIELD_STORAGE_STORE
Definition civetweb.h:1277
@ MG_FORM_FIELD_STORAGE_SKIP
Definition civetweb.h:1273
void mg_close_connection(struct mg_connection *conn)
Definition civetweb.c:17154
int mg_modify_passwords_file_ha1(const char *passwords_file_name, const char *realm, const char *user, const char *ha1)
Definition civetweb.c:8937
void * mg_get_user_connection_data(const struct mg_connection *conn)
Definition civetweb.c:3203
@ MG_FORM_FIELD_HANDLE_NEXT
Definition civetweb.h:1288
@ MG_FORM_FIELD_HANDLE_GET
Definition civetweb.h:1286
@ MG_FORM_FIELD_HANDLE_ABORT
Definition civetweb.h:1290
const char * mg_get_builtin_mime_type(const char *file_name)
Definition civetweb.c:8136
int mg_send_chunk(struct mg_connection *conn, const char *chunk, unsigned int chunk_len)
Definition civetweb.c:6777
int(* mg_websocket_data_handler)(struct mg_connection *, int, char *, size_t, void *)
Definition civetweb.h:550
void mg_set_auth_handler(struct mg_context *ctx, const char *uri, mg_authorization_handler handler, void *cbdata)
Definition civetweb.c:13847
int(* mg_request_handler)(struct mg_connection *conn, void *cbdata)
Definition civetweb.h:492
int mg_get_context_info(const struct mg_context *ctx, char *buffer, int buflen)
Definition civetweb.c:20911
void * mg_get_thread_pointer(const struct mg_connection *conn)
Definition civetweb.c:3174
int mg_get_cookie(const char *cookie, const char *var_name, char *buf, size_t buf_len)
Definition civetweb.c:7159
int mg_response_header_start(struct mg_connection *conn, int status)
Definition response.inl:73
void(* mg_websocket_close_handler)(const struct mg_connection *, void *)
Definition civetweb.h:555
int mg_strcasecmp(const char *s1, const char *s2)
Definition civetweb.c:2999
void mg_set_request_handler(struct mg_context *ctx, const char *uri, mg_request_handler handler, void *cbdata)
Definition civetweb.c:13775
void mg_stop(struct mg_context *)
Definition civetweb.c:19494
int mg_check_digest_access_authentication(struct mg_connection *conn, const char *realm, const char *filename)
Definition civetweb.c:8644
int(* mg_websocket_connect_handler)(const struct mg_connection *, void *)
Definition civetweb.h:547
struct mg_connection * mg_download(const char *host, int port, int use_ssl, char *error_buffer, size_t error_buffer_size, const char *request_fmt,...)
Definition civetweb.c:18032
int mg_get_system_info(char *buffer, int buflen)
Definition civetweb.c:20579
struct mg_context * mg_get_context(const struct mg_connection *conn)
Definition civetweb.c:3153
void mg_set_websocket_handler_with_subprotocols(struct mg_context *ctx, const char *uri, struct mg_websocket_subprotocols *subprotocols, mg_websocket_connect_handler connect_handler, mg_websocket_ready_handler ready_handler, mg_websocket_data_handler data_handler, mg_websocket_close_handler close_handler, void *cbdata)
Definition civetweb.c:13817
int mg_modify_passwords_file(const char *passwords_file_name, const char *realm, const char *user, const char *password)
Definition civetweb.c:8927
int mg_printf(struct mg_connection *, const char *fmt,...)
Definition civetweb.c:6937
void * mg_get_user_data(const struct mg_context *ctx)
Definition civetweb.c:3160
const char * mg_version(void)
Definition civetweb.c:3481
void mg_lock_connection(struct mg_connection *conn)
Definition civetweb.c:12307
int mg_send_file_body(struct mg_connection *conn, const char *path)
Definition civetweb.c:10147
int(* init_ssl)(void *ssl_ctx, void *user_data)
Definition civetweb.h:254
int(* log_message)(const struct mg_connection *, const char *message)
Definition civetweb.h:240
void(* exit_lua)(const struct mg_connection *conn, void *lua_context, unsigned context_flags)
Definition civetweb.h:345
void(* end_request)(const struct mg_connection *, int reply_status_code)
Definition civetweb.h:236
int(* init_connection)(const struct mg_connection *conn, void **conn_data)
Definition civetweb.h:417
void(* connection_close)(const struct mg_connection *)
Definition civetweb.h:320
int(* http_error)(struct mg_connection *conn, int status, const char *errmsg)
Definition civetweb.h:359
void(* exit_context)(const struct mg_context *ctx)
Definition civetweb.h:372
int(* init_ssl_domain)(const char *server_domain, void *ssl_ctx, void *user_data)
Definition civetweb.h:265
int(* external_ssl_ctx)(void **ssl_ctx, void *user_data)
Definition civetweb.h:278
void(* exit_thread)(const struct mg_context *ctx, int thread_type, void *thread_pointer)
Definition civetweb.h:400
int(* begin_request)(struct mg_connection *)
Definition civetweb.h:233
int(* log_access)(const struct mg_connection *, const char *message)
Definition civetweb.h:244
void(* init_context)(const struct mg_context *ctx)
Definition civetweb.h:367
void(* connection_closed)(const struct mg_connection *)
Definition civetweb.h:330
void(* init_lua)(const struct mg_connection *conn, void *lua_context, unsigned context_flags)
Definition civetweb.h:342
int(* external_ssl_ctx_domain)(const char *server_domain, void **ssl_ctx, void *user_data)
Definition civetweb.h:290
const char * issuer
Definition civetweb.h:209
const char * finger
Definition civetweb.h:211
void * peer_cert
Definition civetweb.h:207
const char * subject
Definition civetweb.h:208
const char * serial
Definition civetweb.h:210
const char * host_name
Definition civetweb.h:1438
const char * client_cert
Definition civetweb.h:1436
const char * server_cert
Definition civetweb.h:1437
const char * host
Definition civetweb.h:1434
void * user_data
Definition civetweb.c:2397
struct mg_callbacks callbacks
Definition civetweb.c:2396
unsigned * code
Definition civetweb.h:1672
size_t text_buffer_size
Definition civetweb.h:1674
const char * value
Definition civetweb.h:145
const char * name
Definition civetweb.h:144
void * user_data
Definition civetweb.h:1679
const struct mg_callbacks * callbacks
Definition civetweb.h:1678
const char ** configuration_options
Definition civetweb.h:1680
const char * default_value
Definition civetweb.h:688
const char * name
Definition civetweb.h:686
struct mg_header http_headers[(64)]
Definition civetweb.h:179
const char * local_uri
Definition civetweb.h:157
void * user_data
Definition civetweb.h:175
const char * local_uri_raw
Definition civetweb.h:154
const char * request_method
Definition civetweb.h:151
struct mg_client_cert * client_cert
Definition civetweb.h:182
const char * query_string
Definition civetweb.h:162
long long content_length
Definition civetweb.h:168
void * conn_data
Definition civetweb.h:176
char remote_addr[48]
Definition civetweb.h:166
const char * http_version
Definition civetweb.h:161
const char * request_uri
Definition civetweb.h:152
const char * acceptedWebSocketSubprotocol
Definition civetweb.h:184
const char * remote_user
Definition civetweb.h:164
struct mg_header http_headers[(64)]
Definition civetweb.h:200
long long content_length
Definition civetweb.h:196
const char * http_version
Definition civetweb.h:194
const char * status_text
Definition civetweb.h:193
const char ** subprotocols
Definition civetweb.h:564