Lines Matching +full:- +full:- +full:enable +full:- +full:debug

2 .\" SPDX-License-Identifier: BSD-3-Clause
4 .\" Copyright (c) 2019-2020, Intel Corporation
51 .Cd hw.ice.debug.enable_tx_fc_filter
52 .Cd hw.ice.debug.enable_tx_lldp_filter
53 .Cd hw.ice.debug.ice_tx_balance_en
73 .Bl -bullet -compact
91 .Sx Link-Level Flow Control
101 .Sx Debug Dump
113 .Sx Optics and auto-negotiation
115 .Sx PCI-Express Slot Bandwidth
236 To use RDMA monitoring, more MSI-X interrupts may need to be reserved.
241 .Bd -literal -offset indent
245 The number of extra MSI-X interrupt vectors may need to be adjusted.
248 .Bd -literal -offset indent
258 .Bd -literal -offset indent
282 .Bl -bullet -compact
284 Firmware-based LLDP Agent
286 Software-based LLDP Agent
289 In firmware-based mode, firmware intercepts all LLDP traffic and handles DCBX
299 In software-based mode, LLDP traffic is forwarded to the network stack and user
304 This mode requires the FW-based LLDP Agent to be disabled.
306 Firmware-based mode and software-based mode are controlled by the
312 Link-level flow control and priority flow control are mutually exclusive.
317 To enable/disable priority flow control in software-based DCBX mode:
318 .Bd -literal -offset indent
325 .Bd -literal -offset indent
333 .Bd -literal -offset indent
341 .Bd -literal -offset indent
347 driver supports setting DSCP-based Layer 3 Quality of Service (L3 QoS)
351 Use the following sysctl to enable or disable L3 QoS:
352 .Bd -literal -offset indent
359 For example, to map DSCPs 0-3 and DSCP 8 to DCB TCs 0-3 and 4, respectively:
360 .Bd -literal -offset indent
361 sysctl dev.ice.<interface #>.dscp2tc_map.0-7=0,1,2,3,0,0,0,0
362 sysctl dev.ice.<interface #>.dscp2tc_map.8-15=4,0,0,0,0,0,0,0
369 .Bd -literal -offset indent
373 L3 QoS mode is not available when FW-LLDP is enabled.
375 FW-LLDP cannot be enabled if L3 QoS mode is active.
377 Disable FW-LLDP before switching to L3 QoS mode.
381 section in this README for more information on disabling FW-LLDP.
383 Use sysctl to change FW-LLDP settings.
384 The FW-LLDP setting is per port and persists across boots.
386 To enable the FW-LLDP Agent:
387 .Bd -literal -offset indent
391 To disable the FW-LLDP Agebt:
392 .Bd -literal -offset indent
397 .Bd -literal -offset indent
405 attribute is set to disabled, the FW-LLDP Agent cannot be enabled from the
407 .Ss Link-Level Flow Control
412 to enable receiving and transmitting pause frames for
423 .Bd -literal -offset indent
428 .Bd -literal -offset indent
430 1 = Enable Rx pause
431 2 = Enable Tx pause
432 3 = Enable Rx and Tx pause
470 .Bd -literal -offset indent
478 .Bd -literal -offset indent
483 .Bd -literal -offset indent
488 .Bd -literal -offset indent
489 sysctl -d dev.ice.<interface #>.requested_fec
494 To have the device change the speeds it will use in auto-negotiation or
496 .Bd -literal -offset indent
503 .Bd -literal -offset indent
504 0x0 - Auto
505 0x2 - 100 Mbps
506 0x4 - 1 Gbps
507 0x8 - 2.5 Gbps
508 0x10 - 5 Gbps
509 0x20 - 10 Gbps
510 0x80 - 25 Gbps
511 0x100 - 40 Gbps
512 0x200 - 50 Gbps
513 0x400 - 100 Gbps
514 0x800 - 200 Gbps
525 .Bd -literal -offset indent
532 events, to help debug issues with Customer Support.
538 .Bl -enum -compact
550 Work with Customer Support to debug the issue.
555 Information collected is related only to firmware and hardware for debug
560 sysctl node under the debug section of the driver's sysctl list.
565 .Bl -tag -offset indent -compact -width "task_dispatch"
593 XLR (function-level resets; Bit 13)
601 Intel On-Chip System Fabric (Bit 17)
640 .Bl -item -offset indent -compact
655 .Bd -literal -offset indent
656 sysctl dev.ice.<interface #>.debug.fw_log.severity.<module>=<level>
660 .Bd -literal -offset indent
661 sysctl dev.ice.0.debug.fw_log.severity.link=1
662 sysctl dev.ice.0.debug.fw_log.severity.link_topo=2
663 sysctl dev.ice.0.debug.fw_log.register=1
674 .Bd -literal -offset indent
675 kenv dev.ice.0.debug.fw_log.severity.link=1
676 kenv dev.ice.0.debug.fw_log.severity.link_topo=2
677 kenv dev.ice.0.debug.fw_log.on_load=1
682 .Bd -literal -offset indent
687 add extraneous messages to dmesg and could hinder debug efforts.
688 .Ss Debug Dump
689 Intel Ethernet 800 Series devices support debug dump,
695 This debug dump contains a snapshot of the device and its existing hardware
698 Debug dump captures the current state of the specified cluster(s) and is a
701 NOTE: Like with firmware logs, the contents of the debug dump are not
702 human-readable.
705 Debug dump is per device, not per PF.
707 Debug dump writes all information to a single file.
709 To generate a debug dump file in
715 .Bd -literal -offset indent
716 sysctl dev.ice.<interface #>.debug.dump.clusters=<bitmask>
724 .Bd -literal -offset indent
725 sysctl -d dev.ice.0.debug.dump.clusters
731 .Bl -bullet -compact
733 0 - Dump all clusters (only supported on Intel Ethernet E810 Series and
736 0x1 - Switch
738 0x2 - ACL
740 0x4 - Tx Scheduler
742 0x8 - Profile Configuration
744 0x20 - Link
746 0x80 - DCB
748 0x100 - L2P
750 0x400000 - Manageability Transactions (only supported on Intel Ethernet
755 .Bd -literal -offset indent
756 sysctl dev.ice.0.debug.dump.clusters=0x181
760 .Bd -literal -offset indent
761 sysctl dev.ice.0.debug.dump.clusters=0
768 Issue the debug dump command, using the following:
769 .Bd -literal -offset indent
770 sysctl -b dev.ice.<interface #>.debug.dump.dump=1 > dump.bin
782 mask before a subsequent debug dump and then do the dump:
783 .Bd -literal -offset indent
784 sysctl dev.ice.0.debug.dump.clusters=0
785 sysctl dev.ice.0.debug.dump.dump=1
789 from Intel(R) Ethernet 810 Series devices in order to debug link and
793 .Bl -bullet
801 .Bd -literal -offset indent
802 sysctl dev.ice.<interface #>.debug.phy_statistics
805 NOTE: The contents of the registers are not human-readable.
806 Like with firmware logs and debug dump, work with Customer Support
815 To enable this feature, use one of the following to persistently change the
817 .Bl -bullet
819 Use the Ethernet Port Configuration Tool (EPCT) to enable the
824 Enable the Transmit Balancing device setting in UEFI HII.
837 enable the feature.
841 .Bd -literal -offset indent
849 Check to see if the system is mbuf-starved by running
853 .Bd -literal -offset indent
866 .Bd -literal -offset indent
879 .Bl -bullet
881 To change the behavior of the QSFP28 ports on E810-C adapters, use the Intel
882 .Sy Ethernet Port Configuration Tool - FreeBSD .
885 .Sy Non-Volatile Memory (NVM) Update Utility for Intel Ethernet Network Adapters E810 series - Free…
887 .Ss Optics and auto-negotiation
888 Modules based on 100GBASE-SR4,
890 do not support auto-negotiation per the IEEE specification.
892 auto-negotiation must be turned off on the link partner's switch ports.
896 that comply with SFF-8431 v4.1 and SFF-8472 v10.4 specifications.
897 .Ss PCI-Express Slot Bandwidth
902 if a PCIe v4.0 or v3.0-capable adapter is placed into into a PCIe v2.x
907 .Bd -ragged -offset indent
908 PCI-Express bandwidth available for this device
910 Please move the device to a different PCI-e link
917 .Bl -bullet
919 Any 100Gbps-capable Intel(R) Ethernet 800 Series device: Install in a
922 A 200Gbps-capable Intel(R) Ethernet 830 Series device: Install in a
934 .Bl -bullet -compact
936 Intel Ethernet Controller E810-C
938 Intel Ethernet Controller E810-XXV
940 Intel Ethernet Connection E822-C
942 Intel Ethernet Connection E822-L
944 Intel Ethernet Connection E823-C
946 Intel Ethernet Connection E823-L
948 Intel Ethernet Connection E825-C
950 Intel Ethernet Connection E830-C
952 Intel Ethernet Connection E830-CC
954 Intel Ethernet Connection E830-L
956 Intel Ethernet Connection E830-XXV
958 Intel Ethernet Connection E835-C
960 Intel Ethernet Connection E835-CC
962 Intel Ethernet Connection E835-L
964 Intel Ethernet Connection E835-XXV
978 .Bl -bullet -compact
980 Intel 100G QSFP28 100GBASE-SR4   E100GQSFPSR28SRX
982 Intel 100G QSFP28 100GBASE-SR4   SPTMBP1PMCDF
984 Intel 100G QSFP28 100GBASE-CWDM4 SPTSBP3CLCCO
986 Intel 100G QSFP28 100GBASE-DR    SPTSLP2SLCDF
993 .Bl -bullet -compact
995 Intel 10G/25G SFP28 25GBASE-SR E25GSFP28SR
997 Intel     25G SFP28 25GBASE-SR E25GSFP28SRX (Extended Temp)
999 Intel     25G SFP28 25GBASE-LR E25GSFP28LRX (Extended Temp)
1006 .Bl -bullet -compact
1008 Intel 1G/10G SFP+ 10GBASE-SR E10GSFPSR
1010 Intel 1G/10G SFP+ 10GBASE-SR E10GSFPSRG1P5
1012 Intel 1G/10G SFP+ 10GBASE-SR E10GSFPSRG2P5
1014 Intel    10G SFP+ 10GBASE-SR E10GSFPSRX (Extended Temp)
1016 Intel 1G/10G SFP+ 10GBASE-LR E10GSFPLR
1026 .Bl -tag -width indent
1028 Set to 1 to enable firmware health event reporting across all devices.
1035 Set to 1 to enable the RDMA client interface, required by the
1040 Set the maximum number of per-device MSI-X vectors that are allocated for use
1045 .It Va hw.ice.debug.enable_tx_fc_filter
1046 Set to 1 to enable the TX Flow Control filter across all devices.
1051 .It Va hw.ice.debug.enable_tx_lldp_filter
1052 Set to 1 to enable the TX LLDP filter across all devices.
1059 .It Va hw.ice.debug.ice_tx_balance_en
1060 Set to 1 to allow the driver to use the 5-layer Tx Scheduler tree topology if
1066 .Bl -tag -width indent
1069 This is expected to match the speed of the media type in-use displayed by
1095 .Bl -tag -width indent
1096 .It mac-addr Pq unicast-mac
1099 .Dq allow-set-mac
1101 .It mac-anti-spoof Pq bool
1105 .It allow-set-mac Pq bool
1108 .It allow-promisc Pq bool
1112 .It num-queues Pq uint16_t
1114 By default, this is set to the number of MSI-X vectors supported by the VF
1116 .It mirror-src-vsi Pq uint16_t
1118 other than -1.
1125 .Dq allow-promisc
1127 .It max-vlan-allowed Pq uint16_t
1133 .It max-mac-filters Pq uint16_t