123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331 |
- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
- <html xmlns="http://www.w3.org/1999/xhtml">
- <head>
- <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
- <meta http-equiv="X-UA-Compatible" content="IE=9"/>
- <meta name="generator" content="Doxygen 1.8.17"/>
- <meta name="viewport" content="width=device-width, initial-scale=1"/>
- <title>MQTT C Client Libraries Internals: MQTTClient_SSLOptions Struct Reference</title>
- <link href="tabs.css" rel="stylesheet" type="text/css"/>
- <script type="text/javascript" src="jquery.js"></script>
- <script type="text/javascript" src="dynsections.js"></script>
- <link href="search/search.css" rel="stylesheet" type="text/css"/>
- <script type="text/javascript" src="search/searchdata.js"></script>
- <script type="text/javascript" src="search/search.js"></script>
- <link href="doxygen.css" rel="stylesheet" type="text/css" />
- </head>
- <body>
- <div id="top"><!-- do not remove this div, it is closed by doxygen! -->
- <div id="titlearea">
- <table cellspacing="0" cellpadding="0">
- <tbody>
- <tr style="height: 56px;">
- <td id="projectlogo"><img alt="Logo" src="pahologo.png"/></td>
- <td id="projectalign" style="padding-left: 0.5em;">
- <div id="projectname">MQTT C Client Libraries Internals
- </div>
- </td>
- </tr>
- </tbody>
- </table>
- </div>
- <!-- end header part -->
- <!-- Generated by Doxygen 1.8.17 -->
- <script type="text/javascript">
- /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
- var searchBox = new SearchBox("searchBox", "search",false,'Search');
- /* @license-end */
- </script>
- <script type="text/javascript" src="menudata.js"></script>
- <script type="text/javascript" src="menu.js"></script>
- <script type="text/javascript">
- /* @license magnet:?xt=urn:btih:cf05388f2679ee054f2beb29a391d25f4e673ac3&dn=gpl-2.0.txt GPL-v2 */
- $(function() {
- initMenu('',true,false,'search.php','Search');
- $(document).ready(function() { init_search(); });
- });
- /* @license-end */</script>
- <div id="main-nav"></div>
- <!-- window showing the filter options -->
- <div id="MSearchSelectWindow"
- onmouseover="return searchBox.OnSearchSelectShow()"
- onmouseout="return searchBox.OnSearchSelectHide()"
- onkeydown="return searchBox.OnSearchSelectKey(event)">
- </div>
- <!-- iframe showing the search results (closed by default) -->
- <div id="MSearchResultsWindow">
- <iframe src="javascript:void(0)" frameborder="0"
- name="MSearchResults" id="MSearchResults">
- </iframe>
- </div>
- </div><!-- top -->
- <div class="header">
- <div class="summary">
- <a href="#pub-attribs">Data Fields</a> </div>
- <div class="headertitle">
- <div class="title">MQTTClient_SSLOptions Struct Reference</div> </div>
- </div><!--header-->
- <div class="contents">
- <p>MQTTClient_sslProperties defines the settings to establish an SSL/TLS connection using the OpenSSL library.
- <a href="structMQTTClient__SSLOptions.html#details">More...</a></p>
- <p><code>#include <MQTTClient.h></code></p>
- <table class="memberdecls">
- <tr class="heading"><td colspan="2"><h2 class="groupheader"><a name="pub-attribs"></a>
- Data Fields</h2></td></tr>
- <tr class="memitem:a931062a739a44b9879bb181514070d75"><td class="memItemLeft" align="right" valign="top">char </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#a931062a739a44b9879bb181514070d75">struct_id</a> [4]</td></tr>
- <tr class="memdesc:a931062a739a44b9879bb181514070d75"><td class="mdescLeft"> </td><td class="mdescRight">The eyecatcher for this structure. <a href="structMQTTClient__SSLOptions.html#a931062a739a44b9879bb181514070d75">More...</a><br /></td></tr>
- <tr class="separator:a931062a739a44b9879bb181514070d75"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:a770248be4bf5020b0f57f770afdaca7d"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#a770248be4bf5020b0f57f770afdaca7d">struct_version</a></td></tr>
- <tr class="memdesc:a770248be4bf5020b0f57f770afdaca7d"><td class="mdescLeft"> </td><td class="mdescRight">The version number of this structure. <a href="structMQTTClient__SSLOptions.html#a770248be4bf5020b0f57f770afdaca7d">More...</a><br /></td></tr>
- <tr class="separator:a770248be4bf5020b0f57f770afdaca7d"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:a4583779998f6b3b51c7c1d3226701a4c"><td class="memItemLeft" align="right" valign="top"><a id="a4583779998f6b3b51c7c1d3226701a4c"></a>
- const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#a4583779998f6b3b51c7c1d3226701a4c">trustStore</a></td></tr>
- <tr class="memdesc:a4583779998f6b3b51c7c1d3226701a4c"><td class="mdescLeft"> </td><td class="mdescRight">The file in PEM format containing the public digital certificates trusted by the client. <br /></td></tr>
- <tr class="separator:a4583779998f6b3b51c7c1d3226701a4c"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:aab300df31cebc087303c4e5b8071e12c"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#aab300df31cebc087303c4e5b8071e12c">keyStore</a></td></tr>
- <tr class="memdesc:aab300df31cebc087303c4e5b8071e12c"><td class="mdescLeft"> </td><td class="mdescRight">The file in PEM format containing the public certificate chain of the client. <a href="structMQTTClient__SSLOptions.html#aab300df31cebc087303c4e5b8071e12c">More...</a><br /></td></tr>
- <tr class="separator:aab300df31cebc087303c4e5b8071e12c"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:a5f3cc2c0f36991db85aae88ccd4985f9"><td class="memItemLeft" align="right" valign="top"><a id="a5f3cc2c0f36991db85aae88ccd4985f9"></a>
- const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#a5f3cc2c0f36991db85aae88ccd4985f9">privateKey</a></td></tr>
- <tr class="memdesc:a5f3cc2c0f36991db85aae88ccd4985f9"><td class="mdescLeft"> </td><td class="mdescRight">If not included in the sslKeyStore, this setting points to the file in PEM format containing the client's private key. <br /></td></tr>
- <tr class="separator:a5f3cc2c0f36991db85aae88ccd4985f9"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:a183af235478d93a6b14c204e9e291bab"><td class="memItemLeft" align="right" valign="top"><a id="a183af235478d93a6b14c204e9e291bab"></a>
- const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#a183af235478d93a6b14c204e9e291bab">privateKeyPassword</a></td></tr>
- <tr class="memdesc:a183af235478d93a6b14c204e9e291bab"><td class="mdescLeft"> </td><td class="mdescRight">The password to load the client's privateKey if encrypted. <br /></td></tr>
- <tr class="separator:a183af235478d93a6b14c204e9e291bab"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:a0e07f3de1807ab841646cbb8bfa94657"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#a0e07f3de1807ab841646cbb8bfa94657">enabledCipherSuites</a></td></tr>
- <tr class="memdesc:a0e07f3de1807ab841646cbb8bfa94657"><td class="mdescLeft"> </td><td class="mdescRight">The list of cipher suites that the client will present to the server during the SSL handshake. <a href="structMQTTClient__SSLOptions.html#a0e07f3de1807ab841646cbb8bfa94657">More...</a><br /></td></tr>
- <tr class="separator:a0e07f3de1807ab841646cbb8bfa94657"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ac21e3ad623dd35533e7101001299fb6f"><td class="memItemLeft" align="right" valign="top"><a id="ac21e3ad623dd35533e7101001299fb6f"></a>
- int </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#ac21e3ad623dd35533e7101001299fb6f">enableServerCertAuth</a></td></tr>
- <tr class="memdesc:ac21e3ad623dd35533e7101001299fb6f"><td class="mdescLeft"> </td><td class="mdescRight">True/False option to enable verification of the server certificate. <br /></td></tr>
- <tr class="separator:ac21e3ad623dd35533e7101001299fb6f"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ace536bef1f2e763f28e761c0e3e3bdbe"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#ace536bef1f2e763f28e761c0e3e3bdbe">sslVersion</a></td></tr>
- <tr class="memdesc:ace536bef1f2e763f28e761c0e3e3bdbe"><td class="mdescLeft"> </td><td class="mdescRight">The SSL/TLS version to use. <a href="structMQTTClient__SSLOptions.html#ace536bef1f2e763f28e761c0e3e3bdbe">More...</a><br /></td></tr>
- <tr class="separator:ace536bef1f2e763f28e761c0e3e3bdbe"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:a61dd2a56858da45451f45640b056189d"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#a61dd2a56858da45451f45640b056189d">verify</a></td></tr>
- <tr class="memdesc:a61dd2a56858da45451f45640b056189d"><td class="mdescLeft"> </td><td class="mdescRight">Whether to carry out post-connect checks, including that a certificate matches the given host name. <a href="structMQTTClient__SSLOptions.html#a61dd2a56858da45451f45640b056189d">More...</a><br /></td></tr>
- <tr class="separator:a61dd2a56858da45451f45640b056189d"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:a1901b5590afdc86db8e542c0d49f5106"><td class="memItemLeft" align="right" valign="top">const char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#a1901b5590afdc86db8e542c0d49f5106">CApath</a></td></tr>
- <tr class="memdesc:a1901b5590afdc86db8e542c0d49f5106"><td class="mdescLeft"> </td><td class="mdescRight">From the OpenSSL documentation: If CApath is not NULL, it points to a directory containing CA certificates in PEM format. <a href="structMQTTClient__SSLOptions.html#a1901b5590afdc86db8e542c0d49f5106">More...</a><br /></td></tr>
- <tr class="separator:a1901b5590afdc86db8e542c0d49f5106"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:a997877b8c152310bc342202807ea1165"><td class="memItemLeft" align="right" valign="top"><a id="a997877b8c152310bc342202807ea1165"></a>
- int(* </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#a997877b8c152310bc342202807ea1165">ssl_error_cb</a> )(const char *str, size_t <a class="el" href="utf-8_8c.html#afed088663f8704004425cdae2120b9b3">len</a>, void *u)</td></tr>
- <tr class="memdesc:a997877b8c152310bc342202807ea1165"><td class="mdescLeft"> </td><td class="mdescRight">Callback function for OpenSSL error handler ERR_print_errors_cb Exists only if struct_version >= 3. <br /></td></tr>
- <tr class="separator:a997877b8c152310bc342202807ea1165"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:aeb2a43fde9dfc5627fda508a373bccfc"><td class="memItemLeft" align="right" valign="top"><a id="aeb2a43fde9dfc5627fda508a373bccfc"></a>
- void * </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#aeb2a43fde9dfc5627fda508a373bccfc">ssl_error_context</a></td></tr>
- <tr class="memdesc:aeb2a43fde9dfc5627fda508a373bccfc"><td class="mdescLeft"> </td><td class="mdescRight">Application-specific contex for OpenSSL error handler ERR_print_errors_cb Exists only if struct_version >= 3. <br /></td></tr>
- <tr class="separator:aeb2a43fde9dfc5627fda508a373bccfc"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:a38ecc397cbe9e2042b77c7a52c9ccc35"><td class="memItemLeft" align="right" valign="top">unsigned int(* </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#a38ecc397cbe9e2042b77c7a52c9ccc35">ssl_psk_cb</a> )(const char *hint, char *identity, unsigned int max_identity_len, unsigned char *psk, unsigned int max_psk_len, void *u)</td></tr>
- <tr class="memdesc:a38ecc397cbe9e2042b77c7a52c9ccc35"><td class="mdescLeft"> </td><td class="mdescRight">Callback function for setting TLS-PSK options. <a href="structMQTTClient__SSLOptions.html#a38ecc397cbe9e2042b77c7a52c9ccc35">More...</a><br /></td></tr>
- <tr class="separator:a38ecc397cbe9e2042b77c7a52c9ccc35"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ad459c7e3ab9f4558e9f239bf9b15f131"><td class="memItemLeft" align="right" valign="top"><a id="ad459c7e3ab9f4558e9f239bf9b15f131"></a>
- void * </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#ad459c7e3ab9f4558e9f239bf9b15f131">ssl_psk_context</a></td></tr>
- <tr class="memdesc:ad459c7e3ab9f4558e9f239bf9b15f131"><td class="mdescLeft"> </td><td class="mdescRight">Application-specific contex for ssl_psk_cb Exists only if struct_version >= 4. <br /></td></tr>
- <tr class="separator:ad459c7e3ab9f4558e9f239bf9b15f131"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:a09caf7e179009d70fff6205e89fcc434"><td class="memItemLeft" align="right" valign="top">int </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#a09caf7e179009d70fff6205e89fcc434">disableDefaultTrustStore</a></td></tr>
- <tr class="memdesc:a09caf7e179009d70fff6205e89fcc434"><td class="mdescLeft"> </td><td class="mdescRight">Don't load default SSL CA. <a href="structMQTTClient__SSLOptions.html#a09caf7e179009d70fff6205e89fcc434">More...</a><br /></td></tr>
- <tr class="separator:a09caf7e179009d70fff6205e89fcc434"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ad3db47e7874990570d03758a3fa28dad"><td class="memItemLeft" align="right" valign="top">const unsigned char * </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#ad3db47e7874990570d03758a3fa28dad">protos</a></td></tr>
- <tr class="memdesc:ad3db47e7874990570d03758a3fa28dad"><td class="mdescLeft"> </td><td class="mdescRight">The protocol-lists must be in wire-format, which is defined as a vector of non-empty, 8-bit length-prefixed, byte strings. <a href="structMQTTClient__SSLOptions.html#ad3db47e7874990570d03758a3fa28dad">More...</a><br /></td></tr>
- <tr class="separator:ad3db47e7874990570d03758a3fa28dad"><td class="memSeparator" colspan="2"> </td></tr>
- <tr class="memitem:ac2df368c72cfaa432f90e3b657bd0883"><td class="memItemLeft" align="right" valign="top"><a id="ac2df368c72cfaa432f90e3b657bd0883"></a>
- unsigned int </td><td class="memItemRight" valign="bottom"><a class="el" href="structMQTTClient__SSLOptions.html#ac2df368c72cfaa432f90e3b657bd0883">protos_len</a></td></tr>
- <tr class="memdesc:ac2df368c72cfaa432f90e3b657bd0883"><td class="mdescLeft"> </td><td class="mdescRight">The length of the vector protos vector Exists only if struct_version >= 5. <br /></td></tr>
- <tr class="separator:ac2df368c72cfaa432f90e3b657bd0883"><td class="memSeparator" colspan="2"> </td></tr>
- </table>
- <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
- <div class="textblock"><p>MQTTClient_sslProperties defines the settings to establish an SSL/TLS connection using the OpenSSL library. </p>
- <p>It covers the following scenarios:</p><ul>
- <li>Server authentication: The client needs the digital certificate of the server. It is included in a store containting trusted material (also known as "trust store").</li>
- <li>Mutual authentication: Both client and server are authenticated during the SSL handshake. In addition to the digital certificate of the server in a trust store, the client will need its own digital certificate and the private key used to sign its digital certificate stored in a "key store".</li>
- <li>Anonymous connection: Both client and server do not get authenticated and no credentials are needed to establish an SSL connection. Note that this scenario is not fully secure since it is subject to man-in-the-middle attacks. </li>
- </ul>
- </div><h2 class="groupheader">Field Documentation</h2>
- <a id="a1901b5590afdc86db8e542c0d49f5106"></a>
- <h2 class="memtitle"><span class="permalink"><a href="#a1901b5590afdc86db8e542c0d49f5106">◆ </a></span>CApath</h2>
- <div class="memitem">
- <div class="memproto">
- <table class="memname">
- <tr>
- <td class="memname">const char* MQTTClient_SSLOptions::CApath</td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>From the OpenSSL documentation: If CApath is not NULL, it points to a directory containing CA certificates in PEM format. </p>
- <p>Exists only if struct_version >= 2 </p>
- </div>
- </div>
- <a id="a09caf7e179009d70fff6205e89fcc434"></a>
- <h2 class="memtitle"><span class="permalink"><a href="#a09caf7e179009d70fff6205e89fcc434">◆ </a></span>disableDefaultTrustStore</h2>
- <div class="memitem">
- <div class="memproto">
- <table class="memname">
- <tr>
- <td class="memname">int MQTTClient_SSLOptions::disableDefaultTrustStore</td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>Don't load default SSL CA. </p>
- <p>Should be used together with PSK to make sure regular servers with certificate in place is not accepted. Exists only if struct_version >= 4 </p>
- </div>
- </div>
- <a id="a0e07f3de1807ab841646cbb8bfa94657"></a>
- <h2 class="memtitle"><span class="permalink"><a href="#a0e07f3de1807ab841646cbb8bfa94657">◆ </a></span>enabledCipherSuites</h2>
- <div class="memitem">
- <div class="memproto">
- <table class="memname">
- <tr>
- <td class="memname">const char* MQTTClient_SSLOptions::enabledCipherSuites</td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>The list of cipher suites that the client will present to the server during the SSL handshake. </p>
- <p>For a full explanation of the cipher list format, please see the OpenSSL on-line documentation: <a href="http://www.openssl.org/docs/apps/ciphers.html#CIPHER_LIST_FORMAT">http://www.openssl.org/docs/apps/ciphers.html#CIPHER_LIST_FORMAT</a> If this setting is ommitted, its default value will be "ALL", that is, all the cipher suites -excluding those offering no encryption- will be considered. This setting can be used to set an SSL anonymous connection ("aNULL" string value, for instance). </p>
- </div>
- </div>
- <a id="aab300df31cebc087303c4e5b8071e12c"></a>
- <h2 class="memtitle"><span class="permalink"><a href="#aab300df31cebc087303c4e5b8071e12c">◆ </a></span>keyStore</h2>
- <div class="memitem">
- <div class="memproto">
- <table class="memname">
- <tr>
- <td class="memname">const char* MQTTClient_SSLOptions::keyStore</td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>The file in PEM format containing the public certificate chain of the client. </p>
- <p>It may also include the client's private key. </p>
- </div>
- </div>
- <a id="ad3db47e7874990570d03758a3fa28dad"></a>
- <h2 class="memtitle"><span class="permalink"><a href="#ad3db47e7874990570d03758a3fa28dad">◆ </a></span>protos</h2>
- <div class="memitem">
- <div class="memproto">
- <table class="memname">
- <tr>
- <td class="memname">const unsigned char* MQTTClient_SSLOptions::protos</td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>The protocol-lists must be in wire-format, which is defined as a vector of non-empty, 8-bit length-prefixed, byte strings. </p>
- <p>The length-prefix byte is not included in the length. Each string is limited to 255 bytes. A byte-string length of 0 is invalid. A truncated byte-string is invalid. Check documentation for SSL_CTX_set_alpn_protos Exists only if struct_version >= 5 </p>
- </div>
- </div>
- <a id="a38ecc397cbe9e2042b77c7a52c9ccc35"></a>
- <h2 class="memtitle"><span class="permalink"><a href="#a38ecc397cbe9e2042b77c7a52c9ccc35">◆ </a></span>ssl_psk_cb</h2>
- <div class="memitem">
- <div class="memproto">
- <table class="memname">
- <tr>
- <td class="memname">unsigned int(* MQTTClient_SSLOptions::ssl_psk_cb) (const char *hint, char *identity, unsigned int max_identity_len, unsigned char *psk, unsigned int max_psk_len, void *u)</td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>Callback function for setting TLS-PSK options. </p>
- <p>Parameters correspond to that of SSL_CTX_set_psk_client_callback, except for u which is the pointer ssl_psk_context. Exists only if struct_version >= 4 </p>
- </div>
- </div>
- <a id="ace536bef1f2e763f28e761c0e3e3bdbe"></a>
- <h2 class="memtitle"><span class="permalink"><a href="#ace536bef1f2e763f28e761c0e3e3bdbe">◆ </a></span>sslVersion</h2>
- <div class="memitem">
- <div class="memproto">
- <table class="memname">
- <tr>
- <td class="memname">int MQTTClient_SSLOptions::sslVersion</td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>The SSL/TLS version to use. </p>
- <p>Specify one of MQTT_SSL_VERSION_DEFAULT (0), MQTT_SSL_VERSION_TLS_1_0 (1), MQTT_SSL_VERSION_TLS_1_1 (2) or MQTT_SSL_VERSION_TLS_1_2 (3). Only used if struct_version is >= 1. </p>
- </div>
- </div>
- <a id="a931062a739a44b9879bb181514070d75"></a>
- <h2 class="memtitle"><span class="permalink"><a href="#a931062a739a44b9879bb181514070d75">◆ </a></span>struct_id</h2>
- <div class="memitem">
- <div class="memproto">
- <table class="memname">
- <tr>
- <td class="memname">char MQTTClient_SSLOptions::struct_id[4]</td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>The eyecatcher for this structure. </p>
- <p>Must be MQTS </p>
- </div>
- </div>
- <a id="a770248be4bf5020b0f57f770afdaca7d"></a>
- <h2 class="memtitle"><span class="permalink"><a href="#a770248be4bf5020b0f57f770afdaca7d">◆ </a></span>struct_version</h2>
- <div class="memitem">
- <div class="memproto">
- <table class="memname">
- <tr>
- <td class="memname">int MQTTClient_SSLOptions::struct_version</td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>The version number of this structure. </p>
- <p>Must be 0, 1, 2, 3, 4 or 5. 0 means no sslVersion 1 means no verify, CApath 2 means no ssl_error_context, ssl_error_cb 3 means no ssl_psk_cb, ssl_psk_context, disableDefaultTrustStore 4 means no protos, protos_len </p>
- </div>
- </div>
- <a id="a61dd2a56858da45451f45640b056189d"></a>
- <h2 class="memtitle"><span class="permalink"><a href="#a61dd2a56858da45451f45640b056189d">◆ </a></span>verify</h2>
- <div class="memitem">
- <div class="memproto">
- <table class="memname">
- <tr>
- <td class="memname">int MQTTClient_SSLOptions::verify</td>
- </tr>
- </table>
- </div><div class="memdoc">
- <p>Whether to carry out post-connect checks, including that a certificate matches the given host name. </p>
- <p>Exists only if struct_version >= 2 </p>
- </div>
- </div>
- <hr/>The documentation for this struct was generated from the following file:<ul>
- <li>MQTTClient.h</li>
- </ul>
- </div><!-- contents -->
- <!-- start footer part -->
- <hr class="footer"/><address class="footer"><small>
- Generated on Thu Sep 29 2022 11:34:46 for MQTT C Client Libraries Internals by  <a href="http://www.doxygen.org/index.html">
- <img class="footer" src="doxygen.png" alt="doxygen"/>
- </a> 1.8.17
- </small></address>
- </body>
- </html>
|