/** | |
* \file aesni.h | |
* | |
* \brief AES-NI for hardware AES acceleration on some Intel processors | |
* | |
* \warning These functions are only for internal use by other library | |
* functions; you must not call them directly. | |
*/ | |
/* | |
* Copyright (C) 2006-2015, ARM Limited, All Rights Reserved | |
* SPDX-License-Identifier: Apache-2.0 | |
* | |
* Licensed under the Apache License, Version 2.0 (the "License"); you may | |
* not use this file except in compliance with the License. | |
* You may obtain a copy of the License at | |
* | |
* http://www.apache.org/licenses/LICENSE-2.0 | |
* | |
* Unless required by applicable law or agreed to in writing, software | |
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT | |
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. | |
* See the License for the specific language governing permissions and | |
* limitations under the License. | |
* | |
* This file is part of mbed TLS (https://tls.mbed.org) | |
*/ | |
#ifndef MBEDTLS_AESNI_H | |
#define MBEDTLS_AESNI_H | |
#if !defined(MBEDTLS_CONFIG_FILE) | |
#include "config.h" | |
#else | |
#include MBEDTLS_CONFIG_FILE | |
#endif | |
#include "aes.h" | |
#define MBEDTLS_AESNI_AES 0x02000000u | |
#define MBEDTLS_AESNI_CLMUL 0x00000002u | |
#if defined(MBEDTLS_HAVE_ASM) && defined(__GNUC__) && \ | |
( defined(__amd64__) || defined(__x86_64__) ) && \ | |
! defined(MBEDTLS_HAVE_X86_64) | |
#define MBEDTLS_HAVE_X86_64 | |
#endif | |
#if defined(MBEDTLS_HAVE_X86_64) | |
#ifdef __cplusplus | |
extern "C" { | |
#endif | |
/** | |
* \brief Internal function to detect the AES-NI feature in CPUs. | |
* | |
* \note This function is only for internal use by other library | |
* functions; you must not call it directly. | |
* | |
* \param what The feature to detect | |
* (MBEDTLS_AESNI_AES or MBEDTLS_AESNI_CLMUL) | |
* | |
* \return 1 if CPU has support for the feature, 0 otherwise | |
*/ | |
int mbedtls_aesni_has_support( unsigned int what ); | |
/** | |
* \brief Internal AES-NI AES-ECB block encryption and decryption | |
* | |
* \note This function is only for internal use by other library | |
* functions; you must not call it directly. | |
* | |
* \param ctx AES context | |
* \param mode MBEDTLS_AES_ENCRYPT or MBEDTLS_AES_DECRYPT | |
* \param input 16-byte input block | |
* \param output 16-byte output block | |
* | |
* \return 0 on success (cannot fail) | |
*/ | |
int mbedtls_aesni_crypt_ecb( mbedtls_aes_context *ctx, | |
int mode, | |
const unsigned char input[16], | |
unsigned char output[16] ); | |
/** | |
* \brief Internal GCM multiplication: c = a * b in GF(2^128) | |
* | |
* \note This function is only for internal use by other library | |
* functions; you must not call it directly. | |
* | |
* \param c Result | |
* \param a First operand | |
* \param b Second operand | |
* | |
* \note Both operands and result are bit strings interpreted as | |
* elements of GF(2^128) as per the GCM spec. | |
*/ | |
void mbedtls_aesni_gcm_mult( unsigned char c[16], | |
const unsigned char a[16], | |
const unsigned char b[16] ); | |
/** | |
* \brief Internal round key inversion. This function computes | |
* decryption round keys from the encryption round keys. | |
* | |
* \note This function is only for internal use by other library | |
* functions; you must not call it directly. | |
* | |
* \param invkey Round keys for the equivalent inverse cipher | |
* \param fwdkey Original round keys (for encryption) | |
* \param nr Number of rounds (that is, number of round keys minus one) | |
*/ | |
void mbedtls_aesni_inverse_key( unsigned char *invkey, | |
const unsigned char *fwdkey, | |
int nr ); | |
/** | |
* \brief Internal key expansion for encryption | |
* | |
* \note This function is only for internal use by other library | |
* functions; you must not call it directly. | |
* | |
* \param rk Destination buffer where the round keys are written | |
* \param key Encryption key | |
* \param bits Key size in bits (must be 128, 192 or 256) | |
* | |
* \return 0 if successful, or MBEDTLS_ERR_AES_INVALID_KEY_LENGTH | |
*/ | |
int mbedtls_aesni_setkey_enc( unsigned char *rk, | |
const unsigned char *key, | |
size_t bits ); | |
#ifdef __cplusplus | |
} | |
#endif | |
#endif /* MBEDTLS_HAVE_X86_64 */ | |
#endif /* MBEDTLS_AESNI_H */ |