Google Git
Sign in
cos / mirrors / cros / chromiumos / platform2 / refs/heads/release-R107-15117.B / . / missive
tree: 04e94df7a520f60bd6c91ed805ec0b1609c66f79 [path history] [tgz]
  1. analytics/
  2. client/
  3. compression/
  4. daemon/
  5. dbus/
  6. encryption/
  7. init/
  8. missive/
  9. proto/
  10. resources/
  11. scheduler/
  12. storage/
  13. tmpfiles.d/
  14. util/
  15. BUILD.gn
  16. main.cc
  17. OWNERS
  18. README.md
missive/README.md

Missive Daemon

The Missive Daemon is part of the Encrypted Reporting Pipeline (ERP). It encrypts, stores, and forwards reporting records enqueued on its DBus interface. The interface allows other CrOS daemons and Chrome to enqueue records which are then encrypted and stored on disk. Records are enqueued in different priority queues, which have different upload periods. Once the storage daemon determines that a queue is ready for upload (i.e. the requisite period has elapsed), it sends records to Chrome to be uploaded to the Reporting Server. On successful upload, records are deleted from disk.

Note: This is a complementary daemon to the //chrome/browser/policy/messaging_layer package in chromium.

Build and Deploy

# HOST (inside chroot)
~$ cros-workon-${BOARD} start missive
~$ emerge-${BOARD} missive
~$ cros deploy ssh://localhost:9222 missive

# DUT
~# start missived

To build the package that works with a non-debug image, such as one from GoldenEye, the debug feature must be disabled:

# HOST (inside chroot)
~$ USE=-cros-debug emerge-${BOARD} missive

If there are errors on conflicting USE flags, rebuild the dependencies with

# HOST (inside chroot)
~$ build_packages --board=${BOARD} --no-withdebug

For convenience, if you always work with a non-debug image, consider disabling debug builds by default by adding USE="${USE} -cros-debug" to /etc/make.conf.user (inside chroot).

Original design docs

Note that aspects of the design may have evolved since the original design docs were written.

Updating From Chromium

General Guidelines

The code in the following folders originally comes from chromium://components/reporting:

  • compression
  • encryption
  • proto
  • storage
  • util

When importing updates from the chromium code you will encounter the following issues:

  1. #include statements in chromium for //base need to be converted as follows: #include “base/example.h” -> #include <base/example.h>
  2. Protobuf include directory can be converted from chromium as follows: “third_party/protobuf/src/google/protobuf/...” -> <google/protobuf/...>
  3. ChromeOS doesn‘t need to worry about worrying on multiple operating systems, so doesn’t require FILE_PATH_LITERAL, base::FilePath::CharType, or base::FilePath::StringType. It can be assumed that these are simple char or std::strings.
  4. base::DoNothing() comes from <base/bind_helpers.h> rather than “base/callback_helpers.h”

Specific Files