mbed TLS v2.7.17
des.h
Go to the documentation of this file.
1 
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  */
54 #ifndef MBEDTLS_DES_H
55 #define MBEDTLS_DES_H
56 
57 #if !defined(MBEDTLS_CONFIG_FILE)
58 #include "config.h"
59 #else
60 #include MBEDTLS_CONFIG_FILE
61 #endif
62 
63 #include <stddef.h>
64 #include <stdint.h>
65 
66 #define MBEDTLS_DES_ENCRYPT 1
67 #define MBEDTLS_DES_DECRYPT 0
68 
69 #define MBEDTLS_ERR_DES_INVALID_INPUT_LENGTH -0x0032
70 #define MBEDTLS_ERR_DES_HW_ACCEL_FAILED -0x0033
72 #define MBEDTLS_DES_KEY_SIZE 8
73 
74 #if !defined(MBEDTLS_DES_ALT)
75 // Regular implementation
76 //
77 
78 #ifdef __cplusplus
79 extern "C" {
80 #endif
81 
89 typedef struct
90 {
91  uint32_t sk[32];
92 }
94 
98 typedef struct
99 {
100  uint32_t sk[96];
101 }
103 
114 
125 
132 
139 
152 void mbedtls_des_key_set_parity( unsigned char key[MBEDTLS_DES_KEY_SIZE] );
153 
168 int mbedtls_des_key_check_key_parity( const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
169 
181 int mbedtls_des_key_check_weak( const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
182 
195 int mbedtls_des_setkey_enc( mbedtls_des_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
196 
209 int mbedtls_des_setkey_dec( mbedtls_des_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
210 
220  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 2] );
221 
231  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 2] );
232 
242  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 3] );
243 
253  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 3] );
254 
269  const unsigned char input[8],
270  unsigned char output[8] );
271 
272 #if defined(MBEDTLS_CIPHER_MODE_CBC)
273 
296  int mode,
297  size_t length,
298  unsigned char iv[8],
299  const unsigned char *input,
300  unsigned char *output );
301 #endif /* MBEDTLS_CIPHER_MODE_CBC */
302 
313  const unsigned char input[8],
314  unsigned char output[8] );
315 
316 #if defined(MBEDTLS_CIPHER_MODE_CBC)
317 
338  int mode,
339  size_t length,
340  unsigned char iv[8],
341  const unsigned char *input,
342  unsigned char *output );
343 #endif /* MBEDTLS_CIPHER_MODE_CBC */
344 
357 void mbedtls_des_setkey( uint32_t SK[32],
358  const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
359 #ifdef __cplusplus
360 }
361 #endif
362 
363 #else /* MBEDTLS_DES_ALT */
364 #include "des_alt.h"
365 #endif /* MBEDTLS_DES_ALT */
366 
367 #ifdef __cplusplus
368 extern "C" {
369 #endif
370 
376 int mbedtls_des_self_test( int verbose );
377 
378 #ifdef __cplusplus
379 }
380 #endif
381 
382 #endif /* des.h */
int mbedtls_des3_crypt_ecb(mbedtls_des3_context *ctx, const unsigned char input[8], unsigned char output[8])
3DES-ECB block encryption/decryption
int mbedtls_des_key_check_weak(const unsigned char key[MBEDTLS_DES_KEY_SIZE])
Check that key is not a weak or semi-weak DES key.
void mbedtls_des3_init(mbedtls_des3_context *ctx)
Initialize Triple-DES context.
int mbedtls_des3_set2key_dec(mbedtls_des3_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE *2])
Triple-DES key schedule (112-bit, decryption)
#define MBEDTLS_DES_KEY_SIZE
Definition: des.h:72
DES context structure.
Definition: des.h:89
Configuration options (set of defines)
int mbedtls_des3_set2key_enc(mbedtls_des3_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE *2])
Triple-DES key schedule (112-bit, encryption)
int mbedtls_des3_set3key_enc(mbedtls_des3_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE *3])
Triple-DES key schedule (168-bit, encryption)
Triple-DES context structure.
Definition: des.h:98
int mbedtls_des_self_test(int verbose)
Checkup routine.
int mbedtls_des_crypt_ecb(mbedtls_des_context *ctx, const unsigned char input[8], unsigned char output[8])
DES-ECB block encryption/decryption.
void mbedtls_des_free(mbedtls_des_context *ctx)
Clear DES context.
int mbedtls_des3_crypt_cbc(mbedtls_des3_context *ctx, int mode, size_t length, unsigned char iv[8], const unsigned char *input, unsigned char *output)
3DES-CBC buffer encryption/decryption
void mbedtls_des_init(mbedtls_des_context *ctx)
Initialize DES context.
void mbedtls_des3_free(mbedtls_des3_context *ctx)
Clear Triple-DES context.
int mbedtls_des3_set3key_dec(mbedtls_des3_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE *3])
Triple-DES key schedule (168-bit, decryption)
void mbedtls_des_setkey(uint32_t SK[32], const unsigned char key[MBEDTLS_DES_KEY_SIZE])
Internal function for key expansion. (Only exposed to allow overriding it, see MBEDTLS_DES_SETKEY_ALT...
int mbedtls_des_setkey_enc(mbedtls_des_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE])
DES key schedule (56-bit, encryption)
void mbedtls_des_key_set_parity(unsigned char key[MBEDTLS_DES_KEY_SIZE])
Set key parity on the given key to odd.
int mbedtls_des_key_check_key_parity(const unsigned char key[MBEDTLS_DES_KEY_SIZE])
Check that key parity on the given key is odd.
int mbedtls_des_crypt_cbc(mbedtls_des_context *ctx, int mode, size_t length, unsigned char iv[8], const unsigned char *input, unsigned char *output)
DES-CBC buffer encryption/decryption.
int mbedtls_des_setkey_dec(mbedtls_des_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE])
DES key schedule (56-bit, decryption)