wiretap/wtap-int.h

   1 /* wtap-int.h
   2  *
   3  * $Id$
   4  *
   5  * Wiretap Library
   6  * Copyright (c) 1998 by Gilbert Ramirez <gram@alumni.rice.edu>
   7  *
   8  * This program is free software; you can redistribute it and/or
   9  * modify it under the terms of the GNU General Public License
  10  * as published by the Free Software Foundation; either version 2
  11  * of the License, or (at your option) any later version.
  12  *
  13  * This program is distributed in the hope that it will be useful,
  14  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  15  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  16  * GNU General Public License for more details.
  17  *
  18  * You should have received a copy of the GNU General Public License
  19  * along with this program; if not, write to the Free Software
  20  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  21  */
  22
  23 #ifndef __WTAP_INT_H__
  24 #define __WTAP_INT_H__
  25
  26 #ifdef HAVE_SYS_TIME_H
  27 #include <sys/time.h>
  28 #endif
  29
  30 #include <glib.h>
  31 #include <stdio.h>
  32 #include <time.h>
  33
  34 #ifdef HAVE_WINSOCK2_H
  35 #include <winsock2.h>
  36 #endif
  37
  38 #include <wsutil/file_util.h>
  39
  40 #include "wtap.h"
  41
  42 WS_DLL_PUBLIC
  43 int wtap_fstat(wtap *wth, ws_statb64 *statb, int *err);
  44
  45 typedef gboolean (*subtype_read_func)(struct wtap*, int*, char**, gint64*);
  46 typedef gboolean (*subtype_seek_read_func)(struct wtap*, gint64,
  47                                            struct wtap_pkthdr *, Buffer *buf,
  48                                            int, int *, char **);
  49 /**
  50  * Struct holding data of the currently read file.
  51  */
  52 struct wtap {
  53     FILE_T                      fh;
  54     FILE_T                      random_fh;              /**< Secondary FILE_T for random access */
  55     int                         file_type_subtype;
  56     guint                       snapshot_length;
  57     struct Buffer               *frame_buffer;
  58     struct wtap_pkthdr          phdr;
  59     struct wtapng_section_s     shb_hdr;
  60     guint                       number_of_interfaces;   /**< The number of interfaces a capture was made on, number of IDB:s in a pcapng file or equivalent(?)*/
  61     GArray                      *interface_data;        /**< An array holding the interface data from pcapng IDB:s or equivalent(?)*/
  62
  63     void                        *priv;
  64
  65     subtype_read_func           subtype_read;
  66     subtype_seek_read_func      subtype_seek_read;
  67     void                        (*subtype_sequential_close)(struct wtap*);
  68     void                        (*subtype_close)(struct wtap*);
  69     int                         file_encap;    /* per-file, for those
  70                                                 * file formats that have
  71                                                 * per-file encapsulation
  72                                                 * types
  73                                                 */
  74     int                         tsprecision;   /* timestamp precision of the lower 32bits
  75                                                 * e.g. WTAP_FILE_TSPREC_USEC
  76                                                 */
  77     wtap_new_ipv4_callback_t    add_new_ipv4;
  78     wtap_new_ipv6_callback_t    add_new_ipv6;
  79     GPtrArray                   *fast_seek;
  80 };
  81
  82 struct wtap_dumper;
  83
  84 /*
  85  * This could either be a FILE * or a gzFile.
  86  */
  87 typedef void *WFILE_T;
  88
  89 typedef gboolean (*subtype_write_func)(struct wtap_dumper*,
  90                                        const struct wtap_pkthdr*,
  91                                        const guint8*, int*);
  92 typedef gboolean (*subtype_close_func)(struct wtap_dumper*, int*);
  93
  94 struct wtap_dumper {
  95     WFILE_T                 fh;
  96     int                     file_type_subtype;
  97     int                     snaplen;
  98     int                     encap;
  99     gboolean                compressed;
 100     gint64                  bytes_dumped;
 101
 102     void                    *priv;
 103
 104     subtype_write_func      subtype_write;
 105     subtype_close_func      subtype_close;
 106
 107     int                     tsprecision;    /**< timestamp precision of the lower 32bits
 108                                              * e.g. WTAP_FILE_TSPREC_USEC
 109                                              */
 110     addrinfo_lists_t        *addrinfo_lists;        /**< Struct containing lists of resolved addresses */
 111     struct wtapng_section_s *shb_hdr;
 112     guint                   number_of_interfaces;   /**< The number of interfaces a capture was made on, number of IDB:s in a pcapng file or equivalent(?)*/
 113     GArray                  *interface_data;        /**< An array holding the interface data from pcapng IDB:s or equivalent(?) NULL if not present.*/
 114 };
 115
 116 gboolean wtap_dump_file_write(wtap_dumper *wdh, const void *buf,
 117     size_t bufsize, int *err);
 118 gint64 wtap_dump_file_seek(wtap_dumper *wdh, gint64 offset, int whence, int *err);
 119 gint64 wtap_dump_file_tell(wtap_dumper *wdh, int *err);
 120
 121
 122 extern gint wtap_num_file_types;
 123
 124 /* Macros to byte-swap 64-bit, 32-bit and 16-bit quantities. */
 125 #define BSWAP64(x) \
 126     ((((x)&G_GINT64_CONSTANT(0xFF00000000000000U))>>56) |    \
 127          (((x)&G_GINT64_CONSTANT(0x00FF000000000000U))>>40) |    \
 128      (((x)&G_GINT64_CONSTANT(0x0000FF0000000000U))>>24) |    \
 129      (((x)&G_GINT64_CONSTANT(0x000000FF00000000U))>>8) |    \
 130      (((x)&G_GINT64_CONSTANT(0x00000000FF000000U))<<8) |    \
 131      (((x)&G_GINT64_CONSTANT(0x0000000000FF0000U))<<24) |    \
 132      (((x)&G_GINT64_CONSTANT(0x000000000000FF00U))<<40) |    \
 133      (((x)&G_GINT64_CONSTANT(0x00000000000000FFU))<<56))
 134 #define    BSWAP32(x) \
 135     ((((x)&0xFF000000)>>24) | \
 136      (((x)&0x00FF0000)>>8) | \
 137      (((x)&0x0000FF00)<<8) | \
 138      (((x)&0x000000FF)<<24))
 139 #define    BSWAP16(x) \
 140      ((((x)&0xFF00)>>8) | \
 141       (((x)&0x00FF)<<8))
 142
 143 /* Macros to byte-swap possibly-unaligned 64-bit, 32-bit and 16-bit quantities;
 144  * they take a pointer to the quantity, and byte-swap it in place.
 145  */
 146 #define PBSWAP64(p) \
 147     {            \
 148         guint8 tmp;        \
 149         tmp = (p)[7];      \
 150         (p)[7] = (p)[0];   \
 151         (p)[0] = tmp;      \
 152         tmp = (p)[6];      \
 153         (p)[6] = (p)[1];   \
 154         (p)[1] = tmp;      \
 155         tmp = (p)[5];      \
 156         (p)[5] = (p)[2];   \
 157         (p)[2] = tmp;      \
 158         tmp = (p)[4];      \
 159         (p)[4] = (p)[3];   \
 160         (p)[3] = tmp;      \
 161     }
 162 #define PBSWAP32(p) \
 163     {            \
 164         guint8 tmp;         \
 165         tmp = (p)[3];       \
 166         (p)[3] = (p)[0];    \
 167         (p)[0] = tmp;       \
 168         tmp = (p)[2];       \
 169         (p)[2] = (p)[1];    \
 170         (p)[1] = tmp;       \
 171     }
 172 #define PBSWAP16(p) \
 173     {            \
 174         guint8 tmp;        \
 175         tmp = (p)[1];      \
 176         (p)[1] = (p)[0];   \
 177         (p)[0] = tmp;      \
 178     }
 179
 180 /* Pointer versions of ntohs and ntohl.  Given a pointer to a member of a
 181  * byte array, returns the value of the two or four bytes at the pointer.
 182  * The pletoh[sl] versions return the little-endian representation.
 183  * We also provide pntohll and pletohll, which extract 64-bit integral
 184  * quantities.
 185  *
 186  * These will work regardless of the byte alignment of the pointer.
 187  */
 188
 189 #ifndef pntohs
 190 #define pntohs(p)  ((guint16)                       \
 191                     ((guint16)*((const guint8 *)(p)+0)<<8|  \
 192                      (guint16)*((const guint8 *)(p)+1)<<0))
 193 #endif
 194
 195 #ifndef pntoh24
 196 #define pntoh24(p)  ((guint32)*((const guint8 *)(p)+0)<<16| \
 197                      (guint32)*((const guint8 *)(p)+1)<<8|  \
 198                      (guint32)*((const guint8 *)(p)+2)<<0)
 199 #endif
 200
 201 #ifndef pntohl
 202 #define pntohl(p)  ((guint32)*((const guint8 *)(p)+0)<<24|  \
 203                     (guint32)*((const guint8 *)(p)+1)<<16|  \
 204                     (guint32)*((const guint8 *)(p)+2)<<8|   \
 205                     (guint32)*((const guint8 *)(p)+3)<<0)
 206 #endif
 207
 208 #ifndef pntohll
 209 #define pntohll(p)  ((guint64)*((const guint8 *)(p)+0)<<56|  \
 210                      (guint64)*((const guint8 *)(p)+1)<<48|  \
 211                      (guint64)*((const guint8 *)(p)+2)<<40|  \
 212                      (guint64)*((const guint8 *)(p)+3)<<32|  \
 213                      (guint64)*((const guint8 *)(p)+4)<<24|  \
 214                      (guint64)*((const guint8 *)(p)+5)<<16|  \
 215                      (guint64)*((const guint8 *)(p)+6)<<8|   \
 216                      (guint64)*((const guint8 *)(p)+7)<<0)
 217 #endif
 218
 219
 220 #ifndef pletohs
 221 #define pletohs(p) ((guint16)                       \
 222                     ((guint16)*((const guint8 *)(p)+1)<<8|  \
 223                      (guint16)*((const guint8 *)(p)+0)<<0))
 224 #endif
 225
 226 #ifndef pletoh24
 227 #define pletoh24(p) ((guint32)*((const guint8 *)(p)+2)<<16|  \
 228                      (guint32)*((const guint8 *)(p)+1)<<8|  \
 229                      (guint32)*((const guint8 *)(p)+0)<<0)
 230 #endif
 231
 232
 233 #ifndef pletohl
 234 #define pletohl(p) ((guint32)*((const guint8 *)(p)+3)<<24|  \
 235                     (guint32)*((const guint8 *)(p)+2)<<16|  \
 236                     (guint32)*((const guint8 *)(p)+1)<<8|   \
 237                     (guint32)*((const guint8 *)(p)+0)<<0)
 238 #endif
 239
 240
 241 #ifndef pletohll
 242 #define pletohll(p) ((guint64)*((const guint8 *)(p)+7)<<56|  \
 243                      (guint64)*((const guint8 *)(p)+6)<<48|  \
 244                      (guint64)*((const guint8 *)(p)+5)<<40|  \
 245                      (guint64)*((const guint8 *)(p)+4)<<32|  \
 246                      (guint64)*((const guint8 *)(p)+3)<<24|  \
 247                      (guint64)*((const guint8 *)(p)+2)<<16|  \
 248                      (guint64)*((const guint8 *)(p)+1)<<8|   \
 249                      (guint64)*((const guint8 *)(p)+0)<<0)
 250 #endif
 251
 252 /* Pointer routines to put items out in a particular byte order.
 253  * These will work regardless of the byte alignment of the pointer.
 254  */
 255
 256 #ifndef phtons
 257 #define phtons(p, v) \
 258     {                 \
 259         (p)[0] = (guint8)((v) >> 8);    \
 260         (p)[1] = (guint8)((v) >> 0);    \
 261     }
 262 #endif
 263
 264 #ifndef phton24
 265 #define phton24(p, v) \
 266     {                 \
 267         (p)[0] = (guint8)((v) >> 16);    \
 268         (p)[1] = (guint8)((v) >> 8);     \
 269         (p)[2] = (guint8)((v) >> 0);     \
 270     }
 271 #endif
 272
 273 #ifndef phtonl
 274 #define phtonl(p, v) \
 275     {                 \
 276         (p)[0] = (guint8)((v) >> 24);    \
 277         (p)[1] = (guint8)((v) >> 16);    \
 278         (p)[2] = (guint8)((v) >> 8);     \
 279         (p)[3] = (guint8)((v) >> 0);     \
 280     }
 281 #endif
 282
 283 #ifndef phtonll
 284 #define phtonll(p, v) \
 285     {                 \
 286         (p)[0] = (guint8)((v) >> 56);    \
 287         (p)[1] = (guint8)((v) >> 48);    \
 288         (p)[2] = (guint8)((v) >> 40);    \
 289         (p)[3] = (guint8)((v) >> 32);    \
 290         (p)[4] = (guint8)((v) >> 24);    \
 291         (p)[5] = (guint8)((v) >> 16);    \
 292         (p)[6] = (guint8)((v) >> 8);     \
 293         (p)[7] = (guint8)((v) >> 0);     \
 294     }
 295 #endif
 296
 297 #ifndef phtoles
 298 #define phtoles(p, v) \
 299     {                 \
 300         (p)[0] = (guint8)((v) >> 0);    \
 301         (p)[1] = (guint8)((v) >> 8);    \
 302     }
 303 #endif
 304
 305 #ifndef phtolel
 306 #define phtolel(p, v) \
 307     {                 \
 308         (p)[0] = (guint8)((v) >> 0);     \
 309         (p)[1] = (guint8)((v) >> 8);     \
 310         (p)[2] = (guint8)((v) >> 16);    \
 311         (p)[3] = (guint8)((v) >> 24);    \
 312     }
 313 #endif
 314
 315 #ifndef phtolell
 316 #define phtolell(p, v) \
 317     {                 \
 318         (p)[0] = (guint8)((v) >> 0);     \
 319         (p)[1] = (guint8)((v) >> 8);     \
 320         (p)[2] = (guint8)((v) >> 16);    \
 321         (p)[3] = (guint8)((v) >> 24);    \
 322         (p)[4] = (guint8)((v) >> 32);    \
 323         (p)[5] = (guint8)((v) >> 40);    \
 324         (p)[6] = (guint8)((v) >> 48);    \
 325         (p)[7] = (guint8)((v) >> 56);    \
 326     }
 327 #endif
 328
 329 #define wtap_file_read_unknown_bytes(target, num_bytes, fh, err, err_info) \
 330     G_STMT_START \
 331     { \
 332         int _bytes_read; \
 333         _bytes_read = file_read((target), (num_bytes), (fh)); \
 334         if (_bytes_read != (int) (num_bytes)) { \
 335             *(err) = file_error((fh), (err_info)); \
 336             return FALSE; \
 337         } \
 338     } \
 339     G_STMT_END
 340
 341 #define wtap_file_read_expected_bytes(target, num_bytes, fh, err, err_info) \
 342     G_STMT_START \
 343     { \
 344         int _bytes_read; \
 345         _bytes_read = file_read((target), (num_bytes), (fh)); \
 346         if (_bytes_read != (int) (num_bytes)) { \
 347             *(err) = file_error((fh), (err_info)); \
 348             if (*(err) == 0 && _bytes_read > 0) { \
 349                 *(err) = WTAP_ERR_SHORT_READ; \
 350             } \
 351             return FALSE; \
 352         } \
 353     } \
 354     G_STMT_END
 355
 356 /* glib doesn't have g_ptr_array_len of all things!*/
 357 #ifndef g_ptr_array_len
 358 #define g_ptr_array_len(a)      ((a)->len)
 359 #endif
 360
 361 /*** get GSList of all compressed file extensions ***/
 362 GSList *wtap_get_compressed_file_extensions(void);
 363
 364 /*
 365  * Read packet data into a Buffer, growing the buffer as necessary.
 366  *
 367  * This returns an error on a short read, even if the short read hit
 368  * the EOF immediately.  (The assumption is that each packet has a
 369  * header followed by raw packet data, and that we've already read the
 370  * header, so if we get an EOF trying to read the packet data, the file
 371  * has been cut short, even if the read didn't read any data at all.)
 372  */
 373 gboolean
 374 wtap_read_packet_bytes(FILE_T fh, Buffer *buf, guint length, int *err,
 375     gchar **err_info);
 376
 377 #endif /* __WTAP_INT_H__ */
 378
 379 /*
 380  * Editor modelines
 381  *
 382  * Local Variables:
 383  * c-basic-offset: 8
 384  * tab-width: 8
 385  * indent-tabs-mode: t
 386  * End:
 387  *
 388  * ex: set shiftwidth=8 tabstop=8 noexpandtab:
 389  * :indentSize=8:tabSize=8:noTabs=false:
 390  */