[pw_fuzzer] rebasing submodules to correct version + doc update (#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
project-chip · 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
+13 −13		BUILD.bazel
+1 −1		CMakeLists.txt
+15 −9		MODULE.bazel
+5 −9		README.md
+36 −3		WORKSPACE
+6 −1		ci/windows-presubmit.bat
+1 −1		docs/advanced.md
+23 −30		docs/quickstart-bazel.md
+53 −14		googlemock/include/gmock/gmock-actions.h
+65 −30		googlemock/include/gmock/gmock-matchers.h
+4 −3		googlemock/include/gmock/gmock-more-actions.h
+4 −6		googlemock/include/gmock/gmock-spec-builders.h
+1 −0		googlemock/include/gmock/internal/gmock-port.h
+4 −4		googlemock/src/gmock-cardinalities.cc
+52 −4		googlemock/test/gmock-actions_test.cc
+27 −27		googlemock/test/gmock-matchers-arithmetic_test.cc
+5 −2		googlemock/test/gmock-matchers-comparisons_test.cc
+15 −8		googlemock/test/gmock-matchers-containers_test.cc
+6 −6		googlemock/test/gmock-matchers-misc_test.cc
+1 −1		googlemock/test/gmock-pp_test.cc
+1 −1		googlemock/test/gmock_link_test.h
+1 −1		googletest/README.md
+3 −3		googletest/include/gtest/internal/gtest-type-util.h
+5 −2		googletest/src/gtest.cc
+10 −10		googletest_deps.bzl