📄 group__wpcapsamps.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"><html><head><meta http-equiv="Content-Type" content="text/html;charset=UTF-8"><title>WinPcap: Using WinPcap in your programs</title><link href="style.css" rel="stylesheet" type="text/css"><link href="tabs.css" rel="stylesheet" type="text/css"></head><body><!-- Generated by Doxygen 1.5.6 --><div class="navigation" id="top"> <div class="tabs"> <ul> <li><a href="main.html"><span>Main Page</span></a></li> <li><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="modules.html"><span>Modules</span></a></li> <li><a href="annotated.html"><span>Data Structures</span></a></li> <li><a href="files.html"><span>Files</span></a></li> </ul> </div></div><div class="contents"><h1>Using WinPcap in your programs<br><small>[<a class="el" href="group__wpcap.html">WinPcap user's manual</a>]</small></h1><table border="0" cellpadding="0" cellspacing="0"><tr><td></td></tr></table><html><head><meta http-equiv="Content-Type" content="text/html; charset=windows-1252"><meta name="GENERATOR" content="Microsoft FrontPage 6.0"><meta name="ProgId" content="FrontPage.Editor.Document"><title></title></head><body><h2>Creating an application that uses <i>wpcap.dll</i></h2><p>To create an application that uses <i>wpcap.dll</i> with Microsoft Visual C++, follow thesesteps:</p><ul> <li>Include the file <i>pcap.h</i> at the beginning of every source file that uses the functions exported by library.</li> <li>If your program uses Win32 specific functions of WinPcap, remember to include <i>WPCAP</i> among the preprocessor definitions.</li> <li>If your program uses the remote capture capabilities of WinPcap, add <i> HAVE_REMOTE</i> among the preprocessor definitions. Do <i>not</i> include remote-ext.h directly in your source files.<li>Set the options of the linker to include the <i>wpcap.lib</i> library file specific for your target (x86 or x64). <i>wpcap.lib</i> for x86 can be found in the \lib folder of the WinPcap developer's pack, <i>wpcap.lib</i> for x64 can be found in the \lib\x64 folder.<li>Set the options of the linker to include the winsock library file<i> ws2_32.lib</i>. This file is distributed with the C compiler and contains the socket functions for Windows. It is needed by some functions used by the samples in the tutorial.</li></ul><p><b>How to properly set Microsoft Visual Studio<br><br></b><i>Visual Studio 6</i></p><ul> <li>To add a preprocessor definition, you must select <em>Settings</em> from the <em>Project</em> menu, then select <em>C/C++</em> from the tab control, and under the category <i>General</i>, you must add the definition under the Preprocessor Definitions text box. <li>To add a new library to the project with Microsoft Visual C++, you must select <em>Settings</em> from the <em>Project</em> menu, then select <em>Link</em> from the tab control, and then add the name of the new library in the <em>Object/library modules</em> editbox. <li>To add a new path where Microsoft Visual C++ will look for the libraries, you must select <em>Options</em> from the <em>Tools</em> menu, then <em> Directories</em> from the tab control, <em>Library files</em> from the <em>Show directories for</em> combobox, and the add the path in the <em>Directories</em> box. <li>To add a new path where Microsoft Visual C++ will look for include files, you must select <em>Options</em> from the <em>Tools</em> menu, then <em>Directories</em> from the tab control, <em>Include files</em> from the <em>Show directories for</em> combobox, and the add the path in the <em>Directories</em> box.</li></ul><p><i>Visual Studio 2005 (needed to compile x64 applications)</i></p><ul> <li>To add a preprocessor definition, you must select <em>Properties</em> from the <em>Project</em> menu, then select <em>C/C++</em> from the list control on the left, and under the category <i>Preprocessor</i>, you must add the definition under the <i>Preprocessor Definitions</i> text box. <li>To add a new library to the project, you must select <em>Properties</em> from the <em>Project</em> menu, then select <em>Linker</em> from the list control on the left, and under the category <i>Input</i> add the name of the new library in the <em>Additional Dependencies</em> text box.<li>To add a new path where Microsoft Visual Studio will look for the libraries, you must select <em>Options</em> from the <em>Tools</em> menu, then <em> Project and Solutions</em> from the list control on the left, <em>VC++ Directories</em>, then choose <i>Library</i> <i>Files</i> in the <em>Show directories for</em> combobox, and the add the path in the box below. <li>To add a new path where Microsoft Visual Studio will look for the include files, you must select <em>Options</em> from the <em>Tools</em> menu, then <em> Project and Solutions</em> from the list control on the left, <em>VC++ Directories</em>, then choose <i>Include</i> <i>Files</i> in the <em>Show directories for</em> combobox, and the add the path in the box below. </ul><p> </p><h2>Sample programs</h2><p>A couple of sample programs are provided to show the usage of the WinPcap API. Thesource of the examples, along with all the files needed to compile and run them, can be found in the <a href="http://www.winpcap.org/install/bin">Developer'sPack</a>. For didactic purpose we provide here a browsable version of the code: it is possible to click on the variables and functions to jump the documentation of each of them. For a more complete set of samples, try <a href="group__wpcap__tut.htm">WinPcapTutorial Section</a>.</p></body></html><p><html><head><meta http-equiv="Content-Type" content="text/html; charset=windows-1252"><meta name="GENERATOR" content="Microsoft FrontPage 6.0"><meta name="ProgId" content="FrontPage.Editor.Document"><title></title></head><body><h3>Packet Dump</h3><p>This program reads packets from a file or a network adapter, depending ona command line switch. If a source is not provided, the program shows a list ofavailable adapters, one of which can be selected. Once thecapture is started, the program prints the timestamp, the length and the rawcontents of the packets. Once compiled, it will run on all the Win32 platforms. Itcan be compiled to run on Unix as well (the makefile is provided).</p></body></html> <div class="fragment"><pre class="fragment"><span class="comment">/*</span><span class="comment"> * Copyright (c) 1999 - 2005 NetGroup, Politecnico di Torino (Italy)</span><span class="comment"> * Copyright (c) 2005 - 2006 CACE Technologies, Davis (California)</span><span class="comment"> * All rights reserved.</span><span class="comment"> *</span><span class="comment"> * Redistribution and use in source and binary forms, with or without</span><span class="comment"> * modification, are permitted provided that the following conditions</span><span class="comment"> * are met:</span><span class="comment"> *</span><span class="comment"> * 1. Redistributions of source code must retain the above copyright</span><span class="comment"> * notice, this list of conditions and the following disclaimer.</span><span class="comment"> * 2. Redistributions in binary form must reproduce the above copyright</span><span class="comment"> * notice, this list of conditions and the following disclaimer in the</span><span class="comment"> * documentation and/or other materials provided with the distribution.</span><span class="comment"> * 3. Neither the name of the Politecnico di Torino, CACE Technologies </span><span class="comment"> * nor the names of its contributors may be used to endorse or promote </span><span class="comment"> * products derived from this software without specific prior written </span><span class="comment"> * permission.</span><span class="comment"> *</span><span class="comment"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS</span><span class="comment"> * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT</span><span class="comment"> * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR</span><span class="comment"> * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT</span><span class="comment"> * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,</span><span class="comment"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT</span><span class="comment"> * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,</span><span class="comment"> * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY</span><span class="comment"> * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT</span><span class="comment"> * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE</span><span class="comment"> * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</span><span class="comment"> *</span><span class="comment"> */</span><span class="preprocessor">#include <stdlib.h></span><span class="preprocessor">#include <stdio.h></span><span class="comment">//</span><span class="comment">// NOTE: remember to include WPCAP and HAVE_REMOTE among your</span><span class="comment">// preprocessor definitions.</span><span class="comment">//</span><span class="preprocessor">#include <pcap.h></span><span class="preprocessor">#define LINE_LEN 16</span><span class="preprocessor"></span><span class="keywordtype">int</span> main(<span class="keywordtype">int</span> argc, <span class="keywordtype">char</span> **argv){ <a class="code" href="structpcap__if.html" title="Item in a list of interfaces, used by pcap_findalldevs().">pcap_if_t</a> *alldevs, *d;<a class="code" href="group__wpcap__def.html#g4711d025f83503ce692efa5e45ec60a7" title="Descriptor of an open capture instance. This structure is opaque to the user, that...">pcap_t</a> *fp;u_int inum, i=0;<span class="keywordtype">char</span> errbuf[<a class="code" href="group__wpcap__def.html#gcd448353957d92c98fccc29e1fc8d927" title="Size to use when allocating the buffer that contains the libpcap errors.">PCAP_ERRBUF_SIZE</a>];<span class="keywordtype">int</span> res;<span class="keyword">struct </span><a class="code" href="structpcap__pkthdr.html" title="Header of a packet in the dump file.">pcap_pkthdr</a> *header;<span class="keyword">const</span> u_char *pkt_data; printf(<span class="stringliteral">"pktdump_ex: prints the packets of the network using WinPcap.\n"</span>); printf(<span class="stringliteral">" Usage: pktdump_ex [-s source]\n\n"</span> <span class="stringliteral">" Examples:\n"</span> <span class="stringliteral">" pktdump_ex -s file://c:/temp/file.acp\n"</span> <span class="stringliteral">" pktdump_ex -s rpcap://\\Device\\NPF_{C8736017-F3C3-4373-94AC-9A34B7DAD998}\n\n"</span>); <span class="keywordflow">if</span>(argc < 3) { printf(<span class="stringliteral">"\nNo adapter selected: printing the device list:\n"</span>); <span class="comment">/* The user didn't provide a packet source: Retrieve the local device list */</span> <span class="keywordflow">if</span> (<a class="code" href="group__wpcapfunc.html#g98f36e62c95c6ad81eaa8b2bbeb8f16e" title="Create a list of network devices that can be opened with pcap_open().">pcap_findalldevs_ex</a>(<a class="code" href="group__remote__source__string.html#g6d7103b8a7e1eca8c325bd8f32c361c3" title="String that will be used to determine the type of source in use (file, remote/local...">PCAP_SRC_IF_STRING</a>, NULL, &alldevs, errbuf) == -1) { fprintf(stderr,<span class="stringliteral">"Error in pcap_findalldevs_ex: %s\n"</span>, errbuf); <span class="keywordflow">return</span> -1; } <span class="comment">/* Print the list */</span> <span class="keywordflow">for</span>(d=alldevs; d; d=d-><a class="code" href="structpcap__if.html#81508e6e4e41ca4235c8d6b51913c536" title="if not NULL, a pointer to the next element in the list; NULL for the last element...">next</a>) { printf(<span class="stringliteral">"%d. %s\n "</span>, ++i, d-><a class="code" href="structpcap__if.html#5ac083a645d964373f022d03df4849c8" title="a pointer to a string giving a name for the device to pass to pcap_open_live()">name</a>); <span class="keywordflow">if</span> (d-><a class="code" href="structpcap__if.html#8444d6e0dfe2bbab0b5e7b24308f1559" title="if not NULL, a pointer to a string giving a human-readable description of the device...">description</a>) printf(<span class="stringliteral">" (%s)\n"</span>, d-><a class="code" href="structpcap__if.html#8444d6e0dfe2bbab0b5e7b24308f1559" title="if not NULL, a pointer to a string giving a human-readable description of the device...">description</a>); <span class="keywordflow">else</span> printf(<span class="stringliteral">" (No description available)\n"</span>); } <span class="keywordflow">if</span> (i==0) { fprintf(stderr,<span class="stringliteral">"No interfaces found! Exiting.\n"</span>); <span class="keywordflow">return</span> -1; } printf(<span class="stringliteral">"Enter the interface number (1-%d):"</span>,i); scanf_s(<span class="stringliteral">"%d"</span>, &inum); <span class="keywordflow">if</span> (inum < 1 || inum > i) { printf(<span class="stringliteral">"\nInterface number out of range.\n"</span>); <span class="comment">/* Free the device list */</span> <a class="code" href="group__wpcapfunc.html#g346b4b0b7fd1cda4abb9a39f767dbeb1" title="Free an interface list returned by pcap_findalldevs().">pcap_freealldevs</a>(alldevs); <span class="keywordflow">return</span> -1; } <span class="comment">/* Jump to the selected adapter */</span> <span class="keywordflow">for</span> (d=alldevs, i=0; i< inum-1 ;d=d-><a class="code" href="structpcap__if.html#81508e6e4e41ca4235c8d6b51913c536" title="if not NULL, a pointer to the next element in the list; NULL for the last element...">next</a>, i++); <span class="comment">/* Open the device */</span> <span class="keywordflow">if</span> ( (fp= <a class="code" href="group__wpcapfunc.html#g2b64c7b6490090d1d37088794f1f1791" title="Open a generic source in order to capture / send (WinPcap only) traffic.">pcap_open</a>(d-><a class="code" href="structpcap__if.html#5ac083a645d964373f022d03df4849c8" title="a pointer to a string giving a name for the device to pass to pcap_open_live()">name</a>, 100 <span class="comment">/*snaplen*/</span>, <a class="code" href="group__remote__open__flags.html#g9134ce51a9a6a7d497c3dee5affdc3b9" title="Defines if the adapter has to go in promiscuous mode.">PCAP_OPENFLAG_PROMISCUOUS</a> <span class="comment">/*flags*/</span>, 20 <span class="comment">/*read timeout*/</span>, NULL <span class="comment">/* remote authentication */</span>, errbuf) ) == NULL) { fprintf(stderr,<span class="stringliteral">"\nError opening adapter\n"</span>); <span class="keywordflow">return</span> -1; } } <span class="keywordflow">else</span> ⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -