From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR05-AM6-obe.outbound.protection.outlook.com (mail-am6eur05on2048.outbound.protection.outlook.com [40.107.22.48]) by sourceware.org (Postfix) with ESMTPS id 25A0F385DC0B for ; Thu, 7 Sep 2023 15:21:22 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 25A0F385DC0B 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=2UNVNDZoJTl+YEsYi8L8pf24nJU+LLJhQb3ZE2q1euo=; b=Aepvolh6jPxGYZjCyVi9zPO2MqSb5SFbrLFsy8ir8QiBGTXO7ruZ1yob8ot5WIuGjgwtWGoiTRyblBcJRcffPOU/1B5R21Na5TcyWYPx9hO36rbUyjpTNHcPhbf50431gfs0A0FQVZOQCfkdeEPPvplPtRHtxMpVRtOCOHlyNCw= Received: from AS9PR06CA0429.eurprd06.prod.outlook.com (2603:10a6:20b:49e::12) by AS8PR08MB9456.eurprd08.prod.outlook.com (2603:10a6:20b:5ec::19) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6745.33; Thu, 7 Sep 2023 15:21:19 +0000 Received: from AM7EUR03FT015.eop-EUR03.prod.protection.outlook.com (2603:10a6:20b:49e:cafe::43) by AS9PR06CA0429.outlook.office365.com (2603:10a6:20b:49e::12) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6745.34 via Frontend Transport; Thu, 7 Sep 2023 15:21:19 +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 AM7EUR03FT015.mail.protection.outlook.com (100.127.140.173) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6768.30 via Frontend Transport; Thu, 7 Sep 2023 15:21:19 +0000 Received: ("Tessian outbound c99fbc01d472:v175"); Thu, 07 Sep 2023 15:21:19 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: c4597f3c8ce84728 X-CR-MTA-TID: 64aa7808 Received: from d69d0eea84be.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 84EECFD8-8F51-4202-90E8-49F9AC5D5F1B.1; Thu, 07 Sep 2023 15:21:10 +0000 Received: from EUR05-DB8-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id d69d0eea84be.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Thu, 07 Sep 2023 15:21:10 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=DCWU3lhEkfIbnTD7QAXzleoouXNkYQIom4Ayek7KLQ+C6JSNnwLlcIaaAK+BscssEghIMDLzdcn8YTGzCH62udlxzqKkYCWWWsmfzi2YQ1FHGo3Pr26g3fcEPLnAJBQ5pB4wnQjj9YkAT6AhfMH1S8Y3O4EgpUzR/JFeGjmWXP1pKDtD2KCE+GJbD7NY/wwGETm4pT1HsllDd5OwXM0AyualQRNVJ/KoN809cZ7FTHLa0MRdMOw0ew6nu+hGP8sA/mwhTWWKg+DTYD6XguecHiKzLxMcHoKtRLB2oCJ0G4RkL3YQIMdl8mUAyLj7/F8NMb/ZIBKM5fz4gjNE8/rP1g== 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=2UNVNDZoJTl+YEsYi8L8pf24nJU+LLJhQb3ZE2q1euo=; b=M2mdDz+UVBpLRdHQZzPkWt/ZT/pby5+0bwPcb5UT7HnNzh25lk9Bi7ZqcoDZfOZ/yWeTeD7yS6gcRckv8dViBz5QOaxkTazEsc1ZZYol1dFD4XH9x7dhMVpgkm+gtIbD0yus2C9JWdxc2+Awfqw1AvcCYZMXFhQmiMlowjoQNW03zXtTVsHoBtCSYYT60n4ey2EjMaoLAtAXEG6QcrSrDdFS9uF/qiETKAdwyOW5uStfFx4Um/RpCC4MALQp7BK72aFIUkKf3lhWZ02vO21v+bWLxcfWIVLE28Tm9ftUH41GahIgFshi0aMIz0MwGPl8WtlGVV7oJ7GZkUf6RZwadw== 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=2UNVNDZoJTl+YEsYi8L8pf24nJU+LLJhQb3ZE2q1euo=; b=Aepvolh6jPxGYZjCyVi9zPO2MqSb5SFbrLFsy8ir8QiBGTXO7ruZ1yob8ot5WIuGjgwtWGoiTRyblBcJRcffPOU/1B5R21Na5TcyWYPx9hO36rbUyjpTNHcPhbf50431gfs0A0FQVZOQCfkdeEPPvplPtRHtxMpVRtOCOHlyNCw= Received: from AM6PR10CA0018.EURPRD10.PROD.OUTLOOK.COM (2603:10a6:209:89::31) by DU0PR08MB8448.eurprd08.prod.outlook.com (2603:10a6:10:404::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6745.36; Thu, 7 Sep 2023 15:21:08 +0000 Received: from AM7EUR03FT036.eop-EUR03.prod.protection.outlook.com (2603:10a6:209:89:cafe::5b) by AM6PR10CA0018.outlook.office365.com (2603:10a6:209:89::31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6768.30 via Frontend Transport; Thu, 7 Sep 2023 15:21:08 +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 AM7EUR03FT036.mail.protection.outlook.com (100.127.140.93) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6768.28 via Frontend Transport; Thu, 7 Sep 2023 15:21:08 +0000 Received: from AZ-NEU-EX03.Arm.com (10.251.24.31) 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; Thu, 7 Sep 2023 15:20:51 +0000 Received: from e129171.cambridge.arm.com (10.1.32.59) by mail.arm.com (10.251.24.31) with Microsoft SMTP Server id 15.1.2507.27 via Frontend Transport; Thu, 7 Sep 2023 15:20:51 +0000 From: Luis Machado To: CC: Subject: [PATCH v3 6/6] [gdb/docs] sme2: Document SME2 registers and features Date: Thu, 7 Sep 2023 16:20:49 +0100 Message-ID: <20230907152049.1031425-7-luis.machado@arm.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230907152049.1031425-1-luis.machado@arm.com> References: <20230907152049.1031425-1-luis.machado@arm.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-EOPAttributedMessage: 1 X-MS-TrafficTypeDiagnostic: AM7EUR03FT036:EE_|DU0PR08MB8448:EE_|AM7EUR03FT015:EE_|AS8PR08MB9456:EE_ X-MS-Office365-Filtering-Correlation-Id: 763c8c29-cd71-47f6-6549-08dbafb61620 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: pollc7EKjRavuaU+7z6J7vISaJGE6I/j25ISXS/Vo4J6xc4gFbvR50Gr+y9dnn2rpURa39sLg31j+IbwLLKwYhnh99ZzqB1xfWHE8sSgHY71+LzRNhZgM0SfaTJQKLEcaavsjFPk4VeqcAzAeyv6rTibPzY+VpBENCqVc2CvXyNT3tTHWR1s3rflklZNm/toBJMeVIKTjvoXDm7U5owzwl2ShsNHTF1IZpnbCzMEpn8V2QWZr1VPE1x4kZgM7K+mTlxaqZXbwSG3Cwgpnhq+V7Cfz9aes8Pv97w3+q3b0SNKzV7adgrlscZDmvGvXN71ZGOlDZLb07eyNDyiQ4tEEkS5TpjyzOEq5lx/0ol6JrDaU4abyLfT+TUTqV/IOTA3hE+LcwC8/bGpb3rdo6yH9lnpXl8cgoApHHg5qDSQhIaznKJkL8ThzqOAysU/Y81ERcCi4852ozCIQc2xWOQI/B3MvP5Tna9vUiDF8yQy4/2HmPVz1SYqjOu1jhshmK10vYFVCYzuhl7ZGMB8uJ+/YvuKP1ANB+S4h0lVgDHH8U//keyzP66ZViIVgGP2yiF7GuOiFvp6Mahjeb+R0lxVZ+CrwomGcjkFrY+BfudqaynJk6mgpIOn1Pj0RBEsSZxvS9JRfoO6Nt8TsWor55c+Ate587CmwjU/UUOIydFBsw5iNYCg3KT1EIv7Vv4NvdB1qNjkv1Kqr837ui9SDWXE5eZ7t9h/llNm2FMKvZVjnm7rpCdjSD3GgUJanZ0DjuhOnpKzzLWt+YEUPfviGyiXAw== 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)(396003)(376002)(136003)(346002)(39860400002)(82310400011)(186009)(1800799009)(451199024)(36840700001)(40470700004)(46966006)(26005)(1076003)(7696005)(83380400001)(478600001)(81166007)(356005)(36756003)(426003)(336012)(36860700001)(41300700001)(47076005)(82740400003)(2616005)(6916009)(316002)(70206006)(70586007)(8936002)(44832011)(5660300002)(2906002)(4326008)(40460700003)(86362001)(40480700001)(8676002)(36900700001);DIR:OUT;SFP:1101; X-MS-Exchange-Transport-CrossTenantHeadersStamped: DU0PR08MB8448 X-MS-Exchange-Transport-CrossTenantHeadersStripped: AM7EUR03FT015.eop-EUR03.prod.protection.outlook.com X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id-Prvs: e4bcea0c-3543-4721-3a31-08dbafb60fcb X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: RmpAUA04EbLTdYcuMX+dFfleqj3L3ucG9UWGmu1DjYuZVsA9l9Dcoc+jda9AqbV/OY3bPS+VRsBfkR1rB5CAYGrBf369Iui1imG3rRsGnpLYtC6q2Y7nJJaYHCjWKVdqi6ARKq3HSe/CAF+eGUYxVc+9jT/O1RJ6pubMyVYOMOKq5Qj9b5aMYFSmcTK5UkGuB+o05D64b6dFs+Wqp08MbFOyh2ejqvoehxM1v+MdexWiGuRcCDZZe7hktqafoy/7tBDmvxTUbCgJRjz8GjS6RYP3gWMwqzov2NuD+He8GME7357FbnFJC9XQ8TQvix5I2xm6SxyY3g02L86BZrZIqOvmNBdLSOUxveGeL2aciIegzhVHxG9H4lnY1waoEdFWGQlZamhwI5UhEOoHGlW59yBrnOoVE6jCl9BeyZutdc8BghOAAErrRDRsqPFEi3wBa1NM/iz6zL3eUrm9OYJqvo1d9YoApBtNmXa+ySLxcj3rOdohQunqg4nydqjxGBSz90gv8uQ9Q3vkRC45u3B9BCn4AVBt0gxBy8TzY4P950AeKDzEajqQDOHEJx0YEtl1eFFqqK1L33ObfvvuAAW766sy6W3AvPizaHOpfD7J6/OVk0kMooFIfj9nlz7KbOR4Yic4UdLbrjmQhyA61ozQOAYYy+TnVzXBd/XxcDHzPg4rC3fOVfmpZmOOF2SBcsZPxVT7A6nt2i9gGpjypUPjjZAsgu+PyWK1Oo8q/iWzBVs= 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)(396003)(136003)(346002)(376002)(186009)(1800799009)(451199024)(82310400011)(46966006)(40470700004)(36840700001)(8936002)(70206006)(40480700001)(8676002)(36860700001)(47076005)(478600001)(83380400001)(4326008)(41300700001)(107886003)(70586007)(26005)(7696005)(6916009)(1076003)(316002)(336012)(2616005)(40460700003)(426003)(44832011)(5660300002)(2906002)(82740400003)(86362001)(81166007)(36756003);DIR:OUT;SFP:1101; X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 07 Sep 2023 15:21:19.2562 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 763c8c29-cd71-47f6-6549-08dbafb61620 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: AM7EUR03FT015.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR08MB9456 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: v3: - Fixed formatting. - Fixed period after xfer. -- 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 525ab15e7a6..c83daa82d09 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 7f6065ef7c4..5dba6b910ba 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -26361,6 +26361,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} @@ -48543,6 +48587,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