HTTP server
[Applications]

Insert a tag (found in an shtml in the form of "<!--#tagname-->" into the file.

The tag's name is stored in ssi->tag_name (NULL-terminated), the replacement should be written to hs->tag_insert (up to a length of LWIP_HTTPD_MAX_TAG_INSERT_LEN). The amount of data written is stored to ssi->tag_insert_len.

Parameters:

hs	http connection state

Generate the relevant HTTP headers for the given filename and write them into the supplied buffer.

Sub-function of http_send(): send dynamic headers

Returns:

: - HTTP_NO_DATA_TO_SEND: no new data has been enqueued

• HTTP_DATA_TO_SEND_CONTINUE: continue with sending HTTP body
• HTTP_DATA_TO_SEND_BREAK: data has been enqueued, headers pending, so don't send HTTP body yet

Sub-function of http_send(): end-of-file (or block) is reached, either close the file or read the next block (if supported).

Returns:

: 0 if the file is finished or no data has been read 1 if the file is not finished and data has been read

Sub-function of http_send(): This is the normal send-routine for non-ssi files

Returns:

: - 1: data has been written (so call tcp_ouput)

• 0: no data has been written (no need to call tcp_output)

Sub-function of http_send(): This is the send-routine for ssi files

Returns:

: - 1: data has been written (so call tcp_ouput)

• 0: no data has been written (no need to call tcp_output)

Try to send more data on this pcb.

Parameters:

pcb	the pcb to send data
hs	connection state

Initialize a http connection with a file to send for an error message

Parameters:

hs	http connection state
error_nr	HTTP error number

Returns:

ERR_OK if file was found and hs has been initialized correctly another err_t otherwise

Get the file struct for a 404 error page. Tries some file names and returns NULL if none found.

Parameters:

uri	pointer that receives the actual file name URI

Returns:

file struct for the error page or NULL no matching file was found

Pass received POST body data to the application and correctly handle returning a response document or closing the connection. ATTENTION: The application is responsible for the pbuf now, so don't free it!

Parameters:

hs	http connection state
p	pbuf to pass to the application

Returns:

ERR_OK if passed successfully, another err_t if the response file hasn't been found (after POST finished)

Handle a post request. Called from http_parse_request when method 'POST' is found.

Parameters:

p	The input pbuf (containing the POST header and body).
hs	The http connection state.
data	HTTP request (header and part of body) from input pbuf(s).
data_len	Size of 'data'.
uri	The HTTP URI parsed from input pbuf(s).
uri_end	Pointer to the end of 'uri' (here, the rest of the HTTP header starts).

Returns:

ERR_OK: POST correctly parsed and accepted by the application. ERR_INPROGRESS: POST not completely parsed (no error yet) another err_t: Error parsing POST or denied by the application

A POST implementation can call this function to update the TCP window. This can be used to throttle data reception (e.g. when received data is programmed to flash and data is received faster than programmed).

Parameters:

connection	A connection handle passed to httpd_post_begin for which httpd_post_finished has *NOT* been called yet!
recved_len	Length of data received (for window update)

Try to send more data if file has been blocked before This is a callback function passed to fs_read_async().

When data has been received in the correct state, try to parse it as a HTTP request.

Parameters:

inp	the received pbuf
hs	the connection state
pcb	the tcp_pcb which received this packet

Returns:

ERR_OK if request was OK and hs has been initialized correctly ERR_INPROGRESS if request was OK so far but not fully received another err_t otherwise

Try to find the file specified by uri and, if found, initialize hs accordingly.

Parameters:

hs	the connection state
uri	the HTTP header URI
is_09	1 if the request is HTTP/0.9 (no HTTP headers in response)

Returns:

ERR_OK if file was found and hs has been initialized correctly another err_t otherwise

Initialize a http connection with a file to send (if found). Called by http_find_file and http_find_error_file.

Parameters:

hs	http connection state
file	file structure to send (or NULL if not found)
is_09	1 if the request is HTTP/0.9 (no HTTP headers in response)
uri	the HTTP header URI
tag_check	enable SSI tag checking
params	!= NULL if URI has parameters (separated by '?')

Returns:

ERR_OK if file was found and hs has been initialized correctly another err_t otherwise

The pcb had an error and is already deallocated. The argument might still be valid (if != NULL).

Data has been sent and acknowledged by the remote host. This means that more data can be sent.

The poll function is called every 2nd second. If there has been no data sent (which resets the retries) in 8 seconds, close. If the last portion of a file has not been sent in 2 seconds, close.

This could be increased, but we don't want to waste resources for bad connections.

Data has been received on this pcb. For HTTP 1.0, this should normally only happen once (if the request fits in one packet).

A new incoming connection has been accepted.

Initialize the httpd: set up a listening PCB and bind it to the defined port

Set the SSI handler function.

Parameters:

ssi_handler	the SSI handler function
tags	an array of SSI tag strings to search for in SSI-enabled files
num_tags	number of tags in the 'tags' array

Set an array of CGI filenames/handler functions

Parameters:

cgis	an array of CGI filenames/handler functions
num_handlers	number of elements in the 'cgis' array

Definition at line 745 of file lwip_httpd.c.