pubkey_test.h File Reference

#include <stdint.h>
#include <ipxe/crypto.h>
#include <ipxe/test.h>

Go to the source code of this file.

Macros
#define	pubkey_decrypt_ok(pubkey, key, key_len, ciphertext, ciphertext_len, expected, expected_len)
	Report public key decryption test result. More...
#define	pubkey_encrypt_ok(pubkey, encrypt_key, encrypt_key_len, decrypt_key, decrypt_key_len, plaintext, plaintext_len)
	Report public key encryption and decryption test result. More...
#define	pubkey_sign_ok(pubkey, key, key_len, digest, plaintext, plaintext_len, expected, expected_len)
	Report public key signature test result. More...
#define	pubkey_verify_ok(pubkey, key, key_len, digest, plaintext, plaintext_len, signature, signature_len)
	Report public key verification test result. More...
#define	pubkey_verify_fail_ok(pubkey, key, key_len, digest, plaintext, plaintext_len, signature, signature_len)
	Report public key verification test result. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)

Macro Definition Documentation

pubkey_decrypt_ok

#define pubkey_decrypt_ok	(		pubkey,
			key,
			key_len,
			ciphertext,
			ciphertext_len,
			expected,
			expected_len
	)

Value:

do {\
        uint8_t ctx[ (pubkey)->ctxsize ];                               \
									\
	ok ( pubkey_init ( (pubkey), ctx, (key), (key_len) ) == 0 );   \
        {                                                               \
                size_t max_len = pubkey_max_len ( (pubkey), ctx );      \
                uint8_t decrypted[ max_len ];                           \
                int decrypted_len;                                      \
                                                                        \
                decrypted_len = pubkey_decrypt ( (pubkey), ctx,         \
                                                 (ciphertext),          \
                                                 (ciphertext_len),      \
                                                 decrypted );           \
                ok ( decrypted_len == ( ( int ) (expected_len) ) );     \
                ok ( memcmp ( decrypted, (expected),                    \
                              (expected_len) ) == 0 );                  \
        }                                                               \
        pubkey_final ( (pubkey), ctx );                                 \
        } while ( 0 )

Report public key decryption test result.

Parameters

pubkey	Public key algorithm
key	Key
key_len	Key length
ciphertext	Ciphertext
ciphertext_len	Ciphertext length
expected	Expected plaintext
expected_len	Expected plaintext length

Definition at line 21 of file pubkey_test.h.

pubkey_encrypt_ok

#define pubkey_encrypt_ok	(		pubkey,
			encrypt_key,
			encrypt_key_len,
			decrypt_key,
			decrypt_key_len,
			plaintext,
			plaintext_len
	)

Value:

do {                            \
        uint8_t ctx[ (pubkey)->ctxsize ];                               \
									\
	ok ( pubkey_init ( (pubkey), ctx, (encrypt_key),               \
                           (encrypt_key_len) ) == 0 );                  \
        {                                                               \
                size_t max_len = pubkey_max_len ( (pubkey), ctx );      \
                uint8_t encrypted[ max_len ];                           \
                int encrypted_len;                                      \
                                                                        \
                encrypted_len = pubkey_encrypt ( (pubkey), ctx,         \
                                                 (plaintext),           \
                                                 (plaintext_len),       \
                                                 encrypted );           \
                ok ( encrypted_len >= 0 );                              \
                pubkey_decrypt_ok ( (pubkey), (decrypt_key),            \
                                    (decrypt_key_len), encrypted,       \
                                    encrypted_len, (plaintext),         \
                                    (plaintext_len) );                  \
        }                                                               \
        pubkey_final ( (pubkey), ctx );                                 \
        } while ( 0 )

Report public key encryption and decryption test result.

Parameters

pubkey	Public key algorithm
encrypt_key	Encryption key
encrypt_key_len	Encryption key length
decrypt_key	Decryption key
decrypt_key_len	Decryption key length
plaintext	Plaintext
plaintext_len	Plaintext length

Definition at line 53 of file pubkey_test.h.

pubkey_sign_ok

#define pubkey_sign_ok	(		pubkey,
			key,
			key_len,
			digest,
			plaintext,
			plaintext_len,
			expected,
			expected_len
	)

Value:

do {    \
        uint8_t ctx[ (pubkey)->ctxsize ];                               \
        uint8_t digestctx[ (digest)->ctxsize ];                         \
        uint8_t digestout[ (digest)->digestsize ];                      \
                                                                        \
        digest_init ( (digest), digestctx );                            \
        digest_update ( (digest), digestctx, (plaintext),               \
                        (plaintext_len) );                              \
        digest_final ( (digest), digestctx, digestout );                \
									\
	ok ( pubkey_init ( (pubkey), ctx, (key), (key_len) ) == 0 );   \
        {                                                               \
                size_t max_len = pubkey_max_len ( (pubkey), ctx );      \
                uint8_t signature[ max_len ];                           \
                int signature_len;                                      \
                                                                        \
                signature_len = pubkey_sign ( (pubkey), ctx, (digest),  \
                                              digestout, signature );   \
                ok ( signature_len == ( ( int ) (expected_len) ) );     \
                ok ( memcmp ( signature, (expected),                    \
                              (expected_len) ) == 0 );                  \
        }                                                               \
        pubkey_final ( (pubkey), ctx );                                 \
        } while ( 0 )

Report public key signature test result.

Parameters

pubkey	Public key algorithm
key	Key
key_len	Key length
digest	Digest algorithm
plaintext	Plaintext
plaintext_len	Plaintext length
expected	Expected signature
expected_len	Expected signature length

Definition at line 90 of file pubkey_test.h.

pubkey_verify_ok

#define pubkey_verify_ok	(		pubkey,
			key,
			key_len,
			digest,
			plaintext,
			plaintext_len,
			signature,
			signature_len
	)

Value:

do {\
        uint8_t ctx[ (pubkey)->ctxsize ];                               \
        uint8_t digestctx[ (digest)->ctxsize ];                         \
        uint8_t digestout[ (digest)->digestsize ];                      \
                                                                        \
        digest_init ( (digest), digestctx );                            \
        digest_update ( (digest), digestctx, (plaintext),               \
                        (plaintext_len) );                              \
        digest_final ( (digest), digestctx, digestout );                \
									\
	ok ( pubkey_init ( (pubkey), ctx, (key), (key_len) ) == 0 );   \
        ok ( pubkey_verify ( (pubkey), ctx, (digest), digestout,        \
                             (signature), (signature_len) ) == 0 );     \
        pubkey_final ( (pubkey), ctx );                                 \
        } while ( 0 )

Report public key verification test result.

Parameters

pubkey	Public key algorithm
key	Key
key_len	Key length
digest	Digest algorithm
plaintext	Plaintext
plaintext_len	Plaintext length
signature	Signature
signature_len	Signature length

Definition at line 128 of file pubkey_test.h.

pubkey_verify_fail_ok

#define pubkey_verify_fail_ok	(		pubkey,
			key,
			key_len,
			digest,
			plaintext,
			plaintext_len,
			signature,
			signature_len
	)

Value:

do {                    \
        uint8_t ctx[ (pubkey)->ctxsize ];                               \
        uint8_t digestctx[ (digest)->ctxsize ];                         \
        uint8_t digestout[ (digest)->digestsize ];                      \
                                                                        \
        digest_init ( (digest), digestctx );                            \
        digest_update ( (digest), digestctx, (plaintext),               \
                        (plaintext_len) );                              \
        digest_final ( (digest), digestctx, digestout );                \
									\
	ok ( pubkey_init ( (pubkey), ctx, (key), (key_len) ) == 0 );   \
        ok ( pubkey_verify ( (pubkey), ctx, (digest), digestout,        \
                             (signature), (signature_len) ) != 0 );     \
        pubkey_final ( (pubkey), ctx );                                 \
        } while ( 0 )

Report public key verification test result.

Parameters

pubkey	Public key algorithm
key	Key
key_len	Key length
digest	Digest algorithm
plaintext	Plaintext
plaintext_len	Plaintext length
signature	Signature
signature_len	Signature length

Definition at line 157 of file pubkey_test.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)