vmxnet3: Use common MAC address tracing macros
[qemu.git] / hw / net / vmxnet_rx_pkt.h
1 /*
2 * QEMU VMWARE VMXNET* paravirtual NICs - RX packets abstraction
3 *
4 * Copyright (c) 2012 Ravello Systems LTD (http://ravellosystems.com)
5 *
6 * Developed by Daynix Computing LTD (http://www.daynix.com)
7 *
8 * Authors:
9 * Dmitry Fleytman <dmitry@daynix.com>
10 * Tamir Shomer <tamirs@daynix.com>
11 * Yan Vugenfirer <yan@daynix.com>
12 *
13 * This work is licensed under the terms of the GNU GPL, version 2 or later.
14 * See the COPYING file in the top-level directory.
15 *
16 */
17
18 #ifndef VMXNET_RX_PKT_H
19 #define VMXNET_RX_PKT_H
20
21 #include "net/eth.h"
22
23 /* defines to enable packet dump functions */
24 /*#define VMXNET_RX_PKT_DEBUG*/
25
26 struct VmxnetRxPkt;
27
28 /**
29 * Clean all rx packet resources
30 *
31 * @pkt: packet
32 *
33 */
34 void vmxnet_rx_pkt_uninit(struct VmxnetRxPkt *pkt);
35
36 /**
37 * Init function for rx packet functionality
38 *
39 * @pkt: packet pointer
40 * @has_virt_hdr: device uses virtio header
41 *
42 */
43 void vmxnet_rx_pkt_init(struct VmxnetRxPkt **pkt, bool has_virt_hdr);
44
45 /**
46 * returns total length of data attached to rx context
47 *
48 * @pkt: packet
49 *
50 * Return: nothing
51 *
52 */
53 size_t vmxnet_rx_pkt_get_total_len(struct VmxnetRxPkt *pkt);
54
55 /**
56 * parse and set packet analysis results
57 *
58 * @pkt: packet
59 * @data: pointer to the data buffer to be parsed
60 * @len: data length
61 *
62 */
63 void vmxnet_rx_pkt_set_protocols(struct VmxnetRxPkt *pkt, const void *data,
64 size_t len);
65
66 /**
67 * fetches packet analysis results
68 *
69 * @pkt: packet
70 * @isip4: whether the packet given is IPv4
71 * @isip6: whether the packet given is IPv6
72 * @isudp: whether the packet given is UDP
73 * @istcp: whether the packet given is TCP
74 *
75 */
76 void vmxnet_rx_pkt_get_protocols(struct VmxnetRxPkt *pkt,
77 bool *isip4, bool *isip6,
78 bool *isudp, bool *istcp);
79
80 /**
81 * returns virtio header stored in rx context
82 *
83 * @pkt: packet
84 * @ret: virtio header
85 *
86 */
87 struct virtio_net_hdr *vmxnet_rx_pkt_get_vhdr(struct VmxnetRxPkt *pkt);
88
89 /**
90 * returns packet type
91 *
92 * @pkt: packet
93 * @ret: packet type
94 *
95 */
96 eth_pkt_types_e vmxnet_rx_pkt_get_packet_type(struct VmxnetRxPkt *pkt);
97
98 /**
99 * returns vlan tag
100 *
101 * @pkt: packet
102 * @ret: VLAN tag
103 *
104 */
105 uint16_t vmxnet_rx_pkt_get_vlan_tag(struct VmxnetRxPkt *pkt);
106
107 /**
108 * tells whether vlan was stripped from the packet
109 *
110 * @pkt: packet
111 * @ret: VLAN stripped sign
112 *
113 */
114 bool vmxnet_rx_pkt_is_vlan_stripped(struct VmxnetRxPkt *pkt);
115
116 /**
117 * notifies caller if the packet has virtio header
118 *
119 * @pkt: packet
120 * @ret: true if packet has virtio header, false otherwize
121 *
122 */
123 bool vmxnet_rx_pkt_has_virt_hdr(struct VmxnetRxPkt *pkt);
124
125 /**
126 * attach data to rx packet
127 *
128 * @pkt: packet
129 * @data: pointer to the data buffer
130 * @len: data length
131 * @strip_vlan: should the module strip vlan from data
132 *
133 */
134 void vmxnet_rx_pkt_attach_data(struct VmxnetRxPkt *pkt, const void *data,
135 size_t len, bool strip_vlan);
136
137 /**
138 * returns io vector that holds the attached data
139 *
140 * @pkt: packet
141 * @ret: pointer to IOVec
142 *
143 */
144 struct iovec *vmxnet_rx_pkt_get_iovec(struct VmxnetRxPkt *pkt);
145
146 /**
147 * prints rx packet data if debug is enabled
148 *
149 * @pkt: packet
150 *
151 */
152 void vmxnet_rx_pkt_dump(struct VmxnetRxPkt *pkt);
153
154 /**
155 * copy passed vhdr data to packet context
156 *
157 * @pkt: packet
158 * @vhdr: VHDR buffer
159 *
160 */
161 void vmxnet_rx_pkt_set_vhdr(struct VmxnetRxPkt *pkt,
162 struct virtio_net_hdr *vhdr);
163
164 /**
165 * save packet type in packet context
166 *
167 * @pkt: packet
168 * @packet_type: the packet type
169 *
170 */
171 void vmxnet_rx_pkt_set_packet_type(struct VmxnetRxPkt *pkt,
172 eth_pkt_types_e packet_type);
173
174 #endif