PSA Wrapper Functions: ECC

Detailed Description

Files
file	psa_ecc.h
	Function declarations for low level wrapper functions for ECC operations.

Functions
psa_status_t	psa_generate_ecc_p192r1_key_pair (const psa_key_attributes_t *attributes, uint8_t *priv_key_buffer, uint8_t *pub_key_buffer, size_t *priv_key_buffer_length, size_t *pub_key_buffer_length)
	Low level wrapper function to call a driver for an ECC key generation with a SECP 192 R1 key.
psa_status_t	psa_ecc_p192r1_sign_hash (const psa_key_attributes_t *attributes, psa_algorithm_t alg, const uint8_t *key_buffer, size_t key_buffer_size, const uint8_t *hash, size_t hash_length, uint8_t *signature, size_t signature_size, size_t *signature_length)
	Low level wrapper function to call a driver for an ECC hash signature with a SECP 192 R1 key.
psa_status_t	psa_ecc_p192r1_sign_message (const psa_key_attributes_t *attributes, psa_algorithm_t alg, const uint8_t *key_buffer, size_t key_buffer_size, const uint8_t *input, size_t input_length, uint8_t *signature, size_t signature_size, size_t *signature_length)
	Low level wrapper function to call a driver for an ECC hash signature with a SECP 192 R1 key.
psa_status_t	psa_ecc_p192r1_verify_hash (const psa_key_attributes_t *attributes, psa_algorithm_t alg, const uint8_t *key_buffer, size_t key_buffer_size, const uint8_t *hash, size_t hash_length, const uint8_t *signature, size_t signature_length)
	Low level wrapper function to call a driver for an ECC hash verification with a SECP 192 R1 key.
psa_status_t	psa_ecc_p192r1_verify_message (const psa_key_attributes_t *attributes, psa_algorithm_t alg, const uint8_t *key_buffer, size_t key_buffer_size, const uint8_t *input, size_t input_length, const uint8_t *signature, size_t signature_length)
	Low level wrapper function to call a driver for an ECC hash verification with a SECP 192 R1 key.
psa_status_t	psa_generate_ecc_p256r1_key_pair (const psa_key_attributes_t *attributes, uint8_t *priv_key_buffer, uint8_t *pub_key_buffer, size_t *priv_key_buffer_length, size_t *pub_key_buffer_length)
	Low level wrapper function to call a driver for an ECC key generation with a SECP 192 R1 key.
psa_status_t	psa_ecc_p256r1_sign_hash (const psa_key_attributes_t *attributes, psa_algorithm_t alg, const uint8_t *key_buffer, size_t key_buffer_size, const uint8_t *hash, size_t hash_length, uint8_t *signature, size_t signature_size, size_t *signature_length)
	Low level wrapper function to call a driver for an ECC hash signature with a SECP 256 R1 key.
psa_status_t	psa_ecc_p256r1_sign_message (const psa_key_attributes_t *attributes, psa_algorithm_t alg, const uint8_t *key_buffer, size_t key_buffer_size, const uint8_t *input, size_t input_length, uint8_t *signature, size_t signature_size, size_t *signature_length)
	Low level wrapper function to call a driver for an ECC hash signature with a SECP 256 R1 key.
psa_status_t	psa_ecc_p256r1_verify_hash (const psa_key_attributes_t *attributes, psa_algorithm_t alg, const uint8_t *key_buffer, size_t key_buffer_size, const uint8_t *hash, size_t hash_length, const uint8_t *signature, size_t signature_length)
	Low level wrapper function to call a driver for an ECC hash verification with a SECP 256 R1 key.
psa_status_t	psa_ecc_p256r1_verify_message (const psa_key_attributes_t *attributes, psa_algorithm_t alg, const uint8_t *key_buffer, size_t key_buffer_size, const uint8_t *input, size_t input_length, const uint8_t *signature, size_t signature_length)
	Low level wrapper function to call a driver for an ECC hash verification with a SECP 256 R1 key.
psa_status_t	psa_generate_ecc_ed25519_key_pair (uint8_t *priv_key_buffer, uint8_t *pub_key_buffer, size_t *priv_key_buffer_length, size_t *pub_key_buffer_length)
	Low level wrapper function to call a driver for an ECC key generation with an ed25519 key.
psa_status_t	psa_derive_ecc_ed25519_public_key (const uint8_t *priv_key_buffer, uint8_t *pub_key_buffer, size_t priv_key_buffer_length, size_t *pub_key_buffer_length)
	Low level wrapper function to call a driver for deriving an ed25519 public key from the private key.
psa_status_t	psa_ecc_ed25519_sign_message (const uint8_t *priv_key_buffer, size_t priv_key_buffer_size, const uint8_t *pub_key_buffer, size_t pub_key_buffer_size, const uint8_t *input, size_t input_length, uint8_t *signature, size_t signature_size, size_t *signature_length)
	Low level wrapper function to call a driver for an ECC hash signature with an ed25519 key.
psa_status_t	psa_ecc_ed25519_verify_message (const uint8_t *key_buffer, size_t key_buffer_size, const uint8_t *input, size_t input_length, const uint8_t *signature, size_t signature_length)
	Low level wrapper function to call a driver for an ECC hash verification with a ed25519 key.

Function Documentation

psa_derive_ecc_ed25519_public_key()

psa_status_t psa_derive_ecc_ed25519_public_key	(	const uint8_t *	priv_key_buffer,
		uint8_t *	pub_key_buffer,
		size_t	priv_key_buffer_length,
		size_t *	pub_key_buffer_length
	)

Low level wrapper function to call a driver for deriving an ed25519 public key from the private key.

Parameters

[in]	priv_key_buffer
[out]	pub_key_buffer
[in]	priv_key_buffer_length
[in,out]	pub_key_buffer_length

Returns

psa_status_t

psa_ecc_ed25519_sign_message()

psa_status_t psa_ecc_ed25519_sign_message	(	const uint8_t *	priv_key_buffer,
		size_t	priv_key_buffer_size,
		const uint8_t *	pub_key_buffer,
		size_t	pub_key_buffer_size,
		const uint8_t *	input,
		size_t	input_length,
		uint8_t *	signature,
		size_t	signature_size,
		size_t *	signature_length
	)

Low level wrapper function to call a driver for an ECC hash signature with an ed25519 key.

See psa_sign_message()

Parameters

priv_key_buffer
priv_key_buffer_size
pub_key_buffer
pub_key_buffer_size
input
input_length
signature
signature_size
signature_length

Returns

psa_status_t

psa_ecc_ed25519_verify_message()

psa_status_t psa_ecc_ed25519_verify_message	(	const uint8_t *	key_buffer,
		size_t	key_buffer_size,
		const uint8_t *	input,
		size_t	input_length,
		const uint8_t *	signature,
		size_t	signature_length
	)

Low level wrapper function to call a driver for an ECC hash verification with a ed25519 key.

See psa_verify_message()

Parameters

key_buffer
key_buffer_size
input
input_length
signature
signature_length

Returns

psa_status_t

psa_ecc_p192r1_sign_hash()

psa_status_t psa_ecc_p192r1_sign_hash	(	const psa_key_attributes_t *	attributes,
		psa_algorithm_t	alg,
		const uint8_t *	key_buffer,
		size_t	key_buffer_size,
		const uint8_t *	hash,
		size_t	hash_length,
		uint8_t *	signature,
		size_t	signature_size,
		size_t *	signature_length
	)

Low level wrapper function to call a driver for an ECC hash signature with a SECP 192 R1 key.

See psa_sign_hash()

Parameters

attributes
alg
key_buffer
key_buffer_size
hash
hash_length
signature
signature_size
signature_length

Returns

psa_status_t

psa_ecc_p192r1_sign_message()

psa_status_t psa_ecc_p192r1_sign_message	(	const psa_key_attributes_t *	attributes,
		psa_algorithm_t	alg,
		const uint8_t *	key_buffer,
		size_t	key_buffer_size,
		const uint8_t *	input,
		size_t	input_length,
		uint8_t *	signature,
		size_t	signature_size,
		size_t *	signature_length
	)

Low level wrapper function to call a driver for an ECC hash signature with a SECP 192 R1 key.

See psa_sign_message()

Parameters

attributes
alg
key_buffer
key_buffer_size
input
input_length
signature
signature_size
signature_length

Returns

psa_status_t

psa_ecc_p192r1_verify_hash()

psa_status_t psa_ecc_p192r1_verify_hash	(	const psa_key_attributes_t *	attributes,
		psa_algorithm_t	alg,
		const uint8_t *	key_buffer,
		size_t	key_buffer_size,
		const uint8_t *	hash,
		size_t	hash_length,
		const uint8_t *	signature,
		size_t	signature_length
	)

Low level wrapper function to call a driver for an ECC hash verification with a SECP 192 R1 key.

See psa_verify_hash()

Parameters

attributes
alg
key_buffer
key_buffer_size
hash
hash_length
signature
signature_length

Returns

psa_status_t

psa_ecc_p192r1_verify_message()

psa_status_t psa_ecc_p192r1_verify_message	(	const psa_key_attributes_t *	attributes,
		psa_algorithm_t	alg,
		const uint8_t *	key_buffer,
		size_t	key_buffer_size,
		const uint8_t *	input,
		size_t	input_length,
		const uint8_t *	signature,
		size_t	signature_length
	)

Low level wrapper function to call a driver for an ECC hash verification with a SECP 192 R1 key.

See psa_verify_message()

Parameters

attributes
alg
key_buffer
key_buffer_size
input
input_length
signature
signature_length

Returns

psa_status_t

psa_ecc_p256r1_sign_hash()

psa_status_t psa_ecc_p256r1_sign_hash	(	const psa_key_attributes_t *	attributes,
		psa_algorithm_t	alg,
		const uint8_t *	key_buffer,
		size_t	key_buffer_size,
		const uint8_t *	hash,
		size_t	hash_length,
		uint8_t *	signature,
		size_t	signature_size,
		size_t *	signature_length
	)

Low level wrapper function to call a driver for an ECC hash signature with a SECP 256 R1 key.

See psa_sign_hash()

Parameters

attributes
alg
key_buffer
key_buffer_size
hash
hash_length
signature
signature_size
signature_length

Returns

psa_status_t

psa_ecc_p256r1_sign_message()

psa_status_t psa_ecc_p256r1_sign_message	(	const psa_key_attributes_t *	attributes,
		psa_algorithm_t	alg,
		const uint8_t *	key_buffer,
		size_t	key_buffer_size,
		const uint8_t *	input,
		size_t	input_length,
		uint8_t *	signature,
		size_t	signature_size,
		size_t *	signature_length
	)

Low level wrapper function to call a driver for an ECC hash signature with a SECP 256 R1 key.

See psa_sign_message()

Parameters

attributes
alg
key_buffer
key_buffer_size
input
input_length
signature
signature_size
signature_length

Returns

psa_status_t

psa_ecc_p256r1_verify_hash()

psa_status_t psa_ecc_p256r1_verify_hash	(	const psa_key_attributes_t *	attributes,
		psa_algorithm_t	alg,
		const uint8_t *	key_buffer,
		size_t	key_buffer_size,
		const uint8_t *	hash,
		size_t	hash_length,
		const uint8_t *	signature,
		size_t	signature_length
	)

Low level wrapper function to call a driver for an ECC hash verification with a SECP 256 R1 key.

See psa_verify_hash()

Parameters

attributes
alg
key_buffer
key_buffer_size
hash
hash_length
signature
signature_length

Returns

psa_status_t

psa_ecc_p256r1_verify_message()

psa_status_t psa_ecc_p256r1_verify_message	(	const psa_key_attributes_t *	attributes,
		psa_algorithm_t	alg,
		const uint8_t *	key_buffer,
		size_t	key_buffer_size,
		const uint8_t *	input,
		size_t	input_length,
		const uint8_t *	signature,
		size_t	signature_length
	)

Low level wrapper function to call a driver for an ECC hash verification with a SECP 256 R1 key.

See psa_verify_message()

Parameters

attributes
alg
key_buffer
key_buffer_size
input
input_length
signature
signature_length

Returns

psa_status_t

psa_generate_ecc_ed25519_key_pair()

psa_status_t psa_generate_ecc_ed25519_key_pair	(	uint8_t *	priv_key_buffer,
		uint8_t *	pub_key_buffer,
		size_t *	priv_key_buffer_length,
		size_t *	pub_key_buffer_length
	)

Low level wrapper function to call a driver for an ECC key generation with an ed25519 key.

See psa_generate_key()

Parameters

priv_key_buffer
pub_key_buffer
priv_key_buffer_length
pub_key_buffer_length

Returns

psa_status_t

psa_generate_ecc_p192r1_key_pair()

psa_status_t psa_generate_ecc_p192r1_key_pair	(	const psa_key_attributes_t *	attributes,
		uint8_t *	priv_key_buffer,
		uint8_t *	pub_key_buffer,
		size_t *	priv_key_buffer_length,
		size_t *	pub_key_buffer_length
	)

Low level wrapper function to call a driver for an ECC key generation with a SECP 192 R1 key.

See psa_generate_key()

Parameters

attributes
priv_key_buffer
pub_key_buffer
priv_key_buffer_length
pub_key_buffer_length

Returns

psa_status_t

psa_generate_ecc_p256r1_key_pair()

psa_status_t psa_generate_ecc_p256r1_key_pair	(	const psa_key_attributes_t *	attributes,
		uint8_t *	priv_key_buffer,
		uint8_t *	pub_key_buffer,
		size_t *	priv_key_buffer_length,
		size_t *	pub_key_buffer_length
	)

Low level wrapper function to call a driver for an ECC key generation with a SECP 192 R1 key.

See psa_generate_key()

Parameters

attributes
priv_key_buffer
pub_key_buffer
priv_key_buffer_length
pub_key_buffer_length

Returns

psa_status_t