[pw_fuzzer] rebasing submodules to correct version + doc update (proj…

…ect-chip#35799) * update submodules required for fuzztest * Doc: Clarifying issue related to submodule version of fuzztest and abseil * Doc: Clarifying issue related to submodule version of fuzztest and abseil * fix documentation build error
Sarthak-Shaha · Sep 27, 2024 · d4944bf · d4944bf
1 parent 1b1719a
commit d4944bf
Show file tree

Hide file tree

Showing 5 changed files with 27 additions and 4 deletions.
diff --git a/docs/guides/BUILDING.md b/docs/guides/BUILDING.md
@@ -401,7 +401,11 @@ Tests will be located in:
 `chip_pw_fuzztest` is the name of the toolchain used.
 
 -   Details on How To Run Fuzz Tests in
-    [Running FuzzTests](https://github.com/project-chip/connectedhomeip/blob/master/docs/testing/fuzz_testing.md)
+    [Running FuzzTests](https://github.com/project-chip/connectedhomeip/blob/master/docs/testing/fuzz_testing.md#running-fuzztests)
+
+FAQ: In the event of a build failure related to missing files or dependencies
+for pw_fuzzer, check the
+[FuzzTest FAQ](https://github.com/project-chip/connectedhomeip/blob/master/docs/testing/fuzz_testing.md#FAQ)
 
 ## Build custom configuration
 

diff --git a/docs/testing/fuzz_testing.md b/docs/testing/fuzz_testing.md
@@ -256,6 +256,25 @@ $ ./fuzz-chip-cert-pw --fuzz=ChipCert.DecodeChipCertFuzzer
 
 ```
 
+### FAQ
+
+#### What revision should the FuzzTest and Abseil submodules be for running `pw_fuzzer` with FuzzTest?
+
+-   Google FuzzTest is integrated into Matter using `pw_fuzzer`, which has
+    several dependencies. These dependencies are listed here:
+    [Step 0: Set up FuzzTest for your project](https://pigweed.dev/pw_fuzzer/guides/fuzztest.html#step-0-set-up-fuzztest-for-your-project).
+-   Matter integrates these dependencies as submodules, including Google
+    FuzzTest and Abseil.
+-   Since FuzzTest and Abseil only support the `bazel` and `CMake` build systems
+    and do not support GN, Pigweed maintainers use a script to generate GN files
+    for these dependencies.
+-   the revision of FuzzTest and Abseil submodules in Matter should match or at
+    least be as new as the specific version (SHA1) used when generating these GN
+    files.
+-   You can find the version used for the generated GN files here:
+    [FuzzTest Version](https://pigweed.dev/third_party/fuzztest/#version) and
+    [Abseil Version](https://pigweed.dev/third_party/abseil-cpp/#version).
+
 #### TO ADD:
 
 -   More Information on Test Fixtures (After issues are resolved)

diff --git a/third_party/abseil-cpp/src b/third_party/abseil-cpp/src
diff --git a/third_party/fuzztest b/third_party/fuzztest
diff --git a/third_party/googletest b/third_party/googletest