don't crash if packet.dll is not available, add some more packet.dll version numbers
[obnox/wireshark/wip.git] / capture_wpcap_packet.c
1 /* capture_wpcap_packet.c
2  * WinPcap-specific interfaces for low-level information (packet.dll).  
3  * We load WinPcap at run
4  * time, so that we only need one Ethereal binary and one Tethereal binary
5  * for Windows, regardless of whether WinPcap is installed or not.
6  *
7  * $Id$
8  *
9  * Ethereal - Network traffic analyzer
10  * By Gerald Combs <gerald@ethereal.com>
11  * Copyright 2001 Gerald Combs
12  *
13  * This program is free software; you can redistribute it and/or
14  * modify it under the terms of the GNU General Public License
15  * as published by the Free Software Foundation; either version 2
16  * of the License, or (at your option) any later version.
17  *
18  * This program is distributed in the hope that it will be useful,
19  * but WITHOUT ANY WARRANTY; without even the implied warranty of
20  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
21  * GNU General Public License for more details.
22  *
23  * You should have received a copy of the GNU General Public License
24  * along with this program; if not, write to the Free Software
25  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
26  */
27
28 #ifdef HAVE_CONFIG_H
29 # include "config.h"
30 #endif
31
32 #if defined HAVE_LIBPCAP && defined _WIN32
33
34 #include <glib.h>
35 #include <gmodule.h>
36
37 /* XXX - yes, I know, I should move cppmagic.h to a generic location. */
38 #include "tools/lemon/cppmagic.h"
39
40 #include <epan/value_string.h>
41
42 #include <Packet32.h>
43 #include <windows.h>
44 #include <windowsx.h>
45 #include <Ntddndis.h>
46
47 #include "capture_wpcap_packet.h"
48
49 gboolean has_wpacket = FALSE;
50
51
52 /* This module will use the PacketRequest function in packet.dll (coming with WinPcap) to "directly" access 
53  * the Win32 NDIS network driver(s) and ask for various values (status, statistics, ...).
54  *
55  * Unfortunately, the definitions required for this are not available through the usual windows header files, 
56  * but require the Windows "Device Driver Kit" which is not available for free :-( 
57  *
58  * Fortunately, the definitions needed to access the various NDIS values are available from various OSS projects:
59  * - WinPcap in Ntddndis.h
60  * - Ndiswrapper in driver/ndis.h and driver/iw_ndis.h
61  * - cygwin (MingW?) in usr/include/w32api/ddk/ndis.h and ntddndis.h
62  * - FreeBSD (netperf)
63  */
64
65 /* The MSDN description of the NDIS driver API is available at:
66 /* MSDN Home >  MSDN Library >  Win32 and COM Development >  Driver Development Kit >  Network Devices and Protocols >  Reference */
67 /* "NDIS Objects" */
68 /* http://msdn.microsoft.com/library/default.asp?url=/library/en-us/network/hh/network/21oidovw_d55042e5-0b8a-4439-8ef2-be7331e98464.xml.asp */
69
70 /* Some more interesting links:
71  * http://sourceforge.net/projects/ndiswrapper/
72  * http://www.osronline.com/lists_archive/windbg/thread521.html
73  * http://cvs.sourceforge.net/viewcvs.py/mingw/w32api/include/ddk/ndis.h?view=markup
74  * http://cvs.sourceforge.net/viewcvs.py/mingw/w32api/include/ddk/ntddndis.h?view=markup
75  */
76
77
78
79 /******************************************************************************************************************************/
80 /* stuff to load WinPcap's packet.dll and the functions required from it */
81
82 static PCHAR     (*p_PacketGetVersion) (void);
83 static LPADAPTER (*p_PacketOpenAdapter) (char *adaptername);
84 static void      (*p_PacketCloseAdapter) (LPADAPTER);
85 static int       (*p_PacketRequest) (LPADAPTER, int, void *);
86
87 typedef struct {
88         const char      *name;
89         gpointer        *ptr;
90         gboolean        optional;
91 } symbol_table_t;
92
93 #define SYM(x, y)       { STRINGIFY(x) , (gpointer) &CONCAT(p_,x), y }
94
95 void
96 wpcap_packet_load(void)
97 {
98
99         /* These are the symbols I need or want from packet.dll */
100         static const symbol_table_t     symbols[] = {
101                 SYM(PacketGetVersion, FALSE),
102                 SYM(PacketOpenAdapter, FALSE),
103                 SYM(PacketCloseAdapter, FALSE),
104                 SYM(PacketRequest, FALSE),
105                 { NULL, NULL, FALSE }
106         };
107
108         GModule         *wh; /* wpcap handle */
109         const symbol_table_t    *sym;
110
111         wh = g_module_open("packet", 0);
112
113         if (!wh) {
114                 return;
115         }
116
117         sym = symbols;
118         while (sym->name) {
119                 if (!g_module_symbol(wh, sym->name, sym->ptr)) {
120                         if (sym->optional) {
121                                 /*
122                                  * We don't care if it's missing; we just
123                                  * don't use it.
124                                  */
125                                 *sym->ptr = NULL;
126                         } else {
127                                 /*
128                                  * We require this symbol.
129                                  */
130                                 return;
131                         }
132                 }
133                 sym++;
134         }
135
136         has_wpacket = TRUE;
137 }
138
139
140
141 /******************************************************************************************************************************/
142 /* functions to access the NDIS driver values */
143
144
145 /* get dll version */
146 char *
147 wpcap_packet_get_version(void)
148 {
149     if(!has_wpacket) {
150         return NULL;
151     }
152     return p_PacketGetVersion();
153 }
154
155
156 /* open the interface */
157 void *
158 wpcap_packet_open(char *if_name)
159 {
160     LPADAPTER   adapter;
161
162         g_assert(has_wpacket);
163     adapter = p_PacketOpenAdapter(if_name);
164
165     return adapter;
166 }
167
168
169 /* close the interface */
170 void
171 wpcap_packet_close(void *adapter)
172 {
173
174         g_assert(has_wpacket);
175     p_PacketCloseAdapter(adapter);
176 }
177
178
179 /* do a packet request call */
180 int 
181 wpcap_packet_request(void *adapter, ULONG Oid, int set, char *value, unsigned int *length)
182 {
183     BOOLEAN    Status;
184     ULONG      IoCtlBufferLength=(sizeof(PACKET_OID_DATA) + (*length) - 1);
185     PPACKET_OID_DATA  OidData;
186
187
188         g_assert(has_wpacket);
189
190     if(p_PacketRequest == NULL) {
191         g_warning("packet_request not available\n");
192         return 0;
193     }
194
195     OidData=GlobalAllocPtr(GMEM_MOVEABLE | GMEM_ZEROINIT,IoCtlBufferLength);
196     if (OidData == NULL) {
197         g_warning("packet_link_status failed\n");
198         return 0;
199     }
200
201     OidData->Oid = Oid;
202     OidData->Length = *length;
203
204     Status = p_PacketRequest(adapter, set, OidData);
205
206     if(Status) {
207         g_assert(OidData->Length <= *length);
208         memcpy(value, OidData->Data, OidData->Length);
209         *length = OidData->Length;
210     }
211
212     GlobalFreePtr (OidData);
213
214     if(Status) {
215         return 1;
216     } else {
217         return 0;
218     }
219 }
220
221
222 /* get an UINT value using the packet request call */
223 int
224 wpcap_packet_request_uint(void *adapter, ULONG Oid, UINT *value)
225 {
226     BOOLEAN     Status;
227     int         length = sizeof(UINT);
228
229
230     Status = wpcap_packet_request(adapter, Oid, FALSE /* !set */, (char *) value, &length);
231     if(Status) {
232         g_assert(length == sizeof(UINT));
233         return 1;
234     } else {
235         return 0;
236     }
237 }
238
239
240 /* get an ULONG value using the NDIS packet request call */
241 int
242 wpcap_packet_request_ulong(void *adapter, ULONG Oid, ULONG *value)
243 {
244     BOOLEAN     Status;
245     int         length = sizeof(ULONG);
246
247
248     Status = wpcap_packet_request(adapter, Oid, FALSE /* !set */, (char *) value, &length);
249     if(Status) {
250         g_assert(length == sizeof(ULONG));
251         return 1;
252     } else {
253         return 0;
254     }
255 }
256
257
258 #else /* HAVE_LIBPCAP && _WIN32 */
259
260 void
261 wpcap_packet_load(void)
262 {
263         return;
264 }
265
266 #endif /* HAVE_LIBPCAP */