]> git.proxmox.com Git - qemu.git/blame - hw/vmxnet_tx_pkt.h
Merge remote-tracking branch 'luiz/queue/qmp' into staging
[qemu.git] / hw / vmxnet_tx_pkt.h
CommitLineData
e263cd49
DF
1/*
2 * QEMU VMWARE VMXNET* paravirtual NICs - 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 VMXNET_TX_PKT_H
19#define VMXNET_TX_PKT_H
20
21#include "stdint.h"
22#include "stdbool.h"
23#include "net/eth.h"
24#include "exec/hwaddr.h"
25
26/* define to enable packet dump functions */
27/*#define VMXNET_TX_PKT_DEBUG*/
28
29struct VmxnetTxPkt;
30
31/**
32 * Init function for tx packet functionality
33 *
34 * @pkt: packet pointer
35 * @max_frags: max tx ip fragments
36 * @has_virt_hdr: device uses virtio header.
37 */
38void vmxnet_tx_pkt_init(struct VmxnetTxPkt **pkt, uint32_t max_frags,
39 bool has_virt_hdr);
40
41/**
42 * Clean all tx packet resources.
43 *
44 * @pkt: packet.
45 */
46void vmxnet_tx_pkt_uninit(struct VmxnetTxPkt *pkt);
47
48/**
49 * get virtio header
50 *
51 * @pkt: packet
52 * @ret: virtio header
53 */
54struct virtio_net_hdr *vmxnet_tx_pkt_get_vhdr(struct VmxnetTxPkt *pkt);
55
56/**
57 * build virtio header (will be stored in module context)
58 *
59 * @pkt: packet
60 * @tso_enable: TSO enabled
61 * @csum_enable: CSO enabled
62 * @gso_size: MSS size for TSO
63 *
64 */
65void vmxnet_tx_pkt_build_vheader(struct VmxnetTxPkt *pkt, bool tso_enable,
66 bool csum_enable, uint32_t gso_size);
67
68/**
69 * updates vlan tag, and adds vlan header in case it is missing
70 *
71 * @pkt: packet
72 * @vlan: VLAN tag
73 *
74 */
75void vmxnet_tx_pkt_setup_vlan_header(struct VmxnetTxPkt *pkt, uint16_t vlan);
76
77/**
78 * populate data fragment into pkt context.
79 *
80 * @pkt: packet
81 * @pa: physical address of fragment
82 * @len: length of fragment
83 *
84 */
85bool vmxnet_tx_pkt_add_raw_fragment(struct VmxnetTxPkt *pkt, hwaddr pa,
86 size_t len);
87
88/**
89 * fix ip header fields and calculate checksums needed.
90 *
91 * @pkt: packet
92 *
93 */
94void vmxnet_tx_pkt_update_ip_checksums(struct VmxnetTxPkt *pkt);
95
96/**
97 * get length of all populated data.
98 *
99 * @pkt: packet
100 * @ret: total data length
101 *
102 */
103size_t vmxnet_tx_pkt_get_total_len(struct VmxnetTxPkt *pkt);
104
105/**
106 * get packet type
107 *
108 * @pkt: packet
109 * @ret: packet type
110 *
111 */
112eth_pkt_types_e vmxnet_tx_pkt_get_packet_type(struct VmxnetTxPkt *pkt);
113
114/**
115 * prints packet data if debug is enabled
116 *
117 * @pkt: packet
118 *
119 */
120void vmxnet_tx_pkt_dump(struct VmxnetTxPkt *pkt);
121
122/**
123 * reset tx packet private context (needed to be called between packets)
124 *
125 * @pkt: packet
126 *
127 */
128void vmxnet_tx_pkt_reset(struct VmxnetTxPkt *pkt);
129
130/**
131 * Send packet to qemu. handles sw offloads if vhdr is not supported.
132 *
133 * @pkt: packet
134 * @nc: NetClientState
135 * @ret: operation result
136 *
137 */
138bool vmxnet_tx_pkt_send(struct VmxnetTxPkt *pkt, NetClientState *nc);
139
140/**
141 * parse raw packet data and analyze offload requirements.
142 *
143 * @pkt: packet
144 *
145 */
146bool vmxnet_tx_pkt_parse(struct VmxnetTxPkt *pkt);
147
148#endif