From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists.ozlabs.org (lists.ozlabs.org [112.213.38.117]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 0C778CA0EDC for ; Sun, 17 Aug 2025 13:54:03 +0000 (UTC) Received: from boromir.ozlabs.org (localhost [127.0.0.1]) by lists.ozlabs.org (Postfix) with ESMTP id 4c4clG2VGmz2xgQ; Sun, 17 Aug 2025 23:54:02 +1000 (AEST) Authentication-Results: lists.ozlabs.org; arc=none smtp.remote-ip=176.9.242.62 ARC-Seal: i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707; t=1755438842; cv=none; b=bNSPk1uJaIntkWoIcDdzEMQNZbSm5iCDhhwVOW6Ff26kJPyM8J3LvbAzN0c6oM3YeqlDPLwxlwQLFry4D04YU//YasVe8XsydD1iutJBl5pnTl8NaZosQLYG5vcg75v9DmfZiLwB/QMZfi3qSTqltEEFSzJwu+eqvHPyFm00noDWCF+q8reJl2Hq++UoqYIzKfZ4x4mEv6f2PKB0XUmjND9Qw2lPxo+ASoutD5L06PhQ3KWYL/2gYBJx3F7I6IzsCVLlxl8gwcFPFIed/KKO4xMii+Yk5LPker6e4pwmcecAYA5KOgiZ8IiavYfdnSCZs4LfcOHcmrDCVwykNxMQaA== ARC-Message-Signature: i=1; a=rsa-sha256; d=lists.ozlabs.org; s=201707; t=1755438842; c=relaxed/relaxed; bh=ivL6tmdbxPn7Hy8woM6xcNf0p/QxFtwM+DYdZwCcA2k=; h=Date:From:To:Cc:Subject:Message-ID:References:MIME-Version: Content-Type:Content-Disposition:In-Reply-To; b=XH1pCQ7SrMnxfV01o/8l462Syr/KklTrMViGVLOd+eF7yw4HZ5LCKHHL/+fHnhcDd7/B48X2GBOSKhikatyFEdghg1xuO2QYAfq8fwxLStWPxcu1Z54arQZvHBGwNlO7RSzDR0PSc+YNCMB6KE9HKDwJI5AhfCbX4ktYLu64mPSof85ac5SUTQPuYxtKkUf5fY3kwdOMp0TxVhZUIW/Py+Af7/l71KNeye54bBVokrxfhxNgcV8ytDOozrnDQ/G0hvGXI0IycthEDOPhiyc6q6mwOOv+LIg4XfIVB/w96GGu4VC4Fep6Tgx5K1MZ0Axr0SAJMYk6WP9Be9BDl2ggiw== ARC-Authentication-Results: i=1; lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=wunner.de; spf=pass (client-ip=176.9.242.62; helo=bmailout3.hostsharing.net; envelope-from=foo00@h08.hostsharing.net; receiver=lists.ozlabs.org) smtp.helo=bmailout3.hostsharing.net Authentication-Results: lists.ozlabs.org; dmarc=none (p=none dis=none) header.from=wunner.de Authentication-Results: lists.ozlabs.org; spf=pass (sender SPF authorized) smtp.helo=bmailout3.hostsharing.net (client-ip=176.9.242.62; helo=bmailout3.hostsharing.net; envelope-from=foo00@h08.hostsharing.net; receiver=lists.ozlabs.org) X-Greylist: delayed 512 seconds by postgrey-1.37 at boromir; Sun, 17 Aug 2025 23:54:01 AEST Received: from bmailout3.hostsharing.net (bmailout3.hostsharing.net [176.9.242.62]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by lists.ozlabs.org (Postfix) with ESMTPS id 4c4clF3SmDz2xK5 for ; Sun, 17 Aug 2025 23:54:01 +1000 (AEST) Received: from h08.hostsharing.net (h08.hostsharing.net [IPv6:2a01:37:1000::53df:5f1c:0]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "*.hostsharing.net", Issuer "RapidSSL TLS RSA CA G1" (verified OK)) by bmailout3.hostsharing.net (Postfix) with ESMTPS id 5E0DC2C051CC; Sun, 17 Aug 2025 15:45:25 +0200 (CEST) Received: by h08.hostsharing.net (Postfix, from userid 100393) id 2047E3BEDFB; Sun, 17 Aug 2025 15:45:25 +0200 (CEST) Date: Sun, 17 Aug 2025 15:45:25 +0200 From: Lukas Wunner To: Sathyanarayanan Kuppuswamy Cc: Bjorn Helgaas , Riana Tauro , Aravind Iddamsetty , "Sean C. Dardis" , Terry Bowman , Niklas Schnelle , Linas Vepstas , Mahesh J Salgaonkar , Oliver OHalloran , Manivannan Sadhasivam , linuxppc-dev@lists.ozlabs.org, linux-pci@vger.kernel.org Subject: Re: [PATCH 1/5] PCI/AER: Allow drivers to opt in to Bus Reset on Non-Fatal Errors Message-ID: References: <28fd805043bb57af390168d05abb30898cf4fc58.1755008151.git.lukas@wunner.de> X-Mailing-List: linuxppc-dev@lists.ozlabs.org List-Id: List-Help: List-Owner: List-Post: List-Archive: , List-Subscribe: , , List-Unsubscribe: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: On Wed, Aug 13, 2025 at 04:01:09PM -0700, Sathyanarayanan Kuppuswamy wrote: > On 8/12/25 10:11 PM, Lukas Wunner wrote: > > The file Documentation/PCI/pcieaer-howto.rst hints at a rationale for > > always performing a Bus Reset on Fatal Errors: "Fatal errors [...] cause > > the link to be unreliable. [...] This [reset_link] callback is used to > > reset the PCIe physical link when a fatal error happens. If an error > > message indicates a fatal error, [...] performing link reset at upstream > > is necessary." > > In the code we don't seem to differentiate link_reset and slot_reset. But > the Documentation calls them into two steps. Do you think we should > fix the Documentation? reset_link and slot_reset are two different things: * slot_reset is the ->slot_reset() callback in struct pci_error_handlers. * reset_link is the reset_subordinates() callback passed in to pcie_do_recovery(). Commit 8f1bbfbc3596 renamed reset_link() to reset_subordinates() but neglected to update Documentation/PCI/pcieaer-howto.rst. Commit b6cf1a42f916 dropped the reset_link() callback from struct pcie_port_service_driver and dropped default_reset_link() in favor of passing aer_root_reset() to pcie_do_recovery(). Yet the documentation continues referring to a "default reset_link callback" and incorrectly claims that "Upstream Port drivers may provide their own reset_link functions". I've begun updating the documentation and intend to submit that separately. Thanks, Lukas