ima_main.c 27.9 KB
Newer Older
1
// SPDX-License-Identifier: GPL-2.0-only
2
/*
3 4
 * Integrity Measurement Architecture
 *
5 6 7 8 9 10 11 12 13
 * Copyright (C) 2005,2006,2007,2008 IBM Corporation
 *
 * Authors:
 * Reiner Sailer <sailer@watson.ibm.com>
 * Serge Hallyn <serue@us.ibm.com>
 * Kylene Hall <kylene@us.ibm.com>
 * Mimi Zohar <zohar@us.ibm.com>
 *
 * File: ima_main.c
14
 *	implements the IMA hooks: ima_bprm_check, ima_file_mmap,
15
 *	and ima_file_check.
16
 */
17

18
#include <linux/module.h>
19 20
#include <linux/file.h>
#include <linux/binfmts.h>
21
#include <linux/kernel_read_file.h>
22 23
#include <linux/mount.h>
#include <linux/mman.h>
24
#include <linux/slab.h>
M
Mimi Zohar 已提交
25
#include <linux/xattr.h>
26
#include <linux/ima.h>
27
#include <linux/iversion.h>
28
#include <linux/fs.h>
29 30

#include "ima.h"
31
#include "ima_digest_list.h"
32

M
Mimi Zohar 已提交
33 34 35 36 37 38
#ifdef CONFIG_IMA_APPRAISE
int ima_appraise = IMA_APPRAISE_ENFORCE;
#else
int ima_appraise;
#endif

39
int ima_hash_algo = HASH_ALGO_SHA1;
40 41 42

/* Actions (measure/appraisal) for which digest lists can be used */
int ima_digest_list_actions;
43 44 45 46
/* PCR used for digest list measurements */
int ima_digest_list_pcr = -1;
/* Flag to include standard measurement if digest list PCR is specified */
bool ima_plus_standard_pcr;
47

48
static int hash_setup_done;
49

50 51 52
DECLARE_RWSEM(ima_ns_list_lock);
LIST_HEAD(ima_ns_list);

53 54 55 56
static struct notifier_block ima_lsm_policy_notifier = {
	.notifier_call = ima_lsm_policy_change,
};

57 58
static int __init hash_setup(char *str)
{
59 60 61 62 63 64 65
	struct ima_template_desc *template_desc = ima_template_desc_current();
	int i;

	if (hash_setup_done)
		return 1;

	if (strcmp(template_desc->name, IMA_TEMPLATE_IMA_NAME) == 0) {
66
		if (strncmp(str, "sha1", 4) == 0) {
67
			ima_hash_algo = HASH_ALGO_SHA1;
68
		} else if (strncmp(str, "md5", 3) == 0) {
69
			ima_hash_algo = HASH_ALGO_MD5;
70 71 72
		} else {
			pr_err("invalid hash algorithm \"%s\" for template \"%s\"",
				str, IMA_TEMPLATE_IMA_NAME);
73
			return 1;
74
		}
75 76 77
		goto out;
	}

Y
Yisheng Xie 已提交
78
	i = match_string(hash_algo_name, HASH_ALGO__LAST, str);
79 80
	if (i < 0) {
		pr_err("invalid hash algorithm \"%s\"", str);
81
		return 1;
82
	}
Y
Yisheng Xie 已提交
83 84

	ima_hash_algo = i;
85 86
out:
	hash_setup_done = 1;
87 88 89 90
	return 1;
}
__setup("ima_hash=", hash_setup);

91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111
/* Prevent mmap'ing a file execute that is already mmap'ed write */
static int mmap_violation_check(enum ima_hooks func, struct file *file,
				char **pathbuf, const char **pathname,
				char *filename)
{
	struct inode *inode;
	int rc = 0;

	if ((func == MMAP_CHECK) && mapping_writably_mapped(file->f_mapping)) {
		rc = -ETXTBSY;
		inode = file_inode(file);

		if (!*pathbuf)	/* ima_rdwr_violation possibly pre-fetched */
			*pathname = ima_d_path(&file->f_path, pathbuf,
					       filename);
		integrity_audit_msg(AUDIT_INTEGRITY_DATA, inode, *pathname,
				    "mmap_file", "mmapped_writers", rc, 0);
	}
	return rc;
}

M
Mimi Zohar 已提交
112
/*
113
 * ima_rdwr_violation_check
M
Mimi Zohar 已提交
114
 *
115
 * Only invalidate the PCR for measured files:
116
 *	- Opening a file for write when already open for read,
M
Mimi Zohar 已提交
117 118
 *	  results in a time of measure, time of use (ToMToU) error.
 *	- Opening a file for read when already open for write,
119
 *	  could result in a file measurement error.
M
Mimi Zohar 已提交
120 121
 *
 */
122 123
static void ima_rdwr_violation_check(struct file *file,
				     struct integrity_iint_cache *iint,
124
				     int must_measure,
125
				     char **pathbuf,
126 127
				     const char **pathname,
				     char *filename)
M
Mimi Zohar 已提交
128
{
129
	struct inode *inode = file_inode(file);
M
Mimi Zohar 已提交
130
	fmode_t mode = file->f_mode;
131
	bool send_tomtou = false, send_writers = false;
132

M
Mimi Zohar 已提交
133
	if (mode & FMODE_WRITE) {
134
		if (atomic_read(&inode->i_readcount) && IS_IMA(inode)) {
135 136
			if (!iint)
				iint = integrity_iint_find(inode);
137
			/* IMA_MEASURE is set from reader side */
138 139
			if (iint && test_bit(IMA_MUST_MEASURE,
						&iint->atomic_flags))
140 141
				send_tomtou = true;
		}
142
	} else {
143 144
		if (must_measure)
			set_bit(IMA_MUST_MEASURE, &iint->atomic_flags);
N
Nikolay Borisov 已提交
145
		if (inode_is_open_for_write(inode) && must_measure)
146
			send_writers = true;
M
Mimi Zohar 已提交
147
	}
148

149 150 151
	if (!send_tomtou && !send_writers)
		return;

152
	*pathname = ima_d_path(&file->f_path, pathbuf, filename);
153

154
	if (send_tomtou)
155 156
		ima_add_violation(file, *pathname, iint,
				  "invalid_pcr", "ToMToU");
157
	if (send_writers)
158
		ima_add_violation(file, *pathname, iint,
159
				  "invalid_pcr", "open_writers");
M
Mimi Zohar 已提交
160 161
}

162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178
static enum hash_algo ima_get_hash_algo(struct evm_ima_xattr_data *xattr_value,
					int xattr_len)
{
	struct signature_v2_hdr *sig;
	enum hash_algo ret;

	if (!xattr_value || xattr_len < 2)
		/* return default hash algo */
		return ima_hash_algo;

	switch (xattr_value->type) {
	case EVM_IMA_XATTR_DIGSIG:
		sig = (typeof(sig))xattr_value;
		if (sig->version != 2 || xattr_len < sizeof(*sig))
			return ima_hash_algo;
		return sig->hash_algo;
		break;
179 180
	case EVM_IMA_XATTR_DIGEST_LIST:
		fallthrough;
181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215
	case IMA_XATTR_DIGEST_NG:
		/* first byte contains algorithm id */
		ret = xattr_value->data[0];
		if (ret < HASH_ALGO__LAST)
			return ret;
		break;
	case IMA_XATTR_DIGEST:
		/* this is for backward compatibility */
		if (xattr_len == 21) {
			unsigned int zero = 0;
			if (!memcmp(&xattr_value->data[16], &zero, 4))
				return HASH_ALGO_MD5;
			else
				return HASH_ALGO_SHA1;
		} else if (xattr_len == 17)
			return HASH_ALGO_MD5;
		break;
	}

	/* return default hash algo */
	return ima_hash_algo;
}

static int ima_read_xattr(struct dentry *dentry,
			  struct evm_ima_xattr_data **xattr_value)
{
	ssize_t ret;

	ret = vfs_getxattr_alloc(dentry, XATTR_NAME_IMA, (char **)xattr_value,
				 0, GFP_NOFS);
	if (ret == -EOPNOTSUPP)
		ret = 0;
	return ret;
}

216
static void ima_check_last_writer(struct integrity_iint_cache *iint,
M
Mimi Zohar 已提交
217
				  struct inode *inode, struct file *file)
E
Eric Paris 已提交
218
{
A
Al Viro 已提交
219
	fmode_t mode = file->f_mode;
220
	bool update;
E
Eric Paris 已提交
221

M
Mimi Zohar 已提交
222 223 224
	if (!(mode & FMODE_WRITE))
		return;

225
	mutex_lock(&iint->mutex);
226
	if (atomic_read(&inode->i_writecount) == 1) {
227 228
		update = test_and_clear_bit(IMA_UPDATE_XATTR,
					    &iint->atomic_flags);
229
		if (!IS_I_VERSION(inode) ||
230
		    !inode_eq_iversion(inode, iint->version) ||
231 232
		    (iint->flags & IMA_NEW_FILE)) {
			iint->flags &= ~(IMA_DONE_MASK | IMA_NEW_FILE);
233
			iint->measured_pcrs = 0;
234
			if (update)
235 236
				ima_update_xattr(iint, file);
		}
M
Mimi Zohar 已提交
237
	}
238
	mutex_unlock(&iint->mutex);
E
Eric Paris 已提交
239 240
}

241 242 243 244
/**
 * ima_file_free - called on __fput()
 * @file: pointer to file structure being freed
 *
245
 * Flag files that changed, based on i_version
246 247 248
 */
void ima_file_free(struct file *file)
{
A
Al Viro 已提交
249
	struct inode *inode = file_inode(file);
250
	struct integrity_iint_cache *iint;
251

252
	if (!ima_policy_flag || !S_ISREG(inode->i_mode))
253
		return;
254

255
	iint = integrity_iint_find(inode);
M
Mimi Zohar 已提交
256 257
	if (!iint)
		return;
258

M
Mimi Zohar 已提交
259
	ima_check_last_writer(iint, inode, file);
260 261
}

262 263
static int process_measurement(struct file *file, const struct cred *cred,
			       u32 secid, char *buf, loff_t size, int mask,
264
			       enum ima_hooks func)
265
{
A
Al Viro 已提交
266
	struct inode *inode = file_inode(file);
267
	struct integrity_iint_cache *iint = NULL;
268
	struct ima_template_desc *template_desc = NULL;
269
	char *pathbuf = NULL;
270
	char filename[NAME_MAX];
271
	const char *pathname = NULL;
272
	int rc = 0, action, must_appraise = 0;
273
	int pcr = CONFIG_IMA_MEASURE_PCR_IDX;
274
	struct ima_digest *found_digest;
275
	struct evm_ima_xattr_data *xattr_value = NULL;
276
	struct modsig *modsig = NULL;
277
	int xattr_len = 0;
278
	bool violation_check;
279
	enum hash_algo hash_algo;
280

281
	if (!ima_policy_flag || !S_ISREG(inode->i_mode))
282
		return 0;
E
Eric Paris 已提交
283

284 285 286 287
	/* Return an IMA_MEASURE, IMA_APPRAISE, IMA_AUDIT action
	 * bitmask based on the appraise/audit/measurement policy.
	 * Included is the appraise submask.
	 */
288
	action = ima_get_action(inode, cred, secid, mask, func, &pcr,
289
				&template_desc, NULL);
290
	violation_check = ((func == FILE_CHECK || func == MMAP_CHECK) &&
291 292
			   (ima_policy_flag & IMA_MEASURE));
	if (!action && !violation_check)
M
Mimi Zohar 已提交
293 294 295
		return 0;

	must_appraise = action & IMA_APPRAISE;
E
Eric Paris 已提交
296

297
	/*  Is the appraise rule hook specific?  */
298
	if (action & IMA_FILE_APPRAISE)
299
		func = FILE_CHECK;
300

A
Al Viro 已提交
301
	inode_lock(inode);
M
Mimi Zohar 已提交
302

303 304 305
	if (action) {
		iint = integrity_inode_get(inode);
		if (!iint)
306
			rc = -ENOMEM;
307 308
	}

309
	if (!rc && violation_check)
310
		ima_rdwr_violation_check(file, iint, action & IMA_MEASURE,
311
					 &pathbuf, &pathname, filename);
312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327

	inode_unlock(inode);

	if (rc)
		goto out;
	if (!action)
		goto out;

	mutex_lock(&iint->mutex);

	if (test_and_clear_bit(IMA_CHANGE_ATTR, &iint->atomic_flags))
		/* reset appraisal flags if ima_inode_post_setattr was called */
		iint->flags &= ~(IMA_APPRAISE | IMA_APPRAISED |
				 IMA_APPRAISE_SUBMASK | IMA_APPRAISED_SUBMASK |
				 IMA_ACTION_FLAGS);

328 329 330 331 332 333 334
	/*
	 * Re-evaulate the file if either the xattr has changed or the
	 * kernel has no way of detecting file change on the filesystem.
	 * (Limited to privileged mounted filesystems.)
	 */
	if (test_and_clear_bit(IMA_CHANGE_XATTR, &iint->atomic_flags) ||
	    ((inode->i_sb->s_iflags & SB_I_IMA_UNVERIFIABLE_SIGNATURE) &&
335 336
	     !(inode->i_sb->s_iflags & SB_I_UNTRUSTED_MOUNTER) &&
	     !(action & IMA_FAIL_UNVERIFIABLE_SIGS))) {
337
		iint->flags &= ~IMA_DONE_MASK;
338 339
		iint->measured_pcrs = 0;
	}
340

M
Mimi Zohar 已提交
341
	/* Determine if already appraised/measured based on bitmask
342 343 344
	 * (IMA_MEASURE, IMA_MEASURED, IMA_XXXX_APPRAISE, IMA_XXXX_APPRAISED,
	 *  IMA_AUDIT, IMA_AUDITED)
	 */
M
Mimi Zohar 已提交
345
	iint->flags |= action;
346
	action &= IMA_DO_MASK;
347 348 349 350 351
	action &= ~((iint->flags & (IMA_DONE_MASK ^ IMA_MEASURED)) >> 1);

	/* If target pcr is already measured, unset IMA_MEASURE action */
	if ((action & IMA_MEASURE) && (iint->measured_pcrs & (0x1 << pcr)))
		action ^= IMA_MEASURE;
M
Mimi Zohar 已提交
352

353 354 355 356 357 358 359 360 361 362 363 364
	/* HASH sets the digital signature and update flags, nothing else */
	if ((action & IMA_HASH) &&
	    !(test_bit(IMA_DIGSIG, &iint->atomic_flags))) {
		xattr_len = ima_read_xattr(file_dentry(file), &xattr_value);
		if ((xattr_value && xattr_len > 2) &&
		    (xattr_value->type == EVM_IMA_XATTR_DIGSIG))
			set_bit(IMA_DIGSIG, &iint->atomic_flags);
		iint->flags |= IMA_HASHED;
		action ^= IMA_HASH;
		set_bit(IMA_UPDATE_XATTR, &iint->atomic_flags);
	}

M
Mimi Zohar 已提交
365 366
	/* Nothing to do, just return existing appraised status */
	if (!action) {
367 368 369 370 371 372
		if (must_appraise) {
			rc = mmap_violation_check(func, file, &pathbuf,
						  &pathname, filename);
			if (!rc)
				rc = ima_get_cache_status(iint, func);
		}
373
		goto out_locked;
M
Mimi Zohar 已提交
374
	}
375

376
	if ((action & IMA_APPRAISE_SUBMASK) ||
377
	    strcmp(template_desc->name, IMA_TEMPLATE_IMA_NAME) != 0) {
378
		/* read 'security.ima' */
M
Miklos Szeredi 已提交
379
		xattr_len = ima_read_xattr(file_dentry(file), &xattr_value);
380

381 382 383 384 385 386 387 388 389 390 391 392
		/*
		 * Read the appended modsig if allowed by the policy, and allow
		 * an additional measurement list entry, if needed, based on the
		 * template format and whether the file was already measured.
		 */
		if (iint->flags & IMA_MODSIG_ALLOWED) {
			rc = ima_read_modsig(func, buf, size, &modsig);

			if (!rc && ima_template_has_modsig(template_desc) &&
			    iint->flags & IMA_MEASURED)
				action |= IMA_MEASURE;
		}
393 394
	}

395 396
	hash_algo = ima_get_hash_algo(xattr_value, xattr_len);

T
Thiago Jung Bauermann 已提交
397
	rc = ima_collect_measurement(iint, file, buf, size, hash_algo, modsig);
398
	if (rc != 0 && rc != -EBADF && rc != -EINVAL)
399
		goto out_locked;
400

401 402
	if (!pathbuf)	/* ima_rdwr_violation possibly pre-fetched */
		pathname = ima_d_path(&file->f_path, &pathbuf, filename);
403

404 405 406
	found_digest = ima_lookup_digest(iint->ima_hash->digest, hash_algo,
					 COMPACT_FILE);

M
Mimi Zohar 已提交
407
	if (action & IMA_MEASURE)
408
		ima_store_measurement(iint, file, pathname,
409
				      xattr_value, xattr_len, modsig, pcr,
410 411 412 413
				      template_desc,
				      ima_digest_allow(found_digest,
						       IMA_MEASURE));

414
	if (rc == 0 && (action & IMA_APPRAISE_SUBMASK)) {
415 416 417 418
		rc = ima_check_blacklist(iint, modsig, pcr);
		if (rc != -EPERM) {
			inode_lock(inode);
			rc = ima_appraise_measurement(func, iint, file,
419 420 421 422
					      pathname, xattr_value,
					      xattr_len, modsig,
					      ima_digest_allow(found_digest,
							       IMA_APPRAISE));
423 424
			inode_unlock(inode);
		}
425 426 427
		if (!rc)
			rc = mmap_violation_check(func, file, &pathbuf,
						  &pathname, filename);
428
	}
P
Peter Moody 已提交
429
	if (action & IMA_AUDIT)
430
		ima_audit_measurement(iint, pathname);
431

432 433
	if ((file->f_flags & O_DIRECT) && (iint->flags & IMA_PERMIT_DIRECTIO))
		rc = 0;
434 435
out_locked:
	if ((mask & MAY_WRITE) && test_bit(IMA_DIGSIG, &iint->atomic_flags) &&
436
	     !(iint->flags & IMA_NEW_FILE))
437
		rc = -EACCES;
438
	mutex_unlock(&iint->mutex);
439
	kfree(xattr_value);
440
	ima_free_modsig(modsig);
441
out:
D
Dmitry Kasatkin 已提交
442 443
	if (pathbuf)
		__putname(pathbuf);
444 445 446 447 448 449
	if (must_appraise) {
		if (rc && (ima_appraise & IMA_APPRAISE_ENFORCE))
			return -EACCES;
		if (file->f_mode & FMODE_WRITE)
			set_bit(IMA_UPDATE_XATTR, &iint->atomic_flags);
	}
450
	return 0;
451 452 453 454 455 456 457 458 459 460
}

/**
 * ima_file_mmap - based on policy, collect/store measurement.
 * @file: pointer to the file to be measured (May be NULL)
 * @prot: contains the protection that will be applied by the kernel.
 *
 * Measure files being mmapped executable based on the ima_must_measure()
 * policy decision.
 *
461 462
 * On success return 0.  On integrity appraisal error, assuming the file
 * is in policy and IMA-appraisal is in enforcing mode, return -EACCES.
463 464 465
 */
int ima_file_mmap(struct file *file, unsigned long prot)
{
466 467 468 469 470
	u32 secid;

	if (file && (prot & PROT_EXEC)) {
		security_task_getsecid(current, &secid);
		return process_measurement(file, current_cred(), secid, NULL,
471
					   0, MAY_EXEC, MMAP_CHECK);
472 473
	}

474
	return 0;
475 476
}

477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502
/**
 * ima_file_mprotect - based on policy, limit mprotect change
 * @prot: contains the protection that will be applied by the kernel.
 *
 * Files can be mmap'ed read/write and later changed to execute to circumvent
 * IMA's mmap appraisal policy rules.  Due to locking issues (mmap semaphore
 * would be taken before i_mutex), files can not be measured or appraised at
 * this point.  Eliminate this integrity gap by denying the mprotect
 * PROT_EXECUTE change, if an mmap appraise policy rule exists.
 *
 * On mprotect change success, return 0.  On failure, return -EACESS.
 */
int ima_file_mprotect(struct vm_area_struct *vma, unsigned long prot)
{
	struct ima_template_desc *template;
	struct file *file = vma->vm_file;
	char filename[NAME_MAX];
	char *pathbuf = NULL;
	const char *pathname = NULL;
	struct inode *inode;
	int result = 0;
	int action;
	u32 secid;
	int pcr;

	/* Is mprotect making an mmap'ed file executable? */
M
Mimi Zohar 已提交
503 504
	if (!(ima_policy_flag & IMA_APPRAISE) || !vma->vm_file ||
	    !(prot & PROT_EXEC) || (vma->vm_flags & VM_EXEC))
505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528
		return 0;

	security_task_getsecid(current, &secid);
	inode = file_inode(vma->vm_file);
	action = ima_get_action(inode, current_cred(), secid, MAY_EXEC,
				MMAP_CHECK, &pcr, &template, 0);

	/* Is the mmap'ed file in policy? */
	if (!(action & (IMA_MEASURE | IMA_APPRAISE_SUBMASK)))
		return 0;

	if (action & IMA_APPRAISE_SUBMASK)
		result = -EPERM;

	file = vma->vm_file;
	pathname = ima_d_path(&file->f_path, &pathbuf, filename);
	integrity_audit_msg(AUDIT_INTEGRITY_DATA, inode, pathname,
			    "collect_data", "failed-mprotect", result, 0);
	if (pathbuf)
		__putname(pathbuf);

	return result;
}

529 530 531 532 533 534 535 536 537 538
/**
 * ima_bprm_check - based on policy, collect/store measurement.
 * @bprm: contains the linux_binprm structure
 *
 * The OS protects against an executable file, already open for write,
 * from being executed in deny_write_access() and an executable file,
 * already open for execute, from being modified in get_write_access().
 * So we can be certain that what we verify and measure here is actually
 * what is being executed.
 *
539 540
 * On success return 0.  On integrity appraisal error, assuming the file
 * is in policy and IMA-appraisal is in enforcing mode, return -EACCES.
541 542 543
 */
int ima_bprm_check(struct linux_binprm *bprm)
{
544 545 546 547 548
	int ret;
	u32 secid;

	security_task_getsecid(current, &secid);
	ret = process_measurement(bprm->file, current_cred(), secid, NULL, 0,
549
				  MAY_EXEC, BPRM_CHECK);
550 551 552 553 554
	if (ret)
		return ret;

	security_cred_getsecid(bprm->cred, &secid);
	return process_measurement(bprm->file, bprm->cred, secid, NULL, 0,
555
				   MAY_EXEC, CREDS_CHECK);
556 557
}

M
Mimi Zohar 已提交
558 559 560
/**
 * ima_path_check - based on policy, collect/store measurement.
 * @file: pointer to the file to be measured
L
Lans Zhang 已提交
561
 * @mask: contains MAY_READ, MAY_WRITE, MAY_EXEC or MAY_APPEND
M
Mimi Zohar 已提交
562 563 564
 *
 * Measure files based on the ima_must_measure() policy decision.
 *
565 566
 * On success return 0.  On integrity appraisal error, assuming the file
 * is in policy and IMA-appraisal is in enforcing mode, return -EACCES.
M
Mimi Zohar 已提交
567
 */
568
int ima_file_check(struct file *file, int mask)
M
Mimi Zohar 已提交
569
{
570
	u32 secid;
571
	int rc;
572 573

	security_task_getsecid(current, &secid);
574 575 576 577 578 579
	rc = process_measurement(file, current_cred(), secid, NULL, 0,
				 mask & (MAY_READ | MAY_WRITE | MAY_EXEC |
					 MAY_APPEND), FILE_CHECK);
	if (ima_current_is_parser() && !rc)
		ima_check_measured_appraised(file);
	return rc;
M
Mimi Zohar 已提交
580
}
581
EXPORT_SYMBOL_GPL(ima_file_check);
M
Mimi Zohar 已提交
582

583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618
/**
 * ima_file_hash - return the stored measurement if a file has been hashed and
 * is in the iint cache.
 * @file: pointer to the file
 * @buf: buffer in which to store the hash
 * @buf_size: length of the buffer
 *
 * On success, return the hash algorithm (as defined in the enum hash_algo).
 * If buf is not NULL, this function also outputs the hash into buf.
 * If the hash is larger than buf_size, then only buf_size bytes will be copied.
 * It generally just makes sense to pass a buffer capable of holding the largest
 * possible hash: IMA_MAX_DIGEST_SIZE.
 * The file hash returned is based on the entire file, including the appended
 * signature.
 *
 * If IMA is disabled or if no measurement is available, return -EOPNOTSUPP.
 * If the parameters are incorrect, return -EINVAL.
 */
int ima_file_hash(struct file *file, char *buf, size_t buf_size)
{
	struct inode *inode;
	struct integrity_iint_cache *iint;
	int hash_algo;

	if (!file)
		return -EINVAL;

	if (!ima_policy_flag)
		return -EOPNOTSUPP;

	inode = file_inode(file);
	iint = integrity_iint_find(inode);
	if (!iint)
		return -EOPNOTSUPP;

	mutex_lock(&iint->mutex);
619 620 621 622 623 624 625 626 627 628

	/*
	 * ima_file_hash can be called when ima_collect_measurement has still
	 * not been called, we might not always have a hash.
	 */
	if (!iint->ima_hash) {
		mutex_unlock(&iint->mutex);
		return -EOPNOTSUPP;
	}

629 630 631 632 633 634 635 636 637 638 639 640 641
	if (buf) {
		size_t copied_size;

		copied_size = min_t(size_t, iint->ima_hash->length, buf_size);
		memcpy(buf, iint->ima_hash->digest, copied_size);
	}
	hash_algo = iint->ima_hash->algo;
	mutex_unlock(&iint->mutex);

	return hash_algo;
}
EXPORT_SYMBOL_GPL(ima_file_hash);

642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668
/**
 * ima_post_create_tmpfile - mark newly created tmpfile as new
 * @file : newly created tmpfile
 *
 * No measuring, appraising or auditing of newly created tmpfiles is needed.
 * Skip calling process_measurement(), but indicate which newly, created
 * tmpfiles are in policy.
 */
void ima_post_create_tmpfile(struct inode *inode)
{
	struct integrity_iint_cache *iint;
	int must_appraise;

	must_appraise = ima_must_appraise(inode, MAY_ACCESS, FILE_CHECK);
	if (!must_appraise)
		return;

	/* Nothing to do if we can't allocate memory */
	iint = integrity_inode_get(inode);
	if (!iint)
		return;

	/* needed for writing the security xattrs */
	set_bit(IMA_UPDATE_XATTR, &iint->atomic_flags);
	iint->ima_file_status = INTEGRITY_PASS;
}

669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685
/**
 * ima_post_path_mknod - mark as a new inode
 * @dentry: newly created dentry
 *
 * Mark files created via the mknodat syscall as new, so that the
 * file data can be written later.
 */
void ima_post_path_mknod(struct dentry *dentry)
{
	struct integrity_iint_cache *iint;
	struct inode *inode = dentry->d_inode;
	int must_appraise;

	must_appraise = ima_must_appraise(inode, MAY_ACCESS, FILE_CHECK);
	if (!must_appraise)
		return;

686
	/* Nothing to do if we can't allocate memory */
687
	iint = integrity_inode_get(inode);
688 689 690 691 692
	if (!iint)
		return;

	/* needed for re-opening empty files */
	iint->flags |= IMA_NEW_FILE;
693 694
}

695 696 697 698
/**
 * ima_read_file - pre-measure/appraise hook decision based on policy
 * @file: pointer to the file to be measured/appraised/audit
 * @read_id: caller identifier
699
 * @contents: whether a subsequent call will be made to ima_post_read_file()
700 701 702 703 704 705 706
 *
 * Permit reading a file based on policy. The policy rules are written
 * in terms of the policy identifier.  Appraising the integrity of
 * a file requires a file descriptor.
 *
 * For permission return 0, otherwise return -EACCES.
 */
707 708
int ima_read_file(struct file *file, enum kernel_read_file_id read_id,
		  bool contents)
709
{
710 711
	enum ima_hooks func;
	u32 secid;
712

713 714 715 716
	/*
	 * Do devices using pre-allocated memory run the risk of the
	 * firmware being accessible to the device prior to the completion
	 * of IMA's signature verification any more than when using two
717 718
	 * buffers? It may be desirable to include the buffer address
	 * in this API and walk all the dma_map_single() mappings to check.
719
	 */
720 721 722 723 724 725 726 727 728 729 730 731 732 733

	/*
	 * There will be a call made to ima_post_read_file() with
	 * a filled buffer, so we don't need to perform an extra
	 * read early here.
	 */
	if (contents)
		return 0;

	/* Read entire file for all partial reads. */
	func = read_idmap[read_id] ?: FILE_CHECK;
	security_task_getsecid(current, &secid);
	return process_measurement(file, current_cred(), secid, NULL,
				   0, MAY_READ, func);
734 735
}

736
const int read_idmap[READING_MAX_ID] = {
737 738 739 740
	[READING_FIRMWARE] = FIRMWARE_CHECK,
	[READING_MODULE] = MODULE_CHECK,
	[READING_KEXEC_IMAGE] = KEXEC_KERNEL_CHECK,
	[READING_KEXEC_INITRAMFS] = KEXEC_INITRAMFS_CHECK,
741 742
	[READING_POLICY] = POLICY_CHECK,
	[READING_DIGEST_LIST] = DIGEST_LIST_CHECK
743 744
};

745 746 747 748 749 750 751 752 753 754 755 756 757 758 759 760
/**
 * ima_post_read_file - in memory collect/appraise/audit measurement
 * @file: pointer to the file to be measured/appraised/audit
 * @buf: pointer to in memory file contents
 * @size: size of in memory file contents
 * @read_id: caller identifier
 *
 * Measure/appraise/audit in memory file based on policy.  Policy rules
 * are written in terms of a policy identifier.
 *
 * On success return 0.  On integrity appraisal error, assuming the file
 * is in policy and IMA-appraisal is in enforcing mode, return -EACCES.
 */
int ima_post_read_file(struct file *file, void *buf, loff_t size,
		       enum kernel_read_file_id read_id)
{
761
	enum ima_hooks func;
762
	u32 secid;
763

764 765 766 767
	/* permit signed certs */
	if (!file && read_id == READING_X509_CERTIFICATE)
		return 0;

768 769 770 771 772 773
	if (!file || !buf || size == 0) { /* should never happen */
		if (ima_appraise & IMA_APPRAISE_ENFORCE)
			return -EACCES;
		return 0;
	}

774
	func = read_idmap[read_id] ?: FILE_CHECK;
775 776
	security_task_getsecid(current, &secid);
	return process_measurement(file, current_cred(), secid, buf, size,
777
				   MAY_READ, func);
778 779
}

780 781 782
/**
 * ima_load_data - appraise decision based on policy
 * @id: kernel load data caller identifier
783 784
 * @contents: whether the full contents will be available in a later
 *	      call to ima_post_load_data().
785 786 787 788 789 790 791
 *
 * Callers of this LSM hook can not measure, appraise, or audit the
 * data provided by userspace.  Enforce policy rules requring a file
 * signature (eg. kexec'ed kernel image).
 *
 * For permission return 0, otherwise return -EACCES.
 */
792
int ima_load_data(enum kernel_load_data_id id, bool contents)
793
{
794
	bool ima_enforce, sig_enforce;
795

796 797
	ima_enforce =
		(ima_appraise & IMA_APPRAISE_ENFORCE) == IMA_APPRAISE_ENFORCE;
798 799 800

	switch (id) {
	case LOADING_KEXEC_IMAGE:
801
		if (IS_ENABLED(CONFIG_KEXEC_SIG)
802 803 804 805 806 807
		    && arch_ima_get_secureboot()) {
			pr_err("impossible to appraise a kernel image without a file descriptor; try using kexec_file_load syscall.\n");
			return -EACCES;
		}

		if (ima_enforce && (ima_appraise & IMA_APPRAISE_KEXEC)) {
808 809 810
			pr_err("impossible to appraise a kernel image without a file descriptor; try using kexec_file_load syscall.\n");
			return -EACCES;	/* INTEGRITY_UNKNOWN */
		}
811 812
		break;
	case LOADING_FIRMWARE:
813
		if (ima_enforce && (ima_appraise & IMA_APPRAISE_FIRMWARE) && !contents) {
814 815 816
			pr_err("Prevent firmware sysfs fallback loading.\n");
			return -EACCES;	/* INTEGRITY_UNKNOWN */
		}
817 818 819 820
		break;
	case LOADING_MODULE:
		sig_enforce = is_module_sig_enforced();

821 822
		if (ima_enforce && (!sig_enforce
				    && (ima_appraise & IMA_APPRAISE_MODULES))) {
823 824 825
			pr_err("impossible to appraise a module without a file descriptor. sig_enforce kernel parameter might help\n");
			return -EACCES;	/* INTEGRITY_UNKNOWN */
		}
826 827 828 829 830 831
	default:
		break;
	}
	return 0;
}

832 833 834 835 836 837 838 839 840 841 842 843 844 845 846 847 848
/**
 * ima_post_load_data - appraise decision based on policy
 * @buf: pointer to in memory file contents
 * @size: size of in memory file contents
 * @id: kernel load data caller identifier
 * @description: @id-specific description of contents
 *
 * Measure/appraise/audit in memory buffer based on policy.  Policy rules
 * are written in terms of a policy identifier.
 *
 * On success return 0.  On integrity appraisal error, assuming the file
 * is in policy and IMA-appraisal is in enforcing mode, return -EACCES.
 */
int ima_post_load_data(char *buf, loff_t size,
		       enum kernel_load_data_id load_id,
		       char *description)
{
849 850 851 852 853 854 855 856 857
	if (load_id == LOADING_FIRMWARE) {
		if ((ima_appraise & IMA_APPRAISE_FIRMWARE) &&
		    (ima_appraise & IMA_APPRAISE_ENFORCE)) {
			pr_err("Prevent firmware loading_store.\n");
			return -EACCES; /* INTEGRITY_UNKNOWN */
		}
		return 0;
	}

858 859 860
	return 0;
}

861 862
/*
 * process_buffer_measurement - Measure the buffer to ima log.
863
 * @inode: inode associated with the object being measured (NULL for KEY_CHECK)
864 865 866
 * @buf: pointer to the buffer that needs to be added to the log.
 * @size: size of buffer(in bytes).
 * @eventname: event name to be used for the buffer entry.
867 868
 * @func: IMA hook
 * @pcr: pcr to extend the measurement
869
 * @keyring: keyring name to determine the action to be performed
870 871 872
 *
 * Based on policy, the buffer is measured into the ima log.
 */
873
void process_buffer_measurement(struct inode *inode, const void *buf, int size,
874
				const char *eventname, enum ima_hooks func,
875
				int pcr, const char *keyring)
876 877
{
	int ret = 0;
878
	const char *audit_cause = "ENOMEM";
879 880 881
	struct ima_template_entry *entry = NULL;
	struct integrity_iint_cache iint = {};
	struct ima_event_data event_data = {.iint = &iint,
882 883 884
					    .filename = eventname,
					    .buf = buf,
					    .buf_len = size};
885
	struct ima_template_desc *template = NULL;
886 887 888 889 890 891
	struct {
		struct ima_digest_data hdr;
		char digest[IMA_MAX_DIGEST_SIZE];
	} hash = {};
	int violation = 0;
	int action = 0;
892
	u32 secid;
893

894 895 896
	if (!ima_policy_flag)
		return;

897 898 899 900 901 902 903 904 905
	/*
	 * Both LSM hooks and auxilary based buffer measurements are
	 * based on policy.  To avoid code duplication, differentiate
	 * between the LSM hooks and auxilary buffer measurements,
	 * retrieving the policy rule information only for the LSM hook
	 * buffer measurements.
	 */
	if (func) {
		security_task_getsecid(current, &secid);
906
		action = ima_get_action(inode, current_cred(), secid, 0, func,
907
					&pcr, &template, keyring);
908 909 910 911 912 913 914 915 916 917 918 919 920 921 922 923 924 925 926
		if (!(action & IMA_MEASURE))
			return;
	}

	if (!pcr)
		pcr = CONFIG_IMA_MEASURE_PCR_IDX;

	if (!template) {
		template = lookup_template_desc("ima-buf");
		ret = template_desc_init_fields(template->fmt,
						&(template->fields),
						&(template->num_fields));
		if (ret < 0) {
			pr_err("template %s init failed, result: %d\n",
			       (strlen(template->name) ?
				template->name : template->fmt), ret);
			return;
		}
	}
927 928 929 930 931 932

	iint.ima_hash = &hash.hdr;
	iint.ima_hash->algo = ima_hash_algo;
	iint.ima_hash->length = hash_digest_size[ima_hash_algo];

	ret = ima_calc_buffer_hash(buf, size, iint.ima_hash);
933 934
	if (ret < 0) {
		audit_cause = "hashing_error";
935
		goto out;
936
	}
937

938
	ret = ima_alloc_init_template(&event_data, &entry, template);
939 940
	if (ret < 0) {
		audit_cause = "alloc_entry";
941
		goto out;
942
	}
943

944
	ret = ima_store_template(entry, violation, NULL, buf, pcr, NULL);
945 946
	if (ret < 0) {
		audit_cause = "store_entry";
947
		ima_free_template_entry(entry);
948
	}
949 950

out:
951
	if (ret < 0)
952 953 954
		integrity_audit_message(AUDIT_INTEGRITY_PCR, NULL, eventname,
					func_measure_str(func),
					audit_cause, ret, 0, ret);
955

956 957 958 959 960
	return;
}

/**
 * ima_kexec_cmdline - measure kexec cmdline boot args
961
 * @kernel_fd: file descriptor of the kexec kernel being loaded
962 963 964 965 966
 * @buf: pointer to buffer
 * @size: size of buffer
 *
 * Buffers can only be measured, not appraised.
 */
967
void ima_kexec_cmdline(int kernel_fd, const void *buf, int size)
968
{
969 970 971 972 973 974 975 976 977 978 979 980
	struct fd f;

	if (!buf || !size)
		return;

	f = fdget(kernel_fd);
	if (!f.file)
		return;

	process_buffer_measurement(file_inode(f.file), buf, size,
				   "kexec-cmdline", KEXEC_CMDLINE, 0, NULL);
	fdput(f);
981 982
}

983 984 985 986
static int __init init_ima(void)
{
	int error;

987
	ima_init_template_list();
988
	hash_setup(CONFIG_IMA_DEFAULT_HASH);
989
	error = ima_init();
990 991 992 993 994 995 996 997 998 999

	if (error && strcmp(hash_algo_name[ima_hash_algo],
			    CONFIG_IMA_DEFAULT_HASH) != 0) {
		pr_info("Allocating %s failed, going to use default hash algorithm %s\n",
			hash_algo_name[ima_hash_algo], CONFIG_IMA_DEFAULT_HASH);
		hash_setup_done = 0;
		hash_setup(CONFIG_IMA_DEFAULT_HASH);
		error = ima_init();
	}

1000 1001 1002
	if (error)
		return error;

1003 1004 1005 1006
	error = register_blocking_lsm_notifier(&ima_lsm_policy_notifier);
	if (error)
		pr_warn("Couldn't register LSM notifier, error %d\n", error);

1007
	if (!error)
1008
		ima_update_policy_flag();
1009

1010 1011 1012 1013
	return error;
}

late_initcall(init_ima);	/* Start IMA after the TPM is available */