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 #if !defined(MBEDTLS_DES_ALT)
50 // Regular implementation
51 //
52 
53 #ifdef __cplusplus
54 extern "C" {
55 #endif
56 
64 typedef struct
65 {
66  uint32_t sk[32];
67 }
69 
73 typedef struct
74 {
75  uint32_t sk[96];
76 }
78 
89 
100 
107 
114 
127 void mbedtls_des_key_set_parity( unsigned char key[MBEDTLS_DES_KEY_SIZE] );
128 
143 int mbedtls_des_key_check_key_parity( const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
144 
156 int mbedtls_des_key_check_weak( const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
157 
170 int mbedtls_des_setkey_enc( mbedtls_des_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
171 
184 int mbedtls_des_setkey_dec( mbedtls_des_context *ctx, const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
185 
195  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 2] );
196 
206  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 2] );
207 
217  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 3] );
218 
228  const unsigned char key[MBEDTLS_DES_KEY_SIZE * 3] );
229 
244  const unsigned char input[8],
245  unsigned char output[8] );
246 
247 #if defined(MBEDTLS_CIPHER_MODE_CBC)
248 
271  int mode,
272  size_t length,
273  unsigned char iv[8],
274  const unsigned char *input,
275  unsigned char *output );
276 #endif /* MBEDTLS_CIPHER_MODE_CBC */
277 
288  const unsigned char input[8],
289  unsigned char output[8] );
290 
291 #if defined(MBEDTLS_CIPHER_MODE_CBC)
292 
313  int mode,
314  size_t length,
315  unsigned char iv[8],
316  const unsigned char *input,
317  unsigned char *output );
318 #endif /* MBEDTLS_CIPHER_MODE_CBC */
319 
332 void mbedtls_des_setkey( uint32_t SK[32],
333  const unsigned char key[MBEDTLS_DES_KEY_SIZE] );
334 #ifdef __cplusplus
335 }
336 #endif
337 
338 #else /* MBEDTLS_DES_ALT */
339 #include "des_alt.h"
340 #endif /* MBEDTLS_DES_ALT */
341 
342 #ifdef __cplusplus
343 extern "C" {
344 #endif
345 
351 int mbedtls_des_self_test( int verbose );
352 
353 #ifdef __cplusplus
354 }
355 #endif
356 
357 #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)