From fc259ed41858116de728b154bad3885c3cf55ecf Mon Sep 17 00:00:00 2001 From: Matt Schwager Date: Fri, 16 Feb 2024 15:05:03 -0700 Subject: [PATCH] Some minor verbiage improvements --- README.md | 16 +++++++++------- lib/ruzzy.rb | 2 +- 2 files changed, 10 insertions(+), 8 deletions(-) diff --git a/README.md b/README.md index d89a5d2..c7fdd28 100644 --- a/README.md +++ b/README.md @@ -86,20 +86,22 @@ INFO: Seed: 2527961537 ... SUMMARY: AddressSanitizer: stack-use-after-return /var/lib/gems/3.1.0/gems/ruzzy-0.5.0/ext/dummy/dummy.c:18:24 in _c_dummy_test_one_input ... -==3==ABORTING -MS: 1 InsertByte-; base unit: 253420c1158bc6382093d409ce2e9cff5806e980 -0x48,0x49,0x28, -HI( -artifact_prefix='./'; Test unit written to ./crash-7099f1508d4048cfe74226869805efa3db24b165 -Base64: SEko +==1541==ABORTING +MS: 2 ChangeByte-CrossOver-; base unit: b408860bc2c0584b8e0bb6fa3443005a3ef39854 +0x48,0x49, +HI +artifact_prefix='./'; Test unit written to ./crash-253420c1158bc6382093d409ce2e9cff5806e980 +Base64: SEk= ``` +We can see that it correctly found the input (`"HI"`) that produced a memory violation. For more information, see [`dummy.c`](https://github.com/trailofbits/ruzzy/blob/main/ext/dummy/dummy.c) to see why this violation occurred. + You can re-run the crash case with the following command: ```bash LD_PRELOAD=$(ruby -e 'require "ruzzy"; print Ruzzy::ASAN_PATH') \ ruby -e 'require "ruzzy"; Ruzzy.dummy' \ - ./crash-7099f1508d4048cfe74226869805efa3db24b165 + ./crash-253420c1158bc6382093d409ce2e9cff5806e980 ``` The following sanitizers are available: diff --git a/lib/ruzzy.rb b/lib/ruzzy.rb index 6afe202..0d9af68 100644 --- a/lib/ruzzy.rb +++ b/lib/ruzzy.rb @@ -2,7 +2,7 @@ require 'pathname' -# A Ruby C extension fuzzer +# A coverage-guided fuzzer for both pure Ruby code and Ruby C extensions module Ruzzy require 'cruzzy/cruzzy'