From patchwork Wed Dec 6 20:37:46 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: tip-bot2 for Thomas Gleixner X-Patchwork-Id: 174726 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:bcd1:0:b0:403:3b70:6f57 with SMTP id r17csp4365430vqy; Wed, 6 Dec 2023 12:37:58 -0800 (PST) X-Google-Smtp-Source: AGHT+IGPeAclVPjLBQUJSCJSiPg9JQDka1KPLrcdtB3Gse877NDq7LFvIvXgeL10lbus4v+YZr5v X-Received: by 2002:a17:90a:fb44:b0:285:ba0a:1c9d with SMTP id iq4-20020a17090afb4400b00285ba0a1c9dmr1539864pjb.6.1701895077898; Wed, 06 Dec 2023 12:37:57 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1701895077; cv=none; d=google.com; s=arc-20160816; b=faMmHtvOUH2R52n6NddHKVVGu9R2hWbPxok2i4K8qvseRhryTgc/Ue/IcYfr40cdH5 9m0gGUV4EmNyBrHktE6festIoSsaq70BbrOlPgII6I1IT5w8ijpliWkCKMheoSiRQUzh B6ngBR1rM68erb/DdAC9ag2MABWCnKRX1cyi3F4VzMwwtY8hNSdpVZNN5XFEDJAs+0om C33o5xLVbOKycr0TQUAi7WWZY0ZeAlY+veEz5FP39TCVDagyciInkiVAdFBTRQ0vE6B9 e+8IydumdYfkGeZxQQNq6JCFoGAwbR+HWbUVsp9gVNTyEBnv6iycHdjT0FhHXFsmwnTF pDEA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:robot-unsubscribe :robot-id:message-id:mime-version:references:in-reply-to:cc:subject :to:reply-to:sender:from:dkim-signature:dkim-signature:date; bh=DmqzdnVSaCif9lTTSTkVjsGHjFLNC1T4J8dN+L6XEQ8=; fh=rR8KC3MdVVkWqW1DLWNOtxrtJ4e446FIKUSpWnemrcA=; b=WD5xEXg6ASgt8F1oy8XCmEo0t8D/S5205TCXuPzD3YAyopgCWfN6Kr3xyVXhySpLK9 teEmM8RwrWVdCl7/4jAsDGl5SCg8xg/4l4tXSXN3fYAkkTVDjRNlJj8jj2MIdIFhuZBd HnF0ZYm/HAOdUxnChQIbAmSXdkdDtZsLI8P4/43fImHHqiPkLDH0877jIOXMzrvEB1kS 1wCNpJWdz8udV0W2iQDg6Fds78PDG68+b0YjNpc1tDAd0axJre7SoafCMb2S3sqm9Pif Ne/LgCopv6z1X4T6SYpZRZWelu0sOCrk1rjsQL8FvtcJA2Fw8YkYAr/sUyy3ngZG9Q3H QYTA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b="HYaloY/A"; dkim=neutral (no key) header.i=@linutronix.de; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:8 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Received: from fry.vger.email (fry.vger.email. [2620:137:e000::3:8]) by mx.google.com with ESMTPS id t6-20020a17090ad50600b00286bf61a8b6si338558pju.184.2023.12.06.12.37.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 06 Dec 2023 12:37:57 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:8 as permitted sender) client-ip=2620:137:e000::3:8; Authentication-Results: mx.google.com; dkim=pass header.i=@linutronix.de header.s=2020 header.b="HYaloY/A"; dkim=neutral (no key) header.i=@linutronix.de; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:8 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=linutronix.de Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by fry.vger.email (Postfix) with ESMTP id 0D016802B81E; Wed, 6 Dec 2023 12:37:54 -0800 (PST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at fry.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1379573AbjLFUhp (ORCPT + 99 others); Wed, 6 Dec 2023 15:37:45 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:43882 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1379535AbjLFUhn (ORCPT ); Wed, 6 Dec 2023 15:37:43 -0500 Received: from galois.linutronix.de (Galois.linutronix.de [IPv6:2a0a:51c0:0:12e:550::1]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 442FD1A5; Wed, 6 Dec 2023 12:37:49 -0800 (PST) Date: Wed, 06 Dec 2023 20:37:46 -0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020; t=1701895067; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=DmqzdnVSaCif9lTTSTkVjsGHjFLNC1T4J8dN+L6XEQ8=; b=HYaloY/ARCZuBMNr2/41ylKEnOoSAHT/v9TGDARGS+Rf+rMQSFgUTCPcwle6dv/Jy3nk2n S0rwjkWBju9dOZt2jOFba0vzXFv1APUKGYFzCZar2ktII/YYjTkLo6hHH/bp1mtpDIhpPV S4eL22+zcW4m3uRpPaWdLVW57cnn3Rv/wGkdJq7z0acMujkCtoXKVPqog4acpUhaV1Q8sS lR1+G19MN4iLieiVwl1qZCy5Uq6Zq8NY5EWkD9SXSIl+IXMVWMBjbY9ExnQRVqX3KWU7Pv zU7O4vGxFexmSjIvR3jC4LUpmXDR80pP1AgA8MK0zUgSv3C6eI4bLMnG5okoRw== DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=linutronix.de; s=2020e; t=1701895067; h=from:from:sender:sender:reply-to:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=DmqzdnVSaCif9lTTSTkVjsGHjFLNC1T4J8dN+L6XEQ8=; b=lHBePM279ireXq9m69xnC3Yi0IZ3KFRQ5DtkeaONeXVCXwUXDPBt81FQV9a4SaMxF3OCAi D6UhtBVTiTjkgMCQ== From: "tip-bot2 for Borislav Petkov (AMD)" Sender: tip-bot2@linutronix.de Reply-to: linux-kernel@vger.kernel.org To: linux-tip-commits@vger.kernel.org Subject: [tip: ras/core] Documentation: Begin a RAS section Cc: "Borislav Petkov (AMD)" , x86@kernel.org, linux-kernel@vger.kernel.org In-Reply-To: <+u53@fat_crate.local> References: <+u53@fat_crate.local> MIME-Version: 1.0 Message-ID: <170189506697.398.1918586195547486556.tip-bot2@tip-bot2> Robot-ID: Robot-Unsubscribe: Contact to get blacklisted from these emails X-Spam-Status: No, score=-0.9 required=5.0 tests=DKIM_SIGNED,DKIM_VALID, DKIM_VALID_AU,HEADER_FROM_DIFFERENT_DOMAINS,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on fry.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (fry.vger.email [0.0.0.0]); Wed, 06 Dec 2023 12:37:54 -0800 (PST) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1784566333178668769 X-GMAIL-MSGID: 1784566333178668769 The following commit has been merged into the ras/core branch of tip: Commit-ID: cf0573939d3f4ce822ceb742a8179f38697b1953 Gitweb: https://git.kernel.org/tip/cf0573939d3f4ce822ceb742a8179f38697b1953 Author: Borislav Petkov (AMD) AuthorDate: Tue, 28 Nov 2023 15:20:49 +01:00 Committer: Borislav Petkov (AMD) CommitterDate: Wed, 06 Dec 2023 21:07:52 +01:00 Documentation: Begin a RAS section Add some initial RAS documentation. The expectation is for this to collect, among others, all the user-visible features for interaction with the RAS features of the kernel. Signed-off-by: Borislav Petkov (AMD) Link: https://lore.kernel.org/r/20231128142049.GTZWX3QQTSaQk/+u53@fat_crate.local --- Documentation/RAS/ras.rst | 26 ++++++++++++++++++++++++++ Documentation/index.rst | 1 + 2 files changed, 27 insertions(+) create mode 100644 Documentation/RAS/ras.rst diff --git a/Documentation/RAS/ras.rst b/Documentation/RAS/ras.rst new file mode 100644 index 0000000..2556b39 --- /dev/null +++ b/Documentation/RAS/ras.rst @@ -0,0 +1,26 @@ +.. SPDX-License-Identifier: GPL-2.0 + +Reliability, Availability and Serviceability features +===================================================== + +This documents different aspects of the RAS functionality present in the +kernel. + +Error decoding +--------------- + +* x86 + +Error decoding on AMD systems should be done using the rasdaemon tool: +https://github.com/mchehab/rasdaemon/ + +While the daemon is running, it would automatically log and decode +errors. If not, one can still decode such errors by supplying the +hardware information from the error:: + + $ rasdaemon -p --status --ipid --smca + +Also, the user can pass particular family and model to decode the error +string:: + + $ rasdaemon -p --status --ipid --smca --family --model --bank diff --git a/Documentation/index.rst b/Documentation/index.rst index 9dfdc82..36e6178 100644 --- a/Documentation/index.rst +++ b/Documentation/index.rst @@ -113,6 +113,7 @@ to ReStructured Text format, or are simply too old. :maxdepth: 1 staging/index + RAS/ras Translations