Symbols ![]()
loading...
Files ![]()
loading...
httpd_data struct
Server data for each instance. This is exposed publicly as httpd_handle_t but internal structure/members are kept private.
Syntax
struct httpd_data
{
httpd_config_t config;
int listen_fd;
int ctrl_fd;
#if CONFIG_HTTPD_QUEUE_WORK_BLOCKING
SemaphoreHandle_t ctrl_sock_semaphore;
#endif
int msg_fd;
struct thread_data hd_td;
struct sock_db *hd_sd;
int hd_sd_active_count;
httpd_uri_t **hd_calls;
struct httpd_req hd_req;
struct httpd_req_aux hd_req_aux;
uint64_t lru_counter;
httpd_err_handler_func_t *err_handler_fns;
};
Fields
Field
Declared as
Description
Related Functions
Found 24 other functions taking a httpd_data
argument:
Function
Description
Retrieve a session by its descriptor
Enumerates all sessions
Remove client descriptor from the session / socket database and close the connection for this client.
Checks if session can accept another connection from new client. If sockets database is full then this returns false.
Returns next free session slot (fd<0)
Delete sessions whose FDs have became invalid. This is a recovery strategy e.g. after select() fails.
Initializes an http session by resetting the sockets database.
Starts a new session for client requesting connection and adds it's descriptor to the socket database.
Processes incoming HTTP requests
Add descriptors present in the socket database to an fdset and update the value of maxfd which are needed by the select function for looking through all available sockets for incoming data.
Checks if session has any pending data/packets for processing This is needed as httpd_unrecv may un-receive next packet in the stream. If only partial packet was received then select() would mark the fd for processing as remaining part of the packet would still be in socket recv queue. But if a complete packet got unreceived then it would not be processed until further data is received on the socket. This is when this function comes in use, as it checks the socket's pending data buffer.
Removes the least recently used client from the session This may be useful if new clients are requesting for connection but max number of connections is reached, in which case the client which is inactive for the longest will be removed from the session.
Closes all sessions
For an HTTP request, searches through all the registered URI handlers and invokes the appropriate one if found
Unregister all URI handlers
Initiates the processing of HTTP request Receives incoming TCP packet on a socket, then parses the packet as HTTP request and fills httpd_req_t data structure with the extracted URI, headers are ready to be fetched from scratch buffer and calling http_recv() after this reads the body of the request.
For an HTTP request, resets the resources allocated for it and purges any data left to be received