2016-05-12 04:36:12 +08:00
|
|
|
---
|
|
|
|
title: "struct mg_connect_opts"
|
|
|
|
decl_name: "struct mg_connect_opts"
|
|
|
|
symbol_kind: "struct"
|
|
|
|
signature: |
|
|
|
|
struct mg_connect_opts {
|
|
|
|
void *user_data; /* Initial value for connection's user_data */
|
|
|
|
unsigned int flags; /* Extra connection flags */
|
|
|
|
const char **error_string; /* Placeholder for the error string */
|
2016-11-09 22:48:49 +08:00
|
|
|
struct mg_iface *iface; /* Interface instance */
|
Change from using #ifdef to #if for features tests
"#if FOO" still works with simple -DFOO, but gives more flexibility.
Specifically, if user expressed no preference (FOO is not defined),
we can apply reasonable defaults (this is the legitimate use of ifdef).
In short, from now on, please use
#if MG_ENABLE_FOO
instead of
#ifdef MG_ENABLE_FOO
Since we are all used to #ifdef, this change also adds a precommit check
to police this. Specifically, in *.h and *.c files that are Copyright Cesanta,
"ifdef" and "if defined()" are not allowed to be used with macros that contain
ENABLE or DISABLE, unless the like also contains "ifdef-ok".
Hence, if you are sure you want to use ifdef, use this:
#ifdef MG_ENABLE_FOO /* ifdef-ok */
PUBLISHED_FROM=9be829448f53cff575d6cae8b9945fb12531c15a
2016-10-14 01:55:08 +08:00
|
|
|
#if MG_ENABLE_SSL
|
2016-05-12 04:36:12 +08:00
|
|
|
/* SSL settings. */
|
|
|
|
const char *ssl_cert; /* Client certificate to present to the server */
|
2016-06-09 19:00:14 +08:00
|
|
|
const char *ssl_key; /* Private key corresponding to the certificate.
|
|
|
|
If ssl_cert is set but ssl_key is not, ssl_cert
|
|
|
|
is used. */
|
2016-07-14 21:17:45 +08:00
|
|
|
const char *ssl_ca_cert; /* Verify server certificate using this CA bundle.
|
|
|
|
If set to "*", then SSL is enabled but no cert
|
|
|
|
verification is performed. */
|
2016-05-12 04:36:12 +08:00
|
|
|
|
|
|
|
/*
|
|
|
|
* Server name verification. If ssl_ca_cert is set and the certificate has
|
|
|
|
* passed verification, its subject will be verified against this string.
|
|
|
|
* By default (if ssl_server_name is NULL) hostname part of the address will
|
|
|
|
* be used. Wildcard matching is supported. A special value of "*" disables
|
|
|
|
* name verification.
|
|
|
|
*/
|
|
|
|
const char *ssl_server_name;
|
|
|
|
#endif
|
|
|
|
};
|
|
|
|
---
|
|
|
|
|
|
|
|
Optional parameters to `mg_connect_opt()`
|
|
|
|
|