From patchwork Mon Oct 17 08:30:12 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jan Beulich X-Patchwork-Id: 3272 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a5d:4ac7:0:0:0:0:0 with SMTP id y7csp1332949wrs; Mon, 17 Oct 2022 01:31:11 -0700 (PDT) X-Google-Smtp-Source: AMsMyM7o431DEMav7beIFDZoahIVNhXcA+juG8r+e/89VzaOGV7Dvsmj6MRg5ls7KI3qaAIjmEX8 X-Received: by 2002:a17:907:c18:b0:78d:8577:7c30 with SMTP id ga24-20020a1709070c1800b0078d85777c30mr7404220ejc.413.1665995470850; Mon, 17 Oct 2022 01:31:10 -0700 (PDT) Received: from sourceware.org (server2.sourceware.org. [2620:52:3:1:0:246e:9693:128c]) by mx.google.com with ESMTPS id sa42-20020a1709076d2a00b0078c80f5d81bsi7016480ejc.47.2022.10.17.01.31.10 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 17 Oct 2022 01:31:10 -0700 (PDT) Received-SPF: pass (google.com: domain of binutils-bounces+ouuuleilei=gmail.com@sourceware.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) client-ip=2620:52:3:1:0:246e:9693:128c; Authentication-Results: mx.google.com; dkim=pass header.i=@sourceware.org header.s=default header.b=TFXS1kT8; arc=fail (signature failed); spf=pass (google.com: domain of binutils-bounces+ouuuleilei=gmail.com@sourceware.org designates 2620:52:3:1:0:246e:9693:128c as permitted sender) smtp.mailfrom="binutils-bounces+ouuuleilei=gmail.com@sourceware.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 001533858281 for ; Mon, 17 Oct 2022 08:31:08 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 001533858281 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1665995469; bh=1h2j1z4rTfix91baew9M9a/3fqLlKi3uZAc01HrZGBc=; h=Date:To:Subject:List-Id:List-Unsubscribe:List-Archive:List-Post: List-Help:List-Subscribe:From:Reply-To:From; b=TFXS1kT8uifH9TL0m5KIcdwwEV5unuO2RABLcrHTf9elfmWwbTO69goDvAHTixzEU 2cJM7Fvg/4xSd1rbKBkVCW6c0WuDUKLRxSTqEj6zSnSuJlEFUHN2WzuJFoEZGdVzvv kSq1BEqlfWx0ooDvPGGkgW4JxVy2oowlaamnB+Qc= X-Original-To: binutils@sourceware.org Delivered-To: binutils@sourceware.org Received: from EUR02-AM5-obe.outbound.protection.outlook.com (mail-eopbgr00045.outbound.protection.outlook.com [40.107.0.45]) by sourceware.org (Postfix) with ESMTPS id EFB753858C83 for ; Mon, 17 Oct 2022 08:30:16 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org EFB753858C83 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=PVYoSbVPuqVdYmS3rNFvevOsTdUmlEFhLLYaFpWFhX5eNbH1ovXNFllbksHm7eZ5c1B6ByB0dBFZPxYCE4sNu6bPMHNJGt3ki7XQR6eOvvvii29CLSUV5Esiwv5SkJpt2zk0lfe8qk7lahtOdB9WvDsDssk6Gk7h6ABOurdgCPy46Kdq4JvLdQsSI7E4xs2EY5vsySMD6e7mGjmWdA+YYRmL5b2XXbKSfG+kgMKvREM/FN85B6axP5Xro2YGVFxMyOXjg+ogbU+zO48RteQWrUkCgbosRRy6MxFFuuTh82Cg6neVSJgHbMEtrGf0/+wq7dn7iliBzpWV3ru25iVu0w== 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=1h2j1z4rTfix91baew9M9a/3fqLlKi3uZAc01HrZGBc=; b=RfHVRr/wUYKihy9NWTbMk6Ne3ZjSNBuAadufQn/didqDrclmzb2rJUvyHYoqSErKrNiZ1seth3v+K2sApntMIJ5hzH46/dosLleM495bRSGIrqcYYmnKBHTSiHs7LtLwBweeO6NCEaykAcYH4s6EhUT32hlEOVJyCvRv/0nq4cMkEjlAfhijLly+dt3ZCzl9bGaqs2jYYMBuaHHDRdt6XXUTuoUXiuGTeBYDlFU6EpHPxPN/izFLoJcVgX4M9Rvczq9UXq2vjN5KGayxNMtqpo/NTCS+DDRTPohSQCHXAz7HQwQQbZ3aaixFG7+9prJd+iZg961HglXBs1LZNQl9cA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=suse.com; dmarc=pass action=none header.from=suse.com; dkim=pass header.d=suse.com; arc=none Received: from VE1PR04MB6560.eurprd04.prod.outlook.com (2603:10a6:803:122::25) by AS8PR04MB7686.eurprd04.prod.outlook.com (2603:10a6:20b:290::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5723.26; Mon, 17 Oct 2022 08:30:13 +0000 Received: from VE1PR04MB6560.eurprd04.prod.outlook.com ([fe80::2459:15ae:e6cb:218a]) by VE1PR04MB6560.eurprd04.prod.outlook.com ([fe80::2459:15ae:e6cb:218a%7]) with mapi id 15.20.5723.033; Mon, 17 Oct 2022 08:30:13 +0000 Message-ID: <85dd526c-d3a7-72dc-5444-ed5573eebec1@suse.com> Date: Mon, 17 Oct 2022 10:30:12 +0200 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Thunderbird/102.3.3 Content-Language: en-US To: Binutils Subject: [PATCH] x86: generalize gas documentation for disabling of ISA extensions X-ClientProxiedBy: AM6P192CA0038.EURP192.PROD.OUTLOOK.COM (2603:10a6:209:82::15) To VE1PR04MB6560.eurprd04.prod.outlook.com (2603:10a6:803:122::25) MIME-Version: 1.0 X-MS-PublicTrafficType: Email X-MS-TrafficTypeDiagnostic: VE1PR04MB6560:EE_|AS8PR04MB7686:EE_ X-MS-Office365-Filtering-Correlation-Id: 3e4a2a99-5a0d-4035-a8d5-08dab019cf5d X-MS-Exchange-SenderADCheck: 1 X-MS-Exchange-AntiSpam-Relay: 0 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: yqXvRVCZuw4UATCN0oyhY36YU4BRuGw8OnRfvz3bhdg1uj7Dc5tyVShz5Piu432NrutR/Ea0DjqexB/JoySJb9THmwGmFrPju9VQ9YBEhUykItum6aVKEroLbgjJ0ow9XsQLLuAjlAyFZQOUZn53ajuZbMmC3SC+hfat5pFvy63+UR8K5dFDaBOr99UUYWqsX8MG2ypy0KaPjXhvB/YR1u8oU9EPXZ7F91e/96sJkXbJESbxkfHZMrVlrm6g0u16hJPt4sjIktDmJ166mTS0423Uw1dYUbCtYqwP8GT9AtMIFAp71zoyhL7QtchtwAzF0fz51aKwxLpPvUCJ/FyYbLSIEllCUjbsLD+aJMuBfwMCI8OxiW3+rJfSJ/TLdXwr7k2pN0eFxhsJN6vBL1QLAu9HSpfuojMeLCVZ8OlqOD1zlLlkaX/lbbESwP3kxWroJrT7LYsPq/TXq/AWjKgGvpp+mP+xXA9koJPXpNybbPPuxcXBqBXAaqTY+nv/F1TJdbpXgLTigF7VYTmKO9HQtkfa07tsZS3crY2Zb/ZfbpI/Nq5Uf254IgAA21f8DmgwHkdzgym1+UYeqNag151PgUW+mfLJQhUqtSAe7X+k1VhRo9fTmoKCMxXoqn2Z4cvriS2nep9CfDx22rq0C5TPhHjDvo0pzJfAn+sw28klznOyf1vI0BQGuS5gY3zIxyrdwbPpxcpkgChmL+EljDoXoOC6xfCywAxqB/i41Jhrh7kC4bvoZhHYFaKWiIaaTOlD9cqJAJCHP92efzDN7sg/MykyfCdIrPsMzX/s4ndGuNg= X-Forefront-Antispam-Report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:VE1PR04MB6560.eurprd04.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230022)(136003)(366004)(39860400002)(376002)(346002)(396003)(451199015)(31686004)(5660300002)(316002)(66946007)(6916009)(66476007)(4326008)(8676002)(6486002)(41300700001)(6512007)(6506007)(26005)(8936002)(2906002)(66556008)(186003)(2616005)(36756003)(83380400001)(38100700002)(31696002)(478600001)(86362001)(43740500002)(45980500001); DIR:OUT; SFP:1101; X-MS-Exchange-AntiSpam-MessageData-ChunkCount: 1 X-MS-Exchange-AntiSpam-MessageData-0: =?utf-8?q?iEXme/o2oK9KjXFypv2kOXZQet7U?= =?utf-8?q?OVkjnHyugWy/NoxA18jW01b2Yax6PGBM9E+WueRyKSWZUMfN5ZfJktPnmYll7k7Hn?= =?utf-8?q?9vyJQSqSh6gS7dmMqzDorfgOtSFu5Fqg+LZHVLfdYc1ipTbdTHYZV0GcVR83+RJyN?= =?utf-8?q?46X8YAwtEY0V3IdGlAnqqBvcBaTpeURG05T3PPU8ZExrR6PeYP7VCcMtjQewlzW2Y?= =?utf-8?q?gAZ98bgxtIlnAEIf5gsU8REOz9iH52EJ+CwvCNQr9WihnVo1+Tayo6P1Dvw8jNAPk?= =?utf-8?q?ZZ92B0UVltPY0hls0BdboIxuAJXiX9LXr5s348krr3CxHIob7GPRphSpy4NnoIAqR?= =?utf-8?q?aPO+eXfonVBrK3saT7EYigxWHdxBT3UEUMY8rNqD+s3HVeBLhjyH9ymcDu5STH8/Y?= =?utf-8?q?TbeecNT9h6FORhZKD1xULhldaejPH3mMhIHCC7p4Y2LEg51Q9OP1Txt8XWGlW6Wz/?= =?utf-8?q?VeYZEGkjcRR/K19eaM0zWrv6laUKivqBGyfoBtRJzx8w445zOwGJobU8LTkKqNAx/?= =?utf-8?q?wsBMvUNrzRpitcDQbeq1+kwO0FpNYIiyVtbm0YTOuV60MX6dF49ITNzyOweoJUAad?= =?utf-8?q?nuO+HYIRGIHwApiyCN3f+Qaghy8ma1Xwak/b7zSd/Zs7S6WYApKiCkNetQqgdaTm4?= =?utf-8?q?9maiRT6jMN6ZEaSi7Xldu/iRmy8BAbl+5cuwzAvkwbS6n8NOT/XOjCdCKKAPKzE50?= =?utf-8?q?UVBXZ+m0/trRAJf5DRBiTZmlVl0/0PRuVD3LJSCYYMsmA4cHi5crA6nvmZqmbUQDO?= =?utf-8?q?9DjBLzS9+Z2H6ZVKqZnqIOiPX9OlYZWsKY86cTAACxKnTXPHDNzLSy5+vgEl2jYSV?= =?utf-8?q?vpc0/eg1Q20laDUbcsPREosekVzo60rz09ymPgS36mo/SGS3wcRtD7KFQipP9+iXG?= =?utf-8?q?kxWrxqa3YWxi2taeg0vLimMxW1nYJK/YO2euEvipvgVeouApPLCLsFl9XVH8lOgXp?= =?utf-8?q?3+1LLzu76/TfnLAPZhpYyhMCfkdI8Qr2S4Dr/VjgBT1QcHqy14fA9xfP92jt5hgQN?= =?utf-8?q?qsG2YtAaMgpvFCD5z8fYqGrdK5CsHhP1WCv167pr9ac7WzIHq+wpg2Vb8Cb0OsVKV?= =?utf-8?q?G13zX5BL7gZizCFHndTi5JdCCXuhaMB//8yUUP+mQaRx0guvi4rZMvpCic8j1vdOd?= =?utf-8?q?a+RhWCrzFRa89v6k5MBSHtq5oi1nImHwuXdanHMrfatxFh5vKG6ruag30b7oN/wKR?= =?utf-8?q?9yv2OdIMpXoTXB3LJSPNDBCBXXZVejCxyZYHLSpYEWieigeU7FzCdKUXs4IGTeDkC?= =?utf-8?q?EATJXc72SLnq5X7e/ClOZoAd1xrOswDuEQ3AHVzobxPRlt4qSOEpS5MoMk48Pz3WE?= =?utf-8?q?0VfInqlaQZo0vxFfQCnVkojs0nGXPUvJ8Ch54OQeievCib7IQOxZwxmTM8Ld3pPJ1?= =?utf-8?q?8QvIolhIDS300PLLaKSlbhj5kn4l0qmCefz/xk+JUqWRtQs+XvI21CzsCAeRJzj4b?= =?utf-8?q?rNCnF8JBycBdkgRIhIlg6Me8WRkTI4pYfSHojht5R5g6xaT6EZgeWF8GYhhIBaQIG?= =?utf-8?q?yWclZb5p9Kxx?= X-OriginatorOrg: suse.com X-MS-Exchange-CrossTenant-Network-Message-Id: 3e4a2a99-5a0d-4035-a8d5-08dab019cf5d X-MS-Exchange-CrossTenant-AuthSource: VE1PR04MB6560.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-OriginalArrivalTime: 17 Oct 2022 08:30:13.2132 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: f7a17af6-1c5c-4a36-aa8b-f5be247aa4ba X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: JruOVIkKoNTsWP5LilfznL5IIggbk4mUmJVgPI56ONLhgw/XJb1XEfeGalkkRkml1Ccw7sepI+Ycy+Y37f7iwg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AS8PR04MB7686 X-Spam-Status: No, score=-3029.8 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, RCVD_IN_DNSWL_NONE, RCVD_IN_MSPIKE_H2, SPF_HELO_PASS, SPF_PASS, TXREP 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: binutils@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Binutils mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-Patchwork-Original-From: Jan Beulich via Binutils From: Jan Beulich Reply-To: Jan Beulich Errors-To: binutils-bounces+ouuuleilei=gmail.com@sourceware.org Sender: "Binutils" X-getmail-retrieved-from-mailbox: =?utf-8?q?INBOX?= X-GMAIL-THRID: =?utf-8?q?1746922866685317243?= X-GMAIL-MSGID: =?utf-8?q?1746922866685317243?= As of commit ae89daecb132 ("x86: generalize disabling of sub- architectures") there's no arbitrary subset of ISAs which can also be disabled. This should have been reflected in documentation right away. Since I failed to do so, correct this now. --- a/gas/doc/c-i386.texi +++ b/gas/doc/c-i386.texi @@ -137,16 +137,9 @@ accept various extension mnemonics. For @code{287}, @code{387}, @code{687}, -@code{no87}, -@code{no287}, -@code{no387}, -@code{no687}, @code{cmov}, -@code{nocmov}, @code{fxsr}, -@code{nofxsr}, @code{mmx}, -@code{nommx}, @code{sse}, @code{sse2}, @code{sse3}, @@ -155,18 +148,8 @@ accept various extension mnemonics. For @code{sse4.1}, @code{sse4.2}, @code{sse4}, -@code{nosse}, -@code{nosse2}, -@code{nosse3}, -@code{nosse4a}, -@code{nossse3}, -@code{nosse4.1}, -@code{nosse4.2}, -@code{nosse4}, @code{avx}, @code{avx2}, -@code{noavx}, -@code{noavx2}, @code{adx}, @code{rdseed}, @code{prfchw}, @@ -189,9 +172,7 @@ accept various extension mnemonics. For @code{serialize}, @code{tsxldtrk}, @code{kl}, -@code{nokl}, @code{widekl}, -@code{nowidekl}, @code{hreset}, @code{avx512f}, @code{avx512cd}, @@ -213,37 +194,9 @@ accept various extension mnemonics. For @code{avx512_bf16}, @code{avx_vnni}, @code{avx512_fp16}, -@code{noavx512f}, -@code{noavx512cd}, -@code{noavx512er}, -@code{noavx512pf}, -@code{noavx512vl}, -@code{noavx512bw}, -@code{noavx512dq}, -@code{noavx512ifma}, -@code{noavx512vbmi}, -@code{noavx512_4fmaps}, -@code{noavx512_4vnniw}, -@code{noavx512_vpopcntdq}, -@code{noavx512_vbmi2}, -@code{noavx512_vnni}, -@code{noavx512_bitalg}, -@code{noavx512_vp2intersect}, -@code{notdx}, -@code{noavx512_bf16}, -@code{noavx_vnni}, -@code{noavx512_fp16}, -@code{noenqcmd}, -@code{noserialize}, -@code{notsxldtrk}, @code{amx_int8}, -@code{noamx_int8}, @code{amx_bf16}, -@code{noamx_bf16}, @code{amx_tile}, -@code{noamx_tile}, -@code{nouintr}, -@code{nohreset}, @code{vmx}, @code{vmfunc}, @code{smx}, @@ -291,8 +244,8 @@ accept various extension mnemonics. For @code{tlbsync}, @code{svme} and @code{padlock}. -Note that rather than extending a basic instruction set, the extension -mnemonics starting with @code{no} revoke the respective functionality. +Note that these extension mnemonics can be prefixed with @code{no} to revoke +the respective (and any dependent) functionality. When the @code{.arch} directive is used with @option{-march}, the @code{.arch} directive will take precedent. @@ -1559,6 +1512,9 @@ conditional jumps will be promoted when sequence consisting of a conditional jump of the opposite sense around an unconditional jump to the target. +Note that the sub-architecture specifiers (starting with a dot) can be prefixed +with @code{no} to revoke the respective (and any dependent) functionality. + Following the CPU architecture (but not a sub-architecture, which are those starting with a dot), you may specify @samp{jumps} or @samp{nojumps} to control automatic promotion of conditional jumps. @samp{jumps} is the