[PATCH iwl-next,v1 1/3] igc: Add documentation

From: Song Yoong Siang
Date: Mon Jul 29 2024 - 21:23:57 EST


From: Blanco Alcaine Hector <hector.blanco.alcaine@xxxxxxxxx>

This commit adds the documentation file for the Intel Ethernet Network
Controller I225 and I226 driver. The documentation includes:
- Identifying Your Adapter
- Command Line Parameters
- Additional Configurations
- Support
- Trademarks

The file provides detailed information on how to identify the adapter, use
command line parameters, configure additional features, and obtain support.

Signed-off-by: Blanco Alcaine Hector <hector.blanco.alcaine@xxxxxxxxx>
Signed-off-by: Song Yoong Siang <yoong.siang.song@xxxxxxxxx>
---
.../device_drivers/ethernet/index.rst | 1 +
.../device_drivers/ethernet/intel/igc.rst | 82 +++++++++++++++++++
2 files changed, 83 insertions(+)
create mode 100644 Documentation/networking/device_drivers/ethernet/intel/igc.rst

diff --git a/Documentation/networking/device_drivers/ethernet/index.rst b/Documentation/networking/device_drivers/ethernet/index.rst
index 6932d8c043c2..2b1dbb984f98 100644
--- a/Documentation/networking/device_drivers/ethernet/index.rst
+++ b/Documentation/networking/device_drivers/ethernet/index.rst
@@ -35,6 +35,7 @@ Contents:
intel/idpf
intel/igb
intel/igbvf
+ intel/igc
intel/ixgbe
intel/ixgbevf
intel/i40e
diff --git a/Documentation/networking/device_drivers/ethernet/intel/igc.rst b/Documentation/networking/device_drivers/ethernet/intel/igc.rst
new file mode 100644
index 000000000000..08b2cfacc7c0
--- /dev/null
+++ b/Documentation/networking/device_drivers/ethernet/intel/igc.rst
@@ -0,0 +1,82 @@
+.. SPDX-License-Identifier: GPL-2.0+
+
+========================================================================
+Linux Base Driver for Intel(R) Ethernet Network Controller I225 and I226
+========================================================================
+
+Intel igc Linux driver.
+Copyright(c) 1999-2024 Intel Corporation.
+
+
+Contents
+========
+- Identifying Your Adapter
+- Command Line Parameters
+- Additional Configurations
+- Support
+- Trademarks
+
+
+Identifying Your Adapter
+========================
+For information on how to identify your adapter, and for the latest Intel
+network drivers, refer to the Intel Support website:
+https://www.intel.com/support
+
+
+Command Line Parameters
+========================
+If the driver is built as a module, the following optional parameters are used
+by entering them on the command line with the modprobe command using this
+syntax::
+
+ modprobe igc [<option>=<VAL1>]
+
+NOTE: A descriptor describes a data buffer and attributes related to the data
+buffer. This information is accessed by the hardware.
+
+Debug
+-----
+:Valid Range: 0-16 (0=none,...,16=all)
+:Default Value: 0
+
+This parameter adjusts the level debug messages displayed in the system logs.
+
+
+Additional Features and Configurations
+======================================
+Time-Sensitive Networking
+-------------------------
+Selected models of Intel(R) Ethernet Controller I225 and Intel(R) Ethernet
+Controller I226 support Time-Sensitive Networking features. For more details
+about the features and supported models, please refer to:
+https://www.intel.com/content/www/us/en/support/articles/000096004/ethernet-products/gigabit-ethernet-controllers-up-to-2-5gbe.html
+
+For instructions about configuring Time-Sensitive Networking features on Linux,
+please refer to:
+https://tsn.readthedocs.io/
+
+ethtool
+-------
+The driver utilizes the ethtool interface for driver configuration and
+diagnostics, as well as displaying statistical information. The latest ethtool
+version is required for this functionality. Download it at:
+https://www.kernel.org/pub/software/network/ethtool/
+
+
+Support
+=======
+For general information, go to the Intel support website at:
+https://www.intel.com/support/
+
+If an issue is identified with the released source code on a supported kernel
+with a supported adapter, email the specific information related to the issue
+to intel-wired-lan@xxxxxxxxxxxxxxxx
+
+
+Trademarks
+==========
+Intel is a trademark or registered trademark of Intel Corporation or its
+subsidiaries in the United States and/or other countries.
+
+* Other names and brands may be claimed as the property of others.
--
2.34.1