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.
 */
 
#pragma once

 
#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