mirror/lwip
1
0
Fork 0
mirror of https://github.com/lwip-tcpip/lwip.git synced 2024-12-28 09:19:53 +00:00
Code Issues Packages Projects Releases Wiki Activity

[patch #9547] Bring some comments in httpd.h up to date

Browse Source 
Signed-off-by: goldsimon <goldsimon@gmx.de>
This commit is contained in:
Mike Kleshov 2018-01-22 19:47:16 +01:00 committed by goldsimon
parent 9dbfa9ca0a
commit 76826c1622
1 changed files with 16 additions and 17 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
src/include/lwip/apps/httpd.h
View File

@ -57,8 +57,8 @@ extern "C" {
* *
* This function is called each time the HTTPD server is asked for a file * This function is called each time the HTTPD server is asked for a file
* whose name was previously registered as a CGI function using a call to * whose name was previously registered as a CGI function using a call to
* http_set_cgi_handler. The iIndex parameter provides the index of the * http_set_cgi_handlers. The iIndex parameter provides the index of the
* CGI within the ppcURLs array passed to http_set_cgi_handler. Parameters * CGI within the cgis array passed to http_set_cgi_handlers. Parameters
* pcParam and pcValue provide access to the parameters provided along with * pcParam and pcValue provide access to the parameters provided along with
* the URI. iNumParams provides a count of the entries in the pcParam and * the URI. iNumParams provides a count of the entries in the pcParam and
* pcValue arrays. Each entry in the pcParam array contains the name of a * pcValue arrays. Each entry in the pcParam array contains the name of a
@ -72,8 +72,8 @@ extern "C" {
* browser, for example "/thanks.htm" or "/response/error.ssi". * browser, for example "/thanks.htm" or "/response/error.ssi".
* *
* The maximum number of parameters that will be passed to this function via * The maximum number of parameters that will be passed to this function via
* iNumParams is defined by LWIP_HTTPD_MAX_CGI_PARAMETERS. Any parameters in the incoming * iNumParams is defined by LWIP_HTTPD_MAX_CGI_PARAMETERS. Any parameters in
* HTTP request above this number will be discarded. * the incoming HTTP request above this number will be discarded.
* *
* Requests intended for use by this CGI mechanism must be sent using the GET * Requests intended for use by this CGI mechanism must be sent using the GET
* method (which encodes all parameters within the URI rather than in a block * method (which encodes all parameters within the URI rather than in a block
@ -124,17 +124,17 @@ extern void httpd_cgi_handler(const char* uri, int iNumParams, char **pcParam, c
* Function pointer for the SSI tag handler callback. * Function pointer for the SSI tag handler callback.
* *
* This function will be called each time the HTTPD server detects a tag of the * This function will be called each time the HTTPD server detects a tag of the
* form <!--#name--> in a .shtml, .ssi or .shtm file where "name" appears as * form <!--#name--> in files with extensions mentioned in the g_pcSSIExtensions
* one of the tags supplied to http_set_ssi_handler in the ppcTags array. The * array (currently .shtml, .shtm, .ssi, .xml) where "name" appears as
* one of the tags supplied to http_set_ssi_handler in the tags array. The
* returned insert string, which will be appended after the the string * returned insert string, which will be appended after the the string
* "<!--#name-->" in file sent back to the client,should be written to pointer * "<!--#name-->" in file sent back to the client, should be written to pointer
* pcInsert. iInsertLen contains the size of the buffer pointed to by * pcInsert. iInsertLen contains the size of the buffer pointed to by
* pcInsert. The iIndex parameter provides the zero-based index of the tag as * pcInsert. The iIndex parameter provides the zero-based index of the tag as
* found in the ppcTags array and identifies the tag that is to be processed. * found in the tags array and identifies the tag that is to be processed.
* *
* The handler returns the number of characters written to pcInsert excluding * The handler returns the number of characters written to pcInsert excluding
* any terminating NULL or a negative number to indicate a failure (tag not * any terminating NULL or HTTPD_SSI_TAG_UNKNOWN when tag is not recognized.
* recognized, for example).
* *
* Note that the behavior of this SSI mechanism is somewhat different from the * Note that the behavior of this SSI mechanism is somewhat different from the
* "normal" SSI processing as found in, for example, the Apache web server. In * "normal" SSI processing as found in, for example, the Apache web server. In
@ -145,9 +145,8 @@ extern void httpd_cgi_handler(const char* uri, int iNumParams, char **pcParam, c
* attempting to use SSI within JavaScript. The SSI tag is structured to * attempting to use SSI within JavaScript. The SSI tag is structured to
* resemble an HTML comment but this syntax does not constitute a comment * resemble an HTML comment but this syntax does not constitute a comment
* within JavaScript and, hence, leaving the tag in place will result in * within JavaScript and, hence, leaving the tag in place will result in
* problems in these cases. To work around this, any SSI tag which needs to * problems in these cases. In order to avoid these problems, define
* output JavaScript code must do so in an encapsulated way, sending the whole * LWIP_HTTPD_SSI_INCLUDE_TAG as zero in your lwip options file.
* HTML &lt;script&gt;...&lt;/script&gt; section as a single include.
*/ */
typedef u16_t (*tSSIHandler)( typedef u16_t (*tSSIHandler)(
#if LWIP_HTTPD_SSI_RAW #if LWIP_HTTPD_SSI_RAW