Functions for controlling and providing debug output from the library. More...
#include "config.h"
#include "ssl.h"
#include "ecp.h"
Go to the source code of this file.
Defines | |
#define | MBEDTLS_DEBUG_STRIP_PARENS(...) __VA_ARGS__ |
#define | MBEDTLS_SSL_DEBUG_MSG(level, args) |
#define | MBEDTLS_SSL_DEBUG_RET(level, text, ret) mbedtls_debug_print_ret( ssl, level, __FILE__, __LINE__, text, ret ) |
#define | MBEDTLS_SSL_DEBUG_BUF(level, text, buf, len) mbedtls_debug_print_buf( ssl, level, __FILE__, __LINE__, text, buf, len ) |
#define | MBEDTLS_SSL_DEBUG_MPI(level, text, X) mbedtls_debug_print_mpi( ssl, level, __FILE__, __LINE__, text, X ) |
#define | MBEDTLS_SSL_DEBUG_ECP(level, text, X) mbedtls_debug_print_ecp( ssl, level, __FILE__, __LINE__, text, X ) |
#define | MBEDTLS_SSL_DEBUG_CRT(level, text, crt) mbedtls_debug_print_crt( ssl, level, __FILE__, __LINE__, text, crt ) |
Functions | |
void | mbedtls_debug_set_threshold (int threshold) |
Set the threshold error level to handle globally all debug output. Debug messages that have a level over the threshold value are discarded. (Default value: 0 = No debug ). | |
void | mbedtls_debug_print_msg (const mbedtls_ssl_context *ssl, int level, const char *file, int line, const char *format,...) |
Print a message to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_MSG() macro, which supplies the ssl context, file and line number parameters. | |
void | mbedtls_debug_print_ret (const mbedtls_ssl_context *ssl, int level, const char *file, int line, const char *text, int ret) |
Print the return value of a function to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_RET() macro, which supplies the ssl context, file and line number parameters. | |
void | mbedtls_debug_print_buf (const mbedtls_ssl_context *ssl, int level, const char *file, int line, const char *text, const unsigned char *buf, size_t len) |
Output a buffer of size len bytes to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_BUF() macro, which supplies the ssl context, file and line number parameters. | |
void | mbedtls_debug_print_mpi (const mbedtls_ssl_context *ssl, int level, const char *file, int line, const char *text, const mbedtls_mpi *X) |
Print a MPI variable to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_MPI() macro, which supplies the ssl context, file and line number parameters. | |
void | mbedtls_debug_print_ecp (const mbedtls_ssl_context *ssl, int level, const char *file, int line, const char *text, const mbedtls_ecp_point *X) |
Print an ECP point to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_ECP() macro, which supplies the ssl context, file and line number parameters. | |
void | mbedtls_debug_print_crt (const mbedtls_ssl_context *ssl, int level, const char *file, int line, const char *text, const mbedtls_x509_crt *crt) |
Print a X.509 certificate structure to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_CRT() macro, which supplies the ssl context, file and line number parameters. |
Functions for controlling and providing debug output from the library.
Definition in file debug.h.
#define MBEDTLS_SSL_DEBUG_BUF | ( | level, | |||
text, | |||||
buf, | |||||
len | ) | mbedtls_debug_print_buf( ssl, level, __FILE__, __LINE__, text, buf, len ) |
#define MBEDTLS_SSL_DEBUG_CRT | ( | level, | |||
text, | |||||
crt | ) | mbedtls_debug_print_crt( ssl, level, __FILE__, __LINE__, text, crt ) |
#define MBEDTLS_SSL_DEBUG_ECP | ( | level, | |||
text, | |||||
X | ) | mbedtls_debug_print_ecp( ssl, level, __FILE__, __LINE__, text, X ) |
#define MBEDTLS_SSL_DEBUG_MPI | ( | level, | |||
text, | |||||
X | ) | mbedtls_debug_print_mpi( ssl, level, __FILE__, __LINE__, text, X ) |
#define MBEDTLS_SSL_DEBUG_MSG | ( | level, | |||
args | ) |
mbedtls_debug_print_msg( ssl, level, __FILE__, __LINE__, \ MBEDTLS_DEBUG_STRIP_PARENS args )
#define MBEDTLS_SSL_DEBUG_RET | ( | level, | |||
text, | |||||
ret | ) | mbedtls_debug_print_ret( ssl, level, __FILE__, __LINE__, text, ret ) |
void mbedtls_debug_print_buf | ( | const mbedtls_ssl_context * | ssl, | |
int | level, | |||
const char * | file, | |||
int | line, | |||
const char * | text, | |||
const unsigned char * | buf, | |||
size_t | len | |||
) |
Output a buffer of size len bytes to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_BUF() macro, which supplies the ssl context, file and line number parameters.
ssl | SSL context | |
level | error level of the debug message | |
file | file the error has occurred in | |
line | line number the error has occurred in | |
text | a name or label for the buffer being dumped. Normally the variable or buffer name | |
buf | the buffer to be outputted | |
len | length of the buffer |
void mbedtls_debug_print_crt | ( | const mbedtls_ssl_context * | ssl, | |
int | level, | |||
const char * | file, | |||
int | line, | |||
const char * | text, | |||
const mbedtls_x509_crt * | crt | |||
) |
Print a X.509 certificate structure to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_CRT() macro, which supplies the ssl context, file and line number parameters.
ssl | SSL context | |
level | error level of the debug message | |
file | file the error has occurred in | |
line | line number the error has occurred in | |
text | a name or label for the certificate being output | |
crt | X.509 certificate structure |
void mbedtls_debug_print_ecp | ( | const mbedtls_ssl_context * | ssl, | |
int | level, | |||
const char * | file, | |||
int | line, | |||
const char * | text, | |||
const mbedtls_ecp_point * | X | |||
) |
Print an ECP point to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_ECP() macro, which supplies the ssl context, file and line number parameters.
ssl | SSL context | |
level | error level of the debug message | |
file | file the error has occurred in | |
line | line number the error has occurred in | |
text | a name or label for the ECP point being output. Normally the variable name | |
X | the ECP point |
void mbedtls_debug_print_mpi | ( | const mbedtls_ssl_context * | ssl, | |
int | level, | |||
const char * | file, | |||
int | line, | |||
const char * | text, | |||
const mbedtls_mpi * | X | |||
) |
Print a MPI variable to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_MPI() macro, which supplies the ssl context, file and line number parameters.
ssl | SSL context | |
level | error level of the debug message | |
file | file the error has occurred in | |
line | line number the error has occurred in | |
text | a name or label for the MPI being output. Normally the variable name | |
X | the MPI variable |
void mbedtls_debug_print_msg | ( | const mbedtls_ssl_context * | ssl, | |
int | level, | |||
const char * | file, | |||
int | line, | |||
const char * | format, | |||
... | ||||
) |
Print a message to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_MSG() macro, which supplies the ssl context, file and line number parameters.
ssl | SSL context | |
level | error level of the debug message | |
file | file the message has occurred in | |
line | line number the message has occurred at | |
format | format specifier, in printf format | |
... | variables used by the format specifier |
void mbedtls_debug_print_ret | ( | const mbedtls_ssl_context * | ssl, | |
int | level, | |||
const char * | file, | |||
int | line, | |||
const char * | text, | |||
int | ret | |||
) |
Print the return value of a function to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_RET() macro, which supplies the ssl context, file and line number parameters.
ssl | SSL context | |
level | error level of the debug message | |
file | file the error has occurred in | |
line | line number the error has occurred in | |
text | the name of the function that returned the error | |
ret | the return code value |
void mbedtls_debug_set_threshold | ( | int | threshold | ) |
Set the threshold error level to handle globally all debug output. Debug messages that have a level over the threshold value are discarded. (Default value: 0 = No debug ).
threshold | theshold level of messages to filter on. Messages at a higher level will be discarded.
|