1 /* SPDX-License-Identifier: GPL-2.0-only */
2 /*
3  * Copyright (C) 2008 IBM Corporation
4  * Author: Mimi Zohar <zohar@us.ibm.com>
5  */
6 
7 #ifndef _LINUX_IMA_H
8 #define _LINUX_IMA_H
9 
10 #include <linux/kernel_read_file.h>
11 #include <linux/fs.h>
12 #include <linux/security.h>
13 #include <linux/kexec.h>
14 #include <crypto/hash_info.h>
15 struct linux_binprm;
16 
17 #ifdef CONFIG_IMA
18 extern enum hash_algo ima_get_current_hash_algo(void);
19 extern int ima_bprm_check(struct linux_binprm *bprm);
20 extern int ima_file_check(struct file *file, int mask);
21 extern void ima_post_create_tmpfile(struct user_namespace *mnt_userns,
22 				    struct inode *inode);
23 extern void ima_file_free(struct file *file);
24 extern int ima_file_mmap(struct file *file, unsigned long prot);
25 extern int ima_file_mprotect(struct vm_area_struct *vma, unsigned long prot);
26 extern int ima_load_data(enum kernel_load_data_id id, bool contents);
27 extern int ima_post_load_data(char *buf, loff_t size,
28 			      enum kernel_load_data_id id, char *description);
29 extern int ima_read_file(struct file *file, enum kernel_read_file_id id,
30 			 bool contents);
31 extern int ima_post_read_file(struct file *file, void *buf, loff_t size,
32 			      enum kernel_read_file_id id);
33 extern void ima_post_path_mknod(struct user_namespace *mnt_userns,
34 				struct dentry *dentry);
35 extern int ima_file_hash(struct file *file, char *buf, size_t buf_size);
36 extern int ima_inode_hash(struct inode *inode, char *buf, size_t buf_size);
37 extern void ima_kexec_cmdline(int kernel_fd, const void *buf, int size);
38 extern int ima_measure_critical_data(const char *event_label,
39 				     const char *event_name,
40 				     const void *buf, size_t buf_len,
41 				     bool hash, u8 *digest, size_t digest_len);
42 
43 #ifdef CONFIG_IMA_APPRAISE_BOOTPARAM
44 extern void ima_appraise_parse_cmdline(void);
45 #else
ima_appraise_parse_cmdline(void)46 static inline void ima_appraise_parse_cmdline(void) {}
47 #endif
48 
49 #ifdef CONFIG_IMA_KEXEC
50 extern void ima_add_kexec_buffer(struct kimage *image);
51 #endif
52 
53 #ifdef CONFIG_IMA_SECURE_AND_OR_TRUSTED_BOOT
54 extern bool arch_ima_get_secureboot(void);
55 extern const char * const *arch_get_ima_policy(void);
56 #else
arch_ima_get_secureboot(void)57 static inline bool arch_ima_get_secureboot(void)
58 {
59 	return false;
60 }
61 
arch_get_ima_policy(void)62 static inline const char * const *arch_get_ima_policy(void)
63 {
64 	return NULL;
65 }
66 #endif
67 
68 #else
ima_get_current_hash_algo(void)69 static inline enum hash_algo ima_get_current_hash_algo(void)
70 {
71 	return HASH_ALGO__LAST;
72 }
73 
ima_bprm_check(struct linux_binprm * bprm)74 static inline int ima_bprm_check(struct linux_binprm *bprm)
75 {
76 	return 0;
77 }
78 
ima_file_check(struct file * file,int mask)79 static inline int ima_file_check(struct file *file, int mask)
80 {
81 	return 0;
82 }
83 
ima_post_create_tmpfile(struct user_namespace * mnt_userns,struct inode * inode)84 static inline void ima_post_create_tmpfile(struct user_namespace *mnt_userns,
85 					   struct inode *inode)
86 {
87 }
88 
ima_file_free(struct file * file)89 static inline void ima_file_free(struct file *file)
90 {
91 	return;
92 }
93 
ima_file_mmap(struct file * file,unsigned long prot)94 static inline int ima_file_mmap(struct file *file, unsigned long prot)
95 {
96 	return 0;
97 }
98 
ima_file_mprotect(struct vm_area_struct * vma,unsigned long prot)99 static inline int ima_file_mprotect(struct vm_area_struct *vma,
100 				    unsigned long prot)
101 {
102 	return 0;
103 }
104 
ima_load_data(enum kernel_load_data_id id,bool contents)105 static inline int ima_load_data(enum kernel_load_data_id id, bool contents)
106 {
107 	return 0;
108 }
109 
ima_post_load_data(char * buf,loff_t size,enum kernel_load_data_id id,char * description)110 static inline int ima_post_load_data(char *buf, loff_t size,
111 				     enum kernel_load_data_id id,
112 				     char *description)
113 {
114 	return 0;
115 }
116 
ima_read_file(struct file * file,enum kernel_read_file_id id,bool contents)117 static inline int ima_read_file(struct file *file, enum kernel_read_file_id id,
118 				bool contents)
119 {
120 	return 0;
121 }
122 
ima_post_read_file(struct file * file,void * buf,loff_t size,enum kernel_read_file_id id)123 static inline int ima_post_read_file(struct file *file, void *buf, loff_t size,
124 				     enum kernel_read_file_id id)
125 {
126 	return 0;
127 }
128 
ima_post_path_mknod(struct user_namespace * mnt_userns,struct dentry * dentry)129 static inline void ima_post_path_mknod(struct user_namespace *mnt_userns,
130 				       struct dentry *dentry)
131 {
132 	return;
133 }
134 
ima_file_hash(struct file * file,char * buf,size_t buf_size)135 static inline int ima_file_hash(struct file *file, char *buf, size_t buf_size)
136 {
137 	return -EOPNOTSUPP;
138 }
139 
ima_inode_hash(struct inode * inode,char * buf,size_t buf_size)140 static inline int ima_inode_hash(struct inode *inode, char *buf, size_t buf_size)
141 {
142 	return -EOPNOTSUPP;
143 }
144 
ima_kexec_cmdline(int kernel_fd,const void * buf,int size)145 static inline void ima_kexec_cmdline(int kernel_fd, const void *buf, int size) {}
146 
ima_measure_critical_data(const char * event_label,const char * event_name,const void * buf,size_t buf_len,bool hash,u8 * digest,size_t digest_len)147 static inline int ima_measure_critical_data(const char *event_label,
148 					     const char *event_name,
149 					     const void *buf, size_t buf_len,
150 					     bool hash, u8 *digest,
151 					     size_t digest_len)
152 {
153 	return -ENOENT;
154 }
155 
156 #endif /* CONFIG_IMA */
157 
158 #ifndef CONFIG_IMA_KEXEC
159 struct kimage;
160 
ima_add_kexec_buffer(struct kimage * image)161 static inline void ima_add_kexec_buffer(struct kimage *image)
162 {}
163 #endif
164 
165 #ifdef CONFIG_IMA_MEASURE_ASYMMETRIC_KEYS
166 extern void ima_post_key_create_or_update(struct key *keyring,
167 					  struct key *key,
168 					  const void *payload, size_t plen,
169 					  unsigned long flags, bool create);
170 #else
ima_post_key_create_or_update(struct key * keyring,struct key * key,const void * payload,size_t plen,unsigned long flags,bool create)171 static inline void ima_post_key_create_or_update(struct key *keyring,
172 						 struct key *key,
173 						 const void *payload,
174 						 size_t plen,
175 						 unsigned long flags,
176 						 bool create) {}
177 #endif  /* CONFIG_IMA_MEASURE_ASYMMETRIC_KEYS */
178 
179 #ifdef CONFIG_IMA_APPRAISE
180 extern bool is_ima_appraise_enabled(void);
181 extern void ima_inode_post_setattr(struct user_namespace *mnt_userns,
182 				   struct dentry *dentry);
183 extern int ima_inode_setxattr(struct dentry *dentry, const char *xattr_name,
184 		       const void *xattr_value, size_t xattr_value_len);
185 extern int ima_inode_removexattr(struct dentry *dentry, const char *xattr_name);
186 #else
is_ima_appraise_enabled(void)187 static inline bool is_ima_appraise_enabled(void)
188 {
189 	return 0;
190 }
191 
ima_inode_post_setattr(struct user_namespace * mnt_userns,struct dentry * dentry)192 static inline void ima_inode_post_setattr(struct user_namespace *mnt_userns,
193 					  struct dentry *dentry)
194 {
195 	return;
196 }
197 
ima_inode_setxattr(struct dentry * dentry,const char * xattr_name,const void * xattr_value,size_t xattr_value_len)198 static inline int ima_inode_setxattr(struct dentry *dentry,
199 				     const char *xattr_name,
200 				     const void *xattr_value,
201 				     size_t xattr_value_len)
202 {
203 	return 0;
204 }
205 
ima_inode_removexattr(struct dentry * dentry,const char * xattr_name)206 static inline int ima_inode_removexattr(struct dentry *dentry,
207 					const char *xattr_name)
208 {
209 	return 0;
210 }
211 #endif /* CONFIG_IMA_APPRAISE */
212 
213 #if defined(CONFIG_IMA_APPRAISE) && defined(CONFIG_INTEGRITY_TRUSTED_KEYRING)
214 extern bool ima_appraise_signature(enum kernel_read_file_id func);
215 #else
ima_appraise_signature(enum kernel_read_file_id func)216 static inline bool ima_appraise_signature(enum kernel_read_file_id func)
217 {
218 	return false;
219 }
220 #endif /* CONFIG_IMA_APPRAISE && CONFIG_INTEGRITY_TRUSTED_KEYRING */
221 #endif /* _LINUX_IMA_H */
222