abcrypt_encrypt_with_params(3)

NAME

abcrypt_encrypt_with_params - API function

SYNOPSIS

#include <abcrypt.h>

enum abcrypt_error_code abcrypt_encrypt_with_params(uint8_t *plaintext,
                                                    uintptr_t plaintext_len,
                                                    uint8_t *passphrase,
                                                    uintptr_t passphrase_len,
                                                    uint8_t *out,
                                                    uintptr_t out_len,
                                                    uint32_t memory_cost,
                                                    uint32_t time_cost,
                                                    uint32_t parallelism);

DESCRIPTION

This function encrypts plaintext with the specified Argon2 parameters and write to out.

Arguments

plaintext

A pointer to the plaintext to encrypt.

plaintext_len

Length of plaintext.

passphrase

A pointer to the passphrase used for encryption.

passphrase_len

Length of passphrase.

out

A pointer to where to write the ciphertext.

out_len

Length of out.

memory_cost

The memory size in KiB.

time_cost

The number of iterations.

parallelism

The degree of parallelism.

Behavior is undefined if any of the following are true:
  • plaintext or plaintext_len is invalid.

  • passphrase or passphrase_len is invalid.

  • out or out_len is invalid.

RETURN VALUE

Returns ABCRYPT_ERROR_CODE_OK if successful, otherwise returns an error value defined in abcrypt_error_code(3).

VERSIONS

This function was added in version 0.1.0.

Copyright © 2022-2024 Shun Sakai

This manual page is distributed under the terms of the Creative Commons Attribution 4.0 International Public License.

SEE ALSO

abcrypt_decrypt(3), abcrypt_encrypt(3)