Skip to content

Commit 6227b51

Browse files
committed
Document unsupported proto extensions
1 parent 9d57e97 commit 6227b51

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

README.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -142,6 +142,14 @@ string should be UTF-8, however only "proto3" enforces that. So if fuzzer is
142142
applied to "proto2" type libprotobuf-mutator will generate any strings including
143143
invalid UTF-8. If it's a "proto3" message type, only valid UTF-8 will be used.
144144

145+
## Extensions
146+
Currently the library does not mutate
147+
[extensions](https://developers.google.com/protocol-buffers/docs/proto#extensions).
148+
This can be a problem if extension contains required fields so the library will not
149+
be able to change the message into valid initialized state.
150+
You can use [post processing hooks](#mutation-post-processing-experimental) to
151+
cleanup/initialize the message as workaround.
152+
145153
## Users of the library
146154
* [Chromium](https://cs.chromium.org/search/?q=DEFINE_.*._PROTO_FUZZER%5C\()
147155
* [Envoy](https://github.com/envoyproxy/envoy/search?q=DEFINE_TEXT_PROTO_FUZZER+OR+DEFINE_PROTO_FUZZER+OR+DEFINE_BINARY_PROTO_FUZZER&unscoped_q=DEFINE_TEXT_PROTO_FUZZER+OR+DEFINE_PROTO_FUZZER+OR+DEFINE_BINARY_PROTO_FUZZER&type=Code)

0 commit comments

Comments
 (0)