remove the static build of libevent
This commit is contained in:
parent
6cf6dc9142
commit
d239665a02
367
libevent/evdns.h
367
libevent/evdns.h
|
@ -1,367 +0,0 @@
|
||||||
/*
|
|
||||||
* Copyright (c) 2006 Niels Provos <provos@citi.umich.edu>
|
|
||||||
* All rights reserved.
|
|
||||||
*
|
|
||||||
* Redistribution and use in source and binary forms, with or without
|
|
||||||
* modification, are permitted provided that the following conditions
|
|
||||||
* are met:
|
|
||||||
* 1. Redistributions of source code must retain the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer.
|
|
||||||
* 2. Redistributions in binary form must reproduce the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer in the
|
|
||||||
* documentation and/or other materials provided with the distribution.
|
|
||||||
* 3. The name of the author may not be used to endorse or promote products
|
|
||||||
* derived from this software without specific prior written permission.
|
|
||||||
*
|
|
||||||
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
||||||
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
||||||
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
||||||
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
||||||
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
||||||
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
||||||
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
||||||
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
||||||
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
*/
|
|
||||||
|
|
||||||
/*
|
|
||||||
* The original DNS code is due to Adam Langley with heavy
|
|
||||||
* modifications by Nick Mathewson. Adam put his DNS software in the
|
|
||||||
* public domain. You can find his original copyright below. Please,
|
|
||||||
* aware that the code as part of libevent is governed by the 3-clause
|
|
||||||
* BSD license above.
|
|
||||||
*
|
|
||||||
* This software is Public Domain. To view a copy of the public domain dedication,
|
|
||||||
* visit http://creativecommons.org/licenses/publicdomain/ or send a letter to
|
|
||||||
* Creative Commons, 559 Nathan Abbott Way, Stanford, California 94305, USA.
|
|
||||||
*
|
|
||||||
* I ask and expect, but do not require, that all derivative works contain an
|
|
||||||
* attribution similar to:
|
|
||||||
* Parts developed by Adam Langley <agl@imperialviolet.org>
|
|
||||||
*
|
|
||||||
* You may wish to replace the word "Parts" with something else depending on
|
|
||||||
* the amount of original code.
|
|
||||||
*
|
|
||||||
* (Derivative works does not include programs which link against, run or include
|
|
||||||
* the source verbatim in their source distributions)
|
|
||||||
*/
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Welcome, gentle reader
|
|
||||||
*
|
|
||||||
* Async DNS lookups are really a whole lot harder than they should be,
|
|
||||||
* mostly stemming from the fact that the libc resolver has never been
|
|
||||||
* very good at them. Before you use this library you should see if libc
|
|
||||||
* can do the job for you with the modern async call getaddrinfo_a
|
|
||||||
* (see http://www.imperialviolet.org/page25.html#e498). Otherwise,
|
|
||||||
* please continue.
|
|
||||||
*
|
|
||||||
* This code is based on libevent and you must call event_init before
|
|
||||||
* any of the APIs in this file. You must also seed the OpenSSL random
|
|
||||||
* source if you are using OpenSSL for ids (see below).
|
|
||||||
*
|
|
||||||
* This library is designed to be included and shipped with your source
|
|
||||||
* code. You statically link with it. You should also test for the
|
|
||||||
* existence of strtok_r and define HAVE_STRTOK_R if you have it.
|
|
||||||
*
|
|
||||||
* The DNS protocol requires a good source of id numbers and these
|
|
||||||
* numbers should be unpredictable for spoofing reasons. There are
|
|
||||||
* three methods for generating them here and you must define exactly
|
|
||||||
* one of them. In increasing order of preference:
|
|
||||||
*
|
|
||||||
* DNS_USE_GETTIMEOFDAY_FOR_ID:
|
|
||||||
* Using the bottom 16 bits of the usec result from gettimeofday. This
|
|
||||||
* is a pretty poor solution but should work anywhere.
|
|
||||||
* DNS_USE_CPU_CLOCK_FOR_ID:
|
|
||||||
* Using the bottom 16 bits of the nsec result from the CPU's time
|
|
||||||
* counter. This is better, but may not work everywhere. Requires
|
|
||||||
* POSIX realtime support and you'll need to link against -lrt on
|
|
||||||
* glibc systems at least.
|
|
||||||
* DNS_USE_OPENSSL_FOR_ID:
|
|
||||||
* Uses the OpenSSL RAND_bytes call to generate the data. You must
|
|
||||||
* have seeded the pool before making any calls to this library.
|
|
||||||
*
|
|
||||||
* The library keeps track of the state of nameservers and will avoid
|
|
||||||
* them when they go down. Otherwise it will round robin between them.
|
|
||||||
*
|
|
||||||
* Quick start guide:
|
|
||||||
* #include "evdns.h"
|
|
||||||
* void callback(int result, char type, int count, int ttl,
|
|
||||||
* void *addresses, void *arg);
|
|
||||||
* evdns_resolv_conf_parse(DNS_OPTIONS_ALL, "/etc/resolv.conf");
|
|
||||||
* evdns_resolve("www.hostname.com", 0, callback, NULL);
|
|
||||||
*
|
|
||||||
* When the lookup is complete the callback function is called. The
|
|
||||||
* first argument will be one of the DNS_ERR_* defines in evdns.h.
|
|
||||||
* Hopefully it will be DNS_ERR_NONE, in which case type will be
|
|
||||||
* DNS_IPv4_A, count will be the number of IP addresses, ttl is the time
|
|
||||||
* which the data can be cached for (in seconds), addresses will point
|
|
||||||
* to an array of uint32_t's and arg will be whatever you passed to
|
|
||||||
* evdns_resolve.
|
|
||||||
*
|
|
||||||
* Searching:
|
|
||||||
*
|
|
||||||
* In order for this library to be a good replacement for glibc's resolver it
|
|
||||||
* supports searching. This involves setting a list of default domains, in
|
|
||||||
* which names will be queried for. The number of dots in the query name
|
|
||||||
* determines the order in which this list is used.
|
|
||||||
*
|
|
||||||
* Searching appears to be a single lookup from the point of view of the API,
|
|
||||||
* although many DNS queries may be generated from a single call to
|
|
||||||
* evdns_resolve. Searching can also drastically slow down the resolution
|
|
||||||
* of names.
|
|
||||||
*
|
|
||||||
* To disable searching:
|
|
||||||
* 1. Never set it up. If you never call evdns_resolv_conf_parse or
|
|
||||||
* evdns_search_add then no searching will occur.
|
|
||||||
*
|
|
||||||
* 2. If you do call evdns_resolv_conf_parse then don't pass
|
|
||||||
* DNS_OPTION_SEARCH (or DNS_OPTIONS_ALL, which implies it).
|
|
||||||
*
|
|
||||||
* 3. When calling evdns_resolve, pass the DNS_QUERY_NO_SEARCH flag.
|
|
||||||
*
|
|
||||||
* The order of searches depends on the number of dots in the name. If the
|
|
||||||
* number is greater than the ndots setting then the names is first tried
|
|
||||||
* globally. Otherwise each search domain is appended in turn.
|
|
||||||
*
|
|
||||||
* The ndots setting can either be set from a resolv.conf, or by calling
|
|
||||||
* evdns_search_ndots_set.
|
|
||||||
*
|
|
||||||
* For example, with ndots set to 1 (the default) and a search domain list of
|
|
||||||
* ["myhome.net"]:
|
|
||||||
* Query: www
|
|
||||||
* Order: www.myhome.net, www.
|
|
||||||
*
|
|
||||||
* Query: www.abc
|
|
||||||
* Order: www.abc., www.abc.myhome.net
|
|
||||||
*
|
|
||||||
* API reference:
|
|
||||||
*
|
|
||||||
* int evdns_nameserver_add(unsigned long int address)
|
|
||||||
* Add a nameserver. The address should be an IP address in
|
|
||||||
* network byte order. The type of address is chosen so that
|
|
||||||
* it matches in_addr.s_addr.
|
|
||||||
* Returns non-zero on error.
|
|
||||||
*
|
|
||||||
* int evdns_nameserver_ip_add(const char *ip_as_string)
|
|
||||||
* This wraps the above function by parsing a string as an IP
|
|
||||||
* address and adds it as a nameserver.
|
|
||||||
* Returns non-zero on error
|
|
||||||
*
|
|
||||||
* int evdns_resolve(const char *name, int flags,
|
|
||||||
* evdns_callback_type callback,
|
|
||||||
* void *ptr)
|
|
||||||
* Resolve a name. The name parameter should be a DNS name.
|
|
||||||
* The flags parameter should be 0, or DNS_QUERY_NO_SEARCH
|
|
||||||
* which disables searching for this query. (see defn of
|
|
||||||
* searching above).
|
|
||||||
*
|
|
||||||
* The callback argument is a function which is called when
|
|
||||||
* this query completes and ptr is an argument which is passed
|
|
||||||
* to that callback function.
|
|
||||||
*
|
|
||||||
* Returns non-zero on error
|
|
||||||
*
|
|
||||||
* void evdns_search_clear()
|
|
||||||
* Clears the list of search domains
|
|
||||||
*
|
|
||||||
* void evdns_search_add(const char *domain)
|
|
||||||
* Add a domain to the list of search domains
|
|
||||||
*
|
|
||||||
* void evdns_search_ndots_set(int ndots)
|
|
||||||
* Set the number of dots which, when found in a name, causes
|
|
||||||
* the first query to be without any search domain.
|
|
||||||
*
|
|
||||||
* int evdns_count_nameservers(void)
|
|
||||||
* Return the number of configured nameservers (not necessarily the
|
|
||||||
* number of running nameservers). This is useful for double-checking
|
|
||||||
* whether our calls to the various nameserver configuration functions
|
|
||||||
* have been successful.
|
|
||||||
*
|
|
||||||
* int evdns_clear_nameservers_and_suspend(void)
|
|
||||||
* Remove all currently configured nameservers, and suspend all pending
|
|
||||||
* resolves. Resolves will not necessarily be re-attempted until
|
|
||||||
* evdns_resume() is called.
|
|
||||||
*
|
|
||||||
* int evdns_resume(void)
|
|
||||||
* Re-attempt resolves left in limbo after an earlier call to
|
|
||||||
* evdns_clear_nameservers_and_suspend().
|
|
||||||
*
|
|
||||||
* int evdns_config_windows_nameservers(void)
|
|
||||||
* Attempt to configure a set of nameservers based on platform settings on
|
|
||||||
* a win32 host. Preferentially tries to use GetNetworkParams; if that fails,
|
|
||||||
* looks in the registry. Returns 0 on success, nonzero on failure.
|
|
||||||
*
|
|
||||||
* int evdns_resolv_conf_parse(int flags, const char *filename)
|
|
||||||
* Parse a resolv.conf like file from the given filename.
|
|
||||||
*
|
|
||||||
* See the man page for resolv.conf for the format of this file.
|
|
||||||
* The flags argument determines what information is parsed from
|
|
||||||
* this file:
|
|
||||||
* DNS_OPTION_SEARCH - domain, search and ndots options
|
|
||||||
* DNS_OPTION_NAMESERVERS - nameserver lines
|
|
||||||
* DNS_OPTION_MISC - timeout and attempts options
|
|
||||||
* DNS_OPTIONS_ALL - all of the above
|
|
||||||
* The following directives are not parsed from the file:
|
|
||||||
* sortlist, rotate, no-check-names, inet6, debug
|
|
||||||
*
|
|
||||||
* Returns non-zero on error:
|
|
||||||
* 0 no errors
|
|
||||||
* 1 failed to open file
|
|
||||||
* 2 failed to stat file
|
|
||||||
* 3 file too large
|
|
||||||
* 4 out of memory
|
|
||||||
* 5 short read from file
|
|
||||||
* 6 no nameservers in file
|
|
||||||
*
|
|
||||||
* Internals:
|
|
||||||
*
|
|
||||||
* Requests are kept in two queues. The first is the inflight queue. In
|
|
||||||
* this queue requests have an allocated transaction id and nameserver.
|
|
||||||
* They will soon be transmitted if they haven't already been.
|
|
||||||
*
|
|
||||||
* The second is the waiting queue. The size of the inflight ring is
|
|
||||||
* limited and all other requests wait in waiting queue for space. This
|
|
||||||
* bounds the number of concurrent requests so that we don't flood the
|
|
||||||
* nameserver. Several algorithms require a full walk of the inflight
|
|
||||||
* queue and so bounding its size keeps thing going nicely under huge
|
|
||||||
* (many thousands of requests) loads.
|
|
||||||
*
|
|
||||||
* If a nameserver loses too many requests it is considered down and we
|
|
||||||
* try not to use it. After a while we send a probe to that nameserver
|
|
||||||
* (a lookup for google.com) and, if it replies, we consider it working
|
|
||||||
* again. If the nameserver fails a probe we wait longer to try again
|
|
||||||
* with the next probe.
|
|
||||||
*/
|
|
||||||
|
|
||||||
#ifndef EVENTDNS_H
|
|
||||||
#define EVENTDNS_H
|
|
||||||
|
|
||||||
#ifdef __cplusplus
|
|
||||||
extern "C" {
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/* Error codes 0-5 are as described in RFC 1035. */
|
|
||||||
#define DNS_ERR_NONE 0
|
|
||||||
/* The name server was unable to interpret the query */
|
|
||||||
#define DNS_ERR_FORMAT 1
|
|
||||||
/* The name server was unable to process this query due to a problem with the
|
|
||||||
* name server */
|
|
||||||
#define DNS_ERR_SERVERFAILED 2
|
|
||||||
/* The domain name does not exist */
|
|
||||||
#define DNS_ERR_NOTEXIST 3
|
|
||||||
/* The name server does not support the requested kind of query */
|
|
||||||
#define DNS_ERR_NOTIMPL 4
|
|
||||||
/* The name server refuses to reform the specified operation for policy
|
|
||||||
* reasons */
|
|
||||||
#define DNS_ERR_REFUSED 5
|
|
||||||
/* The reply was truncated or ill-formated */
|
|
||||||
#define DNS_ERR_TRUNCATED 65
|
|
||||||
/* An unknown error occurred */
|
|
||||||
#define DNS_ERR_UNKNOWN 66
|
|
||||||
/* Communication with the server timed out */
|
|
||||||
#define DNS_ERR_TIMEOUT 67
|
|
||||||
/* The request was canceled because the DNS subsystem was shut down. */
|
|
||||||
#define DNS_ERR_SHUTDOWN 68
|
|
||||||
|
|
||||||
#define DNS_IPv4_A 1
|
|
||||||
#define DNS_PTR 2
|
|
||||||
#define DNS_IPv6_AAAA 3
|
|
||||||
|
|
||||||
#define DNS_QUERY_NO_SEARCH 1
|
|
||||||
|
|
||||||
#define DNS_OPTION_SEARCH 1
|
|
||||||
#define DNS_OPTION_NAMESERVERS 2
|
|
||||||
#define DNS_OPTION_MISC 4
|
|
||||||
#define DNS_OPTIONS_ALL 7
|
|
||||||
|
|
||||||
/*
|
|
||||||
* The callback that contains the results from a lookup.
|
|
||||||
* - type is either DNS_IPv4_A or DNS_PTR or DNS_IPv6_AAAA
|
|
||||||
* - count contains the number of addresses of form type
|
|
||||||
* - ttl is the number of seconds the resolution may be cached for.
|
|
||||||
* - addresses needs to be cast according to type
|
|
||||||
*/
|
|
||||||
typedef void (*evdns_callback_type) (int result, char type, int count, int ttl, void *addresses, void *arg);
|
|
||||||
|
|
||||||
int evdns_init(void);
|
|
||||||
void evdns_shutdown(int fail_requests);
|
|
||||||
const char *evdns_err_to_string(int err);
|
|
||||||
int evdns_nameserver_add(unsigned long int address);
|
|
||||||
int evdns_count_nameservers(void);
|
|
||||||
int evdns_clear_nameservers_and_suspend(void);
|
|
||||||
int evdns_resume(void);
|
|
||||||
int evdns_nameserver_ip_add(const char *ip_as_string);
|
|
||||||
int evdns_resolve_ipv4(const char *name, int flags, evdns_callback_type callback, void *ptr);
|
|
||||||
int evdns_resolve_ipv6(const char *name, int flags, evdns_callback_type callback, void *ptr);
|
|
||||||
struct in_addr;
|
|
||||||
struct in6_addr;
|
|
||||||
int evdns_resolve_reverse(struct in_addr *in, int flags, evdns_callback_type callback, void *ptr);
|
|
||||||
int evdns_resolve_reverse_ipv6(struct in6_addr *in, int flags, evdns_callback_type callback, void *ptr);
|
|
||||||
int evdns_set_option(const char *option, const char *val, int flags);
|
|
||||||
int evdns_resolv_conf_parse(int flags, const char *);
|
|
||||||
#ifdef MS_WINDOWS
|
|
||||||
int evdns_config_windows_nameservers(void);
|
|
||||||
#endif
|
|
||||||
void evdns_search_clear(void);
|
|
||||||
void evdns_search_add(const char *domain);
|
|
||||||
void evdns_search_ndots_set(const int ndots);
|
|
||||||
|
|
||||||
typedef void (*evdns_debug_log_fn_type)(int is_warning, const char *msg);
|
|
||||||
void evdns_set_log_fn(evdns_debug_log_fn_type fn);
|
|
||||||
|
|
||||||
#define DNS_NO_SEARCH 1
|
|
||||||
|
|
||||||
#ifdef __cplusplus
|
|
||||||
}
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Structures and functions used to implement a DNS server.
|
|
||||||
*/
|
|
||||||
|
|
||||||
struct evdns_server_request {
|
|
||||||
int flags;
|
|
||||||
int nquestions;
|
|
||||||
struct evdns_server_question **questions;
|
|
||||||
};
|
|
||||||
struct evdns_server_question {
|
|
||||||
int type;
|
|
||||||
int class;
|
|
||||||
char name[1];
|
|
||||||
};
|
|
||||||
typedef void (*evdns_request_callback_fn_type)(struct evdns_server_request *, void *);
|
|
||||||
#define EVDNS_ANSWER_SECTION 0
|
|
||||||
#define EVDNS_AUTHORITY_SECTION 1
|
|
||||||
#define EVDNS_ADDITIONAL_SECTION 2
|
|
||||||
|
|
||||||
#define EVDNS_TYPE_A 1
|
|
||||||
#define EVDNS_TYPE_NS 2
|
|
||||||
#define EVDNS_TYPE_CNAME 5
|
|
||||||
#define EVDNS_TYPE_SOA 6
|
|
||||||
#define EVDNS_TYPE_PTR 12
|
|
||||||
#define EVDNS_TYPE_MX 15
|
|
||||||
#define EVDNS_TYPE_TXT 16
|
|
||||||
#define EVDNS_TYPE_AAAA 28
|
|
||||||
|
|
||||||
#define EVDNS_QTYPE_AXFR 252
|
|
||||||
#define EVDNS_QTYPE_ALL 255
|
|
||||||
|
|
||||||
#define EVDNS_CLASS_INET 1
|
|
||||||
|
|
||||||
struct evdns_server_port *evdns_add_server_port(int socket, int is_tcp, evdns_request_callback_fn_type callback, void *user_data);
|
|
||||||
void evdns_close_server_port(struct evdns_server_port *port);
|
|
||||||
|
|
||||||
int evdns_server_request_add_reply(struct evdns_server_request *req, int section, const char *name, int type, int class, int ttl, int datalen, int is_name, const char *data);
|
|
||||||
int evdns_server_request_add_a_reply(struct evdns_server_request *req, const char *name, int n, void *addrs, int ttl);
|
|
||||||
int evdns_server_request_add_aaaa_reply(struct evdns_server_request *req, const char *name, int n, void *addrs, int ttl);
|
|
||||||
int evdns_server_request_add_ptr_reply(struct evdns_server_request *req, struct in_addr *in, const char *inaddr_name, const char *hostname, int ttl);
|
|
||||||
int evdns_server_request_add_cname_reply(struct evdns_server_request *req, const char *name, const char *cname, int ttl);
|
|
||||||
|
|
||||||
int evdns_server_request_respond(struct evdns_server_request *req, int err);
|
|
||||||
int evdns_server_request_drop(struct evdns_server_request *req);
|
|
||||||
struct sockaddr;
|
|
||||||
int evdns_server_request_get_requesting_addr(struct evdns_server_request *_req, struct sockaddr *sa, int addr_len);
|
|
||||||
|
|
||||||
#endif /* !EVENTDNS_H */
|
|
340
libevent/event.h
340
libevent/event.h
|
@ -1,340 +0,0 @@
|
||||||
/*
|
|
||||||
* Copyright (c) 2000-2004 Niels Provos <provos@citi.umich.edu>
|
|
||||||
* All rights reserved.
|
|
||||||
*
|
|
||||||
* Redistribution and use in source and binary forms, with or without
|
|
||||||
* modification, are permitted provided that the following conditions
|
|
||||||
* are met:
|
|
||||||
* 1. Redistributions of source code must retain the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer.
|
|
||||||
* 2. Redistributions in binary form must reproduce the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer in the
|
|
||||||
* documentation and/or other materials provided with the distribution.
|
|
||||||
* 3. The name of the author may not be used to endorse or promote products
|
|
||||||
* derived from this software without specific prior written permission.
|
|
||||||
*
|
|
||||||
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
||||||
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
||||||
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
||||||
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
||||||
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
||||||
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
||||||
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
||||||
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
||||||
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
*/
|
|
||||||
#ifndef _EVENT_H_
|
|
||||||
#define _EVENT_H_
|
|
||||||
|
|
||||||
#ifdef __cplusplus
|
|
||||||
extern "C" {
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#include <sys/time.h>
|
|
||||||
#include <stdint.h>
|
|
||||||
#include <stdarg.h>
|
|
||||||
|
|
||||||
#ifdef WIN32
|
|
||||||
#define WIN32_LEAN_AND_MEAN
|
|
||||||
#include <windows.h>
|
|
||||||
#undef WIN32_LEAN_AND_MEAN
|
|
||||||
typedef unsigned char u_char;
|
|
||||||
typedef unsigned short u_short;
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#define EVLIST_TIMEOUT 0x01
|
|
||||||
#define EVLIST_INSERTED 0x02
|
|
||||||
#define EVLIST_SIGNAL 0x04
|
|
||||||
#define EVLIST_ACTIVE 0x08
|
|
||||||
#define EVLIST_INTERNAL 0x10
|
|
||||||
#define EVLIST_INIT 0x80
|
|
||||||
|
|
||||||
/* EVLIST_X_ Private space: 0x1000-0xf000 */
|
|
||||||
#define EVLIST_ALL (0xf000 | 0x9f)
|
|
||||||
|
|
||||||
#define EV_TIMEOUT 0x01
|
|
||||||
#define EV_READ 0x02
|
|
||||||
#define EV_WRITE 0x04
|
|
||||||
#define EV_SIGNAL 0x08
|
|
||||||
#define EV_PERSIST 0x10 /* Persistant event */
|
|
||||||
|
|
||||||
/* Fix so that ppl dont have to run with <sys/queue.h> */
|
|
||||||
#ifndef TAILQ_ENTRY
|
|
||||||
#define _EVENT_DEFINED_TQENTRY
|
|
||||||
#define TAILQ_ENTRY(type) \
|
|
||||||
struct { \
|
|
||||||
struct type *tqe_next; /* next element */ \
|
|
||||||
struct type **tqe_prev; /* address of previous next element */ \
|
|
||||||
}
|
|
||||||
#endif /* !TAILQ_ENTRY */
|
|
||||||
#ifndef RB_ENTRY
|
|
||||||
#define _EVENT_DEFINED_RBENTRY
|
|
||||||
#define RB_ENTRY(type) \
|
|
||||||
struct { \
|
|
||||||
struct type *rbe_left; /* left element */ \
|
|
||||||
struct type *rbe_right; /* right element */ \
|
|
||||||
struct type *rbe_parent; /* parent element */ \
|
|
||||||
int rbe_color; /* node color */ \
|
|
||||||
}
|
|
||||||
#endif /* !RB_ENTRY */
|
|
||||||
|
|
||||||
struct event_base;
|
|
||||||
struct event {
|
|
||||||
TAILQ_ENTRY (event) ev_next;
|
|
||||||
TAILQ_ENTRY (event) ev_active_next;
|
|
||||||
TAILQ_ENTRY (event) ev_signal_next;
|
|
||||||
RB_ENTRY (event) ev_timeout_node;
|
|
||||||
|
|
||||||
struct event_base *ev_base;
|
|
||||||
int ev_fd;
|
|
||||||
short ev_events;
|
|
||||||
short ev_ncalls;
|
|
||||||
short *ev_pncalls; /* Allows deletes in callback */
|
|
||||||
|
|
||||||
struct timeval ev_timeout;
|
|
||||||
|
|
||||||
int ev_pri; /* smaller numbers are higher priority */
|
|
||||||
|
|
||||||
void (*ev_callback)(int, short, void *arg);
|
|
||||||
void *ev_arg;
|
|
||||||
|
|
||||||
int ev_res; /* result passed to event callback */
|
|
||||||
int ev_flags;
|
|
||||||
};
|
|
||||||
|
|
||||||
#define EVENT_SIGNAL(ev) (int)(ev)->ev_fd
|
|
||||||
#define EVENT_FD(ev) (int)(ev)->ev_fd
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Key-Value pairs. Can be used for HTTP headers but also for
|
|
||||||
* query argument parsing.
|
|
||||||
*/
|
|
||||||
struct evkeyval {
|
|
||||||
TAILQ_ENTRY(evkeyval) next;
|
|
||||||
|
|
||||||
char *key;
|
|
||||||
char *value;
|
|
||||||
};
|
|
||||||
|
|
||||||
#ifdef _EVENT_DEFINED_TQENTRY
|
|
||||||
#undef TAILQ_ENTRY
|
|
||||||
struct event_list;
|
|
||||||
struct evkeyvalq;
|
|
||||||
#undef _EVENT_DEFINED_TQENTRY
|
|
||||||
#else
|
|
||||||
TAILQ_HEAD (event_list, event);
|
|
||||||
TAILQ_HEAD (evkeyvalq, evkeyval);
|
|
||||||
#endif /* _EVENT_DEFINED_TQENTRY */
|
|
||||||
#ifdef _EVENT_DEFINED_RBENTRY
|
|
||||||
#undef RB_ENTRY
|
|
||||||
#undef _EVENT_DEFINED_RBENTRY
|
|
||||||
#endif /* _EVENT_DEFINED_RBENTRY */
|
|
||||||
|
|
||||||
struct eventop {
|
|
||||||
char *name;
|
|
||||||
void *(*init)(struct event_base *);
|
|
||||||
int (*add)(void *, struct event *);
|
|
||||||
int (*del)(void *, struct event *);
|
|
||||||
int (*recalc)(struct event_base *, void *, int);
|
|
||||||
int (*dispatch)(struct event_base *, void *, struct timeval *);
|
|
||||||
void (*dealloc)(struct event_base *, void *);
|
|
||||||
};
|
|
||||||
|
|
||||||
void *event_init(void);
|
|
||||||
int event_dispatch(void);
|
|
||||||
int event_base_dispatch(struct event_base *);
|
|
||||||
void event_base_free(struct event_base *);
|
|
||||||
|
|
||||||
#define _EVENT_LOG_DEBUG 0
|
|
||||||
#define _EVENT_LOG_MSG 1
|
|
||||||
#define _EVENT_LOG_WARN 2
|
|
||||||
#define _EVENT_LOG_ERR 3
|
|
||||||
typedef void (*event_log_cb)(int severity, const char *msg);
|
|
||||||
void event_set_log_callback(event_log_cb cb);
|
|
||||||
|
|
||||||
/* Associate a different event base with an event */
|
|
||||||
int event_base_set(struct event_base *, struct event *);
|
|
||||||
|
|
||||||
#define EVLOOP_ONCE 0x01
|
|
||||||
#define EVLOOP_NONBLOCK 0x02
|
|
||||||
int event_loop(int);
|
|
||||||
int event_base_loop(struct event_base *, int);
|
|
||||||
int event_loopexit(struct timeval *); /* Causes the loop to exit */
|
|
||||||
int event_base_loopexit(struct event_base *, struct timeval *);
|
|
||||||
|
|
||||||
#define evtimer_add(ev, tv) event_add(ev, tv)
|
|
||||||
#define evtimer_set(ev, cb, arg) event_set(ev, -1, 0, cb, arg)
|
|
||||||
#define evtimer_del(ev) event_del(ev)
|
|
||||||
#define evtimer_pending(ev, tv) event_pending(ev, EV_TIMEOUT, tv)
|
|
||||||
#define evtimer_initialized(ev) ((ev)->ev_flags & EVLIST_INIT)
|
|
||||||
|
|
||||||
#define timeout_add(ev, tv) event_add(ev, tv)
|
|
||||||
#define timeout_set(ev, cb, arg) event_set(ev, -1, 0, cb, arg)
|
|
||||||
#define timeout_del(ev) event_del(ev)
|
|
||||||
#define timeout_pending(ev, tv) event_pending(ev, EV_TIMEOUT, tv)
|
|
||||||
#define timeout_initialized(ev) ((ev)->ev_flags & EVLIST_INIT)
|
|
||||||
|
|
||||||
#define signal_add(ev, tv) event_add(ev, tv)
|
|
||||||
#define signal_set(ev, x, cb, arg) \
|
|
||||||
event_set(ev, x, EV_SIGNAL|EV_PERSIST, cb, arg)
|
|
||||||
#define signal_del(ev) event_del(ev)
|
|
||||||
#define signal_pending(ev, tv) event_pending(ev, EV_SIGNAL, tv)
|
|
||||||
#define signal_initialized(ev) ((ev)->ev_flags & EVLIST_INIT)
|
|
||||||
|
|
||||||
void event_set(struct event *, int, short, void (*)(int, short, void *), void *);
|
|
||||||
int event_once(int, short, void (*)(int, short, void *), void *, struct timeval *);
|
|
||||||
int event_base_once(struct event_base *, int, short, void (*)(int, short, void *), void *, struct timeval *);
|
|
||||||
|
|
||||||
int event_add(struct event *, struct timeval *);
|
|
||||||
int event_del(struct event *);
|
|
||||||
void event_active(struct event *, int, short);
|
|
||||||
|
|
||||||
int event_pending(struct event *, short, struct timeval *);
|
|
||||||
|
|
||||||
#ifdef WIN32
|
|
||||||
#define event_initialized(ev) ((ev)->ev_flags & EVLIST_INIT && (ev)->ev_fd != (int)INVALID_HANDLE_VALUE)
|
|
||||||
#else
|
|
||||||
#define event_initialized(ev) ((ev)->ev_flags & EVLIST_INIT)
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/* Some simple debugging functions */
|
|
||||||
const char *event_get_version(void);
|
|
||||||
const char *event_get_method(void);
|
|
||||||
|
|
||||||
/* These functions deal with event priorities */
|
|
||||||
|
|
||||||
int event_priority_init(int);
|
|
||||||
int event_base_priority_init(struct event_base *, int);
|
|
||||||
int event_priority_set(struct event *, int);
|
|
||||||
|
|
||||||
/* These functions deal with buffering input and output */
|
|
||||||
|
|
||||||
struct evbuffer {
|
|
||||||
u_char *buffer;
|
|
||||||
u_char *orig_buffer;
|
|
||||||
|
|
||||||
size_t misalign;
|
|
||||||
size_t totallen;
|
|
||||||
size_t off;
|
|
||||||
|
|
||||||
void (*cb)(struct evbuffer *, size_t, size_t, void *);
|
|
||||||
void *cbarg;
|
|
||||||
};
|
|
||||||
|
|
||||||
/* Just for error reporting - use other constants otherwise */
|
|
||||||
#define EVBUFFER_READ 0x01
|
|
||||||
#define EVBUFFER_WRITE 0x02
|
|
||||||
#define EVBUFFER_EOF 0x10
|
|
||||||
#define EVBUFFER_ERROR 0x20
|
|
||||||
#define EVBUFFER_TIMEOUT 0x40
|
|
||||||
|
|
||||||
struct bufferevent;
|
|
||||||
typedef void (*evbuffercb)(struct bufferevent *, void *);
|
|
||||||
typedef void (*everrorcb)(struct bufferevent *, short what, void *);
|
|
||||||
|
|
||||||
struct event_watermark {
|
|
||||||
size_t low;
|
|
||||||
size_t high;
|
|
||||||
};
|
|
||||||
|
|
||||||
struct bufferevent {
|
|
||||||
struct event ev_read;
|
|
||||||
struct event ev_write;
|
|
||||||
|
|
||||||
struct evbuffer *input;
|
|
||||||
struct evbuffer *output;
|
|
||||||
|
|
||||||
struct event_watermark wm_read;
|
|
||||||
struct event_watermark wm_write;
|
|
||||||
|
|
||||||
evbuffercb readcb;
|
|
||||||
evbuffercb writecb;
|
|
||||||
everrorcb errorcb;
|
|
||||||
void *cbarg;
|
|
||||||
|
|
||||||
int timeout_read; /* in seconds */
|
|
||||||
int timeout_write; /* in seconds */
|
|
||||||
|
|
||||||
short enabled; /* events that are currently enabled */
|
|
||||||
};
|
|
||||||
|
|
||||||
struct bufferevent *bufferevent_new(int fd,
|
|
||||||
evbuffercb readcb, evbuffercb writecb, everrorcb errorcb, void *cbarg);
|
|
||||||
int bufferevent_base_set(struct event_base *base, struct bufferevent *bufev);
|
|
||||||
int bufferevent_priority_set(struct bufferevent *bufev, int pri);
|
|
||||||
void bufferevent_free(struct bufferevent *bufev);
|
|
||||||
int bufferevent_write(struct bufferevent *bufev, void *data, size_t size);
|
|
||||||
int bufferevent_write_buffer(struct bufferevent *bufev, struct evbuffer *buf);
|
|
||||||
size_t bufferevent_read(struct bufferevent *bufev, void *data, size_t size);
|
|
||||||
int bufferevent_enable(struct bufferevent *bufev, short event);
|
|
||||||
int bufferevent_disable(struct bufferevent *bufev, short event);
|
|
||||||
void bufferevent_settimeout(struct bufferevent *bufev,
|
|
||||||
int timeout_read, int timeout_write);
|
|
||||||
|
|
||||||
#define EVBUFFER_LENGTH(x) (x)->off
|
|
||||||
#define EVBUFFER_DATA(x) (x)->buffer
|
|
||||||
#define EVBUFFER_INPUT(x) (x)->input
|
|
||||||
#define EVBUFFER_OUTPUT(x) (x)->output
|
|
||||||
|
|
||||||
struct evbuffer *evbuffer_new(void);
|
|
||||||
void evbuffer_free(struct evbuffer *);
|
|
||||||
int evbuffer_expand(struct evbuffer *, size_t);
|
|
||||||
int evbuffer_add(struct evbuffer *, const void *, size_t);
|
|
||||||
int evbuffer_remove(struct evbuffer *, void *, size_t);
|
|
||||||
char *evbuffer_readline(struct evbuffer *);
|
|
||||||
int evbuffer_add_buffer(struct evbuffer *, struct evbuffer *);
|
|
||||||
int evbuffer_add_printf(struct evbuffer *, const char *fmt, ...);
|
|
||||||
int evbuffer_add_vprintf(struct evbuffer *, const char *fmt, va_list ap);
|
|
||||||
void evbuffer_drain(struct evbuffer *, size_t);
|
|
||||||
int evbuffer_write(struct evbuffer *, int);
|
|
||||||
int evbuffer_read(struct evbuffer *, int, int);
|
|
||||||
u_char *evbuffer_find(struct evbuffer *, const u_char *, size_t);
|
|
||||||
void evbuffer_setcb(struct evbuffer *, void (*)(struct evbuffer *, size_t, size_t, void *), void *);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Marshaling tagged data - We assume that all tags are inserted in their
|
|
||||||
* numeric order - so that unknown tags will always be higher than the
|
|
||||||
* known ones - and we can just ignore the end of an event buffer.
|
|
||||||
*/
|
|
||||||
|
|
||||||
void evtag_init(void);
|
|
||||||
|
|
||||||
void evtag_marshal(struct evbuffer *evbuf, uint8_t tag, const void *data,
|
|
||||||
uint32_t len);
|
|
||||||
|
|
||||||
void encode_int(struct evbuffer *evbuf, uint32_t number);
|
|
||||||
|
|
||||||
void evtag_marshal_int(struct evbuffer *evbuf, uint8_t tag, uint32_t integer);
|
|
||||||
|
|
||||||
void evtag_marshal_string(struct evbuffer *buf, uint8_t tag,
|
|
||||||
const char *string);
|
|
||||||
|
|
||||||
void evtag_marshal_timeval(struct evbuffer *evbuf, uint8_t tag,
|
|
||||||
struct timeval *tv);
|
|
||||||
|
|
||||||
void evtag_test(void);
|
|
||||||
|
|
||||||
int evtag_unmarshal(struct evbuffer *src, uint8_t *ptag, struct evbuffer *dst);
|
|
||||||
int evtag_peek(struct evbuffer *evbuf, uint8_t *ptag);
|
|
||||||
int evtag_peek_length(struct evbuffer *evbuf, uint32_t *plength);
|
|
||||||
int evtag_payload_length(struct evbuffer *evbuf, uint32_t *plength);
|
|
||||||
int evtag_consume(struct evbuffer *evbuf);
|
|
||||||
|
|
||||||
int evtag_unmarshal_int(struct evbuffer *evbuf, uint8_t need_tag,
|
|
||||||
uint32_t *pinteger);
|
|
||||||
|
|
||||||
int evtag_unmarshal_fixed(struct evbuffer *src, uint8_t need_tag, void *data,
|
|
||||||
size_t len);
|
|
||||||
|
|
||||||
int evtag_unmarshal_string(struct evbuffer *evbuf, uint8_t need_tag,
|
|
||||||
char **pstring);
|
|
||||||
|
|
||||||
int evtag_unmarshal_timeval(struct evbuffer *evbuf, uint8_t need_tag,
|
|
||||||
struct timeval *ptv);
|
|
||||||
|
|
||||||
#ifdef __cplusplus
|
|
||||||
}
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#endif /* _EVENT_H_ */
|
|
|
@ -1,219 +0,0 @@
|
||||||
/*
|
|
||||||
* Copyright (c) 2000-2004 Niels Provos <provos@citi.umich.edu>
|
|
||||||
* All rights reserved.
|
|
||||||
*
|
|
||||||
* Redistribution and use in source and binary forms, with or without
|
|
||||||
* modification, are permitted provided that the following conditions
|
|
||||||
* are met:
|
|
||||||
* 1. Redistributions of source code must retain the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer.
|
|
||||||
* 2. Redistributions in binary form must reproduce the above copyright
|
|
||||||
* notice, this list of conditions and the following disclaimer in the
|
|
||||||
* documentation and/or other materials provided with the distribution.
|
|
||||||
* 3. The name of the author may not be used to endorse or promote products
|
|
||||||
* derived from this software without specific prior written permission.
|
|
||||||
*
|
|
||||||
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
|
||||||
* IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
|
||||||
* OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
|
||||||
* IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
|
||||||
* INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
|
||||||
* NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
||||||
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
||||||
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
||||||
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
|
||||||
* THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
||||||
*/
|
|
||||||
#ifndef _EVHTTP_H_
|
|
||||||
#define _EVHTTP_H_
|
|
||||||
|
|
||||||
#ifdef __cplusplus
|
|
||||||
extern "C" {
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#ifdef WIN32
|
|
||||||
#define WIN32_LEAN_AND_MEAN
|
|
||||||
#include <windows.h>
|
|
||||||
#include <winsock2.h>
|
|
||||||
#undef WIN32_LEAN_AND_MEAN
|
|
||||||
#endif
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Basic support for HTTP serving.
|
|
||||||
*
|
|
||||||
* As libevent is a library for dealing with event notification and most
|
|
||||||
* interesting applications are networked today, I have often found the
|
|
||||||
* need to write HTTP code. The following prototypes and definitions provide
|
|
||||||
* an application with a minimal interface for making HTTP requests and for
|
|
||||||
* creating a very simple HTTP server.
|
|
||||||
*/
|
|
||||||
|
|
||||||
/* Response codes */
|
|
||||||
#define HTTP_OK 200
|
|
||||||
#define HTTP_NOCONTENT 204
|
|
||||||
#define HTTP_MOVEPERM 301
|
|
||||||
#define HTTP_MOVETEMP 302
|
|
||||||
#define HTTP_NOTMODIFIED 304
|
|
||||||
#define HTTP_BADREQUEST 400
|
|
||||||
#define HTTP_NOTFOUND 404
|
|
||||||
#define HTTP_SERVUNAVAIL 503
|
|
||||||
|
|
||||||
struct evhttp;
|
|
||||||
struct evhttp_request;
|
|
||||||
struct evkeyvalq;
|
|
||||||
|
|
||||||
/* Start an HTTP server on the specified address and port */
|
|
||||||
struct evhttp *evhttp_start(const char *address, u_short port);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Free the previously create HTTP server. Works only if no requests are
|
|
||||||
* currently being served.
|
|
||||||
*/
|
|
||||||
void evhttp_free(struct evhttp* http);
|
|
||||||
|
|
||||||
/* Set a callback for a specified URI */
|
|
||||||
void evhttp_set_cb(struct evhttp *, const char *,
|
|
||||||
void (*)(struct evhttp_request *, void *), void *);
|
|
||||||
|
|
||||||
/* Removes the callback for a specified URI */
|
|
||||||
int evhttp_del_cb(struct evhttp *, const char *);
|
|
||||||
|
|
||||||
/* Set a callback for all requests that are not caught by specific callbacks */
|
|
||||||
void evhttp_set_gencb(struct evhttp *,
|
|
||||||
void (*)(struct evhttp_request *, void *), void *);
|
|
||||||
|
|
||||||
void evhttp_set_timeout(struct evhttp *, int timeout_in_secs);
|
|
||||||
|
|
||||||
/* Request/Response functionality */
|
|
||||||
|
|
||||||
void evhttp_send_error(struct evhttp_request *, int, const char *);
|
|
||||||
void evhttp_send_reply(struct evhttp_request *, int, const char *,
|
|
||||||
struct evbuffer *);
|
|
||||||
|
|
||||||
/* Low-level response interface, for streaming/chunked replies */
|
|
||||||
void evhttp_send_reply_start(struct evhttp_request *, int, const char *);
|
|
||||||
void evhttp_send_reply_chunk(struct evhttp_request *, struct evbuffer *);
|
|
||||||
void evhttp_send_reply_end(struct evhttp_request *);
|
|
||||||
|
|
||||||
/* Interfaces for making requests */
|
|
||||||
enum evhttp_cmd_type { EVHTTP_REQ_GET, EVHTTP_REQ_POST, EVHTTP_REQ_HEAD };
|
|
||||||
|
|
||||||
enum evhttp_request_kind { EVHTTP_REQUEST, EVHTTP_RESPONSE };
|
|
||||||
|
|
||||||
/*
|
|
||||||
* the request structure that a server receives.
|
|
||||||
* WARNING: expect this structure to change. I will try to provide
|
|
||||||
* reasonable accessors.
|
|
||||||
*/
|
|
||||||
struct evhttp_request {
|
|
||||||
TAILQ_ENTRY(evhttp_request) next;
|
|
||||||
|
|
||||||
/* the connection object that this request belongs to */
|
|
||||||
struct evhttp_connection *evcon;
|
|
||||||
int flags;
|
|
||||||
#define EVHTTP_REQ_OWN_CONNECTION 0x0001
|
|
||||||
#define EVHTTP_PROXY_REQUEST 0x0002
|
|
||||||
|
|
||||||
struct evkeyvalq *input_headers;
|
|
||||||
struct evkeyvalq *output_headers;
|
|
||||||
|
|
||||||
/* address of the remote host and the port connection came from */
|
|
||||||
char *remote_host;
|
|
||||||
u_short remote_port;
|
|
||||||
|
|
||||||
enum evhttp_request_kind kind;
|
|
||||||
enum evhttp_cmd_type type;
|
|
||||||
|
|
||||||
char *uri; /* uri after HTTP request was parsed */
|
|
||||||
|
|
||||||
char major; /* HTTP Major number */
|
|
||||||
char minor; /* HTTP Minor number */
|
|
||||||
|
|
||||||
int got_firstline;
|
|
||||||
int response_code; /* HTTP Response code */
|
|
||||||
char *response_code_line; /* Readable response */
|
|
||||||
|
|
||||||
struct evbuffer *input_buffer; /* read data */
|
|
||||||
int ntoread;
|
|
||||||
int chunked;
|
|
||||||
|
|
||||||
struct evbuffer *output_buffer; /* outgoing post or data */
|
|
||||||
|
|
||||||
/* Callback */
|
|
||||||
void (*cb)(struct evhttp_request *, void *);
|
|
||||||
void *cb_arg;
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Chunked data callback - call for each completed chunk if
|
|
||||||
* specified. If not specified, all the data is delivered via
|
|
||||||
* the regular callback.
|
|
||||||
*/
|
|
||||||
void (*chunk_cb)(struct evhttp_request *, void *);
|
|
||||||
};
|
|
||||||
|
|
||||||
/*
|
|
||||||
* Creates a new request object that needs to be filled in with the request
|
|
||||||
* parameters. The callback is executed when the request completed or an
|
|
||||||
* error occurred.
|
|
||||||
*/
|
|
||||||
struct evhttp_request *evhttp_request_new(
|
|
||||||
void (*cb)(struct evhttp_request *, void *), void *arg);
|
|
||||||
|
|
||||||
/* enable delivery of chunks to requestor */
|
|
||||||
void evhttp_request_set_chunked_cb(struct evhttp_request *,
|
|
||||||
void (*cb)(struct evhttp_request *, void *));
|
|
||||||
|
|
||||||
/* Frees the request object and removes associated events. */
|
|
||||||
void evhttp_request_free(struct evhttp_request *req);
|
|
||||||
|
|
||||||
/*
|
|
||||||
* A connection object that can be used to for making HTTP requests. The
|
|
||||||
* connection object tries to establish the connection when it is given an
|
|
||||||
* http request object.
|
|
||||||
*/
|
|
||||||
struct evhttp_connection *evhttp_connection_new(
|
|
||||||
const char *address, unsigned short port);
|
|
||||||
|
|
||||||
/* Frees an http connection */
|
|
||||||
void evhttp_connection_free(struct evhttp_connection *evcon);
|
|
||||||
|
|
||||||
/* Sets the timeout for events related to this connection */
|
|
||||||
void evhttp_connection_set_timeout(struct evhttp_connection *evcon,
|
|
||||||
int timeout_in_secs);
|
|
||||||
|
|
||||||
/* Sets the retry limit for this connection - -1 repeats indefnitely */
|
|
||||||
void evhttp_connection_set_retries(struct evhttp_connection *evcon,
|
|
||||||
int retry_max);
|
|
||||||
|
|
||||||
/* Set a callback for connection close. */
|
|
||||||
void evhttp_connection_set_closecb(struct evhttp_connection *evcon,
|
|
||||||
void (*)(struct evhttp_connection *, void *), void *);
|
|
||||||
|
|
||||||
/* Get the remote address and port associated with this connection. */
|
|
||||||
void evhttp_connection_get_peer(struct evhttp_connection *evcon,
|
|
||||||
char **address, u_short *port);
|
|
||||||
|
|
||||||
/* The connection gets ownership of the request */
|
|
||||||
int evhttp_make_request(struct evhttp_connection *evcon,
|
|
||||||
struct evhttp_request *req,
|
|
||||||
enum evhttp_cmd_type type, const char *uri);
|
|
||||||
|
|
||||||
const char *evhttp_request_uri(struct evhttp_request *req);
|
|
||||||
|
|
||||||
/* Interfaces for dealing with HTTP headers */
|
|
||||||
|
|
||||||
const char *evhttp_find_header(const struct evkeyvalq *, const char *);
|
|
||||||
int evhttp_remove_header(struct evkeyvalq *, const char *);
|
|
||||||
int evhttp_add_header(struct evkeyvalq *, const char *, const char *);
|
|
||||||
void evhttp_clear_headers(struct evkeyvalq *);
|
|
||||||
|
|
||||||
/* Miscellaneous utility functions */
|
|
||||||
char *evhttp_encode_uri(const char *uri);
|
|
||||||
char *evhttp_decode_uri(const char *uri);
|
|
||||||
void evhttp_parse_query(const char *uri, struct evkeyvalq *);
|
|
||||||
char *evhttp_htmlescape(const char *html);
|
|
||||||
#ifdef __cplusplus
|
|
||||||
}
|
|
||||||
#endif
|
|
||||||
|
|
||||||
#endif /* _EVHTTP_H_ */
|
|
Binary file not shown.
Loading…
Reference in New Issue