Cover Letter Detail
Show a cover letter.
GET /api/covers/2195497/?format=api
{ "id": 2195497, "url": "http://patchwork.ozlabs.org/api/covers/2195497/?format=api", "web_url": "http://patchwork.ozlabs.org/project/linux-pci/cover/1770798299-202288-1-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-1-git-send-email-shawn.lin@rock-chips.com>", "list_archive_url": null, "date": "2026-02-11T08:24:56", "name": "[v2,0/3] Clarify pci_free_irq_vectors() usage constraints", "submitter": { "id": 66993, "url": "http://patchwork.ozlabs.org/api/people/66993/?format=api", "name": "Shawn Lin", "email": "shawn.lin@rock-chips.com" }, "mbox": "http://patchwork.ozlabs.org/project/linux-pci/cover/1770798299-202288-1-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/covers/2195497/comments/", "headers": { "Return-Path": "\n <linux-pci+bounces-47167-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=WrHnwbT1;\n\tdkim-atps=neutral", "legolas.ozlabs.org;\n spf=pass (sender SPF authorized) smtp.mailfrom=vger.kernel.org\n (client-ip=2600:3c04:e001:36c::12fc:5321; helo=tor.lore.kernel.org;\n envelope-from=linux-pci+bounces-47167-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=\"WrHnwbT1\"", "smtp.subspace.kernel.org;\n arc=none smtp.client-ip=220.197.31.87", "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 tor.lore.kernel.org (tor.lore.kernel.org\n [IPv6:2600:3c04:e001:36c::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 4f9sMd1lCZz1xvb\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 11 Feb 2026 19:40:45 +1100 (AEDT)", "from smtp.subspace.kernel.org (conduit.subspace.kernel.org\n [100.90.174.1])\n\tby tor.lore.kernel.org (Postfix) with ESMTP id 0E4E83010BBF\n\tfor <incoming@patchwork.ozlabs.org>; Wed, 11 Feb 2026 08:40:43 +0000 (UTC)", "from localhost.localdomain (localhost.localdomain [127.0.0.1])\n\tby smtp.subspace.kernel.org (Postfix) with ESMTP id 33A413502A8;\n\tWed, 11 Feb 2026 08:40:40 +0000 (UTC)", "from mail-m1973187.qiye.163.com (mail-m1973187.qiye.163.com\n [220.197.31.87])\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 55B5E34FF77;\n\tWed, 11 Feb 2026 08:40:36 +0000 (UTC)", "from localhost.localdomain (unknown [58.22.7.114])\n\tby smtp.qiye.163.com (Hmail) with ESMTP id 33d869550;\n\tWed, 11 Feb 2026 16:25:09 +0800 (GMT+08:00)" ], "ARC-Seal": "i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116;\n\tt=1770799240; cv=none;\n b=FgImoZJ7KKfojLu66IgtSKYp/m+e/1x0lNbX6vQxL/2Vk8lPwWf3IJwE/TkKSqfgE9pnj2qplPfw2W1mU4flPOioef1a/07FJD/c5xVbIraF201bSb3MBZyXPbaJom/qClh8Epp92rrnEFlwNl9Zji8CCVDUNqwdL6Qboczoty8=", "ARC-Message-Signature": "i=1; a=rsa-sha256; d=subspace.kernel.org;\n\ts=arc-20240116; t=1770799240; c=relaxed/simple;\n\tbh=df7u2Qzcmi9LtE9iK1hJ4/WAuUKFUwnE5kZX8HKvz8E=;\n\th=From:To:Cc:Subject:Date:Message-Id;\n b=IgFMUWHqbBFTImqHh7rZhKLow1SBz7KCeWoQX0qIzJfLyiZvAaz/2QU1V4zpZbQQXIzXE7fg4T2+BSb8O2Rokq49n8ynib58iNUM3cL/ajqJyZsAJBRg6jro/pRkExEmCEE0leozMwPim8VoZ10LA//IeewJi13kI2JeJJ/zz34=", "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=WrHnwbT1; arc=none smtp.client-ip=220.197.31.87", "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 0/3] Clarify pci_free_irq_vectors() usage constraints", "Date": "Wed, 11 Feb 2026 16:24:56 +0800", "Message-Id": "<1770798299-202288-1-git-send-email-shawn.lin@rock-chips.com>", "X-Mailer": "git-send-email 2.7.4", "X-HM-Tid": "0a9c4bcdde4409cckunm6cb3bb0ee1928", "X-HM-MType": "1", "X-HM-Spam-Status": "e1kfGhgUHx5ZQUpXWQgPGg8OCBgUHx5ZQUlOS1dZFg8aDwILHllBWSg2Ly\n\ttZV1koWUFDSUNOT01LS0k3V1ktWUFJV1kPCRoVCBIfWUFZGkhMGVYeGh4eTU9JSEoaGUlWFRQJFh\n\toXVRMBExYaEhckFA4PWVdZGBILWUFZTkNVSUlVTFVKSk9ZV1kWGg8SFR0UWUFZT0tIVUpLSU9PT0\n\thVSktLVUpCS0tZBg++", "DKIM-Signature": "a=rsa-sha256;\n\tb=WrHnwbT1au31RuZMDW9WXpge/f8TuRCERkI8Pt+l6AT8keaPQ6DMIhWd2xqMwHD5wLzl66n58NUsc6GJduj/53ZNC8s9InybHVpFrXSRlqkpQSModCJqNQeVnMmoCq74q54d9CRapuzneaZGOJLE3xANa7ySJG9TjV4JsgvNQPs=;\n s=default; c=relaxed/relaxed; d=rock-chips.com; v=1;\n\tbh=vW6bi5QtvyujZ1cYIV1ApMxkTvQkAASQb3AXOba9ifk=;\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": "pcim_enable_device() automatically manages IRQ vectors, which can cause\ndouble-free issues if drivers manually call pci_free_irq_vectors().\n\nThis series adds documentation and warnings to prevent this:\n1. msi-howto.rst guidance\n2. kernel-doc warning\n3. TODO comment for future cleanup\n\n\nChanges in v2:\n- rework the commit message and documentation\n\nShawn Lin (3):\n Documentation: PCI: Clarify pci_free_irq_vectors() usage for managed\n devices\n PCI/MSI: Add warning to pci_free_irq_vectors() documentation\n PCI/MSI: Add TODO comment about legacy pcim_enable_device()\n side-effect\n\n Documentation/PCI/msi-howto.rst | 7 +++++--\n drivers/pci/msi/api.c | 5 +++++\n drivers/pci/msi/msi.c | 10 ++++++++++\n 3 files changed, 20 insertions(+), 2 deletions(-)" }