2 * Copyright (c) 2018 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.
18 * @brief MPCAP utility definitions
20 #ifndef included_vppinfra_mpcap_h
21 #define included_vppinfra_mpcap_h
23 #include <sys/types.h>
26 #include <vppinfra/time_range.h>
27 #include <vppinfra/lock.h>
30 * @brief Packet types supported by MPCAP
38 #define foreach_vnet_mpcap_packet_type \
47 #define _(f,n) MPCAP_PACKET_TYPE_##f = (n),
48 foreach_vnet_mpcap_packet_type
50 } mpcap_packet_type_t;
52 #define foreach_mpcap_file_header \
53 /** 0xa1b2c3d4 host byte order. \
54 0xd4c3b2a1 => need to byte swap everything. */ \
57 /** Currently major 2 minor 4. */ \
58 _ (u16, major_version) \
59 _ (u16, minor_version) \
64 /** Accuracy of timestamps. Typically set to 0. */ \
67 /** Size of largest packet in file. */ \
68 _ (u32, max_packet_size_in_bytes) \
70 /** One of vnet_mpcap_packet_type_t. */ \
73 /** File header struct */
77 foreach_mpcap_file_header
79 } mpcap_file_header_t;
81 #define foreach_mpcap_packet_header \
82 /** Time stamp in seconds */ \
83 _ (u32, time_in_sec) \
84 /** Time stamp in microseconds. */ \
85 _ (u32, time_in_usec) \
87 /** Number of bytes stored in file. */ \
88 _ (u32, n_packet_bytes_stored_in_file) \
89 /** Number of bytes in actual packet. */ \
90 _ (u32, n_bytes_in_packet)
96 foreach_mpcap_packet_header
98 /** Packet data follows. */
100 } mpcap_packet_header_t;
103 * @brief MPCAP main state data structure
107 /** File name of mpcap output. */
110 /** spinlock, initialized if flagged MPCAP_FLAG_THREAD_SAFE */
111 clib_spinlock_t lock;
113 /** Number of packets to capture. */
114 u32 n_packets_to_capture;
117 mpcap_packet_type_t packet_type;
119 /** Maximum file size */
125 /** current memory address */
128 /** Number of packets currently captured. */
129 u32 n_packets_captured;
131 /** Pointer to file header in svm, for ease of updating */
132 mpcap_file_header_t *file_header;
136 #define MPCAP_FLAG_INIT_DONE (1 << 0)
137 #define MPCAP_FLAG_THREAD_SAFE (1 << 1)
138 #define MPCAP_FLAG_WRITE_ENABLE (1 << 2)
141 u32 n_mpcap_data_written;
143 /** Vector of mpcap data. */
146 /** Packets in mapped mpcap file. */
149 /** Min/Max Packet bytes */
150 u32 min_packet_bytes, max_packet_bytes;
153 /* Some sensible default size */
154 #define MPCAP_DEFAULT_FILE_SIZE (10<<20)
156 /** initialize a mpcap file (for writing) */
157 clib_error_t *mpcap_init (mpcap_main_t * pm);
159 /** Flush / unmap a mpcap file */
160 clib_error_t *mpcap_close (mpcap_main_t * pm);
162 /** mmap a mpcap data file. */
163 clib_error_t *mpcap_map (mpcap_main_t * pm);
165 #endif /* included_vppinfra_mpcap_h */
168 * fd.io coding-style-patch-verification: ON
171 * eval: (c-set-style "gnu")