GIT repo for v14: https://github.com/lcp/grub2/tree/tpm2-unlock-v14

This patch series is based on "Automatic TPM Disk Unlock"(*1) posted by
Hernan Gatta to introduce the key protector framework and TPM2 stack
to GRUB2, and this could be a useful feature for the systems to
implement full disk encryption.

To support TPM 2.0 Key File format(*2), patch 1~5,7 are grabbed from
Daniel Axtens's "appended signature secure boot support" (*3) to import
libtasn1 into grub2. Besides, the libtasn1 version is upgraded to
4.19.0 instead of 4.16.0 in the original patch.

Patch 6 fixes a potential buffer overrun in libtasn1.
(https://gitlab.com/gnutls/libtasn1/-/issues/49)

Patch 8 adds the document for libtasn1 and the steps to upgrade the
library.

Patch 9~13 are Hernan Gatta's patches with the follow-up fixes and
improvements:
- Converting 8 spaces into 1 tab
- Merging the minor build fix from Michael Chang
  - Replacing "lu" with "PRIuGRUB_SIZE" for grub_dprintf
  - Adding "enable = efi" to the tpm2 module in grub-core/Makefile.core.def
- Rebasing "cryptodisk: Support key protectors" to the git master
- Removing the measurement on the sealed key
  - Based on the patch from Olaf Kirch <o...@suse.com>
- Adjusting the input parameters of TPM2_EvictControl to match the order
  in "TCG TPM2 Part3 Commands"
- Declaring the input arguments of TPM2 functions as const
- Resending TPM2 commands on TPM_RC_RETRY
- Adding checks for the parameters of TPM2 commands
- Packing the missing authorization command for TPM2_PCR_Read
- Tweaking the TPM2 command functions to allow some parameters to be
  NULL so that we don't have to declare empty variables
- Only enabling grub-protect for "efi" since the TPM2 stack currently
  relies on the EFI TCG2 protocol to send TPM2 commands
- Using grub_cpu_to_be*() in the TPM2 stack instead of grub_swap_bytes*()
  which may cause problems in big-indian machines
- Changing the short name of "--protector" of "cryptomount" from "-k" to
  "-P" to avoid the conflict with "--key-file"
- Supporting TPM 2.0 Key File Format besides the raw sealed key
- Adding the external libtasn1 dependency to grub-protect to write the
  TPM 2.0 Key files
- Extending the TPM2 TSS stack to support authorized policy

Patch 14 implements the authorized policy support.

Patch 15 implements the missing NV index mode. (Thanks to Patrick Colp)

Patch 16 improves the 'cryptomount' command to fall back to the
passphrase mode when the key protector fails to unlock the encrypted
partition. (Another patch from Patrick Colp)

Patch 17 and 18 fix the potential security issues spotted by Fabian Vogt.

Patch 19 and 20 implement the TPM key unsealing testcases.

To utilize the TPM2 key protector to unlock the encrypted partition
(sdb1), here are the sample steps:

1. Add an extra random key for LUKS (luks-key)
   $ dd if=/dev/urandom of=luks-key bs=1 count=32
   $ sudo cryptsetup luksAddKey /dev/sdb1 luks-key --pbkdf=pbkdf2

2. Seal the key
   $ sudo grub-protect --action=add \
                       --protector=tpm2 \
                       --tpm2key \
                       --tpm2-keyfile=luks-key \
                       --tpm2-outfile=/boot/efi/boot/grub2/sealed.tpm

3. Unseal the key with the proper commands in grub.cfg:
   tpm2_key_protector_init --tpm2key=(hd0,gpt1)/boot/grub2/sealed.tpm
   cryptomount -u <SDB1_UUID> -P tpm2

(*1) https://lists.gnu.org/archive/html/grub-devel/2022-02/msg00006.html
(*2) https://www.hansenpartnership.com/draft-bottomley-tpm2-keys.html
(*3) https://lists.gnu.org/archive/html/grub-devel/2021-06/msg00044.html

v14:
- Addressing the libtasn1 patches more in the document
- Various improvements in tpm2_test
  - Verifying the test inside the LUKS device
  - Improving the return status checks and the waiting loop for swtpm
  - Fixing the portability issues
  - Making all variables braced
- Renaming grub-emu-opts to --emu-opts (grub-shell)

v13:
- https://lists.gnu.org/archive/html/grub-devel/2024-04/msg00155.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v13
- Fixing typos and a few multi-line comments
- Improving the conditional checks for the arguments of
  tpm2_key_protector_init 
- Updating to the latest TPM 2.0 Key File format
  - Adding the new optional fields: description and rsaParent
  - Handling "rsaParent == TRUE" when unsealing the tpm2key
  - Setting "rsaParent" to "TRUE" when sealing the key with RSA SRK
- Removing non-standard SRKs: RSA3072, RSA4096, ECC_NIST_P384,
  ECC_NIST_P521, and ECC_SM2_P256
- Adding more error messages to grub-protect
- Improving the error checking for the swtpm chardev instance
- Exiting the tpm2_test script if grub-protect failed to seal the key   

v12:
- https://lists.gnu.org/archive/html/grub-devel/2024-04/msg00108.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v12
- Fixing typos and indentation
- Removing the unused TPM commands: TPM2_HashSequenceStart,
  TPM2_SequenceUpdate, and TPM2_SequenceComplete,
- Following the TCG EK templates to set the parameters of SRK
- Removing ECC_BN_P256 and ECC_BN_P638 from the SRK algorithm list since
  those two algorithms are not mentioned in the TCG EK templates
- Updating the help messages of the tpm2 module and grub-protect
- Removing the unnecessary NULL checks
- Adding the manpage for grub-protect
- Replacing grub_crypto_hash() with TPM2_Hash() in grub-protect to
  support SHA384 PCR banks
- Using 'swtpm chardev' to start swtpm instead of 'swtpm_cuse' since
  some distros may not build swtpm with cuse
- Adding a new testcase without specifying the SRK type to test the
  default SRK settings
- Amending tpm2_test to remove the duplicate error checking code
- Silencing the tpm2-tools commands in tpm2_test
- Fixing the exit trap of tpm2_test to removing the working directory
  on success

v11:
- https://lists.gnu.org/archive/html/grub-devel/2024-04/msg00052.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v11
- Adding the missing default: handlers in grub-core/tpm2/mu.c
- Updating the help messages and commit messages to reflect the change
  of the default SRK algorithm (RSA2048 -> ECC_NIST_P256)
- Adding the testcase for the NV index mode

v10:
- https://lists.gnu.org/archive/html/grub-devel/2024-04/msg00019.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v10
- Fixing the coverity issues: CID 435775, CID 435771, CID 435770, CID
  435769, CID 435767, CID 435761
  https://lists.gnu.org/archive/html/grub-devel/2024-02/txtKIuUb5lf3O.txt
  - Fixing the potential memory leak (CID 435775)
  - Removing the unnecessary grub_protect_get_grub_drive_for_file() from
    util/grub-protect.c (CID 435771)
  - Using the grub_tpm2_mu_TPM2B_*_Unmarshal functions to unmarshal the
    TPM2B structs instead of a generic grub_tpm2_mu_TPM2B_Unmarshal
    (CID 435770)
  - Fixing Null pointer dereference (CID 435769)
  - Adding bound checks to grub_tpm2_mu_TPML_DIGEST_Unmarshal()
    (CID 435767)
  - Improving the check for the return value of ftell() (CID 435761)
- Adding a quick fix for CID 435762
- Removing the empty ending line in tests/asn1_test.in
- Fixing docs/grub-dev.texi and updating the libtasn1 patches in
  grub-core/lib/libtasn1-patches/
- Merging all the TPM2 TSS stack patches into one to reduce the total
  patch number
- Switching the default asymmetric algorithm from RSA2048 to
  TPM_ECC_NIST_P256 for the faster key generation
- Adding the fallback SRK templates to try a few more SRK types in case
  grub2 failed to associate the sealed key with the SRK in the persistent
  handle or the default SRK
- Improving the test script to add tests for the persistent handle and
  the fallback SRKs

v9:
- https://lists.gnu.org/archive/html/grub-devel/2024-02/msg00007.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v9
- Introducing c-ctype.h to posix_wrap and implementing strncat
- Adding the descriptive comments to the disabled code in libtasn1
- Replacing strcat with the bound-checked _asn1_str_cat in libtasn1 and
  including c-ctype.h directly
- Integrating the asn1 testcases into "functional_test"
- Updating the libtasn1 patches mentioned in the documentation 
- Moving the key protector to a module
- Amending configure.ac to enable/disable grub-protect
- Fixing an timeout issue in the tpm2_test script by feeding the config
  through stdin

v8:
- https://lists.gnu.org/archive/html/grub-devel/2024-01/msg00013.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v8
- Introducing TPM device support to grub-emu and adding the TPM key
  unsealing testcase

v7:
- https://lists.gnu.org/archive/html/grub-devel/2023-11/msg00127.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v7
- Stopping reading SRK from the well-known persistent handle (TPM2_SRK_HANDLE,
  i.e. 0x81000001) by default since the persistent handle may be created
  by other OS and causes unsealing failure due to SRK mismatching
  - The user now has to specify the persistent handle with "--srk"
    explicitly.
- Utilizing grub_error() to print more error messages 
- Unifying the format of the error messages from TPM2 commands

v6:
- https://lists.gnu.org/archive/html/grub-devel/2023-10/msg00026.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v6
- Supporting more SRK types than RSA2048 and ECC_NIST_P256
- Documenting SHA512 as the supported PCR bank type in the tpm2
  protector
- Removing the redundant error message for grub_tpm2_protector_srk_get()
  since it may overwrite the real error message.
- Updating the supported SRK types and PCR bank types in grub-protect 
- Removing the unused type: TPM2_ECC_CURVE

v5:
- https://lists.gnu.org/archive/html/grub-devel/2023-08/msg00113.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v5
- Rebasing to the latest git HEAD and improving the commit messages
- Implementing authorized poilcy support
- Implementing NV index mode
- Improving the 'cryptomount' command to fall back to the passphrase
  mode when the key protector fails to unlock the encrypted partition
- Fixing the potential security issues

v4:
- https://lists.gnu.org/archive/html/grub-devel/2023-04/msg00104.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v4
- Improving the error condition checks in cryptodisk.c
- Moving the code to unseal with the standalone policy sequence below
  the code for authpolicy sequence
  - The standalone policy sequence was mistakenly prepended to to the
    authpolicy sequence with grub_list_push() while it should be
    appended.
- Pushing the error messages from the authpolicy sequence into the
  grub_error stack so that we can list all errors from the sequence
- Improving the error messages in the TPM2 protector
- Amending the calculation of the max string lengths of 'Policy',
  'CommandCode' and 'CommandPolicy'
- Skipping the error path in grub_tpm2key_get_authpolicy_seq() on
  success to avoid freeing the authpolicy sequence

v3:
- https://lists.gnu.org/archive/html/grub-devel/2023-04/msg00055.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v3
- Adding the document for libtasn1
- Improving the error condition checks
  ex: "if (!ptr)" ==> "if (ptr == NULL)"
      "if (err)" ==> "if (err != GRUB_ERR_NONE)"
      "if (rc)" ==> "if (rc != TPM_RC_SUCCESS)"
- Supporting the "TPMPolicy" and "TPMAuthPolicy" sequence in the TPM 2.0
  key File
- Refactoring the key recover function to support "TPMPolicy" and
  "TPMAuthPolicy" sequence
- Using TPMS_PCR_SELECTION_SelectPCR() to set the PCR bit mask
  - Also dropping TPM2_PCR_TO_SELECT() and TPM2_PCR_TO_BIT() which are
    not necessary anymore
- Removing the redundant variable, 'crd', from
  grub_cryptodisk_scan_device_real()
- Fixing the spaces/tabs in cryptodisk.c
- Fixing the comment format in cryptodisk.h
- Adding the defensive check for "cargs->protectors" in
  grub_cryptodisk_scan_device()
- Improving 'grub-protect' for the better support of TPM 2.0 Key File
- Adding more comments

v2:
- https://lists.gnu.org/archive/html/grub-devel/2023-03/msg00094.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock-v2

v1:
- https://lists.gnu.org/archive/html/grub-devel/2023-02/msg00130.html
- GIT repo: https://github.com/lcp/grub2/tree/tpm2-unlock

Daniel Axtens (6):
  posix_wrap: tweaks in preparation for libtasn1
  libtasn1: import libtasn1-4.19.0
  libtasn1: disable code not needed in grub
  libtasn1: changes for grub compatibility
  libtasn1: compile into asn1 module
  asn1_test: test module for libtasn1

Gary Lin (7):
  libtasn1: fix the potential buffer overrun
  libtasn1: Add the documentation
  tpm2: Support authorized policy
  cryptodisk: wipe out the cached keys from protectors
  diskfilter: look up cryptodisk devices first
  tpm2: Enable tpm2 module for grub-emu
  tests: Add tpm2_test

Hernan Gatta (5):
  key_protector: Add key protectors framework
  tpm2: Add TPM Software Stack (TSS)
  key_protector: Add TPM2 Key Protector
  cryptodisk: Support key protectors
  util/grub-protect: Add new tool

Patrick Colp (2):
  tpm2: Implement NV index
  cryptodisk: Fallback to passphrase

 .gitignore                                    |    2 +
 Makefile.util.def                             |   37 +
 configure.ac                                  |   30 +
 docs/grub-dev.texi                            |   34 +
 docs/man/grub-protect.h2m                     |    4 +
 grub-core/Makefile.am                         |    1 +
 grub-core/Makefile.core.def                   |   48 +
 grub-core/disk/cryptodisk.c                   |  183 +-
 grub-core/disk/diskfilter.c                   |   35 +-
 grub-core/disk/key_protector.c                |   78 +
 grub-core/kern/emu/main.c                     |   11 +-
 grub-core/kern/emu/misc.c                     |   51 +
 ...asn1-disable-code-not-needed-in-grub.patch |  320 +++
 ...tasn1-changes-for-grub-compatibility.patch |  135 +
 ...sn1-fix-the-potential-buffer-overrun.patch |   35 +
 grub-core/lib/libtasn1/COPYING                |   16 +
 grub-core/lib/libtasn1/README.md              |   98 +
 grub-core/lib/libtasn1/lib/coding.c           | 1433 ++++++++++
 grub-core/lib/libtasn1/lib/decoding.c         | 2503 +++++++++++++++++
 grub-core/lib/libtasn1/lib/element.c          | 1109 ++++++++
 grub-core/lib/libtasn1/lib/element.h          |   42 +
 grub-core/lib/libtasn1/lib/errors.c           |  103 +
 grub-core/lib/libtasn1/lib/gstr.c             |   74 +
 grub-core/lib/libtasn1/lib/gstr.h             |   50 +
 grub-core/lib/libtasn1/lib/int.h              |  220 ++
 grub-core/lib/libtasn1/lib/parser_aux.c       | 1178 ++++++++
 grub-core/lib/libtasn1/lib/parser_aux.h       |  172 ++
 grub-core/lib/libtasn1/lib/structure.c        | 1227 ++++++++
 grub-core/lib/libtasn1/lib/structure.h        |   46 +
 grub-core/lib/libtasn1_wrap/wrap.c            |   26 +
 grub-core/lib/posix_wrap/c-ctype.h            |  114 +
 grub-core/lib/posix_wrap/limits.h             |    1 +
 grub-core/lib/posix_wrap/stdlib.h             |    8 +
 grub-core/lib/posix_wrap/string.h             |   21 +
 grub-core/lib/posix_wrap/sys/types.h          |    1 +
 .../tests/asn1/CVE-2018-1000654-1_asn1_tab.h  |   32 +
 .../tests/asn1/CVE-2018-1000654-2_asn1_tab.h  |   36 +
 grub-core/tests/asn1/CVE-2018-1000654.c       |   58 +
 grub-core/tests/asn1/Test_overflow.c          |  134 +
 grub-core/tests/asn1/Test_simple.c            |  205 ++
 grub-core/tests/asn1/Test_strings.c           |  142 +
 grub-core/tests/asn1/asn1_test.c              |   49 +
 grub-core/tests/asn1/asn1_test.h              |   44 +
 grub-core/tests/asn1/object-id-decoding.c     |  109 +
 grub-core/tests/asn1/object-id-encoding.c     |  114 +
 grub-core/tests/asn1/octet-string.c           |  199 ++
 grub-core/tests/asn1/reproducers.c            |   80 +
 grub-core/tests/lib/functional_test.c         |    1 +
 grub-core/tpm2/args.c                         |  140 +
 grub-core/tpm2/buffer.c                       |  145 +
 grub-core/tpm2/module.c                       | 1325 +++++++++
 grub-core/tpm2/mu.c                           | 1168 ++++++++
 grub-core/tpm2/tcg2-emu.c                     |   52 +
 grub-core/tpm2/tcg2.c                         |  143 +
 grub-core/tpm2/tpm2.c                         | 1048 +++++++
 grub-core/tpm2/tpm2key.asn                    |   33 +
 grub-core/tpm2/tpm2key.c                      |  476 ++++
 grub-core/tpm2/tpm2key_asn1_tab.c             |   45 +
 include/grub/cryptodisk.h                     |   16 +
 include/grub/emu/misc.h                       |    5 +
 include/grub/key_protector.h                  |   46 +
 include/grub/libtasn1.h                       |  657 +++++
 include/grub/tpm2/buffer.h                    |   65 +
 include/grub/tpm2/internal/args.h             |   49 +
 include/grub/tpm2/internal/functions.h        |  156 +
 include/grub/tpm2/internal/structs.h          |  768 +++++
 include/grub/tpm2/internal/types.h            |  403 +++
 include/grub/tpm2/mu.h                        |  396 +++
 include/grub/tpm2/tcg2.h                      |   34 +
 include/grub/tpm2/tpm2.h                      |   34 +
 include/grub/tpm2/tpm2key.h                   |   86 +
 tests/asn1_test.in                            |   11 +
 tests/tpm2_test.in                            |  306 ++
 tests/util/grub-shell.in                      |    6 +-
 util/grub-protect.c                           | 1420 ++++++++++
 75 files changed, 19639 insertions(+), 43 deletions(-)
 create mode 100644 docs/man/grub-protect.h2m
 create mode 100644 grub-core/disk/key_protector.c
 create mode 100644 
grub-core/lib/libtasn1-patches/0001-libtasn1-disable-code-not-needed-in-grub.patch
 create mode 100644 
grub-core/lib/libtasn1-patches/0002-libtasn1-changes-for-grub-compatibility.patch
 create mode 100644 
grub-core/lib/libtasn1-patches/0003-libtasn1-fix-the-potential-buffer-overrun.patch
 create mode 100644 grub-core/lib/libtasn1/COPYING
 create mode 100644 grub-core/lib/libtasn1/README.md
 create mode 100644 grub-core/lib/libtasn1/lib/coding.c
 create mode 100644 grub-core/lib/libtasn1/lib/decoding.c
 create mode 100644 grub-core/lib/libtasn1/lib/element.c
 create mode 100644 grub-core/lib/libtasn1/lib/element.h
 create mode 100644 grub-core/lib/libtasn1/lib/errors.c
 create mode 100644 grub-core/lib/libtasn1/lib/gstr.c
 create mode 100644 grub-core/lib/libtasn1/lib/gstr.h
 create mode 100644 grub-core/lib/libtasn1/lib/int.h
 create mode 100644 grub-core/lib/libtasn1/lib/parser_aux.c
 create mode 100644 grub-core/lib/libtasn1/lib/parser_aux.h
 create mode 100644 grub-core/lib/libtasn1/lib/structure.c
 create mode 100644 grub-core/lib/libtasn1/lib/structure.h
 create mode 100644 grub-core/lib/libtasn1_wrap/wrap.c
 create mode 100644 grub-core/lib/posix_wrap/c-ctype.h
 create mode 100644 grub-core/tests/asn1/CVE-2018-1000654-1_asn1_tab.h
 create mode 100644 grub-core/tests/asn1/CVE-2018-1000654-2_asn1_tab.h
 create mode 100644 grub-core/tests/asn1/CVE-2018-1000654.c
 create mode 100644 grub-core/tests/asn1/Test_overflow.c
 create mode 100644 grub-core/tests/asn1/Test_simple.c
 create mode 100644 grub-core/tests/asn1/Test_strings.c
 create mode 100644 grub-core/tests/asn1/asn1_test.c
 create mode 100644 grub-core/tests/asn1/asn1_test.h
 create mode 100644 grub-core/tests/asn1/object-id-decoding.c
 create mode 100644 grub-core/tests/asn1/object-id-encoding.c
 create mode 100644 grub-core/tests/asn1/octet-string.c
 create mode 100644 grub-core/tests/asn1/reproducers.c
 create mode 100644 grub-core/tpm2/args.c
 create mode 100644 grub-core/tpm2/buffer.c
 create mode 100644 grub-core/tpm2/module.c
 create mode 100644 grub-core/tpm2/mu.c
 create mode 100644 grub-core/tpm2/tcg2-emu.c
 create mode 100644 grub-core/tpm2/tcg2.c
 create mode 100644 grub-core/tpm2/tpm2.c
 create mode 100644 grub-core/tpm2/tpm2key.asn
 create mode 100644 grub-core/tpm2/tpm2key.c
 create mode 100644 grub-core/tpm2/tpm2key_asn1_tab.c
 create mode 100644 include/grub/key_protector.h
 create mode 100644 include/grub/libtasn1.h
 create mode 100644 include/grub/tpm2/buffer.h
 create mode 100644 include/grub/tpm2/internal/args.h
 create mode 100644 include/grub/tpm2/internal/functions.h
 create mode 100644 include/grub/tpm2/internal/structs.h
 create mode 100644 include/grub/tpm2/internal/types.h
 create mode 100644 include/grub/tpm2/mu.h
 create mode 100644 include/grub/tpm2/tcg2.h
 create mode 100644 include/grub/tpm2/tpm2.h
 create mode 100644 include/grub/tpm2/tpm2key.h
 create mode 100644 tests/asn1_test.in
 create mode 100644 tests/tpm2_test.in
 create mode 100644 util/grub-protect.c

Range-diff against v13:
 -:  --------- >  1:  c6a7b2a55 posix_wrap: tweaks in preparation for libtasn1
 -:  --------- >  2:  c2dfb28d9 libtasn1: import libtasn1-4.19.0
 -:  --------- >  3:  f5c15acce libtasn1: disable code not needed in grub
 1:  60cf41fa3 !  4:  30271d827 libtasn1: changes for grub compatibility
    @@ Commit message
         Cc: Vladimir Serbinenko <phco...@gmail.com>
         Signed-off-by: Daniel Axtens <d...@axtens.net>
         Signed-off-by: Gary Lin <g...@suse.com>
    +    Reviewed-by: Stefan Berger <stef...@linux.ibm.com>
     
      ## grub-core/lib/libtasn1/lib/decoding.c ##
     @@ grub-core/lib/libtasn1/lib/decoding.c: asn1_expand_octet_string 
(asn1_node_const definitions, asn1_node * element,
 2:  ce32406ca =  5:  9eb5bb4fc libtasn1: fix the potential buffer overrun
 3:  6410e21d8 =  6:  ef1e5cfe7 libtasn1: compile into asn1 module
 4:  a94e1b32c =  7:  f851596f8 asn1_test: test module for libtasn1
 5:  0e6041be0 !  8:  f04612ab5 libtasn1: Add the documentation
    @@ docs/grub-dev.texi: cp minilzo-2.10/*.[hc] grub-core/lib/minilzo
     +rm -rf libtasn1-4.19.0
     +@end example
     +
    -+After upgrading the library, it is necessary to apply the patches in
    ++After upgrading the library, it may be necessary to apply the patches in
     +@file{grub-core/lib/libtasn1-patches/} to adjust the code to be 
compatible with
    -+grub.
    ++grub. These patches were needed to use the current version of libtasn1. 
The
    ++existing patches may not apply cleanly, apply at all, or even be needed 
for a
    ++newer version of the library, and other patches maybe needed due to 
changes in
    ++the newer version. If existing patches need to be refreshed to apply 
cleanly,
    ++please include updated patches as part of the a patch set sent to the 
list.
    ++If new patches are needed or existing patches are not needed, also please 
send
    ++additions or removals as part of any patch set upgrading libtasn1.
     +
      @node Debugging
      @chapter Debugging
 6:  386e4c04b =  9:  e03991256 key_protector: Add key protectors framework
 7:  13117460e = 10:  f3368e733 tpm2: Add TPM Software Stack (TSS)
 8:  758d6ec5f = 11:  86495e70d key_protector: Add TPM2 Key Protector
 9:  e3354505d = 12:  3e5484cf0 cryptodisk: Support key protectors
10:  9d5da3317 = 13:  b7bd289b6 util/grub-protect: Add new tool
11:  3207f30a9 = 14:  7cb1d9740 tpm2: Support authorized policy
12:  5f22e6397 = 15:  d7b4b99a9 tpm2: Implement NV index
13:  64c386176 = 16:  d48b1ac29 cryptodisk: Fallback to passphrase
14:  c65391cc2 = 17:  0cfc6d2b7 cryptodisk: wipe out the cached keys from 
protectors
15:  d285e9dc1 = 18:  8c7507f0f diskfilter: look up cryptodisk devices first
16:  669b56fb3 = 19:  64f1a3e02 tpm2: Enable tpm2 module for grub-emu
17:  0a2d6d64c ! 20:  665ce495d tests: Add tpm2_test
    @@ Commit message
     
         Cc: Michael Chang <mch...@suse.com>
         Cc: Stefan Berger <stef...@linux.ibm.com>
    +    Cc: Glenn Washburn <developm...@efficientek.com>
         Signed-off-by: Gary Lin <g...@suse.com>
     
      ## Makefile.util.def ##
    @@ tests/tpm2_test.in (new)
     +
     +. "@builddir@/grub-core/modinfo.sh"
     +
    -+if [ x$grub_modinfo_platform != xemu ]; then
    ++if [ x${grub_modinfo_platform} != xemu ]; then
     +  exit 77
     +fi
     +
     +builddir="@builddir@"
     +
     +# Force build directory components
    -+PATH="${builddir}:$PATH"
    ++PATH="${builddir}:${PATH}"
     +export PATH
     +
    -+if [ "x$EUID" = "x" ] ; then
    ++if [ "x${EUID}" = "x" ] ; then
     +  EUID=`id -u`
     +fi
     +
    -+if [ "$EUID" != 0 ] ; then
    ++if [ "${EUID}" != 0 ] ; then
     +   echo "not root; cannot test tpm2."
     +   exit 99
     +fi
     +
    -+if ! which cryptsetup >/dev/null 2>&1; then
    ++if ! command -v cryptsetup >/dev/null 2>&1; then
     +   echo "cryptsetup not installed; cannot test tpm2."
     +   exit 99
     +fi
    @@ tests/tpm2_test.in (new)
     +   exit 99
     +fi
     +
    -+if ! which swtpm >/dev/null 2>&1; then
    ++if ! command -v swtpm >/dev/null 2>&1; then
     +   echo "swtpm not installed; cannot test tpm2."
     +   exit 99
     +fi
     +
    -+if ! which tpm2_startup >/dev/null 2>&1; then
    ++if ! command -v tpm2_startup >/dev/null 2>&1; then
     +   echo "tpm2-tools not installed; cannot test tpm2."
     +   exit 99
     +fi
     +
    -+tpm2testdir="`mktemp -d "${TMPDIR:-/tmp}/$(basename "$0").XXXXXXXXXX"`" 
|| exit 20
    ++tpm2testdir="`mktemp -d "${TMPDIR:-/tmp}/$(basename "$0").XXXXXXXXXX"`" 
|| exit 99
     +
     +disksize=20M
     +
    -+luksfile=$tpm2testdir/luks.disk
    ++luksfile=${tpm2testdir}/luks.disk
     +lukskeyfile=${tpm2testdir}/password.txt
     +
     +# Choose a low iteration number to reduce the time to decrypt the disk
    @@ tests/tpm2_test.in (new)
     +
     +timeout=20
     +
    -+testoutput=$tpm2testdir/testoutput
    ++testoutput=${tpm2testdir}/testoutput
     +
     +vtext="TEST VERIFIED"
     +
    ++ret=0
    ++
     +# Create the password file
     +echo -n "top secret" > ${lukskeyfile}
     +
    @@ tests/tpm2_test.in (new)
     +truncate -s ${disksize} ${luksfile} || exit 21
     +cryptsetup luksFormat -q ${csopt} ${luksfile} ${lukskeyfile} || exit 22
     +
    ++# Write vtext into the first block of the LUKS2 image
    ++luksdev=/dev/mapper/`basename ${tpm2testdir}`
    ++cryptsetup open --key-file ${lukskeyfile} ${luksfile} `basename 
${luksdev}` || exit 23
    ++echo "${vtext}" | dd of=${luksdev} conv=notrunc status=none
    ++cryptsetup close ${luksdev}
    ++
     +# Shutdown the swtpm instance on exit
     +cleanup() {
     +    RET=$?
    -+    if [ -e "$tpm2ctrl" ]; then
    -+        swtpm_ioctl -s --unix ${tpm2ctrl}
    ++    if [ -e "${tpm2ctrl}" ]; then
    ++  swtpm_ioctl -s --unix ${tpm2ctrl}
     +    fi
     +    if [ "${RET}" -eq 0 ]; then
    -+        rm -rf "$tpm2testdir" || :
    ++  rm -rf "$tpm2testdir" || :
     +    fi
     +}
     +trap cleanup EXIT INT TERM KILL QUIT
    @@ tests/tpm2_test.in (new)
     +# Create the swtpm chardev instance
     +swtpm chardev --vtpm-proxy --tpmstate dir=${tpm2statedir} \
     +  --tpm2 --ctrl type=unixio,path=${tpm2ctrl} \
    -+  --flags startup-clear --daemon > ${tpm2log}
    -+ret=$?
    -+if [ "$ret" -ne 0 ]; then
    -+    exit $ret
    ++  --flags startup-clear --daemon > ${tpm2log} || ret=$?
    ++if [ "${ret}" -ne 0 ]; then
    ++    echo "Failed to start swtpm chardev"
    ++    exit ${ret}
     +fi
     +
     +# Wait for tpm2 chardev
    -+wait=3
    -+while [ "${wait}" -gt 0 ]; do
    ++wait_count=3
    ++for count in `seq 1 ${wait_count}`; do
    ++    sleep 1
    ++
     +    tpm2dev=$(grep "New TPM device" ${tpm2log} | cut -d' ' -f 4)
    -+    if [ -n "${tpm2dev}" ] && [ -c "${tpm2dev}" ]; then
    -+        break
    ++    if [ -c "${tpm2dev}" ]; then
    ++  wait_count=0
    ++  break
     +    fi
    -+    sleep 1
    -+    ((wait--))
     +done
    -+if [ "$wait" -le 0 ]; then
    ++if [ "${wait_count}" -ne 0 ]; then
     +    echo "TPM device did not appear."
     +    exit QUIT
     +fi
    @@ tests/tpm2_test.in (new)
     +export TPM2TOOLS_TCTI="device:${tpm2dev}"
     +
     +# Extend PCR 0
    -+tpm2_pcrextend 0:sha256=$(sha256sum <<< "test0" | cut -d ' ' -f 1)
    -+ret=$?
    -+if [ "$ret" -ne 0 ]; then
    -+    exit $ret
    -+fi
    ++tpm2_pcrextend 0:sha256=$(echo "test0" | sha256sum | cut -d ' ' -f 1)
     +
     +# Extend PCR 1
    -+tpm2_pcrextend 1:sha256=$(sha256sum <<< "test1" | cut -d ' ' -f 1)
    -+ret=$?
    -+if [ "$ret" -ne 0 ]; then
    -+    exit $ret
    -+fi
    ++tpm2_pcrextend 1:sha256=$(echo "test1" | sha256sum | cut -d ' ' -f 1)
     +
     +tpm2_seal_unseal() {
    -+    local srk_alg="$1"
    -+    local handle_type="$2"
    -+    local srk_test="$3"
    ++    srk_alg="$1"
    ++    handle_type="$2"
    ++    srk_test="$3"
     +
    -+    local grub_srk_alg=${srk_alg}
    ++    grub_srk_alg=${srk_alg}
     +
    -+    local extra_opt=""
    -+    local extra_grub_opt=""
    ++    extra_opt=""
    ++    extra_grub_opt=""
     +
    -+    local persistent_handle="0x81000000"
    ++    persistent_handle="0x81000000"
     +
    -+    if [ "${handle_type}" == "persistent" ]; then
    ++    if [ "${handle_type}" = "persistent" ]; then
     +  extra_opt="--tpm2-srk=${persistent_handle}"
     +    fi
     +
    @@ tests/tpm2_test.in (new)
     +
     +    # Seal the password with grub-protect
     +    grub-protect ${extra_opt} \
    -+      --tpm2-device=${tpm2dev} \
    -+      --action=add \
    -+      --protector=tpm2 \
    -+      --tpm2key \
    -+      --tpm2-bank=sha256 \
    -+      --tpm2-pcrs=0,1 \
    -+      --tpm2-keyfile=${lukskeyfile} \
    -+      --tpm2-outfile=${sealedkey}
    -+    ret=$?
    -+    if [ "$ret" -ne 0 ]; then
    ++  --tpm2-device=${tpm2dev} \
    ++  --action=add \
    ++  --protector=tpm2 \
    ++  --tpm2key \
    ++  --tpm2-bank=sha256 \
    ++  --tpm2-pcrs=0,1 \
    ++  --tpm2-keyfile=${lukskeyfile} \
    ++  --tpm2-outfile=${sealedkey} || ret=$?
    ++    if [ "${ret}" -ne 0 ]; then
     +  echo "Failed to seal the secret key"
     +  exit 1
     +    fi
     +
     +    # Flip the asymmetric algorithm in grub.cfg to trigger fallback SRKs
    -+    if [ "${srk_test}" == "fallback_srk" ]; then
    -+        if [[ "${srk_alg}" == RSA* ]]; then
    -+            grub_srk_alg="ECC"
    -+        elif [[ "${srk_alg}" == ECC* ]]; then
    -+            grub_srk_alg="RSA"
    -+        fi
    ++    if [ "${srk_test}" = "fallback_srk" ]; then
    ++  if [ -z "${srk_alg##RSA*}" ]; then
    ++      grub_srk_alg="ECC"
    ++  elif [ -z "${srk_alg##ECC*}" ]; then
    ++      grub_srk_alg="RSA"
    ++  fi
     +    fi
     +
     +    if [ "${grub_srk_alg}" != "default" ] && [ "${handle_type}" != 
"persistent" ]; then
    @@ tests/tpm2_test.in (new)
     +loopback luks (host)${luksfile}
     +tpm2_key_protector_init -T (host)${sealedkey} ${extra_grub_opt}
     +if cryptomount -a --protector tpm2; then
    -+    echo "${vtext}"
    ++    cat (crypto0)+1
     +fi
     +EOF
     +
     +    # Test TPM unsealing with the same PCR
    -+    ${grubshell} --timeout=$timeout --grub-emu-opts="-t ${tpm2dev}" < 
${tpm2testdir}/testcase.cfg > ${testoutput}
    -+    ret=$?
    ++    ${grubshell} --timeout=${timeout} --emu-opts="-t ${tpm2dev}" < 
${tpm2testdir}/testcase.cfg > ${testoutput} || ret=$?
     +
     +    # Remove the persistent handle
    -+    if [ "${handle_type}" == "persistent" ]; then
    ++    if [ "${handle_type}" = "persistent" ]; then
     +  grub-protect \
     +          --tpm2-device=${tpm2dev} \
     +          --protector=tpm2 \
    @@ tests/tpm2_test.in (new)
     +          --tpm2-evict
     +    fi
     +
    -+    if [ "$ret" -eq 0 ]; then
    -+  if ! grep -q "^${vtext}$" "$testoutput"; then
    -+      echo "error: test not verified [`cat $testoutput`]" >&2
    ++    if [ "${ret}" -eq 0 ]; then
    ++  if ! grep -q "^${vtext}$" "${testoutput}"; then
    ++      echo "error: test not verified [`cat ${testoutput}`]" >&2
     +      exit 1
     +  fi
     +    else
    -+  echo "grub-emu exited with error: $ret" >&2
    -+  exit $ret
    ++  echo "grub-emu exited with error: ${ret}" >&2
    ++  exit ${ret}
     +    fi
     +}
     +
     +tpm2_seal_unseal_nv() {
    -+    local persistent_handle="0x81000000"
    -+    local primary_file=${tpm2testdir}/primary.ctx
    -+    local session_file=${tpm2testdir}/session.dat
    -+    local policy_file=${tpm2testdir}/policy.dat
    -+    local keypub_file=${tpm2testdir}/key.pub
    -+    local keypriv_file=${tpm2testdir}/key.priv
    -+    local name_file=${tpm2testdir}/sealing.name
    -+    local sealing_ctx_file=${tpm2testdir}/sealing.ctx
    ++    persistent_handle="0x81000000"
    ++    primary_file=${tpm2testdir}/primary.ctx
    ++    session_file=${tpm2testdir}/session.dat
    ++    policy_file=${tpm2testdir}/policy.dat
    ++    keypub_file=${tpm2testdir}/key.pub
    ++    keypriv_file=${tpm2testdir}/key.priv
    ++    name_file=${tpm2testdir}/sealing.name
    ++    sealing_ctx_file=${tpm2testdir}/sealing.ctx
     +
     +    # Since we don't run a resource manager on our swtpm instance, it has
     +    # to flush the transient handles after tpm2_createprimary, tpm2_create
    @@ tests/tpm2_test.in (new)
     +loopback luks (host)${luksfile}
     +tpm2_key_protector_init --mode=nv --nvindex=${persistent_handle} 
--pcrs=0,1
     +if cryptomount -a --protector tpm2; then
    -+    echo "${vtext}"
    ++    cat (crypto0)+1
     +fi
     +EOF
     +
     +    # Test TPM unsealing with the same PCR
    -+    ${grubshell} --timeout=$timeout --grub-emu-opts="-t ${tpm2dev}" < 
${tpm2testdir}/testcase.cfg > ${testoutput}
    -+    ret=$?
    ++    ${grubshell} --timeout=${timeout} --emu-opts="-t ${tpm2dev}" < 
${tpm2testdir}/testcase.cfg > ${testoutput} || ret=$?
     +
     +    # Remove the persistent handle
     +    grub-protect \
    @@ tests/tpm2_test.in (new)
     +  --tpm2-srk=${persistent_handle} \
     +  --tpm2-evict
     +
    -+    if [ "$ret" -eq 0 ]; then
    -+  if ! grep -q "^${vtext}$" "$testoutput"; then
    -+      echo "error: test not verified [`cat $testoutput`]" >&2
    ++    if [ "${ret}" -eq 0 ]; then
    ++  if ! grep -q "^${vtext}$" "${testoutput}"; then
    ++      echo "error: test not verified [`cat ${testoutput}`]" >&2
     +      exit 1
     +  fi
     +    else
    -+  echo "grub-emu exited with error: $ret" >&2
    -+  exit $ret
    ++  echo "grub-emu exited with error: ${ret}" >&2
    ++  exit ${ret}
     +    fi
     +}
     +
    @@ tests/util/grub-shell.in: work_directory=${WORKDIR:-`mktemp -d 
"${TMPDIR:-/tmp}/
      
      . "${builddir}/grub-core/modinfo.sh"
      qemuopts=
    -+grubemuopts=
    ++emuopts=
      serial_port=com0
      serial_null=
      halt_cmd=halt
    @@ tests/util/grub-shell.in: for option in "$@"; do
          --qemu-opts=*)
        qs=`echo "$option" | sed -e 's/--qemu-opts=//'`
        qemuopts="$qemuopts $qs" ;;
    -+    --grub-emu-opts=*)
    -+  qs=`echo "$option" | sed -e 's/--grub-emu-opts=//'`
    -+  grubemuopts="$grubemuopts $qs" ;;
    ++    --emu-opts=*)
    ++  qs=`echo "$option" | sed -e 's/--emu-opts=//'`
    ++  emuopts="$emuopts $qs" ;;
          --disk=*)
        dsk=`echo "$option" | sed -e 's/--disk=//'`
        if [ ${grub_modinfo_platform} = emu ]; then
    @@ tests/util/grub-shell.in: elif [ x$boot = xemu ]; then
      #! @BUILD_SHEBANG@
      SDIR=\$(realpath -e \${0%/*})
     -exec "$(realpath -e "${builddir}")/grub-core/grub-emu" -m 
"\$SDIR/${device_map##*/}" --memdisk "\$SDIR/${roottar##*/}" -r memdisk -d 
"/boot/grub"
    -+exec "$(realpath -e "${builddir}")/grub-core/grub-emu" -m 
"\$SDIR/${device_map##*/}" --memdisk "\$SDIR/${roottar##*/}" -r memdisk -d 
"/boot/grub" ${grubemuopts}
    ++exec "$(realpath -e "${builddir}")/grub-core/grub-emu" -m 
"\$SDIR/${device_map##*/}" --memdisk "\$SDIR/${roottar##*/}" -r memdisk -d 
"/boot/grub" ${emuopts}
      EOF
      else
          cat >"$work_directory/run.sh" <<EOF
-- 
2.35.3


_______________________________________________
Grub-devel mailing list
Grub-devel@gnu.org
https://lists.gnu.org/mailman/listinfo/grub-devel

Reply via email to