Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/1035062/?format=api
{ "id": 1035062, "url": "http://patchwork.ozlabs.org/api/patches/1035062/?format=api", "web_url": "http://patchwork.ozlabs.org/project/intel-wired-lan/patch/1549048453-3584-7-git-send-email-megha.dey@linux.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": "<1549048453-3584-7-git-send-email-megha.dey@linux.intel.com>", "list_archive_url": null, "date": "2019-02-01T19:14:13", "name": "[RFC,v4,6/6] Documentation: PCI/MSI: Document dynamic MSI-X infrastructure", "commit_ref": null, "pull_url": null, "state": "rfc", "archived": false, "hash": "c1c516e5679e17445158c7e773699c3c30535d2f", "submitter": { "id": 75876, "url": "http://patchwork.ozlabs.org/api/people/75876/?format=api", "name": "Dey, Megha", "email": "megha.dey@linux.intel.com" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/intel-wired-lan/patch/1549048453-3584-7-git-send-email-megha.dey@linux.intel.com/mbox/", "series": [ { "id": 89594, "url": "http://patchwork.ozlabs.org/api/series/89594/?format=api", "web_url": "http://patchwork.ozlabs.org/project/intel-wired-lan/list/?series=89594", "date": "2019-02-01T19:14:07", "name": "Introduce dynamic allocation/freeing of MSI-X vectors", "version": 4, "mbox": "http://patchwork.ozlabs.org/series/89594/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/1035062/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/1035062/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.133; helo=hemlock.osuosl.org;\n\tenvelope-from=intel-wired-lan-bounces@osuosl.org;\n\treceiver=<UNKNOWN>)", "ozlabs.org; dmarc=none (p=none dis=none)\n\theader.from=linux.intel.com" ], "Received": [ "from hemlock.osuosl.org (smtp2.osuosl.org [140.211.166.133])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256\n\tbits)) (No client certificate requested)\n\tby ozlabs.org (Postfix) with ESMTPS id 43rmzm3Bfrz9s4V\n\tfor <incoming@patchwork.ozlabs.org>;\n\tSat, 2 Feb 2019 06:16:19 +1100 (AEDT)", "from localhost (localhost [127.0.0.1])\n\tby hemlock.osuosl.org (Postfix) with ESMTP id 4DF068835B;\n\tFri, 1 Feb 2019 19:16:17 +0000 (UTC)", "from hemlock.osuosl.org ([127.0.0.1])\n\tby localhost (.osuosl.org [127.0.0.1]) (amavisd-new, port 10024)\n\twith ESMTP id uj7--ga5CJ1C; Fri, 1 Feb 2019 19:16:16 +0000 (UTC)", "from ash.osuosl.org (ash.osuosl.org [140.211.166.34])\n\tby hemlock.osuosl.org (Postfix) with ESMTP id BB88388351;\n\tFri, 1 Feb 2019 19:16:16 +0000 (UTC)", "from silver.osuosl.org (smtp3.osuosl.org [140.211.166.136])\n\tby ash.osuosl.org (Postfix) with ESMTP id ED26F1BF951\n\tfor <intel-wired-lan@lists.osuosl.org>;\n\tFri, 1 Feb 2019 18:52:27 +0000 (UTC)", "from localhost (localhost [127.0.0.1])\n\tby silver.osuosl.org (Postfix) with ESMTP id E86323103E\n\tfor <intel-wired-lan@lists.osuosl.org>;\n\tFri, 1 Feb 2019 18:52:27 +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 Y2qSwUhZRsdG for <intel-wired-lan@lists.osuosl.org>;\n\tFri, 1 Feb 2019 18:52:26 +0000 (UTC)", "from mga03.intel.com (mga03.intel.com [134.134.136.65])\n\tby silver.osuosl.org (Postfix) with ESMTPS id DC2343103D\n\tfor <intel-wired-lan@lists.osuosl.org>;\n\tFri, 1 Feb 2019 18:52:26 +0000 (UTC)", "from orsmga003.jf.intel.com ([10.7.209.27])\n\tby orsmga103.jf.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384;\n\t01 Feb 2019 10:50:54 -0800", "from megha-z97x-ud7-th.sc.intel.com ([143.183.85.162])\n\tby orsmga003.jf.intel.com with ESMTP; 01 Feb 2019 10:50:54 -0800" ], "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.56,549,1539673200\"; d=\"scan'208\";a=\"123233699\"", "From": "Megha Dey <megha.dey@linux.intel.com>", "To": "linux-drivers-review@linux.intel.com,\n\tintel-wired-lan@lists.osuosl.org", "Date": "Fri, 1 Feb 2019 11:14:13 -0800", "Message-Id": "<1549048453-3584-7-git-send-email-megha.dey@linux.intel.com>", "X-Mailer": "git-send-email 2.7.4", "In-Reply-To": "<1549048453-3584-1-git-send-email-megha.dey@linux.intel.com>", "References": "<1549048453-3584-1-git-send-email-megha.dey@linux.intel.com>", "X-Mailman-Approved-At": "Fri, 01 Feb 2019 19:16:15 +0000", "Subject": "[Intel-wired-lan] [RFC v4 6/6] Documentation: PCI/MSI: Document\n\tdynamic MSI-X infrastructure", "X-BeenThere": "intel-wired-lan@osuosl.org", "X-Mailman-Version": "2.1.29", "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>", "Cc": "ravi.v.shankar@intel.com, ashok.raj@intel.com, kyung.min.park@intel.com, \n\tjacob.jun.pan@intel.com, Megha Dey <megha.dey@linux.intel.com>,\n\tmegha.dey@intel.com", "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": "Add Documentation for the newly introduced dynamic allocation\nand deallocation of MSI-X vectors.\n\nSigned-off-by: Megha Dey <megha.dey@linux.intel.com>\n---\n Documentation/PCI/MSI-HOWTO.txt | 36 ++++++++++++++++++++++++++++++++++++\n 1 file changed, 36 insertions(+)", "diff": "diff --git a/Documentation/PCI/MSI-HOWTO.txt b/Documentation/PCI/MSI-HOWTO.txt\nindex 618e13d..28674bb 100644\n--- a/Documentation/PCI/MSI-HOWTO.txt\n+++ b/Documentation/PCI/MSI-HOWTO.txt\n@@ -156,6 +156,42 @@ the driver can specify that only MSI or MSI-X is acceptable:\n \tif (nvec < 0)\n \t\tgoto out_err;\n \n+The pci_alloc_irq_vectors() API are one-shot methods to allocate MSI resources\n+i.e. they cannot be called multiple times. In order to allocate MSI-X vectors\n+post probe phase, multiple times, use the following API:\n+\n+ int pci_alloc_irq_vectors_dyn(struct pci_dev *dev, unsigned int min_vecs,\n+ unsigned int max_vecs, unsigned int flags, int *group_id);\n+\n+This API allocates up to max_vecs interrupt vectors for a PCI device. It returns\n+the number of vectors allocated or a negative error. If the device has a\n+requirement for a minimum number of vectors the driver can pass a min_vecs\n+argument set to this limit, and the PCI core will return -ENOSPC if it can't\n+meet the minimum number of vectors. This API is only to be used for MSI-X vectors.\n+\n+A group ID pointer is passed which gets populated by this function. A unique\n+group_id will associated with all the MSI-X vectors allocated each time this\n+function is called:\n+\n+\tint group_id;\n+\tnvec = pci_alloc_irq_vectors_dyn(pdev, minvecs, maxvecs,\n+\t\t\t\t\tflags | PCI_IRQ_MSIX, &group_id);\n+\tif (nvec < 0)\n+\t\tgoto out_err;\n+\n+To get the Linux IRQ numbers passed to request_irq() and free_irq() and the\n+vectors, use the following function:\n+\n+ int pci_irq_vec_grp(struct pci_dev *dev, unsigned int nr, unsigned int group_id);\n+\n+In order to free the MSI-X resources associated with a particular group, use\n+the following function:\n+\n+ int pci_free_irq_vectors_grp(struct pci_dev *dev, int group_id);\n+\n+To delete the group allocated with the pci_alloc_irq_vectors_dyn() call:\n+\tnvec = pci_free_irq_vectors_grp(pdev, group_id);\n+\n 4.3 Legacy APIs\n \n The following old APIs to enable and disable MSI or MSI-X interrupts should\n", "prefixes": [ "RFC", "v4", "6/6" ] }