granicus.if.org Git - apache/blob - modules/proxy/mod_proxy.c

   1 #define FIX_15207
   2 /* Copyright 1999-2004 The Apache Software Foundation
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * 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 #define CORE_PRIVATE
  18
  19 #include "mod_proxy.h"
  20 #include "mod_core.h"
  21 #include "apr_optional.h"
  22 #include "mod_status.h"
  23
  24 #if (MODULE_MAGIC_NUMBER_MAJOR > 20020903)
  25 #include "mod_ssl.h"
  26 #else
  27 APR_DECLARE_OPTIONAL_FN(int, ssl_proxy_enable, (conn_rec *));
  28 APR_DECLARE_OPTIONAL_FN(int, ssl_engine_disable, (conn_rec *));
  29 #endif
  30
  31 #ifndef MAX
  32 #define MAX(x,y) ((x) >= (y) ? (x) : (y))
  33 #endif
  34
  35 /*
  36  * A Web proxy module. Stages:
  37  *
  38  *  translate_name: set filename to proxy:<URL>
  39  *  map_to_storage: run proxy_walk (rather than directory_walk/file_walk)
  40  *                  can't trust directory_walk/file_walk since these are
  41  *                  not in our filesystem.  Prevents mod_http from serving
  42  *                  the TRACE request we will set aside to handle later.
  43  *  type_checker:   set type to PROXY_MAGIC_TYPE if filename begins proxy:
  44  *  fix_ups:        convert the URL stored in the filename to the
  45  *                  canonical form.
  46  *  handler:        handle proxy requests
  47  */
  48
  49 /* -------------------------------------------------------------- */
  50 /* Translate the URL into a 'filename' */
  51
  52 #ifdef FIX_15207
  53 /* XXX: EBCDIC safe? --nd */
  54 #define x2c(x) (((x >= '0') && (x <= '9'))         \
  55                    ? (x - '0')                     \
  56                    : (((x >= 'a') && (x <= 'f'))   \
  57                        ? (10 + x - 'a')            \
  58                        : ((x >= 'A') && (x <='F')) \
  59                            ? (10 + x - 'A')        \
  60                            : 0                     \
  61                      )                             \
  62                )
  63
  64 static unsigned char hex2c(const char* p) {
  65   const char c1 = p[1];
  66   const char c2 = p[1] ? p[2]: '\0';
  67   int i1 = c1 ? x2c(c1) : 0;
  68   int i2 = c2 ? x2c(c2) : 0;
  69   unsigned char ret = (i1 << 4) | i2;
  70
  71   return ret;
  72 }
  73 #endif
  74
  75 #define PROXY_COPY_CONF_PARAMS(w, c) \
  76     do {                             \
  77         (w)->timeout              = (c)->timeout;               \
  78         (w)->timeout_set          = (c)->timeout_set;           \
  79         (w)->recv_buffer_size     = (c)->recv_buffer_size;      \
  80         (w)->recv_buffer_size_set = (c)->recv_buffer_size_set;  \
  81         (w)->io_buffer_size       = (c)->io_buffer_size;        \
  82         (w)->io_buffer_size_set   = (c)->io_buffer_size_set;    \
  83     } while (0)
  84
  85 static const char *set_worker_param(apr_pool_t *p,
  86                                     proxy_worker *worker,
  87                                     const char *key,
  88                                     const char *val)
  89 {
  90
  91     int ival;
  92     if (!strcasecmp(key, "loadfactor")) {
  93         worker->lbfactor = atoi(val);
  94         if (worker->lbfactor < 1 || worker->lbfactor > 100)
  95             return "LoadFactor must be number between 1..100";
  96     }
  97     else if (!strcasecmp(key, "retry")) {
  98         ival = atoi(val);
  99         if (ival < 1)
 100             return "Retry must be at least one second";
 101         worker->retry = apr_time_from_sec(ival);
 102     }
 103     else if (!strcasecmp(key, "ttl")) {
 104         ival = atoi(val);
 105         if (ival < 1)
 106             return "TTL must be at least one second";
 107         worker->ttl = apr_time_from_sec(ival);
 108     }
 109     else if (!strcasecmp(key, "min")) {
 110         ival = atoi(val);
 111         if (ival < 0)
 112             return "Min must be a positive number";
 113         worker->min = ival;
 114     }
 115     else if (!strcasecmp(key, "max")) {
 116         ival = atoi(val);
 117         if (ival < 0)
 118             return "Max must be a positive number";
 119         worker->hmax = ival;
 120     }
 121     /* XXX: More inteligent naming needed */
 122     else if (!strcasecmp(key, "smax")) {
 123         ival = atoi(val);
 124         if (ival < 0)
 125             return "Smax must be a positive number";
 126         worker->smax = ival;
 127     }
 128     else if (!strcasecmp(key, "acquire")) {
 129         ival = atoi(val);
 130         if (ival < 1)
 131             return "Acquire must be at least one mili second";
 132         worker->acquire = apr_time_make(0, ival * 1000);
 133         worker->acquire_set = 1;
 134     }
 135     else if (!strcasecmp(key, "timeout")) {
 136         ival = atoi(val);
 137         if (ival < 1)
 138             return "Timeout must be at least one second";
 139         worker->timeout = apr_time_from_sec(ival);
 140         worker->timeout_set = 1;
 141     }
 142     else if (!strcasecmp(key, "iobuffersize")) {
 143         long s = atol(val);
 144         worker->io_buffer_size = ((s > AP_IOBUFSIZE) ? s : AP_IOBUFSIZE);
 145         worker->io_buffer_size_set = 1;
 146     }
 147     else if (!strcasecmp(key, "receivebuffersize")) {
 148         ival = atoi(val);
 149         if (ival < 512 && ival != 0) {
 150             return "ReceiveBufferSize must be >= 512 bytes, or 0 for system default.";
 151         }
 152         worker->recv_buffer_size = ival;
 153         worker->recv_buffer_size_set = 1;
 154     }
 155     else if (!strcasecmp(key, "keepalive")) {
 156         if (!strcasecmp(val, "on"))
 157             worker->keepalive = 1;
 158         else if (!strcasecmp(val, "off"))
 159             worker->keepalive = 0;
 160         else
 161             return "KeepAlive must be On|Off";
 162         worker->keepalive_set = 1;
 163     }
 164     else if (!strcasecmp(key, "route")) {
 165         worker->route = apr_pstrdup(p, val);
 166     }
 167     else if (!strcasecmp(key, "redirect")) {
 168         worker->redirect = apr_pstrdup(p, val);
 169     }
 170     else {
 171         return "unknown Worker parameter";
 172     }
 173     return NULL;
 174 }
 175
 176 static const char *set_balancer_param(apr_pool_t *p,
 177                                       proxy_balancer *balancer,
 178                                       const char *key,
 179                                       const char *val)
 180 {
 181
 182     int ival;
 183     if (!strcasecmp(key, "stickysession")) {
 184         balancer->sticky = apr_pstrdup(p, val);
 185     }
 186     else if (!strcasecmp(key, "nofailover")) {
 187         if (!strcasecmp(val, "on"))
 188             balancer->sticky_force = 1;
 189         else if (!strcasecmp(val, "off"))
 190             balancer->sticky_force = 0;
 191         else
 192             return "failover must be On|Off";
 193     }
 194     else if (!strcasecmp(key, "timeout")) {
 195         ival = atoi(val);
 196         if (ival < 1)
 197             return "timeout must be at least one second";
 198         balancer->timeout = apr_time_from_sec(ival);
 199     }
 200     else {
 201         return "unknown Balancer parameter";
 202     }
 203     return NULL;
 204 }
 205
 206 static int alias_match(const char *uri, const char *alias_fakename)
 207 {
 208     const char *end_fakename = alias_fakename + strlen(alias_fakename);
 209     const char *aliasp = alias_fakename, *urip = uri;
 210     const char *end_uri = uri + strlen(uri);
 211     unsigned char uric, aliasc;
 212
 213     while (aliasp < end_fakename && urip < end_uri) {
 214         if (*aliasp == '/') {
 215             /* any number of '/' in the alias matches any number in
 216              * the supplied URI, but there must be at least one...
 217              */
 218             if (*urip != '/')
 219                 return 0;
 220
 221             while (*aliasp == '/')
 222                 ++aliasp;
 223             while (*urip == '/')
 224                 ++urip;
 225         }
 226         else {
 227 #ifndef FIX_15207
 228             /* Other characters are compared literally */
 229             if (*urip++ != *aliasp++)
 230                 return 0;
 231 #else
 232             /* Other characters are canonicalised and compared literally */
 233             if (*urip == '%') {
 234                 uric = hex2c(urip);
 235                 urip += 3;
 236             } else {
 237                 uric = (unsigned char)*urip++;
 238             }
 239             if (*aliasp == '%') {
 240                 aliasc = hex2c(aliasp);
 241                 aliasp += 3;
 242             } else {
 243                 aliasc = (unsigned char)*aliasp++;
 244             }
 245             if (uric != aliasc) {
 246                 return 0;
 247             }
 248 #endif
 249         }
 250     }
 251
 252     /* fixup badly encoded stuff (e.g. % as last character) */
 253     if (aliasp > end_fakename) {
 254         aliasp = end_fakename;
 255     }
 256     if (urip > end_uri) {
 257         urip = end_uri;
 258     }
 259
 260    /* We reach the end of the uri before the end of "alias_fakename"
 261     * for example uri is "/" and alias_fakename "/examples"
 262     */
 263    if (urip == end_uri && aliasp!=end_fakename) {
 264        return 0;
 265    }
 266
 267     /* Check last alias path component matched all the way */
 268     if (aliasp[-1] != '/' && *urip != '\0' && *urip != '/')
 269         return 0;
 270
 271     /* Return number of characters from URI which matched (may be
 272      * greater than length of alias, since we may have matched
 273      * doubled slashes)
 274      */
 275
 276     return urip - uri;
 277 }
 278
 279 /* Detect if an absoluteURI should be proxied or not.  Note that we
 280  * have to do this during this phase because later phases are
 281  * "short-circuiting"... i.e. translate_names will end when the first
 282  * module returns OK.  So for example, if the request is something like:
 283  *
 284  * GET http://othervhost/cgi-bin/printenv HTTP/1.0
 285  *
 286  * mod_alias will notice the /cgi-bin part and ScriptAlias it and
 287  * short-circuit the proxy... just because of the ordering in the
 288  * configuration file.
 289  */
 290 static int proxy_detect(request_rec *r)
 291 {
 292     void *sconf = r->server->module_config;
 293     proxy_server_conf *conf =
 294         (proxy_server_conf *) ap_get_module_config(sconf, &proxy_module);
 295 #ifdef FIX_15207
 296     int i, len;
 297     struct proxy_alias *ent = (struct proxy_alias *)conf->aliases->elts;
 298 #endif
 299
 300     /* Ick... msvc (perhaps others) promotes ternary short results to int */
 301
 302     if (conf->req && r->parsed_uri.scheme) {
 303         /* but it might be something vhosted */
 304         if (!(r->parsed_uri.hostname
 305               && !strcasecmp(r->parsed_uri.scheme, ap_http_method(r))
 306               && ap_matches_request_vhost(r, r->parsed_uri.hostname,
 307                                           (apr_port_t)(r->parsed_uri.port_str ? r->parsed_uri.port
 308                                                        : ap_default_port(r))))) {
 309             r->proxyreq = PROXYREQ_PROXY;
 310             r->uri = r->unparsed_uri;
 311             r->filename = apr_pstrcat(r->pool, "proxy:", r->uri, NULL);
 312             r->handler = "proxy-server";
 313         }
 314     }
 315     /* We need special treatment for CONNECT proxying: it has no scheme part */
 316     else if (conf->req && r->method_number == M_CONNECT
 317              && r->parsed_uri.hostname
 318              && r->parsed_uri.port_str) {
 319         r->proxyreq = PROXYREQ_PROXY;
 320         r->uri = r->unparsed_uri;
 321         r->filename = apr_pstrcat(r->pool, "proxy:", r->uri, NULL);
 322         r->handler = "proxy-server";
 323 #ifdef FIX_15207
 324     } else {
 325         /* test for a ProxyPass */
 326         for (i = 0; i < conf->aliases->nelts; i++) {
 327             len = alias_match(r->unparsed_uri, ent[i].fake);
 328             if (len > 0) {
 329                 r->filename = apr_pstrcat(r->pool, "proxy:", ent[i].real,
 330                                           r->unparsed_uri + len, NULL);
 331                 r->handler = "proxy-server";
 332                 r->proxyreq = PROXYREQ_REVERSE;
 333                 r->uri = r->unparsed_uri;
 334                 break;
 335             }
 336         }
 337 #endif
 338     }
 339     return DECLINED;
 340 }
 341
 342 static int proxy_trans(request_rec *r)
 343 {
 344 #ifndef FIX_15207
 345     void *sconf = r->server->module_config;
 346     proxy_server_conf *conf =
 347     (proxy_server_conf *) ap_get_module_config(sconf, &proxy_module);
 348     int i, len;
 349     struct proxy_alias *ent = (struct proxy_alias *) conf->aliases->elts;
 350 #endif
 351
 352     if (r->proxyreq) {
 353         /* someone has already set up the proxy, it was possibly ourselves
 354          * in proxy_detect
 355          */
 356         return OK;
 357     }
 358
 359 #ifndef FIX_15207
 360     /* XXX: since r->uri has been manipulated already we're not really
 361      * compliant with RFC1945 at this point.  But this probably isn't
 362      * an issue because this is a hybrid proxy/origin server.
 363      */
 364
 365     for (i = 0; i < conf->aliases->nelts; i++) {
 366         len = alias_match(r->uri, ent[i].fake);
 367
 368        if (len > 0) {
 369            if ((ent[i].real[0] == '!') && (ent[i].real[1] == 0)) {
 370                return DECLINED;
 371            }
 372
 373            r->filename = apr_pstrcat(r->pool, "proxy:", ent[i].real,
 374                                      r->uri + len, NULL);
 375            r->handler = "proxy-server";
 376            r->proxyreq = PROXYREQ_REVERSE;
 377            return OK;
 378        }
 379     }
 380 #endif
 381     return DECLINED;
 382 }
 383
 384 static int proxy_walk(request_rec *r)
 385 {
 386     proxy_server_conf *sconf = ap_get_module_config(r->server->module_config,
 387                                                     &proxy_module);
 388     ap_conf_vector_t *per_dir_defaults = r->server->lookup_defaults;
 389     ap_conf_vector_t **sec_proxy = (ap_conf_vector_t **) sconf->sec_proxy->elts;
 390     ap_conf_vector_t *entry_config;
 391     proxy_dir_conf *entry_proxy;
 392     int num_sec = sconf->sec_proxy->nelts;
 393     /* XXX: shouldn't we use URI here?  Canonicalize it first?
 394      * Pass over "proxy:" prefix
 395      */
 396     const char *proxyname = r->filename + 6;
 397     int j;
 398
 399     for (j = 0; j < num_sec; ++j)
 400     {
 401         entry_config = sec_proxy[j];
 402         entry_proxy = ap_get_module_config(entry_config, &proxy_module);
 403
 404         /* XXX: What about case insensitive matching ???
 405          * Compare regex, fnmatch or string as appropriate
 406          * If the entry doesn't relate, then continue
 407          */
 408         if (entry_proxy->r
 409               ? ap_regexec(entry_proxy->r, proxyname, 0, NULL, 0)
 410               : (entry_proxy->p_is_fnmatch
 411                    ? apr_fnmatch(entry_proxy->p, proxyname, 0)
 412                    : strncmp(proxyname, entry_proxy->p,
 413                                         strlen(entry_proxy->p)))) {
 414             continue;
 415         }
 416         per_dir_defaults = ap_merge_per_dir_configs(r->pool, per_dir_defaults,
 417                                                              entry_config);
 418     }
 419
 420     r->per_dir_config = per_dir_defaults;
 421
 422     return OK;
 423 }
 424
 425 static int proxy_map_location(request_rec *r)
 426 {
 427     int access_status;
 428
 429     if (!r->proxyreq || !r->filename || strncmp(r->filename, "proxy:", 6) != 0)
 430         return DECLINED;
 431
 432     /* Don't let the core or mod_http map_to_storage hooks handle this,
 433      * We don't need directory/file_walk, and we want to TRACE on our own.
 434      */
 435     if ((access_status = proxy_walk(r))) {
 436         ap_die(access_status, r);
 437         return access_status;
 438     }
 439
 440     return OK;
 441 }
 442 #ifndef FIX_15207
 443 /* -------------------------------------------------------------- */
 444 /* Fixup the filename */
 445
 446 /*
 447  * Canonicalise the URL
 448  */
 449 static int proxy_fixup(request_rec *r)
 450 {
 451     char *url, *p;
 452     int access_status;
 453
 454     if (!r->proxyreq || !r->filename || strncmp(r->filename, "proxy:", 6) != 0)
 455         return DECLINED;
 456
 457 #ifdef FIX_15207
 458 /* We definitely shouldn't canonicalize a proxy_pass.
 459  * But should we really canonicalize a STD_PROXY??? -- Fahree
 460  */
 461     if (r->proxyreq == PROXYREQ_REVERSE) {
 462         return OK;
 463     }
 464 #endif
 465
 466     /* XXX: Shouldn't we try this before we run the proxy_walk? */
 467     url = &r->filename[6];
 468
 469     /* canonicalise each specific scheme */
 470     if ((access_status = proxy_run_canon_handler(r, url))) {
 471         return access_status;
 472     }
 473
 474     p = strchr(url, ':');
 475     if (p == NULL || p == url)
 476         return HTTP_BAD_REQUEST;
 477
 478     return OK;      /* otherwise; we've done the best we can */
 479 }
 480 #endif
 481 /* Send a redirection if the request contains a hostname which is not */
 482 /* fully qualified, i.e. doesn't have a domain name appended. Some proxy */
 483 /* servers like Netscape's allow this and access hosts from the local */
 484 /* domain in this case. I think it is better to redirect to a FQDN, since */
 485 /* these will later be found in the bookmarks files. */
 486 /* The "ProxyDomain" directive determines what domain will be appended */
 487 static int proxy_needsdomain(request_rec *r, const char *url, const char *domain)
 488 {
 489     char *nuri;
 490     const char *ref;
 491
 492     /* We only want to worry about GETs */
 493     if (!r->proxyreq || r->method_number != M_GET || !r->parsed_uri.hostname)
 494         return DECLINED;
 495
 496     /* If host does contain a dot already, or it is "localhost", decline */
 497     if (strchr(r->parsed_uri.hostname, '.') != NULL
 498      || strcasecmp(r->parsed_uri.hostname, "localhost") == 0)
 499         return DECLINED;    /* host name has a dot already */
 500
 501     ref = apr_table_get(r->headers_in, "Referer");
 502
 503     /* Reassemble the request, but insert the domain after the host name */
 504     /* Note that the domain name always starts with a dot */
 505     r->parsed_uri.hostname = apr_pstrcat(r->pool, r->parsed_uri.hostname,
 506                                          domain, NULL);
 507     nuri = apr_uri_unparse(r->pool,
 508                            &r->parsed_uri,
 509                            APR_URI_UNP_REVEALPASSWORD);
 510
 511     apr_table_set(r->headers_out, "Location", nuri);
 512     ap_log_rerror(APLOG_MARK, APLOG_INFO, 0, r,
 513                   "Domain missing: %s sent to %s%s%s", r->uri,
 514                   apr_uri_unparse(r->pool, &r->parsed_uri,
 515                                   APR_URI_UNP_OMITUSERINFO),
 516                   ref ? " from " : "", ref ? ref : "");
 517
 518     return HTTP_MOVED_PERMANENTLY;
 519 }
 520
 521 /* -------------------------------------------------------------- */
 522 /* Invoke handler */
 523
 524 static int proxy_handler(request_rec *r)
 525 {
 526     char *url, *scheme, *p;
 527     const char *p2;
 528     void *sconf = r->server->module_config;
 529     proxy_server_conf *conf = (proxy_server_conf *)
 530         ap_get_module_config(sconf, &proxy_module);
 531     apr_array_header_t *proxies = conf->proxies;
 532     struct proxy_remote *ents = (struct proxy_remote *) proxies->elts;
 533     int i, rc, access_status;
 534     int direct_connect = 0;
 535     const char *str;
 536     long maxfwd;
 537     proxy_balancer *balancer = NULL;
 538     proxy_worker *worker = NULL;
 539
 540     /* is this for us? */
 541     if (!r->proxyreq || !r->filename || strncmp(r->filename, "proxy:", 6) != 0)
 542         return DECLINED;
 543
 544     /* handle max-forwards / OPTIONS / TRACE */
 545     if ((str = apr_table_get(r->headers_in, "Max-Forwards"))) {
 546         maxfwd = strtol(str, NULL, 10);
 547         if (maxfwd < 1) {
 548             switch (r->method_number) {
 549             case M_TRACE: {
 550                 int access_status;
 551                 r->proxyreq = PROXYREQ_NONE;
 552                 if ((access_status = ap_send_http_trace(r)))
 553                     ap_die(access_status, r);
 554                 else
 555                     ap_finalize_request_protocol(r);
 556                 return OK;
 557             }
 558             case M_OPTIONS: {
 559                 int access_status;
 560                 r->proxyreq = PROXYREQ_NONE;
 561                 if ((access_status = ap_send_http_options(r)))
 562                     ap_die(access_status, r);
 563                 else
 564                     ap_finalize_request_protocol(r);
 565                 return OK;
 566             }
 567             default: {
 568                 return ap_proxyerror(r, HTTP_BAD_GATEWAY,
 569                                      "Max-Forwards has reached zero - proxy loop?");
 570             }
 571             }
 572         }
 573         maxfwd = (maxfwd > 0) ? maxfwd - 1 : 0;
 574     }
 575     else {
 576         /* set configured max-forwards */
 577         maxfwd = conf->maxfwd;
 578     }
 579     apr_table_set(r->headers_in, "Max-Forwards",
 580                   apr_psprintf(r->pool, "%ld", (maxfwd > 0) ? maxfwd : 0));
 581
 582     url = r->filename + 6;
 583     p = strchr(url, ':');
 584     if (p == NULL) {
 585         ap_log_rerror(APLOG_MARK, APLOG_DEBUG, 0, r,
 586                       "proxy_handler no URL in %s", r->filename);
 587         return HTTP_BAD_REQUEST;
 588     }
 589
 590     /* If the host doesn't have a domain name, add one and redirect. */
 591     if (conf->domain != NULL) {
 592         rc = proxy_needsdomain(r, url, conf->domain);
 593         if (ap_is_HTTP_REDIRECT(rc))
 594             return HTTP_MOVED_PERMANENTLY;
 595     }
 596
 597     *p = '\0';
 598     scheme = apr_pstrdup(r->pool, url);
 599     *p = ':';
 600
 601     /* Check URI's destination host against NoProxy hosts */
 602     /* Bypass ProxyRemote server lookup if configured as NoProxy */
 603     /* we only know how to handle communication to a proxy via http */
 604     /*if (strcasecmp(scheme, "http") == 0) */
 605     {
 606         int ii;
 607         struct dirconn_entry *list = (struct dirconn_entry *) conf->dirconn->elts;
 608
 609         for (direct_connect = ii = 0; ii < conf->dirconn->nelts && !direct_connect; ii++) {
 610             direct_connect = list[ii].matcher(&list[ii], r);
 611         }
 612 #if DEBUGGING
 613         ap_log_rerror(APLOG_MARK, APLOG_DEBUG, 0, r,
 614                       (direct_connect) ? "NoProxy for %s" : "UseProxy for %s",
 615                       r->uri);
 616 #endif
 617     }
 618
 619     /* Try to obtain the most suitable worker */
 620     access_status = ap_proxy_pre_request(&worker, &balancer, r, conf, &url);
 621     if (access_status != OK)
 622         return access_status;
 623
 624     /* firstly, try a proxy, unless a NoProxy directive is active */
 625     if (!direct_connect) {
 626         for (i = 0; i < proxies->nelts; i++) {
 627             p2 = ap_strchr_c(ents[i].scheme, ':');  /* is it a partial URL? */
 628             if (strcmp(ents[i].scheme, "*") == 0 ||
 629                 (ents[i].use_regex && ap_regexec(ents[i].regexp, url, 0,NULL, 0)) ||
 630                 (p2 == NULL && strcasecmp(scheme, ents[i].scheme) == 0) ||
 631                 (p2 != NULL &&
 632                  strncasecmp(url, ents[i].scheme, strlen(ents[i].scheme)) == 0)) {
 633
 634                 /* handle the scheme */
 635                 ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, r->server,
 636                              "Trying to run scheme_handler against proxy");
 637                 access_status = proxy_run_scheme_handler(r, worker, conf, url, ents[i].hostname, ents[i].port);
 638
 639                 /* an error or success */
 640                 if (access_status != DECLINED && access_status != HTTP_BAD_GATEWAY) {
 641                     goto cleanup;
 642                 }
 643                 /* we failed to talk to the upstream proxy */
 644             }
 645         }
 646     }
 647
 648     /* otherwise, try it direct */
 649     /* N.B. what if we're behind a firewall, where we must use a proxy or
 650      * give up??
 651      */
 652
 653     /* handle the scheme */
 654     ap_log_error(APLOG_MARK, APLOG_DEBUG, 0, r->server,
 655                  "Trying to run scheme_handler");
 656     access_status = proxy_run_scheme_handler(r, worker, conf, url, NULL, 0);
 657     if (DECLINED == access_status) {
 658         ap_log_error(APLOG_MARK, APLOG_WARNING, 0, r->server,
 659                     "proxy: No protocol handler was valid for the URL %s. "
 660                     "If you are using a DSO version of mod_proxy, make sure "
 661                     "the proxy submodules are included in the configuration "
 662                     "using LoadModule.", r->uri);
 663         access_status = HTTP_FORBIDDEN;
 664         goto cleanup;
 665     }
 666
 667 cleanup:
 668     if (balancer) {
 669         int post_status = proxy_run_post_request(worker, balancer, r, conf);
 670         if (post_status == DECLINED) {
 671             post_status = OK; /* no post_request handler available */
 672             /* TODO: reclycle direct worker */
 673         }
 674     }
 675     return access_status;
 676 }
 677
 678 /* -------------------------------------------------------------- */
 679 /* Setup configurable data */
 680
 681 static void * create_proxy_config(apr_pool_t *p, server_rec *s)
 682 {
 683     proxy_server_conf *ps = apr_pcalloc(p, sizeof(proxy_server_conf));
 684
 685     ps->sec_proxy = apr_array_make(p, 10, sizeof(ap_conf_vector_t *));
 686     ps->proxies = apr_array_make(p, 10, sizeof(struct proxy_remote));
 687     ps->aliases = apr_array_make(p, 10, sizeof(struct proxy_alias));
 688     ps->raliases = apr_array_make(p, 10, sizeof(struct proxy_alias));
 689     ps->cookie_paths = apr_array_make(p, 10, sizeof(struct proxy_alias));
 690     ps->cookie_domains = apr_array_make(p, 10, sizeof(struct proxy_alias));
 691     ps->cookie_path_str = apr_strmatch_precompile(p, "path=", 0);
 692     ps->cookie_domain_str = apr_strmatch_precompile(p, "domain=", 0);
 693     ps->noproxies = apr_array_make(p, 10, sizeof(struct noproxy_entry));
 694     ps->dirconn = apr_array_make(p, 10, sizeof(struct dirconn_entry));
 695     ps->allowed_connect_ports = apr_array_make(p, 10, sizeof(int));
 696     ps->workers = apr_array_make(p, 10, sizeof(proxy_worker));
 697     ps->balancers = apr_array_make(p, 10, sizeof(proxy_balancer));
 698     ps->forward = NULL;
 699     ps->domain = NULL;
 700     ps->viaopt = via_off; /* initially backward compatible with 1.3.1 */
 701     ps->viaopt_set = 0; /* 0 means default */
 702     ps->req = 0;
 703     ps->req_set = 0;
 704     ps->recv_buffer_size = 0; /* this default was left unset for some reason */
 705     ps->recv_buffer_size_set = 0;
 706     ps->io_buffer_size = AP_IOBUFSIZE;
 707     ps->io_buffer_size_set = 0;
 708     ps->maxfwd = DEFAULT_MAX_FORWARDS;
 709     ps->maxfwd_set = 0;
 710     ps->error_override = 0;
 711     ps->error_override_set = 0;
 712     ps->preserve_host_set = 0;
 713     ps->preserve_host = 0;
 714     ps->timeout = 0;
 715     ps->timeout_set = 0;
 716     ps->badopt = bad_error;
 717     ps->badopt_set = 0;
 718     ps->pool = p;
 719     return ps;
 720 }
 721
 722 static void * merge_proxy_config(apr_pool_t *p, void *basev, void *overridesv)
 723 {
 724     proxy_server_conf *ps = apr_pcalloc(p, sizeof(proxy_server_conf));
 725     proxy_server_conf *base = (proxy_server_conf *) basev;
 726     proxy_server_conf *overrides = (proxy_server_conf *) overridesv;
 727
 728     ps->proxies = apr_array_append(p, base->proxies, overrides->proxies);
 729     ps->sec_proxy = apr_array_append(p, base->sec_proxy, overrides->sec_proxy);
 730     ps->aliases = apr_array_append(p, base->aliases, overrides->aliases);
 731     ps->raliases = apr_array_append(p, base->raliases, overrides->raliases);
 732     ps->cookie_paths
 733         = apr_array_append(p, base->cookie_paths, overrides->cookie_paths);
 734     ps->cookie_domains
 735         = apr_array_append(p, base->cookie_domains, overrides->cookie_domains);
 736     ps->cookie_path_str = base->cookie_path_str;
 737     ps->cookie_domain_str = base->cookie_domain_str;
 738     ps->noproxies = apr_array_append(p, base->noproxies, overrides->noproxies);
 739     ps->dirconn = apr_array_append(p, base->dirconn, overrides->dirconn);
 740     ps->allowed_connect_ports = apr_array_append(p, base->allowed_connect_ports, overrides->allowed_connect_ports);
 741     ps->workers = apr_array_append(p, base->workers, overrides->workers);
 742     ps->balancers = apr_array_append(p, base->balancers, overrides->balancers);
 743     ps->forward = overrides->forward ? overrides->forward : base->forward;
 744
 745     ps->domain = (overrides->domain == NULL) ? base->domain : overrides->domain;
 746     ps->viaopt = (overrides->viaopt_set == 0) ? base->viaopt : overrides->viaopt;
 747     ps->req = (overrides->req_set == 0) ? base->req : overrides->req;
 748     ps->recv_buffer_size = (overrides->recv_buffer_size_set == 0) ? base->recv_buffer_size : overrides->recv_buffer_size;
 749     ps->io_buffer_size = (overrides->io_buffer_size_set == 0) ? base->io_buffer_size : overrides->io_buffer_size;
 750     ps->maxfwd = (overrides->maxfwd_set == 0) ? base->maxfwd : overrides->maxfwd;
 751     ps->error_override = (overrides->error_override_set == 0) ? base->error_override : overrides->error_override;
 752     ps->preserve_host = (overrides->preserve_host_set == 0) ? base->preserve_host : overrides->preserve_host;
 753     ps->timeout= (overrides->timeout_set == 0) ? base->timeout : overrides->timeout;
 754     ps->badopt = (overrides->badopt_set == 0) ? base->badopt : overrides->badopt;
 755     ps->pool = p;
 756     return ps;
 757 }
 758
 759 static void *create_proxy_dir_config(apr_pool_t *p, char *dummy)
 760 {
 761     proxy_dir_conf *new =
 762         (proxy_dir_conf *) apr_pcalloc(p, sizeof(proxy_dir_conf));
 763
 764     /* Filled in by proxysection, when applicable */
 765
 766     return (void *) new;
 767 }
 768
 769 static void *merge_proxy_dir_config(apr_pool_t *p, void *basev, void *addv)
 770 {
 771     proxy_dir_conf *new = (proxy_dir_conf *) apr_pcalloc(p, sizeof(proxy_dir_conf));
 772     proxy_dir_conf *add = (proxy_dir_conf *) addv;
 773
 774     new->p = add->p;
 775     new->p_is_fnmatch = add->p_is_fnmatch;
 776     new->r = add->r;
 777     return new;
 778 }
 779
 780
 781 static const char *
 782     add_proxy(cmd_parms *cmd, void *dummy, const char *f1, const char *r1, int regex)
 783 {
 784     server_rec *s = cmd->server;
 785     proxy_server_conf *conf =
 786     (proxy_server_conf *) ap_get_module_config(s->module_config, &proxy_module);
 787     struct proxy_remote *new;
 788     char *p, *q;
 789     char *r, *f, *scheme;
 790     regex_t *reg = NULL;
 791     int port;
 792
 793     r = apr_pstrdup(cmd->pool, r1);
 794     scheme = apr_pstrdup(cmd->pool, r1);
 795     f = apr_pstrdup(cmd->pool, f1);
 796     p = strchr(r, ':');
 797     if (p == NULL || p[1] != '/' || p[2] != '/' || p[3] == '\0') {
 798         if (regex)
 799             return "ProxyRemoteMatch: Bad syntax for a remote proxy server";
 800         else
 801             return "ProxyRemote: Bad syntax for a remote proxy server";
 802     }
 803     else {
 804         scheme[p-r] = 0;
 805     }
 806     q = strchr(p + 3, ':');
 807     if (q != NULL) {
 808         if (sscanf(q + 1, "%u", &port) != 1 || port > 65535) {
 809             if (regex)
 810                 return "ProxyRemoteMatch: Bad syntax for a remote proxy server (bad port number)";
 811             else
 812                 return "ProxyRemote: Bad syntax for a remote proxy server (bad port number)";
 813         }
 814         *q = '\0';
 815     }
 816     else
 817         port = -1;
 818     *p = '\0';
 819     if (regex) {
 820         reg = ap_pregcomp(cmd->pool, f, REG_EXTENDED);
 821         if (!reg)
 822             return "Regular expression for ProxyRemoteMatch could not be compiled.";
 823     }
 824     else
 825         if (strchr(f, ':') == NULL)
 826             ap_str_tolower(f);      /* lowercase scheme */
 827     ap_str_tolower(p + 3);      /* lowercase hostname */
 828
 829     if (port == -1) {
 830         port = apr_uri_port_of_scheme(scheme);
 831     }
 832
 833     new = apr_array_push(conf->proxies);
 834     new->scheme = f;
 835     new->protocol = r;
 836     new->hostname = p + 3;
 837     new->port = port;
 838     new->regexp = reg;
 839     new->use_regex = regex;
 840     return NULL;
 841 }
 842
 843 static const char *
 844     add_proxy_noregex(cmd_parms *cmd, void *dummy, const char *f1, const char *r1)
 845 {
 846     return add_proxy(cmd, dummy, f1, r1, 0);
 847 }
 848
 849 static const char *
 850     add_proxy_regex(cmd_parms *cmd, void *dummy, const char *f1, const char *r1)
 851 {
 852     return add_proxy(cmd, dummy, f1, r1, 1);
 853 }
 854
 855 static const char *
 856     add_pass(cmd_parms *cmd, void *dummy, const char *arg)
 857 {
 858     server_rec *s = cmd->server;
 859     proxy_server_conf *conf =
 860     (proxy_server_conf *) ap_get_module_config(s->module_config, &proxy_module);
 861     struct proxy_alias *new;
 862     char *f = cmd->path;
 863     char *r = NULL;
 864     char *word;
 865     apr_table_t *params = apr_table_make(cmd->pool, 5);
 866     const apr_array_header_t *arr;
 867     const apr_table_entry_t *elts;
 868     int i;
 869
 870     while (*arg) {
 871         word = ap_getword_conf(cmd->pool, &arg);
 872         if (!f)
 873             f = word;
 874         else if (!r)
 875             r = word;
 876         else {
 877             char *val = strchr(word, '=');
 878             if (!val) {
 879                 if (cmd->path)
 880                     return "Invalid ProxyPass parameter.  Parameter must be "
 881                            "in the form 'key=value'";
 882                 else
 883                     return "ProxyPass can not have a path when defined in a location";
 884             }
 885             else
 886                 *val++ = '\0';
 887             apr_table_setn(params, word, val);
 888         }
 889     };
 890
 891     if (r == NULL)
 892         return "ProxyPass needs a path when not defined in a location";
 893
 894     new = apr_array_push(conf->aliases);
 895     new->fake = apr_pstrdup(cmd->pool, f);
 896     new->real = apr_pstrdup(cmd->pool, r);
 897
 898     arr = apr_table_elts(params);
 899     elts = (const apr_table_entry_t *)arr->elts;
 900     /* Distinguish the balancer from woker */
 901     if (strncasecmp(r, "balancer:", 9) == 0) {
 902         proxy_balancer *balancer = ap_proxy_get_balancer(cmd->pool, conf, r);
 903         if (!balancer) {
 904             const char *err = ap_proxy_add_balancer(&balancer,
 905                                                     cmd->pool,
 906                                                     conf, r);
 907             if (err)
 908                 return apr_pstrcat(cmd->temp_pool, "ProxyPass ", err, NULL);
 909         }
 910         for (i = 0; i < arr->nelts; i++) {
 911             const char *err = set_balancer_param(cmd->pool, balancer, elts[i].key,
 912                                                  elts[i].val);
 913             if (err)
 914                 return apr_pstrcat(cmd->temp_pool, "ProxyPass ", err, NULL);
 915         }
 916     }
 917     else {
 918         proxy_worker *worker = ap_proxy_get_worker(cmd->temp_pool, conf, r);
 919         if (!worker) {
 920             const char *err = ap_proxy_add_worker(&worker, cmd->pool, conf, r);
 921             if (err)
 922                 return apr_pstrcat(cmd->temp_pool, "ProxyPass ", err, NULL);
 923         }
 924         PROXY_COPY_CONF_PARAMS(worker, conf);
 925
 926         for (i = 0; i < arr->nelts; i++) {
 927             const char *err = set_worker_param(cmd->pool, worker, elts[i].key,
 928                                                elts[i].val);
 929             if (err)
 930                 return apr_pstrcat(cmd->temp_pool, "ProxyPass ", err, NULL);
 931         }
 932     }
 933     return NULL;
 934 }
 935
 936 static const char *
 937     add_pass_reverse(cmd_parms *cmd, void *dummy, const char *f, const char *r)
 938 {
 939     server_rec *s = cmd->server;
 940     proxy_server_conf *conf;
 941     struct proxy_alias *new;
 942
 943     conf = (proxy_server_conf *)ap_get_module_config(s->module_config,
 944                                                      &proxy_module);
 945     if (r!=NULL && cmd->path == NULL ) {
 946         new = apr_array_push(conf->raliases);
 947         new->fake = f;
 948         new->real = r;
 949     } else if (r==NULL && cmd->path != NULL) {
 950         new = apr_array_push(conf->raliases);
 951         new->fake = cmd->path;
 952         new->real = f;
 953     } else {
 954         if ( r == NULL)
 955             return "ProxyPassReverse needs a path when not defined in a location";
 956         else
 957             return "ProxyPassReverse can not have a path when defined in a location";
 958     }
 959
 960     return NULL;
 961 }
 962 static const char*
 963     cookie_path(cmd_parms *cmd, void *dummy, const char *f, const char *r)
 964 {
 965     server_rec *s = cmd->server;
 966     proxy_server_conf *conf;
 967     struct proxy_alias *new;
 968
 969     conf = (proxy_server_conf *)ap_get_module_config(s->module_config,
 970                                                      &proxy_module);
 971     new = apr_array_push(conf->cookie_paths);
 972     new->fake = f;
 973     new->real = r;
 974
 975     return NULL;
 976 }
 977 static const char*
 978     cookie_domain(cmd_parms *cmd, void *dummy, const char *f, const char *r)
 979 {
 980     server_rec *s = cmd->server;
 981     proxy_server_conf *conf;
 982     struct proxy_alias *new;
 983
 984     conf = (proxy_server_conf *)ap_get_module_config(s->module_config,
 985                                                      &proxy_module);
 986     new = apr_array_push(conf->cookie_domains);
 987     new->fake = f;
 988     new->real = r;
 989
 990     return NULL;
 991 }
 992
 993 static const char *
 994     set_proxy_exclude(cmd_parms *parms, void *dummy, const char *arg)
 995 {
 996     server_rec *s = parms->server;
 997     proxy_server_conf *conf =
 998     ap_get_module_config(s->module_config, &proxy_module);
 999     struct noproxy_entry *new;
1000     struct noproxy_entry *list = (struct noproxy_entry *) conf->noproxies->elts;
1001     struct apr_sockaddr_t *addr;
1002     int found = 0;
1003     int i;
1004
1005     /* Don't duplicate entries */
1006     for (i = 0; i < conf->noproxies->nelts; i++) {
1007         if (apr_strnatcasecmp(arg, list[i].name) == 0) { /* ignore case for host names */
1008             found = 1;
1009         }
1010     }
1011
1012     if (!found) {
1013         new = apr_array_push(conf->noproxies);
1014         new->name = arg;
1015         if (APR_SUCCESS == apr_sockaddr_info_get(&addr, new->name, APR_UNSPEC, 0, 0, parms->pool)) {
1016             new->addr = addr;
1017         }
1018         else {
1019             new->addr = NULL;
1020         }
1021     }
1022     return NULL;
1023 }
1024
1025 /*
1026  * Set the ports CONNECT can use
1027  */
1028 static const char *
1029     set_allowed_ports(cmd_parms *parms, void *dummy, const char *arg)
1030 {
1031     server_rec *s = parms->server;
1032     proxy_server_conf *conf =
1033         ap_get_module_config(s->module_config, &proxy_module);
1034     int *New;
1035
1036     if (!apr_isdigit(arg[0]))
1037         return "AllowCONNECT: port number must be numeric";
1038
1039     New = apr_array_push(conf->allowed_connect_ports);
1040     *New = atoi(arg);
1041     return NULL;
1042 }
1043
1044 /* Similar to set_proxy_exclude(), but defining directly connected hosts,
1045  * which should never be accessed via the configured ProxyRemote servers
1046  */
1047 static const char *
1048     set_proxy_dirconn(cmd_parms *parms, void *dummy, const char *arg)
1049 {
1050     server_rec *s = parms->server;
1051     proxy_server_conf *conf =
1052     ap_get_module_config(s->module_config, &proxy_module);
1053     struct dirconn_entry *New;
1054     struct dirconn_entry *list = (struct dirconn_entry *) conf->dirconn->elts;
1055     int found = 0;
1056     int i;
1057
1058     /* Don't duplicate entries */
1059     for (i = 0; i < conf->dirconn->nelts; i++) {
1060         if (strcasecmp(arg, list[i].name) == 0)
1061             found = 1;
1062     }
1063
1064     if (!found) {
1065         New = apr_array_push(conf->dirconn);
1066         New->name = apr_pstrdup(parms->pool, arg);
1067         New->hostaddr = NULL;
1068
1069     if (ap_proxy_is_ipaddr(New, parms->pool)) {
1070 #if DEBUGGING
1071         ap_log_error(APLOG_MARK, APLOG_STARTUP, 0, NULL,
1072                      "Parsed addr %s", inet_ntoa(New->addr));
1073         ap_log_error(APLOG_MARK, APLOG_STARTUP, 0, NULL,
1074                      "Parsed mask %s", inet_ntoa(New->mask));
1075 #endif
1076     }
1077     else if (ap_proxy_is_domainname(New, parms->pool)) {
1078         ap_str_tolower(New->name);
1079 #if DEBUGGING
1080         ap_log_error(APLOG_MARK, APLOG_STARTUP, 0, NULL,
1081                      "Parsed domain %s", New->name);
1082 #endif
1083         }
1084         else if (ap_proxy_is_hostname(New, parms->pool)) {
1085             ap_str_tolower(New->name);
1086 #if DEBUGGING
1087             ap_log_error(APLOG_MARK, APLOG_STARTUP, 0, NULL,
1088                          "Parsed host %s", New->name);
1089 #endif
1090         }
1091         else {
1092             ap_proxy_is_word(New, parms->pool);
1093 #if DEBUGGING
1094             fprintf(stderr, "Parsed word %s\n", New->name);
1095 #endif
1096         }
1097     }
1098     return NULL;
1099 }
1100
1101 static const char *
1102     set_proxy_domain(cmd_parms *parms, void *dummy, const char *arg)
1103 {
1104     proxy_server_conf *psf =
1105     ap_get_module_config(parms->server->module_config, &proxy_module);
1106
1107     if (arg[0] != '.')
1108         return "ProxyDomain: domain name must start with a dot.";
1109
1110     psf->domain = arg;
1111     return NULL;
1112 }
1113
1114 static const char *
1115     set_proxy_req(cmd_parms *parms, void *dummy, int flag)
1116 {
1117     const char *err;
1118     proxy_server_conf *psf =
1119     ap_get_module_config(parms->server->module_config, &proxy_module);
1120
1121     psf->req = flag;
1122     psf->req_set = 1;
1123
1124     if (flag) {
1125         /* Add default forward proxy worker */
1126         if ((err = ap_proxy_add_worker(&(psf->forward), parms->pool,
1127                                        psf, "*://*:0"))) {
1128             return apr_pstrcat(parms->temp_pool, "ProxyRequests ", err, NULL);
1129         }
1130
1131         /* Do not disable worker in case of errors */
1132         psf->forward->status = PROXY_WORKER_IGNORE_ERRORS;
1133     }
1134     return NULL;
1135 }
1136
1137 static const char *
1138     set_proxy_error_override(cmd_parms *parms, void *dummy, int flag)
1139 {
1140     proxy_server_conf *psf =
1141     ap_get_module_config(parms->server->module_config, &proxy_module);
1142
1143     psf->error_override = flag;
1144     psf->error_override_set = 1;
1145     return NULL;
1146 }
1147 static const char *
1148     set_preserve_host(cmd_parms *parms, void *dummy, int flag)
1149 {
1150     proxy_server_conf *psf =
1151     ap_get_module_config(parms->server->module_config, &proxy_module);
1152
1153     psf->preserve_host = flag;
1154     psf->preserve_host_set = 1;
1155     return NULL;
1156 }
1157
1158 static const char *
1159     set_recv_buffer_size(cmd_parms *parms, void *dummy, const char *arg)
1160 {
1161     proxy_server_conf *psf =
1162     ap_get_module_config(parms->server->module_config, &proxy_module);
1163     int s = atoi(arg);
1164     if (s < 512 && s != 0) {
1165         return "ProxyReceiveBufferSize must be >= 512 bytes, or 0 for system default.";
1166     }
1167
1168     psf->recv_buffer_size = s;
1169     psf->recv_buffer_size_set = 1;
1170     return NULL;
1171 }
1172
1173 static const char *
1174     set_io_buffer_size(cmd_parms *parms, void *dummy, const char *arg)
1175 {
1176     proxy_server_conf *psf =
1177     ap_get_module_config(parms->server->module_config, &proxy_module);
1178     long s = atol(arg);
1179
1180     psf->io_buffer_size = ((s > AP_IOBUFSIZE) ? s : AP_IOBUFSIZE);
1181     psf->io_buffer_size_set = 1;
1182     return NULL;
1183 }
1184
1185 static const char *
1186     set_max_forwards(cmd_parms *parms, void *dummy, const char *arg)
1187 {
1188     proxy_server_conf *psf =
1189     ap_get_module_config(parms->server->module_config, &proxy_module);
1190     long s = atol(arg);
1191     if (s < 0) {
1192         return "ProxyMaxForwards must be greater or equal to zero..";
1193     }
1194
1195     psf->maxfwd = s;
1196     psf->maxfwd_set = 1;
1197     return NULL;
1198 }
1199 static const char*
1200     set_proxy_timeout(cmd_parms *parms, void *dummy, const char *arg)
1201 {
1202     proxy_server_conf *psf =
1203     ap_get_module_config(parms->server->module_config, &proxy_module);
1204     int timeout;
1205
1206     timeout=atoi(arg);
1207     if (timeout<1) {
1208         return "Proxy Timeout must be at least 1 second.";
1209     }
1210     psf->timeout_set=1;
1211     psf->timeout=apr_time_from_sec(timeout);
1212
1213     return NULL;
1214 }
1215
1216 static const char*
1217     set_via_opt(cmd_parms *parms, void *dummy, const char *arg)
1218 {
1219     proxy_server_conf *psf =
1220     ap_get_module_config(parms->server->module_config, &proxy_module);
1221
1222     if (strcasecmp(arg, "Off") == 0)
1223         psf->viaopt = via_off;
1224     else if (strcasecmp(arg, "On") == 0)
1225         psf->viaopt = via_on;
1226     else if (strcasecmp(arg, "Block") == 0)
1227         psf->viaopt = via_block;
1228     else if (strcasecmp(arg, "Full") == 0)
1229         psf->viaopt = via_full;
1230     else {
1231         return "ProxyVia must be one of: "
1232             "off | on | full | block";
1233     }
1234
1235     psf->viaopt_set = 1;
1236     return NULL;
1237 }
1238
1239 static const char*
1240     set_bad_opt(cmd_parms *parms, void *dummy, const char *arg)
1241 {
1242     proxy_server_conf *psf =
1243     ap_get_module_config(parms->server->module_config, &proxy_module);
1244
1245     if (strcasecmp(arg, "IsError") == 0)
1246         psf->badopt = bad_error;
1247     else if (strcasecmp(arg, "Ignore") == 0)
1248         psf->badopt = bad_ignore;
1249     else if (strcasecmp(arg, "StartBody") == 0)
1250         psf->badopt = bad_body;
1251     else {
1252         return "ProxyBadHeader must be one of: "
1253             "IsError | Ignore | StartBody";
1254     }
1255
1256     psf->badopt_set = 1;
1257     return NULL;
1258 }
1259
1260 static const char*
1261     set_status_opt(cmd_parms *parms, void *dummy, const char *arg)
1262 {
1263     proxy_server_conf *psf =
1264     ap_get_module_config(parms->server->module_config, &proxy_module);
1265
1266     if (strcasecmp(arg, "Off") == 0)
1267         psf->proxy_status = status_off;
1268     else if (strcasecmp(arg, "On") == 0)
1269         psf->proxy_status = status_on;
1270     else if (strcasecmp(arg, "Full") == 0)
1271         psf->proxy_status = status_full;
1272     else {
1273         return "ProxyStatus must be one of: "
1274             "off | on | block";
1275     }
1276
1277     psf->proxy_status_set = 1;
1278     return NULL;
1279 }
1280
1281 static const char *add_member(cmd_parms *cmd, void *dummy, const char *arg)
1282 {
1283     server_rec *s = cmd->server;
1284     proxy_server_conf *conf =
1285     ap_get_module_config(s->module_config, &proxy_module);
1286     proxy_balancer *balancer;
1287     proxy_worker *worker;
1288     char *path = cmd->path;
1289     char *name = NULL;
1290     char *word;
1291     apr_table_t *params = apr_table_make(cmd->pool, 5);
1292     const apr_array_header_t *arr;
1293     const apr_table_entry_t *elts;
1294     int i;
1295
1296     if (cmd->path)
1297         path = apr_pstrdup(cmd->pool, cmd->path);
1298     while (*arg) {
1299         word = ap_getword_conf(cmd->pool, &arg);
1300         if (!path)
1301             path = word;
1302         else if (!name)
1303             name = word;
1304         else {
1305             char *val = strchr(word, '=');
1306             if (!val)
1307                 if (cmd->path)
1308                     return "BalancerMember can not have a balancer name when defined in a location";
1309                 else
1310                     return "Invalid BalancerMember parameter. Parameter must "
1311                            "be in the form 'key=value'";
1312             else
1313                 *val++ = '\0';
1314             apr_table_setn(params, word, val);
1315         }
1316     }
1317     if (!path)
1318         return "BalancerMember must define balancer name when outside <Proxy > section";
1319     if (!name)
1320         return "BalancerMember must define remote proxy server";
1321
1322     ap_str_tolower(path);   /* lowercase scheme://hostname */
1323     ap_str_tolower(name);   /* lowercase scheme://hostname */
1324
1325     /* Try to find existing worker */
1326     worker = ap_proxy_get_worker(cmd->temp_pool, conf, name);
1327     if (!worker) {
1328         const char *err;
1329         if ((err = ap_proxy_add_worker(&worker, cmd->pool, conf, name)) != NULL)
1330             return apr_pstrcat(cmd->temp_pool, "BalancerMember ", err, NULL);
1331     }
1332     PROXY_COPY_CONF_PARAMS(worker, conf);
1333
1334     arr = apr_table_elts(params);
1335     elts = (const apr_table_entry_t *)arr->elts;
1336     for (i = 0; i < arr->nelts; i++) {
1337         const char *err = set_worker_param(cmd->pool, worker, elts[i].key,
1338                                            elts[i].val);
1339         if (err)
1340             return apr_pstrcat(cmd->temp_pool, "BalancerMember ", err, NULL);
1341     }
1342     /* Try to find the balancer */
1343     balancer = ap_proxy_get_balancer(cmd->temp_pool, conf, path);
1344     if (!balancer) {
1345         const char *err = ap_proxy_add_balancer(&balancer,
1346                                                 cmd->pool,
1347                                                 conf, path);
1348         if (err)
1349             return apr_pstrcat(cmd->temp_pool, "BalancerMember ", err, NULL);
1350     }
1351     /* Add the worker to the load balancer */
1352     ap_proxy_add_worker_to_balancer(cmd->pool, balancer, worker);
1353     return NULL;
1354 }
1355
1356 static const char *
1357     set_proxy_param(cmd_parms *cmd, void *dummy, const char *arg)
1358 {
1359     server_rec *s = cmd->server;
1360     proxy_server_conf *conf =
1361     (proxy_server_conf *) ap_get_module_config(s->module_config, &proxy_module);
1362     char *name = NULL;
1363     char *word, *val;
1364     proxy_balancer *balancer = NULL;
1365     proxy_worker *worker = NULL;
1366     const char *err;
1367
1368     if (cmd->directive->parent &&
1369         strncasecmp(cmd->directive->parent->directive,
1370                     "<Proxy", 6) == 0) {
1371         const char *pargs = cmd->directive->parent->args;
1372         /* Directive inside <Proxy section
1373          * Parent directive arg is the worker/balancer name.
1374          */
1375         name = ap_getword_conf(cmd->temp_pool, &pargs);
1376         if ((word = ap_strchr(name, '>')))
1377             *word = '\0';
1378     }
1379     else {
1380         /* Standard set directive with worker/balancer
1381          * name as first param.
1382          */
1383         name = ap_getword_conf(cmd->temp_pool, &arg);
1384     }
1385
1386     if (strncasecmp(name, "balancer:", 9) == 0) {
1387         balancer = ap_proxy_get_balancer(cmd->pool, conf, name);
1388         if (!balancer) {
1389             return apr_pstrcat(cmd->temp_pool, "ProxySet can not find '",
1390                                name, "' Balancer.", NULL);
1391         }
1392     }
1393     else {
1394         worker = ap_proxy_get_worker(cmd->temp_pool, conf, name);
1395         if (!worker) {
1396             return apr_pstrcat(cmd->temp_pool, "ProxySet can not find '",
1397                                name, "' Worker.", NULL);
1398         }
1399     }
1400
1401     while (*arg) {
1402         word = ap_getword_conf(cmd->pool, &arg);
1403         val = strchr(word, '=');
1404         if (!val) {
1405             return "Invalid ProxySet parameter. Parameter must be "
1406                    "in the form 'key=value'";
1407         }
1408         else
1409             *val++ = '\0';
1410         if (worker)
1411             err = set_worker_param(cmd->pool, worker, word, val);
1412         else
1413             err = set_balancer_param(cmd->pool, balancer, word, val);
1414
1415         if (err)
1416             return apr_pstrcat(cmd->temp_pool, "ProxySet ", err, " ", word, " ", name, NULL);
1417     }
1418
1419     return NULL;
1420 }
1421
1422 static void ap_add_per_proxy_conf(server_rec *s, ap_conf_vector_t *dir_config)
1423 {
1424     proxy_server_conf *sconf = ap_get_module_config(s->module_config,
1425                                                     &proxy_module);
1426     void **new_space = (void **)apr_array_push(sconf->sec_proxy);
1427
1428     *new_space = dir_config;
1429 }
1430
1431 static const char *proxysection(cmd_parms *cmd, void *mconfig, const char *arg)
1432 {
1433     const char *errmsg;
1434     const char *endp = ap_strrchr_c(arg, '>');
1435     int old_overrides = cmd->override;
1436     char *old_path = cmd->path;
1437     proxy_dir_conf *conf;
1438     ap_conf_vector_t *new_dir_conf = ap_create_per_dir_config(cmd->pool);
1439     regex_t *r = NULL;
1440     const command_rec *thiscmd = cmd->cmd;
1441
1442     const char *err = ap_check_cmd_context(cmd,
1443                                            NOT_IN_DIR_LOC_FILE|NOT_IN_LIMIT);
1444     if (err != NULL) {
1445         return err;
1446     }
1447
1448     if (endp == NULL) {
1449         return apr_pstrcat(cmd->pool, cmd->cmd->name,
1450                            "> directive missing closing '>'", NULL);
1451     }
1452
1453     arg=apr_pstrndup(cmd->pool, arg, endp-arg);
1454
1455     if (!arg) {
1456         if (thiscmd->cmd_data)
1457             return "<ProxyMatch > block must specify a path";
1458         else
1459             return "<Proxy > block must specify a path";
1460     }
1461
1462     cmd->path = ap_getword_conf(cmd->pool, &arg);
1463     cmd->override = OR_ALL|ACCESS_CONF;
1464
1465     if (!strncasecmp(cmd->path, "proxy:", 6))
1466         cmd->path += 6;
1467
1468     /* XXX Ignore case?  What if we proxy a case-insensitive server?!?
1469      * While we are at it, shouldn't we also canonicalize the entire
1470      * scheme?  See proxy_fixup()
1471      */
1472     if (thiscmd->cmd_data) { /* <ProxyMatch> */
1473         r = ap_pregcomp(cmd->pool, cmd->path, REG_EXTENDED);
1474         if (!r) {
1475             return "Regex could not be compiled";
1476         }
1477     }
1478     else if (!strcmp(cmd->path, "~")) {
1479         cmd->path = ap_getword_conf(cmd->pool, &arg);
1480         if (!cmd->path)
1481             return "<Proxy ~ > block must specify a path";
1482         if (strncasecmp(cmd->path, "proxy:", 6))
1483             cmd->path += 6;
1484         r = ap_pregcomp(cmd->pool, cmd->path, REG_EXTENDED);
1485         if (!r) {
1486             return "Regex could not be compiled";
1487         }
1488     }
1489
1490     /* initialize our config and fetch it */
1491     conf = ap_set_config_vectors(cmd->server, new_dir_conf, cmd->path,
1492                                  &proxy_module, cmd->pool);
1493
1494     errmsg = ap_walk_config(cmd->directive->first_child, cmd, new_dir_conf);
1495     if (errmsg != NULL)
1496         return errmsg;
1497
1498     conf->r = r;
1499     conf->p = cmd->path;
1500     conf->p_is_fnmatch = apr_fnmatch_test(conf->p);
1501
1502     ap_add_per_proxy_conf(cmd->server, new_dir_conf);
1503
1504     if (*arg != '\0') {
1505         return apr_pstrcat(cmd->pool, "Multiple ", thiscmd->name,
1506                            "> arguments not (yet) supported.", NULL);
1507     }
1508
1509     cmd->path = old_path;
1510     cmd->override = old_overrides;
1511
1512     return NULL;
1513 }
1514
1515 static const command_rec proxy_cmds[] =
1516 {
1517     AP_INIT_RAW_ARGS("<Proxy", proxysection, NULL, RSRC_CONF,
1518     "Container for directives affecting resources located in the proxied "
1519     "location"),
1520     AP_INIT_RAW_ARGS("<ProxyMatch", proxysection, (void*)1, RSRC_CONF,
1521     "Container for directives affecting resources located in the proxied "
1522     "location, in regular expression syntax"),
1523     AP_INIT_FLAG("ProxyRequests", set_proxy_req, NULL, RSRC_CONF,
1524      "on if the true proxy requests should be accepted"),
1525     AP_INIT_TAKE2("ProxyRemote", add_proxy_noregex, NULL, RSRC_CONF,
1526      "a scheme, partial URL or '*' and a proxy server"),
1527     AP_INIT_TAKE2("ProxyRemoteMatch", add_proxy_regex, NULL, RSRC_CONF,
1528      "a regex pattern and a proxy server"),
1529     AP_INIT_RAW_ARGS("ProxyPass", add_pass, NULL, RSRC_CONF|ACCESS_CONF,
1530      "a virtual path and a URL"),
1531     AP_INIT_TAKE12("ProxyPassReverse", add_pass_reverse, NULL, RSRC_CONF|ACCESS_CONF,
1532      "a virtual path and a URL for reverse proxy behaviour"),
1533     AP_INIT_TAKE2("ProxyPassReverseCookiePath", cookie_path, NULL,
1534        RSRC_CONF|ACCESS_CONF, "Path rewrite rule for proxying cookies"),
1535     AP_INIT_TAKE2("ProxyPassReverseCookieDomain", cookie_domain, NULL,
1536        RSRC_CONF|ACCESS_CONF, "Domain rewrite rule for proxying cookies"),
1537     AP_INIT_ITERATE("ProxyBlock", set_proxy_exclude, NULL, RSRC_CONF,
1538      "A list of names, hosts or domains to which the proxy will not connect"),
1539     AP_INIT_TAKE1("ProxyReceiveBufferSize", set_recv_buffer_size, NULL, RSRC_CONF,
1540      "Receive buffer size for outgoing HTTP and FTP connections in bytes"),
1541     AP_INIT_TAKE1("ProxyIOBufferSize", set_io_buffer_size, NULL, RSRC_CONF,
1542      "IO buffer size for outgoing HTTP and FTP connections in bytes"),
1543     AP_INIT_TAKE1("ProxyMaxForwards", set_max_forwards, NULL, RSRC_CONF,
1544      "The maximum number of proxies a request may be forwarded through."),
1545     AP_INIT_ITERATE("NoProxy", set_proxy_dirconn, NULL, RSRC_CONF,
1546      "A list of domains, hosts, or subnets to which the proxy will connect directly"),
1547     AP_INIT_TAKE1("ProxyDomain", set_proxy_domain, NULL, RSRC_CONF,
1548      "The default intranet domain name (in absence of a domain in the URL)"),
1549     AP_INIT_ITERATE("AllowCONNECT", set_allowed_ports, NULL, RSRC_CONF,
1550      "A list of ports which CONNECT may connect to"),
1551     AP_INIT_TAKE1("ProxyVia", set_via_opt, NULL, RSRC_CONF,
1552      "Configure Via: proxy header header to one of: on | off | block | full"),
1553     AP_INIT_FLAG("ProxyErrorOverride", set_proxy_error_override, NULL, RSRC_CONF,
1554      "use our error handling pages instead of the servers' we are proxying"),
1555     AP_INIT_FLAG("ProxyPreserveHost", set_preserve_host, NULL, RSRC_CONF,
1556      "on if we should preserve host header while proxying"),
1557     AP_INIT_TAKE1("ProxyTimeout", set_proxy_timeout, NULL, RSRC_CONF,
1558      "Set the timeout (in seconds) for a proxied connection. "
1559      "This overrides the server timeout"),
1560     AP_INIT_TAKE1("ProxyBadHeader", set_bad_opt, NULL, RSRC_CONF,
1561      "How to handle bad header line in response: IsError | Ignore | StartBody"),
1562     AP_INIT_RAW_ARGS("BalancerMember", add_member, NULL, RSRC_CONF|ACCESS_CONF,
1563      "A balancer name and scheme with list of params"),
1564     AP_INIT_TAKE1("ProxyStatus", set_status_opt, NULL, RSRC_CONF,
1565      "Configure Status: proxy status to one of: on | off | full"),
1566     AP_INIT_RAW_ARGS("ProxySet", set_proxy_param, NULL, RSRC_CONF|ACCESS_CONF,
1567      "A balancer or worker name with list of params"),
1568     {NULL}
1569 };
1570
1571 static APR_OPTIONAL_FN_TYPE(ssl_proxy_enable) *proxy_ssl_enable = NULL;
1572 static APR_OPTIONAL_FN_TYPE(ssl_engine_disable) *proxy_ssl_disable = NULL;
1573
1574 PROXY_DECLARE(int) ap_proxy_ssl_enable(conn_rec *c)
1575 {
1576     /*
1577      * if c == NULL just check if the optional function was imported
1578      * else run the optional function so ssl filters are inserted
1579      */
1580     if (proxy_ssl_enable) {
1581         return c ? proxy_ssl_enable(c) : 1;
1582     }
1583
1584     return 0;
1585 }
1586
1587 PROXY_DECLARE(int) ap_proxy_ssl_disable(conn_rec *c)
1588 {
1589     if (proxy_ssl_disable) {
1590         return proxy_ssl_disable(c);
1591     }
1592
1593     return 0;
1594 }
1595
1596 static int proxy_post_config(apr_pool_t *pconf, apr_pool_t *plog,
1597                              apr_pool_t *ptemp, server_rec *s)
1598 {
1599     proxy_server_conf *conf =
1600     (proxy_server_conf *) ap_get_module_config(s->module_config, &proxy_module);
1601     proxy_worker *worker;
1602     int i;
1603
1604     proxy_ssl_enable = APR_RETRIEVE_OPTIONAL_FN(ssl_proxy_enable);
1605     proxy_ssl_disable = APR_RETRIEVE_OPTIONAL_FN(ssl_engine_disable);
1606
1607     /* Initialize all the workers */
1608     worker = (proxy_worker *)conf->workers->elts;
1609     for (i = 0; i < conf->workers->nelts; i++) {
1610         ap_proxy_initialize_worker(worker, s);
1611         worker++;
1612     }
1613
1614     ap_proxy_initialize_worker(conf->forward, s);
1615
1616     return OK;
1617 }
1618
1619
1620 #define KBYTE 1024
1621 #define MBYTE 1048576L
1622 #define GBYTE 1073741824L
1623
1624 /* Format the number of bytes nicely */
1625 static void format_byte_out(request_rec *r, apr_off_t bytes)
1626 {
1627
1628     if (bytes < (5 * KBYTE))
1629         ap_rprintf(r, "%d B", (int) bytes);
1630     else if (bytes < (MBYTE / 2))
1631         ap_rprintf(r, "%.1f kB", (float) bytes / KBYTE);
1632     else if (bytes < (GBYTE / 2))
1633         ap_rprintf(r, "%.1f MB", (float) bytes / MBYTE);
1634     else
1635         ap_rprintf(r, "%.1f GB", (float) bytes / GBYTE);
1636 }
1637
1638 /*
1639  *  proxy Extension to mod_status
1640  */
1641 static int proxy_status_hook(request_rec *r, int flags)
1642 {
1643     int i, n;
1644     void *sconf = r->server->module_config;
1645     proxy_server_conf *conf = (proxy_server_conf *)
1646         ap_get_module_config(sconf, &proxy_module);
1647     proxy_balancer *balancer = NULL;
1648     proxy_runtime_worker *worker = NULL;
1649
1650     if (flags & AP_STATUS_SHORT || conf->balancers->nelts == 0 ||
1651         conf->proxy_status == status_off)
1652         return OK;
1653
1654     balancer = (proxy_balancer *)conf->balancers->elts;
1655     for (i = 0; i < conf->balancers->nelts; i++) {
1656         ap_rputs("<hr />\n<h1>Proxy LoadBalancer Status for ", r);
1657         ap_rvputs(r, balancer->name, "</h1>\n\n", NULL);
1658         ap_rputs("\n\n<table border=\"0\"><tr>"
1659                  "<th>SSes</th><th>Timeout</th>"
1660                  "</tr>\n<tr>", r);
1661         ap_rvputs(r, "<td>", balancer->sticky, NULL);
1662         ap_rprintf(r, "</td><td>%" APR_TIME_T_FMT "</td>\n",
1663                    apr_time_sec(balancer->timeout));
1664         ap_rputs("</table>\n", r);
1665         ap_rputs("\n\n<table border=\"0\"><tr>"
1666                  "<th>Sch</th><th>Host</th>"
1667                  "<th>Route</th><th>Redir</th>"
1668                  "<th>F</th><th>Acc</th><th>Wr</th><th>Rd</th>"
1669                  "</tr>\n", r);
1670
1671         worker = (proxy_runtime_worker *)balancer->workers->elts;
1672         for (n = 0; n < balancer->workers->nelts; n++) {
1673
1674             ap_rvputs(r, "<tr>\n<td>", worker->w->scheme, "</td>", NULL);
1675             ap_rvputs(r, "<td>", worker->w->hostname, "</td>", NULL);
1676             ap_rvputs(r, "<td>", worker->w->route, NULL);
1677             ap_rvputs(r, "</td><td>", worker->w->redirect, NULL);
1678             ap_rprintf(r, "</td><td>%.2f</td>", worker->s->lbfactor);
1679             ap_rprintf(r, "<td>%d</td><td>", (int)(worker->s->elected));
1680             format_byte_out(r, worker->s->transfered);
1681             ap_rputs("</td><td>", r);
1682             format_byte_out(r, worker->s->transfered);
1683             ap_rputs("</td>\n", r);
1684
1685             /* TODO: Add the rest of dynamic worker data */
1686             ap_rputs("</tr>\n", r);
1687
1688             ++worker;
1689         }
1690         ap_rputs("</table>\n", r);
1691         ++balancer;
1692     }
1693     ap_rputs("<hr /><table>\n"
1694              "<tr><th>SSes</th><td>Sticky session name</td></tr>\n"
1695              "<tr><th>Timeout</th><td>Balancer Timeout</td></tr>\n"
1696              "<tr><th>Sch</th><td>Connection scheme</td></tr>\n"
1697              "<tr><th>Host</th><td>Backend Hostname</td></tr>\n"
1698              "<tr><th>Route</th><td>Session Route</td></tr>\n"
1699              "<tr><th>Redir</th><td>Session Route Redirection</td></tr>\n"
1700              "<tr><th>F</th><td>Load Balancer Factor in %</td></tr>\n"
1701              "<tr><th>Acc</th><td>Number of requests</td></tr>\n"
1702              "<tr><th>Wr</th><td>Number of bytes transfered</td></tr>\n"
1703              "<tr><th>Rd</th><td>Number of bytes readed</td></tr>\n"
1704              "</table>", r);
1705
1706     return OK;
1707 }
1708
1709 /*
1710  * This routine is called before the server processes the configuration
1711  * files.  There is no return value.
1712  */
1713 static int proxy_pre_config(apr_pool_t *pconf, apr_pool_t *plog,
1714                             apr_pool_t *ptemp)
1715 {
1716     APR_OPTIONAL_HOOK(ap, status_hook, proxy_status_hook, NULL, NULL,
1717                       APR_HOOK_MIDDLE);
1718     return OK;
1719 }
1720
1721 static void register_hooks(apr_pool_t *p)
1722 {
1723     /* fixup before mod_rewrite, so that the proxied url will not
1724      * escaped accidentally by our fixup.
1725      */
1726 #ifndef FIX_15207
1727     static const char * const aszSucc[]={ "mod_rewrite.c", NULL };
1728 #endif
1729
1730     /* handler */
1731     ap_hook_handler(proxy_handler, NULL, NULL, APR_HOOK_FIRST);
1732     /* filename-to-URI translation */
1733     ap_hook_translate_name(proxy_trans, NULL, NULL, APR_HOOK_FIRST);
1734     /* walk <Proxy > entries and suppress default TRACE behavior */
1735     ap_hook_map_to_storage(proxy_map_location, NULL,NULL, APR_HOOK_FIRST);
1736 #ifndef FIX_15207
1737     /* fixups */
1738     ap_hook_fixups(proxy_fixup, NULL, aszSucc, APR_HOOK_FIRST);
1739 #endif
1740     /* post read_request handling */
1741     ap_hook_post_read_request(proxy_detect, NULL, NULL, APR_HOOK_FIRST);
1742     /* pre config handling */
1743     ap_hook_pre_config(proxy_pre_config, NULL, NULL, APR_HOOK_MIDDLE);
1744     /* post config handling */
1745     ap_hook_post_config(proxy_post_config, NULL, NULL, APR_HOOK_MIDDLE);
1746 }
1747
1748 module AP_MODULE_DECLARE_DATA proxy_module =
1749 {
1750     STANDARD20_MODULE_STUFF,
1751     create_proxy_dir_config,    /* create per-directory config structure */
1752     merge_proxy_dir_config,     /* merge per-directory config structures */
1753     create_proxy_config,        /* create per-server config structure */
1754     merge_proxy_config,         /* merge per-server config structures */
1755     proxy_cmds,                 /* command table */
1756     register_hooks
1757 };
1758
1759 APR_HOOK_STRUCT(
1760     APR_HOOK_LINK(scheme_handler)
1761     APR_HOOK_LINK(canon_handler)
1762     APR_HOOK_LINK(pre_request)
1763     APR_HOOK_LINK(post_request)
1764 )
1765
1766 APR_IMPLEMENT_EXTERNAL_HOOK_RUN_FIRST(proxy, PROXY, int, scheme_handler,
1767                                      (request_rec *r, proxy_worker *worker,
1768                                       proxy_server_conf *conf,
1769                                       char *url, const char *proxyhost,
1770                                       apr_port_t proxyport),(r,worker,conf,
1771                                       url,proxyhost,proxyport),DECLINED)
1772 APR_IMPLEMENT_EXTERNAL_HOOK_RUN_FIRST(proxy, PROXY, int, canon_handler,
1773                                       (request_rec *r, char *url),(r,
1774                                       url),DECLINED)
1775 APR_IMPLEMENT_EXTERNAL_HOOK_RUN_FIRST(proxy, PROXY, int, pre_request, (
1776                                       proxy_worker **worker,
1777                                       proxy_balancer **balancer,
1778                                       request_rec *r,
1779                                       proxy_server_conf *conf,
1780                                       char **url),(worker,balancer,
1781                                       r,conf,url),DECLINED)
1782 APR_IMPLEMENT_EXTERNAL_HOOK_RUN_FIRST(proxy, PROXY, int, post_request,
1783                                       (proxy_worker *worker,
1784                                        proxy_balancer *balancer,
1785                                        request_rec *r,
1786                                        proxy_server_conf *conf),(worker,
1787                                        balancer,r,conf),DECLINED)
1788 APR_IMPLEMENT_OPTIONAL_HOOK_RUN_ALL(proxy, PROXY, int, fixups,
1789                                     (request_rec *r), (r),
1790                                     OK, DECLINED)