| <!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" lang="en-US"> |
| <head> |
| <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> |
| <meta http-equiv="X-UA-Compatible" content="IE=11"/> |
| <meta name="generator" content="Doxygen 1.12.0"/> |
| <meta name="viewport" content="width=device-width, initial-scale=1"/> |
| <title>lwIP: HTTP client</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> |
| <script type="text/javascript" src="clipboard.js"></script> |
| <link href="navtree.css" rel="stylesheet" type="text/css"/> |
| <script type="text/javascript" src="navtreedata.js"></script> |
| <script type="text/javascript" src="navtree.js"></script> |
| <script type="text/javascript" src="resize.js"></script> |
| <script type="text/javascript" src="cookie.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 id="projectrow"> |
| <td id="projectalign"> |
| <div id="projectname">lwIP<span id="projectnumber"> 2.1.3</span> |
| </div> |
| <div id="projectbrief">Lightweight IP stack</div> |
| </td> |
| </tr> |
| </tbody> |
| </table> |
| </div> |
| <!-- end header part --> |
| <!-- Generated by Doxygen 1.12.0 --> |
| <script type="text/javascript"> |
| /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */ |
| var searchBox = new SearchBox("searchBox", "search/",'.html'); |
| /* @license-end */ |
| </script> |
| <script type="text/javascript"> |
| /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */ |
| $(function() { codefold.init(0); }); |
| /* @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:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */ |
| $(function() { |
| initMenu('',true,false,'search.php','Search',true); |
| $(function() { init_search(); }); |
| }); |
| /* @license-end */ |
| </script> |
| <div id="main-nav"></div> |
| </div><!-- top --> |
| <div id="side-nav" class="ui-resizable side-nav-resizable"> |
| <div id="nav-tree"> |
| <div id="nav-tree-contents"> |
| <div id="nav-sync" class="sync"></div> |
| </div> |
| </div> |
| <div id="splitbar" style="-moz-user-select:none;" |
| class="ui-resizable-handle"> |
| </div> |
| </div> |
| <script type="text/javascript"> |
| /* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&dn=expat.txt MIT */ |
| $(function(){initNavTree('group__httpc.html',''); initResizable(true); }); |
| /* @license-end */ |
| </script> |
| <div id="doc-content"> |
| <!-- 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"> |
| <div id="MSearchResults"> |
| <div class="SRPage"> |
| <div id="SRIndex"> |
| <div id="SRResults"></div> |
| <div class="SRStatus" id="Loading">Loading...</div> |
| <div class="SRStatus" id="Searching">Searching...</div> |
| <div class="SRStatus" id="NoMatches">No Matches</div> |
| </div> |
| </div> |
| </div> |
| </div> |
| |
| <div class="header"> |
| <div class="summary"> |
| <a href="#define-members">Macros</a> | |
| <a href="#typedef-members">Typedefs</a> | |
| <a href="#enum-members">Enumerations</a> | |
| <a href="#func-members">Functions</a> </div> |
| <div class="headertitle"><div class="title">HTTP client<div class="ingroups"><a class="el" href="group__apps.html">Applications</a></div></div></div> |
| </div><!--header--> |
| <div class="contents"> |
| <table class="memberdecls"> |
| <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="define-members" name="define-members"></a> |
| Macros</h2></td></tr> |
| <tr class="memitem:ga055b9a8bf8f4e2c18c621471773fa66c" id="r_ga055b9a8bf8f4e2c18c621471773fa66c"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="#ga055b9a8bf8f4e2c18c621471773fa66c">LWIP_HTTPC_HAVE_FILE_IO</a>   0</td></tr> |
| <tr class="separator:ga055b9a8bf8f4e2c18c621471773fa66c"><td class="memSeparator" colspan="2"> </td></tr> |
| <tr class="memitem:ga1f192f3009865e9f9a3cd83609c866c2" id="r_ga1f192f3009865e9f9a3cd83609c866c2"><td class="memItemLeft" align="right" valign="top">#define </td><td class="memItemRight" valign="bottom"><a class="el" href="#ga1f192f3009865e9f9a3cd83609c866c2">HTTP_DEFAULT_PORT</a>   <a class="el" href="group__iana.html#ggac9396d90585e49e9a287179bf5aa9ba0a1c665cb8e57dff577f4966493c15b618">LWIP_IANA_PORT_HTTP</a></td></tr> |
| <tr class="separator:ga1f192f3009865e9f9a3cd83609c866c2"><td class="memSeparator" colspan="2"> </td></tr> |
| </table><table class="memberdecls"> |
| <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="typedef-members" name="typedef-members"></a> |
| Typedefs</h2></td></tr> |
| <tr class="memitem:gaeef5c7398d07b644c0d5593f3b7d1392" id="r_gaeef5c7398d07b644c0d5593f3b7d1392"><td class="memItemLeft" align="right" valign="top">typedef enum <a class="el" href="#ga49e34884b272b1e0ddae8da46c31d9a3">ehttpc_result</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#gaeef5c7398d07b644c0d5593f3b7d1392">httpc_result_t</a></td></tr> |
| <tr class="separator:gaeef5c7398d07b644c0d5593f3b7d1392"><td class="memSeparator" colspan="2"> </td></tr> |
| <tr class="memitem:ga0452eb8007dbb5f139ec992e58e560dd" id="r_ga0452eb8007dbb5f139ec992e58e560dd"><td class="memItemLeft" align="right" valign="top">typedef void(* </td><td class="memItemRight" valign="bottom"><a class="el" href="#ga0452eb8007dbb5f139ec992e58e560dd">httpc_result_fn</a>) (void *arg, <a class="el" href="#gaeef5c7398d07b644c0d5593f3b7d1392">httpc_result_t</a> httpc_result, u32_t rx_content_len, u32_t srv_res, <a class="el" href="group__infrastructure__errors.html#gaf02d9da80fd66b4f986d2c53d7231ddb">err_t</a> err)</td></tr> |
| <tr class="separator:ga0452eb8007dbb5f139ec992e58e560dd"><td class="memSeparator" colspan="2"> </td></tr> |
| <tr class="memitem:ga1e5b62519d6592c89ed3edfabd917472" id="r_ga1e5b62519d6592c89ed3edfabd917472"><td class="memItemLeft" align="right" valign="top">typedef <a class="el" href="group__infrastructure__errors.html#gaf02d9da80fd66b4f986d2c53d7231ddb">err_t</a>(* </td><td class="memItemRight" valign="bottom"><a class="el" href="#ga1e5b62519d6592c89ed3edfabd917472">httpc_headers_done_fn</a>) (httpc_state_t *connection, void *arg, struct <a class="el" href="structpbuf.html">pbuf</a> *hdr, u16_t hdr_len, u32_t content_len)</td></tr> |
| <tr class="separator:ga1e5b62519d6592c89ed3edfabd917472"><td class="memSeparator" colspan="2"> </td></tr> |
| </table><table class="memberdecls"> |
| <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="enum-members" name="enum-members"></a> |
| Enumerations</h2></td></tr> |
| <tr class="memitem:ga49e34884b272b1e0ddae8da46c31d9a3" id="r_ga49e34884b272b1e0ddae8da46c31d9a3"><td class="memItemLeft" align="right" valign="top">enum  </td><td class="memItemRight" valign="bottom"><a class="el" href="#ga49e34884b272b1e0ddae8da46c31d9a3">ehttpc_result</a> { <br /> |
|   <a class="el" href="#gga49e34884b272b1e0ddae8da46c31d9a3af3173d4d272c9c0b5a5c9b5b027e3659">HTTPC_RESULT_OK</a> = 0 |
| , <a class="el" href="#gga49e34884b272b1e0ddae8da46c31d9a3a5026187026abd1d242333ba6ff69ddbd">HTTPC_RESULT_ERR_UNKNOWN</a> = 1 |
| , <a class="el" href="#gga49e34884b272b1e0ddae8da46c31d9a3ab866d5433b4c4593c80b756d434e1d09">HTTPC_RESULT_ERR_CONNECT</a> = 2 |
| , <a class="el" href="#gga49e34884b272b1e0ddae8da46c31d9a3ae04714f90692c122e6c85e06083dbc6d">HTTPC_RESULT_ERR_HOSTNAME</a> = 3 |
| , <br /> |
|   <a class="el" href="#gga49e34884b272b1e0ddae8da46c31d9a3a89a6700abb14dd7cab9b4e0fd66e5fd6">HTTPC_RESULT_ERR_CLOSED</a> = 4 |
| , <a class="el" href="#gga49e34884b272b1e0ddae8da46c31d9a3a8e6c597f88335b31e6a8b078a32fde33">HTTPC_RESULT_ERR_TIMEOUT</a> = 5 |
| , <a class="el" href="#gga49e34884b272b1e0ddae8da46c31d9a3aaa023a6f8069c02c87a826ba323c54b8">HTTPC_RESULT_ERR_SVR_RESP</a> = 6 |
| , <a class="el" href="#gga49e34884b272b1e0ddae8da46c31d9a3a49972833ec01c7a10dee734c7c69ed62">HTTPC_RESULT_ERR_MEM</a> = 7 |
| , <br /> |
|   <a class="el" href="#gga49e34884b272b1e0ddae8da46c31d9a3adf4e45365923c16b6a6879bde5f60867">HTTPC_RESULT_LOCAL_ABORT</a> = 8 |
| , <a class="el" href="#gga49e34884b272b1e0ddae8da46c31d9a3a6c8a4195834e1997a498a03bb47bb096">HTTPC_RESULT_ERR_CONTENT_LEN</a> = 9 |
| <br /> |
| }</td></tr> |
| <tr class="separator:ga49e34884b272b1e0ddae8da46c31d9a3"><td class="memSeparator" colspan="2"> </td></tr> |
| </table><table class="memberdecls"> |
| <tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a> |
| Functions</h2></td></tr> |
| <tr class="memitem:ga6c961e52cec2d25b4b82b6910ebcfa1b" id="r_ga6c961e52cec2d25b4b82b6910ebcfa1b"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__infrastructure__errors.html#gaf02d9da80fd66b4f986d2c53d7231ddb">err_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#ga6c961e52cec2d25b4b82b6910ebcfa1b">httpc_get_file</a> (const <a class="el" href="group__ipaddr.html#ga335a8c9df66319e88a1a529047ce0a1e">ip_addr_t</a> *server_addr, u16_t port, const char *uri, const httpc_connection_t *settings, altcp_recv_fn recv_fn, void *callback_arg, httpc_state_t **connection)</td></tr> |
| <tr class="separator:ga6c961e52cec2d25b4b82b6910ebcfa1b"><td class="memSeparator" colspan="2"> </td></tr> |
| <tr class="memitem:gabd4ef2259885a93090733235cc0fa8d6" id="r_gabd4ef2259885a93090733235cc0fa8d6"><td class="memItemLeft" align="right" valign="top"><a class="el" href="group__infrastructure__errors.html#gaf02d9da80fd66b4f986d2c53d7231ddb">err_t</a> </td><td class="memItemRight" valign="bottom"><a class="el" href="#gabd4ef2259885a93090733235cc0fa8d6">httpc_get_file_dns</a> (const char *server_name, u16_t port, const char *uri, const httpc_connection_t *settings, altcp_recv_fn recv_fn, void *callback_arg, httpc_state_t **connection)</td></tr> |
| <tr class="separator:gabd4ef2259885a93090733235cc0fa8d6"><td class="memSeparator" colspan="2"> </td></tr> |
| </table> |
| <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2> |
| <h2 class="groupheader">Macro Definition Documentation</h2> |
| <a id="ga1f192f3009865e9f9a3cd83609c866c2" name="ga1f192f3009865e9f9a3cd83609c866c2"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#ga1f192f3009865e9f9a3cd83609c866c2">◆ </a></span>HTTP_DEFAULT_PORT</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">#define HTTP_DEFAULT_PORT   <a class="el" href="group__iana.html#ggac9396d90585e49e9a287179bf5aa9ba0a1c665cb8e57dff577f4966493c15b618">LWIP_IANA_PORT_HTTP</a></td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| <p>The default TCP port used for HTTP </p> |
| |
| </div> |
| </div> |
| <a id="ga055b9a8bf8f4e2c18c621471773fa66c" name="ga055b9a8bf8f4e2c18c621471773fa66c"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#ga055b9a8bf8f4e2c18c621471773fa66c">◆ </a></span>LWIP_HTTPC_HAVE_FILE_IO</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">#define LWIP_HTTPC_HAVE_FILE_IO   0</td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| <p>HTTPC_HAVE_FILE_IO: define this to 1 to have functions dowloading directly to disk via fopen/fwrite. These functions are example implementations of the interface only. </p> |
| |
| </div> |
| </div> |
| <h2 class="groupheader">Typedef Documentation</h2> |
| <a id="ga1e5b62519d6592c89ed3edfabd917472" name="ga1e5b62519d6592c89ed3edfabd917472"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#ga1e5b62519d6592c89ed3edfabd917472">◆ </a></span>httpc_headers_done_fn</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">typedef <a class="el" href="group__infrastructure__errors.html#gaf02d9da80fd66b4f986d2c53d7231ddb">err_t</a>(* httpc_headers_done_fn) (httpc_state_t *connection, void *arg, struct <a class="el" href="structpbuf.html">pbuf</a> *hdr, u16_t hdr_len, u32_t content_len)</td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| <p>Prototype of http client callback: called when the headers are received</p> |
| <dl class="params"><dt>Parameters</dt><dd> |
| <table class="params"> |
| <tr><td class="paramname">connection</td><td>http client connection </td></tr> |
| <tr><td class="paramname">arg</td><td>argument specified when initiating the request </td></tr> |
| <tr><td class="paramname">hdr</td><td>header <a class="el" href="structpbuf.html">pbuf(s)</a> (may contain data also) </td></tr> |
| <tr><td class="paramname">hdr_len</td><td>length of the heders in 'hdr' </td></tr> |
| <tr><td class="paramname">content_len</td><td>content length as received in the headers (-1 if not received) </td></tr> |
| </table> |
| </dd> |
| </dl> |
| <dl class="section return"><dt>Returns</dt><dd>if != ERR_OK is returned, the connection is aborted </dd></dl> |
| |
| </div> |
| </div> |
| <a id="ga0452eb8007dbb5f139ec992e58e560dd" name="ga0452eb8007dbb5f139ec992e58e560dd"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#ga0452eb8007dbb5f139ec992e58e560dd">◆ </a></span>httpc_result_fn</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">typedef void(* httpc_result_fn) (void *arg, <a class="el" href="#gaeef5c7398d07b644c0d5593f3b7d1392">httpc_result_t</a> httpc_result, u32_t rx_content_len, u32_t srv_res, <a class="el" href="group__infrastructure__errors.html#gaf02d9da80fd66b4f986d2c53d7231ddb">err_t</a> err)</td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| <p>Prototype of a http client callback function</p> |
| <dl class="params"><dt>Parameters</dt><dd> |
| <table class="params"> |
| <tr><td class="paramname">arg</td><td>argument specified when initiating the request </td></tr> |
| <tr><td class="paramname">httpc_result</td><td>result of the http transfer (see enum httpc_result_t) </td></tr> |
| <tr><td class="paramname">rx_content_len</td><td>number of bytes received (without headers) </td></tr> |
| <tr><td class="paramname">srv_res</td><td>this contains the http status code received (if any) </td></tr> |
| <tr><td class="paramname">err</td><td>an error returned by internal lwip functions, can help to specify the source of the error but must not necessarily be != ERR_OK </td></tr> |
| </table> |
| </dd> |
| </dl> |
| |
| </div> |
| </div> |
| <a id="gaeef5c7398d07b644c0d5593f3b7d1392" name="gaeef5c7398d07b644c0d5593f3b7d1392"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#gaeef5c7398d07b644c0d5593f3b7d1392">◆ </a></span>httpc_result_t</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">typedef enum <a class="el" href="#ga49e34884b272b1e0ddae8da46c31d9a3">ehttpc_result</a> <a class="el" href="#gaeef5c7398d07b644c0d5593f3b7d1392">httpc_result_t</a></td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| <p>HTTP client result codes </p> |
| |
| </div> |
| </div> |
| <h2 class="groupheader">Enumeration Type Documentation</h2> |
| <a id="ga49e34884b272b1e0ddae8da46c31d9a3" name="ga49e34884b272b1e0ddae8da46c31d9a3"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#ga49e34884b272b1e0ddae8da46c31d9a3">◆ </a></span>ehttpc_result</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname">enum <a class="el" href="#ga49e34884b272b1e0ddae8da46c31d9a3">ehttpc_result</a></td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| <p>HTTP client result codes </p> |
| <table class="fieldtable"> |
| <tr><th colspan="2">Enumerator</th></tr><tr><td class="fieldname"><a id="gga49e34884b272b1e0ddae8da46c31d9a3af3173d4d272c9c0b5a5c9b5b027e3659" name="gga49e34884b272b1e0ddae8da46c31d9a3af3173d4d272c9c0b5a5c9b5b027e3659"></a>HTTPC_RESULT_OK </td><td class="fielddoc"><p>File successfully received </p> |
| </td></tr> |
| <tr><td class="fieldname"><a id="gga49e34884b272b1e0ddae8da46c31d9a3a5026187026abd1d242333ba6ff69ddbd" name="gga49e34884b272b1e0ddae8da46c31d9a3a5026187026abd1d242333ba6ff69ddbd"></a>HTTPC_RESULT_ERR_UNKNOWN </td><td class="fielddoc"><p>Unknown error </p> |
| </td></tr> |
| <tr><td class="fieldname"><a id="gga49e34884b272b1e0ddae8da46c31d9a3ab866d5433b4c4593c80b756d434e1d09" name="gga49e34884b272b1e0ddae8da46c31d9a3ab866d5433b4c4593c80b756d434e1d09"></a>HTTPC_RESULT_ERR_CONNECT </td><td class="fielddoc"><p>Connection to server failed </p> |
| </td></tr> |
| <tr><td class="fieldname"><a id="gga49e34884b272b1e0ddae8da46c31d9a3ae04714f90692c122e6c85e06083dbc6d" name="gga49e34884b272b1e0ddae8da46c31d9a3ae04714f90692c122e6c85e06083dbc6d"></a>HTTPC_RESULT_ERR_HOSTNAME </td><td class="fielddoc"><p>Failed to resolve server hostname </p> |
| </td></tr> |
| <tr><td class="fieldname"><a id="gga49e34884b272b1e0ddae8da46c31d9a3a89a6700abb14dd7cab9b4e0fd66e5fd6" name="gga49e34884b272b1e0ddae8da46c31d9a3a89a6700abb14dd7cab9b4e0fd66e5fd6"></a>HTTPC_RESULT_ERR_CLOSED </td><td class="fielddoc"><p>Connection unexpectedly closed by remote server </p> |
| </td></tr> |
| <tr><td class="fieldname"><a id="gga49e34884b272b1e0ddae8da46c31d9a3a8e6c597f88335b31e6a8b078a32fde33" name="gga49e34884b272b1e0ddae8da46c31d9a3a8e6c597f88335b31e6a8b078a32fde33"></a>HTTPC_RESULT_ERR_TIMEOUT </td><td class="fielddoc"><p>Connection timed out (server didn't respond in time) </p> |
| </td></tr> |
| <tr><td class="fieldname"><a id="gga49e34884b272b1e0ddae8da46c31d9a3aaa023a6f8069c02c87a826ba323c54b8" name="gga49e34884b272b1e0ddae8da46c31d9a3aaa023a6f8069c02c87a826ba323c54b8"></a>HTTPC_RESULT_ERR_SVR_RESP </td><td class="fielddoc"><p>Server responded with an error code </p> |
| </td></tr> |
| <tr><td class="fieldname"><a id="gga49e34884b272b1e0ddae8da46c31d9a3a49972833ec01c7a10dee734c7c69ed62" name="gga49e34884b272b1e0ddae8da46c31d9a3a49972833ec01c7a10dee734c7c69ed62"></a>HTTPC_RESULT_ERR_MEM </td><td class="fielddoc"><p>Local memory error </p> |
| </td></tr> |
| <tr><td class="fieldname"><a id="gga49e34884b272b1e0ddae8da46c31d9a3adf4e45365923c16b6a6879bde5f60867" name="gga49e34884b272b1e0ddae8da46c31d9a3adf4e45365923c16b6a6879bde5f60867"></a>HTTPC_RESULT_LOCAL_ABORT </td><td class="fielddoc"><p>Local abort </p> |
| </td></tr> |
| <tr><td class="fieldname"><a id="gga49e34884b272b1e0ddae8da46c31d9a3a6c8a4195834e1997a498a03bb47bb096" name="gga49e34884b272b1e0ddae8da46c31d9a3a6c8a4195834e1997a498a03bb47bb096"></a>HTTPC_RESULT_ERR_CONTENT_LEN </td><td class="fielddoc"><p>Content length mismatch </p> |
| </td></tr> |
| </table> |
| |
| </div> |
| </div> |
| <h2 class="groupheader">Function Documentation</h2> |
| <a id="ga6c961e52cec2d25b4b82b6910ebcfa1b" name="ga6c961e52cec2d25b4b82b6910ebcfa1b"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#ga6c961e52cec2d25b4b82b6910ebcfa1b">◆ </a></span>httpc_get_file()</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname"><a class="el" href="group__infrastructure__errors.html#gaf02d9da80fd66b4f986d2c53d7231ddb">err_t</a> httpc_get_file </td> |
| <td>(</td> |
| <td class="paramtype">const <a class="el" href="group__ipaddr.html#ga335a8c9df66319e88a1a529047ce0a1e">ip_addr_t</a> *</td> <td class="paramname"><span class="paramname"><em>server_addr</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">u16_t</td> <td class="paramname"><span class="paramname"><em>port</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">const char *</td> <td class="paramname"><span class="paramname"><em>uri</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">const httpc_connection_t *</td> <td class="paramname"><span class="paramname"><em>settings</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">altcp_recv_fn</td> <td class="paramname"><span class="paramname"><em>recv_fn</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">void *</td> <td class="paramname"><span class="paramname"><em>callback_arg</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">httpc_state_t **</td> <td class="paramname"><span class="paramname"><em>connection</em></span> )</td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| <p>HTTP client API: get a file by passing server IP address</p> |
| <dl class="params"><dt>Parameters</dt><dd> |
| <table class="params"> |
| <tr><td class="paramname">server_addr</td><td>IP address of the server to connect </td></tr> |
| <tr><td class="paramname">port</td><td>tcp port of the server </td></tr> |
| <tr><td class="paramname">uri</td><td>uri to get from the server, remember leading "/"! </td></tr> |
| <tr><td class="paramname">settings</td><td>connection settings (callbacks, proxy, etc.) </td></tr> |
| <tr><td class="paramname">recv_fn</td><td>the http body (not the headers) are passed to this callback </td></tr> |
| <tr><td class="paramname">callback_arg</td><td>argument passed to all the callbacks </td></tr> |
| <tr><td class="paramname">connection</td><td>retreives the connection handle (to match in callbacks) </td></tr> |
| </table> |
| </dd> |
| </dl> |
| <dl class="section return"><dt>Returns</dt><dd>ERR_OK if starting the request succeeds (callback_fn will be called later) or an error code </dd></dl> |
| |
| </div> |
| </div> |
| <a id="gabd4ef2259885a93090733235cc0fa8d6" name="gabd4ef2259885a93090733235cc0fa8d6"></a> |
| <h2 class="memtitle"><span class="permalink"><a href="#gabd4ef2259885a93090733235cc0fa8d6">◆ </a></span>httpc_get_file_dns()</h2> |
| |
| <div class="memitem"> |
| <div class="memproto"> |
| <table class="memname"> |
| <tr> |
| <td class="memname"><a class="el" href="group__infrastructure__errors.html#gaf02d9da80fd66b4f986d2c53d7231ddb">err_t</a> httpc_get_file_dns </td> |
| <td>(</td> |
| <td class="paramtype">const char *</td> <td class="paramname"><span class="paramname"><em>server_name</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">u16_t</td> <td class="paramname"><span class="paramname"><em>port</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">const char *</td> <td class="paramname"><span class="paramname"><em>uri</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">const httpc_connection_t *</td> <td class="paramname"><span class="paramname"><em>settings</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">altcp_recv_fn</td> <td class="paramname"><span class="paramname"><em>recv_fn</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">void *</td> <td class="paramname"><span class="paramname"><em>callback_arg</em></span>, </td> |
| </tr> |
| <tr> |
| <td class="paramkey"></td> |
| <td></td> |
| <td class="paramtype">httpc_state_t **</td> <td class="paramname"><span class="paramname"><em>connection</em></span> )</td> |
| </tr> |
| </table> |
| </div><div class="memdoc"> |
| <p>HTTP client API: get a file by passing server name as string (DNS name or IP address string)</p> |
| <dl class="params"><dt>Parameters</dt><dd> |
| <table class="params"> |
| <tr><td class="paramname">server_name</td><td>server name as string (DNS name or IP address string) </td></tr> |
| <tr><td class="paramname">port</td><td>tcp port of the server </td></tr> |
| <tr><td class="paramname">uri</td><td>uri to get from the server, remember leading "/"! </td></tr> |
| <tr><td class="paramname">settings</td><td>connection settings (callbacks, proxy, etc.) </td></tr> |
| <tr><td class="paramname">recv_fn</td><td>the http body (not the headers) are passed to this callback </td></tr> |
| <tr><td class="paramname">callback_arg</td><td>argument passed to all the callbacks </td></tr> |
| <tr><td class="paramname">connection</td><td>retreives the connection handle (to match in callbacks) </td></tr> |
| </table> |
| </dd> |
| </dl> |
| <dl class="section return"><dt>Returns</dt><dd>ERR_OK if starting the request succeeds (callback_fn will be called later) or an error code </dd></dl> |
| |
| </div> |
| </div> |
| </div><!-- contents --> |
| </div><!-- doc-content --> |
| <!-- start footer part --> |
| <div id="nav-path" class="navpath"><!-- id is needed for treeview function! --> |
| <ul> |
| <li class="footer">Generated by <a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.12.0 </li> |
| </ul> |
| </div> |
| </body> |
| </html> |