1 /**
2  * \file ssl_debug_helpers.h
3  *
4  * \brief Automatically generated helper functions for debugging
5  */
6 /*
7  *  Copyright The Mbed TLS Contributors
8  *  SPDX-License-Identifier: Apache-2.0
9  *
10  *  Licensed under the Apache License, Version 2.0 (the "License"); you may
11  *  not use this file except in compliance with the License.
12  *  You may obtain a copy of the License at
13  *
14  *  http://www.apache.org/licenses/LICENSE-2.0
15  *
16  *  Unless required by applicable law or agreed to in writing, software
17  *  distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
18  *  WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
19  *  See the License for the specific language governing permissions and
20  *  limitations under the License.
21  */
22 
23 #ifndef MBEDTLS_SSL_DEBUG_HELPERS_H
24 #define MBEDTLS_SSL_DEBUG_HELPERS_H
25 
26 #include "common.h"
27 
28 #if defined(MBEDTLS_DEBUG_C)
29 
30 #include "mbedtls/ssl.h"
31 #include "ssl_misc.h"
32 
33 
34 const char *mbedtls_ssl_states_str(mbedtls_ssl_states in);
35 
36 const char *mbedtls_ssl_protocol_version_str(mbedtls_ssl_protocol_version in);
37 
38 const char *mbedtls_tls_prf_types_str(mbedtls_tls_prf_types in);
39 
40 const char *mbedtls_ssl_key_export_type_str(mbedtls_ssl_key_export_type in);
41 
42 const char *mbedtls_ssl_sig_alg_to_str(uint16_t in);
43 
44 const char *mbedtls_ssl_named_group_to_str(uint16_t in);
45 
46 const char *mbedtls_ssl_get_extension_name(unsigned int extension_type);
47 
48 void mbedtls_ssl_print_extensions(const mbedtls_ssl_context *ssl,
49                                   int level, const char *file, int line,
50                                   int hs_msg_type, uint32_t extensions_mask,
51                                   const char *extra);
52 
53 void mbedtls_ssl_print_extension(const mbedtls_ssl_context *ssl,
54                                  int level, const char *file, int line,
55                                  int hs_msg_type, unsigned int extension_type,
56                                  const char *extra_msg0, const char *extra_msg1);
57 
58 #if defined(MBEDTLS_SSL_PROTO_TLS1_3) && defined(MBEDTLS_SSL_SESSION_TICKETS)
59 void mbedtls_ssl_print_ticket_flags(const mbedtls_ssl_context *ssl,
60                                     int level, const char *file, int line,
61                                     unsigned int flags);
62 #endif /* MBEDTLS_SSL_PROTO_TLS1_3 && MBEDTLS_SSL_SESSION_TICKETS */
63 
64 #define MBEDTLS_SSL_PRINT_EXTS(level, hs_msg_type, extensions_mask)            \
65     mbedtls_ssl_print_extensions(ssl, level, __FILE__, __LINE__,       \
66                                  hs_msg_type, extensions_mask, NULL)
67 
68 #define MBEDTLS_SSL_PRINT_EXT(level, hs_msg_type, extension_type, extra)      \
69     mbedtls_ssl_print_extension(ssl, level, __FILE__, __LINE__,        \
70                                 hs_msg_type, extension_type,           \
71                                 extra, NULL)
72 
73 #if defined(MBEDTLS_SSL_PROTO_TLS1_3) && defined(MBEDTLS_SSL_SESSION_TICKETS)
74 #define MBEDTLS_SSL_PRINT_TICKET_FLAGS(level, flags)             \
75     mbedtls_ssl_print_ticket_flags(ssl, level, __FILE__, __LINE__, flags)
76 #endif
77 
78 #else
79 
80 #define MBEDTLS_SSL_PRINT_EXTS(level, hs_msg_type, extension_mask)
81 
82 #define MBEDTLS_SSL_PRINT_EXT(level, hs_msg_type, extension_type, extra)
83 
84 #if defined(MBEDTLS_SSL_PROTO_TLS1_3) && defined(MBEDTLS_SSL_SESSION_TICKETS)
85 #define MBEDTLS_SSL_PRINT_TICKET_FLAGS(level, flags)
86 #endif
87 
88 #endif /* MBEDTLS_DEBUG_C */
89 
90 #endif /* MBEDTLS_SSL_DEBUG_HELPERS_H */
91