PolarSSL v1.1.4
Data Structures | Defines | Functions
sha4.h File Reference

SHA-384 and SHA-512 cryptographic hash function. More...

#include <string.h>
Include dependency graph for sha4.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  sha4_context
 SHA-512 context structure. More...

Defines

#define POLARSSL_ERR_SHA4_FILE_IO_ERROR   -0x007A
 Read/write error in file.
#define UL64(x)   x##ULL
#define long64   long long

Functions

void sha4_starts (sha4_context *ctx, int is384)
 SHA-512 context setup.
void sha4_update (sha4_context *ctx, const unsigned char *input, size_t ilen)
 SHA-512 process buffer.
void sha4_finish (sha4_context *ctx, unsigned char output[64])
 SHA-512 final digest.
void sha4 (const unsigned char *input, size_t ilen, unsigned char output[64], int is384)
 Output = SHA-512( input buffer )
int sha4_file (const char *path, unsigned char output[64], int is384)
 Output = SHA-512( file contents )
void sha4_hmac_starts (sha4_context *ctx, const unsigned char *key, size_t keylen, int is384)
 SHA-512 HMAC context setup.
void sha4_hmac_update (sha4_context *ctx, const unsigned char *input, size_t ilen)
 SHA-512 HMAC process buffer.
void sha4_hmac_finish (sha4_context *ctx, unsigned char output[64])
 SHA-512 HMAC final digest.
void sha4_hmac_reset (sha4_context *ctx)
 SHA-512 HMAC context reset.
void sha4_hmac (const unsigned char *key, size_t keylen, const unsigned char *input, size_t ilen, unsigned char output[64], int is384)
 Output = HMAC-SHA-512( hmac key, input buffer )
int sha4_self_test (int verbose)
 Checkup routine.

Detailed Description

SHA-384 and SHA-512 cryptographic hash function.

Copyright (C) 2006-2010, 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 sha4.h.


Define Documentation

#define long64   long long

Definition at line 39 of file sha4.h.

#define POLARSSL_ERR_SHA4_FILE_IO_ERROR   -0x007A

Read/write error in file.

Definition at line 32 of file sha4.h.

#define UL64 (   x)    x##ULL

Definition at line 38 of file sha4.h.


Function Documentation

void sha4 ( const unsigned char *  input,
size_t  ilen,
unsigned char  output[64],
int  is384 
)

Output = SHA-512( input buffer )

Parameters:
inputbuffer holding the data
ilenlength of the input data
outputSHA-384/512 checksum result
is3840 = use SHA512, 1 = use SHA384

Referenced by FCT_BGN().

int sha4_file ( const char *  path,
unsigned char  output[64],
int  is384 
)

Output = SHA-512( file contents )

Parameters:
pathinput file name
outputSHA-384/512 checksum result
is3840 = use SHA512, 1 = use SHA384
Returns:
0 if successful, or POLARSSL_ERR_SHA4_FILE_IO_ERROR

Referenced by FCT_BGN().

void sha4_finish ( sha4_context ctx,
unsigned char  output[64] 
)

SHA-512 final digest.

Parameters:
ctxSHA-512 context
outputSHA-384/512 checksum result
void sha4_hmac ( const unsigned char *  key,
size_t  keylen,
const unsigned char *  input,
size_t  ilen,
unsigned char  output[64],
int  is384 
)

Output = HMAC-SHA-512( hmac key, input buffer )

Parameters:
keyHMAC secret key
keylenlength of the HMAC key
inputbuffer holding the data
ilenlength of the input data
outputHMAC-SHA-384/512 result
is3840 = use SHA512, 1 = use SHA384

Referenced by FCT_BGN().

void sha4_hmac_finish ( sha4_context ctx,
unsigned char  output[64] 
)

SHA-512 HMAC final digest.

Parameters:
ctxHMAC context
outputSHA-384/512 HMAC checksum result
void sha4_hmac_reset ( sha4_context ctx)

SHA-512 HMAC context reset.

Parameters:
ctxHMAC context to be reset
void sha4_hmac_starts ( sha4_context ctx,
const unsigned char *  key,
size_t  keylen,
int  is384 
)

SHA-512 HMAC context setup.

Parameters:
ctxHMAC context to be initialized
is3840 = use SHA512, 1 = use SHA384
keyHMAC secret key
keylenlength of the HMAC key
void sha4_hmac_update ( sha4_context ctx,
const unsigned char *  input,
size_t  ilen 
)

SHA-512 HMAC process buffer.

Parameters:
ctxHMAC context
inputbuffer holding the data
ilenlength of the input data
int sha4_self_test ( int  verbose)

Checkup routine.

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

Referenced by FCT_BGN().

void sha4_starts ( sha4_context ctx,
int  is384 
)

SHA-512 context setup.

Parameters:
ctxcontext to be initialized
is3840 = use SHA512, 1 = use SHA384
void sha4_update ( sha4_context ctx,
const unsigned char *  input,
size_t  ilen 
)

SHA-512 process buffer.

Parameters:
ctxSHA-512 context
inputbuffer holding the data
ilenlength of the input data