From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.90_1) id 1p5vRh-0003Yx-B8 for mharc-grub-devel@gnu.org; Thu, 15 Dec 2022 16:07:13 -0500 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 1p5vRf-0003Yn-Cl for grub-devel@gnu.org; Thu, 15 Dec 2022 16:07:11 -0500 Received: from mail-qt1-x831.google.com ([2607:f8b0:4864:20::831]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1p5vRc-0001x5-S2 for grub-devel@gnu.org; Thu, 15 Dec 2022 16:07:11 -0500 Received: by mail-qt1-x831.google.com with SMTP id h16so899496qtu.2 for ; Thu, 15 Dec 2022 13:07:08 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=efficientek-com.20210112.gappssmtp.com; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=WtW8z1UdRjRcmXLjxJ/ITeF4U+Hb8/jW6WXcWAUgTbw=; b=4WnUPYPApVz9vHHoaRuqgxY8/dvBSaiaDvBW4GUqnRqqey8xKo9VsUGd0xXVQYGUwZ Fso9g6LJFbgkwsYhm9d56Q1pJ3WiTD8DWGl8TQrcl4YRcJoD2s0Z7O2mqqo6eDnD2/0U 43/THaz1m/KQCM2cXGAnCT5ThtnN3DjXbaBcXPJgyqOiBtR42YjMtIZz6E/8rusuvQYU JnQ0bTDg9CmT3oHrNPSHpC0ImZLN9uUB6KD3o9+87fVbBXnkot4kiWy2jLFKvV22JnDs t8Ck7Uooffa52TQvpW63w3qShJn6EZ1gAkZa5HFjyRVuYdNGQ4zJRlzaI5eiaq9xDpzD Uwdw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=WtW8z1UdRjRcmXLjxJ/ITeF4U+Hb8/jW6WXcWAUgTbw=; b=u+OkzzWVwZO/swgrJmZfm2GV+IQaOa+r8cElajskPFML+9o/cekfSw+KTrg2xQCdGp TRsbRunraEcOoEyd0kzxbUFkG0TZbX6/zZd92tBGyt6vyU63vWZ79iZjyZh+KPVlNCxo DQc9+byFyMoaU9MKHOD95NumFw1UuhMYXZKT6F+aeN84744aHlYWNtZqMKOfiMfbTVrk 3sFE9WFBdl0C1PprmIL9IAOSyXOFZS5sK15tLGloLFyhUbyvDuETPPhweO9xk/dRb4pS fa2WB9fkeZgfoLclJ5H25IrEImcNIEtWKAr/9MnkV+FkAVIRNJBqzmcnl5T4HiBENfiQ brLQ== X-Gm-Message-State: ANoB5plpiOZ1za2FFGznHp379Ndo0H/NinDNUPruplR1kMh3QV5tgJVX BSgJ7XCoSvWjZZDe5757KUbnsIQ3PZQ++C0M X-Google-Smtp-Source: AA0mqf6BU0GrL7bVVhZDFDgrSqlGmyRpecym7EoRZqgGvnwui/u6bwXHbfXiqWGkd/BY+++yTgN/xw== X-Received: by 2002:ac8:118e:0:b0:3a5:af69:408a with SMTP id d14-20020ac8118e000000b003a5af69408amr33343375qtj.67.1671138427160; Thu, 15 Dec 2022 13:07:07 -0800 (PST) Received: from crass-HP-ZBook-15-G2.lan ([37.218.244.251]) by smtp.gmail.com with ESMTPSA id h4-20020a05620a284400b006fef61300fesm18953qkp.16.2022.12.15.13.07.05 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 15 Dec 2022 13:07:06 -0800 (PST) From: Glenn Washburn To: "grub-devel @ gnu . org" , Daniel Kiper Cc: Glenn Washburn Subject: [PATCH] docs: Document extra arguments to chainloader on EFI Date: Thu, 15 Dec 2022 15:06:53 -0600 Message-Id: <20221215210653.207151-1-development@efficientek.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2607:f8b0:4864:20::831; envelope-from=development@efficientek.com; helo=mail-qt1-x831.google.com X-Spam_score_int: 14 X-Spam_score: 1.4 X-Spam_bar: + X-Spam_report: (1.4 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, RCVD_IN_SBL_CSS=3.335, SPF_HELO_NONE=0.001, SPF_PASS=-0.001 autolearn=no 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: , X-List-Received-Date: Thu, 15 Dec 2022 21:07:11 -0000 Extra arguments given to chainloader on EFI platforms will be sent to the chainloaded application. Also, minor edit in the chainloading section to note that chainloading can be a jump via the firmware and not necessarily in real mode (which does not exist on some achitectures). Signed-off-by: Glenn Washburn --- docs/grub.texi | 7 +++++-- 1 file changed, 5 insertions(+), 2 deletions(-) diff --git a/docs/grub.texi b/docs/grub.texi index 1752fcb7db..536a0e7e37 100644 --- a/docs/grub.texi +++ b/docs/grub.texi @@ -979,7 +979,7 @@ invoke shutdown machinery. Operating systems that do not support Multiboot and do not have specific support in GRUB (specific support is available for Linux, FreeBSD, NetBSD and OpenBSD) must be chain-loaded, which involves loading another boot -loader and jumping to it in real mode. +loader and jumping to it in real mode or via the firmware. The @command{chainloader} command (@pxref{chainloader}) is used to set this up. It is normally also necessary to load some GRUB modules and set the @@ -4050,10 +4050,13 @@ a list of commands that could use more documentation: @node chainloader @subsection chainloader -@deffn Command chainloader [@option{--force}] file +@deffn Command chainloader [@option{--force}] file [args...] Load @var{file} as a chain-loader. Like any other file loaded by the filesystem code, it can use the blocklist notation (@pxref{Block list syntax}) to grab the first sector of the current partition with @samp{+1}. +On EFI platforms, any arguments after @var{file} will be sent to the loaded +image. + If you specify the option @option{--force}, then load @var{file} forcibly, whether it has a correct signature or not. This is required when you want to load a defective boot loader, such as SCO UnixWare 7.1. -- 2.34.1