d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
407fb44c92
freebsd-skq/share/man/man4/mlx4en.4

96 lines
3.0 KiB
Groff
Raw Normal View History

Move the ConnectX-3 and ConnectX-2 driver from sys/ofed into sys/dev/mlx4 like other PCI network drivers. The sys/ofed directory is now mainly reserved for generic infiniband code, with exception of the mthca driver. - Add new manual page, mlx4en(4), describing how to configure and load mlx4en. - All relevant driver C-files are now prefixed mlx4, mlx4_en and mlx4_ib respectivly to avoid object filename collisions when compiling the kernel. This also fixes an issue with proper dependency file generation for the C-files in question. - Device mlxen is now device mlx4en and depends on device mlx4, see mlx4en(4). Only the network device name remains unchanged. - The mlx4 and mlx4en modules are now built by default on i386 and amd64 targets. Only building the mlx4ib module depends on WITH_OFED=YES . Sponsored by: Mellanox Technologies
2016-09-30 08:23:06 +00:00
.\" Copyright (c) 2016 Mellanox Technologies
.\" All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\" notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\" notice, this list of conditions and the following disclaimer in the
.\" documentation and/or other materials provided with the distribution.
.\"
.\" THIS SOFTWARE IS PROVIDED BY AUTHOR AND CONTRIBUTORS `AS IS' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED. IN NO EVENT SHALL AUTHOR OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 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 POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $FreeBSD$
.\"
Wordsmith mlx4{en,ib}(4) - Replace the "following lines" with more terse phrases. - Use .Lk for the mellanox URL. - Reword the SUPPORT section so it's less wordy. The DESCRIPTION section suggestions are still outstanding; improving the section requires additional review to make sure the nuance/message is correct per the original intent. Bump .Dd for the change Submitted by: wblock Sponsored by: Dell EMC Isilon Differential Revision: https://reviews.freebsd.org/D9241
2017-03-02 06:57:13 +00:00
.Dd March 1, 2017
Move the ConnectX-3 and ConnectX-2 driver from sys/ofed into sys/dev/mlx4 like other PCI network drivers. The sys/ofed directory is now mainly reserved for generic infiniband code, with exception of the mthca driver. - Add new manual page, mlx4en(4), describing how to configure and load mlx4en. - All relevant driver C-files are now prefixed mlx4, mlx4_en and mlx4_ib respectivly to avoid object filename collisions when compiling the kernel. This also fixes an issue with proper dependency file generation for the C-files in question. - Device mlxen is now device mlx4en and depends on device mlx4, see mlx4en(4). Only the network device name remains unchanged. - The mlx4 and mlx4en modules are now built by default on i386 and amd64 targets. Only building the mlx4ib module depends on WITH_OFED=YES . Sponsored by: Mellanox Technologies
2016-09-30 08:23:06 +00:00
.Dt MLX4EN 4
.Os
.Sh NAME
.Nm mlx4en
.Nd "Mellanox ConnectX-3 10GbE/40GbE network adapter driver"
.Sh SYNOPSIS
To compile this driver into the kernel,
Wordsmith mlx4{en,ib}(4) - Replace the "following lines" with more terse phrases. - Use .Lk for the mellanox URL. - Reword the SUPPORT section so it's less wordy. The DESCRIPTION section suggestions are still outstanding; improving the section requires additional review to make sure the nuance/message is correct per the original intent. Bump .Dd for the change Submitted by: wblock Sponsored by: Dell EMC Isilon Differential Revision: https://reviews.freebsd.org/D9241
2017-03-02 06:57:13 +00:00
place these lines in your kernel configuration file:
Move the ConnectX-3 and ConnectX-2 driver from sys/ofed into sys/dev/mlx4 like other PCI network drivers. The sys/ofed directory is now mainly reserved for generic infiniband code, with exception of the mthca driver. - Add new manual page, mlx4en(4), describing how to configure and load mlx4en. - All relevant driver C-files are now prefixed mlx4, mlx4_en and mlx4_ib respectivly to avoid object filename collisions when compiling the kernel. This also fixes an issue with proper dependency file generation for the C-files in question. - Device mlxen is now device mlx4en and depends on device mlx4, see mlx4en(4). Only the network device name remains unchanged. - The mlx4 and mlx4en modules are now built by default on i386 and amd64 targets. Only building the mlx4ib module depends on WITH_OFED=YES . Sponsored by: Mellanox Technologies
2016-09-30 08:23:06 +00:00
.Bd -ragged -offset indent
.Cd "options COMPAT_LINUXKPI"
.Cd "device mlx4"
.Cd "device mlx4en"
.Ed
.Pp
To load the driver as a module at run-time,
Wordsmith mlx4{en,ib}(4) - Replace the "following lines" with more terse phrases. - Use .Lk for the mellanox URL. - Reword the SUPPORT section so it's less wordy. The DESCRIPTION section suggestions are still outstanding; improving the section requires additional review to make sure the nuance/message is correct per the original intent. Bump .Dd for the change Submitted by: wblock Sponsored by: Dell EMC Isilon Differential Revision: https://reviews.freebsd.org/D9241
2017-03-02 06:57:13 +00:00
run this command as root:
Move the ConnectX-3 and ConnectX-2 driver from sys/ofed into sys/dev/mlx4 like other PCI network drivers. The sys/ofed directory is now mainly reserved for generic infiniband code, with exception of the mthca driver. - Add new manual page, mlx4en(4), describing how to configure and load mlx4en. - All relevant driver C-files are now prefixed mlx4, mlx4_en and mlx4_ib respectivly to avoid object filename collisions when compiling the kernel. This also fixes an issue with proper dependency file generation for the C-files in question. - Device mlxen is now device mlx4en and depends on device mlx4, see mlx4en(4). Only the network device name remains unchanged. - The mlx4 and mlx4en modules are now built by default on i386 and amd64 targets. Only building the mlx4ib module depends on WITH_OFED=YES . Sponsored by: Mellanox Technologies
2016-09-30 08:23:06 +00:00
.Bd -literal -offset indent
kldload mlx4en
.Ed
.Pp
To load the driver as a
Wordsmith mlx4{en,ib}(4) - Replace the "following lines" with more terse phrases. - Use .Lk for the mellanox URL. - Reword the SUPPORT section so it's less wordy. The DESCRIPTION section suggestions are still outstanding; improving the section requires additional review to make sure the nuance/message is correct per the original intent. Bump .Dd for the change Submitted by: wblock Sponsored by: Dell EMC Isilon Differential Revision: https://reviews.freebsd.org/D9241
2017-03-02 06:57:13 +00:00
module at boot time, place this line in
Move the ConnectX-3 and ConnectX-2 driver from sys/ofed into sys/dev/mlx4 like other PCI network drivers. The sys/ofed directory is now mainly reserved for generic infiniband code, with exception of the mthca driver. - Add new manual page, mlx4en(4), describing how to configure and load mlx4en. - All relevant driver C-files are now prefixed mlx4, mlx4_en and mlx4_ib respectivly to avoid object filename collisions when compiling the kernel. This also fixes an issue with proper dependency file generation for the C-files in question. - Device mlxen is now device mlx4en and depends on device mlx4, see mlx4en(4). Only the network device name remains unchanged. - The mlx4 and mlx4en modules are now built by default on i386 and amd64 targets. Only building the mlx4ib module depends on WITH_OFED=YES . Sponsored by: Mellanox Technologies
2016-09-30 08:23:06 +00:00
.Xr loader.conf 5 :
.Bd -literal -offset indent
mlx4en_load="YES"
.Ed
.Sh DESCRIPTION
Mellanox ConnectX adapter cards with Virtual Protocol Interconnect
(VPI) provide the highest performing and most flexible interconnect
solution for Enterprise Data Centers, High-Performance Computing, and
Embedded environments.
Clustered data bases, parallelized applications, transactional
services and high-performance embedded I/O applications will achieve
significant performance improvements resulting in reduced completion
time and lower cost per operation.
.Sh HARDWARE
The
.Nm
driver supports the following network adapters:
.Pp
.Bl -bullet -compact
.It
Mellanox ConnectX-2 (ETH)
.It
Mellanox ConnectX-3 (ETH)
.El
.Sh SUPPORT
For general information and support,
go to the Mellanox support website at:
Wordsmith mlx4{en,ib}(4) - Replace the "following lines" with more terse phrases. - Use .Lk for the mellanox URL. - Reword the SUPPORT section so it's less wordy. The DESCRIPTION section suggestions are still outstanding; improving the section requires additional review to make sure the nuance/message is correct per the original intent. Bump .Dd for the change Submitted by: wblock Sponsored by: Dell EMC Isilon Differential Revision: https://reviews.freebsd.org/D9241
2017-03-02 06:57:13 +00:00
.Lk http://www.mellanox.com/ .
Move the ConnectX-3 and ConnectX-2 driver from sys/ofed into sys/dev/mlx4 like other PCI network drivers. The sys/ofed directory is now mainly reserved for generic infiniband code, with exception of the mthca driver. - Add new manual page, mlx4en(4), describing how to configure and load mlx4en. - All relevant driver C-files are now prefixed mlx4, mlx4_en and mlx4_ib respectivly to avoid object filename collisions when compiling the kernel. This also fixes an issue with proper dependency file generation for the C-files in question. - Device mlxen is now device mlx4en and depends on device mlx4, see mlx4en(4). Only the network device name remains unchanged. - The mlx4 and mlx4en modules are now built by default on i386 and amd64 targets. Only building the mlx4ib module depends on WITH_OFED=YES . Sponsored by: Mellanox Technologies
2016-09-30 08:23:06 +00:00
.Pp
Wordsmith mlx4{en,ib}(4) - Replace the "following lines" with more terse phrases. - Use .Lk for the mellanox URL. - Reword the SUPPORT section so it's less wordy. The DESCRIPTION section suggestions are still outstanding; improving the section requires additional review to make sure the nuance/message is correct per the original intent. Bump .Dd for the change Submitted by: wblock Sponsored by: Dell EMC Isilon Differential Revision: https://reviews.freebsd.org/D9241
2017-03-02 06:57:13 +00:00
If an issue is identified with this driver and a supported network adapter,
please email the specific information to
Move the ConnectX-3 and ConnectX-2 driver from sys/ofed into sys/dev/mlx4 like other PCI network drivers. The sys/ofed directory is now mainly reserved for generic infiniband code, with exception of the mthca driver. - Add new manual page, mlx4en(4), describing how to configure and load mlx4en. - All relevant driver C-files are now prefixed mlx4, mlx4_en and mlx4_ib respectivly to avoid object filename collisions when compiling the kernel. This also fixes an issue with proper dependency file generation for the C-files in question. - Device mlxen is now device mlx4en and depends on device mlx4, see mlx4en(4). Only the network device name remains unchanged. - The mlx4 and mlx4en modules are now built by default on i386 and amd64 targets. Only building the mlx4ib module depends on WITH_OFED=YES . Sponsored by: Mellanox Technologies
2016-09-30 08:23:06 +00:00
.Aq Mt freebsd-drivers@mellanox.com .
.Sh SEE ALSO
Add manpage for mlx4ib(4) This manpage isn't differentiated from mlx4en except where necessary, replacing eth/ETH with ib/IB. Eventually the manpages will be split and the common bits be placed in a manpage named "mlx4.4". MFC after: 3 weeks Reviewed by: hselasky Sponsored by: Dell EMC Isilon Differential Revision: https://reviews.freebsd.org/D9241
2017-01-19 17:09:11 +00:00
.Xr mlx4ib 4 ,
Move the ConnectX-3 and ConnectX-2 driver from sys/ofed into sys/dev/mlx4 like other PCI network drivers. The sys/ofed directory is now mainly reserved for generic infiniband code, with exception of the mthca driver. - Add new manual page, mlx4en(4), describing how to configure and load mlx4en. - All relevant driver C-files are now prefixed mlx4, mlx4_en and mlx4_ib respectivly to avoid object filename collisions when compiling the kernel. This also fixes an issue with proper dependency file generation for the C-files in question. - Device mlxen is now device mlx4en and depends on device mlx4, see mlx4en(4). Only the network device name remains unchanged. - The mlx4 and mlx4en modules are now built by default on i386 and amd64 targets. Only building the mlx4ib module depends on WITH_OFED=YES . Sponsored by: Mellanox Technologies
2016-09-30 08:23:06 +00:00
.Xr ifconfig 8
.Sh HISTORY
The
.Nm
device driver first appeared in
.Fx 9.x .
.Sh AUTHORS
.An -nosplit
The
.Nm
driver was written by
.An Mellanox Technologies <freebsd-drivers@mellanox.com> .
Reference in New Issue Copy Permalink