From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from EUR05-DB8-obe.outbound.protection.outlook.com (mail-db8eur05on2048.outbound.protection.outlook.com [40.107.20.48]) by sourceware.org (Postfix) with ESMTPS id 8FB9B38618EC for ; Thu, 14 Dec 2023 16:35:19 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 8FB9B38618EC Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=arm.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=arm.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 8FB9B38618EC Authentication-Results: server2.sourceware.org; arc=pass smtp.remote-ip=40.107.20.48 ARC-Seal: i=3; a=rsa-sha256; d=sourceware.org; s=key; t=1702571724; cv=pass; b=c2qmCU239GqfN6ggy/k0cWwy0Ofa+U8WmOn+zyEl8LWu9oSvRBRMXGTNxtU8Gnav19EYhXYTC35Uf6ztcvF/18KQA2aPaFxv7WVr77aDEefVJjUrvVsvO3ReV/JyRQdngsRl8g07gvdj4nETGjE/hMTAL3QulWWFY0nj1re/rYY= ARC-Message-Signature: i=3; a=rsa-sha256; d=sourceware.org; s=key; t=1702571724; c=relaxed/simple; bh=BUPLEvnB8OSz++Tnsraoz5Xt2Oj/05Y98oZky1ccUWA=; h=DKIM-Signature:DKIM-Signature:Date:From:To:Subject:Message-ID: MIME-Version; b=SLh7JuFDTETQAVBPbwz3gP+paPO2N3AJ07uyseIi2KCUbplF5txuDrBNI5Qzkqh6jWymXXhwYjcFOyRzr/b4xzI0IMWUjXqchkgVerT1M/Mq/5giPQYU9S6I0EHKZFbbfWCfZI8ITpwd+6G3yPYQe7iN4u2awoZk151h+12OuRc= ARC-Authentication-Results: i=3; server2.sourceware.org ARC-Seal: i=2; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=pass; b=dhZhy4u4m3Zqz/RVznSIEj+sfyqjO6fUC/UllYyI9hb6KqtyRxPB2oZ9BbDz6W+7J9PqAzUZpnbpvxFoDUWwK0MCYqTdgR5C11v6KhlsjJYZoMy/PyQm8INuoy4qHhU7BMSfXj7PgXxz6y/RoRABC9KPHUEMmy+EkHR9jqO6HCJfQWMl0MuUP2gMZ/YH9i3P4LHqdqE61Hs9E42zlZ4BPDK0MmD9ZKLlmUIcqQPk9hTIhPsY5OjzqtDk0YZY/Q+WWASBWhC4Y0j2i0sTCds4QoYF5vnp7xw3tG7rtrAOxRoDwHd8PzF1MssRNJGnaRE49NV4pCYh+ZF7DZwS+6v1tA== ARC-Message-Signature: i=2; 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=ddAAWzc3Z6hX85JU6l2l4Y9d44M37s5lJE9KAi5/iAY=; b=MlTcpW4pOl9n5Hba5NodeDmlL1THpyoTemgeo59Ie4iyWIfKOpx8wGxnAbNY3uF5u3aciUiTvAwHW2MWErtkm0j5lYV7FpDIRQD2GbHZAxtWy+rcATSFyeqOUjmGd3/XB47hjjDTCKNhSPH1vaOgFg30fvvDV2vFWLqdx40LOKHZXdQauKkB9MTNGA4Bamm7QeRD1gOpBjWaDUQY7D7QK66q517IY/VlekLPF80QHKIaXkJ1eLAIwOohwdc8t2rGlchOKN09pdyO7C/jBPnEFyYg1Xh6PDoWQewviMGFZkdOYWbDbSTyxfs1YJvkjQsdxTotP5PV5LFEBYBS7dM0EA== ARC-Authentication-Results: i=2; mx.microsoft.com 1; spf=pass (sender ip is 63.35.35.123) smtp.rcpttodomain=gcc.gnu.org smtp.mailfrom=arm.com; dmarc=pass (p=none sp=none pct=100) action=none header.from=arm.com; dkim=pass (signature was verified) header.d=armh.onmicrosoft.com; arc=pass (0 oda=1 ltdi=1 spf=[1,1,smtp.mailfrom=arm.com] dkim=[1,1,header.d=arm.com] dmarc=[1,1,header.from=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=ddAAWzc3Z6hX85JU6l2l4Y9d44M37s5lJE9KAi5/iAY=; b=yUJi0L/VlgBpTA8V25Nla3lkGwWFXWxCUw/4RtaRnclKF/2i1ph/VnxsIsHBxLKM91hxFHqCtG8q8Lz1kbGgCgtKl0pnSZV2SChKfWtSe8tnn5wtZAz9/N98YBQzavDUW5UkpHxbtHQ0pXAxnHVxSuMATE7bEVtykkpLTro4rew= Received: from AS9PR05CA0278.eurprd05.prod.outlook.com (2603:10a6:20b:492::18) by DU0PR08MB8161.eurprd08.prod.outlook.com (2603:10a6:10:3ec::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7091.28; Thu, 14 Dec 2023 16:35:15 +0000 Received: from AMS1EPF00000047.eurprd04.prod.outlook.com (2603:10a6:20b:492:cafe::de) by AS9PR05CA0278.outlook.office365.com (2603:10a6:20b:492::18) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7091.26 via Frontend Transport; Thu, 14 Dec 2023 16:35:15 +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 AMS1EPF00000047.mail.protection.outlook.com (10.167.16.135) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7091.26 via Frontend Transport; Thu, 14 Dec 2023 16:35:15 +0000 Received: ("Tessian outbound 385ad2f98d71:v228"); Thu, 14 Dec 2023 16:35:15 +0000 X-CheckRecipientChecked: true X-CR-MTA-CID: 021db52c3be89a71 X-CR-MTA-TID: 64aa7808 Received: from 0bb0a22b6b72.2 by 64aa7808-outbound-1.mta.getcheckrecipient.com id 3E821D93-AC1E-4B52-AEE8-F271584AD285.1; Thu, 14 Dec 2023 16:35:04 +0000 Received: from EUR04-VI1-obe.outbound.protection.outlook.com by 64aa7808-outbound-1.mta.getcheckrecipient.com with ESMTPS id 0bb0a22b6b72.2 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384); Thu, 14 Dec 2023 16:35:04 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=lq/e27x8qK90t70sNobGqYWpZRjN8hfbuJQk9XHFQRyZ8rQ0qD+eb7yyA/ACk86LVBmsNlAlGGRAiM3Mu9lMy3dzwoHz4NoDi/McOyi4PGyfkIaEq8lbeCSIJ73Rhk391nnG8ZY44R/EQx9Dx/ZOxzjwM2daP6wsf1EEPJf5eaPzjT2ueIDgw/7YXyGO02PryFY5v/KttIJKgwbe9u81gb/v6h7Wzx3kNDPgaG2ODxMZAec3lWOqA4oWIRPwyB7Ow4dsAVkN6wK3QzTVlnIzzI4+xxK/w+J8/HtQ/0rQ9POMAgBwz3//2WTnskEZ2v/mvbiBBNeFNYF6PFDub+1XIw== 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=ddAAWzc3Z6hX85JU6l2l4Y9d44M37s5lJE9KAi5/iAY=; b=cAr1NRbehAaRNU5e2iUFEZUjftBkJ0I2jNNjfHX+PlGTht3rA/3IEmX0h4IA6yHbIyShWAa1qlFRHGIA2BMsPn1xCFirPfU1ClpOI4bB4i81I21lx1O1a0pgKSuzBkiJGb1eNeC3cAjyfPdcrnRkh0+Ci1UEnSFzWRqQyblCTFs8LK3PfjkMAi7D1j7NMStyJNyKNfOn/wqxVDrxJbJ++sMLeNqgwbkpqbl9loHvtugPbkcuZyVQ1aJ6V4ihedtiINjUrU6W/pUDQXWzop9yoDZXuziagG6niuSs8HQjbztxTwdG7pY6HnRC5mIHbO1Z6u4q/9K3MbFbpR4DN2vgOw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=arm.com; dmarc=pass action=none header.from=arm.com; dkim=pass header.d=arm.com; 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=ddAAWzc3Z6hX85JU6l2l4Y9d44M37s5lJE9KAi5/iAY=; b=yUJi0L/VlgBpTA8V25Nla3lkGwWFXWxCUw/4RtaRnclKF/2i1ph/VnxsIsHBxLKM91hxFHqCtG8q8Lz1kbGgCgtKl0pnSZV2SChKfWtSe8tnn5wtZAz9/N98YBQzavDUW5UkpHxbtHQ0pXAxnHVxSuMATE7bEVtykkpLTro4rew= Authentication-Results-Original: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=arm.com; Received: from PAWPR08MB8958.eurprd08.prod.outlook.com (2603:10a6:102:33e::15) by AS2PR08MB9368.eurprd08.prod.outlook.com (2603:10a6:20b:594::7) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7091.28; Thu, 14 Dec 2023 16:35:01 +0000 Received: from PAWPR08MB8958.eurprd08.prod.outlook.com ([fe80::8512:cc10:24d4:1919]) by PAWPR08MB8958.eurprd08.prod.outlook.com ([fe80::8512:cc10:24d4:1919%5]) with mapi id 15.20.7091.028; Thu, 14 Dec 2023 16:35:01 +0000 Date: Thu, 14 Dec 2023 16:34:59 +0000 From: Alex Coplan To: gcc-patches@gcc.gnu.org Cc: Richard Earnshaw , Richard Sandiford , Kyrylo Tkachov Subject: [PATCH] doc: Document AArch64-specific asm operand modifiers Message-ID: Content-Type: multipart/mixed; boundary="xcgrQ+RP45LPmJZN" Content-Disposition: inline X-ClientProxiedBy: LO4P123CA0180.GBRP123.PROD.OUTLOOK.COM (2603:10a6:600:18a::23) To PAWPR08MB8958.eurprd08.prod.outlook.com (2603:10a6:102:33e::15) MIME-Version: 1.0 X-MS-TrafficTypeDiagnostic: PAWPR08MB8958:EE_|AS2PR08MB9368:EE_|AMS1EPF00000047:EE_|DU0PR08MB8161:EE_ X-MS-Office365-Filtering-Correlation-Id: 8da6d9d5-3ae6-4f9e-6a0f-08dbfcc2a6df 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: SB1r9CzwSq+7QDkFGl0sqeg42ApJg7i3uzrlNlRavmvhZy0KCdUzjy2y0rDA7Iz+Jk2Xgg9BpYbBApUgjfbMPiNKlzZ8UjmDK2rRD28VpRg1NVkkQnFHn+xKKUZ9HVl9OGIPOiI/bgYiaYTsP9XtwVICs1BLgcJM01H+xeGncaHaB22doujCmjKLhqaM/r6iSVVy7O2DtsJjoFbwX4WgtP5s0NjG/Jy0BYuM/WXFw5SmV7mpeCr43tNkSC4PoQrvTyUbRP/X9cwVK4KMA+ZrrzPLsToA4oy7iuzOZaPriCgXhFxZ5HIj22RNJ1+4ZJAClCD8zkNf3f1b8K7K2ij3DIvNXyG1xBckwXqbIwYS1gwmRd9i39BhVL/4y3sJCc5EnAi7TH4SAAZVZBLj8I1jUdmxBsHTDAuRFO3UYdSlZwCTeEHUyr2hP02ttjnNDjXP0RgVtpG4kAaw/oR2TVlnUOnEwyRwNbXl10xsh9+6BiSxfzqT/yDQ02egj3YjH6SYterFJAkWgpcgXOINskukwJv5AJslSwcbdUULyGuBtCHNxoWTJL69/3YdcQ0RaAnQWQs9wDefYpIPDl79e5rXcJp61NLTsVSFEjbVE9SMJX0= X-Forefront-Antispam-Report-Untrusted: CIP:255.255.255.255;CTRY:;LANG:en;SCL:1;SRV:;IPV:NLI;SFV:NSPM;H:PAWPR08MB8958.eurprd08.prod.outlook.com;PTR:;CAT:NONE;SFS:(13230031)(396003)(346002)(136003)(366004)(376002)(39860400002)(230922051799003)(451199024)(64100799003)(186009)(1800799012)(4326008)(8936002)(66556008)(66476007)(66946007)(6916009)(54906003)(8676002)(21480400003)(316002)(66574015)(44832011)(33964004)(6506007)(44144004)(6486002)(478600001)(26005)(2616005)(6512007)(2906002)(5660300002)(235185007)(41300700001)(36756003)(38100700002)(86362001)(2700100001);DIR:OUT;SFP:1101; X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS2PR08MB9368 Original-Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=arm.com; X-EOPAttributedMessage: 0 X-MS-Exchange-Transport-CrossTenantHeadersStripped: AMS1EPF00000047.eurprd04.prod.outlook.com X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id-Prvs: b4f3886f-d7b1-49b9-9441-08dbfcc29e85 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: scsm3kHikc6q8geZLxhN5nQDlu1huuKn6glS0TrSffUzzwWj331e+KiebAzpVg/hOnRMi3KAO4gK9ftKxd9AjVssn3hGQ0hDyE6Qbo59OxjQi4Fg/FpnoDb1ys3yMJDHmRQZVcQlrrp7vZKy9JYj063Wokl4738slcQhHkoVG/Y1JBiblzd584VkUvyWitlj+ZJJaoHAoYuF400d+Orh6pPxX4X3KQl658c/dZQZU+W6prcTSm3lsTHiaHiMWHhV1NaVbyTA+NOd03Pz+zDOcrfiOhOuoHgxy7du9TWowKa98t739C4f6Pj3xAPISabKUcUnd6wWhoYJ9bLfts+MrJXQ23Nyb4m/AOJSEpe1RqdpMP8HpX+PSPZaPkO8ayXvhvMWVXnEabetljhbOb405MimWX7JF8cIOUeKs+5NYlLD1iLBSvuiSYQuRX3ESqsS8xylkqe2paQxOIMRWRmGe14fYmX1/VuuPkG4RIbyWXcyUdh7XDX7mOVhQCXU0xxNN3gCr220tw1qSQV63CibQpsJNbNI2eIQdrB1/IWVT99gnatr0aDyM2YqwoXVapXZj7IsVrSyOnCbzN8PotkhG6CQcaQIj+OXR8wAsh9mVO6GE4hUocH/psvYaHk7eYhyx9A6bpXRF8VJgpVxcCGbVL2tJAnLbeZel8XuCtzZRHawQxXtlzE6xbD3f4a82iLWeUPfMWBqiJT2XRqIlSHd9tocbXuvG1baVhF87zz/W8/XQKgB0am8zEIyi+1TeyYi13dAn7jRpvXWXxF7e6QCPQ== 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)(346002)(39860400002)(136003)(396003)(376002)(230922051799003)(451199024)(1800799012)(82310400011)(64100799003)(186009)(46966006)(40470700004)(36840700001)(316002)(4326008)(8936002)(8676002)(40480700001)(6506007)(6512007)(336012)(44144004)(33964004)(54906003)(70586007)(70206006)(6916009)(44832011)(478600001)(86362001)(235185007)(5660300002)(36860700001)(6486002)(21480400003)(41300700001)(36756003)(2906002)(81166007)(356005)(40460700003)(66574015)(47076005)(82740400003)(2616005)(26005)(2700100001);DIR:OUT;SFP:1101; X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 14 Dec 2023 16:35:15.6102 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 8da6d9d5-3ae6-4f9e-6a0f-08dbfcc2a6df 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: AMS1EPF00000047.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Anonymous X-MS-Exchange-CrossTenant-FromEntityHeader: HybridOnPrem X-MS-Exchange-Transport-CrossTenantHeadersStamped: DU0PR08MB8161 X-Spam-Status: No, score=-12.0 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 List-Id: --xcgrQ+RP45LPmJZN Content-Type: text/plain; charset=utf-8 Content-Disposition: inline Hi, As it stands, GCC doesn't document any public AArch64-specific operand modifiers for use in inline asm. This patch fixes that by documenting an initial set of public AArch64-specific operand modifiers. Tested with make html and checking the output looks OK in a browser. OK for trunk? Thanks, Alex gcc/ChangeLog: * doc/extend.texi: Document AArch64 Operand Modifiers. --xcgrQ+RP45LPmJZN Content-Type: text/plain; charset=utf-8 Content-Disposition: attachment; filename="patch.txt" diff --git a/gcc/doc/extend.texi b/gcc/doc/extend.texi index e8b5e771f7a..6ade36759ee 100644 --- a/gcc/doc/extend.texi +++ b/gcc/doc/extend.texi @@ -11723,6 +11723,31 @@ operand as if it were a memory reference. @tab @code{%l0} @end multitable +@anchor{aarch64Operandmodifiers} +@subsubsection AArch64 Operand Modifiers + +The following table shows the modifiers supported by AArch64 and their effects: + +@multitable @columnfractions .10 .90 +@headitem Modifier @tab Description +@item @code{w} @tab Print a 32-bit general-purpose register name or, given a +constant zero operand, the 32-bit zero register (@code{wzr}). +@item @code{x} @tab Print a 64-bit general-purpose register name or, given a +constant zero operand, the 64-bit zero register (@code{xzr}). +@item @code{b} @tab Print an FP/SIMD register name with a @code{b} (byte, 8-bit) +prefix. +@item @code{h} @tab Print an FP/SIMD register name with an @code{h} (halfword, +16-bit) prefix. +@item @code{s} @tab Print an FP/SIMD register name with an @code{s} (single +word, 32-bit) prefix. +@item @code{d} @tab Print an FP/SIMD register name with a @code{d} (doubleword, +64-bit) prefix. +@item @code{q} @tab Print an FP/SIMD register name with a @code{q} (quadword, +128-bit) prefix. +@item @code{Z} @tab Print an FP/SIMD register name as an SVE register (i.e. with +a @code{z} prefix). This is a no-op for SVE register operands. +@end multitable + @anchor{x86Operandmodifiers} @subsubsection x86 Operand Modifiers --xcgrQ+RP45LPmJZN--