Skip to content

Commit d4944bf

Browse files
authored
[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
1 parent 1b1719a commit d4944bf

File tree

5 files changed

+27
-4
lines changed

5 files changed

+27
-4
lines changed

docs/guides/BUILDING.md

+5-1
Original file line numberDiff line numberDiff line change
@@ -401,7 +401,11 @@ Tests will be located in:
401401
`chip_pw_fuzztest` is the name of the toolchain used.
402402
403403
- Details on How To Run Fuzz Tests in
404-
[Running FuzzTests](https://github.com/project-chip/connectedhomeip/blob/master/docs/testing/fuzz_testing.md)
404+
[Running FuzzTests](https://github.com/project-chip/connectedhomeip/blob/master/docs/testing/fuzz_testing.md#running-fuzztests)
405+
406+
FAQ: In the event of a build failure related to missing files or dependencies
407+
for pw_fuzzer, check the
408+
[FuzzTest FAQ](https://github.com/project-chip/connectedhomeip/blob/master/docs/testing/fuzz_testing.md#FAQ)
405409
406410
## Build custom configuration
407411

docs/testing/fuzz_testing.md

+19
Original file line numberDiff line numberDiff line change
@@ -256,6 +256,25 @@ $ ./fuzz-chip-cert-pw --fuzz=ChipCert.DecodeChipCertFuzzer
256256

257257
```
258258

259+
### FAQ
260+
261+
#### What revision should the FuzzTest and Abseil submodules be for running `pw_fuzzer` with FuzzTest?
262+
263+
- Google FuzzTest is integrated into Matter using `pw_fuzzer`, which has
264+
several dependencies. These dependencies are listed here:
265+
[Step 0: Set up FuzzTest for your project](https://pigweed.dev/pw_fuzzer/guides/fuzztest.html#step-0-set-up-fuzztest-for-your-project).
266+
- Matter integrates these dependencies as submodules, including Google
267+
FuzzTest and Abseil.
268+
- Since FuzzTest and Abseil only support the `bazel` and `CMake` build systems
269+
and do not support GN, Pigweed maintainers use a script to generate GN files
270+
for these dependencies.
271+
- the revision of FuzzTest and Abseil submodules in Matter should match or at
272+
least be as new as the specific version (SHA1) used when generating these GN
273+
files.
274+
- You can find the version used for the generated GN files here:
275+
[FuzzTest Version](https://pigweed.dev/third_party/fuzztest/#version) and
276+
[Abseil Version](https://pigweed.dev/third_party/abseil-cpp/#version).
277+
259278
#### TO ADD:
260279

261280
- More Information on Test Fixtures (After issues are resolved)

third_party/abseil-cpp/src

Submodule src updated 339 files

third_party/fuzztest

Submodule fuzztest updated 283 files

0 commit comments

Comments
 (0)