From Martin Mathieson:
[obnox/wireshark/wip.git] / wiretap / wtap.c
index 404bea309499f41eaca2b3e655337c8eb9914af4..c410e13190c1760fc3df07472d2dde25b2fa4e40 100644 (file)
@@ -1,64 +1,90 @@
 /* wtap.c
  *
- * $Id: wtap.c,v 1.35 1999/12/12 22:53:25 guy Exp $
+ * $Id$
  *
  * Wiretap Library
- * Copyright (c) 1998 by Gilbert Ramirez <gram@verdict.uthscsa.edu>
- * 
+ * 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.
- *
  */
-#include <string.h>
-#include <errno.h>
 
 #ifdef HAVE_CONFIG_H
 #include "config.h"
 #endif
+
+#include <string.h>
+#include <errno.h>
+
+#ifdef HAVE_SYS_TYPES_H
+#include <sys/types.h>
+#endif
+
+#ifdef HAVE_UNISTD_H
+#include <unistd.h>
+#endif
+
+#include "wtap-int.h"
 #include "wtap.h"
-#include "file.h"
+
+#include "file_wrappers.h"
+#include "file_util.h"
 #include "buffer.h"
-#include "ascend.h"
-#include "toshiba.h"
 
-FILE* wtap_file(wtap *wth)
+/*
+ * Return the size of the file, as reported by the OS.
+ * (gint64, in case that's 64 bits.)
+ */
+gint64
+wtap_file_size(wtap *wth, int *err)
 {
-       return wth->fh;
-}
+       struct stat statb;
 
-int wtap_fd(wtap *wth)
-{
-       return wth->fd;
+       if (fstat(wth->fd, &statb) == -1) {
+               if (err != NULL)
+                       *err = errno;
+               return -1;
+       }
+       return statb.st_size;
 }
 
-int wtap_file_type(wtap *wth)
+int
+wtap_file_type(wtap *wth)
 {
        return wth->file_type;
 }
 
-int wtap_snapshot_length(wtap *wth)
+int
+wtap_snapshot_length(wtap *wth)
 {
        return wth->snapshot_length;
 }
 
-int wtap_file_encap(wtap *wth)
+int
+wtap_file_encap(wtap *wth)
 {
        return wth->file_encap;
 }
 
+int
+wtap_file_tsprecision(wtap *wth)
+{
+       return wth->tsprecision;
+}
+
 /* Table of the encapsulation types we know about. */
-const static struct encap_type_info {
+static const struct encap_type_info {
        const char *name;
        const char *short_name;
 } encap_table[WTAP_NUM_ENCAP_TYPES] = {
@@ -68,7 +94,7 @@ const static struct encap_type_info {
        /* WTAP_ENCAP_ETHERNET */
        { "Ethernet", "ether" },
 
-       /* WTAP_ENCAP_TR */
+       /* WTAP_ENCAP_TOKEN_RING */
        { "Token Ring", "tr" },
 
        /* WTAP_ENCAP_SLIP */
@@ -89,6 +115,9 @@ const static struct encap_type_info {
        /* WTAP_ENCAP_ARCNET */
        { "ARCNET", "arcnet" },
 
+       /* WTAP_ENCAP_ARCNET_LINUX */
+       { "Linux ARCNET", "arcnet_linux" },
+
        /* WTAP_ENCAP_ATM_RFC1483 */
        { "RFC 1483 ATM", "atm-rfc1483" },
 
@@ -98,8 +127,11 @@ const static struct encap_type_info {
        /* WTAP_ENCAP_LAPB */
        { "LAPB", "lapb" },
 
-       /* WTAP_ENCAP_ATM_SNIFFER */
-       { "ATM Sniffer", "atm-sniffer" },
+       /* WTAP_ENCAP_ATM_PDUS */
+       { "ATM PDUs", "atm-pdus" },
+
+       /* WTAP_ENCAP_ATM_PDUS_UNTRUNCATED */
+       { "ATM PDUs - untruncated", "atm-pdus-untruncated" },
 
        /* WTAP_ENCAP_NULL */
        { "NULL", "null" },
@@ -107,15 +139,232 @@ const static struct encap_type_info {
        /* WTAP_ENCAP_ASCEND */
        { "Lucent/Ascend access equipment", "ascend" },
 
-       /* WTAP_ENCAP_LAPD */
-       { "LAPD", "lapd" },
+       /* WTAP_ENCAP_ISDN */
+       { "ISDN", "isdn" },
+
+       /* WTAP_ENCAP_IP_OVER_FC */
+       { "RFC 2625 IP-over-Fibre Channel", "ip-over-fc" },
+
+       /* WTAP_ENCAP_PPP_WITH_PHDR */
+       { "PPP with Directional Info", "ppp-with-direction" },
+
+       /* WTAP_ENCAP_IEEE_802_11 */
+       { "IEEE 802.11 Wireless LAN", "ieee-802-11" },
+
+       /* WTAP_ENCAP_PRISM_HEADER */
+       { "IEEE 802.11 plus Prism II monitor mode header", "prism" },
+
+       /* WTAP_ENCAP_IEEE_802_11_WITH_RADIO */
+       { "IEEE 802.11 Wireless LAN with radio information", "ieee-802-11-radio" },
+
+       /* WTAP_ENCAP_IEEE_802_11_WLAN_RADIOTAP */
+       { "IEEE 802.11 plus radiotap WLAN header", "ieee-802-11-radiotap" },
+
+       /* WTAP_ENCAP_IEEE_802_11_WLAN_AVS */
+       { "IEEE 802.11 plus AVS WLAN header", "ieee-802-11-avs" },
+
+       /* WTAP_ENCAP_SLL */
+       { "Linux cooked-mode capture", "linux-sll" },
+
+       /* WTAP_ENCAP_FRELAY */
+       { "Frame Relay", "frelay" },
+
+       /* WTAP_ENCAP_FRELAY_WITH_PHDR */
+       { "Frame Relay with Directional Info", "frelay-with-direction" },
+
+       /* WTAP_ENCAP_CHDLC */
+       { "Cisco HDLC", "chdlc" },
+
+       /* WTAP_ENCAP_CISCO_IOS */
+       { "Cisco IOS internal", "ios" },
+
+       /* WTAP_ENCAP_LOCALTALK */
+       { "Localtalk", "ltalk" },
+
+       /* WTAP_ENCAP_OLD_PFLOG  */
+       { "OpenBSD PF Firewall logs, pre-3.4", "pflog-old" },
+
+       /* WTAP_ENCAP_HHDLC */
+       { "HiPath HDLC", "hhdlc" },
+
+       /* WTAP_ENCAP_DOCSIS */
+       { "Data Over Cable Service Interface Specification", "docsis" },
+
+       /* WTAP_ENCAP_COSINE */
+       { "CoSine L2 debug log", "cosine" },
+
+       /* WTAP_ENCAP_WFLEET_HDLC */
+       { "Wellfleet HDLC", "whdlc" },
+
+       /* WTAP_ENCAP_SDLC */
+       { "SDLC", "sdlc" },
+
+       /* WTAP_ENCAP_TZSP */
+       { "Tazmen sniffer protocol", "tzsp" },
+
+       /* WTAP_ENCAP_ENC */
+       { "OpenBSD enc(4) encapsulating interface", "enc" },
+
+       /* WTAP_ENCAP_PFLOG  */
+       { "OpenBSD PF Firewall logs", "pflog" },
+
+       /* WTAP_ENCAP_CHDLC_WITH_PHDR */
+       { "Cisco HDLC with Directional Info", "chdlc-with-direction" },
+
+       /* WTAP_ENCAP_BLUETOOTH_H4 */
+       { "Bluetooth H4", "bluetooth-h4" },
+
+       /* WTAP_ENCAP_MTP2 */
+       { "SS7 MTP2", "mtp2" },
+
+       /* WTAP_ENCAP_MTP3 */
+       { "SS7 MTP3", "mtp3" },
+
+       /* WTAP_ENCAP_IRDA */
+       { "IrDA", "irda" },
+
+       /* WTAP_ENCAP_USER0 */
+       { "USER 0", "user0" },
+
+       /* WTAP_ENCAP_USER1 */
+       { "USER 1", "user1" },
+
+       /* WTAP_ENCAP_USER2 */
+       { "USER 2", "user2" },
+
+       /* WTAP_ENCAP_USER3 */
+       { "USER 3", "user3" },
+
+       /* WTAP_ENCAP_USER4 */
+       { "USER 4", "user4" },
+
+       /* WTAP_ENCAP_USER5 */
+       { "USER 5", "user5" },
+
+       /* WTAP_ENCAP_USER6 */
+       { "USER 6", "user6" },
+
+       /* WTAP_ENCAP_USER7 */
+       { "USER 7", "user7" },
+
+       /* WTAP_ENCAP_USER8 */
+       { "USER 8", "user8" },
 
-       /* WTAP_ENCAP_V120 */
-       { "V.120", "v120" },
+       /* WTAP_ENCAP_USER9 */
+       { "USER 9", "user9" },
+
+       /* WTAP_ENCAP_USER10 */
+       { "USER 10", "user10" },
+
+       /* WTAP_ENCAP_USER11 */
+       { "USER 11", "user11" },
+
+       /* WTAP_ENCAP_USER12 */
+       { "USER 12", "user12" },
+
+       /* WTAP_ENCAP_USER13 */
+       { "USER 13", "user13" },
+
+       /* WTAP_ENCAP_USER14 */
+       { "USER 14", "user14" },
+
+       /* WTAP_ENCAP_USER15 */
+       { "USER 15", "user15" },
+
+       /* WTAP_ENCAP_SYMANTEC */
+       { "Symantec Enterprise Firewall", "symantec" },
+
+       /* WTAP_ENCAP_APPLE_IP_OVER_IEEE1394 */
+       { "Apple IP-over-IEEE 1394", "ap1394" },
+
+       /* WTAP_ENCAP_BACNET_MS_TP */
+       { "BACnet MS/TP", "bacnet-ms-tp" },
+
+       /* WTAP_ENCAP_NETTL_RAW_ICMP */
+       { "Raw ICMP with nettl headers", "raw-icmp-nettl" },
+
+       /* WTAP_ENCAP_NETTL_RAW_ICMPV6 */
+       { "Raw ICMPv6 with nettl headers", "raw-icmpv6-nettl" },
+
+       /* UNUSED */
+       { "", "" },
+
+       /* WTAP_ENCAP_GPRS_LLC */
+       { "GPRS LLC", "gprs-llc" },
+
+       /* WTAP_ENCAP_JUNIPER_ATM1 */
+       { "Juniper ATM1", "juniper-atm1" },
+
+       /* WTAP_ENCAP_JUNIPER_ATM2 */
+       { "Juniper ATM2", "juniper-atm2" },
+
+       /* WTAP_ENCAP_REDBACK */
+       { "Redback SmartEdge", "redback" },
+
+       /* WTAP_ENCAP_NETTL_RAW_IP */
+       { "Raw IP with nettl headers", "rawip-nettl" },
+
+       /* WTAP_ENCAP_NETTL_ETHERNET */
+       { "Ethernet with nettl headers", "ether-nettl" },
+
+       /* WTAP_ENCAP_NETTL_TOKEN_RING */
+       { "Token Ring with nettl headers", "tr-nettl" },
+
+       /* WTAP_ENCAP_NETTL_FDDI */
+       { "FDDI with nettl headers", "fddi-nettl" },
+
+       /* WTAP_ENCAP_NETTL_UNKNOWN */
+       { "Unknown link-layer type with nettl headers", "unknown-nettl" },
+
+       /* WTAP_ENCAP_MTP2_WITH_PHDR */
+       { "MTP2 with pseudoheader", "mtp2-with-phdr" },
+
+       /* WTAP_ENCAP_JUNIPER_PPPOE */
+       { "Juniper PPPoE", "juniper-pppoe" },
+
+       /* WTAP_ENCAP_GCOM_TIE1 */
+       { "GCOM TIE1", "gcom-tie1" },
+
+       /* WTAP_ENCAP_GCOM_SERIAL */
+       { "GCOM Serial", "gcom-serial" },
+
+       /* WTAP_ENCAP_NETTL_X25 */
+       { "X25 with nettl headers", "x25-nettl" },
+
+       /* WTAP_ENCAP_K12 */
+       { "K12 protocol analyzer", "k12" },
+
+       /* WTAP_ENCAP_JUNIPER_MLPPP */
+       { "Juniper MLPPP", "juniper-mlppp" },
+
+       /* WTAP_ENCAP_JUNIPER_MLFR */
+       { "Juniper MLFR", "juniper-mlfr" },
+
+       /* WTAP_ENCAP_JUNIPER_ETHER */
+       { "Juniper Ethernet", "juniper-ether" },
+
+       /* WTAP_ENCAP_JUNIPER_PPP */
+       { "Juniper PPP", "juniper-ppp" },
+
+       /* WTAP_ENCAP_JUNIPER_FRELAY */
+       { "Juniper Frame-Relay", "juniper-frelay" },
+
+       /* WTAP_ENCAP_JUNIPER_CHDLC */
+       { "Juniper C-HDLC", "juniper-chdlc" },
+    
+       /* WTAP_ENCAP_JUNIPER_GGSN */
+       { "Juniper GGSN", "juniper-ggsn" },
+
+       /* WTAP_ENCAP_LINUX_LAPD */
+       { "LAPD", "lapd" },
+
+       /* WTAP_ENCAP_CATAPULT_DCT2000 */
+       { "Catapult DCT2000", "dct2000" },
 };
 
 /* Name that should be somewhat descriptive. */
-const char *wtap_encap_string(int encap)
+const char
+*wtap_encap_string(int encap)
 {
        if (encap < 0 || encap >= WTAP_NUM_ENCAP_TYPES)
                return NULL;
@@ -124,7 +373,8 @@ const char *wtap_encap_string(int encap)
 }
 
 /* Name to use in, say, a command-line flag specifying the type. */
-const char *wtap_encap_short_string(int encap)
+const char
+*wtap_encap_short_string(int encap)
 {
        if (encap < 0 || encap >= WTAP_NUM_ENCAP_TYPES)
                return NULL;
@@ -133,7 +383,8 @@ const char *wtap_encap_short_string(int encap)
 }
 
 /* Translate a short name to a capture file type. */
-int wtap_short_string_to_encap(const char *short_name)
+int
+wtap_short_string_to_encap(const char *short_name)
 {
        int encap;
 
@@ -146,25 +397,32 @@ int wtap_short_string_to_encap(const char *short_name)
 }
 
 static const char *wtap_errlist[] = {
-       "The file isn't a plain file",
+       "The file isn't a plain file or pipe",
+       "The file is being opened for random access but is a pipe",
        "The file isn't a capture file in a known format",
        "File contains record data we don't support",
+       "That file format cannot be written to a pipe",
        NULL,
        "Files can't be saved in that format",
        "Files from that network type can't be saved in that format",
-       "That format doesn't support per-packet encapsulations",
+       "That file format doesn't support per-packet encapsulations",
        NULL,
        NULL,
        "Less data was read than was expected",
        "File contains a record that's not valid",
-       "Less data was written than was requested"
+       "Less data was written than was requested",
+       "Uncompression error: data oddly truncated",
+       "Uncompression error: data would overflow buffer",
+       "Uncompression error: bad LZ77 offset",
+       "The standard input cannot be opened for random access",
 };
 #define        WTAP_ERRLIST_SIZE       (sizeof wtap_errlist / sizeof wtap_errlist[0])
 
-const char *wtap_strerror(int err)
+const char
+*wtap_strerror(int err)
 {
-       static char errbuf[6+11+1];     /* "Error %d" */
-       int wtap_errlist_index;
+       static char errbuf[128];
+       unsigned int wtap_errlist_index;
 
        if (err < 0) {
 #ifdef HAVE_LIBZ
@@ -187,91 +445,121 @@ const char *wtap_strerror(int err)
                return strerror(err);
 }
 
-void wtap_close(wtap *wth)
+/* Close only the sequential side, freeing up memory it uses.
+
+   Note that we do *not* want to call the subtype's close function,
+   as it would free any per-subtype data, and that data may be
+   needed by the random-access side.
+
+   Instead, if the subtype has a "sequential close" function, we call it,
+   to free up stuff used only by the sequential side. */
+void
+wtap_sequential_close(wtap *wth)
 {
-       /* free up memory. If any capture structure ever allocates
-        * its own memory, it would be better to make a *close() function
-        * for each filetype, like pcap_close(0, lanalyzer_close(), etc.
-        * But for now this will work. */
-       switch(wth->file_type) {
-               case WTAP_FILE_PCAP:
-               case WTAP_FILE_PCAP_MODIFIED:
-                       g_free(wth->capture.pcap);
-                       break;
-
-               case WTAP_FILE_LANALYZER:
-                       g_free(wth->capture.lanalyzer);
-                       break;
-
-               case WTAP_FILE_NGSNIFFER:
-                       g_free(wth->capture.ngsniffer);
-                       break;
-
-               case WTAP_FILE_RADCOM:
-                       g_free(wth->capture.radcom);
-                       break;
-
-               case WTAP_FILE_NETMON_1_x:
-               case WTAP_FILE_NETMON_2_x:
-                       g_free(wth->capture.netmon);
-                       break;
-
-               case WTAP_FILE_NETXRAY_1_0:
-               case WTAP_FILE_NETXRAY_1_1:
-               case WTAP_FILE_NETXRAY_2_001:
-                       g_free(wth->capture.netxray);
-                       break;
-
-               case WTAP_FILE_ASCEND:
-                       g_free(wth->capture.ascend);
-                       break;
-
-               case WTAP_FILE_NETTL:
-                       g_free(wth->capture.nettl);
-                       break;
-
-               /* default:
-                        nothing */
-       }
+       if (wth->subtype_sequential_close != NULL)
+               (*wth->subtype_sequential_close)(wth);
 
-       file_close(wth->fh);
+       if (wth->fh != NULL) {
+               file_close(wth->fh);
+               wth->fh = NULL;
+       }
 
        if (wth->frame_buffer) {
                buffer_free(wth->frame_buffer);
                g_free(wth->frame_buffer);
+               wth->frame_buffer = NULL;
        }
+}
+
+void
+wtap_close(wtap *wth)
+{
+       wtap_sequential_close(wth);
+
+       if (wth->subtype_close != NULL)
+               (*wth->subtype_close)(wth);
+
+       if (wth->random_fh != NULL)
+               file_close(wth->random_fh);
 
        g_free(wth);
 }
 
-int wtap_loop(wtap *wth, int count, wtap_handler callback, u_char* user,
-       int *err)
+gboolean
+wtap_read(wtap *wth, int *err, gchar **err_info, long *data_offset)
 {
-       int data_offset, loop = 0;
+       /*
+        * Set the packet encapsulation to the file's encapsulation
+        * value; if that's not WTAP_ENCAP_PER_PACKET, it's the
+        * right answer (and means that the read routine for this
+        * capture file type doesn't have to set it), and if it
+        * *is* WTAP_ENCAP_PER_PACKET, the caller needs to set it
+        * anyway.
+        */
+       wth->phdr.pkt_encap = wth->file_encap;
+
+       if (!wth->subtype_read(wth, err, err_info, data_offset))
+               return FALSE;   /* failure */
 
-       while ((data_offset = wth->subtype_read(wth, err)) > 0) {
-               callback(user, &wth->phdr, data_offset,
-                   buffer_start_ptr(wth->frame_buffer));
-               if (count > 0 && ++loop >= count)
-                       break;
+       /*
+        * It makes no sense for the captured data length to be bigger
+        * than the actual data length.
+        */
+       if (wth->phdr.caplen > wth->phdr.len)
+               wth->phdr.caplen = wth->phdr.len;
+
+       /*
+        * Make sure that it's not WTAP_ENCAP_PER_PACKET, as that
+        * probably means the file has that encapsulation type
+        * but the read routine didn't set this packet's
+        * encapsulation type.
+        */
+       g_assert(wth->phdr.pkt_encap != WTAP_ENCAP_PER_PACKET);
+
+       return TRUE;    /* success */
+}
+
+/*
+ * Return an approximation of the amount of data we've read sequentially
+ * from the file so far.  (gint64, in case that's 64 bits.)
+ */
+gint64
+wtap_read_so_far(wtap *wth, int *err)
+{
+       off_t file_pos;
+
+       file_pos = eth_lseek(wth->fd, 0, SEEK_CUR);
+       if (file_pos == -1) {
+               if (err != NULL)
+                       *err = errno;
+               return -1;
        }
-       if (data_offset < 0)
-               return FALSE;   /* failure */
-       else
-               return TRUE;    /* success */
+       return file_pos;
 }
 
-int wtap_seek_read(int file_type, FILE *fh, int seek_off, guint8 *pd, int len)
+struct wtap_pkthdr*
+wtap_phdr(wtap *wth)
 {
-       switch (file_type) {
+       return &wth->phdr;
+}
 
-       case WTAP_FILE_ASCEND:
-               return ascend_seek_read(fh, seek_off, pd, len);
+union wtap_pseudo_header*
+wtap_pseudoheader(wtap *wth)
+{
+       return &wth->pseudo_header;
+}
 
-       case WTAP_FILE_TOSHIBA:
-               return toshiba_seek_read(fh, seek_off, pd, len);
+guint8*
+wtap_buf_ptr(wtap *wth)
+{
+       return buffer_start_ptr(wth->frame_buffer);
+}
 
-       default:
-               return wtap_def_seek_read(fh, seek_off, pd, len);
-       }
+gboolean
+wtap_seek_read(wtap *wth, long seek_off,
+       union wtap_pseudo_header *pseudo_header, guint8 *pd, int len,
+       int *err, gchar **err_info)
+{
+       return wth->subtype_seek_read(wth, seek_off, pseudo_header, pd, len,
+               err, err_info);
 }