Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ICE(4)			    Kernel Interfaces Manual			ICE(4)

NAME
       ice -- Intel Ethernet 800 Series	Driver

SYNOPSIS
       To  compile  this  driver into the kernel, place	the following lines in
       your kernel configuration file:

	     device iflib
	     device ice

       To load the driver as a module at boot time, place the following	 lines
       in loader.conf(5):

	     if_ice_load="YES"

DESCRIPTION
   Features
       The ice driver provides support for any PCI Express adapter or LOM (LAN
       On  Motherboard)	in the Intel Ethernet 800 Series.  As of this writing,
       the series includes devices with	these model numbers:

          Intel(R) Ethernet Controller	E810-C
          Intel(R) Ethernet Controller	E810-XXV
          Intel(R) Ethernet Connection	E822-C
          Intel(R) Ethernet Connection	E822-L
          Intel(R) Ethernet Connection	E823-C
          Intel(R) Ethernet Connection	E823-L

       For questions related to	hardware requirements, refer to	the documenta-
       tion supplied with your adapter.

       Support for Jumbo Frames	is provided via	 the  interface	 MTU  setting.
       Selecting  an  MTU  larger than 1500 bytes with the ifconfig(8) utility
       configures the adapter to receive and transmit Jumbo Frames.  The maxi-
       mum MTU size for	Jumbo Frames is	9706.  This value coincides  with  the
       maximum Jumbo Frame size	of 9728.

       This driver version supports VLANs.  For	information on enabling	VLANs,
       see the README.

       Offloads	are also controlled via	the interface, for instance, checksum-
       ming for	both IPv4 and IPv6 can be set and unset, TSO4 and/or TSO6, and
       finally LRO can be set and unset.

       For more	information on configuring this	device,	see ifconfig(8).

   Additional Utilities
       There  are  additional tools available from Intel to help configure and
       update the adapters covered by this driver.  These tools	can  be	 down-
       loaded  directly	 from  Intel  at  https://downloadcenter.intel.com, by
       searching for their names, or by	installing certain packages:

          To change the behavior of the QSFP28	ports on E810-C	adapters,  use
	   the Intel EPCT (Ethernet Port configuration tool); installed	by the
	   sysutils/intel-epct package.

          To  update  the  firmware on	an adapter, use	the Intel Non-Volatile
	   Memory (NVM)	Update Utility for Intel Network Adapter  800  series;
	   installed by	the sysutils/intel-nvmupdate-100g package.

HARDWARE
       The  ice	 driver	supports the Intel Ethernet 800	series.	 Most adapters
       in this series with SFP28/QSFP28	cages have firmware that requires that
       Intel qualified modules are used; these qualified  modules  are	listed
       below.  This qualification check	cannot be disabled by the driver.

       The  ice	driver supports	100Gb Ethernet adapters	with these QSFP28 mod-
       ules:

          Intel(R) 100G QSFP28	100GBASE-SR4   E100GQSFPSR28SRX
          Intel(R) 100G QSFP28	100GBASE-SR4   SPTMBP1PMCDF
          Intel(R) 100G QSFP28	100GBASE-CWDM4 SPTSBP3CLCCO
          Intel(R) 100G QSFP28	100GBASE-DR    SPTSLP2SLCDF

       The ice driver supports 25Gb and	 10Gb  Ethernet	 adapters  with	 these
       SFP28 modules:

          Intel(R) 10G/25G SFP28 25GBASE-SR E25GSFP28SR
          Intel(R)	25G SFP28 25GBASE-SR E25GSFP28SRX (Extended Temp)
          Intel(R)	25G SFP28 25GBASE-LR E25GSFP28LRX (Extended Temp)

       The  ice	driver supports	10Gb and 1Gb Ethernet adapters with these SFP+
       modules:

          Intel(R) 1G/10G SFP+	10GBASE-SR E10GSFPSR
          Intel(R) 1G/10G SFP+	10GBASE-SR E10GSFPSRG1P5
          Intel(R) 1G/10G SFP+	10GBASE-SR E10GSFPSRG2P5
          Intel(R)    10G SFP+	10GBASE-SR E10GSFPSRX (Extended	Temp)
          Intel(R) 1G/10G SFP+	10GBASE-LR E10GSFPLR

       Note that adapters also support all passive and active limiting	direct
       attach  cables that comply with SFF-8431	v4.1 and SFF-8472 v10.4	speci-
       fications.

       This is not an exhaustive list; please  consult	product	 documentation
       for an up-to-date list of supported media.

LOADER TUNABLES
       Tunables	 can  be set at	the loader(8) prompt before booting the	kernel
       or stored in loader.conf(5).  See the iflib(4) man page for more	infor-
       mation on using iflib sysctl variables as tunables.

       hw.ice.#.enable_health_events
	       TBW

       hw.ice.#.debug.enable_tx_fc_filter
	       TBW

       hw.ice.#.debug.enable_tx_lldp_filter
	       TBW

       hw.ice.#.debug.enable_health_events
	       TBW

SYSCTL PROCEDURES
       dev.ice.#.fc
	       Allows one to set the flow control value.  A value  of  0  dis-
	       ables flow control, 3 enables full, 1 is	RX, and	2 is TX	pause.

       dev.ice.#.advertise_speed
	       Allows  one to set advertised link speeds, this will then cause
	       a link renegotiation.

       dev.ice.#.current_speed
	       This is a display of the	current	setting.

       dev.ice.#.fw_version
	       Displays	the current firmware and NVM versions of the adapter.

       dev.ice.#.ddp_version
	       TBW

       dev.ice.#.requested_fec
	       TBW

       dev.ice.#.negotiated_fec
	       TBW

       dev.ice.#.fw_lldp_agent
	       TBW

       dev.ice.#.ets_min_rate
	       TBW

       dev.ice.#.up2tc_map
	       TBW

       dev.ice.#.pfc
	       TBW

INTERRUPT STORMS
       It is important to note that 100G operation can generate	 high  numbers
       of interrupts, often incorrectly	being interpreted as a storm condition
       in  the	kernel.	  It  is  suggested  that  this	be resolved by setting
       hw.intr_storm_threshold to 0.

SUPPORT
       For general information and support, go to the  Intel  support  website
       at: http://www.intel.com/support/.

       If  an  issue  is identified with this driver with a supported adapter,
       email  all  the	specific  information  related	 to   the   issue   to
       <freebsd@intel.com>.

SEE ALSO
       arp(4), iflib(4), netintro(4), ng_ether(4), vlan(4), ifconfig(8)

HISTORY
       The ice device driver first appeared in FreeBSD 12.2.

AUTHORS
       The ice driver was written by Intel Corporation <freebsd@intel.com>.

FreeBSD	13.2			 May 20, 2024				ICE(4)

NAME | SYNOPSIS | DESCRIPTION | HARDWARE | LOADER TUNABLES | SYSCTL PROCEDURES | INTERRUPT STORMS | SUPPORT | SEE ALSO | HISTORY | AUTHORS

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=ice&sektion=4&manpath=FreeBSD+14.2-RELEASE+and+Ports>

home | help