mbed TLS v2.3.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) 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. More... | |
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. More... | |
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. 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. 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. 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. More... | |
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. More... | |
Functions for controlling and providing debug output from the library.
Copyright (C) 2006-2015, ARM Limited, All Rights Reserved SPDX-License-Identifier: Apache-2.0
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
This file is part of mbed TLS (https://tls.mbed.org)
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 | |||
) |
#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.
|