From patchwork Wed May 29 08:44:50 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Robert Richter X-Patchwork-Id: 165341 Delivered-To: patch@linaro.org Received: by 2002:a92:9e1a:0:0:0:0:0 with SMTP id q26csp9580378ili; Wed, 29 May 2019 01:45:13 -0700 (PDT) X-Google-Smtp-Source: APXvYqzxoKimbtFiosq2ANsh8zzocOn5yaEMHR5YKuq7Oy2gU2S2YrwuJ28TCGGl1uDHLwAeK6h6 X-Received: by 2002:a17:90a:2561:: with SMTP id j88mr10612629pje.121.1559119512898; Wed, 29 May 2019 01:45:12 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1559119512; cv=none; d=google.com; s=arc-20160816; b=nU1o6DJBG38VJJ1rQCCVuTe+lynqixB3E/uJ49PVWr7imoh4/8ab441oPOw9uBT+vZ l+jGETNenw2JFiH/W9CyiKxJPw+lzEaJSw8xWZ7L2YrrR3jz9UBqYA2C/4hgKMJ0/iCT P8yMQtBO6zTswLY07HwNLjWRaTJ9/wOafIWf8FeTvr1UHfYY3pQJMsXu/IOd3gsgPFRr eiIhykqpQQ9pzLROZFaISHwPUJ9xAAocA8nu3zSikhoLuWjhi+3/iWOa+VU+s33Pc7ac sTA02Bq6BfIqTROmHBMCBYZAyrL5vn8HdGts1mdWVwCr0NUHWpt4KwjuFbBf5p8Q1VB3 35Vg== 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=OsOv9NYZY/eEycVTpje7q2M4ZDTkzGfXukeaN500kfa+NVN/aAAki0qXvUB54dd0Pt mXkNT2LrJ/SZ5MHZDMwfCw0HQx6pXymse4BvNuqns2sKLqEgWT6iPiSPNTjII2H9tJ8Y bZBhpVQ1rjwmRHCR5KsuA0LXWS9yrXRUbmCtW3paeeRFA4qxcvJ5qB7dDRtIDI/myHpn L2Exqms5b72E7rdAvqrOu83meLUkV/UlQqDIPY0focpafwf0xyWp+a/6JsS3a/PGYp5M TQr+/F+Tec2a9gDnfaYi84TI6QUOwXHYOUMc6Q6FHhnr3+ttO+4M1TXBUwdcOXR9JDnv gm2A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@marvell.com header.s=pfpt0818 header.b=mXo9X9jS; dkim=pass header.i=@marvell.onmicrosoft.com header.s=selector2-marvell-onmicrosoft-com header.b=BL25x7GM; 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 c30si444467pje.1.2019.05.29.01.45.12; Wed, 29 May 2019 01:45:12 -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=mXo9X9jS; dkim=pass header.i=@marvell.onmicrosoft.com header.s=selector2-marvell-onmicrosoft-com header.b=BL25x7GM; 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 S1727012AbfE2IpL (ORCPT + 30 others); Wed, 29 May 2019 04:45:11 -0400 Received: from mx0a-0016f401.pphosted.com ([67.231.148.174]:35598 "EHLO mx0b-0016f401.pphosted.com" rhost-flags-OK-OK-OK-FAIL) by vger.kernel.org with ESMTP id S1726943AbfE2IpA (ORCPT ); Wed, 29 May 2019 04:45:00 -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 x4T8ir3e026203; Wed, 29 May 2019 01:44:53 -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=mXo9X9jST62+y77wx7xYgiQ8QlhDDGoTTTCCK/QpCLUkSX76q0NIUMO4dVmBTgOT+0Hp y0Tszk0GLWWgdenMI5ipC8h5psavm1x9b+fIBUIrwT7TGM4AliKLGFTl2X8f0pzSR0In 7ZqRQOZshBBNRLu2m5VcyXSOKieNhUy/oCdmI0d/5qwHWnM4Oz0M0MiFx/HCIAOlyghV YYJfepLOmIGBWVooPrIMnd+m2vZHfM6cAH0TW6g+Q6hwAQTwYlBXDuxqgQhL93dy0AF9 BIH48UcOWEmOhokIimVNLFCnUDqMcdS+/qGNgkoTp1zn0z2lWYM9KhnlHGgwcKsQpUds RA== Received: from sc-exch01.marvell.com ([199.233.58.181]) by mx0a-0016f401.pphosted.com with ESMTP id 2sspkpg1rm-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-SHA384 bits=256 verify=NOT); Wed, 29 May 2019 01:44:52 -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; Wed, 29 May 2019 01:44:52 -0700 Received: from NAM03-CO1-obe.outbound.protection.outlook.com (104.47.40.51) by SC-EXCH04.marvell.com (10.93.176.84) with Microsoft SMTP Server (TLS) id 15.0.1367.3 via Frontend Transport; Wed, 29 May 2019 01:44:52 -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=BL25x7GMgBd9YkcsPkVnPo45i538m88ubp/AkybYVAmlaTSLXHUpZMUaynSbrK6yo1AtZtnNG7OxHTWi7WESDSJYe+bU97+rgYG6m+spbJsK5JPrJrfNgpPkNnVAycpnCJb3Gk51t7/x0Hd2aCuxb2a35R3QuKIOJD8C9sMkQYE= Received: from MN2PR18MB3408.namprd18.prod.outlook.com (10.255.238.217) by MN2PR18MB3437.namprd18.prod.outlook.com (10.255.239.22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.1922.20; Wed, 29 May 2019 08:44:50 +0000 Received: from MN2PR18MB3408.namprd18.prod.outlook.com ([fe80::7c9a:f3bf:fe2e:fe4a]) by MN2PR18MB3408.namprd18.prod.outlook.com ([fe80::7c9a:f3bf:fe2e:fe4a%4]) with mapi id 15.20.1922.021; Wed, 29 May 2019 08:44:50 +0000 From: Robert Richter To: Borislav Petkov , Tony Luck , "James Morse" , Mauro Carvalho Chehab , Jonathan Corbet CC: "linux-edac@vger.kernel.org" , "linux-kernel@vger.kernel.org" , Robert Richter , "linux-doc@vger.kernel.org" Subject: [PATCH 21/21] EDAC, Documentation: Describe CPER module definition and DIMM ranks Thread-Topic: [PATCH 21/21] EDAC, Documentation: Describe CPER module definition and DIMM ranks Thread-Index: AQHVFfrG8kotEYU2/kiYp+ZR4jzKsA== Date: Wed, 29 May 2019 08:44:50 +0000 Message-ID: <20190529084344.28562-22-rrichter@marvell.com> References: <20190529084344.28562-1-rrichter@marvell.com> In-Reply-To: <20190529084344.28562-1-rrichter@marvell.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-clientproxiedby: AM6PR01CA0046.eurprd01.prod.exchangelabs.com (2603:10a6:20b:e0::23) 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: [78.54.13.57] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 72569946-e427-43a1-d470-08d6e411e940 x-microsoft-antispam: BCL:0; PCL:0; RULEID:(2390118)(7020095)(4652040)(8989299)(4534185)(4627221)(201703031133081)(201702281549075)(8990200)(5600148)(711020)(4605104)(1401327)(2017052603328)(7193020); SRVR:MN2PR18MB3437; x-ms-traffictypediagnostic: MN2PR18MB3437: x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:8273; x-forefront-prvs: 0052308DC6 x-forefront-antispam-report: SFV:NSPM; SFS:(10009020)(366004)(346002)(396003)(376002)(39860400002)(136003)(189003)(199004)(8936002)(4326008)(53936002)(50226002)(110136005)(68736007)(36756003)(5660300002)(54906003)(11346002)(26005)(186003)(52116002)(2906002)(2616005)(476003)(446003)(6506007)(14454004)(66476007)(25786009)(478600001)(386003)(86362001)(486006)(81166006)(81156014)(8676002)(305945005)(316002)(7736002)(14444005)(256004)(99286004)(76176011)(6512007)(6436002)(73956011)(64756008)(66446008)(66556008)(66066001)(3846002)(66946007)(1076003)(6486002)(102836004)(71190400001)(71200400001)(6116002); DIR:OUT; SFP:1101; SCL:1; SRVR:MN2PR18MB3437; H:MN2PR18MB3408.namprd18.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A: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: 5XuTA4jAGJ/VfwfBoe2s4eaInHwdRrcEXfFZazxtwTuP4T8MKva2c8LGvdjFd/bzvjYFQyLaMHR+Qc6aKIPoMBGXI+VU171untRJBcmwH4KTJSZHeRpGCKSqcQki+GCrGo6GBkZomwGDJpP6Dwd70LASeNJUrm8ekyjlfZFG7teS18mwAlrwsbXvToRqQqqpenGTpH+Q5pCEtgmQIBkJFCw1GyvQ/R1PUOVSeVpYOpdN2+vq3FeFW17aUtv2i9VKEnd5/Jh77JuudWCv3DX7EZY0kQYOir7+DJMHccNT2XgH4xIp1YPfoRqlpyVXH9sryJdKAFgBUYt9bSqbzqYC8Zui5gp3BAGz81od+gTIegBvIOLFLNfv8PiH3WIypAL2z7iWax1ii0olNzBdkL1OTsZt5BfuoQq0hQMDw8gvtn0= MIME-Version: 1.0 X-MS-Exchange-CrossTenant-Network-Message-Id: 72569946-e427-43a1-d470-08d6e411e940 X-MS-Exchange-CrossTenant-originalarrivaltime: 29 May 2019 08:44:50.1853 (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: MN2PR18MB3437 X-OriginatorOrg: marvell.com X-Proofpoint-Virus-Version: vendor=fsecure engine=2.50.10434:, , definitions=2019-05-29_05:, , 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