contrast-agent 3.8.4
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +7 -0
- data/.clang-format +5 -0
- data/.dockerignore +10 -0
- data/.gitignore +58 -0
- data/.gitmodules +6 -0
- data/.rspec +6 -0
- data/.simplecov +4 -0
- data/Gemfile +7 -0
- data/LICENSE.txt +12 -0
- data/Rakefile +15 -0
- data/exe/contrast_service +29 -0
- data/ext/build_funchook.rb +48 -0
- data/ext/cs__assess_active_record_named/cs__active_record_named.c +47 -0
- data/ext/cs__assess_active_record_named/cs__active_record_named.h +10 -0
- data/ext/cs__assess_active_record_named/extconf.rb +2 -0
- data/ext/cs__assess_array/cs__assess_array.c +38 -0
- data/ext/cs__assess_array/cs__assess_array.h +9 -0
- data/ext/cs__assess_array/extconf.rb +2 -0
- data/ext/cs__assess_basic_object/cs__assess_basic_object.c +50 -0
- data/ext/cs__assess_basic_object/cs__assess_basic_object.h +17 -0
- data/ext/cs__assess_basic_object/extconf.rb +2 -0
- data/ext/cs__assess_fiber_track/cs__assess_fiber_track.c +86 -0
- data/ext/cs__assess_fiber_track/cs__assess_fiber_track.h +34 -0
- data/ext/cs__assess_fiber_track/extconf.rb +2 -0
- data/ext/cs__assess_hash/cs__assess_hash.c +64 -0
- data/ext/cs__assess_hash/cs__assess_hash.h +24 -0
- data/ext/cs__assess_hash/extconf.rb +2 -0
- data/ext/cs__assess_kernel/cs__assess_kernel.c +36 -0
- data/ext/cs__assess_kernel/cs__assess_kernel.h +10 -0
- data/ext/cs__assess_kernel/extconf.rb +2 -0
- data/ext/cs__assess_marshal_module/cs__assess_marshal_module.c +47 -0
- data/ext/cs__assess_marshal_module/cs__assess_marshal_module.h +18 -0
- data/ext/cs__assess_marshal_module/extconf.rb +2 -0
- data/ext/cs__assess_module/cs__assess_module.c +78 -0
- data/ext/cs__assess_module/cs__assess_module.h +25 -0
- data/ext/cs__assess_module/extconf.rb +2 -0
- data/ext/cs__assess_regexp/cs__assess_regexp.c +48 -0
- data/ext/cs__assess_regexp/cs__assess_regexp.h +22 -0
- data/ext/cs__assess_regexp/extconf.rb +2 -0
- data/ext/cs__assess_regexp_track/cs__assess_regexp_track.c +63 -0
- data/ext/cs__assess_regexp_track/cs__assess_regexp_track.h +29 -0
- data/ext/cs__assess_regexp_track/extconf.rb +2 -0
- data/ext/cs__assess_string/cs__assess_string.c +38 -0
- data/ext/cs__assess_string/cs__assess_string.h +19 -0
- data/ext/cs__assess_string/extconf.rb +2 -0
- data/ext/cs__assess_string_interpolation26/cs__assess_string_interpolation26.c +31 -0
- data/ext/cs__assess_string_interpolation26/cs__assess_string_interpolation26.h +13 -0
- data/ext/cs__assess_string_interpolation26/extconf.rb +2 -0
- data/ext/cs__common/cs__common.c +60 -0
- data/ext/cs__common/cs__common.h +28 -0
- data/ext/cs__common/extconf.rb +20 -0
- data/ext/cs__contrast_patch/cs__contrast_patch.c +445 -0
- data/ext/cs__contrast_patch/cs__contrast_patch.h +196 -0
- data/ext/cs__contrast_patch/extconf.rb +2 -0
- data/ext/cs__protect_kernel/cs__protect_kernel.c +37 -0
- data/ext/cs__protect_kernel/cs__protect_kernel.h +11 -0
- data/ext/cs__protect_kernel/extconf.rb +2 -0
- data/ext/cs__scope/cs__scope.c +96 -0
- data/ext/cs__scope/cs__scope.h +33 -0
- data/ext/cs__scope/extconf.rb +2 -0
- data/ext/extconf_common.rb +49 -0
- data/funchook/LICENSE +360 -0
- data/funchook/Makefile +29 -0
- data/funchook/Makefile.in +29 -0
- data/funchook/README.md +121 -0
- data/funchook/appveyor.yml +42 -0
- data/funchook/autogen.sh +3 -0
- data/funchook/autom4te.cache/output.0 +4976 -0
- data/funchook/autom4te.cache/requests +78 -0
- data/funchook/autom4te.cache/traces.0 +364 -0
- data/funchook/config.guess +1530 -0
- data/funchook/config.log +490 -0
- data/funchook/config.status +1016 -0
- data/funchook/config.sub +1773 -0
- data/funchook/configure +4976 -0
- data/funchook/configure.ac +59 -0
- data/funchook/distorm/COPYING +26 -0
- data/funchook/distorm/MANIFEST +25 -0
- data/funchook/distorm/MANIFEST.in +4 -0
- data/funchook/distorm/README.md +12 -0
- data/funchook/distorm/disOps/disOps.py +795 -0
- data/funchook/distorm/disOps/x86db.py +404 -0
- data/funchook/distorm/disOps/x86header.py +247 -0
- data/funchook/distorm/disOps/x86sets.py +1664 -0
- data/funchook/distorm/examples/cs/TestdiStorm/Program.cs +79 -0
- data/funchook/distorm/examples/cs/TestdiStorm/Properties/AssemblyInfo.cs +36 -0
- data/funchook/distorm/examples/cs/TestdiStorm/TestdiStorm.csproj +69 -0
- data/funchook/distorm/examples/cs/distorm-net.sln +26 -0
- data/funchook/distorm/examples/cs/distorm-net/CodeInfo.cs +23 -0
- data/funchook/distorm/examples/cs/distorm-net/DecodedInst.cs +15 -0
- data/funchook/distorm/examples/cs/distorm-net/DecodedResult.cs +14 -0
- data/funchook/distorm/examples/cs/distorm-net/DecomposedInst.cs +36 -0
- data/funchook/distorm/examples/cs/distorm-net/DecomposedResult.cs +14 -0
- data/funchook/distorm/examples/cs/distorm-net/Opcodes.cs +1268 -0
- data/funchook/distorm/examples/cs/distorm-net/Opcodes.tt +37 -0
- data/funchook/distorm/examples/cs/distorm-net/Operand.cs +25 -0
- data/funchook/distorm/examples/cs/distorm-net/Properties/AssemblyInfo.cs +36 -0
- data/funchook/distorm/examples/cs/distorm-net/diStorm3.cs +411 -0
- data/funchook/distorm/examples/cs/distorm-net/distorm-net.csproj +80 -0
- data/funchook/distorm/examples/cs/readme +3 -0
- data/funchook/distorm/examples/ddk/README +48 -0
- data/funchook/distorm/examples/ddk/distorm.ini +11 -0
- data/funchook/distorm/examples/ddk/dummy.c +15 -0
- data/funchook/distorm/examples/ddk/main.c +91 -0
- data/funchook/distorm/examples/ddk/makefile +1 -0
- data/funchook/distorm/examples/ddk/sources +10 -0
- data/funchook/distorm/examples/java/Makefile +23 -0
- data/funchook/distorm/examples/java/distorm/src/Main.java +43 -0
- data/funchook/distorm/examples/java/distorm/src/diStorm3/CodeInfo.java +27 -0
- data/funchook/distorm/examples/java/distorm/src/diStorm3/DecodedInst.java +32 -0
- data/funchook/distorm/examples/java/distorm/src/diStorm3/DecodedResult.java +11 -0
- data/funchook/distorm/examples/java/distorm/src/diStorm3/DecomposedInst.java +89 -0
- data/funchook/distorm/examples/java/distorm/src/diStorm3/DecomposedResult.java +11 -0
- data/funchook/distorm/examples/java/distorm/src/diStorm3/OpcodeEnum.java +131 -0
- data/funchook/distorm/examples/java/distorm/src/diStorm3/Opcodes.java +1123 -0
- data/funchook/distorm/examples/java/distorm/src/diStorm3/Operand.java +24 -0
- data/funchook/distorm/examples/java/distorm/src/diStorm3/distorm3.java +41 -0
- data/funchook/distorm/examples/java/jdistorm.c +405 -0
- data/funchook/distorm/examples/java/jdistorm.h +40 -0
- data/funchook/distorm/examples/java/jdistorm.sln +20 -0
- data/funchook/distorm/examples/java/jdistorm.vcproj +208 -0
- data/funchook/distorm/examples/linux/Makefile +15 -0
- data/funchook/distorm/examples/linux/main.c +181 -0
- data/funchook/distorm/examples/tests/Makefile +15 -0
- data/funchook/distorm/examples/tests/main.cpp +42 -0
- data/funchook/distorm/examples/tests/main.py +66 -0
- data/funchook/distorm/examples/tests/test_distorm3.py +1672 -0
- data/funchook/distorm/examples/tests/tests.sln +20 -0
- data/funchook/distorm/examples/tests/tests.vcxproj +82 -0
- data/funchook/distorm/examples/tests/tests.vcxproj.filters +22 -0
- data/funchook/distorm/examples/win32/disasm.sln +25 -0
- data/funchook/distorm/examples/win32/disasm.vcxproj +201 -0
- data/funchook/distorm/examples/win32/disasm.vcxproj.filters +14 -0
- data/funchook/distorm/examples/win32/main.cpp +163 -0
- data/funchook/distorm/include/distorm.h +482 -0
- data/funchook/distorm/include/mnemonics.h +301 -0
- data/funchook/distorm/make/linux/Makefile +28 -0
- data/funchook/distorm/make/mac/Makefile +24 -0
- data/funchook/distorm/make/win32/cdistorm.vcxproj +239 -0
- data/funchook/distorm/make/win32/cdistorm.vcxproj.filters +80 -0
- data/funchook/distorm/make/win32/distorm.sln +25 -0
- data/funchook/distorm/make/win32/resource.h +14 -0
- data/funchook/distorm/make/win32/resource.rc +99 -0
- data/funchook/distorm/python/distorm3/__init__.py +957 -0
- data/funchook/distorm/python/distorm3/sample.py +51 -0
- data/funchook/distorm/setup.cfg +10 -0
- data/funchook/distorm/setup.py +266 -0
- data/funchook/distorm/src/config.h +169 -0
- data/funchook/distorm/src/decoder.c +641 -0
- data/funchook/distorm/src/decoder.h +33 -0
- data/funchook/distorm/src/distorm.c +413 -0
- data/funchook/distorm/src/instructions.c +597 -0
- data/funchook/distorm/src/instructions.h +463 -0
- data/funchook/distorm/src/insts.c +7939 -0
- data/funchook/distorm/src/insts.h +64 -0
- data/funchook/distorm/src/mnemonics.c +284 -0
- data/funchook/distorm/src/operands.c +1290 -0
- data/funchook/distorm/src/operands.h +28 -0
- data/funchook/distorm/src/prefix.c +368 -0
- data/funchook/distorm/src/prefix.h +64 -0
- data/funchook/distorm/src/textdefs.c +172 -0
- data/funchook/distorm/src/textdefs.h +57 -0
- data/funchook/distorm/src/wstring.c +47 -0
- data/funchook/distorm/src/wstring.h +35 -0
- data/funchook/distorm/src/x86defs.h +82 -0
- data/funchook/include/funchook.h +123 -0
- data/funchook/install-sh +527 -0
- data/funchook/src/Makefile +70 -0
- data/funchook/src/Makefile.in +70 -0
- data/funchook/src/__strerror.h +109 -0
- data/funchook/src/config.h +101 -0
- data/funchook/src/config.h.in +100 -0
- data/funchook/src/decoder.o +0 -0
- data/funchook/src/distorm.o +0 -0
- data/funchook/src/funchook.c +440 -0
- data/funchook/src/funchook.o +0 -0
- data/funchook/src/funchook_internal.h +155 -0
- data/funchook/src/funchook_io.c +182 -0
- data/funchook/src/funchook_io.h +64 -0
- data/funchook/src/funchook_io.o +0 -0
- data/funchook/src/funchook_syscall.S +134 -0
- data/funchook/src/funchook_syscall.o +0 -0
- data/funchook/src/funchook_unix.c +480 -0
- data/funchook/src/funchook_unix.o +0 -0
- data/funchook/src/funchook_windows.c +397 -0
- data/funchook/src/funchook_x86.c +622 -0
- data/funchook/src/funchook_x86.o +0 -0
- data/funchook/src/instructions.o +0 -0
- data/funchook/src/insts.o +0 -0
- data/funchook/src/libfunchook.so +0 -0
- data/funchook/src/mnemonics.o +0 -0
- data/funchook/src/operands.o +0 -0
- data/funchook/src/os_func.c +115 -0
- data/funchook/src/os_func.h +75 -0
- data/funchook/src/os_func.o +0 -0
- data/funchook/src/os_func_unix.c +94 -0
- data/funchook/src/os_func_unix.o +0 -0
- data/funchook/src/os_func_windows.c +32 -0
- data/funchook/src/prefix.o +0 -0
- data/funchook/src/printf_base.c +1688 -0
- data/funchook/src/printf_base.h +46 -0
- data/funchook/src/printf_base.o +0 -0
- data/funchook/src/textdefs.o +0 -0
- data/funchook/src/wstring.o +0 -0
- data/funchook/test/Makefile +43 -0
- data/funchook/test/Makefile.in +43 -0
- data/funchook/test/funchook_test +0 -0
- data/funchook/test/libfunchook_test.c +25 -0
- data/funchook/test/libfunchook_test.so +0 -0
- data/funchook/test/libfunchook_test2.c +18 -0
- data/funchook/test/suffix.list +600 -0
- data/funchook/test/test_main.c +430 -0
- data/funchook/test/test_main.o +0 -0
- data/funchook/test/x86_64_test.S +10 -0
- data/funchook/test/x86_64_test.o +0 -0
- data/funchook/test/x86_test.S +339 -0
- data/funchook/win32/config.h +1 -0
- data/funchook/win32/funchook.sln +52 -0
- data/funchook/win32/funchook.vcxproj +188 -0
- data/funchook/win32/funchook.vcxproj.filters +84 -0
- data/funchook/win32/funchook_test.vcxproj +170 -0
- data/funchook/win32/funchook_test.vcxproj.filters +22 -0
- data/funchook/win32/funchook_test_dll.vcxproj +184 -0
- data/funchook/win32/funchook_test_dll.vcxproj.filters +30 -0
- data/funchook/win32/funchook_test_exe.def +3 -0
- data/lib/contrast-agent.rb +8 -0
- data/lib/contrast.rb +57 -0
- data/lib/contrast/agent.rb +80 -0
- data/lib/contrast/agent/assess.rb +45 -0
- data/lib/contrast/agent/assess/adjusted_span.rb +25 -0
- data/lib/contrast/agent/assess/class_reverter.rb +82 -0
- data/lib/contrast/agent/assess/contrast_event.rb +398 -0
- data/lib/contrast/agent/assess/frozen_properties.rb +41 -0
- data/lib/contrast/agent/assess/insulator.rb +53 -0
- data/lib/contrast/agent/assess/policy/dynamic_source_factory.rb +78 -0
- data/lib/contrast/agent/assess/policy/patcher.rb +85 -0
- data/lib/contrast/agent/assess/policy/policy.rb +116 -0
- data/lib/contrast/agent/assess/policy/policy_node.rb +289 -0
- data/lib/contrast/agent/assess/policy/policy_scanner.rb +44 -0
- data/lib/contrast/agent/assess/policy/preshift.rb +94 -0
- data/lib/contrast/agent/assess/policy/propagation_method.rb +260 -0
- data/lib/contrast/agent/assess/policy/propagation_node.rb +127 -0
- data/lib/contrast/agent/assess/policy/propagator.rb +35 -0
- data/lib/contrast/agent/assess/policy/propagator/append.rb +54 -0
- data/lib/contrast/agent/assess/policy/propagator/base.rb +37 -0
- data/lib/contrast/agent/assess/policy/propagator/center.rb +73 -0
- data/lib/contrast/agent/assess/policy/propagator/custom.rb +36 -0
- data/lib/contrast/agent/assess/policy/propagator/database_write.rb +62 -0
- data/lib/contrast/agent/assess/policy/propagator/insert.rb +55 -0
- data/lib/contrast/agent/assess/policy/propagator/keep.rb +26 -0
- data/lib/contrast/agent/assess/policy/propagator/next.rb +42 -0
- data/lib/contrast/agent/assess/policy/propagator/prepend.rb +50 -0
- data/lib/contrast/agent/assess/policy/propagator/remove.rb +76 -0
- data/lib/contrast/agent/assess/policy/propagator/replace.rb +27 -0
- data/lib/contrast/agent/assess/policy/propagator/reverse.rb +38 -0
- data/lib/contrast/agent/assess/policy/propagator/select.rb +86 -0
- data/lib/contrast/agent/assess/policy/propagator/splat.rb +60 -0
- data/lib/contrast/agent/assess/policy/propagator/split.rb +49 -0
- data/lib/contrast/agent/assess/policy/propagator/substitution.rb +169 -0
- data/lib/contrast/agent/assess/policy/propagator/trim.rb +81 -0
- data/lib/contrast/agent/assess/policy/rewriter_patch.rb +79 -0
- data/lib/contrast/agent/assess/policy/source_method.rb +209 -0
- data/lib/contrast/agent/assess/policy/source_node.rb +62 -0
- data/lib/contrast/agent/assess/policy/trigger_method.rb +209 -0
- data/lib/contrast/agent/assess/policy/trigger_node.rb +198 -0
- data/lib/contrast/agent/assess/policy/trigger_validation/ssrf_validator.rb +77 -0
- data/lib/contrast/agent/assess/policy/trigger_validation/trigger_validation.rb +31 -0
- data/lib/contrast/agent/assess/policy/trigger_validation/xss_validator.rb +40 -0
- data/lib/contrast/agent/assess/properties.rb +392 -0
- data/lib/contrast/agent/assess/rule.rb +18 -0
- data/lib/contrast/agent/assess/rule/base.rb +72 -0
- data/lib/contrast/agent/assess/rule/csrf.rb +66 -0
- data/lib/contrast/agent/assess/rule/csrf/csrf_action.rb +28 -0
- data/lib/contrast/agent/assess/rule/csrf/csrf_applicator.rb +69 -0
- data/lib/contrast/agent/assess/rule/csrf/csrf_watcher.rb +132 -0
- data/lib/contrast/agent/assess/rule/provider.rb +21 -0
- data/lib/contrast/agent/assess/rule/provider/hardcoded_key.rb +62 -0
- data/lib/contrast/agent/assess/rule/provider/hardcoded_password.rb +73 -0
- data/lib/contrast/agent/assess/rule/provider/hardcoded_value_rule.rb +121 -0
- data/lib/contrast/agent/assess/rule/redos.rb +68 -0
- data/lib/contrast/agent/assess/rule/response_scanning_rule.rb +47 -0
- data/lib/contrast/agent/assess/rule/response_watcher.rb +36 -0
- data/lib/contrast/agent/assess/rule/watcher.rb +36 -0
- data/lib/contrast/agent/assess/tag.rb +151 -0
- data/lib/contrast/agent/at_exit_hook.rb +33 -0
- data/lib/contrast/agent/class_reopener.rb +195 -0
- data/lib/contrast/agent/deadzone/policy/deadzone_node.rb +26 -0
- data/lib/contrast/agent/deadzone/policy/policy.rb +57 -0
- data/lib/contrast/agent/disable_reaction.rb +24 -0
- data/lib/contrast/agent/exclusion_matcher.rb +190 -0
- data/lib/contrast/agent/feature_state.rb +379 -0
- data/lib/contrast/agent/inventory/policy/policy.rb +32 -0
- data/lib/contrast/agent/inventory/policy/trigger_node.rb +22 -0
- data/lib/contrast/agent/logger_manager.rb +116 -0
- data/lib/contrast/agent/middleware.rb +352 -0
- data/lib/contrast/agent/module_data.rb +16 -0
- data/lib/contrast/agent/patching/policy/after_load_patch.rb +37 -0
- data/lib/contrast/agent/patching/policy/after_load_patcher.rb +58 -0
- data/lib/contrast/agent/patching/policy/method_policy.rb +94 -0
- data/lib/contrast/agent/patching/policy/module_policy.rb +116 -0
- data/lib/contrast/agent/patching/policy/patch.rb +312 -0
- data/lib/contrast/agent/patching/policy/patch_status.rb +192 -0
- data/lib/contrast/agent/patching/policy/patcher.rb +310 -0
- data/lib/contrast/agent/patching/policy/policy.rb +138 -0
- data/lib/contrast/agent/patching/policy/policy_node.rb +80 -0
- data/lib/contrast/agent/patching/policy/policy_unpatcher.rb +28 -0
- data/lib/contrast/agent/patching/policy/trigger_node.rb +81 -0
- data/lib/contrast/agent/protect/policy/policy.rb +37 -0
- data/lib/contrast/agent/protect/policy/trigger_node.rb +23 -0
- data/lib/contrast/agent/protect/rule.rb +58 -0
- data/lib/contrast/agent/protect/rule/base.rb +300 -0
- data/lib/contrast/agent/protect/rule/base_service.rb +88 -0
- data/lib/contrast/agent/protect/rule/cmd_injection.rb +156 -0
- data/lib/contrast/agent/protect/rule/csrf.rb +118 -0
- data/lib/contrast/agent/protect/rule/csrf/csrf_evaluator.rb +103 -0
- data/lib/contrast/agent/protect/rule/csrf/csrf_token_injector.rb +85 -0
- data/lib/contrast/agent/protect/rule/default_scanner.rb +300 -0
- data/lib/contrast/agent/protect/rule/deserialization.rb +193 -0
- data/lib/contrast/agent/protect/rule/http_method_tampering.rb +80 -0
- data/lib/contrast/agent/protect/rule/no_sqli.rb +101 -0
- data/lib/contrast/agent/protect/rule/no_sqli/mongo_no_sql_scanner.rb +40 -0
- data/lib/contrast/agent/protect/rule/path_traversal.rb +143 -0
- data/lib/contrast/agent/protect/rule/sqli.rb +101 -0
- data/lib/contrast/agent/protect/rule/sqli/default_sql_scanner.rb +16 -0
- data/lib/contrast/agent/protect/rule/sqli/mysql_sql_scanner.rb +38 -0
- data/lib/contrast/agent/protect/rule/sqli/postgres_sql_scanner.rb +22 -0
- data/lib/contrast/agent/protect/rule/sqli/sqlite_sql_scanner.rb +19 -0
- data/lib/contrast/agent/protect/rule/unsafe_file_upload.rb +20 -0
- data/lib/contrast/agent/protect/rule/xss.rb +24 -0
- data/lib/contrast/agent/protect/rule/xxe.rb +120 -0
- data/lib/contrast/agent/protect/rule/xxe/entity_wrapper.rb +82 -0
- data/lib/contrast/agent/railtie.rb +30 -0
- data/lib/contrast/agent/reaction_processor.rb +47 -0
- data/lib/contrast/agent/request.rb +493 -0
- data/lib/contrast/agent/request_context.rb +225 -0
- data/lib/contrast/agent/require_state.rb +61 -0
- data/lib/contrast/agent/response.rb +215 -0
- data/lib/contrast/agent/rewriter.rb +244 -0
- data/lib/contrast/agent/scope.rb +28 -0
- data/lib/contrast/agent/service_heartbeat.rb +37 -0
- data/lib/contrast/agent/settings_state.rb +148 -0
- data/lib/contrast/agent/socket_client.rb +125 -0
- data/lib/contrast/agent/thread.rb +26 -0
- data/lib/contrast/agent/tracepoint_hook.rb +51 -0
- data/lib/contrast/agent/version.rb +8 -0
- data/lib/contrast/api.rb +17 -0
- data/lib/contrast/api/.gitkeep +0 -0
- data/lib/contrast/api/connection_status.rb +49 -0
- data/lib/contrast/api/socket.rb +43 -0
- data/lib/contrast/api/speedracer.rb +206 -0
- data/lib/contrast/api/tcp_socket.rb +31 -0
- data/lib/contrast/api/unix_socket.rb +25 -0
- data/lib/contrast/common_agent_configuration.rb +86 -0
- data/lib/contrast/components/agent.rb +85 -0
- data/lib/contrast/components/app_context.rb +188 -0
- data/lib/contrast/components/assess.rb +67 -0
- data/lib/contrast/components/config.rb +135 -0
- data/lib/contrast/components/contrast_service.rb +113 -0
- data/lib/contrast/components/heap_dump.rb +34 -0
- data/lib/contrast/components/interface.rb +178 -0
- data/lib/contrast/components/inventory.rb +23 -0
- data/lib/contrast/components/logger.rb +92 -0
- data/lib/contrast/components/protect.rb +38 -0
- data/lib/contrast/components/sampling.rb +41 -0
- data/lib/contrast/components/scope.rb +106 -0
- data/lib/contrast/components/settings.rb +140 -0
- data/lib/contrast/config.rb +33 -0
- data/lib/contrast/config/agent_configuration.rb +24 -0
- data/lib/contrast/config/application_configuration.rb +27 -0
- data/lib/contrast/config/assess_configuration.rb +22 -0
- data/lib/contrast/config/assess_rules_configuration.rb +18 -0
- data/lib/contrast/config/base_configuration.rb +105 -0
- data/lib/contrast/config/default_value.rb +16 -0
- data/lib/contrast/config/exception_configuration.rb +21 -0
- data/lib/contrast/config/heap_dump_configuration.rb +23 -0
- data/lib/contrast/config/inventory_configuration.rb +20 -0
- data/lib/contrast/config/logger_configuration.rb +20 -0
- data/lib/contrast/config/protect_configuration.rb +20 -0
- data/lib/contrast/config/protect_rule_configuration.rb +37 -0
- data/lib/contrast/config/protect_rules_configuration.rb +30 -0
- data/lib/contrast/config/root_configuration.rb +26 -0
- data/lib/contrast/config/ruby_configuration.rb +39 -0
- data/lib/contrast/config/sampling_configuration.rb +22 -0
- data/lib/contrast/config/server_configuration.rb +23 -0
- data/lib/contrast/config/service_configuration.rb +22 -0
- data/lib/contrast/configuration.rb +214 -0
- data/lib/contrast/core_extensions/assess.rb +51 -0
- data/lib/contrast/core_extensions/assess/array.rb +58 -0
- data/lib/contrast/core_extensions/assess/assess_extension.rb +145 -0
- data/lib/contrast/core_extensions/assess/basic_object.rb +15 -0
- data/lib/contrast/core_extensions/assess/erb.rb +42 -0
- data/lib/contrast/core_extensions/assess/exec_trigger.rb +48 -0
- data/lib/contrast/core_extensions/assess/fiber.rb +125 -0
- data/lib/contrast/core_extensions/assess/hash.rb +22 -0
- data/lib/contrast/core_extensions/assess/kernel.rb +95 -0
- data/lib/contrast/core_extensions/assess/module.rb +14 -0
- data/lib/contrast/core_extensions/assess/regexp.rb +206 -0
- data/lib/contrast/core_extensions/assess/string.rb +75 -0
- data/lib/contrast/core_extensions/assess/tilt_template_trigger.rb +73 -0
- data/lib/contrast/core_extensions/delegator.rb +14 -0
- data/lib/contrast/core_extensions/eval_trigger.rb +52 -0
- data/lib/contrast/core_extensions/inventory.rb +22 -0
- data/lib/contrast/core_extensions/inventory/datastores.rb +37 -0
- data/lib/contrast/core_extensions/module.rb +42 -0
- data/lib/contrast/core_extensions/object.rb +27 -0
- data/lib/contrast/core_extensions/protect.rb +20 -0
- data/lib/contrast/core_extensions/protect/applies_command_injection_rule.rb +70 -0
- data/lib/contrast/core_extensions/protect/applies_deserialization_rule.rb +58 -0
- data/lib/contrast/core_extensions/protect/applies_no_sqli_rule.rb +81 -0
- data/lib/contrast/core_extensions/protect/applies_path_traversal_rule.rb +119 -0
- data/lib/contrast/core_extensions/protect/applies_sqli_rule.rb +63 -0
- data/lib/contrast/core_extensions/protect/applies_xxe_rule.rb +141 -0
- data/lib/contrast/core_extensions/protect/kernel.rb +30 -0
- data/lib/contrast/core_extensions/protect/psych.rb +7 -0
- data/lib/contrast/core_extensions/thread.rb +31 -0
- data/lib/contrast/internal_exception.rb +8 -0
- data/lib/contrast/rails_extensions/assess/action_controller_inheritance.rb +48 -0
- data/lib/contrast/rails_extensions/assess/active_record.rb +32 -0
- data/lib/contrast/rails_extensions/assess/active_record_named.rb +61 -0
- data/lib/contrast/rails_extensions/assess/configuration.rb +26 -0
- data/lib/contrast/rails_extensions/buffer.rb +30 -0
- data/lib/contrast/rails_extensions/rack.rb +45 -0
- data/lib/contrast/security_exception.rb +14 -0
- data/lib/contrast/sinatra_extensions/assess/cookie.rb +26 -0
- data/lib/contrast/sinatra_extensions/inventory/sinatra_base.rb +59 -0
- data/lib/contrast/tasks/service.rb +95 -0
- data/lib/contrast/utils/assess/sampling_util.rb +96 -0
- data/lib/contrast/utils/assess/tracking_util.rb +39 -0
- data/lib/contrast/utils/boolean_util.rb +33 -0
- data/lib/contrast/utils/cache.rb +69 -0
- data/lib/contrast/utils/class_util.rb +58 -0
- data/lib/contrast/utils/comment_range.rb +19 -0
- data/lib/contrast/utils/data_store_util.rb +23 -0
- data/lib/contrast/utils/duck_utils.rb +58 -0
- data/lib/contrast/utils/env_configuration_item.rb +52 -0
- data/lib/contrast/utils/environment_util.rb +152 -0
- data/lib/contrast/utils/freeze_util.rb +36 -0
- data/lib/contrast/utils/gemfile_reader.rb +191 -0
- data/lib/contrast/utils/hash_digest.rb +148 -0
- data/lib/contrast/utils/heap_dump_util.rb +113 -0
- data/lib/contrast/utils/invalid_configuration_util.rb +88 -0
- data/lib/contrast/utils/inventory_util.rb +126 -0
- data/lib/contrast/utils/io_util.rb +61 -0
- data/lib/contrast/utils/object_share.rb +117 -0
- data/lib/contrast/utils/operating_environment.rb +38 -0
- data/lib/contrast/utils/os.rb +49 -0
- data/lib/contrast/utils/path_util.rb +151 -0
- data/lib/contrast/utils/performs_logging.rb +152 -0
- data/lib/contrast/utils/preflight_util.rb +13 -0
- data/lib/contrast/utils/prevent_serialization.rb +52 -0
- data/lib/contrast/utils/rack_assess_session_cookie.rb +104 -0
- data/lib/contrast/utils/rails_assess_configuration.rb +95 -0
- data/lib/contrast/utils/random_util.rb +22 -0
- data/lib/contrast/utils/resource_loader.rb +23 -0
- data/lib/contrast/utils/ruby_ast_rewriter.rb +74 -0
- data/lib/contrast/utils/scope_util.rb +99 -0
- data/lib/contrast/utils/service_response_util.rb +116 -0
- data/lib/contrast/utils/service_sender_util.rb +98 -0
- data/lib/contrast/utils/sha256_builder.rb +69 -0
- data/lib/contrast/utils/sinatra_helper.rb +49 -0
- data/lib/contrast/utils/stack_trace_utils.rb +209 -0
- data/lib/contrast/utils/string_utils.rb +72 -0
- data/lib/contrast/utils/tag_util.rb +139 -0
- data/lib/contrast/utils/thread_tracker.rb +54 -0
- data/lib/contrast/utils/timer.rb +78 -0
- data/resources/assess/policy.json +1673 -0
- data/resources/csrf/inject.js +44 -0
- data/resources/deadzone/policy.json +55 -0
- data/resources/factory-bot-spec/spec_helper.rb +30 -0
- data/resources/inventory/policy.json +110 -0
- data/resources/protect/policy.json +417 -0
- data/resources/rubocops/kernel/catch_cop.rb +37 -0
- data/resources/rubocops/kernel/require_cop.rb +37 -0
- data/resources/rubocops/kernel/require_relative_cop.rb +33 -0
- data/resources/rubocops/module/autoload_cop.rb +37 -0
- data/resources/rubocops/module/const_defined_cop.rb +37 -0
- data/resources/rubocops/module/const_get_cop.rb +37 -0
- data/resources/rubocops/module/const_set_cop.rb +37 -0
- data/resources/rubocops/module/constants_cop.rb +37 -0
- data/resources/rubocops/module/name_cop.rb +37 -0
- data/resources/rubocops/object/class_cop.rb +37 -0
- data/resources/rubocops/object/freeze_cop.rb +37 -0
- data/resources/rubocops/object/frozen_cop.rb +37 -0
- data/resources/rubocops/object/is_a_cop.rb +37 -0
- data/resources/rubocops/object/method_cop.rb +37 -0
- data/resources/rubocops/object/respond_to_cop.rb +37 -0
- data/resources/rubocops/object/singleton_class_cop.rb +37 -0
- data/resources/rubocops/regexp/spelling_cop.rb +44 -0
- data/resources/rubocops/thread/new_cop.rb +39 -0
- data/resources/ruby-spec/ancestors_spec.rb +70 -0
- data/resources/ruby-spec/modulo_spec.rb +831 -0
- data/resources/ruby-spec/parameters_spec.rb +261 -0
- data/resources/ruby-spec/ruby_spec_spec_helper.rb +35 -0
- data/resources/test_marker.txt +1 -0
- data/ruby-agent.gemspec +129 -0
- data/service_executables/.gitkeep +0 -0
- data/service_executables/VERSION +1 -0
- data/service_executables/linux/contrast-service +0 -0
- data/service_executables/mac/contrast-service +0 -0
- metadata +945 -0
@@ -0,0 +1,196 @@
|
|
1
|
+
#include <ruby.h>
|
2
|
+
|
3
|
+
typedef enum {
|
4
|
+
IMPL_ALIAS_INSTANCE,
|
5
|
+
IMPL_ALIAS_SINGLETON,
|
6
|
+
IMPL_PREPEND
|
7
|
+
} patch_impl;
|
8
|
+
|
9
|
+
/* Calls to Contrast modules */
|
10
|
+
/* Contrast::Agent::Patching::Policy::PatchStatus */
|
11
|
+
static VALUE patch_status;
|
12
|
+
/* Contrast::Agent::Assess::PreShift */
|
13
|
+
static VALUE preshift_class;
|
14
|
+
/* Symbol constants used throughout */
|
15
|
+
static VALUE rb_sym_brackets;
|
16
|
+
static VALUE rb_sym_build_preshift;
|
17
|
+
|
18
|
+
static VALUE rb_sym_contrast_apply_post_patch;
|
19
|
+
static VALUE rb_sym_contrast_apply_pre_patch;
|
20
|
+
|
21
|
+
static VALUE rb_sym_custom_patch;
|
22
|
+
static VALUE rb_sym_cs_to_s;
|
23
|
+
|
24
|
+
static VALUE rb_sym_in_request_context;
|
25
|
+
|
26
|
+
static VALUE rb_sym_build_method_name;
|
27
|
+
static VALUE rb_sym_info_for;
|
28
|
+
static VALUE rb_sym_propagation_node;
|
29
|
+
static VALUE rb_sym_set_info_for;
|
30
|
+
static VALUE rb_sym_private_method;
|
31
|
+
static VALUE rb_sym_method_name;
|
32
|
+
static VALUE rb_sym_alias_method;
|
33
|
+
static VALUE rb_sym_public;
|
34
|
+
static VALUE rb_sym_private;
|
35
|
+
static VALUE rb_sym_instance_method;
|
36
|
+
static VALUE rb_sym_cs_singleton_class;
|
37
|
+
|
38
|
+
/**
|
39
|
+
* Build the preshift object - a snapshot of the object and parameters before
|
40
|
+
* they're transformed by the method being patched. This is required for
|
41
|
+
* proper taint creation in propagation events.
|
42
|
+
*
|
43
|
+
* method_policy - method_policy for the patched method; :MethodPolicy
|
44
|
+
* object - the object on which the method is invoked; Object
|
45
|
+
* argc - the number of params passed to the call of the patched method; C int
|
46
|
+
* params - the params passed to the call of the patched method; C Array
|
47
|
+
*
|
48
|
+
* return - :PreShift or nil if no snapshot is required
|
49
|
+
*/
|
50
|
+
VALUE build_preshift(const VALUE method_policy, const VALUE object,
|
51
|
+
const int argc, const VALUE *params);
|
52
|
+
|
53
|
+
/**
|
54
|
+
* Call the original function. Because we have to use the rb_rescue method, the
|
55
|
+
* args all have to be passed in as a C array.
|
56
|
+
*
|
57
|
+
* args[0] - the object on which the method is invoked; Object
|
58
|
+
* args[1] - the name of the method to be invoked, aliased by Contrast during
|
59
|
+
* patching; cs__ format Symbol
|
60
|
+
* args[2] - the number of params to be used when the method is invoked; C int
|
61
|
+
* args[3] - the params to be used when the method is invoked; C Array or NULL
|
62
|
+
*
|
63
|
+
* return - the return value of the original function; Object, nil, or
|
64
|
+
* Exception
|
65
|
+
*/
|
66
|
+
VALUE contrast_patch_call_original(const VALUE *args);
|
67
|
+
|
68
|
+
/**
|
69
|
+
* Call the contrast patching function responsible for tracking, propagating,
|
70
|
+
* and triggering.
|
71
|
+
*
|
72
|
+
* method_policy - method policy for the patched method; :MethodPolicy
|
73
|
+
* object - the object on which the method was invoked; Object
|
74
|
+
* argc - the number of params used when the method was invoked; C int
|
75
|
+
* params - the params used when the method was invoked; C Array or NULL
|
76
|
+
* exception - any exceptions raised that this patch has to account for
|
77
|
+
* return - the value with which to replace the original functions
|
78
|
+
* return, allowing us to track frozen sources, or nil
|
79
|
+
*/
|
80
|
+
VALUE contrast_call_pre_patch(const VALUE method_policy, const VALUE method,
|
81
|
+
const VALUE object, const int count,
|
82
|
+
const VALUE *params, const VALUE exception);
|
83
|
+
|
84
|
+
/**
|
85
|
+
* Call the contrast patching function responsible for tracking, propagating,
|
86
|
+
* and triggering.
|
87
|
+
*
|
88
|
+
* method_policy - method_policy for the patched method; :MethodPolicy
|
89
|
+
* preshift - a capture of the state before the method was invoked; :PreShift
|
90
|
+
* object - the object on which the method was invoked; Object
|
91
|
+
* ret - the return of the method that was invoked; Object or nil
|
92
|
+
* argc - the number of params used when the method was invoked; C int
|
93
|
+
* params - the params used when the method was invoked; C Array or NULL
|
94
|
+
*
|
95
|
+
* return - the value with which to replace the original functions return,
|
96
|
+
* allowing us to track frozen sources, or nil
|
97
|
+
*/
|
98
|
+
VALUE contrast_call_post_patch(const VALUE method_policy, const VALUE preshift,
|
99
|
+
const VALUE object, const VALUE ret,
|
100
|
+
const int count, const VALUE *params);
|
101
|
+
|
102
|
+
/**
|
103
|
+
* Call our Contrast rescue block for the original function. If the call to
|
104
|
+
* the original function results in exception, we still need to do our Contrast
|
105
|
+
* things. An example is triggering for a SecurityException, i.e. if a command
|
106
|
+
* is poorly formatted doesn't mean it isn't still a command injection.
|
107
|
+
*
|
108
|
+
* args[0] - the object on which the method was invoked; Object
|
109
|
+
* args[1] - the name of the method invoked; Symbol
|
110
|
+
* args[2] - the number of params used when the method was invoked; C int
|
111
|
+
* args[3] - the params used when the method was invoked; C Array or NULL
|
112
|
+
* args[4] - method_policy for the patched method; :MethodPolicy
|
113
|
+
* args[5] - a capture of the state before the method was invoked; :PreShift
|
114
|
+
*
|
115
|
+
*/
|
116
|
+
VALUE contrast_patch_call_rescue(const VALUE *args);
|
117
|
+
|
118
|
+
/**
|
119
|
+
* Call super() with an rb_rescue-compatible function signature.
|
120
|
+
*
|
121
|
+
* args[0] - argc, as native int.
|
122
|
+
* args[1] - *argv, of size argc.
|
123
|
+
*
|
124
|
+
* */
|
125
|
+
VALUE contrast_call_super(const VALUE *args);
|
126
|
+
|
127
|
+
/*
|
128
|
+
* Build the 'proc' to call in place of the original method
|
129
|
+
* 1) Pull the things needed from Policy
|
130
|
+
* 2) Capture state
|
131
|
+
* 3) Do Contrast things
|
132
|
+
* 4) Invoke the original method
|
133
|
+
* 5) Do more Contrast things
|
134
|
+
*
|
135
|
+
* argc - the number of args used in this invocation of the method; C int
|
136
|
+
* argv - the args used in this invocation of the method; C Array
|
137
|
+
* impl - what patch implementation is being used
|
138
|
+
* object - the object on which this invocation of the method occurs; Object
|
139
|
+
*
|
140
|
+
* return - the result of the original function, or as close to it as we can
|
141
|
+
* get. Should be the same value, but not guaranteed to be the same
|
142
|
+
* instance (specifically for frozen sources)
|
143
|
+
*/
|
144
|
+
VALUE contrast_patch_dispatch(const int argc, const VALUE *argv,
|
145
|
+
const patch_impl impl,
|
146
|
+
const VALUE object);
|
147
|
+
|
148
|
+
VALUE contrast_alias_instance_patch(const int argc, const VALUE *argv,
|
149
|
+
const VALUE object);
|
150
|
+
|
151
|
+
VALUE contrast_alias_singleton_patch(const int argc, const VALUE *argv,
|
152
|
+
const VALUE object);
|
153
|
+
|
154
|
+
|
155
|
+
VALUE contrast_prepend_patch(const int argc, const VALUE *argv,
|
156
|
+
const VALUE object);
|
157
|
+
|
158
|
+
/*
|
159
|
+
* Patches a module's method by prepend:
|
160
|
+
* - creates a Contrast module under the namespace of the original module
|
161
|
+
* - defines a shim method on the Contrast module
|
162
|
+
* - prepends the Contrast module to the original module
|
163
|
+
* After this, calling the original method results in calling our shim
|
164
|
+
* method instead. Our shim method can call super() to achieve original
|
165
|
+
* behavior.
|
166
|
+
*
|
167
|
+
* Example:
|
168
|
+
* Prepending Foo#bar results in:
|
169
|
+
* - creating Foo::ContrastPrepend
|
170
|
+
* - defining shim method Foo::ContrastPrepend#bar
|
171
|
+
* - prepending Foo with Foo::ContrastPrepend
|
172
|
+
*
|
173
|
+
* originalModule - Module; the actual Module being prepended
|
174
|
+
* methodPolicy - :MethodPolicy; the method policy that apply to the method being redefined
|
175
|
+
*
|
176
|
+
* return - Boolean; if the prepend occurred or not
|
177
|
+
*/
|
178
|
+
VALUE contrast_patch_prepend(const VALUE self,
|
179
|
+
const VALUE originalModule,
|
180
|
+
const VALUE methodPolicy);
|
181
|
+
|
182
|
+
/*
|
183
|
+
* Call this to redefine the given function such that it can be invoked with
|
184
|
+
* Contrast assess tracking.
|
185
|
+
*
|
186
|
+
* self - Patcher C - Ruby magic binding thing
|
187
|
+
* clazz - the class that owns the method being redefined; Module or Class
|
188
|
+
* method_policy - the method policy that apply to the method being redefined;
|
189
|
+
* :MethodPolicy
|
190
|
+
* cs_method - the name to which the method is being redefined; Symbol
|
191
|
+
*/
|
192
|
+
VALUE contrast_patch_define_method(const VALUE self, const VALUE clazz,
|
193
|
+
const VALUE methodPolicy,
|
194
|
+
const VALUE cs_method);
|
195
|
+
|
196
|
+
void Init_cs__contrast_patch(void);
|
@@ -0,0 +1,37 @@
|
|
1
|
+
/* Copyright (c) 2020 Contrast Security, Inc. See
|
2
|
+
* https://www.contrastsecurity.com/enduser-terms-0317a for more details. */
|
3
|
+
|
4
|
+
#include "cs__protect_kernel.h"
|
5
|
+
#include "../cs__common/cs__common.h"
|
6
|
+
#include <ruby.h>
|
7
|
+
|
8
|
+
static VALUE contrast_protect_fork(const int argc, const VALUE *argv,
|
9
|
+
const VALUE self) {
|
10
|
+
VALUE ret;
|
11
|
+
if (rb_block_given_p()) {
|
12
|
+
VALUE wrapper;
|
13
|
+
wrapper =
|
14
|
+
rb_funcall_with_block(rb_mKernel, rb_sym_protect_kernel_wrapper, 0,
|
15
|
+
NULL, rb_block_proc());
|
16
|
+
ret = rb_funcall_with_block(self, rb_sym_protect_kernel_fork, argc,
|
17
|
+
argv, wrapper);
|
18
|
+
} else {
|
19
|
+
ret = rb_funcall2(self, rb_sym_protect_kernel_fork, argc, argv);
|
20
|
+
}
|
21
|
+
return ret;
|
22
|
+
}
|
23
|
+
|
24
|
+
void Init_cs__protect_kernel(void) {
|
25
|
+
|
26
|
+
rb_sym_protect_kernel_fork = rb_intern("cs__protect_kernel_fork");
|
27
|
+
rb_sym_protect_kernel_wrapper = rb_intern("cs__protect_build_wrapper");
|
28
|
+
|
29
|
+
VALUE singleton = rb_singleton_class(rb_mKernel);
|
30
|
+
contrast_alias_method(rb_mKernel, "cs__protect_kernel_fork", "fork");
|
31
|
+
contrast_alias_method(singleton, "cs__protect_kernel_fork", "fork");
|
32
|
+
rb_define_module_function(rb_mKernel, "fork", contrast_protect_fork, -1);
|
33
|
+
// Kernel#fork, as opposed to Kernel.fork, is private. Restore that.
|
34
|
+
rb_funcall(rb_mKernel, rb_intern("public"), 1,
|
35
|
+
ID2SYM(rb_intern("cs__protect_kernel_fork")));
|
36
|
+
rb_funcall(rb_mKernel, rb_intern("private"), 1, ID2SYM(rb_intern("fork")));
|
37
|
+
}
|
@@ -0,0 +1,11 @@
|
|
1
|
+
#include <ruby.h>
|
2
|
+
|
3
|
+
extern VALUE rb_vm_top_self(void);
|
4
|
+
|
5
|
+
static VALUE rb_sym_protect_kernel_fork;
|
6
|
+
static VALUE rb_sym_protect_kernel_wrapper;
|
7
|
+
|
8
|
+
static VALUE
|
9
|
+
contrast_protect_fork(const int argc, const VALUE *argv, const VALUE self);
|
10
|
+
|
11
|
+
void Init_cs__protect_kernel(void);
|
@@ -0,0 +1,96 @@
|
|
1
|
+
/* Copyright (c) 2020 Contrast Security, Inc. See
|
2
|
+
* https://www.contrastsecurity.com/enduser-terms-0317a for more details. */
|
3
|
+
|
4
|
+
#include "cs__scope.h"
|
5
|
+
#include <ruby.h>
|
6
|
+
|
7
|
+
VALUE in_given_scope(const VALUE object, const char *scope) {
|
8
|
+
VALUE level;
|
9
|
+
level = rb_iv_get(object, scope);
|
10
|
+
if (NUM2INT(level) > 0) {
|
11
|
+
return Qtrue;
|
12
|
+
}
|
13
|
+
return Qfalse;
|
14
|
+
}
|
15
|
+
|
16
|
+
void enter_given_scope(const VALUE object, const char *scope) {
|
17
|
+
int level = NUM2INT(rb_iv_get(object, scope));
|
18
|
+
rb_iv_set(object, scope, INT2NUM(level + 1));
|
19
|
+
}
|
20
|
+
|
21
|
+
void exit_given_scope(const VALUE object, const char *scope) {
|
22
|
+
int level = NUM2INT(rb_iv_get(object, scope));
|
23
|
+
rb_iv_set(object, scope, INT2NUM(level - 1));
|
24
|
+
}
|
25
|
+
|
26
|
+
VALUE in_contrast_scope(const VALUE self) {
|
27
|
+
return in_given_scope(self, ivar_contrast_scope);
|
28
|
+
}
|
29
|
+
|
30
|
+
VALUE enter_contrast_scope(const VALUE self) {
|
31
|
+
enter_given_scope(self, ivar_contrast_scope);
|
32
|
+
return Qnil;
|
33
|
+
}
|
34
|
+
|
35
|
+
VALUE exit_contrast_scope(const VALUE self) {
|
36
|
+
exit_given_scope(self, ivar_contrast_scope);
|
37
|
+
return Qnil;
|
38
|
+
}
|
39
|
+
|
40
|
+
VALUE run_in_scope(const VALUE self) {
|
41
|
+
enter_contrast_scope(self);
|
42
|
+
rb_ensure(rb_yield, Qundef, exit_contrast_scope, self);
|
43
|
+
return Qnil;
|
44
|
+
}
|
45
|
+
|
46
|
+
VALUE enter_scope_for(const VALUE self, const VALUE scope_symbol) {
|
47
|
+
enter_contrast_scope(self);
|
48
|
+
|
49
|
+
return Qnil;
|
50
|
+
}
|
51
|
+
|
52
|
+
VALUE exit_scope_for(const VALUE self, const VALUE scope_symbol) {
|
53
|
+
exit_contrast_scope(self);
|
54
|
+
|
55
|
+
return Qnil;
|
56
|
+
}
|
57
|
+
|
58
|
+
VALUE initialize(const VALUE self) {
|
59
|
+
rb_iv_set(self, ivar_contrast_scope, rbzero);
|
60
|
+
|
61
|
+
return self;
|
62
|
+
}
|
63
|
+
|
64
|
+
VALUE deep_clone(const VALUE self) {
|
65
|
+
VALUE new_scope = rb_funcall(scope_class, rb_sym_new, 0);
|
66
|
+
rb_iv_set(new_scope, ivar_contrast_scope,
|
67
|
+
rb_iv_get(self, ivar_contrast_scope));
|
68
|
+
return new_scope;
|
69
|
+
}
|
70
|
+
|
71
|
+
void Init_cs__scope(void) {
|
72
|
+
rb_sym_new = rb_intern("new");
|
73
|
+
VALUE contrast = rb_define_module("Contrast");
|
74
|
+
VALUE agent = rb_define_module_under(contrast, "Agent");
|
75
|
+
scope_class = rb_define_class_under(agent, "Scope", rb_cObject);
|
76
|
+
rb_define_method(scope_class, "initialize", initialize, 0);
|
77
|
+
|
78
|
+
ivar_contrast_scope = "@contrast_scope";
|
79
|
+
|
80
|
+
rb_define_const(scope_class, "CONTRAST_SCOPE",
|
81
|
+
ID2SYM(rb_intern("contrast")));
|
82
|
+
CONTRAST_SCOPE = rb_const_get(scope_class, rb_intern("CONTRAST_SCOPE"));
|
83
|
+
|
84
|
+
rb_define_method(scope_class, "in_contrast_scope?", in_contrast_scope, 0);
|
85
|
+
|
86
|
+
rb_define_method(scope_class, "enter_contrast_scope", enter_contrast_scope,
|
87
|
+
0);
|
88
|
+
rb_define_method(scope_class, "exit_contrast_scope", exit_contrast_scope,
|
89
|
+
0);
|
90
|
+
|
91
|
+
rb_define_method(scope_class, "run_in_scope", run_in_scope, 0);
|
92
|
+
rb_define_method(scope_class, "enter_scope_for", enter_scope_for, 1);
|
93
|
+
rb_define_method(scope_class, "exit_scope_for", exit_scope_for, 1);
|
94
|
+
|
95
|
+
rb_define_method(scope_class, "deep_clone", deep_clone, 0);
|
96
|
+
}
|
@@ -0,0 +1,33 @@
|
|
1
|
+
#include <ruby.h>
|
2
|
+
|
3
|
+
VALUE rbzero = INT2NUM(0);
|
4
|
+
VALUE scope_class;
|
5
|
+
VALUE rb_sym_new;
|
6
|
+
|
7
|
+
const char *ivar_contrast_scope;
|
8
|
+
|
9
|
+
VALUE CONTRAST_SCOPE;
|
10
|
+
|
11
|
+
VALUE in_given_scope(const VALUE object, const char *scope);
|
12
|
+
|
13
|
+
void enter_given_scope(const VALUE object, const char *scope);
|
14
|
+
|
15
|
+
void exit_given_scope(const VALUE object, const char *scope);
|
16
|
+
|
17
|
+
VALUE in_contrast_scope(const VALUE self);
|
18
|
+
|
19
|
+
VALUE enter_contrast_scope(const VALUE self);
|
20
|
+
|
21
|
+
VALUE exit_contrast_scope(const VALUE self);
|
22
|
+
|
23
|
+
VALUE run_in_scope(const VALUE self);
|
24
|
+
|
25
|
+
VALUE enter_scope_for(const VALUE self, const VALUE scope_symbol);
|
26
|
+
|
27
|
+
VALUE exit_scope_for(const VALUE self, const VALUE scope_symbol);
|
28
|
+
|
29
|
+
VALUE initialize(const VALUE self);
|
30
|
+
|
31
|
+
VALUE deep_clone(const VALUE self);
|
32
|
+
|
33
|
+
void Init_cs__scope(void);
|
@@ -0,0 +1,49 @@
|
|
1
|
+
# Copyright (c) 2020 Contrast Security, Inc. See https://www.contrastsecurity.com/enduser-terms-0317a for more details.
|
2
|
+
require 'mkmf'
|
3
|
+
|
4
|
+
require_relative '../lib/contrast/agent/version'
|
5
|
+
|
6
|
+
def name
|
7
|
+
$TO_MAKE
|
8
|
+
end
|
9
|
+
|
10
|
+
def make!
|
11
|
+
create_makefile "#{name}/#{name}"
|
12
|
+
end
|
13
|
+
|
14
|
+
def ext_path
|
15
|
+
# __dir__ is relative to the file you're reading.
|
16
|
+
# this file you're reading is presently within $APP_ROOT/ext/.
|
17
|
+
__dir__
|
18
|
+
end
|
19
|
+
|
20
|
+
def rpath_root
|
21
|
+
if (darwin = !(/darwin/ =~ RUBY_PLATFORM).nil?)
|
22
|
+
"@loader_path"
|
23
|
+
else
|
24
|
+
"\\$${ORIGIN}"
|
25
|
+
end
|
26
|
+
end
|
27
|
+
|
28
|
+
def funchook_rpath!
|
29
|
+
options = " -Wl,-rpath,#{rpath_root}/../../shared_libraries"
|
30
|
+
raise unless try_link('int main() {return 0;}', options)
|
31
|
+
$LDFLAGS << options
|
32
|
+
$LDFLAGS << " -L#{__dir__}/../shared_libraries"
|
33
|
+
|
34
|
+
find_header('funchook.h', ext_path)
|
35
|
+
have_header('funchook.h')
|
36
|
+
|
37
|
+
find_library('funchook', 'funchook_create', "../shared_libraries")
|
38
|
+
find_library('funchook', 'funchook_install')
|
39
|
+
find_library('funchook', 'funchook_prepare')
|
40
|
+
have_library('funchook', 'funchook_create')
|
41
|
+
have_library('funchook', 'funchook_install')
|
42
|
+
have_library('funchook', 'funchook_prepare')
|
43
|
+
end
|
44
|
+
|
45
|
+
require_relative './build_funchook'
|
46
|
+
|
47
|
+
# default make pathway, here for convenience
|
48
|
+
funchook_rpath!
|
49
|
+
make!
|
data/funchook/LICENSE
ADDED
@@ -0,0 +1,360 @@
|
|
1
|
+
Funchook is distributed under the terms of the GNU General Public
|
2
|
+
License version 2 or later with the following clarification and
|
3
|
+
special exception.
|
4
|
+
|
5
|
+
Linking this library statically or dynamically with other modules is
|
6
|
+
making a combined work based on this library. Thus, the terms and
|
7
|
+
conditions of the GNU General Public License cover the whole
|
8
|
+
combination.
|
9
|
+
|
10
|
+
As a special exception, the copyright holders of this library give you
|
11
|
+
permission to link this library with independent modules to produce an
|
12
|
+
executable, regardless of the license terms of these independent
|
13
|
+
modules, and to copy and distribute the resulting executable under
|
14
|
+
terms of your choice, provided that you also meet, for each linked
|
15
|
+
independent module, the terms and conditions of the license of that
|
16
|
+
module. An independent module is a module which is not derived from or
|
17
|
+
based on this library. If you modify this library, you must extend this
|
18
|
+
exception to your version of the library.
|
19
|
+
|
20
|
+
=====================================================================
|
21
|
+
|
22
|
+
GNU GENERAL PUBLIC LICENSE
|
23
|
+
Version 2, June 1991
|
24
|
+
|
25
|
+
Copyright (C) 1989, 1991 Free Software Foundation, Inc.,
|
26
|
+
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
|
27
|
+
Everyone is permitted to copy and distribute verbatim copies
|
28
|
+
of this license document, but changing it is not allowed.
|
29
|
+
|
30
|
+
Preamble
|
31
|
+
|
32
|
+
The licenses for most software are designed to take away your
|
33
|
+
freedom to share and change it. By contrast, the GNU General Public
|
34
|
+
License is intended to guarantee your freedom to share and change free
|
35
|
+
software--to make sure the software is free for all its users. This
|
36
|
+
General Public License applies to most of the Free Software
|
37
|
+
Foundation's software and to any other program whose authors commit to
|
38
|
+
using it. (Some other Free Software Foundation software is covered by
|
39
|
+
the GNU Lesser General Public License instead.) You can apply it to
|
40
|
+
your programs, too.
|
41
|
+
|
42
|
+
When we speak of free software, we are referring to freedom, not
|
43
|
+
price. Our General Public Licenses are designed to make sure that you
|
44
|
+
have the freedom to distribute copies of free software (and charge for
|
45
|
+
this service if you wish), that you receive source code or can get it
|
46
|
+
if you want it, that you can change the software or use pieces of it
|
47
|
+
in new free programs; and that you know you can do these things.
|
48
|
+
|
49
|
+
To protect your rights, we need to make restrictions that forbid
|
50
|
+
anyone to deny you these rights or to ask you to surrender the rights.
|
51
|
+
These restrictions translate to certain responsibilities for you if you
|
52
|
+
distribute copies of the software, or if you modify it.
|
53
|
+
|
54
|
+
For example, if you distribute copies of such a program, whether
|
55
|
+
gratis or for a fee, you must give the recipients all the rights that
|
56
|
+
you have. You must make sure that they, too, receive or can get the
|
57
|
+
source code. And you must show them these terms so they know their
|
58
|
+
rights.
|
59
|
+
|
60
|
+
We protect your rights with two steps: (1) copyright the software, and
|
61
|
+
(2) offer you this license which gives you legal permission to copy,
|
62
|
+
distribute and/or modify the software.
|
63
|
+
|
64
|
+
Also, for each author's protection and ours, we want to make certain
|
65
|
+
that everyone understands that there is no warranty for this free
|
66
|
+
software. If the software is modified by someone else and passed on, we
|
67
|
+
want its recipients to know that what they have is not the original, so
|
68
|
+
that any problems introduced by others will not reflect on the original
|
69
|
+
authors' reputations.
|
70
|
+
|
71
|
+
Finally, any free program is threatened constantly by software
|
72
|
+
patents. We wish to avoid the danger that redistributors of a free
|
73
|
+
program will individually obtain patent licenses, in effect making the
|
74
|
+
program proprietary. To prevent this, we have made it clear that any
|
75
|
+
patent must be licensed for everyone's free use or not licensed at all.
|
76
|
+
|
77
|
+
The precise terms and conditions for copying, distribution and
|
78
|
+
modification follow.
|
79
|
+
|
80
|
+
GNU GENERAL PUBLIC LICENSE
|
81
|
+
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
|
82
|
+
|
83
|
+
0. This License applies to any program or other work which contains
|
84
|
+
a notice placed by the copyright holder saying it may be distributed
|
85
|
+
under the terms of this General Public License. The "Program", below,
|
86
|
+
refers to any such program or work, and a "work based on the Program"
|
87
|
+
means either the Program or any derivative work under copyright law:
|
88
|
+
that is to say, a work containing the Program or a portion of it,
|
89
|
+
either verbatim or with modifications and/or translated into another
|
90
|
+
language. (Hereinafter, translation is included without limitation in
|
91
|
+
the term "modification".) Each licensee is addressed as "you".
|
92
|
+
|
93
|
+
Activities other than copying, distribution and modification are not
|
94
|
+
covered by this License; they are outside its scope. The act of
|
95
|
+
running the Program is not restricted, and the output from the Program
|
96
|
+
is covered only if its contents constitute a work based on the
|
97
|
+
Program (independent of having been made by running the Program).
|
98
|
+
Whether that is true depends on what the Program does.
|
99
|
+
|
100
|
+
1. You may copy and distribute verbatim copies of the Program's
|
101
|
+
source code as you receive it, in any medium, provided that you
|
102
|
+
conspicuously and appropriately publish on each copy an appropriate
|
103
|
+
copyright notice and disclaimer of warranty; keep intact all the
|
104
|
+
notices that refer to this License and to the absence of any warranty;
|
105
|
+
and give any other recipients of the Program a copy of this License
|
106
|
+
along with the Program.
|
107
|
+
|
108
|
+
You may charge a fee for the physical act of transferring a copy, and
|
109
|
+
you may at your option offer warranty protection in exchange for a fee.
|
110
|
+
|
111
|
+
2. You may modify your copy or copies of the Program or any portion
|
112
|
+
of it, thus forming a work based on the Program, and copy and
|
113
|
+
distribute such modifications or work under the terms of Section 1
|
114
|
+
above, provided that you also meet all of these conditions:
|
115
|
+
|
116
|
+
a) You must cause the modified files to carry prominent notices
|
117
|
+
stating that you changed the files and the date of any change.
|
118
|
+
|
119
|
+
b) You must cause any work that you distribute or publish, that in
|
120
|
+
whole or in part contains or is derived from the Program or any
|
121
|
+
part thereof, to be licensed as a whole at no charge to all third
|
122
|
+
parties under the terms of this License.
|
123
|
+
|
124
|
+
c) If the modified program normally reads commands interactively
|
125
|
+
when run, you must cause it, when started running for such
|
126
|
+
interactive use in the most ordinary way, to print or display an
|
127
|
+
announcement including an appropriate copyright notice and a
|
128
|
+
notice that there is no warranty (or else, saying that you provide
|
129
|
+
a warranty) and that users may redistribute the program under
|
130
|
+
these conditions, and telling the user how to view a copy of this
|
131
|
+
License. (Exception: if the Program itself is interactive but
|
132
|
+
does not normally print such an announcement, your work based on
|
133
|
+
the Program is not required to print an announcement.)
|
134
|
+
|
135
|
+
These requirements apply to the modified work as a whole. If
|
136
|
+
identifiable sections of that work are not derived from the Program,
|
137
|
+
and can be reasonably considered independent and separate works in
|
138
|
+
themselves, then this License, and its terms, do not apply to those
|
139
|
+
sections when you distribute them as separate works. But when you
|
140
|
+
distribute the same sections as part of a whole which is a work based
|
141
|
+
on the Program, the distribution of the whole must be on the terms of
|
142
|
+
this License, whose permissions for other licensees extend to the
|
143
|
+
entire whole, and thus to each and every part regardless of who wrote it.
|
144
|
+
|
145
|
+
Thus, it is not the intent of this section to claim rights or contest
|
146
|
+
your rights to work written entirely by you; rather, the intent is to
|
147
|
+
exercise the right to control the distribution of derivative or
|
148
|
+
collective works based on the Program.
|
149
|
+
|
150
|
+
In addition, mere aggregation of another work not based on the Program
|
151
|
+
with the Program (or with a work based on the Program) on a volume of
|
152
|
+
a storage or distribution medium does not bring the other work under
|
153
|
+
the scope of this License.
|
154
|
+
|
155
|
+
3. You may copy and distribute the Program (or a work based on it,
|
156
|
+
under Section 2) in object code or executable form under the terms of
|
157
|
+
Sections 1 and 2 above provided that you also do one of the following:
|
158
|
+
|
159
|
+
a) Accompany it with the complete corresponding machine-readable
|
160
|
+
source code, which must be distributed under the terms of Sections
|
161
|
+
1 and 2 above on a medium customarily used for software interchange; or,
|
162
|
+
|
163
|
+
b) Accompany it with a written offer, valid for at least three
|
164
|
+
years, to give any third party, for a charge no more than your
|
165
|
+
cost of physically performing source distribution, a complete
|
166
|
+
machine-readable copy of the corresponding source code, to be
|
167
|
+
distributed under the terms of Sections 1 and 2 above on a medium
|
168
|
+
customarily used for software interchange; or,
|
169
|
+
|
170
|
+
c) Accompany it with the information you received as to the offer
|
171
|
+
to distribute corresponding source code. (This alternative is
|
172
|
+
allowed only for noncommercial distribution and only if you
|
173
|
+
received the program in object code or executable form with such
|
174
|
+
an offer, in accord with Subsection b above.)
|
175
|
+
|
176
|
+
The source code for a work means the preferred form of the work for
|
177
|
+
making modifications to it. For an executable work, complete source
|
178
|
+
code means all the source code for all modules it contains, plus any
|
179
|
+
associated interface definition files, plus the scripts used to
|
180
|
+
control compilation and installation of the executable. However, as a
|
181
|
+
special exception, the source code distributed need not include
|
182
|
+
anything that is normally distributed (in either source or binary
|
183
|
+
form) with the major components (compiler, kernel, and so on) of the
|
184
|
+
operating system on which the executable runs, unless that component
|
185
|
+
itself accompanies the executable.
|
186
|
+
|
187
|
+
If distribution of executable or object code is made by offering
|
188
|
+
access to copy from a designated place, then offering equivalent
|
189
|
+
access to copy the source code from the same place counts as
|
190
|
+
distribution of the source code, even though third parties are not
|
191
|
+
compelled to copy the source along with the object code.
|
192
|
+
|
193
|
+
4. You may not copy, modify, sublicense, or distribute the Program
|
194
|
+
except as expressly provided under this License. Any attempt
|
195
|
+
otherwise to copy, modify, sublicense or distribute the Program is
|
196
|
+
void, and will automatically terminate your rights under this License.
|
197
|
+
However, parties who have received copies, or rights, from you under
|
198
|
+
this License will not have their licenses terminated so long as such
|
199
|
+
parties remain in full compliance.
|
200
|
+
|
201
|
+
5. You are not required to accept this License, since you have not
|
202
|
+
signed it. However, nothing else grants you permission to modify or
|
203
|
+
distribute the Program or its derivative works. These actions are
|
204
|
+
prohibited by law if you do not accept this License. Therefore, by
|
205
|
+
modifying or distributing the Program (or any work based on the
|
206
|
+
Program), you indicate your acceptance of this License to do so, and
|
207
|
+
all its terms and conditions for copying, distributing or modifying
|
208
|
+
the Program or works based on it.
|
209
|
+
|
210
|
+
6. Each time you redistribute the Program (or any work based on the
|
211
|
+
Program), the recipient automatically receives a license from the
|
212
|
+
original licensor to copy, distribute or modify the Program subject to
|
213
|
+
these terms and conditions. You may not impose any further
|
214
|
+
restrictions on the recipients' exercise of the rights granted herein.
|
215
|
+
You are not responsible for enforcing compliance by third parties to
|
216
|
+
this License.
|
217
|
+
|
218
|
+
7. If, as a consequence of a court judgment or allegation of patent
|
219
|
+
infringement or for any other reason (not limited to patent issues),
|
220
|
+
conditions are imposed on you (whether by court order, agreement or
|
221
|
+
otherwise) that contradict the conditions of this License, they do not
|
222
|
+
excuse you from the conditions of this License. If you cannot
|
223
|
+
distribute so as to satisfy simultaneously your obligations under this
|
224
|
+
License and any other pertinent obligations, then as a consequence you
|
225
|
+
may not distribute the Program at all. For example, if a patent
|
226
|
+
license would not permit royalty-free redistribution of the Program by
|
227
|
+
all those who receive copies directly or indirectly through you, then
|
228
|
+
the only way you could satisfy both it and this License would be to
|
229
|
+
refrain entirely from distribution of the Program.
|
230
|
+
|
231
|
+
If any portion of this section is held invalid or unenforceable under
|
232
|
+
any particular circumstance, the balance of the section is intended to
|
233
|
+
apply and the section as a whole is intended to apply in other
|
234
|
+
circumstances.
|
235
|
+
|
236
|
+
It is not the purpose of this section to induce you to infringe any
|
237
|
+
patents or other property right claims or to contest validity of any
|
238
|
+
such claims; this section has the sole purpose of protecting the
|
239
|
+
integrity of the free software distribution system, which is
|
240
|
+
implemented by public license practices. Many people have made
|
241
|
+
generous contributions to the wide range of software distributed
|
242
|
+
through that system in reliance on consistent application of that
|
243
|
+
system; it is up to the author/donor to decide if he or she is willing
|
244
|
+
to distribute software through any other system and a licensee cannot
|
245
|
+
impose that choice.
|
246
|
+
|
247
|
+
This section is intended to make thoroughly clear what is believed to
|
248
|
+
be a consequence of the rest of this License.
|
249
|
+
|
250
|
+
8. If the distribution and/or use of the Program is restricted in
|
251
|
+
certain countries either by patents or by copyrighted interfaces, the
|
252
|
+
original copyright holder who places the Program under this License
|
253
|
+
may add an explicit geographical distribution limitation excluding
|
254
|
+
those countries, so that distribution is permitted only in or among
|
255
|
+
countries not thus excluded. In such case, this License incorporates
|
256
|
+
the limitation as if written in the body of this License.
|
257
|
+
|
258
|
+
9. The Free Software Foundation may publish revised and/or new versions
|
259
|
+
of the General Public License from time to time. Such new versions will
|
260
|
+
be similar in spirit to the present version, but may differ in detail to
|
261
|
+
address new problems or concerns.
|
262
|
+
|
263
|
+
Each version is given a distinguishing version number. If the Program
|
264
|
+
specifies a version number of this License which applies to it and "any
|
265
|
+
later version", you have the option of following the terms and conditions
|
266
|
+
either of that version or of any later version published by the Free
|
267
|
+
Software Foundation. If the Program does not specify a version number of
|
268
|
+
this License, you may choose any version ever published by the Free Software
|
269
|
+
Foundation.
|
270
|
+
|
271
|
+
10. If you wish to incorporate parts of the Program into other free
|
272
|
+
programs whose distribution conditions are different, write to the author
|
273
|
+
to ask for permission. For software which is copyrighted by the Free
|
274
|
+
Software Foundation, write to the Free Software Foundation; we sometimes
|
275
|
+
make exceptions for this. Our decision will be guided by the two goals
|
276
|
+
of preserving the free status of all derivatives of our free software and
|
277
|
+
of promoting the sharing and reuse of software generally.
|
278
|
+
|
279
|
+
NO WARRANTY
|
280
|
+
|
281
|
+
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
|
282
|
+
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
|
283
|
+
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
|
284
|
+
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
|
285
|
+
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
|
286
|
+
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
|
287
|
+
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
|
288
|
+
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
|
289
|
+
REPAIR OR CORRECTION.
|
290
|
+
|
291
|
+
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
292
|
+
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
|
293
|
+
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
|
294
|
+
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
|
295
|
+
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
|
296
|
+
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
|
297
|
+
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
|
298
|
+
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
|
299
|
+
POSSIBILITY OF SUCH DAMAGES.
|
300
|
+
|
301
|
+
END OF TERMS AND CONDITIONS
|
302
|
+
|
303
|
+
How to Apply These Terms to Your New Programs
|
304
|
+
|
305
|
+
If you develop a new program, and you want it to be of the greatest
|
306
|
+
possible use to the public, the best way to achieve this is to make it
|
307
|
+
free software which everyone can redistribute and change under these terms.
|
308
|
+
|
309
|
+
To do so, attach the following notices to the program. It is safest
|
310
|
+
to attach them to the start of each source file to most effectively
|
311
|
+
convey the exclusion of warranty; and each file should have at least
|
312
|
+
the "copyright" line and a pointer to where the full notice is found.
|
313
|
+
|
314
|
+
<one line to give the program's name and a brief idea of what it does.>
|
315
|
+
Copyright (C) <year> <name of author>
|
316
|
+
|
317
|
+
This program is free software; you can redistribute it and/or modify
|
318
|
+
it under the terms of the GNU General Public License as published by
|
319
|
+
the Free Software Foundation; either version 2 of the License, or
|
320
|
+
(at your option) any later version.
|
321
|
+
|
322
|
+
This program is distributed in the hope that it will be useful,
|
323
|
+
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
324
|
+
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
325
|
+
GNU General Public License for more details.
|
326
|
+
|
327
|
+
You should have received a copy of the GNU General Public License along
|
328
|
+
with this program; if not, write to the Free Software Foundation, Inc.,
|
329
|
+
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
|
330
|
+
|
331
|
+
Also add information on how to contact you by electronic and paper mail.
|
332
|
+
|
333
|
+
If the program is interactive, make it output a short notice like this
|
334
|
+
when it starts in an interactive mode:
|
335
|
+
|
336
|
+
Gnomovision version 69, Copyright (C) year name of author
|
337
|
+
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
|
338
|
+
This is free software, and you are welcome to redistribute it
|
339
|
+
under certain conditions; type `show c' for details.
|
340
|
+
|
341
|
+
The hypothetical commands `show w' and `show c' should show the appropriate
|
342
|
+
parts of the General Public License. Of course, the commands you use may
|
343
|
+
be called something other than `show w' and `show c'; they could even be
|
344
|
+
mouse-clicks or menu items--whatever suits your program.
|
345
|
+
|
346
|
+
You should also get your employer (if you work as a programmer) or your
|
347
|
+
school, if any, to sign a "copyright disclaimer" for the program, if
|
348
|
+
necessary. Here is a sample; alter the names:
|
349
|
+
|
350
|
+
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
|
351
|
+
`Gnomovision' (which makes passes at compilers) written by James Hacker.
|
352
|
+
|
353
|
+
<signature of Ty Coon>, 1 April 1989
|
354
|
+
Ty Coon, President of Vice
|
355
|
+
|
356
|
+
This General Public License does not permit incorporating your program into
|
357
|
+
proprietary programs. If your program is a subroutine library, you may
|
358
|
+
consider it more useful to permit linking proprietary applications with the
|
359
|
+
library. If this is what you want to do, use the GNU Lesser General
|
360
|
+
Public License instead of this License.
|