s390/uv: Rename find_secret() to uv_find_secret() and publish

JIRA: https://issues.redhat.com/browse/RHEL-113440

commit 933dd21
Author: Harald Freudenberger <freude@linux.ibm.com>
Date:   Thu Apr 24 15:36:15 2025 +0200

    s390/uv: Rename find_secret() to uv_find_secret() and publish

    Rename the internal UV function find_secret() to uv_find_secret()
    and publish it as new UV API in-kernel function.

    The pkey uv handler may be called in a do-not-allocate memory
    situation where sleeping is allowed but allocating memory which
    may cause IO operations is not. For example when an encrypted
    swap file is used and the encryption is done via UV retrievable
    secrets with protected keys.

    The UV API function uv_get_secret_metadata() allocates memory
    and then calls the find_secret() function. By exposing the
    find_secret() function as a new UV API function uv_find_secret()
    it is possible to retrieve UV secret meta data without any
    memory allocations from the UV when the caller offers space
    for one struct uv_secret_list.

    Signed-off-by: Harald Freudenberger <freude@linux.ibm.com>
    Reviewed-by: Steffen Eiden <seiden@linux.ibm.com>
    Acked-by: Holger Dengler <dengler@linux.ibm.com>
    Link: https://lore.kernel.org/r/20250424133619.16495-22-freude@linux.ibm.com
    Signed-off-by: Heiko Carstens <hca@linux.ibm.com>

Signed-off-by: Thomas Huth <thuth@redhat.com>

Author: huth

arch/s390/include/asm/uv.h

@@ -616,6 +616,9 @@ static inline int uv_remove_shared(unsigned long addr)
 	return share(addr, UVC_CMD_REMOVE_SHARED_ACCESS);
 }
 
+int uv_find_secret(const u8 secret_id[UV_SECRET_ID_LEN],
+		   struct uv_secret_list *list,
+		   struct uv_secret_list_item_hdr *secret);
 int uv_get_secret_metadata(const u8 secret_id[UV_SECRET_ID_LEN],
 			   struct uv_secret_list_item_hdr *secret);
 int uv_retrieve_secret(u16 secret_idx, u8 *buf, size_t buf_size);

arch/s390/kernel/uv.c

@@ -841,7 +841,12 @@ static int __init uv_sysfs_init(void)
 device_initcall(uv_sysfs_init);
 
 /*
- * Find the secret with the secret_id in the provided list.
+ * Locate a secret in the list by its id.
+ * @secret_id: search pattern.
+ * @list: ephemeral buffer space
+ * @secret: output data, containing the secret's metadata.
+ *
+ * Search for a secret with the given secret_id in the Ultravisor secret store.
  *
  * Context: might sleep.
  */
@@ -862,12 +867,15 @@ static int find_secret_in_page(const u8 secret_id[UV_SECRET_ID_LEN],
 
 /*
  * Do the actual search for `uv_get_secret_metadata`.
+ * @secret_id: search pattern.
+ * @list: ephemeral buffer space
+ * @secret: output data, containing the secret's metadata.
  *
  * Context: might sleep.
  */
-static int find_secret(const u8 secret_id[UV_SECRET_ID_LEN],
-		       struct uv_secret_list *list,
-		       struct uv_secret_list_item_hdr *secret)
+int uv_find_secret(const u8 secret_id[UV_SECRET_ID_LEN],
+		   struct uv_secret_list *list,
+		   struct uv_secret_list_item_hdr *secret)
 {
 	u16 start_idx = 0;
 	u16 list_rc;
@@ -889,6 +897,7 @@ static int find_secret(const u8 secret_id[UV_SECRET_ID_LEN],
 
 	return -ENOENT;
 }
+EXPORT_SYMBOL_GPL(uv_find_secret);
 
 /**
  * uv_get_secret_metadata() - get secret metadata for a given secret id.
@@ -914,7 +923,7 @@ int uv_get_secret_metadata(const u8 secret_id[UV_SECRET_ID_LEN],
 	buf = kzalloc(sizeof(*buf), GFP_KERNEL);
 	if (!buf)
 		return -ENOMEM;
-	rc = find_secret(secret_id, buf, secret);
+	rc = uv_find_secret(secret_id, buf, secret);
 	kfree(buf);
 	return rc;
 }