core/crypto/aes

aes

Types

Context_CTR :: struct {
	_impl:           Context_Impl,
	_buffer:         [BLOCK_SIZE]u8,
	_off:            int,
	_ctr_hi:         u64,
	_ctr_lo:         u64,
	_is_initialized: bool,
}

Source

Context_CTR is a keyed AES-CTR instance.

Context_ECB :: struct {
	_impl:           Context_Impl,
	_is_initialized: bool,
}

Source

Context_ECB is a keyed AES-ECB instance.

WARNING: Using ECB mode is strongly discouraged unless it is being used to implement higher level constructs.

Context_GCM :: struct {
	_impl:           Context_Impl,
	_is_initialized: bool,
}

Source

Context_GCM is a keyed AES-GCM instance.

Implementation :: enum int {
	Portable = 0,
	Hardware = 1,
}

Source

Implementation is an AES implementation. Most callers will not need to use this as the package will automatically select the most performant implementation available (See is_hardware_accelerated()).

Constants

BLOCK_SIZE :: BLOCK_SIZESource

BLOCK_SIZE is the AES block size in bytes.

CTR_IV_SIZE :: 16Source

CTR_IV_SIZE is the size of the CTR mode IV in bytes.

DEFAULT_IMPLEMENTATION :: Implementation.HardwareSource

DEFAULT_IMPLEMENTATION is the implementation that will be used by default if possible.

GCM_IV_SIZE :: 12Source

GCM_IV_SIZE is the default size of the GCM IV in bytes.

GCM_IV_SIZE_MAX :: 0x2000000000000000Source

GCM_IV_SIZE_MAX is the maximum size of the GCM IV in bytes.

GCM_TAG_SIZE :: GHASH_TAG_SIZESource

GCM_TAG_SIZE is the size of a GCM tag in bytes.

KEY_SIZE_128 :: KEY_SIZE_128Source

KEY_SIZE_128 is the AES-128 key size in bytes.

KEY_SIZE_192 :: KEY_SIZE_192Source

KEY_SIZE_192 is the AES-192 key size in bytes.

KEY_SIZE_256 :: KEY_SIZE_256Source

KEY_SIZE_256 is the AES-256 key size in bytes.

Procedures

decrypt_ecb :: proc(ctx: ^Context_ECB, dst: []u8, src: []u8)Source

decrypt_ecb decrypts the BLOCK_SIZE buffer src, and writes the result to dst.

encrypt_ecb :: proc(ctx: ^Context_ECB, dst: []u8, src: []u8)Source

encrypt_ecb encrypts the BLOCK_SIZE buffer src, and writes the result to dst.

init_ctr :: proc(ctx: ^Context_CTR, key: []u8, iv: []u8, impl = DEFAULT_IMPLEMENTATION)Source

init_ctr initializes a Context_CTR with the provided key and IV.

init_ecb :: proc(ctx: ^Context_ECB, key: []u8, impl = DEFAULT_IMPLEMENTATION)Source

init_ecb initializes a Context_ECB with the provided key.

init_gcm :: proc(ctx: ^Context_GCM, key: []u8, impl = DEFAULT_IMPLEMENTATION)Source

init_gcm initializes a Context_GCM with the provided key.

is_hardware_accelerated :: proc() -> (bool)Source

is_hardware_accelerated returns true if and only if (⟺) hardware accelerated AES is supported.

keystream_bytes_ctr :: proc(ctx: ^Context_CTR, dst: []u8)Source

keystream_bytes_ctr fills dst with the raw AES-CTR keystream output.

open_gcm :: proc(
	ctx:        ^Context_GCM,
	dst:        []u8,
	iv:         []u8,
	aad:        []u8,
	ciphertext: []u8,
	tag:        []u8,
) -> (bool)

Source

open_gcm authenticates the aad and ciphertext, and decrypts the ciphertext, with the provided Context_GCM, iv, and tag, and stores the output in dst, returning true if and only if (⟺) the authentication was successful. If authentication fails, the destination buffer will be zeroed.

dst and plaintext MUST alias exactly or not at all.

reset_ctr :: proc(ctx: ^Context_CTR)Source

reset_ctr sanitizes the Context_CTR. The Context_CTR must be re-initialized to be used again.

reset_ecb :: proc(ctx: ^Context_ECB)Source

reset_ecb sanitizes the Context_ECB. The Context_ECB must be re-initialized to be used again.

reset_gcm :: proc(ctx: ^Context_GCM)Source

reset_gcm sanitizes the Context_GCM. The Context_GCM must be re-initialized to be used again.

seal_gcm :: proc(
	ctx:       ^Context_GCM,
	dst:       []u8,
	tag:       []u8,
	iv:        []u8,
	aad:       []u8,
	plaintext: []u8,
)

Source

seal_gcm encrypts the plaintext and authenticates the aad and ciphertext, with the provided Context_GCM and iv, stores the output in dst and tag.

dst and plaintext MUST alias exactly or not at all.

xor_bytes_ctr :: proc(ctx: ^Context_CTR, dst: []u8, src: []u8)Source

xor_bytes_ctr XORs each byte in src with bytes taken from the AES-CTR keystream, and writes the resulting output to dst. dst and src MUST alias exactly or not at all.

zero_explicit :: proc(data: rawptr, len: int) -> (rawptr)Source

aes

Types

Constants

Procedures

Find anything

Settings