des.h File Reference

DES block cipher. More...

#include "config.h"
#include <string.h>
#include <inttypes.h>

Include dependency graph for des.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	des_context
	DES context structure. More...
struct	des3_context
	Triple-DES context structure. More...
Defines
#define	DES_ENCRYPT 1
#define	DES_DECRYPT 0
#define	POLARSSL_ERR_DES_INVALID_INPUT_LENGTH -0x0032
	The data input has an invalid length.
#define	DES_KEY_SIZE 8
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.

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

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.

Define Documentation

#define DES_DECRYPT 0

Definition at line 42 of file des.h.

Referenced by des_self_test(), pem_des3_decrypt(), and pem_des_decrypt().

#define DES_ENCRYPT 1

Definition at line 41 of file des.h.

Referenced by des3_crypt_cbc(), and des_crypt_cbc().

#define DES_KEY_SIZE 8

Definition at line 46 of file des.h.

#define POLARSSL_ERR_DES_INVALID_INPUT_LENGTH -0x0032

The data input has an invalid length.

Definition at line 44 of file des.h.

Referenced by des3_crypt_cbc(), des_crypt_cbc(), and polarssl_strerror().

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:

	ctx	3DES context
	mode	DES_ENCRYPT or DES_DECRYPT
	length	length of the input data
	iv	initialization vector (updated after use)
	input	buffer holding the input data
	output	buffer holding the output data

Returns:: 0 if successful, or POLARSSL_ERR_DES_INVALID_INPUT_LENGTH

Definition at line 710 of file des.c.

References des3_crypt_ecb(), DES_ENCRYPT, and POLARSSL_ERR_DES_INVALID_INPUT_LENGTH.

Referenced by des3_crypt_cbc_wrap(), des_self_test(), and pem_des3_decrypt().

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

3DES-ECB block encryption/decryption

Parameters:

	ctx	3DES context
	input	64-bit input block
	output	64-bit output block

Returns:: 0 if successful

Definition at line 666 of file des.c.

References DES_FP, DES_IP, DES_ROUND, GET_UINT32_BE, PUT_UINT32_BE, and des3_context::sk.

Referenced by des3_crypt_cbc(), des3_crypt_ecb_wrap(), and des_self_test().

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

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

Parameters:

	ctx	3DES context to be initialized
	key	16-byte secret key

Returns:: 0

Definition at line 519 of file des.c.

References des3_set2key(), key, and des3_context::sk.

Referenced by des3_set2key_dec_wrap(), and des_self_test().

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

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

Parameters:

	ctx	3DES context to be initialized
	key	16-byte secret key

Returns:: 0

Definition at line 506 of file des.c.

References des3_set2key(), key, and des3_context::sk.

Referenced by des3_set2key_enc_wrap(), and des_self_test().

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

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

Parameters:

	ctx	3DES context to be initialized
	key	24-byte secret key

Returns:: 0

Definition at line 568 of file des.c.

References des3_set3key(), key, and des3_context::sk.

Referenced by des3_set3key_dec_wrap(), des_self_test(), and pem_des3_decrypt().

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

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

Parameters:

	ctx	3DES context to be initialized
	key	24-byte secret key

Returns:: 0

Definition at line 555 of file des.c.

References des3_set3key(), key, and des3_context::sk.

Referenced by des3_set3key_enc_wrap(), and des_self_test().

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:

	ctx	DES context
	mode	DES_ENCRYPT or DES_DECRYPT
	length	length of the input data
	iv	initialization vector (updated after use)
	input	buffer holding the input data
	output	buffer holding the output data