From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR05-VI1-obe.outbound.protection.outlook.com (mail-vi1eur05on2073.outbound.protection.outlook.com [40.107.21.73]) by sourceware.org (Postfix) with ESMTPS id 8467E3853D0F for ; Wed, 13 Sep 2023 10:18:59 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 8467E3853D0F 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=2h/iOUatmfsJ/JwDKfCjvrx4tMmxjHm9EJnbaNE6E0Q=; b=Pqvdsde/QTF0O3O2i0F8a3gtFPvDe0wVdfUs0Da3XZ0ykCW5oikpHcvKKKN4QhoQHPTqUVJZhwpt3MMxBvqc/ULRBKNwUcWIWSyoWuWVMjYb4S+44OBYzq/dE+z34JxlcXRzyLLJkfE/esOi2ANGFvawwQz2VrllLkjUX9rFkto= Received: from AS9PR04CA0171.eurprd04.prod.outlook.com (2603:10a6:20b:530::11) by GV1PR08MB7348.eurprd08.prod.outlook.com (2603:10a6:150:23::5) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6792.19; Wed, 13 Sep 2023 10:18:56 +0000 Received: from AM7EUR03FT049.eop-EUR03.prod.protection.outlook.com (2603:10a6:20b:530:cafe::3c) by AS9PR04CA0171.outlook.office365.com (2603:10a6:20b:530::11) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6792.19 via Frontend Transport; Wed, 13 Sep 2023 10:18:55 +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 AM7EUR03FT049.mail.protection.outlook.com (100.127.140.234) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6792.19 via Frontend Transport; Wed, 13 Sep 2023 10:18:55 +0000 Received: ("Tessian outbound c99fbc01d472:v175"); Wed, 13 Sep 2023 10:18:55 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 2a9019b349db7741 X-CR-MTA-TID: 64aa7808 Received: from f362783c338d.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id D3E3ACFF-59F8-40F0-8C24-CCF7A8E224E1.1; Wed, 13 Sep 2023 10:18:47 +0000 Received: from EUR05-AM6-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id f362783c338d.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Wed, 13 Sep 2023 10:18:47 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=HYUG+KorvN4fkBXn75SQcnX8MKwZtPFJXw19RxjN6YNUmcqRHONR9HbhPyx4TK0eidUJvnw3SSxiOCmBDsb86VpI8vCYG53o4XRNPIMmZTSw4xsor7/e06Dwumkup1YHWjvoKnQcJQt5XrIQoAe1GtjXj5yEQkhTwDVcjBCz6PuzYB7KXRy2L4522MlGEjkz83npq1ld2rVQQHE+nPh2bvMl5iZ/f2eP1b87Pb5nPYfElj1LnBJQn6CYEYeCHyBJVhOfSI1Hekzz5rx1LkEpRS9q2uvTzJD05v3tsPjFaY7hOA/EioFOMAZ+vs/NNb8I07hmdVEhThPLAZ/qwJAgjg== 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=2h/iOUatmfsJ/JwDKfCjvrx4tMmxjHm9EJnbaNE6E0Q=; b=cflRr6hhi/S0o/Kv6h6DHuNLqJP2Hx/yk9Sen/AC5yzUfBArozRldnxbjaP1Mm07xnw4ZnUuRPbpcDHqApItJRk9OM9F16blpKfS1jLkM9Tn9qnJzP3ewVjMZc9oaWcENsLsBHJLX8KKYzQw5pMo5MygM8bnFhI7zKB4Lje9CNrP+DeWSeOokLcgOZbFlboGgJmiut3l7Qq02P4EnEs3gnPo9fmEo8LkfKRdUgEmeAJ+FNuJ7FSwiYY0oC5fEbkCKif7rmlWk+KK8xYVQyapLiCjkW0DJhN/RJVPC2pX/GVQp7tDAe6iT0vbAW7sVwlg4PR9GUpJKZpVqtszqJ0gcg== 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=2h/iOUatmfsJ/JwDKfCjvrx4tMmxjHm9EJnbaNE6E0Q=; b=Pqvdsde/QTF0O3O2i0F8a3gtFPvDe0wVdfUs0Da3XZ0ykCW5oikpHcvKKKN4QhoQHPTqUVJZhwpt3MMxBvqc/ULRBKNwUcWIWSyoWuWVMjYb4S+44OBYzq/dE+z34JxlcXRzyLLJkfE/esOi2ANGFvawwQz2VrllLkjUX9rFkto= Received: from AM5PR0101CA0009.eurprd01.prod.exchangelabs.com (2603:10a6:206:16::22) by AS2PR08MB9021.eurprd08.prod.outlook.com (2603:10a6:20b:5fd::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6768.31; Wed, 13 Sep 2023 10:18:46 +0000 Received: from AM7EUR03FT061.eop-EUR03.prod.protection.outlook.com (2603:10a6:206:16:cafe::d3) by AM5PR0101CA0009.outlook.office365.com (2603:10a6:206:16::22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6792.19 via Frontend Transport; Wed, 13 Sep 2023 10:18:46 +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 AM7EUR03FT061.mail.protection.outlook.com (100.127.140.72) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.20.6792.19 via Frontend Transport; Wed, 13 Sep 2023 10:18:46 +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; Wed, 13 Sep 2023 10:18:46 +0000 Received: from e129171.arm.com (10.57.66.200) by mail.arm.com (10.251.24.32) with Microsoft SMTP Server id 15.1.2507.27 via Frontend Transport; Wed, 13 Sep 2023 10:18:45 +0000 From: Luis Machado To: CC: Subject: [PATCH v4 6/6] [gdb/docs] sme2: Document SME2 registers and features Date: Wed, 13 Sep 2023 11:18:40 +0100 Message-ID: <20230913101840.179101-7-luis.machado@arm.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230913101840.179101-1-luis.machado@arm.com> References: <20230913101840.179101-1-luis.machado@arm.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Content-Type: text/plain X-EOPAttributedMessage: 1 X-MS-TrafficTypeDiagnostic: AM7EUR03FT061:EE_|AS2PR08MB9021:EE_|AM7EUR03FT049:EE_|GV1PR08MB7348:EE_ X-MS-Office365-Filtering-Correlation-Id: d08f70eb-e30e-4b8b-427b-08dbb442d64b 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: bKqwQrVCipPwroRPgatg0N0Y9h6HN+QVsAcsAhkyqax4/yypBg4BEvgan6NQod/XKwLoT+CtbrC19aC149OiadIYy+22ToWa7WFSADK7PG/KUmg/ms3YsNdcsOEtZk2bt/F4XDUigPSAMAR9aIwr8wnOioC8RIayzj3hNkXyViGsf3J6qTkQnxyiCgJdmIjy7oU56jjO3uw+K/y/OTqwJ5EewWpyPehnOM3N8CP0LmWa60KNNSnhBnuOhMDdsASZ8MYQXuq2wv0H/9HeQO4DtBStoJBbUGiPi2tbjRwRXqmwcwiVcOprusxAHP1MaHMKNcfea0T4WMmoGUvw/F+6M6bAsaFdGvrrN5S5QFHFJ4wdM9xqCsnT9DKktpseC8T2FN5reePRlUBO2dLl3FPS/BDYZKOY+D0hYVUWtRX3gjXPUVbTOhjs8YYQdLvv15oyka8MWjBWAnXPaSCI8igdJO74LI0tuj39ghfCqteZj7sfHw4RR//sFbEVWrNtVB4AwAcJCUXQm3TH+tHC4+4CU1PaL+4flWOiEGbnXyrwZ6rl7OuKgkKUQdvbplbnwfndhpB0H/qP6APudC8SYDJ2xZSYzGr2OZaAnggQH/25gNBRrzlPCQf3Wekcz3EQx86LuG2OX9oBd06fB9lq2KAIORB//OLddWklkir9jaUZ+eb9ol8NDPFFw25KmIHrD8FYzxIC0MH0xMq14qEpqPYpgSDwyp23ZmNfTuTFA9VgxdnOucMb4WD5ptIa6WIZBxSwyQ7zPH3rQjE/EuN0dIu93A== 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)(39860400002)(396003)(346002)(376002)(1800799009)(82310400011)(186009)(451199024)(40470700004)(46966006)(36840700001)(26005)(5660300002)(356005)(82740400003)(1076003)(8936002)(40460700003)(8676002)(2616005)(4326008)(36860700001)(2906002)(83380400001)(86362001)(36756003)(47076005)(426003)(336012)(44832011)(81166007)(40480700001)(316002)(70206006)(70586007)(7696005)(6916009)(478600001)(41300700001)(6666004)(36900700001);DIR:OUT;SFP:1101; X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS2PR08MB9021 X-MS-Exchange-Transport-CrossTenantHeadersStripped: AM7EUR03FT049.eop-EUR03.prod.protection.outlook.com X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id-Prvs: 5defdcff-52a8-4b73-9937-08dbb442d0aa X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: Nii8ulPrn+9FJjz3t+CD6YS0dsat73EDIfILurEWjb1ExzXWVvI4xNtRamx96iPuOU4lh3cQmlRKdgdDjwnUdHh1BQ7ZU+aWafDM6SuIxplA5mT5h8+ZHQWkrxo5WBydfcat1h66r2RNIysszYJ3S0hvk88Q4bccIKMMlFH4UHM3r0BFUX9GFpe26wnHtR04lf09aKw2Od/eHDcyd6RrkKdK4o+Sve3R20Zb0lxhqr4dtaoct4oZsPsyWuOb9x4U9bOGt2osEQZ7SlsBmC9aufh3R0Hyn+TDDXK7nKgtjGjfK2V68HijORBtyflOVMccmHLigtwzSGmjSKsS5sswK7AqlZcbg/pEiXx4keiV2OKUyLYCtAsNmwTl8yElApQgNn/OcUOsQF1DY7wsoT85RyPJ/MxIqMTrEfpXZEFUfFl41NloPbuQ+lYbTCNotNx0tW+Mx6veTuR2RTq0hXNQHZCwdxYTM2ID+Rt3zmUFH4VqQBRuqiklvwHEQH/ivz7sPtWIRXFwJqV+mGxqXOCsWlEc5vJaqMzv9qJ7V8RoL5rGxg72X1VEXgtO2ppPcNEqjGN0h4oNwMizL0keMZsp+lB95umBh3R3iicn+loGCOKjQqv/HAZt9qhHgVpqk05mA9441WJHrecPaRDkTj68L62O8k6LwVuhviQFI5mpExZNdxp0eExYvO1Dahgs/Hh53VZqHWBGRg6mFyWImmRh1qpaxWUqzhyIkImBNdhYSMM= 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)(136003)(346002)(396003)(82310400011)(1800799009)(186009)(451199024)(40470700004)(46966006)(36840700001)(47076005)(41300700001)(36860700001)(83380400001)(6916009)(316002)(40480700001)(6666004)(478600001)(336012)(7696005)(426003)(1076003)(70586007)(70206006)(26005)(107886003)(2616005)(2906002)(82740400003)(5660300002)(86362001)(4326008)(8936002)(81166007)(8676002)(40460700003)(44832011)(36756003);DIR:OUT;SFP:1101; X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 13 Sep 2023 10:18:55.8686 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: d08f70eb-e30e-4b8b-427b-08dbb442d64b 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: AM7EUR03FT049.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: GV1PR08MB7348 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. Reviewed-By: Eli Zaretskii Signed-off-by: Luis Machado --- 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 3c0419cf43c..0bf479b9c07 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} @@ -48562,6 +48606,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