include/linux/verification.h

   1 /* SPDX-License-Identifier: GPL-2.0-or-later */
   2 /* Signature verification
   3  *
   4  * Copyright (C) 2014 Red Hat, Inc. All Rights Reserved.
   5  * Written by David Howells (dhowells@redhat.com)
   6  */
   7
   8 #ifndef _LINUX_VERIFICATION_H
   9 #define _LINUX_VERIFICATION_H
  10
  11 /*
  12  * Indicate that both builtin trusted keys and secondary trusted keys
  13  * should be used.
  14  */
  15 #define VERIFY_USE_SECONDARY_KEYRING ((struct key *)1UL)
  16 #define VERIFY_USE_PLATFORM_KEYRING  ((struct key *)2UL)
  17
  18 /*
  19  * The use to which an asymmetric key is being put.
  20  */
  21 enum key_being_used_for {
  22         VERIFYING_MODULE_SIGNATURE,
  23         VERIFYING_FIRMWARE_SIGNATURE,
  24         VERIFYING_KEXEC_PE_SIGNATURE,
  25         VERIFYING_KEY_SIGNATURE,
  26         VERIFYING_KEY_SELF_SIGNATURE,
  27         VERIFYING_UNSPECIFIED_SIGNATURE,
  28         NR__KEY_BEING_USED_FOR
  29 };
  30 extern const char *const key_being_used_for[NR__KEY_BEING_USED_FOR];
  31
  32 #ifdef CONFIG_SYSTEM_DATA_VERIFICATION
  33
  34 struct key;
  35
  36 extern int verify_pkcs7_signature(const void *data, size_t len,
  37                                   const void *raw_pkcs7, size_t pkcs7_len,
  38                                   struct key *trusted_keys,
  39                                   enum key_being_used_for usage,
  40                                   int (*view_content)(void *ctx,
  41                                                       const void *data, size_t len,
  42                                                       size_t asn1hdrlen),
  43                                   void *ctx);
  44
  45 #ifdef CONFIG_SIGNED_PE_FILE_VERIFICATION
  46 extern int verify_pefile_signature(const void *pebuf, unsigned pelen,
  47                                    struct key *trusted_keys,
  48                                    enum key_being_used_for usage);
  49 #endif
  50
  51 #endif /* CONFIG_SYSTEM_DATA_VERIFICATION */
  52 #endif /* _LINUX_VERIFY_PEFILE_H */