mod_proxy.h revision 908eb2ea826140b279ed8b7fcbbd83555adaf7b3
842ae4bd224140319ae7feec1872b93dfd491143fielding/* Copyright 1999-2004 The Apache Software Foundation
842ae4bd224140319ae7feec1872b93dfd491143fielding * Licensed under the Apache License, Version 2.0 (the "License");
842ae4bd224140319ae7feec1872b93dfd491143fielding * you may not use this file except in compliance with the License.
842ae4bd224140319ae7feec1872b93dfd491143fielding * You may obtain a copy of the License at
2d2eda71267231c2526be701fe655db125852c1ffielding * Unless required by applicable law or agreed to in writing, software
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd * distributed under the License is distributed on an "AS IS" BASIS,
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd * See the License for the specific language governing permissions and
ce9621257ef9e54c1bbe5ad8a5f445a1f211c2dcnd * limitations under the License.
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh * Main include file for the Apache proxy
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh Also note numerous FIXMEs and CHECKMEs which should be eliminated.
2d2eda71267231c2526be701fe655db125852c1ffielding This code is once again experimental!
fcc25eda7b150e226d3c1cdaea66a943d3fdee4erbb Things to do:
92f3af936ce61f25358a3ee4f28df2f6d62040dfdreid 1. Make it completely work (for FTP too)
c9a95767fbf0f5fb0976a06b97a256033925e433rbb 2. HTTP/1.1
2d2eda71267231c2526be701fe655db125852c1ffielding Chuck Murcko <chuck@topsail.org> 02-06-01
bfb62a96023822c56c9120e4ee627d4091cc59c2rbb/* for proxy_canonenc() */
3d96ee83babeec32482c9082c9426340cee8c44dwrowe#else /*APR_CHARSET_EBCDIC*/
61fd0cab072a05b855cbef9c585702401ac5ae29rbb#endif /*APR_CHARSET_EBCDIC*/
61fd0cab072a05b855cbef9c585702401ac5ae29rbb/* default Max-Forwards header setting */
742318b93e89c311f66b55f426c4d9cf2c14628bjim/* static information about a remote proxy */
61fd0cab072a05b855cbef9c585702401ac5ae29rbb const char *scheme; /* the schemes handled by this proxy, or '*' */
2d2eda71267231c2526be701fe655db125852c1ffielding const char *protocol; /* the scheme used to talk to this proxy */
3d96ee83babeec32482c9082c9426340cee8c44dwrowe const char *hostname; /* the hostname of this proxy */
2d2eda71267231c2526be701fe655db125852c1ffielding regex_t *regexp; /* compiled regex (if any) for the remote */
2d2eda71267231c2526be701fe655db125852c1ffielding int use_regex; /* simple boolean. True if we have a regex pattern */
2d2eda71267231c2526be701fe655db125852c1ffielding const char *real;
2d2eda71267231c2526be701fe655db125852c1ffielding const char *fake;
7bdef86e15d47d16dcbe7a5611683191774bd5fbgstein int (*matcher) (struct dirconn_entry * This, request_rec *r);
61fd0cab072a05b855cbef9c585702401ac5ae29rbb const char *name;
61fd0cab072a05b855cbef9c585702401ac5ae29rbbtypedef struct {
c9a95767fbf0f5fb0976a06b97a256033925e433rbb const char *domain; /* domain name to use in absence of a domain name in the request */
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * the following setting masks the error page
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * returned from the 'proxied server' and just
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * forwards the status code upwards.
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * This allows the main server (us) to generate
742318b93e89c311f66b55f426c4d9cf2c14628bjim * the error page, (so it will look like a error
3d96ee83babeec32482c9082c9426340cee8c44dwrowe * returned from the rest of the system
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin/* putting new stuff on the end maximises binary back-compatibility.
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin * the strmatch_patterns are really a const just to have a
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin * case-independent strstr.
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin apr_pool_t *pool; /* Pool used for allocating this struct */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrintypedef struct {
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin const char *p; /* The path */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin int p_is_fnmatch; /* Is this path an fnmatch candidate? */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrintypedef struct {
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin const char *hostname;
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin apr_pool_t *pool; /* Subpool used for creating socket */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin apr_sockaddr_t *addr; /* Preparsed remote address info */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin int close_on_recycle; /* Close the connection when returning to pool */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin proxy_worker *worker; /* Connection pool this connection belogns to */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrintypedef struct {
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin/* Connection pool */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin apr_pool_t *pool; /* The pool used in constructor and destructor calls */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin apr_sockaddr_t *addr; /* Preparsed remote address info */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin proxy_conn_rec *conn; /* Single connection for prefork mpm's */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin/* woker status flags */
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin#define PROXY_WORKER_IS_USABLE(f) (!((f)->s->status & 0x00F0))
eee20257a5ee9228f4aecdf3d3ca68fd0683ff07minfrin/* default worker retry timeout in seconds */
61fd0cab072a05b855cbef9c585702401ac5ae29rbb/* Runtime worker status informations. Shared in scoreboard */
742318b93e89c311f66b55f426c4d9cf2c14628bjimtypedef struct {
3d96ee83babeec32482c9082c9426340cee8c44dwrowe apr_off_t transfered; /* Number of bytes transfered to remote */
2d2eda71267231c2526be701fe655db125852c1ffielding apr_off_t readed; /* Number of bytes readed from remote */
2d2eda71267231c2526be701fe655db125852c1ffielding apr_size_t elected; /* Number of times the worker was elected */
2d2eda71267231c2526be701fe655db125852c1ffielding/* Worker configuration */
2d2eda71267231c2526be701fe655db125852c1ffielding const char *name;
61fd0cab072a05b855cbef9c585702401ac5ae29rbb const char *redirect; /* temporary balancing redirection route */
61fd0cab072a05b855cbef9c585702401ac5ae29rbb int min; /* Desired minimum number of available connections */
61fd0cab072a05b855cbef9c585702401ac5ae29rbb int smax; /* Soft maximum on the total number of connections */
61fd0cab072a05b855cbef9c585702401ac5ae29rbb int hmax; /* Hard maximum on the total number of connections */
61fd0cab072a05b855cbef9c585702401ac5ae29rbb apr_interval_time_t ttl; /* maximum amount of time in seconds a connection
742318b93e89c311f66b55f426c4d9cf2c14628bjim * may be available while exceeding the soft limit */
23ff73a56371e21f16744cb94d06399b877829f1rbb apr_interval_time_t acquire; /* acquire timeout when the maximum number of connections is exceeded */
2d2eda71267231c2526be701fe655db125852c1ffielding apr_array_header_t *workers; /* array of proxy_workers */
62db15de4c1f335a64d45821796ae197cff94ef8rbb int sticky_force; /* Disable failover for sticky sessions */
62db15de4c1f335a64d45821796ae197cff94ef8rbb apr_interval_time_t timeout; /* Timeout for waiting on free connection */
62db15de4c1f335a64d45821796ae197cff94ef8rbb int max_attempts; /* Number of attempts before failing */
fb532d88e92dde225e7e7796dcdec276944bd3e4sf /* XXX: Perhaps we will need the proc mutex too.
62db15de4c1f335a64d45821796ae197cff94ef8rbb * Altrough we are only using arithmetic operations
48d2edbfb84e5559b5da0f8d614ccab805cc67a8rbb * it may lead to a incorrect calculations.
62db15de4c1f335a64d45821796ae197cff94ef8rbb * For now use only the thread mutex.
62db15de4c1f335a64d45821796ae197cff94ef8rbb apr_thread_mutex_t *mutex; /* Thread lock for updating lb params */
62db15de4c1f335a64d45821796ae197cff94ef8rbb/* hooks */
62db15de4c1f335a64d45821796ae197cff94ef8rbb/* Create a set of PROXY_DECLARE(type), PROXY_DECLARE_NONSTD(type) and
62db15de4c1f335a64d45821796ae197cff94ef8rbb * PROXY_DECLARE_DATA with appropriate export and import tags for the platform
48d2edbfb84e5559b5da0f8d614ccab805cc67a8rbb#if !defined(WIN32)
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coar#define PROXY_DECLARE(type) __declspec(dllexport) type __stdcall
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coar#define PROXY_DECLARE_NONSTD(type) __declspec(dllexport) type
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh#define PROXY_DECLARE(type) __declspec(dllimport) type __stdcall
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh#define PROXY_DECLARE_NONSTD(type) __declspec(dllimport) type
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh * Hook an optional proxy hook. Unlike static hooks, this uses a macro
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh * instead of a function.
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coarAPR_DECLARE_EXTERNAL_HOOK(proxy, PROXY, int, scheme_handler, (request_rec *r,
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coar proxy_worker *worker, proxy_server_conf *conf, char *url,
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coarAPR_DECLARE_EXTERNAL_HOOK(proxy, PROXY, int, canon_handler, (request_rec *r,
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coarAPR_DECLARE_EXTERNAL_HOOK(proxy, PROXY, int, create_req, (request_rec *r, request_rec *pr))
3d96ee83babeec32482c9082c9426340cee8c44dwroweAPR_DECLARE_EXTERNAL_HOOK(proxy, PROXY, int, fixups, (request_rec *r))
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coar * pre request hook.
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coar * It will return the most suitable worker at the moment
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coar * and coresponding balancer.
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coar * The url is rewritten from balancer://cluster/uri to scheme://host:port/uri
41287245b1632a4722b55f6dfe5fcf81f361f043wrowe * and then the scheme_handler is called.
3d96ee83babeec32482c9082c9426340cee8c44dwroweAPR_DECLARE_EXTERNAL_HOOK(proxy, PROXY, int, pre_request, (proxy_worker **worker,
41287245b1632a4722b55f6dfe5fcf81f361f043wrowe * post request hook.
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coar * It is called after request for updating runtime balancer status.
91f0d8da77152d24e4bbb31ce199282b3fd6e3b2coarAPR_DECLARE_EXTERNAL_HOOK(proxy, PROXY, int, post_request, (proxy_worker *worker,
41287245b1632a4722b55f6dfe5fcf81f361f043wrowePROXY_DECLARE(request_rec *)ap_proxy_make_fake_req(conn_rec *c, request_rec *r);
3d96ee83babeec32482c9082c9426340cee8c44dwrowePROXY_DECLARE(char *)ap_proxy_canonenc(apr_pool_t *p, const char *x, int len, enum enctype t,
2864362ca8266097928e84f101010bdf814ffa08stoddardPROXY_DECLARE(char *)ap_proxy_canon_netloc(apr_pool_t *p, char **const urlp, char **userp,
db08da9ddcd65c31f9ea44b823898b72a1b24fbestoddardPROXY_DECLARE(const char *)ap_proxy_date_canon(apr_pool_t *p, const char *x);
bf648cbfa4a723c9c02fe8444103cd41ed8642d0wrowePROXY_DECLARE(int) ap_proxy_liststr(const char *list, const char *val);
742318b93e89c311f66b55f426c4d9cf2c14628bjimPROXY_DECLARE(char *)ap_proxy_removestr(apr_pool_t *pool, const char *list, const char *val);
2864362ca8266097928e84f101010bdf814ffa08stoddardPROXY_DECLARE(void) ap_proxy_sec2hex(int t, char *y);
db08da9ddcd65c31f9ea44b823898b72a1b24fbestoddardPROXY_DECLARE(int) ap_proxyerror(request_rec *r, int statuscode, const char *message);
2864362ca8266097928e84f101010bdf814ffa08stoddardPROXY_DECLARE(int) ap_proxy_is_ipaddr(struct dirconn_entry *This, apr_pool_t *p);
af7cd2711a9737c0a2aa1b8475455a7dd8ce6113covenerPROXY_DECLARE(int) ap_proxy_is_domainname(struct dirconn_entry *This, apr_pool_t *p);
beb207f53c871585c4858040f0a8c0e2005c3c6dcovenerPROXY_DECLARE(int) ap_proxy_is_hostname(struct dirconn_entry *This, apr_pool_t *p);
af7cd2711a9737c0a2aa1b8475455a7dd8ce6113covenerPROXY_DECLARE(int) ap_proxy_is_word(struct dirconn_entry *This, apr_pool_t *p);
af7cd2711a9737c0a2aa1b8475455a7dd8ce6113covenerPROXY_DECLARE(int) ap_proxy_checkproxyblock(request_rec *r, proxy_server_conf *conf, apr_sockaddr_t *uri_addr);
af7cd2711a9737c0a2aa1b8475455a7dd8ce6113covenerPROXY_DECLARE(int) ap_proxy_pre_http_request(conn_rec *c, request_rec *r);
af7cd2711a9737c0a2aa1b8475455a7dd8ce6113covenerPROXY_DECLARE(apr_status_t) ap_proxy_string_read(conn_rec *c, apr_bucket_brigade *bb, char *buff, size_t bufflen, int *eos);
af7cd2711a9737c0a2aa1b8475455a7dd8ce6113covenerPROXY_DECLARE(void) ap_proxy_table_unmerge(apr_pool_t *p, apr_table_t *t, char *key);
2d2eda71267231c2526be701fe655db125852c1ffielding/* DEPRECATED (will be replaced with ap_proxy_connect_backend */
2d2eda71267231c2526be701fe655db125852c1ffieldingPROXY_DECLARE(int) ap_proxy_connect_to_backend(apr_socket_t **, const char *, apr_sockaddr_t *, const char *, proxy_server_conf *, server_rec *, apr_pool_t *);
2d2eda71267231c2526be701fe655db125852c1ffieldingPROXY_DECLARE(int) ap_proxy_ssl_enable(conn_rec *c);
2d2eda71267231c2526be701fe655db125852c1ffieldingPROXY_DECLARE(int) ap_proxy_ssl_disable(conn_rec *c);
61fd0cab072a05b855cbef9c585702401ac5ae29rbb/* Connection pool API */
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * Get the worker from proxy configuration
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param p memory pool used for finding worker
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param conf current proxy server configuration
3d96ee83babeec32482c9082c9426340cee8c44dwrowe * @param url url to find the worker from
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgstein * @return proxy_worker or NULL if not found
b5c963a560a55d08763229330dc661b16b726da0sfPROXY_DECLARE(proxy_worker *) ap_proxy_get_worker(apr_pool_t *p,
b5c963a560a55d08763229330dc661b16b726da0sf const char *url);
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * Add the worker to proxy configuration
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param worker the new worker
b5c963a560a55d08763229330dc661b16b726da0sf * @param p memory pool to allocate worker from
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgstein * @param conf current proxy server configuration
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param url url containing worker name
b5c963a560a55d08763229330dc661b16b726da0sf * @return error message or NULL if successfull
61fd0cab072a05b855cbef9c585702401ac5ae29rbbPROXY_DECLARE(const char *) ap_proxy_add_worker(proxy_worker **worker,
61fd0cab072a05b855cbef9c585702401ac5ae29rbb const char *url);
9d8e6c75a763a4d60cd435bfd733ea5fb6b33bb6trawick * Create new worker
b5c963a560a55d08763229330dc661b16b726da0sf * @param p memory pool to allocate worker from
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgstein * @return new worker
61fd0cab072a05b855cbef9c585702401ac5ae29rbbPROXY_DECLARE(proxy_worker *) ap_proxy_create_worker(apr_pool_t *p);
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * Initize the worker's shared data
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param conf current proxy server configuration
64945a581b504264270920efbad4f6af0d5a1978sf * @param worker worker to initialize
a054609255eb3b10ed30e5471b18ea0e7d5f735esf * @param s current server record
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgstein * @param worker worker to initialize
61fd0cab072a05b855cbef9c585702401ac5ae29rbbPROXY_DECLARE(void) ap_proxy_initialize_worker_share(proxy_server_conf *conf,
aecb17a45c6d3ee4729ed5f68dc4270f211ee7a8fielding * Initize the worker
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgstein * @param worker worker to initialize
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param s current server record
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @return APR_SUCCESS or error code
61fd0cab072a05b855cbef9c585702401ac5ae29rbbPROXY_DECLARE(apr_status_t) ap_proxy_initialize_worker(proxy_worker *worker,
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * Get the balancer from proxy configuration
aecb17a45c6d3ee4729ed5f68dc4270f211ee7a8fielding * @param p memory pool used for finding balancer
11e076839c8d5a82d55e710194d0daac51390dbdsf * @param conf current proxy server configuration
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianh * @param url url to find the worker from. Has to have balancer:// prefix
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @return proxy_balancer or NULL if not found
61fd0cab072a05b855cbef9c585702401ac5ae29rbbPROXY_DECLARE(proxy_balancer *) ap_proxy_get_balancer(apr_pool_t *p,
61fd0cab072a05b855cbef9c585702401ac5ae29rbb const char *url);
2d2eda71267231c2526be701fe655db125852c1ffielding * Add the balancer to proxy configuration
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param balancer the new balancer
2d2eda71267231c2526be701fe655db125852c1ffielding * @param p memory pool to allocate balancer from
2d2eda71267231c2526be701fe655db125852c1ffielding * @param conf current proxy server configuration
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param url url containing balancer name
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @return error message or NULL if successfull
3d96ee83babeec32482c9082c9426340cee8c44dwrowePROXY_DECLARE(const char *) ap_proxy_add_balancer(proxy_balancer **balancer,
d839a9822ee53ce00da24c15f2d9fe054233d342gstein const char *url);
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * Add the worker to the balancer
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param pool memory pool for adding worker
d839a9822ee53ce00da24c15f2d9fe054233d342gstein * @param balancer balancer to add to
3d96ee83babeec32482c9082c9426340cee8c44dwrowe * @param balancer worker to add
d839a9822ee53ce00da24c15f2d9fe054233d342gstein * @note Single worker can be added to multiple balancers.
2d2eda71267231c2526be701fe655db125852c1ffieldingPROXY_DECLARE(void) ap_proxy_add_worker_to_balancer(apr_pool_t *pool,
742318b93e89c311f66b55f426c4d9cf2c14628bjim * Get the most suitable worker and(or) balancer for the request
346029f34d03eb20d84fc35664426d3874b00f9ewrowe * @param worker worker used for processing request
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param balancer balancer used for processing request
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param r current request
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param conf current proxy server configuration
346029f34d03eb20d84fc35664426d3874b00f9ewrowe * @param url request url that balancer can rewrite.
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @return OK or HTTP_XXX error
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @note It calls balancer pre_request hook if the url starts with balancer://
3d96ee83babeec32482c9082c9426340cee8c44dwrowe * The balancer then rewrites the url to particular worker, like http://host:port
61fd0cab072a05b855cbef9c585702401ac5ae29rbbPROXY_DECLARE(int) ap_proxy_pre_request(proxy_worker **worker,
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * Post request worker and balancer cleanup
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param worker worker used for processing request
3d96ee83babeec32482c9082c9426340cee8c44dwrowe * @param balancer balancer used for processing request
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgstein * @param r current request
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param conf current proxy server configuration
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @return OK or HTTP_XXX error
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @note When ever the pre_request is called, the post_request has to be
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * called too.
61fd0cab072a05b855cbef9c585702401ac5ae29rbbPROXY_DECLARE(int) ap_proxy_post_request(proxy_worker *worker,
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgstein * Deternime backend hostname and port
a511a29faf2ff7ead3b67680154a624effb31aafminfrin * @param p memory pool used for processing
a511a29faf2ff7ead3b67680154a624effb31aafminfrin * @param r current request
a511a29faf2ff7ead3b67680154a624effb31aafminfrin * @param conf current proxy server configuration
a511a29faf2ff7ead3b67680154a624effb31aafminfrin * @param worker worker used for processing request
1ee3a77e66dfd7ffa0ade4705467da860bb7d272chrisd * @param conn proxy connection struct
a511a29faf2ff7ead3b67680154a624effb31aafminfrin * @param uri processed uri
a511a29faf2ff7ead3b67680154a624effb31aafminfrin * @param url request url
a511a29faf2ff7ead3b67680154a624effb31aafminfrin * @param proxyname are we connecting directly or via s proxy
a511a29faf2ff7ead3b67680154a624effb31aafminfrin * @param proxyport proxy host port
a511a29faf2ff7ead3b67680154a624effb31aafminfrin * @param server_portstr Via headers server port
a511a29faf2ff7ead3b67680154a624effb31aafminfrin * @param server_portstr_size size of the server_portstr buffer
a511a29faf2ff7ead3b67680154a624effb31aafminfrin * @return OK or HTTP_XXX error
a511a29faf2ff7ead3b67680154a624effb31aafminfrinPROXY_DECLARE(int) ap_proxy_determine_connection(apr_pool_t *p, request_rec *r,
61fd0cab072a05b855cbef9c585702401ac5ae29rbb const char *proxyname,
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * Mark a worker for retry
742318b93e89c311f66b55f426c4d9cf2c14628bjim * @param proxy_function calling proxy scheme (http, ajp, ...)
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param conf current proxy server configuration
3d96ee83babeec32482c9082c9426340cee8c44dwrowe * @param worker worker used for retrying
2d2eda71267231c2526be701fe655db125852c1ffielding * @param s current server record
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @return OK if marked for retry, DECLINED otherwise
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @note Worker will be marker for retry if the time of the last retry
a44d29a3794110c558c940bd903a1930d717a7d7sf * has been ellapsed. In case there is no retry option set, defaults to
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * number_of_retries seconds.
3d96ee83babeec32482c9082c9426340cee8c44dwrowePROXY_DECLARE(int) ap_proxy_retry_worker(const char *proxy_function,
742318b93e89c311f66b55f426c4d9cf2c14628bjim * Acquire a connection from workers connection pool
3d96ee83babeec32482c9082c9426340cee8c44dwrowe * @param proxy_function calling proxy scheme (http, ajp, ...)
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgstein * @param conn acquired connection
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param worker worker used for obtaining connection
a44d29a3794110c558c940bd903a1930d717a7d7sf * @param s current server record
742318b93e89c311f66b55f426c4d9cf2c14628bjim * @return OK or HTTP_XXX error
3d96ee83babeec32482c9082c9426340cee8c44dwrowe * @note If the number of connections is exhaused the function will
a6b9ed64fdf548c61de9714e2cfb999ec59d149cgstein * block untill the timeout is reached.
a44d29a3794110c558c940bd903a1930d717a7d7sfPROXY_DECLARE(int) ap_proxy_acquire_connection(const char *proxy_function,
a44d29a3794110c558c940bd903a1930d717a7d7sf * Release a connection back to worker connection pool
a44d29a3794110c558c940bd903a1930d717a7d7sf * @param proxy_function calling proxy scheme (http, ajp, ...)
a44d29a3794110c558c940bd903a1930d717a7d7sf * @param conn acquired connection
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param s current server record
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @return OK or HTTP_XXX error
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @note The connection will be closed if conn->close_on_release is set
61fd0cab072a05b855cbef9c585702401ac5ae29rbbPROXY_DECLARE(int) ap_proxy_release_connection(const char *proxy_function,
742318b93e89c311f66b55f426c4d9cf2c14628bjim * Make a connection to the backend
742318b93e89c311f66b55f426c4d9cf2c14628bjim * @param proxy_function calling proxy scheme (http, ajp, ...)
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param conn acquired connection
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @param worker connection worker
3d96ee83babeec32482c9082c9426340cee8c44dwrowe * @param s current server record
2d2eda71267231c2526be701fe655db125852c1ffielding * @return OK or HTTP_XXX error
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * @note In case the socket already exists for conn, just check the link
9d129b55f5a43abf43865c6b0eb6dd19bc22aba8ianhPROXY_DECLARE(int) ap_proxy_connect_backend(const char *proxy_function,
61fd0cab072a05b855cbef9c585702401ac5ae29rbb * Make a connection record for backend connection
3d96ee83babeec32482c9082c9426340cee8c44dwrowe * @param proxy_function calling proxy scheme (http, ajp, ...)
2d2eda71267231c2526be701fe655db125852c1ffielding * @param conn acquired connection
fd8b91502bc200ed4cca3810560a2a570522b3debrianp * @param c client connection record
fd8b91502bc200ed4cca3810560a2a570522b3debrianp * @param s current server record
fd8b91502bc200ed4cca3810560a2a570522b3debrianp * @return OK or HTTP_XXX error
fd8b91502bc200ed4cca3810560a2a570522b3debrianpPROXY_DECLARE(int) ap_proxy_connection_create(const char *proxy_function,
fd8b91502bc200ed4cca3810560a2a570522b3debrianp/* Scoreboard */
742318b93e89c311f66b55f426c4d9cf2c14628bjim/* The number of dynamic workers that can be added when reconfiguring.
4111de96e9f75c58e77c2bdda23be83b8ebf81ccgregames * If this limit is reached you must stop and restart the server.
4111de96e9f75c58e77c2bdda23be83b8ebf81ccgregames * Calculate number of maximum number of workers in scoreboard.
742318b93e89c311f66b55f426c4d9cf2c14628bjim * @return number of workers to allocate in the scoreboard
fd8b91502bc200ed4cca3810560a2a570522b3debrianp/* For proxy_util */
45613d36b9466a48def0498cffa07f48980720f8jerenkrantz#endif /*MOD_PROXY_H*/