AES

Header file

#include "mln_aes.h"

Module

aes

Functions

mln_aes_init

int mln_aes_init(mln_aes_t *a, mln_u8ptr_t key, mln_u32_t bits);

Description: Initializes the mln_aes_t structure, which is defined and passed in by the caller. key is the key, the length of the key is related to bit, bit is divided into:

• M_AES_128 128-bit (16-byte) key
• M_AES_192 192-bit (24-byte) key
• M_AES_256 256-bit (32-byte) key

The length of key must be strictly equal to the number of bits required by bit.

Return value: return 0 on success, otherwise return -1

mln_aes_new

mln_aes_t *mln_aes_new(mln_u8ptr_t key, mln_u32_t bits);

Description: Create and initialize the mln_aes_t structure, which is allocated with malloc. key is the key, the length of the key is related to bit, bit is divided into:

• M_AES_128 128-bit (16-byte) key
• M_AES_192 192-bit (24-byte) key
• M_AES_256 256-bit (32-byte) key

The length of key must be strictly equal to the number of bits required by bit.

Return value: return mln_aes_t structure if successful, otherwise return NULL

mln_aes_pool_new

mln_aes_t *mln_aes_pool_new(mln_alloc_t *pool, mln_u8ptr_t key, mln_u32_t bits);

Description: Create and initialize the mln_aes_t structure, which is allocated with the memory pool pointed to by pool. key is the key, the length of the key is related to bit, bit is divided into:

• M_AES_128 128-bit (16-byte) key
• M_AES_192 192-bit (24-byte) key
• M_AES_256 256-bit (32-byte) key

The length of key must be strictly equal to the number of bits required by bit.

Return value: return mln_aes_t structure if successful, otherwise return NULL

mln_aes_free

void mln_aes_free(mln_aes_t *a);

Description: Free the mln_aes_t structure a, which should have been created by mln_aes_new.

Return value: none

mln_aes_pool_free

void mln_aes_pool_free(mln_aes_t *a);

Description: Free the mln_aes_t structure a, which should have been created by mln_aes_pool_new.

Return value: none

mln_aes_encrypt

int mln_aes_encrypt(mln_aes_t *a, mln_u8ptr_t text);

Description: AES encryption of text text. Note: text length must be 128 bits (16 bytes). The ciphertext will be written directly into text.

Note: Since the ciphertext will be written back to the parameter, it is necessary to ensure the writability of the parameter memory, and a segmentation fault will occur for read-only memory.

Return value: return 0 if successful, otherwise return -1

mln_aes_decrypt

int mln_aes_decrypt(mln_aes_t *a, mln_u8ptr_t cipher);

Description: AES decrypt cipher text. Note: cipher length must be 128 bits (16 bytes). The plaintext will be written directly into cipher.

Note: Since the ciphertext will be written back to the parameter, it is necessary to ensure the writability of the parameter memory, and a segmentation fault will occur for read-only memory.

Return value: return 0 if successful, otherwise return -1

Example

#include <stdio.h>
#include <stdlib.h>
#include "mln_string.h"
#include "mln_aes.h"

int main(int argc, char *argv[])
{
    mln_aes_t a;
    char p[] = "1234567890123456";//128-bit 这里如果将char p[] 改为 char *p，则字符串内存区为只读，会导致段错误
    mln_string_t s;

    if (mln_aes_init(&a, (mln_u8ptr_t)"abcdefghijklmnop", M_AES_128) < 0) {
        fprintf(stderr, "aes init failed\n");
        return -1;
    }

    mln_string_set(&s, p);
    if (mln_aes_encrypt(&a, s.data) < 0) {
        fprintf(stderr, "aes encrypt failed\n");
        return -1;
    }
    write(STDOUT_FILENO, s.data, s.len);
    write(STDOUT_FILENO, "\n", 1);

    if (mln_aes_decrypt(&a, s.data) < 0) {
        fprintf(stderr, "aes decrypt failed\n");
        return -1;
    }
    write(STDOUT_FILENO, s.data, s.len);
    write(STDOUT_FILENO, "\n", 1);

    return 0;
}