From patchwork Thu Feb 23 09:52:30 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Luis Machado X-Patchwork-Id: 65497 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 7F6083858C2C for ; Thu, 23 Feb 2023 09:53:11 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 7F6083858C2C DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1677145991; bh=DVZQ2D8uZiTDlNP6fqMsqvc3vLxsMDc18jWezi1lAL8=; h=To:CC:Subject:Date:List-Id:List-Unsubscribe:List-Archive: List-Post:List-Help:List-Subscribe:From:Reply-To:From; b=gQOyW5dwMdE0y6gkvfPXD7ZKEimls+/V4EYwqVSyIXsfzKJR+XsHMkY/L6iVImkwk +bvylzuPx4vNIdiXz+pAvYwdypJgEvD6VGCgKQHediVzH8zgBiShcRMYlVOAp5Y8PS ILjmwG/YFbdJxdMYjQmEXjj+7q4MgoNqBFOV8g2E= X-Original-To: gdb-patches@sourceware.org Delivered-To: gdb-patches@sourceware.org Received: from EUR02-AM0-obe.outbound.protection.outlook.com (mail-am0eur02on2068.outbound.protection.outlook.com [40.107.247.68]) by sourceware.org (Postfix) with ESMTPS id E42BD3858C5E for ; Thu, 23 Feb 2023 09:52:43 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org E42BD3858C5E Received: from AS8P189CA0034.EURP189.PROD.OUTLOOK.COM (2603:10a6:20b:458::15) by AS2PR08MB10227.eurprd08.prod.outlook.com (2603:10a6:20b:647::17) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6111.21; Thu, 23 Feb 2023 09:52:40 +0000 Received: from AM7EUR03FT047.eop-EUR03.prod.protection.outlook.com (2603:10a6:20b:458:cafe::33) by AS8P189CA0034.outlook.office365.com (2603:10a6:20b:458::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6134.21 via Frontend Transport; Thu, 23 Feb 2023 09:52:40 +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 AM7EUR03FT047.mail.protection.outlook.com (100.127.140.69) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6134.21 via Frontend Transport; Thu, 23 Feb 2023 09:52:40 +0000 Received: ("Tessian outbound 8038f0863a52:v132"); Thu, 23 Feb 2023 09:52:40 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 6fd44bcb59583083 X-CR-MTA-TID: 64aa7808 Received: from 098b40177d53.1 by 64aa7808-outbound-1.mta.getcheckrecipient.com id F32A91D6-A7C2-4D95-9D91-664D73E9EC72.1; Thu, 23 Feb 2023 09:52:34 +0000 Received: from EUR05-DB8-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id 098b40177d53.1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Thu, 23 Feb 2023 09:52:34 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=WpNA5IFGHWrBkRcaYO0FFCtfW5f7xTDI8qFnOjicEI1cjpBtJw5xCBNekeHIYyhZRB1jjVD8Z+9LhMcBlrE4DKLYR8aiJRdyXpZWClmD1DPSBqOvNE2pDz13tFriW8Cp1heNXSWSA6ijYQt1zmjEljwa4k5oNjjL78b9Rz+4MwZNPpekfIFL04s2o8Z+XpWQD0/K2uQqiH+rFyOM+LJu1dc6sPNelvmK3PDt4LnyNQUEEaQuhOKtB7su2c/30+tLUakGrxK7c4jYSXD5Nuq25mEAnTmu/nbo21WtPJvxKpjczxsLBiCrU2i7IzplofujFqrVAOsASlAwaMDnqTtuSw== 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=DVZQ2D8uZiTDlNP6fqMsqvc3vLxsMDc18jWezi1lAL8=; b=BGZsDjkvrVx5MOtCQ8aXgN5gnDhLMvhA4hpAeuVXbxaRtnXsa4pY/4BPisMAzhgiItfYJXjPUWEdgCKK/65aBHZqw0TeG84WcCi2yv7brO86wwmkqkAOJcFwPIdvKD0acMMFnwOZu+Cj4O15XzKf2fEaruo+x8mAw6i6LjHHIN/iYQWHXEYOaWU3tktXQin+ePvp2xsosCbLSPmnkFY11NEK7/Mh3b1rq3W3JwIg72ijmS5J1/8NMp24w1kMgmozPddqLShyonf29NnH6Mcm0B6TW1Oakb1/iJRdQYBAnJxncnH9xy3QXUWrGjPe4NR1+T3UYdYqIHjvwME+OYBmmQ== 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 AM7PR04CA0011.eurprd04.prod.outlook.com (2603:10a6:20b:110::21) by DBBPR08MB6219.eurprd08.prod.outlook.com (2603:10a6:10:20d::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6134.21; Thu, 23 Feb 2023 09:52:32 +0000 Received: from AM7EUR03FT036.eop-EUR03.prod.protection.outlook.com (2603:10a6:20b:110:cafe::48) by AM7PR04CA0011.outlook.office365.com (2603:10a6:20b:110::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6134.19 via Frontend Transport; Thu, 23 Feb 2023 09:52:32 +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.6134.21 via Frontend Transport; Thu, 23 Feb 2023 09:52:32 +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.17; Thu, 23 Feb 2023 09:52:31 +0000 Received: from e129171.arm.com (10.57.90.34) by mail.arm.com (10.251.24.32) with Microsoft SMTP Server id 15.1.2507.17 via Frontend Transport; Thu, 23 Feb 2023 09:52:30 +0000 To: CC: Subject: [PATCH] [gdb/doc] arm: Expand documentation of XML features Date: Thu, 23 Feb 2023 09:52:30 +0000 Message-ID: <20230223095230.1813266-1-luis.machado@arm.com> X-Mailer: git-send-email 2.25.1 MIME-Version: 1.0 X-EOPAttributedMessage: 1 X-MS-TrafficTypeDiagnostic: AM7EUR03FT036:EE_|DBBPR08MB6219:EE_|AM7EUR03FT047:EE_|AS2PR08MB10227:EE_ X-MS-Office365-Filtering-Correlation-Id: fb55e24d-814d-48cf-5598-08db1583b3f7 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: Zu22slvvn5tBbE0xs7svZ88a/ygHfKKBFDTHoozUtJkggIZPugiw2Awsp69oHbfWnNYBzekmv/oGj1C/pWoZNGRGEVd/PZ3KI4b9T7Eeg8mM2xV3KYI8HFpufCDFOKo30peAhtd/9pj4R6JzOYLeE3fUuXFsyImQzzOw+L7KUSxs3krwUKyyejhZxCKGTUEiWQBHOxpz7ejvq81mum/oNcP9aQsslcGSLcbWtHlK/RBF4QPQNcvcHOyDcAUf4nRVSNpYxanYrK4HHF4MtbKSq9P4IYAGhS6xuwNXVxjy+inRX1OrpjPTMwL2A4fUlC2ATa8KFvkoS/2NLwpVp8LACN9yXbUiwMQ4DtD9QiQVnap3ylOrNIB2O+hRobhHK9bJrjZ5prvFlgOPFvxikcO7rHGGsoAjeFnbyRjkVAwJBUB5FOHpsUqClElvH3UqR/mUAYn3oTQzZQlvmlvDOojAYexM9PqVaY82rarvWkcOvtnUVMjK9A+FDpv+SVZ0tc2IgYwdFaJSYmsXAP/i/YQXA2tOozWMiuTl0YBW6cberGBwf3NbT4EUF9ClAxHGKjbgVrWWq4G2N5vS66jl2WEOkJ2JJP1+QtVPCtGueIaDvCgXkA4PwHX40IJsVYwqecF/Tne5pi1YlABeHd3w2EAzt+7tEPhYjfdof2RUOcbBUKuDn2d5RrMsQgBknKT7neXpTXcXffkV9VFrF7mRDASHNCDvtHfzEyZfVX4hqcC0LOI= 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:(13230025)(4636009)(376002)(136003)(346002)(39860400002)(396003)(451199018)(40470700004)(46966006)(36840700001)(40460700003)(83380400001)(70586007)(316002)(8676002)(8936002)(5660300002)(4326008)(6916009)(41300700001)(1076003)(2616005)(70206006)(26005)(186003)(47076005)(426003)(478600001)(336012)(7696005)(356005)(40480700001)(82310400005)(36756003)(86362001)(2906002)(82740400003)(36860700001)(44832011)(30864003)(81166007)(66899018)(36900700001); DIR:OUT; SFP:1101; X-MS-Exchange-Transport-CrossTenantHeadersStamped: DBBPR08MB6219 X-MS-Exchange-Transport-CrossTenantHeadersStripped: AM7EUR03FT047.eop-EUR03.prod.protection.outlook.com X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id-Prvs: 3d92391c-11b4-4afd-3fab-08db1583af04 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: oxG3CGTZbwVOCR3ak6iayl9LHZYqdNNUMPcGqo9NhNS29VTTBVTkvZZTLGVTFYGM2n90Niq+31kqyzohOYZnbjLrs5BcpnT1LqXE+vRcSUDbpC0yPjub7TKstuqw5Y8TzLFSI9+FZiMFhDsO2/JgJTSvt5HaRgMMjSGt+NhF5hbeULD1lVm7dynUR3Izf+7ec9JDC/dNurzEEq1vIui3gOkrYApPJQYHYhlJ0M7oPVvzqnoe8BfTHgG33Bj03DK9QelPqFHWWJsK+SjGp8n08e90cScNcwxo5hQKEDxQTwn0oVaJt/3clSta0Gbi4p2NUdIrm6fSH3LY8touYlR9QzT085Gg5eii+DJ2p07z9gPR9sqyQBU6BHfZD0ajMjl+NxGJazPpkp+rnLq9Rcd8koVLdN/Bg81gu437xyrTJrOIuAaPkVOjD2YhbbYO2WVGNIpTu+nW3Y3AmHoEcL3j/mW09njEMeHYnSxa3DM/eR7jhHjI5SerE719zbnvIkAcNrKiSRj1DM7ck+IsoOP37jpbM6Vh2npt09BYTZTDkofii2B34Np/MCMr9zkQmtqadHDiQwqCwl7WzndgmPafZIzpNk/iqARoQlRy9LIOqBn0hxCpaoWZj4DaruvaFXlmzQXIH6vS8ih/3sJlFnRD5ELO5cLj2S8XiTkuNGjg6FzKD6bmnwxJfchGge1WWT3NfdtAP3CwMzIJPjzMBuEY0w== 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:(13230025)(4636009)(136003)(396003)(346002)(376002)(39860400002)(451199018)(36840700001)(40470700004)(46966006)(5660300002)(4326008)(8936002)(36860700001)(41300700001)(40460700003)(81166007)(44832011)(30864003)(40480700001)(2906002)(82740400003)(2616005)(478600001)(6916009)(86362001)(47076005)(426003)(36756003)(82310400005)(336012)(186003)(7696005)(26005)(1076003)(66899018)(316002)(70206006)(83380400001)(70586007)(8676002); DIR:OUT; SFP:1101; X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 23 Feb 2023 09:52:40.6505 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: fb55e24d-814d-48cf-5598-08db1583b3f7 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: AM7EUR03FT047.eop-EUR03.prod.protection.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS2PR08MB10227 X-Spam-Status: No, score=-10.4 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, FORGED_SPF_HELO, GIT_PATCH_0, KAM_DMARC_NONE, LIKELY_SPAM_BODY, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2, RCVD_IN_VALIDITY_RPBL, 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 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" The documentation of the XML features for Arm targets is very brief. I have received feedback saying it is quite unclear from the perspective of the debugging servers what should be defined in the XML features, how and what the outcome is in gdb. This patch attempts to clarify a bit more what all the possible features are. Reviewed-By: Eli Zaretskii --- gdb/doc/gdb.texinfo | 281 ++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 257 insertions(+), 24 deletions(-) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index 2a2077c29d1..3c3a9f98de2 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -47827,40 +47827,188 @@ optional: @samp{lp_start}, @samp{lp_end}, and @samp{bta}. @subsection ARM Features @cindex target descriptions, ARM features +@subsubsection Core register set for non-M-profile + The @samp{org.gnu.gdb.arm.core} feature is required for non-M-profile -ARM targets. -It should contain registers @samp{r0} through @samp{r13}, @samp{sp}, -@samp{lr}, @samp{pc}, and @samp{cpsr}. +ARM targets. It must contain the following registers: + +@itemize @minus +@item +@samp{r0} through @samp{r12}. They are 32-bit in size and of type +@samp{uint32}. +@item +@samp{sp}, the stack pointer register, also known as @samp{r13}. It is 32-bit +in size and of type @samp{data_ptr}. +@item +@samp{lr}, the link register. It is 32-bit in size. +@item +@samp{pc}, the program counter register. It is 32-bit in size and of type +@samp{code_ptr}. +@item +@samp{cpsr}, the current program status register containing all the status +bits. It is 32-bit in size. Historically this register was hardwired to +number 25, but debugging stubs that report XML do not need to use this number +anymore. +@end itemize + +Extra registers are allowed in this feature, but they will not affect +@value{GDBN}. + +@subsubsection Core register set for M-profile For M-profile targets (e.g.@: Cortex-M3), the @samp{org.gnu.gdb.arm.core} -feature is replaced by @samp{org.gnu.gdb.arm.m-profile}. It should contain -registers @samp{r0} through @samp{r13}, @samp{sp}, @samp{lr}, @samp{pc}, -and @samp{xpsr}. +feature is replaced by @samp{org.gnu.gdb.arm.m-profile}, and it is a required +feature. It must contain the following registers: + +@itemize @minus +@item +@samp{r0} through @samp{r12}. They are 32-bit in size and of type +@samp{uint32}. +@item +@samp{sp}, the stack pointer register, also known as @samp{r13}. It is 32-bit +in size and of type @samp{data_ptr}. +@item +@samp{lr}, the link register. It is 32-bit in size. +@item +@samp{pc}, the program counter register. It is 32-bit in size and of type +@samp{code_ptr}. +@item +@samp{xpsr}, the program status register containing all the status +bits. It is 32-bit in size. Historically this register was hardwired to +number 25, but debugging stubs that report XML do not need to use this number +anymore. +@end itemize -The @samp{org.gnu.gdb.arm.fpa} feature is optional. If present, it -should contain registers @samp{f0} through @samp{f7} and @samp{fps}. +Upon seeing this feature, @value{GDBN} will acknowledge that it is dealing +with an M-profile target. This means @value{GDBN} will use hooks and +configurations that are meaningful to M-profiles. -The @samp{org.gnu.gdb.arm.m-profile-mve} feature is optional. If present, it -must contain register @samp{vpr}. +Extra registers are allowed in this feature, but they will not affect +@value{GDBN}. -If the @samp{org.gnu.gdb.arm.m-profile-mve} feature is available, @value{GDBN} -will synthesize the @samp{p0} pseudo register from @samp{vpr} contents. +@subsubsection FPA registers feature (obsolete) + +The @samp{org.gnu.gdb.arm.fpa} feature is obsolete and should not be +advertised by debugging stubs anymore. It used to advertise registers for +the old FPA architecture that has long been discontinued in toolchains. + +It is kept in @value{GDBN} for backward compatibility purposes so older +debugging stubs that don't support XML target descriptions still work +correctly. One such example is the KGDB debugging stub from +Linux or BSD kernels. + +The description below is for historical purposes only. This feature +used to contain the following registers: + +@itemize @minus +@item +@samp{f0} through @samp{f8}. They are 96-bit in size and of type +@samp{arm_fpa_ext}. @samp{f0} is pinned to register number 16. +@item +@samp{fps}, the status register. It has a size of 32-bit. +@end itemize + +@subsubsection M-profile Vector Extension (MVE) + +Also known as Helium, the M-profile Vector Extension is advertised via the +optional @samp{org.gnu.gdb.arm.m-profile-mve} feature. + +It must contain the following: + +@itemize @minus +@item +@samp{vpr}, the vector predication status and control register. It is 32-bit +in size and has a custom flags type. The flags type is laid out in a way that +exposes the @samp{P0} field from bits 0 to 15, the @samp{MASK01} field from +bits 16 to 19 and the @samp{MASK23} field from bits 20 to 23. + +Bits 24 through 31 are reserved. +@end itemize + +When this feature is available, @value{GDBN} will synthesize the @samp{p0} +pseudo-register from @samp{vpr} contents. + +This feature must only be advertised if the target is M-profile. Advertising +this feature for targets that are not M-profile may cause @value{GDBN} to +assume the target is M-profile when it isn't. If the @samp{org.gnu.gdb.arm.vfp} feature is available alongside the @samp{org.gnu.gdb.arm.m-profile-mve} feature, @value{GDBN} will -synthesize the @samp{q} pseudo registers from @samp{d} register +synthesize the @samp{q} pseudo-registers from @samp{d} register contents. -The @samp{org.gnu.gdb.xscale.iwmmxt} feature is optional. If present, -it should contain at least registers @samp{wR0} through @samp{wR15} and -@samp{wCGR0} through @samp{wCGR3}. The @samp{wCID}, @samp{wCon}, -@samp{wCSSF}, and @samp{wCASF} registers are optional. +Extra registers are allowed in this feature, but they will not affect +@value{GDBN}. + +@subsubsection XScale iwMMXt feature + +The XScale @samp{org.gnu.gdb.xscale.iwmmxt} feature is optional. If present, +it must contain the following: + +@itemize @minus +@item +@samp{wR0} through @samp{wR15}, with size 64-bit and a custom type +@samp{iwmmxt_vec64i}. @samp{iwmmxt_vec64i} is a union of four other +types: @samp{uint64}, a 2-element vector of @samp{uint32}, a 4-element +vector of @samp{uint16} and a 8-element vector of @samp{uint8}. +@item +@samp{wCGR0} through @samp{wCGR3}, with size 32-bit and type @samp{int}. +@end itemize + +The following registers are optional: + +@itemize @minus +@item +@samp{wCID}, with size 32-bit and type @samp{int}. +@item +@samp{wCon}, with size 32-bit and type @samp{int}. +@item +@samp{wCSSF}, with size 32-bit and type @samp{int}. +@item +@samp{wCASF}, with size 32-bit and type @samp{int}. +@end itemize + +This feature should only be reported if the target is XScale. + +Extra registers are allowed in this feature, but they will not affect +@value{GDBN}. + +@subsubsection Vector Floating-Point (VFP) feature The @samp{org.gnu.gdb.arm.vfp} feature is optional. If present, it -should contain at least registers @samp{d0} through @samp{d15}. If -they are present, @samp{d16} through @samp{d31} should also be included. -@value{GDBN} will synthesize the single-precision registers from -halves of the double-precision registers. +should contain one of two possible sets of values depending on whether +VFP version 2 or VFP version 3 is in use. + +For VFP v2: + +@itemize @minus +@item +@samp{d0} through @samp{d15}. The double-precision registers. They are 64-bit +in size and have type @samp{ieee_double}. +@item +@samp{fpscr}, the floating-point status and control register. It has a size +of 32-bit and a type of @samp{int}. +@end itemize + +For VFP v3: + +@itemize @minus +@item +@samp{d0} through @samp{d31}. The double-precision registers. They are 64-bit +in size and have type @samp{ieee_double}. +@item +@samp{fpscr}, the floating-point status and control register. It has a size +of 32-bit and a type of @samp{int}. +@end itemize + +If this feature is available, @value{GDBN} will synthesize the +single-precision floating-point registers from halves of the double-precision +registers as pseudo-registers. + +Extra registers are allowed in this feature, but they will not affect +@value{GDBN}. + +@subsubsection NEON architecture feature The @samp{org.gnu.gdb.arm.neon} feature is optional. It does not need to contain registers; it instructs @value{GDBN} to display the @@ -47869,12 +48017,97 @@ quad-precision registers from pairs of double-precision registers. If this feature is present, @samp{org.gnu.gdb.arm.vfp} must also be present and include 32 double-precision registers. +Extra registers are allowed in this feature, but they will not affect +@value{GDBN}. + +@subsubsection M-profile Pointer Authentication and Branch Target Identification feature + The @samp{org.gnu.gdb.arm.m-profile-pacbti} feature is optional, and -acknowledges support for the ARMv8.1-m PACBTI extensions. @value{GDBN} -will track return address signing states and will decorate backtraces using -the [PAC] marker, similar to AArch64's PAC extension. +acknowledges support for the ARMv8.1-m PACBTI extensions. + +This feature doesn't contain any required registers, and it only serves as a +hint to @value{GDBN} that the debugging stub supports the ARMv8.1-m PACBTI +extensions. + +When @value{GDBN} sees this feature, it will track return address signing +states and will decorate backtraces using the [PAC] marker, similar to +AArch64's PAC extension. @xref{AArch64 PAC}. +Extra registers are allowed in this feature, but they will not affect +@value{GDBN}. + +@subsubsection M-profile system registers feature + +The @samp{org.gnu.gdb.arm.m-system} optional feature was introduced as a way to +inform @value{GDBN} about additional system registers. + +At the moment this feature must contain the following: + +@itemize @minus +@item +@samp{msp}, the main stack pointer register. It is 32-bit in size with +type @samp{data_ptr}. +@item +@samp{psp}, the process stack pointer register. It is 32-bit in size with +type @samp{data_ptr}. +@end itemize + +This feature must only be advertised for M-profile targets. When @value{GDBN} +sees this feature, it will attempt to track the values of @samp{msp} and +@samp{psp} across frames. + +Extra registers are allowed in this feature, but they will not affect +@value{GDBN}. + +@subsubsection M-profile Security Extensions feature + +The @samp{org.gnu.gdb.arm.secext} optional feature was introduced so +@value{GDBN} could better support the switching of stack pointers and +secure states in the Security Extensions. + +At the moment this feature must contain the following: + +@itemize @minus +@item +@samp{msp_ns}, the main stack pointer register (non-secure state). It is +32-bit in size with type @samp{data_ptr}. +@item +@samp{psp_ns}, the process stack pointer register (non-secure state). It is +32-bit in size with type @samp{data_ptr}. +@item +@samp{msp_s}, the main stack pointer register (secure state). It is 32-bit +in size with type @samp{data_ptr}. +@item +@samp{psp_s}, the process stack pointer register (secure state). It is 32-bit +in size with type @samp{data_ptr}. +@end itemize + +When @value{GDBN} sees this feature, it will attempt to track the values of +all 4 stack pointers across secure state transitions, potentially improving +unwinding when applications switch between security states. + +Extra registers are allowed in this feature, but they will not affect +@value{GDBN}. + +@subsubsection TLS registers feature + +The optional @samp{org.gnu.gdb.arm.tls} feature contains TLS registers. + +Currently it contains the following: + +@itemize @minus +@item +@samp{tpidruro}, the user read-only thread id register. It is 32-bit in size +and has type @samp{data_ptr}. +@end itemize + +At the moment @value{GDBN} looks for this feature, but doesn't do anything +with it other than displaying it. + +Extra registers are allowed in this feature, but they will not affect +@value{GDBN}. + @node i386 Features @subsection i386 Features @cindex target descriptions, i386 features