2 * Licensed to the Apache Software Foundation (ASF) under one or more
3 * contributor license agreements. See the NOTICE file distributed with
4 * this work for additional information regarding copyright ownership.
5 * The ASF licenses this file to You under the Apache License, Version 2.0
6 * (the "License"); you may not use this file except in compliance with
7 * the License. You may obtain a copy of the License at
9 * http://www.apache.org/licenses/LICENSE-2.0
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
22 #include <apr_thread_mutex.h>
23 #include <apr_pools.h>
25 #include "lua_config.h"
26 #include "apr_optional.h"
29 #include "util_mutex.h"
32 #ifdef APR_HAS_THREADS
33 #include "apr_thread_proc.h"
37 #if APR_HAVE_SYS_TYPES_H
38 #include <sys/types.h>
44 /* getpid for Windows */
45 #if APR_HAVE_PROCESS_H
49 APR_IMPLEMENT_OPTIONAL_HOOK_RUN_ALL(ap_lua, AP_LUA, int, lua_open,
50 (lua_State *L, apr_pool_t *p),
53 APR_IMPLEMENT_OPTIONAL_HOOK_RUN_ALL(ap_lua, AP_LUA, int, lua_request,
54 (lua_State *L, request_rec *r),
56 static APR_OPTIONAL_FN_TYPE(ssl_var_lookup) *lua_ssl_val = NULL;
57 static APR_OPTIONAL_FN_TYPE(ssl_is_https) *lua_ssl_is_https = NULL;
59 module AP_MODULE_DECLARE_DATA lua_module;
61 #define AP_LUA_HOOK_FIRST (APR_HOOK_FIRST - 1)
62 #define AP_LUA_HOOK_LAST (APR_HOOK_LAST + 1)
66 const char *file_name;
67 const char *function_name;
69 apr_array_header_t *args;
70 } lua_authz_provider_spec;
72 apr_hash_t *lua_authz_providers;
76 apr_bucket_brigade *tmpBucket;
82 apr_global_mutex_t *lua_ivm_mutex;
83 apr_shm_t *lua_ivm_shm;
84 char *lua_ivm_shmfile;
86 static apr_status_t shm_cleanup_wrapper(void *unused) {
88 return apr_shm_destroy(lua_ivm_shm);
94 * error reporting if lua has an error.
95 * Extracts the error from lua stack and prints
97 static void report_lua_error(lua_State *L, request_rec *r)
99 const char *lua_response;
100 r->status = HTTP_INTERNAL_SERVER_ERROR;
101 r->content_type = "text/html";
102 ap_rputs("<h3>Error!</h3>\n", r);
103 ap_rputs("<pre>", r);
104 lua_response = lua_tostring(L, -1);
105 ap_rputs(ap_escape_html(r->pool, lua_response), r);
106 ap_rputs("</pre>\n", r);
108 ap_log_perror(APLOG_MARK, APLOG_WARNING, 0, r->pool, APLOGNO(01471) "Lua error: %s",
112 static void lua_open_callback(lua_State *L, apr_pool_t *p, void *ctx)
115 ap_lua_load_apache2_lmodule(L);
116 ap_lua_load_request_lmodule(L, p);
117 ap_lua_load_config_lmodule(L);
120 static int lua_open_hook(lua_State *L, apr_pool_t *p)
122 lua_open_callback(L, p, NULL);
126 static const char *scope_to_string(unsigned int scope)
129 case AP_LUA_SCOPE_ONCE:
130 case AP_LUA_SCOPE_UNSET:
132 case AP_LUA_SCOPE_REQUEST:
134 case AP_LUA_SCOPE_CONN:
137 case AP_LUA_SCOPE_THREAD:
139 case AP_LUA_SCOPE_SERVER:
148 static void ap_lua_release_state(lua_State* L, ap_lua_vm_spec* spec, request_rec* r) {
150 apr_reslist_t* reslist = NULL;
151 if (spec->scope == AP_LUA_SCOPE_SERVER) {
152 ap_lua_server_spec* sspec = NULL;
154 lua_getfield(L, LUA_REGISTRYINDEX, "Apache2.Lua.server_spec");
155 sspec = (ap_lua_server_spec*) lua_touserdata(L, 1);
156 hash = apr_psprintf(r->pool, "reslist:%s", spec->file);
157 if (apr_pool_userdata_get((void **)&reslist, hash,
158 r->server->process->pool) == APR_SUCCESS) {
159 AP_DEBUG_ASSERT(sspec != NULL);
160 if (reslist != NULL) {
161 apr_reslist_release(reslist, sspec);
167 static ap_lua_vm_spec *create_vm_spec(apr_pool_t **lifecycle_pool,
169 const ap_lua_dir_cfg *cfg,
170 const ap_lua_server_cfg *server_cfg,
171 const char *filename,
172 const char *bytecode,
173 apr_size_t bytecode_len,
174 const char *function,
178 ap_lua_vm_spec *spec = apr_pcalloc(r->pool, sizeof(ap_lua_vm_spec));
180 spec->scope = cfg->vm_scope;
181 spec->pool = r->pool;
182 spec->package_paths = cfg->package_paths;
183 spec->package_cpaths = cfg->package_cpaths;
184 spec->cb = &lua_open_callback;
186 spec->bytecode = bytecode;
187 spec->bytecode_len = bytecode_len;
188 spec->codecache = (cfg->codecache == AP_LUA_CACHE_UNSET) ? AP_LUA_CACHE_STAT : cfg->codecache;
189 spec->vm_min = cfg->vm_min ? cfg->vm_min : 1;
190 spec->vm_max = cfg->vm_max ? cfg->vm_max : 1;
194 apr_filepath_merge(&file, server_cfg->root_path,
195 filename, APR_FILEPATH_NOTRELATIVE, r->pool);
199 spec->file = r->filename;
201 ap_log_rerror(APLOG_MARK, APLOG_TRACE2, 0, r, APLOGNO(02313)
202 "%s details: scope: %s, file: %s, func: %s",
203 what, scope_to_string(spec->scope), spec->file,
204 function ? function : "-");
206 switch (spec->scope) {
207 case AP_LUA_SCOPE_ONCE:
208 case AP_LUA_SCOPE_UNSET:
209 apr_pool_create(&pool, r->pool);
211 case AP_LUA_SCOPE_REQUEST:
214 case AP_LUA_SCOPE_CONN:
215 pool = r->connection->pool;
218 case AP_LUA_SCOPE_THREAD:
219 pool = apr_thread_pool_get(r->connection->current_thread);
221 case AP_LUA_SCOPE_SERVER:
222 pool = r->server->process->pool;
229 *lifecycle_pool = pool;
233 static const char* ap_lua_interpolate_string(apr_pool_t* pool, const char* string, const char** values)
238 srclen = strlen(string);
241 for (x=0; x < srclen; x++) {
242 if (string[x] == '$' && x != srclen-1 && string[x+1] >= '0' && string[x+1] <= '9') {
243 int v = *(string+x+1) - '0';
245 stringBetween = apr_pstrndup(pool, string+y, x-y);
250 ret = apr_pstrcat(pool, ret, stringBetween, values[v], NULL);
255 if (x-y > 0 && y > 0) {
256 stringBetween = apr_pstrndup(pool, string+y, x-y);
257 ret = apr_pstrcat(pool, ret, stringBetween, NULL);
259 /* If no replacement was made, just return the original string */
271 static int lua_handler(request_rec *r)
274 if (strcmp(r->handler, "lua-script")) {
277 /* Decline the request if the script does not exist (or is a directory),
278 * rather than just returning internal server error */
280 (r->finfo.filetype == APR_NOFILE)
281 || (r->finfo.filetype & APR_DIR)
285 ap_log_rerror(APLOG_MARK, APLOG_TRACE1, 0, r, APLOGNO(01472)
286 "handling [%s] in mod_lua", r->filename);
288 /* XXX: This seems wrong because it may generate wrong headers for HEAD requests */
289 if (!r->header_only) {
292 const ap_lua_dir_cfg *cfg = ap_get_module_config(r->per_dir_config,
294 ap_lua_vm_spec *spec = create_vm_spec(&pool, r, cfg, NULL, NULL, NULL,
295 0, "handle", "request handler");
297 L = ap_lua_get_lua_state(pool, spec, r);
299 /* TODO annotate spec with failure reason */
300 r->status = HTTP_INTERNAL_SERVER_ERROR;
301 ap_rputs("Unable to compile VM, see logs", r);
302 ap_lua_release_state(L, spec, r);
303 return HTTP_INTERNAL_SERVER_ERROR;
305 ap_log_rerror(APLOG_MARK, APLOG_TRACE3, 0, r, APLOGNO(01474) "got a vm!");
306 lua_getglobal(L, "handle");
307 if (!lua_isfunction(L, -1)) {
308 ap_log_rerror(APLOG_MARK, APLOG_CRIT, 0, r, APLOGNO(01475)
309 "lua: Unable to find entry function '%s' in %s (not a valid function)",
312 ap_lua_release_state(L, spec, r);
313 return HTTP_INTERNAL_SERVER_ERROR;
315 ap_lua_run_lua_request(L, r);
316 if (lua_pcall(L, 1, 1, 0)) {
317 report_lua_error(L, r);
319 if (lua_isnumber(L, -1)) {
320 rc = lua_tointeger(L, -1);
322 ap_lua_release_state(L, spec, r);
328 /* ------------------- Input/output content filters ------------------- */
331 static apr_status_t lua_setup_filter_ctx(ap_filter_t* f, request_rec* r, lua_filter_ctx** c) {
333 ap_lua_vm_spec *spec;
337 ap_lua_server_cfg *server_cfg = ap_get_module_config(r->server->module_config,
339 const ap_lua_dir_cfg *cfg = ap_get_module_config(r->per_dir_config,
342 ctx = apr_pcalloc(r->pool, sizeof(lua_filter_ctx));
345 /* Find the filter that was called.
346 * XXX: If we were wired with mod_filter, the filter (mod_filters name)
347 * and the provider (our underlying filters name) need to have matched.
349 for (n = 0; n < cfg->mapped_filters->nelts; n++) {
350 ap_lua_filter_handler_spec *hook_spec =
351 ((ap_lua_filter_handler_spec **) cfg->mapped_filters->elts)[n];
353 if (hook_spec == NULL) {
356 if (!strcasecmp(hook_spec->filter_name, f->frec->name)) {
357 spec = create_vm_spec(&pool, r, cfg, server_cfg,
358 hook_spec->file_name,
361 hook_spec->function_name,
363 L = ap_lua_get_lua_state(pool, spec, r);
365 L = lua_newthread(L);
369 ap_log_rerror(APLOG_MARK, APLOG_CRIT, 0, r, APLOGNO(02328)
370 "lua: Failed to obtain lua interpreter for %s %s",
371 hook_spec->function_name, hook_spec->file_name);
372 ap_lua_release_state(L, spec, r);
375 if (hook_spec->function_name != NULL) {
376 lua_getglobal(L, hook_spec->function_name);
377 if (!lua_isfunction(L, -1)) {
378 ap_log_rerror(APLOG_MARK, APLOG_CRIT, 0, r, APLOGNO(02329)
379 "lua: Unable to find entry function '%s' in %s (not a valid function)",
380 hook_spec->function_name,
381 hook_spec->file_name);
382 ap_lua_release_state(L, spec, r);
386 ap_lua_run_lua_request(L, r);
390 ap_lua_run_lua_request(L, r);
393 lua_setglobal(L, "r");
399 /* If a Lua filter is interested in filtering a request, it must first do a yield,
400 * otherwise we'll assume that it's not interested and pretend we didn't find it.
402 rc = lua_resume(L, 1);
403 if (rc == LUA_YIELD) {
404 if (f->frec->providers == NULL) {
405 /* Not wired by mod_filter */
406 apr_table_unset(r->headers_out, "Content-Length");
407 apr_table_unset(r->headers_out, "Content-MD5");
408 apr_table_unset(r->headers_out, "ETAG");
413 ap_lua_release_state(L, spec, r);
421 static apr_status_t lua_output_filter_handle(ap_filter_t *f, apr_bucket_brigade *pbbIn) {
422 request_rec *r = f->r;
426 conn_rec *c = r->connection;
430 /* Set up the initial filter context and acquire the function.
431 * The corresponding Lua function should yield here.
434 rc = lua_setup_filter_ctx(f,r,&ctx);
435 if (rc == APR_EGENERAL) {
436 return HTTP_INTERNAL_SERVER_ERROR;
438 if (rc == APR_ENOENT) {
439 /* No filter entry found (or the script declined to filter), just pass on the buckets */
440 ap_remove_output_filter(f);
441 return ap_pass_brigade(f->next,pbbIn);
444 /* We've got a willing lua filter, setup and check for a prefix */
447 const char* output = lua_tolstring(ctx->L, 1, &olen);
450 ctx->tmpBucket = apr_brigade_create(r->pool, c->bucket_alloc);
453 pbktOut = apr_bucket_heap_create(output, olen, NULL, c->bucket_alloc);
454 APR_BRIGADE_INSERT_TAIL(ctx->tmpBucket, pbktOut);
455 rv = ap_pass_brigade(f->next, ctx->tmpBucket);
456 apr_brigade_cleanup(ctx->tmpBucket);
457 if (rv != APR_SUCCESS) {
463 ctx = (lua_filter_ctx*) f->ctx;
465 /* While the Lua function is still yielding, pass in buckets to the coroutine */
467 for (pbktIn = APR_BRIGADE_FIRST(pbbIn);
468 pbktIn != APR_BRIGADE_SENTINEL(pbbIn);
469 pbktIn = APR_BUCKET_NEXT(pbktIn))
475 /* read the bucket */
476 apr_bucket_read(pbktIn,&data,&len,APR_BLOCK_READ);
478 /* Push the bucket onto the Lua stack as a global var */
479 lua_pushlstring(L, data, len);
480 lua_setglobal(L, "bucket");
482 /* If Lua yielded, it means we have something to pass on */
483 if (lua_resume(L, 0) == LUA_YIELD) {
485 const char* output = lua_tolstring(L, 1, &olen);
487 pbktOut = apr_bucket_heap_create(output, olen, NULL,
489 APR_BRIGADE_INSERT_TAIL(ctx->tmpBucket, pbktOut);
490 rv = ap_pass_brigade(f->next, ctx->tmpBucket);
491 apr_brigade_cleanup(ctx->tmpBucket);
492 if (rv != APR_SUCCESS) {
499 ap_lua_release_state(L, ctx->spec, r);
500 ap_remove_output_filter(f);
501 apr_brigade_cleanup(pbbIn);
502 apr_brigade_cleanup(ctx->tmpBucket);
503 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(02663)
504 "lua: Error while executing filter: %s",
505 lua_tostring(L, -1));
506 return HTTP_INTERNAL_SERVER_ERROR;
509 /* If we've safely reached the end, do a final call to Lua to allow for any
510 finishing moves by the script, such as appending a tail. */
511 if (APR_BUCKET_IS_EOS(APR_BRIGADE_LAST(pbbIn))) {
514 lua_setglobal(L, "bucket");
515 if (lua_resume(L, 0) == LUA_YIELD) {
518 const char* output = lua_tolstring(L, 1, &olen);
520 pbktOut = apr_bucket_heap_create(output, olen, NULL,
522 APR_BRIGADE_INSERT_TAIL(ctx->tmpBucket, pbktOut);
525 pbktEOS = apr_bucket_eos_create(c->bucket_alloc);
526 APR_BRIGADE_INSERT_TAIL(ctx->tmpBucket, pbktEOS);
527 ap_lua_release_state(L, ctx->spec, r);
528 rv = ap_pass_brigade(f->next, ctx->tmpBucket);
529 apr_brigade_cleanup(ctx->tmpBucket);
530 if (rv != APR_SUCCESS) {
536 apr_brigade_cleanup(pbbIn);
542 static apr_status_t lua_input_filter_handle(ap_filter_t *f,
543 apr_bucket_brigade *pbbOut,
544 ap_input_mode_t eMode,
545 apr_read_type_e eBlock,
548 request_rec *r = f->r;
549 int rc, lastCall = 0;
552 conn_rec *c = r->connection;
555 /* Set up the initial filter context and acquire the function.
556 * The corresponding Lua function should yield here.
559 rc = lua_setup_filter_ctx(f,r,&ctx);
561 if (rc == APR_EGENERAL) {
563 ap_remove_input_filter(f);
564 return HTTP_INTERNAL_SERVER_ERROR;
566 if (rc == APR_ENOENT ) {
567 ap_remove_input_filter(f);
570 if (rc == APR_SUCCESS) {
571 ctx->tmpBucket = apr_brigade_create(r->pool, c->bucket_alloc);
574 ctx = (lua_filter_ctx*) f->ctx;
576 /* If the Lua script broke or denied serving the request, just pass the buckets through */
578 return ap_get_brigade(f->next, pbbOut, eMode, eBlock, nBytes);
581 if (APR_BRIGADE_EMPTY(ctx->tmpBucket)) {
582 ret = ap_get_brigade(f->next, ctx->tmpBucket, eMode, eBlock, nBytes);
583 if (eMode == AP_MODE_EATCRLF || ret != APR_SUCCESS)
587 /* While the Lua function is still yielding, pass buckets to the coroutine */
590 while(!APR_BRIGADE_EMPTY(ctx->tmpBucket)) {
591 apr_bucket *pbktIn = APR_BRIGADE_FIRST(ctx->tmpBucket);
596 if (APR_BUCKET_IS_EOS(pbktIn)) {
597 APR_BUCKET_REMOVE(pbktIn);
601 /* read the bucket */
602 ret = apr_bucket_read(pbktIn, &data, &len, eBlock);
603 if (ret != APR_SUCCESS)
606 /* Push the bucket onto the Lua stack as a global var */
608 lua_pushlstring(L, data, len);
609 lua_setglobal(L, "bucket");
611 /* If Lua yielded, it means we have something to pass on */
612 if (lua_resume(L, 0) == LUA_YIELD) {
614 const char* output = lua_tolstring(L, 1, &olen);
615 pbktOut = apr_bucket_heap_create(output, olen, 0, c->bucket_alloc);
616 APR_BRIGADE_INSERT_TAIL(pbbOut, pbktOut);
617 apr_bucket_delete(pbktIn);
622 ap_lua_release_state(L, ctx->spec, r);
623 ap_remove_input_filter(f);
624 apr_bucket_delete(pbktIn);
625 return HTTP_INTERNAL_SERVER_ERROR;
628 /* If we've safely reached the end, do a final call to Lua to allow for any
629 finishing moves by the script, such as appending a tail. */
631 apr_bucket *pbktEOS = apr_bucket_eos_create(c->bucket_alloc);
633 lua_setglobal(L, "bucket");
634 if (lua_resume(L, 0) == LUA_YIELD) {
637 const char* output = lua_tolstring(L, 1, &olen);
638 pbktOut = apr_bucket_heap_create(output, olen, 0, c->bucket_alloc);
639 APR_BRIGADE_INSERT_TAIL(pbbOut, pbktOut);
641 APR_BRIGADE_INSERT_TAIL(pbbOut,pbktEOS);
642 ap_lua_release_state(L, ctx->spec, r);
649 /* ---------------- Configury stuff --------------- */
651 /** harnesses for magic hooks **/
653 static int lua_request_rec_hook_harness(request_rec *r, const char *name, int apr_hook_when)
658 ap_lua_vm_spec *spec;
659 ap_lua_server_cfg *server_cfg = ap_get_module_config(r->server->module_config,
661 const ap_lua_dir_cfg *cfg = ap_get_module_config(r->per_dir_config,
663 const char *key = apr_psprintf(r->pool, "%s_%d", name, apr_hook_when);
664 apr_array_header_t *hook_specs = apr_hash_get(cfg->hooks, key,
665 APR_HASH_KEY_STRING);
668 for (i = 0; i < hook_specs->nelts; i++) {
669 ap_lua_mapped_handler_spec *hook_spec =
670 ((ap_lua_mapped_handler_spec **) hook_specs->elts)[i];
672 if (hook_spec == NULL) {
675 spec = create_vm_spec(&pool, r, cfg, server_cfg,
676 hook_spec->file_name,
678 hook_spec->bytecode_len,
679 hook_spec->function_name,
682 L = ap_lua_get_lua_state(pool, spec, r);
685 ap_log_rerror(APLOG_MARK, APLOG_CRIT, 0, r, APLOGNO(01477)
686 "lua: Failed to obtain lua interpreter for entry function '%s' in %s",
687 hook_spec->function_name, hook_spec->file_name);
688 return HTTP_INTERNAL_SERVER_ERROR;
691 if (hook_spec->function_name != NULL) {
692 lua_getglobal(L, hook_spec->function_name);
693 if (!lua_isfunction(L, -1)) {
694 ap_log_rerror(APLOG_MARK, APLOG_CRIT, 0, r, APLOGNO(01478)
695 "lua: Unable to find entry function '%s' in %s (not a valid function)",
696 hook_spec->function_name,
697 hook_spec->file_name);
698 ap_lua_release_state(L, spec, r);
699 return HTTP_INTERNAL_SERVER_ERROR;
702 ap_lua_run_lua_request(L, r);
706 ap_lua_run_lua_request(L, r);
709 lua_setglobal(L, "r");
713 if (lua_pcall(L, 1, 1, 0)) {
714 report_lua_error(L, r);
715 ap_lua_release_state(L, spec, r);
716 return HTTP_INTERNAL_SERVER_ERROR;
719 if (lua_isnumber(L, -1)) {
720 rc = lua_tointeger(L, -1);
721 ap_log_rerror(APLOG_MARK, APLOG_TRACE4, 0, r, "Lua hook %s:%s for phase %s returned %d",
722 hook_spec->file_name, hook_spec->function_name, name, rc);
725 ap_log_rerror(APLOG_MARK, APLOG_CRIT, 0, r, "Lua hook %s:%s for phase %s did not return a numeric value",
726 hook_spec->file_name, hook_spec->function_name, name);
727 return HTTP_INTERNAL_SERVER_ERROR;
729 if (rc != DECLINED) {
730 ap_lua_release_state(L, spec, r);
733 ap_lua_release_state(L, spec, r);
740 /* Fix for making sure that LuaMapHandler works when FallbackResource is set */
741 static int lua_map_handler_fixups(request_rec *r)
743 /* If there is no handler set yet, this might be a LuaMapHandler request */
744 if (r->handler == NULL) {
746 ap_regmatch_t match[10];
747 const ap_lua_dir_cfg *cfg = ap_get_module_config(r->per_dir_config,
749 for (n = 0; n < cfg->mapped_handlers->nelts; n++) {
750 ap_lua_mapped_handler_spec *hook_spec =
751 ((ap_lua_mapped_handler_spec **) cfg->mapped_handlers->elts)[n];
753 if (hook_spec == NULL) {
756 if (!ap_regexec(hook_spec->uri_pattern, r->uri, 10, match, 0)) {
757 r->handler = apr_pstrdup(r->pool, "lua-map-handler");
766 static int lua_map_handler(request_rec *r)
771 const char *filename, *function_name;
772 const char *values[10];
773 ap_lua_vm_spec *spec;
774 ap_regmatch_t match[10];
775 ap_lua_server_cfg *server_cfg = ap_get_module_config(r->server->module_config,
777 const ap_lua_dir_cfg *cfg = ap_get_module_config(r->per_dir_config,
779 for (n = 0; n < cfg->mapped_handlers->nelts; n++) {
780 ap_lua_mapped_handler_spec *hook_spec =
781 ((ap_lua_mapped_handler_spec **) cfg->mapped_handlers->elts)[n];
783 if (hook_spec == NULL) {
786 if (!ap_regexec(hook_spec->uri_pattern, r->uri, 10, match, 0)) {
788 for (i=0 ; i < 10; i++) {
789 if (match[i].rm_eo >= 0) {
790 values[i] = apr_pstrndup(r->pool, r->uri+match[i].rm_so, match[i].rm_eo - match[i].rm_so);
794 filename = ap_lua_interpolate_string(r->pool, hook_spec->file_name, values);
795 function_name = ap_lua_interpolate_string(r->pool, hook_spec->function_name, values);
796 spec = create_vm_spec(&pool, r, cfg, server_cfg,
799 hook_spec->bytecode_len,
802 L = ap_lua_get_lua_state(pool, spec, r);
805 ap_log_rerror(APLOG_MARK, APLOG_CRIT, 0, r, APLOGNO(02330)
806 "lua: Failed to obtain Lua interpreter for entry function '%s' in %s",
807 function_name, filename);
808 ap_lua_release_state(L, spec, r);
809 return HTTP_INTERNAL_SERVER_ERROR;
812 if (function_name != NULL) {
813 lua_getglobal(L, function_name);
814 if (!lua_isfunction(L, -1)) {
815 ap_log_rerror(APLOG_MARK, APLOG_CRIT, 0, r, APLOGNO(02331)
816 "lua: Unable to find entry function '%s' in %s (not a valid function)",
819 ap_lua_release_state(L, spec, r);
820 return HTTP_INTERNAL_SERVER_ERROR;
823 ap_lua_run_lua_request(L, r);
827 ap_lua_run_lua_request(L, r);
830 lua_setglobal(L, "r");
834 if (lua_pcall(L, 1, 1, 0)) {
835 report_lua_error(L, r);
836 ap_lua_release_state(L, spec, r);
837 return HTTP_INTERNAL_SERVER_ERROR;
840 if (lua_isnumber(L, -1)) {
841 rc = lua_tointeger(L, -1);
844 ap_log_rerror(APLOG_MARK, APLOG_WARNING, 0, r, APLOGNO(02483)
845 "lua: Lua handler %s in %s did not return a value, assuming apache2.OK",
850 ap_lua_release_state(L, spec, r);
851 if (rc != DECLINED) {
860 static apr_size_t config_getstr(ap_configfile_t *cfg, char *buf,
866 apr_status_t rc = (cfg->getstr) (buf, bufsiz, cfg->param);
867 if (rc == APR_SUCCESS) {
869 if (i && buf[i - 1] == '\n')
880 apr_status_t rc = (cfg->getch) (&ch, cfg->param);
881 if (rc != APR_SUCCESS)
893 typedef struct cr_ctx
896 ap_configfile_t *cfp;
899 char buf[HUGE_STRING_LEN];
903 /* Okay, this deserves a little explaination -- in order for the errors that lua
904 * generates to be 'accuarate', including line numbers, we basically inject
905 * N line number new lines into the 'top' of the chunk reader.....
907 * be happy. this is cool.
910 static const char *lf =
911 "\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n";
914 static const char *direct_chunkreader(lua_State *lvm, void *udata,
918 struct cr_ctx *ctx = udata;
920 if (ctx->startline) {
921 *plen = ctx->startline > N_LF ? N_LF : ctx->startline;
922 ctx->startline -= *plen;
925 *plen = config_getstr(ctx->cfp, ctx->buf, HUGE_STRING_LEN);
927 for (p = ctx->buf; isspace(*p); ++p);
928 if (p[0] == '<' && p[1] == '/') {
930 while (i < strlen(ctx->endstr)) {
931 if (tolower(p[i + 2]) != ctx->endstr[i])
938 /*fprintf(stderr, "buf read: %s\n", ctx->buf); */
942 static int ldump_writer(lua_State *L, const void *b, size_t size, void *B)
945 luaL_addlstring((luaL_Buffer *) B, (const char *) b, size);
949 typedef struct hack_section_baton
952 ap_lua_mapped_handler_spec *spec;
954 } hack_section_baton;
956 /* You can be unhappy now.
960 * When you create a <Section handler in httpd, the only 'easy' way to create
961 * a directory context is to parse the section, and convert it into a 'normal'
962 * Configureation option, and then collapse the entire section, in memory,
963 * back into the parent section -- from which you can then get the new directive
964 * invoked.... anyways. evil. Rici taught me how to do this hack :-)
966 static const char *hack_section_handler(cmd_parms *cmd, void *_cfg,
969 ap_lua_dir_cfg *cfg = (ap_lua_dir_cfg *) _cfg;
970 ap_directive_t *directive = cmd->directive;
971 hack_section_baton *baton = directive->data;
972 const char *key = apr_psprintf(cmd->pool, "%s_%d", baton->name, baton->apr_hook_when);
974 apr_array_header_t *hook_specs = apr_hash_get(cfg->hooks, key,
975 APR_HASH_KEY_STRING);
977 hook_specs = apr_array_make(cmd->pool, 2,
978 sizeof(ap_lua_mapped_handler_spec *));
979 apr_hash_set(cfg->hooks, key,
980 APR_HASH_KEY_STRING, hook_specs);
983 baton->spec->scope = cfg->vm_scope;
985 *(ap_lua_mapped_handler_spec **) apr_array_push(hook_specs) = baton->spec;
990 static const char *register_named_block_function_hook(const char *name,
995 const char *function = NULL;
996 ap_lua_mapped_handler_spec *spec;
997 int when = APR_HOOK_MIDDLE;
998 const char *endp = ap_strrchr_c(line, '>');
1001 return apr_pstrcat(cmd->pool, cmd->cmd->name,
1002 "> directive missing closing '>'", NULL);
1005 line = apr_pstrndup(cmd->temp_pool, line, endp - line);
1009 word = ap_getword_conf(cmd->temp_pool, &line);
1011 function = apr_pstrdup(cmd->pool, word);
1013 word = ap_getword_conf(cmd->temp_pool, &line);
1015 if (!strcasecmp("early", word)) {
1016 when = AP_LUA_HOOK_FIRST;
1018 else if (!strcasecmp("late", word)) {
1019 when = AP_LUA_HOOK_LAST;
1022 return apr_pstrcat(cmd->pool, cmd->cmd->name,
1023 "> 2nd argument must be 'early' or 'late'", NULL);
1028 spec = apr_pcalloc(cmd->pool, sizeof(ap_lua_mapped_handler_spec));
1035 ap_directive_t **current;
1036 hack_section_baton *baton;
1038 spec->file_name = apr_psprintf(cmd->pool, "%s:%u",
1039 cmd->config_file->name,
1040 cmd->config_file->line_number);
1042 spec->function_name = (char *) function;
1049 tmp = apr_pstrdup(cmd->pool, cmd->err_directive->directive + 1);
1050 ap_str_tolower(tmp);
1052 ctx.cfp = cmd->config_file;
1053 ctx.startline = cmd->config_file->line_number;
1055 /* This lua State is used only to compile the input strings -> bytecode, so we don't need anything extra. */
1056 lvm = luaL_newstate();
1060 rv = lua_load(lvm, direct_chunkreader, &ctx, spec->file_name);
1063 const char *errstr = apr_pstrcat(cmd->pool, "Lua Error:",
1064 lua_tostring(lvm, -1), NULL);
1070 luaL_buffinit(lvm, &b);
1071 lua_dump(lvm, ldump_writer, &b);
1072 luaL_pushresult(&b);
1073 spec->bytecode_len = lua_strlen(lvm, -1);
1074 spec->bytecode = apr_pstrmemdup(cmd->pool, lua_tostring(lvm, -1),
1075 spec->bytecode_len);
1081 /* Here, we have to replace our current config node for the next pass */
1083 *current = apr_pcalloc(cmd->pool, sizeof(**current));
1086 baton = apr_pcalloc(cmd->pool, sizeof(hack_section_baton));
1089 baton->apr_hook_when = when;
1091 (*current)->filename = cmd->config_file->name;
1092 (*current)->line_num = cmd->config_file->line_number;
1093 (*current)->directive = apr_pstrdup(cmd->pool, "Lua_____ByteCodeHack");
1094 (*current)->args = NULL;
1095 (*current)->data = baton;
1101 static const char *register_named_file_function_hook(const char *name,
1105 const char *function,
1108 ap_lua_mapped_handler_spec *spec;
1109 ap_lua_dir_cfg *cfg = (ap_lua_dir_cfg *) _cfg;
1110 const char *key = apr_psprintf(cmd->pool, "%s_%d", name, apr_hook_when);
1111 apr_array_header_t *hook_specs = apr_hash_get(cfg->hooks, key,
1112 APR_HASH_KEY_STRING);
1115 hook_specs = apr_array_make(cmd->pool, 2,
1116 sizeof(ap_lua_mapped_handler_spec *));
1117 apr_hash_set(cfg->hooks, key, APR_HASH_KEY_STRING, hook_specs);
1120 spec = apr_pcalloc(cmd->pool, sizeof(ap_lua_mapped_handler_spec));
1121 spec->file_name = apr_pstrdup(cmd->pool, file);
1122 spec->function_name = apr_pstrdup(cmd->pool, function);
1123 spec->scope = cfg->vm_scope;
1125 *(ap_lua_mapped_handler_spec **) apr_array_push(hook_specs) = spec;
1128 static const char *register_mapped_file_function_hook(const char *pattern,
1132 const char *function)
1134 ap_lua_mapped_handler_spec *spec;
1135 ap_lua_dir_cfg *cfg = (ap_lua_dir_cfg *) _cfg;
1136 ap_regex_t *regex = apr_pcalloc(cmd->pool, sizeof(ap_regex_t));
1137 if (ap_regcomp(regex, pattern,0)) {
1138 return "Invalid regex pattern!";
1141 spec = apr_pcalloc(cmd->pool, sizeof(ap_lua_mapped_handler_spec));
1142 spec->file_name = apr_pstrdup(cmd->pool, file);
1143 spec->function_name = apr_pstrdup(cmd->pool, function);
1144 spec->scope = cfg->vm_scope;
1145 spec->uri_pattern = regex;
1147 *(ap_lua_mapped_handler_spec **) apr_array_push(cfg->mapped_handlers) = spec;
1150 static const char *register_filter_function_hook(const char *filter,
1154 const char *function,
1157 ap_lua_filter_handler_spec *spec;
1158 ap_lua_dir_cfg *cfg = (ap_lua_dir_cfg *) _cfg;
1160 spec = apr_pcalloc(cmd->pool, sizeof(ap_lua_filter_handler_spec));
1161 spec->file_name = apr_pstrdup(cmd->pool, file);
1162 spec->function_name = apr_pstrdup(cmd->pool, function);
1163 spec->filter_name = filter;
1165 *(ap_lua_filter_handler_spec **) apr_array_push(cfg->mapped_filters) = spec;
1166 /* TODO: Make it work on other types than just AP_FTYPE_RESOURCE? */
1167 if (direction == AP_LUA_FILTER_OUTPUT) {
1168 spec->direction = AP_LUA_FILTER_OUTPUT;
1169 ap_register_output_filter_protocol(filter, lua_output_filter_handle, NULL, AP_FTYPE_RESOURCE,
1170 AP_FILTER_PROTO_CHANGE|AP_FILTER_PROTO_CHANGE_LENGTH);
1173 spec->direction = AP_LUA_FILTER_INPUT;
1174 ap_register_input_filter(filter, lua_input_filter_handle, NULL, AP_FTYPE_RESOURCE);
1178 /* disabled (see reference below)
1179 static int lua_check_user_id_harness_first(request_rec *r)
1181 return lua_request_rec_hook_harness(r, "check_user_id", AP_LUA_HOOK_FIRST);
1184 static int lua_check_user_id_harness(request_rec *r)
1186 return lua_request_rec_hook_harness(r, "check_user_id", APR_HOOK_MIDDLE);
1188 /* disabled (see reference below)
1189 static int lua_check_user_id_harness_last(request_rec *r)
1191 return lua_request_rec_hook_harness(r, "check_user_id", AP_LUA_HOOK_LAST);
1195 static int lua_translate_name_harness_first(request_rec *r)
1197 return lua_request_rec_hook_harness(r, "translate_name", AP_LUA_HOOK_FIRST);
1199 static int lua_translate_name_harness(request_rec *r)
1201 return lua_request_rec_hook_harness(r, "translate_name", APR_HOOK_MIDDLE);
1203 static int lua_translate_name_harness_last(request_rec *r)
1205 return lua_request_rec_hook_harness(r, "translate_name", AP_LUA_HOOK_LAST);
1208 static int lua_fixup_harness(request_rec *r)
1210 return lua_request_rec_hook_harness(r, "fixups", APR_HOOK_MIDDLE);
1213 static int lua_map_to_storage_harness(request_rec *r)
1215 return lua_request_rec_hook_harness(r, "map_to_storage", APR_HOOK_MIDDLE);
1218 static int lua_type_checker_harness(request_rec *r)
1220 return lua_request_rec_hook_harness(r, "type_checker", APR_HOOK_MIDDLE);
1223 static int lua_access_checker_harness_first(request_rec *r)
1225 return lua_request_rec_hook_harness(r, "access_checker", AP_LUA_HOOK_FIRST);
1227 static int lua_access_checker_harness(request_rec *r)
1229 return lua_request_rec_hook_harness(r, "access_checker", APR_HOOK_MIDDLE);
1231 static int lua_access_checker_harness_last(request_rec *r)
1233 return lua_request_rec_hook_harness(r, "access_checker", AP_LUA_HOOK_LAST);
1236 static int lua_auth_checker_harness_first(request_rec *r)
1238 return lua_request_rec_hook_harness(r, "auth_checker", AP_LUA_HOOK_FIRST);
1240 static int lua_auth_checker_harness(request_rec *r)
1242 return lua_request_rec_hook_harness(r, "auth_checker", APR_HOOK_MIDDLE);
1244 static int lua_auth_checker_harness_last(request_rec *r)
1246 return lua_request_rec_hook_harness(r, "auth_checker", AP_LUA_HOOK_LAST);
1248 static void lua_insert_filter_harness(request_rec *r)
1250 /* ap_log_rerror(APLOG_MARK, APLOG_WARNING, 0, r, "LuaHookInsertFilter not yet implemented"); */
1253 static int lua_log_transaction_harness(request_rec *r)
1255 return lua_request_rec_hook_harness(r, "log_transaction", APR_HOOK_FIRST);
1258 static int lua_quick_harness(request_rec *r, int lookup)
1263 return lua_request_rec_hook_harness(r, "quick", APR_HOOK_MIDDLE);
1266 static const char *register_translate_name_hook(cmd_parms *cmd, void *_cfg,
1268 const char *function,
1271 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIRECTORY|NOT_IN_FILES|
1273 int apr_hook_when = APR_HOOK_MIDDLE;
1279 if (!strcasecmp(when, "early")) {
1280 apr_hook_when = AP_LUA_HOOK_FIRST;
1282 else if (!strcasecmp(when, "late")) {
1283 apr_hook_when = AP_LUA_HOOK_LAST;
1286 return "Third argument must be 'early' or 'late'";
1290 return register_named_file_function_hook("translate_name", cmd, _cfg,
1291 file, function, apr_hook_when);
1294 static const char *register_translate_name_block(cmd_parms *cmd, void *_cfg,
1297 return register_named_block_function_hook("translate_name", cmd, _cfg,
1302 static const char *register_fixups_hook(cmd_parms *cmd, void *_cfg,
1304 const char *function)
1306 return register_named_file_function_hook("fixups", cmd, _cfg, file,
1307 function, APR_HOOK_MIDDLE);
1309 static const char *register_fixups_block(cmd_parms *cmd, void *_cfg,
1312 return register_named_block_function_hook("fixups", cmd, _cfg, line);
1315 static const char *register_map_to_storage_hook(cmd_parms *cmd, void *_cfg,
1317 const char *function)
1319 return register_named_file_function_hook("map_to_storage", cmd, _cfg,
1320 file, function, APR_HOOK_MIDDLE);
1323 static const char *register_log_transaction_hook(cmd_parms *cmd, void *_cfg,
1325 const char *function)
1327 return register_named_file_function_hook("log_transaction", cmd, _cfg,
1328 file, function, APR_HOOK_FIRST);
1331 static const char *register_map_to_storage_block(cmd_parms *cmd, void *_cfg,
1334 return register_named_block_function_hook("map_to_storage", cmd, _cfg,
1339 static const char *register_check_user_id_hook(cmd_parms *cmd, void *_cfg,
1341 const char *function,
1344 int apr_hook_when = APR_HOOK_MIDDLE;
1345 /* XXX: This does not currently work!!
1347 if (!strcasecmp(when, "early")) {
1348 apr_hook_when = AP_LUA_HOOK_FIRST;
1350 else if (!strcasecmp(when, "late")) {
1351 apr_hook_when = AP_LUA_HOOK_LAST;
1354 return "Third argument must be 'early' or 'late'";
1358 return register_named_file_function_hook("check_user_id", cmd, _cfg, file,
1359 function, apr_hook_when);
1361 static const char *register_check_user_id_block(cmd_parms *cmd, void *_cfg,
1364 return register_named_block_function_hook("check_user_id", cmd, _cfg,
1368 static const char *register_type_checker_hook(cmd_parms *cmd, void *_cfg,
1370 const char *function)
1372 return register_named_file_function_hook("type_checker", cmd, _cfg, file,
1373 function, APR_HOOK_MIDDLE);
1375 static const char *register_type_checker_block(cmd_parms *cmd, void *_cfg,
1378 return register_named_block_function_hook("type_checker", cmd, _cfg,
1382 static const char *register_access_checker_hook(cmd_parms *cmd, void *_cfg,
1384 const char *function,
1387 int apr_hook_when = APR_HOOK_MIDDLE;
1390 if (!strcasecmp(when, "early")) {
1391 apr_hook_when = AP_LUA_HOOK_FIRST;
1393 else if (!strcasecmp(when, "late")) {
1394 apr_hook_when = AP_LUA_HOOK_LAST;
1397 return "Third argument must be 'early' or 'late'";
1401 return register_named_file_function_hook("access_checker", cmd, _cfg,
1402 file, function, apr_hook_when);
1404 static const char *register_access_checker_block(cmd_parms *cmd, void *_cfg,
1408 return register_named_block_function_hook("access_checker", cmd, _cfg,
1412 static const char *register_auth_checker_hook(cmd_parms *cmd, void *_cfg,
1414 const char *function,
1417 int apr_hook_when = APR_HOOK_MIDDLE;
1420 if (!strcasecmp(when, "early")) {
1421 apr_hook_when = AP_LUA_HOOK_FIRST;
1423 else if (!strcasecmp(when, "late")) {
1424 apr_hook_when = AP_LUA_HOOK_LAST;
1427 return "Third argument must be 'early' or 'late'";
1431 return register_named_file_function_hook("auth_checker", cmd, _cfg, file,
1432 function, apr_hook_when);
1434 static const char *register_auth_checker_block(cmd_parms *cmd, void *_cfg,
1437 return register_named_block_function_hook("auth_checker", cmd, _cfg,
1441 static const char *register_insert_filter_hook(cmd_parms *cmd, void *_cfg,
1443 const char *function)
1445 return "LuaHookInsertFilter not yet implemented";
1448 static const char *register_quick_hook(cmd_parms *cmd, void *_cfg,
1449 const char *file, const char *function)
1451 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIRECTORY|NOT_IN_FILES|
1456 return register_named_file_function_hook("quick", cmd, _cfg, file,
1457 function, APR_HOOK_MIDDLE);
1459 static const char *register_map_handler(cmd_parms *cmd, void *_cfg,
1460 const char* match, const char *file, const char *function)
1462 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIRECTORY|NOT_IN_FILES|
1467 if (!function) function = "handle";
1468 return register_mapped_file_function_hook(match, cmd, _cfg, file,
1471 static const char *register_output_filter(cmd_parms *cmd, void *_cfg,
1472 const char* filter, const char *file, const char *function)
1474 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIRECTORY|NOT_IN_FILES|
1479 if (!function) function = "handle";
1480 return register_filter_function_hook(filter, cmd, _cfg, file,
1481 function, AP_LUA_FILTER_OUTPUT);
1483 static const char *register_input_filter(cmd_parms *cmd, void *_cfg,
1484 const char* filter, const char *file, const char *function)
1486 const char *err = ap_check_cmd_context(cmd, NOT_IN_DIRECTORY|NOT_IN_FILES|
1491 if (!function) function = "handle";
1492 return register_filter_function_hook(filter, cmd, _cfg, file,
1493 function, AP_LUA_FILTER_INPUT);
1495 static const char *register_quick_block(cmd_parms *cmd, void *_cfg,
1498 return register_named_block_function_hook("quick", cmd, _cfg,
1504 static const char *register_package_helper(cmd_parms *cmd,
1506 apr_array_header_t *dir_array)
1510 ap_lua_server_cfg *server_cfg =
1511 ap_get_module_config(cmd->server->module_config, &lua_module);
1513 char *fixed_filename;
1514 rv = apr_filepath_merge(&fixed_filename,
1515 server_cfg->root_path,
1517 APR_FILEPATH_NOTRELATIVE,
1520 if (rv != APR_SUCCESS) {
1521 return apr_psprintf(cmd->pool,
1522 "Unable to build full path to file, %s", arg);
1525 *(const char **) apr_array_push(dir_array) = fixed_filename;
1531 * Called for config directive which looks like
1532 * LuaPackagePath /lua/package/path/mapped/thing/like/this/?.lua
1534 static const char *register_package_dir(cmd_parms *cmd, void *_cfg,
1537 ap_lua_dir_cfg *cfg = (ap_lua_dir_cfg *) _cfg;
1539 return register_package_helper(cmd, arg, cfg->package_paths);
1543 * Called for config directive which looks like
1544 * LuaPackageCPath /lua/package/path/mapped/thing/like/this/?.so
1546 static const char *register_package_cdir(cmd_parms *cmd,
1550 ap_lua_dir_cfg *cfg = (ap_lua_dir_cfg *) _cfg;
1552 return register_package_helper(cmd, arg, cfg->package_cpaths);
1555 static const char *register_lua_inherit(cmd_parms *cmd,
1559 ap_lua_dir_cfg *cfg = (ap_lua_dir_cfg *) _cfg;
1561 if (strcasecmp("none", arg) == 0) {
1562 cfg->inherit = AP_LUA_INHERIT_NONE;
1564 else if (strcasecmp("parent-first", arg) == 0) {
1565 cfg->inherit = AP_LUA_INHERIT_PARENT_FIRST;
1567 else if (strcasecmp("parent-last", arg) == 0) {
1568 cfg->inherit = AP_LUA_INHERIT_PARENT_LAST;
1571 return apr_psprintf(cmd->pool,
1572 "LuaInherit type of '%s' not recognized, valid "
1573 "options are 'none', 'parent-first', and 'parent-last'",
1578 static const char *register_lua_codecache(cmd_parms *cmd,
1582 ap_lua_dir_cfg *cfg = (ap_lua_dir_cfg *) _cfg;
1584 if (strcasecmp("never", arg) == 0) {
1585 cfg->codecache = AP_LUA_CACHE_NEVER;
1587 else if (strcasecmp("stat", arg) == 0) {
1588 cfg->codecache = AP_LUA_CACHE_STAT;
1590 else if (strcasecmp("forever", arg) == 0) {
1591 cfg->codecache = AP_LUA_CACHE_FOREVER;
1594 return apr_psprintf(cmd->pool,
1595 "LuaCodeCache type of '%s' not recognized, valid "
1596 "options are 'never', 'stat', and 'forever'",
1601 static const char *register_lua_scope(cmd_parms *cmd,
1607 ap_lua_dir_cfg *cfg = (ap_lua_dir_cfg *) _cfg;
1608 if (strcmp("once", scope) == 0) {
1609 cfg->vm_scope = AP_LUA_SCOPE_ONCE;
1611 else if (strcmp("request", scope) == 0) {
1612 cfg->vm_scope = AP_LUA_SCOPE_REQUEST;
1614 else if (strcmp("conn", scope) == 0) {
1615 cfg->vm_scope = AP_LUA_SCOPE_CONN;
1617 else if (strcmp("thread", scope) == 0) {
1618 #if !APR_HAS_THREADS
1619 return apr_psprintf(cmd->pool,
1620 "Scope type of '%s' cannot be used because this "
1621 "server does not have threading support "
1625 cfg->vm_scope = AP_LUA_SCOPE_THREAD;
1627 else if (strcmp("server", scope) == 0) {
1628 unsigned int vmin, vmax;
1629 #if !APR_HAS_THREADS
1630 return apr_psprintf(cmd->pool,
1631 "Scope type of '%s' cannot be used because this "
1632 "server does not have threading support "
1636 cfg->vm_scope = AP_LUA_SCOPE_SERVER;
1637 vmin = min ? atoi(min) : 1;
1638 vmax = max ? atoi(max) : 1;
1649 return apr_psprintf(cmd->pool,
1650 "Invalid value for LuaScope, '%s', acceptable "
1651 "values are: 'once', 'request', 'conn'"
1653 ", 'thread', 'server'"
1663 static const char *register_lua_root(cmd_parms *cmd, void *_cfg,
1666 /* ap_lua_dir_cfg* cfg = (ap_lua_dir_cfg*)_cfg; */
1667 ap_lua_server_cfg *cfg = ap_get_module_config(cmd->server->module_config,
1670 cfg->root_path = root;
1674 const char *ap_lua_ssl_val(apr_pool_t *p, server_rec *s, conn_rec *c,
1675 request_rec *r, const char *var)
1678 return (const char *)lua_ssl_val(p, s, c, r, (char *)var);
1683 int ap_lua_ssl_is_https(conn_rec *c)
1685 return lua_ssl_is_https ? lua_ssl_is_https(c) : 0;
1688 /*******************************/
1690 static const char *lua_authz_parse(cmd_parms *cmd, const char *require_line,
1691 const void **parsed_require_line)
1693 const char *provider_name;
1694 lua_authz_provider_spec *spec;
1696 apr_pool_userdata_get((void**)&provider_name, AUTHZ_PROVIDER_NAME_NOTE,
1698 ap_assert(provider_name != NULL);
1700 spec = apr_hash_get(lua_authz_providers, provider_name, APR_HASH_KEY_STRING);
1701 ap_assert(spec != NULL);
1703 if (require_line && *require_line) {
1705 spec->args = apr_array_make(cmd->pool, 2, sizeof(const char *));
1706 while ((arg = ap_getword_conf(cmd->pool, &require_line)) && *arg) {
1707 APR_ARRAY_PUSH(spec->args, const char *) = arg;
1711 *parsed_require_line = spec;
1715 static authz_status lua_authz_check(request_rec *r, const char *require_line,
1716 const void *parsed_require_line)
1719 ap_lua_vm_spec *spec;
1721 ap_lua_server_cfg *server_cfg = ap_get_module_config(r->server->module_config,
1723 const ap_lua_dir_cfg *cfg = ap_get_module_config(r->per_dir_config,
1725 const lua_authz_provider_spec *prov_spec = parsed_require_line;
1729 spec = create_vm_spec(&pool, r, cfg, server_cfg, prov_spec->file_name,
1730 NULL, 0, prov_spec->function_name, "authz provider");
1732 L = ap_lua_get_lua_state(pool, spec, r);
1734 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(02314)
1735 "Unable to compile VM for authz provider %s", prov_spec->name);
1736 return AUTHZ_GENERAL_ERROR;
1738 lua_getglobal(L, prov_spec->function_name);
1739 if (!lua_isfunction(L, -1)) {
1740 ap_log_rerror(APLOG_MARK, APLOG_CRIT, 0, r, APLOGNO(02319)
1741 "Unable to find entry function '%s' in %s (not a valid function)",
1742 prov_spec->function_name, prov_spec->file_name);
1743 ap_lua_release_state(L, spec, r);
1744 return AUTHZ_GENERAL_ERROR;
1746 ap_lua_run_lua_request(L, r);
1747 if (prov_spec->args) {
1749 if (!lua_checkstack(L, prov_spec->args->nelts)) {
1750 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(02315)
1751 "Error: authz provider %s: too many arguments", prov_spec->name);
1752 ap_lua_release_state(L, spec, r);
1753 return AUTHZ_GENERAL_ERROR;
1755 for (i = 0; i < prov_spec->args->nelts; i++) {
1756 const char *arg = APR_ARRAY_IDX(prov_spec->args, i, const char *);
1757 lua_pushstring(L, arg);
1759 nargs = prov_spec->args->nelts;
1761 if (lua_pcall(L, 1 + nargs, 1, 0)) {
1762 const char *err = lua_tostring(L, -1);
1763 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(02316)
1764 "Error executing authz provider %s: %s", prov_spec->name, err);
1765 ap_lua_release_state(L, spec, r);
1766 return AUTHZ_GENERAL_ERROR;
1768 if (!lua_isnumber(L, -1)) {
1769 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(02317)
1770 "Error: authz provider %s did not return integer", prov_spec->name);
1771 ap_lua_release_state(L, spec, r);
1772 return AUTHZ_GENERAL_ERROR;
1774 result = lua_tointeger(L, -1);
1775 ap_lua_release_state(L, spec, r);
1780 case AUTHZ_GENERAL_ERROR:
1781 case AUTHZ_DENIED_NO_USER:
1784 ap_log_rerror(APLOG_MARK, APLOG_ERR, 0, r, APLOGNO(02318)
1785 "Error: authz provider %s: invalid return value %d",
1786 prov_spec->name, result);
1788 return AUTHZ_GENERAL_ERROR;
1791 static const authz_provider lua_authz_provider =
1797 static const char *register_authz_provider(cmd_parms *cmd, void *_cfg,
1798 const char *name, const char *file,
1799 const char *function)
1801 lua_authz_provider_spec *spec;
1802 const char *err = ap_check_cmd_context(cmd, GLOBAL_ONLY);
1806 spec = apr_pcalloc(cmd->pool, sizeof(*spec));
1808 spec->file_name = file;
1809 spec->function_name = function;
1811 apr_hash_set(lua_authz_providers, name, APR_HASH_KEY_STRING, spec);
1812 ap_register_auth_provider(cmd->pool, AUTHZ_PROVIDER_GROUP, name,
1813 AUTHZ_PROVIDER_VERSION,
1814 &lua_authz_provider,
1815 AP_AUTH_INTERNAL_PER_CONF);
1820 command_rec lua_commands[] = {
1822 AP_INIT_TAKE1("LuaRoot", register_lua_root, NULL, OR_ALL,
1823 "Specify the base path for resolving relative paths for mod_lua directives"),
1825 AP_INIT_TAKE1("LuaPackagePath", register_package_dir, NULL, OR_ALL,
1826 "Add a directory to lua's package.path"),
1828 AP_INIT_TAKE1("LuaPackageCPath", register_package_cdir, NULL, OR_ALL,
1829 "Add a directory to lua's package.cpath"),
1831 AP_INIT_TAKE3("LuaAuthzProvider", register_authz_provider, NULL, RSRC_CONF|EXEC_ON_READ,
1832 "Provide an authorization provider"),
1834 AP_INIT_TAKE23("LuaHookTranslateName", register_translate_name_hook, NULL,
1836 "Provide a hook for the translate name phase of request processing"),
1838 AP_INIT_RAW_ARGS("<LuaHookTranslateName", register_translate_name_block,
1840 EXEC_ON_READ | OR_ALL,
1841 "Provide a hook for the translate name phase of request processing"),
1843 AP_INIT_TAKE2("LuaHookFixups", register_fixups_hook, NULL, OR_ALL,
1844 "Provide a hook for the fixups phase of request processing"),
1845 AP_INIT_RAW_ARGS("<LuaHookFixups", register_fixups_block, NULL,
1846 EXEC_ON_READ | OR_ALL,
1847 "Provide a inline hook for the fixups phase of request processing"),
1850 AP_INIT_TAKE2("LuaHookMapToStorage", register_map_to_storage_hook, NULL,
1852 "Provide a hook for the map_to_storage phase of request processing"),
1853 AP_INIT_RAW_ARGS("<LuaHookMapToStorage", register_map_to_storage_block,
1855 EXEC_ON_READ | OR_ALL,
1856 "Provide a hook for the map_to_storage phase of request processing"),
1859 AP_INIT_TAKE23("LuaHookCheckUserID", register_check_user_id_hook, NULL,
1861 "Provide a hook for the check_user_id phase of request processing"),
1862 AP_INIT_RAW_ARGS("<LuaHookCheckUserID", register_check_user_id_block,
1864 EXEC_ON_READ | OR_ALL,
1865 "Provide a hook for the check_user_id phase of request processing"),
1868 AP_INIT_TAKE2("LuaHookTypeChecker", register_type_checker_hook, NULL,
1870 "Provide a hook for the type_checker phase of request processing"),
1871 AP_INIT_RAW_ARGS("<LuaHookTypeChecker", register_type_checker_block, NULL,
1872 EXEC_ON_READ | OR_ALL,
1873 "Provide a hook for the type_checker phase of request processing"),
1876 AP_INIT_TAKE23("LuaHookAccessChecker", register_access_checker_hook, NULL,
1878 "Provide a hook for the access_checker phase of request processing"),
1879 AP_INIT_RAW_ARGS("<LuaHookAccessChecker", register_access_checker_block,
1881 EXEC_ON_READ | OR_ALL,
1882 "Provide a hook for the access_checker phase of request processing"),
1885 AP_INIT_TAKE23("LuaHookAuthChecker", register_auth_checker_hook, NULL,
1887 "Provide a hook for the auth_checker phase of request processing"),
1888 AP_INIT_RAW_ARGS("<LuaHookAuthChecker", register_auth_checker_block, NULL,
1889 EXEC_ON_READ | OR_ALL,
1890 "Provide a hook for the auth_checker phase of request processing"),
1893 AP_INIT_TAKE2("LuaHookInsertFilter", register_insert_filter_hook, NULL,
1895 "Provide a hook for the insert_filter phase of request processing"),
1897 AP_INIT_TAKE2("LuaHookLog", register_log_transaction_hook, NULL,
1899 "Provide a hook for the logging phase of request processing"),
1901 AP_INIT_TAKE123("LuaScope", register_lua_scope, NULL, OR_ALL,
1902 "One of once, request, conn, server -- default is once"),
1904 AP_INIT_TAKE1("LuaInherit", register_lua_inherit, NULL, OR_ALL,
1905 "Controls how Lua scripts in parent contexts are merged with the current "
1906 " context: none|parent-last|parent-first (default: parent-first) "),
1908 AP_INIT_TAKE1("LuaCodeCache", register_lua_codecache, NULL, OR_ALL,
1909 "Controls the behavior of the in-memory code cache "
1910 " context: stat|forever|never (default: stat) "),
1912 AP_INIT_TAKE2("LuaQuickHandler", register_quick_hook, NULL, OR_ALL,
1913 "Provide a hook for the quick handler of request processing"),
1914 AP_INIT_RAW_ARGS("<LuaQuickHandler", register_quick_block, NULL,
1915 EXEC_ON_READ | OR_ALL,
1916 "Provide a hook for the quick handler of request processing"),
1917 AP_INIT_RAW_ARGS("Lua_____ByteCodeHack", hack_section_handler, NULL,
1919 "(internal) Byte code handler"),
1920 AP_INIT_TAKE23("LuaMapHandler", register_map_handler, NULL, OR_ALL,
1921 "Maps a path to a lua handler"),
1922 AP_INIT_TAKE3("LuaOutputFilter", register_output_filter, NULL, OR_ALL,
1923 "Registers a Lua function as an output filter"),
1924 AP_INIT_TAKE3("LuaInputFilter", register_input_filter, NULL, OR_ALL,
1925 "Registers a Lua function as an input filter"),
1930 static void *create_dir_config(apr_pool_t *p, char *dir)
1932 ap_lua_dir_cfg *cfg = apr_pcalloc(p, sizeof(ap_lua_dir_cfg));
1933 cfg->package_paths = apr_array_make(p, 2, sizeof(char *));
1934 cfg->package_cpaths = apr_array_make(p, 2, sizeof(char *));
1935 cfg->mapped_handlers =
1936 apr_array_make(p, 1, sizeof(ap_lua_mapped_handler_spec *));
1937 cfg->mapped_filters =
1938 apr_array_make(p, 1, sizeof(ap_lua_filter_handler_spec *));
1940 cfg->hooks = apr_hash_make(p);
1941 cfg->dir = apr_pstrdup(p, dir);
1942 cfg->vm_scope = AP_LUA_SCOPE_UNSET;
1943 cfg->codecache = AP_LUA_CACHE_UNSET;
1950 static int create_request_config(request_rec *r)
1952 ap_lua_request_cfg *cfg = apr_palloc(r->pool, sizeof(ap_lua_request_cfg));
1953 cfg->mapped_request_details = NULL;
1954 cfg->request_scoped_vms = apr_hash_make(r->pool);
1955 ap_set_module_config(r->request_config, &lua_module, cfg);
1959 static void *create_server_config(apr_pool_t *p, server_rec *s)
1962 ap_lua_server_cfg *cfg = apr_pcalloc(p, sizeof(ap_lua_server_cfg));
1963 cfg->root_path = NULL;
1968 static int lua_request_hook(lua_State *L, request_rec *r)
1970 ap_lua_push_request(L, r);
1974 static int lua_pre_config(apr_pool_t *pconf, apr_pool_t *plog,
1977 ap_mutex_register(pconf, "lua-ivm-shm", NULL, APR_LOCK_DEFAULT, 0);
1981 static int lua_post_config(apr_pool_t *pconf, apr_pool_t *plog,
1982 apr_pool_t *ptemp, server_rec *s)
1985 const char *tempdir;
1988 lua_ssl_val = APR_RETRIEVE_OPTIONAL_FN(ssl_var_lookup);
1989 lua_ssl_is_https = APR_RETRIEVE_OPTIONAL_FN(ssl_is_https);
1991 if (ap_state_query(AP_SQ_MAIN_STATE) == AP_SQ_MS_CREATE_PRE_CONFIG)
1994 /* Create ivm mutex */
1995 rs = ap_global_mutex_create(&lua_ivm_mutex, NULL, "lua-ivm-shm", NULL,
1997 if (APR_SUCCESS != rs) {
1998 return HTTP_INTERNAL_SERVER_ERROR;
2001 /* Create shared memory space */
2002 rs = apr_temp_dir_get(&tempdir, pconf);
2003 if (rs != APR_SUCCESS) {
2004 ap_log_error(APLOG_MARK, APLOG_ERR, rs, s, APLOGNO(02664)
2005 "mod_lua IVM: Failed to find temporary directory");
2006 return HTTP_INTERNAL_SERVER_ERROR;
2008 lua_ivm_shmfile = apr_psprintf(pconf, "%s/httpd_lua_shm.%ld", tempdir,
2009 (long int)getpid());
2010 rs = apr_shm_create(&lua_ivm_shm, sizeof(apr_pool_t**),
2011 (const char *) lua_ivm_shmfile, pconf);
2012 if (rs != APR_SUCCESS) {
2013 ap_log_error(APLOG_MARK, APLOG_ERR, rs, s, APLOGNO(02665)
2014 "mod_lua: Failed to create shared memory segment on file %s",
2016 return HTTP_INTERNAL_SERVER_ERROR;
2018 pool = (apr_pool_t **)apr_shm_baseaddr_get(lua_ivm_shm);
2019 apr_pool_create(pool, pconf);
2020 apr_pool_cleanup_register(pconf, NULL, shm_cleanup_wrapper,
2021 apr_pool_cleanup_null);
2024 static void *overlay_hook_specs(apr_pool_t *p,
2027 const void *overlay_val,
2028 const void *base_val,
2031 const apr_array_header_t *overlay_info = (const apr_array_header_t*)overlay_val;
2032 const apr_array_header_t *base_info = (const apr_array_header_t*)base_val;
2033 return apr_array_append(p, base_info, overlay_info);
2036 static void *merge_dir_config(apr_pool_t *p, void *basev, void *overridesv)
2038 ap_lua_dir_cfg *a, *base, *overrides;
2040 a = (ap_lua_dir_cfg *)apr_pcalloc(p, sizeof(ap_lua_dir_cfg));
2041 base = (ap_lua_dir_cfg*)basev;
2042 overrides = (ap_lua_dir_cfg*)overridesv;
2044 a->pool = overrides->pool;
2045 a->dir = apr_pstrdup(p, overrides->dir);
2047 a->vm_scope = (overrides->vm_scope == AP_LUA_SCOPE_UNSET) ? base->vm_scope: overrides->vm_scope;
2048 a->inherit = (overrides->inherit == AP_LUA_INHERIT_UNSET) ? base->inherit : overrides->inherit;
2049 a->codecache = (overrides->codecache == AP_LUA_CACHE_UNSET) ? base->codecache : overrides->codecache;
2051 a->vm_min = (overrides->vm_min == 0) ? base->vm_min : overrides->vm_min;
2052 a->vm_max = (overrides->vm_max == 0) ? base->vm_max : overrides->vm_max;
2054 if (a->inherit == AP_LUA_INHERIT_UNSET || a->inherit == AP_LUA_INHERIT_PARENT_FIRST) {
2055 a->package_paths = apr_array_append(p, base->package_paths, overrides->package_paths);
2056 a->package_cpaths = apr_array_append(p, base->package_cpaths, overrides->package_cpaths);
2057 a->mapped_handlers = apr_array_append(p, base->mapped_handlers, overrides->mapped_handlers);
2058 a->mapped_filters = apr_array_append(p, base->mapped_filters, overrides->mapped_filters);
2059 a->hooks = apr_hash_merge(p, overrides->hooks, base->hooks, overlay_hook_specs, NULL);
2061 else if (a->inherit == AP_LUA_INHERIT_PARENT_LAST) {
2062 a->package_paths = apr_array_append(p, overrides->package_paths, base->package_paths);
2063 a->package_cpaths = apr_array_append(p, overrides->package_cpaths, base->package_cpaths);
2064 a->mapped_handlers = apr_array_append(p, overrides->mapped_handlers, base->mapped_handlers);
2065 a->mapped_filters = apr_array_append(p, overrides->mapped_filters, base->mapped_filters);
2066 a->hooks = apr_hash_merge(p, base->hooks, overrides->hooks, overlay_hook_specs, NULL);
2069 a->package_paths = overrides->package_paths;
2070 a->package_cpaths = overrides->package_cpaths;
2071 a->mapped_handlers= overrides->mapped_handlers;
2072 a->mapped_filters= overrides->mapped_filters;
2073 a->hooks= overrides->hooks;
2079 static void lua_register_hooks(apr_pool_t *p)
2081 /* ap_register_output_filter("luahood", luahood, NULL, AP_FTYPE_RESOURCE); */
2082 ap_hook_handler(lua_handler, NULL, NULL, APR_HOOK_MIDDLE);
2083 ap_hook_create_request(create_request_config, NULL, NULL,
2086 /* http_request.h hooks */
2087 ap_hook_translate_name(lua_translate_name_harness_first, NULL, NULL,
2089 ap_hook_translate_name(lua_translate_name_harness, NULL, NULL,
2091 ap_hook_translate_name(lua_translate_name_harness_last, NULL, NULL,
2094 ap_hook_fixups(lua_fixup_harness, NULL, NULL, APR_HOOK_MIDDLE);
2095 ap_hook_map_to_storage(lua_map_to_storage_harness, NULL, NULL,
2098 /* XXX: Does not work :(
2099 * ap_hook_check_user_id(lua_check_user_id_harness_first, NULL, NULL,
2102 ap_hook_check_user_id(lua_check_user_id_harness, NULL, NULL,
2104 /* XXX: Does not work :(
2105 * ap_hook_check_user_id(lua_check_user_id_harness_last, NULL, NULL,
2108 ap_hook_type_checker(lua_type_checker_harness, NULL, NULL,
2111 ap_hook_access_checker(lua_access_checker_harness_first, NULL, NULL,
2113 ap_hook_access_checker(lua_access_checker_harness, NULL, NULL,
2115 ap_hook_access_checker(lua_access_checker_harness_last, NULL, NULL,
2117 ap_hook_auth_checker(lua_auth_checker_harness_first, NULL, NULL,
2119 ap_hook_auth_checker(lua_auth_checker_harness, NULL, NULL,
2121 ap_hook_auth_checker(lua_auth_checker_harness_last, NULL, NULL,
2124 ap_hook_insert_filter(lua_insert_filter_harness, NULL, NULL,
2126 ap_hook_quick_handler(lua_quick_harness, NULL, NULL, APR_HOOK_FIRST);
2128 ap_hook_post_config(lua_post_config, NULL, NULL, APR_HOOK_MIDDLE);
2129 ap_hook_pre_config(lua_pre_config, NULL, NULL, APR_HOOK_MIDDLE);
2131 APR_OPTIONAL_HOOK(ap_lua, lua_open, lua_open_hook, NULL, NULL,
2132 APR_HOOK_REALLY_FIRST);
2134 APR_OPTIONAL_HOOK(ap_lua, lua_request, lua_request_hook, NULL, NULL,
2135 APR_HOOK_REALLY_FIRST);
2136 ap_hook_handler(lua_map_handler, NULL, NULL, AP_LUA_HOOK_FIRST);
2138 /* Hook this right before FallbackResource kicks in */
2139 ap_hook_fixups(lua_map_handler_fixups, NULL, NULL, AP_LUA_HOOK_LAST-2);
2141 ap_hook_child_init(ap_lua_init_mutex, NULL, NULL, APR_HOOK_MIDDLE);
2144 lua_authz_providers = apr_hash_make(p);
2146 /* Logging catcher */
2147 ap_hook_log_transaction(lua_log_transaction_harness,NULL,NULL,
2151 AP_DECLARE_MODULE(lua) = {
2152 STANDARD20_MODULE_STUFF,
2153 create_dir_config, /* create per-dir config structures */
2154 merge_dir_config, /* merge per-dir config structures */
2155 create_server_config, /* create per-server config structures */
2156 NULL, /* merge per-server config structures */
2157 lua_commands, /* table of config file commands */
2158 lua_register_hooks /* register hooks */