#include "mbedtls/config.h"
#include "mbedtls/platform.h"
#include "mbedtls/debug.h"
#include <stdarg.h>
#include <stdio.h>
#include <string.h>

Include dependency graph for debug.c:

Macros
#define	DEBUG_BUF_SIZE 512

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...

static void	debug_send_line (const mbedtls_ssl_context ssl, int level, const char file, int line, const char *str)

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. 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. 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_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_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...

static void	debug_print_pk (const mbedtls_ssl_context ssl, int level, const char file, int line, const char text, const mbedtls_pk_context pk)

static void	debug_print_line_by_line (const mbedtls_ssl_context ssl, int level, const char file, int line, const char *text)

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. More...

Variables
static int	debug_threshold = 0

Macro Definition Documentation

◆ DEBUG_BUF_SIZE

#define DEBUG_BUF_SIZE 512

Function Documentation

◆ debug_print_line_by_line()

static void debug_print_line_by_line	(	const mbedtls_ssl_context *	ssl,
		int	level,
		const char *	file,
		int	line,
		const char *	text
	)

static

Here is the call graph for this function:

Here is the caller graph for this function:

◆ debug_print_pk()

static void debug_print_pk	(	const mbedtls_ssl_context *	ssl,
		int	level,
		const char *	file,
		int	line,
		const char *	text,
		const mbedtls_pk_context *	pk
	)

static

Here is the call graph for this function:

Here is the caller graph for this function:

◆ debug_send_line()

static void debug_send_line	(	const mbedtls_ssl_context *	ssl,
		int	level,
		const char *	file,
		int	line,
		const char *	str
	)

inlinestatic

Here is the caller graph for this function:

◆ mbedtls_debug_print_buf()

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.

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

Attention: This function is intended for INTERNAL usage within the library only.

Here is the call graph for this function:

◆ mbedtls_debug_print_crt()

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.

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

Attention: This function is intended for INTERNAL usage within the library only.

Here is the call graph for this function:

◆ mbedtls_debug_print_ecp()

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.

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

Attention: This function is intended for INTERNAL usage within the library only.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ mbedtls_debug_print_mpi()

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.

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

Attention: This function is intended for INTERNAL usage within the library only.

Here is the call graph for this function:

Here is the caller graph for this function:

◆ mbedtls_debug_print_msg()

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.

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

Attention: This function is intended for INTERNAL usage within the library only.

Here is the call graph for this function:

◆ mbedtls_debug_print_ret()

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.

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

Attention: This function is intended for INTERNAL usage within the library only.

Here is the call graph for this function:

◆ mbedtls_debug_set_threshold()

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 )

Parameters

threshold

theshold level of messages to filter on. Messages at a higher level will be discarded.

Debug levels
- 0 No debug
- 1 Error
- 2 State change
- 3 Informational
- 4 Verbose

Here is the caller graph for this function:

Variable Documentation

◆ debug_threshold

int debug_threshold = 0

static

Macros

Functions

Variables

Macro Definition Documentation

◆ DEBUG_BUF_SIZE

Function Documentation

◆ debug_print_line_by_line()

◆ debug_print_pk()

◆ debug_send_line()

◆ mbedtls_debug_print_buf()

◆ mbedtls_debug_print_crt()

◆ mbedtls_debug_print_ecp()

◆ mbedtls_debug_print_mpi()

◆ mbedtls_debug_print_msg()

◆ mbedtls_debug_print_ret()

◆ mbedtls_debug_set_threshold()

Variable Documentation

◆ debug_threshold