Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/962636/?format=api
{ "id": 962636, "url": "http://patchwork.ozlabs.org/api/patches/962636/?format=api", "web_url": "http://patchwork.ozlabs.org/project/intel-wired-lan/patch/20180827210640.11543-1-jeffrey.t.kirsher@intel.com/", "project": { "id": 46, "url": "http://patchwork.ozlabs.org/api/projects/46/?format=api", "name": "Intel Wired Ethernet development", "link_name": "intel-wired-lan", "list_id": "intel-wired-lan.osuosl.org", "list_email": "intel-wired-lan@osuosl.org", "web_url": "", "scm_url": "", "webscm_url": "", "list_archive_url": "", "list_archive_url_format": "", "commit_url_format": "" }, "msgid": "<20180827210640.11543-1-jeffrey.t.kirsher@intel.com>", "list_archive_url": null, "date": "2018-08-27T21:06:40", "name": "[v2] Documentation: igb: Update kernel documentation", "commit_ref": null, "pull_url": null, "state": "changes-requested", "archived": false, "hash": "ddaff398d830006cc6c5e218f13caac61a49a126", "submitter": { "id": 473, "url": "http://patchwork.ozlabs.org/api/people/473/?format=api", "name": "Kirsher, Jeffrey T", "email": "jeffrey.t.kirsher@intel.com" }, "delegate": { "id": 68, "url": "http://patchwork.ozlabs.org/api/users/68/?format=api", "username": "jtkirshe", "first_name": "Jeff", "last_name": "Kirsher", "email": "jeffrey.t.kirsher@intel.com" }, "mbox": "http://patchwork.ozlabs.org/project/intel-wired-lan/patch/20180827210640.11543-1-jeffrey.t.kirsher@intel.com/mbox/", "series": [ { "id": 62718, "url": "http://patchwork.ozlabs.org/api/series/62718/?format=api", "web_url": "http://patchwork.ozlabs.org/project/intel-wired-lan/list/?series=62718", "date": "2018-08-27T21:06:40", "name": "[v2] Documentation: igb: Update kernel documentation", "version": 2, "mbox": "http://patchwork.ozlabs.org/series/62718/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/962636/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/962636/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<intel-wired-lan-bounces@osuosl.org>", "X-Original-To": [ "incoming@patchwork.ozlabs.org", "intel-wired-lan@lists.osuosl.org" ], "Delivered-To": [ "patchwork-incoming@bilbo.ozlabs.org", "intel-wired-lan@lists.osuosl.org" ], "Authentication-Results": [ "ozlabs.org;\n\tspf=pass (mailfrom) smtp.mailfrom=osuosl.org\n\t(client-ip=140.211.166.136; helo=silver.osuosl.org;\n\tenvelope-from=intel-wired-lan-bounces@osuosl.org;\n\treceiver=<UNKNOWN>)", "ozlabs.org;\n\tdmarc=fail (p=none dis=none) header.from=intel.com" ], "Received": [ "from silver.osuosl.org (smtp3.osuosl.org [140.211.166.136])\n\t(using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits))\n\t(No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 41zkw95YCRz9s47\n\tfor <incoming@patchwork.ozlabs.org>;\n\tTue, 28 Aug 2018 07:06:49 +1000 (AEST)", "from localhost (localhost [127.0.0.1])\n\tby silver.osuosl.org (Postfix) with ESMTP id 8E697226B2;\n\tMon, 27 Aug 2018 21:06:47 +0000 (UTC)", "from silver.osuosl.org ([127.0.0.1])\n\tby localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024)\n\twith ESMTP id K8SubflBDz8B; Mon, 27 Aug 2018 21:06:45 +0000 (UTC)", "from ash.osuosl.org (ash.osuosl.org [140.211.166.34])\n\tby silver.osuosl.org (Postfix) with ESMTP id 60A95226A9;\n\tMon, 27 Aug 2018 21:06:45 +0000 (UTC)", "from whitealder.osuosl.org (smtp1.osuosl.org [140.211.166.138])\n\tby ash.osuosl.org (Postfix) with ESMTP id 5B9641C2827\n\tfor <intel-wired-lan@lists.osuosl.org>;\n\tMon, 27 Aug 2018 21:06:44 +0000 (UTC)", "from localhost (localhost [127.0.0.1])\n\tby whitealder.osuosl.org (Postfix) with ESMTP id 57DB9848A3\n\tfor <intel-wired-lan@lists.osuosl.org>;\n\tMon, 27 Aug 2018 21:06:44 +0000 (UTC)", "from whitealder.osuosl.org ([127.0.0.1])\n\tby localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024)\n\twith ESMTP id zEyt29qIsJ3X for <intel-wired-lan@lists.osuosl.org>;\n\tMon, 27 Aug 2018 21:06:43 +0000 (UTC)", "from mga06.intel.com (mga06.intel.com [134.134.136.31])\n\tby whitealder.osuosl.org (Postfix) with ESMTPS id 42F678489C\n\tfor <intel-wired-lan@lists.osuosl.org>;\n\tMon, 27 Aug 2018 21:06:43 +0000 (UTC)", "from fmsmga007.fm.intel.com ([10.253.24.52])\n\tby orsmga104.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t27 Aug 2018 14:06:42 -0700", "from jtkirshe-desk1.jf.intel.com ([134.134.177.59])\n\tby fmsmga007.fm.intel.com with ESMTP; 27 Aug 2018 14:06:42 -0700" ], "X-Virus-Scanned": [ "amavisd-new at osuosl.org", "amavisd-new at osuosl.org" ], "X-Greylist": "domain auto-whitelisted by SQLgrey-1.7.6", "X-Amp-Result": "SKIPPED(no attachment in message)", "X-Amp-File-Uploaded": "False", "X-ExtLoop1": "1", "X-IronPort-AV": "E=Sophos;i=\"5.53,296,1531810800\"; d=\"scan'208\";a=\"65619251\"", "From": "Jeff Kirsher <jeffrey.t.kirsher@intel.com>", "To": "intel-wired-lan@lists.osuosl.org", "Date": "Mon, 27 Aug 2018 14:06:40 -0700", "Message-Id": "<20180827210640.11543-1-jeffrey.t.kirsher@intel.com>", "X-Mailer": "git-send-email 2.17.1", "Subject": "[Intel-wired-lan] [PATCH v2] Documentation: igb: Update kernel\n\tdocumentation", "X-BeenThere": "intel-wired-lan@osuosl.org", "X-Mailman-Version": "2.1.24", "Precedence": "list", "List-Id": "Intel Wired Ethernet Linux Kernel Driver Development\n\t<intel-wired-lan.osuosl.org>", "List-Unsubscribe": "<https://lists.osuosl.org/mailman/options/intel-wired-lan>, \n\t<mailto:intel-wired-lan-request@osuosl.org?subject=unsubscribe>", "List-Archive": "<http://lists.osuosl.org/pipermail/intel-wired-lan/>", "List-Post": "<mailto:intel-wired-lan@osuosl.org>", "List-Help": "<mailto:intel-wired-lan-request@osuosl.org?subject=help>", "List-Subscribe": "<https://lists.osuosl.org/mailman/listinfo/intel-wired-lan>, \n\t<mailto:intel-wired-lan-request@osuosl.org?subject=subscribe>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=\"us-ascii\"", "Content-Transfer-Encoding": "7bit", "Errors-To": "intel-wired-lan-bounces@osuosl.org", "Sender": "\"Intel-wired-lan\" <intel-wired-lan-bounces@osuosl.org>" }, "content": "Updated the igb kernel documentation with the latest information.\nCleaned up the command line parameters, which do not exist with the\nin-kernel driver. Converted the documentation to the RST format.\n\nSigned-off-by: Jeff Kirsher <jeffrey.t.kirsher@intel.com>\n---\nv1: Initial documentation update\n\nv2: Convert to RST format and clean up command line parameters that do\n not exist\n\n Documentation/networking/igb.rst | 188 +++++++++++++++++++++++++++++\n Documentation/networking/igb.txt | 129 --------------------\n Documentation/networking/index.rst | 1 +\n MAINTAINERS | 2 +-\n drivers/net/ethernet/intel/Kconfig | 2 +-\n 5 files changed, 191 insertions(+), 131 deletions(-)\n create mode 100644 Documentation/networking/igb.rst\n delete mode 100644 Documentation/networking/igb.txt", "diff": "diff --git a/Documentation/networking/igb.rst b/Documentation/networking/igb.rst\nnew file mode 100644\nindex 000000000000..7a2b14af727f\n--- /dev/null\n+++ b/Documentation/networking/igb.rst\n@@ -0,0 +1,188 @@\n+.. SPDX-License-Identifier: GPL-2.0+\n+\n+Linux* Base Driver for Intel(R) Ethernet Network Connection\n+===========================================================\n+\n+Intel Gigabit Linux driver.\n+Copyright(c) 1999-2018 Intel Corporation.\n+\n+Contents\n+========\n+\n+- Identifying Your Adapter\n+- Command Line Parameters\n+- Additional Configurations\n+- Support\n+\n+\n+Identifying Your Adapter\n+========================\n+For information on how to identify your adapter, and for the latest Intel\n+network drivers, refer to the Intel Support website:\n+http://www.intel.com/support\n+\n+\n+Command Line Parameters\n+========================\n+If the driver is built as a module, the following optional parameters are used\n+by entering them on the command line with the modprobe command using this\n+syntax::\n+\n+ modprobe igb [<option>=<VAL1>,<VAL2>,...]\n+\n+There needs to be a <VAL#> for each network port in the system supported by\n+this driver. The values will be applied to each instance, in function order.\n+For example::\n+\n+ modprobe igb max_vfs=2,4\n+\n+In this case, there are two network ports supported by igb in the system.\n+The default value for each parameter is generally the recommended setting,\n+unless otherwise noted.\n+\n+NOTE: A descriptor describes a data buffer and attributes related to the data\n+buffer. This information is accessed by the hardware.\n+\n+max_vfs\n+-------\n+Valid Range: 0-7\n+\n+This parameter adds support for SR-IOV. It causes the driver to spawn up to\n+max_vfs worth of virtual functions. If the value is greater than 0 it will\n+also force the VMDq parameter to be 1 or more.\n+\n+The parameters for the driver are referenced by position. Thus, if you have a\n+dual port adapter, or more than one adapter in your system, and want N virtual\n+functions per port, you must specify a number for each port with each parameter\n+separated by a comma. For example::\n+\n+ modprobe igb max_vfs=4\n+\n+This will spawn 4 VFs on the first port.\n+\n+::\n+\n+ modprobe igb max_vfs=2,4\n+\n+This will spawn 2 VFs on the first port and 4 VFs on the second port.\n+\n+NOTE: Caution must be used in loading the driver with these parameters.\n+Depending on your system configuration, number of slots, etc., it is impossible\n+to predict in all cases where the positions would be on the command line.\n+\n+NOTE: Neither the device nor the driver control how VFs are mapped into config\n+space. Bus layout will vary by operating system. On operating systems that\n+support it, you can check sysfs to find the mapping.\n+\n+NOTE: When either SR-IOV mode or VMDq mode is enabled, hardware VLAN filtering\n+and VLAN tag stripping/insertion will remain enabled. Please remove the old\n+VLAN filter before the new VLAN filter is added. For example::\n+\n+ ip link set eth0 vf 0 vlan 100\t// set vlan 100 for VF 0\n+ ip link set eth0 vf 0 vlan 0\t// Delete vlan 100\n+ ip link set eth0 vf 0 vlan 200\t// set a new vlan 200 for VF 0\n+\n+\n+Additional Features and Configurations\n+======================================\n+\n+Jumbo Frames\n+------------\n+Jumbo Frames support is enabled by changing the Maximum Transmission Unit (MTU)\n+to a value larger than the default value of 1500.\n+\n+Use the ifconfig command to increase the MTU size. For example, enter the\n+following where <x> is the interface number::\n+\n+ ifconfig eth<x> mtu 9000 up\n+\n+Alternatively, you can use the ip command as follows::\n+\n+ ip link set mtu 9000 dev eth<x>\n+ ip link set up dev eth<x>\n+\n+This setting is not saved across reboots. The setting change can be made\n+permanent by adding 'MTU=9000' to the file:\n+\n+- For RHEL: /etc/sysconfig/network-scripts/ifcfg-eth<x>\n+- For SLES: /etc/sysconfig/network/<config_file>\n+\n+NOTE: The maximum MTU setting for Jumbo Frames is 9216. This value coincides\n+with the maximum Jumbo Frames size of 9234 bytes.\n+\n+NOTE: Using Jumbo frames at 10 or 100 Mbps is not supported and may result in\n+poor performance or loss of link.\n+\n+\n+ethtool\n+-------\n+The driver utilizes the ethtool interface for driver configuration and\n+diagnostics, as well as displaying statistical information. The latest ethtool\n+version is required for this functionality. Download it at:\n+\n+http://www.kernel.org/pub/software/network/ethtool/\n+\n+\n+Enabling Wake on LAN* (WoL)\n+---------------------------\n+WoL is configured through the ethtool* utility.\n+\n+WoL will be enabled on the system during the next shut down or reboot. For\n+this driver version, in order to enable WoL, the igb driver must be loaded\n+prior to shutting down or suspending the system.\n+\n+NOTE: Wake on LAN is only supported on port A of multi-port devices. Also\n+Wake On LAN is not supported for the following device:\n+- Intel(R) Gigabit VT Quad Port Server Adapter\n+\n+\n+Multiqueue\n+----------\n+In this mode, a separate MSI-X vector is allocated for each queue and one for\n+\"other\" interrupts such as link status change and errors. All interrupts are\n+throttled via interrupt moderation. Interrupt moderation must be used to avoid\n+interrupt storms while the driver is processing one interrupt. The moderation\n+value should be at least as large as the expected time for the driver to\n+process an interrupt. Multiqueue is off by default.\n+\n+REQUIREMENTS: MSI-X support is required for Multiqueue. If MSI-X is not found,\n+the system will fallback to MSI or to Legacy interrupts. This driver supports\n+receive multiqueue on all kernels that support MSI-X.\n+\n+NOTE: On some kernels a reboot is required to switch between single queue mode\n+and multiqueue mode or vice-versa.\n+\n+\n+MAC and VLAN anti-spoofing feature\n+----------------------------------\n+When a malicious driver attempts to send a spoofed packet, it is dropped by the\n+hardware and not transmitted.\n+\n+An interrupt is sent to the PF driver notifying it of the spoof attempt. When a\n+spoofed packet is detected, the PF driver will send the following message to\n+the system log (displayed by the \"dmesg\" command):\n+Spoof event(s) detected on VF(n), where n = the VF that attempted to do the\n+spoofing\n+\n+\n+Setting MAC Address, VLAN and Rate Limit Using IProute2 Tool\n+------------------------------------------------------------\n+You can set a MAC address of a Virtual Function (VF), a default VLAN and the\n+rate limit using the IProute2 tool. Download the latest version of the\n+IProute2 tool from Sourceforge if your version does not have all the features\n+you require.\n+\n+\n+Support\n+=======\n+For general information, go to the Intel support website at:\n+\n+https://www.intel.com/support/\n+\n+or the Intel Wired Networking project hosted by Sourceforge at:\n+\n+https://sourceforge.net/projects/e1000\n+\n+If an issue is identified with the released source code on a supported kernel\n+with a supported adapter, email the specific information related to the issue\n+to e1000-devel@lists.sf.net.\ndiff --git a/Documentation/networking/igb.txt b/Documentation/networking/igb.txt\ndeleted file mode 100644\nindex f90643ef39c9..000000000000\n--- a/Documentation/networking/igb.txt\n+++ /dev/null\n@@ -1,129 +0,0 @@\n-Linux* Base Driver for Intel(R) Ethernet Network Connection\n-===========================================================\n-\n-Intel Gigabit Linux driver.\n-Copyright(c) 1999 - 2013 Intel Corporation.\n-\n-Contents\n-========\n-\n-- Identifying Your Adapter\n-- Additional Configurations\n-- Support\n-\n-Identifying Your Adapter\n-========================\n-\n-This driver supports all 82575, 82576 and 82580-based Intel (R) gigabit network\n-connections.\n-\n-For specific information on how to identify your adapter, go to the Adapter &\n-Driver ID Guide at:\n-\n- http://support.intel.com/support/go/network/adapter/idguide.htm\n-\n-Command Line Parameters\n-=======================\n-\n-The default value for each parameter is generally the recommended setting,\n-unless otherwise noted.\n-\n-max_vfs\n--------\n-Valid Range: 0-7\n-Default Value: 0\n-\n-This parameter adds support for SR-IOV. It causes the driver to spawn up to\n-max_vfs worth of virtual function.\n-\n-Additional Configurations\n-=========================\n-\n- Jumbo Frames\n- ------------\n- Jumbo Frames support is enabled by changing the MTU to a value larger than\n- the default of 1500. Use the ip command to increase the MTU size.\n- For example:\n-\n- ip link set dev eth<x> mtu 9000\n-\n- This setting is not saved across reboots.\n-\n- Notes:\n-\n- - The maximum MTU setting for Jumbo Frames is 9216. This value coincides\n- with the maximum Jumbo Frames size of 9234 bytes.\n-\n- - Using Jumbo frames at 10 or 100 Mbps is not supported and may result in\n- poor performance or loss of link.\n-\n- ethtool\n- -------\n- The driver utilizes the ethtool interface for driver configuration and\n- diagnostics, as well as displaying statistical information. The latest\n- version of ethtool can be found at:\n-\n- https://www.kernel.org/pub/software/network/ethtool/\n-\n- Enabling Wake on LAN* (WoL)\n- ---------------------------\n- WoL is configured through the ethtool* utility.\n-\n- For instructions on enabling WoL with ethtool, refer to the ethtool man page.\n-\n- WoL will be enabled on the system during the next shut down or reboot.\n- For this driver version, in order to enable WoL, the igb driver must be\n- loaded when shutting down or rebooting the system.\n-\n- Wake On LAN is only supported on port A of multi-port adapters.\n-\n- Wake On LAN is not supported for the Intel(R) Gigabit VT Quad Port Server\n- Adapter.\n-\n- Multiqueue\n- ----------\n- In this mode, a separate MSI-X vector is allocated for each queue and one\n- for \"other\" interrupts such as link status change and errors. All\n- interrupts are throttled via interrupt moderation. Interrupt moderation\n- must be used to avoid interrupt storms while the driver is processing one\n- interrupt. The moderation value should be at least as large as the expected\n- time for the driver to process an interrupt. Multiqueue is off by default.\n-\n- REQUIREMENTS: MSI-X support is required for Multiqueue. If MSI-X is not\n- found, the system will fallback to MSI or to Legacy interrupts.\n-\n- MAC and VLAN anti-spoofing feature\n- ----------------------------------\n- When a malicious driver attempts to send a spoofed packet, it is dropped by\n- the hardware and not transmitted. An interrupt is sent to the PF driver\n- notifying it of the spoof attempt.\n-\n- When a spoofed packet is detected the PF driver will send the following\n- message to the system log (displayed by the \"dmesg\" command):\n-\n- Spoof event(s) detected on VF(n)\n-\n- Where n=the VF that attempted to do the spoofing.\n-\n- Setting MAC Address, VLAN and Rate Limit Using IProute2 Tool\n- ------------------------------------------------------------\n- You can set a MAC address of a Virtual Function (VF), a default VLAN and the\n- rate limit using the IProute2 tool. Download the latest version of the\n- iproute2 tool from Sourceforge if your version does not have all the\n- features you require.\n-\n-\n-Support\n-=======\n-\n-For general information, go to the Intel support website at:\n-\n- www.intel.com/support/\n-\n-or the Intel Wired Networking project hosted by Sourceforge at:\n-\n- http://sourceforge.net/projects/e1000\n-\n-If an issue is identified with the released source code on the supported\n-kernel with a supported adapter, email the specific information related\n-to the issue to e1000-devel@lists.sf.net\ndiff --git a/Documentation/networking/index.rst b/Documentation/networking/index.rst\nindex fd315630487c..35c92be2b22c 100644\n--- a/Documentation/networking/index.rst\n+++ b/Documentation/networking/index.rst\n@@ -16,6 +16,7 @@ Contents:\n e1000\n e1000e\n fm10k\n+ igb\n ixgb\n kapi\n z8530book\ndiff --git a/MAINTAINERS b/MAINTAINERS\nindex 89a1a53ea768..79ee82b0aab1 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -7279,7 +7279,7 @@ F:\tDocumentation/networking/e100.rst\n F:\tDocumentation/networking/e1000.rst\n F:\tDocumentation/networking/e1000e.rst\n F:\tDocumentation/networking/fm10k.rst\n-F:\tDocumentation/networking/igb.txt\n+F:\tDocumentation/networking/igb.rst\n F:\tDocumentation/networking/igbvf.txt\n F:\tDocumentation/networking/ixgb.rst\n F:\tDocumentation/networking/ixgbe.txt\ndiff --git a/drivers/net/ethernet/intel/Kconfig b/drivers/net/ethernet/intel/Kconfig\nindex 9a10cb3b4e3c..d95997237f9d 100644\n--- a/drivers/net/ethernet/intel/Kconfig\n+++ b/drivers/net/ethernet/intel/Kconfig\n@@ -97,7 +97,7 @@ config IGB\n \t <http://support.intel.com>\n \n \t More specific information on configuring the driver is in\n-\t <file:Documentation/networking/e1000.rst>.\n+\t <file:Documentation/networking/igb.rst>.\n \n \t To compile this driver as a module, choose M here. The module\n \t will be called igb.\n", "prefixes": [ "v2" ] }