]> The Tcpdump Group git mirrors - libpcap/blob - pcap-int.h
Add a "read" function pointer to the pcap_t structure, which handles
[libpcap] / pcap-int.h
1 /*
2 * Copyright (c) 1994, 1995, 1996
3 * The Regents of the University of California. All rights reserved.
4 *
5 * Redistribution and use in source and binary forms, with or without
6 * modification, are permitted provided that the following conditions
7 * are met:
8 * 1. Redistributions of source code must retain the above copyright
9 * notice, this list of conditions and the following disclaimer.
10 * 2. Redistributions in binary form must reproduce the above copyright
11 * notice, this list of conditions and the following disclaimer in the
12 * documentation and/or other materials provided with the distribution.
13 * 3. All advertising materials mentioning features or use of this software
14 * must display the following acknowledgement:
15 * This product includes software developed by the Computer Systems
16 * Engineering Group at Lawrence Berkeley Laboratory.
17 * 4. Neither the name of the University nor of the Laboratory may be used
18 * to endorse or promote products derived from this software without
19 * specific prior written permission.
20 *
21 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
22 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
23 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
24 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
25 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
26 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
27 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
28 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
29 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
30 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
31 * SUCH DAMAGE.
32 *
33 * @(#) $Header: /tcpdump/master/libpcap/pcap-int.h,v 1.52 2003-07-25 05:32:03 guy Exp $ (LBL)
34 */
35
36 #ifndef pcap_int_h
37 #define pcap_int_h
38
39 #ifdef __cplusplus
40 extern "C" {
41 #endif
42
43 #include <pcap.h>
44
45 #ifdef WIN32
46 #include <packet32.h>
47 #endif /* WIN32 */
48
49 /*
50 * Savefile
51 */
52 struct pcap_sf {
53 FILE *rfile;
54 int swapped;
55 int hdrsize;
56 int version_major;
57 int version_minor;
58 u_char *base;
59 };
60
61 struct pcap_md {
62 struct pcap_stat stat;
63 /*XXX*/
64 int use_bpf; /* using kernel filter */
65 u_long TotPkts; /* can't oflow for 79 hrs on ether */
66 u_long TotAccepted; /* count accepted by filter */
67 u_long TotDrops; /* count of dropped packets */
68 long TotMissed; /* missed by i/f during this run */
69 long OrigMissed; /* missed by i/f before this run */
70 #ifdef linux
71 int sock_packet; /* using Linux 2.0 compatible interface */
72 int timeout; /* timeout specified to pcap_open_live */
73 int clear_promisc; /* must clear promiscuous mode when we close */
74 int cooked; /* using SOCK_DGRAM rather than SOCK_RAW */
75 int lo_ifindex; /* interface index of the loopback device */
76 char *device; /* device name */
77 struct pcap *next; /* list of open promiscuous sock_packet pcaps */
78 #endif
79
80 #ifdef HAVE_DAG_API
81 void *dag_mem_base; /* DAG card memory base address */
82 u_int dag_mem_bottom; /* DAG card current memory bottom pointer */
83 u_int dag_mem_top; /* DAG card current memory top pointer */
84 #endif
85 };
86
87 struct pcap {
88 #ifdef WIN32
89 ADAPTER *adapter;
90 LPPACKET Packet;
91 int timeout;
92 int nonblock;
93 #else
94 int fd;
95 #endif /* WIN32 */
96 int snapshot;
97 int linktype;
98 int tzoff; /* timezone offset */
99 int offset; /* offset for proper alignment */
100
101 struct pcap_sf sf;
102 struct pcap_md md;
103
104 /*
105 * Read buffer.
106 */
107 int bufsize;
108 u_char *buffer;
109 u_char *bp;
110 int cc;
111
112 /*
113 * Place holder for pcap_next().
114 */
115 u_char *pkt;
116
117 /*
118 * Methods.
119 */
120 int (*read_op)(pcap_t *, int cnt, pcap_handler, u_char *);
121 int (*setfilter_op)(pcap_t *, struct bpf_program *);
122 int (*set_datalink_op)(pcap_t *, int);
123 int (*stats_op)(pcap_t *, struct pcap_stat *);
124 void (*close_op)(pcap_t *);
125
126 /*
127 * Placeholder for filter code if bpf not in kernel.
128 */
129 struct bpf_program fcode;
130
131 char errbuf[PCAP_ERRBUF_SIZE + 1];
132 int dlt_count;
133 int *dlt_list;
134
135 struct pcap_pkthdr pcap_header; /* This is needed for the pcap_next_ex() to work */
136 };
137
138 /*
139 * This is a timeval as stored in disk in a dumpfile.
140 * It has to use the same types everywhere, independent of the actual
141 * `struct timeval'
142 */
143
144 struct pcap_timeval {
145 bpf_int32 tv_sec; /* seconds */
146 bpf_int32 tv_usec; /* microseconds */
147 };
148
149 /*
150 * How a `pcap_pkthdr' is actually stored in the dumpfile.
151 *
152 * Do not change the format of this structure, in any way (this includes
153 * changes that only affect the length of fields in this structure),
154 * and do not make the time stamp anything other than seconds and
155 * microseconds (e.g., seconds and nanoseconds). Instead:
156 *
157 * introduce a new structure for the new format;
158 *
159 * send mail to "tcpdump-workers@tcpdump.org", requesting a new
160 * magic number for your new capture file format, and, when
161 * you get the new magic number, put it in "savefile.c";
162 *
163 * use that magic number for save files with the changed record
164 * header;
165 *
166 * make the code in "savefile.c" capable of reading files with
167 * the old record header as well as files with the new record header
168 * (using the magic number to determine the header format).
169 *
170 * Then supply the changes to "patches@tcpdump.org", so that future
171 * versions of libpcap and programs that use it (such as tcpdump) will
172 * be able to read your new capture file format.
173 */
174
175 struct pcap_sf_pkthdr {
176 struct pcap_timeval ts; /* time stamp */
177 bpf_u_int32 caplen; /* length of portion present */
178 bpf_u_int32 len; /* length this packet (off wire) */
179 };
180
181 /*
182 * How a `pcap_pkthdr' is actually stored in dumpfiles written
183 * by some patched versions of libpcap (e.g. the ones in Red
184 * Hat Linux 6.1 and 6.2).
185 *
186 * Do not change the format of this structure, in any way (this includes
187 * changes that only affect the length of fields in this structure).
188 * Instead, introduce a new structure, as per the above.
189 */
190
191 struct pcap_sf_patched_pkthdr {
192 struct pcap_timeval ts; /* time stamp */
193 bpf_u_int32 caplen; /* length of portion present */
194 bpf_u_int32 len; /* length this packet (off wire) */
195 int index;
196 unsigned short protocol;
197 unsigned char pkt_type;
198 };
199
200 int yylex(void);
201
202 #ifndef min
203 #define min(a, b) ((a) > (b) ? (b) : (a))
204 #endif
205
206 /* XXX should these be in pcap.h? */
207 int pcap_offline_read(pcap_t *, int, pcap_handler, u_char *);
208 int pcap_read(pcap_t *, int cnt, pcap_handler, u_char *);
209
210
211 /*
212 * Ultrix, DEC OSF/1^H^H^H^H^H^H^H^H^HDigital UNIX^H^H^H^H^H^H^H^H^H^H^H^H
213 * Tru64 UNIX, and NetBSD pad to make everything line up on a nice boundary.
214 */
215 #if defined(ultrix) || defined(__osf__) || defined(__NetBSD__)
216 #define PCAP_FDDIPAD 3
217 #endif
218
219 #ifndef HAVE_STRLCPY
220 #define strlcpy(x, y, z) \
221 (strncpy((x), (y), (z)), \
222 ((z) <= 0 ? 0 : ((x)[(z) - 1] = '\0')), \
223 strlen((y)))
224 #endif
225
226 /*
227 * Internal interface for "pcap_set_datalink()". Attempts to set the
228 * link-layer type to the specified type; if that fails, returns -1.
229 * (On platforms that don't support setting it at all, this can just
230 * return 0 - on those platforms, "pcap_set_datalink()" has already
231 * checked whether the DLT_ value is the one the device supports.
232 */
233 int pcap_set_datalink_platform(pcap_t *, int);
234
235 /*
236 * Internal interfaces for "pcap_findalldevs()".
237 *
238 * "pcap_platform_finddevs()" is a platform-dependent routine to
239 * add devices not found by the "standard" mechanisms (SIOCGIFCONF,
240 * "getifaddrs()", etc..
241 *
242 * "pcap_add_if()" adds an interface to the list of interfaces.
243 */
244 int pcap_platform_finddevs(pcap_if_t **, char *);
245 int add_addr_to_iflist(pcap_if_t **, char *, u_int, struct sockaddr *,
246 size_t, struct sockaddr *, size_t, struct sockaddr *, size_t,
247 struct sockaddr *, size_t, char *);
248 int pcap_add_if(pcap_if_t **, char *, u_int, const char *, char *);
249 struct sockaddr *dup_sockaddr(struct sockaddr *, size_t);
250 int add_or_find_if(pcap_if_t **, pcap_if_t **, const char *, u_int,
251 const char *, char *);
252
253 #ifdef WIN32
254 char *pcap_win32strerror(void);
255 #endif
256
257 /* XXX */
258 extern int pcap_fddipad;
259
260 int install_bpf_program(pcap_t *, struct bpf_program *);
261
262 int pcap_strcasecmp(const char *, const char *);
263
264 #ifdef __cplusplus
265 }
266 #endif
267
268 #endif