granicus.if.org Git - apache/blob - modules/filters/mod_ext_filter.c

   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 /*
  18  * mod_ext_filter allows Unix-style filters to filter http content.
  19  */
  20
  21 #include "httpd.h"
  22 #include "http_config.h"
  23 #include "http_log.h"
  24 #include "http_protocol.h"
  25
  26 #include "http_core.h"
  27 #include "apr_buckets.h"
  28 #include "util_filter.h"
  29 #include "util_script.h"
  30 #include "util_time.h"
  31 #include "apr_strings.h"
  32 #include "apr_hash.h"
  33 #include "apr_lib.h"
  34 #include "apr_poll.h"
  35 #define APR_WANT_STRFUNC
  36 #include "apr_want.h"
  37
  38 typedef struct ef_server_t {
  39     apr_pool_t *p;
  40     apr_hash_t *h;
  41 } ef_server_t;
  42
  43 typedef struct ef_filter_t {
  44     const char *name;
  45     enum {INPUT_FILTER=1, OUTPUT_FILTER} mode;
  46     ap_filter_type ftype;
  47     const char *command;
  48     const char *enable_env;
  49     const char *disable_env;
  50     char **args;
  51     const char *intype;             /* list of IMTs we process (well, just one for now) */
  52 #define INTYPE_ALL (char *)1
  53     const char *outtype;            /* IMT of filtered output */
  54 #define OUTTYPE_UNCHANGED (char *)1
  55     int preserves_content_length;
  56 } ef_filter_t;
  57
  58 typedef struct ef_dir_t {
  59     int log_stderr;
  60     int onfail;
  61 } ef_dir_t;
  62
  63 typedef struct ef_ctx_t {
  64     apr_pool_t *p;
  65     apr_proc_t *proc;
  66     apr_procattr_t *procattr;
  67     ef_dir_t *dc;
  68     ef_filter_t *filter;
  69     int noop;
  70 #if APR_FILES_AS_SOCKETS
  71     apr_pollset_t *pollset;
  72 #endif
  73 } ef_ctx_t;
  74
  75 module AP_MODULE_DECLARE_DATA ext_filter_module;
  76 static const server_rec *main_server;
  77
  78 static apr_status_t ef_output_filter(ap_filter_t *, apr_bucket_brigade *);
  79 static apr_status_t ef_input_filter(ap_filter_t *, apr_bucket_brigade *,
  80                                     ap_input_mode_t, apr_read_type_e,
  81                                     apr_off_t);
  82
  83 #define ERRFN_USERDATA_KEY         "EXTFILTCHILDERRFN"
  84
  85 static void *create_ef_dir_conf(apr_pool_t *p, char *dummy)
  86 {
  87     ef_dir_t *dc = (ef_dir_t *)apr_pcalloc(p, sizeof(ef_dir_t));
  88
  89     dc->log_stderr = -1;
  90     dc->onfail = -1;
  91
  92     return dc;
  93 }
  94
  95 static void *create_ef_server_conf(apr_pool_t *p, server_rec *s)
  96 {
  97     ef_server_t *conf;
  98
  99     conf = (ef_server_t *)apr_pcalloc(p, sizeof(ef_server_t));
 100     conf->p = p;
 101     conf->h = apr_hash_make(conf->p);
 102     return conf;
 103 }
 104
 105 static void *merge_ef_dir_conf(apr_pool_t *p, void *basev, void *overridesv)
 106 {
 107     ef_dir_t *a = (ef_dir_t *)apr_pcalloc (p, sizeof(ef_dir_t));
 108     ef_dir_t *base = (ef_dir_t *)basev, *over = (ef_dir_t *)overridesv;
 109
 110     if (over->log_stderr != -1) {   /* if admin coded something... */
 111         a->log_stderr = over->log_stderr;
 112     }
 113     else {
 114         a->log_stderr = base->log_stderr;
 115     }
 116
 117     if (over->onfail != -1) {   /* if admin coded something... */
 118         a->onfail = over->onfail;
 119     }
 120     else {
 121         a->onfail = base->onfail;
 122     }
 123
 124     return a;
 125 }
 126
 127 static const char *add_options(cmd_parms *cmd, void *in_dc,
 128                                const char *arg)
 129 {
 130     ef_dir_t *dc = in_dc;
 131
 132     if (!strcasecmp(arg, "LogStderr")) {
 133         dc->log_stderr = 1;
 134     }
 135     else if (!strcasecmp(arg, "NoLogStderr")) {
 136         dc->log_stderr = 0;
 137     }
 138     else if (!strcasecmp(arg, "Onfail=remove")) {
 139         dc->onfail = 1;
 140     }
 141     else if (!strcasecmp(arg, "Onfail=abort")) {
 142         dc->onfail = 0;
 143     }
 144     else {
 145         return apr_pstrcat(cmd->temp_pool,
 146                            "Invalid ExtFilterOptions option: ",
 147                            arg,
 148                            NULL);
 149     }
 150
 151     return NULL;
 152 }
 153
 154 static const char *parse_cmd(apr_pool_t *p, const char **args, ef_filter_t *filter)
 155 {
 156     if (**args == '"') {
 157         const char *start = *args + 1;
 158         char *parms;
 159         int escaping = 0;
 160         apr_status_t rv;
 161
 162         ++*args; /* move past leading " */
 163         /* find true end of args string (accounting for escaped quotes) */
 164         while (**args && (**args != '"' || (**args == '"' && escaping))) {
 165             if (escaping) {
 166                 escaping = 0;
 167             }
 168             else if (**args == '\\') {
 169                 escaping = 1;
 170             }
 171             ++*args;
 172         }
 173         if (**args != '"') {
 174             return "Expected cmd= delimiter";
 175         }
 176         /* copy *just* the arg string for parsing, */
 177         parms = apr_pstrndup(p, start, *args - start);
 178         ++*args; /* move past trailing " */
 179
 180         /* parse and tokenize the args. */
 181         rv = apr_tokenize_to_argv(parms, &(filter->args), p);
 182         if (rv != APR_SUCCESS) {
 183             return "cmd= parse error";
 184         }
 185     }
 186     else
 187     {
 188         /* simple path */
 189         /* Allocate space for two argv pointers and parse the args. */
 190         filter->args = (char **)apr_palloc(p, 2 * sizeof(char *));
 191         filter->args[0] = ap_getword_white(p, args);
 192         filter->args[1] = NULL; /* end of args */
 193     }
 194     if (!filter->args[0]) {
 195         return "Invalid cmd= parameter";
 196     }
 197     filter->command = filter->args[0];
 198
 199     return NULL;
 200 }
 201
 202 static const char *define_filter(cmd_parms *cmd, void *dummy, const char *args)
 203 {
 204     ef_server_t *conf = ap_get_module_config(cmd->server->module_config,
 205                                              &ext_filter_module);
 206     const char *token;
 207     const char *name;
 208     char *normalized_name;
 209     ef_filter_t *filter;
 210
 211     name = ap_getword_white(cmd->pool, &args);
 212     if (!name) {
 213         return "Filter name not found";
 214     }
 215
 216     /* During request processing, we find information about the filter
 217      * by looking up the filter name provided by core server in our
 218      * hash table.  But the core server has normalized the filter
 219      * name by converting it to lower case.  Thus, when adding the
 220      * filter to our hash table we have to use lower case as well.
 221      */
 222     normalized_name = apr_pstrdup(cmd->pool, name);
 223     ap_str_tolower(normalized_name);
 224
 225     if (apr_hash_get(conf->h, normalized_name, APR_HASH_KEY_STRING)) {
 226         return apr_psprintf(cmd->pool, "ExtFilter %s is already defined",
 227                             name);
 228     }
 229
 230     filter = (ef_filter_t *)apr_pcalloc(conf->p, sizeof(ef_filter_t));
 231     filter->name = name;
 232     filter->mode = OUTPUT_FILTER;
 233     filter->ftype = AP_FTYPE_RESOURCE;
 234     apr_hash_set(conf->h, normalized_name, APR_HASH_KEY_STRING, filter);
 235
 236     while (*args) {
 237         while (apr_isspace(*args)) {
 238             ++args;
 239         }
 240
 241         /* Nasty parsing...  I wish I could simply use ap_getword_white()
 242          * here and then look at the token, but ap_getword_white() doesn't
 243          * do the right thing when we have cmd="word word word"
 244          */
 245         if (!strncasecmp(args, "preservescontentlength", 22)) {
 246             token = ap_getword_white(cmd->pool, &args);
 247             if (!strcasecmp(token, "preservescontentlength")) {
 248                 filter->preserves_content_length = 1;
 249             }
 250             else {
 251                 return apr_psprintf(cmd->pool,
 252                                     "mangled argument `%s'",
 253                                     token);
 254             }
 255             continue;
 256         }
 257
 258         if (!strncasecmp(args, "mode=", 5)) {
 259             args += 5;
 260             token = ap_getword_white(cmd->pool, &args);
 261             if (!strcasecmp(token, "output")) {
 262                 filter->mode = OUTPUT_FILTER;
 263             }
 264             else if (!strcasecmp(token, "input")) {
 265                 filter->mode = INPUT_FILTER;
 266             }
 267             else {
 268                 return apr_psprintf(cmd->pool, "Invalid mode: `%s'",
 269                                     token);
 270             }
 271             continue;
 272         }
 273
 274         if (!strncasecmp(args, "ftype=", 6)) {
 275             args += 6;
 276             token = ap_getword_white(cmd->pool, &args);
 277             filter->ftype = atoi(token);
 278             continue;
 279         }
 280
 281         if (!strncasecmp(args, "enableenv=", 10)) {
 282             args += 10;
 283             token = ap_getword_white(cmd->pool, &args);
 284             filter->enable_env = token;
 285             continue;
 286         }
 287
 288         if (!strncasecmp(args, "disableenv=", 11)) {
 289             args += 11;
 290             token = ap_getword_white(cmd->pool, &args);
 291             filter->disable_env = token;
 292             continue;
 293         }
 294
 295         if (!strncasecmp(args, "intype=", 7)) {
 296             args += 7;
 297             filter->intype = ap_getword_white(cmd->pool, &args);
 298             continue;
 299         }
 300
 301         if (!strncasecmp(args, "outtype=", 8)) {
 302             args += 8;
 303             filter->outtype = ap_getword_white(cmd->pool, &args);
 304             continue;
 305         }
 306
 307         if (!strncasecmp(args, "cmd=", 4)) {
 308             args += 4;
 309             if ((token = parse_cmd(cmd->pool, &args, filter))) {
 310                 return token;
 311             }
 312             continue;
 313         }
 314
 315         return apr_psprintf(cmd->pool, "Unexpected parameter: `%s'",
 316                             args);
 317     }
 318
 319     /* parsing is done...  register the filter
 320      */
 321     if (filter->mode == OUTPUT_FILTER) {
 322         /* XXX need a way to ensure uniqueness among all filters */
 323         ap_register_output_filter(filter->name, ef_output_filter, NULL, filter->ftype);
 324     }
 325     else if (filter->mode == INPUT_FILTER) {
 326         /* XXX need a way to ensure uniqueness among all filters */
 327         ap_register_input_filter(filter->name, ef_input_filter, NULL, filter->ftype);
 328     }
 329     else {
 330         ap_assert(1 != 1); /* we set the field wrong somehow */
 331     }
 332
 333     return NULL;
 334 }
 335
 336 static const command_rec cmds[] =
 337 {
 338     AP_INIT_ITERATE("ExtFilterOptions",
 339                     add_options,
 340                     NULL,
 341                     ACCESS_CONF, /* same as SetInputFilter/SetOutputFilter */
 342                     "valid options: LogStderr, NoLogStderr"),
 343     AP_INIT_RAW_ARGS("ExtFilterDefine",
 344                      define_filter,
 345                      NULL,
 346                      RSRC_CONF,
 347                      "Define an external filter"),
 348     {NULL}
 349 };
 350
 351 static int ef_init(apr_pool_t *p, apr_pool_t *plog, apr_pool_t *ptemp, server_rec *main_s)
 352 {
 353     main_server = main_s;
 354     return OK;
 355 }
 356
 357 static void register_hooks(apr_pool_t *p)
 358 {
 359     ap_hook_post_config(ef_init, NULL, NULL, APR_HOOK_MIDDLE);
 360 }
 361
 362 static apr_status_t set_resource_limits(request_rec *r,
 363                                         apr_procattr_t *procattr)
 364 {
 365 #if defined(RLIMIT_CPU)  || defined(RLIMIT_NPROC) || \
 366     defined(RLIMIT_DATA) || defined(RLIMIT_VMEM) || defined (RLIMIT_AS)
 367     core_dir_config *conf =
 368         (core_dir_config *)ap_get_core_module_config(r->per_dir_config);
 369     apr_status_t rv;
 370
 371 #ifdef RLIMIT_CPU
 372     rv = apr_procattr_limit_set(procattr, APR_LIMIT_CPU, conf->limit_cpu);
 373     ap_assert(rv == APR_SUCCESS); /* otherwise, we're out of sync with APR */
 374 #endif
 375 #if defined(RLIMIT_DATA) || defined(RLIMIT_VMEM) || defined(RLIMIT_AS)
 376     rv = apr_procattr_limit_set(procattr, APR_LIMIT_MEM, conf->limit_mem);
 377     ap_assert(rv == APR_SUCCESS); /* otherwise, we're out of sync with APR */
 378 #endif
 379 #ifdef RLIMIT_NPROC
 380     rv = apr_procattr_limit_set(procattr, APR_LIMIT_NPROC, conf->limit_nproc);
 381     ap_assert(rv == APR_SUCCESS); /* otherwise, we're out of sync with APR */
 382 #endif
 383
 384 #endif /* if at least one limit defined */
 385
 386     return APR_SUCCESS;
 387 }
 388
 389 static apr_status_t ef_close_file(void *vfile)
 390 {
 391     return apr_file_close(vfile);
 392 }
 393
 394 static void child_errfn(apr_pool_t *pool, apr_status_t err, const char *description)
 395 {
 396     request_rec *r;
 397     void *vr;
 398     apr_file_t *stderr_log;
 399     char errbuf[200];
 400     char time_str[APR_CTIME_LEN];
 401
 402     apr_pool_userdata_get(&vr, ERRFN_USERDATA_KEY, pool);
 403     r = vr;
 404     apr_file_open_stderr(&stderr_log, pool);
 405     ap_recent_ctime(time_str, apr_time_now());
 406     apr_file_printf(stderr_log,
 407                     "[%s] [client %s] mod_ext_filter (%d)%s: %s\n",
 408                     time_str,
 409                     r->useragent_ip,
 410                     err,
 411                     apr_strerror(err, errbuf, sizeof(errbuf)),
 412                     description);
 413 }
 414
 415 /* init_ext_filter_process: get the external filter process going
 416  * This is per-filter-instance (i.e., per-request) initialization.
 417  */
 418 static apr_status_t init_ext_filter_process(ap_filter_t *f)
 419 {
 420     ef_ctx_t *ctx = f->ctx;
 421     apr_status_t rc;
 422     ef_dir_t *dc = ctx->dc;
 423     const char * const *env;
 424
 425     ctx->proc = apr_pcalloc(ctx->p, sizeof(*ctx->proc));
 426
 427     rc = apr_procattr_create(&ctx->procattr, ctx->p);
 428     ap_assert(rc == APR_SUCCESS);
 429
 430     rc = apr_procattr_io_set(ctx->procattr,
 431                             APR_CHILD_BLOCK,
 432                             APR_CHILD_BLOCK,
 433                             APR_CHILD_BLOCK);
 434     ap_assert(rc == APR_SUCCESS);
 435
 436     rc = set_resource_limits(f->r, ctx->procattr);
 437     ap_assert(rc == APR_SUCCESS);
 438
 439     if (dc->log_stderr > 0) {
 440         rc = apr_procattr_child_err_set(ctx->procattr,
 441                                       f->r->server->error_log, /* stderr in child */
 442                                       NULL);
 443         ap_assert(rc == APR_SUCCESS);
 444     }
 445
 446     rc = apr_procattr_child_errfn_set(ctx->procattr, child_errfn);
 447     ap_assert(rc == APR_SUCCESS);
 448     apr_pool_userdata_set(f->r, ERRFN_USERDATA_KEY, apr_pool_cleanup_null, ctx->p);
 449
 450     rc = apr_procattr_error_check_set(ctx->procattr, 1);
 451     if (rc != APR_SUCCESS) {
 452         return rc;
 453     }
 454
 455     /* add standard CGI variables as well as DOCUMENT_URI, DOCUMENT_PATH_INFO,
 456      * and QUERY_STRING_UNESCAPED
 457      */
 458     ap_add_cgi_vars(f->r);
 459     ap_add_common_vars(f->r);
 460     apr_table_setn(f->r->subprocess_env, "DOCUMENT_URI", f->r->uri);
 461     apr_table_setn(f->r->subprocess_env, "DOCUMENT_PATH_INFO", f->r->path_info);
 462     if (f->r->args) {
 463             /* QUERY_STRING is added by ap_add_cgi_vars */
 464         char *arg_copy = apr_pstrdup(f->r->pool, f->r->args);
 465         ap_unescape_url(arg_copy);
 466         apr_table_setn(f->r->subprocess_env, "QUERY_STRING_UNESCAPED",
 467                        ap_escape_shell_cmd(f->r->pool, arg_copy));
 468     }
 469
 470     env = (const char * const *) ap_create_environment(ctx->p,
 471                                                        f->r->subprocess_env);
 472
 473     rc = apr_proc_create(ctx->proc,
 474                             ctx->filter->command,
 475                             (const char * const *)ctx->filter->args,
 476                             env, /* environment */
 477                             ctx->procattr,
 478                             ctx->p);
 479     if (rc != APR_SUCCESS) {
 480         ap_log_rerror(APLOG_MARK, APLOG_ERR, rc, f->r, APLOGNO(01458)
 481                       "couldn't create child process to run `%s'",
 482                       ctx->filter->command);
 483         return rc;
 484     }
 485
 486     apr_pool_note_subprocess(ctx->p, ctx->proc, APR_KILL_AFTER_TIMEOUT);
 487
 488     /* We don't want the handle to the child's stdin inherited by any
 489      * other processes created by httpd.  Otherwise, when we close our
 490      * handle, the child won't see EOF because another handle will still
 491      * be open.
 492      */
 493
 494     apr_pool_cleanup_register(ctx->p, ctx->proc->in,
 495                          apr_pool_cleanup_null, /* other mechanism */
 496                          ef_close_file);
 497
 498 #if APR_FILES_AS_SOCKETS
 499     {
 500         apr_pollfd_t pfd = { 0 };
 501
 502         rc = apr_pollset_create(&ctx->pollset, 2, ctx->p, 0);
 503         ap_assert(rc == APR_SUCCESS);
 504
 505         pfd.p         = ctx->p;
 506         pfd.desc_type = APR_POLL_FILE;
 507         pfd.reqevents = APR_POLLOUT;
 508         pfd.desc.f    = ctx->proc->in;
 509         rc = apr_pollset_add(ctx->pollset, &pfd);
 510         ap_assert(rc == APR_SUCCESS);
 511
 512         pfd.reqevents = APR_POLLIN;
 513         pfd.desc.f    = ctx->proc->out;
 514         rc = apr_pollset_add(ctx->pollset, &pfd);
 515         ap_assert(rc == APR_SUCCESS);
 516     }
 517 #endif
 518
 519     return APR_SUCCESS;
 520 }
 521
 522 static const char *get_cfg_string(ef_dir_t *dc, ef_filter_t *filter, apr_pool_t *p)
 523 {
 524     const char *log_stderr_str = dc->log_stderr < 1 ?
 525         "NoLogStderr" : "LogStderr";
 526     const char *preserve_content_length_str = filter->preserves_content_length ?
 527         "PreservesContentLength" : "!PreserveContentLength";
 528     const char *intype_str = !filter->intype ?
 529         "*/*" : filter->intype;
 530     const char *outtype_str = !filter->outtype ?
 531         "(unchanged)" : filter->outtype;
 532
 533     return apr_psprintf(p,
 534                         "ExtFilterOptions %s %s ExtFilterInType %s "
 535                         "ExtFilterOuttype %s",
 536                         log_stderr_str, preserve_content_length_str,
 537                         intype_str, outtype_str);
 538 }
 539
 540 static ef_filter_t *find_filter_def(const server_rec *s, const char *fname)
 541 {
 542     ef_server_t *sc;
 543     ef_filter_t *f;
 544
 545     sc = ap_get_module_config(s->module_config, &ext_filter_module);
 546     f = apr_hash_get(sc->h, fname, APR_HASH_KEY_STRING);
 547     if (!f && s != main_server) {
 548         s = main_server;
 549         sc = ap_get_module_config(s->module_config, &ext_filter_module);
 550         f = apr_hash_get(sc->h, fname, APR_HASH_KEY_STRING);
 551     }
 552     return f;
 553 }
 554
 555 static apr_status_t init_filter_instance(ap_filter_t *f)
 556 {
 557     ef_ctx_t *ctx;
 558     ef_dir_t *dc;
 559     apr_status_t rv;
 560
 561     f->ctx = ctx = apr_pcalloc(f->r->pool, sizeof(ef_ctx_t));
 562     dc = ap_get_module_config(f->r->per_dir_config,
 563                               &ext_filter_module);
 564     ctx->dc = dc;
 565     /* look for the user-defined filter */
 566     ctx->filter = find_filter_def(f->r->server, f->frec->name);
 567     if (!ctx->filter) {
 568         ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, f->r, APLOGNO(01459)
 569                       "couldn't find definition of filter '%s'",
 570                       f->frec->name);
 571         return APR_EINVAL;
 572     }
 573     ctx->p = f->r->pool;
 574     if (ctx->filter->intype &&
 575         ctx->filter->intype != INTYPE_ALL) {
 576         const char *ctypes;
 577
 578         if (ctx->filter->mode == INPUT_FILTER) {
 579             ctypes = apr_table_get(f->r->headers_in, "Content-Type");
 580         }
 581         else {
 582             ctypes = f->r->content_type;
 583         }
 584
 585         if (ctypes) {
 586             const char *ctype = ap_getword(f->r->pool, &ctypes, ';');
 587
 588             if (strcasecmp(ctx->filter->intype, ctype)) {
 589                 /* wrong IMT for us; don't mess with the output */
 590                 ctx->noop = 1;
 591             }
 592         }
 593         else {
 594             ctx->noop = 1;
 595         }
 596     }
 597     if (ctx->filter->enable_env &&
 598         !apr_table_get(f->r->subprocess_env, ctx->filter->enable_env)) {
 599         /* an environment variable that enables the filter isn't set; bail */
 600         ctx->noop = 1;
 601     }
 602     if (ctx->filter->disable_env &&
 603         apr_table_get(f->r->subprocess_env, ctx->filter->disable_env)) {
 604         /* an environment variable that disables the filter is set; bail */
 605         ctx->noop = 1;
 606     }
 607     if (!ctx->noop) {
 608         rv = init_ext_filter_process(f);
 609         if (rv != APR_SUCCESS) {
 610             return rv;
 611         }
 612         if (ctx->filter->outtype &&
 613             ctx->filter->outtype != OUTTYPE_UNCHANGED) {
 614             ap_set_content_type(f->r, ctx->filter->outtype);
 615         }
 616         if (ctx->filter->preserves_content_length != 1) {
 617             /* nasty, but needed to avoid confusing the browser
 618              */
 619             apr_table_unset(f->r->headers_out, "Content-Length");
 620         }
 621     }
 622
 623     if (APLOGrtrace1(f->r)) {
 624         ap_log_rerror(APLOG_MARK, APLOG_TRACE1, 0, f->r,
 625                       "%sfiltering `%s' of type `%s' through `%s', cfg %s",
 626                       ctx->noop ? "NOT " : "",
 627                       f->r->uri ? f->r->uri : f->r->filename,
 628                       f->r->content_type ? f->r->content_type : "(unspecified)",
 629                       ctx->filter->command,
 630                       get_cfg_string(dc, ctx->filter, f->r->pool));
 631     }
 632
 633     return APR_SUCCESS;
 634 }
 635
 636 /* drain_available_output():
 637  *
 638  * if any data is available from the filter, read it and append it
 639  * to the the bucket brigade
 640  */
 641 static apr_status_t drain_available_output(ap_filter_t *f,
 642                                            apr_bucket_brigade *bb)
 643 {
 644     request_rec *r = f->r;
 645     conn_rec *c = r->connection;
 646     ef_ctx_t *ctx = f->ctx;
 647     apr_size_t len;
 648     char buf[4096];
 649     apr_status_t rv;
 650     apr_bucket *b;
 651
 652     while (1) {
 653         int lvl = APLOG_TRACE5;
 654         len = sizeof(buf);
 655         rv = apr_file_read(ctx->proc->out, buf, &len);
 656         if (rv && !APR_STATUS_IS_EAGAIN(rv))
 657            lvl = APLOG_DEBUG;
 658         ap_log_rerror(APLOG_MARK, lvl, rv, r, APLOGNO(01460)
 659                       "apr_file_read(child output), len %" APR_SIZE_T_FMT,
 660                       !rv ? len : -1);
 661         if (rv != APR_SUCCESS) {
 662             return rv;
 663         }
 664         b = apr_bucket_heap_create(buf, len, NULL, c->bucket_alloc);
 665         APR_BRIGADE_INSERT_TAIL(bb, b);
 666         return APR_SUCCESS;
 667     }
 668     /* we should never get here; if we do, a bogus error message would be
 669      * the least of our problems
 670      */
 671     return APR_ANONYMOUS;
 672 }
 673
 674 static apr_status_t pass_data_to_filter(ap_filter_t *f, const char *data,
 675                                         apr_size_t len, apr_bucket_brigade *bb)
 676 {
 677     ef_ctx_t *ctx = f->ctx;
 678     apr_status_t rv;
 679     apr_size_t bytes_written = 0;
 680     apr_size_t tmplen;
 681
 682     do {
 683         tmplen = len - bytes_written;
 684         rv = apr_file_write(ctx->proc->in,
 685                        (const char *)data + bytes_written,
 686                        &tmplen);
 687         bytes_written += tmplen;
 688         if (rv != APR_SUCCESS && !APR_STATUS_IS_EAGAIN(rv)) {
 689             ap_log_rerror(APLOG_MARK, APLOG_ERR, rv, f->r, APLOGNO(01461)
 690                           "apr_file_write(child input), len %" APR_SIZE_T_FMT,
 691                           tmplen);
 692             return rv;
 693         }
 694         if (APR_STATUS_IS_EAGAIN(rv)) {
 695             /* XXX handle blocking conditions here...  if we block, we need
 696              * to read data from the child process and pass it down to the
 697              * next filter!
 698              */
 699             rv = drain_available_output(f, bb);
 700             if (APR_STATUS_IS_EAGAIN(rv)) {
 701 #if APR_FILES_AS_SOCKETS
 702                 int num_events;
 703                 const apr_pollfd_t *pdesc;
 704
 705                 rv = apr_pollset_poll(ctx->pollset, f->r->server->timeout,
 706                                       &num_events, &pdesc);
 707                 if (rv != APR_SUCCESS && !APR_STATUS_IS_EINTR(rv)) {
 708                     ap_log_rerror(APLOG_MARK, APLOG_WARNING, rv, f->r, APLOGNO(01462)
 709                                   "apr_pollset_poll()");
 710                     /* some error such as APR_TIMEUP */
 711                     return rv;
 712                 }
 713                 ap_log_rerror(APLOG_MARK, APLOG_TRACE6, rv, f->r,
 714                               "apr_pollset_poll()");
 715 #else /* APR_FILES_AS_SOCKETS */
 716                 /* Yuck... I'd really like to wait until I can read
 717                  * or write, but instead I have to sleep and try again
 718                  */
 719                 apr_sleep(100000); /* 100 milliseconds */
 720                 ap_log_rerror(APLOG_MARK, APLOG_TRACE6, 0, f->r, "apr_sleep()");
 721 #endif /* APR_FILES_AS_SOCKETS */
 722             }
 723             else if (rv != APR_SUCCESS) {
 724                 return rv;
 725             }
 726         }
 727     } while (bytes_written < len);
 728     return rv;
 729 }
 730
 731 /* ef_unified_filter:
 732  *
 733  * runs the bucket brigade bb through the filter and puts the result into
 734  * bb, dropping the previous content of bb (the input)
 735  */
 736
 737 static int ef_unified_filter(ap_filter_t *f, apr_bucket_brigade *bb)
 738 {
 739     request_rec *r = f->r;
 740     conn_rec *c = r->connection;
 741     ef_ctx_t *ctx = f->ctx;
 742     apr_bucket *b;
 743     apr_size_t len;
 744     const char *data;
 745     apr_status_t rv;
 746     char buf[4096];
 747     apr_bucket *eos = NULL;
 748     apr_bucket_brigade *bb_tmp;
 749
 750     bb_tmp = apr_brigade_create(r->pool, c->bucket_alloc);
 751
 752     for (b = APR_BRIGADE_FIRST(bb);
 753          b != APR_BRIGADE_SENTINEL(bb);
 754          b = APR_BUCKET_NEXT(b))
 755     {
 756         if (APR_BUCKET_IS_EOS(b)) {
 757             eos = b;
 758             break;
 759         }
 760
 761         rv = apr_bucket_read(b, &data, &len, APR_BLOCK_READ);
 762         if (rv != APR_SUCCESS) {
 763             ap_log_rerror(APLOG_MARK, APLOG_ERR, rv, r, APLOGNO(01463) "apr_bucket_read()");
 764             return rv;
 765         }
 766
 767         /* Good cast, we just tested len isn't negative */
 768         if (len > 0 &&
 769             (rv = pass_data_to_filter(f, data, (apr_size_t)len, bb_tmp))
 770                 != APR_SUCCESS) {
 771             return rv;
 772         }
 773     }
 774
 775     apr_brigade_cleanup(bb);
 776     APR_BRIGADE_CONCAT(bb, bb_tmp);
 777     apr_brigade_destroy(bb_tmp);
 778
 779     if (eos) {
 780         /* close the child's stdin to signal that no more data is coming;
 781          * that will cause the child to finish generating output
 782          */
 783         if ((rv = apr_file_close(ctx->proc->in)) != APR_SUCCESS) {
 784             ap_log_rerror(APLOG_MARK, APLOG_ERR, rv, r, APLOGNO(01464)
 785                           "apr_file_close(child input)");
 786             return rv;
 787         }
 788         /* since we've seen eos and closed the child's stdin, set the proper pipe
 789          * timeout; we don't care if we don't return from apr_file_read() for a while...
 790          */
 791         rv = apr_file_pipe_timeout_set(ctx->proc->out,
 792                                        r->server->timeout);
 793         if (rv) {
 794             ap_log_rerror(APLOG_MARK, APLOG_ERR, rv, r, APLOGNO(01465)
 795                           "apr_file_pipe_timeout_set(child output)");
 796             return rv;
 797         }
 798     }
 799
 800     do {
 801         int lvl = APLOG_TRACE6;
 802         len = sizeof(buf);
 803         rv = apr_file_read(ctx->proc->out, buf, &len);
 804         if (rv && !APR_STATUS_IS_EOF(rv) && !APR_STATUS_IS_EAGAIN(rv))
 805             lvl = APLOG_ERR;
 806         ap_log_rerror(APLOG_MARK, lvl, rv, r, APLOGNO(01466)
 807                       "apr_file_read(child output), len %" APR_SIZE_T_FMT,
 808                       !rv ? len : -1);
 809         if (APR_STATUS_IS_EAGAIN(rv)) {
 810             if (eos) {
 811                 /* should not occur, because we have an APR timeout in place */
 812                 AP_DEBUG_ASSERT(1 != 1);
 813             }
 814             return APR_SUCCESS;
 815         }
 816
 817         if (rv == APR_SUCCESS) {
 818             b = apr_bucket_heap_create(buf, len, NULL, c->bucket_alloc);
 819             APR_BRIGADE_INSERT_TAIL(bb, b);
 820         }
 821     } while (rv == APR_SUCCESS);
 822
 823     if (!APR_STATUS_IS_EOF(rv)) {
 824         return rv;
 825     }
 826
 827     if (eos) {
 828         b = apr_bucket_eos_create(c->bucket_alloc);
 829         APR_BRIGADE_INSERT_TAIL(bb, b);
 830     }
 831
 832     return APR_SUCCESS;
 833 }
 834
 835 static apr_status_t ef_output_filter(ap_filter_t *f, apr_bucket_brigade *bb)
 836 {
 837     request_rec *r = f->r;
 838     ef_ctx_t *ctx = f->ctx;
 839     apr_status_t rv;
 840
 841     if (!ctx) {
 842         if ((rv = init_filter_instance(f)) != APR_SUCCESS) {
 843             ctx = f->ctx;
 844             ap_log_rerror(APLOG_MARK, APLOG_ERR, rv, r, APLOGNO(01467)
 845                           "can't initialise output filter %s: %s",
 846                           f->frec->name,
 847                           (ctx->dc->onfail == 1) ? "removing" : "aborting");
 848             ap_remove_output_filter(f);
 849             if (ctx->dc->onfail == 1) {
 850                 return ap_pass_brigade(f->next, bb);
 851             }
 852             else {
 853                 apr_bucket *e;
 854                 f->r->status_line = "500 Internal Server Error";
 855
 856                 apr_brigade_cleanup(bb);
 857                 e = ap_bucket_error_create(HTTP_INTERNAL_SERVER_ERROR,
 858                                            NULL, r->pool,
 859                                            f->c->bucket_alloc);
 860                 APR_BRIGADE_INSERT_TAIL(bb, e);
 861                 e = apr_bucket_eos_create(f->c->bucket_alloc);
 862                 APR_BRIGADE_INSERT_TAIL(bb, e);
 863                 ap_pass_brigade(f->next, bb);
 864                 return AP_FILTER_ERROR;
 865             }
 866         }
 867         ctx = f->ctx;
 868     }
 869     if (ctx->noop) {
 870         ap_remove_output_filter(f);
 871         return ap_pass_brigade(f->next, bb);
 872     }
 873
 874     rv = ef_unified_filter(f, bb);
 875     if (rv != APR_SUCCESS) {
 876         ap_log_rerror(APLOG_MARK, APLOG_ERR, rv, r, APLOGNO(01468)
 877                       "ef_unified_filter() failed");
 878     }
 879
 880     if ((rv = ap_pass_brigade(f->next, bb)) != APR_SUCCESS) {
 881         ap_log_rerror(APLOG_MARK, APLOG_DEBUG, rv, r, APLOGNO(01469)
 882                       "ap_pass_brigade() failed");
 883     }
 884     return rv;
 885 }
 886
 887 static int ef_input_filter(ap_filter_t *f, apr_bucket_brigade *bb,
 888                            ap_input_mode_t mode, apr_read_type_e block,
 889                            apr_off_t readbytes)
 890 {
 891     ef_ctx_t *ctx = f->ctx;
 892     apr_status_t rv;
 893
 894     if (!ctx) {
 895         if ((rv = init_filter_instance(f)) != APR_SUCCESS) {
 896             ctx = f->ctx;
 897             ap_log_rerror(APLOG_MARK, APLOG_ERR, rv, f->r, APLOGNO(01470)
 898                           "can't initialise input filter %s: %s",
 899                           f->frec->name,
 900                           (ctx->dc->onfail == 1) ? "removing" : "aborting");
 901             ap_remove_input_filter(f);
 902             if (ctx->dc->onfail == 1) {
 903                 return ap_get_brigade(f->next, bb, mode, block, readbytes);
 904             }
 905             else {
 906                 f->r->status = HTTP_INTERNAL_SERVER_ERROR;
 907                 return HTTP_INTERNAL_SERVER_ERROR;
 908             }
 909         }
 910         ctx = f->ctx;
 911     }
 912
 913     if (ctx->noop) {
 914         ap_remove_input_filter(f);
 915         return ap_get_brigade(f->next, bb, mode, block, readbytes);
 916     }
 917
 918     rv = ap_get_brigade(f->next, bb, mode, block, readbytes);
 919     if (rv != APR_SUCCESS) {
 920         return rv;
 921     }
 922
 923     rv = ef_unified_filter(f, bb);
 924     return rv;
 925 }
 926
 927 AP_DECLARE_MODULE(ext_filter) =
 928 {
 929     STANDARD20_MODULE_STUFF,
 930     create_ef_dir_conf,
 931     merge_ef_dir_conf,
 932     create_ef_server_conf,
 933     NULL,
 934     cmds,
 935     register_hooks
 936 };