Packet32.h

Go to the documentation of this file.

/*
 * Copyright (c) 1999 - 2005 NetGroup, Politecnico di Torino (Italy)
 * Copyright (c) 2005 - 2007 CACE Technologies, Davis (California)
 * All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 * notice, this list of conditions and the following disclaimer.
 * 2. Redistributions in binary form must reproduce the above copyright
 * notice, this list of conditions and the following disclaimer in the
 * documentation and/or other materials provided with the distribution.
 * 3. Neither the name of the Politecnico di Torino, CACE Technologies
 * nor the names of its contributors may be used to endorse or promote
 * products derived from this software without specific prior written
 * permission.
 *
 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
 * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
 * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
 * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
 * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
 * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
 * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
 * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
 * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 *
 */

#ifndef __PACKET32
#define __PACKET32

#include <winsock2.h>

#ifdef HAVE_AIRPCAP_API
#include <airpcap.h>
#else
#if !defined(AIRPCAP_HANDLE__EAE405F5_0171_9592_B3C2_C19EC426AD34__DEFINED_)
#define AIRPCAP_HANDLE__EAE405F5_0171_9592_B3C2_C19EC426AD34__DEFINED_
typedef struct _AirpcapHandle *PAirpcapHandle;
#endif /* AIRPCAP_HANDLE__EAE405F5_0171_9592_B3C2_C19EC426AD34__DEFINED_ */
#endif /* HAVE_AIRPCAP_API */

#ifdef HAVE_DAG_API
#include <dagc.h>
#endif /* HAVE_DAG_API */

// Working modes
#define PACKET_MODE_CAPT 0x0 
#define PACKET_MODE_STAT 0x1 
#define PACKET_MODE_MON 0x2 
#define PACKET_MODE_DUMP 0x10 
#define PACKET_MODE_STAT_DUMP MODE_DUMP | MODE_STAT 


#define Packet_ALIGNMENT sizeof(int)
#define Packet_WORDALIGN(x) (((x)+(Packet_ALIGNMENT-1))&~(Packet_ALIGNMENT-1))

#define NdisMediumNull  -1              
#define NdisMediumCHDLC -2              
#define NdisMediumPPPSerial     -3      
#define NdisMediumBare80211     -4      
#define NdisMediumRadio80211    -5      
#define NdisMediumPpi           -6      

// Loopback behaviour definitions
#define NPF_DISABLE_LOOPBACK    1       
#define NPF_ENABLE_LOOPBACK             2       


typedef struct NetType
{
        UINT LinkType;  
        ULONGLONG LinkSpeed;    
}NetType;


//some definitions stolen from libpcap

#ifndef BPF_MAJOR_VERSION

struct bpf_program
{
        UINT bf_len;                            
        struct bpf_insn *bf_insns;      
};

struct bpf_insn
{
        USHORT  code;           
        UCHAR   jt;                     
        UCHAR   jf;                     
        int k;                          
};

struct bpf_stat
{
        UINT bs_recv;           
        UINT bs_drop;           
        UINT ps_ifdrop;         
        UINT bs_capt;           
};

struct bpf_hdr
{
        struct timeval  bh_tstamp;      
        UINT    bh_caplen;                      
        UINT    bh_datalen;                     
        USHORT          bh_hdrlen;              
};

struct dump_bpf_hdr{
    struct timeval      ts;                     
    UINT                        caplen;         
    UINT                        len;            
};


#endif

struct bpf_stat;

#define        DOSNAMEPREFIX   TEXT("Packet_")  
#define        MAX_LINK_NAME_LENGTH     64                      //< Maximum length of the devices symbolic links
#define        NMAX_PACKET 65535

typedef struct npf_if_addr {
        struct sockaddr_storage IPAddress;      
        struct sockaddr_storage SubnetMask;     
        struct sockaddr_storage Broadcast;      
}npf_if_addr;


#define ADAPTER_NAME_LENGTH 256 + 12    
#define ADAPTER_DESC_LENGTH 128                 
#define MAX_MAC_ADDR_LENGTH 8                   
#define MAX_NETWORK_ADDRESSES 16                


typedef struct WAN_ADAPTER_INT WAN_ADAPTER; 
typedef WAN_ADAPTER *PWAN_ADAPTER; 

#define INFO_FLAG_NDIS_ADAPTER          0       
#define INFO_FLAG_NDISWAN_ADAPTER       1       
#define INFO_FLAG_DAG_CARD                      2       
#define INFO_FLAG_DAG_FILE                      6       
#define INFO_FLAG_DONT_EXPORT           8       
#define INFO_FLAG_AIRPCAP_CARD          16      
#define INFO_FLAG_NPFIM_DEVICE          32

typedef struct _ADAPTER  {
        HANDLE hFile;                           
        CHAR  SymbolicLink[MAX_LINK_NAME_LENGTH]; 
        int NumWrites;                          
        HANDLE ReadEvent;                       

        UINT ReadTimeOut;                       
        CHAR Name[ADAPTER_NAME_LENGTH];
        PWAN_ADAPTER pWanAdapter;
        UINT Flags;                                     

#ifdef HAVE_AIRPCAP_API
        PAirpcapHandle  AirpcapAd;
#endif // HAVE_AIRPCAP_API

#ifdef HAVE_NPFIM_API
        void* NpfImHandle;
#endif // HAVE_NPFIM_API

#ifdef HAVE_DAG_API
        dagc_t *pDagCard;                       
        PCHAR DagBuffer;                        
        struct timeval DagReadTimeout;  
        unsigned DagFcsLen;                     
        DWORD DagFastProcess;           
#endif // HAVE_DAG_API
}  ADAPTER, *LPADAPTER;

typedef struct _PACKET {
        HANDLE       hEvent;            
        OVERLAPPED   OverLapped;        
        PVOID        Buffer;            
        UINT         Length;            
        DWORD        ulBytesReceived;   
        BOOLEAN      bIoComplete;       
}  PACKET, *LPPACKET;

struct _PACKET_OID_DATA {
    ULONG Oid;                                  
    ULONG Length;                               
    UCHAR Data[1];                              
};
typedef struct _PACKET_OID_DATA PACKET_OID_DATA, *PPACKET_OID_DATA;

#ifdef __cplusplus
extern "C" {
#endif

/*
BOOLEAN QueryWinPcapRegistryStringA(CHAR *SubKeyName,
                                                                 CHAR *Value,
                                                                 UINT *pValueLen,
                                                                 CHAR *DefaultVal);

BOOLEAN QueryWinPcapRegistryStringW(WCHAR *SubKeyName,
                                                                 WCHAR *Value,
                                                                 UINT *pValueLen,
                                                                 WCHAR *DefaultVal);
*/

//---------------------------------------------------------------------------
// EXPORTED FUNCTIONS
//---------------------------------------------------------------------------

PCHAR PacketGetVersion();
PCHAR PacketGetDriverVersion();
BOOLEAN PacketSetMinToCopy(LPADAPTER AdapterObject,int nbytes);
BOOLEAN PacketSetNumWrites(LPADAPTER AdapterObject,int nwrites);
BOOLEAN PacketSetMode(LPADAPTER AdapterObject,int mode);
BOOLEAN PacketSetReadTimeout(LPADAPTER AdapterObject,int timeout);
BOOLEAN PacketSetBpf(LPADAPTER AdapterObject,struct bpf_program *fp);
BOOLEAN PacketSetLoopbackBehavior(LPADAPTER  AdapterObject, UINT LoopbackBehavior);
INT PacketSetSnapLen(LPADAPTER AdapterObject,int snaplen);
BOOLEAN PacketGetStats(LPADAPTER AdapterObject,struct bpf_stat *s);
BOOLEAN PacketGetStatsEx(LPADAPTER AdapterObject,struct bpf_stat *s);
BOOLEAN PacketSetBuff(LPADAPTER AdapterObject,int dim);
BOOLEAN PacketGetNetType (LPADAPTER AdapterObject,NetType *type);
LPADAPTER PacketOpenAdapter(PCHAR AdapterName);
BOOLEAN PacketSendPacket(LPADAPTER AdapterObject,LPPACKET pPacket,BOOLEAN Sync);
INT PacketSendPackets(LPADAPTER AdapterObject,PVOID PacketBuff,ULONG Size, BOOLEAN Sync);
LPPACKET PacketAllocatePacket(void);
VOID PacketInitPacket(LPPACKET lpPacket,PVOID  Buffer,UINT  Length);
VOID PacketFreePacket(LPPACKET lpPacket);
BOOLEAN PacketReceivePacket(LPADAPTER AdapterObject,LPPACKET lpPacket,BOOLEAN Sync);
BOOLEAN PacketSetHwFilter(LPADAPTER AdapterObject,ULONG Filter);
BOOLEAN PacketGetAdapterNames(PTSTR pStr,PULONG  BufferSize);
BOOLEAN PacketGetNetInfoEx(PCHAR AdapterName, npf_if_addr* buffer, PLONG NEntries);
BOOLEAN PacketRequest(LPADAPTER  AdapterObject,BOOLEAN Set,PPACKET_OID_DATA  OidData);
HANDLE PacketGetReadEvent(LPADAPTER AdapterObject);
BOOLEAN PacketSetDumpName(LPADAPTER AdapterObject, void *name, int len);
BOOLEAN PacketSetDumpLimits(LPADAPTER AdapterObject, UINT maxfilesize, UINT maxnpacks);
BOOLEAN PacketIsDumpEnded(LPADAPTER AdapterObject, BOOLEAN sync);
BOOL PacketStopDriver();
VOID PacketCloseAdapter(LPADAPTER lpAdapter);
BOOLEAN PacketStartOem(PCHAR errorString, UINT errorStringLength);
BOOLEAN PacketStartOemEx(PCHAR errorString, UINT errorStringLength, ULONG flags);
PAirpcapHandle PacketGetAirPcapHandle(LPADAPTER AdapterObject);

//
// Used by PacketStartOemEx
//
#define PACKET_START_OEM_NO_NETMON      0x00000001

#ifdef __cplusplus
}
#endif

#endif //__PACKET32