RubyGems - immunio - Versions diffs - 0.15.4 → 0.16.0 - Mend

immunio 0.15.4 → 0.16.0

Files changed (454) hide show

checksums.yaml +4 -4
data/LICENSE +0 -27
data/ext/immunio/Rakefile +9 -0
data/lib/immunio/plugins/active_record.rb +1 -1
data/lib/immunio/plugins/active_record_relation.rb +1 -1
data/lib/immunio/plugins/environment_reporter.rb +20 -0
data/lib/immunio/rufus_lua_ext/ref.rb +1 -3
data/lib/immunio/version.rb +1 -1
data/lib/immunio/vm.rb +1 -2
data/lua-hooks/Makefile +97 -0
data/lua-hooks/ext/all.c +41 -52
data/lua-hooks/ext/all.o +0 -0
data/lua-hooks/ext/libinjection/libinjection_html5.o +0 -0
data/lua-hooks/ext/libinjection/libinjection_sqli.o +0 -0
data/lua-hooks/ext/libinjection/libinjection_xss.o +0 -0
data/lua-hooks/ext/libinjection/lualib.c +2 -2
data/lua-hooks/ext/lpeg/lpcap.c +2 -2
data/lua-hooks/ext/lpeg/lpcap.o +0 -0
data/lua-hooks/ext/lpeg/lpcode.c +2 -2
data/lua-hooks/ext/lpeg/lpcode.h +1 -1
data/lua-hooks/ext/lpeg/lpcode.o +0 -0
data/lua-hooks/ext/lpeg/lpprint.o +0 -0
data/lua-hooks/ext/lpeg/lptree.c +2 -2
data/lua-hooks/ext/lpeg/lptypes.h +1 -1
data/lua-hooks/ext/lpeg/lpvm.c +2 -2
data/lua-hooks/ext/lpeg/lpvm.o +0 -0
data/lua-hooks/ext/lua-cmsgpack/lua_cmsgpack.c +16 -3
data/lua-hooks/ext/lua-snapshot/snapshot.c +14 -7
data/lua-hooks/ext/luajit/COPYRIGHT +56 -0
data/lua-hooks/ext/luajit/Makefile +159 -0
data/lua-hooks/ext/luajit/README +16 -0
data/lua-hooks/ext/luajit/doc/bluequad-print.css +166 -0
data/lua-hooks/ext/luajit/doc/bluequad.css +325 -0
data/lua-hooks/ext/luajit/doc/changes.html +804 -0
data/lua-hooks/ext/luajit/doc/contact.html +104 -0
data/lua-hooks/ext/luajit/doc/ext_c_api.html +189 -0
data/lua-hooks/ext/luajit/doc/ext_ffi.html +332 -0
data/lua-hooks/ext/luajit/doc/ext_ffi_api.html +570 -0
data/lua-hooks/ext/luajit/doc/ext_ffi_semantics.html +1261 -0
data/lua-hooks/ext/luajit/doc/ext_ffi_tutorial.html +603 -0
data/lua-hooks/ext/luajit/doc/ext_jit.html +201 -0
data/lua-hooks/ext/luajit/doc/ext_profiler.html +365 -0
data/lua-hooks/ext/luajit/doc/extensions.html +448 -0
data/lua-hooks/ext/luajit/doc/faq.html +186 -0
data/lua-hooks/ext/luajit/doc/img/contact.png +0 -0
data/lua-hooks/ext/luajit/doc/install.html +659 -0
data/lua-hooks/ext/luajit/doc/luajit.html +236 -0
data/lua-hooks/ext/luajit/doc/running.html +309 -0
data/lua-hooks/ext/luajit/doc/status.html +118 -0
data/lua-hooks/ext/luajit/dynasm/dasm_arm.h +456 -0
data/lua-hooks/ext/luajit/dynasm/dasm_arm.lua +1125 -0
data/lua-hooks/ext/luajit/dynasm/dasm_arm64.h +518 -0
data/lua-hooks/ext/luajit/dynasm/dasm_arm64.lua +1166 -0
data/lua-hooks/ext/luajit/dynasm/dasm_mips.h +416 -0
data/lua-hooks/ext/luajit/dynasm/dasm_mips.lua +953 -0
data/lua-hooks/ext/luajit/dynasm/dasm_ppc.h +419 -0
data/lua-hooks/ext/luajit/dynasm/dasm_ppc.lua +1919 -0
data/lua-hooks/ext/luajit/dynasm/dasm_proto.h +83 -0
data/lua-hooks/ext/luajit/dynasm/dasm_x64.lua +12 -0
data/lua-hooks/ext/luajit/dynasm/dasm_x86.h +471 -0
data/lua-hooks/ext/luajit/dynasm/dasm_x86.lua +1945 -0
data/lua-hooks/ext/luajit/dynasm/dynasm.lua +1094 -0
data/lua-hooks/ext/luajit/etc/luajit.1 +88 -0
data/lua-hooks/ext/luajit/etc/luajit.pc +25 -0
data/lua-hooks/ext/luajit/src/Makefile +697 -0
data/lua-hooks/ext/luajit/src/Makefile.dep +244 -0
data/lua-hooks/ext/luajit/src/host/README +4 -0
data/lua-hooks/ext/luajit/src/host/buildvm +0 -0
data/lua-hooks/ext/luajit/src/host/buildvm.c +518 -0
data/lua-hooks/ext/luajit/src/host/buildvm.h +105 -0
data/lua-hooks/ext/luajit/src/host/buildvm.o +0 -0
data/lua-hooks/ext/luajit/src/host/buildvm_arch.h +7449 -0
data/lua-hooks/ext/luajit/src/host/buildvm_asm.c +345 -0
data/lua-hooks/ext/luajit/src/host/buildvm_asm.o +0 -0
data/lua-hooks/ext/luajit/src/host/buildvm_fold.c +229 -0
data/lua-hooks/ext/luajit/src/host/buildvm_fold.o +0 -0
data/lua-hooks/ext/luajit/src/host/buildvm_lib.c +457 -0
data/lua-hooks/ext/luajit/src/host/buildvm_lib.o +0 -0
data/lua-hooks/ext/luajit/src/host/buildvm_libbc.h +45 -0
data/lua-hooks/ext/luajit/src/host/buildvm_peobj.c +368 -0
data/lua-hooks/ext/luajit/src/host/buildvm_peobj.o +0 -0
data/lua-hooks/ext/luajit/src/host/genlibbc.lua +197 -0
data/lua-hooks/ext/luajit/src/host/genminilua.lua +428 -0
data/lua-hooks/ext/luajit/src/host/minilua +0 -0
data/lua-hooks/ext/luajit/src/host/minilua.c +7770 -0
data/lua-hooks/ext/luajit/src/host/minilua.o +0 -0
data/lua-hooks/ext/luajit/src/jit/bc.lua +190 -0
data/lua-hooks/ext/luajit/src/jit/bcsave.lua +661 -0
data/lua-hooks/ext/luajit/src/jit/dis_arm.lua +689 -0
data/lua-hooks/ext/luajit/src/jit/dis_mips.lua +428 -0
data/lua-hooks/ext/luajit/src/jit/dis_mipsel.lua +17 -0
data/lua-hooks/ext/luajit/src/jit/dis_ppc.lua +591 -0
data/lua-hooks/ext/luajit/src/jit/dis_x64.lua +17 -0
data/lua-hooks/ext/luajit/src/jit/dis_x86.lua +838 -0
data/lua-hooks/ext/luajit/src/jit/dump.lua +706 -0
data/lua-hooks/ext/luajit/src/jit/p.lua +310 -0
data/lua-hooks/ext/luajit/src/jit/v.lua +170 -0
data/lua-hooks/ext/luajit/src/jit/vmdef.lua +362 -0
data/lua-hooks/ext/luajit/src/jit/zone.lua +45 -0
data/lua-hooks/ext/{lua → luajit/src}/lauxlib.h +10 -17
data/lua-hooks/ext/luajit/src/lib_aux.c +356 -0
data/lua-hooks/ext/luajit/src/lib_aux.o +0 -0
data/lua-hooks/ext/luajit/src/lib_aux_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_base.c +664 -0
data/lua-hooks/ext/luajit/src/lib_base.o +0 -0
data/lua-hooks/ext/luajit/src/lib_base_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_bit.c +180 -0
data/lua-hooks/ext/luajit/src/lib_bit.o +0 -0
data/lua-hooks/ext/luajit/src/lib_bit_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_debug.c +405 -0
data/lua-hooks/ext/luajit/src/lib_debug.o +0 -0
data/lua-hooks/ext/luajit/src/lib_debug_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_ffi.c +872 -0
data/lua-hooks/ext/luajit/src/lib_ffi.o +0 -0
data/lua-hooks/ext/luajit/src/lib_ffi_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_init.c +55 -0
data/lua-hooks/ext/luajit/src/lib_init.o +0 -0
data/lua-hooks/ext/luajit/src/lib_init_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_io.c +541 -0
data/lua-hooks/ext/luajit/src/lib_io.o +0 -0
data/lua-hooks/ext/luajit/src/lib_io_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_jit.c +767 -0
data/lua-hooks/ext/luajit/src/lib_jit.o +0 -0
data/lua-hooks/ext/luajit/src/lib_jit_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_math.c +230 -0
data/lua-hooks/ext/luajit/src/lib_math.o +0 -0
data/lua-hooks/ext/luajit/src/lib_math_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_os.c +292 -0
data/lua-hooks/ext/luajit/src/lib_os.o +0 -0
data/lua-hooks/ext/luajit/src/lib_os_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_package.c +610 -0
data/lua-hooks/ext/luajit/src/lib_package.o +0 -0
data/lua-hooks/ext/luajit/src/lib_package_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_string.c +752 -0
data/lua-hooks/ext/luajit/src/lib_string.o +0 -0
data/lua-hooks/ext/luajit/src/lib_string_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lib_table.c +307 -0
data/lua-hooks/ext/luajit/src/lib_table.o +0 -0
data/lua-hooks/ext/luajit/src/lib_table_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/libluajit.a +0 -0
data/lua-hooks/ext/luajit/src/libluajit.so +0 -0
data/lua-hooks/ext/luajit/src/lj.supp +26 -0
data/lua-hooks/ext/luajit/src/lj_alloc.c +1398 -0
data/lua-hooks/ext/luajit/src/lj_alloc.h +17 -0
data/lua-hooks/ext/luajit/src/lj_alloc.o +0 -0
data/lua-hooks/ext/luajit/src/lj_alloc_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_api.c +1210 -0
data/lua-hooks/ext/luajit/src/lj_api.o +0 -0
data/lua-hooks/ext/luajit/src/lj_api_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_arch.h +509 -0
data/lua-hooks/ext/luajit/src/lj_asm.c +2278 -0
data/lua-hooks/ext/luajit/src/lj_asm.h +17 -0
data/lua-hooks/ext/luajit/src/lj_asm.o +0 -0
data/lua-hooks/ext/luajit/src/lj_asm_arm.h +2217 -0
data/lua-hooks/ext/luajit/src/lj_asm_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_asm_mips.h +1833 -0
data/lua-hooks/ext/luajit/src/lj_asm_ppc.h +2015 -0
data/lua-hooks/ext/luajit/src/lj_asm_x86.h +2634 -0
data/lua-hooks/ext/luajit/src/lj_bc.c +14 -0
data/lua-hooks/ext/luajit/src/lj_bc.h +265 -0
data/lua-hooks/ext/luajit/src/lj_bc.o +0 -0
data/lua-hooks/ext/luajit/src/lj_bc_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_bcdef.h +220 -0
data/lua-hooks/ext/luajit/src/lj_bcdump.h +68 -0
data/lua-hooks/ext/luajit/src/lj_bcread.c +457 -0
data/lua-hooks/ext/luajit/src/lj_bcread.o +0 -0
data/lua-hooks/ext/luajit/src/lj_bcread_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_bcwrite.c +361 -0
data/lua-hooks/ext/luajit/src/lj_bcwrite.o +0 -0
data/lua-hooks/ext/luajit/src/lj_bcwrite_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_buf.c +234 -0
data/lua-hooks/ext/luajit/src/lj_buf.h +105 -0
data/lua-hooks/ext/luajit/src/lj_buf.o +0 -0
data/lua-hooks/ext/luajit/src/lj_buf_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_carith.c +429 -0
data/lua-hooks/ext/luajit/src/lj_carith.h +37 -0
data/lua-hooks/ext/luajit/src/lj_carith.o +0 -0
data/lua-hooks/ext/luajit/src/lj_carith_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_ccall.c +984 -0
data/lua-hooks/ext/luajit/src/lj_ccall.h +178 -0
data/lua-hooks/ext/luajit/src/lj_ccall.o +0 -0
data/lua-hooks/ext/luajit/src/lj_ccall_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_ccallback.c +712 -0
data/lua-hooks/ext/luajit/src/lj_ccallback.h +25 -0
data/lua-hooks/ext/luajit/src/lj_ccallback.o +0 -0
data/lua-hooks/ext/luajit/src/lj_ccallback_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_cconv.c +752 -0
data/lua-hooks/ext/luajit/src/lj_cconv.h +70 -0
data/lua-hooks/ext/luajit/src/lj_cconv.o +0 -0
data/lua-hooks/ext/luajit/src/lj_cconv_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_cdata.c +288 -0
data/lua-hooks/ext/luajit/src/lj_cdata.h +76 -0
data/lua-hooks/ext/luajit/src/lj_cdata.o +0 -0
data/lua-hooks/ext/luajit/src/lj_cdata_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_char.c +43 -0
data/lua-hooks/ext/luajit/src/lj_char.h +42 -0
data/lua-hooks/ext/luajit/src/lj_char.o +0 -0
data/lua-hooks/ext/luajit/src/lj_char_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_clib.c +418 -0
data/lua-hooks/ext/luajit/src/lj_clib.h +29 -0
data/lua-hooks/ext/luajit/src/lj_clib.o +0 -0
data/lua-hooks/ext/luajit/src/lj_clib_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_cparse.c +1862 -0
data/lua-hooks/ext/luajit/src/lj_cparse.h +65 -0
data/lua-hooks/ext/luajit/src/lj_cparse.o +0 -0
data/lua-hooks/ext/luajit/src/lj_cparse_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_crecord.c +1834 -0
data/lua-hooks/ext/luajit/src/lj_crecord.h +38 -0
data/lua-hooks/ext/luajit/src/lj_crecord.o +0 -0
data/lua-hooks/ext/luajit/src/lj_crecord_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_ctype.c +635 -0
data/lua-hooks/ext/luajit/src/lj_ctype.h +461 -0
data/lua-hooks/ext/luajit/src/lj_ctype.o +0 -0
data/lua-hooks/ext/luajit/src/lj_ctype_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_debug.c +699 -0
data/lua-hooks/ext/luajit/src/lj_debug.h +65 -0
data/lua-hooks/ext/luajit/src/lj_debug.o +0 -0
data/lua-hooks/ext/luajit/src/lj_debug_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_def.h +365 -0
data/lua-hooks/ext/luajit/src/lj_dispatch.c +557 -0
data/lua-hooks/ext/luajit/src/lj_dispatch.h +138 -0
data/lua-hooks/ext/luajit/src/lj_dispatch.o +0 -0
data/lua-hooks/ext/luajit/src/lj_dispatch_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_emit_arm.h +356 -0
data/lua-hooks/ext/luajit/src/lj_emit_mips.h +211 -0
data/lua-hooks/ext/luajit/src/lj_emit_ppc.h +238 -0
data/lua-hooks/ext/luajit/src/lj_emit_x86.h +462 -0
data/lua-hooks/ext/luajit/src/lj_err.c +794 -0
data/lua-hooks/ext/luajit/src/lj_err.h +41 -0
data/lua-hooks/ext/luajit/src/lj_err.o +0 -0
data/lua-hooks/ext/luajit/src/lj_err_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_errmsg.h +190 -0
data/lua-hooks/ext/luajit/src/lj_ff.h +18 -0
data/lua-hooks/ext/luajit/src/lj_ffdef.h +209 -0
data/lua-hooks/ext/luajit/src/lj_ffrecord.c +1247 -0
data/lua-hooks/ext/luajit/src/lj_ffrecord.h +24 -0
data/lua-hooks/ext/luajit/src/lj_ffrecord.o +0 -0
data/lua-hooks/ext/luajit/src/lj_ffrecord_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_folddef.h +1138 -0
data/lua-hooks/ext/luajit/src/lj_frame.h +259 -0
data/lua-hooks/ext/luajit/src/lj_func.c +185 -0
data/lua-hooks/ext/luajit/src/lj_func.h +24 -0
data/lua-hooks/ext/luajit/src/lj_func.o +0 -0
data/lua-hooks/ext/luajit/src/lj_func_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_gc.c +845 -0
data/lua-hooks/ext/luajit/src/lj_gc.h +134 -0
data/lua-hooks/ext/luajit/src/lj_gc.o +0 -0
data/lua-hooks/ext/luajit/src/lj_gc_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_gdbjit.c +787 -0
data/lua-hooks/ext/luajit/src/lj_gdbjit.h +22 -0
data/lua-hooks/ext/luajit/src/lj_gdbjit.o +0 -0
data/lua-hooks/ext/luajit/src/lj_gdbjit_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_ir.c +505 -0
data/lua-hooks/ext/luajit/src/lj_ir.h +577 -0
data/lua-hooks/ext/luajit/src/lj_ir.o +0 -0
data/lua-hooks/ext/luajit/src/lj_ir_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_ircall.h +321 -0
data/lua-hooks/ext/luajit/src/lj_iropt.h +161 -0
data/lua-hooks/ext/luajit/src/lj_jit.h +440 -0
data/lua-hooks/ext/luajit/src/lj_lex.c +482 -0
data/lua-hooks/ext/luajit/src/lj_lex.h +86 -0
data/lua-hooks/ext/luajit/src/lj_lex.o +0 -0
data/lua-hooks/ext/luajit/src/lj_lex_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_lib.c +303 -0
data/lua-hooks/ext/luajit/src/lj_lib.h +115 -0
data/lua-hooks/ext/luajit/src/lj_lib.o +0 -0
data/lua-hooks/ext/luajit/src/lj_lib_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_libdef.h +414 -0
data/lua-hooks/ext/luajit/src/lj_load.c +168 -0
data/lua-hooks/ext/luajit/src/lj_load.o +0 -0
data/lua-hooks/ext/luajit/src/lj_load_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_mcode.c +386 -0
data/lua-hooks/ext/luajit/src/lj_mcode.h +30 -0
data/lua-hooks/ext/luajit/src/lj_mcode.o +0 -0
data/lua-hooks/ext/luajit/src/lj_mcode_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_meta.c +477 -0
data/lua-hooks/ext/luajit/src/lj_meta.h +38 -0
data/lua-hooks/ext/luajit/src/lj_meta.o +0 -0
data/lua-hooks/ext/luajit/src/lj_meta_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_obj.c +50 -0
data/lua-hooks/ext/luajit/src/lj_obj.h +976 -0
data/lua-hooks/ext/luajit/src/lj_obj.o +0 -0
data/lua-hooks/ext/luajit/src/lj_obj_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_dce.c +78 -0
data/lua-hooks/ext/luajit/src/lj_opt_dce.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_dce_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_fold.c +2488 -0
data/lua-hooks/ext/luajit/src/lj_opt_fold.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_fold_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_loop.c +449 -0
data/lua-hooks/ext/luajit/src/lj_opt_loop.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_loop_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_mem.c +935 -0
data/lua-hooks/ext/luajit/src/lj_opt_mem.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_mem_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_narrow.c +652 -0
data/lua-hooks/ext/luajit/src/lj_opt_narrow.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_narrow_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_sink.c +245 -0
data/lua-hooks/ext/luajit/src/lj_opt_sink.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_sink_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_split.c +856 -0
data/lua-hooks/ext/luajit/src/lj_opt_split.o +0 -0
data/lua-hooks/ext/luajit/src/lj_opt_split_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_parse.c +2725 -0
data/lua-hooks/ext/luajit/src/lj_parse.h +18 -0
data/lua-hooks/ext/luajit/src/lj_parse.o +0 -0
data/lua-hooks/ext/luajit/src/lj_parse_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_profile.c +368 -0
data/lua-hooks/ext/luajit/src/lj_profile.h +21 -0
data/lua-hooks/ext/luajit/src/lj_profile.o +0 -0
data/lua-hooks/ext/luajit/src/lj_profile_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_recdef.h +270 -0
data/lua-hooks/ext/luajit/src/lj_record.c +2554 -0
data/lua-hooks/ext/luajit/src/lj_record.h +45 -0
data/lua-hooks/ext/luajit/src/lj_record.o +0 -0
data/lua-hooks/ext/luajit/src/lj_record_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_snap.c +870 -0
data/lua-hooks/ext/luajit/src/lj_snap.h +34 -0
data/lua-hooks/ext/luajit/src/lj_snap.o +0 -0
data/lua-hooks/ext/luajit/src/lj_snap_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_state.c +300 -0
data/lua-hooks/ext/luajit/src/lj_state.h +35 -0
data/lua-hooks/ext/luajit/src/lj_state.o +0 -0
data/lua-hooks/ext/luajit/src/lj_state_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_str.c +197 -0
data/lua-hooks/ext/luajit/src/lj_str.h +27 -0
data/lua-hooks/ext/luajit/src/lj_str.o +0 -0
data/lua-hooks/ext/luajit/src/lj_str_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_strfmt.c +554 -0
data/lua-hooks/ext/luajit/src/lj_strfmt.h +125 -0
data/lua-hooks/ext/luajit/src/lj_strfmt.o +0 -0
data/lua-hooks/ext/luajit/src/lj_strfmt_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_strscan.c +547 -0
data/lua-hooks/ext/luajit/src/lj_strscan.h +39 -0
data/lua-hooks/ext/luajit/src/lj_strscan.o +0 -0
data/lua-hooks/ext/luajit/src/lj_strscan_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_tab.c +666 -0
data/lua-hooks/ext/luajit/src/lj_tab.h +73 -0
data/lua-hooks/ext/luajit/src/lj_tab.o +0 -0
data/lua-hooks/ext/luajit/src/lj_tab_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_target.h +164 -0
data/lua-hooks/ext/luajit/src/lj_target_arm.h +270 -0
data/lua-hooks/ext/luajit/src/lj_target_arm64.h +97 -0
data/lua-hooks/ext/luajit/src/lj_target_mips.h +260 -0
data/lua-hooks/ext/luajit/src/lj_target_ppc.h +280 -0
data/lua-hooks/ext/luajit/src/lj_target_x86.h +345 -0
data/lua-hooks/ext/luajit/src/lj_trace.c +859 -0
data/lua-hooks/ext/luajit/src/lj_trace.h +54 -0
data/lua-hooks/ext/luajit/src/lj_trace.o +0 -0
data/lua-hooks/ext/luajit/src/lj_trace_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_traceerr.h +63 -0
data/lua-hooks/ext/luajit/src/lj_udata.c +34 -0
data/lua-hooks/ext/luajit/src/lj_udata.h +14 -0
data/lua-hooks/ext/luajit/src/lj_udata.o +0 -0
data/lua-hooks/ext/luajit/src/lj_udata_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_vm.S +2730 -0
data/lua-hooks/ext/luajit/src/lj_vm.h +114 -0
data/lua-hooks/ext/luajit/src/lj_vm.o +0 -0
data/lua-hooks/ext/luajit/src/lj_vm_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_vmevent.c +58 -0
data/lua-hooks/ext/luajit/src/lj_vmevent.h +59 -0
data/lua-hooks/ext/luajit/src/lj_vmevent.o +0 -0
data/lua-hooks/ext/luajit/src/lj_vmevent_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/lj_vmmath.c +152 -0
data/lua-hooks/ext/luajit/src/lj_vmmath.o +0 -0
data/lua-hooks/ext/luajit/src/lj_vmmath_dyn.o +0 -0
data/lua-hooks/ext/luajit/src/ljamalg.c +96 -0
data/lua-hooks/ext/{lua → luajit/src}/lua.h +12 -7
data/lua-hooks/ext/luajit/src/lua.hpp +9 -0
data/lua-hooks/ext/luajit/src/luaconf.h +156 -0
data/lua-hooks/ext/luajit/src/luajit +0 -0
data/lua-hooks/ext/luajit/src/luajit.c +570 -0
data/lua-hooks/ext/luajit/src/luajit.h +79 -0
data/lua-hooks/ext/luajit/src/luajit.o +0 -0
data/lua-hooks/ext/luajit/src/lualib.h +43 -0
data/lua-hooks/ext/luajit/src/msvcbuild.bat +114 -0
data/lua-hooks/ext/luajit/src/ps4build.bat +103 -0
data/lua-hooks/ext/luajit/src/psvitabuild.bat +93 -0
data/lua-hooks/ext/luajit/src/vm_arm.dasc +4585 -0
data/lua-hooks/ext/luajit/src/vm_arm64.dasc +3764 -0
data/lua-hooks/ext/luajit/src/vm_mips.dasc +4355 -0
data/lua-hooks/ext/luajit/src/vm_ppc.dasc +5252 -0
data/lua-hooks/ext/luajit/src/vm_x64.dasc +4902 -0
data/lua-hooks/ext/luajit/src/vm_x86.dasc +5710 -0
data/lua-hooks/ext/luajit/src/xb1build.bat +101 -0
data/lua-hooks/ext/luajit/src/xedkbuild.bat +92 -0
data/lua-hooks/ext/luautf8/lutf8lib.c +3 -3
data/lua-hooks/lib/boot.lua +37 -2
metadata +372 -69
data/lua-hooks/ext/bitop/README +0 -22
data/lua-hooks/ext/bitop/bit.c +0 -189
data/lua-hooks/ext/extconf.rb +0 -38
data/lua-hooks/ext/lua/COPYRIGHT +0 -34
data/lua-hooks/ext/lua/lapi.c +0 -1087
data/lua-hooks/ext/lua/lapi.h +0 -16
data/lua-hooks/ext/lua/lauxlib.c +0 -652
data/lua-hooks/ext/lua/lbaselib.c +0 -659
data/lua-hooks/ext/lua/lcode.c +0 -831
data/lua-hooks/ext/lua/lcode.h +0 -76
data/lua-hooks/ext/lua/ldblib.c +0 -398
data/lua-hooks/ext/lua/ldebug.c +0 -638
data/lua-hooks/ext/lua/ldebug.h +0 -33
data/lua-hooks/ext/lua/ldo.c +0 -519
data/lua-hooks/ext/lua/ldo.h +0 -57
data/lua-hooks/ext/lua/ldump.c +0 -164
data/lua-hooks/ext/lua/lfunc.c +0 -174
data/lua-hooks/ext/lua/lfunc.h +0 -34
data/lua-hooks/ext/lua/lgc.c +0 -710
data/lua-hooks/ext/lua/lgc.h +0 -110
data/lua-hooks/ext/lua/linit.c +0 -38
data/lua-hooks/ext/lua/liolib.c +0 -556
data/lua-hooks/ext/lua/llex.c +0 -463
data/lua-hooks/ext/lua/llex.h +0 -81
data/lua-hooks/ext/lua/llimits.h +0 -128
data/lua-hooks/ext/lua/lmathlib.c +0 -263
data/lua-hooks/ext/lua/lmem.c +0 -86
data/lua-hooks/ext/lua/lmem.h +0 -49
data/lua-hooks/ext/lua/loadlib.c +0 -705
data/lua-hooks/ext/lua/loadlib_rel.c +0 -760
data/lua-hooks/ext/lua/lobject.c +0 -214
data/lua-hooks/ext/lua/lobject.h +0 -381
data/lua-hooks/ext/lua/lopcodes.c +0 -102
data/lua-hooks/ext/lua/lopcodes.h +0 -268
data/lua-hooks/ext/lua/loslib.c +0 -243
data/lua-hooks/ext/lua/lparser.c +0 -1339
data/lua-hooks/ext/lua/lparser.h +0 -82
data/lua-hooks/ext/lua/lstate.c +0 -214
data/lua-hooks/ext/lua/lstate.h +0 -169
data/lua-hooks/ext/lua/lstring.c +0 -111
data/lua-hooks/ext/lua/lstring.h +0 -31
data/lua-hooks/ext/lua/lstrlib.c +0 -871
data/lua-hooks/ext/lua/ltable.c +0 -588
data/lua-hooks/ext/lua/ltable.h +0 -40
data/lua-hooks/ext/lua/ltablib.c +0 -287
data/lua-hooks/ext/lua/ltm.c +0 -75
data/lua-hooks/ext/lua/ltm.h +0 -54
data/lua-hooks/ext/lua/lua.c +0 -392
data/lua-hooks/ext/lua/lua.def +0 -131
data/lua-hooks/ext/lua/lua.rc +0 -28
data/lua-hooks/ext/lua/lua_dll.rc +0 -26
data/lua-hooks/ext/lua/luac.c +0 -200
data/lua-hooks/ext/lua/luac.rc +0 -1
data/lua-hooks/ext/lua/luaconf.h +0 -763
data/lua-hooks/ext/lua/luaconf.h.in +0 -724
data/lua-hooks/ext/lua/luaconf.h.orig +0 -763
data/lua-hooks/ext/lua/lualib.h +0 -53
data/lua-hooks/ext/lua/lundump.c +0 -227
data/lua-hooks/ext/lua/lundump.h +0 -36
data/lua-hooks/ext/lua/lvm.c +0 -767
data/lua-hooks/ext/lua/lvm.h +0 -36
data/lua-hooks/ext/lua/lzio.c +0 -82
data/lua-hooks/ext/lua/lzio.h +0 -67
data/lua-hooks/ext/lua/print.c +0 -227

data/lua-hooks/ext/luajit/doc/contact.html ADDED

@@ -0,0 +1,104 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Contact</title>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<meta name="Author" content="Mike Pall">
+<meta name="Copyright" content="Copyright (C) 2005-2015, Mike Pall">
+<meta name="Language" content="en">
+<link rel="stylesheet" type="text/css" href="bluequad.css" media="screen">
+<link rel="stylesheet" type="text/css" href="bluequad-print.css" media="print">
+</head>
+<body>
+<div id="site">
+<a href="http://luajit.org"><span>Lua<span id="logo">JIT</span></span></a>
+</div>
+<div id="head">
+<h1>Contact</h1>
+</div>
+<div id="nav">
+<ul><li>
+<a href="luajit.html">LuaJIT</a>
+<ul><li>
+<a href="http://luajit.org/download.html">Download <span class="ext">&raquo;</span></a>
+</li><li>
+<a href="install.html">Installation</a>
+</li><li>
+<a href="running.html">Running</a>
+</li></ul>
+</li><li>
+<a href="extensions.html">Extensions</a>
+<ul><li>
+<a href="ext_ffi.html">FFI Library</a>
+<ul><li>
+<a href="ext_ffi_tutorial.html">FFI Tutorial</a>
+</li><li>
+<a href="ext_ffi_api.html">ffi.* API</a>
+</li><li>
+<a href="ext_ffi_semantics.html">FFI Semantics</a>
+</li></ul>
+</li><li>
+<a href="ext_jit.html">jit.* Library</a>
+</li><li>
+<a href="ext_c_api.html">Lua/C API</a>
+</li><li>
+<a href="ext_profiler.html">Profiler</a>
+</li></ul>
+</li><li>
+<a href="status.html">Status</a>
+<ul><li>
+<a href="changes.html">Changes</a>
+</li></ul>
+</li><li>
+<a href="faq.html">FAQ</a>
+</li><li>
+<a href="http://luajit.org/performance.html">Performance <span class="ext">&raquo;</span></a>
+</li><li>
+<a href="http://wiki.luajit.org/">Wiki <span class="ext">&raquo;</span></a>
+</li><li>
+<a href="http://luajit.org/list.html">Mailing List <span class="ext">&raquo;</span></a>
+</li></ul>
+</div>
+<div id="main">
+<p>
+Please send general questions to the
+<a href="http://luajit.org/list.html"><span class="ext">&raquo;</span>&nbsp;LuaJIT mailing list</a>.
+You can also send any questions you have directly to me:
+</p>
+<script type="text/javascript">
+<!--
+var xS="@-:\" .0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ<abc>defghijklmnopqrstuvwxyz";function xD(s)
+{var len=s.length;var r="";for(var i=0;i<len;i++)
+{var c=s.charAt(i);var n=xS.indexOf(c);if(n!=-1)c=xS.charAt(69-n);r+=c;}
+document.write("<"+"p>"+r+"<"+"/p>\n");}
+//-->
+</script>
+<script type="text/javascript">
+<!--
+xD("fyZKB8xv\"FJytmz8.KAB0u52D")
+//--></script>
+<noscript>
+<p><img src="img/contact.png" alt="Contact info in image" width="170" height="13">
+</p>
+</noscript>
+<h2>Copyright</h2>
+<p>
+All documentation is
+Copyright &copy; 2005-2015 Mike Pall.
+</p>
+<br class="flush">
+</div>
+<div id="foot">
+<hr class="hide">
+Copyright &copy; 2005-2015 Mike Pall
+<span class="noprint">
+&middot;
+<a href="contact.html">Contact</a>
+</span>
+</div>
+</body>
+</html>

data/lua-hooks/ext/luajit/doc/ext_c_api.html ADDED

@@ -0,0 +1,189 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>Lua/C API Extensions</title>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<meta name="Author" content="Mike Pall">
+<meta name="Copyright" content="Copyright (C) 2005-2015, Mike Pall">
+<meta name="Language" content="en">
+<link rel="stylesheet" type="text/css" href="bluequad.css" media="screen">
+<link rel="stylesheet" type="text/css" href="bluequad-print.css" media="print">
+</head>
+<body>
+<div id="site">
+<a href="http://luajit.org"><span>Lua<span id="logo">JIT</span></span></a>
+</div>
+<div id="head">
+<h1>Lua/C API Extensions</h1>
+</div>
+<div id="nav">
+<ul><li>
+<a href="luajit.html">LuaJIT</a>
+<ul><li>
+<a href="http://luajit.org/download.html">Download <span class="ext">&raquo;</span></a>
+</li><li>
+<a href="install.html">Installation</a>
+</li><li>
+<a href="running.html">Running</a>
+</li></ul>
+</li><li>
+<a href="extensions.html">Extensions</a>
+<ul><li>
+<a href="ext_ffi.html">FFI Library</a>
+<ul><li>
+<a href="ext_ffi_tutorial.html">FFI Tutorial</a>
+</li><li>
+<a href="ext_ffi_api.html">ffi.* API</a>
+</li><li>
+<a href="ext_ffi_semantics.html">FFI Semantics</a>
+</li></ul>
+</li><li>
+<a href="ext_jit.html">jit.* Library</a>
+</li><li>
+<a class="current" href="ext_c_api.html">Lua/C API</a>
+</li><li>
+<a href="ext_profiler.html">Profiler</a>
+</li></ul>
+</li><li>
+<a href="status.html">Status</a>
+<ul><li>
+<a href="changes.html">Changes</a>
+</li></ul>
+</li><li>
+<a href="faq.html">FAQ</a>
+</li><li>
+<a href="http://luajit.org/performance.html">Performance <span class="ext">&raquo;</span></a>
+</li><li>
+<a href="http://wiki.luajit.org/">Wiki <span class="ext">&raquo;</span></a>
+</li><li>
+<a href="http://luajit.org/list.html">Mailing List <span class="ext">&raquo;</span></a>
+</li></ul>
+</div>
+<div id="main">
+<p>
+LuaJIT adds some extensions to the standard Lua/C API. The LuaJIT include
+directory must be in the compiler search path (<tt>-I<i>path</i></tt>)
+to be able to include the required header for C code:
+</p>
+<pre class="code">
+#include "luajit.h"
+</pre>
+<p>
+Or for C++ code:
+</p>
+<pre class="code">
+#include "lua.hpp"
+</pre>
+<h2 id="luaJIT_setmode"><tt>luaJIT_setmode(L, idx, mode)</tt>
+&mdash; Control VM</h2>
+<p>
+This is a C API extension to allow control of the VM from C code. The
+full prototype of <tt>LuaJIT_setmode</tt> is:
+</p>
+<pre class="code">
+LUA_API int luaJIT_setmode(lua_State *L, int idx, int mode);
+</pre>
+<p>
+The returned status is either success (<tt>1</tt>) or failure (<tt>0</tt>).
+The second argument is either <tt>0</tt> or a stack index (similar to the
+other Lua/C API functions).
+</p>
+<p>
+The third argument specifies the mode, which is 'or'ed with a flag.
+The flag can be <tt>LUAJIT_MODE_OFF</tt> to turn a feature on,
+<tt>LUAJIT_MODE_ON</tt> to turn a feature off, or
+<tt>LUAJIT_MODE_FLUSH</tt> to flush cached code.
+</p>
+<p>
+The following modes are defined:
+</p>
+<h3 id="mode_engine"><tt>luaJIT_setmode(L, 0, LUAJIT_MODE_ENGINE|flag)</tt></h3>
+<p>
+Turn the whole JIT compiler on or off or flush the whole cache of compiled code.
+</p>
+<h3 id="mode_func"><tt>luaJIT_setmode(L, idx, LUAJIT_MODE_FUNC|flag)</tt><br>
+<tt>luaJIT_setmode(L, idx, LUAJIT_MODE_ALLFUNC|flag)</tt><br>
+<tt>luaJIT_setmode(L, idx, LUAJIT_MODE_ALLSUBFUNC|flag)</tt></h3>
+<p>
+This sets the mode for the function at the stack index <tt>idx</tt> or
+the parent of the calling function (<tt>idx = 0</tt>). It either
+enables JIT compilation for a function, disables it and flushes any
+already compiled code or only flushes already compiled code. This
+applies recursively to all sub-functions of the function with
+<tt>LUAJIT_MODE_ALLFUNC</tt> or only to the sub-functions with
+<tt>LUAJIT_MODE_ALLSUBFUNC</tt>.
+</p>
+<h3 id="mode_trace"><tt>luaJIT_setmode(L, trace,<br>
+&nbsp;&nbsp;LUAJIT_MODE_TRACE|LUAJIT_MODE_FLUSH)</tt></h3>
+<p>
+Flushes the specified root trace and all of its side traces from the cache.
+The code for the trace will be retained as long as there are any other
+traces which link to it.
+</p>
+<h3 id="mode_wrapcfunc"><tt>luaJIT_setmode(L, idx, LUAJIT_MODE_WRAPCFUNC|flag)</tt></h3>
+<p>
+This mode defines a wrapper function for calls to C functions. If
+called with <tt>LUAJIT_MODE_ON</tt>, the stack index at <tt>idx</tt>
+must be a <tt>lightuserdata</tt> object holding a pointer to the wrapper
+function. From now on all C functions are called through the wrapper
+function. If called with <tt>LUAJIT_MODE_OFF</tt> this mode is turned
+off and all C functions are directly called.
+</p>
+<p>
+The wrapper function can be used for debugging purposes or to catch
+and convert foreign exceptions. But please read the section on
+<a href="extensions.html#exceptions">C++&nbsp;exception interoperability</a>
+first. Recommended usage can be seen in this C++ code excerpt:
+</p>
+<pre class="code">
+#include &lt;exception&gt;
+#include "lua.hpp"
+// Catch C++ exceptions and convert them to Lua error messages.
+// Customize as needed for your own exception classes.
+static int wrap_exceptions(lua_State *L, lua_CFunction f)
+{
+  try {
+    return f(L);  // Call wrapped function and return result.
+  } catch (const char *s) {  // Catch and convert exceptions.
+    lua_pushstring(L, s);
+  } catch (std::exception& e) {
+    lua_pushstring(L, e.what());
+  } catch (...) {
+    lua_pushliteral(L, "caught (...)");
+  }
+  return lua_error(L);  // Rethrow as a Lua error.
+}
+static int myinit(lua_State *L)
+{
+  ...
+  // Define wrapper function and enable it.
+  lua_pushlightuserdata(L, (void *)wrap_exceptions);
+  luaJIT_setmode(L, -1, LUAJIT_MODE_WRAPCFUNC|LUAJIT_MODE_ON);
+  lua_pop(L, 1);
+  ...
+}
+</pre>
+<p>
+Note that you can only define <b>a single global wrapper function</b>,
+so be careful when using this mechanism from multiple C++ modules.
+Also note that this mechanism is not without overhead.
+</p>
+<br class="flush">
+</div>
+<div id="foot">
+<hr class="hide">
+Copyright &copy; 2005-2015 Mike Pall
+<span class="noprint">
+&middot;
+<a href="contact.html">Contact</a>
+</span>
+</div>
+</body>
+</html>

data/lua-hooks/ext/luajit/doc/ext_ffi.html ADDED

@@ -0,0 +1,332 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+<html>
+<head>
+<title>FFI Library</title>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+<meta name="Author" content="Mike Pall">
+<meta name="Copyright" content="Copyright (C) 2005-2015, Mike Pall">
+<meta name="Language" content="en">
+<link rel="stylesheet" type="text/css" href="bluequad.css" media="screen">
+<link rel="stylesheet" type="text/css" href="bluequad-print.css" media="print">
+</head>
+<body>
+<div id="site">
+<a href="http://luajit.org"><span>Lua<span id="logo">JIT</span></span></a>
+</div>
+<div id="head">
+<h1>FFI Library</h1>
+</div>
+<div id="nav">
+<ul><li>
+<a href="luajit.html">LuaJIT</a>
+<ul><li>
+<a href="http://luajit.org/download.html">Download <span class="ext">&raquo;</span></a>
+</li><li>
+<a href="install.html">Installation</a>
+</li><li>
+<a href="running.html">Running</a>
+</li></ul>
+</li><li>
+<a href="extensions.html">Extensions</a>
+<ul><li>
+<a class="current" href="ext_ffi.html">FFI Library</a>
+<ul><li>
+<a href="ext_ffi_tutorial.html">FFI Tutorial</a>
+</li><li>
+<a href="ext_ffi_api.html">ffi.* API</a>
+</li><li>
+<a href="ext_ffi_semantics.html">FFI Semantics</a>
+</li></ul>
+</li><li>
+<a href="ext_jit.html">jit.* Library</a>
+</li><li>
+<a href="ext_c_api.html">Lua/C API</a>
+</li><li>
+<a href="ext_profiler.html">Profiler</a>
+</li></ul>
+</li><li>
+<a href="status.html">Status</a>
+<ul><li>
+<a href="changes.html">Changes</a>
+</li></ul>
+</li><li>
+<a href="faq.html">FAQ</a>
+</li><li>
+<a href="http://luajit.org/performance.html">Performance <span class="ext">&raquo;</span></a>
+</li><li>
+<a href="http://wiki.luajit.org/">Wiki <span class="ext">&raquo;</span></a>
+</li><li>
+<a href="http://luajit.org/list.html">Mailing List <span class="ext">&raquo;</span></a>
+</li></ul>
+</div>
+<div id="main">
+<p>
+The FFI library allows <b>calling external C&nbsp;functions</b> and
+<b>using C&nbsp;data structures</b> from pure Lua code.
+</p>
+<p>
+The FFI library largely obviates the need to write tedious manual
+Lua/C bindings in C. No need to learn a separate binding language
+&mdash; <b>it parses plain C&nbsp;declarations!</b> These can be
+cut-n-pasted from C&nbsp;header files or reference manuals. It's up to
+the task of binding large libraries without the need for dealing with
+fragile binding generators.
+</p>
+<p>
+The FFI library is tightly integrated into LuaJIT (it's not available
+as a separate module). The code generated by the JIT-compiler for
+accesses to C&nbsp;data structures from Lua code is on par with the
+code a C&nbsp;compiler would generate. Calls to C&nbsp;functions can
+be inlined in JIT-compiled code, unlike calls to functions bound via
+the classic Lua/C API.
+</p>
+<p>
+This page gives a short introduction to the usage of the FFI library.
+<em>Please use the FFI sub-topics in the navigation bar to learn more.</em>
+</p>
+<h2 id="call">Motivating Example: Calling External C Functions</h2>
+<p>
+It's really easy to call an external C&nbsp;library function:
+</p>
+<pre class="code mark">
+<span class="codemark">&#9312;
+&#9313;
+&#9314;</span>local ffi = require("ffi")
+ffi.cdef[[
+<span style="color:#00a000;">int printf(const char *fmt, ...);</span>
+]]
+ffi.C.printf("Hello %s!", "world")
+</pre>
+<p>
+So, let's pick that apart:
+</p>
+<p>
+<span class="mark">&#9312;</span> Load the FFI library.
+</p>
+<p>
+<span class="mark">&#9313;</span> Add a C&nbsp;declaration
+for the function. The part inside the double-brackets (in green) is
+just standard C&nbsp;syntax.
+</p>
+<p>
+<span class="mark">&#9314;</span> Call the named
+C&nbsp;function &mdash; Yes, it's that simple!
+</p>
+<p style="font-size: 8pt;">
+Actually, what goes on behind the scenes is far from simple: <span
+style="color:#4040c0;">&#9314;</span> makes use of the standard
+C&nbsp;library namespace <tt>ffi.C</tt>. Indexing this namespace with
+a symbol name (<tt>"printf"</tt>) automatically binds it to the
+standard C&nbsp;library. The result is a special kind of object which,
+when called, runs the <tt>printf</tt> function. The arguments passed
+to this function are automatically converted from Lua objects to the
+corresponding C&nbsp;types.
+</p>
+<p>
+Ok, so maybe the use of <tt>printf()</tt> wasn't such a spectacular
+example. You could have done that with <tt>io.write()</tt> and
+<tt>string.format()</tt>, too. But you get the idea ...
+</p>
+<p>
+So here's something to pop up a message box on Windows:
+</p>
+<pre class="code">
+local ffi = require("ffi")
+ffi.cdef[[
+<span style="color:#00a000;">int MessageBoxA(void *w, const char *txt, const char *cap, int type);</span>
+]]
+ffi.C.MessageBoxA(nil, "Hello world!", "Test", 0)
+</pre>
+<p>
+Bing! Again, that was far too easy, no?
+</p>
+<p style="font-size: 8pt;">
+Compare this with the effort required to bind that function using the
+classic Lua/C API: create an extra C&nbsp;file, add a C&nbsp;function
+that retrieves and checks the argument types passed from Lua and calls
+the actual C&nbsp;function, add a list of module functions and their
+names, add a <tt>luaopen_*</tt> function and register all module
+functions, compile and link it into a shared library (DLL), move it to
+the proper path, add Lua code that loads the module aaaand ... finally
+call the binding function. Phew!
+</p>
+<h2 id="cdata">Motivating Example: Using C Data Structures</h2>
+<p>
+The FFI library allows you to create and access C&nbsp;data
+structures. Of course the main use for this is for interfacing with
+C&nbsp;functions. But they can be used stand-alone, too.
+</p>
+<p>
+Lua is built upon high-level data types. They are flexible, extensible
+and dynamic. That's why we all love Lua so much. Alas, this can be
+inefficient for certain tasks, where you'd really want a low-level
+data type. E.g. a large array of a fixed structure needs to be
+implemented with a big table holding lots of tiny tables. This imposes
+both a substantial memory overhead as well as a performance overhead.
+</p>
+<p>
+Here's a sketch of a library that operates on color images plus a
+simple benchmark. First, the plain Lua version:
+</p>
+<pre class="code">
+local floor = math.floor
+local function image_ramp_green(n)
+  local img = {}
+  local f = 255/(n-1)
+  for i=1,n do
+    img[i] = { red = 0, green = floor((i-1)*f), blue = 0, alpha = 255 }
+  end
+  return img
+end
+local function image_to_grey(img, n)
+  for i=1,n do
+    local y = floor(0.3*img[i].red + 0.59*img[i].green + 0.11*img[i].blue)
+    img[i].red = y; img[i].green = y; img[i].blue = y
+  end
+end
+local N = 400*400
+local img = image_ramp_green(N)
+for i=1,1000 do
+  image_to_grey(img, N)
+end
+</pre>
+<p>
+This creates a table with 160.000 pixels, each of which is a table
+holding four number values in the range of 0-255. First an image with
+a green ramp is created (1D for simplicity), then the image is
+converted to greyscale 1000 times. Yes, that's silly, but I was in
+need of a simple example ...
+</p>
+<p>
+And here's the FFI version. The modified parts have been marked in
+bold:
+</p>
+<pre class="code mark">
+<span class="codemark">&#9312;
+&#9313;
+&#9314;
+&#9315;
+&#9314;
+&#9316;</span><b>local ffi = require("ffi")
+ffi.cdef[[
+</b><span style="color:#00a000;">typedef struct { uint8_t red, green, blue, alpha; } rgba_pixel;</span><b>
+]]</b>
+local function image_ramp_green(n)
+  <b>local img = ffi.new("rgba_pixel[?]", n)</b>
+  local f = 255/(n-1)
+  for i=<b>0,n-1</b> do
+    <b>img[i].green = i*f</b>
+    <b>img[i].alpha = 255</b>
+  end
+  return img
+end
+local function image_to_grey(img, n)
+  for i=<b>0,n-1</b> do
+    local y = <b>0.3*img[i].red + 0.59*img[i].green + 0.11*img[i].blue</b>
+    img[i].red = y; img[i].green = y; img[i].blue = y
+  end
+end
+local N = 400*400
+local img = image_ramp_green(N)
+for i=1,1000 do
+  image_to_grey(img, N)
+end
+</pre>
+<p>
+Ok, so that wasn't too difficult:
+</p>
+<p>
+<span class="mark">&#9312;</span> First, load the FFI
+library and declare the low-level data type. Here we choose a
+<tt>struct</tt> which holds four byte fields, one for each component
+of a 4x8&nbsp;bit RGBA pixel.
+</p>
+<p>
+<span class="mark">&#9313;</span> Creating the data
+structure with <tt>ffi.new()</tt> is straightforward &mdash; the
+<tt>'?'</tt> is a placeholder for the number of elements of a
+variable-length array.
+</p>
+<p>
+<span class="mark">&#9314;</span> C&nbsp;arrays are
+zero-based, so the indexes have to run from <tt>0</tt> to
+<tt>n-1</tt>. One might want to allocate one more element instead to
+simplify converting legacy code.
+</p>
+<p>
+<span class="mark">&#9315;</span> Since <tt>ffi.new()</tt>
+zero-fills the array by default, we only need to set the green and the
+alpha fields.
+</p>
+<p>
+<span class="mark">&#9316;</span> The calls to
+<tt>math.floor()</tt> can be omitted here, because floating-point
+numbers are already truncated towards zero when converting them to an
+integer. This happens implicitly when the number is stored in the
+fields of each pixel.
+</p>
+<p>
+Now let's have a look at the impact of the changes: first, memory
+consumption for the image is down from 22&nbsp;Megabytes to
+640&nbsp;Kilobytes (400*400*4 bytes). That's a factor of 35x less! So,
+yes, tables do have a noticeable overhead. BTW: The original program
+would consume 40&nbsp;Megabytes in plain Lua (on x64).
+</p>
+<p>
+Next, performance: the pure Lua version runs in 9.57 seconds (52.9
+seconds with the Lua interpreter) and the FFI version runs in 0.48
+seconds on my machine (YMMV). That's a factor of 20x faster (110x
+faster than the Lua interpreter).
+</p>
+<p style="font-size: 8pt;">
+The avid reader may notice that converting the pure Lua version over
+to use array indexes for the colors (<tt>[1]</tt> instead of
+<tt>.red</tt>, <tt>[2]</tt> instead of <tt>.green</tt> etc.) ought to
+be more compact and faster. This is certainly true (by a factor of
+~1.7x). Switching to a struct-of-arrays would help, too.
+</p>
+<p style="font-size: 8pt;">
+However the resulting code would be less idiomatic and rather
+error-prone. And it still doesn't get even close to the performance of
+the FFI version of the code. Also, high-level data structures cannot
+be easily passed to other C&nbsp;functions, especially I/O functions,
+without undue conversion penalties.
+</p>
+<br class="flush">
+</div>
+<div id="foot">
+<hr class="hide">
+Copyright &copy; 2005-2015 Mike Pall
+<span class="noprint">
+&middot;
+<a href="contact.html">Contact</a>
+</span>
+</div>
+</body>
+</html>