• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1 /**
2  * \file padlock.h
3  *
4  * \brief VIA PadLock ACE for HW encryption/decryption supported by some
5  *        processors
6  *
7  * \warning These functions are only for internal use by other library
8  *          functions; you must not call them directly.
9  */
10 /*
11  *  Copyright The Mbed TLS Contributors
12  *  SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
13  *
14  *  This file is provided under the Apache License 2.0, or the
15  *  GNU General Public License v2.0 or later.
16  *
17  *  **********
18  *  Apache License 2.0:
19  *
20  *  Licensed under the Apache License, Version 2.0 (the "License"); you may
21  *  not use this file except in compliance with the License.
22  *  You may obtain a copy of the License at
23  *
24  *  http://www.apache.org/licenses/LICENSE-2.0
25  *
26  *  Unless required by applicable law or agreed to in writing, software
27  *  distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
28  *  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
29  *  See the License for the specific language governing permissions and
30  *  limitations under the License.
31  *
32  *  **********
33  *
34  *  **********
35  *  GNU General Public License v2.0 or later:
36  *
37  *  This program is free software; you can redistribute it and/or modify
38  *  it under the terms of the GNU General Public License as published by
39  *  the Free Software Foundation; either version 2 of the License, or
40  *  (at your option) any later version.
41  *
42  *  This program is distributed in the hope that it will be useful,
43  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
44  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
45  *  GNU General Public License for more details.
46  *
47  *  You should have received a copy of the GNU General Public License along
48  *  with this program; if not, write to the Free Software Foundation, Inc.,
49  *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
50  *
51  *  **********
52  */
53 #ifndef MBEDTLS_PADLOCK_H
54 #define MBEDTLS_PADLOCK_H
55 
56 #if !defined(MBEDTLS_CONFIG_FILE)
57 #include "config.h"
58 #else
59 #include MBEDTLS_CONFIG_FILE
60 #endif
61 
62 #include "aes.h"
63 
64 #define MBEDTLS_ERR_PADLOCK_DATA_MISALIGNED               -0x0030  /**< Input data should be aligned. */
65 
66 #if defined(__has_feature)
67 #if __has_feature(address_sanitizer)
68 #define MBEDTLS_HAVE_ASAN
69 #endif
70 #endif
71 
72 /* Some versions of ASan result in errors about not enough registers */
73 #if defined(MBEDTLS_HAVE_ASM) && defined(__GNUC__) && defined(__i386__) && \
74     !defined(MBEDTLS_HAVE_ASAN)
75 
76 #ifndef MBEDTLS_HAVE_X86
77 #define MBEDTLS_HAVE_X86
78 #endif
79 
80 #include <stdint.h>
81 
82 #define MBEDTLS_PADLOCK_RNG 0x000C
83 #define MBEDTLS_PADLOCK_ACE 0x00C0
84 #define MBEDTLS_PADLOCK_PHE 0x0C00
85 #define MBEDTLS_PADLOCK_PMM 0x3000
86 
87 #define MBEDTLS_PADLOCK_ALIGN16(x) (uint32_t *) (16 + ((int32_t) (x) & ~15))
88 
89 #ifdef __cplusplus
90 extern "C" {
91 #endif
92 
93 /**
94  * \brief          Internal PadLock detection routine
95  *
96  * \note           This function is only for internal use by other library
97  *                 functions; you must not call it directly.
98  *
99  * \param feature  The feature to detect
100  *
101  * \return         non-zero if CPU has support for the feature, 0 otherwise
102  */
103 int mbedtls_padlock_has_support( int feature );
104 
105 /**
106  * \brief          Internal PadLock AES-ECB block en(de)cryption
107  *
108  * \note           This function is only for internal use by other library
109  *                 functions; you must not call it directly.
110  *
111  * \param ctx      AES context
112  * \param mode     MBEDTLS_AES_ENCRYPT or MBEDTLS_AES_DECRYPT
113  * \param input    16-byte input block
114  * \param output   16-byte output block
115  *
116  * \return         0 if success, 1 if operation failed
117  */
118 int mbedtls_padlock_xcryptecb( mbedtls_aes_context *ctx,
119                                int mode,
120                                const unsigned char input[16],
121                                unsigned char output[16] );
122 
123 /**
124  * \brief          Internal PadLock AES-CBC buffer en(de)cryption
125  *
126  * \note           This function is only for internal use by other library
127  *                 functions; you must not call it directly.
128  *
129  * \param ctx      AES context
130  * \param mode     MBEDTLS_AES_ENCRYPT or MBEDTLS_AES_DECRYPT
131  * \param length   length of the input data
132  * \param iv       initialization vector (updated after use)
133  * \param input    buffer holding the input data
134  * \param output   buffer holding the output data
135  *
136  * \return         0 if success, 1 if operation failed
137  */
138 int mbedtls_padlock_xcryptcbc( mbedtls_aes_context *ctx,
139                                int mode,
140                                size_t length,
141                                unsigned char iv[16],
142                                const unsigned char *input,
143                                unsigned char *output );
144 
145 #ifdef __cplusplus
146 }
147 #endif
148 
149 #endif /* HAVE_X86  */
150 
151 #endif /* padlock.h */
152