From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: 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 Authentication-Results: sourceware.org; dmarc=pass (p=quarantine dis=none) header.from=suse.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=suse.com 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 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=1h2j1z4rTfix91baew9M9a/3fqLlKi3uZAc01HrZGBc=; b=qwWAzMBDSFqYB8LwqnUixwVfyUtklVXFhMf24yx1+OVQYQzGY1/6QgFbkazNbOtxfAa4EdnKn2VC+HujgIAJSRwhmRGo7y3JQo7iljcAbHu0MIAMeS0LTC/kcSPKDeQ2ckAZuiicOE+qJHiFonWD0/s1r9L/oluIdbJ+VI7pr7fds4pT7eYu0Po1/BAIG/Wk6svwTKzodbCcWYqa1Hlvvm++V2snJpcY1qLyxjtjH+RNbG6ScbjKvHWBtJ32k3nOeCQamOaZdrxvRHSOOgJUE8t8OkbSRYJcGDcyrJMBXNNXN6XvEeJG+YLreeL2U72yyRN44cA6ZUOf4eo5G1uPew== Authentication-Results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=suse.com; 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 Cc: "H.J. Lu" From: Jan Beulich Subject: [PATCH] x86: generalize gas documentation for disabling of ISA extensions Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit 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?B?aUVYbWUvbzJvSzlLalhGeXB2MmtPWFpRZXQ3VU9Wa2puSHl1Z1d5L05veEEx?= =?utf-8?B?OGpXMDFiMllheDZQR0JNOUUrV3VlUnlLU1daVU1mTjVaZkprdFBubVlsbDdr?= =?utf-8?B?N0huOXZ5SlFTcVNoNmdTN2RtTXF6RG9yZmdPdFNGdTVGcWcrTFpIVkxmZFlj?= =?utf-8?B?MWlwVGJkVEhZWlYwR2NWUjgzK1JKeU40Nlg4WUF3dEVZMFYzSWRHbEFucXFC?= =?utf-8?B?dmNCYVRwZVVSRzA1VDNQUFU4WkV4clI2UGVZUDdWQ2NNdGpRZXdselcyWWdB?= =?utf-8?B?Wjk4Ymd4dElsbkFFSWY1Z3NVOFJFT3o5aUg1MkVKK0N3dkNOUXI5V2loblZv?= =?utf-8?B?MStUYXlvNlAxRHZ3OGpOQVBrWlo5MkIwVVZsdFBZMGhsczBCZGJvSXh1QUpY?= =?utf-8?B?aVg5TFhyNXMzNDhrcnIzQ3hISW9iN0dQUnBoU3B5NE5ub0lBcVJhUE8rZVhm?= =?utf-8?B?b25WQnJLM3NhVDdFWWlneFdIZHhCVDNVRVVNWThyTnFEK3MzSFZlQkxoanlI?= =?utf-8?B?OXltY0R1NVNUSDgvWVRiZWVjTlQ5aDZGT1JoWktEMXhVTGhsZGFlalBIM21N?= =?utf-8?B?aElIQ0M3cDRZMkxFZzUxUTlPUDFUeHQ4WFdHbFc2V3ovVmVZWkVHa2pjUlIv?= =?utf-8?B?SzE5ZWFNMHpXcnY2bGFVS2l2cUJHeWZvQnRSSnp4OHc0NDV6T3dHSm9iVThM?= =?utf-8?B?VGtLcU5BeC93c0JNdlVOcnpScGl0Y0RRYmVxMStrd08wRnBOWUlpeVZ0Ym0w?= =?utf-8?B?WVRPdVY2ME1YNmRGNDlJVE56eU93ZW9KVUFhZG51TytIWUlSR0lId0FwaXlD?= =?utf-8?B?TjNmK1FhZ2h5OG1hMVh3YWsvYjd6U2QvWnM3UzZXWUFwS2lDa05ldFFxZ2Rh?= =?utf-8?B?VG00OW1haVJUNmpNTjZaRWFTaTdYbGR1L2lSbXk4QkFibCs1Y3V3ekF2a3di?= =?utf-8?B?UzZuOE5PVC9YT2pDZENLS0FQS3pFNTBVVkJYWittMC90clJBSmY1RFJCaVRa?= =?utf-8?B?bWxWbDAvMFBSdVZEM0xKU0NZWU1zbUE0Y0hpNWNyQTZudm1acW1iVVFETzlE?= =?utf-8?B?akJMelM5K1oySDZaVktxWm5xSU9pUFg5T2xZWldzS1k4NmNUQUFDeEtuVFhQ?= =?utf-8?B?SEROekxTeTUrdmdFbDJqWVNWdnBjMC9lZzFRMjBsYURVYmNzUFJFb3Nla1Z6?= =?utf-8?B?bzYwcnowOXltUGdTMzZtby9TR1Mzd2NSdEQ3S0ZRaXBQOStpWEdreFdyeHFh?= =?utf-8?B?M1lXeGkydGFlZzB2TGltTXhXMW5ZSksvWU8yZXVFdmlwdmdWZW91QXBQTENM?= =?utf-8?B?c0ZsOVhWSDhsT2dYcDMrMUxMenU3Ni9UZm5MQVBaaHBZeWhNQ2ZrZEk4UXIy?= =?utf-8?B?UzREci9WamdCVDFRY0hxeTE0ZkE5eGZQOTJqdDVoZ1FOcXNHMll0QWFNZ3B2?= =?utf-8?B?RkNENXo4ZllxR3JkSzVDc0hoUDFXQ3YxNjdwcjlhYzdXeklIcSt3cGcyVmI4?= =?utf-8?B?Q2IwT3NWS1ZHMTN6WDVCTDdnWml6Q0ZIbmRUaTVKZENDWHVoYU1CLy84eVVV?= =?utf-8?B?UCttUWFSeDBndXZpNHJaTXZwQ2ljOGoxdmRPZGErUmhXQ3J6RlJhODl2Nms1?= =?utf-8?B?TUJTSHRxNW9pMW5JbUh3dVhkYW5ITXJmYXR4Rmg1dktHNnJ1YWczMGI3b04v?= =?utf-8?B?d0tSOXl2Mk9kSU1wWG9UWEIzTEpTUE5EQkNCWFhaVmVqQ3h5WllITFNwWUVX?= =?utf-8?B?aWVpZ2VVN0Z6Q2RLVVhzNElHVGVEa0NFQVRKWGM3MlNMbnE1WDdlL0NsT1pv?= =?utf-8?B?QWQxeHJPc3dEdUVRM0FIVnpvYnhQUmx0NHFTT0VwUzVNb01rNDhQejNXRTBW?= =?utf-8?B?ZklucWxhUVpvMHZ4RmZRQ25Wa29qczBuR1hQVXZKOENoNTRPUWVpZXZDaWI3?= =?utf-8?B?SVFPeFp3eG1UTThMZDNwUEoxOFF2SW9saElEUzMwMFBMTGFLU2xiaGo1a240?= =?utf-8?B?bDBxbUNlZnoveGsrSlVxV1J0UXMrWHZJMjFDenNDQWVSSnpqNGJyTkNuRjhK?= =?utf-8?B?QnljQmRrZ1JJaElsZzZNZThXUmtUSTRwWWZTSG9qaHQ1UjVnNnhhVDZFWmdl?= =?utf-8?Q?WF8GYhhIBaQIGyWclZb5p9Kxx?= 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 List-Id: 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