2 * Copyright (c) 2015 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
15 #ifndef __included_vnet_flow_report_h__
16 #define __included_vnet_flow_report_h__
18 #include <vlib/vlib.h>
19 #include <vnet/vnet.h>
20 #include <vnet/ethernet/ethernet.h>
21 #include <vnet/ethernet/packet.h>
22 #include <vnet/ip/ip_packet.h>
23 #include <vnet/ip/ip_types.h>
24 #include <vnet/ip/ip4_packet.h>
25 #include <vnet/ip/ip6_packet.h>
26 #include <vnet/udp/udp_packet.h>
28 #include <vppinfra/error.h>
29 #include <vppinfra/hash.h>
30 #include <vppinfra/cache.h>
32 #include <vnet/ipfix-export/ipfix_packet.h>
34 /* ipfix field definitions for a particular report */
39 } ipfix_report_element_t;
41 /* Used to build the rewrite */
46 ipfix_template_packet_t ipfix;
47 } ip4_ipfix_template_packet_t;
49 struct flow_report_main;
51 struct ipfix_exporter;
53 typedef vlib_frame_t *(vnet_flow_data_callback_t) (
54 struct flow_report_main *frm, struct ipfix_exporter *exp,
55 struct flow_report *, vlib_frame_t *, u32 *, u32);
57 typedef u8 *(vnet_flow_rewrite_callback_t) (struct ipfix_exporter *exp,
59 u16, ipfix_report_element_t *elts,
60 u32 n_elts, u32 *stream_index);
62 u8 *vnet_flow_rewrite_generic_callback (struct ipfix_exporter *exp,
63 struct flow_report *, u16,
64 ipfix_report_element_t *elts,
65 u32 n_elts, u32 *stream_index);
74 * A stream represents an IPFIX session to a destination. We can have
75 * multiple streams to the same destination, but each one has its own
76 * domain and source port. A stream has a sequence number for that
77 * session. A stream may contain multiple templates (i.e multiple for
78 * reports) and each stream also has its own template space.
80 * A stream has per thread state so that data packets can be built
81 * and send on multiple threads at the same time.
90 } flow_report_stream_t;
93 * For each flow_report we want to be able to build buffers/frames per thread.
97 vlib_buffer_t *buffer;
101 * We need this per stream as the IPFIX sequence number is the count of
102 * data record sent, not the count of packets with data records sent.
103 * See RFC 7011, Sec 3.1
106 } flow_report_per_thread_t;
109 * A flow report represents a group of fields that are to be exported.
110 * Each flow_report has an associated template that is generated when
111 * the flow_report is added. Each flow_report is associated with a
112 * stream, and multiple flow_reports can use the same stream. When
113 * adding a flow_report the keys for the stream are the domain_id
114 * and the source_port.
116 typedef struct flow_report
118 /* ipfix rewrite, set by callback */
121 int data_record_size;
122 flow_report_per_thread_t *per_thread_data;
124 f64 last_template_sent;
127 /* Bitmap of fields to send */
128 uword *fields_to_send;
133 /* build-the-template-packet rewrite callback */
134 vnet_flow_rewrite_callback_t *rewrite_callback;
135 ipfix_report_element_t *report_elements;
136 u32 n_report_elements;
139 /* Send-flow-data callback */
140 vnet_flow_data_callback_t *flow_data_callback;
144 * The maximum number of ipfix exporters we can have at once
146 #define IPFIX_EXPORTERS_MAX 5
149 * We support multiple exporters. Each one has its own configured
150 * destination, and its own set of reports and streams.
152 typedef struct ipfix_exporter
154 flow_report_t *reports;
155 flow_report_stream_t *streams;
157 /* ipfix collector ip address, port, our ip address, fib index */
158 ip4_address_t ipfix_collector;
160 ip4_address_t src_address;
166 /* time interval in seconds after which to resend templates */
167 u32 template_interval;
169 /* UDP checksum calculation enable flag */
173 * The amount of data needed for all the headers, prior to the first
174 * flowset (template or data or ...) This is mostly dependent on the
175 * L3 and L4 protocols in use.
177 u32 all_headers_size;
180 typedef struct flow_report_main
183 * A pool of the exporters. Entry 0 is always there for backwards
184 * compatability reasons. Entries 1 and above have to be created by
187 ipfix_exporter_t *exporters;
189 /* time scale transform. Joy. */
193 /* convenience variables */
194 vlib_main_t *vlib_main;
195 vnet_main_t *vnet_main;
198 } flow_report_main_t;
200 extern flow_report_main_t flow_report_main;
202 extern vlib_node_registration_t flow_report_process_node;
206 vnet_flow_data_callback_t *flow_data_callback;
207 vnet_flow_rewrite_callback_t *rewrite_callback;
208 ipfix_report_element_t *report_elements;
209 u32 n_report_elements;
216 * When adding a flow report, the index of the flow report is stored
219 u32 flow_report_index;
220 } vnet_flow_report_add_del_args_t;
222 int vnet_flow_report_add_del (ipfix_exporter_t *exp,
223 vnet_flow_report_add_del_args_t *a,
226 clib_error_t *flow_report_add_del_error_to_clib_error (int error);
228 void vnet_flow_reports_reset (ipfix_exporter_t *exp);
230 void vnet_stream_reset (ipfix_exporter_t *exp, u32 stream_index);
232 int vnet_stream_change (ipfix_exporter_t *exp, u32 old_domain_id,
233 u16 old_src_port, u32 new_domain_id, u16 new_src_port);
236 * Search all the exporters for one that has a matching destination address.
238 ipfix_exporter_t *vnet_ipfix_exporter_lookup (ip4_address_t *ipfix_collector);
241 * Get the currently in use buffer for the given stream on the given core.
242 * If there is no current buffer then allocate a new one and return that.
243 * This is the buffer that data records should be written into. The offset
244 * currently in use is stored in the per-thread data for the stream and
245 * should be updated as new records are written in.
247 vlib_buffer_t *vnet_ipfix_exp_get_buffer (vlib_main_t *vm,
248 ipfix_exporter_t *exp,
249 flow_report_t *fr, u32 thread_index);
252 * Send the provided buffer. At this stage the buffer should be populated
253 * with data records, with the offset in use stored in the stream per thread
254 * data. This func will fix up all the headers and then send the buffer.
256 void vnet_ipfix_exp_send_buffer (vlib_main_t *vm, ipfix_exporter_t *exp,
258 flow_report_stream_t *stream,
259 u32 thread_index, vlib_buffer_t *b0);
261 #endif /* __included_vnet_flow_report_h__ */
264 * fd.io coding-style-patch-verification: ON
267 * eval: (c-set-style "gnu")