connection.c File Reference

Methods for managing connections. More...

#include "internal.h"
#include "connection.h"
#include "memorypool.h"
#include "response.h"
#include "reason_phrase.h"

Include dependency graph for connection.c:

Go to the source code of this file.

Defines

#define HTTP_100_CONTINUE   "HTTP/1.1 100 Continue\r\n\r\n"
#define REQUEST_TOO_BIG   ""
#define REQUEST_LACKS_HOST   ""
#define REQUEST_MALFORMED   ""
#define INTERNAL_ERROR   ""
#define DEBUG_CLOSE   MHD_NO
#define DEBUG_SEND_DATA   MHD_NO

Functions

int MHD_get_connection_values (struct MHD_Connection *connection, enum MHD_ValueKind kind, MHD_KeyValueIterator iterator, void *iterator_cls)
int MHD_set_connection_value (struct MHD_Connection *connection, enum MHD_ValueKind kind, const char *key, const char *value)
const char * MHD_lookup_connection_value (struct MHD_Connection *connection, enum MHD_ValueKind kind, const char *key)
int MHD_queue_response (struct MHD_Connection *connection, unsigned int status_code, struct MHD_Response *response)
static int need_100_continue (struct MHD_Connection *connection)
void MHD_connection_close (struct MHD_Connection *connection, enum MHD_RequestTerminationCode termination_code)
static void connection_close_error (struct MHD_Connection *connection)
static int try_ready_normal_body (struct MHD_Connection *connection)
static int try_ready_chunked_body (struct MHD_Connection *connection)
static void add_extra_headers (struct MHD_Connection *connection)
static void get_date_string (char *date)
static int try_grow_read_buffer (struct MHD_Connection *connection)
static int build_header_response (struct MHD_Connection *connection)
static void transmit_error_response (struct MHD_Connection *connection, unsigned int status_code, const char *message)
static void do_fd_set (int fd, fd_set *set, int *max_fd)
int MHD_connection_get_fdset (struct MHD_Connection *connection, fd_set *read_fd_set, fd_set *write_fd_set, fd_set *except_fd_set, int *max_fd)
static char * get_next_header_line (struct MHD_Connection *connection)
static int connection_add_header (struct MHD_Connection *connection, char *key, char *value, enum MHD_ValueKind kind)
static int parse_arguments (enum MHD_ValueKind kind, struct MHD_Connection *connection, char *args)
static int parse_cookie_header (struct MHD_Connection *connection)
static int parse_initial_message_line (struct MHD_Connection *connection, char *line)
static void call_connection_handler (struct MHD_Connection *connection)
static int do_read (struct MHD_Connection *connection)
static int do_write (struct MHD_Connection *connection)
static int check_write_done (struct MHD_Connection *connection, enum MHD_CONNECTION_STATE next_state)
static int process_header_line (struct MHD_Connection *connection, char *line)
static int process_broken_line (struct MHD_Connection *connection, char *line, enum MHD_ValueKind kind)
static void parse_connection_headers (struct MHD_Connection *connection)
int MHD_connection_handle_read (struct MHD_Connection *connection)
int MHD_connection_handle_write (struct MHD_Connection *connection)
int MHD_connection_handle_idle (struct MHD_Connection *connection)
void MHD_set_http_calbacks (struct MHD_Connection *connection)
union MHD_ConnectionInfoMHD_get_connection_info (struct MHD_Connection *connection, enum MHD_ConnectionInfoType infoType,...)


Detailed Description

Methods for managing connections.

Methods for managing SSL/TLS connections. This file is only compiled if ENABLE_HTTPS is set.

Author:
Daniel Pittman

Christian Grothoff

Sagie Amir

Christian Grothoff

Definition in file connection.c.


Define Documentation

#define DEBUG_CLOSE   MHD_NO

Add extra debug messages with reasons for closing connections (non-error reasons).

Definition at line 94 of file connection.c.

#define DEBUG_SEND_DATA   MHD_NO

Should all data send be printed to stderr?

Definition at line 99 of file connection.c.

#define HTTP_100_CONTINUE   "HTTP/1.1 100 Continue\r\n\r\n"

Message to transmit when http 1.1 request is received

Definition at line 37 of file connection.c.

Referenced by MHD_connection_handle_idle(), MHD_connection_handle_write(), and need_100_continue().

#define INTERNAL_ERROR   ""

Response text used when there is an internal server error.

Intentionally empty here to keep our memory footprint minimal.

Definition at line 87 of file connection.c.

Referenced by MHD_connection_get_fdset().

#define REQUEST_LACKS_HOST   ""

Response text used when the request (http header) does not contain a "Host:" header and still claims to be HTTP 1.1.

Intentionally empty here to keep our memory footprint minimal.

Definition at line 62 of file connection.c.

Referenced by parse_connection_headers().

#define REQUEST_MALFORMED   ""

Response text used when the request (http header) is malformed.

Intentionally empty here to keep our memory footprint minimal.

Definition at line 75 of file connection.c.

Referenced by MHD_connection_handle_idle(), and process_broken_line().

#define REQUEST_TOO_BIG   ""

Response text used when the request (http header) is too big to be processed.

Intentionally empty here to keep our memory footprint minimal.

Definition at line 49 of file connection.c.

Referenced by connection_add_header(), get_next_header_line(), MHD_connection_get_fdset(), parse_cookie_header(), and process_broken_line().


Function Documentation

static void add_extra_headers ( struct MHD_Connection connection  )  [static]

Check if we need to set some additional headers for http-compiliance.

Definition at line 435 of file connection.c.

References MHD_Connection::have_chunked_upload, MHD_add_response_header(), MHD_get_response_header(), MHD_HTTP_HEADER_CONNECTION, MHD_HTTP_HEADER_CONTENT_LENGTH, MHD_HTTP_HEADER_TRANSFER_ENCODING, MHD_HTTP_VERSION_1_1, MHD_NO, MHD_YES, MHD_Connection::response, SPRINTF, MHD_Response::total_size, and MHD_Connection::version.

Referenced by build_header_response().

Here is the call graph for this function:

Here is the caller graph for this function:

static int build_header_response ( struct MHD_Connection connection  )  [static]

static void call_connection_handler ( struct MHD_Connection connection  )  [static]

static int check_write_done ( struct MHD_Connection connection,
enum MHD_CONNECTION_STATE  next_state 
) [static]

Check if we are done sending the write-buffer. If so, transition into "next_state".

Returns:
MHY_NO if we are not done, MHD_YES if we are

Definition at line 1337 of file connection.c.

References MHD_NO, MHD_pool_reallocate(), MHD_YES, MHD_Connection::pool, MHD_Connection::state, MHD_Connection::write_buffer, MHD_Connection::write_buffer_append_offset, MHD_Connection::write_buffer_send_offset, and MHD_Connection::write_buffer_size.

Referenced by MHD_connection_handle_write().

Here is the call graph for this function:

Here is the caller graph for this function:

static int connection_add_header ( struct MHD_Connection connection,
char *  key,
char *  value,
enum MHD_ValueKind  kind 
) [static]

Returns:
MHD_NO on failure (out of memory), MHD_YES for success

Definition at line 886 of file connection.c.

References MHD_Connection::daemon, MHD_HTTP_Header::header, MHD_Connection::headers_received, MHD_HTTP_Header::kind, MHD_HTTP_REQUEST_ENTITY_TOO_LARGE, MHD_NO, MHD_pool_allocate(), MHD_YES, MHD_HTTP_Header::next, MHD_Connection::pool, REQUEST_TOO_BIG, transmit_error_response(), and MHD_HTTP_Header::value.

Referenced by parse_arguments(), parse_cookie_header(), and process_broken_line().

Here is the call graph for this function:

Here is the caller graph for this function:

static void connection_close_error ( struct MHD_Connection connection  )  [static]

A serious error occured, close the connection (and notify the application).

Definition at line 302 of file connection.c.

References MHD_connection_close(), and MHD_REQUEST_TERMINATED_WITH_ERROR.

Referenced by call_connection_handler(), do_read(), do_write(), MHD_connection_get_fdset(), MHD_connection_handle_idle(), MHD_connection_handle_read(), MHD_connection_handle_write(), try_ready_chunked_body(), and try_ready_normal_body().

Here is the call graph for this function:

Here is the caller graph for this function:

static void do_fd_set ( int  fd,
fd_set *  set,
int *  max_fd 
) [static]

Add "fd" to the "fd_set". If "fd" is greater than "*max", set "*max" to fd.

Definition at line 659 of file connection.c.

Referenced by MHD_connection_get_fdset().

Here is the caller graph for this function:

static int do_read ( struct MHD_Connection connection  )  [static]

Try reading data from the socket into the read buffer of the connection.

Returns:
MHD_YES if something changed, MHD_NO if we were interrupted or if no space was available

Definition at line 1258 of file connection.c.

References connection_close_error(), MHD_Connection::daemon, MHD_NO, MHD_YES, MHD_Connection::read_buffer, MHD_Connection::read_buffer_offset, MHD_Connection::read_buffer_size, MHD_Connection::read_closed, MHD_Connection::recv_cls, SHUTDOWN, MHD_Connection::socket_fd, and STRERROR.

Referenced by MHD_connection_handle_read().

Here is the call graph for this function:

Here is the caller graph for this function:

static int do_write ( struct MHD_Connection connection  )  [static]

Try writing data to the socket from the write buffer of the connection.

Returns:
MHD_YES if something changed, MHD_NO if we were interrupted

Definition at line 1300 of file connection.c.

References connection_close_error(), MHD_Connection::daemon, FPRINTF, MHD_NO, MHD_YES, MHD_Connection::send_cls, STRERROR, MHD_Connection::write_buffer, MHD_Connection::write_buffer_append_offset, and MHD_Connection::write_buffer_send_offset.

Referenced by MHD_connection_handle_write().

Here is the call graph for this function:

Here is the caller graph for this function:

static void get_date_string ( char *  date  )  [static]

Produce HTTP "Date:" header.

Parameters:
date where to write the header, with at least 128 bytes available space.

Definition at line 483 of file connection.c.

References SPRINTF.

Referenced by build_header_response().

Here is the caller graph for this function:

static char* get_next_header_line ( struct MHD_Connection connection  )  [static]

Parse a single line of the HTTP header. Advance read_buffer (!) appropriately. If the current line does not fit, consider growing the buffer. If the line is far too long, close the connection. If no line is found (incomplete, buffer too small, line too long), return NULL. Otherwise return a pointer to the line.

Definition at line 833 of file connection.c.

References MHD_BUF_INC_SIZE, MHD_HTTP_REQUEST_ENTITY_TOO_LARGE, MHD_HTTP_REQUEST_URI_TOO_LONG, MHD_pool_reallocate(), MHD_Connection::pool, MHD_Connection::read_buffer, MHD_Connection::read_buffer_offset, MHD_Connection::read_buffer_size, REQUEST_TOO_BIG, transmit_error_response(), and MHD_Connection::url.

Referenced by MHD_connection_handle_idle().

Here is the call graph for this function:

Here is the caller graph for this function:

void MHD_connection_close ( struct MHD_Connection connection,
enum MHD_RequestTerminationCode  termination_code 
)

Close the given connection and give the specified termination code to the user.

Definition at line 282 of file connection.c.

References MHD_Connection::client_context, CLOSE, MHD_Connection::daemon, MHD_CONNECTION_CLOSED, MHD_Daemon::notify_completed, SHUTDOWN, MHD_Connection::socket_fd, and MHD_Connection::state.

Referenced by connection_close_error(), MHD_handle_connection(), MHD_stop_daemon(), and MHD_tls_connection_close().

Here is the caller graph for this function:

int MHD_connection_get_fdset ( struct MHD_Connection connection,
fd_set *  read_fd_set,
fd_set *  write_fd_set,
fd_set *  except_fd_set,
int *  max_fd 
)

Obtain the select sets for this connection

Returns:
MHD_YES on success

Definition at line 672 of file connection.c.

References connection_close_error(), MHD_Connection::daemon, do_fd_set(), EXTRA_CHECK, INTERNAL_ERROR, MHD_CONNECTION_BODY_RECEIVED, MHD_CONNECTION_BODY_SENT, MHD_CONNECTION_CHUNKED_BODY_READY, MHD_CONNECTION_CHUNKED_BODY_UNREADY, MHD_CONNECTION_CLOSED, MHD_CONNECTION_CONTINUE_SENDING, MHD_CONNECTION_CONTINUE_SENT, MHD_CONNECTION_FOOTER_PART_RECEIVED, MHD_CONNECTION_FOOTERS_RECEIVED, MHD_CONNECTION_FOOTERS_SENDING, MHD_CONNECTION_FOOTERS_SENT, MHD_CONNECTION_HEADER_PART_RECEIVED, MHD_CONNECTION_HEADERS_PROCESSED, MHD_CONNECTION_HEADERS_RECEIVED, MHD_CONNECTION_HEADERS_SENDING, MHD_CONNECTION_HEADERS_SENT, MHD_CONNECTION_INIT, MHD_CONNECTION_NORMAL_BODY_READY, MHD_CONNECTION_NORMAL_BODY_UNREADY, MHD_CONNECTION_URL_RECEIVED, MHD_HTTP_INTERNAL_SERVER_ERROR, MHD_HTTP_REQUEST_ENTITY_TOO_LARGE, MHD_HTTP_REQUEST_URI_TOO_LONG, MHD_NO, MHD_pool_create(), MHD_TLS_CONNECTION_INIT, MHD_USE_SELECT_INTERNALLY, MHD_USE_THREAD_PER_CONNECTION, MHD_YES, MHD_Daemon::options, MHD_Connection::pool, MHD_Daemon::pool_size, MHD_Connection::read_buffer_offset, MHD_Connection::read_buffer_size, MHD_Connection::read_closed, REQUEST_TOO_BIG, MHD_Connection::socket_fd, MHD_Connection::state, transmit_error_response(), try_grow_read_buffer(), and MHD_Connection::url.

Referenced by MHD_get_fdset(), and MHD_handle_connection().

Here is the call graph for this function:

Here is the caller graph for this function:

int MHD_connection_handle_idle ( struct MHD_Connection connection  ) 

This function was created to handle per-connection processing that has to happen even if the socket cannot be read or written to. All implementations (multithreaded, external select, internal select) call this function.

Returns:
MHD_YES if we should continue to process the connection (not dead yet), MHD_NO if it died

Definition at line 1763 of file connection.c.

References build_header_response(), call_connection_handler(), MHD_Connection::client_context, connection_close_error(), MHD_Daemon::connection_timeout, MHD_Connection::continue_message_write_offset, MHD_Response::crc, MHD_Connection::daemon, EXTRA_CHECK, get_next_header_line(), MHD_Connection::have_chunked_upload, MHD_Connection::headers_received, HTTP_100_CONTINUE, MHD_Connection::last_activity, MHD_Connection::method, MHD_CONNECTION_BODY_RECEIVED, MHD_CONNECTION_BODY_SENT, MHD_CONNECTION_CHUNKED_BODY_READY, MHD_CONNECTION_CHUNKED_BODY_UNREADY, MHD_CONNECTION_CLOSED, MHD_CONNECTION_CONTINUE_SENDING, MHD_CONNECTION_CONTINUE_SENT, MHD_CONNECTION_FOOTER_PART_RECEIVED, MHD_CONNECTION_FOOTERS_RECEIVED, MHD_CONNECTION_FOOTERS_SENDING, MHD_CONNECTION_FOOTERS_SENT, MHD_CONNECTION_HEADER_PART_RECEIVED, MHD_CONNECTION_HEADERS_PROCESSED, MHD_CONNECTION_HEADERS_RECEIVED, MHD_CONNECTION_HEADERS_SENDING, MHD_CONNECTION_HEADERS_SENT, MHD_CONNECTION_INIT, MHD_CONNECTION_NORMAL_BODY_READY, MHD_CONNECTION_NORMAL_BODY_UNREADY, MHD_CONNECTION_URL_RECEIVED, MHD_destroy_response(), MHD_FOOTER_KIND, MHD_HEADER_KIND, MHD_HTTP_BAD_REQUEST, MHD_HTTP_HEADER_CONNECTION, MHD_HTTP_VERSION_1_1, MHD_lookup_connection_value(), MHD_NO, MHD_pool_destroy(), MHD_pool_reset(), MHD_REQUEST_TERMINATED_COMPLETED_OK, MHD_YES, MHD_Response::mutex, need_100_continue(), MHD_Daemon::notify_completed, parse_connection_headers(), parse_initial_message_line(), MHD_Connection::pool, process_broken_line(), process_header_line(), MHD_Connection::read_buffer, MHD_Connection::read_buffer_offset, MHD_Connection::read_buffer_size, MHD_Connection::read_closed, MHD_Connection::remaining_upload_size, REQUEST_MALFORMED, MHD_Connection::response, MHD_Connection::response_write_position, MHD_Connection::responseCode, MHD_Connection::socket_fd, MHD_Connection::state, transmit_error_response(), try_ready_chunked_body(), try_ready_normal_body(), MHD_Connection::url, MHD_Connection::version, MHD_Connection::write_buffer, MHD_Connection::write_buffer_append_offset, MHD_Connection::write_buffer_send_offset, and MHD_Connection::write_buffer_size.

Referenced by MHD_set_http_calbacks(), and MHD_tls_connection_handle_idle().

Here is the call graph for this function:

Here is the caller graph for this function:

int MHD_connection_handle_read ( struct MHD_Connection connection  ) 

This function handles a particular connection when it has been determined that there is data to be read off a socket. All implementations (multithreaded, external select, internal select) call this function to handle reads.

Returns:
MHD_YES if we should continue to process the connection (not dead yet), MHD_NO if it died

Definition at line 1534 of file connection.c.

References connection_close_error(), MHD_Connection::daemon, do_read(), MHD_Connection::last_activity, MHD_CONNECTION_BODY_RECEIVED, MHD_CONNECTION_CLOSED, MHD_CONNECTION_CONTINUE_SENDING, MHD_CONNECTION_CONTINUE_SENT, MHD_CONNECTION_FOOTER_PART_RECEIVED, MHD_CONNECTION_HEADER_PART_RECEIVED, MHD_CONNECTION_HEADERS_PROCESSED, MHD_CONNECTION_HEADERS_RECEIVED, MHD_CONNECTION_INIT, MHD_CONNECTION_URL_RECEIVED, MHD_NO, MHD_pool_reallocate(), MHD_YES, MHD_Connection::pool, MHD_Connection::read_buffer, MHD_Connection::read_buffer_offset, MHD_Connection::read_buffer_size, MHD_Connection::read_closed, MHD_Connection::socket_fd, and MHD_Connection::state.

Referenced by MHD_set_http_calbacks(), and MHD_tls_connection_handle_read().

Here is the call graph for this function:

Here is the caller graph for this function:

int MHD_connection_handle_write ( struct MHD_Connection connection  ) 

This function was created to handle writes to sockets when it has been determined that the socket can be written to. All implementations (multithreaded, external select, internal select) call this function

Returns:
MHD_YES if we should continue to process the connection (not dead yet), MHD_NO if it died

Definition at line 1592 of file connection.c.

References check_write_done(), connection_close_error(), MHD_Connection::continue_message_write_offset, MHD_Response::crc, MHD_Connection::daemon, MHD_Response::data, MHD_Response::data_size, MHD_Response::data_start, do_write(), EXTRA_CHECK, FPRINTF, HTTP_100_CONTINUE, MHD_Connection::last_activity, MHD__gnutls_record_send(), MHD_CONNECTION_BODY_RECEIVED, MHD_CONNECTION_BODY_SENT, MHD_CONNECTION_CHUNKED_BODY_READY, MHD_CONNECTION_CHUNKED_BODY_UNREADY, MHD_CONNECTION_CLOSED, MHD_CONNECTION_CONTINUE_SENDING, MHD_CONNECTION_CONTINUE_SENT, MHD_CONNECTION_FOOTER_PART_RECEIVED, MHD_CONNECTION_FOOTERS_RECEIVED, MHD_CONNECTION_FOOTERS_SENDING, MHD_CONNECTION_FOOTERS_SENT, MHD_CONNECTION_HEADER_PART_RECEIVED, MHD_CONNECTION_HEADERS_PROCESSED, MHD_CONNECTION_HEADERS_RECEIVED, MHD_CONNECTION_HEADERS_SENDING, MHD_CONNECTION_HEADERS_SENT, MHD_CONNECTION_INIT, MHD_CONNECTION_NORMAL_BODY_READY, MHD_CONNECTION_NORMAL_BODY_UNREADY, MHD_CONNECTION_URL_RECEIVED, MHD_NO, MHD_TLS_CONNECTION_INIT, MHD_TLS_HANDSHAKE_FAILED, MHD_TLS_HELLO_REQUEST, MHD_USE_SSL, MHD_YES, MHD_Response::mutex, MHD_Daemon::options, MHD_Connection::response, MHD_Connection::response_write_position, MHD_Connection::send_cls, MHD_Connection::socket_fd, MHD_Connection::state, STRERROR, MHD_Response::total_size, and try_ready_normal_body().

Referenced by MHD_set_http_calbacks(), and MHD_tls_connection_handle_write().

Here is the call graph for this function:

Here is the caller graph for this function:

union MHD_ConnectionInfo* MHD_get_connection_info ( struct MHD_Connection connection,
enum MHD_ConnectionInfoType  infoType,
  ... 
) [write]

Obtain information about the given connection.

Parameters:
connection what connection to get information about
infoType what information is desired?
... depends on infoType
Returns:
NULL if this information is not available (or if the infoType is unknown)

Definition at line 2130 of file connection.c.

References MHD_Connection::addr, MHD_CONNECTION_INFO_CIPHER_ALGO, MHD_CONNECTION_INFO_CLIENT_ADDRESS, MHD_CONNECTION_INFO_PROTOCOL, and MHD_Connection::version.

int MHD_get_connection_values ( struct MHD_Connection connection,
enum MHD_ValueKind  kind,
MHD_KeyValueIterator  iterator,
void *  iterator_cls 
)

Get all of the headers from the request.

Parameters:
iterator callback to call on each header; maybe NULL (then just count headers)
iterator_cls extra argument to iterator
Returns:
number of entries iterated over

Definition at line 110 of file connection.c.

References MHD_HTTP_Header::header, MHD_Connection::headers_received, MHD_HTTP_Header::kind, MHD_YES, MHD_HTTP_Header::next, and MHD_HTTP_Header::value.

const char* MHD_lookup_connection_value ( struct MHD_Connection connection,
enum MHD_ValueKind  kind,
const char *  key 
)

Get a particular header value. If multiple values match the kind, return any one of them.

Parameters:
key the header to look for
Returns:
NULL if no such item was found

Definition at line 192 of file connection.c.

References MHD_HTTP_Header::header, MHD_Connection::headers_received, MHD_HTTP_Header::kind, MHD_HTTP_Header::next, and MHD_HTTP_Header::value.

Referenced by MHD_connection_handle_idle(), MHD_create_post_processor(), need_100_continue(), parse_connection_headers(), and parse_cookie_header().

Here is the caller graph for this function:

int MHD_queue_response ( struct MHD_Connection connection,
unsigned int  status_code,
struct MHD_Response response 
)

Queue a response to be transmitted to the client (as soon as possible but after MHD_AccessHandlerCallback returns).

Parameters:
connection the connection identifying the client
status_code HTTP status code (i.e. 200 for OK)
response response to transmit
Returns:
MHD_NO on error (i.e. reply already sent), MHD_YES on success or if message has been queued

Definition at line 220 of file connection.c.

References MHD_Connection::have_chunked_response, MHD_Connection::method, MHD_CONNECTION_FOOTERS_RECEIVED, MHD_CONNECTION_HEADERS_PROCESSED, MHD_HTTP_METHOD_HEAD, MHD_HTTP_VERSION_1_1, MHD_increment_response_rc(), MHD_NO, MHD_YES, MHD_Connection::read_closed, MHD_Connection::response, MHD_Connection::response_write_position, MHD_Connection::responseCode, SHUTDOWN, MHD_Connection::socket_fd, MHD_Connection::state, MHD_Response::total_size, and MHD_Connection::version.

Referenced by parse_connection_headers(), and transmit_error_response().

Here is the call graph for this function:

Here is the caller graph for this function:

int MHD_set_connection_value ( struct MHD_Connection connection,
enum MHD_ValueKind  kind,
const char *  key,
const char *  value 
)

This function can be used to add an entry to the HTTP headers of a connection (so that the MHD_get_connection_values function will return them -- and the MHD PostProcessor will also see them). This maybe required in certain situations (see Mantis #1399) where (broken) HTTP implementations fail to supply values needed by the post processor (or other parts of the application).

This function MUST only be called from within the MHD_AccessHandlerCallback (otherwise, access maybe improperly synchronized). Furthermore, the client must guarantee that the key and value arguments are 0-terminated strings that are NOT freed until the connection is closed. (The easiest way to do this is by passing only arguments to permanently allocated strings.).

Parameters:
connection the connection for which a value should be set
kind kind of the value
key key for the value
value the value itself
Returns:
MHD_NO if the operation could not be performed due to insufficient memory; MHD_YES on success

Definition at line 166 of file connection.c.

References MHD_HTTP_Header::header, MHD_Connection::headers_received, MHD_HTTP_Header::kind, MHD_NO, MHD_pool_allocate(), MHD_YES, MHD_HTTP_Header::next, MHD_Connection::pool, and MHD_HTTP_Header::value.

Here is the call graph for this function:

void MHD_set_http_calbacks ( struct MHD_Connection connection  ) 

Definition at line 2108 of file connection.c.

References MHD_Connection::idle_handler, MHD_connection_handle_idle(), MHD_connection_handle_read(), MHD_connection_handle_write(), MHD_Connection::read_handler, and MHD_Connection::write_handler.

Referenced by MHD_accept_connection().

Here is the call graph for this function:

Here is the caller graph for this function:

static int need_100_continue ( struct MHD_Connection connection  )  [static]

Do we (still) need to send a 100 continue message for this connection?

Definition at line 261 of file connection.c.

References MHD_Connection::continue_message_write_offset, HTTP_100_CONTINUE, MHD_HEADER_KIND, MHD_HTTP_HEADER_EXPECT, MHD_HTTP_VERSION_1_1, MHD_lookup_connection_value(), MHD_Connection::response, and MHD_Connection::version.

Referenced by MHD_connection_handle_idle().

Here is the call graph for this function:

Here is the caller graph for this function:

static int parse_arguments ( enum MHD_ValueKind  kind,
struct MHD_Connection connection,
char *  args 
) [static]

Returns:
MHD_NO on failure (out of memory), MHD_YES for success

Definition at line 915 of file connection.c.

References connection_add_header(), MHD_http_unescape(), MHD_NO, and MHD_YES.

Referenced by parse_initial_message_line().

Here is the call graph for this function:

Here is the caller graph for this function:

static void parse_connection_headers ( struct MHD_Connection connection  )  [static]

static int parse_cookie_header ( struct MHD_Connection connection  )  [static]

Parse the cookie header (see RFC 2109).

Returns:
MHD_YES for success, MHD_NO for failure (malformed, out of memory)

Definition at line 949 of file connection.c.

References connection_add_header(), MHD_Connection::daemon, MHD_COOKIE_KIND, MHD_HEADER_KIND, MHD_HTTP_REQUEST_ENTITY_TOO_LARGE, MHD_lookup_connection_value(), MHD_NO, MHD_pool_allocate(), MHD_YES, old, MHD_Connection::pool, REQUEST_TOO_BIG, and transmit_error_response().

Referenced by parse_connection_headers().

Here is the call graph for this function:

Here is the caller graph for this function:

static int parse_initial_message_line ( struct MHD_Connection connection,
char *  line 
) [static]

Parse the first line of the HTTP HEADER.

Parameters:
connection the connection (updated)
line the first line
Returns:
MHD_YES if the line is ok, MHD_NO if it is malformed

Definition at line 1042 of file connection.c.

References MHD_Connection::client_context, MHD_Connection::daemon, MHD_Connection::method, MHD_GET_ARGUMENT_KIND, MHD_http_unescape(), MHD_NO, MHD_YES, parse_arguments(), MHD_Daemon::uri_log_callback, MHD_Connection::url, and MHD_Connection::version.

Referenced by MHD_connection_handle_idle().

Here is the call graph for this function:

Here is the caller graph for this function:

static int process_broken_line ( struct MHD_Connection connection,
char *  line,
enum MHD_ValueKind  kind 
) [static]

Process a header value that spans multiple lines. The previous line(s) are in connection->last.

Parameters:
line the current input line
kind if the line is complete, add a header of the given kind
Returns:
MHD_YES if the line was processed successfully

Definition at line 1400 of file connection.c.

References MHD_Connection::colon, connection_add_header(), EXTRA_CHECK, MHD_Connection::last, MHD_HTTP_BAD_REQUEST, MHD_HTTP_REQUEST_ENTITY_TOO_LARGE, MHD_NO, MHD_pool_reallocate(), MHD_YES, MHD_Connection::pool, process_header_line(), REQUEST_MALFORMED, REQUEST_TOO_BIG, and transmit_error_response().

Referenced by MHD_connection_handle_idle().

Here is the call graph for this function:

Here is the caller graph for this function:

static int process_header_line ( struct MHD_Connection connection,
char *  line 
) [static]

We have received (possibly the beginning of) a line in the header (or footer). Validate (check for ":") and prepare to process.

Definition at line 1359 of file connection.c.

References MHD_Connection::colon, MHD_Connection::daemon, MHD_Connection::last, MHD_CONNECTION_CLOSED, MHD_NO, MHD_YES, and MHD_Connection::state.

Referenced by MHD_connection_handle_idle(), and process_broken_line().

Here is the caller graph for this function:

static void transmit_error_response ( struct MHD_Connection connection,
unsigned int  status_code,
const char *  message 
) [static]

We encountered an error processing the request. Handle it properly by stopping to read data and sending the indicated response code and message.

Parameters:
status_code the response code to send (400, 413 or 414)

Definition at line 621 of file connection.c.

References build_header_response(), MHD_Connection::daemon, EXTRA_CHECK, MHD_CONNECTION_CLOSED, MHD_CONNECTION_FOOTERS_RECEIVED, MHD_CONNECTION_HEADERS_SENDING, MHD_create_response_from_data(), MHD_destroy_response(), MHD_NO, MHD_queue_response(), MHD_YES, MHD_Connection::read_closed, MHD_Connection::response, and MHD_Connection::state.

Referenced by connection_add_header(), get_next_header_line(), MHD_connection_get_fdset(), MHD_connection_handle_idle(), parse_cookie_header(), and process_broken_line().

Here is the call graph for this function:

Here is the caller graph for this function:

static int try_grow_read_buffer ( struct MHD_Connection connection  )  [static]

Try growing the read buffer

Returns:
MHD_YES on success, MHD_NO on failure

Definition at line 510 of file connection.c.

References MHD_BUF_INC_SIZE, MHD_NO, MHD_pool_reallocate(), MHD_YES, MHD_Connection::pool, MHD_Connection::read_buffer, and MHD_Connection::read_buffer_size.

Referenced by MHD_connection_get_fdset().

Here is the call graph for this function:

Here is the caller graph for this function:

static int try_ready_chunked_body ( struct MHD_Connection connection  )  [static]

Prepare the response buffer of this connection for sending. Assumes that the response mutex is already held. If the transmission is complete, this function may close the socket (and return MHD_NO).

Returns:
MHD_NO if readying the response failed

Definition at line 364 of file connection.c.

References connection_close_error(), MHD_Response::crc, MHD_Response::crc_cls, MHD_Connection::daemon, EXTRA_CHECK, MHD_CONNECTION_CHUNKED_BODY_UNREADY, MHD_NO, MHD_pool_allocate(), MHD_YES, MHD_Connection::pool, MHD_Daemon::pool_size, MHD_Connection::response, MHD_Connection::response_write_position, SPRINTF, MHD_Connection::state, MHD_Response::total_size, MHD_Connection::write_buffer, MHD_Connection::write_buffer_append_offset, MHD_Connection::write_buffer_send_offset, and MHD_Connection::write_buffer_size.

Referenced by MHD_connection_handle_idle().

Here is the call graph for this function:

Here is the caller graph for this function:

static int try_ready_normal_body ( struct MHD_Connection connection  )  [static]

Prepare the response buffer of this connection for sending. Assumes that the response mutex is already held. If the transmission is complete, this function may close the socket (and return MHD_NO).

Returns:
MHD_NO if readying the response failed

Definition at line 317 of file connection.c.

References connection_close_error(), MHD_Response::crc, MHD_Response::crc_cls, MHD_Connection::daemon, MHD_Response::data, MHD_Response::data_buffer_size, MHD_Response::data_size, MHD_Response::data_start, MHD_MIN, MHD_NO, MHD_USE_SELECT_INTERNALLY, MHD_YES, MHD_Daemon::options, MHD_Connection::response, MHD_Connection::response_write_position, and MHD_Response::total_size.

Referenced by MHD_connection_handle_idle(), and MHD_connection_handle_write().

Here is the call graph for this function:

Here is the caller graph for this function:


Generated on Fri Feb 27 18:18:45 2009 for GNU libmicrohttpd by  doxygen 1.5.8