aboutsummaryrefslogtreecommitdiffstats
path: root/cfile.h
blob: 2d2d37ed18cdae0e83bf2d7d8033e92b484a6a99 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
/* cfile.h
 * capture_file definition & GUI-independent manipulation
 *
 * Wireshark - Network traffic analyzer
 * By Gerald Combs <gerald@wireshark.org>
 * Copyright 1998 Gerald Combs
 *
 * SPDX-License-Identifier: GPL-2.0-or-later
 */

#ifndef __CFILE_H__
#define __CFILE_H__

#include <epan/epan.h>
#include <epan/column-info.h>
#include <epan/dfilter/dfilter.h>
#include <epan/frame_data.h>
#include <epan/frame_data_sequence.h>
#include <wiretap/wtap.h>

#ifdef __cplusplus
extern "C" {
#endif /* __cplusplus */

/* Current state of file. */
typedef enum {
  FILE_CLOSED,                  /* No file open */
  FILE_READ_IN_PROGRESS,        /* Reading a file we've opened */
  FILE_READ_ABORTED,            /* Read aborted by user */
  FILE_READ_DONE                /* Read completed */
} file_state;

/* Requested packets rescan action. */
typedef enum {
  RESCAN_NONE = 0,              /* No rescan requested */
  RESCAN_SCAN,                  /* Request rescan without full redissection. */
  RESCAN_REDISSECT              /* Request full redissection. */
} rescan_type;

/* Character set for text search. */
typedef enum {
  SCS_NARROW_AND_WIDE,
  SCS_NARROW,
  SCS_WIDE
  /* add EBCDIC when it's implemented */
} search_charset_t;

typedef enum {
  SD_FORWARD,
  SD_BACKWARD
} search_direction;

/*
 * Packet provider for programs using a capture file.
 */
struct packet_provider_data {
  wtap        *wth;                  /* Wiretap session */
  const frame_data *ref;
  frame_data  *prev_dis;
  frame_data  *prev_cap;
  frame_data_sequence *frames;       /* Sequence of frames, if we're keeping that information */
  GTree       *frames_user_comments; /* BST with user comments for frames (key = frame_data) */
};

typedef struct _capture_file {
  epan_t                     *epan;
  file_state                  state;                /* Current state of capture file */
  gchar                      *filename;             /* Name of capture file */
  gchar                      *source;               /* Temp file source, e.g. "Pipe from elsewhere" */
  gboolean                    is_tempfile;          /* Is capture file a temporary file? */
  gboolean                    unsaved_changes;      /* Does the capture file have changes that have not been saved? */
  gboolean                    stop_flag;            /* Stop current processing (loading, searching, etc.) */

  gint64                      f_datalen;            /* Size of capture file data (uncompressed) */
  guint16                     cd_t;                 /* File type of capture file */
  unsigned int                open_type;            /* open_routine index+1 used, if selected, or WTAP_TYPE_AUTO */
  wtap_compression_type       compression_type;     /* Compression type of the file, or uncompressed */
  int                         lnk_t;                /* File link-layer type; could be WTAP_ENCAP_PER_PACKET */
  GArray                     *linktypes;            /* Array of packet link-layer types */
  guint32                     count;                /* Total number of frames */
  guint64                     packet_comment_count; /* Number of comments in frames (could be >1 per frame... */
  guint32                     displayed_count;      /* Number of displayed frames */
  guint32                     marked_count;         /* Number of marked frames */
  guint32                     ignored_count;        /* Number of ignored frames */
  guint32                     ref_time_count;       /* Number of time referenced frames */
  gboolean                    drops_known;          /* TRUE if we know how many packets were dropped */
  guint32                     drops;                /* Dropped packets */
  nstime_t                    elapsed_time;         /* Elapsed time */
  int                         snap;                 /* Maximum captured packet length; 0 if unknown */
  dfilter_t                  *rfcode;               /* Compiled read filter program */
  dfilter_t                  *dfcode;               /* Compiled display filter program */
  gchar                      *dfilter;              /* Display filter string */
  gboolean                    redissecting;         /* TRUE if currently redissecting (cf_redissect_packets) */
  gboolean                    read_lock;            /* TRUE if currently processing a file (cf_read) */
  rescan_type                 redissection_queued;  /* Queued redissection type. */
  /* search */
  gchar                      *sfilter;              /* Filter, hex value, or string being searched */
  gboolean                    hex;                  /* TRUE if "Hex value" search was last selected */
  gboolean                    string;               /* TRUE if "String" search was last selected */
  gboolean                    summary_data;         /* TRUE if "String" search in "Packet list" (Info column) was last selected */
  gboolean                    decode_data;          /* TRUE if "String" search in "Packet details" was last selected */
  gboolean                    packet_data;          /* TRUE if "String" search in "Packet data" was last selected */
  guint32                     search_pos;           /* Byte position of last byte found in a hex search */
  guint32                     search_len;           /* Length of bytes matching the search */
  gboolean                    case_type;            /* TRUE if case-insensitive text search */
  GRegex                     *regex;                /* Set if regular expression search */
  search_charset_t            scs_type;             /* Character set for text search */
  search_direction            dir;                  /* Direction in which to do searches */
  gboolean                    search_in_progress;   /* TRUE if user just clicked OK in the Find dialog or hit <control>N/B */
  /* packet provider */
  struct packet_provider_data provider;
  /* frames */
  guint32                     first_displayed;      /* Frame number of first frame displayed */
  guint32                     last_displayed;       /* Frame number of last frame displayed */
  /* Data for currently selected frame */
  column_info                 cinfo;                /* Column formatting information */
  frame_data                 *current_frame;        /* Frame data */
  gint                        current_row;          /* Row number */
  epan_dissect_t             *edt;                  /* Protocol dissection */
  field_info                 *finfo_selected;       /* Field info */
  wtap_rec                    rec;                  /* Record header */
  Buffer                      buf;                  /* Record data */

  gpointer                    window;               /* Top-level window associated with file */
  gulong                      computed_elapsed;     /* Elapsed time to load the file (in msec). */

  guint32                     cum_bytes;
} capture_file;

extern void cap_file_init(capture_file *cf);

const char *cap_file_provider_get_interface_name(struct packet_provider_data *prov, guint32 interface_id);
const char *cap_file_provider_get_interface_description(struct packet_provider_data *prov, guint32 interface_id);
const char *cap_file_provider_get_user_comment(struct packet_provider_data *prov, const frame_data *fd);
void cap_file_provider_set_user_comment(struct packet_provider_data *prov, frame_data *fd, const char *new_comment);

#ifdef __cplusplus
}
#endif /* __cplusplus */

#endif /* cfile.h */

/*
 * Editor modelines  -  https://www.wireshark.org/tools/modelines.html
 *
 * Local Variables:
 * c-basic-offset: 2
 * tab-width: 8
 * indent-tabs-mode: nil
 * End:
 *
 * vi: set shiftwidth=2 tabstop=8 expandtab:
 * :indentSize=2:tabSize=8:noTabs=true:
 */