From patchwork Fri Jun 30 13:48:44 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luis Machado X-Patchwork-Id: 71921 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 817ED388200B for ; Fri, 30 Jun 2023 13:51:52 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 817ED388200B DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1688133112; bh=9v1Vbv//ndlYgo1/M287BdBKVTG5TnmczxCBzx8P0Mc=; h=To:Subject:Date:In-Reply-To:References:List-Id:List-Unsubscribe: List-Archive:List-Post:List-Help:List-Subscribe:From:Reply-To: From; b=XWvonjvZG0Boz+LzREh+ycKAh1bGTZbipfTZtK+GxZpfs+uOexqKQQs1TRtIMlDI+ YoKRQHRm9/OZ1khwcHb+A4Uy6gmydXZ6gmZ9dvoK29IsjjHQcRxE7Pol/11OfEkoNG EIYQ3ZVodYUd5wI/a9isZgb2Su4h/dr0Q/g7CRBg= X-Original-To: gdb-patches@sourceware.org Delivered-To: gdb-patches@sourceware.org Received: from EUR04-HE1-obe.outbound.protection.outlook.com (mail-he1eur04on2044.outbound.protection.outlook.com [40.107.7.44]) by sourceware.org (Postfix) with ESMTPS id A1B2A3883029 for ; Fri, 30 Jun 2023 13:49:09 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org A1B2A3883029 Received: from AS8PR07CA0057.eurprd07.prod.outlook.com (2603:10a6:20b:459::34) by AS8PR08MB6152.eurprd08.prod.outlook.com (2603:10a6:20b:298::8) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6544.19; Fri, 30 Jun 2023 13:49:03 +0000 Received: from AM7EUR03FT041.eop-EUR03.prod.protection.outlook.com (2603:10a6:20b:459:cafe::c1) by AS8PR07CA0057.outlook.office365.com (2603:10a6:20b:459::34) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6565.10 via Frontend Transport; Fri, 30 Jun 2023 13:49:03 +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 AM7EUR03FT041.mail.protection.outlook.com (100.127.140.233) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6544.22 via Frontend Transport; Fri, 30 Jun 2023 13:49:03 +0000 Received: ("Tessian outbound 52217515e112:v142"); Fri, 30 Jun 2023 13:49:03 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 333c70093e195f15 X-CR-MTA-TID: 64aa7808 Received: from efffbc587a03.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 39934167-A88D-40BA-8DC7-ACDF8DE1D4B6.1; Fri, 30 Jun 2023 13:48:56 +0000 Received: from EUR02-DB5-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id efffbc587a03.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Fri, 30 Jun 2023 13:48:56 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=ZDO2e240Ctbd5698uhAOeDWZCDd10r3scwdbFipbLrHk+sGLh4kYShHZN1336/wG3KbU2zdyG3YkBT4H+f25DEVTK/xPk0RXfcvGmR69u/QW+6RHZd1xlHmChqhoONznnzMjZGT6qT0WufjEkvc7kn+na5U8wPo6XpQb07luhvVxh5tRrkqtvP4f69IPWsi/CyEKBWfT8whG5c7bHXIduuRW/9A33N+SihmSbKIPDweAz5J5QzAb1l7Kj+S39weNYu4spT8YjEG/URJZgWZ5YCYvs0kdHhyHb+nRlXbH5FUQt5MYZbtncf8WQLk/cQ9R24pkpOEqgrGkiKKnWdrnyQ== 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=9v1Vbv//ndlYgo1/M287BdBKVTG5TnmczxCBzx8P0Mc=; b=mxKyj0P356wYkfzPbP11RYsUXQk40Mq390tyrsjJtprGzBD6C48fM+viCouMRc+Nb/o2dBQ1vtSHYpwlAX+RPiXoiIsliENRmnyjUrfwO6wcA3IMJlFB3rH4M0VvY+FgCqZZIki1p8+M6cfBvJYSK8+jDs7ZzC1gr7M74q+HsAWH2D6I5sYceSigVW9uUmD98rexICoDlIETfoEiV4aXtsIVyiaGzjZDtW4Yrzi37sKmBonEx1G4erJfc+ApWZ+S7yxrM/MXzUq9KdwVNRoNVOP3p1ezu5n9C2Y0rTn+wURZGA/7b7+5yRntEZcURLWKIe50/ETu8TQDUowCP13Avw== 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 Received: from DB6PR0301CA0082.eurprd03.prod.outlook.com (2603:10a6:6:30::29) by DU0PR08MB9909.eurprd08.prod.outlook.com (2603:10a6:10:403::16) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6500.35; Fri, 30 Jun 2023 13:48:54 +0000 Received: from DBAEUR03FT029.eop-EUR03.prod.protection.outlook.com (2603:10a6:6:30:cafe::c7) by DB6PR0301CA0082.outlook.office365.com (2603:10a6:6:30::29) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6544.22 via Frontend Transport; Fri, 30 Jun 2023 13:48:54 +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 DBAEUR03FT029.mail.protection.outlook.com (100.127.142.181) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6544.22 via Frontend Transport; Fri, 30 Jun 2023 13:48:54 +0000 Received: from AZ-NEU-EX03.Arm.com (10.251.24.31) by AZ-NEU-EX04.Arm.com (10.251.24.32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.27; Fri, 30 Jun 2023 13:48:54 +0000 Received: from e129171.arm.com (10.57.27.17) by mail.arm.com (10.251.24.31) with Microsoft SMTP Server id 15.1.2507.27 via Frontend Transport; Fri, 30 Jun 2023 13:48:54 +0000 To: Subject: [PATCH 6/6] [gdb/docs] sme2: Document SME2 registers and features Date: Fri, 30 Jun 2023 14:48:44 +0100 Message-ID: <20230630134844.1238445-7-luis.machado@arm.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230630134844.1238445-1-luis.machado@arm.com> References: <20230630134844.1238445-1-luis.machado@arm.com> MIME-Version: 1.0 X-EOPAttributedMessage: 1 X-MS-TrafficTypeDiagnostic: DBAEUR03FT029:EE_|DU0PR08MB9909:EE_|AM7EUR03FT041:EE_|AS8PR08MB6152:EE_ X-MS-Office365-Filtering-Correlation-Id: cbfb3924-8ceb-4169-7106-08db7970c43a 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: ZXVSxwKFWwAY2QdD6IVqJouiFaqhx0HfCaznnxJyts1soh2IsN9USs1Nz6BRGM06pyeKpa0s1bEr1WCnOmOr15uXbmjp2vKFn/jC8Fz8I20uqls8GFQbB16/5l30LWr2XBoPUQY5vtALIZ0hnopd78oPNGETsk+CTC8XdMTpmTRLH7Km4gbr1LNp0LZw4xv+G/MZ2ALIIv1TgL1LTORIdpMNSTX9bWFG/7zk+dfk8W6QIA68sqzGMBFcxoI7ErzAekjqdhSI9B1nmiGNuQgQ9NivIKr40/Jws2RKxBIlJkWSUEFhQseTe8Z13hPRtulBvGLzFssxV2lgzUG9BUOOCJd6+PcOq1hRmMvzZoWeirlPteRpe2vopSnrxxyyGlS03mSTLl7vtQELf6w8/vRUjV4xpEo7ghJO4C/t7WmwG1D8kiMtVZIsfpVqRGqP+kROMR06Lkoavwwbn5mjoAdgbd67GYYjRHSrtkrqpwSW2jwWaV3xr0onC55/G7ArIM87ySgHOX6vht25nau9IwE/nKPxRpMu/LQwI2vk4oATURHlJ/RwwywiUQojPtJF9Ws+rItxmupOOH2pVWKj/RrPfA/+EPz+ysEAd9+iiNAwJnGvjjCC5fYq5Q0IX/XON3dl6Pu5Y6OhQFe5gP1ZoTbVYruevMoVD/aOTf6PAeGYYxtZ0qwJVq0ft5HRqlvZ9hW5pBb21GQclIT5VtWtw1oao6Y1XbbkLwx8TJTNkAhPcK5fCfwArNeXxYw3/geLFdB9b3v/rBtZ1G0lTw7dxiSM7Q== 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:(13230028)(4636009)(39860400002)(396003)(136003)(376002)(346002)(451199021)(40470700004)(36840700001)(46966006)(44832011)(5660300002)(6916009)(478600001)(70206006)(316002)(36756003)(70586007)(8936002)(8676002)(2906002)(6666004)(26005)(40460700003)(36860700001)(41300700001)(82310400005)(7696005)(186003)(40480700001)(426003)(336012)(47076005)(1076003)(356005)(86362001)(82740400003)(81166007)(83380400001)(2616005)(36900700001); DIR:OUT; SFP:1101; X-MS-Exchange-Transport-CrossTenantHeadersStamped: DU0PR08MB9909 X-MS-Exchange-Transport-CrossTenantHeadersStripped: AM7EUR03FT041.eop-EUR03.prod.protection.outlook.com X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id-Prvs: 8220e9b0-8bad-4ac8-212f-08db7970beef X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: 479PtWWTjyu/ey3pdsxhszyspYk9O/WLTH2+h4Iy4OfugzTNlsqsbkinP8kGcTRk/V0on1Phy6uMUsMQEQUgL5cF90edOfV3B7+tXMXUtIVyJ/iyG/LaQtQh9qnVeDu0xp8eOvhBeoooXdhXLjOEU/ozicH9wCBWaqQbySwC4/FJR1bXZ5CaDnA7doX5pGgbfIQmbGJN1oIKz05EbrDGa5cB4c3cM51VEkbVXteLAaQcDwArfEJB6Qxzl+MI+ncSmCaWpdByFIlGw7xZZOOcKThhtKoG2Dbv/f8lm7+dCjLaB+kNARqNoJ8YfuHmbN68tMZqTSHMm9V8bynhnhA/N8fsdESdadsxJiBI+A0sdYjIF7IJMrTQLri3hMwCkblsnd9cvw9emVD9dxSPH8gAN06Meo8uhC2Luxfv788fIRxX2M1t4yPlwX7uxZdCF9wdkhsX6pug3D2jJsEyEOwGfg5s+x+dcWofA+hrTTE/088oL0cXZuMnqvce9OJk5m/3S2I71tS6P0YHVSjCUAfBJfBnoEen4Dfn2tLQIr95cp/1J45o7s2Tos1WNoWKKLmRKvR1QPRT5ear7iiyCe8P2t6ZPrkdyLBHZMlSKxiIrokJOJU5f9BOMUgwqm2mSOojsoIhwXOnCPwDdjBBVSLPYIR9W776vHaif8Kl4w7wpZYuTl2U/GBkZgAbWOlr6ab3+OWJ/D6deefEE3kJWkyyRI9s2z/neNqUkkk/S9Zpf8Y= 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:(13230028)(4636009)(376002)(396003)(136003)(346002)(39860400002)(451199021)(40470700004)(36840700001)(46966006)(40460700003)(41300700001)(316002)(47076005)(83380400001)(82310400005)(86362001)(336012)(36860700001)(426003)(186003)(26005)(1076003)(44832011)(2616005)(2906002)(82740400003)(81166007)(40480700001)(5660300002)(36756003)(8676002)(8936002)(70586007)(7696005)(478600001)(6916009)(70206006)(6666004); DIR:OUT; SFP:1101; X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 30 Jun 2023 13:49:03.7894 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: cbfb3924-8ceb-4169-7106-08db7970c43a 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: AM7EUR03FT041.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR08MB6152 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, T_SCC_BODY_TEXT_LINE, 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 X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Luis Machado via Gdb-patches From: Luis Machado Reply-To: Luis Machado Errors-To: gdb-patches-bounces+patchwork=sourceware.org@sourceware.org Sender: "Gdb-patches" Document changes introduced by gdb's SME2 support. Reviewed-By: Eli Zaretskii --- gdb/NEWS | 3 +++ gdb/doc/gdb.texinfo | 65 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 68 insertions(+) diff --git a/gdb/NEWS b/gdb/NEWS index 720008a5d97..3ab9ae4765e 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 758c9632217..6ab14c01cb8 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -26291,6 +26291,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} @@ -48445,6 +48489,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