From: Anurag Kar Date: Thu, 22 Nov 2018 10:27:05 +0000 (+0530) Subject: Docs : esp_https_server API references corrected X-Git-Tag: v3.3-beta1~79^2 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=684f0b0a32f3e2e6a0b3a3f13b69122c7026ed2a;p=esp-idf Docs : esp_https_server API references corrected --- diff --git a/docs/en/api-reference/protocols/esp_https_server.rst b/docs/en/api-reference/protocols/esp_https_server.rst index 714afec3fc..7cd4627d8b 100644 --- a/docs/en/api-reference/protocols/esp_https_server.rst +++ b/docs/en/api-reference/protocols/esp_https_server.rst @@ -13,20 +13,19 @@ Used APIs The following API of `esp_http_server` should not be used with `esp_https_server`, as they are used internally to handle secure sessions and to maintain internal state: -- "send", "receive" and "pending" function overrides - secure socket handling - - :cpp:func:`httpd_set_sess_send_override` - - :cpp:func:`httpd_set_sess_recv_override` - - :cpp:func:`httpd_set_sess_pending_override` - - :cpp:func:`httpd_set_send_override` - - :cpp:func:`httpd_set_recv_override` - - :cpp:func:`httpd_set_pending_override` -- "transport context" - both global and session - - :cpp:func:`httpd_sess_get_transport_ctx` - returns SSL used for the session - - :cpp:func:`httpd_sess_set_transport_ctx` - - :cpp:func:`httpd_get_global_transport_ctx` - returns the shared SSL context - - :c:member:`httpd_config_t.global_transport_ctx` - - :c:member:`httpd_config_t.global_transport_ctx_free_fn` - - :c:member:`httpd_config_t.open_fn` - used to set up secure sockets +* "send", "receive" and "pending" function overrides - secure socket handling + + * :cpp:func:`httpd_sess_set_send_override` + * :cpp:func:`httpd_sess_set_recv_override` + * :cpp:func:`httpd_sess_set_pending_override` +* "transport context" - both global and session + + * :cpp:func:`httpd_sess_get_transport_ctx` - returns SSL used for the session + * :cpp:func:`httpd_sess_set_transport_ctx` + * :cpp:func:`httpd_get_global_transport_ctx` - returns the shared SSL context + * :c:member:`httpd_config_t.global_transport_ctx` + * :c:member:`httpd_config_t.global_transport_ctx_free_fn` + * :c:member:`httpd_config_t.open_fn` - used to set up secure sockets Everything else can be used without limitations. @@ -37,7 +36,7 @@ Please see the example :example:`protocols/https_server` to learn how to set up Basically all you need is to generate a certificate, embed it in the firmware, and provide its pointers and lengths to the start function via the init struct. -The server can be started with or without SSL by changing a flag in the init struct. This could be used e.g. for testing or in trusted environments where you prefer speed over security. +The server can be started with or without SSL by changing a flag in the init struct - :c:member:`httpd_ssl_config.transport_mode`. This could be used e.g. for testing or in trusted environments where you prefer speed over security. Performance -----------