Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/2195486/?format=api
{ "id": 2195486, "url": "http://patchwork.ozlabs.org/api/patches/2195486/?format=api", "web_url": "http://patchwork.ozlabs.org/project/linux-pci/patch/1770798299-202288-2-git-send-email-shawn.lin@rock-chips.com/", "project": { "id": 28, "url": "http://patchwork.ozlabs.org/api/projects/28/?format=api", "name": "Linux PCI development", "link_name": "linux-pci", "list_id": "linux-pci.vger.kernel.org", "list_email": "linux-pci@vger.kernel.org", "web_url": null, "scm_url": null, "webscm_url": null, "list_archive_url": "", "list_archive_url_format": "", "commit_url_format": "" }, "msgid": "<1770798299-202288-2-git-send-email-shawn.lin@rock-chips.com>", "list_archive_url": null, "date": "2026-02-11T08:24:57", "name": "[v2,1/3] Documentation: PCI: Clarify pci_free_irq_vectors() usage for managed devices", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "0b1f568203f6542014f79119ddfc8b9a724883ff", "submitter": { "id": 66993, "url": "http://patchwork.ozlabs.org/api/people/66993/?format=api", "name": "Shawn Lin", "email": "shawn.lin@rock-chips.com" }, "delegate": null, "mbox": "http://patchwork.ozlabs.org/project/linux-pci/patch/1770798299-202288-2-git-send-email-shawn.lin@rock-chips.com/mbox/", "series": [ { "id": 491791, "url": "http://patchwork.ozlabs.org/api/series/491791/?format=api", "web_url": "http://patchwork.ozlabs.org/project/linux-pci/list/?series=491791", "date": "2026-02-11T08:24:57", "name": "Clarify pci_free_irq_vectors() usage constraints", "version": 2, "mbox": "http://patchwork.ozlabs.org/series/491791/mbox/" } ], "comments": "http://patchwork.ozlabs.org/api/patches/2195486/comments/", "check": "pending", "checks": "http://patchwork.ozlabs.org/api/patches/2195486/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "\n <linux-pci+bounces-47165-incoming=patchwork.ozlabs.org@vger.kernel.org>", "X-Original-To": [ "incoming@patchwork.ozlabs.org", "linux-pci@vger.kernel.org" ], "Delivered-To": "patchwork-incoming@legolas.ozlabs.org", "Authentication-Results": [ "legolas.ozlabs.org;\n\tdkim=pass (1024-bit key;\n unprotected) header.d=rock-chips.com header.i=@rock-chips.com\n header.a=rsa-sha256 header.s=default header.b=JufUhP19;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org\n (client-ip=2600:3c15:e001:75::12fc:5321; helo=sin.lore.kernel.org;\n envelope-from=linux-pci+bounces-47165-incoming=patchwork.ozlabs.org@vger.kernel.org;\n receiver=patchwork.ozlabs.org)", "smtp.subspace.kernel.org;\n\tdkim=pass (1024-bit key) header.d=rock-chips.com header.i=@rock-chips.com\n header.b=\"JufUhP19\"", "smtp.subspace.kernel.org;\n arc=none smtp.client-ip=220.197.32.105", "smtp.subspace.kernel.org;\n dmarc=pass (p=none dis=none) header.from=rock-chips.com", "smtp.subspace.kernel.org;\n spf=pass smtp.mailfrom=rock-chips.com" ], "Received": [ "from sin.lore.kernel.org (sin.lore.kernel.org\n [IPv6:2600:3c15:e001:75::12fc:5321])\n\t(using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)\n\t key-exchange x25519 server-signature ECDSA (secp384r1) server-digest SHA384)\n\t(No client certificate requested)\n\tby legolas.ozlabs.org (Postfix) with ESMTPS id 4f9s235JZTz1xvb\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 11 Feb 2026 19:25:31 +1100 (AEDT)", "from smtp.subspace.kernel.org (conduit.subspace.kernel.org\n [100.90.174.1])\n\tby sin.lore.kernel.org (Postfix) with ESMTP id 28DEF3013C62\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 11 Feb 2026 08:25:26 +0000 (UTC)", "from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 9B81535028B;\n\tWed, 11 Feb 2026 08:25:25 +0000 (UTC)", "from mail-m32105.qiye.163.com (mail-m32105.qiye.163.com\n [220.197.32.105])\n\t(using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits))\n\t(No client certificate requested)\n\tby smtp.subspace.kernel.org (Postfix) with ESMTPS id 754863502B5;\n\tWed, 11 Feb 2026 08:25:21 +0000 (UTC)", "from localhost.localdomain (unknown [58.22.7.114])\n\tby smtp.qiye.163.com (Hmail) with ESMTP id 33d86955b;\n\tWed, 11 Feb 2026 16:25:12 +0800 (GMT+08:00)" ], "ARC-Seal": "i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1770798325; cv=none;\n b=aUWql6tfnlwyI1uYjOjBM5/eOhjP4wU9e0zKCp3MUCidAn1QpaXntpkHJ02a63LOVnmLFNhIP9KehNzmSwuJA8vGl2fuv0YWQFis9QXqUrNPspKZoaWlZxcvkG+A93GqfFqQIyIiHrIGVWQMeqBp3C3ZBzLdoNOS5Et627hOc1w=", "ARC-Message-Signature": "i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1770798325; c=relaxed/simple;\n\tbh=YvigmLCqOr8/AoMiyT9kc2nOEGyhWmlyjRzi0fdnevs=;\n\th=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References;\n b=FuiK8lxelS0V6s0wQM9tzZX28/TSCEOYMbcX70ZzNEhc/ptANicK8Ga4pCONl59Lc41CzfNIEaCJq/t495SpWvmdQpEgFuk+iLn5CjVWdm2uLfQvPtu68gXqyu3gOzai6ENtiIjCIaF0tF3bkhvvRR249wCOEsf5Uzy9r5yG7o4=", "ARC-Authentication-Results": "i=1; smtp.subspace.kernel.org;\n dmarc=pass (p=none dis=none) header.from=rock-chips.com;\n spf=pass smtp.mailfrom=rock-chips.com;\n dkim=pass (1024-bit key) header.d=rock-chips.com header.i=@rock-chips.com\n header.b=JufUhP19; arc=none smtp.client-ip=220.197.32.105", "From": "Shawn Lin <shawn.lin@rock-chips.com>", "To": "Bjorn Helgaas <bhelgaas@google.com>", "Cc": "linux-pci@vger.kernel.org,\n\tlinux-doc@vger.kernel.org,\n\tPhilipp Stanner <phasta@kernel.org>,\n\tShawn Lin <shawn.lin@rock-chips.com>", "Subject": "[PATCH v2 1/3] Documentation: PCI: Clarify pci_free_irq_vectors()\n usage for managed devices", "Date": "Wed, 11 Feb 2026 16:24:57 +0800", "Message-Id": "<1770798299-202288-2-git-send-email-shawn.lin@rock-chips.com>", "X-Mailer": "git-send-email 2.7.4", "In-Reply-To": "<1770798299-202288-1-git-send-email-shawn.lin@rock-chips.com>", "References": "<1770798299-202288-1-git-send-email-shawn.lin@rock-chips.com>", "X-HM-Tid": "0a9c4bcdec8309cckunm6cb3bb0ee1952", "X-HM-MType": "1", "X-HM-Spam-Status": "e1kfGhgUHx5ZQUpXWQgPGg8OCBgUHx5ZQUlOS1dZFg8aDwILHllBWSg2Ly\n\ttZV1koWUFDSUNOT01LS0k3V1ktWUFJV1kPCRoVCBIfWUFZGUwYSFZDTE4YQkhJTUkeGENWFRQJFh\n\toXVRMBExYaEhckFA4PWVdZGBILWUFZTkNVSUlVTFVKSk9ZV1kWGg8SFR0UWUFZT0tIVUpLSU9PT0\n\thVSktLVUpCS0tZBg++", "DKIM-Signature": "a=rsa-sha256;\n\tb=JufUhP197s404EhhqFc+pQZhJZa9rod0V2L9oqrMUrh3NyQstJCxuZ7JOLQTpncGG7/SQftbAq5tYsEhaILjUKIWOth+0SaJAGKNk12LMXj1tbjflubP9Zcw/xeKCK3bX2jpkUxuJdwgRHZHxl8Yt6jZr7qkBqi4NKHcLhWUKHE=;\n s=default; c=relaxed/relaxed; d=rock-chips.com; v=1;\n\tbh=kO7osYZ7Ghm6DE8ieF75ePp5+J1QxST7/0v2tb+XADg=;\n\th=date:mime-version:subject:message-id:from;", "Precedence": "bulk", "X-Mailing-List": "linux-pci@vger.kernel.org", "List-Id": "<linux-pci.vger.kernel.org>", "List-Subscribe": "<mailto:linux-pci+subscribe@vger.kernel.org>", "List-Unsubscribe": "<mailto:linux-pci+unsubscribe@vger.kernel.org>" }, "content": "Update the msi-howto.rst documentation to clarify that drivers using\npcim_enable_device() must not call pci_free_irq_vectors().\n\nFor legacy reasons, pcim_enable_device() switches several normally\nun-managed functions into managed mode. Currently, the only function\naffected in this way is pcim_setup_msi_release(), which results in\nautomatic IRQ vector management.\n\nThis behavior is dangerous and confusing. Drivers using pcim_enable_device()\nshould rely on the automatic IRQ vector management and avoid calling\npci_free_irq_vectors() manually.\n\nSuggested-by: Philipp Stanner <phasta@kernel.org>\nSigned-off-by: Shawn Lin <shawn.lin@rock-chips.com>\n\n---\n\nChanges in v2:\n- rework the commit message and documentation\n\n Documentation/PCI/msi-howto.rst | 7 +++++--\n 1 file changed, 5 insertions(+), 2 deletions(-)", "diff": "diff --git a/Documentation/PCI/msi-howto.rst b/Documentation/PCI/msi-howto.rst\nindex 667ebe2..844c1d3 100644\n--- a/Documentation/PCI/msi-howto.rst\n+++ b/Documentation/PCI/msi-howto.rst\n@@ -113,8 +113,11 @@ vectors, use the following function::\n \n int pci_irq_vector(struct pci_dev *dev, unsigned int nr);\n \n-Any allocated resources should be freed before removing the device using\n-the following function::\n+If the driver enables the device using pcim_enable_device(), the driver\n+shouldn't call pci_free_irq_vectors() because pcim_enable_device()\n+activates automatic management for IRQ vectors. Otherwise, the driver should\n+free any allocated IRQ vectors before removing the device using the following\n+function::\n \n void pci_free_irq_vectors(struct pci_dev *dev);\n \n", "prefixes": [ "v2", "1/3" ] }