I would appreciate any donations. Wishlist or send e-mail type donations to maekawa AT daemon-systems.org.

Thank you.


evhttp(3)                  Library Functions Manual                  evhttp(3)



NAME
       evhttp -

       Basic support for HTTP serving.


SYNOPSIS
       #include <event2/http.h>
       #include <event2/util.h>


   Macros
           #define EVHTTP_URI_NONCONFORMANT   0x01
           Tolerate URIs that do not conform to RFC3986.  #define
           HTTP_BADMETHOD   405
           method not allowed for this uri  #define HTTP_BADREQUEST   400
           invalid http request was made  #define HTTP_ENTITYTOOLARGE   413
           #define HTTP_EXPECTATIONFAILED   417
           we can't handle this expectation  #define HTTP_INTERNAL   500
           internal error  #define HTTP_MOVEPERM   301
           the uri moved permanently  #define HTTP_MOVETEMP   302
           the uri moved temporarily  #define HTTP_NOCONTENT   204
           request does not have content  #define HTTP_NOTFOUND   404
           could not find content for uri  #define HTTP_NOTIMPLEMENTED   501
           not implemented  #define HTTP_NOTMODIFIED   304
           page was not modified from last  #define HTTP_OK   200
           request completed ok  #define HTTP_SERVUNAVAIL   503
           the server is not available

   Enumerations
           enum evhttp_cmd_type { EVHTTP_REQ_GET = 1 << 0, EVHTTP_REQ_POST = 1
           << 1, EVHTTP_REQ_HEAD = 1 << 2, EVHTTP_REQ_PUT = 1 << 3,
           EVHTTP_REQ_DELETE = 1 << 4, EVHTTP_REQ_OPTIONS = 1 << 5,
           EVHTTP_REQ_TRACE = 1 << 6, EVHTTP_REQ_CONNECT = 1 << 7,
           EVHTTP_REQ_PATCH = 1 << 8 }
           The different request types supported by evhttp.  enum
           evhttp_request_kind { EVHTTP_REQUEST, EVHTTP_RESPONSE }
           a request object can represent either a request or a reply

   Functions
           int evhttp_accept_socket (struct evhttp *http, evutil_socket_t fd)
           Makes an HTTP server accept connections on the specified socket.
           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.  int evhttp_add_header (struct evkeyvalq *headers,
           const char *key, const char *value)
           Adds a header to a list of existing headers.  int
           evhttp_add_server_alias (struct evhttp *http, const char *alias)
           Add a server alias to an http object.  int evhttp_add_virtual_host
           (struct evhttp *http, const char *pattern, struct evhttp *vhost)
           Adds a virtual host to the http server.  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_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.  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.  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.
           struct evconnlistener * evhttp_bound_socket_get_listener (struct
           evhttp_bound_socket *bound)
           Return the listener used to implement a bound socket.  void
           evhttp_cancel_request (struct evhttp_request *req)
           Cancels a pending HTTP request.  void evhttp_clear_headers (struct
           evkeyvalq *headers)
           Removes all headers from the header list.  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.
           void evhttp_connection_free (struct evhttp_connection *evcon)
           Frees an http connection.  struct event_base *
           evhttp_connection_get_base (struct evhttp_connection *req)
           Returns the underlying event_base for this connection.  struct
           bufferevent * evhttp_connection_get_bufferevent (struct
           evhttp_connection *evcon)
           Return the bufferevent that an evhttp_connection is using.  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.
           void evhttp_connection_set_closecb (struct evhttp_connection
           *evcon, void(*)(struct evhttp_connection *, void *), void *)
           Set a callback for connection close.  void
           evhttp_connection_set_local_address (struct evhttp_connection
           *evcon, const char *address)
           sets the ip address from which http connections are made  void
           evhttp_connection_set_local_port (struct evhttp_connection *evcon,
           ev_uint16_t port)
           sets the local port from which http connections are made  void
           evhttp_connection_set_max_body_size (struct evhttp_connection
           *evcon, ev_ssize_t new_max_body_size)
           void evhttp_connection_set_max_headers_size (struct
           evhttp_connection *evcon, ev_ssize_t new_max_headers_size)
           void evhttp_connection_set_retries (struct evhttp_connection
           *evcon, int retry_max)
           Sets the retry limit for this connection - -1 repeats indefinitely.
           void evhttp_connection_set_timeout (struct evhttp_connection
           *evcon, int timeout_in_secs)
           Sets the timeout for events related to this connection.  char *
           evhttp_decode_uri (const char *uri)
           Helper function to sort of decode a URI-encoded string.  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.  int evhttp_del_cb (struct evhttp *, const char *)
           Removes the callback for a specified URI.  char * evhttp_encode_uri
           (const char *str)
           Helper function to encode a string for inclusion in a URI.  const
           char * evhttp_find_header (const struct evkeyvalq *headers, const
           char *key)
           Finds the value belonging to a header.  void evhttp_free (struct
           evhttp *http)
           Free the previously created HTTP server.  char * evhttp_htmlescape
           (const char *html)
           Escape HTML character entities in a string.  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.  struct evhttp
           * evhttp_new (struct event_base *base)
           Create a new HTTP server.  int evhttp_parse_query (const char *uri,
           struct evkeyvalq *headers)
           Helper function to parse out arguments in a query.  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.  int evhttp_remove_header (struct evkeyvalq *headers,
           const char *key)
           Removes a header from a list of existing headers.  int
           evhttp_remove_server_alias (struct evhttp *http, const char *alias)
           Remove a server alias from an http object.  int
           evhttp_remove_virtual_host (struct evhttp *http, struct evhttp
           *vhost)
           Removes a virtual host from the http server.  void
           evhttp_request_free (struct evhttp_request *req)
           Frees the request object and removes associated events.  enum
           evhttp_cmd_type evhttp_request_get_command (const struct
           evhttp_request *req)
           Returns the request command.  struct evhttp_connection *
           evhttp_request_get_connection (struct evhttp_request *req)
           Returns the connection object associated with the request or NULL.
           struct evhttp_uri * evhttp_request_get_evhttp_uri (const struct
           evhttp_request *req)
           Returns the request URI (parsed)  const char *
           evhttp_request_get_host (struct evhttp_request *req)
           Returns the host associated with the request.  struct evbuffer *
           evhttp_request_get_input_buffer (struct evhttp_request *req)
           Returns the input buffer.  struct evkeyvalq *
           evhttp_request_get_input_headers (struct evhttp_request *req)
           Returns the input headers.  struct evbuffer *
           evhttp_request_get_output_buffer (struct evhttp_request *req)
           Returns the output buffer.  struct evkeyvalq *
           evhttp_request_get_output_headers (struct evhttp_request *req)
           Returns the output headers.  int evhttp_request_get_response_code
           (const struct evhttp_request *req)
           const char * evhttp_request_get_uri (const struct evhttp_request
           *req)
           Returns the request URI.  int evhttp_request_is_owned (struct
           evhttp_request *req)
           Returns 1 if the request is owned by the user.  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.  void evhttp_request_own (struct evhttp_request
           *req)
           Takes ownership of the request object.  void
           evhttp_request_set_chunked_cb (struct evhttp_request *,
           void(*cb)(struct evhttp_request *, void *))
           Enable delivery of chunks to requestor.  void evhttp_send_error
           (struct evhttp_request *req, int error, const char *reason)
           Send an HTML error message to the client.  void evhttp_send_reply
           (struct evhttp_request *req, int code, const char *reason, struct
           evbuffer *databuf)
           Send an HTML reply to the client.  void evhttp_send_reply_chunk
           (struct evhttp_request *req, struct evbuffer *databuf)
           Send another data chunk as part of an ongoing chunked reply.  void
           evhttp_send_reply_end (struct evhttp_request *req)
           Complete a chunked reply, freeing the request as appropriate.  void
           evhttp_send_reply_start (struct evhttp_request *req, int code,
           const char *reason)
           Initiate a reply that uses Transfer-Encoding chunked.  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 callbacks.  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.  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.  void evhttp_set_max_body_size (struct evhttp *http,
           ev_ssize_t max_body_size)
           XXX Document.  void evhttp_set_max_headers_size (struct evhttp
           *http, ev_ssize_t max_headers_size)
           XXX Document.  void evhttp_set_timeout (struct evhttp *http, int
           timeout_in_secs)
           Set the timeout for an HTTP request.  void evhttp_uri_free (struct
           evhttp_uri *uri)
           Free all memory allocated for a parsed uri.  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 set.  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.  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.  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.  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.  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 contains a Relative-Ref.  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.  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.  struct evhttp_uri * evhttp_uri_new (void)
           Return a new empty evhttp_uri with no fields set.  struct
           evhttp_uri * evhttp_uri_parse (const char *source_uri)
           Alias for evhttp_uri_parse_with_flags(source_uri, 0)  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.
           void evhttp_uri_set_flags (struct evhttp_uri *uri, unsigned flags)
           Changes the flags set on a given URI.  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.  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.
           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.
           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.  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.
           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.  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.  char * evhttp_uridecode (const char *uri, int
           decode_plus, size_t *size_out)
           Helper function to decode a URI-escaped string or HTTP parameter.
           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.

Detailed Description
       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.

Macro Definition Documentation
   #define EVHTTP_URI_NONCONFORMANT   0x01
       Tolerate URIs that do not conform to RFC3986. Unfortunately, some HTTP
       clients generate URIs that, according to RFC3986, are not conformant
       URIs. If you need to support these URIs, you can do so by passing this
       flag to evhttp_uri_parse_with_flags.

       Currently, these changes are:

       o Nonconformant URIs are allowed to contain otherwise unreasonable
         characters in their path, query, and fragment components.
Enumeration Type Documentation
   enum evhttp_cmd_type
       The different request types supported by evhttp. These are as specified
       in RFC2616, except for PATCH which is specified by RFC5789.
       By default, only some of these methods are accepted and passed to user
       callbacks; use evhttp_set_allowed_methods() to change which methods are
       allowed.
Function Documentation
   int evhttp_accept_socket (struct evhttp *http, evutil_socket_tfd)
       Makes an HTTP server accept connections on the specified socket. This
       may be useful to create a socket and then fork multiple instances of an
       http server, or when a socket has been communicated via file descriptor
       passing in situations where an http servers does not have permissions
       to bind to a low-numbered port.
       Can be called multiple times to have the http server listen to multiple
       different sockets.
       Parameters:
           http a pointer to an evhttp object
           fd a socket fd that is ready for accepting connections
       Returns:
           0 on success, -1 on failure.
       See Also:
           evhttp_bind_socket()
   struct evhttp_bound_socket* evhttp_accept_socket_with_handle (struct evhttp
   *http, evutil_socket_tfd) [read]
       Like evhttp_accept_socket(), but returns a handle for referencing the
       socket. The returned pointer is not valid after http is freed.
       Parameters:
           http a pointer to an evhttp object
           fd a socket fd that is ready for accepting connections
       Returns:
           Handle for the socket on success, NULL on failure.
       See Also:
           evhttp_accept_socket(), evhttp_del_accept_socket()
   int evhttp_add_header (struct evkeyvalq *headers, const char *key, const
   char *value)
       Adds a header to a list of existing headers. Parameters:
           headers the evkeyvalq object to which to add a header
           key the name of the header
           value the value belonging to the header
       Returns:
           0 on success, -1 otherwise.
       See Also:
           evhttp_find_header(), evhttp_clear_headers()
   int evhttp_add_server_alias (struct evhttp *http, const char *alias)
       Add a server alias to an http object. The http object can be a virtual
       host or the main server.
       Parameters:
           http the evhttp object
           alias the alias to add
       See Also:
           evhttp_add_remove_alias()
   int evhttp_add_virtual_host (struct evhttp *http, const char *pattern,
   struct evhttp *vhost)
       Adds a virtual host to the http server. A virtual host is a newly
       initialized evhttp object that has request callbacks set on it via
       evhttp_set_cb() or evhttp_set_gencb(). It most not have any listing
       sockets associated with it.
       If the virtual host has not been removed by the time that evhttp_free()
       is called on the main http server, it will be automatically freed, too.
       It is possible to have hierarchical vhosts. For example: A vhost with
       the pattern *.example.com may have other vhosts with patterns
       foo.example.com and bar.example.com associated with it.
       Parameters:
           http the evhttp object to which to add a virtual host
           pattern the glob pattern against which the hostname is matched. The
           match is case insensitive and follows otherwise regular shell
           matching.
           vhost the virtual host to add the regular http server.
       Returns:
           0 on success, -1 on failure
       See Also:
           evhttp_remove_virtual_host()
   struct evhttp_bound_socket* evhttp_bind_listener (struct evhttp *http,
   struct evconnlistener *listener) [read]
       The most low-level evhttp_bind/accept method: takes an evconnlistener,
       and returns an evhttp_bound_socket. The listener will be freed when the
       bound socket is freed.
   int evhttp_bind_socket (struct evhttp *http, const char *address,
   ev_uint16_tport)
       Binds an HTTP server on the specified address and port. Can be called
       multiple times to bind the same http server to multiple different
       ports.
       Parameters:
           http a pointer to an evhttp object
           address a string containing the IP address to listen(2) on
           port the port number to listen on
       Returns:
           0 on success, -1 on failure.
       See Also:
           evhttp_accept_socket()
   struct evhttp_bound_socket* evhttp_bind_socket_with_handle (struct evhttp
   *http, const char *address, ev_uint16_tport) [read]
       Like evhttp_bind_socket(), but returns a handle for referencing the
       socket. The returned pointer is not valid after http is freed.
       Parameters:
           http a pointer to an evhttp object
           address a string containing the IP address to listen(2) on
           port the port number to listen on
       Returns:
           Handle for the socket on success, NULL on failure.
       See Also:
           evhttp_bind_socket(), evhttp_del_accept_socket()
   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.
       Parameters:
           bound_socket a handle returned by
           evhttp_{bind,accept}_socket_with_handle
       Returns:
           the file descriptor used by the bound socket
       See Also:
           evhttp_bind_socket_with_handle(),
           evhttp_accept_socket_with_handle()
   void evhttp_cancel_request (struct evhttp_request *req)
       Cancels a pending HTTP request. Cancels an ongoing HTTP request. The
       callback associated with this request is not executed and the request
       object is freed. If the request is currently being processed, e.g. it
       is ongoing, the corresponding evhttp_connection object is going to get
       reset.
       A request cannot be canceled if its callback has executed already. A
       request may be canceled reentrantly from its chunked callback.
       Parameters:
           req the evhttp_request to cancel; req becomes invalid after this
           call.
   void evhttp_clear_headers (struct evkeyvalq *headers)
       Removes all headers from the header list. Parameters:
           headers the evkeyvalq object from which to remove all headers
   struct evhttp_connection* evhttp_connection_base_new (struct event_base
   *base, struct evdns_base *dnsbase, const char *address, unsigned shortport)
   [read]
       A connection object that can be used to for making HTTP requests. The
       connection object tries to resolve address and establish the connection
       when it is given an http request object.
       Parameters:
           base the event_base to use for handling the connection
           dnsbase the dns_base to use for resolving host names; if not
           specified host name resolution will block.
           address the address to which to connect
           port the port to connect to
       Returns:
           an evhttp_connection object that can be used for making requests
   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.
   void evhttp_connection_set_closecb (struct evhttp_connection *evcon,
   void(*)(struct evhttp_connection *, void *), void *)
       Set a callback for connection close.
   char* evhttp_decode_uri (const char *uri)
       Helper function to sort of decode a URI-encoded string. Unlike
       evhttp_get_decoded_uri, it decodes all plus characters that appear
       after the first question mark character, but no plusses that occur
       before. This is not a good way to decode URIs in whole or in part.
       The returned string must be freed by the caller
       Deprecated
           This function is deprecated; you probably want to use
           evhttp_get_decoded_uri instead.
       Parameters:
           uri an encoded URI
       Returns:
           a newly allocated unencoded URI or NULL on failure
   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. This may be useful when a socket has been sent via file
       descriptor passing and is no longer needed by the current process.
       If you created this bound socket with evhttp_bind_socket_with_handle or
       evhttp_accept_socket_with_handle, this function closes the fd you
       provided. If you created this bound socket with evhttp_bind_listener,
       this function frees the listener you provided.
       bound_socket is an invalid pointer after this call returns.
       Parameters:
           http a pointer to an evhttp object
           bound_socket a handle returned by
           evhttp_{bind,accept}_socket_with_handle
       See Also:
           evhttp_bind_socket_with_handle(),
           evhttp_accept_socket_with_handle()
   char* evhttp_encode_uri (const char *str)
       Helper function to encode a string for inclusion in a URI. All
       characters are replaced by their hex-escaped (%22) equivalents, except
       for characters explicitly unreserved by RFC3986 -- that is, ASCII
       alphanumeric characters, hyphen, dot, underscore, and tilde.
       The returned string must be freed by the caller.
       Parameters:
           str an unencoded string
       Returns:
           a newly allocated URI-encoded string or NULL on failure
   const char* evhttp_find_header (const struct evkeyvalq *headers, const char
   *key)
       Finds the value belonging to a header. Parameters:
           headers the evkeyvalq object in which to find the header
           key the name of the header to find
       Returns:
           a pointer to the value for the header or NULL if the header count
           not be found.
       See Also:
           evhttp_add_header(), evhttp_remove_header()
   void evhttp_free (struct evhttp *http)
       Free the previously created HTTP server. Works only if no requests are
       currently being served.
       Parameters:
           http the evhttp server object to be freed
       See Also:
           evhttp_start()
   char* evhttp_htmlescape (const char *html)
       Escape HTML character entities in a string. Replaces <, >, ", ' and &
       with <, >, ", &#039; and & correspondingly.
       The returned string needs to be freed by the caller.
       Parameters:
           html an unescaped HTML string
       Returns:
           an escaped HTML string or NULL on error
   int evhttp_make_request (struct evhttp_connection *evcon, struct
   evhttp_request *req, enum evhttp_cmd_typetype, const char *uri)
       Make an HTTP request over the specified connection. The connection gets
       ownership of the request. On failure, the request object is no longer
       valid as it has been freed.
       Parameters:
           evcon the evhttp_connection object over which to send the request
           req the previously created and configured request object
           type the request type EVHTTP_REQ_GET, EVHTTP_REQ_POST, etc.
           uri the URI associated with the request
       Returns:
           0 on success, -1 on failure
       See Also:
           evhttp_cancel_request()
   struct evhttp* evhttp_new (struct event_base *base) [read]
       Create a new HTTP server. Parameters:
           base (optional) the event base to receive the HTTP events
       Returns:
           a pointer to a newly initialized evhttp server structure
       See Also:
           evhttp_free()
   int evhttp_parse_query (const char *uri, struct evkeyvalq *headers)
       Helper function to parse out arguments in a query. Parsing a URI like
       http://foo.com/?q=test&s=some+thing
       will result in two entries in the key value queue.
       The first entry is: key='q', value='test' The second entry is: key='s',
       value='some thing'
       Deprecated
           This function is deprecated as of Libevent 2.0.9. Use
           evhttp_uri_parse and evhttp_parse_query_str instead.
       Parameters:
           uri the request URI
           headers the head of the evkeyval queue
       Returns:
           0 on success, -1 on failure
   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. Parsing a query string like
       q=test&s=some+thing
       will result in two entries in the key value queue.
       The first entry is: key='q', value='test' The second entry is: key='s',
       value='some thing'
       Parameters:
           query_parse the query portion of the URI
           headers the head of the evkeyval queue
       Returns:
           0 on success, -1 on failure
   int evhttp_remove_header (struct evkeyvalq *headers, const char *key)
       Removes a header from a list of existing headers. Parameters:
           headers the evkeyvalq object from which to remove a header
           key the name of the header to remove
       Returns:
           0 if the header was removed, -1 otherwise.
       See Also:
           evhttp_find_header(), evhttp_add_header()
   int evhttp_remove_server_alias (struct evhttp *http, const char *alias)
       Remove a server alias from an http object. Parameters:
           http the evhttp object
           alias the alias to remove
       See Also:
           evhttp_add_server_alias()
   int evhttp_remove_virtual_host (struct evhttp *http, struct evhttp *vhost)
       Removes a virtual host from the http server. Parameters:
           http the evhttp object from which to remove the virtual host
           vhost the virtual host to remove from the regular http server.
       Returns:
           0 on success, -1 on failure
       See Also:
           evhttp_add_virtual_host()
   void evhttp_request_free (struct evhttp_request *req)
       Frees the request object and removes associated events.
   struct evhttp_connection* evhttp_request_get_connection (struct
   evhttp_request *req) [read]
       Returns the connection object associated with the request or NULL. The
       user needs to either free the request explicitly or call
       evhttp_send_reply_end().
   const char* evhttp_request_get_host (struct evhttp_request *req)
       Returns the host associated with the request. If a client sends an
       absolute URI, the host part of that is preferred. Otherwise, the input
       headers are searched for a Host: header. NULL is returned if no
       absolute URI or Host: header is provided.
   struct evhttp_request* evhttp_request_new (void(*)(struct evhttp_request *,
   void *)cb, void *arg) [read]
       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.
   void evhttp_request_own (struct evhttp_request *req)
       Takes ownership of the request object. Can be used in a request
       callback to keep onto the request until evhttp_request_free() is
       explicitly called by the user.
   void evhttp_request_set_chunked_cb (struct evhttp_request *, void(*)(struct
   evhttp_request *, void *)cb)
       Enable delivery of chunks to requestor. Parameters:
           cb will be called after every read of data with the same argument
           as the completion callback. Will never be called on an empty
           response. May drain the input buffer; it will be drained
           automatically on return.
   void evhttp_send_error (struct evhttp_request *req, interror, const char
   *reason)
       Send an HTML error message to the client. Parameters:
           req a request object
           error the HTTP error code
           reason a brief explanation of the error. If this is NULL, we'll
           just use the standard meaning of the error code.
   void evhttp_send_reply (struct evhttp_request *req, intcode, const char
   *reason, struct evbuffer *databuf)
       Send an HTML reply to the client. The body of the reply consists of the
       data in databuf. After calling evhttp_send_reply() databuf will be
       empty, but the buffer is still owned by the caller and needs to be
       deallocated by the caller if necessary.
       Parameters:
           req a request object
           code the HTTP response code to send
           reason a brief message to send with the response code
           databuf the body of the response
   void evhttp_send_reply_chunk (struct evhttp_request *req, struct evbuffer
   *databuf)
       Send another data chunk as part of an ongoing chunked reply. The reply
       chunk consists of the data in databuf. After calling
       evhttp_send_reply_chunk() databuf will be empty, but the buffer is
       still owned by the caller and needs to be deallocated by the caller if
       necessary.
       Parameters:
           req a request object
           databuf the data chunk to send as part of the reply.
   void evhttp_send_reply_end (struct evhttp_request *req)
       Complete a chunked reply, freeing the request as appropriate.
       Parameters:
           req a request object
   void evhttp_send_reply_start (struct evhttp_request *req, intcode, const
   char *reason)
       Initiate a reply that uses Transfer-Encoding chunked. This allows the
       caller to stream the reply back to the client and is useful when either
       not all of the reply data is immediately available or when sending very
       large replies.
       The caller needs to supply data chunks with evhttp_send_reply_chunk()
       and complete the reply by calling evhttp_send_reply_end().
       Parameters:
           req a request object
           code the HTTP response code to send
           reason a brief message to send with the response code
   void evhttp_set_allowed_methods (struct evhttp *http, ev_uint16_tmethods)
       Sets the what HTTP methods are supported in requests accepted by this
       server, and passed to user callbacks. If not supported they will
       generate a '405 Method not allowed' response.
       By default this includes the following methods: GET, POST, HEAD, PUT,
       DELETE
       Parameters:
           http the http server on which to set the methods
           methods bit mask constructed from evhttp_cmd_type values
   int evhttp_set_cb (struct evhttp *http, const char *path, void(*)(struct
   evhttp_request *, void *)cb, void *cb_arg)
       Set a callback for a specified URI. Parameters:
           http the http sever on which to set the callback
           path the path for which to invoke the callback
           cb the callback function that gets invoked on requesting path
           cb_arg an additional context argument for the callback
       Returns:
           0 on success, -1 if the callback existed already, -2 on failure
   void evhttp_set_gencb (struct evhttp *http, void(*)(struct evhttp_request
   *, void *)cb, void *arg)
       Set a callback for all requests that are not caught by specific
       callbacks. Invokes the specified callback for all requests that do not
       match any of the previously specified request paths. This is catchall
       for requests not specifically configured with evhttp_set_cb().
       Parameters:
           http the evhttp server object for which to set the callback
           cb the callback to invoke for any unmatched requests
           arg an context argument for the callback
   void evhttp_set_max_body_size (struct evhttp *http,
   ev_ssize_tmax_body_size)
       XXX Document.
   void evhttp_set_max_headers_size (struct evhttp *http,
   ev_ssize_tmax_headers_size)
       XXX Document.
   void evhttp_set_timeout (struct evhttp *http, inttimeout_in_secs)
       Set the timeout for an HTTP request. Parameters:
           http an evhttp object
           timeout_in_secs the timeout, in seconds
   void evhttp_uri_free (struct evhttp_uri *uri)
       Free all memory allocated for a parsed uri. Only use this for URIs
       generated by evhttp_uri_parse.
       Parameters:
           uri container with parsed data
       See Also:
           evhttp_uri_parse()
   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.
       The host may either be a regular hostname (conforming to the RFC 3986
       'regname' production), or an IPv4 address, or the empty string, or a
       bracketed IPv6 address, or a bracketed 'IP-Future' address.
       Note that having a NULL host means that the URI has no authority
       section, but having an empty-string host means that the URI has an
       authority section with no host part. For example,
       'mailto:user@example.com' has a host of NULL, but 'file:///etc/motd'
       has a host of ''.
   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.
   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 contains a Relative-Ref.
   char* evhttp_uri_join (struct evhttp_uri *uri, char *buf, size_tlimit)
       Join together the uri parts from parsed data to form a URI-Reference.
       Note that no escaping of reserved characters is done on the members of
       the evhttp_uri, so the generated string might not be a valid URI unless
       the members of evhttp_uri are themselves valid.
       Parameters:
           uri container with parsed data
           buf destination buffer
           limit destination buffer size
       Returns:
           an joined uri as string or NULL on error
       See Also:
           evhttp_uri_parse()
   struct evhttp_uri* evhttp_uri_parse_with_flags (const char *source_uri,
   unsignedflags) [read]
       Helper function to parse a URI-Reference as specified by RFC3986. This
       function matches the URI-Reference production from RFC3986, which
       includes both URIs like
       scheme://[[userinfo]@]foo.com[:port]]/[path][?query][#fragment]
       and relative-refs like
       [path][?query][#fragment]
       Any optional elements portions not present in the original URI are left
       set to NULL in the resulting evhttp_uri. If no port is specified, the
       port is set to -1.
       Note that no decoding is performed on percent-escaped characters in the
       string; if you want to parse them, use evhttp_uridecode or
       evhttp_parse_query_str as appropriate.
       Note also that most URI schemes will have additional constraints that
       this function does not know about, and cannot check. For example,
       mailto://www.example.com/cgi-bin/fortune.pl is not a reasonable mailto
       url, http://www.example.com:99999/ is not a reasonable HTTP URL, and
       ftp:username@example.com is not a reasonable FTP URL. Nevertheless, all
       of these URLs conform to RFC3986, and this function accepts all of them
       as valid.
       Parameters:
           source_uri the request URI
           flags Zero or more EVHTTP_URI_* flags to affect the behavior of the
           parser.
       Returns:
           uri container to hold parsed data, or NULL if there is error
       See Also:
           evhttp_uri_free()
   void evhttp_uri_set_flags (struct evhttp_uri *uri, unsignedflags)
       Changes the flags set on a given URI. See EVHTTP_URI_* for a list of
       flags.
   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. The fragment should not include a leading '#'. Returns
       0 on success, -1 if fragment is not well-formed.
   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. Returns
       0 on success, -1 if host is not well-formed.
   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. Returns
       0 on success, -1 if path is not well-formed.
   int evhttp_uri_set_port (struct evhttp_uri *uri, intport)
       Set the port of an evhttp_uri, or clear the port if port==-1. Returns 0
       on success, -1 if port is not well-formed.
   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. The
       query should not include a leading '?'. Returns 0 on success, -1 if
       query is not well-formed.
   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.
       Returns 0 on success, -1 if scheme is not well-formed.
   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. Returns 0 on success, -1 if userinfo is not well-
       formed.
   char* evhttp_uridecode (const char *uri, intdecode_plus, size_t *size_out)
       Helper function to decode a URI-escaped string or HTTP parameter. If
       'decode_plus' is 1, then we decode the string as an HTTP parameter
       value, and convert all plus ('+') characters to spaces. If
       'decode_plus' is 0, we leave all plus characters unchanged.
       The returned string must be freed by the caller.
       Parameters:
           uri a URI-encode encoded URI
           decode_plus determines whether we convert '+' to sapce.
           size_out if size_out is not NULL, *size_out is set to the size of
           the returned string
       Returns:
           a newly allocated unencoded URI or NULL on failure
   char* evhttp_uriencode (const char *str, ev_ssize_tsize, intspace_to_plus)
       As evhttp_encode_uri, but if 'size' is nonnegative, treat the string as
       being 'size' bytes long. This allows you to encode strings that may
       contain 0-valued bytes.
       The returned string must be freed by the caller.
       Parameters:
           str an unencoded string
           size the length of the string to encode, or -1 if the string is
           NUL-terminated
           space_to_plus if true, space characters in 'str' are encoded as +,
           not %20.
       Returns:
           a newly allocate URI-encoded string, or NULL on failure.
Author
       Generated automatically by Doxygen for libevent from the source code.



libevent                        Wed Apr 10 2013                      evhttp(3)