From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-17.2 required=3.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_ADSP_CUSTOM_MED,DKIM_SIGNED,DKIM_VALID,HEADER_FROM_DIFFERENT_DOMAINS, INCLUDES_CR_TRAILER,INCLUDES_PATCH,MAILING_LIST_MULTI,SPF_HELO_NONE,SPF_PASS, URIBL_BLOCKED,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id E0E3BC11F66 for ; Wed, 30 Jun 2021 23:17:58 +0000 (UTC) Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id B115561221 for ; Wed, 30 Jun 2021 23:17:58 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org B115561221 Authentication-Results: mail.kernel.org; dmarc=fail (p=reject dis=none) header.from=google.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=lists.infradead.org; s=bombadil.20210309; h=Sender: Content-Transfer-Encoding:Content-Type:List-Subscribe:List-Help:List-Post: List-Archive:List-Unsubscribe:List-Id:Cc:To:From:Subject:References: Mime-Version:Message-Id:In-Reply-To:Date:Reply-To:Content-ID: Content-Description:Resent-Date:Resent-From:Resent-Sender:Resent-To:Resent-Cc :Resent-Message-ID:List-Owner; bh=rOUgy0X9X1ZGqSAX7jInKErpbvPt8GbXdTYsH1vgIYE=; b=EU9qnwlw+iMcNVBGBrSsr4LmA3 hvxsnn7WBbzcwBRzsS/ONJQz+FIeW0XTrne8dpKKADv8XHhUsXI+zr8npzSxt1baY7IPFxF6eVi+z kKNhohza1Oa2PSGqjjKNIGV/bBcGxHhJrQjf0QtPI89caXNh3LOu4yY6p5f8O5SWRDqHH9LlkQbPC d+6R7jGPoZ4hYQaxwwUk9eYcFc1jcPiZlFt75FUhm2ZYOCg91YFyd0qxIDESpzRa7P/15LedCoeY1 dvHqbeWK4NSaCxqaKGU0u4vmURWgfshStlbZ2ZNxnxDWGas9KET0zbN+DLGbab8WrVzozAT2tFu+S RloELrLA==; Received: from localhost ([::1] helo=bombadil.infradead.org) by bombadil.infradead.org with esmtp (Exim 4.94.2 #2 (Red Hat Linux)) id 1lyjRB-00FV5H-M4; Wed, 30 Jun 2021 23:16:09 +0000 Received: from mail-yb1-xb49.google.com ([2607:f8b0:4864:20::b49]) by bombadil.infradead.org with esmtps (Exim 4.94.2 #2 (Red Hat Linux)) id 1lyjQX-00FUyA-AH for linux-arm-kernel@lists.infradead.org; Wed, 30 Jun 2021 23:15:31 +0000 Received: by mail-yb1-xb49.google.com with SMTP id h7-20020a5b0a870000b029054c59edf217so6037932ybq.3 for ; Wed, 30 Jun 2021 16:15:28 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=20161025; h=date:in-reply-to:message-id:mime-version:references:subject:from:to :cc:content-transfer-encoding; bh=wuCMvOpcLz1EO/bGDBjP5AoaMfs4wSC6ZWl6eaxBapc=; b=kmEfeGk4v14GKNip8ux0l4l2+bSKbHuYhxp9TRftdj4n8uTleetfA81UZjuk8RAMrs XKfZSCTX22mQ+onjq8WlGYF4d3gGwfNH4JIFMjhkD0koCiY1MoZPGdSGRnUsWyWioR42 Vs2/zQ9v3bElf2SjBI1JB1w1c6ti2EQKjg/Y3AfDo9IygwjDqsOud7Alv3GgoEjWXGCC KIPLNDrPZTvcDhkuukXiIpS6skleAz1cOPCEEu+1GnoCZYPJwpKC4iIckDa4RoUGgw80 H8bMj2eiHK4IzNtOz9ZKFkJJb0L2X2q1dAudGJQmTgs4cs+bH+YFeKygnU7dobDpUfZd ljzA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:date:in-reply-to:message-id:mime-version :references:subject:from:to:cc:content-transfer-encoding; bh=wuCMvOpcLz1EO/bGDBjP5AoaMfs4wSC6ZWl6eaxBapc=; b=BF0cXJrL0wp4WoqLe8+bVATzRDwaRd54iNfUsuG4ODkw7ueVZxwE2PsPFJ2k5+rH9y 6HIFIZ+9faQmMVLdoVc84TaaweLRaoq/ciQ+Gp+GYpyj6tRQ+VosTacDHtjbWv6OZRUq tdA0Or9EVGNbBICL4dGONZ5EjF2OX22aCFatx0mU3/GFjZC5mwOJNIZ/9yGW6SZBrxSl KbGzCGVXzDXlqZpO6d9xz5hmO/+xNAqK/D0wkr5z3hHhiL6EJvGi/nRxdYjHFteitGkV juHQC0LSJIbKX3Zx8IcGSGeiPD4iOk8CX6VI2LCI4N2YME0TPrAyBcgUqua2jHGHvECk s3ew== X-Gm-Message-State: AOAM533PxDK+a/AzcWWyWaiY0P+LV0J6SG9Dqpobf8U1NNbEo3wSpWzL M1PcglaYYWfyRnliLgGMzyNBiLs= X-Google-Smtp-Source: ABdhPJxUJo0LJ4jCZzVUhiBC2Zc4BXc+gSLqpv2qKCrF71bDf6QI8JlN+M2MhmM+OYym8GFJj4PMUAQ= X-Received: from pcc-desktop.svl.corp.google.com ([2620:15c:2ce:200:8b00:104d:c249:d343]) (user=pcc job=sendgmr) by 2002:a25:2d57:: with SMTP id s23mr5185090ybe.302.1625094927802; Wed, 30 Jun 2021 16:15:27 -0700 (PDT) Date: Wed, 30 Jun 2021 16:15:09 -0700 In-Reply-To: <20210630231509.3773172-1-pcc@google.com> Message-Id: <20210630231509.3773172-5-pcc@google.com> Mime-Version: 1.0 References: <20210630231509.3773172-1-pcc@google.com> X-Mailer: git-send-email 2.32.0.93.g670b81a890-goog Subject: [PATCH v8 4/4] Documentation: document the preferred tag checking mode feature From: Peter Collingbourne To: Catalin Marinas , Vincenzo Frascino , Will Deacon Cc: Peter Collingbourne , Evgenii Stepanov , Szabolcs Nagy , Tejas Belagod , linux-arm-kernel@lists.infradead.org X-CRM114-Version: 20100106-BlameMichelson ( TRE 0.8.0 (BSD) ) MR-646709E3 X-CRM114-CacheID: sfid-20210630_161529_409001_3E6FB5E6 X-CRM114-Status: GOOD ( 17.59 ) X-BeenThere: linux-arm-kernel@lists.infradead.org X-Mailman-Version: 2.1.34 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Sender: "linux-arm-kernel" Errors-To: linux-arm-kernel-bounces+linux-arm-kernel=archiver.kernel.org@lists.infradead.org RG9jdW1lbnQgdGhlIGZ1bmN0aW9uYWxpdHkgYWRkZWQgaW4gdGhlIHByZXZpb3VzIHBhdGNoZXMu CgpMaW5rOiBodHRwczovL2xpbnV4LXJldmlldy5nb29nbGVzb3VyY2UuY29tL2lkL0k0ODIxN2Nj M2U4YjhkYTMzYWJjMDhjYmFkZGMxMWNmNDM2MGExYjg2ClNpZ25lZC1vZmYtYnk6IFBldGVyIENv bGxpbmdib3VybmUgPHBjY0Bnb29nbGUuY29tPgotLS0KIC4uLi9hcm02NC9tZW1vcnktdGFnZ2lu Zy1leHRlbnNpb24ucnN0ICAgICAgICB8IDQ4ICsrKysrKysrKysrKysrKystLS0KIDEgZmlsZSBj aGFuZ2VkLCA0MSBpbnNlcnRpb25zKCspLCA3IGRlbGV0aW9ucygtKQoKZGlmZiAtLWdpdCBhL0Rv Y3VtZW50YXRpb24vYXJtNjQvbWVtb3J5LXRhZ2dpbmctZXh0ZW5zaW9uLnJzdCBiL0RvY3VtZW50 YXRpb24vYXJtNjQvbWVtb3J5LXRhZ2dpbmctZXh0ZW5zaW9uLnJzdAppbmRleCBiNTQwMTc4YTkz ZjguLjdiOTljOGY0MjhlYiAxMDA2NDQKLS0tIGEvRG9jdW1lbnRhdGlvbi9hcm02NC9tZW1vcnkt dGFnZ2luZy1leHRlbnNpb24ucnN0CisrKyBiL0RvY3VtZW50YXRpb24vYXJtNjQvbWVtb3J5LXRh Z2dpbmctZXh0ZW5zaW9uLnJzdApAQCAtNzcsMTQgKzc3LDIwIEBAIGNvbmZpZ3VyYWJsZSBiZWhh dmlvdXJzOgogICBhZGRyZXNzIGlzIHVua25vd24pLgogCiBUaGUgdXNlciBjYW4gc2VsZWN0IHRo ZSBhYm92ZSBtb2RlcywgcGVyIHRocmVhZCwgdXNpbmcgdGhlCi1gYHByY3RsKFBSX1NFVF9UQUdH RURfQUREUl9DVFJMLCBmbGFncywgMCwgMCwgMClgYCBzeXN0ZW0gY2FsbCB3aGVyZQotYGBmbGFn c2BgIGNvbnRhaW4gb25lIG9mIHRoZSBmb2xsb3dpbmcgdmFsdWVzIGluIHRoZSBgYFBSX01URV9U Q0ZfTUFTS2BgCitgYHByY3RsKFBSX1NFVF9UQUdHRURfQUREUl9DVFJMLCBmbGFncywgMCwgMCwg MClgYCBzeXN0ZW0gY2FsbCB3aGVyZSBgYGZsYWdzYGAKK2NvbnRhaW5zIGFueSBudW1iZXIgb2Yg dGhlIGZvbGxvd2luZyB2YWx1ZXMgaW4gdGhlIGBgUFJfTVRFX1RDRl9NQVNLYGAKIGJpdC1maWVs ZDoKIAotLSBgYFBSX01URV9UQ0ZfTk9ORWBgICAtICpJZ25vcmUqIHRhZyBjaGVjayBmYXVsdHMK Ky0gYGBQUl9NVEVfVENGX05PTkVgYCDCoC0gKklnbm9yZSogdGFnIGNoZWNrIGZhdWx0cworICAg ICAgICAgICAgICAgICAgICAgICAgIChpZ25vcmVkIGlmIGNvbWJpbmVkIHdpdGggb3RoZXIgb3B0 aW9ucykKIC0gYGBQUl9NVEVfVENGX1NZTkNgYCAgLSAqU3luY2hyb25vdXMqIHRhZyBjaGVjayBm YXVsdCBtb2RlCiAtIGBgUFJfTVRFX1RDRl9BU1lOQ2BgIC0gKkFzeW5jaHJvbm91cyogdGFnIGNo ZWNrIGZhdWx0IG1vZGUKIAorSWYgbm8gbW9kZXMgYXJlIHNwZWNpZmllZCwgdGFnIGNoZWNrIGZh dWx0cyBhcmUgaWdub3JlZC4gSWYgYSBzaW5nbGUKK21vZGUgaXMgc3BlY2lmaWVkLCB0aGUgcHJv Z3JhbSB3aWxsIHJ1biBpbiB0aGF0IG1vZGUuIElmIG11bHRpcGxlCittb2RlcyBhcmUgc3BlY2lm aWVkLCB0aGUgbW9kZSBpcyBzZWxlY3RlZCBhcyBkZXNjcmliZWQgaW4gdGhlICJQZXItQ1BVCitw cmVmZXJyZWQgdGFnIGNoZWNraW5nIG1vZGVzIiBzZWN0aW9uIGJlbG93LgorCiBUaGUgY3VycmVu dCB0YWcgY2hlY2sgZmF1bHQgbW9kZSBjYW4gYmUgcmVhZCB1c2luZyB0aGUKIGBgcHJjdGwoUFJf R0VUX1RBR0dFRF9BRERSX0NUUkwsIDAsIDAsIDAsIDApYGAgc3lzdGVtIGNhbGwuCiAKQEAgLTEy MCwxMyArMTI2LDM5IEBAIGluIHRoZSBgYFBSX01URV9UQUdfTUFTS2BgIGJpdC1maWVsZC4KIGlu dGVyZmFjZSBwcm92aWRlcyBhbiBpbmNsdWRlIG1hc2suIEFuIGluY2x1ZGUgbWFzayBvZiBgYDBg YCAoZXhjbHVzaW9uCiBtYXNrIGBgMHhmZmZmYGApIHJlc3VsdHMgaW4gdGhlIENQVSBhbHdheXMg Z2VuZXJhdGluZyB0YWcgYGAwYGAuCiAKK1Blci1DUFUgcHJlZmVycmVkIHRhZyBjaGVja2luZyBt b2RlCistLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLQorCitPbiBzb21lIENQVXMg dGhlIHBlcmZvcm1hbmNlIG9mIE1URSBpbiBzdHJpY3RlciB0YWcgY2hlY2tpbmcgbW9kZXMKK2lz IHNpbWlsYXIgdG8gdGhhdCBvZiBsZXNzIHN0cmljdCB0YWcgY2hlY2tpbmcgbW9kZXMuIFRoaXMg bWFrZXMgaXQKK3dvcnRod2hpbGUgdG8gZW5hYmxlIHN0cmljdGVyIGNoZWNrcyBvbiB0aG9zZSBD UFVzIHdoZW4gYSBsZXNzIHN0cmljdAorY2hlY2tpbmcgbW9kZSBpcyByZXF1ZXN0ZWQsIGluIG9y ZGVyIHRvIGdhaW4gdGhlIGVycm9yIGRldGVjdGlvbgorYmVuZWZpdHMgb2YgdGhlIHN0cmljdGVy IGNoZWNrcyB3aXRob3V0IHRoZSBwZXJmb3JtYW5jZSBkb3duc2lkZXMuIFRvCitzdXBwb3J0IHRo aXMgc2NlbmFyaW8sIGEgcHJpdmlsZWdlZCB1c2VyIG1heSBjb25maWd1cmUgYSBzdHJpY3Rlcgor dGFnIGNoZWNraW5nIG1vZGUgYXMgdGhlIENQVSdzIHByZWZlcnJlZCB0YWcgY2hlY2tpbmcgbW9k ZS4KKworVGhlIHByZWZlcnJlZCB0YWcgY2hlY2tpbmcgbW9kZSBmb3IgZWFjaCBDUFUgaXMgY29u dHJvbGxlZCBieQorYGAvc3lzL2RldmljZXMvc3lzdGVtL2NwdS9jcHU8Tj4vbXRlX3RjZl9wcmVm ZXJyZWRgYCwgdG8gd2hpY2ggYQorcHJpdmlsZWdlZCB1c2VyIG1heSB3cml0ZSB0aGUgdmFsdWUg YGBhc3luY2BgIG9yIGBgc3luY2BgLiAgVGhlIGRlZmF1bHQKK3ByZWZlcnJlZCBtb2RlIGZvciBl YWNoIENQVSBpcyBgYGFzeW5jYGAuCisKK1RvIGFsbG93IGEgcHJvZ3JhbSB0byBwb3RlbnRpYWxs eSBydW4gaW4gdGhlIENQVSdzIHByZWZlcnJlZCB0YWcKK2NoZWNraW5nIG1vZGUsIHRoZSB1c2Vy IHByb2dyYW0gbWF5IHNldCBtdWx0aXBsZSB0YWcgY2hlY2sgZmF1bHQgbW9kZQorYml0cyBpbiB0 aGUgYGBmbGFnc2BgIGFyZ3VtZW50IHRvIHRoZSBgYHByY3RsKFBSX1NFVF9UQUdHRURfQUREUl9D VFJMLAorZmxhZ3MsIDAsIDAsIDApYGAgc3lzdGVtIGNhbGwuIElmIHRoZSBDUFUncyBwcmVmZXJy ZWQgdGFnIGNoZWNraW5nCittb2RlIGlzIGluIHRoZSB0YXNrJ3Mgc2V0IG9mIHByb3ZpZGVkIHRh ZyBjaGVja2luZyBtb2RlcyAodGhpcyB3aWxsCithbHdheXMgYmUgdGhlIGNhc2UgYXQgcHJlc2Vu dCBiZWNhdXNlIHRoZSBrZXJuZWwgb25seSBzdXBwb3J0cyB0d28KK3RhZyBjaGVja2luZyBtb2Rl cywgYnV0IGZ1dHVyZSBrZXJuZWxzIG1heSBzdXBwb3J0IG1vcmUgbW9kZXMpLCB0aGF0Cittb2Rl IHdpbGwgYmUgc2VsZWN0ZWQuIE90aGVyd2lzZSwgb25lIG9mIHRoZSBtb2RlcyBpbiB0aGUgdGFz aydzIG1vZGUKK3NldCB3aWxsIGJlIHNlbGVjdGVkIGluIGEgY3VycmVudGx5IHVuc3BlY2lmaWVk IG1hbm5lci4KKwogSW5pdGlhbCBwcm9jZXNzIHN0YXRlCiAtLS0tLS0tLS0tLS0tLS0tLS0tLS0K IAogT24gYGBleGVjdmUoKWBgLCB0aGUgbmV3IHByb2Nlc3MgaGFzIHRoZSBmb2xsb3dpbmcgY29u ZmlndXJhdGlvbjoKIAogLSBgYFBSX1RBR0dFRF9BRERSX0VOQUJMRWBgIHNldCB0byAwIChkaXNh YmxlZCkKLS0gVGFnIGNoZWNraW5nIG1vZGUgc2V0IHRvIGBgUFJfTVRFX1RDRl9OT05FYGAKKy0g Tm8gdGFnIGNoZWNraW5nIG1vZGVzIGFyZSBzZWxlY3RlZCAodGFnIGNoZWNrIGZhdWx0cyBpZ25v cmVkKQogLSBgYFBSX01URV9UQUdfTUFTS2BgIHNldCB0byAwIChhbGwgdGFncyBleGNsdWRlZCkK IC0gYGBQU1RBVEUuVENPYGAgc2V0IHRvIDAKIC0gYGBQUk9UX01URWBgIG5vdCBzZXQgb24gYW55 IG9mIHRoZSBpbml0aWFsIG1lbW9yeSBtYXBzCkBAIC0yNTEsMTEgKzI4MywxMyBAQCBFeGFtcGxl IG9mIGNvcnJlY3QgdXNhZ2UKICAgICAgICAgICAgICAgICAgICAgcmV0dXJuIEVYSVRfRkFJTFVS RTsKIAogICAgICAgICAgICAgLyoKLSAgICAgICAgICAgICAqIEVuYWJsZSB0aGUgdGFnZ2VkIGFk ZHJlc3MgQUJJLCBzeW5jaHJvbm91cyBNVEUgdGFnIGNoZWNrIGZhdWx0cyBhbmQKLSAgICAgICAg ICAgICAqIGFsbG93IGFsbCBub24temVybyB0YWdzIGluIHRoZSByYW5kb21seSBnZW5lcmF0ZWQg c2V0LgorICAgICAgICAgICAgICogRW5hYmxlIHRoZSB0YWdnZWQgYWRkcmVzcyBBQkksIHN5bmNo cm9ub3VzIG9yIGFzeW5jaHJvbm91cyBNVEUKKyAgICAgICAgICAgICAqIHRhZyBjaGVjayBmYXVs dHMgKGJhc2VkIG9uIHBlci1DUFUgcHJlZmVyZW5jZSkgYW5kIGFsbG93IGFsbAorICAgICAgICAg ICAgICogbm9uLXplcm8gdGFncyBpbiB0aGUgcmFuZG9tbHkgZ2VuZXJhdGVkIHNldC4KICAgICAg ICAgICAgICAqLwogICAgICAgICAgICAgaWYgKHByY3RsKFBSX1NFVF9UQUdHRURfQUREUl9DVFJM LAotICAgICAgICAgICAgICAgICAgICAgIFBSX1RBR0dFRF9BRERSX0VOQUJMRSB8IFBSX01URV9U Q0ZfU1lOQyB8ICgweGZmZmUgPDwgUFJfTVRFX1RBR19TSElGVCksCisgICAgICAgICAgICAgICAg ICAgICAgUFJfVEFHR0VEX0FERFJfRU5BQkxFIHwgUFJfTVRFX1RDRl9TWU5DIHwgUFJfTVRFX1RD Rl9BU1lOQyB8CisgICAgICAgICAgICAgICAgICAgICAgKDB4ZmZmZSA8PCBQUl9NVEVfVEFHX1NI SUZUKSwKICAgICAgICAgICAgICAgICAgICAgICAwLCAwLCAwKSkgewogICAgICAgICAgICAgICAg ICAgICBwZXJyb3IoInByY3RsKCkgZmFpbGVkIik7CiAgICAgICAgICAgICAgICAgICAgIHJldHVy biBFWElUX0ZBSUxVUkU7Ci0tIAoyLjMyLjAuOTMuZzY3MGI4MWE4OTAtZ29vZwoKCl9fX19fX19f X19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fCmxpbnV4LWFybS1rZXJuZWwg bWFpbGluZyBsaXN0CmxpbnV4LWFybS1rZXJuZWxAbGlzdHMuaW5mcmFkZWFkLm9yZwpodHRwOi8v bGlzdHMuaW5mcmFkZWFkLm9yZy9tYWlsbWFuL2xpc3RpbmZvL2xpbnV4LWFybS1rZXJuZWwK