From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR05-AM6-obe.outbound.protection.outlook.com (mail-am6eur05on2068.outbound.protection.outlook.com [40.107.22.68]) by sourceware.org (Postfix) with ESMTPS id CD4F0385DC0D for ; Tue, 22 Aug 2023 11:22:02 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org CD4F0385DC0D Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=arm.com DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=d+5/9kzqrC02NjXWDS127SlXRQnQD+GH+FnxPOIagpU=; b=JD/q+UyHIYzV2P4FNC5IS2wy6elO/uHMU/MHCNFcmWFxD7JnOG0qqCFrPs+rhkEpiaMwk96/qOid7WPMtfL80Lnr+wgyxhEybciFA8b6bXp/orV+YxmLedzcUmK7pzFnMw2v11g4JTfdm/HicKraEFHZOoZ0lnuP9yJcGTxjqq8= Received: from DU2PR04CA0264.eurprd04.prod.outlook.com (2603:10a6:10:28e::29) by DBBPR08MB6234.eurprd08.prod.outlook.com (2603:10a6:10:202::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6699.25; Tue, 22 Aug 2023 11:21:59 +0000 Received: from DBAEUR03FT021.eop-EUR03.prod.protection.outlook.com (2603:10a6:10:28e:cafe::f6) by DU2PR04CA0264.outlook.office365.com (2603:10a6:10:28e::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6699.20 via Frontend Transport; Tue, 22 Aug 2023 11:21:59 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 63.35.35.123) smtp.mailfrom=arm.com; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com;dmarc=pass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 63.35.35.123 as permitted sender) receiver=protection.outlook.com; client-ip=63.35.35.123; helo=64aa7808-outbound-1.mta.getcheckrecipient.com; pr=C Received: from 64aa7808-outbound-1.mta.getcheckrecipient.com (63.35.35.123) by DBAEUR03FT021.mail.protection.outlook.com (100.127.142.184) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6723.15 via Frontend Transport; Tue, 22 Aug 2023 11:21:59 +0000 Received: ("Tessian outbound 169aaa6bf2b7:v175"); Tue, 22 Aug 2023 11:21:59 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 910e4da710df0a16 X-CR-MTA-TID: 64aa7808 Received: from a3e0d47831cd.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 4BBE6011-A9AA-4812-B382-92A3737C5F13.1; Tue, 22 Aug 2023 11:21:52 +0000 Received: from EUR04-VI1-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id a3e0d47831cd.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Tue, 22 Aug 2023 11:21:52 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=EzHlRe6EpnOtj/0pd5y5m5lt6ic5RShY8NnncTYs1XVzPTQ8H6BN0046ZOPKP/m0eiL/RvlQf7JL2UcgLD6AN/0a5c2DNQqoFJ/+FQiU1o1QPg/xcRSN82WpKd/7AM4TFySRRnz0pD/3PTGvDZU5va4lJIukjBVi4WjyoRZaV5mPDfZdfGhK4c9Ad40psmKfRqDhe1LVm1D/2fBHYxoNr07IpG3SC/WPGykA5/edJ3pgLeXsUL7pGhBPZ/Vw++Ia29/yhSSlNN3s+9MriwzpYQ6k0MUo/IL2Wm9GNZ79b+YkCV5LIMq3DHtXuf6if+ft9zm5roYxNCrSaqUhKDoTxA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1; bh=d+5/9kzqrC02NjXWDS127SlXRQnQD+GH+FnxPOIagpU=; b=cCBXJLJZlvUfb+cxnX3/exy642+xfJjn3rkibVx1WjT04m4Q7BdGO8rYQHsYTKsP9o3K1Uh9WSaq92TBacLhxjTChbjpHpDgIXDEa9iklxWyWQaOiiGw0BUigWVKLhdqgPwX/4gY1zvffybHsDHBdkzDjuFJPbK/QlJ5p0jhCEefJBIzUQaJsQV6EZ8ZYsBqhGYjH065My0BTA7Q1mu0+c5ntdUMjFFozJUK1Dhjk5EFqzmf0vIhMb5JMWG6EYRcQzTjU/Hw05eN7LHoM9YcP7oOh7wD3/IAInwiY3Uf9+D548IGd6gh9a0it6xSANP2Xc0FcHPu0XbB68Xrl+kvzg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass (sender ip is 40.67.248.234) smtp.rcpttodomain=sourceware.org smtp.mailfrom=arm.com; dmarc=pass (p=none sp=none pct=100) action=none header.from=arm.com; dkim=none (message not signed); arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=d+5/9kzqrC02NjXWDS127SlXRQnQD+GH+FnxPOIagpU=; b=JD/q+UyHIYzV2P4FNC5IS2wy6elO/uHMU/MHCNFcmWFxD7JnOG0qqCFrPs+rhkEpiaMwk96/qOid7WPMtfL80Lnr+wgyxhEybciFA8b6bXp/orV+YxmLedzcUmK7pzFnMw2v11g4JTfdm/HicKraEFHZOoZ0lnuP9yJcGTxjqq8= Received: from AS9PR06CA0762.eurprd06.prod.outlook.com (2603:10a6:20b:484::20) by AM8PR08MB6388.eurprd08.prod.outlook.com (2603:10a6:20b:36b::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6699.24; Tue, 22 Aug 2023 11:21:51 +0000 Received: from AM7EUR03FT034.eop-EUR03.prod.protection.outlook.com (2603:10a6:20b:484:cafe::6d) by AS9PR06CA0762.outlook.office365.com (2603:10a6:20b:484::20) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6699.20 via Frontend Transport; Tue, 22 Aug 2023 11:21:50 +0000 X-MS-Exchange-Authentication-Results: spf=pass (sender IP is 40.67.248.234) smtp.mailfrom=arm.com; dkim=none (message not signed) header.d=none;dmarc=pass action=none header.from=arm.com; Received-SPF: Pass (protection.outlook.com: domain of arm.com designates 40.67.248.234 as permitted sender) receiver=protection.outlook.com; client-ip=40.67.248.234; helo=nebula.arm.com; pr=C Received: from nebula.arm.com (40.67.248.234) by AM7EUR03FT034.mail.protection.outlook.com (100.127.140.87) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6723.15 via Frontend Transport; Tue, 22 Aug 2023 11:21:50 +0000 Received: from AZ-NEU-EX04.Arm.com (10.251.24.32) by AZ-NEU-EX03.Arm.com (10.251.24.31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.27; Tue, 22 Aug 2023 11:21:46 +0000 Received: from e129171.cambridge.arm.com (10.1.34.58) by mail.arm.com (10.251.24.32) with Microsoft SMTP Server id 15.1.2507.27 via Frontend Transport; Tue, 22 Aug 2023 11:21:46 +0000 From: Luis Machado To: CC: Subject: [PATCH v2 6/6] [gdb/docs] sme2: Document SME2 registers and features Date: Tue, 22 Aug 2023 12:21:44 +0100 Message-ID: <20230822112144.1513268-7-luis.machado@arm.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230822112144.1513268-1-luis.machado@arm.com> References: <20230822112144.1513268-1-luis.machado@arm.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-EOPAttributedMessage: 1 X-MS-TrafficTypeDiagnostic: AM7EUR03FT034:EE_|AM8PR08MB6388:EE_|DBAEUR03FT021:EE_|DBBPR08MB6234:EE_ X-MS-Office365-Filtering-Correlation-Id: a89d2ff4-4b2f-49da-c1b9-08dba302002a x-checkrecipientrouted: true NoDisclaimer: true X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam-Untrusted: BCL:0; X-Microsoft-Antispam-Message-Info-Original: Y6GLPlMhRXljM97RQuxJvgQxluqcpulHdxEMGSBy5z9gMhaBDFEh3iQjFi/J/dsNPMG4cbWikHZG9khjNVbLF1i6nRedNpYvi9VaTbEghMzBCIjAp8S8rBW6A9jed+lHMa0xvCDzJU+ra4xUEFFy8whznePTmToDrNb8Xp/5mtrPFVm7vk+uJ8rEaG6FB8/h+9TgddPUtJ+u7ibLFw98HmZZDX+3TIdKIx91+Dj+yT+M+Mj6UPxwBgI/rHMfMDKIogl8SCUzar1Ap+XZewT5HqUvFMXuDSeRyQA1cEYqoRQCZhXYzKDX3nHkgdRHBzJTIzGXtu5pqgsdEMi9akhVrQck+nYs+TMo350oO0tdcRuCTddpoiXt+FsZCYC4V252NRQC7hD8g7CextaQT5VoR3Ouii+Lk42Xyy59bNIIDQNJJWArxzir6eEWXHWGHo9Pq7z9ovSk6tVnW+qEEm/FRoJEKc8o4VrlbvS3wCQnPkqIsw2fP62TyiGj0H1OPLwcdZXA87DCJcr25/bznoJfzVsuIjjvvdb4zCfFKQb/wdxWNI3VVSiJw6VDKPLslPre6sNbm/wddRI9t7em1BcHvBEBsONfxSisx8669HJNY0pJGqj9z6Lf/gURL8e24EG4grDQl2zTtiWP1y5mOcwfe8vIGAretE4K+mXwnRv6O1wx2T2L2K4TrH4F9ocCbOpX9E5tFkll219Cca6buAHkCT5uLvKbUbxKFyvFcakyelK7DPys1DlpgIoVh+/6UlPMsR70wDgklLM1CBx1eokxVQ== X-Forefront-Antispam-Report-Untrusted: CIP:40.67.248.234;CTRY:IE;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:nebula.arm.com;PTR:InfoDomainNonexistent;CAT:NONE;SFS:(13230031)(4636009)(136003)(376002)(396003)(39860400002)(346002)(1800799009)(186009)(451199024)(82310400011)(36840700001)(40470700004)(46966006)(6916009)(316002)(70586007)(70206006)(8676002)(8936002)(2616005)(4326008)(36756003)(40460700003)(41300700001)(1076003)(82740400003)(356005)(81166007)(478600001)(40480700001)(83380400001)(2906002)(86362001)(47076005)(7696005)(36860700001)(336012)(44832011)(426003)(5660300002)(26005)(36900700001);DIR:OUT;SFP:1101; X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM8PR08MB6388 X-MS-Exchange-Transport-CrossTenantHeadersStripped: DBAEUR03FT021.eop-EUR03.prod.protection.outlook.com X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id-Prvs: fbadfa77-e20e-43bd-0b0f-08dba301fb50 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: wPmoe82jDSTKke/UDx+ergESN3SjVakJWuHLE5hXJsRmALpIaXE6gChmMeEk7c/6dlxuHSKoE2vCGk6l2OLxSrG/vxgx+RG8wAz53ts7FFYzcakKiYNhJqRra4mF9VYS07PTzZfyyd9A4Xn/XAogPSqbI0LSsnQyXjkHKIXAj0OM1TVCiLTO6yYVqVl0AP8X5jxr5ZOlV/coxiFVZ3YzARoK27D1+6Fdj/L8+MuTmd8jrEjC+INg+Nhshm9A20OpURLSq9ef5gZarv8rZvQR6cnARPVPKPywiqeJ2bwy2x6pAXCSdYIOdwHBMzqaXPkG48HFT9OkXwIoPLm1FJk/33muFT2jnfEMklBLA717rh4zQCPMnMOG9YzBH4M8e5zOBJhniz9VwG64AULmbmO5CXmF71JxSo/OfNZJyZo/Zxip3w50uJmZ9l+RBW4deuY0Q9b2d8Ff1OC5Vxa/uTCDskiCU5zhDzwpiEIpe96e7B7Et/bz8WkmRIMdJDr27VmcWWbS2QjLsHGuDuZzB2IhqLU1ZNVdnfvZwY+R1Ni95ygGfxR4bVWOdRbJElJaj1mIQFebYXrx0EsgiPbde2VA/hI3fFGZZ47hiv00tM6P8GapUlYpUf2KIjDLFUH1gOv3yVdIuwlxOkuct+jWvIujehiqg2Rk3cWGpEr3gEjfBXdTWpHRPrXHCKThr5AxGNPvHf08z3kBxzHFUMGAqVsz4A70WZY8H51ZYA4LLwKZW5U= X-Forefront-Antispam-Report: CIP:63.35.35.123;CTRY:IE;LANG:en;SCL:1;SRV:;IPV:CAL;SFV:NSPM;H:64aa7808-outbound-1.mta.getcheckrecipient.com;PTR:ec2-63-35-35-123.eu-west-1.compute.amazonaws.com;CAT:NONE;SFS:(13230031)(4636009)(39860400002)(376002)(346002)(136003)(396003)(186009)(1800799009)(82310400011)(451199024)(40470700004)(36840700001)(46966006)(478600001)(1076003)(7696005)(426003)(107886003)(2616005)(336012)(2906002)(70586007)(70206006)(26005)(41300700001)(8936002)(44832011)(4326008)(6916009)(316002)(8676002)(5660300002)(36756003)(86362001)(36860700001)(47076005)(83380400001)(82740400003)(81166007)(40480700001)(40460700003);DIR:OUT;SFP:1101; X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 22 Aug 2023 11:21:59.1121 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: a89d2ff4-4b2f-49da-c1b9-08dba302002a X-MS-Exchange-CrossTenant-Id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp: TenantId=f34e5979-57d9-4aaa-ad4d-b122a662184d;Ip=[63.35.35.123];Helo=[64aa7808-outbound-1.mta.getcheckrecipient.com] X-MS-Exchange-CrossTenant-AuthSource: DBAEUR03FT021.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DBBPR08MB6234 X-Spam-Status: No, score=-11.8 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,FORGED_SPF_HELO,GIT_PATCH_0,KAM_DMARC_NONE,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H2,SPF_HELO_PASS,SPF_NONE,TXREP,UNPARSEABLE_RELAY autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: Document changes introduced by gdb's SME2 support. --- gdb/NEWS | 3 +++ gdb/doc/gdb.texinfo | 65 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 68 insertions(+) diff --git a/gdb/NEWS b/gdb/NEWS index 49acc765ea7..20d1ffe4880 100644 --- a/gdb/NEWS +++ b/gdb/NEWS @@ -3,6 +3,9 @@ *** Changes since GDB 13 +* GDB now supports the AArch64 Scalable Matrix Extension 2 (SME2), which + includes a new 512 bit lookup table register named ZT0. + * GDB now supports the AArch64 Scalable Matrix Extension (SME), which includes a new matrix register named ZA, a new thread register TPIDR2 and a new vector length register SVG (streaming vector granule). GDB also supports tracking diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 23a40f0e8de..0b2f4a8d26d 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -26358,6 +26358,50 @@ incorrect values for SVE registers (when in streaming mode). This is the same limitation we have for the @acronym{SVE} registers, and there are plans to address this limitation going forward. +@subsubsection AArch64 SME2. +@anchor{AArch64 SME2} +@cindex SME2 +@cindex AArch64 SME2 +@cindex Scalable Matrix Extension 2 + +The Scalable Matrix Extension 2 is an AArch64 architecture extension that +further expands the @acronym{SME} extension with the following: + +@itemize + +@item The ability to address the @code{ZA} array through groups of +one-dimensional @code{ZA} array vectors, as opposed to @code{ZA} tiles +with 2 dimensions. + +@item Instructions to operate on groups of @acronym{SVE} @code{Z} registers and +@code{ZA} array vectors. + +@item A new 512 bit @code{ZT0} lookup table register, for data decompression. + +@end itemize + +When @value{GDBN} is debugging the AArch64 architecture, if the Scalable Matrix +Extension 2 (@acronym{SME2}) is present, then @value{GDBN} will make the +@code{ZT0} register available. + +The @code{ZT0} register is only considered active when the @code{ZA} register +state is active, therefore when the @sc{za} bit of the @code{SVCR} is 1. + +When the @sc{za} bit of @code{SVCR} is 0, that means the @code{ZA} register +state is not active, which means the @code{ZT0} register state is also not +active. + +When @code{ZT0} is not active, it is comprised of zeroes, just like @code{ZA}. + +Similarly to the @code{ZA} register, if the @code{ZT0} state is not active and +the user attempts to modify its value such that any of its bytes is non-zero, +then @value{GDBN} will initialize the @code{ZA} register state as well, which +means the @code{SVCR} @sc{za} bit gets set to 1. + +For more information about @acronym{SME2}, please refer to the +official @url{https://developer.arm.com/documentation/ddi0487/latest, +architecture documentation}. + @subsubsection AArch64 Pointer Authentication. @cindex AArch64 Pointer Authentication. @anchor{AArch64 PAC} @@ -48540,6 +48584,27 @@ extensions of the architecture. Extra registers are allowed in this feature, but they will not affect @value{GDBN}. +The @samp{org.gnu.gdb.aarch64.sme} feature is required when the target also +reports support for the @samp{org.gnu.gdb.aarch64.sme2} feature. + +@subsubsection AArch64 SME2 registers feature + +The @samp{org.gnu.gdb.aarch64.sme2} feature is optional. If present, +then the @samp{org.gnu.gdb.aarch64.sme} feature must also be present. The +@samp{org.gnu.gdb.aarch64.sme2} feature should contain the following: +@xref{AArch64 SME2} + +@itemize @minus + +@item +@code{ZT0} is a register of 512 bits (64 bytes). It is defined as a vector +of bytes. + +@end itemize + +Extra registers are allowed in this feature, but they will not affect +@value{GDBN}. + @node ARC Features @subsection ARC Features @cindex target descriptions, ARC Features -- 2.25.1