Skip to content
GitLab
Menu
Projects
Groups
Snippets
Loading...
Help
Help
Support
Community forum
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in
Toggle navigation
Menu
Open sidebar
BC
public
external
mbedtls
Commits
f3b86c1e
Commit
f3b86c1e
authored
Jan 27, 2011
by
Paul Bakker
Browse files
- Updated Doxygen documentation generation and documentation on small parts
parent
0a62cd1a
Changes
18
Hide whitespace changes
Inline
Side-by-side
doxygen/input/doc_encdec.h
View file @
f3b86c1e
...
...
@@ -12,21 +12,23 @@
* ones for key exchange and message integrity.
* Some symmetric algorithms provide different block cipher modes, mainly
* Electronic Code Book (ECB) which is used for short (64-bit) messages and
* Cipher Block Chaining (CBC) which provides the randomness needed for longer
* messages.
* Cipher Block Chaining (CBC) which provides the structure needed for longer
* messages. In addition the Cipher Feedback Mode (CFB-128) stream cipher mode
* is implemented for specific algorithms.
*
* Sometimes the same functions are used for encryption and decryption.
* The following algorithms are provided:
* - Symmetric:
* - AES (see \c aes_crypt_ecb() and\c aes_crypt_c
bc
()).
* - AES (see \c aes_crypt_ecb()
, \c aes_crypt_cbc()
and
\c aes_crypt_c
fb128
()).
* - ARCFOUR (see \c arc4_crypt()).
* - Camellia (see \c camellia_crypt_ecb() and\c camellia_crypt_c
bc
()).
* - DES/3DES (see \c des_crypt_ecb(),\c des_crypt_cbc(),\c des3_crypt_ecb()
* and\c des3_crypt_cbc()).
* - Camellia (see \c camellia_crypt_ecb()
, \c camellia_crypt_cbc()
and
\c camellia_crypt_c
fb128
()).
* - DES/3DES (see \c des_crypt_ecb(),
\c des_crypt_cbc(),
\c des3_crypt_ecb()
* and
\c des3_crypt_cbc()).
* - XTEA (see \c xtea_crypt_ecb()).
* - Asymmetric:
* - Diffie-Hellman-Merkle (see \c dhm_read_public(),\c dhm_make_public()
* - Diffie-Hellman-Merkle (see \c dhm_read_public(),
\c dhm_make_public()
* and \c dhm_calc_secret()).
* - RSA (see \c rsa_public() and\c rsa_private()).
* - RSA (see \c rsa_public() and
\c rsa_private()).
*
* This module provides encryption/decryption which can be used to provide
* secrecy.
...
...
doxygen/input/doc_hashing.h
View file @
f3b86c1e
...
...
@@ -12,9 +12,9 @@
* for authentication, which is a message integrity control.
* The following hashing-algorithms are provided:
* - MD2, MD4, MD5 128-bit one-way hash functions by Ron Rivest (see
* \c md2_hmac(),\c md4_hmac() and\c md5_hmac()).
* \c md2_hmac(),
\c md4_hmac() and
\c md5_hmac()).
* - SHA-1, SHA-256, SHA-384/512 160-bit or more one-way hash functions by
* NIST and NSA (see\c sha1_hmac(),\c sha2_hmac() and\c sha4_hmac()).
* NIST and NSA (see\c sha1_hmac(),
\c sha2_hmac() and
\c sha4_hmac()).
*
* This module provides one-way hashing which can be used for authentication.
*/
doxygen/input/doc_ssltls.h
View file @
f3b86c1e
...
...
@@ -11,7 +11,7 @@
* The basic provisions are:
* - initialise an SSL/TLS context (see \c ssl_init()).
* - perform an SSL/TLS handshake (see \c ssl_handshake()).
* - read/write (see \c ssl_read() and\c ssl_write()).
* - read/write (see \c ssl_read() and
\c ssl_write()).
* - notify a peer that conection is being closed (see \c ssl_close_notify()).
*
*
...
...
doxygen/input/doc_tcpip.h
View file @
f3b86c1e
...
...
@@ -15,7 +15,7 @@
* its basic provisions:
* - listening on a port (see \c net_bind()).
* - accepting a connection (through \c net_accept()).
* - read/write (through \c net_recv/\c net_send()).
* - read/write (through \c net_recv
()
/\c net_send()).
* - close a connection (through \c net_close()).
*
* This way you have the means to, for example, implement and use an UDP or
...
...
doxygen/polarssl.doxyfile
View file @
f3b86c1e
...
...
@@ -614,7 +614,9 @@ RECURSIVE = YES
# excluded from the INPUT source files. This way you can easily exclude a
# subdirectory from a directory tree whose root is specified with the INPUT tag.
EXCLUDE = tests/fct.h
EXCLUDE = tests/fct.h \
programs \
CMakeFiles
# The EXCLUDE_SYMLINKS tag can be used select whether or not files or
# directories that are symbolic links (a Unix filesystem feature) are excluded
...
...
include/polarssl/aes.h
View file @
f3b86c1e
/**
* \file aes.h
*
* \brief AES block cipher
encryption
* \brief AES block cipher
*
* Copyright (C) 2006-2010, Brainspark B.V.
*
...
...
include/polarssl/certs.h
View file @
f3b86c1e
/**
* \file certs.h
*
* \brief
C
am
ellia block cipher
* \brief
S
am
ple certificates and DHM parameters for testing
*
* Copyright (C) 2006-2010, Brainspark B.V.
*
...
...
include/polarssl/cipher.h
View file @
f3b86c1e
...
...
@@ -296,7 +296,7 @@ static inline int cipher_get_key_size ( const cipher_context_t *ctx )
*
* \returns 0 on success, 1 if parameter verification fails.
*/
int
cipher_setkey
(
cipher_context_t
*
ctx
,
const
unsigned
char
*
key
,
int
key_len
,
int
cipher_setkey
(
cipher_context_t
*
ctx
,
const
unsigned
char
*
key
,
int
key_len
gth
,
const
operation_t
operation
);
/**
...
...
include/polarssl/config.h
View file @
f3b86c1e
...
...
@@ -35,32 +35,45 @@
#define _CRT_SECURE_NO_DEPRECATE 1
#endif
/*
/*
*
* \name SECTION: System support
*
* This section sets system specific settings.
* \{
*/
/*
* Uncomment if native integers are 8-bit wide.
/**
* \def POLARSSL_HAVE_INT8
*
* The system uses 8-bit wide native integers.
*
* Uncomment if native integers are 8-bit wide.
#define POLARSSL_HAVE_INT8
*/
/*
* Uncomment if native integers are 16-bit wide.
/**
* \def POLARSSL_HAVE_INT16
*
* The system uses 16-bit wide native integers.
*
* Uncomment if native integers are 16-bit wide.
#define POLARSSL_HAVE_INT16
*/
/*
* Uncomment if the compiler supports long long.
/**
* \def POLARSSL_HAVE_LONGLONG
*
* The compiler supports the use of long long.
*
* Uncomment if the compiler supports long long.
#define POLARSSL_HAVE_LONGLONG
*/
/*
/**
* \def POLARSSL_HAVE_ASM
*
* The compiler has support for asm()
*
* Uncomment to enable the use of assembly code.
*
* Requires support for asm() in compiler.
...
...
@@ -73,14 +86,18 @@
*/
#define POLARSSL_HAVE_ASM
/*
/**
* \def POLARSSL_HAVE_SSE2
*
* CPI supports SSE2 instruction set.
*
* Uncomment if the CPU supports SSE2 (IA-32 specific).
*
#define POLARSSL_HAVE_SSE2
*/
/* \} name */
/*
/*
*
* \name SECTION: PolarSSL feature support
*
* This section sets support for features that are or are not needed
...
...
@@ -88,36 +105,50 @@
* \{
*/
/*
/**
* \def POLARSSL_DEBUG_MSG
*
* Enable all SSL/TLS debugging messages.
*/
#define POLARSSL_DEBUG_MSG
/*
/**
* \def POLARSSL_SELF_TEST
*
* Enable the checkup functions (*_self_test).
*/
#define POLARSSL_SELF_TEST
/*
/**
* \def POLARSSL_GENPRIME
*
* Enable the prime-number generation code.
*/
#define POLARSSL_GENPRIME
/*
/**
* \def POLARSSL_AES_ROM_TABLES
*
* Store the AES tables in ROM.
*
* Uncomment this macro to store the AES tables in ROM.
*
#define POLARSSL_AES_ROM_TABLES
*/
/* \} name */
/*
/*
*
* \name SECTION: PolarSSL modules
*
* This section enables or disables entire modules in PolarSSL
* \{
*/
/*
/**
* \def POLARSSL_AES_C
*
* Enable the AES block cipher.
*
* Module: library/aes.c
* Caller: library/ssl_tls.c
*
...
...
@@ -128,7 +159,11 @@
*/
#define POLARSSL_AES_C
/*
/**
* \def POLARSSL_ARC4_C
*
* Enable the ARCFOUR stream cipher.
*
* Module: library/arc4.c
* Caller: library/ssl_tls.c
*
...
...
@@ -138,7 +173,11 @@
*/
#define POLARSSL_ARC4_C
/*
/**
* \def POLARSSL_BASE64_C
*
* Enable the Base64 module.
*
* Module: library/base64.c
* Caller: library/x509parse.c
*
...
...
@@ -146,7 +185,11 @@
*/
#define POLARSSL_BASE64_C
/*
/**
* \def POLARSSL_BIGNUM_C
*
* Enable the multo-precision integer library.
*
* Module: library/bignum.c
* Caller: library/dhm.c
* library/rsa.c
...
...
@@ -157,7 +200,11 @@
*/
#define POLARSSL_BIGNUM_C
/*
/**
* \def POLARSSL_CAMELLIA_C
*
* Enable the Camellia block cipher.
*
* Module: library/camellia.c
* Caller: library/ssl_tls.c
*
...
...
@@ -168,7 +215,11 @@
*/
#define POLARSSL_CAMELLIA_C
/*
/**
* \def POLARSSL_CERTS_C
*
* Enable the test certificates.
*
* Module: library/certs.c
* Caller:
*
...
...
@@ -176,7 +227,11 @@
*/
#define POLARSSL_CERTS_C
/*
/**
* \def POLARSSL_CIPHER_C
*
* Enable the generic cipher layer.
*
* Module: library/cipher.c
* Caller:
*
...
...
@@ -184,7 +239,11 @@
*/
#define POLARSSL_CIPHER_C
/*
/**
* \def POLARSSL_DEBUG_C
*
* Enable the debug functions.
*
* Module: library/debug.c
* Caller: library/ssl_cli.c
* library/ssl_srv.c
...
...
@@ -194,7 +253,11 @@
*/
#define POLARSSL_DEBUG_C
/*
/**
* \def POLARSSL_DES_C
*
* Enable the DES block cipher.
*
* Module: library/des.c
* Caller: library/ssl_tls.c
*
...
...
@@ -204,7 +267,11 @@
*/
#define POLARSSL_DES_C
/*
/**
* \def POLARSSL_DHM_C
*
* Enable the Diffie-Hellman-Merkle key exchange.
*
* Module: library/dhm.c
* Caller: library/ssl_cli.c
* library/ssl_srv.c
...
...
@@ -216,7 +283,11 @@
*/
#define POLARSSL_DHM_C
/*
/**
* \def POLARSSL_HAVEGE_C
*
* Enable the HAVEGE random generator.
*
* Module: library/havege.c
* Caller:
*
...
...
@@ -224,7 +295,11 @@
*/
#define POLARSSL_HAVEGE_C
/*
/**
* \def POLARSSL_MD_C
*
* Enable the generic message digest layer.
*
* Module: library/md.c
* Caller:
*
...
...
@@ -232,7 +307,11 @@
*/
#define POLARSSL_MD_C
/*
/**
* \def POLARSSL_MD2_C
*
* Enable the MD2 hash algorithm
*
* Module: library/md2.c
* Caller: library/x509parse.c
*
...
...
@@ -241,7 +320,11 @@
#define POLARSSL_MD2_C
*/
/*
/**
* \def POLARSSL_MD4_C
*
* Enable the MD4 hash algorithm
*
* Module: library/md4.c
* Caller: library/x509parse.c
*
...
...
@@ -250,7 +333,11 @@
#define POLARSSL_MD4_C
*/
/*
/**
* \def POLARSSL_MD5_C
*
* Enable the MD5 hash algorithm
*
* Module: library/md5.c
* Caller: library/ssl_tls.c
* library/x509parse.c
...
...
@@ -259,7 +346,11 @@
*/
#define POLARSSL_MD5_C
/*
/**
* \def POLARSSL_NET_C
*
* Enable the TCP/IP networking routines.
*
* Module: library/net.c
* Caller:
*
...
...
@@ -267,7 +358,11 @@
*/
#define POLARSSL_NET_C
/*
/**
* \def POLARSSL_PADLOCK_C
*
* Enable VIA Padlock support on x86.
*
* Module: library/padlock.c
* Caller: library/aes.c
*
...
...
@@ -275,7 +370,11 @@
*/
#define POLARSSL_PADLOCK_C
/*
/**
* \def POLARSSL_RSA_C
*
* Enable the RSA public-key cryptosystem.
*
* Module: library/rsa.c
* Caller: library/ssl_cli.c
* library/ssl_srv.c
...
...
@@ -286,7 +385,11 @@
*/
#define POLARSSL_RSA_C
/*
/**
* \def POLARSSL_SHA1_C
*
* Enable the SHA1 cryptographic hash algorithm.
*
* Module: library/sha1.c
* Caller: library/ssl_cli.c
* library/ssl_srv.c
...
...
@@ -297,23 +400,37 @@
*/
#define POLARSSL_SHA1_C
/*
/**
* \def POLARSSL_SHA2_C
*
* Enable the SHA-224 and SHA-256 cryptographic hash algorithms.
*
* Module: library/sha2.c
* Caller:
* Caller: library/md_wrap.c
* library/x509parse.c
*
* This module adds support for SHA-224 and SHA-256.
*/
#define POLARSSL_SHA2_C
/*
/**
* \def POLARSSL_SHA4_C
*
* Enable the SHA-384 and SHA-512 cryptographic hash algorithms.
*
* Module: library/sha4.c
* Caller:
* Caller: library/md_wrap.c
* library/x509parse.c
*
* This module adds support for SHA-384 and SHA-512.
*/
#define POLARSSL_SHA4_C
/*
/**
* \def POLARSSL_SSL_CLI_C
*
* Enable the SSL/TLS client code.
*
* Module: library/ssl_cli.c
* Caller:
*
...
...
@@ -322,6 +439,10 @@
#define POLARSSL_SSL_CLI_C
/*
* \def POLARSSL_SSL_SRV_C
*
* Enable the SSL/TLS server code.
*
* Module: library/ssl_srv.c
* Caller:
*
...
...
@@ -329,7 +450,11 @@
*/
#define POLARSSL_SSL_SRV_C
/*
/**
* \def POLARSSL_SSL_TLS_C
*
* Enable the generic SSL/RLS code.
*
* Module: library/ssl_tls.c
* Caller: library/ssl_cli.c
* library/ssl_srv.c
...
...
@@ -338,7 +463,11 @@
*/
#define POLARSSL_SSL_TLS_C
/*
/**
* \def POLARSSL_PKCS11_C
*
* Enable support for PKCS#11 smartcard support.
*
* Module: library/ssl_srv.c
* Caller: library/ssl_cli.c
* library/ssl_srv.c
...
...
@@ -348,7 +477,11 @@
#define POLARSSL_PKCS11_C
*/
/*
/**
* \def POLARSSL_TIMING_C
*
* Enable the portable timing interface.
*
* Module: library/timing.c
* Caller: library/havege.c
*
...
...
@@ -356,14 +489,22 @@
*/
#define POLARSSL_TIMING_C
/*
/**
* \def POLARSSL_VERSION_C
*
* Enable run-time version information.
*
* Module: library/version.c
*
* This module provides run-time version information.
*/
#define POLARSSL_VERSION_C
/*
/**
* \def POLARSSL_X509_PARSE_C
*
* Enable X.509 certificate parsing.
*
* Module: library/x509parse.c
* Caller: library/ssl_cli.c
* library/ssl_srv.c
...
...
@@ -373,15 +514,11 @@
*/
#define POLARSSL_X509_PARSE_C
/*
* Module: library/x509_write.c
* Caller:
/**
* \def POLARSSL_XTEA_C
*
* Enable the XTEA block cipher.
*
* This module is required for X.509 certificate writing.
*/
#define POLARSSL_X509_WRITE_C
/*
* Module: library/xtea.c
* Caller:
*/
...
...
include/polarssl/des.h
View file @
f3b86c1e
/**
* \file des.h
*
* \brief D
ebug functions
* \brief D
ES block cipher
*
* Copyright (C) 2006-2010, Brainspark B.V.
*
...
...
include/polarssl/dhm.h
View file @
f3b86c1e
...
...
@@ -29,6 +29,9 @@
#include "polarssl/bignum.h"
/*
* DHM Error codes
*/
#define POLARSSL_ERR_DHM_BAD_INPUT_DATA 0x0480
#define POLARSSL_ERR_DHM_READ_PARAMS_FAILED 0x0490
#define POLARSSL_ERR_DHM_MAKE_PARAMS_FAILED 0x04A0
...
...
@@ -36,6 +39,9 @@
#define POLARSSL_ERR_DHM_MAKE_PUBLIC_FAILED 0x04C0
#define POLARSSL_ERR_DHM_CALC_SECRET_FAILED 0x04D0
/**
* \brief DHM context structure
*/
typedef
struct
{
int
len
;
/*!< size(P) in chars */
...
...
include/polarssl/havege.h
View file @
f3b86c1e
/**
* \file havege.h
*
* \brief
Diffie-Hellman-Merkle key exchange
* \brief
HAVEGE: HArdware Volatile Entropy Gathering and Expansion
*
* Copyright (C) 2006-2010, Brainspark B.V.
*
...
...
include/polarssl/md.h
View file @
f3b86c1e
...
...
@@ -167,8 +167,7 @@ int md_init_ctx( md_context_t *ctx, const md_info_t *md_info );
* \brief Free the message-specific context of ctx. Freeing ctx itself
* remains the responsibility of the caller.
*
* \param ctx Free the -specific context
* \param output Generic message digest checksum result
* \param ctx Free the message-specific context
*
* \returns 0 on success, 1 if parameter verification fails.
*/
...
...
include/polarssl/sha2.h
View file @
f3b86c1e
/**
* \file sha2.h
*
* \brief SHA-256 cryptographic hash function
* \brief
SHA-224 and
SHA-256 cryptographic hash function
*
* Copyright (C) 2006-2010, Brainspark B.V.
*
...
...
include/polarssl/sha4.h
View file @
f3b86c1e