![Guy Harris](/assets/img/avatar_default.png)
The code for reading ERF files has not been significantly updated since 2004. This patch brings it up to date with a number of changes. 1) Increase number of decodable ERF types from 7 to 12. This covers newer DAG card models and firmware updates. 2) Fix timestamp conversion. Was calculating only microsecond precision, now displaying with nanosecond resolution. Hardware precision is 7.5 to 30 ns depending on model. 3) Allow the user to specify HDLC encapsulation as 'chdlc', 'ppp_serial', 'frelay' or 'mtp2'. This is needed because the ERF HDLC capture formats do not include information on what protocol is used at the next level. This is currently done via an environment variable 'ERF_HDLC_ENCAP' and is analagous to the existing 'ERF_ATM_ENCAP' variable. If the user does not specify an HDLC encapsulation it tries to guess, and falls back to MTP2 for backwards compatibility with Florent's existing behaviour. I know environment variables are ugly, suggestions are welcome. 4) When reading HDLC captures as MTP2, use WTAP_ENCAP_MTP2_WITH_PHDR rather than WTAP_ENCAP_MTP2. This allows us to put the 'Multi-Channel ERF' record 'channel number' field into the MTP2 pseudo header > 'link_number' field. This is then displayed in Frame information, and can be filtered on. (Would be nice if it could be made a display column?) Because the ERF record does not specify whether Annex A is used or not, we pass MTP2_ANNEX_A_USED_UNKNOWN and allow the existing user preference to decide. Move the MTP2_ANNEX_A_ definitions into Wiretap, make the annex_a_used field a guint8, and change MTP2_ANNEX_A_USED_UNKNOWN to 2 so it fits in a guint8. (This means that if you can save an ERF MTP2 file as a libpcap file, the pseudo-header will have MTP2_ANNEX_A_USED_UNKNOWN in it.) svn path=/trunk/; revision=22067
445 lines
11 KiB
C
445 lines
11 KiB
C
/* wtap-int.h
|
|
*
|
|
* $Id$
|
|
*
|
|
* Wiretap Library
|
|
* Copyright (c) 1998 by Gilbert Ramirez <gram@alumni.rice.edu>
|
|
*
|
|
* 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 2
|
|
* 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, write to the Free Software
|
|
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
*/
|
|
|
|
#ifndef __WTAP_INT_H__
|
|
#define __WTAP_INT_H__
|
|
|
|
#ifdef HAVE_SYS_TIME_H
|
|
#include <sys/time.h>
|
|
#endif
|
|
|
|
#include <glib.h>
|
|
#include <stdio.h>
|
|
#include <time.h>
|
|
|
|
#ifdef HAVE_LIBZ
|
|
#ifdef HAVE_WINSOCK2_H
|
|
#include <winsock2.h>
|
|
#endif
|
|
#include <zlib.h>
|
|
#define FILE_T gzFile
|
|
#else /* No zLib */
|
|
#define FILE_T FILE *
|
|
#endif /* HAVE_LIBZ */
|
|
|
|
#include "wtap.h"
|
|
|
|
/* Information for a compressed Sniffer data stream. */
|
|
typedef struct {
|
|
unsigned char *buf; /* buffer into which we uncompress data */
|
|
size_t nbytes; /* number of bytes of data in that buffer */
|
|
int nextout; /* offset in that buffer of stream's current position */
|
|
gint64 comp_offset; /* current offset in compressed data stream */
|
|
gint64 uncomp_offset; /* current offset in uncompressed data stream */
|
|
} ngsniffer_comp_stream_t;
|
|
|
|
typedef struct {
|
|
guint8 *sdate; /* Packet start date */
|
|
gboolean tcp_formatted; /* TCP/IP data formated Y/N */
|
|
int format; /* Trace format type */
|
|
} iseries_t;
|
|
|
|
typedef struct {
|
|
guint maj_vers;
|
|
guint min_vers;
|
|
double timeunit;
|
|
time_t start;
|
|
guint network; /* network type */
|
|
ngsniffer_comp_stream_t seq; /* sequential access */
|
|
ngsniffer_comp_stream_t rand; /* random access */
|
|
GList *first_blob; /* list element for first blob */
|
|
GList *last_blob; /* list element for last blob */
|
|
GList *current_blob; /* list element for current blob */
|
|
} ngsniffer_t;
|
|
|
|
typedef struct {
|
|
gboolean byte_swapped;
|
|
} i4btrace_t;
|
|
|
|
typedef struct {
|
|
gboolean is_hpux_11;
|
|
} nettl_t;
|
|
|
|
typedef struct {
|
|
time_t start;
|
|
} lanalyzer_t;
|
|
|
|
typedef enum {
|
|
NOT_SWAPPED,
|
|
SWAPPED,
|
|
MAYBE_SWAPPED
|
|
} swapped_type_t;
|
|
|
|
typedef struct {
|
|
gboolean byte_swapped;
|
|
swapped_type_t lengths_swapped;
|
|
guint16 version_major;
|
|
guint16 version_minor;
|
|
} libpcap_t;
|
|
|
|
typedef struct {
|
|
time_t start_secs;
|
|
guint32 start_usecs;
|
|
guint8 version_major;
|
|
guint32 *frame_table;
|
|
guint32 frame_table_size;
|
|
guint current_frame;
|
|
} netmon_t;
|
|
|
|
typedef struct {
|
|
time_t start_time;
|
|
double ticks_per_sec;
|
|
double start_timestamp;
|
|
gboolean wrapped;
|
|
guint32 nframes;
|
|
gint64 start_offset;
|
|
gint64 end_offset;
|
|
int version_major;
|
|
gboolean fcs_valid; /* if packets have valid FCS at the end */
|
|
guint isdn_type; /* 1 = E1 PRI, 2 = T1 PRI, 3 = BRI */
|
|
} netxray_t;
|
|
|
|
typedef struct {
|
|
time_t inittime;
|
|
int adjusted;
|
|
gint64 next_packet_seek_start;
|
|
} ascend_t;
|
|
|
|
typedef struct {
|
|
gboolean byteswapped;
|
|
} csids_t;
|
|
|
|
typedef struct {
|
|
struct timeval reference_time;
|
|
} etherpeek_t;
|
|
|
|
typedef struct {
|
|
gboolean has_fcs;
|
|
} airopeek9_t;
|
|
|
|
typedef struct {
|
|
guint32 atm_encap;
|
|
guint32 hdlc_encap;
|
|
gboolean is_rawatm;
|
|
} erf_t;
|
|
|
|
typedef struct _k12_t k12_t;
|
|
|
|
typedef struct {
|
|
time_t start_secs;
|
|
guint32 start_usecs;
|
|
} catapult_dct2000_t;
|
|
|
|
typedef struct {
|
|
struct wtap_nstime now;
|
|
double t0;
|
|
} mpeg_t;
|
|
|
|
typedef gboolean (*subtype_read_func)(struct wtap*, int*, char**, gint64*);
|
|
typedef gboolean (*subtype_seek_read_func)(struct wtap*, gint64, union wtap_pseudo_header*,
|
|
guint8*, int, int *, char **);
|
|
struct wtap {
|
|
FILE_T fh;
|
|
int fd; /* File descriptor for cap file */
|
|
FILE_T random_fh; /* Secondary FILE_T for random access */
|
|
int file_type;
|
|
int snapshot_length;
|
|
struct Buffer *frame_buffer;
|
|
struct wtap_pkthdr phdr;
|
|
union wtap_pseudo_header pseudo_header;
|
|
|
|
gint64 data_offset;
|
|
|
|
union {
|
|
libpcap_t *pcap;
|
|
lanalyzer_t *lanalyzer;
|
|
ngsniffer_t *ngsniffer;
|
|
iseries_t *iseries;
|
|
i4btrace_t *i4btrace;
|
|
nettl_t *nettl;
|
|
netmon_t *netmon;
|
|
netxray_t *netxray;
|
|
ascend_t *ascend;
|
|
csids_t *csids;
|
|
etherpeek_t *etherpeek;
|
|
airopeek9_t *airopeek9;
|
|
erf_t *erf;
|
|
k12_t *k12;
|
|
catapult_dct2000_t *catapult_dct2000;
|
|
mpeg_t *mpeg;
|
|
void *generic;
|
|
} capture;
|
|
|
|
subtype_read_func subtype_read;
|
|
subtype_seek_read_func subtype_seek_read;
|
|
void (*subtype_sequential_close)(struct wtap*);
|
|
void (*subtype_close)(struct wtap*);
|
|
int file_encap; /* per-file, for those
|
|
file formats that have
|
|
per-file encapsulation
|
|
types */
|
|
int tsprecision; /* timestamp precision of the lower 32bits
|
|
* e.g. WTAP_FILE_TSPREC_USEC */
|
|
};
|
|
|
|
struct wtap_dumper;
|
|
|
|
typedef gboolean (*subtype_write_func)(struct wtap_dumper*,
|
|
const struct wtap_pkthdr*, const union wtap_pseudo_header*,
|
|
const guchar*, int*);
|
|
typedef gboolean (*subtype_close_func)(struct wtap_dumper*, int*);
|
|
|
|
typedef struct {
|
|
gboolean first_frame;
|
|
time_t start;
|
|
} ngsniffer_dump_t;
|
|
|
|
typedef struct {
|
|
gboolean first_frame;
|
|
struct wtap_nstime start;
|
|
guint32 nframes;
|
|
} netxray_dump_t;
|
|
|
|
typedef struct {
|
|
gboolean got_first_record_time;
|
|
struct wtap_nstime first_record_time;
|
|
guint32 frame_table_offset;
|
|
guint32 *frame_table;
|
|
guint frame_table_index;
|
|
guint frame_table_size;
|
|
} netmon_dump_t;
|
|
|
|
typedef struct {
|
|
guint32 nframes;
|
|
} _5views_dump_t;
|
|
|
|
typedef struct {
|
|
guint64 packet_count;
|
|
guint8 network_type;
|
|
} niobserver_dump_t;
|
|
|
|
typedef struct {
|
|
guint32 file_len;
|
|
guint32 num_of_records;
|
|
guint32 file_offset;
|
|
} k12_dump_t;
|
|
|
|
typedef struct {
|
|
gboolean first_packet_written;
|
|
struct wtap_nstime start_time;
|
|
} dct2000_dump_t;
|
|
|
|
struct wtap_dumper {
|
|
FILE* fh;
|
|
int file_type;
|
|
int snaplen;
|
|
int encap;
|
|
gboolean compressed;
|
|
gint64 bytes_dumped;
|
|
|
|
union {
|
|
void *opaque;
|
|
ngsniffer_dump_t *ngsniffer;
|
|
netmon_dump_t *netmon;
|
|
netxray_dump_t *netxray;
|
|
_5views_dump_t *_5views;
|
|
niobserver_dump_t *niobserver;
|
|
k12_dump_t *k12;
|
|
dct2000_dump_t *dct2000;
|
|
} dump;
|
|
|
|
subtype_write_func subtype_write;
|
|
subtype_close_func subtype_close;
|
|
|
|
int tsprecision; /* timestamp precision of the lower 32bits
|
|
* e.g. WTAP_FILE_TSPREC_USEC */
|
|
};
|
|
|
|
extern size_t wtap_dump_file_write(wtap_dumper *wdh, const void *buf, unsigned bufsize);
|
|
extern int wtap_dump_file_ferror(wtap_dumper *wdh);
|
|
|
|
extern gint wtap_num_file_types;
|
|
|
|
/* Macros to byte-swap 32-bit and 16-bit quantities. */
|
|
#define BSWAP32(x) \
|
|
((((x)&0xFF000000)>>24) | \
|
|
(((x)&0x00FF0000)>>8) | \
|
|
(((x)&0x0000FF00)<<8) | \
|
|
(((x)&0x000000FF)<<24))
|
|
#define BSWAP16(x) \
|
|
((((x)&0xFF00)>>8) | \
|
|
(((x)&0x00FF)<<8))
|
|
|
|
/* Macros to byte-swap possibly-unaligned 32-bit and 16-bit quantities;
|
|
* they take a pointer to the quantity, and byte-swap it in place.
|
|
*/
|
|
#define PBSWAP32(p) \
|
|
{ \
|
|
guint8 tmp; \
|
|
tmp = (p)[3]; \
|
|
(p)[3] = (p)[0]; \
|
|
(p)[0] = tmp; \
|
|
tmp = (p)[2]; \
|
|
(p)[2] = (p)[1]; \
|
|
(p)[1] = tmp; \
|
|
}
|
|
#define PBSWAP16(p) \
|
|
{ \
|
|
guint8 tmp; \
|
|
tmp = (p)[1]; \
|
|
(p)[1] = (p)[0]; \
|
|
(p)[0] = tmp; \
|
|
}
|
|
|
|
/* Turn host-byte-order values into little-endian values. */
|
|
#define htoles(s) GUINT16_TO_LE(s)
|
|
#define htolel(l) GUINT32_TO_LE(l)
|
|
#define htolell(ll) GUINT64_TO_LE(ll)
|
|
|
|
/* Pointer versions of ntohs and ntohl. Given a pointer to a member of a
|
|
* byte array, returns the value of the two or four bytes at the pointer.
|
|
* The pletoh[sl] versions return the little-endian representation.
|
|
* We also provide pntohll and pletohll, which extract 64-bit integral
|
|
* quantities.
|
|
*
|
|
* These will work regardless of the byte alignment of the pointer.
|
|
*/
|
|
|
|
#ifndef pntohs
|
|
#define pntohs(p) ((guint16) \
|
|
((guint16)*((const guint8 *)(p)+0)<<8| \
|
|
(guint16)*((const guint8 *)(p)+1)<<0))
|
|
#endif
|
|
|
|
#ifndef pntoh24
|
|
#define pntoh24(p) ((guint32)*((const guint8 *)(p)+0)<<16| \
|
|
(guint32)*((const guint8 *)(p)+1)<<8| \
|
|
(guint32)*((const guint8 *)(p)+2)<<0)
|
|
#endif
|
|
|
|
#ifndef pntohl
|
|
#define pntohl(p) ((guint32)*((const guint8 *)(p)+0)<<24| \
|
|
(guint32)*((const guint8 *)(p)+1)<<16| \
|
|
(guint32)*((const guint8 *)(p)+2)<<8| \
|
|
(guint32)*((const guint8 *)(p)+3)<<0)
|
|
#endif
|
|
|
|
#ifndef pntohll
|
|
#define pntohll(p) ((guint64)*((const guint8 *)(p)+0)<<56| \
|
|
(guint64)*((const guint8 *)(p)+1)<<48| \
|
|
(guint64)*((const guint8 *)(p)+2)<<40| \
|
|
(guint64)*((const guint8 *)(p)+3)<<32| \
|
|
(guint64)*((const guint8 *)(p)+4)<<24| \
|
|
(guint64)*((const guint8 *)(p)+5)<<16| \
|
|
(guint64)*((const guint8 *)(p)+6)<<8| \
|
|
(guint64)*((const guint8 *)(p)+7)<<0)
|
|
#endif
|
|
|
|
|
|
#ifndef pletohs
|
|
#define pletohs(p) ((guint16) \
|
|
((guint16)*((const guint8 *)(p)+1)<<8| \
|
|
(guint16)*((const guint8 *)(p)+0)<<0))
|
|
#endif
|
|
|
|
#ifndef pletoh24
|
|
#define pletoh24(p) ((guint32)*((const guint8 *)(p)+2)<<16| \
|
|
(guint32)*((const guint8 *)(p)+1)<<8| \
|
|
(guint32)*((const guint8 *)(p)+0)<<0)
|
|
#endif
|
|
|
|
|
|
#ifndef pletohl
|
|
#define pletohl(p) ((guint32)*((const guint8 *)(p)+3)<<24| \
|
|
(guint32)*((const guint8 *)(p)+2)<<16| \
|
|
(guint32)*((const guint8 *)(p)+1)<<8| \
|
|
(guint32)*((const guint8 *)(p)+0)<<0)
|
|
#endif
|
|
|
|
|
|
#ifndef pletohll
|
|
#define pletohll(p) ((guint64)*((const guint8 *)(p)+7)<<56| \
|
|
(guint64)*((const guint8 *)(p)+6)<<48| \
|
|
(guint64)*((const guint8 *)(p)+5)<<40| \
|
|
(guint64)*((const guint8 *)(p)+4)<<32| \
|
|
(guint64)*((const guint8 *)(p)+3)<<24| \
|
|
(guint64)*((const guint8 *)(p)+2)<<16| \
|
|
(guint64)*((const guint8 *)(p)+1)<<8| \
|
|
(guint64)*((const guint8 *)(p)+0)<<0)
|
|
#endif
|
|
|
|
/* Pointer routines to put items out in a particular byte order.
|
|
* These will work regardless of the byte alignment of the pointer.
|
|
*/
|
|
|
|
#ifndef phtons
|
|
#define phtons(p, v) \
|
|
{ \
|
|
(p)[0] = (guint8)((v) >> 8); \
|
|
(p)[1] = (guint8)((v) >> 0); \
|
|
}
|
|
#endif
|
|
|
|
#ifndef phtonl
|
|
#define phtonl(p, v) \
|
|
{ \
|
|
(p)[0] = (guint8)((v) >> 24); \
|
|
(p)[1] = (guint8)((v) >> 16); \
|
|
(p)[2] = (guint8)((v) >> 8); \
|
|
(p)[3] = (guint8)((v) >> 0); \
|
|
}
|
|
#endif
|
|
|
|
#define wtap_file_read_unknown_bytes(target, num_bytes, fh, err) \
|
|
G_STMT_START \
|
|
{ \
|
|
int _bytes_read; \
|
|
_bytes_read = file_read((target), 1, (num_bytes), (fh)); \
|
|
if (_bytes_read != (int) (num_bytes)) { \
|
|
*(err) = file_error((fh)); \
|
|
return FALSE; \
|
|
} \
|
|
} \
|
|
G_STMT_END
|
|
|
|
#define wtap_file_read_expected_bytes(target, num_bytes, fh, err) \
|
|
G_STMT_START \
|
|
{ \
|
|
int _bytes_read; \
|
|
_bytes_read = file_read((target), 1, (num_bytes), (fh)); \
|
|
if (_bytes_read != (int) (num_bytes)) { \
|
|
*(err) = file_error((fh)); \
|
|
if (*(err) == 0 && _bytes_read > 0) { \
|
|
*(err) = WTAP_ERR_SHORT_READ; \
|
|
} \
|
|
return FALSE; \
|
|
} \
|
|
} \
|
|
G_STMT_END
|
|
|
|
/* glib doesn't have g_ptr_array_len of all things!*/
|
|
#ifndef g_ptr_array_len
|
|
#define g_ptr_array_len(a) ((a)->len)
|
|
#endif
|
|
|
|
#endif /* __WTAP_INT_H__ */
|