[PATCH v5 11/14] digest cache: Prefetch digest lists if requested
Roberto Sassu
roberto.sassu at huaweicloud.com
Thu Sep 5 15:05:40 UTC 2024
From: Roberto Sassu <roberto.sassu at huawei.com>
A desirable goal when doing integrity measurements is that they are done
always in the same order across boots, so that the resulting PCR value
becomes predictable and suitable for sealing policies. However, due to
parallel execution of system services at boot, a deterministic order of
measurements is difficult to achieve.
The Integrity Digest Cache is not exempted from this issue. If callers
of digest_cache_get() pass inodes in an unpredictable order, this very
likely will result in reading digest lists in an unpredictable order too.
Overcome this issue by introducing digest_cache_dir_prefetch() and
digest_cache_dir_lookup_filename(), to sequentially search the digest list
the digest cache will be populated from in the parent directory, instead
of directly accessing it from the full path.
If during the file name search there is no match, read the digest list to
trigger its measurement (if an appropriate policy exists). If there is a
match, attempt to create and initialize the digest cache from the found
file name.
This ensures that measurements are always done in the same order as the
file names stored in the digest cache of the parent directory, regardless
of which digest list was requested. However, the PCR still changes every
time a not yet read digest list is requested. In any case, the possible PCR
values are more manageable than in the unpredictable file access case, at
most the number of digest lists. Of course, PCR values further change when
digest lists are added/removed to/from the parent directory.
The prefetching mechanism has been designed to be more like a aid to get
predictable measurements, and assumes that digest lists remain the same
over the time. Thus, it can fail in presence of concurrent VFS operations
changing the inode the digest cache is created from. That does not affect
the digest cache creation/initialization done by digest_cache_get(), since
the digest cache holds a path reference until it is fully initialized.
Prefetching is enabled by setting the newly introduced
'security.dig_prefetch' xattr to '1'. digest_cache_new() and
digest_cache_dir_create() call digest_cache_prefetch_requested() to check
it. They pass the check result to digest_cache_create(), which in turn sets
the DIR_PREFETCH and FILE_PREFETCH bit respectively in the parent directory
and regular file digest cache.
On subsequent calls to digest_cache_prefetch_requested(), the latter can
just test for DIR_PREFETCH bit (faster).
digest_cache_get(), after digest cache creation, checks if the digest cache
has the FILE_PREFETCH bit set and, if yes, calls
digest_cache_dir_prefetch() to do prefetching. For just reading digest
lists, digest_cache_dir_prefetch() asks digest_cache_create() to create
special digest caches with the FILE_READ bit set, so that
digest_cache_populate() does not attempt to extract digests.
Signed-off-by: Roberto Sassu <roberto.sassu at huawei.com>
---
include/uapi/linux/xattr.h | 3 +
security/integrity/digest_cache/dir.c | 122 ++++++++++++++++++++-
security/integrity/digest_cache/internal.h | 12 +-
security/integrity/digest_cache/main.c | 91 ++++++++++++++-
security/integrity/digest_cache/populate.c | 9 +-
security/integrity/digest_cache/verif.c | 4 +
6 files changed, 233 insertions(+), 8 deletions(-)
diff --git a/include/uapi/linux/xattr.h b/include/uapi/linux/xattr.h
index 8a58cf4bce65..8af33d38d9e8 100644
--- a/include/uapi/linux/xattr.h
+++ b/include/uapi/linux/xattr.h
@@ -57,6 +57,9 @@
#define XATTR_DIGEST_LIST_SUFFIX "digest_list"
#define XATTR_NAME_DIGEST_LIST XATTR_SECURITY_PREFIX XATTR_DIGEST_LIST_SUFFIX
+#define XATTR_DIG_PREFETCH_SUFFIX "dig_prefetch"
+#define XATTR_NAME_DIG_PREFETCH XATTR_SECURITY_PREFIX XATTR_DIG_PREFETCH_SUFFIX
+
#define XATTR_SELINUX_SUFFIX "selinux"
#define XATTR_NAME_SELINUX XATTR_SECURITY_PREFIX XATTR_SELINUX_SUFFIX
diff --git a/security/integrity/digest_cache/dir.c b/security/integrity/digest_cache/dir.c
index f0a2cb9618ba..12d6af13d49e 100644
--- a/security/integrity/digest_cache/dir.c
+++ b/security/integrity/digest_cache/dir.c
@@ -55,6 +55,7 @@ static bool digest_cache_dir_iter(struct dir_context *__ctx, const char *name,
new_entry->seq_num = UINT_MAX;
new_entry->digest_cache = NULL;
mutex_init(&new_entry->digest_cache_mutex);
+ new_entry->prefetched = false;
if (new_entry->name[0] < '0' || new_entry->name[0] > '9')
goto out;
@@ -133,6 +134,11 @@ int digest_cache_dir_add_entries(struct digest_cache *digest_cache,
* created/obtained from, so that the caller can use it to perform lookup
* operations.
*
+ * Before creating the digest cache, this function first calls
+ * digest_cache_prefetch_requested() to check if prefetching has been requested
+ * on the directory, and passes the result to digest_cache_create(), so that the
+ * latter sets the DIR_PREFETCH bit in the directory digest cache.
+ *
* Return: A directory digest cache on success, NULL otherwise.
*/
static struct digest_cache *
@@ -140,6 +146,7 @@ digest_cache_dir_create(struct dentry *dentry, struct path *digest_list_path,
char *path_str)
{
struct digest_cache *digest_cache;
+ bool prefetch_req;
int ret;
ret = kern_path(path_str, 0, digest_list_path);
@@ -148,8 +155,11 @@ digest_cache_dir_create(struct dentry *dentry, struct path *digest_list_path,
return NULL;
}
+ prefetch_req = digest_cache_prefetch_requested(digest_list_path,
+ path_str);
+
digest_cache = digest_cache_create(dentry, digest_list_path, path_str,
- "");
+ "", prefetch_req, false);
if (digest_cache)
digest_cache = digest_cache_init(dentry, digest_cache);
@@ -220,7 +230,8 @@ uintptr_t digest_cache_dir_lookup_digest(struct dentry *dentry,
if (!dir_entry->digest_cache) {
cache = digest_cache_create(dentry, &digest_list_path,
dir_cache->path_str,
- dir_entry->name);
+ dir_entry->name, false,
+ false);
if (cache)
cache = digest_cache_init(dentry, cache);
@@ -232,6 +243,8 @@ uintptr_t digest_cache_dir_lookup_digest(struct dentry *dentry,
/* Consume extra ref. from digest_cache_create(). */
dir_entry->digest_cache = cache;
+ /* Digest list was read, mark entry as prefetched. */
+ dir_entry->prefetched = true;
}
mutex_unlock(&dir_entry->digest_cache_mutex);
@@ -251,6 +264,111 @@ uintptr_t digest_cache_dir_lookup_digest(struct dentry *dentry,
return (uintptr_t)found;
}
+/**
+ * digest_cache_dir_lookup_filename - Lookup a digest list
+ * @dentry: Dentry of the file whose digest list is looked up
+ * @digest_list_path: Path structure of the digest list directory
+ * @digest_cache: Dir digest cache
+ * @filename: File name of the digest list to search
+ *
+ * This function iterates over the linked list created by
+ * digest_cache_dir_add_entries() and looks up a digest list with a matching
+ * file name among the entries. If there is no match, it prefetches (reads) the
+ * current digest list. Otherwise, it creates and initializes a new digest
+ * cache.
+ *
+ * The new digest cache is not returned, since it might have been created from
+ * a different inode than the one originally found during digest_cache_create().
+ *
+ * If it is the right one, digest_cache_init() called from digest_cache_get()
+ * will go ahead and simply use the initialized digest cache. If for any reason
+ * the inode was different, digest_cache_init() will perform a full
+ * initialization of the requested digest cache.
+ */
+static void digest_cache_dir_lookup_filename(struct dentry *dentry,
+ struct path *digest_list_path,
+ struct digest_cache *digest_cache,
+ char *filename)
+{
+ struct digest_cache *cache;
+ struct dir_entry *dir_entry;
+ bool filename_found;
+
+ list_for_each_entry(dir_entry, &digest_cache->dir_entries, list) {
+ mutex_lock(&dir_entry->digest_cache_mutex);
+ filename_found = !strcmp(dir_entry->name, filename);
+ if (!filename_found && dir_entry->prefetched) {
+ mutex_unlock(&dir_entry->digest_cache_mutex);
+ continue;
+ }
+
+ cache = digest_cache_create(dentry, digest_list_path,
+ digest_cache->path_str,
+ dir_entry->name, false,
+ filename_found ? false : true);
+ if (cache)
+ cache = digest_cache_init(dentry, cache);
+
+ if (!filename_found)
+ pr_debug("Digest list %s/%s %s prefetched\n",
+ digest_cache->path_str, dir_entry->name,
+ cache ? "has been" : "cannot be");
+
+ if (cache)
+ digest_cache_put(cache);
+
+ dir_entry->prefetched = true;
+ mutex_unlock(&dir_entry->digest_cache_mutex);
+
+ if (filename_found)
+ break;
+ }
+
+ /* Prefetching done, no need to repeat. */
+ clear_bit(FILE_PREFETCH, &digest_cache->flags);
+}
+
+/**
+ * digest_cache_dir_prefetch - Prefetch digest lists in a directory
+ * @dentry: Dentry of the file whose digest list is looked up
+ * @digest_cache: Digest cache
+ *
+ * This function prefetches digest lists in a directory.
+ *
+ * Return: Zero on success, a POSIX error code otherwise.
+ */
+int digest_cache_dir_prefetch(struct dentry *dentry,
+ struct digest_cache *digest_cache)
+{
+ struct digest_cache *dir_cache;
+ char *path_str, *last;
+ struct path dir_path;
+ int ret = 0;
+
+ last = strrchr(digest_cache->path_str, '/');
+ if (!last)
+ return -EINVAL;
+
+ path_str = kstrndup(digest_cache->path_str,
+ last - digest_cache->path_str, GFP_KERNEL);
+ if (!path_str)
+ return -ENOMEM;
+
+ dir_cache = digest_cache_dir_create(dentry, &dir_path, path_str);
+
+ kfree(path_str);
+
+ if (!dir_cache)
+ return -ENOENT;
+
+ digest_cache_dir_lookup_filename(dentry, &dir_path, dir_cache,
+ last + 1);
+
+ digest_cache_put(dir_cache);
+ path_put(&dir_path);
+ return ret;
+}
+
/**
* digest_cache_dir_free - Free the stored file list and put digest caches
* @digest_cache: Dir digest cache
diff --git a/security/integrity/digest_cache/internal.h b/security/integrity/digest_cache/internal.h
index 34a26576a5aa..c90efdbf51ed 100644
--- a/security/integrity/digest_cache/internal.h
+++ b/security/integrity/digest_cache/internal.h
@@ -18,6 +18,9 @@
#define INIT_STARTED 1 /* Digest cache init started. */
#define INVALID 2 /* Digest cache marked as invalid. */
#define IS_DIR 3 /* Digest cache created from dir. */
+#define DIR_PREFETCH 4 /* Prefetch enabled for dir entries. */
+#define FILE_PREFETCH 5 /* Prefetch enabled for dir entry. */
+#define FILE_READ 6 /* Digest cache for reading file. */
/**
* struct readdir_callback - Structure to store information for dir iteration
@@ -38,6 +41,7 @@ struct readdir_callback {
* @digest_cache: Digest cache associated to the directory entry
* @digest_cache_mutex: Protects @digest_cache
* @seq_num: Sequence number of the directory entry from file name
+ * @prefetched: Whether the digest list has been already prefetched
* @name: File name of the directory entry
*
* This structure represents a directory entry with a digest cache created
@@ -48,6 +52,7 @@ struct dir_entry {
struct digest_cache *digest_cache;
struct mutex digest_cache_mutex;
unsigned int seq_num;
+ bool prefetched;
char name[];
};
@@ -214,7 +219,10 @@ digest_cache_from_file_sec(const struct file *file)
/* main.c */
struct digest_cache *digest_cache_create(struct dentry *dentry,
struct path *digest_list_path,
- char *path_str, char *filename);
+ char *path_str, char *filename,
+ bool prefetch_req, bool prefetch);
+bool digest_cache_prefetch_requested(struct path *digest_list_path,
+ char *path_str);
struct digest_cache *digest_cache_init(struct dentry *dentry,
struct digest_cache *digest_cache);
int __init digest_cache_do_init(const struct lsm_id *lsm_id,
@@ -249,6 +257,8 @@ int digest_cache_dir_add_entries(struct digest_cache *digest_cache,
uintptr_t digest_cache_dir_lookup_digest(struct dentry *dentry,
struct digest_cache *digest_cache,
u8 *digest, enum hash_algo algo);
+int digest_cache_dir_prefetch(struct dentry *dentry,
+ struct digest_cache *digest_cache);
void digest_cache_dir_free(struct digest_cache *digest_cache);
#endif /* _DIGEST_CACHE_INTERNAL_H */
diff --git a/security/integrity/digest_cache/main.c b/security/integrity/digest_cache/main.c
index d050ebad3cbb..e9c3d120b8d4 100644
--- a/security/integrity/digest_cache/main.c
+++ b/security/integrity/digest_cache/main.c
@@ -85,6 +85,8 @@ static void digest_cache_free(struct digest_cache *digest_cache)
* @digest_list_path: Path structure of the digest list
* @path_str: Path string of the digest list
* @filename: Digest list file name (can be an empty string)
+ * @prefetch_req: Whether prefetching has been requested
+ * @prefetch: Whether prefetching of a digest list is being done
*
* This function first locates, from the passed path, the digest list inode
* from which the digest cache will be created or retrieved (if it already
@@ -105,7 +107,8 @@ static void digest_cache_free(struct digest_cache *digest_cache)
*/
struct digest_cache *digest_cache_create(struct dentry *dentry,
struct path *digest_list_path,
- char *path_str, char *filename)
+ char *path_str, char *filename,
+ bool prefetch_req, bool prefetch)
{
struct path file_path;
struct digest_cache *digest_cache = NULL;
@@ -157,6 +160,16 @@ struct digest_cache *digest_cache_create(struct dentry *dentry,
goto out;
}
+ if (prefetch) {
+ digest_cache = digest_cache_alloc_init(path_str, filename);
+ if (digest_cache) {
+ set_bit(FILE_READ, &digest_cache->flags);
+ goto out_set;
+ }
+
+ goto out;
+ }
+
/* Ref. count is already 1 for this reference. */
dig_sec->dig_owner = digest_cache_alloc_init(path_str, filename);
if (!dig_sec->dig_owner) {
@@ -166,10 +179,18 @@ struct digest_cache *digest_cache_create(struct dentry *dentry,
/* Increment ref. count for reference returned to the caller. */
digest_cache = digest_cache_ref(dig_sec->dig_owner);
-
+out_set:
/* Make other digest cache requestors wait until creation complete. */
set_bit(INIT_IN_PROGRESS, &digest_cache->flags);
+ /* Set bit if prefetching was requested. */
+ if (prefetch_req) {
+ if (S_ISREG(inode->i_mode))
+ set_bit(FILE_PREFETCH, &digest_cache->flags);
+ else
+ set_bit(DIR_PREFETCH, &digest_cache->flags);
+ }
+
/* Get the digest list path for initialization. */
digest_cache->digest_list_path.dentry = digest_list_path->dentry;
digest_cache->digest_list_path.mnt = digest_list_path->mnt;
@@ -182,6 +203,52 @@ struct digest_cache *digest_cache_create(struct dentry *dentry,
return digest_cache;
}
+/**
+ * digest_cache_prefetch_requested - Verify if prefetching is requested
+ * @digest_list_path: Path structure of the digest list directory
+ * @path_str: Path string of the digest list directory
+ *
+ * This function verifies whether or not digest list prefetching is requested.
+ * If dig_owner exists in the inode security blob, it checks the DIR_PREFETCH
+ * bit (faster). Otherwise, it reads the security.dig_prefetch xattr.
+ *
+ * Return: True if prefetching is requested, false otherwise.
+ */
+bool digest_cache_prefetch_requested(struct path *digest_list_path,
+ char *path_str)
+{
+ struct digest_cache_security *dig_sec;
+ bool prefetch_req = false;
+ char prefetch_value;
+ struct inode *inode;
+ int ret;
+
+ inode = d_backing_inode(digest_list_path->dentry);
+ dig_sec = digest_cache_get_security(inode);
+ if (unlikely(!dig_sec))
+ return false;
+
+ mutex_lock(&dig_sec->dig_owner_mutex);
+ if (dig_sec->dig_owner) {
+ /* Reliable test: DIR_PREFETCH set with dig_owner_mutex held. */
+ prefetch_req = test_bit(DIR_PREFETCH,
+ &dig_sec->dig_owner->flags);
+ mutex_unlock(&dig_sec->dig_owner_mutex);
+ return prefetch_req;
+ }
+ mutex_unlock(&dig_sec->dig_owner_mutex);
+
+ ret = vfs_getxattr(&nop_mnt_idmap, digest_list_path->dentry,
+ XATTR_NAME_DIG_PREFETCH, &prefetch_value, 1);
+ if (ret == 1 && prefetch_value == '1') {
+ pr_debug("Prefetching has been enabled for directory %s\n",
+ path_str);
+ prefetch_req = true;
+ }
+
+ return prefetch_req;
+}
+
/**
* digest_cache_new - Retrieve digest list file name and request digest cache
* @dentry: Dentry of the inode for which the digest cache will be used
@@ -192,6 +259,12 @@ struct digest_cache *digest_cache_create(struct dentry *dentry,
* with that file name. If security.digest_list is empty or not found, this
* function requests the creation of a digest cache on the parent directory.
*
+ * In either case, this function first calls digest_cache_prefetch_requested()
+ * to check if prefetching has been requested on the parent directory, and
+ * passes the result to digest_cache_create(), so that the latter sets the
+ * FILE_PREFETCH and DIR_PREFETCH bit respectively in the file or directory
+ * digest caches.
+ *
* Return: A digest cache on success, NULL on error.
*/
static struct digest_cache *digest_cache_new(struct dentry *dentry)
@@ -199,6 +272,7 @@ static struct digest_cache *digest_cache_new(struct dentry *dentry)
char filename[NAME_MAX + 1] = { 0 };
struct digest_cache *digest_cache = NULL;
struct path default_path;
+ bool prefetch_req = false;
int ret;
ret = kern_path(default_path_str, 0, &default_path);
@@ -239,8 +313,12 @@ static struct digest_cache *digest_cache_new(struct dentry *dentry)
XATTR_NAME_DIGEST_LIST, dentry->d_name.name, default_path_str,
filename);
create:
+ prefetch_req = digest_cache_prefetch_requested(&default_path,
+ default_path_str);
+
digest_cache = digest_cache_create(dentry, &default_path,
- default_path_str, filename);
+ default_path_str, filename,
+ prefetch_req, false);
out:
path_put(&default_path);
return digest_cache;
@@ -357,9 +435,14 @@ struct digest_cache *digest_cache_get(struct dentry *dentry)
mutex_unlock(&dig_sec->dig_user_mutex);
- if (digest_cache)
+ if (digest_cache) {
+ /* Prefetch, digest cache should be initialized afterwards. */
+ if (test_bit(FILE_PREFETCH, &digest_cache->flags))
+ digest_cache_dir_prefetch(dentry, digest_cache);
+
/* This must be always executed, or path ref. is not released.*/
digest_cache = digest_cache_init(dentry, digest_cache);
+ }
return digest_cache;
}
diff --git a/security/integrity/digest_cache/populate.c b/security/integrity/digest_cache/populate.c
index 1ebf3a11f50b..7360bcf55249 100644
--- a/security/integrity/digest_cache/populate.c
+++ b/security/integrity/digest_cache/populate.c
@@ -11,6 +11,7 @@
#include <linux/init_task.h>
#include <linux/vmalloc.h>
#include <linux/kernel_read_file.h>
+#include <linux/namei.h>
#include "internal.h"
#include "parsers/parsers.h"
@@ -135,6 +136,12 @@ int digest_cache_populate(struct digest_cache *digest_cache,
return ret;
}
+ /* The caller wants just to read digest lists. */
+ if (test_bit(FILE_READ, &digest_cache->flags)) {
+ ret = 0;
+ goto out_vfree;
+ }
+
data_len = digest_cache_strip_modsig(data, ret);
/* Digest list parsers initialize the hash table and add the digests. */
@@ -144,7 +151,7 @@ int digest_cache_populate(struct digest_cache *digest_cache,
if (ret < 0)
pr_debug("Error parsing digest list %s, ret: %d\n",
digest_cache->path_str, ret);
-
+out_vfree:
vfree(data);
return ret;
}
diff --git a/security/integrity/digest_cache/verif.c b/security/integrity/digest_cache/verif.c
index de47bd9dc388..8a8e6483679f 100644
--- a/security/integrity/digest_cache/verif.c
+++ b/security/integrity/digest_cache/verif.c
@@ -44,6 +44,10 @@ int digest_cache_verif_set(struct file *file, const char *verif_id, void *data,
gfp_t flags = !strncmp(verif_id, "kprobe", 6) ? GFP_ATOMIC : GFP_KERNEL;
int ret = 0;
+ /* Allows us to detect that we are prefetching in the tests. */
+ if (test_bit(FILE_READ, &digest_cache->flags))
+ return -ENOENT;
+
new_verif = kzalloc(sizeof(*new_verif), flags);
if (!new_verif)
return -ENOMEM;
--
2.34.1
More information about the Linux-security-module-archive
mailing list