Skip to main content

A modified version of mrab-regex with added cpytraceafl instrumentation

Project description


This is a thinly modified version of Matthew Barnett's mrab-regex regular expression library with added instrumentation for use when fuzzing python code with cpytraceafl.

The intention is for fuzzing harnesses to be able to substitute the builtin re module library with this, highly compatible, module and thereby allow AFL to generate examples which pass regular expressions used in the target or explore their limits in interesting ways.

See the original README.mrab-regex.rst for more general information in this library's extended regex features.

Recommended usage

Early in the startup of the fuzzing harness, (though after the call to install_rewriter()):

import regex
from sys import modules
modules["re"] = regex

code later importing/referencing the re module should instead be using this instrumented regex code. Note that before evaluating any regexes, cpytraceafl.tracehook.set_map_start() will need to have been initialized with a memory region to write its intrumentation data into. Otherwise you'll get segfaults.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

cpytraceafl-regex-0.2.0.tar.gz (679.0 kB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page