mbed TLS v3.1.0
|
Functions for controlling and providing debug output from the library. More...
Go to the source code of this file.
Macros | |
#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) do { } while( 0 ) |
#define | MBEDTLS_SSL_DEBUG_ECDH(level, ecdh, attr) mbedtls_debug_printf_ecdh( ssl, level, __FILE__, __LINE__, ecdh, attr ) |
#define | MBEDTLS_PRINTF_ATTRIBUTE(string_index, first_to_check) |
#define | MBEDTLS_PRINTF_SIZET "zu" |
#define | MBEDTLS_PRINTF_LONGLONG "lld" |
Enumerations | |
enum | mbedtls_debug_ecdh_attr { MBEDTLS_DEBUG_ECDH_Q, MBEDTLS_DEBUG_ECDH_QP, MBEDTLS_DEBUG_ECDH_Z } |
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 ) More... | |
void | mbedtls_debug_print_msg (const mbedtls_ssl_context *ssl, int level, const char *file, int line, const char *format,...) MBEDTLS_PRINTF_ATTRIBUTE(5 |
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. More... | |
void 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. More... | |
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. More... | |
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. More... | |
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. More... | |
void | mbedtls_debug_printf_ecdh (const mbedtls_ssl_context *ssl, int level, const char *file, int line, const mbedtls_ecdh_context *ecdh, mbedtls_debug_ecdh_attr attr) |
Print a field of the ECDH structure in the SSL context to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_ECDH() macro, which supplies the ssl context, file and line number parameters. More... | |
Functions for controlling and providing debug output from the library.
Definition in file debug.h.
#define MBEDTLS_PRINTF_ATTRIBUTE | ( | string_index, | |
first_to_check | |||
) |
#define MBEDTLS_PRINTF_SIZET "zu" |
#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 | |||
) | do { } while( 0 ) |
#define MBEDTLS_SSL_DEBUG_ECDH | ( | level, | |
ecdh, | |||
attr | |||
) | mbedtls_debug_printf_ecdh( ssl, level, __FILE__, __LINE__, ecdh, attr ) |
#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 | |||
) |
#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_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 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_printf_ecdh | ( | const mbedtls_ssl_context * | ssl, |
int | level, | ||
const char * | file, | ||
int | line, | ||
const mbedtls_ecdh_context * | ecdh, | ||
mbedtls_debug_ecdh_attr | attr | ||
) |
Print a field of the ECDH structure in the SSL context to the debug output. This function is always used through the MBEDTLS_SSL_DEBUG_ECDH() 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 |
ecdh | the ECDH context |
attr | the identifier of the attribute being output |
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.
|