blob: 693e26fc5974e716330f953c614d1954df0efea5 [file] [log] [blame]
/*
This file is part of libmicrohttpd
Copyright (C) 2007 Daniel Pittman and Christian Grothoff
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Lesser General Public
License as published by the Free Software Foundation; either
version 2.1 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
/**
* @file connection.h
* @brief Methods for managing connections
* @author Daniel Pittman
* @author Christian Grothoff
* @author Karlson2k (Evgeny Grin)
*/
#ifndef CONNECTION_H
#define CONNECTION_H
#include "internal.h"
/**
* Error code similar to EGAIN or EINTR
*/
#define MHD_ERR_AGAIN_ (-3073)
/**
* Connection was hard-closed by remote peer.
*/
#define MHD_ERR_CONNRESET_ (-3074)
/**
* Connection is not connected anymore due to
* network error or any other reason.
*/
#define MHD_ERR_NOTCONN_ (-3075)
/**
* "Not enough memory" error code
*/
#define MHD_ERR_NOMEM_ (-3076)
/**
* "Bad FD" error code
*/
#define MHD_ERR_BADF_ (-3077)
/**
* Error code similar to EINVAL
*/
#define MHD_ERR_INVAL_ (-3078)
/**
* Argument values are not supported
*/
#define MHD_ERR_OPNOTSUPP_ (-3079)
/**
* Socket is shut down for writing or no longer connected
*/
#define MHD_ERR_PIPE_ (-3080)
/**
* General TLS encryption or decryption error
*/
#define MHD_ERR_TLS_ (-4097)
/**
* Set callbacks for this connection to those for HTTP.
*
* @param connection connection to initialize
*/
void
MHD_set_http_callbacks_ (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 polling, internal polling)
* call this function to handle reads.
*
* @param connection connection to handle
* @param socket_error set to true if socket error was detected
*/
void
MHD_connection_handle_read (struct MHD_Connection *connection,
bool socket_error);
/**
* 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
*
* @param connection connection to handle
*/
void
MHD_connection_handle_write (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.
* @remark To be called only from thread that process connection's
* recv(), send() and response.
*
* @param connection connection to handle
* @return #MHD_YES if we should continue to process the
* connection (not dead yet), #MHD_NO if it died
*/
enum MHD_Result
MHD_connection_handle_idle (struct MHD_Connection *connection);
/**
* Mark connection as "closed".
* @remark To be called from any thread.
*
* @param connection connection to close
*/
void
MHD_connection_mark_closed_ (struct MHD_Connection *connection);
/**
* Close the given connection and give the
* specified termination code to the user.
* @remark To be called only from thread that
* process connection's recv(), send() and response.
*
* @param connection connection to close
* @param termination_code termination reason to give
*/
void
MHD_connection_close_ (struct MHD_Connection *connection,
enum MHD_RequestTerminationCode termination_code);
#ifdef HTTPS_SUPPORT
/**
* Stop TLS forwarding on upgraded connection and
* reflect remote disconnect state to socketpair.
* @param connection the upgraded connection
*/
void
MHD_connection_finish_forward_ (struct MHD_Connection *connection);
#else /* ! HTTPS_SUPPORT */
#define MHD_connection_finish_forward_(conn) (void) conn
#endif /* ! HTTPS_SUPPORT */
#ifdef EPOLL_SUPPORT
/**
* Perform epoll processing, possibly moving the connection back into
* the epoll set if needed.
*
* @param connection connection to process
* @return #MHD_YES if we should continue to process the
* connection (not dead yet), #MHD_NO if it died
*/
enum MHD_Result
MHD_connection_epoll_update_ (struct MHD_Connection *connection);
#endif
/**
* Update the 'last_activity' field of the connection to the current time
* and move the connection to the head of the 'normal_timeout' list if
* the timeout for the connection uses the default value.
*
* @param connection the connection that saw some activity
*/
void
MHD_update_last_activity_ (struct MHD_Connection *connection);
/**
* Allocate memory from connection's memory pool.
* If memory pool doesn't have enough free memory but read or write buffer
* have some unused memory, the size of the buffer will be reduced as needed.
* @param connection the connection to use
* @param size the size of allocated memory area
* @return pointer to allocated memory region in the pool or
* NULL if no memory is available
*/
void *
MHD_connection_alloc_memory_ (struct MHD_Connection *connection,
size_t size);
#endif