Google Git
Sign in
chromium / chromiumos / platform / pinweaver / c2343a346dc61564f56626ac7c0bf7e6c4e70d4c
commitc2343a346dc61564f56626ac7c0bf7e6c4e70d4c[log] [tgz]
authorAndrey Pronin <apronin@google.com>Sat May 15 11:17:06 2021
committerAndrey Pronin <apronin@chromium.org>Sat May 15 11:26:07 2021
treedd3efa5a3981163225caa97b5fa1352c4142fa9c
parent13639b98b06e7bf978eb2b142514d34bb88dde1e [diff]
eal: unify header comments

This CL unifies comments in various eal headers and describes return
values.

BUG=b:184977082
TEST=build

Change-Id: I5581acfe68942557963dd1b6907f606550c7c8a0
Reviewed-on: https://chromium-review.googlesource.com/c/chromiumos/platform/pinweaver/+/2898856
Reviewed-by: Andrey Pronin <apronin@chromium.org>
Tested-by: Andrey Pronin <apronin@chromium.org>
3 files changed
tree: dd3efa5a3981163225caa97b5fa1352c4142fa9c
  1. eal/
  2. pinweaver.c
  3. pinweaver.h
  4. pinweaver_eal.h
  5. pinweaver_types.h
  6. README.md
README.md

Common PinWeaver Code

This directory contains reference PinWeaver code that can be used across implementation platforms.

It consists of:

  • PinWeaver reference code:
    • pinweaver.h - PinWeaver embedded API definition
    • pinweaver.c - implementation
    • pinweaver_eal.h - API for Environment Abstraction Layer (EAL) used by PinWeaver
      • note that some types used in this API are platform-specific and are defined in eal/**/pinweaver_eal_types.h
    • pinweaver_types.h - header that is shared by PinWeaver implementation and PinWeaver clients that call it through platform-specific interface.
  • Environment Abstraction Layer (EAL) implementations - in eal/ folder
    • eal/cr50 - implementation for cr50
      • pinweaver_eal_types.h - cr50-specific EAL API types
      • pinweaver_eal.c - cr50 implementation of EAL
    • eal/tpm_storage - implementation for platforms that use TPM as PinWeaver data storage
      • pinweaver_eal_types.h - TPM-storage-specific EAL API types
      • pinweaver_eal_tpm.h - additional EAL functions required by TPM storage
      • pinweaver_eal_linux.c - implementation of non-storage EAL methods for Linux case
      • tpm_storage_stubs.c - empty implementation of storage EAL methods
      • tpm_storage.c - implementation of storage EAL methods on top of TSS
      • mini_trunks/ - mini-TSS (TPM client software stack) used by TPM storage implementation
        • created from trunks TSS used by ChromeOS reduced to the minimal required set of TPM commands and ported from C++ to C
        • relies on pinweaver_eal.h + pinweaver_eal_tpm.h EAL methods
        • TSS API is defined in tss.h + *authorization_delegate.h

A platform implementation that uses TPM storage EAL option needs to implement all EAL methods implemented in pinweaver_eal_linux.c (or use it as-is, if Linux compatible).