mongoose/docs/c-api/net.h/struct_mg_connect_opts.md
Deomid Ryabkov bafc30bec6 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-13 18:07:25 +00:00

1.3 KiB

title decl_name symbol_kind signature
struct mg_connect_opts struct mg_connect_opts struct 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 */ #if MG_ENABLE_SSL /* SSL settings. */ const char *ssl_cert; /* Client certificate to present to the server */ const char *ssl_key; /* Private key corresponding to the certificate. If ssl_cert is set but ssl_key is not, ssl_cert is used. */ 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. */ /* * 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()