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
132
133
134
135
136
137
|
/* Copyright (C) 2022 CZ.NIC, z.s.p.o. <knot-dns@labs.nic.cz>
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>.
*/
#pragma once
#include <time.h>
#include "utils/common/netio.h"
#include "utils/common/params.h"
#include "libknot/libknot.h"
#include "contrib/json.h"
/*!
* \brief Allocates empty packet and sets packet size and random id.
*
* \param max_size Maximal packet size.
*
* \retval packet if success.
* \retval NULL if error.
*/
knot_pkt_t *create_empty_packet(const uint16_t max_size);
/*!
* \brief Prints information header for transfer.
*
* \param packet Parsed packet.
* \param style Style of the output.
*/
void print_header_xfr(const knot_pkt_t *packet, const style_t *style);
/*!
* \brief Prints answer section for 1 transfer message.
*
* \param packet Response packet.
* \param style Style of the output.
*/
void print_data_xfr(const knot_pkt_t *packet, const style_t *style);
/*!
* \brief Prints trailing statistics for transfer.
*
* \param total_len Total reply size (all messages).
* \param msg_count Number of messages.
* \param rr_count Total number of answer records.
* \param net Connection information.
* \param elapsed Total elapsed time.
* \param exec_time Time of the packet creation.
* \param style Style of the output.
*/
void print_footer_xfr(const size_t total_len,
const size_t msg_count,
const size_t rr_count,
const net_t *net,
const float elapsed,
const time_t exec_time,
const style_t *style);
/*!
* \brief Prints initial JSON part of XFR output.
*
* \param query Query packet.
* \param exec_time Time of the packet creation.
* \param style Style of the output.
*
* \retval JSON witter if success.
* \retval NULL if error.
*/
jsonw_t *print_header_xfr_json(const knot_pkt_t *query,
const time_t exec_time,
const style_t *style);
/*!
* \brief Prints one XFR reply packet in JSON.
*
* \param w JSON writter.
* \param reply Reply packet (possibly one of many).
* \param exec_time Time of the packet creation.
*/
void print_data_xfr_json(jsonw_t *w,
const knot_pkt_t *reply,
const time_t exec_time);
/*!
* \brief Prints trailing JSON part of XFR output.
*
* \param w JSON writter.
* \param style Style of the output.
*/
void print_footer_xfr_json(jsonw_t **w,
const style_t *style);
/*!
* \brief Prints one or query/reply pair of DNS packets in JSON format.
*
* \param query Query DNS packet.
* \param reply Reply DNS packet.
* \param net Connection information.
* \param exec_time Time of the packet creation.
* \param style Style of the output.
*/
void print_packets_json(const knot_pkt_t *query,
const knot_pkt_t *reply,
const net_t *net,
const time_t exec_time,
const style_t *style);
/*!
* \brief Prints one DNS packet.
*
* \param packet DNS packet.
* \param net Connection information.
* \param size Original packet wire size.
* \param elapsed Total elapsed time.
* \param exec_time Time of the packet creation.
* \param incoming Indicates if the packet is input.
* \param style Style of the output.
*/
void print_packet(const knot_pkt_t *packet,
const net_t *net,
const size_t size,
const float elapsed,
const time_t exec_time,
const bool incoming,
const style_t *style);
|