system_api: Add protobuf definition for the diagnostics tool

This is required to pass diagnostics result as a protobuf via debugd.

BUG=chromium:463098734
TEST=manual

Change-Id: I2c2ce833e9828eb6a37d1144057b6512fccb06d3
Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/platform2/+/7198039
Reviewed-by: Andreea Costinas <[email protected]>
Commit-Queue: Sergey Poromov <[email protected]>
Reviewed-by: Hidehiko Abe <[email protected]>
Tested-by: Sergey Poromov <[email protected]>
NOKEYCHECK=True
GitOrigin-RevId: 565d1fb37f0156db38fe18e953818f89a125b01a
3 files changed
tree: ac6ba1ce7b7464ac646d6d70b90f760f1a8b4f00
  1. constants/
  2. dbus/
  3. mojo/
  4. non_standard_ipc/
  5. proto/
  6. src/
  7. switches/
  8. .gitignore
  9. BUILD.gn
  10. build.rs
  11. Cargo.toml
  12. DIR_METADATA
  13. LICENSE
  14. OWNERS
  15. README.md
  16. system_api.pc
README.md

This directory (platform2/system_api) contains constants and definitions like D-Bus service names that are shared between Chromium and Chromium OS.

This directory is only for things like headers and .proto files. No implementation should be added.

When writting a .proto file make sure to use:

option optimize_for = LITE_RUNTIME;

This will force usage of a lite protobuf instead of a full/heavy weight protobuf. The browser only links against the light version, so you will get cryptic link errors about missing parts of Message if you define a protobuf here and then try to use it in Chrome. Currently CrOS links against the full protobuffer library, but that might change in the future.

When declaring a protobuf, avoid use of required unless it is exactly what you mean. “Required is Forever” and very rarely should actually be used. Consult Protocol Buffer Basics: C++ for a detailed of this issue.