1 /*
2 * QEMU TX 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 NET_TX_PKT_H
19 #define NET_TX_PKT_H
20
21 #include "net/eth.h"
22 #include "exec/hwaddr.h"
23
24 /* define to enable packet dump functions */
25 /*#define NET_TX_PKT_DEBUG*/
26
27 struct NetTxPkt;
28
29 typedef void (*NetTxPktFreeFrag)(void *, void *, size_t);
30 typedef void (*NetTxPktSend)(void *, const struct iovec *, int, const struct iovec *, int);
31
32 /**
33 * Init function for tx packet functionality
34 *
35 * @pkt: packet pointer
36 * @max_frags: max tx ip fragments
37 */
38 void net_tx_pkt_init(struct NetTxPkt **pkt, uint32_t max_frags);
39
40 /**
41 * Clean all tx packet resources.
42 *
43 * @pkt: packet.
44 */
45 void net_tx_pkt_uninit(struct NetTxPkt *pkt);
46
47 /**
48 * get virtio header
49 *
50 * @pkt: packet
51 * @ret: virtio header
52 */
53 struct virtio_net_hdr *net_tx_pkt_get_vhdr(struct NetTxPkt *pkt);
54
55 /**
56 * build virtio header (will be stored in module context)
57 *
58 * @pkt: packet
59 * @tso_enable: TSO enabled
60 * @csum_enable: CSO enabled
61 * @gso_size: MSS size for TSO
62 * @ret: operation result
63 *
64 */
65 bool net_tx_pkt_build_vheader(struct NetTxPkt *pkt, bool tso_enable,
66 bool csum_enable, uint32_t gso_size);
67
68 /**
69 * updates vlan tag, and adds vlan header with custom ethernet type
70 * in case it is missing.
71 *
72 * @pkt: packet
73 * @vlan: VLAN tag
74 * @vlan_ethtype: VLAN header Ethernet type
75 *
76 */
77 void net_tx_pkt_setup_vlan_header_ex(struct NetTxPkt *pkt,
78 uint16_t vlan, uint16_t vlan_ethtype);
79
80 /**
81 * updates vlan tag, and adds vlan header in case it is missing
82 *
83 * @pkt: packet
84 * @vlan: VLAN tag
85 *
86 */
87 static inline void
net_tx_pkt_setup_vlan_header(struct NetTxPkt * pkt,uint16_t vlan)88 net_tx_pkt_setup_vlan_header(struct NetTxPkt *pkt, uint16_t vlan)
89 {
90 net_tx_pkt_setup_vlan_header_ex(pkt, vlan, ETH_P_VLAN);
91 }
92
93 /**
94 * populate data fragment into pkt context.
95 *
96 * @pkt: packet
97 * @base: pointer to fragment
98 * @len: length of fragment
99 *
100 */
101 bool net_tx_pkt_add_raw_fragment(struct NetTxPkt *pkt, void *base, size_t len);
102
103 /**
104 * Fix ip header fields and calculate IP header and pseudo header checksums.
105 *
106 * @pkt: packet
107 *
108 */
109 void net_tx_pkt_update_ip_checksums(struct NetTxPkt *pkt);
110
111 /**
112 * Calculate the IP header checksum.
113 *
114 * @pkt: packet
115 *
116 */
117 void net_tx_pkt_update_ip_hdr_checksum(struct NetTxPkt *pkt);
118
119 /**
120 * Calculate the SCTP checksum.
121 *
122 * @pkt: packet
123 *
124 */
125 bool net_tx_pkt_update_sctp_checksum(struct NetTxPkt *pkt);
126
127 /**
128 * get length of all populated data.
129 *
130 * @pkt: packet
131 * @ret: total data length
132 *
133 */
134 size_t net_tx_pkt_get_total_len(struct NetTxPkt *pkt);
135
136 /**
137 * get packet type
138 *
139 * @pkt: packet
140 * @ret: packet type
141 *
142 */
143 eth_pkt_types_e net_tx_pkt_get_packet_type(struct NetTxPkt *pkt);
144
145 /**
146 * prints packet data if debug is enabled
147 *
148 * @pkt: packet
149 *
150 */
151 void net_tx_pkt_dump(struct NetTxPkt *pkt);
152
153 /**
154 * reset tx packet private context (needed to be called between packets)
155 *
156 * @pkt: packet
157 * @callback: function to free the fragments
158 * @context: pointer to be passed to the callback
159 */
160 void net_tx_pkt_reset(struct NetTxPkt *pkt,
161 NetTxPktFreeFrag callback, void *context);
162
163 /**
164 * Unmap a fragment mapped from a PCI device.
165 *
166 * @context: PCI device owning fragment
167 * @base: pointer to fragment
168 * @len: length of fragment
169 */
170 void net_tx_pkt_unmap_frag_pci(void *context, void *base, size_t len);
171
172 /**
173 * map data fragment from PCI device and populate it into pkt context.
174 *
175 * @pci_dev: PCI device owning fragment
176 * @pa: physical address of fragment
177 * @len: length of fragment
178 */
179 bool net_tx_pkt_add_raw_fragment_pci(struct NetTxPkt *pkt, PCIDevice *pci_dev,
180 dma_addr_t pa, size_t len);
181
182 /**
183 * Send packet to qemu. handles sw offloads if vhdr is not supported.
184 *
185 * @pkt: packet
186 * @nc: NetClientState
187 * @ret: operation result
188 *
189 */
190 bool net_tx_pkt_send(struct NetTxPkt *pkt, NetClientState *nc);
191
192 /**
193 * Send packet with a custom function.
194 *
195 * @pkt: packet
196 * @offload: whether the callback implements offloading
197 * @callback: a function to be called back for each transformed packet
198 * @context: a pointer to be passed to the callback.
199 * @ret: operation result
200 */
201 bool net_tx_pkt_send_custom(struct NetTxPkt *pkt, bool offload,
202 NetTxPktSend callback, void *context);
203
204 /**
205 * parse raw packet data and analyze offload requirements.
206 *
207 * @pkt: packet
208 *
209 */
210 bool net_tx_pkt_parse(struct NetTxPkt *pkt);
211
212 /**
213 * indicates if there are data fragments held by this packet object.
214 *
215 * @pkt: packet
216 *
217 */
218 bool net_tx_pkt_has_fragments(struct NetTxPkt *pkt);
219
220 /**
221 * Fix IPv6 'plen' field.
222 * If ipv6 payload length field is 0 - then there should be Hop-by-Hop
223 * option for packets greater than 65,535.
224 * For packets with a payload less than 65,535: fix 'plen' field.
225 * For backends with vheader, we need just one packet with proper
226 * payload size. For now, qemu drops every packet with size greater 64K
227 * (see net_tx_pkt_send()) so, there is no reason to add jumbo option to ip6
228 * hop-by-hop extension if it's missed
229 *
230 * @pkt packet
231 */
232 void net_tx_pkt_fix_ip6_payload_len(struct NetTxPkt *pkt);
233
234 #endif
235