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!

sha1.h File Reference

This file contains SHA-1 definitions and functions. More...

#include "config.h"
#include <stddef.h>
#include <stdint.h>
Include dependency graph for sha1.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  mbedtls_sha1_context
 The SHA-1 context structure. More...
 

Macros

#define MBEDTLS_ERR_SHA1_HW_ACCEL_FAILED   -0x0035
 SHA-1 hardware accelerator failed. More...
 
#define MBEDTLS_DEPRECATED
 
#define MBEDTLS_DEPRECATED
 

Typedefs

typedef struct mbedtls_sha1_context mbedtls_sha1_context
 The SHA-1 context structure. More...
 

Functions

void mbedtls_sha1_init (mbedtls_sha1_context *ctx)
 This function initializes a SHA-1 context. More...
 
void mbedtls_sha1_free (mbedtls_sha1_context *ctx)
 This function clears a SHA-1 context. More...
 
void mbedtls_sha1_clone (mbedtls_sha1_context *dst, const mbedtls_sha1_context *src)
 This function clones the state of a SHA-1 context. More...
 
int mbedtls_sha1_starts_ret (mbedtls_sha1_context *ctx)
 This function starts a SHA-1 checksum calculation. More...
 
int mbedtls_sha1_update_ret (mbedtls_sha1_context *ctx, const unsigned char *input, size_t ilen)
 This function feeds an input buffer into an ongoing SHA-1 checksum calculation. More...
 
int mbedtls_sha1_finish_ret (mbedtls_sha1_context *ctx, unsigned char output[20])
 This function finishes the SHA-1 operation, and writes the result to the output buffer. More...
 
int mbedtls_internal_sha1_process (mbedtls_sha1_context *ctx, const unsigned char data[64])
 SHA-1 process data block (internal use only). More...
 
MBEDTLS_DEPRECATED void mbedtls_sha1_starts (mbedtls_sha1_context *ctx)
 This function starts a SHA-1 checksum calculation. More...
 
MBEDTLS_DEPRECATED void mbedtls_sha1_update (mbedtls_sha1_context *ctx, const unsigned char *input, size_t ilen)
 This function feeds an input buffer into an ongoing SHA-1 checksum calculation. More...
 
MBEDTLS_DEPRECATED void mbedtls_sha1_finish (mbedtls_sha1_context *ctx, unsigned char output[20])
 This function finishes the SHA-1 operation, and writes the result to the output buffer. More...
 
MBEDTLS_DEPRECATED void mbedtls_sha1_process (mbedtls_sha1_context *ctx, const unsigned char data[64])
 SHA-1 process data block (internal use only). More...
 
int mbedtls_sha1_ret (const unsigned char *input, size_t ilen, unsigned char output[20])
 This function calculates the SHA-1 checksum of a buffer. More...
 
MBEDTLS_DEPRECATED void mbedtls_sha1 (const unsigned char *input, size_t ilen, unsigned char output[20])
 This function calculates the SHA-1 checksum of a buffer. More...
 
int mbedtls_sha1_self_test (int verbose)
 The SHA-1 checkup routine. More...
 

Detailed Description

This file contains SHA-1 definitions and functions.

The Secure Hash Algorithm 1 (SHA-1) cryptographic hash function is defined in FIPS 180-4: Secure Hash Standard (SHS).

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.

Definition in file sha1.h.

Macro Definition Documentation

#define MBEDTLS_DEPRECATED

Definition at line 278 of file sha1.h.

#define MBEDTLS_DEPRECATED

Definition at line 278 of file sha1.h.

#define MBEDTLS_ERR_SHA1_HW_ACCEL_FAILED   -0x0035

SHA-1 hardware accelerator failed.

Definition at line 43 of file sha1.h.

Typedef Documentation

The SHA-1 context structure.

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.

Function Documentation

int mbedtls_internal_sha1_process ( mbedtls_sha1_context ctx,
const unsigned char  data[64] 
)

SHA-1 process data block (internal use only).

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Parameters
ctxThe SHA-1 context.
dataThe data block being processed.
Returns
0 on success.
MBEDTLS_DEPRECATED void mbedtls_sha1 ( const unsigned char *  input,
size_t  ilen,
unsigned char  output[20] 
)

This function calculates the SHA-1 checksum of a buffer.

The function allocates the context, performs the calculation, and frees the context.

The SHA-1 result is calculated as output = SHA-1(input buffer).

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Deprecated:
Superseded by mbedtls_sha1_ret() in 2.7.0
Parameters
inputThe buffer holding the input data.
ilenThe length of the input data.
outputThe SHA-1 checksum result.
void mbedtls_sha1_clone ( mbedtls_sha1_context dst,
const mbedtls_sha1_context src 
)

This function clones the state of a SHA-1 context.

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Parameters
dstThe SHA-1 context to clone to.
srcThe SHA-1 context to clone from.
MBEDTLS_DEPRECATED void mbedtls_sha1_finish ( mbedtls_sha1_context ctx,
unsigned char  output[20] 
)

This function finishes the SHA-1 operation, and writes the result to the output buffer.

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Deprecated:
Superseded by mbedtls_sha1_finish_ret() in 2.7.0.
Parameters
ctxThe SHA-1 context.
outputThe SHA-1 checksum result.
int mbedtls_sha1_finish_ret ( mbedtls_sha1_context ctx,
unsigned char  output[20] 
)

This function finishes the SHA-1 operation, and writes the result to the output buffer.

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Parameters
ctxThe SHA-1 context.
outputThe SHA-1 checksum result.
Returns
0 on success.
void mbedtls_sha1_free ( mbedtls_sha1_context ctx)

This function clears a SHA-1 context.

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Parameters
ctxThe SHA-1 context to clear.
void mbedtls_sha1_init ( mbedtls_sha1_context ctx)

This function initializes a SHA-1 context.

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Parameters
ctxThe SHA-1 context to initialize.
MBEDTLS_DEPRECATED void mbedtls_sha1_process ( mbedtls_sha1_context ctx,
const unsigned char  data[64] 
)

SHA-1 process data block (internal use only).

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Deprecated:
Superseded by mbedtls_internal_sha1_process() in 2.7.0.
Parameters
ctxThe SHA-1 context.
dataThe data block being processed.
int mbedtls_sha1_ret ( const unsigned char *  input,
size_t  ilen,
unsigned char  output[20] 
)

This function calculates the SHA-1 checksum of a buffer.

The function allocates the context, performs the calculation, and frees the context.

The SHA-1 result is calculated as output = SHA-1(input buffer).

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Parameters
inputThe buffer holding the input data.
ilenThe length of the input data.
outputThe SHA-1 checksum result.
Returns
0 on success.
int mbedtls_sha1_self_test ( int  verbose)

The SHA-1 checkup routine.

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Returns
0 on success.
1 on failure.
MBEDTLS_DEPRECATED void mbedtls_sha1_starts ( mbedtls_sha1_context ctx)

This function starts a SHA-1 checksum calculation.

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Deprecated:
Superseded by mbedtls_sha1_starts_ret() in 2.7.0.
Parameters
ctxThe SHA-1 context to initialize.
int mbedtls_sha1_starts_ret ( mbedtls_sha1_context ctx)

This function starts a SHA-1 checksum calculation.

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Parameters
ctxThe SHA-1 context to initialize.
Returns
0 on success.
MBEDTLS_DEPRECATED void mbedtls_sha1_update ( mbedtls_sha1_context ctx,
const unsigned char *  input,
size_t  ilen 
)

This function feeds an input buffer into an ongoing SHA-1 checksum calculation.

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Deprecated:
Superseded by mbedtls_sha1_update_ret() in 2.7.0.
Parameters
ctxThe SHA-1 context.
inputThe buffer holding the input data.
ilenThe length of the input data.
int mbedtls_sha1_update_ret ( mbedtls_sha1_context ctx,
const unsigned char *  input,
size_t  ilen 
)

This function feeds an input buffer into an ongoing SHA-1 checksum calculation.

Warning
SHA-1 is considered a weak message digest and its use constitutes a security risk. We recommend considering stronger message digests instead.
Parameters
ctxThe SHA-1 context.
inputThe buffer holding the input data.
ilenThe length of the input data.
Returns
0 on success.