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 Received: from lists.gnu.org (lists.gnu.org [209.51.188.17]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id B99A2CAC597 for ; Mon, 15 Sep 2025 09:10:45 +0000 (UTC) Received: from localhost ([::1] helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1uy5DX-0003vV-48; Mon, 15 Sep 2025 05:09:47 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1uy5DM-0003tN-Ud for grub-devel@gnu.org; Mon, 15 Sep 2025 05:09:38 -0400 Received: from mail-wr1-x436.google.com ([2a00:1450:4864:20::436]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1uy5D6-0005PR-Un for grub-devel@gnu.org; Mon, 15 Sep 2025 05:09:35 -0400 Received: by mail-wr1-x436.google.com with SMTP id ffacd0b85a97d-3eb3f05c35bso291247f8f.1 for ; Mon, 15 Sep 2025 02:09:18 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=google; t=1757927357; x=1758532157; darn=gnu.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=IPtk5cIZaeWcU7Uf3BBztuWQEJMWb8lJNfi3Alz5pA4=; b=Cp+QWiTrFIjC8vYkhy/UEhWHuFIAzbJ61XqbzKWzdKkMGhv2ZhPxgcmm9z5+2iew5P BwBibgFM89hpz2hHFk+X/YJpP35fZgxci0EM/rVYnvh0qs598NZVAhTZQPzLphvr3P2N CW9TA/TssKsIhoR6QNM5DByEvY+Jgn7fEbjCi+dHQc2L496eZqrM3kN6/uJHYdi2DQdn Sw4XORT2c8tvED9wynyLmj1CjNBk45huFhtuqFJXs+GgcF9mZXX3xjsbMp89CkfwOem+ IrbMdwANJh6Civt19zxfQb7cH/m+Ka2pUq6qKPh5mY0KFxj91xHQ0awzok+gSLkQYgHb bdwQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757927357; x=1758532157; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=IPtk5cIZaeWcU7Uf3BBztuWQEJMWb8lJNfi3Alz5pA4=; b=wArxkb9NkuehXkLaUVJTHj8w9AdfoG0ISHwtFuFSUe8Ne7wHwASUCoRVsiM7QAGDf+ Bto/ydIG9w6bVgGp6JD7Fof7C0nJ7mLRAkRwbVUIr815zTuSw7k76kv/xlIdYFk3/30r scUkPAdeP34FAhnopS4C5iJIpXQym/x/UXulyA6RhAVoMMy3onR84tQEthxIuoULzX+9 IxqxRrySJm2AP77zc3jJP/9cAVqOgFyV6HMYD02QkCNIfvq5EHymPtQSwdGQqjbWT9aQ 4pfxDrQTHMVaNsaEBZZT9uKz8WTtcpvC6HxD4sDjzbNJuxc5eCkQxAT5AtOZtHw1KoWU 6YAg== X-Gm-Message-State: AOJu0YxA/sDaVuEPzbNIxIwxK83DRXyJ2K85TwNX7d5D6oFnJiXwSdMp v/RSRKU+K/LOPhYCOD/gz1AhTRO6Tk49u7n3OHUeCGs9PzCwf1PfFrHxTHNzjhP59vyK6YVdMXW zPpjw X-Gm-Gg: ASbGncvhHFTk9q81jeoqnPV5mly4mQi8n48ba+4RrqQo+AqAioJNIzFooIUhbg++R63 y2b66D0mMp/VR0m4bx+5AvpTe+hTjkbtkTziBzB4tdPbLFoSV2Ug5ckgD2QkuvGr5sy7jugiQor QvvY76YuvqmIiQ16FuoVcLVwwpnm9X0jZaexd+EVoD/Y64wy73iGt2EE5YWKk33A3T2kqu0wQtA m3oLhixJpkT8OxSqm3Y9tbILqLQQq3araeI0ae9+MhGkC3IKKbHcdYdP7SXvEOb57OgrtupQ0OJ ApQq8hZMZHY/f43D6FPH50yXBpu8uOH6RByxknAhKbYpTia/U/DsTMr3gLSlIMTQpy1RM8qim0F QSOAYvI2oR3RFrW9ULRkay+CFtYXteLGqQhHEkUOQlSFiFXYehFNZjsZS8LMxsQqn+MiYcCWhrm ZGnqjwCViCuSaRyA4= X-Google-Smtp-Source: AGHT+IFQPglrjKJk9YvC/mOxwNhPSdu/CIpeHvL018S7PtA27Ubsbnb9K8LlEcZkC/dlbYZ5HpgWkQ== X-Received: by 2002:a5d:64c4:0:b0:3ea:a8a:5473 with SMTP id ffacd0b85a97d-3ea0a8a636bmr3432665f8f.34.1757927356494; Mon, 15 Sep 2025 02:09:16 -0700 (PDT) Received: from localhost (2001-b011-300c-1db4-7e57-58ff-fec7-948b.dynamic-ip6.hinet.net. [2001:b011:300c:1db4:7e57:58ff:fec7:948b]) by smtp.gmail.com with UTF8SMTPSA id d9443c01a7336-25fc92ebb21sm72468615ad.69.2025.09.15.02.09.15 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 15 Sep 2025 02:09:16 -0700 (PDT) To: The development of GNU GRUB Subject: [PATCH v2 9/9] docs: add Btrfs env block and special env vars Date: Mon, 15 Sep 2025 17:08:48 +0800 Message-ID: <20250915090848.131937-10-mchang@suse.com> X-Mailer: git-send-email 2.51.0 In-Reply-To: <20250915090848.131937-1-mchang@suse.com> References: <20250915090848.131937-1-mchang@suse.com> MIME-Version: 1.0 Received-SPF: pass client-ip=2a00:1450:4864:20::436; envelope-from=mchang@suse.com; helo=mail-wr1-x436.google.com X-Spam_score_int: -20 X-Spam_score: -2.1 X-Spam_bar: -- X-Spam_report: (-2.1 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, DKIM_VALID_AU=-0.1, DKIM_VALID_EF=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , From: Michael Chang via Grub-devel Reply-To: The development of GNU GRUB Cc: Michael Chang , Neal Gompa , Marta Lewandowska Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: base64 Errors-To: grub-devel-bounces+grub-devel=archiver.kernel.org@gnu.org Sender: grub-devel-bounces+grub-devel=archiver.kernel.org@gnu.org VXBkYXRlIGdydWIudGV4aSB0byBkZXNjcmliZSB0aGUgZXh0ZXJuYWwgZW52aXJvbm1lbnQgYmxv Y2sgaW4gdGhlCnJlc2VydmVkIGFyZWEgb2YgQnRyZnMgaGVhZGVyIHVzZWQgZm9yIGdydWItcmVi b290IGFuZCBzYXZlZGVmYXVsdCwgYW5kCmFkZCBhIHNlY3Rpb24gZG9jdW1lbnRpbmcgdGhlIHNh dmVkX2VudHJ5LCBuZXh0X2VudHJ5LCBhbmQgZW52X2Jsb2NrCnZhcmlhYmxlcy4KClNpZ25lZC1v ZmYtYnk6IE1pY2hhZWwgQ2hhbmcgPG1jaGFuZ0BzdXNlLmNvbT4KLS0tCiBkb2NzL2dydWIudGV4 aSB8IDYwICsrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysrKysr CiAxIGZpbGUgY2hhbmdlZCwgNjAgaW5zZXJ0aW9ucygrKQoKZGlmZiAtLWdpdCBhL2RvY3MvZ3J1 Yi50ZXhpIGIvZG9jcy9ncnViLnRleGkKaW5kZXggMzRiMzQ4NGRjLi42ZmZiM2EzNzAgMTAwNjQ0 Ci0tLSBhL2RvY3MvZ3J1Yi50ZXhpCisrKyBiL2RvY3MvZ3J1Yi50ZXhpCkBAIC0zMjcxLDYgKzMy NzEsNyBAQCBHUlVCLiAgT3RoZXJzIG1heSBiZSB1c2VkIGZyZWVseSBpbiBHUlVCIGNvbmZpZ3Vy YXRpb24gZmlsZXMuCiBAbWVudQogKiBTcGVjaWFsIGVudmlyb25tZW50IHZhcmlhYmxlczo6CiAq IEVudmlyb25tZW50IGJsb2NrOjoKKyogU3BlY2lhbCBlbnZpcm9ubWVudCBibG9jayB2YXJpYWJs ZXM6OgogQGVuZCBtZW51CiAKIApAQCAtMzg2OCw5ICszODY5LDY4IEBAIEZvciBzYWZldHkgcmVh c29ucywgdGhpcyBzdG9yYWdlIGlzIG9ubHkgYXZhaWxhYmxlIHdoZW4gaW5zdGFsbGVkIG9uIGEg cGxhaW4KIGRpc2sgKG5vIExWTSBvciBSQUlEKSwgdXNpbmcgYSBub24tY2hlY2tzdW1taW5nIGZp bGVzeXN0ZW0gKG5vIFpGUyksIGFuZAogdXNpbmcgQklPUyBvciBFRkkgZnVuY3Rpb25zIChubyBB VEEsIFVTQiBvciBJRUVFMTI3NSkuCiAKK09uIEJ0cmZzIGZpbGVzeXN0ZW1zLCBhIHJlc2VydmVk IGFyZWEgaW4gdGhlIGZpbGVzeXN0ZW0gaGVhZGVyIG1heSBiZSB1c2VkIHRvCitzdG9yZSB0aGUg ZW52aXJvbm1lbnQgYmxvY2suIFRoaXMgc3RhdGljIGJsb2NrIGF2b2lkcyB0aGUgcHJvYmxlbXMg b2YgdXBkYXRpbmcKK2Egbm9ybWFsIGZpbGUgb24gYSBjb3B5LW9uLXdyaXRlIGZpbGVzeXN0ZW0s IHdoZXJlIHdyaXRpbmcgcmF3IGJsb2NrIGlzIG5vdAorc3RhYmxlIGFuZCByZXF1aXJlcyBtZXRh ZGF0YSB1cGRhdGUuIFRoZSByZXNlcnZlZCBhcmVhIHByb3ZpZGVzIGEgZml4ZWQKK2xvY2F0aW9u IHRoYXQgR1JVQiBjYW4gdXBkYXRlIGRpcmVjdGx5LCBhbGxvd2luZyBjb21tYW5kcyBzdWNoIGFz CitAY29tbWFuZHtncnViLXJlYm9vdH0gYW5kIEBzYW1we0dSVUJfU0FWRURFRkFVTFR9IHRvIGZ1 bmN0aW9uIGNvcnJlY3RseSBvbgorQnRyZnMgdm9sdW1lcy4KKwogQGNvbW1hbmR7Z3J1Yi1ta2Nv bmZpZ30gdXNlcyB0aGlzIGZhY2lsaXR5IHRvIGltcGxlbWVudAogQHNhbXB7R1JVQl9TQVZFREVG QVVMVH0gKEBweHJlZntTaW1wbGUgY29uZmlndXJhdGlvbn0pLgogCisKK0Bub2RlIFNwZWNpYWwg ZW52aXJvbm1lbnQgYmxvY2sgdmFyaWFibGVzCitAc2VjdGlvbiBTcGVjaWFsIGVudmlyb25tZW50 IGJsb2NrIHZhcmlhYmxlcworCitUaGVzZSBzcGVjaWFsIHZhcmlhYmxlcyBhcmUgdXN1YWxseSB3 cml0dGVuIHRvIHRoZSBlbnZpcm9ubWVudCBibG9jaworKEBweHJlZntFbnZpcm9ubWVudCBibG9j a30pIHRvIGN1c3RvbWl6ZSB0aGUgYmVoYXZpb3Igb2YgQGZpbGV7Z3J1Yi5jZmd9CitnZW5lcmF0 ZWQgYnkgQGNvbW1hbmR7Z3J1Yi1ta2NvbmZpZ30uCisKK0BtZW51CisqIHNhdmVkX2VudHJ5OjoK KyogbmV4dF9lbnRyeTo6CisqIGVudl9ibG9jazo6CitAZW5kIG1lbnUKKworCitAbm9kZSBzYXZl ZF9lbnRyeQorQHN1YnNlY3Rpb24gc2F2ZWRfZW50cnkKKworVGhlIEB2YXJ7c2F2ZWRfZW50cnl9 IHZhcmlhYmxlIHNldHMgdGhlIGRlZmF1bHQgYm9vdCBlbnRyeSBpbiBAZmlsZXtncnViLmNmZ30K K2NyZWF0ZWQgYnkgQGNvbW1hbmR7Z3J1Yi1ta2NvbmZpZ30uIEl0IGNhbiBiZSBzZXQgd2l0aAor QGNvbW1hbmR7Z3J1Yi1zZXQtZGVmYXVsdH0gdG8gY2hvb3NlIGEgZGVmYXVsdCBlbnRyeSwgb3Ig YXQgcnVudGltZSB3aXRoIHRoZQorQGNvZGV7c2F2ZWRlZmF1bHR9IGZ1bmN0aW9uIGluIGdydWIu Y2ZnIHRvIHNhdmUgdGhlIGN1cnJlbnQgZW50cnkgYXMgdGhlIG5ldworZGVmYXVsdC4gVGhpcyBt YXkgcmVxdWlyZSB3cml0ZSBhY2Nlc3MgYnkgR1JVQi4KKworCitAbm9kZSBuZXh0X2VudHJ5CitA c3Vic2VjdGlvbiBuZXh0X2VudHJ5CisKK1RoZSBAdmFye25leHRfZW50cnl9IHZhcmlhYmxlIHNl dHMgdGhlIGJvb3QgZW50cnkgZm9yIHRoZSBuZXh0IGJvb3Qgb25seS4gQWZ0ZXIKK2l0IGlzIHVz ZWQsIEdSVUIgY2xlYXJzIHRoZSB2YWx1ZSBzbyBpdCBpcyBub3QgcmV1c2VkLiBUaGlzIHJlcXVp cmVzIHdyaXRlCithY2Nlc3MgdG8gdGhlIGVudmlyb25tZW50IGJsb2NrIChAcHhyZWZ7RW52aXJv bm1lbnQgYmxvY2t9KSBhdCBydW50aW1lLiBUaGUKK0Bjb21tYW5ke2dydWItcmVib290fSBjb21t YW5kIGlzIHVzdWFsbHkgdXNlZCBpbnN0ZWFkIG9mIGNoYW5naW5nIHRoaXMgdmFyaWFibGUKK2Rp cmVjdGx5LgorCisKK0Bub2RlIGVudl9ibG9jaworQHN1YnNlY3Rpb24gZW52X2Jsb2NrCisKK0lm IHRoZSBmaWxlc3lzdGVtIGlzIEJ0cmZzIGFuZCB0aGUgZGlzayBpcyBub3QgYW4gYWJzdHJhY3Rl ZCBkZXZpY2Ugc3VjaCBhcworTFZNLCBSQUlELCBvciBlbmNyeXB0aW9uLCB0aGUgcmVzZXJ2ZWQg c3BhY2UgaW4gdGhlIEJ0cmZzIGhlYWRlciBjYW4gYmUgdXNlZCBhcwordGhlIGVudmlyb25tZW50 IGJsb2NrIChAcHhyZWZ7RW52aXJvbm1lbnQgYmxvY2t9KS4gVGhpcyBwcm92aWRlcyBhIGZpeGVk IHJhdworYmxvY2sgdGhhdCBHUlVCIGNhbiByZWxpYWJseSB3cml0ZSB0by4gVGhlIEB2YXJ7ZW52 X2Jsb2NrfSByZWNvcmRzIHRoaXMKK2xvY2F0aW9uIGluIEdSVUIgYmxvY2tsaXN0IHN5bnRheCAo QHB4cmVme0Jsb2NrIGxpc3Qgc3ludGF4fSkgc28gdGhhdAorQGNvbW1hbmR7Z3J1Yi1lZGl0ZW52 fSBhbmQgQGZpbGV7Z3J1Yi5jZmd9IGtub3cgaG93IHRvIGFjY2VzcyBhbmQgdXNlIHRoZQorZXh0 ZXJuYWwgcmF3IGJsb2NrLgorCitUaGlzIHZhcmlhYmxlIGlzIGluaXRpYWxpemVkIHdoZW4gQGZp bGV7Z3J1YmVudn0gaXMgZmlyc3QgY3JlYXRlZCBieQorQGNvbW1hbmR7Z3J1Yi1lZGl0ZW52fSBh bmQgaXMgdHJlYXRlZCBhcyByZWFkLW9ubHkgdG8gYXZvaWQgYmVpbmcgb3ZlcndyaXR0ZW4KK3dp dGggYW4gdW5wcmVkaWN0YWJsZSB2YWx1ZS4KKworCiBAbm9kZSBNb2R1bGVzCiBAY2hhcHRlciBN b2R1bGVzCiAKLS0gCjIuNTEuMAoKCl9fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19f X19fX19fX19fX19fCkdydWItZGV2ZWwgbWFpbGluZyBsaXN0CkdydWItZGV2ZWxAZ251Lm9yZwpo dHRwczovL2xpc3RzLmdudS5vcmcvbWFpbG1hbi9saXN0aW5mby9ncnViLWRldmVsCg==