aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/networking/device_drivers/ethernet/neterion/vxge.rst
blob: 589c6b15c63d7e1d93c3cf33f90d561b49f90cc4 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
.. SPDX-License-Identifier: GPL-2.0

==============================================================================
Neterion's (Formerly S2io) X3100 Series 10GbE PCIe Server Adapter Linux driver
==============================================================================

.. Contents

  1) Introduction
  2) Features supported
  3) Configurable driver parameters
  4) Troubleshooting

1. Introduction
===============

This Linux driver supports all Neterion's X3100 series 10 GbE PCIe I/O
Virtualized Server adapters.

The X3100 series supports four modes of operation, configurable via
firmware:

	- Single function mode
	- Multi function mode
	- SRIOV mode
	- MRIOV mode

The functions share a 10GbE link and the pci-e bus, but hardly anything else
inside the ASIC. Features like independent hw reset, statistics, bandwidth/
priority allocation and guarantees, GRO, TSO, interrupt moderation etc are
supported independently on each function.

(See below for a complete list of features supported for both IPv4 and IPv6)

2. Features supported
=====================

i)   Single function mode (up to 17 queues)

ii)  Multi function mode (up to 17 functions)

iii) PCI-SIG's I/O Virtualization

       - Single Root mode: v1.0 (up to 17 functions)
       - Multi-Root mode: v1.0 (up to 17 functions)

iv)  Jumbo frames

       X3100 Series supports MTU up to 9600 bytes, modifiable using
       ip command.

v)   Offloads supported: (Enabled by default)

       - Checksum offload (TCP/UDP/IP) on transmit and receive paths
       - TCP Segmentation Offload (TSO) on transmit path
       - Generic Receive Offload (GRO) on receive path

vi)  MSI-X: (Enabled by default)

       Resulting in noticeable performance improvement (up to 7% on certain
       platforms).

vii) NAPI: (Enabled by default)

       For better Rx interrupt moderation.

viii)RTH (Receive Traffic Hash): (Enabled by default)

       Receive side steering for better scaling.

ix)  Statistics

       Comprehensive MAC-level and software statistics displayed using
       "ethtool -S" option.

x)   Multiple hardware queues: (Enabled by default)

       Up to 17 hardware based transmit and receive data channels, with
       multiple steering options (transmit multiqueue enabled by default).

3) Configurable driver parameters:
----------------------------------

i)  max_config_dev
       Specifies maximum device functions to be enabled.

       Valid range: 1-8

ii) max_config_port
       Specifies number of ports to be enabled.

       Valid range: 1,2

       Default: 1

iii) max_config_vpath
       Specifies maximum VPATH(s) configured for each device function.

       Valid range: 1-17

iv) vlan_tag_strip
       Enables/disables vlan tag stripping from all received tagged frames that
       are not replicated at the internal L2 switch.

       Valid range: 0,1 (disabled, enabled respectively)

       Default: 1

v)  addr_learn_en
       Enable learning the mac address of the guest OS interface in
       virtualization environment.

       Valid range: 0,1 (disabled, enabled respectively)

       Default: 0