Received: from list by lists.gnu.org with archive (Exim 4.90_1) id 1kpKz8-0001ks-RV for mharc-grub-devel@gnu.org; Tue, 15 Dec 2020 19:48:07 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:39666) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1kpKz5-0001j7-Sl for grub-devel@gnu.org; Tue, 15 Dec 2020 19:48:03 -0500 Received: from mail-lf1-x141.google.com ([2a00:1450:4864:20::141]:35154) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1kpKz3-0000sj-7s for grub-devel@gnu.org; Tue, 15 Dec 2020 19:48:03 -0500 Received: by mail-lf1-x141.google.com with SMTP id a9so44125093lfh.2 for ; Tue, 15 Dec 2020 16:48:00 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=efficientek-com.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=2kEQ8n4oeESrfdT6rVe0cKhcFWDsxxodG2GNaJ8UBJ8=; b=vcw6GY0A7Ft+JUXZLqw6RMVBJ4cTZusfNJp+yPrS/3GViIAdz0/xVotcpZQ9Q0BOq2 Rfh9oIl3+B/ixym3PEH2w3Xzqv/vi0OO9eY2G48B3U4dNMukw1YkLeyx2cazvt5rNRYj U2DNmWwUwy6Tne+/nuJN6aVpb7ShmXQzmoCG2EIwWgtJ7ePS+Ce0Hbd62PLfUODBU81w FcdJO9bUMV24RVM/1CMaXqpzfJmoTRtruRTR5LZJzoueR+o3WZ5CT+zoiW0latEMRna6 Kj5nUnZfsHmwIsO1MKieH4lpdeMPjB2gPekuX04KJz0lgFIfNtmg+tnRIrDvILw1/M8G lOPA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; bh=2kEQ8n4oeESrfdT6rVe0cKhcFWDsxxodG2GNaJ8UBJ8=; b=HWGVih3dKu6xi6a7rNrMNVW7h/6izZ0/yU1eGUh3VoSEff/w8pOpgAlJfTu/WnaR5C fM089pehsOMzUocBg+a38OdPngLb2JO43YqlG2dh1ZPAfnPAGlFik5oS7IP6iRmzGJSZ eFs2IM8joeKHc2YOkPe0HgtfeLVSKFJVz55VDLk85NhVYYl8FobZfext4ckd2PA+eIRO BhbZ+tfGmk3qpfsESr36gGJpUqaBh+yPewSTTCxmT2mprbi1O7e17oBaJUb4DT6wV1A+ c/OYQlTkdJKaL4FuyQipKyJgHkdBkDKvDra20orbBiaEOvX9oTKBvSaBTNHbOBY7IP6E c+Mg== X-Gm-Message-State: AOAM531dtTpiFPdThLY/1aAi2ZHmLOu3m6z1ueDvraBHvwTadw32ph7W pcXyVXiNHvE+yJDhMcutD1nxjGjOSivndQ== X-Google-Smtp-Source: ABdhPJzYSeqqWaGdNFcyn+MNIsc8bRVDotFE7Dm/u2hhmr6kLz3GGg9NrODy5ZtzSSUTwFFVav6bMw== X-Received: by 2002:a19:10:: with SMTP id 16mr11653415lfa.334.1608079679022; Tue, 15 Dec 2020 16:47:59 -0800 (PST) Received: from localhost.localdomain ([136.49.211.192]) by smtp.gmail.com with ESMTPSA id 186sm65006ljf.21.2020.12.15.16.47.56 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 15 Dec 2020 16:47:58 -0800 (PST) From: Glenn Washburn To: grub-devel@gnu.org Cc: Daniel Kiper , Glenn Washburn Subject: [PATCH] docs: Add documentation of disk size limitations Date: Tue, 15 Dec 2020 18:47:34 -0600 Message-Id: <20201216004734.1043123-1-development@efficientek.com> X-Mailer: git-send-email 2.27.0 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2a00:1450:4864:20::141; envelope-from=development@efficientek.com; helo=mail-lf1-x141.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-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.23 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 16 Dec 2020 00:48:04 -0000 Document the artificially imposed 1 EiB disk size limit and size limitations with LUKS volumes. Fix a few punctuation issues. Signed-off-by: Glenn Washburn --- docs/grub.texi | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/docs/grub.texi b/docs/grub.texi index fa4945ab8..eeac9b2ce 100644 --- a/docs/grub.texi +++ b/docs/grub.texi @@ -5964,6 +5964,15 @@ GRUB2 is designed to be portable and is actually ported across platforms. We try to keep all platforms at the level. Unfortunately some platforms are better supported than others. This is detailed in current and 2 following sections. +All platforms have an artificially GRUB imposed disk size restriction of 1 EiB. +In some cases, larger disk sizes can be used, but access will not be allowed +beyond 1 EiB. + +LUKS2 devices with size larger than 16 EiB are currently not supported. They +can not be created as crypto devices by cryptomount, so can not even be +partially read from. LUKS have no limitations other than those imposed by the +format. + ARC platform is unable to change datetime (firmware doesn't seem to provide a function for it). EMU has similar limitation. @@ -5982,8 +5991,8 @@ by national encoding compatible only in pseudographics. Unicode is the most versatile charset which supports many languages. However the actual console may be much more limited depending on firmware -On BIOS network is supported only if the image is loaded through network. -On sparc64 GRUB is unable to determine which server it was booted from. +On BIOS, network is supported only if the image is loaded through network. +On sparc64, GRUB is unable to determine which server it was booted from. Direct ATA/AHCI support allows to circumvent various firmware limitations but isn't needed for normal operation except on baremetal ports. @@ -6012,7 +6021,7 @@ Bootlocation is ability of GRUB to automatically detect where it boots from. ``disk'' means the detection is limited to detecting the disk with partition being discovered on install time. ``partition'' means that disk and partiton can be automatically discovered. ``file'' means that boot image file name as -well as disk and partition can be discovered. For consistency default install ignores +well as disk and partition can be discovered. For consistency, default install ignores partition and relies solely on disk detection. If no bootlocation discovery is available or boot and grub-root disks are different, UUID is used instead. On ARC if no device to install to is specified, UUID is used instead as well. -- 2.27.0