Apache2
 All Data Structures Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
mod_proxy.h
Go to the documentation of this file.
1 /* Licensed to the Apache Software Foundation (ASF) under one or more
2  * contributor license agreements. See the NOTICE file distributed with
3  * this work for additional information regarding copyright ownership.
4  * The ASF licenses this file to You under the Apache License, Version 2.0
5  * (the "License"); you may not use this file except in compliance with
6  * the License. You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #ifndef MOD_PROXY_H
18 #define MOD_PROXY_H
19 
29 #include "apr_hooks.h"
30 #include "apr_optional.h"
31 #include "apr.h"
32 #include "apr_lib.h"
33 #include "apr_strings.h"
34 #include "apr_buckets.h"
35 #include "apr_md5.h"
36 #include "apr_network_io.h"
37 #include "apr_pools.h"
38 #include "apr_strings.h"
39 #include "apr_uri.h"
40 #include "apr_date.h"
41 #include "apr_strmatch.h"
42 #include "apr_fnmatch.h"
43 #include "apr_reslist.h"
44 #define APR_WANT_STRFUNC
45 #include "apr_want.h"
46 #include "apr_uuid.h"
47 #include "util_mutex.h"
48 #include "apr_global_mutex.h"
49 #include "apr_thread_mutex.h"
50 
51 #include "httpd.h"
52 #include "http_config.h"
53 #include "ap_config.h"
54 #include "http_core.h"
55 #include "http_protocol.h"
56 #include "http_request.h"
57 #include "http_vhost.h"
58 #include "http_main.h"
59 #include "http_log.h"
60 #include "http_connection.h"
61 #include "util_filter.h"
62 #include "util_ebcdic.h"
63 #include "ap_provider.h"
64 #include "ap_slotmem.h"
65 
66 #if APR_HAVE_NETINET_IN_H
67 #include <netinet/in.h>
68 #endif
69 #if APR_HAVE_ARPA_INET_H
70 #include <arpa/inet.h>
71 #endif
72 
73 /* for proxy_canonenc() */
74 enum enctype {
76 };
77 
78 typedef enum {
80 } hcmethod_t;
81 
82 typedef struct {
84  char *name;
87 
88 typedef struct {
89  unsigned int bit;
90  char flag;
91  const char *name;
93 
94 #define BALANCER_PREFIX "balancer://"
95 
96 #if APR_CHARSET_EBCDIC
97 #define CRLF "\r\n"
98 #else /*APR_CHARSET_EBCDIC*/
99 #define CRLF "\015\012"
100 #endif /*APR_CHARSET_EBCDIC*/
101 
102 /* default Max-Forwards header setting */
103 /* Set this to -1, which complies with RFC2616 by not setting
104  * max-forwards if the client didn't send it to us.
105  */
106 #define DEFAULT_MAX_FORWARDS -1
107 
109 typedef struct proxy_worker proxy_worker;
112 
113 /* static information about a remote proxy */
114 struct proxy_remote {
115  const char *scheme; /* the schemes handled by this proxy, or '*' */
116  const char *protocol; /* the scheme used to talk to this proxy */
117  const char *hostname; /* the hostname of this proxy */
118  ap_regex_t *regexp; /* compiled regex (if any) for the remote */
119  int use_regex; /* simple boolean. True if we have a regex pattern */
120  apr_port_t port; /* the port for this proxy */
121 };
122 
123 #define PROXYPASS_NOCANON 0x01
124 #define PROXYPASS_INTERPOLATE 0x02
125 #define PROXYPASS_NOQUERY 0x04
126 struct proxy_alias {
127  const char *real;
128  const char *fake;
130  unsigned int flags;
131  proxy_balancer *balancer; /* only valid for reverse-proxys */
132 };
133 
135  char *name;
136  struct in_addr addr, mask;
138  int (*matcher) (struct dirconn_entry * This, request_rec *r);
139 };
140 
142  const char *name;
144 };
145 
146 typedef struct {
152  apr_array_header_t *workers; /* non-balancer workers, eg ProxyPass http://example.com */
153  apr_array_header_t *balancers; /* list of balancers @ config time */
154  proxy_worker *forward; /* forward proxy worker */
155  proxy_worker *reverse; /* reverse "module-driven" proxy worker */
156  const char *domain; /* domain name to use in absence of a domain name in the request */
157  const char *id;
158  apr_pool_t *pool; /* Pool used for allocating this struct's elements */
159  int req; /* true if proxy requests are enabled */
160  int max_balancers; /* maximum number of allowed balancers */
161  int bgrowth; /* number of post-config balancers can added */
162  enum {
166  via_full
167  } viaopt; /* how to deal with proxy Via: headers */
170  long maxfwd;
172  enum {
175  bad_body
176  } badopt; /* how to deal with bad headers */
177  enum {
180  status_full
181  } proxy_status; /* Status display options */
183  apr_global_mutex_t *mutex; /* global lock - not used */
184  ap_slotmem_instance_t *bslot; /* balancers shm data - runtime */
186 
187  unsigned int req_set:1;
188  unsigned int viaopt_set:1;
189  unsigned int recv_buffer_size_set:1;
190  unsigned int io_buffer_size_set:1;
191  unsigned int maxfwd_set:1;
192  unsigned int timeout_set:1;
193  unsigned int badopt_set:1;
194  unsigned int proxy_status_set:1;
195  unsigned int source_address_set:1;
196  unsigned int bgrowth_set:1;
197  unsigned int bal_persist:1;
198  unsigned int inherit:1;
199  unsigned int inherit_set:1;
200  unsigned int ppinherit:1;
201  unsigned int ppinherit_set:1;
203 
204 typedef struct {
205  const char *p; /* The path */
206  ap_regex_t *r; /* Is this a regex? */
207 
208 /* FIXME
209  * ProxyPassReverse and friends are documented as working inside
210  * <Location>. But in fact they never have done in the case of
211  * more than one <Location>, because the server_conf can't see it.
212  * We need to move them to the per-dir config.
213  * Discussed in February 2005:
214  * http://marc.theaimsgroup.com/?l=apache-httpd-dev&m=110726027118798&w=2
215  */
219  signed char p_is_fnmatch; /* Is the path an fnmatch candidate? */
220  signed char interpolate_env;
222 
231  unsigned int error_override:1;
232  unsigned int preserve_host:1;
233  unsigned int preserve_host_set:1;
234  unsigned int error_override_set:1;
235  unsigned int alias_set:1;
236  unsigned int add_forwarded_headers:1;
237  unsigned int add_forwarded_headers_set:1;
238 
241 
242  unsigned int forward_100_continue:1;
243  unsigned int forward_100_continue_set:1;
244 
247 
248 /* if we interpolate env vars per-request, we'll need a per-request
249  * copy of the reverse proxy config
250  */
251 typedef struct {
256 
257 typedef struct {
259  request_rec *r; /* Request record of the backend request
260  * that is used over the backend connection. */
261  proxy_worker *worker; /* Connection pool this connection belongs to */
262  apr_pool_t *pool; /* Subpool for hostname and addr data */
263  const char *hostname;
264  apr_sockaddr_t *addr; /* Preparsed remote address info */
265  apr_pool_t *scpool; /* Subpool used for socket and connection data */
266  apr_socket_t *sock; /* Connection socket */
267  void *data; /* per scheme connection data */
268  void *forward; /* opaque forward proxy data */
269  apr_uint32_t flags; /* Connection flags */
271  unsigned int is_ssl:1;
272  unsigned int close:1; /* Close 'this' connection */
273  unsigned int need_flush:1; /* Flag to decide whether we need to flush the
274  * filter chain or not */
275  unsigned int inreslist:1; /* connection in apr_reslist? */
276  const char *uds_path; /* Unix domain socket path */
277  const char *ssl_hostname;/* Hostname (SNI) in use by SSL connection */
278  apr_bucket_brigade *tmp_bb;/* Temporary brigade created with the connection
279  * and its scpool/bucket_alloc (NULL before),
280  * must be left cleaned when used (locally).
281  */
283 
284 typedef struct {
285  float cache_completion; /* completion percentage */
286  int content_length; /* length of the content */
288 
289 /* Connection pool */
291  apr_pool_t *pool; /* The pool used in constructor and destructor calls */
292  apr_sockaddr_t *addr; /* Preparsed remote address info */
293  apr_reslist_t *res; /* Connection resource list */
294  proxy_conn_rec *conn; /* Single connection for prefork mpm */
295  apr_pool_t *dns_pool; /* The pool used for worker scoped DNS resolutions */
296 };
297 
298 #define AP_VOLATILIZE_T(T, x) (*(T volatile *)&(x))
299 
300 /* worker status bits */
301 /*
302  * NOTE: Keep up-to-date w/ proxy_wstat_tbl[]
303  * in mod_proxy.c !
304  */
305 #define PROXY_WORKER_INITIALIZED 0x0001
306 #define PROXY_WORKER_IGNORE_ERRORS 0x0002
307 #define PROXY_WORKER_DRAIN 0x0004
308 #define PROXY_WORKER_GENERIC 0x0008
309 #define PROXY_WORKER_IN_SHUTDOWN 0x0010
310 #define PROXY_WORKER_DISABLED 0x0020
311 #define PROXY_WORKER_STOPPED 0x0040
312 #define PROXY_WORKER_IN_ERROR 0x0080
313 #define PROXY_WORKER_HOT_STANDBY 0x0100
314 #define PROXY_WORKER_FREE 0x0200
315 #define PROXY_WORKER_HC_FAIL 0x0400
316 #define PROXY_WORKER_HOT_SPARE 0x0800
317 
318 /* worker status flags */
319 #define PROXY_WORKER_INITIALIZED_FLAG 'O'
320 #define PROXY_WORKER_IGNORE_ERRORS_FLAG 'I'
321 #define PROXY_WORKER_DRAIN_FLAG 'N'
322 #define PROXY_WORKER_GENERIC_FLAG 'G'
323 #define PROXY_WORKER_IN_SHUTDOWN_FLAG 'U'
324 #define PROXY_WORKER_DISABLED_FLAG 'D'
325 #define PROXY_WORKER_STOPPED_FLAG 'S'
326 #define PROXY_WORKER_IN_ERROR_FLAG 'E'
327 #define PROXY_WORKER_HOT_STANDBY_FLAG 'H'
328 #define PROXY_WORKER_FREE_FLAG 'F'
329 #define PROXY_WORKER_HC_FAIL_FLAG 'C'
330 #define PROXY_WORKER_HOT_SPARE_FLAG 'R'
331 
332 #define PROXY_WORKER_NOT_USABLE_BITMAP ( PROXY_WORKER_IN_SHUTDOWN | \
333 PROXY_WORKER_DISABLED | PROXY_WORKER_STOPPED | PROXY_WORKER_IN_ERROR | \
334 PROXY_WORKER_HC_FAIL )
335 
336 /* NOTE: these check the shared status */
337 #define PROXY_WORKER_IS_INITIALIZED(f) ( (f)->s->status & PROXY_WORKER_INITIALIZED )
338 
339 #define PROXY_WORKER_IS_STANDBY(f) ( (f)->s->status & PROXY_WORKER_HOT_STANDBY )
340 
341 #define PROXY_WORKER_IS_SPARE(f) ( (f)->s->status & PROXY_WORKER_HOT_SPARE )
342 
343 #define PROXY_WORKER_IS_USABLE(f) ( ( !( (f)->s->status & PROXY_WORKER_NOT_USABLE_BITMAP) ) && \
344  PROXY_WORKER_IS_INITIALIZED(f) )
345 
346 #define PROXY_WORKER_IS_DRAINING(f) ( (f)->s->status & PROXY_WORKER_DRAIN )
347 
348 #define PROXY_WORKER_IS_GENERIC(f) ( (f)->s->status & PROXY_WORKER_GENERIC )
349 
350 #define PROXY_WORKER_IS_HCFAILED(f) ( (f)->s->status & PROXY_WORKER_HC_FAIL )
351 
352 #define PROXY_WORKER_IS(f, b) ( (f)->s->status & (b) )
353 
354 /* default worker retry timeout in seconds */
355 #define PROXY_WORKER_DEFAULT_RETRY 60
356 
357 /* Some max char string sizes, for shm fields */
358 #define PROXY_WORKER_MAX_SCHEME_SIZE 16
359 #define PROXY_WORKER_MAX_ROUTE_SIZE 96
360 #define PROXY_BALANCER_MAX_ROUTE_SIZE 64
361 #define PROXY_WORKER_MAX_NAME_SIZE 256
362 #define PROXY_BALANCER_MAX_NAME_SIZE 64
363 #define PROXY_WORKER_MAX_HOSTNAME_SIZE 96
364 #define PROXY_BALANCER_MAX_HOSTNAME_SIZE 64
365 #define PROXY_BALANCER_MAX_STICKY_SIZE 64
366 #define PROXY_WORKER_MAX_SECRET_SIZE 64
367 
368 #define PROXY_RFC1035_HOSTNAME_SIZE 256
369 
370 /* RFC-1035 mentions limits of 255 for host-names and 253 for domain-names,
371  * dotted together(?) this would fit the below size (+ trailing NUL).
372  */
373 #define PROXY_WORKER_RFC1035_NAME_SIZE 512
374 
375 #define PROXY_MAX_PROVIDER_NAME_SIZE 16
376 
377 #define PROXY_STRNCPY(dst, src) ap_proxy_strncpy((dst), (src), (sizeof(dst)))
378 
379 #define PROXY_COPY_CONF_PARAMS(w, c) \
380 do { \
381 (w)->s->timeout = (c)->timeout; \
382 (w)->s->timeout_set = (c)->timeout_set; \
383 (w)->s->recv_buffer_size = (c)->recv_buffer_size; \
384 (w)->s->recv_buffer_size_set = (c)->recv_buffer_size_set; \
385 (w)->s->io_buffer_size = (c)->io_buffer_size; \
386 (w)->s->io_buffer_size_set = (c)->io_buffer_size_set; \
387 } while (0)
388 
389 #define PROXY_DO_100_CONTINUE(w, r) \
390 ((w)->s->ping_timeout_set \
391  && (PROXYREQ_REVERSE == (r)->proxyreq) \
392  && !(apr_table_get((r)->subprocess_env, "force-proxy-request-1.0")) \
393  && ap_request_has_body((r)))
394 
395 /* use 2 hashes */
396 typedef struct {
397  unsigned int def;
398  unsigned int fnv;
399 } proxy_hashes ;
400 
401 /* Runtime worker status information. Shared in scoreboard */
402 typedef struct {
404  char scheme[PROXY_WORKER_MAX_SCHEME_SIZE]; /* scheme to use ajp|http|https */
405  char hostname[PROXY_WORKER_MAX_HOSTNAME_SIZE]; /* remote backend address (deprecated, use hostname_ex below) */
406  char route[PROXY_WORKER_MAX_ROUTE_SIZE]; /* balancing route */
407  char redirect[PROXY_WORKER_MAX_ROUTE_SIZE]; /* temporary balancing redirection route */
408  char flusher[PROXY_WORKER_MAX_SCHEME_SIZE]; /* flush provider used by mod_proxy_fdpass */
409  char uds_path[PROXY_WORKER_MAX_NAME_SIZE]; /* path to worker's unix domain socket if applicable */
410  char hcuri[PROXY_WORKER_MAX_ROUTE_SIZE]; /* health check uri */
411  char hcexpr[PROXY_WORKER_MAX_SCHEME_SIZE]; /* name of condition expr for health check */
412  char secret[PROXY_WORKER_MAX_SECRET_SIZE]; /* authentication secret (e.g. AJP13) */
413  char upgrade[PROXY_WORKER_MAX_SCHEME_SIZE];/* upgrade protocol used by mod_proxy_wstunnel */
414  char hostname_ex[PROXY_RFC1035_HOSTNAME_SIZE]; /* RFC1035 compliant version of the remote backend address */
415  int lbset; /* load balancer cluster set */
416  int retries; /* number of retries on this worker */
417  int lbstatus; /* Current lbstatus */
418  int lbfactor; /* dynamic lbfactor */
419  int min; /* Desired minimum number of available connections */
420  int smax; /* Soft maximum on the total number of connections */
421  int hmax; /* Hard maximum on the total number of connections */
422  int flush_wait; /* poll wait time in microseconds if flush_auto */
423  int index; /* shm array index */
424  int passes; /* number of successes for check to pass */
425  int pcount; /* current count of passes */
426  int fails; /* number of failures for check to fail */
427  int fcount; /* current count of failures */
428  proxy_hashes hash; /* hash of worker name */
429  unsigned int status; /* worker status bitfield */
430  enum {
433  flush_auto
434  } flush_packets; /* control AJP flushing */
435  hcmethod_t method; /* method to use for health check */
436  apr_time_t updated; /* timestamp of last update for dynamic workers, or queue-time of HC workers */
437  apr_time_t error_time; /* time of the last error */
438  apr_interval_time_t ttl; /* maximum amount of time in seconds a connection
439  * may be available while exceeding the soft limit */
440  apr_interval_time_t retry; /* retry interval */
441  apr_interval_time_t timeout; /* connection timeout */
442  apr_interval_time_t acquire; /* acquire timeout when the maximum number of connections is exceeded */
448  apr_size_t elected; /* Number of times the worker was elected */
449  apr_size_t busy; /* busyness factor */
450  apr_size_t response_field_size; /* Size of proxy response buffer in bytes. */
452  apr_off_t transferred;/* Number of bytes transferred to remote */
453  apr_off_t read; /* Number of bytes read from remote */
454  void *context; /* general purpose storage */
455  unsigned int keepalive:1;
456  unsigned int disablereuse:1;
457  unsigned int is_address_reusable:1;
458  unsigned int retry_set:1;
459  unsigned int timeout_set:1;
460  unsigned int acquire_set:1;
461  unsigned int ping_timeout_set:1;
462  unsigned int conn_timeout_set:1;
463  unsigned int recv_buffer_size_set:1;
464  unsigned int io_buffer_size_set:1;
465  unsigned int keepalive_set:1;
466  unsigned int disablereuse_set:1;
467  unsigned int was_malloced:1;
468  unsigned int is_name_matchable:1;
469  unsigned int response_field_size_set:1;
471 
472 #define ALIGNED_PROXY_WORKER_SHARED_SIZE (APR_ALIGN_DEFAULT(sizeof(proxy_worker_shared)))
473 
474 /* Worker configuration */
475 struct proxy_worker {
476  proxy_hashes hash; /* hash of worker name */
477  unsigned int local_status; /* status of per-process worker */
478  proxy_conn_pool *cp; /* Connection pool to use */
479  proxy_worker_shared *s; /* Shared data */
480  proxy_balancer *balancer; /* which balancer am I in? */
481 #if APR_HAS_THREADS
482  apr_thread_mutex_t *tmutex; /* Thread lock for updating address cache */
483 #endif
484  void *context; /* general purpose storage */
485  ap_conf_vector_t *section_config; /* <Proxy>-section wherein defined */
486 };
487 
488 /* default to health check every 30 seconds */
489 #define HCHECK_WATHCHDOG_DEFAULT_INTERVAL (30)
490 
491 /*
492  * Time to wait (in microseconds) to find out if more data is currently
493  * available at the backend.
494  */
495 #define PROXY_FLUSH_WAIT 10000
496 
497 typedef struct {
498  char sticky_path[PROXY_BALANCER_MAX_STICKY_SIZE]; /* URL sticky session identifier */
499  char sticky[PROXY_BALANCER_MAX_STICKY_SIZE]; /* sticky session identifier */
500  char lbpname[PROXY_MAX_PROVIDER_NAME_SIZE]; /* lbmethod provider name */
501  char nonce[APR_UUID_FORMATTED_LENGTH + 1];
506  apr_interval_time_t timeout; /* Timeout for waiting on free connection */
507  apr_time_t wupdated; /* timestamp of last change to workers list */
508  int max_attempts; /* Number of attempts before failing */
509  int index; /* shm array index */
511  unsigned int sticky_force:1; /* Disable failover for sticky sessions */
512  unsigned int scolonsep:1; /* true if ';' seps sticky session paths */
513  unsigned int max_attempts_set:1;
514  unsigned int was_malloced:1;
515  unsigned int need_reset:1;
516  unsigned int vhosted:1;
517  unsigned int inactive:1;
518  unsigned int forcerecovery:1;
519  char sticky_separator; /* separator for sessionid/route */
520  unsigned int forcerecovery_set:1;
521  unsigned int scolonsep_set:1;
522  unsigned int sticky_force_set:1;
523  unsigned int nonce_set:1;
524  unsigned int sticky_separator_set:1;
526 
527 #define ALIGNED_PROXY_BALANCER_SHARED_SIZE (APR_ALIGN_DEFAULT(sizeof(proxy_balancer_shared)))
528 
530  apr_array_header_t *workers; /* initially configured workers */
531  apr_array_header_t *errstatuses; /* statuses to force members into error */
532  ap_slotmem_instance_t *wslot; /* worker shm data - runtime */
534  int growth; /* number of post-config workers can added */
535  int max_workers; /* maximum number of allowed workers */
537  apr_time_t wupdated; /* timestamp of last change to workers list */
539  apr_global_mutex_t *gmutex; /* global lock for updating list of workers */
540 #if APR_HAS_THREADS
541  apr_thread_mutex_t *tmutex; /* Thread lock for updating shm */
542 #endif
544  void *context; /* general purpose storage */
545  proxy_balancer_shared *s; /* Shared data */
546  int failontimeout; /* Whether to mark a member in Err if IO timeout occurs */
547  unsigned int failontimeout_set:1;
548  unsigned int growth_set:1;
549  unsigned int lbmethod_set:1;
550  ap_conf_vector_t *section_config; /* <Proxy>-section wherein defined */
551 };
552 
554  const char *name; /* name of the load balancer method*/
555  proxy_worker *(*finder)(proxy_balancer *balancer,
556  request_rec *r);
557  void *context; /* general purpose storage */
561 };
562 
563 #if APR_HAS_THREADS
564 #define PROXY_THREAD_LOCK(x) ( (x) && (x)->tmutex ? apr_thread_mutex_lock((x)->tmutex) : APR_SUCCESS)
565 #define PROXY_THREAD_UNLOCK(x) ( (x) && (x)->tmutex ? apr_thread_mutex_unlock((x)->tmutex) : APR_SUCCESS)
566 #else
567 #define PROXY_THREAD_LOCK(x) (APR_SUCCESS)
568 #define PROXY_THREAD_UNLOCK(x) (APR_SUCCESS)
569 #endif
570 
571 #define PROXY_GLOBAL_LOCK(x) ( (x) && (x)->gmutex ? apr_global_mutex_lock((x)->gmutex) : APR_SUCCESS)
572 #define PROXY_GLOBAL_UNLOCK(x) ( (x) && (x)->gmutex ? apr_global_mutex_unlock((x)->gmutex) : APR_SUCCESS)
573 
574 /* hooks */
575 
576 /* Create a set of PROXY_DECLARE(type), PROXY_DECLARE_NONSTD(type) and
577  * PROXY_DECLARE_DATA with appropriate export and import tags for the platform
578  */
579 #if !defined(WIN32)
580 #define PROXY_DECLARE(type) type
581 #define PROXY_DECLARE_NONSTD(type) type
582 #define PROXY_DECLARE_DATA
583 #elif defined(PROXY_DECLARE_STATIC)
584 #define PROXY_DECLARE(type) type __stdcall
585 #define PROXY_DECLARE_NONSTD(type) type
586 #define PROXY_DECLARE_DATA
587 #elif defined(PROXY_DECLARE_EXPORT)
588 #define PROXY_DECLARE(type) __declspec(dllexport) type __stdcall
589 #define PROXY_DECLARE_NONSTD(type) __declspec(dllexport) type
590 #define PROXY_DECLARE_DATA __declspec(dllexport)
591 #else
592 #define PROXY_DECLARE(type) __declspec(dllimport) type __stdcall
593 #define PROXY_DECLARE_NONSTD(type) __declspec(dllimport) type
594 #define PROXY_DECLARE_DATA __declspec(dllimport)
595 #endif
596 
597 /* Using PROXY_DECLARE_OPTIONAL_HOOK instead of
598  * APR_DECLARE_EXTERNAL_HOOK allows build/make_nw_export.awk
599  * to distinguish between hooks that implement
600  * proxy_hook_xx and proxy_hook_get_xx in mod_proxy.c and
601  * those which don't.
602  */
603 #define PROXY_DECLARE_OPTIONAL_HOOK APR_DECLARE_EXTERNAL_HOOK
604 
605 
606 /* These 2 are in mod_proxy.c */
609 
610 /* Following 4 from health check */
612 APR_DECLARE_OPTIONAL_FN(void, hc_select_exprs, (request_rec *, const char *));
613 APR_DECLARE_OPTIONAL_FN(int, hc_valid_expr, (request_rec *, const char *));
616  const char *, const char *, void *));
617 
618 PROXY_DECLARE_OPTIONAL_HOOK(proxy, PROXY, int, section_post_config,
619  (apr_pool_t *p, apr_pool_t *plog,
620  apr_pool_t *ptemp, server_rec *s,
621  ap_conf_vector_t *section_config))
622 
623 APR_DECLARE_EXTERNAL_HOOK(proxy, PROXY, int, scheme_handler,
625  proxy_server_conf *conf, char *url,
627 APR_DECLARE_EXTERNAL_HOOK(proxy, PROXY, int, check_trans,
628  (request_rec *r, const char *url))
629 APR_DECLARE_EXTERNAL_HOOK(proxy, PROXY, int, canon_handler,
630  (request_rec *r, char *url))
631 
632 PROXY_DECLARE_OPTIONAL_HOOK(proxy, PROXY, int, create_req,
633  (request_rec *r, request_rec *pr))
635 
636 
637 
644  (request_rec *r, proxy_conn_rec *backend))
645 
654 APR_DECLARE_EXTERNAL_HOOK(proxy, PROXY, int, pre_request,
655  (proxy_worker **worker, proxy_balancer **balancer,
656  request_rec *r, proxy_server_conf *conf, char **url))
661 APR_DECLARE_EXTERNAL_HOOK(proxy, PROXY, int, post_request,
662  (proxy_worker *worker, proxy_balancer *balancer,
663  request_rec *r, proxy_server_conf *conf))
664 
670 PROXY_DECLARE_OPTIONAL_HOOK(proxy, PROXY, int, request_status,
671  (int *status, request_rec *r))
672 
673 /* proxy_util.c */
674 
675 PROXY_DECLARE(apr_status_t) ap_proxy_strncpy(char *dst, const char *src,
676  apr_size_t dlen);
677 PROXY_DECLARE(int) ap_proxy_hex2c(const char *x);
678 PROXY_DECLARE(void) ap_proxy_c2hex(int ch, char *x);
679 PROXY_DECLARE(char *)ap_proxy_canonenc(apr_pool_t *p, const char *x, int len, enum enctype t,
680  int forcedec, int proxyreq);
681 PROXY_DECLARE(char *)ap_proxy_canon_netloc(apr_pool_t *p, char **const urlp, char **userp,
682  char **passwordp, char **hostp, apr_port_t *port);
683 PROXY_DECLARE(int) ap_proxyerror(request_rec *r, int statuscode, const char *message);
684 
694  const char *hostname, apr_sockaddr_t *addr);
695 
696 
698 /* DEPRECATED (will be replaced with ap_proxy_connect_backend */
700 /* DEPRECATED (will be replaced with ap_proxy_check_connection */
702  request_rec *r);
706  ap_conf_vector_t *per_dir_config,
707  int enable);
709 PROXY_DECLARE(const char *) ap_proxy_ssl_val(apr_pool_t *p, server_rec *s, conn_rec *c, request_rec *r, const char *var);
710 
711 /* Header mapping functions, and a typedef of their signature */
712 PROXY_DECLARE(const char *) ap_proxy_location_reverse_map(request_rec *r, proxy_dir_conf *conf, const char *url);
713 PROXY_DECLARE(const char *) ap_proxy_cookie_reverse_map(request_rec *r, proxy_dir_conf *conf, const char *str);
714 
715 #if !defined(WIN32)
716 typedef const char *(*ap_proxy_header_reverse_map_fn)(request_rec *,
717  proxy_dir_conf *, const char *);
718 #elif defined(PROXY_DECLARE_STATIC)
719 typedef const char *(__stdcall *ap_proxy_header_reverse_map_fn)(request_rec *,
720  proxy_dir_conf *, const char *);
721 #elif defined(PROXY_DECLARE_EXPORT)
722 typedef __declspec(dllexport) const char *
723  (__stdcall *ap_proxy_header_reverse_map_fn)(request_rec *,
724  proxy_dir_conf *, const char *);
725 #else
726 typedef __declspec(dllimport) const char *
727  (__stdcall *ap_proxy_header_reverse_map_fn)(request_rec *,
728  proxy_dir_conf *, const char *);
729 #endif
730 
731 
732 /* Connection pool API */
741  proxy_worker *worker);
742 
751  const proxy_worker *worker,
752  const char *upgrade);
753 
763  proxy_balancer *balancer,
764  proxy_server_conf *conf,
765  const char *url);
777  proxy_worker **worker,
778  proxy_balancer *balancer,
779  proxy_server_conf *conf,
780  const char *url,
781  int do_malloc);
782 
795  proxy_worker **worker,
796  proxy_balancer *balancer,
797  proxy_server_conf *conf,
798  const char *url,
799  int do_malloc);
800 
809  proxy_worker_shared *shm,
810  int i);
811 
820  server_rec *s,
821  apr_pool_t *p);
822 
830 
831 
841  proxy_server_conf *conf,
842  const char *url,
843  int careactive);
844 
853  proxy_balancer *balancer,
854  const char *url);
855 
867  proxy_balancer **balancer,
868  proxy_server_conf *conf,
869  const char *url,
870  const char *alias,
871  int do_malloc);
872 
882  int i);
883 
892  server_rec *s,
893  apr_pool_t *p);
894 
895 typedef int (proxy_is_best_callback_fn_t)(proxy_worker *current, proxy_worker *prev_best, void *baton);
896 
908  request_rec *r,
910  void *baton);
911 /*
912  * Needed by the lb modules.
913  */
915  (proxy_balancer *balancer,
916  request_rec *r,
918  void *baton));
919 
929  ap_slotmem_instance_t *slot,
930  proxy_worker *worker,
931  unsigned int *index);
932 
942  ap_slotmem_instance_t *slot,
943  proxy_balancer *balancer,
944  unsigned int *index);
945 
957 PROXY_DECLARE(int) ap_proxy_pre_request(proxy_worker **worker,
958  proxy_balancer **balancer,
959  request_rec *r,
960  proxy_server_conf *conf,
961  char **url);
972 PROXY_DECLARE(int) ap_proxy_post_request(proxy_worker *worker,
973  proxy_balancer *balancer,
974  request_rec *r,
975  proxy_server_conf *conf);
976 
994  proxy_server_conf *conf,
995  proxy_worker *worker,
996  proxy_conn_rec *conn,
997  apr_uri_t *uri,
998  char **url,
999  const char *proxyname,
1001  char *server_portstr,
1002  int server_portstr_size);
1003 
1014  (const char *proxy_function, proxy_worker *worker, server_rec *s));
1015 
1027 PROXY_DECLARE(int) ap_proxy_acquire_connection(const char *proxy_function,
1028  proxy_conn_rec **conn,
1029  proxy_worker *worker,
1030  server_rec *s);
1039 PROXY_DECLARE(int) ap_proxy_release_connection(const char *proxy_function,
1040  proxy_conn_rec *conn,
1041  server_rec *s);
1042 
1043 #define PROXY_CHECK_CONN_EMPTY (1 << 0)
1044 
1059  proxy_conn_rec *conn,
1060  server_rec *server,
1061  unsigned max_blank_lines,
1062  int flags);
1063 
1074 PROXY_DECLARE(int) ap_proxy_connect_backend(const char *proxy_function,
1075  proxy_conn_rec *conn,
1076  proxy_worker *worker,
1077  server_rec *s);
1078 
1086 PROXY_DECLARE(apr_status_t) ap_proxy_connect_uds(apr_socket_t *sock,
1087  const char *uds_path,
1088  apr_pool_t *p);
1099 PROXY_DECLARE(int) ap_proxy_connection_create(const char *proxy_function,
1100  proxy_conn_rec *conn,
1101  conn_rec *c, server_rec *s);
1102 
1112 PROXY_DECLARE(int) ap_proxy_connection_create_ex(const char *proxy_function,
1113  proxy_conn_rec *conn,
1114  request_rec *r);
1124 
1133 PROXY_DECLARE(void) ap_proxy_backend_broke(request_rec *r,
1134  apr_bucket_brigade *brigade);
1135 
1144 
1145 PROXY_DECLARE(unsigned int) ap_proxy_hashfunc(const char *str, proxy_hash_t method);
1146 
1147 
1155 PROXY_DECLARE(apr_status_t) ap_proxy_set_wstatus(char c, int set, proxy_worker *w);
1156 
1157 
1164 PROXY_DECLARE(char *) ap_proxy_parse_wstatus(apr_pool_t *p, proxy_worker *w);
1165 
1166 
1175  server_rec *s,
1176  proxy_server_conf *conf);
1177 
1178 
1186 PROXY_DECLARE(int) ap_proxy_trans_match(request_rec *r,
1187  struct proxy_alias *ent,
1188  proxy_dir_conf *dconf);
1189 
1206  apr_bucket_brigade *header_brigade,
1207  request_rec *r,
1208  proxy_conn_rec *p_conn,
1209  proxy_worker *worker,
1210  proxy_server_conf *conf,
1211  apr_uri_t *uri,
1212  char *url, char *server_portstr,
1213  char **old_cl_val,
1214  char **old_te_val);
1215 
1226  request_rec *r, proxy_conn_rec *p_conn,
1227  conn_rec *origin, apr_bucket_brigade *bb,
1228  int flush);
1229 
1230 struct proxy_tunnel_conn; /* opaque */
1231 typedef struct {
1232  request_rec *r;
1233  const char *scheme;
1237  struct proxy_tunnel_conn *client,
1238  *origin;
1239  int replied;
1241 
1251  request_rec *r, conn_rec *c_o,
1252  const char *scheme);
1253 
1262 
1271  (request_rec *r, apr_table_t *headers));
1272 
1273 
1279 
1280 #define PROXY_LBMETHOD "proxylbmethod"
1281 
1282 /* The number of dynamic workers that can be added when reconfiguring.
1283  * If this limit is reached you must stop and restart the server.
1284  */
1285 #define PROXY_DYNAMIC_BALANCER_LIMIT 16
1286 
1291 int ap_proxy_lb_workers(void);
1292 
1300 PROXY_DECLARE(int) ap_proxy_should_override(proxy_dir_conf *conf, int code);
1301 
1307 PROXY_DECLARE(apr_port_t) ap_proxy_port_of_scheme(const char *scheme);
1308 
1314 PROXY_DECLARE (const char *) ap_proxy_show_hcmethod(hcmethod_t method);
1315 
1322 PROXY_DECLARE(const char *) ap_proxy_de_socketfy(apr_pool_t *p, const char *url);
1323 
1324 /*
1325  * Transform buckets from one bucket allocator to another one by creating a
1326  * transient bucket for each data bucket and let it use the data read from
1327  * the old bucket. Metabuckets are transformed by just recreating them.
1328  * Attention: Currently only the following bucket types are handled:
1329  *
1330  * All data buckets
1331  * FLUSH
1332  * EOS
1333  *
1334  * If an other bucket type is found its type is logged as a debug message
1335  * and APR_EGENERAL is returned.
1336  *
1337  * @param r request_rec of the actual request. Used for logging purposes
1338  * @param from the bucket brigade to take the buckets from
1339  * @param to the bucket brigade to store the transformed buckets
1340  * @return apr_status_t of the operation. Either APR_SUCCESS or
1341  * APR_EGENERAL
1342  */
1344  apr_bucket_brigade *from,
1345  apr_bucket_brigade *to);
1346 
1347 /*
1348  * The flags for ap_proxy_transfer_between_connections(), where for legacy and
1349  * compatibility reasons FLUSH_EACH and FLUSH_AFTER are boolean values.
1350  */
1351 #define AP_PROXY_TRANSFER_FLUSH_EACH (0x0)
1352 #define AP_PROXY_TRANSFER_FLUSH_AFTER (0x1)
1353 #define AP_PROXY_TRANSFER_SHOULD_YIELD (0x2)
1354 
1355 /*
1356  * Sends all data that can be read non blocking from the input filter chain of
1357  * c_i and send it down the output filter chain of c_o. For reading it uses
1358  * the bucket brigade bb_i which should be created from the bucket allocator
1359  * associated with c_i. For sending through the output filter chain it uses
1360  * the bucket brigade bb_o which should be created from the bucket allocator
1361  * associated with c_o. In order to get the buckets from bb_i to bb_o
1362  * ap_proxy_buckets_lifetime_transform is used.
1363  *
1364  * @param r request_rec of the actual request. Used for logging purposes
1365  * @param c_i inbound connection conn_rec
1366  * @param c_o outbound connection conn_rec
1367  * @param bb_i bucket brigade for pulling data from the inbound connection
1368  * @param bb_o bucket brigade for sending data through the outbound connection
1369  * @param name string for logging from where data was pulled
1370  * @param sent if not NULL will be set to 1 if data was sent through c_o
1371  * @param bsize maximum amount of data pulled in one iteration from c_i
1372  * @param flags AP_PROXY_TRANSFER_* bitmask
1373  * @return apr_status_t of the operation. Could be any error returned from
1374  * either the input filter chain of c_i or the output filter chain
1375  * of c_o, APR_EPIPE if the outgoing connection was aborted, or
1376  * APR_INCOMPLETE if AP_PROXY_TRANSFER_SHOULD_YIELD was set and
1377  * the output stack gets full before the input stack is exhausted.
1378  */
1380  request_rec *r,
1381  conn_rec *c_i,
1382  conn_rec *c_o,
1383  apr_bucket_brigade *bb_i,
1384  apr_bucket_brigade *bb_o,
1385  const char *name,
1386  int *sent,
1387  apr_off_t bsize,
1388  int flags);
1389 
1391 
1392 #endif /*MOD_PROXY_H*/
1393 
#define socket
Definition: apr_arch_os2calls.h:41
int ap_proxy_trans_match(request_rec *r, struct proxy_alias *ent, proxy_dir_conf *dconf)
int ap_proxy_connect_to_backend(apr_socket_t **, const char *, apr_sockaddr_t *, const char *, proxy_server_conf *, request_rec *)
proxy_worker_shared * s
Definition: mod_proxy.h:479
unsigned int fnv
Definition: mod_proxy.h:398
int ap_proxy_tunnel_run(proxy_tunnel_rec *tunnel)
size_t apr_size_t
Definition: apr.h:397
int ap_proxy_retry_worker(const char *proxy_function, proxy_worker *worker, server_rec *s)
apr_pool_t * pool
Definition: mod_proxy.h:262
proxy_balancer * ap_proxy_get_balancer(apr_pool_t *p, proxy_server_conf *conf, const char *url, int careactive)
int min
Definition: mod_proxy.h:419
proxy_worker proxy_server_conf char const char apr_port_t proxyport
Definition: mod_proxy.h:626
Definition: mod_proxy.h:165
unsigned int growth_set
Definition: mod_proxy.h:548
int hmax
Definition: mod_proxy.h:421
apr_sockaddr_t * addr
Definition: mod_proxy.h:264
int ap_proxy_pass_brigade(apr_bucket_alloc_t *bucket_alloc, request_rec *r, proxy_conn_rec *p_conn, conn_rec *origin, apr_bucket_brigade *bb, int flush)
int ap_proxy_ssl_enable(conn_rec *c)
void hc_show_exprs(request_rec *)
APR Network library.
APR UUID library.
apr_size_t recv_buffer_size
Definition: mod_proxy.h:168
struct ap_slotmem_instance_t ap_slotmem_instance_t
Definition: ap_slotmem.h:75
void hc_select_exprs(request_rec *, const char *)
Apache Configuration.
ap_regex_t * regex
Definition: mod_proxy.h:129
int ap_proxy_checkproxyblock(request_rec *r, proxy_server_conf *conf, const char *hostname, apr_sockaddr_t *addr)
ap_regex_t * regexp
Definition: mod_proxy.h:118
Definition: mod_proxy.h:1231
char * ap_proxy_worker_name(apr_pool_t *p, proxy_worker *worker)
Definition: apr_arch_thread_mutex.h:28
apr_port_t ap_proxy_port_of_scheme(const char *scheme)
const char * protocol
Definition: mod_proxy.h:116
Definition: apr_tables.h:62
const char * name
Definition: mod_proxy.h:142
Definition: mod_proxy.h:79
proxy_worker * worker
Definition: mod_proxy.h:261
int lbfactor
Definition: mod_proxy.h:418
Definition: mod_proxy.h:82
char flag
Definition: mod_proxy.h:90
apr_port_t port
Definition: mod_proxy.h:270
struct apr_reslist_t apr_reslist_t
Definition: apr_reslist.h:42
Definition: mod_proxy.h:164
struct proxy_tunnel_conn * origin
Definition: mod_proxy.h:1237
ap_conf_vector_t * section_config
Definition: mod_proxy.h:550
int ap_proxy_connection_create(const char *proxy_function, proxy_conn_rec *conn, conn_rec *c, server_rec *s)
Definition: mod_proxy.h:284
Definition: mod_proxy.h:141
apr_time_t wupdated
Definition: mod_proxy.h:507
float cache_completion
Definition: mod_proxy.h:285
int bgrowth
Definition: mod_proxy.h:161
proxy_balancer_shared * ap_proxy_find_balancershm(ap_slotmem_provider_t *storage, ap_slotmem_instance_t *slot, proxy_balancer *balancer, unsigned int *index)
struct apr_bucket_alloc_t apr_bucket_alloc_t
Definition: apr_buckets.h:123
Definition: mod_proxy.h:432
request_rec * r
Definition: mod_proxy.h:643
proxy_conn_pool * cp
Definition: mod_proxy.h:478
const char * ssl_hostname
Definition: mod_proxy.h:277
const char * name
Definition: mod_proxy.h:554
struct apr_sockaddr_t * hostaddr
Definition: mod_proxy.h:137
Apache Provider API.
apr_interval_time_t interval
Definition: mod_proxy.h:445
const char * uds_path
Definition: mod_proxy.h:276
proxy_hashes hash
Definition: mod_proxy.h:428
Definition: mod_proxy.h:75
proxy_balancer * balancer
Definition: mod_proxy.h:131
ap_slotmem_provider_t * storage
Definition: mod_proxy.h:185
apr_array_header_t * cookie_domains
Definition: mod_proxy.h:254
proxy_server_conf * sconf
Definition: mod_proxy.h:543
int ap_proxy_post_request(proxy_worker *worker, proxy_balancer *balancer, request_rec *r, proxy_server_conf *conf)
int replied
Definition: mod_proxy.h:1239
apr_sockaddr_t * addr
Definition: mod_proxy.h:292
int index
Definition: mod_proxy.h:509
Definition: mod_proxy.h:497
unsigned int ap_proxy_hashfunc(const char *str, proxy_hash_t method)
proxy_worker * reverse
Definition: mod_proxy.h:155
apr_array_header_t * cookie_paths
Definition: mod_proxy.h:253
Definition: mod_proxy.h:163
apr_interval_time_t timeout
Definition: mod_proxy.h:1236
const char * domain
Definition: mod_proxy.h:156
apr_uint32_t flags
Definition: mod_proxy.h:269
Definition: mod_proxy.h:251
const char * scheme
Definition: mod_proxy.h:1233
apr_status_t ap_proxy_initialize_worker(proxy_worker *worker, server_rec *s, apr_pool_t *p)
int ap_proxy_worker_can_upgrade(apr_pool_t *p, const proxy_worker *worker, const char *upgrade)
proxy_hash_t
Definition: mod_proxy.h:1143
int ap_proxy_connect_backend(const char *proxy_function, proxy_conn_rec *conn, proxy_worker *worker, server_rec *s)
Definition: mod_proxy.h:396
proxy_worker * ap_proxy_balancer_get_best_worker(proxy_balancer *balancer, request_rec *r, proxy_is_best_callback_fn_t *is_best, void *baton)
const char * real
Definition: mod_proxy.h:127
APR Standard Headers Support.
apr_status_t ap_proxy_connect_uds(apr_socket_t *sock, const char *uds_path, apr_pool_t *p)
apr_size_t busy
Definition: mod_proxy.h:449
void * context
Definition: mod_proxy.h:454
apr_interval_time_t timeout
Definition: mod_proxy.h:506
apr_size_t io_buffer_size
Definition: mod_proxy.h:447
CORE HTTP Daemon.
int fails
Definition: mod_proxy.h:426
apr_array_header_t * errstatuses
Definition: mod_proxy.h:531
char * name
Definition: mod_proxy.h:135
char * ap_proxy_define_match_worker(apr_pool_t *p, proxy_worker **worker, proxy_balancer *balancer, proxy_server_conf *conf, const char *url, int do_malloc)
int ap_proxy_is_socket_connected(apr_socket_t *socket)
Apache connection library.
int ap_proxy_connection_create_ex(const char *proxy_function, proxy_conn_rec *conn, request_rec *r)
Utilities for EBCDIC conversion.
int ap_proxy_ssl_disable(conn_rec *c)
proxy_balancer_method * lbmethod
Definition: mod_proxy.h:538
PROXY_DECLARE_DATA proxy_hcmethods_t proxy_hcmethods[]
int use_regex
Definition: mod_proxy.h:119
char * ap_proxy_canonenc(apr_pool_t *p, const char *x, int len, enum enctype t, int forcedec, int proxyreq)
const char const char * uri
Definition: mod_dav.h:614
detach_backend
Definition: mod_proxy.h:643
#define PROXY_WORKER_MAX_ROUTE_SIZE
Definition: mod_proxy.h:359
Definition: apr_buckets.h:258
const char apr_size_t dlen
Definition: mod_proxy.h:675
APR Thread Mutex Routines.
void * context
Definition: mod_proxy.h:557
Definition: mod_proxy.h:114
Definition: mod_proxy.h:79
module PROXY_DECLARE_DATA proxy_module
apr_int64_t apr_interval_time_t
Definition: apr_time.h:55
apr_time_t updated
Definition: mod_proxy.h:436
Definition: mod_proxy.h:75
Structure to store things which are per connection.
Definition: httpd.h:1137
int flush_wait
Definition: mod_proxy.h:422
APR-UTIL Resource List Routines.
#define APR_UUID_FORMATTED_LENGTH
Definition: apr_uuid.h:46
int( proxy_is_best_callback_fn_t)(proxy_worker *current, proxy_worker *prev_best, void *baton)
Definition: mod_proxy.h:895
apr_status_t(* updatelbstatus)(proxy_balancer *balancer, proxy_worker *elected, server_rec *s)
Definition: mod_proxy.h:560
Virtual Host package.
APR-UTIL registration of functions exported by modules.
int fixups(request_rec *r)
apr_size_t response_field_size
Definition: mod_proxy.h:450
Symbol export macros and hook functions.
#define PROXY_MAX_PROVIDER_NAME_SIZE
Definition: mod_proxy.h:375
apr_status_t(* reset)(proxy_balancer *balancer, server_rec *s)
Definition: mod_proxy.h:558
#define PROXY_DECLARE_OPTIONAL_HOOK
Definition: mod_proxy.h:603
char * ap_proxy_parse_wstatus(apr_pool_t *p, proxy_worker *w)
apr_array_header_t * cookie_domains
Definition: mod_proxy.h:218
apr_interval_time_t timeout
Definition: mod_proxy.h:171
const char * set_worker_hc_param(apr_pool_t *, server_rec *, proxy_worker *, const char *, const char *, void *)
Definition: mod_proxy.h:146
apr_array_header_t * aliases
Definition: mod_proxy.h:149
#define PROXY_DECLARE_DATA
Definition: mod_proxy.h:582
apr_pool_t * pool
Definition: mod_proxy.h:158
Definition: mod_proxy.h:75
Definition: apr_arch_global_mutex.h:23
signed char interpolate_env
Definition: mod_proxy.h:220
int ap_proxy_conn_is_https(conn_rec *c)
apr_time_t wupdated
Definition: mod_proxy.h:537
const char *(* ap_proxy_header_reverse_map_fn)(request_rec *, proxy_dir_conf *, const char *)
Definition: mod_proxy.h:716
int req
Definition: mod_proxy.h:159
Apache Logging library.
apr_array_header_t * sec_proxy
Definition: mod_proxy.h:148
unsigned int local_status
Definition: mod_proxy.h:477
char * ap_proxy_define_balancer(apr_pool_t *p, proxy_balancer **balancer, proxy_server_conf *conf, const char *url, const char *alias, int do_malloc)
const char * hostname
Definition: mod_proxy.h:117
unsigned int status
Definition: mod_proxy.h:429
apr_int64_t apr_time_t
Definition: apr_time.h:45
void * forward
Definition: mod_proxy.h:268
#define PROXY_RFC1035_HOSTNAME_SIZE
Definition: mod_proxy.h:368
Command line options.
APR-UTIL date routines.
int ap_proxy_lb_workers(void)
Definition: ap_slotmem.h:86
APR memory allocation.
APR Global Locking Routines.
int ap_proxy_pre_http_request(conn_rec *c, request_rec *r)
apr_bucket_brigade * bb
Definition: mod_dav.h:552
apr_size_t io_buffer_size
Definition: mod_proxy.h:169
const char * ap_proxy_show_hcmethod(hcmethod_t method)
Definition: mod_proxy.h:134
HTTP Daemon routines.
int ap_proxy_acquire_connection(const char *proxy_function, proxy_conn_rec **conn, proxy_worker *worker, server_rec *s)
proxy_hashes hash
Definition: mod_proxy.h:476
Apache hook functions.
Definition: mod_proxy.h:1143
#define PROXY_BALANCER_MAX_ROUTE_SIZE
Definition: mod_proxy.h:360
unsigned int flags
Definition: mod_proxy.h:130
A structure to store information for each virtual server.
Definition: httpd.h:1324
void * context
Definition: mod_proxy.h:484
apr_global_mutex_t * mutex
Definition: mod_proxy.h:183
apr_time_t error_time
Definition: mod_proxy.h:437
Definition: mod_proxy.h:75
const char * p
Definition: mod_proxy.h:205
int growth
Definition: mod_proxy.h:534
int
Definition: mod_proxy.h:643
apr_array_header_t * pfds
Definition: mod_proxy.h:1235
int smax
Definition: mod_proxy.h:420
apr_array_header_t * raliases
Definition: mod_proxy.h:252
Definition: mod_proxy.h:257
Definition: mod_proxy.h:402
int max_attempts
Definition: mod_proxy.h:508
apr_off_t read
Definition: mod_proxy.h:453
#define APR_DECLARE_EXTERNAL_HOOK(ns, link, ret, name, args)
Definition: apr_hooks.h:118
Definition: apr_arch_networkio.h:37
int ap_proxy_clear_connection(request_rec *r, apr_table_t *headers)
Definition: mod_proxy.h:173
int hc_valid_expr(request_rec *, const char *)
int max_balancers
Definition: mod_proxy.h:160
apr_pollset_t * pollset
Definition: mod_proxy.h:1234
const char * ap_proxy_de_socketfy(apr_pool_t *p, const char *url)
struct in_addr addr mask
Definition: mod_proxy.h:136
apr_interval_time_t ttl
Definition: mod_proxy.h:438
proxy_balancer_shared * s
Definition: mod_proxy.h:545
#define PROXY_WORKER_MAX_NAME_SIZE
Definition: mod_proxy.h:361
Definition: mod_proxy.h:529
const char * ap_proxy_ssl_val(apr_pool_t *p, server_rec *s, conn_rec *c, request_rec *r, const char *var)
apr_status_t ap_proxy_transfer_between_connections(request_rec *r, conn_rec *c_i, conn_rec *c_o, apr_bucket_brigade *bb_i, apr_bucket_brigade *bb_o, const char *name, int *sent, apr_off_t bsize, int flags)
Definition: ap_regex.h:111
apr_socket_t * sock
Definition: mod_proxy.h:266
apr_reslist_t * res
Definition: mod_proxy.h:293
request_rec * r
Definition: mod_proxy.h:259
const char * name
Definition: mod_proxy.h:91
APR-UTIL Buckets/Bucket Brigades.
long maxfwd
Definition: mod_proxy.h:170
Definition: mod_proxy.h:126
proxy_worker proxy_server_conf char * url
Definition: mod_proxy.h:626
APR FNMatch Functions.
proxy_worker_shared * ap_proxy_find_workershm(ap_slotmem_provider_t *storage, ap_slotmem_instance_t *slot, proxy_worker *worker, unsigned int *index)
#define PROXY_WORKER_MAX_SECRET_SIZE
Definition: mod_proxy.h:366
unsigned int apr_uint32_t
Definition: apr.h:351
hcmethod_t
Definition: mod_proxy.h:78
APR Platform Definitions.
apr_array_header_t * cookie_paths
Definition: mod_proxy.h:217
apr_port_t port
Definition: mod_proxy.h:451
APR MD5 Routines.
APR general purpose library routines.
#define PROXY_WORKER_MAX_HOSTNAME_SIZE
Definition: mod_proxy.h:363
APR-UTIL string matching routines.
#define PROXY_BALANCER_MAX_STICKY_SIZE
Definition: mod_proxy.h:365
int ap_proxyerror(request_rec *r, int statuscode, const char *message)
void * context
Definition: mod_proxy.h:544
const char * ap_proxy_location_reverse_map(request_rec *r, proxy_dir_conf *conf, const char *url)
apr_status_t ap_proxy_buckets_lifetime_transform(request_rec *r, apr_bucket_brigade *from, apr_bucket_brigade *to)
struct apr_sockaddr_t * addr
Definition: mod_proxy.h:143
int ap_proxy_release_connection(const char *proxy_function, proxy_conn_rec *conn, server_rec *s)
void ap_proxy_backend_broke(request_rec *r, apr_bucket_brigade *brigade)
apr_interval_time_t timeout
Definition: mod_proxy.h:441
Definition: mod_proxy.h:75
void ap_proxy_c2hex(int ch, char *x)
HTTP protocol handling.
int pcount
Definition: mod_proxy.h:425
Definition: apr_uri.h:85
Definition: mod_proxy.h:174
apr_array_header_t * workers
Definition: mod_proxy.h:152
apr_pool_t * p
#define PROXY_BALANCER_MAX_NAME_SIZE
Definition: mod_proxy.h:362
ap_slotmem_provider_t * storage
Definition: mod_proxy.h:533
apr_array_header_t * error_override_codes
Definition: mod_proxy.h:245
proxy_conn_rec * conn
Definition: mod_proxy.h:294
int ap_proxy_ssl_engine(conn_rec *c, ap_conf_vector_t *per_dir_config, int enable)
Apache Mutex support library.
char * ap_proxy_canon_netloc(apr_pool_t *p, char **const urlp, char **userp, char **passwordp, char **hostp, apr_port_t *port)
int content_length
Definition: mod_proxy.h:286
apr_array_header_t * workers
Definition: mod_proxy.h:530
int implemented
Definition: mod_proxy.h:85
apr_interval_time_t acquire
Definition: mod_proxy.h:442
apr_global_mutex_t * gmutex
Definition: mod_proxy.h:539
apr_off_t transferred
Definition: mod_proxy.h:452
Definition: mod_proxy.h:1143
apr_sockaddr_t * source_address
Definition: mod_proxy.h:182
apr_pool_t * scpool
Definition: mod_proxy.h:265
apr_pool_t * dns_pool
Definition: mod_proxy.h:295
struct proxy_alias * alias
Definition: mod_proxy.h:221
Apache Request library.
apr_status_t ap_proxy_sync_balancer(proxy_balancer *b, server_rec *s, proxy_server_conf *conf)
A structure that represents the current request.
Definition: httpd.h:819
int retries
Definition: mod_proxy.h:416
int fcount
Definition: mod_proxy.h:427
Apache filter library.
const char * hostname
Definition: mod_proxy.h:263
APR Strings library.
proxy_worker * forward
Definition: mod_proxy.h:154
apr_status_t ap_proxy_tunnel_create(proxy_tunnel_rec **tunnel, request_rec *r, conn_rec *c_o, const char *scheme)
enctype
Definition: mod_proxy.h:74
apr_port_t port
Definition: mod_proxy.h:120
int passes
Definition: mod_proxy.h:424
int lbset
Definition: mod_proxy.h:415
dav_buffer const char * str
Definition: mod_dav.h:461
int ap_proxy_should_override(proxy_dir_conf *conf, int code)
apr_interval_time_t retry
Definition: mod_proxy.h:440
const char * id
Definition: mod_proxy.h:157
int status
Definition: mod_dav.h:141
#define PROXY_DECLARE(type)
Definition: mod_proxy.h:580
int ap_proxy_connection_reusable(proxy_conn_rec *conn)
char * name
Definition: mod_proxy.h:84
apr_interval_time_t ping_timeout
Definition: mod_proxy.h:443
struct apr_table_t apr_table_t
Definition: apr_tables.h:56
unsigned int bit
Definition: mod_proxy.h:89
#define PROXY_BALANCER_MAX_HOSTNAME_SIZE
Definition: mod_proxy.h:364
int(* matcher)(struct dirconn_entry *This, request_rec *r)
Definition: mod_proxy.h:138
const char * name
Definition: mod_dav.h:726
int ap_proxy_hex2c(const char *x)
Definition: mod_proxy.h:179
int ap_proxy_create_hdrbrgd(apr_pool_t *p, apr_bucket_brigade *header_brigade, request_rec *r, proxy_conn_rec *p_conn, proxy_worker *worker, proxy_server_conf *conf, apr_uri_t *uri, char *url, char *server_portstr, char **old_cl_val, char **old_te_val)
const char * scheme
Definition: mod_proxy.h:115
apr_thread_mutex_t * tmutex
Definition: mod_proxy.h:541
Definition: mod_proxy.h:290
apr_status_t(* age)(proxy_balancer *balancer, server_rec *s)
Definition: mod_proxy.h:559
ap_slotmem_instance_t * bslot
Definition: mod_proxy.h:184
int index
Definition: mod_proxy.h:423
apr_bucket_brigade * tmp_bb
Definition: mod_proxy.h:278
struct apr_pool_t apr_pool_t
Definition: apr_pools.h:60
Definition: mod_proxy.h:79
conn_rec * connection
Definition: mod_proxy.h:258
int ap_proxy_pre_request(proxy_worker **worker, proxy_balancer **balancer, request_rec *r, proxy_server_conf *conf, char **url)
unsigned int lbmethod_set
Definition: mod_proxy.h:549
Definition: http_config.h:355
const char * ap_proxy_cookie_reverse_map(request_rec *r, proxy_dir_conf *conf, const char *str)
hcmethod_t method
Definition: mod_proxy.h:83
int apr_status_t
Definition: apr_errno.h:44
Definition: mod_proxy.h:79
#define APR_DECLARE_OPTIONAL_FN(ret, name, args)
Definition: apr_optional.h:50
proxy_hashes hash
Definition: mod_proxy.h:510
Definition: mod_proxy.h:79
Definition: mod_proxy.h:475
apr_status_t ap_proxy_initialize_balancer(proxy_balancer *balancer, server_rec *s, apr_pool_t *p)
int failontimeout
Definition: mod_proxy.h:546
apr_pool_t * pool
Definition: mod_proxy.h:291
int ap_proxy_determine_connection(apr_pool_t *p, request_rec *r, proxy_server_conf *conf, proxy_worker *worker, proxy_conn_rec *conn, apr_uri_t *uri, char **url, const char *proxyname, apr_port_t proxyport, char *server_portstr, int server_portstr_size)
#define PROXY_WORKER_MAX_SCHEME_SIZE
Definition: mod_proxy.h:358
const char * fake
Definition: mod_proxy.h:128
APR-UTIL URI Routines.
apr_uint16_t apr_port_t
Definition: apr_network_io.h:257
ap_conf_vector_t * section_config
Definition: mod_proxy.h:485
Definition: mod_proxy.h:88
void * data
Definition: mod_proxy.h:267
apr_thread_mutex_t * tmutex
Definition: mod_proxy.h:482
int lbstatus
Definition: mod_proxy.h:417
apr_array_header_t * balancers
Definition: mod_proxy.h:153
Definition: mod_proxy.h:79
proxy_worker proxy_server_conf * conf
Definition: mod_proxy.h:626
apr_size_t recv_buffer_size
Definition: mod_proxy.h:446
Definition: mod_proxy.h:79
Definition: mod_proxy.h:204
unsigned int def
Definition: mod_proxy.h:397
struct ap_conf_vector_t ap_conf_vector_t
Definition: http_config.h:519
hcmethod_t method
Definition: mod_proxy.h:435
apr_interval_time_t conn_timeout
Definition: mod_proxy.h:444
proxy_worker * worker
Definition: mod_proxy.h:626
apr_status_t ap_proxy_ssl_connection_cleanup(proxy_conn_rec *conn, request_rec *r)
apr_array_header_t * raliases
Definition: mod_proxy.h:216
apr_array_header_t * proxies
Definition: mod_proxy.h:147
Definition: mod_proxy.h:431
dav_resource int dav_locktoken dav_response int flags
Definition: mod_dav.h:1346
apr_array_header_t * refs
Definition: mod_proxy.h:240
proxy_balancer * balancer
Definition: mod_proxy.h:480
char * ap_proxy_update_balancer(apr_pool_t *p, proxy_balancer *balancer, const char *url)
ap_regex_t * r
Definition: mod_proxy.h:206
int max_workers
Definition: mod_proxy.h:535
Definition: mod_proxy.h:1143
apr_status_t ap_proxy_share_worker(proxy_worker *worker, proxy_worker_shared *shm, int i)
PROXY
Definition: mod_proxy.h:643
apr_status_t ap_proxy_set_wstatus(char c, int set, proxy_worker *w)
char * ap_proxy_define_worker(apr_pool_t *p, proxy_worker **worker, proxy_balancer *balancer, proxy_server_conf *conf, const char *url, int do_malloc)
apr_status_t ap_proxy_share_balancer(proxy_balancer *balancer, proxy_balancer_shared *shm, int i)
int ap_proxy_valid_balancer_name(char *name, int i)
Definition: mod_proxy.h:553
unsigned int failontimeout_set
Definition: mod_proxy.h:547
proxy_worker * proxy_balancer_get_best_worker(proxy_balancer *balancer, request_rec *r, proxy_is_best_callback_fn_t *is_best, void *baton)
apr_array_header_t * noproxies
Definition: mod_proxy.h:150
off_t apr_off_t
Definition: apr.h:399
Memory Slot Extension Storage Module for Apache.
proxy_hashes hash
Definition: mod_proxy.h:536
proxy_worker * ap_proxy_get_worker(apr_pool_t *p, proxy_balancer *balancer, proxy_server_conf *conf, const char *url)
ap_slotmem_instance_t * wslot
Definition: mod_proxy.h:532
proxy_worker proxy_server_conf char const char * proxyhost
Definition: mod_proxy.h:626
Definition: apr_network_io.h:266
apr_array_header_t * dirconn
Definition: mod_proxy.h:151
signed char p_is_fnmatch
Definition: mod_proxy.h:219
Definition: mod_proxy.h:79
Definition: mod_proxy.h:178
char sticky_separator
Definition: mod_proxy.h:519
PROXY_DECLARE_DATA proxy_wstat_t proxy_wstat_tbl[]
apr_status_t ap_proxy_check_connection(const char *scheme, proxy_conn_rec *conn, server_rec *server, unsigned max_blank_lines, int flags)
request_rec * r
Definition: mod_proxy.h:1232
const char * src
Definition: mod_proxy.h:675
Definition: apr_arch_poll_private.h:119
apr_size_t elected
Definition: mod_proxy.h:448