libnet  1.1
libnet-structures.h
1 /*
2  * $Id: libnet-structures.h,v 1.19 2004/11/09 07:05:07 mike Exp $
3  *
4  * libnet-structures.h - Network routine library structures header file
5  *
6  * Copyright (c) 1998 - 2004 Mike D. Schiffman <mike@infonexus.com>
7  * All rights reserved.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
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  *
18  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
19  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
22  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28  * SUCH DAMAGE.
29  *
30  */
31 
32 #ifndef __LIBNET_STRUCTURES_H
33 #define __LIBNET_STRUCTURES_H
34 
35 #if ((__WIN32__) && !(__CYGWIN__))
36 #include "Packet32.h"
37 #endif
38 
39 /* port list chain structure */
40 typedef struct libnet_port_list_chain libnet_plist_t;
41 struct libnet_port_list_chain
42 {
43  uint16_t node; /* node number */
44  uint16_t bport; /* beggining port */
45  uint16_t eport; /* terminating port */
46  uint8_t id; /* global array offset */
47  libnet_plist_t *next; /* next node in the list */
48 };
49 
50 
51 /* libnet statistics structure */
52 struct libnet_stats
53 {
54 #if (!defined(__WIN32__) || (__CYGWIN__))
55  uint64_t packets_sent; /* packets sent */
56  uint64_t packet_errors; /* packets errors */
57  uint64_t bytes_written; /* bytes written */
58 #else
59  __int64 packets_sent; /* packets sent */
60  __int64 packet_errors; /* packets errors */
61  __int64 bytes_written; /* bytes written */
62 #endif
63 };
64 
65 
66 /*
67  * Libnet ptags are how we identify specific protocol blocks inside the
68  * list.
69  */
70 typedef int32_t libnet_ptag_t;
71 #define LIBNET_PTAG_INITIALIZER 0
72 
73 
74 /*
75  * Libnet generic protocol block memory object. Sort of a poor man's mbuf.
76  */
77 struct libnet_protocol_block
78 {
79  uint8_t *buf; /* protocol buffer */
80  uint32_t b_len; /* length of buf */
81  uint16_t h_len; /* header length */
82  /* Passed as last argument to libnet_do_checksum(). Not necessarily used
83  * by that function, it is essentially a pblock specific number, passed
84  * from _builder to the _do_checksum
85  *
86  * Unused for IPV4_H block types.
87  *
88  * For protocols that sit on top of IP, it should be the the amount of
89  * buf that will be included in the checksum, starting from the beginning
90  * of the header.
91  */
92  uint32_t copied; /* bytes copied - the amount of data copied into buf */
93  /* Used and updated by libnet_pblock_append(). */
94  uint8_t type; /* type of pblock */
95 /* this needs to be updated every time a new packet builder is added */
96 /* libnet_diag_dump_pblock_type() also needs updating for every new pblock tag */
97 #define LIBNET_PBLOCK_ARP_H 0x01 /* ARP header */
98 #define LIBNET_PBLOCK_DHCPV4_H 0x02 /* DHCP v4 header */
99 #define LIBNET_PBLOCK_DNSV4_H 0x03 /* DNS v4 header */
100 #define LIBNET_PBLOCK_ETH_H 0x04 /* Ethernet header */
101 #define LIBNET_PBLOCK_ICMPV4_H 0x05 /* ICMP v4 base header */
102 #define LIBNET_PBLOCK_ICMPV4_ECHO_H 0x06 /* ICMP v4 echo header */
103 #define LIBNET_PBLOCK_ICMPV4_MASK_H 0x07 /* ICMP v4 mask header */
104 #define LIBNET_PBLOCK_ICMPV4_UNREACH_H 0x08 /* ICMP v4 unreach header */
105 #define LIBNET_PBLOCK_ICMPV4_TIMXCEED_H 0x09 /* ICMP v4 exceed header */
106 #define LIBNET_PBLOCK_ICMPV4_REDIRECT_H 0x0a /* ICMP v4 redirect header */
107 #define LIBNET_PBLOCK_ICMPV4_TS_H 0x0b /* ICMP v4 timestamp header */
108 #define LIBNET_PBLOCK_IGMP_H 0x0c /* IGMP header */
109 #define LIBNET_PBLOCK_IPV4_H 0x0d /* IP v4 header */
110 #define LIBNET_PBLOCK_IPO_H 0x0e /* IP v4 options */
111 #define LIBNET_PBLOCK_IPDATA 0x0f /* IP data */
112 #define LIBNET_PBLOCK_OSPF_H 0x10 /* OSPF base header */
113 #define LIBNET_PBLOCK_OSPF_HELLO_H 0x11 /* OSPF hello header */
114 #define LIBNET_PBLOCK_OSPF_DBD_H 0x12 /* OSPF dbd header */
115 #define LIBNET_PBLOCK_OSPF_LSR_H 0x13 /* OSPF lsr header */
116 #define LIBNET_PBLOCK_OSPF_LSU_H 0x14 /* OSPF lsu header */
117 #define LIBNET_PBLOCK_OSPF_LSA_H 0x15 /* OSPF lsa header */
118 #define LIBNET_PBLOCK_OSPF_AUTH_H 0x16 /* OSPF auth header */
119 #define LIBNET_PBLOCK_OSPF_CKSUM 0x17 /* OSPF checksum header */
120 #define LIBNET_PBLOCK_LS_RTR_H 0x18 /* linkstate rtr header */
121 #define LIBNET_PBLOCK_LS_NET_H 0x19 /* linkstate net header */
122 #define LIBNET_PBLOCK_LS_SUM_H 0x1a /* linkstate as sum header */
123 #define LIBNET_PBLOCK_LS_AS_EXT_H 0x1b /* linkstate as ext header */
124 #define LIBNET_PBLOCK_NTP_H 0x1c /* NTP header */
125 #define LIBNET_PBLOCK_RIP_H 0x1d /* RIP header */
126 #define LIBNET_PBLOCK_TCP_H 0x1e /* TCP header */
127 #define LIBNET_PBLOCK_TCPO_H 0x1f /* TCP options */
128 #define LIBNET_PBLOCK_TCPDATA 0x20 /* TCP data */
129 #define LIBNET_PBLOCK_UDP_H 0x21 /* UDP header */
130 #define LIBNET_PBLOCK_VRRP_H 0x22 /* VRRP header */
131 #define LIBNET_PBLOCK_DATA_H 0x23 /* generic data */
132 #define LIBNET_PBLOCK_CDP_H 0x24 /* CDP header */
133 #define LIBNET_PBLOCK_IPSEC_ESP_HDR_H 0x25 /* IPSEC ESP header */
134 #define LIBNET_PBLOCK_IPSEC_ESP_FTR_H 0x26 /* IPSEC ESP footer */
135 #define LIBNET_PBLOCK_IPSEC_AH_H 0x27 /* IPSEC AH header */
136 #define LIBNET_PBLOCK_802_1Q_H 0x28 /* 802.1q header */
137 #define LIBNET_PBLOCK_802_2_H 0x29 /* 802.2 header */
138 #define LIBNET_PBLOCK_802_2SNAP_H 0x2a /* 802.2 SNAP header */
139 #define LIBNET_PBLOCK_802_3_H 0x2b /* 802.3 header */
140 #define LIBNET_PBLOCK_STP_CONF_H 0x2c /* STP configuration header */
141 #define LIBNET_PBLOCK_STP_TCN_H 0x2d /* STP TCN header */
142 #define LIBNET_PBLOCK_ISL_H 0x2e /* ISL header */
143 #define LIBNET_PBLOCK_IPV6_H 0x2f /* IP v6 header */
144 #define LIBNET_PBLOCK_802_1X_H 0x30 /* 802.1x header */
145 #define LIBNET_PBLOCK_RPC_CALL_H 0x31 /* RPC Call header */
146 #define LIBNET_PBLOCK_MPLS_H 0x32 /* MPLS header */
147 #define LIBNET_PBLOCK_FDDI_H 0x33 /* FDDI header */
148 #define LIBNET_PBLOCK_TOKEN_RING_H 0x34 /* TOKEN RING header */
149 #define LIBNET_PBLOCK_BGP4_HEADER_H 0x35 /* BGP4 header */
150 #define LIBNET_PBLOCK_BGP4_OPEN_H 0x36 /* BGP4 open header */
151 #define LIBNET_PBLOCK_BGP4_UPDATE_H 0x37 /* BGP4 update header */
152 #define LIBNET_PBLOCK_BGP4_NOTIFICATION_H 0x38 /* BGP4 notification header */
153 #define LIBNET_PBLOCK_GRE_H 0x39 /* GRE header */
154 #define LIBNET_PBLOCK_GRE_SRE_H 0x3a /* GRE SRE header */
155 #define LIBNET_PBLOCK_IPV6_FRAG_H 0x3b /* IPv6 frag header */
156 #define LIBNET_PBLOCK_IPV6_ROUTING_H 0x3c /* IPv6 routing header */
157 #define LIBNET_PBLOCK_IPV6_DESTOPTS_H 0x3d /* IPv6 dest opts header */
158 #define LIBNET_PBLOCK_IPV6_HBHOPTS_H 0x3e /* IPv6 hop/hop opts header */
159 #define LIBNET_PBLOCK_SEBEK_H 0x3f /* Sebek header */
160 #define LIBNET_PBLOCK_HSRP_H 0x40 /* HSRP header */
161 #define LIBNET_PBLOCK_ICMPV6_H 0x41 /* ICMPv6 header (unused) */
162 #define LIBNET_PBLOCK_ICMPV6_ECHO_H 0x46 /* ICMPv6 echo header */
163 #define LIBNET_PBLOCK_ICMPV6_UNREACH_H 0x42 /* ICMPv6 unreach header */
164 #define LIBNET_PBLOCK_ICMPV6_NDP_NSOL_H 0x43 /* ICMPv6 NDP neighbor solicitation header */
165 #define LIBNET_PBLOCK_ICMPV6_NDP_NADV_H 0x44 /* ICMPv6 NDP neighbor advertisement header */
166 #define LIBNET_PBLOCK_ICMPV6_NDP_OPT_H 0x45 /* ICMPv6 NDP option */
167 
168  uint8_t flags; /* control flags */
169 #define LIBNET_PBLOCK_DO_CHECKSUM 0x01 /* needs a checksum */
170  libnet_ptag_t ptag; /* protocol block tag */
171  /* Chains are built from highest level protocol, towards the link level, so
172  * prev traverses away from link level, and next traverses towards the
173  * link level.
174  */
175  struct libnet_protocol_block *next; /* next pblock */
176  struct libnet_protocol_block *prev; /* prev pblock */
177 };
178 typedef struct libnet_protocol_block libnet_pblock_t;
179 
180 
181 /*
182  * Libnet context
183  * Opaque structure. Nothing in here should ever been touched first hand by
184  * the applications programmer.
185  */
186 struct libnet_context
187 {
188 #if ((__WIN32__) && !(__CYGWIN__))
189  SOCKET fd;
190  LPADAPTER lpAdapter;
191 #else
192  int fd; /* file descriptor of packet device */
193 #endif
194  int injection_type; /* one of: */
195 #define LIBNET_NONE 0xf8 /* no injection type, only construct packets */
196 #define LIBNET_LINK 0x00 /* link-layer interface */
197 #define LIBNET_RAW4 0x01 /* raw socket interface (ipv4) */
198 #define LIBNET_RAW6 0x02 /* raw socket interface (ipv6) */
199 /* the following should actually set a flag in the flags variable above */
200 #define LIBNET_LINK_ADV 0x08 /* advanced mode link-layer */
201 #define LIBNET_RAW4_ADV 0x09 /* advanced mode raw socket (ipv4) */
202 #define LIBNET_RAW6_ADV 0x0a /* advanced mode raw socket (ipv6) */
203 #define LIBNET_ADV_MASK 0x08 /* mask to determine adv mode */
204 
205  /* _blocks is the highest level, and _end is closest to link-level */
206  libnet_pblock_t *protocol_blocks; /* protocol headers / data */
207  libnet_pblock_t *pblock_end; /* last node in list */
208  uint32_t n_pblocks; /* number of pblocks */
209 
210  int link_type; /* link-layer type, a DLT_ value. */
211  /* These are the only values used by libnet (see libnet_build_arp and
212  * libnet_build_link). Other values are assigned by the various
213  * libnet_link_*.c OS support functions, but are not yet used or supported,
214  * they are effectively dead code. <pcap.h> claims these two are invariant
215  * across operating systems... hopefully it is correct!
216  */
217 #ifndef DLT_EN10MB
218 # define DLT_EN10MB 1 /* Ethernet (10Mb) */
219 #endif
220 #ifndef DLT_IEEE802
221 # define DLT_IEEE802 6 /* IEEE 802 Networks */
222 #endif
223 
224  int link_offset; /* link-layer header size */
225  int aligner; /* used to align packets */
226  char *device; /* device name */
227 
228  struct libnet_stats stats; /* statistics */
229  libnet_ptag_t ptag_state; /* state holder for pblock tag */
230  char label[LIBNET_LABEL_SIZE]; /* textual label for cq interface */
231 
232  char err_buf[LIBNET_ERRBUF_SIZE]; /* error buffer */
233  uint32_t total_size; /* total size */
234 };
235 typedef struct libnet_context libnet_t;
236 
237 /*
238  * Libnet context queue structure
239  * Opaque structure. Nothing in here should ever been touched first hand by
240  * the applications programmer.
241  */
242 typedef struct _libnet_context_queue libnet_cq_t;
243 struct _libnet_context_queue
244 {
245  libnet_t *context; /* pointer to libnet context */
246  libnet_cq_t *next; /* next node in the list */
247  libnet_cq_t *prev; /* previous node in the list */
248 };
249 
250 struct _libnet_context_queue_descriptor
251 {
252  uint32_t node; /* number of nodes in the list */
253  uint32_t cq_lock; /* lock status */
254  libnet_cq_t *current; /* current context */
255 };
256 typedef struct _libnet_context_queue_descriptor libnet_cqd_t;
257 
258 #endif /* __LIBNET_STRUCTURES_H */
259 
260 /* EOF */
Generated on Wed Jan 29 2014 21:58:50 for libnet by   doxygen 1.8.4