OpenMPI 0.1.1

- Main Page
- Related Pages
- Modules
- Data Structures
- Files

- File List
- Globals

http.h
Go to the documentation of this file.
1 /*
2 * Copyright (c) 2000-2007 Niels Provos <provos@citi.umich.edu>
3 * Copyright (c) 2007-2010 Niels Provos and Nick Mathewson
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. The name of the author may not be used to endorse or promote products
14 * derived from this software without specific prior written permission.
15 *
16 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
17 * IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
18 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
19 * IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
20 * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
21 * NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
22 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
23 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
25 * THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26 */
27 #ifndef _EVENT2_HTTP_H_
28 #define _EVENT2_HTTP_H_
29
30 /* For int types. */
31 #include <event2/util.h>
32
33 #ifdef __cplusplus
34 extern "C" {
35 #endif
36
37 /* In case we haven't included the right headers yet. */
38 struct evbuffer;
39 struct event_base;
40
41 /** @file event2/http.h
42 *
43 * Basic support for HTTP serving.
44 *
45 * As Libevent is a library for dealing with event notification and most
46 * interesting applications are networked today, I have often found the
47 * need to write HTTP code. The following prototypes and definitions provide
48 * an application with a minimal interface for making HTTP requests and for
49 * creating a very simple HTTP server.
50 */
51
52 /* Response codes */
53 #define HTTP_OK 200 /**< request completed ok */
54 #define HTTP_NOCONTENT 204 /**< request does not have content */
55 #define HTTP_MOVEPERM 301 /**< the uri moved permanently */
56 #define HTTP_MOVETEMP 302 /**< the uri moved temporarily */
57 #define HTTP_NOTMODIFIED 304 /**< page was not modified from last */
58 #define HTTP_BADREQUEST 400 /**< invalid http request was made */
59 #define HTTP_NOTFOUND 404 /**< could not find content for uri */
60 #define HTTP_BADMETHOD 405 /**< method not allowed for this uri */
61 #define HTTP_ENTITYTOOLARGE 413 /**< */
62 #define HTTP_EXPECTATIONFAILED 417 /**< we can't handle this expectation */
63 #define HTTP_INTERNAL 500 /**< internal error */
64 #define HTTP_NOTIMPLEMENTED 501 /**< not implemented */
65 #define HTTP_SERVUNAVAIL 503 /**< the server is not available */
66
67 struct evhttp;
68 struct evhttp_request;
69 struct evkeyvalq;
70 struct evhttp_bound_socket;
71 struct evconnlistener;
72
73 /**
74 * Create a new HTTP server.
75 *
76 * @param base (optional) the event base to receive the HTTP events
77 * @return a pointer to a newly initialized evhttp server structure
78 * @see evhttp_free()
79 */
80 struct evhttp *evhttp_new(struct event_base *base);
81
82 /**
83 * Binds an HTTP server on the specified address and port.
84 *
85 * Can be called multiple times to bind the same http server
86 * to multiple different ports.
87 *
88 * @param http a pointer to an evhttp object
89 * @param address a string containing the IP address to listen(2) on
90 * @param port the port number to listen on
91 * @return 0 on success, -1 on failure.
92 * @see evhttp_accept_socket()
93 */
94 int evhttp_bind_socket(struct evhttp *http, const char *address, ev_uint16_t port);
95
96 /**
97 * Like evhttp_bind_socket(), but returns a handle for referencing the socket.
98 *
99 * The returned pointer is not valid after \a http is freed.
100 *
101 * @param http a pointer to an evhttp object
102 * @param address a string containing the IP address to listen(2) on
103 * @param port the port number to listen on
104 * @return Handle for the socket on success, NULL on failure.
105 * @see evhttp_bind_socket(), evhttp_del_accept_socket()
106 */
107 struct evhttp_bound_socket *evhttp_bind_socket_with_handle(struct evhttp *http, const char *address, ev_uint16_t port);
108
109 /**
110 * Makes an HTTP server accept connections on the specified socket.
111 *
112 * This may be useful to create a socket and then fork multiple instances
113 * of an http server, or when a socket has been communicated via file
114 * descriptor passing in situations where an http servers does not have
115 * permissions to bind to a low-numbered port.
116 *
117 * Can be called multiple times to have the http server listen to
118 * multiple different sockets.
119 *
120 * @param http a pointer to an evhttp object
121 * @param fd a socket fd that is ready for accepting connections
122 * @return 0 on success, -1 on failure.
123 * @see evhttp_bind_socket()
124 */
125 int evhttp_accept_socket(struct evhttp *http, evutil_socket_t fd);
126
127 /**
128 * Like evhttp_accept_socket(), but returns a handle for referencing the socket.
129 *
130 * The returned pointer is not valid after \a http is freed.
131 *
132 * @param http a pointer to an evhttp object
133 * @param fd a socket fd that is ready for accepting connections
134 * @return Handle for the socket on success, NULL on failure.
135 * @see evhttp_accept_socket(), evhttp_del_accept_socket()
136 */
137 struct evhttp_bound_socket *evhttp_accept_socket_with_handle(struct evhttp *http, evutil_socket_t fd);
138
139 /**
140 * The most low-level evhttp_bind/accept method: takes an evconnlistener, and
141 * returns an evhttp_bound_socket. The listener will be freed when the bound
142 * socket is freed.
143 */
144 struct evhttp_bound_socket *evhttp_bind_listener(struct evhttp *http, struct evconnlistener *listener);
145
146 /**
147 * Return the listener used to implement a bound socket.
148 */
149 struct evconnlistener *evhttp_bound_socket_get_listener(struct evhttp_bound_socket *bound);
150
151 /**
152 * Makes an HTTP server stop accepting connections on the specified socket
153 *
154 * This may be useful when a socket has been sent via file descriptor passing
155 * and is no longer needed by the current process.
156 *
157 * If you created this bound socket with evhttp_bind_socket_with_handle or
158 * evhttp_accept_socket_with_handle, this function closes the fd you provided.
159 * If you created this bound socket with evhttp_bind_listener, this function
160 * frees the listener you provided.
161 *
162 * \a bound_socket is an invalid pointer after this call returns.
163 *
164 * @param http a pointer to an evhttp object
165 * @param bound_socket a handle returned by evhttp_{bind,accept}_socket_with_handle
166 * @see evhttp_bind_socket_with_handle(), evhttp_accept_socket_with_handle()
167 */
168 void evhttp_del_accept_socket(struct evhttp *http, struct evhttp_bound_socket *bound_socket);
169
170 /**
171 * Get the raw file descriptor referenced by an evhttp_bound_socket.
172 *
173 * @param bound_socket a handle returned by evhttp_{bind,accept}_socket_with_handle
174 * @return the file descriptor used by the bound socket
175 * @see evhttp_bind_socket_with_handle(), evhttp_accept_socket_with_handle()
176 */
177 evutil_socket_t evhttp_bound_socket_get_fd(struct evhttp_bound_socket *bound_socket);
178
179 /**
180 * Free the previously created HTTP server.
181 *
182 * Works only if no requests are currently being served.
183 *
184 * @param http the evhttp server object to be freed
185 * @see evhttp_start()
186 */
187 void evhttp_free(struct evhttp* http);
188
189 /** XXX Document. */
190 void evhttp_set_max_headers_size(struct evhttp* http, ev_ssize_t max_headers_size);
191 /** XXX Document. */
192 void evhttp_set_max_body_size(struct evhttp* http, ev_ssize_t max_body_size);
193
194 /**
195 Sets the what HTTP methods are supported in requests accepted by this
196 server, and passed to user callbacks.
197
198 If not supported they will generate a "405 Method not allowed" response.
199
200 By default this includes the following methods: GET, POST, HEAD, PUT, DELETE
201
202 @param http the http server on which to set the methods
203 @param methods bit mask constructed from evhttp_cmd_type values
204 */
205 void evhttp_set_allowed_methods(struct evhttp* http, ev_uint16_t methods);
206
207 /**
208 Set a callback for a specified URI
209
210 @param http the http sever on which to set the callback
211 @param path the path for which to invoke the callback
212 @param cb the callback function that gets invoked on requesting path
213 @param cb_arg an additional context argument for the callback
214 @return 0 on success, -1 if the callback existed already, -2 on failure
215 */
216 int evhttp_set_cb(struct evhttp *http, const char *path,
217 void (*cb)(struct evhttp_request *, void *), void *cb_arg);
218
219 /** Removes the callback for a specified URI */
220 int evhttp_del_cb(struct evhttp *, const char *);
221
222 /**
223 Set a callback for all requests that are not caught by specific callbacks
224
225 Invokes the specified callback for all requests that do not match any of
226 the previously specified request paths. This is catchall for requests not
227 specifically configured with evhttp_set_cb().
228
229 @param http the evhttp server object for which to set the callback
230 @param cb the callback to invoke for any unmatched requests
231 @param arg an context argument for the callback
232 */
233 void evhttp_set_gencb(struct evhttp *http,
234 void (*cb)(struct evhttp_request *, void *), void *arg);
235
236 /**
237 Adds a virtual host to the http server.
238
239 A virtual host is a newly initialized evhttp object that has request
240 callbacks set on it via evhttp_set_cb() or evhttp_set_gencb(). It
241 most not have any listing sockets associated with it.
242
243 If the virtual host has not been removed by the time that evhttp_free()
244 is called on the main http server, it will be automatically freed, too.
245
246 It is possible to have hierarchical vhosts. For example: A vhost
247 with the pattern *.example.com may have other vhosts with patterns
248 foo.example.com and bar.example.com associated with it.
249
250 @param http the evhttp object to which to add a virtual host
251 @param pattern the glob pattern against which the hostname is matched.
252 The match is case insensitive and follows otherwise regular shell
253 matching.
254 @param vhost the virtual host to add the regular http server.
255 @return 0 on success, -1 on failure
256 @see evhttp_remove_virtual_host()
257 */
258 int evhttp_add_virtual_host(struct evhttp* http, const char *pattern,
259 struct evhttp* vhost);
260
261 /**
262 Removes a virtual host from the http server.
263
264 @param http the evhttp object from which to remove the virtual host
265 @param vhost the virtual host to remove from the regular http server.
266 @return 0 on success, -1 on failure
267 @see evhttp_add_virtual_host()
268 */
269 int evhttp_remove_virtual_host(struct evhttp* http, struct evhttp* vhost);
270
271 /**
272 Add a server alias to an http object. The http object can be a virtual
273 host or the main server.
274
275 @param http the evhttp object
276 @param alias the alias to add
277 @see evhttp_add_remove_alias()
278 */
279 int evhttp_add_server_alias(struct evhttp *http, const char *alias);
280
281 /**
282 Remove a server alias from an http object.
283
284 @param http the evhttp object
285 @param alias the alias to remove
286 @see evhttp_add_server_alias()
287 */
288 int evhttp_remove_server_alias(struct evhttp *http, const char *alias);
289
290 /**
291 * Set the timeout for an HTTP request.
292 *
293 * @param http an evhttp object
294 * @param timeout_in_secs the timeout, in seconds
295 */
296 void evhttp_set_timeout(struct evhttp *http, int timeout_in_secs);
297
298 /* Request/Response functionality */
299
300 /**
301 * Send an HTML error message to the client.
302 *
303 * @param req a request object
304 * @param error the HTTP error code
305 * @param reason a brief explanation of the error. If this is NULL, we'll
306 * just use the standard meaning of the error code.
307 */
308 void evhttp_send_error(struct evhttp_request *req, int error,
309 const char *reason);
310
311 /**
312 * Send an HTML reply to the client.
313 *
314 * The body of the reply consists of the data in databuf. After calling
315 * evhttp_send_reply() databuf will be empty, but the buffer is still
316 * owned by the caller and needs to be deallocated by the caller if
317 * necessary.
318 *
319 * @param req a request object
320 * @param code the HTTP response code to send
321 * @param reason a brief message to send with the response code
322 * @param databuf the body of the response
323 */
324 void evhttp_send_reply(struct evhttp_request *req, int code,
325 const char *reason, struct evbuffer *databuf);
326
327 /* Low-level response interface, for streaming/chunked replies */
328
329 /**
330 Initiate a reply that uses Transfer-Encoding chunked.
331
332 This allows the caller to stream the reply back to the client and is
333 useful when either not all of the reply data is immediately available
334 or when sending very large replies.
335
336 The caller needs to supply data chunks with evhttp_send_reply_chunk()
337 and complete the reply by calling evhttp_send_reply_end().
338
339 @param req a request object
340 @param code the HTTP response code to send
341 @param reason a brief message to send with the response code
342 */
343 void evhttp_send_reply_start(struct evhttp_request *req, int code,
344 const char *reason);
345
346 /**
347 Send another data chunk as part of an ongoing chunked reply.
348
349 The reply chunk consists of the data in databuf. After calling
350 evhttp_send_reply_chunk() databuf will be empty, but the buffer is
351 still owned by the caller and needs to be deallocated by the caller
352 if necessary.
353
354 @param req a request object
355 @param databuf the data chunk to send as part of the reply.
356 */
357 void evhttp_send_reply_chunk(struct evhttp_request *req,
358 struct evbuffer *databuf);
359 /**
360 Complete a chunked reply.
361
362 @param req a request object
363 */
364 void evhttp_send_reply_end(struct evhttp_request *req);
365
366 /*
367 * Interfaces for making requests
368 */
369
370 /** The different request types supported by evhttp. These are as specified
371 * in RFC2616, except for PATCH which is specified by RFC5789.
372 *
373 * By default, only some of these methods are accepted and passed to user
374 * callbacks; use evhttp_set_allowed_methods() to change which methods
375 * are allowed.
376 */
377 enum evhttp_cmd_type {
378 EVHTTP_REQ_GET = 1 << 0,
379 EVHTTP_REQ_POST = 1 << 1,
380 EVHTTP_REQ_HEAD = 1 << 2,
381 EVHTTP_REQ_PUT = 1 << 3,
382 EVHTTP_REQ_DELETE = 1 << 4,
383 EVHTTP_REQ_OPTIONS = 1 << 5,
384 EVHTTP_REQ_TRACE = 1 << 6,
385 EVHTTP_REQ_CONNECT = 1 << 7,
386 EVHTTP_REQ_PATCH = 1 << 8
387 };
388
389 /** a request object can represent either a request or a reply */
390 enum evhttp_request_kind { EVHTTP_REQUEST, EVHTTP_RESPONSE };
391
392 /**
393 * Creates a new request object that needs to be filled in with the request
394 * parameters. The callback is executed when the request completed or an
395 * error occurred.
396 */
397 struct evhttp_request *evhttp_request_new(
398 void (*cb)(struct evhttp_request *, void *), void *arg);
399
400 /**
401 * Enable delivery of chunks to requestor.
402 * @param cb will be called after every read of data with the same argument
403 * as the completion callback. Will never be called on an empty
404 * response. May drain the input buffer; it will be drained
405 * automatically on return.
406 */
407 void evhttp_request_set_chunked_cb(struct evhttp_request *,
408 void (*cb)(struct evhttp_request *, void *));
409
410 /** Frees the request object and removes associated events. */
411 void evhttp_request_free(struct evhttp_request *req);
412
413 struct evdns_base;
414
415 /**
416 * A connection object that can be used to for making HTTP requests. The
417 * connection object tries to resolve address and establish the connection
418 * when it is given an http request object.
419 *
420 * @param base the event_base to use for handling the connection
421 * @param dnsbase the dns_base to use for resolving host names; if not
422 * specified host name resolution will block.
423 * @param address the address to which to connect
424 * @param port the port to connect to
425 * @return an evhttp_connection object that can be used for making requests
426 */
427 struct evhttp_connection *evhttp_connection_base_new(
428 struct event_base *base, struct evdns_base *dnsbase,
429 const char *address, unsigned short port);
430
431 /** Takes ownership of the request object
432 *
433 * Can be used in a request callback to keep onto the request until
434 * evhttp_request_free() is explicitly called by the user.
435 */
436 void evhttp_request_own(struct evhttp_request *req);
437
438 /** Returns 1 if the request is owned by the user */
439 int evhttp_request_is_owned(struct evhttp_request *req);
440
441 /**
442 * Returns the connection object associated with the request or NULL
443 *
444 * The user needs to either free the request explicitly or call
445 * evhttp_send_reply_end().
446 */
447 struct evhttp_connection *evhttp_request_get_connection(struct evhttp_request *req);
448
449 /**
450 * Returns the underlying event_base for this connection
451 */
452 struct event_base *evhttp_connection_get_base(struct evhttp_connection *req);
453
454 void evhttp_connection_set_max_headers_size(struct evhttp_connection *evcon,
455 ev_ssize_t new_max_headers_size);
456
457 void evhttp_connection_set_max_body_size(struct evhttp_connection* evcon,
458 ev_ssize_t new_max_body_size);
459
460 /** Frees an http connection */
461 void evhttp_connection_free(struct evhttp_connection *evcon);
462
463 /** sets the ip address from which http connections are made */
464 void evhttp_connection_set_local_address(struct evhttp_connection *evcon,
465 const char *address);
466
467 /** sets the local port from which http connections are made */
468 void evhttp_connection_set_local_port(struct evhttp_connection *evcon,
469 ev_uint16_t port);
470
471 /** Sets the timeout for events related to this connection */
472 void evhttp_connection_set_timeout(struct evhttp_connection *evcon,
473 int timeout_in_secs);
474
475 /** Sets the retry limit for this connection - -1 repeats indefinitely */
476 void evhttp_connection_set_retries(struct evhttp_connection *evcon,
477 int retry_max);
478
479 /** Set a callback for connection close. */
480 void evhttp_connection_set_closecb(struct evhttp_connection *evcon,
481 void (*)(struct evhttp_connection *, void *), void *);
482
483 /** Get the remote address and port associated with this connection. */
484 void evhttp_connection_get_peer(struct evhttp_connection *evcon,
485 char **address, ev_uint16_t *port);
486
487 /**
488 Make an HTTP request over the specified connection.
489
490 The connection gets ownership of the request. On failure, the
491 request object is no longer valid as it has been freed.
492
493 @param evcon the evhttp_connection object over which to send the request
494 @param req the previously created and configured request object
495 @param type the request type EVHTTP_REQ_GET, EVHTTP_REQ_POST, etc.
496 @param uri the URI associated with the request
497 @return 0 on success, -1 on failure
498 @see evhttp_cancel_request()
499 */
500 int evhttp_make_request(struct evhttp_connection *evcon,
501 struct evhttp_request *req,
502 enum evhttp_cmd_type type, const char *uri);
503
504 /**
505 Cancels a pending HTTP request.
506
507 Cancels an ongoing HTTP request. The callback associated with this request
508 is not executed and the request object is freed. If the request is
509 currently being processed, e.g. it is ongoing, the corresponding
510 evhttp_connection object is going to get reset.
511
512 A request cannot be canceled if its callback has executed already. A request
513 may be canceled reentrantly from its chunked callback.
514
515 @param req the evhttp_request to cancel; req becomes invalid after this call.
516 */
517 void evhttp_cancel_request(struct evhttp_request *req);
518
519 /**
520 * A structure to hold a parsed URI or Relative-Ref conforming to RFC3986.
521 */
522 struct evhttp_uri;
523
524 /** Returns the request URI */
525 const char *evhttp_request_get_uri(const struct evhttp_request *req);
526 /** Returns the request URI (parsed) */
527 const struct evhttp_uri *evhttp_request_get_evhttp_uri(const struct evhttp_request *req);
528 /** Returns the request command */
529 enum evhttp_cmd_type evhttp_request_get_command(const struct evhttp_request *req);
530
531 int evhttp_request_get_response_code(const struct evhttp_request *req);
532
533 /** Returns the input headers */
534 struct evkeyvalq *evhttp_request_get_input_headers(struct evhttp_request *req);
535 /** Returns the output headers */
536 struct evkeyvalq *evhttp_request_get_output_headers(struct evhttp_request *req);
537 /** Returns the input buffer */
538 struct evbuffer *evhttp_request_get_input_buffer(struct evhttp_request *req);
539 /** Returns the output buffer */
540 struct evbuffer *evhttp_request_get_output_buffer(struct evhttp_request *req);
541 /** Returns the host associated with the request. If a client sends an absolute
542 URI, the host part of that is preferred. Otherwise, the input headers are
543 searched for a Host: header. NULL is returned if no absolute URI or Host:
544 header is provided. */
545 const char *evhttp_request_get_host(struct evhttp_request *req);
546
547 /* Interfaces for dealing with HTTP headers */
548
549 /**
550 Finds the value belonging to a header.
551
552 @param headers the evkeyvalq object in which to find the header
553 @param key the name of the header to find
554 @returns a pointer to the value for the header or NULL if the header
555 count not be found.
556 @see evhttp_add_header(), evhttp_remove_header()
557 */
558 const char *evhttp_find_header(const struct evkeyvalq *headers,
559 const char *key);
560
561 /**
562 Removes a header from a list of existing headers.
563
564 @param headers the evkeyvalq object from which to remove a header
565 @param key the name of the header to remove
566 @returns 0 if the header was removed, -1 otherwise.
567 @see evhttp_find_header(), evhttp_add_header()
568 */
569 int evhttp_remove_header(struct evkeyvalq *headers, const char *key);
570
571 /**
572 Adds a header to a list of existing headers.
573
574 @param headers the evkeyvalq object to which to add a header
575 @param key the name of the header
576 @param value the value belonging to the header
577 @returns 0 on success, -1 otherwise.
578 @see evhttp_find_header(), evhttp_clear_headers()
579 */
580 int evhttp_add_header(struct evkeyvalq *headers, const char *key, const char *value);
581
582 /**
583 Removes all headers from the header list.
584
585 @param headers the evkeyvalq object from which to remove all headers
586 */
587 void evhttp_clear_headers(struct evkeyvalq *headers);
588
589 /* Miscellaneous utility functions */
590
591
592 /**
593 Helper function to encode a string for inclusion in a URI. All
594 characters are replaced by their hex-escaped (%22) equivalents,
595 except for characters explicitly unreserved by RFC3986 -- that is,
596 ASCII alphanumeric characters, hyphen, dot, underscore, and tilde.
597
598 The returned string must be freed by the caller.
599
600 @param str an unencoded string
601 @return a newly allocated URI-encoded string or NULL on failure
602 */
603 char *evhttp_encode_uri(const char *str);
604
605 /**
606 As evhttp_encode_uri, but if 'size' is nonnegative, treat the string
607 as being 'size' bytes long. This allows you to encode strings that
608 may contain 0-valued bytes.
609
610 The returned string must be freed by the caller.
611
612 @param str an unencoded string
613 @param size the length of the string to encode, or -1 if the string
614 is NUL-terminated
615 @param space_to_plus if true, space characters in 'str' are encoded
616 as +, not %20.
617 @return a newly allocate URI-encoded string, or NULL on failure.
618 */
619 char *evhttp_uriencode(const char *str, ev_ssize_t size, int space_to_plus);
620
621 /**
622 Helper function to sort of decode a URI-encoded string. Unlike
623 evhttp_get_decoded_uri, it decodes all plus characters that appear
624 _after_ the first question mark character, but no plusses that occur
625 before. This is not a good way to decode URIs in whole or in part.
626
627 The returned string must be freed by the caller
628
629 @deprecated This function is deprecated; you probably want to use
630 evhttp_get_decoded_uri instead.
631
632 @param uri an encoded URI
633 @return a newly allocated unencoded URI or NULL on failure
634 */
635 char *evhttp_decode_uri(const char *uri);
636
637 /**
638 Helper function to decode a URI-escaped string or HTTP parameter.
639
640 If 'decode_plus' is 1, then we decode the string as an HTTP parameter
641 value, and convert all plus ('+') characters to spaces. If
642 'decode_plus' is 0, we leave all plus characters unchanged.
643
644 The returned string must be freed by the caller.
645
646 @param uri a URI-encode encoded URI
647 @param decode_plus determines whether we convert '+' to sapce.
648 @param size_out if size_out is not NULL, *size_out is set to the size of the
649 returned string
650 @return a newly allocated unencoded URI or NULL on failure
651 */
652 char *evhttp_uridecode(const char *uri, int decode_plus,
653 size_t *size_out);
654
655 /**
656 Helper function to parse out arguments in a query.
657
658 Parsing a URI like
659
660 http://foo.com/?q=test&s=some+thing
661
662 will result in two entries in the key value queue.
663
664 The first entry is: key="q", value="test"
665 The second entry is: key="s", value="some thing"
666
667 @deprecated This function is deprecated as of Libevent 2.0.9. Use
668 evhttp_uri_parse and evhttp_parse_query_str instead.
669
670 @param uri the request URI
671 @param headers the head of the evkeyval queue
672 @return 0 on success, -1 on failure
673 */
674 int evhttp_parse_query(const char *uri, struct evkeyvalq *headers);
675
676 /**
677 Helper function to parse out arguments from the query portion of an
678 HTTP URI.
679
680 Parsing a query string like
681
682 q=test&s=some+thing
683
684 will result in two entries in the key value queue.
685
686 The first entry is: key="q", value="test"
687 The second entry is: key="s", value="some thing"
688
689 @param query_parse the query portion of the URI
690 @param headers the head of the evkeyval queue
691 @return 0 on success, -1 on failure
692 */
693 int evhttp_parse_query_str(const char *uri, struct evkeyvalq *headers);
694
695 /**
696 * Escape HTML character entities in a string.
697 *
698 * Replaces <, >, ", ' and & with &lt;, &gt;, &quot;,
699 * &#039; and &amp; correspondingly.
700 *
701 * The returned string needs to be freed by the caller.
702 *
703 * @param html an unescaped HTML string
704 * @return an escaped HTML string or NULL on error
705 */
706 char *evhttp_htmlescape(const char *html);
707
708 /**
709 * Return a new empty evhttp_uri with no fields set.
710 */
711 struct evhttp_uri *evhttp_uri_new(void);
712
713 /**
714 * Changes the flags set on a given URI. See EVHTTP_URI_* for
715 * a list of flags.
716 **/
717 void evhttp_uri_set_flags(struct evhttp_uri *uri, unsigned flags);
718
719 /** Return the scheme of an evhttp_uri, or NULL if there is no scheme has
720 * been set and the evhttp_uri contains a Relative-Ref. */
721 const char *evhttp_uri_get_scheme(const struct evhttp_uri *uri);
722 /**
723 * Return the userinfo part of an evhttp_uri, or NULL if it has no userinfo
724 * set.
725 */
726 const char *evhttp_uri_get_userinfo(const struct evhttp_uri *uri);
727 /**
728 * Return the host part of an evhttp_uri, or NULL if it has no host set.
729 * The host may either be a regular hostname (conforming to the RFC 3986
730 * "regname" production), or an IPv4 address, or the empty string, or a
731 * bracketed IPv6 address, or a bracketed 'IP-Future' address.
732 *
733 * Note that having a NULL host means that the URI has no authority
734 * section, but having an empty-string host means that the URI has an
735 * authority section with no host part. For example,
736 * "mailto:user@example.com" has a host of NULL, but "file:///etc/motd"
737 * has a host of "".
738 */
739 const char *evhttp_uri_get_host(const struct evhttp_uri *uri);
740 /** Return the port part of an evhttp_uri, or -1 if there is no port set. */
741 int evhttp_uri_get_port(const struct evhttp_uri *uri);
742 /** Return the path part of an evhttp_uri, or NULL if it has no path set */
743 const char *evhttp_uri_get_path(const struct evhttp_uri *uri);
744 /** Return the query part of an evhttp_uri (excluding the leading "?"), or
745 * NULL if it has no query set */
746 const char *evhttp_uri_get_query(const struct evhttp_uri *uri);
747 /** Return the fragment part of an evhttp_uri (excluding the leading "#"),
748 * or NULL if it has no fragment set */
749 const char *evhttp_uri_get_fragment(const struct evhttp_uri *uri);
750
751 /** Set the scheme of an evhttp_uri, or clear the scheme if scheme==NULL.
752 * Returns 0 on success, -1 if scheme is not well-formed. */
753 int evhttp_uri_set_scheme(struct evhttp_uri *uri, const char *scheme);
754 /** Set the userinfo of an evhttp_uri, or clear the userinfo if userinfo==NULL.
755 * Returns 0 on success, -1 if userinfo is not well-formed. */
756 int evhttp_uri_set_userinfo(struct evhttp_uri *uri, const char *userinfo);
757 /** Set the host of an evhttp_uri, or clear the host if host==NULL.
758 * Returns 0 on success, -1 if host is not well-formed. */
759 int evhttp_uri_set_host(struct evhttp_uri *uri, const char *host);
760 /** Set the port of an evhttp_uri, or clear the port if port==-1.
761 * Returns 0 on success, -1 if port is not well-formed. */
762 int evhttp_uri_set_port(struct evhttp_uri *uri, int port);
763 /** Set the path of an evhttp_uri, or clear the path if path==NULL.
764 * Returns 0 on success, -1 if path is not well-formed. */
765 int evhttp_uri_set_path(struct evhttp_uri *uri, const char *path);
766 /** Set the query of an evhttp_uri, or clear the query if query==NULL.
767 * The query should not include a leading "?".
768 * Returns 0 on success, -1 if query is not well-formed. */
769 int evhttp_uri_set_query(struct evhttp_uri *uri, const char *query);
770 /** Set the fragment of an evhttp_uri, or clear the fragment if fragment==NULL.
771 * The fragment should not include a leading "#".
772 * Returns 0 on success, -1 if fragment is not well-formed. */
773 int evhttp_uri_set_fragment(struct evhttp_uri *uri, const char *fragment);
774
775 /**
776 * Helper function to parse a URI-Reference as specified by RFC3986.
777 *
778 * This function matches the URI-Reference production from RFC3986,
779 * which includes both URIs like
780 *
781 * scheme://[[userinfo]@]foo.com[:port]]/[path][?query][#fragment]
782 *
783 * and relative-refs like
784 *
785 * [path][?query][#fragment]
786 *
787 * Any optional elements portions not present in the original URI are
788 * left set to NULL in the resulting evhttp_uri. If no port is
789 * specified, the port is set to -1.
790 *
791 * Note that no decoding is performed on percent-escaped characters in
792 * the string; if you want to parse them, use evhttp_uridecode or
793 * evhttp_parse_query_str as appropriate.
794 *
795 * Note also that most URI schemes will have additional constraints that
796 * this function does not know about, and cannot check. For example,
797 * mailto://www.example.com/cgi-bin/fortune.pl is not a reasonable
798 * mailto url, http://www.example.com:99999/ is not a reasonable HTTP
799 * URL, and ftp:username@example.com is not a reasonable FTP URL.
800 * Nevertheless, all of these URLs conform to RFC3986, and this function
801 * accepts all of them as valid.
802 *
803 * @param source_uri the request URI
804 * @param flags Zero or more EVHTTP_URI_* flags to affect the behavior
805 * of the parser.
806 * @return uri container to hold parsed data, or NULL if there is error
807 * @see evhttp_uri_free()
808 */
809 struct evhttp_uri *evhttp_uri_parse_with_flags(const char *source_uri,
810 unsigned flags);
811
812 /** Tolerate URIs that do not conform to RFC3986.
813 *
814 * Unfortunately, some HTTP clients generate URIs that, according to RFC3986,
815 * are not conformant URIs. If you need to support these URIs, you can
816 * do so by passing this flag to evhttp_uri_parse_with_flags.
817 *
818 * Currently, these changes are:
819 * <ul>
820 * <li> Nonconformant URIs are allowed to contain otherwise unreasonable
821 * characters in their path, query, and fragment components.
822 * </ul>
823 */
824 #define EVHTTP_URI_NONCONFORMANT 0x01
825
826 /** Alias for evhttp_uri_parse_with_flags(source_uri, 0) */
827 struct evhttp_uri *evhttp_uri_parse(const char *source_uri);
828
829 /**
830 * Free all memory allocated for a parsed uri. Only use this for URIs
831 * generated by evhttp_uri_parse.
832 *
833 * @param uri container with parsed data
834 * @see evhttp_uri_parse()
835 */
836 void evhttp_uri_free(struct evhttp_uri *uri);
837
838 /**
839 * Join together the uri parts from parsed data to form a URI-Reference.
840 *
841 * Note that no escaping of reserved characters is done on the members
842 * of the evhttp_uri, so the generated string might not be a valid URI
843 * unless the members of evhttp_uri are themselves valid.
844 *
845 * @param uri container with parsed data
846 * @param buf destination buffer
847 * @param limit destination buffer size
848 * @return an joined uri as string or NULL on error
849 * @see evhttp_uri_parse()
850 */
851 char *evhttp_uri_join(struct evhttp_uri *uri, char *buf, size_t limit);
852
853 #ifdef __cplusplus
854 }
855 #endif
856
857 #endif /* _EVENT2_HTTP_H_ */
evdns_base
Definition: evdns.c:286
evhttp_parse_query_str
int evhttp_parse_query_str(const char *uri, struct evkeyvalq *headers)
Helper function to parse out arguments from the query portion of an HTTP URI.
Definition: http.c:2853
evhttp_uri_set_scheme
int evhttp_uri_set_scheme(struct evhttp_uri *uri, const char *scheme)
Set the scheme of an evhttp_uri, or clear the scheme if scheme==NULL.
Definition: http.c:4442
evhttp_make_request
int evhttp_make_request(struct evhttp_connection *evcon, struct evhttp_request *req, enum evhttp_cmd_type type, const char *uri)
Make an HTTP request over the specified connection.
Definition: http.c:2222
evhttp_encode_uri
char * evhttp_encode_uri(const char *str)
Helper function to encode a string for inclusion in a URI.
Definition: http.c:2691
evhttp_request_get_input_headers
struct evkeyvalq * evhttp_request_get_input_headers(struct evhttp_request *req)
Returns the input headers.
Definition: http.c:3629
evhttp_uri_set_fragment
int evhttp_uri_set_fragment(struct evhttp_uri *uri, const char *fragment)
Set the fragment of an evhttp_uri, or clear the fragment if fragment==NULL.
Definition: http.c:4503
evhttp_set_timeout
void evhttp_set_timeout(struct evhttp *http, int timeout_in_secs)
Set the timeout for an HTTP request.
Definition: http.c:3355
evhttp_uriencode
char * evhttp_uriencode(const char *str, ev_ssize_t size, int space_to_plus)
As evhttp_encode_uri, but if 'size' is nonnegative, treat the string as being 'size' bytes long...
Definition: http.c:2657
evhttp_connection_set_retries
void evhttp_connection_set_retries(struct evhttp_connection *evcon, int retry_max)
Sets the retry limit for this connection - -1 repeats indefinitely.
Definition: http.c:2145
evhttp_remove_virtual_host
int evhttp_remove_virtual_host(struct evhttp *http, struct evhttp *vhost)
Removes a virtual host from the http server.
Definition: http.c:3304
evhttp_uri_get_path
const char * evhttp_uri_get_path(const struct evhttp_uri *uri)
Return the path part of an evhttp_uri, or NULL if it has no path set.
Definition: http.c:4413
evhttp_uri_get_scheme
const char * evhttp_uri_get_scheme(const struct evhttp_uri *uri)
Return the scheme of an evhttp_uri, or NULL if there is no scheme has been set and the evhttp_uri con...
Definition: http.c:4393
evhttp_uri_set_userinfo
int evhttp_uri_set_userinfo(struct evhttp_uri *uri, const char *userinfo)
Set the userinfo of an evhttp_uri, or clear the userinfo if userinfo==NULL.
Definition: http.c:4451
evhttp_request_get_input_buffer
struct evbuffer * evhttp_request_get_input_buffer(struct evhttp_request *req)
Returns the input buffer.
Definition: http.c:3641
evhttp_send_reply_chunk
void evhttp_send_reply_chunk(struct evhttp_request *req, struct evbuffer *databuf)
Send another data chunk as part of an ongoing chunked reply.
Definition: http.c:2447
evhttp_new
struct evhttp * evhttp_new(struct event_base *base)
Create a new HTTP server.
Definition: http.c:3206
evhttp_connection_get_peer
void evhttp_connection_get_peer(struct evhttp_connection *evcon, char **address, ev_uint16_t *port)
Get the remote address and port associated with this connection.
Definition: http.c:2160
evhttp_del_cb
int evhttp_del_cb(struct evhttp *, const char *)
Removes the callback for a specified URI.
Definition: http.c:3415
evhttp_parse_query
int evhttp_parse_query(const char *uri, struct evkeyvalq *headers)
Helper function to parse out arguments in a query.
Definition: http.c:2848
evhttp_request_get_evhttp_uri
const struct evhttp_uri * evhttp_request_get_evhttp_uri(const struct evhttp_request *req)
Returns the request URI (parsed)
Definition: http.c:3572
evhttp_request_set_chunked_cb
void evhttp_request_set_chunked_cb(struct evhttp_request *, void(*cb)(struct evhttp_request *, void *))
Enable delivery of chunks to requestor.
Definition: http.c:3554
evhttp_request_get_output_headers
struct evkeyvalq * evhttp_request_get_output_headers(struct evhttp_request *req)
Returns the output headers.
Definition: http.c:3635
evhttp_send_reply_end
void evhttp_send_reply_end(struct evhttp_request *req)
Complete a chunked reply.
Definition: http.c:2473
evhttp_request_new
struct evhttp_request * evhttp_request_new(void(*cb)(struct evhttp_request *, void *), void *arg)
Creates a new request object that needs to be filled in with the request parameters.
Definition: http.c:3446
evhttp_remove_header
int evhttp_remove_header(struct evkeyvalq *headers, const char *key)
Removes a header from a list of existing headers.
Definition: http.c:1624
evhttp_bind_socket
int evhttp_bind_socket(struct evhttp *http, const char *address, ev_uint16_t port)
Binds an HTTP server on the specified address and port.
Definition: http.c:3071
evhttp_bound_socket_get_listener
struct evconnlistener * evhttp_bound_socket_get_listener(struct evhttp_bound_socket *bound)
Return the listener used to implement a bound socket.
Definition: http.c:3163
evhttp_send_error
void evhttp_send_error(struct evhttp_request *req, int error, const char *reason)
Send an HTML error message to the client.
Definition: http.c:2358
evhttp_bind_listener
struct evhttp_bound_socket * evhttp_bind_listener(struct evhttp *http, struct evconnlistener *listener)
The most low-level evhttp_bind/accept method: takes an evconnlistener, and returns an evhttp_bound_so...
Definition: http.c:3141
evhttp_uri_set_query
int evhttp_uri_set_query(struct evhttp_uri *uri, const char *query)
Set the query of an evhttp_uri, or clear the query if query==NULL.
Definition: http.c:4495
evhttp_request_kind
evhttp_request_kind
a request object can represent either a request or a reply
Definition: http.h:390
evhttp_free
void evhttp_free(struct evhttp *http)
Free the previously created HTTP server.
Definition: http.c:3239
evhttp_uri_new
struct evhttp_uri * evhttp_uri_new(void)
Return a new empty evhttp_uri with no fields set.
Definition: http.c:3905
evhttp_connection_set_local_port
void evhttp_connection_set_local_port(struct evhttp_connection *evcon, ev_uint16_t port)
sets the local port from which http connections are made
Definition: http.c:1187
evhttp_uri_parse
struct evhttp_uri * evhttp_uri_parse(const char *source_uri)
Alias for evhttp_uri_parse_with_flags(source_uri, 0)
Definition: http.c:4176
evhttp_connection_get_base
struct event_base * evhttp_connection_get_base(struct evhttp_connection *req)
Returns the underlying event_base for this connection.
Definition: http.c:3548
evutil_socket_t
#define evutil_socket_t
A type wide enough to hold the output of "socket()" or "accept()".
Definition: util.h:278
evhttp_accept_socket
int evhttp_accept_socket(struct evhttp *http, evutil_socket_t fd)
Makes an HTTP server accept connections on the specified socket.
Definition: http.c:3107
evhttp_set_max_body_size
void evhttp_set_max_body_size(struct evhttp *http, ev_ssize_t max_body_size)
XXX Document.
Definition: http.c:3370
evhttp_accept_socket_with_handle
struct evhttp_bound_socket * evhttp_accept_socket_with_handle(struct evhttp *http, evutil_socket_t fd)
Like evhttp_accept_socket(), but returns a handle for referencing the socket.
Definition: http.c:3118
evhttp_request_free
void evhttp_request_free(struct evhttp_request *req)
Frees the request object and removes associated events.
Definition: http.c:3496
evhttp_del_accept_socket
void evhttp_del_accept_socket(struct evhttp *http, struct evhttp_bound_socket *bound_socket)
Makes an HTTP server stop accepting connections on the specified socket.
Definition: http.c:3169
evhttp_bound_socket_get_fd
evutil_socket_t evhttp_bound_socket_get_fd(struct evhttp_bound_socket *bound_socket)
Get the raw file descriptor referenced by an evhttp_bound_socket.
Definition: http.c:3157
evbuffer
Definition: evbuffer-internal.h:78
evhttp_uri_set_path
int evhttp_uri_set_path(struct evhttp_uri *uri, const char *path)
Set the path of an evhttp_uri, or clear the path if path==NULL.
Definition: http.c:4486
evhttp_set_max_headers_size
void evhttp_set_max_headers_size(struct evhttp *http, ev_ssize_t max_headers_size)
XXX Document.
Definition: http.c:3361
evhttp_uri_parse_with_flags
struct evhttp_uri * evhttp_uri_parse_with_flags(const char *source_uri, unsigned flags)
Helper function to parse a URI-Reference as specified by RFC3986.
Definition: http.c:4182
evhttp_request_own
void evhttp_request_own(struct evhttp_request *req)
Takes ownership of the request object.
Definition: http.c:3530
evhttp_cancel_request
void evhttp_cancel_request(struct evhttp_request *req)
Cancels a pending HTTP request.
Definition: http.c:2274
evhttp_uri_get_fragment
const char * evhttp_uri_get_fragment(const struct evhttp_uri *uri)
Return the fragment part of an evhttp_uri (excluding the leading "#"), or NULL if it has no fragment ...
Definition: http.c:4423
evhttp_connection_set_timeout
void evhttp_connection_set_timeout(struct evhttp_connection *evcon, int timeout_in_secs)
Sets the timeout for events related to this connection.
Definition: http.c:2131
evhttp_clear_headers
void evhttp_clear_headers(struct evkeyvalq *headers)
Removes all headers from the header list.
Definition: http.c:1604
evhttp_request_get_command
enum evhttp_cmd_type evhttp_request_get_command(const struct evhttp_request *req)
Returns the request command.
Definition: http.c:3618
evhttp_send_reply
void evhttp_send_reply(struct evhttp_request *req, int code, const char *reason, struct evbuffer *databuf)
Send an HTML reply to the client.
Definition: http.c:2415
evhttp_uri_free
void evhttp_uri_free(struct evhttp_uri *uri)
Free all memory allocated for a parsed uri.
Definition: http.c:4310
evhttp_uri_get_host
const char * evhttp_uri_get_host(const struct evhttp_uri *uri)
Return the host part of an evhttp_uri, or NULL if it has no host set.
Definition: http.c:4403
evhttp_connection
Definition: http-internal.h:62
util.h
Common convenience functions for cross-platform portability and related socket manipulations.
evhttp_uri_set_port
int evhttp_uri_set_port(struct evhttp_uri *uri, int port)
Set the port of an evhttp_uri, or clear the port if port==-1.
Definition: http.c:4475
evhttp_uridecode
char * evhttp_uridecode(const char *uri, int decode_plus, size_t *size_out)
Helper function to decode a URI-escaped string or HTTP parameter.
Definition: http.c:2753
evhttp_decode_uri
char * evhttp_decode_uri(const char *uri)
Helper function to sort of decode a URI-encoded string.
Definition: http.c:2736
evhttp_send_reply_start
void evhttp_send_reply_start(struct evhttp_request *req, int code, const char *reason)
Initiate a reply that uses Transfer-Encoding chunked.
Definition: http.c:2424
evhttp_request_get_uri
const char * evhttp_request_get_uri(const struct evhttp_request *req)
Returns the request URI.
Definition: http.c:3565
evhttp_set_cb
int evhttp_set_cb(struct evhttp *http, const char *path, void(*cb)(struct evhttp_request *, void *), void *cb_arg)
Set a callback for a specified URI.
Definition: http.c:3385
evhttp_set_gencb
void evhttp_set_gencb(struct evhttp *http, void(*cb)(struct evhttp_request *, void *), void *arg)
Set a callback for all requests that are not caught by specific callbacks.
Definition: http.c:3434
evhttp_uri_set_host
int evhttp_uri_set_host(struct evhttp_uri *uri, const char *host)
Set the host of an evhttp_uri, or clear the host if host==NULL.
Definition: http.c:4459
evhttp_uri_get_port
int evhttp_uri_get_port(const struct evhttp_uri *uri)
Return the port part of an evhttp_uri, or -1 if there is no port set.
Definition: http.c:4408
evhttp_uri_join
char * evhttp_uri_join(struct evhttp_uri *uri, char *buf, size_t limit)
Join together the uri parts from parsed data to form a URI-Reference.
Definition: http.c:4329
evhttp_set_allowed_methods
void evhttp_set_allowed_methods(struct evhttp *http, ev_uint16_t methods)
Sets the what HTTP methods are supported in requests accepted by this server, and passed to user call...
Definition: http.c:3379
evhttp_uri_get_userinfo
const char * evhttp_uri_get_userinfo(const struct evhttp_uri *uri)
Return the userinfo part of an evhttp_uri, or NULL if it has no userinfo set.
Definition: http.c:4398
evhttp_request_is_owned
int evhttp_request_is_owned(struct evhttp_request *req)
Returns 1 if the request is owned by the user.
Definition: http.c:3536
evhttp_connection_set_closecb
void evhttp_connection_set_closecb(struct evhttp_connection *evcon, void(*)(struct evhttp_connection *, void *), void *)
Set a callback for connection close.
Definition: http.c:2152
evhttp_request_get_connection
struct evhttp_connection * evhttp_request_get_connection(struct evhttp_request *req)
Returns the connection object associated with the request or NULL.
Definition: http.c:3542
evhttp_bound_socket
Definition: http-internal.h:123
evhttp_uri
Definition: http.c:3893
evhttp_htmlescape
char * evhttp_htmlescape(const char *html)
Escape HTML character entities in a string.
Definition: http.c:256
evhttp_request_get_output_buffer
struct evbuffer * evhttp_request_get_output_buffer(struct evhttp_request *req)
Returns the output buffer.
Definition: http.c:3647
evhttp_connection_free
void evhttp_connection_free(struct evhttp_connection *evcon)
Frees an http connection.
Definition: http.c:1125
evhttp_uri_set_flags
void evhttp_uri_set_flags(struct evhttp_uri *uri, unsigned flags)
Changes the flags set on a given URI.
Definition: http.c:3914
evhttp_request_get_host
const char * evhttp_request_get_host(struct evhttp_request *req)
Returns the host associated with the request.
Definition: http.c:3580
evhttp_connection_base_new
struct evhttp_connection * evhttp_connection_base_new(struct event_base *base, struct evdns_base *dnsbase, const char *address, unsigned short port)
A connection object that can be used to for making HTTP requests.
Definition: http.c:2064
evhttp_connection_set_local_address
void evhttp_connection_set_local_address(struct evhttp_connection *evcon, const char *address)
sets the ip address from which http connections are made
Definition: http.c:1176
evhttp_add_virtual_host
int evhttp_add_virtual_host(struct evhttp *http, const char *pattern, struct evhttp *vhost)
Adds a virtual host to the http server.
Definition: http.c:3286
evhttp_bind_socket_with_handle
struct evhttp_bound_socket * evhttp_bind_socket_with_handle(struct evhttp *http, const char *address, ev_uint16_t port)
Like evhttp_bind_socket(), but returns a handle for referencing the socket.
Definition: http.c:3081
evhttp
Definition: http-internal.h:136
evhttp_remove_server_alias
int evhttp_remove_server_alias(struct evhttp *http, const char *alias)
Remove a server alias from an http object.
Definition: http.c:3338
evhttp_uri_get_query
const char * evhttp_uri_get_query(const struct evhttp_uri *uri)
Return the query part of an evhttp_uri (excluding the leading "?"), or NULL if it has no query set...
Definition: http.c:4418
evhttp_add_server_alias
int evhttp_add_server_alias(struct evhttp *http, const char *alias)
Add a server alias to an http object.
Definition: http.c:3318
evhttp_add_header
int evhttp_add_header(struct evkeyvalq *headers, const char *key, const char *value)
Adds a header to a list of existing headers.
Definition: http.c:1661
event_base
Definition: event-internal.h:167
evhttp_find_header
const char * evhttp_find_header(const struct evkeyvalq *headers, const char *key)
Finds the value belonging to a header.
Definition: http.c:1591
evconnlistener
Definition: listener.c:74
evhttp_cmd_type
evhttp_cmd_type
The different request types supported by evhttp.
Definition: http.h:377
evhttp_request
the request structure that a server receives.
Definition: http_struct.h:57