SE driver lookup functions
Expose the type of an entry in the SE driver table as an opaque type
to other library modules. Soon, driver table entries will have state,
and callers will need to be able to access this state through
functions using this opaque type.
Provide functions to look up a driver by its lifetime and to retrieve
the method table from an entry.
diff --git a/library/psa_crypto_se.h b/library/psa_crypto_se.h
index e99bd25..88b0127 100644
--- a/library/psa_crypto_se.h
+++ b/library/psa_crypto_se.h
@@ -42,4 +42,42 @@
*/
void psa_unregister_all_se_drivers( void );
+/** A structure that describes a registered secure element driver.
+ *
+ * A secure element driver table entry contains a pointer to the
+ * driver's method table and a pointer to the driver's slot usage
+ * structure.
+ */
+typedef struct psa_se_drv_table_entry_s psa_se_drv_table_entry_t;
+
+/** Return the secure element driver table entry for a lifetime value.
+ *
+ * \param lifetime The lifetime value to query.
+ *
+ * \return The driver table entry for \p lifetime, or
+ * \p NULL if \p lifetime does not correspond to a registered driver.
+ */
+const psa_se_drv_table_entry_t *psa_get_se_driver_entry(
+ psa_key_lifetime_t lifetime );
+
+/** Return the method table for a secure element driver.
+ *
+ * \param[in] drv The driver table entry to access.
+ *
+ * \return The driver table entry for \p lifetime, or
+ * \p NULL if \p lifetime does not correspond to a registered driver.
+ */
+const psa_drv_se_t *psa_get_se_driver_methods(
+ const psa_se_drv_table_entry_t *drv );
+
+/** Return the secure element driver method table for a lifetime value.
+ *
+ * \param lifetime The lifetime value to query.
+ *
+ * \return The driver method table for \p lifetime, or
+ * \p NULL if \p lifetime does not correspond to a registered driver.
+ */
+const psa_drv_se_t *psa_get_se_driver(
+ psa_key_lifetime_t lifetime );
+
#endif /* PSA_CRYPTO_SE_H */