ReactOS  0.4.15-dev-3428-g0609db5
debug.h
Go to the documentation of this file.
1 
6 /*
7  * Copyright The Mbed TLS Contributors
8  * SPDX-License-Identifier: Apache-2.0 OR GPL-2.0-or-later
9  *
10  * This file is provided under the Apache License 2.0, or the
11  * GNU General Public License v2.0 or later.
12  *
13  * **********
14  * Apache License 2.0:
15  *
16  * Licensed under the Apache License, Version 2.0 (the "License"); you may
17  * not use this file except in compliance with the License.
18  * You may obtain a copy of the License at
19  *
20  * http://www.apache.org/licenses/LICENSE-2.0
21  *
22  * Unless required by applicable law or agreed to in writing, software
23  * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
24  * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
25  * See the License for the specific language governing permissions and
26  * limitations under the License.
27  *
28  * **********
29  *
30  * **********
31  * GNU General Public License v2.0 or later:
32  *
33  * This program is free software; you can redistribute it and/or modify
34  * it under the terms of the GNU General Public License as published by
35  * the Free Software Foundation; either version 2 of the License, or
36  * (at your option) any later version.
37  *
38  * This program is distributed in the hope that it will be useful,
39  * but WITHOUT ANY WARRANTY; without even the implied warranty of
40  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
41  * GNU General Public License for more details.
42  *
43  * You should have received a copy of the GNU General Public License along
44  * with this program; if not, write to the Free Software Foundation, Inc.,
45  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
46  *
47  * **********
48  */
49 #ifndef MBEDTLS_DEBUG_H
50 #define MBEDTLS_DEBUG_H
51 
52 #if !defined(MBEDTLS_CONFIG_FILE)
53 #include "config.h"
54 #else
55 #include MBEDTLS_CONFIG_FILE
56 #endif
57 
58 #include "ssl.h"
59 
60 #if defined(MBEDTLS_ECP_C)
61 #include "ecp.h"
62 #endif
63 
64 #if defined(MBEDTLS_DEBUG_C)
65 
66 #define MBEDTLS_DEBUG_STRIP_PARENS( ... ) __VA_ARGS__
67 
68 #define MBEDTLS_SSL_DEBUG_MSG( level, args ) \
69  mbedtls_debug_print_msg( ssl, level, __FILE__, __LINE__, \
70  MBEDTLS_DEBUG_STRIP_PARENS args )
71 
72 #define MBEDTLS_SSL_DEBUG_RET( level, text, ret ) \
73  mbedtls_debug_print_ret( ssl, level, __FILE__, __LINE__, text, ret )
74 
75 #define MBEDTLS_SSL_DEBUG_BUF( level, text, buf, len ) \
76  mbedtls_debug_print_buf( ssl, level, __FILE__, __LINE__, text, buf, len )
77 
78 #if defined(MBEDTLS_BIGNUM_C)
79 #define MBEDTLS_SSL_DEBUG_MPI( level, text, X ) \
80  mbedtls_debug_print_mpi( ssl, level, __FILE__, __LINE__, text, X )
81 #endif
82 
83 #if defined(MBEDTLS_ECP_C)
84 #define MBEDTLS_SSL_DEBUG_ECP( level, text, X ) \
85  mbedtls_debug_print_ecp( ssl, level, __FILE__, __LINE__, text, X )
86 #endif
87 
88 #if defined(MBEDTLS_X509_CRT_PARSE_C)
89 #define MBEDTLS_SSL_DEBUG_CRT( level, text, crt ) \
90  mbedtls_debug_print_crt( ssl, level, __FILE__, __LINE__, text, crt )
91 #endif
92 
93 #if defined(MBEDTLS_ECDH_C)
94 #define MBEDTLS_SSL_DEBUG_ECDH( level, ecdh, attr ) \
95  mbedtls_debug_printf_ecdh( ssl, level, __FILE__, __LINE__, ecdh, attr )
96 #endif
97 
98 #else /* MBEDTLS_DEBUG_C */
99 
100 #define MBEDTLS_SSL_DEBUG_MSG( level, args ) do { } while( 0 )
101 #define MBEDTLS_SSL_DEBUG_RET( level, text, ret ) do { } while( 0 )
102 #define MBEDTLS_SSL_DEBUG_BUF( level, text, buf, len ) do { } while( 0 )
103 #define MBEDTLS_SSL_DEBUG_MPI( level, text, X ) do { } while( 0 )
104 #define MBEDTLS_SSL_DEBUG_ECP( level, text, X ) do { } while( 0 )
105 #define MBEDTLS_SSL_DEBUG_CRT( level, text, crt ) do { } while( 0 )
106 #define MBEDTLS_SSL_DEBUG_ECDH( level, ecdh, attr ) do { } while( 0 )
107 
108 #endif /* MBEDTLS_DEBUG_C */
109 
110 #ifdef __cplusplus
111 extern "C" {
112 #endif
113 
129 void mbedtls_debug_set_threshold( int threshold );
130 
147  const char *file, int line,
148  const char *format, ... );
149 
166  const char *file, int line,
167  const char *text, int ret );
168 
187  const char *file, int line, const char *text,
188  const unsigned char *buf, size_t len );
189 
190 #if defined(MBEDTLS_BIGNUM_C)
191 
208  const char *file, int line,
209  const char *text, const mbedtls_mpi *X );
210 #endif
211 
212 #if defined(MBEDTLS_ECP_C)
213 
230  const char *file, int line,
231  const char *text, const mbedtls_ecp_point *X );
232 #endif
233 
234 #if defined(MBEDTLS_X509_CRT_PARSE_C)
235 
251  const char *file, int line,
252  const char *text, const mbedtls_x509_crt *crt );
253 #endif
254 
255 #if defined(MBEDTLS_ECDH_C)
256 typedef enum
257 {
262 
280  const char *file, int line,
281  const mbedtls_ecdh_context *ecdh,
283 #endif
284 
285 #ifdef __cplusplus
286 }
287 #endif
288 
289 #endif /* debug.h */
290 
GLint level
Definition: gl.h:1546
const WCHAR * text
Definition: package.c:1827
This file provides an API for Elliptic Curves over GF(P) (ECP).
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 u...
GLint GLint GLsizei GLsizei GLsizei GLint GLenum format
Definition: gl.h:1546
GLenum GLuint GLenum GLsizei const GLchar * buf
Definition: glext.h:7751
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 MBEDT...
Definition: parser.c:48
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()...
Definition: cookie.c:201
mbedtls_debug_ecdh_attr
Definition: debug.h:256
void mbedtls_debug_set_threshold(int threshold)
Set the threshold error level to handle globally all debug output. Debug messages that have a level o...
int ret
The ECDH context structure.
Definition: ecdh.h:135
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 MB...
GLenum GLsizei len
Definition: glext.h:6722
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 MBE...
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 structure.
Definition: bignum.h:210
SSL/TLS functions.
The ECP point structure, in Jacobian coordinates.
Definition: ecp.h:149
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_EC...
Definition: fci.c:126