From 7b957ac059c07cf4e9d4bb3803be9c32b13863b5 Mon Sep 17 00:00:00 2001 From: "Scott R. Shinn" Date: Wed, 5 Aug 2026 16:24:57 -0400 Subject: [PATCH] Document optional PCRE2 JIT and macOS default. Note that matching falls back when JIT is unavailable and that Darwin builds default USE_PCRE2_JIT=no (#2040). --- docs/manual/installation/installation-requirements.rst | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/manual/installation/installation-requirements.rst b/docs/manual/installation/installation-requirements.rst index 50e33641..1582f554 100644 --- a/docs/manual/installation/installation-requirements.rst +++ b/docs/manual/installation/installation-requirements.rst @@ -44,6 +44,15 @@ To use the system's PCRE2, set the `PCRE2_SYSTEM` variable to yes: # cd ossec-hids-* # PCRE2_SYSTEM=yes ./install.sh +PCRE2 JIT (``USE_PCRE2_JIT``) is an optional speedup. Matching always goes +through ``pcre2_match``, which uses JIT when it is available and otherwise +falls back to interpreted matching. Builds no longer treat a JIT compile +failure as a fatal ``decoder.xml`` error (macOS and some system packages +often ship libpcre2 without usable JIT). macOS defaults to +``USE_PCRE2_JIT=no``. To force a non-JIT build explicitly:: + + # USE_PCRE2_JIT=no ./install.sh + zlib ----