Linux Audio

Check our new training course

In-person Linux kernel drivers training

Jun 16-20, 2025
Register
Loading...
v4.6
 
  1/*
  2 * Copyright (C) 2009-2010 IBM Corporation
  3 *
  4 * Authors:
  5 * Mimi Zohar <zohar@us.ibm.com>
  6 *
  7 * This program is free software; you can redistribute it and/or
  8 * modify it under the terms of the GNU General Public License as
  9 * published by the Free Software Foundation, version 2 of the
 10 * License.
 11 *
 12 */
 13
 
 
 
 
 
 
 14#include <linux/types.h>
 15#include <linux/integrity.h>
 16#include <crypto/sha.h>
 
 17#include <linux/key.h>
 18
 19/* iint action cache flags */
 20#define IMA_MEASURE		0x00000001
 21#define IMA_MEASURED		0x00000002
 22#define IMA_APPRAISE		0x00000004
 23#define IMA_APPRAISED		0x00000008
 24/*#define IMA_COLLECT		0x00000010  do not use this flag */
 25#define IMA_COLLECTED		0x00000020
 26#define IMA_AUDIT		0x00000040
 27#define IMA_AUDITED		0x00000080
 28
 29/* iint cache flags */
 30#define IMA_ACTION_FLAGS	0xff000000
 31#define IMA_DIGSIG		0x01000000
 32#define IMA_DIGSIG_REQUIRED	0x02000000
 33#define IMA_PERMIT_DIRECTIO	0x04000000
 34#define IMA_NEW_FILE		0x08000000
 35
 36#define IMA_DO_MASK		(IMA_MEASURE | IMA_APPRAISE | IMA_AUDIT | \
 37				 IMA_APPRAISE_SUBMASK)
 38#define IMA_DONE_MASK		(IMA_MEASURED | IMA_APPRAISED | IMA_AUDITED | \
 39				 IMA_COLLECTED | IMA_APPRAISED_SUBMASK)
 40
 41/* iint subaction appraise cache flags */
 42#define IMA_FILE_APPRAISE	0x00000100
 43#define IMA_FILE_APPRAISED	0x00000200
 44#define IMA_MMAP_APPRAISE	0x00000400
 45#define IMA_MMAP_APPRAISED	0x00000800
 46#define IMA_BPRM_APPRAISE	0x00001000
 47#define IMA_BPRM_APPRAISED	0x00002000
 48#define IMA_READ_APPRAISE	0x00004000
 49#define IMA_READ_APPRAISED	0x00008000
 50#define IMA_APPRAISE_SUBMASK	(IMA_FILE_APPRAISE | IMA_MMAP_APPRAISE | \
 51				 IMA_BPRM_APPRAISE | IMA_READ_APPRAISE)
 52#define IMA_APPRAISED_SUBMASK	(IMA_FILE_APPRAISED | IMA_MMAP_APPRAISED | \
 53				 IMA_BPRM_APPRAISED | IMA_READ_APPRAISED)
 54
 55enum evm_ima_xattr_type {
 56	IMA_XATTR_DIGEST = 0x01,
 57	EVM_XATTR_HMAC,
 58	EVM_IMA_XATTR_DIGSIG,
 59	IMA_XATTR_DIGEST_NG,
 
 
 60	IMA_XATTR_LAST
 61};
 62
 63struct evm_ima_xattr_data {
 64	u8 type;
 
 
 
 
 
 
 
 
 
 
 
 65	u8 digest[SHA1_DIGEST_SIZE];
 66} __packed;
 67
 68#define IMA_MAX_DIGEST_SIZE	64
 69
 70struct ima_digest_data {
 
 
 71	u8 algo;
 72	u8 length;
 73	union {
 74		struct {
 75			u8 unused;
 76			u8 type;
 77		} sha1;
 78		struct {
 79			u8 type;
 80			u8 algo;
 81		} ng;
 82		u8 data[2];
 83	} xattr;
 84	u8 digest[0];
 
 85} __packed;
 
 
 86
 87/*
 88 * signature format v2 - for using with asymmetric keys
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 89 */
 90struct signature_v2_hdr {
 91	uint8_t type;		/* xattr type */
 92	uint8_t version;	/* signature format version */
 93	uint8_t	hash_algo;	/* Digest algorithm [enum hash_algo] */
 94	uint32_t keyid;		/* IMA key identifier - not X509/PGP specific */
 95	uint16_t sig_size;	/* signature size */
 96	uint8_t sig[0];		/* signature payload */
 97} __packed;
 98
 99/* integrity data associated with an inode */
100struct integrity_iint_cache {
101	struct rb_node rb_node;	/* rooted in integrity_iint_tree */
102	struct inode *inode;	/* back pointer to inode in question */
103	u64 version;		/* track inode changes */
104	unsigned long flags;
105	enum integrity_status ima_file_status:4;
106	enum integrity_status ima_mmap_status:4;
107	enum integrity_status ima_bprm_status:4;
108	enum integrity_status ima_read_status:4;
109	enum integrity_status evm_status:4;
110	struct ima_digest_data *ima_hash;
111};
112
113/* rbtree tree calls to lookup, insert, delete
114 * integrity data associated with an inode.
 
 
 
 
 
115 */
116struct integrity_iint_cache *integrity_iint_find(struct inode *inode);
 
 
 
 
117
118int integrity_kernel_read(struct file *file, loff_t offset,
119			  char *addr, unsigned long count);
120int __init integrity_read_file(const char *path, char **data);
121
122#define INTEGRITY_KEYRING_EVM		0
123#define INTEGRITY_KEYRING_IMA		1
124#define INTEGRITY_KEYRING_MODULE	2
125#define INTEGRITY_KEYRING_MAX		3
 
 
 
 
 
126
127#ifdef CONFIG_INTEGRITY_SIGNATURE
128
129int integrity_digsig_verify(const unsigned int id, const char *sig, int siglen,
130			    const char *digest, int digestlen);
 
131
132int __init integrity_init_keyring(const unsigned int id);
133int __init integrity_load_x509(const unsigned int id, const char *path);
 
 
134#else
135
136static inline int integrity_digsig_verify(const unsigned int id,
137					  const char *sig, int siglen,
138					  const char *digest, int digestlen)
139{
140	return -EOPNOTSUPP;
141}
142
 
 
 
 
 
 
143static inline int integrity_init_keyring(const unsigned int id)
144{
145	return 0;
146}
 
 
 
 
 
 
 
 
147#endif /* CONFIG_INTEGRITY_SIGNATURE */
148
149#ifdef CONFIG_INTEGRITY_ASYMMETRIC_KEYS
150int asymmetric_verify(struct key *keyring, const char *sig,
151		      int siglen, const char *data, int datalen);
152#else
153static inline int asymmetric_verify(struct key *keyring, const char *sig,
154				    int siglen, const char *data, int datalen)
155{
156	return -EOPNOTSUPP;
157}
158#endif
159
 
 
 
 
 
 
 
 
 
 
160#ifdef CONFIG_IMA_LOAD_X509
161void __init ima_load_x509(void);
162#else
163static inline void ima_load_x509(void)
164{
165}
166#endif
167
168#ifdef CONFIG_EVM_LOAD_X509
169void __init evm_load_x509(void);
170#else
171static inline void evm_load_x509(void)
172{
173}
174#endif
175
176#ifdef CONFIG_INTEGRITY_AUDIT
177/* declarations */
178void integrity_audit_msg(int audit_msgno, struct inode *inode,
179			 const unsigned char *fname, const char *op,
180			 const char *cause, int result, int info);
 
 
 
 
 
 
 
 
 
 
 
 
181#else
182static inline void integrity_audit_msg(int audit_msgno, struct inode *inode,
183				       const unsigned char *fname,
184				       const char *op, const char *cause,
185				       int result, int info)
186{
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
187}
188#endif
v6.13.7
  1/* SPDX-License-Identifier: GPL-2.0-only */
  2/*
  3 * Copyright (C) 2009-2010 IBM Corporation
  4 *
  5 * Authors:
  6 * Mimi Zohar <zohar@us.ibm.com>
 
 
 
 
 
 
  7 */
  8
  9#ifdef pr_fmt
 10#undef pr_fmt
 11#endif
 12
 13#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
 14
 15#include <linux/types.h>
 16#include <linux/integrity.h>
 17#include <crypto/sha1.h>
 18#include <crypto/hash.h>
 19#include <linux/key.h>
 20#include <linux/audit.h>
 21#include <linux/lsm_hooks.h>
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 22
 23enum evm_ima_xattr_type {
 24	IMA_XATTR_DIGEST = 0x01,
 25	EVM_XATTR_HMAC,
 26	EVM_IMA_XATTR_DIGSIG,
 27	IMA_XATTR_DIGEST_NG,
 28	EVM_XATTR_PORTABLE_DIGSIG,
 29	IMA_VERITY_DIGSIG,
 30	IMA_XATTR_LAST
 31};
 32
 33struct evm_ima_xattr_data {
 34	/* New members must be added within the __struct_group() macro below. */
 35	__struct_group(evm_ima_xattr_data_hdr, hdr, __packed,
 36		u8 type;
 37	);
 38	u8 data[];
 39} __packed;
 40static_assert(offsetof(struct evm_ima_xattr_data, data) == sizeof(struct evm_ima_xattr_data_hdr),
 41	      "struct member likely outside of __struct_group()");
 42
 43/* Only used in the EVM HMAC code. */
 44struct evm_xattr {
 45	struct evm_ima_xattr_data_hdr data;
 46	u8 digest[SHA1_DIGEST_SIZE];
 47} __packed;
 48
 49#define IMA_MAX_DIGEST_SIZE	HASH_MAX_DIGESTSIZE
 50
 51struct ima_digest_data {
 52	/* New members must be added within the __struct_group() macro below. */
 53	__struct_group(ima_digest_data_hdr, hdr, __packed,
 54	u8 algo;
 55	u8 length;
 56	union {
 57		struct {
 58			u8 unused;
 59			u8 type;
 60		} sha1;
 61		struct {
 62			u8 type;
 63			u8 algo;
 64		} ng;
 65		u8 data[2];
 66	} xattr;
 67	);
 68	u8 digest[];
 69} __packed;
 70static_assert(offsetof(struct ima_digest_data, digest) == sizeof(struct ima_digest_data_hdr),
 71	      "struct member likely outside of __struct_group()");
 72
 73/*
 74 * Instead of wrapping the ima_digest_data struct inside a local structure
 75 * with the maximum hash size, define ima_max_digest_data struct.
 76 */
 77struct ima_max_digest_data {
 78	struct ima_digest_data_hdr hdr;
 79	u8 digest[HASH_MAX_DIGESTSIZE];
 80} __packed;
 81
 82/*
 83 * signature header format v2 - for using with asymmetric keys
 84 *
 85 * The signature_v2_hdr struct includes a signature format version
 86 * to simplify defining new signature formats.
 87 *
 88 * signature format:
 89 * version 2: regular file data hash based signature
 90 * version 3: struct ima_file_id data based signature
 91 */
 92struct signature_v2_hdr {
 93	uint8_t type;		/* xattr type */
 94	uint8_t version;	/* signature format version */
 95	uint8_t	hash_algo;	/* Digest algorithm [enum hash_algo] */
 96	__be32 keyid;		/* IMA key identifier - not X509/PGP specific */
 97	__be16 sig_size;	/* signature size */
 98	uint8_t sig[];		/* signature payload */
 99} __packed;
 
 
 
 
 
 
 
 
 
 
 
 
 
 
100
101/*
102 * IMA signature version 3 disambiguates the data that is signed, by
103 * indirectly signing the hash of the ima_file_id structure data,
104 * containing either the fsverity_descriptor struct digest or, in the
105 * future, the regular IMA file hash.
106 *
107 * (The hash of the ima_file_id structure is only of the portion used.)
108 */
109struct ima_file_id {
110	__u8 hash_type;		/* xattr type [enum evm_ima_xattr_type] */
111	__u8 hash_algorithm;	/* Digest algorithm [enum hash_algo] */
112	__u8 hash[HASH_MAX_DIGESTSIZE];
113} __packed;
114
115int integrity_kernel_read(struct file *file, loff_t offset,
116			  void *addr, unsigned long count);
 
117
118#define INTEGRITY_KEYRING_EVM		0
119#define INTEGRITY_KEYRING_IMA		1
120#define INTEGRITY_KEYRING_PLATFORM	2
121#define INTEGRITY_KEYRING_MACHINE	3
122#define INTEGRITY_KEYRING_MAX		4
123
124extern struct dentry *integrity_dir;
125
126struct modsig;
127
128#ifdef CONFIG_INTEGRITY_SIGNATURE
129
130int integrity_digsig_verify(const unsigned int id, const char *sig, int siglen,
131			    const char *digest, int digestlen);
132int integrity_modsig_verify(unsigned int id, const struct modsig *modsig);
133
134int __init integrity_init_keyring(const unsigned int id);
135int __init integrity_load_x509(const unsigned int id, const char *path);
136int __init integrity_load_cert(const unsigned int id, const char *source,
137			       const void *data, size_t len, key_perm_t perm);
138#else
139
140static inline int integrity_digsig_verify(const unsigned int id,
141					  const char *sig, int siglen,
142					  const char *digest, int digestlen)
143{
144	return -EOPNOTSUPP;
145}
146
147static inline int integrity_modsig_verify(unsigned int id,
148					  const struct modsig *modsig)
149{
150	return -EOPNOTSUPP;
151}
152
153static inline int integrity_init_keyring(const unsigned int id)
154{
155	return 0;
156}
157
158static inline int __init integrity_load_cert(const unsigned int id,
159					     const char *source,
160					     const void *data, size_t len,
161					     key_perm_t perm)
162{
163	return 0;
164}
165#endif /* CONFIG_INTEGRITY_SIGNATURE */
166
167#ifdef CONFIG_INTEGRITY_ASYMMETRIC_KEYS
168int asymmetric_verify(struct key *keyring, const char *sig,
169		      int siglen, const char *data, int datalen);
170#else
171static inline int asymmetric_verify(struct key *keyring, const char *sig,
172				    int siglen, const char *data, int datalen)
173{
174	return -EOPNOTSUPP;
175}
176#endif
177
178#ifdef CONFIG_IMA_APPRAISE_MODSIG
179int ima_modsig_verify(struct key *keyring, const struct modsig *modsig);
180#else
181static inline int ima_modsig_verify(struct key *keyring,
182				    const struct modsig *modsig)
183{
184	return -EOPNOTSUPP;
185}
186#endif
187
188#ifdef CONFIG_IMA_LOAD_X509
189void __init ima_load_x509(void);
190#else
191static inline void ima_load_x509(void)
192{
193}
194#endif
195
196#ifdef CONFIG_EVM_LOAD_X509
197void __init evm_load_x509(void);
198#else
199static inline void evm_load_x509(void)
200{
201}
202#endif
203
204#ifdef CONFIG_INTEGRITY_AUDIT
205/* declarations */
206void integrity_audit_msg(int audit_msgno, struct inode *inode,
207			 const unsigned char *fname, const char *op,
208			 const char *cause, int result, int info);
209
210void integrity_audit_message(int audit_msgno, struct inode *inode,
211			     const unsigned char *fname, const char *op,
212			     const char *cause, int result, int info,
213			     int errno);
214
215static inline struct audit_buffer *
216integrity_audit_log_start(struct audit_context *ctx, gfp_t gfp_mask, int type)
217{
218	return audit_log_start(ctx, gfp_mask, type);
219}
220
221#else
222static inline void integrity_audit_msg(int audit_msgno, struct inode *inode,
223				       const unsigned char *fname,
224				       const char *op, const char *cause,
225				       int result, int info)
226{
227}
228
229static inline void integrity_audit_message(int audit_msgno,
230					   struct inode *inode,
231					   const unsigned char *fname,
232					   const char *op, const char *cause,
233					   int result, int info, int errno)
234{
235}
236
237static inline struct audit_buffer *
238integrity_audit_log_start(struct audit_context *ctx, gfp_t gfp_mask, int type)
239{
240	return NULL;
241}
242
243#endif
244
245#ifdef CONFIG_INTEGRITY_PLATFORM_KEYRING
246void __init add_to_platform_keyring(const char *source, const void *data,
247				    size_t len);
248#else
249static inline void __init add_to_platform_keyring(const char *source,
250						  const void *data, size_t len)
251{
252}
253#endif
254
255#ifdef CONFIG_INTEGRITY_MACHINE_KEYRING
256void __init add_to_machine_keyring(const char *source, const void *data, size_t len);
257bool __init imputed_trust_enabled(void);
258#else
259static inline void __init add_to_machine_keyring(const char *source,
260						  const void *data, size_t len)
261{
262}
263
264static inline bool __init imputed_trust_enabled(void)
265{
266	return false;
267}
268#endif