PolarSSL is now part of ARM Official announcement and rebranded as mbed TLS.

API Documentation (Doxygen generated)

These pages are generated with doxygen directly from the source code!

des.h
Go to the documentation of this file.
1 
10 /*
11  * Copyright (C) 2006-2015, ARM Limited, All Rights Reserved
12  * SPDX-License-Identifier: Apache-2.0
13  *
14  * Licensed under the Apache License, Version 2.0 (the "License"); you may
15  * not use this file except in compliance with the License.
16  * You may obtain a copy of the License at
17  *
18  * http://www.apache.org/licenses/LICENSE-2.0
19  *
20  * Unless required by applicable law or agreed to in writing, software
21  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
22  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
23  * See the License for the specific language governing permissions and
24  * limitations under the License.
25  *
26  * This file is part of mbed TLS (https://tls.mbed.org)
27  *
28  */
29 #ifndef MBEDTLS_DES_H
30 #define MBEDTLS_DES_H
31 
32 #if !defined(MBEDTLS_CONFIG_FILE)
33 #include "config.h"
34 #else
35 #include MBEDTLS_CONFIG_FILE
36 #endif
37 
38 #include <stddef.h>
39 #include <stdint.h>
40 
41 #define MBEDTLS_DES_ENCRYPT 1
42 #define MBEDTLS_DES_DECRYPT 0
43 
44 #define MBEDTLS_ERR_DES_INVALID_INPUT_LENGTH -0x0032
45 #define MBEDTLS_ERR_DES_HW_ACCEL_FAILED -0x0033
47 #define MBEDTLS_DES_KEY_SIZE 8
48 
49 #ifdef __cplusplus
50 extern "C" {
51 #endif
52 
53 #if !defined(MBEDTLS_DES_ALT)
54 // Regular implementation
55 //
56 
64 typedef struct
65 {
66  uint32_t sk[32];
67 }
69 
73 typedef struct
74 {
75  uint32_t sk[96];
76 }
78 
79 #else /* MBEDTLS_DES_ALT */
80 #include "des_alt.h"
81 #endif /* MBEDTLS_DES_ALT */
82 
93 
104 
111 
118 
131 void mbedtls_des_key_set_parity( unsigned char key[MBEDTLS_DES_KEY_SIZE] );
132 
147 int mbedtls_des_key_check_key_parity( const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
148 
160 int mbedtls_des_key_check_weak( const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
161 
174 int mbedtls_des_setkey_enc( mbedtls_des_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
175 
188 int mbedtls_des_setkey_dec( mbedtls_des_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
189 
199  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 2] );
200 
210  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 2] );
211 
221  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 3] );
222 
232  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 3] );
233 
248  const unsigned char input[8],
249  unsigned char output[8] );
250 
251 #if defined(MBEDTLS_CIPHER_MODE_CBC)
252 
275  int mode,
276  size_t length,
277  unsigned char iv[8],
278  const unsigned char *input,
279  unsigned char *output );
280 #endif /* MBEDTLS_CIPHER_MODE_CBC */
281 
292  const unsigned char input[8],
293  unsigned char output[8] );
294 
295 #if defined(MBEDTLS_CIPHER_MODE_CBC)
296 
317  int mode,
318  size_t length,
319  unsigned char iv[8],
320  const unsigned char *input,
321  unsigned char *output );
322 #endif /* MBEDTLS_CIPHER_MODE_CBC */
323 
336 void mbedtls_des_setkey( uint32_t SK[32],
337  const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
338 
344 int mbedtls_des_self_test( int verbose );
345 
346 #ifdef __cplusplus
347 }
348 #endif
349 
350 #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:47
DES context structure.
Definition: des.h:64
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:73
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.
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)