1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
|
/*
* Copyright 2023-2024 The OpenSSL Project Authors. All Rights Reserved.
*
* Licensed under the Apache License 2.0 (the "License"). You may not use
* this file except in compliance with the License. You can obtain a copy
* in the file LICENSE in the source distribution or at
* https://www.openssl.org/source/license.html
*/
#ifndef OSSL_QLOG_H
# define OSSL_QLOG_H
# include <openssl/ssl.h>
# include "internal/quic_types.h"
# include "internal/time.h"
typedef struct qlog_st QLOG;
# ifndef OPENSSL_NO_QLOG
enum {
QLOG_EVENT_TYPE_NONE,
# define QLOG_EVENT(cat, name) QLOG_EVENT_TYPE_##cat##_##name,
# include "internal/qlog_events.h"
# undef QLOG_EVENT
QLOG_EVENT_TYPE_NUM
};
typedef struct qlog_trace_info_st {
QUIC_CONN_ID odcid;
const char *title, *description, *group_id;
int is_server;
OSSL_TIME (*now_cb)(void *arg);
void *now_cb_arg;
uint64_t override_process_id;
const char *override_impl_name;
} QLOG_TRACE_INFO;
QLOG *ossl_qlog_new(const QLOG_TRACE_INFO *info);
QLOG *ossl_qlog_new_from_env(const QLOG_TRACE_INFO *info);
void ossl_qlog_free(QLOG *qlog);
/* Configuration */
int ossl_qlog_set_event_type_enabled(QLOG *qlog, uint32_t event_type,
int enable);
int ossl_qlog_set_filter(QLOG *qlog, const char *filter);
int ossl_qlog_set_sink_bio(QLOG *qlog, BIO *bio);
# ifndef OPENSSL_NO_STDIO
int ossl_qlog_set_sink_file(QLOG *qlog, FILE *file, int close_flag);
# endif
int ossl_qlog_set_sink_filename(QLOG *qlog, const char *filename);
/* Operations */
int ossl_qlog_flush(QLOG *qlog);
/* Queries */
int ossl_qlog_enabled(QLOG *qlog, uint32_t event_type);
/* Grouping Functions */
int ossl_qlog_event_try_begin(QLOG *qlog, uint32_t event_type,
const char *event_cat, const char *event_name,
const char *event_combined_name);
void ossl_qlog_event_end(QLOG *qlog);
void ossl_qlog_group_begin(QLOG *qlog, const char *name);
void ossl_qlog_group_end(QLOG *qlog);
void ossl_qlog_array_begin(QLOG *qlog, const char *name);
void ossl_qlog_array_end(QLOG *qlog);
void ossl_qlog_override_time(QLOG *qlog, OSSL_TIME event_time);
/* Grouping Macros */
# define QLOG_EVENT_BEGIN(qlog, cat, name) \
{ \
QLOG *qlog_instance = (qlog); \
uint32_t qlog_event_type = QLOG_EVENT_TYPE_##cat##_##name; \
\
if (ossl_qlog_event_try_begin(qlog_instance, qlog_event_type, \
#cat, #name, #cat ":" #name)) {
# define QLOG_EVENT_END() \
ossl_qlog_event_end(qlog_instance); \
} \
}
# define QLOG_BEGIN(name) \
{ \
ossl_qlog_group_begin(qlog_instance, (name));
# define QLOG_END() \
ossl_qlog_group_end(qlog_instance); \
}
# define QLOG_BEGIN_ARRAY(name) \
{ \
ossl_qlog_array_begin(qlog_instance, (name));
# define QLOG_END_ARRAY() \
ossl_qlog_array_end(qlog_instance); \
}
/* Field Functions */
void ossl_qlog_str(QLOG *qlog, const char *name, const char *value);
void ossl_qlog_str_len(QLOG *qlog, const char *name,
const char *value, size_t value_len);
void ossl_qlog_u64(QLOG *qlog, const char *name, uint64_t value);
void ossl_qlog_i64(QLOG *qlog, const char *name, int64_t value);
void ossl_qlog_bool(QLOG *qlog, const char *name, int value);
void ossl_qlog_bin(QLOG *qlog, const char *name,
const void *value, size_t value_len);
/* Field Macros */
# define QLOG_STR(name, value) ossl_qlog_str(qlog_instance, (name), (value))
# define QLOG_STR_LEN(name, value, value_len) \
ossl_qlog_str_len(qlog_instance, (name), (value), (value_len))
# define QLOG_I64(name, value) ossl_qlog_i64(qlog_instance, (name), (value))
# define QLOG_U64(name, value) ossl_qlog_u64(qlog_instance, (name), (value))
# define QLOG_F64(name, value) ossl_qlog_f64(qlog_instance, (name), (value))
# define QLOG_BOOL(name, value) ossl_qlog_bool(qlog_instance, (name), (value))
# define QLOG_BIN(name, value, value_len) \
ossl_qlog_bin(qlog_instance, (name), (value), (value_len))
# define QLOG_CID(name, value) QLOG_BIN((name), (value)->id, (value)->id_len)
# endif
#endif
|
