Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/911533/?format=api
{ "id": 911533, "url": "http://patchwork.ozlabs.org/api/patches/911533/?format=api", "web_url": "http://patchwork.ozlabs.org/project/intel-wired-lan/patch/20180510195538.19124-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": "<20180510195538.19124-1-jeffrey.t.kirsher@intel.com>", "list_archive_url": null, "date": "2018-05-10T19:55:38", "name": "[v2] Documentation: e1000: Update kernel documentation", "commit_ref": null, "pull_url": null, "state": "accepted", "archived": false, "hash": "929febda541bc563fb77de5ddacd81a2d36eccd4", "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/20180510195538.19124-1-jeffrey.t.kirsher@intel.com/mbox/", "series": [ { "id": 43723, "url": "http://patchwork.ozlabs.org/api/series/43723/?format=api", "web_url": "http://patchwork.ozlabs.org/project/intel-wired-lan/list/?series=43723", "date": "2018-05-10T19:55:38", "name": "[v2] Documentation: e1000: Update kernel documentation", "version": 2, "mbox": "http://patchwork.ozlabs.org/series/43723/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/911533/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/911533/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.137; helo=fraxinus.osuosl.org;\n\tenvelope-from=intel-wired-lan-bounces@osuosl.org;\n\treceiver=<UNKNOWN>)", "ozlabs.org;\n\tdmarc=none (p=none dis=none) header.from=intel.com" ], "Received": [ "from fraxinus.osuosl.org (smtp4.osuosl.org [140.211.166.137])\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 40hkT058Jqz9s0w\n\tfor <incoming@patchwork.ozlabs.org>;\n\tFri, 11 May 2018 05:54:28 +1000 (AEST)", "from localhost (localhost [127.0.0.1])\n\tby fraxinus.osuosl.org (Postfix) with ESMTP id 5F6C587CEF;\n\tThu, 10 May 2018 19:54:26 +0000 (UTC)", "from fraxinus.osuosl.org ([127.0.0.1])\n\tby localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024)\n\twith ESMTP id pyOs5r2jC6NO; Thu, 10 May 2018 19:54:24 +0000 (UTC)", "from ash.osuosl.org (ash.osuosl.org [140.211.166.34])\n\tby fraxinus.osuosl.org (Postfix) with ESMTP id 2449787CE5;\n\tThu, 10 May 2018 19:54:24 +0000 (UTC)", "from whitealder.osuosl.org (smtp1.osuosl.org [140.211.166.138])\n\tby ash.osuosl.org (Postfix) with ESMTP id 7247B1C2DED\n\tfor <intel-wired-lan@lists.osuosl.org>;\n\tThu, 10 May 2018 19:54:23 +0000 (UTC)", "from localhost (localhost [127.0.0.1])\n\tby whitealder.osuosl.org (Postfix) with ESMTP id 6C9EE88330\n\tfor <intel-wired-lan@lists.osuosl.org>;\n\tThu, 10 May 2018 19:54:23 +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 F0c8mMIfFChB for <intel-wired-lan@lists.osuosl.org>;\n\tThu, 10 May 2018 19:54:22 +0000 (UTC)", "from mga01.intel.com (mga01.intel.com [192.55.52.88])\n\tby whitealder.osuosl.org (Postfix) with ESMTPS id C58348831D\n\tfor <intel-wired-lan@lists.osuosl.org>;\n\tThu, 10 May 2018 19:54:21 +0000 (UTC)", "from fmsmga006.fm.intel.com ([10.253.24.20])\n\tby fmsmga101.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t10 May 2018 12:54:21 -0700", "from jtkirshe-nuc.jf.intel.com ([134.134.177.59])\n\tby fmsmga006.fm.intel.com with ESMTP; 10 May 2018 12:54:21 -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.49,386,1520924400\"; d=\"scan'208\";a=\"227522997\"", "From": "Jeff Kirsher <jeffrey.t.kirsher@intel.com>", "To": "intel-wired-lan@lists.osuosl.org", "Date": "Thu, 10 May 2018 12:55:38 -0700", "Message-Id": "<20180510195538.19124-1-jeffrey.t.kirsher@intel.com>", "X-Mailer": "git-send-email 2.17.0", "Subject": "[Intel-wired-lan] [PATCH v2] Documentation: e1000: 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 e1000.txt kernel documentation with the latest information.\n\nAlso convert the text file to reStructuredText (RST) format, since the\nLinux kernel documentation now uses this format for documentation.\n\nSigned-off-by: Jeff Kirsher <jeffrey.t.kirsher@intel.com>\n---\nv2: fix the broken URL\n\n .../networking/{e1000.txt => e1000.rst} | 59 ++++---------------\n Documentation/networking/index.rst | 1 +\n MAINTAINERS | 2 +-\n 3 files changed, 12 insertions(+), 50 deletions(-)\n rename Documentation/networking/{e1000.txt => e1000.rst} (89%)", "diff": "diff --git a/Documentation/networking/e1000.txt b/Documentation/networking/e1000.rst\nsimilarity index 89%\nrename from Documentation/networking/e1000.txt\nrename to Documentation/networking/e1000.rst\nindex 1f6ed848363d..616848940e63 100644\n--- a/Documentation/networking/e1000.txt\n+++ b/Documentation/networking/e1000.rst\n@@ -154,7 +154,7 @@ NOTE: When e1000 is loaded with default settings and multiple adapters\n are in use simultaneously, the CPU utilization may increase non-\n linearly. In order to limit the CPU utilization without impacting\n the overall throughput, we recommend that you load the driver as\n- follows:\n+ follows::\n \n modprobe e1000 InterruptThrottleRate=3000,3000,3000\n \n@@ -167,8 +167,8 @@ NOTE: When e1000 is loaded with default settings and multiple adapters\n \n RxDescriptors\n -------------\n-Valid Range: 80-256 for 82542 and 82543-based adapters\n- 80-4096 for all other supported adapters\n+Valid Range: 48-256 for 82542 and 82543-based adapters\n+ 48-4096 for all other supported adapters\n Default Value: 256\n \n This value specifies the number of receive buffer descriptors allocated\n@@ -230,8 +230,8 @@ speed. Duplex should also be set when Speed is set to either 10 or 100.\n \n TxDescriptors\n -------------\n-Valid Range: 80-256 for 82542 and 82543-based adapters\n- 80-4096 for all other supported adapters\n+Valid Range: 48-256 for 82542 and 82543-based adapters\n+ 48-4096 for all other supported adapters\n Default Value: 256\n \n This value is the number of transmit descriptors allocated by the driver.\n@@ -242,41 +242,10 @@ NOTE: Depending on the available system resources, the request for a\n higher number of transmit descriptors may be denied. In this case,\n use a lower number.\n \n-TxDescriptorStep\n-----------------\n-Valid Range: 1 (use every Tx Descriptor)\n- 4 (use every 4th Tx Descriptor)\n-\n-Default Value: 1 (use every Tx Descriptor)\n-\n-On certain non-Intel architectures, it has been observed that intense TX\n-traffic bursts of short packets may result in an improper descriptor\n-writeback. If this occurs, the driver will report a \"TX Timeout\" and reset\n-the adapter, after which the transmit flow will restart, though data may\n-have stalled for as much as 10 seconds before it resumes.\n-\n-The improper writeback does not occur on the first descriptor in a system\n-memory cache-line, which is typically 32 bytes, or 4 descriptors long.\n-\n-Setting TxDescriptorStep to a value of 4 will ensure that all TX descriptors\n-are aligned to the start of a system memory cache line, and so this problem\n-will not occur.\n-\n-NOTES: Setting TxDescriptorStep to 4 effectively reduces the number of\n- TxDescriptors available for transmits to 1/4 of the normal allocation.\n- This has a possible negative performance impact, which may be\n- compensated for by allocating more descriptors using the TxDescriptors\n- module parameter.\n-\n- There are other conditions which may result in \"TX Timeout\", which will\n- not be resolved by the use of the TxDescriptorStep parameter. As the\n- issue addressed by this parameter has never been observed on Intel\n- Architecture platforms, it should not be used on Intel platforms.\n-\n TxIntDelay\n ----------\n Valid Range: 0-65535 (0=off)\n-Default Value: 64\n+Default Value: 8\n \n This value delays the generation of transmit interrupts in units of\n 1.024 microseconds. Transmit interrupt reduction can improve CPU\n@@ -288,7 +257,7 @@ TxAbsIntDelay\n -------------\n (This parameter is supported only on 82540, 82545 and later adapters.)\n Valid Range: 0-65535 (0=off)\n-Default Value: 64\n+Default Value: 32\n \n This value, in units of 1.024 microseconds, limits the delay in which a\n transmit interrupt is generated. Useful only if TxIntDelay is non-zero,\n@@ -310,7 +279,7 @@ Copybreak\n ---------\n Valid Range: 0-xxxxxxx (0=off)\n Default Value: 256\n-Usage: insmod e1000.ko copybreak=128\n+Usage: modprobe e1000.ko copybreak=128\n \n Driver copies all packets below or equaling this size to a fresh RX\n buffer before handing it up the stack.\n@@ -328,14 +297,6 @@ Default Value: 0 (disabled)\n Allows PHY to turn off in lower power states. The user can turn off\n this parameter in supported chipsets.\n \n-KumeranLockLoss\n----------------\n-Valid Range: 0-1\n-Default Value: 1 (enabled)\n-\n-This workaround skips resetting the PHY at shutdown for the initial\n-silicon releases of ICH8 systems.\n-\n Speed and Duplex Configuration\n ==============================\n \n@@ -397,12 +358,12 @@ Additional Configurations\n ------------\n Jumbo Frames support is enabled by changing the MTU to a value larger than\n the default of 1500. Use the ifconfig command to increase the MTU size.\n- For example:\n+ For example::\n \n ifconfig eth<x> mtu 9000 up\n \n This setting is not saved across reboots. It can be made permanent if\n- you add:\n+ you add::\n \n MTU=9000\n \ndiff --git a/Documentation/networking/index.rst b/Documentation/networking/index.rst\nindex d11a62977edd..fec8588a588e 100644\n--- a/Documentation/networking/index.rst\n+++ b/Documentation/networking/index.rst\n@@ -11,6 +11,7 @@ Contents:\n can\n dpaa2/index\n e100\n+ e1000\n kapi\n z8530book\n msg_zerocopy\ndiff --git a/MAINTAINERS b/MAINTAINERS\nindex 0a5e36927540..79a725453d22 100644\n--- a/MAINTAINERS\n+++ b/MAINTAINERS\n@@ -7081,7 +7081,7 @@ T:\tgit git://git.kernel.org/pub/scm/linux/kernel/git/jkirsher/net-queue.git\n T:\tgit git://git.kernel.org/pub/scm/linux/kernel/git/jkirsher/next-queue.git\n S:\tSupported\n F:\tDocumentation/networking/e100.rst\n-F:\tDocumentation/networking/e1000.txt\n+F:\tDocumentation/networking/e1000.rst\n F:\tDocumentation/networking/e1000e.txt\n F:\tDocumentation/networking/igb.txt\n F:\tDocumentation/networking/igbvf.txt\n", "prefixes": [ "v2" ] }