libDwm-0.6.0
DwmPcap.hh
Go to the documentation of this file.
1 //===========================================================================
2 // @(#) $DwmPath: dwm/libDwm/tags/libDwm-0.6.0/include/DwmPcap.hh 8401 $
3 // @(#) $Id: DwmPcap.hh 8401 2016-04-17 06:44:31Z dwm $
4 //===========================================================================
5 // Copyright (c) Daniel W. McRobb 2005-2007, 2016
6 // All rights reserved.
7 //
8 // Redistribution and use in source and binary forms, with or without
9 // modification, are permitted provided that the following conditions
10 // are met:
11 //
12 // 1. Redistributions of source code must retain the above copyright
13 // notice, this list of conditions and the following disclaimer.
14 // 2. Redistributions in binary form must reproduce the above copyright
15 // notice, this list of conditions and the following disclaimer in the
16 // documentation and/or other materials provided with the distribution.
17 // 3. The names of the authors and copyright holders may not be used to
18 // endorse or promote products derived from this software without
19 // specific prior written permission.
20 //
21 // IN NO EVENT SHALL DANIEL W. MCROBB BE LIABLE TO ANY PARTY FOR
22 // DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES,
23 // INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE,
24 // EVEN IF DANIEL W. MCROBB HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
25 // DAMAGE.
26 //
27 // THE SOFTWARE PROVIDED HEREIN IS ON AN "AS IS" BASIS, AND
28 // DANIEL W. MCROBB HAS NO OBLIGATION TO PROVIDE MAINTENANCE, SUPPORT,
29 // UPDATES, ENHANCEMENTS, OR MODIFICATIONS. DANIEL W. MCROBB MAKES NO
30 // REPRESENTATIONS AND EXTENDS NO WARRANTIES OF ANY KIND, EITHER
31 // IMPLIED OR EXPRESS, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
32 // WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE,
33 // OR THAT THE USE OF THIS SOFTWARE WILL NOT INFRINGE ANY PATENT,
34 // TRADEMARK OR OTHER RIGHTS.
35 //===========================================================================
36 
37 //---------------------------------------------------------------------------
40 //---------------------------------------------------------------------------
41 
42 #ifndef _DWMPCAP_HH_
43 #define _DWMPCAP_HH_
44 
45 extern "C" {
46  #include <pcap.h>
47 }
48 
49 #include <map>
50 #include <string>
51 
52 namespace Dwm {
53 
54  //--------------------------------------------------------------------------
56  //--------------------------------------------------------------------------
57  class Pcap
58  {
59  public:
60  //------------------------------------------------------------------------
62  //------------------------------------------------------------------------
63  Pcap();
64 
65  //------------------------------------------------------------------------
67  //------------------------------------------------------------------------
68  ~Pcap();
69 
70  //------------------------------------------------------------------------
76  //------------------------------------------------------------------------
77  bool OpenLive(const std::string & device, int snaplen,
78  bool promisc, int timeout_msecs);
79 
80  //------------------------------------------------------------------------
83  //------------------------------------------------------------------------
84  bool OpenOffline(const std::string & fname);
85 
86  //------------------------------------------------------------------------
90  //------------------------------------------------------------------------
91  bool SetFilter(const std::string & filter, bool optimize);
92 
93  //------------------------------------------------------------------------
95  //------------------------------------------------------------------------
96  int Dispatch(int count, pcap_handler callback, uint8_t *user);
97 
98  //------------------------------------------------------------------------
100  //------------------------------------------------------------------------
101  int Loop(int count, pcap_handler callback, uint8_t *user);
102 
103  //------------------------------------------------------------------------
106  //------------------------------------------------------------------------
107  bool Close();
108 
109  //------------------------------------------------------------------------
112  //------------------------------------------------------------------------
113  const std::string & LastError() const;
114 
115  //------------------------------------------------------------------------
120  //------------------------------------------------------------------------
121  int DataLinkOffset() const;
122 
123  private:
124  static std::map<int,int> _dataLinkOffsets;
125 
126  pcap_t *_pcap;
127  std::string _errbuf;
128  };
129 
130 } // namespace Dwm
131 
132 #endif // _DWMPCAP_HH_
133 
134 //---------------------------- emacs settings -----------------------------
135 // Local Variables:
136 // mode: C++/la
137 // tab-width: 2
138 // indent-tabs-mode: nil
139 // c-basic-offset: 2
140 // End:
141 //-------------------------------------------------------------------------
int Loop(int count, pcap_handler callback, uint8_t *user)
A wrapper for pcap_loop(). See the pcap(3) manpage.
bool SetFilter(const std::string &filter, bool optimize)
Sets the filter for the capture device.
const std::string & LastError() const
Returns the last error string from a failed OpenLive() or OpenOffline() call.
bool Close()
Closes the capture device.
Definition: DwmBZ2IO.hh:67
Pcap()
Constructor.
~Pcap()
Destructor. Will close the contained pcap device if it&#39;s open.
int DataLinkOffset() const
Returns the length of the link layer header for the capture device.
bool OpenOffline(const std::string &fname)
Opens the file fname for reading.
int Dispatch(int count, pcap_handler callback, uint8_t *user)
A wrapper for pcap_dispatch(). See the pcap(3) manpage.
bool OpenLive(const std::string &device, int snaplen, bool promisc, int timeout_msecs)
Open device for live packet capture.
This is a pcap wrapper/utility class.
Definition: DwmPcap.hh:57