psa_crypto_se_management.h

Go to the documentation of this file.

/*
 * Copyright (C) 2021 HAW Hamburg
 *
 * This file is subject to the terms and conditions of the GNU Lesser
 * General Public License v2.1. See the file LICENSE in the top level
 * directory for more details.
 */
 
#ifndef PSA_CRYPTO_SE_MANAGEMENT_H
#define PSA_CRYPTO_SE_MANAGEMENT_H
 
#ifdef __cplusplus
extern "C" {
#endif
 
#include "psa/crypto.h"
#include "psa_crypto_se_driver.h"
 
#ifndef CONFIG_PSA_MAX_SE_COUNT
#define CONFIG_PSA_MAX_SE_COUNT     (1)
#endif /* CONFIG_PSA_MAX_SE_COUNT */
 
#define PSA_MAX_SE_COUNT    (CONFIG_PSA_MAX_SE_COUNT)
 
typedef struct {
    void * persistent_data;  
    size_t persistent_data_size;    
    uintptr_t transient_data;       
} psa_drv_se_internal_context_t;
 
struct psa_se_drv_data_s {
    psa_key_location_t location;    
    const psa_drv_se_t *methods;    
    union {
        psa_drv_se_internal_context_t internal; 
        psa_drv_se_context_t context;           
    } ctx;                                        
};
 
typedef struct psa_se_drv_data_s psa_se_drv_data_t;
 
psa_status_t psa_register_secure_element(psa_key_location_t location,
                                         const psa_drv_se_t *methods,
                                         void *psa_se_configuration,
                                         const void *drv_transient_data);
 
psa_se_drv_data_t *psa_get_se_driver_data(psa_key_lifetime_t lifetime);
 
int psa_get_se_driver(  psa_key_lifetime_t lifetime,
                        const psa_drv_se_t **p_methods,
                        psa_drv_se_context_t **p_drv_context);
 
const psa_drv_se_t *psa_get_se_driver_methods(const psa_se_drv_data_t *driver);
 
psa_drv_se_context_t *psa_get_se_drv_context(psa_se_drv_data_t *driver);
 
psa_status_t psa_find_free_se_slot( const psa_key_attributes_t *attributes,
                                    psa_key_creation_method_t method,
                                    psa_se_drv_data_t *driver,
                                    psa_key_slot_number_t *slot_number);
 
psa_status_t psa_destroy_se_key(psa_se_drv_data_t *driver,
                                psa_key_slot_number_t slot_number);
 
psa_status_t psa_load_se_persistent_data(const psa_se_drv_data_t *driver);
 
psa_status_t psa_save_se_persistent_data(const psa_se_drv_data_t *driver);
 
psa_status_t psa_destroy_se_persistent_data(psa_key_location_t location);
 
#ifdef __cplusplus
}
#endif
 
#endif /* PSA_CRYPTO_SE_MANAGEMENT_H */