From patchwork Mon Jun 24 15:09:42 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Robert Richter X-Patchwork-Id: 167615 Delivered-To: patch@linaro.org Received: by 2002:a92:4782:0:0:0:0:0 with SMTP id e2csp4348122ilk; Mon, 24 Jun 2019 08:09:57 -0700 (PDT) X-Google-Smtp-Source: APXvYqzZxZHvHdFtH1Rw6vFXXNsXkTfcnf2lRAW4v7FWfSE4z7P3RDrsyr7evOGKD2knCWptX2Pw X-Received: by 2002:a17:90a:2706:: with SMTP id o6mr26022780pje.62.1561388997059; Mon, 24 Jun 2019 08:09:57 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1561388997; cv=none; d=google.com; s=arc-20160816; b=FNoy06aDQR245mB3oJjfsyriRV24jUBpHT8zvwriMdSqgzLv83u80lpMy56U9/ENu9 5N1YnuoxVlAkMsCbYsC49IE+sv7JdxcqKSCaiUF20f//vacMIv6ZOKzB5CGCYK5QKBlv 0KWFrXlET3/CQ9DgVqLJT0cOslZxZkUCfVpZUowvm79zOc3AOB6wDWs9SJfMgSoHYFBn MXzI7dEmQxrmuAOL9KlglG44uW7EWcPWMOSDxrZO89MIXCJeIQ1LGKBv8f5mmsisaUty /XDrib/3FBhE/9p1tZEyAnIVccp8ceHxE+VtNTb2eSwf6cQ6IGMO9oTyoEYVcCHslbjB xbBg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:mime-version:content-transfer-encoding :content-language:accept-language:in-reply-to:references:message-id :date:thread-index:thread-topic:subject:cc:to:from:dkim-signature :dkim-signature; bh=WGLFp4pMQEFqnYop+HzdF+dqUTZFIfj7jmF0nxJn8Zg=; b=TY4vGWyed9JyXw1HHyqbSRGbNoraBIVAT/4Qnz2Ue+ksvsKvClYJczugpwmjwWqExa AisK1DQ/W7at7C2nwhvvSdu5EruPHKecLBOq8eVMOlhEGI68MR9kXRX8dVpx1T8/Qhp7 RM2jtiShjkZ08Bg/pTgZ2p5uevuLJ/8uUIj3TIikTnqk63vH4qRX45Eg4yzsj1FgCfIZ qeWZzTVNVSn0QFiWRO6HqvoCMoj7V/8zRd9/u3ipJa4mcssdy6kQsXZ3J4j+JrS9gyn5 Unlc3vJGvOcnUAY5uWYYS5SfC/rBWwvcJD41utyIidDF0/vtwrzxciZP5zzDvH+HisJe mPig== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@marvell.com header.s=pfpt0818 header.b=eoFkrXJV; dkim=pass header.i=@marvell.onmicrosoft.com header.s=selector2-marvell-onmicrosoft-com header.b=HgRd42z+; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=marvell.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id j74si11500049pje.12.2019.06.24.08.09.56; Mon, 24 Jun 2019 08:09:57 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; dkim=pass header.i=@marvell.com header.s=pfpt0818 header.b=eoFkrXJV; dkim=pass header.i=@marvell.onmicrosoft.com header.s=selector2-marvell-onmicrosoft-com header.b=HgRd42z+; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=marvell.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1730895AbfFXPJz (ORCPT + 30 others); Mon, 24 Jun 2019 11:09:55 -0400 Received: from mx0a-0016f401.pphosted.com ([67.231.148.174]:28516 "EHLO mx0b-0016f401.pphosted.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1730860AbfFXPJw (ORCPT ); Mon, 24 Jun 2019 11:09:52 -0400 Received: from pps.filterd (m0045849.ppops.net [127.0.0.1]) by mx0a-0016f401.pphosted.com (8.16.0.27/8.16.0.27) with SMTP id x5OF0Dhp018663; Mon, 24 Jun 2019 08:09:45 -0700 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.com; h=from : to : cc : subject : date : message-id : references : in-reply-to : content-type : content-transfer-encoding : mime-version; s=pfpt0818; bh=WGLFp4pMQEFqnYop+HzdF+dqUTZFIfj7jmF0nxJn8Zg=; b=eoFkrXJVOphEEUK0J7vYV8gCgNcDj4rkfeq2w3EoPD8CqtDKx10LgqeX2D7gQLsK0afi TBigNGdxpGgfnVJA3rpOYElU9+hVLL1Zg/EVN4YJBIDDtGx9elhBNGd12+e44O+BFRJy c0X/HvT1qNmhvRWVL8wWFyt9VM2zEy/Jcc8+O7Vim2Qi2Hx0zXsuVMHCAvqozPN8gS6L 2InfJZlbYK8C3etP90jS0XGSL5d97LjBTpPXJZ5oeeLmuDMwvHEMXBurRK7lhtGdC1Wy B6T3zVwA8yD7H0SfvKo44sUA4r3cJM4mxPrKk7+KtLQlQmEhfFeWhXt7G7ErKdOxJq+c AA== Received: from sc-exch01.marvell.com ([199.233.58.181]) by mx0a-0016f401.pphosted.com with ESMTP id 2tarxr9tcf-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Mon, 24 Jun 2019 08:09:44 -0700 Received: from SC-EXCH04.marvell.com (10.93.176.84) by SC-EXCH01.marvell.com (10.93.176.81) with Microsoft SMTP Server (TLS) id 15.0.1367.3; Mon, 24 Jun 2019 08:09:43 -0700 Received: from NAM04-CO1-obe.outbound.protection.outlook.com (104.47.45.59) by SC-EXCH04.marvell.com (10.93.176.84) with Microsoft SMTP Server (TLS) id 15.0.1367.3 via Frontend Transport; Mon, 24 Jun 2019 08:09:43 -0700 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=marvell.onmicrosoft.com; s=selector2-marvell-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=WGLFp4pMQEFqnYop+HzdF+dqUTZFIfj7jmF0nxJn8Zg=; b=HgRd42z+3vSbZhCy/yY+0RV0UimhQ5XYbGAJvBTQya1yNjpsMKoi3KzyUqPdxydlBZLzgvqjsA65+HNA9tAadF2Y4IX4ZnIevePosH3O3GOEoReaSymimM+oxn4QWr0cQcx9lZXAXQa0Q7NTQDBt1ihGVEMflFklxpbwzQFNxYg= Received: from MN2PR18MB3408.namprd18.prod.outlook.com (10.255.238.217) by MN2PR18MB3197.namprd18.prod.outlook.com (10.255.236.158) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2008.13; Mon, 24 Jun 2019 15:09:42 +0000 Received: from MN2PR18MB3408.namprd18.prod.outlook.com ([fe80::d3:794c:1b94:cf3]) by MN2PR18MB3408.namprd18.prod.outlook.com ([fe80::d3:794c:1b94:cf3%4]) with mapi id 15.20.2008.014; Mon, 24 Jun 2019 15:09:42 +0000 From: Robert Richter To: Borislav Petkov , James Morse , "Mauro Carvalho Chehab" , Tony Luck , Jonathan Corbet CC: "linux-edac@vger.kernel.org" , "linux-kernel@vger.kernel.org" , Robert Richter , "linux-doc@vger.kernel.org" Subject: [PATCH v2 23/24] EDAC, Documentation: Describe CPER module definition and DIMM ranks Thread-Topic: [PATCH v2 23/24] EDAC, Documentation: Describe CPER module definition and DIMM ranks Thread-Index: AQHVKp7ZS8LjERln60y0i8Uoi5Y0PA== Date: Mon, 24 Jun 2019 15:09:42 +0000 Message-ID: <20190624150758.6695-24-rrichter@marvell.com> References: <20190624150758.6695-1-rrichter@marvell.com> In-Reply-To: <20190624150758.6695-1-rrichter@marvell.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-clientproxiedby: HE1P190CA0035.EURP190.PROD.OUTLOOK.COM (2603:10a6:7:52::24) To MN2PR18MB3408.namprd18.prod.outlook.com (2603:10b6:208:16c::25) x-ms-exchange-messagesentrepresentingtype: 1 x-mailer: git-send-email 2.20.1 x-originating-ip: [92.254.182.202] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 8b4851e0-917e-461f-531a-08d6f8b5fc0a x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600148)(711020)(4605104)(1401327)(2017052603328)(7193020); SRVR:MN2PR18MB3197; x-ms-traffictypediagnostic: MN2PR18MB3197: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:8273; x-forefront-prvs: 007814487B x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(39860400002)(366004)(136003)(396003)(346002)(376002)(199004)(189003)(36756003)(110136005)(54906003)(81156014)(81166006)(68736007)(8676002)(25786009)(5660300002)(8936002)(305945005)(7736002)(4326008)(1076003)(186003)(6116002)(14454004)(476003)(486006)(2616005)(11346002)(256004)(14444005)(446003)(3846002)(50226002)(26005)(2906002)(52116002)(76176011)(71200400001)(71190400001)(99286004)(386003)(6506007)(102836004)(478600001)(316002)(86362001)(6512007)(66066001)(53936002)(6486002)(73956011)(66946007)(66476007)(66556008)(64756008)(66446008)(6436002); DIR:OUT; SFP:1101; SCL:1; SRVR:MN2PR18MB3197; H:MN2PR18MB3408.namprd18.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1; received-spf: None (protection.outlook.com: marvell.com does not designate permitted sender hosts) x-ms-exchange-senderadcheck: 1 x-microsoft-antispam-message-info: 35kuKiqfEN76kJTUZYkkbBY/gs7U2YHYeiY/T+PE74/hVW+deFE5f0k60h//r2BmFM1Sk2dThcC2yQbhDjErIvJFWgYOX4/mAmn19RXLRy/jRZv7zKrnCn0YEqByIi1UJCpI5QnVqA59tFeHpoJi5xR40N+NeG6AAezcGVZihfHL6ENm5k6JPhLFPMhaxHHipt7lIfO2mJVHYBlF0j4I+dGKe7idN+SGkc+/WvX29iKUTwJDUB/B/zzYGO1H+uc9eGHuXy+Mdf708O7H6xrNXvCy2PHMAIGxPEvfHCd4uvUvHwh9DMwEXX/0/ifMbicAQZEPFKZ4jal4vw02C+bsCylqEp+UDsgzzbr4W79Ni5L891SipcpYTI42CGfRUWGwTjo1C89L1dUFPYfLWz9VHHTHQ+HLVirn5Jj2u0kG1UI= MIME-Version: 1.0 X-MS-Exchange-CrossTenant-Network-Message-Id: 8b4851e0-917e-461f-531a-08d6f8b5fc0a X-MS-Exchange-CrossTenant-originalarrivaltime: 24 Jun 2019 15:09:42.2856 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 70e1fb47-1155-421d-87fc-2e58f638b6e0 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: rrichter@marvell.com X-MS-Exchange-Transport-CrossTenantHeadersStamped: MN2PR18MB3197 X-OriginatorOrg: marvell.com X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-06-24_10:, , signatures=0 Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Update on CPER DIMM naming convention and DIMM ranks. Signed-off-by: Robert Richter --- Documentation/admin-guide/ras.rst | 31 +++++++++++++++++++------------ 1 file changed, 19 insertions(+), 12 deletions(-) -- 2.20.1 diff --git a/Documentation/admin-guide/ras.rst b/Documentation/admin-guide/ras.rst index c7495e42e6f4..4e2a01c77a9c 100644 --- a/Documentation/admin-guide/ras.rst +++ b/Documentation/admin-guide/ras.rst @@ -330,9 +330,12 @@ There can be multiple csrows and multiple channels. .. [#f4] Nowadays, the term DIMM (Dual In-line Memory Module) is widely used to refer to a memory module, although there are other memory - packaging alternatives, like SO-DIMM, SIMM, etc. Along this document, - and inside the EDAC system, the term "dimm" is used for all memory - modules, even when they use a different kind of packaging. + packaging alternatives, like SO-DIMM, SIMM, etc. The UEFI + specification (Version 2.7) defines a memory module in the Common + Platform Error Record (CPER) section to be an SMBIOS Memory Device + (Type 17). Along this document, and inside the EDAC system, the term + "dimm" is used for all memory modules, even when they use a + different kind of packaging. Memory controllers allow for several csrows, with 8 csrows being a typical value. Yet, the actual number of csrows depends on the layout of @@ -349,12 +352,14 @@ controllers. The following example will assume 2 channels: | | ``ch0`` | ``ch1`` | +============+===========+===========+ | ``csrow0`` | DIMM_A0 | DIMM_B0 | - +------------+ | | - | ``csrow1`` | | | + | | rank0 | rank0 | + +------------+ - | - | + | ``csrow1`` | rank1 | rank1 | +------------+-----------+-----------+ | ``csrow2`` | DIMM_A1 | DIMM_B1 | - +------------+ | | - | ``csrow3`` | | | + | | rank0 | rank0 | + +------------+ - | - | + | ``csrow3`` | rank1 | rank1 | +------------+-----------+-----------+ In the above example, there are 4 physical slots on the motherboard @@ -374,11 +379,13 @@ which the memory DIMM is placed. Thus, when 1 DIMM is placed in each Channel, the csrows cross both DIMMs. Memory DIMMs come single or dual "ranked". A rank is a populated csrow. -Thus, 2 single ranked DIMMs, placed in slots DIMM_A0 and DIMM_B0 above -will have just one csrow (csrow0). csrow1 will be empty. On the other -hand, when 2 dual ranked DIMMs are similarly placed, then both csrow0 -and csrow1 will be populated. The pattern repeats itself for csrow2 and -csrow3. +In the example above 2 dual ranked DIMMs are similarly placed. Thus, +both csrow0 and csrow1 are populated. On the other hand, when 2 single +ranked DIMMs are placed in slots DIMM_A0 and DIMM_B0, then they will +have just one csrow (csrow0) and csrow1 will be empty. The pattern +repeats itself for csrow2 and csrow3. Also note that some memory +controller doesn't have any logic to identify the memory module, see +``rankX`` directories below. The representation of the above is reflected in the directory tree in EDAC's sysfs interface. Starting in directory