32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/*
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor** Licensed to the Apache Software Foundation (ASF) under one or more
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor** contributor license agreements. See the NOTICE file distributed with
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor** this work for additional information regarding copyright ownership.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor** The ASF licenses this file to You under the Apache License, Version 2.0
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor** (the "License"); you may not use this file except in compliance with
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor** the License. You may obtain a copy of the License at
96ad5d81ee4a2cc66a4ae19893efc8aa6d06fae7jailletc**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor** http://www.apache.org/licenses/LICENSE-2.0
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor** Unless required by applicable law or agreed to in writing, software
2e545ce2450a9953665f701bb05350f0d3f26275nd** distributed under the License is distributed on an "AS IS" BASIS,
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor** See the License for the specific language governing permissions and
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor** limitations under the License.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor*/
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor#ifndef APREQ_MODULE_H
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor#define APREQ_MODULE_H
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor#include "apreq_cookie.h"
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor#include "apreq_parser.h"
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor#include "apreq_error.h"
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor#ifdef __cplusplus
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor extern "C" {
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor#endif
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @file apreq_module.h
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @brief Module API
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @ingroup libapreq2
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * An apreq handle associated with a module. The structure
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * may have variable size, because the module may append its own data
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * structures after it.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzortypedef struct apreq_handle_t {
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** the apreq module which implements this handle */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor const struct apreq_module_t *module;
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** the pool which defines the lifetime of the parsed data */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_pool_t *pool;
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** the allocator, which persists at least as long as the pool */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_bucket_alloc_t *bucket_alloc;
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor} apreq_handle_t;
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @brief Vtable describing the necessary module functions.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzortypedef struct apreq_module_t {
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** name of this apreq module */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor const char *name;
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** magic number identifying the module and version */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_uint32_t magic_number;
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** get a table with all cookies */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*jar)(apreq_handle_t *, const apr_table_t **);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** get a table with all query string parameters */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*args)(apreq_handle_t *, const apr_table_t **);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** get a table with all body parameters */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*body)(apreq_handle_t *, const apr_table_t **);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** get a cookie by its name */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apreq_cookie_t *(*jar_get)(apreq_handle_t *, const char *);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** get a query string parameter by its name */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apreq_param_t *(*args_get)(apreq_handle_t *, const char *);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** get a body parameter by its name */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apreq_param_t *(*body_get)(apreq_handle_t *, const char *);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** gets the parser associated with the request body */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*parser_get)(apreq_handle_t *, const apreq_parser_t **);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** manually set a parser for the request body */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*parser_set)(apreq_handle_t *, apreq_parser_t *);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** add a hook function */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*hook_add)(apreq_handle_t *, apreq_hook_t *);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** determine the maximum in-memory bytes a brigade may use */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*brigade_limit_get)(apreq_handle_t *, apr_size_t *);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** set the maximum in-memory bytes a brigade may use */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*brigade_limit_set)(apreq_handle_t *, apr_size_t);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** determine the maximum amount of data that will be fed into a parser */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*read_limit_get)(apreq_handle_t *, apr_uint64_t *);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** set the maximum amount of data that will be fed into a parser */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*read_limit_set)(apreq_handle_t *, apr_uint64_t);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** determine the directory used by the parser for temporary files */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*temp_dir_get)(apreq_handle_t *, const char **);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor /** set the directory used by the parser for temporary files */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_status_t (*temp_dir_set)(apreq_handle_t *, const char *);
4aa603e6448b99f9371397d439795c91a93637eand
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor} apreq_module_t;
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Defines the module-specific status codes which
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * are commonly considered to be non-fatal.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param s status code returned by an apreq_module_t method.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @return 1 if s is fatal, 0 otherwise.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
4aa603e6448b99f9371397d439795c91a93637eandstatic APR_INLINE
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorunsigned apreq_module_status_is_error(apr_status_t s) {
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor switch (s) {
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor case APR_SUCCESS:
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor case APR_INCOMPLETE:
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor case APR_EINIT:
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor case APREQ_ERROR_NODATA:
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor case APREQ_ERROR_NOPARSER:
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor case APREQ_ERROR_NOHEADER:
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return 0;
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor default:
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return 1;
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor }
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor}
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Expose the parsed "cookie" header associated to this handle.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param req The request handle
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param t The resulting table, which will either be NULL or a
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * valid table object on return.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @return APR_SUCCESS or a module-specific error status code.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorstatic APR_INLINE
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorapr_status_t apreq_jar(apreq_handle_t *req, const apr_table_t **t)
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor{
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return req->module->jar(req,t);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor}
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Expose the parsed "query string" associated to this handle.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param req The request handle
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param t The resulting table, which will either be NULL or a
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * valid table object on return.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @return APR_SUCCESS or a module-specific error status code.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorstatic APR_INLINE
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorapr_status_t apreq_args(apreq_handle_t *req, const apr_table_t **t)
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor{
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return req->module->args(req,t);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor}
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Expose the parsed "request body" associated to this handle.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param req The request handle
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param t The resulting table, which will either be NULL or a
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * valid table object on return.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @return APR_SUCCESS or a module-specific error status code.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorstatic APR_INLINE
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorapr_status_t apreq_body(apreq_handle_t *req, const apr_table_t **t)
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor{
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return req->module->body(req, t);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor}
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Fetch the first cookie with the given name.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param req The request handle
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param name Case-insensitive cookie name.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @return First matching cookie, or NULL if none match.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorstatic APR_INLINE
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorapreq_cookie_t *apreq_jar_get(apreq_handle_t *req, const char *name)
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor{
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return req->module->jar_get(req, name);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor}
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Fetch the first query string param with the given name.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param req The request handle
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param name Case-insensitive param name.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @return First matching param, or NULL if none match.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorstatic APR_INLINE
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorapreq_param_t *apreq_args_get(apreq_handle_t *req, const char *name)
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor{
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return req->module->args_get(req, name);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor}
4aa603e6448b99f9371397d439795c91a93637eand
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Fetch the first body param with the given name.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param req The request handle
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param name Case-insensitive cookie name.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @return First matching param, or NULL if none match.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorstatic APR_INLINE
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorapreq_param_t *apreq_body_get(apreq_handle_t *req, const char *name)
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor{
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return req->module->body_get(req, name);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor}
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Fetch the active body parser.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param req The request handle
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param parser Points to the active parser on return.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @return APR_SUCCESS or module-specific error.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorstatic APR_INLINE
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorapr_status_t apreq_parser_get(apreq_handle_t *req,
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor const apreq_parser_t **parser)
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor{
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return req->module->parser_get(req, parser);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor}
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Set the body parser for this request.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param req The request handle
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param parser New parser to use.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @return APR_SUCCESS or module-specific error.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorstatic APR_INLINE
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorapr_status_t apreq_parser_set(apreq_handle_t *req,
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apreq_parser_t *parser)
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor{
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return req->module->parser_set(req, parser);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor}
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Add a parser hook for this request.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param req The request handle
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param hook Hook to add.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @return APR_SUCCESS or module-specific error.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorstatic APR_INLINE
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorapr_status_t apreq_hook_add(apreq_handle_t *req, apreq_hook_t *hook)
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor{
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return req->module->hook_add(req, hook);
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor}
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Set the active brigade limit.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param req The handle.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param bytes New limit to use.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @return APR_SUCCESS or module-specific error.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor */
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorstatic APR_INLINE
32f5dfaca53f31a4ccb791a811607367ce16e832gryzorapr_status_t apreq_brigade_limit_set(apreq_handle_t *req,
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor apr_size_t bytes)
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor{
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor return req->module->brigade_limit_set(req, bytes);
07dc96d063d49299da433f84b5c5681da9bbdf68rbowen}
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor/**
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * Get the active brigade limit.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor *
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param req The handle.
32f5dfaca53f31a4ccb791a811607367ce16e832gryzor * @param bytes Pointer to resulting (current) limit.
*
* @return APR_SUCCESS or a module-specific error,
* which may leave bytes undefined.
*/
static APR_INLINE
apr_status_t apreq_brigade_limit_get(apreq_handle_t *req,
apr_size_t *bytes)
{
return req->module->brigade_limit_get(req, bytes);
}
/**
* Set the active read limit.
*
* @param req The handle.
* @param bytes New limit to use.
*
* @return APR_SUCCESS or a module-specific error.
*
*/
static APR_INLINE
apr_status_t apreq_read_limit_set(apreq_handle_t *req,
apr_uint64_t bytes)
{
return req->module->read_limit_set(req, bytes);
}
/**
* Get the active read limit.
*
* @param req The request handle.
* @param bytes Pointer to resulting (current) limit.
*
* @return APR_SUCCESS or a module-specific error,
* which may leave bytes undefined.
*/
static APR_INLINE
apr_status_t apreq_read_limit_get(apreq_handle_t *req,
apr_uint64_t *bytes)
{
return req->module->read_limit_get(req, bytes);
}
/**
* Set the active temp directory.
*
* @param req The handle.
* @param path New path to use; may be NULL.
*
* @return APR_SUCCESS or a module-specific error .
*/
static APR_INLINE
apr_status_t apreq_temp_dir_set(apreq_handle_t *req, const char *path)
{
return req->module->temp_dir_set(req, path);
}
/**
* Get the active temp directory.
*
* @param req The handle.
* @param path Resulting path to temp dir.
*
* @return APR_SUCCESS implies path is valid, but may also be NULL.
* Any other return value is module-specific, and may leave
* path undefined.
*/
static APR_INLINE
apr_status_t apreq_temp_dir_get(apreq_handle_t *req, const char **path)
{
return req->module->temp_dir_get(req, path);
}
/**
* Convenience macro for defining a module by mapping
* a function prefix to an associated apreq_module_t structure.
*
* @param pre Prefix to define new module. All attributes of
* the apreq_module_t struct are defined with this as their
* prefix. The generated struct is named by appending "_module" to
* the prefix.
* @param mmn Magic number (i.e. version number) of this module.
*/
#define APREQ_MODULE(pre, mmn) const apreq_module_t \
pre##_module = { #pre, mmn, \
pre##_jar, pre##_args, pre##_body, \
pre##_jar_get, pre##_args_get, pre##_body_get, \
pre##_parser_get, pre##_parser_set, pre##_hook_add, \
pre##_brigade_limit_get, pre##_brigade_limit_set, \
pre##_read_limit_get, pre##_read_limit_set, \
pre##_temp_dir_get, pre##_temp_dir_set, \
}
/**
* Create an apreq handle which is suitable for a CGI program. It
* reads input from stdin and writes output to stdout.
*
* @param pool Pool associated to this handle.
*
* @return New handle; can only be NULL if the pool allocation failed.
*
* @remarks The handle gets cached in the pool's userdata, so subsequent
* calls will retrieve the original cached handle.
*/
APREQ_DECLARE(apreq_handle_t*) apreq_handle_cgi(apr_pool_t *pool);
/**
* Create a custom apreq handle which knows only some static
* values. Useful if you want to test the parser code or if you have
* got data from a custom source (neither Apache 2 nor CGI).
*
* @param pool allocates the parse data,
* @param query_string parsed into args table
* @param cookie value of the request "Cookie" header
* @param parser parses the request body
* @param read_limit maximum bytes to read from the body
* @param in brigade containing the request body
*
* @return new handle; can only be NULL if the pool allocation failed.
*/
APREQ_DECLARE(apreq_handle_t*) apreq_handle_custom(apr_pool_t *pool,
const char *query_string,
const char *cookie,
apreq_parser_t *parser,
apr_uint64_t read_limit,
apr_bucket_brigade *in);
/**
* Find the first query string parameter or body parameter with the
* specified name. The match is case-insensitive.
*
* @param req request handle.
* @param key desired parameter name
*
* @return The first matching parameter (with args searched first) or NULL.
*/
APREQ_DECLARE(apreq_param_t *)apreq_param(apreq_handle_t *req, const char *key);
/**
* Find the first cookie with the specified name.
* The match is case-insensitive.
*
* @param req request handle.
* @param name desired cookie name
*
* @return The first matching cookie or NULL.
*/
#define apreq_cookie(req, name) apreq_jar_get(req, name)
/**
* Returns a table containing key-value pairs for the full request
* (args + body).
*
* @param req request handle
* @param p allocates the returned table.
*
* @return table representing all available params; is never NULL.
*/
APREQ_DECLARE(apr_table_t *) apreq_params(apreq_handle_t *req, apr_pool_t *p);
/**
* Returns a table containing all request cookies.
*
* @param req the apreq request handle
* @param p Allocates the returned table.
*/
APREQ_DECLARE(apr_table_t *)apreq_cookies(apreq_handle_t *req, apr_pool_t *p);
#ifdef __cplusplus
}
#endif
#endif /* APREQ_MODULE_H */