Changeset View
Changeset View
Standalone View
Standalone View
share/man/man4/ixl.4
Show All 25 Lines | |||||
.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) | ||||
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE | ||||
.\" POSSIBILITY OF SUCH DAMAGE. | .\" POSSIBILITY OF SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" * Other names and brands may be claimed as the property of others. | .\" * Other names and brands may be claimed as the property of others. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd June 27, 2020 | .Dd January 19, 2021 | ||||
.Dt IXL 4 | .Dt IXL 4 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm ixl | .Nm ixl | ||||
.Nd "Intel Ethernet 700 Series Driver" | .Nd "Intel Ethernet 700 Series Driver" | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
To compile this driver into the kernel, place the following lines in your | To compile this driver into the kernel, place the following lines in your | ||||
kernel configuration file: | kernel configuration file: | ||||
▲ Show 20 Lines • Show All 179 Lines • ▼ Show 20 Lines | |||||
.It Va dev.ixl.#.advertise_speed | .It Va dev.ixl.#.advertise_speed | ||||
Set the speeds that the interface will advertise on the link. | Set the speeds that the interface will advertise on the link. | ||||
.Va dev.ixl.#.supported_speeds | .Va dev.ixl.#.supported_speeds | ||||
contains the speeds that are allowed to be set. | contains the speeds that are allowed to be set. | ||||
.It Va dev.ixl.#.current_speed | .It Va dev.ixl.#.current_speed | ||||
Displays the current speed. | Displays the current speed. | ||||
.It Va dev.ixl.#.fw_version | .It Va dev.ixl.#.fw_version | ||||
Displays the current firmware and NVM versions of the adapter. | Displays the current firmware and NVM versions of the adapter. | ||||
.It Va dev.ixl.#.debug.switch_vlans | |||||
Set the Ethertype used by the hardware itself to handle internal | |||||
services. | |||||
brueffer: mdoc style: a new sentence should start on a new line. | |||||
Frames with this Ethertype will be dropped without notice. | |||||
Done Inline ActionsThis should probably be Defaults to brueffer: This should probably be
Defaults to
.Dv 0x88a8 ,
which... | |||||
Defaults to | |||||
Done Inline Actionsmdoc style: a new sentence should start on a new line. brueffer: mdoc style: a new sentence should start on a new line. | |||||
.Dv 0x88a8 , | |||||
Done Inline ActionsI would suggest wording like "if you need 802.1ad support, set this to another ethertype". Perhaps suggest 0x88b5 or 0x88b6 instead. These are reserved for "local experimentation" in IEEE 802. philip: I would suggest wording like "if you need 802.1ad support, set this to another ethertype".
Note… | |||||
Done Inline ActionsEverybody out there seems to set it to 0xffff. Which should be the default in FreeBSD, too (sometimes later) donner: Everybody out there seems to set it to 0xffff. Which should be the default in FreeBSD, too… | |||||
Done Inline ActionsSame as above, .Dv 0xffff brueffer: Same as above, .Dv 0xffff | |||||
which is a well known number for IEEE 802.1ad VLAN stacking. | |||||
Done Inline ActionsJust another minor nitpick, I think we capitalize LAN and VLAN everywhere. Looks good otherwise, thanks! Please bump the document date before you commit. brueffer: Just another minor nitpick, I think we capitalize LAN and VLAN everywhere. Looks good otherwise… | |||||
If you need 802.1ad support, set this number to any another Ethertype i.e. | |||||
.Dv 0xffff . | |||||
.El | .El | ||||
.Sh INTERRUPT STORMS | .Sh INTERRUPT STORMS | ||||
It is important to note that 40G operation can generate high | It is important to note that 40G operation can generate high | ||||
numbers of interrupts, often incorrectly being interpreted as | numbers of interrupts, often incorrectly being interpreted as | ||||
a storm condition in the kernel. | a storm condition in the kernel. | ||||
It is suggested that this be resolved by setting: | It is suggested that this be resolved by setting: | ||||
.Bl -tag -width indent | .Bl -tag -width indent | ||||
.It Va hw.intr_storm_threshold: 0 | .It Va hw.intr_storm_threshold: 0 | ||||
▲ Show 20 Lines • Show All 58 Lines • Show Last 20 Lines |
mdoc style: a new sentence should start on a new line.