Example program to test AES-GCM functionality. Used for a workshop

Dependencies:   mbed

Embed: (wiki syntax)

« Back to documentation index

des.h File Reference

des.h File Reference

DES block cipher. More...

Go to the source code of this file.

Data Structures

struct  des_context
 DES context structure. More...
struct  des3_context
 Triple-DES context structure. More...

Functions

void des_key_set_parity (unsigned char key[DES_KEY_SIZE])
 Set key parity on the given key to odd.
int des_key_check_key_parity (const unsigned char key[DES_KEY_SIZE])
 Check that key parity on the given key is odd.
int des_key_check_weak (const unsigned char key[DES_KEY_SIZE])
 Check that key is not a weak or semi-weak DES key.
int des_setkey_enc (des_context *ctx, const unsigned char key[DES_KEY_SIZE])
 DES key schedule (56-bit, encryption)
int des_setkey_dec (des_context *ctx, const unsigned char key[DES_KEY_SIZE])
 DES key schedule (56-bit, decryption)
int des3_set2key_enc (des3_context *ctx, const unsigned char key[DES_KEY_SIZE *2])
 Triple-DES key schedule (112-bit, encryption)
int des3_set2key_dec (des3_context *ctx, const unsigned char key[DES_KEY_SIZE *2])
 Triple-DES key schedule (112-bit, decryption)
int des3_set3key_enc (des3_context *ctx, const unsigned char key[DES_KEY_SIZE *3])
 Triple-DES key schedule (168-bit, encryption)
int des3_set3key_dec (des3_context *ctx, const unsigned char key[DES_KEY_SIZE *3])
 Triple-DES key schedule (168-bit, decryption)
int des_crypt_ecb (des_context *ctx, const unsigned char input[8], unsigned char output[8])
 DES-ECB block encryption/decryption.
int des_crypt_cbc (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 des3_crypt_ecb (des3_context *ctx, const unsigned char input[8], unsigned char output[8])
 3DES-ECB block encryption/decryption
int des3_crypt_cbc (des3_context *ctx, int mode, size_t length, unsigned char iv[8], const unsigned char *input, unsigned char *output)
 3DES-CBC buffer encryption/decryption
int des_self_test (int verbose)
 Checkup routine.

Detailed Description

DES block cipher.

Copyright (C) 2006-2014, Brainspark B.V.

This file is part of PolarSSL (http://www.polarssl.org) Lead Maintainer: Paul Bakker <polarssl_maintainer at polarssl.org>

All rights reserved.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

Definition in file des.h.


Function Documentation

int des3_crypt_cbc ( des3_context ctx,
int  mode,
size_t  length,
unsigned char  iv[8],
const unsigned char *  input,
unsigned char *  output 
)

3DES-CBC buffer encryption/decryption

Parameters:
ctx3DES context
modeDES_ENCRYPT or DES_DECRYPT
lengthlength of the input data
ivinitialization vector (updated after use)
inputbuffer holding the input data
outputbuffer holding the output data
Returns:
0 if successful, or POLARSSL_ERR_DES_INVALID_INPUT_LENGTH

Definition at line 724 of file des.c.

int des3_crypt_ecb ( des3_context ctx,
const unsigned char  input[8],
unsigned char  output[8] 
)

3DES-ECB block encryption/decryption

Parameters:
ctx3DES context
input64-bit input block
output64-bit output block
Returns:
0 if successful

Definition at line 680 of file des.c.

int des3_set2key_dec ( des3_context ctx,
const unsigned char  key[DES_KEY_SIZE *2] 
)

Triple-DES key schedule (112-bit, decryption)

Parameters:
ctx3DES context to be initialized
key16-byte secret key
Returns:
0

Definition at line 530 of file des.c.

int des3_set2key_enc ( des3_context ctx,
const unsigned char  key[DES_KEY_SIZE *2] 
)

Triple-DES key schedule (112-bit, encryption)

Parameters:
ctx3DES context to be initialized
key16-byte secret key
Returns:
0

Definition at line 516 of file des.c.

int des3_set3key_dec ( des3_context ctx,
const unsigned char  key[DES_KEY_SIZE *3] 
)

Triple-DES key schedule (168-bit, decryption)

Parameters:
ctx3DES context to be initialized
key24-byte secret key
Returns:
0

Definition at line 581 of file des.c.

int des3_set3key_enc ( des3_context ctx,
const unsigned char  key[DES_KEY_SIZE *3] 
)

Triple-DES key schedule (168-bit, encryption)

Parameters:
ctx3DES context to be initialized
key24-byte secret key
Returns:
0

Definition at line 567 of file des.c.

int des_crypt_cbc ( des_context ctx,
int  mode,
size_t  length,
unsigned char  iv[8],
const unsigned char *  input,
unsigned char *  output 
)

DES-CBC buffer encryption/decryption.

Parameters:
ctxDES context
modeDES_ENCRYPT or DES_DECRYPT
lengthlength of the input data
ivinitialization vector (updated after use)
inputbuffer holding the input data
outputbuffer holding the output data

Definition at line 627 of file des.c.

int des_crypt_ecb ( des_context ctx,
const unsigned char  input[8],
unsigned char  output[8] 
)

DES-ECB block encryption/decryption.

Parameters:
ctxDES context
input64-bit input block
output64-bit output block
Returns:
0 if successful

Definition at line 595 of file des.c.

int des_key_check_key_parity ( const unsigned char  key[DES_KEY_SIZE] )

Check that key parity on the given key is odd.

DES keys are 56 bits long, but each byte is padded with a parity bit to allow verification.

Parameters:
key8-byte secret key
Returns:
0 is parity was ok, 1 if parity was not correct.

Definition at line 325 of file des.c.

int des_key_check_weak ( const unsigned char  key[DES_KEY_SIZE] )

Check that key is not a weak or semi-weak DES key.

Parameters:
key8-byte secret key
Returns:
0 if no weak key was found, 1 if a weak key was identified.

Definition at line 380 of file des.c.

void des_key_set_parity ( unsigned char  key[DES_KEY_SIZE] )

Set key parity on the given key to odd.

DES keys are 56 bits long, but each byte is padded with a parity bit to allow verification.

Parameters:
key8-byte secret key

Definition at line 314 of file des.c.

int des_self_test ( int  verbose )

Checkup routine.

Returns:
0 if successful, or 1 if the test failed

Definition at line 835 of file des.c.

int des_setkey_dec ( des_context ctx,
const unsigned char  key[DES_KEY_SIZE] 
)

DES key schedule (56-bit, decryption)

Parameters:
ctxDES context to be initialized
key8-byte secret key
Returns:
0

Definition at line 473 of file des.c.

int des_setkey_enc ( des_context ctx,
const unsigned char  key[DES_KEY_SIZE] 
)

DES key schedule (56-bit, encryption)

Parameters:
ctxDES context to be initialized
key8-byte secret key
Returns:
0

Definition at line 463 of file des.c.