ecc_key.h

Go to the documentation of this file.

/*
 * Copyright IBM Corp. 2022
 *
 * 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_ECC_KEY_H
# define ZPC_ECC_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_EC_KEY_TYPE_CCA                       0x1f
#define ZPC_EC_KEY_TYPE_EP11                      7
#define ZPC_EC_KEY_TYPE_PVSECRET                  9
   
 
#define ZPC_EC_KEY_REENCIPHER_OLD_TO_CURRENT      1
#define ZPC_EC_KEY_REENCIPHER_CURRENT_TO_NEW      2
 
typedef enum {
    ZPC_EC_CURVE_NOT_SET = -2,
    ZPC_EC_CURVE_INVALID = -1,
    ZPC_EC_CURVE_P256 = 0,
    ZPC_EC_CURVE_P384,
    ZPC_EC_CURVE_P521,
    ZPC_EC_CURVE_ED25519,
    ZPC_EC_CURVE_ED448
} zpc_ec_curve_t;
 
typedef enum {
    ZPC_EC_SECRET_TYPE_NOT_SET = -2,
    ZPC_EC_SECRET_TYPE_INVALID = -1,
    ZPC_EC_SECRET_ECDSA_P256 = 0x0011, /* architected key types, also below */
    ZPC_EC_SECRET_ECDSA_P384 = 0x0012,
    ZPC_EC_SECRET_ECDSA_P521 = 0x0013,
    ZPC_EC_SECRET_EDDSA_ED25519 = 0x0014,
    ZPC_EC_SECRET_EDDSA_ED448 = 0x0015,
} zpc_ecsecret_type_t;
 
struct zpc_ec_key;

__attribute__((visibility("default")))
int zpc_ec_key_alloc(struct zpc_ec_key **key);

__attribute__((visibility("default")))
int zpc_ec_key_set_curve(struct zpc_ec_key *key, zpc_ec_curve_t curve);

__attribute__((visibility("default")))
int zpc_ec_key_set_type(struct zpc_ec_key *key, int type);

__attribute__((visibility("default")))
int zpc_ec_key_set_flags(struct zpc_ec_key *key, unsigned int flags);

__attribute__((visibility("default")))
int zpc_ec_key_set_mkvp(struct zpc_ec_key *key, const char *mkvp);

__attribute__((visibility("default")))
int zpc_ec_key_set_apqns(struct zpc_ec_key *key, const char *apqns[]);

__attribute__((visibility("default")))
int zpc_ec_key_import(struct zpc_ec_key *key, const unsigned char *seckey,
                    unsigned int seckeylen);

__attribute__((visibility("default")))
int zpc_ec_key_import_clear(struct zpc_ec_key *key,
                    const unsigned char *pubkey, unsigned int publen,
                    const unsigned char *privkey, unsigned int privlen);

__attribute__((visibility("default")))
int zpc_ec_key_export(struct zpc_ec_key *key, unsigned char *seckey,
                    unsigned int *seckeylen);

__attribute__((visibility("default")))
int zpc_ec_key_export_public(struct zpc_ec_key *key, unsigned char *pubkey,
                    unsigned int *pubkeylen);

__attribute__((visibility("default")))
int zpc_ec_key_generate(struct zpc_ec_key *key);

__attribute__((visibility("default")))
int zpc_ec_key_reencipher(struct zpc_ec_key *key, unsigned int reenc);

__attribute__((visibility("default")))
void zpc_ec_key_free(struct zpc_ec_key **key);
 
# ifdef __cplusplus
/* *INDENT-OFF* */
}
/* *INDENT-ON* */
# endif
#endif