Changeset View
Changeset View
Standalone View
Standalone View
share/man/man4/em.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 January 30, 2019 | .Dd May 8, 2023 | ||||
.Dt EM 4 | .Dt EM 4 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm em | .Nm em | ||||
.Nd "Intel(R) PRO/1000 Gigabit Ethernet adapter driver" | .Nd "Intel(R) PRO/1000 Gigabit Ethernet adapter driver" | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
To compile this driver into the kernel, | To compile this driver into the kernel, | ||||
place the following lines in your | place the following lines in your | ||||
▲ Show 20 Lines • Show All 167 Lines • ▼ Show 20 Lines | |||||
.It | .It | ||||
Intel PRO/1000 XT Server Adapter (82544) | Intel PRO/1000 XT Server Adapter (82544) | ||||
.El | .El | ||||
.Sh LOADER TUNABLES | .Sh LOADER TUNABLES | ||||
Tunables can be set at the | Tunables can be set at the | ||||
.Xr loader 8 | .Xr loader 8 | ||||
prompt before booting the kernel or stored in | prompt before booting the kernel or stored in | ||||
.Xr loader.conf 5 . | .Xr loader.conf 5 . | ||||
See | |||||
.Xr iflib 4 | |||||
for per-instance variables. | |||||
.Bl -tag -width indent | .Bl -tag -width indent | ||||
.It Va hw.em.disable_crc_stripping | .It Va hw.em.disable_crc_stripping | ||||
Disable or enable hardware stripping of CRC field. | Disable or enable hardware stripping of CRC field. | ||||
This is mostly useful on BMC/IPMI shared interfaces where stripping the CRC | This is mostly useful on BMC/IPMI shared interfaces where stripping the CRC | ||||
causes remote access over IPMI to fail. | causes remote access over IPMI to fail. | ||||
Default 0 (enabled). | Default 0 (enabled). | ||||
.It Va hw.em.eee_setting | .It Va hw.em.eee_setting | ||||
Disable or enable Energy Efficient Ethernet. | Disable or enable Energy Efficient Ethernet. | ||||
Default 1 (disabled). | Default 1 (disabled). | ||||
.It Va hw.em.msix | |||||
Enable or disable MSI-X style interrupts. | |||||
Default 1 (enabled). | |||||
.It Va hw.em.smart_pwr_down | .It Va hw.em.smart_pwr_down | ||||
Enable or disable smart power down features on newer adapters. | Enable or disable smart power down features on newer adapters. | ||||
Default 0 (disabled). | Default 0 (disabled). | ||||
.It Va hw.em.sbp | .It Va hw.em.sbp | ||||
Show bad packets when in promiscuous mode. | Show bad packets when in promiscuous mode. | ||||
Default 0 (off). | Default 0 (off). | ||||
.It Va hw.em.rxd | |||||
Number of receive descriptors allocated by the driver. | |||||
The default value is 1024 for adapters newer than 82547, | |||||
and 256 for older ones. | |||||
The 82542 and 82543-based adapters can handle up to 256 descriptors, | |||||
while others can have up to 4096. | |||||
.It Va hw.em.txd | |||||
Number of transmit descriptors allocated by the driver. | |||||
The default value is 1024 for adapters newer than 82547, | |||||
and 256 for older ones. | |||||
The 82542 and 82543-based adapters can handle up to 256 descriptors, | |||||
while others can have up to 4096. | |||||
.It Va hw.em.rx_int_delay | .It Va hw.em.rx_int_delay | ||||
This value delays the generation of receive interrupts in units of | This value delays the generation of receive interrupts in units of | ||||
1.024 microseconds. | 1.024 microseconds. | ||||
The default value is 0, since adapters may hang with this feature | The default value is 0, since adapters may hang with this feature | ||||
being enabled. | being enabled. | ||||
.It Va hw.em.rx_abs_int_delay | .It Va hw.em.rx_abs_int_delay | ||||
If | If | ||||
.Va hw.em.rx_int_delay | .Va hw.em.rx_int_delay | ||||
is non-zero, this tunable limits the maximum delay in which a receive | is non-zero, this tunable limits the maximum delay in which a receive | ||||
interrupt is generated. | interrupt is generated. | ||||
.It Va hw.em.tx_int_delay | .It Va hw.em.tx_int_delay | ||||
This value delays the generation of transmit interrupts in units of | This value delays the generation of transmit interrupts in units of | ||||
1.024 microseconds. | 1.024 microseconds. | ||||
The default value is 64. | The default value is 64. | ||||
.It Va hw.em.tx_abs_int_delay | .It Va hw.em.tx_abs_int_delay | ||||
If | If | ||||
.Va hw.em.tx_int_delay | .Va hw.em.tx_int_delay | ||||
is non-zero, this tunable limits the maximum delay in which a transmit | is non-zero, this tunable limits the maximum delay in which a transmit | ||||
interrupt is generated. | interrupt is generated. | ||||
.It Va hw.em.max_interrupt_rate | |||||
Maximum interrupts per second. | |||||
The default value is 8000. | |||||
.It Va hw.em.rx_process_limit | |||||
Maximum number of received packets to process at a time, -1 means unlimited. | |||||
The default value is 100. | |||||
.El | .El | ||||
.Sh FILES | .Sh FILES | ||||
.Bl -tag -width /dev/led/em* | .Bl -tag -width /dev/led/em* | ||||
.It Pa /dev/led/em* | .It Pa /dev/led/em* | ||||
identification LED device nodes | identification LED device nodes | ||||
.El | .El | ||||
.Sh EXAMPLES | .Sh EXAMPLES | ||||
Make the identification LED of em0 blink: | Make the identification LED of em0 blink: | ||||
▲ Show 20 Lines • Show All 53 Lines • Show Last 20 Lines |