]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
fixed example file
authorHarald Hoyer <harald@freedesktop.org>
Thu, 30 May 2013 13:29:15 +0000 (06:29 -0700)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Tue, 19 Jun 2018 10:36:21 +0000 (12:36 +0200)
doc/BOOT_LOADER_SPECIFICATION.md

index 2fb096a74ccbdeea393ddd462524283e06b2f919..7d4ead96cfafda3342190e08a417de8c55eb73f2 100644 (file)
@@ -1,5 +1,3 @@
-
-
 # The Boot Loader Specification
 
 _TL;DR: Currently there's little cooperation between multiple distributions in dual-boot (or triple, ... multi-boot) setups, and we'd like to improve this situation by getting everybody to commit to a single boot configuration format that is based on drop-in files, and thus is robust, simple, works without rewriting configuration files and is free of namespace clashes._ 
@@ -65,16 +63,14 @@ These configuration snippets shall be Unix-style text files (i.e. line separatio
 * `options` shall contain kernel parameters to pass to the Linux kernel to spawn. This key is optional. 
 Each configuration drop-in snippet must include at least a `linux` or an `efi` key, and is otherwise not valid. Here's an example for a complete drop-in file: 
 
+      # cat /boot/loader/entries/6a9857a393724b7a981ebb5b8495b9ea-3.8.0-2.fc19.x86_64.conf
+      title      Fedora 19 (Rawhide)
+      version    3.8.0-2.fc19.x86_64
+      machine-id 6a9857a393724b7a981ebb5b8495b9ea
+      options    root=UUID=6d3376e4-fc93-4509-95ec-a21d68011da2
+      linux      /6a9857a393724b7a981ebb5b8495b9ea/3.8.0-2.fc19.x86_64/linux
+      initrd     /6a9857a393724b7a981ebb5b8495b9ea/3.8.0-2.fc19.x86_64/initrd
 
-[[!format txt """
-# cat /boot/loader/entries/6a9857a393724b7a981ebb5b8495b9ea-3.8.0-2.fc19.x86_64.conf
-title      Fedora 19 (Rawhide)
-version    3.8.0-2.fc19.x86_64
-machine-id 6a9857a393724b7a981ebb5b8495b9ea
-options    root=UUID=6d3376e4-fc93-4509-95ec-a21d68011da2
-linux      /6a9857a393724b7a981ebb5b8495b9ea/3.8.0-2.fc19.x86_64/linux
-initrd     /6a9857a393724b7a981ebb5b8495b9ea/3.8.0-2.fc19.x86_64/initrd
-"""]]
 On EFI systems all kernel images shall be EFI images. In order to be compatible with EFI systems it is highly recommended only to install EFI kernel images, even on non-EFI systems, if that's applicable and supported on the specific architecture.  
 
 Note that these configurations snippets do not need to be the only configuration source for a boot loader. It may extend this list of entries with additional items from other configuration files (for example its own native configuration files) or automatically detected other entries without explicit configuration. 
@@ -103,4 +99,4 @@ There are a couple of items that are out of focus for this specifications:
 
 * If userspace can figure out the available boot options, then this is only useful so much: we'd still need to come up with a way how userspace could communicate to the boot loader the default boot loader entry temporarily or persistently. Defining a common scheme for this is certainly a good idea, but out of focus for this specifications. 
 * This specifications is just about "Free" Operating systems. Hooking in other operating systems (like Windows, MacOS) into the boot menu is a different story, and should probably happen outside of this specification. For example, boot loaders might choose to detect other available OSes dynamically at runtime without explicit configuration (like Gummiboot does it), or via natvie configuration (for example via explicit Grub2 configuration generated once at installation). 
-* This specification leaves undefined what to do about systems which are upgraded from an OS that does not implement this specification. As the previous boot loader logic was largely handled by in distribution-specific ways we probably should leave the upgrade path (and whether there actually is one) to the distributions. The simplest solution might be to simply continue with the old scheme for old installations and use this new scheme only for new installations. 
\ No newline at end of file
+* This specification leaves undefined what to do about systems which are upgraded from an OS that does not implement this specification. As the previous boot loader logic was largely handled by in distribution-specific ways we probably should leave the upgrade path (and whether there actually is one) to the distributions. The simplest solution might be to simply continue with the old scheme for old installations and use this new scheme only for new installations.