aes_key.h

Go to the documentation of this file.

/*
 * Copyright IBM Corp. 2021
 *
 * libzpc is free software; you can redistribute it and/or modify
 * it under the terms of the MIT license. See LICENSE for details.
 */
 
#ifndef ZPC_AES_KEY_H
# define ZPC_AES_KEY_H
# ifdef __cplusplus
/* *INDENT-OFF* */
extern "C" {
/* *INDENT-ON* */
# endif

 
# include <stddef.h>
 
/*
 * These constants match with kernel's pkey.h, enum pkey_key_type.
 */
# define ZPC_AES_KEY_TYPE_CCA_DATA     1
# define ZPC_AES_KEY_TYPE_CCA_CIPHER   2
# define ZPC_AES_KEY_TYPE_EP11         3
# define ZPC_AES_KEY_TYPE_PVSECRET     9 
 
# define ZPC_AES_KEY_REENCIPHER_OLD_TO_CURRENT    1
# define ZPC_AES_KEY_REENCIPHER_CURRENT_TO_NEW    2
 
typedef enum {
    ZPC_AES_SECRET_TYPE_NOT_SET = -2,
    ZPC_AES_SECRET_TYPE_INVALID = -1,
    ZPC_AES_SECRET_AES_128 = 0x04, /* architected key types, also below */
    ZPC_AES_SECRET_AES_192 = 0x05,
    ZPC_AES_SECRET_AES_256 = 0x06,
} zpc_aessecret_type_t;
 
struct zpc_aes_key;

__attribute__((visibility("default")))
int zpc_aes_key_alloc(struct zpc_aes_key **key);
__attribute__((visibility("default")))
int zpc_aes_key_set_size(struct zpc_aes_key *key, int size);
__attribute__((visibility("default")))
int zpc_aes_key_set_type(struct zpc_aes_key *key, int type);
__attribute__((visibility("default")))
int zpc_aes_key_set_flags(struct zpc_aes_key *key, unsigned int flags);
__attribute__((visibility("default")))
int zpc_aes_key_set_mkvp(struct zpc_aes_key *key, const char *mkvp);
__attribute__((visibility("default")))
int zpc_aes_key_set_apqns(struct zpc_aes_key *key, const char *apqns[]);
__attribute__((visibility("default")))
int zpc_aes_key_import(struct zpc_aes_key *key, const unsigned char *seckey,
    size_t seckeylen);
__attribute__((visibility("default")))
int zpc_aes_key_import_clear(struct zpc_aes_key *key,
    const unsigned char *clrkey);
__attribute__((visibility("default")))
int zpc_aes_key_export(struct zpc_aes_key *key, unsigned char *seckey,
    size_t *seckeylen);
__attribute__((visibility("default")))
int zpc_aes_key_generate(struct zpc_aes_key *key);
__attribute__((visibility("default")))
int zpc_aes_key_reencipher(struct zpc_aes_key *key, int reenc);
__attribute__((visibility("default")))
void zpc_aes_key_free(struct zpc_aes_key **key);
 
# ifdef __cplusplus
/* *INDENT-OFF* */
}
/* *INDENT-ON* */
# endif
#endif