file.h

   1 /* file.h
   2  * Definitions for file structures and routines
   3  *
   4  * $Id: file.h,v 1.90 2002/02/08 10:07:34 guy Exp $
   5  *
   6  * Ethereal - Network traffic analyzer
   7  * By Gerald Combs <gerald@ethereal.com>
   8  * Copyright 1998 Gerald Combs
   9  *
  10  * This program is free software; you can redistribute it and/or
  11  * modify it under the terms of the GNU General Public License
  12  * as published by the Free Software Foundation; either version 2
  13  * of the License, or (at your option) any later version.
  14  *
  15  * This program is distributed in the hope that it will be useful,
  16  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  * GNU General Public License for more details.
  19  *
  20  * You should have received a copy of the GNU General Public License
  21  * along with this program; if not, write to the Free Software
  22  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
  23  */
  24
  25 #ifndef __FILE_H__
  26 #define __FILE_H__
  27
  28 #ifdef HAVE_SYS_TYPES_H
  29 #include <sys/types.h>
  30 #endif
  31
  32 #include "wiretap/wtap.h"
  33 #include <epan/dfilter/dfilter.h>
  34 #include "print.h"
  35 #include <errno.h>
  36 #include <epan/epan.h>
  37
  38 /* Current state of file. */
  39 typedef enum {
  40         FILE_CLOSED,            /* No file open */
  41         FILE_READ_IN_PROGRESS,  /* Reading a file we've opened */
  42         FILE_READ_ABORTED,      /* Read aborted by user */
  43         FILE_READ_DONE          /* Read completed */
  44 } file_state;
  45
  46 typedef struct _capture_file {
  47   file_state   state;     /* Current state of capture file */
  48   int          filed;     /* File descriptor of capture file */
  49   gchar       *filename;  /* Name of capture file */
  50   gboolean     is_tempfile; /* Is capture file a temporary file? */
  51   gboolean     user_saved;/* If capture file is temporary, has it been saved by user yet? */
  52   long         f_len;     /* Length of capture file */
  53   guint16      cd_t;      /* File type of capture file */
  54   int          lnk_t;     /* Link-layer type with which to save capture */
  55   guint32      vers;      /* Version.  For tcpdump minor is appended to major */
  56   int          count;     /* Total number of frames */
  57   int          marked_count; /* Number of marked frames */
  58   gboolean     drops_known; /* TRUE if we know how many packets were dropped */
  59   guint32      drops;     /* Dropped packets */
  60   guint32      esec;      /* Elapsed seconds */
  61   guint32      eusec;     /* Elapsed microseconds */
  62   gboolean     has_snap;  /* TRUE if maximum capture packet length is known */
  63   int          snap;      /* Maximum captured packet length */
  64   long         progbar_quantum; /* Number of bytes read per progress bar update */
  65   long         progbar_nextstep; /* Next point at which to update progress bar */
  66   gchar       *iface;     /* Interface */
  67   gchar       *save_file; /* File that user saved capture to */
  68   int          save_file_fd; /* File descriptor for saved file */
  69   wtap        *wth;       /* Wiretap session */
  70   dfilter_t   *rfcode;    /* Compiled read filter program */
  71   gchar       *dfilter;   /* Display filter string */
  72   struct _colfilter   *colors;    /* Colors for colorizing packet window */
  73   dfilter_t   *dfcode;    /* Compiled display filter program */
  74 #ifdef HAVE_LIBPCAP
  75   gchar       *cfilter;   /* Capture filter string */
  76 #endif
  77   gchar       *sfilter;   /* Search filter string */
  78   gboolean     sbackward;  /* TRUE if search is backward, FALSE if forward */
  79   union wtap_pseudo_header pseudo_header;      /* Packet pseudo_header */
  80   guint8       pd[WTAP_MAX_PACKET_SIZE];  /* Packet data */
  81   GMemChunk   *plist_chunk; /* Memory chunk for frame_data structures */
  82   frame_data  *plist;     /* Packet list */
  83   frame_data  *plist_end; /* Last packet in list */
  84   frame_data  *first_displayed; /* First frame displayed */
  85   frame_data  *last_displayed;  /* Last frame displayed */
  86   column_info  cinfo;    /* Column formatting information */
  87   frame_data  *current_frame;  /* Frame data for current frame */
  88   epan_dissect_t *edt; /* Protocol dissection fo rcurrently selected packet */
  89   FILE        *print_fh;  /* File we're printing to */
  90 #ifdef HAVE_LIBPCAP
  91   gint32       autostop_filesize; /* Maximum capture file size */
  92   gint32       autostop_duration; /* Maximum capture duration */
  93   gboolean     ringbuffer_on; /* Ringbuffer option */
  94   guint32      ringbuffer_num_files; /* Number of ringbuffer files */
  95 #endif
  96 } capture_file;
  97
  98 /* Return values from "read_cap_file()", "continue_tail_cap_file()",
  99    and "finish_tail_cap_file()". */
 100 typedef enum {
 101         READ_SUCCESS,   /* read succeeded */
 102         READ_ERROR,     /* read got an error */
 103         READ_ABORTED    /* read aborted by user */
 104 } read_status_t;
 105
 106 int  open_cap_file(char *, gboolean, capture_file *);
 107 void close_cap_file(capture_file *);
 108 read_status_t read_cap_file(capture_file *, int *);
 109 int  start_tail_cap_file(char *, gboolean, capture_file *);
 110 read_status_t continue_tail_cap_file(capture_file *, int, int *);
 111 read_status_t finish_tail_cap_file(capture_file *, int *);
 112 /* size_t read_frame_header(capture_file *); */
 113 int  save_cap_file(char *, capture_file *, gboolean, gboolean, guint);
 114
 115 int filter_packets(capture_file *cf, gchar *dfilter);
 116 void colorize_packets(capture_file *);
 117 void redissect_packets(capture_file *cf);
 118 int print_packets(capture_file *cf, print_args_t *print_args);
 119 void change_time_formats(capture_file *);
 120 gboolean find_packet(capture_file *cf, dfilter_t *sfcode);
 121
 122 typedef enum {
 123   FOUND_FRAME,          /* found the frame */
 124   NO_SUCH_FRAME,        /* no frame with that number */
 125   FRAME_NOT_DISPLAYED   /* frame with that number isn't displayed */
 126 } goto_result_t;
 127 goto_result_t goto_frame(capture_file *cf, guint fnumber);
 128
 129 void select_packet(capture_file *, int);
 130 void unselect_packet(capture_file *);
 131
 132 void unselect_field(void);
 133
 134 /*
 135  * Mark a particular frame in a particular capture.
 136  */
 137 void mark_frame(capture_file *, frame_data *);
 138
 139 /*
 140  * Unmark a particular frame in a particular capture.
 141  */
 142 void unmark_frame(capture_file *, frame_data *);
 143
 144 /* Moves or copies a file. Returns 0 on failure, 1 on success */
 145 int file_mv(char *from, char *to);
 146
 147 /* Copies a file. Returns 0 on failure, 1 on success */
 148 int file_cp(char *from, char *to);
 149
 150 char *file_open_error_message(int, gboolean);
 151 char *file_read_error_message(int);
 152 char *file_write_error_message(int);
 153
 154 #endif /* file.h */