3 * Copyright (c) 2003 Endace Technology Ltd, Hamilton, New Zealand.
6 * This software and documentation has been developed by Endace Technology Ltd.
7 * along with the DAG PCI network capture cards. For further information please
8 * visit http://www.endace.com/.
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions are met:
13 * 1. Redistributions of source code must retain the above copyright notice,
14 * this list of conditions and the following disclaimer.
16 * 2. Redistributions in binary form must reproduce the above copyright
17 * notice, this list of conditions and the following disclaimer in the
18 * documentation and/or other materials provided with the distribution.
20 * 3. The name of Endace Technology Ltd may not be used to endorse or promote
21 * products derived from this software without specific prior written
24 * THIS SOFTWARE IS PROVIDED BY ENDACE TECHNOLOGY LTD ``AS IS'' AND ANY EXPRESS
25 * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
26 * OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO
27 * EVENT SHALL ENDACE TECHNOLOGY LTD BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
28 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
29 * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR
30 * BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER
31 * IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
32 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
33 * POSSIBILITY OF SUCH DAMAGE.
39 * erf - Endace ERF (Extensible Record Format)
43 * http://www.endace.com/support/EndaceRecordFormat.pdf
54 #include "file_wrappers.h"
60 #define min(a, b) ((a) > (b) ? (b) : (a))
63 static int erf_read_header(FILE_T fh,
64 struct wtap_pkthdr *phdr,
65 union wtap_pseudo_header *pseudo_header,
66 erf_header_t *erf_header,
70 guint32 *packet_size);
71 static gboolean erf_read(wtap *wth, int *err, gchar **err_info,
73 static gboolean erf_seek_read(wtap *wth, gint64 seek_off,
74 union wtap_pseudo_header *pseudo_header, guchar *pd,
75 int length, int *err, gchar **err_info);
77 extern int erf_open(wtap *wth, int *err, gchar **err_info _U_)
79 int i, n, records_for_erf_check = RECORDS_FOR_ERF_CHECK;
81 erf_timestamp_t prevts,ts;
87 guint64 erf_ext_header;
92 memset(&prevts, 0, sizeof(prevts));
94 /* number of records to scan before deciding if this really is ERF */
95 if ((s = getenv("ERF_RECORDS_TO_CHECK")) != NULL) {
96 if ((n = atoi(s)) > 0 && n < 101) {
97 records_for_erf_check = n;
102 * ERF is a little hard because there's no magic number; we look at
103 * the first few records and see if they look enough like ERF
107 for (i = 0; i < records_for_erf_check; i++) { /* records_for_erf_check */
109 r = file_read(&header,1,sizeof(header),wth->fh);
112 if (r != sizeof(header)) {
113 if ((*err = file_error(wth->fh)) != 0) {
116 /* ERF header too short accept the file,
117 only if the very first records have been successfully checked */
118 if (i < MIN_RECORDS_FOR_ERF_CHECK) {
121 /* BREAK, the last record is too short, and will be ignored */
127 rlen=g_ntohs(header.rlen);
128 wlen=g_ntohs(header.wlen);
130 /* fail on invalid record type, invalid rlen, timestamps decreasing, or incrementing too far */
132 /* Test valid rlen >= 16 */
137 packet_size = rlen - (guint32)sizeof(header);
138 if (packet_size > WTAP_MAX_PACKET_SIZE) {
140 * Probably a corrupt capture file or a file that's not an ERF file
141 * but that passed earlier tests; don't blow up trying
142 * to allocate space for an immensely-large packet.
147 /* Skip PAD records, timestamps may not be set */
148 if ((header.type & 0x7F) == ERF_TYPE_PAD) {
149 if (file_seek(wth->fh, packet_size, SEEK_CUR, err) == -1) {
155 /* fail on invalid record type, decreasing timestamps or non-zero pad-bits */
156 /* Not all types within this range are decoded, but it is a first filter */
157 if ((header.type & 0x7F) == 0 || (header.type & 0x7F) > ERF_TYPE_MAX ) {
161 /* The ERF_TYPE_MAX is the PAD record, but the last used type is ERF_TYPE_RAW_LINK */
162 if ((header.type & 0x7F) > ERF_TYPE_RAW_LINK) {
166 if ((ts = pletohll(&header.ts)) < prevts) {
167 /* reassembled AALx records may not be in time order, also records are not in strict time order between physical interfaces, so allow 1 sec fudge */
168 if ( ((prevts-ts)>>32) > 1 ) {
173 /* Check to see if timestamp increment is > 1 week */
174 if ( (i) && (ts > prevts) && (((ts-prevts)>>32) > 3600*24*7) ) {
178 memcpy(&prevts, &ts, sizeof(prevts));
180 /* Read over the extension headers */
183 if (file_read(&erf_ext_header, 1, sizeof(erf_ext_header),wth->fh) != sizeof(erf_ext_header)) {
184 *err = file_error(wth->fh);
187 packet_size -= (guint32)sizeof(erf_ext_header);
188 memcpy(&type, &erf_ext_header, sizeof(type));
192 /* Read over MC or ETH subheader */
193 switch(header.type & 0x7F) {
194 case ERF_TYPE_MC_HDLC:
195 case ERF_TYPE_MC_RAW:
196 case ERF_TYPE_MC_ATM:
197 case ERF_TYPE_MC_RAW_CHANNEL:
198 case ERF_TYPE_MC_AAL5:
199 case ERF_TYPE_MC_AAL2:
200 case ERF_TYPE_COLOR_MC_HDLC_POS:
201 if (file_read(&mc_hdr,1,sizeof(mc_hdr),wth->fh) != sizeof(mc_hdr)) {
202 *err = file_error(wth->fh);
205 packet_size -= (guint32)sizeof(mc_hdr);
208 case ERF_TYPE_COLOR_ETH:
209 case ERF_TYPE_DSM_COLOR_ETH:
210 if (file_read(ð_hdr,1,sizeof(eth_hdr),wth->fh) != sizeof(eth_hdr)) {
211 *err = file_error(wth->fh);
214 packet_size -= (guint32)sizeof(eth_hdr);
220 /* The file_seek function do not return an error if the end of file
221 is reached whereas the record is truncated */
222 if (packet_size > WTAP_MAX_PACKET_SIZE) {
224 * Probably a corrupt capture file; don't blow up trying
225 * to allocate space for an immensely-large packet.
229 buffer=g_malloc(packet_size);
230 r = file_read(buffer, 1, packet_size, wth->fh);
233 if (r != packet_size) {
234 /* ERF record too short, accept the file,
235 only if the very first records have been successfully checked */
236 if (i < MIN_RECORDS_FOR_ERF_CHECK) {
241 } /* records_for_erf_check */
243 if (file_seek(wth->fh, 0L, SEEK_SET, err) == -1) { /* rewind */
247 wth->data_offset = 0;
249 /* This is an ERF file */
250 wth->file_type = WTAP_FILE_ERF;
251 wth->snapshot_length = 0; /* not available in header, only in frame */
254 * Use the encapsulation for ERF records.
256 wth->file_encap = WTAP_ENCAP_ERF;
258 wth->subtype_read = erf_read;
259 wth->subtype_seek_read = erf_seek_read;
260 wth->tsprecision = WTAP_FILE_TSPREC_NSEC;
265 /* Read the next packet */
266 static gboolean erf_read(wtap *wth, int *err, gchar **err_info,
269 erf_header_t erf_header;
270 guint32 packet_size, bytes_read;
272 *data_offset = wth->data_offset;
275 if (!erf_read_header(wth->fh,
276 &wth->phdr, &wth->pseudo_header, &erf_header,
277 err, err_info, &bytes_read, &packet_size)) {
280 wth->data_offset += bytes_read;
281 } while ( erf_header.type == ERF_TYPE_PAD );
283 buffer_assure_space(wth->frame_buffer, packet_size);
285 wtap_file_read_expected_bytes(buffer_start_ptr(wth->frame_buffer),
286 (gint32)(packet_size), wth->fh, err );
287 wth->data_offset += packet_size;
292 static gboolean erf_seek_read(wtap *wth, gint64 seek_off,
293 union wtap_pseudo_header *pseudo_header, guchar *pd,
294 int length _U_, int *err, gchar **err_info)
296 erf_header_t erf_header;
299 if (file_seek(wth->random_fh, seek_off, SEEK_SET, err) == -1)
303 if (!erf_read_header(wth->random_fh, NULL, pseudo_header, &erf_header,
304 err, err_info, NULL, &packet_size))
306 } while ( erf_header.type == ERF_TYPE_PAD );
308 wtap_file_read_expected_bytes(pd, (int)packet_size, wth->random_fh, err);
313 static int erf_read_header(FILE_T fh,
314 struct wtap_pkthdr *phdr,
315 union wtap_pseudo_header *pseudo_header,
316 erf_header_t *erf_header,
320 guint32 *packet_size)
324 guint64 erf_exhdr_sw;
328 int i = 0 , max = sizeof(pseudo_header->erf.ehdr_list)/sizeof(struct erf_ehdr);
330 wtap_file_read_expected_bytes(erf_header, sizeof(*erf_header), fh, err);
331 if (bytes_read != NULL) {
332 *bytes_read = sizeof(*erf_header);
335 *packet_size = g_ntohs(erf_header->rlen) - (guint32)sizeof(*erf_header);
337 if (*packet_size > WTAP_MAX_PACKET_SIZE) {
339 * Probably a corrupt capture file; don't blow up trying
340 * to allocate space for an immensely-large packet.
342 *err = WTAP_ERR_BAD_RECORD;
343 *err_info = g_strdup_printf("erf: File has %u-byte packet, bigger than maximum of %u",
344 *packet_size, WTAP_MAX_PACKET_SIZE);
349 guint64 ts = pletohll(&erf_header->ts);
351 phdr->ts.secs = (long) (ts >> 32);
352 ts = ((ts & 0xffffffff) * 1000 * 1000 * 1000);
353 ts += (ts & 0x80000000) << 1; /* rounding */
354 phdr->ts.nsecs = ((int) (ts >> 32));
355 if (phdr->ts.nsecs >= 1000000000) {
356 phdr->ts.nsecs -= 1000000000;
361 /* Copy the ERF pseudo header */
362 pseudo_header->erf.phdr.ts = pletohll(&erf_header->ts);
363 pseudo_header->erf.phdr.type = erf_header->type;
364 pseudo_header->erf.phdr.flags = erf_header->flags;
365 pseudo_header->erf.phdr.rlen = g_ntohs(erf_header->rlen);
366 pseudo_header->erf.phdr.lctr = g_ntohs(erf_header->lctr);
367 pseudo_header->erf.phdr.wlen = g_ntohs(erf_header->wlen);
369 /* Copy the ERF extension header into the pseudo header */
370 type = erf_header->type;
372 wtap_file_read_expected_bytes(&erf_exhdr, sizeof(erf_exhdr), fh, err);
373 if (bytes_read != NULL)
374 *bytes_read += (guint32)sizeof(erf_exhdr);
375 *packet_size -= (guint32)sizeof(erf_exhdr);
376 skiplen += (guint32)sizeof(erf_exhdr);
377 erf_exhdr_sw = pntohll((guint64*) &(erf_exhdr[0]));
379 memcpy(&pseudo_header->erf.ehdr_list[i].ehdr, &erf_exhdr_sw, sizeof(erf_exhdr_sw));
384 switch (erf_header->type & 0x7F) {
387 case ERF_TYPE_RAW_LINK:
388 case ERF_TYPE_INFINIBAND:
391 phdr->len = g_htons(erf_header->wlen);
392 phdr->caplen = g_htons(erf_header->wlen);
398 case ERF_TYPE_HDLC_POS:
399 case ERF_TYPE_COLOR_HDLC_POS:
400 case ERF_TYPE_DSM_COLOR_HDLC_POS:
407 case ERF_TYPE_COLOR_ETH:
408 case ERF_TYPE_DSM_COLOR_ETH:
409 wtap_file_read_expected_bytes(ð_hdr, sizeof(eth_hdr), fh, err);
410 if (bytes_read != NULL)
411 *bytes_read += (guint32)sizeof(eth_hdr);
412 *packet_size -= (guint32)sizeof(eth_hdr);
413 skiplen += (guint32)sizeof(eth_hdr);
414 pseudo_header->erf.subhdr.eth_hdr = g_htons(eth_hdr);
417 case ERF_TYPE_MC_HDLC:
418 case ERF_TYPE_MC_RAW:
419 case ERF_TYPE_MC_ATM:
420 case ERF_TYPE_MC_RAW_CHANNEL:
421 case ERF_TYPE_MC_AAL5:
422 case ERF_TYPE_MC_AAL2:
423 case ERF_TYPE_COLOR_MC_HDLC_POS:
424 wtap_file_read_expected_bytes(&mc_hdr, sizeof(mc_hdr), fh, err);
425 if (bytes_read != NULL)
426 *bytes_read += (guint32)sizeof(mc_hdr);
427 *packet_size -= (guint32)sizeof(mc_hdr);
428 skiplen += (guint32)sizeof(mc_hdr);
429 pseudo_header->erf.subhdr.mc_hdr = g_htonl(mc_hdr);
432 case ERF_TYPE_IP_COUNTER:
433 case ERF_TYPE_TCP_FLOW_COUNTER:
434 /* unsupported, continue with default: */
436 *err = WTAP_ERR_UNSUPPORTED_ENCAP;
437 *err_info = g_strdup_printf("erf: unknown record encapsulation %u",
443 phdr->len = g_htons(erf_header->wlen);
444 phdr->caplen = min( g_htons(erf_header->wlen),
445 g_htons(erf_header->rlen) - (guint32)sizeof(*erf_header) - skiplen );