2 * Copyright (C) 2005,2006,2007,2008 IBM Corporation
5 * Reiner Sailer <sailer@watson.ibm.com>
6 * Mimi Zohar <zohar@us.ibm.com>
8 * This program is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU General Public License as
10 * published by the Free Software Foundation, version 2 of the
14 * internal Integrity Measurement Architecture (IMA) definitions
20 #include <linux/types.h>
21 #include <linux/crypto.h>
22 #include <linux/security.h>
23 #include <linux/hash.h>
24 #include <linux/tpm.h>
25 #include <linux/audit.h>
27 #include "../integrity.h"
29 enum ima_show_type { IMA_SHOW_BINARY, IMA_SHOW_ASCII };
30 enum tpm_pcrs { TPM_PCR0 = 0, TPM_PCR8 = 8 };
32 /* digest size for IMA, fits SHA1 or MD5 */
33 #define IMA_DIGEST_SIZE SHA1_DIGEST_SIZE
34 #define IMA_EVENT_NAME_LEN_MAX 255
36 #define IMA_HASH_BITS 9
37 #define IMA_MEASURE_HTABLE_SIZE (1 << IMA_HASH_BITS)
39 /* set during initialization */
40 extern int ima_initialized;
41 extern int ima_used_chip;
42 extern int ima_hash_algo;
43 extern int ima_appraise;
45 /* IMA inode template definition */
46 struct ima_template_data {
47 u8 digest[IMA_DIGEST_SIZE]; /* sha1/md5 measurement hash */
48 char file_name[IMA_EVENT_NAME_LEN_MAX + 1]; /* name + \0 */
51 struct ima_template_entry {
52 u8 digest[TPM_DIGEST_SIZE]; /* sha1 or md5 measurement hash */
53 const char *template_name;
55 struct ima_template_data template;
58 struct ima_queue_entry {
59 struct hlist_node hnext; /* place in hash collision list */
60 struct list_head later; /* place in ima_measurements list */
61 struct ima_template_entry *entry;
63 extern struct list_head ima_measurements; /* list of all measurements */
65 /* Internal IMA function definitions */
67 void ima_cleanup(void);
68 int ima_fs_init(void);
69 void ima_fs_cleanup(void);
70 int ima_inode_alloc(struct inode *inode);
71 int ima_add_template_entry(struct ima_template_entry *entry, int violation,
72 const char *op, struct inode *inode,
73 const unsigned char *filename);
74 int ima_calc_file_hash(struct file *file, struct ima_digest_data *hash);
75 int ima_calc_buffer_hash(const void *data, int len,
76 struct ima_digest_data *hash);
77 int __init ima_calc_boot_aggregate(struct ima_digest_data *hash);
78 void ima_add_violation(struct file *file, const unsigned char *filename,
79 const char *op, const char *cause);
80 int ima_init_crypto(void);
83 * used to protect h_table and sha_table
85 extern spinlock_t ima_queue_lock;
88 atomic_long_t len; /* number of stored measurements in the list */
89 atomic_long_t violations;
90 struct hlist_head queue[IMA_MEASURE_HTABLE_SIZE];
92 extern struct ima_h_table ima_htable;
94 static inline unsigned long ima_hash_key(u8 *digest)
96 return hash_long(*digest, IMA_HASH_BITS);
99 /* LIM API function definitions */
100 int ima_get_action(struct inode *inode, int mask, int function);
101 int ima_must_measure(struct inode *inode, int mask, int function);
102 int ima_collect_measurement(struct integrity_iint_cache *iint,
104 struct evm_ima_xattr_data **xattr_value,
106 void ima_store_measurement(struct integrity_iint_cache *iint, struct file *file,
107 const unsigned char *filename);
108 void ima_audit_measurement(struct integrity_iint_cache *iint,
109 const unsigned char *filename);
110 int ima_alloc_init_template(struct integrity_iint_cache *iint,
111 struct file *file, const unsigned char *filename,
112 struct ima_template_entry **entry);
113 int ima_store_template(struct ima_template_entry *entry, int violation,
114 struct inode *inode, const unsigned char *filename);
115 void ima_template_show(struct seq_file *m, void *e, enum ima_show_type show);
116 const char *ima_d_path(struct path *path, char **pathbuf);
118 /* rbtree tree calls to lookup, insert, delete
119 * integrity data associated with an inode.
121 struct integrity_iint_cache *integrity_iint_insert(struct inode *inode);
122 struct integrity_iint_cache *integrity_iint_find(struct inode *inode);
124 /* IMA policy related functions */
125 enum ima_hooks { FILE_CHECK = 1, MMAP_CHECK, BPRM_CHECK, MODULE_CHECK, POST_SETATTR };
127 int ima_match_policy(struct inode *inode, enum ima_hooks func, int mask,
129 void ima_init_policy(void);
130 void ima_update_policy(void);
131 ssize_t ima_parse_add_rule(char *);
132 void ima_delete_rules(void);
134 /* Appraise integrity measurements */
135 #define IMA_APPRAISE_ENFORCE 0x01
136 #define IMA_APPRAISE_FIX 0x02
137 #define IMA_APPRAISE_MODULES 0x04
139 #ifdef CONFIG_IMA_APPRAISE
140 int ima_appraise_measurement(int func, struct integrity_iint_cache *iint,
141 struct file *file, const unsigned char *filename,
142 struct evm_ima_xattr_data *xattr_value,
144 int ima_must_appraise(struct inode *inode, int mask, enum ima_hooks func);
145 void ima_update_xattr(struct integrity_iint_cache *iint, struct file *file);
146 enum integrity_status ima_get_cache_status(struct integrity_iint_cache *iint,
148 void ima_get_hash_algo(struct evm_ima_xattr_data *xattr_value, int xattr_len,
149 struct ima_digest_data *hash);
150 int ima_read_xattr(struct dentry *dentry,
151 struct evm_ima_xattr_data **xattr_value);
154 static inline int ima_appraise_measurement(int func,
155 struct integrity_iint_cache *iint,
157 const unsigned char *filename,
158 struct evm_ima_xattr_data *xattr_value,
161 return INTEGRITY_UNKNOWN;
164 static inline int ima_must_appraise(struct inode *inode, int mask,
170 static inline void ima_update_xattr(struct integrity_iint_cache *iint,
175 static inline enum integrity_status ima_get_cache_status(struct integrity_iint_cache
178 return INTEGRITY_UNKNOWN;
181 static inline void ima_get_hash_algo(struct evm_ima_xattr_data *xattr_value,
183 struct ima_digest_data *hash)
187 static inline int ima_read_xattr(struct dentry *dentry,
188 struct evm_ima_xattr_data **xattr_value)
195 /* LSM based policy rules require audit */
196 #ifdef CONFIG_IMA_LSM_RULES
198 #define security_filter_rule_init security_audit_rule_init
199 #define security_filter_rule_match security_audit_rule_match
203 static inline int security_filter_rule_init(u32 field, u32 op, char *rulestr,
209 static inline int security_filter_rule_match(u32 secid, u32 field, u32 op,
211 struct audit_context *actx)
215 #endif /* CONFIG_IMA_LSM_RULES */