From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.90_1) id 1j9nvw-0007Kh-Qb for mharc-grub-devel@gnu.org; Thu, 05 Mar 2020 05:40:52 -0500 Received: from eggs.gnu.org ([2001:470:142:3::10]:48451) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1j9nvu-0007KU-Dr for grub-devel@gnu.org; Thu, 05 Mar 2020 05:40:51 -0500 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1j9nvr-0004f7-Lr for grub-devel@gnu.org; Thu, 05 Mar 2020 05:40:48 -0500 Received: from m9a0014g.houston.softwaregrp.com ([15.124.64.90]:34822) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1j9nvr-0004dR-F5 for grub-devel@gnu.org; Thu, 05 Mar 2020 05:40:47 -0500 Received: FROM m9a0014g.houston.softwaregrp.com (15.121.0.191) BY m9a0014g.houston.softwaregrp.com WITH ESMTP FOR grub-devel@gnu.org; Thu, 5 Mar 2020 10:40:00 +0000 Received: from M4W0334.microfocus.com (2002:f78:1192::f78:1192) by M9W0068.microfocus.com (2002:f79:bf::f79:bf) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1591.10; Thu, 5 Mar 2020 10:40:15 +0000 Received: from NAM10-MW2-obe.outbound.protection.outlook.com (15.124.8.10) by M4W0334.microfocus.com (15.120.17.146) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256_P256) id 15.1.1591.10 via Frontend Transport; Thu, 5 Mar 2020 10:40:15 +0000 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=jvjfjaQeOAtmrUsTeU8o5XLfOPgIt4f++CO57XmVXA2LQL9QFvUV+VCjOuf4Eu61JRfvPvotVHaFGa2iszYf1SvDKx7EkWiPggT0636A+Xh0qt+i09LK8DOopzcA0D8PiHXW5D4pveHnVRSyrVl41tYOKxris5AViajU7tGPkkzyC3cJHsy3GaF0ejc2OVdBT6ulFlE7M7g6RPsnPmaIX6zBlR5Mq2l7IHRNp10fJTH6/PPlVp0UwNOqJ1zYvcOBBlSbgvCjc/DkY6lgQ3zoV6BV268BadFqwMWH0ttTScDx9emi174s2VXW9VB9Vn9VFZAHagS58rB9dp07W99lUA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=PaGpeCUmmeZB2WxLKWIzk1q/H74uZj0KSrEgNvAB4Dk=; b=Q8ABC1Bfwpl9Zf5l8mpOpaqlckcv8pQBSWMTC27b0nXB49DkWaA51j2Z1XblJwfLaEVvXcGLiWrESlCcAY+kNFmeXOW0KTAdiBb5R/Ebf9zLQ42m/WYL2uyEAoBWCVzkWFGgZ0qb+yqf6i8lfhN2Xbpkbu1mznUXFEYM1NMGErC206diG+jc/2rGVyb2X0SRsEnkQ7HSiX3m07iBnnSpUXz+9xBDjzV9DHZNagk/CQTLl2o4K72zOm7qFC9tby4NXOEU62LF62yJW9/kzsO27uGVsLIUDLNv8n7DP/3X/+qhRUPo074yBVWBDLhLnjmqbPmEvme2FUNOiPV+62wqDw== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=suse.com; dmarc=pass action=none header.from=suse.com; dkim=pass header.d=suse.com; arc=none Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=MChang@suse.com; Received: from BY5PR18MB3188.namprd18.prod.outlook.com (2603:10b6:a03:1ac::18) by BY5PR18MB3299.namprd18.prod.outlook.com (2603:10b6:a03:1ac::32) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2772.14; Thu, 5 Mar 2020 10:40:13 +0000 Received: from BY5PR18MB3188.namprd18.prod.outlook.com ([fe80::28ac:20e6:d692:e83]) by BY5PR18MB3188.namprd18.prod.outlook.com ([fe80::28ac:20e6:d692:e83%5]) with mapi id 15.20.2772.019; Thu, 5 Mar 2020 10:40:13 +0000 Date: Thu, 5 Mar 2020 18:40:01 +0800 From: Michael Chang To: Subject: [PATCH] docs: Update for stopping small mbr gap support Message-ID: <20200305104001.GA32361@mercury> Content-Type: text/plain; charset="us-ascii" Content-Disposition: inline User-Agent: Mutt/1.10.1 (2018-07-13) X-ClientProxiedBy: CWLP123CA0013.GBRP123.PROD.OUTLOOK.COM (2603:10a6:401:56::25) To BY5PR18MB3188.namprd18.prod.outlook.com (2603:10b6:a03:1ac::18) MIME-Version: 1.0 X-MS-Exchange-MessageSentRepresentingType: 1 Received: from mercury (36.229.12.84) by CWLP123CA0013.GBRP123.PROD.OUTLOOK.COM (2603:10a6:401:56::25) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.2772.18 via Frontend Transport; Thu, 5 Mar 2020 10:40:11 +0000 X-Originating-IP: [36.229.12.84] X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 1132365c-5cd0-4628-3c9c-08d7c0f195c1 X-MS-TrafficTypeDiagnostic: BY5PR18MB3299: X-Microsoft-Antispam-PRVS: X-MS-Oob-TLC-OOBClassifiers: OLM:9508; X-Forefront-PRVS: 03333C607F X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(4636009)(396003)(376002)(366004)(39860400002)(346002)(136003)(199004)(189003)(6496006)(186003)(33656002)(52116002)(5660300002)(2906002)(6916009)(26005)(8676002)(66946007)(66476007)(6666004)(66556008)(16526019)(478600001)(316002)(9576002)(81166006)(8936002)(81156014)(966005)(9686003)(55016002)(1076003)(86362001)(956004)(33716001); DIR:OUT; SFP:1102; SCL:1; SRVR:BY5PR18MB3299; H:BY5PR18MB3188.namprd18.prod.outlook.com; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1; Received-SPF: None (protection.outlook.com: suse.com does not designate permitted sender hosts) X-MS-Exchange-SenderADCheck: 1 X-Microsoft-Antispam: BCL:0; X-Microsoft-Antispam-Message-Info: VLHgli4iGto6hEMzeDDGFgQe/y1dPWanDkWLBUGGP/GDcAcSAQdhlyew73YX6ANuTPE4BUNaT64IFrk/lyFXaC6atSIvsqlcZan2VkyZmT12TQgam20YdmXRXgsavIX7eIuUA176ahNnRH2DKA1F+gC7ytYbWU1gNdGa6qXcnUJSChzKhyTRFwvlnzH+Z4kpSnem1c4WdaeqPbeq/M0UAloZl61bTnAjj3VOlfMTCx7gX1WP18q4hh0p4vrx4nVrFmcyLbaLMSE07YOXD7qDbboj+Pz/rFMFgKjFY6ZRpngO9znT9WM+Saoup5egBD7DiLTwQoalbYQzek0s0cv83sImxavrhKW2st1KfiZqA2qKVl2X46Ni18tuXWPsz94AeCzefj+oAf66jHRa9G6MIAcBdDv/5vbC5QDL7pWyRyOYG91sgz4E7vSrTR4hMZLF5x+3RBDedfGtK+keMf4qM7/fAiJrU0+yhI04Ia+mP1f7riJPCbjMYI9h4az42rxgWp7+NemHpOp53FlnXQFOYQ== X-MS-Exchange-AntiSpam-MessageData: BgkjxozOgkjstDTB/QQ8LpUxwciSCU/gAzBWdJdrgCtjt+KdPQPkdo0VIBkyGkY1PdkAtjfP6zLy8+sa4F8angx8RTroV9NGh6I2XIR6F2H5LIyipU35KMwif+AvqJsgykorwa7xS2U7zTzcWdUxUQ== X-MS-Exchange-CrossTenant-Network-Message-Id: 1132365c-5cd0-4628-3c9c-08d7c0f195c1 X-MS-Exchange-CrossTenant-OriginalArrivalTime: 05 Mar 2020 10:40:13.0663 (UTC) X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 856b813c-16e5-49a5-85ec-6f081e13b527 X-MS-Exchange-CrossTenant-MailboxType: HOSTED X-MS-Exchange-CrossTenant-UserPrincipalName: TWqfx4CbyCKwt7qgHvvd4mXAbtJwpIv+hkBvbd/zk5WwU1L/xr74olzPXdOQt+04 X-MS-Exchange-Transport-CrossTenantHeadersStamped: BY5PR18MB3299 X-OriginatorOrg: suse.com X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] [fuzzy] X-Received-From: 15.124.64.90 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: Thu, 05 Mar 2020 10:40:51 -0000 Further to the discussion about disabling btrfs zstd support for i386-pc[1], this paragraph in manual about mbr gap size doesn't seem to hold true any longer. "You must ensure that the first partition starts at least 31 KiB (63 sectors) from the start of the disk" As in many occasions we inevitablely have to provide core image size that goes beyond 31 KiB, this statement becomes a true liability as people would be misguided and think it is still fine to use small MBR gap, that has always been a headache in distribution's upgrade path as growing new feature would render the size requirement bigger but no way for the user to relocate their partitions. The patch tries to correct the paragraph with a more practical size that works for grub and also for modern computer systems in general. [1] https://lists.gnu.org/archive/html/grub-devel/2019-11/msg00025.html Signed-off-by: Michael Chang --- docs/grub.texi | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) diff --git a/docs/grub.texi b/docs/grub.texi index 83979af38..651468268 100644 --- a/docs/grub.texi +++ b/docs/grub.texi @@ -845,12 +845,20 @@ only be used if the @file{/boot} filesystem is on the same disk that the BIOS boots from, so that GRUB does not have to rely on guessing BIOS drive numbers. -The GRUB development team generally recommends embedding GRUB before the -first partition, unless you have special requirements. You must ensure that -the first partition starts at least 31 KiB (63 sectors) from the start of -the disk; on modern disks, it is often a performance advantage to align -partitions on larger boundaries anyway, so the first partition might start 1 -MiB from the start of the disk. +The GRUB development team generally recommends embedding GRUB before the first +partition, unless you have special requirements. You must ensure that the first +partition starts at least 1 MiB from the start of the disk; on modern disks, it +is often a performance advantage to align partitions on larger boundaries and 1 +MiB is the least common multiple of many used alignment sizes. For SSD, it +became crucial to have the partition correctly aligned to avoid excessive +read-modify-write cycles and thus modern tools set to use 1 MiB as a stardard +practice. + +In case legacy systems that cannot boot if first partition not on the cylinder +boundary, the fallback blocklist install method should remain working for them +if the core image growing too much someday. Here we just can't advertise that +31 KiB (63 sectors) is a sensible size any longer as that would pose great +constraint to include new features as time goes by. @heading GPT -- 2.16.4