1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
|
/*
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"
/**
* 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 select, internal select)
* call this function to handle reads.
*
* @param connection connection to handle
* @return always MHD_YES (we should continue to process the
* connection)
*/
int
MHD_connection_handle_read (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
*
* @param connection connection to handle
* @return always MHD_YES (we should continue to process the
* connection)
*/
int
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
*/
int
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
*/
int
MHD_connection_epoll_update_ (struct MHD_Connection *connection);
#endif
#endif
|
