Read-only gsubtree of platform2/system_api/ code

Clone this repo:
  1. a20288c spaced: Update spaced with the following two IPC endpoints: by Suresh Warrier · 12 days ago main
  2. e7dd9c3 system_api: Add IfChange lint to the VM proto. by Junichi Uekawa · 3 weeks ago
  3. 0bb4ee8 update_engine: Deprecate ApplyDeferredUpdate by Divya Chauhan · 4 weeks ago
  4. fe88d94 system_api: Add USB Limit signal definition to dbus constants by Jameson Thies · 4 weeks ago
  5. 6ed1107 vm_tools: concierge: add xattr-based vm type identification for disk images by maciek swiech · 6 weeks ago

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.