From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.1 (2015-04-28) on archive.lwn.net X-Spam-Level: X-Spam-Status: No, score=-5.6 required=5.0 tests=DKIM_SIGNED, HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI, T_DKIM_INVALID autolearn=unavailable autolearn_force=no version=3.4.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by archive.lwn.net (Postfix) with ESMTP id 861D17DF90 for ; Wed, 23 May 2018 08:24:02 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932066AbeEWIXa (ORCPT ); Wed, 23 May 2018 04:23:30 -0400 Received: from mail.kernel.org ([198.145.29.99]:59458 "EHLO mail.kernel.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754444AbeEWIX0 (ORCPT ); Wed, 23 May 2018 04:23:26 -0400 Received: from localhost (unknown [37.173.74.74]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPSA id 88C5220873; Wed, 23 May 2018 08:23:24 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=default; t=1527063805; bh=43opHADRZeJkS/sUx9TqYxC0GKZ4iNdRBqaK4eVcHuw=; h=Date:From:To:Cc:Subject:References:In-Reply-To:From; b=j8p7EhRlHRmvDhGzbkzxiyonc/IGcZTYr67zWQVLnP6EU8i48V0BvtBqKXg+n6rof CrnlvGRKbV4zwllVBzLUlatxtHzbjl3IfHA5Tzq7xxZM68TDAWRz/EVbiCGN7xri20 cgs7b6FgO8D2Ib7+qroWzRPtkti/09WDAMBAc13Q= Date: Wed, 23 May 2018 10:23:06 +0200 From: Greg Kroah-Hartman To: Rajat Jain Cc: Bjorn Helgaas , Jonathan Corbet , Philippe Ombredanne , Kate Stewart , Thomas Gleixner , Frederick Lawler , Oza Pawandeep , Keith Busch , Gabriele Paoloni , Alexandru Gagniuc , Thomas Tai , "Steven Rostedt (VMware)" , linux-pci@vger.kernel.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Jes Sorensen , Kyle McMartin , rajatxjain@gmail.com Subject: Re: [PATCH 5/5] Documentation/PCI: Add details of PCI AER statistics Message-ID: <20180523082306.GD7247@kroah.com> References: <20180522222805.80314-1-rajatja@google.com> <20180522222805.80314-6-rajatja@google.com> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20180522222805.80314-6-rajatja@google.com> User-Agent: Mutt/1.10.0 (2018-05-17) Sender: linux-doc-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-doc@vger.kernel.org On Tue, May 22, 2018 at 03:28:05PM -0700, Rajat Jain wrote: > Add the PCI AER statistics details to > Documentation/PCI/pcieaer-howto.txt > > Signed-off-by: Rajat Jain > --- > Documentation/PCI/pcieaer-howto.txt | 35 +++++++++++++++++++++++++++++ > 1 file changed, 35 insertions(+) > > diff --git a/Documentation/PCI/pcieaer-howto.txt b/Documentation/PCI/pcieaer-howto.txt > index acd0dddd6bb8..86ee9f9ff5e1 100644 > --- a/Documentation/PCI/pcieaer-howto.txt > +++ b/Documentation/PCI/pcieaer-howto.txt > @@ -73,6 +73,41 @@ In the example, 'Requester ID' means the ID of the device who sends > the error message to root port. Pls. refer to pci express specs for > other fields. > > +2.4 AER statistics > + > +When AER messages are captured, the statistics are exposed via the following > +sysfs attributes under the "aer_stats" folder for the device: > + > +2.4.1 Device sysfs Attributes > + > +These attributes show up under all the devices that are AER capable. These > +indicate the errors "as seen by the device". Note that this may mean that if > +an end point is causing problems, the AER counters may increment at its link > +partner (e.g. root port) because the errors will be "seen" by the link partner > +and not the the problematic end point itself (which may report all counters > +as 0 as it never saw any problems). > + > + * dev_total_cor_errs: number of correctable errors seen by the device. > + * dev_total_fatal_errs: number of fatal uncorrectable errors seen by the device. > + * dev_total_nonfatal_errs: number of nonfatal uncorr errors seen by the device. > + * dev_breakdown_correctable: Provides a breakdown of different type of > + correctable errors seen. > + * dev_breakdown_uncorrectable: Provides a breakdown of different type of > + uncorrectable errors seen. > + > +2.4.1 Rootport sysfs Attributes > + > +These attributes showup under only the rootports that are AER capable. These > +indicate the number of error messages as "reported to" the rootport. Please note > +that the rootports also transmit (internally) the ERR_* messages for errors seen > +by the internal rootport PCI device, so these counters includes them and are > +thus cumulative of all the error messages on the PCI hierarchy originating > +at that root port. > + > + * rootport_total_cor_errs: number of ERR_COR messages reported to rootport. > + * rootport_total_fatal_errs: number of ERR_FATAL messages reported to rootport. > + * rootport_total_nonfatal_errs: number of ERR_NONFATAL messages reporeted to > + rootport. These all belong in Documentation/ABI/ please. thanks, greg k-h -- To unsubscribe from this list: send the line "unsubscribe linux-doc" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html