From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-qk1-x729.google.com (mail-qk1-x729.google.com [IPv6:2607:f8b0:4864:20::729]) by sourceware.org (Postfix) with ESMTPS id 63B2A3858C83 for ; Mon, 17 Oct 2022 22:28:54 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 63B2A3858C83 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-qk1-x729.google.com with SMTP id a5so7621214qkl.6 for ; Mon, 17 Oct 2022 15:28:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=yLplhoUY4UtwW3dKUcePw+TFq7dVE4KFGvjjFMbgsWo=; b=RNf6urhF9PGlXFk4DHtxsn3lEIKJDo8EHRz4ftjGL2OeUDuziCxirPgMmzxNkUl+M1 oTXW1MUMaRRXJoK+z6N885bmjiKZUW/aMxENyePrduTmje2DNS2LKtzG5MrmTrqKV0n3 eEW28+XMiT9oYweAWcJrE3W3f8ZanduIXpIs7FxK916b/IhYouKq432+6+bo0t/3X33F tkr8bSKH52mB5O0LJnLWSGueIrPNTImDBZeu7TqGrSGxbDtnWERKcto1Rai7io1H0YvZ fEL/m+ISMhwc6VNaHiKjYPFc1ee9VHkZB6pQEqDMZsWVqeLxZeBpg+8awvqg5UWRyDL8 bdig== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=yLplhoUY4UtwW3dKUcePw+TFq7dVE4KFGvjjFMbgsWo=; b=aE6TblP87jhM85LtEhfjDZv8WSKUPac8DZ4g5K0IfBZjx8/1JEP5k9AsHbXO80nUdi YnYxLcBIEU7q/uCtjg2zWHrBPanpBD9PNiqZFrPLXS4+j6BncaXWtE/KwP9+v9g+LBXN ukqPQ+VdFbp5NFE5hOLOaFrpEP++o3RIUv+SDPZFhvUJiVll3XD68mxFqM2+cbXcn1gE 2tLc/Ty3shdPLu7LAwkEAd25xtpuR1V1Z9CEYp+lRkNJqHrb25q78u6gnaahiC1QW+hG VTIYZcDon8Wjg9eVw5PZ9Un1UR7YrJirSxQkAI0sHAjTAb27oIl4Fsl8Gnc7qRvvSqiP JmiA== X-Gm-Message-State: ACrzQf1knkmZpiMNjy/zFmQizSjDvzzQ7y1ILaSnHJGDiAvSrWjgh82u 6KIwTV0w8FCGm8nEa5lKV8xXWl5lnNv/VPZVsC/etUsv X-Google-Smtp-Source: AMsMyM5Lu1T5N6CXNoa/NC7JcVPSzlgmDE1CI86Ca0RPm1bcPCzr6t33QXwWyWlYruaWX8BNmAz6K9EuQjTPDKiVDHQ= X-Received: by 2002:a05:620a:2683:b0:6cf:3768:8e4b with SMTP id c3-20020a05620a268300b006cf37688e4bmr9038865qkp.768.1666045733686; Mon, 17 Oct 2022 15:28:53 -0700 (PDT) MIME-Version: 1.0 References: <85dd526c-d3a7-72dc-5444-ed5573eebec1@suse.com> In-Reply-To: <85dd526c-d3a7-72dc-5444-ed5573eebec1@suse.com> From: "H.J. Lu" Date: Mon, 17 Oct 2022 15:28:17 -0700 Message-ID: Subject: Re: [PATCH] x86: generalize gas documentation for disabling of ISA extensions To: Jan Beulich Cc: Binutils Content-Type: text/plain; charset="UTF-8" X-Spam-Status: No, score=-3018.2 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,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: On Mon, Oct 17, 2022 at 1:30 AM Jan Beulich wrote: > > 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 OK. Thanks. -- H.J.