From patchwork Tue May 22 22:28:05 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Rajat Jain X-Patchwork-Id: 10419683 X-Patchwork-Delegate: bhelgaas@google.com Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 0131D6032A for ; Tue, 22 May 2018 22:29:00 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id DD9D228C6C for ; Tue, 22 May 2018 22:28:59 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id D185928F23; Tue, 22 May 2018 22:28:59 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-15.5 required=2.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI, USER_IN_DEF_DKIM_WL autolearn=unavailable version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 85AAE28C6C for ; Tue, 22 May 2018 22:28:59 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1753409AbeEVW2c (ORCPT ); Tue, 22 May 2018 18:28:32 -0400 Received: from mail-pl0-f67.google.com ([209.85.160.67]:42677 "EHLO mail-pl0-f67.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1753408AbeEVW2a (ORCPT ); Tue, 22 May 2018 18:28:30 -0400 Received: by mail-pl0-f67.google.com with SMTP id u6-v6so11727618pls.9 for ; Tue, 22 May 2018 15:28:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20161025; h=from:to:cc:subject:date:message-id:in-reply-to:references; bh=z7VkBQQlYBnvGN1Gtxd8V7KUxPUVslFvPtw1dHurOCM=; b=Im6X19goSnAIwczCEWkfWe6g8yWklA+xrSn4mIPx/5zWGgTVZnUhPDfHbOrT+Q9g0A tA13+JiEdXujiHl22unVZj8UgBrmP97cxm9xbrkHdxvXV02MzAnrpFGRQzHsftIZA53p n3V7uyh/8cKWau8KurcGuMmtipvgpA6sYLpPSVVlA8kxIaiXS0FQbxSfL/o43eYoHJo3 quq+ruKCBE9Iabt/+1mL3wl/ag25aR/osN031hbhVDXN2PbHKUP7ZvbzOuvex3oXECKI 2/r/I0lMlT5GHR/PSeHRtQrK6oDI/V7EYzGVKleOz/Arp3atGHio8B1OwF+lBZAn1ajh gF0w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references; bh=z7VkBQQlYBnvGN1Gtxd8V7KUxPUVslFvPtw1dHurOCM=; b=P98HNc5hmsDofCgNarlObMlKhEmKaTWxadG6lm7GQ20ifw3him4K/Du7I0yA6AawXQ XBAeb65G5FCOVx/ohbiSJDwvuZejiSOTYNk3hMQJFqoRtlORdCbuGtk8WR/cd+NDZXiR RYPLSjnlapF9sD0/OIzXFS3R3dN45RQM5+HbWWBF9BuN6LO7qMKw9gpfeIpgY6fJ7P6A jgXMOBoJPWoNxyVO3JH0Y9rlfMRcblH+lXVJJ58iISYsEnqryOUDIZNCKhuxwRIiR6D3 XEGjON2Qp0V2k36wJWNGT/sJO1x7ldhZnv4gi9U4NF8+EyEF1FHX1IyMiclxHFfTmDoD sebg== X-Gm-Message-State: ALKqPwcTcx/92G4tm+wOxaQwSCWf5kcfYCtFf5fUAWKH2nEMZ8etdW9z T7IYjlb+pe8CrPT0DowHOqi1jA== X-Google-Smtp-Source: AB8JxZrRiuC9iS72kd4aGlNn5MMtdQyVn0H3/m5JAUn0kvnd2dsIr1Zj8+8Wi4tngIzM5X4VAL9eFg== X-Received: by 2002:a17:902:3c5:: with SMTP id d63-v6mr291803pld.163.1527028109443; Tue, 22 May 2018 15:28:29 -0700 (PDT) Received: from rajat.mtv.corp.google.com ([2620:0:1000:1501:dc81:9a9e:fdee:decf]) by smtp.gmail.com with ESMTPSA id b72-v6sm34327852pfm.69.2018.05.22.15.28.27 (version=TLS1_2 cipher=ECDHE-RSA-AES128-GCM-SHA256 bits=128/128); Tue, 22 May 2018 15:28:28 -0700 (PDT) From: Rajat Jain To: Bjorn Helgaas , Jonathan Corbet , Philippe Ombredanne , Kate Stewart , Thomas Gleixner , Greg Kroah-Hartman , Rajat Jain , 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 Cc: rajatxjain@gmail.com Subject: [PATCH 5/5] Documentation/PCI: Add details of PCI AER statistics Date: Tue, 22 May 2018 15:28:05 -0700 Message-Id: <20180522222805.80314-6-rajatja@google.com> X-Mailer: git-send-email 2.17.0.441.gb46fe60e1d-goog In-Reply-To: <20180522222805.80314-1-rajatja@google.com> References: <20180522222805.80314-1-rajatja@google.com> Sender: linux-pci-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-pci@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP 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. 3. Developer Guide