--- /srv/reproducible-results/rbuild-debian/r-b-build.PEG43eUS/b1/grub2_2.06-13+deb12u1_arm64.changes +++ /srv/reproducible-results/rbuild-debian/r-b-build.PEG43eUS/b2/grub2_2.06-13+deb12u1_arm64.changes ├── Files │ @@ -1,12 +1,12 @@ │ │ f9a599c93fa9a8bc6804ed81f3bb1b13 11417956 debug optional grub-common-dbgsym_2.06-13+deb12u1_arm64.deb │ 080224ed0c5cba29024b373699c0358c 2694924 admin optional grub-common_2.06-13+deb12u1_arm64.deb │ - f44219b843e1038558af090a6e5aa6e4 1401860 admin optional grub-efi-arm64-bin_2.06-13+deb12u1_arm64.deb │ + 23250438417f473b1e0bcd87acabc291 1401500 admin optional grub-efi-arm64-bin_2.06-13+deb12u1_arm64.deb │ 781e2575ed3c42bab47da91c4d97469f 2839072 debug optional grub-efi-arm64-dbg_2.06-13+deb12u1_arm64.deb │ 767c76e7c7cd468644750937ceb37e11 184084 admin optional grub-efi-arm64-signed-template_2.06-13+deb12u1_arm64.deb │ 0befa42e97c5f9a6d8aa92ea47c8e42e 45580 admin optional grub-efi-arm64_2.06-13+deb12u1_arm64.deb │ 72d7f4121a2e1efa57a4ddd5e971db06 2388 admin optional grub-efi_2.06-13+deb12u1_arm64.deb │ cf0dce671c86e1949fe01d08e029a4ca 405004 debian-installer optional grub-mount-udeb_2.06-13+deb12u1_arm64.udeb │ 4b0ce86ac8aa0bf980aecd6adbf5cbc9 2155240 admin optional grub-theme-starfield_2.06-13+deb12u1_arm64.deb │ 018e2e8027cded05cf1c96333ff85665 1422572 debug optional grub2-common-dbgsym_2.06-13+deb12u1_arm64.deb │ - 80176379798d6c5b68863b4b7ecaa1d7 579556 admin optional grub2-common_2.06-13+deb12u1_arm64.deb │ + 409a04620f1d4f7a212de35259ed3e96 579588 admin optional grub2-common_2.06-13+deb12u1_arm64.deb ├── grub-efi-arm64-bin_2.06-13+deb12u1_arm64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ -rw-r--r-- 0 0 0 6656 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 1395012 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 1394652 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -133,15 +133,15 @@ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6544 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/minix2.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6664 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/minix2_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6560 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/minix3.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6664 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/minix3_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 6592 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/minix_be.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 12248 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/mmap.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4048 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/moddep.lst │ │ │ │ --rwxr-xr-x 0 root (0) root (0) 2395 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/modinfo.sh │ │ │ │ +-rwxr-xr-x 0 root (0) root (0) 2393 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/modinfo.sh │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/monolithic/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3977216 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/monolithic/gcdaa64.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4358144 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/monolithic/grubaa64.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3985408 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/monolithic/grubnetaa64-installer.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 3985408 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/monolithic/grubnetaa64.efi │ │ │ │ -rw-r--r-- 0 root (0) root (0) 48904 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/mpi.mod │ │ │ │ -rw-r--r-- 0 root (0) root (0) 4608 2023-10-02 14:11:34.000000 ./usr/lib/grub/arm64-efi/msdospart.mod │ │ │ ├── ./usr/lib/grub/arm64-efi/modinfo.sh │ │ │ │ @@ -1,8 +1,8 @@ │ │ │ │ -#!/bin/bash │ │ │ │ +#!/bin/sh │ │ │ │ │ │ │ │ # User-controllable options │ │ │ │ grub_modinfo_target_cpu=arm64 │ │ │ │ grub_modinfo_platform=efi │ │ │ │ grub_disk_cache_stats=0 │ │ │ │ grub_boot_time_stats=0 │ │ │ │ grub_have_font_source=1 │ │ │ ├── ./usr/lib/grub/arm64-efi/monolithic/gcdaa64.efi │ │ │ │ ├── objdump │ │ │ │ │ @@ -323462,16 +323462,16 @@ │ │ │ │ │ 16f89c: umax v11.4h, v19.4h, v19.4h │ │ │ │ │ 16f8a0: .inst 0x00746166 ; undefined │ │ │ │ │ 16f8a4: .inst 0x00010402 ; undefined │ │ │ │ │ 16f8a8: mov z2.b, p0/m, za0h.b[w12, 0] │ │ │ │ │ 16f8ac: .inst 0x0004f812 ; undefined │ │ │ │ │ 16f8b0: .inst 0x00020020 ; undefined │ │ │ │ │ ... │ │ │ │ │ - 16f8bc: add z0.b, z4.b, z9.b │ │ │ │ │ - 16f8c0: shsub v12.4s, v1.4s, v16.4s │ │ │ │ │ + 16f8bc: fnmadd s0, s4, s9, s0 │ │ │ │ │ + 16f8c0: .inst 0x4eaa28bd ; undefined │ │ │ │ │ 16f8c4: .inst 0x414e204f ; undefined │ │ │ │ │ 16f8c8: .inst 0x2020454d ; undefined │ │ │ │ │ 16f8cc: .inst 0x41462020 ; undefined │ │ │ │ │ 16f8d0: .inst 0x20323154 ; undefined │ │ │ │ │ 16f8d4: fmadd s0, s1, s14, s8 │ │ │ │ │ 16f8d8: ldnp q30, q22, [x29, #-128] │ │ │ │ │ 16f8dc: .inst 0x0b74c022 ; undefined │ │ │ ├── ./usr/lib/grub/arm64-efi/monolithic/grubaa64.efi │ │ │ │ ├── objdump │ │ │ │ │ @@ -410049,16 +410049,16 @@ │ │ │ │ │ 1cd2f4: umax v11.4h, v19.4h, v19.4h │ │ │ │ │ 1cd2f8: .inst 0x00746166 ; undefined │ │ │ │ │ 1cd2fc: .inst 0x00010402 ; undefined │ │ │ │ │ 1cd300: mov z2.b, p0/m, za0h.b[w12, 0] │ │ │ │ │ 1cd304: .inst 0x0004f812 ; undefined │ │ │ │ │ 1cd308: .inst 0x00020020 ; undefined │ │ │ │ │ ... │ │ │ │ │ - 1cd314: add z0.b, z4.b, z9.b │ │ │ │ │ - 1cd318: shsub v12.4s, v1.4s, v16.4s │ │ │ │ │ + 1cd314: fnmadd s0, s4, s9, s0 │ │ │ │ │ + 1cd318: .inst 0x4eaa28bd ; undefined │ │ │ │ │ 1cd31c: .inst 0x414e204f ; undefined │ │ │ │ │ 1cd320: .inst 0x2020454d ; undefined │ │ │ │ │ 1cd324: .inst 0x41462020 ; undefined │ │ │ │ │ 1cd328: .inst 0x20323154 ; undefined │ │ │ │ │ 1cd32c: fmadd s0, s1, s14, s8 │ │ │ │ │ 1cd330: ldnp q30, q22, [x29, #-128] │ │ │ │ │ 1cd334: .inst 0x0b74c022 ; undefined │ │ │ ├── ./usr/lib/grub/arm64-efi/monolithic/grubnetaa64-installer.efi │ │ │ │ ├── objdump │ │ │ │ │ @@ -325465,16 +325465,16 @@ │ │ │ │ │ 171df4: umax v11.4h, v19.4h, v19.4h │ │ │ │ │ 171df8: .inst 0x00746166 ; undefined │ │ │ │ │ 171dfc: .inst 0x00010402 ; undefined │ │ │ │ │ 171e00: mov z2.b, p0/m, za0h.b[w12, 0] │ │ │ │ │ 171e04: .inst 0x0004f812 ; undefined │ │ │ │ │ 171e08: .inst 0x00020020 ; undefined │ │ │ │ │ ... │ │ │ │ │ - 171e14: .inst 0xc2290080 ; undefined │ │ │ │ │ - 171e18: shsub v7.4s, v3.4s, v16.4s │ │ │ │ │ + 171e14: .inst 0x1a290080 ; undefined │ │ │ │ │ + 171e18: .inst 0x4eaa2a2c ; undefined │ │ │ │ │ 171e1c: .inst 0x414e204f ; undefined │ │ │ │ │ 171e20: .inst 0x2020454d ; undefined │ │ │ │ │ 171e24: .inst 0x41462020 ; undefined │ │ │ │ │ 171e28: .inst 0x20323154 ; undefined │ │ │ │ │ 171e2c: fmadd s0, s1, s14, s8 │ │ │ │ │ 171e30: ldnp q30, q22, [x29, #-128] │ │ │ │ │ 171e34: .inst 0x0b74c022 ; undefined │ │ │ ├── ./usr/lib/grub/arm64-efi/monolithic/grubnetaa64.efi │ │ │ │ ├── objdump │ │ │ │ │ @@ -325465,16 +325465,16 @@ │ │ │ │ │ 171df4: umax v11.4h, v19.4h, v19.4h │ │ │ │ │ 171df8: .inst 0x00746166 ; undefined │ │ │ │ │ 171dfc: .inst 0x00010402 ; undefined │ │ │ │ │ 171e00: mov z2.b, p0/m, za0h.b[w12, 0] │ │ │ │ │ 171e04: .inst 0x0004f812 ; undefined │ │ │ │ │ 171e08: .inst 0x00020020 ; undefined │ │ │ │ │ ... │ │ │ │ │ - 171e14: .inst 0xc2290080 ; undefined │ │ │ │ │ - 171e18: shsub v7.4s, v3.4s, v16.4s │ │ │ │ │ + 171e14: .inst 0x1a290080 ; undefined │ │ │ │ │ + 171e18: .inst 0x4eaa2a2c ; undefined │ │ │ │ │ 171e1c: .inst 0x414e204f ; undefined │ │ │ │ │ 171e20: .inst 0x2020454d ; undefined │ │ │ │ │ 171e24: .inst 0x41462020 ; undefined │ │ │ │ │ 171e28: .inst 0x20323154 ; undefined │ │ │ │ │ 171e2c: fmadd s0, s1, s14, s8 │ │ │ │ │ 171e30: ldnp q30, q22, [x29, #-128] │ │ │ │ │ 171e34: .inst 0x0b74c022 ; undefined ├── grub2-common_2.06-13+deb12u1_arm64.deb │ ├── file list │ │ @@ -1,3 +1,3 @@ │ │ -rw-r--r-- 0 0 0 4 2023-10-02 14:11:34.000000 debian-binary │ │ -rw-r--r-- 0 0 0 1380 2023-10-02 14:11:34.000000 control.tar.xz │ │ --rw-r--r-- 0 0 0 577984 2023-10-02 14:11:34.000000 data.tar.xz │ │ +-rw-r--r-- 0 0 0 578016 2023-10-02 14:11:34.000000 data.tar.xz │ ├── control.tar.xz │ │ ├── control.tar │ │ │ ├── ./md5sums │ │ │ │ ├── ./md5sums │ │ │ │ │┄ Files differ │ ├── data.tar.xz │ │ ├── data.tar │ │ │ ├── file list │ │ │ │ @@ -20,18 +20,18 @@ │ │ │ │ -rwxr-xr-x 0 root (0) root (0) 1768 2023-10-02 14:11:34.000000 ./usr/share/bug/grub2-common/script │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/doc/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/grub/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/grub/default/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1490 2023-10-02 14:11:34.000000 ./usr/share/grub/default/grub │ │ │ │ -rw-r--r-- 0 root (0) root (0) 186 2023-10-02 14:11:34.000000 ./usr/share/grub/default/grub.md5sum │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/info/ │ │ │ │ --rw-r--r-- 0 root (0) root (0) 33132 2023-10-02 14:11:34.000000 ./usr/share/info/grub-dev.info.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 90527 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info-1.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 1700 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info-2.gz │ │ │ │ --rw-r--r-- 0 root (0) root (0) 3378 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 33145 2023-10-02 14:11:34.000000 ./usr/share/info/grub-dev.info.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 90529 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info-1.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 1701 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info-2.gz │ │ │ │ +-rw-r--r-- 0 root (0) root (0) 3380 2023-10-02 14:11:34.000000 ./usr/share/info/grub.info.gz │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/man/ │ │ │ │ drwxr-xr-x 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/share/man/man8/ │ │ │ │ -rw-r--r-- 0 root (0) root (0) 1958 2023-10-02 14:11:34.000000 ./usr/share/man/man8/grub-install.8.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 931 2023-10-02 14:11:34.000000 ./usr/share/man/man8/grub-reboot.8.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 666 2023-10-02 14:11:34.000000 ./usr/share/man/man8/grub-set-default.8.gz │ │ │ │ -rw-r--r-- 0 root (0) root (0) 248 2023-10-02 14:11:34.000000 ./usr/share/man/man8/update-grub.8.gz │ │ │ │ lrwxrwxrwx 0 root (0) root (0) 0 2023-10-02 14:11:34.000000 ./usr/sbin/update-grub2 -> update-grub │ │ │ ├── ./usr/share/info/grub-dev.info.gz │ │ │ │ ├── grub-dev.info │ │ │ │ │ @@ -2,6789 +2,6789 @@ │ │ │ │ │ 00000010: 2e69 6e66 6f2c 2070 726f 6475 6365 6420 .info, produced │ │ │ │ │ 00000020: 6279 206d 616b 6569 6e66 6f20 7665 7273 by makeinfo vers │ │ │ │ │ 00000030: 696f 6e20 362e 3820 6672 6f6d 0a67 7275 ion 6.8 from.gru │ │ │ │ │ 00000040: 622d 6465 762e 7465 7869 2e0a 0a54 6869 b-dev.texi...Thi │ │ │ │ │ 00000050: 7320 6465 7665 6c6f 7065 7220 6d61 6e75 s developer manu │ │ │ │ │ 00000060: 616c 2069 7320 666f 7220 474e 5520 4752 al is for GNU GR │ │ │ │ │ 00000070: 5542 2028 7665 7273 696f 6e20 322e 3036 UB (version 2.06 │ │ │ │ │ -00000080: 2c20 3720 4a61 6e75 6172 7920 3230 3234 , 7 January 2024 │ │ │ │ │ -00000090: 292e 0a0a 2020 2043 6f70 7972 6967 6874 )... Copyright │ │ │ │ │ -000000a0: 2028 4329 2031 3939 392c 3230 3030 2c32 (C) 1999,2000,2 │ │ │ │ │ -000000b0: 3030 312c 3230 3032 2c32 3030 342c 3230 001,2002,2004,20 │ │ │ │ │ -000000c0: 3035 2c32 3030 362c 3230 3038 2c32 3030 05,2006,2008,200 │ │ │ │ │ -000000d0: 392c 3230 3130 2c32 3031 310a 4672 6565 9,2010,2011.Free │ │ │ │ │ -000000e0: 2053 6f66 7477 6172 6520 466f 756e 6461 Software Founda │ │ │ │ │ -000000f0: 7469 6f6e 2c20 496e 632e 0a0a 2020 2020 tion, Inc... │ │ │ │ │ -00000100: 2050 6572 6d69 7373 696f 6e20 6973 2067 Permission is g │ │ │ │ │ -00000110: 7261 6e74 6564 2074 6f20 636f 7079 2c20 ranted to copy, │ │ │ │ │ -00000120: 6469 7374 7269 6275 7465 2061 6e64 2f6f distribute and/o │ │ │ │ │ -00000130: 7220 6d6f 6469 6679 2074 6869 730a 2020 r modify this. │ │ │ │ │ -00000140: 2020 2064 6f63 756d 656e 7420 756e 6465 document unde │ │ │ │ │ -00000150: 7220 7468 6520 7465 726d 7320 6f66 2074 r the terms of t │ │ │ │ │ -00000160: 6865 2047 4e55 2046 7265 6520 446f 6375 he GNU Free Docu │ │ │ │ │ -00000170: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73 mentation Licens │ │ │ │ │ -00000180: 652c 0a20 2020 2020 5665 7273 696f 6e20 e,. Version │ │ │ │ │ -00000190: 312e 3220 6f72 2061 6e79 206c 6174 6572 1.2 or any later │ │ │ │ │ -000001a0: 2076 6572 7369 6f6e 2070 7562 6c69 7368 version publish │ │ │ │ │ -000001b0: 6564 2062 7920 7468 6520 4672 6565 2053 ed by the Free S │ │ │ │ │ -000001c0: 6f66 7477 6172 650a 2020 2020 2046 6f75 oftware. Fou │ │ │ │ │ -000001d0: 6e64 6174 696f 6e3b 2077 6974 6820 6e6f ndation; with no │ │ │ │ │ -000001e0: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ -000001f0: 6f6e 732e 0a49 4e46 4f2d 4449 522d 5345 ons..INFO-DIR-SE │ │ │ │ │ -00000200: 4354 494f 4e20 4b65 726e 656c 0a53 5441 CTION Kernel.STA │ │ │ │ │ -00000210: 5254 2d49 4e46 4f2d 4449 522d 454e 5452 RT-INFO-DIR-ENTR │ │ │ │ │ -00000220: 590a 2a20 6772 7562 2d64 6576 3a20 2867 Y.* grub-dev: (g │ │ │ │ │ -00000230: 7275 622d 6465 7629 2e20 2020 2020 2020 rub-dev). │ │ │ │ │ -00000240: 2020 2020 2020 2020 2020 5468 6520 4752 The GR │ │ │ │ │ -00000250: 616e 6420 556e 6966 6965 6420 426f 6f74 and Unified Boot │ │ │ │ │ -00000260: 6c6f 6164 6572 2044 6576 0a45 4e44 2d49 loader Dev.END-I │ │ │ │ │ -00000270: 4e46 4f2d 4449 522d 454e 5452 590a 0a1f NFO-DIR-ENTRY... │ │ │ │ │ -00000280: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ -00000290: 696e 666f 2c20 204e 6f64 653a 2054 6f70 info, Node: Top │ │ │ │ │ -000002a0: 2c20 204e 6578 743a 2047 6574 7469 6e67 , Next: Getting │ │ │ │ │ -000002b0: 2074 6865 2073 6f75 7263 6520 636f 6465 the source code │ │ │ │ │ -000002c0: 2c20 2055 703a 2028 6469 7229 0a0a 474e , Up: (dir)..GN │ │ │ │ │ -000002d0: 5520 4752 5542 2064 6576 656c 6f70 6572 U GRUB developer │ │ │ │ │ -000002e0: 206d 616e 7561 6c0a 2a2a 2a2a 2a2a 2a2a manual.******** │ │ │ │ │ +00000080: 2c20 3920 4665 6272 7561 7279 2032 3032 , 9 February 202 │ │ │ │ │ +00000090: 3529 2e0a 0a20 2020 436f 7079 7269 6768 5)... Copyrigh │ │ │ │ │ +000000a0: 7420 2843 2920 3139 3939 2c32 3030 302c t (C) 1999,2000, │ │ │ │ │ +000000b0: 3230 3031 2c32 3030 322c 3230 3034 2c32 2001,2002,2004,2 │ │ │ │ │ +000000c0: 3030 352c 3230 3036 2c32 3030 382c 3230 005,2006,2008,20 │ │ │ │ │ +000000d0: 3039 2c32 3031 302c 3230 3131 0a46 7265 09,2010,2011.Fre │ │ │ │ │ +000000e0: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ │ │ +000000f0: 6174 696f 6e2c 2049 6e63 2e0a 0a20 2020 ation, Inc... │ │ │ │ │ +00000100: 2020 5065 726d 6973 7369 6f6e 2069 7320 Permission is │ │ │ │ │ +00000110: 6772 616e 7465 6420 746f 2063 6f70 792c granted to copy, │ │ │ │ │ +00000120: 2064 6973 7472 6962 7574 6520 616e 642f distribute and/ │ │ │ │ │ +00000130: 6f72 206d 6f64 6966 7920 7468 6973 0a20 or modify this. │ │ │ │ │ +00000140: 2020 2020 646f 6375 6d65 6e74 2075 6e64 document und │ │ │ │ │ +00000150: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ +00000160: 7468 6520 474e 5520 4672 6565 2044 6f63 the GNU Free Doc │ │ │ │ │ +00000170: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ +00000180: 7365 2c0a 2020 2020 2056 6572 7369 6f6e se,. Version │ │ │ │ │ +00000190: 2031 2e32 206f 7220 616e 7920 6c61 7465 1.2 or any late │ │ │ │ │ +000001a0: 7220 7665 7273 696f 6e20 7075 626c 6973 r version publis │ │ │ │ │ +000001b0: 6865 6420 6279 2074 6865 2046 7265 6520 hed by the Free │ │ │ │ │ +000001c0: 536f 6674 7761 7265 0a20 2020 2020 466f Software. Fo │ │ │ │ │ +000001d0: 756e 6461 7469 6f6e 3b20 7769 7468 206e undation; with n │ │ │ │ │ +000001e0: 6f20 496e 7661 7269 616e 7420 5365 6374 o Invariant Sect │ │ │ │ │ +000001f0: 696f 6e73 2e0a 494e 464f 2d44 4952 2d53 ions..INFO-DIR-S │ │ │ │ │ +00000200: 4543 5449 4f4e 204b 6572 6e65 6c0a 5354 ECTION Kernel.ST │ │ │ │ │ +00000210: 4152 542d 494e 464f 2d44 4952 2d45 4e54 ART-INFO-DIR-ENT │ │ │ │ │ +00000220: 5259 0a2a 2067 7275 622d 6465 763a 2028 RY.* grub-dev: ( │ │ │ │ │ +00000230: 6772 7562 2d64 6576 292e 2020 2020 2020 grub-dev). │ │ │ │ │ +00000240: 2020 2020 2020 2020 2020 2054 6865 2047 The G │ │ │ │ │ +00000250: 5261 6e64 2055 6e69 6669 6564 2042 6f6f Rand Unified Boo │ │ │ │ │ +00000260: 746c 6f61 6465 7220 4465 760a 454e 442d tloader Dev.END- │ │ │ │ │ +00000270: 494e 464f 2d44 4952 2d45 4e54 5259 0a0a INFO-DIR-ENTRY.. │ │ │ │ │ +00000280: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ │ +00000290: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 546f .info, Node: To │ │ │ │ │ +000002a0: 702c 2020 4e65 7874 3a20 4765 7474 696e p, Next: Gettin │ │ │ │ │ +000002b0: 6720 7468 6520 736f 7572 6365 2063 6f64 g the source cod │ │ │ │ │ +000002c0: 652c 2020 5570 3a20 2864 6972 290a 0a47 e, Up: (dir)..G │ │ │ │ │ +000002d0: 4e55 2047 5255 4220 6465 7665 6c6f 7065 NU GRUB develope │ │ │ │ │ +000002e0: 7220 6d61 6e75 616c 0a2a 2a2a 2a2a 2a2a r manual.******* │ │ │ │ │ 000002f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00000300: 2a0a 0a54 6869 7320 6973 2074 6865 2064 *..This is the d │ │ │ │ │ -00000310: 6576 656c 6f70 6572 2064 6f63 756d 656e eveloper documen │ │ │ │ │ -00000320: 7461 7469 6f6e 206f 6620 474e 5520 4752 tation of GNU GR │ │ │ │ │ -00000330: 5542 2c20 7468 6520 4752 616e 6420 556e UB, the GRand Un │ │ │ │ │ -00000340: 6966 6965 640a 426f 6f74 6c6f 6164 6572 ified.Bootloader │ │ │ │ │ -00000350: 2c20 6120 666c 6578 6962 6c65 2061 6e64 , a flexible and │ │ │ │ │ -00000360: 2070 6f77 6572 6675 6c20 626f 6f74 206c powerful boot l │ │ │ │ │ -00000370: 6f61 6465 7220 7072 6f67 7261 6d20 666f oader program fo │ │ │ │ │ -00000380: 7220 6120 7769 6465 2072 616e 6765 0a6f r a wide range.o │ │ │ │ │ -00000390: 6620 6172 6368 6974 6563 7475 7265 732e f architectures. │ │ │ │ │ -000003a0: 0a0a 2020 2054 6869 7320 6564 6974 696f .. This editio │ │ │ │ │ -000003b0: 6e20 646f 6375 6d65 6e74 7320 7665 7273 n documents vers │ │ │ │ │ -000003c0: 696f 6e20 322e 3036 2e0a 0a20 2020 5468 ion 2.06... Th │ │ │ │ │ -000003d0: 6973 2064 6576 656c 6f70 6572 206d 616e is developer man │ │ │ │ │ -000003e0: 7561 6c20 6973 2066 6f72 2047 4e55 2047 ual is for GNU G │ │ │ │ │ -000003f0: 5255 4220 2876 6572 7369 6f6e 2032 2e30 RUB (version 2.0 │ │ │ │ │ -00000400: 362c 2037 204a 616e 7561 7279 2032 3032 6, 7 January 202 │ │ │ │ │ -00000410: 3429 2e0a 0a20 2020 436f 7079 7269 6768 4)... Copyrigh │ │ │ │ │ -00000420: 7420 2843 2920 3139 3939 2c32 3030 302c t (C) 1999,2000, │ │ │ │ │ -00000430: 3230 3031 2c32 3030 322c 3230 3034 2c32 2001,2002,2004,2 │ │ │ │ │ -00000440: 3030 352c 3230 3036 2c32 3030 382c 3230 005,2006,2008,20 │ │ │ │ │ -00000450: 3039 2c32 3031 302c 3230 3131 0a46 7265 09,2010,2011.Fre │ │ │ │ │ -00000460: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ │ │ -00000470: 6174 696f 6e2c 2049 6e63 2e0a 0a20 2020 ation, Inc... │ │ │ │ │ -00000480: 2020 5065 726d 6973 7369 6f6e 2069 7320 Permission is │ │ │ │ │ -00000490: 6772 616e 7465 6420 746f 2063 6f70 792c granted to copy, │ │ │ │ │ -000004a0: 2064 6973 7472 6962 7574 6520 616e 642f distribute and/ │ │ │ │ │ -000004b0: 6f72 206d 6f64 6966 7920 7468 6973 0a20 or modify this. │ │ │ │ │ -000004c0: 2020 2020 646f 6375 6d65 6e74 2075 6e64 document und │ │ │ │ │ -000004d0: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ -000004e0: 7468 6520 474e 5520 4672 6565 2044 6f63 the GNU Free Doc │ │ │ │ │ -000004f0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ -00000500: 7365 2c0a 2020 2020 2056 6572 7369 6f6e se,. Version │ │ │ │ │ -00000510: 2031 2e32 206f 7220 616e 7920 6c61 7465 1.2 or any late │ │ │ │ │ -00000520: 7220 7665 7273 696f 6e20 7075 626c 6973 r version publis │ │ │ │ │ -00000530: 6865 6420 6279 2074 6865 2046 7265 6520 hed by the Free │ │ │ │ │ -00000540: 536f 6674 7761 7265 0a20 2020 2020 466f Software. Fo │ │ │ │ │ -00000550: 756e 6461 7469 6f6e 3b20 7769 7468 206e undation; with n │ │ │ │ │ -00000560: 6f20 496e 7661 7269 616e 7420 5365 6374 o Invariant Sect │ │ │ │ │ -00000570: 696f 6e73 2e0a 0a2a 204d 656e 753a 0a0a ions...* Menu:.. │ │ │ │ │ -00000580: 2a20 4765 7474 696e 6720 7468 6520 736f * Getting the so │ │ │ │ │ -00000590: 7572 6365 2063 6f64 653a 3a0a 2a20 436f urce code::.* Co │ │ │ │ │ -000005a0: 6469 6e67 2073 7479 6c65 3a3a 0a2a 2046 ding style::.* F │ │ │ │ │ -000005b0: 696e 6469 6e67 2079 6f75 7220 7761 7920 inding your way │ │ │ │ │ -000005c0: 6172 6f75 6e64 3a3a 0a2a 2043 6f6e 7472 around::.* Contr │ │ │ │ │ -000005d0: 6962 7574 696e 6720 4368 616e 6765 733a ibuting Changes: │ │ │ │ │ -000005e0: 3a0a 2a20 5570 6461 7469 6e67 2045 7874 :.* Updating Ext │ │ │ │ │ -000005f0: 6572 6e61 6c20 436f 6465 3a3a 0a2a 2050 ernal Code::.* P │ │ │ │ │ -00000600: 6f72 7469 6e67 3a3a 0a2a 2045 7272 6f72 orting::.* Error │ │ │ │ │ -00000610: 2048 616e 646c 696e 673a 3a0a 2a20 5374 Handling::.* St │ │ │ │ │ -00000620: 6163 6b20 616e 6420 6865 6170 2073 697a ack and heap siz │ │ │ │ │ -00000630: 653a 3a0a 2a20 4249 4f53 2070 6f72 7420 e::.* BIOS port │ │ │ │ │ -00000640: 6d65 6d6f 7279 206d 6170 3a3a 0a2a 2056 memory map::.* V │ │ │ │ │ -00000650: 6964 656f 2053 7562 7379 7374 656d 3a3a ideo Subsystem:: │ │ │ │ │ -00000660: 0a2a 2050 4646 3220 466f 6e74 2046 696c .* PFF2 Font Fil │ │ │ │ │ -00000670: 6520 466f 726d 6174 3a3a 0a2a 2047 7261 e Format::.* Gra │ │ │ │ │ -00000680: 7068 6963 616c 204d 656e 7520 536f 6674 phical Menu Soft │ │ │ │ │ -00000690: 7761 7265 2044 6573 6967 6e3a 3a0a 2a20 ware Design::.* │ │ │ │ │ -000006a0: 5665 7269 6669 6572 7320 6672 616d 6577 Verifiers framew │ │ │ │ │ -000006b0: 6f72 6b3a 3a0a 2a20 4c6f 636b 646f 776e ork::.* Lockdown │ │ │ │ │ -000006c0: 2066 7261 6d65 776f 726b 3a3a 0a2a 2043 framework::.* C │ │ │ │ │ -000006d0: 6f70 7969 6e67 2054 6869 7320 4d61 6e75 opying This Manu │ │ │ │ │ -000006e0: 616c 3a3a 2020 2020 2020 2020 2043 6f70 al:: Cop │ │ │ │ │ -000006f0: 7969 6e67 2054 6869 7320 4d61 6e75 616c ying This Manual │ │ │ │ │ -00000700: 0a2a 2049 6e64 6578 3a3a 0a0a 1f0a 4669 .* Index::....Fi │ │ │ │ │ -00000710: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ -00000720: 6f2c 2020 4e6f 6465 3a20 4765 7474 696e o, Node: Gettin │ │ │ │ │ -00000730: 6720 7468 6520 736f 7572 6365 2063 6f64 g the source cod │ │ │ │ │ -00000740: 652c 2020 4e65 7874 3a20 436f 6469 6e67 e, Next: Coding │ │ │ │ │ -00000750: 2073 7479 6c65 2c20 2050 7265 763a 2054 style, Prev: T │ │ │ │ │ -00000760: 6f70 2c20 2055 703a 2054 6f70 0a0a 3120 op, Up: Top..1 │ │ │ │ │ -00000770: 4765 7474 696e 6720 7468 6520 736f 7572 Getting the sour │ │ │ │ │ -00000780: 6365 2063 6f64 650a 2a2a 2a2a 2a2a 2a2a ce code.******** │ │ │ │ │ +00000300: 2a2a 0a0a 5468 6973 2069 7320 7468 6520 **..This is the │ │ │ │ │ +00000310: 6465 7665 6c6f 7065 7220 646f 6375 6d65 developer docume │ │ │ │ │ +00000320: 6e74 6174 696f 6e20 6f66 2047 4e55 2047 ntation of GNU G │ │ │ │ │ +00000330: 5255 422c 2074 6865 2047 5261 6e64 2055 RUB, the GRand U │ │ │ │ │ +00000340: 6e69 6669 6564 0a42 6f6f 746c 6f61 6465 nified.Bootloade │ │ │ │ │ +00000350: 722c 2061 2066 6c65 7869 626c 6520 616e r, a flexible an │ │ │ │ │ +00000360: 6420 706f 7765 7266 756c 2062 6f6f 7420 d powerful boot │ │ │ │ │ +00000370: 6c6f 6164 6572 2070 726f 6772 616d 2066 loader program f │ │ │ │ │ +00000380: 6f72 2061 2077 6964 6520 7261 6e67 650a or a wide range. │ │ │ │ │ +00000390: 6f66 2061 7263 6869 7465 6374 7572 6573 of architectures │ │ │ │ │ +000003a0: 2e0a 0a20 2020 5468 6973 2065 6469 7469 ... This editi │ │ │ │ │ +000003b0: 6f6e 2064 6f63 756d 656e 7473 2076 6572 on documents ver │ │ │ │ │ +000003c0: 7369 6f6e 2032 2e30 362e 0a0a 2020 2054 sion 2.06... T │ │ │ │ │ +000003d0: 6869 7320 6465 7665 6c6f 7065 7220 6d61 his developer ma │ │ │ │ │ +000003e0: 6e75 616c 2069 7320 666f 7220 474e 5520 nual is for GNU │ │ │ │ │ +000003f0: 4752 5542 2028 7665 7273 696f 6e20 322e GRUB (version 2. │ │ │ │ │ +00000400: 3036 2c20 3920 4665 6272 7561 7279 0a32 06, 9 February.2 │ │ │ │ │ +00000410: 3032 3529 2e0a 0a20 2020 436f 7079 7269 025)... Copyri │ │ │ │ │ +00000420: 6768 7420 2843 2920 3139 3939 2c32 3030 ght (C) 1999,200 │ │ │ │ │ +00000430: 302c 3230 3031 2c32 3030 322c 3230 3034 0,2001,2002,2004 │ │ │ │ │ +00000440: 2c32 3030 352c 3230 3036 2c32 3030 382c ,2005,2006,2008, │ │ │ │ │ +00000450: 3230 3039 2c32 3031 302c 3230 3131 0a46 2009,2010,2011.F │ │ │ │ │ +00000460: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ │ │ +00000470: 6e64 6174 696f 6e2c 2049 6e63 2e0a 0a20 ndation, Inc... │ │ │ │ │ +00000480: 2020 2020 5065 726d 6973 7369 6f6e 2069 Permission i │ │ │ │ │ +00000490: 7320 6772 616e 7465 6420 746f 2063 6f70 s granted to cop │ │ │ │ │ +000004a0: 792c 2064 6973 7472 6962 7574 6520 616e y, distribute an │ │ │ │ │ +000004b0: 642f 6f72 206d 6f64 6966 7920 7468 6973 d/or modify this │ │ │ │ │ +000004c0: 0a20 2020 2020 646f 6375 6d65 6e74 2075 . document u │ │ │ │ │ +000004d0: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ +000004e0: 6620 7468 6520 474e 5520 4672 6565 2044 f the GNU Free D │ │ │ │ │ +000004f0: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ +00000500: 656e 7365 2c0a 2020 2020 2056 6572 7369 ense,. Versi │ │ │ │ │ +00000510: 6f6e 2031 2e32 206f 7220 616e 7920 6c61 on 1.2 or any la │ │ │ │ │ +00000520: 7465 7220 7665 7273 696f 6e20 7075 626c ter version publ │ │ │ │ │ +00000530: 6973 6865 6420 6279 2074 6865 2046 7265 ished by the Fre │ │ │ │ │ +00000540: 6520 536f 6674 7761 7265 0a20 2020 2020 e Software. │ │ │ │ │ +00000550: 466f 756e 6461 7469 6f6e 3b20 7769 7468 Foundation; with │ │ │ │ │ +00000560: 206e 6f20 496e 7661 7269 616e 7420 5365 no Invariant Se │ │ │ │ │ +00000570: 6374 696f 6e73 2e0a 0a2a 204d 656e 753a ctions...* Menu: │ │ │ │ │ +00000580: 0a0a 2a20 4765 7474 696e 6720 7468 6520 ..* Getting the │ │ │ │ │ +00000590: 736f 7572 6365 2063 6f64 653a 3a0a 2a20 source code::.* │ │ │ │ │ +000005a0: 436f 6469 6e67 2073 7479 6c65 3a3a 0a2a Coding style::.* │ │ │ │ │ +000005b0: 2046 696e 6469 6e67 2079 6f75 7220 7761 Finding your wa │ │ │ │ │ +000005c0: 7920 6172 6f75 6e64 3a3a 0a2a 2043 6f6e y around::.* Con │ │ │ │ │ +000005d0: 7472 6962 7574 696e 6720 4368 616e 6765 tributing Change │ │ │ │ │ +000005e0: 733a 3a0a 2a20 5570 6461 7469 6e67 2045 s::.* Updating E │ │ │ │ │ +000005f0: 7874 6572 6e61 6c20 436f 6465 3a3a 0a2a xternal Code::.* │ │ │ │ │ +00000600: 2050 6f72 7469 6e67 3a3a 0a2a 2045 7272 Porting::.* Err │ │ │ │ │ +00000610: 6f72 2048 616e 646c 696e 673a 3a0a 2a20 or Handling::.* │ │ │ │ │ +00000620: 5374 6163 6b20 616e 6420 6865 6170 2073 Stack and heap s │ │ │ │ │ +00000630: 697a 653a 3a0a 2a20 4249 4f53 2070 6f72 ize::.* BIOS por │ │ │ │ │ +00000640: 7420 6d65 6d6f 7279 206d 6170 3a3a 0a2a t memory map::.* │ │ │ │ │ +00000650: 2056 6964 656f 2053 7562 7379 7374 656d Video Subsystem │ │ │ │ │ +00000660: 3a3a 0a2a 2050 4646 3220 466f 6e74 2046 ::.* PFF2 Font F │ │ │ │ │ +00000670: 696c 6520 466f 726d 6174 3a3a 0a2a 2047 ile Format::.* G │ │ │ │ │ +00000680: 7261 7068 6963 616c 204d 656e 7520 536f raphical Menu So │ │ │ │ │ +00000690: 6674 7761 7265 2044 6573 6967 6e3a 3a0a ftware Design::. │ │ │ │ │ +000006a0: 2a20 5665 7269 6669 6572 7320 6672 616d * Verifiers fram │ │ │ │ │ +000006b0: 6577 6f72 6b3a 3a0a 2a20 4c6f 636b 646f ework::.* Lockdo │ │ │ │ │ +000006c0: 776e 2066 7261 6d65 776f 726b 3a3a 0a2a wn framework::.* │ │ │ │ │ +000006d0: 2043 6f70 7969 6e67 2054 6869 7320 4d61 Copying This Ma │ │ │ │ │ +000006e0: 6e75 616c 3a3a 2020 2020 2020 2020 2043 nual:: C │ │ │ │ │ +000006f0: 6f70 7969 6e67 2054 6869 7320 4d61 6e75 opying This Manu │ │ │ │ │ +00000700: 616c 0a2a 2049 6e64 6578 3a3a 0a0a 1f0a al.* Index::.... │ │ │ │ │ +00000710: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ │ +00000720: 6e66 6f2c 2020 4e6f 6465 3a20 4765 7474 nfo, Node: Gett │ │ │ │ │ +00000730: 696e 6720 7468 6520 736f 7572 6365 2063 ing the source c │ │ │ │ │ +00000740: 6f64 652c 2020 4e65 7874 3a20 436f 6469 ode, Next: Codi │ │ │ │ │ +00000750: 6e67 2073 7479 6c65 2c20 2050 7265 763a ng style, Prev: │ │ │ │ │ +00000760: 2054 6f70 2c20 2055 703a 2054 6f70 0a0a Top, Up: Top.. │ │ │ │ │ +00000770: 3120 4765 7474 696e 6720 7468 6520 736f 1 Getting the so │ │ │ │ │ +00000780: 7572 6365 2063 6f64 650a 2a2a 2a2a 2a2a urce code.****** │ │ │ │ │ 00000790: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000007a0: 2a0a 0a47 5255 4220 6973 206d 6169 6e74 *..GRUB is maint │ │ │ │ │ -000007b0: 6169 6e65 6420 7573 696e 6720 7468 6520 ained using the │ │ │ │ │ -000007c0: 3c47 4954 2072 6576 6973 696f 6e20 636f . │ │ │ │ │ -000007e0: 546f 2066 6574 6368 3a0a 0a20 2020 2020 To fetch:.. │ │ │ │ │ -000007f0: 6769 7420 636c 6f6e 6520 6769 743a 2f2f git clone git:// │ │ │ │ │ -00000800: 6769 742e 7376 2e67 6e75 2e6f 7267 2f67 git.sv.gnu.org/g │ │ │ │ │ -00000810: 7275 622e 6769 740a 0a20 2020 5765 6220 rub.git.. Web │ │ │ │ │ -00000820: 6163 6365 7373 2069 7320 6176 6169 6c61 access is availa │ │ │ │ │ -00000830: 626c 6520 756e 6465 720a 2020 2020 2068 ble under. h │ │ │ │ │ -00000840: 7474 703a 2f2f 6769 742e 7361 7661 6e6e ttp://git.savann │ │ │ │ │ -00000850: 6168 2e67 6e75 2e6f 7267 2f63 6769 742f ah.gnu.org/cgit/ │ │ │ │ │ -00000860: 6772 7562 2e67 6974 2f0a 0a20 2020 5468 grub.git/.. Th │ │ │ │ │ -00000870: 6520 6272 616e 6368 6573 2061 7661 696c e branches avail │ │ │ │ │ -00000880: 6162 6c65 2061 7265 3a0a 0a27 6d61 7374 able are:..'mast │ │ │ │ │ -00000890: 6572 270a 2020 2020 204d 6169 6e20 6465 er'. Main de │ │ │ │ │ -000008a0: 7665 6c6f 706d 656e 7420 6272 616e 6368 velopment branch │ │ │ │ │ -000008b0: 2e0a 2767 7275 622d 6c65 6761 6379 270a ..'grub-legacy'. │ │ │ │ │ -000008c0: 2020 2020 2047 5255 4220 302e 3937 2063 GRUB 0.97 c │ │ │ │ │ -000008d0: 6f64 6562 6173 652e 2020 4b65 7074 2066 odebase. Kept f │ │ │ │ │ -000008e0: 6f72 2072 6566 6572 656e 6365 2061 6e64 or reference and │ │ │ │ │ -000008f0: 206c 6567 616c 2072 6561 736f 6e73 0a27 legal reasons.' │ │ │ │ │ -00000900: 6d75 6c74 6962 6f6f 7427 0a20 2020 2020 multiboot'. │ │ │ │ │ -00000910: 4d75 6c74 6962 6f6f 7420 7370 6563 6669 Multiboot specfi │ │ │ │ │ -00000920: 6361 7469 6f6e 0a27 6d75 6c74 6962 6f6f cation.'multiboo │ │ │ │ │ -00000930: 7432 270a 2020 2020 204d 756c 7469 626f t2'. Multibo │ │ │ │ │ -00000940: 6f74 3220 7370 6563 6669 6361 7469 6f6e ot2 specfication │ │ │ │ │ -00000950: 0a27 6465 7665 6c6f 7065 7220 6272 616e .'developer bran │ │ │ │ │ -00000960: 6368 6573 270a 2020 2020 2050 7265 6669 ches'. Prefi │ │ │ │ │ -00000970: 7865 6420 7769 7468 2064 6576 656c 6f70 xed with develop │ │ │ │ │ -00000980: 6572 206e 616d 652e 2020 4576 6572 7920 er name. Every │ │ │ │ │ -00000990: 6465 7665 6c6f 7065 7220 6f66 2061 2074 developer of a t │ │ │ │ │ -000009a0: 6561 6d20 6d61 6e61 6765 730a 2020 2020 eam manages. │ │ │ │ │ -000009b0: 2068 6973 206f 776e 2062 7261 6e63 6865 his own branche │ │ │ │ │ -000009c0: 732e 2020 4465 7665 6c6f 7065 7220 6272 s. Developer br │ │ │ │ │ -000009d0: 616e 6368 6573 2064 6f20 6e6f 7420 6e65 anches do not ne │ │ │ │ │ -000009e0: 6564 2063 6861 6e67 656c 6f67 0a20 2020 ed changelog. │ │ │ │ │ -000009f0: 2020 656e 7472 6965 732e 0a0a 2020 204f entries... O │ │ │ │ │ -00000a00: 6e63 6520 796f 7520 6861 7665 2075 7365 nce you have use │ │ │ │ │ -00000a10: 6420 2767 6974 2063 6c6f 6e65 2720 746f d 'git clone' to │ │ │ │ │ -00000a20: 2066 6574 6368 2061 6e20 696e 6974 6961 fetch an initia │ │ │ │ │ -00000a30: 6c20 636f 7079 206f 6620 6120 6272 616e l copy of a bran │ │ │ │ │ -00000a40: 6368 2c0a 796f 7520 6361 6e20 7573 6520 ch,.you can use │ │ │ │ │ -00000a50: 2767 6974 2070 756c 6c27 2074 6f20 6b65 'git pull' to ke │ │ │ │ │ -00000a60: 6570 2069 7420 7570 2074 6f20 6461 7465 ep it up to date │ │ │ │ │ -00000a70: 2e20 2049 6620 796f 7520 6861 7665 206d . If you have m │ │ │ │ │ -00000a80: 6f64 6966 6965 6420 796f 7572 0a6c 6f63 odified your.loc │ │ │ │ │ -00000a90: 616c 2076 6572 7369 6f6e 2c20 796f 7520 al version, you │ │ │ │ │ -00000aa0: 6d61 7920 6e65 6564 2074 6f20 7265 736f may need to reso │ │ │ │ │ -00000ab0: 6c76 6520 636f 6e66 6c69 6374 7320 7768 lve conflicts wh │ │ │ │ │ -00000ac0: 656e 2070 756c 6c69 6e67 2e0a 0a1f 0a46 en pulling.....F │ │ │ │ │ -00000ad0: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ │ -00000ae0: 666f 2c20 204e 6f64 653a 2043 6f64 696e fo, Node: Codin │ │ │ │ │ -00000af0: 6720 7374 796c 652c 2020 4e65 7874 3a20 g style, Next: │ │ │ │ │ -00000b00: 4669 6e64 696e 6720 796f 7572 2077 6179 Finding your way │ │ │ │ │ -00000b10: 2061 726f 756e 642c 2020 5072 6576 3a20 around, Prev: │ │ │ │ │ -00000b20: 4765 7474 696e 6720 7468 6520 736f 7572 Getting the sour │ │ │ │ │ -00000b30: 6365 2063 6f64 652c 2020 5570 3a20 546f ce code, Up: To │ │ │ │ │ -00000b40: 700a 0a32 2043 6f64 696e 6720 7374 796c p..2 Coding styl │ │ │ │ │ -00000b50: 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a e.************** │ │ │ │ │ -00000b60: 0a0a 4261 7369 6361 6c6c 7920 7765 2066 ..Basically we f │ │ │ │ │ -00000b70: 6f6c 6c6f 7720 7468 6520 474e 5520 436f ollow the GNU Co │ │ │ │ │ -00000b80: 6469 6e67 2053 7461 6e64 6172 6473 0a28 ding Standards.( │ │ │ │ │ -00000b90: 6874 7470 3a2f 2f77 7777 2e67 6e75 2e6f http://www.gnu.o │ │ │ │ │ -00000ba0: 7267 2f70 7265 702f 7374 616e 6461 7264 rg/prep/standard │ │ │ │ │ -00000bb0: 735f 746f 632e 6874 6d6c 292e 2020 5765 s_toc.html). We │ │ │ │ │ -00000bc0: 2064 6566 696e 6520 6164 6469 7469 6f6e define addition │ │ │ │ │ -00000bd0: 616c 0a63 6f6e 7665 6e74 696f 6e73 2066 al.conventions f │ │ │ │ │ -00000be0: 6f72 2047 5255 4220 6865 7265 2e0a 0a2a or GRUB here...* │ │ │ │ │ -00000bf0: 204d 656e 753a 0a0a 2a20 4e61 6d69 6e67 Menu:..* Naming │ │ │ │ │ -00000c00: 2043 6f6e 7665 6e74 696f 6e73 3a3a 0a2a Conventions::.* │ │ │ │ │ -00000c10: 2046 756e 6374 696f 6e73 3a3a 0a2a 2056 Functions::.* V │ │ │ │ │ -00000c20: 6172 6961 626c 6573 3a3a 0a2a 2054 7970 ariables::.* Typ │ │ │ │ │ -00000c30: 6573 3a3a 0a2a 204d 6163 726f 733a 3a0a es::.* Macros::. │ │ │ │ │ -00000c40: 2a20 436f 6d6d 656e 7473 3a3a 0a2a 204d * Comments::.* M │ │ │ │ │ -00000c50: 756c 7469 2d4c 696e 6520 436f 6d6d 656e ulti-Line Commen │ │ │ │ │ -00000c60: 7473 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 ts::....File: gr │ │ │ │ │ -00000c70: 7562 2d64 6576 2e69 6e66 6f2c 2020 4e6f ub-dev.info, No │ │ │ │ │ -00000c80: 6465 3a20 4e61 6d69 6e67 2043 6f6e 7665 de: Naming Conve │ │ │ │ │ -00000c90: 6e74 696f 6e73 2c20 204e 6578 743a 2046 ntions, Next: F │ │ │ │ │ -00000ca0: 756e 6374 696f 6e73 2c20 2055 703a 2043 unctions, Up: C │ │ │ │ │ -00000cb0: 6f64 696e 6720 7374 796c 650a 0a32 2e31 oding style..2.1 │ │ │ │ │ -00000cc0: 204e 616d 696e 6720 436f 6e76 656e 7469 Naming Conventi │ │ │ │ │ -00000cd0: 6f6e 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ons.============ │ │ │ │ │ -00000ce0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 416c 6c20 ==========..All │ │ │ │ │ -00000cf0: 676c 6f62 616c 2073 796d 626f 6c73 2028 global symbols ( │ │ │ │ │ -00000d00: 692e 652e 2020 6675 6e63 7469 6f6e 732c i.e. functions, │ │ │ │ │ -00000d10: 2076 6172 6961 626c 6573 2c20 7479 7065 variables, type │ │ │ │ │ -00000d20: 732c 2061 6e64 206d 6163 726f 7329 206d s, and macros) m │ │ │ │ │ -00000d30: 7573 740a 6861 7665 2074 6865 2070 7265 ust.have the pre │ │ │ │ │ -00000d40: 6669 7820 6772 7562 5f20 6f72 2047 5255 fix grub_ or GRU │ │ │ │ │ -00000d50: 425f 2e20 2054 6865 2061 6c6c 2063 6170 B_. The all cap │ │ │ │ │ -00000d60: 6974 616c 2066 6f72 6d20 6973 2075 7365 ital form is use │ │ │ │ │ -00000d70: 6420 6f6e 6c79 2062 790a 6d61 6372 6f73 d only by.macros │ │ │ │ │ -00000d80: 2e0a 0a1f 0a46 696c 653a 2067 7275 622d .....File: grub- │ │ │ │ │ -00000d90: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ │ -00000da0: 2046 756e 6374 696f 6e73 2c20 204e 6578 Functions, Nex │ │ │ │ │ -00000db0: 743a 2056 6172 6961 626c 6573 2c20 2050 t: Variables, P │ │ │ │ │ -00000dc0: 7265 763a 204e 616d 696e 6720 436f 6e76 rev: Naming Conv │ │ │ │ │ -00000dd0: 656e 7469 6f6e 732c 2020 5570 3a20 436f entions, Up: Co │ │ │ │ │ -00000de0: 6469 6e67 2073 7479 6c65 0a0a 322e 3220 ding style..2.2 │ │ │ │ │ -00000df0: 4675 6e63 7469 6f6e 730a 3d3d 3d3d 3d3d Functions.====== │ │ │ │ │ -00000e00: 3d3d 3d3d 3d3d 3d0a 0a49 6620 6120 6675 =======..If a fu │ │ │ │ │ -00000e10: 6e63 7469 6f6e 2069 7320 676c 6f62 616c nction is global │ │ │ │ │ -00000e20: 2c20 6974 7320 6e61 6d65 206d 7573 7420 , its name must │ │ │ │ │ -00000e30: 6265 2070 7265 6669 7865 6420 7769 7468 be prefixed with │ │ │ │ │ -00000e40: 2067 7275 625f 2061 6e64 206d 7573 740a grub_ and must. │ │ │ │ │ -00000e50: 636f 6e73 6973 7420 6f66 206f 6e6c 7920 consist of only │ │ │ │ │ -00000e60: 736d 616c 6c20 6c65 7474 6572 732e 2020 small letters. │ │ │ │ │ -00000e70: 4966 2074 6865 2066 756e 6374 696f 6e20 If the function │ │ │ │ │ -00000e80: 6265 6c6f 6e67 7320 746f 2061 2073 7065 belongs to a spe │ │ │ │ │ -00000e90: 6369 6669 630a 6675 6e63 7469 6f6e 206d cific.function m │ │ │ │ │ -00000ea0: 6f64 756c 652c 2074 6865 206e 616d 6520 odule, the name │ │ │ │ │ -00000eb0: 6d75 7374 2061 6c73 6f20 6265 2070 7265 must also be pre │ │ │ │ │ -00000ec0: 6669 7865 6420 7769 7468 2074 6865 206d fixed with the m │ │ │ │ │ -00000ed0: 6f64 756c 6520 6e61 6d65 2e0a 466f 7220 odule name..For │ │ │ │ │ -00000ee0: 6578 616d 706c 652c 2069 6620 6120 6675 example, if a fu │ │ │ │ │ -00000ef0: 6e63 7469 6f6e 2069 7320 666f 7220 6669 nction is for fi │ │ │ │ │ -00000f00: 6c65 2073 7973 7465 6d73 2c20 6974 7320 le systems, its │ │ │ │ │ -00000f10: 6e61 6d65 2069 7320 7072 6566 6978 6564 name is prefixed │ │ │ │ │ -00000f20: 0a77 6974 6820 6772 7562 5f66 735f 2e20 .with grub_fs_. │ │ │ │ │ -00000f30: 2049 6620 6120 6675 6e63 7469 6f6e 2069 If a function i │ │ │ │ │ -00000f40: 7320 666f 7220 4641 5420 6669 6c65 2073 s for FAT file s │ │ │ │ │ -00000f50: 7973 7465 6d20 6275 7420 6e6f 7420 666f ystem but not fo │ │ │ │ │ -00000f60: 7220 616c 6c0a 6669 6c65 2073 7973 7465 r all.file syste │ │ │ │ │ -00000f70: 6d73 2c20 6974 7320 6e61 6d65 2069 7320 ms, its name is │ │ │ │ │ -00000f80: 7072 6566 6978 6564 2077 6974 6820 6772 prefixed with gr │ │ │ │ │ -00000f90: 7562 5f66 735f 6661 745f 2e20 2054 6865 ub_fs_fat_. The │ │ │ │ │ -00000fa0: 2068 6965 7261 7263 6879 2069 730a 6e6f hierarchy is.no │ │ │ │ │ -00000fb0: 7465 6420 7468 6973 2077 6179 2e0a 0a20 ted this way... │ │ │ │ │ -00000fc0: 2020 4166 7465 7220 6120 7072 6566 6978 After a prefix │ │ │ │ │ -00000fd0: 2c20 6120 6675 6e63 7469 6f6e 206e 616d , a function nam │ │ │ │ │ -00000fe0: 6520 6d75 7374 2073 7461 7274 2077 6974 e must start wit │ │ │ │ │ -00000ff0: 6820 6120 7665 7262 2028 7375 6368 2061 h a verb (such a │ │ │ │ │ -00001000: 7320 6765 740a 6f72 2069 7329 2e20 2049 s get.or is). I │ │ │ │ │ -00001010: 7420 6d75 7374 206e 6f74 2062 6520 6120 t must not be a │ │ │ │ │ -00001020: 6e6f 756e 2e20 2053 6f6d 6520 6b69 6e64 noun. Some kind │ │ │ │ │ -00001030: 206f 6620 6162 6272 6576 6961 7469 6f6e of abbreviation │ │ │ │ │ -00001040: 2069 7320 7065 726d 6974 7465 642c 0a61 is permitted,.a │ │ │ │ │ -00001050: 7320 6c6f 6e67 2061 7320 6974 2077 6f75 s long as it wou │ │ │ │ │ -00001060: 6c64 6e27 7420 6d61 6b65 2063 6f64 6520 ldn't make code │ │ │ │ │ -00001070: 6c65 7373 2072 6561 6461 626c 6520 2865 less readable (e │ │ │ │ │ -00001080: 2e67 2e20 2069 6e69 7429 2e0a 0a20 2020 .g. init)... │ │ │ │ │ -00001090: 4966 2061 2066 756e 6374 696f 6e20 6973 If a function is │ │ │ │ │ -000010a0: 206c 6f63 616c 2c20 6974 7320 6e61 6d65 local, its name │ │ │ │ │ -000010b0: 206d 6179 206e 6f74 2073 7461 7274 2077 may not start w │ │ │ │ │ -000010c0: 6974 6820 616e 7920 7072 6566 6978 2e20 ith any prefix. │ │ │ │ │ -000010d0: 2049 740a 6d75 7374 2073 7461 7274 2077 It.must start w │ │ │ │ │ -000010e0: 6974 6820 6120 7665 7262 2e0a 0a1f 0a46 ith a verb.....F │ │ │ │ │ -000010f0: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ │ -00001100: 666f 2c20 204e 6f64 653a 2056 6172 6961 fo, Node: Varia │ │ │ │ │ -00001110: 626c 6573 2c20 204e 6578 743a 2054 7970 bles, Next: Typ │ │ │ │ │ -00001120: 6573 2c20 2050 7265 763a 2046 756e 6374 es, Prev: Funct │ │ │ │ │ -00001130: 696f 6e73 2c20 2055 703a 2043 6f64 696e ions, Up: Codin │ │ │ │ │ -00001140: 6720 7374 796c 650a 0a32 2e33 2056 6172 g style..2.3 Var │ │ │ │ │ -00001150: 6961 626c 6573 0a3d 3d3d 3d3d 3d3d 3d3d iables.========= │ │ │ │ │ -00001160: 3d3d 3d3d 0a0a 5468 6520 7275 6c65 2069 ====..The rule i │ │ │ │ │ -00001170: 7320 6d6f 7374 6c79 2074 6865 2073 616d s mostly the sam │ │ │ │ │ -00001180: 6520 6173 2066 756e 6374 696f 6e73 2c20 e as functions, │ │ │ │ │ -00001190: 6173 206e 6f74 6564 2061 626f 7665 2e20 as noted above. │ │ │ │ │ -000011a0: 2049 6620 6120 7661 7269 6162 6c65 0a69 If a variable.i │ │ │ │ │ -000011b0: 7320 676c 6f62 616c 2c20 6974 7320 6e61 s global, its na │ │ │ │ │ -000011c0: 6d65 206d 7573 7420 6265 2070 7265 6669 me must be prefi │ │ │ │ │ -000011d0: 7865 6420 7769 7468 2067 7275 625f 2061 xed with grub_ a │ │ │ │ │ -000011e0: 6e64 206d 7573 7420 636f 6e73 6973 7420 nd must consist │ │ │ │ │ -000011f0: 6f66 206f 6e6c 790a 736d 616c 6c20 6c65 of only.small le │ │ │ │ │ -00001200: 7474 6572 732e 2020 4966 2074 6865 2076 tters. If the v │ │ │ │ │ -00001210: 6172 6961 626c 6520 6265 6c6f 6e67 7320 ariable belongs │ │ │ │ │ -00001220: 746f 2061 2073 7065 6369 6669 6320 6675 to a specific fu │ │ │ │ │ -00001230: 6e63 7469 6f6e 206d 6f64 756c 652c 0a74 nction module,.t │ │ │ │ │ -00001240: 6865 206e 616d 6520 6d75 7374 2061 6c73 he name must als │ │ │ │ │ -00001250: 6f20 6265 2070 7265 6669 7865 6420 7769 o be prefixed wi │ │ │ │ │ -00001260: 7468 2074 6865 206d 6f64 756c 6520 6e61 th the module na │ │ │ │ │ -00001270: 6d65 2e20 2046 6f72 2065 7861 6d70 6c65 me. For example │ │ │ │ │ -00001280: 2c20 6966 2061 0a66 756e 6374 696f 6e20 , if a.function │ │ │ │ │ -00001290: 6973 2066 6f72 2064 796e 616d 6963 206c is for dynamic l │ │ │ │ │ -000012a0: 6f61 6469 6e67 2c20 6974 7320 6e61 6d65 oading, its name │ │ │ │ │ -000012b0: 2069 7320 7072 6566 6978 6564 2077 6974 is prefixed wit │ │ │ │ │ -000012c0: 6820 6772 7562 5f64 6c5f 2e20 2049 660a h grub_dl_. If. │ │ │ │ │ -000012d0: 6120 7661 7269 6162 6c65 2069 7320 666f a variable is fo │ │ │ │ │ -000012e0: 7220 454c 4620 6275 7420 6e6f 7420 666f r ELF but not fo │ │ │ │ │ -000012f0: 7220 616c 6c20 6479 6e61 6d69 6320 6c6f r all dynamic lo │ │ │ │ │ -00001300: 6164 696e 6720 7379 7374 656d 732c 2069 ading systems, i │ │ │ │ │ -00001310: 7473 206e 616d 650a 6973 2070 7265 6669 ts name.is prefi │ │ │ │ │ -00001320: 7865 6420 7769 7468 2067 7275 625f 646c xed with grub_dl │ │ │ │ │ -00001330: 5f65 6c66 5f2e 0a0a 2020 2041 6674 6572 _elf_... After │ │ │ │ │ -00001340: 2061 2070 7265 6669 782c 2061 2076 6172 a prefix, a var │ │ │ │ │ -00001350: 6961 626c 6520 6e61 6d65 206d 7573 7420 iable name must │ │ │ │ │ -00001360: 7374 6172 7420 7769 7468 2061 206e 6f75 start with a nou │ │ │ │ │ -00001370: 6e20 6f72 2061 6e0a 6164 6a65 6374 6976 n or an.adjectiv │ │ │ │ │ -00001380: 6520 2873 7563 6820 6173 206e 616d 6520 e (such as name │ │ │ │ │ -00001390: 6f72 206c 6f6e 6729 2061 6e64 2069 7420 or long) and it │ │ │ │ │ -000013a0: 7368 6f75 6c64 2065 6e64 2077 6974 6820 should end with │ │ │ │ │ -000013b0: 6120 6e6f 756e 2e20 2053 6f6d 650a 6b69 a noun. Some.ki │ │ │ │ │ -000013c0: 6e64 206f 6620 6162 6272 6576 6961 7469 nd of abbreviati │ │ │ │ │ -000013d0: 6f6e 2069 7320 7065 726d 6974 7465 642c on is permitted, │ │ │ │ │ -000013e0: 2061 7320 6c6f 6e67 2061 7320 6974 2077 as long as it w │ │ │ │ │ -000013f0: 6f75 6c64 6e27 7420 6d61 6b65 2063 6f64 ouldn't make cod │ │ │ │ │ -00001400: 6520 6c65 7373 0a72 6561 6461 626c 6520 e less.readable │ │ │ │ │ -00001410: 2865 2e67 2e20 2069 3138 6e29 2e0a 0a20 (e.g. i18n)... │ │ │ │ │ -00001420: 2020 4966 2061 2076 6172 6961 626c 6520 If a variable │ │ │ │ │ -00001430: 6973 2067 6c6f 6261 6c20 696e 2074 6865 is global in the │ │ │ │ │ -00001440: 2073 636f 7065 206f 6620 6120 7369 6e67 scope of a sing │ │ │ │ │ -00001450: 6c65 2066 696c 6520 2869 2e65 2e20 2069 le file (i.e. i │ │ │ │ │ -00001460: 7420 6973 0a64 6563 6c61 7265 6420 7769 t is.declared wi │ │ │ │ │ -00001470: 7468 2073 7461 7469 6329 2c20 6974 7320 th static), its │ │ │ │ │ -00001480: 6e61 6d65 206d 6179 206e 6f74 2073 7461 name may not sta │ │ │ │ │ -00001490: 7274 2077 6974 6820 616e 7920 7072 6566 rt with any pref │ │ │ │ │ -000014a0: 6978 2e20 2049 7420 6d75 7374 0a73 7461 ix. It must.sta │ │ │ │ │ -000014b0: 7274 2077 6974 6820 6120 6e6f 756e 206f rt with a noun o │ │ │ │ │ -000014c0: 7220 616e 2061 646a 6563 7469 7665 2e0a r an adjective.. │ │ │ │ │ -000014d0: 0a20 2020 4966 2061 2076 6172 6961 626c . If a variabl │ │ │ │ │ -000014e0: 6520 6973 206c 6f63 616c 2c20 796f 7520 e is local, you │ │ │ │ │ -000014f0: 6d61 7920 6368 6f6f 7365 2061 6e79 2073 may choose any s │ │ │ │ │ -00001500: 686f 7274 6572 206e 616d 652c 2061 7320 horter name, as │ │ │ │ │ -00001510: 6c6f 6e67 2061 730a 6974 2077 6f75 6c64 long as.it would │ │ │ │ │ -00001520: 6e27 7420 6d61 6b65 2063 6f64 6520 6c65 n't make code le │ │ │ │ │ -00001530: 7373 2072 6561 6461 626c 6520 2865 2e67 ss readable (e.g │ │ │ │ │ -00001540: 2e20 2069 292e 0a0a 1f0a 4669 6c65 3a20 . i).....File: │ │ │ │ │ -00001550: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ -00001560: 4e6f 6465 3a20 5479 7065 732c 2020 4e65 Node: Types, Ne │ │ │ │ │ -00001570: 7874 3a20 4d61 6372 6f73 2c20 2050 7265 xt: Macros, Pre │ │ │ │ │ -00001580: 763a 2056 6172 6961 626c 6573 2c20 2055 v: Variables, U │ │ │ │ │ -00001590: 703a 2043 6f64 696e 6720 7374 796c 650a p: Coding style. │ │ │ │ │ -000015a0: 0a32 2e34 2054 7970 6573 0a3d 3d3d 3d3d .2.4 Types.===== │ │ │ │ │ -000015b0: 3d3d 3d3d 0a0a 5468 6520 6e61 6d65 206f ====..The name o │ │ │ │ │ -000015c0: 6620 6120 7479 7065 206d 7573 7420 6265 f a type must be │ │ │ │ │ -000015d0: 2070 7265 6669 7865 6420 7769 7468 2067 prefixed with g │ │ │ │ │ -000015e0: 7275 625f 2061 6e64 206d 7573 7420 636f rub_ and must co │ │ │ │ │ -000015f0: 6e73 6973 7420 6f66 206f 6e6c 790a 736d nsist of only.sm │ │ │ │ │ -00001600: 616c 6c20 6c65 7474 6572 732e 2020 4966 all letters. If │ │ │ │ │ -00001610: 2074 6865 2074 7970 6520 6265 6c6f 6e67 the type belong │ │ │ │ │ -00001620: 7320 746f 2061 2073 7065 6369 6669 6320 s to a specific │ │ │ │ │ -00001630: 6675 6e63 7469 6f6e 206d 6f64 756c 652c function module, │ │ │ │ │ -00001640: 2074 6865 0a6e 616d 6520 6d75 7374 2061 the.name must a │ │ │ │ │ -00001650: 6c73 6f20 6265 2070 7265 6669 7865 6420 lso be prefixed │ │ │ │ │ -00001660: 7769 7468 2074 6865 206d 6f64 756c 6520 with the module │ │ │ │ │ -00001670: 6e61 6d65 2e20 2046 6f72 2065 7861 6d70 name. For examp │ │ │ │ │ -00001680: 6c65 2c20 6966 2061 2074 7970 650a 6973 le, if a type.is │ │ │ │ │ -00001690: 2066 6f72 204f 5320 6c6f 6164 6572 732c for OS loaders, │ │ │ │ │ -000016a0: 2069 7473 206e 616d 6520 6973 2070 7265 its name is pre │ │ │ │ │ -000016b0: 6669 7865 6420 7769 7468 2067 7275 625f fixed with grub_ │ │ │ │ │ -000016c0: 6c6f 6164 6572 5f2e 2020 4966 2061 2074 loader_. If a t │ │ │ │ │ -000016d0: 7970 6520 6973 0a66 6f72 204d 756c 7469 ype is.for Multi │ │ │ │ │ -000016e0: 626f 6f74 2062 7574 206e 6f74 2066 6f72 boot but not for │ │ │ │ │ -000016f0: 2061 6c6c 204f 5320 6c6f 6164 6572 732c all OS loaders, │ │ │ │ │ -00001700: 2069 7473 206e 616d 6520 6973 2070 7265 its name is pre │ │ │ │ │ -00001710: 6669 7865 6420 7769 7468 0a67 7275 625f fixed with.grub_ │ │ │ │ │ -00001720: 6c6f 6164 6572 5f6c 696e 7578 5f2e 0a0a loader_linux_... │ │ │ │ │ -00001730: 2020 2054 6865 206e 616d 6520 6d75 7374 The name must │ │ │ │ │ -00001740: 2062 6520 7375 6666 6978 6564 2077 6974 be suffixed wit │ │ │ │ │ -00001750: 6820 5f74 2c20 746f 2065 6d70 6861 7369 h _t, to emphasi │ │ │ │ │ -00001760: 7a65 2074 6865 2066 6163 7420 7468 6174 ze the fact that │ │ │ │ │ -00001770: 2069 7420 6973 2061 0a74 7970 6520 6275 it is a.type bu │ │ │ │ │ -00001780: 7420 6e6f 7420 6120 7661 7269 6162 6c65 t not a variable │ │ │ │ │ -00001790: 206f 7220 6120 6675 6e63 7469 6f6e 2e0a or a function.. │ │ │ │ │ -000017a0: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ │ -000017b0: 762e 696e 666f 2c20 204e 6f64 653a 204d v.info, Node: M │ │ │ │ │ -000017c0: 6163 726f 732c 2020 4e65 7874 3a20 436f acros, Next: Co │ │ │ │ │ -000017d0: 6d6d 656e 7473 2c20 2050 7265 763a 2054 mments, Prev: T │ │ │ │ │ -000017e0: 7970 6573 2c20 2055 703a 2043 6f64 696e ypes, Up: Codin │ │ │ │ │ -000017f0: 6720 7374 796c 650a 0a32 2e35 204d 6163 g style..2.5 Mac │ │ │ │ │ -00001800: 726f 730a 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ros.==========.. │ │ │ │ │ -00001810: 4966 2061 206d 6163 726f 2069 7320 676c If a macro is gl │ │ │ │ │ -00001820: 6f62 616c 2c20 6974 7320 6e61 6d65 206d obal, its name m │ │ │ │ │ -00001830: 7573 7420 6265 2070 7265 6669 7865 6420 ust be prefixed │ │ │ │ │ -00001840: 7769 7468 2047 5255 425f 2061 6e64 206d with GRUB_ and m │ │ │ │ │ -00001850: 7573 740a 636f 6e73 6973 7420 6f66 206f ust.consist of o │ │ │ │ │ -00001860: 6e6c 7920 6c61 7267 6520 6c65 7474 6572 nly large letter │ │ │ │ │ -00001870: 732e 2020 4f74 6865 7220 7275 6c65 7320 s. Other rules │ │ │ │ │ -00001880: 6172 6520 7468 6520 7361 6d65 2061 7320 are the same as │ │ │ │ │ -00001890: 6675 6e63 7469 6f6e 7320 6f72 0a76 6172 functions or.var │ │ │ │ │ -000018a0: 6961 626c 6573 2c20 6465 7065 6e64 696e iables, dependin │ │ │ │ │ -000018b0: 6720 6f6e 2077 6865 7468 6572 2061 206d g on whether a m │ │ │ │ │ -000018c0: 6163 726f 2069 7320 7573 6564 206c 696b acro is used lik │ │ │ │ │ -000018d0: 6520 6120 6675 6e63 7469 6f6e 206f 7220 e a function or │ │ │ │ │ -000018e0: 610a 7661 7269 6162 6c65 2e0a 0a1f 0a46 a.variable.....F │ │ │ │ │ -000018f0: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ │ -00001900: 666f 2c20 204e 6f64 653a 2043 6f6d 6d65 fo, Node: Comme │ │ │ │ │ -00001910: 6e74 732c 2020 4e65 7874 3a20 4d75 6c74 nts, Next: Mult │ │ │ │ │ -00001920: 692d 4c69 6e65 2043 6f6d 6d65 6e74 732c i-Line Comments, │ │ │ │ │ -00001930: 2020 5072 6576 3a20 4d61 6372 6f73 2c20 Prev: Macros, │ │ │ │ │ -00001940: 2055 703a 2043 6f64 696e 6720 7374 796c Up: Coding styl │ │ │ │ │ -00001950: 650a 0a32 2e36 2043 6f6d 6d65 6e74 730a e..2.6 Comments. │ │ │ │ │ -00001960: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 416c ============..Al │ │ │ │ │ -00001970: 6c20 636f 6d6d 656e 7473 2073 6861 6c6c l comments shall │ │ │ │ │ -00001980: 2062 6520 432d 7374 796c 6520 636f 6d6d be C-style comm │ │ │ │ │ -00001990: 656e 7473 2c20 6f66 2074 6865 2066 6f72 ents, of the for │ │ │ │ │ -000019a0: 6d20 272f 2a20 2e2e 2e20 2a2f 272e 2020 m '/* ... */'. │ │ │ │ │ -000019b0: 410a 636f 6d6d 656e 7420 6361 6e20 6265 A.comment can be │ │ │ │ │ -000019c0: 2070 6c61 6365 6420 696d 6d65 6469 6174 placed immediat │ │ │ │ │ -000019d0: 656c 7920 7072 6563 6564 696e 6720 7468 ely preceding th │ │ │ │ │ -000019e0: 6520 656e 7469 7479 2069 7420 6465 7363 e entity it desc │ │ │ │ │ -000019f0: 7269 6265 7320 6f72 0a69 7420 6361 6e20 ribes or.it can │ │ │ │ │ -00001a00: 6265 2070 6c61 6365 6420 746f 6765 7468 be placed togeth │ │ │ │ │ -00001a10: 6572 2077 6974 6820 636f 6465 2c20 7661 er with code, va │ │ │ │ │ -00001a20: 7269 6162 6c65 2064 6563 6c61 7261 7469 riable declarati │ │ │ │ │ -00001a30: 6f6e 732c 206f 7220 6f74 6865 720a 6e6f ons, or other.no │ │ │ │ │ -00001a40: 6e2d 636f 6d6d 656e 7420 656e 7469 7469 n-comment entiti │ │ │ │ │ -00001a50: 6573 2e20 2048 6f77 6576 6572 2c20 6974 es. However, it │ │ │ │ │ -00001a60: 2069 7320 7265 636f 6d6d 656e 6465 6420 is recommended │ │ │ │ │ -00001a70: 746f 206e 6f74 206d 6978 2076 6172 696f to not mix vario │ │ │ │ │ -00001a80: 7573 0a66 6f72 6d73 2065 7370 6563 6961 us.forms especia │ │ │ │ │ -00001a90: 6c6c 7920 696e 2074 7970 6573 2f73 7472 lly in types/str │ │ │ │ │ -00001aa0: 7563 7473 2064 6573 6372 6970 7469 6f6e ucts description │ │ │ │ │ -00001ab0: 732e 0a0a 2020 2041 6363 6570 7461 626c s... Acceptabl │ │ │ │ │ -00001ac0: 653a 0a20 2020 2020 2f2a 2054 6865 2070 e:. /* The p │ │ │ │ │ -00001ad0: 6167 6520 2320 7468 6174 2069 7320 7468 age # that is th │ │ │ │ │ -00001ae0: 6520 6672 6f6e 7420 6275 6666 6572 2e20 e front buffer. │ │ │ │ │ -00001af0: 2a2f 0a20 2020 2020 696e 7420 6469 7370 */. int disp │ │ │ │ │ -00001b00: 6c61 7965 645f 7061 6765 3b0a 0a20 2020 layed_page;.. │ │ │ │ │ -00001b10: 2020 696e 7420 7265 6e64 6572 5f70 6167 int render_pag │ │ │ │ │ -00001b20: 653b 202f 2a20 5468 6520 7061 6765 2023 e; /* The page # │ │ │ │ │ -00001b30: 2074 6861 7420 6973 2074 6865 2062 6163 that is the bac │ │ │ │ │ -00001b40: 6b20 6275 6666 6572 2e20 2a2f 0a0a 1f0a k buffer. */.... │ │ │ │ │ -00001b50: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ │ -00001b60: 6e66 6f2c 2020 4e6f 6465 3a20 4d75 6c74 nfo, Node: Mult │ │ │ │ │ -00001b70: 692d 4c69 6e65 2043 6f6d 6d65 6e74 732c i-Line Comments, │ │ │ │ │ -00001b80: 2020 5072 6576 3a20 436f 6d6d 656e 7473 Prev: Comments │ │ │ │ │ -00001b90: 2c20 2055 703a 2043 6f64 696e 6720 7374 , Up: Coding st │ │ │ │ │ -00001ba0: 796c 650a 0a32 2e37 204d 756c 7469 2d4c yle..2.7 Multi-L │ │ │ │ │ -00001bb0: 696e 6520 436f 6d6d 656e 7473 0a3d 3d3d ine Comments.=== │ │ │ │ │ +000007a0: 2a2a 2a0a 0a47 5255 4220 6973 206d 6169 ***..GRUB is mai │ │ │ │ │ +000007b0: 6e74 6169 6e65 6420 7573 696e 6720 7468 ntained using th │ │ │ │ │ +000007c0: 6520 3c47 4954 2072 6576 6973 696f 6e20 e . │ │ │ │ │ +000007e0: 2020 546f 2066 6574 6368 3a0a 0a20 2020 To fetch:.. │ │ │ │ │ +000007f0: 2020 6769 7420 636c 6f6e 6520 6769 743a git clone git: │ │ │ │ │ +00000800: 2f2f 6769 742e 7376 2e67 6e75 2e6f 7267 //git.sv.gnu.org │ │ │ │ │ +00000810: 2f67 7275 622e 6769 740a 0a20 2020 5765 /grub.git.. We │ │ │ │ │ +00000820: 6220 6163 6365 7373 2069 7320 6176 6169 b access is avai │ │ │ │ │ +00000830: 6c61 626c 6520 756e 6465 720a 2020 2020 lable under. │ │ │ │ │ +00000840: 2068 7474 703a 2f2f 6769 742e 7361 7661 http://git.sava │ │ │ │ │ +00000850: 6e6e 6168 2e67 6e75 2e6f 7267 2f63 6769 nnah.gnu.org/cgi │ │ │ │ │ +00000860: 742f 6772 7562 2e67 6974 2f0a 0a20 2020 t/grub.git/.. │ │ │ │ │ +00000870: 5468 6520 6272 616e 6368 6573 2061 7661 The branches ava │ │ │ │ │ +00000880: 696c 6162 6c65 2061 7265 3a0a 0a27 6d61 ilable are:..'ma │ │ │ │ │ +00000890: 7374 6572 270a 2020 2020 204d 6169 6e20 ster'. Main │ │ │ │ │ +000008a0: 6465 7665 6c6f 706d 656e 7420 6272 616e development bran │ │ │ │ │ +000008b0: 6368 2e0a 2767 7275 622d 6c65 6761 6379 ch..'grub-legacy │ │ │ │ │ +000008c0: 270a 2020 2020 2047 5255 4220 302e 3937 '. GRUB 0.97 │ │ │ │ │ +000008d0: 2063 6f64 6562 6173 652e 2020 4b65 7074 codebase. Kept │ │ │ │ │ +000008e0: 2066 6f72 2072 6566 6572 656e 6365 2061 for reference a │ │ │ │ │ +000008f0: 6e64 206c 6567 616c 2072 6561 736f 6e73 nd legal reasons │ │ │ │ │ +00000900: 0a27 6d75 6c74 6962 6f6f 7427 0a20 2020 .'multiboot'. │ │ │ │ │ +00000910: 2020 4d75 6c74 6962 6f6f 7420 7370 6563 Multiboot spec │ │ │ │ │ +00000920: 6669 6361 7469 6f6e 0a27 6d75 6c74 6962 fication.'multib │ │ │ │ │ +00000930: 6f6f 7432 270a 2020 2020 204d 756c 7469 oot2'. Multi │ │ │ │ │ +00000940: 626f 6f74 3220 7370 6563 6669 6361 7469 boot2 specficati │ │ │ │ │ +00000950: 6f6e 0a27 6465 7665 6c6f 7065 7220 6272 on.'developer br │ │ │ │ │ +00000960: 616e 6368 6573 270a 2020 2020 2050 7265 anches'. Pre │ │ │ │ │ +00000970: 6669 7865 6420 7769 7468 2064 6576 656c fixed with devel │ │ │ │ │ +00000980: 6f70 6572 206e 616d 652e 2020 4576 6572 oper name. Ever │ │ │ │ │ +00000990: 7920 6465 7665 6c6f 7065 7220 6f66 2061 y developer of a │ │ │ │ │ +000009a0: 2074 6561 6d20 6d61 6e61 6765 730a 2020 team manages. │ │ │ │ │ +000009b0: 2020 2068 6973 206f 776e 2062 7261 6e63 his own branc │ │ │ │ │ +000009c0: 6865 732e 2020 4465 7665 6c6f 7065 7220 hes. Developer │ │ │ │ │ +000009d0: 6272 616e 6368 6573 2064 6f20 6e6f 7420 branches do not │ │ │ │ │ +000009e0: 6e65 6564 2063 6861 6e67 656c 6f67 0a20 need changelog. │ │ │ │ │ +000009f0: 2020 2020 656e 7472 6965 732e 0a0a 2020 entries... │ │ │ │ │ +00000a00: 204f 6e63 6520 796f 7520 6861 7665 2075 Once you have u │ │ │ │ │ +00000a10: 7365 6420 2767 6974 2063 6c6f 6e65 2720 sed 'git clone' │ │ │ │ │ +00000a20: 746f 2066 6574 6368 2061 6e20 696e 6974 to fetch an init │ │ │ │ │ +00000a30: 6961 6c20 636f 7079 206f 6620 6120 6272 ial copy of a br │ │ │ │ │ +00000a40: 616e 6368 2c0a 796f 7520 6361 6e20 7573 anch,.you can us │ │ │ │ │ +00000a50: 6520 2767 6974 2070 756c 6c27 2074 6f20 e 'git pull' to │ │ │ │ │ +00000a60: 6b65 6570 2069 7420 7570 2074 6f20 6461 keep it up to da │ │ │ │ │ +00000a70: 7465 2e20 2049 6620 796f 7520 6861 7665 te. If you have │ │ │ │ │ +00000a80: 206d 6f64 6966 6965 6420 796f 7572 0a6c modified your.l │ │ │ │ │ +00000a90: 6f63 616c 2076 6572 7369 6f6e 2c20 796f ocal version, yo │ │ │ │ │ +00000aa0: 7520 6d61 7920 6e65 6564 2074 6f20 7265 u may need to re │ │ │ │ │ +00000ab0: 736f 6c76 6520 636f 6e66 6c69 6374 7320 solve conflicts │ │ │ │ │ +00000ac0: 7768 656e 2070 756c 6c69 6e67 2e0a 0a1f when pulling.... │ │ │ │ │ +00000ad0: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ +00000ae0: 696e 666f 2c20 204e 6f64 653a 2043 6f64 info, Node: Cod │ │ │ │ │ +00000af0: 696e 6720 7374 796c 652c 2020 4e65 7874 ing style, Next │ │ │ │ │ +00000b00: 3a20 4669 6e64 696e 6720 796f 7572 2077 : Finding your w │ │ │ │ │ +00000b10: 6179 2061 726f 756e 642c 2020 5072 6576 ay around, Prev │ │ │ │ │ +00000b20: 3a20 4765 7474 696e 6720 7468 6520 736f : Getting the so │ │ │ │ │ +00000b30: 7572 6365 2063 6f64 652c 2020 5570 3a20 urce code, Up: │ │ │ │ │ +00000b40: 546f 700a 0a32 2043 6f64 696e 6720 7374 Top..2 Coding st │ │ │ │ │ +00000b50: 796c 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a yle.************ │ │ │ │ │ +00000b60: 2a2a 0a0a 4261 7369 6361 6c6c 7920 7765 **..Basically we │ │ │ │ │ +00000b70: 2066 6f6c 6c6f 7720 7468 6520 474e 5520 follow the GNU │ │ │ │ │ +00000b80: 436f 6469 6e67 2053 7461 6e64 6172 6473 Coding Standards │ │ │ │ │ +00000b90: 0a28 6874 7470 3a2f 2f77 7777 2e67 6e75 .(http://www.gnu │ │ │ │ │ +00000ba0: 2e6f 7267 2f70 7265 702f 7374 616e 6461 .org/prep/standa │ │ │ │ │ +00000bb0: 7264 735f 746f 632e 6874 6d6c 292e 2020 rds_toc.html). │ │ │ │ │ +00000bc0: 5765 2064 6566 696e 6520 6164 6469 7469 We define additi │ │ │ │ │ +00000bd0: 6f6e 616c 0a63 6f6e 7665 6e74 696f 6e73 onal.conventions │ │ │ │ │ +00000be0: 2066 6f72 2047 5255 4220 6865 7265 2e0a for GRUB here.. │ │ │ │ │ +00000bf0: 0a2a 204d 656e 753a 0a0a 2a20 4e61 6d69 .* Menu:..* Nami │ │ │ │ │ +00000c00: 6e67 2043 6f6e 7665 6e74 696f 6e73 3a3a ng Conventions:: │ │ │ │ │ +00000c10: 0a2a 2046 756e 6374 696f 6e73 3a3a 0a2a .* Functions::.* │ │ │ │ │ +00000c20: 2056 6172 6961 626c 6573 3a3a 0a2a 2054 Variables::.* T │ │ │ │ │ +00000c30: 7970 6573 3a3a 0a2a 204d 6163 726f 733a ypes::.* Macros: │ │ │ │ │ +00000c40: 3a0a 2a20 436f 6d6d 656e 7473 3a3a 0a2a :.* Comments::.* │ │ │ │ │ +00000c50: 204d 756c 7469 2d4c 696e 6520 436f 6d6d Multi-Line Comm │ │ │ │ │ +00000c60: 656e 7473 3a3a 0a0a 1f0a 4669 6c65 3a20 ents::....File: │ │ │ │ │ +00000c70: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ +00000c80: 4e6f 6465 3a20 4e61 6d69 6e67 2043 6f6e Node: Naming Con │ │ │ │ │ +00000c90: 7665 6e74 696f 6e73 2c20 204e 6578 743a ventions, Next: │ │ │ │ │ +00000ca0: 2046 756e 6374 696f 6e73 2c20 2055 703a Functions, Up: │ │ │ │ │ +00000cb0: 2043 6f64 696e 6720 7374 796c 650a 0a32 Coding style..2 │ │ │ │ │ +00000cc0: 2e31 204e 616d 696e 6720 436f 6e76 656e .1 Naming Conven │ │ │ │ │ +00000cd0: 7469 6f6e 730a 3d3d 3d3d 3d3d 3d3d 3d3d tions.========== │ │ │ │ │ +00000ce0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 416c ============..Al │ │ │ │ │ +00000cf0: 6c20 676c 6f62 616c 2073 796d 626f 6c73 l global symbols │ │ │ │ │ +00000d00: 2028 692e 652e 2020 6675 6e63 7469 6f6e (i.e. function │ │ │ │ │ +00000d10: 732c 2076 6172 6961 626c 6573 2c20 7479 s, variables, ty │ │ │ │ │ +00000d20: 7065 732c 2061 6e64 206d 6163 726f 7329 pes, and macros) │ │ │ │ │ +00000d30: 206d 7573 740a 6861 7665 2074 6865 2070 must.have the p │ │ │ │ │ +00000d40: 7265 6669 7820 6772 7562 5f20 6f72 2047 refix grub_ or G │ │ │ │ │ +00000d50: 5255 425f 2e20 2054 6865 2061 6c6c 2063 RUB_. The all c │ │ │ │ │ +00000d60: 6170 6974 616c 2066 6f72 6d20 6973 2075 apital form is u │ │ │ │ │ +00000d70: 7365 6420 6f6e 6c79 2062 790a 6d61 6372 sed only by.macr │ │ │ │ │ +00000d80: 6f73 2e0a 0a1f 0a46 696c 653a 2067 7275 os.....File: gru │ │ │ │ │ +00000d90: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +00000da0: 653a 2046 756e 6374 696f 6e73 2c20 204e e: Functions, N │ │ │ │ │ +00000db0: 6578 743a 2056 6172 6961 626c 6573 2c20 ext: Variables, │ │ │ │ │ +00000dc0: 2050 7265 763a 204e 616d 696e 6720 436f Prev: Naming Co │ │ │ │ │ +00000dd0: 6e76 656e 7469 6f6e 732c 2020 5570 3a20 nventions, Up: │ │ │ │ │ +00000de0: 436f 6469 6e67 2073 7479 6c65 0a0a 322e Coding style..2. │ │ │ │ │ +00000df0: 3220 4675 6e63 7469 6f6e 730a 3d3d 3d3d 2 Functions.==== │ │ │ │ │ +00000e00: 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 6620 6120 =========..If a │ │ │ │ │ +00000e10: 6675 6e63 7469 6f6e 2069 7320 676c 6f62 function is glob │ │ │ │ │ +00000e20: 616c 2c20 6974 7320 6e61 6d65 206d 7573 al, its name mus │ │ │ │ │ +00000e30: 7420 6265 2070 7265 6669 7865 6420 7769 t be prefixed wi │ │ │ │ │ +00000e40: 7468 2067 7275 625f 2061 6e64 206d 7573 th grub_ and mus │ │ │ │ │ +00000e50: 740a 636f 6e73 6973 7420 6f66 206f 6e6c t.consist of onl │ │ │ │ │ +00000e60: 7920 736d 616c 6c20 6c65 7474 6572 732e y small letters. │ │ │ │ │ +00000e70: 2020 4966 2074 6865 2066 756e 6374 696f If the functio │ │ │ │ │ +00000e80: 6e20 6265 6c6f 6e67 7320 746f 2061 2073 n belongs to a s │ │ │ │ │ +00000e90: 7065 6369 6669 630a 6675 6e63 7469 6f6e pecific.function │ │ │ │ │ +00000ea0: 206d 6f64 756c 652c 2074 6865 206e 616d module, the nam │ │ │ │ │ +00000eb0: 6520 6d75 7374 2061 6c73 6f20 6265 2070 e must also be p │ │ │ │ │ +00000ec0: 7265 6669 7865 6420 7769 7468 2074 6865 refixed with the │ │ │ │ │ +00000ed0: 206d 6f64 756c 6520 6e61 6d65 2e0a 466f module name..Fo │ │ │ │ │ +00000ee0: 7220 6578 616d 706c 652c 2069 6620 6120 r example, if a │ │ │ │ │ +00000ef0: 6675 6e63 7469 6f6e 2069 7320 666f 7220 function is for │ │ │ │ │ +00000f00: 6669 6c65 2073 7973 7465 6d73 2c20 6974 file systems, it │ │ │ │ │ +00000f10: 7320 6e61 6d65 2069 7320 7072 6566 6978 s name is prefix │ │ │ │ │ +00000f20: 6564 0a77 6974 6820 6772 7562 5f66 735f ed.with grub_fs_ │ │ │ │ │ +00000f30: 2e20 2049 6620 6120 6675 6e63 7469 6f6e . If a function │ │ │ │ │ +00000f40: 2069 7320 666f 7220 4641 5420 6669 6c65 is for FAT file │ │ │ │ │ +00000f50: 2073 7973 7465 6d20 6275 7420 6e6f 7420 system but not │ │ │ │ │ +00000f60: 666f 7220 616c 6c0a 6669 6c65 2073 7973 for all.file sys │ │ │ │ │ +00000f70: 7465 6d73 2c20 6974 7320 6e61 6d65 2069 tems, its name i │ │ │ │ │ +00000f80: 7320 7072 6566 6978 6564 2077 6974 6820 s prefixed with │ │ │ │ │ +00000f90: 6772 7562 5f66 735f 6661 745f 2e20 2054 grub_fs_fat_. T │ │ │ │ │ +00000fa0: 6865 2068 6965 7261 7263 6879 2069 730a he hierarchy is. │ │ │ │ │ +00000fb0: 6e6f 7465 6420 7468 6973 2077 6179 2e0a noted this way.. │ │ │ │ │ +00000fc0: 0a20 2020 4166 7465 7220 6120 7072 6566 . After a pref │ │ │ │ │ +00000fd0: 6978 2c20 6120 6675 6e63 7469 6f6e 206e ix, a function n │ │ │ │ │ +00000fe0: 616d 6520 6d75 7374 2073 7461 7274 2077 ame must start w │ │ │ │ │ +00000ff0: 6974 6820 6120 7665 7262 2028 7375 6368 ith a verb (such │ │ │ │ │ +00001000: 2061 7320 6765 740a 6f72 2069 7329 2e20 as get.or is). │ │ │ │ │ +00001010: 2049 7420 6d75 7374 206e 6f74 2062 6520 It must not be │ │ │ │ │ +00001020: 6120 6e6f 756e 2e20 2053 6f6d 6520 6b69 a noun. Some ki │ │ │ │ │ +00001030: 6e64 206f 6620 6162 6272 6576 6961 7469 nd of abbreviati │ │ │ │ │ +00001040: 6f6e 2069 7320 7065 726d 6974 7465 642c on is permitted, │ │ │ │ │ +00001050: 0a61 7320 6c6f 6e67 2061 7320 6974 2077 .as long as it w │ │ │ │ │ +00001060: 6f75 6c64 6e27 7420 6d61 6b65 2063 6f64 ouldn't make cod │ │ │ │ │ +00001070: 6520 6c65 7373 2072 6561 6461 626c 6520 e less readable │ │ │ │ │ +00001080: 2865 2e67 2e20 2069 6e69 7429 2e0a 0a20 (e.g. init)... │ │ │ │ │ +00001090: 2020 4966 2061 2066 756e 6374 696f 6e20 If a function │ │ │ │ │ +000010a0: 6973 206c 6f63 616c 2c20 6974 7320 6e61 is local, its na │ │ │ │ │ +000010b0: 6d65 206d 6179 206e 6f74 2073 7461 7274 me may not start │ │ │ │ │ +000010c0: 2077 6974 6820 616e 7920 7072 6566 6978 with any prefix │ │ │ │ │ +000010d0: 2e20 2049 740a 6d75 7374 2073 7461 7274 . It.must start │ │ │ │ │ +000010e0: 2077 6974 6820 6120 7665 7262 2e0a 0a1f with a verb.... │ │ │ │ │ +000010f0: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ +00001100: 696e 666f 2c20 204e 6f64 653a 2056 6172 info, Node: Var │ │ │ │ │ +00001110: 6961 626c 6573 2c20 204e 6578 743a 2054 iables, Next: T │ │ │ │ │ +00001120: 7970 6573 2c20 2050 7265 763a 2046 756e ypes, Prev: Fun │ │ │ │ │ +00001130: 6374 696f 6e73 2c20 2055 703a 2043 6f64 ctions, Up: Cod │ │ │ │ │ +00001140: 696e 6720 7374 796c 650a 0a32 2e33 2056 ing style..2.3 V │ │ │ │ │ +00001150: 6172 6961 626c 6573 0a3d 3d3d 3d3d 3d3d ariables.======= │ │ │ │ │ +00001160: 3d3d 3d3d 3d3d 0a0a 5468 6520 7275 6c65 ======..The rule │ │ │ │ │ +00001170: 2069 7320 6d6f 7374 6c79 2074 6865 2073 is mostly the s │ │ │ │ │ +00001180: 616d 6520 6173 2066 756e 6374 696f 6e73 ame as functions │ │ │ │ │ +00001190: 2c20 6173 206e 6f74 6564 2061 626f 7665 , as noted above │ │ │ │ │ +000011a0: 2e20 2049 6620 6120 7661 7269 6162 6c65 . If a variable │ │ │ │ │ +000011b0: 0a69 7320 676c 6f62 616c 2c20 6974 7320 .is global, its │ │ │ │ │ +000011c0: 6e61 6d65 206d 7573 7420 6265 2070 7265 name must be pre │ │ │ │ │ +000011d0: 6669 7865 6420 7769 7468 2067 7275 625f fixed with grub_ │ │ │ │ │ +000011e0: 2061 6e64 206d 7573 7420 636f 6e73 6973 and must consis │ │ │ │ │ +000011f0: 7420 6f66 206f 6e6c 790a 736d 616c 6c20 t of only.small │ │ │ │ │ +00001200: 6c65 7474 6572 732e 2020 4966 2074 6865 letters. If the │ │ │ │ │ +00001210: 2076 6172 6961 626c 6520 6265 6c6f 6e67 variable belong │ │ │ │ │ +00001220: 7320 746f 2061 2073 7065 6369 6669 6320 s to a specific │ │ │ │ │ +00001230: 6675 6e63 7469 6f6e 206d 6f64 756c 652c function module, │ │ │ │ │ +00001240: 0a74 6865 206e 616d 6520 6d75 7374 2061 .the name must a │ │ │ │ │ +00001250: 6c73 6f20 6265 2070 7265 6669 7865 6420 lso be prefixed │ │ │ │ │ +00001260: 7769 7468 2074 6865 206d 6f64 756c 6520 with the module │ │ │ │ │ +00001270: 6e61 6d65 2e20 2046 6f72 2065 7861 6d70 name. For examp │ │ │ │ │ +00001280: 6c65 2c20 6966 2061 0a66 756e 6374 696f le, if a.functio │ │ │ │ │ +00001290: 6e20 6973 2066 6f72 2064 796e 616d 6963 n is for dynamic │ │ │ │ │ +000012a0: 206c 6f61 6469 6e67 2c20 6974 7320 6e61 loading, its na │ │ │ │ │ +000012b0: 6d65 2069 7320 7072 6566 6978 6564 2077 me is prefixed w │ │ │ │ │ +000012c0: 6974 6820 6772 7562 5f64 6c5f 2e20 2049 ith grub_dl_. I │ │ │ │ │ +000012d0: 660a 6120 7661 7269 6162 6c65 2069 7320 f.a variable is │ │ │ │ │ +000012e0: 666f 7220 454c 4620 6275 7420 6e6f 7420 for ELF but not │ │ │ │ │ +000012f0: 666f 7220 616c 6c20 6479 6e61 6d69 6320 for all dynamic │ │ │ │ │ +00001300: 6c6f 6164 696e 6720 7379 7374 656d 732c loading systems, │ │ │ │ │ +00001310: 2069 7473 206e 616d 650a 6973 2070 7265 its name.is pre │ │ │ │ │ +00001320: 6669 7865 6420 7769 7468 2067 7275 625f fixed with grub_ │ │ │ │ │ +00001330: 646c 5f65 6c66 5f2e 0a0a 2020 2041 6674 dl_elf_... Aft │ │ │ │ │ +00001340: 6572 2061 2070 7265 6669 782c 2061 2076 er a prefix, a v │ │ │ │ │ +00001350: 6172 6961 626c 6520 6e61 6d65 206d 7573 ariable name mus │ │ │ │ │ +00001360: 7420 7374 6172 7420 7769 7468 2061 206e t start with a n │ │ │ │ │ +00001370: 6f75 6e20 6f72 2061 6e0a 6164 6a65 6374 oun or an.adject │ │ │ │ │ +00001380: 6976 6520 2873 7563 6820 6173 206e 616d ive (such as nam │ │ │ │ │ +00001390: 6520 6f72 206c 6f6e 6729 2061 6e64 2069 e or long) and i │ │ │ │ │ +000013a0: 7420 7368 6f75 6c64 2065 6e64 2077 6974 t should end wit │ │ │ │ │ +000013b0: 6820 6120 6e6f 756e 2e20 2053 6f6d 650a h a noun. Some. │ │ │ │ │ +000013c0: 6b69 6e64 206f 6620 6162 6272 6576 6961 kind of abbrevia │ │ │ │ │ +000013d0: 7469 6f6e 2069 7320 7065 726d 6974 7465 tion is permitte │ │ │ │ │ +000013e0: 642c 2061 7320 6c6f 6e67 2061 7320 6974 d, as long as it │ │ │ │ │ +000013f0: 2077 6f75 6c64 6e27 7420 6d61 6b65 2063 wouldn't make c │ │ │ │ │ +00001400: 6f64 6520 6c65 7373 0a72 6561 6461 626c ode less.readabl │ │ │ │ │ +00001410: 6520 2865 2e67 2e20 2069 3138 6e29 2e0a e (e.g. i18n).. │ │ │ │ │ +00001420: 0a20 2020 4966 2061 2076 6172 6961 626c . If a variabl │ │ │ │ │ +00001430: 6520 6973 2067 6c6f 6261 6c20 696e 2074 e is global in t │ │ │ │ │ +00001440: 6865 2073 636f 7065 206f 6620 6120 7369 he scope of a si │ │ │ │ │ +00001450: 6e67 6c65 2066 696c 6520 2869 2e65 2e20 ngle file (i.e. │ │ │ │ │ +00001460: 2069 7420 6973 0a64 6563 6c61 7265 6420 it is.declared │ │ │ │ │ +00001470: 7769 7468 2073 7461 7469 6329 2c20 6974 with static), it │ │ │ │ │ +00001480: 7320 6e61 6d65 206d 6179 206e 6f74 2073 s name may not s │ │ │ │ │ +00001490: 7461 7274 2077 6974 6820 616e 7920 7072 tart with any pr │ │ │ │ │ +000014a0: 6566 6978 2e20 2049 7420 6d75 7374 0a73 efix. It must.s │ │ │ │ │ +000014b0: 7461 7274 2077 6974 6820 6120 6e6f 756e tart with a noun │ │ │ │ │ +000014c0: 206f 7220 616e 2061 646a 6563 7469 7665 or an adjective │ │ │ │ │ +000014d0: 2e0a 0a20 2020 4966 2061 2076 6172 6961 ... If a varia │ │ │ │ │ +000014e0: 626c 6520 6973 206c 6f63 616c 2c20 796f ble is local, yo │ │ │ │ │ +000014f0: 7520 6d61 7920 6368 6f6f 7365 2061 6e79 u may choose any │ │ │ │ │ +00001500: 2073 686f 7274 6572 206e 616d 652c 2061 shorter name, a │ │ │ │ │ +00001510: 7320 6c6f 6e67 2061 730a 6974 2077 6f75 s long as.it wou │ │ │ │ │ +00001520: 6c64 6e27 7420 6d61 6b65 2063 6f64 6520 ldn't make code │ │ │ │ │ +00001530: 6c65 7373 2072 6561 6461 626c 6520 2865 less readable (e │ │ │ │ │ +00001540: 2e67 2e20 2069 292e 0a0a 1f0a 4669 6c65 .g. i).....File │ │ │ │ │ +00001550: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ +00001560: 2020 4e6f 6465 3a20 5479 7065 732c 2020 Node: Types, │ │ │ │ │ +00001570: 4e65 7874 3a20 4d61 6372 6f73 2c20 2050 Next: Macros, P │ │ │ │ │ +00001580: 7265 763a 2056 6172 6961 626c 6573 2c20 rev: Variables, │ │ │ │ │ +00001590: 2055 703a 2043 6f64 696e 6720 7374 796c Up: Coding styl │ │ │ │ │ +000015a0: 650a 0a32 2e34 2054 7970 6573 0a3d 3d3d e..2.4 Types.=== │ │ │ │ │ +000015b0: 3d3d 3d3d 3d3d 0a0a 5468 6520 6e61 6d65 ======..The name │ │ │ │ │ +000015c0: 206f 6620 6120 7479 7065 206d 7573 7420 of a type must │ │ │ │ │ +000015d0: 6265 2070 7265 6669 7865 6420 7769 7468 be prefixed with │ │ │ │ │ +000015e0: 2067 7275 625f 2061 6e64 206d 7573 7420 grub_ and must │ │ │ │ │ +000015f0: 636f 6e73 6973 7420 6f66 206f 6e6c 790a consist of only. │ │ │ │ │ +00001600: 736d 616c 6c20 6c65 7474 6572 732e 2020 small letters. │ │ │ │ │ +00001610: 4966 2074 6865 2074 7970 6520 6265 6c6f If the type belo │ │ │ │ │ +00001620: 6e67 7320 746f 2061 2073 7065 6369 6669 ngs to a specifi │ │ │ │ │ +00001630: 6320 6675 6e63 7469 6f6e 206d 6f64 756c c function modul │ │ │ │ │ +00001640: 652c 2074 6865 0a6e 616d 6520 6d75 7374 e, the.name must │ │ │ │ │ +00001650: 2061 6c73 6f20 6265 2070 7265 6669 7865 also be prefixe │ │ │ │ │ +00001660: 6420 7769 7468 2074 6865 206d 6f64 756c d with the modul │ │ │ │ │ +00001670: 6520 6e61 6d65 2e20 2046 6f72 2065 7861 e name. For exa │ │ │ │ │ +00001680: 6d70 6c65 2c20 6966 2061 2074 7970 650a mple, if a type. │ │ │ │ │ +00001690: 6973 2066 6f72 204f 5320 6c6f 6164 6572 is for OS loader │ │ │ │ │ +000016a0: 732c 2069 7473 206e 616d 6520 6973 2070 s, its name is p │ │ │ │ │ +000016b0: 7265 6669 7865 6420 7769 7468 2067 7275 refixed with gru │ │ │ │ │ +000016c0: 625f 6c6f 6164 6572 5f2e 2020 4966 2061 b_loader_. If a │ │ │ │ │ +000016d0: 2074 7970 6520 6973 0a66 6f72 204d 756c type is.for Mul │ │ │ │ │ +000016e0: 7469 626f 6f74 2062 7574 206e 6f74 2066 tiboot but not f │ │ │ │ │ +000016f0: 6f72 2061 6c6c 204f 5320 6c6f 6164 6572 or all OS loader │ │ │ │ │ +00001700: 732c 2069 7473 206e 616d 6520 6973 2070 s, its name is p │ │ │ │ │ +00001710: 7265 6669 7865 6420 7769 7468 0a67 7275 refixed with.gru │ │ │ │ │ +00001720: 625f 6c6f 6164 6572 5f6c 696e 7578 5f2e b_loader_linux_. │ │ │ │ │ +00001730: 0a0a 2020 2054 6865 206e 616d 6520 6d75 .. The name mu │ │ │ │ │ +00001740: 7374 2062 6520 7375 6666 6978 6564 2077 st be suffixed w │ │ │ │ │ +00001750: 6974 6820 5f74 2c20 746f 2065 6d70 6861 ith _t, to empha │ │ │ │ │ +00001760: 7369 7a65 2074 6865 2066 6163 7420 7468 size the fact th │ │ │ │ │ +00001770: 6174 2069 7420 6973 2061 0a74 7970 6520 at it is a.type │ │ │ │ │ +00001780: 6275 7420 6e6f 7420 6120 7661 7269 6162 but not a variab │ │ │ │ │ +00001790: 6c65 206f 7220 6120 6675 6e63 7469 6f6e le or a function │ │ │ │ │ +000017a0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622d .....File: grub- │ │ │ │ │ +000017b0: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ │ +000017c0: 204d 6163 726f 732c 2020 4e65 7874 3a20 Macros, Next: │ │ │ │ │ +000017d0: 436f 6d6d 656e 7473 2c20 2050 7265 763a Comments, Prev: │ │ │ │ │ +000017e0: 2054 7970 6573 2c20 2055 703a 2043 6f64 Types, Up: Cod │ │ │ │ │ +000017f0: 696e 6720 7374 796c 650a 0a32 2e35 204d ing style..2.5 M │ │ │ │ │ +00001800: 6163 726f 730a 3d3d 3d3d 3d3d 3d3d 3d3d acros.========== │ │ │ │ │ +00001810: 0a0a 4966 2061 206d 6163 726f 2069 7320 ..If a macro is │ │ │ │ │ +00001820: 676c 6f62 616c 2c20 6974 7320 6e61 6d65 global, its name │ │ │ │ │ +00001830: 206d 7573 7420 6265 2070 7265 6669 7865 must be prefixe │ │ │ │ │ +00001840: 6420 7769 7468 2047 5255 425f 2061 6e64 d with GRUB_ and │ │ │ │ │ +00001850: 206d 7573 740a 636f 6e73 6973 7420 6f66 must.consist of │ │ │ │ │ +00001860: 206f 6e6c 7920 6c61 7267 6520 6c65 7474 only large lett │ │ │ │ │ +00001870: 6572 732e 2020 4f74 6865 7220 7275 6c65 ers. Other rule │ │ │ │ │ +00001880: 7320 6172 6520 7468 6520 7361 6d65 2061 s are the same a │ │ │ │ │ +00001890: 7320 6675 6e63 7469 6f6e 7320 6f72 0a76 s functions or.v │ │ │ │ │ +000018a0: 6172 6961 626c 6573 2c20 6465 7065 6e64 ariables, depend │ │ │ │ │ +000018b0: 696e 6720 6f6e 2077 6865 7468 6572 2061 ing on whether a │ │ │ │ │ +000018c0: 206d 6163 726f 2069 7320 7573 6564 206c macro is used l │ │ │ │ │ +000018d0: 696b 6520 6120 6675 6e63 7469 6f6e 206f ike a function o │ │ │ │ │ +000018e0: 7220 610a 7661 7269 6162 6c65 2e0a 0a1f r a.variable.... │ │ │ │ │ +000018f0: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ +00001900: 696e 666f 2c20 204e 6f64 653a 2043 6f6d info, Node: Com │ │ │ │ │ +00001910: 6d65 6e74 732c 2020 4e65 7874 3a20 4d75 ments, Next: Mu │ │ │ │ │ +00001920: 6c74 692d 4c69 6e65 2043 6f6d 6d65 6e74 lti-Line Comment │ │ │ │ │ +00001930: 732c 2020 5072 6576 3a20 4d61 6372 6f73 s, Prev: Macros │ │ │ │ │ +00001940: 2c20 2055 703a 2043 6f64 696e 6720 7374 , Up: Coding st │ │ │ │ │ +00001950: 796c 650a 0a32 2e36 2043 6f6d 6d65 6e74 yle..2.6 Comment │ │ │ │ │ +00001960: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a s.============.. │ │ │ │ │ +00001970: 416c 6c20 636f 6d6d 656e 7473 2073 6861 All comments sha │ │ │ │ │ +00001980: 6c6c 2062 6520 432d 7374 796c 6520 636f ll be C-style co │ │ │ │ │ +00001990: 6d6d 656e 7473 2c20 6f66 2074 6865 2066 mments, of the f │ │ │ │ │ +000019a0: 6f72 6d20 272f 2a20 2e2e 2e20 2a2f 272e orm '/* ... */'. │ │ │ │ │ +000019b0: 2020 410a 636f 6d6d 656e 7420 6361 6e20 A.comment can │ │ │ │ │ +000019c0: 6265 2070 6c61 6365 6420 696d 6d65 6469 be placed immedi │ │ │ │ │ +000019d0: 6174 656c 7920 7072 6563 6564 696e 6720 ately preceding │ │ │ │ │ +000019e0: 7468 6520 656e 7469 7479 2069 7420 6465 the entity it de │ │ │ │ │ +000019f0: 7363 7269 6265 7320 6f72 0a69 7420 6361 scribes or.it ca │ │ │ │ │ +00001a00: 6e20 6265 2070 6c61 6365 6420 746f 6765 n be placed toge │ │ │ │ │ +00001a10: 7468 6572 2077 6974 6820 636f 6465 2c20 ther with code, │ │ │ │ │ +00001a20: 7661 7269 6162 6c65 2064 6563 6c61 7261 variable declara │ │ │ │ │ +00001a30: 7469 6f6e 732c 206f 7220 6f74 6865 720a tions, or other. │ │ │ │ │ +00001a40: 6e6f 6e2d 636f 6d6d 656e 7420 656e 7469 non-comment enti │ │ │ │ │ +00001a50: 7469 6573 2e20 2048 6f77 6576 6572 2c20 ties. However, │ │ │ │ │ +00001a60: 6974 2069 7320 7265 636f 6d6d 656e 6465 it is recommende │ │ │ │ │ +00001a70: 6420 746f 206e 6f74 206d 6978 2076 6172 d to not mix var │ │ │ │ │ +00001a80: 696f 7573 0a66 6f72 6d73 2065 7370 6563 ious.forms espec │ │ │ │ │ +00001a90: 6961 6c6c 7920 696e 2074 7970 6573 2f73 ially in types/s │ │ │ │ │ +00001aa0: 7472 7563 7473 2064 6573 6372 6970 7469 tructs descripti │ │ │ │ │ +00001ab0: 6f6e 732e 0a0a 2020 2041 6363 6570 7461 ons... Accepta │ │ │ │ │ +00001ac0: 626c 653a 0a20 2020 2020 2f2a 2054 6865 ble:. /* The │ │ │ │ │ +00001ad0: 2070 6167 6520 2320 7468 6174 2069 7320 page # that is │ │ │ │ │ +00001ae0: 7468 6520 6672 6f6e 7420 6275 6666 6572 the front buffer │ │ │ │ │ +00001af0: 2e20 2a2f 0a20 2020 2020 696e 7420 6469 . */. int di │ │ │ │ │ +00001b00: 7370 6c61 7965 645f 7061 6765 3b0a 0a20 splayed_page;.. │ │ │ │ │ +00001b10: 2020 2020 696e 7420 7265 6e64 6572 5f70 int render_p │ │ │ │ │ +00001b20: 6167 653b 202f 2a20 5468 6520 7061 6765 age; /* The page │ │ │ │ │ +00001b30: 2023 2074 6861 7420 6973 2074 6865 2062 # that is the b │ │ │ │ │ +00001b40: 6163 6b20 6275 6666 6572 2e20 2a2f 0a0a ack buffer. */.. │ │ │ │ │ +00001b50: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ │ +00001b60: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4d75 .info, Node: Mu │ │ │ │ │ +00001b70: 6c74 692d 4c69 6e65 2043 6f6d 6d65 6e74 lti-Line Comment │ │ │ │ │ +00001b80: 732c 2020 5072 6576 3a20 436f 6d6d 656e s, Prev: Commen │ │ │ │ │ +00001b90: 7473 2c20 2055 703a 2043 6f64 696e 6720 ts, Up: Coding │ │ │ │ │ +00001ba0: 7374 796c 650a 0a32 2e37 204d 756c 7469 style..2.7 Multi │ │ │ │ │ +00001bb0: 2d4c 696e 6520 436f 6d6d 656e 7473 0a3d -Line Comments.= │ │ │ │ │ 00001bc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00001bd0: 3d3d 3d3d 0a0a 436f 6d6d 656e 7473 2073 ====..Comments s │ │ │ │ │ -00001be0: 7061 6e6e 696e 6720 6d75 6c74 6970 6c65 panning multiple │ │ │ │ │ -00001bf0: 206c 696e 6573 2073 6861 6c6c 2062 6520 lines shall be │ │ │ │ │ -00001c00: 666f 726d 6174 7465 6420 7769 7468 2061 formatted with a │ │ │ │ │ -00001c10: 6c6c 206c 696e 6573 2061 6674 6572 0a74 ll lines after.t │ │ │ │ │ -00001c20: 6865 2066 6972 7374 2061 6c69 676e 6564 he first aligned │ │ │ │ │ -00001c30: 2077 6974 6820 7468 6520 6669 7273 7420 with the first │ │ │ │ │ -00001c40: 6c69 6e65 2e20 2041 7374 6572 6973 6b20 line. Asterisk │ │ │ │ │ -00001c50: 6368 6172 6163 7465 7273 2073 686f 756c characters shoul │ │ │ │ │ -00001c60: 6420 6265 0a72 6570 6561 7465 6420 6174 d be.repeated at │ │ │ │ │ -00001c70: 2074 6865 2073 7461 7274 206f 6620 6561 the start of ea │ │ │ │ │ -00001c80: 6368 2073 7562 7365 7175 656e 7420 6c69 ch subsequent li │ │ │ │ │ -00001c90: 6e65 2e0a 0a20 2020 4163 6365 7074 6162 ne... Acceptab │ │ │ │ │ -00001ca0: 6c65 3a0a 2020 2020 202f 2a0a 2020 2020 le:. /*. │ │ │ │ │ -00001cb0: 2020 2a20 5468 6973 2069 7320 6120 636f * This is a co │ │ │ │ │ -00001cc0: 6d6d 656e 740a 2020 2020 2020 2a20 7768 mment. * wh │ │ │ │ │ -00001cd0: 6963 6820 7370 616e 7320 6d75 6c74 6970 ich spans multip │ │ │ │ │ -00001ce0: 6c65 206c 696e 6573 2e0a 2020 2020 2020 le lines.. │ │ │ │ │ -00001cf0: 2a20 4974 2069 7320 6c6f 6e67 2e0a 2020 * It is long.. │ │ │ │ │ -00001d00: 2020 2020 2a2f 0a0a 2020 2055 6e61 6363 */.. Unacc │ │ │ │ │ -00001d10: 6570 7461 626c 653a 0a20 2020 2020 2f2a eptable:. /* │ │ │ │ │ -00001d20: 2054 6869 7320 6973 2061 2063 6f6d 6d65 This is a comme │ │ │ │ │ -00001d30: 6e74 0a20 2020 2020 2020 2077 6869 6368 nt. which │ │ │ │ │ -00001d40: 2073 7061 6e73 206d 756c 7469 706c 6520 spans multiple │ │ │ │ │ -00001d50: 6c69 6e65 732e 0a20 2020 2020 2020 2049 lines.. I │ │ │ │ │ -00001d60: 7420 6973 206c 6f6e 672e 202a 2f0a 0a20 t is long. */.. │ │ │ │ │ -00001d70: 2020 2020 2f2a 0a20 2020 2020 202a 2054 /*. * T │ │ │ │ │ -00001d80: 6869 7320 6973 2061 2063 6f6d 6d65 6e74 his is a comment │ │ │ │ │ -00001d90: 0a20 2020 2020 202a 2077 6869 6368 2073 . * which s │ │ │ │ │ -00001da0: 7061 6e73 206d 756c 7469 706c 6520 6c69 pans multiple li │ │ │ │ │ -00001db0: 6e65 732e 0a20 2020 2020 202a 2049 7420 nes.. * It │ │ │ │ │ -00001dc0: 6973 206c 6f6e 672e 202a 2f0a 0a20 2020 is long. */.. │ │ │ │ │ -00001dd0: 2020 2f2a 2054 6869 7320 6973 2061 2063 /* This is a c │ │ │ │ │ -00001de0: 6f6d 6d65 6e74 0a20 2020 2020 202a 2077 omment. * w │ │ │ │ │ -00001df0: 6869 6368 2073 7061 6e73 206d 756c 7469 hich spans multi │ │ │ │ │ -00001e00: 706c 6520 6c69 6e65 732e 0a20 2020 2020 ple lines.. │ │ │ │ │ -00001e10: 202a 2049 7420 6973 206c 6f6e 672e 0a20 * It is long.. │ │ │ │ │ -00001e20: 2020 2020 202a 2f0a 0a20 2020 496e 2070 */.. In p │ │ │ │ │ -00001e30: 6172 7469 6375 6c61 7220 6669 7273 7420 articular first │ │ │ │ │ -00001e40: 756e 6163 6365 7074 6162 6c65 2066 6f72 unacceptable for │ │ │ │ │ -00001e50: 6d20 6d61 6b65 7320 636f 6d6d 656e 7420 m makes comment │ │ │ │ │ -00001e60: 6469 6666 6963 756c 7420 746f 0a64 6973 difficult to.dis │ │ │ │ │ -00001e70: 7469 6e67 7569 7368 2066 726f 6d20 7468 tinguish from th │ │ │ │ │ -00001e80: 6520 636f 6465 2069 7473 656c 662e 2020 e code itself. │ │ │ │ │ -00001e90: 4573 7065 6369 616c 6c79 2069 6620 6974 Especially if it │ │ │ │ │ -00001ea0: 2063 6f6e 7461 696e 7320 7468 6520 636f contains the co │ │ │ │ │ -00001eb0: 6465 0a73 6e69 7070 6574 7320 616e 642f de.snippets and/ │ │ │ │ │ -00001ec0: 6f72 2069 7320 6c6f 6e67 2e20 2053 6f2c or is long. So, │ │ │ │ │ -00001ed0: 2069 7473 2075 7361 6765 2069 7320 6469 its usage is di │ │ │ │ │ -00001ee0: 7361 6c6c 6f77 6564 2e0a 0a1f 0a46 696c sallowed.....Fil │ │ │ │ │ -00001ef0: 653a 2067 7275 622d 6465 762e 696e 666f e: grub-dev.info │ │ │ │ │ -00001f00: 2c20 204e 6f64 653a 2046 696e 6469 6e67 , Node: Finding │ │ │ │ │ -00001f10: 2079 6f75 7220 7761 7920 6172 6f75 6e64 your way around │ │ │ │ │ -00001f20: 2c20 204e 6578 743a 2043 6f6e 7472 6962 , Next: Contrib │ │ │ │ │ -00001f30: 7574 696e 6720 4368 616e 6765 732c 2020 uting Changes, │ │ │ │ │ -00001f40: 5072 6576 3a20 436f 6469 6e67 2073 7479 Prev: Coding sty │ │ │ │ │ -00001f50: 6c65 2c20 2055 703a 2054 6f70 0a0a 3320 le, Up: Top..3 │ │ │ │ │ -00001f60: 4669 6e64 696e 6720 796f 7572 2077 6179 Finding your way │ │ │ │ │ -00001f70: 2061 726f 756e 640a 2a2a 2a2a 2a2a 2a2a around.******** │ │ │ │ │ +00001bd0: 3d3d 3d3d 3d3d 0a0a 436f 6d6d 656e 7473 ======..Comments │ │ │ │ │ +00001be0: 2073 7061 6e6e 696e 6720 6d75 6c74 6970 spanning multip │ │ │ │ │ +00001bf0: 6c65 206c 696e 6573 2073 6861 6c6c 2062 le lines shall b │ │ │ │ │ +00001c00: 6520 666f 726d 6174 7465 6420 7769 7468 e formatted with │ │ │ │ │ +00001c10: 2061 6c6c 206c 696e 6573 2061 6674 6572 all lines after │ │ │ │ │ +00001c20: 0a74 6865 2066 6972 7374 2061 6c69 676e .the first align │ │ │ │ │ +00001c30: 6564 2077 6974 6820 7468 6520 6669 7273 ed with the firs │ │ │ │ │ +00001c40: 7420 6c69 6e65 2e20 2041 7374 6572 6973 t line. Asteris │ │ │ │ │ +00001c50: 6b20 6368 6172 6163 7465 7273 2073 686f k characters sho │ │ │ │ │ +00001c60: 756c 6420 6265 0a72 6570 6561 7465 6420 uld be.repeated │ │ │ │ │ +00001c70: 6174 2074 6865 2073 7461 7274 206f 6620 at the start of │ │ │ │ │ +00001c80: 6561 6368 2073 7562 7365 7175 656e 7420 each subsequent │ │ │ │ │ +00001c90: 6c69 6e65 2e0a 0a20 2020 4163 6365 7074 line... Accept │ │ │ │ │ +00001ca0: 6162 6c65 3a0a 2020 2020 202f 2a0a 2020 able:. /*. │ │ │ │ │ +00001cb0: 2020 2020 2a20 5468 6973 2069 7320 6120 * This is a │ │ │ │ │ +00001cc0: 636f 6d6d 656e 740a 2020 2020 2020 2a20 comment. * │ │ │ │ │ +00001cd0: 7768 6963 6820 7370 616e 7320 6d75 6c74 which spans mult │ │ │ │ │ +00001ce0: 6970 6c65 206c 696e 6573 2e0a 2020 2020 iple lines.. │ │ │ │ │ +00001cf0: 2020 2a20 4974 2069 7320 6c6f 6e67 2e0a * It is long.. │ │ │ │ │ +00001d00: 2020 2020 2020 2a2f 0a0a 2020 2055 6e61 */.. Una │ │ │ │ │ +00001d10: 6363 6570 7461 626c 653a 0a20 2020 2020 cceptable:. │ │ │ │ │ +00001d20: 2f2a 2054 6869 7320 6973 2061 2063 6f6d /* This is a com │ │ │ │ │ +00001d30: 6d65 6e74 0a20 2020 2020 2020 2077 6869 ment. whi │ │ │ │ │ +00001d40: 6368 2073 7061 6e73 206d 756c 7469 706c ch spans multipl │ │ │ │ │ +00001d50: 6520 6c69 6e65 732e 0a20 2020 2020 2020 e lines.. │ │ │ │ │ +00001d60: 2049 7420 6973 206c 6f6e 672e 202a 2f0a It is long. */. │ │ │ │ │ +00001d70: 0a20 2020 2020 2f2a 0a20 2020 2020 202a . /*. * │ │ │ │ │ +00001d80: 2054 6869 7320 6973 2061 2063 6f6d 6d65 This is a comme │ │ │ │ │ +00001d90: 6e74 0a20 2020 2020 202a 2077 6869 6368 nt. * which │ │ │ │ │ +00001da0: 2073 7061 6e73 206d 756c 7469 706c 6520 spans multiple │ │ │ │ │ +00001db0: 6c69 6e65 732e 0a20 2020 2020 202a 2049 lines.. * I │ │ │ │ │ +00001dc0: 7420 6973 206c 6f6e 672e 202a 2f0a 0a20 t is long. */.. │ │ │ │ │ +00001dd0: 2020 2020 2f2a 2054 6869 7320 6973 2061 /* This is a │ │ │ │ │ +00001de0: 2063 6f6d 6d65 6e74 0a20 2020 2020 202a comment. * │ │ │ │ │ +00001df0: 2077 6869 6368 2073 7061 6e73 206d 756c which spans mul │ │ │ │ │ +00001e00: 7469 706c 6520 6c69 6e65 732e 0a20 2020 tiple lines.. │ │ │ │ │ +00001e10: 2020 202a 2049 7420 6973 206c 6f6e 672e * It is long. │ │ │ │ │ +00001e20: 0a20 2020 2020 202a 2f0a 0a20 2020 496e . */.. In │ │ │ │ │ +00001e30: 2070 6172 7469 6375 6c61 7220 6669 7273 particular firs │ │ │ │ │ +00001e40: 7420 756e 6163 6365 7074 6162 6c65 2066 t unacceptable f │ │ │ │ │ +00001e50: 6f72 6d20 6d61 6b65 7320 636f 6d6d 656e orm makes commen │ │ │ │ │ +00001e60: 7420 6469 6666 6963 756c 7420 746f 0a64 t difficult to.d │ │ │ │ │ +00001e70: 6973 7469 6e67 7569 7368 2066 726f 6d20 istinguish from │ │ │ │ │ +00001e80: 7468 6520 636f 6465 2069 7473 656c 662e the code itself. │ │ │ │ │ +00001e90: 2020 4573 7065 6369 616c 6c79 2069 6620 Especially if │ │ │ │ │ +00001ea0: 6974 2063 6f6e 7461 696e 7320 7468 6520 it contains the │ │ │ │ │ +00001eb0: 636f 6465 0a73 6e69 7070 6574 7320 616e code.snippets an │ │ │ │ │ +00001ec0: 642f 6f72 2069 7320 6c6f 6e67 2e20 2053 d/or is long. S │ │ │ │ │ +00001ed0: 6f2c 2069 7473 2075 7361 6765 2069 7320 o, its usage is │ │ │ │ │ +00001ee0: 6469 7361 6c6c 6f77 6564 2e0a 0a1f 0a46 disallowed.....F │ │ │ │ │ +00001ef0: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ │ +00001f00: 666f 2c20 204e 6f64 653a 2046 696e 6469 fo, Node: Findi │ │ │ │ │ +00001f10: 6e67 2079 6f75 7220 7761 7920 6172 6f75 ng your way arou │ │ │ │ │ +00001f20: 6e64 2c20 204e 6578 743a 2043 6f6e 7472 nd, Next: Contr │ │ │ │ │ +00001f30: 6962 7574 696e 6720 4368 616e 6765 732c ibuting Changes, │ │ │ │ │ +00001f40: 2020 5072 6576 3a20 436f 6469 6e67 2073 Prev: Coding s │ │ │ │ │ +00001f50: 7479 6c65 2c20 2055 703a 2054 6f70 0a0a tyle, Up: Top.. │ │ │ │ │ +00001f60: 3320 4669 6e64 696e 6720 796f 7572 2077 3 Finding your w │ │ │ │ │ +00001f70: 6179 2061 726f 756e 640a 2a2a 2a2a 2a2a ay around.****** │ │ │ │ │ 00001f80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00001f90: 2a0a 0a48 6572 6520 6973 2061 2062 7269 *..Here is a bri │ │ │ │ │ -00001fa0: 6566 206d 6170 206f 6620 7468 6520 4752 ef map of the GR │ │ │ │ │ -00001fb0: 5542 2063 6f64 6520 6261 7365 2e0a 0a20 UB code base... │ │ │ │ │ -00001fc0: 2020 4752 5542 2075 7365 7320 4175 746f GRUB uses Auto │ │ │ │ │ -00001fd0: 636f 6e66 2061 6e64 2041 7574 6f6d 616b conf and Automak │ │ │ │ │ -00001fe0: 652c 2077 6974 6820 6d6f 7374 206f 6620 e, with most of │ │ │ │ │ -00001ff0: 7468 6520 4175 746f 6d61 6b65 2069 6e70 the Automake inp │ │ │ │ │ -00002000: 7574 0a67 656e 6572 6174 6564 2062 7920 ut.generated by │ │ │ │ │ -00002010: 6120 5079 7468 6f6e 2073 6372 6970 742e a Python script. │ │ │ │ │ -00002020: 2020 5468 6520 746f 702d 6c65 7665 6c20 The top-level │ │ │ │ │ -00002030: 6275 696c 6420 7275 6c65 7320 6172 6520 build rules are │ │ │ │ │ -00002040: 696e 0a27 636f 6e66 6967 7572 652e 6163 in.'configure.ac │ │ │ │ │ -00002050: 272c 2027 6772 7562 2d63 6f72 652f 4d61 ', 'grub-core/Ma │ │ │ │ │ -00002060: 6b65 6669 6c65 2e63 6f72 652e 6465 6627 kefile.core.def' │ │ │ │ │ -00002070: 2c20 616e 6420 274d 616b 6566 696c 652e , and 'Makefile. │ │ │ │ │ -00002080: 7574 696c 2e64 6566 272e 0a45 6163 6820 util.def'..Each │ │ │ │ │ -00002090: 626c 6f63 6b20 696e 2061 2027 2a2e 6465 block in a '*.de │ │ │ │ │ -000020a0: 6627 2066 696c 6520 7265 7072 6573 656e f' file represen │ │ │ │ │ -000020b0: 7473 2061 2062 7569 6c64 2074 6172 6765 ts a build targe │ │ │ │ │ -000020c0: 742c 2061 6e64 2073 7065 6369 6669 6573 t, and specifies │ │ │ │ │ -000020d0: 0a74 6865 2073 6f75 7263 6520 6669 6c65 .the source file │ │ │ │ │ -000020e0: 7320 7573 6564 2074 6f20 6275 696c 6420 s used to build │ │ │ │ │ -000020f0: 6974 206f 6e20 7661 7269 6f75 7320 706c it on various pl │ │ │ │ │ -00002100: 6174 666f 726d 732e 2020 5468 6520 272a atforms. The '* │ │ │ │ │ -00002110: 2e64 6566 270a 6669 6c65 7320 6172 6520 .def'.files are │ │ │ │ │ -00002120: 7072 6f63 6573 7365 6420 696e 746f 2041 processed into A │ │ │ │ │ -00002130: 7574 6f6d 616b 6520 696e 7075 7420 6279 utomake input by │ │ │ │ │ -00002140: 2027 6765 6e74 706c 2e70 7927 2028 7768 'gentpl.py' (wh │ │ │ │ │ -00002150: 6963 6820 796f 7520 6f6e 6c79 0a6e 6565 ich you only.nee │ │ │ │ │ -00002160: 6420 746f 206c 6f6f 6b20 6174 2069 6620 d to look at if │ │ │ │ │ -00002170: 796f 7520 6172 6520 6578 7465 6e64 696e you are extendin │ │ │ │ │ -00002180: 6720 7468 6520 6275 696c 6420 7379 7374 g the build syst │ │ │ │ │ -00002190: 656d 292e 2020 4966 2079 6f75 2061 7265 em). If you are │ │ │ │ │ -000021a0: 0a61 6464 696e 6720 6120 6e65 7720 6d6f .adding a new mo │ │ │ │ │ -000021b0: 6475 6c65 2077 6869 6368 2066 6f6c 6c6f dule which follo │ │ │ │ │ -000021c0: 7773 2061 6e20 6578 6973 7469 6e67 2070 ws an existing p │ │ │ │ │ -000021d0: 6174 7465 726e 2c20 7375 6368 2061 7320 attern, such as │ │ │ │ │ -000021e0: 6120 6e65 770a 636f 6d6d 616e 6420 6f72 a new.command or │ │ │ │ │ -000021f0: 2061 206e 6577 2066 696c 6573 7973 7465 a new filesyste │ │ │ │ │ -00002200: 6d20 696d 706c 656d 656e 7461 7469 6f6e m implementation │ │ │ │ │ -00002210: 2c20 6974 2069 7320 7573 7561 6c6c 7920 , it is usually │ │ │ │ │ -00002220: 6561 7369 6573 7420 746f 0a67 7265 7020 easiest to.grep │ │ │ │ │ -00002230: 2767 7275 622d 636f 7265 2f4d 616b 6566 'grub-core/Makef │ │ │ │ │ -00002240: 696c 652e 636f 7265 2e64 6566 2720 616e ile.core.def' an │ │ │ │ │ -00002250: 6420 274d 616b 6566 696c 652e 7574 696c d 'Makefile.util │ │ │ │ │ -00002260: 2e64 6566 2720 666f 7220 616e 0a65 7869 .def' for an.exi │ │ │ │ │ -00002270: 7374 696e 6720 6578 616d 706c 6520 6f66 sting example of │ │ │ │ │ -00002280: 2074 6861 7420 7061 7474 6572 6e20 746f that pattern to │ │ │ │ │ -00002290: 2066 696e 6420 6f75 7420 7768 6572 6520 find out where │ │ │ │ │ -000022a0: 6974 2073 686f 756c 6420 6265 2061 6464 it should be add │ │ │ │ │ -000022b0: 6564 2e0a 0a20 2020 496e 2067 656e 6572 ed... In gener │ │ │ │ │ -000022c0: 616c 2c20 636f 6465 2074 6861 7420 6d61 al, code that ma │ │ │ │ │ -000022d0: 7920 6265 2072 756e 2061 7420 626f 6f74 y be run at boot │ │ │ │ │ -000022e0: 2074 696d 6520 6973 2069 6e20 6120 7375 time is in a su │ │ │ │ │ -000022f0: 6264 6972 6563 746f 7279 206f 660a 2767 bdirectory of.'g │ │ │ │ │ -00002300: 7275 622d 636f 7265 272c 2077 6869 6c65 rub-core', while │ │ │ │ │ -00002310: 2063 6f64 6520 7468 6174 2069 7320 6f6e code that is on │ │ │ │ │ -00002320: 6c79 2072 756e 2066 726f 6d20 7769 7468 ly run from with │ │ │ │ │ -00002330: 696e 2061 2066 756c 6c20 6f70 6572 6174 in a full operat │ │ │ │ │ -00002340: 696e 670a 7379 7374 656d 2069 7320 696e ing.system is in │ │ │ │ │ -00002350: 2061 2073 7562 6469 7265 6374 6f72 7920 a subdirectory │ │ │ │ │ -00002360: 6f66 2074 6865 2074 6f70 206c 6576 656c of the top level │ │ │ │ │ -00002370: 2e0a 0a20 2020 4c6f 772d 6c65 7665 6c20 ... Low-level │ │ │ │ │ -00002380: 626f 6f74 2063 6f64 652c 2073 7563 6820 boot code, such │ │ │ │ │ -00002390: 6173 2074 6865 204d 4252 2069 6d70 6c65 as the MBR imple │ │ │ │ │ -000023a0: 6d65 6e74 6174 696f 6e20 6f6e 2050 4320 mentation on PC │ │ │ │ │ -000023b0: 4249 4f53 0a73 7973 7465 6d73 2c20 6973 BIOS.systems, is │ │ │ │ │ -000023c0: 2069 6e20 7468 6520 2767 7275 622d 636f in the 'grub-co │ │ │ │ │ -000023d0: 7265 2f62 6f6f 742f 2720 6469 7265 6374 re/boot/' direct │ │ │ │ │ -000023e0: 6f72 792e 0a0a 2020 2054 6865 2047 5255 ory... The GRU │ │ │ │ │ -000023f0: 4220 6b65 726e 656c 2069 7320 696e 2027 B kernel is in ' │ │ │ │ │ -00002400: 6772 7562 2d63 6f72 652f 6b65 726e 2f27 grub-core/kern/' │ │ │ │ │ -00002410: 2e20 2054 6869 7320 636f 6e74 6169 6e73 . This contains │ │ │ │ │ -00002420: 2063 6f72 650a 6661 6369 6c69 7469 6573 core.facilities │ │ │ │ │ -00002430: 2073 7563 6820 6173 2074 6865 2064 6576 such as the dev │ │ │ │ │ -00002440: 6963 652c 2064 6973 6b2c 2061 6e64 2066 ice, disk, and f │ │ │ │ │ -00002450: 696c 6520 6672 616d 6577 6f72 6b73 2c20 ile frameworks, │ │ │ │ │ -00002460: 656e 7669 726f 6e6d 656e 740a 7661 7269 environment.vari │ │ │ │ │ -00002470: 6162 6c65 2068 616e 646c 696e 672c 206c able handling, l │ │ │ │ │ -00002480: 6973 7420 7072 6f63 6573 7369 6e67 2c20 ist processing, │ │ │ │ │ -00002490: 616e 6420 736f 206f 6e2e 2020 5468 6520 and so on. The │ │ │ │ │ -000024a0: 6b65 726e 656c 2073 686f 756c 640a 636f kernel should.co │ │ │ │ │ -000024b0: 6e74 6169 6e20 656e 6f75 6768 2074 6f20 ntain enough to │ │ │ │ │ -000024c0: 6765 7420 7570 2074 6f20 6120 7265 7363 get up to a resc │ │ │ │ │ -000024d0: 7565 2070 726f 6d70 742e 2020 4865 6164 ue prompt. Head │ │ │ │ │ -000024e0: 6572 2066 696c 6573 2066 6f72 206b 6572 er files for ker │ │ │ │ │ -000024f0: 6e65 6c0a 6661 6369 6c69 7469 6573 2c20 nel.facilities, │ │ │ │ │ -00002500: 616d 6f6e 6720 6f74 6865 7273 2c20 6172 among others, ar │ │ │ │ │ -00002510: 6520 696e 2027 696e 636c 7564 652f 272e e in 'include/'. │ │ │ │ │ -00002520: 0a0a 2020 2054 6572 6d69 6e61 6c20 696d .. Terminal im │ │ │ │ │ -00002530: 706c 656d 656e 7461 7469 6f6e 7320 6172 plementations ar │ │ │ │ │ -00002540: 6520 696e 2027 6772 7562 2d63 6f72 652f e in 'grub-core/ │ │ │ │ │ -00002550: 7465 726d 2f27 2e0a 0a20 2020 4469 736b term/'... Disk │ │ │ │ │ -00002560: 2061 6363 6573 7320 636f 6465 2069 7320 access code is │ │ │ │ │ -00002570: 7370 7265 6164 2061 6372 6f73 7320 2767 spread across 'g │ │ │ │ │ -00002580: 7275 622d 636f 7265 2f64 6973 6b2f 2720 rub-core/disk/' │ │ │ │ │ -00002590: 2866 6f72 2061 6363 6573 7369 6e67 0a74 (for accessing.t │ │ │ │ │ -000025a0: 6865 2064 6973 6b20 6465 7669 6365 7320 he disk devices │ │ │ │ │ -000025b0: 7468 656d 7365 6c76 6573 292c 2027 6772 themselves), 'gr │ │ │ │ │ -000025c0: 7562 2d63 6f72 652f 7061 7274 6d61 702f ub-core/partmap/ │ │ │ │ │ -000025d0: 2720 2866 6f72 2069 6e74 6572 7072 6574 ' (for interpret │ │ │ │ │ -000025e0: 696e 670a 7061 7274 6974 696f 6e20 7461 ing.partition ta │ │ │ │ │ -000025f0: 626c 6520 6461 7461 292c 2061 6e64 2027 ble data), and ' │ │ │ │ │ -00002600: 6772 7562 2d63 6f72 652f 6673 2f27 2028 grub-core/fs/' ( │ │ │ │ │ -00002610: 666f 7220 6163 6365 7373 696e 6720 6669 for accessing fi │ │ │ │ │ -00002620: 6c65 7379 7374 656d 7329 2e0a 4e6f 7465 lesystems)..Note │ │ │ │ │ -00002630: 2074 6861 742c 2077 6974 6820 7468 6520 that, with the │ │ │ │ │ -00002640: 6f64 6420 7370 6563 6961 6c69 7365 6420 odd specialised │ │ │ │ │ -00002650: 6578 6365 7074 696f 6e2c 2047 5255 4220 exception, GRUB │ │ │ │ │ -00002660: 6f6e 6c79 2063 6f6e 7461 696e 7320 636f only contains co │ │ │ │ │ -00002670: 6465 0a74 6f20 5f72 6561 645f 2066 726f de.to _read_ fro │ │ │ │ │ -00002680: 6d20 6669 6c65 7379 7374 656d 7320 616e m filesystems an │ │ │ │ │ -00002690: 6420 7472 6965 7320 746f 2061 766f 6964 d tries to avoid │ │ │ │ │ -000026a0: 2063 6f6e 7461 696e 696e 6720 616e 7920 containing any │ │ │ │ │ -000026b0: 636f 6465 2074 6f0a 5f77 7269 7465 5f20 code to._write_ │ │ │ │ │ -000026c0: 746f 2066 696c 6573 7973 7465 6d73 3b20 to filesystems; │ │ │ │ │ -000026d0: 7468 6973 206c 6574 7320 7573 2063 6f6e this lets us con │ │ │ │ │ -000026e0: 6669 6465 6e74 6c79 2061 7373 7572 6520 fidently assure │ │ │ │ │ -000026f0: 7573 6572 7320 7468 6174 2047 5255 420a users that GRUB. │ │ │ │ │ -00002700: 6361 6e6e 6f74 2062 6520 7265 7370 6f6e cannot be respon │ │ │ │ │ -00002710: 7369 626c 6520 666f 7220 6669 6c65 7379 sible for filesy │ │ │ │ │ -00002720: 7374 656d 2063 6f72 7275 7074 696f 6e2e stem corruption. │ │ │ │ │ -00002730: 0a0a 2020 2050 4349 2061 6e64 2055 5342 .. PCI and USB │ │ │ │ │ -00002740: 2062 7573 2068 616e 646c 696e 6720 6973 bus handling is │ │ │ │ │ -00002750: 2069 6e20 2767 7275 622d 636f 7265 2f62 in 'grub-core/b │ │ │ │ │ -00002760: 7573 2f27 2e0a 0a20 2020 5669 6465 6f20 us/'... Video │ │ │ │ │ -00002770: 6861 6e64 6c69 6e67 2063 6f64 6520 6973 handling code is │ │ │ │ │ -00002780: 2069 6e20 2767 7275 622d 636f 7265 2f76 in 'grub-core/v │ │ │ │ │ -00002790: 6964 656f 2f27 2e20 2054 6865 2067 7261 ideo/'. The gra │ │ │ │ │ -000027a0: 7068 6963 616c 206d 656e 750a 7379 7374 phical menu.syst │ │ │ │ │ -000027b0: 656d 2075 7365 7320 7468 6973 2068 6561 em uses this hea │ │ │ │ │ -000027c0: 7669 6c79 2c20 6275 7420 6973 2069 6e20 vily, but is in │ │ │ │ │ -000027d0: 6120 7365 7061 7261 7465 2064 6972 6563 a separate direc │ │ │ │ │ -000027e0: 746f 7279 2c0a 2767 7275 622d 636f 7265 tory,.'grub-core │ │ │ │ │ -000027f0: 2f67 6678 6d65 6e75 2f27 2e0a 0a20 2020 /gfxmenu/'... │ │ │ │ │ -00002800: 4d6f 7374 2063 6f6d 6d61 6e64 7320 6172 Most commands ar │ │ │ │ │ -00002810: 6520 696d 706c 656d 656e 7465 6420 6279 e implemented by │ │ │ │ │ -00002820: 2066 696c 6573 2069 6e20 2767 7275 622d files in 'grub- │ │ │ │ │ -00002830: 636f 7265 2f63 6f6d 6d61 6e64 732f 272c core/commands/', │ │ │ │ │ -00002840: 2077 6974 680a 7468 6520 666f 6c6c 6f77 with.the follow │ │ │ │ │ -00002850: 696e 6720 6578 6365 7074 696f 6e73 3a0a ing exceptions:. │ │ │ │ │ -00002860: 0a20 2020 2a20 4120 6665 7720 636f 7265 . * A few core │ │ │ │ │ -00002870: 2063 6f6d 6d61 6e64 7320 6c69 7665 2069 commands live i │ │ │ │ │ -00002880: 6e20 2767 7275 622d 636f 7265 2f6b 6572 n 'grub-core/ker │ │ │ │ │ -00002890: 6e2f 636f 7265 636d 642e 6327 2e0a 0a20 n/corecmd.c'... │ │ │ │ │ -000028a0: 2020 2a20 436f 6d6d 616e 6473 2072 656c * Commands rel │ │ │ │ │ -000028b0: 6174 6564 2074 6f20 6e6f 726d 616c 206d ated to normal m │ │ │ │ │ -000028c0: 6f64 6520 6c69 7665 2075 6e64 6572 2027 ode live under ' │ │ │ │ │ -000028d0: 6772 7562 2d63 6f72 652f 6e6f 726d 616c grub-core/normal │ │ │ │ │ -000028e0: 2f27 2e0a 0a20 2020 2a20 436f 6d6d 616e /'... * Comman │ │ │ │ │ -000028f0: 6473 2074 6861 7420 6c6f 6164 2061 6e64 ds that load and │ │ │ │ │ -00002900: 2062 6f6f 7420 6b65 726e 656c 7320 6c69 boot kernels li │ │ │ │ │ -00002910: 7665 2075 6e64 6572 2027 6772 7562 2d63 ve under 'grub-c │ │ │ │ │ -00002920: 6f72 652f 6c6f 6164 6572 2f27 2e0a 0a20 ore/loader/'... │ │ │ │ │ -00002930: 2020 2a20 5468 6520 276c 6f6f 7062 6163 * The 'loopbac │ │ │ │ │ -00002940: 6b27 2063 6f6d 6d61 6e64 2069 7320 7265 k' command is re │ │ │ │ │ -00002950: 616c 6c79 2061 2064 6973 6b20 6465 7669 ally a disk devi │ │ │ │ │ -00002960: 6365 2c20 616e 6420 736f 206c 6976 6573 ce, and so lives │ │ │ │ │ -00002970: 2069 6e0a 2020 2020 2027 6772 7562 2d63 in. 'grub-c │ │ │ │ │ -00002980: 6f72 652f 6469 736b 2f6c 6f6f 7062 6163 ore/disk/loopbac │ │ │ │ │ -00002990: 6b2e 6327 2e0a 0a20 2020 2a20 5468 6520 k.c'... * The │ │ │ │ │ -000029a0: 2767 6574 7465 7874 2720 636f 6d6d 616e 'gettext' comman │ │ │ │ │ -000029b0: 6420 6c69 7665 7320 756e 6465 7220 2767 d lives under 'g │ │ │ │ │ -000029c0: 7275 622d 636f 7265 2f67 6574 7465 7874 rub-core/gettext │ │ │ │ │ -000029d0: 2f27 2e0a 0a20 2020 2a20 5468 6520 276c /'... * The 'l │ │ │ │ │ -000029e0: 6f61 6466 6f6e 7427 2061 6e64 2027 6c73 oadfont' and 'ls │ │ │ │ │ -000029f0: 666f 6e74 7327 2063 6f6d 6d61 6e64 7320 fonts' commands │ │ │ │ │ -00002a00: 6c69 7665 2075 6e64 6572 2027 6772 7562 live under 'grub │ │ │ │ │ -00002a10: 2d63 6f72 652f 666f 6e74 2f27 2e0a 0a20 -core/font/'... │ │ │ │ │ -00002a20: 2020 2a20 5468 6520 2773 6572 6961 6c27 * The 'serial' │ │ │ │ │ -00002a30: 2c20 2774 6572 6d69 6e66 6f27 2c20 616e , 'terminfo', an │ │ │ │ │ -00002a40: 6420 2762 6163 6b67 726f 756e 645f 696d d 'background_im │ │ │ │ │ -00002a50: 6167 6527 2063 6f6d 6d61 6e64 7320 6c69 age' commands li │ │ │ │ │ -00002a60: 7665 0a20 2020 2020 756e 6465 7220 2767 ve. under 'g │ │ │ │ │ -00002a70: 7275 622d 636f 7265 2f74 6572 6d2f 272e rub-core/term/'. │ │ │ │ │ -00002a80: 0a0a 2020 202a 2054 6865 2027 6566 6965 .. * The 'efie │ │ │ │ │ -00002a90: 6d75 5f2a 2720 636f 6d6d 616e 6473 206c mu_*' commands l │ │ │ │ │ -00002aa0: 6976 6520 756e 6465 7220 2767 7275 622d ive under 'grub- │ │ │ │ │ -00002ab0: 636f 7265 2f65 6669 656d 752f 272e 0a0a core/efiemu/'... │ │ │ │ │ -00002ac0: 2020 202a 204f 532d 6465 7065 6e64 656e * OS-dependen │ │ │ │ │ -00002ad0: 7420 636f 6465 2073 686f 756c 6420 6265 t code should be │ │ │ │ │ -00002ae0: 2075 6e64 6572 2027 6772 7562 2d63 6f72 under 'grub-cor │ │ │ │ │ -00002af0: 652f 6f73 6465 702f 270a 0a20 2020 2a20 e/osdep/'.. * │ │ │ │ │ -00002b00: 5574 696c 6974 7920 7072 6f67 7261 6d73 Utility programs │ │ │ │ │ -00002b10: 206d 6561 6e74 2074 6f20 6265 2072 756e meant to be run │ │ │ │ │ -00002b20: 2066 726f 6d20 6120 6675 6c6c 206f 7065 from a full ope │ │ │ │ │ -00002b30: 7261 7469 6e67 2073 7973 7465 6d0a 2020 rating system. │ │ │ │ │ -00002b40: 2020 2028 6578 6365 7074 204f 532d 6465 (except OS-de │ │ │ │ │ -00002b50: 7065 6e64 656e 7420 636f 6465 206d 656e pendent code men │ │ │ │ │ -00002b60: 7469 6f6e 6564 2070 7265 7669 6f75 736c tioned previousl │ │ │ │ │ -00002b70: 7929 2061 7265 2069 6e20 2775 7469 6c2f y) are in 'util/ │ │ │ │ │ -00002b80: 272e 0a0a 2020 2054 6865 7265 2061 7265 '... There are │ │ │ │ │ -00002b90: 2061 2066 6577 206f 7468 6572 2073 7065 a few other spe │ │ │ │ │ -00002ba0: 6369 616c 2d70 7572 706f 7365 2065 7863 cial-purpose exc │ │ │ │ │ -00002bb0: 6570 7469 6f6e 733b 2067 7265 7020 666f eptions; grep fo │ │ │ │ │ -00002bc0: 7220 7468 656d 2069 660a 7468 6579 206d r them if.they m │ │ │ │ │ -00002bd0: 6174 7465 7220 746f 2079 6f75 2e0a 0a1f atter to you.... │ │ │ │ │ -00002be0: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ -00002bf0: 696e 666f 2c20 204e 6f64 653a 2043 6f6e info, Node: Con │ │ │ │ │ -00002c00: 7472 6962 7574 696e 6720 4368 616e 6765 tributing Change │ │ │ │ │ -00002c10: 732c 2020 4e65 7874 3a20 5570 6461 7469 s, Next: Updati │ │ │ │ │ -00002c20: 6e67 2045 7874 6572 6e61 6c20 436f 6465 ng External Code │ │ │ │ │ -00002c30: 2c20 2050 7265 763a 2046 696e 6469 6e67 , Prev: Finding │ │ │ │ │ -00002c40: 2079 6f75 7220 7761 7920 6172 6f75 6e64 your way around │ │ │ │ │ -00002c50: 2c20 2055 703a 2054 6f70 0a0a 3420 436f , Up: Top..4 Co │ │ │ │ │ -00002c60: 6e74 7269 6275 7469 6e67 2063 6861 6e67 ntributing chang │ │ │ │ │ -00002c70: 6573 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a es.************* │ │ │ │ │ -00002c80: 2a2a 2a2a 2a2a 2a2a 2a0a 0a43 6f6e 7472 *********..Contr │ │ │ │ │ -00002c90: 6962 7574 696e 6720 6368 616e 6765 7320 ibuting changes │ │ │ │ │ -00002ca0: 746f 2047 5255 4220 3220 6973 2077 656c to GRUB 2 is wel │ │ │ │ │ -00002cb0: 636f 6d65 6420 6163 7469 7669 7479 2e20 comed activity. │ │ │ │ │ -00002cc0: 2048 6f77 6576 6572 2077 6520 6861 7665 However we have │ │ │ │ │ -00002cd0: 2061 0a62 6974 206f 6620 636f 6e74 726f a.bit of contro │ │ │ │ │ -00002ce0: 6c20 7768 6174 206b 696e 6420 6f66 2063 l what kind of c │ │ │ │ │ -00002cf0: 6861 6e67 6573 2077 696c 6c20 6265 2061 hanges will be a │ │ │ │ │ -00002d00: 6363 6570 7465 6420 746f 2047 5255 4220 ccepted to GRUB │ │ │ │ │ -00002d10: 322e 0a54 6865 7265 666f 7265 2069 7420 2..Therefore it │ │ │ │ │ -00002d20: 6973 2069 6d70 6f72 7461 6e74 2074 6f20 is important to │ │ │ │ │ -00002d30: 6469 7363 7573 7320 796f 7572 2063 6861 discuss your cha │ │ │ │ │ -00002d40: 6e67 6573 206f 6e20 6772 7562 2d64 6576 nges on grub-dev │ │ │ │ │ -00002d50: 656c 206d 6169 6c69 6e67 0a6c 6973 7420 el mailing.list │ │ │ │ │ -00002d60: 2873 6565 204d 6169 6c69 6e67 4c69 7374 (see MailingList │ │ │ │ │ -00002d70: 7329 2e20 204f 6e20 7468 6973 2070 6167 s). On this pag │ │ │ │ │ -00002d80: 6520 7468 6572 6520 6172 6520 736f 6d65 e there are some │ │ │ │ │ -00002d90: 2062 6173 6963 2064 6574 6169 6c73 206f basic details o │ │ │ │ │ -00002da0: 6e0a 7468 6520 6465 7665 6c6f 706d 656e n.the developmen │ │ │ │ │ -00002db0: 7420 7072 6f63 6573 7320 616e 6420 6163 t process and ac │ │ │ │ │ -00002dc0: 7469 7669 7469 6573 2e0a 0a20 2020 4669 tivities... Fi │ │ │ │ │ -00002dd0: 7273 7420 6f66 2061 6c6c 2079 6f75 2073 rst of all you s │ │ │ │ │ -00002de0: 686f 756c 6420 636f 6d65 2075 7020 7769 hould come up wi │ │ │ │ │ -00002df0: 7468 2074 6865 2069 6465 6120 796f 7572 th the idea your │ │ │ │ │ -00002e00: 7365 6c66 2077 6861 7420 796f 7520 7761 self what you wa │ │ │ │ │ -00002e10: 6e74 0a74 6f20 636f 6e74 7269 6275 7465 nt.to contribute │ │ │ │ │ -00002e20: 2e20 2049 6620 796f 7520 646f 206e 6f74 . If you do not │ │ │ │ │ -00002e30: 2068 6176 6520 7468 6174 2062 6566 6f72 have that befor │ │ │ │ │ -00002e40: 6568 616e 6420 796f 7520 6172 6520 6164 ehand you are ad │ │ │ │ │ -00002e50: 7669 7365 6420 746f 0a73 7475 6479 2074 vised to.study t │ │ │ │ │ -00002e60: 6869 7320 6d61 6e75 616c 2061 6e64 2074 his manual and t │ │ │ │ │ -00002e70: 7279 2047 5255 4220 3220 6f75 7420 746f ry GRUB 2 out to │ │ │ │ │ -00002e80: 2073 6565 2077 6861 7420 796f 7520 7468 see what you th │ │ │ │ │ -00002e90: 696e 6b20 6973 206d 6973 7369 6e67 0a66 ink is missing.f │ │ │ │ │ -00002ea0: 726f 6d20 7468 6572 652e 0a0a 2020 2048 rom there... H │ │ │ │ │ -00002eb0: 6572 6520 6172 6520 6164 6469 7469 6f6e ere are addition │ │ │ │ │ -00002ec0: 616c 2070 6f69 6e74 6572 733a 0a20 2020 al pointers:. │ │ │ │ │ -00002ed0: 2a20 3c68 7474 7073 3a2f 2f73 6176 616e * . * .. If you │ │ │ │ │ -00002f60: 2069 6e74 656e 6465 6420 746f 206d 616b intended to mak │ │ │ │ │ -00002f70: 6520 6368 616e 6765 7320 746f 2047 5255 e changes to GRU │ │ │ │ │ -00002f80: 4220 4c65 6761 6379 2028 3c3d 302e 3937 B Legacy (<=0.97 │ │ │ │ │ -00002f90: 2920 7468 6f73 6520 6172 6520 6e6f 740a ) those are not. │ │ │ │ │ -00002fa0: 6163 6365 7074 6564 2061 6e79 6d6f 7265 accepted anymore │ │ │ │ │ -00002fb0: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 4765 ...* Menu:..* Ge │ │ │ │ │ -00002fc0: 7474 696e 6720 7374 6172 7465 643a 3a0a tting started::. │ │ │ │ │ -00002fd0: 2a20 5479 7069 6361 6c20 4465 7665 6c6f * Typical Develo │ │ │ │ │ -00002fe0: 7065 7220 4578 7065 7269 656e 6365 3a3a per Experience:: │ │ │ │ │ -00002ff0: 0a2a 2057 6865 6e20 796f 7520 6172 6520 .* When you are │ │ │ │ │ -00003000: 6170 7072 6f76 6564 2066 6f72 2077 7269 approved for wri │ │ │ │ │ -00003010: 7465 2061 6363 6573 7320 746f 2070 726f te access to pro │ │ │ │ │ -00003020: 6a65 6374 2773 2066 696c 6573 3a3a 0a0a ject's files::.. │ │ │ │ │ -00003030: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ │ -00003040: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4765 .info, Node: Ge │ │ │ │ │ -00003050: 7474 696e 6720 7374 6172 7465 642c 2020 tting started, │ │ │ │ │ -00003060: 4e65 7874 3a20 5479 7069 6361 6c20 4465 Next: Typical De │ │ │ │ │ -00003070: 7665 6c6f 7065 7220 4578 7065 7269 656e veloper Experien │ │ │ │ │ -00003080: 6365 2c20 2055 703a 2043 6f6e 7472 6962 ce, Up: Contrib │ │ │ │ │ -00003090: 7574 696e 6720 4368 616e 6765 730a 0a34 uting Changes..4 │ │ │ │ │ -000030a0: 2e31 2047 6574 7469 6e67 2073 7461 7274 .1 Getting start │ │ │ │ │ -000030b0: 6564 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ed.============= │ │ │ │ │ -000030c0: 3d3d 3d3d 3d3d 0a0a 2020 202a 2041 6c77 ======.. * Alw │ │ │ │ │ -000030d0: 6179 7320 7573 6520 6c61 7465 7374 2047 ays use latest G │ │ │ │ │ -000030e0: 5255 4220 3220 736f 7572 6365 2063 6f64 RUB 2 source cod │ │ │ │ │ -000030f0: 652e 2020 536f 2067 6574 2074 6861 7420 e. So get that │ │ │ │ │ -00003100: 6669 7273 742e 0a0a 2020 2020 2046 6f72 first... For │ │ │ │ │ -00003110: 2064 6576 656c 6f70 6572 7320 6974 2069 developers it i │ │ │ │ │ -00003120: 7320 7265 636f 6d6d 656e 6465 6420 616c s recommended al │ │ │ │ │ -00003130: 7761 7973 2074 6f20 7573 6520 7468 6520 ways to use the │ │ │ │ │ -00003140: 6e65 7765 7374 0a20 2020 2020 6465 7665 newest. deve │ │ │ │ │ -00003150: 6c6f 706d 656e 7420 7665 7273 696f 6e20 lopment version │ │ │ │ │ -00003160: 6f66 2047 5255 4220 322e 2020 4966 2064 of GRUB 2. If d │ │ │ │ │ -00003170: 6576 656c 6f70 6d65 6e74 2074 616b 6573 evelopment takes │ │ │ │ │ -00003180: 2061 206c 6f6e 6720 7065 7269 6f64 0a20 a long period. │ │ │ │ │ -00003190: 2020 2020 6f66 2074 696d 652c 2070 6c65 of time, ple │ │ │ │ │ -000031a0: 6173 6520 7265 6d65 6d62 6572 2074 6f20 ase remember to │ │ │ │ │ -000031b0: 6b65 6570 2069 6e20 7379 6e63 2077 6974 keep in sync wit │ │ │ │ │ -000031c0: 6820 6e65 7765 7374 2064 6576 656c 6f70 h newest develop │ │ │ │ │ -000031d0: 6d65 6e74 730a 2020 2020 2072 6567 756c ments. regul │ │ │ │ │ -000031e0: 6172 6c79 2073 6f20 6974 2069 7320 6d75 arly so it is mu │ │ │ │ │ -000031f0: 6368 2065 6173 6965 7220 746f 2069 6e74 ch easier to int │ │ │ │ │ -00003200: 6567 7261 7465 2079 6f75 7220 6368 616e egrate your chan │ │ │ │ │ -00003210: 6765 2069 6e20 7468 650a 2020 2020 2066 ge in the. f │ │ │ │ │ -00003220: 7574 7572 652e 2020 4752 5542 2032 2069 uture. GRUB 2 i │ │ │ │ │ -00003230: 7320 6265 696e 6720 6465 7665 6c6f 7065 s being develope │ │ │ │ │ -00003240: 6420 696e 2061 2047 4954 2072 6570 6f73 d in a GIT repos │ │ │ │ │ -00003250: 6974 6f72 792e 0a0a 2020 2020 2050 6c65 itory... Ple │ │ │ │ │ -00003260: 6173 6520 6368 6563 6b20 5361 7661 6e6e ase check Savann │ │ │ │ │ -00003270: 6168 2773 2047 5255 4220 7072 6f6a 6563 ah's GRUB projec │ │ │ │ │ -00003280: 7420 7061 6765 2066 6f72 2064 6574 6169 t page for detai │ │ │ │ │ -00003290: 6c73 2068 6f77 2074 6f20 6765 740a 2020 ls how to get. │ │ │ │ │ -000032a0: 2020 206e 6577 6573 7420 6769 743a 2047 newest git: G │ │ │ │ │ -000032b0: 5255 4220 3220 6769 7420 5265 706f 7369 RUB 2 git Reposi │ │ │ │ │ -000032c0: 746f 7279 0a20 2020 2020 2868 7474 7073 tory. (https │ │ │ │ │ -000032d0: 3a2f 2f73 6176 616e 6e61 682e 676e 752e ://savannah.gnu. │ │ │ │ │ -000032e0: 6f72 672f 6769 742f 3f67 726f 7570 3d67 org/git/?group=g │ │ │ │ │ -000032f0: 7275 6229 0a0a 2020 202a 2043 6f6d 7069 rub).. * Compi │ │ │ │ │ -00003300: 6c65 2069 7420 616e 6420 7472 7920 6974 le it and try it │ │ │ │ │ -00003310: 206f 7574 2e0a 0a20 2020 2020 4974 2069 out... It i │ │ │ │ │ -00003320: 7320 616c 7761 7973 2067 6f6f 6420 6964 s always good id │ │ │ │ │ -00003330: 6561 2074 6f20 6669 7273 7420 7365 6520 ea to first see │ │ │ │ │ -00003340: 7468 6174 2074 6869 6e67 7320 776f 726b that things work │ │ │ │ │ -00003350: 2073 6f6d 6568 6f77 2061 6e64 0a20 2020 somehow and. │ │ │ │ │ -00003360: 2020 6166 7465 7220 7468 6174 2074 6f20 after that to │ │ │ │ │ -00003370: 7374 6172 7420 746f 2069 6d70 6c65 6d65 start to impleme │ │ │ │ │ -00003380: 6e74 206e 6577 2066 6561 7475 7265 7320 nt new features │ │ │ │ │ -00003390: 6f72 2064 6576 656c 6f70 2066 6978 6573 or develop fixes │ │ │ │ │ -000033a0: 2074 6f0a 2020 2020 2062 7567 732e 0a0a to. bugs... │ │ │ │ │ -000033b0: 2020 202a 2053 7475 6479 2074 6865 2063 * Study the c │ │ │ │ │ -000033c0: 6f64 652e 0a0a 2020 2020 2054 6865 7265 ode... There │ │ │ │ │ -000033d0: 2061 7265 2073 6f6d 6574 696d 6573 206f are sometimes o │ │ │ │ │ -000033e0: 6464 2077 6179 7320 746f 2064 6f20 7468 dd ways to do th │ │ │ │ │ -000033f0: 696e 6773 2069 6e20 4752 5542 2032 2063 ings in GRUB 2 c │ │ │ │ │ -00003400: 6f64 6520 6261 7365 2e0a 2020 2020 2054 ode base.. T │ │ │ │ │ -00003410: 6869 7320 6973 206d 6169 6e6c 7920 7265 his is mainly re │ │ │ │ │ -00003420: 6c61 7465 6420 746f 206c 696d 6974 6564 lated to limited │ │ │ │ │ -00003430: 2065 6e76 6972 6f6e 6d65 6e74 2077 6865 environment whe │ │ │ │ │ -00003440: 7265 2047 5255 4220 3220 6973 2062 6569 re GRUB 2 is bei │ │ │ │ │ -00003450: 6e67 0a20 2020 2020 6578 6563 7574 6564 ng. executed │ │ │ │ │ -00003460: 2e20 2059 6f75 2075 7375 616c 6c79 2064 . You usually d │ │ │ │ │ -00003470: 6f20 6e6f 7420 6e65 6564 2074 6f20 756e o not need to un │ │ │ │ │ -00003480: 6465 7273 7461 6e64 2069 7420 616c 6c20 derstand it all │ │ │ │ │ -00003490: 736f 2069 7420 6973 0a20 2020 2020 6265 so it is. be │ │ │ │ │ -000034a0: 7474 6572 2074 6f20 6f6e 6c79 2074 7279 tter to only try │ │ │ │ │ -000034b0: 2074 6f20 6c6f 6f6b 2061 7420 706c 6163 to look at plac │ │ │ │ │ -000034c0: 6573 2074 6861 7420 7265 6c61 7465 7320 es that relates │ │ │ │ │ -000034d0: 746f 2079 6f75 7220 776f 726b 2e0a 2020 to your work.. │ │ │ │ │ -000034e0: 2020 2050 6c65 6173 6520 646f 206e 6f74 Please do not │ │ │ │ │ -000034f0: 2068 6573 6974 6174 6520 746f 2061 736b hesitate to ask │ │ │ │ │ -00003500: 2066 6f72 2068 656c 7020 6966 2074 6865 for help if the │ │ │ │ │ -00003510: 7265 2069 7320 736f 6d65 7468 696e 6720 re is something │ │ │ │ │ -00003520: 7468 6174 0a20 2020 2020 796f 7520 646f that. you do │ │ │ │ │ -00003530: 206e 6f74 2075 6e64 6572 7374 616e 642e not understand. │ │ │ │ │ -00003540: 0a0a 2020 202a 2044 6576 656c 6f70 2061 .. * Develop a │ │ │ │ │ -00003550: 206e 6577 2066 6561 7475 7265 2e0a 0a20 new feature... │ │ │ │ │ -00003560: 2020 2020 4e6f 7720 7468 6174 2079 6f75 Now that you │ │ │ │ │ -00003570: 206b 6e6f 7720 7768 6174 2074 6f20 646f know what to do │ │ │ │ │ -00003580: 2061 6e64 2068 6f77 2069 7420 7368 6f75 and how it shou │ │ │ │ │ -00003590: 6c64 2077 6f72 6b20 696e 2047 5255 4220 ld work in GRUB │ │ │ │ │ -000035a0: 3220 636f 6465 0a20 2020 2020 6261 7365 2 code. base │ │ │ │ │ -000035b0: 2c20 706c 6561 7365 2062 6520 6672 6565 , please be free │ │ │ │ │ -000035c0: 2074 6f20 6465 7665 6c6f 7020 6974 2e20 to develop it. │ │ │ │ │ -000035d0: 2049 6620 796f 7520 6861 7665 206e 6f74 If you have not │ │ │ │ │ -000035e0: 2073 6f20 6661 720a 2020 2020 2061 6e6e so far. ann │ │ │ │ │ -000035f0: 6f75 6e63 6564 2079 6f75 7220 6964 6561 ounced your idea │ │ │ │ │ -00003600: 206f 6e20 6772 7562 2d64 6576 656c 206d on grub-devel m │ │ │ │ │ -00003610: 6169 6c69 6e67 206c 6973 742c 2070 6c65 ailing list, ple │ │ │ │ │ -00003620: 6173 6520 646f 2069 7420 6e6f 772e 0a20 ase do it now.. │ │ │ │ │ -00003630: 2020 2020 5468 6973 2069 7320 746f 206d This is to m │ │ │ │ │ -00003640: 616b 6520 7375 7265 2079 6f75 2061 7265 ake sure you are │ │ │ │ │ -00003650: 206e 6f74 2077 6173 7469 6e67 2079 6f75 not wasting you │ │ │ │ │ -00003660: 7220 7469 6d65 2077 6f72 6b69 6e67 206f r time working o │ │ │ │ │ -00003670: 6e20 7468 650a 2020 2020 2073 6f6c 7574 n the. solut │ │ │ │ │ -00003680: 696f 6e20 7468 6174 2077 696c 6c20 6e6f ion that will no │ │ │ │ │ -00003690: 7420 6265 2069 6e74 6567 7261 7465 6420 t be integrated │ │ │ │ │ -000036a0: 746f 2047 5255 4220 3220 636f 6465 2062 to GRUB 2 code b │ │ │ │ │ -000036b0: 6173 652e 0a0a 2020 2020 2059 6f75 206d ase... You m │ │ │ │ │ -000036c0: 6967 6874 2077 616e 7420 746f 2073 7475 ight want to stu │ │ │ │ │ -000036d0: 6479 206f 7572 2063 6f64 696e 6720 7374 dy our coding st │ │ │ │ │ -000036e0: 796c 6520 6265 666f 7265 2073 7461 7274 yle before start │ │ │ │ │ -000036f0: 696e 670a 2020 2020 2064 6576 656c 6f70 ing. develop │ │ │ │ │ -00003700: 6d65 6e74 2073 6f20 796f 7520 646f 206e ment so you do n │ │ │ │ │ -00003710: 6f74 206e 6565 6420 746f 2063 6861 6e67 ot need to chang │ │ │ │ │ -00003720: 6520 6d75 6368 206f 6620 7468 6520 636f e much of the co │ │ │ │ │ -00003730: 6465 2077 6865 6e20 796f 7572 0a20 2020 de when your. │ │ │ │ │ -00003740: 2020 7061 7463 6820 6973 2062 6569 6e67 patch is being │ │ │ │ │ -00003750: 2072 6576 6965 7765 642e 2020 2873 6565 reviewed. (see │ │ │ │ │ -00003760: 202a 6e6f 7465 2043 6f64 696e 6720 7374 *note Coding st │ │ │ │ │ -00003770: 796c 653a 3a29 0a0a 2020 2020 2046 6f72 yle::).. For │ │ │ │ │ -00003780: 2065 7665 7279 2061 6363 6570 7465 6420 every accepted │ │ │ │ │ -00003790: 7061 7463 6820 7468 6572 6520 6861 7320 patch there has │ │ │ │ │ -000037a0: 746f 2065 7869 7374 2061 2043 6861 6e67 to exist a Chang │ │ │ │ │ -000037b0: 654c 6f67 2065 6e74 7279 2e20 204f 7572 eLog entry. Our │ │ │ │ │ -000037c0: 0a20 2020 2020 4368 616e 6765 4c6f 6720 . ChangeLog │ │ │ │ │ -000037d0: 636f 6e73 6973 7420 6f66 2063 6861 6e67 consist of chang │ │ │ │ │ -000037e0: 6573 2077 6974 6869 6e20 736f 7572 6365 es within source │ │ │ │ │ -000037f0: 2063 6f64 6520 616e 6420 6172 6520 6e6f code and are no │ │ │ │ │ -00003800: 740a 2020 2020 2064 6573 6372 6962 696e t. describin │ │ │ │ │ -00003810: 6720 6162 6f75 7420 7768 6174 2074 6865 g about what the │ │ │ │ │ -00003820: 2063 6861 6e67 6520 6c6f 6769 6361 6c6c change logicall │ │ │ │ │ -00003830: 7920 646f 6573 2e20 2050 6c65 6173 6520 y does. Please │ │ │ │ │ -00003840: 7365 650a 2020 2020 2065 7861 6d70 6c65 see. example │ │ │ │ │ -00003850: 7320 6672 6f6d 2070 7265 7669 6f75 7320 s from previous │ │ │ │ │ -00003860: 656e 7472 6965 732e 0a0a 2020 2020 2041 entries... A │ │ │ │ │ -00003870: 6c73 6f20 7265 6d65 6d62 6572 2074 6861 lso remember tha │ │ │ │ │ -00003880: 7420 4752 5542 2032 2069 7320 6c69 6365 t GRUB 2 is lice │ │ │ │ │ -00003890: 6e73 6564 2075 6e64 6572 2047 504c 7633 nsed under GPLv3 │ │ │ │ │ -000038a0: 206c 6963 656e 7365 2061 6e64 2074 6861 license and tha │ │ │ │ │ -000038b0: 740a 2020 2020 2075 7375 616c 6c79 206d t. usually m │ │ │ │ │ -000038c0: 6561 6e73 2074 6861 7420 796f 7520 6172 eans that you ar │ │ │ │ │ -000038d0: 6520 6e6f 7420 616c 6c6f 7765 6420 746f e not allowed to │ │ │ │ │ -000038e0: 2063 6f70 7920 7069 6563 6573 206f 6620 copy pieces of │ │ │ │ │ -000038f0: 636f 6465 2066 726f 6d0a 2020 2020 206f code from. o │ │ │ │ │ -00003900: 7468 6572 2070 726f 6a65 6374 732e 2020 ther projects. │ │ │ │ │ -00003910: 4576 656e 2069 6620 7468 6520 736f 7572 Even if the sour │ │ │ │ │ -00003920: 6365 2070 726f 6a65 6374 2773 206c 6963 ce project's lic │ │ │ │ │ -00003930: 656e 7365 2077 6f75 6c64 2062 650a 2020 ense would be. │ │ │ │ │ -00003940: 2020 2063 6f6d 7061 7469 626c 6520 7769 compatible wi │ │ │ │ │ -00003950: 7468 2047 504c 7633 2c20 706c 6561 7365 th GPLv3, please │ │ │ │ │ -00003960: 2064 6973 6375 7373 2069 7420 6265 666f discuss it befo │ │ │ │ │ -00003970: 7265 6861 6e64 206f 6e20 6772 7562 2d64 rehand on grub-d │ │ │ │ │ -00003980: 6576 656c 0a20 2020 2020 6d61 696c 696e evel. mailin │ │ │ │ │ -00003990: 6720 6c69 7374 2e0a 0a20 2020 2a20 5465 g list... * Te │ │ │ │ │ -000039a0: 7374 2079 6f75 7220 6368 616e 6765 2e0a st your change.. │ │ │ │ │ -000039b0: 0a20 2020 2020 5465 7374 2074 6861 7420 . Test that │ │ │ │ │ -000039c0: 796f 7572 2063 6861 6e67 6520 776f 726b your change work │ │ │ │ │ -000039d0: 7320 7072 6f70 6572 6c79 2e20 2054 7279 s properly. Try │ │ │ │ │ -000039e0: 2069 7420 6f75 7420 6120 636f 7570 6c65 it out a couple │ │ │ │ │ -000039f0: 206f 660a 2020 2020 2074 696d 6573 2c20 of. times, │ │ │ │ │ -00003a00: 7072 6566 6572 6162 6c79 206f 6e20 6469 preferably on di │ │ │ │ │ -00003a10: 6666 6572 656e 7420 7379 7374 656d 732c fferent systems, │ │ │ │ │ -00003a20: 2061 6e64 2074 7279 2074 6f20 6669 6e64 and try to find │ │ │ │ │ -00003a30: 2070 726f 626c 656d 730a 2020 2020 2077 problems. w │ │ │ │ │ -00003a40: 6974 6820 6974 2e0a 0a20 2020 2a20 5075 ith it... * Pu │ │ │ │ │ -00003a50: 626c 6973 6820 796f 7572 2063 6861 6e67 blish your chang │ │ │ │ │ -00003a60: 652e 0a0a 2020 2020 2057 6865 6e20 796f e... When yo │ │ │ │ │ -00003a70: 7520 6172 6520 6861 7070 7920 7769 7468 u are happy with │ │ │ │ │ -00003a80: 2079 6f75 7220 6368 616e 6765 2c20 6669 your change, fi │ │ │ │ │ -00003a90: 7273 7420 6d61 6b65 2073 7572 6520 6974 rst make sure it │ │ │ │ │ -00003aa0: 2069 730a 2020 2020 2063 6f6d 7069 6c61 is. compila │ │ │ │ │ -00003ab0: 626c 6520 7769 7468 206c 6174 6573 7420 ble with latest │ │ │ │ │ -00003ac0: 6465 7665 6c6f 706d 656e 7420 7665 7273 development vers │ │ │ │ │ -00003ad0: 696f 6e20 6f66 2047 5255 4220 322e 2020 ion of GRUB 2. │ │ │ │ │ -00003ae0: 4166 7465 7220 7468 6174 0a20 2020 2020 After that. │ │ │ │ │ -00003af0: 706c 6561 7365 2073 656e 6420 6120 7061 please send a pa │ │ │ │ │ -00003b00: 7463 6820 746f 2067 7275 622d 6465 7665 tch to grub-deve │ │ │ │ │ -00003b10: 6c20 666f 7220 7265 7669 6577 2e20 2050 l for review. P │ │ │ │ │ -00003b20: 6c65 6173 6520 6465 7363 7269 6265 2069 lease describe i │ │ │ │ │ -00003b30: 6e0a 2020 2020 2079 6f75 7220 656d 6169 n. your emai │ │ │ │ │ -00003b40: 6c20 7768 7920 796f 7520 6d61 6465 2074 l why you made t │ │ │ │ │ -00003b50: 6865 2063 6861 6e67 652c 2077 6861 7420 he change, what │ │ │ │ │ -00003b60: 6974 2063 6861 6e67 6573 2061 6e64 2073 it changes and s │ │ │ │ │ -00003b70: 6f20 6f6e 2e0a 2020 2020 2050 6c65 6173 o on.. Pleas │ │ │ │ │ -00003b80: 6520 6265 2070 7265 7061 7265 6420 746f e be prepared to │ │ │ │ │ -00003b90: 2072 6563 6569 7665 2065 7665 6e20 6469 receive even di │ │ │ │ │ -00003ba0: 7363 6f75 7261 6769 6e67 2063 6f6d 6d65 scouraging comme │ │ │ │ │ -00003bb0: 6e74 7320 6162 6f75 7420 796f 7572 0a20 nts about your. │ │ │ │ │ -00003bc0: 2020 2020 7061 7463 682e 2020 5468 6572 patch. Ther │ │ │ │ │ -00003bd0: 6520 6973 2075 7375 616c 6c79 2061 7420 e is usually at │ │ │ │ │ -00003be0: 6c65 6173 7420 736f 6d65 7468 696e 6720 least something │ │ │ │ │ -00003bf0: 7468 6174 206e 6565 6473 2074 6f20 6265 that needs to be │ │ │ │ │ -00003c00: 0a20 2020 2020 696d 7072 6f76 6564 2069 . improved i │ │ │ │ │ -00003c10: 6e20 6576 6572 7920 7061 7463 682e 0a0a n every patch... │ │ │ │ │ -00003c20: 2020 2020 2050 6c65 6173 6520 7573 6520 Please use │ │ │ │ │ -00003c30: 756e 6966 6965 6420 6469 6666 2074 6f20 unified diff to │ │ │ │ │ -00003c40: 6d61 6b65 2079 6f75 7220 7061 7463 6820 make your patch │ │ │ │ │ -00003c50: 2867 6f6f 6420 6d61 7463 6820 6f66 2061 (good match of a │ │ │ │ │ -00003c60: 7267 756d 656e 7473 0a20 2020 2020 666f rguments. fo │ │ │ │ │ -00003c70: 7220 6469 6666 2069 7320 272d 7072 754e r diff is '-pruN │ │ │ │ │ -00003c80: 2729 2e0a 0a20 2020 2a20 5265 7370 6f6e ')... * Respon │ │ │ │ │ -00003c90: 6420 746f 2072 6563 6569 7665 6420 6665 d to received fe │ │ │ │ │ -00003ca0: 6564 6261 636b 2e0a 0a20 2020 2020 4966 edback... If │ │ │ │ │ -00003cb0: 2079 6f75 2061 7265 2061 736b 6564 2074 you are asked t │ │ │ │ │ -00003cc0: 6f20 6d6f 6469 6679 2079 6f75 7220 7061 o modify your pa │ │ │ │ │ -00003cd0: 7463 682c 2070 6c65 6173 6520 646f 2074 tch, please do t │ │ │ │ │ -00003ce0: 6861 7420 616e 6420 7265 7375 626d 6974 hat and resubmit │ │ │ │ │ -00003cf0: 0a20 2020 2020 6974 2066 6f72 2072 6576 . it for rev │ │ │ │ │ -00003d00: 6965 772e 2020 4966 2079 6f75 7220 6368 iew. If your ch │ │ │ │ │ -00003d10: 616e 6765 2069 7320 6c61 7267 6520 796f ange is large yo │ │ │ │ │ -00003d20: 7520 6172 6520 7265 7175 6972 6564 2074 u are required t │ │ │ │ │ -00003d30: 6f20 7375 626d 6974 0a20 2020 2020 6120 o submit. a │ │ │ │ │ -00003d40: 636f 7079 7269 6768 7420 6167 7265 656d copyright agreem │ │ │ │ │ -00003d50: 656e 7420 746f 2046 5346 2e20 506c 6561 ent to FSF. Plea │ │ │ │ │ -00003d60: 7365 206b 6565 7020 696e 206d 696e 6420 se keep in mind │ │ │ │ │ -00003d70: 7468 6174 2069 6620 796f 7520 6172 650a that if you are. │ │ │ │ │ -00003d80: 2020 2020 2061 736b 6564 2074 6f20 7375 asked to su │ │ │ │ │ -00003d90: 626d 6974 2066 6f72 2063 6f70 7972 6967 bmit for copyrig │ │ │ │ │ -00003da0: 6874 2061 6772 6565 6d65 6e74 2c20 7072 ht agreement, pr │ │ │ │ │ -00003db0: 6f63 6573 7320 6361 6e20 7461 6b65 2073 ocess can take s │ │ │ │ │ -00003dc0: 6f6d 6520 7469 6d65 0a20 2020 2020 616e ome time. an │ │ │ │ │ -00003dd0: 6420 6973 206d 616e 6461 746f 7279 2069 d is mandatory i │ │ │ │ │ -00003de0: 6e20 6f72 6465 7220 746f 2067 6574 2079 n order to get y │ │ │ │ │ -00003df0: 6f75 7220 6368 616e 6765 7320 696e 7465 our changes inte │ │ │ │ │ -00003e00: 6772 6174 6564 2e0a 0a20 2020 2020 4966 grated... If │ │ │ │ │ -00003e10: 2079 6f75 2061 7265 206e 6f74 206f 6e20 you are not on │ │ │ │ │ -00003e20: 6772 7562 2d64 6576 656c 2074 6f20 7265 grub-devel to re │ │ │ │ │ -00003e30: 7370 6f6e 6420 746f 2071 7565 7374 696f spond to questio │ │ │ │ │ -00003e40: 6e73 2c20 6d6f 7374 206c 696b 656c 790a ns, most likely. │ │ │ │ │ -00003e50: 2020 2020 2079 6f75 7220 7061 7463 6820 your patch │ │ │ │ │ -00003e60: 7769 6c6c 206e 6f74 2062 6520 6163 6365 will not be acce │ │ │ │ │ -00003e70: 7074 6564 2e20 2041 6c73 6f20 6966 2070 pted. Also if p │ │ │ │ │ -00003e80: 726f 626c 656d 7320 6172 6973 6520 6672 roblems arise fr │ │ │ │ │ -00003e90: 6f6d 2079 6f75 720a 2020 2020 2063 6861 om your. cha │ │ │ │ │ -00003ea0: 6e67 6573 206c 6174 6572 206f 6e2c 2069 nges later on, i │ │ │ │ │ -00003eb0: 7420 776f 756c 6420 6265 2070 7265 6665 t would be prefe │ │ │ │ │ -00003ec0: 7261 626c 6520 7468 6174 2079 6f75 2061 rable that you a │ │ │ │ │ -00003ed0: 6c73 6f20 6669 7820 7468 650a 2020 2020 lso fix the. │ │ │ │ │ -00003ee0: 2070 726f 626c 656d 2e20 2053 6f20 7374 problem. So st │ │ │ │ │ -00003ef0: 6179 2061 726f 756e 6420 666f 7220 6120 ay around for a │ │ │ │ │ -00003f00: 7768 696c 652e 0a0a 2020 202a 2059 6f75 while... * You │ │ │ │ │ -00003f10: 7220 7061 7463 6820 6973 2061 6363 6570 r patch is accep │ │ │ │ │ -00003f20: 7465 642e 0a0a 2020 2020 2047 6f6f 6420 ted... Good │ │ │ │ │ -00003f30: 6a6f 6221 2020 596f 7572 2070 6174 6368 job! Your patch │ │ │ │ │ -00003f40: 2077 696c 6c20 6e6f 7720 6265 2069 6e74 will now be int │ │ │ │ │ -00003f50: 6567 7261 7465 6420 696e 746f 2047 5255 egrated into GRU │ │ │ │ │ -00003f60: 4220 3220 6d61 696e 6c69 6e65 2c0a 2020 B 2 mainline,. │ │ │ │ │ -00003f70: 2020 2061 6e64 2069 6620 6974 2064 6964 and if it did │ │ │ │ │ -00003f80: 6e27 7420 6272 6561 6b20 616e 7974 6869 n't break anythi │ │ │ │ │ -00003f90: 6e67 2069 7420 7769 6c6c 2062 6520 7075 ng it will be pu │ │ │ │ │ -00003fa0: 626c 6963 6c79 2061 7661 696c 6162 6c65 blicly available │ │ │ │ │ -00003fb0: 2069 6e0a 2020 2020 2074 6865 206e 6578 in. the nex │ │ │ │ │ -00003fc0: 7420 7265 6c65 6173 652e 0a0a 2020 2020 t release... │ │ │ │ │ -00003fd0: 204e 6f77 2079 6f75 2061 7265 2077 656c Now you are wel │ │ │ │ │ -00003fe0: 636f 6d65 2074 6f20 646f 2066 7572 7468 come to do furth │ │ │ │ │ -00003ff0: 6572 2069 6d70 726f 7665 6d65 6e74 7320 er improvements │ │ │ │ │ -00004000: 3a29 0a0a 1f0a 4669 6c65 3a20 6772 7562 :)....File: grub │ │ │ │ │ -00004010: 2d64 6576 2e69 6e66 6f2c 2020 4e6f 6465 -dev.info, Node │ │ │ │ │ -00004020: 3a20 5479 7069 6361 6c20 4465 7665 6c6f : Typical Develo │ │ │ │ │ -00004030: 7065 7220 4578 7065 7269 656e 6365 2c20 per Experience, │ │ │ │ │ -00004040: 204e 6578 743a 2057 6865 6e20 796f 7520 Next: When you │ │ │ │ │ -00004050: 6172 6520 6170 7072 6f76 6564 2066 6f72 are approved for │ │ │ │ │ -00004060: 2077 7269 7465 2061 6363 6573 7320 746f write access to │ │ │ │ │ -00004070: 2070 726f 6a65 6374 2773 2066 696c 6573 project's files │ │ │ │ │ -00004080: 2c20 2050 7265 763a 2047 6574 7469 6e67 , Prev: Getting │ │ │ │ │ -00004090: 2073 7461 7274 6564 2c20 2055 703a 2043 started, Up: C │ │ │ │ │ -000040a0: 6f6e 7472 6962 7574 696e 6720 4368 616e ontributing Chan │ │ │ │ │ -000040b0: 6765 730a 0a34 2e32 2054 7970 6963 616c ges..4.2 Typical │ │ │ │ │ -000040c0: 2044 6576 656c 6f70 6572 2045 7870 6572 Developer Exper │ │ │ │ │ -000040d0: 6965 6e63 650a 3d3d 3d3d 3d3d 3d3d 3d3d ience.========== │ │ │ │ │ +00001f90: 2a2a 2a0a 0a48 6572 6520 6973 2061 2062 ***..Here is a b │ │ │ │ │ +00001fa0: 7269 6566 206d 6170 206f 6620 7468 6520 rief map of the │ │ │ │ │ +00001fb0: 4752 5542 2063 6f64 6520 6261 7365 2e0a GRUB code base.. │ │ │ │ │ +00001fc0: 0a20 2020 4752 5542 2075 7365 7320 4175 . GRUB uses Au │ │ │ │ │ +00001fd0: 746f 636f 6e66 2061 6e64 2041 7574 6f6d toconf and Autom │ │ │ │ │ +00001fe0: 616b 652c 2077 6974 6820 6d6f 7374 206f ake, with most o │ │ │ │ │ +00001ff0: 6620 7468 6520 4175 746f 6d61 6b65 2069 f the Automake i │ │ │ │ │ +00002000: 6e70 7574 0a67 656e 6572 6174 6564 2062 nput.generated b │ │ │ │ │ +00002010: 7920 6120 5079 7468 6f6e 2073 6372 6970 y a Python scrip │ │ │ │ │ +00002020: 742e 2020 5468 6520 746f 702d 6c65 7665 t. The top-leve │ │ │ │ │ +00002030: 6c20 6275 696c 6420 7275 6c65 7320 6172 l build rules ar │ │ │ │ │ +00002040: 6520 696e 0a27 636f 6e66 6967 7572 652e e in.'configure. │ │ │ │ │ +00002050: 6163 272c 2027 6772 7562 2d63 6f72 652f ac', 'grub-core/ │ │ │ │ │ +00002060: 4d61 6b65 6669 6c65 2e63 6f72 652e 6465 Makefile.core.de │ │ │ │ │ +00002070: 6627 2c20 616e 6420 274d 616b 6566 696c f', and 'Makefil │ │ │ │ │ +00002080: 652e 7574 696c 2e64 6566 272e 0a45 6163 e.util.def'..Eac │ │ │ │ │ +00002090: 6820 626c 6f63 6b20 696e 2061 2027 2a2e h block in a '*. │ │ │ │ │ +000020a0: 6465 6627 2066 696c 6520 7265 7072 6573 def' file repres │ │ │ │ │ +000020b0: 656e 7473 2061 2062 7569 6c64 2074 6172 ents a build tar │ │ │ │ │ +000020c0: 6765 742c 2061 6e64 2073 7065 6369 6669 get, and specifi │ │ │ │ │ +000020d0: 6573 0a74 6865 2073 6f75 7263 6520 6669 es.the source fi │ │ │ │ │ +000020e0: 6c65 7320 7573 6564 2074 6f20 6275 696c les used to buil │ │ │ │ │ +000020f0: 6420 6974 206f 6e20 7661 7269 6f75 7320 d it on various │ │ │ │ │ +00002100: 706c 6174 666f 726d 732e 2020 5468 6520 platforms. The │ │ │ │ │ +00002110: 272a 2e64 6566 270a 6669 6c65 7320 6172 '*.def'.files ar │ │ │ │ │ +00002120: 6520 7072 6f63 6573 7365 6420 696e 746f e processed into │ │ │ │ │ +00002130: 2041 7574 6f6d 616b 6520 696e 7075 7420 Automake input │ │ │ │ │ +00002140: 6279 2027 6765 6e74 706c 2e70 7927 2028 by 'gentpl.py' ( │ │ │ │ │ +00002150: 7768 6963 6820 796f 7520 6f6e 6c79 0a6e which you only.n │ │ │ │ │ +00002160: 6565 6420 746f 206c 6f6f 6b20 6174 2069 eed to look at i │ │ │ │ │ +00002170: 6620 796f 7520 6172 6520 6578 7465 6e64 f you are extend │ │ │ │ │ +00002180: 696e 6720 7468 6520 6275 696c 6420 7379 ing the build sy │ │ │ │ │ +00002190: 7374 656d 292e 2020 4966 2079 6f75 2061 stem). If you a │ │ │ │ │ +000021a0: 7265 0a61 6464 696e 6720 6120 6e65 7720 re.adding a new │ │ │ │ │ +000021b0: 6d6f 6475 6c65 2077 6869 6368 2066 6f6c module which fol │ │ │ │ │ +000021c0: 6c6f 7773 2061 6e20 6578 6973 7469 6e67 lows an existing │ │ │ │ │ +000021d0: 2070 6174 7465 726e 2c20 7375 6368 2061 pattern, such a │ │ │ │ │ +000021e0: 7320 6120 6e65 770a 636f 6d6d 616e 6420 s a new.command │ │ │ │ │ +000021f0: 6f72 2061 206e 6577 2066 696c 6573 7973 or a new filesys │ │ │ │ │ +00002200: 7465 6d20 696d 706c 656d 656e 7461 7469 tem implementati │ │ │ │ │ +00002210: 6f6e 2c20 6974 2069 7320 7573 7561 6c6c on, it is usuall │ │ │ │ │ +00002220: 7920 6561 7369 6573 7420 746f 0a67 7265 y easiest to.gre │ │ │ │ │ +00002230: 7020 2767 7275 622d 636f 7265 2f4d 616b p 'grub-core/Mak │ │ │ │ │ +00002240: 6566 696c 652e 636f 7265 2e64 6566 2720 efile.core.def' │ │ │ │ │ +00002250: 616e 6420 274d 616b 6566 696c 652e 7574 and 'Makefile.ut │ │ │ │ │ +00002260: 696c 2e64 6566 2720 666f 7220 616e 0a65 il.def' for an.e │ │ │ │ │ +00002270: 7869 7374 696e 6720 6578 616d 706c 6520 xisting example │ │ │ │ │ +00002280: 6f66 2074 6861 7420 7061 7474 6572 6e20 of that pattern │ │ │ │ │ +00002290: 746f 2066 696e 6420 6f75 7420 7768 6572 to find out wher │ │ │ │ │ +000022a0: 6520 6974 2073 686f 756c 6420 6265 2061 e it should be a │ │ │ │ │ +000022b0: 6464 6564 2e0a 0a20 2020 496e 2067 656e dded... In gen │ │ │ │ │ +000022c0: 6572 616c 2c20 636f 6465 2074 6861 7420 eral, code that │ │ │ │ │ +000022d0: 6d61 7920 6265 2072 756e 2061 7420 626f may be run at bo │ │ │ │ │ +000022e0: 6f74 2074 696d 6520 6973 2069 6e20 6120 ot time is in a │ │ │ │ │ +000022f0: 7375 6264 6972 6563 746f 7279 206f 660a subdirectory of. │ │ │ │ │ +00002300: 2767 7275 622d 636f 7265 272c 2077 6869 'grub-core', whi │ │ │ │ │ +00002310: 6c65 2063 6f64 6520 7468 6174 2069 7320 le code that is │ │ │ │ │ +00002320: 6f6e 6c79 2072 756e 2066 726f 6d20 7769 only run from wi │ │ │ │ │ +00002330: 7468 696e 2061 2066 756c 6c20 6f70 6572 thin a full oper │ │ │ │ │ +00002340: 6174 696e 670a 7379 7374 656d 2069 7320 ating.system is │ │ │ │ │ +00002350: 696e 2061 2073 7562 6469 7265 6374 6f72 in a subdirector │ │ │ │ │ +00002360: 7920 6f66 2074 6865 2074 6f70 206c 6576 y of the top lev │ │ │ │ │ +00002370: 656c 2e0a 0a20 2020 4c6f 772d 6c65 7665 el... Low-leve │ │ │ │ │ +00002380: 6c20 626f 6f74 2063 6f64 652c 2073 7563 l boot code, suc │ │ │ │ │ +00002390: 6820 6173 2074 6865 204d 4252 2069 6d70 h as the MBR imp │ │ │ │ │ +000023a0: 6c65 6d65 6e74 6174 696f 6e20 6f6e 2050 lementation on P │ │ │ │ │ +000023b0: 4320 4249 4f53 0a73 7973 7465 6d73 2c20 C BIOS.systems, │ │ │ │ │ +000023c0: 6973 2069 6e20 7468 6520 2767 7275 622d is in the 'grub- │ │ │ │ │ +000023d0: 636f 7265 2f62 6f6f 742f 2720 6469 7265 core/boot/' dire │ │ │ │ │ +000023e0: 6374 6f72 792e 0a0a 2020 2054 6865 2047 ctory... The G │ │ │ │ │ +000023f0: 5255 4220 6b65 726e 656c 2069 7320 696e RUB kernel is in │ │ │ │ │ +00002400: 2027 6772 7562 2d63 6f72 652f 6b65 726e 'grub-core/kern │ │ │ │ │ +00002410: 2f27 2e20 2054 6869 7320 636f 6e74 6169 /'. This contai │ │ │ │ │ +00002420: 6e73 2063 6f72 650a 6661 6369 6c69 7469 ns core.faciliti │ │ │ │ │ +00002430: 6573 2073 7563 6820 6173 2074 6865 2064 es such as the d │ │ │ │ │ +00002440: 6576 6963 652c 2064 6973 6b2c 2061 6e64 evice, disk, and │ │ │ │ │ +00002450: 2066 696c 6520 6672 616d 6577 6f72 6b73 file frameworks │ │ │ │ │ +00002460: 2c20 656e 7669 726f 6e6d 656e 740a 7661 , environment.va │ │ │ │ │ +00002470: 7269 6162 6c65 2068 616e 646c 696e 672c riable handling, │ │ │ │ │ +00002480: 206c 6973 7420 7072 6f63 6573 7369 6e67 list processing │ │ │ │ │ +00002490: 2c20 616e 6420 736f 206f 6e2e 2020 5468 , and so on. Th │ │ │ │ │ +000024a0: 6520 6b65 726e 656c 2073 686f 756c 640a e kernel should. │ │ │ │ │ +000024b0: 636f 6e74 6169 6e20 656e 6f75 6768 2074 contain enough t │ │ │ │ │ +000024c0: 6f20 6765 7420 7570 2074 6f20 6120 7265 o get up to a re │ │ │ │ │ +000024d0: 7363 7565 2070 726f 6d70 742e 2020 4865 scue prompt. He │ │ │ │ │ +000024e0: 6164 6572 2066 696c 6573 2066 6f72 206b ader files for k │ │ │ │ │ +000024f0: 6572 6e65 6c0a 6661 6369 6c69 7469 6573 ernel.facilities │ │ │ │ │ +00002500: 2c20 616d 6f6e 6720 6f74 6865 7273 2c20 , among others, │ │ │ │ │ +00002510: 6172 6520 696e 2027 696e 636c 7564 652f are in 'include/ │ │ │ │ │ +00002520: 272e 0a0a 2020 2054 6572 6d69 6e61 6c20 '... Terminal │ │ │ │ │ +00002530: 696d 706c 656d 656e 7461 7469 6f6e 7320 implementations │ │ │ │ │ +00002540: 6172 6520 696e 2027 6772 7562 2d63 6f72 are in 'grub-cor │ │ │ │ │ +00002550: 652f 7465 726d 2f27 2e0a 0a20 2020 4469 e/term/'... Di │ │ │ │ │ +00002560: 736b 2061 6363 6573 7320 636f 6465 2069 sk access code i │ │ │ │ │ +00002570: 7320 7370 7265 6164 2061 6372 6f73 7320 s spread across │ │ │ │ │ +00002580: 2767 7275 622d 636f 7265 2f64 6973 6b2f 'grub-core/disk/ │ │ │ │ │ +00002590: 2720 2866 6f72 2061 6363 6573 7369 6e67 ' (for accessing │ │ │ │ │ +000025a0: 0a74 6865 2064 6973 6b20 6465 7669 6365 .the disk device │ │ │ │ │ +000025b0: 7320 7468 656d 7365 6c76 6573 292c 2027 s themselves), ' │ │ │ │ │ +000025c0: 6772 7562 2d63 6f72 652f 7061 7274 6d61 grub-core/partma │ │ │ │ │ +000025d0: 702f 2720 2866 6f72 2069 6e74 6572 7072 p/' (for interpr │ │ │ │ │ +000025e0: 6574 696e 670a 7061 7274 6974 696f 6e20 eting.partition │ │ │ │ │ +000025f0: 7461 626c 6520 6461 7461 292c 2061 6e64 table data), and │ │ │ │ │ +00002600: 2027 6772 7562 2d63 6f72 652f 6673 2f27 'grub-core/fs/' │ │ │ │ │ +00002610: 2028 666f 7220 6163 6365 7373 696e 6720 (for accessing │ │ │ │ │ +00002620: 6669 6c65 7379 7374 656d 7329 2e0a 4e6f filesystems)..No │ │ │ │ │ +00002630: 7465 2074 6861 742c 2077 6974 6820 7468 te that, with th │ │ │ │ │ +00002640: 6520 6f64 6420 7370 6563 6961 6c69 7365 e odd specialise │ │ │ │ │ +00002650: 6420 6578 6365 7074 696f 6e2c 2047 5255 d exception, GRU │ │ │ │ │ +00002660: 4220 6f6e 6c79 2063 6f6e 7461 696e 7320 B only contains │ │ │ │ │ +00002670: 636f 6465 0a74 6f20 5f72 6561 645f 2066 code.to _read_ f │ │ │ │ │ +00002680: 726f 6d20 6669 6c65 7379 7374 656d 7320 rom filesystems │ │ │ │ │ +00002690: 616e 6420 7472 6965 7320 746f 2061 766f and tries to avo │ │ │ │ │ +000026a0: 6964 2063 6f6e 7461 696e 696e 6720 616e id containing an │ │ │ │ │ +000026b0: 7920 636f 6465 2074 6f0a 5f77 7269 7465 y code to._write │ │ │ │ │ +000026c0: 5f20 746f 2066 696c 6573 7973 7465 6d73 _ to filesystems │ │ │ │ │ +000026d0: 3b20 7468 6973 206c 6574 7320 7573 2063 ; this lets us c │ │ │ │ │ +000026e0: 6f6e 6669 6465 6e74 6c79 2061 7373 7572 onfidently assur │ │ │ │ │ +000026f0: 6520 7573 6572 7320 7468 6174 2047 5255 e users that GRU │ │ │ │ │ +00002700: 420a 6361 6e6e 6f74 2062 6520 7265 7370 B.cannot be resp │ │ │ │ │ +00002710: 6f6e 7369 626c 6520 666f 7220 6669 6c65 onsible for file │ │ │ │ │ +00002720: 7379 7374 656d 2063 6f72 7275 7074 696f system corruptio │ │ │ │ │ +00002730: 6e2e 0a0a 2020 2050 4349 2061 6e64 2055 n... PCI and U │ │ │ │ │ +00002740: 5342 2062 7573 2068 616e 646c 696e 6720 SB bus handling │ │ │ │ │ +00002750: 6973 2069 6e20 2767 7275 622d 636f 7265 is in 'grub-core │ │ │ │ │ +00002760: 2f62 7573 2f27 2e0a 0a20 2020 5669 6465 /bus/'... Vide │ │ │ │ │ +00002770: 6f20 6861 6e64 6c69 6e67 2063 6f64 6520 o handling code │ │ │ │ │ +00002780: 6973 2069 6e20 2767 7275 622d 636f 7265 is in 'grub-core │ │ │ │ │ +00002790: 2f76 6964 656f 2f27 2e20 2054 6865 2067 /video/'. The g │ │ │ │ │ +000027a0: 7261 7068 6963 616c 206d 656e 750a 7379 raphical menu.sy │ │ │ │ │ +000027b0: 7374 656d 2075 7365 7320 7468 6973 2068 stem uses this h │ │ │ │ │ +000027c0: 6561 7669 6c79 2c20 6275 7420 6973 2069 eavily, but is i │ │ │ │ │ +000027d0: 6e20 6120 7365 7061 7261 7465 2064 6972 n a separate dir │ │ │ │ │ +000027e0: 6563 746f 7279 2c0a 2767 7275 622d 636f ectory,.'grub-co │ │ │ │ │ +000027f0: 7265 2f67 6678 6d65 6e75 2f27 2e0a 0a20 re/gfxmenu/'... │ │ │ │ │ +00002800: 2020 4d6f 7374 2063 6f6d 6d61 6e64 7320 Most commands │ │ │ │ │ +00002810: 6172 6520 696d 706c 656d 656e 7465 6420 are implemented │ │ │ │ │ +00002820: 6279 2066 696c 6573 2069 6e20 2767 7275 by files in 'gru │ │ │ │ │ +00002830: 622d 636f 7265 2f63 6f6d 6d61 6e64 732f b-core/commands/ │ │ │ │ │ +00002840: 272c 2077 6974 680a 7468 6520 666f 6c6c ', with.the foll │ │ │ │ │ +00002850: 6f77 696e 6720 6578 6365 7074 696f 6e73 owing exceptions │ │ │ │ │ +00002860: 3a0a 0a20 2020 2a20 4120 6665 7720 636f :.. * A few co │ │ │ │ │ +00002870: 7265 2063 6f6d 6d61 6e64 7320 6c69 7665 re commands live │ │ │ │ │ +00002880: 2069 6e20 2767 7275 622d 636f 7265 2f6b in 'grub-core/k │ │ │ │ │ +00002890: 6572 6e2f 636f 7265 636d 642e 6327 2e0a ern/corecmd.c'.. │ │ │ │ │ +000028a0: 0a20 2020 2a20 436f 6d6d 616e 6473 2072 . * Commands r │ │ │ │ │ +000028b0: 656c 6174 6564 2074 6f20 6e6f 726d 616c elated to normal │ │ │ │ │ +000028c0: 206d 6f64 6520 6c69 7665 2075 6e64 6572 mode live under │ │ │ │ │ +000028d0: 2027 6772 7562 2d63 6f72 652f 6e6f 726d 'grub-core/norm │ │ │ │ │ +000028e0: 616c 2f27 2e0a 0a20 2020 2a20 436f 6d6d al/'... * Comm │ │ │ │ │ +000028f0: 616e 6473 2074 6861 7420 6c6f 6164 2061 ands that load a │ │ │ │ │ +00002900: 6e64 2062 6f6f 7420 6b65 726e 656c 7320 nd boot kernels │ │ │ │ │ +00002910: 6c69 7665 2075 6e64 6572 2027 6772 7562 live under 'grub │ │ │ │ │ +00002920: 2d63 6f72 652f 6c6f 6164 6572 2f27 2e0a -core/loader/'.. │ │ │ │ │ +00002930: 0a20 2020 2a20 5468 6520 276c 6f6f 7062 . * The 'loopb │ │ │ │ │ +00002940: 6163 6b27 2063 6f6d 6d61 6e64 2069 7320 ack' command is │ │ │ │ │ +00002950: 7265 616c 6c79 2061 2064 6973 6b20 6465 really a disk de │ │ │ │ │ +00002960: 7669 6365 2c20 616e 6420 736f 206c 6976 vice, and so liv │ │ │ │ │ +00002970: 6573 2069 6e0a 2020 2020 2027 6772 7562 es in. 'grub │ │ │ │ │ +00002980: 2d63 6f72 652f 6469 736b 2f6c 6f6f 7062 -core/disk/loopb │ │ │ │ │ +00002990: 6163 6b2e 6327 2e0a 0a20 2020 2a20 5468 ack.c'... * Th │ │ │ │ │ +000029a0: 6520 2767 6574 7465 7874 2720 636f 6d6d e 'gettext' comm │ │ │ │ │ +000029b0: 616e 6420 6c69 7665 7320 756e 6465 7220 and lives under │ │ │ │ │ +000029c0: 2767 7275 622d 636f 7265 2f67 6574 7465 'grub-core/gette │ │ │ │ │ +000029d0: 7874 2f27 2e0a 0a20 2020 2a20 5468 6520 xt/'... * The │ │ │ │ │ +000029e0: 276c 6f61 6466 6f6e 7427 2061 6e64 2027 'loadfont' and ' │ │ │ │ │ +000029f0: 6c73 666f 6e74 7327 2063 6f6d 6d61 6e64 lsfonts' command │ │ │ │ │ +00002a00: 7320 6c69 7665 2075 6e64 6572 2027 6772 s live under 'gr │ │ │ │ │ +00002a10: 7562 2d63 6f72 652f 666f 6e74 2f27 2e0a ub-core/font/'.. │ │ │ │ │ +00002a20: 0a20 2020 2a20 5468 6520 2773 6572 6961 . * The 'seria │ │ │ │ │ +00002a30: 6c27 2c20 2774 6572 6d69 6e66 6f27 2c20 l', 'terminfo', │ │ │ │ │ +00002a40: 616e 6420 2762 6163 6b67 726f 756e 645f and 'background_ │ │ │ │ │ +00002a50: 696d 6167 6527 2063 6f6d 6d61 6e64 7320 image' commands │ │ │ │ │ +00002a60: 6c69 7665 0a20 2020 2020 756e 6465 7220 live. under │ │ │ │ │ +00002a70: 2767 7275 622d 636f 7265 2f74 6572 6d2f 'grub-core/term/ │ │ │ │ │ +00002a80: 272e 0a0a 2020 202a 2054 6865 2027 6566 '... * The 'ef │ │ │ │ │ +00002a90: 6965 6d75 5f2a 2720 636f 6d6d 616e 6473 iemu_*' commands │ │ │ │ │ +00002aa0: 206c 6976 6520 756e 6465 7220 2767 7275 live under 'gru │ │ │ │ │ +00002ab0: 622d 636f 7265 2f65 6669 656d 752f 272e b-core/efiemu/'. │ │ │ │ │ +00002ac0: 0a0a 2020 202a 204f 532d 6465 7065 6e64 .. * OS-depend │ │ │ │ │ +00002ad0: 656e 7420 636f 6465 2073 686f 756c 6420 ent code should │ │ │ │ │ +00002ae0: 6265 2075 6e64 6572 2027 6772 7562 2d63 be under 'grub-c │ │ │ │ │ +00002af0: 6f72 652f 6f73 6465 702f 270a 0a20 2020 ore/osdep/'.. │ │ │ │ │ +00002b00: 2a20 5574 696c 6974 7920 7072 6f67 7261 * Utility progra │ │ │ │ │ +00002b10: 6d73 206d 6561 6e74 2074 6f20 6265 2072 ms meant to be r │ │ │ │ │ +00002b20: 756e 2066 726f 6d20 6120 6675 6c6c 206f un from a full o │ │ │ │ │ +00002b30: 7065 7261 7469 6e67 2073 7973 7465 6d0a perating system. │ │ │ │ │ +00002b40: 2020 2020 2028 6578 6365 7074 204f 532d (except OS- │ │ │ │ │ +00002b50: 6465 7065 6e64 656e 7420 636f 6465 206d dependent code m │ │ │ │ │ +00002b60: 656e 7469 6f6e 6564 2070 7265 7669 6f75 entioned previou │ │ │ │ │ +00002b70: 736c 7929 2061 7265 2069 6e20 2775 7469 sly) are in 'uti │ │ │ │ │ +00002b80: 6c2f 272e 0a0a 2020 2054 6865 7265 2061 l/'... There a │ │ │ │ │ +00002b90: 7265 2061 2066 6577 206f 7468 6572 2073 re a few other s │ │ │ │ │ +00002ba0: 7065 6369 616c 2d70 7572 706f 7365 2065 pecial-purpose e │ │ │ │ │ +00002bb0: 7863 6570 7469 6f6e 733b 2067 7265 7020 xceptions; grep │ │ │ │ │ +00002bc0: 666f 7220 7468 656d 2069 660a 7468 6579 for them if.they │ │ │ │ │ +00002bd0: 206d 6174 7465 7220 746f 2079 6f75 2e0a matter to you.. │ │ │ │ │ +00002be0: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ │ +00002bf0: 762e 696e 666f 2c20 204e 6f64 653a 2043 v.info, Node: C │ │ │ │ │ +00002c00: 6f6e 7472 6962 7574 696e 6720 4368 616e ontributing Chan │ │ │ │ │ +00002c10: 6765 732c 2020 4e65 7874 3a20 5570 6461 ges, Next: Upda │ │ │ │ │ +00002c20: 7469 6e67 2045 7874 6572 6e61 6c20 436f ting External Co │ │ │ │ │ +00002c30: 6465 2c20 2050 7265 763a 2046 696e 6469 de, Prev: Findi │ │ │ │ │ +00002c40: 6e67 2079 6f75 7220 7761 7920 6172 6f75 ng your way arou │ │ │ │ │ +00002c50: 6e64 2c20 2055 703a 2054 6f70 0a0a 3420 nd, Up: Top..4 │ │ │ │ │ +00002c60: 436f 6e74 7269 6275 7469 6e67 2063 6861 Contributing cha │ │ │ │ │ +00002c70: 6e67 6573 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a nges.*********** │ │ │ │ │ +00002c80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a43 6f6e ***********..Con │ │ │ │ │ +00002c90: 7472 6962 7574 696e 6720 6368 616e 6765 tributing change │ │ │ │ │ +00002ca0: 7320 746f 2047 5255 4220 3220 6973 2077 s to GRUB 2 is w │ │ │ │ │ +00002cb0: 656c 636f 6d65 6420 6163 7469 7669 7479 elcomed activity │ │ │ │ │ +00002cc0: 2e20 2048 6f77 6576 6572 2077 6520 6861 . However we ha │ │ │ │ │ +00002cd0: 7665 2061 0a62 6974 206f 6620 636f 6e74 ve a.bit of cont │ │ │ │ │ +00002ce0: 726f 6c20 7768 6174 206b 696e 6420 6f66 rol what kind of │ │ │ │ │ +00002cf0: 2063 6861 6e67 6573 2077 696c 6c20 6265 changes will be │ │ │ │ │ +00002d00: 2061 6363 6570 7465 6420 746f 2047 5255 accepted to GRU │ │ │ │ │ +00002d10: 4220 322e 0a54 6865 7265 666f 7265 2069 B 2..Therefore i │ │ │ │ │ +00002d20: 7420 6973 2069 6d70 6f72 7461 6e74 2074 t is important t │ │ │ │ │ +00002d30: 6f20 6469 7363 7573 7320 796f 7572 2063 o discuss your c │ │ │ │ │ +00002d40: 6861 6e67 6573 206f 6e20 6772 7562 2d64 hanges on grub-d │ │ │ │ │ +00002d50: 6576 656c 206d 6169 6c69 6e67 0a6c 6973 evel mailing.lis │ │ │ │ │ +00002d60: 7420 2873 6565 204d 6169 6c69 6e67 4c69 t (see MailingLi │ │ │ │ │ +00002d70: 7374 7329 2e20 204f 6e20 7468 6973 2070 sts). On this p │ │ │ │ │ +00002d80: 6167 6520 7468 6572 6520 6172 6520 736f age there are so │ │ │ │ │ +00002d90: 6d65 2062 6173 6963 2064 6574 6169 6c73 me basic details │ │ │ │ │ +00002da0: 206f 6e0a 7468 6520 6465 7665 6c6f 706d on.the developm │ │ │ │ │ +00002db0: 656e 7420 7072 6f63 6573 7320 616e 6420 ent process and │ │ │ │ │ +00002dc0: 6163 7469 7669 7469 6573 2e0a 0a20 2020 activities... │ │ │ │ │ +00002dd0: 4669 7273 7420 6f66 2061 6c6c 2079 6f75 First of all you │ │ │ │ │ +00002de0: 2073 686f 756c 6420 636f 6d65 2075 7020 should come up │ │ │ │ │ +00002df0: 7769 7468 2074 6865 2069 6465 6120 796f with the idea yo │ │ │ │ │ +00002e00: 7572 7365 6c66 2077 6861 7420 796f 7520 urself what you │ │ │ │ │ +00002e10: 7761 6e74 0a74 6f20 636f 6e74 7269 6275 want.to contribu │ │ │ │ │ +00002e20: 7465 2e20 2049 6620 796f 7520 646f 206e te. If you do n │ │ │ │ │ +00002e30: 6f74 2068 6176 6520 7468 6174 2062 6566 ot have that bef │ │ │ │ │ +00002e40: 6f72 6568 616e 6420 796f 7520 6172 6520 orehand you are │ │ │ │ │ +00002e50: 6164 7669 7365 6420 746f 0a73 7475 6479 advised to.study │ │ │ │ │ +00002e60: 2074 6869 7320 6d61 6e75 616c 2061 6e64 this manual and │ │ │ │ │ +00002e70: 2074 7279 2047 5255 4220 3220 6f75 7420 try GRUB 2 out │ │ │ │ │ +00002e80: 746f 2073 6565 2077 6861 7420 796f 7520 to see what you │ │ │ │ │ +00002e90: 7468 696e 6b20 6973 206d 6973 7369 6e67 think is missing │ │ │ │ │ +00002ea0: 0a66 726f 6d20 7468 6572 652e 0a0a 2020 .from there... │ │ │ │ │ +00002eb0: 2048 6572 6520 6172 6520 6164 6469 7469 Here are additi │ │ │ │ │ +00002ec0: 6f6e 616c 2070 6f69 6e74 6572 733a 0a20 onal pointers:. │ │ │ │ │ +00002ed0: 2020 2a20 3c68 7474 7073 3a2f 2f73 6176 * . * .. If y │ │ │ │ │ +00002f60: 6f75 2069 6e74 656e 6465 6420 746f 206d ou intended to m │ │ │ │ │ +00002f70: 616b 6520 6368 616e 6765 7320 746f 2047 ake changes to G │ │ │ │ │ +00002f80: 5255 4220 4c65 6761 6379 2028 3c3d 302e RUB Legacy (<=0. │ │ │ │ │ +00002f90: 3937 2920 7468 6f73 6520 6172 6520 6e6f 97) those are no │ │ │ │ │ +00002fa0: 740a 6163 6365 7074 6564 2061 6e79 6d6f t.accepted anymo │ │ │ │ │ +00002fb0: 7265 2e0a 0a2a 204d 656e 753a 0a0a 2a20 re...* Menu:..* │ │ │ │ │ +00002fc0: 4765 7474 696e 6720 7374 6172 7465 643a Getting started: │ │ │ │ │ +00002fd0: 3a0a 2a20 5479 7069 6361 6c20 4465 7665 :.* Typical Deve │ │ │ │ │ +00002fe0: 6c6f 7065 7220 4578 7065 7269 656e 6365 loper Experience │ │ │ │ │ +00002ff0: 3a3a 0a2a 2057 6865 6e20 796f 7520 6172 ::.* When you ar │ │ │ │ │ +00003000: 6520 6170 7072 6f76 6564 2066 6f72 2077 e approved for w │ │ │ │ │ +00003010: 7269 7465 2061 6363 6573 7320 746f 2070 rite access to p │ │ │ │ │ +00003020: 726f 6a65 6374 2773 2066 696c 6573 3a3a roject's files:: │ │ │ │ │ +00003030: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2d64 ....File: grub-d │ │ │ │ │ +00003040: 6576 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ev.info, Node: │ │ │ │ │ +00003050: 4765 7474 696e 6720 7374 6172 7465 642c Getting started, │ │ │ │ │ +00003060: 2020 4e65 7874 3a20 5479 7069 6361 6c20 Next: Typical │ │ │ │ │ +00003070: 4465 7665 6c6f 7065 7220 4578 7065 7269 Developer Experi │ │ │ │ │ +00003080: 656e 6365 2c20 2055 703a 2043 6f6e 7472 ence, Up: Contr │ │ │ │ │ +00003090: 6962 7574 696e 6720 4368 616e 6765 730a ibuting Changes. │ │ │ │ │ +000030a0: 0a34 2e31 2047 6574 7469 6e67 2073 7461 .4.1 Getting sta │ │ │ │ │ +000030b0: 7274 6564 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d rted.=========== │ │ │ │ │ +000030c0: 3d3d 3d3d 3d3d 3d3d 0a0a 2020 202a 2041 ========.. * A │ │ │ │ │ +000030d0: 6c77 6179 7320 7573 6520 6c61 7465 7374 lways use latest │ │ │ │ │ +000030e0: 2047 5255 4220 3220 736f 7572 6365 2063 GRUB 2 source c │ │ │ │ │ +000030f0: 6f64 652e 2020 536f 2067 6574 2074 6861 ode. So get tha │ │ │ │ │ +00003100: 7420 6669 7273 742e 0a0a 2020 2020 2046 t first... F │ │ │ │ │ +00003110: 6f72 2064 6576 656c 6f70 6572 7320 6974 or developers it │ │ │ │ │ +00003120: 2069 7320 7265 636f 6d6d 656e 6465 6420 is recommended │ │ │ │ │ +00003130: 616c 7761 7973 2074 6f20 7573 6520 7468 always to use th │ │ │ │ │ +00003140: 6520 6e65 7765 7374 0a20 2020 2020 6465 e newest. de │ │ │ │ │ +00003150: 7665 6c6f 706d 656e 7420 7665 7273 696f velopment versio │ │ │ │ │ +00003160: 6e20 6f66 2047 5255 4220 322e 2020 4966 n of GRUB 2. If │ │ │ │ │ +00003170: 2064 6576 656c 6f70 6d65 6e74 2074 616b development tak │ │ │ │ │ +00003180: 6573 2061 206c 6f6e 6720 7065 7269 6f64 es a long period │ │ │ │ │ +00003190: 0a20 2020 2020 6f66 2074 696d 652c 2070 . of time, p │ │ │ │ │ +000031a0: 6c65 6173 6520 7265 6d65 6d62 6572 2074 lease remember t │ │ │ │ │ +000031b0: 6f20 6b65 6570 2069 6e20 7379 6e63 2077 o keep in sync w │ │ │ │ │ +000031c0: 6974 6820 6e65 7765 7374 2064 6576 656c ith newest devel │ │ │ │ │ +000031d0: 6f70 6d65 6e74 730a 2020 2020 2072 6567 opments. reg │ │ │ │ │ +000031e0: 756c 6172 6c79 2073 6f20 6974 2069 7320 ularly so it is │ │ │ │ │ +000031f0: 6d75 6368 2065 6173 6965 7220 746f 2069 much easier to i │ │ │ │ │ +00003200: 6e74 6567 7261 7465 2079 6f75 7220 6368 ntegrate your ch │ │ │ │ │ +00003210: 616e 6765 2069 6e20 7468 650a 2020 2020 ange in the. │ │ │ │ │ +00003220: 2066 7574 7572 652e 2020 4752 5542 2032 future. GRUB 2 │ │ │ │ │ +00003230: 2069 7320 6265 696e 6720 6465 7665 6c6f is being develo │ │ │ │ │ +00003240: 7065 6420 696e 2061 2047 4954 2072 6570 ped in a GIT rep │ │ │ │ │ +00003250: 6f73 6974 6f72 792e 0a0a 2020 2020 2050 ository... P │ │ │ │ │ +00003260: 6c65 6173 6520 6368 6563 6b20 5361 7661 lease check Sava │ │ │ │ │ +00003270: 6e6e 6168 2773 2047 5255 4220 7072 6f6a nnah's GRUB proj │ │ │ │ │ +00003280: 6563 7420 7061 6765 2066 6f72 2064 6574 ect page for det │ │ │ │ │ +00003290: 6169 6c73 2068 6f77 2074 6f20 6765 740a ails how to get. │ │ │ │ │ +000032a0: 2020 2020 206e 6577 6573 7420 6769 743a newest git: │ │ │ │ │ +000032b0: 2047 5255 4220 3220 6769 7420 5265 706f GRUB 2 git Repo │ │ │ │ │ +000032c0: 7369 746f 7279 0a20 2020 2020 2868 7474 sitory. (htt │ │ │ │ │ +000032d0: 7073 3a2f 2f73 6176 616e 6e61 682e 676e ps://savannah.gn │ │ │ │ │ +000032e0: 752e 6f72 672f 6769 742f 3f67 726f 7570 u.org/git/?group │ │ │ │ │ +000032f0: 3d67 7275 6229 0a0a 2020 202a 2043 6f6d =grub).. * Com │ │ │ │ │ +00003300: 7069 6c65 2069 7420 616e 6420 7472 7920 pile it and try │ │ │ │ │ +00003310: 6974 206f 7574 2e0a 0a20 2020 2020 4974 it out... It │ │ │ │ │ +00003320: 2069 7320 616c 7761 7973 2067 6f6f 6420 is always good │ │ │ │ │ +00003330: 6964 6561 2074 6f20 6669 7273 7420 7365 idea to first se │ │ │ │ │ +00003340: 6520 7468 6174 2074 6869 6e67 7320 776f e that things wo │ │ │ │ │ +00003350: 726b 2073 6f6d 6568 6f77 2061 6e64 0a20 rk somehow and. │ │ │ │ │ +00003360: 2020 2020 6166 7465 7220 7468 6174 2074 after that t │ │ │ │ │ +00003370: 6f20 7374 6172 7420 746f 2069 6d70 6c65 o start to imple │ │ │ │ │ +00003380: 6d65 6e74 206e 6577 2066 6561 7475 7265 ment new feature │ │ │ │ │ +00003390: 7320 6f72 2064 6576 656c 6f70 2066 6978 s or develop fix │ │ │ │ │ +000033a0: 6573 2074 6f0a 2020 2020 2062 7567 732e es to. bugs. │ │ │ │ │ +000033b0: 0a0a 2020 202a 2053 7475 6479 2074 6865 .. * Study the │ │ │ │ │ +000033c0: 2063 6f64 652e 0a0a 2020 2020 2054 6865 code... The │ │ │ │ │ +000033d0: 7265 2061 7265 2073 6f6d 6574 696d 6573 re are sometimes │ │ │ │ │ +000033e0: 206f 6464 2077 6179 7320 746f 2064 6f20 odd ways to do │ │ │ │ │ +000033f0: 7468 696e 6773 2069 6e20 4752 5542 2032 things in GRUB 2 │ │ │ │ │ +00003400: 2063 6f64 6520 6261 7365 2e0a 2020 2020 code base.. │ │ │ │ │ +00003410: 2054 6869 7320 6973 206d 6169 6e6c 7920 This is mainly │ │ │ │ │ +00003420: 7265 6c61 7465 6420 746f 206c 696d 6974 related to limit │ │ │ │ │ +00003430: 6564 2065 6e76 6972 6f6e 6d65 6e74 2077 ed environment w │ │ │ │ │ +00003440: 6865 7265 2047 5255 4220 3220 6973 2062 here GRUB 2 is b │ │ │ │ │ +00003450: 6569 6e67 0a20 2020 2020 6578 6563 7574 eing. execut │ │ │ │ │ +00003460: 6564 2e20 2059 6f75 2075 7375 616c 6c79 ed. You usually │ │ │ │ │ +00003470: 2064 6f20 6e6f 7420 6e65 6564 2074 6f20 do not need to │ │ │ │ │ +00003480: 756e 6465 7273 7461 6e64 2069 7420 616c understand it al │ │ │ │ │ +00003490: 6c20 736f 2069 7420 6973 0a20 2020 2020 l so it is. │ │ │ │ │ +000034a0: 6265 7474 6572 2074 6f20 6f6e 6c79 2074 better to only t │ │ │ │ │ +000034b0: 7279 2074 6f20 6c6f 6f6b 2061 7420 706c ry to look at pl │ │ │ │ │ +000034c0: 6163 6573 2074 6861 7420 7265 6c61 7465 aces that relate │ │ │ │ │ +000034d0: 7320 746f 2079 6f75 7220 776f 726b 2e0a s to your work.. │ │ │ │ │ +000034e0: 2020 2020 2050 6c65 6173 6520 646f 206e Please do n │ │ │ │ │ +000034f0: 6f74 2068 6573 6974 6174 6520 746f 2061 ot hesitate to a │ │ │ │ │ +00003500: 736b 2066 6f72 2068 656c 7020 6966 2074 sk for help if t │ │ │ │ │ +00003510: 6865 7265 2069 7320 736f 6d65 7468 696e here is somethin │ │ │ │ │ +00003520: 6720 7468 6174 0a20 2020 2020 796f 7520 g that. you │ │ │ │ │ +00003530: 646f 206e 6f74 2075 6e64 6572 7374 616e do not understan │ │ │ │ │ +00003540: 642e 0a0a 2020 202a 2044 6576 656c 6f70 d... * Develop │ │ │ │ │ +00003550: 2061 206e 6577 2066 6561 7475 7265 2e0a a new feature.. │ │ │ │ │ +00003560: 0a20 2020 2020 4e6f 7720 7468 6174 2079 . Now that y │ │ │ │ │ +00003570: 6f75 206b 6e6f 7720 7768 6174 2074 6f20 ou know what to │ │ │ │ │ +00003580: 646f 2061 6e64 2068 6f77 2069 7420 7368 do and how it sh │ │ │ │ │ +00003590: 6f75 6c64 2077 6f72 6b20 696e 2047 5255 ould work in GRU │ │ │ │ │ +000035a0: 4220 3220 636f 6465 0a20 2020 2020 6261 B 2 code. ba │ │ │ │ │ +000035b0: 7365 2c20 706c 6561 7365 2062 6520 6672 se, please be fr │ │ │ │ │ +000035c0: 6565 2074 6f20 6465 7665 6c6f 7020 6974 ee to develop it │ │ │ │ │ +000035d0: 2e20 2049 6620 796f 7520 6861 7665 206e . If you have n │ │ │ │ │ +000035e0: 6f74 2073 6f20 6661 720a 2020 2020 2061 ot so far. a │ │ │ │ │ +000035f0: 6e6e 6f75 6e63 6564 2079 6f75 7220 6964 nnounced your id │ │ │ │ │ +00003600: 6561 206f 6e20 6772 7562 2d64 6576 656c ea on grub-devel │ │ │ │ │ +00003610: 206d 6169 6c69 6e67 206c 6973 742c 2070 mailing list, p │ │ │ │ │ +00003620: 6c65 6173 6520 646f 2069 7420 6e6f 772e lease do it now. │ │ │ │ │ +00003630: 0a20 2020 2020 5468 6973 2069 7320 746f . This is to │ │ │ │ │ +00003640: 206d 616b 6520 7375 7265 2079 6f75 2061 make sure you a │ │ │ │ │ +00003650: 7265 206e 6f74 2077 6173 7469 6e67 2079 re not wasting y │ │ │ │ │ +00003660: 6f75 7220 7469 6d65 2077 6f72 6b69 6e67 our time working │ │ │ │ │ +00003670: 206f 6e20 7468 650a 2020 2020 2073 6f6c on the. sol │ │ │ │ │ +00003680: 7574 696f 6e20 7468 6174 2077 696c 6c20 ution that will │ │ │ │ │ +00003690: 6e6f 7420 6265 2069 6e74 6567 7261 7465 not be integrate │ │ │ │ │ +000036a0: 6420 746f 2047 5255 4220 3220 636f 6465 d to GRUB 2 code │ │ │ │ │ +000036b0: 2062 6173 652e 0a0a 2020 2020 2059 6f75 base... You │ │ │ │ │ +000036c0: 206d 6967 6874 2077 616e 7420 746f 2073 might want to s │ │ │ │ │ +000036d0: 7475 6479 206f 7572 2063 6f64 696e 6720 tudy our coding │ │ │ │ │ +000036e0: 7374 796c 6520 6265 666f 7265 2073 7461 style before sta │ │ │ │ │ +000036f0: 7274 696e 670a 2020 2020 2064 6576 656c rting. devel │ │ │ │ │ +00003700: 6f70 6d65 6e74 2073 6f20 796f 7520 646f opment so you do │ │ │ │ │ +00003710: 206e 6f74 206e 6565 6420 746f 2063 6861 not need to cha │ │ │ │ │ +00003720: 6e67 6520 6d75 6368 206f 6620 7468 6520 nge much of the │ │ │ │ │ +00003730: 636f 6465 2077 6865 6e20 796f 7572 0a20 code when your. │ │ │ │ │ +00003740: 2020 2020 7061 7463 6820 6973 2062 6569 patch is bei │ │ │ │ │ +00003750: 6e67 2072 6576 6965 7765 642e 2020 2873 ng reviewed. (s │ │ │ │ │ +00003760: 6565 202a 6e6f 7465 2043 6f64 696e 6720 ee *note Coding │ │ │ │ │ +00003770: 7374 796c 653a 3a29 0a0a 2020 2020 2046 style::).. F │ │ │ │ │ +00003780: 6f72 2065 7665 7279 2061 6363 6570 7465 or every accepte │ │ │ │ │ +00003790: 6420 7061 7463 6820 7468 6572 6520 6861 d patch there ha │ │ │ │ │ +000037a0: 7320 746f 2065 7869 7374 2061 2043 6861 s to exist a Cha │ │ │ │ │ +000037b0: 6e67 654c 6f67 2065 6e74 7279 2e20 204f ngeLog entry. O │ │ │ │ │ +000037c0: 7572 0a20 2020 2020 4368 616e 6765 4c6f ur. ChangeLo │ │ │ │ │ +000037d0: 6720 636f 6e73 6973 7420 6f66 2063 6861 g consist of cha │ │ │ │ │ +000037e0: 6e67 6573 2077 6974 6869 6e20 736f 7572 nges within sour │ │ │ │ │ +000037f0: 6365 2063 6f64 6520 616e 6420 6172 6520 ce code and are │ │ │ │ │ +00003800: 6e6f 740a 2020 2020 2064 6573 6372 6962 not. describ │ │ │ │ │ +00003810: 696e 6720 6162 6f75 7420 7768 6174 2074 ing about what t │ │ │ │ │ +00003820: 6865 2063 6861 6e67 6520 6c6f 6769 6361 he change logica │ │ │ │ │ +00003830: 6c6c 7920 646f 6573 2e20 2050 6c65 6173 lly does. Pleas │ │ │ │ │ +00003840: 6520 7365 650a 2020 2020 2065 7861 6d70 e see. examp │ │ │ │ │ +00003850: 6c65 7320 6672 6f6d 2070 7265 7669 6f75 les from previou │ │ │ │ │ +00003860: 7320 656e 7472 6965 732e 0a0a 2020 2020 s entries... │ │ │ │ │ +00003870: 2041 6c73 6f20 7265 6d65 6d62 6572 2074 Also remember t │ │ │ │ │ +00003880: 6861 7420 4752 5542 2032 2069 7320 6c69 hat GRUB 2 is li │ │ │ │ │ +00003890: 6365 6e73 6564 2075 6e64 6572 2047 504c censed under GPL │ │ │ │ │ +000038a0: 7633 206c 6963 656e 7365 2061 6e64 2074 v3 license and t │ │ │ │ │ +000038b0: 6861 740a 2020 2020 2075 7375 616c 6c79 hat. usually │ │ │ │ │ +000038c0: 206d 6561 6e73 2074 6861 7420 796f 7520 means that you │ │ │ │ │ +000038d0: 6172 6520 6e6f 7420 616c 6c6f 7765 6420 are not allowed │ │ │ │ │ +000038e0: 746f 2063 6f70 7920 7069 6563 6573 206f to copy pieces o │ │ │ │ │ +000038f0: 6620 636f 6465 2066 726f 6d0a 2020 2020 f code from. │ │ │ │ │ +00003900: 206f 7468 6572 2070 726f 6a65 6374 732e other projects. │ │ │ │ │ +00003910: 2020 4576 656e 2069 6620 7468 6520 736f Even if the so │ │ │ │ │ +00003920: 7572 6365 2070 726f 6a65 6374 2773 206c urce project's l │ │ │ │ │ +00003930: 6963 656e 7365 2077 6f75 6c64 2062 650a icense would be. │ │ │ │ │ +00003940: 2020 2020 2063 6f6d 7061 7469 626c 6520 compatible │ │ │ │ │ +00003950: 7769 7468 2047 504c 7633 2c20 706c 6561 with GPLv3, plea │ │ │ │ │ +00003960: 7365 2064 6973 6375 7373 2069 7420 6265 se discuss it be │ │ │ │ │ +00003970: 666f 7265 6861 6e64 206f 6e20 6772 7562 forehand on grub │ │ │ │ │ +00003980: 2d64 6576 656c 0a20 2020 2020 6d61 696c -devel. mail │ │ │ │ │ +00003990: 696e 6720 6c69 7374 2e0a 0a20 2020 2a20 ing list... * │ │ │ │ │ +000039a0: 5465 7374 2079 6f75 7220 6368 616e 6765 Test your change │ │ │ │ │ +000039b0: 2e0a 0a20 2020 2020 5465 7374 2074 6861 ... Test tha │ │ │ │ │ +000039c0: 7420 796f 7572 2063 6861 6e67 6520 776f t your change wo │ │ │ │ │ +000039d0: 726b 7320 7072 6f70 6572 6c79 2e20 2054 rks properly. T │ │ │ │ │ +000039e0: 7279 2069 7420 6f75 7420 6120 636f 7570 ry it out a coup │ │ │ │ │ +000039f0: 6c65 206f 660a 2020 2020 2074 696d 6573 le of. times │ │ │ │ │ +00003a00: 2c20 7072 6566 6572 6162 6c79 206f 6e20 , preferably on │ │ │ │ │ +00003a10: 6469 6666 6572 656e 7420 7379 7374 656d different system │ │ │ │ │ +00003a20: 732c 2061 6e64 2074 7279 2074 6f20 6669 s, and try to fi │ │ │ │ │ +00003a30: 6e64 2070 726f 626c 656d 730a 2020 2020 nd problems. │ │ │ │ │ +00003a40: 2077 6974 6820 6974 2e0a 0a20 2020 2a20 with it... * │ │ │ │ │ +00003a50: 5075 626c 6973 6820 796f 7572 2063 6861 Publish your cha │ │ │ │ │ +00003a60: 6e67 652e 0a0a 2020 2020 2057 6865 6e20 nge... When │ │ │ │ │ +00003a70: 796f 7520 6172 6520 6861 7070 7920 7769 you are happy wi │ │ │ │ │ +00003a80: 7468 2079 6f75 7220 6368 616e 6765 2c20 th your change, │ │ │ │ │ +00003a90: 6669 7273 7420 6d61 6b65 2073 7572 6520 first make sure │ │ │ │ │ +00003aa0: 6974 2069 730a 2020 2020 2063 6f6d 7069 it is. compi │ │ │ │ │ +00003ab0: 6c61 626c 6520 7769 7468 206c 6174 6573 lable with lates │ │ │ │ │ +00003ac0: 7420 6465 7665 6c6f 706d 656e 7420 7665 t development ve │ │ │ │ │ +00003ad0: 7273 696f 6e20 6f66 2047 5255 4220 322e rsion of GRUB 2. │ │ │ │ │ +00003ae0: 2020 4166 7465 7220 7468 6174 0a20 2020 After that. │ │ │ │ │ +00003af0: 2020 706c 6561 7365 2073 656e 6420 6120 please send a │ │ │ │ │ +00003b00: 7061 7463 6820 746f 2067 7275 622d 6465 patch to grub-de │ │ │ │ │ +00003b10: 7665 6c20 666f 7220 7265 7669 6577 2e20 vel for review. │ │ │ │ │ +00003b20: 2050 6c65 6173 6520 6465 7363 7269 6265 Please describe │ │ │ │ │ +00003b30: 2069 6e0a 2020 2020 2079 6f75 7220 656d in. your em │ │ │ │ │ +00003b40: 6169 6c20 7768 7920 796f 7520 6d61 6465 ail why you made │ │ │ │ │ +00003b50: 2074 6865 2063 6861 6e67 652c 2077 6861 the change, wha │ │ │ │ │ +00003b60: 7420 6974 2063 6861 6e67 6573 2061 6e64 t it changes and │ │ │ │ │ +00003b70: 2073 6f20 6f6e 2e0a 2020 2020 2050 6c65 so on.. Ple │ │ │ │ │ +00003b80: 6173 6520 6265 2070 7265 7061 7265 6420 ase be prepared │ │ │ │ │ +00003b90: 746f 2072 6563 6569 7665 2065 7665 6e20 to receive even │ │ │ │ │ +00003ba0: 6469 7363 6f75 7261 6769 6e67 2063 6f6d discouraging com │ │ │ │ │ +00003bb0: 6d65 6e74 7320 6162 6f75 7420 796f 7572 ments about your │ │ │ │ │ +00003bc0: 0a20 2020 2020 7061 7463 682e 2020 5468 . patch. Th │ │ │ │ │ +00003bd0: 6572 6520 6973 2075 7375 616c 6c79 2061 ere is usually a │ │ │ │ │ +00003be0: 7420 6c65 6173 7420 736f 6d65 7468 696e t least somethin │ │ │ │ │ +00003bf0: 6720 7468 6174 206e 6565 6473 2074 6f20 g that needs to │ │ │ │ │ +00003c00: 6265 0a20 2020 2020 696d 7072 6f76 6564 be. improved │ │ │ │ │ +00003c10: 2069 6e20 6576 6572 7920 7061 7463 682e in every patch. │ │ │ │ │ +00003c20: 0a0a 2020 2020 2050 6c65 6173 6520 7573 .. Please us │ │ │ │ │ +00003c30: 6520 756e 6966 6965 6420 6469 6666 2074 e unified diff t │ │ │ │ │ +00003c40: 6f20 6d61 6b65 2079 6f75 7220 7061 7463 o make your patc │ │ │ │ │ +00003c50: 6820 2867 6f6f 6420 6d61 7463 6820 6f66 h (good match of │ │ │ │ │ +00003c60: 2061 7267 756d 656e 7473 0a20 2020 2020 arguments. │ │ │ │ │ +00003c70: 666f 7220 6469 6666 2069 7320 272d 7072 for diff is '-pr │ │ │ │ │ +00003c80: 754e 2729 2e0a 0a20 2020 2a20 5265 7370 uN')... * Resp │ │ │ │ │ +00003c90: 6f6e 6420 746f 2072 6563 6569 7665 6420 ond to received │ │ │ │ │ +00003ca0: 6665 6564 6261 636b 2e0a 0a20 2020 2020 feedback... │ │ │ │ │ +00003cb0: 4966 2079 6f75 2061 7265 2061 736b 6564 If you are asked │ │ │ │ │ +00003cc0: 2074 6f20 6d6f 6469 6679 2079 6f75 7220 to modify your │ │ │ │ │ +00003cd0: 7061 7463 682c 2070 6c65 6173 6520 646f patch, please do │ │ │ │ │ +00003ce0: 2074 6861 7420 616e 6420 7265 7375 626d that and resubm │ │ │ │ │ +00003cf0: 6974 0a20 2020 2020 6974 2066 6f72 2072 it. it for r │ │ │ │ │ +00003d00: 6576 6965 772e 2020 4966 2079 6f75 7220 eview. If your │ │ │ │ │ +00003d10: 6368 616e 6765 2069 7320 6c61 7267 6520 change is large │ │ │ │ │ +00003d20: 796f 7520 6172 6520 7265 7175 6972 6564 you are required │ │ │ │ │ +00003d30: 2074 6f20 7375 626d 6974 0a20 2020 2020 to submit. │ │ │ │ │ +00003d40: 6120 636f 7079 7269 6768 7420 6167 7265 a copyright agre │ │ │ │ │ +00003d50: 656d 656e 7420 746f 2046 5346 2e20 506c ement to FSF. Pl │ │ │ │ │ +00003d60: 6561 7365 206b 6565 7020 696e 206d 696e ease keep in min │ │ │ │ │ +00003d70: 6420 7468 6174 2069 6620 796f 7520 6172 d that if you ar │ │ │ │ │ +00003d80: 650a 2020 2020 2061 736b 6564 2074 6f20 e. asked to │ │ │ │ │ +00003d90: 7375 626d 6974 2066 6f72 2063 6f70 7972 submit for copyr │ │ │ │ │ +00003da0: 6967 6874 2061 6772 6565 6d65 6e74 2c20 ight agreement, │ │ │ │ │ +00003db0: 7072 6f63 6573 7320 6361 6e20 7461 6b65 process can take │ │ │ │ │ +00003dc0: 2073 6f6d 6520 7469 6d65 0a20 2020 2020 some time. │ │ │ │ │ +00003dd0: 616e 6420 6973 206d 616e 6461 746f 7279 and is mandatory │ │ │ │ │ +00003de0: 2069 6e20 6f72 6465 7220 746f 2067 6574 in order to get │ │ │ │ │ +00003df0: 2079 6f75 7220 6368 616e 6765 7320 696e your changes in │ │ │ │ │ +00003e00: 7465 6772 6174 6564 2e0a 0a20 2020 2020 tegrated... │ │ │ │ │ +00003e10: 4966 2079 6f75 2061 7265 206e 6f74 206f If you are not o │ │ │ │ │ +00003e20: 6e20 6772 7562 2d64 6576 656c 2074 6f20 n grub-devel to │ │ │ │ │ +00003e30: 7265 7370 6f6e 6420 746f 2071 7565 7374 respond to quest │ │ │ │ │ +00003e40: 696f 6e73 2c20 6d6f 7374 206c 696b 656c ions, most likel │ │ │ │ │ +00003e50: 790a 2020 2020 2079 6f75 7220 7061 7463 y. your patc │ │ │ │ │ +00003e60: 6820 7769 6c6c 206e 6f74 2062 6520 6163 h will not be ac │ │ │ │ │ +00003e70: 6365 7074 6564 2e20 2041 6c73 6f20 6966 cepted. Also if │ │ │ │ │ +00003e80: 2070 726f 626c 656d 7320 6172 6973 6520 problems arise │ │ │ │ │ +00003e90: 6672 6f6d 2079 6f75 720a 2020 2020 2063 from your. c │ │ │ │ │ +00003ea0: 6861 6e67 6573 206c 6174 6572 206f 6e2c hanges later on, │ │ │ │ │ +00003eb0: 2069 7420 776f 756c 6420 6265 2070 7265 it would be pre │ │ │ │ │ +00003ec0: 6665 7261 626c 6520 7468 6174 2079 6f75 ferable that you │ │ │ │ │ +00003ed0: 2061 6c73 6f20 6669 7820 7468 650a 2020 also fix the. │ │ │ │ │ +00003ee0: 2020 2070 726f 626c 656d 2e20 2053 6f20 problem. So │ │ │ │ │ +00003ef0: 7374 6179 2061 726f 756e 6420 666f 7220 stay around for │ │ │ │ │ +00003f00: 6120 7768 696c 652e 0a0a 2020 202a 2059 a while... * Y │ │ │ │ │ +00003f10: 6f75 7220 7061 7463 6820 6973 2061 6363 our patch is acc │ │ │ │ │ +00003f20: 6570 7465 642e 0a0a 2020 2020 2047 6f6f epted... Goo │ │ │ │ │ +00003f30: 6420 6a6f 6221 2020 596f 7572 2070 6174 d job! Your pat │ │ │ │ │ +00003f40: 6368 2077 696c 6c20 6e6f 7720 6265 2069 ch will now be i │ │ │ │ │ +00003f50: 6e74 6567 7261 7465 6420 696e 746f 2047 ntegrated into G │ │ │ │ │ +00003f60: 5255 4220 3220 6d61 696e 6c69 6e65 2c0a RUB 2 mainline,. │ │ │ │ │ +00003f70: 2020 2020 2061 6e64 2069 6620 6974 2064 and if it d │ │ │ │ │ +00003f80: 6964 6e27 7420 6272 6561 6b20 616e 7974 idn't break anyt │ │ │ │ │ +00003f90: 6869 6e67 2069 7420 7769 6c6c 2062 6520 hing it will be │ │ │ │ │ +00003fa0: 7075 626c 6963 6c79 2061 7661 696c 6162 publicly availab │ │ │ │ │ +00003fb0: 6c65 2069 6e0a 2020 2020 2074 6865 206e le in. the n │ │ │ │ │ +00003fc0: 6578 7420 7265 6c65 6173 652e 0a0a 2020 ext release... │ │ │ │ │ +00003fd0: 2020 204e 6f77 2079 6f75 2061 7265 2077 Now you are w │ │ │ │ │ +00003fe0: 656c 636f 6d65 2074 6f20 646f 2066 7572 elcome to do fur │ │ │ │ │ +00003ff0: 7468 6572 2069 6d70 726f 7665 6d65 6e74 ther improvement │ │ │ │ │ +00004000: 7320 3a29 0a0a 1f0a 4669 6c65 3a20 6772 s :)....File: gr │ │ │ │ │ +00004010: 7562 2d64 6576 2e69 6e66 6f2c 2020 4e6f ub-dev.info, No │ │ │ │ │ +00004020: 6465 3a20 5479 7069 6361 6c20 4465 7665 de: Typical Deve │ │ │ │ │ +00004030: 6c6f 7065 7220 4578 7065 7269 656e 6365 loper Experience │ │ │ │ │ +00004040: 2c20 204e 6578 743a 2057 6865 6e20 796f , Next: When yo │ │ │ │ │ +00004050: 7520 6172 6520 6170 7072 6f76 6564 2066 u are approved f │ │ │ │ │ +00004060: 6f72 2077 7269 7465 2061 6363 6573 7320 or write access │ │ │ │ │ +00004070: 746f 2070 726f 6a65 6374 2773 2066 696c to project's fil │ │ │ │ │ +00004080: 6573 2c20 2050 7265 763a 2047 6574 7469 es, Prev: Getti │ │ │ │ │ +00004090: 6e67 2073 7461 7274 6564 2c20 2055 703a ng started, Up: │ │ │ │ │ +000040a0: 2043 6f6e 7472 6962 7574 696e 6720 4368 Contributing Ch │ │ │ │ │ +000040b0: 616e 6765 730a 0a34 2e32 2054 7970 6963 anges..4.2 Typic │ │ │ │ │ +000040c0: 616c 2044 6576 656c 6f70 6572 2045 7870 al Developer Exp │ │ │ │ │ +000040d0: 6572 6965 6e63 650a 3d3d 3d3d 3d3d 3d3d erience.======== │ │ │ │ │ 000040e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000040f0: 3d3d 3d3d 3d3d 0a0a 5468 6520 7479 7069 ======..The typi │ │ │ │ │ -00004100: 6361 6c20 6578 7065 7269 656e 6365 2066 cal experience f │ │ │ │ │ -00004110: 6f72 2061 2064 6576 656c 6f70 6572 2069 or a developer i │ │ │ │ │ -00004120: 6e20 7468 6973 2070 726f 6a65 6374 2069 n this project i │ │ │ │ │ -00004130: 7320 7468 6520 666f 6c6c 6f77 696e 673a s the following: │ │ │ │ │ -00004140: 0a0a 2020 312e 2059 6f75 2066 696e 6420 .. 1. You find │ │ │ │ │ -00004150: 796f 7572 7365 6c66 2077 616e 7469 6e67 yourself wanting │ │ │ │ │ -00004160: 2074 6f20 646f 2073 6f6d 6574 6869 6e67 to do something │ │ │ │ │ -00004170: 2028 652e 672e 2020 6669 7869 6e67 2061 (e.g. fixing a │ │ │ │ │ -00004180: 2062 7567 292e 0a20 2032 2e20 596f 7520 bug).. 2. You │ │ │ │ │ -00004190: 7368 6f77 2073 6f6d 6520 7265 7375 6c74 show some result │ │ │ │ │ -000041a0: 2069 6e20 7468 6520 6d61 696c 696e 6720 in the mailing │ │ │ │ │ -000041b0: 6c69 7374 206f 7220 7468 6520 4952 432e list or the IRC. │ │ │ │ │ -000041c0: 0a20 2033 2e20 596f 7520 6172 6520 6765 . 3. You are ge │ │ │ │ │ -000041d0: 7474 696e 6720 746f 2062 6520 6b6e 6f77 tting to be know │ │ │ │ │ -000041e0: 6e20 746f 206f 7468 6572 2064 6576 656c n to other devel │ │ │ │ │ -000041f0: 6f70 6572 732e 0a20 2034 2e20 596f 7520 opers.. 4. You │ │ │ │ │ -00004200: 6163 6375 6d75 6c61 7465 2073 6967 6e69 accumulate signi │ │ │ │ │ -00004210: 6669 6361 6e74 2061 6d6f 756e 7420 6f66 ficant amount of │ │ │ │ │ -00004220: 2063 6f6e 7472 6962 7574 696f 6e2c 2073 contribution, s │ │ │ │ │ -00004230: 6f20 636f 7079 7269 6768 740a 2020 2020 o copyright. │ │ │ │ │ -00004240: 2061 7373 6967 6e6d 656e 7420 6973 2070 assignment is p │ │ │ │ │ -00004250: 726f 6365 7373 6564 2e0a 2020 352e 2059 rocessed.. 5. Y │ │ │ │ │ -00004260: 6f75 2061 7265 2066 7265 6520 746f 2063 ou are free to c │ │ │ │ │ -00004270: 6865 636b 2069 6e20 796f 7572 2063 6861 heck in your cha │ │ │ │ │ -00004280: 6e67 6573 206f 6e20 796f 7572 206f 776e nges on your own │ │ │ │ │ -00004290: 2c20 6c65 6761 6c6c 790a 2020 2020 2073 , legally. s │ │ │ │ │ -000042a0: 7065 616b 696e 672e 0a0a 2020 2041 7420 peaking... At │ │ │ │ │ -000042b0: 7468 6973 2070 6f69 6e74 2c20 6974 2069 this point, it i │ │ │ │ │ -000042c0: 7320 7261 7468 6572 2061 6e6e 6f79 696e s rather annoyin │ │ │ │ │ -000042d0: 6720 7468 6174 2079 6f75 206f 7567 6874 g that you ought │ │ │ │ │ -000042e0: 2074 6f20 6173 6b20 736f 6d65 626f 6479 to ask somebody │ │ │ │ │ -000042f0: 0a65 6c73 6520 6576 6572 7920 6368 616e .else every chan │ │ │ │ │ -00004300: 6765 2074 6f20 6265 2063 6865 636b 6564 ge to be checked │ │ │ │ │ -00004310: 2069 6e2e 2020 466f 7220 6566 6669 6369 in. For effici │ │ │ │ │ -00004320: 656e 6379 2c20 6974 2069 7320 6661 7220 ency, it is far │ │ │ │ │ -00004330: 6265 7474 6572 2c0a 6966 2079 6f75 2063 better,.if you c │ │ │ │ │ -00004340: 616e 2063 6f6d 6d69 7420 6974 2079 6f75 an commit it you │ │ │ │ │ -00004350: 7273 656c 662e 2020 5468 6572 6566 6f72 rself. Therefor │ │ │ │ │ -00004360: 652c 206f 7572 2070 6f6c 6963 7920 6973 e, our policy is │ │ │ │ │ -00004370: 2074 6f20 6769 7665 2079 6f75 2074 6865 to give you the │ │ │ │ │ -00004380: 0a77 7269 7465 2070 6572 6d69 7373 696f .write permissio │ │ │ │ │ -00004390: 6e20 746f 206f 7572 206f 6666 6963 6961 n to our officia │ │ │ │ │ -000043a0: 6c20 7265 706f 7369 746f 7279 2c20 6f6e l repository, on │ │ │ │ │ -000043b0: 6365 2079 6f75 2068 6176 6520 7368 6f77 ce you have show │ │ │ │ │ -000043c0: 6e20 796f 7572 0a73 6b69 6c6c 2061 6e64 n your.skill and │ │ │ │ │ -000043d0: 2077 696c 6c2c 2061 6e64 2074 6865 2046 will, and the F │ │ │ │ │ -000043e0: 5346 2063 6c65 726b 7320 6861 7665 2064 SF clerks have d │ │ │ │ │ -000043f0: 6561 6c74 2077 6974 6820 796f 7572 2063 ealt with your c │ │ │ │ │ -00004400: 6f70 7972 6967 6874 0a61 7373 6967 6e6d opyright.assignm │ │ │ │ │ -00004410: 656e 742e 0a0a 1f0a 4669 6c65 3a20 6772 ent.....File: gr │ │ │ │ │ -00004420: 7562 2d64 6576 2e69 6e66 6f2c 2020 4e6f ub-dev.info, No │ │ │ │ │ -00004430: 6465 3a20 5768 656e 2079 6f75 2061 7265 de: When you are │ │ │ │ │ -00004440: 2061 7070 726f 7665 6420 666f 7220 7772 approved for wr │ │ │ │ │ -00004450: 6974 6520 6163 6365 7373 2074 6f20 7072 ite access to pr │ │ │ │ │ -00004460: 6f6a 6563 7427 7320 6669 6c65 732c 2020 oject's files, │ │ │ │ │ -00004470: 5072 6576 3a20 5479 7069 6361 6c20 4465 Prev: Typical De │ │ │ │ │ -00004480: 7665 6c6f 7065 7220 4578 7065 7269 656e veloper Experien │ │ │ │ │ -00004490: 6365 2c20 2055 703a 2043 6f6e 7472 6962 ce, Up: Contrib │ │ │ │ │ -000044a0: 7574 696e 6720 4368 616e 6765 730a 0a34 uting Changes..4 │ │ │ │ │ -000044b0: 2e33 2057 6865 6e20 796f 7520 6172 6520 .3 When you are │ │ │ │ │ -000044c0: 6170 7072 6f76 6564 2066 6f72 2077 7269 approved for wri │ │ │ │ │ -000044d0: 7465 2061 6363 6573 7320 746f 2070 726f te access to pro │ │ │ │ │ -000044e0: 6a65 6374 2773 2066 696c 6573 0a3d 3d3d ject's files.=== │ │ │ │ │ +000040f0: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 7479 ========..The ty │ │ │ │ │ +00004100: 7069 6361 6c20 6578 7065 7269 656e 6365 pical experience │ │ │ │ │ +00004110: 2066 6f72 2061 2064 6576 656c 6f70 6572 for a developer │ │ │ │ │ +00004120: 2069 6e20 7468 6973 2070 726f 6a65 6374 in this project │ │ │ │ │ +00004130: 2069 7320 7468 6520 666f 6c6c 6f77 696e is the followin │ │ │ │ │ +00004140: 673a 0a0a 2020 312e 2059 6f75 2066 696e g:.. 1. You fin │ │ │ │ │ +00004150: 6420 796f 7572 7365 6c66 2077 616e 7469 d yourself wanti │ │ │ │ │ +00004160: 6e67 2074 6f20 646f 2073 6f6d 6574 6869 ng to do somethi │ │ │ │ │ +00004170: 6e67 2028 652e 672e 2020 6669 7869 6e67 ng (e.g. fixing │ │ │ │ │ +00004180: 2061 2062 7567 292e 0a20 2032 2e20 596f a bug).. 2. Yo │ │ │ │ │ +00004190: 7520 7368 6f77 2073 6f6d 6520 7265 7375 u show some resu │ │ │ │ │ +000041a0: 6c74 2069 6e20 7468 6520 6d61 696c 696e lt in the mailin │ │ │ │ │ +000041b0: 6720 6c69 7374 206f 7220 7468 6520 4952 g list or the IR │ │ │ │ │ +000041c0: 432e 0a20 2033 2e20 596f 7520 6172 6520 C.. 3. You are │ │ │ │ │ +000041d0: 6765 7474 696e 6720 746f 2062 6520 6b6e getting to be kn │ │ │ │ │ +000041e0: 6f77 6e20 746f 206f 7468 6572 2064 6576 own to other dev │ │ │ │ │ +000041f0: 656c 6f70 6572 732e 0a20 2034 2e20 596f elopers.. 4. Yo │ │ │ │ │ +00004200: 7520 6163 6375 6d75 6c61 7465 2073 6967 u accumulate sig │ │ │ │ │ +00004210: 6e69 6669 6361 6e74 2061 6d6f 756e 7420 nificant amount │ │ │ │ │ +00004220: 6f66 2063 6f6e 7472 6962 7574 696f 6e2c of contribution, │ │ │ │ │ +00004230: 2073 6f20 636f 7079 7269 6768 740a 2020 so copyright. │ │ │ │ │ +00004240: 2020 2061 7373 6967 6e6d 656e 7420 6973 assignment is │ │ │ │ │ +00004250: 2070 726f 6365 7373 6564 2e0a 2020 352e processed.. 5. │ │ │ │ │ +00004260: 2059 6f75 2061 7265 2066 7265 6520 746f You are free to │ │ │ │ │ +00004270: 2063 6865 636b 2069 6e20 796f 7572 2063 check in your c │ │ │ │ │ +00004280: 6861 6e67 6573 206f 6e20 796f 7572 206f hanges on your o │ │ │ │ │ +00004290: 776e 2c20 6c65 6761 6c6c 790a 2020 2020 wn, legally. │ │ │ │ │ +000042a0: 2073 7065 616b 696e 672e 0a0a 2020 2041 speaking... A │ │ │ │ │ +000042b0: 7420 7468 6973 2070 6f69 6e74 2c20 6974 t this point, it │ │ │ │ │ +000042c0: 2069 7320 7261 7468 6572 2061 6e6e 6f79 is rather annoy │ │ │ │ │ +000042d0: 696e 6720 7468 6174 2079 6f75 206f 7567 ing that you oug │ │ │ │ │ +000042e0: 6874 2074 6f20 6173 6b20 736f 6d65 626f ht to ask somebo │ │ │ │ │ +000042f0: 6479 0a65 6c73 6520 6576 6572 7920 6368 dy.else every ch │ │ │ │ │ +00004300: 616e 6765 2074 6f20 6265 2063 6865 636b ange to be check │ │ │ │ │ +00004310: 6564 2069 6e2e 2020 466f 7220 6566 6669 ed in. For effi │ │ │ │ │ +00004320: 6369 656e 6379 2c20 6974 2069 7320 6661 ciency, it is fa │ │ │ │ │ +00004330: 7220 6265 7474 6572 2c0a 6966 2079 6f75 r better,.if you │ │ │ │ │ +00004340: 2063 616e 2063 6f6d 6d69 7420 6974 2079 can commit it y │ │ │ │ │ +00004350: 6f75 7273 656c 662e 2020 5468 6572 6566 ourself. Theref │ │ │ │ │ +00004360: 6f72 652c 206f 7572 2070 6f6c 6963 7920 ore, our policy │ │ │ │ │ +00004370: 6973 2074 6f20 6769 7665 2079 6f75 2074 is to give you t │ │ │ │ │ +00004380: 6865 0a77 7269 7465 2070 6572 6d69 7373 he.write permiss │ │ │ │ │ +00004390: 696f 6e20 746f 206f 7572 206f 6666 6963 ion to our offic │ │ │ │ │ +000043a0: 6961 6c20 7265 706f 7369 746f 7279 2c20 ial repository, │ │ │ │ │ +000043b0: 6f6e 6365 2079 6f75 2068 6176 6520 7368 once you have sh │ │ │ │ │ +000043c0: 6f77 6e20 796f 7572 0a73 6b69 6c6c 2061 own your.skill a │ │ │ │ │ +000043d0: 6e64 2077 696c 6c2c 2061 6e64 2074 6865 nd will, and the │ │ │ │ │ +000043e0: 2046 5346 2063 6c65 726b 7320 6861 7665 FSF clerks have │ │ │ │ │ +000043f0: 2064 6561 6c74 2077 6974 6820 796f 7572 dealt with your │ │ │ │ │ +00004400: 2063 6f70 7972 6967 6874 0a61 7373 6967 copyright.assig │ │ │ │ │ +00004410: 6e6d 656e 742e 0a0a 1f0a 4669 6c65 3a20 nment.....File: │ │ │ │ │ +00004420: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ +00004430: 4e6f 6465 3a20 5768 656e 2079 6f75 2061 Node: When you a │ │ │ │ │ +00004440: 7265 2061 7070 726f 7665 6420 666f 7220 re approved for │ │ │ │ │ +00004450: 7772 6974 6520 6163 6365 7373 2074 6f20 write access to │ │ │ │ │ +00004460: 7072 6f6a 6563 7427 7320 6669 6c65 732c project's files, │ │ │ │ │ +00004470: 2020 5072 6576 3a20 5479 7069 6361 6c20 Prev: Typical │ │ │ │ │ +00004480: 4465 7665 6c6f 7065 7220 4578 7065 7269 Developer Experi │ │ │ │ │ +00004490: 656e 6365 2c20 2055 703a 2043 6f6e 7472 ence, Up: Contr │ │ │ │ │ +000044a0: 6962 7574 696e 6720 4368 616e 6765 730a ibuting Changes. │ │ │ │ │ +000044b0: 0a34 2e33 2057 6865 6e20 796f 7520 6172 .4.3 When you ar │ │ │ │ │ +000044c0: 6520 6170 7072 6f76 6564 2066 6f72 2077 e approved for w │ │ │ │ │ +000044d0: 7269 7465 2061 6363 6573 7320 746f 2070 rite access to p │ │ │ │ │ +000044e0: 726f 6a65 6374 2773 2066 696c 6573 0a3d roject's files.= │ │ │ │ │ 000044f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00004500: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00004510: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00004520: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4173 2079 ==========..As y │ │ │ │ │ -00004530: 6f75 206d 6967 6874 206b 6e6f 772c 2047 ou might know, G │ │ │ │ │ -00004540: 5255 4220 6973 2068 6f73 7465 6420 6f6e RUB is hosted on │ │ │ │ │ -00004550: 0a3c 6874 7470 733a 2f2f 7361 7661 6e6e ., thus the mem │ │ │ │ │ -00004590: 6265 7273 6869 700a 6973 206d 616e 6167 bership.is manag │ │ │ │ │ -000045a0: 6564 2062 7920 5361 7661 6e6e 6168 2e20 ed by Savannah. │ │ │ │ │ -000045b0: 2054 6869 7320 6d65 616e 7320 7468 6174 This means that │ │ │ │ │ -000045c0: 2c20 6966 2079 6f75 2077 616e 7420 746f , if you want to │ │ │ │ │ -000045d0: 2062 6520 6120 6d65 6d62 6572 206f 660a be a member of. │ │ │ │ │ -000045e0: 7468 6973 2070 726f 6a65 6374 3a0a 0a20 this project:.. │ │ │ │ │ -000045f0: 2031 2e20 596f 7520 6e65 6564 2074 6f20 1. You need to │ │ │ │ │ -00004600: 6372 6561 7465 2079 6f75 7220 6f77 6e20 create your own │ │ │ │ │ -00004610: 6163 636f 756e 7420 6f6e 2053 6176 616e account on Savan │ │ │ │ │ -00004620: 6e61 682e 0a20 2032 2e20 596f 7520 6361 nah.. 2. You ca │ │ │ │ │ -00004630: 6e20 7375 626d 6974 2022 5265 7175 6573 n submit "Reques │ │ │ │ │ -00004640: 7420 666f 7220 496e 636c 7573 696f 6e22 t for Inclusion" │ │ │ │ │ -00004650: 2066 726f 6d20 224d 7920 4772 6f75 7073 from "My Groups │ │ │ │ │ -00004660: 2220 6f6e 0a20 2020 2020 5361 7661 6e6e " on. Savann │ │ │ │ │ -00004670: 6168 2e0a 0a20 2020 5468 656e 2c20 6f6e ah... Then, on │ │ │ │ │ -00004680: 6520 6f66 2074 6865 2061 646d 696e 7320 e of the admins │ │ │ │ │ -00004690: 6361 6e20 6170 7072 6f76 6520 796f 7572 can approve your │ │ │ │ │ -000046a0: 2072 6571 7565 7374 2c20 616e 6420 796f request, and yo │ │ │ │ │ -000046b0: 7520 7769 6c6c 2062 6520 610a 6d65 6d62 u will be a.memb │ │ │ │ │ -000046c0: 6572 2e20 2049 6620 796f 7520 646f 6e27 er. If you don' │ │ │ │ │ -000046d0: 7420 7761 6e74 2074 6f20 7573 6520 7468 t want to use th │ │ │ │ │ -000046e0: 6520 5361 7661 6e6e 6168 2069 6e74 6572 e Savannah inter │ │ │ │ │ -000046f0: 6661 6365 2074 6f20 7375 626d 6974 2061 face to submit a │ │ │ │ │ -00004700: 0a72 6571 7565 7374 2c20 796f 7520 6361 .request, you ca │ │ │ │ │ -00004710: 6e20 7369 6d70 6c79 206e 6f74 6966 7920 n simply notify │ │ │ │ │ -00004720: 7468 6520 6164 6d69 6e73 2062 7920 656d the admins by em │ │ │ │ │ -00004730: 6169 6c20 6f72 2073 6f6d 6574 6869 6e67 ail or something │ │ │ │ │ -00004740: 2065 6c73 652c 0a61 6c74 6572 6e61 7469 else,.alternati │ │ │ │ │ -00004750: 7665 6c79 2e20 2042 7574 2079 6f75 2073 vely. But you s │ │ │ │ │ -00004760: 7469 6c6c 206e 6565 6420 746f 2063 7265 till need to cre │ │ │ │ │ -00004770: 6174 6520 616e 2061 6363 6f75 6e74 2062 ate an account b │ │ │ │ │ -00004780: 6566 6f72 6568 616e 642e 0a0a 2020 204e eforehand... N │ │ │ │ │ -00004790: 4f54 453a 2077 6520 736f 6d65 7469 6d65 OTE: we sometime │ │ │ │ │ -000047a0: 7320 7265 6365 6976 6520 6120 2252 6571 s receive a "Req │ │ │ │ │ -000047b0: 7565 7374 2066 6f72 2049 6e63 6c75 7369 uest for Inclusi │ │ │ │ │ -000047c0: 6f6e 2220 6672 6f6d 2061 6e20 756e 6b6e on" from an unkn │ │ │ │ │ -000047d0: 6f77 6e0a 7065 7273 6f6e 2e20 2049 6e20 own.person. In │ │ │ │ │ -000047e0: 7468 6973 2063 6173 652c 2074 6865 2072 this case, the r │ │ │ │ │ -000047f0: 6571 7565 7374 2077 6f75 6c64 2062 6520 equest would be │ │ │ │ │ -00004800: 6a75 7374 2064 6973 6361 7264 6564 2c20 just discarded, │ │ │ │ │ -00004810: 7369 6e63 6520 6974 2069 730a 746f 6f20 since it is.too │ │ │ │ │ -00004820: 6461 6e67 6572 6f75 7320 746f 2061 6c6c dangerous to all │ │ │ │ │ -00004830: 6f77 2061 2073 7472 616e 6765 7220 746f ow a stranger to │ │ │ │ │ -00004840: 2062 6520 6120 6d65 6d62 6572 2c20 7768 be a member, wh │ │ │ │ │ -00004850: 6963 6820 6175 746f 6d61 7469 6361 6c6c ich automaticall │ │ │ │ │ -00004860: 790a 6769 7665 7320 6869 6d20 6120 636f y.gives him a co │ │ │ │ │ -00004870: 6d6d 6974 2072 6967 6874 2074 6f20 7468 mmit right to th │ │ │ │ │ -00004880: 6520 7265 706f 7369 746f 7279 2c20 626f e repository, bo │ │ │ │ │ -00004890: 7468 2066 6f72 2061 206c 6567 616c 2072 th for a legal r │ │ │ │ │ -000048a0: 6561 736f 6e20 616e 640a 666f 7220 6120 eason and.for a │ │ │ │ │ -000048b0: 7465 6368 6e69 6361 6c20 7265 6173 6f6e technical reason │ │ │ │ │ -000048c0: 2e0a 0a20 2020 4966 2079 6f75 7220 696e ... If your in │ │ │ │ │ -000048d0: 7465 6e74 696f 6e20 6973 2074 6f20 6a75 tention is to ju │ │ │ │ │ -000048e0: 7374 2067 6574 2073 7461 7274 6564 2c20 st get started, │ │ │ │ │ -000048f0: 706c 6561 7365 2064 6f20 6e6f 7420 7375 please do not su │ │ │ │ │ -00004900: 626d 6974 2061 0a69 6e63 6c75 7369 6f6e bmit a.inclusion │ │ │ │ │ -00004910: 2072 6571 7565 7374 2e20 2049 6e73 7465 request. Inste │ │ │ │ │ -00004920: 6164 2c20 706c 6561 7365 2073 7562 7363 ad, please subsc │ │ │ │ │ -00004930: 7269 6265 2074 6f20 7468 6520 6d61 696c ribe to the mail │ │ │ │ │ -00004940: 696e 6720 6c69 7374 2c20 616e 640a 636f ing list, and.co │ │ │ │ │ -00004950: 6d6d 756e 6963 6174 6520 6669 7273 7420 mmunicate first │ │ │ │ │ -00004960: 2865 2e67 2e20 2073 656e 6469 6e67 2061 (e.g. sending a │ │ │ │ │ -00004970: 2070 6174 6368 2c20 6173 6b69 6e67 2061 patch, asking a │ │ │ │ │ -00004980: 2071 7565 7374 696f 6e2c 2063 6f6d 6d65 question, comme │ │ │ │ │ -00004990: 6e74 696e 670a 6f6e 2061 6e6f 7468 6572 nting.on another │ │ │ │ │ -000049a0: 206d 6573 7361 6765 2e2e 2e29 2e0a 0a1f message...).... │ │ │ │ │ -000049b0: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ -000049c0: 696e 666f 2c20 204e 6f64 653a 2055 7064 info, Node: Upd │ │ │ │ │ -000049d0: 6174 696e 6720 4578 7465 726e 616c 2043 ating External C │ │ │ │ │ -000049e0: 6f64 652c 2020 4e65 7874 3a20 506f 7274 ode, Next: Port │ │ │ │ │ -000049f0: 696e 672c 2020 5072 6576 3a20 436f 6e74 ing, Prev: Cont │ │ │ │ │ -00004a00: 7269 6275 7469 6e67 2043 6861 6e67 6573 ributing Changes │ │ │ │ │ -00004a10: 2c20 2055 703a 2054 6f70 0a0a 3520 5570 , Up: Top..5 Up │ │ │ │ │ -00004a20: 6461 7469 6e67 2065 7874 6572 6e61 6c20 dating external │ │ │ │ │ -00004a30: 636f 6465 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a code.*********** │ │ │ │ │ -00004a40: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 *************..G │ │ │ │ │ -00004a50: 5255 4220 696e 636c 7564 6573 2073 6f6d RUB includes som │ │ │ │ │ -00004a60: 6520 636f 6465 2066 726f 6d20 6f74 6865 e code from othe │ │ │ │ │ -00004a70: 7220 7072 6f6a 6563 7473 2c20 616e 6420 r projects, and │ │ │ │ │ -00004a80: 6974 2069 7320 736f 6d65 7469 6d65 730a it is sometimes. │ │ │ │ │ -00004a90: 6e65 6365 7373 6172 7920 746f 2075 7064 necessary to upd │ │ │ │ │ -00004aa0: 6174 6520 6974 2e0a 0a2a 204d 656e 753a ate it...* Menu: │ │ │ │ │ -00004ab0: 0a0a 2a20 476e 756c 6962 3a3a 0a2a 206a ..* Gnulib::.* j │ │ │ │ │ -00004ac0: 736d 6e3a 3a0a 2a20 6d69 6e69 6c7a 6f3a smn::.* minilzo: │ │ │ │ │ -00004ad0: 3a0a 0a1f 0a46 696c 653a 2067 7275 622d :....File: grub- │ │ │ │ │ -00004ae0: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ │ -00004af0: 2047 6e75 6c69 622c 2020 4e65 7874 3a20 Gnulib, Next: │ │ │ │ │ -00004b00: 6a73 6d6e 2c20 2055 703a 2055 7064 6174 jsmn, Up: Updat │ │ │ │ │ -00004b10: 696e 6720 4578 7465 726e 616c 2043 6f64 ing External Cod │ │ │ │ │ -00004b20: 650a 0a35 2e31 2047 6e75 6c69 620a 3d3d e..5.1 Gnulib.== │ │ │ │ │ -00004b30: 3d3d 3d3d 3d3d 3d3d 0a0a 476e 756c 6962 ========..Gnulib │ │ │ │ │ -00004b40: 2069 7320 6120 736f 7572 6365 2063 6f64 is a source cod │ │ │ │ │ -00004b50: 6520 6c69 6272 6172 7920 7468 6174 2070 e library that p │ │ │ │ │ -00004b60: 726f 7669 6465 7320 6261 7369 6320 6675 rovides basic fu │ │ │ │ │ -00004b70: 6e63 7469 6f6e 616c 6974 7920 746f 0a70 nctionality to.p │ │ │ │ │ -00004b80: 726f 6772 616d 7320 616e 6420 6c69 6272 rograms and libr │ │ │ │ │ -00004b90: 6172 6965 732e 2020 4d61 6e79 2073 6f66 aries. Many sof │ │ │ │ │ -00004ba0: 7477 6172 6520 7061 636b 6167 6573 206d tware packages m │ │ │ │ │ -00004bb0: 616b 6520 7573 6520 6f66 2047 6e75 6c69 ake use of Gnuli │ │ │ │ │ -00004bc0: 6220 746f 0a61 766f 6964 2072 6569 6e76 b to.avoid reinv │ │ │ │ │ -00004bd0: 656e 7469 6e67 2074 6865 2070 6f72 7461 enting the porta │ │ │ │ │ -00004be0: 6269 6c69 7479 2077 6865 656c 2e0a 0a20 bility wheel... │ │ │ │ │ -00004bf0: 2020 4752 5542 2069 6d70 6f72 7473 2047 GRUB imports G │ │ │ │ │ -00004c00: 6e75 6c69 6220 7573 696e 6720 6974 7320 nulib using its │ │ │ │ │ -00004c10: 2762 6f6f 7473 7472 6170 2720 7574 696c 'bootstrap' util │ │ │ │ │ -00004c20: 6974 792c 2069 6465 6e74 6966 7969 6e67 ity, identifying │ │ │ │ │ -00004c30: 2061 0a70 6172 7469 6375 6c61 7220 4769 a.particular Gi │ │ │ │ │ -00004c40: 7420 636f 6d6d 6974 2069 6e20 2762 6f6f t commit in 'boo │ │ │ │ │ -00004c50: 7473 7472 6170 2e63 6f6e 6627 2e20 2054 tstrap.conf'. T │ │ │ │ │ -00004c60: 6f20 7570 6772 6164 6520 746f 2061 206e o upgrade to a n │ │ │ │ │ -00004c70: 6577 2047 6e75 6c69 620a 636f 6d6d 6974 ew Gnulib.commit │ │ │ │ │ -00004c80: 2c20 7365 7420 2747 4e55 4c49 425f 5245 , set 'GNULIB_RE │ │ │ │ │ -00004c90: 5649 5349 4f4e 2720 696e 2027 626f 6f74 VISION' in 'boot │ │ │ │ │ -00004ca0: 7374 7261 702e 636f 6e66 2720 746f 2074 strap.conf' to t │ │ │ │ │ -00004cb0: 6865 206e 6577 2063 6f6d 6d69 7420 4944 he new commit ID │ │ │ │ │ -00004cc0: 2c0a 7468 656e 2072 756e 2027 2e2f 626f ,.then run './bo │ │ │ │ │ -00004cd0: 6f74 7374 7261 7027 2061 6e64 2077 6861 otstrap' and wha │ │ │ │ │ -00004ce0: 7465 7665 7220 656c 7365 2079 6f75 206e tever else you n │ │ │ │ │ -00004cf0: 6565 6420 746f 206d 616b 6520 7375 7265 eed to make sure │ │ │ │ │ -00004d00: 2069 7420 776f 726b 732e 0a43 6865 636b it works..Check │ │ │ │ │ -00004d10: 2066 6f72 2063 6861 6e67 6573 2074 6f20 for changes to │ │ │ │ │ -00004d20: 476e 756c 6962 2773 2027 4e45 5753 2720 Gnulib's 'NEWS' │ │ │ │ │ -00004d30: 6669 6c65 2062 6574 7765 656e 2074 6865 file between the │ │ │ │ │ -00004d40: 206f 6c64 2061 6e64 206e 6577 0a63 6f6d old and new.com │ │ │ │ │ -00004d50: 6d69 7473 3b20 696e 2073 6f6d 6520 6361 mits; in some ca │ │ │ │ │ -00004d60: 7365 7320 6974 2077 696c 6c20 6265 206e ses it will be n │ │ │ │ │ -00004d70: 6563 6573 7361 7279 2074 6f20 6164 6a75 ecessary to adju │ │ │ │ │ -00004d80: 7374 2047 5255 4220 746f 206d 6174 6368 st GRUB to match │ │ │ │ │ -00004d90: 2e0a 596f 7520 6d61 7920 616c 736f 206e ..You may also n │ │ │ │ │ -00004da0: 6565 6420 746f 2075 7064 6174 6520 7468 eed to update th │ │ │ │ │ -00004db0: 6520 7061 7463 6865 7320 696e 0a27 6772 e patches in.'gr │ │ │ │ │ -00004dc0: 7562 2d63 6f72 652f 6c69 622f 676e 756c ub-core/lib/gnul │ │ │ │ │ -00004dd0: 6962 2d70 6174 6368 6573 2f27 2e0a 0a20 ib-patches/'... │ │ │ │ │ -00004de0: 2020 546f 2061 6464 2061 206e 6577 2047 To add a new G │ │ │ │ │ -00004df0: 6e75 6c69 6220 6d6f 6475 6c65 206f 7220 nulib module or │ │ │ │ │ -00004e00: 7265 6d6f 7665 206f 6e65 2074 6861 7420 remove one that │ │ │ │ │ -00004e10: 6973 206e 6f20 6c6f 6e67 6572 206e 6565 is no longer nee │ │ │ │ │ -00004e20: 6465 642c 0a63 6861 6e67 6520 2767 6e75 ded,.change 'gnu │ │ │ │ │ -00004e30: 6c69 625f 6d6f 6475 6c65 7327 2069 6e20 lib_modules' in │ │ │ │ │ -00004e40: 2762 6f6f 7473 7472 6170 2e63 6f6e 6627 'bootstrap.conf' │ │ │ │ │ -00004e50: 2e20 2041 6761 696e 2c20 7275 6e20 272e . Again, run '. │ │ │ │ │ -00004e60: 2f62 6f6f 7473 7472 6170 270a 616e 6420 /bootstrap'.and │ │ │ │ │ -00004e70: 7768 6174 6576 6572 2065 6c73 6520 796f whatever else yo │ │ │ │ │ -00004e80: 7520 6e65 6564 2074 6f20 6d61 6b65 2073 u need to make s │ │ │ │ │ -00004e90: 7572 6520 6974 2077 6f72 6b73 2e0a 0a20 ure it works... │ │ │ │ │ -00004ea0: 2020 426f 6f74 7374 7261 7070 696e 6720 Bootstrapping │ │ │ │ │ -00004eb0: 6672 6f6d 2061 6e20 6f6c 6465 7220 6469 from an older di │ │ │ │ │ -00004ec0: 7374 7269 6275 7469 6f6e 2063 6f6e 7461 stribution conta │ │ │ │ │ -00004ed0: 696e 696e 6720 6765 7474 6578 7420 7665 ining gettext ve │ │ │ │ │ -00004ee0: 7273 696f 6e20 3c0a 302e 3138 2e33 2c20 rsion <.0.18.3, │ │ │ │ │ -00004ef0: 7769 6c6c 2072 6571 7569 7265 2061 2070 will require a p │ │ │ │ │ -00004f00: 6174 6368 2073 696d 696c 6172 2074 6f20 atch similar to │ │ │ │ │ -00004f10: 7468 6973 2074 6f20 6265 2061 7070 6c69 this to be appli │ │ │ │ │ -00004f20: 6564 2066 6972 7374 2062 6566 6f72 650a ed first before. │ │ │ │ │ -00004f30: 7275 6e6e 696e 6720 7468 6520 272e 2f62 running the './b │ │ │ │ │ -00004f40: 6f6f 7473 7472 6170 2720 7574 696c 6974 ootstrap' utilit │ │ │ │ │ -00004f50: 793a 0a0a 2020 2020 2064 6966 6620 2d2d y:.. diff -- │ │ │ │ │ -00004f60: 6769 7420 612f 626f 6f74 7374 7261 702e git a/bootstrap. │ │ │ │ │ -00004f70: 636f 6e66 2062 2f62 6f6f 7473 7472 6170 conf b/bootstrap │ │ │ │ │ -00004f80: 2e63 6f6e 660a 2020 2020 2069 6e64 6578 .conf. index │ │ │ │ │ -00004f90: 2039 3838 6464 6130 2e2e 6133 3139 3361 988dda0..a3193a │ │ │ │ │ -00004fa0: 3920 3130 3036 3434 0a20 2020 2020 2d2d 9 100644. -- │ │ │ │ │ -00004fb0: 2d20 612f 626f 6f74 7374 7261 702e 636f - a/bootstrap.co │ │ │ │ │ -00004fc0: 6e66 0a20 2020 2020 2b2b 2b20 622f 626f nf. +++ b/bo │ │ │ │ │ -00004fd0: 6f74 7374 7261 702e 636f 6e66 0a20 2020 otstrap.conf. │ │ │ │ │ -00004fe0: 2020 4020 2d36 372c 3720 2b36 372c 3720 @ -67,7 +67,7 │ │ │ │ │ -00004ff0: 4020 534b 4950 5f50 4f3d 740a 2020 2020 @ SKIP_PO=t. │ │ │ │ │ -00005000: 2062 7569 6c64 7265 713d 225c 0a20 2020 buildreq="\. │ │ │ │ │ -00005010: 2020 6175 746f 636f 6e66 2020 2032 2e36 autoconf 2.6 │ │ │ │ │ -00005020: 330a 2020 2020 2061 7574 6f6d 616b 6520 3. automake │ │ │ │ │ -00005030: 2020 312e 3131 0a20 2020 2020 2d67 6574 1.11. -get │ │ │ │ │ -00005040: 7465 7874 2020 2020 302e 3138 2e33 0a20 text 0.18.3. │ │ │ │ │ -00005050: 2020 2020 2b67 6574 7465 7874 2020 2020 +gettext │ │ │ │ │ -00005060: 302e 3137 0a20 2020 2020 6769 7420 2020 0.17. git │ │ │ │ │ -00005070: 2020 2020 2031 2e35 2e35 0a20 2020 2020 1.5.5. │ │ │ │ │ -00005080: 7461 7220 2020 2020 2020 202d 0a20 2020 tar -. │ │ │ │ │ -00005090: 2020 220a 2020 2020 2064 6966 6620 2d2d ". diff -- │ │ │ │ │ -000050a0: 6769 7420 612f 636f 6e66 6967 7572 652e git a/configure. │ │ │ │ │ -000050b0: 6163 2062 2f63 6f6e 6669 6775 7265 2e61 ac b/configure.a │ │ │ │ │ -000050c0: 630a 2020 2020 2069 6e64 6578 2030 3862 c. index 08b │ │ │ │ │ -000050d0: 3531 3866 2e2e 3939 6635 6233 3620 3130 518f..99f5b36 10 │ │ │ │ │ -000050e0: 3036 3434 0a20 2020 2020 2d2d 2d20 612f 0644. --- a/ │ │ │ │ │ -000050f0: 636f 6e66 6967 7572 652e 6163 0a20 2020 configure.ac. │ │ │ │ │ -00005100: 2020 2b2b 2b20 622f 636f 6e66 6967 7572 +++ b/configur │ │ │ │ │ -00005110: 652e 6163 0a20 2020 2020 4020 2d33 3632 e.ac. @ -362 │ │ │ │ │ -00005120: 2c37 202b 3336 322c 3720 4020 4143 5f43 ,7 +362,7 @ AC_C │ │ │ │ │ -00005130: 4845 434b 5f50 524f 4728 4841 5645 5f43 HECK_PROG(HAVE_C │ │ │ │ │ -00005140: 5858 2c20 2443 5858 2c20 7965 732c 206e XX, $CXX, yes, n │ │ │ │ │ -00005150: 6f29 0a0a 2020 2020 2041 435f 474e 555f o).. AC_GNU_ │ │ │ │ │ -00005160: 534f 5552 4345 0a20 2020 2020 414d 5f47 SOURCE. AM_G │ │ │ │ │ -00005170: 4e55 5f47 4554 5445 5854 285b 6578 7465 NU_GETTEXT([exte │ │ │ │ │ -00005180: 726e 616c 5d29 0a20 2020 2020 2d41 4d5f rnal]). -AM_ │ │ │ │ │ -00005190: 474e 555f 4745 5454 4558 545f 5645 5253 GNU_GETTEXT_VERS │ │ │ │ │ -000051a0: 494f 4e28 5b30 2e31 382e 335d 290a 2020 ION([0.18.3]). │ │ │ │ │ -000051b0: 2020 202b 414d 5f47 4e55 5f47 4554 5445 +AM_GNU_GETTE │ │ │ │ │ -000051c0: 5854 5f56 4552 5349 4f4e 285b 302e 3137 XT_VERSION([0.17 │ │ │ │ │ -000051d0: 5d29 0a20 2020 2020 4143 5f53 5953 5f4c ]). AC_SYS_L │ │ │ │ │ -000051e0: 4152 4745 4649 4c45 0a0a 2020 2020 2023 ARGEFILE.. # │ │ │ │ │ -000051f0: 2049 6465 6e74 6966 7920 6368 6172 6163 Identify charac │ │ │ │ │ -00005200: 7465 7269 7374 6963 7320 6f66 2074 6865 teristics of the │ │ │ │ │ -00005210: 2068 6f73 7420 6172 6368 6974 6563 7475 host architectu │ │ │ │ │ -00005220: 7265 2e0a 0a0a 2020 2049 7420 7769 6c6c re.... It will │ │ │ │ │ -00005230: 2061 6c73 6f20 6265 206e 6563 6573 7361 also be necessa │ │ │ │ │ -00005240: 7279 2074 6f20 6164 6a75 7374 2074 6865 ry to adjust the │ │ │ │ │ -00005250: 2070 6174 6368 6573 2069 6e0a 2770 6f2f patches in.'po/ │ │ │ │ │ -00005260: 6765 7474 6578 742d 7061 7463 6865 732f gettext-patches/ │ │ │ │ │ -00005270: 2720 746f 2061 7070 6c79 2074 6f20 616e ' to apply to an │ │ │ │ │ -00005280: 206f 6c64 6572 2076 6572 7369 6f6e 206f older version o │ │ │ │ │ -00005290: 6620 6765 7474 6578 742e 0a0a 1f0a 4669 f gettext.....Fi │ │ │ │ │ -000052a0: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ -000052b0: 6f2c 2020 4e6f 6465 3a20 6a73 6d6e 2c20 o, Node: jsmn, │ │ │ │ │ -000052c0: 204e 6578 743a 206d 696e 696c 7a6f 2c20 Next: minilzo, │ │ │ │ │ -000052d0: 2050 7265 763a 2047 6e75 6c69 622c 2020 Prev: Gnulib, │ │ │ │ │ -000052e0: 5570 3a20 5570 6461 7469 6e67 2045 7874 Up: Updating Ext │ │ │ │ │ -000052f0: 6572 6e61 6c20 436f 6465 0a0a 352e 3220 ernal Code..5.2 │ │ │ │ │ -00005300: 6a73 6d6e 0a3d 3d3d 3d3d 3d3d 3d0a 0a6a jsmn.========..j │ │ │ │ │ -00005310: 736d 6e20 6973 2061 206d 696e 696d 616c smn is a minimal │ │ │ │ │ -00005320: 6973 7469 6320 4a53 4f4e 2070 6172 7365 istic JSON parse │ │ │ │ │ -00005330: 7220 7768 6963 6820 6973 2069 6d70 6c65 r which is imple │ │ │ │ │ -00005340: 6d65 6e74 6564 2069 6e20 6120 7369 6e67 mented in a sing │ │ │ │ │ -00005350: 6c65 0a68 6561 6465 7220 6669 6c65 2027 le.header file ' │ │ │ │ │ -00005360: 6a73 6d6e 2e68 272e 2020 546f 2069 6d70 jsmn.h'. To imp │ │ │ │ │ -00005370: 6f72 7420 6120 6469 6666 6572 656e 7420 ort a different │ │ │ │ │ -00005380: 7665 7273 696f 6e20 6f66 2074 6865 206a version of the j │ │ │ │ │ -00005390: 736d 6e20 7061 7273 6572 2c0a 796f 7520 smn parser,.you │ │ │ │ │ -000053a0: 6d61 7920 7369 6d70 6c79 2064 6f77 6e6c may simply downl │ │ │ │ │ -000053b0: 6f61 6420 7468 6520 276a 736d 6e2e 6827 oad the 'jsmn.h' │ │ │ │ │ -000053c0: 2068 6561 6465 7220 6672 6f6d 2074 6865 header from the │ │ │ │ │ -000053d0: 2064 6573 6972 6564 2074 6167 206f 720a desired tag or. │ │ │ │ │ -000053e0: 636f 6d6d 6974 2074 6f20 7468 6520 7461 commit to the ta │ │ │ │ │ -000053f0: 7267 6574 2064 6972 6563 746f 7279 3a0a rget directory:. │ │ │ │ │ -00005400: 0a20 2020 2020 6375 726c 202d 4c20 6874 . curl -L ht │ │ │ │ │ -00005410: 7470 733a 2f2f 7261 772e 6769 7468 7562 tps://raw.github │ │ │ │ │ -00005420: 7573 6572 636f 6e74 656e 742e 636f 6d2f usercontent.com/ │ │ │ │ │ -00005430: 7a73 6572 6765 2f6a 736d 6e2f 7631 2e31 zserge/jsmn/v1.1 │ │ │ │ │ -00005440: 2e30 2f6a 736d 6e2e 6820 5c0a 2020 2020 .0/jsmn.h \. │ │ │ │ │ -00005450: 2020 2020 202d 6f20 6772 7562 2d63 6f72 -o grub-cor │ │ │ │ │ -00005460: 652f 6c69 622f 6a73 6f6e 2f6a 736d 6e2e e/lib/json/jsmn. │ │ │ │ │ -00005470: 680a 0a1f 0a46 696c 653a 2067 7275 622d h....File: grub- │ │ │ │ │ -00005480: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ │ -00005490: 206d 696e 696c 7a6f 2c20 2050 7265 763a minilzo, Prev: │ │ │ │ │ -000054a0: 206a 736d 6e2c 2020 5570 3a20 5570 6461 jsmn, Up: Upda │ │ │ │ │ -000054b0: 7469 6e67 2045 7874 6572 6e61 6c20 436f ting External Co │ │ │ │ │ -000054c0: 6465 0a0a 352e 3320 6d69 6e69 6c7a 6f0a de..5.3 minilzo. │ │ │ │ │ -000054d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a6d 696e ===========..min │ │ │ │ │ -000054e0: 694c 5a4f 2069 7320 6120 7665 7279 206c iLZO is a very l │ │ │ │ │ -000054f0: 6967 6874 7765 6967 6874 2073 7562 7365 ightweight subse │ │ │ │ │ -00005500: 7420 6f66 2074 6865 204c 5a4f 206c 6962 t of the LZO lib │ │ │ │ │ -00005510: 7261 7279 2069 6e74 656e 6465 6420 666f rary intended fo │ │ │ │ │ -00005520: 720a 6561 7379 2069 6e63 6c75 7369 6f6e r.easy inclusion │ │ │ │ │ -00005530: 2069 6e20 6f74 6865 7220 7072 6f6a 6563 in other projec │ │ │ │ │ -00005540: 7473 2e20 2049 7420 6973 2067 656e 6572 ts. It is gener │ │ │ │ │ -00005550: 6174 6564 2061 7574 6f6d 6174 6963 616c ated automatical │ │ │ │ │ -00005560: 6c79 2066 726f 6d0a 7468 6520 4c5a 4f20 ly from.the LZO │ │ │ │ │ -00005570: 736f 7572 6365 2063 6f64 6520 616e 6420 source code and │ │ │ │ │ -00005580: 636f 6e74 6169 6e73 2074 6865 206d 6f73 contains the mos │ │ │ │ │ -00005590: 7420 696d 706f 7274 616e 7420 4c5a 4f20 t important LZO │ │ │ │ │ -000055a0: 6675 6e63 7469 6f6e 732e 0a0a 2020 2054 functions... T │ │ │ │ │ -000055b0: 6f20 7570 6772 6164 6520 746f 2061 206e o upgrade to a n │ │ │ │ │ -000055c0: 6577 2076 6572 7369 6f6e 206f 6620 7468 ew version of th │ │ │ │ │ -000055d0: 6520 6d69 6e69 4c5a 4f20 6c69 6272 6172 e miniLZO librar │ │ │ │ │ -000055e0: 792c 2064 6f77 6e6c 6f61 6420 7468 650a y, download the. │ │ │ │ │ -000055f0: 7265 6c65 6173 6520 7461 7262 616c 6c20 release tarball │ │ │ │ │ -00005600: 616e 6420 636f 7079 2074 6865 2066 696c and copy the fil │ │ │ │ │ -00005610: 6573 2069 6e74 6f20 7468 6520 7461 7267 es into the targ │ │ │ │ │ -00005620: 6574 2064 6972 6563 746f 7279 3a0a 0a20 et directory:.. │ │ │ │ │ -00005630: 2020 2020 6375 726c 202d 4c20 2d4f 2068 curl -L -O h │ │ │ │ │ -00005640: 7474 703a 2f2f 7777 772e 6f62 6572 6875 ttp://www.oberhu │ │ │ │ │ -00005650: 6d65 722e 636f 6d2f 6f70 656e 736f 7572 mer.com/opensour │ │ │ │ │ -00005660: 6365 2f6c 7a6f 2f64 6f77 6e6c 6f61 642f ce/lzo/download/ │ │ │ │ │ -00005670: 6d69 6e69 6c7a 6f2d 322e 3130 2e74 6172 minilzo-2.10.tar │ │ │ │ │ -00005680: 2e67 7a0a 2020 2020 2074 6172 202d 7a78 .gz. tar -zx │ │ │ │ │ -00005690: 6620 6d69 6e69 6c7a 6f2d 322e 3130 2e74 f minilzo-2.10.t │ │ │ │ │ -000056a0: 6172 2e67 7a0a 2020 2020 2072 6d20 6d69 ar.gz. rm mi │ │ │ │ │ -000056b0: 6e69 6c7a 6f2d 322e 3130 2f74 6573 746d nilzo-2.10/testm │ │ │ │ │ -000056c0: 696e 692e 630a 2020 2020 2072 6d20 2d72 ini.c. rm -r │ │ │ │ │ -000056d0: 2067 7275 622d 636f 7265 2f6c 6962 2f6d grub-core/lib/m │ │ │ │ │ -000056e0: 696e 696c 7a6f 2f2a 0a20 2020 2020 6370 inilzo/*. cp │ │ │ │ │ -000056f0: 206d 696e 696c 7a6f 2d32 2e31 302f 2a2e minilzo-2.10/*. │ │ │ │ │ -00005700: 5b68 635d 2067 7275 622d 636f 7265 2f6c [hc] grub-core/l │ │ │ │ │ -00005710: 6962 2f6d 696e 696c 7a6f 0a20 2020 2020 ib/minilzo. │ │ │ │ │ -00005720: 726d 202d 7220 6d69 6e69 6c7a 6f2d 322e rm -r minilzo-2. │ │ │ │ │ -00005730: 3130 2a0a 0a1f 0a46 696c 653a 2067 7275 10*....File: gru │ │ │ │ │ -00005740: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ -00005750: 653a 2050 6f72 7469 6e67 2c20 204e 6578 e: Porting, Nex │ │ │ │ │ -00005760: 743a 2045 7272 6f72 2048 616e 646c 696e t: Error Handlin │ │ │ │ │ -00005770: 672c 2020 5072 6576 3a20 5570 6461 7469 g, Prev: Updati │ │ │ │ │ -00005780: 6e67 2045 7874 6572 6e61 6c20 436f 6465 ng External Code │ │ │ │ │ -00005790: 2c20 2055 703a 2054 6f70 0a0a 3620 506f , Up: Top..6 Po │ │ │ │ │ -000057a0: 7274 696e 670a 2a2a 2a2a 2a2a 2a2a 2a0a rting.*********. │ │ │ │ │ -000057b0: 0a47 5255 4232 2069 7320 6465 7369 676e .GRUB2 is design │ │ │ │ │ -000057c0: 6564 2074 6f20 6265 2065 6173 696c 7920 ed to be easily │ │ │ │ │ -000057d0: 706f 7274 6162 6c65 2061 6363 726f 7373 portable accross │ │ │ │ │ -000057e0: 2070 6c61 7466 6f72 6d73 2e20 2042 7574 platforms. But │ │ │ │ │ -000057f0: 2062 6563 6175 7365 0a6f 6620 7468 6520 because.of the │ │ │ │ │ -00005800: 6e61 7475 7265 206f 6620 626f 6f74 6c6f nature of bootlo │ │ │ │ │ -00005810: 6164 6572 2065 7665 7279 206e 6577 2070 ader every new p │ │ │ │ │ -00005820: 6f72 7420 6d75 7374 2062 6520 646f 6e65 ort must be done │ │ │ │ │ -00005830: 2073 6570 6172 6174 656c 792e 0a48 6572 separately..Her │ │ │ │ │ -00005840: 6520 6973 2068 6f77 2049 2064 6964 204d e is how I did M │ │ │ │ │ -00005850: 4950 5320 286c 6f6f 6e67 736f 6e20 616e IPS (loongson an │ │ │ │ │ -00005860: 6420 4152 4329 2061 6e64 2058 656e 2070 d ARC) and Xen p │ │ │ │ │ -00005870: 6f72 7473 2e20 204e 6f74 6520 7468 616e orts. Note than │ │ │ │ │ -00005880: 2074 6869 730a 6973 206d 6f72 6520 6f66 this.is more of │ │ │ │ │ -00005890: 2073 7567 6765 7374 696f 6e73 2c20 6e6f suggestions, no │ │ │ │ │ -000058a0: 7420 6162 736f 6c75 7465 2074 7275 7468 t absolute truth │ │ │ │ │ -000058b0: 2e0a 0a20 2020 4669 7273 7420 6f66 2061 ... First of a │ │ │ │ │ -000058c0: 6c6c 2067 7261 6220 616e 7920 6172 6368 ll grab any arch │ │ │ │ │ -000058d0: 6974 6563 7475 7265 2073 7065 6369 6669 itecture specifi │ │ │ │ │ -000058e0: 6361 7469 6f6e 7320 796f 7520 6361 6e20 cations you can │ │ │ │ │ -000058f0: 6669 6e64 2069 6e0a 7075 626c 6963 2028 find in.public ( │ │ │ │ │ -00005900: 706c 6561 7365 2061 766f 6964 204e 4441 please avoid NDA │ │ │ │ │ -00005910: 292e 0a0a 2020 2046 6972 7374 2073 7461 )... First sta │ │ │ │ │ -00005920: 6765 2069 7320 2248 656c 6c6f 2077 6f72 ge is "Hello wor │ │ │ │ │ -00005930: 6c64 222e 2020 4927 7665 2064 6f6e 6520 ld". I've done │ │ │ │ │ -00005940: 6974 206f 7574 7369 6465 206f 6620 4752 it outside of GR │ │ │ │ │ -00005950: 5542 2066 6f72 0a73 696d 706c 6963 6974 UB for.simplicit │ │ │ │ │ -00005960: 792e 2020 596f 7572 2074 6173 6b20 6973 y. Your task is │ │ │ │ │ -00005970: 2074 6f20 6861 7665 2061 2073 6d61 6c6c to have a small │ │ │ │ │ -00005980: 2070 726f 6772 616d 2077 6869 6368 2069 program which i │ │ │ │ │ -00005990: 7320 6c6f 6164 6162 6c65 2061 730a 626f s loadable as.bo │ │ │ │ │ -000059a0: 6f74 6c6f 6164 6572 2061 6e64 2063 6c65 otloader and cle │ │ │ │ │ -000059b0: 6172 6c79 2073 686f 7773 2069 7473 2070 arly shows its p │ │ │ │ │ -000059c0: 7265 7365 6e63 6520 746f 2079 6f75 2e20 resence to you. │ │ │ │ │ -000059d0: 2049 6620 796f 7520 6861 7665 2065 6173 If you have eas │ │ │ │ │ -000059e0: 696c 790a 6163 6365 7373 6962 6c65 2063 ily.accessible c │ │ │ │ │ -000059f0: 6f6e 736f 6c65 2079 6f75 2063 616e 206a onsole you can j │ │ │ │ │ -00005a00: 7573 7420 7072 696e 7420 6120 6d65 7373 ust print a mess │ │ │ │ │ -00005a10: 6167 652e 2020 4966 2079 6f75 2068 6176 age. If you hav │ │ │ │ │ -00005a20: 6520 6120 6d61 7070 6564 0a66 7261 6d65 e a mapped.frame │ │ │ │ │ -00005a30: 6275 6666 6572 2079 6f75 206b 6e6f 7720 buffer you know │ │ │ │ │ -00005a40: 6164 6472 6573 7320 6f66 2c20 796f 7520 address of, you │ │ │ │ │ -00005a50: 6361 6e20 6472 6177 2061 2073 7175 6172 can draw a squar │ │ │ │ │ -00005a60: 652e 2020 4966 2079 6f75 2068 6176 6520 e. If you have │ │ │ │ │ -00005a70: 610a 6465 6275 6720 6661 6369 6c69 7479 a.debug facility │ │ │ │ │ -00005a80: 2c20 6a75 7374 2068 616e 6769 6e67 2077 , just hanging w │ │ │ │ │ -00005a90: 6974 686f 7574 2063 7261 7368 696e 6720 ithout crashing │ │ │ │ │ -00005aa0: 6d69 6768 7420 6265 2065 6e6f 7567 682e might be enough. │ │ │ │ │ -00005ab0: 2020 466f 7220 7468 650a 6669 7273 7420 For the.first │ │ │ │ │ -00005ac0: 7374 6167 6520 796f 7520 6361 6e20 6368 stage you can ch │ │ │ │ │ -00005ad0: 6f6f 7365 2074 6f20 6c6f 6164 2074 6865 oose to load the │ │ │ │ │ -00005ae0: 2062 6f6f 746c 6f61 6465 7220 6163 726f bootloader acro │ │ │ │ │ -00005af0: 7373 2074 6865 206e 6574 776f 726b 0a73 ss the network.s │ │ │ │ │ -00005b00: 696e 6365 2066 6f72 6d61 7420 666f 7220 ince format for │ │ │ │ │ -00005b10: 6e65 7477 6f72 6b20 696d 6167 6520 6973 network image is │ │ │ │ │ -00005b20: 206f 6674 656e 2065 6173 6965 7220 7468 often easier th │ │ │ │ │ -00005b30: 616e 2066 6f72 206c 6f63 616c 2062 6f6f an for local boo │ │ │ │ │ -00005b40: 7420 616e 640a 6974 2073 6b69 7073 2074 t and.it skips t │ │ │ │ │ -00005b50: 6865 206e 6565 6420 6f66 2073 6d61 6c6c he need of small │ │ │ │ │ -00005b60: 2069 6e74 6572 6d65 6469 6172 7920 7374 intermediary st │ │ │ │ │ -00005b70: 6167 6573 2061 6e64 206e 7672 616d 2068 ages and nvram h │ │ │ │ │ -00005b80: 616e 646c 696e 672e 0a41 6464 6974 696f andling..Additio │ │ │ │ │ -00005b90: 6e61 6c6c 7920 796f 7520 6361 6e20 6f66 nally you can of │ │ │ │ │ -00005ba0: 7465 6e20 6861 7665 2061 2067 6f6f 6420 ten have a good │ │ │ │ │ -00005bb0: 6964 6561 206f 6620 7468 6520 6e65 6564 idea of the need │ │ │ │ │ -00005bc0: 6564 2066 6f72 6d61 7420 6279 0a72 756e ed format by.run │ │ │ │ │ -00005bd0: 6e69 6e67 2022 6669 6c65 2220 6f6e 2061 ning "file" on a │ │ │ │ │ -00005be0: 6e79 206e 6574 626f 6f74 6162 6c65 2065 ny netbootable e │ │ │ │ │ -00005bf0: 7865 6375 7461 626c 6520 666f 7220 6769 xecutable for gi │ │ │ │ │ -00005c00: 7665 6e20 706c 6174 666f 726d 2e0a 0a20 ven platform... │ │ │ │ │ -00005c10: 2020 5468 6973 2070 726f 6772 616d 2073 This program s │ │ │ │ │ -00005c20: 686f 756c 6420 7072 6f62 6162 6c79 2068 hould probably h │ │ │ │ │ -00005c30: 6176 6520 3220 7061 7274 733a 2061 6e20 ave 2 parts: an │ │ │ │ │ -00005c40: 6173 7365 6d62 6c65 7220 616e 6420 4320 assembler and C │ │ │ │ │ -00005c50: 6f6e 652e 0a41 7373 656d 626c 6572 206f one..Assembler o │ │ │ │ │ -00005c60: 6e65 2068 616e 646c 6573 2042 5353 2063 ne handles BSS c │ │ │ │ │ -00005c70: 6c65 616e 696e 6720 616e 6420 6f74 6865 leaning and othe │ │ │ │ │ -00005c80: 7220 6e65 6564 6564 2073 6574 7570 2028 r needed setup ( │ │ │ │ │ -00005c90: 6f6e 2073 6f6d 650a 706c 6174 666f 726d on some.platform │ │ │ │ │ -00005ca0: 7320 796f 7520 6d61 7920 6e65 6564 2074 s you may need t │ │ │ │ │ -00005cb0: 6f20 7377 6974 6368 206d 6f64 6573 206f o switch modes o │ │ │ │ │ -00005cc0: 7220 636f 7079 2074 6865 2065 7865 6375 r copy the execu │ │ │ │ │ -00005cd0: 7461 626c 6520 746f 2069 7473 0a64 6566 table to its.def │ │ │ │ │ -00005ce0: 696e 6974 6976 6520 706f 7369 7469 6f6e initive position │ │ │ │ │ -00005cf0: 292e 2020 536f 2079 6f75 7220 636f 6465 ). So your code │ │ │ │ │ -00005d00: 206d 6179 206c 6f6f 6b20 6c69 6b65 2028 may look like ( │ │ │ │ │ -00005d10: 7838 3620 6173 7365 6d62 6c79 2066 6f72 x86 assembly for │ │ │ │ │ -00005d20: 0a69 6c6c 7573 7472 6174 696f 6e20 7075 .illustration pu │ │ │ │ │ -00005d30: 7270 6f73 6573 290a 0a20 2020 2020 2020 rposes).. │ │ │ │ │ -00005d40: 2020 2020 2020 2e67 6c6f 626c 205f 7374 .globl _st │ │ │ │ │ -00005d50: 6172 740a 2020 2020 205f 7374 6172 743a art. _start: │ │ │ │ │ -00005d60: 0a20 2020 2020 096d 6f76 6c09 245f 6273 . .movl.$_bs │ │ │ │ │ -00005d70: 735f 7374 6172 742c 2025 6564 690a 2020 s_start, %edi. │ │ │ │ │ -00005d80: 2020 2009 6d6f 766c 0924 5f65 6e64 2c20 .movl.$_end, │ │ │ │ │ -00005d90: 2565 6378 0a20 2020 2020 0973 7562 6c09 %ecx. .subl. │ │ │ │ │ -00005da0: 2565 6469 2c20 2565 6378 0a20 2020 2020 %edi, %ecx. │ │ │ │ │ -00005db0: 0978 6f72 6c09 2565 6178 2c20 2565 6178 .xorl.%eax, %eax │ │ │ │ │ -00005dc0: 0a20 2020 2020 0963 6c64 0a20 2020 2020 . .cld. │ │ │ │ │ -00005dd0: 0972 6570 0a20 2020 2020 0973 746f 7362 .rep. .stosb │ │ │ │ │ -00005de0: 0a20 2020 2020 2020 2020 2020 2020 6361 . ca │ │ │ │ │ -00005df0: 6c6c 206d 6169 6e0a 0a0a 2020 2020 2073 ll main... s │ │ │ │ │ -00005e00: 7461 7469 6320 636f 6e73 7420 6368 6172 tatic const char │ │ │ │ │ -00005e10: 206d 7367 5b5d 203d 2022 4865 6c6c 6f2c msg[] = "Hello, │ │ │ │ │ -00005e20: 2077 6f72 6c64 223b 0a0a 2020 2020 2076 world";.. v │ │ │ │ │ -00005e30: 6f69 640a 2020 2020 2070 7574 6368 6172 oid. putchar │ │ │ │ │ -00005e40: 2028 696e 7420 6329 0a20 2020 2020 7b0a (int c). {. │ │ │ │ │ -00005e50: 2020 2020 2020 202e 2e2e 0a20 2020 2020 .... │ │ │ │ │ -00005e60: 7d0a 0a20 2020 2020 766f 6964 0a20 2020 }.. void. │ │ │ │ │ -00005e70: 2020 6d61 696e 2028 766f 6964 290a 2020 main (void). │ │ │ │ │ -00005e80: 2020 207b 0a20 2020 2020 2020 636f 6e73 {. cons │ │ │ │ │ -00005e90: 7420 6368 6172 202a 7074 7220 3d20 6d73 t char *ptr = ms │ │ │ │ │ -00005ea0: 673b 0a20 2020 2020 2020 7768 696c 6520 g;. while │ │ │ │ │ -00005eb0: 282a 7074 7229 0a20 2020 2020 2020 2020 (*ptr). │ │ │ │ │ -00005ec0: 7075 7463 6861 7220 282a 7074 722b 2b29 putchar (*ptr++) │ │ │ │ │ -00005ed0: 3b0a 2020 2020 2020 2077 6869 6c65 2028 ;. while ( │ │ │ │ │ -00005ee0: 3129 3b0a 2020 2020 207d 0a0a 2020 2053 1);. }.. S │ │ │ │ │ -00005ef0: 6f6d 6574 696d 6573 2079 6f75 206e 6565 ometimes you nee │ │ │ │ │ -00005f00: 6420 6120 7468 6972 6420 6669 6c65 3a20 d a third file: │ │ │ │ │ -00005f10: 6173 7365 6d62 6c79 2073 7475 6273 2066 assembly stubs f │ │ │ │ │ -00005f20: 6f72 0a41 4249 2d63 6f6d 7061 7469 6269 or.ABI-compatibi │ │ │ │ │ -00005f30: 6c69 7479 2e0a 0a20 2020 4f6e 6365 2074 lity... Once t │ │ │ │ │ -00005f40: 6869 7320 6669 6c65 2069 7320 6675 6e63 his file is func │ │ │ │ │ -00005f50: 7469 6f6e 616c 2069 7427 7320 7469 6d65 tional it's time │ │ │ │ │ -00005f60: 2074 6f20 6d6f 7665 2069 7420 696e 746f to move it into │ │ │ │ │ -00005f70: 2047 5255 4232 2e20 2054 6865 0a73 7461 GRUB2. The.sta │ │ │ │ │ -00005f80: 7274 7570 2061 7373 656d 626c 7920 6669 rtup assembly fi │ │ │ │ │ -00005f90: 6c65 2067 6f65 7320 746f 2067 7275 622d le goes to grub- │ │ │ │ │ -00005fa0: 636f 7265 2f6b 6572 6e2f 2463 7075 2f24 core/kern/$cpu/$ │ │ │ │ │ -00005fb0: 706c 6174 666f 726d 2f73 7461 7274 7570 platform/startup │ │ │ │ │ -00005fc0: 2e53 2e0a 596f 7520 7368 6f75 6c64 2061 .S..You should a │ │ │ │ │ -00005fd0: 6c73 6f20 696e 636c 7564 6520 6772 7562 lso include grub │ │ │ │ │ -00005fe0: 2f73 796d 626f 6c2e 6820 616e 6420 7265 /symbol.h and re │ │ │ │ │ -00005ff0: 706c 6163 6520 6361 6c6c 2074 6f20 656e place call to en │ │ │ │ │ -00006000: 7472 7920 706f 696e 740a 7769 7468 2063 try point.with c │ │ │ │ │ -00006010: 616c 6c20 746f 2045 5854 5f43 2867 7275 all to EXT_C(gru │ │ │ │ │ -00006020: 625f 6d61 696e 292e 2020 5468 6520 4320 b_main). The C │ │ │ │ │ -00006030: 6669 6c65 2067 6f65 7320 746f 0a67 7275 file goes to.gru │ │ │ │ │ -00006040: 622d 636f 7265 2f6b 6572 6e2f 2463 7075 b-core/kern/$cpu │ │ │ │ │ -00006050: 2f24 706c 6174 666f 726d 2f69 6e69 742e /$platform/init. │ │ │ │ │ -00006060: 6320 616e 6420 6974 7320 656e 7472 7920 c and its entry │ │ │ │ │ -00006070: 706f 696e 7420 6973 2072 656e 616d 6564 point is renamed │ │ │ │ │ -00006080: 2074 6f0a 766f 6964 2067 7275 625f 6d61 to.void grub_ma │ │ │ │ │ -00006090: 6368 696e 655f 696e 6974 2028 766f 6964 chine_init (void │ │ │ │ │ -000060a0: 292e 2020 4b65 6570 2066 696e 616c 2069 ). Keep final i │ │ │ │ │ -000060b0: 6e66 696e 6974 6520 6c6f 6f70 2066 6f72 nfinite loop for │ │ │ │ │ -000060c0: 206e 6f77 2e20 2053 7475 6273 0a66 696c now. Stubs.fil │ │ │ │ │ -000060d0: 6520 6966 2061 6e79 2067 6f65 7320 746f e if any goes to │ │ │ │ │ -000060e0: 2067 7275 622d 636f 7265 2f6b 6572 6e2f grub-core/kern/ │ │ │ │ │ -000060f0: 2463 7075 2f24 706c 6174 666f 726d 2f63 $cpu/$platform/c │ │ │ │ │ -00006100: 616c 6c77 7261 702e 532e 2053 6f6d 6574 allwrap.S. Somet │ │ │ │ │ -00006110: 696d 6573 0a65 6974 6865 7220 2463 7075 imes.either $cpu │ │ │ │ │ -00006120: 206f 7220 2470 6c61 7466 6f72 6d20 6973 or $platform is │ │ │ │ │ -00006130: 2064 726f 7070 6564 2069 6620 6669 6c65 dropped if file │ │ │ │ │ -00006140: 2069 7320 7573 6564 206f 6e20 7365 7665 is used on seve │ │ │ │ │ -00006150: 7261 6c20 6370 7573 0a72 6573 7065 6374 ral cpus.respect │ │ │ │ │ -00006160: 6976 656c 7970 6c61 7466 6f72 6d73 2e20 ivelyplatforms. │ │ │ │ │ -00006170: 2043 6865 636b 2074 686f 7365 206c 6f63 Check those loc │ │ │ │ │ -00006180: 6174 696f 6e73 2069 6620 7468 6579 2061 ations if they a │ │ │ │ │ -00006190: 6c72 6561 6479 2068 6176 6520 7768 6174 lready have what │ │ │ │ │ -000061a0: 0a79 6f75 2772 6520 6c6f 6f6b 696e 6720 .you're looking │ │ │ │ │ -000061b0: 666f 722e 0a0a 2020 2054 6865 6e20 6d6f for... Then mo │ │ │ │ │ -000061c0: 6469 6679 2069 6e20 636f 6e66 6967 7572 dify in configur │ │ │ │ │ -000061d0: 652e 6163 2074 6865 2066 6f6c 6c6f 7769 e.ac the followi │ │ │ │ │ -000061e0: 6e67 2070 6172 7473 3a0a 0a20 2020 4350 ng parts:.. CP │ │ │ │ │ -000061f0: 5520 6e61 6d65 733a 0a0a 2020 2020 2063 U names:.. c │ │ │ │ │ -00006200: 6173 6520 2224 7461 7267 6574 5f63 7075 ase "$target_cpu │ │ │ │ │ -00006210: 2220 696e 0a20 2020 2020 2020 695b 5b33 " in. i[[3 │ │ │ │ │ -00006220: 3435 365d 5d38 3629 0974 6172 6765 745f 456]]86).target_ │ │ │ │ │ -00006230: 6370 753d 6933 3836 203b 3b0a 2020 2020 cpu=i386 ;;. │ │ │ │ │ -00006240: 2020 2061 6d64 3634 2909 7461 7267 6574 amd64).target │ │ │ │ │ -00006250: 5f63 7075 3d78 3836 5f36 3420 3b3b 0a20 _cpu=x86_64 ;;. │ │ │ │ │ -00006260: 2020 2020 2020 7370 6172 6329 0974 6172 sparc).tar │ │ │ │ │ -00006270: 6765 745f 6370 753d 7370 6172 6336 3420 get_cpu=sparc64 │ │ │ │ │ -00006280: 3b3b 0a20 2020 2020 2020 7333 3930 7829 ;;. s390x) │ │ │ │ │ -00006290: 0974 6172 6765 745f 6370 753d 7333 3930 .target_cpu=s390 │ │ │ │ │ -000062a0: 203b 3b0a 2020 2020 2020 202e 2e2e 0a20 ;;. .... │ │ │ │ │ -000062b0: 2020 2020 6573 6163 0a0a 2020 2053 6f6d esac.. Som │ │ │ │ │ -000062c0: 6574 696d 6573 2043 5055 2068 6176 6520 etimes CPU have │ │ │ │ │ -000062d0: 6164 6469 7469 6f6e 616c 2061 7263 6869 additional archi │ │ │ │ │ -000062e0: 7465 6374 7572 6520 6e61 6d65 7320 7768 tecture names wh │ │ │ │ │ -000062f0: 6963 6820 646f 6e27 740a 696e 666c 7565 ich don't.influe │ │ │ │ │ -00006300: 6e63 6520 626f 6f74 696e 672e 2020 596f nce booting. Yo │ │ │ │ │ -00006310: 7520 6d69 6768 7420 7761 6e74 2074 6f20 u might want to │ │ │ │ │ -00006320: 6861 7665 2073 6f6d 6520 6361 6e6f 6e69 have some canoni │ │ │ │ │ -00006330: 6361 6c20 6e61 6d65 2074 6f20 6176 6f69 cal name to avoi │ │ │ │ │ -00006340: 640a 6861 7669 6e67 2062 756e 6368 206f d.having bunch o │ │ │ │ │ -00006350: 6620 6964 656e 7469 6361 6c20 706c 6174 f identical plat │ │ │ │ │ -00006360: 666f 726d 7320 7769 7468 2064 6966 6665 forms with diffe │ │ │ │ │ -00006370: 7265 6e74 206e 616d 6573 2e0a 0a20 2020 rent names... │ │ │ │ │ -00006380: 4e4f 5445 3a20 6974 2064 6f65 736e 2774 NOTE: it doesn't │ │ │ │ │ -00006390: 2069 6e66 6c75 656e 6365 2063 6f6d 7069 influence compi │ │ │ │ │ -000063a0: 6c65 206f 7074 696d 6973 6174 696f 6e73 le optimisations │ │ │ │ │ -000063b0: 2077 6869 6368 2064 6570 656e 6420 736f which depend so │ │ │ │ │ -000063c0: 6c65 6c79 0a6f 6e20 6368 6f73 656e 2063 lely.on chosen c │ │ │ │ │ -000063d0: 6f6d 7069 6c65 7220 616e 6420 636f 6d70 ompiler and comp │ │ │ │ │ -000063e0: 696c 6520 6f70 7469 6f6e 732e 0a0a 2020 ile options... │ │ │ │ │ -000063f0: 2020 2069 6620 7465 7374 2022 7824 7769 if test "x$wi │ │ │ │ │ -00006400: 7468 5f70 6c61 7466 6f72 6d22 203d 2078 th_platform" = x │ │ │ │ │ -00006410: 3b20 7468 656e 0a20 2020 2020 2020 6361 ; then. ca │ │ │ │ │ -00006420: 7365 2022 2474 6172 6765 745f 6370 7522 se "$target_cpu" │ │ │ │ │ -00006430: 2d22 2474 6172 6765 745f 7665 6e64 6f72 -"$target_vendor │ │ │ │ │ -00006440: 2220 696e 0a20 2020 2020 2020 2020 6933 " in. i3 │ │ │ │ │ -00006450: 3836 2d61 7070 6c65 2920 706c 6174 666f 86-apple) platfo │ │ │ │ │ -00006460: 726d 3d65 6669 203b 3b0a 2020 2020 2020 rm=efi ;;. │ │ │ │ │ -00006470: 2020 2069 3338 362d 2a29 2070 6c61 7466 i386-*) platf │ │ │ │ │ -00006480: 6f72 6d3d 7063 203b 3b0a 2020 2020 2020 orm=pc ;;. │ │ │ │ │ -00006490: 2020 2078 3836 5f36 342d 6170 706c 6529 x86_64-apple) │ │ │ │ │ -000064a0: 2070 6c61 7466 6f72 6d3d 6566 6920 3b3b platform=efi ;; │ │ │ │ │ -000064b0: 0a20 2020 2020 2020 2020 7838 365f 3634 . x86_64 │ │ │ │ │ -000064c0: 2d2a 2920 706c 6174 666f 726d 3d70 6320 -*) platform=pc │ │ │ │ │ -000064d0: 3b3b 0a20 2020 2020 2020 2020 706f 7765 ;;. powe │ │ │ │ │ -000064e0: 7270 632d 2a29 2070 6c61 7466 6f72 6d3d rpc-*) platform= │ │ │ │ │ -000064f0: 6965 6565 3132 3735 203b 3b0a 2020 2020 ieee1275 ;;. │ │ │ │ │ -00006500: 2020 2020 202e 2e2e 0a20 2020 2020 2020 .... │ │ │ │ │ -00006510: 6573 6163 0a20 2020 2020 656c 7365 0a20 esac. else. │ │ │ │ │ -00006520: 2020 2020 2020 2e2e 2e0a 2020 2020 2066 .... f │ │ │ │ │ -00006530: 690a 0a20 2020 5468 6973 2070 6172 7420 i.. This part │ │ │ │ │ -00006540: 6465 616c 7320 7769 7468 2067 7565 7373 deals with guess │ │ │ │ │ -00006550: 696e 6720 7468 6520 706c 6174 666f 726d ing the platform │ │ │ │ │ -00006560: 2066 726f 6d20 4350 5520 616e 6420 7665 from CPU and ve │ │ │ │ │ -00006570: 6e64 6f72 2e0a 536f 6d65 7469 6d65 7320 ndor..Sometimes │ │ │ │ │ -00006580: 796f 7520 6e65 6564 2074 6f20 7573 6520 you need to use │ │ │ │ │ -00006590: 3332 2d62 6974 206d 6f64 6520 666f 7220 32-bit mode for │ │ │ │ │ -000065a0: 626f 6f74 696e 6720 6576 656e 2069 6620 booting even if │ │ │ │ │ -000065b0: 4f53 2072 756e 7320 696e 0a36 342d 6269 OS runs in.64-bi │ │ │ │ │ -000065c0: 7420 6f6e 652e 2020 4966 2073 6f20 6164 t one. If so ad │ │ │ │ │ -000065d0: 6420 796f 7572 2070 6c61 7466 6f72 6d20 d your platform │ │ │ │ │ -000065e0: 746f 3a0a 0a20 2020 2020 6361 7365 2022 to:.. case " │ │ │ │ │ -000065f0: 2474 6172 6765 745f 6370 7522 2d22 2470 $target_cpu"-"$p │ │ │ │ │ -00006600: 6c61 7466 6f72 6d22 2069 6e0a 2020 2020 latform" in. │ │ │ │ │ -00006610: 2020 2078 3836 5f36 342d 6566 6929 203b x86_64-efi) ; │ │ │ │ │ -00006620: 3b0a 2020 2020 2020 2078 3836 5f36 342d ;. x86_64- │ │ │ │ │ -00006630: 656d 7529 203b 3b0a 2020 2020 2020 2078 emu) ;;. x │ │ │ │ │ -00006640: 3836 5f36 342d 2a29 2074 6172 6765 745f 86_64-*) target_ │ │ │ │ │ -00006650: 6370 753d 6933 3836 203b 3b0a 2020 2020 cpu=i386 ;;. │ │ │ │ │ -00006660: 2020 2070 6f77 6572 7063 3634 2d69 6565 powerpc64-iee │ │ │ │ │ -00006670: 6531 3237 3529 2074 6172 6765 745f 6370 e1275) target_cp │ │ │ │ │ -00006680: 753d 706f 7765 7270 6320 3b3b 0a20 2020 u=powerpc ;;. │ │ │ │ │ -00006690: 2020 6573 6163 0a0a 2020 2041 6464 2079 esac.. Add y │ │ │ │ │ -000066a0: 6f75 7220 706c 6174 666f 726d 2074 6f20 our platform to │ │ │ │ │ -000066b0: 7468 6520 6c69 7374 206f 6620 7375 7070 the list of supp │ │ │ │ │ -000066c0: 6f72 7465 6420 6f6e 6573 3a0a 0a20 2020 orted ones:.. │ │ │ │ │ -000066d0: 2020 6361 7365 2022 2474 6172 6765 745f case "$target_ │ │ │ │ │ -000066e0: 6370 7522 2d22 2470 6c61 7466 6f72 6d22 cpu"-"$platform" │ │ │ │ │ -000066f0: 2069 6e0a 2020 2020 2020 2069 3338 362d in. i386- │ │ │ │ │ -00006700: 6566 6929 203b 3b0a 2020 2020 2020 2078 efi) ;;. x │ │ │ │ │ -00006710: 3836 5f36 342d 6566 6929 203b 3b0a 2020 86_64-efi) ;;. │ │ │ │ │ -00006720: 2020 2020 2069 3338 362d 7063 2920 3b3b i386-pc) ;; │ │ │ │ │ -00006730: 0a20 2020 2020 2020 6933 3836 2d6d 756c . i386-mul │ │ │ │ │ -00006740: 7469 626f 6f74 2920 3b3b 0a20 2020 2020 tiboot) ;;. │ │ │ │ │ -00006750: 2020 6933 3836 2d63 6f72 6562 6f6f 7429 i386-coreboot) │ │ │ │ │ -00006760: 203b 3b0a 2020 2020 2020 202e 2e2e 0a20 ;;. .... │ │ │ │ │ -00006770: 2020 2020 6573 6163 0a0a 2020 2049 6620 esac.. If │ │ │ │ │ -00006780: 6578 706c 6963 6974 202d 6d33 3220 6f72 explicit -m32 or │ │ │ │ │ -00006790: 202d 6d36 3420 6973 206e 6565 6465 6420 -m64 is needed │ │ │ │ │ -000067a0: 6164 6420 6974 2074 6f3a 0a0a 2020 2020 add it to:.. │ │ │ │ │ -000067b0: 2063 6173 6520 2224 7461 7267 6574 5f63 case "$target_c │ │ │ │ │ -000067c0: 7075 2220 696e 0a20 2020 2020 2020 6933 pu" in. i3 │ │ │ │ │ -000067d0: 3836 207c 2070 6f77 6572 7063 2920 7461 86 | powerpc) ta │ │ │ │ │ -000067e0: 7267 6574 5f6d 3332 3d31 203b 3b0a 2020 rget_m32=1 ;;. │ │ │ │ │ -000067f0: 2020 2020 2078 3836 5f36 3420 7c20 7370 x86_64 | sp │ │ │ │ │ -00006800: 6172 6336 3429 2074 6172 6765 745f 6d36 arc64) target_m6 │ │ │ │ │ -00006810: 343d 3120 3b3b 0a20 2020 2020 6573 6163 4=1 ;;. esac │ │ │ │ │ -00006820: 0a0a 2020 2046 696e 616c 6c79 2079 6f75 .. Finally you │ │ │ │ │ -00006830: 206e 6565 6420 746f 2061 6464 2061 2063 need to add a c │ │ │ │ │ -00006840: 6f6e 6469 7469 6f6e 616c 2074 6f20 7468 onditional to th │ │ │ │ │ -00006850: 6520 666f 6c6c 6f77 696e 6720 626c 6f63 e following bloc │ │ │ │ │ -00006860: 6b3a 0a0a 2020 2020 2041 4d5f 434f 4e44 k:.. AM_COND │ │ │ │ │ -00006870: 4954 494f 4e41 4c28 5b43 4f4e 445f 6d69 ITIONAL([COND_mi │ │ │ │ │ -00006880: 7073 5f61 7263 5d2c 205b 7465 7374 2078 ps_arc], [test x │ │ │ │ │ -00006890: 2474 6172 6765 745f 6370 7520 3d20 786d $target_cpu = xm │ │ │ │ │ -000068a0: 6970 7320 2d61 2078 2470 6c61 7466 6f72 ips -a x$platfor │ │ │ │ │ -000068b0: 6d20 3d20 7861 7263 5d29 0a20 2020 2020 m = xarc]). │ │ │ │ │ -000068c0: 414d 5f43 4f4e 4449 5449 4f4e 414c 285b AM_CONDITIONAL([ │ │ │ │ │ -000068d0: 434f 4e44 5f73 7061 7263 3634 5f69 6565 COND_sparc64_iee │ │ │ │ │ -000068e0: 6531 3237 355d 2c20 5b74 6573 7420 7824 e1275], [test x$ │ │ │ │ │ -000068f0: 7461 7267 6574 5f63 7075 203d 2078 7370 target_cpu = xsp │ │ │ │ │ -00006900: 6172 6336 3420 2d61 2078 2470 6c61 7466 arc64 -a x$platf │ │ │ │ │ -00006910: 6f72 6d20 3d20 7869 6565 6531 3237 355d orm = xieee1275] │ │ │ │ │ -00006920: 290a 2020 2020 2041 4d5f 434f 4e44 4954 ). AM_CONDIT │ │ │ │ │ -00006930: 494f 4e41 4c28 5b43 4f4e 445f 706f 7765 IONAL([COND_powe │ │ │ │ │ -00006940: 7270 635f 6965 6565 3132 3735 5d2c 205b rpc_ieee1275], [ │ │ │ │ │ -00006950: 7465 7374 2078 2474 6172 6765 745f 6370 test x$target_cp │ │ │ │ │ -00006960: 7520 3d20 7870 6f77 6572 7063 202d 6120 u = xpowerpc -a │ │ │ │ │ -00006970: 7824 706c 6174 666f 726d 203d 2078 6965 x$platform = xie │ │ │ │ │ -00006980: 6565 3132 3735 5d29 0a0a 2020 204e 6578 ee1275]).. Nex │ │ │ │ │ -00006990: 7420 7374 6f70 2069 7320 6765 6e74 706c t stop is gentpl │ │ │ │ │ -000069a0: 2e70 792e 2020 596f 7520 6e65 6564 2074 .py. You need t │ │ │ │ │ -000069b0: 6f20 6164 6420 796f 7572 2070 6c61 7466 o add your platf │ │ │ │ │ -000069c0: 6f72 6d20 746f 2074 6865 206c 6973 7420 orm to the list │ │ │ │ │ -000069d0: 6f66 0a73 7570 706f 7274 6564 206f 6e65 of.supported one │ │ │ │ │ -000069e0: 7320 2873 6f72 7279 2074 6861 7420 7468 s (sorry that th │ │ │ │ │ -000069f0: 6973 206c 6973 7420 6973 2064 7570 6c69 is list is dupli │ │ │ │ │ -00006a00: 6361 7465 6429 3a0a 0a20 2020 2020 4752 cated):.. GR │ │ │ │ │ -00006a10: 5542 5f50 4c41 5446 4f52 4d53 203d 205b UB_PLATFORMS = [ │ │ │ │ │ -00006a20: 2022 656d 7522 2c20 2269 3338 365f 7063 "emu", "i386_pc │ │ │ │ │ -00006a30: 222c 2022 6933 3836 5f65 6669 222c 2022 ", "i386_efi", " │ │ │ │ │ -00006a40: 6933 3836 5f71 656d 7522 2c20 2269 3338 i386_qemu", "i38 │ │ │ │ │ -00006a50: 365f 636f 7265 626f 6f74 222c 0a20 2020 6_coreboot",. │ │ │ │ │ +00004520: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4173 ============..As │ │ │ │ │ +00004530: 2079 6f75 206d 6967 6874 206b 6e6f 772c you might know, │ │ │ │ │ +00004540: 2047 5255 4220 6973 2068 6f73 7465 6420 GRUB is hosted │ │ │ │ │ +00004550: 6f6e 0a3c 6874 7470 733a 2f2f 7361 7661 on., thus the m │ │ │ │ │ +00004590: 656d 6265 7273 6869 700a 6973 206d 616e embership.is man │ │ │ │ │ +000045a0: 6167 6564 2062 7920 5361 7661 6e6e 6168 aged by Savannah │ │ │ │ │ +000045b0: 2e20 2054 6869 7320 6d65 616e 7320 7468 . This means th │ │ │ │ │ +000045c0: 6174 2c20 6966 2079 6f75 2077 616e 7420 at, if you want │ │ │ │ │ +000045d0: 746f 2062 6520 6120 6d65 6d62 6572 206f to be a member o │ │ │ │ │ +000045e0: 660a 7468 6973 2070 726f 6a65 6374 3a0a f.this project:. │ │ │ │ │ +000045f0: 0a20 2031 2e20 596f 7520 6e65 6564 2074 . 1. You need t │ │ │ │ │ +00004600: 6f20 6372 6561 7465 2079 6f75 7220 6f77 o create your ow │ │ │ │ │ +00004610: 6e20 6163 636f 756e 7420 6f6e 2053 6176 n account on Sav │ │ │ │ │ +00004620: 616e 6e61 682e 0a20 2032 2e20 596f 7520 annah.. 2. You │ │ │ │ │ +00004630: 6361 6e20 7375 626d 6974 2022 5265 7175 can submit "Requ │ │ │ │ │ +00004640: 6573 7420 666f 7220 496e 636c 7573 696f est for Inclusio │ │ │ │ │ +00004650: 6e22 2066 726f 6d20 224d 7920 4772 6f75 n" from "My Grou │ │ │ │ │ +00004660: 7073 2220 6f6e 0a20 2020 2020 5361 7661 ps" on. Sava │ │ │ │ │ +00004670: 6e6e 6168 2e0a 0a20 2020 5468 656e 2c20 nnah... Then, │ │ │ │ │ +00004680: 6f6e 6520 6f66 2074 6865 2061 646d 696e one of the admin │ │ │ │ │ +00004690: 7320 6361 6e20 6170 7072 6f76 6520 796f s can approve yo │ │ │ │ │ +000046a0: 7572 2072 6571 7565 7374 2c20 616e 6420 ur request, and │ │ │ │ │ +000046b0: 796f 7520 7769 6c6c 2062 6520 610a 6d65 you will be a.me │ │ │ │ │ +000046c0: 6d62 6572 2e20 2049 6620 796f 7520 646f mber. If you do │ │ │ │ │ +000046d0: 6e27 7420 7761 6e74 2074 6f20 7573 6520 n't want to use │ │ │ │ │ +000046e0: 7468 6520 5361 7661 6e6e 6168 2069 6e74 the Savannah int │ │ │ │ │ +000046f0: 6572 6661 6365 2074 6f20 7375 626d 6974 erface to submit │ │ │ │ │ +00004700: 2061 0a72 6571 7565 7374 2c20 796f 7520 a.request, you │ │ │ │ │ +00004710: 6361 6e20 7369 6d70 6c79 206e 6f74 6966 can simply notif │ │ │ │ │ +00004720: 7920 7468 6520 6164 6d69 6e73 2062 7920 y the admins by │ │ │ │ │ +00004730: 656d 6169 6c20 6f72 2073 6f6d 6574 6869 email or somethi │ │ │ │ │ +00004740: 6e67 2065 6c73 652c 0a61 6c74 6572 6e61 ng else,.alterna │ │ │ │ │ +00004750: 7469 7665 6c79 2e20 2042 7574 2079 6f75 tively. But you │ │ │ │ │ +00004760: 2073 7469 6c6c 206e 6565 6420 746f 2063 still need to c │ │ │ │ │ +00004770: 7265 6174 6520 616e 2061 6363 6f75 6e74 reate an account │ │ │ │ │ +00004780: 2062 6566 6f72 6568 616e 642e 0a0a 2020 beforehand... │ │ │ │ │ +00004790: 204e 4f54 453a 2077 6520 736f 6d65 7469 NOTE: we someti │ │ │ │ │ +000047a0: 6d65 7320 7265 6365 6976 6520 6120 2252 mes receive a "R │ │ │ │ │ +000047b0: 6571 7565 7374 2066 6f72 2049 6e63 6c75 equest for Inclu │ │ │ │ │ +000047c0: 7369 6f6e 2220 6672 6f6d 2061 6e20 756e sion" from an un │ │ │ │ │ +000047d0: 6b6e 6f77 6e0a 7065 7273 6f6e 2e20 2049 known.person. I │ │ │ │ │ +000047e0: 6e20 7468 6973 2063 6173 652c 2074 6865 n this case, the │ │ │ │ │ +000047f0: 2072 6571 7565 7374 2077 6f75 6c64 2062 request would b │ │ │ │ │ +00004800: 6520 6a75 7374 2064 6973 6361 7264 6564 e just discarded │ │ │ │ │ +00004810: 2c20 7369 6e63 6520 6974 2069 730a 746f , since it is.to │ │ │ │ │ +00004820: 6f20 6461 6e67 6572 6f75 7320 746f 2061 o dangerous to a │ │ │ │ │ +00004830: 6c6c 6f77 2061 2073 7472 616e 6765 7220 llow a stranger │ │ │ │ │ +00004840: 746f 2062 6520 6120 6d65 6d62 6572 2c20 to be a member, │ │ │ │ │ +00004850: 7768 6963 6820 6175 746f 6d61 7469 6361 which automatica │ │ │ │ │ +00004860: 6c6c 790a 6769 7665 7320 6869 6d20 6120 lly.gives him a │ │ │ │ │ +00004870: 636f 6d6d 6974 2072 6967 6874 2074 6f20 commit right to │ │ │ │ │ +00004880: 7468 6520 7265 706f 7369 746f 7279 2c20 the repository, │ │ │ │ │ +00004890: 626f 7468 2066 6f72 2061 206c 6567 616c both for a legal │ │ │ │ │ +000048a0: 2072 6561 736f 6e20 616e 640a 666f 7220 reason and.for │ │ │ │ │ +000048b0: 6120 7465 6368 6e69 6361 6c20 7265 6173 a technical reas │ │ │ │ │ +000048c0: 6f6e 2e0a 0a20 2020 4966 2079 6f75 7220 on... If your │ │ │ │ │ +000048d0: 696e 7465 6e74 696f 6e20 6973 2074 6f20 intention is to │ │ │ │ │ +000048e0: 6a75 7374 2067 6574 2073 7461 7274 6564 just get started │ │ │ │ │ +000048f0: 2c20 706c 6561 7365 2064 6f20 6e6f 7420 , please do not │ │ │ │ │ +00004900: 7375 626d 6974 2061 0a69 6e63 6c75 7369 submit a.inclusi │ │ │ │ │ +00004910: 6f6e 2072 6571 7565 7374 2e20 2049 6e73 on request. Ins │ │ │ │ │ +00004920: 7465 6164 2c20 706c 6561 7365 2073 7562 tead, please sub │ │ │ │ │ +00004930: 7363 7269 6265 2074 6f20 7468 6520 6d61 scribe to the ma │ │ │ │ │ +00004940: 696c 696e 6720 6c69 7374 2c20 616e 640a iling list, and. │ │ │ │ │ +00004950: 636f 6d6d 756e 6963 6174 6520 6669 7273 communicate firs │ │ │ │ │ +00004960: 7420 2865 2e67 2e20 2073 656e 6469 6e67 t (e.g. sending │ │ │ │ │ +00004970: 2061 2070 6174 6368 2c20 6173 6b69 6e67 a patch, asking │ │ │ │ │ +00004980: 2061 2071 7565 7374 696f 6e2c 2063 6f6d a question, com │ │ │ │ │ +00004990: 6d65 6e74 696e 670a 6f6e 2061 6e6f 7468 menting.on anoth │ │ │ │ │ +000049a0: 6572 206d 6573 7361 6765 2e2e 2e29 2e0a er message...).. │ │ │ │ │ +000049b0: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ │ +000049c0: 762e 696e 666f 2c20 204e 6f64 653a 2055 v.info, Node: U │ │ │ │ │ +000049d0: 7064 6174 696e 6720 4578 7465 726e 616c pdating External │ │ │ │ │ +000049e0: 2043 6f64 652c 2020 4e65 7874 3a20 506f Code, Next: Po │ │ │ │ │ +000049f0: 7274 696e 672c 2020 5072 6576 3a20 436f rting, Prev: Co │ │ │ │ │ +00004a00: 6e74 7269 6275 7469 6e67 2043 6861 6e67 ntributing Chang │ │ │ │ │ +00004a10: 6573 2c20 2055 703a 2054 6f70 0a0a 3520 es, Up: Top..5 │ │ │ │ │ +00004a20: 5570 6461 7469 6e67 2065 7874 6572 6e61 Updating externa │ │ │ │ │ +00004a30: 6c20 636f 6465 0a2a 2a2a 2a2a 2a2a 2a2a l code.********* │ │ │ │ │ +00004a40: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ +00004a50: 0a47 5255 4220 696e 636c 7564 6573 2073 .GRUB includes s │ │ │ │ │ +00004a60: 6f6d 6520 636f 6465 2066 726f 6d20 6f74 ome code from ot │ │ │ │ │ +00004a70: 6865 7220 7072 6f6a 6563 7473 2c20 616e her projects, an │ │ │ │ │ +00004a80: 6420 6974 2069 7320 736f 6d65 7469 6d65 d it is sometime │ │ │ │ │ +00004a90: 730a 6e65 6365 7373 6172 7920 746f 2075 s.necessary to u │ │ │ │ │ +00004aa0: 7064 6174 6520 6974 2e0a 0a2a 204d 656e pdate it...* Men │ │ │ │ │ +00004ab0: 753a 0a0a 2a20 476e 756c 6962 3a3a 0a2a u:..* Gnulib::.* │ │ │ │ │ +00004ac0: 206a 736d 6e3a 3a0a 2a20 6d69 6e69 6c7a jsmn::.* minilz │ │ │ │ │ +00004ad0: 6f3a 3a0a 0a1f 0a46 696c 653a 2067 7275 o::....File: gru │ │ │ │ │ +00004ae0: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +00004af0: 653a 2047 6e75 6c69 622c 2020 4e65 7874 e: Gnulib, Next │ │ │ │ │ +00004b00: 3a20 6a73 6d6e 2c20 2055 703a 2055 7064 : jsmn, Up: Upd │ │ │ │ │ +00004b10: 6174 696e 6720 4578 7465 726e 616c 2043 ating External C │ │ │ │ │ +00004b20: 6f64 650a 0a35 2e31 2047 6e75 6c69 620a ode..5.1 Gnulib. │ │ │ │ │ +00004b30: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 476e 756c ==========..Gnul │ │ │ │ │ +00004b40: 6962 2069 7320 6120 736f 7572 6365 2063 ib is a source c │ │ │ │ │ +00004b50: 6f64 6520 6c69 6272 6172 7920 7468 6174 ode library that │ │ │ │ │ +00004b60: 2070 726f 7669 6465 7320 6261 7369 6320 provides basic │ │ │ │ │ +00004b70: 6675 6e63 7469 6f6e 616c 6974 7920 746f functionality to │ │ │ │ │ +00004b80: 0a70 726f 6772 616d 7320 616e 6420 6c69 .programs and li │ │ │ │ │ +00004b90: 6272 6172 6965 732e 2020 4d61 6e79 2073 braries. Many s │ │ │ │ │ +00004ba0: 6f66 7477 6172 6520 7061 636b 6167 6573 oftware packages │ │ │ │ │ +00004bb0: 206d 616b 6520 7573 6520 6f66 2047 6e75 make use of Gnu │ │ │ │ │ +00004bc0: 6c69 6220 746f 0a61 766f 6964 2072 6569 lib to.avoid rei │ │ │ │ │ +00004bd0: 6e76 656e 7469 6e67 2074 6865 2070 6f72 nventing the por │ │ │ │ │ +00004be0: 7461 6269 6c69 7479 2077 6865 656c 2e0a tability wheel.. │ │ │ │ │ +00004bf0: 0a20 2020 4752 5542 2069 6d70 6f72 7473 . GRUB imports │ │ │ │ │ +00004c00: 2047 6e75 6c69 6220 7573 696e 6720 6974 Gnulib using it │ │ │ │ │ +00004c10: 7320 2762 6f6f 7473 7472 6170 2720 7574 s 'bootstrap' ut │ │ │ │ │ +00004c20: 696c 6974 792c 2069 6465 6e74 6966 7969 ility, identifyi │ │ │ │ │ +00004c30: 6e67 2061 0a70 6172 7469 6375 6c61 7220 ng a.particular │ │ │ │ │ +00004c40: 4769 7420 636f 6d6d 6974 2069 6e20 2762 Git commit in 'b │ │ │ │ │ +00004c50: 6f6f 7473 7472 6170 2e63 6f6e 6627 2e20 ootstrap.conf'. │ │ │ │ │ +00004c60: 2054 6f20 7570 6772 6164 6520 746f 2061 To upgrade to a │ │ │ │ │ +00004c70: 206e 6577 2047 6e75 6c69 620a 636f 6d6d new Gnulib.comm │ │ │ │ │ +00004c80: 6974 2c20 7365 7420 2747 4e55 4c49 425f it, set 'GNULIB_ │ │ │ │ │ +00004c90: 5245 5649 5349 4f4e 2720 696e 2027 626f REVISION' in 'bo │ │ │ │ │ +00004ca0: 6f74 7374 7261 702e 636f 6e66 2720 746f otstrap.conf' to │ │ │ │ │ +00004cb0: 2074 6865 206e 6577 2063 6f6d 6d69 7420 the new commit │ │ │ │ │ +00004cc0: 4944 2c0a 7468 656e 2072 756e 2027 2e2f ID,.then run './ │ │ │ │ │ +00004cd0: 626f 6f74 7374 7261 7027 2061 6e64 2077 bootstrap' and w │ │ │ │ │ +00004ce0: 6861 7465 7665 7220 656c 7365 2079 6f75 hatever else you │ │ │ │ │ +00004cf0: 206e 6565 6420 746f 206d 616b 6520 7375 need to make su │ │ │ │ │ +00004d00: 7265 2069 7420 776f 726b 732e 0a43 6865 re it works..Che │ │ │ │ │ +00004d10: 636b 2066 6f72 2063 6861 6e67 6573 2074 ck for changes t │ │ │ │ │ +00004d20: 6f20 476e 756c 6962 2773 2027 4e45 5753 o Gnulib's 'NEWS │ │ │ │ │ +00004d30: 2720 6669 6c65 2062 6574 7765 656e 2074 ' file between t │ │ │ │ │ +00004d40: 6865 206f 6c64 2061 6e64 206e 6577 0a63 he old and new.c │ │ │ │ │ +00004d50: 6f6d 6d69 7473 3b20 696e 2073 6f6d 6520 ommits; in some │ │ │ │ │ +00004d60: 6361 7365 7320 6974 2077 696c 6c20 6265 cases it will be │ │ │ │ │ +00004d70: 206e 6563 6573 7361 7279 2074 6f20 6164 necessary to ad │ │ │ │ │ +00004d80: 6a75 7374 2047 5255 4220 746f 206d 6174 just GRUB to mat │ │ │ │ │ +00004d90: 6368 2e0a 596f 7520 6d61 7920 616c 736f ch..You may also │ │ │ │ │ +00004da0: 206e 6565 6420 746f 2075 7064 6174 6520 need to update │ │ │ │ │ +00004db0: 7468 6520 7061 7463 6865 7320 696e 0a27 the patches in.' │ │ │ │ │ +00004dc0: 6772 7562 2d63 6f72 652f 6c69 622f 676e grub-core/lib/gn │ │ │ │ │ +00004dd0: 756c 6962 2d70 6174 6368 6573 2f27 2e0a ulib-patches/'.. │ │ │ │ │ +00004de0: 0a20 2020 546f 2061 6464 2061 206e 6577 . To add a new │ │ │ │ │ +00004df0: 2047 6e75 6c69 6220 6d6f 6475 6c65 206f Gnulib module o │ │ │ │ │ +00004e00: 7220 7265 6d6f 7665 206f 6e65 2074 6861 r remove one tha │ │ │ │ │ +00004e10: 7420 6973 206e 6f20 6c6f 6e67 6572 206e t is no longer n │ │ │ │ │ +00004e20: 6565 6465 642c 0a63 6861 6e67 6520 2767 eeded,.change 'g │ │ │ │ │ +00004e30: 6e75 6c69 625f 6d6f 6475 6c65 7327 2069 nulib_modules' i │ │ │ │ │ +00004e40: 6e20 2762 6f6f 7473 7472 6170 2e63 6f6e n 'bootstrap.con │ │ │ │ │ +00004e50: 6627 2e20 2041 6761 696e 2c20 7275 6e20 f'. Again, run │ │ │ │ │ +00004e60: 272e 2f62 6f6f 7473 7472 6170 270a 616e './bootstrap'.an │ │ │ │ │ +00004e70: 6420 7768 6174 6576 6572 2065 6c73 6520 d whatever else │ │ │ │ │ +00004e80: 796f 7520 6e65 6564 2074 6f20 6d61 6b65 you need to make │ │ │ │ │ +00004e90: 2073 7572 6520 6974 2077 6f72 6b73 2e0a sure it works.. │ │ │ │ │ +00004ea0: 0a20 2020 426f 6f74 7374 7261 7070 696e . Bootstrappin │ │ │ │ │ +00004eb0: 6720 6672 6f6d 2061 6e20 6f6c 6465 7220 g from an older │ │ │ │ │ +00004ec0: 6469 7374 7269 6275 7469 6f6e 2063 6f6e distribution con │ │ │ │ │ +00004ed0: 7461 696e 696e 6720 6765 7474 6578 7420 taining gettext │ │ │ │ │ +00004ee0: 7665 7273 696f 6e20 3c0a 302e 3138 2e33 version <.0.18.3 │ │ │ │ │ +00004ef0: 2c20 7769 6c6c 2072 6571 7569 7265 2061 , will require a │ │ │ │ │ +00004f00: 2070 6174 6368 2073 696d 696c 6172 2074 patch similar t │ │ │ │ │ +00004f10: 6f20 7468 6973 2074 6f20 6265 2061 7070 o this to be app │ │ │ │ │ +00004f20: 6c69 6564 2066 6972 7374 2062 6566 6f72 lied first befor │ │ │ │ │ +00004f30: 650a 7275 6e6e 696e 6720 7468 6520 272e e.running the '. │ │ │ │ │ +00004f40: 2f62 6f6f 7473 7472 6170 2720 7574 696c /bootstrap' util │ │ │ │ │ +00004f50: 6974 793a 0a0a 2020 2020 2064 6966 6620 ity:.. diff │ │ │ │ │ +00004f60: 2d2d 6769 7420 612f 626f 6f74 7374 7261 --git a/bootstra │ │ │ │ │ +00004f70: 702e 636f 6e66 2062 2f62 6f6f 7473 7472 p.conf b/bootstr │ │ │ │ │ +00004f80: 6170 2e63 6f6e 660a 2020 2020 2069 6e64 ap.conf. ind │ │ │ │ │ +00004f90: 6578 2039 3838 6464 6130 2e2e 6133 3139 ex 988dda0..a319 │ │ │ │ │ +00004fa0: 3361 3920 3130 3036 3434 0a20 2020 2020 3a9 100644. │ │ │ │ │ +00004fb0: 2d2d 2d20 612f 626f 6f74 7374 7261 702e --- a/bootstrap. │ │ │ │ │ +00004fc0: 636f 6e66 0a20 2020 2020 2b2b 2b20 622f conf. +++ b/ │ │ │ │ │ +00004fd0: 626f 6f74 7374 7261 702e 636f 6e66 0a20 bootstrap.conf. │ │ │ │ │ +00004fe0: 2020 2020 4020 2d36 372c 3720 2b36 372c @ -67,7 +67, │ │ │ │ │ +00004ff0: 3720 4020 534b 4950 5f50 4f3d 740a 2020 7 @ SKIP_PO=t. │ │ │ │ │ +00005000: 2020 2062 7569 6c64 7265 713d 225c 0a20 buildreq="\. │ │ │ │ │ +00005010: 2020 2020 6175 746f 636f 6e66 2020 2032 autoconf 2 │ │ │ │ │ +00005020: 2e36 330a 2020 2020 2061 7574 6f6d 616b .63. automak │ │ │ │ │ +00005030: 6520 2020 312e 3131 0a20 2020 2020 2d67 e 1.11. -g │ │ │ │ │ +00005040: 6574 7465 7874 2020 2020 302e 3138 2e33 ettext 0.18.3 │ │ │ │ │ +00005050: 0a20 2020 2020 2b67 6574 7465 7874 2020 . +gettext │ │ │ │ │ +00005060: 2020 302e 3137 0a20 2020 2020 6769 7420 0.17. git │ │ │ │ │ +00005070: 2020 2020 2020 2031 2e35 2e35 0a20 2020 1.5.5. │ │ │ │ │ +00005080: 2020 7461 7220 2020 2020 2020 202d 0a20 tar -. │ │ │ │ │ +00005090: 2020 2020 220a 2020 2020 2064 6966 6620 ". diff │ │ │ │ │ +000050a0: 2d2d 6769 7420 612f 636f 6e66 6967 7572 --git a/configur │ │ │ │ │ +000050b0: 652e 6163 2062 2f63 6f6e 6669 6775 7265 e.ac b/configure │ │ │ │ │ +000050c0: 2e61 630a 2020 2020 2069 6e64 6578 2030 .ac. index 0 │ │ │ │ │ +000050d0: 3862 3531 3866 2e2e 3939 6635 6233 3620 8b518f..99f5b36 │ │ │ │ │ +000050e0: 3130 3036 3434 0a20 2020 2020 2d2d 2d20 100644. --- │ │ │ │ │ +000050f0: 612f 636f 6e66 6967 7572 652e 6163 0a20 a/configure.ac. │ │ │ │ │ +00005100: 2020 2020 2b2b 2b20 622f 636f 6e66 6967 +++ b/config │ │ │ │ │ +00005110: 7572 652e 6163 0a20 2020 2020 4020 2d33 ure.ac. @ -3 │ │ │ │ │ +00005120: 3632 2c37 202b 3336 322c 3720 4020 4143 62,7 +362,7 @ AC │ │ │ │ │ +00005130: 5f43 4845 434b 5f50 524f 4728 4841 5645 _CHECK_PROG(HAVE │ │ │ │ │ +00005140: 5f43 5858 2c20 2443 5858 2c20 7965 732c _CXX, $CXX, yes, │ │ │ │ │ +00005150: 206e 6f29 0a0a 2020 2020 2041 435f 474e no).. AC_GN │ │ │ │ │ +00005160: 555f 534f 5552 4345 0a20 2020 2020 414d U_SOURCE. AM │ │ │ │ │ +00005170: 5f47 4e55 5f47 4554 5445 5854 285b 6578 _GNU_GETTEXT([ex │ │ │ │ │ +00005180: 7465 726e 616c 5d29 0a20 2020 2020 2d41 ternal]). -A │ │ │ │ │ +00005190: 4d5f 474e 555f 4745 5454 4558 545f 5645 M_GNU_GETTEXT_VE │ │ │ │ │ +000051a0: 5253 494f 4e28 5b30 2e31 382e 335d 290a RSION([0.18.3]). │ │ │ │ │ +000051b0: 2020 2020 202b 414d 5f47 4e55 5f47 4554 +AM_GNU_GET │ │ │ │ │ +000051c0: 5445 5854 5f56 4552 5349 4f4e 285b 302e TEXT_VERSION([0. │ │ │ │ │ +000051d0: 3137 5d29 0a20 2020 2020 4143 5f53 5953 17]). AC_SYS │ │ │ │ │ +000051e0: 5f4c 4152 4745 4649 4c45 0a0a 2020 2020 _LARGEFILE.. │ │ │ │ │ +000051f0: 2023 2049 6465 6e74 6966 7920 6368 6172 # Identify char │ │ │ │ │ +00005200: 6163 7465 7269 7374 6963 7320 6f66 2074 acteristics of t │ │ │ │ │ +00005210: 6865 2068 6f73 7420 6172 6368 6974 6563 he host architec │ │ │ │ │ +00005220: 7475 7265 2e0a 0a0a 2020 2049 7420 7769 ture.... It wi │ │ │ │ │ +00005230: 6c6c 2061 6c73 6f20 6265 206e 6563 6573 ll also be neces │ │ │ │ │ +00005240: 7361 7279 2074 6f20 6164 6a75 7374 2074 sary to adjust t │ │ │ │ │ +00005250: 6865 2070 6174 6368 6573 2069 6e0a 2770 he patches in.'p │ │ │ │ │ +00005260: 6f2f 6765 7474 6578 742d 7061 7463 6865 o/gettext-patche │ │ │ │ │ +00005270: 732f 2720 746f 2061 7070 6c79 2074 6f20 s/' to apply to │ │ │ │ │ +00005280: 616e 206f 6c64 6572 2076 6572 7369 6f6e an older version │ │ │ │ │ +00005290: 206f 6620 6765 7474 6578 742e 0a0a 1f0a of gettext..... │ │ │ │ │ +000052a0: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ │ +000052b0: 6e66 6f2c 2020 4e6f 6465 3a20 6a73 6d6e nfo, Node: jsmn │ │ │ │ │ +000052c0: 2c20 204e 6578 743a 206d 696e 696c 7a6f , Next: minilzo │ │ │ │ │ +000052d0: 2c20 2050 7265 763a 2047 6e75 6c69 622c , Prev: Gnulib, │ │ │ │ │ +000052e0: 2020 5570 3a20 5570 6461 7469 6e67 2045 Up: Updating E │ │ │ │ │ +000052f0: 7874 6572 6e61 6c20 436f 6465 0a0a 352e xternal Code..5. │ │ │ │ │ +00005300: 3220 6a73 6d6e 0a3d 3d3d 3d3d 3d3d 3d0a 2 jsmn.========. │ │ │ │ │ +00005310: 0a6a 736d 6e20 6973 2061 206d 696e 696d .jsmn is a minim │ │ │ │ │ +00005320: 616c 6973 7469 6320 4a53 4f4e 2070 6172 alistic JSON par │ │ │ │ │ +00005330: 7365 7220 7768 6963 6820 6973 2069 6d70 ser which is imp │ │ │ │ │ +00005340: 6c65 6d65 6e74 6564 2069 6e20 6120 7369 lemented in a si │ │ │ │ │ +00005350: 6e67 6c65 0a68 6561 6465 7220 6669 6c65 ngle.header file │ │ │ │ │ +00005360: 2027 6a73 6d6e 2e68 272e 2020 546f 2069 'jsmn.h'. To i │ │ │ │ │ +00005370: 6d70 6f72 7420 6120 6469 6666 6572 656e mport a differen │ │ │ │ │ +00005380: 7420 7665 7273 696f 6e20 6f66 2074 6865 t version of the │ │ │ │ │ +00005390: 206a 736d 6e20 7061 7273 6572 2c0a 796f jsmn parser,.yo │ │ │ │ │ +000053a0: 7520 6d61 7920 7369 6d70 6c79 2064 6f77 u may simply dow │ │ │ │ │ +000053b0: 6e6c 6f61 6420 7468 6520 276a 736d 6e2e nload the 'jsmn. │ │ │ │ │ +000053c0: 6827 2068 6561 6465 7220 6672 6f6d 2074 h' header from t │ │ │ │ │ +000053d0: 6865 2064 6573 6972 6564 2074 6167 206f he desired tag o │ │ │ │ │ +000053e0: 720a 636f 6d6d 6974 2074 6f20 7468 6520 r.commit to the │ │ │ │ │ +000053f0: 7461 7267 6574 2064 6972 6563 746f 7279 target directory │ │ │ │ │ +00005400: 3a0a 0a20 2020 2020 6375 726c 202d 4c20 :.. curl -L │ │ │ │ │ +00005410: 6874 7470 733a 2f2f 7261 772e 6769 7468 https://raw.gith │ │ │ │ │ +00005420: 7562 7573 6572 636f 6e74 656e 742e 636f ubusercontent.co │ │ │ │ │ +00005430: 6d2f 7a73 6572 6765 2f6a 736d 6e2f 7631 m/zserge/jsmn/v1 │ │ │ │ │ +00005440: 2e31 2e30 2f6a 736d 6e2e 6820 5c0a 2020 .1.0/jsmn.h \. │ │ │ │ │ +00005450: 2020 2020 2020 202d 6f20 6772 7562 2d63 -o grub-c │ │ │ │ │ +00005460: 6f72 652f 6c69 622f 6a73 6f6e 2f6a 736d ore/lib/json/jsm │ │ │ │ │ +00005470: 6e2e 680a 0a1f 0a46 696c 653a 2067 7275 n.h....File: gru │ │ │ │ │ +00005480: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +00005490: 653a 206d 696e 696c 7a6f 2c20 2050 7265 e: minilzo, Pre │ │ │ │ │ +000054a0: 763a 206a 736d 6e2c 2020 5570 3a20 5570 v: jsmn, Up: Up │ │ │ │ │ +000054b0: 6461 7469 6e67 2045 7874 6572 6e61 6c20 dating External │ │ │ │ │ +000054c0: 436f 6465 0a0a 352e 3320 6d69 6e69 6c7a Code..5.3 minilz │ │ │ │ │ +000054d0: 6f0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a6d o.===========..m │ │ │ │ │ +000054e0: 696e 694c 5a4f 2069 7320 6120 7665 7279 iniLZO is a very │ │ │ │ │ +000054f0: 206c 6967 6874 7765 6967 6874 2073 7562 lightweight sub │ │ │ │ │ +00005500: 7365 7420 6f66 2074 6865 204c 5a4f 206c set of the LZO l │ │ │ │ │ +00005510: 6962 7261 7279 2069 6e74 656e 6465 6420 ibrary intended │ │ │ │ │ +00005520: 666f 720a 6561 7379 2069 6e63 6c75 7369 for.easy inclusi │ │ │ │ │ +00005530: 6f6e 2069 6e20 6f74 6865 7220 7072 6f6a on in other proj │ │ │ │ │ +00005540: 6563 7473 2e20 2049 7420 6973 2067 656e ects. It is gen │ │ │ │ │ +00005550: 6572 6174 6564 2061 7574 6f6d 6174 6963 erated automatic │ │ │ │ │ +00005560: 616c 6c79 2066 726f 6d0a 7468 6520 4c5a ally from.the LZ │ │ │ │ │ +00005570: 4f20 736f 7572 6365 2063 6f64 6520 616e O source code an │ │ │ │ │ +00005580: 6420 636f 6e74 6169 6e73 2074 6865 206d d contains the m │ │ │ │ │ +00005590: 6f73 7420 696d 706f 7274 616e 7420 4c5a ost important LZ │ │ │ │ │ +000055a0: 4f20 6675 6e63 7469 6f6e 732e 0a0a 2020 O functions... │ │ │ │ │ +000055b0: 2054 6f20 7570 6772 6164 6520 746f 2061 To upgrade to a │ │ │ │ │ +000055c0: 206e 6577 2076 6572 7369 6f6e 206f 6620 new version of │ │ │ │ │ +000055d0: 7468 6520 6d69 6e69 4c5a 4f20 6c69 6272 the miniLZO libr │ │ │ │ │ +000055e0: 6172 792c 2064 6f77 6e6c 6f61 6420 7468 ary, download th │ │ │ │ │ +000055f0: 650a 7265 6c65 6173 6520 7461 7262 616c e.release tarbal │ │ │ │ │ +00005600: 6c20 616e 6420 636f 7079 2074 6865 2066 l and copy the f │ │ │ │ │ +00005610: 696c 6573 2069 6e74 6f20 7468 6520 7461 iles into the ta │ │ │ │ │ +00005620: 7267 6574 2064 6972 6563 746f 7279 3a0a rget directory:. │ │ │ │ │ +00005630: 0a20 2020 2020 6375 726c 202d 4c20 2d4f . curl -L -O │ │ │ │ │ +00005640: 2068 7474 703a 2f2f 7777 772e 6f62 6572 http://www.ober │ │ │ │ │ +00005650: 6875 6d65 722e 636f 6d2f 6f70 656e 736f humer.com/openso │ │ │ │ │ +00005660: 7572 6365 2f6c 7a6f 2f64 6f77 6e6c 6f61 urce/lzo/downloa │ │ │ │ │ +00005670: 642f 6d69 6e69 6c7a 6f2d 322e 3130 2e74 d/minilzo-2.10.t │ │ │ │ │ +00005680: 6172 2e67 7a0a 2020 2020 2074 6172 202d ar.gz. tar - │ │ │ │ │ +00005690: 7a78 6620 6d69 6e69 6c7a 6f2d 322e 3130 zxf minilzo-2.10 │ │ │ │ │ +000056a0: 2e74 6172 2e67 7a0a 2020 2020 2072 6d20 .tar.gz. rm │ │ │ │ │ +000056b0: 6d69 6e69 6c7a 6f2d 322e 3130 2f74 6573 minilzo-2.10/tes │ │ │ │ │ +000056c0: 746d 696e 692e 630a 2020 2020 2072 6d20 tmini.c. rm │ │ │ │ │ +000056d0: 2d72 2067 7275 622d 636f 7265 2f6c 6962 -r grub-core/lib │ │ │ │ │ +000056e0: 2f6d 696e 696c 7a6f 2f2a 0a20 2020 2020 /minilzo/*. │ │ │ │ │ +000056f0: 6370 206d 696e 696c 7a6f 2d32 2e31 302f cp minilzo-2.10/ │ │ │ │ │ +00005700: 2a2e 5b68 635d 2067 7275 622d 636f 7265 *.[hc] grub-core │ │ │ │ │ +00005710: 2f6c 6962 2f6d 696e 696c 7a6f 0a20 2020 /lib/minilzo. │ │ │ │ │ +00005720: 2020 726d 202d 7220 6d69 6e69 6c7a 6f2d rm -r minilzo- │ │ │ │ │ +00005730: 322e 3130 2a0a 0a1f 0a46 696c 653a 2067 2.10*....File: g │ │ │ │ │ +00005740: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ │ +00005750: 6f64 653a 2050 6f72 7469 6e67 2c20 204e ode: Porting, N │ │ │ │ │ +00005760: 6578 743a 2045 7272 6f72 2048 616e 646c ext: Error Handl │ │ │ │ │ +00005770: 696e 672c 2020 5072 6576 3a20 5570 6461 ing, Prev: Upda │ │ │ │ │ +00005780: 7469 6e67 2045 7874 6572 6e61 6c20 436f ting External Co │ │ │ │ │ +00005790: 6465 2c20 2055 703a 2054 6f70 0a0a 3620 de, Up: Top..6 │ │ │ │ │ +000057a0: 506f 7274 696e 670a 2a2a 2a2a 2a2a 2a2a Porting.******** │ │ │ │ │ +000057b0: 2a0a 0a47 5255 4232 2069 7320 6465 7369 *..GRUB2 is desi │ │ │ │ │ +000057c0: 676e 6564 2074 6f20 6265 2065 6173 696c gned to be easil │ │ │ │ │ +000057d0: 7920 706f 7274 6162 6c65 2061 6363 726f y portable accro │ │ │ │ │ +000057e0: 7373 2070 6c61 7466 6f72 6d73 2e20 2042 ss platforms. B │ │ │ │ │ +000057f0: 7574 2062 6563 6175 7365 0a6f 6620 7468 ut because.of th │ │ │ │ │ +00005800: 6520 6e61 7475 7265 206f 6620 626f 6f74 e nature of boot │ │ │ │ │ +00005810: 6c6f 6164 6572 2065 7665 7279 206e 6577 loader every new │ │ │ │ │ +00005820: 2070 6f72 7420 6d75 7374 2062 6520 646f port must be do │ │ │ │ │ +00005830: 6e65 2073 6570 6172 6174 656c 792e 0a48 ne separately..H │ │ │ │ │ +00005840: 6572 6520 6973 2068 6f77 2049 2064 6964 ere is how I did │ │ │ │ │ +00005850: 204d 4950 5320 286c 6f6f 6e67 736f 6e20 MIPS (loongson │ │ │ │ │ +00005860: 616e 6420 4152 4329 2061 6e64 2058 656e and ARC) and Xen │ │ │ │ │ +00005870: 2070 6f72 7473 2e20 204e 6f74 6520 7468 ports. Note th │ │ │ │ │ +00005880: 616e 2074 6869 730a 6973 206d 6f72 6520 an this.is more │ │ │ │ │ +00005890: 6f66 2073 7567 6765 7374 696f 6e73 2c20 of suggestions, │ │ │ │ │ +000058a0: 6e6f 7420 6162 736f 6c75 7465 2074 7275 not absolute tru │ │ │ │ │ +000058b0: 7468 2e0a 0a20 2020 4669 7273 7420 6f66 th... First of │ │ │ │ │ +000058c0: 2061 6c6c 2067 7261 6220 616e 7920 6172 all grab any ar │ │ │ │ │ +000058d0: 6368 6974 6563 7475 7265 2073 7065 6369 chitecture speci │ │ │ │ │ +000058e0: 6669 6361 7469 6f6e 7320 796f 7520 6361 fications you ca │ │ │ │ │ +000058f0: 6e20 6669 6e64 2069 6e0a 7075 626c 6963 n find in.public │ │ │ │ │ +00005900: 2028 706c 6561 7365 2061 766f 6964 204e (please avoid N │ │ │ │ │ +00005910: 4441 292e 0a0a 2020 2046 6972 7374 2073 DA)... First s │ │ │ │ │ +00005920: 7461 6765 2069 7320 2248 656c 6c6f 2077 tage is "Hello w │ │ │ │ │ +00005930: 6f72 6c64 222e 2020 4927 7665 2064 6f6e orld". I've don │ │ │ │ │ +00005940: 6520 6974 206f 7574 7369 6465 206f 6620 e it outside of │ │ │ │ │ +00005950: 4752 5542 2066 6f72 0a73 696d 706c 6963 GRUB for.simplic │ │ │ │ │ +00005960: 6974 792e 2020 596f 7572 2074 6173 6b20 ity. Your task │ │ │ │ │ +00005970: 6973 2074 6f20 6861 7665 2061 2073 6d61 is to have a sma │ │ │ │ │ +00005980: 6c6c 2070 726f 6772 616d 2077 6869 6368 ll program which │ │ │ │ │ +00005990: 2069 7320 6c6f 6164 6162 6c65 2061 730a is loadable as. │ │ │ │ │ +000059a0: 626f 6f74 6c6f 6164 6572 2061 6e64 2063 bootloader and c │ │ │ │ │ +000059b0: 6c65 6172 6c79 2073 686f 7773 2069 7473 learly shows its │ │ │ │ │ +000059c0: 2070 7265 7365 6e63 6520 746f 2079 6f75 presence to you │ │ │ │ │ +000059d0: 2e20 2049 6620 796f 7520 6861 7665 2065 . If you have e │ │ │ │ │ +000059e0: 6173 696c 790a 6163 6365 7373 6962 6c65 asily.accessible │ │ │ │ │ +000059f0: 2063 6f6e 736f 6c65 2079 6f75 2063 616e console you can │ │ │ │ │ +00005a00: 206a 7573 7420 7072 696e 7420 6120 6d65 just print a me │ │ │ │ │ +00005a10: 7373 6167 652e 2020 4966 2079 6f75 2068 ssage. If you h │ │ │ │ │ +00005a20: 6176 6520 6120 6d61 7070 6564 0a66 7261 ave a mapped.fra │ │ │ │ │ +00005a30: 6d65 6275 6666 6572 2079 6f75 206b 6e6f mebuffer you kno │ │ │ │ │ +00005a40: 7720 6164 6472 6573 7320 6f66 2c20 796f w address of, yo │ │ │ │ │ +00005a50: 7520 6361 6e20 6472 6177 2061 2073 7175 u can draw a squ │ │ │ │ │ +00005a60: 6172 652e 2020 4966 2079 6f75 2068 6176 are. If you hav │ │ │ │ │ +00005a70: 6520 610a 6465 6275 6720 6661 6369 6c69 e a.debug facili │ │ │ │ │ +00005a80: 7479 2c20 6a75 7374 2068 616e 6769 6e67 ty, just hanging │ │ │ │ │ +00005a90: 2077 6974 686f 7574 2063 7261 7368 696e without crashin │ │ │ │ │ +00005aa0: 6720 6d69 6768 7420 6265 2065 6e6f 7567 g might be enoug │ │ │ │ │ +00005ab0: 682e 2020 466f 7220 7468 650a 6669 7273 h. For the.firs │ │ │ │ │ +00005ac0: 7420 7374 6167 6520 796f 7520 6361 6e20 t stage you can │ │ │ │ │ +00005ad0: 6368 6f6f 7365 2074 6f20 6c6f 6164 2074 choose to load t │ │ │ │ │ +00005ae0: 6865 2062 6f6f 746c 6f61 6465 7220 6163 he bootloader ac │ │ │ │ │ +00005af0: 726f 7373 2074 6865 206e 6574 776f 726b ross the network │ │ │ │ │ +00005b00: 0a73 696e 6365 2066 6f72 6d61 7420 666f .since format fo │ │ │ │ │ +00005b10: 7220 6e65 7477 6f72 6b20 696d 6167 6520 r network image │ │ │ │ │ +00005b20: 6973 206f 6674 656e 2065 6173 6965 7220 is often easier │ │ │ │ │ +00005b30: 7468 616e 2066 6f72 206c 6f63 616c 2062 than for local b │ │ │ │ │ +00005b40: 6f6f 7420 616e 640a 6974 2073 6b69 7073 oot and.it skips │ │ │ │ │ +00005b50: 2074 6865 206e 6565 6420 6f66 2073 6d61 the need of sma │ │ │ │ │ +00005b60: 6c6c 2069 6e74 6572 6d65 6469 6172 7920 ll intermediary │ │ │ │ │ +00005b70: 7374 6167 6573 2061 6e64 206e 7672 616d stages and nvram │ │ │ │ │ +00005b80: 2068 616e 646c 696e 672e 0a41 6464 6974 handling..Addit │ │ │ │ │ +00005b90: 696f 6e61 6c6c 7920 796f 7520 6361 6e20 ionally you can │ │ │ │ │ +00005ba0: 6f66 7465 6e20 6861 7665 2061 2067 6f6f often have a goo │ │ │ │ │ +00005bb0: 6420 6964 6561 206f 6620 7468 6520 6e65 d idea of the ne │ │ │ │ │ +00005bc0: 6564 6564 2066 6f72 6d61 7420 6279 0a72 eded format by.r │ │ │ │ │ +00005bd0: 756e 6e69 6e67 2022 6669 6c65 2220 6f6e unning "file" on │ │ │ │ │ +00005be0: 2061 6e79 206e 6574 626f 6f74 6162 6c65 any netbootable │ │ │ │ │ +00005bf0: 2065 7865 6375 7461 626c 6520 666f 7220 executable for │ │ │ │ │ +00005c00: 6769 7665 6e20 706c 6174 666f 726d 2e0a given platform.. │ │ │ │ │ +00005c10: 0a20 2020 5468 6973 2070 726f 6772 616d . This program │ │ │ │ │ +00005c20: 2073 686f 756c 6420 7072 6f62 6162 6c79 should probably │ │ │ │ │ +00005c30: 2068 6176 6520 3220 7061 7274 733a 2061 have 2 parts: a │ │ │ │ │ +00005c40: 6e20 6173 7365 6d62 6c65 7220 616e 6420 n assembler and │ │ │ │ │ +00005c50: 4320 6f6e 652e 0a41 7373 656d 626c 6572 C one..Assembler │ │ │ │ │ +00005c60: 206f 6e65 2068 616e 646c 6573 2042 5353 one handles BSS │ │ │ │ │ +00005c70: 2063 6c65 616e 696e 6720 616e 6420 6f74 cleaning and ot │ │ │ │ │ +00005c80: 6865 7220 6e65 6564 6564 2073 6574 7570 her needed setup │ │ │ │ │ +00005c90: 2028 6f6e 2073 6f6d 650a 706c 6174 666f (on some.platfo │ │ │ │ │ +00005ca0: 726d 7320 796f 7520 6d61 7920 6e65 6564 rms you may need │ │ │ │ │ +00005cb0: 2074 6f20 7377 6974 6368 206d 6f64 6573 to switch modes │ │ │ │ │ +00005cc0: 206f 7220 636f 7079 2074 6865 2065 7865 or copy the exe │ │ │ │ │ +00005cd0: 6375 7461 626c 6520 746f 2069 7473 0a64 cutable to its.d │ │ │ │ │ +00005ce0: 6566 696e 6974 6976 6520 706f 7369 7469 efinitive positi │ │ │ │ │ +00005cf0: 6f6e 292e 2020 536f 2079 6f75 7220 636f on). So your co │ │ │ │ │ +00005d00: 6465 206d 6179 206c 6f6f 6b20 6c69 6b65 de may look like │ │ │ │ │ +00005d10: 2028 7838 3620 6173 7365 6d62 6c79 2066 (x86 assembly f │ │ │ │ │ +00005d20: 6f72 0a69 6c6c 7573 7472 6174 696f 6e20 or.illustration │ │ │ │ │ +00005d30: 7075 7270 6f73 6573 290a 0a20 2020 2020 purposes).. │ │ │ │ │ +00005d40: 2020 2020 2020 2020 2e67 6c6f 626c 205f .globl _ │ │ │ │ │ +00005d50: 7374 6172 740a 2020 2020 205f 7374 6172 start. _star │ │ │ │ │ +00005d60: 743a 0a20 2020 2020 096d 6f76 6c09 245f t:. .movl.$_ │ │ │ │ │ +00005d70: 6273 735f 7374 6172 742c 2025 6564 690a bss_start, %edi. │ │ │ │ │ +00005d80: 2020 2020 2009 6d6f 766c 0924 5f65 6e64 .movl.$_end │ │ │ │ │ +00005d90: 2c20 2565 6378 0a20 2020 2020 0973 7562 , %ecx. .sub │ │ │ │ │ +00005da0: 6c09 2565 6469 2c20 2565 6378 0a20 2020 l.%edi, %ecx. │ │ │ │ │ +00005db0: 2020 0978 6f72 6c09 2565 6178 2c20 2565 .xorl.%eax, %e │ │ │ │ │ +00005dc0: 6178 0a20 2020 2020 0963 6c64 0a20 2020 ax. .cld. │ │ │ │ │ +00005dd0: 2020 0972 6570 0a20 2020 2020 0973 746f .rep. .sto │ │ │ │ │ +00005de0: 7362 0a20 2020 2020 2020 2020 2020 2020 sb. │ │ │ │ │ +00005df0: 6361 6c6c 206d 6169 6e0a 0a0a 2020 2020 call main... │ │ │ │ │ +00005e00: 2073 7461 7469 6320 636f 6e73 7420 6368 static const ch │ │ │ │ │ +00005e10: 6172 206d 7367 5b5d 203d 2022 4865 6c6c ar msg[] = "Hell │ │ │ │ │ +00005e20: 6f2c 2077 6f72 6c64 223b 0a0a 2020 2020 o, world";.. │ │ │ │ │ +00005e30: 2076 6f69 640a 2020 2020 2070 7574 6368 void. putch │ │ │ │ │ +00005e40: 6172 2028 696e 7420 6329 0a20 2020 2020 ar (int c). │ │ │ │ │ +00005e50: 7b0a 2020 2020 2020 202e 2e2e 0a20 2020 {. .... │ │ │ │ │ +00005e60: 2020 7d0a 0a20 2020 2020 766f 6964 0a20 }.. void. │ │ │ │ │ +00005e70: 2020 2020 6d61 696e 2028 766f 6964 290a main (void). │ │ │ │ │ +00005e80: 2020 2020 207b 0a20 2020 2020 2020 636f {. co │ │ │ │ │ +00005e90: 6e73 7420 6368 6172 202a 7074 7220 3d20 nst char *ptr = │ │ │ │ │ +00005ea0: 6d73 673b 0a20 2020 2020 2020 7768 696c msg;. whil │ │ │ │ │ +00005eb0: 6520 282a 7074 7229 0a20 2020 2020 2020 e (*ptr). │ │ │ │ │ +00005ec0: 2020 7075 7463 6861 7220 282a 7074 722b putchar (*ptr+ │ │ │ │ │ +00005ed0: 2b29 3b0a 2020 2020 2020 2077 6869 6c65 +);. while │ │ │ │ │ +00005ee0: 2028 3129 3b0a 2020 2020 207d 0a0a 2020 (1);. }.. │ │ │ │ │ +00005ef0: 2053 6f6d 6574 696d 6573 2079 6f75 206e Sometimes you n │ │ │ │ │ +00005f00: 6565 6420 6120 7468 6972 6420 6669 6c65 eed a third file │ │ │ │ │ +00005f10: 3a20 6173 7365 6d62 6c79 2073 7475 6273 : assembly stubs │ │ │ │ │ +00005f20: 2066 6f72 0a41 4249 2d63 6f6d 7061 7469 for.ABI-compati │ │ │ │ │ +00005f30: 6269 6c69 7479 2e0a 0a20 2020 4f6e 6365 bility... Once │ │ │ │ │ +00005f40: 2074 6869 7320 6669 6c65 2069 7320 6675 this file is fu │ │ │ │ │ +00005f50: 6e63 7469 6f6e 616c 2069 7427 7320 7469 nctional it's ti │ │ │ │ │ +00005f60: 6d65 2074 6f20 6d6f 7665 2069 7420 696e me to move it in │ │ │ │ │ +00005f70: 746f 2047 5255 4232 2e20 2054 6865 0a73 to GRUB2. The.s │ │ │ │ │ +00005f80: 7461 7274 7570 2061 7373 656d 626c 7920 tartup assembly │ │ │ │ │ +00005f90: 6669 6c65 2067 6f65 7320 746f 2067 7275 file goes to gru │ │ │ │ │ +00005fa0: 622d 636f 7265 2f6b 6572 6e2f 2463 7075 b-core/kern/$cpu │ │ │ │ │ +00005fb0: 2f24 706c 6174 666f 726d 2f73 7461 7274 /$platform/start │ │ │ │ │ +00005fc0: 7570 2e53 2e0a 596f 7520 7368 6f75 6c64 up.S..You should │ │ │ │ │ +00005fd0: 2061 6c73 6f20 696e 636c 7564 6520 6772 also include gr │ │ │ │ │ +00005fe0: 7562 2f73 796d 626f 6c2e 6820 616e 6420 ub/symbol.h and │ │ │ │ │ +00005ff0: 7265 706c 6163 6520 6361 6c6c 2074 6f20 replace call to │ │ │ │ │ +00006000: 656e 7472 7920 706f 696e 740a 7769 7468 entry point.with │ │ │ │ │ +00006010: 2063 616c 6c20 746f 2045 5854 5f43 2867 call to EXT_C(g │ │ │ │ │ +00006020: 7275 625f 6d61 696e 292e 2020 5468 6520 rub_main). The │ │ │ │ │ +00006030: 4320 6669 6c65 2067 6f65 7320 746f 0a67 C file goes to.g │ │ │ │ │ +00006040: 7275 622d 636f 7265 2f6b 6572 6e2f 2463 rub-core/kern/$c │ │ │ │ │ +00006050: 7075 2f24 706c 6174 666f 726d 2f69 6e69 pu/$platform/ini │ │ │ │ │ +00006060: 742e 6320 616e 6420 6974 7320 656e 7472 t.c and its entr │ │ │ │ │ +00006070: 7920 706f 696e 7420 6973 2072 656e 616d y point is renam │ │ │ │ │ +00006080: 6564 2074 6f0a 766f 6964 2067 7275 625f ed to.void grub_ │ │ │ │ │ +00006090: 6d61 6368 696e 655f 696e 6974 2028 766f machine_init (vo │ │ │ │ │ +000060a0: 6964 292e 2020 4b65 6570 2066 696e 616c id). Keep final │ │ │ │ │ +000060b0: 2069 6e66 696e 6974 6520 6c6f 6f70 2066 infinite loop f │ │ │ │ │ +000060c0: 6f72 206e 6f77 2e20 2053 7475 6273 0a66 or now. Stubs.f │ │ │ │ │ +000060d0: 696c 6520 6966 2061 6e79 2067 6f65 7320 ile if any goes │ │ │ │ │ +000060e0: 746f 2067 7275 622d 636f 7265 2f6b 6572 to grub-core/ker │ │ │ │ │ +000060f0: 6e2f 2463 7075 2f24 706c 6174 666f 726d n/$cpu/$platform │ │ │ │ │ +00006100: 2f63 616c 6c77 7261 702e 532e 2053 6f6d /callwrap.S. Som │ │ │ │ │ +00006110: 6574 696d 6573 0a65 6974 6865 7220 2463 etimes.either $c │ │ │ │ │ +00006120: 7075 206f 7220 2470 6c61 7466 6f72 6d20 pu or $platform │ │ │ │ │ +00006130: 6973 2064 726f 7070 6564 2069 6620 6669 is dropped if fi │ │ │ │ │ +00006140: 6c65 2069 7320 7573 6564 206f 6e20 7365 le is used on se │ │ │ │ │ +00006150: 7665 7261 6c20 6370 7573 0a72 6573 7065 veral cpus.respe │ │ │ │ │ +00006160: 6374 6976 656c 7970 6c61 7466 6f72 6d73 ctivelyplatforms │ │ │ │ │ +00006170: 2e20 2043 6865 636b 2074 686f 7365 206c . Check those l │ │ │ │ │ +00006180: 6f63 6174 696f 6e73 2069 6620 7468 6579 ocations if they │ │ │ │ │ +00006190: 2061 6c72 6561 6479 2068 6176 6520 7768 already have wh │ │ │ │ │ +000061a0: 6174 0a79 6f75 2772 6520 6c6f 6f6b 696e at.you're lookin │ │ │ │ │ +000061b0: 6720 666f 722e 0a0a 2020 2054 6865 6e20 g for... Then │ │ │ │ │ +000061c0: 6d6f 6469 6679 2069 6e20 636f 6e66 6967 modify in config │ │ │ │ │ +000061d0: 7572 652e 6163 2074 6865 2066 6f6c 6c6f ure.ac the follo │ │ │ │ │ +000061e0: 7769 6e67 2070 6172 7473 3a0a 0a20 2020 wing parts:.. │ │ │ │ │ +000061f0: 4350 5520 6e61 6d65 733a 0a0a 2020 2020 CPU names:.. │ │ │ │ │ +00006200: 2063 6173 6520 2224 7461 7267 6574 5f63 case "$target_c │ │ │ │ │ +00006210: 7075 2220 696e 0a20 2020 2020 2020 695b pu" in. i[ │ │ │ │ │ +00006220: 5b33 3435 365d 5d38 3629 0974 6172 6765 [3456]]86).targe │ │ │ │ │ +00006230: 745f 6370 753d 6933 3836 203b 3b0a 2020 t_cpu=i386 ;;. │ │ │ │ │ +00006240: 2020 2020 2061 6d64 3634 2909 7461 7267 amd64).targ │ │ │ │ │ +00006250: 6574 5f63 7075 3d78 3836 5f36 3420 3b3b et_cpu=x86_64 ;; │ │ │ │ │ +00006260: 0a20 2020 2020 2020 7370 6172 6329 0974 . sparc).t │ │ │ │ │ +00006270: 6172 6765 745f 6370 753d 7370 6172 6336 arget_cpu=sparc6 │ │ │ │ │ +00006280: 3420 3b3b 0a20 2020 2020 2020 7333 3930 4 ;;. s390 │ │ │ │ │ +00006290: 7829 0974 6172 6765 745f 6370 753d 7333 x).target_cpu=s3 │ │ │ │ │ +000062a0: 3930 203b 3b0a 2020 2020 2020 202e 2e2e 90 ;;. ... │ │ │ │ │ +000062b0: 0a20 2020 2020 6573 6163 0a0a 2020 2053 . esac.. S │ │ │ │ │ +000062c0: 6f6d 6574 696d 6573 2043 5055 2068 6176 ometimes CPU hav │ │ │ │ │ +000062d0: 6520 6164 6469 7469 6f6e 616c 2061 7263 e additional arc │ │ │ │ │ +000062e0: 6869 7465 6374 7572 6520 6e61 6d65 7320 hitecture names │ │ │ │ │ +000062f0: 7768 6963 6820 646f 6e27 740a 696e 666c which don't.infl │ │ │ │ │ +00006300: 7565 6e63 6520 626f 6f74 696e 672e 2020 uence booting. │ │ │ │ │ +00006310: 596f 7520 6d69 6768 7420 7761 6e74 2074 You might want t │ │ │ │ │ +00006320: 6f20 6861 7665 2073 6f6d 6520 6361 6e6f o have some cano │ │ │ │ │ +00006330: 6e69 6361 6c20 6e61 6d65 2074 6f20 6176 nical name to av │ │ │ │ │ +00006340: 6f69 640a 6861 7669 6e67 2062 756e 6368 oid.having bunch │ │ │ │ │ +00006350: 206f 6620 6964 656e 7469 6361 6c20 706c of identical pl │ │ │ │ │ +00006360: 6174 666f 726d 7320 7769 7468 2064 6966 atforms with dif │ │ │ │ │ +00006370: 6665 7265 6e74 206e 616d 6573 2e0a 0a20 ferent names... │ │ │ │ │ +00006380: 2020 4e4f 5445 3a20 6974 2064 6f65 736e NOTE: it doesn │ │ │ │ │ +00006390: 2774 2069 6e66 6c75 656e 6365 2063 6f6d 't influence com │ │ │ │ │ +000063a0: 7069 6c65 206f 7074 696d 6973 6174 696f pile optimisatio │ │ │ │ │ +000063b0: 6e73 2077 6869 6368 2064 6570 656e 6420 ns which depend │ │ │ │ │ +000063c0: 736f 6c65 6c79 0a6f 6e20 6368 6f73 656e solely.on chosen │ │ │ │ │ +000063d0: 2063 6f6d 7069 6c65 7220 616e 6420 636f compiler and co │ │ │ │ │ +000063e0: 6d70 696c 6520 6f70 7469 6f6e 732e 0a0a mpile options... │ │ │ │ │ +000063f0: 2020 2020 2069 6620 7465 7374 2022 7824 if test "x$ │ │ │ │ │ +00006400: 7769 7468 5f70 6c61 7466 6f72 6d22 203d with_platform" = │ │ │ │ │ +00006410: 2078 3b20 7468 656e 0a20 2020 2020 2020 x; then. │ │ │ │ │ +00006420: 6361 7365 2022 2474 6172 6765 745f 6370 case "$target_cp │ │ │ │ │ +00006430: 7522 2d22 2474 6172 6765 745f 7665 6e64 u"-"$target_vend │ │ │ │ │ +00006440: 6f72 2220 696e 0a20 2020 2020 2020 2020 or" in. │ │ │ │ │ +00006450: 6933 3836 2d61 7070 6c65 2920 706c 6174 i386-apple) plat │ │ │ │ │ +00006460: 666f 726d 3d65 6669 203b 3b0a 2020 2020 form=efi ;;. │ │ │ │ │ +00006470: 2020 2020 2069 3338 362d 2a29 2070 6c61 i386-*) pla │ │ │ │ │ +00006480: 7466 6f72 6d3d 7063 203b 3b0a 2020 2020 tform=pc ;;. │ │ │ │ │ +00006490: 2020 2020 2078 3836 5f36 342d 6170 706c x86_64-appl │ │ │ │ │ +000064a0: 6529 2070 6c61 7466 6f72 6d3d 6566 6920 e) platform=efi │ │ │ │ │ +000064b0: 3b3b 0a20 2020 2020 2020 2020 7838 365f ;;. x86_ │ │ │ │ │ +000064c0: 3634 2d2a 2920 706c 6174 666f 726d 3d70 64-*) platform=p │ │ │ │ │ +000064d0: 6320 3b3b 0a20 2020 2020 2020 2020 706f c ;;. po │ │ │ │ │ +000064e0: 7765 7270 632d 2a29 2070 6c61 7466 6f72 werpc-*) platfor │ │ │ │ │ +000064f0: 6d3d 6965 6565 3132 3735 203b 3b0a 2020 m=ieee1275 ;;. │ │ │ │ │ +00006500: 2020 2020 2020 202e 2e2e 0a20 2020 2020 .... │ │ │ │ │ +00006510: 2020 6573 6163 0a20 2020 2020 656c 7365 esac. else │ │ │ │ │ +00006520: 0a20 2020 2020 2020 2e2e 2e0a 2020 2020 . .... │ │ │ │ │ +00006530: 2066 690a 0a20 2020 5468 6973 2070 6172 fi.. This par │ │ │ │ │ +00006540: 7420 6465 616c 7320 7769 7468 2067 7565 t deals with gue │ │ │ │ │ +00006550: 7373 696e 6720 7468 6520 706c 6174 666f ssing the platfo │ │ │ │ │ +00006560: 726d 2066 726f 6d20 4350 5520 616e 6420 rm from CPU and │ │ │ │ │ +00006570: 7665 6e64 6f72 2e0a 536f 6d65 7469 6d65 vendor..Sometime │ │ │ │ │ +00006580: 7320 796f 7520 6e65 6564 2074 6f20 7573 s you need to us │ │ │ │ │ +00006590: 6520 3332 2d62 6974 206d 6f64 6520 666f e 32-bit mode fo │ │ │ │ │ +000065a0: 7220 626f 6f74 696e 6720 6576 656e 2069 r booting even i │ │ │ │ │ +000065b0: 6620 4f53 2072 756e 7320 696e 0a36 342d f OS runs in.64- │ │ │ │ │ +000065c0: 6269 7420 6f6e 652e 2020 4966 2073 6f20 bit one. If so │ │ │ │ │ +000065d0: 6164 6420 796f 7572 2070 6c61 7466 6f72 add your platfor │ │ │ │ │ +000065e0: 6d20 746f 3a0a 0a20 2020 2020 6361 7365 m to:.. case │ │ │ │ │ +000065f0: 2022 2474 6172 6765 745f 6370 7522 2d22 "$target_cpu"-" │ │ │ │ │ +00006600: 2470 6c61 7466 6f72 6d22 2069 6e0a 2020 $platform" in. │ │ │ │ │ +00006610: 2020 2020 2078 3836 5f36 342d 6566 6929 x86_64-efi) │ │ │ │ │ +00006620: 203b 3b0a 2020 2020 2020 2078 3836 5f36 ;;. x86_6 │ │ │ │ │ +00006630: 342d 656d 7529 203b 3b0a 2020 2020 2020 4-emu) ;;. │ │ │ │ │ +00006640: 2078 3836 5f36 342d 2a29 2074 6172 6765 x86_64-*) targe │ │ │ │ │ +00006650: 745f 6370 753d 6933 3836 203b 3b0a 2020 t_cpu=i386 ;;. │ │ │ │ │ +00006660: 2020 2020 2070 6f77 6572 7063 3634 2d69 powerpc64-i │ │ │ │ │ +00006670: 6565 6531 3237 3529 2074 6172 6765 745f eee1275) target_ │ │ │ │ │ +00006680: 6370 753d 706f 7765 7270 6320 3b3b 0a20 cpu=powerpc ;;. │ │ │ │ │ +00006690: 2020 2020 6573 6163 0a0a 2020 2041 6464 esac.. Add │ │ │ │ │ +000066a0: 2079 6f75 7220 706c 6174 666f 726d 2074 your platform t │ │ │ │ │ +000066b0: 6f20 7468 6520 6c69 7374 206f 6620 7375 o the list of su │ │ │ │ │ +000066c0: 7070 6f72 7465 6420 6f6e 6573 3a0a 0a20 pported ones:.. │ │ │ │ │ +000066d0: 2020 2020 6361 7365 2022 2474 6172 6765 case "$targe │ │ │ │ │ +000066e0: 745f 6370 7522 2d22 2470 6c61 7466 6f72 t_cpu"-"$platfor │ │ │ │ │ +000066f0: 6d22 2069 6e0a 2020 2020 2020 2069 3338 m" in. i38 │ │ │ │ │ +00006700: 362d 6566 6929 203b 3b0a 2020 2020 2020 6-efi) ;;. │ │ │ │ │ +00006710: 2078 3836 5f36 342d 6566 6929 203b 3b0a x86_64-efi) ;;. │ │ │ │ │ +00006720: 2020 2020 2020 2069 3338 362d 7063 2920 i386-pc) │ │ │ │ │ +00006730: 3b3b 0a20 2020 2020 2020 6933 3836 2d6d ;;. i386-m │ │ │ │ │ +00006740: 756c 7469 626f 6f74 2920 3b3b 0a20 2020 ultiboot) ;;. │ │ │ │ │ +00006750: 2020 2020 6933 3836 2d63 6f72 6562 6f6f i386-coreboo │ │ │ │ │ +00006760: 7429 203b 3b0a 2020 2020 2020 202e 2e2e t) ;;. ... │ │ │ │ │ +00006770: 0a20 2020 2020 6573 6163 0a0a 2020 2049 . esac.. I │ │ │ │ │ +00006780: 6620 6578 706c 6963 6974 202d 6d33 3220 f explicit -m32 │ │ │ │ │ +00006790: 6f72 202d 6d36 3420 6973 206e 6565 6465 or -m64 is neede │ │ │ │ │ +000067a0: 6420 6164 6420 6974 2074 6f3a 0a0a 2020 d add it to:.. │ │ │ │ │ +000067b0: 2020 2063 6173 6520 2224 7461 7267 6574 case "$target │ │ │ │ │ +000067c0: 5f63 7075 2220 696e 0a20 2020 2020 2020 _cpu" in. │ │ │ │ │ +000067d0: 6933 3836 207c 2070 6f77 6572 7063 2920 i386 | powerpc) │ │ │ │ │ +000067e0: 7461 7267 6574 5f6d 3332 3d31 203b 3b0a target_m32=1 ;;. │ │ │ │ │ +000067f0: 2020 2020 2020 2078 3836 5f36 3420 7c20 x86_64 | │ │ │ │ │ +00006800: 7370 6172 6336 3429 2074 6172 6765 745f sparc64) target_ │ │ │ │ │ +00006810: 6d36 343d 3120 3b3b 0a20 2020 2020 6573 m64=1 ;;. es │ │ │ │ │ +00006820: 6163 0a0a 2020 2046 696e 616c 6c79 2079 ac.. Finally y │ │ │ │ │ +00006830: 6f75 206e 6565 6420 746f 2061 6464 2061 ou need to add a │ │ │ │ │ +00006840: 2063 6f6e 6469 7469 6f6e 616c 2074 6f20 conditional to │ │ │ │ │ +00006850: 7468 6520 666f 6c6c 6f77 696e 6720 626c the following bl │ │ │ │ │ +00006860: 6f63 6b3a 0a0a 2020 2020 2041 4d5f 434f ock:.. AM_CO │ │ │ │ │ +00006870: 4e44 4954 494f 4e41 4c28 5b43 4f4e 445f NDITIONAL([COND_ │ │ │ │ │ +00006880: 6d69 7073 5f61 7263 5d2c 205b 7465 7374 mips_arc], [test │ │ │ │ │ +00006890: 2078 2474 6172 6765 745f 6370 7520 3d20 x$target_cpu = │ │ │ │ │ +000068a0: 786d 6970 7320 2d61 2078 2470 6c61 7466 xmips -a x$platf │ │ │ │ │ +000068b0: 6f72 6d20 3d20 7861 7263 5d29 0a20 2020 orm = xarc]). │ │ │ │ │ +000068c0: 2020 414d 5f43 4f4e 4449 5449 4f4e 414c AM_CONDITIONAL │ │ │ │ │ +000068d0: 285b 434f 4e44 5f73 7061 7263 3634 5f69 ([COND_sparc64_i │ │ │ │ │ +000068e0: 6565 6531 3237 355d 2c20 5b74 6573 7420 eee1275], [test │ │ │ │ │ +000068f0: 7824 7461 7267 6574 5f63 7075 203d 2078 x$target_cpu = x │ │ │ │ │ +00006900: 7370 6172 6336 3420 2d61 2078 2470 6c61 sparc64 -a x$pla │ │ │ │ │ +00006910: 7466 6f72 6d20 3d20 7869 6565 6531 3237 tform = xieee127 │ │ │ │ │ +00006920: 355d 290a 2020 2020 2041 4d5f 434f 4e44 5]). AM_COND │ │ │ │ │ +00006930: 4954 494f 4e41 4c28 5b43 4f4e 445f 706f ITIONAL([COND_po │ │ │ │ │ +00006940: 7765 7270 635f 6965 6565 3132 3735 5d2c werpc_ieee1275], │ │ │ │ │ +00006950: 205b 7465 7374 2078 2474 6172 6765 745f [test x$target_ │ │ │ │ │ +00006960: 6370 7520 3d20 7870 6f77 6572 7063 202d cpu = xpowerpc - │ │ │ │ │ +00006970: 6120 7824 706c 6174 666f 726d 203d 2078 a x$platform = x │ │ │ │ │ +00006980: 6965 6565 3132 3735 5d29 0a0a 2020 204e ieee1275]).. N │ │ │ │ │ +00006990: 6578 7420 7374 6f70 2069 7320 6765 6e74 ext stop is gent │ │ │ │ │ +000069a0: 706c 2e70 792e 2020 596f 7520 6e65 6564 pl.py. You need │ │ │ │ │ +000069b0: 2074 6f20 6164 6420 796f 7572 2070 6c61 to add your pla │ │ │ │ │ +000069c0: 7466 6f72 6d20 746f 2074 6865 206c 6973 tform to the lis │ │ │ │ │ +000069d0: 7420 6f66 0a73 7570 706f 7274 6564 206f t of.supported o │ │ │ │ │ +000069e0: 6e65 7320 2873 6f72 7279 2074 6861 7420 nes (sorry that │ │ │ │ │ +000069f0: 7468 6973 206c 6973 7420 6973 2064 7570 this list is dup │ │ │ │ │ +00006a00: 6c69 6361 7465 6429 3a0a 0a20 2020 2020 licated):.. │ │ │ │ │ +00006a10: 4752 5542 5f50 4c41 5446 4f52 4d53 203d GRUB_PLATFORMS = │ │ │ │ │ +00006a20: 205b 2022 656d 7522 2c20 2269 3338 365f [ "emu", "i386_ │ │ │ │ │ +00006a30: 7063 222c 2022 6933 3836 5f65 6669 222c pc", "i386_efi", │ │ │ │ │ +00006a40: 2022 6933 3836 5f71 656d 7522 2c20 2269 "i386_qemu", "i │ │ │ │ │ +00006a50: 3338 365f 636f 7265 626f 6f74 222c 0a20 386_coreboot",. │ │ │ │ │ 00006a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00006a70: 2020 2020 2022 6933 3836 5f6d 756c 7469 "i386_multi │ │ │ │ │ -00006a80: 626f 6f74 222c 2022 6933 3836 5f69 6565 boot", "i386_iee │ │ │ │ │ -00006a90: 6531 3237 3522 2c20 2278 3836 5f36 345f e1275", "x86_64_ │ │ │ │ │ -00006aa0: 6566 6922 2c0a 2020 2020 2020 2020 2020 efi",. │ │ │ │ │ -00006ab0: 2020 2020 2020 2020 2020 2020 2020 226d "m │ │ │ │ │ -00006ac0: 6970 735f 6c6f 6f6e 6773 6f6e 222c 2022 ips_loongson", " │ │ │ │ │ -00006ad0: 7370 6172 6336 345f 6965 6565 3132 3735 sparc64_ieee1275 │ │ │ │ │ -00006ae0: 222c 0a20 2020 2020 2020 2020 2020 2020 ",. │ │ │ │ │ -00006af0: 2020 2020 2020 2020 2020 2022 706f 7765 "powe │ │ │ │ │ -00006b00: 7270 635f 6965 6565 3132 3735 222c 2022 rpc_ieee1275", " │ │ │ │ │ -00006b10: 6d69 7073 5f61 7263 222c 2022 6961 3634 mips_arc", "ia64 │ │ │ │ │ -00006b20: 5f65 6669 222c 0a20 2020 2020 2020 2020 _efi",. │ │ │ │ │ -00006b30: 2020 2020 2020 2020 2020 2020 2020 2022 " │ │ │ │ │ -00006b40: 6d69 7073 5f71 656d 755f 6d69 7073 222c mips_qemu_mips", │ │ │ │ │ -00006b50: 2022 7333 3930 5f6d 6169 6e66 7261 6d65 "s390_mainframe │ │ │ │ │ -00006b60: 2220 5d0a 0a20 2020 596f 7520 6d61 7920 " ].. You may │ │ │ │ │ -00006b70: 616c 736f 2077 616e 7420 616c 7265 6164 also want alread │ │ │ │ │ -00006b80: 7920 746f 2061 6464 206e 6577 2070 6c61 y to add new pla │ │ │ │ │ -00006b90: 7466 6f72 6d20 746f 206f 6e65 206f 7220 tform to one or │ │ │ │ │ -00006ba0: 7365 7665 7261 6c20 6f66 0a61 7661 696c several of.avail │ │ │ │ │ -00006bb0: 6162 6c65 2067 726f 7570 732e 2020 496e able groups. In │ │ │ │ │ -00006bc0: 2070 6172 7469 6375 6c61 7220 7765 2061 particular we a │ │ │ │ │ -00006bd0: 6c77 6179 7320 6861 7665 2061 2067 726f lways have a gro │ │ │ │ │ -00006be0: 7570 2066 6f72 2065 6163 6820 4350 550a up for each CPU. │ │ │ │ │ -00006bf0: 6576 656e 2077 6865 6e20 6f6e 6c79 206f even when only o │ │ │ │ │ -00006c00: 6e65 2070 6c61 7466 6f72 6d20 666f 7220 ne platform for │ │ │ │ │ -00006c10: 6769 7665 6e20 4350 5520 6973 2061 7661 given CPU is ava │ │ │ │ │ -00006c20: 696c 6162 6c65 2e0a 0a20 2020 5468 656e ilable... Then │ │ │ │ │ -00006c30: 2063 6f6d 6573 2067 7275 622d 636f 7265 comes grub-core │ │ │ │ │ -00006c40: 2f4d 616b 6566 696c 652e 636f 7265 2e64 /Makefile.core.d │ │ │ │ │ -00006c50: 6566 2e20 2049 6e20 7468 6520 626c 6f63 ef. In the bloc │ │ │ │ │ -00006c60: 6b20 226b 6572 6e65 6c22 2079 6f75 276c k "kernel" you'l │ │ │ │ │ -00006c70: 6c0a 6e65 6564 2074 6f20 6465 6669 6e65 l.need to define │ │ │ │ │ -00006c80: 206c 6466 6c61 6773 2066 6f72 2079 6f75 ldflags for you │ │ │ │ │ -00006c90: 7220 706c 6174 666f 726d 2028 2463 7075 r platform ($cpu │ │ │ │ │ -00006ca0: 5f24 706c 6174 666f 726d 5f6c 6466 6c61 _$platform_ldfla │ │ │ │ │ -00006cb0: 6773 292e 2020 596f 750a 616c 736f 206e gs). You.also n │ │ │ │ │ -00006cc0: 6565 6420 746f 2064 6563 6c61 7265 2073 eed to declare s │ │ │ │ │ -00006cd0: 7461 7274 7570 2061 736d 2066 696c 6520 tartup asm file │ │ │ │ │ -00006ce0: 2824 6370 755f 2470 6c61 7466 6f72 6d5f ($cpu_$platform_ │ │ │ │ │ -00006cf0: 7374 6172 7475 7029 2061 7320 7765 6c6c startup) as well │ │ │ │ │ -00006d00: 0a61 7320 616e 7920 6f74 6865 7220 6669 .as any other fi │ │ │ │ │ -00006d10: 6c65 7320 2865 2e67 2e20 2069 6e69 742e les (e.g. init. │ │ │ │ │ -00006d20: 6320 616e 6420 6361 6c6c 7772 6170 2e53 c and callwrap.S │ │ │ │ │ -00006d30: 2920 2865 2e67 2e20 2024 6370 755f 2470 ) (e.g. $cpu_$p │ │ │ │ │ -00006d40: 6c61 7466 6f72 6d20 3d0a 6b65 726e 2f24 latform =.kern/$ │ │ │ │ │ -00006d50: 6370 752f 2470 6c61 7466 6f72 6d2f 696e cpu/$platform/in │ │ │ │ │ -00006d60: 6974 2e63 292e 2020 4174 2074 6869 7320 it.c). At this │ │ │ │ │ -00006d70: 7374 6167 6520 796f 7520 7769 6c6c 2061 stage you will a │ │ │ │ │ -00006d80: 6c73 6f20 6e65 6564 2074 6f20 6164 640a lso need to add. │ │ │ │ │ -00006d90: 6475 6d6d 7920 646c 2e63 2061 6e64 2063 dummy dl.c and c │ │ │ │ │ -00006da0: 6163 6865 2e53 2077 6974 6820 6675 6e63 ache.S with func │ │ │ │ │ -00006db0: 7469 6f6e 7320 6772 7562 5f65 7272 5f74 tions grub_err_t │ │ │ │ │ -00006dc0: 0a67 7275 625f 6172 6368 5f64 6c5f 6368 .grub_arch_dl_ch │ │ │ │ │ -00006dd0: 6563 6b5f 6865 6164 6572 2028 766f 6964 eck_header (void │ │ │ │ │ -00006de0: 202a 6568 6472 292c 2067 7275 625f 6572 *ehdr), grub_er │ │ │ │ │ -00006df0: 725f 740a 6772 7562 5f61 7263 685f 646c r_t.grub_arch_dl │ │ │ │ │ -00006e00: 5f72 656c 6f63 6174 655f 7379 6d62 6f6c _relocate_symbol │ │ │ │ │ -00006e10: 7320 2867 7275 625f 646c 5f74 206d 6f64 s (grub_dl_t mod │ │ │ │ │ -00006e20: 2c20 766f 6964 202a 6568 6472 2920 2864 , void *ehdr) (d │ │ │ │ │ -00006e30: 6c2e 6329 2061 6e64 0a76 6f69 6420 6772 l.c) and.void gr │ │ │ │ │ -00006e40: 7562 5f61 7263 685f 7379 6e63 5f63 6163 ub_arch_sync_cac │ │ │ │ │ -00006e50: 6865 7320 2876 6f69 6420 2a61 6464 7265 hes (void *addre │ │ │ │ │ -00006e60: 7373 2c20 6772 7562 5f73 697a 655f 7420 ss, grub_size_t │ │ │ │ │ -00006e70: 6c65 6e29 2028 6361 6368 652e 5329 2e0a len) (cache.S).. │ │ │ │ │ -00006e80: 5468 6579 2077 6f6e 2774 2062 6520 7573 They won't be us │ │ │ │ │ -00006e90: 6564 2066 6f72 206e 6f77 2e0a 0a20 2020 ed for now... │ │ │ │ │ -00006ea0: 596f 7520 7769 6c6c 206e 6565 6420 746f You will need to │ │ │ │ │ -00006eb0: 2063 7265 6174 6520 6469 7265 6374 6f72 create director │ │ │ │ │ -00006ec0: 7920 696e 636c 7564 652f 2463 7075 2f24 y include/$cpu/$ │ │ │ │ │ -00006ed0: 706c 6174 666f 726d 2061 6e64 2061 2066 platform and a f │ │ │ │ │ -00006ee0: 696c 650a 696e 636c 7564 652f 2463 7075 ile.include/$cpu │ │ │ │ │ -00006ef0: 2f74 7970 6573 2e68 2e20 2054 6865 206c /types.h. The l │ │ │ │ │ -00006f00: 6174 6572 2066 6f6c 6f77 696e 6720 7468 ater folowing th │ │ │ │ │ -00006f10: 6973 2074 656d 706c 6174 653a 0a0a 2020 is template:.. │ │ │ │ │ -00006f20: 2020 2023 6966 6e64 6566 2047 5255 425f #ifndef GRUB_ │ │ │ │ │ -00006f30: 5459 5045 535f 4350 555f 4845 4144 4552 TYPES_CPU_HEADER │ │ │ │ │ -00006f40: 0a20 2020 2020 2364 6566 696e 6520 4752 . #define GR │ │ │ │ │ -00006f50: 5542 5f54 5950 4553 5f43 5055 5f48 4541 UB_TYPES_CPU_HEA │ │ │ │ │ -00006f60: 4445 5209 310a 0a20 2020 2020 2f2a 2054 DER.1.. /* T │ │ │ │ │ -00006f70: 6865 2073 697a 6520 6f66 2076 6f69 6420 he size of void │ │ │ │ │ -00006f80: 2a2e 2020 2a2f 0a20 2020 2020 2364 6566 *. */. #def │ │ │ │ │ -00006f90: 696e 6520 4752 5542 5f54 4152 4745 545f ine GRUB_TARGET_ │ │ │ │ │ -00006fa0: 5349 5a45 4f46 5f56 4f49 445f 5009 340a SIZEOF_VOID_P.4. │ │ │ │ │ -00006fb0: 0a20 2020 2020 2f2a 2054 6865 2073 697a . /* The siz │ │ │ │ │ -00006fc0: 6520 6f66 206c 6f6e 672e 2020 2a2f 0a20 e of long. */. │ │ │ │ │ -00006fd0: 2020 2020 2364 6566 696e 6520 4752 5542 #define GRUB │ │ │ │ │ -00006fe0: 5f54 4152 4745 545f 5349 5a45 4f46 5f4c _TARGET_SIZEOF_L │ │ │ │ │ -00006ff0: 4f4e 4709 0934 0a0a 2020 2020 202f 2a20 ONG..4.. /* │ │ │ │ │ -00007000: 6d79 6370 7520 6973 2062 6967 2d65 6e64 mycpu is big-end │ │ │ │ │ -00007010: 6961 6e2e 2020 2a2f 0a20 2020 2020 2364 ian. */. #d │ │ │ │ │ -00007020: 6566 696e 6520 4752 5542 5f54 4152 4745 efine GRUB_TARGE │ │ │ │ │ -00007030: 545f 574f 5244 535f 4249 4745 4e44 4941 T_WORDS_BIGENDIA │ │ │ │ │ -00007040: 4e09 310a 2020 2020 202f 2a20 416c 7465 N.1. /* Alte │ │ │ │ │ -00007050: 726e 6174 6976 656c 793a 206d 7963 7075 rnatively: mycpu │ │ │ │ │ -00007060: 2069 7320 6c69 7474 6c65 2d65 6e64 6961 is little-endia │ │ │ │ │ -00007070: 6e2e 2020 2a2f 0a20 2020 2020 2375 6e64 n. */. #und │ │ │ │ │ -00007080: 6566 2047 5255 425f 5441 5247 4554 5f57 ef GRUB_TARGET_W │ │ │ │ │ -00007090: 4f52 4453 5f42 4947 454e 4449 414e 0a0a ORDS_BIGENDIAN.. │ │ │ │ │ -000070a0: 2020 2020 2023 656e 6469 6620 2f2a 2021 #endif /* ! │ │ │ │ │ -000070b0: 2047 5255 425f 5459 5045 535f 4350 555f GRUB_TYPES_CPU_ │ │ │ │ │ -000070c0: 4845 4144 4552 202a 2f0a 0a20 2020 596f HEADER */.. Yo │ │ │ │ │ -000070d0: 7520 7769 6c6c 2061 6c73 6f20 6e65 6564 u will also need │ │ │ │ │ -000070e0: 2074 6f20 6164 6420 6120 6475 6d6d 7920 to add a dummy │ │ │ │ │ -000070f0: 6669 6c65 2074 6f20 6461 7465 7469 6d65 file to datetime │ │ │ │ │ -00007100: 2061 6e64 2073 6574 6a6d 7020 6d6f 6475 and setjmp modu │ │ │ │ │ -00007110: 6c65 730a 746f 2061 766f 6964 2061 6e79 les.to avoid any │ │ │ │ │ -00007120: 206f 6620 6974 2068 6176 696e 6720 6e6f of it having no │ │ │ │ │ -00007130: 2066 696c 6573 2e20 2049 7420 6361 6e20 files. It can │ │ │ │ │ -00007140: 6265 206a 7573 7420 636f 6d70 6c65 7465 be just complete │ │ │ │ │ -00007150: 6c79 2065 6d70 7479 2061 740a 7468 6973 ly empty at.this │ │ │ │ │ -00007160: 2073 7461 6765 2e0a 0a20 2020 596f 7527 stage... You' │ │ │ │ │ -00007170: 6c6c 206e 6565 6420 746f 206d 616b 6520 ll need to make │ │ │ │ │ -00007180: 6772 7562 2d6d 6b69 6d61 6765 2e63 2028 grub-mkimage.c ( │ │ │ │ │ -00007190: 7574 696c 2f67 7275 625f 6d6b 696d 6167 util/grub_mkimag │ │ │ │ │ -000071a0: 652e 6329 2061 7761 7265 206f 6620 7468 e.c) aware of th │ │ │ │ │ -000071b0: 650a 6e65 6564 6564 2066 6f72 6d61 742e e.needed format. │ │ │ │ │ -000071c0: 2020 466f 7220 6d6f 7374 2063 6f6d 6d6f For most commo │ │ │ │ │ -000071d0: 6e6c 7920 7573 6564 2066 6f72 6d61 7473 nly used formats │ │ │ │ │ -000071e0: 206c 696b 6520 454c 462c 2050 452c 2061 like ELF, PE, a │ │ │ │ │ -000071f0: 6f75 7420 6f72 2072 6177 0a74 6865 2073 out or raw.the s │ │ │ │ │ -00007200: 7570 706f 7274 2069 7320 616c 7265 6164 upport is alread │ │ │ │ │ -00007210: 7920 7072 6573 656e 7420 616e 6420 796f y present and yo │ │ │ │ │ -00007220: 7527 6c6c 206e 6565 6420 746f 206d 616b u'll need to mak │ │ │ │ │ -00007230: 6520 6974 2066 6f6c 6c6f 7720 7468 650a e it follow the. │ │ │ │ │ -00007240: 6578 6973 7461 6e74 2063 6f64 6520 7061 existant code pa │ │ │ │ │ -00007250: 7468 7320 666f 7220 796f 7572 2070 6c61 ths for your pla │ │ │ │ │ -00007260: 7466 6f72 6d20 6164 6469 6e67 2061 646a tform adding adj │ │ │ │ │ -00007270: 7573 746d 656e 7473 2069 6620 6e65 6365 ustments if nece │ │ │ │ │ -00007280: 7373 6172 792e 0a57 6865 6e20 646f 6e65 ssary..When done │ │ │ │ │ -00007290: 2063 6f6d 7069 6c65 3a0a 0a20 2020 2020 compile:.. │ │ │ │ │ -000072a0: 2e2f 626f 6f74 7374 7261 700a 2020 2020 ./bootstrap. │ │ │ │ │ -000072b0: 202e 2f63 6f6e 6669 6775 7265 202d 2d74 ./configure --t │ │ │ │ │ -000072c0: 6172 6765 743d 2463 7075 202d 2d77 6974 arget=$cpu --wit │ │ │ │ │ -000072d0: 682d 706c 6174 666f 726d 3d24 706c 6174 h-platform=$plat │ │ │ │ │ -000072e0: 666f 726d 2054 4152 4745 545f 4343 3d2e form TARGET_CC=. │ │ │ │ │ -000072f0: 2e20 4f42 4a43 4f50 593d 2e2e 2e20 5354 . OBJCOPY=... ST │ │ │ │ │ -00007300: 5249 503d 2e2e 2e0a 2020 2020 206d 616b RIP=.... mak │ │ │ │ │ -00007310: 6520 3e20 2f64 6576 2f6e 756c 6c0a 0a20 e > /dev/null.. │ │ │ │ │ -00007320: 2020 416e 6420 6372 6561 7465 2069 6d61 And create ima │ │ │ │ │ -00007330: 6765 0a0a 2020 2020 202e 2f67 7275 622d ge.. ./grub- │ │ │ │ │ -00007340: 6d6b 696d 6167 6520 2d64 2067 7275 622d mkimage -d grub- │ │ │ │ │ -00007350: 636f 7265 202d 4f20 2466 6f72 6d61 745f core -O $format_ │ │ │ │ │ -00007360: 6964 202d 6f20 7465 7374 2e69 6d67 0a0a id -o test.img.. │ │ │ │ │ -00007370: 2020 2041 6e64 2069 7427 7320 7469 6d65 And it's time │ │ │ │ │ -00007380: 2074 6f20 7465 7374 2079 6f75 7220 7465 to test your te │ │ │ │ │ -00007390: 7374 2e69 6d67 2e0a 0a20 2020 4966 2069 st.img... If i │ │ │ │ │ -000073a0: 7420 776f 726b 7320 6e65 7874 2073 7461 t works next sta │ │ │ │ │ -000073b0: 6765 2069 7320 746f 2068 6176 6520 6865 ge is to have he │ │ │ │ │ -000073c0: 6170 2c20 636f 6e73 6f6c 6520 616e 6420 ap, console and │ │ │ │ │ -000073d0: 7469 6d65 722e 0a0a 2020 2054 6f20 6861 timer... To ha │ │ │ │ │ -000073e0: 7665 2074 6865 2068 6561 7020 776f 726b ve the heap work │ │ │ │ │ -000073f0: 696e 6720 796f 7520 6e65 6564 2074 6f20 ing you need to │ │ │ │ │ -00007400: 6465 7465 726d 696e 6520 7768 6963 6820 determine which │ │ │ │ │ -00007410: 7265 6769 6f6e 7320 6172 650a 7375 6974 regions are.suit │ │ │ │ │ -00007420: 6162 6c65 2066 6f72 2068 6561 7020 7573 able for heap us │ │ │ │ │ -00007430: 6167 652c 2061 6c6c 6f63 6174 6520 7468 age, allocate th │ │ │ │ │ -00007440: 656d 2066 726f 6d20 6669 726d 7761 7265 em from firmware │ │ │ │ │ -00007450: 2061 6e64 206d 6170 2028 6966 0a61 7070 and map (if.app │ │ │ │ │ -00007460: 6c69 6361 626c 6529 2e20 2054 6865 6e20 licable). Then │ │ │ │ │ -00007470: 6361 6c6c 2067 7275 625f 6d6d 5f69 6e69 call grub_mm_ini │ │ │ │ │ -00007480: 745f 7265 6769 6f6e 2028 766f 6973 202a t_region (vois * │ │ │ │ │ -00007490: 7374 6172 742c 2067 7275 625f 7369 7a65 start, grub_size │ │ │ │ │ -000074a0: 5f74 2073 290a 666f 7220 6576 6572 7920 _t s).for every │ │ │ │ │ -000074b0: 6f66 2074 6869 7320 7265 6769 6f6e 2e20 of this region. │ │ │ │ │ -000074c0: 2041 7320 6120 7368 6f72 7463 7574 2066 As a shortcut f │ │ │ │ │ -000074d0: 6f72 2065 6172 6c79 2070 6f72 7420 796f or early port yo │ │ │ │ │ -000074e0: 7520 6361 6e20 616c 6c6f 6361 7465 0a72 u can allocate.r │ │ │ │ │ -000074f0: 6967 6874 2061 6674 6572 205f 656e 6420 ight after _end │ │ │ │ │ -00007500: 6f72 2068 6176 6520 6120 6269 6720 7374 or have a big st │ │ │ │ │ -00007510: 6174 6963 2061 7272 6179 2066 6f72 2068 atic array for h │ │ │ │ │ -00007520: 6561 702e 2020 4966 2079 6f75 2064 6f20 eap. If you do │ │ │ │ │ -00007530: 796f 7527 6c6c 0a70 726f 6261 626c 7920 you'll.probably │ │ │ │ │ -00007540: 6e65 6564 2074 6f20 636f 6d65 2062 6163 need to come bac │ │ │ │ │ -00007550: 6b20 746f 2074 6869 7320 6c61 7465 722e k to this later. │ │ │ │ │ -00007560: 2020 4173 2066 6f72 206f 7574 7075 7420 As for output │ │ │ │ │ -00007570: 636f 6e73 6f6c 6520 796f 750a 7368 6f75 console you.shou │ │ │ │ │ -00007580: 6c64 2064 6973 7469 6e67 7569 7368 2062 ld distinguish b │ │ │ │ │ -00007590: 6574 7765 656e 2061 6e20 6172 7261 7920 etween an array │ │ │ │ │ -000075a0: 6f66 2074 6578 742c 2074 6572 6d69 6e66 of text, terminf │ │ │ │ │ -000075b0: 6f20 6f72 2067 7261 7068 6963 732d 6261 o or graphics-ba │ │ │ │ │ -000075c0: 7365 640a 636f 6e73 6f6c 652e 2020 4d61 sed.console. Ma │ │ │ │ │ -000075d0: 6e79 206f 6620 7265 616c 2d77 6f72 6c64 ny of real-world │ │ │ │ │ -000075e0: 2065 7861 6d70 6c65 7320 646f 6e27 7420 examples don't │ │ │ │ │ -000075f0: 6669 7420 7065 7266 6563 746c 7920 696e fit perfectly in │ │ │ │ │ -00007600: 746f 2061 6e79 206f 660a 7468 6573 6520 to any of.these │ │ │ │ │ -00007610: 6361 7465 676f 7269 6573 2062 7574 206f categories but o │ │ │ │ │ -00007620: 6e65 206f 6620 7468 6520 6d6f 6465 6c73 ne of the models │ │ │ │ │ -00007630: 2069 7320 6561 7369 6572 2074 6f20 6265 is easier to be │ │ │ │ │ -00007640: 2075 7365 6420 6173 2062 6173 652e 2020 used as base. │ │ │ │ │ -00007650: 496e 0a73 6563 6f6e 6420 616e 6420 7468 In.second and th │ │ │ │ │ -00007660: 6972 6420 6361 7365 2079 6f75 2073 686f ird case you sho │ │ │ │ │ -00007670: 756c 6420 6164 6420 796f 7572 2070 6c61 uld add your pla │ │ │ │ │ -00007680: 7466 6f72 6d20 746f 2074 6572 6d69 6e66 tform to terminf │ │ │ │ │ -00007690: 6f6b 6572 6e65 6c0a 7265 7370 6563 7469 okernel.respecti │ │ │ │ │ -000076a0: 7665 6c79 2076 6964 656f 696e 6b65 726e vely videoinkern │ │ │ │ │ -000076b0: 656c 2067 726f 7570 2e20 2041 2067 6f6f el group. A goo │ │ │ │ │ -000076c0: 6420 6578 616d 706c 6520 6f66 2061 7272 d example of arr │ │ │ │ │ -000076d0: 6179 206f 6620 7465 7874 2069 730a 6933 ay of text is.i3 │ │ │ │ │ -000076e0: 3836 2d70 6320 286b 6572 6e2f 6933 3836 86-pc (kern/i386 │ │ │ │ │ -000076f0: 2f70 632f 696e 6974 2e63 2061 6e64 2074 /pc/init.c and t │ │ │ │ │ -00007700: 6572 6d2f 6933 3836 2f70 632f 636f 6e73 erm/i386/pc/cons │ │ │ │ │ -00007710: 6f6c 652e 6329 2e20 204f 6620 7465 726d ole.c). Of term │ │ │ │ │ -00007720: 696e 666f 0a69 7320 6965 6565 3132 3735 info.is ieee1275 │ │ │ │ │ -00007730: 2028 6b65 726e 2f69 6565 6531 3237 352f (kern/ieee1275/ │ │ │ │ │ -00007740: 696e 6974 2e63 2061 6e64 2074 6572 6d2f init.c and term/ │ │ │ │ │ -00007750: 6965 6565 3132 3735 2f63 6f6e 736f 6c65 ieee1275/console │ │ │ │ │ -00007760: 2e63 292e 2020 4f66 0a76 6964 656f 2069 .c). Of.video i │ │ │ │ │ -00007770: 7320 6c6f 6f6e 6773 6f6e 2028 6b65 726e s loongson (kern │ │ │ │ │ -00007780: 2f6d 6970 732f 6c6f 6f6e 6773 6f6e 2f69 /mips/loongson/i │ │ │ │ │ -00007790: 6e69 742e 6329 2e20 204e 6f74 6520 7468 nit.c). Note th │ │ │ │ │ -000077a0: 6174 2074 6572 6d69 6e66 6f20 6861 730a at terminfo has. │ │ │ │ │ -000077b0: 746f 2062 6520 696e 6974 6564 2069 6e20 to be inited in │ │ │ │ │ -000077c0: 3220 7374 6167 6573 3a20 6f6e 6520 6265 2 stages: one be │ │ │ │ │ -000077d0: 666f 7265 2028 746f 2067 6574 2061 7420 fore (to get at │ │ │ │ │ -000077e0: 6c65 6173 7420 7275 6469 6d65 6e74 6172 least rudimentar │ │ │ │ │ -000077f0: 790a 636f 6e73 6f6c 6520 6173 2065 6172 y.console as ear │ │ │ │ │ -00007800: 6c79 2061 7320 706f 7373 6962 6c65 2920 ly as possible) │ │ │ │ │ -00007810: 616e 6420 616e 6f74 6865 7220 6166 7465 and another afte │ │ │ │ │ -00007820: 7220 7468 6520 6865 6170 2028 746f 2067 r the heap (to g │ │ │ │ │ -00007830: 6574 0a66 756c 6c2d 6665 6174 7572 6564 et.full-featured │ │ │ │ │ -00007840: 2063 6f6e 736f 6c65 292e 2020 466f 7220 console). For │ │ │ │ │ -00007850: 7468 6520 696e 7075 7420 7468 6572 6520 the input there │ │ │ │ │ -00007860: 6172 6520 7374 7269 6e67 206f 6620 6b65 are string of ke │ │ │ │ │ -00007870: 7973 2c0a 7465 726d 696e 666f 2061 6e64 ys,.terminfo and │ │ │ │ │ -00007880: 2064 6972 6563 7420 6861 7264 7761 7265 direct hardware │ │ │ │ │ -00007890: 2e20 2046 6f72 2073 7472 696e 6720 6f66 . For string of │ │ │ │ │ -000078a0: 206b 6579 7320 6c6f 6f6b 2061 7420 6933 keys look at i3 │ │ │ │ │ -000078b0: 3836 2d70 6320 2873 616d 650a 6669 6c65 86-pc (same.file │ │ │ │ │ -000078c0: 7329 2c20 666f 7220 7465 726d 696e 666f s), for terminfo │ │ │ │ │ -000078d0: 2069 6565 6531 3237 3520 2873 616d 6520 ieee1275 (same │ │ │ │ │ -000078e0: 6669 6c65 7329 2061 6e64 2066 6f72 2068 files) and for h │ │ │ │ │ -000078f0: 6172 6477 6172 6520 6c6f 6f6e 6773 6f6e ardware loongson │ │ │ │ │ -00007900: 0a28 6b65 726e 2f6d 6970 732f 6c6f 6f6e .(kern/mips/loon │ │ │ │ │ -00007910: 6773 6f6e 2f69 6e69 742e 6320 616e 6420 gson/init.c and │ │ │ │ │ -00007920: 7465 726d 2f61 745f 6b65 7962 6f61 7264 term/at_keyboard │ │ │ │ │ -00007930: 2e63 292e 0a0a 2020 2046 6f72 2074 6865 .c)... For the │ │ │ │ │ -00007940: 2074 696d 6572 2079 6f75 276c 6c20 6e65 timer you'll ne │ │ │ │ │ -00007950: 6564 2074 6f20 6361 6c6c 2067 7275 625f ed to call grub_ │ │ │ │ │ -00007960: 696e 7374 616c 6c5f 6765 745f 7469 6d65 install_get_time │ │ │ │ │ -00007970: 5f6d 7320 282e 2e2e 290a 7769 7468 2061 _ms (...).with a │ │ │ │ │ -00007980: 7320 736f 6c65 2061 7267 756d 656e 7420 s sole argument │ │ │ │ │ -00007990: 6120 6675 6e63 7469 6f6e 2072 6574 7572 a function retur │ │ │ │ │ -000079a0: 6e69 6e67 2061 2067 7275 625f 7569 6e74 ning a grub_uint │ │ │ │ │ -000079b0: 3634 5f74 206f 6620 6120 6e75 6d62 6572 64_t of a number │ │ │ │ │ -000079c0: 0a6f 6620 6d69 6c6c 6973 6563 6f6e 6473 .of milliseconds │ │ │ │ │ -000079d0: 2065 6c61 7073 6564 2073 696e 6365 2061 elapsed since a │ │ │ │ │ -000079e0: 7262 6974 7261 7279 2070 6f69 6e74 2069 rbitrary point i │ │ │ │ │ -000079f0: 6e20 7468 6520 7061 7374 2e0a 0a20 2020 n the past... │ │ │ │ │ -00007a00: 4f6e 6365 2074 6865 7365 2073 7465 7073 Once these steps │ │ │ │ │ -00007a10: 2061 6363 6f6d 706c 6973 6865 6420 796f accomplished yo │ │ │ │ │ -00007a20: 7520 6361 6e20 7265 6d6f 7665 2074 6865 u can remove the │ │ │ │ │ -00007a30: 2069 6e69 6669 6e69 7465 206c 6f6f 7020 inifinite loop │ │ │ │ │ -00007a40: 616e 640a 796f 7520 7368 6f75 6c64 2062 and.you should b │ │ │ │ │ -00007a50: 6520 6162 6c65 2074 6f20 6765 7420 746f e able to get to │ │ │ │ │ -00007a60: 2074 6865 206d 696e 696d 616c 2063 6f6e the minimal con │ │ │ │ │ -00007a70: 736f 6c65 2e20 204e 6578 7420 7374 6570 sole. Next step │ │ │ │ │ -00007a80: 2069 7320 746f 2068 6176 650a 6d6f 6475 is to have.modu │ │ │ │ │ -00007a90: 6c65 206c 6f61 6469 6e67 2077 6f72 6b69 le loading worki │ │ │ │ │ -00007aa0: 6e67 2e20 2046 6f72 2074 6869 7320 796f ng. For this yo │ │ │ │ │ -00007ab0: 7527 6c6c 206e 6565 6420 746f 2066 696c u'll need to fil │ │ │ │ │ -00007ac0: 6c20 6b65 726e 2f24 6370 752f 646c 2e63 l kern/$cpu/dl.c │ │ │ │ │ -00007ad0: 2061 6e64 0a6b 6572 6e2f 2463 7075 2f63 and.kern/$cpu/c │ │ │ │ │ -00007ae0: 6163 6865 2e53 2077 6974 6820 7265 616c ache.S with real │ │ │ │ │ -00007af0: 2068 616e 646c 696e 6720 6f66 2072 656c handling of rel │ │ │ │ │ -00007b00: 6f63 6174 696f 6e73 2061 6e64 2072 6573 ocations and res │ │ │ │ │ -00007b10: 7065 6374 6976 656c 7920 7468 650a 7265 pectively the.re │ │ │ │ │ -00007b20: 616c 2073 796e 6320 6f66 2049 2061 6e64 al sync of I and │ │ │ │ │ -00007b30: 2044 2063 6163 6865 732e 2020 416c 736f D caches. Also │ │ │ │ │ -00007b40: 2079 6f75 276c 6c20 6e65 6564 2074 6f20 you'll need to │ │ │ │ │ -00007b50: 6465 6369 6465 2077 6865 7265 2069 6e20 decide where in │ │ │ │ │ -00007b60: 7468 650a 696d 6167 6520 746f 2073 746f the.image to sto │ │ │ │ │ -00007b70: 7265 2074 6865 206d 6f64 756c 6573 2e20 re the modules. │ │ │ │ │ -00007b80: 2055 7375 616c 2077 6179 2069 7320 746f Usual way is to │ │ │ │ │ -00007b90: 2068 6176 6520 6974 2063 6f6e 6361 7465 have it concate │ │ │ │ │ -00007ba0: 6e61 7465 6420 6174 2074 6865 0a65 6e64 nated at the.end │ │ │ │ │ -00007bb0: 2e20 2049 6e20 7468 6973 2063 6173 6520 . In this case │ │ │ │ │ -00007bc0: 796f 7527 6c6c 206e 6565 6420 746f 206d you'll need to m │ │ │ │ │ -00007bd0: 6f64 6966 7920 7374 6172 7475 702e 5320 odify startup.S │ │ │ │ │ -00007be0: 746f 2063 6f70 7920 6d6f 6475 6c65 7320 to copy modules │ │ │ │ │ -00007bf0: 6f75 740a 6f66 2062 7373 2074 6f20 6c65 out.of bss to le │ │ │ │ │ -00007c00: 7427 7320 7361 7920 414c 4947 4e5f 5550 t's say ALIGN_UP │ │ │ │ │ -00007c10: 2028 5f65 6e64 2c20 3829 2062 6566 6f72 (_end, 8) befor │ │ │ │ │ -00007c20: 6520 636c 6561 6e69 6e67 206f 7574 2062 e cleaning out b │ │ │ │ │ -00007c30: 7373 2e20 2059 6f75 276c 6c0a 7072 6f62 ss. You'll.prob │ │ │ │ │ -00007c40: 6162 6c79 2066 696e 6420 7573 6566 756c ably find useful │ │ │ │ │ -00007c50: 2074 6f20 6164 6420 746f 7461 6c5f 6d6f to add total_mo │ │ │ │ │ -00007c60: 6475 6c65 5f73 697a 6520 6669 656c 6420 dule_size field │ │ │ │ │ -00007c70: 746f 2073 7461 7274 7570 2e53 2e20 496e to startup.S. In │ │ │ │ │ -00007c80: 0a69 6e69 742e 6320 796f 7520 6e65 6564 .init.c you need │ │ │ │ │ -00007c90: 2074 6f20 7365 7420 6772 7562 5f6d 6f64 to set grub_mod │ │ │ │ │ -00007ca0: 6261 7365 2074 6f20 7468 6520 6164 6472 base to the addr │ │ │ │ │ -00007cb0: 6573 7320 7768 6572 6520 6d6f 6475 6c65 ess where module │ │ │ │ │ -00007cc0: 7320 6361 6e20 6265 0a66 6f75 6e64 2e20 s can be.found. │ │ │ │ │ -00007cd0: 2059 6f75 206d 6179 206e 6565 6420 6772 You may need gr │ │ │ │ │ -00007ce0: 7562 5f6d 6f64 756c 6573 5f67 6574 5f65 ub_modules_get_e │ │ │ │ │ -00007cf0: 6e64 2028 2920 746f 2061 766f 6964 2064 nd () to avoid d │ │ │ │ │ -00007d00: 6563 6c61 7269 6e67 2074 6865 0a73 7061 eclaring the.spa │ │ │ │ │ -00007d10: 6365 206f 6363 7570 6965 6420 6279 206d ce occupied by m │ │ │ │ │ -00007d20: 6f64 756c 6573 2061 7320 7573 6162 6c65 odules as usable │ │ │ │ │ -00007d30: 2066 6f72 2068 6561 702e 2020 596f 7520 for heap. You │ │ │ │ │ -00007d40: 6361 6e20 7465 7374 206d 6f64 756c 6573 can test modules │ │ │ │ │ -00007d50: 0a77 6974 683a 0a0a 2020 2020 202e 2f67 .with:.. ./g │ │ │ │ │ -00007d60: 7275 622d 6d6b 696d 6167 6520 2d64 2067 rub-mkimage -d g │ │ │ │ │ -00007d70: 7275 622d 636f 7265 202d 4f20 2466 6f72 rub-core -O $for │ │ │ │ │ -00007d80: 6d61 745f 6964 202d 6f20 7465 7374 2e69 mat_id -o test.i │ │ │ │ │ -00007d90: 6d67 2068 656c 6c6f 0a0a 2020 2061 6e64 mg hello.. and │ │ │ │ │ -00007da0: 2074 6865 6e20 7275 6e6e 696e 6720 2268 then running "h │ │ │ │ │ -00007db0: 656c 6c6f 2220 696e 2074 6865 2073 6865 ello" in the she │ │ │ │ │ -00007dc0: 6c6c 2e0a 0a20 2020 4f6e 6365 2074 6869 ll... Once thi │ │ │ │ │ -00007dd0: 7320 776f 726b 732c 2079 6f75 2073 686f s works, you sho │ │ │ │ │ -00007de0: 756c 6420 7468 696e 6b20 6f66 2069 6d70 uld think of imp │ │ │ │ │ -00007df0: 6c65 6d65 6e74 696e 6720 6469 736b 2061 lementing disk a │ │ │ │ │ -00007e00: 6363 6573 732e 2020 4c6f 6f6b 0a61 726f ccess. Look.aro │ │ │ │ │ -00007e10: 756e 6420 6469 736b 2f20 666f 7220 6578 und disk/ for ex │ │ │ │ │ -00007e20: 616d 706c 6573 2e0a 0a20 2020 5468 656e amples... Then │ │ │ │ │ -00007e30: 2c20 7665 7279 2069 6d70 6f72 7461 6e74 , very important │ │ │ │ │ -00007e40: 6c79 2c20 796f 7520 7072 6f62 6162 6c79 ly, you probably │ │ │ │ │ -00007e50: 206e 6565 6420 746f 2069 6d70 6c65 6d65 need to impleme │ │ │ │ │ -00007e60: 6e74 2074 6865 2061 6374 7561 6c0a 6c6f nt the actual.lo │ │ │ │ │ -00007e70: 6164 6572 2028 6578 616d 706c 6573 2061 ader (examples a │ │ │ │ │ -00007e80: 7661 696c 6162 6c65 2069 6e20 6c6f 6164 vailable in load │ │ │ │ │ -00007e90: 6572 2f29 0a0a 2020 204c 6173 7420 7374 er/).. Last st │ │ │ │ │ -00007ea0: 6570 2074 6f20 6861 7665 206d 696e 696d ep to have minim │ │ │ │ │ -00007eb0: 616c 6c79 2075 7361 626c 6520 706f 7274 ally usable port │ │ │ │ │ -00007ec0: 2069 7320 746f 2061 6464 2073 7570 706f is to add suppo │ │ │ │ │ -00007ed0: 7274 2074 6f0a 6772 7562 2d69 6e73 7461 rt to.grub-insta │ │ │ │ │ -00007ee0: 6c6c 2074 6f20 7075 7420 4752 5542 2069 ll to put GRUB i │ │ │ │ │ -00007ef0: 6e20 6120 706c 6163 6520 7768 6572 6520 n a place where │ │ │ │ │ -00007f00: 6669 726d 7761 7265 206f 7220 706c 6174 firmware or plat │ │ │ │ │ -00007f10: 666f 726d 2077 696c 6c20 7069 636b 0a69 form will pick.i │ │ │ │ │ -00007f20: 7420 7570 2e0a 0a20 2020 4e65 7874 2073 t up... Next s │ │ │ │ │ -00007f30: 7465 7073 2061 7265 3a20 6669 6c6c 696e teps are: fillin │ │ │ │ │ -00007f40: 6720 6461 7465 7469 6d65 2e63 2c20 7365 g datetime.c, se │ │ │ │ │ -00007f50: 746a 6d70 2e53 2c20 6e65 7477 6f72 6b20 tjmp.S, network │ │ │ │ │ -00007f60: 286e 6574 2f64 7269 7665 7273 292c 0a76 (net/drivers),.v │ │ │ │ │ -00007f70: 6964 656f 2028 7669 6465 6f2f 292c 2068 ideo (video/), h │ │ │ │ │ -00007f80: 616c 7420 286c 6962 2f29 2c20 7265 626f alt (lib/), rebo │ │ │ │ │ -00007f90: 6f74 2028 6c69 622f 292e 0a0a 2020 2050 ot (lib/)... P │ │ │ │ │ -00007fa0: 6c65 6173 6520 6164 6420 796f 7572 2070 lease add your p │ │ │ │ │ -00007fb0: 6c61 7466 6f72 6d20 746f 2050 6c61 7466 latform to Platf │ │ │ │ │ -00007fc0: 6f72 6d20 6c69 6d69 7461 7469 6f6e 7320 orm limitations │ │ │ │ │ -00007fd0: 616e 6420 5375 7070 6f72 7465 640a 6b65 and Supported.ke │ │ │ │ │ -00007fe0: 726e 656c 7320 6368 6170 7465 7220 696e rnels chapter in │ │ │ │ │ -00007ff0: 2075 7365 7220 646f 6375 6d65 6e74 6174 user documentat │ │ │ │ │ -00008000: 696f 6e20 616e 6420 6d65 6e74 696f 6e20 ion and mention │ │ │ │ │ -00008010: 616e 7920 7374 6570 7320 796f 7520 736b any steps you sk │ │ │ │ │ -00008020: 6970 7065 640a 7768 6963 6820 7265 7375 ipped.which resu │ │ │ │ │ -00008030: 6c74 2069 6e20 7265 6475 6365 6420 6665 lt in reduced fe │ │ │ │ │ -00008040: 6174 7572 6573 206f 7220 7065 7266 6f72 atures or perfor │ │ │ │ │ -00008050: 6d61 6e63 652e 2020 4865 7265 2069 7320 mance. Here is │ │ │ │ │ -00008060: 7468 6520 7175 6963 6b0a 6368 6563 6b6c the quick.checkl │ │ │ │ │ -00008070: 6973 7420 6f66 2066 6561 7475 7265 732e ist of features. │ │ │ │ │ -00008080: 2020 536f 6d65 206f 6620 7468 656d 2061 Some of them a │ │ │ │ │ -00008090: 7265 206c 6573 7320 696d 706f 7274 616e re less importan │ │ │ │ │ -000080a0: 7420 7468 616e 206f 7468 6572 7320 616e t than others an │ │ │ │ │ -000080b0: 640a 736b 6970 7069 6e67 2074 6865 6d20 d.skipping them │ │ │ │ │ -000080c0: 6973 2063 6f6d 706c 6574 656c 7920 6f6b is completely ok │ │ │ │ │ -000080d0: 2c20 6a75 7374 206e 6565 6473 2074 6f20 , just needs to │ │ │ │ │ -000080e0: 6265 206d 656e 7469 6f6e 6564 2069 6e20 be mentioned in │ │ │ │ │ -000080f0: 7573 6572 0a64 6f63 756d 656e 7461 7469 user.documentati │ │ │ │ │ -00008100: 6f6e 2e0a 0a20 2020 4368 6563 6b6c 6973 on... Checklis │ │ │ │ │ -00008110: 743a 0a20 2020 2a20 4973 2068 6561 7020 t:. * Is heap │ │ │ │ │ -00008120: 6269 6720 656e 6f75 6768 3f0a 2020 202a big enough?. * │ │ │ │ │ -00008130: 2057 6869 6368 2063 6861 7273 6574 2069 Which charset i │ │ │ │ │ -00008140: 7320 7375 7070 6f72 7465 6420 6279 2063 s supported by c │ │ │ │ │ -00008150: 6f6e 736f 6c65 3f0a 2020 202a 2044 6f65 onsole?. * Doe │ │ │ │ │ -00008160: 7320 706c 6174 666f 726d 2068 6176 6520 s platform have │ │ │ │ │ -00008170: 6469 736b 2064 7269 7665 723f 0a20 2020 disk driver?. │ │ │ │ │ -00008180: 2a20 446f 2079 6f75 2068 6176 6520 6e65 * Do you have ne │ │ │ │ │ -00008190: 7477 6f72 6b20 6361 7264 2073 7570 706f twork card suppo │ │ │ │ │ -000081a0: 7274 3f0a 2020 202a 2041 7265 2079 6f75 rt?. * Are you │ │ │ │ │ -000081b0: 2061 626c 6520 746f 2072 6574 7269 6576 able to retriev │ │ │ │ │ -000081c0: 6520 6461 7465 7469 6d65 2028 7769 7468 e datetime (with │ │ │ │ │ -000081d0: 2064 6174 6529 3f0a 2020 202a 2041 7265 date)?. * Are │ │ │ │ │ -000081e0: 2079 6f75 2061 626c 6520 746f 2073 6574 you able to set │ │ │ │ │ -000081f0: 2064 6174 6574 696d 6520 2877 6974 6820 datetime (with │ │ │ │ │ -00008200: 6461 7465 293f 0a20 2020 2a20 4973 2073 date)?. * Is s │ │ │ │ │ -00008210: 6572 6961 6c20 7375 7070 6f72 7465 643f erial supported? │ │ │ │ │ -00008220: 0a20 2020 2a20 446f 2079 6f75 2068 6176 . * Do you hav │ │ │ │ │ -00008230: 6520 6469 7265 6374 2064 6973 6b20 7375 e direct disk su │ │ │ │ │ -00008240: 7070 6f72 743f 0a20 2020 2a20 446f 2079 pport?. * Do y │ │ │ │ │ -00008250: 6f75 2068 6176 6520 6469 7265 6374 206b ou have direct k │ │ │ │ │ -00008260: 6579 626f 6172 6420 7375 7070 6f72 743f eyboard support? │ │ │ │ │ -00008270: 0a20 2020 2a20 446f 2079 6f75 2068 6176 . * Do you hav │ │ │ │ │ -00008280: 6520 5553 4220 7375 7070 6f72 743f 0a20 e USB support?. │ │ │ │ │ -00008290: 2020 2a20 446f 2079 6f75 2073 7570 706f * Do you suppo │ │ │ │ │ -000082a0: 7274 206c 6f61 6469 6e67 2074 6872 6f75 rt loading throu │ │ │ │ │ -000082b0: 6768 206e 6574 776f 726b 3f0a 2020 202a gh network?. * │ │ │ │ │ -000082c0: 2044 6f20 796f 7520 7375 7070 6f72 7420 Do you support │ │ │ │ │ -000082d0: 6c6f 6164 696e 6720 6672 6f6d 2064 6973 loading from dis │ │ │ │ │ -000082e0: 6b3f 0a20 2020 2a20 446f 2079 6f75 2073 k?. * Do you s │ │ │ │ │ -000082f0: 7570 706f 7274 2063 6861 696e 6c6f 6164 upport chainload │ │ │ │ │ -00008300: 696e 673f 0a20 2020 2a20 446f 2079 6f75 ing?. * Do you │ │ │ │ │ -00008310: 2073 7570 706f 7274 206e 6574 776f 726b support network │ │ │ │ │ -00008320: 2063 6861 696e 6c6f 6164 696e 673f 0a20 chainloading?. │ │ │ │ │ -00008330: 2020 2a20 446f 6573 2063 7075 6964 2063 * Does cpuid c │ │ │ │ │ -00008340: 6f6d 6d61 6e64 2073 7570 706f 7274 7320 ommand supports │ │ │ │ │ -00008350: 6368 6563 6b69 6e67 2061 6c6c 2043 5055 checking all CPU │ │ │ │ │ -00008360: 2066 6561 7475 7265 7320 7468 6174 2074 features that t │ │ │ │ │ -00008370: 6865 2075 7365 720a 2020 2020 206d 6967 he user. mig │ │ │ │ │ -00008380: 6874 2077 616e 7420 636f 6e64 6974 696f ht want conditio │ │ │ │ │ -00008390: 6e61 6c69 7365 206f 6e20 2836 342d 6269 nalise on (64-bi │ │ │ │ │ -000083a0: 7420 6d6f 6465 2c20 6879 7065 7276 6973 t mode, hypervis │ │ │ │ │ -000083b0: 6f72 2c2e 2e2e 290a 2020 202a 2044 6f20 or,...). * Do │ │ │ │ │ -000083c0: 796f 7520 7375 7070 6f72 7420 6869 6e74 you support hint │ │ │ │ │ -000083d0: 733f 2020 486f 7720 7265 6c69 6162 6c65 s? How reliable │ │ │ │ │ -000083e0: 2061 7265 2074 6865 793f 0a20 2020 2a20 are they?. * │ │ │ │ │ -000083f0: 446f 6573 2070 6c61 7466 6f72 6d20 6861 Does platform ha │ │ │ │ │ -00008400: 7665 2041 4350 493f 2049 6620 736f 2064 ve ACPI? If so d │ │ │ │ │ -00008410: 6f20 2261 6370 6922 2061 6e64 2022 6c73 o "acpi" and "ls │ │ │ │ │ -00008420: 6163 7069 2220 6d6f 6475 6c65 7320 776f acpi" modules wo │ │ │ │ │ -00008430: 726b 3f0a 2020 202a 2044 6f20 616e 7920 rk?. * Do any │ │ │ │ │ -00008440: 6f66 2070 6c61 7466 6f72 6d2d 7370 6563 of platform-spec │ │ │ │ │ -00008450: 6966 6963 206f 7065 7261 7469 6f6e 7320 ific operations │ │ │ │ │ -00008460: 6d65 6e74 696f 6e65 6420 696e 2074 6865 mentioned in the │ │ │ │ │ -00008470: 2072 656c 6576 616e 740a 2020 2020 2073 relevant. s │ │ │ │ │ -00008480: 6563 7469 6f6e 206f 6620 7573 6572 206d ection of user m │ │ │ │ │ -00008490: 616e 7561 6c20 6d61 6b65 7320 7365 6e73 anual makes sens │ │ │ │ │ -000084a0: 6520 6f6e 2079 6f75 7220 706c 6174 666f e on your platfo │ │ │ │ │ -000084b0: 726d 3f0a 2020 202a 2044 6f65 7320 796f rm?. * Does yo │ │ │ │ │ -000084c0: 7572 2070 6c61 7466 6f72 6d20 7375 7070 ur platform supp │ │ │ │ │ -000084d0: 6f72 7420 5043 493f 2049 6620 736f 2069 ort PCI? If so i │ │ │ │ │ -000084e0: 7320 7468 6572 6520 616e 2061 7070 726f s there an appro │ │ │ │ │ -000084f0: 7072 6961 7465 0a20 2020 2020 6472 6976 priate. driv │ │ │ │ │ -00008500: 6572 2066 6f72 2047 5255 423f 0a20 2020 er for GRUB?. │ │ │ │ │ -00008510: 2a20 446f 2079 6f75 2073 7570 706f 7274 * Do you support │ │ │ │ │ -00008520: 2062 6164 7261 6d3f 0a0a 1f0a 4669 6c65 badram?....File │ │ │ │ │ -00008530: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ -00008540: 2020 4e6f 6465 3a20 4572 726f 7220 4861 Node: Error Ha │ │ │ │ │ -00008550: 6e64 6c69 6e67 2c20 204e 6578 743a 2053 ndling, Next: S │ │ │ │ │ -00008560: 7461 636b 2061 6e64 2068 6561 7020 7369 tack and heap si │ │ │ │ │ -00008570: 7a65 2c20 2050 7265 763a 2050 6f72 7469 ze, Prev: Porti │ │ │ │ │ -00008580: 6e67 2c20 2055 703a 2054 6f70 0a0a 3720 ng, Up: Top..7 │ │ │ │ │ -00008590: 4572 726f 7220 4861 6e64 6c69 6e67 0a2a Error Handling.* │ │ │ │ │ -000085a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ -000085b0: 0a45 7272 6f72 2068 616e 646c 696e 6720 .Error handling │ │ │ │ │ -000085c0: 696e 2047 5255 4220 3220 6973 2062 6173 in GRUB 2 is bas │ │ │ │ │ -000085d0: 6564 206f 6e20 6578 6365 7074 696f 6e20 ed on exception │ │ │ │ │ -000085e0: 6861 6e64 6c69 6e67 206d 6f64 656c 2e20 handling model. │ │ │ │ │ -000085f0: 2041 7320 430a 6c61 6e67 7561 6765 2064 As C.language d │ │ │ │ │ -00008600: 6f65 736e 2774 2064 6972 6563 746c 7920 oesn't directly │ │ │ │ │ -00008610: 7375 7070 6f72 7420 6578 6365 7074 696f support exceptio │ │ │ │ │ -00008620: 6e73 2c20 6578 6365 7074 696f 6e20 6861 ns, exception ha │ │ │ │ │ -00008630: 6e64 6c69 6e67 0a62 6568 6176 696f 7220 ndling.behavior │ │ │ │ │ -00008640: 6973 2065 6d75 6c61 7465 6420 696e 2073 is emulated in s │ │ │ │ │ -00008650: 6f66 7477 6172 652e 0a0a 2020 2057 6865 oftware... Whe │ │ │ │ │ -00008660: 6e20 6578 6365 7074 696f 6e20 6973 2072 n exception is r │ │ │ │ │ -00008670: 6169 7365 642c 2066 756e 6374 696f 6e20 aised, function │ │ │ │ │ -00008680: 6d75 7374 2072 6574 7572 6e20 746f 2063 must return to c │ │ │ │ │ -00008690: 616c 6c69 6e67 2066 756e 6374 696f 6e2e alling function. │ │ │ │ │ -000086a0: 0a49 6620 6361 6c6c 696e 6720 6675 6e63 .If calling func │ │ │ │ │ -000086b0: 7469 6f6e 2064 6f65 7320 6e6f 7420 7072 tion does not pr │ │ │ │ │ -000086c0: 6f76 6964 6520 6861 6e64 6c69 6e67 206f ovide handling o │ │ │ │ │ -000086d0: 6620 7468 6520 6578 6365 7074 696f 6e20 f the exception │ │ │ │ │ -000086e0: 6974 206d 7573 740a 7265 7475 726e 2062 it must.return b │ │ │ │ │ -000086f0: 6163 6b20 746f 2069 7473 2063 616c 6c69 ack to its calli │ │ │ │ │ -00008700: 6e67 2066 756e 6374 696f 6e20 616e 6420 ng function and │ │ │ │ │ -00008710: 736f 206f 6e2c 2075 6e74 696c 2065 7863 so on, until exc │ │ │ │ │ -00008720: 6570 7469 6f6e 2069 730a 6861 6e64 6c65 eption is.handle │ │ │ │ │ -00008730: 642e 2020 4966 2065 7863 6570 7469 6f6e d. If exception │ │ │ │ │ -00008740: 2069 7320 6e6f 7420 6861 6e64 6c65 6420 is not handled │ │ │ │ │ -00008750: 6265 666f 7265 2070 726f 6d70 7420 6973 before prompt is │ │ │ │ │ -00008760: 2064 6973 706c 6179 6564 2c20 6572 726f displayed, erro │ │ │ │ │ -00008770: 720a 6d65 7373 6167 6520 7769 6c6c 2062 r.message will b │ │ │ │ │ -00008780: 6520 7368 6f77 6e20 746f 2075 7365 722e e shown to user. │ │ │ │ │ -00008790: 0a0a 2020 2045 7863 6570 7469 6f6e 2069 .. Exception i │ │ │ │ │ -000087a0: 6e66 6f72 6d61 7469 6f6e 2069 7320 7374 nformation is st │ │ │ │ │ -000087b0: 6f72 6564 206f 6e20 2767 7275 625f 6572 ored on 'grub_er │ │ │ │ │ -000087c0: 726e 6f27 2067 6c6f 6261 6c20 7661 7269 rno' global vari │ │ │ │ │ -000087d0: 6162 6c65 2e20 2049 660a 2767 7275 625f able. If.'grub_ │ │ │ │ │ -000087e0: 6572 726e 6f27 2076 6172 6961 626c 6520 errno' variable │ │ │ │ │ -000087f0: 636f 6e74 6169 6e73 2076 616c 7565 2027 contains value ' │ │ │ │ │ -00008800: 4752 5542 5f45 5252 5f4e 4f4e 4527 2c20 GRUB_ERR_NONE', │ │ │ │ │ -00008810: 7468 6572 6520 6973 206e 6f20 6163 7469 there is no acti │ │ │ │ │ -00008820: 7665 0a65 7863 6570 7469 6f6e 2061 6e64 ve.exception and │ │ │ │ │ -00008830: 2061 7070 6c69 6361 7469 6f6e 2063 616e application can │ │ │ │ │ -00008840: 2063 6f6e 7469 6e75 6520 6e6f 726d 616c continue normal │ │ │ │ │ -00008850: 2070 726f 6365 7373 696e 672e 2020 5768 processing. Wh │ │ │ │ │ -00008860: 656e 0a27 6772 7562 5f65 7272 6e6f 2720 en.'grub_errno' │ │ │ │ │ -00008870: 6861 7320 6f74 6865 7220 7661 6c75 652c has other value, │ │ │ │ │ -00008880: 2069 7420 6973 2072 6571 7569 7265 6420 it is required │ │ │ │ │ -00008890: 7468 6174 2061 7070 6c69 6361 7469 6f6e that application │ │ │ │ │ -000088a0: 2063 6f64 650a 6569 7468 6572 2068 616e code.either han │ │ │ │ │ -000088b0: 646c 6573 2074 6869 7320 6572 726f 7220 dles this error │ │ │ │ │ -000088c0: 6f72 2072 6574 7572 6e73 2069 6e73 7461 or returns insta │ │ │ │ │ -000088d0: 6e74 6c79 2074 6f20 6361 6c6c 6572 2e20 ntly to caller. │ │ │ │ │ -000088e0: 2049 6620 6675 6e63 7469 6f6e 0a69 7320 If function.is │ │ │ │ │ -000088f0: 7769 7468 2072 6574 7572 6e20 7479 7065 with return type │ │ │ │ │ -00008900: 2027 6772 7562 5f65 7272 5f74 2720 6973 'grub_err_t' is │ │ │ │ │ -00008910: 2061 626f 7574 2074 6f20 7265 7475 726e about to return │ │ │ │ │ -00008920: 2027 4752 5542 5f45 5252 5f4e 4f4e 4527 'GRUB_ERR_NONE' │ │ │ │ │ -00008930: 2c20 6974 0a73 686f 756c 6420 6e6f 7420 , it.should not │ │ │ │ │ -00008940: 7365 7420 2767 7275 625f 6572 726e 6f27 set 'grub_errno' │ │ │ │ │ -00008950: 2074 6f20 7468 6174 2076 616c 7565 2e20 to that value. │ │ │ │ │ -00008960: 204f 6e6c 7920 7365 7420 2767 7275 625f Only set 'grub_ │ │ │ │ │ -00008970: 6572 726e 6f27 2069 6e0a 6361 7365 7320 errno' in.cases │ │ │ │ │ -00008980: 7768 6572 6520 7468 6572 6520 6973 2065 where there is e │ │ │ │ │ -00008990: 7272 6f72 2073 6974 7561 7469 6f6e 2e0a rror situation.. │ │ │ │ │ -000089a0: 0a20 2020 5369 6d70 6c65 2065 7863 6570 . Simple excep │ │ │ │ │ -000089b0: 7469 6f6e 2066 6f72 7761 7264 6572 2e0a tion forwarder.. │ │ │ │ │ -000089c0: 2020 2020 2067 7275 625f 6572 725f 740a grub_err_t. │ │ │ │ │ -000089d0: 2020 2020 2066 6f72 7761 7264 696e 675f forwarding_ │ │ │ │ │ -000089e0: 6578 616d 706c 6520 2876 6f69 6429 0a20 example (void). │ │ │ │ │ -000089f0: 2020 2020 7b0a 2020 2020 2020 202f 2a20 {. /* │ │ │ │ │ -00008a00: 4361 6c6c 2066 756e 6374 696f 6e20 7468 Call function th │ │ │ │ │ -00008a10: 6174 206d 6967 6874 2063 6175 7365 2065 at might cause e │ │ │ │ │ -00008a20: 7863 6570 7469 6f6e 2e20 202a 2f0a 2020 xception. */. │ │ │ │ │ -00008a30: 2020 2020 2066 6f6f 6261 7220 2829 3b0a foobar ();. │ │ │ │ │ -00008a40: 0a20 2020 2020 2020 2f2a 204e 6f20 7370 . /* No sp │ │ │ │ │ -00008a50: 6563 6961 6c20 6578 6365 7074 696f 6e20 ecial exception │ │ │ │ │ -00008a60: 6861 6e64 6c65 722c 206a 7573 7420 666f handler, just fo │ │ │ │ │ -00008a70: 7277 6172 6420 706f 7373 6962 6c65 2065 rward possible e │ │ │ │ │ -00008a80: 7863 6570 7469 6f6e 732e 2020 2a2f 0a20 xceptions. */. │ │ │ │ │ -00008a90: 2020 2020 2020 6966 2028 6772 7562 5f65 if (grub_e │ │ │ │ │ -00008aa0: 7272 6e6f 2021 3d20 4752 5542 5f45 5252 rrno != GRUB_ERR │ │ │ │ │ -00008ab0: 5f4e 4f4e 4529 0a20 2020 2020 2020 2020 _NONE). │ │ │ │ │ -00008ac0: 7b0a 2020 2020 2020 2020 2020 2072 6574 {. ret │ │ │ │ │ -00008ad0: 7572 6e20 6772 7562 5f65 7272 6e6f 3b0a urn grub_errno;. │ │ │ │ │ -00008ae0: 2020 2020 2020 2020 207d 0a0a 2020 2020 }.. │ │ │ │ │ -00008af0: 2020 202f 2a20 416c 6c20 6973 204f 4b2c /* All is OK, │ │ │ │ │ -00008b00: 2064 6f20 6d6f 7265 2070 726f 6365 7373 do more process │ │ │ │ │ -00008b10: 696e 672e 2020 2a2f 0a0a 2020 2020 2020 ing. */.. │ │ │ │ │ -00008b20: 202f 2a20 5265 7475 726e 204f 4b20 7369 /* Return OK si │ │ │ │ │ -00008b30: 676e 616c 2c20 746f 2063 616c 6c65 722e gnal, to caller. │ │ │ │ │ -00008b40: 2020 2a2f 0a20 2020 2020 2020 7265 7475 */. retu │ │ │ │ │ -00008b50: 726e 2047 5255 425f 4552 525f 4e4f 4e45 rn GRUB_ERR_NONE │ │ │ │ │ -00008b60: 3b0a 2020 2020 207d 0a0a 2020 2045 7272 ;. }.. Err │ │ │ │ │ -00008b70: 6f72 2072 6570 6f72 7469 6e67 2068 6173 or reporting has │ │ │ │ │ -00008b80: 2074 776f 2063 6f6d 706f 6e65 6e74 732c two components, │ │ │ │ │ -00008b90: 2074 6865 2061 6374 7561 6c20 6572 726f the actual erro │ │ │ │ │ -00008ba0: 7220 636f 6465 2028 6f66 2074 7970 650a r code (of type. │ │ │ │ │ -00008bb0: 2767 7275 625f 6572 725f 7427 2920 616e 'grub_err_t') an │ │ │ │ │ -00008bc0: 6420 7465 7874 7561 6c20 6d65 7373 6167 d textual messag │ │ │ │ │ -00008bd0: 6520 7468 6174 2077 696c 6c20 6265 2064 e that will be d │ │ │ │ │ -00008be0: 6973 706c 6179 6564 2074 6f20 7573 6572 isplayed to user │ │ │ │ │ -00008bf0: 2e20 204c 6973 740a 6f66 2076 616c 6964 . List.of valid │ │ │ │ │ -00008c00: 2065 7272 6f72 2063 6f64 6573 2069 7320 error codes is │ │ │ │ │ -00008c10: 6c69 7374 6564 2069 6e20 6865 6164 6572 listed in header │ │ │ │ │ -00008c20: 2066 696c 6520 2769 6e63 6c75 6465 2f67 file 'include/g │ │ │ │ │ -00008c30: 7275 622f 6572 722e 6827 2e0a 5465 7874 rub/err.h'..Text │ │ │ │ │ -00008c40: 7561 6c20 6572 726f 7220 6d65 7373 6167 ual error messag │ │ │ │ │ -00008c50: 6520 6361 6e20 636f 6e74 6169 6e20 616e e can contain an │ │ │ │ │ -00008c60: 7920 7465 7874 7561 6c20 6461 7461 2e20 y textual data. │ │ │ │ │ -00008c70: 2041 7420 7469 6d65 206f 6620 7772 6974 At time of writ │ │ │ │ │ -00008c80: 696e 672c 0a65 7272 6f72 206d 6573 7361 ing,.error messa │ │ │ │ │ -00008c90: 6765 2063 616e 2063 6f6e 7461 696e 2075 ge can contain u │ │ │ │ │ -00008ca0: 7020 746f 2032 3536 2063 6861 7261 6374 p to 256 charact │ │ │ │ │ -00008cb0: 6572 7320 2869 6e63 6c75 6469 6e67 2074 ers (including t │ │ │ │ │ -00008cc0: 6572 6d69 6e61 7469 6e67 0a4e 554c 292e erminating.NUL). │ │ │ │ │ -00008cd0: 2054 6f20 6561 7365 2065 7272 6f72 2072 To ease error r │ │ │ │ │ -00008ce0: 6570 6f72 7469 6e67 2074 6865 7265 2069 eporting there i │ │ │ │ │ -00008cf0: 7320 6120 6865 6c70 6572 2066 756e 6374 s a helper funct │ │ │ │ │ -00008d00: 696f 6e20 2767 7275 625f 6572 726f 7227 ion 'grub_error' │ │ │ │ │ -00008d10: 0a74 6861 7420 616c 6c6f 7773 2065 6173 .that allows eas │ │ │ │ │ -00008d20: 6965 7220 666f 726d 6174 7469 6e67 206f ier formatting o │ │ │ │ │ -00008d30: 6620 6572 726f 7220 6d65 7373 6167 6573 f error messages │ │ │ │ │ -00008d40: 2061 6e64 2073 686f 756c 6420 6265 2075 and should be u │ │ │ │ │ -00008d50: 7365 640a 696e 7374 6561 6420 6f66 2077 sed.instead of w │ │ │ │ │ -00008d60: 7269 7469 6e67 2064 6972 6563 746c 7920 riting directly │ │ │ │ │ -00008d70: 746f 2067 6c6f 6261 6c20 7661 7269 6162 to global variab │ │ │ │ │ -00008d80: 6c65 732e 0a0a 2020 2045 7861 6d70 6c65 les... Example │ │ │ │ │ -00008d90: 206f 6620 6572 726f 7220 7265 706f 7274 of error report │ │ │ │ │ -00008da0: 696e 672e 0a20 2020 2020 6772 7562 5f65 ing.. grub_e │ │ │ │ │ -00008db0: 7272 5f74 0a20 2020 2020 6661 696c 696e rr_t. failin │ │ │ │ │ -00008dc0: 675f 6578 616d 706c 6520 2829 0a20 2020 g_example (). │ │ │ │ │ -00008dd0: 2020 7b0a 2020 2020 2020 2072 6574 7572 {. retur │ │ │ │ │ -00008de0: 6e20 6772 7562 5f65 7272 6f72 2028 4752 n grub_error (GR │ │ │ │ │ -00008df0: 5542 5f45 5252 5f46 494c 455f 4e4f 545f UB_ERR_FILE_NOT_ │ │ │ │ │ -00008e00: 464f 554e 442c 0a20 2020 2020 2020 2020 FOUND,. │ │ │ │ │ +00006a70: 2020 2020 2020 2022 6933 3836 5f6d 756c "i386_mul │ │ │ │ │ +00006a80: 7469 626f 6f74 222c 2022 6933 3836 5f69 tiboot", "i386_i │ │ │ │ │ +00006a90: 6565 6531 3237 3522 2c20 2278 3836 5f36 eee1275", "x86_6 │ │ │ │ │ +00006aa0: 345f 6566 6922 2c0a 2020 2020 2020 2020 4_efi",. │ │ │ │ │ +00006ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00006ac0: 226d 6970 735f 6c6f 6f6e 6773 6f6e 222c "mips_loongson", │ │ │ │ │ +00006ad0: 2022 7370 6172 6336 345f 6965 6565 3132 "sparc64_ieee12 │ │ │ │ │ +00006ae0: 3735 222c 0a20 2020 2020 2020 2020 2020 75",. │ │ │ │ │ +00006af0: 2020 2020 2020 2020 2020 2020 2022 706f "po │ │ │ │ │ +00006b00: 7765 7270 635f 6965 6565 3132 3735 222c werpc_ieee1275", │ │ │ │ │ +00006b10: 2022 6d69 7073 5f61 7263 222c 2022 6961 "mips_arc", "ia │ │ │ │ │ +00006b20: 3634 5f65 6669 222c 0a20 2020 2020 2020 64_efi",. │ │ │ │ │ +00006b30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00006b40: 2022 6d69 7073 5f71 656d 755f 6d69 7073 "mips_qemu_mips │ │ │ │ │ +00006b50: 222c 2022 7333 3930 5f6d 6169 6e66 7261 ", "s390_mainfra │ │ │ │ │ +00006b60: 6d65 2220 5d0a 0a20 2020 596f 7520 6d61 me" ].. You ma │ │ │ │ │ +00006b70: 7920 616c 736f 2077 616e 7420 616c 7265 y also want alre │ │ │ │ │ +00006b80: 6164 7920 746f 2061 6464 206e 6577 2070 ady to add new p │ │ │ │ │ +00006b90: 6c61 7466 6f72 6d20 746f 206f 6e65 206f latform to one o │ │ │ │ │ +00006ba0: 7220 7365 7665 7261 6c20 6f66 0a61 7661 r several of.ava │ │ │ │ │ +00006bb0: 696c 6162 6c65 2067 726f 7570 732e 2020 ilable groups. │ │ │ │ │ +00006bc0: 496e 2070 6172 7469 6375 6c61 7220 7765 In particular we │ │ │ │ │ +00006bd0: 2061 6c77 6179 7320 6861 7665 2061 2067 always have a g │ │ │ │ │ +00006be0: 726f 7570 2066 6f72 2065 6163 6820 4350 roup for each CP │ │ │ │ │ +00006bf0: 550a 6576 656e 2077 6865 6e20 6f6e 6c79 U.even when only │ │ │ │ │ +00006c00: 206f 6e65 2070 6c61 7466 6f72 6d20 666f one platform fo │ │ │ │ │ +00006c10: 7220 6769 7665 6e20 4350 5520 6973 2061 r given CPU is a │ │ │ │ │ +00006c20: 7661 696c 6162 6c65 2e0a 0a20 2020 5468 vailable... Th │ │ │ │ │ +00006c30: 656e 2063 6f6d 6573 2067 7275 622d 636f en comes grub-co │ │ │ │ │ +00006c40: 7265 2f4d 616b 6566 696c 652e 636f 7265 re/Makefile.core │ │ │ │ │ +00006c50: 2e64 6566 2e20 2049 6e20 7468 6520 626c .def. In the bl │ │ │ │ │ +00006c60: 6f63 6b20 226b 6572 6e65 6c22 2079 6f75 ock "kernel" you │ │ │ │ │ +00006c70: 276c 6c0a 6e65 6564 2074 6f20 6465 6669 'll.need to defi │ │ │ │ │ +00006c80: 6e65 206c 6466 6c61 6773 2066 6f72 2079 ne ldflags for y │ │ │ │ │ +00006c90: 6f75 7220 706c 6174 666f 726d 2028 2463 our platform ($c │ │ │ │ │ +00006ca0: 7075 5f24 706c 6174 666f 726d 5f6c 6466 pu_$platform_ldf │ │ │ │ │ +00006cb0: 6c61 6773 292e 2020 596f 750a 616c 736f lags). You.also │ │ │ │ │ +00006cc0: 206e 6565 6420 746f 2064 6563 6c61 7265 need to declare │ │ │ │ │ +00006cd0: 2073 7461 7274 7570 2061 736d 2066 696c startup asm fil │ │ │ │ │ +00006ce0: 6520 2824 6370 755f 2470 6c61 7466 6f72 e ($cpu_$platfor │ │ │ │ │ +00006cf0: 6d5f 7374 6172 7475 7029 2061 7320 7765 m_startup) as we │ │ │ │ │ +00006d00: 6c6c 0a61 7320 616e 7920 6f74 6865 7220 ll.as any other │ │ │ │ │ +00006d10: 6669 6c65 7320 2865 2e67 2e20 2069 6e69 files (e.g. ini │ │ │ │ │ +00006d20: 742e 6320 616e 6420 6361 6c6c 7772 6170 t.c and callwrap │ │ │ │ │ +00006d30: 2e53 2920 2865 2e67 2e20 2024 6370 755f .S) (e.g. $cpu_ │ │ │ │ │ +00006d40: 2470 6c61 7466 6f72 6d20 3d0a 6b65 726e $platform =.kern │ │ │ │ │ +00006d50: 2f24 6370 752f 2470 6c61 7466 6f72 6d2f /$cpu/$platform/ │ │ │ │ │ +00006d60: 696e 6974 2e63 292e 2020 4174 2074 6869 init.c). At thi │ │ │ │ │ +00006d70: 7320 7374 6167 6520 796f 7520 7769 6c6c s stage you will │ │ │ │ │ +00006d80: 2061 6c73 6f20 6e65 6564 2074 6f20 6164 also need to ad │ │ │ │ │ +00006d90: 640a 6475 6d6d 7920 646c 2e63 2061 6e64 d.dummy dl.c and │ │ │ │ │ +00006da0: 2063 6163 6865 2e53 2077 6974 6820 6675 cache.S with fu │ │ │ │ │ +00006db0: 6e63 7469 6f6e 7320 6772 7562 5f65 7272 nctions grub_err │ │ │ │ │ +00006dc0: 5f74 0a67 7275 625f 6172 6368 5f64 6c5f _t.grub_arch_dl_ │ │ │ │ │ +00006dd0: 6368 6563 6b5f 6865 6164 6572 2028 766f check_header (vo │ │ │ │ │ +00006de0: 6964 202a 6568 6472 292c 2067 7275 625f id *ehdr), grub_ │ │ │ │ │ +00006df0: 6572 725f 740a 6772 7562 5f61 7263 685f err_t.grub_arch_ │ │ │ │ │ +00006e00: 646c 5f72 656c 6f63 6174 655f 7379 6d62 dl_relocate_symb │ │ │ │ │ +00006e10: 6f6c 7320 2867 7275 625f 646c 5f74 206d ols (grub_dl_t m │ │ │ │ │ +00006e20: 6f64 2c20 766f 6964 202a 6568 6472 2920 od, void *ehdr) │ │ │ │ │ +00006e30: 2864 6c2e 6329 2061 6e64 0a76 6f69 6420 (dl.c) and.void │ │ │ │ │ +00006e40: 6772 7562 5f61 7263 685f 7379 6e63 5f63 grub_arch_sync_c │ │ │ │ │ +00006e50: 6163 6865 7320 2876 6f69 6420 2a61 6464 aches (void *add │ │ │ │ │ +00006e60: 7265 7373 2c20 6772 7562 5f73 697a 655f ress, grub_size_ │ │ │ │ │ +00006e70: 7420 6c65 6e29 2028 6361 6368 652e 5329 t len) (cache.S) │ │ │ │ │ +00006e80: 2e0a 5468 6579 2077 6f6e 2774 2062 6520 ..They won't be │ │ │ │ │ +00006e90: 7573 6564 2066 6f72 206e 6f77 2e0a 0a20 used for now... │ │ │ │ │ +00006ea0: 2020 596f 7520 7769 6c6c 206e 6565 6420 You will need │ │ │ │ │ +00006eb0: 746f 2063 7265 6174 6520 6469 7265 6374 to create direct │ │ │ │ │ +00006ec0: 6f72 7920 696e 636c 7564 652f 2463 7075 ory include/$cpu │ │ │ │ │ +00006ed0: 2f24 706c 6174 666f 726d 2061 6e64 2061 /$platform and a │ │ │ │ │ +00006ee0: 2066 696c 650a 696e 636c 7564 652f 2463 file.include/$c │ │ │ │ │ +00006ef0: 7075 2f74 7970 6573 2e68 2e20 2054 6865 pu/types.h. The │ │ │ │ │ +00006f00: 206c 6174 6572 2066 6f6c 6f77 696e 6720 later folowing │ │ │ │ │ +00006f10: 7468 6973 2074 656d 706c 6174 653a 0a0a this template:.. │ │ │ │ │ +00006f20: 2020 2020 2023 6966 6e64 6566 2047 5255 #ifndef GRU │ │ │ │ │ +00006f30: 425f 5459 5045 535f 4350 555f 4845 4144 B_TYPES_CPU_HEAD │ │ │ │ │ +00006f40: 4552 0a20 2020 2020 2364 6566 696e 6520 ER. #define │ │ │ │ │ +00006f50: 4752 5542 5f54 5950 4553 5f43 5055 5f48 GRUB_TYPES_CPU_H │ │ │ │ │ +00006f60: 4541 4445 5209 310a 0a20 2020 2020 2f2a EADER.1.. /* │ │ │ │ │ +00006f70: 2054 6865 2073 697a 6520 6f66 2076 6f69 The size of voi │ │ │ │ │ +00006f80: 6420 2a2e 2020 2a2f 0a20 2020 2020 2364 d *. */. #d │ │ │ │ │ +00006f90: 6566 696e 6520 4752 5542 5f54 4152 4745 efine GRUB_TARGE │ │ │ │ │ +00006fa0: 545f 5349 5a45 4f46 5f56 4f49 445f 5009 T_SIZEOF_VOID_P. │ │ │ │ │ +00006fb0: 340a 0a20 2020 2020 2f2a 2054 6865 2073 4.. /* The s │ │ │ │ │ +00006fc0: 697a 6520 6f66 206c 6f6e 672e 2020 2a2f ize of long. */ │ │ │ │ │ +00006fd0: 0a20 2020 2020 2364 6566 696e 6520 4752 . #define GR │ │ │ │ │ +00006fe0: 5542 5f54 4152 4745 545f 5349 5a45 4f46 UB_TARGET_SIZEOF │ │ │ │ │ +00006ff0: 5f4c 4f4e 4709 0934 0a0a 2020 2020 202f _LONG..4.. / │ │ │ │ │ +00007000: 2a20 6d79 6370 7520 6973 2062 6967 2d65 * mycpu is big-e │ │ │ │ │ +00007010: 6e64 6961 6e2e 2020 2a2f 0a20 2020 2020 ndian. */. │ │ │ │ │ +00007020: 2364 6566 696e 6520 4752 5542 5f54 4152 #define GRUB_TAR │ │ │ │ │ +00007030: 4745 545f 574f 5244 535f 4249 4745 4e44 GET_WORDS_BIGEND │ │ │ │ │ +00007040: 4941 4e09 310a 2020 2020 202f 2a20 416c IAN.1. /* Al │ │ │ │ │ +00007050: 7465 726e 6174 6976 656c 793a 206d 7963 ternatively: myc │ │ │ │ │ +00007060: 7075 2069 7320 6c69 7474 6c65 2d65 6e64 pu is little-end │ │ │ │ │ +00007070: 6961 6e2e 2020 2a2f 0a20 2020 2020 2375 ian. */. #u │ │ │ │ │ +00007080: 6e64 6566 2047 5255 425f 5441 5247 4554 ndef GRUB_TARGET │ │ │ │ │ +00007090: 5f57 4f52 4453 5f42 4947 454e 4449 414e _WORDS_BIGENDIAN │ │ │ │ │ +000070a0: 0a0a 2020 2020 2023 656e 6469 6620 2f2a .. #endif /* │ │ │ │ │ +000070b0: 2021 2047 5255 425f 5459 5045 535f 4350 ! GRUB_TYPES_CP │ │ │ │ │ +000070c0: 555f 4845 4144 4552 202a 2f0a 0a20 2020 U_HEADER */.. │ │ │ │ │ +000070d0: 596f 7520 7769 6c6c 2061 6c73 6f20 6e65 You will also ne │ │ │ │ │ +000070e0: 6564 2074 6f20 6164 6420 6120 6475 6d6d ed to add a dumm │ │ │ │ │ +000070f0: 7920 6669 6c65 2074 6f20 6461 7465 7469 y file to dateti │ │ │ │ │ +00007100: 6d65 2061 6e64 2073 6574 6a6d 7020 6d6f me and setjmp mo │ │ │ │ │ +00007110: 6475 6c65 730a 746f 2061 766f 6964 2061 dules.to avoid a │ │ │ │ │ +00007120: 6e79 206f 6620 6974 2068 6176 696e 6720 ny of it having │ │ │ │ │ +00007130: 6e6f 2066 696c 6573 2e20 2049 7420 6361 no files. It ca │ │ │ │ │ +00007140: 6e20 6265 206a 7573 7420 636f 6d70 6c65 n be just comple │ │ │ │ │ +00007150: 7465 6c79 2065 6d70 7479 2061 740a 7468 tely empty at.th │ │ │ │ │ +00007160: 6973 2073 7461 6765 2e0a 0a20 2020 596f is stage... Yo │ │ │ │ │ +00007170: 7527 6c6c 206e 6565 6420 746f 206d 616b u'll need to mak │ │ │ │ │ +00007180: 6520 6772 7562 2d6d 6b69 6d61 6765 2e63 e grub-mkimage.c │ │ │ │ │ +00007190: 2028 7574 696c 2f67 7275 625f 6d6b 696d (util/grub_mkim │ │ │ │ │ +000071a0: 6167 652e 6329 2061 7761 7265 206f 6620 age.c) aware of │ │ │ │ │ +000071b0: 7468 650a 6e65 6564 6564 2066 6f72 6d61 the.needed forma │ │ │ │ │ +000071c0: 742e 2020 466f 7220 6d6f 7374 2063 6f6d t. For most com │ │ │ │ │ +000071d0: 6d6f 6e6c 7920 7573 6564 2066 6f72 6d61 monly used forma │ │ │ │ │ +000071e0: 7473 206c 696b 6520 454c 462c 2050 452c ts like ELF, PE, │ │ │ │ │ +000071f0: 2061 6f75 7420 6f72 2072 6177 0a74 6865 aout or raw.the │ │ │ │ │ +00007200: 2073 7570 706f 7274 2069 7320 616c 7265 support is alre │ │ │ │ │ +00007210: 6164 7920 7072 6573 656e 7420 616e 6420 ady present and │ │ │ │ │ +00007220: 796f 7527 6c6c 206e 6565 6420 746f 206d you'll need to m │ │ │ │ │ +00007230: 616b 6520 6974 2066 6f6c 6c6f 7720 7468 ake it follow th │ │ │ │ │ +00007240: 650a 6578 6973 7461 6e74 2063 6f64 6520 e.existant code │ │ │ │ │ +00007250: 7061 7468 7320 666f 7220 796f 7572 2070 paths for your p │ │ │ │ │ +00007260: 6c61 7466 6f72 6d20 6164 6469 6e67 2061 latform adding a │ │ │ │ │ +00007270: 646a 7573 746d 656e 7473 2069 6620 6e65 djustments if ne │ │ │ │ │ +00007280: 6365 7373 6172 792e 0a57 6865 6e20 646f cessary..When do │ │ │ │ │ +00007290: 6e65 2063 6f6d 7069 6c65 3a0a 0a20 2020 ne compile:.. │ │ │ │ │ +000072a0: 2020 2e2f 626f 6f74 7374 7261 700a 2020 ./bootstrap. │ │ │ │ │ +000072b0: 2020 202e 2f63 6f6e 6669 6775 7265 202d ./configure - │ │ │ │ │ +000072c0: 2d74 6172 6765 743d 2463 7075 202d 2d77 -target=$cpu --w │ │ │ │ │ +000072d0: 6974 682d 706c 6174 666f 726d 3d24 706c ith-platform=$pl │ │ │ │ │ +000072e0: 6174 666f 726d 2054 4152 4745 545f 4343 atform TARGET_CC │ │ │ │ │ +000072f0: 3d2e 2e20 4f42 4a43 4f50 593d 2e2e 2e20 =.. OBJCOPY=... │ │ │ │ │ +00007300: 5354 5249 503d 2e2e 2e0a 2020 2020 206d STRIP=.... m │ │ │ │ │ +00007310: 616b 6520 3e20 2f64 6576 2f6e 756c 6c0a ake > /dev/null. │ │ │ │ │ +00007320: 0a20 2020 416e 6420 6372 6561 7465 2069 . And create i │ │ │ │ │ +00007330: 6d61 6765 0a0a 2020 2020 202e 2f67 7275 mage.. ./gru │ │ │ │ │ +00007340: 622d 6d6b 696d 6167 6520 2d64 2067 7275 b-mkimage -d gru │ │ │ │ │ +00007350: 622d 636f 7265 202d 4f20 2466 6f72 6d61 b-core -O $forma │ │ │ │ │ +00007360: 745f 6964 202d 6f20 7465 7374 2e69 6d67 t_id -o test.img │ │ │ │ │ +00007370: 0a0a 2020 2041 6e64 2069 7427 7320 7469 .. And it's ti │ │ │ │ │ +00007380: 6d65 2074 6f20 7465 7374 2079 6f75 7220 me to test your │ │ │ │ │ +00007390: 7465 7374 2e69 6d67 2e0a 0a20 2020 4966 test.img... If │ │ │ │ │ +000073a0: 2069 7420 776f 726b 7320 6e65 7874 2073 it works next s │ │ │ │ │ +000073b0: 7461 6765 2069 7320 746f 2068 6176 6520 tage is to have │ │ │ │ │ +000073c0: 6865 6170 2c20 636f 6e73 6f6c 6520 616e heap, console an │ │ │ │ │ +000073d0: 6420 7469 6d65 722e 0a0a 2020 2054 6f20 d timer... To │ │ │ │ │ +000073e0: 6861 7665 2074 6865 2068 6561 7020 776f have the heap wo │ │ │ │ │ +000073f0: 726b 696e 6720 796f 7520 6e65 6564 2074 rking you need t │ │ │ │ │ +00007400: 6f20 6465 7465 726d 696e 6520 7768 6963 o determine whic │ │ │ │ │ +00007410: 6820 7265 6769 6f6e 7320 6172 650a 7375 h regions are.su │ │ │ │ │ +00007420: 6974 6162 6c65 2066 6f72 2068 6561 7020 itable for heap │ │ │ │ │ +00007430: 7573 6167 652c 2061 6c6c 6f63 6174 6520 usage, allocate │ │ │ │ │ +00007440: 7468 656d 2066 726f 6d20 6669 726d 7761 them from firmwa │ │ │ │ │ +00007450: 7265 2061 6e64 206d 6170 2028 6966 0a61 re and map (if.a │ │ │ │ │ +00007460: 7070 6c69 6361 626c 6529 2e20 2054 6865 pplicable). The │ │ │ │ │ +00007470: 6e20 6361 6c6c 2067 7275 625f 6d6d 5f69 n call grub_mm_i │ │ │ │ │ +00007480: 6e69 745f 7265 6769 6f6e 2028 766f 6973 nit_region (vois │ │ │ │ │ +00007490: 202a 7374 6172 742c 2067 7275 625f 7369 *start, grub_si │ │ │ │ │ +000074a0: 7a65 5f74 2073 290a 666f 7220 6576 6572 ze_t s).for ever │ │ │ │ │ +000074b0: 7920 6f66 2074 6869 7320 7265 6769 6f6e y of this region │ │ │ │ │ +000074c0: 2e20 2041 7320 6120 7368 6f72 7463 7574 . As a shortcut │ │ │ │ │ +000074d0: 2066 6f72 2065 6172 6c79 2070 6f72 7420 for early port │ │ │ │ │ +000074e0: 796f 7520 6361 6e20 616c 6c6f 6361 7465 you can allocate │ │ │ │ │ +000074f0: 0a72 6967 6874 2061 6674 6572 205f 656e .right after _en │ │ │ │ │ +00007500: 6420 6f72 2068 6176 6520 6120 6269 6720 d or have a big │ │ │ │ │ +00007510: 7374 6174 6963 2061 7272 6179 2066 6f72 static array for │ │ │ │ │ +00007520: 2068 6561 702e 2020 4966 2079 6f75 2064 heap. If you d │ │ │ │ │ +00007530: 6f20 796f 7527 6c6c 0a70 726f 6261 626c o you'll.probabl │ │ │ │ │ +00007540: 7920 6e65 6564 2074 6f20 636f 6d65 2062 y need to come b │ │ │ │ │ +00007550: 6163 6b20 746f 2074 6869 7320 6c61 7465 ack to this late │ │ │ │ │ +00007560: 722e 2020 4173 2066 6f72 206f 7574 7075 r. As for outpu │ │ │ │ │ +00007570: 7420 636f 6e73 6f6c 6520 796f 750a 7368 t console you.sh │ │ │ │ │ +00007580: 6f75 6c64 2064 6973 7469 6e67 7569 7368 ould distinguish │ │ │ │ │ +00007590: 2062 6574 7765 656e 2061 6e20 6172 7261 between an arra │ │ │ │ │ +000075a0: 7920 6f66 2074 6578 742c 2074 6572 6d69 y of text, termi │ │ │ │ │ +000075b0: 6e66 6f20 6f72 2067 7261 7068 6963 732d nfo or graphics- │ │ │ │ │ +000075c0: 6261 7365 640a 636f 6e73 6f6c 652e 2020 based.console. │ │ │ │ │ +000075d0: 4d61 6e79 206f 6620 7265 616c 2d77 6f72 Many of real-wor │ │ │ │ │ +000075e0: 6c64 2065 7861 6d70 6c65 7320 646f 6e27 ld examples don' │ │ │ │ │ +000075f0: 7420 6669 7420 7065 7266 6563 746c 7920 t fit perfectly │ │ │ │ │ +00007600: 696e 746f 2061 6e79 206f 660a 7468 6573 into any of.thes │ │ │ │ │ +00007610: 6520 6361 7465 676f 7269 6573 2062 7574 e categories but │ │ │ │ │ +00007620: 206f 6e65 206f 6620 7468 6520 6d6f 6465 one of the mode │ │ │ │ │ +00007630: 6c73 2069 7320 6561 7369 6572 2074 6f20 ls is easier to │ │ │ │ │ +00007640: 6265 2075 7365 6420 6173 2062 6173 652e be used as base. │ │ │ │ │ +00007650: 2020 496e 0a73 6563 6f6e 6420 616e 6420 In.second and │ │ │ │ │ +00007660: 7468 6972 6420 6361 7365 2079 6f75 2073 third case you s │ │ │ │ │ +00007670: 686f 756c 6420 6164 6420 796f 7572 2070 hould add your p │ │ │ │ │ +00007680: 6c61 7466 6f72 6d20 746f 2074 6572 6d69 latform to termi │ │ │ │ │ +00007690: 6e66 6f6b 6572 6e65 6c0a 7265 7370 6563 nfokernel.respec │ │ │ │ │ +000076a0: 7469 7665 6c79 2076 6964 656f 696e 6b65 tively videoinke │ │ │ │ │ +000076b0: 726e 656c 2067 726f 7570 2e20 2041 2067 rnel group. A g │ │ │ │ │ +000076c0: 6f6f 6420 6578 616d 706c 6520 6f66 2061 ood example of a │ │ │ │ │ +000076d0: 7272 6179 206f 6620 7465 7874 2069 730a rray of text is. │ │ │ │ │ +000076e0: 6933 3836 2d70 6320 286b 6572 6e2f 6933 i386-pc (kern/i3 │ │ │ │ │ +000076f0: 3836 2f70 632f 696e 6974 2e63 2061 6e64 86/pc/init.c and │ │ │ │ │ +00007700: 2074 6572 6d2f 6933 3836 2f70 632f 636f term/i386/pc/co │ │ │ │ │ +00007710: 6e73 6f6c 652e 6329 2e20 204f 6620 7465 nsole.c). Of te │ │ │ │ │ +00007720: 726d 696e 666f 0a69 7320 6965 6565 3132 rminfo.is ieee12 │ │ │ │ │ +00007730: 3735 2028 6b65 726e 2f69 6565 6531 3237 75 (kern/ieee127 │ │ │ │ │ +00007740: 352f 696e 6974 2e63 2061 6e64 2074 6572 5/init.c and ter │ │ │ │ │ +00007750: 6d2f 6965 6565 3132 3735 2f63 6f6e 736f m/ieee1275/conso │ │ │ │ │ +00007760: 6c65 2e63 292e 2020 4f66 0a76 6964 656f le.c). Of.video │ │ │ │ │ +00007770: 2069 7320 6c6f 6f6e 6773 6f6e 2028 6b65 is loongson (ke │ │ │ │ │ +00007780: 726e 2f6d 6970 732f 6c6f 6f6e 6773 6f6e rn/mips/loongson │ │ │ │ │ +00007790: 2f69 6e69 742e 6329 2e20 204e 6f74 6520 /init.c). Note │ │ │ │ │ +000077a0: 7468 6174 2074 6572 6d69 6e66 6f20 6861 that terminfo ha │ │ │ │ │ +000077b0: 730a 746f 2062 6520 696e 6974 6564 2069 s.to be inited i │ │ │ │ │ +000077c0: 6e20 3220 7374 6167 6573 3a20 6f6e 6520 n 2 stages: one │ │ │ │ │ +000077d0: 6265 666f 7265 2028 746f 2067 6574 2061 before (to get a │ │ │ │ │ +000077e0: 7420 6c65 6173 7420 7275 6469 6d65 6e74 t least rudiment │ │ │ │ │ +000077f0: 6172 790a 636f 6e73 6f6c 6520 6173 2065 ary.console as e │ │ │ │ │ +00007800: 6172 6c79 2061 7320 706f 7373 6962 6c65 arly as possible │ │ │ │ │ +00007810: 2920 616e 6420 616e 6f74 6865 7220 6166 ) and another af │ │ │ │ │ +00007820: 7465 7220 7468 6520 6865 6170 2028 746f ter the heap (to │ │ │ │ │ +00007830: 2067 6574 0a66 756c 6c2d 6665 6174 7572 get.full-featur │ │ │ │ │ +00007840: 6564 2063 6f6e 736f 6c65 292e 2020 466f ed console). Fo │ │ │ │ │ +00007850: 7220 7468 6520 696e 7075 7420 7468 6572 r the input ther │ │ │ │ │ +00007860: 6520 6172 6520 7374 7269 6e67 206f 6620 e are string of │ │ │ │ │ +00007870: 6b65 7973 2c0a 7465 726d 696e 666f 2061 keys,.terminfo a │ │ │ │ │ +00007880: 6e64 2064 6972 6563 7420 6861 7264 7761 nd direct hardwa │ │ │ │ │ +00007890: 7265 2e20 2046 6f72 2073 7472 696e 6720 re. For string │ │ │ │ │ +000078a0: 6f66 206b 6579 7320 6c6f 6f6b 2061 7420 of keys look at │ │ │ │ │ +000078b0: 6933 3836 2d70 6320 2873 616d 650a 6669 i386-pc (same.fi │ │ │ │ │ +000078c0: 6c65 7329 2c20 666f 7220 7465 726d 696e les), for termin │ │ │ │ │ +000078d0: 666f 2069 6565 6531 3237 3520 2873 616d fo ieee1275 (sam │ │ │ │ │ +000078e0: 6520 6669 6c65 7329 2061 6e64 2066 6f72 e files) and for │ │ │ │ │ +000078f0: 2068 6172 6477 6172 6520 6c6f 6f6e 6773 hardware loongs │ │ │ │ │ +00007900: 6f6e 0a28 6b65 726e 2f6d 6970 732f 6c6f on.(kern/mips/lo │ │ │ │ │ +00007910: 6f6e 6773 6f6e 2f69 6e69 742e 6320 616e ongson/init.c an │ │ │ │ │ +00007920: 6420 7465 726d 2f61 745f 6b65 7962 6f61 d term/at_keyboa │ │ │ │ │ +00007930: 7264 2e63 292e 0a0a 2020 2046 6f72 2074 rd.c)... For t │ │ │ │ │ +00007940: 6865 2074 696d 6572 2079 6f75 276c 6c20 he timer you'll │ │ │ │ │ +00007950: 6e65 6564 2074 6f20 6361 6c6c 2067 7275 need to call gru │ │ │ │ │ +00007960: 625f 696e 7374 616c 6c5f 6765 745f 7469 b_install_get_ti │ │ │ │ │ +00007970: 6d65 5f6d 7320 282e 2e2e 290a 7769 7468 me_ms (...).with │ │ │ │ │ +00007980: 2061 7320 736f 6c65 2061 7267 756d 656e as sole argumen │ │ │ │ │ +00007990: 7420 6120 6675 6e63 7469 6f6e 2072 6574 t a function ret │ │ │ │ │ +000079a0: 7572 6e69 6e67 2061 2067 7275 625f 7569 urning a grub_ui │ │ │ │ │ +000079b0: 6e74 3634 5f74 206f 6620 6120 6e75 6d62 nt64_t of a numb │ │ │ │ │ +000079c0: 6572 0a6f 6620 6d69 6c6c 6973 6563 6f6e er.of millisecon │ │ │ │ │ +000079d0: 6473 2065 6c61 7073 6564 2073 696e 6365 ds elapsed since │ │ │ │ │ +000079e0: 2061 7262 6974 7261 7279 2070 6f69 6e74 arbitrary point │ │ │ │ │ +000079f0: 2069 6e20 7468 6520 7061 7374 2e0a 0a20 in the past... │ │ │ │ │ +00007a00: 2020 4f6e 6365 2074 6865 7365 2073 7465 Once these ste │ │ │ │ │ +00007a10: 7073 2061 6363 6f6d 706c 6973 6865 6420 ps accomplished │ │ │ │ │ +00007a20: 796f 7520 6361 6e20 7265 6d6f 7665 2074 you can remove t │ │ │ │ │ +00007a30: 6865 2069 6e69 6669 6e69 7465 206c 6f6f he inifinite loo │ │ │ │ │ +00007a40: 7020 616e 640a 796f 7520 7368 6f75 6c64 p and.you should │ │ │ │ │ +00007a50: 2062 6520 6162 6c65 2074 6f20 6765 7420 be able to get │ │ │ │ │ +00007a60: 746f 2074 6865 206d 696e 696d 616c 2063 to the minimal c │ │ │ │ │ +00007a70: 6f6e 736f 6c65 2e20 204e 6578 7420 7374 onsole. Next st │ │ │ │ │ +00007a80: 6570 2069 7320 746f 2068 6176 650a 6d6f ep is to have.mo │ │ │ │ │ +00007a90: 6475 6c65 206c 6f61 6469 6e67 2077 6f72 dule loading wor │ │ │ │ │ +00007aa0: 6b69 6e67 2e20 2046 6f72 2074 6869 7320 king. For this │ │ │ │ │ +00007ab0: 796f 7527 6c6c 206e 6565 6420 746f 2066 you'll need to f │ │ │ │ │ +00007ac0: 696c 6c20 6b65 726e 2f24 6370 752f 646c ill kern/$cpu/dl │ │ │ │ │ +00007ad0: 2e63 2061 6e64 0a6b 6572 6e2f 2463 7075 .c and.kern/$cpu │ │ │ │ │ +00007ae0: 2f63 6163 6865 2e53 2077 6974 6820 7265 /cache.S with re │ │ │ │ │ +00007af0: 616c 2068 616e 646c 696e 6720 6f66 2072 al handling of r │ │ │ │ │ +00007b00: 656c 6f63 6174 696f 6e73 2061 6e64 2072 elocations and r │ │ │ │ │ +00007b10: 6573 7065 6374 6976 656c 7920 7468 650a espectively the. │ │ │ │ │ +00007b20: 7265 616c 2073 796e 6320 6f66 2049 2061 real sync of I a │ │ │ │ │ +00007b30: 6e64 2044 2063 6163 6865 732e 2020 416c nd D caches. Al │ │ │ │ │ +00007b40: 736f 2079 6f75 276c 6c20 6e65 6564 2074 so you'll need t │ │ │ │ │ +00007b50: 6f20 6465 6369 6465 2077 6865 7265 2069 o decide where i │ │ │ │ │ +00007b60: 6e20 7468 650a 696d 6167 6520 746f 2073 n the.image to s │ │ │ │ │ +00007b70: 746f 7265 2074 6865 206d 6f64 756c 6573 tore the modules │ │ │ │ │ +00007b80: 2e20 2055 7375 616c 2077 6179 2069 7320 . Usual way is │ │ │ │ │ +00007b90: 746f 2068 6176 6520 6974 2063 6f6e 6361 to have it conca │ │ │ │ │ +00007ba0: 7465 6e61 7465 6420 6174 2074 6865 0a65 tenated at the.e │ │ │ │ │ +00007bb0: 6e64 2e20 2049 6e20 7468 6973 2063 6173 nd. In this cas │ │ │ │ │ +00007bc0: 6520 796f 7527 6c6c 206e 6565 6420 746f e you'll need to │ │ │ │ │ +00007bd0: 206d 6f64 6966 7920 7374 6172 7475 702e modify startup. │ │ │ │ │ +00007be0: 5320 746f 2063 6f70 7920 6d6f 6475 6c65 S to copy module │ │ │ │ │ +00007bf0: 7320 6f75 740a 6f66 2062 7373 2074 6f20 s out.of bss to │ │ │ │ │ +00007c00: 6c65 7427 7320 7361 7920 414c 4947 4e5f let's say ALIGN_ │ │ │ │ │ +00007c10: 5550 2028 5f65 6e64 2c20 3829 2062 6566 UP (_end, 8) bef │ │ │ │ │ +00007c20: 6f72 6520 636c 6561 6e69 6e67 206f 7574 ore cleaning out │ │ │ │ │ +00007c30: 2062 7373 2e20 2059 6f75 276c 6c0a 7072 bss. You'll.pr │ │ │ │ │ +00007c40: 6f62 6162 6c79 2066 696e 6420 7573 6566 obably find usef │ │ │ │ │ +00007c50: 756c 2074 6f20 6164 6420 746f 7461 6c5f ul to add total_ │ │ │ │ │ +00007c60: 6d6f 6475 6c65 5f73 697a 6520 6669 656c module_size fiel │ │ │ │ │ +00007c70: 6420 746f 2073 7461 7274 7570 2e53 2e20 d to startup.S. │ │ │ │ │ +00007c80: 496e 0a69 6e69 742e 6320 796f 7520 6e65 In.init.c you ne │ │ │ │ │ +00007c90: 6564 2074 6f20 7365 7420 6772 7562 5f6d ed to set grub_m │ │ │ │ │ +00007ca0: 6f64 6261 7365 2074 6f20 7468 6520 6164 odbase to the ad │ │ │ │ │ +00007cb0: 6472 6573 7320 7768 6572 6520 6d6f 6475 dress where modu │ │ │ │ │ +00007cc0: 6c65 7320 6361 6e20 6265 0a66 6f75 6e64 les can be.found │ │ │ │ │ +00007cd0: 2e20 2059 6f75 206d 6179 206e 6565 6420 . You may need │ │ │ │ │ +00007ce0: 6772 7562 5f6d 6f64 756c 6573 5f67 6574 grub_modules_get │ │ │ │ │ +00007cf0: 5f65 6e64 2028 2920 746f 2061 766f 6964 _end () to avoid │ │ │ │ │ +00007d00: 2064 6563 6c61 7269 6e67 2074 6865 0a73 declaring the.s │ │ │ │ │ +00007d10: 7061 6365 206f 6363 7570 6965 6420 6279 pace occupied by │ │ │ │ │ +00007d20: 206d 6f64 756c 6573 2061 7320 7573 6162 modules as usab │ │ │ │ │ +00007d30: 6c65 2066 6f72 2068 6561 702e 2020 596f le for heap. Yo │ │ │ │ │ +00007d40: 7520 6361 6e20 7465 7374 206d 6f64 756c u can test modul │ │ │ │ │ +00007d50: 6573 0a77 6974 683a 0a0a 2020 2020 202e es.with:.. . │ │ │ │ │ +00007d60: 2f67 7275 622d 6d6b 696d 6167 6520 2d64 /grub-mkimage -d │ │ │ │ │ +00007d70: 2067 7275 622d 636f 7265 202d 4f20 2466 grub-core -O $f │ │ │ │ │ +00007d80: 6f72 6d61 745f 6964 202d 6f20 7465 7374 ormat_id -o test │ │ │ │ │ +00007d90: 2e69 6d67 2068 656c 6c6f 0a0a 2020 2061 .img hello.. a │ │ │ │ │ +00007da0: 6e64 2074 6865 6e20 7275 6e6e 696e 6720 nd then running │ │ │ │ │ +00007db0: 2268 656c 6c6f 2220 696e 2074 6865 2073 "hello" in the s │ │ │ │ │ +00007dc0: 6865 6c6c 2e0a 0a20 2020 4f6e 6365 2074 hell... Once t │ │ │ │ │ +00007dd0: 6869 7320 776f 726b 732c 2079 6f75 2073 his works, you s │ │ │ │ │ +00007de0: 686f 756c 6420 7468 696e 6b20 6f66 2069 hould think of i │ │ │ │ │ +00007df0: 6d70 6c65 6d65 6e74 696e 6720 6469 736b mplementing disk │ │ │ │ │ +00007e00: 2061 6363 6573 732e 2020 4c6f 6f6b 0a61 access. Look.a │ │ │ │ │ +00007e10: 726f 756e 6420 6469 736b 2f20 666f 7220 round disk/ for │ │ │ │ │ +00007e20: 6578 616d 706c 6573 2e0a 0a20 2020 5468 examples... Th │ │ │ │ │ +00007e30: 656e 2c20 7665 7279 2069 6d70 6f72 7461 en, very importa │ │ │ │ │ +00007e40: 6e74 6c79 2c20 796f 7520 7072 6f62 6162 ntly, you probab │ │ │ │ │ +00007e50: 6c79 206e 6565 6420 746f 2069 6d70 6c65 ly need to imple │ │ │ │ │ +00007e60: 6d65 6e74 2074 6865 2061 6374 7561 6c0a ment the actual. │ │ │ │ │ +00007e70: 6c6f 6164 6572 2028 6578 616d 706c 6573 loader (examples │ │ │ │ │ +00007e80: 2061 7661 696c 6162 6c65 2069 6e20 6c6f available in lo │ │ │ │ │ +00007e90: 6164 6572 2f29 0a0a 2020 204c 6173 7420 ader/).. Last │ │ │ │ │ +00007ea0: 7374 6570 2074 6f20 6861 7665 206d 696e step to have min │ │ │ │ │ +00007eb0: 696d 616c 6c79 2075 7361 626c 6520 706f imally usable po │ │ │ │ │ +00007ec0: 7274 2069 7320 746f 2061 6464 2073 7570 rt is to add sup │ │ │ │ │ +00007ed0: 706f 7274 2074 6f0a 6772 7562 2d69 6e73 port to.grub-ins │ │ │ │ │ +00007ee0: 7461 6c6c 2074 6f20 7075 7420 4752 5542 tall to put GRUB │ │ │ │ │ +00007ef0: 2069 6e20 6120 706c 6163 6520 7768 6572 in a place wher │ │ │ │ │ +00007f00: 6520 6669 726d 7761 7265 206f 7220 706c e firmware or pl │ │ │ │ │ +00007f10: 6174 666f 726d 2077 696c 6c20 7069 636b atform will pick │ │ │ │ │ +00007f20: 0a69 7420 7570 2e0a 0a20 2020 4e65 7874 .it up... Next │ │ │ │ │ +00007f30: 2073 7465 7073 2061 7265 3a20 6669 6c6c steps are: fill │ │ │ │ │ +00007f40: 696e 6720 6461 7465 7469 6d65 2e63 2c20 ing datetime.c, │ │ │ │ │ +00007f50: 7365 746a 6d70 2e53 2c20 6e65 7477 6f72 setjmp.S, networ │ │ │ │ │ +00007f60: 6b20 286e 6574 2f64 7269 7665 7273 292c k (net/drivers), │ │ │ │ │ +00007f70: 0a76 6964 656f 2028 7669 6465 6f2f 292c .video (video/), │ │ │ │ │ +00007f80: 2068 616c 7420 286c 6962 2f29 2c20 7265 halt (lib/), re │ │ │ │ │ +00007f90: 626f 6f74 2028 6c69 622f 292e 0a0a 2020 boot (lib/)... │ │ │ │ │ +00007fa0: 2050 6c65 6173 6520 6164 6420 796f 7572 Please add your │ │ │ │ │ +00007fb0: 2070 6c61 7466 6f72 6d20 746f 2050 6c61 platform to Pla │ │ │ │ │ +00007fc0: 7466 6f72 6d20 6c69 6d69 7461 7469 6f6e tform limitation │ │ │ │ │ +00007fd0: 7320 616e 6420 5375 7070 6f72 7465 640a s and Supported. │ │ │ │ │ +00007fe0: 6b65 726e 656c 7320 6368 6170 7465 7220 kernels chapter │ │ │ │ │ +00007ff0: 696e 2075 7365 7220 646f 6375 6d65 6e74 in user document │ │ │ │ │ +00008000: 6174 696f 6e20 616e 6420 6d65 6e74 696f ation and mentio │ │ │ │ │ +00008010: 6e20 616e 7920 7374 6570 7320 796f 7520 n any steps you │ │ │ │ │ +00008020: 736b 6970 7065 640a 7768 6963 6820 7265 skipped.which re │ │ │ │ │ +00008030: 7375 6c74 2069 6e20 7265 6475 6365 6420 sult in reduced │ │ │ │ │ +00008040: 6665 6174 7572 6573 206f 7220 7065 7266 features or perf │ │ │ │ │ +00008050: 6f72 6d61 6e63 652e 2020 4865 7265 2069 ormance. Here i │ │ │ │ │ +00008060: 7320 7468 6520 7175 6963 6b0a 6368 6563 s the quick.chec │ │ │ │ │ +00008070: 6b6c 6973 7420 6f66 2066 6561 7475 7265 klist of feature │ │ │ │ │ +00008080: 732e 2020 536f 6d65 206f 6620 7468 656d s. Some of them │ │ │ │ │ +00008090: 2061 7265 206c 6573 7320 696d 706f 7274 are less import │ │ │ │ │ +000080a0: 616e 7420 7468 616e 206f 7468 6572 7320 ant than others │ │ │ │ │ +000080b0: 616e 640a 736b 6970 7069 6e67 2074 6865 and.skipping the │ │ │ │ │ +000080c0: 6d20 6973 2063 6f6d 706c 6574 656c 7920 m is completely │ │ │ │ │ +000080d0: 6f6b 2c20 6a75 7374 206e 6565 6473 2074 ok, just needs t │ │ │ │ │ +000080e0: 6f20 6265 206d 656e 7469 6f6e 6564 2069 o be mentioned i │ │ │ │ │ +000080f0: 6e20 7573 6572 0a64 6f63 756d 656e 7461 n user.documenta │ │ │ │ │ +00008100: 7469 6f6e 2e0a 0a20 2020 4368 6563 6b6c tion... Checkl │ │ │ │ │ +00008110: 6973 743a 0a20 2020 2a20 4973 2068 6561 ist:. * Is hea │ │ │ │ │ +00008120: 7020 6269 6720 656e 6f75 6768 3f0a 2020 p big enough?. │ │ │ │ │ +00008130: 202a 2057 6869 6368 2063 6861 7273 6574 * Which charset │ │ │ │ │ +00008140: 2069 7320 7375 7070 6f72 7465 6420 6279 is supported by │ │ │ │ │ +00008150: 2063 6f6e 736f 6c65 3f0a 2020 202a 2044 console?. * D │ │ │ │ │ +00008160: 6f65 7320 706c 6174 666f 726d 2068 6176 oes platform hav │ │ │ │ │ +00008170: 6520 6469 736b 2064 7269 7665 723f 0a20 e disk driver?. │ │ │ │ │ +00008180: 2020 2a20 446f 2079 6f75 2068 6176 6520 * Do you have │ │ │ │ │ +00008190: 6e65 7477 6f72 6b20 6361 7264 2073 7570 network card sup │ │ │ │ │ +000081a0: 706f 7274 3f0a 2020 202a 2041 7265 2079 port?. * Are y │ │ │ │ │ +000081b0: 6f75 2061 626c 6520 746f 2072 6574 7269 ou able to retri │ │ │ │ │ +000081c0: 6576 6520 6461 7465 7469 6d65 2028 7769 eve datetime (wi │ │ │ │ │ +000081d0: 7468 2064 6174 6529 3f0a 2020 202a 2041 th date)?. * A │ │ │ │ │ +000081e0: 7265 2079 6f75 2061 626c 6520 746f 2073 re you able to s │ │ │ │ │ +000081f0: 6574 2064 6174 6574 696d 6520 2877 6974 et datetime (wit │ │ │ │ │ +00008200: 6820 6461 7465 293f 0a20 2020 2a20 4973 h date)?. * Is │ │ │ │ │ +00008210: 2073 6572 6961 6c20 7375 7070 6f72 7465 serial supporte │ │ │ │ │ +00008220: 643f 0a20 2020 2a20 446f 2079 6f75 2068 d?. * Do you h │ │ │ │ │ +00008230: 6176 6520 6469 7265 6374 2064 6973 6b20 ave direct disk │ │ │ │ │ +00008240: 7375 7070 6f72 743f 0a20 2020 2a20 446f support?. * Do │ │ │ │ │ +00008250: 2079 6f75 2068 6176 6520 6469 7265 6374 you have direct │ │ │ │ │ +00008260: 206b 6579 626f 6172 6420 7375 7070 6f72 keyboard suppor │ │ │ │ │ +00008270: 743f 0a20 2020 2a20 446f 2079 6f75 2068 t?. * Do you h │ │ │ │ │ +00008280: 6176 6520 5553 4220 7375 7070 6f72 743f ave USB support? │ │ │ │ │ +00008290: 0a20 2020 2a20 446f 2079 6f75 2073 7570 . * Do you sup │ │ │ │ │ +000082a0: 706f 7274 206c 6f61 6469 6e67 2074 6872 port loading thr │ │ │ │ │ +000082b0: 6f75 6768 206e 6574 776f 726b 3f0a 2020 ough network?. │ │ │ │ │ +000082c0: 202a 2044 6f20 796f 7520 7375 7070 6f72 * Do you suppor │ │ │ │ │ +000082d0: 7420 6c6f 6164 696e 6720 6672 6f6d 2064 t loading from d │ │ │ │ │ +000082e0: 6973 6b3f 0a20 2020 2a20 446f 2079 6f75 isk?. * Do you │ │ │ │ │ +000082f0: 2073 7570 706f 7274 2063 6861 696e 6c6f support chainlo │ │ │ │ │ +00008300: 6164 696e 673f 0a20 2020 2a20 446f 2079 ading?. * Do y │ │ │ │ │ +00008310: 6f75 2073 7570 706f 7274 206e 6574 776f ou support netwo │ │ │ │ │ +00008320: 726b 2063 6861 696e 6c6f 6164 696e 673f rk chainloading? │ │ │ │ │ +00008330: 0a20 2020 2a20 446f 6573 2063 7075 6964 . * Does cpuid │ │ │ │ │ +00008340: 2063 6f6d 6d61 6e64 2073 7570 706f 7274 command support │ │ │ │ │ +00008350: 7320 6368 6563 6b69 6e67 2061 6c6c 2043 s checking all C │ │ │ │ │ +00008360: 5055 2066 6561 7475 7265 7320 7468 6174 PU features that │ │ │ │ │ +00008370: 2074 6865 2075 7365 720a 2020 2020 206d the user. m │ │ │ │ │ +00008380: 6967 6874 2077 616e 7420 636f 6e64 6974 ight want condit │ │ │ │ │ +00008390: 696f 6e61 6c69 7365 206f 6e20 2836 342d ionalise on (64- │ │ │ │ │ +000083a0: 6269 7420 6d6f 6465 2c20 6879 7065 7276 bit mode, hyperv │ │ │ │ │ +000083b0: 6973 6f72 2c2e 2e2e 290a 2020 202a 2044 isor,...). * D │ │ │ │ │ +000083c0: 6f20 796f 7520 7375 7070 6f72 7420 6869 o you support hi │ │ │ │ │ +000083d0: 6e74 733f 2020 486f 7720 7265 6c69 6162 nts? How reliab │ │ │ │ │ +000083e0: 6c65 2061 7265 2074 6865 793f 0a20 2020 le are they?. │ │ │ │ │ +000083f0: 2a20 446f 6573 2070 6c61 7466 6f72 6d20 * Does platform │ │ │ │ │ +00008400: 6861 7665 2041 4350 493f 2049 6620 736f have ACPI? If so │ │ │ │ │ +00008410: 2064 6f20 2261 6370 6922 2061 6e64 2022 do "acpi" and " │ │ │ │ │ +00008420: 6c73 6163 7069 2220 6d6f 6475 6c65 7320 lsacpi" modules │ │ │ │ │ +00008430: 776f 726b 3f0a 2020 202a 2044 6f20 616e work?. * Do an │ │ │ │ │ +00008440: 7920 6f66 2070 6c61 7466 6f72 6d2d 7370 y of platform-sp │ │ │ │ │ +00008450: 6563 6966 6963 206f 7065 7261 7469 6f6e ecific operation │ │ │ │ │ +00008460: 7320 6d65 6e74 696f 6e65 6420 696e 2074 s mentioned in t │ │ │ │ │ +00008470: 6865 2072 656c 6576 616e 740a 2020 2020 he relevant. │ │ │ │ │ +00008480: 2073 6563 7469 6f6e 206f 6620 7573 6572 section of user │ │ │ │ │ +00008490: 206d 616e 7561 6c20 6d61 6b65 7320 7365 manual makes se │ │ │ │ │ +000084a0: 6e73 6520 6f6e 2079 6f75 7220 706c 6174 nse on your plat │ │ │ │ │ +000084b0: 666f 726d 3f0a 2020 202a 2044 6f65 7320 form?. * Does │ │ │ │ │ +000084c0: 796f 7572 2070 6c61 7466 6f72 6d20 7375 your platform su │ │ │ │ │ +000084d0: 7070 6f72 7420 5043 493f 2049 6620 736f pport PCI? If so │ │ │ │ │ +000084e0: 2069 7320 7468 6572 6520 616e 2061 7070 is there an app │ │ │ │ │ +000084f0: 726f 7072 6961 7465 0a20 2020 2020 6472 ropriate. dr │ │ │ │ │ +00008500: 6976 6572 2066 6f72 2047 5255 423f 0a20 iver for GRUB?. │ │ │ │ │ +00008510: 2020 2a20 446f 2079 6f75 2073 7570 706f * Do you suppo │ │ │ │ │ +00008520: 7274 2062 6164 7261 6d3f 0a0a 1f0a 4669 rt badram?....Fi │ │ │ │ │ +00008530: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ +00008540: 6f2c 2020 4e6f 6465 3a20 4572 726f 7220 o, Node: Error │ │ │ │ │ +00008550: 4861 6e64 6c69 6e67 2c20 204e 6578 743a Handling, Next: │ │ │ │ │ +00008560: 2053 7461 636b 2061 6e64 2068 6561 7020 Stack and heap │ │ │ │ │ +00008570: 7369 7a65 2c20 2050 7265 763a 2050 6f72 size, Prev: Por │ │ │ │ │ +00008580: 7469 6e67 2c20 2055 703a 2054 6f70 0a0a ting, Up: Top.. │ │ │ │ │ +00008590: 3720 4572 726f 7220 4861 6e64 6c69 6e67 7 Error Handling │ │ │ │ │ +000085a0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ +000085b0: 2a0a 0a45 7272 6f72 2068 616e 646c 696e *..Error handlin │ │ │ │ │ +000085c0: 6720 696e 2047 5255 4220 3220 6973 2062 g in GRUB 2 is b │ │ │ │ │ +000085d0: 6173 6564 206f 6e20 6578 6365 7074 696f ased on exceptio │ │ │ │ │ +000085e0: 6e20 6861 6e64 6c69 6e67 206d 6f64 656c n handling model │ │ │ │ │ +000085f0: 2e20 2041 7320 430a 6c61 6e67 7561 6765 . As C.language │ │ │ │ │ +00008600: 2064 6f65 736e 2774 2064 6972 6563 746c doesn't directl │ │ │ │ │ +00008610: 7920 7375 7070 6f72 7420 6578 6365 7074 y support except │ │ │ │ │ +00008620: 696f 6e73 2c20 6578 6365 7074 696f 6e20 ions, exception │ │ │ │ │ +00008630: 6861 6e64 6c69 6e67 0a62 6568 6176 696f handling.behavio │ │ │ │ │ +00008640: 7220 6973 2065 6d75 6c61 7465 6420 696e r is emulated in │ │ │ │ │ +00008650: 2073 6f66 7477 6172 652e 0a0a 2020 2057 software... W │ │ │ │ │ +00008660: 6865 6e20 6578 6365 7074 696f 6e20 6973 hen exception is │ │ │ │ │ +00008670: 2072 6169 7365 642c 2066 756e 6374 696f raised, functio │ │ │ │ │ +00008680: 6e20 6d75 7374 2072 6574 7572 6e20 746f n must return to │ │ │ │ │ +00008690: 2063 616c 6c69 6e67 2066 756e 6374 696f calling functio │ │ │ │ │ +000086a0: 6e2e 0a49 6620 6361 6c6c 696e 6720 6675 n..If calling fu │ │ │ │ │ +000086b0: 6e63 7469 6f6e 2064 6f65 7320 6e6f 7420 nction does not │ │ │ │ │ +000086c0: 7072 6f76 6964 6520 6861 6e64 6c69 6e67 provide handling │ │ │ │ │ +000086d0: 206f 6620 7468 6520 6578 6365 7074 696f of the exceptio │ │ │ │ │ +000086e0: 6e20 6974 206d 7573 740a 7265 7475 726e n it must.return │ │ │ │ │ +000086f0: 2062 6163 6b20 746f 2069 7473 2063 616c back to its cal │ │ │ │ │ +00008700: 6c69 6e67 2066 756e 6374 696f 6e20 616e ling function an │ │ │ │ │ +00008710: 6420 736f 206f 6e2c 2075 6e74 696c 2065 d so on, until e │ │ │ │ │ +00008720: 7863 6570 7469 6f6e 2069 730a 6861 6e64 xception is.hand │ │ │ │ │ +00008730: 6c65 642e 2020 4966 2065 7863 6570 7469 led. If excepti │ │ │ │ │ +00008740: 6f6e 2069 7320 6e6f 7420 6861 6e64 6c65 on is not handle │ │ │ │ │ +00008750: 6420 6265 666f 7265 2070 726f 6d70 7420 d before prompt │ │ │ │ │ +00008760: 6973 2064 6973 706c 6179 6564 2c20 6572 is displayed, er │ │ │ │ │ +00008770: 726f 720a 6d65 7373 6167 6520 7769 6c6c ror.message will │ │ │ │ │ +00008780: 2062 6520 7368 6f77 6e20 746f 2075 7365 be shown to use │ │ │ │ │ +00008790: 722e 0a0a 2020 2045 7863 6570 7469 6f6e r... Exception │ │ │ │ │ +000087a0: 2069 6e66 6f72 6d61 7469 6f6e 2069 7320 information is │ │ │ │ │ +000087b0: 7374 6f72 6564 206f 6e20 2767 7275 625f stored on 'grub_ │ │ │ │ │ +000087c0: 6572 726e 6f27 2067 6c6f 6261 6c20 7661 errno' global va │ │ │ │ │ +000087d0: 7269 6162 6c65 2e20 2049 660a 2767 7275 riable. If.'gru │ │ │ │ │ +000087e0: 625f 6572 726e 6f27 2076 6172 6961 626c b_errno' variabl │ │ │ │ │ +000087f0: 6520 636f 6e74 6169 6e73 2076 616c 7565 e contains value │ │ │ │ │ +00008800: 2027 4752 5542 5f45 5252 5f4e 4f4e 4527 'GRUB_ERR_NONE' │ │ │ │ │ +00008810: 2c20 7468 6572 6520 6973 206e 6f20 6163 , there is no ac │ │ │ │ │ +00008820: 7469 7665 0a65 7863 6570 7469 6f6e 2061 tive.exception a │ │ │ │ │ +00008830: 6e64 2061 7070 6c69 6361 7469 6f6e 2063 nd application c │ │ │ │ │ +00008840: 616e 2063 6f6e 7469 6e75 6520 6e6f 726d an continue norm │ │ │ │ │ +00008850: 616c 2070 726f 6365 7373 696e 672e 2020 al processing. │ │ │ │ │ +00008860: 5768 656e 0a27 6772 7562 5f65 7272 6e6f When.'grub_errno │ │ │ │ │ +00008870: 2720 6861 7320 6f74 6865 7220 7661 6c75 ' has other valu │ │ │ │ │ +00008880: 652c 2069 7420 6973 2072 6571 7569 7265 e, it is require │ │ │ │ │ +00008890: 6420 7468 6174 2061 7070 6c69 6361 7469 d that applicati │ │ │ │ │ +000088a0: 6f6e 2063 6f64 650a 6569 7468 6572 2068 on code.either h │ │ │ │ │ +000088b0: 616e 646c 6573 2074 6869 7320 6572 726f andles this erro │ │ │ │ │ +000088c0: 7220 6f72 2072 6574 7572 6e73 2069 6e73 r or returns ins │ │ │ │ │ +000088d0: 7461 6e74 6c79 2074 6f20 6361 6c6c 6572 tantly to caller │ │ │ │ │ +000088e0: 2e20 2049 6620 6675 6e63 7469 6f6e 0a69 . If function.i │ │ │ │ │ +000088f0: 7320 7769 7468 2072 6574 7572 6e20 7479 s with return ty │ │ │ │ │ +00008900: 7065 2027 6772 7562 5f65 7272 5f74 2720 pe 'grub_err_t' │ │ │ │ │ +00008910: 6973 2061 626f 7574 2074 6f20 7265 7475 is about to retu │ │ │ │ │ +00008920: 726e 2027 4752 5542 5f45 5252 5f4e 4f4e rn 'GRUB_ERR_NON │ │ │ │ │ +00008930: 4527 2c20 6974 0a73 686f 756c 6420 6e6f E', it.should no │ │ │ │ │ +00008940: 7420 7365 7420 2767 7275 625f 6572 726e t set 'grub_errn │ │ │ │ │ +00008950: 6f27 2074 6f20 7468 6174 2076 616c 7565 o' to that value │ │ │ │ │ +00008960: 2e20 204f 6e6c 7920 7365 7420 2767 7275 . Only set 'gru │ │ │ │ │ +00008970: 625f 6572 726e 6f27 2069 6e0a 6361 7365 b_errno' in.case │ │ │ │ │ +00008980: 7320 7768 6572 6520 7468 6572 6520 6973 s where there is │ │ │ │ │ +00008990: 2065 7272 6f72 2073 6974 7561 7469 6f6e error situation │ │ │ │ │ +000089a0: 2e0a 0a20 2020 5369 6d70 6c65 2065 7863 ... Simple exc │ │ │ │ │ +000089b0: 6570 7469 6f6e 2066 6f72 7761 7264 6572 eption forwarder │ │ │ │ │ +000089c0: 2e0a 2020 2020 2067 7275 625f 6572 725f .. grub_err_ │ │ │ │ │ +000089d0: 740a 2020 2020 2066 6f72 7761 7264 696e t. forwardin │ │ │ │ │ +000089e0: 675f 6578 616d 706c 6520 2876 6f69 6429 g_example (void) │ │ │ │ │ +000089f0: 0a20 2020 2020 7b0a 2020 2020 2020 202f . {. / │ │ │ │ │ +00008a00: 2a20 4361 6c6c 2066 756e 6374 696f 6e20 * Call function │ │ │ │ │ +00008a10: 7468 6174 206d 6967 6874 2063 6175 7365 that might cause │ │ │ │ │ +00008a20: 2065 7863 6570 7469 6f6e 2e20 202a 2f0a exception. */. │ │ │ │ │ +00008a30: 2020 2020 2020 2066 6f6f 6261 7220 2829 foobar () │ │ │ │ │ +00008a40: 3b0a 0a20 2020 2020 2020 2f2a 204e 6f20 ;.. /* No │ │ │ │ │ +00008a50: 7370 6563 6961 6c20 6578 6365 7074 696f special exceptio │ │ │ │ │ +00008a60: 6e20 6861 6e64 6c65 722c 206a 7573 7420 n handler, just │ │ │ │ │ +00008a70: 666f 7277 6172 6420 706f 7373 6962 6c65 forward possible │ │ │ │ │ +00008a80: 2065 7863 6570 7469 6f6e 732e 2020 2a2f exceptions. */ │ │ │ │ │ +00008a90: 0a20 2020 2020 2020 6966 2028 6772 7562 . if (grub │ │ │ │ │ +00008aa0: 5f65 7272 6e6f 2021 3d20 4752 5542 5f45 _errno != GRUB_E │ │ │ │ │ +00008ab0: 5252 5f4e 4f4e 4529 0a20 2020 2020 2020 RR_NONE). │ │ │ │ │ +00008ac0: 2020 7b0a 2020 2020 2020 2020 2020 2072 {. r │ │ │ │ │ +00008ad0: 6574 7572 6e20 6772 7562 5f65 7272 6e6f eturn grub_errno │ │ │ │ │ +00008ae0: 3b0a 2020 2020 2020 2020 207d 0a0a 2020 ;. }.. │ │ │ │ │ +00008af0: 2020 2020 202f 2a20 416c 6c20 6973 204f /* All is O │ │ │ │ │ +00008b00: 4b2c 2064 6f20 6d6f 7265 2070 726f 6365 K, do more proce │ │ │ │ │ +00008b10: 7373 696e 672e 2020 2a2f 0a0a 2020 2020 ssing. */.. │ │ │ │ │ +00008b20: 2020 202f 2a20 5265 7475 726e 204f 4b20 /* Return OK │ │ │ │ │ +00008b30: 7369 676e 616c 2c20 746f 2063 616c 6c65 signal, to calle │ │ │ │ │ +00008b40: 722e 2020 2a2f 0a20 2020 2020 2020 7265 r. */. re │ │ │ │ │ +00008b50: 7475 726e 2047 5255 425f 4552 525f 4e4f turn GRUB_ERR_NO │ │ │ │ │ +00008b60: 4e45 3b0a 2020 2020 207d 0a0a 2020 2045 NE;. }.. E │ │ │ │ │ +00008b70: 7272 6f72 2072 6570 6f72 7469 6e67 2068 rror reporting h │ │ │ │ │ +00008b80: 6173 2074 776f 2063 6f6d 706f 6e65 6e74 as two component │ │ │ │ │ +00008b90: 732c 2074 6865 2061 6374 7561 6c20 6572 s, the actual er │ │ │ │ │ +00008ba0: 726f 7220 636f 6465 2028 6f66 2074 7970 ror code (of typ │ │ │ │ │ +00008bb0: 650a 2767 7275 625f 6572 725f 7427 2920 e.'grub_err_t') │ │ │ │ │ +00008bc0: 616e 6420 7465 7874 7561 6c20 6d65 7373 and textual mess │ │ │ │ │ +00008bd0: 6167 6520 7468 6174 2077 696c 6c20 6265 age that will be │ │ │ │ │ +00008be0: 2064 6973 706c 6179 6564 2074 6f20 7573 displayed to us │ │ │ │ │ +00008bf0: 6572 2e20 204c 6973 740a 6f66 2076 616c er. List.of val │ │ │ │ │ +00008c00: 6964 2065 7272 6f72 2063 6f64 6573 2069 id error codes i │ │ │ │ │ +00008c10: 7320 6c69 7374 6564 2069 6e20 6865 6164 s listed in head │ │ │ │ │ +00008c20: 6572 2066 696c 6520 2769 6e63 6c75 6465 er file 'include │ │ │ │ │ +00008c30: 2f67 7275 622f 6572 722e 6827 2e0a 5465 /grub/err.h'..Te │ │ │ │ │ +00008c40: 7874 7561 6c20 6572 726f 7220 6d65 7373 xtual error mess │ │ │ │ │ +00008c50: 6167 6520 6361 6e20 636f 6e74 6169 6e20 age can contain │ │ │ │ │ +00008c60: 616e 7920 7465 7874 7561 6c20 6461 7461 any textual data │ │ │ │ │ +00008c70: 2e20 2041 7420 7469 6d65 206f 6620 7772 . At time of wr │ │ │ │ │ +00008c80: 6974 696e 672c 0a65 7272 6f72 206d 6573 iting,.error mes │ │ │ │ │ +00008c90: 7361 6765 2063 616e 2063 6f6e 7461 696e sage can contain │ │ │ │ │ +00008ca0: 2075 7020 746f 2032 3536 2063 6861 7261 up to 256 chara │ │ │ │ │ +00008cb0: 6374 6572 7320 2869 6e63 6c75 6469 6e67 cters (including │ │ │ │ │ +00008cc0: 2074 6572 6d69 6e61 7469 6e67 0a4e 554c terminating.NUL │ │ │ │ │ +00008cd0: 292e 2054 6f20 6561 7365 2065 7272 6f72 ). To ease error │ │ │ │ │ +00008ce0: 2072 6570 6f72 7469 6e67 2074 6865 7265 reporting there │ │ │ │ │ +00008cf0: 2069 7320 6120 6865 6c70 6572 2066 756e is a helper fun │ │ │ │ │ +00008d00: 6374 696f 6e20 2767 7275 625f 6572 726f ction 'grub_erro │ │ │ │ │ +00008d10: 7227 0a74 6861 7420 616c 6c6f 7773 2065 r'.that allows e │ │ │ │ │ +00008d20: 6173 6965 7220 666f 726d 6174 7469 6e67 asier formatting │ │ │ │ │ +00008d30: 206f 6620 6572 726f 7220 6d65 7373 6167 of error messag │ │ │ │ │ +00008d40: 6573 2061 6e64 2073 686f 756c 6420 6265 es and should be │ │ │ │ │ +00008d50: 2075 7365 640a 696e 7374 6561 6420 6f66 used.instead of │ │ │ │ │ +00008d60: 2077 7269 7469 6e67 2064 6972 6563 746c writing directl │ │ │ │ │ +00008d70: 7920 746f 2067 6c6f 6261 6c20 7661 7269 y to global vari │ │ │ │ │ +00008d80: 6162 6c65 732e 0a0a 2020 2045 7861 6d70 ables... Examp │ │ │ │ │ +00008d90: 6c65 206f 6620 6572 726f 7220 7265 706f le of error repo │ │ │ │ │ +00008da0: 7274 696e 672e 0a20 2020 2020 6772 7562 rting.. grub │ │ │ │ │ +00008db0: 5f65 7272 5f74 0a20 2020 2020 6661 696c _err_t. fail │ │ │ │ │ +00008dc0: 696e 675f 6578 616d 706c 6520 2829 0a20 ing_example (). │ │ │ │ │ +00008dd0: 2020 2020 7b0a 2020 2020 2020 2072 6574 {. ret │ │ │ │ │ +00008de0: 7572 6e20 6772 7562 5f65 7272 6f72 2028 urn grub_error ( │ │ │ │ │ +00008df0: 4752 5542 5f45 5252 5f46 494c 455f 4e4f GRUB_ERR_FILE_NO │ │ │ │ │ +00008e00: 545f 464f 554e 442c 0a20 2020 2020 2020 T_FOUND,. │ │ │ │ │ 00008e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00008e20: 2022 4661 696c 6564 2074 6f20 7265 6164 "Failed to read │ │ │ │ │ -00008e30: 2025 732c 2074 7269 6564 2025 6420 7469 %s, tried %d ti │ │ │ │ │ -00008e40: 6d65 732e 222c 0a20 2020 2020 2020 2020 mes.",. │ │ │ │ │ +00008e20: 2020 2022 4661 696c 6564 2074 6f20 7265 "Failed to re │ │ │ │ │ +00008e30: 6164 2025 732c 2074 7269 6564 2025 6420 ad %s, tried %d │ │ │ │ │ +00008e40: 7469 6d65 732e 222c 0a20 2020 2020 2020 times.",. │ │ │ │ │ 00008e50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00008e60: 2022 7465 7374 2e74 7874 222c 0a20 2020 "test.txt",. │ │ │ │ │ +00008e60: 2020 2022 7465 7374 2e74 7874 222c 0a20 "test.txt",. │ │ │ │ │ 00008e70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00008e80: 2020 2020 2020 2031 3029 3b0a 2020 2020 10);. │ │ │ │ │ -00008e90: 207d 0a0a 2020 2049 6620 7468 6572 6520 }.. If there │ │ │ │ │ -00008ea0: 6973 2061 2073 7065 6369 616c 2072 6561 is a special rea │ │ │ │ │ -00008eb0: 736f 6e20 7468 6174 2065 7272 6f72 2063 son that error c │ │ │ │ │ -00008ec0: 6f64 6520 646f 6573 206e 6f74 206e 6565 ode does not nee │ │ │ │ │ -00008ed0: 6420 746f 2062 650a 7461 6b65 6e20 6163 d to be.taken ac │ │ │ │ │ -00008ee0: 636f 756e 742c 2027 6772 7562 5f65 7272 count, 'grub_err │ │ │ │ │ -00008ef0: 6e6f 2720 6361 6e20 6265 207a 6572 6f65 no' can be zeroe │ │ │ │ │ -00008f00: 6420 6261 636b 2074 6f20 2747 5255 425f d back to 'GRUB_ │ │ │ │ │ -00008f10: 4552 525f 4e4f 4e45 272e 2020 496e 0a63 ERR_NONE'. In.c │ │ │ │ │ -00008f20: 6173 6573 206c 696b 6520 7468 6973 2061 ases like this a │ │ │ │ │ -00008f30: 6c6c 2070 7265 7669 6f75 7320 6572 726f ll previous erro │ │ │ │ │ -00008f40: 7220 636f 6465 7320 7368 6f75 6c64 2068 r codes should h │ │ │ │ │ -00008f50: 6176 6520 6265 656e 2068 616e 646c 6564 ave been handled │ │ │ │ │ -00008f60: 0a63 6f72 7265 6374 6c79 2e20 2054 6869 .correctly. Thi │ │ │ │ │ -00008f70: 7320 6d61 6b65 7320 7375 7265 2074 6861 s makes sure tha │ │ │ │ │ -00008f80: 7420 7468 6572 6520 6172 6520 6e6f 2075 t there are no u │ │ │ │ │ -00008f90: 6e68 616e 646c 6564 2065 7863 6570 7469 nhandled excepti │ │ │ │ │ -00008fa0: 6f6e 732e 0a0a 2020 2045 7861 6d70 6c65 ons... Example │ │ │ │ │ -00008fb0: 206f 6620 7a65 726f 696e 6720 2767 7275 of zeroing 'gru │ │ │ │ │ -00008fc0: 625f 6572 726e 6f27 2e0a 2020 2020 2067 b_errno'.. g │ │ │ │ │ -00008fd0: 7275 625f 6572 725f 740a 2020 2020 2070 rub_err_t. p │ │ │ │ │ -00008fe0: 726f 6265 5f65 7861 6d70 6c65 2028 290a robe_example (). │ │ │ │ │ -00008ff0: 2020 2020 207b 0a20 2020 2020 2020 2f2a {. /* │ │ │ │ │ -00009000: 2054 7279 2074 6f20 7072 6f62 6520 6465 Try to probe de │ │ │ │ │ -00009010: 7669 6365 2074 7970 6520 312e 2020 2a2f vice type 1. */ │ │ │ │ │ -00009020: 0a20 2020 2020 2020 7072 6f62 655f 666f . probe_fo │ │ │ │ │ -00009030: 725f 6465 7669 6365 2028 293b 0a20 2020 r_device ();. │ │ │ │ │ -00009040: 2020 2020 6966 2028 6772 7562 5f65 7272 if (grub_err │ │ │ │ │ -00009050: 6e6f 203d 3d20 4752 5542 5f45 5252 5f4e no == GRUB_ERR_N │ │ │ │ │ -00009060: 4f4e 4529 0a20 2020 2020 2020 2020 7b0a ONE). {. │ │ │ │ │ -00009070: 2020 2020 2020 2020 2020 202f 2a20 4465 /* De │ │ │ │ │ -00009080: 7669 6365 2074 7970 6520 3120 7761 7320 vice type 1 was │ │ │ │ │ -00009090: 666f 756e 6420 6f6e 2073 7973 7465 6d2e found on system. │ │ │ │ │ -000090a0: 2020 2a2f 0a20 2020 2020 2020 2020 2020 */. │ │ │ │ │ -000090b0: 7265 6769 7374 6572 5f64 6576 6963 6520 register_device │ │ │ │ │ -000090c0: 2829 3b0a 2020 2020 2020 2020 2020 2072 ();. r │ │ │ │ │ -000090d0: 6574 7572 6e20 4752 5542 5f45 5252 5f4e eturn GRUB_ERR_N │ │ │ │ │ -000090e0: 4f4e 453b 0a20 2020 2020 2020 2020 7d0a ONE;. }. │ │ │ │ │ -000090f0: 2020 2020 2020 202f 2a20 5a65 726f 206f /* Zero o │ │ │ │ │ -00009100: 7574 2065 7272 6f72 2063 6f64 652e 2020 ut error code. │ │ │ │ │ -00009110: 2a2f 0a20 2020 2020 2020 6772 7562 5f65 */. grub_e │ │ │ │ │ -00009120: 7272 6e6f 203d 2047 5255 425f 4552 525f rrno = GRUB_ERR_ │ │ │ │ │ -00009130: 4e4f 4e45 3b0a 0a20 2020 2020 2020 2f2a NONE;.. /* │ │ │ │ │ -00009140: 204e 6f20 6465 7669 6365 2074 7970 6520 No device type │ │ │ │ │ -00009150: 3120 666f 756e 642c 2074 7279 2074 6f20 1 found, try to │ │ │ │ │ -00009160: 7072 6f62 6520 6465 7669 6365 2074 7970 probe device typ │ │ │ │ │ -00009170: 6520 322e 2020 2a2f 0a20 2020 2020 2020 e 2. */. │ │ │ │ │ -00009180: 7072 6f62 655f 666f 725f 6465 7669 6365 probe_for_device │ │ │ │ │ -00009190: 3220 2829 3b0a 2020 2020 2020 2069 6620 2 ();. if │ │ │ │ │ -000091a0: 2867 7275 625f 6572 726e 6f20 3d3d 2047 (grub_errno == G │ │ │ │ │ -000091b0: 5255 425f 4552 525f 4e4f 4e45 290a 2020 RUB_ERR_NONE). │ │ │ │ │ -000091c0: 2020 2020 2020 207b 0a20 2020 2020 2020 {. │ │ │ │ │ -000091d0: 2020 2020 2f2a 2044 6576 6963 6520 7479 /* Device ty │ │ │ │ │ -000091e0: 7065 2032 2077 6173 2066 6f75 6e64 206f pe 2 was found o │ │ │ │ │ -000091f0: 6e20 7379 7374 656d 2e20 202a 2f0a 2020 n system. */. │ │ │ │ │ -00009200: 2020 2020 2020 2020 2072 6567 6973 7465 registe │ │ │ │ │ -00009210: 725f 6465 7669 6365 3220 2829 3b0a 2020 r_device2 ();. │ │ │ │ │ -00009220: 2020 2020 2020 2020 2072 6574 7572 6e20 return │ │ │ │ │ -00009230: 4752 5542 5f45 5252 5f4e 4f4e 453b 0a20 GRUB_ERR_NONE;. │ │ │ │ │ -00009240: 2020 2020 2020 2020 7d0a 2020 2020 2020 }. │ │ │ │ │ -00009250: 202f 2a20 5a65 726f 206f 7574 2065 7272 /* Zero out err │ │ │ │ │ -00009260: 6f72 2063 6f64 652e 2020 2a2f 0a20 2020 or code. */. │ │ │ │ │ -00009270: 2020 2020 6772 7562 5f65 7272 6e6f 203d grub_errno = │ │ │ │ │ -00009280: 2047 5255 425f 4552 525f 4e4f 4e45 3b0a GRUB_ERR_NONE;. │ │ │ │ │ -00009290: 0a20 2020 2020 2020 2f2a 2052 6574 7572 . /* Retur │ │ │ │ │ -000092a0: 6e20 6375 7374 6f6d 2065 7272 6f72 206d n custom error m │ │ │ │ │ -000092b0: 6573 7361 6765 2e20 202a 2f0a 2020 2020 essage. */. │ │ │ │ │ -000092c0: 2020 2072 6574 7572 6e20 6772 7562 5f65 return grub_e │ │ │ │ │ -000092d0: 7272 6f72 2028 4752 5542 5f45 5252 5f55 rror (GRUB_ERR_U │ │ │ │ │ -000092e0: 4e4b 4e4f 574e 5f44 4556 4943 452c 2022 NKNOWN_DEVICE, " │ │ │ │ │ -000092f0: 4e6f 2064 6576 6963 6520 7479 7065 2031 No device type 1 │ │ │ │ │ -00009300: 206f 7220 3220 666f 756e 642e 2229 3b0a or 2 found.");. │ │ │ │ │ -00009310: 2020 2020 207d 0a0a 2020 2053 6f6d 6520 }.. Some │ │ │ │ │ -00009320: 7469 6d65 7320 7468 6572 6520 6973 2061 times there is a │ │ │ │ │ -00009330: 206e 6565 6420 746f 2063 6f6e 7469 6e75 need to continu │ │ │ │ │ -00009340: 6520 7072 6f63 6573 7369 6e67 2065 7665 e processing eve │ │ │ │ │ -00009350: 6e20 6966 2074 6865 7265 2069 7320 610a n if there is a. │ │ │ │ │ -00009360: 6572 726f 7220 7374 6174 6520 696e 2061 error state in a │ │ │ │ │ -00009370: 7070 6c69 6361 7469 6f6e 2e20 2049 6e20 pplication. In │ │ │ │ │ -00009380: 7369 7475 6174 696f 6e73 206c 696b 6520 situations like │ │ │ │ │ -00009390: 7468 6973 2c20 7468 6572 6520 6973 2061 this, there is a │ │ │ │ │ -000093a0: 206e 6565 6465 640a 746f 2073 6176 6520 needed.to save │ │ │ │ │ -000093b0: 6f6c 6420 6572 726f 7220 7374 6174 6520 old error state │ │ │ │ │ -000093c0: 616e 6420 7468 656e 2063 616c 6c20 6f74 and then call ot │ │ │ │ │ -000093d0: 6865 7220 6675 6e63 7469 6f6e 7320 7468 her functions th │ │ │ │ │ -000093e0: 6174 206d 6967 6874 2066 6169 6c2e 0a54 at might fail..T │ │ │ │ │ -000093f0: 6f20 6169 6420 696e 2074 6869 732c 2074 o aid in this, t │ │ │ │ │ -00009400: 6865 7265 2069 7320 6120 6572 726f 7220 here is a error │ │ │ │ │ -00009410: 7374 6163 6b20 696d 706c 656d 656e 7465 stack implemente │ │ │ │ │ -00009420: 642e 2020 4572 726f 7220 7374 6174 6520 d. Error state │ │ │ │ │ -00009430: 6361 6e20 6265 0a70 7573 6865 6420 746f can be.pushed to │ │ │ │ │ -00009440: 2065 7272 6f72 2073 7461 636b 2062 7920 error stack by │ │ │ │ │ -00009450: 6361 6c6c 696e 6720 6675 6e63 7469 6f6e calling function │ │ │ │ │ -00009460: 2027 6772 7562 5f65 7272 6f72 5f70 7573 'grub_error_pus │ │ │ │ │ -00009470: 6820 2829 272e 2020 5768 656e 0a70 726f h ()'. When.pro │ │ │ │ │ -00009480: 6365 7373 696e 6720 6861 7320 6265 656e cessing has been │ │ │ │ │ -00009490: 2063 6f6d 706c 6574 6564 2c20 2767 7275 completed, 'gru │ │ │ │ │ -000094a0: 625f 6572 726f 725f 706f 7020 2829 2720 b_error_pop ()' │ │ │ │ │ -000094b0: 6361 6e20 6265 2075 7365 6420 746f 2070 can be used to p │ │ │ │ │ -000094c0: 6f70 0a65 7272 6f72 2073 7461 7465 2066 op.error state f │ │ │ │ │ -000094d0: 726f 6d20 7374 6163 6b2e 2020 4572 726f rom stack. Erro │ │ │ │ │ -000094e0: 7220 7374 6163 6b20 636f 6e74 6169 6e73 r stack contains │ │ │ │ │ -000094f0: 2070 7265 6465 6669 6e65 6420 616d 6f75 predefined amou │ │ │ │ │ -00009500: 6e74 206f 6620 6572 726f 720a 7374 6163 nt of error.stac │ │ │ │ │ -00009510: 6b20 6974 656d 732e 2020 4572 726f 7220 k items. Error │ │ │ │ │ -00009520: 7374 6163 6b20 6973 2070 726f 7465 6374 stack is protect │ │ │ │ │ -00009530: 6564 2066 6f72 206f 7665 7266 6c6f 7720 ed for overflow │ │ │ │ │ -00009540: 616e 6420 6d61 726b 7320 7468 6573 650a and marks these. │ │ │ │ │ -00009550: 7369 7475 6174 696f 6e73 2073 6f20 6f76 situations so ov │ │ │ │ │ -00009560: 6572 666c 6f77 2065 7272 6f72 2064 6f65 erflow error doe │ │ │ │ │ -00009570: 7320 6e6f 7420 6765 7420 756e 7365 656e s not get unseen │ │ │ │ │ -00009580: 2e20 2049 6620 7468 6572 6520 6973 206e . If there is n │ │ │ │ │ -00009590: 6f20 7370 6163 650a 6176 6169 6c61 626c o space.availabl │ │ │ │ │ -000095a0: 6520 746f 2073 746f 7265 2065 7272 6f72 e to store error │ │ │ │ │ -000095b0: 206d 6573 7361 6765 2c20 6974 2069 7320 message, it is │ │ │ │ │ -000095c0: 7369 6d70 6c79 2064 6973 6361 7264 6564 simply discarded │ │ │ │ │ -000095d0: 2061 6e64 206f 7665 7266 6c6f 770a 7769 and overflow.wi │ │ │ │ │ -000095e0: 6c6c 2062 6520 6d61 726b 6564 2061 7320 ll be marked as │ │ │ │ │ -000095f0: 6861 7070 656e 6564 2e20 2057 6865 6e20 happened. When │ │ │ │ │ -00009600: 6f76 6572 666c 6f77 2068 6170 7065 6e73 overflow happens │ │ │ │ │ -00009610: 2c20 6974 206d 6f73 7420 6c69 6b65 6c79 , it most likely │ │ │ │ │ -00009620: 2077 696c 6c0a 636f 7272 7570 7420 6572 will.corrupt er │ │ │ │ │ -00009630: 726f 7220 7374 6163 6b20 636f 6e73 6973 ror stack consis │ │ │ │ │ -00009640: 7465 6e63 7920 6173 2066 6f72 2070 7573 tency as for pus │ │ │ │ │ -00009650: 6865 6420 6572 726f 7220 7468 6572 6520 hed error there │ │ │ │ │ -00009660: 6973 206e 6f20 6d61 7463 6869 6e67 0a70 is no matching.p │ │ │ │ │ -00009670: 6f70 2c20 6275 7420 6f76 6572 666c 6f77 op, but overflow │ │ │ │ │ -00009680: 206d 6573 7361 6765 2077 696c 6c20 6265 message will be │ │ │ │ │ -00009690: 2073 686f 776e 2074 6f20 696e 666f 726d shown to inform │ │ │ │ │ -000096a0: 2075 7365 7220 6162 6f75 7420 7468 650a user about the. │ │ │ │ │ -000096b0: 7369 7475 6174 696f 6e2e 2020 4f76 6572 situation. Over │ │ │ │ │ -000096c0: 666c 6f77 206d 6573 7361 6765 2077 696c flow message wil │ │ │ │ │ -000096d0: 6c20 6265 2073 686f 776e 2061 7420 7469 l be shown at ti │ │ │ │ │ -000096e0: 6d65 2077 6865 6e20 7072 6f6d 7074 2069 me when prompt i │ │ │ │ │ -000096f0: 7320 6162 6f75 740a 746f 2062 6520 6472 s about.to be dr │ │ │ │ │ -00009700: 6177 6e2e 0a0a 2020 2045 7861 6d70 6c65 awn... Example │ │ │ │ │ -00009710: 2075 7361 6765 206f 6620 6572 726f 7220 usage of error │ │ │ │ │ -00009720: 7374 6163 6b2e 0a20 2020 2020 2f2a 2053 stack.. /* S │ │ │ │ │ -00009730: 6176 6520 706f 7373 6962 6c65 206f 6c64 ave possible old │ │ │ │ │ -00009740: 2065 7272 6f72 206d 6573 7361 6765 2e20 error message. │ │ │ │ │ -00009750: 202a 2f0a 2020 2020 2067 7275 625f 6572 */. grub_er │ │ │ │ │ -00009760: 726f 725f 7075 7368 2028 293b 0a0a 2020 ror_push ();.. │ │ │ │ │ -00009770: 2020 202f 2a20 446f 2079 6f75 7220 7374 /* Do your st │ │ │ │ │ -00009780: 7566 6620 6865 7265 2e20 202a 2f0a 2020 uff here. */. │ │ │ │ │ -00009790: 2020 2063 616c 6c5f 706f 7373 6962 6c79 call_possibly │ │ │ │ │ -000097a0: 5f66 6169 6c69 6e67 5f66 756e 6374 696f _failing_functio │ │ │ │ │ -000097b0: 6e20 2829 3b0a 0a20 2020 2020 6966 2028 n ();.. if ( │ │ │ │ │ -000097c0: 6772 7562 5f65 7272 6e6f 2021 3d20 4752 grub_errno != GR │ │ │ │ │ -000097d0: 5542 5f45 5252 5f4e 4f4e 4529 0a20 2020 UB_ERR_NONE). │ │ │ │ │ -000097e0: 2020 2020 7b0a 2020 2020 2020 2020 202f {. / │ │ │ │ │ -000097f0: 2a20 496e 666f 726d 2072 6573 7420 6f66 * Inform rest of │ │ │ │ │ -00009800: 2074 6865 2063 6f64 6520 7468 6174 2074 the code that t │ │ │ │ │ -00009810: 6865 7265 2069 7320 6572 726f 7220 2867 here is error (g │ │ │ │ │ -00009820: 7275 625f 6572 726e 6f0a 2020 2020 2020 rub_errno. │ │ │ │ │ -00009830: 2020 2020 2020 6973 2073 6574 292e 2054 is set). T │ │ │ │ │ -00009840: 6865 7265 2069 7320 6e6f 2070 6f70 2068 here is no pop h │ │ │ │ │ -00009850: 6572 6520 6173 2077 6520 7761 6e74 2062 ere as we want b │ │ │ │ │ -00009860: 6f74 6820 6572 726f 7220 7374 6174 6573 oth error states │ │ │ │ │ -00009870: 0a20 2020 2020 2020 2020 2020 2074 6f20 . to │ │ │ │ │ -00009880: 6265 2064 6973 706c 6179 6564 2e20 202a be displayed. * │ │ │ │ │ -00009890: 2f0a 2020 2020 2020 2020 2072 6574 7572 /. retur │ │ │ │ │ -000098a0: 6e3b 0a20 2020 2020 2020 7d0a 0a20 2020 n;. }.. │ │ │ │ │ -000098b0: 2020 2f2a 2052 6573 746f 7265 206f 6c64 /* Restore old │ │ │ │ │ -000098c0: 2065 7272 6f72 2073 7461 7465 2062 7920 error state by │ │ │ │ │ -000098d0: 706f 7070 696e 6720 7072 6576 696f 7573 popping previous │ │ │ │ │ -000098e0: 2069 7465 6d20 6672 6f6d 2073 7461 636b item from stack │ │ │ │ │ -000098f0: 2e20 2a2f 0a20 2020 2020 6772 7562 5f65 . */. grub_e │ │ │ │ │ -00009900: 7272 6f72 5f70 6f70 2028 293b 0a0a 1f0a rror_pop ();.... │ │ │ │ │ -00009910: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ │ -00009920: 6e66 6f2c 2020 4e6f 6465 3a20 5374 6163 nfo, Node: Stac │ │ │ │ │ -00009930: 6b20 616e 6420 6865 6170 2073 697a 652c k and heap size, │ │ │ │ │ -00009940: 2020 4e65 7874 3a20 4249 4f53 2070 6f72 Next: BIOS por │ │ │ │ │ -00009950: 7420 6d65 6d6f 7279 206d 6170 2c20 2050 t memory map, P │ │ │ │ │ -00009960: 7265 763a 2045 7272 6f72 2048 616e 646c rev: Error Handl │ │ │ │ │ -00009970: 696e 672c 2020 5570 3a20 546f 700a 0a38 ing, Up: Top..8 │ │ │ │ │ -00009980: 2053 7461 636b 2061 6e64 2068 6561 7020 Stack and heap │ │ │ │ │ -00009990: 7369 7a65 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a size.*********** │ │ │ │ │ -000099a0: 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4f6e 2065 **********..On e │ │ │ │ │ -000099b0: 6d75 2073 7461 636b 2061 6e64 2068 6561 mu stack and hea │ │ │ │ │ -000099c0: 7020 6172 6520 6a75 7374 206e 6f72 6d61 p are just norma │ │ │ │ │ -000099d0: 6c20 686f 7374 204f 5320 7374 6163 6b20 l host OS stack │ │ │ │ │ -000099e0: 616e 6420 6865 6170 2e20 2053 7461 636b and heap. Stack │ │ │ │ │ -000099f0: 2069 730a 7479 7069 6361 6c6c 7920 3820 is.typically 8 │ │ │ │ │ -00009a00: 4d69 4220 616c 7468 6f75 6768 2069 7427 MiB although it' │ │ │ │ │ -00009a10: 7320 4f53 2d64 6570 656e 6465 6e74 2e0a s OS-dependent.. │ │ │ │ │ -00009a20: 0a20 2020 4f6e 2069 3338 362d 7063 2c20 . On i386-pc, │ │ │ │ │ -00009a30: 6933 3836 2d63 6f72 6562 6f6f 742c 2069 i386-coreboot, i │ │ │ │ │ -00009a40: 3338 362d 7165 6d75 2061 6e64 2069 3338 386-qemu and i38 │ │ │ │ │ -00009a50: 362d 6d75 6c74 6962 6f6f 7420 7468 6520 6-multiboot the │ │ │ │ │ -00009a60: 7374 6163 6b20 6973 0a36 304b 6942 2e20 stack is.60KiB. │ │ │ │ │ -00009a70: 416c 6c20 6176 6169 6c61 626c 6520 7370 All available sp │ │ │ │ │ -00009a80: 6163 6520 6265 7477 6565 6e20 314d 6942 ace between 1MiB │ │ │ │ │ -00009a90: 2061 6e64 2034 4769 4220 6d61 726b 7320 and 4GiB marks │ │ │ │ │ -00009aa0: 6973 2070 6172 7420 6f66 2068 6561 702e is part of heap. │ │ │ │ │ -00009ab0: 0a0a 2020 204f 6e20 2a2d 7865 6e20 7374 .. On *-xen st │ │ │ │ │ -00009ac0: 6163 6b20 6973 2034 4d69 422e 2049 6620 ack is 4MiB. If │ │ │ │ │ -00009ad0: 636f 6d70 696c 6564 2066 6f72 2078 3836 compiled for x86 │ │ │ │ │ -00009ae0: 2d36 3420 7769 7468 2047 4343 2034 2e34 -64 with GCC 4.4 │ │ │ │ │ -00009af0: 206f 7220 6c61 7465 720a 6164 7265 7373 or later.adress │ │ │ │ │ -00009b00: 6162 6c65 2073 7061 6365 2069 7320 756e able space is un │ │ │ │ │ -00009b10: 6c69 6d69 7465 642e 2020 5768 656e 2063 limited. When c │ │ │ │ │ -00009b20: 6f6d 7069 6c65 6420 666f 7220 7838 362d ompiled for x86- │ │ │ │ │ -00009b30: 3634 2077 6974 6820 6f6c 6465 7220 4743 64 with older GC │ │ │ │ │ -00009b40: 430a 7665 7273 696f 6e20 6164 7265 7373 C.version adress │ │ │ │ │ -00009b50: 6162 6c65 2073 7061 6365 2069 7320 6c69 able space is li │ │ │ │ │ -00009b60: 6d69 7465 6420 746f 2032 4769 422e 2057 mited to 2GiB. W │ │ │ │ │ -00009b70: 6865 6e20 636f 6d70 696c 696e 6720 666f hen compiling fo │ │ │ │ │ -00009b80: 7220 6933 3836 0a61 6472 6573 7361 626c r i386.adressabl │ │ │ │ │ -00009b90: 6520 7370 6163 6520 6973 206c 696d 6974 e space is limit │ │ │ │ │ -00009ba0: 6564 2074 6f20 3447 6942 2e20 416c 6c20 ed to 4GiB. All │ │ │ │ │ -00009bb0: 6164 7265 7373 6162 6c65 2070 6167 6573 adressable pages │ │ │ │ │ -00009bc0: 2065 7863 6570 7420 7468 650a 6f6e 6573 except the.ones │ │ │ │ │ -00009bd0: 2066 6f72 2073 7461 636b 2c20 4752 5542 for stack, GRUB │ │ │ │ │ -00009be0: 2062 696e 6172 792c 2073 7065 6369 616c binary, special │ │ │ │ │ -00009bf0: 2070 6167 6573 2061 6e64 2070 6167 6520 pages and page │ │ │ │ │ -00009c00: 7461 626c 6520 6172 6520 696e 2074 6865 table are in the │ │ │ │ │ -00009c10: 0a68 6561 702e 0a0a 2020 204f 6e20 2a2d .heap... On *- │ │ │ │ │ -00009c20: 6566 6920 4752 5542 2075 7365 7320 7361 efi GRUB uses sa │ │ │ │ │ -00009c30: 6d65 2073 7461 636b 2061 7320 4546 492e me stack as EFI. │ │ │ │ │ -00009c40: 2049 6620 636f 6d70 696c 6564 2066 6f72 If compiled for │ │ │ │ │ -00009c50: 2078 3836 2d36 3420 7769 7468 2047 4343 x86-64 with GCC │ │ │ │ │ -00009c60: 0a34 2e34 206f 7220 6c61 7465 7220 6164 .4.4 or later ad │ │ │ │ │ -00009c70: 7265 7373 6162 6c65 2073 7061 6365 2069 ressable space i │ │ │ │ │ -00009c80: 7320 756e 6c69 6d69 7465 642e 2020 5768 s unlimited. Wh │ │ │ │ │ -00009c90: 656e 2063 6f6d 7069 6c65 6420 666f 7220 en compiled for │ │ │ │ │ -00009ca0: 7838 362d 3634 0a77 6974 6820 6f6c 6465 x86-64.with olde │ │ │ │ │ -00009cb0: 7220 4743 4320 7665 7273 696f 6e20 6164 r GCC version ad │ │ │ │ │ -00009cc0: 7265 7373 6162 6c65 2073 7061 6365 2069 ressable space i │ │ │ │ │ -00009cd0: 7320 6c69 6d69 7465 6420 746f 2032 4769 s limited to 2Gi │ │ │ │ │ -00009ce0: 422e 2046 6f72 2061 6c6c 0a6f 7468 6572 B. For all.other │ │ │ │ │ -00009cf0: 2070 6c61 7466 6f72 6d73 2061 6472 6573 platforms adres │ │ │ │ │ -00009d00: 7361 626c 6520 7370 6163 6520 6973 206c sable space is l │ │ │ │ │ -00009d10: 696d 6974 6564 2074 6f20 3447 6942 2e20 imited to 4GiB. │ │ │ │ │ -00009d20: 4752 5542 2061 6c6c 6f63 6174 6573 0a70 GRUB allocates.p │ │ │ │ │ -00009d30: 6167 6573 2066 726f 6d20 4546 4920 666f ages from EFI fo │ │ │ │ │ -00009d40: 7220 6974 7320 6865 6170 2c20 6174 206d r its heap, at m │ │ │ │ │ -00009d50: 6f73 7420 312e 3620 4769 422e 0a0a 2020 ost 1.6 GiB... │ │ │ │ │ -00009d60: 204f 6e20 6933 3836 2d69 6565 6531 3237 On i386-ieee127 │ │ │ │ │ -00009d70: 3520 616e 6420 706f 7765 7270 632d 6965 5 and powerpc-ie │ │ │ │ │ -00009d80: 6565 3132 3735 2047 5255 4220 7573 6573 ee1275 GRUB uses │ │ │ │ │ -00009d90: 2073 616d 6520 7374 6163 6b20 6173 0a49 same stack as.I │ │ │ │ │ -00009da0: 4545 4531 3237 352e 2020 4974 2061 6c6c EEE1275. It all │ │ │ │ │ -00009db0: 6f63 6174 6573 2061 7420 6d6f 7374 2033 ocates at most 3 │ │ │ │ │ -00009dc0: 324d 6942 2066 6f72 2069 7473 2068 6561 2MiB for its hea │ │ │ │ │ -00009dd0: 702e 0a0a 2020 204f 6e20 7370 6172 6336 p... On sparc6 │ │ │ │ │ -00009de0: 342d 6965 6565 3132 3735 2073 7461 636b 4-ieee1275 stack │ │ │ │ │ -00009df0: 2069 7320 3235 364b 6942 2061 6e64 2068 is 256KiB and h │ │ │ │ │ -00009e00: 6561 7020 6973 2032 4d69 422e 0a0a 2020 eap is 2MiB... │ │ │ │ │ -00009e10: 204f 6e20 6d69 7073 2865 6c29 2d71 656d On mips(el)-qem │ │ │ │ │ -00009e20: 755f 6d69 7073 2061 6e64 206d 6970 7365 u_mips and mipse │ │ │ │ │ -00009e30: 6c2d 6c6f 6f6e 6773 6f6e 2073 7461 636b l-loongson stack │ │ │ │ │ -00009e40: 2069 7320 324d 6942 2028 6576 6572 7974 is 2MiB (everyt │ │ │ │ │ -00009e50: 6869 6e67 0a62 656c 6f77 2047 5255 4220 hing.below GRUB │ │ │ │ │ -00009e60: 696d 6167 6529 2061 6e64 2065 7665 7279 image) and every │ │ │ │ │ -00009e70: 7468 696e 6720 6162 6f76 6520 4752 5542 thing above GRUB │ │ │ │ │ -00009e80: 2069 6d61 6765 2028 6672 6f6d 2032 4d69 image (from 2Mi │ │ │ │ │ -00009e90: 4220 2b20 6b65 726e 656c 0a73 697a 6529 B + kernel.size) │ │ │ │ │ -00009ea0: 2075 6e74 696c 2032 3536 4d69 4220 6973 until 256MiB is │ │ │ │ │ -00009eb0: 2070 6172 7420 6f66 2068 6561 702e 0a0a part of heap... │ │ │ │ │ -00009ec0: 2020 204f 6e20 6d69 7073 2d61 7263 2073 On mips-arc s │ │ │ │ │ -00009ed0: 7461 636b 2069 7320 324d 6942 2028 6576 tack is 2MiB (ev │ │ │ │ │ -00009ee0: 6572 7974 6869 6e67 2062 656c 6f77 2047 erything below G │ │ │ │ │ -00009ef0: 5255 4220 696d 6167 6529 2061 6e64 0a65 RUB image) and.e │ │ │ │ │ -00009f00: 7665 7279 7468 696e 6720 6162 6f76 6520 verything above │ │ │ │ │ -00009f10: 4752 5542 2069 6d61 6765 2866 726f 6d20 GRUB image(from │ │ │ │ │ -00009f20: 324d 6942 202b 206b 6572 6e65 6c20 7369 2MiB + kernel si │ │ │ │ │ -00009f30: 7a65 2920 756e 7469 6c20 3132 384d 6942 ze) until 128MiB │ │ │ │ │ -00009f40: 2069 730a 7061 7274 206f 6620 6865 6170 is.part of heap │ │ │ │ │ -00009f50: 2e0a 0a20 2020 4f6e 206d 6970 7365 6c2d ... On mipsel- │ │ │ │ │ -00009f60: 6172 6320 7374 6163 6b20 6973 2032 4d69 arc stack is 2Mi │ │ │ │ │ -00009f70: 4220 2865 7665 7279 7468 696e 6720 6265 B (everything be │ │ │ │ │ -00009f80: 6c6f 7720 4752 5542 2069 6d61 6765 2077 low GRUB image w │ │ │ │ │ -00009f90: 6869 6368 2069 7320 6e6f 740a 7061 7274 hich is not.part │ │ │ │ │ -00009fa0: 206f 6620 4152 4329 2061 6e64 2065 7665 of ARC) and eve │ │ │ │ │ -00009fb0: 7279 7468 696e 6720 6162 6f76 6520 4752 rything above GR │ │ │ │ │ -00009fc0: 5542 2069 6d61 6765 2028 6672 6f6d 2037 UB image (from 7 │ │ │ │ │ -00009fd0: 4d69 4220 2b20 6b65 726e 656c 2073 697a MiB + kernel siz │ │ │ │ │ -00009fe0: 6529 0a75 6e74 696c 2032 3536 4d69 4220 e).until 256MiB │ │ │ │ │ -00009ff0: 6973 2070 6172 7420 6f66 2068 6561 702e is part of heap. │ │ │ │ │ -0000a000: 0a0a 2020 204f 6e20 6172 6d2d 7562 6f6f .. On arm-uboo │ │ │ │ │ -0000a010: 7420 7374 6163 6b20 6973 2032 3536 4b69 t stack is 256Ki │ │ │ │ │ -0000a020: 4220 616e 6420 6865 6170 2069 7320 324d B and heap is 2M │ │ │ │ │ -0000a030: 6942 2e0a 0a20 2020 496e 2073 686f 7274 iB... In short │ │ │ │ │ -0000a040: 3a0a 0a50 6c61 7466 6f72 6d20 2020 2053 :..Platform S │ │ │ │ │ -0000a050: 7461 636b 2020 2020 2020 2020 2020 2020 tack │ │ │ │ │ -0000a060: 2020 4865 6170 0a2d 2d2d 2d2d 2d2d 2d2d Heap.--------- │ │ │ │ │ +00008e80: 2020 2020 2020 2020 2031 3029 3b0a 2020 10);. │ │ │ │ │ +00008e90: 2020 207d 0a0a 2020 2049 6620 7468 6572 }.. If ther │ │ │ │ │ +00008ea0: 6520 6973 2061 2073 7065 6369 616c 2072 e is a special r │ │ │ │ │ +00008eb0: 6561 736f 6e20 7468 6174 2065 7272 6f72 eason that error │ │ │ │ │ +00008ec0: 2063 6f64 6520 646f 6573 206e 6f74 206e code does not n │ │ │ │ │ +00008ed0: 6565 6420 746f 2062 650a 7461 6b65 6e20 eed to be.taken │ │ │ │ │ +00008ee0: 6163 636f 756e 742c 2027 6772 7562 5f65 account, 'grub_e │ │ │ │ │ +00008ef0: 7272 6e6f 2720 6361 6e20 6265 207a 6572 rrno' can be zer │ │ │ │ │ +00008f00: 6f65 6420 6261 636b 2074 6f20 2747 5255 oed back to 'GRU │ │ │ │ │ +00008f10: 425f 4552 525f 4e4f 4e45 272e 2020 496e B_ERR_NONE'. In │ │ │ │ │ +00008f20: 0a63 6173 6573 206c 696b 6520 7468 6973 .cases like this │ │ │ │ │ +00008f30: 2061 6c6c 2070 7265 7669 6f75 7320 6572 all previous er │ │ │ │ │ +00008f40: 726f 7220 636f 6465 7320 7368 6f75 6c64 ror codes should │ │ │ │ │ +00008f50: 2068 6176 6520 6265 656e 2068 616e 646c have been handl │ │ │ │ │ +00008f60: 6564 0a63 6f72 7265 6374 6c79 2e20 2054 ed.correctly. T │ │ │ │ │ +00008f70: 6869 7320 6d61 6b65 7320 7375 7265 2074 his makes sure t │ │ │ │ │ +00008f80: 6861 7420 7468 6572 6520 6172 6520 6e6f hat there are no │ │ │ │ │ +00008f90: 2075 6e68 616e 646c 6564 2065 7863 6570 unhandled excep │ │ │ │ │ +00008fa0: 7469 6f6e 732e 0a0a 2020 2045 7861 6d70 tions... Examp │ │ │ │ │ +00008fb0: 6c65 206f 6620 7a65 726f 696e 6720 2767 le of zeroing 'g │ │ │ │ │ +00008fc0: 7275 625f 6572 726e 6f27 2e0a 2020 2020 rub_errno'.. │ │ │ │ │ +00008fd0: 2067 7275 625f 6572 725f 740a 2020 2020 grub_err_t. │ │ │ │ │ +00008fe0: 2070 726f 6265 5f65 7861 6d70 6c65 2028 probe_example ( │ │ │ │ │ +00008ff0: 290a 2020 2020 207b 0a20 2020 2020 2020 ). {. │ │ │ │ │ +00009000: 2f2a 2054 7279 2074 6f20 7072 6f62 6520 /* Try to probe │ │ │ │ │ +00009010: 6465 7669 6365 2074 7970 6520 312e 2020 device type 1. │ │ │ │ │ +00009020: 2a2f 0a20 2020 2020 2020 7072 6f62 655f */. probe_ │ │ │ │ │ +00009030: 666f 725f 6465 7669 6365 2028 293b 0a20 for_device ();. │ │ │ │ │ +00009040: 2020 2020 2020 6966 2028 6772 7562 5f65 if (grub_e │ │ │ │ │ +00009050: 7272 6e6f 203d 3d20 4752 5542 5f45 5252 rrno == GRUB_ERR │ │ │ │ │ +00009060: 5f4e 4f4e 4529 0a20 2020 2020 2020 2020 _NONE). │ │ │ │ │ +00009070: 7b0a 2020 2020 2020 2020 2020 202f 2a20 {. /* │ │ │ │ │ +00009080: 4465 7669 6365 2074 7970 6520 3120 7761 Device type 1 wa │ │ │ │ │ +00009090: 7320 666f 756e 6420 6f6e 2073 7973 7465 s found on syste │ │ │ │ │ +000090a0: 6d2e 2020 2a2f 0a20 2020 2020 2020 2020 m. */. │ │ │ │ │ +000090b0: 2020 7265 6769 7374 6572 5f64 6576 6963 register_devic │ │ │ │ │ +000090c0: 6520 2829 3b0a 2020 2020 2020 2020 2020 e ();. │ │ │ │ │ +000090d0: 2072 6574 7572 6e20 4752 5542 5f45 5252 return GRUB_ERR │ │ │ │ │ +000090e0: 5f4e 4f4e 453b 0a20 2020 2020 2020 2020 _NONE;. │ │ │ │ │ +000090f0: 7d0a 2020 2020 2020 202f 2a20 5a65 726f }. /* Zero │ │ │ │ │ +00009100: 206f 7574 2065 7272 6f72 2063 6f64 652e out error code. │ │ │ │ │ +00009110: 2020 2a2f 0a20 2020 2020 2020 6772 7562 */. grub │ │ │ │ │ +00009120: 5f65 7272 6e6f 203d 2047 5255 425f 4552 _errno = GRUB_ER │ │ │ │ │ +00009130: 525f 4e4f 4e45 3b0a 0a20 2020 2020 2020 R_NONE;.. │ │ │ │ │ +00009140: 2f2a 204e 6f20 6465 7669 6365 2074 7970 /* No device typ │ │ │ │ │ +00009150: 6520 3120 666f 756e 642c 2074 7279 2074 e 1 found, try t │ │ │ │ │ +00009160: 6f20 7072 6f62 6520 6465 7669 6365 2074 o probe device t │ │ │ │ │ +00009170: 7970 6520 322e 2020 2a2f 0a20 2020 2020 ype 2. */. │ │ │ │ │ +00009180: 2020 7072 6f62 655f 666f 725f 6465 7669 probe_for_devi │ │ │ │ │ +00009190: 6365 3220 2829 3b0a 2020 2020 2020 2069 ce2 ();. i │ │ │ │ │ +000091a0: 6620 2867 7275 625f 6572 726e 6f20 3d3d f (grub_errno == │ │ │ │ │ +000091b0: 2047 5255 425f 4552 525f 4e4f 4e45 290a GRUB_ERR_NONE). │ │ │ │ │ +000091c0: 2020 2020 2020 2020 207b 0a20 2020 2020 {. │ │ │ │ │ +000091d0: 2020 2020 2020 2f2a 2044 6576 6963 6520 /* Device │ │ │ │ │ +000091e0: 7479 7065 2032 2077 6173 2066 6f75 6e64 type 2 was found │ │ │ │ │ +000091f0: 206f 6e20 7379 7374 656d 2e20 202a 2f0a on system. */. │ │ │ │ │ +00009200: 2020 2020 2020 2020 2020 2072 6567 6973 regis │ │ │ │ │ +00009210: 7465 725f 6465 7669 6365 3220 2829 3b0a ter_device2 ();. │ │ │ │ │ +00009220: 2020 2020 2020 2020 2020 2072 6574 7572 retur │ │ │ │ │ +00009230: 6e20 4752 5542 5f45 5252 5f4e 4f4e 453b n GRUB_ERR_NONE; │ │ │ │ │ +00009240: 0a20 2020 2020 2020 2020 7d0a 2020 2020 . }. │ │ │ │ │ +00009250: 2020 202f 2a20 5a65 726f 206f 7574 2065 /* Zero out e │ │ │ │ │ +00009260: 7272 6f72 2063 6f64 652e 2020 2a2f 0a20 rror code. */. │ │ │ │ │ +00009270: 2020 2020 2020 6772 7562 5f65 7272 6e6f grub_errno │ │ │ │ │ +00009280: 203d 2047 5255 425f 4552 525f 4e4f 4e45 = GRUB_ERR_NONE │ │ │ │ │ +00009290: 3b0a 0a20 2020 2020 2020 2f2a 2052 6574 ;.. /* Ret │ │ │ │ │ +000092a0: 7572 6e20 6375 7374 6f6d 2065 7272 6f72 urn custom error │ │ │ │ │ +000092b0: 206d 6573 7361 6765 2e20 202a 2f0a 2020 message. */. │ │ │ │ │ +000092c0: 2020 2020 2072 6574 7572 6e20 6772 7562 return grub │ │ │ │ │ +000092d0: 5f65 7272 6f72 2028 4752 5542 5f45 5252 _error (GRUB_ERR │ │ │ │ │ +000092e0: 5f55 4e4b 4e4f 574e 5f44 4556 4943 452c _UNKNOWN_DEVICE, │ │ │ │ │ +000092f0: 2022 4e6f 2064 6576 6963 6520 7479 7065 "No device type │ │ │ │ │ +00009300: 2031 206f 7220 3220 666f 756e 642e 2229 1 or 2 found.") │ │ │ │ │ +00009310: 3b0a 2020 2020 207d 0a0a 2020 2053 6f6d ;. }.. Som │ │ │ │ │ +00009320: 6520 7469 6d65 7320 7468 6572 6520 6973 e times there is │ │ │ │ │ +00009330: 2061 206e 6565 6420 746f 2063 6f6e 7469 a need to conti │ │ │ │ │ +00009340: 6e75 6520 7072 6f63 6573 7369 6e67 2065 nue processing e │ │ │ │ │ +00009350: 7665 6e20 6966 2074 6865 7265 2069 7320 ven if there is │ │ │ │ │ +00009360: 610a 6572 726f 7220 7374 6174 6520 696e a.error state in │ │ │ │ │ +00009370: 2061 7070 6c69 6361 7469 6f6e 2e20 2049 application. I │ │ │ │ │ +00009380: 6e20 7369 7475 6174 696f 6e73 206c 696b n situations lik │ │ │ │ │ +00009390: 6520 7468 6973 2c20 7468 6572 6520 6973 e this, there is │ │ │ │ │ +000093a0: 2061 206e 6565 6465 640a 746f 2073 6176 a needed.to sav │ │ │ │ │ +000093b0: 6520 6f6c 6420 6572 726f 7220 7374 6174 e old error stat │ │ │ │ │ +000093c0: 6520 616e 6420 7468 656e 2063 616c 6c20 e and then call │ │ │ │ │ +000093d0: 6f74 6865 7220 6675 6e63 7469 6f6e 7320 other functions │ │ │ │ │ +000093e0: 7468 6174 206d 6967 6874 2066 6169 6c2e that might fail. │ │ │ │ │ +000093f0: 0a54 6f20 6169 6420 696e 2074 6869 732c .To aid in this, │ │ │ │ │ +00009400: 2074 6865 7265 2069 7320 6120 6572 726f there is a erro │ │ │ │ │ +00009410: 7220 7374 6163 6b20 696d 706c 656d 656e r stack implemen │ │ │ │ │ +00009420: 7465 642e 2020 4572 726f 7220 7374 6174 ted. Error stat │ │ │ │ │ +00009430: 6520 6361 6e20 6265 0a70 7573 6865 6420 e can be.pushed │ │ │ │ │ +00009440: 746f 2065 7272 6f72 2073 7461 636b 2062 to error stack b │ │ │ │ │ +00009450: 7920 6361 6c6c 696e 6720 6675 6e63 7469 y calling functi │ │ │ │ │ +00009460: 6f6e 2027 6772 7562 5f65 7272 6f72 5f70 on 'grub_error_p │ │ │ │ │ +00009470: 7573 6820 2829 272e 2020 5768 656e 0a70 ush ()'. When.p │ │ │ │ │ +00009480: 726f 6365 7373 696e 6720 6861 7320 6265 rocessing has be │ │ │ │ │ +00009490: 656e 2063 6f6d 706c 6574 6564 2c20 2767 en completed, 'g │ │ │ │ │ +000094a0: 7275 625f 6572 726f 725f 706f 7020 2829 rub_error_pop () │ │ │ │ │ +000094b0: 2720 6361 6e20 6265 2075 7365 6420 746f ' can be used to │ │ │ │ │ +000094c0: 2070 6f70 0a65 7272 6f72 2073 7461 7465 pop.error state │ │ │ │ │ +000094d0: 2066 726f 6d20 7374 6163 6b2e 2020 4572 from stack. Er │ │ │ │ │ +000094e0: 726f 7220 7374 6163 6b20 636f 6e74 6169 ror stack contai │ │ │ │ │ +000094f0: 6e73 2070 7265 6465 6669 6e65 6420 616d ns predefined am │ │ │ │ │ +00009500: 6f75 6e74 206f 6620 6572 726f 720a 7374 ount of error.st │ │ │ │ │ +00009510: 6163 6b20 6974 656d 732e 2020 4572 726f ack items. Erro │ │ │ │ │ +00009520: 7220 7374 6163 6b20 6973 2070 726f 7465 r stack is prote │ │ │ │ │ +00009530: 6374 6564 2066 6f72 206f 7665 7266 6c6f cted for overflo │ │ │ │ │ +00009540: 7720 616e 6420 6d61 726b 7320 7468 6573 w and marks thes │ │ │ │ │ +00009550: 650a 7369 7475 6174 696f 6e73 2073 6f20 e.situations so │ │ │ │ │ +00009560: 6f76 6572 666c 6f77 2065 7272 6f72 2064 overflow error d │ │ │ │ │ +00009570: 6f65 7320 6e6f 7420 6765 7420 756e 7365 oes not get unse │ │ │ │ │ +00009580: 656e 2e20 2049 6620 7468 6572 6520 6973 en. If there is │ │ │ │ │ +00009590: 206e 6f20 7370 6163 650a 6176 6169 6c61 no space.availa │ │ │ │ │ +000095a0: 626c 6520 746f 2073 746f 7265 2065 7272 ble to store err │ │ │ │ │ +000095b0: 6f72 206d 6573 7361 6765 2c20 6974 2069 or message, it i │ │ │ │ │ +000095c0: 7320 7369 6d70 6c79 2064 6973 6361 7264 s simply discard │ │ │ │ │ +000095d0: 6564 2061 6e64 206f 7665 7266 6c6f 770a ed and overflow. │ │ │ │ │ +000095e0: 7769 6c6c 2062 6520 6d61 726b 6564 2061 will be marked a │ │ │ │ │ +000095f0: 7320 6861 7070 656e 6564 2e20 2057 6865 s happened. Whe │ │ │ │ │ +00009600: 6e20 6f76 6572 666c 6f77 2068 6170 7065 n overflow happe │ │ │ │ │ +00009610: 6e73 2c20 6974 206d 6f73 7420 6c69 6b65 ns, it most like │ │ │ │ │ +00009620: 6c79 2077 696c 6c0a 636f 7272 7570 7420 ly will.corrupt │ │ │ │ │ +00009630: 6572 726f 7220 7374 6163 6b20 636f 6e73 error stack cons │ │ │ │ │ +00009640: 6973 7465 6e63 7920 6173 2066 6f72 2070 istency as for p │ │ │ │ │ +00009650: 7573 6865 6420 6572 726f 7220 7468 6572 ushed error ther │ │ │ │ │ +00009660: 6520 6973 206e 6f20 6d61 7463 6869 6e67 e is no matching │ │ │ │ │ +00009670: 0a70 6f70 2c20 6275 7420 6f76 6572 666c .pop, but overfl │ │ │ │ │ +00009680: 6f77 206d 6573 7361 6765 2077 696c 6c20 ow message will │ │ │ │ │ +00009690: 6265 2073 686f 776e 2074 6f20 696e 666f be shown to info │ │ │ │ │ +000096a0: 726d 2075 7365 7220 6162 6f75 7420 7468 rm user about th │ │ │ │ │ +000096b0: 650a 7369 7475 6174 696f 6e2e 2020 4f76 e.situation. Ov │ │ │ │ │ +000096c0: 6572 666c 6f77 206d 6573 7361 6765 2077 erflow message w │ │ │ │ │ +000096d0: 696c 6c20 6265 2073 686f 776e 2061 7420 ill be shown at │ │ │ │ │ +000096e0: 7469 6d65 2077 6865 6e20 7072 6f6d 7074 time when prompt │ │ │ │ │ +000096f0: 2069 7320 6162 6f75 740a 746f 2062 6520 is about.to be │ │ │ │ │ +00009700: 6472 6177 6e2e 0a0a 2020 2045 7861 6d70 drawn... Examp │ │ │ │ │ +00009710: 6c65 2075 7361 6765 206f 6620 6572 726f le usage of erro │ │ │ │ │ +00009720: 7220 7374 6163 6b2e 0a20 2020 2020 2f2a r stack.. /* │ │ │ │ │ +00009730: 2053 6176 6520 706f 7373 6962 6c65 206f Save possible o │ │ │ │ │ +00009740: 6c64 2065 7272 6f72 206d 6573 7361 6765 ld error message │ │ │ │ │ +00009750: 2e20 202a 2f0a 2020 2020 2067 7275 625f . */. grub_ │ │ │ │ │ +00009760: 6572 726f 725f 7075 7368 2028 293b 0a0a error_push ();.. │ │ │ │ │ +00009770: 2020 2020 202f 2a20 446f 2079 6f75 7220 /* Do your │ │ │ │ │ +00009780: 7374 7566 6620 6865 7265 2e20 202a 2f0a stuff here. */. │ │ │ │ │ +00009790: 2020 2020 2063 616c 6c5f 706f 7373 6962 call_possib │ │ │ │ │ +000097a0: 6c79 5f66 6169 6c69 6e67 5f66 756e 6374 ly_failing_funct │ │ │ │ │ +000097b0: 696f 6e20 2829 3b0a 0a20 2020 2020 6966 ion ();.. if │ │ │ │ │ +000097c0: 2028 6772 7562 5f65 7272 6e6f 2021 3d20 (grub_errno != │ │ │ │ │ +000097d0: 4752 5542 5f45 5252 5f4e 4f4e 4529 0a20 GRUB_ERR_NONE). │ │ │ │ │ +000097e0: 2020 2020 2020 7b0a 2020 2020 2020 2020 {. │ │ │ │ │ +000097f0: 202f 2a20 496e 666f 726d 2072 6573 7420 /* Inform rest │ │ │ │ │ +00009800: 6f66 2074 6865 2063 6f64 6520 7468 6174 of the code that │ │ │ │ │ +00009810: 2074 6865 7265 2069 7320 6572 726f 7220 there is error │ │ │ │ │ +00009820: 2867 7275 625f 6572 726e 6f0a 2020 2020 (grub_errno. │ │ │ │ │ +00009830: 2020 2020 2020 2020 6973 2073 6574 292e is set). │ │ │ │ │ +00009840: 2054 6865 7265 2069 7320 6e6f 2070 6f70 There is no pop │ │ │ │ │ +00009850: 2068 6572 6520 6173 2077 6520 7761 6e74 here as we want │ │ │ │ │ +00009860: 2062 6f74 6820 6572 726f 7220 7374 6174 both error stat │ │ │ │ │ +00009870: 6573 0a20 2020 2020 2020 2020 2020 2074 es. t │ │ │ │ │ +00009880: 6f20 6265 2064 6973 706c 6179 6564 2e20 o be displayed. │ │ │ │ │ +00009890: 202a 2f0a 2020 2020 2020 2020 2072 6574 */. ret │ │ │ │ │ +000098a0: 7572 6e3b 0a20 2020 2020 2020 7d0a 0a20 urn;. }.. │ │ │ │ │ +000098b0: 2020 2020 2f2a 2052 6573 746f 7265 206f /* Restore o │ │ │ │ │ +000098c0: 6c64 2065 7272 6f72 2073 7461 7465 2062 ld error state b │ │ │ │ │ +000098d0: 7920 706f 7070 696e 6720 7072 6576 696f y popping previo │ │ │ │ │ +000098e0: 7573 2069 7465 6d20 6672 6f6d 2073 7461 us item from sta │ │ │ │ │ +000098f0: 636b 2e20 2a2f 0a20 2020 2020 6772 7562 ck. */. grub │ │ │ │ │ +00009900: 5f65 7272 6f72 5f70 6f70 2028 293b 0a0a _error_pop ();.. │ │ │ │ │ +00009910: 1f0a 4669 6c65 3a20 6772 7562 2d64 6576 ..File: grub-dev │ │ │ │ │ +00009920: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5374 .info, Node: St │ │ │ │ │ +00009930: 6163 6b20 616e 6420 6865 6170 2073 697a ack and heap siz │ │ │ │ │ +00009940: 652c 2020 4e65 7874 3a20 4249 4f53 2070 e, Next: BIOS p │ │ │ │ │ +00009950: 6f72 7420 6d65 6d6f 7279 206d 6170 2c20 ort memory map, │ │ │ │ │ +00009960: 2050 7265 763a 2045 7272 6f72 2048 616e Prev: Error Han │ │ │ │ │ +00009970: 646c 696e 672c 2020 5570 3a20 546f 700a dling, Up: Top. │ │ │ │ │ +00009980: 0a38 2053 7461 636b 2061 6e64 2068 6561 .8 Stack and hea │ │ │ │ │ +00009990: 7020 7369 7a65 0a2a 2a2a 2a2a 2a2a 2a2a p size.********* │ │ │ │ │ +000099a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4f6e ************..On │ │ │ │ │ +000099b0: 2065 6d75 2073 7461 636b 2061 6e64 2068 emu stack and h │ │ │ │ │ +000099c0: 6561 7020 6172 6520 6a75 7374 206e 6f72 eap are just nor │ │ │ │ │ +000099d0: 6d61 6c20 686f 7374 204f 5320 7374 6163 mal host OS stac │ │ │ │ │ +000099e0: 6b20 616e 6420 6865 6170 2e20 2053 7461 k and heap. Sta │ │ │ │ │ +000099f0: 636b 2069 730a 7479 7069 6361 6c6c 7920 ck is.typically │ │ │ │ │ +00009a00: 3820 4d69 4220 616c 7468 6f75 6768 2069 8 MiB although i │ │ │ │ │ +00009a10: 7427 7320 4f53 2d64 6570 656e 6465 6e74 t's OS-dependent │ │ │ │ │ +00009a20: 2e0a 0a20 2020 4f6e 2069 3338 362d 7063 ... On i386-pc │ │ │ │ │ +00009a30: 2c20 6933 3836 2d63 6f72 6562 6f6f 742c , i386-coreboot, │ │ │ │ │ +00009a40: 2069 3338 362d 7165 6d75 2061 6e64 2069 i386-qemu and i │ │ │ │ │ +00009a50: 3338 362d 6d75 6c74 6962 6f6f 7420 7468 386-multiboot th │ │ │ │ │ +00009a60: 6520 7374 6163 6b20 6973 0a36 304b 6942 e stack is.60KiB │ │ │ │ │ +00009a70: 2e20 416c 6c20 6176 6169 6c61 626c 6520 . All available │ │ │ │ │ +00009a80: 7370 6163 6520 6265 7477 6565 6e20 314d space between 1M │ │ │ │ │ +00009a90: 6942 2061 6e64 2034 4769 4220 6d61 726b iB and 4GiB mark │ │ │ │ │ +00009aa0: 7320 6973 2070 6172 7420 6f66 2068 6561 s is part of hea │ │ │ │ │ +00009ab0: 702e 0a0a 2020 204f 6e20 2a2d 7865 6e20 p... On *-xen │ │ │ │ │ +00009ac0: 7374 6163 6b20 6973 2034 4d69 422e 2049 stack is 4MiB. I │ │ │ │ │ +00009ad0: 6620 636f 6d70 696c 6564 2066 6f72 2078 f compiled for x │ │ │ │ │ +00009ae0: 3836 2d36 3420 7769 7468 2047 4343 2034 86-64 with GCC 4 │ │ │ │ │ +00009af0: 2e34 206f 7220 6c61 7465 720a 6164 7265 .4 or later.adre │ │ │ │ │ +00009b00: 7373 6162 6c65 2073 7061 6365 2069 7320 ssable space is │ │ │ │ │ +00009b10: 756e 6c69 6d69 7465 642e 2020 5768 656e unlimited. When │ │ │ │ │ +00009b20: 2063 6f6d 7069 6c65 6420 666f 7220 7838 compiled for x8 │ │ │ │ │ +00009b30: 362d 3634 2077 6974 6820 6f6c 6465 7220 6-64 with older │ │ │ │ │ +00009b40: 4743 430a 7665 7273 696f 6e20 6164 7265 GCC.version adre │ │ │ │ │ +00009b50: 7373 6162 6c65 2073 7061 6365 2069 7320 ssable space is │ │ │ │ │ +00009b60: 6c69 6d69 7465 6420 746f 2032 4769 422e limited to 2GiB. │ │ │ │ │ +00009b70: 2057 6865 6e20 636f 6d70 696c 696e 6720 When compiling │ │ │ │ │ +00009b80: 666f 7220 6933 3836 0a61 6472 6573 7361 for i386.adressa │ │ │ │ │ +00009b90: 626c 6520 7370 6163 6520 6973 206c 696d ble space is lim │ │ │ │ │ +00009ba0: 6974 6564 2074 6f20 3447 6942 2e20 416c ited to 4GiB. Al │ │ │ │ │ +00009bb0: 6c20 6164 7265 7373 6162 6c65 2070 6167 l adressable pag │ │ │ │ │ +00009bc0: 6573 2065 7863 6570 7420 7468 650a 6f6e es except the.on │ │ │ │ │ +00009bd0: 6573 2066 6f72 2073 7461 636b 2c20 4752 es for stack, GR │ │ │ │ │ +00009be0: 5542 2062 696e 6172 792c 2073 7065 6369 UB binary, speci │ │ │ │ │ +00009bf0: 616c 2070 6167 6573 2061 6e64 2070 6167 al pages and pag │ │ │ │ │ +00009c00: 6520 7461 626c 6520 6172 6520 696e 2074 e table are in t │ │ │ │ │ +00009c10: 6865 0a68 6561 702e 0a0a 2020 204f 6e20 he.heap... On │ │ │ │ │ +00009c20: 2a2d 6566 6920 4752 5542 2075 7365 7320 *-efi GRUB uses │ │ │ │ │ +00009c30: 7361 6d65 2073 7461 636b 2061 7320 4546 same stack as EF │ │ │ │ │ +00009c40: 492e 2049 6620 636f 6d70 696c 6564 2066 I. If compiled f │ │ │ │ │ +00009c50: 6f72 2078 3836 2d36 3420 7769 7468 2047 or x86-64 with G │ │ │ │ │ +00009c60: 4343 0a34 2e34 206f 7220 6c61 7465 7220 CC.4.4 or later │ │ │ │ │ +00009c70: 6164 7265 7373 6162 6c65 2073 7061 6365 adressable space │ │ │ │ │ +00009c80: 2069 7320 756e 6c69 6d69 7465 642e 2020 is unlimited. │ │ │ │ │ +00009c90: 5768 656e 2063 6f6d 7069 6c65 6420 666f When compiled fo │ │ │ │ │ +00009ca0: 7220 7838 362d 3634 0a77 6974 6820 6f6c r x86-64.with ol │ │ │ │ │ +00009cb0: 6465 7220 4743 4320 7665 7273 696f 6e20 der GCC version │ │ │ │ │ +00009cc0: 6164 7265 7373 6162 6c65 2073 7061 6365 adressable space │ │ │ │ │ +00009cd0: 2069 7320 6c69 6d69 7465 6420 746f 2032 is limited to 2 │ │ │ │ │ +00009ce0: 4769 422e 2046 6f72 2061 6c6c 0a6f 7468 GiB. For all.oth │ │ │ │ │ +00009cf0: 6572 2070 6c61 7466 6f72 6d73 2061 6472 er platforms adr │ │ │ │ │ +00009d00: 6573 7361 626c 6520 7370 6163 6520 6973 essable space is │ │ │ │ │ +00009d10: 206c 696d 6974 6564 2074 6f20 3447 6942 limited to 4GiB │ │ │ │ │ +00009d20: 2e20 4752 5542 2061 6c6c 6f63 6174 6573 . GRUB allocates │ │ │ │ │ +00009d30: 0a70 6167 6573 2066 726f 6d20 4546 4920 .pages from EFI │ │ │ │ │ +00009d40: 666f 7220 6974 7320 6865 6170 2c20 6174 for its heap, at │ │ │ │ │ +00009d50: 206d 6f73 7420 312e 3620 4769 422e 0a0a most 1.6 GiB... │ │ │ │ │ +00009d60: 2020 204f 6e20 6933 3836 2d69 6565 6531 On i386-ieee1 │ │ │ │ │ +00009d70: 3237 3520 616e 6420 706f 7765 7270 632d 275 and powerpc- │ │ │ │ │ +00009d80: 6965 6565 3132 3735 2047 5255 4220 7573 ieee1275 GRUB us │ │ │ │ │ +00009d90: 6573 2073 616d 6520 7374 6163 6b20 6173 es same stack as │ │ │ │ │ +00009da0: 0a49 4545 4531 3237 352e 2020 4974 2061 .IEEE1275. It a │ │ │ │ │ +00009db0: 6c6c 6f63 6174 6573 2061 7420 6d6f 7374 llocates at most │ │ │ │ │ +00009dc0: 2033 324d 6942 2066 6f72 2069 7473 2068 32MiB for its h │ │ │ │ │ +00009dd0: 6561 702e 0a0a 2020 204f 6e20 7370 6172 eap... On spar │ │ │ │ │ +00009de0: 6336 342d 6965 6565 3132 3735 2073 7461 c64-ieee1275 sta │ │ │ │ │ +00009df0: 636b 2069 7320 3235 364b 6942 2061 6e64 ck is 256KiB and │ │ │ │ │ +00009e00: 2068 6561 7020 6973 2032 4d69 422e 0a0a heap is 2MiB... │ │ │ │ │ +00009e10: 2020 204f 6e20 6d69 7073 2865 6c29 2d71 On mips(el)-q │ │ │ │ │ +00009e20: 656d 755f 6d69 7073 2061 6e64 206d 6970 emu_mips and mip │ │ │ │ │ +00009e30: 7365 6c2d 6c6f 6f6e 6773 6f6e 2073 7461 sel-loongson sta │ │ │ │ │ +00009e40: 636b 2069 7320 324d 6942 2028 6576 6572 ck is 2MiB (ever │ │ │ │ │ +00009e50: 7974 6869 6e67 0a62 656c 6f77 2047 5255 ything.below GRU │ │ │ │ │ +00009e60: 4220 696d 6167 6529 2061 6e64 2065 7665 B image) and eve │ │ │ │ │ +00009e70: 7279 7468 696e 6720 6162 6f76 6520 4752 rything above GR │ │ │ │ │ +00009e80: 5542 2069 6d61 6765 2028 6672 6f6d 2032 UB image (from 2 │ │ │ │ │ +00009e90: 4d69 4220 2b20 6b65 726e 656c 0a73 697a MiB + kernel.siz │ │ │ │ │ +00009ea0: 6529 2075 6e74 696c 2032 3536 4d69 4220 e) until 256MiB │ │ │ │ │ +00009eb0: 6973 2070 6172 7420 6f66 2068 6561 702e is part of heap. │ │ │ │ │ +00009ec0: 0a0a 2020 204f 6e20 6d69 7073 2d61 7263 .. On mips-arc │ │ │ │ │ +00009ed0: 2073 7461 636b 2069 7320 324d 6942 2028 stack is 2MiB ( │ │ │ │ │ +00009ee0: 6576 6572 7974 6869 6e67 2062 656c 6f77 everything below │ │ │ │ │ +00009ef0: 2047 5255 4220 696d 6167 6529 2061 6e64 GRUB image) and │ │ │ │ │ +00009f00: 0a65 7665 7279 7468 696e 6720 6162 6f76 .everything abov │ │ │ │ │ +00009f10: 6520 4752 5542 2069 6d61 6765 2866 726f e GRUB image(fro │ │ │ │ │ +00009f20: 6d20 324d 6942 202b 206b 6572 6e65 6c20 m 2MiB + kernel │ │ │ │ │ +00009f30: 7369 7a65 2920 756e 7469 6c20 3132 384d size) until 128M │ │ │ │ │ +00009f40: 6942 2069 730a 7061 7274 206f 6620 6865 iB is.part of he │ │ │ │ │ +00009f50: 6170 2e0a 0a20 2020 4f6e 206d 6970 7365 ap... On mipse │ │ │ │ │ +00009f60: 6c2d 6172 6320 7374 6163 6b20 6973 2032 l-arc stack is 2 │ │ │ │ │ +00009f70: 4d69 4220 2865 7665 7279 7468 696e 6720 MiB (everything │ │ │ │ │ +00009f80: 6265 6c6f 7720 4752 5542 2069 6d61 6765 below GRUB image │ │ │ │ │ +00009f90: 2077 6869 6368 2069 7320 6e6f 740a 7061 which is not.pa │ │ │ │ │ +00009fa0: 7274 206f 6620 4152 4329 2061 6e64 2065 rt of ARC) and e │ │ │ │ │ +00009fb0: 7665 7279 7468 696e 6720 6162 6f76 6520 verything above │ │ │ │ │ +00009fc0: 4752 5542 2069 6d61 6765 2028 6672 6f6d GRUB image (from │ │ │ │ │ +00009fd0: 2037 4d69 4220 2b20 6b65 726e 656c 2073 7MiB + kernel s │ │ │ │ │ +00009fe0: 697a 6529 0a75 6e74 696c 2032 3536 4d69 ize).until 256Mi │ │ │ │ │ +00009ff0: 4220 6973 2070 6172 7420 6f66 2068 6561 B is part of hea │ │ │ │ │ +0000a000: 702e 0a0a 2020 204f 6e20 6172 6d2d 7562 p... On arm-ub │ │ │ │ │ +0000a010: 6f6f 7420 7374 6163 6b20 6973 2032 3536 oot stack is 256 │ │ │ │ │ +0000a020: 4b69 4220 616e 6420 6865 6170 2069 7320 KiB and heap is │ │ │ │ │ +0000a030: 324d 6942 2e0a 0a20 2020 496e 2073 686f 2MiB... In sho │ │ │ │ │ +0000a040: 7274 3a0a 0a50 6c61 7466 6f72 6d20 2020 rt:..Platform │ │ │ │ │ +0000a050: 2053 7461 636b 2020 2020 2020 2020 2020 Stack │ │ │ │ │ +0000a060: 2020 2020 4865 6170 0a2d 2d2d 2d2d 2d2d Heap.------- │ │ │ │ │ 0000a070: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a080: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a090: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000a0a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 656d 7520 -----------.emu │ │ │ │ │ -0000a0b0: 2020 2020 2020 2020 3820 4d69 4220 2020 8 MiB │ │ │ │ │ -0000a0c0: 2020 2020 2020 2020 2020 203f 0a69 3338 ?.i38 │ │ │ │ │ -0000a0d0: 362d 7063 2020 2020 2036 3020 4b69 4220 6-pc 60 KiB │ │ │ │ │ -0000a0e0: 2020 2020 2020 2020 2020 2020 3c20 3420 < 4 │ │ │ │ │ -0000a0f0: 4769 420a 6933 3836 2d63 6f72 6562 6f6f GiB.i386-coreboo │ │ │ │ │ -0000a100: 7436 3020 4b69 4220 2020 2020 2020 2020 t60 KiB │ │ │ │ │ -0000a110: 2020 203c 2034 2047 6942 0a69 3338 362d < 4 GiB.i386- │ │ │ │ │ -0000a120: 6d75 6c74 6962 6f6f 7436 3020 4b69 4220 multiboot60 KiB │ │ │ │ │ -0000a130: 2020 2020 2020 2020 2020 3c20 3420 4769 < 4 Gi │ │ │ │ │ -0000a140: 420a 6933 3836 2d71 656d 7520 2020 3630 B.i386-qemu 60 │ │ │ │ │ -0000a150: 204b 6942 2020 2020 2020 2020 2020 2020 KiB │ │ │ │ │ -0000a160: 203c 2034 2047 6942 0a2a 2d65 6669 2020 < 4 GiB.*-efi │ │ │ │ │ -0000a170: 2020 2020 203f 2020 2020 2020 2020 2020 ? │ │ │ │ │ -0000a180: 2020 2020 2020 2020 3c20 312e 3620 4769 < 1.6 Gi │ │ │ │ │ -0000a190: 420a 6933 3836 2d69 6565 6531 3237 353f B.i386-ieee1275? │ │ │ │ │ -0000a1a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a1b0: 203c 2033 3220 4d69 420a 706f 7765 7270 < 32 MiB.powerp │ │ │ │ │ -0000a1c0: 632d 6965 6565 3132 3735 3f20 2020 2020 c-ieee1275? │ │ │ │ │ -0000a1d0: 2020 2020 2020 2020 203c 2033 3220 4d69 < 32 Mi │ │ │ │ │ -0000a1e0: 420a 7370 6172 6336 342d 6965 6565 3132 B.sparc64-ieee12 │ │ │ │ │ -0000a1f0: 3735 3235 364b 6942 2020 2020 2020 2020 75256KiB │ │ │ │ │ -0000a200: 2032 204d 6942 0a61 726d 2d75 626f 6f74 2 MiB.arm-uboot │ │ │ │ │ -0000a210: 2020 2032 3536 4b69 4220 2020 2020 2020 256KiB │ │ │ │ │ -0000a220: 2020 2020 2020 3220 4d69 420a 6d69 7073 2 MiB.mips │ │ │ │ │ -0000a230: 2865 6c29 2d71 656d 755f 6d69 7073 324d (el)-qemu_mips2M │ │ │ │ │ -0000a240: 6942 2020 2020 2020 2020 2032 3533 204d iB 253 M │ │ │ │ │ -0000a250: 6942 0a6d 6970 7365 6c2d 6c6f 6f6e 6773 iB.mipsel-loongs │ │ │ │ │ -0000a260: 6f6e 324d 6942 2020 2020 2020 2020 2020 on2MiB │ │ │ │ │ -0000a270: 2020 3235 3320 4d69 420a 6d69 7073 2d61 253 MiB.mips-a │ │ │ │ │ -0000a280: 7263 2020 2020 324d 6942 2020 2020 2020 rc 2MiB │ │ │ │ │ -0000a290: 2020 2020 2020 2020 2031 3235 204d 6942 125 MiB │ │ │ │ │ -0000a2a0: 0a6d 6970 7365 6c2d 6172 6320 2032 4d69 .mipsel-arc 2Mi │ │ │ │ │ -0000a2b0: 4220 2020 2020 2020 2020 2020 2020 2020 B │ │ │ │ │ -0000a2c0: 3234 3820 4d69 420a 7838 365f 3634 2d78 248 MiB.x86_64-x │ │ │ │ │ -0000a2d0: 656e 2020 344d 6942 2020 2020 2020 2020 en 4MiB │ │ │ │ │ -0000a2e0: 2020 2020 2020 2075 6e6c 696d 6974 6564 unlimited │ │ │ │ │ -0000a2f0: 0a28 4743 4320 3e3d 0a34 2e34 290a 7838 .(GCC >=.4.4).x8 │ │ │ │ │ -0000a300: 365f 3634 2d78 656e 2020 344d 6942 2020 6_64-xen 4MiB │ │ │ │ │ -0000a310: 2020 2020 2020 2020 2020 2020 203c 2032 < 2 │ │ │ │ │ -0000a320: 4769 420a 2847 4343 203c 0a34 2e34 290a GiB.(GCC <.4.4). │ │ │ │ │ -0000a330: 6933 3836 2d78 656e 2020 2020 344d 6942 i386-xen 4MiB │ │ │ │ │ -0000a340: 2020 2020 2020 2020 2020 2020 2020 203c < │ │ │ │ │ -0000a350: 2034 4769 420a 0a1f 0a46 696c 653a 2067 4GiB....File: g │ │ │ │ │ -0000a360: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ │ -0000a370: 6f64 653a 2042 494f 5320 706f 7274 206d ode: BIOS port m │ │ │ │ │ -0000a380: 656d 6f72 7920 6d61 702c 2020 4e65 7874 emory map, Next │ │ │ │ │ -0000a390: 3a20 5669 6465 6f20 5375 6273 7973 7465 : Video Subsyste │ │ │ │ │ -0000a3a0: 6d2c 2020 5072 6576 3a20 5374 6163 6b20 m, Prev: Stack │ │ │ │ │ -0000a3b0: 616e 6420 6865 6170 2073 697a 652c 2020 and heap size, │ │ │ │ │ -0000a3c0: 5570 3a20 546f 700a 0a39 2042 494f 5320 Up: Top..9 BIOS │ │ │ │ │ -0000a3d0: 706f 7274 206d 656d 6f72 7920 6d61 700a port memory map. │ │ │ │ │ -0000a3e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0000a3f0: 2a2a 2a2a 2a2a 0a0a 5374 6172 7420 2020 ******..Start │ │ │ │ │ -0000a400: 2020 2020 456e 6420 2020 2020 2020 2020 End │ │ │ │ │ -0000a410: 2020 2020 2020 2055 7361 6765 0a2d 2d2d Usage.--- │ │ │ │ │ +0000a0a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 656d -------------.em │ │ │ │ │ +0000a0b0: 7520 2020 2020 2020 2020 3820 4d69 4220 u 8 MiB │ │ │ │ │ +0000a0c0: 2020 2020 2020 2020 2020 2020 203f 0a69 ?.i │ │ │ │ │ +0000a0d0: 3338 362d 7063 2020 2020 2036 3020 4b69 386-pc 60 Ki │ │ │ │ │ +0000a0e0: 4220 2020 2020 2020 2020 2020 2020 3c20 B < │ │ │ │ │ +0000a0f0: 3420 4769 420a 6933 3836 2d63 6f72 6562 4 GiB.i386-coreb │ │ │ │ │ +0000a100: 6f6f 7436 3020 4b69 4220 2020 2020 2020 oot60 KiB │ │ │ │ │ +0000a110: 2020 2020 203c 2034 2047 6942 0a69 3338 < 4 GiB.i38 │ │ │ │ │ +0000a120: 362d 6d75 6c74 6962 6f6f 7436 3020 4b69 6-multiboot60 Ki │ │ │ │ │ +0000a130: 4220 2020 2020 2020 2020 2020 3c20 3420 B < 4 │ │ │ │ │ +0000a140: 4769 420a 6933 3836 2d71 656d 7520 2020 GiB.i386-qemu │ │ │ │ │ +0000a150: 3630 204b 6942 2020 2020 2020 2020 2020 60 KiB │ │ │ │ │ +0000a160: 2020 203c 2034 2047 6942 0a2a 2d65 6669 < 4 GiB.*-efi │ │ │ │ │ +0000a170: 2020 2020 2020 203f 2020 2020 2020 2020 ? │ │ │ │ │ +0000a180: 2020 2020 2020 2020 2020 3c20 312e 3620 < 1.6 │ │ │ │ │ +0000a190: 4769 420a 6933 3836 2d69 6565 6531 3237 GiB.i386-ieee127 │ │ │ │ │ +0000a1a0: 353f 2020 2020 2020 2020 2020 2020 2020 5? │ │ │ │ │ +0000a1b0: 2020 203c 2033 3220 4d69 420a 706f 7765 < 32 MiB.powe │ │ │ │ │ +0000a1c0: 7270 632d 6965 6565 3132 3735 3f20 2020 rpc-ieee1275? │ │ │ │ │ +0000a1d0: 2020 2020 2020 2020 2020 203c 2033 3220 < 32 │ │ │ │ │ +0000a1e0: 4d69 420a 7370 6172 6336 342d 6965 6565 MiB.sparc64-ieee │ │ │ │ │ +0000a1f0: 3132 3735 3235 364b 6942 2020 2020 2020 1275256KiB │ │ │ │ │ +0000a200: 2020 2032 204d 6942 0a61 726d 2d75 626f 2 MiB.arm-ubo │ │ │ │ │ +0000a210: 6f74 2020 2032 3536 4b69 4220 2020 2020 ot 256KiB │ │ │ │ │ +0000a220: 2020 2020 2020 2020 3220 4d69 420a 6d69 2 MiB.mi │ │ │ │ │ +0000a230: 7073 2865 6c29 2d71 656d 755f 6d69 7073 ps(el)-qemu_mips │ │ │ │ │ +0000a240: 324d 6942 2020 2020 2020 2020 2032 3533 2MiB 253 │ │ │ │ │ +0000a250: 204d 6942 0a6d 6970 7365 6c2d 6c6f 6f6e MiB.mipsel-loon │ │ │ │ │ +0000a260: 6773 6f6e 324d 6942 2020 2020 2020 2020 gson2MiB │ │ │ │ │ +0000a270: 2020 2020 3235 3320 4d69 420a 6d69 7073 253 MiB.mips │ │ │ │ │ +0000a280: 2d61 7263 2020 2020 324d 6942 2020 2020 -arc 2MiB │ │ │ │ │ +0000a290: 2020 2020 2020 2020 2020 2031 3235 204d 125 M │ │ │ │ │ +0000a2a0: 6942 0a6d 6970 7365 6c2d 6172 6320 2032 iB.mipsel-arc 2 │ │ │ │ │ +0000a2b0: 4d69 4220 2020 2020 2020 2020 2020 2020 MiB │ │ │ │ │ +0000a2c0: 2020 3234 3820 4d69 420a 7838 365f 3634 248 MiB.x86_64 │ │ │ │ │ +0000a2d0: 2d78 656e 2020 344d 6942 2020 2020 2020 -xen 4MiB │ │ │ │ │ +0000a2e0: 2020 2020 2020 2020 2075 6e6c 696d 6974 unlimit │ │ │ │ │ +0000a2f0: 6564 0a28 4743 4320 3e3d 0a34 2e34 290a ed.(GCC >=.4.4). │ │ │ │ │ +0000a300: 7838 365f 3634 2d78 656e 2020 344d 6942 x86_64-xen 4MiB │ │ │ │ │ +0000a310: 2020 2020 2020 2020 2020 2020 2020 203c < │ │ │ │ │ +0000a320: 2032 4769 420a 2847 4343 203c 0a34 2e34 2GiB.(GCC <.4.4 │ │ │ │ │ +0000a330: 290a 6933 3836 2d78 656e 2020 2020 344d ).i386-xen 4M │ │ │ │ │ +0000a340: 6942 2020 2020 2020 2020 2020 2020 2020 iB │ │ │ │ │ +0000a350: 203c 2034 4769 420a 0a1f 0a46 696c 653a < 4GiB....File: │ │ │ │ │ +0000a360: 2067 7275 622d 6465 762e 696e 666f 2c20 grub-dev.info, │ │ │ │ │ +0000a370: 204e 6f64 653a 2042 494f 5320 706f 7274 Node: BIOS port │ │ │ │ │ +0000a380: 206d 656d 6f72 7920 6d61 702c 2020 4e65 memory map, Ne │ │ │ │ │ +0000a390: 7874 3a20 5669 6465 6f20 5375 6273 7973 xt: Video Subsys │ │ │ │ │ +0000a3a0: 7465 6d2c 2020 5072 6576 3a20 5374 6163 tem, Prev: Stac │ │ │ │ │ +0000a3b0: 6b20 616e 6420 6865 6170 2073 697a 652c k and heap size, │ │ │ │ │ +0000a3c0: 2020 5570 3a20 546f 700a 0a39 2042 494f Up: Top..9 BIO │ │ │ │ │ +0000a3d0: 5320 706f 7274 206d 656d 6f72 7920 6d61 S port memory ma │ │ │ │ │ +0000a3e0: 700a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a p.************** │ │ │ │ │ +0000a3f0: 2a2a 2a2a 2a2a 2a2a 0a0a 5374 6172 7420 ********..Start │ │ │ │ │ +0000a400: 2020 2020 2020 456e 6420 2020 2020 2020 End │ │ │ │ │ +0000a410: 2020 2020 2020 2020 2055 7361 6765 0a2d Usage.- │ │ │ │ │ 0000a420: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a430: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a440: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000a450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000a460: 2d0a 3020 2020 2020 2020 2020 2020 3078 -.0 0x │ │ │ │ │ -0000a470: 3130 3030 202d 2031 2020 2020 2020 2020 1000 - 1 │ │ │ │ │ -0000a480: 2042 494f 5320 616e 6420 7265 616c 206d BIOS and real m │ │ │ │ │ -0000a490: 6f64 6520 696e 7465 7272 7570 7473 0a30 ode interrupts.0 │ │ │ │ │ -0000a4a0: 7830 3742 4520 2020 2020 2030 7830 3746 x07BE 0x07F │ │ │ │ │ -0000a4b0: 4620 2020 2020 2020 2020 2020 2020 5061 F Pa │ │ │ │ │ -0000a4c0: 7274 6974 696f 6e20 7461 626c 6520 7061 rtition table pa │ │ │ │ │ -0000a4d0: 7373 6564 2074 6f20 616e 6f74 6865 720a ssed to another. │ │ │ │ │ -0000a4e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a4f0: 2020 2020 2020 2020 2020 2020 2020 2062 b │ │ │ │ │ -0000a500: 6f6f 7420 6c6f 6164 6572 0a3f 2020 2020 oot loader.? │ │ │ │ │ -0000a510: 2020 2020 2020 2030 7832 3030 3020 2d20 0x2000 - │ │ │ │ │ -0000a520: 3120 2020 2020 2020 2020 5265 616c 206d 1 Real m │ │ │ │ │ -0000a530: 6f64 6520 7374 6163 6b0a 3078 3743 3030 ode stack.0x7C00 │ │ │ │ │ -0000a540: 2020 2020 2020 3078 3744 3030 202d 2031 0x7D00 - 1 │ │ │ │ │ -0000a550: 2020 2020 2020 2020 2042 6f6f 7420 7365 Boot se │ │ │ │ │ -0000a560: 6374 6f72 0a30 7838 3030 3020 2020 2020 ctor.0x8000 │ │ │ │ │ -0000a570: 203f 2020 2020 2020 2020 2020 2020 2020 ? │ │ │ │ │ -0000a580: 2020 2020 4752 5542 206b 6572 6e65 6c0a GRUB kernel. │ │ │ │ │ -0000a590: 3078 3638 3030 3020 2020 2020 3078 3731 0x68000 0x71 │ │ │ │ │ -0000a5a0: 3030 3020 2d20 3120 2020 2020 2020 2044 000 - 1 D │ │ │ │ │ -0000a5b0: 6973 6b20 6275 6666 6572 0a3f 2020 2020 isk buffer.? │ │ │ │ │ -0000a5c0: 2020 2020 2020 2030 7838 3030 3030 202d 0x80000 - │ │ │ │ │ -0000a5d0: 2031 2020 2020 2020 2020 5072 6f74 6563 1 Protec │ │ │ │ │ -0000a5e0: 7465 6420 6d6f 6465 2073 7461 636b 0a3f ted mode stack.? │ │ │ │ │ -0000a5f0: 2020 2020 2020 2020 2020 2030 7841 3030 0xA00 │ │ │ │ │ -0000a600: 3030 202d 2031 2020 2020 2020 2020 4578 00 - 1 Ex │ │ │ │ │ -0000a610: 7465 6e64 6564 2042 494f 5320 4461 7461 tended BIOS Data │ │ │ │ │ -0000a620: 2041 7265 610a 3078 4130 3030 3020 2020 Area.0xA0000 │ │ │ │ │ -0000a630: 2020 3078 4330 3030 3020 2d20 3120 2020 0xC0000 - 1 │ │ │ │ │ -0000a640: 2020 2020 2056 6964 656f 2052 414d 0a30 Video RAM.0 │ │ │ │ │ -0000a650: 7843 3030 3030 2020 2020 2030 7831 3030 xC0000 0x100 │ │ │ │ │ -0000a660: 3030 3020 2d20 3120 2020 2020 2020 4249 000 - 1 BI │ │ │ │ │ -0000a670: 4f53 0a30 7831 3030 3030 3020 2020 203f OS.0x100000 ? │ │ │ │ │ -0000a680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a690: 2020 4865 6170 2061 6e64 206d 6f64 756c Heap and modul │ │ │ │ │ -0000a6a0: 6520 636f 6465 0a0a 1f0a 4669 6c65 3a20 e code....File: │ │ │ │ │ -0000a6b0: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ -0000a6c0: 4e6f 6465 3a20 5669 6465 6f20 5375 6273 Node: Video Subs │ │ │ │ │ -0000a6d0: 7973 7465 6d2c 2020 4e65 7874 3a20 5046 ystem, Next: PF │ │ │ │ │ -0000a6e0: 4632 2046 6f6e 7420 4669 6c65 2046 6f72 F2 Font File For │ │ │ │ │ -0000a6f0: 6d61 742c 2020 5072 6576 3a20 4249 4f53 mat, Prev: BIOS │ │ │ │ │ -0000a700: 2070 6f72 7420 6d65 6d6f 7279 206d 6170 port memory map │ │ │ │ │ -0000a710: 2c20 2055 703a 2054 6f70 0a0a 3130 2056 , Up: Top..10 V │ │ │ │ │ -0000a720: 6964 656f 2053 7562 7379 7374 656d 0a2a ideo Subsystem.* │ │ │ │ │ -0000a730: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0000a740: 2a0a 0a54 6869 7320 646f 6375 6d65 6e74 *..This document │ │ │ │ │ -0000a750: 2063 6f6e 7461 696e 7320 7370 6563 6966 contains specif │ │ │ │ │ -0000a760: 6963 6174 696f 6e20 666f 7220 5669 6465 ication for Vide │ │ │ │ │ -0000a770: 6f20 5375 6273 7973 7465 6d20 666f 7220 o Subsystem for │ │ │ │ │ -0000a780: 4752 5542 322e 0a43 7572 7265 6e74 6c79 GRUB2..Currently │ │ │ │ │ -0000a790: 206f 6e6c 7920 7468 6520 7573 6167 6520 only the usage │ │ │ │ │ -0000a7a0: 696e 7465 7266 6163 6520 6973 2064 6573 interface is des │ │ │ │ │ -0000a7b0: 6372 6962 6564 2069 6e20 7468 6973 2064 cribed in this d │ │ │ │ │ -0000a7c0: 6f63 756d 656e 742e 0a49 6e74 6572 6e61 ocument..Interna │ │ │ │ │ -0000a7d0: 6c20 7374 7275 6374 7572 6520 6f66 2068 l structure of h │ │ │ │ │ -0000a7e0: 6f77 2076 6964 656f 2064 7269 7665 7273 ow video drivers │ │ │ │ │ -0000a7f0: 2061 7265 2072 6567 6973 7465 7269 6e67 are registering │ │ │ │ │ -0000a800: 2061 6e64 2068 6f77 2076 6964 656f 0a64 and how video.d │ │ │ │ │ -0000a810: 7269 7665 7220 6d61 6e61 6765 7220 776f river manager wo │ │ │ │ │ -0000a820: 726b 7320 6172 6520 6e6f 7420 696e 636c rks are not incl │ │ │ │ │ -0000a830: 7564 6564 2068 6572 652e 0a0a 2a20 4d65 uded here...* Me │ │ │ │ │ -0000a840: 6e75 3a0a 0a2a 2056 6964 656f 2041 5049 nu:..* Video API │ │ │ │ │ -0000a850: 3a3a 0a2a 2045 7861 6d70 6c65 2075 7361 ::.* Example usa │ │ │ │ │ -0000a860: 6765 206f 6620 5669 6465 6f20 4150 493a ge of Video API: │ │ │ │ │ -0000a870: 3a0a 2a20 4269 746d 6170 2041 5049 3a3a :.* Bitmap API:: │ │ │ │ │ -0000a880: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2d64 ....File: grub-d │ │ │ │ │ -0000a890: 6576 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ev.info, Node: │ │ │ │ │ -0000a8a0: 5669 6465 6f20 4150 492c 2020 4e65 7874 Video API, Next │ │ │ │ │ -0000a8b0: 3a20 4578 616d 706c 6520 7573 6167 6520 : Example usage │ │ │ │ │ -0000a8c0: 6f66 2056 6964 656f 2041 5049 2c20 2055 of Video API, U │ │ │ │ │ -0000a8d0: 703a 2056 6964 656f 2053 7562 7379 7374 p: Video Subsyst │ │ │ │ │ -0000a8e0: 656d 0a0a 3130 2e31 2056 6964 656f 2041 em..10.1 Video A │ │ │ │ │ -0000a8f0: 5049 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d PI.============= │ │ │ │ │ -0000a900: 3d0a 0a31 302e 312e 3120 6772 7562 5f76 =..10.1.1 grub_v │ │ │ │ │ -0000a910: 6964 656f 5f73 6574 7570 0a2d 2d2d 2d2d ideo_setup.----- │ │ │ │ │ +0000a460: 2d2d 2d0a 3020 2020 2020 2020 2020 2020 ---.0 │ │ │ │ │ +0000a470: 3078 3130 3030 202d 2031 2020 2020 2020 0x1000 - 1 │ │ │ │ │ +0000a480: 2020 2042 494f 5320 616e 6420 7265 616c BIOS and real │ │ │ │ │ +0000a490: 206d 6f64 6520 696e 7465 7272 7570 7473 mode interrupts │ │ │ │ │ +0000a4a0: 0a30 7830 3742 4520 2020 2020 2030 7830 .0x07BE 0x0 │ │ │ │ │ +0000a4b0: 3746 4620 2020 2020 2020 2020 2020 2020 7FF │ │ │ │ │ +0000a4c0: 5061 7274 6974 696f 6e20 7461 626c 6520 Partition table │ │ │ │ │ +0000a4d0: 7061 7373 6564 2074 6f20 616e 6f74 6865 passed to anothe │ │ │ │ │ +0000a4e0: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ +0000a4f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0000a500: 2062 6f6f 7420 6c6f 6164 6572 0a3f 2020 boot loader.? │ │ │ │ │ +0000a510: 2020 2020 2020 2020 2030 7832 3030 3020 0x2000 │ │ │ │ │ +0000a520: 2d20 3120 2020 2020 2020 2020 5265 616c - 1 Real │ │ │ │ │ +0000a530: 206d 6f64 6520 7374 6163 6b0a 3078 3743 mode stack.0x7C │ │ │ │ │ +0000a540: 3030 2020 2020 2020 3078 3744 3030 202d 00 0x7D00 - │ │ │ │ │ +0000a550: 2031 2020 2020 2020 2020 2042 6f6f 7420 1 Boot │ │ │ │ │ +0000a560: 7365 6374 6f72 0a30 7838 3030 3020 2020 sector.0x8000 │ │ │ │ │ +0000a570: 2020 203f 2020 2020 2020 2020 2020 2020 ? │ │ │ │ │ +0000a580: 2020 2020 2020 4752 5542 206b 6572 6e65 GRUB kerne │ │ │ │ │ +0000a590: 6c0a 3078 3638 3030 3020 2020 2020 3078 l.0x68000 0x │ │ │ │ │ +0000a5a0: 3731 3030 3020 2d20 3120 2020 2020 2020 71000 - 1 │ │ │ │ │ +0000a5b0: 2044 6973 6b20 6275 6666 6572 0a3f 2020 Disk buffer.? │ │ │ │ │ +0000a5c0: 2020 2020 2020 2020 2030 7838 3030 3030 0x80000 │ │ │ │ │ +0000a5d0: 202d 2031 2020 2020 2020 2020 5072 6f74 - 1 Prot │ │ │ │ │ +0000a5e0: 6563 7465 6420 6d6f 6465 2073 7461 636b ected mode stack │ │ │ │ │ +0000a5f0: 0a3f 2020 2020 2020 2020 2020 2030 7841 .? 0xA │ │ │ │ │ +0000a600: 3030 3030 202d 2031 2020 2020 2020 2020 0000 - 1 │ │ │ │ │ +0000a610: 4578 7465 6e64 6564 2042 494f 5320 4461 Extended BIOS Da │ │ │ │ │ +0000a620: 7461 2041 7265 610a 3078 4130 3030 3020 ta Area.0xA0000 │ │ │ │ │ +0000a630: 2020 2020 3078 4330 3030 3020 2d20 3120 0xC0000 - 1 │ │ │ │ │ +0000a640: 2020 2020 2020 2056 6964 656f 2052 414d Video RAM │ │ │ │ │ +0000a650: 0a30 7843 3030 3030 2020 2020 2030 7831 .0xC0000 0x1 │ │ │ │ │ +0000a660: 3030 3030 3020 2d20 3120 2020 2020 2020 00000 - 1 │ │ │ │ │ +0000a670: 4249 4f53 0a30 7831 3030 3030 3020 2020 BIOS.0x100000 │ │ │ │ │ +0000a680: 203f 2020 2020 2020 2020 2020 2020 2020 ? │ │ │ │ │ +0000a690: 2020 2020 4865 6170 2061 6e64 206d 6f64 Heap and mod │ │ │ │ │ +0000a6a0: 756c 6520 636f 6465 0a0a 1f0a 4669 6c65 ule code....File │ │ │ │ │ +0000a6b0: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ +0000a6c0: 2020 4e6f 6465 3a20 5669 6465 6f20 5375 Node: Video Su │ │ │ │ │ +0000a6d0: 6273 7973 7465 6d2c 2020 4e65 7874 3a20 bsystem, Next: │ │ │ │ │ +0000a6e0: 5046 4632 2046 6f6e 7420 4669 6c65 2046 PFF2 Font File F │ │ │ │ │ +0000a6f0: 6f72 6d61 742c 2020 5072 6576 3a20 4249 ormat, Prev: BI │ │ │ │ │ +0000a700: 4f53 2070 6f72 7420 6d65 6d6f 7279 206d OS port memory m │ │ │ │ │ +0000a710: 6170 2c20 2055 703a 2054 6f70 0a0a 3130 ap, Up: Top..10 │ │ │ │ │ +0000a720: 2056 6964 656f 2053 7562 7379 7374 656d Video Subsystem │ │ │ │ │ +0000a730: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ +0000a740: 2a2a 2a0a 0a54 6869 7320 646f 6375 6d65 ***..This docume │ │ │ │ │ +0000a750: 6e74 2063 6f6e 7461 696e 7320 7370 6563 nt contains spec │ │ │ │ │ +0000a760: 6966 6963 6174 696f 6e20 666f 7220 5669 ification for Vi │ │ │ │ │ +0000a770: 6465 6f20 5375 6273 7973 7465 6d20 666f deo Subsystem fo │ │ │ │ │ +0000a780: 7220 4752 5542 322e 0a43 7572 7265 6e74 r GRUB2..Current │ │ │ │ │ +0000a790: 6c79 206f 6e6c 7920 7468 6520 7573 6167 ly only the usag │ │ │ │ │ +0000a7a0: 6520 696e 7465 7266 6163 6520 6973 2064 e interface is d │ │ │ │ │ +0000a7b0: 6573 6372 6962 6564 2069 6e20 7468 6973 escribed in this │ │ │ │ │ +0000a7c0: 2064 6f63 756d 656e 742e 0a49 6e74 6572 document..Inter │ │ │ │ │ +0000a7d0: 6e61 6c20 7374 7275 6374 7572 6520 6f66 nal structure of │ │ │ │ │ +0000a7e0: 2068 6f77 2076 6964 656f 2064 7269 7665 how video drive │ │ │ │ │ +0000a7f0: 7273 2061 7265 2072 6567 6973 7465 7269 rs are registeri │ │ │ │ │ +0000a800: 6e67 2061 6e64 2068 6f77 2076 6964 656f ng and how video │ │ │ │ │ +0000a810: 0a64 7269 7665 7220 6d61 6e61 6765 7220 .driver manager │ │ │ │ │ +0000a820: 776f 726b 7320 6172 6520 6e6f 7420 696e works are not in │ │ │ │ │ +0000a830: 636c 7564 6564 2068 6572 652e 0a0a 2a20 cluded here...* │ │ │ │ │ +0000a840: 4d65 6e75 3a0a 0a2a 2056 6964 656f 2041 Menu:..* Video A │ │ │ │ │ +0000a850: 5049 3a3a 0a2a 2045 7861 6d70 6c65 2075 PI::.* Example u │ │ │ │ │ +0000a860: 7361 6765 206f 6620 5669 6465 6f20 4150 sage of Video AP │ │ │ │ │ +0000a870: 493a 3a0a 2a20 4269 746d 6170 2041 5049 I::.* Bitmap API │ │ │ │ │ +0000a880: 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 7562 ::....File: grub │ │ │ │ │ +0000a890: 2d64 6576 2e69 6e66 6f2c 2020 4e6f 6465 -dev.info, Node │ │ │ │ │ +0000a8a0: 3a20 5669 6465 6f20 4150 492c 2020 4e65 : Video API, Ne │ │ │ │ │ +0000a8b0: 7874 3a20 4578 616d 706c 6520 7573 6167 xt: Example usag │ │ │ │ │ +0000a8c0: 6520 6f66 2056 6964 656f 2041 5049 2c20 e of Video API, │ │ │ │ │ +0000a8d0: 2055 703a 2056 6964 656f 2053 7562 7379 Up: Video Subsy │ │ │ │ │ +0000a8e0: 7374 656d 0a0a 3130 2e31 2056 6964 656f stem..10.1 Video │ │ │ │ │ +0000a8f0: 2041 5049 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d API.=========== │ │ │ │ │ +0000a900: 3d3d 3d0a 0a31 302e 312e 3120 6772 7562 ===..10.1.1 grub │ │ │ │ │ +0000a910: 5f76 6964 656f 5f73 6574 7570 0a2d 2d2d _video_setup.--- │ │ │ │ │ 0000a920: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000a930: 2d2d 0a0a 2020 202a 2050 726f 746f 7479 --.. * Prototy │ │ │ │ │ -0000a940: 7065 3a0a 2020 2020 2020 2020 2020 6772 pe:. gr │ │ │ │ │ -0000a950: 7562 5f65 7272 5f74 0a20 2020 2020 2020 ub_err_t. │ │ │ │ │ -0000a960: 2020 2067 7275 625f 7669 6465 6f5f 7365 grub_video_se │ │ │ │ │ -0000a970: 7475 7020 2875 6e73 6967 6e65 6420 696e tup (unsigned in │ │ │ │ │ -0000a980: 7420 7769 6474 682c 2075 6e73 6967 6e65 t width, unsigne │ │ │ │ │ -0000a990: 6420 696e 7420 6865 6967 6874 2c20 756e d int height, un │ │ │ │ │ -0000a9a0: 7369 676e 6564 2069 6e74 206d 6f64 655f signed int mode_ │ │ │ │ │ -0000a9b0: 7479 7065 293b 0a20 2020 2a20 4465 7363 type);. * Desc │ │ │ │ │ -0000a9c0: 7269 7074 696f 6e3a 0a0a 2020 2020 2044 ription:.. D │ │ │ │ │ -0000a9d0: 7269 7665 7220 7769 6c6c 2075 7365 2069 river will use i │ │ │ │ │ -0000a9e0: 6e66 6f72 6d61 7469 6f6e 2070 726f 7669 nformation provi │ │ │ │ │ -0000a9f0: 6465 6420 746f 2069 7420 746f 2073 656c ded to it to sel │ │ │ │ │ -0000aa00: 6563 7420 6265 7374 2070 6f73 7369 626c ect best possibl │ │ │ │ │ -0000aa10: 650a 2020 2020 2076 6964 656f 206d 6f64 e. video mod │ │ │ │ │ -0000aa20: 6520 616e 6420 7377 6974 6368 2074 6f20 e and switch to │ │ │ │ │ -0000aa30: 6974 2e20 2053 7570 706f 7274 6564 2076 it. Supported v │ │ │ │ │ -0000aa40: 616c 7565 7320 666f 7220 276d 6f64 655f alues for 'mode_ │ │ │ │ │ -0000aa50: 7479 7065 2720 6172 650a 2020 2020 2027 type' are. ' │ │ │ │ │ -0000aa60: 4752 5542 5f56 4944 454f 5f4d 4f44 455f GRUB_VIDEO_MODE_ │ │ │ │ │ -0000aa70: 5459 5045 5f49 4e44 4558 5f43 4f4c 4f52 TYPE_INDEX_COLOR │ │ │ │ │ -0000aa80: 2720 666f 7220 696e 6465 7820 636f 6c6f ' for index colo │ │ │ │ │ -0000aa90: 7220 6d6f 6465 732c 0a20 2020 2020 2747 r modes,. 'G │ │ │ │ │ -0000aaa0: 5255 425f 5649 4445 4f5f 4d4f 4445 5f54 RUB_VIDEO_MODE_T │ │ │ │ │ -0000aab0: 5950 455f 5247 4227 2066 6f72 2064 6972 YPE_RGB' for dir │ │ │ │ │ -0000aac0: 6563 7420 5247 4220 636f 6c6f 7220 6d6f ect RGB color mo │ │ │ │ │ -0000aad0: 6465 7320 616e 640a 2020 2020 2027 4752 des and. 'GR │ │ │ │ │ -0000aae0: 5542 5f56 4944 454f 5f4d 4f44 455f 5459 UB_VIDEO_MODE_TY │ │ │ │ │ -0000aaf0: 5045 5f44 4f55 424c 455f 4255 4646 4552 PE_DOUBLE_BUFFER │ │ │ │ │ -0000ab00: 4544 2720 666f 7220 646f 7562 6c65 2062 ED' for double b │ │ │ │ │ -0000ab10: 7566 6665 7269 6e67 2e20 2057 6865 6e0a uffering. When. │ │ │ │ │ -0000ab20: 2020 2020 2072 6571 7565 7374 696e 6720 requesting │ │ │ │ │ -0000ab30: 5247 4220 6d6f 6465 2c20 6869 6768 6573 RGB mode, highes │ │ │ │ │ -0000ab40: 7420 6269 7473 2070 6572 2070 6978 656c t bits per pixel │ │ │ │ │ -0000ab50: 206d 6f64 6520 7769 6c6c 2062 6520 7365 mode will be se │ │ │ │ │ -0000ab60: 6c65 6374 6564 2e0a 2020 2020 2057 6865 lected.. Whe │ │ │ │ │ -0000ab70: 6e20 7265 7175 6573 7469 6e67 2049 6e64 n requesting Ind │ │ │ │ │ -0000ab80: 6578 2063 6f6c 6f72 206d 6f64 652c 206d ex color mode, m │ │ │ │ │ -0000ab90: 6f64 6520 7769 7468 2068 6967 6865 7374 ode with highest │ │ │ │ │ -0000aba0: 206e 756d 6265 7220 6f66 0a20 2020 2020 number of. │ │ │ │ │ -0000abb0: 636f 6c6f 7273 2077 696c 6c20 6265 2073 colors will be s │ │ │ │ │ -0000abc0: 656c 6563 7465 642e 2020 4966 2061 6c6c elected. If all │ │ │ │ │ -0000abd0: 2070 6172 616d 6574 6572 7320 6172 6520 parameters are │ │ │ │ │ -0000abe0: 7370 6563 6966 6965 6420 6173 207a 6572 specified as zer │ │ │ │ │ -0000abf0: 6f2c 0a20 2020 2020 7669 6465 6f20 6164 o,. video ad │ │ │ │ │ -0000ac00: 6170 7465 7220 7769 6c6c 2074 7279 2074 apter will try t │ │ │ │ │ -0000ac10: 6f20 6669 6775 7265 206f 7574 2062 6573 o figure out bes │ │ │ │ │ -0000ac20: 7420 706f 7373 6962 6c65 206d 6f64 6520 t possible mode │ │ │ │ │ -0000ac30: 616e 640a 2020 2020 2069 6e69 7469 616c and. initial │ │ │ │ │ -0000ac40: 697a 6520 6974 2c20 706c 6174 666f 726d ize it, platform │ │ │ │ │ -0000ac50: 2073 7065 6369 6669 6320 6469 6666 6572 specific differ │ │ │ │ │ -0000ac60: 656e 6365 7320 6172 6520 616c 6c6f 7765 ences are allowe │ │ │ │ │ -0000ac70: 6420 6865 7265 2e20 2049 660a 2020 2020 d here. If. │ │ │ │ │ -0000ac80: 2074 6865 7265 2069 7320 6e6f 206d 6f64 there is no mod │ │ │ │ │ -0000ac90: 6520 6d61 7463 6869 6e67 2072 6571 7565 e matching reque │ │ │ │ │ -0000aca0: 7374 2c20 6572 726f 7220 5820 7769 6c6c st, error X will │ │ │ │ │ -0000acb0: 2062 6520 7265 7475 726e 6564 2e20 2049 be returned. I │ │ │ │ │ -0000acc0: 660a 2020 2020 2074 6865 7265 2061 7265 f. there are │ │ │ │ │ -0000acd0: 206e 6f20 7072 6f62 6c65 6d73 2c20 6675 no problems, fu │ │ │ │ │ -0000ace0: 6e63 7469 6f6e 2072 6574 7572 6e73 2027 nction returns ' │ │ │ │ │ -0000acf0: 4752 5542 5f45 5252 5f4e 4f4e 4527 2e0a GRUB_ERR_NONE'.. │ │ │ │ │ -0000ad00: 0a20 2020 2020 5468 6973 2066 756e 6374 . This funct │ │ │ │ │ -0000ad10: 696f 6e20 616c 736f 2070 6572 666f 726d ion also perform │ │ │ │ │ -0000ad20: 7320 666f 6c6c 6f77 696e 6720 7461 736b s following task │ │ │ │ │ -0000ad30: 2075 706f 6e20 7375 6363 6573 6675 6c20 upon succesful │ │ │ │ │ -0000ad40: 6d6f 6465 0a20 2020 2020 7377 6974 6368 mode. switch │ │ │ │ │ -0000ad50: 2e20 2041 6374 6976 6520 7265 6e64 6572 . Active render │ │ │ │ │ -0000ad60: 696e 6720 7461 7267 6574 2069 7320 6368 ing target is ch │ │ │ │ │ -0000ad70: 616e 6765 6420 746f 2073 6372 6565 6e20 anged to screen │ │ │ │ │ -0000ad80: 616e 6420 7669 6577 706f 7274 0a20 2020 and viewport. │ │ │ │ │ -0000ad90: 2020 6973 206d 6178 696d 697a 6564 2074 is maximized t │ │ │ │ │ -0000ada0: 6f20 616c 6c6f 7720 7768 6f6c 6520 7363 o allow whole sc │ │ │ │ │ -0000adb0: 7265 656e 2074 6f20 6265 2075 7365 6420 reen to be used │ │ │ │ │ -0000adc0: 7768 656e 2070 6572 666f 726d 696e 670a when performing. │ │ │ │ │ -0000add0: 2020 2020 2067 7261 7068 6963 7320 6f70 graphics op │ │ │ │ │ -0000ade0: 6572 6174 696f 6e73 2e20 2049 6e20 5247 erations. In RG │ │ │ │ │ -0000adf0: 4220 6d6f 6465 732c 2065 6d75 6c61 7465 B modes, emulate │ │ │ │ │ -0000ae00: 6420 7061 6c65 7474 6520 6765 7473 2031 d palette gets 1 │ │ │ │ │ -0000ae10: 360a 2020 2020 2065 6e74 7269 6573 2063 6. entries c │ │ │ │ │ -0000ae20: 6f6e 7461 696e 696e 6720 6465 6661 756c ontaining defaul │ │ │ │ │ -0000ae30: 7420 7661 6c75 6573 2066 6f72 2056 4741 t values for VGA │ │ │ │ │ -0000ae40: 2070 616c 6574 7465 2c20 6f74 6865 7220 palette, other │ │ │ │ │ -0000ae50: 636f 6c6f 7273 2061 7265 0a20 2020 2020 colors are. │ │ │ │ │ -0000ae60: 6465 6669 6e65 6420 6173 2062 6c61 636b defined as black │ │ │ │ │ -0000ae70: 2e20 2057 6865 6e20 7377 6974 6368 696e . When switchin │ │ │ │ │ -0000ae80: 6720 746f 2049 6e64 6578 6564 2043 6f6c g to Indexed Col │ │ │ │ │ -0000ae90: 6f72 206d 6f64 652c 2064 7269 7665 7220 or mode, driver │ │ │ │ │ -0000aea0: 6d61 790a 2020 2020 2073 6574 2064 6566 may. set def │ │ │ │ │ -0000aeb0: 6175 6c74 2056 4741 2070 616c 6574 7465 ault VGA palette │ │ │ │ │ -0000aec0: 2074 6f20 7363 7265 656e 2069 6620 7468 to screen if th │ │ │ │ │ -0000aed0: 6520 7669 6465 6f20 6361 7264 2061 6c6c e video card all │ │ │ │ │ -0000aee0: 6f77 7320 7468 650a 2020 2020 206f 7065 ows the. ope │ │ │ │ │ -0000aef0: 7261 7469 6f6e 2e0a 0a31 302e 312e 3220 ration...10.1.2 │ │ │ │ │ -0000af00: 6772 7562 5f76 6964 656f 5f72 6573 746f grub_video_resto │ │ │ │ │ -0000af10: 7265 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d re.------------- │ │ │ │ │ -0000af20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ -0000af30: 202a 2050 726f 746f 7479 7065 3a0a 0a20 * Prototype:.. │ │ │ │ │ -0000af40: 2020 2020 2020 2020 2067 7275 625f 6572 grub_er │ │ │ │ │ -0000af50: 725f 740a 2020 2020 2020 2020 2020 6772 r_t. gr │ │ │ │ │ -0000af60: 7562 5f76 6964 656f 5f72 6573 746f 7265 ub_video_restore │ │ │ │ │ -0000af70: 2028 766f 6964 293b 0a20 2020 2a20 4465 (void);. * De │ │ │ │ │ -0000af80: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ -0000af90: 2056 6964 656f 2073 7562 7379 7374 656d Video subsystem │ │ │ │ │ -0000afa0: 2077 696c 6c20 6465 696e 6974 6961 6c69 will deinitiali │ │ │ │ │ -0000afb0: 7a65 2061 6374 6976 6174 6564 2076 6964 ze activated vid │ │ │ │ │ -0000afc0: 656f 2064 7269 7665 7220 746f 2072 6573 eo driver to res │ │ │ │ │ -0000afd0: 746f 7265 0a20 2020 2020 6f6c 6420 7374 tore. old st │ │ │ │ │ -0000afe0: 6174 6520 6f66 2076 6964 656f 2064 6576 ate of video dev │ │ │ │ │ -0000aff0: 6963 652e 2020 5468 6973 2063 616e 2062 ice. This can b │ │ │ │ │ -0000b000: 6520 7573 6564 2074 6f20 7377 6974 6368 e used to switch │ │ │ │ │ -0000b010: 2062 6163 6b20 746f 2074 6578 740a 2020 back to text. │ │ │ │ │ -0000b020: 2020 206d 6f64 652e 0a0a 3130 2e31 2e33 mode...10.1.3 │ │ │ │ │ -0000b030: 2067 7275 625f 7669 6465 6f5f 6765 745f grub_video_get_ │ │ │ │ │ -0000b040: 696e 666f 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d info.----------- │ │ │ │ │ -0000b050: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -0000b060: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ │ -0000b070: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ │ -0000b080: 5f65 7272 5f74 0a20 2020 2020 2020 2020 _err_t. │ │ │ │ │ -0000b090: 2067 7275 625f 7669 6465 6f5f 6765 745f grub_video_get_ │ │ │ │ │ -0000b0a0: 696e 666f 2028 7374 7275 6374 2067 7275 info (struct gru │ │ │ │ │ -0000b0b0: 625f 7669 6465 6f5f 6d6f 6465 5f69 6e66 b_video_mode_inf │ │ │ │ │ -0000b0c0: 6f20 2a6d 6f64 655f 696e 666f 293b 0a20 o *mode_info);. │ │ │ │ │ -0000b0d0: 2020 2020 2020 2020 2073 7472 7563 7420 struct │ │ │ │ │ -0000b0e0: 6772 7562 5f76 6964 656f 5f6d 6f64 655f grub_video_mode_ │ │ │ │ │ -0000b0f0: 696e 666f 0a20 2020 2020 2020 2020 207b info. { │ │ │ │ │ -0000b100: 0a20 2020 2020 2020 2020 2020 202f 2a20 . /* │ │ │ │ │ -0000b110: 5769 6474 6820 6f66 2074 6865 2073 6372 Width of the scr │ │ │ │ │ -0000b120: 6565 6e2e 2020 2a2f 0a20 2020 2020 2020 een. */. │ │ │ │ │ -0000b130: 2020 2020 2075 6e73 6967 6e65 6420 696e unsigned in │ │ │ │ │ -0000b140: 7420 7769 6474 683b 0a20 2020 2020 2020 t width;. │ │ │ │ │ -0000b150: 2020 2020 202f 2a20 4865 6967 6874 206f /* Height o │ │ │ │ │ -0000b160: 6620 7468 6520 7363 7265 656e 2e20 202a f the screen. * │ │ │ │ │ -0000b170: 2f0a 2020 2020 2020 2020 2020 2020 756e /. un │ │ │ │ │ -0000b180: 7369 676e 6564 2069 6e74 2068 6569 6768 signed int heigh │ │ │ │ │ -0000b190: 743b 0a20 2020 2020 2020 2020 2020 202f t;. / │ │ │ │ │ -0000b1a0: 2a20 4d6f 6465 2074 7970 6520 6269 746d * Mode type bitm │ │ │ │ │ -0000b1b0: 6173 6b2e 2020 436f 6e74 6169 6e73 2069 ask. Contains i │ │ │ │ │ -0000b1c0: 6e66 6f72 6d61 7469 6f6e 206c 696b 6520 nformation like │ │ │ │ │ -0000b1d0: 6973 2069 7420 496e 6465 7820 636f 6c6f is it Index colo │ │ │ │ │ -0000b1e0: 7220 6f72 0a20 2020 2020 2020 2020 2020 r or. │ │ │ │ │ -0000b1f0: 2020 2020 5247 4220 6d6f 6465 2e20 202a RGB mode. * │ │ │ │ │ -0000b200: 2f0a 2020 2020 2020 2020 2020 2020 756e /. un │ │ │ │ │ -0000b210: 7369 676e 6564 2069 6e74 206d 6f64 655f signed int mode_ │ │ │ │ │ -0000b220: 7479 7065 3b0a 2020 2020 2020 2020 2020 type;. │ │ │ │ │ -0000b230: 2020 2f2a 2042 6974 7320 7065 7220 7069 /* Bits per pi │ │ │ │ │ -0000b240: 7865 6c2e 2020 2a2f 0a20 2020 2020 2020 xel. */. │ │ │ │ │ -0000b250: 2020 2020 2075 6e73 6967 6e65 6420 696e unsigned in │ │ │ │ │ -0000b260: 7420 6270 703b 0a20 2020 2020 2020 2020 t bpp;. │ │ │ │ │ -0000b270: 2020 202f 2a20 4279 7465 7320 7065 7220 /* Bytes per │ │ │ │ │ -0000b280: 7069 7865 6c2e 2020 2a2f 0a20 2020 2020 pixel. */. │ │ │ │ │ -0000b290: 2020 2020 2020 2075 6e73 6967 6e65 6420 unsigned │ │ │ │ │ -0000b2a0: 696e 7420 6279 7465 735f 7065 725f 7069 int bytes_per_pi │ │ │ │ │ -0000b2b0: 7865 6c3b 0a20 2020 2020 2020 2020 2020 xel;. │ │ │ │ │ -0000b2c0: 202f 2a20 5069 7463 6820 6f66 206f 6e65 /* Pitch of one │ │ │ │ │ -0000b2d0: 2073 6361 6e6c 696e 652e 2020 486f 7720 scanline. How │ │ │ │ │ -0000b2e0: 6d61 6e79 2062 7974 6573 2074 6865 7265 many bytes there │ │ │ │ │ -0000b2f0: 2061 7265 2066 6f72 2073 6361 6e6c 696e are for scanlin │ │ │ │ │ -0000b300: 652e 2020 2a2f 0a20 2020 2020 2020 2020 e. */. │ │ │ │ │ -0000b310: 2020 2075 6e73 6967 6e65 6420 696e 7420 unsigned int │ │ │ │ │ -0000b320: 7069 7463 683b 0a20 2020 2020 2020 2020 pitch;. │ │ │ │ │ -0000b330: 2020 202f 2a20 496e 2069 6e64 6578 2063 /* In index c │ │ │ │ │ -0000b340: 6f6c 6f72 206d 6f64 652c 206e 756d 6265 olor mode, numbe │ │ │ │ │ -0000b350: 7220 6f66 2063 6f6c 6f72 732e 2020 496e r of colors. In │ │ │ │ │ -0000b360: 2052 4742 206d 6f64 6520 7468 6973 2069 RGB mode this i │ │ │ │ │ -0000b370: 7320 3235 362e 2020 2a2f 0a20 2020 2020 s 256. */. │ │ │ │ │ -0000b380: 2020 2020 2020 2075 6e73 6967 6e65 6420 unsigned │ │ │ │ │ -0000b390: 696e 7420 6e75 6d62 6572 5f6f 665f 636f int number_of_co │ │ │ │ │ -0000b3a0: 6c6f 7273 3b0a 2020 2020 2020 2020 2020 lors;. │ │ │ │ │ -0000b3b0: 2020 2f2a 204f 7074 696d 697a 6174 696f /* Optimizatio │ │ │ │ │ -0000b3c0: 6e20 6869 6e74 2068 6f77 2062 696e 6172 n hint how binar │ │ │ │ │ -0000b3d0: 7920 6461 7461 2069 7320 636f 6465 642e y data is coded. │ │ │ │ │ -0000b3e0: 2020 2a2f 0a20 2020 2020 2020 2020 2020 */. │ │ │ │ │ -0000b3f0: 2065 6e75 6d20 6772 7562 5f76 6964 656f enum grub_video │ │ │ │ │ -0000b400: 5f62 6c69 745f 666f 726d 6174 2062 6c69 _blit_format bli │ │ │ │ │ -0000b410: 745f 666f 726d 6174 3b0a 2020 2020 2020 t_format;. │ │ │ │ │ -0000b420: 2020 2020 2020 2f2a 2048 6f77 206d 616e /* How man │ │ │ │ │ -0000b430: 7920 6269 7473 2061 7265 2072 6573 6572 y bits are reser │ │ │ │ │ -0000b440: 7665 6420 666f 7220 7265 6420 636f 6c6f ved for red colo │ │ │ │ │ -0000b450: 722e 2020 2a2f 0a20 2020 2020 2020 2020 r. */. │ │ │ │ │ -0000b460: 2020 2075 6e73 6967 6e65 6420 696e 7420 unsigned int │ │ │ │ │ -0000b470: 7265 645f 6d61 736b 5f73 697a 653b 0a20 red_mask_size;. │ │ │ │ │ -0000b480: 2020 2020 2020 2020 2020 202f 2a20 5768 /* Wh │ │ │ │ │ -0000b490: 6174 2069 7320 6c6f 6361 7469 6f6e 206f at is location o │ │ │ │ │ -0000b4a0: 6620 7265 6420 636f 6c6f 7220 6269 7473 f red color bits │ │ │ │ │ -0000b4b0: 2e20 2049 6e20 496e 6465 7820 436f 6c6f . In Index Colo │ │ │ │ │ -0000b4c0: 7220 6d6f 6465 2c20 7468 6973 2069 7320 r mode, this is │ │ │ │ │ -0000b4d0: 302e 2020 2a2f 0a20 2020 2020 2020 2020 0. */. │ │ │ │ │ -0000b4e0: 2020 2075 6e73 6967 6e65 6420 696e 7420 unsigned int │ │ │ │ │ -0000b4f0: 7265 645f 6669 656c 645f 706f 733b 0a20 red_field_pos;. │ │ │ │ │ -0000b500: 2020 2020 2020 2020 2020 202f 2a20 486f /* Ho │ │ │ │ │ -0000b510: 7720 6d61 6e79 2062 6974 7320 6172 6520 w many bits are │ │ │ │ │ -0000b520: 7265 7365 7276 6564 2066 6f72 2067 7265 reserved for gre │ │ │ │ │ -0000b530: 656e 2063 6f6c 6f72 2e20 202a 2f0a 2020 en color. */. │ │ │ │ │ -0000b540: 2020 2020 2020 2020 2020 756e 7369 676e unsign │ │ │ │ │ -0000b550: 6564 2069 6e74 2067 7265 656e 5f6d 6173 ed int green_mas │ │ │ │ │ -0000b560: 6b5f 7369 7a65 3b0a 2020 2020 2020 2020 k_size;. │ │ │ │ │ -0000b570: 2020 2020 2f2a 2057 6861 7420 6973 206c /* What is l │ │ │ │ │ -0000b580: 6f63 6174 696f 6e20 6f66 2067 7265 656e ocation of green │ │ │ │ │ -0000b590: 2063 6f6c 6f72 2062 6974 732e 2020 496e color bits. In │ │ │ │ │ -0000b5a0: 2049 6e64 6578 2043 6f6c 6f72 206d 6f64 Index Color mod │ │ │ │ │ -0000b5b0: 652c 2074 6869 7320 6973 2030 2e20 202a e, this is 0. * │ │ │ │ │ -0000b5c0: 2f0a 2020 2020 2020 2020 2020 2020 756e /. un │ │ │ │ │ -0000b5d0: 7369 676e 6564 2069 6e74 2067 7265 656e signed int green │ │ │ │ │ -0000b5e0: 5f66 6965 6c64 5f70 6f73 3b0a 2020 2020 _field_pos;. │ │ │ │ │ -0000b5f0: 2020 2020 2020 2020 2f2a 2048 6f77 206d /* How m │ │ │ │ │ -0000b600: 616e 7920 6269 7473 2061 7265 2072 6573 any bits are res │ │ │ │ │ -0000b610: 6572 7665 6420 666f 7220 626c 7565 2063 erved for blue c │ │ │ │ │ -0000b620: 6f6c 6f72 2e20 202a 2f0a 2020 2020 2020 olor. */. │ │ │ │ │ -0000b630: 2020 2020 2020 756e 7369 676e 6564 2069 unsigned i │ │ │ │ │ -0000b640: 6e74 2062 6c75 655f 6d61 736b 5f73 697a nt blue_mask_siz │ │ │ │ │ -0000b650: 653b 0a20 2020 2020 2020 2020 2020 202f e;. / │ │ │ │ │ -0000b660: 2a20 5768 6174 2069 7320 6c6f 6361 7469 * What is locati │ │ │ │ │ -0000b670: 6f6e 206f 6620 626c 7565 2063 6f6c 6f72 on of blue color │ │ │ │ │ -0000b680: 2062 6974 732e 2020 496e 2049 6e64 6578 bits. In Index │ │ │ │ │ -0000b690: 2043 6f6c 6f72 206d 6f64 652c 2074 6869 Color mode, thi │ │ │ │ │ -0000b6a0: 7320 6973 2030 2e20 202a 2f0a 2020 2020 s is 0. */. │ │ │ │ │ -0000b6b0: 2020 2020 2020 2020 756e 7369 676e 6564 unsigned │ │ │ │ │ -0000b6c0: 2069 6e74 2062 6c75 655f 6669 656c 645f int blue_field_ │ │ │ │ │ -0000b6d0: 706f 733b 0a20 2020 2020 2020 2020 2020 pos;. │ │ │ │ │ -0000b6e0: 202f 2a20 486f 7720 6d61 6e79 2062 6974 /* How many bit │ │ │ │ │ -0000b6f0: 7320 6172 6520 7265 7365 7276 6564 2069 s are reserved i │ │ │ │ │ -0000b700: 6e20 636f 6c6f 722e 2020 2a2f 0a20 2020 n color. */. │ │ │ │ │ -0000b710: 2020 2020 2020 2020 2075 6e73 6967 6e65 unsigne │ │ │ │ │ -0000b720: 6420 696e 7420 7265 7365 7276 6564 5f6d d int reserved_m │ │ │ │ │ -0000b730: 6173 6b5f 7369 7a65 3b0a 2020 2020 2020 ask_size;. │ │ │ │ │ -0000b740: 2020 2020 2020 2f2a 2057 6861 7420 6973 /* What is │ │ │ │ │ -0000b750: 206c 6f63 6174 696f 6e20 6f66 2072 6573 location of res │ │ │ │ │ -0000b760: 6572 7665 6420 636f 6c6f 7220 6269 7473 erved color bits │ │ │ │ │ -0000b770: 2e20 2049 6e20 496e 6465 7820 436f 6c6f . In Index Colo │ │ │ │ │ -0000b780: 7220 6d6f 6465 2c0a 2020 2020 2020 2020 r mode,. │ │ │ │ │ -0000b790: 2020 2020 2020 2074 6869 7320 6973 2030 this is 0 │ │ │ │ │ -0000b7a0: 2e20 202a 2f0a 2020 2020 2020 2020 2020 . */. │ │ │ │ │ -0000b7b0: 2020 756e 7369 676e 6564 2069 6e74 2072 unsigned int r │ │ │ │ │ -0000b7c0: 6573 6572 7665 645f 6669 656c 645f 706f eserved_field_po │ │ │ │ │ -0000b7d0: 733b 0a20 2020 2020 2020 2020 207d 3b0a s;. };. │ │ │ │ │ -0000b7e0: 2020 202a 2044 6573 6372 6970 7469 6f6e * Description │ │ │ │ │ -0000b7f0: 3a0a 0a20 2020 2020 536f 6674 7761 7265 :.. Software │ │ │ │ │ -0000b800: 2064 6576 656c 6f70 6572 2063 616e 2075 developer can u │ │ │ │ │ -0000b810: 7365 2074 6869 7320 6675 6e63 7469 6f6e se this function │ │ │ │ │ -0000b820: 2074 6f20 7175 6572 7920 7072 6f70 6572 to query proper │ │ │ │ │ -0000b830: 7469 6573 206f 660a 2020 2020 2061 6374 ties of. act │ │ │ │ │ -0000b840: 6976 6520 7265 6e64 6572 696e 6720 7461 ive rendering ta │ │ │ │ │ -0000b850: 6765 742e 2020 496e 666f 726d 6174 696f get. Informatio │ │ │ │ │ -0000b860: 6e20 7072 6f76 6964 6564 2068 6572 6520 n provided here │ │ │ │ │ -0000b870: 6361 6e20 6265 2075 7365 6420 6279 0a20 can be used by. │ │ │ │ │ -0000b880: 2020 2020 6f74 6865 7220 7061 7274 7320 other parts │ │ │ │ │ -0000b890: 6f66 2047 5255 422c 206c 696b 6520 696d of GRUB, like im │ │ │ │ │ -0000b8a0: 6167 6520 6c6f 6164 6572 7320 746f 2063 age loaders to c │ │ │ │ │ -0000b8b0: 6f6e 7665 7274 206c 6f61 6465 6420 696d onvert loaded im │ │ │ │ │ -0000b8c0: 6167 6573 2074 6f0a 2020 2020 2063 6f72 ages to. cor │ │ │ │ │ -0000b8d0: 7265 6374 2073 6372 6565 6e20 666f 726d rect screen form │ │ │ │ │ -0000b8e0: 6174 2074 6f20 616c 6c6f 7720 6d6f 7265 at to allow more │ │ │ │ │ -0000b8f0: 206f 7074 696d 697a 6564 2062 6c69 7474 optimized blitt │ │ │ │ │ -0000b900: 6572 7320 746f 2062 6520 7573 6564 2e0a ers to be used.. │ │ │ │ │ -0000b910: 2020 2020 2049 6620 7468 6572 6520 7468 If there th │ │ │ │ │ -0000b920: 6572 6520 6973 206e 6f20 636f 6e66 6967 ere is no config │ │ │ │ │ -0000b930: 7572 6564 2076 6964 656f 2064 7269 7665 ured video drive │ │ │ │ │ -0000b940: 7220 7769 7468 2061 6374 6976 6520 7363 r with active sc │ │ │ │ │ -0000b950: 7265 656e 2c0a 2020 2020 2065 7272 6f72 reen,. error │ │ │ │ │ -0000b960: 2027 4752 5542 5f45 5252 5f42 4144 5f44 'GRUB_ERR_BAD_D │ │ │ │ │ -0000b970: 4556 4943 4527 2069 7320 7265 7475 726e EVICE' is return │ │ │ │ │ -0000b980: 6564 2c20 6f74 6865 7277 6973 6520 276d ed, otherwise 'm │ │ │ │ │ -0000b990: 6f64 655f 696e 666f 2720 6973 0a20 2020 ode_info' is. │ │ │ │ │ -0000b9a0: 2020 6669 6c6c 6564 2077 6974 6820 7661 filled with va │ │ │ │ │ -0000b9b0: 6c69 6420 696e 666f 726d 6174 696f 6e20 lid information │ │ │ │ │ -0000b9c0: 616e 6420 2747 5255 425f 4552 525f 4e4f and 'GRUB_ERR_NO │ │ │ │ │ -0000b9d0: 4e45 2720 6973 2072 6574 7572 6e65 642e NE' is returned. │ │ │ │ │ -0000b9e0: 0a0a 3130 2e31 2e34 2067 7275 625f 7669 ..10.1.4 grub_vi │ │ │ │ │ -0000b9f0: 6465 6f5f 6765 745f 626c 6974 5f66 6f72 deo_get_blit_for │ │ │ │ │ -0000ba00: 6d61 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d mat.------------ │ │ │ │ │ +0000a930: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ │ +0000a940: 7479 7065 3a0a 2020 2020 2020 2020 2020 type:. │ │ │ │ │ +0000a950: 6772 7562 5f65 7272 5f74 0a20 2020 2020 grub_err_t. │ │ │ │ │ +0000a960: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ │ +0000a970: 7365 7475 7020 2875 6e73 6967 6e65 6420 setup (unsigned │ │ │ │ │ +0000a980: 696e 7420 7769 6474 682c 2075 6e73 6967 int width, unsig │ │ │ │ │ +0000a990: 6e65 6420 696e 7420 6865 6967 6874 2c20 ned int height, │ │ │ │ │ +0000a9a0: 756e 7369 676e 6564 2069 6e74 206d 6f64 unsigned int mod │ │ │ │ │ +0000a9b0: 655f 7479 7065 293b 0a20 2020 2a20 4465 e_type);. * De │ │ │ │ │ +0000a9c0: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ +0000a9d0: 2044 7269 7665 7220 7769 6c6c 2075 7365 Driver will use │ │ │ │ │ +0000a9e0: 2069 6e66 6f72 6d61 7469 6f6e 2070 726f information pro │ │ │ │ │ +0000a9f0: 7669 6465 6420 746f 2069 7420 746f 2073 vided to it to s │ │ │ │ │ +0000aa00: 656c 6563 7420 6265 7374 2070 6f73 7369 elect best possi │ │ │ │ │ +0000aa10: 626c 650a 2020 2020 2076 6964 656f 206d ble. video m │ │ │ │ │ +0000aa20: 6f64 6520 616e 6420 7377 6974 6368 2074 ode and switch t │ │ │ │ │ +0000aa30: 6f20 6974 2e20 2053 7570 706f 7274 6564 o it. Supported │ │ │ │ │ +0000aa40: 2076 616c 7565 7320 666f 7220 276d 6f64 values for 'mod │ │ │ │ │ +0000aa50: 655f 7479 7065 2720 6172 650a 2020 2020 e_type' are. │ │ │ │ │ +0000aa60: 2027 4752 5542 5f56 4944 454f 5f4d 4f44 'GRUB_VIDEO_MOD │ │ │ │ │ +0000aa70: 455f 5459 5045 5f49 4e44 4558 5f43 4f4c E_TYPE_INDEX_COL │ │ │ │ │ +0000aa80: 4f52 2720 666f 7220 696e 6465 7820 636f OR' for index co │ │ │ │ │ +0000aa90: 6c6f 7220 6d6f 6465 732c 0a20 2020 2020 lor modes,. │ │ │ │ │ +0000aaa0: 2747 5255 425f 5649 4445 4f5f 4d4f 4445 'GRUB_VIDEO_MODE │ │ │ │ │ +0000aab0: 5f54 5950 455f 5247 4227 2066 6f72 2064 _TYPE_RGB' for d │ │ │ │ │ +0000aac0: 6972 6563 7420 5247 4220 636f 6c6f 7220 irect RGB color │ │ │ │ │ +0000aad0: 6d6f 6465 7320 616e 640a 2020 2020 2027 modes and. ' │ │ │ │ │ +0000aae0: 4752 5542 5f56 4944 454f 5f4d 4f44 455f GRUB_VIDEO_MODE_ │ │ │ │ │ +0000aaf0: 5459 5045 5f44 4f55 424c 455f 4255 4646 TYPE_DOUBLE_BUFF │ │ │ │ │ +0000ab00: 4552 4544 2720 666f 7220 646f 7562 6c65 ERED' for double │ │ │ │ │ +0000ab10: 2062 7566 6665 7269 6e67 2e20 2057 6865 buffering. Whe │ │ │ │ │ +0000ab20: 6e0a 2020 2020 2072 6571 7565 7374 696e n. requestin │ │ │ │ │ +0000ab30: 6720 5247 4220 6d6f 6465 2c20 6869 6768 g RGB mode, high │ │ │ │ │ +0000ab40: 6573 7420 6269 7473 2070 6572 2070 6978 est bits per pix │ │ │ │ │ +0000ab50: 656c 206d 6f64 6520 7769 6c6c 2062 6520 el mode will be │ │ │ │ │ +0000ab60: 7365 6c65 6374 6564 2e0a 2020 2020 2057 selected.. W │ │ │ │ │ +0000ab70: 6865 6e20 7265 7175 6573 7469 6e67 2049 hen requesting I │ │ │ │ │ +0000ab80: 6e64 6578 2063 6f6c 6f72 206d 6f64 652c ndex color mode, │ │ │ │ │ +0000ab90: 206d 6f64 6520 7769 7468 2068 6967 6865 mode with highe │ │ │ │ │ +0000aba0: 7374 206e 756d 6265 7220 6f66 0a20 2020 st number of. │ │ │ │ │ +0000abb0: 2020 636f 6c6f 7273 2077 696c 6c20 6265 colors will be │ │ │ │ │ +0000abc0: 2073 656c 6563 7465 642e 2020 4966 2061 selected. If a │ │ │ │ │ +0000abd0: 6c6c 2070 6172 616d 6574 6572 7320 6172 ll parameters ar │ │ │ │ │ +0000abe0: 6520 7370 6563 6966 6965 6420 6173 207a e specified as z │ │ │ │ │ +0000abf0: 6572 6f2c 0a20 2020 2020 7669 6465 6f20 ero,. video │ │ │ │ │ +0000ac00: 6164 6170 7465 7220 7769 6c6c 2074 7279 adapter will try │ │ │ │ │ +0000ac10: 2074 6f20 6669 6775 7265 206f 7574 2062 to figure out b │ │ │ │ │ +0000ac20: 6573 7420 706f 7373 6962 6c65 206d 6f64 est possible mod │ │ │ │ │ +0000ac30: 6520 616e 640a 2020 2020 2069 6e69 7469 e and. initi │ │ │ │ │ +0000ac40: 616c 697a 6520 6974 2c20 706c 6174 666f alize it, platfo │ │ │ │ │ +0000ac50: 726d 2073 7065 6369 6669 6320 6469 6666 rm specific diff │ │ │ │ │ +0000ac60: 6572 656e 6365 7320 6172 6520 616c 6c6f erences are allo │ │ │ │ │ +0000ac70: 7765 6420 6865 7265 2e20 2049 660a 2020 wed here. If. │ │ │ │ │ +0000ac80: 2020 2074 6865 7265 2069 7320 6e6f 206d there is no m │ │ │ │ │ +0000ac90: 6f64 6520 6d61 7463 6869 6e67 2072 6571 ode matching req │ │ │ │ │ +0000aca0: 7565 7374 2c20 6572 726f 7220 5820 7769 uest, error X wi │ │ │ │ │ +0000acb0: 6c6c 2062 6520 7265 7475 726e 6564 2e20 ll be returned. │ │ │ │ │ +0000acc0: 2049 660a 2020 2020 2074 6865 7265 2061 If. there a │ │ │ │ │ +0000acd0: 7265 206e 6f20 7072 6f62 6c65 6d73 2c20 re no problems, │ │ │ │ │ +0000ace0: 6675 6e63 7469 6f6e 2072 6574 7572 6e73 function returns │ │ │ │ │ +0000acf0: 2027 4752 5542 5f45 5252 5f4e 4f4e 4527 'GRUB_ERR_NONE' │ │ │ │ │ +0000ad00: 2e0a 0a20 2020 2020 5468 6973 2066 756e ... This fun │ │ │ │ │ +0000ad10: 6374 696f 6e20 616c 736f 2070 6572 666f ction also perfo │ │ │ │ │ +0000ad20: 726d 7320 666f 6c6c 6f77 696e 6720 7461 rms following ta │ │ │ │ │ +0000ad30: 736b 2075 706f 6e20 7375 6363 6573 6675 sk upon succesfu │ │ │ │ │ +0000ad40: 6c20 6d6f 6465 0a20 2020 2020 7377 6974 l mode. swit │ │ │ │ │ +0000ad50: 6368 2e20 2041 6374 6976 6520 7265 6e64 ch. Active rend │ │ │ │ │ +0000ad60: 6572 696e 6720 7461 7267 6574 2069 7320 ering target is │ │ │ │ │ +0000ad70: 6368 616e 6765 6420 746f 2073 6372 6565 changed to scree │ │ │ │ │ +0000ad80: 6e20 616e 6420 7669 6577 706f 7274 0a20 n and viewport. │ │ │ │ │ +0000ad90: 2020 2020 6973 206d 6178 696d 697a 6564 is maximized │ │ │ │ │ +0000ada0: 2074 6f20 616c 6c6f 7720 7768 6f6c 6520 to allow whole │ │ │ │ │ +0000adb0: 7363 7265 656e 2074 6f20 6265 2075 7365 screen to be use │ │ │ │ │ +0000adc0: 6420 7768 656e 2070 6572 666f 726d 696e d when performin │ │ │ │ │ +0000add0: 670a 2020 2020 2067 7261 7068 6963 7320 g. graphics │ │ │ │ │ +0000ade0: 6f70 6572 6174 696f 6e73 2e20 2049 6e20 operations. In │ │ │ │ │ +0000adf0: 5247 4220 6d6f 6465 732c 2065 6d75 6c61 RGB modes, emula │ │ │ │ │ +0000ae00: 7465 6420 7061 6c65 7474 6520 6765 7473 ted palette gets │ │ │ │ │ +0000ae10: 2031 360a 2020 2020 2065 6e74 7269 6573 16. entries │ │ │ │ │ +0000ae20: 2063 6f6e 7461 696e 696e 6720 6465 6661 containing defa │ │ │ │ │ +0000ae30: 756c 7420 7661 6c75 6573 2066 6f72 2056 ult values for V │ │ │ │ │ +0000ae40: 4741 2070 616c 6574 7465 2c20 6f74 6865 GA palette, othe │ │ │ │ │ +0000ae50: 7220 636f 6c6f 7273 2061 7265 0a20 2020 r colors are. │ │ │ │ │ +0000ae60: 2020 6465 6669 6e65 6420 6173 2062 6c61 defined as bla │ │ │ │ │ +0000ae70: 636b 2e20 2057 6865 6e20 7377 6974 6368 ck. When switch │ │ │ │ │ +0000ae80: 696e 6720 746f 2049 6e64 6578 6564 2043 ing to Indexed C │ │ │ │ │ +0000ae90: 6f6c 6f72 206d 6f64 652c 2064 7269 7665 olor mode, drive │ │ │ │ │ +0000aea0: 7220 6d61 790a 2020 2020 2073 6574 2064 r may. set d │ │ │ │ │ +0000aeb0: 6566 6175 6c74 2056 4741 2070 616c 6574 efault VGA palet │ │ │ │ │ +0000aec0: 7465 2074 6f20 7363 7265 656e 2069 6620 te to screen if │ │ │ │ │ +0000aed0: 7468 6520 7669 6465 6f20 6361 7264 2061 the video card a │ │ │ │ │ +0000aee0: 6c6c 6f77 7320 7468 650a 2020 2020 206f llows the. o │ │ │ │ │ +0000aef0: 7065 7261 7469 6f6e 2e0a 0a31 302e 312e peration...10.1. │ │ │ │ │ +0000af00: 3220 6772 7562 5f76 6964 656f 5f72 6573 2 grub_video_res │ │ │ │ │ +0000af10: 746f 7265 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d tore.----------- │ │ │ │ │ +0000af20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0000af30: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ +0000af40: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +0000af50: 6572 725f 740a 2020 2020 2020 2020 2020 err_t. │ │ │ │ │ +0000af60: 6772 7562 5f76 6964 656f 5f72 6573 746f grub_video_resto │ │ │ │ │ +0000af70: 7265 2028 766f 6964 293b 0a20 2020 2a20 re (void);. * │ │ │ │ │ +0000af80: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ +0000af90: 2020 2056 6964 656f 2073 7562 7379 7374 Video subsyst │ │ │ │ │ +0000afa0: 656d 2077 696c 6c20 6465 696e 6974 6961 em will deinitia │ │ │ │ │ +0000afb0: 6c69 7a65 2061 6374 6976 6174 6564 2076 lize activated v │ │ │ │ │ +0000afc0: 6964 656f 2064 7269 7665 7220 746f 2072 ideo driver to r │ │ │ │ │ +0000afd0: 6573 746f 7265 0a20 2020 2020 6f6c 6420 estore. old │ │ │ │ │ +0000afe0: 7374 6174 6520 6f66 2076 6964 656f 2064 state of video d │ │ │ │ │ +0000aff0: 6576 6963 652e 2020 5468 6973 2063 616e evice. This can │ │ │ │ │ +0000b000: 2062 6520 7573 6564 2074 6f20 7377 6974 be used to swit │ │ │ │ │ +0000b010: 6368 2062 6163 6b20 746f 2074 6578 740a ch back to text. │ │ │ │ │ +0000b020: 2020 2020 206d 6f64 652e 0a0a 3130 2e31 mode...10.1 │ │ │ │ │ +0000b030: 2e33 2067 7275 625f 7669 6465 6f5f 6765 .3 grub_video_ge │ │ │ │ │ +0000b040: 745f 696e 666f 0a2d 2d2d 2d2d 2d2d 2d2d t_info.--------- │ │ │ │ │ +0000b050: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0000b060: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ +0000b070: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ │ +0000b080: 7562 5f65 7272 5f74 0a20 2020 2020 2020 ub_err_t. │ │ │ │ │ +0000b090: 2020 2067 7275 625f 7669 6465 6f5f 6765 grub_video_ge │ │ │ │ │ +0000b0a0: 745f 696e 666f 2028 7374 7275 6374 2067 t_info (struct g │ │ │ │ │ +0000b0b0: 7275 625f 7669 6465 6f5f 6d6f 6465 5f69 rub_video_mode_i │ │ │ │ │ +0000b0c0: 6e66 6f20 2a6d 6f64 655f 696e 666f 293b nfo *mode_info); │ │ │ │ │ +0000b0d0: 0a20 2020 2020 2020 2020 2073 7472 7563 . struc │ │ │ │ │ +0000b0e0: 7420 6772 7562 5f76 6964 656f 5f6d 6f64 t grub_video_mod │ │ │ │ │ +0000b0f0: 655f 696e 666f 0a20 2020 2020 2020 2020 e_info. │ │ │ │ │ +0000b100: 207b 0a20 2020 2020 2020 2020 2020 202f {. / │ │ │ │ │ +0000b110: 2a20 5769 6474 6820 6f66 2074 6865 2073 * Width of the s │ │ │ │ │ +0000b120: 6372 6565 6e2e 2020 2a2f 0a20 2020 2020 creen. */. │ │ │ │ │ +0000b130: 2020 2020 2020 2075 6e73 6967 6e65 6420 unsigned │ │ │ │ │ +0000b140: 696e 7420 7769 6474 683b 0a20 2020 2020 int width;. │ │ │ │ │ +0000b150: 2020 2020 2020 202f 2a20 4865 6967 6874 /* Height │ │ │ │ │ +0000b160: 206f 6620 7468 6520 7363 7265 656e 2e20 of the screen. │ │ │ │ │ +0000b170: 202a 2f0a 2020 2020 2020 2020 2020 2020 */. │ │ │ │ │ +0000b180: 756e 7369 676e 6564 2069 6e74 2068 6569 unsigned int hei │ │ │ │ │ +0000b190: 6768 743b 0a20 2020 2020 2020 2020 2020 ght;. │ │ │ │ │ +0000b1a0: 202f 2a20 4d6f 6465 2074 7970 6520 6269 /* Mode type bi │ │ │ │ │ +0000b1b0: 746d 6173 6b2e 2020 436f 6e74 6169 6e73 tmask. Contains │ │ │ │ │ +0000b1c0: 2069 6e66 6f72 6d61 7469 6f6e 206c 696b information lik │ │ │ │ │ +0000b1d0: 6520 6973 2069 7420 496e 6465 7820 636f e is it Index co │ │ │ │ │ +0000b1e0: 6c6f 7220 6f72 0a20 2020 2020 2020 2020 lor or. │ │ │ │ │ +0000b1f0: 2020 2020 2020 5247 4220 6d6f 6465 2e20 RGB mode. │ │ │ │ │ +0000b200: 202a 2f0a 2020 2020 2020 2020 2020 2020 */. │ │ │ │ │ +0000b210: 756e 7369 676e 6564 2069 6e74 206d 6f64 unsigned int mod │ │ │ │ │ +0000b220: 655f 7479 7065 3b0a 2020 2020 2020 2020 e_type;. │ │ │ │ │ +0000b230: 2020 2020 2f2a 2042 6974 7320 7065 7220 /* Bits per │ │ │ │ │ +0000b240: 7069 7865 6c2e 2020 2a2f 0a20 2020 2020 pixel. */. │ │ │ │ │ +0000b250: 2020 2020 2020 2075 6e73 6967 6e65 6420 unsigned │ │ │ │ │ +0000b260: 696e 7420 6270 703b 0a20 2020 2020 2020 int bpp;. │ │ │ │ │ +0000b270: 2020 2020 202f 2a20 4279 7465 7320 7065 /* Bytes pe │ │ │ │ │ +0000b280: 7220 7069 7865 6c2e 2020 2a2f 0a20 2020 r pixel. */. │ │ │ │ │ +0000b290: 2020 2020 2020 2020 2075 6e73 6967 6e65 unsigne │ │ │ │ │ +0000b2a0: 6420 696e 7420 6279 7465 735f 7065 725f d int bytes_per_ │ │ │ │ │ +0000b2b0: 7069 7865 6c3b 0a20 2020 2020 2020 2020 pixel;. │ │ │ │ │ +0000b2c0: 2020 202f 2a20 5069 7463 6820 6f66 206f /* Pitch of o │ │ │ │ │ +0000b2d0: 6e65 2073 6361 6e6c 696e 652e 2020 486f ne scanline. Ho │ │ │ │ │ +0000b2e0: 7720 6d61 6e79 2062 7974 6573 2074 6865 w many bytes the │ │ │ │ │ +0000b2f0: 7265 2061 7265 2066 6f72 2073 6361 6e6c re are for scanl │ │ │ │ │ +0000b300: 696e 652e 2020 2a2f 0a20 2020 2020 2020 ine. */. │ │ │ │ │ +0000b310: 2020 2020 2075 6e73 6967 6e65 6420 696e unsigned in │ │ │ │ │ +0000b320: 7420 7069 7463 683b 0a20 2020 2020 2020 t pitch;. │ │ │ │ │ +0000b330: 2020 2020 202f 2a20 496e 2069 6e64 6578 /* In index │ │ │ │ │ +0000b340: 2063 6f6c 6f72 206d 6f64 652c 206e 756d color mode, num │ │ │ │ │ +0000b350: 6265 7220 6f66 2063 6f6c 6f72 732e 2020 ber of colors. │ │ │ │ │ +0000b360: 496e 2052 4742 206d 6f64 6520 7468 6973 In RGB mode this │ │ │ │ │ +0000b370: 2069 7320 3235 362e 2020 2a2f 0a20 2020 is 256. */. │ │ │ │ │ +0000b380: 2020 2020 2020 2020 2075 6e73 6967 6e65 unsigne │ │ │ │ │ +0000b390: 6420 696e 7420 6e75 6d62 6572 5f6f 665f d int number_of_ │ │ │ │ │ +0000b3a0: 636f 6c6f 7273 3b0a 2020 2020 2020 2020 colors;. │ │ │ │ │ +0000b3b0: 2020 2020 2f2a 204f 7074 696d 697a 6174 /* Optimizat │ │ │ │ │ +0000b3c0: 696f 6e20 6869 6e74 2068 6f77 2062 696e ion hint how bin │ │ │ │ │ +0000b3d0: 6172 7920 6461 7461 2069 7320 636f 6465 ary data is code │ │ │ │ │ +0000b3e0: 642e 2020 2a2f 0a20 2020 2020 2020 2020 d. */. │ │ │ │ │ +0000b3f0: 2020 2065 6e75 6d20 6772 7562 5f76 6964 enum grub_vid │ │ │ │ │ +0000b400: 656f 5f62 6c69 745f 666f 726d 6174 2062 eo_blit_format b │ │ │ │ │ +0000b410: 6c69 745f 666f 726d 6174 3b0a 2020 2020 lit_format;. │ │ │ │ │ +0000b420: 2020 2020 2020 2020 2f2a 2048 6f77 206d /* How m │ │ │ │ │ +0000b430: 616e 7920 6269 7473 2061 7265 2072 6573 any bits are res │ │ │ │ │ +0000b440: 6572 7665 6420 666f 7220 7265 6420 636f erved for red co │ │ │ │ │ +0000b450: 6c6f 722e 2020 2a2f 0a20 2020 2020 2020 lor. */. │ │ │ │ │ +0000b460: 2020 2020 2075 6e73 6967 6e65 6420 696e unsigned in │ │ │ │ │ +0000b470: 7420 7265 645f 6d61 736b 5f73 697a 653b t red_mask_size; │ │ │ │ │ +0000b480: 0a20 2020 2020 2020 2020 2020 202f 2a20 . /* │ │ │ │ │ +0000b490: 5768 6174 2069 7320 6c6f 6361 7469 6f6e What is location │ │ │ │ │ +0000b4a0: 206f 6620 7265 6420 636f 6c6f 7220 6269 of red color bi │ │ │ │ │ +0000b4b0: 7473 2e20 2049 6e20 496e 6465 7820 436f ts. In Index Co │ │ │ │ │ +0000b4c0: 6c6f 7220 6d6f 6465 2c20 7468 6973 2069 lor mode, this i │ │ │ │ │ +0000b4d0: 7320 302e 2020 2a2f 0a20 2020 2020 2020 s 0. */. │ │ │ │ │ +0000b4e0: 2020 2020 2075 6e73 6967 6e65 6420 696e unsigned in │ │ │ │ │ +0000b4f0: 7420 7265 645f 6669 656c 645f 706f 733b t red_field_pos; │ │ │ │ │ +0000b500: 0a20 2020 2020 2020 2020 2020 202f 2a20 . /* │ │ │ │ │ +0000b510: 486f 7720 6d61 6e79 2062 6974 7320 6172 How many bits ar │ │ │ │ │ +0000b520: 6520 7265 7365 7276 6564 2066 6f72 2067 e reserved for g │ │ │ │ │ +0000b530: 7265 656e 2063 6f6c 6f72 2e20 202a 2f0a reen color. */. │ │ │ │ │ +0000b540: 2020 2020 2020 2020 2020 2020 756e 7369 unsi │ │ │ │ │ +0000b550: 676e 6564 2069 6e74 2067 7265 656e 5f6d gned int green_m │ │ │ │ │ +0000b560: 6173 6b5f 7369 7a65 3b0a 2020 2020 2020 ask_size;. │ │ │ │ │ +0000b570: 2020 2020 2020 2f2a 2057 6861 7420 6973 /* What is │ │ │ │ │ +0000b580: 206c 6f63 6174 696f 6e20 6f66 2067 7265 location of gre │ │ │ │ │ +0000b590: 656e 2063 6f6c 6f72 2062 6974 732e 2020 en color bits. │ │ │ │ │ +0000b5a0: 496e 2049 6e64 6578 2043 6f6c 6f72 206d In Index Color m │ │ │ │ │ +0000b5b0: 6f64 652c 2074 6869 7320 6973 2030 2e20 ode, this is 0. │ │ │ │ │ +0000b5c0: 202a 2f0a 2020 2020 2020 2020 2020 2020 */. │ │ │ │ │ +0000b5d0: 756e 7369 676e 6564 2069 6e74 2067 7265 unsigned int gre │ │ │ │ │ +0000b5e0: 656e 5f66 6965 6c64 5f70 6f73 3b0a 2020 en_field_pos;. │ │ │ │ │ +0000b5f0: 2020 2020 2020 2020 2020 2f2a 2048 6f77 /* How │ │ │ │ │ +0000b600: 206d 616e 7920 6269 7473 2061 7265 2072 many bits are r │ │ │ │ │ +0000b610: 6573 6572 7665 6420 666f 7220 626c 7565 eserved for blue │ │ │ │ │ +0000b620: 2063 6f6c 6f72 2e20 202a 2f0a 2020 2020 color. */. │ │ │ │ │ +0000b630: 2020 2020 2020 2020 756e 7369 676e 6564 unsigned │ │ │ │ │ +0000b640: 2069 6e74 2062 6c75 655f 6d61 736b 5f73 int blue_mask_s │ │ │ │ │ +0000b650: 697a 653b 0a20 2020 2020 2020 2020 2020 ize;. │ │ │ │ │ +0000b660: 202f 2a20 5768 6174 2069 7320 6c6f 6361 /* What is loca │ │ │ │ │ +0000b670: 7469 6f6e 206f 6620 626c 7565 2063 6f6c tion of blue col │ │ │ │ │ +0000b680: 6f72 2062 6974 732e 2020 496e 2049 6e64 or bits. In Ind │ │ │ │ │ +0000b690: 6578 2043 6f6c 6f72 206d 6f64 652c 2074 ex Color mode, t │ │ │ │ │ +0000b6a0: 6869 7320 6973 2030 2e20 202a 2f0a 2020 his is 0. */. │ │ │ │ │ +0000b6b0: 2020 2020 2020 2020 2020 756e 7369 676e unsign │ │ │ │ │ +0000b6c0: 6564 2069 6e74 2062 6c75 655f 6669 656c ed int blue_fiel │ │ │ │ │ +0000b6d0: 645f 706f 733b 0a20 2020 2020 2020 2020 d_pos;. │ │ │ │ │ +0000b6e0: 2020 202f 2a20 486f 7720 6d61 6e79 2062 /* How many b │ │ │ │ │ +0000b6f0: 6974 7320 6172 6520 7265 7365 7276 6564 its are reserved │ │ │ │ │ +0000b700: 2069 6e20 636f 6c6f 722e 2020 2a2f 0a20 in color. */. │ │ │ │ │ +0000b710: 2020 2020 2020 2020 2020 2075 6e73 6967 unsig │ │ │ │ │ +0000b720: 6e65 6420 696e 7420 7265 7365 7276 6564 ned int reserved │ │ │ │ │ +0000b730: 5f6d 6173 6b5f 7369 7a65 3b0a 2020 2020 _mask_size;. │ │ │ │ │ +0000b740: 2020 2020 2020 2020 2f2a 2057 6861 7420 /* What │ │ │ │ │ +0000b750: 6973 206c 6f63 6174 696f 6e20 6f66 2072 is location of r │ │ │ │ │ +0000b760: 6573 6572 7665 6420 636f 6c6f 7220 6269 eserved color bi │ │ │ │ │ +0000b770: 7473 2e20 2049 6e20 496e 6465 7820 436f ts. In Index Co │ │ │ │ │ +0000b780: 6c6f 7220 6d6f 6465 2c0a 2020 2020 2020 lor mode,. │ │ │ │ │ +0000b790: 2020 2020 2020 2020 2074 6869 7320 6973 this is │ │ │ │ │ +0000b7a0: 2030 2e20 202a 2f0a 2020 2020 2020 2020 0. */. │ │ │ │ │ +0000b7b0: 2020 2020 756e 7369 676e 6564 2069 6e74 unsigned int │ │ │ │ │ +0000b7c0: 2072 6573 6572 7665 645f 6669 656c 645f reserved_field_ │ │ │ │ │ +0000b7d0: 706f 733b 0a20 2020 2020 2020 2020 207d pos;. } │ │ │ │ │ +0000b7e0: 3b0a 2020 202a 2044 6573 6372 6970 7469 ;. * Descripti │ │ │ │ │ +0000b7f0: 6f6e 3a0a 0a20 2020 2020 536f 6674 7761 on:.. Softwa │ │ │ │ │ +0000b800: 7265 2064 6576 656c 6f70 6572 2063 616e re developer can │ │ │ │ │ +0000b810: 2075 7365 2074 6869 7320 6675 6e63 7469 use this functi │ │ │ │ │ +0000b820: 6f6e 2074 6f20 7175 6572 7920 7072 6f70 on to query prop │ │ │ │ │ +0000b830: 6572 7469 6573 206f 660a 2020 2020 2061 erties of. a │ │ │ │ │ +0000b840: 6374 6976 6520 7265 6e64 6572 696e 6720 ctive rendering │ │ │ │ │ +0000b850: 7461 6765 742e 2020 496e 666f 726d 6174 taget. Informat │ │ │ │ │ +0000b860: 696f 6e20 7072 6f76 6964 6564 2068 6572 ion provided her │ │ │ │ │ +0000b870: 6520 6361 6e20 6265 2075 7365 6420 6279 e can be used by │ │ │ │ │ +0000b880: 0a20 2020 2020 6f74 6865 7220 7061 7274 . other part │ │ │ │ │ +0000b890: 7320 6f66 2047 5255 422c 206c 696b 6520 s of GRUB, like │ │ │ │ │ +0000b8a0: 696d 6167 6520 6c6f 6164 6572 7320 746f image loaders to │ │ │ │ │ +0000b8b0: 2063 6f6e 7665 7274 206c 6f61 6465 6420 convert loaded │ │ │ │ │ +0000b8c0: 696d 6167 6573 2074 6f0a 2020 2020 2063 images to. c │ │ │ │ │ +0000b8d0: 6f72 7265 6374 2073 6372 6565 6e20 666f orrect screen fo │ │ │ │ │ +0000b8e0: 726d 6174 2074 6f20 616c 6c6f 7720 6d6f rmat to allow mo │ │ │ │ │ +0000b8f0: 7265 206f 7074 696d 697a 6564 2062 6c69 re optimized bli │ │ │ │ │ +0000b900: 7474 6572 7320 746f 2062 6520 7573 6564 tters to be used │ │ │ │ │ +0000b910: 2e0a 2020 2020 2049 6620 7468 6572 6520 .. If there │ │ │ │ │ +0000b920: 7468 6572 6520 6973 206e 6f20 636f 6e66 there is no conf │ │ │ │ │ +0000b930: 6967 7572 6564 2076 6964 656f 2064 7269 igured video dri │ │ │ │ │ +0000b940: 7665 7220 7769 7468 2061 6374 6976 6520 ver with active │ │ │ │ │ +0000b950: 7363 7265 656e 2c0a 2020 2020 2065 7272 screen,. err │ │ │ │ │ +0000b960: 6f72 2027 4752 5542 5f45 5252 5f42 4144 or 'GRUB_ERR_BAD │ │ │ │ │ +0000b970: 5f44 4556 4943 4527 2069 7320 7265 7475 _DEVICE' is retu │ │ │ │ │ +0000b980: 726e 6564 2c20 6f74 6865 7277 6973 6520 rned, otherwise │ │ │ │ │ +0000b990: 276d 6f64 655f 696e 666f 2720 6973 0a20 'mode_info' is. │ │ │ │ │ +0000b9a0: 2020 2020 6669 6c6c 6564 2077 6974 6820 filled with │ │ │ │ │ +0000b9b0: 7661 6c69 6420 696e 666f 726d 6174 696f valid informatio │ │ │ │ │ +0000b9c0: 6e20 616e 6420 2747 5255 425f 4552 525f n and 'GRUB_ERR_ │ │ │ │ │ +0000b9d0: 4e4f 4e45 2720 6973 2072 6574 7572 6e65 NONE' is returne │ │ │ │ │ +0000b9e0: 642e 0a0a 3130 2e31 2e34 2067 7275 625f d...10.1.4 grub_ │ │ │ │ │ +0000b9f0: 7669 6465 6f5f 6765 745f 626c 6974 5f66 video_get_blit_f │ │ │ │ │ +0000ba00: 6f72 6d61 740a 2d2d 2d2d 2d2d 2d2d 2d2d ormat.---------- │ │ │ │ │ 0000ba10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000ba20: 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 6f74 -----.. * Prot │ │ │ │ │ -0000ba30: 6f74 7970 653a 0a0a 2020 2020 2020 2020 otype:.. │ │ │ │ │ -0000ba40: 2020 656e 756d 2067 7275 625f 7669 6465 enum grub_vide │ │ │ │ │ -0000ba50: 6f5f 626c 6974 5f66 6f72 6d61 740a 2020 o_blit_format. │ │ │ │ │ -0000ba60: 2020 2020 2020 2020 6772 7562 5f76 6964 grub_vid │ │ │ │ │ -0000ba70: 656f 5f67 6574 5f62 6c69 745f 666f 726d eo_get_blit_form │ │ │ │ │ -0000ba80: 6174 2028 7374 7275 6374 2067 7275 625f at (struct grub_ │ │ │ │ │ -0000ba90: 7669 6465 6f5f 6d6f 6465 5f69 6e66 6f20 video_mode_info │ │ │ │ │ -0000baa0: 2a6d 6f64 655f 696e 666f 293b 0a20 2020 *mode_info);. │ │ │ │ │ -0000bab0: 2020 2020 2020 2065 6e75 6d20 6772 7562 enum grub │ │ │ │ │ -0000bac0: 5f76 6964 656f 5f62 6c69 745f 666f 726d _video_blit_form │ │ │ │ │ -0000bad0: 6174 0a20 2020 2020 2020 2020 2020 207b at. { │ │ │ │ │ -0000bae0: 0a20 2020 2020 2020 2020 2020 2020 202f . / │ │ │ │ │ -0000baf0: 2a20 466f 6c6c 6f77 2065 7861 6374 6c79 * Follow exactly │ │ │ │ │ -0000bb00: 2066 6965 6c64 2026 206d 6173 6b20 696e field & mask in │ │ │ │ │ -0000bb10: 666f 726d 6174 696f 6e2e 2020 2a2f 0a20 formation. */. │ │ │ │ │ -0000bb20: 2020 2020 2020 2020 2020 2020 2047 5255 GRU │ │ │ │ │ -0000bb30: 425f 5649 4445 4f5f 424c 4954 5f46 4f52 B_VIDEO_BLIT_FOR │ │ │ │ │ -0000bb40: 4d41 545f 5247 4241 2c0a 2020 2020 2020 MAT_RGBA,. │ │ │ │ │ -0000bb50: 2020 2020 2020 2020 2f2a 204d 616b 6520 /* Make │ │ │ │ │ -0000bb60: 6f70 7469 6d69 7a61 7469 6f6e 2061 7373 optimization ass │ │ │ │ │ -0000bb70: 756d 7074 696f 6e2e 2020 2a2f 0a20 2020 umption. */. │ │ │ │ │ -0000bb80: 2020 2020 2020 2020 2020 2047 5255 425f GRUB_ │ │ │ │ │ -0000bb90: 5649 4445 4f5f 424c 4954 5f46 4f52 4d41 VIDEO_BLIT_FORMA │ │ │ │ │ -0000bba0: 545f 5238 4738 4238 4138 2c0a 2020 2020 T_R8G8B8A8,. │ │ │ │ │ -0000bbb0: 2020 2020 2020 2020 2020 2f2a 2046 6f6c /* Fol │ │ │ │ │ -0000bbc0: 6c6f 7720 6578 6163 746c 7920 6669 656c low exactly fiel │ │ │ │ │ -0000bbd0: 6420 2620 6d61 736b 2069 6e66 6f72 6d61 d & mask informa │ │ │ │ │ -0000bbe0: 7469 6f6e 2e20 202a 2f0a 2020 2020 2020 tion. */. │ │ │ │ │ -0000bbf0: 2020 2020 2020 2020 4752 5542 5f56 4944 GRUB_VID │ │ │ │ │ -0000bc00: 454f 5f42 4c49 545f 464f 524d 4154 5f52 EO_BLIT_FORMAT_R │ │ │ │ │ -0000bc10: 4742 2c0a 2020 2020 2020 2020 2020 2020 GB,. │ │ │ │ │ -0000bc20: 2020 2f2a 204d 616b 6520 6f70 7469 6d69 /* Make optimi │ │ │ │ │ -0000bc30: 7a61 7469 6f6e 2061 7373 756d 7074 696f zation assumptio │ │ │ │ │ -0000bc40: 6e2e 2020 2a2f 0a20 2020 2020 2020 2020 n. */. │ │ │ │ │ -0000bc50: 2020 2020 2047 5255 425f 5649 4445 4f5f GRUB_VIDEO_ │ │ │ │ │ -0000bc60: 424c 4954 5f46 4f52 4d41 545f 5238 4738 BLIT_FORMAT_R8G8 │ │ │ │ │ -0000bc70: 4238 2c0a 2020 2020 2020 2020 2020 2020 B8,. │ │ │ │ │ -0000bc80: 2020 2f2a 2057 6865 6e20 6e65 6564 6564 /* When needed │ │ │ │ │ -0000bc90: 2c20 6465 636f 6465 2063 6f6c 6f72 206f , decode color o │ │ │ │ │ -0000bca0: 7220 6a75 7374 2075 7365 2076 616c 7565 r just use value │ │ │ │ │ -0000bcb0: 2061 7320 6973 2e20 202a 2f0a 2020 2020 as is. */. │ │ │ │ │ -0000bcc0: 2020 2020 2020 2020 2020 4752 5542 5f56 GRUB_V │ │ │ │ │ -0000bcd0: 4944 454f 5f42 4c49 545f 464f 524d 4154 IDEO_BLIT_FORMAT │ │ │ │ │ -0000bce0: 5f49 4e44 4558 434f 4c4f 520a 2020 2020 _INDEXCOLOR. │ │ │ │ │ -0000bcf0: 2020 2020 2020 2020 7d3b 0a20 2020 2a20 };. * │ │ │ │ │ -0000bd00: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ -0000bd10: 2020 2055 7365 6420 746f 2071 7565 7279 Used to query │ │ │ │ │ -0000bd20: 2068 6f77 2064 6174 6120 636f 756c 6420 how data could │ │ │ │ │ -0000bd30: 6265 206f 7074 696d 697a 6564 2074 6f20 be optimized to │ │ │ │ │ -0000bd40: 7375 6974 2073 7065 6369 6669 6564 2076 suit specified v │ │ │ │ │ -0000bd50: 6964 656f 0a20 2020 2020 6d6f 6465 2e20 ideo. mode. │ │ │ │ │ -0000bd60: 2052 6574 7572 6e73 2065 7861 6374 2076 Returns exact v │ │ │ │ │ -0000bd70: 6964 656f 2066 6f72 6d61 7420 7479 7065 ideo format type │ │ │ │ │ -0000bd80: 2c20 6f72 2061 2067 656e 6572 6963 206f , or a generic o │ │ │ │ │ -0000bd90: 6e65 2069 6620 7468 6572 650a 2020 2020 ne if there. │ │ │ │ │ -0000bda0: 2069 7320 6e6f 2064 6566 696e 6974 696f is no definitio │ │ │ │ │ -0000bdb0: 6e20 666f 7220 7468 6520 7479 7065 2e20 n for the type. │ │ │ │ │ -0000bdc0: 2046 6f72 2067 656e 6572 6963 2066 6f72 For generic for │ │ │ │ │ -0000bdd0: 6d61 7473 2c20 7573 650a 2020 2020 2027 mats, use. ' │ │ │ │ │ -0000bde0: 6772 7562 5f76 6964 656f 5f67 6574 5f69 grub_video_get_i │ │ │ │ │ -0000bdf0: 6e66 6f27 2074 6f20 7175 6572 7920 7669 nfo' to query vi │ │ │ │ │ -0000be00: 6465 6f20 636f 6c6f 7220 636f 6469 6e67 deo color coding │ │ │ │ │ -0000be10: 2073 6574 7469 6e67 732e 0a0a 3130 2e31 settings...10.1 │ │ │ │ │ -0000be20: 2e35 2067 7275 625f 7669 6465 6f5f 7365 .5 grub_video_se │ │ │ │ │ -0000be30: 745f 7061 6c65 7474 650a 2d2d 2d2d 2d2d t_palette.------ │ │ │ │ │ +0000ba20: 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 -------.. * Pr │ │ │ │ │ +0000ba30: 6f74 6f74 7970 653a 0a0a 2020 2020 2020 ototype:.. │ │ │ │ │ +0000ba40: 2020 2020 656e 756d 2067 7275 625f 7669 enum grub_vi │ │ │ │ │ +0000ba50: 6465 6f5f 626c 6974 5f66 6f72 6d61 740a deo_blit_format. │ │ │ │ │ +0000ba60: 2020 2020 2020 2020 2020 6772 7562 5f76 grub_v │ │ │ │ │ +0000ba70: 6964 656f 5f67 6574 5f62 6c69 745f 666f ideo_get_blit_fo │ │ │ │ │ +0000ba80: 726d 6174 2028 7374 7275 6374 2067 7275 rmat (struct gru │ │ │ │ │ +0000ba90: 625f 7669 6465 6f5f 6d6f 6465 5f69 6e66 b_video_mode_inf │ │ │ │ │ +0000baa0: 6f20 2a6d 6f64 655f 696e 666f 293b 0a20 o *mode_info);. │ │ │ │ │ +0000bab0: 2020 2020 2020 2020 2065 6e75 6d20 6772 enum gr │ │ │ │ │ +0000bac0: 7562 5f76 6964 656f 5f62 6c69 745f 666f ub_video_blit_fo │ │ │ │ │ +0000bad0: 726d 6174 0a20 2020 2020 2020 2020 2020 rmat. │ │ │ │ │ +0000bae0: 207b 0a20 2020 2020 2020 2020 2020 2020 {. │ │ │ │ │ +0000baf0: 202f 2a20 466f 6c6c 6f77 2065 7861 6374 /* Follow exact │ │ │ │ │ +0000bb00: 6c79 2066 6965 6c64 2026 206d 6173 6b20 ly field & mask │ │ │ │ │ +0000bb10: 696e 666f 726d 6174 696f 6e2e 2020 2a2f information. */ │ │ │ │ │ +0000bb20: 0a20 2020 2020 2020 2020 2020 2020 2047 . G │ │ │ │ │ +0000bb30: 5255 425f 5649 4445 4f5f 424c 4954 5f46 RUB_VIDEO_BLIT_F │ │ │ │ │ +0000bb40: 4f52 4d41 545f 5247 4241 2c0a 2020 2020 ORMAT_RGBA,. │ │ │ │ │ +0000bb50: 2020 2020 2020 2020 2020 2f2a 204d 616b /* Mak │ │ │ │ │ +0000bb60: 6520 6f70 7469 6d69 7a61 7469 6f6e 2061 e optimization a │ │ │ │ │ +0000bb70: 7373 756d 7074 696f 6e2e 2020 2a2f 0a20 ssumption. */. │ │ │ │ │ +0000bb80: 2020 2020 2020 2020 2020 2020 2047 5255 GRU │ │ │ │ │ +0000bb90: 425f 5649 4445 4f5f 424c 4954 5f46 4f52 B_VIDEO_BLIT_FOR │ │ │ │ │ +0000bba0: 4d41 545f 5238 4738 4238 4138 2c0a 2020 MAT_R8G8B8A8,. │ │ │ │ │ +0000bbb0: 2020 2020 2020 2020 2020 2020 2f2a 2046 /* F │ │ │ │ │ +0000bbc0: 6f6c 6c6f 7720 6578 6163 746c 7920 6669 ollow exactly fi │ │ │ │ │ +0000bbd0: 656c 6420 2620 6d61 736b 2069 6e66 6f72 eld & mask infor │ │ │ │ │ +0000bbe0: 6d61 7469 6f6e 2e20 202a 2f0a 2020 2020 mation. */. │ │ │ │ │ +0000bbf0: 2020 2020 2020 2020 2020 4752 5542 5f56 GRUB_V │ │ │ │ │ +0000bc00: 4944 454f 5f42 4c49 545f 464f 524d 4154 IDEO_BLIT_FORMAT │ │ │ │ │ +0000bc10: 5f52 4742 2c0a 2020 2020 2020 2020 2020 _RGB,. │ │ │ │ │ +0000bc20: 2020 2020 2f2a 204d 616b 6520 6f70 7469 /* Make opti │ │ │ │ │ +0000bc30: 6d69 7a61 7469 6f6e 2061 7373 756d 7074 mization assumpt │ │ │ │ │ +0000bc40: 696f 6e2e 2020 2a2f 0a20 2020 2020 2020 ion. */. │ │ │ │ │ +0000bc50: 2020 2020 2020 2047 5255 425f 5649 4445 GRUB_VIDE │ │ │ │ │ +0000bc60: 4f5f 424c 4954 5f46 4f52 4d41 545f 5238 O_BLIT_FORMAT_R8 │ │ │ │ │ +0000bc70: 4738 4238 2c0a 2020 2020 2020 2020 2020 G8B8,. │ │ │ │ │ +0000bc80: 2020 2020 2f2a 2057 6865 6e20 6e65 6564 /* When need │ │ │ │ │ +0000bc90: 6564 2c20 6465 636f 6465 2063 6f6c 6f72 ed, decode color │ │ │ │ │ +0000bca0: 206f 7220 6a75 7374 2075 7365 2076 616c or just use val │ │ │ │ │ +0000bcb0: 7565 2061 7320 6973 2e20 202a 2f0a 2020 ue as is. */. │ │ │ │ │ +0000bcc0: 2020 2020 2020 2020 2020 2020 4752 5542 GRUB │ │ │ │ │ +0000bcd0: 5f56 4944 454f 5f42 4c49 545f 464f 524d _VIDEO_BLIT_FORM │ │ │ │ │ +0000bce0: 4154 5f49 4e44 4558 434f 4c4f 520a 2020 AT_INDEXCOLOR. │ │ │ │ │ +0000bcf0: 2020 2020 2020 2020 2020 7d3b 0a20 2020 };. │ │ │ │ │ +0000bd00: 2a20 4465 7363 7269 7074 696f 6e3a 0a0a * Description:.. │ │ │ │ │ +0000bd10: 2020 2020 2055 7365 6420 746f 2071 7565 Used to que │ │ │ │ │ +0000bd20: 7279 2068 6f77 2064 6174 6120 636f 756c ry how data coul │ │ │ │ │ +0000bd30: 6420 6265 206f 7074 696d 697a 6564 2074 d be optimized t │ │ │ │ │ +0000bd40: 6f20 7375 6974 2073 7065 6369 6669 6564 o suit specified │ │ │ │ │ +0000bd50: 2076 6964 656f 0a20 2020 2020 6d6f 6465 video. mode │ │ │ │ │ +0000bd60: 2e20 2052 6574 7572 6e73 2065 7861 6374 . Returns exact │ │ │ │ │ +0000bd70: 2076 6964 656f 2066 6f72 6d61 7420 7479 video format ty │ │ │ │ │ +0000bd80: 7065 2c20 6f72 2061 2067 656e 6572 6963 pe, or a generic │ │ │ │ │ +0000bd90: 206f 6e65 2069 6620 7468 6572 650a 2020 one if there. │ │ │ │ │ +0000bda0: 2020 2069 7320 6e6f 2064 6566 696e 6974 is no definit │ │ │ │ │ +0000bdb0: 696f 6e20 666f 7220 7468 6520 7479 7065 ion for the type │ │ │ │ │ +0000bdc0: 2e20 2046 6f72 2067 656e 6572 6963 2066 . For generic f │ │ │ │ │ +0000bdd0: 6f72 6d61 7473 2c20 7573 650a 2020 2020 ormats, use. │ │ │ │ │ +0000bde0: 2027 6772 7562 5f76 6964 656f 5f67 6574 'grub_video_get │ │ │ │ │ +0000bdf0: 5f69 6e66 6f27 2074 6f20 7175 6572 7920 _info' to query │ │ │ │ │ +0000be00: 7669 6465 6f20 636f 6c6f 7220 636f 6469 video color codi │ │ │ │ │ +0000be10: 6e67 2073 6574 7469 6e67 732e 0a0a 3130 ng settings...10 │ │ │ │ │ +0000be20: 2e31 2e35 2067 7275 625f 7669 6465 6f5f .1.5 grub_video_ │ │ │ │ │ +0000be30: 7365 745f 7061 6c65 7474 650a 2d2d 2d2d set_palette.---- │ │ │ │ │ 0000be40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000be50: 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 -------.. * Pr │ │ │ │ │ -0000be60: 6f74 6f74 7970 653a 0a0a 2020 2020 2020 ototype:.. │ │ │ │ │ -0000be70: 2020 2020 6772 7562 5f65 7272 5f74 0a20 grub_err_t. │ │ │ │ │ -0000be80: 2020 2020 2020 2020 2067 7275 625f 7669 grub_vi │ │ │ │ │ -0000be90: 6465 6f5f 7365 745f 7061 6c65 7474 6520 deo_set_palette │ │ │ │ │ -0000bea0: 2875 6e73 6967 6e65 6420 696e 7420 7374 (unsigned int st │ │ │ │ │ -0000beb0: 6172 742c 2075 6e73 6967 6e65 6420 696e art, unsigned in │ │ │ │ │ -0000bec0: 7420 636f 756e 742c 2073 7472 7563 7420 t count, struct │ │ │ │ │ -0000bed0: 6772 7562 5f76 6964 656f 5f70 616c 6574 grub_video_palet │ │ │ │ │ -0000bee0: 7465 5f64 6174 6120 2a70 616c 6574 7465 te_data *palette │ │ │ │ │ -0000bef0: 5f64 6174 6129 3b0a 2020 2020 2020 2020 _data);. │ │ │ │ │ -0000bf00: 2020 7374 7275 6374 2067 7275 625f 7669 struct grub_vi │ │ │ │ │ -0000bf10: 6465 6f5f 7061 6c65 7474 655f 6461 7461 deo_palette_data │ │ │ │ │ -0000bf20: 0a20 2020 2020 2020 2020 207b 0a20 2020 . {. │ │ │ │ │ -0000bf30: 2020 2020 2020 2020 2020 2067 7275 625f grub_ │ │ │ │ │ -0000bf40: 7569 6e74 385f 7420 723b 202f 2a20 5265 uint8_t r; /* Re │ │ │ │ │ -0000bf50: 6420 636f 6c6f 7220 7661 6c75 6520 2830 d color value (0 │ │ │ │ │ -0000bf60: 2d32 3535 292e 202a 2f0a 2020 2020 2020 -255). */. │ │ │ │ │ -0000bf70: 2020 2020 2020 2020 6772 7562 5f75 696e grub_uin │ │ │ │ │ -0000bf80: 7438 5f74 2067 3b20 2f2a 2047 7265 656e t8_t g; /* Green │ │ │ │ │ -0000bf90: 2063 6f6c 6f72 2076 616c 7565 2028 302d color value (0- │ │ │ │ │ -0000bfa0: 3235 3529 2e20 2a2f 0a20 2020 2020 2020 255). */. │ │ │ │ │ -0000bfb0: 2020 2020 2020 2067 7275 625f 7569 6e74 grub_uint │ │ │ │ │ -0000bfc0: 385f 7420 623b 202f 2a20 426c 7565 2063 8_t b; /* Blue c │ │ │ │ │ -0000bfd0: 6f6c 6f72 2076 616c 7565 2028 302d 3235 olor value (0-25 │ │ │ │ │ -0000bfe0: 3529 2e20 2a2f 0a20 2020 2020 2020 2020 5). */. │ │ │ │ │ -0000bff0: 2020 2020 2067 7275 625f 7569 6e74 385f grub_uint8_ │ │ │ │ │ -0000c000: 7420 613b 202f 2a20 5265 7365 7276 6564 t a; /* Reserved │ │ │ │ │ -0000c010: 2062 6974 7320 7661 6c75 6520 2830 2d32 bits value (0-2 │ │ │ │ │ -0000c020: 3535 292e 202a 2f0a 2020 2020 2020 2020 55). */. │ │ │ │ │ -0000c030: 2020 7d3b 0a20 2020 2a20 4465 7363 7269 };. * Descri │ │ │ │ │ -0000c040: 7074 696f 6e3a 0a0a 2020 2020 2055 7365 ption:.. Use │ │ │ │ │ -0000c050: 6420 746f 2073 6574 7570 2069 6e64 6578 d to setup index │ │ │ │ │ -0000c060: 6564 2063 6f6c 6f72 2070 616c 6574 7465 ed color palette │ │ │ │ │ -0000c070: 732e 2020 4966 206d 6f64 6520 6973 2052 s. If mode is R │ │ │ │ │ -0000c080: 4742 206d 6f64 652c 2063 6f6c 6f72 730a GB mode, colors. │ │ │ │ │ -0000c090: 2020 2020 2077 696c 6c20 6265 2073 6574 will be set │ │ │ │ │ -0000c0a0: 2074 6f20 656d 756c 6174 6564 2070 616c to emulated pal │ │ │ │ │ -0000c0b0: 6574 7465 2064 6174 612e 2020 496e 2049 ette data. In I │ │ │ │ │ -0000c0c0: 6e64 6578 6564 2043 6f6c 6f72 206d 6f64 ndexed Color mod │ │ │ │ │ -0000c0d0: 6573 2c0a 2020 2020 2070 616c 6574 7465 es,. palette │ │ │ │ │ -0000c0e0: 7320 7769 6c6c 2062 6520 7365 7420 746f s will be set to │ │ │ │ │ -0000c0f0: 2068 6172 6477 6172 652e 2020 436f 6c6f hardware. Colo │ │ │ │ │ -0000c100: 7220 7661 6c75 6573 2077 696c 6c20 6265 r values will be │ │ │ │ │ -0000c110: 2063 6f6e 7665 7274 6564 0a20 2020 2020 converted. │ │ │ │ │ -0000c120: 746f 2073 7569 7420 7265 7175 6972 656d to suit requirem │ │ │ │ │ -0000c130: 656e 7473 206f 6620 7468 6520 7669 6465 ents of the vide │ │ │ │ │ -0000c140: 6f20 6d6f 6465 2e20 2027 7374 6172 7427 o mode. 'start' │ │ │ │ │ -0000c150: 2077 696c 6c20 7465 6c6c 2077 6861 740a will tell what. │ │ │ │ │ -0000c160: 2020 2020 2068 6172 6477 6172 6520 636f hardware co │ │ │ │ │ -0000c170: 6c6f 7220 696e 6465 7820 286f 7220 656d lor index (or em │ │ │ │ │ -0000c180: 756c 6174 6564 2063 6f6c 6f72 2069 6e64 ulated color ind │ │ │ │ │ -0000c190: 6578 2920 7769 6c6c 2062 6520 7365 7420 ex) will be set │ │ │ │ │ -0000c1a0: 746f 0a20 2020 2020 6163 636f 7264 696e to. accordin │ │ │ │ │ -0000c1b0: 6720 696e 666f 726d 6174 696f 6e20 696e g information in │ │ │ │ │ -0000c1c0: 2066 6972 7374 2069 6e64 6963 6520 6f66 first indice of │ │ │ │ │ -0000c1d0: 2027 7061 6c65 7474 655f 6461 7461 272c 'palette_data', │ │ │ │ │ -0000c1e0: 2061 6674 6572 2074 6861 740a 2020 2020 after that. │ │ │ │ │ -0000c1f0: 2062 6f74 6820 6861 7264 7761 7265 2063 both hardware c │ │ │ │ │ -0000c200: 6f6c 6f72 2069 6e64 6578 2061 6e64 2027 olor index and ' │ │ │ │ │ -0000c210: 7061 6c65 7474 655f 6461 7461 2720 696e palette_data' in │ │ │ │ │ -0000c220: 6465 7820 7769 6c6c 2062 650a 2020 2020 dex will be. │ │ │ │ │ -0000c230: 2069 6e63 7265 6d65 6e74 6564 2075 6e74 incremented unt │ │ │ │ │ -0000c240: 696c 2027 636f 756e 7427 206e 756d 6265 il 'count' numbe │ │ │ │ │ -0000c250: 7220 6f66 2063 6f6c 6f72 7320 6861 7665 r of colors have │ │ │ │ │ -0000c260: 2062 6565 6e20 7365 742e 0a0a 3130 2e31 been set...10.1 │ │ │ │ │ -0000c270: 2e36 2067 7275 625f 7669 6465 6f5f 6765 .6 grub_video_ge │ │ │ │ │ -0000c280: 745f 7061 6c65 7474 650a 2d2d 2d2d 2d2d t_palette.------ │ │ │ │ │ +0000be50: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ │ +0000be60: 5072 6f74 6f74 7970 653a 0a0a 2020 2020 Prototype:.. │ │ │ │ │ +0000be70: 2020 2020 2020 6772 7562 5f65 7272 5f74 grub_err_t │ │ │ │ │ +0000be80: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +0000be90: 7669 6465 6f5f 7365 745f 7061 6c65 7474 video_set_palett │ │ │ │ │ +0000bea0: 6520 2875 6e73 6967 6e65 6420 696e 7420 e (unsigned int │ │ │ │ │ +0000beb0: 7374 6172 742c 2075 6e73 6967 6e65 6420 start, unsigned │ │ │ │ │ +0000bec0: 696e 7420 636f 756e 742c 2073 7472 7563 int count, struc │ │ │ │ │ +0000bed0: 7420 6772 7562 5f76 6964 656f 5f70 616c t grub_video_pal │ │ │ │ │ +0000bee0: 6574 7465 5f64 6174 6120 2a70 616c 6574 ette_data *palet │ │ │ │ │ +0000bef0: 7465 5f64 6174 6129 3b0a 2020 2020 2020 te_data);. │ │ │ │ │ +0000bf00: 2020 2020 7374 7275 6374 2067 7275 625f struct grub_ │ │ │ │ │ +0000bf10: 7669 6465 6f5f 7061 6c65 7474 655f 6461 video_palette_da │ │ │ │ │ +0000bf20: 7461 0a20 2020 2020 2020 2020 207b 0a20 ta. {. │ │ │ │ │ +0000bf30: 2020 2020 2020 2020 2020 2020 2067 7275 gru │ │ │ │ │ +0000bf40: 625f 7569 6e74 385f 7420 723b 202f 2a20 b_uint8_t r; /* │ │ │ │ │ +0000bf50: 5265 6420 636f 6c6f 7220 7661 6c75 6520 Red color value │ │ │ │ │ +0000bf60: 2830 2d32 3535 292e 202a 2f0a 2020 2020 (0-255). */. │ │ │ │ │ +0000bf70: 2020 2020 2020 2020 2020 6772 7562 5f75 grub_u │ │ │ │ │ +0000bf80: 696e 7438 5f74 2067 3b20 2f2a 2047 7265 int8_t g; /* Gre │ │ │ │ │ +0000bf90: 656e 2063 6f6c 6f72 2076 616c 7565 2028 en color value ( │ │ │ │ │ +0000bfa0: 302d 3235 3529 2e20 2a2f 0a20 2020 2020 0-255). */. │ │ │ │ │ +0000bfb0: 2020 2020 2020 2020 2067 7275 625f 7569 grub_ui │ │ │ │ │ +0000bfc0: 6e74 385f 7420 623b 202f 2a20 426c 7565 nt8_t b; /* Blue │ │ │ │ │ +0000bfd0: 2063 6f6c 6f72 2076 616c 7565 2028 302d color value (0- │ │ │ │ │ +0000bfe0: 3235 3529 2e20 2a2f 0a20 2020 2020 2020 255). */. │ │ │ │ │ +0000bff0: 2020 2020 2020 2067 7275 625f 7569 6e74 grub_uint │ │ │ │ │ +0000c000: 385f 7420 613b 202f 2a20 5265 7365 7276 8_t a; /* Reserv │ │ │ │ │ +0000c010: 6564 2062 6974 7320 7661 6c75 6520 2830 ed bits value (0 │ │ │ │ │ +0000c020: 2d32 3535 292e 202a 2f0a 2020 2020 2020 -255). */. │ │ │ │ │ +0000c030: 2020 2020 7d3b 0a20 2020 2a20 4465 7363 };. * Desc │ │ │ │ │ +0000c040: 7269 7074 696f 6e3a 0a0a 2020 2020 2055 ription:.. U │ │ │ │ │ +0000c050: 7365 6420 746f 2073 6574 7570 2069 6e64 sed to setup ind │ │ │ │ │ +0000c060: 6578 6564 2063 6f6c 6f72 2070 616c 6574 exed color palet │ │ │ │ │ +0000c070: 7465 732e 2020 4966 206d 6f64 6520 6973 tes. If mode is │ │ │ │ │ +0000c080: 2052 4742 206d 6f64 652c 2063 6f6c 6f72 RGB mode, color │ │ │ │ │ +0000c090: 730a 2020 2020 2077 696c 6c20 6265 2073 s. will be s │ │ │ │ │ +0000c0a0: 6574 2074 6f20 656d 756c 6174 6564 2070 et to emulated p │ │ │ │ │ +0000c0b0: 616c 6574 7465 2064 6174 612e 2020 496e alette data. In │ │ │ │ │ +0000c0c0: 2049 6e64 6578 6564 2043 6f6c 6f72 206d Indexed Color m │ │ │ │ │ +0000c0d0: 6f64 6573 2c0a 2020 2020 2070 616c 6574 odes,. palet │ │ │ │ │ +0000c0e0: 7465 7320 7769 6c6c 2062 6520 7365 7420 tes will be set │ │ │ │ │ +0000c0f0: 746f 2068 6172 6477 6172 652e 2020 436f to hardware. Co │ │ │ │ │ +0000c100: 6c6f 7220 7661 6c75 6573 2077 696c 6c20 lor values will │ │ │ │ │ +0000c110: 6265 2063 6f6e 7665 7274 6564 0a20 2020 be converted. │ │ │ │ │ +0000c120: 2020 746f 2073 7569 7420 7265 7175 6972 to suit requir │ │ │ │ │ +0000c130: 656d 656e 7473 206f 6620 7468 6520 7669 ements of the vi │ │ │ │ │ +0000c140: 6465 6f20 6d6f 6465 2e20 2027 7374 6172 deo mode. 'star │ │ │ │ │ +0000c150: 7427 2077 696c 6c20 7465 6c6c 2077 6861 t' will tell wha │ │ │ │ │ +0000c160: 740a 2020 2020 2068 6172 6477 6172 6520 t. hardware │ │ │ │ │ +0000c170: 636f 6c6f 7220 696e 6465 7820 286f 7220 color index (or │ │ │ │ │ +0000c180: 656d 756c 6174 6564 2063 6f6c 6f72 2069 emulated color i │ │ │ │ │ +0000c190: 6e64 6578 2920 7769 6c6c 2062 6520 7365 ndex) will be se │ │ │ │ │ +0000c1a0: 7420 746f 0a20 2020 2020 6163 636f 7264 t to. accord │ │ │ │ │ +0000c1b0: 696e 6720 696e 666f 726d 6174 696f 6e20 ing information │ │ │ │ │ +0000c1c0: 696e 2066 6972 7374 2069 6e64 6963 6520 in first indice │ │ │ │ │ +0000c1d0: 6f66 2027 7061 6c65 7474 655f 6461 7461 of 'palette_data │ │ │ │ │ +0000c1e0: 272c 2061 6674 6572 2074 6861 740a 2020 ', after that. │ │ │ │ │ +0000c1f0: 2020 2062 6f74 6820 6861 7264 7761 7265 both hardware │ │ │ │ │ +0000c200: 2063 6f6c 6f72 2069 6e64 6578 2061 6e64 color index and │ │ │ │ │ +0000c210: 2027 7061 6c65 7474 655f 6461 7461 2720 'palette_data' │ │ │ │ │ +0000c220: 696e 6465 7820 7769 6c6c 2062 650a 2020 index will be. │ │ │ │ │ +0000c230: 2020 2069 6e63 7265 6d65 6e74 6564 2075 incremented u │ │ │ │ │ +0000c240: 6e74 696c 2027 636f 756e 7427 206e 756d ntil 'count' num │ │ │ │ │ +0000c250: 6265 7220 6f66 2063 6f6c 6f72 7320 6861 ber of colors ha │ │ │ │ │ +0000c260: 7665 2062 6565 6e20 7365 742e 0a0a 3130 ve been set...10 │ │ │ │ │ +0000c270: 2e31 2e36 2067 7275 625f 7669 6465 6f5f .1.6 grub_video_ │ │ │ │ │ +0000c280: 6765 745f 7061 6c65 7474 650a 2d2d 2d2d get_palette.---- │ │ │ │ │ 0000c290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000c2a0: 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 -------.. * Pr │ │ │ │ │ -0000c2b0: 6f74 6f74 7970 653a 0a0a 2020 2020 2020 ototype:.. │ │ │ │ │ -0000c2c0: 2020 2020 6772 7562 5f65 7272 5f74 0a20 grub_err_t. │ │ │ │ │ -0000c2d0: 2020 2020 2020 2020 2067 7275 625f 7669 grub_vi │ │ │ │ │ -0000c2e0: 6465 6f5f 6765 745f 7061 6c65 7474 6520 deo_get_palette │ │ │ │ │ -0000c2f0: 2875 6e73 6967 6e65 6420 696e 7420 7374 (unsigned int st │ │ │ │ │ -0000c300: 6172 742c 2075 6e73 6967 6e65 6420 696e art, unsigned in │ │ │ │ │ -0000c310: 7420 636f 756e 742c 2073 7472 7563 7420 t count, struct │ │ │ │ │ -0000c320: 6772 7562 5f76 6964 656f 5f70 616c 6574 grub_video_palet │ │ │ │ │ -0000c330: 7465 5f64 6174 6120 2a70 616c 6574 7465 te_data *palette │ │ │ │ │ -0000c340: 5f64 6174 6129 3b0a 2020 2020 2020 2020 _data);. │ │ │ │ │ -0000c350: 2020 7374 7275 6374 2067 7275 625f 7669 struct grub_vi │ │ │ │ │ -0000c360: 6465 6f5f 7061 6c65 7474 655f 6461 7461 deo_palette_data │ │ │ │ │ -0000c370: 0a20 2020 2020 2020 2020 207b 0a20 2020 . {. │ │ │ │ │ -0000c380: 2020 2020 2020 2020 2020 2067 7275 625f grub_ │ │ │ │ │ -0000c390: 7569 6e74 385f 7420 723b 202f 2a20 5265 uint8_t r; /* Re │ │ │ │ │ -0000c3a0: 6420 636f 6c6f 7220 7661 6c75 6520 2830 d color value (0 │ │ │ │ │ -0000c3b0: 2d32 3535 292e 202a 2f0a 2020 2020 2020 -255). */. │ │ │ │ │ -0000c3c0: 2020 2020 2020 2020 6772 7562 5f75 696e grub_uin │ │ │ │ │ -0000c3d0: 7438 5f74 2067 3b20 2f2a 2047 7265 656e t8_t g; /* Green │ │ │ │ │ -0000c3e0: 2063 6f6c 6f72 2076 616c 7565 2028 302d color value (0- │ │ │ │ │ -0000c3f0: 3235 3529 2e20 2a2f 0a20 2020 2020 2020 255). */. │ │ │ │ │ -0000c400: 2020 2020 2020 2067 7275 625f 7569 6e74 grub_uint │ │ │ │ │ -0000c410: 385f 7420 623b 202f 2a20 426c 7565 2063 8_t b; /* Blue c │ │ │ │ │ -0000c420: 6f6c 6f72 2076 616c 7565 2028 302d 3235 olor value (0-25 │ │ │ │ │ -0000c430: 3529 2e20 2a2f 0a20 2020 2020 2020 2020 5). */. │ │ │ │ │ -0000c440: 2020 2020 2067 7275 625f 7569 6e74 385f grub_uint8_ │ │ │ │ │ -0000c450: 7420 613b 202f 2a20 5265 7365 7276 6564 t a; /* Reserved │ │ │ │ │ -0000c460: 2062 6974 7320 7661 6c75 6520 2830 2d32 bits value (0-2 │ │ │ │ │ -0000c470: 3535 292e 202a 2f0a 2020 2020 2020 2020 55). */. │ │ │ │ │ -0000c480: 2020 7d3b 0a20 2020 2a20 4465 7363 7269 };. * Descri │ │ │ │ │ -0000c490: 7074 696f 6e3a 0a0a 2020 2020 2055 7365 ption:.. Use │ │ │ │ │ -0000c4a0: 6420 746f 2071 7565 7279 2069 6e64 6578 d to query index │ │ │ │ │ -0000c4b0: 6564 2063 6f6c 6f72 2070 616c 6574 7465 ed color palette │ │ │ │ │ -0000c4c0: 732e 2020 4966 206d 6f64 6520 6973 2052 s. If mode is R │ │ │ │ │ -0000c4d0: 4742 206d 6f64 652c 2063 6f6c 6f72 730a GB mode, colors. │ │ │ │ │ -0000c4e0: 2020 2020 2077 696c 6c20 6265 2063 6f70 will be cop │ │ │ │ │ -0000c4f0: 6965 6420 6672 6f6d 2065 6d75 6c61 7465 ied from emulate │ │ │ │ │ -0000c500: 6420 7061 6c65 7474 6520 6461 7461 2e20 d palette data. │ │ │ │ │ -0000c510: 2049 6e20 496e 6465 7865 6420 436f 6c6f In Indexed Colo │ │ │ │ │ -0000c520: 7220 6d6f 6465 732c 0a20 2020 2020 7061 r modes,. pa │ │ │ │ │ -0000c530: 6c65 7474 6573 2077 696c 6c20 6265 2072 lettes will be r │ │ │ │ │ -0000c540: 6561 6420 6672 6f6d 2068 6172 6477 6172 ead from hardwar │ │ │ │ │ -0000c550: 652e 2020 436f 6c6f 7220 7661 6c75 6573 e. Color values │ │ │ │ │ -0000c560: 2077 696c 6c20 6265 0a20 2020 2020 636f will be. co │ │ │ │ │ -0000c570: 6e76 6572 7465 6420 746f 2073 7569 7420 nverted to suit │ │ │ │ │ -0000c580: 7374 7275 6374 7572 6520 666f 726d 6174 structure format │ │ │ │ │ -0000c590: 2e20 2027 7374 6172 7427 2077 696c 6c20 . 'start' will │ │ │ │ │ -0000c5a0: 7465 6c6c 2077 6861 740a 2020 2020 2068 tell what. h │ │ │ │ │ -0000c5b0: 6172 6477 6172 6520 636f 6c6f 7220 696e ardware color in │ │ │ │ │ -0000c5c0: 6465 7820 286f 7220 656d 756c 6174 6564 dex (or emulated │ │ │ │ │ -0000c5d0: 2063 6f6c 6f72 2069 6e64 6578 2920 7769 color index) wi │ │ │ │ │ -0000c5e0: 6c6c 2062 6520 7573 6564 2061 7320 610a ll be used as a. │ │ │ │ │ -0000c5f0: 2020 2020 2073 6f75 7263 6520 666f 7220 source for │ │ │ │ │ -0000c600: 6669 7273 7420 696e 6469 6365 206f 6620 first indice of │ │ │ │ │ -0000c610: 2770 616c 6574 7465 5f64 6174 6127 2c20 'palette_data', │ │ │ │ │ -0000c620: 6166 7465 7220 7468 6174 2062 6f74 6820 after that both │ │ │ │ │ -0000c630: 6861 7264 7761 7265 0a20 2020 2020 636f hardware. co │ │ │ │ │ -0000c640: 6c6f 7220 696e 6465 7820 616e 6420 2770 lor index and 'p │ │ │ │ │ -0000c650: 616c 6574 7465 5f64 6174 6127 2069 6e64 alette_data' ind │ │ │ │ │ -0000c660: 6578 2077 696c 6c20 6265 2069 6e63 7265 ex will be incre │ │ │ │ │ -0000c670: 6d65 6e74 6564 2075 6e74 696c 0a20 2020 mented until. │ │ │ │ │ -0000c680: 2020 2763 6f75 6e74 2720 6e75 6d62 6572 'count' number │ │ │ │ │ -0000c690: 206f 6620 636f 6c6f 7273 2068 6176 6520 of colors have │ │ │ │ │ -0000c6a0: 6265 656e 2072 6561 642e 0a0a 3130 2e31 been read...10.1 │ │ │ │ │ -0000c6b0: 2e37 2067 7275 625f 7669 6465 6f5f 7365 .7 grub_video_se │ │ │ │ │ -0000c6c0: 745f 6172 6561 5f73 7461 7475 730a 2d2d t_area_status.-- │ │ │ │ │ +0000c2a0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ │ +0000c2b0: 5072 6f74 6f74 7970 653a 0a0a 2020 2020 Prototype:.. │ │ │ │ │ +0000c2c0: 2020 2020 2020 6772 7562 5f65 7272 5f74 grub_err_t │ │ │ │ │ +0000c2d0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +0000c2e0: 7669 6465 6f5f 6765 745f 7061 6c65 7474 video_get_palett │ │ │ │ │ +0000c2f0: 6520 2875 6e73 6967 6e65 6420 696e 7420 e (unsigned int │ │ │ │ │ +0000c300: 7374 6172 742c 2075 6e73 6967 6e65 6420 start, unsigned │ │ │ │ │ +0000c310: 696e 7420 636f 756e 742c 2073 7472 7563 int count, struc │ │ │ │ │ +0000c320: 7420 6772 7562 5f76 6964 656f 5f70 616c t grub_video_pal │ │ │ │ │ +0000c330: 6574 7465 5f64 6174 6120 2a70 616c 6574 ette_data *palet │ │ │ │ │ +0000c340: 7465 5f64 6174 6129 3b0a 2020 2020 2020 te_data);. │ │ │ │ │ +0000c350: 2020 2020 7374 7275 6374 2067 7275 625f struct grub_ │ │ │ │ │ +0000c360: 7669 6465 6f5f 7061 6c65 7474 655f 6461 video_palette_da │ │ │ │ │ +0000c370: 7461 0a20 2020 2020 2020 2020 207b 0a20 ta. {. │ │ │ │ │ +0000c380: 2020 2020 2020 2020 2020 2020 2067 7275 gru │ │ │ │ │ +0000c390: 625f 7569 6e74 385f 7420 723b 202f 2a20 b_uint8_t r; /* │ │ │ │ │ +0000c3a0: 5265 6420 636f 6c6f 7220 7661 6c75 6520 Red color value │ │ │ │ │ +0000c3b0: 2830 2d32 3535 292e 202a 2f0a 2020 2020 (0-255). */. │ │ │ │ │ +0000c3c0: 2020 2020 2020 2020 2020 6772 7562 5f75 grub_u │ │ │ │ │ +0000c3d0: 696e 7438 5f74 2067 3b20 2f2a 2047 7265 int8_t g; /* Gre │ │ │ │ │ +0000c3e0: 656e 2063 6f6c 6f72 2076 616c 7565 2028 en color value ( │ │ │ │ │ +0000c3f0: 302d 3235 3529 2e20 2a2f 0a20 2020 2020 0-255). */. │ │ │ │ │ +0000c400: 2020 2020 2020 2020 2067 7275 625f 7569 grub_ui │ │ │ │ │ +0000c410: 6e74 385f 7420 623b 202f 2a20 426c 7565 nt8_t b; /* Blue │ │ │ │ │ +0000c420: 2063 6f6c 6f72 2076 616c 7565 2028 302d color value (0- │ │ │ │ │ +0000c430: 3235 3529 2e20 2a2f 0a20 2020 2020 2020 255). */. │ │ │ │ │ +0000c440: 2020 2020 2020 2067 7275 625f 7569 6e74 grub_uint │ │ │ │ │ +0000c450: 385f 7420 613b 202f 2a20 5265 7365 7276 8_t a; /* Reserv │ │ │ │ │ +0000c460: 6564 2062 6974 7320 7661 6c75 6520 2830 ed bits value (0 │ │ │ │ │ +0000c470: 2d32 3535 292e 202a 2f0a 2020 2020 2020 -255). */. │ │ │ │ │ +0000c480: 2020 2020 7d3b 0a20 2020 2a20 4465 7363 };. * Desc │ │ │ │ │ +0000c490: 7269 7074 696f 6e3a 0a0a 2020 2020 2055 ription:.. U │ │ │ │ │ +0000c4a0: 7365 6420 746f 2071 7565 7279 2069 6e64 sed to query ind │ │ │ │ │ +0000c4b0: 6578 6564 2063 6f6c 6f72 2070 616c 6574 exed color palet │ │ │ │ │ +0000c4c0: 7465 732e 2020 4966 206d 6f64 6520 6973 tes. If mode is │ │ │ │ │ +0000c4d0: 2052 4742 206d 6f64 652c 2063 6f6c 6f72 RGB mode, color │ │ │ │ │ +0000c4e0: 730a 2020 2020 2077 696c 6c20 6265 2063 s. will be c │ │ │ │ │ +0000c4f0: 6f70 6965 6420 6672 6f6d 2065 6d75 6c61 opied from emula │ │ │ │ │ +0000c500: 7465 6420 7061 6c65 7474 6520 6461 7461 ted palette data │ │ │ │ │ +0000c510: 2e20 2049 6e20 496e 6465 7865 6420 436f . In Indexed Co │ │ │ │ │ +0000c520: 6c6f 7220 6d6f 6465 732c 0a20 2020 2020 lor modes,. │ │ │ │ │ +0000c530: 7061 6c65 7474 6573 2077 696c 6c20 6265 palettes will be │ │ │ │ │ +0000c540: 2072 6561 6420 6672 6f6d 2068 6172 6477 read from hardw │ │ │ │ │ +0000c550: 6172 652e 2020 436f 6c6f 7220 7661 6c75 are. Color valu │ │ │ │ │ +0000c560: 6573 2077 696c 6c20 6265 0a20 2020 2020 es will be. │ │ │ │ │ +0000c570: 636f 6e76 6572 7465 6420 746f 2073 7569 converted to sui │ │ │ │ │ +0000c580: 7420 7374 7275 6374 7572 6520 666f 726d t structure form │ │ │ │ │ +0000c590: 6174 2e20 2027 7374 6172 7427 2077 696c at. 'start' wil │ │ │ │ │ +0000c5a0: 6c20 7465 6c6c 2077 6861 740a 2020 2020 l tell what. │ │ │ │ │ +0000c5b0: 2068 6172 6477 6172 6520 636f 6c6f 7220 hardware color │ │ │ │ │ +0000c5c0: 696e 6465 7820 286f 7220 656d 756c 6174 index (or emulat │ │ │ │ │ +0000c5d0: 6564 2063 6f6c 6f72 2069 6e64 6578 2920 ed color index) │ │ │ │ │ +0000c5e0: 7769 6c6c 2062 6520 7573 6564 2061 7320 will be used as │ │ │ │ │ +0000c5f0: 610a 2020 2020 2073 6f75 7263 6520 666f a. source fo │ │ │ │ │ +0000c600: 7220 6669 7273 7420 696e 6469 6365 206f r first indice o │ │ │ │ │ +0000c610: 6620 2770 616c 6574 7465 5f64 6174 6127 f 'palette_data' │ │ │ │ │ +0000c620: 2c20 6166 7465 7220 7468 6174 2062 6f74 , after that bot │ │ │ │ │ +0000c630: 6820 6861 7264 7761 7265 0a20 2020 2020 h hardware. │ │ │ │ │ +0000c640: 636f 6c6f 7220 696e 6465 7820 616e 6420 color index and │ │ │ │ │ +0000c650: 2770 616c 6574 7465 5f64 6174 6127 2069 'palette_data' i │ │ │ │ │ +0000c660: 6e64 6578 2077 696c 6c20 6265 2069 6e63 ndex will be inc │ │ │ │ │ +0000c670: 7265 6d65 6e74 6564 2075 6e74 696c 0a20 remented until. │ │ │ │ │ +0000c680: 2020 2020 2763 6f75 6e74 2720 6e75 6d62 'count' numb │ │ │ │ │ +0000c690: 6572 206f 6620 636f 6c6f 7273 2068 6176 er of colors hav │ │ │ │ │ +0000c6a0: 6520 6265 656e 2072 6561 642e 0a0a 3130 e been read...10 │ │ │ │ │ +0000c6b0: 2e31 2e37 2067 7275 625f 7669 6465 6f5f .1.7 grub_video_ │ │ │ │ │ +0000c6c0: 7365 745f 6172 6561 5f73 7461 7475 730a set_area_status. │ │ │ │ │ 0000c6d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000c6e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -0000c6f0: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ │ -0000c700: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ -0000c710: 6572 725f 740a 2020 2020 2020 2020 2020 err_t. │ │ │ │ │ -0000c720: 6772 7562 5f76 6964 656f 5f73 6574 5f61 grub_video_set_a │ │ │ │ │ -0000c730: 7265 615f 7374 6174 7573 2028 6772 7562 rea_status (grub │ │ │ │ │ -0000c740: 5f76 6964 656f 5f61 7265 615f 7374 6174 _video_area_stat │ │ │ │ │ -0000c750: 7573 5f74 2061 7265 615f 7374 6174 7573 us_t area_status │ │ │ │ │ -0000c760: 293b 0a20 2020 2020 2020 2020 2065 6e75 );. enu │ │ │ │ │ -0000c770: 6d20 6772 7562 5f76 6964 656f 5f61 7265 m grub_video_are │ │ │ │ │ -0000c780: 615f 7374 6174 7573 5f74 0a20 2020 2020 a_status_t. │ │ │ │ │ -0000c790: 2020 2020 2020 207b 0a20 2020 2020 2020 {. │ │ │ │ │ -0000c7a0: 2020 2020 2020 2047 5255 425f 5649 4445 GRUB_VIDE │ │ │ │ │ -0000c7b0: 4f5f 4152 4541 5f44 4953 4142 4c45 442c O_AREA_DISABLED, │ │ │ │ │ -0000c7c0: 0a20 2020 2020 2020 2020 2020 2020 2047 . G │ │ │ │ │ -0000c7d0: 5255 425f 5649 4445 4f5f 4152 4541 5f45 RUB_VIDEO_AREA_E │ │ │ │ │ -0000c7e0: 4e41 424c 4544 0a20 2020 2020 2020 2020 NABLED. │ │ │ │ │ -0000c7f0: 2020 207d 3b0a 0a20 2020 2a20 4465 7363 };.. * Desc │ │ │ │ │ -0000c800: 7269 7074 696f 6e3a 0a0a 2020 2020 2055 ription:.. U │ │ │ │ │ -0000c810: 7365 6420 746f 2073 6574 2061 7265 6120 sed to set area │ │ │ │ │ -0000c820: 6472 6177 696e 6720 6d6f 6465 2066 6f72 drawing mode for │ │ │ │ │ -0000c830: 2072 6564 7261 7769 6e67 2074 6865 2073 redrawing the s │ │ │ │ │ -0000c840: 7065 6369 6669 6564 2072 6567 696f 6e2e pecified region. │ │ │ │ │ -0000c850: 0a20 2020 2020 4472 6177 2063 6f6d 6d61 . Draw comma │ │ │ │ │ -0000c860: 6e64 7320 6172 6520 7065 7266 6f72 6d65 nds are performe │ │ │ │ │ -0000c870: 6420 696e 2074 6865 2069 6e74 6572 7365 d in the interse │ │ │ │ │ -0000c880: 6374 696f 6e20 6f66 2074 6865 2076 6965 ction of the vie │ │ │ │ │ -0000c890: 7770 6f72 7420 616e 640a 2020 2020 2074 wport and. t │ │ │ │ │ -0000c8a0: 6865 2072 6567 696f 6e20 6361 6c6c 6564 he region called │ │ │ │ │ -0000c8b0: 2061 7265 612e 2020 436f 6f72 6469 6e61 area. Coordina │ │ │ │ │ -0000c8c0: 7465 7320 7265 6d61 696e 2072 656c 6174 tes remain relat │ │ │ │ │ -0000c8d0: 6564 2074 6f20 7468 650a 2020 2020 2076 ed to the. v │ │ │ │ │ -0000c8e0: 6965 7770 6f72 742e 2020 4966 2064 7261 iewport. If dra │ │ │ │ │ -0000c8f0: 7720 636f 6d6d 616e 6473 2074 7279 2074 w commands try t │ │ │ │ │ -0000c900: 6f20 6472 6177 206f 7665 7220 7468 6520 o draw over the │ │ │ │ │ -0000c910: 6172 6561 2c20 7468 6579 2061 7265 0a20 area, they are. │ │ │ │ │ -0000c920: 2020 2020 636c 6970 7065 642e 2020 5365 clipped. Se │ │ │ │ │ -0000c930: 7420 7374 6174 7573 2074 6f20 4449 5341 t status to DISA │ │ │ │ │ -0000c940: 424c 4544 2069 6620 796f 7520 6e65 6564 BLED if you need │ │ │ │ │ -0000c950: 2074 6f20 6472 6177 2065 7665 7279 7468 to draw everyth │ │ │ │ │ -0000c960: 696e 672e 0a20 2020 2020 5365 7420 7374 ing.. Set st │ │ │ │ │ -0000c970: 6174 7573 2074 6f20 454e 4142 4c45 4420 atus to ENABLED │ │ │ │ │ -0000c980: 616e 6420 7265 6769 6f6e 2074 6f20 7468 and region to th │ │ │ │ │ -0000c990: 6520 6465 7369 7265 6420 7265 6374 616e e desired rectan │ │ │ │ │ -0000c9a0: 676c 6520 746f 2072 6564 7261 770a 2020 gle to redraw. │ │ │ │ │ -0000c9b0: 2020 2065 7665 7279 7468 696e 6720 696e everything in │ │ │ │ │ -0000c9c0: 7369 6465 2074 6865 2072 6567 696f 6e20 side the region │ │ │ │ │ -0000c9d0: 6c65 6176 696e 6720 6576 6572 7974 6869 leaving everythi │ │ │ │ │ -0000c9e0: 6e67 2065 6c73 6520 696e 7461 6374 2e0a ng else intact.. │ │ │ │ │ -0000c9f0: 2020 2020 2053 686f 756c 6420 6265 2075 Should be u │ │ │ │ │ -0000ca00: 7365 6420 666f 7220 7265 6472 6177 696e sed for redrawin │ │ │ │ │ -0000ca10: 6720 6f66 2061 6374 6976 6520 656c 656d g of active elem │ │ │ │ │ -0000ca20: 656e 7473 2e0a 0a31 302e 312e 3820 6772 ents...10.1.8 gr │ │ │ │ │ -0000ca30: 7562 5f76 6964 656f 5f67 6574 5f61 7265 ub_video_get_are │ │ │ │ │ -0000ca40: 615f 7374 6174 7573 0a2d 2d2d 2d2d 2d2d a_status.------- │ │ │ │ │ +0000c6e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0000c6f0: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ +0000c700: 653a 0a20 2020 2020 2020 2020 2067 7275 e:. gru │ │ │ │ │ +0000c710: 625f 6572 725f 740a 2020 2020 2020 2020 b_err_t. │ │ │ │ │ +0000c720: 2020 6772 7562 5f76 6964 656f 5f73 6574 grub_video_set │ │ │ │ │ +0000c730: 5f61 7265 615f 7374 6174 7573 2028 6772 _area_status (gr │ │ │ │ │ +0000c740: 7562 5f76 6964 656f 5f61 7265 615f 7374 ub_video_area_st │ │ │ │ │ +0000c750: 6174 7573 5f74 2061 7265 615f 7374 6174 atus_t area_stat │ │ │ │ │ +0000c760: 7573 293b 0a20 2020 2020 2020 2020 2065 us);. e │ │ │ │ │ +0000c770: 6e75 6d20 6772 7562 5f76 6964 656f 5f61 num grub_video_a │ │ │ │ │ +0000c780: 7265 615f 7374 6174 7573 5f74 0a20 2020 rea_status_t. │ │ │ │ │ +0000c790: 2020 2020 2020 2020 207b 0a20 2020 2020 {. │ │ │ │ │ +0000c7a0: 2020 2020 2020 2020 2047 5255 425f 5649 GRUB_VI │ │ │ │ │ +0000c7b0: 4445 4f5f 4152 4541 5f44 4953 4142 4c45 DEO_AREA_DISABLE │ │ │ │ │ +0000c7c0: 442c 0a20 2020 2020 2020 2020 2020 2020 D,. │ │ │ │ │ +0000c7d0: 2047 5255 425f 5649 4445 4f5f 4152 4541 GRUB_VIDEO_AREA │ │ │ │ │ +0000c7e0: 5f45 4e41 424c 4544 0a20 2020 2020 2020 _ENABLED. │ │ │ │ │ +0000c7f0: 2020 2020 207d 3b0a 0a20 2020 2a20 4465 };.. * De │ │ │ │ │ +0000c800: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ +0000c810: 2055 7365 6420 746f 2073 6574 2061 7265 Used to set are │ │ │ │ │ +0000c820: 6120 6472 6177 696e 6720 6d6f 6465 2066 a drawing mode f │ │ │ │ │ +0000c830: 6f72 2072 6564 7261 7769 6e67 2074 6865 or redrawing the │ │ │ │ │ +0000c840: 2073 7065 6369 6669 6564 2072 6567 696f specified regio │ │ │ │ │ +0000c850: 6e2e 0a20 2020 2020 4472 6177 2063 6f6d n.. Draw com │ │ │ │ │ +0000c860: 6d61 6e64 7320 6172 6520 7065 7266 6f72 mands are perfor │ │ │ │ │ +0000c870: 6d65 6420 696e 2074 6865 2069 6e74 6572 med in the inter │ │ │ │ │ +0000c880: 7365 6374 696f 6e20 6f66 2074 6865 2076 section of the v │ │ │ │ │ +0000c890: 6965 7770 6f72 7420 616e 640a 2020 2020 iewport and. │ │ │ │ │ +0000c8a0: 2074 6865 2072 6567 696f 6e20 6361 6c6c the region call │ │ │ │ │ +0000c8b0: 6564 2061 7265 612e 2020 436f 6f72 6469 ed area. Coordi │ │ │ │ │ +0000c8c0: 6e61 7465 7320 7265 6d61 696e 2072 656c nates remain rel │ │ │ │ │ +0000c8d0: 6174 6564 2074 6f20 7468 650a 2020 2020 ated to the. │ │ │ │ │ +0000c8e0: 2076 6965 7770 6f72 742e 2020 4966 2064 viewport. If d │ │ │ │ │ +0000c8f0: 7261 7720 636f 6d6d 616e 6473 2074 7279 raw commands try │ │ │ │ │ +0000c900: 2074 6f20 6472 6177 206f 7665 7220 7468 to draw over th │ │ │ │ │ +0000c910: 6520 6172 6561 2c20 7468 6579 2061 7265 e area, they are │ │ │ │ │ +0000c920: 0a20 2020 2020 636c 6970 7065 642e 2020 . clipped. │ │ │ │ │ +0000c930: 5365 7420 7374 6174 7573 2074 6f20 4449 Set status to DI │ │ │ │ │ +0000c940: 5341 424c 4544 2069 6620 796f 7520 6e65 SABLED if you ne │ │ │ │ │ +0000c950: 6564 2074 6f20 6472 6177 2065 7665 7279 ed to draw every │ │ │ │ │ +0000c960: 7468 696e 672e 0a20 2020 2020 5365 7420 thing.. Set │ │ │ │ │ +0000c970: 7374 6174 7573 2074 6f20 454e 4142 4c45 status to ENABLE │ │ │ │ │ +0000c980: 4420 616e 6420 7265 6769 6f6e 2074 6f20 D and region to │ │ │ │ │ +0000c990: 7468 6520 6465 7369 7265 6420 7265 6374 the desired rect │ │ │ │ │ +0000c9a0: 616e 676c 6520 746f 2072 6564 7261 770a angle to redraw. │ │ │ │ │ +0000c9b0: 2020 2020 2065 7665 7279 7468 696e 6720 everything │ │ │ │ │ +0000c9c0: 696e 7369 6465 2074 6865 2072 6567 696f inside the regio │ │ │ │ │ +0000c9d0: 6e20 6c65 6176 696e 6720 6576 6572 7974 n leaving everyt │ │ │ │ │ +0000c9e0: 6869 6e67 2065 6c73 6520 696e 7461 6374 hing else intact │ │ │ │ │ +0000c9f0: 2e0a 2020 2020 2053 686f 756c 6420 6265 .. Should be │ │ │ │ │ +0000ca00: 2075 7365 6420 666f 7220 7265 6472 6177 used for redraw │ │ │ │ │ +0000ca10: 696e 6720 6f66 2061 6374 6976 6520 656c ing of active el │ │ │ │ │ +0000ca20: 656d 656e 7473 2e0a 0a31 302e 312e 3820 ements...10.1.8 │ │ │ │ │ +0000ca30: 6772 7562 5f76 6964 656f 5f67 6574 5f61 grub_video_get_a │ │ │ │ │ +0000ca40: 7265 615f 7374 6174 7573 0a2d 2d2d 2d2d rea_status.----- │ │ │ │ │ 0000ca50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000ca60: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ │ -0000ca70: 2050 726f 746f 7479 7065 3a0a 2020 2020 Prototype:. │ │ │ │ │ -0000ca80: 2020 2020 2020 6772 7562 5f65 7272 5f72 grub_err_r │ │ │ │ │ -0000ca90: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ -0000caa0: 7669 6465 6f5f 6765 745f 6172 6561 5f73 video_get_area_s │ │ │ │ │ -0000cab0: 7461 7475 7320 2867 7275 625f 7669 6465 tatus (grub_vide │ │ │ │ │ -0000cac0: 6f5f 6172 6561 5f73 7461 7475 735f 7420 o_area_status_t │ │ │ │ │ -0000cad0: 2a61 7265 615f 7374 6174 7573 293b 0a0a *area_status);.. │ │ │ │ │ -0000cae0: 2020 202a 2044 6573 6372 6970 7469 6f6e * Description │ │ │ │ │ -0000caf0: 3a20 5573 6564 2074 6f20 7175 6572 7920 : Used to query │ │ │ │ │ -0000cb00: 7468 6520 6172 6561 2073 7461 7475 732e the area status. │ │ │ │ │ -0000cb10: 0a0a 3130 2e31 2e39 2067 7275 625f 7669 ..10.1.9 grub_vi │ │ │ │ │ -0000cb20: 6465 6f5f 7365 745f 7669 6577 706f 7274 deo_set_viewport │ │ │ │ │ -0000cb30: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -0000cb40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -0000cb50: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ │ -0000cb60: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ │ -0000cb70: 5f65 7272 5f74 0a20 2020 2020 2020 2020 _err_t. │ │ │ │ │ -0000cb80: 2067 7275 625f 7669 6465 6f5f 7365 745f grub_video_set_ │ │ │ │ │ -0000cb90: 7669 6577 706f 7274 2028 756e 7369 676e viewport (unsign │ │ │ │ │ -0000cba0: 6564 2069 6e74 2078 2c20 756e 7369 676e ed int x, unsign │ │ │ │ │ -0000cbb0: 6564 2069 6e74 2079 2c20 756e 7369 676e ed int y, unsign │ │ │ │ │ -0000cbc0: 6564 2069 6e74 2077 6964 7468 2c20 756e ed int width, un │ │ │ │ │ -0000cbd0: 7369 676e 6564 2069 6e74 2068 6569 6768 signed int heigh │ │ │ │ │ -0000cbe0: 7429 3b0a 2020 202a 2044 6573 6372 6970 t);. * Descrip │ │ │ │ │ -0000cbf0: 7469 6f6e 3a0a 0a20 2020 2020 5573 6564 tion:.. Used │ │ │ │ │ -0000cc00: 2074 6f20 7370 6563 6966 7920 7669 6577 to specify view │ │ │ │ │ -0000cc10: 706f 7274 2077 6865 7265 2064 7261 7720 port where draw │ │ │ │ │ -0000cc20: 636f 6d6d 616e 6473 2061 7265 2070 6572 commands are per │ │ │ │ │ -0000cc30: 666f 726d 6564 2e20 2057 6865 6e0a 2020 formed. When. │ │ │ │ │ -0000cc40: 2020 2076 6965 7770 6f72 7420 6973 2073 viewport is s │ │ │ │ │ -0000cc50: 6574 2c20 616c 6c20 6472 6177 2063 6f6d et, all draw com │ │ │ │ │ -0000cc60: 6d61 6e64 7320 636f 6f72 6469 6e61 7465 mands coordinate │ │ │ │ │ -0000cc70: 7320 7265 6c61 7465 2074 6f20 7468 6f73 s relate to thos │ │ │ │ │ -0000cc80: 650a 2020 2020 2073 7065 6369 6669 6564 e. specified │ │ │ │ │ -0000cc90: 2062 7920 2778 2720 616e 6420 2779 272e by 'x' and 'y'. │ │ │ │ │ -0000cca0: 2020 4966 2064 7261 7720 636f 6d6d 616e If draw comman │ │ │ │ │ -0000ccb0: 6473 2074 7279 2074 6f20 6472 6177 206f ds try to draw o │ │ │ │ │ -0000ccc0: 7665 720a 2020 2020 2076 6965 7770 6f72 ver. viewpor │ │ │ │ │ -0000ccd0: 742c 2074 6865 7920 6172 6520 636c 6970 t, they are clip │ │ │ │ │ -0000cce0: 7065 642e 2020 4966 2064 6576 656c 6f70 ped. If develop │ │ │ │ │ -0000ccf0: 6572 2072 6571 7565 7374 7320 6c61 7267 er requests larg │ │ │ │ │ -0000cd00: 6572 2074 6861 6e0a 2020 2020 2070 6f73 er than. pos │ │ │ │ │ -0000cd10: 7369 626c 6520 7669 6577 706f 7274 2c20 sible viewport, │ │ │ │ │ -0000cd20: 7769 6474 6820 616e 6420 6865 6967 6874 width and height │ │ │ │ │ -0000cd30: 2077 696c 6c20 6265 2063 6c61 6d70 6564 will be clamped │ │ │ │ │ -0000cd40: 2074 6f20 6669 7420 7363 7265 656e 2e0a to fit screen.. │ │ │ │ │ -0000cd50: 2020 2020 2049 6620 2778 2720 616e 6420 If 'x' and │ │ │ │ │ -0000cd60: 2779 2720 6172 6520 6f75 7420 6f66 2062 'y' are out of b │ │ │ │ │ -0000cd70: 6f75 6e64 732c 2061 6c6c 2066 756e 6374 ounds, all funct │ │ │ │ │ -0000cd80: 696f 6e73 2064 7261 7769 6e67 2074 6f20 ions drawing to │ │ │ │ │ -0000cd90: 7363 7265 656e 0a20 2020 2020 7769 6c6c screen. will │ │ │ │ │ -0000cda0: 206e 6f74 2062 6520 6469 7370 6c61 7965 not be displaye │ │ │ │ │ -0000cdb0: 642e 2020 496e 206f 7264 6572 2074 6f20 d. In order to │ │ │ │ │ -0000cdc0: 6d61 7869 6d69 7a65 2076 6965 7770 6f72 maximize viewpor │ │ │ │ │ -0000cdd0: 742c 2075 7365 0a20 2020 2020 2767 7275 t, use. 'gru │ │ │ │ │ -0000cde0: 625f 7669 6465 6f5f 6765 745f 696e 666f b_video_get_info │ │ │ │ │ -0000cdf0: 2720 746f 2071 7565 7279 2061 6374 7561 ' to query actua │ │ │ │ │ -0000ce00: 6c20 7363 7265 656e 2064 696d 656e 7369 l screen dimensi │ │ │ │ │ -0000ce10: 6f6e 7320 616e 6420 7072 6f76 6964 650a ons and provide. │ │ │ │ │ -0000ce20: 2020 2020 2074 6861 7420 696e 666f 726d that inform │ │ │ │ │ -0000ce30: 6174 696f 6e20 746f 2074 6869 7320 6675 ation to this fu │ │ │ │ │ -0000ce40: 6e63 7469 6f6e 2e0a 0a31 302e 312e 3130 nction...10.1.10 │ │ │ │ │ -0000ce50: 2067 7275 625f 7669 6465 6f5f 6765 745f grub_video_get_ │ │ │ │ │ -0000ce60: 7669 6577 706f 7274 0a2d 2d2d 2d2d 2d2d viewport.------- │ │ │ │ │ +0000ca60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ +0000ca70: 202a 2050 726f 746f 7479 7065 3a0a 2020 * Prototype:. │ │ │ │ │ +0000ca80: 2020 2020 2020 2020 6772 7562 5f65 7272 grub_err │ │ │ │ │ +0000ca90: 5f72 0a20 2020 2020 2020 2020 2067 7275 _r. gru │ │ │ │ │ +0000caa0: 625f 7669 6465 6f5f 6765 745f 6172 6561 b_video_get_area │ │ │ │ │ +0000cab0: 5f73 7461 7475 7320 2867 7275 625f 7669 _status (grub_vi │ │ │ │ │ +0000cac0: 6465 6f5f 6172 6561 5f73 7461 7475 735f deo_area_status_ │ │ │ │ │ +0000cad0: 7420 2a61 7265 615f 7374 6174 7573 293b t *area_status); │ │ │ │ │ +0000cae0: 0a0a 2020 202a 2044 6573 6372 6970 7469 .. * Descripti │ │ │ │ │ +0000caf0: 6f6e 3a20 5573 6564 2074 6f20 7175 6572 on: Used to quer │ │ │ │ │ +0000cb00: 7920 7468 6520 6172 6561 2073 7461 7475 y the area statu │ │ │ │ │ +0000cb10: 732e 0a0a 3130 2e31 2e39 2067 7275 625f s...10.1.9 grub_ │ │ │ │ │ +0000cb20: 7669 6465 6f5f 7365 745f 7669 6577 706f video_set_viewpo │ │ │ │ │ +0000cb30: 7274 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d rt.------------- │ │ │ │ │ +0000cb40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0000cb50: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ +0000cb60: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ │ +0000cb70: 7562 5f65 7272 5f74 0a20 2020 2020 2020 ub_err_t. │ │ │ │ │ +0000cb80: 2020 2067 7275 625f 7669 6465 6f5f 7365 grub_video_se │ │ │ │ │ +0000cb90: 745f 7669 6577 706f 7274 2028 756e 7369 t_viewport (unsi │ │ │ │ │ +0000cba0: 676e 6564 2069 6e74 2078 2c20 756e 7369 gned int x, unsi │ │ │ │ │ +0000cbb0: 676e 6564 2069 6e74 2079 2c20 756e 7369 gned int y, unsi │ │ │ │ │ +0000cbc0: 676e 6564 2069 6e74 2077 6964 7468 2c20 gned int width, │ │ │ │ │ +0000cbd0: 756e 7369 676e 6564 2069 6e74 2068 6569 unsigned int hei │ │ │ │ │ +0000cbe0: 6768 7429 3b0a 2020 202a 2044 6573 6372 ght);. * Descr │ │ │ │ │ +0000cbf0: 6970 7469 6f6e 3a0a 0a20 2020 2020 5573 iption:.. Us │ │ │ │ │ +0000cc00: 6564 2074 6f20 7370 6563 6966 7920 7669 ed to specify vi │ │ │ │ │ +0000cc10: 6577 706f 7274 2077 6865 7265 2064 7261 ewport where dra │ │ │ │ │ +0000cc20: 7720 636f 6d6d 616e 6473 2061 7265 2070 w commands are p │ │ │ │ │ +0000cc30: 6572 666f 726d 6564 2e20 2057 6865 6e0a erformed. When. │ │ │ │ │ +0000cc40: 2020 2020 2076 6965 7770 6f72 7420 6973 viewport is │ │ │ │ │ +0000cc50: 2073 6574 2c20 616c 6c20 6472 6177 2063 set, all draw c │ │ │ │ │ +0000cc60: 6f6d 6d61 6e64 7320 636f 6f72 6469 6e61 ommands coordina │ │ │ │ │ +0000cc70: 7465 7320 7265 6c61 7465 2074 6f20 7468 tes relate to th │ │ │ │ │ +0000cc80: 6f73 650a 2020 2020 2073 7065 6369 6669 ose. specifi │ │ │ │ │ +0000cc90: 6564 2062 7920 2778 2720 616e 6420 2779 ed by 'x' and 'y │ │ │ │ │ +0000cca0: 272e 2020 4966 2064 7261 7720 636f 6d6d '. If draw comm │ │ │ │ │ +0000ccb0: 616e 6473 2074 7279 2074 6f20 6472 6177 ands try to draw │ │ │ │ │ +0000ccc0: 206f 7665 720a 2020 2020 2076 6965 7770 over. viewp │ │ │ │ │ +0000ccd0: 6f72 742c 2074 6865 7920 6172 6520 636c ort, they are cl │ │ │ │ │ +0000cce0: 6970 7065 642e 2020 4966 2064 6576 656c ipped. If devel │ │ │ │ │ +0000ccf0: 6f70 6572 2072 6571 7565 7374 7320 6c61 oper requests la │ │ │ │ │ +0000cd00: 7267 6572 2074 6861 6e0a 2020 2020 2070 rger than. p │ │ │ │ │ +0000cd10: 6f73 7369 626c 6520 7669 6577 706f 7274 ossible viewport │ │ │ │ │ +0000cd20: 2c20 7769 6474 6820 616e 6420 6865 6967 , width and heig │ │ │ │ │ +0000cd30: 6874 2077 696c 6c20 6265 2063 6c61 6d70 ht will be clamp │ │ │ │ │ +0000cd40: 6564 2074 6f20 6669 7420 7363 7265 656e ed to fit screen │ │ │ │ │ +0000cd50: 2e0a 2020 2020 2049 6620 2778 2720 616e .. If 'x' an │ │ │ │ │ +0000cd60: 6420 2779 2720 6172 6520 6f75 7420 6f66 d 'y' are out of │ │ │ │ │ +0000cd70: 2062 6f75 6e64 732c 2061 6c6c 2066 756e bounds, all fun │ │ │ │ │ +0000cd80: 6374 696f 6e73 2064 7261 7769 6e67 2074 ctions drawing t │ │ │ │ │ +0000cd90: 6f20 7363 7265 656e 0a20 2020 2020 7769 o screen. wi │ │ │ │ │ +0000cda0: 6c6c 206e 6f74 2062 6520 6469 7370 6c61 ll not be displa │ │ │ │ │ +0000cdb0: 7965 642e 2020 496e 206f 7264 6572 2074 yed. In order t │ │ │ │ │ +0000cdc0: 6f20 6d61 7869 6d69 7a65 2076 6965 7770 o maximize viewp │ │ │ │ │ +0000cdd0: 6f72 742c 2075 7365 0a20 2020 2020 2767 ort, use. 'g │ │ │ │ │ +0000cde0: 7275 625f 7669 6465 6f5f 6765 745f 696e rub_video_get_in │ │ │ │ │ +0000cdf0: 666f 2720 746f 2071 7565 7279 2061 6374 fo' to query act │ │ │ │ │ +0000ce00: 7561 6c20 7363 7265 656e 2064 696d 656e ual screen dimen │ │ │ │ │ +0000ce10: 7369 6f6e 7320 616e 6420 7072 6f76 6964 sions and provid │ │ │ │ │ +0000ce20: 650a 2020 2020 2074 6861 7420 696e 666f e. that info │ │ │ │ │ +0000ce30: 726d 6174 696f 6e20 746f 2074 6869 7320 rmation to this │ │ │ │ │ +0000ce40: 6675 6e63 7469 6f6e 2e0a 0a31 302e 312e function...10.1. │ │ │ │ │ +0000ce50: 3130 2067 7275 625f 7669 6465 6f5f 6765 10 grub_video_ge │ │ │ │ │ +0000ce60: 745f 7669 6577 706f 7274 0a2d 2d2d 2d2d t_viewport.----- │ │ │ │ │ 0000ce70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000ce80: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 --------.. * P │ │ │ │ │ -0000ce90: 726f 746f 7479 7065 3a0a 0a20 2020 2020 rototype:.. │ │ │ │ │ -0000cea0: 2020 2020 2067 7275 625f 6572 725f 740a grub_err_t. │ │ │ │ │ -0000ceb0: 2020 2020 2020 2020 2020 6772 7562 5f76 grub_v │ │ │ │ │ -0000cec0: 6964 656f 5f67 6574 5f76 6965 7770 6f72 ideo_get_viewpor │ │ │ │ │ -0000ced0: 7420 2875 6e73 6967 6e65 6420 696e 7420 t (unsigned int │ │ │ │ │ -0000cee0: 2a78 2c20 756e 7369 676e 6564 2069 6e74 *x, unsigned int │ │ │ │ │ -0000cef0: 202a 792c 2075 6e73 6967 6e65 6420 696e *y, unsigned in │ │ │ │ │ -0000cf00: 7420 2a77 6964 7468 2c20 756e 7369 676e t *width, unsign │ │ │ │ │ -0000cf10: 6564 2069 6e74 202a 6865 6967 6874 293b ed int *height); │ │ │ │ │ -0000cf20: 0a20 2020 2a20 4465 7363 7269 7074 696f . * Descriptio │ │ │ │ │ -0000cf30: 6e3a 0a0a 2020 2020 2055 7365 6420 746f n:.. Used to │ │ │ │ │ -0000cf40: 2071 7565 7279 2063 7572 7265 6e74 2076 query current v │ │ │ │ │ -0000cf50: 6965 7770 6f72 7420 6469 6d65 6e73 696f iewport dimensio │ │ │ │ │ -0000cf60: 6e73 2e20 2053 6f66 7477 6172 6520 6465 ns. Software de │ │ │ │ │ -0000cf70: 7665 6c6f 7065 7220 6361 6e0a 2020 2020 veloper can. │ │ │ │ │ -0000cf80: 2075 7365 2074 6869 7320 746f 2063 686f use this to cho │ │ │ │ │ -0000cf90: 6f73 6520 6265 7374 2077 6179 2074 6f20 ose best way to │ │ │ │ │ -0000cfa0: 7265 6e64 6572 2063 6f6e 7465 6e74 7320 render contents │ │ │ │ │ -0000cfb0: 6f66 2074 6865 2076 6965 7770 6f72 742e of the viewport. │ │ │ │ │ -0000cfc0: 0a0a 3130 2e31 2e31 3120 6772 7562 5f76 ..10.1.11 grub_v │ │ │ │ │ -0000cfd0: 6964 656f 5f73 6574 5f72 6567 696f 6e0a ideo_set_region. │ │ │ │ │ -0000cfe0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000cff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ -0000d000: 2020 2a20 5072 6f74 6f74 7970 653a 0a0a * Prototype:.. │ │ │ │ │ -0000d010: 2020 2020 2020 2020 2020 6772 7562 5f65 grub_e │ │ │ │ │ -0000d020: 7272 5f74 0a20 2020 2020 2020 2020 2067 rr_t. g │ │ │ │ │ -0000d030: 7275 625f 7669 6465 6f5f 7365 745f 7265 rub_video_set_re │ │ │ │ │ -0000d040: 6769 6f6e 2028 756e 7369 676e 6564 2069 gion (unsigned i │ │ │ │ │ -0000d050: 6e74 2078 2c20 756e 7369 676e 6564 2069 nt x, unsigned i │ │ │ │ │ -0000d060: 6e74 2079 2c20 756e 7369 676e 6564 2069 nt y, unsigned i │ │ │ │ │ -0000d070: 6e74 2077 6964 7468 2c20 756e 7369 676e nt width, unsign │ │ │ │ │ -0000d080: 6564 2069 6e74 2068 6569 6768 7429 3b0a ed int height);. │ │ │ │ │ -0000d090: 2020 202a 2044 6573 6372 6970 7469 6f6e * Description │ │ │ │ │ -0000d0a0: 3a0a 0a20 2020 2020 5573 6564 2074 6f20 :.. Used to │ │ │ │ │ -0000d0b0: 7370 6563 6966 7920 7468 6520 7265 6769 specify the regi │ │ │ │ │ -0000d0c0: 6f6e 206f 6620 7468 6520 7363 7265 656e on of the screen │ │ │ │ │ -0000d0d0: 2077 6869 6368 2073 686f 756c 6420 6265 which should be │ │ │ │ │ -0000d0e0: 2072 6564 7261 776e 2e0a 2020 2020 2055 redrawn.. U │ │ │ │ │ -0000d0f0: 7365 2061 6273 6f6c 7574 6520 7661 6c75 se absolute valu │ │ │ │ │ -0000d100: 6573 2e20 2057 6865 6e20 7468 6520 7265 es. When the re │ │ │ │ │ -0000d110: 6769 6f6e 2069 7320 7365 7420 616e 6420 gion is set and │ │ │ │ │ -0000d120: 6172 6561 2073 7461 7475 7320 6973 0a20 area status is. │ │ │ │ │ -0000d130: 2020 2020 454e 4142 4c45 2061 6c6c 2064 ENABLE all d │ │ │ │ │ -0000d140: 7261 7720 636f 6d6d 616e 6473 2077 696c raw commands wil │ │ │ │ │ -0000d150: 6c20 6265 2070 6572 666f 726d 6564 2069 l be performed i │ │ │ │ │ -0000d160: 6e73 6964 6520 7468 6520 696e 7465 7273 nside the inters │ │ │ │ │ -0000d170: 6570 7469 6f6e 0a20 2020 2020 6f66 2072 eption. of r │ │ │ │ │ -0000d180: 6567 696f 6e20 616e 6420 7669 6577 706f egion and viewpo │ │ │ │ │ -0000d190: 7274 206e 616d 6564 2061 7265 612e 2020 rt named area. │ │ │ │ │ -0000d1a0: 4966 2064 7261 7720 636f 6d6d 616e 6473 If draw commands │ │ │ │ │ -0000d1b0: 2074 7279 2074 6f20 6472 6177 0a20 2020 try to draw. │ │ │ │ │ -0000d1c0: 2020 6f76 6572 2076 6965 7770 6f72 742c over viewport, │ │ │ │ │ -0000d1d0: 2074 6865 7920 6172 6520 636c 6970 7065 they are clippe │ │ │ │ │ -0000d1e0: 642e 2020 4966 2064 6576 656c 6f70 6572 d. If developer │ │ │ │ │ -0000d1f0: 2072 6571 7565 7374 7320 6c61 7267 6572 requests larger │ │ │ │ │ -0000d200: 2074 6861 6e0a 2020 2020 2070 6f73 7369 than. possi │ │ │ │ │ -0000d210: 626c 6520 7265 6769 6f6e 2c20 7769 6474 ble region, widt │ │ │ │ │ -0000d220: 6820 616e 6420 6865 6967 6874 2077 696c h and height wil │ │ │ │ │ -0000d230: 6c20 6265 2063 6c61 6d70 6564 2074 6f20 l be clamped to │ │ │ │ │ -0000d240: 6669 7420 7363 7265 656e 2e0a 2020 2020 fit screen.. │ │ │ │ │ -0000d250: 2053 686f 756c 6420 6265 2075 7365 6420 Should be used │ │ │ │ │ -0000d260: 666f 7220 7265 6472 6177 696e 6720 6f66 for redrawing of │ │ │ │ │ -0000d270: 2061 6374 6976 6520 656c 656d 656e 7473 active elements │ │ │ │ │ -0000d280: 2e0a 0a31 302e 312e 3132 2067 7275 625f ...10.1.12 grub_ │ │ │ │ │ -0000d290: 7669 6465 6f5f 6765 745f 7265 6769 6f6e video_get_region │ │ │ │ │ -0000d2a0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -0000d2b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -0000d2c0: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ -0000d2d0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ -0000d2e0: 6572 725f 740a 2020 2020 2020 2020 2020 err_t. │ │ │ │ │ -0000d2f0: 6772 7562 5f76 6964 656f 5f67 6574 5f72 grub_video_get_r │ │ │ │ │ -0000d300: 6567 696f 6e20 2875 6e73 6967 6e65 6420 egion (unsigned │ │ │ │ │ -0000d310: 696e 7420 2a78 2c20 756e 7369 676e 6564 int *x, unsigned │ │ │ │ │ -0000d320: 2069 6e74 202a 792c 2075 6e73 6967 6e65 int *y, unsigne │ │ │ │ │ -0000d330: 6420 696e 7420 2a77 6964 7468 2c20 756e d int *width, un │ │ │ │ │ -0000d340: 7369 676e 6564 2069 6e74 202a 6865 6967 signed int *heig │ │ │ │ │ -0000d350: 6874 293b 0a20 2020 2a20 4465 7363 7269 ht);. * Descri │ │ │ │ │ -0000d360: 7074 696f 6e3a 0a0a 2020 2020 2055 7365 ption:.. Use │ │ │ │ │ -0000d370: 6420 746f 2071 7565 7279 2063 7572 7265 d to query curre │ │ │ │ │ -0000d380: 6e74 2072 6567 696f 6e20 6469 6d65 6e73 nt region dimens │ │ │ │ │ -0000d390: 696f 6e73 2e0a 0a31 302e 312e 3133 2067 ions...10.1.13 g │ │ │ │ │ -0000d3a0: 7275 625f 7669 6465 6f5f 6d61 705f 636f rub_video_map_co │ │ │ │ │ -0000d3b0: 6c6f 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d lor.------------ │ │ │ │ │ +0000ce80: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ │ +0000ce90: 2050 726f 746f 7479 7065 3a0a 0a20 2020 Prototype:.. │ │ │ │ │ +0000cea0: 2020 2020 2020 2067 7275 625f 6572 725f grub_err_ │ │ │ │ │ +0000ceb0: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ │ +0000cec0: 5f76 6964 656f 5f67 6574 5f76 6965 7770 _video_get_viewp │ │ │ │ │ +0000ced0: 6f72 7420 2875 6e73 6967 6e65 6420 696e ort (unsigned in │ │ │ │ │ +0000cee0: 7420 2a78 2c20 756e 7369 676e 6564 2069 t *x, unsigned i │ │ │ │ │ +0000cef0: 6e74 202a 792c 2075 6e73 6967 6e65 6420 nt *y, unsigned │ │ │ │ │ +0000cf00: 696e 7420 2a77 6964 7468 2c20 756e 7369 int *width, unsi │ │ │ │ │ +0000cf10: 676e 6564 2069 6e74 202a 6865 6967 6874 gned int *height │ │ │ │ │ +0000cf20: 293b 0a20 2020 2a20 4465 7363 7269 7074 );. * Descript │ │ │ │ │ +0000cf30: 696f 6e3a 0a0a 2020 2020 2055 7365 6420 ion:.. Used │ │ │ │ │ +0000cf40: 746f 2071 7565 7279 2063 7572 7265 6e74 to query current │ │ │ │ │ +0000cf50: 2076 6965 7770 6f72 7420 6469 6d65 6e73 viewport dimens │ │ │ │ │ +0000cf60: 696f 6e73 2e20 2053 6f66 7477 6172 6520 ions. Software │ │ │ │ │ +0000cf70: 6465 7665 6c6f 7065 7220 6361 6e0a 2020 developer can. │ │ │ │ │ +0000cf80: 2020 2075 7365 2074 6869 7320 746f 2063 use this to c │ │ │ │ │ +0000cf90: 686f 6f73 6520 6265 7374 2077 6179 2074 hoose best way t │ │ │ │ │ +0000cfa0: 6f20 7265 6e64 6572 2063 6f6e 7465 6e74 o render content │ │ │ │ │ +0000cfb0: 7320 6f66 2074 6865 2076 6965 7770 6f72 s of the viewpor │ │ │ │ │ +0000cfc0: 742e 0a0a 3130 2e31 2e31 3120 6772 7562 t...10.1.11 grub │ │ │ │ │ +0000cfd0: 5f76 6964 656f 5f73 6574 5f72 6567 696f _video_set_regio │ │ │ │ │ +0000cfe0: 6e0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d n.-------------- │ │ │ │ │ +0000cff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +0000d000: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ │ +0000d010: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ │ +0000d020: 5f65 7272 5f74 0a20 2020 2020 2020 2020 _err_t. │ │ │ │ │ +0000d030: 2067 7275 625f 7669 6465 6f5f 7365 745f grub_video_set_ │ │ │ │ │ +0000d040: 7265 6769 6f6e 2028 756e 7369 676e 6564 region (unsigned │ │ │ │ │ +0000d050: 2069 6e74 2078 2c20 756e 7369 676e 6564 int x, unsigned │ │ │ │ │ +0000d060: 2069 6e74 2079 2c20 756e 7369 676e 6564 int y, unsigned │ │ │ │ │ +0000d070: 2069 6e74 2077 6964 7468 2c20 756e 7369 int width, unsi │ │ │ │ │ +0000d080: 676e 6564 2069 6e74 2068 6569 6768 7429 gned int height) │ │ │ │ │ +0000d090: 3b0a 2020 202a 2044 6573 6372 6970 7469 ;. * Descripti │ │ │ │ │ +0000d0a0: 6f6e 3a0a 0a20 2020 2020 5573 6564 2074 on:.. Used t │ │ │ │ │ +0000d0b0: 6f20 7370 6563 6966 7920 7468 6520 7265 o specify the re │ │ │ │ │ +0000d0c0: 6769 6f6e 206f 6620 7468 6520 7363 7265 gion of the scre │ │ │ │ │ +0000d0d0: 656e 2077 6869 6368 2073 686f 756c 6420 en which should │ │ │ │ │ +0000d0e0: 6265 2072 6564 7261 776e 2e0a 2020 2020 be redrawn.. │ │ │ │ │ +0000d0f0: 2055 7365 2061 6273 6f6c 7574 6520 7661 Use absolute va │ │ │ │ │ +0000d100: 6c75 6573 2e20 2057 6865 6e20 7468 6520 lues. When the │ │ │ │ │ +0000d110: 7265 6769 6f6e 2069 7320 7365 7420 616e region is set an │ │ │ │ │ +0000d120: 6420 6172 6561 2073 7461 7475 7320 6973 d area status is │ │ │ │ │ +0000d130: 0a20 2020 2020 454e 4142 4c45 2061 6c6c . ENABLE all │ │ │ │ │ +0000d140: 2064 7261 7720 636f 6d6d 616e 6473 2077 draw commands w │ │ │ │ │ +0000d150: 696c 6c20 6265 2070 6572 666f 726d 6564 ill be performed │ │ │ │ │ +0000d160: 2069 6e73 6964 6520 7468 6520 696e 7465 inside the inte │ │ │ │ │ +0000d170: 7273 6570 7469 6f6e 0a20 2020 2020 6f66 rseption. of │ │ │ │ │ +0000d180: 2072 6567 696f 6e20 616e 6420 7669 6577 region and view │ │ │ │ │ +0000d190: 706f 7274 206e 616d 6564 2061 7265 612e port named area. │ │ │ │ │ +0000d1a0: 2020 4966 2064 7261 7720 636f 6d6d 616e If draw comman │ │ │ │ │ +0000d1b0: 6473 2074 7279 2074 6f20 6472 6177 0a20 ds try to draw. │ │ │ │ │ +0000d1c0: 2020 2020 6f76 6572 2076 6965 7770 6f72 over viewpor │ │ │ │ │ +0000d1d0: 742c 2074 6865 7920 6172 6520 636c 6970 t, they are clip │ │ │ │ │ +0000d1e0: 7065 642e 2020 4966 2064 6576 656c 6f70 ped. If develop │ │ │ │ │ +0000d1f0: 6572 2072 6571 7565 7374 7320 6c61 7267 er requests larg │ │ │ │ │ +0000d200: 6572 2074 6861 6e0a 2020 2020 2070 6f73 er than. pos │ │ │ │ │ +0000d210: 7369 626c 6520 7265 6769 6f6e 2c20 7769 sible region, wi │ │ │ │ │ +0000d220: 6474 6820 616e 6420 6865 6967 6874 2077 dth and height w │ │ │ │ │ +0000d230: 696c 6c20 6265 2063 6c61 6d70 6564 2074 ill be clamped t │ │ │ │ │ +0000d240: 6f20 6669 7420 7363 7265 656e 2e0a 2020 o fit screen.. │ │ │ │ │ +0000d250: 2020 2053 686f 756c 6420 6265 2075 7365 Should be use │ │ │ │ │ +0000d260: 6420 666f 7220 7265 6472 6177 696e 6720 d for redrawing │ │ │ │ │ +0000d270: 6f66 2061 6374 6976 6520 656c 656d 656e of active elemen │ │ │ │ │ +0000d280: 7473 2e0a 0a31 302e 312e 3132 2067 7275 ts...10.1.12 gru │ │ │ │ │ +0000d290: 625f 7669 6465 6f5f 6765 745f 7265 6769 b_video_get_regi │ │ │ │ │ +0000d2a0: 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d on.------------- │ │ │ │ │ +0000d2b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0000d2c0: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ │ +0000d2d0: 3a0a 0a20 2020 2020 2020 2020 2067 7275 :.. gru │ │ │ │ │ +0000d2e0: 625f 6572 725f 740a 2020 2020 2020 2020 b_err_t. │ │ │ │ │ +0000d2f0: 2020 6772 7562 5f76 6964 656f 5f67 6574 grub_video_get │ │ │ │ │ +0000d300: 5f72 6567 696f 6e20 2875 6e73 6967 6e65 _region (unsigne │ │ │ │ │ +0000d310: 6420 696e 7420 2a78 2c20 756e 7369 676e d int *x, unsign │ │ │ │ │ +0000d320: 6564 2069 6e74 202a 792c 2075 6e73 6967 ed int *y, unsig │ │ │ │ │ +0000d330: 6e65 6420 696e 7420 2a77 6964 7468 2c20 ned int *width, │ │ │ │ │ +0000d340: 756e 7369 676e 6564 2069 6e74 202a 6865 unsigned int *he │ │ │ │ │ +0000d350: 6967 6874 293b 0a20 2020 2a20 4465 7363 ight);. * Desc │ │ │ │ │ +0000d360: 7269 7074 696f 6e3a 0a0a 2020 2020 2055 ription:.. U │ │ │ │ │ +0000d370: 7365 6420 746f 2071 7565 7279 2063 7572 sed to query cur │ │ │ │ │ +0000d380: 7265 6e74 2072 6567 696f 6e20 6469 6d65 rent region dime │ │ │ │ │ +0000d390: 6e73 696f 6e73 2e0a 0a31 302e 312e 3133 nsions...10.1.13 │ │ │ │ │ +0000d3a0: 2067 7275 625f 7669 6465 6f5f 6d61 705f grub_video_map_ │ │ │ │ │ +0000d3b0: 636f 6c6f 720a 2d2d 2d2d 2d2d 2d2d 2d2d color.---------- │ │ │ │ │ 0000d3c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000d3d0: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ │ -0000d3e0: 3a0a 0a20 2020 2020 2020 2020 2067 7275 :.. gru │ │ │ │ │ -0000d3f0: 625f 7669 6465 6f5f 636f 6c6f 725f 740a b_video_color_t. │ │ │ │ │ -0000d400: 2020 2020 2020 2020 2020 6772 7562 5f76 grub_v │ │ │ │ │ -0000d410: 6964 656f 5f6d 6170 5f63 6f6c 6f72 2028 ideo_map_color ( │ │ │ │ │ -0000d420: 6772 7562 5f75 696e 7433 325f 7420 636f grub_uint32_t co │ │ │ │ │ -0000d430: 6c6f 725f 6e61 6d65 293b 0a20 2020 2a20 lor_name);. * │ │ │ │ │ -0000d440: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ -0000d450: 2020 204d 6170 2063 6f6c 6f72 2063 616e Map color can │ │ │ │ │ -0000d460: 2062 6520 7573 6564 2074 6f20 7375 7070 be used to supp │ │ │ │ │ -0000d470: 6f72 7420 636f 6c6f 7220 7468 656d 6573 ort color themes │ │ │ │ │ -0000d480: 2069 6e20 4752 5542 2e20 5468 6572 6520 in GRUB. There │ │ │ │ │ -0000d490: 7769 6c6c 0a20 2020 2020 6265 2063 6f6c will. be col │ │ │ │ │ -0000d4a0: 6c65 6374 696f 6e20 6f66 2063 6f6c 6f72 lection of color │ │ │ │ │ -0000d4b0: 206e 616d 6573 2074 6861 7420 6361 6e20 names that can │ │ │ │ │ -0000d4c0: 6265 2075 7365 6420 746f 2071 7565 7279 be used to query │ │ │ │ │ -0000d4d0: 2061 6374 7561 6c0a 2020 2020 2073 6372 actual. scr │ │ │ │ │ -0000d4e0: 6565 6e20 6d61 7070 6564 2063 6f6c 6f72 een mapped color │ │ │ │ │ -0000d4f0: 2064 6174 612e 2020 4578 616d 706c 6573 data. Examples │ │ │ │ │ -0000d500: 2063 6f75 6c64 2062 650a 2020 2020 2027 could be. ' │ │ │ │ │ -0000d510: 4752 5542 5f43 4f4c 4f52 5f43 4f4e 534f GRUB_COLOR_CONSO │ │ │ │ │ -0000d520: 4c45 5f42 4143 4b47 524f 554e 4427 2c20 LE_BACKGROUND', │ │ │ │ │ -0000d530: 2747 5255 425f 434f 4c4f 525f 434f 4e53 'GRUB_COLOR_CONS │ │ │ │ │ -0000d540: 4f4c 455f 5445 5854 272e 2020 5468 650a OLE_TEXT'. The. │ │ │ │ │ -0000d550: 2020 2020 2061 6374 7561 6c20 636f 6c6f actual colo │ │ │ │ │ -0000d560: 7220 6465 6669 6e65 7320 6172 6520 6e6f r defines are no │ │ │ │ │ -0000d570: 7420 7370 6563 6966 6965 6420 6174 2074 t specified at t │ │ │ │ │ -0000d580: 6869 7320 706f 696e 742e 0a0a 3130 2e31 his point...10.1 │ │ │ │ │ -0000d590: 2e31 3420 6772 7562 5f76 6964 656f 5f6d .14 grub_video_m │ │ │ │ │ -0000d5a0: 6170 5f72 6762 0a2d 2d2d 2d2d 2d2d 2d2d ap_rgb.--------- │ │ │ │ │ +0000d3d0: 2d2d 0a0a 2020 202a 2050 726f 746f 7479 --.. * Prototy │ │ │ │ │ +0000d3e0: 7065 3a0a 0a20 2020 2020 2020 2020 2067 pe:.. g │ │ │ │ │ +0000d3f0: 7275 625f 7669 6465 6f5f 636f 6c6f 725f rub_video_color_ │ │ │ │ │ +0000d400: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ │ +0000d410: 5f76 6964 656f 5f6d 6170 5f63 6f6c 6f72 _video_map_color │ │ │ │ │ +0000d420: 2028 6772 7562 5f75 696e 7433 325f 7420 (grub_uint32_t │ │ │ │ │ +0000d430: 636f 6c6f 725f 6e61 6d65 293b 0a20 2020 color_name);. │ │ │ │ │ +0000d440: 2a20 4465 7363 7269 7074 696f 6e3a 0a0a * Description:.. │ │ │ │ │ +0000d450: 2020 2020 204d 6170 2063 6f6c 6f72 2063 Map color c │ │ │ │ │ +0000d460: 616e 2062 6520 7573 6564 2074 6f20 7375 an be used to su │ │ │ │ │ +0000d470: 7070 6f72 7420 636f 6c6f 7220 7468 656d pport color them │ │ │ │ │ +0000d480: 6573 2069 6e20 4752 5542 2e20 5468 6572 es in GRUB. Ther │ │ │ │ │ +0000d490: 6520 7769 6c6c 0a20 2020 2020 6265 2063 e will. be c │ │ │ │ │ +0000d4a0: 6f6c 6c65 6374 696f 6e20 6f66 2063 6f6c ollection of col │ │ │ │ │ +0000d4b0: 6f72 206e 616d 6573 2074 6861 7420 6361 or names that ca │ │ │ │ │ +0000d4c0: 6e20 6265 2075 7365 6420 746f 2071 7565 n be used to que │ │ │ │ │ +0000d4d0: 7279 2061 6374 7561 6c0a 2020 2020 2073 ry actual. s │ │ │ │ │ +0000d4e0: 6372 6565 6e20 6d61 7070 6564 2063 6f6c creen mapped col │ │ │ │ │ +0000d4f0: 6f72 2064 6174 612e 2020 4578 616d 706c or data. Exampl │ │ │ │ │ +0000d500: 6573 2063 6f75 6c64 2062 650a 2020 2020 es could be. │ │ │ │ │ +0000d510: 2027 4752 5542 5f43 4f4c 4f52 5f43 4f4e 'GRUB_COLOR_CON │ │ │ │ │ +0000d520: 534f 4c45 5f42 4143 4b47 524f 554e 4427 SOLE_BACKGROUND' │ │ │ │ │ +0000d530: 2c20 2747 5255 425f 434f 4c4f 525f 434f , 'GRUB_COLOR_CO │ │ │ │ │ +0000d540: 4e53 4f4c 455f 5445 5854 272e 2020 5468 NSOLE_TEXT'. Th │ │ │ │ │ +0000d550: 650a 2020 2020 2061 6374 7561 6c20 636f e. actual co │ │ │ │ │ +0000d560: 6c6f 7220 6465 6669 6e65 7320 6172 6520 lor defines are │ │ │ │ │ +0000d570: 6e6f 7420 7370 6563 6966 6965 6420 6174 not specified at │ │ │ │ │ +0000d580: 2074 6869 7320 706f 696e 742e 0a0a 3130 this point...10 │ │ │ │ │ +0000d590: 2e31 2e31 3420 6772 7562 5f76 6964 656f .1.14 grub_video │ │ │ │ │ +0000d5a0: 5f6d 6170 5f72 6762 0a2d 2d2d 2d2d 2d2d _map_rgb.------- │ │ │ │ │ 0000d5b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000d5c0: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ -0000d5d0: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ │ -0000d5e0: 7562 5f76 6964 656f 5f63 6f6c 6f72 5f74 ub_video_color_t │ │ │ │ │ -0000d5f0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ -0000d600: 7669 6465 6f5f 6d61 705f 7267 6220 2867 video_map_rgb (g │ │ │ │ │ -0000d610: 7275 625f 7569 6e74 385f 7420 7265 642c rub_uint8_t red, │ │ │ │ │ -0000d620: 2067 7275 625f 7569 6e74 385f 7420 6772 grub_uint8_t gr │ │ │ │ │ -0000d630: 6565 6e2c 2067 7275 625f 7569 6e74 385f een, grub_uint8_ │ │ │ │ │ -0000d640: 7420 626c 7565 293b 0a20 2020 2a20 4465 t blue);. * De │ │ │ │ │ -0000d650: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ -0000d660: 204d 6170 2052 4742 2076 616c 7565 7320 Map RGB values │ │ │ │ │ -0000d670: 746f 2063 6f6d 7061 7469 626c 6520 7363 to compatible sc │ │ │ │ │ -0000d680: 7265 656e 2063 6f6c 6f72 2064 6174 612e reen color data. │ │ │ │ │ -0000d690: 2020 5661 6c75 6573 2061 7265 0a20 2020 Values are. │ │ │ │ │ -0000d6a0: 2020 6578 7065 6374 6564 2074 6f20 6265 expected to be │ │ │ │ │ -0000d6b0: 2069 6e20 7261 6e67 6520 302d 3235 3520 in range 0-255 │ │ │ │ │ -0000d6c0: 616e 6420 696e 2052 4742 206d 6f64 6573 and in RGB modes │ │ │ │ │ -0000d6d0: 2074 6865 7920 7769 6c6c 2062 650a 2020 they will be. │ │ │ │ │ -0000d6e0: 2020 2063 6f6e 7665 7274 6564 2074 6f20 converted to │ │ │ │ │ -0000d6f0: 7363 7265 656e 2063 6f6c 6f72 2064 6174 screen color dat │ │ │ │ │ -0000d700: 612e 2020 496e 2069 6e64 6578 2063 6f6c a. In index col │ │ │ │ │ -0000d710: 6f72 206d 6f64 6573 2c20 696e 6465 7820 or modes, index │ │ │ │ │ -0000d720: 636f 6c6f 720a 2020 2020 2070 616c 6574 color. palet │ │ │ │ │ -0000d730: 7465 2077 696c 6c20 6265 2073 6561 7263 te will be searc │ │ │ │ │ -0000d740: 6865 6420 666f 7220 7370 6563 6966 6965 hed for specifie │ │ │ │ │ -0000d750: 6420 636f 6c6f 7220 616e 6420 7468 656e d color and then │ │ │ │ │ -0000d760: 2069 6e64 6578 2069 730a 2020 2020 2072 index is. r │ │ │ │ │ -0000d770: 6574 7572 6e65 642e 0a0a 3130 2e31 2e31 eturned...10.1.1 │ │ │ │ │ -0000d780: 3520 6772 7562 5f76 6964 656f 5f6d 6170 5 grub_video_map │ │ │ │ │ -0000d790: 5f72 6762 610a 2d2d 2d2d 2d2d 2d2d 2d2d _rgba.---------- │ │ │ │ │ +0000d5c0: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ │ +0000d5d0: 7970 653a 0a0a 2020 2020 2020 2020 2020 ype:.. │ │ │ │ │ +0000d5e0: 6772 7562 5f76 6964 656f 5f63 6f6c 6f72 grub_video_color │ │ │ │ │ +0000d5f0: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ │ +0000d600: 625f 7669 6465 6f5f 6d61 705f 7267 6220 b_video_map_rgb │ │ │ │ │ +0000d610: 2867 7275 625f 7569 6e74 385f 7420 7265 (grub_uint8_t re │ │ │ │ │ +0000d620: 642c 2067 7275 625f 7569 6e74 385f 7420 d, grub_uint8_t │ │ │ │ │ +0000d630: 6772 6565 6e2c 2067 7275 625f 7569 6e74 green, grub_uint │ │ │ │ │ +0000d640: 385f 7420 626c 7565 293b 0a20 2020 2a20 8_t blue);. * │ │ │ │ │ +0000d650: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ +0000d660: 2020 204d 6170 2052 4742 2076 616c 7565 Map RGB value │ │ │ │ │ +0000d670: 7320 746f 2063 6f6d 7061 7469 626c 6520 s to compatible │ │ │ │ │ +0000d680: 7363 7265 656e 2063 6f6c 6f72 2064 6174 screen color dat │ │ │ │ │ +0000d690: 612e 2020 5661 6c75 6573 2061 7265 0a20 a. Values are. │ │ │ │ │ +0000d6a0: 2020 2020 6578 7065 6374 6564 2074 6f20 expected to │ │ │ │ │ +0000d6b0: 6265 2069 6e20 7261 6e67 6520 302d 3235 be in range 0-25 │ │ │ │ │ +0000d6c0: 3520 616e 6420 696e 2052 4742 206d 6f64 5 and in RGB mod │ │ │ │ │ +0000d6d0: 6573 2074 6865 7920 7769 6c6c 2062 650a es they will be. │ │ │ │ │ +0000d6e0: 2020 2020 2063 6f6e 7665 7274 6564 2074 converted t │ │ │ │ │ +0000d6f0: 6f20 7363 7265 656e 2063 6f6c 6f72 2064 o screen color d │ │ │ │ │ +0000d700: 6174 612e 2020 496e 2069 6e64 6578 2063 ata. In index c │ │ │ │ │ +0000d710: 6f6c 6f72 206d 6f64 6573 2c20 696e 6465 olor modes, inde │ │ │ │ │ +0000d720: 7820 636f 6c6f 720a 2020 2020 2070 616c x color. pal │ │ │ │ │ +0000d730: 6574 7465 2077 696c 6c20 6265 2073 6561 ette will be sea │ │ │ │ │ +0000d740: 7263 6865 6420 666f 7220 7370 6563 6966 rched for specif │ │ │ │ │ +0000d750: 6965 6420 636f 6c6f 7220 616e 6420 7468 ied color and th │ │ │ │ │ +0000d760: 656e 2069 6e64 6578 2069 730a 2020 2020 en index is. │ │ │ │ │ +0000d770: 2072 6574 7572 6e65 642e 0a0a 3130 2e31 returned...10.1 │ │ │ │ │ +0000d780: 2e31 3520 6772 7562 5f76 6964 656f 5f6d .15 grub_video_m │ │ │ │ │ +0000d790: 6170 5f72 6762 610a 2d2d 2d2d 2d2d 2d2d ap_rgba.-------- │ │ │ │ │ 0000d7a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000d7b0: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ -0000d7c0: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ │ -0000d7d0: 7562 5f76 6964 656f 5f63 6f6c 6f72 5f74 ub_video_color_t │ │ │ │ │ -0000d7e0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ -0000d7f0: 7669 6465 6f5f 6d61 705f 7267 6261 2028 video_map_rgba ( │ │ │ │ │ -0000d800: 6772 7562 5f75 696e 7438 5f74 2072 6564 grub_uint8_t red │ │ │ │ │ -0000d810: 2c20 6772 7562 5f75 696e 7438 5f74 2067 , grub_uint8_t g │ │ │ │ │ -0000d820: 7265 656e 2c20 6772 7562 5f75 696e 7438 reen, grub_uint8 │ │ │ │ │ -0000d830: 5f74 2062 6c75 652c 2067 7275 625f 7569 _t blue, grub_ui │ │ │ │ │ -0000d840: 6e74 385f 7420 616c 7068 6129 3b0a 2020 nt8_t alpha);. │ │ │ │ │ -0000d850: 202a 2044 6573 6372 6970 7469 6f6e 3a0a * Description:. │ │ │ │ │ -0000d860: 0a20 2020 2020 4d61 7020 5247 4241 2076 . Map RGBA v │ │ │ │ │ -0000d870: 616c 7565 7320 746f 2063 6f6d 7061 7469 alues to compati │ │ │ │ │ -0000d880: 626c 6520 7363 7265 656e 2063 6f6c 6f72 ble screen color │ │ │ │ │ -0000d890: 2064 6174 612e 2020 5661 6c75 6573 2061 data. Values a │ │ │ │ │ -0000d8a0: 7265 0a20 2020 2020 6578 7065 6374 6564 re. expected │ │ │ │ │ -0000d8b0: 2074 6f20 6265 2069 6e20 7261 6e67 6520 to be in range │ │ │ │ │ -0000d8c0: 302d 3235 352e 2020 496e 2052 4742 4120 0-255. In RGBA │ │ │ │ │ -0000d8d0: 6d6f 6465 7320 7468 6579 2077 696c 6c20 modes they will │ │ │ │ │ -0000d8e0: 6265 0a20 2020 2020 636f 6e76 6572 7465 be. converte │ │ │ │ │ -0000d8f0: 6420 746f 2073 6372 6565 6e20 636f 6c6f d to screen colo │ │ │ │ │ -0000d900: 7220 6461 7461 2e20 2049 6e20 696e 6465 r data. In inde │ │ │ │ │ -0000d910: 7820 636f 6c6f 7220 6d6f 6465 732c 2069 x color modes, i │ │ │ │ │ -0000d920: 6e64 6578 2063 6f6c 6f72 0a20 2020 2020 ndex color. │ │ │ │ │ -0000d930: 7061 6c65 7474 6520 7769 6c6c 2062 6520 palette will be │ │ │ │ │ -0000d940: 7365 6172 6368 6564 2066 6f72 2062 6573 searched for bes │ │ │ │ │ -0000d950: 7420 6d61 7463 6869 6e67 2063 6f6c 6f72 t matching color │ │ │ │ │ -0000d960: 2061 6e64 2069 7473 2069 6e64 6578 2069 and its index i │ │ │ │ │ -0000d970: 730a 2020 2020 2072 6574 7572 6e65 642e s. returned. │ │ │ │ │ -0000d980: 0a0a 3130 2e31 2e31 3620 6772 7562 5f76 ..10.1.16 grub_v │ │ │ │ │ -0000d990: 6964 656f 5f75 6e6d 6170 5f63 6f6c 6f72 ideo_unmap_color │ │ │ │ │ -0000d9a0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -0000d9b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -0000d9c0: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ │ -0000d9d0: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ │ -0000d9e0: 5f65 7272 5f74 0a20 2020 2020 2020 2020 _err_t. │ │ │ │ │ -0000d9f0: 2067 7275 625f 7669 6465 6f5f 756e 6d61 grub_video_unma │ │ │ │ │ -0000da00: 705f 636f 6c6f 7220 2867 7275 625f 7669 p_color (grub_vi │ │ │ │ │ -0000da10: 6465 6f5f 636f 6c6f 725f 7420 636f 6c6f deo_color_t colo │ │ │ │ │ -0000da20: 722c 2067 7275 625f 7569 6e74 385f 7420 r, grub_uint8_t │ │ │ │ │ -0000da30: 2a72 6564 2c20 6772 7562 5f75 696e 7438 *red, grub_uint8 │ │ │ │ │ -0000da40: 5f74 202a 6772 6565 6e2c 2067 7275 625f _t *green, grub_ │ │ │ │ │ -0000da50: 7569 6e74 385f 7420 2a62 6c75 652c 2067 uint8_t *blue, g │ │ │ │ │ -0000da60: 7275 625f 7569 6e74 385f 7420 2a61 6c70 rub_uint8_t *alp │ │ │ │ │ -0000da70: 6861 293b 0a20 2020 2a20 4465 7363 7269 ha);. * Descri │ │ │ │ │ -0000da80: 7074 696f 6e3a 0a0a 2020 2020 2055 6e6d ption:.. Unm │ │ │ │ │ -0000da90: 6170 2063 6f6c 6f72 2076 616c 7565 2066 ap color value f │ │ │ │ │ -0000daa0: 726f 6d20 2763 6f6c 6f72 2720 746f 2063 rom 'color' to c │ │ │ │ │ -0000dab0: 6f6c 6f72 2063 6861 6e6e 656c 7320 696e olor channels in │ │ │ │ │ -0000dac0: 2027 7265 6427 2c20 2767 7265 656e 272c 'red', 'green', │ │ │ │ │ -0000dad0: 0a20 2020 2020 2762 6c75 6527 2061 6e64 . 'blue' and │ │ │ │ │ -0000dae0: 2027 616c 7068 6127 2e20 2056 616c 7565 'alpha'. Value │ │ │ │ │ -0000daf0: 7320 7769 6c6c 2062 6520 696e 2072 616e s will be in ran │ │ │ │ │ -0000db00: 6765 2030 2d32 3535 2e20 2041 6374 6976 ge 0-255. Activ │ │ │ │ │ -0000db10: 650a 2020 2020 2072 656e 6465 7269 6e67 e. rendering │ │ │ │ │ -0000db20: 2074 6172 6765 7420 7769 6c6c 2062 6520 target will be │ │ │ │ │ -0000db30: 7573 6564 2066 6f72 2063 6f6c 6f72 2064 used for color d │ │ │ │ │ -0000db40: 6f6d 6169 6e2e 2020 496e 2063 6173 6520 omain. In case │ │ │ │ │ -0000db50: 616c 7068 610a 2020 2020 2069 6e66 6f72 alpha. infor │ │ │ │ │ -0000db60: 6d61 7469 6f6e 2069 7320 6e6f 7420 6176 mation is not av │ │ │ │ │ -0000db70: 6169 6c61 626c 6520 696e 2072 656e 6465 ailable in rende │ │ │ │ │ -0000db80: 7269 6e67 2074 6172 6765 742c 2069 7420 ring target, it │ │ │ │ │ -0000db90: 6973 2061 7373 756d 6564 2074 6f0a 2020 is assumed to. │ │ │ │ │ -0000dba0: 2020 2062 6520 6f70 6171 7565 2028 6861 be opaque (ha │ │ │ │ │ -0000dbb0: 7669 6e67 2076 616c 7565 2032 3535 292e ving value 255). │ │ │ │ │ -0000dbc0: 0a0a 3130 2e31 2e31 3720 6772 7562 5f76 ..10.1.17 grub_v │ │ │ │ │ -0000dbd0: 6964 656f 5f66 696c 6c5f 7265 6374 0a2d ideo_fill_rect.- │ │ │ │ │ -0000dbe0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000dbf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ │ -0000dc00: 2a20 5072 6f74 6f74 7970 653a 0a0a 2020 * Prototype:.. │ │ │ │ │ -0000dc10: 2020 2020 2020 2020 6772 7562 5f65 7272 grub_err │ │ │ │ │ -0000dc20: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ │ -0000dc30: 625f 7669 6465 6f5f 6669 6c6c 5f72 6563 b_video_fill_rec │ │ │ │ │ -0000dc40: 7420 2867 7275 625f 7669 6465 6f5f 636f t (grub_video_co │ │ │ │ │ -0000dc50: 6c6f 725f 7420 636f 6c6f 722c 2069 6e74 lor_t color, int │ │ │ │ │ -0000dc60: 2078 2c20 696e 7420 792c 2075 6e73 6967 x, int y, unsig │ │ │ │ │ -0000dc70: 6e65 6420 696e 7420 7769 6474 682c 2075 ned int width, u │ │ │ │ │ -0000dc80: 6e73 6967 6e65 6420 696e 7420 6865 6967 nsigned int heig │ │ │ │ │ -0000dc90: 6874 293b 0a20 2020 2a20 4465 7363 7269 ht);. * Descri │ │ │ │ │ -0000dca0: 7074 696f 6e3a 0a0a 2020 2020 2046 696c ption:.. Fil │ │ │ │ │ -0000dcb0: 6c20 7370 6563 6966 6965 6420 6172 6561 l specified area │ │ │ │ │ -0000dcc0: 206c 696d 6974 6564 2062 7920 6769 7665 limited by give │ │ │ │ │ -0000dcd0: 6e20 636f 6f72 6469 6e61 7465 7320 7769 n coordinates wi │ │ │ │ │ -0000dce0: 7468 696e 2073 7065 6369 6669 6564 0a20 thin specified. │ │ │ │ │ -0000dcf0: 2020 2020 7669 6577 706f 7274 2e20 204e viewport. N │ │ │ │ │ -0000dd00: 6567 6174 6976 6520 636f 6f72 6469 6e61 egative coordina │ │ │ │ │ -0000dd10: 7465 7320 6172 6520 6163 6365 7074 6564 tes are accepted │ │ │ │ │ -0000dd20: 2069 6e20 6f72 6465 7220 746f 2061 6c6c in order to all │ │ │ │ │ -0000dd30: 6f77 2065 6173 790a 2020 2020 206d 6f76 ow easy. mov │ │ │ │ │ -0000dd40: 696e 6720 6f66 2072 6563 7461 6e67 6c65 ing of rectangle │ │ │ │ │ -0000dd50: 2077 6974 6869 6e20 7669 6577 706f 7274 within viewport │ │ │ │ │ -0000dd60: 2e20 2049 6620 636f 6f72 6469 6e61 7465 . If coordinate │ │ │ │ │ -0000dd70: 7320 6172 6520 6e65 6761 7469 7665 2c0a s are negative,. │ │ │ │ │ -0000dd80: 2020 2020 2061 7265 6120 6f66 2074 6865 area of the │ │ │ │ │ -0000dd90: 2072 6563 7461 6e67 6c65 2077 696c 6c20 rectangle will │ │ │ │ │ -0000dda0: 6265 2073 6872 696e 6b65 6e20 746f 2066 be shrinken to f │ │ │ │ │ -0000ddb0: 6f6c 6c6f 7720 7369 7a65 206c 696d 6974 ollow size limit │ │ │ │ │ -0000ddc0: 7320 6f66 2074 6865 0a20 2020 2020 7669 s of the. vi │ │ │ │ │ -0000ddd0: 6577 706f 7274 2e0a 0a20 2020 2020 536f ewport... So │ │ │ │ │ -0000dde0: 6674 7761 7265 2064 6576 656c 6f70 6572 ftware developer │ │ │ │ │ -0000ddf0: 2073 686f 756c 6420 7573 6520 6569 7468 should use eith │ │ │ │ │ -0000de00: 6572 2027 6772 7562 5f76 6964 656f 5f6d er 'grub_video_m │ │ │ │ │ -0000de10: 6170 5f63 6f6c 6f72 272c 0a20 2020 2020 ap_color',. │ │ │ │ │ -0000de20: 2767 7275 625f 7669 6465 6f5f 6d61 705f 'grub_video_map_ │ │ │ │ │ -0000de30: 7267 6227 206f 7220 2767 7275 625f 7669 rgb' or 'grub_vi │ │ │ │ │ -0000de40: 6465 6f5f 6d61 705f 7267 6261 2720 746f deo_map_rgba' to │ │ │ │ │ -0000de50: 206d 6170 2072 6571 7565 7374 6564 0a20 map requested. │ │ │ │ │ -0000de60: 2020 2020 636f 6c6f 7220 746f 2027 636f color to 'co │ │ │ │ │ -0000de70: 6c6f 7227 2070 6172 616d 6574 6572 2e0a lor' parameter.. │ │ │ │ │ -0000de80: 0a31 302e 312e 3138 2067 7275 625f 7669 .10.1.18 grub_vi │ │ │ │ │ -0000de90: 6465 6f5f 626c 6974 5f67 6c79 7068 0a2d deo_blit_glyph.- │ │ │ │ │ -0000dea0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000deb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ -0000dec0: 202a 2050 726f 746f 7479 7065 3a0a 0a20 * Prototype:.. │ │ │ │ │ -0000ded0: 2020 2020 2020 2020 2067 7275 625f 6572 grub_er │ │ │ │ │ -0000dee0: 725f 740a 2020 2020 2020 2020 2020 6772 r_t. gr │ │ │ │ │ -0000def0: 7562 5f76 6964 656f 5f62 6c69 745f 676c ub_video_blit_gl │ │ │ │ │ -0000df00: 7970 6820 2873 7472 7563 7420 6772 7562 yph (struct grub │ │ │ │ │ -0000df10: 5f66 6f6e 745f 676c 7970 6820 2a67 6c79 _font_glyph *gly │ │ │ │ │ -0000df20: 7068 2c20 6772 7562 5f76 6964 656f 5f63 ph, grub_video_c │ │ │ │ │ -0000df30: 6f6c 6f72 5f74 2063 6f6c 6f72 2c20 696e olor_t color, in │ │ │ │ │ -0000df40: 7420 782c 2069 6e74 2079 293b 0a20 2020 t x, int y);. │ │ │ │ │ -0000df50: 2020 2020 2020 2073 7472 7563 7420 6772 struct gr │ │ │ │ │ -0000df60: 7562 5f66 6f6e 745f 676c 7970 6820 7b0a ub_font_glyph {. │ │ │ │ │ -0000df70: 2020 2020 2020 2020 2020 2020 2020 2f2a /* │ │ │ │ │ -0000df80: 2054 4244 2e20 2a2f 0a20 2020 2020 2020 TBD. */. │ │ │ │ │ -0000df90: 2020 207d 3b0a 2020 202a 2044 6573 6372 };. * Descr │ │ │ │ │ -0000dfa0: 6970 7469 6f6e 3a0a 0a20 2020 2020 5573 iption:.. Us │ │ │ │ │ -0000dfb0: 6564 2074 6f20 626c 6974 2067 6c79 7068 ed to blit glyph │ │ │ │ │ -0000dfc0: 2074 6f20 7669 6577 706f 7274 2069 6e20 to viewport in │ │ │ │ │ -0000dfd0: 7370 6563 6966 6965 6420 636f 6f64 696e specified coodin │ │ │ │ │ -0000dfe0: 6174 6573 2e20 2049 6620 676c 7970 680a ates. If glyph. │ │ │ │ │ -0000dff0: 2020 2020 2069 7320 6174 2065 6467 6520 is at edge │ │ │ │ │ -0000e000: 6f66 2076 6965 7770 6f72 742c 2070 6978 of viewport, pix │ │ │ │ │ -0000e010: 656c 7320 6f75 7473 6964 6520 6f66 2076 els outside of v │ │ │ │ │ -0000e020: 6965 7770 6f72 7420 7769 6c6c 2062 6520 iewport will be │ │ │ │ │ -0000e030: 636c 6970 7065 640a 2020 2020 206f 7574 clipped. out │ │ │ │ │ -0000e040: 2e20 2053 6f66 7477 6172 6520 6465 7665 . Software deve │ │ │ │ │ -0000e050: 6c6f 7065 7220 7368 6f75 6c64 2075 7365 loper should use │ │ │ │ │ -0000e060: 2065 6974 6865 7220 2767 7275 625f 7669 either 'grub_vi │ │ │ │ │ -0000e070: 6465 6f5f 6d61 705f 7267 6227 206f 720a deo_map_rgb' or. │ │ │ │ │ -0000e080: 2020 2020 2027 6772 7562 5f76 6964 656f 'grub_video │ │ │ │ │ -0000e090: 5f6d 6170 5f72 6762 6127 2074 6f20 6d61 _map_rgba' to ma │ │ │ │ │ -0000e0a0: 7020 7265 7175 6573 7465 6420 636f 6c6f p requested colo │ │ │ │ │ -0000e0b0: 7220 746f 2027 636f 6c6f 7227 2070 6172 r to 'color' par │ │ │ │ │ -0000e0c0: 616d 6574 6572 2e0a 0a31 302e 312e 3139 ameter...10.1.19 │ │ │ │ │ -0000e0d0: 2067 7275 625f 7669 6465 6f5f 626c 6974 grub_video_blit │ │ │ │ │ -0000e0e0: 5f62 6974 6d61 700a 2d2d 2d2d 2d2d 2d2d _bitmap.-------- │ │ │ │ │ +0000d7b0: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ │ +0000d7c0: 7970 653a 0a0a 2020 2020 2020 2020 2020 ype:.. │ │ │ │ │ +0000d7d0: 6772 7562 5f76 6964 656f 5f63 6f6c 6f72 grub_video_color │ │ │ │ │ +0000d7e0: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ │ +0000d7f0: 625f 7669 6465 6f5f 6d61 705f 7267 6261 b_video_map_rgba │ │ │ │ │ +0000d800: 2028 6772 7562 5f75 696e 7438 5f74 2072 (grub_uint8_t r │ │ │ │ │ +0000d810: 6564 2c20 6772 7562 5f75 696e 7438 5f74 ed, grub_uint8_t │ │ │ │ │ +0000d820: 2067 7265 656e 2c20 6772 7562 5f75 696e green, grub_uin │ │ │ │ │ +0000d830: 7438 5f74 2062 6c75 652c 2067 7275 625f t8_t blue, grub_ │ │ │ │ │ +0000d840: 7569 6e74 385f 7420 616c 7068 6129 3b0a uint8_t alpha);. │ │ │ │ │ +0000d850: 2020 202a 2044 6573 6372 6970 7469 6f6e * Description │ │ │ │ │ +0000d860: 3a0a 0a20 2020 2020 4d61 7020 5247 4241 :.. Map RGBA │ │ │ │ │ +0000d870: 2076 616c 7565 7320 746f 2063 6f6d 7061 values to compa │ │ │ │ │ +0000d880: 7469 626c 6520 7363 7265 656e 2063 6f6c tible screen col │ │ │ │ │ +0000d890: 6f72 2064 6174 612e 2020 5661 6c75 6573 or data. Values │ │ │ │ │ +0000d8a0: 2061 7265 0a20 2020 2020 6578 7065 6374 are. expect │ │ │ │ │ +0000d8b0: 6564 2074 6f20 6265 2069 6e20 7261 6e67 ed to be in rang │ │ │ │ │ +0000d8c0: 6520 302d 3235 352e 2020 496e 2052 4742 e 0-255. In RGB │ │ │ │ │ +0000d8d0: 4120 6d6f 6465 7320 7468 6579 2077 696c A modes they wil │ │ │ │ │ +0000d8e0: 6c20 6265 0a20 2020 2020 636f 6e76 6572 l be. conver │ │ │ │ │ +0000d8f0: 7465 6420 746f 2073 6372 6565 6e20 636f ted to screen co │ │ │ │ │ +0000d900: 6c6f 7220 6461 7461 2e20 2049 6e20 696e lor data. In in │ │ │ │ │ +0000d910: 6465 7820 636f 6c6f 7220 6d6f 6465 732c dex color modes, │ │ │ │ │ +0000d920: 2069 6e64 6578 2063 6f6c 6f72 0a20 2020 index color. │ │ │ │ │ +0000d930: 2020 7061 6c65 7474 6520 7769 6c6c 2062 palette will b │ │ │ │ │ +0000d940: 6520 7365 6172 6368 6564 2066 6f72 2062 e searched for b │ │ │ │ │ +0000d950: 6573 7420 6d61 7463 6869 6e67 2063 6f6c est matching col │ │ │ │ │ +0000d960: 6f72 2061 6e64 2069 7473 2069 6e64 6578 or and its index │ │ │ │ │ +0000d970: 2069 730a 2020 2020 2072 6574 7572 6e65 is. returne │ │ │ │ │ +0000d980: 642e 0a0a 3130 2e31 2e31 3620 6772 7562 d...10.1.16 grub │ │ │ │ │ +0000d990: 5f76 6964 656f 5f75 6e6d 6170 5f63 6f6c _video_unmap_col │ │ │ │ │ +0000d9a0: 6f72 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d or.------------- │ │ │ │ │ +0000d9b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0000d9c0: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ +0000d9d0: 653a 0a0a 2020 2020 2020 2020 2020 6772 e:.. gr │ │ │ │ │ +0000d9e0: 7562 5f65 7272 5f74 0a20 2020 2020 2020 ub_err_t. │ │ │ │ │ +0000d9f0: 2020 2067 7275 625f 7669 6465 6f5f 756e grub_video_un │ │ │ │ │ +0000da00: 6d61 705f 636f 6c6f 7220 2867 7275 625f map_color (grub_ │ │ │ │ │ +0000da10: 7669 6465 6f5f 636f 6c6f 725f 7420 636f video_color_t co │ │ │ │ │ +0000da20: 6c6f 722c 2067 7275 625f 7569 6e74 385f lor, grub_uint8_ │ │ │ │ │ +0000da30: 7420 2a72 6564 2c20 6772 7562 5f75 696e t *red, grub_uin │ │ │ │ │ +0000da40: 7438 5f74 202a 6772 6565 6e2c 2067 7275 t8_t *green, gru │ │ │ │ │ +0000da50: 625f 7569 6e74 385f 7420 2a62 6c75 652c b_uint8_t *blue, │ │ │ │ │ +0000da60: 2067 7275 625f 7569 6e74 385f 7420 2a61 grub_uint8_t *a │ │ │ │ │ +0000da70: 6c70 6861 293b 0a20 2020 2a20 4465 7363 lpha);. * Desc │ │ │ │ │ +0000da80: 7269 7074 696f 6e3a 0a0a 2020 2020 2055 ription:.. U │ │ │ │ │ +0000da90: 6e6d 6170 2063 6f6c 6f72 2076 616c 7565 nmap color value │ │ │ │ │ +0000daa0: 2066 726f 6d20 2763 6f6c 6f72 2720 746f from 'color' to │ │ │ │ │ +0000dab0: 2063 6f6c 6f72 2063 6861 6e6e 656c 7320 color channels │ │ │ │ │ +0000dac0: 696e 2027 7265 6427 2c20 2767 7265 656e in 'red', 'green │ │ │ │ │ +0000dad0: 272c 0a20 2020 2020 2762 6c75 6527 2061 ',. 'blue' a │ │ │ │ │ +0000dae0: 6e64 2027 616c 7068 6127 2e20 2056 616c nd 'alpha'. Val │ │ │ │ │ +0000daf0: 7565 7320 7769 6c6c 2062 6520 696e 2072 ues will be in r │ │ │ │ │ +0000db00: 616e 6765 2030 2d32 3535 2e20 2041 6374 ange 0-255. Act │ │ │ │ │ +0000db10: 6976 650a 2020 2020 2072 656e 6465 7269 ive. renderi │ │ │ │ │ +0000db20: 6e67 2074 6172 6765 7420 7769 6c6c 2062 ng target will b │ │ │ │ │ +0000db30: 6520 7573 6564 2066 6f72 2063 6f6c 6f72 e used for color │ │ │ │ │ +0000db40: 2064 6f6d 6169 6e2e 2020 496e 2063 6173 domain. In cas │ │ │ │ │ +0000db50: 6520 616c 7068 610a 2020 2020 2069 6e66 e alpha. inf │ │ │ │ │ +0000db60: 6f72 6d61 7469 6f6e 2069 7320 6e6f 7420 ormation is not │ │ │ │ │ +0000db70: 6176 6169 6c61 626c 6520 696e 2072 656e available in ren │ │ │ │ │ +0000db80: 6465 7269 6e67 2074 6172 6765 742c 2069 dering target, i │ │ │ │ │ +0000db90: 7420 6973 2061 7373 756d 6564 2074 6f0a t is assumed to. │ │ │ │ │ +0000dba0: 2020 2020 2062 6520 6f70 6171 7565 2028 be opaque ( │ │ │ │ │ +0000dbb0: 6861 7669 6e67 2076 616c 7565 2032 3535 having value 255 │ │ │ │ │ +0000dbc0: 292e 0a0a 3130 2e31 2e31 3720 6772 7562 )...10.1.17 grub │ │ │ │ │ +0000dbd0: 5f76 6964 656f 5f66 696c 6c5f 7265 6374 _video_fill_rect │ │ │ │ │ +0000dbe0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +0000dbf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +0000dc00: 2020 2a20 5072 6f74 6f74 7970 653a 0a0a * Prototype:.. │ │ │ │ │ +0000dc10: 2020 2020 2020 2020 2020 6772 7562 5f65 grub_e │ │ │ │ │ +0000dc20: 7272 5f74 0a20 2020 2020 2020 2020 2067 rr_t. g │ │ │ │ │ +0000dc30: 7275 625f 7669 6465 6f5f 6669 6c6c 5f72 rub_video_fill_r │ │ │ │ │ +0000dc40: 6563 7420 2867 7275 625f 7669 6465 6f5f ect (grub_video_ │ │ │ │ │ +0000dc50: 636f 6c6f 725f 7420 636f 6c6f 722c 2069 color_t color, i │ │ │ │ │ +0000dc60: 6e74 2078 2c20 696e 7420 792c 2075 6e73 nt x, int y, uns │ │ │ │ │ +0000dc70: 6967 6e65 6420 696e 7420 7769 6474 682c igned int width, │ │ │ │ │ +0000dc80: 2075 6e73 6967 6e65 6420 696e 7420 6865 unsigned int he │ │ │ │ │ +0000dc90: 6967 6874 293b 0a20 2020 2a20 4465 7363 ight);. * Desc │ │ │ │ │ +0000dca0: 7269 7074 696f 6e3a 0a0a 2020 2020 2046 ription:.. F │ │ │ │ │ +0000dcb0: 696c 6c20 7370 6563 6966 6965 6420 6172 ill specified ar │ │ │ │ │ +0000dcc0: 6561 206c 696d 6974 6564 2062 7920 6769 ea limited by gi │ │ │ │ │ +0000dcd0: 7665 6e20 636f 6f72 6469 6e61 7465 7320 ven coordinates │ │ │ │ │ +0000dce0: 7769 7468 696e 2073 7065 6369 6669 6564 within specified │ │ │ │ │ +0000dcf0: 0a20 2020 2020 7669 6577 706f 7274 2e20 . viewport. │ │ │ │ │ +0000dd00: 204e 6567 6174 6976 6520 636f 6f72 6469 Negative coordi │ │ │ │ │ +0000dd10: 6e61 7465 7320 6172 6520 6163 6365 7074 nates are accept │ │ │ │ │ +0000dd20: 6564 2069 6e20 6f72 6465 7220 746f 2061 ed in order to a │ │ │ │ │ +0000dd30: 6c6c 6f77 2065 6173 790a 2020 2020 206d llow easy. m │ │ │ │ │ +0000dd40: 6f76 696e 6720 6f66 2072 6563 7461 6e67 oving of rectang │ │ │ │ │ +0000dd50: 6c65 2077 6974 6869 6e20 7669 6577 706f le within viewpo │ │ │ │ │ +0000dd60: 7274 2e20 2049 6620 636f 6f72 6469 6e61 rt. If coordina │ │ │ │ │ +0000dd70: 7465 7320 6172 6520 6e65 6761 7469 7665 tes are negative │ │ │ │ │ +0000dd80: 2c0a 2020 2020 2061 7265 6120 6f66 2074 ,. area of t │ │ │ │ │ +0000dd90: 6865 2072 6563 7461 6e67 6c65 2077 696c he rectangle wil │ │ │ │ │ +0000dda0: 6c20 6265 2073 6872 696e 6b65 6e20 746f l be shrinken to │ │ │ │ │ +0000ddb0: 2066 6f6c 6c6f 7720 7369 7a65 206c 696d follow size lim │ │ │ │ │ +0000ddc0: 6974 7320 6f66 2074 6865 0a20 2020 2020 its of the. │ │ │ │ │ +0000ddd0: 7669 6577 706f 7274 2e0a 0a20 2020 2020 viewport... │ │ │ │ │ +0000dde0: 536f 6674 7761 7265 2064 6576 656c 6f70 Software develop │ │ │ │ │ +0000ddf0: 6572 2073 686f 756c 6420 7573 6520 6569 er should use ei │ │ │ │ │ +0000de00: 7468 6572 2027 6772 7562 5f76 6964 656f ther 'grub_video │ │ │ │ │ +0000de10: 5f6d 6170 5f63 6f6c 6f72 272c 0a20 2020 _map_color',. │ │ │ │ │ +0000de20: 2020 2767 7275 625f 7669 6465 6f5f 6d61 'grub_video_ma │ │ │ │ │ +0000de30: 705f 7267 6227 206f 7220 2767 7275 625f p_rgb' or 'grub_ │ │ │ │ │ +0000de40: 7669 6465 6f5f 6d61 705f 7267 6261 2720 video_map_rgba' │ │ │ │ │ +0000de50: 746f 206d 6170 2072 6571 7565 7374 6564 to map requested │ │ │ │ │ +0000de60: 0a20 2020 2020 636f 6c6f 7220 746f 2027 . color to ' │ │ │ │ │ +0000de70: 636f 6c6f 7227 2070 6172 616d 6574 6572 color' parameter │ │ │ │ │ +0000de80: 2e0a 0a31 302e 312e 3138 2067 7275 625f ...10.1.18 grub_ │ │ │ │ │ +0000de90: 7669 6465 6f5f 626c 6974 5f67 6c79 7068 video_blit_glyph │ │ │ │ │ +0000dea0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +0000deb0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0000dec0: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ +0000ded0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +0000dee0: 6572 725f 740a 2020 2020 2020 2020 2020 err_t. │ │ │ │ │ +0000def0: 6772 7562 5f76 6964 656f 5f62 6c69 745f grub_video_blit_ │ │ │ │ │ +0000df00: 676c 7970 6820 2873 7472 7563 7420 6772 glyph (struct gr │ │ │ │ │ +0000df10: 7562 5f66 6f6e 745f 676c 7970 6820 2a67 ub_font_glyph *g │ │ │ │ │ +0000df20: 6c79 7068 2c20 6772 7562 5f76 6964 656f lyph, grub_video │ │ │ │ │ +0000df30: 5f63 6f6c 6f72 5f74 2063 6f6c 6f72 2c20 _color_t color, │ │ │ │ │ +0000df40: 696e 7420 782c 2069 6e74 2079 293b 0a20 int x, int y);. │ │ │ │ │ +0000df50: 2020 2020 2020 2020 2073 7472 7563 7420 struct │ │ │ │ │ +0000df60: 6772 7562 5f66 6f6e 745f 676c 7970 6820 grub_font_glyph │ │ │ │ │ +0000df70: 7b0a 2020 2020 2020 2020 2020 2020 2020 {. │ │ │ │ │ +0000df80: 2f2a 2054 4244 2e20 2a2f 0a20 2020 2020 /* TBD. */. │ │ │ │ │ +0000df90: 2020 2020 207d 3b0a 2020 202a 2044 6573 };. * Des │ │ │ │ │ +0000dfa0: 6372 6970 7469 6f6e 3a0a 0a20 2020 2020 cription:.. │ │ │ │ │ +0000dfb0: 5573 6564 2074 6f20 626c 6974 2067 6c79 Used to blit gly │ │ │ │ │ +0000dfc0: 7068 2074 6f20 7669 6577 706f 7274 2069 ph to viewport i │ │ │ │ │ +0000dfd0: 6e20 7370 6563 6966 6965 6420 636f 6f64 n specified cood │ │ │ │ │ +0000dfe0: 696e 6174 6573 2e20 2049 6620 676c 7970 inates. If glyp │ │ │ │ │ +0000dff0: 680a 2020 2020 2069 7320 6174 2065 6467 h. is at edg │ │ │ │ │ +0000e000: 6520 6f66 2076 6965 7770 6f72 742c 2070 e of viewport, p │ │ │ │ │ +0000e010: 6978 656c 7320 6f75 7473 6964 6520 6f66 ixels outside of │ │ │ │ │ +0000e020: 2076 6965 7770 6f72 7420 7769 6c6c 2062 viewport will b │ │ │ │ │ +0000e030: 6520 636c 6970 7065 640a 2020 2020 206f e clipped. o │ │ │ │ │ +0000e040: 7574 2e20 2053 6f66 7477 6172 6520 6465 ut. Software de │ │ │ │ │ +0000e050: 7665 6c6f 7065 7220 7368 6f75 6c64 2075 veloper should u │ │ │ │ │ +0000e060: 7365 2065 6974 6865 7220 2767 7275 625f se either 'grub_ │ │ │ │ │ +0000e070: 7669 6465 6f5f 6d61 705f 7267 6227 206f video_map_rgb' o │ │ │ │ │ +0000e080: 720a 2020 2020 2027 6772 7562 5f76 6964 r. 'grub_vid │ │ │ │ │ +0000e090: 656f 5f6d 6170 5f72 6762 6127 2074 6f20 eo_map_rgba' to │ │ │ │ │ +0000e0a0: 6d61 7020 7265 7175 6573 7465 6420 636f map requested co │ │ │ │ │ +0000e0b0: 6c6f 7220 746f 2027 636f 6c6f 7227 2070 lor to 'color' p │ │ │ │ │ +0000e0c0: 6172 616d 6574 6572 2e0a 0a31 302e 312e arameter...10.1. │ │ │ │ │ +0000e0d0: 3139 2067 7275 625f 7669 6465 6f5f 626c 19 grub_video_bl │ │ │ │ │ +0000e0e0: 6974 5f62 6974 6d61 700a 2d2d 2d2d 2d2d it_bitmap.------ │ │ │ │ │ 0000e0f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000e100: 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 726f ------.. * Pro │ │ │ │ │ -0000e110: 746f 7479 7065 3a0a 0a20 2020 2020 2020 totype:.. │ │ │ │ │ -0000e120: 2020 2067 7275 625f 6572 725f 740a 2020 grub_err_t. │ │ │ │ │ -0000e130: 2020 2020 2020 2020 6772 7562 5f76 6964 grub_vid │ │ │ │ │ -0000e140: 656f 5f62 6c69 745f 6269 746d 6170 2028 eo_blit_bitmap ( │ │ │ │ │ -0000e150: 7374 7275 6374 2067 7275 625f 7669 6465 struct grub_vide │ │ │ │ │ -0000e160: 6f5f 6269 746d 6170 202a 6269 746d 6170 o_bitmap *bitmap │ │ │ │ │ -0000e170: 2c20 656e 756d 2067 7275 625f 7669 6465 , enum grub_vide │ │ │ │ │ -0000e180: 6f5f 626c 6974 5f6f 7065 7261 746f 7273 o_blit_operators │ │ │ │ │ -0000e190: 206f 7065 722c 2069 6e74 2078 2c20 696e oper, int x, in │ │ │ │ │ -0000e1a0: 7420 792c 2069 6e74 206f 6666 7365 745f t y, int offset_ │ │ │ │ │ -0000e1b0: 782c 2069 6e74 206f 6666 7365 745f 792c x, int offset_y, │ │ │ │ │ -0000e1c0: 2075 6e73 6967 6e65 6420 696e 7420 7769 unsigned int wi │ │ │ │ │ -0000e1d0: 6474 682c 2075 6e73 6967 6e65 6420 696e dth, unsigned in │ │ │ │ │ -0000e1e0: 7420 6865 6967 6874 293b 0a20 2020 2020 t height);. │ │ │ │ │ -0000e1f0: 2020 2020 2073 7472 7563 7420 6772 7562 struct grub │ │ │ │ │ -0000e200: 5f76 6964 656f 5f62 6974 6d61 700a 2020 _video_bitmap. │ │ │ │ │ -0000e210: 2020 2020 2020 2020 7b0a 2020 2020 2020 {. │ │ │ │ │ -0000e220: 2020 2020 2020 2020 2f2a 2054 4244 2e20 /* TBD. │ │ │ │ │ -0000e230: 2a2f 0a20 2020 2020 2020 2020 207d 3b0a */. };. │ │ │ │ │ -0000e240: 0a20 2020 2020 2020 2020 2065 6e75 6d20 . enum │ │ │ │ │ -0000e250: 6772 7562 5f76 6964 656f 5f62 6c69 745f grub_video_blit_ │ │ │ │ │ -0000e260: 6f70 6572 6174 6f72 730a 2020 2020 2020 operators. │ │ │ │ │ -0000e270: 2020 2020 2020 7b0a 2020 2020 2020 2020 {. │ │ │ │ │ -0000e280: 2020 2020 2020 4752 5542 5f56 4944 454f GRUB_VIDEO │ │ │ │ │ -0000e290: 5f42 4c49 545f 5245 504c 4143 452c 0a20 _BLIT_REPLACE,. │ │ │ │ │ -0000e2a0: 2020 2020 2020 2020 2020 2020 2047 5255 GRU │ │ │ │ │ -0000e2b0: 425f 5649 4445 4f5f 424c 4954 5f42 4c45 B_VIDEO_BLIT_BLE │ │ │ │ │ -0000e2c0: 4e44 0a20 2020 2020 2020 2020 2020 207d ND. } │ │ │ │ │ -0000e2d0: 3b0a 2020 202a 2044 6573 6372 6970 7469 ;. * Descripti │ │ │ │ │ -0000e2e0: 6f6e 3a0a 0a20 2020 2020 5573 6564 2074 on:.. Used t │ │ │ │ │ -0000e2f0: 6f20 626c 6974 2062 6974 6d61 7020 746f o blit bitmap to │ │ │ │ │ -0000e300: 2076 6965 7770 6f72 7420 696e 2073 7065 viewport in spe │ │ │ │ │ -0000e310: 6369 6669 6564 2063 6f6f 7264 696e 6174 cified coordinat │ │ │ │ │ -0000e320: 6573 2e20 2049 6620 7061 7274 0a20 2020 es. If part. │ │ │ │ │ -0000e330: 2020 6f66 2062 6974 6d61 7020 6973 206f of bitmap is o │ │ │ │ │ -0000e340: 7574 7369 6465 206f 6620 7669 6577 706f utside of viewpo │ │ │ │ │ -0000e350: 7274 2072 6567 696f 6e2c 2069 7420 7769 rt region, it wi │ │ │ │ │ -0000e360: 6c6c 2062 6520 636c 6970 7065 6420 6f75 ll be clipped ou │ │ │ │ │ -0000e370: 742e 0a20 2020 2020 4f66 6673 6574 7320 t.. Offsets │ │ │ │ │ -0000e380: 6166 6665 6374 2062 6974 6d61 7020 706f affect bitmap po │ │ │ │ │ -0000e390: 7369 7469 6f6e 2077 6865 7265 2064 6174 sition where dat │ │ │ │ │ -0000e3a0: 6120 7769 6c6c 2062 6520 636f 7069 6564 a will be copied │ │ │ │ │ -0000e3b0: 2066 726f 6d2e 0a20 2020 2020 4e65 6761 from.. Nega │ │ │ │ │ -0000e3c0: 7469 7665 2076 616c 7565 7320 666f 7220 tive values for │ │ │ │ │ -0000e3d0: 626f 7468 2076 6965 7770 6f72 7420 636f both viewport co │ │ │ │ │ -0000e3e0: 6f72 6469 6e61 7465 7320 616e 6420 6269 ordinates and bi │ │ │ │ │ -0000e3f0: 746d 6170 206f 6666 7365 740a 2020 2020 tmap offset. │ │ │ │ │ -0000e400: 2063 6f6f 7264 696e 6174 6573 2061 7265 coordinates are │ │ │ │ │ -0000e410: 2061 6c6c 6f77 6564 2e20 2049 6620 6461 allowed. If da │ │ │ │ │ -0000e420: 7461 2069 7320 6c6f 6f6b 6564 206f 7574 ta is looked out │ │ │ │ │ -0000e430: 206f 6620 626f 756e 6473 206f 660a 2020 of bounds of. │ │ │ │ │ -0000e440: 2020 2062 6974 6d61 702c 2063 6f6c 6f72 bitmap, color │ │ │ │ │ -0000e450: 2076 616c 7565 2077 696c 6c20 6265 2061 value will be a │ │ │ │ │ -0000e460: 7373 756d 6564 2074 6f20 6265 2074 7261 ssumed to be tra │ │ │ │ │ -0000e470: 6e73 7061 7265 6e74 2e20 2049 6620 7669 nsparent. If vi │ │ │ │ │ -0000e480: 6577 706f 7274 0a20 2020 2020 636f 6f72 ewport. coor │ │ │ │ │ -0000e490: 6469 6e61 7465 7320 6172 6520 6e65 6761 dinates are nega │ │ │ │ │ -0000e4a0: 7469 7665 2c20 6172 6561 206f 6620 7468 tive, area of th │ │ │ │ │ -0000e4b0: 6520 626c 6974 7465 6420 7265 6374 616e e blitted rectan │ │ │ │ │ -0000e4c0: 676c 6520 7769 6c6c 2062 650a 2020 2020 gle will be. │ │ │ │ │ -0000e4d0: 2073 6872 696e 6b65 6e20 746f 2066 6f6c shrinken to fol │ │ │ │ │ -0000e4e0: 6c6f 7720 7369 7a65 206c 696d 6974 7320 low size limits │ │ │ │ │ -0000e4f0: 6f66 2074 6865 2076 6965 7770 6f72 7420 of the viewport │ │ │ │ │ -0000e500: 616e 6420 6269 746d 6170 2e0a 2020 2020 and bitmap.. │ │ │ │ │ -0000e510: 2042 6c69 7474 696e 6720 6f70 6572 6174 Blitting operat │ │ │ │ │ -0000e520: 6f72 2027 6f70 6572 2720 7370 6563 6966 or 'oper' specif │ │ │ │ │ -0000e530: 6965 7320 7368 6f75 6c64 2073 6f75 7263 ies should sourc │ │ │ │ │ -0000e540: 6520 7069 7865 6c20 7265 706c 6163 6520 e pixel replace │ │ │ │ │ -0000e550: 6461 7461 0a20 2020 2020 696e 2073 6372 data. in scr │ │ │ │ │ -0000e560: 6565 6e20 6f72 2062 6c65 6e64 2077 6974 een or blend wit │ │ │ │ │ -0000e570: 6820 7069 7865 6c20 616c 7068 6120 7661 h pixel alpha va │ │ │ │ │ -0000e580: 6c75 652e 0a0a 2020 2020 2053 6f66 7477 lue... Softw │ │ │ │ │ -0000e590: 6172 6520 6465 7665 6c6f 7065 7220 7368 are developer sh │ │ │ │ │ -0000e5a0: 6f75 6c64 2075 7365 2027 6772 7562 5f76 ould use 'grub_v │ │ │ │ │ -0000e5b0: 6964 656f 5f62 6974 6d61 705f 6372 6561 ideo_bitmap_crea │ │ │ │ │ -0000e5c0: 7465 2720 6f72 0a20 2020 2020 2767 7275 te' or. 'gru │ │ │ │ │ -0000e5d0: 625f 7669 6465 6f5f 6269 746d 6170 5f6c b_video_bitmap_l │ │ │ │ │ -0000e5e0: 6f61 6427 2074 6f20 6372 6561 7465 206f oad' to create o │ │ │ │ │ -0000e5f0: 7220 6c6f 6164 2062 6974 6d61 7020 6461 r load bitmap da │ │ │ │ │ -0000e600: 7461 2e0a 0a31 302e 312e 3230 2067 7275 ta...10.1.20 gru │ │ │ │ │ -0000e610: 625f 7669 6465 6f5f 626c 6974 5f72 656e b_video_blit_ren │ │ │ │ │ -0000e620: 6465 725f 7461 7267 6574 0a2d 2d2d 2d2d der_target.----- │ │ │ │ │ +0000e100: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 --------.. * P │ │ │ │ │ +0000e110: 726f 746f 7479 7065 3a0a 0a20 2020 2020 rototype:.. │ │ │ │ │ +0000e120: 2020 2020 2067 7275 625f 6572 725f 740a grub_err_t. │ │ │ │ │ +0000e130: 2020 2020 2020 2020 2020 6772 7562 5f76 grub_v │ │ │ │ │ +0000e140: 6964 656f 5f62 6c69 745f 6269 746d 6170 ideo_blit_bitmap │ │ │ │ │ +0000e150: 2028 7374 7275 6374 2067 7275 625f 7669 (struct grub_vi │ │ │ │ │ +0000e160: 6465 6f5f 6269 746d 6170 202a 6269 746d deo_bitmap *bitm │ │ │ │ │ +0000e170: 6170 2c20 656e 756d 2067 7275 625f 7669 ap, enum grub_vi │ │ │ │ │ +0000e180: 6465 6f5f 626c 6974 5f6f 7065 7261 746f deo_blit_operato │ │ │ │ │ +0000e190: 7273 206f 7065 722c 2069 6e74 2078 2c20 rs oper, int x, │ │ │ │ │ +0000e1a0: 696e 7420 792c 2069 6e74 206f 6666 7365 int y, int offse │ │ │ │ │ +0000e1b0: 745f 782c 2069 6e74 206f 6666 7365 745f t_x, int offset_ │ │ │ │ │ +0000e1c0: 792c 2075 6e73 6967 6e65 6420 696e 7420 y, unsigned int │ │ │ │ │ +0000e1d0: 7769 6474 682c 2075 6e73 6967 6e65 6420 width, unsigned │ │ │ │ │ +0000e1e0: 696e 7420 6865 6967 6874 293b 0a20 2020 int height);. │ │ │ │ │ +0000e1f0: 2020 2020 2020 2073 7472 7563 7420 6772 struct gr │ │ │ │ │ +0000e200: 7562 5f76 6964 656f 5f62 6974 6d61 700a ub_video_bitmap. │ │ │ │ │ +0000e210: 2020 2020 2020 2020 2020 7b0a 2020 2020 {. │ │ │ │ │ +0000e220: 2020 2020 2020 2020 2020 2f2a 2054 4244 /* TBD │ │ │ │ │ +0000e230: 2e20 2a2f 0a20 2020 2020 2020 2020 207d . */. } │ │ │ │ │ +0000e240: 3b0a 0a20 2020 2020 2020 2020 2065 6e75 ;.. enu │ │ │ │ │ +0000e250: 6d20 6772 7562 5f76 6964 656f 5f62 6c69 m grub_video_bli │ │ │ │ │ +0000e260: 745f 6f70 6572 6174 6f72 730a 2020 2020 t_operators. │ │ │ │ │ +0000e270: 2020 2020 2020 2020 7b0a 2020 2020 2020 {. │ │ │ │ │ +0000e280: 2020 2020 2020 2020 4752 5542 5f56 4944 GRUB_VID │ │ │ │ │ +0000e290: 454f 5f42 4c49 545f 5245 504c 4143 452c EO_BLIT_REPLACE, │ │ │ │ │ +0000e2a0: 0a20 2020 2020 2020 2020 2020 2020 2047 . G │ │ │ │ │ +0000e2b0: 5255 425f 5649 4445 4f5f 424c 4954 5f42 RUB_VIDEO_BLIT_B │ │ │ │ │ +0000e2c0: 4c45 4e44 0a20 2020 2020 2020 2020 2020 LEND. │ │ │ │ │ +0000e2d0: 207d 3b0a 2020 202a 2044 6573 6372 6970 };. * Descrip │ │ │ │ │ +0000e2e0: 7469 6f6e 3a0a 0a20 2020 2020 5573 6564 tion:.. Used │ │ │ │ │ +0000e2f0: 2074 6f20 626c 6974 2062 6974 6d61 7020 to blit bitmap │ │ │ │ │ +0000e300: 746f 2076 6965 7770 6f72 7420 696e 2073 to viewport in s │ │ │ │ │ +0000e310: 7065 6369 6669 6564 2063 6f6f 7264 696e pecified coordin │ │ │ │ │ +0000e320: 6174 6573 2e20 2049 6620 7061 7274 0a20 ates. If part. │ │ │ │ │ +0000e330: 2020 2020 6f66 2062 6974 6d61 7020 6973 of bitmap is │ │ │ │ │ +0000e340: 206f 7574 7369 6465 206f 6620 7669 6577 outside of view │ │ │ │ │ +0000e350: 706f 7274 2072 6567 696f 6e2c 2069 7420 port region, it │ │ │ │ │ +0000e360: 7769 6c6c 2062 6520 636c 6970 7065 6420 will be clipped │ │ │ │ │ +0000e370: 6f75 742e 0a20 2020 2020 4f66 6673 6574 out.. Offset │ │ │ │ │ +0000e380: 7320 6166 6665 6374 2062 6974 6d61 7020 s affect bitmap │ │ │ │ │ +0000e390: 706f 7369 7469 6f6e 2077 6865 7265 2064 position where d │ │ │ │ │ +0000e3a0: 6174 6120 7769 6c6c 2062 6520 636f 7069 ata will be copi │ │ │ │ │ +0000e3b0: 6564 2066 726f 6d2e 0a20 2020 2020 4e65 ed from.. Ne │ │ │ │ │ +0000e3c0: 6761 7469 7665 2076 616c 7565 7320 666f gative values fo │ │ │ │ │ +0000e3d0: 7220 626f 7468 2076 6965 7770 6f72 7420 r both viewport │ │ │ │ │ +0000e3e0: 636f 6f72 6469 6e61 7465 7320 616e 6420 coordinates and │ │ │ │ │ +0000e3f0: 6269 746d 6170 206f 6666 7365 740a 2020 bitmap offset. │ │ │ │ │ +0000e400: 2020 2063 6f6f 7264 696e 6174 6573 2061 coordinates a │ │ │ │ │ +0000e410: 7265 2061 6c6c 6f77 6564 2e20 2049 6620 re allowed. If │ │ │ │ │ +0000e420: 6461 7461 2069 7320 6c6f 6f6b 6564 206f data is looked o │ │ │ │ │ +0000e430: 7574 206f 6620 626f 756e 6473 206f 660a ut of bounds of. │ │ │ │ │ +0000e440: 2020 2020 2062 6974 6d61 702c 2063 6f6c bitmap, col │ │ │ │ │ +0000e450: 6f72 2076 616c 7565 2077 696c 6c20 6265 or value will be │ │ │ │ │ +0000e460: 2061 7373 756d 6564 2074 6f20 6265 2074 assumed to be t │ │ │ │ │ +0000e470: 7261 6e73 7061 7265 6e74 2e20 2049 6620 ransparent. If │ │ │ │ │ +0000e480: 7669 6577 706f 7274 0a20 2020 2020 636f viewport. co │ │ │ │ │ +0000e490: 6f72 6469 6e61 7465 7320 6172 6520 6e65 ordinates are ne │ │ │ │ │ +0000e4a0: 6761 7469 7665 2c20 6172 6561 206f 6620 gative, area of │ │ │ │ │ +0000e4b0: 7468 6520 626c 6974 7465 6420 7265 6374 the blitted rect │ │ │ │ │ +0000e4c0: 616e 676c 6520 7769 6c6c 2062 650a 2020 angle will be. │ │ │ │ │ +0000e4d0: 2020 2073 6872 696e 6b65 6e20 746f 2066 shrinken to f │ │ │ │ │ +0000e4e0: 6f6c 6c6f 7720 7369 7a65 206c 696d 6974 ollow size limit │ │ │ │ │ +0000e4f0: 7320 6f66 2074 6865 2076 6965 7770 6f72 s of the viewpor │ │ │ │ │ +0000e500: 7420 616e 6420 6269 746d 6170 2e0a 2020 t and bitmap.. │ │ │ │ │ +0000e510: 2020 2042 6c69 7474 696e 6720 6f70 6572 Blitting oper │ │ │ │ │ +0000e520: 6174 6f72 2027 6f70 6572 2720 7370 6563 ator 'oper' spec │ │ │ │ │ +0000e530: 6966 6965 7320 7368 6f75 6c64 2073 6f75 ifies should sou │ │ │ │ │ +0000e540: 7263 6520 7069 7865 6c20 7265 706c 6163 rce pixel replac │ │ │ │ │ +0000e550: 6520 6461 7461 0a20 2020 2020 696e 2073 e data. in s │ │ │ │ │ +0000e560: 6372 6565 6e20 6f72 2062 6c65 6e64 2077 creen or blend w │ │ │ │ │ +0000e570: 6974 6820 7069 7865 6c20 616c 7068 6120 ith pixel alpha │ │ │ │ │ +0000e580: 7661 6c75 652e 0a0a 2020 2020 2053 6f66 value... Sof │ │ │ │ │ +0000e590: 7477 6172 6520 6465 7665 6c6f 7065 7220 tware developer │ │ │ │ │ +0000e5a0: 7368 6f75 6c64 2075 7365 2027 6772 7562 should use 'grub │ │ │ │ │ +0000e5b0: 5f76 6964 656f 5f62 6974 6d61 705f 6372 _video_bitmap_cr │ │ │ │ │ +0000e5c0: 6561 7465 2720 6f72 0a20 2020 2020 2767 eate' or. 'g │ │ │ │ │ +0000e5d0: 7275 625f 7669 6465 6f5f 6269 746d 6170 rub_video_bitmap │ │ │ │ │ +0000e5e0: 5f6c 6f61 6427 2074 6f20 6372 6561 7465 _load' to create │ │ │ │ │ +0000e5f0: 206f 7220 6c6f 6164 2062 6974 6d61 7020 or load bitmap │ │ │ │ │ +0000e600: 6461 7461 2e0a 0a31 302e 312e 3230 2067 data...10.1.20 g │ │ │ │ │ +0000e610: 7275 625f 7669 6465 6f5f 626c 6974 5f72 rub_video_blit_r │ │ │ │ │ +0000e620: 656e 6465 725f 7461 7267 6574 0a2d 2d2d ender_target.--- │ │ │ │ │ 0000e630: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000e640: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000e650: 0a0a 2020 202a 2050 726f 746f 7479 7065 .. * Prototype │ │ │ │ │ -0000e660: 3a0a 0a20 2020 2020 2020 2020 2067 7275 :.. gru │ │ │ │ │ -0000e670: 625f 6572 725f 740a 2020 2020 2020 2020 b_err_t. │ │ │ │ │ -0000e680: 2020 6772 7562 5f76 6964 656f 5f62 6c69 grub_video_bli │ │ │ │ │ -0000e690: 745f 7265 6e64 6572 5f74 6172 6765 7420 t_render_target │ │ │ │ │ -0000e6a0: 2873 7472 7563 7420 6772 7562 5f76 6964 (struct grub_vid │ │ │ │ │ -0000e6b0: 656f 5f72 656e 6465 725f 7461 7267 6574 eo_render_target │ │ │ │ │ -0000e6c0: 202a 736f 7572 6365 2c20 656e 756d 2067 *source, enum g │ │ │ │ │ -0000e6d0: 7275 625f 7669 6465 6f5f 626c 6974 5f6f rub_video_blit_o │ │ │ │ │ -0000e6e0: 7065 7261 746f 7273 206f 7065 722c 2069 perators oper, i │ │ │ │ │ -0000e6f0: 6e74 2078 2c20 696e 7420 792c 2069 6e74 nt x, int y, int │ │ │ │ │ -0000e700: 206f 6666 7365 745f 782c 2069 6e74 206f offset_x, int o │ │ │ │ │ -0000e710: 6666 7365 745f 792c 2075 6e73 6967 6e65 ffset_y, unsigne │ │ │ │ │ -0000e720: 6420 696e 7420 7769 6474 682c 2075 6e73 d int width, uns │ │ │ │ │ -0000e730: 6967 6e65 6420 696e 7420 6865 6967 6874 igned int height │ │ │ │ │ -0000e740: 293b 0a20 2020 2020 2020 2020 2073 7472 );. str │ │ │ │ │ -0000e750: 7563 7420 6772 7562 5f76 6964 656f 5f72 uct grub_video_r │ │ │ │ │ -0000e760: 656e 6465 725f 7461 7267 6574 207b 0a20 ender_target {. │ │ │ │ │ -0000e770: 2020 2020 2020 2020 2020 2020 202f 2a20 /* │ │ │ │ │ -0000e780: 5468 6973 2069 7320 7072 6976 6174 6520 This is private │ │ │ │ │ -0000e790: 6461 7461 2066 6f72 2076 6964 656f 2064 data for video d │ │ │ │ │ -0000e7a0: 7269 7665 722e 2053 686f 756c 6420 6e6f river. Should no │ │ │ │ │ -0000e7b0: 7420 6265 2061 6363 6573 7365 6420 6672 t be accessed fr │ │ │ │ │ -0000e7c0: 6f6d 2065 6c73 6577 6865 7265 2064 6972 om elsewhere dir │ │ │ │ │ -0000e7d0: 6563 746c 792e 2020 2a2f 0a20 2020 2020 ectly. */. │ │ │ │ │ -0000e7e0: 2020 2020 207d 3b0a 0a20 2020 2020 2020 };.. │ │ │ │ │ -0000e7f0: 2020 2065 6e75 6d20 6772 7562 5f76 6964 enum grub_vid │ │ │ │ │ -0000e800: 656f 5f62 6c69 745f 6f70 6572 6174 6f72 eo_blit_operator │ │ │ │ │ -0000e810: 730a 2020 2020 2020 2020 2020 2020 7b0a s. {. │ │ │ │ │ -0000e820: 2020 2020 2020 2020 2020 2020 2020 4752 GR │ │ │ │ │ -0000e830: 5542 5f56 4944 454f 5f42 4c49 545f 5245 UB_VIDEO_BLIT_RE │ │ │ │ │ -0000e840: 504c 4143 452c 0a20 2020 2020 2020 2020 PLACE,. │ │ │ │ │ -0000e850: 2020 2020 2047 5255 425f 5649 4445 4f5f GRUB_VIDEO_ │ │ │ │ │ -0000e860: 424c 4954 5f42 4c45 4e44 0a20 2020 2020 BLIT_BLEND. │ │ │ │ │ -0000e870: 2020 2020 2020 207d 3b0a 2020 202a 2044 };. * D │ │ │ │ │ -0000e880: 6573 6372 6970 7469 6f6e 3a0a 0a20 2020 escription:.. │ │ │ │ │ -0000e890: 2020 5573 6564 2074 6f20 626c 6974 2073 Used to blit s │ │ │ │ │ -0000e8a0: 6f75 7263 6520 7265 6e64 6572 2074 6172 ource render tar │ │ │ │ │ -0000e8b0: 6765 7420 746f 2076 6965 7770 6f72 7420 get to viewport │ │ │ │ │ -0000e8c0: 696e 2073 7065 6369 6669 6564 0a20 2020 in specified. │ │ │ │ │ -0000e8d0: 2020 636f 6f72 6469 6e61 7465 732e 2020 coordinates. │ │ │ │ │ -0000e8e0: 4966 2070 6172 7420 6f66 2073 6f75 7263 If part of sourc │ │ │ │ │ -0000e8f0: 6520 7265 6e64 6572 2074 6172 6765 7420 e render target │ │ │ │ │ -0000e900: 6973 206f 7574 7369 6465 206f 660a 2020 is outside of. │ │ │ │ │ -0000e910: 2020 2076 6965 7770 6f72 7420 7265 6769 viewport regi │ │ │ │ │ -0000e920: 6f6e 2c20 6974 2077 696c 6c20 6265 2063 on, it will be c │ │ │ │ │ -0000e930: 6c69 7070 6564 206f 7574 2e20 2049 6620 lipped out. If │ │ │ │ │ -0000e940: 626c 6974 7469 6e67 206f 7065 7261 746f blitting operato │ │ │ │ │ -0000e950: 7220 6973 0a20 2020 2020 7370 6563 6966 r is. specif │ │ │ │ │ -0000e960: 6965 6420 616e 6420 736f 7572 6365 2063 ied and source c │ │ │ │ │ -0000e970: 6f6e 7461 696e 7320 616c 7068 6120 7661 ontains alpha va │ │ │ │ │ -0000e980: 6c75 6573 2c20 7265 7375 6c74 696e 6720 lues, resulting │ │ │ │ │ -0000e990: 7069 7865 6c20 636f 6c6f 720a 2020 2020 pixel color. │ │ │ │ │ -0000e9a0: 2063 6f6d 706f 6e65 6e74 7320 7769 6c6c components will │ │ │ │ │ -0000e9b0: 2062 6520 6361 6c63 756c 6174 6564 2075 be calculated u │ │ │ │ │ -0000e9c0: 7369 6e67 2066 6f72 6d75 6c61 2028 2873 sing formula ((s │ │ │ │ │ -0000e9d0: 7263 5f63 6f6c 6f72 202a 0a20 2020 2020 rc_color *. │ │ │ │ │ -0000e9e0: 7372 635f 616c 7068 6129 202b 2028 6473 src_alpha) + (ds │ │ │ │ │ -0000e9f0: 745f 636f 6c6f 7220 2a20 2832 3535 202d t_color * (255 - │ │ │ │ │ -0000ea00: 2073 7263 5f61 6c70 6861 2929 202f 2032 src_alpha)) / 2 │ │ │ │ │ -0000ea10: 3535 2c20 6966 2074 6172 6765 740a 2020 55, if target. │ │ │ │ │ -0000ea20: 2020 2062 7566 6665 7220 6861 7320 616c buffer has al │ │ │ │ │ -0000ea30: 7068 612c 2069 7420 7769 6c6c 2062 6520 pha, it will be │ │ │ │ │ -0000ea40: 7365 7420 746f 2073 7263 5f61 6c70 6861 set to src_alpha │ │ │ │ │ -0000ea50: 2e20 204f 6666 7365 7473 2061 6666 6563 . Offsets affec │ │ │ │ │ -0000ea60: 740a 2020 2020 2072 656e 6465 7220 7461 t. render ta │ │ │ │ │ -0000ea70: 7267 6574 2070 6f73 6974 696f 6e20 7768 rget position wh │ │ │ │ │ -0000ea80: 6572 6520 6461 7461 2077 696c 6c20 6265 ere data will be │ │ │ │ │ -0000ea90: 2063 6f70 6965 6420 6672 6f6d 2e20 2049 copied from. I │ │ │ │ │ -0000eaa0: 6620 6461 7461 2069 730a 2020 2020 206c f data is. l │ │ │ │ │ -0000eab0: 6f6f 6b65 6420 6f75 7420 6f66 2062 6f75 ooked out of bou │ │ │ │ │ -0000eac0: 6e64 7320 6f66 2072 656e 6465 7220 7461 nds of render ta │ │ │ │ │ -0000ead0: 7267 6574 2c20 636f 6c6f 7220 7661 6c75 rget, color valu │ │ │ │ │ -0000eae0: 6520 7769 6c6c 2062 6520 6173 7375 6d65 e will be assume │ │ │ │ │ -0000eaf0: 640a 2020 2020 2074 6f20 6265 2074 7261 d. to be tra │ │ │ │ │ -0000eb00: 6e73 7061 7265 6e74 2e20 2042 6c69 7474 nsparent. Blitt │ │ │ │ │ -0000eb10: 696e 6720 6f70 6572 6174 6f72 2027 6f70 ing operator 'op │ │ │ │ │ -0000eb20: 6572 2720 7370 6563 6966 6965 7320 7368 er' specifies sh │ │ │ │ │ -0000eb30: 6f75 6c64 0a20 2020 2020 736f 7572 6365 ould. source │ │ │ │ │ -0000eb40: 2070 6978 656c 2072 6570 6c61 6365 2064 pixel replace d │ │ │ │ │ -0000eb50: 6174 6120 696e 2073 6372 6565 6e20 6f72 ata in screen or │ │ │ │ │ -0000eb60: 2062 6c65 6e64 2077 6974 6820 7069 7865 blend with pixe │ │ │ │ │ -0000eb70: 6c20 616c 7068 610a 2020 2020 2076 616c l alpha. val │ │ │ │ │ -0000eb80: 7565 2e0a 0a31 302e 312e 3231 2067 7275 ue...10.1.21 gru │ │ │ │ │ -0000eb90: 625f 7669 6465 6f5f 7363 726f 6c6c 0a2d b_video_scroll.- │ │ │ │ │ -0000eba0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000ebb0: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 --------.. * P │ │ │ │ │ -0000ebc0: 726f 746f 7479 7065 3a0a 0a20 2020 2020 rototype:.. │ │ │ │ │ -0000ebd0: 2020 2020 2067 7275 625f 6572 725f 740a grub_err_t. │ │ │ │ │ -0000ebe0: 2020 2020 2020 2020 2020 6772 7562 5f76 grub_v │ │ │ │ │ -0000ebf0: 6964 656f 5f73 6372 6f6c 6c20 2867 7275 ideo_scroll (gru │ │ │ │ │ -0000ec00: 625f 7669 6465 6f5f 636f 6c6f 725f 7420 b_video_color_t │ │ │ │ │ -0000ec10: 636f 6c6f 722c 2069 6e74 2064 782c 2069 color, int dx, i │ │ │ │ │ -0000ec20: 6e74 2064 7929 3b0a 2020 202a 2044 6573 nt dy);. * Des │ │ │ │ │ -0000ec30: 6372 6970 7469 6f6e 3a0a 0a20 2020 2020 cription:.. │ │ │ │ │ -0000ec40: 5573 6564 2074 6f20 7363 726f 6c6c 2076 Used to scroll v │ │ │ │ │ -0000ec50: 6965 7770 6f72 7420 746f 2073 7065 6369 iewport to speci │ │ │ │ │ -0000ec60: 6669 6564 2064 6972 6563 7469 6f6e 2e20 fied direction. │ │ │ │ │ -0000ec70: 204e 6577 2061 7265 6173 2061 7265 0a20 New areas are. │ │ │ │ │ -0000ec80: 2020 2020 6669 6c6c 6564 2077 6974 6820 filled with │ │ │ │ │ -0000ec90: 7370 6563 6966 6965 6420 636f 6c6f 722e specified color. │ │ │ │ │ -0000eca0: 2020 5468 6973 2066 756e 6374 696f 6e20 This function │ │ │ │ │ -0000ecb0: 6973 2075 7365 6420 7768 656e 2073 6372 is used when scr │ │ │ │ │ -0000ecc0: 6565 6e20 6973 0a20 2020 2020 7363 726f een is. scro │ │ │ │ │ -0000ecd0: 6c6c 6572 2075 7020 696e 2076 6964 656f ller up in video │ │ │ │ │ -0000ece0: 2074 6572 6d69 6e61 6c2e 0a0a 3130 2e31 terminal...10.1 │ │ │ │ │ -0000ecf0: 2e32 3220 6772 7562 5f76 6964 656f 5f73 .22 grub_video_s │ │ │ │ │ -0000ed00: 7761 705f 6275 6666 6572 730a 2d2d 2d2d wap_buffers.---- │ │ │ │ │ +0000e650: 2d2d 0a0a 2020 202a 2050 726f 746f 7479 --.. * Prototy │ │ │ │ │ +0000e660: 7065 3a0a 0a20 2020 2020 2020 2020 2067 pe:.. g │ │ │ │ │ +0000e670: 7275 625f 6572 725f 740a 2020 2020 2020 rub_err_t. │ │ │ │ │ +0000e680: 2020 2020 6772 7562 5f76 6964 656f 5f62 grub_video_b │ │ │ │ │ +0000e690: 6c69 745f 7265 6e64 6572 5f74 6172 6765 lit_render_targe │ │ │ │ │ +0000e6a0: 7420 2873 7472 7563 7420 6772 7562 5f76 t (struct grub_v │ │ │ │ │ +0000e6b0: 6964 656f 5f72 656e 6465 725f 7461 7267 ideo_render_targ │ │ │ │ │ +0000e6c0: 6574 202a 736f 7572 6365 2c20 656e 756d et *source, enum │ │ │ │ │ +0000e6d0: 2067 7275 625f 7669 6465 6f5f 626c 6974 grub_video_blit │ │ │ │ │ +0000e6e0: 5f6f 7065 7261 746f 7273 206f 7065 722c _operators oper, │ │ │ │ │ +0000e6f0: 2069 6e74 2078 2c20 696e 7420 792c 2069 int x, int y, i │ │ │ │ │ +0000e700: 6e74 206f 6666 7365 745f 782c 2069 6e74 nt offset_x, int │ │ │ │ │ +0000e710: 206f 6666 7365 745f 792c 2075 6e73 6967 offset_y, unsig │ │ │ │ │ +0000e720: 6e65 6420 696e 7420 7769 6474 682c 2075 ned int width, u │ │ │ │ │ +0000e730: 6e73 6967 6e65 6420 696e 7420 6865 6967 nsigned int heig │ │ │ │ │ +0000e740: 6874 293b 0a20 2020 2020 2020 2020 2073 ht);. s │ │ │ │ │ +0000e750: 7472 7563 7420 6772 7562 5f76 6964 656f truct grub_video │ │ │ │ │ +0000e760: 5f72 656e 6465 725f 7461 7267 6574 207b _render_target { │ │ │ │ │ +0000e770: 0a20 2020 2020 2020 2020 2020 2020 202f . / │ │ │ │ │ +0000e780: 2a20 5468 6973 2069 7320 7072 6976 6174 * This is privat │ │ │ │ │ +0000e790: 6520 6461 7461 2066 6f72 2076 6964 656f e data for video │ │ │ │ │ +0000e7a0: 2064 7269 7665 722e 2053 686f 756c 6420 driver. Should │ │ │ │ │ +0000e7b0: 6e6f 7420 6265 2061 6363 6573 7365 6420 not be accessed │ │ │ │ │ +0000e7c0: 6672 6f6d 2065 6c73 6577 6865 7265 2064 from elsewhere d │ │ │ │ │ +0000e7d0: 6972 6563 746c 792e 2020 2a2f 0a20 2020 irectly. */. │ │ │ │ │ +0000e7e0: 2020 2020 2020 207d 3b0a 0a20 2020 2020 };.. │ │ │ │ │ +0000e7f0: 2020 2020 2065 6e75 6d20 6772 7562 5f76 enum grub_v │ │ │ │ │ +0000e800: 6964 656f 5f62 6c69 745f 6f70 6572 6174 ideo_blit_operat │ │ │ │ │ +0000e810: 6f72 730a 2020 2020 2020 2020 2020 2020 ors. │ │ │ │ │ +0000e820: 7b0a 2020 2020 2020 2020 2020 2020 2020 {. │ │ │ │ │ +0000e830: 4752 5542 5f56 4944 454f 5f42 4c49 545f GRUB_VIDEO_BLIT_ │ │ │ │ │ +0000e840: 5245 504c 4143 452c 0a20 2020 2020 2020 REPLACE,. │ │ │ │ │ +0000e850: 2020 2020 2020 2047 5255 425f 5649 4445 GRUB_VIDE │ │ │ │ │ +0000e860: 4f5f 424c 4954 5f42 4c45 4e44 0a20 2020 O_BLIT_BLEND. │ │ │ │ │ +0000e870: 2020 2020 2020 2020 207d 3b0a 2020 202a };. * │ │ │ │ │ +0000e880: 2044 6573 6372 6970 7469 6f6e 3a0a 0a20 Description:.. │ │ │ │ │ +0000e890: 2020 2020 5573 6564 2074 6f20 626c 6974 Used to blit │ │ │ │ │ +0000e8a0: 2073 6f75 7263 6520 7265 6e64 6572 2074 source render t │ │ │ │ │ +0000e8b0: 6172 6765 7420 746f 2076 6965 7770 6f72 arget to viewpor │ │ │ │ │ +0000e8c0: 7420 696e 2073 7065 6369 6669 6564 0a20 t in specified. │ │ │ │ │ +0000e8d0: 2020 2020 636f 6f72 6469 6e61 7465 732e coordinates. │ │ │ │ │ +0000e8e0: 2020 4966 2070 6172 7420 6f66 2073 6f75 If part of sou │ │ │ │ │ +0000e8f0: 7263 6520 7265 6e64 6572 2074 6172 6765 rce render targe │ │ │ │ │ +0000e900: 7420 6973 206f 7574 7369 6465 206f 660a t is outside of. │ │ │ │ │ +0000e910: 2020 2020 2076 6965 7770 6f72 7420 7265 viewport re │ │ │ │ │ +0000e920: 6769 6f6e 2c20 6974 2077 696c 6c20 6265 gion, it will be │ │ │ │ │ +0000e930: 2063 6c69 7070 6564 206f 7574 2e20 2049 clipped out. I │ │ │ │ │ +0000e940: 6620 626c 6974 7469 6e67 206f 7065 7261 f blitting opera │ │ │ │ │ +0000e950: 746f 7220 6973 0a20 2020 2020 7370 6563 tor is. spec │ │ │ │ │ +0000e960: 6966 6965 6420 616e 6420 736f 7572 6365 ified and source │ │ │ │ │ +0000e970: 2063 6f6e 7461 696e 7320 616c 7068 6120 contains alpha │ │ │ │ │ +0000e980: 7661 6c75 6573 2c20 7265 7375 6c74 696e values, resultin │ │ │ │ │ +0000e990: 6720 7069 7865 6c20 636f 6c6f 720a 2020 g pixel color. │ │ │ │ │ +0000e9a0: 2020 2063 6f6d 706f 6e65 6e74 7320 7769 components wi │ │ │ │ │ +0000e9b0: 6c6c 2062 6520 6361 6c63 756c 6174 6564 ll be calculated │ │ │ │ │ +0000e9c0: 2075 7369 6e67 2066 6f72 6d75 6c61 2028 using formula ( │ │ │ │ │ +0000e9d0: 2873 7263 5f63 6f6c 6f72 202a 0a20 2020 (src_color *. │ │ │ │ │ +0000e9e0: 2020 7372 635f 616c 7068 6129 202b 2028 src_alpha) + ( │ │ │ │ │ +0000e9f0: 6473 745f 636f 6c6f 7220 2a20 2832 3535 dst_color * (255 │ │ │ │ │ +0000ea00: 202d 2073 7263 5f61 6c70 6861 2929 202f - src_alpha)) / │ │ │ │ │ +0000ea10: 2032 3535 2c20 6966 2074 6172 6765 740a 255, if target. │ │ │ │ │ +0000ea20: 2020 2020 2062 7566 6665 7220 6861 7320 buffer has │ │ │ │ │ +0000ea30: 616c 7068 612c 2069 7420 7769 6c6c 2062 alpha, it will b │ │ │ │ │ +0000ea40: 6520 7365 7420 746f 2073 7263 5f61 6c70 e set to src_alp │ │ │ │ │ +0000ea50: 6861 2e20 204f 6666 7365 7473 2061 6666 ha. Offsets aff │ │ │ │ │ +0000ea60: 6563 740a 2020 2020 2072 656e 6465 7220 ect. render │ │ │ │ │ +0000ea70: 7461 7267 6574 2070 6f73 6974 696f 6e20 target position │ │ │ │ │ +0000ea80: 7768 6572 6520 6461 7461 2077 696c 6c20 where data will │ │ │ │ │ +0000ea90: 6265 2063 6f70 6965 6420 6672 6f6d 2e20 be copied from. │ │ │ │ │ +0000eaa0: 2049 6620 6461 7461 2069 730a 2020 2020 If data is. │ │ │ │ │ +0000eab0: 206c 6f6f 6b65 6420 6f75 7420 6f66 2062 looked out of b │ │ │ │ │ +0000eac0: 6f75 6e64 7320 6f66 2072 656e 6465 7220 ounds of render │ │ │ │ │ +0000ead0: 7461 7267 6574 2c20 636f 6c6f 7220 7661 target, color va │ │ │ │ │ +0000eae0: 6c75 6520 7769 6c6c 2062 6520 6173 7375 lue will be assu │ │ │ │ │ +0000eaf0: 6d65 640a 2020 2020 2074 6f20 6265 2074 med. to be t │ │ │ │ │ +0000eb00: 7261 6e73 7061 7265 6e74 2e20 2042 6c69 ransparent. Bli │ │ │ │ │ +0000eb10: 7474 696e 6720 6f70 6572 6174 6f72 2027 tting operator ' │ │ │ │ │ +0000eb20: 6f70 6572 2720 7370 6563 6966 6965 7320 oper' specifies │ │ │ │ │ +0000eb30: 7368 6f75 6c64 0a20 2020 2020 736f 7572 should. sour │ │ │ │ │ +0000eb40: 6365 2070 6978 656c 2072 6570 6c61 6365 ce pixel replace │ │ │ │ │ +0000eb50: 2064 6174 6120 696e 2073 6372 6565 6e20 data in screen │ │ │ │ │ +0000eb60: 6f72 2062 6c65 6e64 2077 6974 6820 7069 or blend with pi │ │ │ │ │ +0000eb70: 7865 6c20 616c 7068 610a 2020 2020 2076 xel alpha. v │ │ │ │ │ +0000eb80: 616c 7565 2e0a 0a31 302e 312e 3231 2067 alue...10.1.21 g │ │ │ │ │ +0000eb90: 7275 625f 7669 6465 6f5f 7363 726f 6c6c rub_video_scroll │ │ │ │ │ +0000eba0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +0000ebb0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ │ +0000ebc0: 2050 726f 746f 7479 7065 3a0a 0a20 2020 Prototype:.. │ │ │ │ │ +0000ebd0: 2020 2020 2020 2067 7275 625f 6572 725f grub_err_ │ │ │ │ │ +0000ebe0: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ │ +0000ebf0: 5f76 6964 656f 5f73 6372 6f6c 6c20 2867 _video_scroll (g │ │ │ │ │ +0000ec00: 7275 625f 7669 6465 6f5f 636f 6c6f 725f rub_video_color_ │ │ │ │ │ +0000ec10: 7420 636f 6c6f 722c 2069 6e74 2064 782c t color, int dx, │ │ │ │ │ +0000ec20: 2069 6e74 2064 7929 3b0a 2020 202a 2044 int dy);. * D │ │ │ │ │ +0000ec30: 6573 6372 6970 7469 6f6e 3a0a 0a20 2020 escription:.. │ │ │ │ │ +0000ec40: 2020 5573 6564 2074 6f20 7363 726f 6c6c Used to scroll │ │ │ │ │ +0000ec50: 2076 6965 7770 6f72 7420 746f 2073 7065 viewport to spe │ │ │ │ │ +0000ec60: 6369 6669 6564 2064 6972 6563 7469 6f6e cified direction │ │ │ │ │ +0000ec70: 2e20 204e 6577 2061 7265 6173 2061 7265 . New areas are │ │ │ │ │ +0000ec80: 0a20 2020 2020 6669 6c6c 6564 2077 6974 . filled wit │ │ │ │ │ +0000ec90: 6820 7370 6563 6966 6965 6420 636f 6c6f h specified colo │ │ │ │ │ +0000eca0: 722e 2020 5468 6973 2066 756e 6374 696f r. This functio │ │ │ │ │ +0000ecb0: 6e20 6973 2075 7365 6420 7768 656e 2073 n is used when s │ │ │ │ │ +0000ecc0: 6372 6565 6e20 6973 0a20 2020 2020 7363 creen is. sc │ │ │ │ │ +0000ecd0: 726f 6c6c 6572 2075 7020 696e 2076 6964 roller up in vid │ │ │ │ │ +0000ece0: 656f 2074 6572 6d69 6e61 6c2e 0a0a 3130 eo terminal...10 │ │ │ │ │ +0000ecf0: 2e31 2e32 3220 6772 7562 5f76 6964 656f .1.22 grub_video │ │ │ │ │ +0000ed00: 5f73 7761 705f 6275 6666 6572 730a 2d2d _swap_buffers.-- │ │ │ │ │ 0000ed10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000ed20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ │ -0000ed30: 2a20 5072 6f74 6f74 7970 653a 0a0a 2020 * Prototype:.. │ │ │ │ │ -0000ed40: 2020 2020 2020 2020 6772 7562 5f65 7272 grub_err │ │ │ │ │ -0000ed50: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ │ -0000ed60: 625f 7669 6465 6f5f 7377 6170 5f62 7566 b_video_swap_buf │ │ │ │ │ -0000ed70: 6665 7273 2028 766f 6964 293b 0a20 2020 fers (void);. │ │ │ │ │ -0000ed80: 2a20 4465 7363 7269 7074 696f 6e3a 0a0a * Description:.. │ │ │ │ │ -0000ed90: 2020 2020 2049 6620 646f 7562 6c65 2062 If double b │ │ │ │ │ -0000eda0: 7566 6665 7269 6e67 2069 7320 656e 6162 uffering is enab │ │ │ │ │ -0000edb0: 6c65 642c 2074 6869 7320 7377 6170 7320 led, this swaps │ │ │ │ │ -0000edc0: 6672 6f6e 7462 7566 6665 7220 616e 640a frontbuffer and. │ │ │ │ │ -0000edd0: 2020 2020 2062 6163 6b62 7566 6665 722c backbuffer, │ │ │ │ │ -0000ede0: 2069 6e20 6f72 6465 7220 746f 2073 686f in order to sho │ │ │ │ │ -0000edf0: 7720 7661 6c75 6573 2064 7261 776e 2074 w values drawn t │ │ │ │ │ -0000ee00: 6f20 6261 636b 2062 7566 6665 722e 2020 o back buffer. │ │ │ │ │ -0000ee10: 5669 6465 6f0a 2020 2020 2064 7269 7665 Video. drive │ │ │ │ │ -0000ee20: 7220 6973 2066 7265 6520 746f 2063 686f r is free to cho │ │ │ │ │ -0000ee30: 6f73 6520 686f 7720 7468 6973 206f 7065 ose how this ope │ │ │ │ │ -0000ee40: 7261 7469 6f6e 2069 7320 7465 6368 696e ration is techin │ │ │ │ │ -0000ee50: 6361 6c6c 7920 646f 6e65 2e0a 0a31 302e cally done...10. │ │ │ │ │ -0000ee60: 312e 3233 2067 7275 625f 7669 6465 6f5f 1.23 grub_video_ │ │ │ │ │ -0000ee70: 6372 6561 7465 5f72 656e 6465 725f 7461 create_render_ta │ │ │ │ │ -0000ee80: 7267 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d rget.----------- │ │ │ │ │ +0000ed20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +0000ed30: 2020 2a20 5072 6f74 6f74 7970 653a 0a0a * Prototype:.. │ │ │ │ │ +0000ed40: 2020 2020 2020 2020 2020 6772 7562 5f65 grub_e │ │ │ │ │ +0000ed50: 7272 5f74 0a20 2020 2020 2020 2020 2067 rr_t. g │ │ │ │ │ +0000ed60: 7275 625f 7669 6465 6f5f 7377 6170 5f62 rub_video_swap_b │ │ │ │ │ +0000ed70: 7566 6665 7273 2028 766f 6964 293b 0a20 uffers (void);. │ │ │ │ │ +0000ed80: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ │ +0000ed90: 0a0a 2020 2020 2049 6620 646f 7562 6c65 .. If double │ │ │ │ │ +0000eda0: 2062 7566 6665 7269 6e67 2069 7320 656e buffering is en │ │ │ │ │ +0000edb0: 6162 6c65 642c 2074 6869 7320 7377 6170 abled, this swap │ │ │ │ │ +0000edc0: 7320 6672 6f6e 7462 7566 6665 7220 616e s frontbuffer an │ │ │ │ │ +0000edd0: 640a 2020 2020 2062 6163 6b62 7566 6665 d. backbuffe │ │ │ │ │ +0000ede0: 722c 2069 6e20 6f72 6465 7220 746f 2073 r, in order to s │ │ │ │ │ +0000edf0: 686f 7720 7661 6c75 6573 2064 7261 776e how values drawn │ │ │ │ │ +0000ee00: 2074 6f20 6261 636b 2062 7566 6665 722e to back buffer. │ │ │ │ │ +0000ee10: 2020 5669 6465 6f0a 2020 2020 2064 7269 Video. dri │ │ │ │ │ +0000ee20: 7665 7220 6973 2066 7265 6520 746f 2063 ver is free to c │ │ │ │ │ +0000ee30: 686f 6f73 6520 686f 7720 7468 6973 206f hoose how this o │ │ │ │ │ +0000ee40: 7065 7261 7469 6f6e 2069 7320 7465 6368 peration is tech │ │ │ │ │ +0000ee50: 696e 6361 6c6c 7920 646f 6e65 2e0a 0a31 incally done...1 │ │ │ │ │ +0000ee60: 302e 312e 3233 2067 7275 625f 7669 6465 0.1.23 grub_vide │ │ │ │ │ +0000ee70: 6f5f 6372 6561 7465 5f72 656e 6465 725f o_create_render_ │ │ │ │ │ +0000ee80: 7461 7267 6574 0a2d 2d2d 2d2d 2d2d 2d2d target.--------- │ │ │ │ │ 0000ee90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000eea0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ -0000eeb0: 202a 2050 726f 746f 7479 7065 3a0a 0a20 * Prototype:.. │ │ │ │ │ -0000eec0: 2020 2020 2020 2020 2067 7275 625f 6572 grub_er │ │ │ │ │ -0000eed0: 725f 740a 2020 2020 2020 2020 2020 6772 r_t. gr │ │ │ │ │ -0000eee0: 7562 5f76 6964 656f 5f63 7265 6174 655f ub_video_create_ │ │ │ │ │ -0000eef0: 7265 6e64 6572 5f74 6172 6765 7420 2873 render_target (s │ │ │ │ │ -0000ef00: 7472 7563 7420 6772 7562 5f76 6964 656f truct grub_video │ │ │ │ │ -0000ef10: 5f72 656e 6465 725f 7461 7267 6574 202a _render_target * │ │ │ │ │ -0000ef20: 2a72 6573 756c 742c 2075 6e73 6967 6e65 *result, unsigne │ │ │ │ │ -0000ef30: 6420 696e 7420 7769 6474 682c 2075 6e73 d int width, uns │ │ │ │ │ -0000ef40: 6967 6e65 6420 696e 7420 6865 6967 6874 igned int height │ │ │ │ │ -0000ef50: 2c20 756e 7369 676e 6564 2069 6e74 206d , unsigned int m │ │ │ │ │ -0000ef60: 6f64 655f 7479 7065 293b 0a20 2020 2020 ode_type);. │ │ │ │ │ -0000ef70: 2020 2020 2073 7472 7563 7420 6772 7562 struct grub │ │ │ │ │ -0000ef80: 5f76 6964 656f 5f72 656e 6465 725f 7461 _video_render_ta │ │ │ │ │ -0000ef90: 7267 6574 207b 0a20 2020 2020 2020 2020 rget {. │ │ │ │ │ -0000efa0: 2020 2020 202f 2a20 5468 6973 2069 7320 /* This is │ │ │ │ │ -0000efb0: 7072 6976 6174 6520 6461 7461 2066 6f72 private data for │ │ │ │ │ -0000efc0: 2076 6964 656f 2064 7269 7665 722e 2053 video driver. S │ │ │ │ │ -0000efd0: 686f 756c 6420 6e6f 7420 6265 2061 6363 hould not be acc │ │ │ │ │ -0000efe0: 6573 7365 6420 6672 6f6d 2065 6c73 6577 essed from elsew │ │ │ │ │ -0000eff0: 6865 7265 2064 6972 6563 746c 792e 2020 here directly. │ │ │ │ │ -0000f000: 2a2f 0a20 2020 2020 2020 2020 207d 3b0a */. };. │ │ │ │ │ -0000f010: 2020 202a 2044 6573 6372 6970 7469 6f6e * Description │ │ │ │ │ -0000f020: 3a0a 0a20 2020 2020 4472 6976 6572 2077 :.. Driver w │ │ │ │ │ -0000f030: 696c 6c20 7573 6520 696e 666f 726d 6174 ill use informat │ │ │ │ │ -0000f040: 696f 6e20 7072 6f76 6964 6564 2074 6f20 ion provided to │ │ │ │ │ -0000f050: 6974 2074 6f20 6372 6561 7465 2062 6573 it to create bes │ │ │ │ │ -0000f060: 7420 6669 7474 696e 670a 2020 2020 2072 t fitting. r │ │ │ │ │ -0000f070: 656e 6465 7220 7461 7267 6574 2e20 2027 ender target. ' │ │ │ │ │ -0000f080: 6d6f 6465 5f74 7970 6527 2077 696c 6c20 mode_type' will │ │ │ │ │ -0000f090: 6265 2075 7365 6420 746f 2067 7569 6465 be used to guide │ │ │ │ │ -0000f0a0: 206f 6e20 7365 6c65 6374 696e 6720 7768 on selecting wh │ │ │ │ │ -0000f0b0: 6174 0a20 2020 2020 6665 6174 7572 6573 at. features │ │ │ │ │ -0000f0c0: 2061 7265 2077 616e 7465 6420 666f 7220 are wanted for │ │ │ │ │ -0000f0d0: 7265 6e64 6572 2074 6172 6765 742e 2020 render target. │ │ │ │ │ -0000f0e0: 5375 7070 6f72 7465 6420 7661 6c75 6573 Supported values │ │ │ │ │ -0000f0f0: 2066 6f72 0a20 2020 2020 276d 6f64 655f for. 'mode_ │ │ │ │ │ -0000f100: 7479 7065 2720 6172 6520 2747 5255 425f type' are 'GRUB_ │ │ │ │ │ -0000f110: 5649 4445 4f5f 4d4f 4445 5f54 5950 455f VIDEO_MODE_TYPE_ │ │ │ │ │ -0000f120: 494e 4445 585f 434f 4c4f 5227 2066 6f72 INDEX_COLOR' for │ │ │ │ │ -0000f130: 2069 6e64 6578 2063 6f6c 6f72 0a20 2020 index color. │ │ │ │ │ -0000f140: 2020 6d6f 6465 732c 2027 4752 5542 5f56 modes, 'GRUB_V │ │ │ │ │ -0000f150: 4944 454f 5f4d 4f44 455f 5459 5045 5f52 IDEO_MODE_TYPE_R │ │ │ │ │ -0000f160: 4742 2720 666f 7220 6469 7265 6374 2052 GB' for direct R │ │ │ │ │ -0000f170: 4742 2063 6f6c 6f72 206d 6f64 6573 2061 GB color modes a │ │ │ │ │ -0000f180: 6e64 0a20 2020 2020 2747 5255 425f 5649 nd. 'GRUB_VI │ │ │ │ │ -0000f190: 4445 4f5f 4d4f 4445 5f54 5950 455f 414c DEO_MODE_TYPE_AL │ │ │ │ │ -0000f1a0: 5048 4127 2066 6f72 2061 6c70 6861 2063 PHA' for alpha c │ │ │ │ │ -0000f1b0: 6f6d 706f 6e65 6e74 2e0a 0a31 302e 312e omponent...10.1. │ │ │ │ │ -0000f1c0: 3234 2067 7275 625f 7669 6465 6f5f 6465 24 grub_video_de │ │ │ │ │ -0000f1d0: 6c65 7465 5f72 656e 6465 725f 7461 7267 lete_render_targ │ │ │ │ │ -0000f1e0: 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d et.------------- │ │ │ │ │ +0000eea0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0000eeb0: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ +0000eec0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +0000eed0: 6572 725f 740a 2020 2020 2020 2020 2020 err_t. │ │ │ │ │ +0000eee0: 6772 7562 5f76 6964 656f 5f63 7265 6174 grub_video_creat │ │ │ │ │ +0000eef0: 655f 7265 6e64 6572 5f74 6172 6765 7420 e_render_target │ │ │ │ │ +0000ef00: 2873 7472 7563 7420 6772 7562 5f76 6964 (struct grub_vid │ │ │ │ │ +0000ef10: 656f 5f72 656e 6465 725f 7461 7267 6574 eo_render_target │ │ │ │ │ +0000ef20: 202a 2a72 6573 756c 742c 2075 6e73 6967 **result, unsig │ │ │ │ │ +0000ef30: 6e65 6420 696e 7420 7769 6474 682c 2075 ned int width, u │ │ │ │ │ +0000ef40: 6e73 6967 6e65 6420 696e 7420 6865 6967 nsigned int heig │ │ │ │ │ +0000ef50: 6874 2c20 756e 7369 676e 6564 2069 6e74 ht, unsigned int │ │ │ │ │ +0000ef60: 206d 6f64 655f 7479 7065 293b 0a20 2020 mode_type);. │ │ │ │ │ +0000ef70: 2020 2020 2020 2073 7472 7563 7420 6772 struct gr │ │ │ │ │ +0000ef80: 7562 5f76 6964 656f 5f72 656e 6465 725f ub_video_render_ │ │ │ │ │ +0000ef90: 7461 7267 6574 207b 0a20 2020 2020 2020 target {. │ │ │ │ │ +0000efa0: 2020 2020 2020 202f 2a20 5468 6973 2069 /* This i │ │ │ │ │ +0000efb0: 7320 7072 6976 6174 6520 6461 7461 2066 s private data f │ │ │ │ │ +0000efc0: 6f72 2076 6964 656f 2064 7269 7665 722e or video driver. │ │ │ │ │ +0000efd0: 2053 686f 756c 6420 6e6f 7420 6265 2061 Should not be a │ │ │ │ │ +0000efe0: 6363 6573 7365 6420 6672 6f6d 2065 6c73 ccessed from els │ │ │ │ │ +0000eff0: 6577 6865 7265 2064 6972 6563 746c 792e ewhere directly. │ │ │ │ │ +0000f000: 2020 2a2f 0a20 2020 2020 2020 2020 207d */. } │ │ │ │ │ +0000f010: 3b0a 2020 202a 2044 6573 6372 6970 7469 ;. * Descripti │ │ │ │ │ +0000f020: 6f6e 3a0a 0a20 2020 2020 4472 6976 6572 on:.. Driver │ │ │ │ │ +0000f030: 2077 696c 6c20 7573 6520 696e 666f 726d will use inform │ │ │ │ │ +0000f040: 6174 696f 6e20 7072 6f76 6964 6564 2074 ation provided t │ │ │ │ │ +0000f050: 6f20 6974 2074 6f20 6372 6561 7465 2062 o it to create b │ │ │ │ │ +0000f060: 6573 7420 6669 7474 696e 670a 2020 2020 est fitting. │ │ │ │ │ +0000f070: 2072 656e 6465 7220 7461 7267 6574 2e20 render target. │ │ │ │ │ +0000f080: 2027 6d6f 6465 5f74 7970 6527 2077 696c 'mode_type' wil │ │ │ │ │ +0000f090: 6c20 6265 2075 7365 6420 746f 2067 7569 l be used to gui │ │ │ │ │ +0000f0a0: 6465 206f 6e20 7365 6c65 6374 696e 6720 de on selecting │ │ │ │ │ +0000f0b0: 7768 6174 0a20 2020 2020 6665 6174 7572 what. featur │ │ │ │ │ +0000f0c0: 6573 2061 7265 2077 616e 7465 6420 666f es are wanted fo │ │ │ │ │ +0000f0d0: 7220 7265 6e64 6572 2074 6172 6765 742e r render target. │ │ │ │ │ +0000f0e0: 2020 5375 7070 6f72 7465 6420 7661 6c75 Supported valu │ │ │ │ │ +0000f0f0: 6573 2066 6f72 0a20 2020 2020 276d 6f64 es for. 'mod │ │ │ │ │ +0000f100: 655f 7479 7065 2720 6172 6520 2747 5255 e_type' are 'GRU │ │ │ │ │ +0000f110: 425f 5649 4445 4f5f 4d4f 4445 5f54 5950 B_VIDEO_MODE_TYP │ │ │ │ │ +0000f120: 455f 494e 4445 585f 434f 4c4f 5227 2066 E_INDEX_COLOR' f │ │ │ │ │ +0000f130: 6f72 2069 6e64 6578 2063 6f6c 6f72 0a20 or index color. │ │ │ │ │ +0000f140: 2020 2020 6d6f 6465 732c 2027 4752 5542 modes, 'GRUB │ │ │ │ │ +0000f150: 5f56 4944 454f 5f4d 4f44 455f 5459 5045 _VIDEO_MODE_TYPE │ │ │ │ │ +0000f160: 5f52 4742 2720 666f 7220 6469 7265 6374 _RGB' for direct │ │ │ │ │ +0000f170: 2052 4742 2063 6f6c 6f72 206d 6f64 6573 RGB color modes │ │ │ │ │ +0000f180: 2061 6e64 0a20 2020 2020 2747 5255 425f and. 'GRUB_ │ │ │ │ │ +0000f190: 5649 4445 4f5f 4d4f 4445 5f54 5950 455f VIDEO_MODE_TYPE_ │ │ │ │ │ +0000f1a0: 414c 5048 4127 2066 6f72 2061 6c70 6861 ALPHA' for alpha │ │ │ │ │ +0000f1b0: 2063 6f6d 706f 6e65 6e74 2e0a 0a31 302e component...10. │ │ │ │ │ +0000f1c0: 312e 3234 2067 7275 625f 7669 6465 6f5f 1.24 grub_video_ │ │ │ │ │ +0000f1d0: 6465 6c65 7465 5f72 656e 6465 725f 7461 delete_render_ta │ │ │ │ │ +0000f1e0: 7267 6574 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d rget.----------- │ │ │ │ │ 0000f1f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000f200: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ │ -0000f210: 2050 726f 746f 7479 7065 3a0a 0a20 2020 Prototype:.. │ │ │ │ │ -0000f220: 2020 2020 2020 2067 7275 625f 6572 725f grub_err_ │ │ │ │ │ -0000f230: 740a 2020 2020 2020 2020 2020 6772 7562 t. grub │ │ │ │ │ -0000f240: 5f76 6964 656f 5f64 656c 6574 655f 7265 _video_delete_re │ │ │ │ │ -0000f250: 6e64 6572 5f74 6172 6765 7420 2873 7472 nder_target (str │ │ │ │ │ -0000f260: 7563 7420 6772 7562 5f76 6964 656f 5f72 uct grub_video_r │ │ │ │ │ -0000f270: 656e 6465 725f 7461 7267 6574 202a 7461 ender_target *ta │ │ │ │ │ -0000f280: 7267 6574 293b 0a20 2020 2a20 4465 7363 rget);. * Desc │ │ │ │ │ -0000f290: 7269 7074 696f 6e3a 0a0a 2020 2020 2055 ription:.. U │ │ │ │ │ -0000f2a0: 7365 6420 746f 2064 656c 6574 6520 7072 sed to delete pr │ │ │ │ │ -0000f2b0: 6576 696f 7573 6c79 2063 7265 6174 6564 eviously created │ │ │ │ │ -0000f2c0: 2072 656e 6465 7220 7461 7267 6574 2e20 render target. │ │ │ │ │ -0000f2d0: 2049 6620 2774 6172 6765 7427 0a20 2020 If 'target'. │ │ │ │ │ -0000f2e0: 2020 636f 6e74 6169 6e73 2027 4e55 4c4c contains 'NULL │ │ │ │ │ -0000f2f0: 2720 706f 696e 7465 722c 206e 6f74 6869 ' pointer, nothi │ │ │ │ │ -0000f300: 6e67 2077 696c 6c20 6265 2064 6f6e 652e ng will be done. │ │ │ │ │ -0000f310: 2020 4966 2072 656e 6465 7220 7461 7267 If render targ │ │ │ │ │ -0000f320: 6574 2069 730a 2020 2020 2063 6f72 7265 et is. corre │ │ │ │ │ -0000f330: 6374 6c79 2064 6573 7472 6f79 6564 2c20 ctly destroyed, │ │ │ │ │ -0000f340: 4752 5542 5f45 5252 5f4e 4f4e 4520 6973 GRUB_ERR_NONE is │ │ │ │ │ -0000f350: 2072 6574 7572 6e65 642e 0a0a 3130 2e31 returned...10.1 │ │ │ │ │ -0000f360: 2e32 3520 6772 7562 5f76 6964 656f 5f73 .25 grub_video_s │ │ │ │ │ -0000f370: 6574 5f61 6374 6976 655f 7265 6e64 6572 et_active_render │ │ │ │ │ -0000f380: 5f74 6172 6765 740a 2d2d 2d2d 2d2d 2d2d _target.-------- │ │ │ │ │ +0000f200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ +0000f210: 202a 2050 726f 746f 7479 7065 3a0a 0a20 * Prototype:.. │ │ │ │ │ +0000f220: 2020 2020 2020 2020 2067 7275 625f 6572 grub_er │ │ │ │ │ +0000f230: 725f 740a 2020 2020 2020 2020 2020 6772 r_t. gr │ │ │ │ │ +0000f240: 7562 5f76 6964 656f 5f64 656c 6574 655f ub_video_delete_ │ │ │ │ │ +0000f250: 7265 6e64 6572 5f74 6172 6765 7420 2873 render_target (s │ │ │ │ │ +0000f260: 7472 7563 7420 6772 7562 5f76 6964 656f truct grub_video │ │ │ │ │ +0000f270: 5f72 656e 6465 725f 7461 7267 6574 202a _render_target * │ │ │ │ │ +0000f280: 7461 7267 6574 293b 0a20 2020 2a20 4465 target);. * De │ │ │ │ │ +0000f290: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ +0000f2a0: 2055 7365 6420 746f 2064 656c 6574 6520 Used to delete │ │ │ │ │ +0000f2b0: 7072 6576 696f 7573 6c79 2063 7265 6174 previously creat │ │ │ │ │ +0000f2c0: 6564 2072 656e 6465 7220 7461 7267 6574 ed render target │ │ │ │ │ +0000f2d0: 2e20 2049 6620 2774 6172 6765 7427 0a20 . If 'target'. │ │ │ │ │ +0000f2e0: 2020 2020 636f 6e74 6169 6e73 2027 4e55 contains 'NU │ │ │ │ │ +0000f2f0: 4c4c 2720 706f 696e 7465 722c 206e 6f74 LL' pointer, not │ │ │ │ │ +0000f300: 6869 6e67 2077 696c 6c20 6265 2064 6f6e hing will be don │ │ │ │ │ +0000f310: 652e 2020 4966 2072 656e 6465 7220 7461 e. If render ta │ │ │ │ │ +0000f320: 7267 6574 2069 730a 2020 2020 2063 6f72 rget is. cor │ │ │ │ │ +0000f330: 7265 6374 6c79 2064 6573 7472 6f79 6564 rectly destroyed │ │ │ │ │ +0000f340: 2c20 4752 5542 5f45 5252 5f4e 4f4e 4520 , GRUB_ERR_NONE │ │ │ │ │ +0000f350: 6973 2072 6574 7572 6e65 642e 0a0a 3130 is returned...10 │ │ │ │ │ +0000f360: 2e31 2e32 3520 6772 7562 5f76 6964 656f .1.25 grub_video │ │ │ │ │ +0000f370: 5f73 6574 5f61 6374 6976 655f 7265 6e64 _set_active_rend │ │ │ │ │ +0000f380: 6572 5f74 6172 6765 740a 2d2d 2d2d 2d2d er_target.------ │ │ │ │ │ 0000f390: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000f3a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000f3b0: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ │ -0000f3c0: 7970 653a 0a0a 2020 2020 2020 2020 2020 ype:.. │ │ │ │ │ -0000f3d0: 6772 7562 5f65 7272 5f74 0a20 2020 2020 grub_err_t. │ │ │ │ │ -0000f3e0: 2020 2020 2067 7275 625f 7669 6465 6f5f grub_video_ │ │ │ │ │ -0000f3f0: 7365 745f 6163 7469 7665 5f72 656e 6465 set_active_rende │ │ │ │ │ -0000f400: 725f 7461 7267 6574 2028 7374 7275 6374 r_target (struct │ │ │ │ │ -0000f410: 2067 7275 625f 7669 6465 6f5f 7265 6e64 grub_video_rend │ │ │ │ │ -0000f420: 6572 5f74 6172 6765 7420 2a74 6172 6765 er_target *targe │ │ │ │ │ -0000f430: 7429 3b0a 2020 202a 2044 6573 6372 6970 t);. * Descrip │ │ │ │ │ -0000f440: 7469 6f6e 3a0a 0a20 2020 2020 5365 7473 tion:.. Sets │ │ │ │ │ -0000f450: 2061 6374 6976 6520 7265 6e64 6572 2074 active render t │ │ │ │ │ -0000f460: 6172 6765 742e 2020 4966 2074 6869 7320 arget. If this │ │ │ │ │ -0000f470: 636f 6d61 6e64 2069 7320 7375 6363 6573 comand is succes │ │ │ │ │ -0000f480: 7366 756c 2061 6c6c 0a20 2020 2020 6472 sful all. dr │ │ │ │ │ -0000f490: 6177 696e 6720 636f 6d6d 616e 6473 2077 awing commands w │ │ │ │ │ -0000f4a0: 696c 6c20 6265 2064 6f6e 6520 746f 2073 ill be done to s │ │ │ │ │ -0000f4b0: 7065 6369 6669 6564 2027 7461 7267 6574 pecified 'target │ │ │ │ │ -0000f4c0: 272e 2020 5468 6572 6520 6973 2061 6c73 '. There is als │ │ │ │ │ -0000f4d0: 6f0a 2020 2020 2073 7065 6369 616c 2076 o. special v │ │ │ │ │ -0000f4e0: 616c 7565 7320 666f 7220 7461 7267 6574 alues for target │ │ │ │ │ -0000f4f0: 2c20 2747 5255 425f 5649 4445 4f5f 5245 , 'GRUB_VIDEO_RE │ │ │ │ │ -0000f500: 4e44 4552 5f54 4152 4745 545f 4449 5350 NDER_TARGET_DISP │ │ │ │ │ -0000f510: 4c41 5927 2075 7365 640a 2020 2020 2074 LAY' used. t │ │ │ │ │ -0000f520: 6f20 7265 6665 7265 6e63 6520 7363 7265 o reference scre │ │ │ │ │ -0000f530: 656e 2773 2066 726f 6e74 2062 7566 6665 en's front buffe │ │ │ │ │ -0000f540: 722c 0a20 2020 2020 2747 5255 425f 5649 r,. 'GRUB_VI │ │ │ │ │ -0000f550: 4445 4f5f 5245 4e44 4552 5f54 4152 4745 DEO_RENDER_TARGE │ │ │ │ │ -0000f560: 545f 4652 4f4e 545f 4255 4646 4552 2720 T_FRONT_BUFFER' │ │ │ │ │ -0000f570: 7573 6564 2074 6f20 7265 6665 7265 6e63 used to referenc │ │ │ │ │ -0000f580: 6520 7363 7265 656e 2773 0a20 2020 2020 e screen's. │ │ │ │ │ -0000f590: 6672 6f6e 7420 6275 6666 6572 2028 616c front buffer (al │ │ │ │ │ -0000f5a0: 6961 7320 666f 7220 2747 5255 425f 5649 ias for 'GRUB_VI │ │ │ │ │ -0000f5b0: 4445 4f5f 5245 4e44 4552 5f54 4152 4745 DEO_RENDER_TARGE │ │ │ │ │ -0000f5c0: 545f 4449 5350 4c41 5927 2920 616e 640a T_DISPLAY') and. │ │ │ │ │ -0000f5d0: 2020 2020 2027 4752 5542 5f56 4944 454f 'GRUB_VIDEO │ │ │ │ │ -0000f5e0: 5f52 454e 4445 525f 5441 5247 4554 5f42 _RENDER_TARGET_B │ │ │ │ │ -0000f5f0: 4143 4b5f 4255 4646 4552 2720 7573 6564 ACK_BUFFER' used │ │ │ │ │ -0000f600: 2074 6f20 7265 6665 7265 6e63 6520 6261 to reference ba │ │ │ │ │ -0000f610: 636b 0a20 2020 2020 6275 6666 6572 2028 ck. buffer ( │ │ │ │ │ -0000f620: 6966 2064 6f75 626c 6520 6275 6666 6572 if double buffer │ │ │ │ │ -0000f630: 696e 6720 6973 2065 6e61 626c 6564 292e ing is enabled). │ │ │ │ │ -0000f640: 2020 4966 2072 656e 6465 7220 7461 7267 If render targ │ │ │ │ │ -0000f650: 6574 2069 730a 2020 2020 2063 6f72 7265 et is. corre │ │ │ │ │ -0000f660: 636c 7479 2073 7769 7463 6865 6420 4752 clty switched GR │ │ │ │ │ -0000f670: 5542 5f45 5252 5f4e 4f4e 4520 6973 2072 UB_ERR_NONE is r │ │ │ │ │ -0000f680: 6574 7572 6e65 642e 2020 496e 206e 6f20 eturned. In no │ │ │ │ │ -0000f690: 616e 7920 6576 656e 740a 2020 2020 2073 any event. s │ │ │ │ │ -0000f6a0: 6861 6c6c 2074 6865 7265 2062 6520 6e6f hall there be no │ │ │ │ │ -0000f6b0: 6e20 6472 6177 6162 6c65 2061 6374 6976 n drawable activ │ │ │ │ │ -0000f6c0: 6520 7265 6e64 6572 2074 6172 6765 742e e render target. │ │ │ │ │ -0000f6d0: 0a0a 3130 2e31 2e32 3620 6772 7562 5f76 ..10.1.26 grub_v │ │ │ │ │ -0000f6e0: 6964 656f 5f67 6574 5f61 6374 6976 655f ideo_get_active_ │ │ │ │ │ -0000f6f0: 7265 6e64 6572 5f74 6172 6765 740a 2d2d render_target.-- │ │ │ │ │ +0000f3b0: 2d2d 2d2d 2d0a 0a20 2020 2a20 5072 6f74 -----.. * Prot │ │ │ │ │ +0000f3c0: 6f74 7970 653a 0a0a 2020 2020 2020 2020 otype:.. │ │ │ │ │ +0000f3d0: 2020 6772 7562 5f65 7272 5f74 0a20 2020 grub_err_t. │ │ │ │ │ +0000f3e0: 2020 2020 2020 2067 7275 625f 7669 6465 grub_vide │ │ │ │ │ +0000f3f0: 6f5f 7365 745f 6163 7469 7665 5f72 656e o_set_active_ren │ │ │ │ │ +0000f400: 6465 725f 7461 7267 6574 2028 7374 7275 der_target (stru │ │ │ │ │ +0000f410: 6374 2067 7275 625f 7669 6465 6f5f 7265 ct grub_video_re │ │ │ │ │ +0000f420: 6e64 6572 5f74 6172 6765 7420 2a74 6172 nder_target *tar │ │ │ │ │ +0000f430: 6765 7429 3b0a 2020 202a 2044 6573 6372 get);. * Descr │ │ │ │ │ +0000f440: 6970 7469 6f6e 3a0a 0a20 2020 2020 5365 iption:.. Se │ │ │ │ │ +0000f450: 7473 2061 6374 6976 6520 7265 6e64 6572 ts active render │ │ │ │ │ +0000f460: 2074 6172 6765 742e 2020 4966 2074 6869 target. If thi │ │ │ │ │ +0000f470: 7320 636f 6d61 6e64 2069 7320 7375 6363 s comand is succ │ │ │ │ │ +0000f480: 6573 7366 756c 2061 6c6c 0a20 2020 2020 essful all. │ │ │ │ │ +0000f490: 6472 6177 696e 6720 636f 6d6d 616e 6473 drawing commands │ │ │ │ │ +0000f4a0: 2077 696c 6c20 6265 2064 6f6e 6520 746f will be done to │ │ │ │ │ +0000f4b0: 2073 7065 6369 6669 6564 2027 7461 7267 specified 'targ │ │ │ │ │ +0000f4c0: 6574 272e 2020 5468 6572 6520 6973 2061 et'. There is a │ │ │ │ │ +0000f4d0: 6c73 6f0a 2020 2020 2073 7065 6369 616c lso. special │ │ │ │ │ +0000f4e0: 2076 616c 7565 7320 666f 7220 7461 7267 values for targ │ │ │ │ │ +0000f4f0: 6574 2c20 2747 5255 425f 5649 4445 4f5f et, 'GRUB_VIDEO_ │ │ │ │ │ +0000f500: 5245 4e44 4552 5f54 4152 4745 545f 4449 RENDER_TARGET_DI │ │ │ │ │ +0000f510: 5350 4c41 5927 2075 7365 640a 2020 2020 SPLAY' used. │ │ │ │ │ +0000f520: 2074 6f20 7265 6665 7265 6e63 6520 7363 to reference sc │ │ │ │ │ +0000f530: 7265 656e 2773 2066 726f 6e74 2062 7566 reen's front buf │ │ │ │ │ +0000f540: 6665 722c 0a20 2020 2020 2747 5255 425f fer,. 'GRUB_ │ │ │ │ │ +0000f550: 5649 4445 4f5f 5245 4e44 4552 5f54 4152 VIDEO_RENDER_TAR │ │ │ │ │ +0000f560: 4745 545f 4652 4f4e 545f 4255 4646 4552 GET_FRONT_BUFFER │ │ │ │ │ +0000f570: 2720 7573 6564 2074 6f20 7265 6665 7265 ' used to refere │ │ │ │ │ +0000f580: 6e63 6520 7363 7265 656e 2773 0a20 2020 nce screen's. │ │ │ │ │ +0000f590: 2020 6672 6f6e 7420 6275 6666 6572 2028 front buffer ( │ │ │ │ │ +0000f5a0: 616c 6961 7320 666f 7220 2747 5255 425f alias for 'GRUB_ │ │ │ │ │ +0000f5b0: 5649 4445 4f5f 5245 4e44 4552 5f54 4152 VIDEO_RENDER_TAR │ │ │ │ │ +0000f5c0: 4745 545f 4449 5350 4c41 5927 2920 616e GET_DISPLAY') an │ │ │ │ │ +0000f5d0: 640a 2020 2020 2027 4752 5542 5f56 4944 d. 'GRUB_VID │ │ │ │ │ +0000f5e0: 454f 5f52 454e 4445 525f 5441 5247 4554 EO_RENDER_TARGET │ │ │ │ │ +0000f5f0: 5f42 4143 4b5f 4255 4646 4552 2720 7573 _BACK_BUFFER' us │ │ │ │ │ +0000f600: 6564 2074 6f20 7265 6665 7265 6e63 6520 ed to reference │ │ │ │ │ +0000f610: 6261 636b 0a20 2020 2020 6275 6666 6572 back. buffer │ │ │ │ │ +0000f620: 2028 6966 2064 6f75 626c 6520 6275 6666 (if double buff │ │ │ │ │ +0000f630: 6572 696e 6720 6973 2065 6e61 626c 6564 ering is enabled │ │ │ │ │ +0000f640: 292e 2020 4966 2072 656e 6465 7220 7461 ). If render ta │ │ │ │ │ +0000f650: 7267 6574 2069 730a 2020 2020 2063 6f72 rget is. cor │ │ │ │ │ +0000f660: 7265 636c 7479 2073 7769 7463 6865 6420 reclty switched │ │ │ │ │ +0000f670: 4752 5542 5f45 5252 5f4e 4f4e 4520 6973 GRUB_ERR_NONE is │ │ │ │ │ +0000f680: 2072 6574 7572 6e65 642e 2020 496e 206e returned. In n │ │ │ │ │ +0000f690: 6f20 616e 7920 6576 656e 740a 2020 2020 o any event. │ │ │ │ │ +0000f6a0: 2073 6861 6c6c 2074 6865 7265 2062 6520 shall there be │ │ │ │ │ +0000f6b0: 6e6f 6e20 6472 6177 6162 6c65 2061 6374 non drawable act │ │ │ │ │ +0000f6c0: 6976 6520 7265 6e64 6572 2074 6172 6765 ive render targe │ │ │ │ │ +0000f6d0: 742e 0a0a 3130 2e31 2e32 3620 6772 7562 t...10.1.26 grub │ │ │ │ │ +0000f6e0: 5f76 6964 656f 5f67 6574 5f61 6374 6976 _video_get_activ │ │ │ │ │ +0000f6f0: 655f 7265 6e64 6572 5f74 6172 6765 740a e_render_target. │ │ │ │ │ 0000f700: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000f710: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000f720: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 2a20 ---------.. * │ │ │ │ │ -0000f730: 5072 6f74 6f74 7970 653a 0a0a 2020 2020 Prototype:.. │ │ │ │ │ -0000f740: 2020 2020 2020 6772 7562 5f65 7272 5f74 grub_err_t │ │ │ │ │ -0000f750: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ -0000f760: 7669 6465 6f5f 6765 745f 6163 7469 7665 video_get_active │ │ │ │ │ -0000f770: 5f72 656e 6465 725f 7461 7267 6574 2028 _render_target ( │ │ │ │ │ -0000f780: 7374 7275 6374 2067 7275 625f 7669 6465 struct grub_vide │ │ │ │ │ -0000f790: 6f5f 7265 6e64 6572 5f74 6172 6765 7420 o_render_target │ │ │ │ │ -0000f7a0: 2a2a 7461 7267 6574 293b 0a20 2020 2a20 **target);. * │ │ │ │ │ -0000f7b0: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ -0000f7c0: 2020 2052 6574 7572 6e73 2063 7572 7265 Returns curre │ │ │ │ │ -0000f7d0: 6e74 6c79 2061 6374 6976 6520 7265 6e64 ntly active rend │ │ │ │ │ -0000f7e0: 6572 2074 6172 6765 742e 2020 4974 2072 er target. It r │ │ │ │ │ -0000f7f0: 6574 7572 6e73 2076 616c 7565 2069 6e0a eturns value in. │ │ │ │ │ -0000f800: 2020 2020 2027 7461 7267 6574 2720 7468 'target' th │ │ │ │ │ -0000f810: 6174 2063 616e 2062 6520 7375 6273 6571 at can be subseq │ │ │ │ │ -0000f820: 7565 6e74 6c79 2069 7373 7565 6420 6261 uently issued ba │ │ │ │ │ -0000f830: 636b 2074 6f0a 2020 2020 2027 6772 7562 ck to. 'grub │ │ │ │ │ -0000f840: 5f76 6964 656f 5f73 6574 5f61 6374 6976 _video_set_activ │ │ │ │ │ -0000f850: 655f 7265 6e64 6572 5f74 6172 6765 7427 e_render_target' │ │ │ │ │ -0000f860: 2e0a 0a1f 0a46 696c 653a 2067 7275 622d .....File: grub- │ │ │ │ │ -0000f870: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ │ -0000f880: 2045 7861 6d70 6c65 2075 7361 6765 206f Example usage o │ │ │ │ │ -0000f890: 6620 5669 6465 6f20 4150 492c 2020 4e65 f Video API, Ne │ │ │ │ │ -0000f8a0: 7874 3a20 4269 746d 6170 2041 5049 2c20 xt: Bitmap API, │ │ │ │ │ -0000f8b0: 2050 7265 763a 2056 6964 656f 2041 5049 Prev: Video API │ │ │ │ │ -0000f8c0: 2c20 2055 703a 2056 6964 656f 2053 7562 , Up: Video Sub │ │ │ │ │ -0000f8d0: 7379 7374 656d 0a0a 3130 2e32 2045 7861 system..10.2 Exa │ │ │ │ │ -0000f8e0: 6d70 6c65 2075 7361 6765 206f 6620 5669 mple usage of Vi │ │ │ │ │ -0000f8f0: 6465 6f20 4150 490a 3d3d 3d3d 3d3d 3d3d deo API.======== │ │ │ │ │ +0000f720: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ │ +0000f730: 2a20 5072 6f74 6f74 7970 653a 0a0a 2020 * Prototype:.. │ │ │ │ │ +0000f740: 2020 2020 2020 2020 6772 7562 5f65 7272 grub_err │ │ │ │ │ +0000f750: 5f74 0a20 2020 2020 2020 2020 2067 7275 _t. gru │ │ │ │ │ +0000f760: 625f 7669 6465 6f5f 6765 745f 6163 7469 b_video_get_acti │ │ │ │ │ +0000f770: 7665 5f72 656e 6465 725f 7461 7267 6574 ve_render_target │ │ │ │ │ +0000f780: 2028 7374 7275 6374 2067 7275 625f 7669 (struct grub_vi │ │ │ │ │ +0000f790: 6465 6f5f 7265 6e64 6572 5f74 6172 6765 deo_render_targe │ │ │ │ │ +0000f7a0: 7420 2a2a 7461 7267 6574 293b 0a20 2020 t **target);. │ │ │ │ │ +0000f7b0: 2a20 4465 7363 7269 7074 696f 6e3a 0a0a * Description:.. │ │ │ │ │ +0000f7c0: 2020 2020 2052 6574 7572 6e73 2063 7572 Returns cur │ │ │ │ │ +0000f7d0: 7265 6e74 6c79 2061 6374 6976 6520 7265 rently active re │ │ │ │ │ +0000f7e0: 6e64 6572 2074 6172 6765 742e 2020 4974 nder target. It │ │ │ │ │ +0000f7f0: 2072 6574 7572 6e73 2076 616c 7565 2069 returns value i │ │ │ │ │ +0000f800: 6e0a 2020 2020 2027 7461 7267 6574 2720 n. 'target' │ │ │ │ │ +0000f810: 7468 6174 2063 616e 2062 6520 7375 6273 that can be subs │ │ │ │ │ +0000f820: 6571 7565 6e74 6c79 2069 7373 7565 6420 equently issued │ │ │ │ │ +0000f830: 6261 636b 2074 6f0a 2020 2020 2027 6772 back to. 'gr │ │ │ │ │ +0000f840: 7562 5f76 6964 656f 5f73 6574 5f61 6374 ub_video_set_act │ │ │ │ │ +0000f850: 6976 655f 7265 6e64 6572 5f74 6172 6765 ive_render_targe │ │ │ │ │ +0000f860: 7427 2e0a 0a1f 0a46 696c 653a 2067 7275 t'.....File: gru │ │ │ │ │ +0000f870: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +0000f880: 653a 2045 7861 6d70 6c65 2075 7361 6765 e: Example usage │ │ │ │ │ +0000f890: 206f 6620 5669 6465 6f20 4150 492c 2020 of Video API, │ │ │ │ │ +0000f8a0: 4e65 7874 3a20 4269 746d 6170 2041 5049 Next: Bitmap API │ │ │ │ │ +0000f8b0: 2c20 2050 7265 763a 2056 6964 656f 2041 , Prev: Video A │ │ │ │ │ +0000f8c0: 5049 2c20 2055 703a 2056 6964 656f 2053 PI, Up: Video S │ │ │ │ │ +0000f8d0: 7562 7379 7374 656d 0a0a 3130 2e32 2045 ubsystem..10.2 E │ │ │ │ │ +0000f8e0: 7861 6d70 6c65 2075 7361 6765 206f 6620 xample usage of │ │ │ │ │ +0000f8f0: 5669 6465 6f20 4150 490a 3d3d 3d3d 3d3d Video API.====== │ │ │ │ │ 0000f900: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000f910: 3d3d 3d3d 3d3d 3d0a 0a31 302e 322e 3120 =======..10.2.1 │ │ │ │ │ -0000f920: 4578 616d 706c 6520 6f66 2073 6372 6565 Example of scree │ │ │ │ │ -0000f930: 6e20 7365 7475 700a 2d2d 2d2d 2d2d 2d2d n setup.-------- │ │ │ │ │ +0000f910: 3d3d 3d3d 3d3d 3d3d 3d0a 0a31 302e 322e =========..10.2. │ │ │ │ │ +0000f920: 3120 4578 616d 706c 6520 6f66 2073 6372 1 Example of scr │ │ │ │ │ +0000f930: 6565 6e20 7365 7475 700a 2d2d 2d2d 2d2d een setup.------ │ │ │ │ │ 0000f940: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000f950: 2d2d 2d2d 2d2d 0a0a 2020 2020 2067 7275 ------.. gru │ │ │ │ │ -0000f960: 625f 6572 725f 7420 7263 3b0a 2020 2020 b_err_t rc;. │ │ │ │ │ -0000f970: 202f 2a20 5472 7920 746f 2069 6e69 7469 /* Try to initi │ │ │ │ │ -0000f980: 616c 697a 6520 7669 6465 6f20 6d6f 6465 alize video mode │ │ │ │ │ -0000f990: 2031 3032 3420 7820 3736 3820 7769 7468 1024 x 768 with │ │ │ │ │ -0000f9a0: 2064 6972 6563 7420 5247 422e 2020 2a2f direct RGB. */ │ │ │ │ │ -0000f9b0: 0a20 2020 2020 7263 203d 2067 7275 625f . rc = grub_ │ │ │ │ │ -0000f9c0: 7669 6465 6f5f 7365 7475 7020 2831 3032 video_setup (102 │ │ │ │ │ -0000f9d0: 342c 2037 3638 2c20 4752 5542 5f56 4944 4, 768, GRUB_VID │ │ │ │ │ -0000f9e0: 454f 5f4d 4f44 455f 5459 5045 5f52 4742 EO_MODE_TYPE_RGB │ │ │ │ │ -0000f9f0: 293b 0a20 2020 2020 6966 2028 7263 2021 );. if (rc ! │ │ │ │ │ -0000fa00: 3d20 4752 5542 5f45 5252 5f4e 4f4e 4529 = GRUB_ERR_NONE) │ │ │ │ │ -0000fa10: 0a20 2020 2020 7b0a 2020 2020 2020 202f . {. / │ │ │ │ │ -0000fa20: 2a20 4661 6c6c 2062 6163 6b20 746f 2073 * Fall back to s │ │ │ │ │ -0000fa30: 7461 6e64 6172 6420 5647 4120 496e 6465 tandard VGA Inde │ │ │ │ │ -0000fa40: 7820 436f 6c6f 7220 6d6f 6465 2e20 202a x Color mode. * │ │ │ │ │ -0000fa50: 2f0a 2020 2020 2020 2072 6320 3d20 6772 /. rc = gr │ │ │ │ │ -0000fa60: 7562 5f76 6964 656f 5f73 6574 7570 2028 ub_video_setup ( │ │ │ │ │ -0000fa70: 3634 302c 2034 3830 2c20 4752 5542 5f56 640, 480, GRUB_V │ │ │ │ │ -0000fa80: 4944 454f 5f4d 4f44 455f 5459 5045 5f49 IDEO_MODE_TYPE_I │ │ │ │ │ -0000fa90: 4e44 4558 293b 0a20 2020 2020 2020 6966 NDEX);. if │ │ │ │ │ -0000faa0: 2028 7263 2021 3d20 4752 5542 5f45 5252 (rc != GRUB_ERR │ │ │ │ │ -0000fab0: 5f4e 4f4e 4529 0a20 2020 2020 2020 7b0a _NONE). {. │ │ │ │ │ -0000fac0: 2020 2020 2020 202f 2a20 4861 6e64 6c65 /* Handle │ │ │ │ │ -0000fad0: 2065 7272 6f72 2e20 202a 2f0a 2020 2020 error. */. │ │ │ │ │ -0000fae0: 2020 207d 0a20 2020 2020 7d0a 0a31 302e }. }..10. │ │ │ │ │ -0000faf0: 322e 3220 4578 616d 706c 6520 6f66 2073 2.2 Example of s │ │ │ │ │ -0000fb00: 6574 7469 6e67 2075 7020 636f 6e73 6f6c etting up consol │ │ │ │ │ -0000fb10: 6520 7669 6577 706f 7274 0a2d 2d2d 2d2d e viewport.----- │ │ │ │ │ +0000f950: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 2020 2067 --------.. g │ │ │ │ │ +0000f960: 7275 625f 6572 725f 7420 7263 3b0a 2020 rub_err_t rc;. │ │ │ │ │ +0000f970: 2020 202f 2a20 5472 7920 746f 2069 6e69 /* Try to ini │ │ │ │ │ +0000f980: 7469 616c 697a 6520 7669 6465 6f20 6d6f tialize video mo │ │ │ │ │ +0000f990: 6465 2031 3032 3420 7820 3736 3820 7769 de 1024 x 768 wi │ │ │ │ │ +0000f9a0: 7468 2064 6972 6563 7420 5247 422e 2020 th direct RGB. │ │ │ │ │ +0000f9b0: 2a2f 0a20 2020 2020 7263 203d 2067 7275 */. rc = gru │ │ │ │ │ +0000f9c0: 625f 7669 6465 6f5f 7365 7475 7020 2831 b_video_setup (1 │ │ │ │ │ +0000f9d0: 3032 342c 2037 3638 2c20 4752 5542 5f56 024, 768, GRUB_V │ │ │ │ │ +0000f9e0: 4944 454f 5f4d 4f44 455f 5459 5045 5f52 IDEO_MODE_TYPE_R │ │ │ │ │ +0000f9f0: 4742 293b 0a20 2020 2020 6966 2028 7263 GB);. if (rc │ │ │ │ │ +0000fa00: 2021 3d20 4752 5542 5f45 5252 5f4e 4f4e != GRUB_ERR_NON │ │ │ │ │ +0000fa10: 4529 0a20 2020 2020 7b0a 2020 2020 2020 E). {. │ │ │ │ │ +0000fa20: 202f 2a20 4661 6c6c 2062 6163 6b20 746f /* Fall back to │ │ │ │ │ +0000fa30: 2073 7461 6e64 6172 6420 5647 4120 496e standard VGA In │ │ │ │ │ +0000fa40: 6465 7820 436f 6c6f 7220 6d6f 6465 2e20 dex Color mode. │ │ │ │ │ +0000fa50: 202a 2f0a 2020 2020 2020 2072 6320 3d20 */. rc = │ │ │ │ │ +0000fa60: 6772 7562 5f76 6964 656f 5f73 6574 7570 grub_video_setup │ │ │ │ │ +0000fa70: 2028 3634 302c 2034 3830 2c20 4752 5542 (640, 480, GRUB │ │ │ │ │ +0000fa80: 5f56 4944 454f 5f4d 4f44 455f 5459 5045 _VIDEO_MODE_TYPE │ │ │ │ │ +0000fa90: 5f49 4e44 4558 293b 0a20 2020 2020 2020 _INDEX);. │ │ │ │ │ +0000faa0: 6966 2028 7263 2021 3d20 4752 5542 5f45 if (rc != GRUB_E │ │ │ │ │ +0000fab0: 5252 5f4e 4f4e 4529 0a20 2020 2020 2020 RR_NONE). │ │ │ │ │ +0000fac0: 7b0a 2020 2020 2020 202f 2a20 4861 6e64 {. /* Hand │ │ │ │ │ +0000fad0: 6c65 2065 7272 6f72 2e20 202a 2f0a 2020 le error. */. │ │ │ │ │ +0000fae0: 2020 2020 207d 0a20 2020 2020 7d0a 0a31 }. }..1 │ │ │ │ │ +0000faf0: 302e 322e 3220 4578 616d 706c 6520 6f66 0.2.2 Example of │ │ │ │ │ +0000fb00: 2073 6574 7469 6e67 2075 7020 636f 6e73 setting up cons │ │ │ │ │ +0000fb10: 6f6c 6520 7669 6577 706f 7274 0a2d 2d2d ole viewport.--- │ │ │ │ │ 0000fb20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0000fb30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000fb40: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 2020 2067 --------.. g │ │ │ │ │ -0000fb50: 7275 625f 7569 6e74 3332 5f74 2078 2c20 rub_uint32_t x, │ │ │ │ │ -0000fb60: 792c 2077 6964 7468 2c20 6865 6967 6874 y, width, height │ │ │ │ │ -0000fb70: 3b0a 2020 2020 2067 7275 625f 7669 6465 ;. grub_vide │ │ │ │ │ -0000fb80: 6f5f 636f 6c6f 725f 7420 636f 6c6f 723b o_color_t color; │ │ │ │ │ -0000fb90: 0a20 2020 2020 7374 7275 6374 2067 7275 . struct gru │ │ │ │ │ -0000fba0: 625f 666f 6e74 5f67 6c79 7068 2067 6c79 b_font_glyph gly │ │ │ │ │ -0000fbb0: 7068 3b0a 2020 2020 2067 7275 625f 6572 ph;. grub_er │ │ │ │ │ -0000fbc0: 725f 7420 7263 3b0a 2020 2020 202f 2a20 r_t rc;. /* │ │ │ │ │ -0000fbd0: 5175 6572 7920 6578 6973 7469 6e67 2076 Query existing v │ │ │ │ │ -0000fbe0: 6965 7770 6f72 742e 2020 2a2f 0a20 2020 iewport. */. │ │ │ │ │ -0000fbf0: 2020 6772 7562 5f76 6964 656f 5f67 6574 grub_video_get │ │ │ │ │ -0000fc00: 5f76 6965 7770 6f72 7420 2826 782c 2026 _viewport (&x, & │ │ │ │ │ -0000fc10: 792c 2026 7769 6474 682c 2026 6865 6967 y, &width, &heig │ │ │ │ │ -0000fc20: 6874 293b 0a20 2020 2020 2f2a 2046 696c ht);. /* Fil │ │ │ │ │ -0000fc30: 6c20 6261 636b 6772 6f75 6e64 2e20 202a l background. * │ │ │ │ │ -0000fc40: 2f0a 2020 2020 2063 6f6c 6f72 203d 2067 /. color = g │ │ │ │ │ -0000fc50: 7275 625f 7669 6465 6f5f 6d61 705f 636f rub_video_map_co │ │ │ │ │ -0000fc60: 6c6f 7220 2847 5255 425f 434f 4c4f 525f lor (GRUB_COLOR_ │ │ │ │ │ -0000fc70: 4241 434b 4752 4f55 4e44 293b 0a20 2020 BACKGROUND);. │ │ │ │ │ -0000fc80: 2020 6772 7562 5f76 6964 656f 5f66 696c grub_video_fil │ │ │ │ │ -0000fc90: 6c5f 7265 6374 2028 636f 6c6f 722c 2030 l_rect (color, 0 │ │ │ │ │ -0000fca0: 2c20 302c 2077 6964 7468 2c20 6865 6967 , 0, width, heig │ │ │ │ │ -0000fcb0: 6874 293b 0a20 2020 2020 2f2a 2053 6574 ht);. /* Set │ │ │ │ │ -0000fcc0: 7570 2063 6f6e 736f 6c65 2076 6965 7770 up console viewp │ │ │ │ │ -0000fcd0: 6f72 742e 2020 2a2f 0a20 2020 2020 6772 ort. */. gr │ │ │ │ │ -0000fce0: 7562 5f76 6964 656f 5f73 6574 5f76 6965 ub_video_set_vie │ │ │ │ │ -0000fcf0: 7770 6f72 7420 2878 202b 2031 302c 2079 wport (x + 10, y │ │ │ │ │ -0000fd00: 202b 2031 302c 2077 6964 7468 202d 2032 + 10, width - 2 │ │ │ │ │ -0000fd10: 302c 2068 6569 6768 7420 2d20 3230 293b 0, height - 20); │ │ │ │ │ -0000fd20: 0a20 2020 2020 6772 7562 5f76 6964 656f . grub_video │ │ │ │ │ -0000fd30: 5f67 6574 5f76 6965 7770 6f72 7420 2826 _get_viewport (& │ │ │ │ │ -0000fd40: 782c 2026 792c 2026 7769 6474 682c 2026 x, &y, &width, & │ │ │ │ │ -0000fd50: 6865 6967 6874 293b 0a20 2020 2020 636f height);. co │ │ │ │ │ -0000fd60: 6c6f 7220 3d20 6772 7562 5f76 6964 656f lor = grub_video │ │ │ │ │ -0000fd70: 5f6d 6170 5f63 6f6c 6f72 2028 4752 5542 _map_color (GRUB │ │ │ │ │ -0000fd80: 5f43 4f4c 4f52 5f43 4f4e 534f 4c45 5f42 _COLOR_CONSOLE_B │ │ │ │ │ -0000fd90: 4143 4b47 524f 554e 4429 3b0a 2020 2020 ACKGROUND);. │ │ │ │ │ -0000fda0: 2067 7275 625f 7669 6465 6f5f 6669 6c6c grub_video_fill │ │ │ │ │ -0000fdb0: 5f72 6563 7420 2863 6f6c 6f72 2c20 302c _rect (color, 0, │ │ │ │ │ -0000fdc0: 2030 2c20 7769 6474 682c 2068 6569 6768 0, width, heigh │ │ │ │ │ -0000fdd0: 7429 3b0a 2020 2020 202f 2a20 4472 6177 t);. /* Draw │ │ │ │ │ -0000fde0: 2074 6578 7420 746f 2076 6965 7770 6f72 text to viewpor │ │ │ │ │ -0000fdf0: 742e 2020 2a2f 0a20 2020 2020 636f 6c6f t. */. colo │ │ │ │ │ -0000fe00: 7220 3d20 6772 7562 5f76 6964 656f 5f6d r = grub_video_m │ │ │ │ │ -0000fe10: 6170 5f63 6f6c 6f72 2028 4752 5542 5f43 ap_color (GRUB_C │ │ │ │ │ -0000fe20: 4f4c 4f52 5f43 4f4e 534f 4c45 5f54 4558 OLOR_CONSOLE_TEX │ │ │ │ │ -0000fe30: 5429 3b0a 2020 2020 2067 7275 625f 666f T);. grub_fo │ │ │ │ │ -0000fe40: 6e74 5f67 6574 5f67 6c79 7068 2028 2758 nt_get_glyph ('X │ │ │ │ │ -0000fe50: 272c 2026 676c 7970 6829 3b0a 2020 2020 ', &glyph);. │ │ │ │ │ -0000fe60: 2067 7275 625f 7669 6465 6f5f 626c 6974 grub_video_blit │ │ │ │ │ -0000fe70: 5f67 6c79 7068 2028 2667 6c79 7068 2c20 _glyph (&glyph, │ │ │ │ │ -0000fe80: 636f 6c6f 722c 2030 2c20 3029 3b0a 0a1f color, 0, 0);... │ │ │ │ │ -0000fe90: 0a46 696c 653a 2067 7275 622d 6465 762e .File: grub-dev. │ │ │ │ │ -0000fea0: 696e 666f 2c20 204e 6f64 653a 2042 6974 info, Node: Bit │ │ │ │ │ -0000feb0: 6d61 7020 4150 492c 2020 5072 6576 3a20 map API, Prev: │ │ │ │ │ -0000fec0: 4578 616d 706c 6520 7573 6167 6520 6f66 Example usage of │ │ │ │ │ -0000fed0: 2056 6964 656f 2041 5049 2c20 2055 703a Video API, Up: │ │ │ │ │ -0000fee0: 2056 6964 656f 2053 7562 7379 7374 656d Video Subsystem │ │ │ │ │ -0000fef0: 0a0a 3130 2e33 2042 6974 6d61 7020 4150 ..10.3 Bitmap AP │ │ │ │ │ -0000ff00: 490a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d I.============== │ │ │ │ │ -0000ff10: 3d0a 0a31 302e 332e 3120 6772 7562 5f76 =..10.3.1 grub_v │ │ │ │ │ -0000ff20: 6964 656f 5f62 6974 6d61 705f 6372 6561 ideo_bitmap_crea │ │ │ │ │ -0000ff30: 7465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d te.------------- │ │ │ │ │ +0000fb40: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 2020 ----------.. │ │ │ │ │ +0000fb50: 2067 7275 625f 7569 6e74 3332 5f74 2078 grub_uint32_t x │ │ │ │ │ +0000fb60: 2c20 792c 2077 6964 7468 2c20 6865 6967 , y, width, heig │ │ │ │ │ +0000fb70: 6874 3b0a 2020 2020 2067 7275 625f 7669 ht;. grub_vi │ │ │ │ │ +0000fb80: 6465 6f5f 636f 6c6f 725f 7420 636f 6c6f deo_color_t colo │ │ │ │ │ +0000fb90: 723b 0a20 2020 2020 7374 7275 6374 2067 r;. struct g │ │ │ │ │ +0000fba0: 7275 625f 666f 6e74 5f67 6c79 7068 2067 rub_font_glyph g │ │ │ │ │ +0000fbb0: 6c79 7068 3b0a 2020 2020 2067 7275 625f lyph;. grub_ │ │ │ │ │ +0000fbc0: 6572 725f 7420 7263 3b0a 2020 2020 202f err_t rc;. / │ │ │ │ │ +0000fbd0: 2a20 5175 6572 7920 6578 6973 7469 6e67 * Query existing │ │ │ │ │ +0000fbe0: 2076 6965 7770 6f72 742e 2020 2a2f 0a20 viewport. */. │ │ │ │ │ +0000fbf0: 2020 2020 6772 7562 5f76 6964 656f 5f67 grub_video_g │ │ │ │ │ +0000fc00: 6574 5f76 6965 7770 6f72 7420 2826 782c et_viewport (&x, │ │ │ │ │ +0000fc10: 2026 792c 2026 7769 6474 682c 2026 6865 &y, &width, &he │ │ │ │ │ +0000fc20: 6967 6874 293b 0a20 2020 2020 2f2a 2046 ight);. /* F │ │ │ │ │ +0000fc30: 696c 6c20 6261 636b 6772 6f75 6e64 2e20 ill background. │ │ │ │ │ +0000fc40: 202a 2f0a 2020 2020 2063 6f6c 6f72 203d */. color = │ │ │ │ │ +0000fc50: 2067 7275 625f 7669 6465 6f5f 6d61 705f grub_video_map_ │ │ │ │ │ +0000fc60: 636f 6c6f 7220 2847 5255 425f 434f 4c4f color (GRUB_COLO │ │ │ │ │ +0000fc70: 525f 4241 434b 4752 4f55 4e44 293b 0a20 R_BACKGROUND);. │ │ │ │ │ +0000fc80: 2020 2020 6772 7562 5f76 6964 656f 5f66 grub_video_f │ │ │ │ │ +0000fc90: 696c 6c5f 7265 6374 2028 636f 6c6f 722c ill_rect (color, │ │ │ │ │ +0000fca0: 2030 2c20 302c 2077 6964 7468 2c20 6865 0, 0, width, he │ │ │ │ │ +0000fcb0: 6967 6874 293b 0a20 2020 2020 2f2a 2053 ight);. /* S │ │ │ │ │ +0000fcc0: 6574 7570 2063 6f6e 736f 6c65 2076 6965 etup console vie │ │ │ │ │ +0000fcd0: 7770 6f72 742e 2020 2a2f 0a20 2020 2020 wport. */. │ │ │ │ │ +0000fce0: 6772 7562 5f76 6964 656f 5f73 6574 5f76 grub_video_set_v │ │ │ │ │ +0000fcf0: 6965 7770 6f72 7420 2878 202b 2031 302c iewport (x + 10, │ │ │ │ │ +0000fd00: 2079 202b 2031 302c 2077 6964 7468 202d y + 10, width - │ │ │ │ │ +0000fd10: 2032 302c 2068 6569 6768 7420 2d20 3230 20, height - 20 │ │ │ │ │ +0000fd20: 293b 0a20 2020 2020 6772 7562 5f76 6964 );. grub_vid │ │ │ │ │ +0000fd30: 656f 5f67 6574 5f76 6965 7770 6f72 7420 eo_get_viewport │ │ │ │ │ +0000fd40: 2826 782c 2026 792c 2026 7769 6474 682c (&x, &y, &width, │ │ │ │ │ +0000fd50: 2026 6865 6967 6874 293b 0a20 2020 2020 &height);. │ │ │ │ │ +0000fd60: 636f 6c6f 7220 3d20 6772 7562 5f76 6964 color = grub_vid │ │ │ │ │ +0000fd70: 656f 5f6d 6170 5f63 6f6c 6f72 2028 4752 eo_map_color (GR │ │ │ │ │ +0000fd80: 5542 5f43 4f4c 4f52 5f43 4f4e 534f 4c45 UB_COLOR_CONSOLE │ │ │ │ │ +0000fd90: 5f42 4143 4b47 524f 554e 4429 3b0a 2020 _BACKGROUND);. │ │ │ │ │ +0000fda0: 2020 2067 7275 625f 7669 6465 6f5f 6669 grub_video_fi │ │ │ │ │ +0000fdb0: 6c6c 5f72 6563 7420 2863 6f6c 6f72 2c20 ll_rect (color, │ │ │ │ │ +0000fdc0: 302c 2030 2c20 7769 6474 682c 2068 6569 0, 0, width, hei │ │ │ │ │ +0000fdd0: 6768 7429 3b0a 2020 2020 202f 2a20 4472 ght);. /* Dr │ │ │ │ │ +0000fde0: 6177 2074 6578 7420 746f 2076 6965 7770 aw text to viewp │ │ │ │ │ +0000fdf0: 6f72 742e 2020 2a2f 0a20 2020 2020 636f ort. */. co │ │ │ │ │ +0000fe00: 6c6f 7220 3d20 6772 7562 5f76 6964 656f lor = grub_video │ │ │ │ │ +0000fe10: 5f6d 6170 5f63 6f6c 6f72 2028 4752 5542 _map_color (GRUB │ │ │ │ │ +0000fe20: 5f43 4f4c 4f52 5f43 4f4e 534f 4c45 5f54 _COLOR_CONSOLE_T │ │ │ │ │ +0000fe30: 4558 5429 3b0a 2020 2020 2067 7275 625f EXT);. grub_ │ │ │ │ │ +0000fe40: 666f 6e74 5f67 6574 5f67 6c79 7068 2028 font_get_glyph ( │ │ │ │ │ +0000fe50: 2758 272c 2026 676c 7970 6829 3b0a 2020 'X', &glyph);. │ │ │ │ │ +0000fe60: 2020 2067 7275 625f 7669 6465 6f5f 626c grub_video_bl │ │ │ │ │ +0000fe70: 6974 5f67 6c79 7068 2028 2667 6c79 7068 it_glyph (&glyph │ │ │ │ │ +0000fe80: 2c20 636f 6c6f 722c 2030 2c20 3029 3b0a , color, 0, 0);. │ │ │ │ │ +0000fe90: 0a1f 0a46 696c 653a 2067 7275 622d 6465 ...File: grub-de │ │ │ │ │ +0000fea0: 762e 696e 666f 2c20 204e 6f64 653a 2042 v.info, Node: B │ │ │ │ │ +0000feb0: 6974 6d61 7020 4150 492c 2020 5072 6576 itmap API, Prev │ │ │ │ │ +0000fec0: 3a20 4578 616d 706c 6520 7573 6167 6520 : Example usage │ │ │ │ │ +0000fed0: 6f66 2056 6964 656f 2041 5049 2c20 2055 of Video API, U │ │ │ │ │ +0000fee0: 703a 2056 6964 656f 2053 7562 7379 7374 p: Video Subsyst │ │ │ │ │ +0000fef0: 656d 0a0a 3130 2e33 2042 6974 6d61 7020 em..10.3 Bitmap │ │ │ │ │ +0000ff00: 4150 490a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d API.============ │ │ │ │ │ +0000ff10: 3d3d 3d0a 0a31 302e 332e 3120 6772 7562 ===..10.3.1 grub │ │ │ │ │ +0000ff20: 5f76 6964 656f 5f62 6974 6d61 705f 6372 _video_bitmap_cr │ │ │ │ │ +0000ff30: 6561 7465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d eate.----------- │ │ │ │ │ 0000ff40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0000ff50: 2d2d 0a0a 2020 202a 2050 726f 746f 7479 --.. * Prototy │ │ │ │ │ -0000ff60: 7065 3a0a 2020 2020 2020 2020 2020 6772 pe:. gr │ │ │ │ │ -0000ff70: 7562 5f65 7272 5f74 2067 7275 625f 7669 ub_err_t grub_vi │ │ │ │ │ -0000ff80: 6465 6f5f 6269 746d 6170 5f63 7265 6174 deo_bitmap_creat │ │ │ │ │ -0000ff90: 6520 2873 7472 7563 7420 6772 7562 5f76 e (struct grub_v │ │ │ │ │ -0000ffa0: 6964 656f 5f62 6974 6d61 7020 2a2a 6269 ideo_bitmap **bi │ │ │ │ │ -0000ffb0: 746d 6170 2c20 756e 7369 676e 6564 2069 tmap, unsigned i │ │ │ │ │ -0000ffc0: 6e74 2077 6964 7468 2c20 756e 7369 676e nt width, unsign │ │ │ │ │ -0000ffd0: 6564 2069 6e74 2068 6569 6768 742c 2065 ed int height, e │ │ │ │ │ -0000ffe0: 6e75 6d20 6772 7562 5f76 6964 656f 5f62 num grub_video_b │ │ │ │ │ -0000fff0: 6c69 745f 666f 726d 6174 2062 6c69 745f lit_format blit_ │ │ │ │ │ -00010000: 666f 726d 6174 290a 0a20 2020 2a20 4465 format).. * De │ │ │ │ │ -00010010: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ -00010020: 2043 7265 6174 6573 2061 206e 6577 2062 Creates a new b │ │ │ │ │ -00010030: 6974 6d61 7020 7769 7468 2067 6976 656e itmap with given │ │ │ │ │ -00010040: 2064 696d 656e 7369 6f6e 7320 616e 6420 dimensions and │ │ │ │ │ -00010050: 626c 6974 7469 6e67 2066 6f72 6d61 742e blitting format. │ │ │ │ │ -00010060: 0a20 2020 2020 416c 6c6f 6361 7465 6420 . Allocated │ │ │ │ │ -00010070: 6269 746d 6170 2064 6174 6120 6361 6e20 bitmap data can │ │ │ │ │ -00010080: 7468 656e 2062 6520 6d6f 6469 6669 6564 then be modified │ │ │ │ │ -00010090: 2066 7265 656c 7920 616e 6420 6669 6e61 freely and fina │ │ │ │ │ -000100a0: 6c6c 790a 2020 2020 2062 6c69 7474 6564 lly. blitted │ │ │ │ │ -000100b0: 2077 6974 6820 2767 7275 625f 7669 6465 with 'grub_vide │ │ │ │ │ -000100c0: 6f5f 626c 6974 5f62 6974 6d61 7027 2074 o_blit_bitmap' t │ │ │ │ │ -000100d0: 6f20 7265 6e64 6572 696e 6720 7461 7267 o rendering targ │ │ │ │ │ -000100e0: 6574 2e0a 0a31 302e 332e 3220 6772 7562 et...10.3.2 grub │ │ │ │ │ -000100f0: 5f76 6964 656f 5f62 6974 6d61 705f 6465 _video_bitmap_de │ │ │ │ │ -00010100: 7374 726f 790a 2d2d 2d2d 2d2d 2d2d 2d2d stroy.---------- │ │ │ │ │ +0000ff50: 2d2d 2d2d 0a0a 2020 202a 2050 726f 746f ----.. * Proto │ │ │ │ │ +0000ff60: 7479 7065 3a0a 2020 2020 2020 2020 2020 type:. │ │ │ │ │ +0000ff70: 6772 7562 5f65 7272 5f74 2067 7275 625f grub_err_t grub_ │ │ │ │ │ +0000ff80: 7669 6465 6f5f 6269 746d 6170 5f63 7265 video_bitmap_cre │ │ │ │ │ +0000ff90: 6174 6520 2873 7472 7563 7420 6772 7562 ate (struct grub │ │ │ │ │ +0000ffa0: 5f76 6964 656f 5f62 6974 6d61 7020 2a2a _video_bitmap ** │ │ │ │ │ +0000ffb0: 6269 746d 6170 2c20 756e 7369 676e 6564 bitmap, unsigned │ │ │ │ │ +0000ffc0: 2069 6e74 2077 6964 7468 2c20 756e 7369 int width, unsi │ │ │ │ │ +0000ffd0: 676e 6564 2069 6e74 2068 6569 6768 742c gned int height, │ │ │ │ │ +0000ffe0: 2065 6e75 6d20 6772 7562 5f76 6964 656f enum grub_video │ │ │ │ │ +0000fff0: 5f62 6c69 745f 666f 726d 6174 2062 6c69 _blit_format bli │ │ │ │ │ +00010000: 745f 666f 726d 6174 290a 0a20 2020 2a20 t_format).. * │ │ │ │ │ +00010010: 4465 7363 7269 7074 696f 6e3a 0a0a 2020 Description:.. │ │ │ │ │ +00010020: 2020 2043 7265 6174 6573 2061 206e 6577 Creates a new │ │ │ │ │ +00010030: 2062 6974 6d61 7020 7769 7468 2067 6976 bitmap with giv │ │ │ │ │ +00010040: 656e 2064 696d 656e 7369 6f6e 7320 616e en dimensions an │ │ │ │ │ +00010050: 6420 626c 6974 7469 6e67 2066 6f72 6d61 d blitting forma │ │ │ │ │ +00010060: 742e 0a20 2020 2020 416c 6c6f 6361 7465 t.. Allocate │ │ │ │ │ +00010070: 6420 6269 746d 6170 2064 6174 6120 6361 d bitmap data ca │ │ │ │ │ +00010080: 6e20 7468 656e 2062 6520 6d6f 6469 6669 n then be modifi │ │ │ │ │ +00010090: 6564 2066 7265 656c 7920 616e 6420 6669 ed freely and fi │ │ │ │ │ +000100a0: 6e61 6c6c 790a 2020 2020 2062 6c69 7474 nally. blitt │ │ │ │ │ +000100b0: 6564 2077 6974 6820 2767 7275 625f 7669 ed with 'grub_vi │ │ │ │ │ +000100c0: 6465 6f5f 626c 6974 5f62 6974 6d61 7027 deo_blit_bitmap' │ │ │ │ │ +000100d0: 2074 6f20 7265 6e64 6572 696e 6720 7461 to rendering ta │ │ │ │ │ +000100e0: 7267 6574 2e0a 0a31 302e 332e 3220 6772 rget...10.3.2 gr │ │ │ │ │ +000100f0: 7562 5f76 6964 656f 5f62 6974 6d61 705f ub_video_bitmap_ │ │ │ │ │ +00010100: 6465 7374 726f 790a 2d2d 2d2d 2d2d 2d2d destroy.-------- │ │ │ │ │ 00010110: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010120: 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 726f ------.. * Pro │ │ │ │ │ -00010130: 746f 7479 7065 3a0a 2020 2020 2020 2020 totype:. │ │ │ │ │ -00010140: 2020 6772 7562 5f65 7272 5f74 2067 7275 grub_err_t gru │ │ │ │ │ -00010150: 625f 7669 6465 6f5f 6269 746d 6170 5f64 b_video_bitmap_d │ │ │ │ │ -00010160: 6573 7472 6f79 2028 7374 7275 6374 2067 estroy (struct g │ │ │ │ │ -00010170: 7275 625f 7669 6465 6f5f 6269 746d 6170 rub_video_bitmap │ │ │ │ │ -00010180: 202a 6269 746d 6170 293b 0a0a 2020 202a *bitmap);.. * │ │ │ │ │ -00010190: 2044 6573 6372 6970 7469 6f6e 3a0a 0a20 Description:.. │ │ │ │ │ -000101a0: 2020 2020 5768 656e 2062 6974 6d61 7020 When bitmap │ │ │ │ │ -000101b0: 6973 206e 6f20 6c6f 6e67 6572 206e 6565 is no longer nee │ │ │ │ │ -000101c0: 6465 642c 2069 7420 6361 6e20 6265 2066 ded, it can be f │ │ │ │ │ -000101d0: 7265 6564 2066 726f 6d20 6d65 6d6f 7279 reed from memory │ │ │ │ │ -000101e0: 2075 7369 6e67 0a20 2020 2020 7468 6973 using. this │ │ │ │ │ -000101f0: 2063 6f6d 6d61 6e64 2e20 2027 6269 746d command. 'bitm │ │ │ │ │ -00010200: 6170 2720 6973 2070 7265 7669 6f75 736c ap' is previousl │ │ │ │ │ -00010210: 7920 616c 6c6f 6361 7465 6420 6269 746d y allocated bitm │ │ │ │ │ -00010220: 6170 2077 6974 680a 2020 2020 2027 6772 ap with. 'gr │ │ │ │ │ -00010230: 7562 5f76 6964 656f 5f62 6974 6d61 705f ub_video_bitmap_ │ │ │ │ │ -00010240: 6372 6561 7465 2720 6f72 206c 6f61 6465 create' or loade │ │ │ │ │ -00010250: 6420 7769 7468 2027 6772 7562 5f76 6964 d with 'grub_vid │ │ │ │ │ -00010260: 656f 5f62 6974 6d61 705f 6c6f 6164 272e eo_bitmap_load'. │ │ │ │ │ -00010270: 0a0a 3130 2e33 2e33 2067 7275 625f 7669 ..10.3.3 grub_vi │ │ │ │ │ -00010280: 6465 6f5f 6269 746d 6170 5f6c 6f61 640a deo_bitmap_load. │ │ │ │ │ -00010290: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000102a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ -000102b0: 2020 2a20 5072 6f74 6f74 7970 653a 0a20 * Prototype:. │ │ │ │ │ -000102c0: 2020 2020 2020 2020 2067 7275 625f 6572 grub_er │ │ │ │ │ -000102d0: 725f 7420 6772 7562 5f76 6964 656f 5f62 r_t grub_video_b │ │ │ │ │ -000102e0: 6974 6d61 705f 6c6f 6164 2028 7374 7275 itmap_load (stru │ │ │ │ │ -000102f0: 6374 2067 7275 625f 7669 6465 6f5f 6269 ct grub_video_bi │ │ │ │ │ -00010300: 746d 6170 202a 2a62 6974 6d61 702c 2063 tmap **bitmap, c │ │ │ │ │ -00010310: 6f6e 7374 2063 6861 7220 2a66 696c 656e onst char *filen │ │ │ │ │ -00010320: 616d 6529 3b0a 0a20 2020 2a20 4465 7363 ame);.. * Desc │ │ │ │ │ -00010330: 7269 7074 696f 6e3a 0a0a 2020 2020 2054 ription:.. T │ │ │ │ │ -00010340: 7269 6573 2074 6f20 6c6f 6164 2067 6976 ries to load giv │ │ │ │ │ -00010350: 656e 2062 6974 6d61 7020 2827 6669 6c65 en bitmap ('file │ │ │ │ │ -00010360: 6e61 6d65 2729 2075 7369 6e67 2072 6567 name') using reg │ │ │ │ │ -00010370: 6973 7465 7265 6420 6269 746d 6170 0a20 istered bitmap. │ │ │ │ │ -00010380: 2020 2020 6c6f 6164 6572 732e 2020 496e loaders. In │ │ │ │ │ -00010390: 2063 6173 6520 6269 746d 6170 2066 6f72 case bitmap for │ │ │ │ │ -000103a0: 6d61 7420 6973 206e 6f74 2072 6563 6f67 mat is not recog │ │ │ │ │ -000103b0: 6e69 7a65 6420 6f72 2073 7570 706f 7274 nized or support │ │ │ │ │ -000103c0: 6564 0a20 2020 2020 6572 726f 7220 2747 ed. error 'G │ │ │ │ │ -000103d0: 5255 425f 4552 525f 4241 445f 4649 4c45 RUB_ERR_BAD_FILE │ │ │ │ │ -000103e0: 5f54 5950 4527 2069 7320 7265 7475 726e _TYPE' is return │ │ │ │ │ -000103f0: 6564 2e0a 0a31 302e 332e 3420 6772 7562 ed...10.3.4 grub │ │ │ │ │ -00010400: 5f76 6964 656f 5f62 6974 6d61 705f 6765 _video_bitmap_ge │ │ │ │ │ -00010410: 745f 7769 6474 680a 2d2d 2d2d 2d2d 2d2d t_width.-------- │ │ │ │ │ +00010120: 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a 2050 --------.. * P │ │ │ │ │ +00010130: 726f 746f 7479 7065 3a0a 2020 2020 2020 rototype:. │ │ │ │ │ +00010140: 2020 2020 6772 7562 5f65 7272 5f74 2067 grub_err_t g │ │ │ │ │ +00010150: 7275 625f 7669 6465 6f5f 6269 746d 6170 rub_video_bitmap │ │ │ │ │ +00010160: 5f64 6573 7472 6f79 2028 7374 7275 6374 _destroy (struct │ │ │ │ │ +00010170: 2067 7275 625f 7669 6465 6f5f 6269 746d grub_video_bitm │ │ │ │ │ +00010180: 6170 202a 6269 746d 6170 293b 0a0a 2020 ap *bitmap);.. │ │ │ │ │ +00010190: 202a 2044 6573 6372 6970 7469 6f6e 3a0a * Description:. │ │ │ │ │ +000101a0: 0a20 2020 2020 5768 656e 2062 6974 6d61 . When bitma │ │ │ │ │ +000101b0: 7020 6973 206e 6f20 6c6f 6e67 6572 206e p is no longer n │ │ │ │ │ +000101c0: 6565 6465 642c 2069 7420 6361 6e20 6265 eeded, it can be │ │ │ │ │ +000101d0: 2066 7265 6564 2066 726f 6d20 6d65 6d6f freed from memo │ │ │ │ │ +000101e0: 7279 2075 7369 6e67 0a20 2020 2020 7468 ry using. th │ │ │ │ │ +000101f0: 6973 2063 6f6d 6d61 6e64 2e20 2027 6269 is command. 'bi │ │ │ │ │ +00010200: 746d 6170 2720 6973 2070 7265 7669 6f75 tmap' is previou │ │ │ │ │ +00010210: 736c 7920 616c 6c6f 6361 7465 6420 6269 sly allocated bi │ │ │ │ │ +00010220: 746d 6170 2077 6974 680a 2020 2020 2027 tmap with. ' │ │ │ │ │ +00010230: 6772 7562 5f76 6964 656f 5f62 6974 6d61 grub_video_bitma │ │ │ │ │ +00010240: 705f 6372 6561 7465 2720 6f72 206c 6f61 p_create' or loa │ │ │ │ │ +00010250: 6465 6420 7769 7468 2027 6772 7562 5f76 ded with 'grub_v │ │ │ │ │ +00010260: 6964 656f 5f62 6974 6d61 705f 6c6f 6164 ideo_bitmap_load │ │ │ │ │ +00010270: 272e 0a0a 3130 2e33 2e33 2067 7275 625f '...10.3.3 grub_ │ │ │ │ │ +00010280: 7669 6465 6f5f 6269 746d 6170 5f6c 6f61 video_bitmap_loa │ │ │ │ │ +00010290: 640a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d d.-------------- │ │ │ │ │ +000102a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +000102b0: 0a20 2020 2a20 5072 6f74 6f74 7970 653a . * Prototype: │ │ │ │ │ +000102c0: 0a20 2020 2020 2020 2020 2067 7275 625f . grub_ │ │ │ │ │ +000102d0: 6572 725f 7420 6772 7562 5f76 6964 656f err_t grub_video │ │ │ │ │ +000102e0: 5f62 6974 6d61 705f 6c6f 6164 2028 7374 _bitmap_load (st │ │ │ │ │ +000102f0: 7275 6374 2067 7275 625f 7669 6465 6f5f ruct grub_video_ │ │ │ │ │ +00010300: 6269 746d 6170 202a 2a62 6974 6d61 702c bitmap **bitmap, │ │ │ │ │ +00010310: 2063 6f6e 7374 2063 6861 7220 2a66 696c const char *fil │ │ │ │ │ +00010320: 656e 616d 6529 3b0a 0a20 2020 2a20 4465 ename);.. * De │ │ │ │ │ +00010330: 7363 7269 7074 696f 6e3a 0a0a 2020 2020 scription:.. │ │ │ │ │ +00010340: 2054 7269 6573 2074 6f20 6c6f 6164 2067 Tries to load g │ │ │ │ │ +00010350: 6976 656e 2062 6974 6d61 7020 2827 6669 iven bitmap ('fi │ │ │ │ │ +00010360: 6c65 6e61 6d65 2729 2075 7369 6e67 2072 lename') using r │ │ │ │ │ +00010370: 6567 6973 7465 7265 6420 6269 746d 6170 egistered bitmap │ │ │ │ │ +00010380: 0a20 2020 2020 6c6f 6164 6572 732e 2020 . loaders. │ │ │ │ │ +00010390: 496e 2063 6173 6520 6269 746d 6170 2066 In case bitmap f │ │ │ │ │ +000103a0: 6f72 6d61 7420 6973 206e 6f74 2072 6563 ormat is not rec │ │ │ │ │ +000103b0: 6f67 6e69 7a65 6420 6f72 2073 7570 706f ognized or suppo │ │ │ │ │ +000103c0: 7274 6564 0a20 2020 2020 6572 726f 7220 rted. error │ │ │ │ │ +000103d0: 2747 5255 425f 4552 525f 4241 445f 4649 'GRUB_ERR_BAD_FI │ │ │ │ │ +000103e0: 4c45 5f54 5950 4527 2069 7320 7265 7475 LE_TYPE' is retu │ │ │ │ │ +000103f0: 726e 6564 2e0a 0a31 302e 332e 3420 6772 rned...10.3.4 gr │ │ │ │ │ +00010400: 7562 5f76 6964 656f 5f62 6974 6d61 705f ub_video_bitmap_ │ │ │ │ │ +00010410: 6765 745f 7769 6474 680a 2d2d 2d2d 2d2d get_width.------ │ │ │ │ │ 00010420: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010430: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ │ -00010440: 2050 726f 746f 7479 7065 3a0a 2020 2020 Prototype:. │ │ │ │ │ -00010450: 2020 2020 2020 756e 7369 676e 6564 2069 unsigned i │ │ │ │ │ -00010460: 6e74 2067 7275 625f 7669 6465 6f5f 6269 nt grub_video_bi │ │ │ │ │ -00010470: 746d 6170 5f67 6574 5f77 6964 7468 2028 tmap_get_width ( │ │ │ │ │ -00010480: 7374 7275 6374 2067 7275 625f 7669 6465 struct grub_vide │ │ │ │ │ -00010490: 6f5f 6269 746d 6170 202a 6269 746d 6170 o_bitmap *bitmap │ │ │ │ │ -000104a0: 293b 0a0a 2020 202a 2044 6573 6372 6970 );.. * Descrip │ │ │ │ │ -000104b0: 7469 6f6e 3a0a 0a20 2020 2020 5265 7475 tion:.. Retu │ │ │ │ │ -000104c0: 726e 7320 6269 746d 6170 2077 6964 7468 rns bitmap width │ │ │ │ │ -000104d0: 2e0a 0a31 302e 332e 3520 6772 7562 5f76 ...10.3.5 grub_v │ │ │ │ │ -000104e0: 6964 656f 5f62 6974 6d61 705f 6765 745f ideo_bitmap_get_ │ │ │ │ │ -000104f0: 6865 6967 6874 0a2d 2d2d 2d2d 2d2d 2d2d height.--------- │ │ │ │ │ +00010430: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ +00010440: 202a 2050 726f 746f 7479 7065 3a0a 2020 * Prototype:. │ │ │ │ │ +00010450: 2020 2020 2020 2020 756e 7369 676e 6564 unsigned │ │ │ │ │ +00010460: 2069 6e74 2067 7275 625f 7669 6465 6f5f int grub_video_ │ │ │ │ │ +00010470: 6269 746d 6170 5f67 6574 5f77 6964 7468 bitmap_get_width │ │ │ │ │ +00010480: 2028 7374 7275 6374 2067 7275 625f 7669 (struct grub_vi │ │ │ │ │ +00010490: 6465 6f5f 6269 746d 6170 202a 6269 746d deo_bitmap *bitm │ │ │ │ │ +000104a0: 6170 293b 0a0a 2020 202a 2044 6573 6372 ap);.. * Descr │ │ │ │ │ +000104b0: 6970 7469 6f6e 3a0a 0a20 2020 2020 5265 iption:.. Re │ │ │ │ │ +000104c0: 7475 726e 7320 6269 746d 6170 2077 6964 turns bitmap wid │ │ │ │ │ +000104d0: 7468 2e0a 0a31 302e 332e 3520 6772 7562 th...10.3.5 grub │ │ │ │ │ +000104e0: 5f76 6964 656f 5f62 6974 6d61 705f 6765 _video_bitmap_ge │ │ │ │ │ +000104f0: 745f 6865 6967 6874 0a2d 2d2d 2d2d 2d2d t_height.------- │ │ │ │ │ 00010500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010510: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 202a ----------.. * │ │ │ │ │ -00010520: 2050 726f 746f 7479 7065 3a0a 2020 2020 Prototype:. │ │ │ │ │ -00010530: 2020 2020 2020 756e 7369 676e 6564 2069 unsigned i │ │ │ │ │ -00010540: 6e74 2067 7275 625f 7669 6465 6f5f 6269 nt grub_video_bi │ │ │ │ │ -00010550: 746d 6170 5f67 6574 5f68 6569 6768 7420 tmap_get_height │ │ │ │ │ -00010560: 2873 7472 7563 7420 6772 7562 5f76 6964 (struct grub_vid │ │ │ │ │ -00010570: 656f 5f62 6974 6d61 7020 2a62 6974 6d61 eo_bitmap *bitma │ │ │ │ │ -00010580: 7029 3b0a 0a20 2020 2a20 4465 7363 7269 p);.. * Descri │ │ │ │ │ -00010590: 7074 696f 6e3a 0a0a 2020 2020 2052 6574 ption:.. Ret │ │ │ │ │ -000105a0: 7572 6e20 6269 746d 6170 2068 6569 6768 urn bitmap heigh │ │ │ │ │ -000105b0: 742e 0a0a 3130 2e33 2e36 2067 7275 625f t...10.3.6 grub_ │ │ │ │ │ -000105c0: 7669 6465 6f5f 6269 746d 6170 5f67 6574 video_bitmap_get │ │ │ │ │ -000105d0: 5f6d 6f64 655f 696e 666f 0a2d 2d2d 2d2d _mode_info.----- │ │ │ │ │ +00010510: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ +00010520: 202a 2050 726f 746f 7479 7065 3a0a 2020 * Prototype:. │ │ │ │ │ +00010530: 2020 2020 2020 2020 756e 7369 676e 6564 unsigned │ │ │ │ │ +00010540: 2069 6e74 2067 7275 625f 7669 6465 6f5f int grub_video_ │ │ │ │ │ +00010550: 6269 746d 6170 5f67 6574 5f68 6569 6768 bitmap_get_heigh │ │ │ │ │ +00010560: 7420 2873 7472 7563 7420 6772 7562 5f76 t (struct grub_v │ │ │ │ │ +00010570: 6964 656f 5f62 6974 6d61 7020 2a62 6974 ideo_bitmap *bit │ │ │ │ │ +00010580: 6d61 7029 3b0a 0a20 2020 2a20 4465 7363 map);.. * Desc │ │ │ │ │ +00010590: 7269 7074 696f 6e3a 0a0a 2020 2020 2052 ription:.. R │ │ │ │ │ +000105a0: 6574 7572 6e20 6269 746d 6170 2068 6569 eturn bitmap hei │ │ │ │ │ +000105b0: 6768 742e 0a0a 3130 2e33 2e36 2067 7275 ght...10.3.6 gru │ │ │ │ │ +000105c0: 625f 7669 6465 6f5f 6269 746d 6170 5f67 b_video_bitmap_g │ │ │ │ │ +000105d0: 6574 5f6d 6f64 655f 696e 666f 0a2d 2d2d et_mode_info.--- │ │ │ │ │ 000105e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 000105f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010600: 2d0a 0a20 2020 2a20 5072 6f74 6f74 7970 -.. * Prototyp │ │ │ │ │ -00010610: 653a 0a20 2020 2020 2020 2020 2076 6f69 e:. voi │ │ │ │ │ -00010620: 6420 6772 7562 5f76 6964 656f 5f62 6974 d grub_video_bit │ │ │ │ │ -00010630: 6d61 705f 6765 745f 6d6f 6465 5f69 6e66 map_get_mode_inf │ │ │ │ │ -00010640: 6f20 2873 7472 7563 7420 6772 7562 5f76 o (struct grub_v │ │ │ │ │ -00010650: 6964 656f 5f62 6974 6d61 7020 2a62 6974 ideo_bitmap *bit │ │ │ │ │ -00010660: 6d61 702c 2073 7472 7563 7420 6772 7562 map, struct grub │ │ │ │ │ -00010670: 5f76 6964 656f 5f6d 6f64 655f 696e 666f _video_mode_info │ │ │ │ │ -00010680: 202a 6d6f 6465 5f69 6e66 6f29 3b0a 0a20 *mode_info);.. │ │ │ │ │ -00010690: 2020 2a20 4465 7363 7269 7074 696f 6e3a * Description: │ │ │ │ │ -000106a0: 0a0a 2020 2020 2052 6574 7572 6e73 2062 .. Returns b │ │ │ │ │ -000106b0: 6974 6d61 7020 666f 726d 6174 2064 6574 itmap format det │ │ │ │ │ -000106c0: 6169 6c73 2069 6e20 666f 726d 206f 6620 ails in form of │ │ │ │ │ -000106d0: 2767 7275 625f 7669 6465 6f5f 6d6f 6465 'grub_video_mode │ │ │ │ │ -000106e0: 5f69 6e66 6f27 2e0a 0a31 302e 332e 3720 _info'...10.3.7 │ │ │ │ │ -000106f0: 6772 7562 5f76 6964 656f 5f62 6974 6d61 grub_video_bitma │ │ │ │ │ -00010700: 705f 6765 745f 6461 7461 0a2d 2d2d 2d2d p_get_data.----- │ │ │ │ │ +00010600: 2d2d 2d0a 0a20 2020 2a20 5072 6f74 6f74 ---.. * Protot │ │ │ │ │ +00010610: 7970 653a 0a20 2020 2020 2020 2020 2076 ype:. v │ │ │ │ │ +00010620: 6f69 6420 6772 7562 5f76 6964 656f 5f62 oid grub_video_b │ │ │ │ │ +00010630: 6974 6d61 705f 6765 745f 6d6f 6465 5f69 itmap_get_mode_i │ │ │ │ │ +00010640: 6e66 6f20 2873 7472 7563 7420 6772 7562 nfo (struct grub │ │ │ │ │ +00010650: 5f76 6964 656f 5f62 6974 6d61 7020 2a62 _video_bitmap *b │ │ │ │ │ +00010660: 6974 6d61 702c 2073 7472 7563 7420 6772 itmap, struct gr │ │ │ │ │ +00010670: 7562 5f76 6964 656f 5f6d 6f64 655f 696e ub_video_mode_in │ │ │ │ │ +00010680: 666f 202a 6d6f 6465 5f69 6e66 6f29 3b0a fo *mode_info);. │ │ │ │ │ +00010690: 0a20 2020 2a20 4465 7363 7269 7074 696f . * Descriptio │ │ │ │ │ +000106a0: 6e3a 0a0a 2020 2020 2052 6574 7572 6e73 n:.. Returns │ │ │ │ │ +000106b0: 2062 6974 6d61 7020 666f 726d 6174 2064 bitmap format d │ │ │ │ │ +000106c0: 6574 6169 6c73 2069 6e20 666f 726d 206f etails in form o │ │ │ │ │ +000106d0: 6620 2767 7275 625f 7669 6465 6f5f 6d6f f 'grub_video_mo │ │ │ │ │ +000106e0: 6465 5f69 6e66 6f27 2e0a 0a31 302e 332e de_info'...10.3. │ │ │ │ │ +000106f0: 3720 6772 7562 5f76 6964 656f 5f62 6974 7 grub_video_bit │ │ │ │ │ +00010700: 6d61 705f 6765 745f 6461 7461 0a2d 2d2d map_get_data.--- │ │ │ │ │ 00010710: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010720: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2020 ------------.. │ │ │ │ │ -00010730: 202a 2050 726f 746f 7479 7065 3a0a 2020 * Prototype:. │ │ │ │ │ -00010740: 2020 2020 2020 2020 766f 6964 202a 6772 void *gr │ │ │ │ │ -00010750: 7562 5f76 6964 656f 5f62 6974 6d61 705f ub_video_bitmap_ │ │ │ │ │ -00010760: 6765 745f 6461 7461 2028 7374 7275 6374 get_data (struct │ │ │ │ │ -00010770: 2067 7275 625f 7669 6465 6f5f 6269 746d grub_video_bitm │ │ │ │ │ -00010780: 6170 202a 6269 746d 6170 293b 0a0a 2020 ap *bitmap);.. │ │ │ │ │ -00010790: 202a 2044 6573 6372 6970 7469 6f6e 3a0a * Description:. │ │ │ │ │ -000107a0: 0a20 2020 2020 5265 7475 726e 2070 6f69 . Return poi │ │ │ │ │ -000107b0: 6e74 6572 2074 6f20 6269 746d 6170 2064 nter to bitmap d │ │ │ │ │ -000107c0: 6174 612e 2020 436f 6e74 656e 7473 206f ata. Contents o │ │ │ │ │ -000107d0: 6620 7468 6520 706f 696e 7465 6420 6461 f the pointed da │ │ │ │ │ -000107e0: 7461 2063 616e 2062 650a 2020 2020 2066 ta can be. f │ │ │ │ │ -000107f0: 7265 656c 7920 6d6f 6469 6669 6564 2e20 reely modified. │ │ │ │ │ -00010800: 2054 6865 7265 2069 7320 6e6f 2065 7874 There is no ext │ │ │ │ │ -00010810: 7261 2070 726f 7465 6374 696f 6e20 6167 ra protection ag │ │ │ │ │ -00010820: 6169 6e73 7420 676f 696e 6720 6f66 660a ainst going off. │ │ │ │ │ -00010830: 2020 2020 2074 6865 2062 6f75 6e64 7320 the bounds │ │ │ │ │ -00010840: 736f 2079 6f75 2068 6176 6520 746f 2062 so you have to b │ │ │ │ │ -00010850: 6520 6361 7265 6675 6c6c 2068 6f77 2074 e carefull how t │ │ │ │ │ -00010860: 6f20 6163 6365 7373 2074 6865 2064 6174 o access the dat │ │ │ │ │ -00010870: 612e 0a0a 1f0a 4669 6c65 3a20 6772 7562 a.....File: grub │ │ │ │ │ -00010880: 2d64 6576 2e69 6e66 6f2c 2020 4e6f 6465 -dev.info, Node │ │ │ │ │ -00010890: 3a20 5046 4632 2046 6f6e 7420 4669 6c65 : PFF2 Font File │ │ │ │ │ -000108a0: 2046 6f72 6d61 742c 2020 4e65 7874 3a20 Format, Next: │ │ │ │ │ -000108b0: 4772 6170 6869 6361 6c20 4d65 6e75 2053 Graphical Menu S │ │ │ │ │ -000108c0: 6f66 7477 6172 6520 4465 7369 676e 2c20 oftware Design, │ │ │ │ │ -000108d0: 2050 7265 763a 2056 6964 656f 2053 7562 Prev: Video Sub │ │ │ │ │ -000108e0: 7379 7374 656d 2c20 2055 703a 2054 6f70 system, Up: Top │ │ │ │ │ -000108f0: 0a0a 3131 2050 4646 3220 466f 6e74 2046 ..11 PFF2 Font F │ │ │ │ │ -00010900: 696c 6520 466f 726d 6174 0a2a 2a2a 2a2a ile Format.***** │ │ │ │ │ +00010720: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00010730: 2020 202a 2050 726f 746f 7479 7065 3a0a * Prototype:. │ │ │ │ │ +00010740: 2020 2020 2020 2020 2020 766f 6964 202a void * │ │ │ │ │ +00010750: 6772 7562 5f76 6964 656f 5f62 6974 6d61 grub_video_bitma │ │ │ │ │ +00010760: 705f 6765 745f 6461 7461 2028 7374 7275 p_get_data (stru │ │ │ │ │ +00010770: 6374 2067 7275 625f 7669 6465 6f5f 6269 ct grub_video_bi │ │ │ │ │ +00010780: 746d 6170 202a 6269 746d 6170 293b 0a0a tmap *bitmap);.. │ │ │ │ │ +00010790: 2020 202a 2044 6573 6372 6970 7469 6f6e * Description │ │ │ │ │ +000107a0: 3a0a 0a20 2020 2020 5265 7475 726e 2070 :.. Return p │ │ │ │ │ +000107b0: 6f69 6e74 6572 2074 6f20 6269 746d 6170 ointer to bitmap │ │ │ │ │ +000107c0: 2064 6174 612e 2020 436f 6e74 656e 7473 data. Contents │ │ │ │ │ +000107d0: 206f 6620 7468 6520 706f 696e 7465 6420 of the pointed │ │ │ │ │ +000107e0: 6461 7461 2063 616e 2062 650a 2020 2020 data can be. │ │ │ │ │ +000107f0: 2066 7265 656c 7920 6d6f 6469 6669 6564 freely modified │ │ │ │ │ +00010800: 2e20 2054 6865 7265 2069 7320 6e6f 2065 . There is no e │ │ │ │ │ +00010810: 7874 7261 2070 726f 7465 6374 696f 6e20 xtra protection │ │ │ │ │ +00010820: 6167 6169 6e73 7420 676f 696e 6720 6f66 against going of │ │ │ │ │ +00010830: 660a 2020 2020 2074 6865 2062 6f75 6e64 f. the bound │ │ │ │ │ +00010840: 7320 736f 2079 6f75 2068 6176 6520 746f s so you have to │ │ │ │ │ +00010850: 2062 6520 6361 7265 6675 6c6c 2068 6f77 be carefull how │ │ │ │ │ +00010860: 2074 6f20 6163 6365 7373 2074 6865 2064 to access the d │ │ │ │ │ +00010870: 6174 612e 0a0a 1f0a 4669 6c65 3a20 6772 ata.....File: gr │ │ │ │ │ +00010880: 7562 2d64 6576 2e69 6e66 6f2c 2020 4e6f ub-dev.info, No │ │ │ │ │ +00010890: 6465 3a20 5046 4632 2046 6f6e 7420 4669 de: PFF2 Font Fi │ │ │ │ │ +000108a0: 6c65 2046 6f72 6d61 742c 2020 4e65 7874 le Format, Next │ │ │ │ │ +000108b0: 3a20 4772 6170 6869 6361 6c20 4d65 6e75 : Graphical Menu │ │ │ │ │ +000108c0: 2053 6f66 7477 6172 6520 4465 7369 676e Software Design │ │ │ │ │ +000108d0: 2c20 2050 7265 763a 2056 6964 656f 2053 , Prev: Video S │ │ │ │ │ +000108e0: 7562 7379 7374 656d 2c20 2055 703a 2054 ubsystem, Up: T │ │ │ │ │ +000108f0: 6f70 0a0a 3131 2050 4646 3220 466f 6e74 op..11 PFF2 Font │ │ │ │ │ +00010900: 2046 696c 6520 466f 726d 6174 0a2a 2a2a File Format.*** │ │ │ │ │ 00010910: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00010920: 2a2a 2a0a 0a2a 204d 656e 753a 0a0a 2a20 ***..* Menu:..* │ │ │ │ │ -00010930: 496e 7472 6f64 7563 7469 6f6e 3a3a 0a2a Introduction::.* │ │ │ │ │ -00010940: 2046 696c 6520 5374 7275 6374 7572 653a File Structure: │ │ │ │ │ -00010950: 3a0a 2a20 466f 6e74 204d 6574 7269 6373 :.* Font Metrics │ │ │ │ │ -00010960: 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 7562 ::....File: grub │ │ │ │ │ -00010970: 2d64 6576 2e69 6e66 6f2c 2020 4e6f 6465 -dev.info, Node │ │ │ │ │ -00010980: 3a20 496e 7472 6f64 7563 7469 6f6e 2c20 : Introduction, │ │ │ │ │ -00010990: 204e 6578 743a 2046 696c 6520 5374 7275 Next: File Stru │ │ │ │ │ -000109a0: 6374 7572 652c 2020 5570 3a20 5046 4632 cture, Up: PFF2 │ │ │ │ │ -000109b0: 2046 6f6e 7420 4669 6c65 2046 6f72 6d61 Font File Forma │ │ │ │ │ -000109c0: 740a 0a31 312e 3120 496e 7472 6f64 7563 t..11.1 Introduc │ │ │ │ │ -000109d0: 7469 6f6e 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d tion.=========== │ │ │ │ │ -000109e0: 3d3d 3d3d 3d3d 0a0a 5468 6520 676f 616c ======..The goal │ │ │ │ │ -000109f0: 206f 6620 7468 6973 2066 6f72 6d61 7420 of this format │ │ │ │ │ -00010a00: 6973 2074 6f20 7072 6f76 6964 6520 6120 is to provide a │ │ │ │ │ -00010a10: 6269 746d 6170 2066 6f6e 7420 666f 726d bitmap font form │ │ │ │ │ -00010a20: 6174 2074 6861 7420 6973 0a73 696d 706c at that is.simpl │ │ │ │ │ -00010a30: 6520 746f 2075 7365 2c20 636f 6d70 6163 e to use, compac │ │ │ │ │ -00010a40: 742c 2061 6e64 2063 6c65 616e 6c79 2073 t, and cleanly s │ │ │ │ │ -00010a50: 7570 706f 7274 7320 556e 6963 6f64 652e upports Unicode. │ │ │ │ │ -00010a60: 0a0a 3131 2e31 2e31 2047 6f61 6c73 206f ..11.1.1 Goals o │ │ │ │ │ -00010a70: 6620 7468 6520 4752 5542 2046 6f6e 7420 f the GRUB Font │ │ │ │ │ -00010a80: 466f 726d 6174 0a2d 2d2d 2d2d 2d2d 2d2d Format.--------- │ │ │ │ │ +00010920: 2a2a 2a2a 2a0a 0a2a 204d 656e 753a 0a0a *****..* Menu:.. │ │ │ │ │ +00010930: 2a20 496e 7472 6f64 7563 7469 6f6e 3a3a * Introduction:: │ │ │ │ │ +00010940: 0a2a 2046 696c 6520 5374 7275 6374 7572 .* File Structur │ │ │ │ │ +00010950: 653a 3a0a 2a20 466f 6e74 204d 6574 7269 e::.* Font Metri │ │ │ │ │ +00010960: 6373 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 cs::....File: gr │ │ │ │ │ +00010970: 7562 2d64 6576 2e69 6e66 6f2c 2020 4e6f ub-dev.info, No │ │ │ │ │ +00010980: 6465 3a20 496e 7472 6f64 7563 7469 6f6e de: Introduction │ │ │ │ │ +00010990: 2c20 204e 6578 743a 2046 696c 6520 5374 , Next: File St │ │ │ │ │ +000109a0: 7275 6374 7572 652c 2020 5570 3a20 5046 ructure, Up: PF │ │ │ │ │ +000109b0: 4632 2046 6f6e 7420 4669 6c65 2046 6f72 F2 Font File For │ │ │ │ │ +000109c0: 6d61 740a 0a31 312e 3120 496e 7472 6f64 mat..11.1 Introd │ │ │ │ │ +000109d0: 7563 7469 6f6e 0a3d 3d3d 3d3d 3d3d 3d3d uction.========= │ │ │ │ │ +000109e0: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 676f ========..The go │ │ │ │ │ +000109f0: 616c 206f 6620 7468 6973 2066 6f72 6d61 al of this forma │ │ │ │ │ +00010a00: 7420 6973 2074 6f20 7072 6f76 6964 6520 t is to provide │ │ │ │ │ +00010a10: 6120 6269 746d 6170 2066 6f6e 7420 666f a bitmap font fo │ │ │ │ │ +00010a20: 726d 6174 2074 6861 7420 6973 0a73 696d rmat that is.sim │ │ │ │ │ +00010a30: 706c 6520 746f 2075 7365 2c20 636f 6d70 ple to use, comp │ │ │ │ │ +00010a40: 6163 742c 2061 6e64 2063 6c65 616e 6c79 act, and cleanly │ │ │ │ │ +00010a50: 2073 7570 706f 7274 7320 556e 6963 6f64 supports Unicod │ │ │ │ │ +00010a60: 652e 0a0a 3131 2e31 2e31 2047 6f61 6c73 e...11.1.1 Goals │ │ │ │ │ +00010a70: 206f 6620 7468 6520 4752 5542 2046 6f6e of the GRUB Fon │ │ │ │ │ +00010a80: 7420 466f 726d 6174 0a2d 2d2d 2d2d 2d2d t Format.------- │ │ │ │ │ 00010a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010aa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2020 -----------.. │ │ │ │ │ -00010ab0: 2a20 5369 6d70 6c65 2074 6f20 7265 6164 * Simple to read │ │ │ │ │ -00010ac0: 2061 6e64 2075 7365 2e20 2053 696e 6365 and use. Since │ │ │ │ │ -00010ad0: 2047 5255 4220 7769 6c6c 206f 6e6c 7920 GRUB will only │ │ │ │ │ -00010ae0: 6265 2072 6561 6469 6e67 2074 6865 2066 be reading the f │ │ │ │ │ -00010af0: 6f6e 740a 2020 2020 2066 696c 6573 2c20 ont. files, │ │ │ │ │ -00010b00: 7765 2061 7265 206d 6f72 6520 636f 6e63 we are more conc │ │ │ │ │ -00010b10: 6572 6e65 6420 7769 7468 206d 616b 696e erned with makin │ │ │ │ │ -00010b20: 6720 7468 6520 636f 6465 2074 6f20 7265 g the code to re │ │ │ │ │ -00010b30: 6164 2074 6865 2066 6f6e 740a 2020 2020 ad the font. │ │ │ │ │ -00010b40: 2073 696d 706c 6520 7468 616e 2077 6520 simple than we │ │ │ │ │ -00010b50: 6172 6520 7769 7468 2077 7269 7469 6e67 are with writing │ │ │ │ │ -00010b60: 2074 6865 2066 6f6e 742e 0a0a 2020 202a the font... * │ │ │ │ │ -00010b70: 2043 6f6d 7061 6374 2073 746f 7261 6765 Compact storage │ │ │ │ │ -00010b80: 2e20 2054 6865 2066 6f6e 7473 2077 696c . The fonts wil │ │ │ │ │ -00010b90: 6c20 6765 6e65 7261 6c6c 7920 6265 2073 l generally be s │ │ │ │ │ -00010ba0: 746f 7265 6420 696e 2061 2073 6d61 6c6c tored in a small │ │ │ │ │ -00010bb0: 0a20 2020 2020 626f 6f74 2070 6172 7469 . boot parti │ │ │ │ │ -00010bc0: 7469 6f6e 2077 6865 7265 2047 5255 4220 tion where GRUB │ │ │ │ │ -00010bd0: 6973 206c 6f63 6174 6564 2c20 616e 6420 is located, and │ │ │ │ │ -00010be0: 7468 6973 206d 6179 2062 6520 6f6e 2061 this may be on a │ │ │ │ │ -00010bf0: 0a20 2020 2020 7265 6d6f 7661 626c 6520 . removable │ │ │ │ │ -00010c00: 7374 6f72 6167 6520 6465 7669 6365 2073 storage device s │ │ │ │ │ -00010c10: 7563 6820 6173 2061 2043 4420 6f72 2055 uch as a CD or U │ │ │ │ │ -00010c20: 5342 2066 6c61 7368 2064 7269 7665 2077 SB flash drive w │ │ │ │ │ -00010c30: 6865 7265 0a20 2020 2020 7370 6163 6520 here. space │ │ │ │ │ -00010c40: 6973 206d 6f72 6520 6c69 6d69 7465 6420 is more limited │ │ │ │ │ -00010c50: 7468 616e 2069 7420 6973 206f 6e20 6d6f than it is on mo │ │ │ │ │ -00010c60: 7374 2068 6172 6420 6472 6976 6573 2e0a st hard drives.. │ │ │ │ │ -00010c70: 0a20 2020 2a20 556e 6963 6f64 652e 2020 . * Unicode. │ │ │ │ │ -00010c80: 4752 5542 2073 686f 756c 6420 6e6f 7420 GRUB should not │ │ │ │ │ -00010c90: 6861 7665 2074 6f20 6465 616c 2077 6974 have to deal wit │ │ │ │ │ -00010ca0: 6820 6d75 6c74 6970 6c65 2063 6861 7261 h multiple chara │ │ │ │ │ -00010cb0: 6374 6572 0a20 2020 2020 656e 636f 6469 cter. encodi │ │ │ │ │ -00010cc0: 6e67 732e 2020 5468 6520 666f 6e74 2073 ngs. The font s │ │ │ │ │ -00010cd0: 686f 756c 6420 616c 7761 7973 2075 7365 hould always use │ │ │ │ │ -00010ce0: 2055 6e69 636f 6465 2063 6861 7261 6374 Unicode charact │ │ │ │ │ -00010cf0: 6572 2063 6f64 6573 2066 6f72 0a20 2020 er codes for. │ │ │ │ │ -00010d00: 2020 7369 6d70 6c65 2069 6e74 6572 6e61 simple interna │ │ │ │ │ -00010d10: 7469 6f6e 616c 697a 6174 696f 6e2e 0a0a tionalization... │ │ │ │ │ -00010d20: 3131 2e31 2e32 2057 6879 2041 6e6f 7468 11.1.2 Why Anoth │ │ │ │ │ -00010d30: 6572 2046 6f6e 7420 466f 726d 6174 3f0a er Font Format?. │ │ │ │ │ -00010d40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010d50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -00010d60: 0a54 6865 7265 2061 7265 206d 616e 7920 .There are many │ │ │ │ │ -00010d70: 6578 6973 7469 6e67 2062 6974 6d61 7020 existing bitmap │ │ │ │ │ -00010d80: 666f 6e74 2066 6f72 6d61 7473 2074 6861 font formats tha │ │ │ │ │ -00010d90: 7420 4752 5542 2063 6f75 6c64 2075 7365 t GRUB could use │ │ │ │ │ -00010da0: 2e0a 486f 7765 7665 722c 2074 6865 7265 ..However, there │ │ │ │ │ -00010db0: 2061 7265 2061 7370 6563 7473 206f 6620 are aspects of │ │ │ │ │ -00010dc0: 7468 6573 6520 666f 726d 6174 7320 7468 these formats th │ │ │ │ │ -00010dd0: 6174 206d 6179 206d 616b 6520 7468 656d at may make them │ │ │ │ │ -00010de0: 206c 6573 7320 7468 616e 0a73 7569 7461 less than.suita │ │ │ │ │ -00010df0: 626c 6520 666f 7220 7573 6520 696e 2047 ble for use in G │ │ │ │ │ -00010e00: 5255 4220 6174 2074 6869 7320 7469 6d65 RUB at this time │ │ │ │ │ -00010e10: 3a0a 0a27 4244 4627 0a20 2020 2020 496e :..'BDF'. In │ │ │ │ │ -00010e20: 6566 6669 6369 656e 7420 7374 6f72 6167 efficient storag │ │ │ │ │ -00010e30: 653b 2075 7365 7320 4153 4349 4920 746f e; uses ASCII to │ │ │ │ │ -00010e40: 2064 6573 6372 6962 6520 7072 6f70 6572 describe proper │ │ │ │ │ -00010e50: 7469 6573 2061 6e64 0a20 2020 2020 6865 ties and. he │ │ │ │ │ -00010e60: 7861 6465 6369 6d61 6c20 6e75 6d62 6572 xadecimal number │ │ │ │ │ -00010e70: 7320 696e 2041 5343 4949 2066 6f72 2074 s in ASCII for t │ │ │ │ │ -00010e80: 6865 2062 6974 6d61 7020 726f 7773 2e0a he bitmap rows.. │ │ │ │ │ -00010e90: 2750 4346 270a 2020 2020 204d 616e 7920 'PCF'. Many │ │ │ │ │ -00010ea0: 666f 726d 6174 2076 6172 6961 7469 6f6e format variation │ │ │ │ │ -00010eb0: 7320 7375 6368 2061 7320 6279 7465 206f s such as byte o │ │ │ │ │ -00010ec0: 7264 6572 2061 6e64 2062 6974 6d61 7020 rder and bitmap │ │ │ │ │ -00010ed0: 7061 6464 696e 6720 2872 6f77 730a 2020 padding (rows. │ │ │ │ │ -00010ee0: 2020 2070 6164 6465 6420 746f 2062 7974 padded to byt │ │ │ │ │ -00010ef0: 652c 2077 6f72 642c 2065 7463 2e29 2020 e, word, etc.) │ │ │ │ │ -00010f00: 776f 756c 6420 7265 7375 6c74 2069 6e20 would result in │ │ │ │ │ -00010f10: 6d6f 7265 2063 6f6d 706c 6578 2063 6f64 more complex cod │ │ │ │ │ -00010f20: 6520 746f 0a20 2020 2020 6861 6e64 6c65 e to. handle │ │ │ │ │ -00010f30: 2074 6865 2066 6f6e 7420 666f 726d 6174 the font format │ │ │ │ │ -00010f40: 2e0a 0a1f 0a46 696c 653a 2067 7275 622d .....File: grub- │ │ │ │ │ -00010f50: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ │ -00010f60: 2046 696c 6520 5374 7275 6374 7572 652c File Structure, │ │ │ │ │ -00010f70: 2020 4e65 7874 3a20 466f 6e74 204d 6574 Next: Font Met │ │ │ │ │ -00010f80: 7269 6373 2c20 2050 7265 763a 2049 6e74 rics, Prev: Int │ │ │ │ │ -00010f90: 726f 6475 6374 696f 6e2c 2020 5570 3a20 roduction, Up: │ │ │ │ │ -00010fa0: 5046 4632 2046 6f6e 7420 4669 6c65 2046 PFF2 Font File F │ │ │ │ │ -00010fb0: 6f72 6d61 740a 0a31 312e 3220 4669 6c65 ormat..11.2 File │ │ │ │ │ -00010fc0: 2053 7472 7563 7475 7265 0a3d 3d3d 3d3d Structure.===== │ │ │ │ │ -00010fd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00010fe0: 4120 6669 6c65 202a 7365 6374 696f 6e2a A file *section* │ │ │ │ │ -00010ff0: 2063 6f6e 7369 7374 7320 6f66 2061 2034 consists of a 4 │ │ │ │ │ -00011000: 2d62 7974 6520 6e61 6d65 2c20 6120 3332 -byte name, a 32 │ │ │ │ │ -00011010: 2d62 6974 2062 6967 2d65 6e64 6961 6e20 -bit big-endian │ │ │ │ │ -00011020: 6c65 6e67 7468 0a28 6e6f 7420 696e 636c length.(not incl │ │ │ │ │ -00011030: 7564 696e 6720 7468 6520 6e61 6d65 206f uding the name o │ │ │ │ │ -00011040: 7220 6c65 6e67 7468 292c 2061 6e64 2074 r length), and t │ │ │ │ │ -00011050: 6865 6e20 4c45 4e47 5448 206d 6f72 650a hen LENGTH more. │ │ │ │ │ -00011060: 7365 6374 696f 6e2d 7479 7065 2d73 7065 section-type-spe │ │ │ │ │ -00011070: 6369 6669 6320 6279 7465 732e 0a0a 2020 cific bytes... │ │ │ │ │ -00011080: 2054 6865 2073 7461 6e64 6172 6420 6669 The standard fi │ │ │ │ │ -00011090: 6c65 2065 7874 656e 7369 6f6e 2066 6f72 le extension for │ │ │ │ │ -000110a0: 2050 4646 3220 666f 6e74 2066 696c 6573 PFF2 font files │ │ │ │ │ -000110b0: 2069 7320 272e 7066 3227 2e0a 0a31 312e is '.pf2'...11. │ │ │ │ │ -000110c0: 322e 3120 5365 6374 696f 6e20 5479 7065 2.1 Section Type │ │ │ │ │ -000110d0: 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d s.-------------- │ │ │ │ │ -000110e0: 2d2d 2d2d 2d2d 0a0a 2746 494c 4527 0a20 ------..'FILE'. │ │ │ │ │ -000110f0: 2020 2020 2a46 696c 6520 7479 7065 2049 *File type I │ │ │ │ │ -00011100: 442a 2028 4153 4349 4920 7374 7269 6e67 D* (ASCII string │ │ │ │ │ -00011110: 292e 2020 5468 6973 206d 7573 7420 6265 ). This must be │ │ │ │ │ -00011120: 2074 6865 2066 6972 7374 2073 6563 7469 the first secti │ │ │ │ │ -00011130: 6f6e 2069 6e0a 2020 2020 2074 6865 2066 on in. the f │ │ │ │ │ -00011140: 696c 652e 2020 4974 2068 6173 206c 656e ile. It has len │ │ │ │ │ -00011150: 6774 6820 3420 616e 6420 7468 6520 636f gth 4 and the co │ │ │ │ │ -00011160: 6e74 656e 7473 2061 7265 2074 6865 2066 ntents are the f │ │ │ │ │ -00011170: 6f75 7220 6279 7465 7320 6f66 0a20 2020 our bytes of. │ │ │ │ │ -00011180: 2020 7468 6520 4153 4349 4920 7374 7269 the ASCII stri │ │ │ │ │ -00011190: 6e67 2027 5046 4632 272e 0a0a 274e 414d ng 'PFF2'...'NAM │ │ │ │ │ -000111a0: 4527 0a20 2020 2020 2a46 6f6e 7420 6e61 E'. *Font na │ │ │ │ │ -000111b0: 6d65 2a20 2841 5343 4949 2073 7472 696e me* (ASCII strin │ │ │ │ │ -000111c0: 6729 2e20 2054 6869 7320 6973 2074 6865 g). This is the │ │ │ │ │ -000111d0: 2066 756c 6c20 666f 6e74 206e 616d 6520 full font name │ │ │ │ │ -000111e0: 696e 636c 7564 696e 670a 2020 2020 2066 including. f │ │ │ │ │ -000111f0: 616d 696c 792c 2077 6569 6768 742c 2073 amily, weight, s │ │ │ │ │ -00011200: 7479 6c65 2c20 616e 6420 706f 696e 7420 tyle, and point │ │ │ │ │ -00011210: 7369 7a65 2e20 2046 6f72 2069 6e73 7461 size. For insta │ │ │ │ │ -00011220: 6e63 652c 2022 4865 6c76 6574 6963 610a nce, "Helvetica. │ │ │ │ │ -00011230: 2020 2020 2042 6f6c 6420 4974 616c 6963 Bold Italic │ │ │ │ │ -00011240: 2031 3422 2e0a 0a27 4641 4d49 270a 2020 14"...'FAMI'. │ │ │ │ │ -00011250: 2020 202a 466f 6e74 2066 616d 696c 7920 *Font family │ │ │ │ │ -00011260: 6e61 6d65 2a20 2841 5343 4949 2073 7472 name* (ASCII str │ │ │ │ │ -00011270: 696e 6729 2e20 2046 6f72 2069 6e73 7461 ing). For insta │ │ │ │ │ -00011280: 6e63 652c 2022 4865 6c76 6574 6963 6122 nce, "Helvetica" │ │ │ │ │ -00011290: 2e0a 2020 2020 2054 6869 7320 7368 6f75 .. This shou │ │ │ │ │ -000112a0: 6c64 2062 6520 696e 636c 7564 6564 2073 ld be included s │ │ │ │ │ -000112b0: 6f20 7468 6174 2069 6e74 656c 6c69 6765 o that intellige │ │ │ │ │ -000112c0: 6e74 2066 6f6e 7420 7375 6273 7469 7475 nt font substitu │ │ │ │ │ -000112d0: 7469 6f6e 2063 616e 0a20 2020 2020 7461 tion can. ta │ │ │ │ │ -000112e0: 6b65 2070 6c61 6365 2e0a 0a27 5745 4947 ke place...'WEIG │ │ │ │ │ -000112f0: 270a 2020 2020 202a 466f 6e74 2077 6569 '. *Font wei │ │ │ │ │ -00011300: 6768 742a 2028 4153 4349 4920 7374 7269 ght* (ASCII stri │ │ │ │ │ -00011310: 6e67 292e 2020 5661 6c69 6420 7661 6c75 ng). Valid valu │ │ │ │ │ -00011320: 6573 2061 7265 2027 626f 6c64 2720 616e es are 'bold' an │ │ │ │ │ -00011330: 640a 2020 2020 2027 6e6f 726d 616c 272e d. 'normal'. │ │ │ │ │ -00011340: 2020 5468 6973 2073 686f 756c 6420 6265 This should be │ │ │ │ │ -00011350: 2069 6e63 6c75 6465 6420 736f 2074 6861 included so tha │ │ │ │ │ -00011360: 7420 696e 7465 6c6c 6967 656e 7420 666f t intelligent fo │ │ │ │ │ -00011370: 6e74 0a20 2020 2020 7375 6273 7469 7475 nt. substitu │ │ │ │ │ -00011380: 7469 6f6e 2063 616e 2074 616b 6520 706c tion can take pl │ │ │ │ │ -00011390: 6163 652e 0a0a 2753 4c41 4e27 0a20 2020 ace...'SLAN'. │ │ │ │ │ -000113a0: 2020 2a46 6f6e 7420 736c 616e 742a 2028 *Font slant* ( │ │ │ │ │ -000113b0: 4153 4349 4920 7374 7269 6e67 292e 2020 ASCII string). │ │ │ │ │ -000113c0: 5661 6c69 6420 7661 6c75 6573 2061 7265 Valid values are │ │ │ │ │ -000113d0: 2027 6974 616c 6963 2720 616e 640a 2020 'italic' and. │ │ │ │ │ -000113e0: 2020 2027 6e6f 726d 616c 272e 2020 5468 'normal'. Th │ │ │ │ │ -000113f0: 6973 2073 686f 756c 6420 6265 2069 6e63 is should be inc │ │ │ │ │ -00011400: 6c75 6465 6420 736f 2074 6861 7420 696e luded so that in │ │ │ │ │ -00011410: 7465 6c6c 6967 656e 7420 666f 6e74 0a20 telligent font. │ │ │ │ │ -00011420: 2020 2020 7375 6273 7469 7475 7469 6f6e substitution │ │ │ │ │ -00011430: 2063 616e 2074 616b 6520 706c 6163 652e can take place. │ │ │ │ │ -00011440: 0a0a 2750 5453 5a27 0a20 2020 2020 2a46 ..'PTSZ'. *F │ │ │ │ │ -00011450: 6f6e 7420 706f 696e 7420 7369 7a65 2a20 ont point size* │ │ │ │ │ -00011460: 2875 696e 7431 3662 6529 2e0a 0a27 4d41 (uint16be)...'MA │ │ │ │ │ -00011470: 5857 270a 2020 2020 202a 4d61 7869 6d75 XW'. *Maximu │ │ │ │ │ -00011480: 6d20 6368 6172 6163 7465 7220 7769 6474 m character widt │ │ │ │ │ -00011490: 6820 696e 2070 6978 656c 732a 2028 7569 h in pixels* (ui │ │ │ │ │ -000114a0: 6e74 3136 6265 292e 0a0a 274d 4158 4827 nt16be)...'MAXH' │ │ │ │ │ -000114b0: 0a20 2020 2020 2a4d 6178 696d 756d 2063 . *Maximum c │ │ │ │ │ -000114c0: 6861 7261 6374 6572 2068 6569 6768 7420 haracter height │ │ │ │ │ -000114d0: 696e 2070 6978 656c 732a 2028 7569 6e74 in pixels* (uint │ │ │ │ │ -000114e0: 3136 6265 292e 0a0a 2741 5343 4527 0a20 16be)...'ASCE'. │ │ │ │ │ -000114f0: 2020 2020 2a41 7363 656e 7420 696e 2070 *Ascent in p │ │ │ │ │ -00011500: 6978 656c 732a 2028 7569 6e74 3136 6265 ixels* (uint16be │ │ │ │ │ -00011510: 292e 2020 2a4e 6f74 6520 466f 6e74 204d ). *Note Font M │ │ │ │ │ -00011520: 6574 7269 6373 3a3a 2c20 666f 7220 6465 etrics::, for de │ │ │ │ │ -00011530: 7461 696c 732e 0a0a 2744 4553 4327 0a20 tails...'DESC'. │ │ │ │ │ -00011540: 2020 2020 2a44 6573 6365 6e74 2069 6e20 *Descent in │ │ │ │ │ -00011550: 7069 7865 6c73 2a20 2875 696e 7431 3662 pixels* (uint16b │ │ │ │ │ -00011560: 6529 2e20 202a 4e6f 7465 2046 6f6e 7420 e). *Note Font │ │ │ │ │ -00011570: 4d65 7472 6963 733a 3a2c 2066 6f72 2064 Metrics::, for d │ │ │ │ │ -00011580: 6574 6169 6c73 2e0a 0a27 4348 4958 270a etails...'CHIX'. │ │ │ │ │ -00011590: 2020 2020 202a 4368 6172 6163 7465 7220 *Character │ │ │ │ │ -000115a0: 696e 6465 782e 2a20 2054 6865 2063 6861 index.* The cha │ │ │ │ │ -000115b0: 7261 6374 6572 2069 6e64 6578 2062 6567 racter index beg │ │ │ │ │ -000115c0: 696e 7320 7769 7468 2061 2033 322d 6269 ins with a 32-bi │ │ │ │ │ -000115d0: 740a 2020 2020 2062 6967 2d65 6e64 6961 t. big-endia │ │ │ │ │ -000115e0: 6e20 756e 7369 676e 6564 2069 6e74 6567 n unsigned integ │ │ │ │ │ -000115f0: 6572 2069 6e64 6963 6174 696e 6720 7468 er indicating th │ │ │ │ │ -00011600: 6520 746f 7461 6c20 7369 7a65 206f 6620 e total size of │ │ │ │ │ -00011610: 7468 650a 2020 2020 2073 6563 7469 6f6e the. section │ │ │ │ │ -00011620: 2c20 6e6f 7420 696e 636c 7564 696e 6720 , not including │ │ │ │ │ -00011630: 7468 6973 2073 697a 6520 7661 6c75 652e this size value. │ │ │ │ │ -00011640: 2020 466f 7220 6561 6368 2063 6861 7261 For each chara │ │ │ │ │ -00011650: 6374 6572 2c20 7468 6572 650a 2020 2020 cter, there. │ │ │ │ │ -00011660: 2069 7320 616e 2069 6e73 7461 6e63 6520 is an instance │ │ │ │ │ -00011670: 6f66 2074 6865 2066 6f6c 6c6f 7769 6e67 of the following │ │ │ │ │ -00011680: 2065 6e74 7279 2073 7472 7563 7475 7265 entry structure │ │ │ │ │ -00011690: 3a0a 0a20 2020 2020 2020 202a 202a 556e :.. * *Un │ │ │ │ │ -000116a0: 6963 6f64 6520 636f 6465 2070 6f69 6e74 icode code point │ │ │ │ │ -000116b0: 2e2a 2020 2833 322d 6269 7420 6269 672d .* (32-bit big- │ │ │ │ │ -000116c0: 656e 6469 616e 2069 6e74 6567 6572 2e29 endian integer.) │ │ │ │ │ -000116d0: 0a0a 2020 2020 2020 2020 2a20 2a53 746f .. * *Sto │ │ │ │ │ -000116e0: 7261 6765 2066 6c61 6773 2e2a 2020 2862 rage flags.* (b │ │ │ │ │ -000116f0: 7974 652e 290a 0a20 2020 2020 2020 2020 yte.).. │ │ │ │ │ -00011700: 2020 2020 2a20 4269 7473 2032 2e2e 303a * Bits 2..0: │ │ │ │ │ -00011710: 0a0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ -00011720: 2049 6620 6571 7561 6c20 746f 2030 3030 If equal to 000 │ │ │ │ │ -00011730: 2062 696e 6172 792c 2074 6865 6e20 7468 binary, then th │ │ │ │ │ -00011740: 6520 6368 6172 6163 7465 7220 6461 7461 e character data │ │ │ │ │ -00011750: 2069 7320 7374 6f72 6564 0a20 2020 2020 is stored. │ │ │ │ │ -00011760: 2020 2020 2020 2020 2020 756e 636f 6d70 uncomp │ │ │ │ │ -00011770: 7265 7373 6564 2062 6567 696e 6e69 6e67 ressed beginning │ │ │ │ │ -00011780: 2061 7420 7468 6520 6f66 6673 6574 2069 at the offset i │ │ │ │ │ -00011790: 6e64 6963 6174 6564 2062 7920 7468 650a ndicated by the. │ │ │ │ │ -000117a0: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ │ -000117b0: 6861 7261 6374 6572 2773 202a 6f66 6673 haracter's *offs │ │ │ │ │ -000117c0: 6574 2a20 7661 6c75 652e 0a0a 2020 2020 et* value... │ │ │ │ │ -000117d0: 2020 2020 2020 2020 2020 2049 6620 6571 If eq │ │ │ │ │ -000117e0: 7561 6c20 746f 2030 3031 2062 696e 6172 ual to 001 binar │ │ │ │ │ -000117f0: 792c 2074 6865 6e20 7468 6520 6368 6172 y, then the char │ │ │ │ │ -00011800: 6163 7465 7220 6461 7461 2069 7320 7374 acter data is st │ │ │ │ │ -00011810: 6f72 6564 0a20 2020 2020 2020 2020 2020 ored. │ │ │ │ │ -00011820: 2020 2020 7769 7468 696e 2061 2063 6f6d within a com │ │ │ │ │ -00011830: 7072 6573 7365 6420 6368 6172 6163 7465 pressed characte │ │ │ │ │ -00011840: 7220 6465 6669 6e69 7469 6f6e 2062 6c6f r definition blo │ │ │ │ │ -00011850: 636b 2074 6861 740a 2020 2020 2020 2020 ck that. │ │ │ │ │ -00011860: 2020 2020 2020 2062 6567 696e 7320 6174 begins at │ │ │ │ │ -00011870: 2074 6865 206f 6666 7365 7420 7769 7468 the offset with │ │ │ │ │ -00011880: 696e 2074 6865 2066 696c 6520 696e 6469 in the file indi │ │ │ │ │ -00011890: 6361 7465 6420 6279 2074 6865 0a20 2020 cated by the. │ │ │ │ │ -000118a0: 2020 2020 2020 2020 2020 2020 6368 6172 char │ │ │ │ │ -000118b0: 6163 7465 7227 7320 2a6f 6666 7365 742a acter's *offset* │ │ │ │ │ -000118c0: 2076 616c 7565 2e0a 0a20 2020 2020 2020 value... │ │ │ │ │ -000118d0: 202a 202a 4f66 6673 6574 2e2a 2020 2833 * *Offset.* (3 │ │ │ │ │ -000118e0: 322d 6269 7420 6269 672d 656e 6469 616e 2-bit big-endian │ │ │ │ │ -000118f0: 2069 6e74 6567 6572 2e29 0a0a 2020 2020 integer.).. │ │ │ │ │ -00011900: 2020 2020 2020 4120 6d61 726b 6572 2074 A marker t │ │ │ │ │ -00011910: 6861 7420 696e 6469 6361 7465 7320 7468 hat indicates th │ │ │ │ │ -00011920: 6520 7265 6d61 696e 6465 7220 6f66 2074 e remainder of t │ │ │ │ │ -00011930: 6865 2066 696c 6520 6973 2064 6174 610a he file is data. │ │ │ │ │ -00011940: 2020 2020 2020 2020 2020 6163 6365 7373 access │ │ │ │ │ -00011950: 6564 2076 6961 2074 6865 2063 6861 7261 ed via the chara │ │ │ │ │ -00011960: 6374 6572 2069 6e64 6578 2028 4348 4958 cter index (CHIX │ │ │ │ │ -00011970: 2920 7365 6374 696f 6e2e 2020 5768 656e ) section. When │ │ │ │ │ -00011980: 2072 6561 6469 6e67 0a20 2020 2020 2020 reading. │ │ │ │ │ -00011990: 2020 2074 6869 7320 666f 6e74 2066 696c this font fil │ │ │ │ │ -000119a0: 652c 2074 6865 2072 6573 7420 6f66 2074 e, the rest of t │ │ │ │ │ -000119b0: 6865 2066 696c 6520 6361 6e20 6265 2069 he file can be i │ │ │ │ │ -000119c0: 676e 6f72 6564 2077 6865 6e0a 2020 2020 gnored when. │ │ │ │ │ -000119d0: 2020 2020 2020 7363 616e 6e69 6e67 2074 scanning t │ │ │ │ │ -000119e0: 6865 2073 6563 7469 6f6e 732e 2020 5468 he sections. Th │ │ │ │ │ -000119f0: 6520 6c65 6e67 7468 2073 686f 756c 6420 e length should │ │ │ │ │ -00011a00: 6265 2073 6574 2074 6f20 2d31 0a20 2020 be set to -1. │ │ │ │ │ -00011a10: 2020 2020 2020 2028 3078 4646 4646 4646 (0xFFFFFF │ │ │ │ │ -00011a20: 4646 292e 0a0a 2020 2020 2020 2020 2020 FF)... │ │ │ │ │ -00011a30: 5375 7070 6f72 7465 6420 6461 7461 2073 Supported data s │ │ │ │ │ -00011a40: 7472 7563 7475 7265 733a 0a0a 2020 2020 tructures:.. │ │ │ │ │ -00011a50: 2020 2020 2020 4368 6172 6163 7465 7220 Character │ │ │ │ │ -00011a60: 6465 6669 6e69 7469 6f6e 2045 6163 6820 definition Each │ │ │ │ │ -00011a70: 6368 6172 6163 7465 7220 6465 6669 6e69 character defini │ │ │ │ │ -00011a80: 7469 6f6e 2063 6f6e 7369 7374 7320 6f66 tion consists of │ │ │ │ │ -00011a90: 3a0a 0a20 2020 2020 2020 2020 2020 2020 :.. │ │ │ │ │ -00011aa0: 2a20 2a57 6964 7468 2e2a 2020 5769 6474 * *Width.* Widt │ │ │ │ │ -00011ab0: 6820 6f66 2074 6865 2062 6974 6d61 7020 h of the bitmap │ │ │ │ │ -00011ac0: 696e 2070 6978 656c 732e 2020 5468 6520 in pixels. The │ │ │ │ │ -00011ad0: 6269 746d 6170 2773 0a20 2020 2020 2020 bitmap's. │ │ │ │ │ -00011ae0: 2020 2020 2020 2020 6578 7465 6e74 7320 extents │ │ │ │ │ -00011af0: 7265 7072 6573 656e 7420 7468 6520 676c represent the gl │ │ │ │ │ -00011b00: 7970 6827 7320 626f 756e 6469 6e67 2062 yph's bounding b │ │ │ │ │ -00011b10: 6f78 2e20 2027 7569 6e74 3136 6265 272e ox. 'uint16be'. │ │ │ │ │ -00011b20: 0a0a 2020 2020 2020 2020 2020 2020 202a .. * │ │ │ │ │ -00011b30: 202a 4865 6967 6874 2e2a 2020 4865 6967 *Height.* Heig │ │ │ │ │ -00011b40: 6874 206f 6620 7468 6520 6269 746d 6170 ht of the bitmap │ │ │ │ │ -00011b50: 2069 6e20 7069 7865 6c73 2e20 2054 6865 in pixels. The │ │ │ │ │ -00011b60: 2062 6974 6d61 7027 730a 2020 2020 2020 bitmap's. │ │ │ │ │ -00011b70: 2020 2020 2020 2020 2065 7874 656e 7473 extents │ │ │ │ │ -00011b80: 2072 6570 7265 7365 6e74 2074 6865 2067 represent the g │ │ │ │ │ -00011b90: 6c79 7068 2773 2062 6f75 6e64 696e 6720 lyph's bounding │ │ │ │ │ -00011ba0: 626f 782e 2020 2775 696e 7431 3662 6527 box. 'uint16be' │ │ │ │ │ -00011bb0: 2e0a 0a20 2020 2020 2020 2020 2020 2020 ... │ │ │ │ │ -00011bc0: 2a20 2a58 206f 6666 7365 742e 2a20 2054 * *X offset.* T │ │ │ │ │ -00011bd0: 6865 206e 756d 6265 7220 6f66 2070 6978 he number of pix │ │ │ │ │ -00011be0: 656c 7320 746f 2073 6869 6674 2074 6865 els to shift the │ │ │ │ │ -00011bf0: 2062 6974 6d61 7020 6279 0a20 2020 2020 bitmap by. │ │ │ │ │ -00011c00: 2020 2020 2020 2020 2020 686f 7269 7a6f horizo │ │ │ │ │ -00011c10: 6e74 616c 6c79 2062 6566 6f72 6520 6472 ntally before dr │ │ │ │ │ -00011c20: 6177 696e 6720 7468 6520 6368 6172 6163 awing the charac │ │ │ │ │ -00011c30: 7465 722e 2020 2769 6e74 3136 6265 272e ter. 'int16be'. │ │ │ │ │ -00011c40: 0a0a 2020 2020 2020 2020 2020 2020 202a .. * │ │ │ │ │ -00011c50: 202a 5920 6f66 6673 6574 2e2a 2020 5468 *Y offset.* Th │ │ │ │ │ -00011c60: 6520 6e75 6d62 6572 206f 6620 7069 7865 e number of pixe │ │ │ │ │ -00011c70: 6c73 2074 6f20 7368 6966 7420 7468 6520 ls to shift the │ │ │ │ │ -00011c80: 6269 746d 6170 2062 790a 2020 2020 2020 bitmap by. │ │ │ │ │ -00011c90: 2020 2020 2020 2020 2076 6572 7469 6361 vertica │ │ │ │ │ -00011ca0: 6c6c 7920 6265 666f 7265 2064 7261 7769 lly before drawi │ │ │ │ │ -00011cb0: 6e67 2074 6865 2063 6861 7261 6374 6572 ng the character │ │ │ │ │ -00011cc0: 2e20 2027 696e 7431 3662 6527 2e0a 0a20 . 'int16be'... │ │ │ │ │ -00011cd0: 2020 2020 2020 2020 2020 2020 2a20 2a44 * *D │ │ │ │ │ -00011ce0: 6576 6963 6520 7769 6474 682e 2a20 2054 evice width.* T │ │ │ │ │ -00011cf0: 6865 206e 756d 6265 7220 6f66 2070 6978 he number of pix │ │ │ │ │ -00011d00: 656c 7320 746f 2061 6476 616e 6365 0a20 els to advance. │ │ │ │ │ -00011d10: 2020 2020 2020 2020 2020 2020 2020 686f ho │ │ │ │ │ -00011d20: 7269 7a6f 6e74 616c 6c79 2066 726f 6d20 rizontally from │ │ │ │ │ -00011d30: 7468 6973 2063 6861 7261 6374 6572 2773 this character's │ │ │ │ │ -00011d40: 206f 7269 6769 6e20 746f 2074 6865 206f origin to the o │ │ │ │ │ -00011d50: 7269 6769 6e0a 2020 2020 2020 2020 2020 rigin. │ │ │ │ │ -00011d60: 2020 2020 206f 6620 7468 6520 6e65 7874 of the next │ │ │ │ │ -00011d70: 2063 6861 7261 6374 6572 2e20 2027 696e character. 'in │ │ │ │ │ -00011d80: 7431 3662 6527 2e0a 0a20 2020 2020 2020 t16be'... │ │ │ │ │ -00011d90: 2020 2020 2020 2a20 2a42 6974 6d61 7020 * *Bitmap │ │ │ │ │ -00011da0: 6461 7461 2e2a 2020 5468 6973 2069 7320 data.* This is │ │ │ │ │ -00011db0: 656e 636f 6465 6420 6173 2061 2073 7472 encoded as a str │ │ │ │ │ -00011dc0: 696e 6720 6f66 2062 6974 732e 2020 4974 ing of bits. It │ │ │ │ │ -00011dd0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00011de0: 6973 206f 7267 616e 697a 6564 2061 7320 is organized as │ │ │ │ │ -00011df0: 6120 726f 772d 6d61 6a6f 722c 2074 6f70 a row-major, top │ │ │ │ │ -00011e00: 2d64 6f77 6e2c 206c 6566 742d 746f 2d72 -down, left-to-r │ │ │ │ │ -00011e10: 6967 6874 0a20 2020 2020 2020 2020 2020 ight. │ │ │ │ │ -00011e20: 2020 2020 6269 746d 6170 2e20 2054 6865 bitmap. The │ │ │ │ │ -00011e30: 206d 6f73 7420 7369 676e 6966 6963 616e most significan │ │ │ │ │ -00011e40: 7420 6269 7420 6f66 2065 6163 6820 6279 t bit of each by │ │ │ │ │ -00011e50: 7465 2069 7320 7461 6b65 6e0a 2020 2020 te is taken. │ │ │ │ │ -00011e60: 2020 2020 2020 2020 2020 2074 6f20 6265 to be │ │ │ │ │ -00011e70: 2074 6865 206c 6566 746d 6f73 7420 6f72 the leftmost or │ │ │ │ │ -00011e80: 2075 7070 6572 6d6f 7374 2062 6974 2069 uppermost bit i │ │ │ │ │ -00011e90: 6e20 7468 6520 6279 7465 2e20 2046 6f72 n the byte. For │ │ │ │ │ -00011ea0: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ │ -00011eb0: 2020 2020 7361 6b65 206f 6620 636f 6d70 sake of comp │ │ │ │ │ -00011ec0: 6163 7420 7374 6f72 6167 652c 2072 6f77 act storage, row │ │ │ │ │ -00011ed0: 7320 6172 6520 6e6f 7420 7061 6464 6564 s are not padded │ │ │ │ │ -00011ee0: 2074 6f20 6279 7465 0a20 2020 2020 2020 to byte. │ │ │ │ │ -00011ef0: 2020 2020 2020 2020 626f 756e 6461 7269 boundari │ │ │ │ │ -00011f00: 6573 2028 692e 652e 2c20 6120 7369 6e67 es (i.e., a sing │ │ │ │ │ -00011f10: 6c65 2062 7974 6520 6d61 7920 636f 6e74 le byte may cont │ │ │ │ │ -00011f20: 6169 6e20 6269 7473 0a20 2020 2020 2020 ain bits. │ │ │ │ │ -00011f30: 2020 2020 2020 2020 6265 6c6f 6e67 696e belongin │ │ │ │ │ -00011f40: 6720 746f 206d 756c 7469 706c 6520 726f g to multiple ro │ │ │ │ │ -00011f50: 7773 292e 2020 5468 6520 6c61 7374 2062 ws). The last b │ │ │ │ │ -00011f60: 7974 6520 6f66 2074 6865 2062 6974 6d61 yte of the bitma │ │ │ │ │ -00011f70: 700a 2020 2020 2020 2020 2020 2020 2020 p. │ │ │ │ │ -00011f80: 202a 6973 2a20 7061 6464 6564 2077 6974 *is* padded wit │ │ │ │ │ -00011f90: 6820 7a65 726f 2062 6974 7320 696e 2074 h zero bits in t │ │ │ │ │ -00011fa0: 6865 2062 6974 7320 706f 7369 7469 6f6e he bits position │ │ │ │ │ -00011fb0: 7320 746f 2074 6865 0a20 2020 2020 2020 s to the. │ │ │ │ │ -00011fc0: 2020 2020 2020 2020 7269 6768 7420 6f66 right of │ │ │ │ │ -00011fd0: 2074 6865 206c 6173 7420 7573 6564 2062 the last used b │ │ │ │ │ -00011fe0: 6974 2069 6620 7468 6520 6269 746d 6170 it if the bitmap │ │ │ │ │ -00011ff0: 2064 6174 6120 646f 6573 206e 6f74 0a20 data does not. │ │ │ │ │ -00012000: 2020 2020 2020 2020 2020 2020 2020 6669 fi │ │ │ │ │ -00012010: 6c6c 2074 6865 206c 6173 7420 6279 7465 ll the last byte │ │ │ │ │ -00012020: 2e0a 0a20 2020 2020 2020 2020 2020 2020 ... │ │ │ │ │ -00012030: 2020 5468 6520 6c65 6e67 7468 206f 6620 The length of │ │ │ │ │ -00012040: 7468 6520 2a62 6974 6d61 7020 6461 7461 the *bitmap data │ │ │ │ │ -00012050: 2a20 6669 656c 6420 6973 2028 5749 4454 * field is (WIDT │ │ │ │ │ -00012060: 4820 2a20 4845 4947 4854 0a20 2020 2020 H * HEIGHT. │ │ │ │ │ -00012070: 2020 2020 2020 2020 2020 2b20 3729 202f + 7) / │ │ │ │ │ -00012080: 2038 2075 7369 6e67 2069 6e74 6567 6572 8 using integer │ │ │ │ │ -00012090: 2061 7269 7468 6d65 7469 632c 2077 6869 arithmetic, whi │ │ │ │ │ -000120a0: 6368 2069 7320 6571 7569 7661 6c65 6e74 ch is equivalent │ │ │ │ │ -000120b0: 2074 6f0a 2020 2020 2020 2020 2020 2020 to. │ │ │ │ │ -000120c0: 2020 2063 6569 6c28 5749 4454 4820 2a20 ceil(WIDTH * │ │ │ │ │ -000120d0: 4845 4947 4854 202f 2038 2920 7573 696e HEIGHT / 8) usin │ │ │ │ │ -000120e0: 6720 7265 616c 206e 756d 6265 7220 6172 g real number ar │ │ │ │ │ -000120f0: 6974 686d 6574 6963 2e0a 0a20 2020 2020 ithmetic... │ │ │ │ │ -00012100: 2020 2020 2020 2020 2020 4974 2072 656d It rem │ │ │ │ │ -00012110: 6169 6e73 2074 6f20 6265 2064 6574 6572 ains to be deter │ │ │ │ │ -00012120: 6d69 6e65 6420 7768 6574 6865 7220 6269 mined whether bi │ │ │ │ │ -00012130: 746d 6170 2066 6f6e 7473 2075 7375 616c tmap fonts usual │ │ │ │ │ -00012140: 6c79 0a20 2020 2020 2020 2020 2020 2020 ly. │ │ │ │ │ -00012150: 2020 6d61 6b65 2061 6c6c 2067 6c79 7068 make all glyph │ │ │ │ │ -00012160: 2062 6974 6d61 7073 2074 6865 2073 616d bitmaps the sam │ │ │ │ │ -00012170: 6520 6865 6967 6874 2c20 6f72 2069 6620 e height, or if │ │ │ │ │ -00012180: 736d 616c 6c65 720a 2020 2020 2020 2020 smaller. │ │ │ │ │ -00012190: 2020 2020 2020 2067 6c79 7068 7320 6172 glyphs ar │ │ │ │ │ -000121a0: 6520 7374 6f72 6564 2077 6974 6820 6269 e stored with bi │ │ │ │ │ -000121b0: 746d 6170 7320 6861 7669 6e67 2061 206c tmaps having a l │ │ │ │ │ -000121c0: 6573 7365 7220 6865 6967 6874 2e0a 2020 esser height.. │ │ │ │ │ -000121d0: 2020 2020 2020 2020 2020 2020 2049 6e20 In │ │ │ │ │ -000121e0: 7468 6520 6c61 7474 6572 2063 6173 652c the latter case, │ │ │ │ │ -000121f0: 2074 6865 2062 6173 656c 696e 6520 776f the baseline wo │ │ │ │ │ -00012200: 756c 6420 6861 7665 2074 6f20 6265 2075 uld have to be u │ │ │ │ │ -00012210: 7365 6420 746f 0a20 2020 2020 2020 2020 sed to. │ │ │ │ │ -00012220: 2020 2020 2020 6361 6c63 756c 6174 6520 calculate │ │ │ │ │ -00012230: 7468 6520 6c6f 6361 7469 6f6e 2074 6865 the location the │ │ │ │ │ -00012240: 2062 6974 6d61 7020 7368 6f75 6c64 2062 bitmap should b │ │ │ │ │ -00012250: 6520 616e 6368 6f72 6564 2061 740a 2020 e anchored at. │ │ │ │ │ -00012260: 2020 2020 2020 2020 2020 2020 206f 6e20 on │ │ │ │ │ -00012270: 7363 7265 656e 2e0a 0a1f 0a46 696c 653a screen.....File: │ │ │ │ │ -00012280: 2067 7275 622d 6465 762e 696e 666f 2c20 grub-dev.info, │ │ │ │ │ -00012290: 204e 6f64 653a 2046 6f6e 7420 4d65 7472 Node: Font Metr │ │ │ │ │ -000122a0: 6963 732c 2020 5072 6576 3a20 4669 6c65 ics, Prev: File │ │ │ │ │ -000122b0: 2053 7472 7563 7475 7265 2c20 2055 703a Structure, Up: │ │ │ │ │ -000122c0: 2050 4646 3220 466f 6e74 2046 696c 6520 PFF2 Font File │ │ │ │ │ -000122d0: 466f 726d 6174 0a0a 3131 2e33 2046 6f6e Format..11.3 Fon │ │ │ │ │ -000122e0: 7420 4d65 7472 6963 730a 3d3d 3d3d 3d3d t Metrics.====== │ │ │ │ │ -000122f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a20 2020 ===========.. │ │ │ │ │ -00012300: 2a20 4173 6365 6e74 2e20 2054 6865 2064 * Ascent. The d │ │ │ │ │ -00012310: 6973 7461 6e63 6520 6672 6f6d 2074 6865 istance from the │ │ │ │ │ -00012320: 2062 6173 656c 696e 6520 746f 2074 6865 baseline to the │ │ │ │ │ -00012330: 2074 6f70 206f 6620 6d6f 7374 0a20 2020 top of most. │ │ │ │ │ -00012340: 2020 6368 6172 6163 7465 7273 2e20 204e characters. N │ │ │ │ │ -00012350: 6f74 6520 7468 6174 2069 6e20 736f 6d65 ote that in some │ │ │ │ │ -00012360: 2063 6173 6573 2063 6861 7261 6374 6572 cases character │ │ │ │ │ -00012370: 7320 6d61 7920 6578 7465 6e64 2061 626f s may extend abo │ │ │ │ │ -00012380: 7665 0a20 2020 2020 7468 6520 6173 6365 ve. the asce │ │ │ │ │ -00012390: 6e74 2e0a 0a20 2020 2a20 4465 7363 656e nt... * Descen │ │ │ │ │ -000123a0: 742e 2020 5468 6520 6469 7374 616e 6365 t. The distance │ │ │ │ │ -000123b0: 2066 726f 6d20 7468 6520 6261 7365 6c69 from the baseli │ │ │ │ │ -000123c0: 6e65 2074 6f20 7468 6520 626f 7474 6f6d ne to the bottom │ │ │ │ │ -000123d0: 206f 6620 6d6f 7374 0a20 2020 2020 6368 of most. ch │ │ │ │ │ -000123e0: 6172 6163 7465 7273 2e20 204e 6f74 6520 aracters. Note │ │ │ │ │ -000123f0: 7468 6174 2069 6e20 736f 6d65 2063 6173 that in some cas │ │ │ │ │ -00012400: 6573 2063 6861 7261 6374 6572 7320 6d61 es characters ma │ │ │ │ │ -00012410: 7920 6578 7465 6e64 2062 656c 6f77 0a20 y extend below. │ │ │ │ │ -00012420: 2020 2020 7468 6520 6465 7363 656e 742e the descent. │ │ │ │ │ -00012430: 0a0a 2020 202a 204c 6561 6469 6e67 2e20 .. * Leading. │ │ │ │ │ -00012440: 2054 6865 2061 6d6f 756e 7420 6f66 2073 The amount of s │ │ │ │ │ -00012450: 7061 6365 2c20 696e 2070 6978 656c 732c pace, in pixels, │ │ │ │ │ -00012460: 2074 6f20 6c65 6176 6520 6265 7477 6565 to leave betwee │ │ │ │ │ -00012470: 6e20 7468 650a 2020 2020 2064 6573 6365 n the. desce │ │ │ │ │ -00012480: 6e74 206f 6620 6f6e 6520 6c69 6e65 206f nt of one line o │ │ │ │ │ -00012490: 6620 7465 7874 2061 6e64 2074 6865 2061 f text and the a │ │ │ │ │ -000124a0: 7363 656e 7420 6f66 2074 6865 206e 6578 scent of the nex │ │ │ │ │ -000124b0: 7420 6c69 6e65 2e20 2054 6869 730a 2020 t line. This. │ │ │ │ │ -000124c0: 2020 206d 6574 7269 6373 2069 7320 6e6f metrics is no │ │ │ │ │ -000124d0: 7420 7370 6563 6966 6965 6420 696e 2074 t specified in t │ │ │ │ │ -000124e0: 6865 2063 7572 7265 6e74 2066 696c 6520 he current file │ │ │ │ │ -000124f0: 666f 726d 6174 3b20 696e 7374 6561 642c format; instead, │ │ │ │ │ -00012500: 2074 6865 0a20 2020 2020 666f 6e74 2072 the. font r │ │ │ │ │ -00012510: 656e 6465 7269 6e67 2065 6e67 696e 6520 endering engine │ │ │ │ │ -00012520: 6361 6c63 756c 6174 6573 2061 2072 6561 calculates a rea │ │ │ │ │ -00012530: 736f 6e61 626c 6520 6c65 6164 696e 6720 sonable leading │ │ │ │ │ -00012540: 7661 6c75 6520 6261 7365 640a 2020 2020 value based. │ │ │ │ │ -00012550: 206f 6e20 7468 6520 6f74 6865 7220 666f on the other fo │ │ │ │ │ -00012560: 6e74 206d 6574 7269 6373 2e0a 0a20 2020 nt metrics... │ │ │ │ │ -00012570: 2a20 486f 7269 7a6f 6e61 6c20 6c65 6164 * Horizonal lead │ │ │ │ │ -00012580: 696e 672e 2020 5468 6520 616d 6f75 6e74 ing. The amount │ │ │ │ │ -00012590: 206f 6620 7370 6163 652c 2069 6e20 7069 of space, in pi │ │ │ │ │ -000125a0: 7865 6c73 2c20 746f 206c 6561 7665 0a20 xels, to leave. │ │ │ │ │ -000125b0: 2020 2020 686f 7269 7a6f 6e74 616c 6c79 horizontally │ │ │ │ │ -000125c0: 2062 6574 7765 656e 2074 6865 206c 6566 between the lef │ │ │ │ │ -000125d0: 7420 616e 6420 7269 6768 7420 6564 6765 t and right edge │ │ │ │ │ -000125e0: 7320 6f66 2074 776f 2061 646a 6163 656e s of two adjacen │ │ │ │ │ -000125f0: 740a 2020 2020 2067 6c79 7068 732e 2020 t. glyphs. │ │ │ │ │ -00012600: 5468 6520 2a64 6576 6963 6520 7769 6474 The *device widt │ │ │ │ │ -00012610: 682a 2066 6965 6c64 2064 6574 6572 6d69 h* field determi │ │ │ │ │ -00012620: 6e65 7320 7468 6520 6566 6665 6374 6976 nes the effectiv │ │ │ │ │ -00012630: 6520 6c65 6164 696e 670a 2020 2020 2076 e leading. v │ │ │ │ │ -00012640: 616c 7565 2074 6861 7420 6973 2075 7365 alue that is use │ │ │ │ │ -00012650: 6420 746f 2072 656e 6465 7220 7468 6520 d to render the │ │ │ │ │ -00012660: 666f 6e74 2e0a 0a00 085b 696d 6167 6520 font.....[image │ │ │ │ │ -00012670: 7372 633d 2266 6f6e 745f 6368 6172 5f6d src="font_char_m │ │ │ │ │ -00012680: 6574 7269 6373 2e70 6e67 2220 7465 7874 etrics.png" text │ │ │ │ │ -00012690: 3d22 506c 6561 7365 2066 696c 6c20 7468 ="Please fill th │ │ │ │ │ -000126a0: 6973 2069 6e2e 2200 085d 0a0a 0a20 2020 is in."..]... │ │ │ │ │ -000126b0: 416e 2069 6c6c 7573 7472 6174 696f 6e20 An illustration │ │ │ │ │ -000126c0: 6f66 2068 6f77 2074 6865 2076 6172 696f of how the vario │ │ │ │ │ -000126d0: 7573 2066 6f6e 7420 6d65 7472 6963 7320 us font metrics │ │ │ │ │ -000126e0: 6170 706c 7920 746f 2063 6861 7261 6374 apply to charact │ │ │ │ │ -000126f0: 6572 732e 0a0a 1f0a 4669 6c65 3a20 6772 ers.....File: gr │ │ │ │ │ -00012700: 7562 2d64 6576 2e69 6e66 6f2c 2020 4e6f ub-dev.info, No │ │ │ │ │ -00012710: 6465 3a20 4772 6170 6869 6361 6c20 4d65 de: Graphical Me │ │ │ │ │ -00012720: 6e75 2053 6f66 7477 6172 6520 4465 7369 nu Software Desi │ │ │ │ │ -00012730: 676e 2c20 204e 6578 743a 2056 6572 6966 gn, Next: Verif │ │ │ │ │ -00012740: 6965 7273 2066 7261 6d65 776f 726b 2c20 iers framework, │ │ │ │ │ -00012750: 2050 7265 763a 2050 4646 3220 466f 6e74 Prev: PFF2 Font │ │ │ │ │ -00012760: 2046 696c 6520 466f 726d 6174 2c20 2055 File Format, U │ │ │ │ │ -00012770: 703a 2054 6f70 0a0a 3132 2047 7261 7068 p: Top..12 Graph │ │ │ │ │ -00012780: 6963 616c 204d 656e 7520 536f 6674 7761 ical Menu Softwa │ │ │ │ │ -00012790: 7265 2044 6573 6967 6e0a 2a2a 2a2a 2a2a re Design.****** │ │ │ │ │ +00010aa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +00010ab0: 2020 2a20 5369 6d70 6c65 2074 6f20 7265 * Simple to re │ │ │ │ │ +00010ac0: 6164 2061 6e64 2075 7365 2e20 2053 696e ad and use. Sin │ │ │ │ │ +00010ad0: 6365 2047 5255 4220 7769 6c6c 206f 6e6c ce GRUB will onl │ │ │ │ │ +00010ae0: 7920 6265 2072 6561 6469 6e67 2074 6865 y be reading the │ │ │ │ │ +00010af0: 2066 6f6e 740a 2020 2020 2066 696c 6573 font. files │ │ │ │ │ +00010b00: 2c20 7765 2061 7265 206d 6f72 6520 636f , we are more co │ │ │ │ │ +00010b10: 6e63 6572 6e65 6420 7769 7468 206d 616b ncerned with mak │ │ │ │ │ +00010b20: 696e 6720 7468 6520 636f 6465 2074 6f20 ing the code to │ │ │ │ │ +00010b30: 7265 6164 2074 6865 2066 6f6e 740a 2020 read the font. │ │ │ │ │ +00010b40: 2020 2073 696d 706c 6520 7468 616e 2077 simple than w │ │ │ │ │ +00010b50: 6520 6172 6520 7769 7468 2077 7269 7469 e are with writi │ │ │ │ │ +00010b60: 6e67 2074 6865 2066 6f6e 742e 0a0a 2020 ng the font... │ │ │ │ │ +00010b70: 202a 2043 6f6d 7061 6374 2073 746f 7261 * Compact stora │ │ │ │ │ +00010b80: 6765 2e20 2054 6865 2066 6f6e 7473 2077 ge. The fonts w │ │ │ │ │ +00010b90: 696c 6c20 6765 6e65 7261 6c6c 7920 6265 ill generally be │ │ │ │ │ +00010ba0: 2073 746f 7265 6420 696e 2061 2073 6d61 stored in a sma │ │ │ │ │ +00010bb0: 6c6c 0a20 2020 2020 626f 6f74 2070 6172 ll. boot par │ │ │ │ │ +00010bc0: 7469 7469 6f6e 2077 6865 7265 2047 5255 tition where GRU │ │ │ │ │ +00010bd0: 4220 6973 206c 6f63 6174 6564 2c20 616e B is located, an │ │ │ │ │ +00010be0: 6420 7468 6973 206d 6179 2062 6520 6f6e d this may be on │ │ │ │ │ +00010bf0: 2061 0a20 2020 2020 7265 6d6f 7661 626c a. removabl │ │ │ │ │ +00010c00: 6520 7374 6f72 6167 6520 6465 7669 6365 e storage device │ │ │ │ │ +00010c10: 2073 7563 6820 6173 2061 2043 4420 6f72 such as a CD or │ │ │ │ │ +00010c20: 2055 5342 2066 6c61 7368 2064 7269 7665 USB flash drive │ │ │ │ │ +00010c30: 2077 6865 7265 0a20 2020 2020 7370 6163 where. spac │ │ │ │ │ +00010c40: 6520 6973 206d 6f72 6520 6c69 6d69 7465 e is more limite │ │ │ │ │ +00010c50: 6420 7468 616e 2069 7420 6973 206f 6e20 d than it is on │ │ │ │ │ +00010c60: 6d6f 7374 2068 6172 6420 6472 6976 6573 most hard drives │ │ │ │ │ +00010c70: 2e0a 0a20 2020 2a20 556e 6963 6f64 652e ... * Unicode. │ │ │ │ │ +00010c80: 2020 4752 5542 2073 686f 756c 6420 6e6f GRUB should no │ │ │ │ │ +00010c90: 7420 6861 7665 2074 6f20 6465 616c 2077 t have to deal w │ │ │ │ │ +00010ca0: 6974 6820 6d75 6c74 6970 6c65 2063 6861 ith multiple cha │ │ │ │ │ +00010cb0: 7261 6374 6572 0a20 2020 2020 656e 636f racter. enco │ │ │ │ │ +00010cc0: 6469 6e67 732e 2020 5468 6520 666f 6e74 dings. The font │ │ │ │ │ +00010cd0: 2073 686f 756c 6420 616c 7761 7973 2075 should always u │ │ │ │ │ +00010ce0: 7365 2055 6e69 636f 6465 2063 6861 7261 se Unicode chara │ │ │ │ │ +00010cf0: 6374 6572 2063 6f64 6573 2066 6f72 0a20 cter codes for. │ │ │ │ │ +00010d00: 2020 2020 7369 6d70 6c65 2069 6e74 6572 simple inter │ │ │ │ │ +00010d10: 6e61 7469 6f6e 616c 697a 6174 696f 6e2e nationalization. │ │ │ │ │ +00010d20: 0a0a 3131 2e31 2e32 2057 6879 2041 6e6f ..11.1.2 Why Ano │ │ │ │ │ +00010d30: 7468 6572 2046 6f6e 7420 466f 726d 6174 ther Font Format │ │ │ │ │ +00010d40: 3f0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ?.-------------- │ │ │ │ │ +00010d50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00010d60: 2d0a 0a54 6865 7265 2061 7265 206d 616e -..There are man │ │ │ │ │ +00010d70: 7920 6578 6973 7469 6e67 2062 6974 6d61 y existing bitma │ │ │ │ │ +00010d80: 7020 666f 6e74 2066 6f72 6d61 7473 2074 p font formats t │ │ │ │ │ +00010d90: 6861 7420 4752 5542 2063 6f75 6c64 2075 hat GRUB could u │ │ │ │ │ +00010da0: 7365 2e0a 486f 7765 7665 722c 2074 6865 se..However, the │ │ │ │ │ +00010db0: 7265 2061 7265 2061 7370 6563 7473 206f re are aspects o │ │ │ │ │ +00010dc0: 6620 7468 6573 6520 666f 726d 6174 7320 f these formats │ │ │ │ │ +00010dd0: 7468 6174 206d 6179 206d 616b 6520 7468 that may make th │ │ │ │ │ +00010de0: 656d 206c 6573 7320 7468 616e 0a73 7569 em less than.sui │ │ │ │ │ +00010df0: 7461 626c 6520 666f 7220 7573 6520 696e table for use in │ │ │ │ │ +00010e00: 2047 5255 4220 6174 2074 6869 7320 7469 GRUB at this ti │ │ │ │ │ +00010e10: 6d65 3a0a 0a27 4244 4627 0a20 2020 2020 me:..'BDF'. │ │ │ │ │ +00010e20: 496e 6566 6669 6369 656e 7420 7374 6f72 Inefficient stor │ │ │ │ │ +00010e30: 6167 653b 2075 7365 7320 4153 4349 4920 age; uses ASCII │ │ │ │ │ +00010e40: 746f 2064 6573 6372 6962 6520 7072 6f70 to describe prop │ │ │ │ │ +00010e50: 6572 7469 6573 2061 6e64 0a20 2020 2020 erties and. │ │ │ │ │ +00010e60: 6865 7861 6465 6369 6d61 6c20 6e75 6d62 hexadecimal numb │ │ │ │ │ +00010e70: 6572 7320 696e 2041 5343 4949 2066 6f72 ers in ASCII for │ │ │ │ │ +00010e80: 2074 6865 2062 6974 6d61 7020 726f 7773 the bitmap rows │ │ │ │ │ +00010e90: 2e0a 2750 4346 270a 2020 2020 204d 616e ..'PCF'. Man │ │ │ │ │ +00010ea0: 7920 666f 726d 6174 2076 6172 6961 7469 y format variati │ │ │ │ │ +00010eb0: 6f6e 7320 7375 6368 2061 7320 6279 7465 ons such as byte │ │ │ │ │ +00010ec0: 206f 7264 6572 2061 6e64 2062 6974 6d61 order and bitma │ │ │ │ │ +00010ed0: 7020 7061 6464 696e 6720 2872 6f77 730a p padding (rows. │ │ │ │ │ +00010ee0: 2020 2020 2070 6164 6465 6420 746f 2062 padded to b │ │ │ │ │ +00010ef0: 7974 652c 2077 6f72 642c 2065 7463 2e29 yte, word, etc.) │ │ │ │ │ +00010f00: 2020 776f 756c 6420 7265 7375 6c74 2069 would result i │ │ │ │ │ +00010f10: 6e20 6d6f 7265 2063 6f6d 706c 6578 2063 n more complex c │ │ │ │ │ +00010f20: 6f64 6520 746f 0a20 2020 2020 6861 6e64 ode to. hand │ │ │ │ │ +00010f30: 6c65 2074 6865 2066 6f6e 7420 666f 726d le the font form │ │ │ │ │ +00010f40: 6174 2e0a 0a1f 0a46 696c 653a 2067 7275 at.....File: gru │ │ │ │ │ +00010f50: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +00010f60: 653a 2046 696c 6520 5374 7275 6374 7572 e: File Structur │ │ │ │ │ +00010f70: 652c 2020 4e65 7874 3a20 466f 6e74 204d e, Next: Font M │ │ │ │ │ +00010f80: 6574 7269 6373 2c20 2050 7265 763a 2049 etrics, Prev: I │ │ │ │ │ +00010f90: 6e74 726f 6475 6374 696f 6e2c 2020 5570 ntroduction, Up │ │ │ │ │ +00010fa0: 3a20 5046 4632 2046 6f6e 7420 4669 6c65 : PFF2 Font File │ │ │ │ │ +00010fb0: 2046 6f72 6d61 740a 0a31 312e 3220 4669 Format..11.2 Fi │ │ │ │ │ +00010fc0: 6c65 2053 7472 7563 7475 7265 0a3d 3d3d le Structure.=== │ │ │ │ │ +00010fd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00010fe0: 0a0a 4120 6669 6c65 202a 7365 6374 696f ..A file *sectio │ │ │ │ │ +00010ff0: 6e2a 2063 6f6e 7369 7374 7320 6f66 2061 n* consists of a │ │ │ │ │ +00011000: 2034 2d62 7974 6520 6e61 6d65 2c20 6120 4-byte name, a │ │ │ │ │ +00011010: 3332 2d62 6974 2062 6967 2d65 6e64 6961 32-bit big-endia │ │ │ │ │ +00011020: 6e20 6c65 6e67 7468 0a28 6e6f 7420 696e n length.(not in │ │ │ │ │ +00011030: 636c 7564 696e 6720 7468 6520 6e61 6d65 cluding the name │ │ │ │ │ +00011040: 206f 7220 6c65 6e67 7468 292c 2061 6e64 or length), and │ │ │ │ │ +00011050: 2074 6865 6e20 4c45 4e47 5448 206d 6f72 then LENGTH mor │ │ │ │ │ +00011060: 650a 7365 6374 696f 6e2d 7479 7065 2d73 e.section-type-s │ │ │ │ │ +00011070: 7065 6369 6669 6320 6279 7465 732e 0a0a pecific bytes... │ │ │ │ │ +00011080: 2020 2054 6865 2073 7461 6e64 6172 6420 The standard │ │ │ │ │ +00011090: 6669 6c65 2065 7874 656e 7369 6f6e 2066 file extension f │ │ │ │ │ +000110a0: 6f72 2050 4646 3220 666f 6e74 2066 696c or PFF2 font fil │ │ │ │ │ +000110b0: 6573 2069 7320 272e 7066 3227 2e0a 0a31 es is '.pf2'...1 │ │ │ │ │ +000110c0: 312e 322e 3120 5365 6374 696f 6e20 5479 1.2.1 Section Ty │ │ │ │ │ +000110d0: 7065 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d pes.------------ │ │ │ │ │ +000110e0: 2d2d 2d2d 2d2d 2d2d 0a0a 2746 494c 4527 --------..'FILE' │ │ │ │ │ +000110f0: 0a20 2020 2020 2a46 696c 6520 7479 7065 . *File type │ │ │ │ │ +00011100: 2049 442a 2028 4153 4349 4920 7374 7269 ID* (ASCII stri │ │ │ │ │ +00011110: 6e67 292e 2020 5468 6973 206d 7573 7420 ng). This must │ │ │ │ │ +00011120: 6265 2074 6865 2066 6972 7374 2073 6563 be the first sec │ │ │ │ │ +00011130: 7469 6f6e 2069 6e0a 2020 2020 2074 6865 tion in. the │ │ │ │ │ +00011140: 2066 696c 652e 2020 4974 2068 6173 206c file. It has l │ │ │ │ │ +00011150: 656e 6774 6820 3420 616e 6420 7468 6520 ength 4 and the │ │ │ │ │ +00011160: 636f 6e74 656e 7473 2061 7265 2074 6865 contents are the │ │ │ │ │ +00011170: 2066 6f75 7220 6279 7465 7320 6f66 0a20 four bytes of. │ │ │ │ │ +00011180: 2020 2020 7468 6520 4153 4349 4920 7374 the ASCII st │ │ │ │ │ +00011190: 7269 6e67 2027 5046 4632 272e 0a0a 274e ring 'PFF2'...'N │ │ │ │ │ +000111a0: 414d 4527 0a20 2020 2020 2a46 6f6e 7420 AME'. *Font │ │ │ │ │ +000111b0: 6e61 6d65 2a20 2841 5343 4949 2073 7472 name* (ASCII str │ │ │ │ │ +000111c0: 696e 6729 2e20 2054 6869 7320 6973 2074 ing). This is t │ │ │ │ │ +000111d0: 6865 2066 756c 6c20 666f 6e74 206e 616d he full font nam │ │ │ │ │ +000111e0: 6520 696e 636c 7564 696e 670a 2020 2020 e including. │ │ │ │ │ +000111f0: 2066 616d 696c 792c 2077 6569 6768 742c family, weight, │ │ │ │ │ +00011200: 2073 7479 6c65 2c20 616e 6420 706f 696e style, and poin │ │ │ │ │ +00011210: 7420 7369 7a65 2e20 2046 6f72 2069 6e73 t size. For ins │ │ │ │ │ +00011220: 7461 6e63 652c 2022 4865 6c76 6574 6963 tance, "Helvetic │ │ │ │ │ +00011230: 610a 2020 2020 2042 6f6c 6420 4974 616c a. Bold Ital │ │ │ │ │ +00011240: 6963 2031 3422 2e0a 0a27 4641 4d49 270a ic 14"...'FAMI'. │ │ │ │ │ +00011250: 2020 2020 202a 466f 6e74 2066 616d 696c *Font famil │ │ │ │ │ +00011260: 7920 6e61 6d65 2a20 2841 5343 4949 2073 y name* (ASCII s │ │ │ │ │ +00011270: 7472 696e 6729 2e20 2046 6f72 2069 6e73 tring). For ins │ │ │ │ │ +00011280: 7461 6e63 652c 2022 4865 6c76 6574 6963 tance, "Helvetic │ │ │ │ │ +00011290: 6122 2e0a 2020 2020 2054 6869 7320 7368 a".. This sh │ │ │ │ │ +000112a0: 6f75 6c64 2062 6520 696e 636c 7564 6564 ould be included │ │ │ │ │ +000112b0: 2073 6f20 7468 6174 2069 6e74 656c 6c69 so that intelli │ │ │ │ │ +000112c0: 6765 6e74 2066 6f6e 7420 7375 6273 7469 gent font substi │ │ │ │ │ +000112d0: 7475 7469 6f6e 2063 616e 0a20 2020 2020 tution can. │ │ │ │ │ +000112e0: 7461 6b65 2070 6c61 6365 2e0a 0a27 5745 take place...'WE │ │ │ │ │ +000112f0: 4947 270a 2020 2020 202a 466f 6e74 2077 IG'. *Font w │ │ │ │ │ +00011300: 6569 6768 742a 2028 4153 4349 4920 7374 eight* (ASCII st │ │ │ │ │ +00011310: 7269 6e67 292e 2020 5661 6c69 6420 7661 ring). Valid va │ │ │ │ │ +00011320: 6c75 6573 2061 7265 2027 626f 6c64 2720 lues are 'bold' │ │ │ │ │ +00011330: 616e 640a 2020 2020 2027 6e6f 726d 616c and. 'normal │ │ │ │ │ +00011340: 272e 2020 5468 6973 2073 686f 756c 6420 '. This should │ │ │ │ │ +00011350: 6265 2069 6e63 6c75 6465 6420 736f 2074 be included so t │ │ │ │ │ +00011360: 6861 7420 696e 7465 6c6c 6967 656e 7420 hat intelligent │ │ │ │ │ +00011370: 666f 6e74 0a20 2020 2020 7375 6273 7469 font. substi │ │ │ │ │ +00011380: 7475 7469 6f6e 2063 616e 2074 616b 6520 tution can take │ │ │ │ │ +00011390: 706c 6163 652e 0a0a 2753 4c41 4e27 0a20 place...'SLAN'. │ │ │ │ │ +000113a0: 2020 2020 2a46 6f6e 7420 736c 616e 742a *Font slant* │ │ │ │ │ +000113b0: 2028 4153 4349 4920 7374 7269 6e67 292e (ASCII string). │ │ │ │ │ +000113c0: 2020 5661 6c69 6420 7661 6c75 6573 2061 Valid values a │ │ │ │ │ +000113d0: 7265 2027 6974 616c 6963 2720 616e 640a re 'italic' and. │ │ │ │ │ +000113e0: 2020 2020 2027 6e6f 726d 616c 272e 2020 'normal'. │ │ │ │ │ +000113f0: 5468 6973 2073 686f 756c 6420 6265 2069 This should be i │ │ │ │ │ +00011400: 6e63 6c75 6465 6420 736f 2074 6861 7420 ncluded so that │ │ │ │ │ +00011410: 696e 7465 6c6c 6967 656e 7420 666f 6e74 intelligent font │ │ │ │ │ +00011420: 0a20 2020 2020 7375 6273 7469 7475 7469 . substituti │ │ │ │ │ +00011430: 6f6e 2063 616e 2074 616b 6520 706c 6163 on can take plac │ │ │ │ │ +00011440: 652e 0a0a 2750 5453 5a27 0a20 2020 2020 e...'PTSZ'. │ │ │ │ │ +00011450: 2a46 6f6e 7420 706f 696e 7420 7369 7a65 *Font point size │ │ │ │ │ +00011460: 2a20 2875 696e 7431 3662 6529 2e0a 0a27 * (uint16be)...' │ │ │ │ │ +00011470: 4d41 5857 270a 2020 2020 202a 4d61 7869 MAXW'. *Maxi │ │ │ │ │ +00011480: 6d75 6d20 6368 6172 6163 7465 7220 7769 mum character wi │ │ │ │ │ +00011490: 6474 6820 696e 2070 6978 656c 732a 2028 dth in pixels* ( │ │ │ │ │ +000114a0: 7569 6e74 3136 6265 292e 0a0a 274d 4158 uint16be)...'MAX │ │ │ │ │ +000114b0: 4827 0a20 2020 2020 2a4d 6178 696d 756d H'. *Maximum │ │ │ │ │ +000114c0: 2063 6861 7261 6374 6572 2068 6569 6768 character heigh │ │ │ │ │ +000114d0: 7420 696e 2070 6978 656c 732a 2028 7569 t in pixels* (ui │ │ │ │ │ +000114e0: 6e74 3136 6265 292e 0a0a 2741 5343 4527 nt16be)...'ASCE' │ │ │ │ │ +000114f0: 0a20 2020 2020 2a41 7363 656e 7420 696e . *Ascent in │ │ │ │ │ +00011500: 2070 6978 656c 732a 2028 7569 6e74 3136 pixels* (uint16 │ │ │ │ │ +00011510: 6265 292e 2020 2a4e 6f74 6520 466f 6e74 be). *Note Font │ │ │ │ │ +00011520: 204d 6574 7269 6373 3a3a 2c20 666f 7220 Metrics::, for │ │ │ │ │ +00011530: 6465 7461 696c 732e 0a0a 2744 4553 4327 details...'DESC' │ │ │ │ │ +00011540: 0a20 2020 2020 2a44 6573 6365 6e74 2069 . *Descent i │ │ │ │ │ +00011550: 6e20 7069 7865 6c73 2a20 2875 696e 7431 n pixels* (uint1 │ │ │ │ │ +00011560: 3662 6529 2e20 202a 4e6f 7465 2046 6f6e 6be). *Note Fon │ │ │ │ │ +00011570: 7420 4d65 7472 6963 733a 3a2c 2066 6f72 t Metrics::, for │ │ │ │ │ +00011580: 2064 6574 6169 6c73 2e0a 0a27 4348 4958 details...'CHIX │ │ │ │ │ +00011590: 270a 2020 2020 202a 4368 6172 6163 7465 '. *Characte │ │ │ │ │ +000115a0: 7220 696e 6465 782e 2a20 2054 6865 2063 r index.* The c │ │ │ │ │ +000115b0: 6861 7261 6374 6572 2069 6e64 6578 2062 haracter index b │ │ │ │ │ +000115c0: 6567 696e 7320 7769 7468 2061 2033 322d egins with a 32- │ │ │ │ │ +000115d0: 6269 740a 2020 2020 2062 6967 2d65 6e64 bit. big-end │ │ │ │ │ +000115e0: 6961 6e20 756e 7369 676e 6564 2069 6e74 ian unsigned int │ │ │ │ │ +000115f0: 6567 6572 2069 6e64 6963 6174 696e 6720 eger indicating │ │ │ │ │ +00011600: 7468 6520 746f 7461 6c20 7369 7a65 206f the total size o │ │ │ │ │ +00011610: 6620 7468 650a 2020 2020 2073 6563 7469 f the. secti │ │ │ │ │ +00011620: 6f6e 2c20 6e6f 7420 696e 636c 7564 696e on, not includin │ │ │ │ │ +00011630: 6720 7468 6973 2073 697a 6520 7661 6c75 g this size valu │ │ │ │ │ +00011640: 652e 2020 466f 7220 6561 6368 2063 6861 e. For each cha │ │ │ │ │ +00011650: 7261 6374 6572 2c20 7468 6572 650a 2020 racter, there. │ │ │ │ │ +00011660: 2020 2069 7320 616e 2069 6e73 7461 6e63 is an instanc │ │ │ │ │ +00011670: 6520 6f66 2074 6865 2066 6f6c 6c6f 7769 e of the followi │ │ │ │ │ +00011680: 6e67 2065 6e74 7279 2073 7472 7563 7475 ng entry structu │ │ │ │ │ +00011690: 7265 3a0a 0a20 2020 2020 2020 202a 202a re:.. * * │ │ │ │ │ +000116a0: 556e 6963 6f64 6520 636f 6465 2070 6f69 Unicode code poi │ │ │ │ │ +000116b0: 6e74 2e2a 2020 2833 322d 6269 7420 6269 nt.* (32-bit bi │ │ │ │ │ +000116c0: 672d 656e 6469 616e 2069 6e74 6567 6572 g-endian integer │ │ │ │ │ +000116d0: 2e29 0a0a 2020 2020 2020 2020 2a20 2a53 .).. * *S │ │ │ │ │ +000116e0: 746f 7261 6765 2066 6c61 6773 2e2a 2020 torage flags.* │ │ │ │ │ +000116f0: 2862 7974 652e 290a 0a20 2020 2020 2020 (byte.).. │ │ │ │ │ +00011700: 2020 2020 2020 2a20 4269 7473 2032 2e2e * Bits 2.. │ │ │ │ │ +00011710: 303a 0a0a 2020 2020 2020 2020 2020 2020 0:.. │ │ │ │ │ +00011720: 2020 2049 6620 6571 7561 6c20 746f 2030 If equal to 0 │ │ │ │ │ +00011730: 3030 2062 696e 6172 792c 2074 6865 6e20 00 binary, then │ │ │ │ │ +00011740: 7468 6520 6368 6172 6163 7465 7220 6461 the character da │ │ │ │ │ +00011750: 7461 2069 7320 7374 6f72 6564 0a20 2020 ta is stored. │ │ │ │ │ +00011760: 2020 2020 2020 2020 2020 2020 756e 636f unco │ │ │ │ │ +00011770: 6d70 7265 7373 6564 2062 6567 696e 6e69 mpressed beginni │ │ │ │ │ +00011780: 6e67 2061 7420 7468 6520 6f66 6673 6574 ng at the offset │ │ │ │ │ +00011790: 2069 6e64 6963 6174 6564 2062 7920 7468 indicated by th │ │ │ │ │ +000117a0: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ +000117b0: 2063 6861 7261 6374 6572 2773 202a 6f66 character's *of │ │ │ │ │ +000117c0: 6673 6574 2a20 7661 6c75 652e 0a0a 2020 fset* value... │ │ │ │ │ +000117d0: 2020 2020 2020 2020 2020 2020 2049 6620 If │ │ │ │ │ +000117e0: 6571 7561 6c20 746f 2030 3031 2062 696e equal to 001 bin │ │ │ │ │ +000117f0: 6172 792c 2074 6865 6e20 7468 6520 6368 ary, then the ch │ │ │ │ │ +00011800: 6172 6163 7465 7220 6461 7461 2069 7320 aracter data is │ │ │ │ │ +00011810: 7374 6f72 6564 0a20 2020 2020 2020 2020 stored. │ │ │ │ │ +00011820: 2020 2020 2020 7769 7468 696e 2061 2063 within a c │ │ │ │ │ +00011830: 6f6d 7072 6573 7365 6420 6368 6172 6163 ompressed charac │ │ │ │ │ +00011840: 7465 7220 6465 6669 6e69 7469 6f6e 2062 ter definition b │ │ │ │ │ +00011850: 6c6f 636b 2074 6861 740a 2020 2020 2020 lock that. │ │ │ │ │ +00011860: 2020 2020 2020 2020 2062 6567 696e 7320 begins │ │ │ │ │ +00011870: 6174 2074 6865 206f 6666 7365 7420 7769 at the offset wi │ │ │ │ │ +00011880: 7468 696e 2074 6865 2066 696c 6520 696e thin the file in │ │ │ │ │ +00011890: 6469 6361 7465 6420 6279 2074 6865 0a20 dicated by the. │ │ │ │ │ +000118a0: 2020 2020 2020 2020 2020 2020 2020 6368 ch │ │ │ │ │ +000118b0: 6172 6163 7465 7227 7320 2a6f 6666 7365 aracter's *offse │ │ │ │ │ +000118c0: 742a 2076 616c 7565 2e0a 0a20 2020 2020 t* value... │ │ │ │ │ +000118d0: 2020 202a 202a 4f66 6673 6574 2e2a 2020 * *Offset.* │ │ │ │ │ +000118e0: 2833 322d 6269 7420 6269 672d 656e 6469 (32-bit big-endi │ │ │ │ │ +000118f0: 616e 2069 6e74 6567 6572 2e29 0a0a 2020 an integer.).. │ │ │ │ │ +00011900: 2020 2020 2020 2020 4120 6d61 726b 6572 A marker │ │ │ │ │ +00011910: 2074 6861 7420 696e 6469 6361 7465 7320 that indicates │ │ │ │ │ +00011920: 7468 6520 7265 6d61 696e 6465 7220 6f66 the remainder of │ │ │ │ │ +00011930: 2074 6865 2066 696c 6520 6973 2064 6174 the file is dat │ │ │ │ │ +00011940: 610a 2020 2020 2020 2020 2020 6163 6365 a. acce │ │ │ │ │ +00011950: 7373 6564 2076 6961 2074 6865 2063 6861 ssed via the cha │ │ │ │ │ +00011960: 7261 6374 6572 2069 6e64 6578 2028 4348 racter index (CH │ │ │ │ │ +00011970: 4958 2920 7365 6374 696f 6e2e 2020 5768 IX) section. Wh │ │ │ │ │ +00011980: 656e 2072 6561 6469 6e67 0a20 2020 2020 en reading. │ │ │ │ │ +00011990: 2020 2020 2074 6869 7320 666f 6e74 2066 this font f │ │ │ │ │ +000119a0: 696c 652c 2074 6865 2072 6573 7420 6f66 ile, the rest of │ │ │ │ │ +000119b0: 2074 6865 2066 696c 6520 6361 6e20 6265 the file can be │ │ │ │ │ +000119c0: 2069 676e 6f72 6564 2077 6865 6e0a 2020 ignored when. │ │ │ │ │ +000119d0: 2020 2020 2020 2020 7363 616e 6e69 6e67 scanning │ │ │ │ │ +000119e0: 2074 6865 2073 6563 7469 6f6e 732e 2020 the sections. │ │ │ │ │ +000119f0: 5468 6520 6c65 6e67 7468 2073 686f 756c The length shoul │ │ │ │ │ +00011a00: 6420 6265 2073 6574 2074 6f20 2d31 0a20 d be set to -1. │ │ │ │ │ +00011a10: 2020 2020 2020 2020 2028 3078 4646 4646 (0xFFFF │ │ │ │ │ +00011a20: 4646 4646 292e 0a0a 2020 2020 2020 2020 FFFF)... │ │ │ │ │ +00011a30: 2020 5375 7070 6f72 7465 6420 6461 7461 Supported data │ │ │ │ │ +00011a40: 2073 7472 7563 7475 7265 733a 0a0a 2020 structures:.. │ │ │ │ │ +00011a50: 2020 2020 2020 2020 4368 6172 6163 7465 Characte │ │ │ │ │ +00011a60: 7220 6465 6669 6e69 7469 6f6e 2045 6163 r definition Eac │ │ │ │ │ +00011a70: 6820 6368 6172 6163 7465 7220 6465 6669 h character defi │ │ │ │ │ +00011a80: 6e69 7469 6f6e 2063 6f6e 7369 7374 7320 nition consists │ │ │ │ │ +00011a90: 6f66 3a0a 0a20 2020 2020 2020 2020 2020 of:.. │ │ │ │ │ +00011aa0: 2020 2a20 2a57 6964 7468 2e2a 2020 5769 * *Width.* Wi │ │ │ │ │ +00011ab0: 6474 6820 6f66 2074 6865 2062 6974 6d61 dth of the bitma │ │ │ │ │ +00011ac0: 7020 696e 2070 6978 656c 732e 2020 5468 p in pixels. Th │ │ │ │ │ +00011ad0: 6520 6269 746d 6170 2773 0a20 2020 2020 e bitmap's. │ │ │ │ │ +00011ae0: 2020 2020 2020 2020 2020 6578 7465 6e74 extent │ │ │ │ │ +00011af0: 7320 7265 7072 6573 656e 7420 7468 6520 s represent the │ │ │ │ │ +00011b00: 676c 7970 6827 7320 626f 756e 6469 6e67 glyph's bounding │ │ │ │ │ +00011b10: 2062 6f78 2e20 2027 7569 6e74 3136 6265 box. 'uint16be │ │ │ │ │ +00011b20: 272e 0a0a 2020 2020 2020 2020 2020 2020 '... │ │ │ │ │ +00011b30: 202a 202a 4865 6967 6874 2e2a 2020 4865 * *Height.* He │ │ │ │ │ +00011b40: 6967 6874 206f 6620 7468 6520 6269 746d ight of the bitm │ │ │ │ │ +00011b50: 6170 2069 6e20 7069 7865 6c73 2e20 2054 ap in pixels. T │ │ │ │ │ +00011b60: 6865 2062 6974 6d61 7027 730a 2020 2020 he bitmap's. │ │ │ │ │ +00011b70: 2020 2020 2020 2020 2020 2065 7874 656e exten │ │ │ │ │ +00011b80: 7473 2072 6570 7265 7365 6e74 2074 6865 ts represent the │ │ │ │ │ +00011b90: 2067 6c79 7068 2773 2062 6f75 6e64 696e glyph's boundin │ │ │ │ │ +00011ba0: 6720 626f 782e 2020 2775 696e 7431 3662 g box. 'uint16b │ │ │ │ │ +00011bb0: 6527 2e0a 0a20 2020 2020 2020 2020 2020 e'... │ │ │ │ │ +00011bc0: 2020 2a20 2a58 206f 6666 7365 742e 2a20 * *X offset.* │ │ │ │ │ +00011bd0: 2054 6865 206e 756d 6265 7220 6f66 2070 The number of p │ │ │ │ │ +00011be0: 6978 656c 7320 746f 2073 6869 6674 2074 ixels to shift t │ │ │ │ │ +00011bf0: 6865 2062 6974 6d61 7020 6279 0a20 2020 he bitmap by. │ │ │ │ │ +00011c00: 2020 2020 2020 2020 2020 2020 686f 7269 hori │ │ │ │ │ +00011c10: 7a6f 6e74 616c 6c79 2062 6566 6f72 6520 zontally before │ │ │ │ │ +00011c20: 6472 6177 696e 6720 7468 6520 6368 6172 drawing the char │ │ │ │ │ +00011c30: 6163 7465 722e 2020 2769 6e74 3136 6265 acter. 'int16be │ │ │ │ │ +00011c40: 272e 0a0a 2020 2020 2020 2020 2020 2020 '... │ │ │ │ │ +00011c50: 202a 202a 5920 6f66 6673 6574 2e2a 2020 * *Y offset.* │ │ │ │ │ +00011c60: 5468 6520 6e75 6d62 6572 206f 6620 7069 The number of pi │ │ │ │ │ +00011c70: 7865 6c73 2074 6f20 7368 6966 7420 7468 xels to shift th │ │ │ │ │ +00011c80: 6520 6269 746d 6170 2062 790a 2020 2020 e bitmap by. │ │ │ │ │ +00011c90: 2020 2020 2020 2020 2020 2076 6572 7469 verti │ │ │ │ │ +00011ca0: 6361 6c6c 7920 6265 666f 7265 2064 7261 cally before dra │ │ │ │ │ +00011cb0: 7769 6e67 2074 6865 2063 6861 7261 6374 wing the charact │ │ │ │ │ +00011cc0: 6572 2e20 2027 696e 7431 3662 6527 2e0a er. 'int16be'.. │ │ │ │ │ +00011cd0: 0a20 2020 2020 2020 2020 2020 2020 2a20 . * │ │ │ │ │ +00011ce0: 2a44 6576 6963 6520 7769 6474 682e 2a20 *Device width.* │ │ │ │ │ +00011cf0: 2054 6865 206e 756d 6265 7220 6f66 2070 The number of p │ │ │ │ │ +00011d00: 6978 656c 7320 746f 2061 6476 616e 6365 ixels to advance │ │ │ │ │ +00011d10: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00011d20: 686f 7269 7a6f 6e74 616c 6c79 2066 726f horizontally fro │ │ │ │ │ +00011d30: 6d20 7468 6973 2063 6861 7261 6374 6572 m this character │ │ │ │ │ +00011d40: 2773 206f 7269 6769 6e20 746f 2074 6865 's origin to the │ │ │ │ │ +00011d50: 206f 7269 6769 6e0a 2020 2020 2020 2020 origin. │ │ │ │ │ +00011d60: 2020 2020 2020 206f 6620 7468 6520 6e65 of the ne │ │ │ │ │ +00011d70: 7874 2063 6861 7261 6374 6572 2e20 2027 xt character. ' │ │ │ │ │ +00011d80: 696e 7431 3662 6527 2e0a 0a20 2020 2020 int16be'... │ │ │ │ │ +00011d90: 2020 2020 2020 2020 2a20 2a42 6974 6d61 * *Bitma │ │ │ │ │ +00011da0: 7020 6461 7461 2e2a 2020 5468 6973 2069 p data.* This i │ │ │ │ │ +00011db0: 7320 656e 636f 6465 6420 6173 2061 2073 s encoded as a s │ │ │ │ │ +00011dc0: 7472 696e 6720 6f66 2062 6974 732e 2020 tring of bits. │ │ │ │ │ +00011dd0: 4974 0a20 2020 2020 2020 2020 2020 2020 It. │ │ │ │ │ +00011de0: 2020 6973 206f 7267 616e 697a 6564 2061 is organized a │ │ │ │ │ +00011df0: 7320 6120 726f 772d 6d61 6a6f 722c 2074 s a row-major, t │ │ │ │ │ +00011e00: 6f70 2d64 6f77 6e2c 206c 6566 742d 746f op-down, left-to │ │ │ │ │ +00011e10: 2d72 6967 6874 0a20 2020 2020 2020 2020 -right. │ │ │ │ │ +00011e20: 2020 2020 2020 6269 746d 6170 2e20 2054 bitmap. T │ │ │ │ │ +00011e30: 6865 206d 6f73 7420 7369 676e 6966 6963 he most signific │ │ │ │ │ +00011e40: 616e 7420 6269 7420 6f66 2065 6163 6820 ant bit of each │ │ │ │ │ +00011e50: 6279 7465 2069 7320 7461 6b65 6e0a 2020 byte is taken. │ │ │ │ │ +00011e60: 2020 2020 2020 2020 2020 2020 2074 6f20 to │ │ │ │ │ +00011e70: 6265 2074 6865 206c 6566 746d 6f73 7420 be the leftmost │ │ │ │ │ +00011e80: 6f72 2075 7070 6572 6d6f 7374 2062 6974 or uppermost bit │ │ │ │ │ +00011e90: 2069 6e20 7468 6520 6279 7465 2e20 2046 in the byte. F │ │ │ │ │ +00011ea0: 6f72 2074 6865 0a20 2020 2020 2020 2020 or the. │ │ │ │ │ +00011eb0: 2020 2020 2020 7361 6b65 206f 6620 636f sake of co │ │ │ │ │ +00011ec0: 6d70 6163 7420 7374 6f72 6167 652c 2072 mpact storage, r │ │ │ │ │ +00011ed0: 6f77 7320 6172 6520 6e6f 7420 7061 6464 ows are not padd │ │ │ │ │ +00011ee0: 6564 2074 6f20 6279 7465 0a20 2020 2020 ed to byte. │ │ │ │ │ +00011ef0: 2020 2020 2020 2020 2020 626f 756e 6461 bounda │ │ │ │ │ +00011f00: 7269 6573 2028 692e 652e 2c20 6120 7369 ries (i.e., a si │ │ │ │ │ +00011f10: 6e67 6c65 2062 7974 6520 6d61 7920 636f ngle byte may co │ │ │ │ │ +00011f20: 6e74 6169 6e20 6269 7473 0a20 2020 2020 ntain bits. │ │ │ │ │ +00011f30: 2020 2020 2020 2020 2020 6265 6c6f 6e67 belong │ │ │ │ │ +00011f40: 696e 6720 746f 206d 756c 7469 706c 6520 ing to multiple │ │ │ │ │ +00011f50: 726f 7773 292e 2020 5468 6520 6c61 7374 rows). The last │ │ │ │ │ +00011f60: 2062 7974 6520 6f66 2074 6865 2062 6974 byte of the bit │ │ │ │ │ +00011f70: 6d61 700a 2020 2020 2020 2020 2020 2020 map. │ │ │ │ │ +00011f80: 2020 202a 6973 2a20 7061 6464 6564 2077 *is* padded w │ │ │ │ │ +00011f90: 6974 6820 7a65 726f 2062 6974 7320 696e ith zero bits in │ │ │ │ │ +00011fa0: 2074 6865 2062 6974 7320 706f 7369 7469 the bits positi │ │ │ │ │ +00011fb0: 6f6e 7320 746f 2074 6865 0a20 2020 2020 ons to the. │ │ │ │ │ +00011fc0: 2020 2020 2020 2020 2020 7269 6768 7420 right │ │ │ │ │ +00011fd0: 6f66 2074 6865 206c 6173 7420 7573 6564 of the last used │ │ │ │ │ +00011fe0: 2062 6974 2069 6620 7468 6520 6269 746d bit if the bitm │ │ │ │ │ +00011ff0: 6170 2064 6174 6120 646f 6573 206e 6f74 ap data does not │ │ │ │ │ +00012000: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00012010: 6669 6c6c 2074 6865 206c 6173 7420 6279 fill the last by │ │ │ │ │ +00012020: 7465 2e0a 0a20 2020 2020 2020 2020 2020 te... │ │ │ │ │ +00012030: 2020 2020 5468 6520 6c65 6e67 7468 206f The length o │ │ │ │ │ +00012040: 6620 7468 6520 2a62 6974 6d61 7020 6461 f the *bitmap da │ │ │ │ │ +00012050: 7461 2a20 6669 656c 6420 6973 2028 5749 ta* field is (WI │ │ │ │ │ +00012060: 4454 4820 2a20 4845 4947 4854 0a20 2020 DTH * HEIGHT. │ │ │ │ │ +00012070: 2020 2020 2020 2020 2020 2020 2b20 3729 + 7) │ │ │ │ │ +00012080: 202f 2038 2075 7369 6e67 2069 6e74 6567 / 8 using integ │ │ │ │ │ +00012090: 6572 2061 7269 7468 6d65 7469 632c 2077 er arithmetic, w │ │ │ │ │ +000120a0: 6869 6368 2069 7320 6571 7569 7661 6c65 hich is equivale │ │ │ │ │ +000120b0: 6e74 2074 6f0a 2020 2020 2020 2020 2020 nt to. │ │ │ │ │ +000120c0: 2020 2020 2063 6569 6c28 5749 4454 4820 ceil(WIDTH │ │ │ │ │ +000120d0: 2a20 4845 4947 4854 202f 2038 2920 7573 * HEIGHT / 8) us │ │ │ │ │ +000120e0: 696e 6720 7265 616c 206e 756d 6265 7220 ing real number │ │ │ │ │ +000120f0: 6172 6974 686d 6574 6963 2e0a 0a20 2020 arithmetic... │ │ │ │ │ +00012100: 2020 2020 2020 2020 2020 2020 4974 2072 It r │ │ │ │ │ +00012110: 656d 6169 6e73 2074 6f20 6265 2064 6574 emains to be det │ │ │ │ │ +00012120: 6572 6d69 6e65 6420 7768 6574 6865 7220 ermined whether │ │ │ │ │ +00012130: 6269 746d 6170 2066 6f6e 7473 2075 7375 bitmap fonts usu │ │ │ │ │ +00012140: 616c 6c79 0a20 2020 2020 2020 2020 2020 ally. │ │ │ │ │ +00012150: 2020 2020 6d61 6b65 2061 6c6c 2067 6c79 make all gly │ │ │ │ │ +00012160: 7068 2062 6974 6d61 7073 2074 6865 2073 ph bitmaps the s │ │ │ │ │ +00012170: 616d 6520 6865 6967 6874 2c20 6f72 2069 ame height, or i │ │ │ │ │ +00012180: 6620 736d 616c 6c65 720a 2020 2020 2020 f smaller. │ │ │ │ │ +00012190: 2020 2020 2020 2020 2067 6c79 7068 7320 glyphs │ │ │ │ │ +000121a0: 6172 6520 7374 6f72 6564 2077 6974 6820 are stored with │ │ │ │ │ +000121b0: 6269 746d 6170 7320 6861 7669 6e67 2061 bitmaps having a │ │ │ │ │ +000121c0: 206c 6573 7365 7220 6865 6967 6874 2e0a lesser height.. │ │ │ │ │ +000121d0: 2020 2020 2020 2020 2020 2020 2020 2049 I │ │ │ │ │ +000121e0: 6e20 7468 6520 6c61 7474 6572 2063 6173 n the latter cas │ │ │ │ │ +000121f0: 652c 2074 6865 2062 6173 656c 696e 6520 e, the baseline │ │ │ │ │ +00012200: 776f 756c 6420 6861 7665 2074 6f20 6265 would have to be │ │ │ │ │ +00012210: 2075 7365 6420 746f 0a20 2020 2020 2020 used to. │ │ │ │ │ +00012220: 2020 2020 2020 2020 6361 6c63 756c 6174 calculat │ │ │ │ │ +00012230: 6520 7468 6520 6c6f 6361 7469 6f6e 2074 e the location t │ │ │ │ │ +00012240: 6865 2062 6974 6d61 7020 7368 6f75 6c64 he bitmap should │ │ │ │ │ +00012250: 2062 6520 616e 6368 6f72 6564 2061 740a be anchored at. │ │ │ │ │ +00012260: 2020 2020 2020 2020 2020 2020 2020 206f o │ │ │ │ │ +00012270: 6e20 7363 7265 656e 2e0a 0a1f 0a46 696c n screen.....Fil │ │ │ │ │ +00012280: 653a 2067 7275 622d 6465 762e 696e 666f e: grub-dev.info │ │ │ │ │ +00012290: 2c20 204e 6f64 653a 2046 6f6e 7420 4d65 , Node: Font Me │ │ │ │ │ +000122a0: 7472 6963 732c 2020 5072 6576 3a20 4669 trics, Prev: Fi │ │ │ │ │ +000122b0: 6c65 2053 7472 7563 7475 7265 2c20 2055 le Structure, U │ │ │ │ │ +000122c0: 703a 2050 4646 3220 466f 6e74 2046 696c p: PFF2 Font Fil │ │ │ │ │ +000122d0: 6520 466f 726d 6174 0a0a 3131 2e33 2046 e Format..11.3 F │ │ │ │ │ +000122e0: 6f6e 7420 4d65 7472 6963 730a 3d3d 3d3d ont Metrics.==== │ │ │ │ │ +000122f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a20 =============.. │ │ │ │ │ +00012300: 2020 2a20 4173 6365 6e74 2e20 2054 6865 * Ascent. The │ │ │ │ │ +00012310: 2064 6973 7461 6e63 6520 6672 6f6d 2074 distance from t │ │ │ │ │ +00012320: 6865 2062 6173 656c 696e 6520 746f 2074 he baseline to t │ │ │ │ │ +00012330: 6865 2074 6f70 206f 6620 6d6f 7374 0a20 he top of most. │ │ │ │ │ +00012340: 2020 2020 6368 6172 6163 7465 7273 2e20 characters. │ │ │ │ │ +00012350: 204e 6f74 6520 7468 6174 2069 6e20 736f Note that in so │ │ │ │ │ +00012360: 6d65 2063 6173 6573 2063 6861 7261 6374 me cases charact │ │ │ │ │ +00012370: 6572 7320 6d61 7920 6578 7465 6e64 2061 ers may extend a │ │ │ │ │ +00012380: 626f 7665 0a20 2020 2020 7468 6520 6173 bove. the as │ │ │ │ │ +00012390: 6365 6e74 2e0a 0a20 2020 2a20 4465 7363 cent... * Desc │ │ │ │ │ +000123a0: 656e 742e 2020 5468 6520 6469 7374 616e ent. The distan │ │ │ │ │ +000123b0: 6365 2066 726f 6d20 7468 6520 6261 7365 ce from the base │ │ │ │ │ +000123c0: 6c69 6e65 2074 6f20 7468 6520 626f 7474 line to the bott │ │ │ │ │ +000123d0: 6f6d 206f 6620 6d6f 7374 0a20 2020 2020 om of most. │ │ │ │ │ +000123e0: 6368 6172 6163 7465 7273 2e20 204e 6f74 characters. Not │ │ │ │ │ +000123f0: 6520 7468 6174 2069 6e20 736f 6d65 2063 e that in some c │ │ │ │ │ +00012400: 6173 6573 2063 6861 7261 6374 6572 7320 ases characters │ │ │ │ │ +00012410: 6d61 7920 6578 7465 6e64 2062 656c 6f77 may extend below │ │ │ │ │ +00012420: 0a20 2020 2020 7468 6520 6465 7363 656e . the descen │ │ │ │ │ +00012430: 742e 0a0a 2020 202a 204c 6561 6469 6e67 t... * Leading │ │ │ │ │ +00012440: 2e20 2054 6865 2061 6d6f 756e 7420 6f66 . The amount of │ │ │ │ │ +00012450: 2073 7061 6365 2c20 696e 2070 6978 656c space, in pixel │ │ │ │ │ +00012460: 732c 2074 6f20 6c65 6176 6520 6265 7477 s, to leave betw │ │ │ │ │ +00012470: 6565 6e20 7468 650a 2020 2020 2064 6573 een the. des │ │ │ │ │ +00012480: 6365 6e74 206f 6620 6f6e 6520 6c69 6e65 cent of one line │ │ │ │ │ +00012490: 206f 6620 7465 7874 2061 6e64 2074 6865 of text and the │ │ │ │ │ +000124a0: 2061 7363 656e 7420 6f66 2074 6865 206e ascent of the n │ │ │ │ │ +000124b0: 6578 7420 6c69 6e65 2e20 2054 6869 730a ext line. This. │ │ │ │ │ +000124c0: 2020 2020 206d 6574 7269 6373 2069 7320 metrics is │ │ │ │ │ +000124d0: 6e6f 7420 7370 6563 6966 6965 6420 696e not specified in │ │ │ │ │ +000124e0: 2074 6865 2063 7572 7265 6e74 2066 696c the current fil │ │ │ │ │ +000124f0: 6520 666f 726d 6174 3b20 696e 7374 6561 e format; instea │ │ │ │ │ +00012500: 642c 2074 6865 0a20 2020 2020 666f 6e74 d, the. font │ │ │ │ │ +00012510: 2072 656e 6465 7269 6e67 2065 6e67 696e rendering engin │ │ │ │ │ +00012520: 6520 6361 6c63 756c 6174 6573 2061 2072 e calculates a r │ │ │ │ │ +00012530: 6561 736f 6e61 626c 6520 6c65 6164 696e easonable leadin │ │ │ │ │ +00012540: 6720 7661 6c75 6520 6261 7365 640a 2020 g value based. │ │ │ │ │ +00012550: 2020 206f 6e20 7468 6520 6f74 6865 7220 on the other │ │ │ │ │ +00012560: 666f 6e74 206d 6574 7269 6373 2e0a 0a20 font metrics... │ │ │ │ │ +00012570: 2020 2a20 486f 7269 7a6f 6e61 6c20 6c65 * Horizonal le │ │ │ │ │ +00012580: 6164 696e 672e 2020 5468 6520 616d 6f75 ading. The amou │ │ │ │ │ +00012590: 6e74 206f 6620 7370 6163 652c 2069 6e20 nt of space, in │ │ │ │ │ +000125a0: 7069 7865 6c73 2c20 746f 206c 6561 7665 pixels, to leave │ │ │ │ │ +000125b0: 0a20 2020 2020 686f 7269 7a6f 6e74 616c . horizontal │ │ │ │ │ +000125c0: 6c79 2062 6574 7765 656e 2074 6865 206c ly between the l │ │ │ │ │ +000125d0: 6566 7420 616e 6420 7269 6768 7420 6564 eft and right ed │ │ │ │ │ +000125e0: 6765 7320 6f66 2074 776f 2061 646a 6163 ges of two adjac │ │ │ │ │ +000125f0: 656e 740a 2020 2020 2067 6c79 7068 732e ent. glyphs. │ │ │ │ │ +00012600: 2020 5468 6520 2a64 6576 6963 6520 7769 The *device wi │ │ │ │ │ +00012610: 6474 682a 2066 6965 6c64 2064 6574 6572 dth* field deter │ │ │ │ │ +00012620: 6d69 6e65 7320 7468 6520 6566 6665 6374 mines the effect │ │ │ │ │ +00012630: 6976 6520 6c65 6164 696e 670a 2020 2020 ive leading. │ │ │ │ │ +00012640: 2076 616c 7565 2074 6861 7420 6973 2075 value that is u │ │ │ │ │ +00012650: 7365 6420 746f 2072 656e 6465 7220 7468 sed to render th │ │ │ │ │ +00012660: 6520 666f 6e74 2e0a 0a00 085b 696d 6167 e font.....[imag │ │ │ │ │ +00012670: 6520 7372 633d 2266 6f6e 745f 6368 6172 e src="font_char │ │ │ │ │ +00012680: 5f6d 6574 7269 6373 2e70 6e67 2220 7465 _metrics.png" te │ │ │ │ │ +00012690: 7874 3d22 506c 6561 7365 2066 696c 6c20 xt="Please fill │ │ │ │ │ +000126a0: 7468 6973 2069 6e2e 2200 085d 0a0a 0a20 this in."..]... │ │ │ │ │ +000126b0: 2020 416e 2069 6c6c 7573 7472 6174 696f An illustratio │ │ │ │ │ +000126c0: 6e20 6f66 2068 6f77 2074 6865 2076 6172 n of how the var │ │ │ │ │ +000126d0: 696f 7573 2066 6f6e 7420 6d65 7472 6963 ious font metric │ │ │ │ │ +000126e0: 7320 6170 706c 7920 746f 2063 6861 7261 s apply to chara │ │ │ │ │ +000126f0: 6374 6572 732e 0a0a 1f0a 4669 6c65 3a20 cters.....File: │ │ │ │ │ +00012700: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ +00012710: 4e6f 6465 3a20 4772 6170 6869 6361 6c20 Node: Graphical │ │ │ │ │ +00012720: 4d65 6e75 2053 6f66 7477 6172 6520 4465 Menu Software De │ │ │ │ │ +00012730: 7369 676e 2c20 204e 6578 743a 2056 6572 sign, Next: Ver │ │ │ │ │ +00012740: 6966 6965 7273 2066 7261 6d65 776f 726b ifiers framework │ │ │ │ │ +00012750: 2c20 2050 7265 763a 2050 4646 3220 466f , Prev: PFF2 Fo │ │ │ │ │ +00012760: 6e74 2046 696c 6520 466f 726d 6174 2c20 nt File Format, │ │ │ │ │ +00012770: 2055 703a 2054 6f70 0a0a 3132 2047 7261 Up: Top..12 Gra │ │ │ │ │ +00012780: 7068 6963 616c 204d 656e 7520 536f 6674 phical Menu Soft │ │ │ │ │ +00012790: 7761 7265 2044 6573 6967 6e0a 2a2a 2a2a ware Design.**** │ │ │ │ │ 000127a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000127b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a 204d ***********..* M │ │ │ │ │ -000127c0: 656e 753a 0a0a 2a20 496e 7472 6f64 7563 enu:..* Introduc │ │ │ │ │ -000127d0: 7469 6f6e 5f32 3a3a 0a2a 2053 7461 7274 tion_2::.* Start │ │ │ │ │ -000127e0: 7570 2053 6571 7565 6e63 653a 3a0a 2a20 up Sequence::.* │ │ │ │ │ -000127f0: 4755 4920 436f 6d70 6f6e 656e 7473 3a3a GUI Components:: │ │ │ │ │ -00012800: 0a2a 2043 6f6d 6d61 6e64 204c 696e 6520 .* Command Line │ │ │ │ │ -00012810: 5769 6e64 6f77 3a3a 0a0a 1f0a 4669 6c65 Window::....File │ │ │ │ │ -00012820: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ -00012830: 2020 4e6f 6465 3a20 496e 7472 6f64 7563 Node: Introduc │ │ │ │ │ -00012840: 7469 6f6e 5f32 2c20 204e 6578 743a 2053 tion_2, Next: S │ │ │ │ │ -00012850: 7461 7274 7570 2053 6571 7565 6e63 652c tartup Sequence, │ │ │ │ │ -00012860: 2020 5570 3a20 4772 6170 6869 6361 6c20 Up: Graphical │ │ │ │ │ -00012870: 4d65 6e75 2053 6f66 7477 6172 6520 4465 Menu Software De │ │ │ │ │ -00012880: 7369 676e 0a0a 3132 2e31 2049 6e74 726f sign..12.1 Intro │ │ │ │ │ -00012890: 6475 6374 696f 6e0a 3d3d 3d3d 3d3d 3d3d duction.======== │ │ │ │ │ -000128a0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 2027 =========..The ' │ │ │ │ │ -000128b0: 6766 786d 656e 7527 206d 6f64 756c 6520 gfxmenu' module │ │ │ │ │ -000128c0: 7072 6f76 6964 6573 2061 2067 7261 7068 provides a graph │ │ │ │ │ -000128d0: 6963 616c 206d 656e 7520 696e 7465 7266 ical menu interf │ │ │ │ │ -000128e0: 6163 6520 666f 7220 4752 5542 2032 2e20 ace for GRUB 2. │ │ │ │ │ -000128f0: 2049 740a 6675 6e63 7469 6f6e 7320 6173 It.functions as │ │ │ │ │ -00012900: 2061 6e20 616c 7465 726e 6174 6976 6520 an alternative │ │ │ │ │ -00012910: 746f 2074 6865 206d 656e 7520 696e 7465 to the menu inte │ │ │ │ │ -00012920: 7266 6163 6520 7072 6f76 6964 6564 2062 rface provided b │ │ │ │ │ -00012930: 7920 7468 650a 276e 6f72 6d61 6c27 206d y the.'normal' m │ │ │ │ │ -00012940: 6f64 756c 652c 2077 6869 6368 2075 7365 odule, which use │ │ │ │ │ -00012950: 7320 7468 6520 6772 7562 2074 6572 6d69 s the grub termi │ │ │ │ │ -00012960: 6e61 6c20 696e 7465 7266 6163 6520 746f nal interface to │ │ │ │ │ -00012970: 2064 6973 706c 6179 2061 0a6d 656e 7520 display a.menu │ │ │ │ │ -00012980: 6f6e 2061 2063 6861 7261 6374 6572 2d6f on a character-o │ │ │ │ │ -00012990: 7269 656e 7465 6420 7465 726d 696e 616c riented terminal │ │ │ │ │ -000129a0: 2e0a 0a20 2020 5468 6520 6772 6170 6869 ... The graphi │ │ │ │ │ -000129b0: 6361 6c20 6d65 6e75 2075 7365 7320 7468 cal menu uses th │ │ │ │ │ -000129c0: 6520 4752 5542 2076 6964 656f 2041 5049 e GRUB video API │ │ │ │ │ -000129d0: 2c20 7768 6963 6820 6973 2063 7572 7265 , which is curre │ │ │ │ │ -000129e0: 6e74 6c79 2066 6f72 0a74 6865 2056 4553 ntly for.the VES │ │ │ │ │ -000129f0: 4120 4249 4f53 2065 7874 656e 7369 6f6e A BIOS extension │ │ │ │ │ -00012a00: 7320 2856 4245 2920 322e 302b 2e20 2054 s (VBE) 2.0+. T │ │ │ │ │ -00012a10: 6869 7320 6973 2073 7570 706f 7274 6564 his is supported │ │ │ │ │ -00012a20: 206f 6e20 7468 6520 6933 3836 2d70 630a on the i386-pc. │ │ │ │ │ -00012a30: 706c 6174 666f 726d 2e20 2048 6f77 6576 platform. Howev │ │ │ │ │ -00012a40: 6572 2c20 7468 6520 6772 6170 6869 6361 er, the graphica │ │ │ │ │ -00012a50: 6c20 6d65 6e75 2069 7473 656c 6620 646f l menu itself do │ │ │ │ │ -00012a60: 6573 206e 6f74 2064 6570 656e 6420 6f6e es not depend on │ │ │ │ │ -00012a70: 2075 7369 6e67 0a56 4245 2c20 736f 2069 using.VBE, so i │ │ │ │ │ -00012a80: 6620 616e 6f74 6865 7220 4752 5542 2076 f another GRUB v │ │ │ │ │ -00012a90: 6964 656f 2064 7269 7665 7220 7765 7265 ideo driver were │ │ │ │ │ -00012aa0: 2069 6d70 6c65 6d65 6e74 6564 2c20 7468 implemented, th │ │ │ │ │ -00012ab0: 6520 2767 6678 6d65 6e75 270a 6772 6170 e 'gfxmenu'.grap │ │ │ │ │ -00012ac0: 6869 6361 6c20 6d65 6e75 2077 6f75 6c64 hical menu would │ │ │ │ │ -00012ad0: 2077 6f72 6b20 6f6e 2074 6865 206e 6577 work on the new │ │ │ │ │ -00012ae0: 2076 6964 656f 2064 7269 7665 7220 6173 video driver as │ │ │ │ │ -00012af0: 2077 656c 6c2e 0a0a 1f0a 4669 6c65 3a20 well.....File: │ │ │ │ │ -00012b00: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ -00012b10: 4e6f 6465 3a20 5374 6172 7475 7020 5365 Node: Startup Se │ │ │ │ │ -00012b20: 7175 656e 6365 2c20 204e 6578 743a 2047 quence, Next: G │ │ │ │ │ -00012b30: 5549 2043 6f6d 706f 6e65 6e74 732c 2020 UI Components, │ │ │ │ │ -00012b40: 5072 6576 3a20 496e 7472 6f64 7563 7469 Prev: Introducti │ │ │ │ │ -00012b50: 6f6e 5f32 2c20 2055 703a 2047 7261 7068 on_2, Up: Graph │ │ │ │ │ -00012b60: 6963 616c 204d 656e 7520 536f 6674 7761 ical Menu Softwa │ │ │ │ │ -00012b70: 7265 2044 6573 6967 6e0a 0a31 322e 3220 re Design..12.2 │ │ │ │ │ -00012b80: 5374 6172 7475 7020 5365 7175 656e 6365 Startup Sequence │ │ │ │ │ -00012b90: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ -00012ba0: 3d3d 3d3d 3d3d 0a0a 2020 202a 2067 7275 ======.. * gru │ │ │ │ │ -00012bb0: 625f 656e 7465 725f 6e6f 726d 616c 5f6d b_enter_normal_m │ │ │ │ │ -00012bc0: 6f64 6520 5b6e 6f72 6d61 6c2f 6d61 696e ode [normal/main │ │ │ │ │ -00012bd0: 2e63 5d0a 2020 202a 2067 7275 625f 6e6f .c]. * grub_no │ │ │ │ │ -00012be0: 726d 616c 5f65 7865 6375 7465 205b 6e6f rmal_execute [no │ │ │ │ │ -00012bf0: 726d 616c 2f6d 6169 6e2e 635d 0a20 2020 rmal/main.c]. │ │ │ │ │ -00012c00: 2a20 7265 6164 5f63 6f6e 6669 675f 6669 * read_config_fi │ │ │ │ │ -00012c10: 6c65 205b 6e6f 726d 616c 2f6d 6169 6e2e le [normal/main. │ │ │ │ │ -00012c20: 635d 0a20 2020 2a20 2857 6865 6e20 2767 c]. * (When 'g │ │ │ │ │ -00012c30: 6678 6d65 6e75 2e6d 6f64 2720 6973 206c fxmenu.mod' is l │ │ │ │ │ -00012c40: 6f61 6465 6420 7769 7468 2027 696e 736d oaded with 'insm │ │ │ │ │ -00012c50: 6f64 272c 2069 7420 7769 6c6c 2063 616c od', it will cal │ │ │ │ │ -00012c60: 6c0a 2020 2020 2027 6772 7562 5f6d 656e l. 'grub_men │ │ │ │ │ -00012c70: 755f 7669 6577 6572 5f72 6567 6973 7465 u_viewer_registe │ │ │ │ │ -00012c80: 7228 2927 2074 6f20 7265 6769 7374 6572 r()' to register │ │ │ │ │ -00012c90: 2069 7473 656c 662e 290a 2020 202a 2047 itself.). * G │ │ │ │ │ -00012ca0: 5255 425f 4d4f 445f 494e 4954 2028 6766 RUB_MOD_INIT (gf │ │ │ │ │ -00012cb0: 786d 656e 7529 205b 6766 786d 656e 752f xmenu) [gfxmenu/ │ │ │ │ │ -00012cc0: 6766 786d 656e 752e 635d 0a20 2020 2a20 gfxmenu.c]. * │ │ │ │ │ -00012cd0: 6772 7562 5f6d 656e 755f 7669 6577 6572 grub_menu_viewer │ │ │ │ │ -00012ce0: 5f72 6567 6973 7465 7220 5b6b 6572 6e2f _register [kern/ │ │ │ │ │ -00012cf0: 6d65 6e75 5f76 6965 7765 722e 635d 0a20 menu_viewer.c]. │ │ │ │ │ -00012d00: 2020 2a20 6772 7562 5f6d 656e 755f 7669 * grub_menu_vi │ │ │ │ │ -00012d10: 6577 6572 5f73 686f 775f 6d65 6e75 205b ewer_show_menu [ │ │ │ │ │ -00012d20: 6b65 726e 2f6d 656e 755f 7669 6577 6572 kern/menu_viewer │ │ │ │ │ -00012d30: 2e63 5d0a 2020 202a 2067 6574 5f63 7572 .c]. * get_cur │ │ │ │ │ -00012d40: 7265 6e74 5f6d 656e 755f 7669 6577 6572 rent_menu_viewer │ │ │ │ │ -00012d50: 2829 205b 6b65 726e 2f6d 656e 755f 7669 () [kern/menu_vi │ │ │ │ │ -00012d60: 6577 6572 2e63 5d0a 2020 202a 2073 686f ewer.c]. * sho │ │ │ │ │ -00012d70: 775f 6d65 6e75 2829 205b 6766 786d 656e w_menu() [gfxmen │ │ │ │ │ -00012d80: 752f 6766 786d 656e 752e 635d 0a20 2020 u/gfxmenu.c]. │ │ │ │ │ -00012d90: 2a20 6772 7562 5f67 6678 6d65 6e75 5f6d * grub_gfxmenu_m │ │ │ │ │ -00012da0: 6f64 656c 5f6e 6577 205b 6766 786d 656e odel_new [gfxmen │ │ │ │ │ -00012db0: 752f 6d6f 6465 6c2e 635d 0a20 2020 2a20 u/model.c]. * │ │ │ │ │ -00012dc0: 6772 7562 5f67 6678 6d65 6e75 5f76 6965 grub_gfxmenu_vie │ │ │ │ │ -00012dd0: 775f 6e65 7720 5b67 6678 6d65 6e75 2f76 w_new [gfxmenu/v │ │ │ │ │ -00012de0: 6965 772e 635d 0a20 2020 2a20 7365 745f iew.c]. * set_ │ │ │ │ │ -00012df0: 6772 6170 6869 6373 5f6d 6f64 6520 5b67 graphics_mode [g │ │ │ │ │ -00012e00: 6678 6d65 6e75 2f76 6965 772e 635d 0a20 fxmenu/view.c]. │ │ │ │ │ -00012e10: 2020 2a20 6772 7562 5f67 6678 6d65 6e75 * grub_gfxmenu │ │ │ │ │ -00012e20: 5f76 6965 775f 6c6f 6164 5f74 6865 6d65 _view_load_theme │ │ │ │ │ -00012e30: 205b 6766 786d 656e 752f 7468 656d 655f [gfxmenu/theme_ │ │ │ │ │ -00012e40: 6c6f 6164 6572 2e63 5d0a 0a1f 0a46 696c loader.c]....Fil │ │ │ │ │ -00012e50: 653a 2067 7275 622d 6465 762e 696e 666f e: grub-dev.info │ │ │ │ │ -00012e60: 2c20 204e 6f64 653a 2047 5549 2043 6f6d , Node: GUI Com │ │ │ │ │ -00012e70: 706f 6e65 6e74 732c 2020 4e65 7874 3a20 ponents, Next: │ │ │ │ │ -00012e80: 436f 6d6d 616e 6420 4c69 6e65 2057 696e Command Line Win │ │ │ │ │ -00012e90: 646f 772c 2020 5072 6576 3a20 5374 6172 dow, Prev: Star │ │ │ │ │ -00012ea0: 7475 7020 5365 7175 656e 6365 2c20 2055 tup Sequence, U │ │ │ │ │ -00012eb0: 703a 2047 7261 7068 6963 616c 204d 656e p: Graphical Men │ │ │ │ │ -00012ec0: 7520 536f 6674 7761 7265 2044 6573 6967 u Software Desig │ │ │ │ │ -00012ed0: 6e0a 0a31 322e 3320 4755 4920 436f 6d70 n..12.3 GUI Comp │ │ │ │ │ -00012ee0: 6f6e 656e 7473 0a3d 3d3d 3d3d 3d3d 3d3d onents.========= │ │ │ │ │ -00012ef0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ │ -00012f00: 6772 6170 6869 6361 6c20 6d65 6e75 2069 graphical menu i │ │ │ │ │ -00012f10: 6d70 6c65 6d65 6e74 7320 6120 4755 4920 mplements a GUI │ │ │ │ │ -00012f20: 636f 6d70 6f6e 656e 7420 7379 7374 656d component system │ │ │ │ │ -00012f30: 2074 6861 7420 7375 7070 6f72 7473 2061 that supports a │ │ │ │ │ -00012f40: 0a63 6f6e 7461 696e 6572 2d62 6173 6564 .container-based │ │ │ │ │ -00012f50: 206c 6179 6f75 7420 7379 7374 656d 2e20 layout system. │ │ │ │ │ -00012f60: 2043 6f6d 706f 6e65 6e74 7320 6361 6e20 Components can │ │ │ │ │ -00012f70: 6265 2061 6464 6564 2074 6f20 636f 6e74 be added to cont │ │ │ │ │ -00012f80: 6169 6e65 7273 2c0a 616e 6420 636f 6e74 ainers,.and cont │ │ │ │ │ -00012f90: 6169 6e65 7273 2028 7768 6963 6820 6172 ainers (which ar │ │ │ │ │ -00012fa0: 6520 6120 7479 7065 206f 6620 636f 6d70 e a type of comp │ │ │ │ │ -00012fb0: 6f6e 656e 7429 2063 616e 2074 6865 6e20 onent) can then │ │ │ │ │ -00012fc0: 6265 2061 6464 6564 2074 6f0a 6f74 6865 be added to.othe │ │ │ │ │ -00012fd0: 7220 636f 6e74 6169 6e65 7273 2c20 746f r containers, to │ │ │ │ │ -00012fe0: 2066 6f72 6d20 6120 7472 6565 206f 6620 form a tree of │ │ │ │ │ -00012ff0: 636f 6d70 6f6e 656e 7473 2e20 2043 7572 components. Cur │ │ │ │ │ -00013000: 7265 6e74 6c79 2c20 7468 6520 726f 6f74 rently, the root │ │ │ │ │ -00013010: 0a63 6f6d 706f 6e65 6e74 206f 6620 7468 .component of th │ │ │ │ │ -00013020: 6973 2074 7265 6520 6973 2061 2027 6361 is tree is a 'ca │ │ │ │ │ -00013030: 6e76 6173 2720 636f 6d70 6f6e 656e 742c nvas' component, │ │ │ │ │ -00013040: 2077 6869 6368 2061 6c6c 6f77 7320 6d61 which allows ma │ │ │ │ │ -00013050: 6e75 616c 0a6c 6179 6f75 7420 6f66 2069 nual.layout of i │ │ │ │ │ -00013060: 7473 2063 6869 6c64 2063 6f6d 706f 6e65 ts child compone │ │ │ │ │ -00013070: 6e74 732e 0a0a 2020 2043 6f6d 706f 6e65 nts... Compone │ │ │ │ │ -00013080: 6e74 7320 286e 6f6e 2d63 6f6e 7461 696e nts (non-contain │ │ │ │ │ -00013090: 6572 293a 0a0a 2020 202a 206c 6162 656c er):.. * label │ │ │ │ │ -000130a0: 0a20 2020 2a20 696d 6167 650a 2020 202a . * image. * │ │ │ │ │ -000130b0: 2070 726f 6772 6573 735f 6261 720a 2020 progress_bar. │ │ │ │ │ -000130c0: 202a 2063 6972 6375 6c61 725f 7072 6f67 * circular_prog │ │ │ │ │ -000130d0: 7265 7373 0a20 2020 2a20 6c69 7374 2028 ress. * list ( │ │ │ │ │ -000130e0: 6375 7272 656e 746c 7920 6861 7264 2063 currently hard c │ │ │ │ │ -000130f0: 6f64 6564 2074 6f20 6265 2061 2062 6f6f oded to be a boo │ │ │ │ │ -00013100: 7420 6d65 6e75 206c 6973 7429 0a0a 2020 t menu list).. │ │ │ │ │ -00013110: 2043 6f6e 7461 696e 6572 733a 0a0a 2020 Containers:.. │ │ │ │ │ -00013120: 202a 2063 616e 7661 730a 2020 202a 2068 * canvas. * h │ │ │ │ │ -00013130: 626f 780a 2020 202a 2076 626f 780a 0a20 box. * vbox.. │ │ │ │ │ -00013140: 2020 5468 6520 4755 4920 636f 6d70 6f6e The GUI compon │ │ │ │ │ -00013150: 656e 7420 696e 7374 616e 6365 7320 6172 ent instances ar │ │ │ │ │ -00013160: 6520 6372 6561 7465 6420 6279 2074 6865 e created by the │ │ │ │ │ -00013170: 2074 6865 6d65 206c 6f61 6465 7220 696e theme loader in │ │ │ │ │ -00013180: 0a27 6766 786d 656e 752f 7468 656d 655f .'gfxmenu/theme_ │ │ │ │ │ -00013190: 6c6f 6164 6572 2e63 2720 7768 656e 2061 loader.c' when a │ │ │ │ │ -000131a0: 2074 6865 6d65 2069 7320 6c6f 6164 6564 theme is loaded │ │ │ │ │ -000131b0: 2e20 2054 6865 6d65 2066 696c 6573 2073 . Theme files s │ │ │ │ │ -000131c0: 7065 6369 6679 0a73 7461 7465 6d65 6e74 pecify.statement │ │ │ │ │ -000131d0: 7320 7375 6368 2061 7320 272b 7662 6f78 s such as '+vbox │ │ │ │ │ -000131e0: 7b20 2b6c 6162 656c 207b 2074 6578 743d { +label { text= │ │ │ │ │ -000131f0: 2248 656c 6c6f 2220 7d20 2b6c 6162 656c "Hello" } +label │ │ │ │ │ -00013200: 7b20 7465 7874 3d22 576f 726c 6422 0a7d { text="World".} │ │ │ │ │ -00013210: 207d 2720 746f 2061 6464 2063 6f6d 706f }' to add compo │ │ │ │ │ -00013220: 6e65 6e74 7320 746f 2074 6865 2063 6f6d nents to the com │ │ │ │ │ -00013230: 706f 6e65 6e74 2074 7265 6520 726f 6f74 ponent tree root │ │ │ │ │ -00013240: 2e20 2042 7920 6e65 7374 696e 6720 7468 . By nesting th │ │ │ │ │ -00013250: 650a 636f 6d70 6f6e 656e 7420 6372 6561 e.component crea │ │ │ │ │ -00013260: 7469 6f6e 2073 7461 7465 6d65 6e74 7320 tion statements │ │ │ │ │ -00013270: 696e 2074 6865 2074 6865 6d65 2066 696c in the theme fil │ │ │ │ │ -00013280: 652c 2074 6865 2069 6e73 7461 6e74 6961 e, the instantia │ │ │ │ │ -00013290: 7465 640a 636f 6d70 6f6e 656e 7473 2061 ted.components a │ │ │ │ │ -000132a0: 7265 206e 6573 7465 6420 7468 6520 7361 re nested the sa │ │ │ │ │ -000132b0: 6d65 2077 6179 2e0a 0a20 2020 5768 656e me way... When │ │ │ │ │ -000132c0: 2061 2063 6f6d 706f 6e65 6e74 2069 7320 a component is │ │ │ │ │ -000132d0: 6164 6465 6420 746f 2061 2063 6f6e 7461 added to a conta │ │ │ │ │ -000132e0: 696e 6572 2c20 7468 6174 206e 6577 2063 iner, that new c │ │ │ │ │ -000132f0: 6869 6c64 2069 730a 636f 6e73 6964 6572 hild is.consider │ │ │ │ │ -00013300: 6564 202a 6f77 6e65 642a 2062 7920 7468 ed *owned* by th │ │ │ │ │ -00013310: 6520 636f 6e74 6169 6e65 722e 2020 4772 e container. Gr │ │ │ │ │ -00013320: 6561 7420 6361 7265 2073 686f 756c 6420 eat care should │ │ │ │ │ -00013330: 6265 2074 616b 656e 2069 6620 7468 650a be taken if the. │ │ │ │ │ -00013340: 6361 6c6c 6572 2072 6574 6169 6e73 2061 caller retains a │ │ │ │ │ -00013350: 2072 6566 6572 656e 6365 2074 6f20 7468 reference to th │ │ │ │ │ -00013360: 6520 6368 696c 6420 636f 6d70 6f6e 656e e child componen │ │ │ │ │ -00013370: 742c 2073 696e 6365 2069 7420 7769 6c6c t, since it will │ │ │ │ │ -00013380: 2062 650a 6465 7374 726f 7965 6420 6966 be.destroyed if │ │ │ │ │ -00013390: 2069 7473 2070 6172 656e 7420 636f 6e74 its parent cont │ │ │ │ │ -000133a0: 6169 6e65 7220 6973 2064 6573 7472 6f79 ainer is destroy │ │ │ │ │ -000133b0: 6564 2e20 2041 2062 6574 7465 7220 6368 ed. A better ch │ │ │ │ │ -000133c0: 6f69 6365 2069 6e73 7465 6164 0a6f 6620 oice instead.of │ │ │ │ │ -000133d0: 7374 6f72 696e 6720 6120 706f 696e 7465 storing a pointe │ │ │ │ │ -000133e0: 7220 746f 2074 6865 2063 6869 6c64 2063 r to the child c │ │ │ │ │ -000133f0: 6f6d 706f 6e65 6e74 2069 7320 746f 2075 omponent is to u │ │ │ │ │ -00013400: 7365 2074 6865 2063 6f6d 706f 6e65 6e74 se the component │ │ │ │ │ -00013410: 2049 440a 746f 2066 696e 6420 7468 6520 ID.to find the │ │ │ │ │ -00013420: 6465 7369 7265 6420 636f 6d70 6f6e 656e desired componen │ │ │ │ │ -00013430: 742e 2020 436f 6d70 6f6e 656e 7420 4944 t. Component ID │ │ │ │ │ -00013440: 7320 646f 206e 6f74 2068 6176 6520 746f s do not have to │ │ │ │ │ -00013450: 2062 6520 756e 6971 7565 0a28 6974 2069 be unique.(it i │ │ │ │ │ -00013460: 7320 6f66 7465 6e20 7573 6566 756c 2074 s often useful t │ │ │ │ │ -00013470: 6f20 6861 7665 206d 756c 7469 706c 6520 o have multiple │ │ │ │ │ -00013480: 636f 6d70 6f6e 656e 7473 2077 6974 6820 components with │ │ │ │ │ -00013490: 616e 2049 4420 6f66 0a22 5f5f 7469 6d65 an ID of."__time │ │ │ │ │ -000134a0: 6f75 745f 5f22 2c20 666f 7220 696e 7374 out__", for inst │ │ │ │ │ -000134b0: 616e 6365 292e 0a0a 2020 2049 6e20 6f72 ance)... In or │ │ │ │ │ -000134c0: 6465 7220 746f 2061 6363 6573 7320 616e der to access an │ │ │ │ │ -000134d0: 6420 7573 6520 636f 6d70 6f6e 656e 7473 d use components │ │ │ │ │ -000134e0: 2069 6e20 7468 6520 636f 6d70 6f6e 656e in the componen │ │ │ │ │ -000134f0: 7420 7472 6565 2c20 7468 6572 650a 6172 t tree, there.ar │ │ │ │ │ -00013500: 6520 7477 6f20 6675 6e63 7469 6f6e 7320 e two functions │ │ │ │ │ -00013510: 2864 6566 696e 6564 2069 6e20 2767 6678 (defined in 'gfx │ │ │ │ │ -00013520: 6d65 6e75 2f67 7569 5f75 7469 6c2e 6327 menu/gui_util.c' │ │ │ │ │ -00013530: 2920 7468 6174 2061 7265 0a70 6172 7469 ) that are.parti │ │ │ │ │ -00013540: 6375 6c61 726c 7920 7573 6566 756c 3a0a cularly useful:. │ │ │ │ │ -00013550: 0a20 2020 2a20 2767 7275 625f 6775 695f . * 'grub_gui_ │ │ │ │ │ -00013560: 6669 6e64 5f62 795f 6964 2028 726f 6f74 find_by_id (root │ │ │ │ │ -00013570: 2c20 6964 2c20 6361 6c6c 6261 636b 2c20 , id, callback, │ │ │ │ │ -00013580: 7573 6572 6461 7461 2927 3a0a 0a20 2020 userdata)':.. │ │ │ │ │ -00013590: 2020 5468 6973 2066 756e 6374 696f 6e20 This function │ │ │ │ │ -000135a0: 6563 7572 7369 7665 6c79 2074 7261 7665 ecursively trave │ │ │ │ │ -000135b0: 7273 6573 2074 6865 2063 6f6d 706f 6e65 rses the compone │ │ │ │ │ -000135c0: 6e74 2074 7265 6520 726f 6f74 6564 2061 nt tree rooted a │ │ │ │ │ -000135d0: 740a 2020 2020 2052 4f4f 542c 2061 6e64 t. ROOT, and │ │ │ │ │ -000135e0: 2066 6f72 2065 7665 7279 2063 6f6d 706f for every compo │ │ │ │ │ -000135f0: 6e65 6e74 2074 6861 7420 6861 7320 616e nent that has an │ │ │ │ │ -00013600: 2049 4420 6571 7561 6c20 746f 2049 442c ID equal to ID, │ │ │ │ │ -00013610: 2063 616c 6c73 2074 6865 0a20 2020 2020 calls the. │ │ │ │ │ -00013620: 6675 6e63 7469 6f6e 2070 6f69 6e74 6564 function pointed │ │ │ │ │ -00013630: 2074 6f20 6279 2043 414c 4c42 4143 4b20 to by CALLBACK │ │ │ │ │ -00013640: 7769 7468 2074 6865 206d 6174 6368 696e with the matchin │ │ │ │ │ -00013650: 6720 636f 6d70 6f6e 656e 7420 616e 6420 g component and │ │ │ │ │ -00013660: 7468 650a 2020 2020 2076 6f69 6420 706f the. void po │ │ │ │ │ -00013670: 696e 7465 7220 5553 4552 4441 5441 2061 inter USERDATA a │ │ │ │ │ -00013680: 7320 6172 6775 6d65 6e74 732e 2020 5468 s arguments. Th │ │ │ │ │ -00013690: 6520 6361 6c6c 6261 636b 2066 756e 6374 e callback funct │ │ │ │ │ -000136a0: 696f 6e20 6361 6e20 646f 0a20 2020 2020 ion can do. │ │ │ │ │ -000136b0: 7768 6174 6576 6572 2069 7320 6465 7369 whatever is desi │ │ │ │ │ -000136c0: 7265 6420 746f 2075 7365 2074 6865 2063 red to use the c │ │ │ │ │ -000136d0: 6f6d 706f 6e65 6e74 2070 6173 7365 6420 omponent passed │ │ │ │ │ -000136e0: 696e 2e0a 0a20 2020 2a20 2767 7275 625f in... * 'grub_ │ │ │ │ │ -000136f0: 6775 695f 6974 6572 6174 655f 7265 6375 gui_iterate_recu │ │ │ │ │ -00013700: 7273 6976 656c 7920 2872 6f6f 742c 2063 rsively (root, c │ │ │ │ │ -00013710: 616c 6c62 6163 6b2c 2075 7365 7264 6174 allback, userdat │ │ │ │ │ -00013720: 6129 273a 0a0a 2020 2020 2054 6869 7320 a)':.. This │ │ │ │ │ -00013730: 6675 6e63 7469 6f6e 2063 616c 6c73 2074 function calls t │ │ │ │ │ -00013740: 6865 2066 756e 6374 696f 6e20 706f 696e he function poin │ │ │ │ │ -00013750: 7465 6420 746f 2062 7920 4341 4c4c 4241 ted to by CALLBA │ │ │ │ │ -00013760: 434b 2066 6f72 2065 7665 7279 0a20 2020 CK for every. │ │ │ │ │ -00013770: 2020 636f 6d70 6f6e 656e 7420 7468 6174 component that │ │ │ │ │ -00013780: 2069 7320 6120 6465 7363 656e 6461 6e74 is a descendant │ │ │ │ │ -00013790: 206f 6620 524f 4f54 2069 6e20 7468 6520 of ROOT in the │ │ │ │ │ -000137a0: 636f 6d70 6f6e 656e 7420 7472 6565 2e20 component tree. │ │ │ │ │ -000137b0: 2057 6865 6e0a 2020 2020 2074 6865 2063 When. the c │ │ │ │ │ -000137c0: 616c 6c62 6163 6b20 6675 6e63 7469 6f6e allback function │ │ │ │ │ -000137d0: 2069 7320 6361 6c6c 6564 2c20 7468 6520 is called, the │ │ │ │ │ -000137e0: 636f 6d70 6f6e 656e 7420 616e 6420 7468 component and th │ │ │ │ │ -000137f0: 6520 766f 6964 2070 6f69 6e74 6572 0a20 e void pointer. │ │ │ │ │ -00013800: 2020 2020 5553 4552 4441 5441 2061 7320 USERDATA as │ │ │ │ │ -00013810: 6172 6775 6d65 6e74 732e 2020 5468 6520 arguments. The │ │ │ │ │ -00013820: 6361 6c6c 6261 636b 2066 756e 6374 696f callback functio │ │ │ │ │ -00013830: 6e20 6361 6e20 646f 2077 6861 7465 7665 n can do whateve │ │ │ │ │ -00013840: 7220 6973 0a20 2020 2020 6465 7369 7265 r is. desire │ │ │ │ │ -00013850: 6420 746f 2075 7365 2074 6865 2063 6f6d d to use the com │ │ │ │ │ -00013860: 706f 6e65 6e74 2070 6173 7365 6420 696e ponent passed in │ │ │ │ │ -00013870: 2e0a 0a1f 0a46 696c 653a 2067 7275 622d .....File: grub- │ │ │ │ │ -00013880: 6465 762e 696e 666f 2c20 204e 6f64 653a dev.info, Node: │ │ │ │ │ -00013890: 2043 6f6d 6d61 6e64 204c 696e 6520 5769 Command Line Wi │ │ │ │ │ -000138a0: 6e64 6f77 2c20 2050 7265 763a 2047 5549 ndow, Prev: GUI │ │ │ │ │ -000138b0: 2043 6f6d 706f 6e65 6e74 732c 2020 5570 Components, Up │ │ │ │ │ -000138c0: 3a20 4772 6170 6869 6361 6c20 4d65 6e75 : Graphical Menu │ │ │ │ │ -000138d0: 2053 6f66 7477 6172 6520 4465 7369 676e Software Design │ │ │ │ │ -000138e0: 0a0a 3132 2e34 2043 6f6d 6d61 6e64 204c ..12.4 Command L │ │ │ │ │ -000138f0: 696e 6520 5769 6e64 6f77 0a3d 3d3d 3d3d ine Window.===== │ │ │ │ │ +000127b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a *************..* │ │ │ │ │ +000127c0: 204d 656e 753a 0a0a 2a20 496e 7472 6f64 Menu:..* Introd │ │ │ │ │ +000127d0: 7563 7469 6f6e 5f32 3a3a 0a2a 2053 7461 uction_2::.* Sta │ │ │ │ │ +000127e0: 7274 7570 2053 6571 7565 6e63 653a 3a0a rtup Sequence::. │ │ │ │ │ +000127f0: 2a20 4755 4920 436f 6d70 6f6e 656e 7473 * GUI Components │ │ │ │ │ +00012800: 3a3a 0a2a 2043 6f6d 6d61 6e64 204c 696e ::.* Command Lin │ │ │ │ │ +00012810: 6520 5769 6e64 6f77 3a3a 0a0a 1f0a 4669 e Window::....Fi │ │ │ │ │ +00012820: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ +00012830: 6f2c 2020 4e6f 6465 3a20 496e 7472 6f64 o, Node: Introd │ │ │ │ │ +00012840: 7563 7469 6f6e 5f32 2c20 204e 6578 743a uction_2, Next: │ │ │ │ │ +00012850: 2053 7461 7274 7570 2053 6571 7565 6e63 Startup Sequenc │ │ │ │ │ +00012860: 652c 2020 5570 3a20 4772 6170 6869 6361 e, Up: Graphica │ │ │ │ │ +00012870: 6c20 4d65 6e75 2053 6f66 7477 6172 6520 l Menu Software │ │ │ │ │ +00012880: 4465 7369 676e 0a0a 3132 2e31 2049 6e74 Design..12.1 Int │ │ │ │ │ +00012890: 726f 6475 6374 696f 6e0a 3d3d 3d3d 3d3d roduction.====== │ │ │ │ │ +000128a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 ===========..The │ │ │ │ │ +000128b0: 2027 6766 786d 656e 7527 206d 6f64 756c 'gfxmenu' modul │ │ │ │ │ +000128c0: 6520 7072 6f76 6964 6573 2061 2067 7261 e provides a gra │ │ │ │ │ +000128d0: 7068 6963 616c 206d 656e 7520 696e 7465 phical menu inte │ │ │ │ │ +000128e0: 7266 6163 6520 666f 7220 4752 5542 2032 rface for GRUB 2 │ │ │ │ │ +000128f0: 2e20 2049 740a 6675 6e63 7469 6f6e 7320 . It.functions │ │ │ │ │ +00012900: 6173 2061 6e20 616c 7465 726e 6174 6976 as an alternativ │ │ │ │ │ +00012910: 6520 746f 2074 6865 206d 656e 7520 696e e to the menu in │ │ │ │ │ +00012920: 7465 7266 6163 6520 7072 6f76 6964 6564 terface provided │ │ │ │ │ +00012930: 2062 7920 7468 650a 276e 6f72 6d61 6c27 by the.'normal' │ │ │ │ │ +00012940: 206d 6f64 756c 652c 2077 6869 6368 2075 module, which u │ │ │ │ │ +00012950: 7365 7320 7468 6520 6772 7562 2074 6572 ses the grub ter │ │ │ │ │ +00012960: 6d69 6e61 6c20 696e 7465 7266 6163 6520 minal interface │ │ │ │ │ +00012970: 746f 2064 6973 706c 6179 2061 0a6d 656e to display a.men │ │ │ │ │ +00012980: 7520 6f6e 2061 2063 6861 7261 6374 6572 u on a character │ │ │ │ │ +00012990: 2d6f 7269 656e 7465 6420 7465 726d 696e -oriented termin │ │ │ │ │ +000129a0: 616c 2e0a 0a20 2020 5468 6520 6772 6170 al... The grap │ │ │ │ │ +000129b0: 6869 6361 6c20 6d65 6e75 2075 7365 7320 hical menu uses │ │ │ │ │ +000129c0: 7468 6520 4752 5542 2076 6964 656f 2041 the GRUB video A │ │ │ │ │ +000129d0: 5049 2c20 7768 6963 6820 6973 2063 7572 PI, which is cur │ │ │ │ │ +000129e0: 7265 6e74 6c79 2066 6f72 0a74 6865 2056 rently for.the V │ │ │ │ │ +000129f0: 4553 4120 4249 4f53 2065 7874 656e 7369 ESA BIOS extensi │ │ │ │ │ +00012a00: 6f6e 7320 2856 4245 2920 322e 302b 2e20 ons (VBE) 2.0+. │ │ │ │ │ +00012a10: 2054 6869 7320 6973 2073 7570 706f 7274 This is support │ │ │ │ │ +00012a20: 6564 206f 6e20 7468 6520 6933 3836 2d70 ed on the i386-p │ │ │ │ │ +00012a30: 630a 706c 6174 666f 726d 2e20 2048 6f77 c.platform. How │ │ │ │ │ +00012a40: 6576 6572 2c20 7468 6520 6772 6170 6869 ever, the graphi │ │ │ │ │ +00012a50: 6361 6c20 6d65 6e75 2069 7473 656c 6620 cal menu itself │ │ │ │ │ +00012a60: 646f 6573 206e 6f74 2064 6570 656e 6420 does not depend │ │ │ │ │ +00012a70: 6f6e 2075 7369 6e67 0a56 4245 2c20 736f on using.VBE, so │ │ │ │ │ +00012a80: 2069 6620 616e 6f74 6865 7220 4752 5542 if another GRUB │ │ │ │ │ +00012a90: 2076 6964 656f 2064 7269 7665 7220 7765 video driver we │ │ │ │ │ +00012aa0: 7265 2069 6d70 6c65 6d65 6e74 6564 2c20 re implemented, │ │ │ │ │ +00012ab0: 7468 6520 2767 6678 6d65 6e75 270a 6772 the 'gfxmenu'.gr │ │ │ │ │ +00012ac0: 6170 6869 6361 6c20 6d65 6e75 2077 6f75 aphical menu wou │ │ │ │ │ +00012ad0: 6c64 2077 6f72 6b20 6f6e 2074 6865 206e ld work on the n │ │ │ │ │ +00012ae0: 6577 2076 6964 656f 2064 7269 7665 7220 ew video driver │ │ │ │ │ +00012af0: 6173 2077 656c 6c2e 0a0a 1f0a 4669 6c65 as well.....File │ │ │ │ │ +00012b00: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ +00012b10: 2020 4e6f 6465 3a20 5374 6172 7475 7020 Node: Startup │ │ │ │ │ +00012b20: 5365 7175 656e 6365 2c20 204e 6578 743a Sequence, Next: │ │ │ │ │ +00012b30: 2047 5549 2043 6f6d 706f 6e65 6e74 732c GUI Components, │ │ │ │ │ +00012b40: 2020 5072 6576 3a20 496e 7472 6f64 7563 Prev: Introduc │ │ │ │ │ +00012b50: 7469 6f6e 5f32 2c20 2055 703a 2047 7261 tion_2, Up: Gra │ │ │ │ │ +00012b60: 7068 6963 616c 204d 656e 7520 536f 6674 phical Menu Soft │ │ │ │ │ +00012b70: 7761 7265 2044 6573 6967 6e0a 0a31 322e ware Design..12. │ │ │ │ │ +00012b80: 3220 5374 6172 7475 7020 5365 7175 656e 2 Startup Sequen │ │ │ │ │ +00012b90: 6365 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ce.============= │ │ │ │ │ +00012ba0: 3d3d 3d3d 3d3d 3d3d 0a0a 2020 202a 2067 ========.. * g │ │ │ │ │ +00012bb0: 7275 625f 656e 7465 725f 6e6f 726d 616c rub_enter_normal │ │ │ │ │ +00012bc0: 5f6d 6f64 6520 5b6e 6f72 6d61 6c2f 6d61 _mode [normal/ma │ │ │ │ │ +00012bd0: 696e 2e63 5d0a 2020 202a 2067 7275 625f in.c]. * grub_ │ │ │ │ │ +00012be0: 6e6f 726d 616c 5f65 7865 6375 7465 205b normal_execute [ │ │ │ │ │ +00012bf0: 6e6f 726d 616c 2f6d 6169 6e2e 635d 0a20 normal/main.c]. │ │ │ │ │ +00012c00: 2020 2a20 7265 6164 5f63 6f6e 6669 675f * read_config_ │ │ │ │ │ +00012c10: 6669 6c65 205b 6e6f 726d 616c 2f6d 6169 file [normal/mai │ │ │ │ │ +00012c20: 6e2e 635d 0a20 2020 2a20 2857 6865 6e20 n.c]. * (When │ │ │ │ │ +00012c30: 2767 6678 6d65 6e75 2e6d 6f64 2720 6973 'gfxmenu.mod' is │ │ │ │ │ +00012c40: 206c 6f61 6465 6420 7769 7468 2027 696e loaded with 'in │ │ │ │ │ +00012c50: 736d 6f64 272c 2069 7420 7769 6c6c 2063 smod', it will c │ │ │ │ │ +00012c60: 616c 6c0a 2020 2020 2027 6772 7562 5f6d all. 'grub_m │ │ │ │ │ +00012c70: 656e 755f 7669 6577 6572 5f72 6567 6973 enu_viewer_regis │ │ │ │ │ +00012c80: 7465 7228 2927 2074 6f20 7265 6769 7374 ter()' to regist │ │ │ │ │ +00012c90: 6572 2069 7473 656c 662e 290a 2020 202a er itself.). * │ │ │ │ │ +00012ca0: 2047 5255 425f 4d4f 445f 494e 4954 2028 GRUB_MOD_INIT ( │ │ │ │ │ +00012cb0: 6766 786d 656e 7529 205b 6766 786d 656e gfxmenu) [gfxmen │ │ │ │ │ +00012cc0: 752f 6766 786d 656e 752e 635d 0a20 2020 u/gfxmenu.c]. │ │ │ │ │ +00012cd0: 2a20 6772 7562 5f6d 656e 755f 7669 6577 * grub_menu_view │ │ │ │ │ +00012ce0: 6572 5f72 6567 6973 7465 7220 5b6b 6572 er_register [ker │ │ │ │ │ +00012cf0: 6e2f 6d65 6e75 5f76 6965 7765 722e 635d n/menu_viewer.c] │ │ │ │ │ +00012d00: 0a20 2020 2a20 6772 7562 5f6d 656e 755f . * grub_menu_ │ │ │ │ │ +00012d10: 7669 6577 6572 5f73 686f 775f 6d65 6e75 viewer_show_menu │ │ │ │ │ +00012d20: 205b 6b65 726e 2f6d 656e 755f 7669 6577 [kern/menu_view │ │ │ │ │ +00012d30: 6572 2e63 5d0a 2020 202a 2067 6574 5f63 er.c]. * get_c │ │ │ │ │ +00012d40: 7572 7265 6e74 5f6d 656e 755f 7669 6577 urrent_menu_view │ │ │ │ │ +00012d50: 6572 2829 205b 6b65 726e 2f6d 656e 755f er() [kern/menu_ │ │ │ │ │ +00012d60: 7669 6577 6572 2e63 5d0a 2020 202a 2073 viewer.c]. * s │ │ │ │ │ +00012d70: 686f 775f 6d65 6e75 2829 205b 6766 786d how_menu() [gfxm │ │ │ │ │ +00012d80: 656e 752f 6766 786d 656e 752e 635d 0a20 enu/gfxmenu.c]. │ │ │ │ │ +00012d90: 2020 2a20 6772 7562 5f67 6678 6d65 6e75 * grub_gfxmenu │ │ │ │ │ +00012da0: 5f6d 6f64 656c 5f6e 6577 205b 6766 786d _model_new [gfxm │ │ │ │ │ +00012db0: 656e 752f 6d6f 6465 6c2e 635d 0a20 2020 enu/model.c]. │ │ │ │ │ +00012dc0: 2a20 6772 7562 5f67 6678 6d65 6e75 5f76 * grub_gfxmenu_v │ │ │ │ │ +00012dd0: 6965 775f 6e65 7720 5b67 6678 6d65 6e75 iew_new [gfxmenu │ │ │ │ │ +00012de0: 2f76 6965 772e 635d 0a20 2020 2a20 7365 /view.c]. * se │ │ │ │ │ +00012df0: 745f 6772 6170 6869 6373 5f6d 6f64 6520 t_graphics_mode │ │ │ │ │ +00012e00: 5b67 6678 6d65 6e75 2f76 6965 772e 635d [gfxmenu/view.c] │ │ │ │ │ +00012e10: 0a20 2020 2a20 6772 7562 5f67 6678 6d65 . * grub_gfxme │ │ │ │ │ +00012e20: 6e75 5f76 6965 775f 6c6f 6164 5f74 6865 nu_view_load_the │ │ │ │ │ +00012e30: 6d65 205b 6766 786d 656e 752f 7468 656d me [gfxmenu/them │ │ │ │ │ +00012e40: 655f 6c6f 6164 6572 2e63 5d0a 0a1f 0a46 e_loader.c]....F │ │ │ │ │ +00012e50: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ │ +00012e60: 666f 2c20 204e 6f64 653a 2047 5549 2043 fo, Node: GUI C │ │ │ │ │ +00012e70: 6f6d 706f 6e65 6e74 732c 2020 4e65 7874 omponents, Next │ │ │ │ │ +00012e80: 3a20 436f 6d6d 616e 6420 4c69 6e65 2057 : Command Line W │ │ │ │ │ +00012e90: 696e 646f 772c 2020 5072 6576 3a20 5374 indow, Prev: St │ │ │ │ │ +00012ea0: 6172 7475 7020 5365 7175 656e 6365 2c20 artup Sequence, │ │ │ │ │ +00012eb0: 2055 703a 2047 7261 7068 6963 616c 204d Up: Graphical M │ │ │ │ │ +00012ec0: 656e 7520 536f 6674 7761 7265 2044 6573 enu Software Des │ │ │ │ │ +00012ed0: 6967 6e0a 0a31 322e 3320 4755 4920 436f ign..12.3 GUI Co │ │ │ │ │ +00012ee0: 6d70 6f6e 656e 7473 0a3d 3d3d 3d3d 3d3d mponents.======= │ │ │ │ │ +00012ef0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ │ +00012f00: 6520 6772 6170 6869 6361 6c20 6d65 6e75 e graphical menu │ │ │ │ │ +00012f10: 2069 6d70 6c65 6d65 6e74 7320 6120 4755 implements a GU │ │ │ │ │ +00012f20: 4920 636f 6d70 6f6e 656e 7420 7379 7374 I component syst │ │ │ │ │ +00012f30: 656d 2074 6861 7420 7375 7070 6f72 7473 em that supports │ │ │ │ │ +00012f40: 2061 0a63 6f6e 7461 696e 6572 2d62 6173 a.container-bas │ │ │ │ │ +00012f50: 6564 206c 6179 6f75 7420 7379 7374 656d ed layout system │ │ │ │ │ +00012f60: 2e20 2043 6f6d 706f 6e65 6e74 7320 6361 . Components ca │ │ │ │ │ +00012f70: 6e20 6265 2061 6464 6564 2074 6f20 636f n be added to co │ │ │ │ │ +00012f80: 6e74 6169 6e65 7273 2c0a 616e 6420 636f ntainers,.and co │ │ │ │ │ +00012f90: 6e74 6169 6e65 7273 2028 7768 6963 6820 ntainers (which │ │ │ │ │ +00012fa0: 6172 6520 6120 7479 7065 206f 6620 636f are a type of co │ │ │ │ │ +00012fb0: 6d70 6f6e 656e 7429 2063 616e 2074 6865 mponent) can the │ │ │ │ │ +00012fc0: 6e20 6265 2061 6464 6564 2074 6f0a 6f74 n be added to.ot │ │ │ │ │ +00012fd0: 6865 7220 636f 6e74 6169 6e65 7273 2c20 her containers, │ │ │ │ │ +00012fe0: 746f 2066 6f72 6d20 6120 7472 6565 206f to form a tree o │ │ │ │ │ +00012ff0: 6620 636f 6d70 6f6e 656e 7473 2e20 2043 f components. C │ │ │ │ │ +00013000: 7572 7265 6e74 6c79 2c20 7468 6520 726f urrently, the ro │ │ │ │ │ +00013010: 6f74 0a63 6f6d 706f 6e65 6e74 206f 6620 ot.component of │ │ │ │ │ +00013020: 7468 6973 2074 7265 6520 6973 2061 2027 this tree is a ' │ │ │ │ │ +00013030: 6361 6e76 6173 2720 636f 6d70 6f6e 656e canvas' componen │ │ │ │ │ +00013040: 742c 2077 6869 6368 2061 6c6c 6f77 7320 t, which allows │ │ │ │ │ +00013050: 6d61 6e75 616c 0a6c 6179 6f75 7420 6f66 manual.layout of │ │ │ │ │ +00013060: 2069 7473 2063 6869 6c64 2063 6f6d 706f its child compo │ │ │ │ │ +00013070: 6e65 6e74 732e 0a0a 2020 2043 6f6d 706f nents... Compo │ │ │ │ │ +00013080: 6e65 6e74 7320 286e 6f6e 2d63 6f6e 7461 nents (non-conta │ │ │ │ │ +00013090: 696e 6572 293a 0a0a 2020 202a 206c 6162 iner):.. * lab │ │ │ │ │ +000130a0: 656c 0a20 2020 2a20 696d 6167 650a 2020 el. * image. │ │ │ │ │ +000130b0: 202a 2070 726f 6772 6573 735f 6261 720a * progress_bar. │ │ │ │ │ +000130c0: 2020 202a 2063 6972 6375 6c61 725f 7072 * circular_pr │ │ │ │ │ +000130d0: 6f67 7265 7373 0a20 2020 2a20 6c69 7374 ogress. * list │ │ │ │ │ +000130e0: 2028 6375 7272 656e 746c 7920 6861 7264 (currently hard │ │ │ │ │ +000130f0: 2063 6f64 6564 2074 6f20 6265 2061 2062 coded to be a b │ │ │ │ │ +00013100: 6f6f 7420 6d65 6e75 206c 6973 7429 0a0a oot menu list).. │ │ │ │ │ +00013110: 2020 2043 6f6e 7461 696e 6572 733a 0a0a Containers:.. │ │ │ │ │ +00013120: 2020 202a 2063 616e 7661 730a 2020 202a * canvas. * │ │ │ │ │ +00013130: 2068 626f 780a 2020 202a 2076 626f 780a hbox. * vbox. │ │ │ │ │ +00013140: 0a20 2020 5468 6520 4755 4920 636f 6d70 . The GUI comp │ │ │ │ │ +00013150: 6f6e 656e 7420 696e 7374 616e 6365 7320 onent instances │ │ │ │ │ +00013160: 6172 6520 6372 6561 7465 6420 6279 2074 are created by t │ │ │ │ │ +00013170: 6865 2074 6865 6d65 206c 6f61 6465 7220 he theme loader │ │ │ │ │ +00013180: 696e 0a27 6766 786d 656e 752f 7468 656d in.'gfxmenu/them │ │ │ │ │ +00013190: 655f 6c6f 6164 6572 2e63 2720 7768 656e e_loader.c' when │ │ │ │ │ +000131a0: 2061 2074 6865 6d65 2069 7320 6c6f 6164 a theme is load │ │ │ │ │ +000131b0: 6564 2e20 2054 6865 6d65 2066 696c 6573 ed. Theme files │ │ │ │ │ +000131c0: 2073 7065 6369 6679 0a73 7461 7465 6d65 specify.stateme │ │ │ │ │ +000131d0: 6e74 7320 7375 6368 2061 7320 272b 7662 nts such as '+vb │ │ │ │ │ +000131e0: 6f78 7b20 2b6c 6162 656c 207b 2074 6578 ox{ +label { tex │ │ │ │ │ +000131f0: 743d 2248 656c 6c6f 2220 7d20 2b6c 6162 t="Hello" } +lab │ │ │ │ │ +00013200: 656c 7b20 7465 7874 3d22 576f 726c 6422 el{ text="World" │ │ │ │ │ +00013210: 0a7d 207d 2720 746f 2061 6464 2063 6f6d .} }' to add com │ │ │ │ │ +00013220: 706f 6e65 6e74 7320 746f 2074 6865 2063 ponents to the c │ │ │ │ │ +00013230: 6f6d 706f 6e65 6e74 2074 7265 6520 726f omponent tree ro │ │ │ │ │ +00013240: 6f74 2e20 2042 7920 6e65 7374 696e 6720 ot. By nesting │ │ │ │ │ +00013250: 7468 650a 636f 6d70 6f6e 656e 7420 6372 the.component cr │ │ │ │ │ +00013260: 6561 7469 6f6e 2073 7461 7465 6d65 6e74 eation statement │ │ │ │ │ +00013270: 7320 696e 2074 6865 2074 6865 6d65 2066 s in the theme f │ │ │ │ │ +00013280: 696c 652c 2074 6865 2069 6e73 7461 6e74 ile, the instant │ │ │ │ │ +00013290: 6961 7465 640a 636f 6d70 6f6e 656e 7473 iated.components │ │ │ │ │ +000132a0: 2061 7265 206e 6573 7465 6420 7468 6520 are nested the │ │ │ │ │ +000132b0: 7361 6d65 2077 6179 2e0a 0a20 2020 5768 same way... Wh │ │ │ │ │ +000132c0: 656e 2061 2063 6f6d 706f 6e65 6e74 2069 en a component i │ │ │ │ │ +000132d0: 7320 6164 6465 6420 746f 2061 2063 6f6e s added to a con │ │ │ │ │ +000132e0: 7461 696e 6572 2c20 7468 6174 206e 6577 tainer, that new │ │ │ │ │ +000132f0: 2063 6869 6c64 2069 730a 636f 6e73 6964 child is.consid │ │ │ │ │ +00013300: 6572 6564 202a 6f77 6e65 642a 2062 7920 ered *owned* by │ │ │ │ │ +00013310: 7468 6520 636f 6e74 6169 6e65 722e 2020 the container. │ │ │ │ │ +00013320: 4772 6561 7420 6361 7265 2073 686f 756c Great care shoul │ │ │ │ │ +00013330: 6420 6265 2074 616b 656e 2069 6620 7468 d be taken if th │ │ │ │ │ +00013340: 650a 6361 6c6c 6572 2072 6574 6169 6e73 e.caller retains │ │ │ │ │ +00013350: 2061 2072 6566 6572 656e 6365 2074 6f20 a reference to │ │ │ │ │ +00013360: 7468 6520 6368 696c 6420 636f 6d70 6f6e the child compon │ │ │ │ │ +00013370: 656e 742c 2073 696e 6365 2069 7420 7769 ent, since it wi │ │ │ │ │ +00013380: 6c6c 2062 650a 6465 7374 726f 7965 6420 ll be.destroyed │ │ │ │ │ +00013390: 6966 2069 7473 2070 6172 656e 7420 636f if its parent co │ │ │ │ │ +000133a0: 6e74 6169 6e65 7220 6973 2064 6573 7472 ntainer is destr │ │ │ │ │ +000133b0: 6f79 6564 2e20 2041 2062 6574 7465 7220 oyed. A better │ │ │ │ │ +000133c0: 6368 6f69 6365 2069 6e73 7465 6164 0a6f choice instead.o │ │ │ │ │ +000133d0: 6620 7374 6f72 696e 6720 6120 706f 696e f storing a poin │ │ │ │ │ +000133e0: 7465 7220 746f 2074 6865 2063 6869 6c64 ter to the child │ │ │ │ │ +000133f0: 2063 6f6d 706f 6e65 6e74 2069 7320 746f component is to │ │ │ │ │ +00013400: 2075 7365 2074 6865 2063 6f6d 706f 6e65 use the compone │ │ │ │ │ +00013410: 6e74 2049 440a 746f 2066 696e 6420 7468 nt ID.to find th │ │ │ │ │ +00013420: 6520 6465 7369 7265 6420 636f 6d70 6f6e e desired compon │ │ │ │ │ +00013430: 656e 742e 2020 436f 6d70 6f6e 656e 7420 ent. Component │ │ │ │ │ +00013440: 4944 7320 646f 206e 6f74 2068 6176 6520 IDs do not have │ │ │ │ │ +00013450: 746f 2062 6520 756e 6971 7565 0a28 6974 to be unique.(it │ │ │ │ │ +00013460: 2069 7320 6f66 7465 6e20 7573 6566 756c is often useful │ │ │ │ │ +00013470: 2074 6f20 6861 7665 206d 756c 7469 706c to have multipl │ │ │ │ │ +00013480: 6520 636f 6d70 6f6e 656e 7473 2077 6974 e components wit │ │ │ │ │ +00013490: 6820 616e 2049 4420 6f66 0a22 5f5f 7469 h an ID of."__ti │ │ │ │ │ +000134a0: 6d65 6f75 745f 5f22 2c20 666f 7220 696e meout__", for in │ │ │ │ │ +000134b0: 7374 616e 6365 292e 0a0a 2020 2049 6e20 stance)... In │ │ │ │ │ +000134c0: 6f72 6465 7220 746f 2061 6363 6573 7320 order to access │ │ │ │ │ +000134d0: 616e 6420 7573 6520 636f 6d70 6f6e 656e and use componen │ │ │ │ │ +000134e0: 7473 2069 6e20 7468 6520 636f 6d70 6f6e ts in the compon │ │ │ │ │ +000134f0: 656e 7420 7472 6565 2c20 7468 6572 650a ent tree, there. │ │ │ │ │ +00013500: 6172 6520 7477 6f20 6675 6e63 7469 6f6e are two function │ │ │ │ │ +00013510: 7320 2864 6566 696e 6564 2069 6e20 2767 s (defined in 'g │ │ │ │ │ +00013520: 6678 6d65 6e75 2f67 7569 5f75 7469 6c2e fxmenu/gui_util. │ │ │ │ │ +00013530: 6327 2920 7468 6174 2061 7265 0a70 6172 c') that are.par │ │ │ │ │ +00013540: 7469 6375 6c61 726c 7920 7573 6566 756c ticularly useful │ │ │ │ │ +00013550: 3a0a 0a20 2020 2a20 2767 7275 625f 6775 :.. * 'grub_gu │ │ │ │ │ +00013560: 695f 6669 6e64 5f62 795f 6964 2028 726f i_find_by_id (ro │ │ │ │ │ +00013570: 6f74 2c20 6964 2c20 6361 6c6c 6261 636b ot, id, callback │ │ │ │ │ +00013580: 2c20 7573 6572 6461 7461 2927 3a0a 0a20 , userdata)':.. │ │ │ │ │ +00013590: 2020 2020 5468 6973 2066 756e 6374 696f This functio │ │ │ │ │ +000135a0: 6e20 6563 7572 7369 7665 6c79 2074 7261 n ecursively tra │ │ │ │ │ +000135b0: 7665 7273 6573 2074 6865 2063 6f6d 706f verses the compo │ │ │ │ │ +000135c0: 6e65 6e74 2074 7265 6520 726f 6f74 6564 nent tree rooted │ │ │ │ │ +000135d0: 2061 740a 2020 2020 2052 4f4f 542c 2061 at. ROOT, a │ │ │ │ │ +000135e0: 6e64 2066 6f72 2065 7665 7279 2063 6f6d nd for every com │ │ │ │ │ +000135f0: 706f 6e65 6e74 2074 6861 7420 6861 7320 ponent that has │ │ │ │ │ +00013600: 616e 2049 4420 6571 7561 6c20 746f 2049 an ID equal to I │ │ │ │ │ +00013610: 442c 2063 616c 6c73 2074 6865 0a20 2020 D, calls the. │ │ │ │ │ +00013620: 2020 6675 6e63 7469 6f6e 2070 6f69 6e74 function point │ │ │ │ │ +00013630: 6564 2074 6f20 6279 2043 414c 4c42 4143 ed to by CALLBAC │ │ │ │ │ +00013640: 4b20 7769 7468 2074 6865 206d 6174 6368 K with the match │ │ │ │ │ +00013650: 696e 6720 636f 6d70 6f6e 656e 7420 616e ing component an │ │ │ │ │ +00013660: 6420 7468 650a 2020 2020 2076 6f69 6420 d the. void │ │ │ │ │ +00013670: 706f 696e 7465 7220 5553 4552 4441 5441 pointer USERDATA │ │ │ │ │ +00013680: 2061 7320 6172 6775 6d65 6e74 732e 2020 as arguments. │ │ │ │ │ +00013690: 5468 6520 6361 6c6c 6261 636b 2066 756e The callback fun │ │ │ │ │ +000136a0: 6374 696f 6e20 6361 6e20 646f 0a20 2020 ction can do. │ │ │ │ │ +000136b0: 2020 7768 6174 6576 6572 2069 7320 6465 whatever is de │ │ │ │ │ +000136c0: 7369 7265 6420 746f 2075 7365 2074 6865 sired to use the │ │ │ │ │ +000136d0: 2063 6f6d 706f 6e65 6e74 2070 6173 7365 component passe │ │ │ │ │ +000136e0: 6420 696e 2e0a 0a20 2020 2a20 2767 7275 d in... * 'gru │ │ │ │ │ +000136f0: 625f 6775 695f 6974 6572 6174 655f 7265 b_gui_iterate_re │ │ │ │ │ +00013700: 6375 7273 6976 656c 7920 2872 6f6f 742c cursively (root, │ │ │ │ │ +00013710: 2063 616c 6c62 6163 6b2c 2075 7365 7264 callback, userd │ │ │ │ │ +00013720: 6174 6129 273a 0a0a 2020 2020 2054 6869 ata)':.. Thi │ │ │ │ │ +00013730: 7320 6675 6e63 7469 6f6e 2063 616c 6c73 s function calls │ │ │ │ │ +00013740: 2074 6865 2066 756e 6374 696f 6e20 706f the function po │ │ │ │ │ +00013750: 696e 7465 6420 746f 2062 7920 4341 4c4c inted to by CALL │ │ │ │ │ +00013760: 4241 434b 2066 6f72 2065 7665 7279 0a20 BACK for every. │ │ │ │ │ +00013770: 2020 2020 636f 6d70 6f6e 656e 7420 7468 component th │ │ │ │ │ +00013780: 6174 2069 7320 6120 6465 7363 656e 6461 at is a descenda │ │ │ │ │ +00013790: 6e74 206f 6620 524f 4f54 2069 6e20 7468 nt of ROOT in th │ │ │ │ │ +000137a0: 6520 636f 6d70 6f6e 656e 7420 7472 6565 e component tree │ │ │ │ │ +000137b0: 2e20 2057 6865 6e0a 2020 2020 2074 6865 . When. the │ │ │ │ │ +000137c0: 2063 616c 6c62 6163 6b20 6675 6e63 7469 callback functi │ │ │ │ │ +000137d0: 6f6e 2069 7320 6361 6c6c 6564 2c20 7468 on is called, th │ │ │ │ │ +000137e0: 6520 636f 6d70 6f6e 656e 7420 616e 6420 e component and │ │ │ │ │ +000137f0: 7468 6520 766f 6964 2070 6f69 6e74 6572 the void pointer │ │ │ │ │ +00013800: 0a20 2020 2020 5553 4552 4441 5441 2061 . USERDATA a │ │ │ │ │ +00013810: 7320 6172 6775 6d65 6e74 732e 2020 5468 s arguments. Th │ │ │ │ │ +00013820: 6520 6361 6c6c 6261 636b 2066 756e 6374 e callback funct │ │ │ │ │ +00013830: 696f 6e20 6361 6e20 646f 2077 6861 7465 ion can do whate │ │ │ │ │ +00013840: 7665 7220 6973 0a20 2020 2020 6465 7369 ver is. desi │ │ │ │ │ +00013850: 7265 6420 746f 2075 7365 2074 6865 2063 red to use the c │ │ │ │ │ +00013860: 6f6d 706f 6e65 6e74 2070 6173 7365 6420 omponent passed │ │ │ │ │ +00013870: 696e 2e0a 0a1f 0a46 696c 653a 2067 7275 in.....File: gru │ │ │ │ │ +00013880: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ +00013890: 653a 2043 6f6d 6d61 6e64 204c 696e 6520 e: Command Line │ │ │ │ │ +000138a0: 5769 6e64 6f77 2c20 2050 7265 763a 2047 Window, Prev: G │ │ │ │ │ +000138b0: 5549 2043 6f6d 706f 6e65 6e74 732c 2020 UI Components, │ │ │ │ │ +000138c0: 5570 3a20 4772 6170 6869 6361 6c20 4d65 Up: Graphical Me │ │ │ │ │ +000138d0: 6e75 2053 6f66 7477 6172 6520 4465 7369 nu Software Desi │ │ │ │ │ +000138e0: 676e 0a0a 3132 2e34 2043 6f6d 6d61 6e64 gn..12.4 Command │ │ │ │ │ +000138f0: 204c 696e 6520 5769 6e64 6f77 0a3d 3d3d Line Window.=== │ │ │ │ │ 00013900: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00013910: 3d3d 3d0a 0a54 6865 2074 6572 6d69 6e61 ===..The termina │ │ │ │ │ -00013920: 6c20 7769 6e64 6f77 2075 7365 6420 746f l window used to │ │ │ │ │ -00013930: 2070 726f 7669 6465 2063 6f6d 6d61 6e64 provide command │ │ │ │ │ -00013940: 206c 696e 6520 6163 6365 7373 2077 6974 line access wit │ │ │ │ │ -00013950: 6869 6e20 7468 650a 6772 6170 6869 6361 hin the.graphica │ │ │ │ │ -00013960: 6c20 6d65 6e75 2069 7320 6d61 6e61 6765 l menu is manage │ │ │ │ │ -00013970: 6420 6279 2027 6766 786d 656e 752f 7669 d by 'gfxmenu/vi │ │ │ │ │ -00013980: 6577 2e63 272e 2020 5468 6520 2767 6678 ew.c'. The 'gfx │ │ │ │ │ -00013990: 7465 726d 2720 7465 726d 696e 616c 0a69 term' terminal.i │ │ │ │ │ -000139a0: 7320 7573 6564 2c20 616e 6420 6974 2068 s used, and it h │ │ │ │ │ -000139b0: 6173 2062 6565 6e20 6d6f 6469 6669 6564 as been modified │ │ │ │ │ -000139c0: 2074 6f20 616c 6c6f 7720 7265 6e64 6572 to allow render │ │ │ │ │ -000139d0: 696e 6720 746f 2061 6e20 6f66 6673 6372 ing to an offscr │ │ │ │ │ -000139e0: 6565 6e0a 7265 6e64 6572 2074 6172 6765 een.render targe │ │ │ │ │ -000139f0: 7420 746f 2061 6c6c 6f77 2069 7420 746f t to allow it to │ │ │ │ │ -00013a00: 2062 6520 636f 6d70 6f73 6564 2069 6e74 be composed int │ │ │ │ │ -00013a10: 6f20 7468 6520 646f 7562 6c65 2062 7566 o the double buf │ │ │ │ │ -00013a20: 6665 7269 6e67 0a73 7973 7465 6d20 7468 fering.system th │ │ │ │ │ -00013a30: 6174 2074 6865 2067 7261 7068 6963 616c at the graphical │ │ │ │ │ -00013a40: 206d 656e 7520 7669 6577 2075 7365 732e menu view uses. │ │ │ │ │ -00013a50: 2020 5468 6973 2069 7320 6261 6420 666f This is bad fo │ │ │ │ │ -00013a60: 7220 7065 7266 6f72 6d61 6e63 652c 0a68 r performance,.h │ │ │ │ │ -00013a70: 6f77 6576 6572 2c20 736f 2069 7420 776f owever, so it wo │ │ │ │ │ -00013a80: 756c 6420 7072 6f62 6162 6c79 2062 6520 uld probably be │ │ │ │ │ -00013a90: 6120 676f 6f64 2069 6465 6120 746f 206d a good idea to m │ │ │ │ │ -00013aa0: 616b 6520 6974 2070 6f73 7369 626c 6520 ake it possible │ │ │ │ │ -00013ab0: 746f 0a74 656d 706f 7261 7269 6c79 2064 to.temporarily d │ │ │ │ │ -00013ac0: 6973 6162 6c65 2064 6f75 626c 6520 6275 isable double bu │ │ │ │ │ -00013ad0: 6666 6572 696e 6720 6173 206c 6f6e 6720 ffering as long │ │ │ │ │ -00013ae0: 6173 2074 6865 2074 6572 6d69 6e61 6c20 as the terminal │ │ │ │ │ -00013af0: 7769 6e64 6f77 2069 730a 7669 7369 626c window is.visibl │ │ │ │ │ -00013b00: 652e 2020 5468 6572 6520 6172 6520 7374 e. There are st │ │ │ │ │ -00013b10: 696c 6c20 756e 7265 736f 6c76 6564 2070 ill unresolved p │ │ │ │ │ -00013b20: 726f 626c 656d 7320 7468 6174 206f 6363 roblems that occ │ │ │ │ │ -00013b30: 7572 2077 6865 6e20 636f 6d6d 616e 6473 ur when commands │ │ │ │ │ -00013b40: 0a61 7265 2065 7865 6375 7465 6420 6672 .are executed fr │ │ │ │ │ -00013b50: 6f6d 2074 6865 2074 6572 6d69 6e61 6c20 om the terminal │ │ │ │ │ -00013b60: 7769 6e64 6f77 2074 6861 7420 6368 616e window that chan │ │ │ │ │ -00013b70: 6765 2074 6865 2067 7261 7068 6963 7320 ge the graphics │ │ │ │ │ -00013b80: 6d6f 6465 2e0a 4974 2773 2070 6f73 7369 mode..It's possi │ │ │ │ │ -00013b90: 626c 6520 7468 6174 206d 616b 696e 6720 ble that making │ │ │ │ │ -00013ba0: 2767 7275 625f 7669 6465 6f5f 7265 7374 'grub_video_rest │ │ │ │ │ -00013bb0: 6f72 6528 2927 2072 6574 7572 6e20 746f ore()' return to │ │ │ │ │ -00013bc0: 2074 6865 2067 7261 7068 6963 730a 6d6f the graphics.mo │ │ │ │ │ -00013bd0: 6465 2074 6861 7420 7761 7320 696e 2075 de that was in u │ │ │ │ │ -00013be0: 7365 2062 6566 6f72 6520 2767 7275 625f se before 'grub_ │ │ │ │ │ -00013bf0: 7669 6465 6f5f 7365 7475 7028 2927 2077 video_setup()' w │ │ │ │ │ -00013c00: 6173 2063 616c 6c65 6420 6d69 6768 7420 as called might │ │ │ │ │ -00013c10: 6669 780a 736f 6d65 206f 6620 7468 6520 fix.some of the │ │ │ │ │ -00013c20: 7072 6f62 6c65 6d73 2e0a 0a1f 0a46 696c problems.....Fil │ │ │ │ │ -00013c30: 653a 2067 7275 622d 6465 762e 696e 666f e: grub-dev.info │ │ │ │ │ -00013c40: 2c20 204e 6f64 653a 2056 6572 6966 6965 , Node: Verifie │ │ │ │ │ -00013c50: 7273 2066 7261 6d65 776f 726b 2c20 204e rs framework, N │ │ │ │ │ -00013c60: 6578 743a 204c 6f63 6b64 6f77 6e20 6672 ext: Lockdown fr │ │ │ │ │ -00013c70: 616d 6577 6f72 6b2c 2020 5072 6576 3a20 amework, Prev: │ │ │ │ │ -00013c80: 4772 6170 6869 6361 6c20 4d65 6e75 2053 Graphical Menu S │ │ │ │ │ -00013c90: 6f66 7477 6172 6520 4465 7369 676e 2c20 oftware Design, │ │ │ │ │ -00013ca0: 2055 703a 2054 6f70 0a0a 3133 2056 6572 Up: Top..13 Ver │ │ │ │ │ -00013cb0: 6966 6965 7273 2066 7261 6d65 776f 726b ifiers framework │ │ │ │ │ -00013cc0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ -00013cd0: 2a2a 2a2a 2a2a 2a0a 0a54 6f20 7265 6769 *******..To regi │ │ │ │ │ -00013ce0: 7374 6572 2079 6f75 7220 6f77 6e20 7665 ster your own ve │ │ │ │ │ -00013cf0: 7269 6669 6572 2063 616c 6c20 2767 7275 rifier call 'gru │ │ │ │ │ -00013d00: 625f 7665 7269 6669 6572 5f72 6567 6973 b_verifier_regis │ │ │ │ │ -00013d10: 7465 7227 2077 6974 6820 610a 7374 7275 ter' with a.stru │ │ │ │ │ -00013d20: 6374 7572 6520 706f 696e 7469 6e67 2074 cture pointing t │ │ │ │ │ -00013d30: 6f20 796f 7572 2066 756e 6374 696f 6e73 o your functions │ │ │ │ │ -00013d40: 2e0a 0a20 2020 5468 6520 696e 7465 7266 ... The interf │ │ │ │ │ -00013d50: 6163 6520 6973 2069 6e73 7069 7265 6420 ace is inspired │ │ │ │ │ -00013d60: 6279 2074 6865 2068 6173 6820 696e 7465 by the hash inte │ │ │ │ │ -00013d70: 7266 6163 6520 7769 7468 0a27 696e 6974 rface with.'init │ │ │ │ │ -00013d80: 272f 2777 7269 7465 272f 2766 696e 6927 '/'write'/'fini' │ │ │ │ │ -00013d90: 2e0a 0a20 2020 5468 6572 6520 6172 6520 ... There are │ │ │ │ │ -00013da0: 6573 7365 6e74 6961 6c6c 7920 3220 7761 essentially 2 wa │ │ │ │ │ -00013db0: 7973 206f 6620 7573 696e 6720 6974 2c20 ys of using it, │ │ │ │ │ -00013dc0: 6861 7368 696e 6720 616e 6420 7768 6f6c hashing and whol │ │ │ │ │ -00013dd0: 652d 6669 6c65 0a76 6572 6966 6963 6174 e-file.verificat │ │ │ │ │ -00013de0: 696f 6e2e 0a0a 2020 2057 6974 6820 7468 ion... With th │ │ │ │ │ -00013df0: 6520 6861 7368 696e 6720 6170 7072 6f61 e hashing approa │ │ │ │ │ -00013e00: 6368 3a20 4475 7269 6e67 2027 696e 6974 ch: During 'init │ │ │ │ │ -00013e10: 2720 796f 7520 6465 6369 6465 2077 6865 ' you decide whe │ │ │ │ │ -00013e20: 7468 6572 2079 6f75 2077 616e 740a 746f ther you want.to │ │ │ │ │ -00013e30: 2063 6865 636b 2074 6865 2067 6976 656e check the given │ │ │ │ │ -00013e40: 2066 696c 6520 616e 6420 696e 6974 2063 file and init c │ │ │ │ │ -00013e50: 6f6e 7465 7874 2e20 2049 6e20 2777 7269 ontext. In 'wri │ │ │ │ │ -00013e60: 7465 2720 796f 7520 7570 6461 7465 2079 te' you update y │ │ │ │ │ -00013e70: 6f75 720a 6861 7368 696e 6720 7374 6174 our.hashing stat │ │ │ │ │ -00013e80: 652e 2020 496e 2027 6669 6e69 2720 796f e. In 'fini' yo │ │ │ │ │ -00013e90: 7520 6368 6563 6b20 7468 6174 2074 6865 u check that the │ │ │ │ │ -00013ea0: 2068 6173 6820 6d61 7463 6865 7320 7468 hash matches th │ │ │ │ │ -00013eb0: 6520 6578 7065 6374 6564 0a76 616c 7565 e expected.value │ │ │ │ │ -00013ec0: 2f70 6173 7365 7320 736f 6d65 2063 6865 /passes some che │ │ │ │ │ -00013ed0: 636b 2f2e 2e2e 0a0a 2020 2057 6974 6820 ck/..... With │ │ │ │ │ -00013ee0: 7768 6f6c 652d 6669 6c65 2076 6572 6966 whole-file verif │ │ │ │ │ -00013ef0: 6963 6174 696f 6e3a 2044 7572 696e 6720 ication: During │ │ │ │ │ -00013f00: 2769 6e69 7427 2079 6f75 2064 6563 6964 'init' you decid │ │ │ │ │ -00013f10: 6520 7768 6574 6865 7220 796f 750a 7761 e whether you.wa │ │ │ │ │ -00013f20: 6e74 2074 6f20 6368 6563 6b20 7468 6520 nt to check the │ │ │ │ │ -00013f30: 6769 7665 6e20 6669 6c65 2061 6e64 2069 given file and i │ │ │ │ │ -00013f40: 6e69 7420 636f 6e74 6578 742e 2020 496e nit context. In │ │ │ │ │ -00013f50: 2027 7772 6974 6527 2079 6f75 2076 6572 'write' you ver │ │ │ │ │ -00013f60: 6966 790a 7468 6520 6669 6c65 2061 6e64 ify.the file and │ │ │ │ │ -00013f70: 2072 6574 7572 6e20 616e 2065 7272 6f72 return an error │ │ │ │ │ -00013f80: 2069 6620 6974 2066 6169 6c73 2e20 2059 if it fails. Y │ │ │ │ │ -00013f90: 6f75 2064 6f6e 2774 2068 6176 6520 2766 ou don't have 'f │ │ │ │ │ -00013fa0: 696e 6927 2e0a 0a20 2020 4164 6469 7469 ini'... Additi │ │ │ │ │ -00013fb0: 6f6e 616c 2027 7665 7269 6679 5f73 7472 onal 'verify_str │ │ │ │ │ -00013fc0: 696e 6727 2072 6563 6569 7665 7320 7661 ing' receives va │ │ │ │ │ -00013fd0: 7269 6f75 7320 7374 7269 6e67 7320 6c69 rious strings li │ │ │ │ │ -00013fe0: 6b65 206b 6572 6e65 6c0a 7061 7261 6d65 ke kernel.parame │ │ │ │ │ -00013ff0: 7465 7273 2074 6f20 7665 7269 6679 2e20 ters to verify. │ │ │ │ │ -00014000: 2052 6574 7572 6e69 6e67 206e 6f20 6572 Returning no er │ │ │ │ │ -00014010: 726f 7220 6d65 616e 7320 7375 6363 6573 ror means succes │ │ │ │ │ -00014020: 7366 756c 2076 6572 6966 6963 6174 696f sful verificatio │ │ │ │ │ -00014030: 6e0a 616e 6420 616e 2065 7272 6f72 2073 n.and an error s │ │ │ │ │ -00014040: 746f 7073 2074 6865 2063 7572 7265 6e74 tops the current │ │ │ │ │ -00014050: 2061 6374 696f 6e2e 0a0a 2020 2044 6574 action... Det │ │ │ │ │ -00014060: 6169 6c65 6420 6465 7363 7269 7074 696f ailed descriptio │ │ │ │ │ -00014070: 6e20 6f66 2074 6865 2041 5049 3a0a 0a20 n of the API:.. │ │ │ │ │ -00014080: 2020 4576 6572 7920 7469 6d65 2061 2066 Every time a f │ │ │ │ │ -00014090: 696c 6520 6973 206f 7065 6e65 6420 796f ile is opened yo │ │ │ │ │ -000140a0: 7572 2027 696e 6974 2720 6675 6e63 7469 ur 'init' functi │ │ │ │ │ -000140b0: 6f6e 2069 7320 6361 6c6c 6564 2077 6974 on is called wit │ │ │ │ │ -000140c0: 6820 6669 6c65 0a64 6573 6372 6970 746f h file.descripto │ │ │ │ │ -000140d0: 7220 616e 6420 6669 6c65 2074 7970 652e r and file type. │ │ │ │ │ -000140e0: 2020 596f 7572 2066 756e 6374 696f 6e20 Your function │ │ │ │ │ -000140f0: 6361 6e20 6861 7665 2074 6865 2066 6f6c can have the fol │ │ │ │ │ -00014100: 6c6f 7769 6e67 0a6f 7574 636f 6d65 733a lowing.outcomes: │ │ │ │ │ -00014110: 0a0a 2020 202a 2072 6574 7572 6e69 6e67 .. * returning │ │ │ │ │ -00014120: 206e 6f20 6572 726f 7220 616e 6420 7365 no error and se │ │ │ │ │ -00014130: 7474 696e 6720 272a 666c 6167 7327 2074 tting '*flags' t │ │ │ │ │ -00014140: 6f0a 2020 2020 2027 4752 5542 5f56 4552 o. 'GRUB_VER │ │ │ │ │ -00014150: 4946 595f 464c 4147 535f 4445 4645 525f IFY_FLAGS_DEFER_ │ │ │ │ │ -00014160: 4155 5448 272e 2020 496e 2074 6869 7320 AUTH'. In this │ │ │ │ │ -00014170: 6361 7365 2076 6572 6966 6963 6174 696f case verificatio │ │ │ │ │ -00014180: 6e20 6973 0a20 2020 2020 6465 6665 7272 n is. deferr │ │ │ │ │ -00014190: 6564 2074 6f20 6f74 6865 7220 6163 7469 ed to other acti │ │ │ │ │ -000141a0: 7665 2076 6572 6966 6965 7273 2e20 2056 ve verifiers. V │ │ │ │ │ -000141b0: 6572 6966 6963 6174 696f 6e20 6661 696c erification fail │ │ │ │ │ -000141c0: 7320 6966 206e 6f62 6f64 790a 2020 2020 s if nobody. │ │ │ │ │ -000141d0: 2063 6172 6573 206f 7220 7365 6c65 6374 cares or select │ │ │ │ │ -000141e0: 6564 2076 6572 6966 6965 7220 6661 696c ed verifier fail │ │ │ │ │ -000141f0: 732e 0a0a 2020 202a 2072 6574 7572 6e69 s... * returni │ │ │ │ │ -00014200: 6e67 206e 6f20 6572 726f 7220 616e 6420 ng no error and │ │ │ │ │ -00014210: 7365 7474 696e 6720 272a 666c 6167 7327 setting '*flags' │ │ │ │ │ -00014220: 2074 6f0a 2020 2020 2027 4752 5542 5f56 to. 'GRUB_V │ │ │ │ │ -00014230: 4552 4946 595f 464c 4147 535f 534b 4950 ERIFY_FLAGS_SKIP │ │ │ │ │ -00014240: 5f56 4552 4946 4943 4154 494f 4e27 2e20 _VERIFICATION'. │ │ │ │ │ -00014250: 2049 6e20 7468 6973 2063 6173 6520 796f In this case yo │ │ │ │ │ -00014260: 7572 2076 6572 6966 6965 720a 2020 2020 ur verifier. │ │ │ │ │ -00014270: 2077 696c 6c20 6e6f 7420 6265 2063 616c will not be cal │ │ │ │ │ -00014280: 6c65 6420 616e 796d 6f72 6520 616e 6420 led anymore and │ │ │ │ │ -00014290: 6974 2069 7320 6173 7375 6d65 6420 746f it is assumed to │ │ │ │ │ -000142a0: 2068 6176 6520 736b 6970 7065 640a 2020 have skipped. │ │ │ │ │ -000142b0: 2020 2076 6572 6966 6963 6174 696f 6e2e verification. │ │ │ │ │ -000142c0: 0a0a 2020 202a 2072 6574 7572 6e69 6e67 .. * returning │ │ │ │ │ -000142d0: 206e 6f20 6572 726f 7220 616e 6420 6e6f no error and no │ │ │ │ │ -000142e0: 7420 7365 7474 696e 6720 272a 666c 6167 t setting '*flag │ │ │ │ │ -000142f0: 7327 2074 6f0a 2020 2020 2027 4752 5542 s' to. 'GRUB │ │ │ │ │ -00014300: 5f56 4552 4946 595f 464c 4147 535f 534b _VERIFY_FLAGS_SK │ │ │ │ │ -00014310: 4950 5f56 4552 4946 4943 4154 494f 4e27 IP_VERIFICATION' │ │ │ │ │ -00014320: 2049 6e20 7468 6973 2063 6173 6520 7665 In this case ve │ │ │ │ │ -00014330: 7269 6669 6361 7469 6f6e 2069 730a 2020 rification is. │ │ │ │ │ -00014340: 2020 2064 6f6e 6520 6173 2064 6573 6372 done as descr │ │ │ │ │ -00014350: 6962 6564 2069 6e20 7468 6520 666f 6c6c ibed in the foll │ │ │ │ │ -00014360: 6f77 696e 6720 7365 6374 696f 6e2e 0a0a owing section... │ │ │ │ │ -00014370: 2020 202a 2072 6574 7572 6e69 6e67 2061 * returning a │ │ │ │ │ -00014380: 6e20 6572 726f 722e 2020 5468 656e 206f n error. Then o │ │ │ │ │ -00014390: 7065 6e69 6e67 206f 6620 7468 6520 6669 pening of the fi │ │ │ │ │ -000143a0: 6c65 2077 696c 6c20 6661 696c 2064 7565 le will fail due │ │ │ │ │ -000143b0: 2074 6f0a 2020 2020 2066 6169 6c65 6420 to. failed │ │ │ │ │ -000143c0: 7665 7269 6669 6361 7469 6f6e 2e0a 0a20 verification... │ │ │ │ │ -000143d0: 2020 496e 2074 6865 2074 6869 7264 2063 In the third c │ │ │ │ │ -000143e0: 6173 6520 796f 7572 2027 7772 6974 6527 ase your 'write' │ │ │ │ │ -000143f0: 2077 696c 6c20 6265 2063 616c 6c65 6420 will be called │ │ │ │ │ -00014400: 7769 7468 2063 6875 6e6b 7320 6f66 2074 with chunks of t │ │ │ │ │ -00014410: 6865 0a66 696c 652e 2020 4966 2079 6f75 he.file. If you │ │ │ │ │ -00014420: 206e 6565 6420 7468 6520 7768 6f6c 6520 need the whole │ │ │ │ │ -00014430: 6669 6c65 2069 6e20 6120 7369 6e67 6c65 file in a single │ │ │ │ │ -00014440: 2063 6875 6e6b 2074 6865 6e20 6475 7269 chunk then duri │ │ │ │ │ -00014450: 6e67 2027 696e 6974 270a 7365 7420 7468 ng 'init'.set th │ │ │ │ │ -00014460: 6520 6269 7420 2747 5255 425f 5645 5249 e bit 'GRUB_VERI │ │ │ │ │ -00014470: 4659 5f46 4c41 4753 5f53 494e 474c 455f FY_FLAGS_SINGLE_ │ │ │ │ │ -00014480: 4348 554e 4b27 2069 6e20 272a 666c 6167 CHUNK' in '*flag │ │ │ │ │ -00014490: 7327 2e20 2044 7572 696e 6720 2769 6e69 s'. During 'ini │ │ │ │ │ -000144a0: 7427 0a79 6f75 206d 6179 2073 6574 2027 t'.you may set ' │ │ │ │ │ -000144b0: 2a63 6f6e 7465 7874 2720 6966 2079 6f75 *context' if you │ │ │ │ │ -000144c0: 206e 6565 6420 6164 6469 7469 6f6e 616c need additional │ │ │ │ │ -000144d0: 2063 6f6e 7465 7874 2e20 2041 7420 6576 context. At ev │ │ │ │ │ -000144e0: 6572 790a 6974 6572 6174 696f 6e20 796f ery.iteration yo │ │ │ │ │ -000144f0: 7520 6d61 7920 7265 7475 726e 2061 6e20 u may return an │ │ │ │ │ -00014500: 6572 726f 7220 616e 6420 7468 6520 6669 error and the fi │ │ │ │ │ -00014510: 6c65 2077 696c 6c20 6265 2063 6f6e 7369 le will be consi │ │ │ │ │ -00014520: 6465 7265 6420 6173 0a68 6176 696e 6720 dered as.having │ │ │ │ │ -00014530: 6661 696c 6564 2074 6865 2076 6572 6966 failed the verif │ │ │ │ │ -00014540: 6963 6174 696f 6e2e 2020 4966 2079 6f75 ication. If you │ │ │ │ │ -00014550: 2072 6574 7572 6e20 6e6f 2065 7272 6f72 return no error │ │ │ │ │ -00014560: 2074 6865 6e0a 7665 7269 6669 6361 7469 then.verificati │ │ │ │ │ -00014570: 6f6e 2063 6f6e 7469 6e75 6573 2e0a 0a20 on continues... │ │ │ │ │ -00014580: 2020 4f70 7469 6f6e 616c 6c79 2061 7420 Optionally at │ │ │ │ │ -00014590: 7468 6520 656e 6420 6f66 2074 6865 2066 the end of the f │ │ │ │ │ -000145a0: 696c 6520 2766 696e 6927 2c20 6966 2069 ile 'fini', if i │ │ │ │ │ -000145b0: 7420 6578 6973 7473 2c20 6973 2063 616c t exists, is cal │ │ │ │ │ -000145c0: 6c65 640a 7769 7468 206a 7573 7420 7468 led.with just th │ │ │ │ │ -000145d0: 6520 636f 6e74 6578 742e 2020 4966 2079 e context. If y │ │ │ │ │ -000145e0: 6f75 2072 6574 7572 6e20 6e6f 2065 7272 ou return no err │ │ │ │ │ -000145f0: 6f72 2064 7572 696e 6720 616e 7920 6f66 or during any of │ │ │ │ │ -00014600: 2027 696e 6974 272c 0a27 7772 6974 6527 'init',.'write' │ │ │ │ │ -00014610: 2061 6e64 2027 6669 6e69 2720 7468 656e and 'fini' then │ │ │ │ │ -00014620: 2074 6865 2066 696c 6520 6973 2063 6f6e the file is con │ │ │ │ │ -00014630: 7369 6465 7265 6420 6173 2068 6176 696e sidered as havin │ │ │ │ │ -00014640: 6720 7375 6363 6564 6564 0a76 6572 6966 g succeded.verif │ │ │ │ │ -00014650: 6963 6174 696f 6e2e 0a0a 1f0a 4669 6c65 ication.....File │ │ │ │ │ -00014660: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ -00014670: 2020 4e6f 6465 3a20 4c6f 636b 646f 776e Node: Lockdown │ │ │ │ │ -00014680: 2066 7261 6d65 776f 726b 2c20 204e 6578 framework, Nex │ │ │ │ │ -00014690: 743a 2043 6f70 7969 6e67 2054 6869 7320 t: Copying This │ │ │ │ │ -000146a0: 4d61 6e75 616c 2c20 2050 7265 763a 2056 Manual, Prev: V │ │ │ │ │ -000146b0: 6572 6966 6965 7273 2066 7261 6d65 776f erifiers framewo │ │ │ │ │ -000146c0: 726b 2c20 2055 703a 2054 6f70 0a0a 3134 rk, Up: Top..14 │ │ │ │ │ -000146d0: 204c 6f63 6b64 6f77 6e20 6672 616d 6577 Lockdown framew │ │ │ │ │ -000146e0: 6f72 6b0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ork.************ │ │ │ │ │ -000146f0: 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 2047 *********..The G │ │ │ │ │ -00014700: 5255 4220 6361 6e20 6265 206c 6f63 6b65 RUB can be locke │ │ │ │ │ -00014710: 6420 646f 776e 2c20 7768 6963 6820 6973 d down, which is │ │ │ │ │ -00014720: 2061 2072 6573 7472 6963 7465 6420 6d6f a restricted mo │ │ │ │ │ -00014730: 6465 2077 6865 7265 2073 6f6d 650a 6f70 de where some.op │ │ │ │ │ -00014740: 6572 6174 696f 6e73 2061 7265 206e 6f74 erations are not │ │ │ │ │ -00014750: 2061 6c6c 6f77 6564 2e20 2046 6f72 2069 allowed. For i │ │ │ │ │ -00014760: 6e73 7461 6e63 652c 2073 6f6d 6520 636f nstance, some co │ │ │ │ │ -00014770: 6d6d 616e 6473 2063 616e 6e6f 7420 6265 mmands cannot be │ │ │ │ │ -00014780: 2075 7365 640a 7768 656e 2074 6865 2047 used.when the G │ │ │ │ │ -00014790: 5255 4220 6973 206c 6f63 6b65 6420 646f RUB is locked do │ │ │ │ │ -000147a0: 776e 2e0a 0a20 2020 5468 6520 6675 6e63 wn... The func │ │ │ │ │ -000147b0: 7469 6f6e 2027 6772 7562 5f6c 6f63 6b64 tion 'grub_lockd │ │ │ │ │ -000147c0: 6f77 6e28 2927 2069 7320 7573 6564 2074 own()' is used t │ │ │ │ │ -000147d0: 6f20 6c6f 636b 646f 776e 2047 5255 4220 o lockdown GRUB │ │ │ │ │ -000147e0: 616e 6420 7468 650a 6675 6e63 7469 6f6e and the.function │ │ │ │ │ -000147f0: 2027 6772 7562 5f69 735f 6c6f 636b 646f 'grub_is_lockdo │ │ │ │ │ -00014800: 776e 2829 2720 6675 6e63 7469 6f6e 2063 wn()' function c │ │ │ │ │ -00014810: 616e 2062 6520 7573 6564 2074 6f20 6368 an be used to ch │ │ │ │ │ -00014820: 6563 6b20 7768 6574 6865 720a 6c6f 636b eck whether.lock │ │ │ │ │ -00014830: 646f 776e 2069 7320 656e 6162 6c65 6420 down is enabled │ │ │ │ │ -00014840: 6f72 206e 6f74 2e20 2057 6865 6e20 656e or not. When en │ │ │ │ │ -00014850: 6162 6c65 642c 2074 6865 2066 756e 6374 abled, the funct │ │ │ │ │ -00014860: 696f 6e20 7265 7475 726e 730a 2747 5255 ion returns.'GRU │ │ │ │ │ -00014870: 425f 4c4f 434b 444f 574e 5f45 4e41 424c B_LOCKDOWN_ENABL │ │ │ │ │ -00014880: 4544 2720 616e 6420 2747 5255 425f 4c4f ED' and 'GRUB_LO │ │ │ │ │ -00014890: 434b 444f 574e 5f44 4953 4142 4c45 4427 CKDOWN_DISABLED' │ │ │ │ │ -000148a0: 2077 6865 6e20 6973 206e 6f74 0a65 6e61 when is not.ena │ │ │ │ │ -000148b0: 626c 6564 2e0a 0a20 2020 5468 6520 666f bled... The fo │ │ │ │ │ -000148c0: 6c6c 6f77 696e 6720 6675 6e63 7469 6f6e llowing function │ │ │ │ │ -000148d0: 7320 6361 6e20 6265 2075 7365 6420 746f s can be used to │ │ │ │ │ -000148e0: 2072 6567 6973 7465 7220 7468 6520 636f register the co │ │ │ │ │ -000148f0: 6d6d 616e 6473 2074 6861 7420 6361 6e0a mmands that can. │ │ │ │ │ -00014900: 6f6e 6c79 2062 6520 7573 6564 2077 6865 only be used whe │ │ │ │ │ -00014910: 6e20 6c6f 636b 646f 776e 2069 7320 6469 n lockdown is di │ │ │ │ │ -00014920: 7361 626c 6564 3a0a 0a20 2020 2a20 2767 sabled:.. * 'g │ │ │ │ │ -00014930: 7275 625f 636d 645f 6c6f 636b 646f 776e rub_cmd_lockdown │ │ │ │ │ -00014940: 2829 2720 7265 6769 7374 6572 7320 636f ()' registers co │ │ │ │ │ -00014950: 6d6d 616e 6420 7768 6963 6820 7368 6f75 mmand which shou │ │ │ │ │ -00014960: 6c64 206e 6f74 2072 756e 2077 6865 6e0a ld not run when. │ │ │ │ │ -00014970: 2020 2020 2074 6865 2047 5255 4220 6973 the GRUB is │ │ │ │ │ -00014980: 2069 6e20 6c6f 636b 646f 776e 206d 6f64 in lockdown mod │ │ │ │ │ -00014990: 652e 0a0a 2020 202a 2027 6772 7562 5f63 e... * 'grub_c │ │ │ │ │ -000149a0: 6d64 5f6c 6f63 6b64 6f77 6e28 2927 2072 md_lockdown()' r │ │ │ │ │ -000149b0: 6567 6973 7465 7273 2065 7874 656e 6465 egisters extende │ │ │ │ │ -000149c0: 6420 636f 6d6d 616e 6420 7768 6963 6820 d command which │ │ │ │ │ -000149d0: 7368 6f75 6c64 206e 6f74 0a20 2020 2020 should not. │ │ │ │ │ -000149e0: 7275 6e20 7768 656e 2074 6865 2047 5255 run when the GRU │ │ │ │ │ -000149f0: 4220 6973 2069 6e20 6c6f 636b 646f 776e B is in lockdown │ │ │ │ │ -00014a00: 206d 6f64 652e 0a0a 1f0a 4669 6c65 3a20 mode.....File: │ │ │ │ │ -00014a10: 6772 7562 2d64 6576 2e69 6e66 6f2c 2020 grub-dev.info, │ │ │ │ │ -00014a20: 4e6f 6465 3a20 436f 7079 696e 6720 5468 Node: Copying Th │ │ │ │ │ -00014a30: 6973 204d 616e 7561 6c2c 2020 4e65 7874 is Manual, Next │ │ │ │ │ -00014a40: 3a20 496e 6465 782c 2020 5072 6576 3a20 : Index, Prev: │ │ │ │ │ -00014a50: 4c6f 636b 646f 776e 2066 7261 6d65 776f Lockdown framewo │ │ │ │ │ -00014a60: 726b 2c20 2055 703a 2054 6f70 0a0a 4170 rk, Up: Top..Ap │ │ │ │ │ -00014a70: 7065 6e64 6978 2041 2043 6f70 7969 6e67 pendix A Copying │ │ │ │ │ -00014a80: 2054 6869 7320 4d61 6e75 616c 0a2a 2a2a This Manual.*** │ │ │ │ │ +00013910: 3d3d 3d3d 3d0a 0a54 6865 2074 6572 6d69 =====..The termi │ │ │ │ │ +00013920: 6e61 6c20 7769 6e64 6f77 2075 7365 6420 nal window used │ │ │ │ │ +00013930: 746f 2070 726f 7669 6465 2063 6f6d 6d61 to provide comma │ │ │ │ │ +00013940: 6e64 206c 696e 6520 6163 6365 7373 2077 nd line access w │ │ │ │ │ +00013950: 6974 6869 6e20 7468 650a 6772 6170 6869 ithin the.graphi │ │ │ │ │ +00013960: 6361 6c20 6d65 6e75 2069 7320 6d61 6e61 cal menu is mana │ │ │ │ │ +00013970: 6765 6420 6279 2027 6766 786d 656e 752f ged by 'gfxmenu/ │ │ │ │ │ +00013980: 7669 6577 2e63 272e 2020 5468 6520 2767 view.c'. The 'g │ │ │ │ │ +00013990: 6678 7465 726d 2720 7465 726d 696e 616c fxterm' terminal │ │ │ │ │ +000139a0: 0a69 7320 7573 6564 2c20 616e 6420 6974 .is used, and it │ │ │ │ │ +000139b0: 2068 6173 2062 6565 6e20 6d6f 6469 6669 has been modifi │ │ │ │ │ +000139c0: 6564 2074 6f20 616c 6c6f 7720 7265 6e64 ed to allow rend │ │ │ │ │ +000139d0: 6572 696e 6720 746f 2061 6e20 6f66 6673 ering to an offs │ │ │ │ │ +000139e0: 6372 6565 6e0a 7265 6e64 6572 2074 6172 creen.render tar │ │ │ │ │ +000139f0: 6765 7420 746f 2061 6c6c 6f77 2069 7420 get to allow it │ │ │ │ │ +00013a00: 746f 2062 6520 636f 6d70 6f73 6564 2069 to be composed i │ │ │ │ │ +00013a10: 6e74 6f20 7468 6520 646f 7562 6c65 2062 nto the double b │ │ │ │ │ +00013a20: 7566 6665 7269 6e67 0a73 7973 7465 6d20 uffering.system │ │ │ │ │ +00013a30: 7468 6174 2074 6865 2067 7261 7068 6963 that the graphic │ │ │ │ │ +00013a40: 616c 206d 656e 7520 7669 6577 2075 7365 al menu view use │ │ │ │ │ +00013a50: 732e 2020 5468 6973 2069 7320 6261 6420 s. This is bad │ │ │ │ │ +00013a60: 666f 7220 7065 7266 6f72 6d61 6e63 652c for performance, │ │ │ │ │ +00013a70: 0a68 6f77 6576 6572 2c20 736f 2069 7420 .however, so it │ │ │ │ │ +00013a80: 776f 756c 6420 7072 6f62 6162 6c79 2062 would probably b │ │ │ │ │ +00013a90: 6520 6120 676f 6f64 2069 6465 6120 746f e a good idea to │ │ │ │ │ +00013aa0: 206d 616b 6520 6974 2070 6f73 7369 626c make it possibl │ │ │ │ │ +00013ab0: 6520 746f 0a74 656d 706f 7261 7269 6c79 e to.temporarily │ │ │ │ │ +00013ac0: 2064 6973 6162 6c65 2064 6f75 626c 6520 disable double │ │ │ │ │ +00013ad0: 6275 6666 6572 696e 6720 6173 206c 6f6e buffering as lon │ │ │ │ │ +00013ae0: 6720 6173 2074 6865 2074 6572 6d69 6e61 g as the termina │ │ │ │ │ +00013af0: 6c20 7769 6e64 6f77 2069 730a 7669 7369 l window is.visi │ │ │ │ │ +00013b00: 626c 652e 2020 5468 6572 6520 6172 6520 ble. There are │ │ │ │ │ +00013b10: 7374 696c 6c20 756e 7265 736f 6c76 6564 still unresolved │ │ │ │ │ +00013b20: 2070 726f 626c 656d 7320 7468 6174 206f problems that o │ │ │ │ │ +00013b30: 6363 7572 2077 6865 6e20 636f 6d6d 616e ccur when comman │ │ │ │ │ +00013b40: 6473 0a61 7265 2065 7865 6375 7465 6420 ds.are executed │ │ │ │ │ +00013b50: 6672 6f6d 2074 6865 2074 6572 6d69 6e61 from the termina │ │ │ │ │ +00013b60: 6c20 7769 6e64 6f77 2074 6861 7420 6368 l window that ch │ │ │ │ │ +00013b70: 616e 6765 2074 6865 2067 7261 7068 6963 ange the graphic │ │ │ │ │ +00013b80: 7320 6d6f 6465 2e0a 4974 2773 2070 6f73 s mode..It's pos │ │ │ │ │ +00013b90: 7369 626c 6520 7468 6174 206d 616b 696e sible that makin │ │ │ │ │ +00013ba0: 6720 2767 7275 625f 7669 6465 6f5f 7265 g 'grub_video_re │ │ │ │ │ +00013bb0: 7374 6f72 6528 2927 2072 6574 7572 6e20 store()' return │ │ │ │ │ +00013bc0: 746f 2074 6865 2067 7261 7068 6963 730a to the graphics. │ │ │ │ │ +00013bd0: 6d6f 6465 2074 6861 7420 7761 7320 696e mode that was in │ │ │ │ │ +00013be0: 2075 7365 2062 6566 6f72 6520 2767 7275 use before 'gru │ │ │ │ │ +00013bf0: 625f 7669 6465 6f5f 7365 7475 7028 2927 b_video_setup()' │ │ │ │ │ +00013c00: 2077 6173 2063 616c 6c65 6420 6d69 6768 was called migh │ │ │ │ │ +00013c10: 7420 6669 780a 736f 6d65 206f 6620 7468 t fix.some of th │ │ │ │ │ +00013c20: 6520 7072 6f62 6c65 6d73 2e0a 0a1f 0a46 e problems.....F │ │ │ │ │ +00013c30: 696c 653a 2067 7275 622d 6465 762e 696e ile: grub-dev.in │ │ │ │ │ +00013c40: 666f 2c20 204e 6f64 653a 2056 6572 6966 fo, Node: Verif │ │ │ │ │ +00013c50: 6965 7273 2066 7261 6d65 776f 726b 2c20 iers framework, │ │ │ │ │ +00013c60: 204e 6578 743a 204c 6f63 6b64 6f77 6e20 Next: Lockdown │ │ │ │ │ +00013c70: 6672 616d 6577 6f72 6b2c 2020 5072 6576 framework, Prev │ │ │ │ │ +00013c80: 3a20 4772 6170 6869 6361 6c20 4d65 6e75 : Graphical Menu │ │ │ │ │ +00013c90: 2053 6f66 7477 6172 6520 4465 7369 676e Software Design │ │ │ │ │ +00013ca0: 2c20 2055 703a 2054 6f70 0a0a 3133 2056 , Up: Top..13 V │ │ │ │ │ +00013cb0: 6572 6966 6965 7273 2066 7261 6d65 776f erifiers framewo │ │ │ │ │ +00013cc0: 726b 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a rk.************* │ │ │ │ │ +00013cd0: 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6f20 7265 *********..To re │ │ │ │ │ +00013ce0: 6769 7374 6572 2079 6f75 7220 6f77 6e20 gister your own │ │ │ │ │ +00013cf0: 7665 7269 6669 6572 2063 616c 6c20 2767 verifier call 'g │ │ │ │ │ +00013d00: 7275 625f 7665 7269 6669 6572 5f72 6567 rub_verifier_reg │ │ │ │ │ +00013d10: 6973 7465 7227 2077 6974 6820 610a 7374 ister' with a.st │ │ │ │ │ +00013d20: 7275 6374 7572 6520 706f 696e 7469 6e67 ructure pointing │ │ │ │ │ +00013d30: 2074 6f20 796f 7572 2066 756e 6374 696f to your functio │ │ │ │ │ +00013d40: 6e73 2e0a 0a20 2020 5468 6520 696e 7465 ns... The inte │ │ │ │ │ +00013d50: 7266 6163 6520 6973 2069 6e73 7069 7265 rface is inspire │ │ │ │ │ +00013d60: 6420 6279 2074 6865 2068 6173 6820 696e d by the hash in │ │ │ │ │ +00013d70: 7465 7266 6163 6520 7769 7468 0a27 696e terface with.'in │ │ │ │ │ +00013d80: 6974 272f 2777 7269 7465 272f 2766 696e it'/'write'/'fin │ │ │ │ │ +00013d90: 6927 2e0a 0a20 2020 5468 6572 6520 6172 i'... There ar │ │ │ │ │ +00013da0: 6520 6573 7365 6e74 6961 6c6c 7920 3220 e essentially 2 │ │ │ │ │ +00013db0: 7761 7973 206f 6620 7573 696e 6720 6974 ways of using it │ │ │ │ │ +00013dc0: 2c20 6861 7368 696e 6720 616e 6420 7768 , hashing and wh │ │ │ │ │ +00013dd0: 6f6c 652d 6669 6c65 0a76 6572 6966 6963 ole-file.verific │ │ │ │ │ +00013de0: 6174 696f 6e2e 0a0a 2020 2057 6974 6820 ation... With │ │ │ │ │ +00013df0: 7468 6520 6861 7368 696e 6720 6170 7072 the hashing appr │ │ │ │ │ +00013e00: 6f61 6368 3a20 4475 7269 6e67 2027 696e oach: During 'in │ │ │ │ │ +00013e10: 6974 2720 796f 7520 6465 6369 6465 2077 it' you decide w │ │ │ │ │ +00013e20: 6865 7468 6572 2079 6f75 2077 616e 740a hether you want. │ │ │ │ │ +00013e30: 746f 2063 6865 636b 2074 6865 2067 6976 to check the giv │ │ │ │ │ +00013e40: 656e 2066 696c 6520 616e 6420 696e 6974 en file and init │ │ │ │ │ +00013e50: 2063 6f6e 7465 7874 2e20 2049 6e20 2777 context. In 'w │ │ │ │ │ +00013e60: 7269 7465 2720 796f 7520 7570 6461 7465 rite' you update │ │ │ │ │ +00013e70: 2079 6f75 720a 6861 7368 696e 6720 7374 your.hashing st │ │ │ │ │ +00013e80: 6174 652e 2020 496e 2027 6669 6e69 2720 ate. In 'fini' │ │ │ │ │ +00013e90: 796f 7520 6368 6563 6b20 7468 6174 2074 you check that t │ │ │ │ │ +00013ea0: 6865 2068 6173 6820 6d61 7463 6865 7320 he hash matches │ │ │ │ │ +00013eb0: 7468 6520 6578 7065 6374 6564 0a76 616c the expected.val │ │ │ │ │ +00013ec0: 7565 2f70 6173 7365 7320 736f 6d65 2063 ue/passes some c │ │ │ │ │ +00013ed0: 6865 636b 2f2e 2e2e 0a0a 2020 2057 6974 heck/..... Wit │ │ │ │ │ +00013ee0: 6820 7768 6f6c 652d 6669 6c65 2076 6572 h whole-file ver │ │ │ │ │ +00013ef0: 6966 6963 6174 696f 6e3a 2044 7572 696e ification: Durin │ │ │ │ │ +00013f00: 6720 2769 6e69 7427 2079 6f75 2064 6563 g 'init' you dec │ │ │ │ │ +00013f10: 6964 6520 7768 6574 6865 7220 796f 750a ide whether you. │ │ │ │ │ +00013f20: 7761 6e74 2074 6f20 6368 6563 6b20 7468 want to check th │ │ │ │ │ +00013f30: 6520 6769 7665 6e20 6669 6c65 2061 6e64 e given file and │ │ │ │ │ +00013f40: 2069 6e69 7420 636f 6e74 6578 742e 2020 init context. │ │ │ │ │ +00013f50: 496e 2027 7772 6974 6527 2079 6f75 2076 In 'write' you v │ │ │ │ │ +00013f60: 6572 6966 790a 7468 6520 6669 6c65 2061 erify.the file a │ │ │ │ │ +00013f70: 6e64 2072 6574 7572 6e20 616e 2065 7272 nd return an err │ │ │ │ │ +00013f80: 6f72 2069 6620 6974 2066 6169 6c73 2e20 or if it fails. │ │ │ │ │ +00013f90: 2059 6f75 2064 6f6e 2774 2068 6176 6520 You don't have │ │ │ │ │ +00013fa0: 2766 696e 6927 2e0a 0a20 2020 4164 6469 'fini'... Addi │ │ │ │ │ +00013fb0: 7469 6f6e 616c 2027 7665 7269 6679 5f73 tional 'verify_s │ │ │ │ │ +00013fc0: 7472 696e 6727 2072 6563 6569 7665 7320 tring' receives │ │ │ │ │ +00013fd0: 7661 7269 6f75 7320 7374 7269 6e67 7320 various strings │ │ │ │ │ +00013fe0: 6c69 6b65 206b 6572 6e65 6c0a 7061 7261 like kernel.para │ │ │ │ │ +00013ff0: 6d65 7465 7273 2074 6f20 7665 7269 6679 meters to verify │ │ │ │ │ +00014000: 2e20 2052 6574 7572 6e69 6e67 206e 6f20 . Returning no │ │ │ │ │ +00014010: 6572 726f 7220 6d65 616e 7320 7375 6363 error means succ │ │ │ │ │ +00014020: 6573 7366 756c 2076 6572 6966 6963 6174 essful verificat │ │ │ │ │ +00014030: 696f 6e0a 616e 6420 616e 2065 7272 6f72 ion.and an error │ │ │ │ │ +00014040: 2073 746f 7073 2074 6865 2063 7572 7265 stops the curre │ │ │ │ │ +00014050: 6e74 2061 6374 696f 6e2e 0a0a 2020 2044 nt action... D │ │ │ │ │ +00014060: 6574 6169 6c65 6420 6465 7363 7269 7074 etailed descript │ │ │ │ │ +00014070: 696f 6e20 6f66 2074 6865 2041 5049 3a0a ion of the API:. │ │ │ │ │ +00014080: 0a20 2020 4576 6572 7920 7469 6d65 2061 . Every time a │ │ │ │ │ +00014090: 2066 696c 6520 6973 206f 7065 6e65 6420 file is opened │ │ │ │ │ +000140a0: 796f 7572 2027 696e 6974 2720 6675 6e63 your 'init' func │ │ │ │ │ +000140b0: 7469 6f6e 2069 7320 6361 6c6c 6564 2077 tion is called w │ │ │ │ │ +000140c0: 6974 6820 6669 6c65 0a64 6573 6372 6970 ith file.descrip │ │ │ │ │ +000140d0: 746f 7220 616e 6420 6669 6c65 2074 7970 tor and file typ │ │ │ │ │ +000140e0: 652e 2020 596f 7572 2066 756e 6374 696f e. Your functio │ │ │ │ │ +000140f0: 6e20 6361 6e20 6861 7665 2074 6865 2066 n can have the f │ │ │ │ │ +00014100: 6f6c 6c6f 7769 6e67 0a6f 7574 636f 6d65 ollowing.outcome │ │ │ │ │ +00014110: 733a 0a0a 2020 202a 2072 6574 7572 6e69 s:.. * returni │ │ │ │ │ +00014120: 6e67 206e 6f20 6572 726f 7220 616e 6420 ng no error and │ │ │ │ │ +00014130: 7365 7474 696e 6720 272a 666c 6167 7327 setting '*flags' │ │ │ │ │ +00014140: 2074 6f0a 2020 2020 2027 4752 5542 5f56 to. 'GRUB_V │ │ │ │ │ +00014150: 4552 4946 595f 464c 4147 535f 4445 4645 ERIFY_FLAGS_DEFE │ │ │ │ │ +00014160: 525f 4155 5448 272e 2020 496e 2074 6869 R_AUTH'. In thi │ │ │ │ │ +00014170: 7320 6361 7365 2076 6572 6966 6963 6174 s case verificat │ │ │ │ │ +00014180: 696f 6e20 6973 0a20 2020 2020 6465 6665 ion is. defe │ │ │ │ │ +00014190: 7272 6564 2074 6f20 6f74 6865 7220 6163 rred to other ac │ │ │ │ │ +000141a0: 7469 7665 2076 6572 6966 6965 7273 2e20 tive verifiers. │ │ │ │ │ +000141b0: 2056 6572 6966 6963 6174 696f 6e20 6661 Verification fa │ │ │ │ │ +000141c0: 696c 7320 6966 206e 6f62 6f64 790a 2020 ils if nobody. │ │ │ │ │ +000141d0: 2020 2063 6172 6573 206f 7220 7365 6c65 cares or sele │ │ │ │ │ +000141e0: 6374 6564 2076 6572 6966 6965 7220 6661 cted verifier fa │ │ │ │ │ +000141f0: 696c 732e 0a0a 2020 202a 2072 6574 7572 ils... * retur │ │ │ │ │ +00014200: 6e69 6e67 206e 6f20 6572 726f 7220 616e ning no error an │ │ │ │ │ +00014210: 6420 7365 7474 696e 6720 272a 666c 6167 d setting '*flag │ │ │ │ │ +00014220: 7327 2074 6f0a 2020 2020 2027 4752 5542 s' to. 'GRUB │ │ │ │ │ +00014230: 5f56 4552 4946 595f 464c 4147 535f 534b _VERIFY_FLAGS_SK │ │ │ │ │ +00014240: 4950 5f56 4552 4946 4943 4154 494f 4e27 IP_VERIFICATION' │ │ │ │ │ +00014250: 2e20 2049 6e20 7468 6973 2063 6173 6520 . In this case │ │ │ │ │ +00014260: 796f 7572 2076 6572 6966 6965 720a 2020 your verifier. │ │ │ │ │ +00014270: 2020 2077 696c 6c20 6e6f 7420 6265 2063 will not be c │ │ │ │ │ +00014280: 616c 6c65 6420 616e 796d 6f72 6520 616e alled anymore an │ │ │ │ │ +00014290: 6420 6974 2069 7320 6173 7375 6d65 6420 d it is assumed │ │ │ │ │ +000142a0: 746f 2068 6176 6520 736b 6970 7065 640a to have skipped. │ │ │ │ │ +000142b0: 2020 2020 2076 6572 6966 6963 6174 696f verificatio │ │ │ │ │ +000142c0: 6e2e 0a0a 2020 202a 2072 6574 7572 6e69 n... * returni │ │ │ │ │ +000142d0: 6e67 206e 6f20 6572 726f 7220 616e 6420 ng no error and │ │ │ │ │ +000142e0: 6e6f 7420 7365 7474 696e 6720 272a 666c not setting '*fl │ │ │ │ │ +000142f0: 6167 7327 2074 6f0a 2020 2020 2027 4752 ags' to. 'GR │ │ │ │ │ +00014300: 5542 5f56 4552 4946 595f 464c 4147 535f UB_VERIFY_FLAGS_ │ │ │ │ │ +00014310: 534b 4950 5f56 4552 4946 4943 4154 494f SKIP_VERIFICATIO │ │ │ │ │ +00014320: 4e27 2049 6e20 7468 6973 2063 6173 6520 N' In this case │ │ │ │ │ +00014330: 7665 7269 6669 6361 7469 6f6e 2069 730a verification is. │ │ │ │ │ +00014340: 2020 2020 2064 6f6e 6520 6173 2064 6573 done as des │ │ │ │ │ +00014350: 6372 6962 6564 2069 6e20 7468 6520 666f cribed in the fo │ │ │ │ │ +00014360: 6c6c 6f77 696e 6720 7365 6374 696f 6e2e llowing section. │ │ │ │ │ +00014370: 0a0a 2020 202a 2072 6574 7572 6e69 6e67 .. * returning │ │ │ │ │ +00014380: 2061 6e20 6572 726f 722e 2020 5468 656e an error. Then │ │ │ │ │ +00014390: 206f 7065 6e69 6e67 206f 6620 7468 6520 opening of the │ │ │ │ │ +000143a0: 6669 6c65 2077 696c 6c20 6661 696c 2064 file will fail d │ │ │ │ │ +000143b0: 7565 2074 6f0a 2020 2020 2066 6169 6c65 ue to. faile │ │ │ │ │ +000143c0: 6420 7665 7269 6669 6361 7469 6f6e 2e0a d verification.. │ │ │ │ │ +000143d0: 0a20 2020 496e 2074 6865 2074 6869 7264 . In the third │ │ │ │ │ +000143e0: 2063 6173 6520 796f 7572 2027 7772 6974 case your 'writ │ │ │ │ │ +000143f0: 6527 2077 696c 6c20 6265 2063 616c 6c65 e' will be calle │ │ │ │ │ +00014400: 6420 7769 7468 2063 6875 6e6b 7320 6f66 d with chunks of │ │ │ │ │ +00014410: 2074 6865 0a66 696c 652e 2020 4966 2079 the.file. If y │ │ │ │ │ +00014420: 6f75 206e 6565 6420 7468 6520 7768 6f6c ou need the whol │ │ │ │ │ +00014430: 6520 6669 6c65 2069 6e20 6120 7369 6e67 e file in a sing │ │ │ │ │ +00014440: 6c65 2063 6875 6e6b 2074 6865 6e20 6475 le chunk then du │ │ │ │ │ +00014450: 7269 6e67 2027 696e 6974 270a 7365 7420 ring 'init'.set │ │ │ │ │ +00014460: 7468 6520 6269 7420 2747 5255 425f 5645 the bit 'GRUB_VE │ │ │ │ │ +00014470: 5249 4659 5f46 4c41 4753 5f53 494e 474c RIFY_FLAGS_SINGL │ │ │ │ │ +00014480: 455f 4348 554e 4b27 2069 6e20 272a 666c E_CHUNK' in '*fl │ │ │ │ │ +00014490: 6167 7327 2e20 2044 7572 696e 6720 2769 ags'. During 'i │ │ │ │ │ +000144a0: 6e69 7427 0a79 6f75 206d 6179 2073 6574 nit'.you may set │ │ │ │ │ +000144b0: 2027 2a63 6f6e 7465 7874 2720 6966 2079 '*context' if y │ │ │ │ │ +000144c0: 6f75 206e 6565 6420 6164 6469 7469 6f6e ou need addition │ │ │ │ │ +000144d0: 616c 2063 6f6e 7465 7874 2e20 2041 7420 al context. At │ │ │ │ │ +000144e0: 6576 6572 790a 6974 6572 6174 696f 6e20 every.iteration │ │ │ │ │ +000144f0: 796f 7520 6d61 7920 7265 7475 726e 2061 you may return a │ │ │ │ │ +00014500: 6e20 6572 726f 7220 616e 6420 7468 6520 n error and the │ │ │ │ │ +00014510: 6669 6c65 2077 696c 6c20 6265 2063 6f6e file will be con │ │ │ │ │ +00014520: 7369 6465 7265 6420 6173 0a68 6176 696e sidered as.havin │ │ │ │ │ +00014530: 6720 6661 696c 6564 2074 6865 2076 6572 g failed the ver │ │ │ │ │ +00014540: 6966 6963 6174 696f 6e2e 2020 4966 2079 ification. If y │ │ │ │ │ +00014550: 6f75 2072 6574 7572 6e20 6e6f 2065 7272 ou return no err │ │ │ │ │ +00014560: 6f72 2074 6865 6e0a 7665 7269 6669 6361 or then.verifica │ │ │ │ │ +00014570: 7469 6f6e 2063 6f6e 7469 6e75 6573 2e0a tion continues.. │ │ │ │ │ +00014580: 0a20 2020 4f70 7469 6f6e 616c 6c79 2061 . Optionally a │ │ │ │ │ +00014590: 7420 7468 6520 656e 6420 6f66 2074 6865 t the end of the │ │ │ │ │ +000145a0: 2066 696c 6520 2766 696e 6927 2c20 6966 file 'fini', if │ │ │ │ │ +000145b0: 2069 7420 6578 6973 7473 2c20 6973 2063 it exists, is c │ │ │ │ │ +000145c0: 616c 6c65 640a 7769 7468 206a 7573 7420 alled.with just │ │ │ │ │ +000145d0: 7468 6520 636f 6e74 6578 742e 2020 4966 the context. If │ │ │ │ │ +000145e0: 2079 6f75 2072 6574 7572 6e20 6e6f 2065 you return no e │ │ │ │ │ +000145f0: 7272 6f72 2064 7572 696e 6720 616e 7920 rror during any │ │ │ │ │ +00014600: 6f66 2027 696e 6974 272c 0a27 7772 6974 of 'init',.'writ │ │ │ │ │ +00014610: 6527 2061 6e64 2027 6669 6e69 2720 7468 e' and 'fini' th │ │ │ │ │ +00014620: 656e 2074 6865 2066 696c 6520 6973 2063 en the file is c │ │ │ │ │ +00014630: 6f6e 7369 6465 7265 6420 6173 2068 6176 onsidered as hav │ │ │ │ │ +00014640: 696e 6720 7375 6363 6564 6564 0a76 6572 ing succeded.ver │ │ │ │ │ +00014650: 6966 6963 6174 696f 6e2e 0a0a 1f0a 4669 ification.....Fi │ │ │ │ │ +00014660: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ +00014670: 6f2c 2020 4e6f 6465 3a20 4c6f 636b 646f o, Node: Lockdo │ │ │ │ │ +00014680: 776e 2066 7261 6d65 776f 726b 2c20 204e wn framework, N │ │ │ │ │ +00014690: 6578 743a 2043 6f70 7969 6e67 2054 6869 ext: Copying Thi │ │ │ │ │ +000146a0: 7320 4d61 6e75 616c 2c20 2050 7265 763a s Manual, Prev: │ │ │ │ │ +000146b0: 2056 6572 6966 6965 7273 2066 7261 6d65 Verifiers frame │ │ │ │ │ +000146c0: 776f 726b 2c20 2055 703a 2054 6f70 0a0a work, Up: Top.. │ │ │ │ │ +000146d0: 3134 204c 6f63 6b64 6f77 6e20 6672 616d 14 Lockdown fram │ │ │ │ │ +000146e0: 6577 6f72 6b0a 2a2a 2a2a 2a2a 2a2a 2a2a ework.********** │ │ │ │ │ +000146f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 ***********..The │ │ │ │ │ +00014700: 2047 5255 4220 6361 6e20 6265 206c 6f63 GRUB can be loc │ │ │ │ │ +00014710: 6b65 6420 646f 776e 2c20 7768 6963 6820 ked down, which │ │ │ │ │ +00014720: 6973 2061 2072 6573 7472 6963 7465 6420 is a restricted │ │ │ │ │ +00014730: 6d6f 6465 2077 6865 7265 2073 6f6d 650a mode where some. │ │ │ │ │ +00014740: 6f70 6572 6174 696f 6e73 2061 7265 206e operations are n │ │ │ │ │ +00014750: 6f74 2061 6c6c 6f77 6564 2e20 2046 6f72 ot allowed. For │ │ │ │ │ +00014760: 2069 6e73 7461 6e63 652c 2073 6f6d 6520 instance, some │ │ │ │ │ +00014770: 636f 6d6d 616e 6473 2063 616e 6e6f 7420 commands cannot │ │ │ │ │ +00014780: 6265 2075 7365 640a 7768 656e 2074 6865 be used.when the │ │ │ │ │ +00014790: 2047 5255 4220 6973 206c 6f63 6b65 6420 GRUB is locked │ │ │ │ │ +000147a0: 646f 776e 2e0a 0a20 2020 5468 6520 6675 down... The fu │ │ │ │ │ +000147b0: 6e63 7469 6f6e 2027 6772 7562 5f6c 6f63 nction 'grub_loc │ │ │ │ │ +000147c0: 6b64 6f77 6e28 2927 2069 7320 7573 6564 kdown()' is used │ │ │ │ │ +000147d0: 2074 6f20 6c6f 636b 646f 776e 2047 5255 to lockdown GRU │ │ │ │ │ +000147e0: 4220 616e 6420 7468 650a 6675 6e63 7469 B and the.functi │ │ │ │ │ +000147f0: 6f6e 2027 6772 7562 5f69 735f 6c6f 636b on 'grub_is_lock │ │ │ │ │ +00014800: 646f 776e 2829 2720 6675 6e63 7469 6f6e down()' function │ │ │ │ │ +00014810: 2063 616e 2062 6520 7573 6564 2074 6f20 can be used to │ │ │ │ │ +00014820: 6368 6563 6b20 7768 6574 6865 720a 6c6f check whether.lo │ │ │ │ │ +00014830: 636b 646f 776e 2069 7320 656e 6162 6c65 ckdown is enable │ │ │ │ │ +00014840: 6420 6f72 206e 6f74 2e20 2057 6865 6e20 d or not. When │ │ │ │ │ +00014850: 656e 6162 6c65 642c 2074 6865 2066 756e enabled, the fun │ │ │ │ │ +00014860: 6374 696f 6e20 7265 7475 726e 730a 2747 ction returns.'G │ │ │ │ │ +00014870: 5255 425f 4c4f 434b 444f 574e 5f45 4e41 RUB_LOCKDOWN_ENA │ │ │ │ │ +00014880: 424c 4544 2720 616e 6420 2747 5255 425f BLED' and 'GRUB_ │ │ │ │ │ +00014890: 4c4f 434b 444f 574e 5f44 4953 4142 4c45 LOCKDOWN_DISABLE │ │ │ │ │ +000148a0: 4427 2077 6865 6e20 6973 206e 6f74 0a65 D' when is not.e │ │ │ │ │ +000148b0: 6e61 626c 6564 2e0a 0a20 2020 5468 6520 nabled... The │ │ │ │ │ +000148c0: 666f 6c6c 6f77 696e 6720 6675 6e63 7469 following functi │ │ │ │ │ +000148d0: 6f6e 7320 6361 6e20 6265 2075 7365 6420 ons can be used │ │ │ │ │ +000148e0: 746f 2072 6567 6973 7465 7220 7468 6520 to register the │ │ │ │ │ +000148f0: 636f 6d6d 616e 6473 2074 6861 7420 6361 commands that ca │ │ │ │ │ +00014900: 6e0a 6f6e 6c79 2062 6520 7573 6564 2077 n.only be used w │ │ │ │ │ +00014910: 6865 6e20 6c6f 636b 646f 776e 2069 7320 hen lockdown is │ │ │ │ │ +00014920: 6469 7361 626c 6564 3a0a 0a20 2020 2a20 disabled:.. * │ │ │ │ │ +00014930: 2767 7275 625f 636d 645f 6c6f 636b 646f 'grub_cmd_lockdo │ │ │ │ │ +00014940: 776e 2829 2720 7265 6769 7374 6572 7320 wn()' registers │ │ │ │ │ +00014950: 636f 6d6d 616e 6420 7768 6963 6820 7368 command which sh │ │ │ │ │ +00014960: 6f75 6c64 206e 6f74 2072 756e 2077 6865 ould not run whe │ │ │ │ │ +00014970: 6e0a 2020 2020 2074 6865 2047 5255 4220 n. the GRUB │ │ │ │ │ +00014980: 6973 2069 6e20 6c6f 636b 646f 776e 206d is in lockdown m │ │ │ │ │ +00014990: 6f64 652e 0a0a 2020 202a 2027 6772 7562 ode... * 'grub │ │ │ │ │ +000149a0: 5f63 6d64 5f6c 6f63 6b64 6f77 6e28 2927 _cmd_lockdown()' │ │ │ │ │ +000149b0: 2072 6567 6973 7465 7273 2065 7874 656e registers exten │ │ │ │ │ +000149c0: 6465 6420 636f 6d6d 616e 6420 7768 6963 ded command whic │ │ │ │ │ +000149d0: 6820 7368 6f75 6c64 206e 6f74 0a20 2020 h should not. │ │ │ │ │ +000149e0: 2020 7275 6e20 7768 656e 2074 6865 2047 run when the G │ │ │ │ │ +000149f0: 5255 4220 6973 2069 6e20 6c6f 636b 646f RUB is in lockdo │ │ │ │ │ +00014a00: 776e 206d 6f64 652e 0a0a 1f0a 4669 6c65 wn mode.....File │ │ │ │ │ +00014a10: 3a20 6772 7562 2d64 6576 2e69 6e66 6f2c : grub-dev.info, │ │ │ │ │ +00014a20: 2020 4e6f 6465 3a20 436f 7079 696e 6720 Node: Copying │ │ │ │ │ +00014a30: 5468 6973 204d 616e 7561 6c2c 2020 4e65 This Manual, Ne │ │ │ │ │ +00014a40: 7874 3a20 496e 6465 782c 2020 5072 6576 xt: Index, Prev │ │ │ │ │ +00014a50: 3a20 4c6f 636b 646f 776e 2066 7261 6d65 : Lockdown frame │ │ │ │ │ +00014a60: 776f 726b 2c20 2055 703a 2054 6f70 0a0a work, Up: Top.. │ │ │ │ │ +00014a70: 4170 7065 6e64 6978 2041 2043 6f70 7969 Appendix A Copyi │ │ │ │ │ +00014a80: 6e67 2054 6869 7320 4d61 6e75 616c 0a2a ng This Manual.* │ │ │ │ │ 00014a90: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00014aa0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a 204d ***********..* M │ │ │ │ │ -00014ab0: 656e 753a 0a0a 2a20 474e 5520 4672 6565 enu:..* GNU Free │ │ │ │ │ -00014ac0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00014ad0: 6963 656e 7365 3a3a 2020 4c69 6365 6e73 icense:: Licens │ │ │ │ │ -00014ae0: 6520 666f 7220 636f 7079 696e 6720 7468 e for copying th │ │ │ │ │ -00014af0: 6973 206d 616e 7561 6c2e 0a0a 1f0a 4669 is manual.....Fi │ │ │ │ │ -00014b00: 6c65 3a20 6772 7562 2d64 6576 2e69 6e66 le: grub-dev.inf │ │ │ │ │ -00014b10: 6f2c 2020 4e6f 6465 3a20 474e 5520 4672 o, Node: GNU Fr │ │ │ │ │ -00014b20: 6565 2044 6f63 756d 656e 7461 7469 6f6e ee Documentation │ │ │ │ │ -00014b30: 204c 6963 656e 7365 2c20 2055 703a 2043 License, Up: C │ │ │ │ │ -00014b40: 6f70 7969 6e67 2054 6869 7320 4d61 6e75 opying This Manu │ │ │ │ │ -00014b50: 616c 0a0a 412e 3120 474e 5520 4672 6565 al..A.1 GNU Free │ │ │ │ │ -00014b60: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ -00014b70: 6963 656e 7365 0a3d 3d3d 3d3d 3d3d 3d3d icense.========= │ │ │ │ │ +00014aa0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a *************..* │ │ │ │ │ +00014ab0: 204d 656e 753a 0a0a 2a20 474e 5520 4672 Menu:..* GNU Fr │ │ │ │ │ +00014ac0: 6565 2044 6f63 756d 656e 7461 7469 6f6e ee Documentation │ │ │ │ │ +00014ad0: 204c 6963 656e 7365 3a3a 2020 4c69 6365 License:: Lice │ │ │ │ │ +00014ae0: 6e73 6520 666f 7220 636f 7079 696e 6720 nse for copying │ │ │ │ │ +00014af0: 7468 6973 206d 616e 7561 6c2e 0a0a 1f0a this manual..... │ │ │ │ │ +00014b00: 4669 6c65 3a20 6772 7562 2d64 6576 2e69 File: grub-dev.i │ │ │ │ │ +00014b10: 6e66 6f2c 2020 4e6f 6465 3a20 474e 5520 nfo, Node: GNU │ │ │ │ │ +00014b20: 4672 6565 2044 6f63 756d 656e 7461 7469 Free Documentati │ │ │ │ │ +00014b30: 6f6e 204c 6963 656e 7365 2c20 2055 703a on License, Up: │ │ │ │ │ +00014b40: 2043 6f70 7969 6e67 2054 6869 7320 4d61 Copying This Ma │ │ │ │ │ +00014b50: 6e75 616c 0a0a 412e 3120 474e 5520 4672 nual..A.1 GNU Fr │ │ │ │ │ +00014b60: 6565 2044 6f63 756d 656e 7461 7469 6f6e ee Documentation │ │ │ │ │ +00014b70: 204c 6963 656e 7365 0a3d 3d3d 3d3d 3d3d License.======= │ │ │ │ │ 00014b80: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00014b90: 3d3d 3d3d 3d3d 3d3d 3d0a 0a20 2020 2020 =========.. │ │ │ │ │ +00014b90: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a20 2020 ===========.. │ │ │ │ │ 00014ba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00014bb0: 2056 6572 7369 6f6e 2031 2e32 2c20 4e6f Version 1.2, No │ │ │ │ │ -00014bc0: 7665 6d62 6572 2032 3030 320a 0a20 2020 vember 2002.. │ │ │ │ │ -00014bd0: 2020 436f 7079 7269 6768 7420 2843 2920 Copyright (C) │ │ │ │ │ -00014be0: 3230 3030 2c32 3030 312c 3230 3032 2046 2000,2001,2002 F │ │ │ │ │ -00014bf0: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ │ │ -00014c00: 6e64 6174 696f 6e2c 2049 6e63 2e0a 2020 ndation, Inc.. │ │ │ │ │ -00014c10: 2020 2035 3120 4672 616e 6b6c 696e 2053 51 Franklin S │ │ │ │ │ -00014c20: 742c 2046 6966 7468 2046 6c6f 6f72 2c20 t, Fifth Floor, │ │ │ │ │ -00014c30: 426f 7374 6f6e 2c20 4d41 2020 3032 3131 Boston, MA 0211 │ │ │ │ │ -00014c40: 302d 3133 3031 2c20 5553 410a 0a20 2020 0-1301, USA.. │ │ │ │ │ -00014c50: 2020 4576 6572 796f 6e65 2069 7320 7065 Everyone is pe │ │ │ │ │ -00014c60: 726d 6974 7465 6420 746f 2063 6f70 7920 rmitted to copy │ │ │ │ │ -00014c70: 616e 6420 6469 7374 7269 6275 7465 2076 and distribute v │ │ │ │ │ -00014c80: 6572 6261 7469 6d20 636f 7069 6573 0a20 erbatim copies. │ │ │ │ │ -00014c90: 2020 2020 6f66 2074 6869 7320 6c69 6365 of this lice │ │ │ │ │ -00014ca0: 6e73 6520 646f 6375 6d65 6e74 2c20 6275 nse document, bu │ │ │ │ │ -00014cb0: 7420 6368 616e 6769 6e67 2069 7420 6973 t changing it is │ │ │ │ │ -00014cc0: 206e 6f74 2061 6c6c 6f77 6564 2e0a 0a20 not allowed... │ │ │ │ │ -00014cd0: 2030 2e20 5052 4541 4d42 4c45 0a0a 2020 0. PREAMBLE.. │ │ │ │ │ -00014ce0: 2020 2054 6865 2070 7572 706f 7365 206f The purpose o │ │ │ │ │ -00014cf0: 6620 7468 6973 204c 6963 656e 7365 2069 f this License i │ │ │ │ │ -00014d00: 7320 746f 206d 616b 6520 6120 6d61 6e75 s to make a manu │ │ │ │ │ -00014d10: 616c 2c20 7465 7874 626f 6f6b 2c20 6f72 al, textbook, or │ │ │ │ │ -00014d20: 206f 7468 6572 0a20 2020 2020 6675 6e63 other. func │ │ │ │ │ -00014d30: 7469 6f6e 616c 2061 6e64 2075 7365 6675 tional and usefu │ │ │ │ │ -00014d40: 6c20 646f 6375 6d65 6e74 2022 6672 6565 l document "free │ │ │ │ │ -00014d50: 2220 696e 2074 6865 2073 656e 7365 206f " in the sense o │ │ │ │ │ -00014d60: 6620 6672 6565 646f 6d3a 2074 6f0a 2020 f freedom: to. │ │ │ │ │ -00014d70: 2020 2061 7373 7572 6520 6576 6572 796f assure everyo │ │ │ │ │ -00014d80: 6e65 2074 6865 2065 6666 6563 7469 7665 ne the effective │ │ │ │ │ -00014d90: 2066 7265 6564 6f6d 2074 6f20 636f 7079 freedom to copy │ │ │ │ │ -00014da0: 2061 6e64 2072 6564 6973 7472 6962 7574 and redistribut │ │ │ │ │ -00014db0: 6520 6974 2c0a 2020 2020 2077 6974 6820 e it,. with │ │ │ │ │ -00014dc0: 6f72 2077 6974 686f 7574 206d 6f64 6966 or without modif │ │ │ │ │ -00014dd0: 7969 6e67 2069 742c 2065 6974 6865 7220 ying it, either │ │ │ │ │ -00014de0: 636f 6d6d 6572 6369 616c 6c79 206f 720a commercially or. │ │ │ │ │ -00014df0: 2020 2020 206e 6f6e 636f 6d6d 6572 6369 noncommerci │ │ │ │ │ -00014e00: 616c 6c79 2e20 2053 6563 6f6e 6461 7269 ally. Secondari │ │ │ │ │ -00014e10: 6c79 2c20 7468 6973 204c 6963 656e 7365 ly, this License │ │ │ │ │ -00014e20: 2070 7265 7365 7276 6573 2066 6f72 2074 preserves for t │ │ │ │ │ -00014e30: 6865 0a20 2020 2020 6175 7468 6f72 2061 he. author a │ │ │ │ │ -00014e40: 6e64 2070 7562 6c69 7368 6572 2061 2077 nd publisher a w │ │ │ │ │ -00014e50: 6179 2074 6f20 6765 7420 6372 6564 6974 ay to get credit │ │ │ │ │ -00014e60: 2066 6f72 2074 6865 6972 2077 6f72 6b2c for their work, │ │ │ │ │ -00014e70: 2077 6869 6c65 206e 6f74 0a20 2020 2020 while not. │ │ │ │ │ -00014e80: 6265 696e 6720 636f 6e73 6964 6572 6564 being considered │ │ │ │ │ -00014e90: 2072 6573 706f 6e73 6962 6c65 2066 6f72 responsible for │ │ │ │ │ -00014ea0: 206d 6f64 6966 6963 6174 696f 6e73 206d modifications m │ │ │ │ │ -00014eb0: 6164 6520 6279 206f 7468 6572 732e 0a0a ade by others... │ │ │ │ │ -00014ec0: 2020 2020 2054 6869 7320 4c69 6365 6e73 This Licens │ │ │ │ │ -00014ed0: 6520 6973 2061 206b 696e 6420 6f66 2022 e is a kind of " │ │ │ │ │ -00014ee0: 636f 7079 6c65 6674 222c 2077 6869 6368 copyleft", which │ │ │ │ │ -00014ef0: 206d 6561 6e73 2074 6861 7420 6465 7269 means that deri │ │ │ │ │ -00014f00: 7661 7469 7665 0a20 2020 2020 776f 726b vative. work │ │ │ │ │ -00014f10: 7320 6f66 2074 6865 2064 6f63 756d 656e s of the documen │ │ │ │ │ -00014f20: 7420 6d75 7374 2074 6865 6d73 656c 7665 t must themselve │ │ │ │ │ -00014f30: 7320 6265 2066 7265 6520 696e 2074 6865 s be free in the │ │ │ │ │ -00014f40: 2073 616d 6520 7365 6e73 652e 0a20 2020 same sense.. │ │ │ │ │ -00014f50: 2020 4974 2063 6f6d 706c 656d 656e 7473 It complements │ │ │ │ │ -00014f60: 2074 6865 2047 4e55 2047 656e 6572 616c the GNU General │ │ │ │ │ -00014f70: 2050 7562 6c69 6320 4c69 6365 6e73 652c Public License, │ │ │ │ │ -00014f80: 2077 6869 6368 2069 7320 6120 636f 7079 which is a copy │ │ │ │ │ -00014f90: 6c65 6674 0a20 2020 2020 6c69 6365 6e73 left. licens │ │ │ │ │ -00014fa0: 6520 6465 7369 676e 6564 2066 6f72 2066 e designed for f │ │ │ │ │ -00014fb0: 7265 6520 736f 6674 7761 7265 2e0a 0a20 ree software... │ │ │ │ │ -00014fc0: 2020 2020 5765 2068 6176 6520 6465 7369 We have desi │ │ │ │ │ -00014fd0: 676e 6564 2074 6869 7320 4c69 6365 6e73 gned this Licens │ │ │ │ │ -00014fe0: 6520 696e 206f 7264 6572 2074 6f20 7573 e in order to us │ │ │ │ │ -00014ff0: 6520 6974 2066 6f72 206d 616e 7561 6c73 e it for manuals │ │ │ │ │ -00015000: 2066 6f72 0a20 2020 2020 6672 6565 2073 for. free s │ │ │ │ │ -00015010: 6f66 7477 6172 652c 2062 6563 6175 7365 oftware, because │ │ │ │ │ -00015020: 2066 7265 6520 736f 6674 7761 7265 206e free software n │ │ │ │ │ -00015030: 6565 6473 2066 7265 6520 646f 6375 6d65 eeds free docume │ │ │ │ │ -00015040: 6e74 6174 696f 6e3a 2061 0a20 2020 2020 ntation: a. │ │ │ │ │ -00015050: 6672 6565 2070 726f 6772 616d 2073 686f free program sho │ │ │ │ │ -00015060: 756c 6420 636f 6d65 2077 6974 6820 6d61 uld come with ma │ │ │ │ │ -00015070: 6e75 616c 7320 7072 6f76 6964 696e 6720 nuals providing │ │ │ │ │ -00015080: 7468 6520 7361 6d65 2066 7265 6564 6f6d the same freedom │ │ │ │ │ -00015090: 730a 2020 2020 2074 6861 7420 7468 6520 s. that the │ │ │ │ │ -000150a0: 736f 6674 7761 7265 2064 6f65 732e 2020 software does. │ │ │ │ │ -000150b0: 4275 7420 7468 6973 204c 6963 656e 7365 But this License │ │ │ │ │ -000150c0: 2069 7320 6e6f 7420 6c69 6d69 7465 6420 is not limited │ │ │ │ │ -000150d0: 746f 0a20 2020 2020 736f 6674 7761 7265 to. software │ │ │ │ │ -000150e0: 206d 616e 7561 6c73 3b20 6974 2063 616e manuals; it can │ │ │ │ │ -000150f0: 2062 6520 7573 6564 2066 6f72 2061 6e79 be used for any │ │ │ │ │ -00015100: 2074 6578 7475 616c 2077 6f72 6b2c 2072 textual work, r │ │ │ │ │ -00015110: 6567 6172 646c 6573 730a 2020 2020 206f egardless. o │ │ │ │ │ -00015120: 6620 7375 626a 6563 7420 6d61 7474 6572 f subject matter │ │ │ │ │ -00015130: 206f 7220 7768 6574 6865 7220 6974 2069 or whether it i │ │ │ │ │ -00015140: 7320 7075 626c 6973 6865 6420 6173 2061 s published as a │ │ │ │ │ -00015150: 2070 7269 6e74 6564 2062 6f6f 6b2e 2020 printed book. │ │ │ │ │ -00015160: 5765 0a20 2020 2020 7265 636f 6d6d 656e We. recommen │ │ │ │ │ -00015170: 6420 7468 6973 204c 6963 656e 7365 2070 d this License p │ │ │ │ │ -00015180: 7269 6e63 6970 616c 6c79 2066 6f72 2077 rincipally for w │ │ │ │ │ -00015190: 6f72 6b73 2077 686f 7365 2070 7572 706f orks whose purpo │ │ │ │ │ -000151a0: 7365 2069 730a 2020 2020 2069 6e73 7472 se is. instr │ │ │ │ │ -000151b0: 7563 7469 6f6e 206f 7220 7265 6665 7265 uction or refere │ │ │ │ │ -000151c0: 6e63 652e 0a0a 2020 312e 2041 5050 4c49 nce... 1. APPLI │ │ │ │ │ -000151d0: 4341 4249 4c49 5459 2041 4e44 2044 4546 CABILITY AND DEF │ │ │ │ │ -000151e0: 494e 4954 494f 4e53 0a0a 2020 2020 2054 INITIONS.. T │ │ │ │ │ -000151f0: 6869 7320 4c69 6365 6e73 6520 6170 706c his License appl │ │ │ │ │ -00015200: 6965 7320 746f 2061 6e79 206d 616e 7561 ies to any manua │ │ │ │ │ -00015210: 6c20 6f72 206f 7468 6572 2077 6f72 6b2c l or other work, │ │ │ │ │ -00015220: 2069 6e20 616e 7920 6d65 6469 756d 2c0a in any medium,. │ │ │ │ │ -00015230: 2020 2020 2074 6861 7420 636f 6e74 6169 that contai │ │ │ │ │ -00015240: 6e73 2061 206e 6f74 6963 6520 706c 6163 ns a notice plac │ │ │ │ │ -00015250: 6564 2062 7920 7468 6520 636f 7079 7269 ed by the copyri │ │ │ │ │ -00015260: 6768 7420 686f 6c64 6572 2073 6179 696e ght holder sayin │ │ │ │ │ -00015270: 6720 6974 2063 616e 0a20 2020 2020 6265 g it can. be │ │ │ │ │ -00015280: 2064 6973 7472 6962 7574 6564 2075 6e64 distributed und │ │ │ │ │ -00015290: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ -000152a0: 7468 6973 204c 6963 656e 7365 2e20 2053 this License. S │ │ │ │ │ -000152b0: 7563 6820 6120 6e6f 7469 6365 0a20 2020 uch a notice. │ │ │ │ │ -000152c0: 2020 6772 616e 7473 2061 2077 6f72 6c64 grants a world │ │ │ │ │ -000152d0: 2d77 6964 652c 2072 6f79 616c 7479 2d66 -wide, royalty-f │ │ │ │ │ -000152e0: 7265 6520 6c69 6365 6e73 652c 2075 6e6c ree license, unl │ │ │ │ │ -000152f0: 696d 6974 6564 2069 6e20 6475 7261 7469 imited in durati │ │ │ │ │ -00015300: 6f6e 2c0a 2020 2020 2074 6f20 7573 6520 on,. to use │ │ │ │ │ -00015310: 7468 6174 2077 6f72 6b20 756e 6465 7220 that work under │ │ │ │ │ -00015320: 7468 6520 636f 6e64 6974 696f 6e73 2073 the conditions s │ │ │ │ │ -00015330: 7461 7465 6420 6865 7265 696e 2e20 2054 tated herein. T │ │ │ │ │ -00015340: 6865 0a20 2020 2020 2244 6f63 756d 656e he. "Documen │ │ │ │ │ -00015350: 7422 2c20 6265 6c6f 772c 2072 6566 6572 t", below, refer │ │ │ │ │ -00015360: 7320 746f 2061 6e79 2073 7563 6820 6d61 s to any such ma │ │ │ │ │ -00015370: 6e75 616c 206f 7220 776f 726b 2e20 2041 nual or work. A │ │ │ │ │ -00015380: 6e79 206d 656d 6265 720a 2020 2020 206f ny member. o │ │ │ │ │ -00015390: 6620 7468 6520 7075 626c 6963 2069 7320 f the public is │ │ │ │ │ -000153a0: 6120 6c69 6365 6e73 6565 2c20 616e 6420 a licensee, and │ │ │ │ │ -000153b0: 6973 2061 6464 7265 7373 6564 2061 7320 is addressed as │ │ │ │ │ -000153c0: 2279 6f75 222e 2020 596f 7520 6163 6365 "you". You acce │ │ │ │ │ -000153d0: 7074 0a20 2020 2020 7468 6520 6c69 6365 pt. the lice │ │ │ │ │ -000153e0: 6e73 6520 6966 2079 6f75 2063 6f70 792c nse if you copy, │ │ │ │ │ -000153f0: 206d 6f64 6966 7920 6f72 2064 6973 7472 modify or distr │ │ │ │ │ -00015400: 6962 7574 6520 7468 6520 776f 726b 2069 ibute the work i │ │ │ │ │ -00015410: 6e20 6120 7761 790a 2020 2020 2072 6571 n a way. req │ │ │ │ │ -00015420: 7569 7269 6e67 2070 6572 6d69 7373 696f uiring permissio │ │ │ │ │ -00015430: 6e20 756e 6465 7220 636f 7079 7269 6768 n under copyrigh │ │ │ │ │ -00015440: 7420 6c61 772e 0a0a 2020 2020 2041 2022 t law... A " │ │ │ │ │ -00015450: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ │ -00015460: 2220 6f66 2074 6865 2044 6f63 756d 656e " of the Documen │ │ │ │ │ -00015470: 7420 6d65 616e 7320 616e 7920 776f 726b t means any work │ │ │ │ │ -00015480: 2063 6f6e 7461 696e 696e 6720 7468 650a containing the. │ │ │ │ │ -00015490: 2020 2020 2044 6f63 756d 656e 7420 6f72 Document or │ │ │ │ │ -000154a0: 2061 2070 6f72 7469 6f6e 206f 6620 6974 a portion of it │ │ │ │ │ -000154b0: 2c20 6569 7468 6572 2063 6f70 6965 6420 , either copied │ │ │ │ │ -000154c0: 7665 7262 6174 696d 2c20 6f72 2077 6974 verbatim, or wit │ │ │ │ │ -000154d0: 680a 2020 2020 206d 6f64 6966 6963 6174 h. modificat │ │ │ │ │ -000154e0: 696f 6e73 2061 6e64 2f6f 7220 7472 616e ions and/or tran │ │ │ │ │ -000154f0: 736c 6174 6564 2069 6e74 6f20 616e 6f74 slated into anot │ │ │ │ │ -00015500: 6865 7220 6c61 6e67 7561 6765 2e0a 0a20 her language... │ │ │ │ │ -00015510: 2020 2020 4120 2253 6563 6f6e 6461 7279 A "Secondary │ │ │ │ │ -00015520: 2053 6563 7469 6f6e 2220 6973 2061 206e Section" is a n │ │ │ │ │ -00015530: 616d 6564 2061 7070 656e 6469 7820 6f72 amed appendix or │ │ │ │ │ -00015540: 2061 2066 726f 6e74 2d6d 6174 7465 7220 a front-matter │ │ │ │ │ -00015550: 7365 6374 696f 6e0a 2020 2020 206f 6620 section. of │ │ │ │ │ -00015560: 7468 6520 446f 6375 6d65 6e74 2074 6861 the Document tha │ │ │ │ │ -00015570: 7420 6465 616c 7320 6578 636c 7573 6976 t deals exclusiv │ │ │ │ │ -00015580: 656c 7920 7769 7468 2074 6865 2072 656c ely with the rel │ │ │ │ │ -00015590: 6174 696f 6e73 6869 7020 6f66 2074 6865 ationship of the │ │ │ │ │ -000155a0: 0a20 2020 2020 7075 626c 6973 6865 7273 . publishers │ │ │ │ │ -000155b0: 206f 7220 6175 7468 6f72 7320 6f66 2074 or authors of t │ │ │ │ │ -000155c0: 6865 2044 6f63 756d 656e 7420 746f 2074 he Document to t │ │ │ │ │ -000155d0: 6865 2044 6f63 756d 656e 7427 7320 6f76 he Document's ov │ │ │ │ │ -000155e0: 6572 616c 6c0a 2020 2020 2073 7562 6a65 erall. subje │ │ │ │ │ -000155f0: 6374 2028 6f72 2074 6f20 7265 6c61 7465 ct (or to relate │ │ │ │ │ -00015600: 6420 6d61 7474 6572 7329 2061 6e64 2063 d matters) and c │ │ │ │ │ -00015610: 6f6e 7461 696e 7320 6e6f 7468 696e 6720 ontains nothing │ │ │ │ │ -00015620: 7468 6174 2063 6f75 6c64 0a20 2020 2020 that could. │ │ │ │ │ -00015630: 6661 6c6c 2064 6972 6563 746c 7920 7769 fall directly wi │ │ │ │ │ -00015640: 7468 696e 2074 6861 7420 6f76 6572 616c thin that overal │ │ │ │ │ -00015650: 6c20 7375 626a 6563 742e 2020 2854 6875 l subject. (Thu │ │ │ │ │ -00015660: 732c 2069 6620 7468 6520 446f 6375 6d65 s, if the Docume │ │ │ │ │ -00015670: 6e74 0a20 2020 2020 6973 2069 6e20 7061 nt. is in pa │ │ │ │ │ -00015680: 7274 2061 2074 6578 7462 6f6f 6b20 6f66 rt a textbook of │ │ │ │ │ -00015690: 206d 6174 6865 6d61 7469 6373 2c20 6120 mathematics, a │ │ │ │ │ -000156a0: 5365 636f 6e64 6172 7920 5365 6374 696f Secondary Sectio │ │ │ │ │ -000156b0: 6e20 6d61 7920 6e6f 740a 2020 2020 2065 n may not. e │ │ │ │ │ -000156c0: 7870 6c61 696e 2061 6e79 206d 6174 6865 xplain any mathe │ │ │ │ │ -000156d0: 6d61 7469 6373 2e29 2020 5468 6520 7265 matics.) The re │ │ │ │ │ -000156e0: 6c61 7469 6f6e 7368 6970 2063 6f75 6c64 lationship could │ │ │ │ │ -000156f0: 2062 6520 6120 6d61 7474 6572 206f 660a be a matter of. │ │ │ │ │ -00015700: 2020 2020 2068 6973 746f 7269 6361 6c20 historical │ │ │ │ │ -00015710: 636f 6e6e 6563 7469 6f6e 2077 6974 6820 connection with │ │ │ │ │ -00015720: 7468 6520 7375 626a 6563 7420 6f72 2077 the subject or w │ │ │ │ │ -00015730: 6974 6820 7265 6c61 7465 6420 6d61 7474 ith related matt │ │ │ │ │ -00015740: 6572 732c 206f 720a 2020 2020 206f 6620 ers, or. of │ │ │ │ │ -00015750: 6c65 6761 6c2c 2063 6f6d 6d65 7263 6961 legal, commercia │ │ │ │ │ -00015760: 6c2c 2070 6869 6c6f 736f 7068 6963 616c l, philosophical │ │ │ │ │ -00015770: 2c20 6574 6869 6361 6c20 6f72 2070 6f6c , ethical or pol │ │ │ │ │ -00015780: 6974 6963 616c 2070 6f73 6974 696f 6e0a itical position. │ │ │ │ │ -00015790: 2020 2020 2072 6567 6172 6469 6e67 2074 regarding t │ │ │ │ │ -000157a0: 6865 6d2e 0a0a 2020 2020 2054 6865 2022 hem... The " │ │ │ │ │ -000157b0: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ │ -000157c0: 6e73 2220 6172 6520 6365 7274 6169 6e20 ns" are certain │ │ │ │ │ -000157d0: 5365 636f 6e64 6172 7920 5365 6374 696f Secondary Sectio │ │ │ │ │ -000157e0: 6e73 2077 686f 7365 0a20 2020 2020 7469 ns whose. ti │ │ │ │ │ -000157f0: 746c 6573 2061 7265 2064 6573 6967 6e61 tles are designa │ │ │ │ │ -00015800: 7465 642c 2061 7320 6265 696e 6720 7468 ted, as being th │ │ │ │ │ -00015810: 6f73 6520 6f66 2049 6e76 6172 6961 6e74 ose of Invariant │ │ │ │ │ -00015820: 2053 6563 7469 6f6e 732c 2069 6e20 7468 Sections, in th │ │ │ │ │ -00015830: 650a 2020 2020 206e 6f74 6963 6520 7468 e. notice th │ │ │ │ │ -00015840: 6174 2073 6179 7320 7468 6174 2074 6865 at says that the │ │ │ │ │ -00015850: 2044 6f63 756d 656e 7420 6973 2072 656c Document is rel │ │ │ │ │ -00015860: 6561 7365 6420 756e 6465 7220 7468 6973 eased under this │ │ │ │ │ -00015870: 204c 6963 656e 7365 2e0a 2020 2020 2049 License.. I │ │ │ │ │ -00015880: 6620 6120 7365 6374 696f 6e20 646f 6573 f a section does │ │ │ │ │ -00015890: 206e 6f74 2066 6974 2074 6865 2061 626f not fit the abo │ │ │ │ │ -000158a0: 7665 2064 6566 696e 6974 696f 6e20 6f66 ve definition of │ │ │ │ │ -000158b0: 2053 6563 6f6e 6461 7279 2074 6865 6e20 Secondary then │ │ │ │ │ -000158c0: 6974 0a20 2020 2020 6973 206e 6f74 2061 it. is not a │ │ │ │ │ -000158d0: 6c6c 6f77 6564 2074 6f20 6265 2064 6573 llowed to be des │ │ │ │ │ -000158e0: 6967 6e61 7465 6420 6173 2049 6e76 6172 ignated as Invar │ │ │ │ │ -000158f0: 6961 6e74 2e20 2054 6865 2044 6f63 756d iant. The Docum │ │ │ │ │ -00015900: 656e 7420 6d61 790a 2020 2020 2063 6f6e ent may. con │ │ │ │ │ -00015910: 7461 696e 207a 6572 6f20 496e 7661 7269 tain zero Invari │ │ │ │ │ -00015920: 616e 7420 5365 6374 696f 6e73 2e20 2049 ant Sections. I │ │ │ │ │ -00015930: 6620 7468 6520 446f 6375 6d65 6e74 2064 f the Document d │ │ │ │ │ -00015940: 6f65 7320 6e6f 7420 6964 656e 7469 6679 oes not identify │ │ │ │ │ -00015950: 0a20 2020 2020 616e 7920 496e 7661 7269 . any Invari │ │ │ │ │ -00015960: 616e 7420 5365 6374 696f 6e73 2074 6865 ant Sections the │ │ │ │ │ -00015970: 6e20 7468 6572 6520 6172 6520 6e6f 6e65 n there are none │ │ │ │ │ -00015980: 2e0a 0a20 2020 2020 5468 6520 2243 6f76 ... The "Cov │ │ │ │ │ -00015990: 6572 2054 6578 7473 2220 6172 6520 6365 er Texts" are ce │ │ │ │ │ -000159a0: 7274 6169 6e20 7368 6f72 7420 7061 7373 rtain short pass │ │ │ │ │ -000159b0: 6167 6573 206f 6620 7465 7874 2074 6861 ages of text tha │ │ │ │ │ -000159c0: 7420 6172 650a 2020 2020 206c 6973 7465 t are. liste │ │ │ │ │ -000159d0: 642c 2061 7320 4672 6f6e 742d 436f 7665 d, as Front-Cove │ │ │ │ │ -000159e0: 7220 5465 7874 7320 6f72 2042 6163 6b2d r Texts or Back- │ │ │ │ │ -000159f0: 436f 7665 7220 5465 7874 732c 2069 6e20 Cover Texts, in │ │ │ │ │ -00015a00: 7468 6520 6e6f 7469 6365 0a20 2020 2020 the notice. │ │ │ │ │ -00015a10: 7468 6174 2073 6179 7320 7468 6174 2074 that says that t │ │ │ │ │ -00015a20: 6865 2044 6f63 756d 656e 7420 6973 2072 he Document is r │ │ │ │ │ -00015a30: 656c 6561 7365 6420 756e 6465 7220 7468 eleased under th │ │ │ │ │ -00015a40: 6973 204c 6963 656e 7365 2e20 2041 0a20 is License. A. │ │ │ │ │ -00015a50: 2020 2020 4672 6f6e 742d 436f 7665 7220 Front-Cover │ │ │ │ │ -00015a60: 5465 7874 206d 6179 2062 6520 6174 206d Text may be at m │ │ │ │ │ -00015a70: 6f73 7420 3520 776f 7264 732c 2061 6e64 ost 5 words, and │ │ │ │ │ -00015a80: 2061 2042 6163 6b2d 436f 7665 7220 5465 a Back-Cover Te │ │ │ │ │ -00015a90: 7874 206d 6179 0a20 2020 2020 6265 2061 xt may. be a │ │ │ │ │ -00015aa0: 7420 6d6f 7374 2032 3520 776f 7264 732e t most 25 words. │ │ │ │ │ -00015ab0: 0a0a 2020 2020 2041 2022 5472 616e 7370 .. A "Transp │ │ │ │ │ -00015ac0: 6172 656e 7422 2063 6f70 7920 6f66 2074 arent" copy of t │ │ │ │ │ -00015ad0: 6865 2044 6f63 756d 656e 7420 6d65 616e he Document mean │ │ │ │ │ -00015ae0: 7320 6120 6d61 6368 696e 652d 7265 6164 s a machine-read │ │ │ │ │ -00015af0: 6162 6c65 2063 6f70 792c 0a20 2020 2020 able copy,. │ │ │ │ │ -00015b00: 7265 7072 6573 656e 7465 6420 696e 2061 represented in a │ │ │ │ │ -00015b10: 2066 6f72 6d61 7420 7768 6f73 6520 7370 format whose sp │ │ │ │ │ -00015b20: 6563 6966 6963 6174 696f 6e20 6973 2061 ecification is a │ │ │ │ │ -00015b30: 7661 696c 6162 6c65 2074 6f20 7468 650a vailable to the. │ │ │ │ │ -00015b40: 2020 2020 2067 656e 6572 616c 2070 7562 general pub │ │ │ │ │ -00015b50: 6c69 632c 2074 6861 7420 6973 2073 7569 lic, that is sui │ │ │ │ │ -00015b60: 7461 626c 6520 666f 7220 7265 7669 7369 table for revisi │ │ │ │ │ -00015b70: 6e67 2074 6865 2064 6f63 756d 656e 740a ng the document. │ │ │ │ │ -00015b80: 2020 2020 2073 7472 6169 6768 7466 6f72 straightfor │ │ │ │ │ -00015b90: 7761 7264 6c79 2077 6974 6820 6765 6e65 wardly with gene │ │ │ │ │ -00015ba0: 7269 6320 7465 7874 2065 6469 746f 7273 ric text editors │ │ │ │ │ -00015bb0: 206f 7220 2866 6f72 2069 6d61 6765 7320 or (for images │ │ │ │ │ -00015bc0: 636f 6d70 6f73 6564 0a20 2020 2020 6f66 composed. of │ │ │ │ │ -00015bd0: 2070 6978 656c 7329 2067 656e 6572 6963 pixels) generic │ │ │ │ │ -00015be0: 2070 6169 6e74 2070 726f 6772 616d 7320 paint programs │ │ │ │ │ -00015bf0: 6f72 2028 666f 7220 6472 6177 696e 6773 or (for drawings │ │ │ │ │ -00015c00: 2920 736f 6d65 2077 6964 656c 790a 2020 ) some widely. │ │ │ │ │ -00015c10: 2020 2061 7661 696c 6162 6c65 2064 7261 available dra │ │ │ │ │ -00015c20: 7769 6e67 2065 6469 746f 722c 2061 6e64 wing editor, and │ │ │ │ │ -00015c30: 2074 6861 7420 6973 2073 7569 7461 626c that is suitabl │ │ │ │ │ -00015c40: 6520 666f 7220 696e 7075 7420 746f 2074 e for input to t │ │ │ │ │ -00015c50: 6578 740a 2020 2020 2066 6f72 6d61 7474 ext. formatt │ │ │ │ │ -00015c60: 6572 7320 6f72 2066 6f72 2061 7574 6f6d ers or for autom │ │ │ │ │ -00015c70: 6174 6963 2074 7261 6e73 6c61 7469 6f6e atic translation │ │ │ │ │ -00015c80: 2074 6f20 6120 7661 7269 6574 7920 6f66 to a variety of │ │ │ │ │ -00015c90: 2066 6f72 6d61 7473 0a20 2020 2020 7375 formats. su │ │ │ │ │ -00015ca0: 6974 6162 6c65 2066 6f72 2069 6e70 7574 itable for input │ │ │ │ │ -00015cb0: 2074 6f20 7465 7874 2066 6f72 6d61 7474 to text formatt │ │ │ │ │ -00015cc0: 6572 732e 2020 4120 636f 7079 206d 6164 ers. A copy mad │ │ │ │ │ -00015cd0: 6520 696e 2061 6e20 6f74 6865 7277 6973 e in an otherwis │ │ │ │ │ -00015ce0: 650a 2020 2020 2054 7261 6e73 7061 7265 e. Transpare │ │ │ │ │ -00015cf0: 6e74 2066 696c 6520 666f 726d 6174 2077 nt file format w │ │ │ │ │ -00015d00: 686f 7365 206d 6172 6b75 702c 206f 7220 hose markup, or │ │ │ │ │ -00015d10: 6162 7365 6e63 6520 6f66 206d 6172 6b75 absence of marku │ │ │ │ │ -00015d20: 702c 2068 6173 0a20 2020 2020 6265 656e p, has. been │ │ │ │ │ -00015d30: 2061 7272 616e 6765 6420 746f 2074 6877 arranged to thw │ │ │ │ │ -00015d40: 6172 7420 6f72 2064 6973 636f 7572 6167 art or discourag │ │ │ │ │ -00015d50: 6520 7375 6273 6571 7565 6e74 206d 6f64 e subsequent mod │ │ │ │ │ -00015d60: 6966 6963 6174 696f 6e20 6279 0a20 2020 ification by. │ │ │ │ │ -00015d70: 2020 7265 6164 6572 7320 6973 206e 6f74 readers is not │ │ │ │ │ -00015d80: 2054 7261 6e73 7061 7265 6e74 2e20 2041 Transparent. A │ │ │ │ │ -00015d90: 6e20 696d 6167 6520 666f 726d 6174 2069 n image format i │ │ │ │ │ -00015da0: 7320 6e6f 7420 5472 616e 7370 6172 656e s not Transparen │ │ │ │ │ -00015db0: 7420 6966 0a20 2020 2020 7573 6564 2066 t if. used f │ │ │ │ │ -00015dc0: 6f72 2061 6e79 2073 7562 7374 616e 7469 or any substanti │ │ │ │ │ -00015dd0: 616c 2061 6d6f 756e 7420 6f66 2074 6578 al amount of tex │ │ │ │ │ -00015de0: 742e 2020 4120 636f 7079 2074 6861 7420 t. A copy that │ │ │ │ │ -00015df0: 6973 206e 6f74 0a20 2020 2020 2254 7261 is not. "Tra │ │ │ │ │ -00015e00: 6e73 7061 7265 6e74 2220 6973 2063 616c nsparent" is cal │ │ │ │ │ -00015e10: 6c65 6420 224f 7061 7175 6522 2e0a 0a20 led "Opaque"... │ │ │ │ │ -00015e20: 2020 2020 4578 616d 706c 6573 206f 6620 Examples of │ │ │ │ │ -00015e30: 7375 6974 6162 6c65 2066 6f72 6d61 7473 suitable formats │ │ │ │ │ -00015e40: 2066 6f72 2054 7261 6e73 7061 7265 6e74 for Transparent │ │ │ │ │ -00015e50: 2063 6f70 6965 7320 696e 636c 7564 6520 copies include │ │ │ │ │ -00015e60: 706c 6169 6e0a 2020 2020 2041 5343 4949 plain. ASCII │ │ │ │ │ -00015e70: 2077 6974 686f 7574 206d 6172 6b75 702c without markup, │ │ │ │ │ -00015e80: 2054 6578 696e 666f 2069 6e70 7574 2066 Texinfo input f │ │ │ │ │ -00015e90: 6f72 6d61 742c 204c 6154 6558 2069 6e70 ormat, LaTeX inp │ │ │ │ │ -00015ea0: 7574 2066 6f72 6d61 742c 0a20 2020 2020 ut format,. │ │ │ │ │ -00015eb0: 5347 4d4c 206f 7220 584d 4c20 7573 696e SGML or XML usin │ │ │ │ │ -00015ec0: 6720 6120 7075 626c 6963 6c79 2061 7661 g a publicly ava │ │ │ │ │ -00015ed0: 696c 6162 6c65 2044 5444 2c20 616e 6420 ilable DTD, and │ │ │ │ │ -00015ee0: 7374 616e 6461 7264 2d63 6f6e 666f 726d standard-conform │ │ │ │ │ -00015ef0: 696e 670a 2020 2020 2073 696d 706c 6520 ing. simple │ │ │ │ │ -00015f00: 4854 4d4c 2c20 506f 7374 5363 7269 7074 HTML, PostScript │ │ │ │ │ -00015f10: 206f 7220 5044 4620 6465 7369 676e 6564 or PDF designed │ │ │ │ │ -00015f20: 2066 6f72 2068 756d 616e 206d 6f64 6966 for human modif │ │ │ │ │ -00015f30: 6963 6174 696f 6e2e 0a20 2020 2020 4578 ication.. Ex │ │ │ │ │ -00015f40: 616d 706c 6573 206f 6620 7472 616e 7370 amples of transp │ │ │ │ │ -00015f50: 6172 656e 7420 696d 6167 6520 666f 726d arent image form │ │ │ │ │ -00015f60: 6174 7320 696e 636c 7564 6520 504e 472c ats include PNG, │ │ │ │ │ -00015f70: 2058 4346 2061 6e64 204a 5047 2e0a 2020 XCF and JPG.. │ │ │ │ │ -00015f80: 2020 204f 7061 7175 6520 666f 726d 6174 Opaque format │ │ │ │ │ -00015f90: 7320 696e 636c 7564 6520 7072 6f70 7269 s include propri │ │ │ │ │ -00015fa0: 6574 6172 7920 666f 726d 6174 7320 7468 etary formats th │ │ │ │ │ -00015fb0: 6174 2063 616e 2062 6520 7265 6164 2061 at can be read a │ │ │ │ │ -00015fc0: 6e64 0a20 2020 2020 6564 6974 6564 206f nd. edited o │ │ │ │ │ -00015fd0: 6e6c 7920 6279 2070 726f 7072 6965 7461 nly by proprieta │ │ │ │ │ -00015fe0: 7279 2077 6f72 6420 7072 6f63 6573 736f ry word processo │ │ │ │ │ -00015ff0: 7273 2c20 5347 4d4c 206f 7220 584d 4c20 rs, SGML or XML │ │ │ │ │ -00016000: 666f 7220 7768 6963 680a 2020 2020 2074 for which. t │ │ │ │ │ -00016010: 6865 2044 5444 2061 6e64 2f6f 7220 7072 he DTD and/or pr │ │ │ │ │ -00016020: 6f63 6573 7369 6e67 2074 6f6f 6c73 2061 ocessing tools a │ │ │ │ │ -00016030: 7265 206e 6f74 2067 656e 6572 616c 6c79 re not generally │ │ │ │ │ -00016040: 2061 7661 696c 6162 6c65 2c20 616e 640a available, and. │ │ │ │ │ -00016050: 2020 2020 2074 6865 206d 6163 6869 6e65 the machine │ │ │ │ │ -00016060: 2d67 656e 6572 6174 6564 2048 544d 4c2c -generated HTML, │ │ │ │ │ -00016070: 2050 6f73 7453 6372 6970 7420 6f72 2050 PostScript or P │ │ │ │ │ -00016080: 4446 2070 726f 6475 6365 6420 6279 2073 DF produced by s │ │ │ │ │ -00016090: 6f6d 6520 776f 7264 0a20 2020 2020 7072 ome word. pr │ │ │ │ │ -000160a0: 6f63 6573 736f 7273 2066 6f72 206f 7574 ocessors for out │ │ │ │ │ -000160b0: 7075 7420 7075 7270 6f73 6573 206f 6e6c put purposes onl │ │ │ │ │ -000160c0: 792e 0a0a 2020 2020 2054 6865 2022 5469 y... The "Ti │ │ │ │ │ -000160d0: 746c 6520 5061 6765 2220 6d65 616e 732c tle Page" means, │ │ │ │ │ -000160e0: 2066 6f72 2061 2070 7269 6e74 6564 2062 for a printed b │ │ │ │ │ -000160f0: 6f6f 6b2c 2074 6865 2074 6974 6c65 2070 ook, the title p │ │ │ │ │ -00016100: 6167 6520 6974 7365 6c66 2c0a 2020 2020 age itself,. │ │ │ │ │ -00016110: 2070 6c75 7320 7375 6368 2066 6f6c 6c6f plus such follo │ │ │ │ │ -00016120: 7769 6e67 2070 6167 6573 2061 7320 6172 wing pages as ar │ │ │ │ │ -00016130: 6520 6e65 6564 6564 2074 6f20 686f 6c64 e needed to hold │ │ │ │ │ -00016140: 2c20 6c65 6769 626c 792c 2074 6865 0a20 , legibly, the. │ │ │ │ │ -00016150: 2020 2020 6d61 7465 7269 616c 2074 6869 material thi │ │ │ │ │ -00016160: 7320 4c69 6365 6e73 6520 7265 7175 6972 s License requir │ │ │ │ │ -00016170: 6573 2074 6f20 6170 7065 6172 2069 6e20 es to appear in │ │ │ │ │ -00016180: 7468 6520 7469 746c 6520 7061 6765 2e20 the title page. │ │ │ │ │ -00016190: 2046 6f72 0a20 2020 2020 776f 726b 7320 For. works │ │ │ │ │ -000161a0: 696e 2066 6f72 6d61 7473 2077 6869 6368 in formats which │ │ │ │ │ -000161b0: 2064 6f20 6e6f 7420 6861 7665 2061 6e79 do not have any │ │ │ │ │ -000161c0: 2074 6974 6c65 2070 6167 6520 6173 2073 title page as s │ │ │ │ │ -000161d0: 7563 682c 2022 5469 746c 650a 2020 2020 uch, "Title. │ │ │ │ │ -000161e0: 2050 6167 6522 206d 6561 6e73 2074 6865 Page" means the │ │ │ │ │ -000161f0: 2074 6578 7420 6e65 6172 2074 6865 206d text near the m │ │ │ │ │ -00016200: 6f73 7420 7072 6f6d 696e 656e 7420 6170 ost prominent ap │ │ │ │ │ -00016210: 7065 6172 616e 6365 206f 6620 7468 650a pearance of the. │ │ │ │ │ -00016220: 2020 2020 2077 6f72 6b27 7320 7469 746c work's titl │ │ │ │ │ -00016230: 652c 2070 7265 6365 6469 6e67 2074 6865 e, preceding the │ │ │ │ │ -00016240: 2062 6567 696e 6e69 6e67 206f 6620 7468 beginning of th │ │ │ │ │ -00016250: 6520 626f 6479 206f 6620 7468 6520 7465 e body of the te │ │ │ │ │ -00016260: 7874 2e0a 0a20 2020 2020 4120 7365 6374 xt... A sect │ │ │ │ │ -00016270: 696f 6e20 2245 6e74 6974 6c65 6420 5859 ion "Entitled XY │ │ │ │ │ -00016280: 5a22 206d 6561 6e73 2061 206e 616d 6564 Z" means a named │ │ │ │ │ -00016290: 2073 7562 756e 6974 206f 6620 7468 6520 subunit of the │ │ │ │ │ -000162a0: 446f 6375 6d65 6e74 0a20 2020 2020 7768 Document. wh │ │ │ │ │ -000162b0: 6f73 6520 7469 746c 6520 6569 7468 6572 ose title either │ │ │ │ │ -000162c0: 2069 7320 7072 6563 6973 656c 7920 5859 is precisely XY │ │ │ │ │ -000162d0: 5a20 6f72 2063 6f6e 7461 696e 7320 5859 Z or contains XY │ │ │ │ │ -000162e0: 5a20 696e 2070 6172 656e 7468 6573 6573 Z in parentheses │ │ │ │ │ -000162f0: 0a20 2020 2020 666f 6c6c 6f77 696e 6720 . following │ │ │ │ │ -00016300: 7465 7874 2074 6861 7420 7472 616e 736c text that transl │ │ │ │ │ -00016310: 6174 6573 2058 595a 2069 6e20 616e 6f74 ates XYZ in anot │ │ │ │ │ -00016320: 6865 7220 6c61 6e67 7561 6765 2e20 2028 her language. ( │ │ │ │ │ -00016330: 4865 7265 2058 595a 0a20 2020 2020 7374 Here XYZ. st │ │ │ │ │ -00016340: 616e 6473 2066 6f72 2061 2073 7065 6369 ands for a speci │ │ │ │ │ -00016350: 6669 6320 7365 6374 696f 6e20 6e61 6d65 fic section name │ │ │ │ │ -00016360: 206d 656e 7469 6f6e 6564 2062 656c 6f77 mentioned below │ │ │ │ │ -00016370: 2c20 7375 6368 2061 730a 2020 2020 2022 , such as. " │ │ │ │ │ -00016380: 4163 6b6e 6f77 6c65 6467 656d 656e 7473 Acknowledgements │ │ │ │ │ -00016390: 222c 2022 4465 6469 6361 7469 6f6e 7322 ", "Dedications" │ │ │ │ │ -000163a0: 2c20 2245 6e64 6f72 7365 6d65 6e74 7322 , "Endorsements" │ │ │ │ │ -000163b0: 2c20 6f72 2022 4869 7374 6f72 7922 2e29 , or "History".) │ │ │ │ │ -000163c0: 0a20 2020 2020 546f 2022 5072 6573 6572 . To "Preser │ │ │ │ │ -000163d0: 7665 2074 6865 2054 6974 6c65 2220 6f66 ve the Title" of │ │ │ │ │ -000163e0: 2073 7563 6820 6120 7365 6374 696f 6e20 such a section │ │ │ │ │ -000163f0: 7768 656e 2079 6f75 206d 6f64 6966 7920 when you modify │ │ │ │ │ -00016400: 7468 650a 2020 2020 2044 6f63 756d 656e the. Documen │ │ │ │ │ -00016410: 7420 6d65 616e 7320 7468 6174 2069 7420 t means that it │ │ │ │ │ -00016420: 7265 6d61 696e 7320 6120 7365 6374 696f remains a sectio │ │ │ │ │ -00016430: 6e20 2245 6e74 6974 6c65 6420 5859 5a22 n "Entitled XYZ" │ │ │ │ │ -00016440: 2061 6363 6f72 6469 6e67 0a20 2020 2020 according. │ │ │ │ │ -00016450: 746f 2074 6869 7320 6465 6669 6e69 7469 to this definiti │ │ │ │ │ -00016460: 6f6e 2e0a 0a20 2020 2020 5468 6520 446f on... The Do │ │ │ │ │ -00016470: 6375 6d65 6e74 206d 6179 2069 6e63 6c75 cument may inclu │ │ │ │ │ -00016480: 6465 2057 6172 7261 6e74 7920 4469 7363 de Warranty Disc │ │ │ │ │ -00016490: 6c61 696d 6572 7320 6e65 7874 2074 6f20 laimers next to │ │ │ │ │ -000164a0: 7468 6520 6e6f 7469 6365 0a20 2020 2020 the notice. │ │ │ │ │ -000164b0: 7768 6963 6820 7374 6174 6573 2074 6861 which states tha │ │ │ │ │ -000164c0: 7420 7468 6973 204c 6963 656e 7365 2061 t this License a │ │ │ │ │ -000164d0: 7070 6c69 6573 2074 6f20 7468 6520 446f pplies to the Do │ │ │ │ │ -000164e0: 6375 6d65 6e74 2e20 2054 6865 7365 0a20 cument. These. │ │ │ │ │ -000164f0: 2020 2020 5761 7272 616e 7479 2044 6973 Warranty Dis │ │ │ │ │ -00016500: 636c 6169 6d65 7273 2061 7265 2063 6f6e claimers are con │ │ │ │ │ -00016510: 7369 6465 7265 6420 746f 2062 6520 696e sidered to be in │ │ │ │ │ -00016520: 636c 7564 6564 2062 7920 7265 6665 7265 cluded by refere │ │ │ │ │ -00016530: 6e63 6520 696e 0a20 2020 2020 7468 6973 nce in. this │ │ │ │ │ -00016540: 204c 6963 656e 7365 2c20 6275 7420 6f6e License, but on │ │ │ │ │ -00016550: 6c79 2061 7320 7265 6761 7264 7320 6469 ly as regards di │ │ │ │ │ -00016560: 7363 6c61 696d 696e 6720 7761 7272 616e sclaiming warran │ │ │ │ │ -00016570: 7469 6573 3a20 616e 7920 6f74 6865 720a ties: any other. │ │ │ │ │ -00016580: 2020 2020 2069 6d70 6c69 6361 7469 6f6e implication │ │ │ │ │ -00016590: 2074 6861 7420 7468 6573 6520 5761 7272 that these Warr │ │ │ │ │ -000165a0: 616e 7479 2044 6973 636c 6169 6d65 7273 anty Disclaimers │ │ │ │ │ -000165b0: 206d 6179 2068 6176 6520 6973 2076 6f69 may have is voi │ │ │ │ │ -000165c0: 6420 616e 640a 2020 2020 2068 6173 206e d and. has n │ │ │ │ │ -000165d0: 6f20 6566 6665 6374 206f 6e20 7468 6520 o effect on the │ │ │ │ │ -000165e0: 6d65 616e 696e 6720 6f66 2074 6869 7320 meaning of this │ │ │ │ │ -000165f0: 4c69 6365 6e73 652e 0a0a 2020 322e 2056 License... 2. V │ │ │ │ │ -00016600: 4552 4241 5449 4d20 434f 5059 494e 470a ERBATIM COPYING. │ │ │ │ │ -00016610: 0a20 2020 2020 596f 7520 6d61 7920 636f . You may co │ │ │ │ │ -00016620: 7079 2061 6e64 2064 6973 7472 6962 7574 py and distribut │ │ │ │ │ -00016630: 6520 7468 6520 446f 6375 6d65 6e74 2069 e the Document i │ │ │ │ │ -00016640: 6e20 616e 7920 6d65 6469 756d 2c20 6569 n any medium, ei │ │ │ │ │ -00016650: 7468 6572 0a20 2020 2020 636f 6d6d 6572 ther. commer │ │ │ │ │ -00016660: 6369 616c 6c79 206f 7220 6e6f 6e63 6f6d cially or noncom │ │ │ │ │ -00016670: 6d65 7263 6961 6c6c 792c 2070 726f 7669 mercially, provi │ │ │ │ │ -00016680: 6465 6420 7468 6174 2074 6869 7320 4c69 ded that this Li │ │ │ │ │ -00016690: 6365 6e73 652c 2074 6865 0a20 2020 2020 cense, the. │ │ │ │ │ -000166a0: 636f 7079 7269 6768 7420 6e6f 7469 6365 copyright notice │ │ │ │ │ -000166b0: 732c 2061 6e64 2074 6865 206c 6963 656e s, and the licen │ │ │ │ │ -000166c0: 7365 206e 6f74 6963 6520 7361 7969 6e67 se notice saying │ │ │ │ │ -000166d0: 2074 6869 7320 4c69 6365 6e73 650a 2020 this License. │ │ │ │ │ -000166e0: 2020 2061 7070 6c69 6573 2074 6f20 7468 applies to th │ │ │ │ │ -000166f0: 6520 446f 6375 6d65 6e74 2061 7265 2072 e Document are r │ │ │ │ │ -00016700: 6570 726f 6475 6365 6420 696e 2061 6c6c eproduced in all │ │ │ │ │ -00016710: 2063 6f70 6965 732c 2061 6e64 2074 6861 copies, and tha │ │ │ │ │ -00016720: 7420 796f 750a 2020 2020 2061 6464 206e t you. add n │ │ │ │ │ -00016730: 6f20 6f74 6865 7220 636f 6e64 6974 696f o other conditio │ │ │ │ │ -00016740: 6e73 2077 6861 7473 6f65 7665 7220 746f ns whatsoever to │ │ │ │ │ -00016750: 2074 686f 7365 206f 6620 7468 6973 204c those of this L │ │ │ │ │ -00016760: 6963 656e 7365 2e20 2059 6f75 0a20 2020 icense. You. │ │ │ │ │ -00016770: 2020 6d61 7920 6e6f 7420 7573 6520 7465 may not use te │ │ │ │ │ -00016780: 6368 6e69 6361 6c20 6d65 6173 7572 6573 chnical measures │ │ │ │ │ -00016790: 2074 6f20 6f62 7374 7275 6374 206f 7220 to obstruct or │ │ │ │ │ -000167a0: 636f 6e74 726f 6c20 7468 6520 7265 6164 control the read │ │ │ │ │ -000167b0: 696e 670a 2020 2020 206f 7220 6675 7274 ing. or furt │ │ │ │ │ -000167c0: 6865 7220 636f 7079 696e 6720 6f66 2074 her copying of t │ │ │ │ │ -000167d0: 6865 2063 6f70 6965 7320 796f 7520 6d61 he copies you ma │ │ │ │ │ -000167e0: 6b65 206f 7220 6469 7374 7269 6275 7465 ke or distribute │ │ │ │ │ -000167f0: 2e20 2048 6f77 6576 6572 2c0a 2020 2020 . However,. │ │ │ │ │ -00016800: 2079 6f75 206d 6179 2061 6363 6570 7420 you may accept │ │ │ │ │ -00016810: 636f 6d70 656e 7361 7469 6f6e 2069 6e20 compensation in │ │ │ │ │ -00016820: 6578 6368 616e 6765 2066 6f72 2063 6f70 exchange for cop │ │ │ │ │ -00016830: 6965 732e 2020 4966 2079 6f75 0a20 2020 ies. If you. │ │ │ │ │ -00016840: 2020 6469 7374 7269 6275 7465 2061 206c distribute a l │ │ │ │ │ -00016850: 6172 6765 2065 6e6f 7567 6820 6e75 6d62 arge enough numb │ │ │ │ │ -00016860: 6572 206f 6620 636f 7069 6573 2079 6f75 er of copies you │ │ │ │ │ -00016870: 206d 7573 7420 616c 736f 2066 6f6c 6c6f must also follo │ │ │ │ │ -00016880: 7720 7468 650a 2020 2020 2063 6f6e 6469 w the. condi │ │ │ │ │ -00016890: 7469 6f6e 7320 696e 2073 6563 7469 6f6e tions in section │ │ │ │ │ -000168a0: 2033 2e0a 0a20 2020 2020 596f 7520 6d61 3... You ma │ │ │ │ │ -000168b0: 7920 616c 736f 206c 656e 6420 636f 7069 y also lend copi │ │ │ │ │ -000168c0: 6573 2c20 756e 6465 7220 7468 6520 7361 es, under the sa │ │ │ │ │ -000168d0: 6d65 2063 6f6e 6469 7469 6f6e 7320 7374 me conditions st │ │ │ │ │ -000168e0: 6174 6564 2061 626f 7665 2c0a 2020 2020 ated above,. │ │ │ │ │ -000168f0: 2061 6e64 2079 6f75 206d 6179 2070 7562 and you may pub │ │ │ │ │ -00016900: 6c69 636c 7920 6469 7370 6c61 7920 636f licly display co │ │ │ │ │ -00016910: 7069 6573 2e0a 0a20 2033 2e20 434f 5059 pies... 3. COPY │ │ │ │ │ -00016920: 494e 4720 494e 2051 5541 4e54 4954 590a ING IN QUANTITY. │ │ │ │ │ -00016930: 0a20 2020 2020 4966 2079 6f75 2070 7562 . If you pub │ │ │ │ │ -00016940: 6c69 7368 2070 7269 6e74 6564 2063 6f70 lish printed cop │ │ │ │ │ -00016950: 6965 7320 286f 7220 636f 7069 6573 2069 ies (or copies i │ │ │ │ │ -00016960: 6e20 6d65 6469 6120 7468 6174 2063 6f6d n media that com │ │ │ │ │ -00016970: 6d6f 6e6c 790a 2020 2020 2068 6176 6520 monly. have │ │ │ │ │ -00016980: 7072 696e 7465 6420 636f 7665 7273 2920 printed covers) │ │ │ │ │ -00016990: 6f66 2074 6865 2044 6f63 756d 656e 742c of the Document, │ │ │ │ │ -000169a0: 206e 756d 6265 7269 6e67 206d 6f72 6520 numbering more │ │ │ │ │ -000169b0: 7468 616e 2031 3030 2c20 616e 640a 2020 than 100, and. │ │ │ │ │ -000169c0: 2020 2074 6865 2044 6f63 756d 656e 7427 the Document' │ │ │ │ │ -000169d0: 7320 6c69 6365 6e73 6520 6e6f 7469 6365 s license notice │ │ │ │ │ -000169e0: 2072 6571 7569 7265 7320 436f 7665 7220 requires Cover │ │ │ │ │ -000169f0: 5465 7874 732c 2079 6f75 206d 7573 740a Texts, you must. │ │ │ │ │ -00016a00: 2020 2020 2065 6e63 6c6f 7365 2074 6865 enclose the │ │ │ │ │ -00016a10: 2063 6f70 6965 7320 696e 2063 6f76 6572 copies in cover │ │ │ │ │ -00016a20: 7320 7468 6174 2063 6172 7279 2c20 636c s that carry, cl │ │ │ │ │ -00016a30: 6561 726c 7920 616e 6420 6c65 6769 626c early and legibl │ │ │ │ │ -00016a40: 792c 2061 6c6c 0a20 2020 2020 7468 6573 y, all. thes │ │ │ │ │ -00016a50: 6520 436f 7665 7220 5465 7874 733a 2046 e Cover Texts: F │ │ │ │ │ -00016a60: 726f 6e74 2d43 6f76 6572 2054 6578 7473 ront-Cover Texts │ │ │ │ │ -00016a70: 206f 6e20 7468 6520 6672 6f6e 7420 636f on the front co │ │ │ │ │ -00016a80: 7665 722c 2061 6e64 0a20 2020 2020 4261 ver, and. Ba │ │ │ │ │ -00016a90: 636b 2d43 6f76 6572 2054 6578 7473 206f ck-Cover Texts o │ │ │ │ │ -00016aa0: 6e20 7468 6520 6261 636b 2063 6f76 6572 n the back cover │ │ │ │ │ -00016ab0: 2e20 2042 6f74 6820 636f 7665 7273 206d . Both covers m │ │ │ │ │ -00016ac0: 7573 7420 616c 736f 2063 6c65 6172 6c79 ust also clearly │ │ │ │ │ -00016ad0: 0a20 2020 2020 616e 6420 6c65 6769 626c . and legibl │ │ │ │ │ -00016ae0: 7920 6964 656e 7469 6679 2079 6f75 2061 y identify you a │ │ │ │ │ -00016af0: 7320 7468 6520 7075 626c 6973 6865 7220 s the publisher │ │ │ │ │ -00016b00: 6f66 2074 6865 7365 2063 6f70 6965 732e of these copies. │ │ │ │ │ -00016b10: 2020 5468 650a 2020 2020 2066 726f 6e74 The. front │ │ │ │ │ -00016b20: 2063 6f76 6572 206d 7573 7420 7072 6573 cover must pres │ │ │ │ │ -00016b30: 656e 7420 7468 6520 6675 6c6c 2074 6974 ent the full tit │ │ │ │ │ -00016b40: 6c65 2077 6974 6820 616c 6c20 776f 7264 le with all word │ │ │ │ │ -00016b50: 7320 6f66 2074 6865 2074 6974 6c65 0a20 s of the title. │ │ │ │ │ -00016b60: 2020 2020 6571 7561 6c6c 7920 7072 6f6d equally prom │ │ │ │ │ -00016b70: 696e 656e 7420 616e 6420 7669 7369 626c inent and visibl │ │ │ │ │ -00016b80: 652e 2020 596f 7520 6d61 7920 6164 6420 e. You may add │ │ │ │ │ -00016b90: 6f74 6865 7220 6d61 7465 7269 616c 206f other material o │ │ │ │ │ -00016ba0: 6e20 7468 650a 2020 2020 2063 6f76 6572 n the. cover │ │ │ │ │ -00016bb0: 7320 696e 2061 6464 6974 696f 6e2e 2020 s in addition. │ │ │ │ │ -00016bc0: 436f 7079 696e 6720 7769 7468 2063 6861 Copying with cha │ │ │ │ │ -00016bd0: 6e67 6573 206c 696d 6974 6564 2074 6f20 nges limited to │ │ │ │ │ -00016be0: 7468 6520 636f 7665 7273 2c20 6173 0a20 the covers, as. │ │ │ │ │ -00016bf0: 2020 2020 6c6f 6e67 2061 7320 7468 6579 long as they │ │ │ │ │ -00016c00: 2070 7265 7365 7276 6520 7468 6520 7469 preserve the ti │ │ │ │ │ -00016c10: 746c 6520 6f66 2074 6865 2044 6f63 756d tle of the Docum │ │ │ │ │ -00016c20: 656e 7420 616e 6420 7361 7469 7366 7920 ent and satisfy │ │ │ │ │ -00016c30: 7468 6573 650a 2020 2020 2063 6f6e 6469 these. condi │ │ │ │ │ -00016c40: 7469 6f6e 732c 2063 616e 2062 6520 7472 tions, can be tr │ │ │ │ │ -00016c50: 6561 7465 6420 6173 2076 6572 6261 7469 eated as verbati │ │ │ │ │ -00016c60: 6d20 636f 7079 696e 6720 696e 206f 7468 m copying in oth │ │ │ │ │ -00016c70: 6572 2072 6573 7065 6374 732e 0a0a 2020 er respects... │ │ │ │ │ -00016c80: 2020 2049 6620 7468 6520 7265 7175 6972 If the requir │ │ │ │ │ -00016c90: 6564 2074 6578 7473 2066 6f72 2065 6974 ed texts for eit │ │ │ │ │ -00016ca0: 6865 7220 636f 7665 7220 6172 6520 746f her cover are to │ │ │ │ │ -00016cb0: 6f20 766f 6c75 6d69 6e6f 7573 2074 6f20 o voluminous to │ │ │ │ │ -00016cc0: 6669 740a 2020 2020 206c 6567 6962 6c79 fit. legibly │ │ │ │ │ -00016cd0: 2c20 796f 7520 7368 6f75 6c64 2070 7574 , you should put │ │ │ │ │ -00016ce0: 2074 6865 2066 6972 7374 206f 6e65 7320 the first ones │ │ │ │ │ -00016cf0: 6c69 7374 6564 2028 6173 206d 616e 7920 listed (as many │ │ │ │ │ -00016d00: 6173 2066 6974 0a20 2020 2020 7265 6173 as fit. reas │ │ │ │ │ -00016d10: 6f6e 6162 6c79 2920 6f6e 2074 6865 2061 onably) on the a │ │ │ │ │ -00016d20: 6374 7561 6c20 636f 7665 722c 2061 6e64 ctual cover, and │ │ │ │ │ -00016d30: 2063 6f6e 7469 6e75 6520 7468 6520 7265 continue the re │ │ │ │ │ -00016d40: 7374 206f 6e74 6f0a 2020 2020 2061 646a st onto. adj │ │ │ │ │ -00016d50: 6163 656e 7420 7061 6765 732e 0a0a 2020 acent pages... │ │ │ │ │ -00016d60: 2020 2049 6620 796f 7520 7075 626c 6973 If you publis │ │ │ │ │ -00016d70: 6820 6f72 2064 6973 7472 6962 7574 6520 h or distribute │ │ │ │ │ -00016d80: 4f70 6171 7565 2063 6f70 6965 7320 6f66 Opaque copies of │ │ │ │ │ -00016d90: 2074 6865 2044 6f63 756d 656e 740a 2020 the Document. │ │ │ │ │ -00016da0: 2020 206e 756d 6265 7269 6e67 206d 6f72 numbering mor │ │ │ │ │ -00016db0: 6520 7468 616e 2031 3030 2c20 796f 7520 e than 100, you │ │ │ │ │ -00016dc0: 6d75 7374 2065 6974 6865 7220 696e 636c must either incl │ │ │ │ │ -00016dd0: 7564 6520 6120 6d61 6368 696e 652d 7265 ude a machine-re │ │ │ │ │ -00016de0: 6164 6162 6c65 0a20 2020 2020 5472 616e adable. Tran │ │ │ │ │ -00016df0: 7370 6172 656e 7420 636f 7079 2061 6c6f sparent copy alo │ │ │ │ │ -00016e00: 6e67 2077 6974 6820 6561 6368 204f 7061 ng with each Opa │ │ │ │ │ -00016e10: 7175 6520 636f 7079 2c20 6f72 2073 7461 que copy, or sta │ │ │ │ │ -00016e20: 7465 2069 6e20 6f72 2077 6974 680a 2020 te in or with. │ │ │ │ │ -00016e30: 2020 2065 6163 6820 4f70 6171 7565 2063 each Opaque c │ │ │ │ │ -00016e40: 6f70 7920 6120 636f 6d70 7574 6572 2d6e opy a computer-n │ │ │ │ │ -00016e50: 6574 776f 726b 206c 6f63 6174 696f 6e20 etwork location │ │ │ │ │ -00016e60: 6672 6f6d 2077 6869 6368 2074 6865 2067 from which the g │ │ │ │ │ -00016e70: 656e 6572 616c 0a20 2020 2020 6e65 7477 eneral. netw │ │ │ │ │ -00016e80: 6f72 6b2d 7573 696e 6720 7075 626c 6963 ork-using public │ │ │ │ │ -00016e90: 2068 6173 2061 6363 6573 7320 746f 2064 has access to d │ │ │ │ │ -00016ea0: 6f77 6e6c 6f61 6420 7573 696e 6720 7075 ownload using pu │ │ │ │ │ -00016eb0: 626c 6963 2d73 7461 6e64 6172 640a 2020 blic-standard. │ │ │ │ │ -00016ec0: 2020 206e 6574 776f 726b 2070 726f 746f network proto │ │ │ │ │ -00016ed0: 636f 6c73 2061 2063 6f6d 706c 6574 6520 cols a complete │ │ │ │ │ -00016ee0: 5472 616e 7370 6172 656e 7420 636f 7079 Transparent copy │ │ │ │ │ -00016ef0: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -00016f00: 2c20 6672 6565 0a20 2020 2020 6f66 2061 , free. of a │ │ │ │ │ -00016f10: 6464 6564 206d 6174 6572 6961 6c2e 2020 dded material. │ │ │ │ │ -00016f20: 4966 2079 6f75 2075 7365 2074 6865 206c If you use the l │ │ │ │ │ -00016f30: 6174 7465 7220 6f70 7469 6f6e 2c20 796f atter option, yo │ │ │ │ │ -00016f40: 7520 6d75 7374 2074 616b 650a 2020 2020 u must take. │ │ │ │ │ -00016f50: 2072 6561 736f 6e61 626c 7920 7072 7564 reasonably prud │ │ │ │ │ -00016f60: 656e 7420 7374 6570 732c 2077 6865 6e20 ent steps, when │ │ │ │ │ -00016f70: 796f 7520 6265 6769 6e20 6469 7374 7269 you begin distri │ │ │ │ │ -00016f80: 6275 7469 6f6e 206f 6620 4f70 6171 7565 bution of Opaque │ │ │ │ │ -00016f90: 0a20 2020 2020 636f 7069 6573 2069 6e20 . copies in │ │ │ │ │ -00016fa0: 7175 616e 7469 7479 2c20 746f 2065 6e73 quantity, to ens │ │ │ │ │ -00016fb0: 7572 6520 7468 6174 2074 6869 7320 5472 ure that this Tr │ │ │ │ │ -00016fc0: 616e 7370 6172 656e 7420 636f 7079 2077 ansparent copy w │ │ │ │ │ -00016fd0: 696c 6c0a 2020 2020 2072 656d 6169 6e20 ill. remain │ │ │ │ │ -00016fe0: 7468 7573 2061 6363 6573 7369 626c 6520 thus accessible │ │ │ │ │ -00016ff0: 6174 2074 6865 2073 7461 7465 6420 6c6f at the stated lo │ │ │ │ │ -00017000: 6361 7469 6f6e 2075 6e74 696c 2061 7420 cation until at │ │ │ │ │ -00017010: 6c65 6173 7420 6f6e 650a 2020 2020 2079 least one. y │ │ │ │ │ -00017020: 6561 7220 6166 7465 7220 7468 6520 6c61 ear after the la │ │ │ │ │ -00017030: 7374 2074 696d 6520 796f 7520 6469 7374 st time you dist │ │ │ │ │ -00017040: 7269 6275 7465 2061 6e20 4f70 6171 7565 ribute an Opaque │ │ │ │ │ -00017050: 2063 6f70 7920 2864 6972 6563 746c 7920 copy (directly │ │ │ │ │ -00017060: 6f72 0a20 2020 2020 7468 726f 7567 6820 or. through │ │ │ │ │ -00017070: 796f 7572 2061 6765 6e74 7320 6f72 2072 your agents or r │ │ │ │ │ -00017080: 6574 6169 6c65 7273 2920 6f66 2074 6861 etailers) of tha │ │ │ │ │ -00017090: 7420 6564 6974 696f 6e20 746f 2074 6865 t edition to the │ │ │ │ │ -000170a0: 2070 7562 6c69 632e 0a0a 2020 2020 2049 public... I │ │ │ │ │ -000170b0: 7420 6973 2072 6571 7565 7374 6564 2c20 t is requested, │ │ │ │ │ -000170c0: 6275 7420 6e6f 7420 7265 7175 6972 6564 but not required │ │ │ │ │ -000170d0: 2c20 7468 6174 2079 6f75 2063 6f6e 7461 , that you conta │ │ │ │ │ -000170e0: 6374 2074 6865 2061 7574 686f 7273 206f ct the authors o │ │ │ │ │ -000170f0: 660a 2020 2020 2074 6865 2044 6f63 756d f. the Docum │ │ │ │ │ -00017100: 656e 7420 7765 6c6c 2062 6566 6f72 6520 ent well before │ │ │ │ │ -00017110: 7265 6469 7374 7269 6275 7469 6e67 2061 redistributing a │ │ │ │ │ -00017120: 6e79 206c 6172 6765 206e 756d 6265 7220 ny large number │ │ │ │ │ -00017130: 6f66 2063 6f70 6965 732c 0a20 2020 2020 of copies,. │ │ │ │ │ -00017140: 746f 2067 6976 6520 7468 656d 2061 2063 to give them a c │ │ │ │ │ -00017150: 6861 6e63 6520 746f 2070 726f 7669 6465 hance to provide │ │ │ │ │ -00017160: 2079 6f75 2077 6974 6820 616e 2075 7064 you with an upd │ │ │ │ │ -00017170: 6174 6564 2076 6572 7369 6f6e 206f 6620 ated version of │ │ │ │ │ -00017180: 7468 650a 2020 2020 2044 6f63 756d 656e the. Documen │ │ │ │ │ -00017190: 742e 0a0a 2020 342e 204d 4f44 4946 4943 t... 4. MODIFIC │ │ │ │ │ -000171a0: 4154 494f 4e53 0a0a 2020 2020 2059 6f75 ATIONS.. You │ │ │ │ │ -000171b0: 206d 6179 2063 6f70 7920 616e 6420 6469 may copy and di │ │ │ │ │ -000171c0: 7374 7269 6275 7465 2061 204d 6f64 6966 stribute a Modif │ │ │ │ │ -000171d0: 6965 6420 5665 7273 696f 6e20 6f66 2074 ied Version of t │ │ │ │ │ -000171e0: 6865 2044 6f63 756d 656e 740a 2020 2020 he Document. │ │ │ │ │ -000171f0: 2075 6e64 6572 2074 6865 2063 6f6e 6469 under the condi │ │ │ │ │ -00017200: 7469 6f6e 7320 6f66 2073 6563 7469 6f6e tions of section │ │ │ │ │ -00017210: 7320 3220 616e 6420 3320 6162 6f76 652c s 2 and 3 above, │ │ │ │ │ -00017220: 2070 726f 7669 6465 6420 7468 6174 2079 provided that y │ │ │ │ │ -00017230: 6f75 0a20 2020 2020 7265 6c65 6173 6520 ou. release │ │ │ │ │ -00017240: 7468 6520 4d6f 6469 6669 6564 2056 6572 the Modified Ver │ │ │ │ │ -00017250: 7369 6f6e 2075 6e64 6572 2070 7265 6369 sion under preci │ │ │ │ │ -00017260: 7365 6c79 2074 6869 7320 4c69 6365 6e73 sely this Licens │ │ │ │ │ -00017270: 652c 2077 6974 6820 7468 650a 2020 2020 e, with the. │ │ │ │ │ -00017280: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ │ -00017290: 6e20 6669 6c6c 696e 6720 7468 6520 726f n filling the ro │ │ │ │ │ -000172a0: 6c65 206f 6620 7468 6520 446f 6375 6d65 le of the Docume │ │ │ │ │ -000172b0: 6e74 2c20 7468 7573 206c 6963 656e 7369 nt, thus licensi │ │ │ │ │ -000172c0: 6e67 0a20 2020 2020 6469 7374 7269 6275 ng. distribu │ │ │ │ │ -000172d0: 7469 6f6e 2061 6e64 206d 6f64 6966 6963 tion and modific │ │ │ │ │ -000172e0: 6174 696f 6e20 6f66 2074 6865 204d 6f64 ation of the Mod │ │ │ │ │ -000172f0: 6966 6965 6420 5665 7273 696f 6e20 746f ified Version to │ │ │ │ │ -00017300: 2077 686f 6576 6572 0a20 2020 2020 706f whoever. po │ │ │ │ │ -00017310: 7373 6573 7365 7320 6120 636f 7079 206f ssesses a copy o │ │ │ │ │ -00017320: 6620 6974 2e20 2049 6e20 6164 6469 7469 f it. In additi │ │ │ │ │ -00017330: 6f6e 2c20 796f 7520 6d75 7374 2064 6f20 on, you must do │ │ │ │ │ -00017340: 7468 6573 6520 7468 696e 6773 2069 6e0a these things in. │ │ │ │ │ -00017350: 2020 2020 2074 6865 204d 6f64 6966 6965 the Modifie │ │ │ │ │ -00017360: 6420 5665 7273 696f 6e3a 0a0a 2020 2020 d Version:.. │ │ │ │ │ -00017370: 2020 2041 2e20 5573 6520 696e 2074 6865 A. Use in the │ │ │ │ │ -00017380: 2054 6974 6c65 2050 6167 6520 2861 6e64 Title Page (and │ │ │ │ │ -00017390: 206f 6e20 7468 6520 636f 7665 7273 2c20 on the covers, │ │ │ │ │ -000173a0: 6966 2061 6e79 2920 6120 7469 746c 650a if any) a title. │ │ │ │ │ -000173b0: 2020 2020 2020 2020 2020 6469 7374 696e distin │ │ │ │ │ -000173c0: 6374 2066 726f 6d20 7468 6174 206f 6620 ct from that of │ │ │ │ │ -000173d0: 7468 6520 446f 6375 6d65 6e74 2c20 616e the Document, an │ │ │ │ │ -000173e0: 6420 6672 6f6d 2074 686f 7365 206f 6620 d from those of │ │ │ │ │ -000173f0: 7072 6576 696f 7573 0a20 2020 2020 2020 previous. │ │ │ │ │ -00017400: 2020 2076 6572 7369 6f6e 7320 2877 6869 versions (whi │ │ │ │ │ -00017410: 6368 2073 686f 756c 642c 2069 6620 7468 ch should, if th │ │ │ │ │ -00017420: 6572 6520 7765 7265 2061 6e79 2c20 6265 ere were any, be │ │ │ │ │ -00017430: 206c 6973 7465 6420 696e 2074 6865 0a20 listed in the. │ │ │ │ │ -00017440: 2020 2020 2020 2020 2048 6973 746f 7279 History │ │ │ │ │ -00017450: 2073 6563 7469 6f6e 206f 6620 7468 6520 section of the │ │ │ │ │ -00017460: 446f 6375 6d65 6e74 292e 2020 596f 7520 Document). You │ │ │ │ │ -00017470: 6d61 7920 7573 6520 7468 6520 7361 6d65 may use the same │ │ │ │ │ -00017480: 2074 6974 6c65 0a20 2020 2020 2020 2020 title. │ │ │ │ │ -00017490: 2061 7320 6120 7072 6576 696f 7573 2076 as a previous v │ │ │ │ │ -000174a0: 6572 7369 6f6e 2069 6620 7468 6520 6f72 ersion if the or │ │ │ │ │ -000174b0: 6967 696e 616c 2070 7562 6c69 7368 6572 iginal publisher │ │ │ │ │ -000174c0: 206f 6620 7468 6174 0a20 2020 2020 2020 of that. │ │ │ │ │ -000174d0: 2020 2076 6572 7369 6f6e 2067 6976 6573 version gives │ │ │ │ │ -000174e0: 2070 6572 6d69 7373 696f 6e2e 0a0a 2020 permission... │ │ │ │ │ -000174f0: 2020 2020 2042 2e20 4c69 7374 206f 6e20 B. List on │ │ │ │ │ -00017500: 7468 6520 5469 746c 6520 5061 6765 2c20 the Title Page, │ │ │ │ │ -00017510: 6173 2061 7574 686f 7273 2c20 6f6e 6520 as authors, one │ │ │ │ │ -00017520: 6f72 206d 6f72 6520 7065 7273 6f6e 7320 or more persons │ │ │ │ │ -00017530: 6f72 0a20 2020 2020 2020 2020 2065 6e74 or. ent │ │ │ │ │ -00017540: 6974 6965 7320 7265 7370 6f6e 7369 626c ities responsibl │ │ │ │ │ -00017550: 6520 666f 7220 6175 7468 6f72 7368 6970 e for authorship │ │ │ │ │ -00017560: 206f 6620 7468 6520 6d6f 6469 6669 6361 of the modifica │ │ │ │ │ -00017570: 7469 6f6e 7320 696e 0a20 2020 2020 2020 tions in. │ │ │ │ │ -00017580: 2020 2074 6865 204d 6f64 6966 6965 6420 the Modified │ │ │ │ │ -00017590: 5665 7273 696f 6e2c 2074 6f67 6574 6865 Version, togethe │ │ │ │ │ -000175a0: 7220 7769 7468 2061 7420 6c65 6173 7420 r with at least │ │ │ │ │ -000175b0: 6669 7665 206f 6620 7468 650a 2020 2020 five of the. │ │ │ │ │ -000175c0: 2020 2020 2020 7072 696e 6369 7061 6c20 principal │ │ │ │ │ -000175d0: 6175 7468 6f72 7320 6f66 2074 6865 2044 authors of the D │ │ │ │ │ -000175e0: 6f63 756d 656e 7420 2861 6c6c 206f 6620 ocument (all of │ │ │ │ │ -000175f0: 6974 7320 7072 696e 6369 7061 6c0a 2020 its principal. │ │ │ │ │ -00017600: 2020 2020 2020 2020 6175 7468 6f72 732c authors, │ │ │ │ │ -00017610: 2069 6620 6974 2068 6173 2066 6577 6572 if it has fewer │ │ │ │ │ -00017620: 2074 6861 6e20 6669 7665 292c 2075 6e6c than five), unl │ │ │ │ │ -00017630: 6573 7320 7468 6579 2072 656c 6561 7365 ess they release │ │ │ │ │ -00017640: 2079 6f75 0a20 2020 2020 2020 2020 2066 you. f │ │ │ │ │ -00017650: 726f 6d20 7468 6973 2072 6571 7569 7265 rom this require │ │ │ │ │ -00017660: 6d65 6e74 2e0a 0a20 2020 2020 2020 432e ment... C. │ │ │ │ │ -00017670: 2053 7461 7465 206f 6e20 7468 6520 5469 State on the Ti │ │ │ │ │ -00017680: 746c 6520 7061 6765 2074 6865 206e 616d tle page the nam │ │ │ │ │ -00017690: 6520 6f66 2074 6865 2070 7562 6c69 7368 e of the publish │ │ │ │ │ -000176a0: 6572 206f 6620 7468 650a 2020 2020 2020 er of the. │ │ │ │ │ -000176b0: 2020 2020 4d6f 6469 6669 6564 2056 6572 Modified Ver │ │ │ │ │ -000176c0: 7369 6f6e 2c20 6173 2074 6865 2070 7562 sion, as the pub │ │ │ │ │ -000176d0: 6c69 7368 6572 2e0a 0a20 2020 2020 2020 lisher... │ │ │ │ │ -000176e0: 442e 2050 7265 7365 7276 6520 616c 6c20 D. Preserve all │ │ │ │ │ -000176f0: 7468 6520 636f 7079 7269 6768 7420 6e6f the copyright no │ │ │ │ │ -00017700: 7469 6365 7320 6f66 2074 6865 2044 6f63 tices of the Doc │ │ │ │ │ -00017710: 756d 656e 742e 0a0a 2020 2020 2020 2045 ument... E │ │ │ │ │ -00017720: 2e20 4164 6420 616e 2061 7070 726f 7072 . Add an appropr │ │ │ │ │ -00017730: 6961 7465 2063 6f70 7972 6967 6874 206e iate copyright n │ │ │ │ │ -00017740: 6f74 6963 6520 666f 7220 796f 7572 206d otice for your m │ │ │ │ │ -00017750: 6f64 6966 6963 6174 696f 6e73 0a20 2020 odifications. │ │ │ │ │ -00017760: 2020 2020 2020 2061 646a 6163 656e 7420 adjacent │ │ │ │ │ -00017770: 746f 2074 6865 206f 7468 6572 2063 6f70 to the other cop │ │ │ │ │ -00017780: 7972 6967 6874 206e 6f74 6963 6573 2e0a yright notices.. │ │ │ │ │ -00017790: 0a20 2020 2020 2020 462e 2049 6e63 6c75 . F. Inclu │ │ │ │ │ -000177a0: 6465 2c20 696d 6d65 6469 6174 656c 7920 de, immediately │ │ │ │ │ -000177b0: 6166 7465 7220 7468 6520 636f 7079 7269 after the copyri │ │ │ │ │ -000177c0: 6768 7420 6e6f 7469 6365 732c 2061 206c ght notices, a l │ │ │ │ │ -000177d0: 6963 656e 7365 0a20 2020 2020 2020 2020 icense. │ │ │ │ │ -000177e0: 206e 6f74 6963 6520 6769 7669 6e67 2074 notice giving t │ │ │ │ │ -000177f0: 6865 2070 7562 6c69 6320 7065 726d 6973 he public permis │ │ │ │ │ -00017800: 7369 6f6e 2074 6f20 7573 6520 7468 6520 sion to use the │ │ │ │ │ -00017810: 4d6f 6469 6669 6564 0a20 2020 2020 2020 Modified. │ │ │ │ │ -00017820: 2020 2056 6572 7369 6f6e 2075 6e64 6572 Version under │ │ │ │ │ -00017830: 2074 6865 2074 6572 6d73 206f 6620 7468 the terms of th │ │ │ │ │ -00017840: 6973 204c 6963 656e 7365 2c20 696e 2074 is License, in t │ │ │ │ │ -00017850: 6865 2066 6f72 6d20 7368 6f77 6e20 696e he form shown in │ │ │ │ │ -00017860: 0a20 2020 2020 2020 2020 2074 6865 2041 . the A │ │ │ │ │ -00017870: 6464 656e 6475 6d20 6265 6c6f 772e 0a0a ddendum below... │ │ │ │ │ -00017880: 2020 2020 2020 2047 2e20 5072 6573 6572 G. Preser │ │ │ │ │ -00017890: 7665 2069 6e20 7468 6174 206c 6963 656e ve in that licen │ │ │ │ │ -000178a0: 7365 206e 6f74 6963 6520 7468 6520 6675 se notice the fu │ │ │ │ │ -000178b0: 6c6c 206c 6973 7473 206f 6620 496e 7661 ll lists of Inva │ │ │ │ │ -000178c0: 7269 616e 740a 2020 2020 2020 2020 2020 riant. │ │ │ │ │ -000178d0: 5365 6374 696f 6e73 2061 6e64 2072 6571 Sections and req │ │ │ │ │ -000178e0: 7569 7265 6420 436f 7665 7220 5465 7874 uired Cover Text │ │ │ │ │ -000178f0: 7320 6769 7665 6e20 696e 2074 6865 2044 s given in the D │ │ │ │ │ -00017900: 6f63 756d 656e 7427 730a 2020 2020 2020 ocument's. │ │ │ │ │ -00017910: 2020 2020 6c69 6365 6e73 6520 6e6f 7469 license noti │ │ │ │ │ -00017920: 6365 2e0a 0a20 2020 2020 2020 482e 2049 ce... H. I │ │ │ │ │ -00017930: 6e63 6c75 6465 2061 6e20 756e 616c 7465 nclude an unalte │ │ │ │ │ -00017940: 7265 6420 636f 7079 206f 6620 7468 6973 red copy of this │ │ │ │ │ -00017950: 204c 6963 656e 7365 2e0a 0a20 2020 2020 License... │ │ │ │ │ -00017960: 2020 492e 2050 7265 7365 7276 6520 7468 I. Preserve th │ │ │ │ │ -00017970: 6520 7365 6374 696f 6e20 456e 7469 746c e section Entitl │ │ │ │ │ -00017980: 6564 2022 4869 7374 6f72 7922 2c20 5072 ed "History", Pr │ │ │ │ │ -00017990: 6573 6572 7665 2069 7473 2054 6974 6c65 eserve its Title │ │ │ │ │ -000179a0: 2c0a 2020 2020 2020 2020 2020 616e 6420 ,. and │ │ │ │ │ -000179b0: 6164 6420 746f 2069 7420 616e 2069 7465 add to it an ite │ │ │ │ │ -000179c0: 6d20 7374 6174 696e 6720 6174 206c 6561 m stating at lea │ │ │ │ │ -000179d0: 7374 2074 6865 2074 6974 6c65 2c20 7965 st the title, ye │ │ │ │ │ -000179e0: 6172 2c20 6e65 770a 2020 2020 2020 2020 ar, new. │ │ │ │ │ -000179f0: 2020 6175 7468 6f72 732c 2061 6e64 2070 authors, and p │ │ │ │ │ -00017a00: 7562 6c69 7368 6572 206f 6620 7468 6520 ublisher of the │ │ │ │ │ -00017a10: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ │ -00017a20: 2061 7320 6769 7665 6e20 6f6e 2074 6865 as given on the │ │ │ │ │ -00017a30: 0a20 2020 2020 2020 2020 2054 6974 6c65 . Title │ │ │ │ │ -00017a40: 2050 6167 652e 2020 4966 2074 6865 7265 Page. If there │ │ │ │ │ -00017a50: 2069 7320 6e6f 2073 6563 7469 6f6e 2045 is no section E │ │ │ │ │ -00017a60: 6e74 6974 6c65 6420 2248 6973 746f 7279 ntitled "History │ │ │ │ │ -00017a70: 2220 696e 2074 6865 0a20 2020 2020 2020 " in the. │ │ │ │ │ -00017a80: 2020 2044 6f63 756d 656e 742c 2063 7265 Document, cre │ │ │ │ │ -00017a90: 6174 6520 6f6e 6520 7374 6174 696e 6720 ate one stating │ │ │ │ │ -00017aa0: 7468 6520 7469 746c 652c 2079 6561 722c the title, year, │ │ │ │ │ -00017ab0: 2061 7574 686f 7273 2c20 616e 640a 2020 authors, and. │ │ │ │ │ -00017ac0: 2020 2020 2020 2020 7075 626c 6973 6865 publishe │ │ │ │ │ -00017ad0: 7220 6f66 2074 6865 2044 6f63 756d 656e r of the Documen │ │ │ │ │ -00017ae0: 7420 6173 2067 6976 656e 206f 6e20 6974 t as given on it │ │ │ │ │ -00017af0: 7320 5469 746c 6520 5061 6765 2c20 7468 s Title Page, th │ │ │ │ │ -00017b00: 656e 2061 6464 0a20 2020 2020 2020 2020 en add. │ │ │ │ │ -00017b10: 2061 6e20 6974 656d 2064 6573 6372 6962 an item describ │ │ │ │ │ -00017b20: 696e 6720 7468 6520 4d6f 6469 6669 6564 ing the Modified │ │ │ │ │ -00017b30: 2056 6572 7369 6f6e 2061 7320 7374 6174 Version as stat │ │ │ │ │ -00017b40: 6564 2069 6e20 7468 650a 2020 2020 2020 ed in the. │ │ │ │ │ -00017b50: 2020 2020 7072 6576 696f 7573 2073 656e previous sen │ │ │ │ │ -00017b60: 7465 6e63 652e 0a0a 2020 2020 2020 204a tence... J │ │ │ │ │ -00017b70: 2e20 5072 6573 6572 7665 2074 6865 206e . Preserve the n │ │ │ │ │ -00017b80: 6574 776f 726b 206c 6f63 6174 696f 6e2c etwork location, │ │ │ │ │ -00017b90: 2069 6620 616e 792c 2067 6976 656e 2069 if any, given i │ │ │ │ │ -00017ba0: 6e20 7468 6520 446f 6375 6d65 6e74 0a20 n the Document. │ │ │ │ │ -00017bb0: 2020 2020 2020 2020 2066 6f72 2070 7562 for pub │ │ │ │ │ -00017bc0: 6c69 6320 6163 6365 7373 2074 6f20 6120 lic access to a │ │ │ │ │ -00017bd0: 5472 616e 7370 6172 656e 7420 636f 7079 Transparent copy │ │ │ │ │ -00017be0: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -00017bf0: 2c20 616e 640a 2020 2020 2020 2020 2020 , and. │ │ │ │ │ -00017c00: 6c69 6b65 7769 7365 2074 6865 206e 6574 likewise the net │ │ │ │ │ -00017c10: 776f 726b 206c 6f63 6174 696f 6e73 2067 work locations g │ │ │ │ │ -00017c20: 6976 656e 2069 6e20 7468 6520 446f 6375 iven in the Docu │ │ │ │ │ -00017c30: 6d65 6e74 2066 6f72 0a20 2020 2020 2020 ment for. │ │ │ │ │ -00017c40: 2020 2070 7265 7669 6f75 7320 7665 7273 previous vers │ │ │ │ │ -00017c50: 696f 6e73 2069 7420 7761 7320 6261 7365 ions it was base │ │ │ │ │ -00017c60: 6420 6f6e 2e20 2054 6865 7365 206d 6179 d on. These may │ │ │ │ │ -00017c70: 2062 6520 706c 6163 6564 2069 6e20 7468 be placed in th │ │ │ │ │ -00017c80: 650a 2020 2020 2020 2020 2020 2248 6973 e. "His │ │ │ │ │ -00017c90: 746f 7279 2220 7365 6374 696f 6e2e 2020 tory" section. │ │ │ │ │ -00017ca0: 596f 7520 6d61 7920 6f6d 6974 2061 206e You may omit a n │ │ │ │ │ -00017cb0: 6574 776f 726b 206c 6f63 6174 696f 6e20 etwork location │ │ │ │ │ -00017cc0: 666f 7220 6120 776f 726b 0a20 2020 2020 for a work. │ │ │ │ │ -00017cd0: 2020 2020 2074 6861 7420 7761 7320 7075 that was pu │ │ │ │ │ -00017ce0: 626c 6973 6865 6420 6174 206c 6561 7374 blished at least │ │ │ │ │ -00017cf0: 2066 6f75 7220 7965 6172 7320 6265 666f four years befo │ │ │ │ │ -00017d00: 7265 2074 6865 2044 6f63 756d 656e 740a re the Document. │ │ │ │ │ -00017d10: 2020 2020 2020 2020 2020 6974 7365 6c66 itself │ │ │ │ │ -00017d20: 2c20 6f72 2069 6620 7468 6520 6f72 6967 , or if the orig │ │ │ │ │ -00017d30: 696e 616c 2070 7562 6c69 7368 6572 206f inal publisher o │ │ │ │ │ -00017d40: 6620 7468 6520 7665 7273 696f 6e20 6974 f the version it │ │ │ │ │ -00017d50: 2072 6566 6572 730a 2020 2020 2020 2020 refers. │ │ │ │ │ -00017d60: 2020 746f 2067 6976 6573 2070 6572 6d69 to gives permi │ │ │ │ │ -00017d70: 7373 696f 6e2e 0a0a 2020 2020 2020 204b ssion... K │ │ │ │ │ -00017d80: 2e20 466f 7220 616e 7920 7365 6374 696f . For any sectio │ │ │ │ │ -00017d90: 6e20 456e 7469 746c 6564 2022 4163 6b6e n Entitled "Ackn │ │ │ │ │ -00017da0: 6f77 6c65 6467 656d 656e 7473 2220 6f72 owledgements" or │ │ │ │ │ -00017db0: 2022 4465 6469 6361 7469 6f6e 7322 2c0a "Dedications",. │ │ │ │ │ -00017dc0: 2020 2020 2020 2020 2020 5072 6573 6572 Preser │ │ │ │ │ -00017dd0: 7665 2074 6865 2054 6974 6c65 206f 6620 ve the Title of │ │ │ │ │ -00017de0: 7468 6520 7365 6374 696f 6e2c 2061 6e64 the section, and │ │ │ │ │ -00017df0: 2070 7265 7365 7276 6520 696e 2074 6865 preserve in the │ │ │ │ │ -00017e00: 2073 6563 7469 6f6e 0a20 2020 2020 2020 section. │ │ │ │ │ -00017e10: 2020 2061 6c6c 2074 6865 2073 7562 7374 all the subst │ │ │ │ │ -00017e20: 616e 6365 2061 6e64 2074 6f6e 6520 6f66 ance and tone of │ │ │ │ │ -00017e30: 2065 6163 6820 6f66 2074 6865 2063 6f6e each of the con │ │ │ │ │ -00017e40: 7472 6962 7574 6f72 0a20 2020 2020 2020 tributor. │ │ │ │ │ -00017e50: 2020 2061 636b 6e6f 776c 6564 6765 6d65 acknowledgeme │ │ │ │ │ -00017e60: 6e74 7320 616e 642f 6f72 2064 6564 6963 nts and/or dedic │ │ │ │ │ -00017e70: 6174 696f 6e73 2067 6976 656e 2074 6865 ations given the │ │ │ │ │ -00017e80: 7265 696e 2e0a 0a20 2020 2020 2020 4c2e rein... L. │ │ │ │ │ -00017e90: 2050 7265 7365 7276 6520 616c 6c20 7468 Preserve all th │ │ │ │ │ -00017ea0: 6520 496e 7661 7269 616e 7420 5365 6374 e Invariant Sect │ │ │ │ │ -00017eb0: 696f 6e73 206f 6620 7468 6520 446f 6375 ions of the Docu │ │ │ │ │ -00017ec0: 6d65 6e74 2c20 756e 616c 7465 7265 640a ment, unaltered. │ │ │ │ │ -00017ed0: 2020 2020 2020 2020 2020 696e 2074 6865 in the │ │ │ │ │ -00017ee0: 6972 2074 6578 7420 616e 6420 696e 2074 ir text and in t │ │ │ │ │ -00017ef0: 6865 6972 2074 6974 6c65 732e 2020 5365 heir titles. Se │ │ │ │ │ -00017f00: 6374 696f 6e20 6e75 6d62 6572 7320 6f72 ction numbers or │ │ │ │ │ -00017f10: 2074 6865 0a20 2020 2020 2020 2020 2065 the. e │ │ │ │ │ -00017f20: 7175 6976 616c 656e 7420 6172 6520 6e6f quivalent are no │ │ │ │ │ -00017f30: 7420 636f 6e73 6964 6572 6564 2070 6172 t considered par │ │ │ │ │ -00017f40: 7420 6f66 2074 6865 2073 6563 7469 6f6e t of the section │ │ │ │ │ -00017f50: 2074 6974 6c65 732e 0a0a 2020 2020 2020 titles... │ │ │ │ │ -00017f60: 204d 2e20 4465 6c65 7465 2061 6e79 2073 M. Delete any s │ │ │ │ │ -00017f70: 6563 7469 6f6e 2045 6e74 6974 6c65 6420 ection Entitled │ │ │ │ │ -00017f80: 2245 6e64 6f72 7365 6d65 6e74 7322 2e20 "Endorsements". │ │ │ │ │ -00017f90: 2053 7563 6820 6120 7365 6374 696f 6e0a Such a section. │ │ │ │ │ -00017fa0: 2020 2020 2020 2020 2020 6d61 7920 6e6f may no │ │ │ │ │ -00017fb0: 7420 6265 2069 6e63 6c75 6465 6420 696e t be included in │ │ │ │ │ -00017fc0: 2074 6865 204d 6f64 6966 6965 6420 5665 the Modified Ve │ │ │ │ │ -00017fd0: 7273 696f 6e2e 0a0a 2020 2020 2020 204e rsion... N │ │ │ │ │ -00017fe0: 2e20 446f 206e 6f74 2072 6574 6974 6c65 . Do not retitle │ │ │ │ │ -00017ff0: 2061 6e79 2065 7869 7374 696e 6720 7365 any existing se │ │ │ │ │ -00018000: 6374 696f 6e20 746f 2062 6520 456e 7469 ction to be Enti │ │ │ │ │ -00018010: 746c 6564 0a20 2020 2020 2020 2020 2022 tled. " │ │ │ │ │ -00018020: 456e 646f 7273 656d 656e 7473 2220 6f72 Endorsements" or │ │ │ │ │ -00018030: 2074 6f20 636f 6e66 6c69 6374 2069 6e20 to conflict in │ │ │ │ │ -00018040: 7469 746c 6520 7769 7468 2061 6e79 2049 title with any I │ │ │ │ │ -00018050: 6e76 6172 6961 6e74 0a20 2020 2020 2020 nvariant. │ │ │ │ │ -00018060: 2020 2053 6563 7469 6f6e 2e0a 0a20 2020 Section... │ │ │ │ │ -00018070: 2020 2020 4f2e 2050 7265 7365 7276 6520 O. Preserve │ │ │ │ │ -00018080: 616e 7920 5761 7272 616e 7479 2044 6973 any Warranty Dis │ │ │ │ │ -00018090: 636c 6169 6d65 7273 2e0a 0a20 2020 2020 claimers... │ │ │ │ │ -000180a0: 4966 2074 6865 204d 6f64 6966 6965 6420 If the Modified │ │ │ │ │ -000180b0: 5665 7273 696f 6e20 696e 636c 7564 6573 Version includes │ │ │ │ │ -000180c0: 206e 6577 2066 726f 6e74 2d6d 6174 7465 new front-matte │ │ │ │ │ -000180d0: 7220 7365 6374 696f 6e73 206f 720a 2020 r sections or. │ │ │ │ │ -000180e0: 2020 2061 7070 656e 6469 6365 7320 7468 appendices th │ │ │ │ │ -000180f0: 6174 2071 7561 6c69 6679 2061 7320 5365 at qualify as Se │ │ │ │ │ -00018100: 636f 6e64 6172 7920 5365 6374 696f 6e73 condary Sections │ │ │ │ │ -00018110: 2061 6e64 2063 6f6e 7461 696e 206e 6f0a and contain no. │ │ │ │ │ -00018120: 2020 2020 206d 6174 6572 6961 6c20 636f material co │ │ │ │ │ -00018130: 7069 6564 2066 726f 6d20 7468 6520 446f pied from the Do │ │ │ │ │ -00018140: 6375 6d65 6e74 2c20 796f 7520 6d61 7920 cument, you may │ │ │ │ │ -00018150: 6174 2079 6f75 7220 6f70 7469 6f6e 2064 at your option d │ │ │ │ │ -00018160: 6573 6967 6e61 7465 0a20 2020 2020 736f esignate. so │ │ │ │ │ -00018170: 6d65 206f 7220 616c 6c20 6f66 2074 6865 me or all of the │ │ │ │ │ -00018180: 7365 2073 6563 7469 6f6e 7320 6173 2069 se sections as i │ │ │ │ │ -00018190: 6e76 6172 6961 6e74 2e20 2054 6f20 646f nvariant. To do │ │ │ │ │ -000181a0: 2074 6869 732c 2061 6464 2074 6865 6972 this, add their │ │ │ │ │ -000181b0: 0a20 2020 2020 7469 746c 6573 2074 6f20 . titles to │ │ │ │ │ -000181c0: 7468 6520 6c69 7374 206f 6620 496e 7661 the list of Inva │ │ │ │ │ -000181d0: 7269 616e 7420 5365 6374 696f 6e73 2069 riant Sections i │ │ │ │ │ -000181e0: 6e20 7468 6520 4d6f 6469 6669 6564 2056 n the Modified V │ │ │ │ │ -000181f0: 6572 7369 6f6e 2773 0a20 2020 2020 6c69 ersion's. li │ │ │ │ │ -00018200: 6365 6e73 6520 6e6f 7469 6365 2e20 2054 cense notice. T │ │ │ │ │ -00018210: 6865 7365 2074 6974 6c65 7320 6d75 7374 hese titles must │ │ │ │ │ -00018220: 2062 6520 6469 7374 696e 6374 2066 726f be distinct fro │ │ │ │ │ -00018230: 6d20 616e 7920 6f74 6865 720a 2020 2020 m any other. │ │ │ │ │ -00018240: 2073 6563 7469 6f6e 2074 6974 6c65 732e section titles. │ │ │ │ │ -00018250: 0a0a 2020 2020 2059 6f75 206d 6179 2061 .. You may a │ │ │ │ │ -00018260: 6464 2061 2073 6563 7469 6f6e 2045 6e74 dd a section Ent │ │ │ │ │ -00018270: 6974 6c65 6420 2245 6e64 6f72 7365 6d65 itled "Endorseme │ │ │ │ │ -00018280: 6e74 7322 2c20 7072 6f76 6964 6564 2069 nts", provided i │ │ │ │ │ -00018290: 7420 636f 6e74 6169 6e73 0a20 2020 2020 t contains. │ │ │ │ │ -000182a0: 6e6f 7468 696e 6720 6275 7420 656e 646f nothing but endo │ │ │ │ │ -000182b0: 7273 656d 656e 7473 206f 6620 796f 7572 rsements of your │ │ │ │ │ -000182c0: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ │ -000182d0: 6e20 6279 2076 6172 696f 7573 0a20 2020 n by various. │ │ │ │ │ -000182e0: 2020 7061 7274 6965 732d 2d66 6f72 2065 parties--for e │ │ │ │ │ -000182f0: 7861 6d70 6c65 2c20 7374 6174 656d 656e xample, statemen │ │ │ │ │ -00018300: 7473 206f 6620 7065 6572 2072 6576 6965 ts of peer revie │ │ │ │ │ -00018310: 7720 6f72 2074 6861 7420 7468 6520 7465 w or that the te │ │ │ │ │ -00018320: 7874 0a20 2020 2020 6861 7320 6265 656e xt. has been │ │ │ │ │ -00018330: 2061 7070 726f 7665 6420 6279 2061 6e20 approved by an │ │ │ │ │ -00018340: 6f72 6761 6e69 7a61 7469 6f6e 2061 7320 organization as │ │ │ │ │ -00018350: 7468 6520 6175 7468 6f72 6974 6174 6976 the authoritativ │ │ │ │ │ -00018360: 650a 2020 2020 2064 6566 696e 6974 696f e. definitio │ │ │ │ │ -00018370: 6e20 6f66 2061 2073 7461 6e64 6172 642e n of a standard. │ │ │ │ │ -00018380: 0a0a 2020 2020 2059 6f75 206d 6179 2061 .. You may a │ │ │ │ │ -00018390: 6464 2061 2070 6173 7361 6765 206f 6620 dd a passage of │ │ │ │ │ -000183a0: 7570 2074 6f20 6669 7665 2077 6f72 6473 up to five words │ │ │ │ │ -000183b0: 2061 7320 6120 4672 6f6e 742d 436f 7665 as a Front-Cove │ │ │ │ │ -000183c0: 7220 5465 7874 2c0a 2020 2020 2061 6e64 r Text,. and │ │ │ │ │ -000183d0: 2061 2070 6173 7361 6765 206f 6620 7570 a passage of up │ │ │ │ │ -000183e0: 2074 6f20 3235 2077 6f72 6473 2061 7320 to 25 words as │ │ │ │ │ -000183f0: 6120 4261 636b 2d43 6f76 6572 2054 6578 a Back-Cover Tex │ │ │ │ │ -00018400: 742c 2074 6f20 7468 6520 656e 6420 6f66 t, to the end of │ │ │ │ │ -00018410: 0a20 2020 2020 7468 6520 6c69 7374 206f . the list o │ │ │ │ │ -00018420: 6620 436f 7665 7220 5465 7874 7320 696e f Cover Texts in │ │ │ │ │ -00018430: 2074 6865 204d 6f64 6966 6965 6420 5665 the Modified Ve │ │ │ │ │ -00018440: 7273 696f 6e2e 2020 4f6e 6c79 206f 6e65 rsion. Only one │ │ │ │ │ -00018450: 2070 6173 7361 6765 0a20 2020 2020 6f66 passage. of │ │ │ │ │ -00018460: 2046 726f 6e74 2d43 6f76 6572 2054 6578 Front-Cover Tex │ │ │ │ │ -00018470: 7420 616e 6420 6f6e 6520 6f66 2042 6163 t and one of Bac │ │ │ │ │ -00018480: 6b2d 436f 7665 7220 5465 7874 206d 6179 k-Cover Text may │ │ │ │ │ -00018490: 2062 6520 6164 6465 6420 6279 2028 6f72 be added by (or │ │ │ │ │ -000184a0: 0a20 2020 2020 7468 726f 7567 6820 6172 . through ar │ │ │ │ │ -000184b0: 7261 6e67 656d 656e 7473 206d 6164 6520 rangements made │ │ │ │ │ -000184c0: 6279 2920 616e 7920 6f6e 6520 656e 7469 by) any one enti │ │ │ │ │ -000184d0: 7479 2e20 2049 6620 7468 6520 446f 6375 ty. If the Docu │ │ │ │ │ -000184e0: 6d65 6e74 0a20 2020 2020 616c 7265 6164 ment. alread │ │ │ │ │ -000184f0: 7920 696e 636c 7564 6573 2061 2063 6f76 y includes a cov │ │ │ │ │ -00018500: 6572 2074 6578 7420 666f 7220 7468 6520 er text for the │ │ │ │ │ -00018510: 7361 6d65 2063 6f76 6572 2c20 7072 6576 same cover, prev │ │ │ │ │ -00018520: 696f 7573 6c79 2061 6464 6564 0a20 2020 iously added. │ │ │ │ │ -00018530: 2020 6279 2079 6f75 206f 7220 6279 2061 by you or by a │ │ │ │ │ -00018540: 7272 616e 6765 6d65 6e74 206d 6164 6520 rrangement made │ │ │ │ │ -00018550: 6279 2074 6865 2073 616d 6520 656e 7469 by the same enti │ │ │ │ │ -00018560: 7479 2079 6f75 2061 7265 2061 6374 696e ty you are actin │ │ │ │ │ -00018570: 6720 6f6e 0a20 2020 2020 6265 6861 6c66 g on. behalf │ │ │ │ │ -00018580: 206f 662c 2079 6f75 206d 6179 206e 6f74 of, you may not │ │ │ │ │ -00018590: 2061 6464 2061 6e6f 7468 6572 3b20 6275 add another; bu │ │ │ │ │ -000185a0: 7420 796f 7520 6d61 7920 7265 706c 6163 t you may replac │ │ │ │ │ -000185b0: 6520 7468 6520 6f6c 640a 2020 2020 206f e the old. o │ │ │ │ │ -000185c0: 6e65 2c20 6f6e 2065 7870 6c69 6369 7420 ne, on explicit │ │ │ │ │ -000185d0: 7065 726d 6973 7369 6f6e 2066 726f 6d20 permission from │ │ │ │ │ -000185e0: 7468 6520 7072 6576 696f 7573 2070 7562 the previous pub │ │ │ │ │ -000185f0: 6c69 7368 6572 2074 6861 7420 6164 6465 lisher that adde │ │ │ │ │ -00018600: 640a 2020 2020 2074 6865 206f 6c64 206f d. the old o │ │ │ │ │ -00018610: 6e65 2e0a 0a20 2020 2020 5468 6520 6175 ne... The au │ │ │ │ │ -00018620: 7468 6f72 2873 2920 616e 6420 7075 626c thor(s) and publ │ │ │ │ │ -00018630: 6973 6865 7228 7329 206f 6620 7468 6520 isher(s) of the │ │ │ │ │ -00018640: 446f 6375 6d65 6e74 2064 6f20 6e6f 7420 Document do not │ │ │ │ │ -00018650: 6279 2074 6869 730a 2020 2020 204c 6963 by this. Lic │ │ │ │ │ -00018660: 656e 7365 2067 6976 6520 7065 726d 6973 ense give permis │ │ │ │ │ -00018670: 7369 6f6e 2074 6f20 7573 6520 7468 6569 sion to use thei │ │ │ │ │ -00018680: 7220 6e61 6d65 7320 666f 7220 7075 626c r names for publ │ │ │ │ │ -00018690: 6963 6974 7920 666f 7220 6f72 2074 6f0a icity for or to. │ │ │ │ │ -000186a0: 2020 2020 2061 7373 6572 7420 6f72 2069 assert or i │ │ │ │ │ -000186b0: 6d70 6c79 2065 6e64 6f72 7365 6d65 6e74 mply endorsement │ │ │ │ │ -000186c0: 206f 6620 616e 7920 4d6f 6469 6669 6564 of any Modified │ │ │ │ │ -000186d0: 2056 6572 7369 6f6e 2e0a 0a20 2035 2e20 Version... 5. │ │ │ │ │ -000186e0: 434f 4d42 494e 494e 4720 444f 4355 4d45 COMBINING DOCUME │ │ │ │ │ -000186f0: 4e54 530a 0a20 2020 2020 596f 7520 6d61 NTS.. You ma │ │ │ │ │ -00018700: 7920 636f 6d62 696e 6520 7468 6520 446f y combine the Do │ │ │ │ │ -00018710: 6375 6d65 6e74 2077 6974 6820 6f74 6865 cument with othe │ │ │ │ │ -00018720: 7220 646f 6375 6d65 6e74 7320 7265 6c65 r documents rele │ │ │ │ │ -00018730: 6173 6564 2075 6e64 6572 0a20 2020 2020 ased under. │ │ │ │ │ -00018740: 7468 6973 204c 6963 656e 7365 2c20 756e this License, un │ │ │ │ │ -00018750: 6465 7220 7468 6520 7465 726d 7320 6465 der the terms de │ │ │ │ │ -00018760: 6669 6e65 6420 696e 2073 6563 7469 6f6e fined in section │ │ │ │ │ -00018770: 2034 2061 626f 7665 2066 6f72 0a20 2020 4 above for. │ │ │ │ │ -00018780: 2020 6d6f 6469 6669 6564 2076 6572 7369 modified versi │ │ │ │ │ -00018790: 6f6e 732c 2070 726f 7669 6465 6420 7468 ons, provided th │ │ │ │ │ -000187a0: 6174 2079 6f75 2069 6e63 6c75 6465 2069 at you include i │ │ │ │ │ -000187b0: 6e20 7468 6520 636f 6d62 696e 6174 696f n the combinatio │ │ │ │ │ -000187c0: 6e20 616c 6c0a 2020 2020 206f 6620 7468 n all. of th │ │ │ │ │ -000187d0: 6520 496e 7661 7269 616e 7420 5365 6374 e Invariant Sect │ │ │ │ │ -000187e0: 696f 6e73 206f 6620 616c 6c20 6f66 2074 ions of all of t │ │ │ │ │ -000187f0: 6865 206f 7269 6769 6e61 6c20 646f 6375 he original docu │ │ │ │ │ -00018800: 6d65 6e74 732c 0a20 2020 2020 756e 6d6f ments,. unmo │ │ │ │ │ -00018810: 6469 6669 6564 2c20 616e 6420 6c69 7374 dified, and list │ │ │ │ │ -00018820: 2074 6865 6d20 616c 6c20 6173 2049 6e76 them all as Inv │ │ │ │ │ -00018830: 6172 6961 6e74 2053 6563 7469 6f6e 7320 ariant Sections │ │ │ │ │ -00018840: 6f66 2079 6f75 720a 2020 2020 2063 6f6d of your. com │ │ │ │ │ -00018850: 6269 6e65 6420 776f 726b 2069 6e20 6974 bined work in it │ │ │ │ │ -00018860: 7320 6c69 6365 6e73 6520 6e6f 7469 6365 s license notice │ │ │ │ │ -00018870: 2c20 616e 6420 7468 6174 2079 6f75 2070 , and that you p │ │ │ │ │ -00018880: 7265 7365 7276 6520 616c 6c0a 2020 2020 reserve all. │ │ │ │ │ -00018890: 2074 6865 6972 2057 6172 7261 6e74 7920 their Warranty │ │ │ │ │ -000188a0: 4469 7363 6c61 696d 6572 732e 0a0a 2020 Disclaimers... │ │ │ │ │ -000188b0: 2020 2054 6865 2063 6f6d 6269 6e65 6420 The combined │ │ │ │ │ -000188c0: 776f 726b 206e 6565 6420 6f6e 6c79 2063 work need only c │ │ │ │ │ -000188d0: 6f6e 7461 696e 206f 6e65 2063 6f70 7920 ontain one copy │ │ │ │ │ -000188e0: 6f66 2074 6869 7320 4c69 6365 6e73 652c of this License, │ │ │ │ │ -000188f0: 2061 6e64 0a20 2020 2020 6d75 6c74 6970 and. multip │ │ │ │ │ -00018900: 6c65 2069 6465 6e74 6963 616c 2049 6e76 le identical Inv │ │ │ │ │ -00018910: 6172 6961 6e74 2053 6563 7469 6f6e 7320 ariant Sections │ │ │ │ │ -00018920: 6d61 7920 6265 2072 6570 6c61 6365 6420 may be replaced │ │ │ │ │ -00018930: 7769 7468 2061 2073 696e 676c 650a 2020 with a single. │ │ │ │ │ -00018940: 2020 2063 6f70 792e 2020 4966 2074 6865 copy. If the │ │ │ │ │ -00018950: 7265 2061 7265 206d 756c 7469 706c 6520 re are multiple │ │ │ │ │ -00018960: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ │ -00018970: 6e73 2077 6974 6820 7468 6520 7361 6d65 ns with the same │ │ │ │ │ -00018980: 206e 616d 650a 2020 2020 2062 7574 2064 name. but d │ │ │ │ │ -00018990: 6966 6665 7265 6e74 2063 6f6e 7465 6e74 ifferent content │ │ │ │ │ -000189a0: 732c 206d 616b 6520 7468 6520 7469 746c s, make the titl │ │ │ │ │ -000189b0: 6520 6f66 2065 6163 6820 7375 6368 2073 e of each such s │ │ │ │ │ -000189c0: 6563 7469 6f6e 2075 6e69 7175 650a 2020 ection unique. │ │ │ │ │ -000189d0: 2020 2062 7920 6164 6469 6e67 2061 7420 by adding at │ │ │ │ │ -000189e0: 7468 6520 656e 6420 6f66 2069 742c 2069 the end of it, i │ │ │ │ │ -000189f0: 6e20 7061 7265 6e74 6865 7365 732c 2074 n parentheses, t │ │ │ │ │ -00018a00: 6865 206e 616d 6520 6f66 2074 6865 0a20 he name of the. │ │ │ │ │ -00018a10: 2020 2020 6f72 6967 696e 616c 2061 7574 original aut │ │ │ │ │ -00018a20: 686f 7220 6f72 2070 7562 6c69 7368 6572 hor or publisher │ │ │ │ │ -00018a30: 206f 6620 7468 6174 2073 6563 7469 6f6e of that section │ │ │ │ │ -00018a40: 2069 6620 6b6e 6f77 6e2c 206f 7220 656c if known, or el │ │ │ │ │ -00018a50: 7365 2061 0a20 2020 2020 756e 6971 7565 se a. unique │ │ │ │ │ -00018a60: 206e 756d 6265 722e 2020 4d61 6b65 2074 number. Make t │ │ │ │ │ -00018a70: 6865 2073 616d 6520 6164 6a75 7374 6d65 he same adjustme │ │ │ │ │ -00018a80: 6e74 2074 6f20 7468 6520 7365 6374 696f nt to the sectio │ │ │ │ │ -00018a90: 6e20 7469 746c 6573 2069 6e0a 2020 2020 n titles in. │ │ │ │ │ -00018aa0: 2074 6865 206c 6973 7420 6f66 2049 6e76 the list of Inv │ │ │ │ │ -00018ab0: 6172 6961 6e74 2053 6563 7469 6f6e 7320 ariant Sections │ │ │ │ │ -00018ac0: 696e 2074 6865 206c 6963 656e 7365 206e in the license n │ │ │ │ │ -00018ad0: 6f74 6963 6520 6f66 2074 6865 0a20 2020 otice of the. │ │ │ │ │ -00018ae0: 2020 636f 6d62 696e 6564 2077 6f72 6b2e combined work. │ │ │ │ │ -00018af0: 0a0a 2020 2020 2049 6e20 7468 6520 636f .. In the co │ │ │ │ │ -00018b00: 6d62 696e 6174 696f 6e2c 2079 6f75 206d mbination, you m │ │ │ │ │ -00018b10: 7573 7420 636f 6d62 696e 6520 616e 7920 ust combine any │ │ │ │ │ -00018b20: 7365 6374 696f 6e73 2045 6e74 6974 6c65 sections Entitle │ │ │ │ │ -00018b30: 640a 2020 2020 2022 4869 7374 6f72 7922 d. "History" │ │ │ │ │ -00018b40: 2069 6e20 7468 6520 7661 7269 6f75 7320 in the various │ │ │ │ │ -00018b50: 6f72 6967 696e 616c 2064 6f63 756d 656e original documen │ │ │ │ │ -00018b60: 7473 2c20 666f 726d 696e 6720 6f6e 6520 ts, forming one │ │ │ │ │ -00018b70: 7365 6374 696f 6e0a 2020 2020 2045 6e74 section. Ent │ │ │ │ │ -00018b80: 6974 6c65 6420 2248 6973 746f 7279 223b itled "History"; │ │ │ │ │ -00018b90: 206c 696b 6577 6973 6520 636f 6d62 696e likewise combin │ │ │ │ │ -00018ba0: 6520 616e 7920 7365 6374 696f 6e73 2045 e any sections E │ │ │ │ │ -00018bb0: 6e74 6974 6c65 640a 2020 2020 2022 4163 ntitled. "Ac │ │ │ │ │ -00018bc0: 6b6e 6f77 6c65 6467 656d 656e 7473 222c knowledgements", │ │ │ │ │ -00018bd0: 2061 6e64 2061 6e79 2073 6563 7469 6f6e and any section │ │ │ │ │ -00018be0: 7320 456e 7469 746c 6564 2022 4465 6469 s Entitled "Dedi │ │ │ │ │ -00018bf0: 6361 7469 6f6e 7322 2e20 2059 6f75 0a20 cations". You. │ │ │ │ │ -00018c00: 2020 2020 6d75 7374 2064 656c 6574 6520 must delete │ │ │ │ │ -00018c10: 616c 6c20 7365 6374 696f 6e73 2045 6e74 all sections Ent │ │ │ │ │ -00018c20: 6974 6c65 6420 2245 6e64 6f72 7365 6d65 itled "Endorseme │ │ │ │ │ -00018c30: 6e74 732e 220a 0a20 2036 2e20 434f 4c4c nts.".. 6. COLL │ │ │ │ │ -00018c40: 4543 5449 4f4e 5320 4f46 2044 4f43 554d ECTIONS OF DOCUM │ │ │ │ │ -00018c50: 454e 5453 0a0a 2020 2020 2059 6f75 206d ENTS.. You m │ │ │ │ │ -00018c60: 6179 206d 616b 6520 6120 636f 6c6c 6563 ay make a collec │ │ │ │ │ -00018c70: 7469 6f6e 2063 6f6e 7369 7374 696e 6720 tion consisting │ │ │ │ │ -00018c80: 6f66 2074 6865 2044 6f63 756d 656e 7420 of the Document │ │ │ │ │ -00018c90: 616e 6420 6f74 6865 720a 2020 2020 2064 and other. d │ │ │ │ │ -00018ca0: 6f63 756d 656e 7473 2072 656c 6561 7365 ocuments release │ │ │ │ │ -00018cb0: 6420 756e 6465 7220 7468 6973 204c 6963 d under this Lic │ │ │ │ │ -00018cc0: 656e 7365 2c20 616e 6420 7265 706c 6163 ense, and replac │ │ │ │ │ -00018cd0: 6520 7468 6520 696e 6469 7669 6475 616c e the individual │ │ │ │ │ -00018ce0: 0a20 2020 2020 636f 7069 6573 206f 6620 . copies of │ │ │ │ │ -00018cf0: 7468 6973 204c 6963 656e 7365 2069 6e20 this License in │ │ │ │ │ -00018d00: 7468 6520 7661 7269 6f75 7320 646f 6375 the various docu │ │ │ │ │ -00018d10: 6d65 6e74 7320 7769 7468 2061 2073 696e ments with a sin │ │ │ │ │ -00018d20: 676c 6520 636f 7079 0a20 2020 2020 7468 gle copy. th │ │ │ │ │ -00018d30: 6174 2069 7320 696e 636c 7564 6564 2069 at is included i │ │ │ │ │ -00018d40: 6e20 7468 6520 636f 6c6c 6563 7469 6f6e n the collection │ │ │ │ │ -00018d50: 2c20 7072 6f76 6964 6564 2074 6861 7420 , provided that │ │ │ │ │ -00018d60: 796f 7520 666f 6c6c 6f77 2074 6865 0a20 you follow the. │ │ │ │ │ -00018d70: 2020 2020 7275 6c65 7320 6f66 2074 6869 rules of thi │ │ │ │ │ -00018d80: 7320 4c69 6365 6e73 6520 666f 7220 7665 s License for ve │ │ │ │ │ -00018d90: 7262 6174 696d 2063 6f70 7969 6e67 206f rbatim copying o │ │ │ │ │ -00018da0: 6620 6561 6368 206f 6620 7468 6520 646f f each of the do │ │ │ │ │ -00018db0: 6375 6d65 6e74 730a 2020 2020 2069 6e20 cuments. in │ │ │ │ │ -00018dc0: 616c 6c20 6f74 6865 7220 7265 7370 6563 all other respec │ │ │ │ │ -00018dd0: 7473 2e0a 0a20 2020 2020 596f 7520 6d61 ts... You ma │ │ │ │ │ -00018de0: 7920 6578 7472 6163 7420 6120 7369 6e67 y extract a sing │ │ │ │ │ -00018df0: 6c65 2064 6f63 756d 656e 7420 6672 6f6d le document from │ │ │ │ │ -00018e00: 2073 7563 6820 6120 636f 6c6c 6563 7469 such a collecti │ │ │ │ │ -00018e10: 6f6e 2c20 616e 640a 2020 2020 2064 6973 on, and. dis │ │ │ │ │ -00018e20: 7472 6962 7574 6520 6974 2069 6e64 6976 tribute it indiv │ │ │ │ │ -00018e30: 6964 7561 6c6c 7920 756e 6465 7220 7468 idually under th │ │ │ │ │ -00018e40: 6973 204c 6963 656e 7365 2c20 7072 6f76 is License, prov │ │ │ │ │ -00018e50: 6964 6564 2079 6f75 2069 6e73 6572 740a ided you insert. │ │ │ │ │ -00018e60: 2020 2020 2061 2063 6f70 7920 6f66 2074 a copy of t │ │ │ │ │ -00018e70: 6869 7320 4c69 6365 6e73 6520 696e 746f his License into │ │ │ │ │ -00018e80: 2074 6865 2065 7874 7261 6374 6564 2064 the extracted d │ │ │ │ │ -00018e90: 6f63 756d 656e 742c 2061 6e64 2066 6f6c ocument, and fol │ │ │ │ │ -00018ea0: 6c6f 7720 7468 6973 0a20 2020 2020 4c69 low this. Li │ │ │ │ │ -00018eb0: 6365 6e73 6520 696e 2061 6c6c 206f 7468 cense in all oth │ │ │ │ │ -00018ec0: 6572 2072 6573 7065 6374 7320 7265 6761 er respects rega │ │ │ │ │ -00018ed0: 7264 696e 6720 7665 7262 6174 696d 2063 rding verbatim c │ │ │ │ │ -00018ee0: 6f70 7969 6e67 206f 6620 7468 6174 0a20 opying of that. │ │ │ │ │ -00018ef0: 2020 2020 646f 6375 6d65 6e74 2e0a 0a20 document... │ │ │ │ │ -00018f00: 2037 2e20 4147 4752 4547 4154 494f 4e20 7. AGGREGATION │ │ │ │ │ -00018f10: 5749 5448 2049 4e44 4550 454e 4445 4e54 WITH INDEPENDENT │ │ │ │ │ -00018f20: 2057 4f52 4b53 0a0a 2020 2020 2041 2063 WORKS.. A c │ │ │ │ │ -00018f30: 6f6d 7069 6c61 7469 6f6e 206f 6620 7468 ompilation of th │ │ │ │ │ -00018f40: 6520 446f 6375 6d65 6e74 206f 7220 6974 e Document or it │ │ │ │ │ -00018f50: 7320 6465 7269 7661 7469 7665 7320 7769 s derivatives wi │ │ │ │ │ -00018f60: 7468 206f 7468 6572 0a20 2020 2020 7365 th other. se │ │ │ │ │ -00018f70: 7061 7261 7465 2061 6e64 2069 6e64 6570 parate and indep │ │ │ │ │ -00018f80: 656e 6465 6e74 2064 6f63 756d 656e 7473 endent documents │ │ │ │ │ -00018f90: 206f 7220 776f 726b 732c 2069 6e20 6f72 or works, in or │ │ │ │ │ -00018fa0: 206f 6e20 6120 766f 6c75 6d65 206f 6620 on a volume of │ │ │ │ │ -00018fb0: 610a 2020 2020 2073 746f 7261 6765 206f a. storage o │ │ │ │ │ -00018fc0: 7220 6469 7374 7269 6275 7469 6f6e 206d r distribution m │ │ │ │ │ -00018fd0: 6564 6975 6d2c 2069 7320 6361 6c6c 6564 edium, is called │ │ │ │ │ -00018fe0: 2061 6e20 2261 6767 7265 6761 7465 2220 an "aggregate" │ │ │ │ │ -00018ff0: 6966 2074 6865 0a20 2020 2020 636f 7079 if the. copy │ │ │ │ │ -00019000: 7269 6768 7420 7265 7375 6c74 696e 6720 right resulting │ │ │ │ │ -00019010: 6672 6f6d 2074 6865 2063 6f6d 7069 6c61 from the compila │ │ │ │ │ -00019020: 7469 6f6e 2069 7320 6e6f 7420 7573 6564 tion is not used │ │ │ │ │ -00019030: 2074 6f20 6c69 6d69 7420 7468 650a 2020 to limit the. │ │ │ │ │ -00019040: 2020 206c 6567 616c 2072 6967 6874 7320 legal rights │ │ │ │ │ -00019050: 6f66 2074 6865 2063 6f6d 7069 6c61 7469 of the compilati │ │ │ │ │ -00019060: 6f6e 2773 2075 7365 7273 2062 6579 6f6e on's users beyon │ │ │ │ │ -00019070: 6420 7768 6174 2074 6865 2069 6e64 6976 d what the indiv │ │ │ │ │ -00019080: 6964 7561 6c0a 2020 2020 2077 6f72 6b73 idual. works │ │ │ │ │ -00019090: 2070 6572 6d69 742e 2020 5768 656e 2074 permit. When t │ │ │ │ │ -000190a0: 6865 2044 6f63 756d 656e 7420 6973 2069 he Document is i │ │ │ │ │ -000190b0: 6e63 6c75 6465 6420 696e 2061 6e20 6167 ncluded in an ag │ │ │ │ │ -000190c0: 6772 6567 6174 652c 2074 6869 730a 2020 gregate, this. │ │ │ │ │ -000190d0: 2020 204c 6963 656e 7365 2064 6f65 7320 License does │ │ │ │ │ -000190e0: 6e6f 7420 6170 706c 7920 746f 2074 6865 not apply to the │ │ │ │ │ -000190f0: 206f 7468 6572 2077 6f72 6b73 2069 6e20 other works in │ │ │ │ │ -00019100: 7468 6520 6167 6772 6567 6174 6520 7768 the aggregate wh │ │ │ │ │ -00019110: 6963 680a 2020 2020 2061 7265 206e 6f74 ich. are not │ │ │ │ │ -00019120: 2074 6865 6d73 656c 7665 7320 6465 7269 themselves deri │ │ │ │ │ -00019130: 7661 7469 7665 2077 6f72 6b73 206f 6620 vative works of │ │ │ │ │ -00019140: 7468 6520 446f 6375 6d65 6e74 2e0a 0a20 the Document... │ │ │ │ │ -00019150: 2020 2020 4966 2074 6865 2043 6f76 6572 If the Cover │ │ │ │ │ -00019160: 2054 6578 7420 7265 7175 6972 656d 656e Text requiremen │ │ │ │ │ -00019170: 7420 6f66 2073 6563 7469 6f6e 2033 2069 t of section 3 i │ │ │ │ │ -00019180: 7320 6170 706c 6963 6162 6c65 2074 6f20 s applicable to │ │ │ │ │ -00019190: 7468 6573 650a 2020 2020 2063 6f70 6965 these. copie │ │ │ │ │ -000191a0: 7320 6f66 2074 6865 2044 6f63 756d 656e s of the Documen │ │ │ │ │ -000191b0: 742c 2074 6865 6e20 6966 2074 6865 2044 t, then if the D │ │ │ │ │ -000191c0: 6f63 756d 656e 7420 6973 206c 6573 7320 ocument is less │ │ │ │ │ -000191d0: 7468 616e 206f 6e65 2068 616c 660a 2020 than one half. │ │ │ │ │ -000191e0: 2020 206f 6620 7468 6520 656e 7469 7265 of the entire │ │ │ │ │ -000191f0: 2061 6767 7265 6761 7465 2c20 7468 6520 aggregate, the │ │ │ │ │ -00019200: 446f 6375 6d65 6e74 2773 2043 6f76 6572 Document's Cover │ │ │ │ │ -00019210: 2054 6578 7473 206d 6179 2062 6520 706c Texts may be pl │ │ │ │ │ -00019220: 6163 6564 0a20 2020 2020 6f6e 2063 6f76 aced. on cov │ │ │ │ │ -00019230: 6572 7320 7468 6174 2062 7261 636b 6574 ers that bracket │ │ │ │ │ -00019240: 2074 6865 2044 6f63 756d 656e 7420 7769 the Document wi │ │ │ │ │ -00019250: 7468 696e 2074 6865 2061 6767 7265 6761 thin the aggrega │ │ │ │ │ -00019260: 7465 2c20 6f72 2074 6865 0a20 2020 2020 te, or the. │ │ │ │ │ -00019270: 656c 6563 7472 6f6e 6963 2065 7175 6976 electronic equiv │ │ │ │ │ -00019280: 616c 656e 7420 6f66 2063 6f76 6572 7320 alent of covers │ │ │ │ │ -00019290: 6966 2074 6865 2044 6f63 756d 656e 7420 if the Document │ │ │ │ │ -000192a0: 6973 2069 6e20 656c 6563 7472 6f6e 6963 is in electronic │ │ │ │ │ -000192b0: 0a20 2020 2020 666f 726d 2e20 204f 7468 . form. Oth │ │ │ │ │ -000192c0: 6572 7769 7365 2074 6865 7920 6d75 7374 erwise they must │ │ │ │ │ -000192d0: 2061 7070 6561 7220 6f6e 2070 7269 6e74 appear on print │ │ │ │ │ -000192e0: 6564 2063 6f76 6572 7320 7468 6174 2062 ed covers that b │ │ │ │ │ -000192f0: 7261 636b 6574 0a20 2020 2020 7468 6520 racket. the │ │ │ │ │ -00019300: 7768 6f6c 6520 6167 6772 6567 6174 652e whole aggregate. │ │ │ │ │ -00019310: 0a0a 2020 382e 2054 5241 4e53 4c41 5449 .. 8. TRANSLATI │ │ │ │ │ -00019320: 4f4e 0a0a 2020 2020 2054 7261 6e73 6c61 ON.. Transla │ │ │ │ │ -00019330: 7469 6f6e 2069 7320 636f 6e73 6964 6572 tion is consider │ │ │ │ │ -00019340: 6564 2061 206b 696e 6420 6f66 206d 6f64 ed a kind of mod │ │ │ │ │ -00019350: 6966 6963 6174 696f 6e2c 2073 6f20 796f ification, so yo │ │ │ │ │ -00019360: 7520 6d61 790a 2020 2020 2064 6973 7472 u may. distr │ │ │ │ │ -00019370: 6962 7574 6520 7472 616e 736c 6174 696f ibute translatio │ │ │ │ │ -00019380: 6e73 206f 6620 7468 6520 446f 6375 6d65 ns of the Docume │ │ │ │ │ -00019390: 6e74 2075 6e64 6572 2074 6865 2074 6572 nt under the ter │ │ │ │ │ -000193a0: 6d73 206f 6620 7365 6374 696f 6e0a 2020 ms of section. │ │ │ │ │ -000193b0: 2020 2034 2e20 2052 6570 6c61 6369 6e67 4. Replacing │ │ │ │ │ -000193c0: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ -000193d0: 6f6e 7320 7769 7468 2074 7261 6e73 6c61 ons with transla │ │ │ │ │ -000193e0: 7469 6f6e 7320 7265 7175 6972 6573 2073 tions requires s │ │ │ │ │ -000193f0: 7065 6369 616c 0a20 2020 2020 7065 726d pecial. perm │ │ │ │ │ -00019400: 6973 7369 6f6e 2066 726f 6d20 7468 6569 ission from thei │ │ │ │ │ -00019410: 7220 636f 7079 7269 6768 7420 686f 6c64 r copyright hold │ │ │ │ │ -00019420: 6572 732c 2062 7574 2079 6f75 206d 6179 ers, but you may │ │ │ │ │ -00019430: 2069 6e63 6c75 6465 0a20 2020 2020 7472 include. tr │ │ │ │ │ -00019440: 616e 736c 6174 696f 6e73 206f 6620 736f anslations of so │ │ │ │ │ -00019450: 6d65 206f 7220 616c 6c20 496e 7661 7269 me or all Invari │ │ │ │ │ -00019460: 616e 7420 5365 6374 696f 6e73 2069 6e20 ant Sections in │ │ │ │ │ -00019470: 6164 6469 7469 6f6e 2074 6f20 7468 650a addition to the. │ │ │ │ │ -00019480: 2020 2020 206f 7269 6769 6e61 6c20 7665 original ve │ │ │ │ │ -00019490: 7273 696f 6e73 206f 6620 7468 6573 6520 rsions of these │ │ │ │ │ -000194a0: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ │ -000194b0: 6e73 2e20 2059 6f75 206d 6179 2069 6e63 ns. You may inc │ │ │ │ │ -000194c0: 6c75 6465 2061 0a20 2020 2020 7472 616e lude a. tran │ │ │ │ │ -000194d0: 736c 6174 696f 6e20 6f66 2074 6869 7320 slation of this │ │ │ │ │ -000194e0: 4c69 6365 6e73 652c 2061 6e64 2061 6c6c License, and all │ │ │ │ │ -000194f0: 2074 6865 206c 6963 656e 7365 206e 6f74 the license not │ │ │ │ │ -00019500: 6963 6573 2069 6e20 7468 650a 2020 2020 ices in the. │ │ │ │ │ -00019510: 2044 6f63 756d 656e 742c 2061 6e64 2061 Document, and a │ │ │ │ │ -00019520: 6e79 2057 6172 7261 6e74 7920 4469 7363 ny Warranty Disc │ │ │ │ │ -00019530: 6c61 696d 6572 732c 2070 726f 7669 6465 laimers, provide │ │ │ │ │ -00019540: 6420 7468 6174 2079 6f75 2061 6c73 6f0a d that you also. │ │ │ │ │ -00019550: 2020 2020 2069 6e63 6c75 6465 2074 6865 include the │ │ │ │ │ -00019560: 206f 7269 6769 6e61 6c20 456e 676c 6973 original Englis │ │ │ │ │ -00019570: 6820 7665 7273 696f 6e20 6f66 2074 6869 h version of thi │ │ │ │ │ -00019580: 7320 4c69 6365 6e73 6520 616e 6420 7468 s License and th │ │ │ │ │ -00019590: 650a 2020 2020 206f 7269 6769 6e61 6c20 e. original │ │ │ │ │ -000195a0: 7665 7273 696f 6e73 206f 6620 7468 6f73 versions of thos │ │ │ │ │ -000195b0: 6520 6e6f 7469 6365 7320 616e 6420 6469 e notices and di │ │ │ │ │ -000195c0: 7363 6c61 696d 6572 732e 2020 496e 2063 sclaimers. In c │ │ │ │ │ -000195d0: 6173 6520 6f66 2061 0a20 2020 2020 6469 ase of a. di │ │ │ │ │ -000195e0: 7361 6772 6565 6d65 6e74 2062 6574 7765 sagreement betwe │ │ │ │ │ -000195f0: 656e 2074 6865 2074 7261 6e73 6c61 7469 en the translati │ │ │ │ │ -00019600: 6f6e 2061 6e64 2074 6865 206f 7269 6769 on and the origi │ │ │ │ │ -00019610: 6e61 6c20 7665 7273 696f 6e20 6f66 0a20 nal version of. │ │ │ │ │ -00019620: 2020 2020 7468 6973 204c 6963 656e 7365 this License │ │ │ │ │ -00019630: 206f 7220 6120 6e6f 7469 6365 206f 7220 or a notice or │ │ │ │ │ -00019640: 6469 7363 6c61 696d 6572 2c20 7468 6520 disclaimer, the │ │ │ │ │ -00019650: 6f72 6967 696e 616c 2076 6572 7369 6f6e original version │ │ │ │ │ -00019660: 2077 696c 6c0a 2020 2020 2070 7265 7661 will. preva │ │ │ │ │ -00019670: 696c 2e0a 0a20 2020 2020 4966 2061 2073 il... If a s │ │ │ │ │ -00019680: 6563 7469 6f6e 2069 6e20 7468 6520 446f ection in the Do │ │ │ │ │ -00019690: 6375 6d65 6e74 2069 7320 456e 7469 746c cument is Entitl │ │ │ │ │ -000196a0: 6564 2022 4163 6b6e 6f77 6c65 6467 656d ed "Acknowledgem │ │ │ │ │ -000196b0: 656e 7473 222c 0a20 2020 2020 2244 6564 ents",. "Ded │ │ │ │ │ -000196c0: 6963 6174 696f 6e73 222c 206f 7220 2248 ications", or "H │ │ │ │ │ -000196d0: 6973 746f 7279 222c 2074 6865 2072 6571 istory", the req │ │ │ │ │ -000196e0: 7569 7265 6d65 6e74 2028 7365 6374 696f uirement (sectio │ │ │ │ │ -000196f0: 6e20 3429 2074 6f0a 2020 2020 2050 7265 n 4) to. Pre │ │ │ │ │ -00019700: 7365 7276 6520 6974 7320 5469 746c 6520 serve its Title │ │ │ │ │ -00019710: 2873 6563 7469 6f6e 2031 2920 7769 6c6c (section 1) will │ │ │ │ │ -00019720: 2074 7970 6963 616c 6c79 2072 6571 7569 typically requi │ │ │ │ │ -00019730: 7265 2063 6861 6e67 696e 6720 7468 650a re changing the. │ │ │ │ │ -00019740: 2020 2020 2061 6374 7561 6c20 7469 746c actual titl │ │ │ │ │ -00019750: 652e 0a0a 2020 392e 2054 4552 4d49 4e41 e... 9. TERMINA │ │ │ │ │ -00019760: 5449 4f4e 0a0a 2020 2020 2059 6f75 206d TION.. You m │ │ │ │ │ -00019770: 6179 206e 6f74 2063 6f70 792c 206d 6f64 ay not copy, mod │ │ │ │ │ -00019780: 6966 792c 2073 7562 6c69 6365 6e73 652c ify, sublicense, │ │ │ │ │ -00019790: 206f 7220 6469 7374 7269 6275 7465 2074 or distribute t │ │ │ │ │ -000197a0: 6865 2044 6f63 756d 656e 740a 2020 2020 he Document. │ │ │ │ │ -000197b0: 2065 7863 6570 7420 6173 2065 7870 7265 except as expre │ │ │ │ │ -000197c0: 7373 6c79 2070 726f 7669 6465 6420 666f ssly provided fo │ │ │ │ │ -000197d0: 7220 756e 6465 7220 7468 6973 204c 6963 r under this Lic │ │ │ │ │ -000197e0: 656e 7365 2e20 2041 6e79 206f 7468 6572 ense. Any other │ │ │ │ │ -000197f0: 0a20 2020 2020 6174 7465 6d70 7420 746f . attempt to │ │ │ │ │ -00019800: 2063 6f70 792c 206d 6f64 6966 792c 2073 copy, modify, s │ │ │ │ │ -00019810: 7562 6c69 6365 6e73 6520 6f72 2064 6973 ublicense or dis │ │ │ │ │ -00019820: 7472 6962 7574 6520 7468 6520 446f 6375 tribute the Docu │ │ │ │ │ -00019830: 6d65 6e74 2069 730a 2020 2020 2076 6f69 ment is. voi │ │ │ │ │ -00019840: 642c 2061 6e64 2077 696c 6c20 6175 746f d, and will auto │ │ │ │ │ -00019850: 6d61 7469 6361 6c6c 7920 7465 726d 696e matically termin │ │ │ │ │ -00019860: 6174 6520 796f 7572 2072 6967 6874 7320 ate your rights │ │ │ │ │ -00019870: 756e 6465 7220 7468 6973 0a20 2020 2020 under this. │ │ │ │ │ -00019880: 4c69 6365 6e73 652e 2020 486f 7765 7665 License. Howeve │ │ │ │ │ -00019890: 722c 2070 6172 7469 6573 2077 686f 2068 r, parties who h │ │ │ │ │ -000198a0: 6176 6520 7265 6365 6976 6564 2063 6f70 ave received cop │ │ │ │ │ -000198b0: 6965 732c 206f 7220 7269 6768 7473 2c0a ies, or rights,. │ │ │ │ │ -000198c0: 2020 2020 2066 726f 6d20 796f 7520 756e from you un │ │ │ │ │ -000198d0: 6465 7220 7468 6973 204c 6963 656e 7365 der this License │ │ │ │ │ -000198e0: 2077 696c 6c20 6e6f 7420 6861 7665 2074 will not have t │ │ │ │ │ -000198f0: 6865 6972 206c 6963 656e 7365 7320 7465 heir licenses te │ │ │ │ │ -00019900: 726d 696e 6174 6564 0a20 2020 2020 736f rminated. so │ │ │ │ │ -00019910: 206c 6f6e 6720 6173 2073 7563 6820 7061 long as such pa │ │ │ │ │ -00019920: 7274 6965 7320 7265 6d61 696e 2069 6e20 rties remain in │ │ │ │ │ -00019930: 6675 6c6c 2063 6f6d 706c 6961 6e63 652e full compliance. │ │ │ │ │ -00019940: 0a0a 2020 3130 2e20 4655 5455 5245 2052 .. 10. FUTURE R │ │ │ │ │ -00019950: 4556 4953 494f 4e53 204f 4620 5448 4953 EVISIONS OF THIS │ │ │ │ │ -00019960: 204c 4943 454e 5345 0a0a 2020 2020 2054 LICENSE.. T │ │ │ │ │ -00019970: 6865 2046 7265 6520 536f 6674 7761 7265 he Free Software │ │ │ │ │ -00019980: 2046 6f75 6e64 6174 696f 6e20 6d61 7920 Foundation may │ │ │ │ │ -00019990: 7075 626c 6973 6820 6e65 772c 2072 6576 publish new, rev │ │ │ │ │ -000199a0: 6973 6564 2076 6572 7369 6f6e 7320 6f66 ised versions of │ │ │ │ │ -000199b0: 0a20 2020 2020 7468 6520 474e 5520 4672 . the GNU Fr │ │ │ │ │ -000199c0: 6565 2044 6f63 756d 656e 7461 7469 6f6e ee Documentation │ │ │ │ │ -000199d0: 204c 6963 656e 7365 2066 726f 6d20 7469 License from ti │ │ │ │ │ -000199e0: 6d65 2074 6f20 7469 6d65 2e20 2053 7563 me to time. Suc │ │ │ │ │ -000199f0: 6820 6e65 770a 2020 2020 2076 6572 7369 h new. versi │ │ │ │ │ -00019a00: 6f6e 7320 7769 6c6c 2062 6520 7369 6d69 ons will be simi │ │ │ │ │ -00019a10: 6c61 7220 696e 2073 7069 7269 7420 746f lar in spirit to │ │ │ │ │ -00019a20: 2074 6865 2070 7265 7365 6e74 2076 6572 the present ver │ │ │ │ │ -00019a30: 7369 6f6e 2c20 6275 7420 6d61 790a 2020 sion, but may. │ │ │ │ │ -00019a40: 2020 2064 6966 6665 7220 696e 2064 6574 differ in det │ │ │ │ │ -00019a50: 6169 6c20 746f 2061 6464 7265 7373 206e ail to address n │ │ │ │ │ -00019a60: 6577 2070 726f 626c 656d 7320 6f72 2063 ew problems or c │ │ │ │ │ -00019a70: 6f6e 6365 726e 732e 2020 5365 650a 2020 oncerns. See. │ │ │ │ │ -00019a80: 2020 203c 6874 7470 3a2f 2f77 7777 2e67 ... Each ve │ │ │ │ │ -00019ab0: 7273 696f 6e20 6f66 2074 6865 204c 6963 rsion of the Lic │ │ │ │ │ -00019ac0: 656e 7365 2069 7320 6769 7665 6e20 6120 ense is given a │ │ │ │ │ -00019ad0: 6469 7374 696e 6775 6973 6869 6e67 2076 distinguishing v │ │ │ │ │ -00019ae0: 6572 7369 6f6e 0a20 2020 2020 6e75 6d62 ersion. numb │ │ │ │ │ -00019af0: 6572 2e20 2049 6620 7468 6520 446f 6375 er. If the Docu │ │ │ │ │ -00019b00: 6d65 6e74 2073 7065 6369 6669 6573 2074 ment specifies t │ │ │ │ │ -00019b10: 6861 7420 6120 7061 7274 6963 756c 6172 hat a particular │ │ │ │ │ -00019b20: 206e 756d 6265 7265 640a 2020 2020 2076 numbered. v │ │ │ │ │ -00019b30: 6572 7369 6f6e 206f 6620 7468 6973 204c ersion of this L │ │ │ │ │ -00019b40: 6963 656e 7365 2022 6f72 2061 6e79 206c icense "or any l │ │ │ │ │ -00019b50: 6174 6572 2076 6572 7369 6f6e 2220 6170 ater version" ap │ │ │ │ │ -00019b60: 706c 6965 7320 746f 2069 742c 2079 6f75 plies to it, you │ │ │ │ │ -00019b70: 0a20 2020 2020 6861 7665 2074 6865 206f . have the o │ │ │ │ │ -00019b80: 7074 696f 6e20 6f66 2066 6f6c 6c6f 7769 ption of followi │ │ │ │ │ -00019b90: 6e67 2074 6865 2074 6572 6d73 2061 6e64 ng the terms and │ │ │ │ │ -00019ba0: 2063 6f6e 6469 7469 6f6e 7320 6569 7468 conditions eith │ │ │ │ │ -00019bb0: 6572 206f 660a 2020 2020 2074 6861 7420 er of. that │ │ │ │ │ -00019bc0: 7370 6563 6966 6965 6420 7665 7273 696f specified versio │ │ │ │ │ -00019bd0: 6e20 6f72 206f 6620 616e 7920 6c61 7465 n or of any late │ │ │ │ │ -00019be0: 7220 7665 7273 696f 6e20 7468 6174 2068 r version that h │ │ │ │ │ -00019bf0: 6173 2062 6565 6e0a 2020 2020 2070 7562 as been. pub │ │ │ │ │ -00019c00: 6c69 7368 6564 2028 6e6f 7420 6173 2061 lished (not as a │ │ │ │ │ -00019c10: 2064 7261 6674 2920 6279 2074 6865 2046 draft) by the F │ │ │ │ │ -00019c20: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ │ │ -00019c30: 6e64 6174 696f 6e2e 2020 4966 2074 6865 ndation. If the │ │ │ │ │ -00019c40: 0a20 2020 2020 446f 6375 6d65 6e74 2064 . Document d │ │ │ │ │ -00019c50: 6f65 7320 6e6f 7420 7370 6563 6966 7920 oes not specify │ │ │ │ │ -00019c60: 6120 7665 7273 696f 6e20 6e75 6d62 6572 a version number │ │ │ │ │ -00019c70: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ -00019c80: 2c20 796f 7520 6d61 790a 2020 2020 2063 , you may. c │ │ │ │ │ -00019c90: 686f 6f73 6520 616e 7920 7665 7273 696f hoose any versio │ │ │ │ │ -00019ca0: 6e20 6576 6572 2070 7562 6c69 7368 6564 n ever published │ │ │ │ │ -00019cb0: 2028 6e6f 7420 6173 2061 2064 7261 6674 (not as a draft │ │ │ │ │ -00019cc0: 2920 6279 2074 6865 2046 7265 650a 2020 ) by the Free. │ │ │ │ │ -00019cd0: 2020 2053 6f66 7477 6172 6520 466f 756e Software Foun │ │ │ │ │ -00019ce0: 6461 7469 6f6e 2e0a 0a41 2e31 2e31 2041 dation...A.1.1 A │ │ │ │ │ -00019cf0: 4444 454e 4455 4d3a 2048 6f77 2074 6f20 DDENDUM: How to │ │ │ │ │ -00019d00: 7573 6520 7468 6973 204c 6963 656e 7365 use this License │ │ │ │ │ -00019d10: 2066 6f72 2079 6f75 7220 646f 6375 6d65 for your docume │ │ │ │ │ -00019d20: 6e74 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d nts.------------ │ │ │ │ │ +00014bb0: 2020 2056 6572 7369 6f6e 2031 2e32 2c20 Version 1.2, │ │ │ │ │ +00014bc0: 4e6f 7665 6d62 6572 2032 3030 320a 0a20 November 2002.. │ │ │ │ │ +00014bd0: 2020 2020 436f 7079 7269 6768 7420 2843 Copyright (C │ │ │ │ │ +00014be0: 2920 3230 3030 2c32 3030 312c 3230 3032 ) 2000,2001,2002 │ │ │ │ │ +00014bf0: 2046 7265 6520 536f 6674 7761 7265 2046 Free Software F │ │ │ │ │ +00014c00: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e0a oundation, Inc.. │ │ │ │ │ +00014c10: 2020 2020 2035 3120 4672 616e 6b6c 696e 51 Franklin │ │ │ │ │ +00014c20: 2053 742c 2046 6966 7468 2046 6c6f 6f72 St, Fifth Floor │ │ │ │ │ +00014c30: 2c20 426f 7374 6f6e 2c20 4d41 2020 3032 , Boston, MA 02 │ │ │ │ │ +00014c40: 3131 302d 3133 3031 2c20 5553 410a 0a20 110-1301, USA.. │ │ │ │ │ +00014c50: 2020 2020 4576 6572 796f 6e65 2069 7320 Everyone is │ │ │ │ │ +00014c60: 7065 726d 6974 7465 6420 746f 2063 6f70 permitted to cop │ │ │ │ │ +00014c70: 7920 616e 6420 6469 7374 7269 6275 7465 y and distribute │ │ │ │ │ +00014c80: 2076 6572 6261 7469 6d20 636f 7069 6573 verbatim copies │ │ │ │ │ +00014c90: 0a20 2020 2020 6f66 2074 6869 7320 6c69 . of this li │ │ │ │ │ +00014ca0: 6365 6e73 6520 646f 6375 6d65 6e74 2c20 cense document, │ │ │ │ │ +00014cb0: 6275 7420 6368 616e 6769 6e67 2069 7420 but changing it │ │ │ │ │ +00014cc0: 6973 206e 6f74 2061 6c6c 6f77 6564 2e0a is not allowed.. │ │ │ │ │ +00014cd0: 0a20 2030 2e20 5052 4541 4d42 4c45 0a0a . 0. PREAMBLE.. │ │ │ │ │ +00014ce0: 2020 2020 2054 6865 2070 7572 706f 7365 The purpose │ │ │ │ │ +00014cf0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ +00014d00: 2069 7320 746f 206d 616b 6520 6120 6d61 is to make a ma │ │ │ │ │ +00014d10: 6e75 616c 2c20 7465 7874 626f 6f6b 2c20 nual, textbook, │ │ │ │ │ +00014d20: 6f72 206f 7468 6572 0a20 2020 2020 6675 or other. fu │ │ │ │ │ +00014d30: 6e63 7469 6f6e 616c 2061 6e64 2075 7365 nctional and use │ │ │ │ │ +00014d40: 6675 6c20 646f 6375 6d65 6e74 2022 6672 ful document "fr │ │ │ │ │ +00014d50: 6565 2220 696e 2074 6865 2073 656e 7365 ee" in the sense │ │ │ │ │ +00014d60: 206f 6620 6672 6565 646f 6d3a 2074 6f0a of freedom: to. │ │ │ │ │ +00014d70: 2020 2020 2061 7373 7572 6520 6576 6572 assure ever │ │ │ │ │ +00014d80: 796f 6e65 2074 6865 2065 6666 6563 7469 yone the effecti │ │ │ │ │ +00014d90: 7665 2066 7265 6564 6f6d 2074 6f20 636f ve freedom to co │ │ │ │ │ +00014da0: 7079 2061 6e64 2072 6564 6973 7472 6962 py and redistrib │ │ │ │ │ +00014db0: 7574 6520 6974 2c0a 2020 2020 2077 6974 ute it,. wit │ │ │ │ │ +00014dc0: 6820 6f72 2077 6974 686f 7574 206d 6f64 h or without mod │ │ │ │ │ +00014dd0: 6966 7969 6e67 2069 742c 2065 6974 6865 ifying it, eithe │ │ │ │ │ +00014de0: 7220 636f 6d6d 6572 6369 616c 6c79 206f r commercially o │ │ │ │ │ +00014df0: 720a 2020 2020 206e 6f6e 636f 6d6d 6572 r. noncommer │ │ │ │ │ +00014e00: 6369 616c 6c79 2e20 2053 6563 6f6e 6461 cially. Seconda │ │ │ │ │ +00014e10: 7269 6c79 2c20 7468 6973 204c 6963 656e rily, this Licen │ │ │ │ │ +00014e20: 7365 2070 7265 7365 7276 6573 2066 6f72 se preserves for │ │ │ │ │ +00014e30: 2074 6865 0a20 2020 2020 6175 7468 6f72 the. author │ │ │ │ │ +00014e40: 2061 6e64 2070 7562 6c69 7368 6572 2061 and publisher a │ │ │ │ │ +00014e50: 2077 6179 2074 6f20 6765 7420 6372 6564 way to get cred │ │ │ │ │ +00014e60: 6974 2066 6f72 2074 6865 6972 2077 6f72 it for their wor │ │ │ │ │ +00014e70: 6b2c 2077 6869 6c65 206e 6f74 0a20 2020 k, while not. │ │ │ │ │ +00014e80: 2020 6265 696e 6720 636f 6e73 6964 6572 being consider │ │ │ │ │ +00014e90: 6564 2072 6573 706f 6e73 6962 6c65 2066 ed responsible f │ │ │ │ │ +00014ea0: 6f72 206d 6f64 6966 6963 6174 696f 6e73 or modifications │ │ │ │ │ +00014eb0: 206d 6164 6520 6279 206f 7468 6572 732e made by others. │ │ │ │ │ +00014ec0: 0a0a 2020 2020 2054 6869 7320 4c69 6365 .. This Lice │ │ │ │ │ +00014ed0: 6e73 6520 6973 2061 206b 696e 6420 6f66 nse is a kind of │ │ │ │ │ +00014ee0: 2022 636f 7079 6c65 6674 222c 2077 6869 "copyleft", whi │ │ │ │ │ +00014ef0: 6368 206d 6561 6e73 2074 6861 7420 6465 ch means that de │ │ │ │ │ +00014f00: 7269 7661 7469 7665 0a20 2020 2020 776f rivative. wo │ │ │ │ │ +00014f10: 726b 7320 6f66 2074 6865 2064 6f63 756d rks of the docum │ │ │ │ │ +00014f20: 656e 7420 6d75 7374 2074 6865 6d73 656c ent must themsel │ │ │ │ │ +00014f30: 7665 7320 6265 2066 7265 6520 696e 2074 ves be free in t │ │ │ │ │ +00014f40: 6865 2073 616d 6520 7365 6e73 652e 0a20 he same sense.. │ │ │ │ │ +00014f50: 2020 2020 4974 2063 6f6d 706c 656d 656e It complemen │ │ │ │ │ +00014f60: 7473 2074 6865 2047 4e55 2047 656e 6572 ts the GNU Gener │ │ │ │ │ +00014f70: 616c 2050 7562 6c69 6320 4c69 6365 6e73 al Public Licens │ │ │ │ │ +00014f80: 652c 2077 6869 6368 2069 7320 6120 636f e, which is a co │ │ │ │ │ +00014f90: 7079 6c65 6674 0a20 2020 2020 6c69 6365 pyleft. lice │ │ │ │ │ +00014fa0: 6e73 6520 6465 7369 676e 6564 2066 6f72 nse designed for │ │ │ │ │ +00014fb0: 2066 7265 6520 736f 6674 7761 7265 2e0a free software.. │ │ │ │ │ +00014fc0: 0a20 2020 2020 5765 2068 6176 6520 6465 . We have de │ │ │ │ │ +00014fd0: 7369 676e 6564 2074 6869 7320 4c69 6365 signed this Lice │ │ │ │ │ +00014fe0: 6e73 6520 696e 206f 7264 6572 2074 6f20 nse in order to │ │ │ │ │ +00014ff0: 7573 6520 6974 2066 6f72 206d 616e 7561 use it for manua │ │ │ │ │ +00015000: 6c73 2066 6f72 0a20 2020 2020 6672 6565 ls for. free │ │ │ │ │ +00015010: 2073 6f66 7477 6172 652c 2062 6563 6175 software, becau │ │ │ │ │ +00015020: 7365 2066 7265 6520 736f 6674 7761 7265 se free software │ │ │ │ │ +00015030: 206e 6565 6473 2066 7265 6520 646f 6375 needs free docu │ │ │ │ │ +00015040: 6d65 6e74 6174 696f 6e3a 2061 0a20 2020 mentation: a. │ │ │ │ │ +00015050: 2020 6672 6565 2070 726f 6772 616d 2073 free program s │ │ │ │ │ +00015060: 686f 756c 6420 636f 6d65 2077 6974 6820 hould come with │ │ │ │ │ +00015070: 6d61 6e75 616c 7320 7072 6f76 6964 696e manuals providin │ │ │ │ │ +00015080: 6720 7468 6520 7361 6d65 2066 7265 6564 g the same freed │ │ │ │ │ +00015090: 6f6d 730a 2020 2020 2074 6861 7420 7468 oms. that th │ │ │ │ │ +000150a0: 6520 736f 6674 7761 7265 2064 6f65 732e e software does. │ │ │ │ │ +000150b0: 2020 4275 7420 7468 6973 204c 6963 656e But this Licen │ │ │ │ │ +000150c0: 7365 2069 7320 6e6f 7420 6c69 6d69 7465 se is not limite │ │ │ │ │ +000150d0: 6420 746f 0a20 2020 2020 736f 6674 7761 d to. softwa │ │ │ │ │ +000150e0: 7265 206d 616e 7561 6c73 3b20 6974 2063 re manuals; it c │ │ │ │ │ +000150f0: 616e 2062 6520 7573 6564 2066 6f72 2061 an be used for a │ │ │ │ │ +00015100: 6e79 2074 6578 7475 616c 2077 6f72 6b2c ny textual work, │ │ │ │ │ +00015110: 2072 6567 6172 646c 6573 730a 2020 2020 regardless. │ │ │ │ │ +00015120: 206f 6620 7375 626a 6563 7420 6d61 7474 of subject matt │ │ │ │ │ +00015130: 6572 206f 7220 7768 6574 6865 7220 6974 er or whether it │ │ │ │ │ +00015140: 2069 7320 7075 626c 6973 6865 6420 6173 is published as │ │ │ │ │ +00015150: 2061 2070 7269 6e74 6564 2062 6f6f 6b2e a printed book. │ │ │ │ │ +00015160: 2020 5765 0a20 2020 2020 7265 636f 6d6d We. recomm │ │ │ │ │ +00015170: 656e 6420 7468 6973 204c 6963 656e 7365 end this License │ │ │ │ │ +00015180: 2070 7269 6e63 6970 616c 6c79 2066 6f72 principally for │ │ │ │ │ +00015190: 2077 6f72 6b73 2077 686f 7365 2070 7572 works whose pur │ │ │ │ │ +000151a0: 706f 7365 2069 730a 2020 2020 2069 6e73 pose is. ins │ │ │ │ │ +000151b0: 7472 7563 7469 6f6e 206f 7220 7265 6665 truction or refe │ │ │ │ │ +000151c0: 7265 6e63 652e 0a0a 2020 312e 2041 5050 rence... 1. APP │ │ │ │ │ +000151d0: 4c49 4341 4249 4c49 5459 2041 4e44 2044 LICABILITY AND D │ │ │ │ │ +000151e0: 4546 494e 4954 494f 4e53 0a0a 2020 2020 EFINITIONS.. │ │ │ │ │ +000151f0: 2054 6869 7320 4c69 6365 6e73 6520 6170 This License ap │ │ │ │ │ +00015200: 706c 6965 7320 746f 2061 6e79 206d 616e plies to any man │ │ │ │ │ +00015210: 7561 6c20 6f72 206f 7468 6572 2077 6f72 ual or other wor │ │ │ │ │ +00015220: 6b2c 2069 6e20 616e 7920 6d65 6469 756d k, in any medium │ │ │ │ │ +00015230: 2c0a 2020 2020 2074 6861 7420 636f 6e74 ,. that cont │ │ │ │ │ +00015240: 6169 6e73 2061 206e 6f74 6963 6520 706c ains a notice pl │ │ │ │ │ +00015250: 6163 6564 2062 7920 7468 6520 636f 7079 aced by the copy │ │ │ │ │ +00015260: 7269 6768 7420 686f 6c64 6572 2073 6179 right holder say │ │ │ │ │ +00015270: 696e 6720 6974 2063 616e 0a20 2020 2020 ing it can. │ │ │ │ │ +00015280: 6265 2064 6973 7472 6962 7574 6564 2075 be distributed u │ │ │ │ │ +00015290: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ +000152a0: 6620 7468 6973 204c 6963 656e 7365 2e20 f this License. │ │ │ │ │ +000152b0: 2053 7563 6820 6120 6e6f 7469 6365 0a20 Such a notice. │ │ │ │ │ +000152c0: 2020 2020 6772 616e 7473 2061 2077 6f72 grants a wor │ │ │ │ │ +000152d0: 6c64 2d77 6964 652c 2072 6f79 616c 7479 ld-wide, royalty │ │ │ │ │ +000152e0: 2d66 7265 6520 6c69 6365 6e73 652c 2075 -free license, u │ │ │ │ │ +000152f0: 6e6c 696d 6974 6564 2069 6e20 6475 7261 nlimited in dura │ │ │ │ │ +00015300: 7469 6f6e 2c0a 2020 2020 2074 6f20 7573 tion,. to us │ │ │ │ │ +00015310: 6520 7468 6174 2077 6f72 6b20 756e 6465 e that work unde │ │ │ │ │ +00015320: 7220 7468 6520 636f 6e64 6974 696f 6e73 r the conditions │ │ │ │ │ +00015330: 2073 7461 7465 6420 6865 7265 696e 2e20 stated herein. │ │ │ │ │ +00015340: 2054 6865 0a20 2020 2020 2244 6f63 756d The. "Docum │ │ │ │ │ +00015350: 656e 7422 2c20 6265 6c6f 772c 2072 6566 ent", below, ref │ │ │ │ │ +00015360: 6572 7320 746f 2061 6e79 2073 7563 6820 ers to any such │ │ │ │ │ +00015370: 6d61 6e75 616c 206f 7220 776f 726b 2e20 manual or work. │ │ │ │ │ +00015380: 2041 6e79 206d 656d 6265 720a 2020 2020 Any member. │ │ │ │ │ +00015390: 206f 6620 7468 6520 7075 626c 6963 2069 of the public i │ │ │ │ │ +000153a0: 7320 6120 6c69 6365 6e73 6565 2c20 616e s a licensee, an │ │ │ │ │ +000153b0: 6420 6973 2061 6464 7265 7373 6564 2061 d is addressed a │ │ │ │ │ +000153c0: 7320 2279 6f75 222e 2020 596f 7520 6163 s "you". You ac │ │ │ │ │ +000153d0: 6365 7074 0a20 2020 2020 7468 6520 6c69 cept. the li │ │ │ │ │ +000153e0: 6365 6e73 6520 6966 2079 6f75 2063 6f70 cense if you cop │ │ │ │ │ +000153f0: 792c 206d 6f64 6966 7920 6f72 2064 6973 y, modify or dis │ │ │ │ │ +00015400: 7472 6962 7574 6520 7468 6520 776f 726b tribute the work │ │ │ │ │ +00015410: 2069 6e20 6120 7761 790a 2020 2020 2072 in a way. r │ │ │ │ │ +00015420: 6571 7569 7269 6e67 2070 6572 6d69 7373 equiring permiss │ │ │ │ │ +00015430: 696f 6e20 756e 6465 7220 636f 7079 7269 ion under copyri │ │ │ │ │ +00015440: 6768 7420 6c61 772e 0a0a 2020 2020 2041 ght law... A │ │ │ │ │ +00015450: 2022 4d6f 6469 6669 6564 2056 6572 7369 "Modified Versi │ │ │ │ │ +00015460: 6f6e 2220 6f66 2074 6865 2044 6f63 756d on" of the Docum │ │ │ │ │ +00015470: 656e 7420 6d65 616e 7320 616e 7920 776f ent means any wo │ │ │ │ │ +00015480: 726b 2063 6f6e 7461 696e 696e 6720 7468 rk containing th │ │ │ │ │ +00015490: 650a 2020 2020 2044 6f63 756d 656e 7420 e. Document │ │ │ │ │ +000154a0: 6f72 2061 2070 6f72 7469 6f6e 206f 6620 or a portion of │ │ │ │ │ +000154b0: 6974 2c20 6569 7468 6572 2063 6f70 6965 it, either copie │ │ │ │ │ +000154c0: 6420 7665 7262 6174 696d 2c20 6f72 2077 d verbatim, or w │ │ │ │ │ +000154d0: 6974 680a 2020 2020 206d 6f64 6966 6963 ith. modific │ │ │ │ │ +000154e0: 6174 696f 6e73 2061 6e64 2f6f 7220 7472 ations and/or tr │ │ │ │ │ +000154f0: 616e 736c 6174 6564 2069 6e74 6f20 616e anslated into an │ │ │ │ │ +00015500: 6f74 6865 7220 6c61 6e67 7561 6765 2e0a other language.. │ │ │ │ │ +00015510: 0a20 2020 2020 4120 2253 6563 6f6e 6461 . A "Seconda │ │ │ │ │ +00015520: 7279 2053 6563 7469 6f6e 2220 6973 2061 ry Section" is a │ │ │ │ │ +00015530: 206e 616d 6564 2061 7070 656e 6469 7820 named appendix │ │ │ │ │ +00015540: 6f72 2061 2066 726f 6e74 2d6d 6174 7465 or a front-matte │ │ │ │ │ +00015550: 7220 7365 6374 696f 6e0a 2020 2020 206f r section. o │ │ │ │ │ +00015560: 6620 7468 6520 446f 6375 6d65 6e74 2074 f the Document t │ │ │ │ │ +00015570: 6861 7420 6465 616c 7320 6578 636c 7573 hat deals exclus │ │ │ │ │ +00015580: 6976 656c 7920 7769 7468 2074 6865 2072 ively with the r │ │ │ │ │ +00015590: 656c 6174 696f 6e73 6869 7020 6f66 2074 elationship of t │ │ │ │ │ +000155a0: 6865 0a20 2020 2020 7075 626c 6973 6865 he. publishe │ │ │ │ │ +000155b0: 7273 206f 7220 6175 7468 6f72 7320 6f66 rs or authors of │ │ │ │ │ +000155c0: 2074 6865 2044 6f63 756d 656e 7420 746f the Document to │ │ │ │ │ +000155d0: 2074 6865 2044 6f63 756d 656e 7427 7320 the Document's │ │ │ │ │ +000155e0: 6f76 6572 616c 6c0a 2020 2020 2073 7562 overall. sub │ │ │ │ │ +000155f0: 6a65 6374 2028 6f72 2074 6f20 7265 6c61 ject (or to rela │ │ │ │ │ +00015600: 7465 6420 6d61 7474 6572 7329 2061 6e64 ted matters) and │ │ │ │ │ +00015610: 2063 6f6e 7461 696e 7320 6e6f 7468 696e contains nothin │ │ │ │ │ +00015620: 6720 7468 6174 2063 6f75 6c64 0a20 2020 g that could. │ │ │ │ │ +00015630: 2020 6661 6c6c 2064 6972 6563 746c 7920 fall directly │ │ │ │ │ +00015640: 7769 7468 696e 2074 6861 7420 6f76 6572 within that over │ │ │ │ │ +00015650: 616c 6c20 7375 626a 6563 742e 2020 2854 all subject. (T │ │ │ │ │ +00015660: 6875 732c 2069 6620 7468 6520 446f 6375 hus, if the Docu │ │ │ │ │ +00015670: 6d65 6e74 0a20 2020 2020 6973 2069 6e20 ment. is in │ │ │ │ │ +00015680: 7061 7274 2061 2074 6578 7462 6f6f 6b20 part a textbook │ │ │ │ │ +00015690: 6f66 206d 6174 6865 6d61 7469 6373 2c20 of mathematics, │ │ │ │ │ +000156a0: 6120 5365 636f 6e64 6172 7920 5365 6374 a Secondary Sect │ │ │ │ │ +000156b0: 696f 6e20 6d61 7920 6e6f 740a 2020 2020 ion may not. │ │ │ │ │ +000156c0: 2065 7870 6c61 696e 2061 6e79 206d 6174 explain any mat │ │ │ │ │ +000156d0: 6865 6d61 7469 6373 2e29 2020 5468 6520 hematics.) The │ │ │ │ │ +000156e0: 7265 6c61 7469 6f6e 7368 6970 2063 6f75 relationship cou │ │ │ │ │ +000156f0: 6c64 2062 6520 6120 6d61 7474 6572 206f ld be a matter o │ │ │ │ │ +00015700: 660a 2020 2020 2068 6973 746f 7269 6361 f. historica │ │ │ │ │ +00015710: 6c20 636f 6e6e 6563 7469 6f6e 2077 6974 l connection wit │ │ │ │ │ +00015720: 6820 7468 6520 7375 626a 6563 7420 6f72 h the subject or │ │ │ │ │ +00015730: 2077 6974 6820 7265 6c61 7465 6420 6d61 with related ma │ │ │ │ │ +00015740: 7474 6572 732c 206f 720a 2020 2020 206f tters, or. o │ │ │ │ │ +00015750: 6620 6c65 6761 6c2c 2063 6f6d 6d65 7263 f legal, commerc │ │ │ │ │ +00015760: 6961 6c2c 2070 6869 6c6f 736f 7068 6963 ial, philosophic │ │ │ │ │ +00015770: 616c 2c20 6574 6869 6361 6c20 6f72 2070 al, ethical or p │ │ │ │ │ +00015780: 6f6c 6974 6963 616c 2070 6f73 6974 696f olitical positio │ │ │ │ │ +00015790: 6e0a 2020 2020 2072 6567 6172 6469 6e67 n. regarding │ │ │ │ │ +000157a0: 2074 6865 6d2e 0a0a 2020 2020 2054 6865 them... The │ │ │ │ │ +000157b0: 2022 496e 7661 7269 616e 7420 5365 6374 "Invariant Sect │ │ │ │ │ +000157c0: 696f 6e73 2220 6172 6520 6365 7274 6169 ions" are certai │ │ │ │ │ +000157d0: 6e20 5365 636f 6e64 6172 7920 5365 6374 n Secondary Sect │ │ │ │ │ +000157e0: 696f 6e73 2077 686f 7365 0a20 2020 2020 ions whose. │ │ │ │ │ +000157f0: 7469 746c 6573 2061 7265 2064 6573 6967 titles are desig │ │ │ │ │ +00015800: 6e61 7465 642c 2061 7320 6265 696e 6720 nated, as being │ │ │ │ │ +00015810: 7468 6f73 6520 6f66 2049 6e76 6172 6961 those of Invaria │ │ │ │ │ +00015820: 6e74 2053 6563 7469 6f6e 732c 2069 6e20 nt Sections, in │ │ │ │ │ +00015830: 7468 650a 2020 2020 206e 6f74 6963 6520 the. notice │ │ │ │ │ +00015840: 7468 6174 2073 6179 7320 7468 6174 2074 that says that t │ │ │ │ │ +00015850: 6865 2044 6f63 756d 656e 7420 6973 2072 he Document is r │ │ │ │ │ +00015860: 656c 6561 7365 6420 756e 6465 7220 7468 eleased under th │ │ │ │ │ +00015870: 6973 204c 6963 656e 7365 2e0a 2020 2020 is License.. │ │ │ │ │ +00015880: 2049 6620 6120 7365 6374 696f 6e20 646f If a section do │ │ │ │ │ +00015890: 6573 206e 6f74 2066 6974 2074 6865 2061 es not fit the a │ │ │ │ │ +000158a0: 626f 7665 2064 6566 696e 6974 696f 6e20 bove definition │ │ │ │ │ +000158b0: 6f66 2053 6563 6f6e 6461 7279 2074 6865 of Secondary the │ │ │ │ │ +000158c0: 6e20 6974 0a20 2020 2020 6973 206e 6f74 n it. is not │ │ │ │ │ +000158d0: 2061 6c6c 6f77 6564 2074 6f20 6265 2064 allowed to be d │ │ │ │ │ +000158e0: 6573 6967 6e61 7465 6420 6173 2049 6e76 esignated as Inv │ │ │ │ │ +000158f0: 6172 6961 6e74 2e20 2054 6865 2044 6f63 ariant. The Doc │ │ │ │ │ +00015900: 756d 656e 7420 6d61 790a 2020 2020 2063 ument may. c │ │ │ │ │ +00015910: 6f6e 7461 696e 207a 6572 6f20 496e 7661 ontain zero Inva │ │ │ │ │ +00015920: 7269 616e 7420 5365 6374 696f 6e73 2e20 riant Sections. │ │ │ │ │ +00015930: 2049 6620 7468 6520 446f 6375 6d65 6e74 If the Document │ │ │ │ │ +00015940: 2064 6f65 7320 6e6f 7420 6964 656e 7469 does not identi │ │ │ │ │ +00015950: 6679 0a20 2020 2020 616e 7920 496e 7661 fy. any Inva │ │ │ │ │ +00015960: 7269 616e 7420 5365 6374 696f 6e73 2074 riant Sections t │ │ │ │ │ +00015970: 6865 6e20 7468 6572 6520 6172 6520 6e6f hen there are no │ │ │ │ │ +00015980: 6e65 2e0a 0a20 2020 2020 5468 6520 2243 ne... The "C │ │ │ │ │ +00015990: 6f76 6572 2054 6578 7473 2220 6172 6520 over Texts" are │ │ │ │ │ +000159a0: 6365 7274 6169 6e20 7368 6f72 7420 7061 certain short pa │ │ │ │ │ +000159b0: 7373 6167 6573 206f 6620 7465 7874 2074 ssages of text t │ │ │ │ │ +000159c0: 6861 7420 6172 650a 2020 2020 206c 6973 hat are. lis │ │ │ │ │ +000159d0: 7465 642c 2061 7320 4672 6f6e 742d 436f ted, as Front-Co │ │ │ │ │ +000159e0: 7665 7220 5465 7874 7320 6f72 2042 6163 ver Texts or Bac │ │ │ │ │ +000159f0: 6b2d 436f 7665 7220 5465 7874 732c 2069 k-Cover Texts, i │ │ │ │ │ +00015a00: 6e20 7468 6520 6e6f 7469 6365 0a20 2020 n the notice. │ │ │ │ │ +00015a10: 2020 7468 6174 2073 6179 7320 7468 6174 that says that │ │ │ │ │ +00015a20: 2074 6865 2044 6f63 756d 656e 7420 6973 the Document is │ │ │ │ │ +00015a30: 2072 656c 6561 7365 6420 756e 6465 7220 released under │ │ │ │ │ +00015a40: 7468 6973 204c 6963 656e 7365 2e20 2041 this License. A │ │ │ │ │ +00015a50: 0a20 2020 2020 4672 6f6e 742d 436f 7665 . Front-Cove │ │ │ │ │ +00015a60: 7220 5465 7874 206d 6179 2062 6520 6174 r Text may be at │ │ │ │ │ +00015a70: 206d 6f73 7420 3520 776f 7264 732c 2061 most 5 words, a │ │ │ │ │ +00015a80: 6e64 2061 2042 6163 6b2d 436f 7665 7220 nd a Back-Cover │ │ │ │ │ +00015a90: 5465 7874 206d 6179 0a20 2020 2020 6265 Text may. be │ │ │ │ │ +00015aa0: 2061 7420 6d6f 7374 2032 3520 776f 7264 at most 25 word │ │ │ │ │ +00015ab0: 732e 0a0a 2020 2020 2041 2022 5472 616e s... A "Tran │ │ │ │ │ +00015ac0: 7370 6172 656e 7422 2063 6f70 7920 6f66 sparent" copy of │ │ │ │ │ +00015ad0: 2074 6865 2044 6f63 756d 656e 7420 6d65 the Document me │ │ │ │ │ +00015ae0: 616e 7320 6120 6d61 6368 696e 652d 7265 ans a machine-re │ │ │ │ │ +00015af0: 6164 6162 6c65 2063 6f70 792c 0a20 2020 adable copy,. │ │ │ │ │ +00015b00: 2020 7265 7072 6573 656e 7465 6420 696e represented in │ │ │ │ │ +00015b10: 2061 2066 6f72 6d61 7420 7768 6f73 6520 a format whose │ │ │ │ │ +00015b20: 7370 6563 6966 6963 6174 696f 6e20 6973 specification is │ │ │ │ │ +00015b30: 2061 7661 696c 6162 6c65 2074 6f20 7468 available to th │ │ │ │ │ +00015b40: 650a 2020 2020 2067 656e 6572 616c 2070 e. general p │ │ │ │ │ +00015b50: 7562 6c69 632c 2074 6861 7420 6973 2073 ublic, that is s │ │ │ │ │ +00015b60: 7569 7461 626c 6520 666f 7220 7265 7669 uitable for revi │ │ │ │ │ +00015b70: 7369 6e67 2074 6865 2064 6f63 756d 656e sing the documen │ │ │ │ │ +00015b80: 740a 2020 2020 2073 7472 6169 6768 7466 t. straightf │ │ │ │ │ +00015b90: 6f72 7761 7264 6c79 2077 6974 6820 6765 orwardly with ge │ │ │ │ │ +00015ba0: 6e65 7269 6320 7465 7874 2065 6469 746f neric text edito │ │ │ │ │ +00015bb0: 7273 206f 7220 2866 6f72 2069 6d61 6765 rs or (for image │ │ │ │ │ +00015bc0: 7320 636f 6d70 6f73 6564 0a20 2020 2020 s composed. │ │ │ │ │ +00015bd0: 6f66 2070 6978 656c 7329 2067 656e 6572 of pixels) gener │ │ │ │ │ +00015be0: 6963 2070 6169 6e74 2070 726f 6772 616d ic paint program │ │ │ │ │ +00015bf0: 7320 6f72 2028 666f 7220 6472 6177 696e s or (for drawin │ │ │ │ │ +00015c00: 6773 2920 736f 6d65 2077 6964 656c 790a gs) some widely. │ │ │ │ │ +00015c10: 2020 2020 2061 7661 696c 6162 6c65 2064 available d │ │ │ │ │ +00015c20: 7261 7769 6e67 2065 6469 746f 722c 2061 rawing editor, a │ │ │ │ │ +00015c30: 6e64 2074 6861 7420 6973 2073 7569 7461 nd that is suita │ │ │ │ │ +00015c40: 626c 6520 666f 7220 696e 7075 7420 746f ble for input to │ │ │ │ │ +00015c50: 2074 6578 740a 2020 2020 2066 6f72 6d61 text. forma │ │ │ │ │ +00015c60: 7474 6572 7320 6f72 2066 6f72 2061 7574 tters or for aut │ │ │ │ │ +00015c70: 6f6d 6174 6963 2074 7261 6e73 6c61 7469 omatic translati │ │ │ │ │ +00015c80: 6f6e 2074 6f20 6120 7661 7269 6574 7920 on to a variety │ │ │ │ │ +00015c90: 6f66 2066 6f72 6d61 7473 0a20 2020 2020 of formats. │ │ │ │ │ +00015ca0: 7375 6974 6162 6c65 2066 6f72 2069 6e70 suitable for inp │ │ │ │ │ +00015cb0: 7574 2074 6f20 7465 7874 2066 6f72 6d61 ut to text forma │ │ │ │ │ +00015cc0: 7474 6572 732e 2020 4120 636f 7079 206d tters. A copy m │ │ │ │ │ +00015cd0: 6164 6520 696e 2061 6e20 6f74 6865 7277 ade in an otherw │ │ │ │ │ +00015ce0: 6973 650a 2020 2020 2054 7261 6e73 7061 ise. Transpa │ │ │ │ │ +00015cf0: 7265 6e74 2066 696c 6520 666f 726d 6174 rent file format │ │ │ │ │ +00015d00: 2077 686f 7365 206d 6172 6b75 702c 206f whose markup, o │ │ │ │ │ +00015d10: 7220 6162 7365 6e63 6520 6f66 206d 6172 r absence of mar │ │ │ │ │ +00015d20: 6b75 702c 2068 6173 0a20 2020 2020 6265 kup, has. be │ │ │ │ │ +00015d30: 656e 2061 7272 616e 6765 6420 746f 2074 en arranged to t │ │ │ │ │ +00015d40: 6877 6172 7420 6f72 2064 6973 636f 7572 hwart or discour │ │ │ │ │ +00015d50: 6167 6520 7375 6273 6571 7565 6e74 206d age subsequent m │ │ │ │ │ +00015d60: 6f64 6966 6963 6174 696f 6e20 6279 0a20 odification by. │ │ │ │ │ +00015d70: 2020 2020 7265 6164 6572 7320 6973 206e readers is n │ │ │ │ │ +00015d80: 6f74 2054 7261 6e73 7061 7265 6e74 2e20 ot Transparent. │ │ │ │ │ +00015d90: 2041 6e20 696d 6167 6520 666f 726d 6174 An image format │ │ │ │ │ +00015da0: 2069 7320 6e6f 7420 5472 616e 7370 6172 is not Transpar │ │ │ │ │ +00015db0: 656e 7420 6966 0a20 2020 2020 7573 6564 ent if. used │ │ │ │ │ +00015dc0: 2066 6f72 2061 6e79 2073 7562 7374 616e for any substan │ │ │ │ │ +00015dd0: 7469 616c 2061 6d6f 756e 7420 6f66 2074 tial amount of t │ │ │ │ │ +00015de0: 6578 742e 2020 4120 636f 7079 2074 6861 ext. A copy tha │ │ │ │ │ +00015df0: 7420 6973 206e 6f74 0a20 2020 2020 2254 t is not. "T │ │ │ │ │ +00015e00: 7261 6e73 7061 7265 6e74 2220 6973 2063 ransparent" is c │ │ │ │ │ +00015e10: 616c 6c65 6420 224f 7061 7175 6522 2e0a alled "Opaque".. │ │ │ │ │ +00015e20: 0a20 2020 2020 4578 616d 706c 6573 206f . Examples o │ │ │ │ │ +00015e30: 6620 7375 6974 6162 6c65 2066 6f72 6d61 f suitable forma │ │ │ │ │ +00015e40: 7473 2066 6f72 2054 7261 6e73 7061 7265 ts for Transpare │ │ │ │ │ +00015e50: 6e74 2063 6f70 6965 7320 696e 636c 7564 nt copies includ │ │ │ │ │ +00015e60: 6520 706c 6169 6e0a 2020 2020 2041 5343 e plain. ASC │ │ │ │ │ +00015e70: 4949 2077 6974 686f 7574 206d 6172 6b75 II without marku │ │ │ │ │ +00015e80: 702c 2054 6578 696e 666f 2069 6e70 7574 p, Texinfo input │ │ │ │ │ +00015e90: 2066 6f72 6d61 742c 204c 6154 6558 2069 format, LaTeX i │ │ │ │ │ +00015ea0: 6e70 7574 2066 6f72 6d61 742c 0a20 2020 nput format,. │ │ │ │ │ +00015eb0: 2020 5347 4d4c 206f 7220 584d 4c20 7573 SGML or XML us │ │ │ │ │ +00015ec0: 696e 6720 6120 7075 626c 6963 6c79 2061 ing a publicly a │ │ │ │ │ +00015ed0: 7661 696c 6162 6c65 2044 5444 2c20 616e vailable DTD, an │ │ │ │ │ +00015ee0: 6420 7374 616e 6461 7264 2d63 6f6e 666f d standard-confo │ │ │ │ │ +00015ef0: 726d 696e 670a 2020 2020 2073 696d 706c rming. simpl │ │ │ │ │ +00015f00: 6520 4854 4d4c 2c20 506f 7374 5363 7269 e HTML, PostScri │ │ │ │ │ +00015f10: 7074 206f 7220 5044 4620 6465 7369 676e pt or PDF design │ │ │ │ │ +00015f20: 6564 2066 6f72 2068 756d 616e 206d 6f64 ed for human mod │ │ │ │ │ +00015f30: 6966 6963 6174 696f 6e2e 0a20 2020 2020 ification.. │ │ │ │ │ +00015f40: 4578 616d 706c 6573 206f 6620 7472 616e Examples of tran │ │ │ │ │ +00015f50: 7370 6172 656e 7420 696d 6167 6520 666f sparent image fo │ │ │ │ │ +00015f60: 726d 6174 7320 696e 636c 7564 6520 504e rmats include PN │ │ │ │ │ +00015f70: 472c 2058 4346 2061 6e64 204a 5047 2e0a G, XCF and JPG.. │ │ │ │ │ +00015f80: 2020 2020 204f 7061 7175 6520 666f 726d Opaque form │ │ │ │ │ +00015f90: 6174 7320 696e 636c 7564 6520 7072 6f70 ats include prop │ │ │ │ │ +00015fa0: 7269 6574 6172 7920 666f 726d 6174 7320 rietary formats │ │ │ │ │ +00015fb0: 7468 6174 2063 616e 2062 6520 7265 6164 that can be read │ │ │ │ │ +00015fc0: 2061 6e64 0a20 2020 2020 6564 6974 6564 and. edited │ │ │ │ │ +00015fd0: 206f 6e6c 7920 6279 2070 726f 7072 6965 only by proprie │ │ │ │ │ +00015fe0: 7461 7279 2077 6f72 6420 7072 6f63 6573 tary word proces │ │ │ │ │ +00015ff0: 736f 7273 2c20 5347 4d4c 206f 7220 584d sors, SGML or XM │ │ │ │ │ +00016000: 4c20 666f 7220 7768 6963 680a 2020 2020 L for which. │ │ │ │ │ +00016010: 2074 6865 2044 5444 2061 6e64 2f6f 7220 the DTD and/or │ │ │ │ │ +00016020: 7072 6f63 6573 7369 6e67 2074 6f6f 6c73 processing tools │ │ │ │ │ +00016030: 2061 7265 206e 6f74 2067 656e 6572 616c are not general │ │ │ │ │ +00016040: 6c79 2061 7661 696c 6162 6c65 2c20 616e ly available, an │ │ │ │ │ +00016050: 640a 2020 2020 2074 6865 206d 6163 6869 d. the machi │ │ │ │ │ +00016060: 6e65 2d67 656e 6572 6174 6564 2048 544d ne-generated HTM │ │ │ │ │ +00016070: 4c2c 2050 6f73 7453 6372 6970 7420 6f72 L, PostScript or │ │ │ │ │ +00016080: 2050 4446 2070 726f 6475 6365 6420 6279 PDF produced by │ │ │ │ │ +00016090: 2073 6f6d 6520 776f 7264 0a20 2020 2020 some word. │ │ │ │ │ +000160a0: 7072 6f63 6573 736f 7273 2066 6f72 206f processors for o │ │ │ │ │ +000160b0: 7574 7075 7420 7075 7270 6f73 6573 206f utput purposes o │ │ │ │ │ +000160c0: 6e6c 792e 0a0a 2020 2020 2054 6865 2022 nly... The " │ │ │ │ │ +000160d0: 5469 746c 6520 5061 6765 2220 6d65 616e Title Page" mean │ │ │ │ │ +000160e0: 732c 2066 6f72 2061 2070 7269 6e74 6564 s, for a printed │ │ │ │ │ +000160f0: 2062 6f6f 6b2c 2074 6865 2074 6974 6c65 book, the title │ │ │ │ │ +00016100: 2070 6167 6520 6974 7365 6c66 2c0a 2020 page itself,. │ │ │ │ │ +00016110: 2020 2070 6c75 7320 7375 6368 2066 6f6c plus such fol │ │ │ │ │ +00016120: 6c6f 7769 6e67 2070 6167 6573 2061 7320 lowing pages as │ │ │ │ │ +00016130: 6172 6520 6e65 6564 6564 2074 6f20 686f are needed to ho │ │ │ │ │ +00016140: 6c64 2c20 6c65 6769 626c 792c 2074 6865 ld, legibly, the │ │ │ │ │ +00016150: 0a20 2020 2020 6d61 7465 7269 616c 2074 . material t │ │ │ │ │ +00016160: 6869 7320 4c69 6365 6e73 6520 7265 7175 his License requ │ │ │ │ │ +00016170: 6972 6573 2074 6f20 6170 7065 6172 2069 ires to appear i │ │ │ │ │ +00016180: 6e20 7468 6520 7469 746c 6520 7061 6765 n the title page │ │ │ │ │ +00016190: 2e20 2046 6f72 0a20 2020 2020 776f 726b . For. work │ │ │ │ │ +000161a0: 7320 696e 2066 6f72 6d61 7473 2077 6869 s in formats whi │ │ │ │ │ +000161b0: 6368 2064 6f20 6e6f 7420 6861 7665 2061 ch do not have a │ │ │ │ │ +000161c0: 6e79 2074 6974 6c65 2070 6167 6520 6173 ny title page as │ │ │ │ │ +000161d0: 2073 7563 682c 2022 5469 746c 650a 2020 such, "Title. │ │ │ │ │ +000161e0: 2020 2050 6167 6522 206d 6561 6e73 2074 Page" means t │ │ │ │ │ +000161f0: 6865 2074 6578 7420 6e65 6172 2074 6865 he text near the │ │ │ │ │ +00016200: 206d 6f73 7420 7072 6f6d 696e 656e 7420 most prominent │ │ │ │ │ +00016210: 6170 7065 6172 616e 6365 206f 6620 7468 appearance of th │ │ │ │ │ +00016220: 650a 2020 2020 2077 6f72 6b27 7320 7469 e. work's ti │ │ │ │ │ +00016230: 746c 652c 2070 7265 6365 6469 6e67 2074 tle, preceding t │ │ │ │ │ +00016240: 6865 2062 6567 696e 6e69 6e67 206f 6620 he beginning of │ │ │ │ │ +00016250: 7468 6520 626f 6479 206f 6620 7468 6520 the body of the │ │ │ │ │ +00016260: 7465 7874 2e0a 0a20 2020 2020 4120 7365 text... A se │ │ │ │ │ +00016270: 6374 696f 6e20 2245 6e74 6974 6c65 6420 ction "Entitled │ │ │ │ │ +00016280: 5859 5a22 206d 6561 6e73 2061 206e 616d XYZ" means a nam │ │ │ │ │ +00016290: 6564 2073 7562 756e 6974 206f 6620 7468 ed subunit of th │ │ │ │ │ +000162a0: 6520 446f 6375 6d65 6e74 0a20 2020 2020 e Document. │ │ │ │ │ +000162b0: 7768 6f73 6520 7469 746c 6520 6569 7468 whose title eith │ │ │ │ │ +000162c0: 6572 2069 7320 7072 6563 6973 656c 7920 er is precisely │ │ │ │ │ +000162d0: 5859 5a20 6f72 2063 6f6e 7461 696e 7320 XYZ or contains │ │ │ │ │ +000162e0: 5859 5a20 696e 2070 6172 656e 7468 6573 XYZ in parenthes │ │ │ │ │ +000162f0: 6573 0a20 2020 2020 666f 6c6c 6f77 696e es. followin │ │ │ │ │ +00016300: 6720 7465 7874 2074 6861 7420 7472 616e g text that tran │ │ │ │ │ +00016310: 736c 6174 6573 2058 595a 2069 6e20 616e slates XYZ in an │ │ │ │ │ +00016320: 6f74 6865 7220 6c61 6e67 7561 6765 2e20 other language. │ │ │ │ │ +00016330: 2028 4865 7265 2058 595a 0a20 2020 2020 (Here XYZ. │ │ │ │ │ +00016340: 7374 616e 6473 2066 6f72 2061 2073 7065 stands for a spe │ │ │ │ │ +00016350: 6369 6669 6320 7365 6374 696f 6e20 6e61 cific section na │ │ │ │ │ +00016360: 6d65 206d 656e 7469 6f6e 6564 2062 656c me mentioned bel │ │ │ │ │ +00016370: 6f77 2c20 7375 6368 2061 730a 2020 2020 ow, such as. │ │ │ │ │ +00016380: 2022 4163 6b6e 6f77 6c65 6467 656d 656e "Acknowledgemen │ │ │ │ │ +00016390: 7473 222c 2022 4465 6469 6361 7469 6f6e ts", "Dedication │ │ │ │ │ +000163a0: 7322 2c20 2245 6e64 6f72 7365 6d65 6e74 s", "Endorsement │ │ │ │ │ +000163b0: 7322 2c20 6f72 2022 4869 7374 6f72 7922 s", or "History" │ │ │ │ │ +000163c0: 2e29 0a20 2020 2020 546f 2022 5072 6573 .). To "Pres │ │ │ │ │ +000163d0: 6572 7665 2074 6865 2054 6974 6c65 2220 erve the Title" │ │ │ │ │ +000163e0: 6f66 2073 7563 6820 6120 7365 6374 696f of such a sectio │ │ │ │ │ +000163f0: 6e20 7768 656e 2079 6f75 206d 6f64 6966 n when you modif │ │ │ │ │ +00016400: 7920 7468 650a 2020 2020 2044 6f63 756d y the. Docum │ │ │ │ │ +00016410: 656e 7420 6d65 616e 7320 7468 6174 2069 ent means that i │ │ │ │ │ +00016420: 7420 7265 6d61 696e 7320 6120 7365 6374 t remains a sect │ │ │ │ │ +00016430: 696f 6e20 2245 6e74 6974 6c65 6420 5859 ion "Entitled XY │ │ │ │ │ +00016440: 5a22 2061 6363 6f72 6469 6e67 0a20 2020 Z" according. │ │ │ │ │ +00016450: 2020 746f 2074 6869 7320 6465 6669 6e69 to this defini │ │ │ │ │ +00016460: 7469 6f6e 2e0a 0a20 2020 2020 5468 6520 tion... The │ │ │ │ │ +00016470: 446f 6375 6d65 6e74 206d 6179 2069 6e63 Document may inc │ │ │ │ │ +00016480: 6c75 6465 2057 6172 7261 6e74 7920 4469 lude Warranty Di │ │ │ │ │ +00016490: 7363 6c61 696d 6572 7320 6e65 7874 2074 sclaimers next t │ │ │ │ │ +000164a0: 6f20 7468 6520 6e6f 7469 6365 0a20 2020 o the notice. │ │ │ │ │ +000164b0: 2020 7768 6963 6820 7374 6174 6573 2074 which states t │ │ │ │ │ +000164c0: 6861 7420 7468 6973 204c 6963 656e 7365 hat this License │ │ │ │ │ +000164d0: 2061 7070 6c69 6573 2074 6f20 7468 6520 applies to the │ │ │ │ │ +000164e0: 446f 6375 6d65 6e74 2e20 2054 6865 7365 Document. These │ │ │ │ │ +000164f0: 0a20 2020 2020 5761 7272 616e 7479 2044 . Warranty D │ │ │ │ │ +00016500: 6973 636c 6169 6d65 7273 2061 7265 2063 isclaimers are c │ │ │ │ │ +00016510: 6f6e 7369 6465 7265 6420 746f 2062 6520 onsidered to be │ │ │ │ │ +00016520: 696e 636c 7564 6564 2062 7920 7265 6665 included by refe │ │ │ │ │ +00016530: 7265 6e63 6520 696e 0a20 2020 2020 7468 rence in. th │ │ │ │ │ +00016540: 6973 204c 6963 656e 7365 2c20 6275 7420 is License, but │ │ │ │ │ +00016550: 6f6e 6c79 2061 7320 7265 6761 7264 7320 only as regards │ │ │ │ │ +00016560: 6469 7363 6c61 696d 696e 6720 7761 7272 disclaiming warr │ │ │ │ │ +00016570: 616e 7469 6573 3a20 616e 7920 6f74 6865 anties: any othe │ │ │ │ │ +00016580: 720a 2020 2020 2069 6d70 6c69 6361 7469 r. implicati │ │ │ │ │ +00016590: 6f6e 2074 6861 7420 7468 6573 6520 5761 on that these Wa │ │ │ │ │ +000165a0: 7272 616e 7479 2044 6973 636c 6169 6d65 rranty Disclaime │ │ │ │ │ +000165b0: 7273 206d 6179 2068 6176 6520 6973 2076 rs may have is v │ │ │ │ │ +000165c0: 6f69 6420 616e 640a 2020 2020 2068 6173 oid and. has │ │ │ │ │ +000165d0: 206e 6f20 6566 6665 6374 206f 6e20 7468 no effect on th │ │ │ │ │ +000165e0: 6520 6d65 616e 696e 6720 6f66 2074 6869 e meaning of thi │ │ │ │ │ +000165f0: 7320 4c69 6365 6e73 652e 0a0a 2020 322e s License... 2. │ │ │ │ │ +00016600: 2056 4552 4241 5449 4d20 434f 5059 494e VERBATIM COPYIN │ │ │ │ │ +00016610: 470a 0a20 2020 2020 596f 7520 6d61 7920 G.. You may │ │ │ │ │ +00016620: 636f 7079 2061 6e64 2064 6973 7472 6962 copy and distrib │ │ │ │ │ +00016630: 7574 6520 7468 6520 446f 6375 6d65 6e74 ute the Document │ │ │ │ │ +00016640: 2069 6e20 616e 7920 6d65 6469 756d 2c20 in any medium, │ │ │ │ │ +00016650: 6569 7468 6572 0a20 2020 2020 636f 6d6d either. comm │ │ │ │ │ +00016660: 6572 6369 616c 6c79 206f 7220 6e6f 6e63 ercially or nonc │ │ │ │ │ +00016670: 6f6d 6d65 7263 6961 6c6c 792c 2070 726f ommercially, pro │ │ │ │ │ +00016680: 7669 6465 6420 7468 6174 2074 6869 7320 vided that this │ │ │ │ │ +00016690: 4c69 6365 6e73 652c 2074 6865 0a20 2020 License, the. │ │ │ │ │ +000166a0: 2020 636f 7079 7269 6768 7420 6e6f 7469 copyright noti │ │ │ │ │ +000166b0: 6365 732c 2061 6e64 2074 6865 206c 6963 ces, and the lic │ │ │ │ │ +000166c0: 656e 7365 206e 6f74 6963 6520 7361 7969 ense notice sayi │ │ │ │ │ +000166d0: 6e67 2074 6869 7320 4c69 6365 6e73 650a ng this License. │ │ │ │ │ +000166e0: 2020 2020 2061 7070 6c69 6573 2074 6f20 applies to │ │ │ │ │ +000166f0: 7468 6520 446f 6375 6d65 6e74 2061 7265 the Document are │ │ │ │ │ +00016700: 2072 6570 726f 6475 6365 6420 696e 2061 reproduced in a │ │ │ │ │ +00016710: 6c6c 2063 6f70 6965 732c 2061 6e64 2074 ll copies, and t │ │ │ │ │ +00016720: 6861 7420 796f 750a 2020 2020 2061 6464 hat you. add │ │ │ │ │ +00016730: 206e 6f20 6f74 6865 7220 636f 6e64 6974 no other condit │ │ │ │ │ +00016740: 696f 6e73 2077 6861 7473 6f65 7665 7220 ions whatsoever │ │ │ │ │ +00016750: 746f 2074 686f 7365 206f 6620 7468 6973 to those of this │ │ │ │ │ +00016760: 204c 6963 656e 7365 2e20 2059 6f75 0a20 License. You. │ │ │ │ │ +00016770: 2020 2020 6d61 7920 6e6f 7420 7573 6520 may not use │ │ │ │ │ +00016780: 7465 6368 6e69 6361 6c20 6d65 6173 7572 technical measur │ │ │ │ │ +00016790: 6573 2074 6f20 6f62 7374 7275 6374 206f es to obstruct o │ │ │ │ │ +000167a0: 7220 636f 6e74 726f 6c20 7468 6520 7265 r control the re │ │ │ │ │ +000167b0: 6164 696e 670a 2020 2020 206f 7220 6675 ading. or fu │ │ │ │ │ +000167c0: 7274 6865 7220 636f 7079 696e 6720 6f66 rther copying of │ │ │ │ │ +000167d0: 2074 6865 2063 6f70 6965 7320 796f 7520 the copies you │ │ │ │ │ +000167e0: 6d61 6b65 206f 7220 6469 7374 7269 6275 make or distribu │ │ │ │ │ +000167f0: 7465 2e20 2048 6f77 6576 6572 2c0a 2020 te. However,. │ │ │ │ │ +00016800: 2020 2079 6f75 206d 6179 2061 6363 6570 you may accep │ │ │ │ │ +00016810: 7420 636f 6d70 656e 7361 7469 6f6e 2069 t compensation i │ │ │ │ │ +00016820: 6e20 6578 6368 616e 6765 2066 6f72 2063 n exchange for c │ │ │ │ │ +00016830: 6f70 6965 732e 2020 4966 2079 6f75 0a20 opies. If you. │ │ │ │ │ +00016840: 2020 2020 6469 7374 7269 6275 7465 2061 distribute a │ │ │ │ │ +00016850: 206c 6172 6765 2065 6e6f 7567 6820 6e75 large enough nu │ │ │ │ │ +00016860: 6d62 6572 206f 6620 636f 7069 6573 2079 mber of copies y │ │ │ │ │ +00016870: 6f75 206d 7573 7420 616c 736f 2066 6f6c ou must also fol │ │ │ │ │ +00016880: 6c6f 7720 7468 650a 2020 2020 2063 6f6e low the. con │ │ │ │ │ +00016890: 6469 7469 6f6e 7320 696e 2073 6563 7469 ditions in secti │ │ │ │ │ +000168a0: 6f6e 2033 2e0a 0a20 2020 2020 596f 7520 on 3... You │ │ │ │ │ +000168b0: 6d61 7920 616c 736f 206c 656e 6420 636f may also lend co │ │ │ │ │ +000168c0: 7069 6573 2c20 756e 6465 7220 7468 6520 pies, under the │ │ │ │ │ +000168d0: 7361 6d65 2063 6f6e 6469 7469 6f6e 7320 same conditions │ │ │ │ │ +000168e0: 7374 6174 6564 2061 626f 7665 2c0a 2020 stated above,. │ │ │ │ │ +000168f0: 2020 2061 6e64 2079 6f75 206d 6179 2070 and you may p │ │ │ │ │ +00016900: 7562 6c69 636c 7920 6469 7370 6c61 7920 ublicly display │ │ │ │ │ +00016910: 636f 7069 6573 2e0a 0a20 2033 2e20 434f copies... 3. CO │ │ │ │ │ +00016920: 5059 494e 4720 494e 2051 5541 4e54 4954 PYING IN QUANTIT │ │ │ │ │ +00016930: 590a 0a20 2020 2020 4966 2079 6f75 2070 Y.. If you p │ │ │ │ │ +00016940: 7562 6c69 7368 2070 7269 6e74 6564 2063 ublish printed c │ │ │ │ │ +00016950: 6f70 6965 7320 286f 7220 636f 7069 6573 opies (or copies │ │ │ │ │ +00016960: 2069 6e20 6d65 6469 6120 7468 6174 2063 in media that c │ │ │ │ │ +00016970: 6f6d 6d6f 6e6c 790a 2020 2020 2068 6176 ommonly. hav │ │ │ │ │ +00016980: 6520 7072 696e 7465 6420 636f 7665 7273 e printed covers │ │ │ │ │ +00016990: 2920 6f66 2074 6865 2044 6f63 756d 656e ) of the Documen │ │ │ │ │ +000169a0: 742c 206e 756d 6265 7269 6e67 206d 6f72 t, numbering mor │ │ │ │ │ +000169b0: 6520 7468 616e 2031 3030 2c20 616e 640a e than 100, and. │ │ │ │ │ +000169c0: 2020 2020 2074 6865 2044 6f63 756d 656e the Documen │ │ │ │ │ +000169d0: 7427 7320 6c69 6365 6e73 6520 6e6f 7469 t's license noti │ │ │ │ │ +000169e0: 6365 2072 6571 7569 7265 7320 436f 7665 ce requires Cove │ │ │ │ │ +000169f0: 7220 5465 7874 732c 2079 6f75 206d 7573 r Texts, you mus │ │ │ │ │ +00016a00: 740a 2020 2020 2065 6e63 6c6f 7365 2074 t. enclose t │ │ │ │ │ +00016a10: 6865 2063 6f70 6965 7320 696e 2063 6f76 he copies in cov │ │ │ │ │ +00016a20: 6572 7320 7468 6174 2063 6172 7279 2c20 ers that carry, │ │ │ │ │ +00016a30: 636c 6561 726c 7920 616e 6420 6c65 6769 clearly and legi │ │ │ │ │ +00016a40: 626c 792c 2061 6c6c 0a20 2020 2020 7468 bly, all. th │ │ │ │ │ +00016a50: 6573 6520 436f 7665 7220 5465 7874 733a ese Cover Texts: │ │ │ │ │ +00016a60: 2046 726f 6e74 2d43 6f76 6572 2054 6578 Front-Cover Tex │ │ │ │ │ +00016a70: 7473 206f 6e20 7468 6520 6672 6f6e 7420 ts on the front │ │ │ │ │ +00016a80: 636f 7665 722c 2061 6e64 0a20 2020 2020 cover, and. │ │ │ │ │ +00016a90: 4261 636b 2d43 6f76 6572 2054 6578 7473 Back-Cover Texts │ │ │ │ │ +00016aa0: 206f 6e20 7468 6520 6261 636b 2063 6f76 on the back cov │ │ │ │ │ +00016ab0: 6572 2e20 2042 6f74 6820 636f 7665 7273 er. Both covers │ │ │ │ │ +00016ac0: 206d 7573 7420 616c 736f 2063 6c65 6172 must also clear │ │ │ │ │ +00016ad0: 6c79 0a20 2020 2020 616e 6420 6c65 6769 ly. and legi │ │ │ │ │ +00016ae0: 626c 7920 6964 656e 7469 6679 2079 6f75 bly identify you │ │ │ │ │ +00016af0: 2061 7320 7468 6520 7075 626c 6973 6865 as the publishe │ │ │ │ │ +00016b00: 7220 6f66 2074 6865 7365 2063 6f70 6965 r of these copie │ │ │ │ │ +00016b10: 732e 2020 5468 650a 2020 2020 2066 726f s. The. fro │ │ │ │ │ +00016b20: 6e74 2063 6f76 6572 206d 7573 7420 7072 nt cover must pr │ │ │ │ │ +00016b30: 6573 656e 7420 7468 6520 6675 6c6c 2074 esent the full t │ │ │ │ │ +00016b40: 6974 6c65 2077 6974 6820 616c 6c20 776f itle with all wo │ │ │ │ │ +00016b50: 7264 7320 6f66 2074 6865 2074 6974 6c65 rds of the title │ │ │ │ │ +00016b60: 0a20 2020 2020 6571 7561 6c6c 7920 7072 . equally pr │ │ │ │ │ +00016b70: 6f6d 696e 656e 7420 616e 6420 7669 7369 ominent and visi │ │ │ │ │ +00016b80: 626c 652e 2020 596f 7520 6d61 7920 6164 ble. You may ad │ │ │ │ │ +00016b90: 6420 6f74 6865 7220 6d61 7465 7269 616c d other material │ │ │ │ │ +00016ba0: 206f 6e20 7468 650a 2020 2020 2063 6f76 on the. cov │ │ │ │ │ +00016bb0: 6572 7320 696e 2061 6464 6974 696f 6e2e ers in addition. │ │ │ │ │ +00016bc0: 2020 436f 7079 696e 6720 7769 7468 2063 Copying with c │ │ │ │ │ +00016bd0: 6861 6e67 6573 206c 696d 6974 6564 2074 hanges limited t │ │ │ │ │ +00016be0: 6f20 7468 6520 636f 7665 7273 2c20 6173 o the covers, as │ │ │ │ │ +00016bf0: 0a20 2020 2020 6c6f 6e67 2061 7320 7468 . long as th │ │ │ │ │ +00016c00: 6579 2070 7265 7365 7276 6520 7468 6520 ey preserve the │ │ │ │ │ +00016c10: 7469 746c 6520 6f66 2074 6865 2044 6f63 title of the Doc │ │ │ │ │ +00016c20: 756d 656e 7420 616e 6420 7361 7469 7366 ument and satisf │ │ │ │ │ +00016c30: 7920 7468 6573 650a 2020 2020 2063 6f6e y these. con │ │ │ │ │ +00016c40: 6469 7469 6f6e 732c 2063 616e 2062 6520 ditions, can be │ │ │ │ │ +00016c50: 7472 6561 7465 6420 6173 2076 6572 6261 treated as verba │ │ │ │ │ +00016c60: 7469 6d20 636f 7079 696e 6720 696e 206f tim copying in o │ │ │ │ │ +00016c70: 7468 6572 2072 6573 7065 6374 732e 0a0a ther respects... │ │ │ │ │ +00016c80: 2020 2020 2049 6620 7468 6520 7265 7175 If the requ │ │ │ │ │ +00016c90: 6972 6564 2074 6578 7473 2066 6f72 2065 ired texts for e │ │ │ │ │ +00016ca0: 6974 6865 7220 636f 7665 7220 6172 6520 ither cover are │ │ │ │ │ +00016cb0: 746f 6f20 766f 6c75 6d69 6e6f 7573 2074 too voluminous t │ │ │ │ │ +00016cc0: 6f20 6669 740a 2020 2020 206c 6567 6962 o fit. legib │ │ │ │ │ +00016cd0: 6c79 2c20 796f 7520 7368 6f75 6c64 2070 ly, you should p │ │ │ │ │ +00016ce0: 7574 2074 6865 2066 6972 7374 206f 6e65 ut the first one │ │ │ │ │ +00016cf0: 7320 6c69 7374 6564 2028 6173 206d 616e s listed (as man │ │ │ │ │ +00016d00: 7920 6173 2066 6974 0a20 2020 2020 7265 y as fit. re │ │ │ │ │ +00016d10: 6173 6f6e 6162 6c79 2920 6f6e 2074 6865 asonably) on the │ │ │ │ │ +00016d20: 2061 6374 7561 6c20 636f 7665 722c 2061 actual cover, a │ │ │ │ │ +00016d30: 6e64 2063 6f6e 7469 6e75 6520 7468 6520 nd continue the │ │ │ │ │ +00016d40: 7265 7374 206f 6e74 6f0a 2020 2020 2061 rest onto. a │ │ │ │ │ +00016d50: 646a 6163 656e 7420 7061 6765 732e 0a0a djacent pages... │ │ │ │ │ +00016d60: 2020 2020 2049 6620 796f 7520 7075 626c If you publ │ │ │ │ │ +00016d70: 6973 6820 6f72 2064 6973 7472 6962 7574 ish or distribut │ │ │ │ │ +00016d80: 6520 4f70 6171 7565 2063 6f70 6965 7320 e Opaque copies │ │ │ │ │ +00016d90: 6f66 2074 6865 2044 6f63 756d 656e 740a of the Document. │ │ │ │ │ +00016da0: 2020 2020 206e 756d 6265 7269 6e67 206d numbering m │ │ │ │ │ +00016db0: 6f72 6520 7468 616e 2031 3030 2c20 796f ore than 100, yo │ │ │ │ │ +00016dc0: 7520 6d75 7374 2065 6974 6865 7220 696e u must either in │ │ │ │ │ +00016dd0: 636c 7564 6520 6120 6d61 6368 696e 652d clude a machine- │ │ │ │ │ +00016de0: 7265 6164 6162 6c65 0a20 2020 2020 5472 readable. Tr │ │ │ │ │ +00016df0: 616e 7370 6172 656e 7420 636f 7079 2061 ansparent copy a │ │ │ │ │ +00016e00: 6c6f 6e67 2077 6974 6820 6561 6368 204f long with each O │ │ │ │ │ +00016e10: 7061 7175 6520 636f 7079 2c20 6f72 2073 paque copy, or s │ │ │ │ │ +00016e20: 7461 7465 2069 6e20 6f72 2077 6974 680a tate in or with. │ │ │ │ │ +00016e30: 2020 2020 2065 6163 6820 4f70 6171 7565 each Opaque │ │ │ │ │ +00016e40: 2063 6f70 7920 6120 636f 6d70 7574 6572 copy a computer │ │ │ │ │ +00016e50: 2d6e 6574 776f 726b 206c 6f63 6174 696f -network locatio │ │ │ │ │ +00016e60: 6e20 6672 6f6d 2077 6869 6368 2074 6865 n from which the │ │ │ │ │ +00016e70: 2067 656e 6572 616c 0a20 2020 2020 6e65 general. ne │ │ │ │ │ +00016e80: 7477 6f72 6b2d 7573 696e 6720 7075 626c twork-using publ │ │ │ │ │ +00016e90: 6963 2068 6173 2061 6363 6573 7320 746f ic has access to │ │ │ │ │ +00016ea0: 2064 6f77 6e6c 6f61 6420 7573 696e 6720 download using │ │ │ │ │ +00016eb0: 7075 626c 6963 2d73 7461 6e64 6172 640a public-standard. │ │ │ │ │ +00016ec0: 2020 2020 206e 6574 776f 726b 2070 726f network pro │ │ │ │ │ +00016ed0: 746f 636f 6c73 2061 2063 6f6d 706c 6574 tocols a complet │ │ │ │ │ +00016ee0: 6520 5472 616e 7370 6172 656e 7420 636f e Transparent co │ │ │ │ │ +00016ef0: 7079 206f 6620 7468 6520 446f 6375 6d65 py of the Docume │ │ │ │ │ +00016f00: 6e74 2c20 6672 6565 0a20 2020 2020 6f66 nt, free. of │ │ │ │ │ +00016f10: 2061 6464 6564 206d 6174 6572 6961 6c2e added material. │ │ │ │ │ +00016f20: 2020 4966 2079 6f75 2075 7365 2074 6865 If you use the │ │ │ │ │ +00016f30: 206c 6174 7465 7220 6f70 7469 6f6e 2c20 latter option, │ │ │ │ │ +00016f40: 796f 7520 6d75 7374 2074 616b 650a 2020 you must take. │ │ │ │ │ +00016f50: 2020 2072 6561 736f 6e61 626c 7920 7072 reasonably pr │ │ │ │ │ +00016f60: 7564 656e 7420 7374 6570 732c 2077 6865 udent steps, whe │ │ │ │ │ +00016f70: 6e20 796f 7520 6265 6769 6e20 6469 7374 n you begin dist │ │ │ │ │ +00016f80: 7269 6275 7469 6f6e 206f 6620 4f70 6171 ribution of Opaq │ │ │ │ │ +00016f90: 7565 0a20 2020 2020 636f 7069 6573 2069 ue. copies i │ │ │ │ │ +00016fa0: 6e20 7175 616e 7469 7479 2c20 746f 2065 n quantity, to e │ │ │ │ │ +00016fb0: 6e73 7572 6520 7468 6174 2074 6869 7320 nsure that this │ │ │ │ │ +00016fc0: 5472 616e 7370 6172 656e 7420 636f 7079 Transparent copy │ │ │ │ │ +00016fd0: 2077 696c 6c0a 2020 2020 2072 656d 6169 will. remai │ │ │ │ │ +00016fe0: 6e20 7468 7573 2061 6363 6573 7369 626c n thus accessibl │ │ │ │ │ +00016ff0: 6520 6174 2074 6865 2073 7461 7465 6420 e at the stated │ │ │ │ │ +00017000: 6c6f 6361 7469 6f6e 2075 6e74 696c 2061 location until a │ │ │ │ │ +00017010: 7420 6c65 6173 7420 6f6e 650a 2020 2020 t least one. │ │ │ │ │ +00017020: 2079 6561 7220 6166 7465 7220 7468 6520 year after the │ │ │ │ │ +00017030: 6c61 7374 2074 696d 6520 796f 7520 6469 last time you di │ │ │ │ │ +00017040: 7374 7269 6275 7465 2061 6e20 4f70 6171 stribute an Opaq │ │ │ │ │ +00017050: 7565 2063 6f70 7920 2864 6972 6563 746c ue copy (directl │ │ │ │ │ +00017060: 7920 6f72 0a20 2020 2020 7468 726f 7567 y or. throug │ │ │ │ │ +00017070: 6820 796f 7572 2061 6765 6e74 7320 6f72 h your agents or │ │ │ │ │ +00017080: 2072 6574 6169 6c65 7273 2920 6f66 2074 retailers) of t │ │ │ │ │ +00017090: 6861 7420 6564 6974 696f 6e20 746f 2074 hat edition to t │ │ │ │ │ +000170a0: 6865 2070 7562 6c69 632e 0a0a 2020 2020 he public... │ │ │ │ │ +000170b0: 2049 7420 6973 2072 6571 7565 7374 6564 It is requested │ │ │ │ │ +000170c0: 2c20 6275 7420 6e6f 7420 7265 7175 6972 , but not requir │ │ │ │ │ +000170d0: 6564 2c20 7468 6174 2079 6f75 2063 6f6e ed, that you con │ │ │ │ │ +000170e0: 7461 6374 2074 6865 2061 7574 686f 7273 tact the authors │ │ │ │ │ +000170f0: 206f 660a 2020 2020 2074 6865 2044 6f63 of. the Doc │ │ │ │ │ +00017100: 756d 656e 7420 7765 6c6c 2062 6566 6f72 ument well befor │ │ │ │ │ +00017110: 6520 7265 6469 7374 7269 6275 7469 6e67 e redistributing │ │ │ │ │ +00017120: 2061 6e79 206c 6172 6765 206e 756d 6265 any large numbe │ │ │ │ │ +00017130: 7220 6f66 2063 6f70 6965 732c 0a20 2020 r of copies,. │ │ │ │ │ +00017140: 2020 746f 2067 6976 6520 7468 656d 2061 to give them a │ │ │ │ │ +00017150: 2063 6861 6e63 6520 746f 2070 726f 7669 chance to provi │ │ │ │ │ +00017160: 6465 2079 6f75 2077 6974 6820 616e 2075 de you with an u │ │ │ │ │ +00017170: 7064 6174 6564 2076 6572 7369 6f6e 206f pdated version o │ │ │ │ │ +00017180: 6620 7468 650a 2020 2020 2044 6f63 756d f the. Docum │ │ │ │ │ +00017190: 656e 742e 0a0a 2020 342e 204d 4f44 4946 ent... 4. MODIF │ │ │ │ │ +000171a0: 4943 4154 494f 4e53 0a0a 2020 2020 2059 ICATIONS.. Y │ │ │ │ │ +000171b0: 6f75 206d 6179 2063 6f70 7920 616e 6420 ou may copy and │ │ │ │ │ +000171c0: 6469 7374 7269 6275 7465 2061 204d 6f64 distribute a Mod │ │ │ │ │ +000171d0: 6966 6965 6420 5665 7273 696f 6e20 6f66 ified Version of │ │ │ │ │ +000171e0: 2074 6865 2044 6f63 756d 656e 740a 2020 the Document. │ │ │ │ │ +000171f0: 2020 2075 6e64 6572 2074 6865 2063 6f6e under the con │ │ │ │ │ +00017200: 6469 7469 6f6e 7320 6f66 2073 6563 7469 ditions of secti │ │ │ │ │ +00017210: 6f6e 7320 3220 616e 6420 3320 6162 6f76 ons 2 and 3 abov │ │ │ │ │ +00017220: 652c 2070 726f 7669 6465 6420 7468 6174 e, provided that │ │ │ │ │ +00017230: 2079 6f75 0a20 2020 2020 7265 6c65 6173 you. releas │ │ │ │ │ +00017240: 6520 7468 6520 4d6f 6469 6669 6564 2056 e the Modified V │ │ │ │ │ +00017250: 6572 7369 6f6e 2075 6e64 6572 2070 7265 ersion under pre │ │ │ │ │ +00017260: 6369 7365 6c79 2074 6869 7320 4c69 6365 cisely this Lice │ │ │ │ │ +00017270: 6e73 652c 2077 6974 6820 7468 650a 2020 nse, with the. │ │ │ │ │ +00017280: 2020 204d 6f64 6966 6965 6420 5665 7273 Modified Vers │ │ │ │ │ +00017290: 696f 6e20 6669 6c6c 696e 6720 7468 6520 ion filling the │ │ │ │ │ +000172a0: 726f 6c65 206f 6620 7468 6520 446f 6375 role of the Docu │ │ │ │ │ +000172b0: 6d65 6e74 2c20 7468 7573 206c 6963 656e ment, thus licen │ │ │ │ │ +000172c0: 7369 6e67 0a20 2020 2020 6469 7374 7269 sing. distri │ │ │ │ │ +000172d0: 6275 7469 6f6e 2061 6e64 206d 6f64 6966 bution and modif │ │ │ │ │ +000172e0: 6963 6174 696f 6e20 6f66 2074 6865 204d ication of the M │ │ │ │ │ +000172f0: 6f64 6966 6965 6420 5665 7273 696f 6e20 odified Version │ │ │ │ │ +00017300: 746f 2077 686f 6576 6572 0a20 2020 2020 to whoever. │ │ │ │ │ +00017310: 706f 7373 6573 7365 7320 6120 636f 7079 possesses a copy │ │ │ │ │ +00017320: 206f 6620 6974 2e20 2049 6e20 6164 6469 of it. In addi │ │ │ │ │ +00017330: 7469 6f6e 2c20 796f 7520 6d75 7374 2064 tion, you must d │ │ │ │ │ +00017340: 6f20 7468 6573 6520 7468 696e 6773 2069 o these things i │ │ │ │ │ +00017350: 6e0a 2020 2020 2074 6865 204d 6f64 6966 n. the Modif │ │ │ │ │ +00017360: 6965 6420 5665 7273 696f 6e3a 0a0a 2020 ied Version:.. │ │ │ │ │ +00017370: 2020 2020 2041 2e20 5573 6520 696e 2074 A. Use in t │ │ │ │ │ +00017380: 6865 2054 6974 6c65 2050 6167 6520 2861 he Title Page (a │ │ │ │ │ +00017390: 6e64 206f 6e20 7468 6520 636f 7665 7273 nd on the covers │ │ │ │ │ +000173a0: 2c20 6966 2061 6e79 2920 6120 7469 746c , if any) a titl │ │ │ │ │ +000173b0: 650a 2020 2020 2020 2020 2020 6469 7374 e. dist │ │ │ │ │ +000173c0: 696e 6374 2066 726f 6d20 7468 6174 206f inct from that o │ │ │ │ │ +000173d0: 6620 7468 6520 446f 6375 6d65 6e74 2c20 f the Document, │ │ │ │ │ +000173e0: 616e 6420 6672 6f6d 2074 686f 7365 206f and from those o │ │ │ │ │ +000173f0: 6620 7072 6576 696f 7573 0a20 2020 2020 f previous. │ │ │ │ │ +00017400: 2020 2020 2076 6572 7369 6f6e 7320 2877 versions (w │ │ │ │ │ +00017410: 6869 6368 2073 686f 756c 642c 2069 6620 hich should, if │ │ │ │ │ +00017420: 7468 6572 6520 7765 7265 2061 6e79 2c20 there were any, │ │ │ │ │ +00017430: 6265 206c 6973 7465 6420 696e 2074 6865 be listed in the │ │ │ │ │ +00017440: 0a20 2020 2020 2020 2020 2048 6973 746f . Histo │ │ │ │ │ +00017450: 7279 2073 6563 7469 6f6e 206f 6620 7468 ry section of th │ │ │ │ │ +00017460: 6520 446f 6375 6d65 6e74 292e 2020 596f e Document). Yo │ │ │ │ │ +00017470: 7520 6d61 7920 7573 6520 7468 6520 7361 u may use the sa │ │ │ │ │ +00017480: 6d65 2074 6974 6c65 0a20 2020 2020 2020 me title. │ │ │ │ │ +00017490: 2020 2061 7320 6120 7072 6576 696f 7573 as a previous │ │ │ │ │ +000174a0: 2076 6572 7369 6f6e 2069 6620 7468 6520 version if the │ │ │ │ │ +000174b0: 6f72 6967 696e 616c 2070 7562 6c69 7368 original publish │ │ │ │ │ +000174c0: 6572 206f 6620 7468 6174 0a20 2020 2020 er of that. │ │ │ │ │ +000174d0: 2020 2020 2076 6572 7369 6f6e 2067 6976 version giv │ │ │ │ │ +000174e0: 6573 2070 6572 6d69 7373 696f 6e2e 0a0a es permission... │ │ │ │ │ +000174f0: 2020 2020 2020 2042 2e20 4c69 7374 206f B. List o │ │ │ │ │ +00017500: 6e20 7468 6520 5469 746c 6520 5061 6765 n the Title Page │ │ │ │ │ +00017510: 2c20 6173 2061 7574 686f 7273 2c20 6f6e , as authors, on │ │ │ │ │ +00017520: 6520 6f72 206d 6f72 6520 7065 7273 6f6e e or more person │ │ │ │ │ +00017530: 7320 6f72 0a20 2020 2020 2020 2020 2065 s or. e │ │ │ │ │ +00017540: 6e74 6974 6965 7320 7265 7370 6f6e 7369 ntities responsi │ │ │ │ │ +00017550: 626c 6520 666f 7220 6175 7468 6f72 7368 ble for authorsh │ │ │ │ │ +00017560: 6970 206f 6620 7468 6520 6d6f 6469 6669 ip of the modifi │ │ │ │ │ +00017570: 6361 7469 6f6e 7320 696e 0a20 2020 2020 cations in. │ │ │ │ │ +00017580: 2020 2020 2074 6865 204d 6f64 6966 6965 the Modifie │ │ │ │ │ +00017590: 6420 5665 7273 696f 6e2c 2074 6f67 6574 d Version, toget │ │ │ │ │ +000175a0: 6865 7220 7769 7468 2061 7420 6c65 6173 her with at leas │ │ │ │ │ +000175b0: 7420 6669 7665 206f 6620 7468 650a 2020 t five of the. │ │ │ │ │ +000175c0: 2020 2020 2020 2020 7072 696e 6369 7061 principa │ │ │ │ │ +000175d0: 6c20 6175 7468 6f72 7320 6f66 2074 6865 l authors of the │ │ │ │ │ +000175e0: 2044 6f63 756d 656e 7420 2861 6c6c 206f Document (all o │ │ │ │ │ +000175f0: 6620 6974 7320 7072 696e 6369 7061 6c0a f its principal. │ │ │ │ │ +00017600: 2020 2020 2020 2020 2020 6175 7468 6f72 author │ │ │ │ │ +00017610: 732c 2069 6620 6974 2068 6173 2066 6577 s, if it has few │ │ │ │ │ +00017620: 6572 2074 6861 6e20 6669 7665 292c 2075 er than five), u │ │ │ │ │ +00017630: 6e6c 6573 7320 7468 6579 2072 656c 6561 nless they relea │ │ │ │ │ +00017640: 7365 2079 6f75 0a20 2020 2020 2020 2020 se you. │ │ │ │ │ +00017650: 2066 726f 6d20 7468 6973 2072 6571 7569 from this requi │ │ │ │ │ +00017660: 7265 6d65 6e74 2e0a 0a20 2020 2020 2020 rement... │ │ │ │ │ +00017670: 432e 2053 7461 7465 206f 6e20 7468 6520 C. State on the │ │ │ │ │ +00017680: 5469 746c 6520 7061 6765 2074 6865 206e Title page the n │ │ │ │ │ +00017690: 616d 6520 6f66 2074 6865 2070 7562 6c69 ame of the publi │ │ │ │ │ +000176a0: 7368 6572 206f 6620 7468 650a 2020 2020 sher of the. │ │ │ │ │ +000176b0: 2020 2020 2020 4d6f 6469 6669 6564 2056 Modified V │ │ │ │ │ +000176c0: 6572 7369 6f6e 2c20 6173 2074 6865 2070 ersion, as the p │ │ │ │ │ +000176d0: 7562 6c69 7368 6572 2e0a 0a20 2020 2020 ublisher... │ │ │ │ │ +000176e0: 2020 442e 2050 7265 7365 7276 6520 616c D. Preserve al │ │ │ │ │ +000176f0: 6c20 7468 6520 636f 7079 7269 6768 7420 l the copyright │ │ │ │ │ +00017700: 6e6f 7469 6365 7320 6f66 2074 6865 2044 notices of the D │ │ │ │ │ +00017710: 6f63 756d 656e 742e 0a0a 2020 2020 2020 ocument... │ │ │ │ │ +00017720: 2045 2e20 4164 6420 616e 2061 7070 726f E. Add an appro │ │ │ │ │ +00017730: 7072 6961 7465 2063 6f70 7972 6967 6874 priate copyright │ │ │ │ │ +00017740: 206e 6f74 6963 6520 666f 7220 796f 7572 notice for your │ │ │ │ │ +00017750: 206d 6f64 6966 6963 6174 696f 6e73 0a20 modifications. │ │ │ │ │ +00017760: 2020 2020 2020 2020 2061 646a 6163 656e adjacen │ │ │ │ │ +00017770: 7420 746f 2074 6865 206f 7468 6572 2063 t to the other c │ │ │ │ │ +00017780: 6f70 7972 6967 6874 206e 6f74 6963 6573 opyright notices │ │ │ │ │ +00017790: 2e0a 0a20 2020 2020 2020 462e 2049 6e63 ... F. Inc │ │ │ │ │ +000177a0: 6c75 6465 2c20 696d 6d65 6469 6174 656c lude, immediatel │ │ │ │ │ +000177b0: 7920 6166 7465 7220 7468 6520 636f 7079 y after the copy │ │ │ │ │ +000177c0: 7269 6768 7420 6e6f 7469 6365 732c 2061 right notices, a │ │ │ │ │ +000177d0: 206c 6963 656e 7365 0a20 2020 2020 2020 license. │ │ │ │ │ +000177e0: 2020 206e 6f74 6963 6520 6769 7669 6e67 notice giving │ │ │ │ │ +000177f0: 2074 6865 2070 7562 6c69 6320 7065 726d the public perm │ │ │ │ │ +00017800: 6973 7369 6f6e 2074 6f20 7573 6520 7468 ission to use th │ │ │ │ │ +00017810: 6520 4d6f 6469 6669 6564 0a20 2020 2020 e Modified. │ │ │ │ │ +00017820: 2020 2020 2056 6572 7369 6f6e 2075 6e64 Version und │ │ │ │ │ +00017830: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ +00017840: 7468 6973 204c 6963 656e 7365 2c20 696e this License, in │ │ │ │ │ +00017850: 2074 6865 2066 6f72 6d20 7368 6f77 6e20 the form shown │ │ │ │ │ +00017860: 696e 0a20 2020 2020 2020 2020 2074 6865 in. the │ │ │ │ │ +00017870: 2041 6464 656e 6475 6d20 6265 6c6f 772e Addendum below. │ │ │ │ │ +00017880: 0a0a 2020 2020 2020 2047 2e20 5072 6573 .. G. Pres │ │ │ │ │ +00017890: 6572 7665 2069 6e20 7468 6174 206c 6963 erve in that lic │ │ │ │ │ +000178a0: 656e 7365 206e 6f74 6963 6520 7468 6520 ense notice the │ │ │ │ │ +000178b0: 6675 6c6c 206c 6973 7473 206f 6620 496e full lists of In │ │ │ │ │ +000178c0: 7661 7269 616e 740a 2020 2020 2020 2020 variant. │ │ │ │ │ +000178d0: 2020 5365 6374 696f 6e73 2061 6e64 2072 Sections and r │ │ │ │ │ +000178e0: 6571 7569 7265 6420 436f 7665 7220 5465 equired Cover Te │ │ │ │ │ +000178f0: 7874 7320 6769 7665 6e20 696e 2074 6865 xts given in the │ │ │ │ │ +00017900: 2044 6f63 756d 656e 7427 730a 2020 2020 Document's. │ │ │ │ │ +00017910: 2020 2020 2020 6c69 6365 6e73 6520 6e6f license no │ │ │ │ │ +00017920: 7469 6365 2e0a 0a20 2020 2020 2020 482e tice... H. │ │ │ │ │ +00017930: 2049 6e63 6c75 6465 2061 6e20 756e 616c Include an unal │ │ │ │ │ +00017940: 7465 7265 6420 636f 7079 206f 6620 7468 tered copy of th │ │ │ │ │ +00017950: 6973 204c 6963 656e 7365 2e0a 0a20 2020 is License... │ │ │ │ │ +00017960: 2020 2020 492e 2050 7265 7365 7276 6520 I. Preserve │ │ │ │ │ +00017970: 7468 6520 7365 6374 696f 6e20 456e 7469 the section Enti │ │ │ │ │ +00017980: 746c 6564 2022 4869 7374 6f72 7922 2c20 tled "History", │ │ │ │ │ +00017990: 5072 6573 6572 7665 2069 7473 2054 6974 Preserve its Tit │ │ │ │ │ +000179a0: 6c65 2c0a 2020 2020 2020 2020 2020 616e le,. an │ │ │ │ │ +000179b0: 6420 6164 6420 746f 2069 7420 616e 2069 d add to it an i │ │ │ │ │ +000179c0: 7465 6d20 7374 6174 696e 6720 6174 206c tem stating at l │ │ │ │ │ +000179d0: 6561 7374 2074 6865 2074 6974 6c65 2c20 east the title, │ │ │ │ │ +000179e0: 7965 6172 2c20 6e65 770a 2020 2020 2020 year, new. │ │ │ │ │ +000179f0: 2020 2020 6175 7468 6f72 732c 2061 6e64 authors, and │ │ │ │ │ +00017a00: 2070 7562 6c69 7368 6572 206f 6620 7468 publisher of th │ │ │ │ │ +00017a10: 6520 4d6f 6469 6669 6564 2056 6572 7369 e Modified Versi │ │ │ │ │ +00017a20: 6f6e 2061 7320 6769 7665 6e20 6f6e 2074 on as given on t │ │ │ │ │ +00017a30: 6865 0a20 2020 2020 2020 2020 2054 6974 he. Tit │ │ │ │ │ +00017a40: 6c65 2050 6167 652e 2020 4966 2074 6865 le Page. If the │ │ │ │ │ +00017a50: 7265 2069 7320 6e6f 2073 6563 7469 6f6e re is no section │ │ │ │ │ +00017a60: 2045 6e74 6974 6c65 6420 2248 6973 746f Entitled "Histo │ │ │ │ │ +00017a70: 7279 2220 696e 2074 6865 0a20 2020 2020 ry" in the. │ │ │ │ │ +00017a80: 2020 2020 2044 6f63 756d 656e 742c 2063 Document, c │ │ │ │ │ +00017a90: 7265 6174 6520 6f6e 6520 7374 6174 696e reate one statin │ │ │ │ │ +00017aa0: 6720 7468 6520 7469 746c 652c 2079 6561 g the title, yea │ │ │ │ │ +00017ab0: 722c 2061 7574 686f 7273 2c20 616e 640a r, authors, and. │ │ │ │ │ +00017ac0: 2020 2020 2020 2020 2020 7075 626c 6973 publis │ │ │ │ │ +00017ad0: 6865 7220 6f66 2074 6865 2044 6f63 756d her of the Docum │ │ │ │ │ +00017ae0: 656e 7420 6173 2067 6976 656e 206f 6e20 ent as given on │ │ │ │ │ +00017af0: 6974 7320 5469 746c 6520 5061 6765 2c20 its Title Page, │ │ │ │ │ +00017b00: 7468 656e 2061 6464 0a20 2020 2020 2020 then add. │ │ │ │ │ +00017b10: 2020 2061 6e20 6974 656d 2064 6573 6372 an item descr │ │ │ │ │ +00017b20: 6962 696e 6720 7468 6520 4d6f 6469 6669 ibing the Modifi │ │ │ │ │ +00017b30: 6564 2056 6572 7369 6f6e 2061 7320 7374 ed Version as st │ │ │ │ │ +00017b40: 6174 6564 2069 6e20 7468 650a 2020 2020 ated in the. │ │ │ │ │ +00017b50: 2020 2020 2020 7072 6576 696f 7573 2073 previous s │ │ │ │ │ +00017b60: 656e 7465 6e63 652e 0a0a 2020 2020 2020 entence... │ │ │ │ │ +00017b70: 204a 2e20 5072 6573 6572 7665 2074 6865 J. Preserve the │ │ │ │ │ +00017b80: 206e 6574 776f 726b 206c 6f63 6174 696f network locatio │ │ │ │ │ +00017b90: 6e2c 2069 6620 616e 792c 2067 6976 656e n, if any, given │ │ │ │ │ +00017ba0: 2069 6e20 7468 6520 446f 6375 6d65 6e74 in the Document │ │ │ │ │ +00017bb0: 0a20 2020 2020 2020 2020 2066 6f72 2070 . for p │ │ │ │ │ +00017bc0: 7562 6c69 6320 6163 6365 7373 2074 6f20 ublic access to │ │ │ │ │ +00017bd0: 6120 5472 616e 7370 6172 656e 7420 636f a Transparent co │ │ │ │ │ +00017be0: 7079 206f 6620 7468 6520 446f 6375 6d65 py of the Docume │ │ │ │ │ +00017bf0: 6e74 2c20 616e 640a 2020 2020 2020 2020 nt, and. │ │ │ │ │ +00017c00: 2020 6c69 6b65 7769 7365 2074 6865 206e likewise the n │ │ │ │ │ +00017c10: 6574 776f 726b 206c 6f63 6174 696f 6e73 etwork locations │ │ │ │ │ +00017c20: 2067 6976 656e 2069 6e20 7468 6520 446f given in the Do │ │ │ │ │ +00017c30: 6375 6d65 6e74 2066 6f72 0a20 2020 2020 cument for. │ │ │ │ │ +00017c40: 2020 2020 2070 7265 7669 6f75 7320 7665 previous ve │ │ │ │ │ +00017c50: 7273 696f 6e73 2069 7420 7761 7320 6261 rsions it was ba │ │ │ │ │ +00017c60: 7365 6420 6f6e 2e20 2054 6865 7365 206d sed on. These m │ │ │ │ │ +00017c70: 6179 2062 6520 706c 6163 6564 2069 6e20 ay be placed in │ │ │ │ │ +00017c80: 7468 650a 2020 2020 2020 2020 2020 2248 the. "H │ │ │ │ │ +00017c90: 6973 746f 7279 2220 7365 6374 696f 6e2e istory" section. │ │ │ │ │ +00017ca0: 2020 596f 7520 6d61 7920 6f6d 6974 2061 You may omit a │ │ │ │ │ +00017cb0: 206e 6574 776f 726b 206c 6f63 6174 696f network locatio │ │ │ │ │ +00017cc0: 6e20 666f 7220 6120 776f 726b 0a20 2020 n for a work. │ │ │ │ │ +00017cd0: 2020 2020 2020 2074 6861 7420 7761 7320 that was │ │ │ │ │ +00017ce0: 7075 626c 6973 6865 6420 6174 206c 6561 published at lea │ │ │ │ │ +00017cf0: 7374 2066 6f75 7220 7965 6172 7320 6265 st four years be │ │ │ │ │ +00017d00: 666f 7265 2074 6865 2044 6f63 756d 656e fore the Documen │ │ │ │ │ +00017d10: 740a 2020 2020 2020 2020 2020 6974 7365 t. itse │ │ │ │ │ +00017d20: 6c66 2c20 6f72 2069 6620 7468 6520 6f72 lf, or if the or │ │ │ │ │ +00017d30: 6967 696e 616c 2070 7562 6c69 7368 6572 iginal publisher │ │ │ │ │ +00017d40: 206f 6620 7468 6520 7665 7273 696f 6e20 of the version │ │ │ │ │ +00017d50: 6974 2072 6566 6572 730a 2020 2020 2020 it refers. │ │ │ │ │ +00017d60: 2020 2020 746f 2067 6976 6573 2070 6572 to gives per │ │ │ │ │ +00017d70: 6d69 7373 696f 6e2e 0a0a 2020 2020 2020 mission... │ │ │ │ │ +00017d80: 204b 2e20 466f 7220 616e 7920 7365 6374 K. For any sect │ │ │ │ │ +00017d90: 696f 6e20 456e 7469 746c 6564 2022 4163 ion Entitled "Ac │ │ │ │ │ +00017da0: 6b6e 6f77 6c65 6467 656d 656e 7473 2220 knowledgements" │ │ │ │ │ +00017db0: 6f72 2022 4465 6469 6361 7469 6f6e 7322 or "Dedications" │ │ │ │ │ +00017dc0: 2c0a 2020 2020 2020 2020 2020 5072 6573 ,. Pres │ │ │ │ │ +00017dd0: 6572 7665 2074 6865 2054 6974 6c65 206f erve the Title o │ │ │ │ │ +00017de0: 6620 7468 6520 7365 6374 696f 6e2c 2061 f the section, a │ │ │ │ │ +00017df0: 6e64 2070 7265 7365 7276 6520 696e 2074 nd preserve in t │ │ │ │ │ +00017e00: 6865 2073 6563 7469 6f6e 0a20 2020 2020 he section. │ │ │ │ │ +00017e10: 2020 2020 2061 6c6c 2074 6865 2073 7562 all the sub │ │ │ │ │ +00017e20: 7374 616e 6365 2061 6e64 2074 6f6e 6520 stance and tone │ │ │ │ │ +00017e30: 6f66 2065 6163 6820 6f66 2074 6865 2063 of each of the c │ │ │ │ │ +00017e40: 6f6e 7472 6962 7574 6f72 0a20 2020 2020 ontributor. │ │ │ │ │ +00017e50: 2020 2020 2061 636b 6e6f 776c 6564 6765 acknowledge │ │ │ │ │ +00017e60: 6d65 6e74 7320 616e 642f 6f72 2064 6564 ments and/or ded │ │ │ │ │ +00017e70: 6963 6174 696f 6e73 2067 6976 656e 2074 ications given t │ │ │ │ │ +00017e80: 6865 7265 696e 2e0a 0a20 2020 2020 2020 herein... │ │ │ │ │ +00017e90: 4c2e 2050 7265 7365 7276 6520 616c 6c20 L. Preserve all │ │ │ │ │ +00017ea0: 7468 6520 496e 7661 7269 616e 7420 5365 the Invariant Se │ │ │ │ │ +00017eb0: 6374 696f 6e73 206f 6620 7468 6520 446f ctions of the Do │ │ │ │ │ +00017ec0: 6375 6d65 6e74 2c20 756e 616c 7465 7265 cument, unaltere │ │ │ │ │ +00017ed0: 640a 2020 2020 2020 2020 2020 696e 2074 d. in t │ │ │ │ │ +00017ee0: 6865 6972 2074 6578 7420 616e 6420 696e heir text and in │ │ │ │ │ +00017ef0: 2074 6865 6972 2074 6974 6c65 732e 2020 their titles. │ │ │ │ │ +00017f00: 5365 6374 696f 6e20 6e75 6d62 6572 7320 Section numbers │ │ │ │ │ +00017f10: 6f72 2074 6865 0a20 2020 2020 2020 2020 or the. │ │ │ │ │ +00017f20: 2065 7175 6976 616c 656e 7420 6172 6520 equivalent are │ │ │ │ │ +00017f30: 6e6f 7420 636f 6e73 6964 6572 6564 2070 not considered p │ │ │ │ │ +00017f40: 6172 7420 6f66 2074 6865 2073 6563 7469 art of the secti │ │ │ │ │ +00017f50: 6f6e 2074 6974 6c65 732e 0a0a 2020 2020 on titles... │ │ │ │ │ +00017f60: 2020 204d 2e20 4465 6c65 7465 2061 6e79 M. Delete any │ │ │ │ │ +00017f70: 2073 6563 7469 6f6e 2045 6e74 6974 6c65 section Entitle │ │ │ │ │ +00017f80: 6420 2245 6e64 6f72 7365 6d65 6e74 7322 d "Endorsements" │ │ │ │ │ +00017f90: 2e20 2053 7563 6820 6120 7365 6374 696f . Such a sectio │ │ │ │ │ +00017fa0: 6e0a 2020 2020 2020 2020 2020 6d61 7920 n. may │ │ │ │ │ +00017fb0: 6e6f 7420 6265 2069 6e63 6c75 6465 6420 not be included │ │ │ │ │ +00017fc0: 696e 2074 6865 204d 6f64 6966 6965 6420 in the Modified │ │ │ │ │ +00017fd0: 5665 7273 696f 6e2e 0a0a 2020 2020 2020 Version... │ │ │ │ │ +00017fe0: 204e 2e20 446f 206e 6f74 2072 6574 6974 N. Do not retit │ │ │ │ │ +00017ff0: 6c65 2061 6e79 2065 7869 7374 696e 6720 le any existing │ │ │ │ │ +00018000: 7365 6374 696f 6e20 746f 2062 6520 456e section to be En │ │ │ │ │ +00018010: 7469 746c 6564 0a20 2020 2020 2020 2020 titled. │ │ │ │ │ +00018020: 2022 456e 646f 7273 656d 656e 7473 2220 "Endorsements" │ │ │ │ │ +00018030: 6f72 2074 6f20 636f 6e66 6c69 6374 2069 or to conflict i │ │ │ │ │ +00018040: 6e20 7469 746c 6520 7769 7468 2061 6e79 n title with any │ │ │ │ │ +00018050: 2049 6e76 6172 6961 6e74 0a20 2020 2020 Invariant. │ │ │ │ │ +00018060: 2020 2020 2053 6563 7469 6f6e 2e0a 0a20 Section... │ │ │ │ │ +00018070: 2020 2020 2020 4f2e 2050 7265 7365 7276 O. Preserv │ │ │ │ │ +00018080: 6520 616e 7920 5761 7272 616e 7479 2044 e any Warranty D │ │ │ │ │ +00018090: 6973 636c 6169 6d65 7273 2e0a 0a20 2020 isclaimers... │ │ │ │ │ +000180a0: 2020 4966 2074 6865 204d 6f64 6966 6965 If the Modifie │ │ │ │ │ +000180b0: 6420 5665 7273 696f 6e20 696e 636c 7564 d Version includ │ │ │ │ │ +000180c0: 6573 206e 6577 2066 726f 6e74 2d6d 6174 es new front-mat │ │ │ │ │ +000180d0: 7465 7220 7365 6374 696f 6e73 206f 720a ter sections or. │ │ │ │ │ +000180e0: 2020 2020 2061 7070 656e 6469 6365 7320 appendices │ │ │ │ │ +000180f0: 7468 6174 2071 7561 6c69 6679 2061 7320 that qualify as │ │ │ │ │ +00018100: 5365 636f 6e64 6172 7920 5365 6374 696f Secondary Sectio │ │ │ │ │ +00018110: 6e73 2061 6e64 2063 6f6e 7461 696e 206e ns and contain n │ │ │ │ │ +00018120: 6f0a 2020 2020 206d 6174 6572 6961 6c20 o. material │ │ │ │ │ +00018130: 636f 7069 6564 2066 726f 6d20 7468 6520 copied from the │ │ │ │ │ +00018140: 446f 6375 6d65 6e74 2c20 796f 7520 6d61 Document, you ma │ │ │ │ │ +00018150: 7920 6174 2079 6f75 7220 6f70 7469 6f6e y at your option │ │ │ │ │ +00018160: 2064 6573 6967 6e61 7465 0a20 2020 2020 designate. │ │ │ │ │ +00018170: 736f 6d65 206f 7220 616c 6c20 6f66 2074 some or all of t │ │ │ │ │ +00018180: 6865 7365 2073 6563 7469 6f6e 7320 6173 hese sections as │ │ │ │ │ +00018190: 2069 6e76 6172 6961 6e74 2e20 2054 6f20 invariant. To │ │ │ │ │ +000181a0: 646f 2074 6869 732c 2061 6464 2074 6865 do this, add the │ │ │ │ │ +000181b0: 6972 0a20 2020 2020 7469 746c 6573 2074 ir. titles t │ │ │ │ │ +000181c0: 6f20 7468 6520 6c69 7374 206f 6620 496e o the list of In │ │ │ │ │ +000181d0: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ +000181e0: 2069 6e20 7468 6520 4d6f 6469 6669 6564 in the Modified │ │ │ │ │ +000181f0: 2056 6572 7369 6f6e 2773 0a20 2020 2020 Version's. │ │ │ │ │ +00018200: 6c69 6365 6e73 6520 6e6f 7469 6365 2e20 license notice. │ │ │ │ │ +00018210: 2054 6865 7365 2074 6974 6c65 7320 6d75 These titles mu │ │ │ │ │ +00018220: 7374 2062 6520 6469 7374 696e 6374 2066 st be distinct f │ │ │ │ │ +00018230: 726f 6d20 616e 7920 6f74 6865 720a 2020 rom any other. │ │ │ │ │ +00018240: 2020 2073 6563 7469 6f6e 2074 6974 6c65 section title │ │ │ │ │ +00018250: 732e 0a0a 2020 2020 2059 6f75 206d 6179 s... You may │ │ │ │ │ +00018260: 2061 6464 2061 2073 6563 7469 6f6e 2045 add a section E │ │ │ │ │ +00018270: 6e74 6974 6c65 6420 2245 6e64 6f72 7365 ntitled "Endorse │ │ │ │ │ +00018280: 6d65 6e74 7322 2c20 7072 6f76 6964 6564 ments", provided │ │ │ │ │ +00018290: 2069 7420 636f 6e74 6169 6e73 0a20 2020 it contains. │ │ │ │ │ +000182a0: 2020 6e6f 7468 696e 6720 6275 7420 656e nothing but en │ │ │ │ │ +000182b0: 646f 7273 656d 656e 7473 206f 6620 796f dorsements of yo │ │ │ │ │ +000182c0: 7572 204d 6f64 6966 6965 6420 5665 7273 ur Modified Vers │ │ │ │ │ +000182d0: 696f 6e20 6279 2076 6172 696f 7573 0a20 ion by various. │ │ │ │ │ +000182e0: 2020 2020 7061 7274 6965 732d 2d66 6f72 parties--for │ │ │ │ │ +000182f0: 2065 7861 6d70 6c65 2c20 7374 6174 656d example, statem │ │ │ │ │ +00018300: 656e 7473 206f 6620 7065 6572 2072 6576 ents of peer rev │ │ │ │ │ +00018310: 6965 7720 6f72 2074 6861 7420 7468 6520 iew or that the │ │ │ │ │ +00018320: 7465 7874 0a20 2020 2020 6861 7320 6265 text. has be │ │ │ │ │ +00018330: 656e 2061 7070 726f 7665 6420 6279 2061 en approved by a │ │ │ │ │ +00018340: 6e20 6f72 6761 6e69 7a61 7469 6f6e 2061 n organization a │ │ │ │ │ +00018350: 7320 7468 6520 6175 7468 6f72 6974 6174 s the authoritat │ │ │ │ │ +00018360: 6976 650a 2020 2020 2064 6566 696e 6974 ive. definit │ │ │ │ │ +00018370: 696f 6e20 6f66 2061 2073 7461 6e64 6172 ion of a standar │ │ │ │ │ +00018380: 642e 0a0a 2020 2020 2059 6f75 206d 6179 d... You may │ │ │ │ │ +00018390: 2061 6464 2061 2070 6173 7361 6765 206f add a passage o │ │ │ │ │ +000183a0: 6620 7570 2074 6f20 6669 7665 2077 6f72 f up to five wor │ │ │ │ │ +000183b0: 6473 2061 7320 6120 4672 6f6e 742d 436f ds as a Front-Co │ │ │ │ │ +000183c0: 7665 7220 5465 7874 2c0a 2020 2020 2061 ver Text,. a │ │ │ │ │ +000183d0: 6e64 2061 2070 6173 7361 6765 206f 6620 nd a passage of │ │ │ │ │ +000183e0: 7570 2074 6f20 3235 2077 6f72 6473 2061 up to 25 words a │ │ │ │ │ +000183f0: 7320 6120 4261 636b 2d43 6f76 6572 2054 s a Back-Cover T │ │ │ │ │ +00018400: 6578 742c 2074 6f20 7468 6520 656e 6420 ext, to the end │ │ │ │ │ +00018410: 6f66 0a20 2020 2020 7468 6520 6c69 7374 of. the list │ │ │ │ │ +00018420: 206f 6620 436f 7665 7220 5465 7874 7320 of Cover Texts │ │ │ │ │ +00018430: 696e 2074 6865 204d 6f64 6966 6965 6420 in the Modified │ │ │ │ │ +00018440: 5665 7273 696f 6e2e 2020 4f6e 6c79 206f Version. Only o │ │ │ │ │ +00018450: 6e65 2070 6173 7361 6765 0a20 2020 2020 ne passage. │ │ │ │ │ +00018460: 6f66 2046 726f 6e74 2d43 6f76 6572 2054 of Front-Cover T │ │ │ │ │ +00018470: 6578 7420 616e 6420 6f6e 6520 6f66 2042 ext and one of B │ │ │ │ │ +00018480: 6163 6b2d 436f 7665 7220 5465 7874 206d ack-Cover Text m │ │ │ │ │ +00018490: 6179 2062 6520 6164 6465 6420 6279 2028 ay be added by ( │ │ │ │ │ +000184a0: 6f72 0a20 2020 2020 7468 726f 7567 6820 or. through │ │ │ │ │ +000184b0: 6172 7261 6e67 656d 656e 7473 206d 6164 arrangements mad │ │ │ │ │ +000184c0: 6520 6279 2920 616e 7920 6f6e 6520 656e e by) any one en │ │ │ │ │ +000184d0: 7469 7479 2e20 2049 6620 7468 6520 446f tity. If the Do │ │ │ │ │ +000184e0: 6375 6d65 6e74 0a20 2020 2020 616c 7265 cument. alre │ │ │ │ │ +000184f0: 6164 7920 696e 636c 7564 6573 2061 2063 ady includes a c │ │ │ │ │ +00018500: 6f76 6572 2074 6578 7420 666f 7220 7468 over text for th │ │ │ │ │ +00018510: 6520 7361 6d65 2063 6f76 6572 2c20 7072 e same cover, pr │ │ │ │ │ +00018520: 6576 696f 7573 6c79 2061 6464 6564 0a20 eviously added. │ │ │ │ │ +00018530: 2020 2020 6279 2079 6f75 206f 7220 6279 by you or by │ │ │ │ │ +00018540: 2061 7272 616e 6765 6d65 6e74 206d 6164 arrangement mad │ │ │ │ │ +00018550: 6520 6279 2074 6865 2073 616d 6520 656e e by the same en │ │ │ │ │ +00018560: 7469 7479 2079 6f75 2061 7265 2061 6374 tity you are act │ │ │ │ │ +00018570: 696e 6720 6f6e 0a20 2020 2020 6265 6861 ing on. beha │ │ │ │ │ +00018580: 6c66 206f 662c 2079 6f75 206d 6179 206e lf of, you may n │ │ │ │ │ +00018590: 6f74 2061 6464 2061 6e6f 7468 6572 3b20 ot add another; │ │ │ │ │ +000185a0: 6275 7420 796f 7520 6d61 7920 7265 706c but you may repl │ │ │ │ │ +000185b0: 6163 6520 7468 6520 6f6c 640a 2020 2020 ace the old. │ │ │ │ │ +000185c0: 206f 6e65 2c20 6f6e 2065 7870 6c69 6369 one, on explici │ │ │ │ │ +000185d0: 7420 7065 726d 6973 7369 6f6e 2066 726f t permission fro │ │ │ │ │ +000185e0: 6d20 7468 6520 7072 6576 696f 7573 2070 m the previous p │ │ │ │ │ +000185f0: 7562 6c69 7368 6572 2074 6861 7420 6164 ublisher that ad │ │ │ │ │ +00018600: 6465 640a 2020 2020 2074 6865 206f 6c64 ded. the old │ │ │ │ │ +00018610: 206f 6e65 2e0a 0a20 2020 2020 5468 6520 one... The │ │ │ │ │ +00018620: 6175 7468 6f72 2873 2920 616e 6420 7075 author(s) and pu │ │ │ │ │ +00018630: 626c 6973 6865 7228 7329 206f 6620 7468 blisher(s) of th │ │ │ │ │ +00018640: 6520 446f 6375 6d65 6e74 2064 6f20 6e6f e Document do no │ │ │ │ │ +00018650: 7420 6279 2074 6869 730a 2020 2020 204c t by this. L │ │ │ │ │ +00018660: 6963 656e 7365 2067 6976 6520 7065 726d icense give perm │ │ │ │ │ +00018670: 6973 7369 6f6e 2074 6f20 7573 6520 7468 ission to use th │ │ │ │ │ +00018680: 6569 7220 6e61 6d65 7320 666f 7220 7075 eir names for pu │ │ │ │ │ +00018690: 626c 6963 6974 7920 666f 7220 6f72 2074 blicity for or t │ │ │ │ │ +000186a0: 6f0a 2020 2020 2061 7373 6572 7420 6f72 o. assert or │ │ │ │ │ +000186b0: 2069 6d70 6c79 2065 6e64 6f72 7365 6d65 imply endorseme │ │ │ │ │ +000186c0: 6e74 206f 6620 616e 7920 4d6f 6469 6669 nt of any Modifi │ │ │ │ │ +000186d0: 6564 2056 6572 7369 6f6e 2e0a 0a20 2035 ed Version... 5 │ │ │ │ │ +000186e0: 2e20 434f 4d42 494e 494e 4720 444f 4355 . COMBINING DOCU │ │ │ │ │ +000186f0: 4d45 4e54 530a 0a20 2020 2020 596f 7520 MENTS.. You │ │ │ │ │ +00018700: 6d61 7920 636f 6d62 696e 6520 7468 6520 may combine the │ │ │ │ │ +00018710: 446f 6375 6d65 6e74 2077 6974 6820 6f74 Document with ot │ │ │ │ │ +00018720: 6865 7220 646f 6375 6d65 6e74 7320 7265 her documents re │ │ │ │ │ +00018730: 6c65 6173 6564 2075 6e64 6572 0a20 2020 leased under. │ │ │ │ │ +00018740: 2020 7468 6973 204c 6963 656e 7365 2c20 this License, │ │ │ │ │ +00018750: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ +00018760: 6465 6669 6e65 6420 696e 2073 6563 7469 defined in secti │ │ │ │ │ +00018770: 6f6e 2034 2061 626f 7665 2066 6f72 0a20 on 4 above for. │ │ │ │ │ +00018780: 2020 2020 6d6f 6469 6669 6564 2076 6572 modified ver │ │ │ │ │ +00018790: 7369 6f6e 732c 2070 726f 7669 6465 6420 sions, provided │ │ │ │ │ +000187a0: 7468 6174 2079 6f75 2069 6e63 6c75 6465 that you include │ │ │ │ │ +000187b0: 2069 6e20 7468 6520 636f 6d62 696e 6174 in the combinat │ │ │ │ │ +000187c0: 696f 6e20 616c 6c0a 2020 2020 206f 6620 ion all. of │ │ │ │ │ +000187d0: 7468 6520 496e 7661 7269 616e 7420 5365 the Invariant Se │ │ │ │ │ +000187e0: 6374 696f 6e73 206f 6620 616c 6c20 6f66 ctions of all of │ │ │ │ │ +000187f0: 2074 6865 206f 7269 6769 6e61 6c20 646f the original do │ │ │ │ │ +00018800: 6375 6d65 6e74 732c 0a20 2020 2020 756e cuments,. un │ │ │ │ │ +00018810: 6d6f 6469 6669 6564 2c20 616e 6420 6c69 modified, and li │ │ │ │ │ +00018820: 7374 2074 6865 6d20 616c 6c20 6173 2049 st them all as I │ │ │ │ │ +00018830: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ +00018840: 7320 6f66 2079 6f75 720a 2020 2020 2063 s of your. c │ │ │ │ │ +00018850: 6f6d 6269 6e65 6420 776f 726b 2069 6e20 ombined work in │ │ │ │ │ +00018860: 6974 7320 6c69 6365 6e73 6520 6e6f 7469 its license noti │ │ │ │ │ +00018870: 6365 2c20 616e 6420 7468 6174 2079 6f75 ce, and that you │ │ │ │ │ +00018880: 2070 7265 7365 7276 6520 616c 6c0a 2020 preserve all. │ │ │ │ │ +00018890: 2020 2074 6865 6972 2057 6172 7261 6e74 their Warrant │ │ │ │ │ +000188a0: 7920 4469 7363 6c61 696d 6572 732e 0a0a y Disclaimers... │ │ │ │ │ +000188b0: 2020 2020 2054 6865 2063 6f6d 6269 6e65 The combine │ │ │ │ │ +000188c0: 6420 776f 726b 206e 6565 6420 6f6e 6c79 d work need only │ │ │ │ │ +000188d0: 2063 6f6e 7461 696e 206f 6e65 2063 6f70 contain one cop │ │ │ │ │ +000188e0: 7920 6f66 2074 6869 7320 4c69 6365 6e73 y of this Licens │ │ │ │ │ +000188f0: 652c 2061 6e64 0a20 2020 2020 6d75 6c74 e, and. mult │ │ │ │ │ +00018900: 6970 6c65 2069 6465 6e74 6963 616c 2049 iple identical I │ │ │ │ │ +00018910: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ +00018920: 7320 6d61 7920 6265 2072 6570 6c61 6365 s may be replace │ │ │ │ │ +00018930: 6420 7769 7468 2061 2073 696e 676c 650a d with a single. │ │ │ │ │ +00018940: 2020 2020 2063 6f70 792e 2020 4966 2074 copy. If t │ │ │ │ │ +00018950: 6865 7265 2061 7265 206d 756c 7469 706c here are multipl │ │ │ │ │ +00018960: 6520 496e 7661 7269 616e 7420 5365 6374 e Invariant Sect │ │ │ │ │ +00018970: 696f 6e73 2077 6974 6820 7468 6520 7361 ions with the sa │ │ │ │ │ +00018980: 6d65 206e 616d 650a 2020 2020 2062 7574 me name. but │ │ │ │ │ +00018990: 2064 6966 6665 7265 6e74 2063 6f6e 7465 different conte │ │ │ │ │ +000189a0: 6e74 732c 206d 616b 6520 7468 6520 7469 nts, make the ti │ │ │ │ │ +000189b0: 746c 6520 6f66 2065 6163 6820 7375 6368 tle of each such │ │ │ │ │ +000189c0: 2073 6563 7469 6f6e 2075 6e69 7175 650a section unique. │ │ │ │ │ +000189d0: 2020 2020 2062 7920 6164 6469 6e67 2061 by adding a │ │ │ │ │ +000189e0: 7420 7468 6520 656e 6420 6f66 2069 742c t the end of it, │ │ │ │ │ +000189f0: 2069 6e20 7061 7265 6e74 6865 7365 732c in parentheses, │ │ │ │ │ +00018a00: 2074 6865 206e 616d 6520 6f66 2074 6865 the name of the │ │ │ │ │ +00018a10: 0a20 2020 2020 6f72 6967 696e 616c 2061 . original a │ │ │ │ │ +00018a20: 7574 686f 7220 6f72 2070 7562 6c69 7368 uthor or publish │ │ │ │ │ +00018a30: 6572 206f 6620 7468 6174 2073 6563 7469 er of that secti │ │ │ │ │ +00018a40: 6f6e 2069 6620 6b6e 6f77 6e2c 206f 7220 on if known, or │ │ │ │ │ +00018a50: 656c 7365 2061 0a20 2020 2020 756e 6971 else a. uniq │ │ │ │ │ +00018a60: 7565 206e 756d 6265 722e 2020 4d61 6b65 ue number. Make │ │ │ │ │ +00018a70: 2074 6865 2073 616d 6520 6164 6a75 7374 the same adjust │ │ │ │ │ +00018a80: 6d65 6e74 2074 6f20 7468 6520 7365 6374 ment to the sect │ │ │ │ │ +00018a90: 696f 6e20 7469 746c 6573 2069 6e0a 2020 ion titles in. │ │ │ │ │ +00018aa0: 2020 2074 6865 206c 6973 7420 6f66 2049 the list of I │ │ │ │ │ +00018ab0: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ +00018ac0: 7320 696e 2074 6865 206c 6963 656e 7365 s in the license │ │ │ │ │ +00018ad0: 206e 6f74 6963 6520 6f66 2074 6865 0a20 notice of the. │ │ │ │ │ +00018ae0: 2020 2020 636f 6d62 696e 6564 2077 6f72 combined wor │ │ │ │ │ +00018af0: 6b2e 0a0a 2020 2020 2049 6e20 7468 6520 k... In the │ │ │ │ │ +00018b00: 636f 6d62 696e 6174 696f 6e2c 2079 6f75 combination, you │ │ │ │ │ +00018b10: 206d 7573 7420 636f 6d62 696e 6520 616e must combine an │ │ │ │ │ +00018b20: 7920 7365 6374 696f 6e73 2045 6e74 6974 y sections Entit │ │ │ │ │ +00018b30: 6c65 640a 2020 2020 2022 4869 7374 6f72 led. "Histor │ │ │ │ │ +00018b40: 7922 2069 6e20 7468 6520 7661 7269 6f75 y" in the variou │ │ │ │ │ +00018b50: 7320 6f72 6967 696e 616c 2064 6f63 756d s original docum │ │ │ │ │ +00018b60: 656e 7473 2c20 666f 726d 696e 6720 6f6e ents, forming on │ │ │ │ │ +00018b70: 6520 7365 6374 696f 6e0a 2020 2020 2045 e section. E │ │ │ │ │ +00018b80: 6e74 6974 6c65 6420 2248 6973 746f 7279 ntitled "History │ │ │ │ │ +00018b90: 223b 206c 696b 6577 6973 6520 636f 6d62 "; likewise comb │ │ │ │ │ +00018ba0: 696e 6520 616e 7920 7365 6374 696f 6e73 ine any sections │ │ │ │ │ +00018bb0: 2045 6e74 6974 6c65 640a 2020 2020 2022 Entitled. " │ │ │ │ │ +00018bc0: 4163 6b6e 6f77 6c65 6467 656d 656e 7473 Acknowledgements │ │ │ │ │ +00018bd0: 222c 2061 6e64 2061 6e79 2073 6563 7469 ", and any secti │ │ │ │ │ +00018be0: 6f6e 7320 456e 7469 746c 6564 2022 4465 ons Entitled "De │ │ │ │ │ +00018bf0: 6469 6361 7469 6f6e 7322 2e20 2059 6f75 dications". You │ │ │ │ │ +00018c00: 0a20 2020 2020 6d75 7374 2064 656c 6574 . must delet │ │ │ │ │ +00018c10: 6520 616c 6c20 7365 6374 696f 6e73 2045 e all sections E │ │ │ │ │ +00018c20: 6e74 6974 6c65 6420 2245 6e64 6f72 7365 ntitled "Endorse │ │ │ │ │ +00018c30: 6d65 6e74 732e 220a 0a20 2036 2e20 434f ments.".. 6. CO │ │ │ │ │ +00018c40: 4c4c 4543 5449 4f4e 5320 4f46 2044 4f43 LLECTIONS OF DOC │ │ │ │ │ +00018c50: 554d 454e 5453 0a0a 2020 2020 2059 6f75 UMENTS.. You │ │ │ │ │ +00018c60: 206d 6179 206d 616b 6520 6120 636f 6c6c may make a coll │ │ │ │ │ +00018c70: 6563 7469 6f6e 2063 6f6e 7369 7374 696e ection consistin │ │ │ │ │ +00018c80: 6720 6f66 2074 6865 2044 6f63 756d 656e g of the Documen │ │ │ │ │ +00018c90: 7420 616e 6420 6f74 6865 720a 2020 2020 t and other. │ │ │ │ │ +00018ca0: 2064 6f63 756d 656e 7473 2072 656c 6561 documents relea │ │ │ │ │ +00018cb0: 7365 6420 756e 6465 7220 7468 6973 204c sed under this L │ │ │ │ │ +00018cc0: 6963 656e 7365 2c20 616e 6420 7265 706c icense, and repl │ │ │ │ │ +00018cd0: 6163 6520 7468 6520 696e 6469 7669 6475 ace the individu │ │ │ │ │ +00018ce0: 616c 0a20 2020 2020 636f 7069 6573 206f al. copies o │ │ │ │ │ +00018cf0: 6620 7468 6973 204c 6963 656e 7365 2069 f this License i │ │ │ │ │ +00018d00: 6e20 7468 6520 7661 7269 6f75 7320 646f n the various do │ │ │ │ │ +00018d10: 6375 6d65 6e74 7320 7769 7468 2061 2073 cuments with a s │ │ │ │ │ +00018d20: 696e 676c 6520 636f 7079 0a20 2020 2020 ingle copy. │ │ │ │ │ +00018d30: 7468 6174 2069 7320 696e 636c 7564 6564 that is included │ │ │ │ │ +00018d40: 2069 6e20 7468 6520 636f 6c6c 6563 7469 in the collecti │ │ │ │ │ +00018d50: 6f6e 2c20 7072 6f76 6964 6564 2074 6861 on, provided tha │ │ │ │ │ +00018d60: 7420 796f 7520 666f 6c6c 6f77 2074 6865 t you follow the │ │ │ │ │ +00018d70: 0a20 2020 2020 7275 6c65 7320 6f66 2074 . rules of t │ │ │ │ │ +00018d80: 6869 7320 4c69 6365 6e73 6520 666f 7220 his License for │ │ │ │ │ +00018d90: 7665 7262 6174 696d 2063 6f70 7969 6e67 verbatim copying │ │ │ │ │ +00018da0: 206f 6620 6561 6368 206f 6620 7468 6520 of each of the │ │ │ │ │ +00018db0: 646f 6375 6d65 6e74 730a 2020 2020 2069 documents. i │ │ │ │ │ +00018dc0: 6e20 616c 6c20 6f74 6865 7220 7265 7370 n all other resp │ │ │ │ │ +00018dd0: 6563 7473 2e0a 0a20 2020 2020 596f 7520 ects... You │ │ │ │ │ +00018de0: 6d61 7920 6578 7472 6163 7420 6120 7369 may extract a si │ │ │ │ │ +00018df0: 6e67 6c65 2064 6f63 756d 656e 7420 6672 ngle document fr │ │ │ │ │ +00018e00: 6f6d 2073 7563 6820 6120 636f 6c6c 6563 om such a collec │ │ │ │ │ +00018e10: 7469 6f6e 2c20 616e 640a 2020 2020 2064 tion, and. d │ │ │ │ │ +00018e20: 6973 7472 6962 7574 6520 6974 2069 6e64 istribute it ind │ │ │ │ │ +00018e30: 6976 6964 7561 6c6c 7920 756e 6465 7220 ividually under │ │ │ │ │ +00018e40: 7468 6973 204c 6963 656e 7365 2c20 7072 this License, pr │ │ │ │ │ +00018e50: 6f76 6964 6564 2079 6f75 2069 6e73 6572 ovided you inser │ │ │ │ │ +00018e60: 740a 2020 2020 2061 2063 6f70 7920 6f66 t. a copy of │ │ │ │ │ +00018e70: 2074 6869 7320 4c69 6365 6e73 6520 696e this License in │ │ │ │ │ +00018e80: 746f 2074 6865 2065 7874 7261 6374 6564 to the extracted │ │ │ │ │ +00018e90: 2064 6f63 756d 656e 742c 2061 6e64 2066 document, and f │ │ │ │ │ +00018ea0: 6f6c 6c6f 7720 7468 6973 0a20 2020 2020 ollow this. │ │ │ │ │ +00018eb0: 4c69 6365 6e73 6520 696e 2061 6c6c 206f License in all o │ │ │ │ │ +00018ec0: 7468 6572 2072 6573 7065 6374 7320 7265 ther respects re │ │ │ │ │ +00018ed0: 6761 7264 696e 6720 7665 7262 6174 696d garding verbatim │ │ │ │ │ +00018ee0: 2063 6f70 7969 6e67 206f 6620 7468 6174 copying of that │ │ │ │ │ +00018ef0: 0a20 2020 2020 646f 6375 6d65 6e74 2e0a . document.. │ │ │ │ │ +00018f00: 0a20 2037 2e20 4147 4752 4547 4154 494f . 7. AGGREGATIO │ │ │ │ │ +00018f10: 4e20 5749 5448 2049 4e44 4550 454e 4445 N WITH INDEPENDE │ │ │ │ │ +00018f20: 4e54 2057 4f52 4b53 0a0a 2020 2020 2041 NT WORKS.. A │ │ │ │ │ +00018f30: 2063 6f6d 7069 6c61 7469 6f6e 206f 6620 compilation of │ │ │ │ │ +00018f40: 7468 6520 446f 6375 6d65 6e74 206f 7220 the Document or │ │ │ │ │ +00018f50: 6974 7320 6465 7269 7661 7469 7665 7320 its derivatives │ │ │ │ │ +00018f60: 7769 7468 206f 7468 6572 0a20 2020 2020 with other. │ │ │ │ │ +00018f70: 7365 7061 7261 7465 2061 6e64 2069 6e64 separate and ind │ │ │ │ │ +00018f80: 6570 656e 6465 6e74 2064 6f63 756d 656e ependent documen │ │ │ │ │ +00018f90: 7473 206f 7220 776f 726b 732c 2069 6e20 ts or works, in │ │ │ │ │ +00018fa0: 6f72 206f 6e20 6120 766f 6c75 6d65 206f or on a volume o │ │ │ │ │ +00018fb0: 6620 610a 2020 2020 2073 746f 7261 6765 f a. storage │ │ │ │ │ +00018fc0: 206f 7220 6469 7374 7269 6275 7469 6f6e or distribution │ │ │ │ │ +00018fd0: 206d 6564 6975 6d2c 2069 7320 6361 6c6c medium, is call │ │ │ │ │ +00018fe0: 6564 2061 6e20 2261 6767 7265 6761 7465 ed an "aggregate │ │ │ │ │ +00018ff0: 2220 6966 2074 6865 0a20 2020 2020 636f " if the. co │ │ │ │ │ +00019000: 7079 7269 6768 7420 7265 7375 6c74 696e pyright resultin │ │ │ │ │ +00019010: 6720 6672 6f6d 2074 6865 2063 6f6d 7069 g from the compi │ │ │ │ │ +00019020: 6c61 7469 6f6e 2069 7320 6e6f 7420 7573 lation is not us │ │ │ │ │ +00019030: 6564 2074 6f20 6c69 6d69 7420 7468 650a ed to limit the. │ │ │ │ │ +00019040: 2020 2020 206c 6567 616c 2072 6967 6874 legal right │ │ │ │ │ +00019050: 7320 6f66 2074 6865 2063 6f6d 7069 6c61 s of the compila │ │ │ │ │ +00019060: 7469 6f6e 2773 2075 7365 7273 2062 6579 tion's users bey │ │ │ │ │ +00019070: 6f6e 6420 7768 6174 2074 6865 2069 6e64 ond what the ind │ │ │ │ │ +00019080: 6976 6964 7561 6c0a 2020 2020 2077 6f72 ividual. wor │ │ │ │ │ +00019090: 6b73 2070 6572 6d69 742e 2020 5768 656e ks permit. When │ │ │ │ │ +000190a0: 2074 6865 2044 6f63 756d 656e 7420 6973 the Document is │ │ │ │ │ +000190b0: 2069 6e63 6c75 6465 6420 696e 2061 6e20 included in an │ │ │ │ │ +000190c0: 6167 6772 6567 6174 652c 2074 6869 730a aggregate, this. │ │ │ │ │ +000190d0: 2020 2020 204c 6963 656e 7365 2064 6f65 License doe │ │ │ │ │ +000190e0: 7320 6e6f 7420 6170 706c 7920 746f 2074 s not apply to t │ │ │ │ │ +000190f0: 6865 206f 7468 6572 2077 6f72 6b73 2069 he other works i │ │ │ │ │ +00019100: 6e20 7468 6520 6167 6772 6567 6174 6520 n the aggregate │ │ │ │ │ +00019110: 7768 6963 680a 2020 2020 2061 7265 206e which. are n │ │ │ │ │ +00019120: 6f74 2074 6865 6d73 656c 7665 7320 6465 ot themselves de │ │ │ │ │ +00019130: 7269 7661 7469 7665 2077 6f72 6b73 206f rivative works o │ │ │ │ │ +00019140: 6620 7468 6520 446f 6375 6d65 6e74 2e0a f the Document.. │ │ │ │ │ +00019150: 0a20 2020 2020 4966 2074 6865 2043 6f76 . If the Cov │ │ │ │ │ +00019160: 6572 2054 6578 7420 7265 7175 6972 656d er Text requirem │ │ │ │ │ +00019170: 656e 7420 6f66 2073 6563 7469 6f6e 2033 ent of section 3 │ │ │ │ │ +00019180: 2069 7320 6170 706c 6963 6162 6c65 2074 is applicable t │ │ │ │ │ +00019190: 6f20 7468 6573 650a 2020 2020 2063 6f70 o these. cop │ │ │ │ │ +000191a0: 6965 7320 6f66 2074 6865 2044 6f63 756d ies of the Docum │ │ │ │ │ +000191b0: 656e 742c 2074 6865 6e20 6966 2074 6865 ent, then if the │ │ │ │ │ +000191c0: 2044 6f63 756d 656e 7420 6973 206c 6573 Document is les │ │ │ │ │ +000191d0: 7320 7468 616e 206f 6e65 2068 616c 660a s than one half. │ │ │ │ │ +000191e0: 2020 2020 206f 6620 7468 6520 656e 7469 of the enti │ │ │ │ │ +000191f0: 7265 2061 6767 7265 6761 7465 2c20 7468 re aggregate, th │ │ │ │ │ +00019200: 6520 446f 6375 6d65 6e74 2773 2043 6f76 e Document's Cov │ │ │ │ │ +00019210: 6572 2054 6578 7473 206d 6179 2062 6520 er Texts may be │ │ │ │ │ +00019220: 706c 6163 6564 0a20 2020 2020 6f6e 2063 placed. on c │ │ │ │ │ +00019230: 6f76 6572 7320 7468 6174 2062 7261 636b overs that brack │ │ │ │ │ +00019240: 6574 2074 6865 2044 6f63 756d 656e 7420 et the Document │ │ │ │ │ +00019250: 7769 7468 696e 2074 6865 2061 6767 7265 within the aggre │ │ │ │ │ +00019260: 6761 7465 2c20 6f72 2074 6865 0a20 2020 gate, or the. │ │ │ │ │ +00019270: 2020 656c 6563 7472 6f6e 6963 2065 7175 electronic equ │ │ │ │ │ +00019280: 6976 616c 656e 7420 6f66 2063 6f76 6572 ivalent of cover │ │ │ │ │ +00019290: 7320 6966 2074 6865 2044 6f63 756d 656e s if the Documen │ │ │ │ │ +000192a0: 7420 6973 2069 6e20 656c 6563 7472 6f6e t is in electron │ │ │ │ │ +000192b0: 6963 0a20 2020 2020 666f 726d 2e20 204f ic. form. O │ │ │ │ │ +000192c0: 7468 6572 7769 7365 2074 6865 7920 6d75 therwise they mu │ │ │ │ │ +000192d0: 7374 2061 7070 6561 7220 6f6e 2070 7269 st appear on pri │ │ │ │ │ +000192e0: 6e74 6564 2063 6f76 6572 7320 7468 6174 nted covers that │ │ │ │ │ +000192f0: 2062 7261 636b 6574 0a20 2020 2020 7468 bracket. th │ │ │ │ │ +00019300: 6520 7768 6f6c 6520 6167 6772 6567 6174 e whole aggregat │ │ │ │ │ +00019310: 652e 0a0a 2020 382e 2054 5241 4e53 4c41 e... 8. TRANSLA │ │ │ │ │ +00019320: 5449 4f4e 0a0a 2020 2020 2054 7261 6e73 TION.. Trans │ │ │ │ │ +00019330: 6c61 7469 6f6e 2069 7320 636f 6e73 6964 lation is consid │ │ │ │ │ +00019340: 6572 6564 2061 206b 696e 6420 6f66 206d ered a kind of m │ │ │ │ │ +00019350: 6f64 6966 6963 6174 696f 6e2c 2073 6f20 odification, so │ │ │ │ │ +00019360: 796f 7520 6d61 790a 2020 2020 2064 6973 you may. dis │ │ │ │ │ +00019370: 7472 6962 7574 6520 7472 616e 736c 6174 tribute translat │ │ │ │ │ +00019380: 696f 6e73 206f 6620 7468 6520 446f 6375 ions of the Docu │ │ │ │ │ +00019390: 6d65 6e74 2075 6e64 6572 2074 6865 2074 ment under the t │ │ │ │ │ +000193a0: 6572 6d73 206f 6620 7365 6374 696f 6e0a erms of section. │ │ │ │ │ +000193b0: 2020 2020 2034 2e20 2052 6570 6c61 6369 4. Replaci │ │ │ │ │ +000193c0: 6e67 2049 6e76 6172 6961 6e74 2053 6563 ng Invariant Sec │ │ │ │ │ +000193d0: 7469 6f6e 7320 7769 7468 2074 7261 6e73 tions with trans │ │ │ │ │ +000193e0: 6c61 7469 6f6e 7320 7265 7175 6972 6573 lations requires │ │ │ │ │ +000193f0: 2073 7065 6369 616c 0a20 2020 2020 7065 special. pe │ │ │ │ │ +00019400: 726d 6973 7369 6f6e 2066 726f 6d20 7468 rmission from th │ │ │ │ │ +00019410: 6569 7220 636f 7079 7269 6768 7420 686f eir copyright ho │ │ │ │ │ +00019420: 6c64 6572 732c 2062 7574 2079 6f75 206d lders, but you m │ │ │ │ │ +00019430: 6179 2069 6e63 6c75 6465 0a20 2020 2020 ay include. │ │ │ │ │ +00019440: 7472 616e 736c 6174 696f 6e73 206f 6620 translations of │ │ │ │ │ +00019450: 736f 6d65 206f 7220 616c 6c20 496e 7661 some or all Inva │ │ │ │ │ +00019460: 7269 616e 7420 5365 6374 696f 6e73 2069 riant Sections i │ │ │ │ │ +00019470: 6e20 6164 6469 7469 6f6e 2074 6f20 7468 n addition to th │ │ │ │ │ +00019480: 650a 2020 2020 206f 7269 6769 6e61 6c20 e. original │ │ │ │ │ +00019490: 7665 7273 696f 6e73 206f 6620 7468 6573 versions of thes │ │ │ │ │ +000194a0: 6520 496e 7661 7269 616e 7420 5365 6374 e Invariant Sect │ │ │ │ │ +000194b0: 696f 6e73 2e20 2059 6f75 206d 6179 2069 ions. You may i │ │ │ │ │ +000194c0: 6e63 6c75 6465 2061 0a20 2020 2020 7472 nclude a. tr │ │ │ │ │ +000194d0: 616e 736c 6174 696f 6e20 6f66 2074 6869 anslation of thi │ │ │ │ │ +000194e0: 7320 4c69 6365 6e73 652c 2061 6e64 2061 s License, and a │ │ │ │ │ +000194f0: 6c6c 2074 6865 206c 6963 656e 7365 206e ll the license n │ │ │ │ │ +00019500: 6f74 6963 6573 2069 6e20 7468 650a 2020 otices in the. │ │ │ │ │ +00019510: 2020 2044 6f63 756d 656e 742c 2061 6e64 Document, and │ │ │ │ │ +00019520: 2061 6e79 2057 6172 7261 6e74 7920 4469 any Warranty Di │ │ │ │ │ +00019530: 7363 6c61 696d 6572 732c 2070 726f 7669 sclaimers, provi │ │ │ │ │ +00019540: 6465 6420 7468 6174 2079 6f75 2061 6c73 ded that you als │ │ │ │ │ +00019550: 6f0a 2020 2020 2069 6e63 6c75 6465 2074 o. include t │ │ │ │ │ +00019560: 6865 206f 7269 6769 6e61 6c20 456e 676c he original Engl │ │ │ │ │ +00019570: 6973 6820 7665 7273 696f 6e20 6f66 2074 ish version of t │ │ │ │ │ +00019580: 6869 7320 4c69 6365 6e73 6520 616e 6420 his License and │ │ │ │ │ +00019590: 7468 650a 2020 2020 206f 7269 6769 6e61 the. origina │ │ │ │ │ +000195a0: 6c20 7665 7273 696f 6e73 206f 6620 7468 l versions of th │ │ │ │ │ +000195b0: 6f73 6520 6e6f 7469 6365 7320 616e 6420 ose notices and │ │ │ │ │ +000195c0: 6469 7363 6c61 696d 6572 732e 2020 496e disclaimers. In │ │ │ │ │ +000195d0: 2063 6173 6520 6f66 2061 0a20 2020 2020 case of a. │ │ │ │ │ +000195e0: 6469 7361 6772 6565 6d65 6e74 2062 6574 disagreement bet │ │ │ │ │ +000195f0: 7765 656e 2074 6865 2074 7261 6e73 6c61 ween the transla │ │ │ │ │ +00019600: 7469 6f6e 2061 6e64 2074 6865 206f 7269 tion and the ori │ │ │ │ │ +00019610: 6769 6e61 6c20 7665 7273 696f 6e20 6f66 ginal version of │ │ │ │ │ +00019620: 0a20 2020 2020 7468 6973 204c 6963 656e . this Licen │ │ │ │ │ +00019630: 7365 206f 7220 6120 6e6f 7469 6365 206f se or a notice o │ │ │ │ │ +00019640: 7220 6469 7363 6c61 696d 6572 2c20 7468 r disclaimer, th │ │ │ │ │ +00019650: 6520 6f72 6967 696e 616c 2076 6572 7369 e original versi │ │ │ │ │ +00019660: 6f6e 2077 696c 6c0a 2020 2020 2070 7265 on will. pre │ │ │ │ │ +00019670: 7661 696c 2e0a 0a20 2020 2020 4966 2061 vail... If a │ │ │ │ │ +00019680: 2073 6563 7469 6f6e 2069 6e20 7468 6520 section in the │ │ │ │ │ +00019690: 446f 6375 6d65 6e74 2069 7320 456e 7469 Document is Enti │ │ │ │ │ +000196a0: 746c 6564 2022 4163 6b6e 6f77 6c65 6467 tled "Acknowledg │ │ │ │ │ +000196b0: 656d 656e 7473 222c 0a20 2020 2020 2244 ements",. "D │ │ │ │ │ +000196c0: 6564 6963 6174 696f 6e73 222c 206f 7220 edications", or │ │ │ │ │ +000196d0: 2248 6973 746f 7279 222c 2074 6865 2072 "History", the r │ │ │ │ │ +000196e0: 6571 7569 7265 6d65 6e74 2028 7365 6374 equirement (sect │ │ │ │ │ +000196f0: 696f 6e20 3429 2074 6f0a 2020 2020 2050 ion 4) to. P │ │ │ │ │ +00019700: 7265 7365 7276 6520 6974 7320 5469 746c reserve its Titl │ │ │ │ │ +00019710: 6520 2873 6563 7469 6f6e 2031 2920 7769 e (section 1) wi │ │ │ │ │ +00019720: 6c6c 2074 7970 6963 616c 6c79 2072 6571 ll typically req │ │ │ │ │ +00019730: 7569 7265 2063 6861 6e67 696e 6720 7468 uire changing th │ │ │ │ │ +00019740: 650a 2020 2020 2061 6374 7561 6c20 7469 e. actual ti │ │ │ │ │ +00019750: 746c 652e 0a0a 2020 392e 2054 4552 4d49 tle... 9. TERMI │ │ │ │ │ +00019760: 4e41 5449 4f4e 0a0a 2020 2020 2059 6f75 NATION.. You │ │ │ │ │ +00019770: 206d 6179 206e 6f74 2063 6f70 792c 206d may not copy, m │ │ │ │ │ +00019780: 6f64 6966 792c 2073 7562 6c69 6365 6e73 odify, sublicens │ │ │ │ │ +00019790: 652c 206f 7220 6469 7374 7269 6275 7465 e, or distribute │ │ │ │ │ +000197a0: 2074 6865 2044 6f63 756d 656e 740a 2020 the Document. │ │ │ │ │ +000197b0: 2020 2065 7863 6570 7420 6173 2065 7870 except as exp │ │ │ │ │ +000197c0: 7265 7373 6c79 2070 726f 7669 6465 6420 ressly provided │ │ │ │ │ +000197d0: 666f 7220 756e 6465 7220 7468 6973 204c for under this L │ │ │ │ │ +000197e0: 6963 656e 7365 2e20 2041 6e79 206f 7468 icense. Any oth │ │ │ │ │ +000197f0: 6572 0a20 2020 2020 6174 7465 6d70 7420 er. attempt │ │ │ │ │ +00019800: 746f 2063 6f70 792c 206d 6f64 6966 792c to copy, modify, │ │ │ │ │ +00019810: 2073 7562 6c69 6365 6e73 6520 6f72 2064 sublicense or d │ │ │ │ │ +00019820: 6973 7472 6962 7574 6520 7468 6520 446f istribute the Do │ │ │ │ │ +00019830: 6375 6d65 6e74 2069 730a 2020 2020 2076 cument is. v │ │ │ │ │ +00019840: 6f69 642c 2061 6e64 2077 696c 6c20 6175 oid, and will au │ │ │ │ │ +00019850: 746f 6d61 7469 6361 6c6c 7920 7465 726d tomatically term │ │ │ │ │ +00019860: 696e 6174 6520 796f 7572 2072 6967 6874 inate your right │ │ │ │ │ +00019870: 7320 756e 6465 7220 7468 6973 0a20 2020 s under this. │ │ │ │ │ +00019880: 2020 4c69 6365 6e73 652e 2020 486f 7765 License. Howe │ │ │ │ │ +00019890: 7665 722c 2070 6172 7469 6573 2077 686f ver, parties who │ │ │ │ │ +000198a0: 2068 6176 6520 7265 6365 6976 6564 2063 have received c │ │ │ │ │ +000198b0: 6f70 6965 732c 206f 7220 7269 6768 7473 opies, or rights │ │ │ │ │ +000198c0: 2c0a 2020 2020 2066 726f 6d20 796f 7520 ,. from you │ │ │ │ │ +000198d0: 756e 6465 7220 7468 6973 204c 6963 656e under this Licen │ │ │ │ │ +000198e0: 7365 2077 696c 6c20 6e6f 7420 6861 7665 se will not have │ │ │ │ │ +000198f0: 2074 6865 6972 206c 6963 656e 7365 7320 their licenses │ │ │ │ │ +00019900: 7465 726d 696e 6174 6564 0a20 2020 2020 terminated. │ │ │ │ │ +00019910: 736f 206c 6f6e 6720 6173 2073 7563 6820 so long as such │ │ │ │ │ +00019920: 7061 7274 6965 7320 7265 6d61 696e 2069 parties remain i │ │ │ │ │ +00019930: 6e20 6675 6c6c 2063 6f6d 706c 6961 6e63 n full complianc │ │ │ │ │ +00019940: 652e 0a0a 2020 3130 2e20 4655 5455 5245 e... 10. FUTURE │ │ │ │ │ +00019950: 2052 4556 4953 494f 4e53 204f 4620 5448 REVISIONS OF TH │ │ │ │ │ +00019960: 4953 204c 4943 454e 5345 0a0a 2020 2020 IS LICENSE.. │ │ │ │ │ +00019970: 2054 6865 2046 7265 6520 536f 6674 7761 The Free Softwa │ │ │ │ │ +00019980: 7265 2046 6f75 6e64 6174 696f 6e20 6d61 re Foundation ma │ │ │ │ │ +00019990: 7920 7075 626c 6973 6820 6e65 772c 2072 y publish new, r │ │ │ │ │ +000199a0: 6576 6973 6564 2076 6572 7369 6f6e 7320 evised versions │ │ │ │ │ +000199b0: 6f66 0a20 2020 2020 7468 6520 474e 5520 of. the GNU │ │ │ │ │ +000199c0: 4672 6565 2044 6f63 756d 656e 7461 7469 Free Documentati │ │ │ │ │ +000199d0: 6f6e 204c 6963 656e 7365 2066 726f 6d20 on License from │ │ │ │ │ +000199e0: 7469 6d65 2074 6f20 7469 6d65 2e20 2053 time to time. S │ │ │ │ │ +000199f0: 7563 6820 6e65 770a 2020 2020 2076 6572 uch new. ver │ │ │ │ │ +00019a00: 7369 6f6e 7320 7769 6c6c 2062 6520 7369 sions will be si │ │ │ │ │ +00019a10: 6d69 6c61 7220 696e 2073 7069 7269 7420 milar in spirit │ │ │ │ │ +00019a20: 746f 2074 6865 2070 7265 7365 6e74 2076 to the present v │ │ │ │ │ +00019a30: 6572 7369 6f6e 2c20 6275 7420 6d61 790a ersion, but may. │ │ │ │ │ +00019a40: 2020 2020 2064 6966 6665 7220 696e 2064 differ in d │ │ │ │ │ +00019a50: 6574 6169 6c20 746f 2061 6464 7265 7373 etail to address │ │ │ │ │ +00019a60: 206e 6577 2070 726f 626c 656d 7320 6f72 new problems or │ │ │ │ │ +00019a70: 2063 6f6e 6365 726e 732e 2020 5365 650a concerns. See. │ │ │ │ │ +00019a80: 2020 2020 203c 6874 7470 3a2f 2f77 7777 ... Each │ │ │ │ │ +00019ab0: 7665 7273 696f 6e20 6f66 2074 6865 204c version of the L │ │ │ │ │ +00019ac0: 6963 656e 7365 2069 7320 6769 7665 6e20 icense is given │ │ │ │ │ +00019ad0: 6120 6469 7374 696e 6775 6973 6869 6e67 a distinguishing │ │ │ │ │ +00019ae0: 2076 6572 7369 6f6e 0a20 2020 2020 6e75 version. nu │ │ │ │ │ +00019af0: 6d62 6572 2e20 2049 6620 7468 6520 446f mber. If the Do │ │ │ │ │ +00019b00: 6375 6d65 6e74 2073 7065 6369 6669 6573 cument specifies │ │ │ │ │ +00019b10: 2074 6861 7420 6120 7061 7274 6963 756c that a particul │ │ │ │ │ +00019b20: 6172 206e 756d 6265 7265 640a 2020 2020 ar numbered. │ │ │ │ │ +00019b30: 2076 6572 7369 6f6e 206f 6620 7468 6973 version of this │ │ │ │ │ +00019b40: 204c 6963 656e 7365 2022 6f72 2061 6e79 License "or any │ │ │ │ │ +00019b50: 206c 6174 6572 2076 6572 7369 6f6e 2220 later version" │ │ │ │ │ +00019b60: 6170 706c 6965 7320 746f 2069 742c 2079 applies to it, y │ │ │ │ │ +00019b70: 6f75 0a20 2020 2020 6861 7665 2074 6865 ou. have the │ │ │ │ │ +00019b80: 206f 7074 696f 6e20 6f66 2066 6f6c 6c6f option of follo │ │ │ │ │ +00019b90: 7769 6e67 2074 6865 2074 6572 6d73 2061 wing the terms a │ │ │ │ │ +00019ba0: 6e64 2063 6f6e 6469 7469 6f6e 7320 6569 nd conditions ei │ │ │ │ │ +00019bb0: 7468 6572 206f 660a 2020 2020 2074 6861 ther of. tha │ │ │ │ │ +00019bc0: 7420 7370 6563 6966 6965 6420 7665 7273 t specified vers │ │ │ │ │ +00019bd0: 696f 6e20 6f72 206f 6620 616e 7920 6c61 ion or of any la │ │ │ │ │ +00019be0: 7465 7220 7665 7273 696f 6e20 7468 6174 ter version that │ │ │ │ │ +00019bf0: 2068 6173 2062 6565 6e0a 2020 2020 2070 has been. p │ │ │ │ │ +00019c00: 7562 6c69 7368 6564 2028 6e6f 7420 6173 ublished (not as │ │ │ │ │ +00019c10: 2061 2064 7261 6674 2920 6279 2074 6865 a draft) by the │ │ │ │ │ +00019c20: 2046 7265 6520 536f 6674 7761 7265 2046 Free Software F │ │ │ │ │ +00019c30: 6f75 6e64 6174 696f 6e2e 2020 4966 2074 oundation. If t │ │ │ │ │ +00019c40: 6865 0a20 2020 2020 446f 6375 6d65 6e74 he. Document │ │ │ │ │ +00019c50: 2064 6f65 7320 6e6f 7420 7370 6563 6966 does not specif │ │ │ │ │ +00019c60: 7920 6120 7665 7273 696f 6e20 6e75 6d62 y a version numb │ │ │ │ │ +00019c70: 6572 206f 6620 7468 6973 204c 6963 656e er of this Licen │ │ │ │ │ +00019c80: 7365 2c20 796f 7520 6d61 790a 2020 2020 se, you may. │ │ │ │ │ +00019c90: 2063 686f 6f73 6520 616e 7920 7665 7273 choose any vers │ │ │ │ │ +00019ca0: 696f 6e20 6576 6572 2070 7562 6c69 7368 ion ever publish │ │ │ │ │ +00019cb0: 6564 2028 6e6f 7420 6173 2061 2064 7261 ed (not as a dra │ │ │ │ │ +00019cc0: 6674 2920 6279 2074 6865 2046 7265 650a ft) by the Free. │ │ │ │ │ +00019cd0: 2020 2020 2053 6f66 7477 6172 6520 466f Software Fo │ │ │ │ │ +00019ce0: 756e 6461 7469 6f6e 2e0a 0a41 2e31 2e31 undation...A.1.1 │ │ │ │ │ +00019cf0: 2041 4444 454e 4455 4d3a 2048 6f77 2074 ADDENDUM: How t │ │ │ │ │ +00019d00: 6f20 7573 6520 7468 6973 204c 6963 656e o use this Licen │ │ │ │ │ +00019d10: 7365 2066 6f72 2079 6f75 7220 646f 6375 se for your docu │ │ │ │ │ +00019d20: 6d65 6e74 730a 2d2d 2d2d 2d2d 2d2d 2d2d ments.---------- │ │ │ │ │ 00019d30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00019d40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00019d50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -00019d60: 546f 2075 7365 2074 6869 7320 4c69 6365 To use this Lice │ │ │ │ │ -00019d70: 6e73 6520 696e 2061 2064 6f63 756d 656e nse in a documen │ │ │ │ │ -00019d80: 7420 796f 7520 6861 7665 2077 7269 7474 t you have writt │ │ │ │ │ -00019d90: 656e 2c20 696e 636c 7564 6520 6120 636f en, include a co │ │ │ │ │ -00019da0: 7079 206f 660a 7468 6520 4c69 6365 6e73 py of.the Licens │ │ │ │ │ -00019db0: 6520 696e 2074 6865 2064 6f63 756d 656e e in the documen │ │ │ │ │ -00019dc0: 7420 616e 6420 7075 7420 7468 6520 666f t and put the fo │ │ │ │ │ -00019dd0: 6c6c 6f77 696e 6720 636f 7079 7269 6768 llowing copyrigh │ │ │ │ │ -00019de0: 7420 616e 6420 6c69 6365 6e73 650a 6e6f t and license.no │ │ │ │ │ -00019df0: 7469 6365 7320 6a75 7374 2061 6674 6572 tices just after │ │ │ │ │ -00019e00: 2074 6865 2074 6974 6c65 2070 6167 653a the title page: │ │ │ │ │ -00019e10: 0a0a 2020 2020 2020 2043 6f70 7972 6967 .. Copyrig │ │ │ │ │ -00019e20: 6874 2028 4329 2020 5945 4152 2020 594f ht (C) YEAR YO │ │ │ │ │ -00019e30: 5552 204e 414d 452e 0a20 2020 2020 2020 UR NAME.. │ │ │ │ │ -00019e40: 5065 726d 6973 7369 6f6e 2069 7320 6772 Permission is gr │ │ │ │ │ -00019e50: 616e 7465 6420 746f 2063 6f70 792c 2064 anted to copy, d │ │ │ │ │ -00019e60: 6973 7472 6962 7574 6520 616e 642f 6f72 istribute and/or │ │ │ │ │ -00019e70: 206d 6f64 6966 7920 7468 6973 2064 6f63 modify this doc │ │ │ │ │ -00019e80: 756d 656e 740a 2020 2020 2020 2075 6e64 ument. und │ │ │ │ │ -00019e90: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ -00019ea0: 7468 6520 474e 5520 4672 6565 2044 6f63 the GNU Free Doc │ │ │ │ │ -00019eb0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ -00019ec0: 7365 2c20 5665 7273 696f 6e20 312e 320a se, Version 1.2. │ │ │ │ │ -00019ed0: 2020 2020 2020 206f 7220 616e 7920 6c61 or any la │ │ │ │ │ -00019ee0: 7465 7220 7665 7273 696f 6e20 7075 626c ter version publ │ │ │ │ │ -00019ef0: 6973 6865 6420 6279 2074 6865 2046 7265 ished by the Fre │ │ │ │ │ -00019f00: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ │ │ -00019f10: 6174 696f 6e3b 0a20 2020 2020 2020 7769 ation;. wi │ │ │ │ │ -00019f20: 7468 206e 6f20 496e 7661 7269 616e 7420 th no Invariant │ │ │ │ │ -00019f30: 5365 6374 696f 6e73 2c20 6e6f 2046 726f Sections, no Fro │ │ │ │ │ -00019f40: 6e74 2d43 6f76 6572 2054 6578 7473 2c20 nt-Cover Texts, │ │ │ │ │ -00019f50: 616e 6420 6e6f 2042 6163 6b2d 436f 7665 and no Back-Cove │ │ │ │ │ -00019f60: 720a 2020 2020 2020 2054 6578 7473 2e20 r. Texts. │ │ │ │ │ -00019f70: 2041 2063 6f70 7920 6f66 2074 6865 206c A copy of the l │ │ │ │ │ -00019f80: 6963 656e 7365 2069 7320 696e 636c 7564 icense is includ │ │ │ │ │ -00019f90: 6564 2069 6e20 7468 6520 7365 6374 696f ed in the sectio │ │ │ │ │ -00019fa0: 6e20 656e 7469 746c 6564 2060 6047 4e55 n entitled ``GNU │ │ │ │ │ -00019fb0: 0a20 2020 2020 2020 4672 6565 2044 6f63 . Free Doc │ │ │ │ │ -00019fc0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ -00019fd0: 7365 2727 2e0a 0a20 2020 4966 2079 6f75 se''... If you │ │ │ │ │ -00019fe0: 2068 6176 6520 496e 7661 7269 616e 7420 have Invariant │ │ │ │ │ -00019ff0: 5365 6374 696f 6e73 2c20 4672 6f6e 742d Sections, Front- │ │ │ │ │ -0001a000: 436f 7665 7220 5465 7874 7320 616e 6420 Cover Texts and │ │ │ │ │ -0001a010: 4261 636b 2d43 6f76 6572 0a54 6578 7473 Back-Cover.Texts │ │ │ │ │ -0001a020: 2c20 7265 706c 6163 6520 7468 6520 2277 , replace the "w │ │ │ │ │ -0001a030: 6974 682e 2e2e 5465 7874 732e 2220 206c ith...Texts." l │ │ │ │ │ -0001a040: 696e 6520 7769 7468 2074 6869 733a 0a0a ine with this:.. │ │ │ │ │ -0001a050: 2020 2020 2020 2020 2077 6974 6820 7468 with th │ │ │ │ │ -0001a060: 6520 496e 7661 7269 616e 7420 5365 6374 e Invariant Sect │ │ │ │ │ -0001a070: 696f 6e73 2062 6569 6e67 204c 4953 5420 ions being LIST │ │ │ │ │ -0001a080: 5448 4549 5220 5449 544c 4553 2c20 7769 THEIR TITLES, wi │ │ │ │ │ -0001a090: 7468 0a20 2020 2020 2020 2020 7468 6520 th. the │ │ │ │ │ -0001a0a0: 4672 6f6e 742d 436f 7665 7220 5465 7874 Front-Cover Text │ │ │ │ │ -0001a0b0: 7320 6265 696e 6720 4c49 5354 2c20 616e s being LIST, an │ │ │ │ │ -0001a0c0: 6420 7769 7468 2074 6865 2042 6163 6b2d d with the Back- │ │ │ │ │ -0001a0d0: 436f 7665 7220 5465 7874 730a 2020 2020 Cover Texts. │ │ │ │ │ -0001a0e0: 2020 2020 2062 6569 6e67 204c 4953 542e being LIST. │ │ │ │ │ -0001a0f0: 0a0a 2020 2049 6620 796f 7520 6861 7665 .. If you have │ │ │ │ │ -0001a100: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ -0001a110: 6f6e 7320 7769 7468 6f75 7420 436f 7665 ons without Cove │ │ │ │ │ -0001a120: 7220 5465 7874 732c 206f 7220 736f 6d65 r Texts, or some │ │ │ │ │ -0001a130: 206f 7468 6572 0a63 6f6d 6269 6e61 7469 other.combinati │ │ │ │ │ -0001a140: 6f6e 206f 6620 7468 6520 7468 7265 652c on of the three, │ │ │ │ │ -0001a150: 206d 6572 6765 2074 686f 7365 2074 776f merge those two │ │ │ │ │ -0001a160: 2061 6c74 6572 6e61 7469 7665 7320 746f alternatives to │ │ │ │ │ -0001a170: 2073 7569 7420 7468 650a 7369 7475 6174 suit the.situat │ │ │ │ │ -0001a180: 696f 6e2e 0a0a 2020 2049 6620 796f 7572 ion... If your │ │ │ │ │ -0001a190: 2064 6f63 756d 656e 7420 636f 6e74 6169 document contai │ │ │ │ │ -0001a1a0: 6e73 206e 6f6e 7472 6976 6961 6c20 6578 ns nontrivial ex │ │ │ │ │ -0001a1b0: 616d 706c 6573 206f 6620 7072 6f67 7261 amples of progra │ │ │ │ │ -0001a1c0: 6d20 636f 6465 2c20 7765 0a72 6563 6f6d m code, we.recom │ │ │ │ │ -0001a1d0: 6d65 6e64 2072 656c 6561 7369 6e67 2074 mend releasing t │ │ │ │ │ -0001a1e0: 6865 7365 2065 7861 6d70 6c65 7320 696e hese examples in │ │ │ │ │ -0001a1f0: 2070 6172 616c 6c65 6c20 756e 6465 7220 parallel under │ │ │ │ │ -0001a200: 796f 7572 2063 686f 6963 6520 6f66 2066 your choice of f │ │ │ │ │ -0001a210: 7265 650a 736f 6674 7761 7265 206c 6963 ree.software lic │ │ │ │ │ -0001a220: 656e 7365 2c20 7375 6368 2061 7320 7468 ense, such as th │ │ │ │ │ -0001a230: 6520 474e 5520 4765 6e65 7261 6c20 5075 e GNU General Pu │ │ │ │ │ -0001a240: 626c 6963 204c 6963 656e 7365 2c20 746f blic License, to │ │ │ │ │ -0001a250: 2070 6572 6d69 740a 7468 6569 7220 7573 permit.their us │ │ │ │ │ -0001a260: 6520 696e 2066 7265 6520 736f 6674 7761 e in free softwa │ │ │ │ │ -0001a270: 7265 2e0a 0a1f 0a46 696c 653a 2067 7275 re.....File: gru │ │ │ │ │ -0001a280: 622d 6465 762e 696e 666f 2c20 204e 6f64 b-dev.info, Nod │ │ │ │ │ -0001a290: 653a 2049 6e64 6578 2c20 2050 7265 763a e: Index, Prev: │ │ │ │ │ -0001a2a0: 2043 6f70 7969 6e67 2054 6869 7320 4d61 Copying This Ma │ │ │ │ │ -0001a2b0: 6e75 616c 2c20 2055 703a 2054 6f70 0a0a nual, Up: Top.. │ │ │ │ │ -0001a2c0: 496e 6465 780a 2a2a 2a2a 2a0a 0a00 085b Index.*****....[ │ │ │ │ │ -0001a2d0: 696e 6465 7800 085d 0a2a 204d 656e 753a index..].* Menu: │ │ │ │ │ -0001a2e0: 0a0a 2a20 4644 4c2c 2047 4e55 2046 7265 ..* FDL, GNU Fre │ │ │ │ │ -0001a2f0: 6520 446f 6375 6d65 6e74 6174 696f 6e20 e Documentation │ │ │ │ │ -0001a300: 4c69 6365 6e73 653a 2020 2047 4e55 2046 License: GNU F │ │ │ │ │ -0001a310: 7265 6520 446f 6375 6d65 6e74 6174 696f ree Documentatio │ │ │ │ │ -0001a320: 6e20 4c69 6365 6e73 652e 0a20 2020 2020 n License.. │ │ │ │ │ +00019d50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00019d60: 0a0a 546f 2075 7365 2074 6869 7320 4c69 ..To use this Li │ │ │ │ │ +00019d70: 6365 6e73 6520 696e 2061 2064 6f63 756d cense in a docum │ │ │ │ │ +00019d80: 656e 7420 796f 7520 6861 7665 2077 7269 ent you have wri │ │ │ │ │ +00019d90: 7474 656e 2c20 696e 636c 7564 6520 6120 tten, include a │ │ │ │ │ +00019da0: 636f 7079 206f 660a 7468 6520 4c69 6365 copy of.the Lice │ │ │ │ │ +00019db0: 6e73 6520 696e 2074 6865 2064 6f63 756d nse in the docum │ │ │ │ │ +00019dc0: 656e 7420 616e 6420 7075 7420 7468 6520 ent and put the │ │ │ │ │ +00019dd0: 666f 6c6c 6f77 696e 6720 636f 7079 7269 following copyri │ │ │ │ │ +00019de0: 6768 7420 616e 6420 6c69 6365 6e73 650a ght and license. │ │ │ │ │ +00019df0: 6e6f 7469 6365 7320 6a75 7374 2061 6674 notices just aft │ │ │ │ │ +00019e00: 6572 2074 6865 2074 6974 6c65 2070 6167 er the title pag │ │ │ │ │ +00019e10: 653a 0a0a 2020 2020 2020 2043 6f70 7972 e:.. Copyr │ │ │ │ │ +00019e20: 6967 6874 2028 4329 2020 5945 4152 2020 ight (C) YEAR │ │ │ │ │ +00019e30: 594f 5552 204e 414d 452e 0a20 2020 2020 YOUR NAME.. │ │ │ │ │ +00019e40: 2020 5065 726d 6973 7369 6f6e 2069 7320 Permission is │ │ │ │ │ +00019e50: 6772 616e 7465 6420 746f 2063 6f70 792c granted to copy, │ │ │ │ │ +00019e60: 2064 6973 7472 6962 7574 6520 616e 642f distribute and/ │ │ │ │ │ +00019e70: 6f72 206d 6f64 6966 7920 7468 6973 2064 or modify this d │ │ │ │ │ +00019e80: 6f63 756d 656e 740a 2020 2020 2020 2075 ocument. u │ │ │ │ │ +00019e90: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ +00019ea0: 6620 7468 6520 474e 5520 4672 6565 2044 f the GNU Free D │ │ │ │ │ +00019eb0: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ +00019ec0: 656e 7365 2c20 5665 7273 696f 6e20 312e ense, Version 1. │ │ │ │ │ +00019ed0: 320a 2020 2020 2020 206f 7220 616e 7920 2. or any │ │ │ │ │ +00019ee0: 6c61 7465 7220 7665 7273 696f 6e20 7075 later version pu │ │ │ │ │ +00019ef0: 626c 6973 6865 6420 6279 2074 6865 2046 blished by the F │ │ │ │ │ +00019f00: 7265 6520 536f 6674 7761 7265 2046 6f75 ree Software Fou │ │ │ │ │ +00019f10: 6e64 6174 696f 6e3b 0a20 2020 2020 2020 ndation;. │ │ │ │ │ +00019f20: 7769 7468 206e 6f20 496e 7661 7269 616e with no Invarian │ │ │ │ │ +00019f30: 7420 5365 6374 696f 6e73 2c20 6e6f 2046 t Sections, no F │ │ │ │ │ +00019f40: 726f 6e74 2d43 6f76 6572 2054 6578 7473 ront-Cover Texts │ │ │ │ │ +00019f50: 2c20 616e 6420 6e6f 2042 6163 6b2d 436f , and no Back-Co │ │ │ │ │ +00019f60: 7665 720a 2020 2020 2020 2054 6578 7473 ver. Texts │ │ │ │ │ +00019f70: 2e20 2041 2063 6f70 7920 6f66 2074 6865 . A copy of the │ │ │ │ │ +00019f80: 206c 6963 656e 7365 2069 7320 696e 636c license is incl │ │ │ │ │ +00019f90: 7564 6564 2069 6e20 7468 6520 7365 6374 uded in the sect │ │ │ │ │ +00019fa0: 696f 6e20 656e 7469 746c 6564 2060 6047 ion entitled ``G │ │ │ │ │ +00019fb0: 4e55 0a20 2020 2020 2020 4672 6565 2044 NU. Free D │ │ │ │ │ +00019fc0: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ +00019fd0: 656e 7365 2727 2e0a 0a20 2020 4966 2079 ense''... If y │ │ │ │ │ +00019fe0: 6f75 2068 6176 6520 496e 7661 7269 616e ou have Invarian │ │ │ │ │ +00019ff0: 7420 5365 6374 696f 6e73 2c20 4672 6f6e t Sections, Fron │ │ │ │ │ +0001a000: 742d 436f 7665 7220 5465 7874 7320 616e t-Cover Texts an │ │ │ │ │ +0001a010: 6420 4261 636b 2d43 6f76 6572 0a54 6578 d Back-Cover.Tex │ │ │ │ │ +0001a020: 7473 2c20 7265 706c 6163 6520 7468 6520 ts, replace the │ │ │ │ │ +0001a030: 2277 6974 682e 2e2e 5465 7874 732e 2220 "with...Texts." │ │ │ │ │ +0001a040: 206c 696e 6520 7769 7468 2074 6869 733a line with this: │ │ │ │ │ +0001a050: 0a0a 2020 2020 2020 2020 2077 6974 6820 .. with │ │ │ │ │ +0001a060: 7468 6520 496e 7661 7269 616e 7420 5365 the Invariant Se │ │ │ │ │ +0001a070: 6374 696f 6e73 2062 6569 6e67 204c 4953 ctions being LIS │ │ │ │ │ +0001a080: 5420 5448 4549 5220 5449 544c 4553 2c20 T THEIR TITLES, │ │ │ │ │ +0001a090: 7769 7468 0a20 2020 2020 2020 2020 7468 with. th │ │ │ │ │ +0001a0a0: 6520 4672 6f6e 742d 436f 7665 7220 5465 e Front-Cover Te │ │ │ │ │ +0001a0b0: 7874 7320 6265 696e 6720 4c49 5354 2c20 xts being LIST, │ │ │ │ │ +0001a0c0: 616e 6420 7769 7468 2074 6865 2042 6163 and with the Bac │ │ │ │ │ +0001a0d0: 6b2d 436f 7665 7220 5465 7874 730a 2020 k-Cover Texts. │ │ │ │ │ +0001a0e0: 2020 2020 2020 2062 6569 6e67 204c 4953 being LIS │ │ │ │ │ +0001a0f0: 542e 0a0a 2020 2049 6620 796f 7520 6861 T... If you ha │ │ │ │ │ +0001a100: 7665 2049 6e76 6172 6961 6e74 2053 6563 ve Invariant Sec │ │ │ │ │ +0001a110: 7469 6f6e 7320 7769 7468 6f75 7420 436f tions without Co │ │ │ │ │ +0001a120: 7665 7220 5465 7874 732c 206f 7220 736f ver Texts, or so │ │ │ │ │ +0001a130: 6d65 206f 7468 6572 0a63 6f6d 6269 6e61 me other.combina │ │ │ │ │ +0001a140: 7469 6f6e 206f 6620 7468 6520 7468 7265 tion of the thre │ │ │ │ │ +0001a150: 652c 206d 6572 6765 2074 686f 7365 2074 e, merge those t │ │ │ │ │ +0001a160: 776f 2061 6c74 6572 6e61 7469 7665 7320 wo alternatives │ │ │ │ │ +0001a170: 746f 2073 7569 7420 7468 650a 7369 7475 to suit the.situ │ │ │ │ │ +0001a180: 6174 696f 6e2e 0a0a 2020 2049 6620 796f ation... If yo │ │ │ │ │ +0001a190: 7572 2064 6f63 756d 656e 7420 636f 6e74 ur document cont │ │ │ │ │ +0001a1a0: 6169 6e73 206e 6f6e 7472 6976 6961 6c20 ains nontrivial │ │ │ │ │ +0001a1b0: 6578 616d 706c 6573 206f 6620 7072 6f67 examples of prog │ │ │ │ │ +0001a1c0: 7261 6d20 636f 6465 2c20 7765 0a72 6563 ram code, we.rec │ │ │ │ │ +0001a1d0: 6f6d 6d65 6e64 2072 656c 6561 7369 6e67 ommend releasing │ │ │ │ │ +0001a1e0: 2074 6865 7365 2065 7861 6d70 6c65 7320 these examples │ │ │ │ │ +0001a1f0: 696e 2070 6172 616c 6c65 6c20 756e 6465 in parallel unde │ │ │ │ │ +0001a200: 7220 796f 7572 2063 686f 6963 6520 6f66 r your choice of │ │ │ │ │ +0001a210: 2066 7265 650a 736f 6674 7761 7265 206c free.software l │ │ │ │ │ +0001a220: 6963 656e 7365 2c20 7375 6368 2061 7320 icense, such as │ │ │ │ │ +0001a230: 7468 6520 474e 5520 4765 6e65 7261 6c20 the GNU General │ │ │ │ │ +0001a240: 5075 626c 6963 204c 6963 656e 7365 2c20 Public License, │ │ │ │ │ +0001a250: 746f 2070 6572 6d69 740a 7468 6569 7220 to permit.their │ │ │ │ │ +0001a260: 7573 6520 696e 2066 7265 6520 736f 6674 use in free soft │ │ │ │ │ +0001a270: 7761 7265 2e0a 0a1f 0a46 696c 653a 2067 ware.....File: g │ │ │ │ │ +0001a280: 7275 622d 6465 762e 696e 666f 2c20 204e rub-dev.info, N │ │ │ │ │ +0001a290: 6f64 653a 2049 6e64 6578 2c20 2050 7265 ode: Index, Pre │ │ │ │ │ +0001a2a0: 763a 2043 6f70 7969 6e67 2054 6869 7320 v: Copying This │ │ │ │ │ +0001a2b0: 4d61 6e75 616c 2c20 2055 703a 2054 6f70 Manual, Up: Top │ │ │ │ │ +0001a2c0: 0a0a 496e 6465 780a 2a2a 2a2a 2a0a 0a00 ..Index.*****... │ │ │ │ │ +0001a2d0: 085b 696e 6465 7800 085d 0a2a 204d 656e .[index..].* Men │ │ │ │ │ +0001a2e0: 753a 0a0a 2a20 4644 4c2c 2047 4e55 2046 u:..* FDL, GNU F │ │ │ │ │ +0001a2f0: 7265 6520 446f 6375 6d65 6e74 6174 696f ree Documentatio │ │ │ │ │ +0001a300: 6e20 4c69 6365 6e73 653a 2020 2047 4e55 n License: GNU │ │ │ │ │ +0001a310: 2046 7265 6520 446f 6375 6d65 6e74 6174 Free Documentat │ │ │ │ │ +0001a320: 696f 6e20 4c69 6365 6e73 652e 0a20 2020 ion License.. │ │ │ │ │ 0001a330: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0001a340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0001a350: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a360: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -0001a370: 2036 290a 0a0a 1f0a 5461 6720 5461 626c 6).....Tag Tabl │ │ │ │ │ -0001a380: 653a 0a4e 6f64 653a 2054 6f70 7f36 3339 e:.Node: Top.639 │ │ │ │ │ -0001a390: 0a4e 6f64 653a 2047 6574 7469 6e67 2074 .Node: Getting t │ │ │ │ │ -0001a3a0: 6865 2073 6f75 7263 6520 636f 6465 7f31 he source code.1 │ │ │ │ │ -0001a3b0: 3830 340a 4e6f 6465 3a20 436f 6469 6e67 804.Node: Coding │ │ │ │ │ -0001a3c0: 2073 7479 6c65 7f32 3736 350a 4e6f 6465 style.2765.Node │ │ │ │ │ -0001a3d0: 3a20 4e61 6d69 6e67 2043 6f6e 7665 6e74 : Naming Convent │ │ │ │ │ -0001a3e0: 696f 6e73 7f33 3137 340a 4e6f 6465 3a20 ions.3174.Node: │ │ │ │ │ -0001a3f0: 4675 6e63 7469 6f6e 737f 3334 3539 0a4e Functions.3459.N │ │ │ │ │ -0001a400: 6f64 653a 2056 6172 6961 626c 6573 7f34 ode: Variables.4 │ │ │ │ │ -0001a410: 3333 330a 4e6f 6465 3a20 5479 7065 737f 333.Node: Types. │ │ │ │ │ -0001a420: 3534 3438 0a4e 6f64 653a 204d 6163 726f 5448.Node: Macro │ │ │ │ │ -0001a430: 737f 3630 3439 0a4e 6f64 653a 2043 6f6d s.6049.Node: Com │ │ │ │ │ -0001a440: 6d65 6e74 737f 3633 3831 0a4e 6f64 653a ments.6381.Node: │ │ │ │ │ -0001a450: 204d 756c 7469 2d4c 696e 6520 436f 6d6d Multi-Line Comm │ │ │ │ │ -0001a460: 656e 7473 7f36 3939 300a 4e6f 6465 3a20 ents.6990.Node: │ │ │ │ │ -0001a470: 4669 6e64 696e 6720 796f 7572 2077 6179 Finding your way │ │ │ │ │ -0001a480: 2061 726f 756e 647f 3739 3135 0a4e 6f64 around.7915.Nod │ │ │ │ │ -0001a490: 653a 2043 6f6e 7472 6962 7574 696e 6720 e: Contributing │ │ │ │ │ -0001a4a0: 4368 616e 6765 737f 3131 3233 310a 4e6f Changes.11231.No │ │ │ │ │ -0001a4b0: 6465 3a20 4765 7474 696e 6720 7374 6172 de: Getting star │ │ │ │ │ -0001a4c0: 7465 647f 3132 3333 360a 4e6f 6465 3a20 ted.12336.Node: │ │ │ │ │ -0001a4d0: 5479 7069 6361 6c20 4465 7665 6c6f 7065 Typical Develope │ │ │ │ │ -0001a4e0: 7220 4578 7065 7269 656e 6365 7f31 3633 r Experience.163 │ │ │ │ │ -0001a4f0: 3838 0a4e 6f64 653a 2057 6865 6e20 796f 88.Node: When yo │ │ │ │ │ -0001a500: 7520 6172 6520 6170 7072 6f76 6564 2066 u are approved f │ │ │ │ │ -0001a510: 6f72 2077 7269 7465 2061 6363 6573 7320 or write access │ │ │ │ │ -0001a520: 746f 2070 726f 6a65 6374 2773 2066 696c to project's fil │ │ │ │ │ -0001a530: 6573 7f31 3734 3330 0a4e 6f64 653a 2055 es.17430.Node: U │ │ │ │ │ -0001a540: 7064 6174 696e 6720 4578 7465 726e 616c pdating External │ │ │ │ │ -0001a550: 2043 6f64 657f 3138 3836 330a 4e6f 6465 Code.18863.Node │ │ │ │ │ -0001a560: 3a20 476e 756c 6962 7f31 3931 3535 0a4e : Gnulib.19155.N │ │ │ │ │ -0001a570: 6f64 653a 206a 736d 6e7f 3231 3134 380a ode: jsmn.21148. │ │ │ │ │ -0001a580: 4e6f 6465 3a20 6d69 6e69 6c7a 6f7f 3231 Node: minilzo.21 │ │ │ │ │ -0001a590: 3631 390a 4e6f 6465 3a20 506f 7274 696e 619.Node: Portin │ │ │ │ │ -0001a5a0: 677f 3232 3332 350a 4e6f 6465 3a20 4572 g.22325.Node: Er │ │ │ │ │ -0001a5b0: 726f 7220 4861 6e64 6c69 6e67 7f33 3430 ror Handling.340 │ │ │ │ │ -0001a5c0: 3930 0a4e 6f64 653a 2053 7461 636b 2061 90.Node: Stack a │ │ │ │ │ -0001a5d0: 6e64 2068 6561 7020 7369 7a65 7f33 3931 nd heap size.391 │ │ │ │ │ -0001a5e0: 3832 0a4e 6f64 653a 2042 494f 5320 706f 82.Node: BIOS po │ │ │ │ │ -0001a5f0: 7274 206d 656d 6f72 7920 6d61 707f 3431 rt memory map.41 │ │ │ │ │ -0001a600: 3831 350a 4e6f 6465 3a20 5669 6465 6f20 815.Node: Video │ │ │ │ │ -0001a610: 5375 6273 7973 7465 6d7f 3432 3636 340a Subsystem.42664. │ │ │ │ │ -0001a620: 4e6f 6465 3a20 5669 6465 6f20 4150 497f Node: Video API. │ │ │ │ │ -0001a630: 3433 3133 380a 4e6f 6465 3a20 4578 616d 43138.Node: Exam │ │ │ │ │ -0001a640: 706c 6520 7573 6167 6520 6f66 2056 6964 ple usage of Vid │ │ │ │ │ -0001a650: 656f 2041 5049 7f36 3335 3837 0a4e 6f64 eo API.63587.Nod │ │ │ │ │ -0001a660: 653a 2042 6974 6d61 7020 4150 497f 3635 e: Bitmap API.65 │ │ │ │ │ -0001a670: 3136 370a 4e6f 6465 3a20 5046 4632 2046 167.Node: PFF2 F │ │ │ │ │ -0001a680: 6f6e 7420 4669 6c65 2046 6f72 6d61 747f ont File Format. │ │ │ │ │ -0001a690: 3637 3730 300a 4e6f 6465 3a20 496e 7472 67700.Node: Intr │ │ │ │ │ -0001a6a0: 6f64 7563 7469 6f6e 7f36 3739 3430 0a4e oduction.67940.N │ │ │ │ │ -0001a6b0: 6f64 653a 2046 696c 6520 5374 7275 6374 ode: File Struct │ │ │ │ │ -0001a6c0: 7572 657f 3639 3434 330a 4e6f 6465 3a20 ure.69443.Node: │ │ │ │ │ -0001a6d0: 466f 6e74 204d 6574 7269 6373 7f37 3433 Font Metrics.743 │ │ │ │ │ -0001a6e0: 3631 0a4e 6f64 653a 2047 7261 7068 6963 61.Node: Graphic │ │ │ │ │ -0001a6f0: 616c 204d 656e 7520 536f 6674 7761 7265 al Menu Software │ │ │ │ │ -0001a700: 2044 6573 6967 6e7f 3735 3531 300a 4e6f Design.75510.No │ │ │ │ │ -0001a710: 6465 3a20 496e 7472 6f64 7563 7469 6f6e de: Introduction │ │ │ │ │ -0001a720: 5f32 7f37 3538 3032 0a4e 6f64 653a 2053 _2.75802.Node: S │ │ │ │ │ -0001a730: 7461 7274 7570 2053 6571 7565 6e63 657f tartup Sequence. │ │ │ │ │ -0001a740: 3736 3533 360a 4e6f 6465 3a20 4755 4920 76536.Node: GUI │ │ │ │ │ -0001a750: 436f 6d70 6f6e 656e 7473 7f37 3733 3837 Components.77387 │ │ │ │ │ -0001a760: 0a4e 6f64 653a 2043 6f6d 6d61 6e64 204c .Node: Command L │ │ │ │ │ -0001a770: 696e 6520 5769 6e64 6f77 7f37 3939 3837 ine Window.79987 │ │ │ │ │ -0001a780: 0a4e 6f64 653a 2056 6572 6966 6965 7273 .Node: Verifiers │ │ │ │ │ -0001a790: 2066 7261 6d65 776f 726b 7f38 3039 3339 framework.80939 │ │ │ │ │ -0001a7a0: 0a4e 6f64 653a 204c 6f63 6b64 6f77 6e20 .Node: Lockdown │ │ │ │ │ -0001a7b0: 6672 616d 6577 6f72 6b7f 3833 3534 360a framework.83546. │ │ │ │ │ -0001a7c0: 4e6f 6465 3a20 436f 7079 696e 6720 5468 Node: Copying Th │ │ │ │ │ -0001a7d0: 6973 204d 616e 7561 6c7f 3834 3438 380a is Manual.84488. │ │ │ │ │ -0001a7e0: 4e6f 6465 3a20 474e 5520 4672 6565 2044 Node: GNU Free D │ │ │ │ │ -0001a7f0: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ -0001a800: 656e 7365 7f38 3437 3332 0a4e 6f64 653a ense.84732.Node: │ │ │ │ │ -0001a810: 2049 6e64 6578 7f31 3037 3132 350a 1f0a Index.107125... │ │ │ │ │ -0001a820: 456e 6420 5461 6720 5461 626c 650a 0a1f End Tag Table... │ │ │ │ │ -0001a830: 0a4c 6f63 616c 2056 6172 6961 626c 6573 .Local Variables │ │ │ │ │ -0001a840: 3a0a 636f 6469 6e67 3a20 7574 662d 380a :.coding: utf-8. │ │ │ │ │ -0001a850: 456e 643a 0a End:. │ │ │ │ │ +0001a360: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +0001a370: 6e65 2036 290a 0a0a 1f0a 5461 6720 5461 ne 6).....Tag Ta │ │ │ │ │ +0001a380: 626c 653a 0a4e 6f64 653a 2054 6f70 7f36 ble:.Node: Top.6 │ │ │ │ │ +0001a390: 3430 0a4e 6f64 653a 2047 6574 7469 6e67 40.Node: Getting │ │ │ │ │ +0001a3a0: 2074 6865 2073 6f75 7263 6520 636f 6465 the source code │ │ │ │ │ +0001a3b0: 7f31 3830 360a 4e6f 6465 3a20 436f 6469 .1806.Node: Codi │ │ │ │ │ +0001a3c0: 6e67 2073 7479 6c65 7f32 3736 370a 4e6f ng style.2767.No │ │ │ │ │ +0001a3d0: 6465 3a20 4e61 6d69 6e67 2043 6f6e 7665 de: Naming Conve │ │ │ │ │ +0001a3e0: 6e74 696f 6e73 7f33 3137 360a 4e6f 6465 ntions.3176.Node │ │ │ │ │ +0001a3f0: 3a20 4675 6e63 7469 6f6e 737f 3334 3631 : Functions.3461 │ │ │ │ │ +0001a400: 0a4e 6f64 653a 2056 6172 6961 626c 6573 .Node: Variables │ │ │ │ │ +0001a410: 7f34 3333 350a 4e6f 6465 3a20 5479 7065 .4335.Node: Type │ │ │ │ │ +0001a420: 737f 3534 3530 0a4e 6f64 653a 204d 6163 s.5450.Node: Mac │ │ │ │ │ +0001a430: 726f 737f 3630 3531 0a4e 6f64 653a 2043 ros.6051.Node: C │ │ │ │ │ +0001a440: 6f6d 6d65 6e74 737f 3633 3833 0a4e 6f64 omments.6383.Nod │ │ │ │ │ +0001a450: 653a 204d 756c 7469 2d4c 696e 6520 436f e: Multi-Line Co │ │ │ │ │ +0001a460: 6d6d 656e 7473 7f36 3939 320a 4e6f 6465 mments.6992.Node │ │ │ │ │ +0001a470: 3a20 4669 6e64 696e 6720 796f 7572 2077 : Finding your w │ │ │ │ │ +0001a480: 6179 2061 726f 756e 647f 3739 3137 0a4e ay around.7917.N │ │ │ │ │ +0001a490: 6f64 653a 2043 6f6e 7472 6962 7574 696e ode: Contributin │ │ │ │ │ +0001a4a0: 6720 4368 616e 6765 737f 3131 3233 330a g Changes.11233. │ │ │ │ │ +0001a4b0: 4e6f 6465 3a20 4765 7474 696e 6720 7374 Node: Getting st │ │ │ │ │ +0001a4c0: 6172 7465 647f 3132 3333 380a 4e6f 6465 arted.12338.Node │ │ │ │ │ +0001a4d0: 3a20 5479 7069 6361 6c20 4465 7665 6c6f : Typical Develo │ │ │ │ │ +0001a4e0: 7065 7220 4578 7065 7269 656e 6365 7f31 per Experience.1 │ │ │ │ │ +0001a4f0: 3633 3930 0a4e 6f64 653a 2057 6865 6e20 6390.Node: When │ │ │ │ │ +0001a500: 796f 7520 6172 6520 6170 7072 6f76 6564 you are approved │ │ │ │ │ +0001a510: 2066 6f72 2077 7269 7465 2061 6363 6573 for write acces │ │ │ │ │ +0001a520: 7320 746f 2070 726f 6a65 6374 2773 2066 s to project's f │ │ │ │ │ +0001a530: 696c 6573 7f31 3734 3332 0a4e 6f64 653a iles.17432.Node: │ │ │ │ │ +0001a540: 2055 7064 6174 696e 6720 4578 7465 726e Updating Extern │ │ │ │ │ +0001a550: 616c 2043 6f64 657f 3138 3836 350a 4e6f al Code.18865.No │ │ │ │ │ +0001a560: 6465 3a20 476e 756c 6962 7f31 3931 3537 de: Gnulib.19157 │ │ │ │ │ +0001a570: 0a4e 6f64 653a 206a 736d 6e7f 3231 3135 .Node: jsmn.2115 │ │ │ │ │ +0001a580: 300a 4e6f 6465 3a20 6d69 6e69 6c7a 6f7f 0.Node: minilzo. │ │ │ │ │ +0001a590: 3231 3632 310a 4e6f 6465 3a20 506f 7274 21621.Node: Port │ │ │ │ │ +0001a5a0: 696e 677f 3232 3332 370a 4e6f 6465 3a20 ing.22327.Node: │ │ │ │ │ +0001a5b0: 4572 726f 7220 4861 6e64 6c69 6e67 7f33 Error Handling.3 │ │ │ │ │ +0001a5c0: 3430 3932 0a4e 6f64 653a 2053 7461 636b 4092.Node: Stack │ │ │ │ │ +0001a5d0: 2061 6e64 2068 6561 7020 7369 7a65 7f33 and heap size.3 │ │ │ │ │ +0001a5e0: 3931 3834 0a4e 6f64 653a 2042 494f 5320 9184.Node: BIOS │ │ │ │ │ +0001a5f0: 706f 7274 206d 656d 6f72 7920 6d61 707f port memory map. │ │ │ │ │ +0001a600: 3431 3831 370a 4e6f 6465 3a20 5669 6465 41817.Node: Vide │ │ │ │ │ +0001a610: 6f20 5375 6273 7973 7465 6d7f 3432 3636 o Subsystem.4266 │ │ │ │ │ +0001a620: 360a 4e6f 6465 3a20 5669 6465 6f20 4150 6.Node: Video AP │ │ │ │ │ +0001a630: 497f 3433 3134 300a 4e6f 6465 3a20 4578 I.43140.Node: Ex │ │ │ │ │ +0001a640: 616d 706c 6520 7573 6167 6520 6f66 2056 ample usage of V │ │ │ │ │ +0001a650: 6964 656f 2041 5049 7f36 3335 3839 0a4e ideo API.63589.N │ │ │ │ │ +0001a660: 6f64 653a 2042 6974 6d61 7020 4150 497f ode: Bitmap API. │ │ │ │ │ +0001a670: 3635 3136 390a 4e6f 6465 3a20 5046 4632 65169.Node: PFF2 │ │ │ │ │ +0001a680: 2046 6f6e 7420 4669 6c65 2046 6f72 6d61 Font File Forma │ │ │ │ │ +0001a690: 747f 3637 3730 320a 4e6f 6465 3a20 496e t.67702.Node: In │ │ │ │ │ +0001a6a0: 7472 6f64 7563 7469 6f6e 7f36 3739 3432 troduction.67942 │ │ │ │ │ +0001a6b0: 0a4e 6f64 653a 2046 696c 6520 5374 7275 .Node: File Stru │ │ │ │ │ +0001a6c0: 6374 7572 657f 3639 3434 350a 4e6f 6465 cture.69445.Node │ │ │ │ │ +0001a6d0: 3a20 466f 6e74 204d 6574 7269 6373 7f37 : Font Metrics.7 │ │ │ │ │ +0001a6e0: 3433 3633 0a4e 6f64 653a 2047 7261 7068 4363.Node: Graph │ │ │ │ │ +0001a6f0: 6963 616c 204d 656e 7520 536f 6674 7761 ical Menu Softwa │ │ │ │ │ +0001a700: 7265 2044 6573 6967 6e7f 3735 3531 320a re Design.75512. │ │ │ │ │ +0001a710: 4e6f 6465 3a20 496e 7472 6f64 7563 7469 Node: Introducti │ │ │ │ │ +0001a720: 6f6e 5f32 7f37 3538 3034 0a4e 6f64 653a on_2.75804.Node: │ │ │ │ │ +0001a730: 2053 7461 7274 7570 2053 6571 7565 6e63 Startup Sequenc │ │ │ │ │ +0001a740: 657f 3736 3533 380a 4e6f 6465 3a20 4755 e.76538.Node: GU │ │ │ │ │ +0001a750: 4920 436f 6d70 6f6e 656e 7473 7f37 3733 I Components.773 │ │ │ │ │ +0001a760: 3839 0a4e 6f64 653a 2043 6f6d 6d61 6e64 89.Node: Command │ │ │ │ │ +0001a770: 204c 696e 6520 5769 6e64 6f77 7f37 3939 Line Window.799 │ │ │ │ │ +0001a780: 3839 0a4e 6f64 653a 2056 6572 6966 6965 89.Node: Verifie │ │ │ │ │ +0001a790: 7273 2066 7261 6d65 776f 726b 7f38 3039 rs framework.809 │ │ │ │ │ +0001a7a0: 3431 0a4e 6f64 653a 204c 6f63 6b64 6f77 41.Node: Lockdow │ │ │ │ │ +0001a7b0: 6e20 6672 616d 6577 6f72 6b7f 3833 3534 n framework.8354 │ │ │ │ │ +0001a7c0: 380a 4e6f 6465 3a20 436f 7079 696e 6720 8.Node: Copying │ │ │ │ │ +0001a7d0: 5468 6973 204d 616e 7561 6c7f 3834 3439 This Manual.8449 │ │ │ │ │ +0001a7e0: 300a 4e6f 6465 3a20 474e 5520 4672 6565 0.Node: GNU Free │ │ │ │ │ +0001a7f0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ +0001a800: 6963 656e 7365 7f38 3437 3334 0a4e 6f64 icense.84734.Nod │ │ │ │ │ +0001a810: 653a 2049 6e64 6578 7f31 3037 3132 370a e: Index.107127. │ │ │ │ │ +0001a820: 1f0a 456e 6420 5461 6720 5461 626c 650a ..End Tag Table. │ │ │ │ │ +0001a830: 0a1f 0a4c 6f63 616c 2056 6172 6961 626c ...Local Variabl │ │ │ │ │ +0001a840: 6573 3a0a 636f 6469 6e67 3a20 7574 662d es:.coding: utf- │ │ │ │ │ +0001a850: 380a 456e 643a 0a 8.End:. │ │ │ ├── ./usr/share/info/grub.info-1.gz │ │ │ │ ├── grub.info-1 │ │ │ │ │ @@ -1,19455 +1,19455 @@ │ │ │ │ │ 00000000: 5468 6973 2069 7320 6772 7562 2e69 6e66 This is grub.inf │ │ │ │ │ 00000010: 6f2c 2070 726f 6475 6365 6420 6279 206d o, produced by m │ │ │ │ │ 00000020: 616b 6569 6e66 6f20 7665 7273 696f 6e20 akeinfo version │ │ │ │ │ 00000030: 362e 3820 6672 6f6d 2067 7275 622e 7465 6.8 from grub.te │ │ │ │ │ 00000040: 7869 2e0a 0a54 6869 7320 6d61 6e75 616c xi...This manual │ │ │ │ │ 00000050: 2069 7320 666f 7220 474e 5520 4752 5542 is for GNU GRUB │ │ │ │ │ 00000060: 2028 7665 7273 696f 6e20 322e 3036 2c20 (version 2.06, │ │ │ │ │ -00000070: 3720 4a61 6e75 6172 7920 3230 3234 292e 7 January 2024). │ │ │ │ │ -00000080: 0a0a 2020 2043 6f70 7972 6967 6874 2028 .. Copyright ( │ │ │ │ │ -00000090: 4329 0a31 3939 392c 3230 3030 2c32 3030 C).1999,2000,200 │ │ │ │ │ -000000a0: 312c 3230 3032 2c32 3030 342c 3230 3036 1,2002,2004,2006 │ │ │ │ │ -000000b0: 2c32 3030 382c 3230 3039 2c32 3031 302c ,2008,2009,2010, │ │ │ │ │ -000000c0: 3230 3131 2c32 3031 322c 3230 3133 2046 2011,2012,2013 F │ │ │ │ │ -000000d0: 7265 650a 536f 6674 7761 7265 2046 6f75 ree.Software Fou │ │ │ │ │ -000000e0: 6e64 6174 696f 6e2c 2049 6e63 2e0a 0a20 ndation, Inc... │ │ │ │ │ -000000f0: 2020 2020 5065 726d 6973 7369 6f6e 2069 Permission i │ │ │ │ │ -00000100: 7320 6772 616e 7465 6420 746f 2063 6f70 s granted to cop │ │ │ │ │ -00000110: 792c 2064 6973 7472 6962 7574 6520 616e y, distribute an │ │ │ │ │ -00000120: 642f 6f72 206d 6f64 6966 7920 7468 6973 d/or modify this │ │ │ │ │ -00000130: 0a20 2020 2020 646f 6375 6d65 6e74 2075 . document u │ │ │ │ │ -00000140: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ -00000150: 6620 7468 6520 474e 5520 4672 6565 2044 f the GNU Free D │ │ │ │ │ -00000160: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ -00000170: 656e 7365 2c0a 2020 2020 2056 6572 7369 ense,. Versi │ │ │ │ │ -00000180: 6f6e 2031 2e32 206f 7220 616e 7920 6c61 on 1.2 or any la │ │ │ │ │ -00000190: 7465 7220 7665 7273 696f 6e20 7075 626c ter version publ │ │ │ │ │ -000001a0: 6973 6865 6420 6279 2074 6865 2046 7265 ished by the Fre │ │ │ │ │ -000001b0: 6520 536f 6674 7761 7265 0a20 2020 2020 e Software. │ │ │ │ │ -000001c0: 466f 756e 6461 7469 6f6e 3b20 7769 7468 Foundation; with │ │ │ │ │ -000001d0: 206e 6f20 496e 7661 7269 616e 7420 5365 no Invariant Se │ │ │ │ │ -000001e0: 6374 696f 6e73 2e0a 494e 464f 2d44 4952 ctions..INFO-DIR │ │ │ │ │ -000001f0: 2d53 4543 5449 4f4e 204b 6572 6e65 6c0a -SECTION Kernel. │ │ │ │ │ -00000200: 5354 4152 542d 494e 464f 2d44 4952 2d45 START-INFO-DIR-E │ │ │ │ │ -00000210: 4e54 5259 0a2a 2047 5255 423a 2028 6772 NTRY.* GRUB: (gr │ │ │ │ │ -00000220: 7562 292e 2020 2020 2020 2020 2020 2020 ub). │ │ │ │ │ -00000230: 2020 2020 2054 6865 2047 5261 6e64 2055 The GRand U │ │ │ │ │ -00000240: 6e69 6669 6564 2042 6f6f 746c 6f61 6465 nified Bootloade │ │ │ │ │ -00000250: 720a 2a20 6772 7562 2d69 6e73 7461 6c6c r.* grub-install │ │ │ │ │ -00000260: 3a20 2867 7275 6229 496e 766f 6b69 6e67 : (grub)Invoking │ │ │ │ │ -00000270: 2067 7275 622d 696e 7374 616c 6c2e 2020 grub-install. │ │ │ │ │ -00000280: 2020 496e 7374 616c 6c20 4752 5542 206f Install GRUB o │ │ │ │ │ -00000290: 6e20 796f 7572 2064 7269 7665 0a2a 2067 n your drive.* g │ │ │ │ │ -000002a0: 7275 622d 6d6b 636f 6e66 6967 3a20 2867 rub-mkconfig: (g │ │ │ │ │ -000002b0: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ -000002c0: 622d 6d6b 636f 6e66 6967 2e20 2047 656e b-mkconfig. Gen │ │ │ │ │ -000002d0: 6572 6174 6520 4752 5542 2063 6f6e 6669 erate GRUB confi │ │ │ │ │ -000002e0: 6775 7261 7469 6f6e 0a2a 2067 7275 622d guration.* grub- │ │ │ │ │ -000002f0: 6d6b 7061 7373 7764 2d70 626b 6466 323a mkpasswd-pbkdf2: │ │ │ │ │ -00000300: 2028 6772 7562 2949 6e76 6f6b 696e 6720 (grub)Invoking │ │ │ │ │ -00000310: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ -00000320: 6b64 6632 2e0a 2a20 6772 7562 2d6d 6b72 kdf2..* grub-mkr │ │ │ │ │ -00000330: 656c 7061 7468 3a20 2867 7275 6229 496e elpath: (grub)In │ │ │ │ │ -00000340: 766f 6b69 6e67 2067 7275 622d 6d6b 7265 voking grub-mkre │ │ │ │ │ -00000350: 6c70 6174 682e 0a2a 2067 7275 622d 6d6b lpath..* grub-mk │ │ │ │ │ -00000360: 7265 7363 7565 3a20 2867 7275 6229 496e rescue: (grub)In │ │ │ │ │ -00000370: 766f 6b69 6e67 2067 7275 622d 6d6b 7265 voking grub-mkre │ │ │ │ │ -00000380: 7363 7565 2e20 204d 616b 6520 6120 4752 scue. Make a GR │ │ │ │ │ -00000390: 5542 2072 6573 6375 6520 696d 6167 650a UB rescue image. │ │ │ │ │ -000003a0: 2a20 6772 7562 2d6d 6f75 6e74 3a20 2867 * grub-mount: (g │ │ │ │ │ -000003b0: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ -000003c0: 622d 6d6f 756e 742e 2020 2020 2020 2020 b-mount. │ │ │ │ │ -000003d0: 4d6f 756e 7420 6120 6669 6c65 2073 7973 Mount a file sys │ │ │ │ │ -000003e0: 7465 6d20 7573 696e 6720 4752 5542 0a2a tem using GRUB.* │ │ │ │ │ -000003f0: 2067 7275 622d 7072 6f62 653a 2028 6772 grub-probe: (gr │ │ │ │ │ -00000400: 7562 2949 6e76 6f6b 696e 6720 6772 7562 ub)Invoking grub │ │ │ │ │ -00000410: 2d70 726f 6265 2e20 2020 2020 2020 2050 -probe. P │ │ │ │ │ -00000420: 726f 6265 2064 6576 6963 6520 696e 666f robe device info │ │ │ │ │ -00000430: 726d 6174 696f 6e0a 2a20 6772 7562 2d73 rmation.* grub-s │ │ │ │ │ -00000440: 6372 6970 742d 6368 6563 6b3a 2028 6772 cript-check: (gr │ │ │ │ │ -00000450: 7562 2949 6e76 6f6b 696e 6720 6772 7562 ub)Invoking grub │ │ │ │ │ -00000460: 2d73 6372 6970 742d 6368 6563 6b2e 0a45 -script-check..E │ │ │ │ │ -00000470: 4e44 2d49 4e46 4f2d 4449 522d 454e 5452 ND-INFO-DIR-ENTR │ │ │ │ │ -00000480: 590a 0a1f 0a46 696c 653a 2067 7275 622e Y....File: grub. │ │ │ │ │ -00000490: 696e 666f 2c20 204e 6f64 653a 2054 6f70 info, Node: Top │ │ │ │ │ -000004a0: 2c20 204e 6578 743a 2049 6e74 726f 6475 , Next: Introdu │ │ │ │ │ -000004b0: 6374 696f 6e2c 2020 5570 3a20 2864 6972 ction, Up: (dir │ │ │ │ │ -000004c0: 290a 0a47 4e55 2047 5255 4220 6d61 6e75 )..GNU GRUB manu │ │ │ │ │ -000004d0: 616c 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a al.************* │ │ │ │ │ -000004e0: 2a2a 0a0a 5468 6973 2069 7320 7468 6520 **..This is the │ │ │ │ │ -000004f0: 646f 6375 6d65 6e74 6174 696f 6e20 6f66 documentation of │ │ │ │ │ -00000500: 2047 4e55 2047 5255 422c 2074 6865 2047 GNU GRUB, the G │ │ │ │ │ -00000510: 5261 6e64 2055 6e69 6669 6564 2042 6f6f Rand Unified Boo │ │ │ │ │ -00000520: 746c 6f61 6465 722c 2061 0a66 6c65 7869 tloader, a.flexi │ │ │ │ │ -00000530: 626c 6520 616e 6420 706f 7765 7266 756c ble and powerful │ │ │ │ │ -00000540: 2062 6f6f 7420 6c6f 6164 6572 2070 726f boot loader pro │ │ │ │ │ -00000550: 6772 616d 2066 6f72 2061 2077 6964 6520 gram for a wide │ │ │ │ │ -00000560: 7261 6e67 6520 6f66 0a61 7263 6869 7465 range of.archite │ │ │ │ │ -00000570: 6374 7572 6573 2e0a 0a20 2020 5468 6973 ctures... This │ │ │ │ │ -00000580: 2065 6469 7469 6f6e 2064 6f63 756d 656e edition documen │ │ │ │ │ -00000590: 7473 2076 6572 7369 6f6e 2032 2e30 362e ts version 2.06. │ │ │ │ │ -000005a0: 0a0a 2020 2054 6869 7320 6d61 6e75 616c .. This manual │ │ │ │ │ -000005b0: 2069 7320 666f 7220 474e 5520 4752 5542 is for GNU GRUB │ │ │ │ │ -000005c0: 2028 7665 7273 696f 6e20 322e 3036 2c20 (version 2.06, │ │ │ │ │ -000005d0: 3720 4a61 6e75 6172 7920 3230 3234 292e 7 January 2024). │ │ │ │ │ -000005e0: 0a0a 2020 2043 6f70 7972 6967 6874 2028 .. Copyright ( │ │ │ │ │ -000005f0: 4329 0a31 3939 392c 3230 3030 2c32 3030 C).1999,2000,200 │ │ │ │ │ -00000600: 312c 3230 3032 2c32 3030 342c 3230 3036 1,2002,2004,2006 │ │ │ │ │ -00000610: 2c32 3030 382c 3230 3039 2c32 3031 302c ,2008,2009,2010, │ │ │ │ │ -00000620: 3230 3131 2c32 3031 322c 3230 3133 2046 2011,2012,2013 F │ │ │ │ │ -00000630: 7265 650a 536f 6674 7761 7265 2046 6f75 ree.Software Fou │ │ │ │ │ -00000640: 6e64 6174 696f 6e2c 2049 6e63 2e0a 0a20 ndation, Inc... │ │ │ │ │ -00000650: 2020 2020 5065 726d 6973 7369 6f6e 2069 Permission i │ │ │ │ │ -00000660: 7320 6772 616e 7465 6420 746f 2063 6f70 s granted to cop │ │ │ │ │ -00000670: 792c 2064 6973 7472 6962 7574 6520 616e y, distribute an │ │ │ │ │ -00000680: 642f 6f72 206d 6f64 6966 7920 7468 6973 d/or modify this │ │ │ │ │ -00000690: 0a20 2020 2020 646f 6375 6d65 6e74 2075 . document u │ │ │ │ │ -000006a0: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ -000006b0: 6620 7468 6520 474e 5520 4672 6565 2044 f the GNU Free D │ │ │ │ │ -000006c0: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ -000006d0: 656e 7365 2c0a 2020 2020 2056 6572 7369 ense,. Versi │ │ │ │ │ -000006e0: 6f6e 2031 2e32 206f 7220 616e 7920 6c61 on 1.2 or any la │ │ │ │ │ -000006f0: 7465 7220 7665 7273 696f 6e20 7075 626c ter version publ │ │ │ │ │ -00000700: 6973 6865 6420 6279 2074 6865 2046 7265 ished by the Fre │ │ │ │ │ -00000710: 6520 536f 6674 7761 7265 0a20 2020 2020 e Software. │ │ │ │ │ -00000720: 466f 756e 6461 7469 6f6e 3b20 7769 7468 Foundation; with │ │ │ │ │ -00000730: 206e 6f20 496e 7661 7269 616e 7420 5365 no Invariant Se │ │ │ │ │ -00000740: 6374 696f 6e73 2e0a 0a2a 204d 656e 753a ctions...* Menu: │ │ │ │ │ -00000750: 0a0a 2a20 496e 7472 6f64 7563 7469 6f6e ..* Introduction │ │ │ │ │ -00000760: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00000770: 2020 4361 7074 7572 696e 6720 7468 6520 Capturing the │ │ │ │ │ -00000780: 7370 6972 6974 206f 6620 4752 5542 0a2a spirit of GRUB.* │ │ │ │ │ -00000790: 204e 616d 696e 6720 636f 6e76 656e 7469 Naming conventi │ │ │ │ │ -000007a0: 6f6e 3a3a 2020 2020 2020 2020 2020 204e on:: N │ │ │ │ │ -000007b0: 616d 6573 206f 6620 796f 7572 2064 7269 ames of your dri │ │ │ │ │ -000007c0: 7665 7320 696e 2047 5255 420a 2a20 4f53 ves in GRUB.* OS │ │ │ │ │ -000007d0: 2d73 7065 6369 6669 6320 6e6f 7465 7320 -specific notes │ │ │ │ │ -000007e0: 6162 6f75 7420 6772 7562 2074 6f6f 6c73 about grub tools │ │ │ │ │ -000007f0: 3a3a 0a20 2020 2020 2020 2020 2020 2020 ::. │ │ │ │ │ +00000070: 3920 4665 6272 7561 7279 2032 3032 3529 9 February 2025) │ │ │ │ │ +00000080: 2e0a 0a20 2020 436f 7079 7269 6768 7420 ... Copyright │ │ │ │ │ +00000090: 2843 290a 3139 3939 2c32 3030 302c 3230 (C).1999,2000,20 │ │ │ │ │ +000000a0: 3031 2c32 3030 322c 3230 3034 2c32 3030 01,2002,2004,200 │ │ │ │ │ +000000b0: 362c 3230 3038 2c32 3030 392c 3230 3130 6,2008,2009,2010 │ │ │ │ │ +000000c0: 2c32 3031 312c 3230 3132 2c32 3031 3320 ,2011,2012,2013 │ │ │ │ │ +000000d0: 4672 6565 0a53 6f66 7477 6172 6520 466f Free.Software Fo │ │ │ │ │ +000000e0: 756e 6461 7469 6f6e 2c20 496e 632e 0a0a undation, Inc... │ │ │ │ │ +000000f0: 2020 2020 2050 6572 6d69 7373 696f 6e20 Permission │ │ │ │ │ +00000100: 6973 2067 7261 6e74 6564 2074 6f20 636f is granted to co │ │ │ │ │ +00000110: 7079 2c20 6469 7374 7269 6275 7465 2061 py, distribute a │ │ │ │ │ +00000120: 6e64 2f6f 7220 6d6f 6469 6679 2074 6869 nd/or modify thi │ │ │ │ │ +00000130: 730a 2020 2020 2064 6f63 756d 656e 7420 s. document │ │ │ │ │ +00000140: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ +00000150: 6f66 2074 6865 2047 4e55 2046 7265 6520 of the GNU Free │ │ │ │ │ +00000160: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ │ +00000170: 6365 6e73 652c 0a20 2020 2020 5665 7273 cense,. Vers │ │ │ │ │ +00000180: 696f 6e20 312e 3220 6f72 2061 6e79 206c ion 1.2 or any l │ │ │ │ │ +00000190: 6174 6572 2076 6572 7369 6f6e 2070 7562 ater version pub │ │ │ │ │ +000001a0: 6c69 7368 6564 2062 7920 7468 6520 4672 lished by the Fr │ │ │ │ │ +000001b0: 6565 2053 6f66 7477 6172 650a 2020 2020 ee Software. │ │ │ │ │ +000001c0: 2046 6f75 6e64 6174 696f 6e3b 2077 6974 Foundation; wit │ │ │ │ │ +000001d0: 6820 6e6f 2049 6e76 6172 6961 6e74 2053 h no Invariant S │ │ │ │ │ +000001e0: 6563 7469 6f6e 732e 0a49 4e46 4f2d 4449 ections..INFO-DI │ │ │ │ │ +000001f0: 522d 5345 4354 494f 4e20 4b65 726e 656c R-SECTION Kernel │ │ │ │ │ +00000200: 0a53 5441 5254 2d49 4e46 4f2d 4449 522d .START-INFO-DIR- │ │ │ │ │ +00000210: 454e 5452 590a 2a20 4752 5542 3a20 2867 ENTRY.* GRUB: (g │ │ │ │ │ +00000220: 7275 6229 2e20 2020 2020 2020 2020 2020 rub). │ │ │ │ │ +00000230: 2020 2020 2020 5468 6520 4752 616e 6420 The GRand │ │ │ │ │ +00000240: 556e 6966 6965 6420 426f 6f74 6c6f 6164 Unified Bootload │ │ │ │ │ +00000250: 6572 0a2a 2067 7275 622d 696e 7374 616c er.* grub-instal │ │ │ │ │ +00000260: 6c3a 2028 6772 7562 2949 6e76 6f6b 696e l: (grub)Invokin │ │ │ │ │ +00000270: 6720 6772 7562 2d69 6e73 7461 6c6c 2e20 g grub-install. │ │ │ │ │ +00000280: 2020 2049 6e73 7461 6c6c 2047 5255 4220 Install GRUB │ │ │ │ │ +00000290: 6f6e 2079 6f75 7220 6472 6976 650a 2a20 on your drive.* │ │ │ │ │ +000002a0: 6772 7562 2d6d 6b63 6f6e 6669 673a 2028 grub-mkconfig: ( │ │ │ │ │ +000002b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000002c0: 7562 2d6d 6b63 6f6e 6669 672e 2020 4765 ub-mkconfig. Ge │ │ │ │ │ +000002d0: 6e65 7261 7465 2047 5255 4220 636f 6e66 nerate GRUB conf │ │ │ │ │ +000002e0: 6967 7572 6174 696f 6e0a 2a20 6772 7562 iguration.* grub │ │ │ │ │ +000002f0: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ │ +00000300: 3a20 2867 7275 6229 496e 766f 6b69 6e67 : (grub)Invoking │ │ │ │ │ +00000310: 2067 7275 622d 6d6b 7061 7373 7764 2d70 grub-mkpasswd-p │ │ │ │ │ +00000320: 626b 6466 322e 0a2a 2067 7275 622d 6d6b bkdf2..* grub-mk │ │ │ │ │ +00000330: 7265 6c70 6174 683a 2028 6772 7562 2949 relpath: (grub)I │ │ │ │ │ +00000340: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000350: 656c 7061 7468 2e0a 2a20 6772 7562 2d6d elpath..* grub-m │ │ │ │ │ +00000360: 6b72 6573 6375 653a 2028 6772 7562 2949 krescue: (grub)I │ │ │ │ │ +00000370: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000380: 6573 6375 652e 2020 4d61 6b65 2061 2047 escue. Make a G │ │ │ │ │ +00000390: 5255 4220 7265 7363 7565 2069 6d61 6765 RUB rescue image │ │ │ │ │ +000003a0: 0a2a 2067 7275 622d 6d6f 756e 743a 2028 .* grub-mount: ( │ │ │ │ │ +000003b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000003c0: 7562 2d6d 6f75 6e74 2e20 2020 2020 2020 ub-mount. │ │ │ │ │ +000003d0: 204d 6f75 6e74 2061 2066 696c 6520 7379 Mount a file sy │ │ │ │ │ +000003e0: 7374 656d 2075 7369 6e67 2047 5255 420a stem using GRUB. │ │ │ │ │ +000003f0: 2a20 6772 7562 2d70 726f 6265 3a20 2867 * grub-probe: (g │ │ │ │ │ +00000400: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000410: 622d 7072 6f62 652e 2020 2020 2020 2020 b-probe. │ │ │ │ │ +00000420: 5072 6f62 6520 6465 7669 6365 2069 6e66 Probe device inf │ │ │ │ │ +00000430: 6f72 6d61 7469 6f6e 0a2a 2067 7275 622d ormation.* grub- │ │ │ │ │ +00000440: 7363 7269 7074 2d63 6865 636b 3a20 2867 script-check: (g │ │ │ │ │ +00000450: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000460: 622d 7363 7269 7074 2d63 6865 636b 2e0a b-script-check.. │ │ │ │ │ +00000470: 454e 442d 494e 464f 2d44 4952 2d45 4e54 END-INFO-DIR-ENT │ │ │ │ │ +00000480: 5259 0a0a 1f0a 4669 6c65 3a20 6772 7562 RY....File: grub │ │ │ │ │ +00000490: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 546f .info, Node: To │ │ │ │ │ +000004a0: 702c 2020 4e65 7874 3a20 496e 7472 6f64 p, Next: Introd │ │ │ │ │ +000004b0: 7563 7469 6f6e 2c20 2055 703a 2028 6469 uction, Up: (di │ │ │ │ │ +000004c0: 7229 0a0a 474e 5520 4752 5542 206d 616e r)..GNU GRUB man │ │ │ │ │ +000004d0: 7561 6c0a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ual.************ │ │ │ │ │ +000004e0: 2a2a 2a0a 0a54 6869 7320 6973 2074 6865 ***..This is the │ │ │ │ │ +000004f0: 2064 6f63 756d 656e 7461 7469 6f6e 206f documentation o │ │ │ │ │ +00000500: 6620 474e 5520 4752 5542 2c20 7468 6520 f GNU GRUB, the │ │ │ │ │ +00000510: 4752 616e 6420 556e 6966 6965 6420 426f GRand Unified Bo │ │ │ │ │ +00000520: 6f74 6c6f 6164 6572 2c20 610a 666c 6578 otloader, a.flex │ │ │ │ │ +00000530: 6962 6c65 2061 6e64 2070 6f77 6572 6675 ible and powerfu │ │ │ │ │ +00000540: 6c20 626f 6f74 206c 6f61 6465 7220 7072 l boot loader pr │ │ │ │ │ +00000550: 6f67 7261 6d20 666f 7220 6120 7769 6465 ogram for a wide │ │ │ │ │ +00000560: 2072 616e 6765 206f 660a 6172 6368 6974 range of.archit │ │ │ │ │ +00000570: 6563 7475 7265 732e 0a0a 2020 2054 6869 ectures... Thi │ │ │ │ │ +00000580: 7320 6564 6974 696f 6e20 646f 6375 6d65 s edition docume │ │ │ │ │ +00000590: 6e74 7320 7665 7273 696f 6e20 322e 3036 nts version 2.06 │ │ │ │ │ +000005a0: 2e0a 0a20 2020 5468 6973 206d 616e 7561 ... This manua │ │ │ │ │ +000005b0: 6c20 6973 2066 6f72 2047 4e55 2047 5255 l is for GNU GRU │ │ │ │ │ +000005c0: 4220 2876 6572 7369 6f6e 2032 2e30 362c B (version 2.06, │ │ │ │ │ +000005d0: 2039 2046 6562 7275 6172 7920 3230 3235 9 February 2025 │ │ │ │ │ +000005e0: 292e 0a0a 2020 2043 6f70 7972 6967 6874 )... Copyright │ │ │ │ │ +000005f0: 2028 4329 0a31 3939 392c 3230 3030 2c32 (C).1999,2000,2 │ │ │ │ │ +00000600: 3030 312c 3230 3032 2c32 3030 342c 3230 001,2002,2004,20 │ │ │ │ │ +00000610: 3036 2c32 3030 382c 3230 3039 2c32 3031 06,2008,2009,201 │ │ │ │ │ +00000620: 302c 3230 3131 2c32 3031 322c 3230 3133 0,2011,2012,2013 │ │ │ │ │ +00000630: 2046 7265 650a 536f 6674 7761 7265 2046 Free.Software F │ │ │ │ │ +00000640: 6f75 6e64 6174 696f 6e2c 2049 6e63 2e0a oundation, Inc.. │ │ │ │ │ +00000650: 0a20 2020 2020 5065 726d 6973 7369 6f6e . Permission │ │ │ │ │ +00000660: 2069 7320 6772 616e 7465 6420 746f 2063 is granted to c │ │ │ │ │ +00000670: 6f70 792c 2064 6973 7472 6962 7574 6520 opy, distribute │ │ │ │ │ +00000680: 616e 642f 6f72 206d 6f64 6966 7920 7468 and/or modify th │ │ │ │ │ +00000690: 6973 0a20 2020 2020 646f 6375 6d65 6e74 is. document │ │ │ │ │ +000006a0: 2075 6e64 6572 2074 6865 2074 6572 6d73 under the terms │ │ │ │ │ +000006b0: 206f 6620 7468 6520 474e 5520 4672 6565 of the GNU Free │ │ │ │ │ +000006c0: 2044 6f63 756d 656e 7461 7469 6f6e 204c Documentation L │ │ │ │ │ +000006d0: 6963 656e 7365 2c0a 2020 2020 2056 6572 icense,. Ver │ │ │ │ │ +000006e0: 7369 6f6e 2031 2e32 206f 7220 616e 7920 sion 1.2 or any │ │ │ │ │ +000006f0: 6c61 7465 7220 7665 7273 696f 6e20 7075 later version pu │ │ │ │ │ +00000700: 626c 6973 6865 6420 6279 2074 6865 2046 blished by the F │ │ │ │ │ +00000710: 7265 6520 536f 6674 7761 7265 0a20 2020 ree Software. │ │ │ │ │ +00000720: 2020 466f 756e 6461 7469 6f6e 3b20 7769 Foundation; wi │ │ │ │ │ +00000730: 7468 206e 6f20 496e 7661 7269 616e 7420 th no Invariant │ │ │ │ │ +00000740: 5365 6374 696f 6e73 2e0a 0a2a 204d 656e Sections...* Men │ │ │ │ │ +00000750: 753a 0a0a 2a20 496e 7472 6f64 7563 7469 u:..* Introducti │ │ │ │ │ +00000760: 6f6e 3a3a 2020 2020 2020 2020 2020 2020 on:: │ │ │ │ │ +00000770: 2020 2020 4361 7074 7572 696e 6720 7468 Capturing th │ │ │ │ │ +00000780: 6520 7370 6972 6974 206f 6620 4752 5542 e spirit of GRUB │ │ │ │ │ +00000790: 0a2a 204e 616d 696e 6720 636f 6e76 656e .* Naming conven │ │ │ │ │ +000007a0: 7469 6f6e 3a3a 2020 2020 2020 2020 2020 tion:: │ │ │ │ │ +000007b0: 204e 616d 6573 206f 6620 796f 7572 2064 Names of your d │ │ │ │ │ +000007c0: 7269 7665 7320 696e 2047 5255 420a 2a20 rives in GRUB.* │ │ │ │ │ +000007d0: 4f53 2d73 7065 6369 6669 6320 6e6f 7465 OS-specific note │ │ │ │ │ +000007e0: 7320 6162 6f75 7420 6772 7562 2074 6f6f s about grub too │ │ │ │ │ +000007f0: 6c73 3a3a 0a20 2020 2020 2020 2020 2020 ls::. │ │ │ │ │ 00000800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000810: 2020 2053 6f6d 6520 6e6f 7465 7320 6162 Some notes ab │ │ │ │ │ -00000820: 6f75 7420 4f53 2d73 7065 6369 6669 6320 out OS-specific │ │ │ │ │ -00000830: 6265 6861 7669 6f75 7220 6f66 2047 5255 behaviour of GRU │ │ │ │ │ -00000840: 420a 2020 2020 2020 2020 2020 2020 2020 B. │ │ │ │ │ +00000810: 2020 2020 2053 6f6d 6520 6e6f 7465 7320 Some notes │ │ │ │ │ +00000820: 6162 6f75 7420 4f53 2d73 7065 6369 6669 about OS-specifi │ │ │ │ │ +00000830: 6320 6265 6861 7669 6f75 7220 6f66 2047 c behaviour of G │ │ │ │ │ +00000840: 5255 420a 2020 2020 2020 2020 2020 2020 RUB. │ │ │ │ │ 00000850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000860: 2020 746f 6f6c 730a 2a20 496e 7374 616c tools.* Instal │ │ │ │ │ -00000870: 6c61 7469 6f6e 3a3a 2020 2020 2020 2020 lation:: │ │ │ │ │ -00000880: 2020 2020 2020 2020 496e 7374 616c 6c69 Installi │ │ │ │ │ -00000890: 6e67 2047 5255 4220 6f6e 2079 6f75 7220 ng GRUB on your │ │ │ │ │ -000008a0: 6472 6976 650a 2a20 426f 6f74 696e 673a drive.* Booting: │ │ │ │ │ -000008b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000008c0: 2020 2020 2020 486f 7720 746f 2062 6f6f How to boo │ │ │ │ │ -000008d0: 7420 6469 6666 6572 656e 7420 6f70 6572 t different oper │ │ │ │ │ -000008e0: 6174 696e 6720 7379 7374 656d 730a 2a20 ating systems.* │ │ │ │ │ -000008f0: 436f 6e66 6967 7572 6174 696f 6e3a 3a20 Configuration:: │ │ │ │ │ -00000900: 2020 2020 2020 2020 2020 2020 2020 5772 Wr │ │ │ │ │ -00000910: 6974 696e 6720 796f 7572 206f 776e 2063 iting your own c │ │ │ │ │ -00000920: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ │ -00000930: 650a 2a20 5468 656d 6520 6669 6c65 2066 e.* Theme file f │ │ │ │ │ -00000940: 6f72 6d61 743a 3a20 2020 2020 2020 2020 ormat:: │ │ │ │ │ -00000950: 2020 466f 726d 6174 206f 6620 4752 5542 Format of GRUB │ │ │ │ │ -00000960: 2074 6865 6d65 2066 696c 6573 0a2a 204e theme files.* N │ │ │ │ │ -00000970: 6574 776f 726b 3a3a 2020 2020 2020 2020 etwork:: │ │ │ │ │ -00000980: 2020 2020 2020 2020 2020 2020 2044 6f77 Dow │ │ │ │ │ -00000990: 6e6c 6f61 6469 6e67 204f 5320 696d 6167 nloading OS imag │ │ │ │ │ -000009a0: 6573 2066 726f 6d20 6120 6e65 7477 6f72 es from a networ │ │ │ │ │ -000009b0: 6b0a 2a20 5365 7269 616c 2074 6572 6d69 k.* Serial termi │ │ │ │ │ -000009c0: 6e61 6c3a 3a20 2020 2020 2020 2020 2020 nal:: │ │ │ │ │ -000009d0: 2020 5573 696e 6720 4752 5542 2076 6961 Using GRUB via │ │ │ │ │ -000009e0: 2061 2073 6572 6961 6c20 6c69 6e65 0a2a a serial line.* │ │ │ │ │ -000009f0: 2056 656e 646f 7220 706f 7765 722d 6f6e Vendor power-on │ │ │ │ │ -00000a00: 206b 6579 733a 3a20 2020 2020 2020 2043 keys:: C │ │ │ │ │ -00000a10: 6861 6e67 696e 6720 4752 5542 2062 6568 hanging GRUB beh │ │ │ │ │ -00000a20: 6176 696f 7572 206f 6e20 7665 6e64 6f72 aviour on vendor │ │ │ │ │ -00000a30: 2070 6f77 6572 2d6f 6e20 6b65 7973 0a2a power-on keys.* │ │ │ │ │ -00000a40: 2049 6d61 6765 733a 3a20 2020 2020 2020 Images:: │ │ │ │ │ -00000a50: 2020 2020 2020 2020 2020 2020 2020 2047 G │ │ │ │ │ -00000a60: 5255 4220 696d 6167 6520 6669 6c65 730a RUB image files. │ │ │ │ │ -00000a70: 2a20 436f 7265 2069 6d61 6765 2073 697a * Core image siz │ │ │ │ │ -00000a80: 6520 6c69 6d69 7461 7469 6f6e 3a3a 2020 e limitation:: │ │ │ │ │ -00000a90: 4752 5542 2069 6d61 6765 2066 696c 6573 GRUB image files │ │ │ │ │ -00000aa0: 2073 697a 6520 6c69 6d69 7461 7469 6f6e size limitation │ │ │ │ │ -00000ab0: 730a 2a20 4669 6c65 7379 7374 656d 3a3a s.* Filesystem:: │ │ │ │ │ -00000ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ad0: 2020 4669 6c65 7379 7374 656d 2073 796e Filesystem syn │ │ │ │ │ -00000ae0: 7461 7820 616e 6420 7365 6d61 6e74 6963 tax and semantic │ │ │ │ │ -00000af0: 730a 2a20 496e 7465 7266 6163 653a 3a20 s.* Interface:: │ │ │ │ │ -00000b00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000b10: 2020 5468 6520 6d65 6e75 2061 6e64 2074 The menu and t │ │ │ │ │ -00000b20: 6865 2063 6f6d 6d61 6e64 2d6c 696e 650a he command-line. │ │ │ │ │ -00000b30: 2a20 456e 7669 726f 6e6d 656e 743a 3a20 * Environment:: │ │ │ │ │ -00000b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000b50: 4752 5542 2065 6e76 6972 6f6e 6d65 6e74 GRUB environment │ │ │ │ │ -00000b60: 2076 6172 6961 626c 6573 0a2a 2043 6f6d variables.* Com │ │ │ │ │ -00000b70: 6d61 6e64 733a 3a20 2020 2020 2020 2020 mands:: │ │ │ │ │ -00000b80: 2020 2020 2020 2020 2020 2054 6865 206c The l │ │ │ │ │ -00000b90: 6973 7420 6f66 2061 7661 696c 6162 6c65 ist of available │ │ │ │ │ -00000ba0: 2062 7569 6c74 696e 2063 6f6d 6d61 6e64 builtin command │ │ │ │ │ -00000bb0: 730a 2a20 496e 7465 726e 6174 696f 6e61 s.* Internationa │ │ │ │ │ -00000bc0: 6c69 7361 7469 6f6e 3a3a 2020 2020 2020 lisation:: │ │ │ │ │ -00000bd0: 2020 546f 7069 6373 2072 656c 6174 696e Topics relatin │ │ │ │ │ -00000be0: 6720 746f 206c 616e 6775 6167 6520 7375 g to language su │ │ │ │ │ -00000bf0: 7070 6f72 740a 2a20 5365 6375 7269 7479 pport.* Security │ │ │ │ │ -00000c00: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00000c10: 2020 2020 2020 4175 7468 656e 7469 6361 Authentica │ │ │ │ │ -00000c20: 7469 6f6e 2c20 6175 7468 6f72 6973 6174 tion, authorisat │ │ │ │ │ -00000c30: 696f 6e2c 2061 6e64 2073 6967 6e61 7475 ion, and signatu │ │ │ │ │ -00000c40: 7265 730a 2a20 506c 6174 666f 726d 206c res.* Platform l │ │ │ │ │ -00000c50: 696d 6974 6174 696f 6e73 3a3a 2020 2020 imitations:: │ │ │ │ │ -00000c60: 2020 2020 5468 6520 6c69 7374 206f 6620 The list of │ │ │ │ │ -00000c70: 706c 6174 666f 726d 2d73 7065 6369 6669 platform-specifi │ │ │ │ │ -00000c80: 6320 6c69 6d69 7461 7469 6f6e 730a 2a20 c limitations.* │ │ │ │ │ -00000c90: 506c 6174 666f 726d 2d73 7065 6369 6669 Platform-specifi │ │ │ │ │ -00000ca0: 6320 6f70 6572 6174 696f 6e73 3a3a 2050 c operations:: P │ │ │ │ │ -00000cb0: 6c61 7466 6f72 6d2d 7370 6563 6966 6963 latform-specific │ │ │ │ │ -00000cc0: 206f 7065 7261 7469 6f6e 730a 2a20 5375 operations.* Su │ │ │ │ │ -00000cd0: 7070 6f72 7465 6420 6b65 726e 656c 733a pported kernels: │ │ │ │ │ -00000ce0: 3a20 2020 2020 2020 2020 2020 5468 6520 : The │ │ │ │ │ -00000cf0: 6c69 7374 206f 6620 7375 7070 6f72 7465 list of supporte │ │ │ │ │ -00000d00: 6420 6b65 726e 656c 730a 2a20 5472 6f75 d kernels.* Trou │ │ │ │ │ -00000d10: 626c 6573 686f 6f74 696e 673a 3a20 2020 bleshooting:: │ │ │ │ │ -00000d20: 2020 2020 2020 2020 2020 4572 726f 7220 Error │ │ │ │ │ -00000d30: 6d65 7373 6167 6573 2070 726f 6475 6365 messages produce │ │ │ │ │ -00000d40: 6420 6279 2047 5255 420a 2a20 496e 766f d by GRUB.* Invo │ │ │ │ │ -00000d50: 6b69 6e67 2067 7275 622d 696e 7374 616c king grub-instal │ │ │ │ │ -00000d60: 6c3a 3a20 2020 2020 2020 486f 7720 746f l:: How to │ │ │ │ │ -00000d70: 2075 7365 2074 6865 2047 5255 4220 696e use the GRUB in │ │ │ │ │ -00000d80: 7374 616c 6c65 720a 2a20 496e 766f 6b69 staller.* Invoki │ │ │ │ │ -00000d90: 6e67 2067 7275 622d 6d6b 636f 6e66 6967 ng grub-mkconfig │ │ │ │ │ -00000da0: 3a3a 2020 2020 2020 4765 6e65 7261 7465 :: Generate │ │ │ │ │ -00000db0: 2061 2047 5255 4220 636f 6e66 6967 7572 a GRUB configur │ │ │ │ │ -00000dc0: 6174 696f 6e20 6669 6c65 0a2a 2049 6e76 ation file.* Inv │ │ │ │ │ -00000dd0: 6f6b 696e 6720 6772 7562 2d6d 6b70 6173 oking grub-mkpas │ │ │ │ │ -00000de0: 7377 642d 7062 6b64 6632 3a3a 0a20 2020 swd-pbkdf2::. │ │ │ │ │ +00000860: 2020 2020 746f 6f6c 730a 2a20 496e 7374 tools.* Inst │ │ │ │ │ +00000870: 616c 6c61 7469 6f6e 3a3a 2020 2020 2020 allation:: │ │ │ │ │ +00000880: 2020 2020 2020 2020 2020 496e 7374 616c Instal │ │ │ │ │ +00000890: 6c69 6e67 2047 5255 4220 6f6e 2079 6f75 ling GRUB on you │ │ │ │ │ +000008a0: 7220 6472 6976 650a 2a20 426f 6f74 696e r drive.* Bootin │ │ │ │ │ +000008b0: 673a 3a20 2020 2020 2020 2020 2020 2020 g:: │ │ │ │ │ +000008c0: 2020 2020 2020 2020 486f 7720 746f 2062 How to b │ │ │ │ │ +000008d0: 6f6f 7420 6469 6666 6572 656e 7420 6f70 oot different op │ │ │ │ │ +000008e0: 6572 6174 696e 6720 7379 7374 656d 730a erating systems. │ │ │ │ │ +000008f0: 2a20 436f 6e66 6967 7572 6174 696f 6e3a * Configuration: │ │ │ │ │ +00000900: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00000910: 5772 6974 696e 6720 796f 7572 206f 776e Writing your own │ │ │ │ │ +00000920: 2063 6f6e 6669 6775 7261 7469 6f6e 2066 configuration f │ │ │ │ │ +00000930: 696c 650a 2a20 5468 656d 6520 6669 6c65 ile.* Theme file │ │ │ │ │ +00000940: 2066 6f72 6d61 743a 3a20 2020 2020 2020 format:: │ │ │ │ │ +00000950: 2020 2020 466f 726d 6174 206f 6620 4752 Format of GR │ │ │ │ │ +00000960: 5542 2074 6865 6d65 2066 696c 6573 0a2a UB theme files.* │ │ │ │ │ +00000970: 204e 6574 776f 726b 3a3a 2020 2020 2020 Network:: │ │ │ │ │ +00000980: 2020 2020 2020 2020 2020 2020 2020 2044 D │ │ │ │ │ +00000990: 6f77 6e6c 6f61 6469 6e67 204f 5320 696d ownloading OS im │ │ │ │ │ +000009a0: 6167 6573 2066 726f 6d20 6120 6e65 7477 ages from a netw │ │ │ │ │ +000009b0: 6f72 6b0a 2a20 5365 7269 616c 2074 6572 ork.* Serial ter │ │ │ │ │ +000009c0: 6d69 6e61 6c3a 3a20 2020 2020 2020 2020 minal:: │ │ │ │ │ +000009d0: 2020 2020 5573 696e 6720 4752 5542 2076 Using GRUB v │ │ │ │ │ +000009e0: 6961 2061 2073 6572 6961 6c20 6c69 6e65 ia a serial line │ │ │ │ │ +000009f0: 0a2a 2056 656e 646f 7220 706f 7765 722d .* Vendor power- │ │ │ │ │ +00000a00: 6f6e 206b 6579 733a 3a20 2020 2020 2020 on keys:: │ │ │ │ │ +00000a10: 2043 6861 6e67 696e 6720 4752 5542 2062 Changing GRUB b │ │ │ │ │ +00000a20: 6568 6176 696f 7572 206f 6e20 7665 6e64 ehaviour on vend │ │ │ │ │ +00000a30: 6f72 2070 6f77 6572 2d6f 6e20 6b65 7973 or power-on keys │ │ │ │ │ +00000a40: 0a2a 2049 6d61 6765 733a 3a20 2020 2020 .* Images:: │ │ │ │ │ +00000a50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00000a60: 2047 5255 4220 696d 6167 6520 6669 6c65 GRUB image file │ │ │ │ │ +00000a70: 730a 2a20 436f 7265 2069 6d61 6765 2073 s.* Core image s │ │ │ │ │ +00000a80: 697a 6520 6c69 6d69 7461 7469 6f6e 3a3a ize limitation:: │ │ │ │ │ +00000a90: 2020 4752 5542 2069 6d61 6765 2066 696c GRUB image fil │ │ │ │ │ +00000aa0: 6573 2073 697a 6520 6c69 6d69 7461 7469 es size limitati │ │ │ │ │ +00000ab0: 6f6e 730a 2a20 4669 6c65 7379 7374 656d ons.* Filesystem │ │ │ │ │ +00000ac0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +00000ad0: 2020 2020 4669 6c65 7379 7374 656d 2073 Filesystem s │ │ │ │ │ +00000ae0: 796e 7461 7820 616e 6420 7365 6d61 6e74 yntax and semant │ │ │ │ │ +00000af0: 6963 730a 2a20 496e 7465 7266 6163 653a ics.* Interface: │ │ │ │ │ +00000b00: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00000b10: 2020 2020 5468 6520 6d65 6e75 2061 6e64 The menu and │ │ │ │ │ +00000b20: 2074 6865 2063 6f6d 6d61 6e64 2d6c 696e the command-lin │ │ │ │ │ +00000b30: 650a 2a20 456e 7669 726f 6e6d 656e 743a e.* Environment: │ │ │ │ │ +00000b40: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00000b50: 2020 4752 5542 2065 6e76 6972 6f6e 6d65 GRUB environme │ │ │ │ │ +00000b60: 6e74 2076 6172 6961 626c 6573 0a2a 2043 nt variables.* C │ │ │ │ │ +00000b70: 6f6d 6d61 6e64 733a 3a20 2020 2020 2020 ommands:: │ │ │ │ │ +00000b80: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ +00000b90: 206c 6973 7420 6f66 2061 7661 696c 6162 list of availab │ │ │ │ │ +00000ba0: 6c65 2062 7569 6c74 696e 2063 6f6d 6d61 le builtin comma │ │ │ │ │ +00000bb0: 6e64 730a 2a20 496e 7465 726e 6174 696f nds.* Internatio │ │ │ │ │ +00000bc0: 6e61 6c69 7361 7469 6f6e 3a3a 2020 2020 nalisation:: │ │ │ │ │ +00000bd0: 2020 2020 546f 7069 6373 2072 656c 6174 Topics relat │ │ │ │ │ +00000be0: 696e 6720 746f 206c 616e 6775 6167 6520 ing to language │ │ │ │ │ +00000bf0: 7375 7070 6f72 740a 2a20 5365 6375 7269 support.* Securi │ │ │ │ │ +00000c00: 7479 3a3a 2020 2020 2020 2020 2020 2020 ty:: │ │ │ │ │ +00000c10: 2020 2020 2020 2020 4175 7468 656e 7469 Authenti │ │ │ │ │ +00000c20: 6361 7469 6f6e 2c20 6175 7468 6f72 6973 cation, authoris │ │ │ │ │ +00000c30: 6174 696f 6e2c 2061 6e64 2073 6967 6e61 ation, and signa │ │ │ │ │ +00000c40: 7475 7265 730a 2a20 506c 6174 666f 726d tures.* Platform │ │ │ │ │ +00000c50: 206c 696d 6974 6174 696f 6e73 3a3a 2020 limitations:: │ │ │ │ │ +00000c60: 2020 2020 2020 5468 6520 6c69 7374 206f The list o │ │ │ │ │ +00000c70: 6620 706c 6174 666f 726d 2d73 7065 6369 f platform-speci │ │ │ │ │ +00000c80: 6669 6320 6c69 6d69 7461 7469 6f6e 730a fic limitations. │ │ │ │ │ +00000c90: 2a20 506c 6174 666f 726d 2d73 7065 6369 * Platform-speci │ │ │ │ │ +00000ca0: 6669 6320 6f70 6572 6174 696f 6e73 3a3a fic operations:: │ │ │ │ │ +00000cb0: 2050 6c61 7466 6f72 6d2d 7370 6563 6966 Platform-specif │ │ │ │ │ +00000cc0: 6963 206f 7065 7261 7469 6f6e 730a 2a20 ic operations.* │ │ │ │ │ +00000cd0: 5375 7070 6f72 7465 6420 6b65 726e 656c Supported kernel │ │ │ │ │ +00000ce0: 733a 3a20 2020 2020 2020 2020 2020 5468 s:: Th │ │ │ │ │ +00000cf0: 6520 6c69 7374 206f 6620 7375 7070 6f72 e list of suppor │ │ │ │ │ +00000d00: 7465 6420 6b65 726e 656c 730a 2a20 5472 ted kernels.* Tr │ │ │ │ │ +00000d10: 6f75 626c 6573 686f 6f74 696e 673a 3a20 oubleshooting:: │ │ │ │ │ +00000d20: 2020 2020 2020 2020 2020 2020 4572 726f Erro │ │ │ │ │ +00000d30: 7220 6d65 7373 6167 6573 2070 726f 6475 r messages produ │ │ │ │ │ +00000d40: 6365 6420 6279 2047 5255 420a 2a20 496e ced by GRUB.* In │ │ │ │ │ +00000d50: 766f 6b69 6e67 2067 7275 622d 696e 7374 voking grub-inst │ │ │ │ │ +00000d60: 616c 6c3a 3a20 2020 2020 2020 486f 7720 all:: How │ │ │ │ │ +00000d70: 746f 2075 7365 2074 6865 2047 5255 4220 to use the GRUB │ │ │ │ │ +00000d80: 696e 7374 616c 6c65 720a 2a20 496e 766f installer.* Invo │ │ │ │ │ +00000d90: 6b69 6e67 2067 7275 622d 6d6b 636f 6e66 king grub-mkconf │ │ │ │ │ +00000da0: 6967 3a3a 2020 2020 2020 4765 6e65 7261 ig:: Genera │ │ │ │ │ +00000db0: 7465 2061 2047 5255 4220 636f 6e66 6967 te a GRUB config │ │ │ │ │ +00000dc0: 7572 6174 696f 6e20 6669 6c65 0a2a 2049 uration file.* I │ │ │ │ │ +00000dd0: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b70 nvoking grub-mkp │ │ │ │ │ +00000de0: 6173 7377 642d 7062 6b64 6632 3a3a 0a20 asswd-pbkdf2::. │ │ │ │ │ 00000df0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000e00: 2020 2020 2020 2020 2020 2020 2047 656e Gen │ │ │ │ │ -00000e10: 6572 6174 6520 4752 5542 2070 6173 7377 erate GRUB passw │ │ │ │ │ -00000e20: 6f72 6420 6861 7368 6573 0a2a 2049 6e76 ord hashes.* Inv │ │ │ │ │ -00000e30: 6f6b 696e 6720 6772 7562 2d6d 6b72 656c oking grub-mkrel │ │ │ │ │ -00000e40: 7061 7468 3a3a 2020 2020 204d 616b 6520 path:: Make │ │ │ │ │ -00000e50: 7379 7374 656d 2070 6174 6820 7265 6c61 system path rela │ │ │ │ │ -00000e60: 7469 7665 2074 6f20 6974 7320 726f 6f74 tive to its root │ │ │ │ │ -00000e70: 0a2a 2049 6e76 6f6b 696e 6720 6772 7562 .* Invoking grub │ │ │ │ │ -00000e80: 2d6d 6b72 6573 6375 653a 3a20 2020 2020 -mkrescue:: │ │ │ │ │ -00000e90: 204d 616b 6520 6120 4752 5542 2072 6573 Make a GRUB res │ │ │ │ │ -00000ea0: 6375 6520 696d 6167 650a 2a20 496e 766f cue image.* Invo │ │ │ │ │ -00000eb0: 6b69 6e67 2067 7275 622d 6d6f 756e 743a king grub-mount: │ │ │ │ │ -00000ec0: 3a20 2020 2020 2020 2020 4d6f 756e 7420 : Mount │ │ │ │ │ -00000ed0: 6120 6669 6c65 2073 7973 7465 6d20 7573 a file system us │ │ │ │ │ -00000ee0: 696e 6720 4752 5542 0a2a 2049 6e76 6f6b ing GRUB.* Invok │ │ │ │ │ -00000ef0: 696e 6720 6772 7562 2d70 726f 6265 3a3a ing grub-probe:: │ │ │ │ │ -00000f00: 2020 2020 2020 2020 2050 726f 6265 2064 Probe d │ │ │ │ │ -00000f10: 6576 6963 6520 696e 666f 726d 6174 696f evice informatio │ │ │ │ │ -00000f20: 6e20 666f 7220 4752 5542 0a2a 2049 6e76 n for GRUB.* Inv │ │ │ │ │ -00000f30: 6f6b 696e 6720 6772 7562 2d73 6372 6970 oking grub-scrip │ │ │ │ │ -00000f40: 742d 6368 6563 6b3a 3a20 2043 6865 636b t-check:: Check │ │ │ │ │ -00000f50: 2047 5255 4220 7363 7269 7074 2066 696c GRUB script fil │ │ │ │ │ -00000f60: 6520 666f 7220 7379 6e74 6178 2065 7272 e for syntax err │ │ │ │ │ -00000f70: 6f72 730a 2a20 4f62 7461 696e 696e 6720 ors.* Obtaining │ │ │ │ │ -00000f80: 616e 6420 4275 696c 6469 6e67 2047 5255 and Building GRU │ │ │ │ │ -00000f90: 423a 3a20 486f 7720 746f 206f 6274 6169 B:: How to obtai │ │ │ │ │ -00000fa0: 6e20 616e 6420 6275 696c 6420 4752 5542 n and build GRUB │ │ │ │ │ -00000fb0: 0a2a 2052 6570 6f72 7469 6e67 2062 7567 .* Reporting bug │ │ │ │ │ -00000fc0: 733a 3a20 2020 2020 2020 2020 2020 2020 s:: │ │ │ │ │ -00000fd0: 2057 6865 7265 2079 6f75 2073 686f 756c Where you shoul │ │ │ │ │ -00000fe0: 6420 7365 6e64 2061 2062 7567 2072 6570 d send a bug rep │ │ │ │ │ -00000ff0: 6f72 740a 2a20 4675 7475 7265 3a3a 2020 ort.* Future:: │ │ │ │ │ +00000e00: 2020 2020 2020 2020 2020 2020 2020 2047 G │ │ │ │ │ +00000e10: 656e 6572 6174 6520 4752 5542 2070 6173 enerate GRUB pas │ │ │ │ │ +00000e20: 7377 6f72 6420 6861 7368 6573 0a2a 2049 sword hashes.* I │ │ │ │ │ +00000e30: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000e40: 656c 7061 7468 3a3a 2020 2020 204d 616b elpath:: Mak │ │ │ │ │ +00000e50: 6520 7379 7374 656d 2070 6174 6820 7265 e system path re │ │ │ │ │ +00000e60: 6c61 7469 7665 2074 6f20 6974 7320 726f lative to its ro │ │ │ │ │ +00000e70: 6f74 0a2a 2049 6e76 6f6b 696e 6720 6772 ot.* Invoking gr │ │ │ │ │ +00000e80: 7562 2d6d 6b72 6573 6375 653a 3a20 2020 ub-mkrescue:: │ │ │ │ │ +00000e90: 2020 204d 616b 6520 6120 4752 5542 2072 Make a GRUB r │ │ │ │ │ +00000ea0: 6573 6375 6520 696d 6167 650a 2a20 496e escue image.* In │ │ │ │ │ +00000eb0: 766f 6b69 6e67 2067 7275 622d 6d6f 756e voking grub-moun │ │ │ │ │ +00000ec0: 743a 3a20 2020 2020 2020 2020 4d6f 756e t:: Moun │ │ │ │ │ +00000ed0: 7420 6120 6669 6c65 2073 7973 7465 6d20 t a file system │ │ │ │ │ +00000ee0: 7573 696e 6720 4752 5542 0a2a 2049 6e76 using GRUB.* Inv │ │ │ │ │ +00000ef0: 6f6b 696e 6720 6772 7562 2d70 726f 6265 oking grub-probe │ │ │ │ │ +00000f00: 3a3a 2020 2020 2020 2020 2050 726f 6265 :: Probe │ │ │ │ │ +00000f10: 2064 6576 6963 6520 696e 666f 726d 6174 device informat │ │ │ │ │ +00000f20: 696f 6e20 666f 7220 4752 5542 0a2a 2049 ion for GRUB.* I │ │ │ │ │ +00000f30: 6e76 6f6b 696e 6720 6772 7562 2d73 6372 nvoking grub-scr │ │ │ │ │ +00000f40: 6970 742d 6368 6563 6b3a 3a20 2043 6865 ipt-check:: Che │ │ │ │ │ +00000f50: 636b 2047 5255 4220 7363 7269 7074 2066 ck GRUB script f │ │ │ │ │ +00000f60: 696c 6520 666f 7220 7379 6e74 6178 2065 ile for syntax e │ │ │ │ │ +00000f70: 7272 6f72 730a 2a20 4f62 7461 696e 696e rrors.* Obtainin │ │ │ │ │ +00000f80: 6720 616e 6420 4275 696c 6469 6e67 2047 g and Building G │ │ │ │ │ +00000f90: 5255 423a 3a20 486f 7720 746f 206f 6274 RUB:: How to obt │ │ │ │ │ +00000fa0: 6169 6e20 616e 6420 6275 696c 6420 4752 ain and build GR │ │ │ │ │ +00000fb0: 5542 0a2a 2052 6570 6f72 7469 6e67 2062 UB.* Reporting b │ │ │ │ │ +00000fc0: 7567 733a 3a20 2020 2020 2020 2020 2020 ugs:: │ │ │ │ │ +00000fd0: 2020 2057 6865 7265 2079 6f75 2073 686f Where you sho │ │ │ │ │ +00000fe0: 756c 6420 7365 6e64 2061 2062 7567 2072 uld send a bug r │ │ │ │ │ +00000ff0: 6570 6f72 740a 2a20 4675 7475 7265 3a3a eport.* Future:: │ │ │ │ │ 00001000: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001010: 2020 2020 536f 6d65 2066 7574 7572 6520 Some future │ │ │ │ │ -00001020: 706c 616e 7320 6f6e 2047 5255 420a 2a20 plans on GRUB.* │ │ │ │ │ -00001030: 436f 7079 696e 6720 5468 6973 204d 616e Copying This Man │ │ │ │ │ -00001040: 7561 6c3a 3a20 2020 2020 2020 2020 436f ual:: Co │ │ │ │ │ -00001050: 7079 696e 6720 5468 6973 204d 616e 7561 pying This Manua │ │ │ │ │ -00001060: 6c0a 2a20 496e 6465 783a 3a0a 0a1f 0a46 l.* Index::....F │ │ │ │ │ -00001070: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -00001080: 204e 6f64 653a 2049 6e74 726f 6475 6374 Node: Introduct │ │ │ │ │ -00001090: 696f 6e2c 2020 4e65 7874 3a20 4e61 6d69 ion, Next: Nami │ │ │ │ │ -000010a0: 6e67 2063 6f6e 7665 6e74 696f 6e2c 2020 ng convention, │ │ │ │ │ -000010b0: 5072 6576 3a20 546f 702c 2020 5570 3a20 Prev: Top, Up: │ │ │ │ │ -000010c0: 546f 700a 0a31 2049 6e74 726f 6475 6374 Top..1 Introduct │ │ │ │ │ -000010d0: 696f 6e20 746f 2047 5255 420a 2a2a 2a2a ion to GRUB.**** │ │ │ │ │ +00001010: 2020 2020 2020 536f 6d65 2066 7574 7572 Some futur │ │ │ │ │ +00001020: 6520 706c 616e 7320 6f6e 2047 5255 420a e plans on GRUB. │ │ │ │ │ +00001030: 2a20 436f 7079 696e 6720 5468 6973 204d * Copying This M │ │ │ │ │ +00001040: 616e 7561 6c3a 3a20 2020 2020 2020 2020 anual:: │ │ │ │ │ +00001050: 436f 7079 696e 6720 5468 6973 204d 616e Copying This Man │ │ │ │ │ +00001060: 7561 6c0a 2a20 496e 6465 783a 3a0a 0a1f ual.* Index::... │ │ │ │ │ +00001070: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +00001080: 2c20 204e 6f64 653a 2049 6e74 726f 6475 , Node: Introdu │ │ │ │ │ +00001090: 6374 696f 6e2c 2020 4e65 7874 3a20 4e61 ction, Next: Na │ │ │ │ │ +000010a0: 6d69 6e67 2063 6f6e 7665 6e74 696f 6e2c ming convention, │ │ │ │ │ +000010b0: 2020 5072 6576 3a20 546f 702c 2020 5570 Prev: Top, Up │ │ │ │ │ +000010c0: 3a20 546f 700a 0a31 2049 6e74 726f 6475 : Top..1 Introdu │ │ │ │ │ +000010d0: 6374 696f 6e20 746f 2047 5255 420a 2a2a ction to GRUB.** │ │ │ │ │ 000010e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000010f0: 2a2a 0a0a 2a20 4d65 6e75 3a0a 0a2a 204f **..* Menu:..* O │ │ │ │ │ -00001100: 7665 7276 6965 773a 3a20 2020 2020 2020 verview:: │ │ │ │ │ -00001110: 2020 2020 2020 2020 2020 2020 2057 6861 Wha │ │ │ │ │ -00001120: 7420 6578 6163 746c 7920 4752 5542 2069 t exactly GRUB i │ │ │ │ │ -00001130: 7320 616e 6420 686f 7720 746f 2075 7365 s and how to use │ │ │ │ │ -00001140: 2069 740a 2a20 4869 7374 6f72 793a 3a20 it.* History:: │ │ │ │ │ -00001150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001160: 2020 2020 4672 6f6d 206d 6167 676f 7420 From maggot │ │ │ │ │ -00001170: 746f 2068 6f75 7365 2066 6c79 0a2a 2043 to house fly.* C │ │ │ │ │ -00001180: 6861 6e67 6573 2066 726f 6d20 4752 5542 hanges from GRUB │ │ │ │ │ -00001190: 204c 6567 6163 793a 3a20 2020 2044 6966 Legacy:: Dif │ │ │ │ │ -000011a0: 6665 7265 6e63 6573 2066 726f 6d20 7072 ferences from pr │ │ │ │ │ -000011b0: 6576 696f 7573 2076 6572 7369 6f6e 730a evious versions. │ │ │ │ │ -000011c0: 2a20 4665 6174 7572 6573 3a3a 2020 2020 * Features:: │ │ │ │ │ +000010f0: 2a2a 2a2a 0a0a 2a20 4d65 6e75 3a0a 0a2a ****..* Menu:..* │ │ │ │ │ +00001100: 204f 7665 7276 6965 773a 3a20 2020 2020 Overview:: │ │ │ │ │ +00001110: 2020 2020 2020 2020 2020 2020 2020 2057 W │ │ │ │ │ +00001120: 6861 7420 6578 6163 746c 7920 4752 5542 hat exactly GRUB │ │ │ │ │ +00001130: 2069 7320 616e 6420 686f 7720 746f 2075 is and how to u │ │ │ │ │ +00001140: 7365 2069 740a 2a20 4869 7374 6f72 793a se it.* History: │ │ │ │ │ +00001150: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001160: 2020 2020 2020 4672 6f6d 206d 6167 676f From maggo │ │ │ │ │ +00001170: 7420 746f 2068 6f75 7365 2066 6c79 0a2a t to house fly.* │ │ │ │ │ +00001180: 2043 6861 6e67 6573 2066 726f 6d20 4752 Changes from GR │ │ │ │ │ +00001190: 5542 204c 6567 6163 793a 3a20 2020 2044 UB Legacy:: D │ │ │ │ │ +000011a0: 6966 6665 7265 6e63 6573 2066 726f 6d20 ifferences from │ │ │ │ │ +000011b0: 7072 6576 696f 7573 2076 6572 7369 6f6e previous version │ │ │ │ │ +000011c0: 730a 2a20 4665 6174 7572 6573 3a3a 2020 s.* Features:: │ │ │ │ │ 000011d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000011e0: 4752 5542 2066 6561 7475 7265 730a 2a20 GRUB features.* │ │ │ │ │ -000011f0: 526f 6c65 206f 6620 6120 626f 6f74 206c Role of a boot l │ │ │ │ │ -00001200: 6f61 6465 723a 3a20 2020 2020 2020 5468 oader:: Th │ │ │ │ │ -00001210: 6520 726f 6c65 206f 6620 6120 626f 6f74 e role of a boot │ │ │ │ │ -00001220: 206c 6f61 6465 720a 0a1f 0a46 696c 653a loader....File: │ │ │ │ │ -00001230: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -00001240: 653a 204f 7665 7276 6965 772c 2020 4e65 e: Overview, Ne │ │ │ │ │ -00001250: 7874 3a20 4869 7374 6f72 792c 2020 5570 xt: History, Up │ │ │ │ │ -00001260: 3a20 496e 7472 6f64 7563 7469 6f6e 0a0a : Introduction.. │ │ │ │ │ -00001270: 312e 3120 4f76 6572 7669 6577 0a3d 3d3d 1.1 Overview.=== │ │ │ │ │ -00001280: 3d3d 3d3d 3d3d 3d3d 3d0a 0a42 7269 6566 =========..Brief │ │ │ │ │ -00001290: 6c79 2c20 6120 2262 6f6f 7420 6c6f 6164 ly, a "boot load │ │ │ │ │ -000012a0: 6572 2220 6973 2074 6865 2066 6972 7374 er" is the first │ │ │ │ │ -000012b0: 2073 6f66 7477 6172 6520 7072 6f67 7261 software progra │ │ │ │ │ -000012c0: 6d20 7468 6174 2072 756e 7320 7768 656e m that runs when │ │ │ │ │ -000012d0: 2061 0a63 6f6d 7075 7465 7220 7374 6172 a.computer star │ │ │ │ │ -000012e0: 7473 2e20 2049 7420 6973 2072 6573 706f ts. It is respo │ │ │ │ │ -000012f0: 6e73 6962 6c65 2066 6f72 206c 6f61 6469 nsible for loadi │ │ │ │ │ -00001300: 6e67 2061 6e64 2074 7261 6e73 6665 7272 ng and transferr │ │ │ │ │ -00001310: 696e 6720 636f 6e74 726f 6c0a 746f 2061 ing control.to a │ │ │ │ │ -00001320: 6e20 6f70 6572 6174 696e 6720 7379 7374 n operating syst │ │ │ │ │ -00001330: 656d 2022 6b65 726e 656c 2220 736f 6674 em "kernel" soft │ │ │ │ │ -00001340: 7761 7265 2028 7375 6368 2061 7320 4c69 ware (such as Li │ │ │ │ │ -00001350: 6e75 7820 6f72 2047 4e55 204d 6163 6829 nux or GNU Mach) │ │ │ │ │ -00001360: 2e0a 5468 6520 6b65 726e 656c 2c20 696e ..The kernel, in │ │ │ │ │ -00001370: 2074 7572 6e2c 2069 6e69 7469 616c 697a turn, initializ │ │ │ │ │ -00001380: 6573 2074 6865 2072 6573 7420 6f66 2074 es the rest of t │ │ │ │ │ -00001390: 6865 206f 7065 7261 7469 6e67 2073 7973 he operating sys │ │ │ │ │ -000013a0: 7465 6d20 2865 2e67 2e0a 6120 474e 5520 tem (e.g..a GNU │ │ │ │ │ -000013b0: 7379 7374 656d 292e 0a0a 2020 2047 4e55 system)... GNU │ │ │ │ │ -000013c0: 2047 5255 4220 6973 2061 2076 6572 7920 GRUB is a very │ │ │ │ │ -000013d0: 706f 7765 7266 756c 2062 6f6f 7420 6c6f powerful boot lo │ │ │ │ │ -000013e0: 6164 6572 2c20 7768 6963 6820 6361 6e20 ader, which can │ │ │ │ │ -000013f0: 6c6f 6164 2061 2077 6964 650a 7661 7269 load a wide.vari │ │ │ │ │ -00001400: 6574 7920 6f66 2066 7265 6520 6f70 6572 ety of free oper │ │ │ │ │ -00001410: 6174 696e 6720 7379 7374 656d 732c 2061 ating systems, a │ │ │ │ │ -00001420: 7320 7765 6c6c 2061 7320 7072 6f70 7269 s well as propri │ │ │ │ │ -00001430: 6574 6172 7920 6f70 6572 6174 696e 670a etary operating. │ │ │ │ │ -00001440: 7379 7374 656d 7320 7769 7468 2063 6861 systems with cha │ │ │ │ │ -00001450: 696e 2d6c 6f61 6469 6e67 2831 2920 282a in-loading(1) (* │ │ │ │ │ -00001460: 6e6f 7465 204f 7665 7276 6965 772d 466f note Overview-Fo │ │ │ │ │ -00001470: 6f74 6e6f 7465 2d31 3a3a 292e 2020 4752 otnote-1::). GR │ │ │ │ │ -00001480: 5542 2069 730a 6465 7369 676e 6564 2074 UB is.designed t │ │ │ │ │ -00001490: 6f20 6164 6472 6573 7320 7468 6520 636f o address the co │ │ │ │ │ -000014a0: 6d70 6c65 7869 7479 206f 6620 626f 6f74 mplexity of boot │ │ │ │ │ -000014b0: 696e 6720 6120 7065 7273 6f6e 616c 2063 ing a personal c │ │ │ │ │ -000014c0: 6f6d 7075 7465 723b 2062 6f74 680a 7468 omputer; both.th │ │ │ │ │ -000014d0: 6520 7072 6f67 7261 6d20 616e 6420 7468 e program and th │ │ │ │ │ -000014e0: 6973 206d 616e 7561 6c20 6172 6520 7469 is manual are ti │ │ │ │ │ -000014f0: 6768 746c 7920 626f 756e 6420 746f 2074 ghtly bound to t │ │ │ │ │ -00001500: 6861 7420 636f 6d70 7574 6572 2070 6c61 hat computer pla │ │ │ │ │ -00001510: 7466 6f72 6d2c 0a61 6c74 686f 7567 6820 tform,.although │ │ │ │ │ -00001520: 706f 7274 696e 6720 746f 206f 7468 6572 porting to other │ │ │ │ │ -00001530: 2070 6c61 7466 6f72 6d73 206d 6179 2062 platforms may b │ │ │ │ │ -00001540: 6520 6164 6472 6573 7365 6420 696e 2074 e addressed in t │ │ │ │ │ -00001550: 6865 2066 7574 7572 652e 0a0a 2020 204f he future... O │ │ │ │ │ -00001560: 6e65 206f 6620 7468 6520 696d 706f 7274 ne of the import │ │ │ │ │ -00001570: 616e 7420 6665 6174 7572 6573 2069 6e20 ant features in │ │ │ │ │ -00001580: 4752 5542 2069 7320 666c 6578 6962 696c GRUB is flexibil │ │ │ │ │ -00001590: 6974 793b 2047 5255 420a 756e 6465 7273 ity; GRUB.unders │ │ │ │ │ -000015a0: 7461 6e64 7320 6669 6c65 7379 7374 656d tands filesystem │ │ │ │ │ -000015b0: 7320 616e 6420 6b65 726e 656c 2065 7865 s and kernel exe │ │ │ │ │ -000015c0: 6375 7461 626c 6520 666f 726d 6174 732c cutable formats, │ │ │ │ │ -000015d0: 2073 6f20 796f 7520 6361 6e20 6c6f 6164 so you can load │ │ │ │ │ -000015e0: 0a61 6e20 6172 6269 7472 6172 7920 6f70 .an arbitrary op │ │ │ │ │ -000015f0: 6572 6174 696e 6720 7379 7374 656d 2074 erating system t │ │ │ │ │ -00001600: 6865 2077 6179 2079 6f75 206c 696b 652c he way you like, │ │ │ │ │ -00001610: 2077 6974 686f 7574 2072 6563 6f72 6469 without recordi │ │ │ │ │ -00001620: 6e67 2074 6865 0a70 6879 7369 6361 6c20 ng the.physical │ │ │ │ │ -00001630: 706f 7369 7469 6f6e 206f 6620 796f 7572 position of your │ │ │ │ │ -00001640: 206b 6572 6e65 6c20 6f6e 2074 6865 2064 kernel on the d │ │ │ │ │ -00001650: 6973 6b2e 2020 5468 7573 2079 6f75 2063 isk. Thus you c │ │ │ │ │ -00001660: 616e 206c 6f61 6420 7468 650a 6b65 726e an load the.kern │ │ │ │ │ -00001670: 656c 206a 7573 7420 6279 2073 7065 6369 el just by speci │ │ │ │ │ -00001680: 6679 696e 6720 6974 7320 6669 6c65 206e fying its file n │ │ │ │ │ -00001690: 616d 6520 616e 6420 7468 6520 6472 6976 ame and the driv │ │ │ │ │ -000016a0: 6520 616e 6420 7061 7274 6974 696f 6e0a e and partition. │ │ │ │ │ -000016b0: 7768 6572 6520 7468 6520 6b65 726e 656c where the kernel │ │ │ │ │ -000016c0: 2072 6573 6964 6573 2e0a 0a20 2020 5768 resides... Wh │ │ │ │ │ -000016d0: 656e 2062 6f6f 7469 6e67 2077 6974 6820 en booting with │ │ │ │ │ -000016e0: 4752 5542 2c20 796f 7520 6361 6e20 7573 GRUB, you can us │ │ │ │ │ -000016f0: 6520 6569 7468 6572 2061 2063 6f6d 6d61 e either a comma │ │ │ │ │ -00001700: 6e64 2d6c 696e 6520 696e 7465 7266 6163 nd-line interfac │ │ │ │ │ -00001710: 650a 282a 6e6f 7465 2043 6f6d 6d61 6e64 e.(*note Command │ │ │ │ │ -00001720: 2d6c 696e 6520 696e 7465 7266 6163 653a -line interface: │ │ │ │ │ -00001730: 3a29 2c20 6f72 2061 206d 656e 7520 696e :), or a menu in │ │ │ │ │ -00001740: 7465 7266 6163 6520 282a 6e6f 7465 204d terface (*note M │ │ │ │ │ -00001750: 656e 750a 696e 7465 7266 6163 653a 3a29 enu.interface::) │ │ │ │ │ -00001760: 2e20 2055 7369 6e67 2074 6865 2063 6f6d . Using the com │ │ │ │ │ -00001770: 6d61 6e64 2d6c 696e 6520 696e 7465 7266 mand-line interf │ │ │ │ │ -00001780: 6163 652c 2079 6f75 2074 7970 6520 7468 ace, you type th │ │ │ │ │ -00001790: 6520 6472 6976 650a 7370 6563 6966 6963 e drive.specific │ │ │ │ │ -000017a0: 6174 696f 6e20 616e 6420 6669 6c65 206e ation and file n │ │ │ │ │ -000017b0: 616d 6520 6f66 2074 6865 206b 6572 6e65 ame of the kerne │ │ │ │ │ -000017c0: 6c20 6d61 6e75 616c 6c79 2e20 2049 6e20 l manually. In │ │ │ │ │ -000017d0: 7468 6520 6d65 6e75 0a69 6e74 6572 6661 the menu.interfa │ │ │ │ │ -000017e0: 6365 2c20 796f 7520 6a75 7374 2073 656c ce, you just sel │ │ │ │ │ -000017f0: 6563 7420 616e 204f 5320 7573 696e 6720 ect an OS using │ │ │ │ │ -00001800: 7468 6520 6172 726f 7720 6b65 7973 2e20 the arrow keys. │ │ │ │ │ -00001810: 2054 6865 206d 656e 7520 6973 0a62 6173 The menu is.bas │ │ │ │ │ -00001820: 6564 206f 6e20 6120 636f 6e66 6967 7572 ed on a configur │ │ │ │ │ -00001830: 6174 696f 6e20 6669 6c65 2077 6869 6368 ation file which │ │ │ │ │ -00001840: 2079 6f75 2070 7265 7061 7265 2062 6566 you prepare bef │ │ │ │ │ -00001850: 6f72 6568 616e 6420 282a 6e6f 7465 0a43 orehand (*note.C │ │ │ │ │ -00001860: 6f6e 6669 6775 7261 7469 6f6e 3a3a 292e onfiguration::). │ │ │ │ │ -00001870: 2020 5768 696c 6520 696e 2074 6865 206d While in the m │ │ │ │ │ -00001880: 656e 752c 2079 6f75 2063 616e 2073 7769 enu, you can swi │ │ │ │ │ -00001890: 7463 6820 746f 2074 6865 2063 6f6d 6d61 tch to the comma │ │ │ │ │ -000018a0: 6e64 2d6c 696e 650a 6d6f 6465 2c20 616e nd-line.mode, an │ │ │ │ │ -000018b0: 6420 7669 6365 2d76 6572 7361 2e20 2059 d vice-versa. Y │ │ │ │ │ -000018c0: 6f75 2063 616e 2065 7665 6e20 6564 6974 ou can even edit │ │ │ │ │ -000018d0: 206d 656e 7520 656e 7472 6965 7320 6265 menu entries be │ │ │ │ │ -000018e0: 666f 7265 2075 7369 6e67 2074 6865 6d2e fore using them. │ │ │ │ │ -000018f0: 0a0a 2020 2049 6e20 7468 6520 666f 6c6c .. In the foll │ │ │ │ │ -00001900: 6f77 696e 6720 6368 6170 7465 7273 2c20 owing chapters, │ │ │ │ │ -00001910: 796f 7520 7769 6c6c 206c 6561 726e 2068 you will learn h │ │ │ │ │ -00001920: 6f77 2074 6f20 7370 6563 6966 7920 6120 ow to specify a │ │ │ │ │ -00001930: 6472 6976 652c 2061 0a70 6172 7469 7469 drive, a.partiti │ │ │ │ │ -00001940: 6f6e 2c20 616e 6420 6120 6669 6c65 206e on, and a file n │ │ │ │ │ -00001950: 616d 6520 282a 6e6f 7465 204e 616d 696e ame (*note Namin │ │ │ │ │ -00001960: 6720 636f 6e76 656e 7469 6f6e 3a3a 2920 g convention::) │ │ │ │ │ -00001970: 746f 2047 5255 422c 2068 6f77 2074 6f0a to GRUB, how to. │ │ │ │ │ -00001980: 696e 7374 616c 6c20 4752 5542 206f 6e20 install GRUB on │ │ │ │ │ -00001990: 796f 7572 2064 7269 7665 2028 2a6e 6f74 your drive (*not │ │ │ │ │ -000019a0: 6520 496e 7374 616c 6c61 7469 6f6e 3a3a e Installation:: │ │ │ │ │ -000019b0: 292c 2061 6e64 2068 6f77 2074 6f20 626f ), and how to bo │ │ │ │ │ -000019c0: 6f74 2079 6f75 720a 4f53 6573 2028 2a6e ot your.OSes (*n │ │ │ │ │ -000019d0: 6f74 6520 426f 6f74 696e 673a 3a29 2c20 ote Booting::), │ │ │ │ │ -000019e0: 7374 6570 2062 7920 7374 6570 2e0a 0a1f step by step.... │ │ │ │ │ -000019f0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00001a00: 2c20 204e 6f64 653a 204f 7665 7276 6965 , Node: Overvie │ │ │ │ │ -00001a10: 772d 466f 6f74 6e6f 7465 732c 2020 5570 w-Footnotes, Up │ │ │ │ │ -00001a20: 3a20 4f76 6572 7669 6577 0a0a 2020 2028 : Overview.. ( │ │ │ │ │ -00001a30: 3129 2022 6368 6169 6e2d 6c6f 6164 2220 1) "chain-load" │ │ │ │ │ -00001a40: 6973 2074 6865 206d 6563 6861 6e69 736d is the mechanism │ │ │ │ │ -00001a50: 2066 6f72 206c 6f61 6469 6e67 2075 6e73 for loading uns │ │ │ │ │ -00001a60: 7570 706f 7274 6564 206f 7065 7261 7469 upported operati │ │ │ │ │ -00001a70: 6e67 0a73 7973 7465 6d73 2062 7920 6c6f ng.systems by lo │ │ │ │ │ -00001a80: 6164 696e 6720 616e 6f74 6865 7220 626f ading another bo │ │ │ │ │ -00001a90: 6f74 206c 6f61 6465 722e 2020 4974 2069 ot loader. It i │ │ │ │ │ -00001aa0: 7320 7479 7069 6361 6c6c 7920 7573 6564 s typically used │ │ │ │ │ -00001ab0: 2066 6f72 0a6c 6f61 6469 6e67 2044 4f53 for.loading DOS │ │ │ │ │ -00001ac0: 206f 7220 5769 6e64 6f77 732e 0a0a 1f0a or Windows..... │ │ │ │ │ -00001ad0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -00001ae0: 2020 4e6f 6465 3a20 4869 7374 6f72 792c Node: History, │ │ │ │ │ -00001af0: 2020 4e65 7874 3a20 4368 616e 6765 7320 Next: Changes │ │ │ │ │ -00001b00: 6672 6f6d 2047 5255 4220 4c65 6761 6379 from GRUB Legacy │ │ │ │ │ -00001b10: 2c20 2050 7265 763a 204f 7665 7276 6965 , Prev: Overvie │ │ │ │ │ -00001b20: 772c 2020 5570 3a20 496e 7472 6f64 7563 w, Up: Introduc │ │ │ │ │ -00001b30: 7469 6f6e 0a0a 312e 3220 4869 7374 6f72 tion..1.2 Histor │ │ │ │ │ -00001b40: 7920 6f66 2047 5255 420a 3d3d 3d3d 3d3d y of GRUB.====== │ │ │ │ │ -00001b50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a47 =============..G │ │ │ │ │ -00001b60: 5255 4220 6f72 6967 696e 6174 6564 2069 RUB originated i │ │ │ │ │ -00001b70: 6e20 3139 3935 2077 6865 6e20 4572 6963 n 1995 when Eric │ │ │ │ │ -00001b80: 6820 426f 6c65 796e 2077 6173 2074 7279 h Boleyn was try │ │ │ │ │ -00001b90: 696e 6720 746f 2062 6f6f 7420 7468 6520 ing to boot the │ │ │ │ │ -00001ba0: 474e 550a 4875 7264 2077 6974 6820 7468 GNU.Hurd with th │ │ │ │ │ -00001bb0: 6520 556e 6976 6572 7369 7479 206f 6620 e University of │ │ │ │ │ -00001bc0: 5574 6168 2773 204d 6163 6820 3420 6d69 Utah's Mach 4 mi │ │ │ │ │ -00001bd0: 6372 6f6b 6572 6e65 6c20 286e 6f77 206b crokernel (now k │ │ │ │ │ -00001be0: 6e6f 776e 2061 7320 474e 550a 4d61 6368 nown as GNU.Mach │ │ │ │ │ -00001bf0: 292e 2020 4572 6963 6820 616e 6420 4272 ). Erich and Br │ │ │ │ │ -00001c00: 6961 6e20 466f 7264 2064 6573 6967 6e65 ian Ford designe │ │ │ │ │ -00001c10: 6420 7468 6520 4d75 6c74 6962 6f6f 7420 d the Multiboot │ │ │ │ │ -00001c20: 5370 6563 6966 6963 6174 696f 6e20 282a Specification (* │ │ │ │ │ -00001c30: 6e6f 7465 0a4d 756c 7469 626f 6f74 2053 note.Multiboot S │ │ │ │ │ -00001c40: 7065 6369 6669 6361 7469 6f6e 3a20 286d pecification: (m │ │ │ │ │ -00001c50: 756c 7469 626f 6f74 2954 6f70 2e29 2c20 ultiboot)Top.), │ │ │ │ │ -00001c60: 6265 6361 7573 6520 7468 6579 2077 6572 because they wer │ │ │ │ │ -00001c70: 6520 6465 7465 726d 696e 6564 0a6e 6f74 e determined.not │ │ │ │ │ -00001c80: 2074 6f20 6164 6420 746f 2074 6865 206c to add to the l │ │ │ │ │ -00001c90: 6172 6765 206e 756d 6265 7220 6f66 206d arge number of m │ │ │ │ │ -00001ca0: 7574 7561 6c6c 792d 696e 636f 6d70 6174 utually-incompat │ │ │ │ │ -00001cb0: 6962 6c65 2050 4320 626f 6f74 206d 6574 ible PC boot met │ │ │ │ │ -00001cc0: 686f 6473 2e0a 0a20 2020 4572 6963 6820 hods... Erich │ │ │ │ │ -00001cd0: 7468 656e 2062 6567 616e 206d 6f64 6966 then began modif │ │ │ │ │ -00001ce0: 7969 6e67 2074 6865 2046 7265 6542 5344 ying the FreeBSD │ │ │ │ │ -00001cf0: 2062 6f6f 7420 6c6f 6164 6572 2073 6f20 boot loader so │ │ │ │ │ -00001d00: 7468 6174 2069 7420 776f 756c 640a 756e that it would.un │ │ │ │ │ -00001d10: 6465 7273 7461 6e64 204d 756c 7469 626f derstand Multibo │ │ │ │ │ -00001d20: 6f74 2e20 2048 6520 736f 6f6e 2072 6561 ot. He soon rea │ │ │ │ │ -00001d30: 6c69 7a65 6420 7468 6174 2069 7420 776f lized that it wo │ │ │ │ │ -00001d40: 756c 6420 6265 2061 206c 6f74 2065 6173 uld be a lot eas │ │ │ │ │ -00001d50: 6965 7220 746f 0a77 7269 7465 2068 6973 ier to.write his │ │ │ │ │ -00001d60: 206f 776e 2062 6f6f 7420 6c6f 6164 6572 own boot loader │ │ │ │ │ -00001d70: 2066 726f 6d20 7363 7261 7463 6820 7468 from scratch th │ │ │ │ │ -00001d80: 616e 2074 6f20 6b65 6570 2077 6f72 6b69 an to keep worki │ │ │ │ │ -00001d90: 6e67 206f 6e20 7468 650a 4672 6565 4253 ng on the.FreeBS │ │ │ │ │ -00001da0: 4420 626f 6f74 206c 6f61 6465 722c 2061 D boot loader, a │ │ │ │ │ -00001db0: 6e64 2073 6f20 4752 5542 2077 6173 2062 nd so GRUB was b │ │ │ │ │ -00001dc0: 6f72 6e2e 0a0a 2020 2045 7269 6368 2061 orn... Erich a │ │ │ │ │ -00001dd0: 6464 6564 206d 616e 7920 6665 6174 7572 dded many featur │ │ │ │ │ -00001de0: 6573 2074 6f20 4752 5542 2c20 6275 7420 es to GRUB, but │ │ │ │ │ -00001df0: 6f74 6865 7220 7072 696f 7269 7469 6573 other priorities │ │ │ │ │ -00001e00: 2070 7265 7665 6e74 6564 2068 696d 0a66 prevented him.f │ │ │ │ │ -00001e10: 726f 6d20 6b65 6570 696e 6720 7570 2077 rom keeping up w │ │ │ │ │ -00001e20: 6974 6820 7468 6520 6465 6d61 6e64 7320 ith the demands │ │ │ │ │ -00001e30: 6f66 2069 7473 2071 7569 636b 6c79 2d65 of its quickly-e │ │ │ │ │ -00001e40: 7870 616e 6469 6e67 2075 7365 7220 6261 xpanding user ba │ │ │ │ │ -00001e50: 7365 2e20 2049 6e0a 3139 3939 2c20 476f se. In.1999, Go │ │ │ │ │ -00001e60: 7264 6f6e 204d 6174 7a69 676b 6569 7420 rdon Matzigkeit │ │ │ │ │ -00001e70: 616e 6420 596f 7368 696e 6f72 6920 4b2e and Yoshinori K. │ │ │ │ │ -00001e80: 204f 6b75 6a69 2061 646f 7074 6564 2047 Okuji adopted G │ │ │ │ │ -00001e90: 5255 4220 6173 2061 6e0a 6f66 6669 6369 RUB as an.offici │ │ │ │ │ -00001ea0: 616c 2047 4e55 2070 6163 6b61 6765 2c20 al GNU package, │ │ │ │ │ -00001eb0: 616e 6420 6f70 656e 6564 2069 7473 2064 and opened its d │ │ │ │ │ -00001ec0: 6576 656c 6f70 6d65 6e74 2062 7920 6d61 evelopment by ma │ │ │ │ │ -00001ed0: 6b69 6e67 2074 6865 206c 6174 6573 740a king the latest. │ │ │ │ │ -00001ee0: 736f 7572 6365 7320 6176 6169 6c61 626c sources availabl │ │ │ │ │ -00001ef0: 6520 7669 6120 616e 6f6e 796d 6f75 7320 e via anonymous │ │ │ │ │ -00001f00: 4356 532e 202a 4e6f 7465 204f 6274 6169 CVS. *Note Obtai │ │ │ │ │ -00001f10: 6e69 6e67 2061 6e64 2042 7569 6c64 696e ning and Buildin │ │ │ │ │ -00001f20: 670a 4752 5542 3a3a 2c20 666f 7220 6d6f g.GRUB::, for mo │ │ │ │ │ -00001f30: 7265 2069 6e66 6f72 6d61 7469 6f6e 2e0a re information.. │ │ │ │ │ -00001f40: 0a20 2020 4f76 6572 2074 6865 206e 6578 . Over the nex │ │ │ │ │ -00001f50: 7420 6665 7720 7965 6172 732c 2047 5255 t few years, GRU │ │ │ │ │ -00001f60: 4220 7761 7320 6578 7465 6e64 6564 2074 B was extended t │ │ │ │ │ -00001f70: 6f20 6d65 6574 206d 616e 7920 6e65 6564 o meet many need │ │ │ │ │ -00001f80: 732c 2062 7574 2069 740a 7175 6963 6b6c s, but it.quickl │ │ │ │ │ -00001f90: 7920 6265 6361 6d65 2063 6c65 6172 2074 y became clear t │ │ │ │ │ -00001fa0: 6861 7420 6974 7320 6465 7369 676e 2077 hat its design w │ │ │ │ │ -00001fb0: 6173 206e 6f74 206b 6565 7069 6e67 2075 as not keeping u │ │ │ │ │ -00001fc0: 7020 7769 7468 2074 6865 0a65 7874 656e p with the.exten │ │ │ │ │ -00001fd0: 7369 6f6e 7320 6265 696e 6720 6d61 6465 sions being made │ │ │ │ │ -00001fe0: 2074 6f20 6974 2c20 616e 6420 7765 2072 to it, and we r │ │ │ │ │ -00001ff0: 6561 6368 6564 2074 6865 2070 6f69 6e74 eached the point │ │ │ │ │ -00002000: 2077 6865 7265 2069 7420 7761 7320 7665 where it was ve │ │ │ │ │ -00002010: 7279 0a64 6966 6669 6375 6c74 2074 6f20 ry.difficult to │ │ │ │ │ -00002020: 6d61 6b65 2061 6e79 2066 7572 7468 6572 make any further │ │ │ │ │ -00002030: 2063 6861 6e67 6573 2077 6974 686f 7574 changes without │ │ │ │ │ -00002040: 2062 7265 616b 696e 6720 6578 6973 7469 breaking existi │ │ │ │ │ -00002050: 6e67 0a66 6561 7475 7265 732e 2020 4172 ng.features. Ar │ │ │ │ │ -00002060: 6f75 6e64 2032 3030 322c 2059 6f73 6869 ound 2002, Yoshi │ │ │ │ │ -00002070: 6e6f 7269 204b 2e20 4f6b 756a 6920 7374 nori K. Okuji st │ │ │ │ │ -00002080: 6172 7465 6420 776f 726b 206f 6e20 5055 arted work on PU │ │ │ │ │ -00002090: 5041 0a28 5072 656c 696d 696e 6172 7920 PA.(Preliminary │ │ │ │ │ -000020a0: 556e 6976 6572 7361 6c20 5072 6f67 7261 Universal Progra │ │ │ │ │ -000020b0: 6d6d 696e 6720 4172 6368 6974 6563 7475 mming Architectu │ │ │ │ │ -000020c0: 7265 2066 6f72 2047 4e55 2047 5255 4229 re for GNU GRUB) │ │ │ │ │ -000020d0: 2c20 6169 6d69 6e67 2074 6f0a 7265 7772 , aiming to.rewr │ │ │ │ │ -000020e0: 6974 6520 7468 6520 636f 7265 206f 6620 ite the core of │ │ │ │ │ -000020f0: 4752 5542 2074 6f20 6d61 6b65 2069 7420 GRUB to make it │ │ │ │ │ -00002100: 636c 6561 6e65 722c 2073 6166 6572 2c20 cleaner, safer, │ │ │ │ │ -00002110: 6d6f 7265 2072 6f62 7573 742c 2061 6e64 more robust, and │ │ │ │ │ -00002120: 0a6d 6f72 6520 706f 7765 7266 756c 2e20 .more powerful. │ │ │ │ │ -00002130: 2050 5550 4120 7761 7320 6576 656e 7475 PUPA was eventu │ │ │ │ │ -00002140: 616c 6c79 2072 656e 616d 6564 2074 6f20 ally renamed to │ │ │ │ │ -00002150: 4752 5542 2032 2c20 616e 6420 7468 6520 GRUB 2, and the │ │ │ │ │ -00002160: 6f72 6967 696e 616c 0a76 6572 7369 6f6e original.version │ │ │ │ │ -00002170: 206f 6620 4752 5542 2077 6173 2072 656e of GRUB was ren │ │ │ │ │ -00002180: 616d 6564 2074 6f20 4752 5542 204c 6567 amed to GRUB Leg │ │ │ │ │ -00002190: 6163 792e 2020 536d 616c 6c20 616d 6f75 acy. Small amou │ │ │ │ │ -000021a0: 6e74 7320 6f66 0a6d 6169 6e74 656e 616e nts of.maintenan │ │ │ │ │ -000021b0: 6365 2063 6f6e 7469 6e75 6564 2074 6f20 ce continued to │ │ │ │ │ -000021c0: 6265 2064 6f6e 6520 6f6e 2047 5255 4220 be done on GRUB │ │ │ │ │ -000021d0: 4c65 6761 6379 2c20 6275 7420 7468 6520 Legacy, but the │ │ │ │ │ -000021e0: 6c61 7374 2072 656c 6561 7365 0a28 302e last release.(0. │ │ │ │ │ -000021f0: 3937 2920 7761 7320 6d61 6465 2069 6e20 97) was made in │ │ │ │ │ -00002200: 3230 3035 2061 6e64 2061 7420 7468 6520 2005 and at the │ │ │ │ │ -00002210: 7469 6d65 206f 6620 7772 6974 696e 6720 time of writing │ │ │ │ │ -00002220: 6974 2073 6565 6d73 2075 6e6c 696b 656c it seems unlikel │ │ │ │ │ -00002230: 790a 7468 6174 2074 6865 7265 2077 696c y.that there wil │ │ │ │ │ -00002240: 6c20 6265 2061 6e6f 7468 6572 2e0a 0a20 l be another... │ │ │ │ │ -00002250: 2020 4279 2061 726f 756e 6420 3230 3037 By around 2007 │ │ │ │ │ -00002260: 2c20 474e 552f 4c69 6e75 7820 6469 7374 , GNU/Linux dist │ │ │ │ │ -00002270: 7269 6275 7469 6f6e 7320 7374 6172 7465 ributions starte │ │ │ │ │ -00002280: 6420 746f 2075 7365 2047 5255 4220 3220 d to use GRUB 2 │ │ │ │ │ -00002290: 746f 0a6c 696d 6974 6564 2065 7874 656e to.limited exten │ │ │ │ │ -000022a0: 7473 2c20 616e 6420 6279 2074 6865 2065 ts, and by the e │ │ │ │ │ -000022b0: 6e64 206f 6620 3230 3039 206d 756c 7469 nd of 2009 multi │ │ │ │ │ -000022c0: 706c 6520 6d61 6a6f 7220 6469 7374 7269 ple major distri │ │ │ │ │ -000022d0: 6275 7469 6f6e 730a 7765 7265 2069 6e73 butions.were ins │ │ │ │ │ -000022e0: 7461 6c6c 696e 6720 6974 2062 7920 6465 talling it by de │ │ │ │ │ -000022f0: 6661 756c 742e 0a0a 1f0a 4669 6c65 3a20 fault.....File: │ │ │ │ │ -00002300: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00002310: 3a20 4368 616e 6765 7320 6672 6f6d 2047 : Changes from G │ │ │ │ │ -00002320: 5255 4220 4c65 6761 6379 2c20 204e 6578 RUB Legacy, Nex │ │ │ │ │ -00002330: 743a 2046 6561 7475 7265 732c 2020 5072 t: Features, Pr │ │ │ │ │ -00002340: 6576 3a20 4869 7374 6f72 792c 2020 5570 ev: History, Up │ │ │ │ │ -00002350: 3a20 496e 7472 6f64 7563 7469 6f6e 0a0a : Introduction.. │ │ │ │ │ -00002360: 312e 3320 4469 6666 6572 656e 6365 7320 1.3 Differences │ │ │ │ │ -00002370: 6672 6f6d 2070 7265 7669 6f75 7320 7665 from previous ve │ │ │ │ │ -00002380: 7273 696f 6e73 0a3d 3d3d 3d3d 3d3d 3d3d rsions.========= │ │ │ │ │ +000011e0: 2020 4752 5542 2066 6561 7475 7265 730a GRUB features. │ │ │ │ │ +000011f0: 2a20 526f 6c65 206f 6620 6120 626f 6f74 * Role of a boot │ │ │ │ │ +00001200: 206c 6f61 6465 723a 3a20 2020 2020 2020 loader:: │ │ │ │ │ +00001210: 5468 6520 726f 6c65 206f 6620 6120 626f The role of a bo │ │ │ │ │ +00001220: 6f74 206c 6f61 6465 720a 0a1f 0a46 696c ot loader....Fil │ │ │ │ │ +00001230: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00001240: 6f64 653a 204f 7665 7276 6965 772c 2020 ode: Overview, │ │ │ │ │ +00001250: 4e65 7874 3a20 4869 7374 6f72 792c 2020 Next: History, │ │ │ │ │ +00001260: 5570 3a20 496e 7472 6f64 7563 7469 6f6e Up: Introduction │ │ │ │ │ +00001270: 0a0a 312e 3120 4f76 6572 7669 6577 0a3d ..1.1 Overview.= │ │ │ │ │ +00001280: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a42 7269 ===========..Bri │ │ │ │ │ +00001290: 6566 6c79 2c20 6120 2262 6f6f 7420 6c6f efly, a "boot lo │ │ │ │ │ +000012a0: 6164 6572 2220 6973 2074 6865 2066 6972 ader" is the fir │ │ │ │ │ +000012b0: 7374 2073 6f66 7477 6172 6520 7072 6f67 st software prog │ │ │ │ │ +000012c0: 7261 6d20 7468 6174 2072 756e 7320 7768 ram that runs wh │ │ │ │ │ +000012d0: 656e 2061 0a63 6f6d 7075 7465 7220 7374 en a.computer st │ │ │ │ │ +000012e0: 6172 7473 2e20 2049 7420 6973 2072 6573 arts. It is res │ │ │ │ │ +000012f0: 706f 6e73 6962 6c65 2066 6f72 206c 6f61 ponsible for loa │ │ │ │ │ +00001300: 6469 6e67 2061 6e64 2074 7261 6e73 6665 ding and transfe │ │ │ │ │ +00001310: 7272 696e 6720 636f 6e74 726f 6c0a 746f rring control.to │ │ │ │ │ +00001320: 2061 6e20 6f70 6572 6174 696e 6720 7379 an operating sy │ │ │ │ │ +00001330: 7374 656d 2022 6b65 726e 656c 2220 736f stem "kernel" so │ │ │ │ │ +00001340: 6674 7761 7265 2028 7375 6368 2061 7320 ftware (such as │ │ │ │ │ +00001350: 4c69 6e75 7820 6f72 2047 4e55 204d 6163 Linux or GNU Mac │ │ │ │ │ +00001360: 6829 2e0a 5468 6520 6b65 726e 656c 2c20 h)..The kernel, │ │ │ │ │ +00001370: 696e 2074 7572 6e2c 2069 6e69 7469 616c in turn, initial │ │ │ │ │ +00001380: 697a 6573 2074 6865 2072 6573 7420 6f66 izes the rest of │ │ │ │ │ +00001390: 2074 6865 206f 7065 7261 7469 6e67 2073 the operating s │ │ │ │ │ +000013a0: 7973 7465 6d20 2865 2e67 2e0a 6120 474e ystem (e.g..a GN │ │ │ │ │ +000013b0: 5520 7379 7374 656d 292e 0a0a 2020 2047 U system)... G │ │ │ │ │ +000013c0: 4e55 2047 5255 4220 6973 2061 2076 6572 NU GRUB is a ver │ │ │ │ │ +000013d0: 7920 706f 7765 7266 756c 2062 6f6f 7420 y powerful boot │ │ │ │ │ +000013e0: 6c6f 6164 6572 2c20 7768 6963 6820 6361 loader, which ca │ │ │ │ │ +000013f0: 6e20 6c6f 6164 2061 2077 6964 650a 7661 n load a wide.va │ │ │ │ │ +00001400: 7269 6574 7920 6f66 2066 7265 6520 6f70 riety of free op │ │ │ │ │ +00001410: 6572 6174 696e 6720 7379 7374 656d 732c erating systems, │ │ │ │ │ +00001420: 2061 7320 7765 6c6c 2061 7320 7072 6f70 as well as prop │ │ │ │ │ +00001430: 7269 6574 6172 7920 6f70 6572 6174 696e rietary operatin │ │ │ │ │ +00001440: 670a 7379 7374 656d 7320 7769 7468 2063 g.systems with c │ │ │ │ │ +00001450: 6861 696e 2d6c 6f61 6469 6e67 2831 2920 hain-loading(1) │ │ │ │ │ +00001460: 282a 6e6f 7465 204f 7665 7276 6965 772d (*note Overview- │ │ │ │ │ +00001470: 466f 6f74 6e6f 7465 2d31 3a3a 292e 2020 Footnote-1::). │ │ │ │ │ +00001480: 4752 5542 2069 730a 6465 7369 676e 6564 GRUB is.designed │ │ │ │ │ +00001490: 2074 6f20 6164 6472 6573 7320 7468 6520 to address the │ │ │ │ │ +000014a0: 636f 6d70 6c65 7869 7479 206f 6620 626f complexity of bo │ │ │ │ │ +000014b0: 6f74 696e 6720 6120 7065 7273 6f6e 616c oting a personal │ │ │ │ │ +000014c0: 2063 6f6d 7075 7465 723b 2062 6f74 680a computer; both. │ │ │ │ │ +000014d0: 7468 6520 7072 6f67 7261 6d20 616e 6420 the program and │ │ │ │ │ +000014e0: 7468 6973 206d 616e 7561 6c20 6172 6520 this manual are │ │ │ │ │ +000014f0: 7469 6768 746c 7920 626f 756e 6420 746f tightly bound to │ │ │ │ │ +00001500: 2074 6861 7420 636f 6d70 7574 6572 2070 that computer p │ │ │ │ │ +00001510: 6c61 7466 6f72 6d2c 0a61 6c74 686f 7567 latform,.althoug │ │ │ │ │ +00001520: 6820 706f 7274 696e 6720 746f 206f 7468 h porting to oth │ │ │ │ │ +00001530: 6572 2070 6c61 7466 6f72 6d73 206d 6179 er platforms may │ │ │ │ │ +00001540: 2062 6520 6164 6472 6573 7365 6420 696e be addressed in │ │ │ │ │ +00001550: 2074 6865 2066 7574 7572 652e 0a0a 2020 the future... │ │ │ │ │ +00001560: 204f 6e65 206f 6620 7468 6520 696d 706f One of the impo │ │ │ │ │ +00001570: 7274 616e 7420 6665 6174 7572 6573 2069 rtant features i │ │ │ │ │ +00001580: 6e20 4752 5542 2069 7320 666c 6578 6962 n GRUB is flexib │ │ │ │ │ +00001590: 696c 6974 793b 2047 5255 420a 756e 6465 ility; GRUB.unde │ │ │ │ │ +000015a0: 7273 7461 6e64 7320 6669 6c65 7379 7374 rstands filesyst │ │ │ │ │ +000015b0: 656d 7320 616e 6420 6b65 726e 656c 2065 ems and kernel e │ │ │ │ │ +000015c0: 7865 6375 7461 626c 6520 666f 726d 6174 xecutable format │ │ │ │ │ +000015d0: 732c 2073 6f20 796f 7520 6361 6e20 6c6f s, so you can lo │ │ │ │ │ +000015e0: 6164 0a61 6e20 6172 6269 7472 6172 7920 ad.an arbitrary │ │ │ │ │ +000015f0: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +00001600: 2074 6865 2077 6179 2079 6f75 206c 696b the way you lik │ │ │ │ │ +00001610: 652c 2077 6974 686f 7574 2072 6563 6f72 e, without recor │ │ │ │ │ +00001620: 6469 6e67 2074 6865 0a70 6879 7369 6361 ding the.physica │ │ │ │ │ +00001630: 6c20 706f 7369 7469 6f6e 206f 6620 796f l position of yo │ │ │ │ │ +00001640: 7572 206b 6572 6e65 6c20 6f6e 2074 6865 ur kernel on the │ │ │ │ │ +00001650: 2064 6973 6b2e 2020 5468 7573 2079 6f75 disk. Thus you │ │ │ │ │ +00001660: 2063 616e 206c 6f61 6420 7468 650a 6b65 can load the.ke │ │ │ │ │ +00001670: 726e 656c 206a 7573 7420 6279 2073 7065 rnel just by spe │ │ │ │ │ +00001680: 6369 6679 696e 6720 6974 7320 6669 6c65 cifying its file │ │ │ │ │ +00001690: 206e 616d 6520 616e 6420 7468 6520 6472 name and the dr │ │ │ │ │ +000016a0: 6976 6520 616e 6420 7061 7274 6974 696f ive and partitio │ │ │ │ │ +000016b0: 6e0a 7768 6572 6520 7468 6520 6b65 726e n.where the kern │ │ │ │ │ +000016c0: 656c 2072 6573 6964 6573 2e0a 0a20 2020 el resides... │ │ │ │ │ +000016d0: 5768 656e 2062 6f6f 7469 6e67 2077 6974 When booting wit │ │ │ │ │ +000016e0: 6820 4752 5542 2c20 796f 7520 6361 6e20 h GRUB, you can │ │ │ │ │ +000016f0: 7573 6520 6569 7468 6572 2061 2063 6f6d use either a com │ │ │ │ │ +00001700: 6d61 6e64 2d6c 696e 6520 696e 7465 7266 mand-line interf │ │ │ │ │ +00001710: 6163 650a 282a 6e6f 7465 2043 6f6d 6d61 ace.(*note Comma │ │ │ │ │ +00001720: 6e64 2d6c 696e 6520 696e 7465 7266 6163 nd-line interfac │ │ │ │ │ +00001730: 653a 3a29 2c20 6f72 2061 206d 656e 7520 e::), or a menu │ │ │ │ │ +00001740: 696e 7465 7266 6163 6520 282a 6e6f 7465 interface (*note │ │ │ │ │ +00001750: 204d 656e 750a 696e 7465 7266 6163 653a Menu.interface: │ │ │ │ │ +00001760: 3a29 2e20 2055 7369 6e67 2074 6865 2063 :). Using the c │ │ │ │ │ +00001770: 6f6d 6d61 6e64 2d6c 696e 6520 696e 7465 ommand-line inte │ │ │ │ │ +00001780: 7266 6163 652c 2079 6f75 2074 7970 6520 rface, you type │ │ │ │ │ +00001790: 7468 6520 6472 6976 650a 7370 6563 6966 the drive.specif │ │ │ │ │ +000017a0: 6963 6174 696f 6e20 616e 6420 6669 6c65 ication and file │ │ │ │ │ +000017b0: 206e 616d 6520 6f66 2074 6865 206b 6572 name of the ker │ │ │ │ │ +000017c0: 6e65 6c20 6d61 6e75 616c 6c79 2e20 2049 nel manually. I │ │ │ │ │ +000017d0: 6e20 7468 6520 6d65 6e75 0a69 6e74 6572 n the menu.inter │ │ │ │ │ +000017e0: 6661 6365 2c20 796f 7520 6a75 7374 2073 face, you just s │ │ │ │ │ +000017f0: 656c 6563 7420 616e 204f 5320 7573 696e elect an OS usin │ │ │ │ │ +00001800: 6720 7468 6520 6172 726f 7720 6b65 7973 g the arrow keys │ │ │ │ │ +00001810: 2e20 2054 6865 206d 656e 7520 6973 0a62 . The menu is.b │ │ │ │ │ +00001820: 6173 6564 206f 6e20 6120 636f 6e66 6967 ased on a config │ │ │ │ │ +00001830: 7572 6174 696f 6e20 6669 6c65 2077 6869 uration file whi │ │ │ │ │ +00001840: 6368 2079 6f75 2070 7265 7061 7265 2062 ch you prepare b │ │ │ │ │ +00001850: 6566 6f72 6568 616e 6420 282a 6e6f 7465 eforehand (*note │ │ │ │ │ +00001860: 0a43 6f6e 6669 6775 7261 7469 6f6e 3a3a .Configuration:: │ │ │ │ │ +00001870: 292e 2020 5768 696c 6520 696e 2074 6865 ). While in the │ │ │ │ │ +00001880: 206d 656e 752c 2079 6f75 2063 616e 2073 menu, you can s │ │ │ │ │ +00001890: 7769 7463 6820 746f 2074 6865 2063 6f6d witch to the com │ │ │ │ │ +000018a0: 6d61 6e64 2d6c 696e 650a 6d6f 6465 2c20 mand-line.mode, │ │ │ │ │ +000018b0: 616e 6420 7669 6365 2d76 6572 7361 2e20 and vice-versa. │ │ │ │ │ +000018c0: 2059 6f75 2063 616e 2065 7665 6e20 6564 You can even ed │ │ │ │ │ +000018d0: 6974 206d 656e 7520 656e 7472 6965 7320 it menu entries │ │ │ │ │ +000018e0: 6265 666f 7265 2075 7369 6e67 2074 6865 before using the │ │ │ │ │ +000018f0: 6d2e 0a0a 2020 2049 6e20 7468 6520 666f m... In the fo │ │ │ │ │ +00001900: 6c6c 6f77 696e 6720 6368 6170 7465 7273 llowing chapters │ │ │ │ │ +00001910: 2c20 796f 7520 7769 6c6c 206c 6561 726e , you will learn │ │ │ │ │ +00001920: 2068 6f77 2074 6f20 7370 6563 6966 7920 how to specify │ │ │ │ │ +00001930: 6120 6472 6976 652c 2061 0a70 6172 7469 a drive, a.parti │ │ │ │ │ +00001940: 7469 6f6e 2c20 616e 6420 6120 6669 6c65 tion, and a file │ │ │ │ │ +00001950: 206e 616d 6520 282a 6e6f 7465 204e 616d name (*note Nam │ │ │ │ │ +00001960: 696e 6720 636f 6e76 656e 7469 6f6e 3a3a ing convention:: │ │ │ │ │ +00001970: 2920 746f 2047 5255 422c 2068 6f77 2074 ) to GRUB, how t │ │ │ │ │ +00001980: 6f0a 696e 7374 616c 6c20 4752 5542 206f o.install GRUB o │ │ │ │ │ +00001990: 6e20 796f 7572 2064 7269 7665 2028 2a6e n your drive (*n │ │ │ │ │ +000019a0: 6f74 6520 496e 7374 616c 6c61 7469 6f6e ote Installation │ │ │ │ │ +000019b0: 3a3a 292c 2061 6e64 2068 6f77 2074 6f20 ::), and how to │ │ │ │ │ +000019c0: 626f 6f74 2079 6f75 720a 4f53 6573 2028 boot your.OSes ( │ │ │ │ │ +000019d0: 2a6e 6f74 6520 426f 6f74 696e 673a 3a29 *note Booting::) │ │ │ │ │ +000019e0: 2c20 7374 6570 2062 7920 7374 6570 2e0a , step by step.. │ │ │ │ │ +000019f0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00001a00: 666f 2c20 204e 6f64 653a 204f 7665 7276 fo, Node: Overv │ │ │ │ │ +00001a10: 6965 772d 466f 6f74 6e6f 7465 732c 2020 iew-Footnotes, │ │ │ │ │ +00001a20: 5570 3a20 4f76 6572 7669 6577 0a0a 2020 Up: Overview.. │ │ │ │ │ +00001a30: 2028 3129 2022 6368 6169 6e2d 6c6f 6164 (1) "chain-load │ │ │ │ │ +00001a40: 2220 6973 2074 6865 206d 6563 6861 6e69 " is the mechani │ │ │ │ │ +00001a50: 736d 2066 6f72 206c 6f61 6469 6e67 2075 sm for loading u │ │ │ │ │ +00001a60: 6e73 7570 706f 7274 6564 206f 7065 7261 nsupported opera │ │ │ │ │ +00001a70: 7469 6e67 0a73 7973 7465 6d73 2062 7920 ting.systems by │ │ │ │ │ +00001a80: 6c6f 6164 696e 6720 616e 6f74 6865 7220 loading another │ │ │ │ │ +00001a90: 626f 6f74 206c 6f61 6465 722e 2020 4974 boot loader. It │ │ │ │ │ +00001aa0: 2069 7320 7479 7069 6361 6c6c 7920 7573 is typically us │ │ │ │ │ +00001ab0: 6564 2066 6f72 0a6c 6f61 6469 6e67 2044 ed for.loading D │ │ │ │ │ +00001ac0: 4f53 206f 7220 5769 6e64 6f77 732e 0a0a OS or Windows... │ │ │ │ │ +00001ad0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00001ae0: 6f2c 2020 4e6f 6465 3a20 4869 7374 6f72 o, Node: Histor │ │ │ │ │ +00001af0: 792c 2020 4e65 7874 3a20 4368 616e 6765 y, Next: Change │ │ │ │ │ +00001b00: 7320 6672 6f6d 2047 5255 4220 4c65 6761 s from GRUB Lega │ │ │ │ │ +00001b10: 6379 2c20 2050 7265 763a 204f 7665 7276 cy, Prev: Overv │ │ │ │ │ +00001b20: 6965 772c 2020 5570 3a20 496e 7472 6f64 iew, Up: Introd │ │ │ │ │ +00001b30: 7563 7469 6f6e 0a0a 312e 3220 4869 7374 uction..1.2 Hist │ │ │ │ │ +00001b40: 6f72 7920 6f66 2047 5255 420a 3d3d 3d3d ory of GRUB.==== │ │ │ │ │ +00001b50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00001b60: 0a47 5255 4220 6f72 6967 696e 6174 6564 .GRUB originated │ │ │ │ │ +00001b70: 2069 6e20 3139 3935 2077 6865 6e20 4572 in 1995 when Er │ │ │ │ │ +00001b80: 6963 6820 426f 6c65 796e 2077 6173 2074 ich Boleyn was t │ │ │ │ │ +00001b90: 7279 696e 6720 746f 2062 6f6f 7420 7468 rying to boot th │ │ │ │ │ +00001ba0: 6520 474e 550a 4875 7264 2077 6974 6820 e GNU.Hurd with │ │ │ │ │ +00001bb0: 7468 6520 556e 6976 6572 7369 7479 206f the University o │ │ │ │ │ +00001bc0: 6620 5574 6168 2773 204d 6163 6820 3420 f Utah's Mach 4 │ │ │ │ │ +00001bd0: 6d69 6372 6f6b 6572 6e65 6c20 286e 6f77 microkernel (now │ │ │ │ │ +00001be0: 206b 6e6f 776e 2061 7320 474e 550a 4d61 known as GNU.Ma │ │ │ │ │ +00001bf0: 6368 292e 2020 4572 6963 6820 616e 6420 ch). Erich and │ │ │ │ │ +00001c00: 4272 6961 6e20 466f 7264 2064 6573 6967 Brian Ford desig │ │ │ │ │ +00001c10: 6e65 6420 7468 6520 4d75 6c74 6962 6f6f ned the Multiboo │ │ │ │ │ +00001c20: 7420 5370 6563 6966 6963 6174 696f 6e20 t Specification │ │ │ │ │ +00001c30: 282a 6e6f 7465 0a4d 756c 7469 626f 6f74 (*note.Multiboot │ │ │ │ │ +00001c40: 2053 7065 6369 6669 6361 7469 6f6e 3a20 Specification: │ │ │ │ │ +00001c50: 286d 756c 7469 626f 6f74 2954 6f70 2e29 (multiboot)Top.) │ │ │ │ │ +00001c60: 2c20 6265 6361 7573 6520 7468 6579 2077 , because they w │ │ │ │ │ +00001c70: 6572 6520 6465 7465 726d 696e 6564 0a6e ere determined.n │ │ │ │ │ +00001c80: 6f74 2074 6f20 6164 6420 746f 2074 6865 ot to add to the │ │ │ │ │ +00001c90: 206c 6172 6765 206e 756d 6265 7220 6f66 large number of │ │ │ │ │ +00001ca0: 206d 7574 7561 6c6c 792d 696e 636f 6d70 mutually-incomp │ │ │ │ │ +00001cb0: 6174 6962 6c65 2050 4320 626f 6f74 206d atible PC boot m │ │ │ │ │ +00001cc0: 6574 686f 6473 2e0a 0a20 2020 4572 6963 ethods... Eric │ │ │ │ │ +00001cd0: 6820 7468 656e 2062 6567 616e 206d 6f64 h then began mod │ │ │ │ │ +00001ce0: 6966 7969 6e67 2074 6865 2046 7265 6542 ifying the FreeB │ │ │ │ │ +00001cf0: 5344 2062 6f6f 7420 6c6f 6164 6572 2073 SD boot loader s │ │ │ │ │ +00001d00: 6f20 7468 6174 2069 7420 776f 756c 640a o that it would. │ │ │ │ │ +00001d10: 756e 6465 7273 7461 6e64 204d 756c 7469 understand Multi │ │ │ │ │ +00001d20: 626f 6f74 2e20 2048 6520 736f 6f6e 2072 boot. He soon r │ │ │ │ │ +00001d30: 6561 6c69 7a65 6420 7468 6174 2069 7420 ealized that it │ │ │ │ │ +00001d40: 776f 756c 6420 6265 2061 206c 6f74 2065 would be a lot e │ │ │ │ │ +00001d50: 6173 6965 7220 746f 0a77 7269 7465 2068 asier to.write h │ │ │ │ │ +00001d60: 6973 206f 776e 2062 6f6f 7420 6c6f 6164 is own boot load │ │ │ │ │ +00001d70: 6572 2066 726f 6d20 7363 7261 7463 6820 er from scratch │ │ │ │ │ +00001d80: 7468 616e 2074 6f20 6b65 6570 2077 6f72 than to keep wor │ │ │ │ │ +00001d90: 6b69 6e67 206f 6e20 7468 650a 4672 6565 king on the.Free │ │ │ │ │ +00001da0: 4253 4420 626f 6f74 206c 6f61 6465 722c BSD boot loader, │ │ │ │ │ +00001db0: 2061 6e64 2073 6f20 4752 5542 2077 6173 and so GRUB was │ │ │ │ │ +00001dc0: 2062 6f72 6e2e 0a0a 2020 2045 7269 6368 born... Erich │ │ │ │ │ +00001dd0: 2061 6464 6564 206d 616e 7920 6665 6174 added many feat │ │ │ │ │ +00001de0: 7572 6573 2074 6f20 4752 5542 2c20 6275 ures to GRUB, bu │ │ │ │ │ +00001df0: 7420 6f74 6865 7220 7072 696f 7269 7469 t other prioriti │ │ │ │ │ +00001e00: 6573 2070 7265 7665 6e74 6564 2068 696d es prevented him │ │ │ │ │ +00001e10: 0a66 726f 6d20 6b65 6570 696e 6720 7570 .from keeping up │ │ │ │ │ +00001e20: 2077 6974 6820 7468 6520 6465 6d61 6e64 with the demand │ │ │ │ │ +00001e30: 7320 6f66 2069 7473 2071 7569 636b 6c79 s of its quickly │ │ │ │ │ +00001e40: 2d65 7870 616e 6469 6e67 2075 7365 7220 -expanding user │ │ │ │ │ +00001e50: 6261 7365 2e20 2049 6e0a 3139 3939 2c20 base. In.1999, │ │ │ │ │ +00001e60: 476f 7264 6f6e 204d 6174 7a69 676b 6569 Gordon Matzigkei │ │ │ │ │ +00001e70: 7420 616e 6420 596f 7368 696e 6f72 6920 t and Yoshinori │ │ │ │ │ +00001e80: 4b2e 204f 6b75 6a69 2061 646f 7074 6564 K. Okuji adopted │ │ │ │ │ +00001e90: 2047 5255 4220 6173 2061 6e0a 6f66 6669 GRUB as an.offi │ │ │ │ │ +00001ea0: 6369 616c 2047 4e55 2070 6163 6b61 6765 cial GNU package │ │ │ │ │ +00001eb0: 2c20 616e 6420 6f70 656e 6564 2069 7473 , and opened its │ │ │ │ │ +00001ec0: 2064 6576 656c 6f70 6d65 6e74 2062 7920 development by │ │ │ │ │ +00001ed0: 6d61 6b69 6e67 2074 6865 206c 6174 6573 making the lates │ │ │ │ │ +00001ee0: 740a 736f 7572 6365 7320 6176 6169 6c61 t.sources availa │ │ │ │ │ +00001ef0: 626c 6520 7669 6120 616e 6f6e 796d 6f75 ble via anonymou │ │ │ │ │ +00001f00: 7320 4356 532e 202a 4e6f 7465 204f 6274 s CVS. *Note Obt │ │ │ │ │ +00001f10: 6169 6e69 6e67 2061 6e64 2042 7569 6c64 aining and Build │ │ │ │ │ +00001f20: 696e 670a 4752 5542 3a3a 2c20 666f 7220 ing.GRUB::, for │ │ │ │ │ +00001f30: 6d6f 7265 2069 6e66 6f72 6d61 7469 6f6e more information │ │ │ │ │ +00001f40: 2e0a 0a20 2020 4f76 6572 2074 6865 206e ... Over the n │ │ │ │ │ +00001f50: 6578 7420 6665 7720 7965 6172 732c 2047 ext few years, G │ │ │ │ │ +00001f60: 5255 4220 7761 7320 6578 7465 6e64 6564 RUB was extended │ │ │ │ │ +00001f70: 2074 6f20 6d65 6574 206d 616e 7920 6e65 to meet many ne │ │ │ │ │ +00001f80: 6564 732c 2062 7574 2069 740a 7175 6963 eds, but it.quic │ │ │ │ │ +00001f90: 6b6c 7920 6265 6361 6d65 2063 6c65 6172 kly became clear │ │ │ │ │ +00001fa0: 2074 6861 7420 6974 7320 6465 7369 676e that its design │ │ │ │ │ +00001fb0: 2077 6173 206e 6f74 206b 6565 7069 6e67 was not keeping │ │ │ │ │ +00001fc0: 2075 7020 7769 7468 2074 6865 0a65 7874 up with the.ext │ │ │ │ │ +00001fd0: 656e 7369 6f6e 7320 6265 696e 6720 6d61 ensions being ma │ │ │ │ │ +00001fe0: 6465 2074 6f20 6974 2c20 616e 6420 7765 de to it, and we │ │ │ │ │ +00001ff0: 2072 6561 6368 6564 2074 6865 2070 6f69 reached the poi │ │ │ │ │ +00002000: 6e74 2077 6865 7265 2069 7420 7761 7320 nt where it was │ │ │ │ │ +00002010: 7665 7279 0a64 6966 6669 6375 6c74 2074 very.difficult t │ │ │ │ │ +00002020: 6f20 6d61 6b65 2061 6e79 2066 7572 7468 o make any furth │ │ │ │ │ +00002030: 6572 2063 6861 6e67 6573 2077 6974 686f er changes witho │ │ │ │ │ +00002040: 7574 2062 7265 616b 696e 6720 6578 6973 ut breaking exis │ │ │ │ │ +00002050: 7469 6e67 0a66 6561 7475 7265 732e 2020 ting.features. │ │ │ │ │ +00002060: 4172 6f75 6e64 2032 3030 322c 2059 6f73 Around 2002, Yos │ │ │ │ │ +00002070: 6869 6e6f 7269 204b 2e20 4f6b 756a 6920 hinori K. Okuji │ │ │ │ │ +00002080: 7374 6172 7465 6420 776f 726b 206f 6e20 started work on │ │ │ │ │ +00002090: 5055 5041 0a28 5072 656c 696d 696e 6172 PUPA.(Preliminar │ │ │ │ │ +000020a0: 7920 556e 6976 6572 7361 6c20 5072 6f67 y Universal Prog │ │ │ │ │ +000020b0: 7261 6d6d 696e 6720 4172 6368 6974 6563 ramming Architec │ │ │ │ │ +000020c0: 7475 7265 2066 6f72 2047 4e55 2047 5255 ture for GNU GRU │ │ │ │ │ +000020d0: 4229 2c20 6169 6d69 6e67 2074 6f0a 7265 B), aiming to.re │ │ │ │ │ +000020e0: 7772 6974 6520 7468 6520 636f 7265 206f write the core o │ │ │ │ │ +000020f0: 6620 4752 5542 2074 6f20 6d61 6b65 2069 f GRUB to make i │ │ │ │ │ +00002100: 7420 636c 6561 6e65 722c 2073 6166 6572 t cleaner, safer │ │ │ │ │ +00002110: 2c20 6d6f 7265 2072 6f62 7573 742c 2061 , more robust, a │ │ │ │ │ +00002120: 6e64 0a6d 6f72 6520 706f 7765 7266 756c nd.more powerful │ │ │ │ │ +00002130: 2e20 2050 5550 4120 7761 7320 6576 656e . PUPA was even │ │ │ │ │ +00002140: 7475 616c 6c79 2072 656e 616d 6564 2074 tually renamed t │ │ │ │ │ +00002150: 6f20 4752 5542 2032 2c20 616e 6420 7468 o GRUB 2, and th │ │ │ │ │ +00002160: 6520 6f72 6967 696e 616c 0a76 6572 7369 e original.versi │ │ │ │ │ +00002170: 6f6e 206f 6620 4752 5542 2077 6173 2072 on of GRUB was r │ │ │ │ │ +00002180: 656e 616d 6564 2074 6f20 4752 5542 204c enamed to GRUB L │ │ │ │ │ +00002190: 6567 6163 792e 2020 536d 616c 6c20 616d egacy. Small am │ │ │ │ │ +000021a0: 6f75 6e74 7320 6f66 0a6d 6169 6e74 656e ounts of.mainten │ │ │ │ │ +000021b0: 616e 6365 2063 6f6e 7469 6e75 6564 2074 ance continued t │ │ │ │ │ +000021c0: 6f20 6265 2064 6f6e 6520 6f6e 2047 5255 o be done on GRU │ │ │ │ │ +000021d0: 4220 4c65 6761 6379 2c20 6275 7420 7468 B Legacy, but th │ │ │ │ │ +000021e0: 6520 6c61 7374 2072 656c 6561 7365 0a28 e last release.( │ │ │ │ │ +000021f0: 302e 3937 2920 7761 7320 6d61 6465 2069 0.97) was made i │ │ │ │ │ +00002200: 6e20 3230 3035 2061 6e64 2061 7420 7468 n 2005 and at th │ │ │ │ │ +00002210: 6520 7469 6d65 206f 6620 7772 6974 696e e time of writin │ │ │ │ │ +00002220: 6720 6974 2073 6565 6d73 2075 6e6c 696b g it seems unlik │ │ │ │ │ +00002230: 656c 790a 7468 6174 2074 6865 7265 2077 ely.that there w │ │ │ │ │ +00002240: 696c 6c20 6265 2061 6e6f 7468 6572 2e0a ill be another.. │ │ │ │ │ +00002250: 0a20 2020 4279 2061 726f 756e 6420 3230 . By around 20 │ │ │ │ │ +00002260: 3037 2c20 474e 552f 4c69 6e75 7820 6469 07, GNU/Linux di │ │ │ │ │ +00002270: 7374 7269 6275 7469 6f6e 7320 7374 6172 stributions star │ │ │ │ │ +00002280: 7465 6420 746f 2075 7365 2047 5255 4220 ted to use GRUB │ │ │ │ │ +00002290: 3220 746f 0a6c 696d 6974 6564 2065 7874 2 to.limited ext │ │ │ │ │ +000022a0: 656e 7473 2c20 616e 6420 6279 2074 6865 ents, and by the │ │ │ │ │ +000022b0: 2065 6e64 206f 6620 3230 3039 206d 756c end of 2009 mul │ │ │ │ │ +000022c0: 7469 706c 6520 6d61 6a6f 7220 6469 7374 tiple major dist │ │ │ │ │ +000022d0: 7269 6275 7469 6f6e 730a 7765 7265 2069 ributions.were i │ │ │ │ │ +000022e0: 6e73 7461 6c6c 696e 6720 6974 2062 7920 nstalling it by │ │ │ │ │ +000022f0: 6465 6661 756c 742e 0a0a 1f0a 4669 6c65 default.....File │ │ │ │ │ +00002300: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00002310: 6465 3a20 4368 616e 6765 7320 6672 6f6d de: Changes from │ │ │ │ │ +00002320: 2047 5255 4220 4c65 6761 6379 2c20 204e GRUB Legacy, N │ │ │ │ │ +00002330: 6578 743a 2046 6561 7475 7265 732c 2020 ext: Features, │ │ │ │ │ +00002340: 5072 6576 3a20 4869 7374 6f72 792c 2020 Prev: History, │ │ │ │ │ +00002350: 5570 3a20 496e 7472 6f64 7563 7469 6f6e Up: Introduction │ │ │ │ │ +00002360: 0a0a 312e 3320 4469 6666 6572 656e 6365 ..1.3 Difference │ │ │ │ │ +00002370: 7320 6672 6f6d 2070 7265 7669 6f75 7320 s from previous │ │ │ │ │ +00002380: 7665 7273 696f 6e73 0a3d 3d3d 3d3d 3d3d versions.======= │ │ │ │ │ 00002390: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000023a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a47 =============..G │ │ │ │ │ -000023b0: 5255 4220 3220 6973 2061 2072 6577 7269 RUB 2 is a rewri │ │ │ │ │ -000023c0: 7465 206f 6620 4752 5542 2028 2a6e 6f74 te of GRUB (*not │ │ │ │ │ -000023d0: 6520 4869 7374 6f72 793a 3a29 2c20 616c e History::), al │ │ │ │ │ -000023e0: 7468 6f75 6768 2069 7420 7368 6172 6573 though it shares │ │ │ │ │ -000023f0: 206d 616e 790a 6368 6172 6163 7465 7269 many.characteri │ │ │ │ │ -00002400: 7374 6963 7320 7769 7468 2074 6865 2070 stics with the p │ │ │ │ │ -00002410: 7265 7669 6f75 7320 7665 7273 696f 6e2c revious version, │ │ │ │ │ -00002420: 206e 6f77 206b 6e6f 776e 2061 7320 4752 now known as GR │ │ │ │ │ -00002430: 5542 204c 6567 6163 792e 0a55 7365 7273 UB Legacy..Users │ │ │ │ │ -00002440: 206f 6620 4752 5542 204c 6567 6163 7920 of GRUB Legacy │ │ │ │ │ -00002450: 6d61 7920 6e65 6564 2073 6f6d 6520 6775 may need some gu │ │ │ │ │ -00002460: 6964 616e 6365 2074 6f20 6669 6e64 2074 idance to find t │ │ │ │ │ -00002470: 6865 6972 2077 6179 2061 726f 756e 640a heir way around. │ │ │ │ │ -00002480: 7468 6973 206e 6577 2076 6572 7369 6f6e this new version │ │ │ │ │ -00002490: 2e0a 0a20 2020 2a20 5468 6520 636f 6e66 ... * The conf │ │ │ │ │ -000024a0: 6967 7572 6174 696f 6e20 6669 6c65 2068 iguration file h │ │ │ │ │ -000024b0: 6173 2061 206e 6577 206e 616d 6520 2827 as a new name (' │ │ │ │ │ -000024c0: 6772 7562 2e63 6667 2720 7261 7468 6572 grub.cfg' rather │ │ │ │ │ -000024d0: 2074 6861 6e0a 2020 2020 2027 6d65 6e75 than. 'menu │ │ │ │ │ -000024e0: 2e6c 7374 2720 6f72 2027 6772 7562 2e63 .lst' or 'grub.c │ │ │ │ │ -000024f0: 6f6e 6627 292c 206e 6577 2073 796e 7461 onf'), new synta │ │ │ │ │ -00002500: 7820 282a 6e6f 7465 2043 6f6e 6669 6775 x (*note Configu │ │ │ │ │ -00002510: 7261 7469 6f6e 3a3a 2920 616e 640a 2020 ration::) and. │ │ │ │ │ -00002520: 2020 206d 616e 7920 6e65 7720 636f 6d6d many new comm │ │ │ │ │ -00002530: 616e 6473 2028 2a6e 6f74 6520 436f 6d6d ands (*note Comm │ │ │ │ │ -00002540: 616e 6473 3a3a 292e 2020 436f 6e66 6967 ands::). Config │ │ │ │ │ -00002550: 7572 6174 696f 6e20 6361 6e6e 6f74 2062 uration cannot b │ │ │ │ │ -00002560: 650a 2020 2020 2063 6f70 6965 6420 6f76 e. copied ov │ │ │ │ │ -00002570: 6572 2064 6972 6563 746c 792c 2061 6c74 er directly, alt │ │ │ │ │ -00002580: 686f 7567 6820 6d6f 7374 2047 5255 4220 hough most GRUB │ │ │ │ │ -00002590: 4c65 6761 6379 2075 7365 7273 2073 686f Legacy users sho │ │ │ │ │ -000025a0: 756c 6420 6e6f 740a 2020 2020 2066 696e uld not. fin │ │ │ │ │ -000025b0: 6420 7468 6520 7379 6e74 6178 2074 6f6f d the syntax too │ │ │ │ │ -000025c0: 2073 7572 7072 6973 696e 672e 0a0a 2020 surprising... │ │ │ │ │ -000025d0: 202a 2027 6772 7562 2e63 6667 2720 6973 * 'grub.cfg' is │ │ │ │ │ -000025e0: 2074 7970 6963 616c 6c79 2061 7574 6f6d typically autom │ │ │ │ │ -000025f0: 6174 6963 616c 6c79 2067 656e 6572 6174 atically generat │ │ │ │ │ -00002600: 6564 2062 7920 2767 7275 622d 6d6b 636f ed by 'grub-mkco │ │ │ │ │ -00002610: 6e66 6967 270a 2020 2020 2028 2a6e 6f74 nfig'. (*not │ │ │ │ │ -00002620: 6520 5369 6d70 6c65 2063 6f6e 6669 6775 e Simple configu │ │ │ │ │ -00002630: 7261 7469 6f6e 3a3a 292e 2020 5468 6973 ration::). This │ │ │ │ │ -00002640: 206d 616b 6573 2069 7420 6561 7369 6572 makes it easier │ │ │ │ │ -00002650: 2074 6f20 6861 6e64 6c65 0a20 2020 2020 to handle. │ │ │ │ │ -00002660: 7665 7273 696f 6e65 6420 6b65 726e 656c versioned kernel │ │ │ │ │ -00002670: 2075 7067 7261 6465 732e 0a0a 2020 202a upgrades... * │ │ │ │ │ -00002680: 2050 6172 7469 7469 6f6e 206e 756d 6265 Partition numbe │ │ │ │ │ -00002690: 7273 2069 6e20 4752 5542 2064 6576 6963 rs in GRUB devic │ │ │ │ │ -000026a0: 6520 6e61 6d65 7320 6e6f 7720 7374 6172 e names now star │ │ │ │ │ -000026b0: 7420 6174 2031 2c20 6e6f 7420 3020 282a t at 1, not 0 (* │ │ │ │ │ -000026c0: 6e6f 7465 0a20 2020 2020 4e61 6d69 6e67 note. Naming │ │ │ │ │ -000026d0: 2063 6f6e 7665 6e74 696f 6e3a 3a29 2e0a convention::).. │ │ │ │ │ -000026e0: 0a20 2020 2a20 5468 6520 636f 6e66 6967 . * The config │ │ │ │ │ -000026f0: 7572 6174 696f 6e20 6669 6c65 2069 7320 uration file is │ │ │ │ │ -00002700: 6e6f 7720 7772 6974 7465 6e20 696e 2073 now written in s │ │ │ │ │ -00002710: 6f6d 6574 6869 6e67 2063 6c6f 7365 7220 omething closer │ │ │ │ │ -00002720: 746f 2061 2066 756c 6c0a 2020 2020 2073 to a full. s │ │ │ │ │ -00002730: 6372 6970 7469 6e67 206c 616e 6775 6167 cripting languag │ │ │ │ │ -00002740: 653a 2076 6172 6961 626c 6573 2c20 636f e: variables, co │ │ │ │ │ -00002750: 6e64 6974 696f 6e61 6c73 2c20 616e 6420 nditionals, and │ │ │ │ │ -00002760: 6c6f 6f70 7320 6172 650a 2020 2020 2061 loops are. a │ │ │ │ │ -00002770: 7661 696c 6162 6c65 2e0a 0a20 2020 2a20 vailable... * │ │ │ │ │ -00002780: 4120 736d 616c 6c20 616d 6f75 6e74 206f A small amount o │ │ │ │ │ -00002790: 6620 7065 7273 6973 7465 6e74 2073 746f f persistent sto │ │ │ │ │ -000027a0: 7261 6765 2069 7320 6176 6169 6c61 626c rage is availabl │ │ │ │ │ -000027b0: 6520 6163 726f 7373 2072 6562 6f6f 7473 e across reboots │ │ │ │ │ -000027c0: 2c0a 2020 2020 2075 7369 6e67 2074 6865 ,. using the │ │ │ │ │ -000027d0: 2027 7361 7665 5f65 6e76 2720 616e 6420 'save_env' and │ │ │ │ │ -000027e0: 276c 6f61 645f 656e 7627 2063 6f6d 6d61 'load_env' comma │ │ │ │ │ -000027f0: 6e64 7320 696e 2047 5255 4220 616e 6420 nds in GRUB and │ │ │ │ │ -00002800: 7468 650a 2020 2020 2027 6772 7562 2d65 the. 'grub-e │ │ │ │ │ -00002810: 6469 7465 6e76 2720 7574 696c 6974 792e ditenv' utility. │ │ │ │ │ -00002820: 2020 5468 6973 2069 7320 6e6f 7420 6176 This is not av │ │ │ │ │ -00002830: 6169 6c61 626c 6520 696e 2061 6c6c 0a20 ailable in all. │ │ │ │ │ -00002840: 2020 2020 636f 6e66 6967 7572 6174 696f configuratio │ │ │ │ │ -00002850: 6e73 2028 2a6e 6f74 6520 456e 7669 726f ns (*note Enviro │ │ │ │ │ -00002860: 6e6d 656e 7420 626c 6f63 6b3a 3a29 2e0a nment block::).. │ │ │ │ │ -00002870: 0a20 2020 2a20 4752 5542 2032 2068 6173 . * GRUB 2 has │ │ │ │ │ -00002880: 206d 6f72 6520 7265 6c69 6162 6c65 2077 more reliable w │ │ │ │ │ -00002890: 6179 7320 746f 2066 696e 6420 6974 7320 ays to find its │ │ │ │ │ -000028a0: 6f77 6e20 6669 6c65 7320 616e 6420 7468 own files and th │ │ │ │ │ -000028b0: 6f73 6520 6f66 0a20 2020 2020 7461 7267 ose of. targ │ │ │ │ │ -000028c0: 6574 206b 6572 6e65 6c73 206f 6e20 6d75 et kernels on mu │ │ │ │ │ -000028d0: 6c74 6970 6c65 2d64 6973 6b20 7379 7374 ltiple-disk syst │ │ │ │ │ -000028e0: 656d 732c 2061 6e64 2068 6173 2063 6f6d ems, and has com │ │ │ │ │ -000028f0: 6d61 6e64 7320 282a 6e6f 7465 0a20 2020 mands (*note. │ │ │ │ │ -00002900: 2020 7365 6172 6368 3a3a 2920 746f 2066 search::) to f │ │ │ │ │ -00002910: 696e 6420 6465 7669 6365 7320 7573 696e ind devices usin │ │ │ │ │ -00002920: 6720 6669 6c65 2073 7973 7465 6d20 6c61 g file system la │ │ │ │ │ -00002930: 6265 6c73 206f 7220 556e 6976 6572 7361 bels or Universa │ │ │ │ │ -00002940: 6c6c 790a 2020 2020 2055 6e69 7175 6520 lly. Unique │ │ │ │ │ -00002950: 4964 656e 7469 6669 6572 7320 2855 5549 Identifiers (UUI │ │ │ │ │ -00002960: 4473 292e 0a0a 2020 202a 2047 5255 4220 Ds)... * GRUB │ │ │ │ │ -00002970: 3220 6973 2061 7661 696c 6162 6c65 2066 2 is available f │ │ │ │ │ -00002980: 6f72 2073 6576 6572 616c 206f 7468 6572 or several other │ │ │ │ │ -00002990: 2074 7970 6573 206f 6620 7379 7374 656d types of system │ │ │ │ │ -000029a0: 2069 6e20 6164 6469 7469 6f6e 0a20 2020 in addition. │ │ │ │ │ -000029b0: 2020 746f 2074 6865 2050 4320 4249 4f53 to the PC BIOS │ │ │ │ │ -000029c0: 2073 7973 7465 6d73 2073 7570 706f 7274 systems support │ │ │ │ │ -000029d0: 6564 2062 7920 4752 5542 204c 6567 6163 ed by GRUB Legac │ │ │ │ │ -000029e0: 793a 2050 4320 4546 492c 2050 430a 2020 y: PC EFI, PC. │ │ │ │ │ -000029f0: 2020 2063 6f72 6562 6f6f 742c 2050 6f77 coreboot, Pow │ │ │ │ │ -00002a00: 6572 5043 2c20 5350 4152 432c 2061 6e64 erPC, SPARC, and │ │ │ │ │ -00002a10: 204d 4950 5320 4c65 6d6f 7465 2059 6565 MIPS Lemote Yee │ │ │ │ │ -00002a20: 6c6f 6f6e 6720 6172 6520 616c 6c0a 2020 loong are all. │ │ │ │ │ -00002a30: 2020 2073 7570 706f 7274 6564 2e0a 0a20 supported... │ │ │ │ │ -00002a40: 2020 2a20 4d61 6e79 206d 6f72 6520 6669 * Many more fi │ │ │ │ │ -00002a50: 6c65 2073 7973 7465 6d73 2061 7265 2073 le systems are s │ │ │ │ │ -00002a60: 7570 706f 7274 6564 2c20 696e 636c 7564 upported, includ │ │ │ │ │ -00002a70: 696e 6720 6275 7420 6e6f 7420 6c69 6d69 ing but not limi │ │ │ │ │ -00002a80: 7465 6420 746f 0a20 2020 2020 6578 7434 ted to. ext4 │ │ │ │ │ -00002a90: 2c20 4846 532b 2c20 616e 6420 4e54 4653 , HFS+, and NTFS │ │ │ │ │ -00002aa0: 2e0a 0a20 2020 2a20 4752 5542 2032 2063 ... * GRUB 2 c │ │ │ │ │ -00002ab0: 616e 2072 6561 6420 6669 6c65 7320 6469 an read files di │ │ │ │ │ -00002ac0: 7265 6374 6c79 2066 726f 6d20 4c56 4d20 rectly from LVM │ │ │ │ │ -00002ad0: 616e 6420 5241 4944 2064 6576 6963 6573 and RAID devices │ │ │ │ │ -00002ae0: 2e0a 0a20 2020 2a20 4120 6772 6170 6869 ... * A graphi │ │ │ │ │ -00002af0: 6361 6c20 7465 726d 696e 616c 2061 6e64 cal terminal and │ │ │ │ │ -00002b00: 2061 2067 7261 7068 6963 616c 206d 656e a graphical men │ │ │ │ │ -00002b10: 7520 7379 7374 656d 2061 7265 2061 7661 u system are ava │ │ │ │ │ -00002b20: 696c 6162 6c65 2e0a 0a20 2020 2a20 4752 ilable... * GR │ │ │ │ │ -00002b30: 5542 2032 2773 2069 6e74 6572 6661 6365 UB 2's interface │ │ │ │ │ -00002b40: 2063 616e 2062 6520 7472 616e 736c 6174 can be translat │ │ │ │ │ -00002b50: 6564 2c20 696e 636c 7564 696e 6720 6d65 ed, including me │ │ │ │ │ -00002b60: 6e75 2065 6e74 7279 206e 616d 6573 2e0a nu entry names.. │ │ │ │ │ -00002b70: 0a20 2020 2a20 5468 6520 696d 6167 6520 . * The image │ │ │ │ │ -00002b80: 6669 6c65 7320 282a 6e6f 7465 2049 6d61 files (*note Ima │ │ │ │ │ -00002b90: 6765 733a 3a29 2074 6861 7420 6d61 6b65 ges::) that make │ │ │ │ │ -00002ba0: 2075 7020 4752 5542 2068 6176 6520 6265 up GRUB have be │ │ │ │ │ -00002bb0: 656e 0a20 2020 2020 7265 6f72 6761 6e69 en. reorgani │ │ │ │ │ -00002bc0: 7365 643b 2053 7461 6765 2031 2c20 5374 sed; Stage 1, St │ │ │ │ │ -00002bd0: 6167 6520 312e 352c 2061 6e64 2053 7461 age 1.5, and Sta │ │ │ │ │ -00002be0: 6765 2032 2061 7265 206e 6f20 6d6f 7265 ge 2 are no more │ │ │ │ │ -00002bf0: 2e0a 0a20 2020 2a20 4752 5542 2032 2070 ... * GRUB 2 p │ │ │ │ │ -00002c00: 7574 7320 6d61 6e79 2066 6163 696c 6974 uts many facilit │ │ │ │ │ -00002c10: 6965 7320 696e 2064 796e 616d 6963 616c ies in dynamical │ │ │ │ │ -00002c20: 6c79 206c 6f61 6465 6420 6d6f 6475 6c65 ly loaded module │ │ │ │ │ -00002c30: 732c 2061 6c6c 6f77 696e 670a 2020 2020 s, allowing. │ │ │ │ │ -00002c40: 2074 6865 2063 6f72 6520 696d 6167 6520 the core image │ │ │ │ │ -00002c50: 746f 2062 6520 736d 616c 6c65 722c 2061 to be smaller, a │ │ │ │ │ -00002c60: 6e64 2061 6c6c 6f77 696e 6720 7468 6520 nd allowing the │ │ │ │ │ -00002c70: 636f 7265 2069 6d61 6765 2074 6f20 6265 core image to be │ │ │ │ │ -00002c80: 0a20 2020 2020 6275 696c 7420 696e 206d . built in m │ │ │ │ │ -00002c90: 6f72 6520 666c 6578 6962 6c65 2077 6179 ore flexible way │ │ │ │ │ -00002ca0: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ -00002cb0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4665 .info, Node: Fe │ │ │ │ │ -00002cc0: 6174 7572 6573 2c20 204e 6578 743a 2052 atures, Next: R │ │ │ │ │ -00002cd0: 6f6c 6520 6f66 2061 2062 6f6f 7420 6c6f ole of a boot lo │ │ │ │ │ -00002ce0: 6164 6572 2c20 2050 7265 763a 2043 6861 ader, Prev: Cha │ │ │ │ │ -00002cf0: 6e67 6573 2066 726f 6d20 4752 5542 204c nges from GRUB L │ │ │ │ │ -00002d00: 6567 6163 792c 2020 5570 3a20 496e 7472 egacy, Up: Intr │ │ │ │ │ -00002d10: 6f64 7563 7469 6f6e 0a0a 312e 3420 4752 oduction..1.4 GR │ │ │ │ │ -00002d20: 5542 2066 6561 7475 7265 730a 3d3d 3d3d UB features.==== │ │ │ │ │ -00002d30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 =============..T │ │ │ │ │ -00002d40: 6865 2070 7269 6d61 7279 2072 6571 7569 he primary requi │ │ │ │ │ -00002d50: 7265 6d65 6e74 2066 6f72 2047 5255 4220 rement for GRUB │ │ │ │ │ -00002d60: 6973 2074 6861 7420 6974 2062 6520 636f is that it be co │ │ │ │ │ -00002d70: 6d70 6c69 616e 7420 7769 7468 2074 6865 mpliant with the │ │ │ │ │ -00002d80: 0a22 4d75 6c74 6962 6f6f 7420 5370 6563 ."Multiboot Spec │ │ │ │ │ -00002d90: 6966 6963 6174 696f 6e22 2c20 7768 6963 ification", whic │ │ │ │ │ -00002da0: 6820 6973 2064 6573 6372 6962 6564 2069 h is described i │ │ │ │ │ -00002db0: 6e20 2a6e 6f74 6520 4d75 6c74 6962 6f6f n *note Multiboo │ │ │ │ │ -00002dc0: 740a 5370 6563 6966 6963 6174 696f 6e3a t.Specification: │ │ │ │ │ -00002dd0: 2028 6d75 6c74 6962 6f6f 7429 546f 702e (multiboot)Top. │ │ │ │ │ -00002de0: 0a0a 2020 2054 6865 206f 7468 6572 2067 .. The other g │ │ │ │ │ -00002df0: 6f61 6c73 2c20 6c69 7374 6564 2069 6e20 oals, listed in │ │ │ │ │ -00002e00: 6170 7072 6f78 696d 6174 6520 6f72 6465 approximate orde │ │ │ │ │ -00002e10: 7220 6f66 2069 6d70 6f72 7461 6e63 652c r of importance, │ │ │ │ │ -00002e20: 2061 7265 3a0a 0a20 2020 2a20 4261 7369 are:.. * Basi │ │ │ │ │ -00002e30: 6320 6675 6e63 7469 6f6e 7320 6d75 7374 c functions must │ │ │ │ │ -00002e40: 2062 6520 7374 7261 6967 6874 666f 7277 be straightforw │ │ │ │ │ -00002e50: 6172 6420 666f 7220 656e 642d 7573 6572 ard for end-user │ │ │ │ │ -00002e60: 732e 0a0a 2020 202a 2052 6963 6820 6675 s... * Rich fu │ │ │ │ │ -00002e70: 6e63 7469 6f6e 616c 6974 7920 746f 2073 nctionality to s │ │ │ │ │ -00002e80: 7570 706f 7274 206b 6572 6e65 6c20 6578 upport kernel ex │ │ │ │ │ -00002e90: 7065 7274 7320 616e 6420 6465 7369 676e perts and design │ │ │ │ │ -00002ea0: 6572 732e 0a0a 2020 202a 2042 6163 6b77 ers... * Backw │ │ │ │ │ -00002eb0: 6172 6420 636f 6d70 6174 6962 696c 6974 ard compatibilit │ │ │ │ │ -00002ec0: 7920 666f 7220 626f 6f74 696e 6720 4672 y for booting Fr │ │ │ │ │ -00002ed0: 6565 4253 442c 204e 6574 4253 442c 204f eeBSD, NetBSD, O │ │ │ │ │ -00002ee0: 7065 6e42 5344 2c20 616e 640a 2020 2020 penBSD, and. │ │ │ │ │ -00002ef0: 204c 696e 7578 2e20 2050 726f 7072 6965 Linux. Proprie │ │ │ │ │ -00002f00: 7461 7279 206b 6572 6e65 6c73 2028 7375 tary kernels (su │ │ │ │ │ -00002f10: 6368 2061 7320 444f 532c 2057 696e 646f ch as DOS, Windo │ │ │ │ │ -00002f20: 7773 204e 542c 2061 6e64 204f 532f 3229 ws NT, and OS/2) │ │ │ │ │ -00002f30: 2061 7265 0a20 2020 2020 7375 7070 6f72 are. suppor │ │ │ │ │ -00002f40: 7465 6420 7669 6120 6120 6368 6169 6e2d ted via a chain- │ │ │ │ │ -00002f50: 6c6f 6164 696e 6720 6675 6e63 7469 6f6e loading function │ │ │ │ │ -00002f60: 2e0a 0a20 2020 4578 6365 7074 2066 6f72 ... Except for │ │ │ │ │ -00002f70: 2073 7065 6369 6669 6320 636f 6d70 6174 specific compat │ │ │ │ │ -00002f80: 6962 696c 6974 7920 6d6f 6465 7320 2863 ibility modes (c │ │ │ │ │ -00002f90: 6861 696e 2d6c 6f61 6469 6e67 2061 6e64 hain-loading and │ │ │ │ │ -00002fa0: 2074 6865 204c 696e 7578 0a22 7069 6767 the Linux."pigg │ │ │ │ │ -00002fb0: 7962 6163 6b22 2066 6f72 6d61 7429 2c20 yback" format), │ │ │ │ │ -00002fc0: 616c 6c20 6b65 726e 656c 7320 7769 6c6c all kernels will │ │ │ │ │ -00002fd0: 2062 6520 7374 6172 7465 6420 696e 206d be started in m │ │ │ │ │ -00002fe0: 7563 6820 7468 6520 7361 6d65 2073 7461 uch the same sta │ │ │ │ │ -00002ff0: 7465 0a61 7320 696e 2074 6865 204d 756c te.as in the Mul │ │ │ │ │ -00003000: 7469 626f 6f74 2053 7065 6369 6669 6361 tiboot Specifica │ │ │ │ │ -00003010: 7469 6f6e 2e20 204f 6e6c 7920 6b65 726e tion. Only kern │ │ │ │ │ -00003020: 656c 7320 6c6f 6164 6564 2061 7420 3120 els loaded at 1 │ │ │ │ │ -00003030: 6d65 6761 6279 7465 206f 720a 6162 6f76 megabyte or.abov │ │ │ │ │ -00003040: 6520 6172 6520 7072 6573 656e 746c 7920 e are presently │ │ │ │ │ -00003050: 7375 7070 6f72 7465 642e 2020 416e 7920 supported. Any │ │ │ │ │ -00003060: 6174 7465 6d70 7420 746f 206c 6f61 6420 attempt to load │ │ │ │ │ -00003070: 6265 6c6f 7720 7468 6174 2062 6f75 6e64 below that bound │ │ │ │ │ -00003080: 6172 790a 7769 6c6c 2073 696d 706c 7920 ary.will simply │ │ │ │ │ -00003090: 7265 7375 6c74 2069 6e20 696d 6d65 6469 result in immedi │ │ │ │ │ -000030a0: 6174 6520 6661 696c 7572 6520 616e 6420 ate failure and │ │ │ │ │ -000030b0: 616e 2065 7272 6f72 206d 6573 7361 6765 an error message │ │ │ │ │ -000030c0: 2072 6570 6f72 7469 6e67 0a74 6865 2070 reporting.the p │ │ │ │ │ -000030d0: 726f 626c 656d 2e0a 0a20 2020 496e 2061 roblem... In a │ │ │ │ │ -000030e0: 6464 6974 696f 6e20 746f 2074 6865 2072 ddition to the r │ │ │ │ │ -000030f0: 6571 7569 7265 6d65 6e74 7320 6162 6f76 equirements abov │ │ │ │ │ -00003100: 652c 2047 5255 4220 6861 7320 7468 6520 e, GRUB has the │ │ │ │ │ -00003110: 666f 6c6c 6f77 696e 670a 6665 6174 7572 following.featur │ │ │ │ │ -00003120: 6573 2028 6e6f 7465 2074 6861 7420 7468 es (note that th │ │ │ │ │ -00003130: 6520 4d75 6c74 6962 6f6f 7420 5370 6563 e Multiboot Spec │ │ │ │ │ -00003140: 6966 6963 6174 696f 6e20 646f 6573 6e27 ification doesn' │ │ │ │ │ -00003150: 7420 7265 7175 6972 6520 616c 6c20 7468 t require all th │ │ │ │ │ -00003160: 650a 6665 6174 7572 6573 2074 6861 7420 e.features that │ │ │ │ │ -00003170: 4752 5542 2073 7570 706f 7274 7329 3a0a GRUB supports):. │ │ │ │ │ -00003180: 0a52 6563 6f67 6e69 7a65 206d 756c 7469 .Recognize multi │ │ │ │ │ -00003190: 706c 6520 6578 6563 7574 6162 6c65 2066 ple executable f │ │ │ │ │ -000031a0: 6f72 6d61 7473 0a20 2020 2020 5375 7070 ormats. Supp │ │ │ │ │ -000031b0: 6f72 7420 6d61 6e79 206f 6620 7468 6520 ort many of the │ │ │ │ │ -000031c0: 2261 2e6f 7574 2220 7661 7269 616e 7473 "a.out" variants │ │ │ │ │ -000031d0: 2070 6c75 7320 2245 4c46 222e 2053 796d plus "ELF". Sym │ │ │ │ │ -000031e0: 626f 6c20 7461 626c 6573 2061 7265 0a20 bol tables are. │ │ │ │ │ -000031f0: 2020 2020 616c 736f 206c 6f61 6465 642e also loaded. │ │ │ │ │ -00003200: 0a0a 5375 7070 6f72 7420 6e6f 6e2d 4d75 ..Support non-Mu │ │ │ │ │ -00003210: 6c74 6962 6f6f 7420 6b65 726e 656c 730a ltiboot kernels. │ │ │ │ │ -00003220: 2020 2020 2053 7570 706f 7274 206d 616e Support man │ │ │ │ │ -00003230: 7920 6f66 2074 6865 2076 6172 696f 7573 y of the various │ │ │ │ │ -00003240: 2066 7265 6520 3332 2d62 6974 206b 6572 free 32-bit ker │ │ │ │ │ -00003250: 6e65 6c73 2074 6861 7420 6c61 636b 204d nels that lack M │ │ │ │ │ -00003260: 756c 7469 626f 6f74 0a20 2020 2020 636f ultiboot. co │ │ │ │ │ -00003270: 6d70 6c69 616e 6365 2028 7072 696d 6172 mpliance (primar │ │ │ │ │ -00003280: 696c 7920 4672 6565 4253 442c 204e 6574 ily FreeBSD, Net │ │ │ │ │ -00003290: 4253 4428 3129 2028 2a6e 6f74 650a 2020 BSD(1) (*note. │ │ │ │ │ -000032a0: 2020 2046 6561 7475 7265 732d 466f 6f74 Features-Foot │ │ │ │ │ -000032b0: 6e6f 7465 2d31 3a3a 292c 204f 7065 6e42 note-1::), OpenB │ │ │ │ │ -000032c0: 5344 2c20 616e 6420 4c69 6e75 7829 2e20 SD, and Linux). │ │ │ │ │ -000032d0: 2043 6861 696e 2d6c 6f61 6469 6e67 206f Chain-loading o │ │ │ │ │ -000032e0: 660a 2020 2020 206f 7468 6572 2062 6f6f f. other boo │ │ │ │ │ -000032f0: 7420 6c6f 6164 6572 7320 6973 2061 6c73 t loaders is als │ │ │ │ │ -00003300: 6f20 7375 7070 6f72 7465 642e 0a0a 4c6f o supported...Lo │ │ │ │ │ -00003310: 6164 206d 756c 7469 706c 6573 206d 6f64 ad multiples mod │ │ │ │ │ -00003320: 756c 6573 0a20 2020 2020 4675 6c6c 7920 ules. Fully │ │ │ │ │ -00003330: 7375 7070 6f72 7420 7468 6520 4d75 6c74 support the Mult │ │ │ │ │ -00003340: 6962 6f6f 7420 6665 6174 7572 6520 6f66 iboot feature of │ │ │ │ │ -00003350: 206c 6f61 6469 6e67 206d 756c 7469 706c loading multipl │ │ │ │ │ -00003360: 6520 6d6f 6475 6c65 732e 0a0a 4c6f 6164 e modules...Load │ │ │ │ │ -00003370: 2061 2063 6f6e 6669 6775 7261 7469 6f6e a configuration │ │ │ │ │ -00003380: 2066 696c 650a 2020 2020 2053 7570 706f file. Suppo │ │ │ │ │ -00003390: 7274 2061 2068 756d 616e 2d72 6561 6461 rt a human-reada │ │ │ │ │ -000033a0: 626c 6520 7465 7874 2063 6f6e 6669 6775 ble text configu │ │ │ │ │ -000033b0: 7261 7469 6f6e 2066 696c 6520 7769 7468 ration file with │ │ │ │ │ -000033c0: 2070 7265 7365 7420 626f 6f74 0a20 2020 preset boot. │ │ │ │ │ -000033d0: 2020 636f 6d6d 616e 6473 2e20 2059 6f75 commands. You │ │ │ │ │ -000033e0: 2063 616e 2061 6c73 6f20 6c6f 6164 2061 can also load a │ │ │ │ │ -000033f0: 6e6f 7468 6572 2063 6f6e 6669 6775 7261 nother configura │ │ │ │ │ -00003400: 7469 6f6e 2066 696c 6520 6479 6e61 6d69 tion file dynami │ │ │ │ │ -00003410: 6361 6c6c 790a 2020 2020 2061 6e64 2065 cally. and e │ │ │ │ │ -00003420: 6d62 6564 2061 2070 7265 7365 7420 636f mbed a preset co │ │ │ │ │ -00003430: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ -00003440: 2069 6e20 6120 4752 5542 2069 6d61 6765 in a GRUB image │ │ │ │ │ -00003450: 2066 696c 652e 2020 5468 650a 2020 2020 file. The. │ │ │ │ │ -00003460: 206c 6973 7420 6f66 2063 6f6d 6d61 6e64 list of command │ │ │ │ │ -00003470: 7320 282a 6e6f 7465 2043 6f6d 6d61 6e64 s (*note Command │ │ │ │ │ -00003480: 733a 3a29 2061 7265 2061 2073 7570 6572 s::) are a super │ │ │ │ │ -00003490: 7365 7420 6f66 2074 686f 7365 0a20 2020 set of those. │ │ │ │ │ -000034a0: 2020 7375 7070 6f72 7465 6420 6f6e 2074 supported on t │ │ │ │ │ -000034b0: 6865 2063 6f6d 6d61 6e64 2d6c 696e 652e he command-line. │ │ │ │ │ -000034c0: 2020 416e 2065 7861 6d70 6c65 2063 6f6e An example con │ │ │ │ │ -000034d0: 6669 6775 7261 7469 6f6e 2066 696c 6520 figuration file │ │ │ │ │ -000034e0: 6973 0a20 2020 2020 7072 6f76 6964 6564 is. provided │ │ │ │ │ -000034f0: 2069 6e20 2a6e 6f74 6520 436f 6e66 6967 in *note Config │ │ │ │ │ -00003500: 7572 6174 696f 6e3a 3a2e 0a0a 5072 6f76 uration::...Prov │ │ │ │ │ -00003510: 6964 6520 6120 6d65 6e75 2069 6e74 6572 ide a menu inter │ │ │ │ │ -00003520: 6661 6365 0a20 2020 2020 4120 6d65 6e75 face. A menu │ │ │ │ │ -00003530: 2069 6e74 6572 6661 6365 206c 6973 7469 interface listi │ │ │ │ │ -00003540: 6e67 2070 7265 7365 7420 626f 6f74 2063 ng preset boot c │ │ │ │ │ -00003550: 6f6d 6d61 6e64 732c 2077 6974 6820 6120 ommands, with a │ │ │ │ │ -00003560: 7072 6f67 7261 6d6d 6162 6c65 0a20 2020 programmable. │ │ │ │ │ -00003570: 2020 7469 6d65 6f75 742c 2069 7320 6176 timeout, is av │ │ │ │ │ -00003580: 6169 6c61 626c 652e 2020 5468 6572 6520 ailable. There │ │ │ │ │ -00003590: 6973 206e 6f20 6669 7865 6420 6c69 6d69 is no fixed limi │ │ │ │ │ -000035a0: 7420 6f6e 2074 6865 206e 756d 6265 7220 t on the number │ │ │ │ │ -000035b0: 6f66 0a20 2020 2020 626f 6f74 2065 6e74 of. boot ent │ │ │ │ │ -000035c0: 7269 6573 2c20 616e 6420 7468 6520 6375 ries, and the cu │ │ │ │ │ -000035d0: 7272 656e 7420 696d 706c 656d 656e 7461 rrent implementa │ │ │ │ │ -000035e0: 7469 6f6e 2068 6173 2073 7061 6365 2066 tion has space f │ │ │ │ │ -000035f0: 6f72 2073 6576 6572 616c 0a20 2020 2020 or several. │ │ │ │ │ -00003600: 6875 6e64 7265 642e 0a0a 4861 7665 2061 hundred...Have a │ │ │ │ │ -00003610: 2066 6c65 7869 626c 6520 636f 6d6d 616e flexible comman │ │ │ │ │ -00003620: 642d 6c69 6e65 2069 6e74 6572 6661 6365 d-line interface │ │ │ │ │ -00003630: 0a20 2020 2020 4120 6661 6972 6c79 2066 . A fairly f │ │ │ │ │ -00003640: 6c65 7869 626c 6520 636f 6d6d 616e 642d lexible command- │ │ │ │ │ -00003650: 6c69 6e65 2069 6e74 6572 6661 6365 2c20 line interface, │ │ │ │ │ -00003660: 6163 6365 7373 6962 6c65 2066 726f 6d20 accessible from │ │ │ │ │ -00003670: 7468 6520 6d65 6e75 2c0a 2020 2020 2069 the menu,. i │ │ │ │ │ -00003680: 7320 6176 6169 6c61 626c 6520 746f 2065 s available to e │ │ │ │ │ -00003690: 6469 7420 616e 7920 7072 6573 6574 2063 dit any preset c │ │ │ │ │ -000036a0: 6f6d 6d61 6e64 732c 206f 7220 7772 6974 ommands, or writ │ │ │ │ │ -000036b0: 6520 6120 6e65 7720 626f 6f74 0a20 2020 e a new boot. │ │ │ │ │ -000036c0: 2020 636f 6d6d 616e 6420 7365 7420 6672 command set fr │ │ │ │ │ -000036d0: 6f6d 2073 6372 6174 6368 2e20 2049 6620 om scratch. If │ │ │ │ │ -000036e0: 6e6f 2063 6f6e 6669 6775 7261 7469 6f6e no configuration │ │ │ │ │ -000036f0: 2066 696c 6520 6973 2070 7265 7365 6e74 file is present │ │ │ │ │ -00003700: 2c0a 2020 2020 2047 5255 4220 6472 6f70 ,. GRUB drop │ │ │ │ │ -00003710: 7320 746f 2074 6865 2063 6f6d 6d61 6e64 s to the command │ │ │ │ │ -00003720: 2d6c 696e 652e 0a0a 2020 2020 2054 6865 -line... The │ │ │ │ │ -00003730: 206c 6973 7420 6f66 2063 6f6d 6d61 6e64 list of command │ │ │ │ │ -00003740: 7320 282a 6e6f 7465 2043 6f6d 6d61 6e64 s (*note Command │ │ │ │ │ -00003750: 733a 3a29 2061 7265 2061 2073 7562 7365 s::) are a subse │ │ │ │ │ -00003760: 7420 6f66 2074 686f 7365 0a20 2020 2020 t of those. │ │ │ │ │ -00003770: 7375 7070 6f72 7465 6420 666f 7220 636f supported for co │ │ │ │ │ -00003780: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ -00003790: 732e 2020 4564 6974 696e 6720 636f 6d6d s. Editing comm │ │ │ │ │ -000037a0: 616e 6473 2063 6c6f 7365 6c79 0a20 2020 ands closely. │ │ │ │ │ -000037b0: 2020 7265 7365 6d62 6c65 7320 7468 6520 resembles the │ │ │ │ │ -000037c0: 4261 7368 2063 6f6d 6d61 6e64 2d6c 696e Bash command-lin │ │ │ │ │ -000037d0: 6520 282a 6e6f 7465 2042 6173 683a 2028 e (*note Bash: ( │ │ │ │ │ -000037e0: 6665 6174 7572 6573 2943 6f6d 6d61 6e64 features)Command │ │ │ │ │ -000037f0: 204c 696e 650a 2020 2020 2045 6469 7469 Line. Editi │ │ │ │ │ -00003800: 6e67 2e29 2c20 7769 7468 203c 5441 423e ng.), with │ │ │ │ │ -00003810: 2d63 6f6d 706c 6574 696f 6e20 6f66 2063 -completion of c │ │ │ │ │ -00003820: 6f6d 6d61 6e64 732c 2064 6576 6963 6573 ommands, devices │ │ │ │ │ -00003830: 2c20 7061 7274 6974 696f 6e73 2c0a 2020 , partitions,. │ │ │ │ │ -00003840: 2020 2061 6e64 2066 696c 6573 2069 6e20 and files in │ │ │ │ │ -00003850: 6120 6469 7265 6374 6f72 7920 6465 7065 a directory depe │ │ │ │ │ -00003860: 6e64 696e 6720 6f6e 2063 6f6e 7465 7874 nding on context │ │ │ │ │ -00003870: 2e0a 0a53 7570 706f 7274 206d 756c 7469 ...Support multi │ │ │ │ │ -00003880: 706c 6520 6669 6c65 7379 7374 656d 2074 ple filesystem t │ │ │ │ │ -00003890: 7970 6573 0a20 2020 2020 5375 7070 6f72 ypes. Suppor │ │ │ │ │ -000038a0: 7420 6d75 6c74 6970 6c65 2066 696c 6573 t multiple files │ │ │ │ │ -000038b0: 7973 7465 6d20 7479 7065 7320 7472 616e ystem types tran │ │ │ │ │ -000038c0: 7370 6172 656e 746c 792c 2070 6c75 7320 sparently, plus │ │ │ │ │ -000038d0: 6120 7573 6566 756c 0a20 2020 2020 6578 a useful. ex │ │ │ │ │ -000038e0: 706c 6963 6974 2062 6c6f 636b 6c69 7374 plicit blocklist │ │ │ │ │ -000038f0: 206e 6f74 6174 696f 6e2e 2020 5468 6520 notation. The │ │ │ │ │ -00003900: 6375 7272 656e 746c 7920 7375 7070 6f72 currently suppor │ │ │ │ │ -00003910: 7465 6420 6669 6c65 7379 7374 656d 0a20 ted filesystem. │ │ │ │ │ -00003920: 2020 2020 7479 7065 7320 6172 6520 2241 types are "A │ │ │ │ │ -00003930: 6d69 6761 2046 6173 7420 4669 6c65 5379 miga Fast FileSy │ │ │ │ │ -00003940: 7374 656d 2028 4146 4653 2922 2c20 2241 stem (AFFS)", "A │ │ │ │ │ -00003950: 7468 654f 5320 6673 222c 2022 4265 4653 theOS fs", "BeFS │ │ │ │ │ -00003960: 222c 0a20 2020 2020 2242 7472 4653 2220 ",. "BtrFS" │ │ │ │ │ -00003970: 2869 6e63 6c75 6469 6e67 2072 6169 6430 (including raid0 │ │ │ │ │ -00003980: 2c20 7261 6964 312c 2072 6169 6431 302c , raid1, raid10, │ │ │ │ │ -00003990: 2067 7a69 7020 616e 6420 6c7a 6f29 2c20 gzip and lzo), │ │ │ │ │ -000039a0: 2263 7069 6f22 0a20 2020 2020 286c 6974 "cpio". (lit │ │ │ │ │ -000039b0: 746c 652d 2061 6e64 2062 6967 2d65 6e64 tle- and big-end │ │ │ │ │ -000039c0: 6961 6e20 6269 6e2c 206f 6463 2061 6e64 ian bin, odc and │ │ │ │ │ -000039d0: 206e 6577 6320 7661 7269 616e 7473 292c newc variants), │ │ │ │ │ -000039e0: 2022 4c69 6e75 780a 2020 2020 2065 7874 "Linux. ext │ │ │ │ │ -000039f0: 322f 6578 7433 2f65 7874 3422 2c20 2244 2/ext3/ext4", "D │ │ │ │ │ -00003a00: 4f53 2046 4154 3132 2f46 4154 3136 2f46 OS FAT12/FAT16/F │ │ │ │ │ -00003a10: 4154 3332 222c 2022 6578 4641 5422 2c20 AT32", "exFAT", │ │ │ │ │ -00003a20: 2246 3246 5322 2c20 2248 4653 222c 0a20 "F2FS", "HFS",. │ │ │ │ │ -00003a30: 2020 2020 2248 4653 2b22 2c20 2249 534f "HFS+", "ISO │ │ │ │ │ -00003a40: 3936 3630 2220 2869 6e63 6c75 6469 6e67 9660" (including │ │ │ │ │ -00003a50: 204a 6f6c 6965 742c 2052 6f63 6b2d 7269 Joliet, Rock-ri │ │ │ │ │ -00003a60: 6467 6520 616e 6420 6d75 6c74 692d 6368 dge and multi-ch │ │ │ │ │ -00003a70: 756e 6b0a 2020 2020 2066 696c 6573 292c unk. files), │ │ │ │ │ -00003a80: 2022 4a46 5322 2c20 224d 696e 6978 2066 "JFS", "Minix f │ │ │ │ │ -00003a90: 7322 2028 7665 7273 696f 6e73 2031 2c20 s" (versions 1, │ │ │ │ │ -00003aa0: 3220 616e 6420 3329 2c20 226e 696c 6673 2 and 3), "nilfs │ │ │ │ │ -00003ab0: 3222 2c20 224e 5446 5322 0a20 2020 2020 2", "NTFS". │ │ │ │ │ -00003ac0: 2869 6e63 6c75 6469 6e67 2063 6f6d 7072 (including compr │ │ │ │ │ -00003ad0: 6573 7369 6f6e 292c 2022 5265 6973 6572 ession), "Reiser │ │ │ │ │ -00003ae0: 4653 222c 2022 524f 4d46 5322 2c20 2241 FS", "ROMFS", "A │ │ │ │ │ -00003af0: 6d69 6761 2053 6d61 7274 0a20 2020 2020 miga Smart. │ │ │ │ │ -00003b00: 4669 6c65 5379 7374 656d 2028 5346 5329 FileSystem (SFS) │ │ │ │ │ -00003b10: 222c 2022 5371 7561 7368 3422 2c20 2274 ", "Squash4", "t │ │ │ │ │ -00003b20: 6172 222c 2022 5544 4622 2c20 2242 5344 ar", "UDF", "BSD │ │ │ │ │ -00003b30: 2055 4653 2f55 4653 3222 2c20 2258 4653 UFS/UFS2", "XFS │ │ │ │ │ -00003b40: 222c 0a20 2020 2020 616e 6420 225a 4653 ",. and "ZFS │ │ │ │ │ -00003b50: 2220 2869 6e63 6c75 6469 6e67 206c 7a6a " (including lzj │ │ │ │ │ -00003b60: 622c 2067 7a69 702c 207a 6c65 2c20 6d69 b, gzip, zle, mi │ │ │ │ │ -00003b70: 7272 6f72 2c20 7374 7269 7065 2c20 7261 rror, stripe, ra │ │ │ │ │ -00003b80: 6964 7a31 2f32 2f33 0a20 2020 2020 616e idz1/2/3. an │ │ │ │ │ -00003b90: 6420 656e 6372 7970 7469 6f6e 2069 6e20 d encryption in │ │ │ │ │ -00003ba0: 4145 532d 4343 4d20 616e 6420 4145 532d AES-CCM and AES- │ │ │ │ │ -00003bb0: 4743 4d29 2e20 2a4e 6f74 6520 4669 6c65 GCM). *Note File │ │ │ │ │ -00003bc0: 7379 7374 656d 3a3a 2c20 666f 720a 2020 system::, for. │ │ │ │ │ -00003bd0: 2020 206d 6f72 6520 696e 666f 726d 6174 more informat │ │ │ │ │ -00003be0: 696f 6e2e 0a0a 5375 7070 6f72 7420 6175 ion...Support au │ │ │ │ │ -00003bf0: 746f 6d61 7469 6320 6465 636f 6d70 7265 tomatic decompre │ │ │ │ │ -00003c00: 7373 696f 6e0a 2020 2020 2043 616e 2064 ssion. Can d │ │ │ │ │ -00003c10: 6563 6f6d 7072 6573 7320 6669 6c65 7320 ecompress files │ │ │ │ │ -00003c20: 7768 6963 6820 7765 7265 2063 6f6d 7072 which were compr │ │ │ │ │ -00003c30: 6573 7365 6420 6279 2027 677a 6970 2720 essed by 'gzip' │ │ │ │ │ -00003c40: 6f72 2027 787a 2728 3229 0a20 2020 2020 or 'xz'(2). │ │ │ │ │ -00003c50: 282a 6e6f 7465 2046 6561 7475 7265 732d (*note Features- │ │ │ │ │ -00003c60: 466f 6f74 6e6f 7465 2d32 3a3a 292e 2020 Footnote-2::). │ │ │ │ │ -00003c70: 5468 6973 2066 756e 6374 696f 6e20 6973 This function is │ │ │ │ │ -00003c80: 2062 6f74 6820 6175 746f 6d61 7469 6320 both automatic │ │ │ │ │ -00003c90: 616e 640a 2020 2020 2074 7261 6e73 7061 and. transpa │ │ │ │ │ -00003ca0: 7265 6e74 2074 6f20 7468 6520 7573 6572 rent to the user │ │ │ │ │ -00003cb0: 2028 692e 652e 2020 616c 6c20 6675 6e63 (i.e. all func │ │ │ │ │ -00003cc0: 7469 6f6e 7320 6f70 6572 6174 6520 7570 tions operate up │ │ │ │ │ -00003cd0: 6f6e 2074 6865 0a20 2020 2020 756e 636f on the. unco │ │ │ │ │ -00003ce0: 6d70 7265 7373 6564 2063 6f6e 7465 6e74 mpressed content │ │ │ │ │ -00003cf0: 7320 6f66 2074 6865 2073 7065 6369 6669 s of the specifi │ │ │ │ │ -00003d00: 6564 2066 696c 6573 292e 2020 5468 6973 ed files). This │ │ │ │ │ -00003d10: 2067 7265 6174 6c79 0a20 2020 2020 7265 greatly. re │ │ │ │ │ -00003d20: 6475 6365 7320 6120 6669 6c65 2073 697a duces a file siz │ │ │ │ │ -00003d30: 6520 616e 6420 6c6f 6164 696e 6720 7469 e and loading ti │ │ │ │ │ -00003d40: 6d65 2c20 6120 7061 7274 6963 756c 6172 me, a particular │ │ │ │ │ -00003d50: 6c79 2067 7265 6174 2062 656e 6566 6974 ly great benefit │ │ │ │ │ -00003d60: 0a20 2020 2020 666f 7220 666c 6f70 7069 . for floppi │ │ │ │ │ -00003d70: 6573 2e28 3329 2020 282a 6e6f 7465 2046 es.(3) (*note F │ │ │ │ │ -00003d80: 6561 7475 7265 732d 466f 6f74 6e6f 7465 eatures-Footnote │ │ │ │ │ -00003d90: 2d33 3a3a 290a 0a20 2020 2020 4974 2069 -3::).. It i │ │ │ │ │ -00003da0: 7320 636f 6e63 6569 7661 626c 6520 7468 s conceivable th │ │ │ │ │ -00003db0: 6174 2073 6f6d 6520 6b65 726e 656c 206d at some kernel m │ │ │ │ │ -00003dc0: 6f64 756c 6573 2073 686f 756c 6420 6265 odules should be │ │ │ │ │ -00003dd0: 206c 6f61 6465 6420 696e 2061 0a20 2020 loaded in a. │ │ │ │ │ -00003de0: 2020 636f 6d70 7265 7373 6564 2073 7461 compressed sta │ │ │ │ │ -00003df0: 7465 2c20 736f 2061 2064 6966 6665 7265 te, so a differe │ │ │ │ │ -00003e00: 6e74 206d 6f64 756c 652d 6c6f 6164 696e nt module-loadin │ │ │ │ │ -00003e10: 6720 636f 6d6d 616e 6420 6361 6e20 6265 g command can be │ │ │ │ │ -00003e20: 0a20 2020 2020 7370 6563 6966 6965 6420 . specified │ │ │ │ │ -00003e30: 746f 2061 766f 6964 2075 6e63 6f6d 7072 to avoid uncompr │ │ │ │ │ -00003e40: 6573 7369 6e67 2074 6865 206d 6f64 756c essing the modul │ │ │ │ │ -00003e50: 6573 2e0a 0a41 6363 6573 7320 6461 7461 es...Access data │ │ │ │ │ -00003e60: 206f 6e20 616e 7920 696e 7374 616c 6c65 on any installe │ │ │ │ │ -00003e70: 6420 6465 7669 6365 0a20 2020 2020 5375 d device. Su │ │ │ │ │ -00003e80: 7070 6f72 7420 7265 6164 696e 6720 6461 pport reading da │ │ │ │ │ -00003e90: 7461 2066 726f 6d20 616e 7920 6f72 2061 ta from any or a │ │ │ │ │ -00003ea0: 6c6c 2066 6c6f 7070 6965 7320 6f72 2068 ll floppies or h │ │ │ │ │ -00003eb0: 6172 6420 6469 736b 2873 290a 2020 2020 ard disk(s). │ │ │ │ │ -00003ec0: 2072 6563 6f67 6e69 7a65 6420 6279 2074 recognized by t │ │ │ │ │ -00003ed0: 6865 2042 494f 532c 2069 6e64 6570 656e he BIOS, indepen │ │ │ │ │ -00003ee0: 6465 6e74 206f 6620 7468 6520 7365 7474 dent of the sett │ │ │ │ │ -00003ef0: 696e 6720 6f66 2074 6865 2072 6f6f 740a ing of the root. │ │ │ │ │ -00003f00: 2020 2020 2064 6576 6963 652e 0a0a 4265 device...Be │ │ │ │ │ -00003f10: 2069 6e64 6570 656e 6465 6e74 206f 6620 independent of │ │ │ │ │ -00003f20: 6472 6976 6520 6765 6f6d 6574 7279 2074 drive geometry t │ │ │ │ │ -00003f30: 7261 6e73 6c61 7469 6f6e 730a 2020 2020 ranslations. │ │ │ │ │ -00003f40: 2055 6e6c 696b 6520 6d61 6e79 206f 7468 Unlike many oth │ │ │ │ │ -00003f50: 6572 2062 6f6f 7420 6c6f 6164 6572 732c er boot loaders, │ │ │ │ │ -00003f60: 2047 5255 4220 6d61 6b65 7320 7468 6520 GRUB makes the │ │ │ │ │ -00003f70: 7061 7274 6963 756c 6172 2064 7269 7665 particular drive │ │ │ │ │ -00003f80: 0a20 2020 2020 7472 616e 736c 6174 696f . translatio │ │ │ │ │ -00003f90: 6e20 6972 7265 6c65 7661 6e74 2e20 2041 n irrelevant. A │ │ │ │ │ -00003fa0: 2064 7269 7665 2069 6e73 7461 6c6c 6564 drive installed │ │ │ │ │ -00003fb0: 2061 6e64 2072 756e 6e69 6e67 2077 6974 and running wit │ │ │ │ │ -00003fc0: 6820 6f6e 650a 2020 2020 2074 7261 6e73 h one. trans │ │ │ │ │ -00003fd0: 6c61 7469 6f6e 206d 6179 2062 6520 636f lation may be co │ │ │ │ │ -00003fe0: 6e76 6572 7465 6420 746f 2061 6e6f 7468 nverted to anoth │ │ │ │ │ -00003ff0: 6572 2074 7261 6e73 6c61 7469 6f6e 2077 er translation w │ │ │ │ │ -00004000: 6974 686f 7574 2061 6e79 0a20 2020 2020 ithout any. │ │ │ │ │ -00004010: 6164 7665 7273 6520 6566 6665 6374 7320 adverse effects │ │ │ │ │ -00004020: 6f72 2063 6861 6e67 6573 2069 6e20 4752 or changes in GR │ │ │ │ │ -00004030: 5542 2773 2063 6f6e 6669 6775 7261 7469 UB's configurati │ │ │ │ │ -00004040: 6f6e 2e0a 0a44 6574 6563 7420 616c 6c20 on...Detect all │ │ │ │ │ -00004050: 696e 7374 616c 6c65 6420 5241 4d0a 2020 installed RAM. │ │ │ │ │ -00004060: 2020 2047 5255 4220 6361 6e20 6765 6e65 GRUB can gene │ │ │ │ │ -00004070: 7261 6c6c 7920 6669 6e64 2061 6c6c 2074 rally find all t │ │ │ │ │ -00004080: 6865 2069 6e73 7461 6c6c 6564 2052 414d he installed RAM │ │ │ │ │ -00004090: 206f 6e20 6120 5043 2d63 6f6d 7061 7469 on a PC-compati │ │ │ │ │ -000040a0: 626c 650a 2020 2020 206d 6163 6869 6e65 ble. machine │ │ │ │ │ -000040b0: 2e20 2049 7420 7573 6573 2061 6e20 6164 . It uses an ad │ │ │ │ │ -000040c0: 7661 6e63 6564 2042 494f 5320 7175 6572 vanced BIOS quer │ │ │ │ │ -000040d0: 7920 7465 6368 6e69 7175 6520 666f 7220 y technique for │ │ │ │ │ -000040e0: 6669 6e64 696e 6720 616c 6c0a 2020 2020 finding all. │ │ │ │ │ -000040f0: 206d 656d 6f72 7920 7265 6769 6f6e 732e memory regions. │ │ │ │ │ -00004100: 2020 4173 2064 6573 6372 6962 6564 206f As described o │ │ │ │ │ -00004110: 6e20 7468 6520 4d75 6c74 6962 6f6f 7420 n the Multiboot │ │ │ │ │ -00004120: 5370 6563 6966 6963 6174 696f 6e20 282a Specification (* │ │ │ │ │ -00004130: 6e6f 7465 0a20 2020 2020 4d75 6c74 6962 note. Multib │ │ │ │ │ -00004140: 6f6f 7420 5370 6563 6966 6963 6174 696f oot Specificatio │ │ │ │ │ -00004150: 6e3a 2028 6d75 6c74 6962 6f6f 7429 546f n: (multiboot)To │ │ │ │ │ -00004160: 702e 292c 206e 6f74 2061 6c6c 206b 6572 p.), not all ker │ │ │ │ │ -00004170: 6e65 6c73 206d 616b 6520 7573 650a 2020 nels make use. │ │ │ │ │ -00004180: 2020 206f 6620 7468 6973 2069 6e66 6f72 of this infor │ │ │ │ │ -00004190: 6d61 7469 6f6e 2c20 6275 7420 4752 5542 mation, but GRUB │ │ │ │ │ -000041a0: 2070 726f 7669 6465 7320 6974 2066 6f72 provides it for │ │ │ │ │ -000041b0: 2074 686f 7365 2077 686f 2064 6f2e 0a0a those who do... │ │ │ │ │ -000041c0: 5375 7070 6f72 7420 4c6f 6769 6361 6c20 Support Logical │ │ │ │ │ -000041d0: 426c 6f63 6b20 4164 6472 6573 7320 6d6f Block Address mo │ │ │ │ │ -000041e0: 6465 0a20 2020 2020 496e 2074 7261 6469 de. In tradi │ │ │ │ │ -000041f0: 7469 6f6e 616c 2064 6973 6b20 6361 6c6c tional disk call │ │ │ │ │ -00004200: 7320 2863 616c 6c65 6420 2243 4853 206d s (called "CHS m │ │ │ │ │ -00004210: 6f64 6522 292c 2074 6865 7265 2069 7320 ode"), there is │ │ │ │ │ -00004220: 6120 6765 6f6d 6574 7279 0a20 2020 2020 a geometry. │ │ │ │ │ -00004230: 7472 616e 736c 6174 696f 6e20 7072 6f62 translation prob │ │ │ │ │ -00004240: 6c65 6d2c 2074 6861 7420 6973 2c20 7468 lem, that is, th │ │ │ │ │ -00004250: 6520 4249 4f53 2063 616e 6e6f 7420 6163 e BIOS cannot ac │ │ │ │ │ -00004260: 6365 7373 206f 7665 7220 3130 3234 0a20 cess over 1024. │ │ │ │ │ -00004270: 2020 2020 6379 6c69 6e64 6572 732c 2073 cylinders, s │ │ │ │ │ -00004280: 6f20 7468 6520 6163 6365 7373 6962 6c65 o the accessible │ │ │ │ │ -00004290: 2073 7061 6365 2069 7320 6c69 6d69 7465 space is limite │ │ │ │ │ -000042a0: 6420 746f 2061 7420 6c65 6173 7420 3530 d to at least 50 │ │ │ │ │ -000042b0: 3820 4d42 0a20 2020 2020 616e 6420 746f 8 MB. and to │ │ │ │ │ -000042c0: 2061 7420 6d6f 7374 2038 4742 2e20 4752 at most 8GB. GR │ │ │ │ │ -000042d0: 5542 2063 616e 2774 2075 6e69 7665 7273 UB can't univers │ │ │ │ │ -000042e0: 616c 6c79 2073 6f6c 7665 2074 6869 7320 ally solve this │ │ │ │ │ -000042f0: 7072 6f62 6c65 6d2c 2061 730a 2020 2020 problem, as. │ │ │ │ │ -00004300: 2074 6865 7265 2069 7320 6e6f 2073 7461 there is no sta │ │ │ │ │ -00004310: 6e64 6172 6420 696e 7465 7266 6163 6520 ndard interface │ │ │ │ │ -00004320: 7573 6564 2069 6e20 616c 6c20 6d61 6368 used in all mach │ │ │ │ │ -00004330: 696e 6573 2e20 2048 6f77 6576 6572 2c0a ines. However,. │ │ │ │ │ -00004340: 2020 2020 2073 6576 6572 616c 206e 6577 several new │ │ │ │ │ -00004350: 6572 206d 6163 6869 6e65 7320 6861 7665 er machines have │ │ │ │ │ -00004360: 2074 6865 206e 6577 2069 6e74 6572 6661 the new interfa │ │ │ │ │ -00004370: 6365 2c20 4c6f 6769 6361 6c20 426c 6f63 ce, Logical Bloc │ │ │ │ │ -00004380: 6b0a 2020 2020 2041 6464 7265 7373 2028 k. Address ( │ │ │ │ │ -00004390: 224c 4241 2229 206d 6f64 652e 2020 4752 "LBA") mode. GR │ │ │ │ │ -000043a0: 5542 2061 7574 6f6d 6174 6963 616c 6c79 UB automatically │ │ │ │ │ -000043b0: 2064 6574 6563 7473 2069 6620 4c42 4120 detects if LBA │ │ │ │ │ -000043c0: 6d6f 6465 2069 730a 2020 2020 2061 7661 mode is. ava │ │ │ │ │ -000043d0: 696c 6162 6c65 2061 6e64 2075 7365 7320 ilable and uses │ │ │ │ │ -000043e0: 6974 2069 6620 6176 6169 6c61 626c 652e it if available. │ │ │ │ │ -000043f0: 2020 496e 204c 4241 206d 6f64 652c 2047 In LBA mode, G │ │ │ │ │ -00004400: 5255 4220 6361 6e20 6163 6365 7373 0a20 RUB can access. │ │ │ │ │ -00004410: 2020 2020 7468 6520 656e 7469 7265 2064 the entire d │ │ │ │ │ -00004420: 6973 6b2e 0a0a 5375 7070 6f72 7420 6e65 isk...Support ne │ │ │ │ │ -00004430: 7477 6f72 6b20 626f 6f74 696e 670a 2020 twork booting. │ │ │ │ │ -00004440: 2020 2047 5255 4220 6973 2062 6173 6963 GRUB is basic │ │ │ │ │ -00004450: 616c 6c79 2061 2064 6973 6b2d 6261 7365 ally a disk-base │ │ │ │ │ -00004460: 6420 626f 6f74 206c 6f61 6465 7220 6275 d boot loader bu │ │ │ │ │ -00004470: 7420 616c 736f 2068 6173 206e 6574 776f t also has netwo │ │ │ │ │ -00004480: 726b 0a20 2020 2020 7375 7070 6f72 742e rk. support. │ │ │ │ │ -00004490: 2020 596f 7520 6361 6e20 6c6f 6164 204f You can load O │ │ │ │ │ -000044a0: 5320 696d 6167 6573 2066 726f 6d20 6120 S images from a │ │ │ │ │ -000044b0: 6e65 7477 6f72 6b20 6279 2075 7369 6e67 network by using │ │ │ │ │ -000044c0: 2074 6865 2022 5446 5450 220a 2020 2020 the "TFTP". │ │ │ │ │ -000044d0: 2070 726f 746f 636f 6c2e 0a0a 5375 7070 protocol...Supp │ │ │ │ │ -000044e0: 6f72 7420 7265 6d6f 7465 2074 6572 6d69 ort remote termi │ │ │ │ │ -000044f0: 6e61 6c73 0a20 2020 2020 546f 2073 7570 nals. To sup │ │ │ │ │ -00004500: 706f 7274 2063 6f6d 7075 7465 7273 2077 port computers w │ │ │ │ │ -00004510: 6974 6820 6e6f 2063 6f6e 736f 6c65 2c20 ith no console, │ │ │ │ │ -00004520: 4752 5542 2070 726f 7669 6465 7320 7265 GRUB provides re │ │ │ │ │ -00004530: 6d6f 7465 2074 6572 6d69 6e61 6c0a 2020 mote terminal. │ │ │ │ │ -00004540: 2020 2073 7570 706f 7274 2c20 736f 2074 support, so t │ │ │ │ │ -00004550: 6861 7420 796f 7520 6361 6e20 636f 6e74 hat you can cont │ │ │ │ │ -00004560: 726f 6c20 4752 5542 2066 726f 6d20 6120 rol GRUB from a │ │ │ │ │ -00004570: 7265 6d6f 7465 2068 6f73 742e 2020 4f6e remote host. On │ │ │ │ │ -00004580: 6c79 0a20 2020 2020 7365 7269 616c 2074 ly. serial t │ │ │ │ │ -00004590: 6572 6d69 6e61 6c20 7375 7070 6f72 7420 erminal support │ │ │ │ │ -000045a0: 6973 2069 6d70 6c65 6d65 6e74 6564 2061 is implemented a │ │ │ │ │ -000045b0: 7420 7468 6520 6d6f 6d65 6e74 2e0a 0a1f t the moment.... │ │ │ │ │ -000045c0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -000045d0: 2c20 204e 6f64 653a 2046 6561 7475 7265 , Node: Feature │ │ │ │ │ -000045e0: 732d 466f 6f74 6e6f 7465 732c 2020 5570 s-Footnotes, Up │ │ │ │ │ -000045f0: 3a20 4665 6174 7572 6573 0a0a 2020 2028 : Features.. ( │ │ │ │ │ -00004600: 3129 2054 6865 204e 6574 4253 442f 6933 1) The NetBSD/i3 │ │ │ │ │ -00004610: 3836 206b 6572 6e65 6c20 6973 204d 756c 86 kernel is Mul │ │ │ │ │ -00004620: 7469 626f 6f74 2d63 6f6d 706c 6961 6e74 tiboot-compliant │ │ │ │ │ -00004630: 2c20 6275 7420 6c61 636b 7320 7375 7070 , but lacks supp │ │ │ │ │ -00004640: 6f72 740a 666f 7220 4d75 6c74 6962 6f6f ort.for Multiboo │ │ │ │ │ -00004650: 7420 6d6f 6475 6c65 732e 0a0a 2020 2028 t modules... ( │ │ │ │ │ -00004660: 3229 204f 6e6c 7920 4352 4333 3220 6461 2) Only CRC32 da │ │ │ │ │ -00004670: 7461 2069 6e74 6567 7269 7479 2063 6865 ta integrity che │ │ │ │ │ -00004680: 636b 2069 7320 7375 7070 6f72 7465 6420 ck is supported │ │ │ │ │ -00004690: 2878 7a20 6465 6661 756c 7420 6973 2043 (xz default is C │ │ │ │ │ -000046a0: 5243 3634 0a73 6f20 6f6e 6520 7368 6f75 RC64.so one shou │ │ │ │ │ -000046b0: 6c64 2075 7365 202d 6368 6563 6b3d 6372 ld use -check=cr │ │ │ │ │ -000046c0: 6333 3220 6f70 7469 6f6e 292e 2020 4c5a c32 option). LZ │ │ │ │ │ -000046d0: 4d41 2042 434a 2066 696c 7465 7273 2061 MA BCJ filters a │ │ │ │ │ -000046e0: 7265 2073 7570 706f 7274 6564 2e0a 0a20 re supported... │ │ │ │ │ -000046f0: 2020 2833 2920 5468 6572 6520 6172 6520 (3) There are │ │ │ │ │ -00004700: 6120 6665 7720 7061 7468 6f6c 6f67 6963 a few pathologic │ │ │ │ │ -00004710: 616c 2063 6173 6573 2077 6865 7265 206c al cases where l │ │ │ │ │ -00004720: 6f61 6469 6e67 2061 2076 6572 7920 6261 oading a very ba │ │ │ │ │ -00004730: 646c 790a 6f72 6761 6e69 7a65 6420 454c dly.organized EL │ │ │ │ │ -00004740: 4620 6b65 726e 656c 206d 6967 6874 2074 F kernel might t │ │ │ │ │ -00004750: 616b 6520 6c6f 6e67 6572 2c20 6275 7420 ake longer, but │ │ │ │ │ -00004760: 696e 2070 7261 6374 6963 6520 7468 6973 in practice this │ │ │ │ │ -00004770: 206e 6576 6572 0a68 6170 7065 6e2e 0a0a never.happen... │ │ │ │ │ -00004780: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00004790: 6f2c 2020 4e6f 6465 3a20 526f 6c65 206f o, Node: Role o │ │ │ │ │ -000047a0: 6620 6120 626f 6f74 206c 6f61 6465 722c f a boot loader, │ │ │ │ │ -000047b0: 2020 5072 6576 3a20 4665 6174 7572 6573 Prev: Features │ │ │ │ │ -000047c0: 2c20 2055 703a 2049 6e74 726f 6475 6374 , Up: Introduct │ │ │ │ │ -000047d0: 696f 6e0a 0a31 2e35 2054 6865 2072 6f6c ion..1.5 The rol │ │ │ │ │ -000047e0: 6520 6f66 2061 2062 6f6f 7420 6c6f 6164 e of a boot load │ │ │ │ │ -000047f0: 6572 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d er.============= │ │ │ │ │ +000023a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +000023b0: 0a47 5255 4220 3220 6973 2061 2072 6577 .GRUB 2 is a rew │ │ │ │ │ +000023c0: 7269 7465 206f 6620 4752 5542 2028 2a6e rite of GRUB (*n │ │ │ │ │ +000023d0: 6f74 6520 4869 7374 6f72 793a 3a29 2c20 ote History::), │ │ │ │ │ +000023e0: 616c 7468 6f75 6768 2069 7420 7368 6172 although it shar │ │ │ │ │ +000023f0: 6573 206d 616e 790a 6368 6172 6163 7465 es many.characte │ │ │ │ │ +00002400: 7269 7374 6963 7320 7769 7468 2074 6865 ristics with the │ │ │ │ │ +00002410: 2070 7265 7669 6f75 7320 7665 7273 696f previous versio │ │ │ │ │ +00002420: 6e2c 206e 6f77 206b 6e6f 776e 2061 7320 n, now known as │ │ │ │ │ +00002430: 4752 5542 204c 6567 6163 792e 0a55 7365 GRUB Legacy..Use │ │ │ │ │ +00002440: 7273 206f 6620 4752 5542 204c 6567 6163 rs of GRUB Legac │ │ │ │ │ +00002450: 7920 6d61 7920 6e65 6564 2073 6f6d 6520 y may need some │ │ │ │ │ +00002460: 6775 6964 616e 6365 2074 6f20 6669 6e64 guidance to find │ │ │ │ │ +00002470: 2074 6865 6972 2077 6179 2061 726f 756e their way aroun │ │ │ │ │ +00002480: 640a 7468 6973 206e 6577 2076 6572 7369 d.this new versi │ │ │ │ │ +00002490: 6f6e 2e0a 0a20 2020 2a20 5468 6520 636f on... * The co │ │ │ │ │ +000024a0: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ +000024b0: 2068 6173 2061 206e 6577 206e 616d 6520 has a new name │ │ │ │ │ +000024c0: 2827 6772 7562 2e63 6667 2720 7261 7468 ('grub.cfg' rath │ │ │ │ │ +000024d0: 6572 2074 6861 6e0a 2020 2020 2027 6d65 er than. 'me │ │ │ │ │ +000024e0: 6e75 2e6c 7374 2720 6f72 2027 6772 7562 nu.lst' or 'grub │ │ │ │ │ +000024f0: 2e63 6f6e 6627 292c 206e 6577 2073 796e .conf'), new syn │ │ │ │ │ +00002500: 7461 7820 282a 6e6f 7465 2043 6f6e 6669 tax (*note Confi │ │ │ │ │ +00002510: 6775 7261 7469 6f6e 3a3a 2920 616e 640a guration::) and. │ │ │ │ │ +00002520: 2020 2020 206d 616e 7920 6e65 7720 636f many new co │ │ │ │ │ +00002530: 6d6d 616e 6473 2028 2a6e 6f74 6520 436f mmands (*note Co │ │ │ │ │ +00002540: 6d6d 616e 6473 3a3a 292e 2020 436f 6e66 mmands::). Conf │ │ │ │ │ +00002550: 6967 7572 6174 696f 6e20 6361 6e6e 6f74 iguration cannot │ │ │ │ │ +00002560: 2062 650a 2020 2020 2063 6f70 6965 6420 be. copied │ │ │ │ │ +00002570: 6f76 6572 2064 6972 6563 746c 792c 2061 over directly, a │ │ │ │ │ +00002580: 6c74 686f 7567 6820 6d6f 7374 2047 5255 lthough most GRU │ │ │ │ │ +00002590: 4220 4c65 6761 6379 2075 7365 7273 2073 B Legacy users s │ │ │ │ │ +000025a0: 686f 756c 6420 6e6f 740a 2020 2020 2066 hould not. f │ │ │ │ │ +000025b0: 696e 6420 7468 6520 7379 6e74 6178 2074 ind the syntax t │ │ │ │ │ +000025c0: 6f6f 2073 7572 7072 6973 696e 672e 0a0a oo surprising... │ │ │ │ │ +000025d0: 2020 202a 2027 6772 7562 2e63 6667 2720 * 'grub.cfg' │ │ │ │ │ +000025e0: 6973 2074 7970 6963 616c 6c79 2061 7574 is typically aut │ │ │ │ │ +000025f0: 6f6d 6174 6963 616c 6c79 2067 656e 6572 omatically gener │ │ │ │ │ +00002600: 6174 6564 2062 7920 2767 7275 622d 6d6b ated by 'grub-mk │ │ │ │ │ +00002610: 636f 6e66 6967 270a 2020 2020 2028 2a6e config'. (*n │ │ │ │ │ +00002620: 6f74 6520 5369 6d70 6c65 2063 6f6e 6669 ote Simple confi │ │ │ │ │ +00002630: 6775 7261 7469 6f6e 3a3a 292e 2020 5468 guration::). Th │ │ │ │ │ +00002640: 6973 206d 616b 6573 2069 7420 6561 7369 is makes it easi │ │ │ │ │ +00002650: 6572 2074 6f20 6861 6e64 6c65 0a20 2020 er to handle. │ │ │ │ │ +00002660: 2020 7665 7273 696f 6e65 6420 6b65 726e versioned kern │ │ │ │ │ +00002670: 656c 2075 7067 7261 6465 732e 0a0a 2020 el upgrades... │ │ │ │ │ +00002680: 202a 2050 6172 7469 7469 6f6e 206e 756d * Partition num │ │ │ │ │ +00002690: 6265 7273 2069 6e20 4752 5542 2064 6576 bers in GRUB dev │ │ │ │ │ +000026a0: 6963 6520 6e61 6d65 7320 6e6f 7720 7374 ice names now st │ │ │ │ │ +000026b0: 6172 7420 6174 2031 2c20 6e6f 7420 3020 art at 1, not 0 │ │ │ │ │ +000026c0: 282a 6e6f 7465 0a20 2020 2020 4e61 6d69 (*note. Nami │ │ │ │ │ +000026d0: 6e67 2063 6f6e 7665 6e74 696f 6e3a 3a29 ng convention::) │ │ │ │ │ +000026e0: 2e0a 0a20 2020 2a20 5468 6520 636f 6e66 ... * The conf │ │ │ │ │ +000026f0: 6967 7572 6174 696f 6e20 6669 6c65 2069 iguration file i │ │ │ │ │ +00002700: 7320 6e6f 7720 7772 6974 7465 6e20 696e s now written in │ │ │ │ │ +00002710: 2073 6f6d 6574 6869 6e67 2063 6c6f 7365 something close │ │ │ │ │ +00002720: 7220 746f 2061 2066 756c 6c0a 2020 2020 r to a full. │ │ │ │ │ +00002730: 2073 6372 6970 7469 6e67 206c 616e 6775 scripting langu │ │ │ │ │ +00002740: 6167 653a 2076 6172 6961 626c 6573 2c20 age: variables, │ │ │ │ │ +00002750: 636f 6e64 6974 696f 6e61 6c73 2c20 616e conditionals, an │ │ │ │ │ +00002760: 6420 6c6f 6f70 7320 6172 650a 2020 2020 d loops are. │ │ │ │ │ +00002770: 2061 7661 696c 6162 6c65 2e0a 0a20 2020 available... │ │ │ │ │ +00002780: 2a20 4120 736d 616c 6c20 616d 6f75 6e74 * A small amount │ │ │ │ │ +00002790: 206f 6620 7065 7273 6973 7465 6e74 2073 of persistent s │ │ │ │ │ +000027a0: 746f 7261 6765 2069 7320 6176 6169 6c61 torage is availa │ │ │ │ │ +000027b0: 626c 6520 6163 726f 7373 2072 6562 6f6f ble across reboo │ │ │ │ │ +000027c0: 7473 2c0a 2020 2020 2075 7369 6e67 2074 ts,. using t │ │ │ │ │ +000027d0: 6865 2027 7361 7665 5f65 6e76 2720 616e he 'save_env' an │ │ │ │ │ +000027e0: 6420 276c 6f61 645f 656e 7627 2063 6f6d d 'load_env' com │ │ │ │ │ +000027f0: 6d61 6e64 7320 696e 2047 5255 4220 616e mands in GRUB an │ │ │ │ │ +00002800: 6420 7468 650a 2020 2020 2027 6772 7562 d the. 'grub │ │ │ │ │ +00002810: 2d65 6469 7465 6e76 2720 7574 696c 6974 -editenv' utilit │ │ │ │ │ +00002820: 792e 2020 5468 6973 2069 7320 6e6f 7420 y. This is not │ │ │ │ │ +00002830: 6176 6169 6c61 626c 6520 696e 2061 6c6c available in all │ │ │ │ │ +00002840: 0a20 2020 2020 636f 6e66 6967 7572 6174 . configurat │ │ │ │ │ +00002850: 696f 6e73 2028 2a6e 6f74 6520 456e 7669 ions (*note Envi │ │ │ │ │ +00002860: 726f 6e6d 656e 7420 626c 6f63 6b3a 3a29 ronment block::) │ │ │ │ │ +00002870: 2e0a 0a20 2020 2a20 4752 5542 2032 2068 ... * GRUB 2 h │ │ │ │ │ +00002880: 6173 206d 6f72 6520 7265 6c69 6162 6c65 as more reliable │ │ │ │ │ +00002890: 2077 6179 7320 746f 2066 696e 6420 6974 ways to find it │ │ │ │ │ +000028a0: 7320 6f77 6e20 6669 6c65 7320 616e 6420 s own files and │ │ │ │ │ +000028b0: 7468 6f73 6520 6f66 0a20 2020 2020 7461 those of. ta │ │ │ │ │ +000028c0: 7267 6574 206b 6572 6e65 6c73 206f 6e20 rget kernels on │ │ │ │ │ +000028d0: 6d75 6c74 6970 6c65 2d64 6973 6b20 7379 multiple-disk sy │ │ │ │ │ +000028e0: 7374 656d 732c 2061 6e64 2068 6173 2063 stems, and has c │ │ │ │ │ +000028f0: 6f6d 6d61 6e64 7320 282a 6e6f 7465 0a20 ommands (*note. │ │ │ │ │ +00002900: 2020 2020 7365 6172 6368 3a3a 2920 746f search::) to │ │ │ │ │ +00002910: 2066 696e 6420 6465 7669 6365 7320 7573 find devices us │ │ │ │ │ +00002920: 696e 6720 6669 6c65 2073 7973 7465 6d20 ing file system │ │ │ │ │ +00002930: 6c61 6265 6c73 206f 7220 556e 6976 6572 labels or Univer │ │ │ │ │ +00002940: 7361 6c6c 790a 2020 2020 2055 6e69 7175 sally. Uniqu │ │ │ │ │ +00002950: 6520 4964 656e 7469 6669 6572 7320 2855 e Identifiers (U │ │ │ │ │ +00002960: 5549 4473 292e 0a0a 2020 202a 2047 5255 UIDs)... * GRU │ │ │ │ │ +00002970: 4220 3220 6973 2061 7661 696c 6162 6c65 B 2 is available │ │ │ │ │ +00002980: 2066 6f72 2073 6576 6572 616c 206f 7468 for several oth │ │ │ │ │ +00002990: 6572 2074 7970 6573 206f 6620 7379 7374 er types of syst │ │ │ │ │ +000029a0: 656d 2069 6e20 6164 6469 7469 6f6e 0a20 em in addition. │ │ │ │ │ +000029b0: 2020 2020 746f 2074 6865 2050 4320 4249 to the PC BI │ │ │ │ │ +000029c0: 4f53 2073 7973 7465 6d73 2073 7570 706f OS systems suppo │ │ │ │ │ +000029d0: 7274 6564 2062 7920 4752 5542 204c 6567 rted by GRUB Leg │ │ │ │ │ +000029e0: 6163 793a 2050 4320 4546 492c 2050 430a acy: PC EFI, PC. │ │ │ │ │ +000029f0: 2020 2020 2063 6f72 6562 6f6f 742c 2050 coreboot, P │ │ │ │ │ +00002a00: 6f77 6572 5043 2c20 5350 4152 432c 2061 owerPC, SPARC, a │ │ │ │ │ +00002a10: 6e64 204d 4950 5320 4c65 6d6f 7465 2059 nd MIPS Lemote Y │ │ │ │ │ +00002a20: 6565 6c6f 6f6e 6720 6172 6520 616c 6c0a eeloong are all. │ │ │ │ │ +00002a30: 2020 2020 2073 7570 706f 7274 6564 2e0a supported.. │ │ │ │ │ +00002a40: 0a20 2020 2a20 4d61 6e79 206d 6f72 6520 . * Many more │ │ │ │ │ +00002a50: 6669 6c65 2073 7973 7465 6d73 2061 7265 file systems are │ │ │ │ │ +00002a60: 2073 7570 706f 7274 6564 2c20 696e 636c supported, incl │ │ │ │ │ +00002a70: 7564 696e 6720 6275 7420 6e6f 7420 6c69 uding but not li │ │ │ │ │ +00002a80: 6d69 7465 6420 746f 0a20 2020 2020 6578 mited to. ex │ │ │ │ │ +00002a90: 7434 2c20 4846 532b 2c20 616e 6420 4e54 t4, HFS+, and NT │ │ │ │ │ +00002aa0: 4653 2e0a 0a20 2020 2a20 4752 5542 2032 FS... * GRUB 2 │ │ │ │ │ +00002ab0: 2063 616e 2072 6561 6420 6669 6c65 7320 can read files │ │ │ │ │ +00002ac0: 6469 7265 6374 6c79 2066 726f 6d20 4c56 directly from LV │ │ │ │ │ +00002ad0: 4d20 616e 6420 5241 4944 2064 6576 6963 M and RAID devic │ │ │ │ │ +00002ae0: 6573 2e0a 0a20 2020 2a20 4120 6772 6170 es... * A grap │ │ │ │ │ +00002af0: 6869 6361 6c20 7465 726d 696e 616c 2061 hical terminal a │ │ │ │ │ +00002b00: 6e64 2061 2067 7261 7068 6963 616c 206d nd a graphical m │ │ │ │ │ +00002b10: 656e 7520 7379 7374 656d 2061 7265 2061 enu system are a │ │ │ │ │ +00002b20: 7661 696c 6162 6c65 2e0a 0a20 2020 2a20 vailable... * │ │ │ │ │ +00002b30: 4752 5542 2032 2773 2069 6e74 6572 6661 GRUB 2's interfa │ │ │ │ │ +00002b40: 6365 2063 616e 2062 6520 7472 616e 736c ce can be transl │ │ │ │ │ +00002b50: 6174 6564 2c20 696e 636c 7564 696e 6720 ated, including │ │ │ │ │ +00002b60: 6d65 6e75 2065 6e74 7279 206e 616d 6573 menu entry names │ │ │ │ │ +00002b70: 2e0a 0a20 2020 2a20 5468 6520 696d 6167 ... * The imag │ │ │ │ │ +00002b80: 6520 6669 6c65 7320 282a 6e6f 7465 2049 e files (*note I │ │ │ │ │ +00002b90: 6d61 6765 733a 3a29 2074 6861 7420 6d61 mages::) that ma │ │ │ │ │ +00002ba0: 6b65 2075 7020 4752 5542 2068 6176 6520 ke up GRUB have │ │ │ │ │ +00002bb0: 6265 656e 0a20 2020 2020 7265 6f72 6761 been. reorga │ │ │ │ │ +00002bc0: 6e69 7365 643b 2053 7461 6765 2031 2c20 nised; Stage 1, │ │ │ │ │ +00002bd0: 5374 6167 6520 312e 352c 2061 6e64 2053 Stage 1.5, and S │ │ │ │ │ +00002be0: 7461 6765 2032 2061 7265 206e 6f20 6d6f tage 2 are no mo │ │ │ │ │ +00002bf0: 7265 2e0a 0a20 2020 2a20 4752 5542 2032 re... * GRUB 2 │ │ │ │ │ +00002c00: 2070 7574 7320 6d61 6e79 2066 6163 696c puts many facil │ │ │ │ │ +00002c10: 6974 6965 7320 696e 2064 796e 616d 6963 ities in dynamic │ │ │ │ │ +00002c20: 616c 6c79 206c 6f61 6465 6420 6d6f 6475 ally loaded modu │ │ │ │ │ +00002c30: 6c65 732c 2061 6c6c 6f77 696e 670a 2020 les, allowing. │ │ │ │ │ +00002c40: 2020 2074 6865 2063 6f72 6520 696d 6167 the core imag │ │ │ │ │ +00002c50: 6520 746f 2062 6520 736d 616c 6c65 722c e to be smaller, │ │ │ │ │ +00002c60: 2061 6e64 2061 6c6c 6f77 696e 6720 7468 and allowing th │ │ │ │ │ +00002c70: 6520 636f 7265 2069 6d61 6765 2074 6f20 e core image to │ │ │ │ │ +00002c80: 6265 0a20 2020 2020 6275 696c 7420 696e be. built in │ │ │ │ │ +00002c90: 206d 6f72 6520 666c 6578 6962 6c65 2077 more flexible w │ │ │ │ │ +00002ca0: 6179 732e 0a0a 1f0a 4669 6c65 3a20 6772 ays.....File: gr │ │ │ │ │ +00002cb0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00002cc0: 4665 6174 7572 6573 2c20 204e 6578 743a Features, Next: │ │ │ │ │ +00002cd0: 2052 6f6c 6520 6f66 2061 2062 6f6f 7420 Role of a boot │ │ │ │ │ +00002ce0: 6c6f 6164 6572 2c20 2050 7265 763a 2043 loader, Prev: C │ │ │ │ │ +00002cf0: 6861 6e67 6573 2066 726f 6d20 4752 5542 hanges from GRUB │ │ │ │ │ +00002d00: 204c 6567 6163 792c 2020 5570 3a20 496e Legacy, Up: In │ │ │ │ │ +00002d10: 7472 6f64 7563 7469 6f6e 0a0a 312e 3420 troduction..1.4 │ │ │ │ │ +00002d20: 4752 5542 2066 6561 7475 7265 730a 3d3d GRUB features.== │ │ │ │ │ +00002d30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00002d40: 0a54 6865 2070 7269 6d61 7279 2072 6571 .The primary req │ │ │ │ │ +00002d50: 7569 7265 6d65 6e74 2066 6f72 2047 5255 uirement for GRU │ │ │ │ │ +00002d60: 4220 6973 2074 6861 7420 6974 2062 6520 B is that it be │ │ │ │ │ +00002d70: 636f 6d70 6c69 616e 7420 7769 7468 2074 compliant with t │ │ │ │ │ +00002d80: 6865 0a22 4d75 6c74 6962 6f6f 7420 5370 he."Multiboot Sp │ │ │ │ │ +00002d90: 6563 6966 6963 6174 696f 6e22 2c20 7768 ecification", wh │ │ │ │ │ +00002da0: 6963 6820 6973 2064 6573 6372 6962 6564 ich is described │ │ │ │ │ +00002db0: 2069 6e20 2a6e 6f74 6520 4d75 6c74 6962 in *note Multib │ │ │ │ │ +00002dc0: 6f6f 740a 5370 6563 6966 6963 6174 696f oot.Specificatio │ │ │ │ │ +00002dd0: 6e3a 2028 6d75 6c74 6962 6f6f 7429 546f n: (multiboot)To │ │ │ │ │ +00002de0: 702e 0a0a 2020 2054 6865 206f 7468 6572 p... The other │ │ │ │ │ +00002df0: 2067 6f61 6c73 2c20 6c69 7374 6564 2069 goals, listed i │ │ │ │ │ +00002e00: 6e20 6170 7072 6f78 696d 6174 6520 6f72 n approximate or │ │ │ │ │ +00002e10: 6465 7220 6f66 2069 6d70 6f72 7461 6e63 der of importanc │ │ │ │ │ +00002e20: 652c 2061 7265 3a0a 0a20 2020 2a20 4261 e, are:.. * Ba │ │ │ │ │ +00002e30: 7369 6320 6675 6e63 7469 6f6e 7320 6d75 sic functions mu │ │ │ │ │ +00002e40: 7374 2062 6520 7374 7261 6967 6874 666f st be straightfo │ │ │ │ │ +00002e50: 7277 6172 6420 666f 7220 656e 642d 7573 rward for end-us │ │ │ │ │ +00002e60: 6572 732e 0a0a 2020 202a 2052 6963 6820 ers... * Rich │ │ │ │ │ +00002e70: 6675 6e63 7469 6f6e 616c 6974 7920 746f functionality to │ │ │ │ │ +00002e80: 2073 7570 706f 7274 206b 6572 6e65 6c20 support kernel │ │ │ │ │ +00002e90: 6578 7065 7274 7320 616e 6420 6465 7369 experts and desi │ │ │ │ │ +00002ea0: 676e 6572 732e 0a0a 2020 202a 2042 6163 gners... * Bac │ │ │ │ │ +00002eb0: 6b77 6172 6420 636f 6d70 6174 6962 696c kward compatibil │ │ │ │ │ +00002ec0: 6974 7920 666f 7220 626f 6f74 696e 6720 ity for booting │ │ │ │ │ +00002ed0: 4672 6565 4253 442c 204e 6574 4253 442c FreeBSD, NetBSD, │ │ │ │ │ +00002ee0: 204f 7065 6e42 5344 2c20 616e 640a 2020 OpenBSD, and. │ │ │ │ │ +00002ef0: 2020 204c 696e 7578 2e20 2050 726f 7072 Linux. Propr │ │ │ │ │ +00002f00: 6965 7461 7279 206b 6572 6e65 6c73 2028 ietary kernels ( │ │ │ │ │ +00002f10: 7375 6368 2061 7320 444f 532c 2057 696e such as DOS, Win │ │ │ │ │ +00002f20: 646f 7773 204e 542c 2061 6e64 204f 532f dows NT, and OS/ │ │ │ │ │ +00002f30: 3229 2061 7265 0a20 2020 2020 7375 7070 2) are. supp │ │ │ │ │ +00002f40: 6f72 7465 6420 7669 6120 6120 6368 6169 orted via a chai │ │ │ │ │ +00002f50: 6e2d 6c6f 6164 696e 6720 6675 6e63 7469 n-loading functi │ │ │ │ │ +00002f60: 6f6e 2e0a 0a20 2020 4578 6365 7074 2066 on... Except f │ │ │ │ │ +00002f70: 6f72 2073 7065 6369 6669 6320 636f 6d70 or specific comp │ │ │ │ │ +00002f80: 6174 6962 696c 6974 7920 6d6f 6465 7320 atibility modes │ │ │ │ │ +00002f90: 2863 6861 696e 2d6c 6f61 6469 6e67 2061 (chain-loading a │ │ │ │ │ +00002fa0: 6e64 2074 6865 204c 696e 7578 0a22 7069 nd the Linux."pi │ │ │ │ │ +00002fb0: 6767 7962 6163 6b22 2066 6f72 6d61 7429 ggyback" format) │ │ │ │ │ +00002fc0: 2c20 616c 6c20 6b65 726e 656c 7320 7769 , all kernels wi │ │ │ │ │ +00002fd0: 6c6c 2062 6520 7374 6172 7465 6420 696e ll be started in │ │ │ │ │ +00002fe0: 206d 7563 6820 7468 6520 7361 6d65 2073 much the same s │ │ │ │ │ +00002ff0: 7461 7465 0a61 7320 696e 2074 6865 204d tate.as in the M │ │ │ │ │ +00003000: 756c 7469 626f 6f74 2053 7065 6369 6669 ultiboot Specifi │ │ │ │ │ +00003010: 6361 7469 6f6e 2e20 204f 6e6c 7920 6b65 cation. Only ke │ │ │ │ │ +00003020: 726e 656c 7320 6c6f 6164 6564 2061 7420 rnels loaded at │ │ │ │ │ +00003030: 3120 6d65 6761 6279 7465 206f 720a 6162 1 megabyte or.ab │ │ │ │ │ +00003040: 6f76 6520 6172 6520 7072 6573 656e 746c ove are presentl │ │ │ │ │ +00003050: 7920 7375 7070 6f72 7465 642e 2020 416e y supported. An │ │ │ │ │ +00003060: 7920 6174 7465 6d70 7420 746f 206c 6f61 y attempt to loa │ │ │ │ │ +00003070: 6420 6265 6c6f 7720 7468 6174 2062 6f75 d below that bou │ │ │ │ │ +00003080: 6e64 6172 790a 7769 6c6c 2073 696d 706c ndary.will simpl │ │ │ │ │ +00003090: 7920 7265 7375 6c74 2069 6e20 696d 6d65 y result in imme │ │ │ │ │ +000030a0: 6469 6174 6520 6661 696c 7572 6520 616e diate failure an │ │ │ │ │ +000030b0: 6420 616e 2065 7272 6f72 206d 6573 7361 d an error messa │ │ │ │ │ +000030c0: 6765 2072 6570 6f72 7469 6e67 0a74 6865 ge reporting.the │ │ │ │ │ +000030d0: 2070 726f 626c 656d 2e0a 0a20 2020 496e problem... In │ │ │ │ │ +000030e0: 2061 6464 6974 696f 6e20 746f 2074 6865 addition to the │ │ │ │ │ +000030f0: 2072 6571 7569 7265 6d65 6e74 7320 6162 requirements ab │ │ │ │ │ +00003100: 6f76 652c 2047 5255 4220 6861 7320 7468 ove, GRUB has th │ │ │ │ │ +00003110: 6520 666f 6c6c 6f77 696e 670a 6665 6174 e following.feat │ │ │ │ │ +00003120: 7572 6573 2028 6e6f 7465 2074 6861 7420 ures (note that │ │ │ │ │ +00003130: 7468 6520 4d75 6c74 6962 6f6f 7420 5370 the Multiboot Sp │ │ │ │ │ +00003140: 6563 6966 6963 6174 696f 6e20 646f 6573 ecification does │ │ │ │ │ +00003150: 6e27 7420 7265 7175 6972 6520 616c 6c20 n't require all │ │ │ │ │ +00003160: 7468 650a 6665 6174 7572 6573 2074 6861 the.features tha │ │ │ │ │ +00003170: 7420 4752 5542 2073 7570 706f 7274 7329 t GRUB supports) │ │ │ │ │ +00003180: 3a0a 0a52 6563 6f67 6e69 7a65 206d 756c :..Recognize mul │ │ │ │ │ +00003190: 7469 706c 6520 6578 6563 7574 6162 6c65 tiple executable │ │ │ │ │ +000031a0: 2066 6f72 6d61 7473 0a20 2020 2020 5375 formats. Su │ │ │ │ │ +000031b0: 7070 6f72 7420 6d61 6e79 206f 6620 7468 pport many of th │ │ │ │ │ +000031c0: 6520 2261 2e6f 7574 2220 7661 7269 616e e "a.out" varian │ │ │ │ │ +000031d0: 7473 2070 6c75 7320 2245 4c46 222e 2053 ts plus "ELF". S │ │ │ │ │ +000031e0: 796d 626f 6c20 7461 626c 6573 2061 7265 ymbol tables are │ │ │ │ │ +000031f0: 0a20 2020 2020 616c 736f 206c 6f61 6465 . also loade │ │ │ │ │ +00003200: 642e 0a0a 5375 7070 6f72 7420 6e6f 6e2d d...Support non- │ │ │ │ │ +00003210: 4d75 6c74 6962 6f6f 7420 6b65 726e 656c Multiboot kernel │ │ │ │ │ +00003220: 730a 2020 2020 2053 7570 706f 7274 206d s. Support m │ │ │ │ │ +00003230: 616e 7920 6f66 2074 6865 2076 6172 696f any of the vario │ │ │ │ │ +00003240: 7573 2066 7265 6520 3332 2d62 6974 206b us free 32-bit k │ │ │ │ │ +00003250: 6572 6e65 6c73 2074 6861 7420 6c61 636b ernels that lack │ │ │ │ │ +00003260: 204d 756c 7469 626f 6f74 0a20 2020 2020 Multiboot. │ │ │ │ │ +00003270: 636f 6d70 6c69 616e 6365 2028 7072 696d compliance (prim │ │ │ │ │ +00003280: 6172 696c 7920 4672 6565 4253 442c 204e arily FreeBSD, N │ │ │ │ │ +00003290: 6574 4253 4428 3129 2028 2a6e 6f74 650a etBSD(1) (*note. │ │ │ │ │ +000032a0: 2020 2020 2046 6561 7475 7265 732d 466f Features-Fo │ │ │ │ │ +000032b0: 6f74 6e6f 7465 2d31 3a3a 292c 204f 7065 otnote-1::), Ope │ │ │ │ │ +000032c0: 6e42 5344 2c20 616e 6420 4c69 6e75 7829 nBSD, and Linux) │ │ │ │ │ +000032d0: 2e20 2043 6861 696e 2d6c 6f61 6469 6e67 . Chain-loading │ │ │ │ │ +000032e0: 206f 660a 2020 2020 206f 7468 6572 2062 of. other b │ │ │ │ │ +000032f0: 6f6f 7420 6c6f 6164 6572 7320 6973 2061 oot loaders is a │ │ │ │ │ +00003300: 6c73 6f20 7375 7070 6f72 7465 642e 0a0a lso supported... │ │ │ │ │ +00003310: 4c6f 6164 206d 756c 7469 706c 6573 206d Load multiples m │ │ │ │ │ +00003320: 6f64 756c 6573 0a20 2020 2020 4675 6c6c odules. Full │ │ │ │ │ +00003330: 7920 7375 7070 6f72 7420 7468 6520 4d75 y support the Mu │ │ │ │ │ +00003340: 6c74 6962 6f6f 7420 6665 6174 7572 6520 ltiboot feature │ │ │ │ │ +00003350: 6f66 206c 6f61 6469 6e67 206d 756c 7469 of loading multi │ │ │ │ │ +00003360: 706c 6520 6d6f 6475 6c65 732e 0a0a 4c6f ple modules...Lo │ │ │ │ │ +00003370: 6164 2061 2063 6f6e 6669 6775 7261 7469 ad a configurati │ │ │ │ │ +00003380: 6f6e 2066 696c 650a 2020 2020 2053 7570 on file. Sup │ │ │ │ │ +00003390: 706f 7274 2061 2068 756d 616e 2d72 6561 port a human-rea │ │ │ │ │ +000033a0: 6461 626c 6520 7465 7874 2063 6f6e 6669 dable text confi │ │ │ │ │ +000033b0: 6775 7261 7469 6f6e 2066 696c 6520 7769 guration file wi │ │ │ │ │ +000033c0: 7468 2070 7265 7365 7420 626f 6f74 0a20 th preset boot. │ │ │ │ │ +000033d0: 2020 2020 636f 6d6d 616e 6473 2e20 2059 commands. Y │ │ │ │ │ +000033e0: 6f75 2063 616e 2061 6c73 6f20 6c6f 6164 ou can also load │ │ │ │ │ +000033f0: 2061 6e6f 7468 6572 2063 6f6e 6669 6775 another configu │ │ │ │ │ +00003400: 7261 7469 6f6e 2066 696c 6520 6479 6e61 ration file dyna │ │ │ │ │ +00003410: 6d69 6361 6c6c 790a 2020 2020 2061 6e64 mically. and │ │ │ │ │ +00003420: 2065 6d62 6564 2061 2070 7265 7365 7420 embed a preset │ │ │ │ │ +00003430: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ +00003440: 6c65 2069 6e20 6120 4752 5542 2069 6d61 le in a GRUB ima │ │ │ │ │ +00003450: 6765 2066 696c 652e 2020 5468 650a 2020 ge file. The. │ │ │ │ │ +00003460: 2020 206c 6973 7420 6f66 2063 6f6d 6d61 list of comma │ │ │ │ │ +00003470: 6e64 7320 282a 6e6f 7465 2043 6f6d 6d61 nds (*note Comma │ │ │ │ │ +00003480: 6e64 733a 3a29 2061 7265 2061 2073 7570 nds::) are a sup │ │ │ │ │ +00003490: 6572 7365 7420 6f66 2074 686f 7365 0a20 erset of those. │ │ │ │ │ +000034a0: 2020 2020 7375 7070 6f72 7465 6420 6f6e supported on │ │ │ │ │ +000034b0: 2074 6865 2063 6f6d 6d61 6e64 2d6c 696e the command-lin │ │ │ │ │ +000034c0: 652e 2020 416e 2065 7861 6d70 6c65 2063 e. An example c │ │ │ │ │ +000034d0: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ │ +000034e0: 6520 6973 0a20 2020 2020 7072 6f76 6964 e is. provid │ │ │ │ │ +000034f0: 6564 2069 6e20 2a6e 6f74 6520 436f 6e66 ed in *note Conf │ │ │ │ │ +00003500: 6967 7572 6174 696f 6e3a 3a2e 0a0a 5072 iguration::...Pr │ │ │ │ │ +00003510: 6f76 6964 6520 6120 6d65 6e75 2069 6e74 ovide a menu int │ │ │ │ │ +00003520: 6572 6661 6365 0a20 2020 2020 4120 6d65 erface. A me │ │ │ │ │ +00003530: 6e75 2069 6e74 6572 6661 6365 206c 6973 nu interface lis │ │ │ │ │ +00003540: 7469 6e67 2070 7265 7365 7420 626f 6f74 ting preset boot │ │ │ │ │ +00003550: 2063 6f6d 6d61 6e64 732c 2077 6974 6820 commands, with │ │ │ │ │ +00003560: 6120 7072 6f67 7261 6d6d 6162 6c65 0a20 a programmable. │ │ │ │ │ +00003570: 2020 2020 7469 6d65 6f75 742c 2069 7320 timeout, is │ │ │ │ │ +00003580: 6176 6169 6c61 626c 652e 2020 5468 6572 available. Ther │ │ │ │ │ +00003590: 6520 6973 206e 6f20 6669 7865 6420 6c69 e is no fixed li │ │ │ │ │ +000035a0: 6d69 7420 6f6e 2074 6865 206e 756d 6265 mit on the numbe │ │ │ │ │ +000035b0: 7220 6f66 0a20 2020 2020 626f 6f74 2065 r of. boot e │ │ │ │ │ +000035c0: 6e74 7269 6573 2c20 616e 6420 7468 6520 ntries, and the │ │ │ │ │ +000035d0: 6375 7272 656e 7420 696d 706c 656d 656e current implemen │ │ │ │ │ +000035e0: 7461 7469 6f6e 2068 6173 2073 7061 6365 tation has space │ │ │ │ │ +000035f0: 2066 6f72 2073 6576 6572 616c 0a20 2020 for several. │ │ │ │ │ +00003600: 2020 6875 6e64 7265 642e 0a0a 4861 7665 hundred...Have │ │ │ │ │ +00003610: 2061 2066 6c65 7869 626c 6520 636f 6d6d a flexible comm │ │ │ │ │ +00003620: 616e 642d 6c69 6e65 2069 6e74 6572 6661 and-line interfa │ │ │ │ │ +00003630: 6365 0a20 2020 2020 4120 6661 6972 6c79 ce. A fairly │ │ │ │ │ +00003640: 2066 6c65 7869 626c 6520 636f 6d6d 616e flexible comman │ │ │ │ │ +00003650: 642d 6c69 6e65 2069 6e74 6572 6661 6365 d-line interface │ │ │ │ │ +00003660: 2c20 6163 6365 7373 6962 6c65 2066 726f , accessible fro │ │ │ │ │ +00003670: 6d20 7468 6520 6d65 6e75 2c0a 2020 2020 m the menu,. │ │ │ │ │ +00003680: 2069 7320 6176 6169 6c61 626c 6520 746f is available to │ │ │ │ │ +00003690: 2065 6469 7420 616e 7920 7072 6573 6574 edit any preset │ │ │ │ │ +000036a0: 2063 6f6d 6d61 6e64 732c 206f 7220 7772 commands, or wr │ │ │ │ │ +000036b0: 6974 6520 6120 6e65 7720 626f 6f74 0a20 ite a new boot. │ │ │ │ │ +000036c0: 2020 2020 636f 6d6d 616e 6420 7365 7420 command set │ │ │ │ │ +000036d0: 6672 6f6d 2073 6372 6174 6368 2e20 2049 from scratch. I │ │ │ │ │ +000036e0: 6620 6e6f 2063 6f6e 6669 6775 7261 7469 f no configurati │ │ │ │ │ +000036f0: 6f6e 2066 696c 6520 6973 2070 7265 7365 on file is prese │ │ │ │ │ +00003700: 6e74 2c0a 2020 2020 2047 5255 4220 6472 nt,. GRUB dr │ │ │ │ │ +00003710: 6f70 7320 746f 2074 6865 2063 6f6d 6d61 ops to the comma │ │ │ │ │ +00003720: 6e64 2d6c 696e 652e 0a0a 2020 2020 2054 nd-line... T │ │ │ │ │ +00003730: 6865 206c 6973 7420 6f66 2063 6f6d 6d61 he list of comma │ │ │ │ │ +00003740: 6e64 7320 282a 6e6f 7465 2043 6f6d 6d61 nds (*note Comma │ │ │ │ │ +00003750: 6e64 733a 3a29 2061 7265 2061 2073 7562 nds::) are a sub │ │ │ │ │ +00003760: 7365 7420 6f66 2074 686f 7365 0a20 2020 set of those. │ │ │ │ │ +00003770: 2020 7375 7070 6f72 7465 6420 666f 7220 supported for │ │ │ │ │ +00003780: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ +00003790: 6c65 732e 2020 4564 6974 696e 6720 636f les. Editing co │ │ │ │ │ +000037a0: 6d6d 616e 6473 2063 6c6f 7365 6c79 0a20 mmands closely. │ │ │ │ │ +000037b0: 2020 2020 7265 7365 6d62 6c65 7320 7468 resembles th │ │ │ │ │ +000037c0: 6520 4261 7368 2063 6f6d 6d61 6e64 2d6c e Bash command-l │ │ │ │ │ +000037d0: 696e 6520 282a 6e6f 7465 2042 6173 683a ine (*note Bash: │ │ │ │ │ +000037e0: 2028 6665 6174 7572 6573 2943 6f6d 6d61 (features)Comma │ │ │ │ │ +000037f0: 6e64 204c 696e 650a 2020 2020 2045 6469 nd Line. Edi │ │ │ │ │ +00003800: 7469 6e67 2e29 2c20 7769 7468 203c 5441 ting.), with -completion of │ │ │ │ │ +00003820: 2063 6f6d 6d61 6e64 732c 2064 6576 6963 commands, devic │ │ │ │ │ +00003830: 6573 2c20 7061 7274 6974 696f 6e73 2c0a es, partitions,. │ │ │ │ │ +00003840: 2020 2020 2061 6e64 2066 696c 6573 2069 and files i │ │ │ │ │ +00003850: 6e20 6120 6469 7265 6374 6f72 7920 6465 n a directory de │ │ │ │ │ +00003860: 7065 6e64 696e 6720 6f6e 2063 6f6e 7465 pending on conte │ │ │ │ │ +00003870: 7874 2e0a 0a53 7570 706f 7274 206d 756c xt...Support mul │ │ │ │ │ +00003880: 7469 706c 6520 6669 6c65 7379 7374 656d tiple filesystem │ │ │ │ │ +00003890: 2074 7970 6573 0a20 2020 2020 5375 7070 types. Supp │ │ │ │ │ +000038a0: 6f72 7420 6d75 6c74 6970 6c65 2066 696c ort multiple fil │ │ │ │ │ +000038b0: 6573 7973 7465 6d20 7479 7065 7320 7472 esystem types tr │ │ │ │ │ +000038c0: 616e 7370 6172 656e 746c 792c 2070 6c75 ansparently, plu │ │ │ │ │ +000038d0: 7320 6120 7573 6566 756c 0a20 2020 2020 s a useful. │ │ │ │ │ +000038e0: 6578 706c 6963 6974 2062 6c6f 636b 6c69 explicit blockli │ │ │ │ │ +000038f0: 7374 206e 6f74 6174 696f 6e2e 2020 5468 st notation. Th │ │ │ │ │ +00003900: 6520 6375 7272 656e 746c 7920 7375 7070 e currently supp │ │ │ │ │ +00003910: 6f72 7465 6420 6669 6c65 7379 7374 656d orted filesystem │ │ │ │ │ +00003920: 0a20 2020 2020 7479 7065 7320 6172 6520 . types are │ │ │ │ │ +00003930: 2241 6d69 6761 2046 6173 7420 4669 6c65 "Amiga Fast File │ │ │ │ │ +00003940: 5379 7374 656d 2028 4146 4653 2922 2c20 System (AFFS)", │ │ │ │ │ +00003950: 2241 7468 654f 5320 6673 222c 2022 4265 "AtheOS fs", "Be │ │ │ │ │ +00003960: 4653 222c 0a20 2020 2020 2242 7472 4653 FS",. "BtrFS │ │ │ │ │ +00003970: 2220 2869 6e63 6c75 6469 6e67 2072 6169 " (including rai │ │ │ │ │ +00003980: 6430 2c20 7261 6964 312c 2072 6169 6431 d0, raid1, raid1 │ │ │ │ │ +00003990: 302c 2067 7a69 7020 616e 6420 6c7a 6f29 0, gzip and lzo) │ │ │ │ │ +000039a0: 2c20 2263 7069 6f22 0a20 2020 2020 286c , "cpio". (l │ │ │ │ │ +000039b0: 6974 746c 652d 2061 6e64 2062 6967 2d65 ittle- and big-e │ │ │ │ │ +000039c0: 6e64 6961 6e20 6269 6e2c 206f 6463 2061 ndian bin, odc a │ │ │ │ │ +000039d0: 6e64 206e 6577 6320 7661 7269 616e 7473 nd newc variants │ │ │ │ │ +000039e0: 292c 2022 4c69 6e75 780a 2020 2020 2065 ), "Linux. e │ │ │ │ │ +000039f0: 7874 322f 6578 7433 2f65 7874 3422 2c20 xt2/ext3/ext4", │ │ │ │ │ +00003a00: 2244 4f53 2046 4154 3132 2f46 4154 3136 "DOS FAT12/FAT16 │ │ │ │ │ +00003a10: 2f46 4154 3332 222c 2022 6578 4641 5422 /FAT32", "exFAT" │ │ │ │ │ +00003a20: 2c20 2246 3246 5322 2c20 2248 4653 222c , "F2FS", "HFS", │ │ │ │ │ +00003a30: 0a20 2020 2020 2248 4653 2b22 2c20 2249 . "HFS+", "I │ │ │ │ │ +00003a40: 534f 3936 3630 2220 2869 6e63 6c75 6469 SO9660" (includi │ │ │ │ │ +00003a50: 6e67 204a 6f6c 6965 742c 2052 6f63 6b2d ng Joliet, Rock- │ │ │ │ │ +00003a60: 7269 6467 6520 616e 6420 6d75 6c74 692d ridge and multi- │ │ │ │ │ +00003a70: 6368 756e 6b0a 2020 2020 2066 696c 6573 chunk. files │ │ │ │ │ +00003a80: 292c 2022 4a46 5322 2c20 224d 696e 6978 ), "JFS", "Minix │ │ │ │ │ +00003a90: 2066 7322 2028 7665 7273 696f 6e73 2031 fs" (versions 1 │ │ │ │ │ +00003aa0: 2c20 3220 616e 6420 3329 2c20 226e 696c , 2 and 3), "nil │ │ │ │ │ +00003ab0: 6673 3222 2c20 224e 5446 5322 0a20 2020 fs2", "NTFS". │ │ │ │ │ +00003ac0: 2020 2869 6e63 6c75 6469 6e67 2063 6f6d (including com │ │ │ │ │ +00003ad0: 7072 6573 7369 6f6e 292c 2022 5265 6973 pression), "Reis │ │ │ │ │ +00003ae0: 6572 4653 222c 2022 524f 4d46 5322 2c20 erFS", "ROMFS", │ │ │ │ │ +00003af0: 2241 6d69 6761 2053 6d61 7274 0a20 2020 "Amiga Smart. │ │ │ │ │ +00003b00: 2020 4669 6c65 5379 7374 656d 2028 5346 FileSystem (SF │ │ │ │ │ +00003b10: 5329 222c 2022 5371 7561 7368 3422 2c20 S)", "Squash4", │ │ │ │ │ +00003b20: 2274 6172 222c 2022 5544 4622 2c20 2242 "tar", "UDF", "B │ │ │ │ │ +00003b30: 5344 2055 4653 2f55 4653 3222 2c20 2258 SD UFS/UFS2", "X │ │ │ │ │ +00003b40: 4653 222c 0a20 2020 2020 616e 6420 225a FS",. and "Z │ │ │ │ │ +00003b50: 4653 2220 2869 6e63 6c75 6469 6e67 206c FS" (including l │ │ │ │ │ +00003b60: 7a6a 622c 2067 7a69 702c 207a 6c65 2c20 zjb, gzip, zle, │ │ │ │ │ +00003b70: 6d69 7272 6f72 2c20 7374 7269 7065 2c20 mirror, stripe, │ │ │ │ │ +00003b80: 7261 6964 7a31 2f32 2f33 0a20 2020 2020 raidz1/2/3. │ │ │ │ │ +00003b90: 616e 6420 656e 6372 7970 7469 6f6e 2069 and encryption i │ │ │ │ │ +00003ba0: 6e20 4145 532d 4343 4d20 616e 6420 4145 n AES-CCM and AE │ │ │ │ │ +00003bb0: 532d 4743 4d29 2e20 2a4e 6f74 6520 4669 S-GCM). *Note Fi │ │ │ │ │ +00003bc0: 6c65 7379 7374 656d 3a3a 2c20 666f 720a lesystem::, for. │ │ │ │ │ +00003bd0: 2020 2020 206d 6f72 6520 696e 666f 726d more inform │ │ │ │ │ +00003be0: 6174 696f 6e2e 0a0a 5375 7070 6f72 7420 ation...Support │ │ │ │ │ +00003bf0: 6175 746f 6d61 7469 6320 6465 636f 6d70 automatic decomp │ │ │ │ │ +00003c00: 7265 7373 696f 6e0a 2020 2020 2043 616e ression. Can │ │ │ │ │ +00003c10: 2064 6563 6f6d 7072 6573 7320 6669 6c65 decompress file │ │ │ │ │ +00003c20: 7320 7768 6963 6820 7765 7265 2063 6f6d s which were com │ │ │ │ │ +00003c30: 7072 6573 7365 6420 6279 2027 677a 6970 pressed by 'gzip │ │ │ │ │ +00003c40: 2720 6f72 2027 787a 2728 3229 0a20 2020 ' or 'xz'(2). │ │ │ │ │ +00003c50: 2020 282a 6e6f 7465 2046 6561 7475 7265 (*note Feature │ │ │ │ │ +00003c60: 732d 466f 6f74 6e6f 7465 2d32 3a3a 292e s-Footnote-2::). │ │ │ │ │ +00003c70: 2020 5468 6973 2066 756e 6374 696f 6e20 This function │ │ │ │ │ +00003c80: 6973 2062 6f74 6820 6175 746f 6d61 7469 is both automati │ │ │ │ │ +00003c90: 6320 616e 640a 2020 2020 2074 7261 6e73 c and. trans │ │ │ │ │ +00003ca0: 7061 7265 6e74 2074 6f20 7468 6520 7573 parent to the us │ │ │ │ │ +00003cb0: 6572 2028 692e 652e 2020 616c 6c20 6675 er (i.e. all fu │ │ │ │ │ +00003cc0: 6e63 7469 6f6e 7320 6f70 6572 6174 6520 nctions operate │ │ │ │ │ +00003cd0: 7570 6f6e 2074 6865 0a20 2020 2020 756e upon the. un │ │ │ │ │ +00003ce0: 636f 6d70 7265 7373 6564 2063 6f6e 7465 compressed conte │ │ │ │ │ +00003cf0: 6e74 7320 6f66 2074 6865 2073 7065 6369 nts of the speci │ │ │ │ │ +00003d00: 6669 6564 2066 696c 6573 292e 2020 5468 fied files). Th │ │ │ │ │ +00003d10: 6973 2067 7265 6174 6c79 0a20 2020 2020 is greatly. │ │ │ │ │ +00003d20: 7265 6475 6365 7320 6120 6669 6c65 2073 reduces a file s │ │ │ │ │ +00003d30: 697a 6520 616e 6420 6c6f 6164 696e 6720 ize and loading │ │ │ │ │ +00003d40: 7469 6d65 2c20 6120 7061 7274 6963 756c time, a particul │ │ │ │ │ +00003d50: 6172 6c79 2067 7265 6174 2062 656e 6566 arly great benef │ │ │ │ │ +00003d60: 6974 0a20 2020 2020 666f 7220 666c 6f70 it. for flop │ │ │ │ │ +00003d70: 7069 6573 2e28 3329 2020 282a 6e6f 7465 pies.(3) (*note │ │ │ │ │ +00003d80: 2046 6561 7475 7265 732d 466f 6f74 6e6f Features-Footno │ │ │ │ │ +00003d90: 7465 2d33 3a3a 290a 0a20 2020 2020 4974 te-3::).. It │ │ │ │ │ +00003da0: 2069 7320 636f 6e63 6569 7661 626c 6520 is conceivable │ │ │ │ │ +00003db0: 7468 6174 2073 6f6d 6520 6b65 726e 656c that some kernel │ │ │ │ │ +00003dc0: 206d 6f64 756c 6573 2073 686f 756c 6420 modules should │ │ │ │ │ +00003dd0: 6265 206c 6f61 6465 6420 696e 2061 0a20 be loaded in a. │ │ │ │ │ +00003de0: 2020 2020 636f 6d70 7265 7373 6564 2073 compressed s │ │ │ │ │ +00003df0: 7461 7465 2c20 736f 2061 2064 6966 6665 tate, so a diffe │ │ │ │ │ +00003e00: 7265 6e74 206d 6f64 756c 652d 6c6f 6164 rent module-load │ │ │ │ │ +00003e10: 696e 6720 636f 6d6d 616e 6420 6361 6e20 ing command can │ │ │ │ │ +00003e20: 6265 0a20 2020 2020 7370 6563 6966 6965 be. specifie │ │ │ │ │ +00003e30: 6420 746f 2061 766f 6964 2075 6e63 6f6d d to avoid uncom │ │ │ │ │ +00003e40: 7072 6573 7369 6e67 2074 6865 206d 6f64 pressing the mod │ │ │ │ │ +00003e50: 756c 6573 2e0a 0a41 6363 6573 7320 6461 ules...Access da │ │ │ │ │ +00003e60: 7461 206f 6e20 616e 7920 696e 7374 616c ta on any instal │ │ │ │ │ +00003e70: 6c65 6420 6465 7669 6365 0a20 2020 2020 led device. │ │ │ │ │ +00003e80: 5375 7070 6f72 7420 7265 6164 696e 6720 Support reading │ │ │ │ │ +00003e90: 6461 7461 2066 726f 6d20 616e 7920 6f72 data from any or │ │ │ │ │ +00003ea0: 2061 6c6c 2066 6c6f 7070 6965 7320 6f72 all floppies or │ │ │ │ │ +00003eb0: 2068 6172 6420 6469 736b 2873 290a 2020 hard disk(s). │ │ │ │ │ +00003ec0: 2020 2072 6563 6f67 6e69 7a65 6420 6279 recognized by │ │ │ │ │ +00003ed0: 2074 6865 2042 494f 532c 2069 6e64 6570 the BIOS, indep │ │ │ │ │ +00003ee0: 656e 6465 6e74 206f 6620 7468 6520 7365 endent of the se │ │ │ │ │ +00003ef0: 7474 696e 6720 6f66 2074 6865 2072 6f6f tting of the roo │ │ │ │ │ +00003f00: 740a 2020 2020 2064 6576 6963 652e 0a0a t. device... │ │ │ │ │ +00003f10: 4265 2069 6e64 6570 656e 6465 6e74 206f Be independent o │ │ │ │ │ +00003f20: 6620 6472 6976 6520 6765 6f6d 6574 7279 f drive geometry │ │ │ │ │ +00003f30: 2074 7261 6e73 6c61 7469 6f6e 730a 2020 translations. │ │ │ │ │ +00003f40: 2020 2055 6e6c 696b 6520 6d61 6e79 206f Unlike many o │ │ │ │ │ +00003f50: 7468 6572 2062 6f6f 7420 6c6f 6164 6572 ther boot loader │ │ │ │ │ +00003f60: 732c 2047 5255 4220 6d61 6b65 7320 7468 s, GRUB makes th │ │ │ │ │ +00003f70: 6520 7061 7274 6963 756c 6172 2064 7269 e particular dri │ │ │ │ │ +00003f80: 7665 0a20 2020 2020 7472 616e 736c 6174 ve. translat │ │ │ │ │ +00003f90: 696f 6e20 6972 7265 6c65 7661 6e74 2e20 ion irrelevant. │ │ │ │ │ +00003fa0: 2041 2064 7269 7665 2069 6e73 7461 6c6c A drive install │ │ │ │ │ +00003fb0: 6564 2061 6e64 2072 756e 6e69 6e67 2077 ed and running w │ │ │ │ │ +00003fc0: 6974 6820 6f6e 650a 2020 2020 2074 7261 ith one. tra │ │ │ │ │ +00003fd0: 6e73 6c61 7469 6f6e 206d 6179 2062 6520 nslation may be │ │ │ │ │ +00003fe0: 636f 6e76 6572 7465 6420 746f 2061 6e6f converted to ano │ │ │ │ │ +00003ff0: 7468 6572 2074 7261 6e73 6c61 7469 6f6e ther translation │ │ │ │ │ +00004000: 2077 6974 686f 7574 2061 6e79 0a20 2020 without any. │ │ │ │ │ +00004010: 2020 6164 7665 7273 6520 6566 6665 6374 adverse effect │ │ │ │ │ +00004020: 7320 6f72 2063 6861 6e67 6573 2069 6e20 s or changes in │ │ │ │ │ +00004030: 4752 5542 2773 2063 6f6e 6669 6775 7261 GRUB's configura │ │ │ │ │ +00004040: 7469 6f6e 2e0a 0a44 6574 6563 7420 616c tion...Detect al │ │ │ │ │ +00004050: 6c20 696e 7374 616c 6c65 6420 5241 4d0a l installed RAM. │ │ │ │ │ +00004060: 2020 2020 2047 5255 4220 6361 6e20 6765 GRUB can ge │ │ │ │ │ +00004070: 6e65 7261 6c6c 7920 6669 6e64 2061 6c6c nerally find all │ │ │ │ │ +00004080: 2074 6865 2069 6e73 7461 6c6c 6564 2052 the installed R │ │ │ │ │ +00004090: 414d 206f 6e20 6120 5043 2d63 6f6d 7061 AM on a PC-compa │ │ │ │ │ +000040a0: 7469 626c 650a 2020 2020 206d 6163 6869 tible. machi │ │ │ │ │ +000040b0: 6e65 2e20 2049 7420 7573 6573 2061 6e20 ne. It uses an │ │ │ │ │ +000040c0: 6164 7661 6e63 6564 2042 494f 5320 7175 advanced BIOS qu │ │ │ │ │ +000040d0: 6572 7920 7465 6368 6e69 7175 6520 666f ery technique fo │ │ │ │ │ +000040e0: 7220 6669 6e64 696e 6720 616c 6c0a 2020 r finding all. │ │ │ │ │ +000040f0: 2020 206d 656d 6f72 7920 7265 6769 6f6e memory region │ │ │ │ │ +00004100: 732e 2020 4173 2064 6573 6372 6962 6564 s. As described │ │ │ │ │ +00004110: 206f 6e20 7468 6520 4d75 6c74 6962 6f6f on the Multiboo │ │ │ │ │ +00004120: 7420 5370 6563 6966 6963 6174 696f 6e20 t Specification │ │ │ │ │ +00004130: 282a 6e6f 7465 0a20 2020 2020 4d75 6c74 (*note. Mult │ │ │ │ │ +00004140: 6962 6f6f 7420 5370 6563 6966 6963 6174 iboot Specificat │ │ │ │ │ +00004150: 696f 6e3a 2028 6d75 6c74 6962 6f6f 7429 ion: (multiboot) │ │ │ │ │ +00004160: 546f 702e 292c 206e 6f74 2061 6c6c 206b Top.), not all k │ │ │ │ │ +00004170: 6572 6e65 6c73 206d 616b 6520 7573 650a ernels make use. │ │ │ │ │ +00004180: 2020 2020 206f 6620 7468 6973 2069 6e66 of this inf │ │ │ │ │ +00004190: 6f72 6d61 7469 6f6e 2c20 6275 7420 4752 ormation, but GR │ │ │ │ │ +000041a0: 5542 2070 726f 7669 6465 7320 6974 2066 UB provides it f │ │ │ │ │ +000041b0: 6f72 2074 686f 7365 2077 686f 2064 6f2e or those who do. │ │ │ │ │ +000041c0: 0a0a 5375 7070 6f72 7420 4c6f 6769 6361 ..Support Logica │ │ │ │ │ +000041d0: 6c20 426c 6f63 6b20 4164 6472 6573 7320 l Block Address │ │ │ │ │ +000041e0: 6d6f 6465 0a20 2020 2020 496e 2074 7261 mode. In tra │ │ │ │ │ +000041f0: 6469 7469 6f6e 616c 2064 6973 6b20 6361 ditional disk ca │ │ │ │ │ +00004200: 6c6c 7320 2863 616c 6c65 6420 2243 4853 lls (called "CHS │ │ │ │ │ +00004210: 206d 6f64 6522 292c 2074 6865 7265 2069 mode"), there i │ │ │ │ │ +00004220: 7320 6120 6765 6f6d 6574 7279 0a20 2020 s a geometry. │ │ │ │ │ +00004230: 2020 7472 616e 736c 6174 696f 6e20 7072 translation pr │ │ │ │ │ +00004240: 6f62 6c65 6d2c 2074 6861 7420 6973 2c20 oblem, that is, │ │ │ │ │ +00004250: 7468 6520 4249 4f53 2063 616e 6e6f 7420 the BIOS cannot │ │ │ │ │ +00004260: 6163 6365 7373 206f 7665 7220 3130 3234 access over 1024 │ │ │ │ │ +00004270: 0a20 2020 2020 6379 6c69 6e64 6572 732c . cylinders, │ │ │ │ │ +00004280: 2073 6f20 7468 6520 6163 6365 7373 6962 so the accessib │ │ │ │ │ +00004290: 6c65 2073 7061 6365 2069 7320 6c69 6d69 le space is limi │ │ │ │ │ +000042a0: 7465 6420 746f 2061 7420 6c65 6173 7420 ted to at least │ │ │ │ │ +000042b0: 3530 3820 4d42 0a20 2020 2020 616e 6420 508 MB. and │ │ │ │ │ +000042c0: 746f 2061 7420 6d6f 7374 2038 4742 2e20 to at most 8GB. │ │ │ │ │ +000042d0: 4752 5542 2063 616e 2774 2075 6e69 7665 GRUB can't unive │ │ │ │ │ +000042e0: 7273 616c 6c79 2073 6f6c 7665 2074 6869 rsally solve thi │ │ │ │ │ +000042f0: 7320 7072 6f62 6c65 6d2c 2061 730a 2020 s problem, as. │ │ │ │ │ +00004300: 2020 2074 6865 7265 2069 7320 6e6f 2073 there is no s │ │ │ │ │ +00004310: 7461 6e64 6172 6420 696e 7465 7266 6163 tandard interfac │ │ │ │ │ +00004320: 6520 7573 6564 2069 6e20 616c 6c20 6d61 e used in all ma │ │ │ │ │ +00004330: 6368 696e 6573 2e20 2048 6f77 6576 6572 chines. However │ │ │ │ │ +00004340: 2c0a 2020 2020 2073 6576 6572 616c 206e ,. several n │ │ │ │ │ +00004350: 6577 6572 206d 6163 6869 6e65 7320 6861 ewer machines ha │ │ │ │ │ +00004360: 7665 2074 6865 206e 6577 2069 6e74 6572 ve the new inter │ │ │ │ │ +00004370: 6661 6365 2c20 4c6f 6769 6361 6c20 426c face, Logical Bl │ │ │ │ │ +00004380: 6f63 6b0a 2020 2020 2041 6464 7265 7373 ock. Address │ │ │ │ │ +00004390: 2028 224c 4241 2229 206d 6f64 652e 2020 ("LBA") mode. │ │ │ │ │ +000043a0: 4752 5542 2061 7574 6f6d 6174 6963 616c GRUB automatical │ │ │ │ │ +000043b0: 6c79 2064 6574 6563 7473 2069 6620 4c42 ly detects if LB │ │ │ │ │ +000043c0: 4120 6d6f 6465 2069 730a 2020 2020 2061 A mode is. a │ │ │ │ │ +000043d0: 7661 696c 6162 6c65 2061 6e64 2075 7365 vailable and use │ │ │ │ │ +000043e0: 7320 6974 2069 6620 6176 6169 6c61 626c s it if availabl │ │ │ │ │ +000043f0: 652e 2020 496e 204c 4241 206d 6f64 652c e. In LBA mode, │ │ │ │ │ +00004400: 2047 5255 4220 6361 6e20 6163 6365 7373 GRUB can access │ │ │ │ │ +00004410: 0a20 2020 2020 7468 6520 656e 7469 7265 . the entire │ │ │ │ │ +00004420: 2064 6973 6b2e 0a0a 5375 7070 6f72 7420 disk...Support │ │ │ │ │ +00004430: 6e65 7477 6f72 6b20 626f 6f74 696e 670a network booting. │ │ │ │ │ +00004440: 2020 2020 2047 5255 4220 6973 2062 6173 GRUB is bas │ │ │ │ │ +00004450: 6963 616c 6c79 2061 2064 6973 6b2d 6261 ically a disk-ba │ │ │ │ │ +00004460: 7365 6420 626f 6f74 206c 6f61 6465 7220 sed boot loader │ │ │ │ │ +00004470: 6275 7420 616c 736f 2068 6173 206e 6574 but also has net │ │ │ │ │ +00004480: 776f 726b 0a20 2020 2020 7375 7070 6f72 work. suppor │ │ │ │ │ +00004490: 742e 2020 596f 7520 6361 6e20 6c6f 6164 t. You can load │ │ │ │ │ +000044a0: 204f 5320 696d 6167 6573 2066 726f 6d20 OS images from │ │ │ │ │ +000044b0: 6120 6e65 7477 6f72 6b20 6279 2075 7369 a network by usi │ │ │ │ │ +000044c0: 6e67 2074 6865 2022 5446 5450 220a 2020 ng the "TFTP". │ │ │ │ │ +000044d0: 2020 2070 726f 746f 636f 6c2e 0a0a 5375 protocol...Su │ │ │ │ │ +000044e0: 7070 6f72 7420 7265 6d6f 7465 2074 6572 pport remote ter │ │ │ │ │ +000044f0: 6d69 6e61 6c73 0a20 2020 2020 546f 2073 minals. To s │ │ │ │ │ +00004500: 7570 706f 7274 2063 6f6d 7075 7465 7273 upport computers │ │ │ │ │ +00004510: 2077 6974 6820 6e6f 2063 6f6e 736f 6c65 with no console │ │ │ │ │ +00004520: 2c20 4752 5542 2070 726f 7669 6465 7320 , GRUB provides │ │ │ │ │ +00004530: 7265 6d6f 7465 2074 6572 6d69 6e61 6c0a remote terminal. │ │ │ │ │ +00004540: 2020 2020 2073 7570 706f 7274 2c20 736f support, so │ │ │ │ │ +00004550: 2074 6861 7420 796f 7520 6361 6e20 636f that you can co │ │ │ │ │ +00004560: 6e74 726f 6c20 4752 5542 2066 726f 6d20 ntrol GRUB from │ │ │ │ │ +00004570: 6120 7265 6d6f 7465 2068 6f73 742e 2020 a remote host. │ │ │ │ │ +00004580: 4f6e 6c79 0a20 2020 2020 7365 7269 616c Only. serial │ │ │ │ │ +00004590: 2074 6572 6d69 6e61 6c20 7375 7070 6f72 terminal suppor │ │ │ │ │ +000045a0: 7420 6973 2069 6d70 6c65 6d65 6e74 6564 t is implemented │ │ │ │ │ +000045b0: 2061 7420 7468 6520 6d6f 6d65 6e74 2e0a at the moment.. │ │ │ │ │ +000045c0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +000045d0: 666f 2c20 204e 6f64 653a 2046 6561 7475 fo, Node: Featu │ │ │ │ │ +000045e0: 7265 732d 466f 6f74 6e6f 7465 732c 2020 res-Footnotes, │ │ │ │ │ +000045f0: 5570 3a20 4665 6174 7572 6573 0a0a 2020 Up: Features.. │ │ │ │ │ +00004600: 2028 3129 2054 6865 204e 6574 4253 442f (1) The NetBSD/ │ │ │ │ │ +00004610: 6933 3836 206b 6572 6e65 6c20 6973 204d i386 kernel is M │ │ │ │ │ +00004620: 756c 7469 626f 6f74 2d63 6f6d 706c 6961 ultiboot-complia │ │ │ │ │ +00004630: 6e74 2c20 6275 7420 6c61 636b 7320 7375 nt, but lacks su │ │ │ │ │ +00004640: 7070 6f72 740a 666f 7220 4d75 6c74 6962 pport.for Multib │ │ │ │ │ +00004650: 6f6f 7420 6d6f 6475 6c65 732e 0a0a 2020 oot modules... │ │ │ │ │ +00004660: 2028 3229 204f 6e6c 7920 4352 4333 3220 (2) Only CRC32 │ │ │ │ │ +00004670: 6461 7461 2069 6e74 6567 7269 7479 2063 data integrity c │ │ │ │ │ +00004680: 6865 636b 2069 7320 7375 7070 6f72 7465 heck is supporte │ │ │ │ │ +00004690: 6420 2878 7a20 6465 6661 756c 7420 6973 d (xz default is │ │ │ │ │ +000046a0: 2043 5243 3634 0a73 6f20 6f6e 6520 7368 CRC64.so one sh │ │ │ │ │ +000046b0: 6f75 6c64 2075 7365 202d 6368 6563 6b3d ould use -check= │ │ │ │ │ +000046c0: 6372 6333 3220 6f70 7469 6f6e 292e 2020 crc32 option). │ │ │ │ │ +000046d0: 4c5a 4d41 2042 434a 2066 696c 7465 7273 LZMA BCJ filters │ │ │ │ │ +000046e0: 2061 7265 2073 7570 706f 7274 6564 2e0a are supported.. │ │ │ │ │ +000046f0: 0a20 2020 2833 2920 5468 6572 6520 6172 . (3) There ar │ │ │ │ │ +00004700: 6520 6120 6665 7720 7061 7468 6f6c 6f67 e a few patholog │ │ │ │ │ +00004710: 6963 616c 2063 6173 6573 2077 6865 7265 ical cases where │ │ │ │ │ +00004720: 206c 6f61 6469 6e67 2061 2076 6572 7920 loading a very │ │ │ │ │ +00004730: 6261 646c 790a 6f72 6761 6e69 7a65 6420 badly.organized │ │ │ │ │ +00004740: 454c 4620 6b65 726e 656c 206d 6967 6874 ELF kernel might │ │ │ │ │ +00004750: 2074 616b 6520 6c6f 6e67 6572 2c20 6275 take longer, bu │ │ │ │ │ +00004760: 7420 696e 2070 7261 6374 6963 6520 7468 t in practice th │ │ │ │ │ +00004770: 6973 206e 6576 6572 0a68 6170 7065 6e2e is never.happen. │ │ │ │ │ +00004780: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00004790: 6e66 6f2c 2020 4e6f 6465 3a20 526f 6c65 nfo, Node: Role │ │ │ │ │ +000047a0: 206f 6620 6120 626f 6f74 206c 6f61 6465 of a boot loade │ │ │ │ │ +000047b0: 722c 2020 5072 6576 3a20 4665 6174 7572 r, Prev: Featur │ │ │ │ │ +000047c0: 6573 2c20 2055 703a 2049 6e74 726f 6475 es, Up: Introdu │ │ │ │ │ +000047d0: 6374 696f 6e0a 0a31 2e35 2054 6865 2072 ction..1.5 The r │ │ │ │ │ +000047e0: 6f6c 6520 6f66 2061 2062 6f6f 7420 6c6f ole of a boot lo │ │ │ │ │ +000047f0: 6164 6572 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ader.=========== │ │ │ │ │ 00004800: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00004810: 0a0a 5468 6520 666f 6c6c 6f77 696e 6720 ..The following │ │ │ │ │ -00004820: 6973 2061 2071 756f 7461 7469 6f6e 2066 is a quotation f │ │ │ │ │ -00004830: 726f 6d20 476f 7264 6f6e 204d 6174 7a69 rom Gordon Matzi │ │ │ │ │ -00004840: 676b 6569 742c 2061 2047 5255 4220 6661 gkeit, a GRUB fa │ │ │ │ │ -00004850: 6e61 7469 633a 0a0a 2020 2020 2053 6f6d natic:.. Som │ │ │ │ │ -00004860: 6520 7065 6f70 6c65 206c 696b 6520 746f e people like to │ │ │ │ │ -00004870: 2061 636b 6e6f 776c 6564 6765 2062 6f74 acknowledge bot │ │ │ │ │ -00004880: 6820 7468 6520 6f70 6572 6174 696e 6720 h the operating │ │ │ │ │ -00004890: 7379 7374 656d 2061 6e64 0a20 2020 2020 system and. │ │ │ │ │ -000048a0: 6b65 726e 656c 2077 6865 6e20 7468 6579 kernel when they │ │ │ │ │ -000048b0: 2074 616c 6b20 6162 6f75 7420 7468 6569 talk about thei │ │ │ │ │ -000048c0: 7220 636f 6d70 7574 6572 732c 2073 6f20 r computers, so │ │ │ │ │ -000048d0: 7468 6579 206d 6967 6874 2073 6179 2074 they might say t │ │ │ │ │ -000048e0: 6865 790a 2020 2020 2075 7365 2022 474e hey. use "GN │ │ │ │ │ -000048f0: 552f 4c69 6e75 7822 206f 7220 2247 4e55 U/Linux" or "GNU │ │ │ │ │ -00004900: 2f48 7572 6422 2e20 204f 7468 6572 2070 /Hurd". Other p │ │ │ │ │ -00004910: 656f 706c 6520 7365 656d 2074 6f20 7468 eople seem to th │ │ │ │ │ -00004920: 696e 6b20 7468 6174 2074 6865 0a20 2020 ink that the. │ │ │ │ │ -00004930: 2020 6b65 726e 656c 2069 7320 7468 6520 kernel is the │ │ │ │ │ -00004940: 6d6f 7374 2069 6d70 6f72 7461 6e74 2070 most important p │ │ │ │ │ -00004950: 6172 7420 6f66 2074 6865 2073 7973 7465 art of the syste │ │ │ │ │ -00004960: 6d2c 2073 6f20 7468 6579 206c 696b 6520 m, so they like │ │ │ │ │ -00004970: 746f 0a20 2020 2020 6361 6c6c 2074 6865 to. call the │ │ │ │ │ -00004980: 6972 2047 4e55 206f 7065 7261 7469 6e67 ir GNU operating │ │ │ │ │ -00004990: 2073 7973 7465 6d73 2022 4c69 6e75 7820 systems "Linux │ │ │ │ │ -000049a0: 7379 7374 656d 732e 220a 0a20 2020 2020 systems.".. │ │ │ │ │ -000049b0: 492c 2070 6572 736f 6e61 6c6c 792c 2062 I, personally, b │ │ │ │ │ -000049c0: 656c 6965 7665 2074 6861 7420 7468 6973 elieve that this │ │ │ │ │ -000049d0: 2069 7320 6120 6772 6176 6520 696e 6a75 is a grave inju │ │ │ │ │ -000049e0: 7374 6963 652c 2062 6563 6175 7365 2074 stice, because t │ │ │ │ │ -000049f0: 6865 0a20 2020 2020 5f62 6f6f 7420 6c6f he. _boot lo │ │ │ │ │ -00004a00: 6164 6572 5f20 6973 2074 6865 206d 6f73 ader_ is the mos │ │ │ │ │ -00004a10: 7420 696d 706f 7274 616e 7420 736f 6674 t important soft │ │ │ │ │ -00004a20: 7761 7265 206f 6620 616c 6c2e 2020 4920 ware of all. I │ │ │ │ │ -00004a30: 7573 6564 2074 6f0a 2020 2020 2072 6566 used to. ref │ │ │ │ │ -00004a40: 6572 2074 6f20 7468 6520 6162 6f76 6520 er to the above │ │ │ │ │ -00004a50: 7379 7374 656d 7320 6173 2065 6974 6865 systems as eithe │ │ │ │ │ -00004a60: 7220 224c 494c 4f22 2831 2920 282a 6e6f r "LILO"(1) (*no │ │ │ │ │ -00004a70: 7465 2052 6f6c 6520 6f66 2061 0a20 2020 te Role of a. │ │ │ │ │ -00004a80: 2020 626f 6f74 206c 6f61 6465 722d 466f boot loader-Fo │ │ │ │ │ -00004a90: 6f74 6e6f 7465 2d31 3a3a 2920 6f72 2022 otnote-1::) or " │ │ │ │ │ -00004aa0: 4752 5542 2220 7379 7374 656d 732e 0a0a GRUB" systems... │ │ │ │ │ -00004ab0: 2020 2020 2055 6e66 6f72 7475 6e61 7465 Unfortunate │ │ │ │ │ -00004ac0: 6c79 2c20 6e6f 626f 6479 2065 7665 7220 ly, nobody ever │ │ │ │ │ -00004ad0: 756e 6465 7273 746f 6f64 2077 6861 7420 understood what │ │ │ │ │ -00004ae0: 4920 7761 7320 7461 6c6b 696e 6720 6162 I was talking ab │ │ │ │ │ -00004af0: 6f75 743b 206e 6f77 0a20 2020 2020 4920 out; now. I │ │ │ │ │ -00004b00: 6a75 7374 2075 7365 2074 6865 2077 6f72 just use the wor │ │ │ │ │ -00004b10: 6420 2247 4e55 2220 6173 2061 2070 7365 d "GNU" as a pse │ │ │ │ │ -00004b20: 7564 6f6e 796d 2066 6f72 2047 5255 422e udonym for GRUB. │ │ │ │ │ -00004b30: 0a0a 2020 2020 2053 6f2c 2069 6620 796f .. So, if yo │ │ │ │ │ -00004b40: 7520 6576 6572 2068 6561 7220 7065 6f70 u ever hear peop │ │ │ │ │ -00004b50: 6c65 2074 616c 6b69 6e67 2061 626f 7574 le talking about │ │ │ │ │ -00004b60: 2074 6865 6972 2061 6c6c 6567 6564 2022 their alleged " │ │ │ │ │ -00004b70: 474e 5522 0a20 2020 2020 7379 7374 656d GNU". system │ │ │ │ │ -00004b80: 732c 2072 656d 656d 6265 7220 7468 6174 s, remember that │ │ │ │ │ -00004b90: 2074 6865 7920 6172 6520 6163 7475 616c they are actual │ │ │ │ │ -00004ba0: 6c79 2070 6179 696e 6720 686f 6d61 6765 ly paying homage │ │ │ │ │ -00004bb0: 2074 6f20 7468 6520 6265 7374 0a20 2020 to the best. │ │ │ │ │ -00004bc0: 2020 626f 6f74 206c 6f61 6465 7220 6172 boot loader ar │ │ │ │ │ -00004bd0: 6f75 6e64 2e2e 2e20 4752 5542 210a 0a20 ound... GRUB!.. │ │ │ │ │ -00004be0: 2020 5765 2c20 7468 6520 4752 5542 206d We, the GRUB m │ │ │ │ │ -00004bf0: 6169 6e74 6169 6e65 7273 2c20 646f 206e aintainers, do n │ │ │ │ │ -00004c00: 6f74 2028 7573 7561 6c6c 7929 2065 6e63 ot (usually) enc │ │ │ │ │ -00004c10: 6f75 7261 6765 2047 6f72 646f 6e27 7320 ourage Gordon's │ │ │ │ │ -00004c20: 6c65 7665 6c0a 6f66 2066 616e 6174 6963 level.of fanatic │ │ │ │ │ -00004c30: 6973 6d2c 2062 7574 2069 7420 6865 6c70 ism, but it help │ │ │ │ │ -00004c40: 7320 746f 2072 656d 656d 6265 7220 7468 s to remember th │ │ │ │ │ -00004c50: 6174 2062 6f6f 7420 6c6f 6164 6572 7320 at boot loaders │ │ │ │ │ -00004c60: 6465 7365 7276 650a 7265 636f 676e 6974 deserve.recognit │ │ │ │ │ -00004c70: 696f 6e2e 2020 5765 2068 6f70 6520 7468 ion. We hope th │ │ │ │ │ -00004c80: 6174 2079 6f75 2065 6e6a 6f79 2075 7369 at you enjoy usi │ │ │ │ │ -00004c90: 6e67 2047 4e55 2047 5255 4220 6173 206d ng GNU GRUB as m │ │ │ │ │ -00004ca0: 7563 6820 6173 2077 6520 6469 640a 7772 uch as we did.wr │ │ │ │ │ -00004cb0: 6974 696e 6720 6974 2e0a 0a1f 0a46 696c iting it.....Fil │ │ │ │ │ -00004cc0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00004cd0: 6f64 653a 2052 6f6c 6520 6f66 2061 2062 ode: Role of a b │ │ │ │ │ -00004ce0: 6f6f 7420 6c6f 6164 6572 2d46 6f6f 746e oot loader-Footn │ │ │ │ │ -00004cf0: 6f74 6573 2c20 2055 703a 2052 6f6c 6520 otes, Up: Role │ │ │ │ │ -00004d00: 6f66 2061 2062 6f6f 7420 6c6f 6164 6572 of a boot loader │ │ │ │ │ -00004d10: 0a0a 2020 2028 3129 2054 6865 204c 496e .. (1) The LIn │ │ │ │ │ -00004d20: 7578 204c 4f61 6465 722c 2061 2062 6f6f ux LOader, a boo │ │ │ │ │ -00004d30: 7420 6c6f 6164 6572 2074 6861 7420 6576 t loader that ev │ │ │ │ │ -00004d40: 6572 7962 6f64 7920 7573 6573 2c20 6275 erybody uses, bu │ │ │ │ │ -00004d50: 7420 6e6f 626f 6479 0a6c 696b 6573 2e0a t nobody.likes.. │ │ │ │ │ -00004d60: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00004d70: 666f 2c20 204e 6f64 653a 204e 616d 696e fo, Node: Namin │ │ │ │ │ -00004d80: 6720 636f 6e76 656e 7469 6f6e 2c20 204e g convention, N │ │ │ │ │ -00004d90: 6578 743a 204f 532d 7370 6563 6966 6963 ext: OS-specific │ │ │ │ │ -00004da0: 206e 6f74 6573 2061 626f 7574 2067 7275 notes about gru │ │ │ │ │ -00004db0: 6220 746f 6f6c 732c 2020 5072 6576 3a20 b tools, Prev: │ │ │ │ │ -00004dc0: 496e 7472 6f64 7563 7469 6f6e 2c20 2055 Introduction, U │ │ │ │ │ -00004dd0: 703a 2054 6f70 0a0a 3220 4e61 6d69 6e67 p: Top..2 Naming │ │ │ │ │ -00004de0: 2063 6f6e 7665 6e74 696f 6e0a 2a2a 2a2a convention.**** │ │ │ │ │ -00004df0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ -00004e00: 0a54 6865 2064 6576 6963 6520 7379 6e74 .The device synt │ │ │ │ │ -00004e10: 6178 2075 7365 6420 696e 2047 5255 4220 ax used in GRUB │ │ │ │ │ -00004e20: 6973 2061 2077 6565 2062 6974 2064 6966 is a wee bit dif │ │ │ │ │ -00004e30: 6665 7265 6e74 2066 726f 6d20 7768 6174 ferent from what │ │ │ │ │ -00004e40: 2079 6f75 206d 6179 0a68 6176 6520 7365 you may.have se │ │ │ │ │ -00004e50: 656e 2062 6566 6f72 6520 696e 2079 6f75 en before in you │ │ │ │ │ -00004e60: 7220 6f70 6572 6174 696e 6720 7379 7374 r operating syst │ │ │ │ │ -00004e70: 656d 2873 292c 2061 6e64 2079 6f75 206e em(s), and you n │ │ │ │ │ -00004e80: 6565 6420 746f 206b 6e6f 7720 6974 2073 eed to know it s │ │ │ │ │ -00004e90: 6f0a 7468 6174 2079 6f75 2063 616e 2073 o.that you can s │ │ │ │ │ -00004ea0: 7065 6369 6679 2061 2064 7269 7665 2f70 pecify a drive/p │ │ │ │ │ -00004eb0: 6172 7469 7469 6f6e 2e0a 0a20 2020 4c6f artition... Lo │ │ │ │ │ -00004ec0: 6f6b 2061 7420 7468 6520 666f 6c6c 6f77 ok at the follow │ │ │ │ │ -00004ed0: 696e 6720 6578 616d 706c 6573 2061 6e64 ing examples and │ │ │ │ │ -00004ee0: 2065 7870 6c61 6e61 7469 6f6e 733a 0a0a explanations:.. │ │ │ │ │ -00004ef0: 2020 2020 2028 6664 3029 0a0a 2020 2046 (fd0).. F │ │ │ │ │ -00004f00: 6972 7374 206f 6620 616c 6c2c 2047 5255 irst of all, GRU │ │ │ │ │ -00004f10: 4220 7265 7175 6972 6573 2074 6861 7420 B requires that │ │ │ │ │ -00004f20: 7468 6520 6465 7669 6365 206e 616d 6520 the device name │ │ │ │ │ -00004f30: 6265 2065 6e63 6c6f 7365 6420 7769 7468 be enclosed with │ │ │ │ │ -00004f40: 2027 2827 0a61 6e64 2027 2927 2e20 2054 '('.and ')'. T │ │ │ │ │ -00004f50: 6865 2027 6664 2720 7061 7274 206d 6561 he 'fd' part mea │ │ │ │ │ -00004f60: 6e73 2074 6861 7420 6974 2069 7320 6120 ns that it is a │ │ │ │ │ -00004f70: 666c 6f70 7079 2064 6973 6b2e 2020 5468 floppy disk. Th │ │ │ │ │ -00004f80: 6520 6e75 6d62 6572 2027 3027 0a69 7320 e number '0'.is │ │ │ │ │ -00004f90: 7468 6520 6472 6976 6520 6e75 6d62 6572 the drive number │ │ │ │ │ -00004fa0: 2c20 7768 6963 6820 6973 2063 6f75 6e74 , which is count │ │ │ │ │ -00004fb0: 6564 2066 726f 6d20 5f7a 6572 6f5f 2e20 ed from _zero_. │ │ │ │ │ -00004fc0: 2054 6869 7320 6578 7072 6573 7369 6f6e This expression │ │ │ │ │ -00004fd0: 0a6d 6561 6e73 2074 6861 7420 4752 5542 .means that GRUB │ │ │ │ │ -00004fe0: 2077 696c 6c20 7573 6520 7468 6520 7768 will use the wh │ │ │ │ │ -00004ff0: 6f6c 6520 666c 6f70 7079 2064 6973 6b2e ole floppy disk. │ │ │ │ │ -00005000: 0a0a 2020 2020 2028 6864 302c 6d73 646f .. (hd0,msdo │ │ │ │ │ -00005010: 7332 290a 0a20 2020 4865 7265 2c20 2768 s2).. Here, 'h │ │ │ │ │ -00005020: 6427 206d 6561 6e73 2069 7420 6973 2061 d' means it is a │ │ │ │ │ -00005030: 2068 6172 6420 6469 736b 2064 7269 7665 hard disk drive │ │ │ │ │ -00005040: 2e20 2054 6865 2066 6972 7374 2069 6e74 . The first int │ │ │ │ │ -00005050: 6567 6572 2027 3027 0a69 6e64 6963 6174 eger '0'.indicat │ │ │ │ │ -00005060: 6573 2074 6865 2064 7269 7665 206e 756d es the drive num │ │ │ │ │ -00005070: 6265 722c 2074 6861 7420 6973 2c20 7468 ber, that is, th │ │ │ │ │ -00005080: 6520 6669 7273 7420 6861 7264 2064 6973 e first hard dis │ │ │ │ │ -00005090: 6b2c 2074 6865 2073 7472 696e 670a 276d k, the string.'m │ │ │ │ │ -000050a0: 7364 6f73 2720 696e 6469 6361 7465 7320 sdos' indicates │ │ │ │ │ -000050b0: 7468 6520 7061 7274 6974 696f 6e20 7363 the partition sc │ │ │ │ │ -000050c0: 6865 6d65 2c20 7768 696c 6520 7468 6520 heme, while the │ │ │ │ │ -000050d0: 7365 636f 6e64 2069 6e74 6567 6572 2c20 second integer, │ │ │ │ │ -000050e0: 2732 272c 0a69 6e64 6963 6174 6573 2074 '2',.indicates t │ │ │ │ │ -000050f0: 6865 2070 6172 7469 7469 6f6e 206e 756d he partition num │ │ │ │ │ -00005100: 6265 7220 286f 7220 7468 6520 5043 2073 ber (or the PC s │ │ │ │ │ -00005110: 6c69 6365 206e 756d 6265 7220 696e 2074 lice number in t │ │ │ │ │ -00005120: 6865 2042 5344 0a74 6572 6d69 6e6f 6c6f he BSD.terminolo │ │ │ │ │ -00005130: 6779 292e 2020 5468 6520 7061 7274 6974 gy). The partit │ │ │ │ │ -00005140: 696f 6e20 6e75 6d62 6572 7320 6172 6520 ion numbers are │ │ │ │ │ -00005150: 636f 756e 7465 6420 6672 6f6d 205f 6f6e counted from _on │ │ │ │ │ -00005160: 655f 2c20 6e6f 7420 6672 6f6d 0a7a 6572 e_, not from.zer │ │ │ │ │ -00005170: 6f20 2861 7320 7761 7320 7468 6520 6361 o (as was the ca │ │ │ │ │ -00005180: 7365 2069 6e20 7072 6576 696f 7573 2076 se in previous v │ │ │ │ │ -00005190: 6572 7369 6f6e 7320 6f66 2047 5255 4229 ersions of GRUB) │ │ │ │ │ -000051a0: 2e20 5468 6973 2065 7870 7265 7373 696f . This expressio │ │ │ │ │ -000051b0: 6e0a 6d65 616e 7320 7468 6520 7365 636f n.means the seco │ │ │ │ │ -000051c0: 6e64 2070 6172 7469 7469 6f6e 206f 6620 nd partition of │ │ │ │ │ -000051d0: 7468 6520 6669 7273 7420 6861 7264 2064 the first hard d │ │ │ │ │ -000051e0: 6973 6b20 6472 6976 652e 2020 496e 2074 isk drive. In t │ │ │ │ │ -000051f0: 6869 7320 6361 7365 2c0a 4752 5542 2075 his case,.GRUB u │ │ │ │ │ -00005200: 7365 7320 6f6e 6520 7061 7274 6974 696f ses one partitio │ │ │ │ │ -00005210: 6e20 6f66 2074 6865 2064 6973 6b2c 2069 n of the disk, i │ │ │ │ │ -00005220: 6e73 7465 6164 206f 6620 7468 6520 7768 nstead of the wh │ │ │ │ │ -00005230: 6f6c 6520 6469 736b 2e0a 0a20 2020 2020 ole disk... │ │ │ │ │ -00005240: 2868 6430 2c6d 7364 6f73 3529 0a0a 2020 (hd0,msdos5).. │ │ │ │ │ -00005250: 2054 6869 7320 7370 6563 6966 6965 7320 This specifies │ │ │ │ │ -00005260: 7468 6520 6669 7273 7420 2265 7874 656e the first "exten │ │ │ │ │ -00005270: 6465 6420 7061 7274 6974 696f 6e22 206f ded partition" o │ │ │ │ │ -00005280: 6620 7468 6520 6669 7273 7420 6861 7264 f the first hard │ │ │ │ │ -00005290: 2064 6973 6b0a 6472 6976 652e 2020 4e6f disk.drive. No │ │ │ │ │ -000052a0: 7465 2074 6861 7420 7468 6520 7061 7274 te that the part │ │ │ │ │ -000052b0: 6974 696f 6e20 6e75 6d62 6572 7320 666f ition numbers fo │ │ │ │ │ -000052c0: 7220 6578 7465 6e64 6564 2070 6172 7469 r extended parti │ │ │ │ │ -000052d0: 7469 6f6e 7320 6172 650a 636f 756e 7465 tions are.counte │ │ │ │ │ -000052e0: 6420 6672 6f6d 2027 3527 2c20 7265 6761 d from '5', rega │ │ │ │ │ -000052f0: 7264 6c65 7373 206f 6620 7468 6520 6163 rdless of the ac │ │ │ │ │ -00005300: 7475 616c 206e 756d 6265 7220 6f66 2070 tual number of p │ │ │ │ │ -00005310: 7269 6d61 7279 2070 6172 7469 7469 6f6e rimary partition │ │ │ │ │ -00005320: 730a 6f6e 2079 6f75 7220 6861 7264 2064 s.on your hard d │ │ │ │ │ -00005330: 6973 6b2e 0a0a 2020 2020 2028 6864 312c isk... (hd1, │ │ │ │ │ -00005340: 6d73 646f 7331 2c62 7364 3129 0a0a 2020 msdos1,bsd1).. │ │ │ │ │ -00005350: 2054 6869 7320 6d65 616e 7320 7468 6520 This means the │ │ │ │ │ -00005360: 4253 4420 2761 2720 7061 7274 6974 696f BSD 'a' partitio │ │ │ │ │ -00005370: 6e20 6f6e 2066 6972 7374 2050 4320 736c n on first PC sl │ │ │ │ │ -00005380: 6963 6520 6e75 6d62 6572 206f 6620 7468 ice number of th │ │ │ │ │ -00005390: 650a 7365 636f 6e64 2068 6172 6420 6469 e.second hard di │ │ │ │ │ -000053a0: 736b 2e0a 0a20 2020 4f66 2063 6f75 7273 sk... Of cours │ │ │ │ │ -000053b0: 652c 2074 6f20 6163 7475 616c 6c79 2061 e, to actually a │ │ │ │ │ -000053c0: 6363 6573 7320 7468 6520 6469 736b 7320 ccess the disks │ │ │ │ │ -000053d0: 6f72 2070 6172 7469 7469 6f6e 7320 7769 or partitions wi │ │ │ │ │ -000053e0: 7468 2047 5255 422c 2079 6f75 0a6e 6565 th GRUB, you.nee │ │ │ │ │ -000053f0: 6420 746f 2075 7365 2074 6865 2064 6576 d to use the dev │ │ │ │ │ -00005400: 6963 6520 7370 6563 6966 6963 6174 696f ice specificatio │ │ │ │ │ -00005410: 6e20 696e 2061 2063 6f6d 6d61 6e64 2c20 n in a command, │ │ │ │ │ -00005420: 6c69 6b65 2027 7365 7420 726f 6f74 3d28 like 'set root=( │ │ │ │ │ -00005430: 6664 3029 270a 6f72 2027 7061 7274 746f fd0)'.or 'partto │ │ │ │ │ -00005440: 6f6c 2028 6864 302c 6d73 646f 7333 2920 ol (hd0,msdos3) │ │ │ │ │ -00005450: 6869 6464 656e 2d27 2e20 2054 6f20 6865 hidden-'. To he │ │ │ │ │ -00005460: 6c70 2079 6f75 2066 696e 6420 6f75 7420 lp you find out │ │ │ │ │ -00005470: 7768 6963 6820 6e75 6d62 6572 0a73 7065 which number.spe │ │ │ │ │ -00005480: 6369 6669 6573 2061 2070 6172 7469 7469 cifies a partiti │ │ │ │ │ -00005490: 6f6e 2079 6f75 2077 616e 742c 2074 6865 on you want, the │ │ │ │ │ -000054a0: 2047 5255 4220 636f 6d6d 616e 642d 6c69 GRUB command-li │ │ │ │ │ -000054b0: 6e65 2028 2a6e 6f74 650a 436f 6d6d 616e ne (*note.Comman │ │ │ │ │ -000054c0: 642d 6c69 6e65 2069 6e74 6572 6661 6365 d-line interface │ │ │ │ │ -000054d0: 3a3a 2920 6f70 7469 6f6e 7320 6861 7665 ::) options have │ │ │ │ │ -000054e0: 2061 7267 756d 656e 7420 636f 6d70 6c65 argument comple │ │ │ │ │ -000054f0: 7469 6f6e 2e20 2054 6869 7320 6d65 616e tion. This mean │ │ │ │ │ -00005500: 730a 7468 6174 2c20 666f 7220 6578 616d s.that, for exam │ │ │ │ │ -00005510: 706c 652c 2079 6f75 206f 6e6c 7920 6e65 ple, you only ne │ │ │ │ │ -00005520: 6564 2074 6f20 7479 7065 0a0a 2020 2020 ed to type.. │ │ │ │ │ -00005530: 2073 6574 2072 6f6f 743d 280a 0a20 2020 set root=(.. │ │ │ │ │ -00005540: 666f 6c6c 6f77 6564 2062 7920 6120 3c54 followed by a , and GRUB wi │ │ │ │ │ -00005560: 6c6c 2064 6973 706c 6179 2074 6865 206c ll display the l │ │ │ │ │ -00005570: 6973 7420 6f66 2064 7269 7665 732c 0a70 ist of drives,.p │ │ │ │ │ -00005580: 6172 7469 7469 6f6e 732c 206f 7220 6669 artitions, or fi │ │ │ │ │ -00005590: 6c65 206e 616d 6573 2e20 2053 6f20 6974 le names. So it │ │ │ │ │ -000055a0: 2073 686f 756c 6420 6265 2071 7569 7465 should be quite │ │ │ │ │ -000055b0: 2065 6173 7920 746f 2064 6574 6572 6d69 easy to determi │ │ │ │ │ -000055c0: 6e65 2074 6865 0a6e 616d 6520 6f66 2079 ne the.name of y │ │ │ │ │ -000055d0: 6f75 7220 7461 7267 6574 2070 6172 7469 our target parti │ │ │ │ │ -000055e0: 7469 6f6e 2c20 6576 656e 2077 6974 6820 tion, even with │ │ │ │ │ -000055f0: 6d69 6e69 6d61 6c20 6b6e 6f77 6c65 6467 minimal knowledg │ │ │ │ │ -00005600: 6520 6f66 2074 6865 0a73 796e 7461 782e e of the.syntax. │ │ │ │ │ -00005610: 0a0a 2020 204e 6f74 6520 7468 6174 2047 .. Note that G │ │ │ │ │ -00005620: 5255 4220 646f 6573 205f 6e6f 745f 2064 RUB does _not_ d │ │ │ │ │ -00005630: 6973 7469 6e67 7569 7368 2049 4445 2066 istinguish IDE f │ │ │ │ │ -00005640: 726f 6d20 5343 5349 202d 2069 7420 7369 rom SCSI - it si │ │ │ │ │ -00005650: 6d70 6c79 0a63 6f75 6e74 7320 7468 6520 mply.counts the │ │ │ │ │ -00005660: 6472 6976 6520 6e75 6d62 6572 7320 6672 drive numbers fr │ │ │ │ │ -00005670: 6f6d 207a 6572 6f2c 2072 6567 6172 646c om zero, regardl │ │ │ │ │ -00005680: 6573 7320 6f66 2074 6865 6972 2074 7970 ess of their typ │ │ │ │ │ -00005690: 652e 2020 4e6f 726d 616c 6c79 2c0a 616e e. Normally,.an │ │ │ │ │ -000056a0: 7920 4944 4520 6472 6976 6520 6e75 6d62 y IDE drive numb │ │ │ │ │ -000056b0: 6572 2069 7320 6c65 7373 2074 6861 6e20 er is less than │ │ │ │ │ -000056c0: 616e 7920 5343 5349 2064 7269 7665 206e any SCSI drive n │ │ │ │ │ -000056d0: 756d 6265 722c 2061 6c74 686f 7567 6820 umber, although │ │ │ │ │ -000056e0: 7468 6174 0a69 7320 6e6f 7420 7472 7565 that.is not true │ │ │ │ │ -000056f0: 2069 6620 796f 7520 6368 616e 6765 2074 if you change t │ │ │ │ │ -00005700: 6865 2062 6f6f 7420 7365 7175 656e 6365 he boot sequence │ │ │ │ │ -00005710: 2062 7920 7377 6170 7069 6e67 2049 4445 by swapping IDE │ │ │ │ │ -00005720: 2061 6e64 2053 4353 490a 6472 6976 6573 and SCSI.drives │ │ │ │ │ -00005730: 2069 6e20 796f 7572 2042 494f 532e 0a0a in your BIOS... │ │ │ │ │ -00005740: 2020 204e 6f77 2074 6865 2071 7565 7374 Now the quest │ │ │ │ │ -00005750: 696f 6e20 6973 2c20 686f 7720 746f 2073 ion is, how to s │ │ │ │ │ -00005760: 7065 6369 6679 2061 2066 696c 653f 2020 pecify a file? │ │ │ │ │ -00005770: 4167 6169 6e2c 2063 6f6e 7369 6465 7220 Again, consider │ │ │ │ │ -00005780: 616e 0a65 7861 6d70 6c65 3a0a 0a20 2020 an.example:.. │ │ │ │ │ -00005790: 2020 2868 6430 2c6d 7364 6f73 3129 2f76 (hd0,msdos1)/v │ │ │ │ │ -000057a0: 6d6c 696e 757a 0a0a 2020 2054 6869 7320 mlinuz.. This │ │ │ │ │ -000057b0: 7370 6563 6966 6965 7320 7468 6520 6669 specifies the fi │ │ │ │ │ -000057c0: 6c65 206e 616d 6564 2027 766d 6c69 6e75 le named 'vmlinu │ │ │ │ │ -000057d0: 7a27 2c20 666f 756e 6420 6f6e 2074 6865 z', found on the │ │ │ │ │ -000057e0: 2066 6972 7374 2070 6172 7469 7469 6f6e first partition │ │ │ │ │ -000057f0: 0a6f 6620 7468 6520 6669 7273 7420 6861 .of the first ha │ │ │ │ │ -00005800: 7264 2064 6973 6b20 6472 6976 652e 2020 rd disk drive. │ │ │ │ │ -00005810: 4e6f 7465 2074 6861 7420 7468 6520 6172 Note that the ar │ │ │ │ │ -00005820: 6775 6d65 6e74 2063 6f6d 706c 6574 696f gument completio │ │ │ │ │ -00005830: 6e20 776f 726b 730a 7769 7468 2066 696c n works.with fil │ │ │ │ │ -00005840: 6520 6e61 6d65 732c 2074 6f6f 2e0a 0a20 e names, too... │ │ │ │ │ -00005850: 2020 5468 6174 2077 6173 2065 6173 792c That was easy, │ │ │ │ │ -00005860: 2061 646d 6974 2069 742e 2020 4e6f 7720 admit it. Now │ │ │ │ │ -00005870: 7265 6164 2074 6865 206e 6578 7420 6368 read the next ch │ │ │ │ │ -00005880: 6170 7465 722c 2074 6f20 6669 6e64 206f apter, to find o │ │ │ │ │ -00005890: 7574 2068 6f77 0a74 6f20 6163 7475 616c ut how.to actual │ │ │ │ │ -000058a0: 6c79 2069 6e73 7461 6c6c 2047 5255 4220 ly install GRUB │ │ │ │ │ -000058b0: 6f6e 2079 6f75 7220 6472 6976 652e 0a0a on your drive... │ │ │ │ │ -000058c0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -000058d0: 6f2c 2020 4e6f 6465 3a20 4f53 2d73 7065 o, Node: OS-spe │ │ │ │ │ -000058e0: 6369 6669 6320 6e6f 7465 7320 6162 6f75 cific notes abou │ │ │ │ │ -000058f0: 7420 6772 7562 2074 6f6f 6c73 2c20 204e t grub tools, N │ │ │ │ │ -00005900: 6578 743a 2049 6e73 7461 6c6c 6174 696f ext: Installatio │ │ │ │ │ -00005910: 6e2c 2020 5072 6576 3a20 4e61 6d69 6e67 n, Prev: Naming │ │ │ │ │ -00005920: 2063 6f6e 7665 6e74 696f 6e2c 2020 5570 convention, Up │ │ │ │ │ -00005930: 3a20 546f 700a 0a33 204f 532d 7370 6563 : Top..3 OS-spec │ │ │ │ │ -00005940: 6966 6963 206e 6f74 6573 2061 626f 7574 ific notes about │ │ │ │ │ -00005950: 2067 7275 6220 746f 6f6c 730a 2a2a 2a2a grub tools.**** │ │ │ │ │ +00004810: 3d3d 0a0a 5468 6520 666f 6c6c 6f77 696e ==..The followin │ │ │ │ │ +00004820: 6720 6973 2061 2071 756f 7461 7469 6f6e g is a quotation │ │ │ │ │ +00004830: 2066 726f 6d20 476f 7264 6f6e 204d 6174 from Gordon Mat │ │ │ │ │ +00004840: 7a69 676b 6569 742c 2061 2047 5255 4220 zigkeit, a GRUB │ │ │ │ │ +00004850: 6661 6e61 7469 633a 0a0a 2020 2020 2053 fanatic:.. S │ │ │ │ │ +00004860: 6f6d 6520 7065 6f70 6c65 206c 696b 6520 ome people like │ │ │ │ │ +00004870: 746f 2061 636b 6e6f 776c 6564 6765 2062 to acknowledge b │ │ │ │ │ +00004880: 6f74 6820 7468 6520 6f70 6572 6174 696e oth the operatin │ │ │ │ │ +00004890: 6720 7379 7374 656d 2061 6e64 0a20 2020 g system and. │ │ │ │ │ +000048a0: 2020 6b65 726e 656c 2077 6865 6e20 7468 kernel when th │ │ │ │ │ +000048b0: 6579 2074 616c 6b20 6162 6f75 7420 7468 ey talk about th │ │ │ │ │ +000048c0: 6569 7220 636f 6d70 7574 6572 732c 2073 eir computers, s │ │ │ │ │ +000048d0: 6f20 7468 6579 206d 6967 6874 2073 6179 o they might say │ │ │ │ │ +000048e0: 2074 6865 790a 2020 2020 2075 7365 2022 they. use " │ │ │ │ │ +000048f0: 474e 552f 4c69 6e75 7822 206f 7220 2247 GNU/Linux" or "G │ │ │ │ │ +00004900: 4e55 2f48 7572 6422 2e20 204f 7468 6572 NU/Hurd". Other │ │ │ │ │ +00004910: 2070 656f 706c 6520 7365 656d 2074 6f20 people seem to │ │ │ │ │ +00004920: 7468 696e 6b20 7468 6174 2074 6865 0a20 think that the. │ │ │ │ │ +00004930: 2020 2020 6b65 726e 656c 2069 7320 7468 kernel is th │ │ │ │ │ +00004940: 6520 6d6f 7374 2069 6d70 6f72 7461 6e74 e most important │ │ │ │ │ +00004950: 2070 6172 7420 6f66 2074 6865 2073 7973 part of the sys │ │ │ │ │ +00004960: 7465 6d2c 2073 6f20 7468 6579 206c 696b tem, so they lik │ │ │ │ │ +00004970: 6520 746f 0a20 2020 2020 6361 6c6c 2074 e to. call t │ │ │ │ │ +00004980: 6865 6972 2047 4e55 206f 7065 7261 7469 heir GNU operati │ │ │ │ │ +00004990: 6e67 2073 7973 7465 6d73 2022 4c69 6e75 ng systems "Linu │ │ │ │ │ +000049a0: 7820 7379 7374 656d 732e 220a 0a20 2020 x systems.".. │ │ │ │ │ +000049b0: 2020 492c 2070 6572 736f 6e61 6c6c 792c I, personally, │ │ │ │ │ +000049c0: 2062 656c 6965 7665 2074 6861 7420 7468 believe that th │ │ │ │ │ +000049d0: 6973 2069 7320 6120 6772 6176 6520 696e is is a grave in │ │ │ │ │ +000049e0: 6a75 7374 6963 652c 2062 6563 6175 7365 justice, because │ │ │ │ │ +000049f0: 2074 6865 0a20 2020 2020 5f62 6f6f 7420 the. _boot │ │ │ │ │ +00004a00: 6c6f 6164 6572 5f20 6973 2074 6865 206d loader_ is the m │ │ │ │ │ +00004a10: 6f73 7420 696d 706f 7274 616e 7420 736f ost important so │ │ │ │ │ +00004a20: 6674 7761 7265 206f 6620 616c 6c2e 2020 ftware of all. │ │ │ │ │ +00004a30: 4920 7573 6564 2074 6f0a 2020 2020 2072 I used to. r │ │ │ │ │ +00004a40: 6566 6572 2074 6f20 7468 6520 6162 6f76 efer to the abov │ │ │ │ │ +00004a50: 6520 7379 7374 656d 7320 6173 2065 6974 e systems as eit │ │ │ │ │ +00004a60: 6865 7220 224c 494c 4f22 2831 2920 282a her "LILO"(1) (* │ │ │ │ │ +00004a70: 6e6f 7465 2052 6f6c 6520 6f66 2061 0a20 note Role of a. │ │ │ │ │ +00004a80: 2020 2020 626f 6f74 206c 6f61 6465 722d boot loader- │ │ │ │ │ +00004a90: 466f 6f74 6e6f 7465 2d31 3a3a 2920 6f72 Footnote-1::) or │ │ │ │ │ +00004aa0: 2022 4752 5542 2220 7379 7374 656d 732e "GRUB" systems. │ │ │ │ │ +00004ab0: 0a0a 2020 2020 2055 6e66 6f72 7475 6e61 .. Unfortuna │ │ │ │ │ +00004ac0: 7465 6c79 2c20 6e6f 626f 6479 2065 7665 tely, nobody eve │ │ │ │ │ +00004ad0: 7220 756e 6465 7273 746f 6f64 2077 6861 r understood wha │ │ │ │ │ +00004ae0: 7420 4920 7761 7320 7461 6c6b 696e 6720 t I was talking │ │ │ │ │ +00004af0: 6162 6f75 743b 206e 6f77 0a20 2020 2020 about; now. │ │ │ │ │ +00004b00: 4920 6a75 7374 2075 7365 2074 6865 2077 I just use the w │ │ │ │ │ +00004b10: 6f72 6420 2247 4e55 2220 6173 2061 2070 ord "GNU" as a p │ │ │ │ │ +00004b20: 7365 7564 6f6e 796d 2066 6f72 2047 5255 seudonym for GRU │ │ │ │ │ +00004b30: 422e 0a0a 2020 2020 2053 6f2c 2069 6620 B... So, if │ │ │ │ │ +00004b40: 796f 7520 6576 6572 2068 6561 7220 7065 you ever hear pe │ │ │ │ │ +00004b50: 6f70 6c65 2074 616c 6b69 6e67 2061 626f ople talking abo │ │ │ │ │ +00004b60: 7574 2074 6865 6972 2061 6c6c 6567 6564 ut their alleged │ │ │ │ │ +00004b70: 2022 474e 5522 0a20 2020 2020 7379 7374 "GNU". syst │ │ │ │ │ +00004b80: 656d 732c 2072 656d 656d 6265 7220 7468 ems, remember th │ │ │ │ │ +00004b90: 6174 2074 6865 7920 6172 6520 6163 7475 at they are actu │ │ │ │ │ +00004ba0: 616c 6c79 2070 6179 696e 6720 686f 6d61 ally paying homa │ │ │ │ │ +00004bb0: 6765 2074 6f20 7468 6520 6265 7374 0a20 ge to the best. │ │ │ │ │ +00004bc0: 2020 2020 626f 6f74 206c 6f61 6465 7220 boot loader │ │ │ │ │ +00004bd0: 6172 6f75 6e64 2e2e 2e20 4752 5542 210a around... GRUB!. │ │ │ │ │ +00004be0: 0a20 2020 5765 2c20 7468 6520 4752 5542 . We, the GRUB │ │ │ │ │ +00004bf0: 206d 6169 6e74 6169 6e65 7273 2c20 646f maintainers, do │ │ │ │ │ +00004c00: 206e 6f74 2028 7573 7561 6c6c 7929 2065 not (usually) e │ │ │ │ │ +00004c10: 6e63 6f75 7261 6765 2047 6f72 646f 6e27 ncourage Gordon' │ │ │ │ │ +00004c20: 7320 6c65 7665 6c0a 6f66 2066 616e 6174 s level.of fanat │ │ │ │ │ +00004c30: 6963 6973 6d2c 2062 7574 2069 7420 6865 icism, but it he │ │ │ │ │ +00004c40: 6c70 7320 746f 2072 656d 656d 6265 7220 lps to remember │ │ │ │ │ +00004c50: 7468 6174 2062 6f6f 7420 6c6f 6164 6572 that boot loader │ │ │ │ │ +00004c60: 7320 6465 7365 7276 650a 7265 636f 676e s deserve.recogn │ │ │ │ │ +00004c70: 6974 696f 6e2e 2020 5765 2068 6f70 6520 ition. We hope │ │ │ │ │ +00004c80: 7468 6174 2079 6f75 2065 6e6a 6f79 2075 that you enjoy u │ │ │ │ │ +00004c90: 7369 6e67 2047 4e55 2047 5255 4220 6173 sing GNU GRUB as │ │ │ │ │ +00004ca0: 206d 7563 6820 6173 2077 6520 6469 640a much as we did. │ │ │ │ │ +00004cb0: 7772 6974 696e 6720 6974 2e0a 0a1f 0a46 writing it.....F │ │ │ │ │ +00004cc0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00004cd0: 204e 6f64 653a 2052 6f6c 6520 6f66 2061 Node: Role of a │ │ │ │ │ +00004ce0: 2062 6f6f 7420 6c6f 6164 6572 2d46 6f6f boot loader-Foo │ │ │ │ │ +00004cf0: 746e 6f74 6573 2c20 2055 703a 2052 6f6c tnotes, Up: Rol │ │ │ │ │ +00004d00: 6520 6f66 2061 2062 6f6f 7420 6c6f 6164 e of a boot load │ │ │ │ │ +00004d10: 6572 0a0a 2020 2028 3129 2054 6865 204c er.. (1) The L │ │ │ │ │ +00004d20: 496e 7578 204c 4f61 6465 722c 2061 2062 Inux LOader, a b │ │ │ │ │ +00004d30: 6f6f 7420 6c6f 6164 6572 2074 6861 7420 oot loader that │ │ │ │ │ +00004d40: 6576 6572 7962 6f64 7920 7573 6573 2c20 everybody uses, │ │ │ │ │ +00004d50: 6275 7420 6e6f 626f 6479 0a6c 696b 6573 but nobody.likes │ │ │ │ │ +00004d60: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00004d70: 696e 666f 2c20 204e 6f64 653a 204e 616d info, Node: Nam │ │ │ │ │ +00004d80: 696e 6720 636f 6e76 656e 7469 6f6e 2c20 ing convention, │ │ │ │ │ +00004d90: 204e 6578 743a 204f 532d 7370 6563 6966 Next: OS-specif │ │ │ │ │ +00004da0: 6963 206e 6f74 6573 2061 626f 7574 2067 ic notes about g │ │ │ │ │ +00004db0: 7275 6220 746f 6f6c 732c 2020 5072 6576 rub tools, Prev │ │ │ │ │ +00004dc0: 3a20 496e 7472 6f64 7563 7469 6f6e 2c20 : Introduction, │ │ │ │ │ +00004dd0: 2055 703a 2054 6f70 0a0a 3220 4e61 6d69 Up: Top..2 Nami │ │ │ │ │ +00004de0: 6e67 2063 6f6e 7665 6e74 696f 6e0a 2a2a ng convention.** │ │ │ │ │ +00004df0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +00004e00: 2a0a 0a54 6865 2064 6576 6963 6520 7379 *..The device sy │ │ │ │ │ +00004e10: 6e74 6178 2075 7365 6420 696e 2047 5255 ntax used in GRU │ │ │ │ │ +00004e20: 4220 6973 2061 2077 6565 2062 6974 2064 B is a wee bit d │ │ │ │ │ +00004e30: 6966 6665 7265 6e74 2066 726f 6d20 7768 ifferent from wh │ │ │ │ │ +00004e40: 6174 2079 6f75 206d 6179 0a68 6176 6520 at you may.have │ │ │ │ │ +00004e50: 7365 656e 2062 6566 6f72 6520 696e 2079 seen before in y │ │ │ │ │ +00004e60: 6f75 7220 6f70 6572 6174 696e 6720 7379 our operating sy │ │ │ │ │ +00004e70: 7374 656d 2873 292c 2061 6e64 2079 6f75 stem(s), and you │ │ │ │ │ +00004e80: 206e 6565 6420 746f 206b 6e6f 7720 6974 need to know it │ │ │ │ │ +00004e90: 2073 6f0a 7468 6174 2079 6f75 2063 616e so.that you can │ │ │ │ │ +00004ea0: 2073 7065 6369 6679 2061 2064 7269 7665 specify a drive │ │ │ │ │ +00004eb0: 2f70 6172 7469 7469 6f6e 2e0a 0a20 2020 /partition... │ │ │ │ │ +00004ec0: 4c6f 6f6b 2061 7420 7468 6520 666f 6c6c Look at the foll │ │ │ │ │ +00004ed0: 6f77 696e 6720 6578 616d 706c 6573 2061 owing examples a │ │ │ │ │ +00004ee0: 6e64 2065 7870 6c61 6e61 7469 6f6e 733a nd explanations: │ │ │ │ │ +00004ef0: 0a0a 2020 2020 2028 6664 3029 0a0a 2020 .. (fd0).. │ │ │ │ │ +00004f00: 2046 6972 7374 206f 6620 616c 6c2c 2047 First of all, G │ │ │ │ │ +00004f10: 5255 4220 7265 7175 6972 6573 2074 6861 RUB requires tha │ │ │ │ │ +00004f20: 7420 7468 6520 6465 7669 6365 206e 616d t the device nam │ │ │ │ │ +00004f30: 6520 6265 2065 6e63 6c6f 7365 6420 7769 e be enclosed wi │ │ │ │ │ +00004f40: 7468 2027 2827 0a61 6e64 2027 2927 2e20 th '('.and ')'. │ │ │ │ │ +00004f50: 2054 6865 2027 6664 2720 7061 7274 206d The 'fd' part m │ │ │ │ │ +00004f60: 6561 6e73 2074 6861 7420 6974 2069 7320 eans that it is │ │ │ │ │ +00004f70: 6120 666c 6f70 7079 2064 6973 6b2e 2020 a floppy disk. │ │ │ │ │ +00004f80: 5468 6520 6e75 6d62 6572 2027 3027 0a69 The number '0'.i │ │ │ │ │ +00004f90: 7320 7468 6520 6472 6976 6520 6e75 6d62 s the drive numb │ │ │ │ │ +00004fa0: 6572 2c20 7768 6963 6820 6973 2063 6f75 er, which is cou │ │ │ │ │ +00004fb0: 6e74 6564 2066 726f 6d20 5f7a 6572 6f5f nted from _zero_ │ │ │ │ │ +00004fc0: 2e20 2054 6869 7320 6578 7072 6573 7369 . This expressi │ │ │ │ │ +00004fd0: 6f6e 0a6d 6561 6e73 2074 6861 7420 4752 on.means that GR │ │ │ │ │ +00004fe0: 5542 2077 696c 6c20 7573 6520 7468 6520 UB will use the │ │ │ │ │ +00004ff0: 7768 6f6c 6520 666c 6f70 7079 2064 6973 whole floppy dis │ │ │ │ │ +00005000: 6b2e 0a0a 2020 2020 2028 6864 302c 6d73 k... (hd0,ms │ │ │ │ │ +00005010: 646f 7332 290a 0a20 2020 4865 7265 2c20 dos2).. Here, │ │ │ │ │ +00005020: 2768 6427 206d 6561 6e73 2069 7420 6973 'hd' means it is │ │ │ │ │ +00005030: 2061 2068 6172 6420 6469 736b 2064 7269 a hard disk dri │ │ │ │ │ +00005040: 7665 2e20 2054 6865 2066 6972 7374 2069 ve. The first i │ │ │ │ │ +00005050: 6e74 6567 6572 2027 3027 0a69 6e64 6963 nteger '0'.indic │ │ │ │ │ +00005060: 6174 6573 2074 6865 2064 7269 7665 206e ates the drive n │ │ │ │ │ +00005070: 756d 6265 722c 2074 6861 7420 6973 2c20 umber, that is, │ │ │ │ │ +00005080: 7468 6520 6669 7273 7420 6861 7264 2064 the first hard d │ │ │ │ │ +00005090: 6973 6b2c 2074 6865 2073 7472 696e 670a isk, the string. │ │ │ │ │ +000050a0: 276d 7364 6f73 2720 696e 6469 6361 7465 'msdos' indicate │ │ │ │ │ +000050b0: 7320 7468 6520 7061 7274 6974 696f 6e20 s the partition │ │ │ │ │ +000050c0: 7363 6865 6d65 2c20 7768 696c 6520 7468 scheme, while th │ │ │ │ │ +000050d0: 6520 7365 636f 6e64 2069 6e74 6567 6572 e second integer │ │ │ │ │ +000050e0: 2c20 2732 272c 0a69 6e64 6963 6174 6573 , '2',.indicates │ │ │ │ │ +000050f0: 2074 6865 2070 6172 7469 7469 6f6e 206e the partition n │ │ │ │ │ +00005100: 756d 6265 7220 286f 7220 7468 6520 5043 umber (or the PC │ │ │ │ │ +00005110: 2073 6c69 6365 206e 756d 6265 7220 696e slice number in │ │ │ │ │ +00005120: 2074 6865 2042 5344 0a74 6572 6d69 6e6f the BSD.termino │ │ │ │ │ +00005130: 6c6f 6779 292e 2020 5468 6520 7061 7274 logy). The part │ │ │ │ │ +00005140: 6974 696f 6e20 6e75 6d62 6572 7320 6172 ition numbers ar │ │ │ │ │ +00005150: 6520 636f 756e 7465 6420 6672 6f6d 205f e counted from _ │ │ │ │ │ +00005160: 6f6e 655f 2c20 6e6f 7420 6672 6f6d 0a7a one_, not from.z │ │ │ │ │ +00005170: 6572 6f20 2861 7320 7761 7320 7468 6520 ero (as was the │ │ │ │ │ +00005180: 6361 7365 2069 6e20 7072 6576 696f 7573 case in previous │ │ │ │ │ +00005190: 2076 6572 7369 6f6e 7320 6f66 2047 5255 versions of GRU │ │ │ │ │ +000051a0: 4229 2e20 5468 6973 2065 7870 7265 7373 B). This express │ │ │ │ │ +000051b0: 696f 6e0a 6d65 616e 7320 7468 6520 7365 ion.means the se │ │ │ │ │ +000051c0: 636f 6e64 2070 6172 7469 7469 6f6e 206f cond partition o │ │ │ │ │ +000051d0: 6620 7468 6520 6669 7273 7420 6861 7264 f the first hard │ │ │ │ │ +000051e0: 2064 6973 6b20 6472 6976 652e 2020 496e disk drive. In │ │ │ │ │ +000051f0: 2074 6869 7320 6361 7365 2c0a 4752 5542 this case,.GRUB │ │ │ │ │ +00005200: 2075 7365 7320 6f6e 6520 7061 7274 6974 uses one partit │ │ │ │ │ +00005210: 696f 6e20 6f66 2074 6865 2064 6973 6b2c ion of the disk, │ │ │ │ │ +00005220: 2069 6e73 7465 6164 206f 6620 7468 6520 instead of the │ │ │ │ │ +00005230: 7768 6f6c 6520 6469 736b 2e0a 0a20 2020 whole disk... │ │ │ │ │ +00005240: 2020 2868 6430 2c6d 7364 6f73 3529 0a0a (hd0,msdos5).. │ │ │ │ │ +00005250: 2020 2054 6869 7320 7370 6563 6966 6965 This specifie │ │ │ │ │ +00005260: 7320 7468 6520 6669 7273 7420 2265 7874 s the first "ext │ │ │ │ │ +00005270: 656e 6465 6420 7061 7274 6974 696f 6e22 ended partition" │ │ │ │ │ +00005280: 206f 6620 7468 6520 6669 7273 7420 6861 of the first ha │ │ │ │ │ +00005290: 7264 2064 6973 6b0a 6472 6976 652e 2020 rd disk.drive. │ │ │ │ │ +000052a0: 4e6f 7465 2074 6861 7420 7468 6520 7061 Note that the pa │ │ │ │ │ +000052b0: 7274 6974 696f 6e20 6e75 6d62 6572 7320 rtition numbers │ │ │ │ │ +000052c0: 666f 7220 6578 7465 6e64 6564 2070 6172 for extended par │ │ │ │ │ +000052d0: 7469 7469 6f6e 7320 6172 650a 636f 756e titions are.coun │ │ │ │ │ +000052e0: 7465 6420 6672 6f6d 2027 3527 2c20 7265 ted from '5', re │ │ │ │ │ +000052f0: 6761 7264 6c65 7373 206f 6620 7468 6520 gardless of the │ │ │ │ │ +00005300: 6163 7475 616c 206e 756d 6265 7220 6f66 actual number of │ │ │ │ │ +00005310: 2070 7269 6d61 7279 2070 6172 7469 7469 primary partiti │ │ │ │ │ +00005320: 6f6e 730a 6f6e 2079 6f75 7220 6861 7264 ons.on your hard │ │ │ │ │ +00005330: 2064 6973 6b2e 0a0a 2020 2020 2028 6864 disk... (hd │ │ │ │ │ +00005340: 312c 6d73 646f 7331 2c62 7364 3129 0a0a 1,msdos1,bsd1).. │ │ │ │ │ +00005350: 2020 2054 6869 7320 6d65 616e 7320 7468 This means th │ │ │ │ │ +00005360: 6520 4253 4420 2761 2720 7061 7274 6974 e BSD 'a' partit │ │ │ │ │ +00005370: 696f 6e20 6f6e 2066 6972 7374 2050 4320 ion on first PC │ │ │ │ │ +00005380: 736c 6963 6520 6e75 6d62 6572 206f 6620 slice number of │ │ │ │ │ +00005390: 7468 650a 7365 636f 6e64 2068 6172 6420 the.second hard │ │ │ │ │ +000053a0: 6469 736b 2e0a 0a20 2020 4f66 2063 6f75 disk... Of cou │ │ │ │ │ +000053b0: 7273 652c 2074 6f20 6163 7475 616c 6c79 rse, to actually │ │ │ │ │ +000053c0: 2061 6363 6573 7320 7468 6520 6469 736b access the disk │ │ │ │ │ +000053d0: 7320 6f72 2070 6172 7469 7469 6f6e 7320 s or partitions │ │ │ │ │ +000053e0: 7769 7468 2047 5255 422c 2079 6f75 0a6e with GRUB, you.n │ │ │ │ │ +000053f0: 6565 6420 746f 2075 7365 2074 6865 2064 eed to use the d │ │ │ │ │ +00005400: 6576 6963 6520 7370 6563 6966 6963 6174 evice specificat │ │ │ │ │ +00005410: 696f 6e20 696e 2061 2063 6f6d 6d61 6e64 ion in a command │ │ │ │ │ +00005420: 2c20 6c69 6b65 2027 7365 7420 726f 6f74 , like 'set root │ │ │ │ │ +00005430: 3d28 6664 3029 270a 6f72 2027 7061 7274 =(fd0)'.or 'part │ │ │ │ │ +00005440: 746f 6f6c 2028 6864 302c 6d73 646f 7333 tool (hd0,msdos3 │ │ │ │ │ +00005450: 2920 6869 6464 656e 2d27 2e20 2054 6f20 ) hidden-'. To │ │ │ │ │ +00005460: 6865 6c70 2079 6f75 2066 696e 6420 6f75 help you find ou │ │ │ │ │ +00005470: 7420 7768 6963 6820 6e75 6d62 6572 0a73 t which number.s │ │ │ │ │ +00005480: 7065 6369 6669 6573 2061 2070 6172 7469 pecifies a parti │ │ │ │ │ +00005490: 7469 6f6e 2079 6f75 2077 616e 742c 2074 tion you want, t │ │ │ │ │ +000054a0: 6865 2047 5255 4220 636f 6d6d 616e 642d he GRUB command- │ │ │ │ │ +000054b0: 6c69 6e65 2028 2a6e 6f74 650a 436f 6d6d line (*note.Comm │ │ │ │ │ +000054c0: 616e 642d 6c69 6e65 2069 6e74 6572 6661 and-line interfa │ │ │ │ │ +000054d0: 6365 3a3a 2920 6f70 7469 6f6e 7320 6861 ce::) options ha │ │ │ │ │ +000054e0: 7665 2061 7267 756d 656e 7420 636f 6d70 ve argument comp │ │ │ │ │ +000054f0: 6c65 7469 6f6e 2e20 2054 6869 7320 6d65 letion. This me │ │ │ │ │ +00005500: 616e 730a 7468 6174 2c20 666f 7220 6578 ans.that, for ex │ │ │ │ │ +00005510: 616d 706c 652c 2079 6f75 206f 6e6c 7920 ample, you only │ │ │ │ │ +00005520: 6e65 6564 2074 6f20 7479 7065 0a0a 2020 need to type.. │ │ │ │ │ +00005530: 2020 2073 6574 2072 6f6f 743d 280a 0a20 set root=(.. │ │ │ │ │ +00005540: 2020 666f 6c6c 6f77 6564 2062 7920 6120 followed by a │ │ │ │ │ +00005550: 3c54 4142 3e2c 2061 6e64 2047 5255 4220 , and GRUB │ │ │ │ │ +00005560: 7769 6c6c 2064 6973 706c 6179 2074 6865 will display the │ │ │ │ │ +00005570: 206c 6973 7420 6f66 2064 7269 7665 732c list of drives, │ │ │ │ │ +00005580: 0a70 6172 7469 7469 6f6e 732c 206f 7220 .partitions, or │ │ │ │ │ +00005590: 6669 6c65 206e 616d 6573 2e20 2053 6f20 file names. So │ │ │ │ │ +000055a0: 6974 2073 686f 756c 6420 6265 2071 7569 it should be qui │ │ │ │ │ +000055b0: 7465 2065 6173 7920 746f 2064 6574 6572 te easy to deter │ │ │ │ │ +000055c0: 6d69 6e65 2074 6865 0a6e 616d 6520 6f66 mine the.name of │ │ │ │ │ +000055d0: 2079 6f75 7220 7461 7267 6574 2070 6172 your target par │ │ │ │ │ +000055e0: 7469 7469 6f6e 2c20 6576 656e 2077 6974 tition, even wit │ │ │ │ │ +000055f0: 6820 6d69 6e69 6d61 6c20 6b6e 6f77 6c65 h minimal knowle │ │ │ │ │ +00005600: 6467 6520 6f66 2074 6865 0a73 796e 7461 dge of the.synta │ │ │ │ │ +00005610: 782e 0a0a 2020 204e 6f74 6520 7468 6174 x... Note that │ │ │ │ │ +00005620: 2047 5255 4220 646f 6573 205f 6e6f 745f GRUB does _not_ │ │ │ │ │ +00005630: 2064 6973 7469 6e67 7569 7368 2049 4445 distinguish IDE │ │ │ │ │ +00005640: 2066 726f 6d20 5343 5349 202d 2069 7420 from SCSI - it │ │ │ │ │ +00005650: 7369 6d70 6c79 0a63 6f75 6e74 7320 7468 simply.counts th │ │ │ │ │ +00005660: 6520 6472 6976 6520 6e75 6d62 6572 7320 e drive numbers │ │ │ │ │ +00005670: 6672 6f6d 207a 6572 6f2c 2072 6567 6172 from zero, regar │ │ │ │ │ +00005680: 646c 6573 7320 6f66 2074 6865 6972 2074 dless of their t │ │ │ │ │ +00005690: 7970 652e 2020 4e6f 726d 616c 6c79 2c0a ype. Normally,. │ │ │ │ │ +000056a0: 616e 7920 4944 4520 6472 6976 6520 6e75 any IDE drive nu │ │ │ │ │ +000056b0: 6d62 6572 2069 7320 6c65 7373 2074 6861 mber is less tha │ │ │ │ │ +000056c0: 6e20 616e 7920 5343 5349 2064 7269 7665 n any SCSI drive │ │ │ │ │ +000056d0: 206e 756d 6265 722c 2061 6c74 686f 7567 number, althoug │ │ │ │ │ +000056e0: 6820 7468 6174 0a69 7320 6e6f 7420 7472 h that.is not tr │ │ │ │ │ +000056f0: 7565 2069 6620 796f 7520 6368 616e 6765 ue if you change │ │ │ │ │ +00005700: 2074 6865 2062 6f6f 7420 7365 7175 656e the boot sequen │ │ │ │ │ +00005710: 6365 2062 7920 7377 6170 7069 6e67 2049 ce by swapping I │ │ │ │ │ +00005720: 4445 2061 6e64 2053 4353 490a 6472 6976 DE and SCSI.driv │ │ │ │ │ +00005730: 6573 2069 6e20 796f 7572 2042 494f 532e es in your BIOS. │ │ │ │ │ +00005740: 0a0a 2020 204e 6f77 2074 6865 2071 7565 .. Now the que │ │ │ │ │ +00005750: 7374 696f 6e20 6973 2c20 686f 7720 746f stion is, how to │ │ │ │ │ +00005760: 2073 7065 6369 6679 2061 2066 696c 653f specify a file? │ │ │ │ │ +00005770: 2020 4167 6169 6e2c 2063 6f6e 7369 6465 Again, conside │ │ │ │ │ +00005780: 7220 616e 0a65 7861 6d70 6c65 3a0a 0a20 r an.example:.. │ │ │ │ │ +00005790: 2020 2020 2868 6430 2c6d 7364 6f73 3129 (hd0,msdos1) │ │ │ │ │ +000057a0: 2f76 6d6c 696e 757a 0a0a 2020 2054 6869 /vmlinuz.. Thi │ │ │ │ │ +000057b0: 7320 7370 6563 6966 6965 7320 7468 6520 s specifies the │ │ │ │ │ +000057c0: 6669 6c65 206e 616d 6564 2027 766d 6c69 file named 'vmli │ │ │ │ │ +000057d0: 6e75 7a27 2c20 666f 756e 6420 6f6e 2074 nuz', found on t │ │ │ │ │ +000057e0: 6865 2066 6972 7374 2070 6172 7469 7469 he first partiti │ │ │ │ │ +000057f0: 6f6e 0a6f 6620 7468 6520 6669 7273 7420 on.of the first │ │ │ │ │ +00005800: 6861 7264 2064 6973 6b20 6472 6976 652e hard disk drive. │ │ │ │ │ +00005810: 2020 4e6f 7465 2074 6861 7420 7468 6520 Note that the │ │ │ │ │ +00005820: 6172 6775 6d65 6e74 2063 6f6d 706c 6574 argument complet │ │ │ │ │ +00005830: 696f 6e20 776f 726b 730a 7769 7468 2066 ion works.with f │ │ │ │ │ +00005840: 696c 6520 6e61 6d65 732c 2074 6f6f 2e0a ile names, too.. │ │ │ │ │ +00005850: 0a20 2020 5468 6174 2077 6173 2065 6173 . That was eas │ │ │ │ │ +00005860: 792c 2061 646d 6974 2069 742e 2020 4e6f y, admit it. No │ │ │ │ │ +00005870: 7720 7265 6164 2074 6865 206e 6578 7420 w read the next │ │ │ │ │ +00005880: 6368 6170 7465 722c 2074 6f20 6669 6e64 chapter, to find │ │ │ │ │ +00005890: 206f 7574 2068 6f77 0a74 6f20 6163 7475 out how.to actu │ │ │ │ │ +000058a0: 616c 6c79 2069 6e73 7461 6c6c 2047 5255 ally install GRU │ │ │ │ │ +000058b0: 4220 6f6e 2079 6f75 7220 6472 6976 652e B on your drive. │ │ │ │ │ +000058c0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +000058d0: 6e66 6f2c 2020 4e6f 6465 3a20 4f53 2d73 nfo, Node: OS-s │ │ │ │ │ +000058e0: 7065 6369 6669 6320 6e6f 7465 7320 6162 pecific notes ab │ │ │ │ │ +000058f0: 6f75 7420 6772 7562 2074 6f6f 6c73 2c20 out grub tools, │ │ │ │ │ +00005900: 204e 6578 743a 2049 6e73 7461 6c6c 6174 Next: Installat │ │ │ │ │ +00005910: 696f 6e2c 2020 5072 6576 3a20 4e61 6d69 ion, Prev: Nami │ │ │ │ │ +00005920: 6e67 2063 6f6e 7665 6e74 696f 6e2c 2020 ng convention, │ │ │ │ │ +00005930: 5570 3a20 546f 700a 0a33 204f 532d 7370 Up: Top..3 OS-sp │ │ │ │ │ +00005940: 6563 6966 6963 206e 6f74 6573 2061 626f ecific notes abo │ │ │ │ │ +00005950: 7574 2067 7275 6220 746f 6f6c 730a 2a2a ut grub tools.** │ │ │ │ │ 00005960: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ 00005970: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00005980: 0a0a 4f6e 204f 5320 7768 6963 6820 6861 ..On OS which ha │ │ │ │ │ -00005990: 7665 2064 6576 6963 6520 6e6f 6465 7320 ve device nodes │ │ │ │ │ -000059a0: 7369 6d69 6c61 7220 746f 2055 6e69 782d similar to Unix- │ │ │ │ │ -000059b0: 6c69 6b65 204f 5320 4752 5542 2074 6f6f like OS GRUB too │ │ │ │ │ -000059c0: 6c73 2075 7365 2074 6865 0a4f 5320 6e61 ls use the.OS na │ │ │ │ │ -000059d0: 6d65 2e20 2045 2e67 2e20 2066 6f72 2047 me. E.g. for G │ │ │ │ │ -000059e0: 4e55 2f4c 696e 7578 3a0a 0a20 2020 2020 NU/Linux:.. │ │ │ │ │ -000059f0: 2320 6772 7562 2d69 6e73 7461 6c6c 202f # grub-install / │ │ │ │ │ -00005a00: 6465 762f 7364 610a 0a20 2020 4f6e 2041 dev/sda.. On A │ │ │ │ │ -00005a10: 524f 5320 7765 2075 7365 2061 6e6f 7468 ROS we use anoth │ │ │ │ │ -00005a20: 6572 2073 796e 7461 782e 2020 466f 7220 er syntax. For │ │ │ │ │ -00005a30: 766f 6c75 6d65 733a 0a0a 2020 2020 202f volumes:.. / │ │ │ │ │ -00005a40: 2f3a 3c76 6f6c 756d 6520 6e61 6d65 3e0a /:. │ │ │ │ │ -00005a50: 0a20 2020 452e 672e 0a0a 2020 2020 202f . E.g... / │ │ │ │ │ -00005a60: 2f3a 4448 300a 0a20 2020 466f 7220 6469 /:DH0.. For di │ │ │ │ │ -00005a70: 736b 7320 7765 2075 7365 2073 796e 7461 sks we use synta │ │ │ │ │ -00005a80: 783a 0a20 2020 2020 2f2f 3a3c 6472 6976 x:. //:/unit/fl │ │ │ │ │ -00005aa0: 6167 730a 0a20 2020 452e 672e 0a0a 2020 ags.. E.g... │ │ │ │ │ -00005ab0: 2020 2023 2067 7275 622d 696e 7374 616c # grub-instal │ │ │ │ │ -00005ac0: 6c20 2f2f 3a61 7461 2e64 6576 6963 652f l //:ata.device/ │ │ │ │ │ -00005ad0: 302f 300a 0a20 2020 4f6e 2057 696e 646f 0/0.. On Windo │ │ │ │ │ -00005ae0: 7773 2077 6520 7573 6520 554e 4320 7061 ws we use UNC pa │ │ │ │ │ -00005af0: 7468 2e20 2046 6f72 2076 6f6c 756d 6573 th. For volumes │ │ │ │ │ -00005b00: 2069 7427 7320 7479 7069 6361 6c6c 790a it's typically. │ │ │ │ │ -00005b10: 0a20 2020 2020 5c5c 3f5c 566f 6c75 6d65 . \\?\Volume │ │ │ │ │ -00005b20: 7b3c 4755 4944 3e7d 0a20 2020 2020 5c5c {}. \\ │ │ │ │ │ -00005b30: 3f5c 3c64 7269 7665 206c 6574 7465 723e ?\ │ │ │ │ │ -00005b40: 3a0a 0a20 2020 452e 672e 0a0a 2020 2020 :.. E.g... │ │ │ │ │ -00005b50: 205c 5c3f 5c56 6f6c 756d 657b 3137 6633 \\?\Volume{17f3 │ │ │ │ │ -00005b60: 3464 3530 2d63 6636 342d 3462 3032 2d38 4d50-cf64-4b02-8 │ │ │ │ │ -00005b70: 3030 652d 3531 6437 3963 3361 6132 6666 00e-51d79c3aa2ff │ │ │ │ │ -00005b80: 7d0a 2020 2020 205c 5c3f 5c43 3a0a 0a20 }. \\?\C:.. │ │ │ │ │ -00005b90: 2020 466f 7220 6469 736b 7320 6974 2773 For disks it's │ │ │ │ │ -00005ba0: 0a0a 2020 2020 205c 5c3f 5c50 6879 7369 .. \\?\Physi │ │ │ │ │ -00005bb0: 6361 6c44 7269 7665 3c6e 756d 6265 723e calDrive │ │ │ │ │ -00005bc0: 0a0a 2020 2045 2e67 2e0a 0a20 2020 2020 .. E.g... │ │ │ │ │ -00005bd0: 2320 6772 7562 2d69 6e73 7461 6c6c 205c # grub-install \ │ │ │ │ │ -00005be0: 5c3f 5c50 6879 7369 6361 6c44 7269 7665 \?\PhysicalDrive │ │ │ │ │ -00005bf0: 300a 0a20 2020 4265 7761 7265 2074 6861 0.. Beware tha │ │ │ │ │ -00005c00: 7420 796f 7520 6d61 7920 6e65 6564 2074 t you may need t │ │ │ │ │ -00005c10: 6f20 6675 7274 6865 7220 6573 6361 7065 o further escape │ │ │ │ │ -00005c20: 2074 6865 2062 6163 6b73 6c61 7368 6573 the backslashes │ │ │ │ │ -00005c30: 2064 6570 656e 6469 6e67 0a6f 6e20 796f depending.on yo │ │ │ │ │ -00005c40: 7572 2073 6865 6c6c 2e0a 0a20 2020 5768 ur shell... Wh │ │ │ │ │ -00005c50: 656e 2063 6f6d 7069 6c65 6420 7769 7468 en compiled with │ │ │ │ │ -00005c60: 2063 7967 7769 6e20 7375 7070 6f72 7420 cygwin support │ │ │ │ │ -00005c70: 7468 656e 2063 7967 7769 6e20 6472 6976 then cygwin driv │ │ │ │ │ -00005c80: 6520 6e61 6d65 7320 6172 650a 6175 746f e names are.auto │ │ │ │ │ -00005c90: 6d61 7469 6361 6c6c 7920 7768 656e 206e matically when n │ │ │ │ │ -00005ca0: 6565 6465 642e 2020 452e 672e 0a0a 2020 eeded. E.g... │ │ │ │ │ -00005cb0: 2020 2023 2067 7275 622d 696e 7374 616c # grub-instal │ │ │ │ │ -00005cc0: 6c20 2f64 6576 2f73 6461 0a0a 1f0a 4669 l /dev/sda....Fi │ │ │ │ │ -00005cd0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00005ce0: 4e6f 6465 3a20 496e 7374 616c 6c61 7469 Node: Installati │ │ │ │ │ -00005cf0: 6f6e 2c20 204e 6578 743a 2042 6f6f 7469 on, Next: Booti │ │ │ │ │ -00005d00: 6e67 2c20 2050 7265 763a 204f 532d 7370 ng, Prev: OS-sp │ │ │ │ │ -00005d10: 6563 6966 6963 206e 6f74 6573 2061 626f ecific notes abo │ │ │ │ │ -00005d20: 7574 2067 7275 6220 746f 6f6c 732c 2020 ut grub tools, │ │ │ │ │ -00005d30: 5570 3a20 546f 700a 0a34 2049 6e73 7461 Up: Top..4 Insta │ │ │ │ │ -00005d40: 6c6c 6174 696f 6e0a 2a2a 2a2a 2a2a 2a2a llation.******** │ │ │ │ │ -00005d50: 2a2a 2a2a 2a2a 0a0a 496e 206f 7264 6572 ******..In order │ │ │ │ │ -00005d60: 2074 6f20 696e 7374 616c 6c20 4752 5542 to install GRUB │ │ │ │ │ -00005d70: 2061 7320 796f 7572 2062 6f6f 7420 6c6f as your boot lo │ │ │ │ │ -00005d80: 6164 6572 2c20 796f 7520 6e65 6564 2074 ader, you need t │ │ │ │ │ -00005d90: 6f20 6669 7273 7420 696e 7374 616c 6c0a o first install. │ │ │ │ │ -00005da0: 7468 6520 4752 5542 2073 7973 7465 6d20 the GRUB system │ │ │ │ │ -00005db0: 616e 6420 7574 696c 6974 6965 7320 756e and utilities un │ │ │ │ │ -00005dc0: 6465 7220 796f 7572 2055 4e49 582d 6c69 der your UNIX-li │ │ │ │ │ -00005dd0: 6b65 206f 7065 7261 7469 6e67 2073 7973 ke operating sys │ │ │ │ │ -00005de0: 7465 6d0a 282a 6e6f 7465 204f 6274 6169 tem.(*note Obtai │ │ │ │ │ -00005df0: 6e69 6e67 2061 6e64 2042 7569 6c64 696e ning and Buildin │ │ │ │ │ -00005e00: 6720 4752 5542 3a3a 292e 2020 596f 7520 g GRUB::). You │ │ │ │ │ -00005e10: 6361 6e20 646f 2074 6869 7320 6569 7468 can do this eith │ │ │ │ │ -00005e20: 6572 2066 726f 6d20 7468 650a 736f 7572 er from the.sour │ │ │ │ │ -00005e30: 6365 2074 6172 6261 6c6c 2c20 6f72 2061 ce tarball, or a │ │ │ │ │ -00005e40: 7320 6120 7061 636b 6167 6520 666f 7220 s a package for │ │ │ │ │ -00005e50: 796f 7572 204f 532e 0a0a 2020 2041 6674 your OS... Aft │ │ │ │ │ -00005e60: 6572 2079 6f75 2068 6176 6520 646f 6e65 er you have done │ │ │ │ │ -00005e70: 2074 6861 742c 2079 6f75 206e 6565 6420 that, you need │ │ │ │ │ -00005e80: 746f 2069 6e73 7461 6c6c 2074 6865 2062 to install the b │ │ │ │ │ -00005e90: 6f6f 7420 6c6f 6164 6572 206f 6e20 610a oot loader on a. │ │ │ │ │ -00005ea0: 6472 6976 6520 2866 6c6f 7070 7920 6f72 drive (floppy or │ │ │ │ │ -00005eb0: 2068 6172 6420 6469 736b 2920 6279 2075 hard disk) by u │ │ │ │ │ -00005ec0: 7369 6e67 2074 6865 2075 7469 6c69 7479 sing the utility │ │ │ │ │ -00005ed0: 2027 6772 7562 2d69 6e73 7461 6c6c 2720 'grub-install' │ │ │ │ │ -00005ee0: 282a 6e6f 7465 0a49 6e76 6f6b 696e 6720 (*note.Invoking │ │ │ │ │ -00005ef0: 6772 7562 2d69 6e73 7461 6c6c 3a3a 2920 grub-install::) │ │ │ │ │ -00005f00: 6f6e 2061 2055 4e49 582d 6c69 6b65 204f on a UNIX-like O │ │ │ │ │ -00005f10: 532e 0a0a 2020 2047 5255 4220 636f 6d65 S... GRUB come │ │ │ │ │ -00005f20: 7320 7769 7468 2062 6f6f 7420 696d 6167 s with boot imag │ │ │ │ │ -00005f30: 6573 2c20 7768 6963 6820 6172 6520 6e6f es, which are no │ │ │ │ │ -00005f40: 726d 616c 6c79 2070 7574 2069 6e20 7468 rmally put in th │ │ │ │ │ -00005f50: 6520 6469 7265 6374 6f72 790a 272f 7573 e directory.'/us │ │ │ │ │ -00005f60: 722f 6c69 622f 6772 7562 2f3c 6370 753e r/lib/grub/ │ │ │ │ │ -00005f70: 2d3c 706c 6174 666f 726d 3e27 2028 666f -' (fo │ │ │ │ │ -00005f80: 7220 4249 4f53 2d62 6173 6564 206d 6163 r BIOS-based mac │ │ │ │ │ -00005f90: 6869 6e65 730a 272f 7573 722f 6c69 622f hines.'/usr/lib/ │ │ │ │ │ -00005fa0: 6772 7562 2f69 3338 362d 7063 2729 2e20 grub/i386-pc'). │ │ │ │ │ -00005fb0: 2048 6572 6561 6674 6572 2c20 7468 6520 Hereafter, the │ │ │ │ │ -00005fc0: 6469 7265 6374 6f72 7920 7768 6572 6520 directory where │ │ │ │ │ -00005fd0: 4752 5542 2069 6d61 6765 730a 6172 6520 GRUB images.are │ │ │ │ │ -00005fe0: 696e 6974 6961 6c6c 7920 706c 6163 6564 initially placed │ │ │ │ │ -00005ff0: 2028 6e6f 726d 616c 6c79 2027 2f75 7372 (normally '/usr │ │ │ │ │ -00006000: 2f6c 6962 2f67 7275 622f 3c63 7075 3e2d /lib/grub/- │ │ │ │ │ -00006010: 3c70 6c61 7466 6f72 6d3e 2729 2077 696c ') wil │ │ │ │ │ -00006020: 6c20 6265 0a63 616c 6c65 6420 7468 6520 l be.called the │ │ │ │ │ -00006030: 2269 6d61 6765 2064 6972 6563 746f 7279 "image directory │ │ │ │ │ -00006040: 222c 2061 6e64 2074 6865 2064 6972 6563 ", and the direc │ │ │ │ │ -00006050: 746f 7279 2077 6865 7265 2074 6865 2062 tory where the b │ │ │ │ │ -00006060: 6f6f 7420 6c6f 6164 6572 0a6e 6565 6473 oot loader.needs │ │ │ │ │ -00006070: 2074 6f20 6669 6e64 2074 6865 6d20 2875 to find them (u │ │ │ │ │ -00006080: 7375 616c 6c79 2027 2f62 6f6f 7427 2920 sually '/boot') │ │ │ │ │ -00006090: 7769 6c6c 2062 6520 6361 6c6c 6564 2074 will be called t │ │ │ │ │ -000060a0: 6865 2022 626f 6f74 0a64 6972 6563 746f he "boot.directo │ │ │ │ │ -000060b0: 7279 222e 0a0a 2a20 4d65 6e75 3a0a 0a2a ry"...* Menu:..* │ │ │ │ │ -000060c0: 2049 6e73 7461 6c6c 696e 6720 4752 5542 Installing GRUB │ │ │ │ │ -000060d0: 2075 7369 6e67 2067 7275 622d 696e 7374 using grub-inst │ │ │ │ │ -000060e0: 616c 6c3a 3a0a 2a20 4d61 6b69 6e67 2061 all::.* Making a │ │ │ │ │ -000060f0: 2047 5255 4220 626f 6f74 6162 6c65 2043 GRUB bootable C │ │ │ │ │ -00006100: 442d 524f 4d3a 3a0a 2a20 4465 7669 6365 D-ROM::.* Device │ │ │ │ │ -00006110: 206d 6170 3a3a 0a2a 2042 494f 5320 696e map::.* BIOS in │ │ │ │ │ -00006120: 7374 616c 6c61 7469 6f6e 3a3a 0a0a 1f0a stallation::.... │ │ │ │ │ -00006130: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -00006140: 2020 4e6f 6465 3a20 496e 7374 616c 6c69 Node: Installi │ │ │ │ │ -00006150: 6e67 2047 5255 4220 7573 696e 6720 6772 ng GRUB using gr │ │ │ │ │ -00006160: 7562 2d69 6e73 7461 6c6c 2c20 204e 6578 ub-install, Nex │ │ │ │ │ -00006170: 743a 204d 616b 696e 6720 6120 4752 5542 t: Making a GRUB │ │ │ │ │ -00006180: 2062 6f6f 7461 626c 6520 4344 2d52 4f4d bootable CD-ROM │ │ │ │ │ -00006190: 2c20 2055 703a 2049 6e73 7461 6c6c 6174 , Up: Installat │ │ │ │ │ -000061a0: 696f 6e0a 0a34 2e31 2049 6e73 7461 6c6c ion..4.1 Install │ │ │ │ │ -000061b0: 696e 6720 4752 5542 2075 7369 6e67 2067 ing GRUB using g │ │ │ │ │ -000061c0: 7275 622d 696e 7374 616c 6c0a 3d3d 3d3d rub-install.==== │ │ │ │ │ +00005980: 2a2a 0a0a 4f6e 204f 5320 7768 6963 6820 **..On OS which │ │ │ │ │ +00005990: 6861 7665 2064 6576 6963 6520 6e6f 6465 have device node │ │ │ │ │ +000059a0: 7320 7369 6d69 6c61 7220 746f 2055 6e69 s similar to Uni │ │ │ │ │ +000059b0: 782d 6c69 6b65 204f 5320 4752 5542 2074 x-like OS GRUB t │ │ │ │ │ +000059c0: 6f6f 6c73 2075 7365 2074 6865 0a4f 5320 ools use the.OS │ │ │ │ │ +000059d0: 6e61 6d65 2e20 2045 2e67 2e20 2066 6f72 name. E.g. for │ │ │ │ │ +000059e0: 2047 4e55 2f4c 696e 7578 3a0a 0a20 2020 GNU/Linux:.. │ │ │ │ │ +000059f0: 2020 2320 6772 7562 2d69 6e73 7461 6c6c # grub-install │ │ │ │ │ +00005a00: 202f 6465 762f 7364 610a 0a20 2020 4f6e /dev/sda.. On │ │ │ │ │ +00005a10: 2041 524f 5320 7765 2075 7365 2061 6e6f AROS we use ano │ │ │ │ │ +00005a20: 7468 6572 2073 796e 7461 782e 2020 466f ther syntax. Fo │ │ │ │ │ +00005a30: 7220 766f 6c75 6d65 733a 0a0a 2020 2020 r volumes:.. │ │ │ │ │ +00005a40: 202f 2f3a 3c76 6f6c 756d 6520 6e61 6d65 //:.. E.g... │ │ │ │ │ +00005a60: 202f 2f3a 4448 300a 0a20 2020 466f 7220 //:DH0.. For │ │ │ │ │ +00005a70: 6469 736b 7320 7765 2075 7365 2073 796e disks we use syn │ │ │ │ │ +00005a80: 7461 783a 0a20 2020 2020 2f2f 3a3c 6472 tax:. //:/unit/ │ │ │ │ │ +00005aa0: 666c 6167 730a 0a20 2020 452e 672e 0a0a flags.. E.g... │ │ │ │ │ +00005ab0: 2020 2020 2023 2067 7275 622d 696e 7374 # grub-inst │ │ │ │ │ +00005ac0: 616c 6c20 2f2f 3a61 7461 2e64 6576 6963 all //:ata.devic │ │ │ │ │ +00005ad0: 652f 302f 300a 0a20 2020 4f6e 2057 696e e/0/0.. On Win │ │ │ │ │ +00005ae0: 646f 7773 2077 6520 7573 6520 554e 4320 dows we use UNC │ │ │ │ │ +00005af0: 7061 7468 2e20 2046 6f72 2076 6f6c 756d path. For volum │ │ │ │ │ +00005b00: 6573 2069 7427 7320 7479 7069 6361 6c6c es it's typicall │ │ │ │ │ +00005b10: 790a 0a20 2020 2020 5c5c 3f5c 566f 6c75 y.. \\?\Volu │ │ │ │ │ +00005b20: 6d65 7b3c 4755 4944 3e7d 0a20 2020 2020 me{}. │ │ │ │ │ +00005b30: 5c5c 3f5c 3c64 7269 7665 206c 6574 7465 \\?\:.. E.g... │ │ │ │ │ +00005b50: 2020 205c 5c3f 5c56 6f6c 756d 657b 3137 \\?\Volume{17 │ │ │ │ │ +00005b60: 6633 3464 3530 2d63 6636 342d 3462 3032 f34d50-cf64-4b02 │ │ │ │ │ +00005b70: 2d38 3030 652d 3531 6437 3963 3361 6132 -800e-51d79c3aa2 │ │ │ │ │ +00005b80: 6666 7d0a 2020 2020 205c 5c3f 5c43 3a0a ff}. \\?\C:. │ │ │ │ │ +00005b90: 0a20 2020 466f 7220 6469 736b 7320 6974 . For disks it │ │ │ │ │ +00005ba0: 2773 0a0a 2020 2020 205c 5c3f 5c50 6879 's.. \\?\Phy │ │ │ │ │ +00005bb0: 7369 6361 6c44 7269 7665 3c6e 756d 6265 sicalDrive.. E.g... │ │ │ │ │ +00005bd0: 2020 2320 6772 7562 2d69 6e73 7461 6c6c # grub-install │ │ │ │ │ +00005be0: 205c 5c3f 5c50 6879 7369 6361 6c44 7269 \\?\PhysicalDri │ │ │ │ │ +00005bf0: 7665 300a 0a20 2020 4265 7761 7265 2074 ve0.. Beware t │ │ │ │ │ +00005c00: 6861 7420 796f 7520 6d61 7920 6e65 6564 hat you may need │ │ │ │ │ +00005c10: 2074 6f20 6675 7274 6865 7220 6573 6361 to further esca │ │ │ │ │ +00005c20: 7065 2074 6865 2062 6163 6b73 6c61 7368 pe the backslash │ │ │ │ │ +00005c30: 6573 2064 6570 656e 6469 6e67 0a6f 6e20 es depending.on │ │ │ │ │ +00005c40: 796f 7572 2073 6865 6c6c 2e0a 0a20 2020 your shell... │ │ │ │ │ +00005c50: 5768 656e 2063 6f6d 7069 6c65 6420 7769 When compiled wi │ │ │ │ │ +00005c60: 7468 2063 7967 7769 6e20 7375 7070 6f72 th cygwin suppor │ │ │ │ │ +00005c70: 7420 7468 656e 2063 7967 7769 6e20 6472 t then cygwin dr │ │ │ │ │ +00005c80: 6976 6520 6e61 6d65 7320 6172 650a 6175 ive names are.au │ │ │ │ │ +00005c90: 746f 6d61 7469 6361 6c6c 7920 7768 656e tomatically when │ │ │ │ │ +00005ca0: 206e 6565 6465 642e 2020 452e 672e 0a0a needed. E.g... │ │ │ │ │ +00005cb0: 2020 2020 2023 2067 7275 622d 696e 7374 # grub-inst │ │ │ │ │ +00005cc0: 616c 6c20 2f64 6576 2f73 6461 0a0a 1f0a all /dev/sda.... │ │ │ │ │ +00005cd0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00005ce0: 2020 4e6f 6465 3a20 496e 7374 616c 6c61 Node: Installa │ │ │ │ │ +00005cf0: 7469 6f6e 2c20 204e 6578 743a 2042 6f6f tion, Next: Boo │ │ │ │ │ +00005d00: 7469 6e67 2c20 2050 7265 763a 204f 532d ting, Prev: OS- │ │ │ │ │ +00005d10: 7370 6563 6966 6963 206e 6f74 6573 2061 specific notes a │ │ │ │ │ +00005d20: 626f 7574 2067 7275 6220 746f 6f6c 732c bout grub tools, │ │ │ │ │ +00005d30: 2020 5570 3a20 546f 700a 0a34 2049 6e73 Up: Top..4 Ins │ │ │ │ │ +00005d40: 7461 6c6c 6174 696f 6e0a 2a2a 2a2a 2a2a tallation.****** │ │ │ │ │ +00005d50: 2a2a 2a2a 2a2a 2a2a 0a0a 496e 206f 7264 ********..In ord │ │ │ │ │ +00005d60: 6572 2074 6f20 696e 7374 616c 6c20 4752 er to install GR │ │ │ │ │ +00005d70: 5542 2061 7320 796f 7572 2062 6f6f 7420 UB as your boot │ │ │ │ │ +00005d80: 6c6f 6164 6572 2c20 796f 7520 6e65 6564 loader, you need │ │ │ │ │ +00005d90: 2074 6f20 6669 7273 7420 696e 7374 616c to first instal │ │ │ │ │ +00005da0: 6c0a 7468 6520 4752 5542 2073 7973 7465 l.the GRUB syste │ │ │ │ │ +00005db0: 6d20 616e 6420 7574 696c 6974 6965 7320 m and utilities │ │ │ │ │ +00005dc0: 756e 6465 7220 796f 7572 2055 4e49 582d under your UNIX- │ │ │ │ │ +00005dd0: 6c69 6b65 206f 7065 7261 7469 6e67 2073 like operating s │ │ │ │ │ +00005de0: 7973 7465 6d0a 282a 6e6f 7465 204f 6274 ystem.(*note Obt │ │ │ │ │ +00005df0: 6169 6e69 6e67 2061 6e64 2042 7569 6c64 aining and Build │ │ │ │ │ +00005e00: 696e 6720 4752 5542 3a3a 292e 2020 596f ing GRUB::). Yo │ │ │ │ │ +00005e10: 7520 6361 6e20 646f 2074 6869 7320 6569 u can do this ei │ │ │ │ │ +00005e20: 7468 6572 2066 726f 6d20 7468 650a 736f ther from the.so │ │ │ │ │ +00005e30: 7572 6365 2074 6172 6261 6c6c 2c20 6f72 urce tarball, or │ │ │ │ │ +00005e40: 2061 7320 6120 7061 636b 6167 6520 666f as a package fo │ │ │ │ │ +00005e50: 7220 796f 7572 204f 532e 0a0a 2020 2041 r your OS... A │ │ │ │ │ +00005e60: 6674 6572 2079 6f75 2068 6176 6520 646f fter you have do │ │ │ │ │ +00005e70: 6e65 2074 6861 742c 2079 6f75 206e 6565 ne that, you nee │ │ │ │ │ +00005e80: 6420 746f 2069 6e73 7461 6c6c 2074 6865 d to install the │ │ │ │ │ +00005e90: 2062 6f6f 7420 6c6f 6164 6572 206f 6e20 boot loader on │ │ │ │ │ +00005ea0: 610a 6472 6976 6520 2866 6c6f 7070 7920 a.drive (floppy │ │ │ │ │ +00005eb0: 6f72 2068 6172 6420 6469 736b 2920 6279 or hard disk) by │ │ │ │ │ +00005ec0: 2075 7369 6e67 2074 6865 2075 7469 6c69 using the utili │ │ │ │ │ +00005ed0: 7479 2027 6772 7562 2d69 6e73 7461 6c6c ty 'grub-install │ │ │ │ │ +00005ee0: 2720 282a 6e6f 7465 0a49 6e76 6f6b 696e ' (*note.Invokin │ │ │ │ │ +00005ef0: 6720 6772 7562 2d69 6e73 7461 6c6c 3a3a g grub-install:: │ │ │ │ │ +00005f00: 2920 6f6e 2061 2055 4e49 582d 6c69 6b65 ) on a UNIX-like │ │ │ │ │ +00005f10: 204f 532e 0a0a 2020 2047 5255 4220 636f OS... GRUB co │ │ │ │ │ +00005f20: 6d65 7320 7769 7468 2062 6f6f 7420 696d mes with boot im │ │ │ │ │ +00005f30: 6167 6573 2c20 7768 6963 6820 6172 6520 ages, which are │ │ │ │ │ +00005f40: 6e6f 726d 616c 6c79 2070 7574 2069 6e20 normally put in │ │ │ │ │ +00005f50: 7468 6520 6469 7265 6374 6f72 790a 272f the directory.'/ │ │ │ │ │ +00005f60: 7573 722f 6c69 622f 6772 7562 2f3c 6370 usr/lib/grub/-' ( │ │ │ │ │ +00005f80: 666f 7220 4249 4f53 2d62 6173 6564 206d for BIOS-based m │ │ │ │ │ +00005f90: 6163 6869 6e65 730a 272f 7573 722f 6c69 achines.'/usr/li │ │ │ │ │ +00005fa0: 622f 6772 7562 2f69 3338 362d 7063 2729 b/grub/i386-pc') │ │ │ │ │ +00005fb0: 2e20 2048 6572 6561 6674 6572 2c20 7468 . Hereafter, th │ │ │ │ │ +00005fc0: 6520 6469 7265 6374 6f72 7920 7768 6572 e directory wher │ │ │ │ │ +00005fd0: 6520 4752 5542 2069 6d61 6765 730a 6172 e GRUB images.ar │ │ │ │ │ +00005fe0: 6520 696e 6974 6961 6c6c 7920 706c 6163 e initially plac │ │ │ │ │ +00005ff0: 6564 2028 6e6f 726d 616c 6c79 2027 2f75 ed (normally '/u │ │ │ │ │ +00006000: 7372 2f6c 6962 2f67 7275 622f 3c63 7075 sr/lib/grub/-') w │ │ │ │ │ +00006020: 696c 6c20 6265 0a63 616c 6c65 6420 7468 ill be.called th │ │ │ │ │ +00006030: 6520 2269 6d61 6765 2064 6972 6563 746f e "image directo │ │ │ │ │ +00006040: 7279 222c 2061 6e64 2074 6865 2064 6972 ry", and the dir │ │ │ │ │ +00006050: 6563 746f 7279 2077 6865 7265 2074 6865 ectory where the │ │ │ │ │ +00006060: 2062 6f6f 7420 6c6f 6164 6572 0a6e 6565 boot loader.nee │ │ │ │ │ +00006070: 6473 2074 6f20 6669 6e64 2074 6865 6d20 ds to find them │ │ │ │ │ +00006080: 2875 7375 616c 6c79 2027 2f62 6f6f 7427 (usually '/boot' │ │ │ │ │ +00006090: 2920 7769 6c6c 2062 6520 6361 6c6c 6564 ) will be called │ │ │ │ │ +000060a0: 2074 6865 2022 626f 6f74 0a64 6972 6563 the "boot.direc │ │ │ │ │ +000060b0: 746f 7279 222e 0a0a 2a20 4d65 6e75 3a0a tory"...* Menu:. │ │ │ │ │ +000060c0: 0a2a 2049 6e73 7461 6c6c 696e 6720 4752 .* Installing GR │ │ │ │ │ +000060d0: 5542 2075 7369 6e67 2067 7275 622d 696e UB using grub-in │ │ │ │ │ +000060e0: 7374 616c 6c3a 3a0a 2a20 4d61 6b69 6e67 stall::.* Making │ │ │ │ │ +000060f0: 2061 2047 5255 4220 626f 6f74 6162 6c65 a GRUB bootable │ │ │ │ │ +00006100: 2043 442d 524f 4d3a 3a0a 2a20 4465 7669 CD-ROM::.* Devi │ │ │ │ │ +00006110: 6365 206d 6170 3a3a 0a2a 2042 494f 5320 ce map::.* BIOS │ │ │ │ │ +00006120: 696e 7374 616c 6c61 7469 6f6e 3a3a 0a0a installation::.. │ │ │ │ │ +00006130: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00006140: 6f2c 2020 4e6f 6465 3a20 496e 7374 616c o, Node: Instal │ │ │ │ │ +00006150: 6c69 6e67 2047 5255 4220 7573 696e 6720 ling GRUB using │ │ │ │ │ +00006160: 6772 7562 2d69 6e73 7461 6c6c 2c20 204e grub-install, N │ │ │ │ │ +00006170: 6578 743a 204d 616b 696e 6720 6120 4752 ext: Making a GR │ │ │ │ │ +00006180: 5542 2062 6f6f 7461 626c 6520 4344 2d52 UB bootable CD-R │ │ │ │ │ +00006190: 4f4d 2c20 2055 703a 2049 6e73 7461 6c6c OM, Up: Install │ │ │ │ │ +000061a0: 6174 696f 6e0a 0a34 2e31 2049 6e73 7461 ation..4.1 Insta │ │ │ │ │ +000061b0: 6c6c 696e 6720 4752 5542 2075 7369 6e67 lling GRUB using │ │ │ │ │ +000061c0: 2067 7275 622d 696e 7374 616c 6c0a 3d3d grub-install.== │ │ │ │ │ 000061d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 000061e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000061f0: 3d3d 0a0a 466f 7220 696e 666f 726d 6174 ==..For informat │ │ │ │ │ -00006200: 696f 6e20 6f6e 2077 6865 7265 2047 5255 ion on where GRU │ │ │ │ │ -00006210: 4220 7368 6f75 6c64 2062 6520 696e 7374 B should be inst │ │ │ │ │ -00006220: 616c 6c65 6420 6f6e 2050 4320 4249 4f53 alled on PC BIOS │ │ │ │ │ -00006230: 2070 6c61 7466 6f72 6d73 2c0a 2a6e 6f74 platforms,.*not │ │ │ │ │ -00006240: 6520 4249 4f53 2069 6e73 7461 6c6c 6174 e BIOS installat │ │ │ │ │ -00006250: 696f 6e3a 3a2e 0a0a 2020 2049 6e20 6f72 ion::... In or │ │ │ │ │ -00006260: 6465 7220 746f 2069 6e73 7461 6c6c 2047 der to install G │ │ │ │ │ -00006270: 5255 4220 756e 6465 7220 6120 554e 4958 RUB under a UNIX │ │ │ │ │ -00006280: 2d6c 696b 6520 4f53 2028 7375 6368 2061 -like OS (such a │ │ │ │ │ -00006290: 7320 474e 5529 2c20 696e 766f 6b65 0a74 s GNU), invoke.t │ │ │ │ │ -000062a0: 6865 2070 726f 6772 616d 2027 6772 7562 he program 'grub │ │ │ │ │ -000062b0: 2d69 6e73 7461 6c6c 2720 282a 6e6f 7465 -install' (*note │ │ │ │ │ -000062c0: 2049 6e76 6f6b 696e 6720 6772 7562 2d69 Invoking grub-i │ │ │ │ │ -000062d0: 6e73 7461 6c6c 3a3a 2920 6173 2074 6865 nstall::) as the │ │ │ │ │ -000062e0: 0a73 7570 6572 7573 6572 2028 2272 6f6f .superuser ("roo │ │ │ │ │ -000062f0: 7422 292e 0a0a 2020 2054 6865 2075 7361 t")... The usa │ │ │ │ │ -00006300: 6765 2069 7320 6261 7369 6361 6c6c 7920 ge is basically │ │ │ │ │ -00006310: 7665 7279 2073 696d 706c 652e 2020 596f very simple. Yo │ │ │ │ │ -00006320: 7520 6f6e 6c79 206e 6565 6420 746f 2073 u only need to s │ │ │ │ │ -00006330: 7065 6369 6679 206f 6e65 0a61 7267 756d pecify one.argum │ │ │ │ │ -00006340: 656e 7420 746f 2074 6865 2070 726f 6772 ent to the progr │ │ │ │ │ -00006350: 616d 2c20 6e61 6d65 6c79 2c20 7768 6572 am, namely, wher │ │ │ │ │ -00006360: 6520 746f 2069 6e73 7461 6c6c 2074 6865 e to install the │ │ │ │ │ -00006370: 2062 6f6f 7420 6c6f 6164 6572 2e20 2054 boot loader. T │ │ │ │ │ -00006380: 6865 0a61 7267 756d 656e 7420 6861 7320 he.argument has │ │ │ │ │ -00006390: 746f 2062 6520 6569 7468 6572 2061 2064 to be either a d │ │ │ │ │ -000063a0: 6576 6963 6520 6669 6c65 2028 6c69 6b65 evice file (like │ │ │ │ │ -000063b0: 2027 2f64 6576 2f68 6461 2729 2e20 2046 '/dev/hda'). F │ │ │ │ │ -000063c0: 6f72 2065 7861 6d70 6c65 2c0a 756e 6465 or example,.unde │ │ │ │ │ -000063d0: 7220 4c69 6e75 7820 7468 6520 666f 6c6c r Linux the foll │ │ │ │ │ -000063e0: 6f77 696e 6720 7769 6c6c 2069 6e73 7461 owing will insta │ │ │ │ │ -000063f0: 6c6c 2047 5255 4220 696e 746f 2074 6865 ll GRUB into the │ │ │ │ │ -00006400: 204d 4252 206f 6620 7468 6520 6669 7273 MBR of the firs │ │ │ │ │ -00006410: 740a 4944 4520 6469 736b 3a0a 0a20 2020 t.IDE disk:.. │ │ │ │ │ -00006420: 2020 2320 6772 7562 2d69 6e73 7461 6c6c # grub-install │ │ │ │ │ -00006430: 202f 6465 762f 7364 610a 0a20 2020 4c69 /dev/sda.. Li │ │ │ │ │ -00006440: 6b65 7769 7365 2c20 756e 6465 7220 474e kewise, under GN │ │ │ │ │ -00006450: 552f 4875 7264 2c20 7468 6973 2068 6173 U/Hurd, this has │ │ │ │ │ -00006460: 2074 6865 2073 616d 6520 6566 6665 6374 the same effect │ │ │ │ │ -00006470: 3a0a 0a20 2020 2020 2320 6772 7562 2d69 :.. # grub-i │ │ │ │ │ -00006480: 6e73 7461 6c6c 202f 6465 762f 6864 300a nstall /dev/hd0. │ │ │ │ │ -00006490: 0a20 2020 4275 7420 616c 6c20 7468 6520 . But all the │ │ │ │ │ -000064a0: 6162 6f76 6520 6578 616d 706c 6573 2061 above examples a │ │ │ │ │ -000064b0: 7373 756d 6520 7468 6174 2047 5255 4220 ssume that GRUB │ │ │ │ │ -000064c0: 7368 6f75 6c64 2070 7574 2069 6d61 6765 should put image │ │ │ │ │ -000064d0: 7320 756e 6465 720a 7468 6520 272f 626f s under.the '/bo │ │ │ │ │ -000064e0: 6f74 2720 6469 7265 6374 6f72 792e 2020 ot' directory. │ │ │ │ │ -000064f0: 4966 2079 6f75 2077 616e 7420 4752 5542 If you want GRUB │ │ │ │ │ -00006500: 2074 6f20 7075 7420 696d 6167 6573 2075 to put images u │ │ │ │ │ -00006510: 6e64 6572 2061 2064 6972 6563 746f 7279 nder a directory │ │ │ │ │ -00006520: 0a6f 7468 6572 2074 6861 6e20 272f 626f .other than '/bo │ │ │ │ │ -00006530: 6f74 272c 2079 6f75 206e 6565 6420 746f ot', you need to │ │ │ │ │ -00006540: 2073 7065 6369 6679 2074 6865 206f 7074 specify the opt │ │ │ │ │ -00006550: 696f 6e20 272d 2d62 6f6f 742d 6469 7265 ion '--boot-dire │ │ │ │ │ -00006560: 6374 6f72 7927 2e0a 5468 6520 7479 7069 ctory'..The typi │ │ │ │ │ -00006570: 6361 6c20 7573 6167 6520 6973 2074 6861 cal usage is tha │ │ │ │ │ -00006580: 7420 796f 7520 6372 6561 7465 2061 2047 t you create a G │ │ │ │ │ -00006590: 5255 4220 626f 6f74 2066 6c6f 7070 7920 RUB boot floppy │ │ │ │ │ -000065a0: 7769 7468 2061 0a66 696c 6573 7973 7465 with a.filesyste │ │ │ │ │ -000065b0: 6d2e 2020 4865 7265 2069 7320 616e 2065 m. Here is an e │ │ │ │ │ -000065c0: 7861 6d70 6c65 3a0a 0a20 2020 2020 2320 xample:.. # │ │ │ │ │ -000065d0: 6d6b 6532 6673 202f 6465 762f 6664 300a mke2fs /dev/fd0. │ │ │ │ │ -000065e0: 2020 2020 2023 206d 6f75 6e74 202d 7420 # mount -t │ │ │ │ │ -000065f0: 6578 7432 202f 6465 762f 6664 3020 2f6d ext2 /dev/fd0 /m │ │ │ │ │ -00006600: 6e74 0a20 2020 2020 2320 6d6b 6469 7220 nt. # mkdir │ │ │ │ │ -00006610: 2f6d 6e74 2f62 6f6f 740a 2020 2020 2023 /mnt/boot. # │ │ │ │ │ -00006620: 2067 7275 622d 696e 7374 616c 6c20 2d2d grub-install -- │ │ │ │ │ -00006630: 626f 6f74 2d64 6972 6563 746f 7279 3d2f boot-directory=/ │ │ │ │ │ -00006640: 6d6e 742f 626f 6f74 202f 6465 762f 6664 mnt/boot /dev/fd │ │ │ │ │ -00006650: 300a 2020 2020 2023 2075 6d6f 756e 7420 0. # umount │ │ │ │ │ -00006660: 2f6d 6e74 0a0a 2020 2053 6f6d 6520 4249 /mnt.. Some BI │ │ │ │ │ -00006670: 4f53 6573 2068 6176 6520 6120 6275 6720 OSes have a bug │ │ │ │ │ -00006680: 6f66 2065 7870 6f73 696e 6720 7468 6520 of exposing the │ │ │ │ │ -00006690: 6669 7273 7420 7061 7274 6974 696f 6e20 first partition │ │ │ │ │ -000066a0: 6f66 2061 2055 5342 2064 7269 7665 0a61 of a USB drive.a │ │ │ │ │ -000066b0: 7320 6120 666c 6f70 7079 2069 6e73 7465 s a floppy inste │ │ │ │ │ -000066c0: 6164 206f 6620 6578 706f 7369 6e67 2074 ad of exposing t │ │ │ │ │ -000066d0: 6865 2055 5342 2064 7269 7665 2061 7320 he USB drive as │ │ │ │ │ -000066e0: 6120 6861 7264 2064 6973 6b20 2874 6865 a hard disk (the │ │ │ │ │ -000066f0: 7920 6361 6c6c 0a69 7420 2255 5342 2d46 y call.it "USB-F │ │ │ │ │ -00006700: 4444 2220 626f 6f74 292e 2020 496e 2073 DD" boot). In s │ │ │ │ │ -00006710: 7563 6820 6361 7365 732c 2079 6f75 206e uch cases, you n │ │ │ │ │ -00006720: 6565 6420 746f 2069 6e73 7461 6c6c 206c eed to install l │ │ │ │ │ -00006730: 696b 6520 7468 6973 3a0a 0a20 2020 2020 ike this:.. │ │ │ │ │ -00006740: 2320 6c6f 7365 7475 7020 2f64 6576 2f6c # losetup /dev/l │ │ │ │ │ -00006750: 6f6f 7030 202f 6465 762f 7364 6231 0a20 oop0 /dev/sdb1. │ │ │ │ │ -00006760: 2020 2020 2320 6d6f 756e 7420 2f64 6576 # mount /dev │ │ │ │ │ -00006770: 2f6c 6f6f 7030 202f 6d6e 742f 7573 620a /loop0 /mnt/usb. │ │ │ │ │ -00006780: 2020 2020 2023 2067 7275 622d 696e 7374 # grub-inst │ │ │ │ │ -00006790: 616c 6c20 2d2d 626f 6f74 2d64 6972 6563 all --boot-direc │ │ │ │ │ -000067a0: 746f 7279 3d2f 6d6e 742f 7573 622f 6275 tory=/mnt/usb/bu │ │ │ │ │ -000067b0: 6762 696f 7320 2d2d 666f 7263 6520 2d2d gbios --force -- │ │ │ │ │ -000067c0: 616c 6c6f 772d 666c 6f70 7079 202f 6465 allow-floppy /de │ │ │ │ │ -000067d0: 762f 6c6f 6f70 300a 0a20 2020 5468 6973 v/loop0.. This │ │ │ │ │ -000067e0: 2069 6e73 7461 6c6c 2064 6f65 736e 2774 install doesn't │ │ │ │ │ -000067f0: 2063 6f6e 666c 6963 7420 7769 7468 2073 conflict with s │ │ │ │ │ -00006800: 7461 6e64 6172 6420 696e 7374 616c 6c20 tandard install │ │ │ │ │ -00006810: 6173 206c 6f6e 6720 6173 2074 6865 790a as long as they. │ │ │ │ │ -00006820: 6172 6520 696e 2073 6570 6172 6174 6520 are in separate │ │ │ │ │ -00006830: 6469 7265 6374 6f72 6965 732e 0a0a 2020 directories... │ │ │ │ │ -00006840: 204f 6e20 4546 4920 7379 7374 656d 7320 On EFI systems │ │ │ │ │ -00006850: 666f 7220 6669 7865 6420 6469 736b 2069 for fixed disk i │ │ │ │ │ -00006860: 6e73 7461 6c6c 2079 6f75 2068 6176 6520 nstall you have │ │ │ │ │ -00006870: 746f 206d 6f75 6e74 2045 4649 2053 7973 to mount EFI Sys │ │ │ │ │ -00006880: 7465 6d0a 5061 7274 6974 696f 6e2e 2020 tem.Partition. │ │ │ │ │ -00006890: 4966 2079 6f75 206d 6f75 6e74 2069 7420 If you mount it │ │ │ │ │ -000068a0: 6174 2027 2f62 6f6f 742f 6566 6927 2074 at '/boot/efi' t │ │ │ │ │ -000068b0: 6865 6e20 796f 7520 646f 6e27 7420 6e65 hen you don't ne │ │ │ │ │ -000068c0: 6564 2061 6e79 0a73 7065 6369 616c 2061 ed any.special a │ │ │ │ │ -000068d0: 7267 756d 656e 7473 3a0a 0a20 2020 2020 rguments:.. │ │ │ │ │ -000068e0: 2320 6772 7562 2d69 6e73 7461 6c6c 0a0a # grub-install.. │ │ │ │ │ -000068f0: 2020 204f 7468 6572 7769 7365 2079 6f75 Otherwise you │ │ │ │ │ -00006900: 206e 6565 6420 746f 2073 7065 6369 6679 need to specify │ │ │ │ │ -00006910: 2077 6865 7265 2079 6f75 7220 4546 4920 where your EFI │ │ │ │ │ -00006920: 5379 7374 656d 2070 6172 7469 7469 6f6e System partition │ │ │ │ │ -00006930: 2069 730a 6d6f 756e 7465 643a 0a0a 2020 is.mounted:.. │ │ │ │ │ -00006940: 2020 2023 2067 7275 622d 696e 7374 616c # grub-instal │ │ │ │ │ -00006950: 6c20 2d2d 6566 692d 6469 7265 6374 6f72 l --efi-director │ │ │ │ │ -00006960: 793d 2f6d 6e74 2f65 6669 0a0a 2020 2046 y=/mnt/efi.. F │ │ │ │ │ -00006970: 6f72 2072 656d 6f76 6162 6c65 2069 6e73 or removable ins │ │ │ │ │ -00006980: 7461 6c6c 7320 796f 7520 6861 7665 2074 talls you have t │ │ │ │ │ -00006990: 6f20 7573 6520 272d 2d72 656d 6f76 6162 o use '--removab │ │ │ │ │ -000069a0: 6c65 2720 616e 6420 7370 6563 6966 7920 le' and specify │ │ │ │ │ -000069b0: 626f 7468 0a27 2d2d 626f 6f74 2d64 6972 both.'--boot-dir │ │ │ │ │ -000069c0: 6563 746f 7279 2720 616e 6420 272d 2d65 ectory' and '--e │ │ │ │ │ -000069d0: 6669 2d64 6972 6563 746f 7279 273a 0a0a fi-directory':.. │ │ │ │ │ -000069e0: 2020 2020 2023 2067 7275 622d 696e 7374 # grub-inst │ │ │ │ │ -000069f0: 616c 6c20 2d2d 6566 692d 6469 7265 6374 all --efi-direct │ │ │ │ │ -00006a00: 6f72 793d 2f6d 6e74 2f75 7362 202d 2d62 ory=/mnt/usb --b │ │ │ │ │ -00006a10: 6f6f 742d 6469 7265 6374 6f72 793d 2f6d oot-directory=/m │ │ │ │ │ -00006a20: 6e74 2f75 7362 2f62 6f6f 7420 2d2d 7265 nt/usb/boot --re │ │ │ │ │ -00006a30: 6d6f 7661 626c 650a 0a1f 0a46 696c 653a movable....File: │ │ │ │ │ -00006a40: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -00006a50: 653a 204d 616b 696e 6720 6120 4752 5542 e: Making a GRUB │ │ │ │ │ -00006a60: 2062 6f6f 7461 626c 6520 4344 2d52 4f4d bootable CD-ROM │ │ │ │ │ -00006a70: 2c20 204e 6578 743a 2044 6576 6963 6520 , Next: Device │ │ │ │ │ -00006a80: 6d61 702c 2020 5072 6576 3a20 496e 7374 map, Prev: Inst │ │ │ │ │ -00006a90: 616c 6c69 6e67 2047 5255 4220 7573 696e alling GRUB usin │ │ │ │ │ -00006aa0: 6720 6772 7562 2d69 6e73 7461 6c6c 2c20 g grub-install, │ │ │ │ │ -00006ab0: 2055 703a 2049 6e73 7461 6c6c 6174 696f Up: Installatio │ │ │ │ │ -00006ac0: 6e0a 0a34 2e32 204d 616b 696e 6720 6120 n..4.2 Making a │ │ │ │ │ -00006ad0: 4752 5542 2062 6f6f 7461 626c 6520 4344 GRUB bootable CD │ │ │ │ │ -00006ae0: 2d52 4f4d 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d -ROM.=========== │ │ │ │ │ +000061f0: 3d3d 3d3d 0a0a 466f 7220 696e 666f 726d ====..For inform │ │ │ │ │ +00006200: 6174 696f 6e20 6f6e 2077 6865 7265 2047 ation on where G │ │ │ │ │ +00006210: 5255 4220 7368 6f75 6c64 2062 6520 696e RUB should be in │ │ │ │ │ +00006220: 7374 616c 6c65 6420 6f6e 2050 4320 4249 stalled on PC BI │ │ │ │ │ +00006230: 4f53 2070 6c61 7466 6f72 6d73 2c0a 2a6e OS platforms,.*n │ │ │ │ │ +00006240: 6f74 6520 4249 4f53 2069 6e73 7461 6c6c ote BIOS install │ │ │ │ │ +00006250: 6174 696f 6e3a 3a2e 0a0a 2020 2049 6e20 ation::... In │ │ │ │ │ +00006260: 6f72 6465 7220 746f 2069 6e73 7461 6c6c order to install │ │ │ │ │ +00006270: 2047 5255 4220 756e 6465 7220 6120 554e GRUB under a UN │ │ │ │ │ +00006280: 4958 2d6c 696b 6520 4f53 2028 7375 6368 IX-like OS (such │ │ │ │ │ +00006290: 2061 7320 474e 5529 2c20 696e 766f 6b65 as GNU), invoke │ │ │ │ │ +000062a0: 0a74 6865 2070 726f 6772 616d 2027 6772 .the program 'gr │ │ │ │ │ +000062b0: 7562 2d69 6e73 7461 6c6c 2720 282a 6e6f ub-install' (*no │ │ │ │ │ +000062c0: 7465 2049 6e76 6f6b 696e 6720 6772 7562 te Invoking grub │ │ │ │ │ +000062d0: 2d69 6e73 7461 6c6c 3a3a 2920 6173 2074 -install::) as t │ │ │ │ │ +000062e0: 6865 0a73 7570 6572 7573 6572 2028 2272 he.superuser ("r │ │ │ │ │ +000062f0: 6f6f 7422 292e 0a0a 2020 2054 6865 2075 oot")... The u │ │ │ │ │ +00006300: 7361 6765 2069 7320 6261 7369 6361 6c6c sage is basicall │ │ │ │ │ +00006310: 7920 7665 7279 2073 696d 706c 652e 2020 y very simple. │ │ │ │ │ +00006320: 596f 7520 6f6e 6c79 206e 6565 6420 746f You only need to │ │ │ │ │ +00006330: 2073 7065 6369 6679 206f 6e65 0a61 7267 specify one.arg │ │ │ │ │ +00006340: 756d 656e 7420 746f 2074 6865 2070 726f ument to the pro │ │ │ │ │ +00006350: 6772 616d 2c20 6e61 6d65 6c79 2c20 7768 gram, namely, wh │ │ │ │ │ +00006360: 6572 6520 746f 2069 6e73 7461 6c6c 2074 ere to install t │ │ │ │ │ +00006370: 6865 2062 6f6f 7420 6c6f 6164 6572 2e20 he boot loader. │ │ │ │ │ +00006380: 2054 6865 0a61 7267 756d 656e 7420 6861 The.argument ha │ │ │ │ │ +00006390: 7320 746f 2062 6520 6569 7468 6572 2061 s to be either a │ │ │ │ │ +000063a0: 2064 6576 6963 6520 6669 6c65 2028 6c69 device file (li │ │ │ │ │ +000063b0: 6b65 2027 2f64 6576 2f68 6461 2729 2e20 ke '/dev/hda'). │ │ │ │ │ +000063c0: 2046 6f72 2065 7861 6d70 6c65 2c0a 756e For example,.un │ │ │ │ │ +000063d0: 6465 7220 4c69 6e75 7820 7468 6520 666f der Linux the fo │ │ │ │ │ +000063e0: 6c6c 6f77 696e 6720 7769 6c6c 2069 6e73 llowing will ins │ │ │ │ │ +000063f0: 7461 6c6c 2047 5255 4220 696e 746f 2074 tall GRUB into t │ │ │ │ │ +00006400: 6865 204d 4252 206f 6620 7468 6520 6669 he MBR of the fi │ │ │ │ │ +00006410: 7273 740a 4944 4520 6469 736b 3a0a 0a20 rst.IDE disk:.. │ │ │ │ │ +00006420: 2020 2020 2320 6772 7562 2d69 6e73 7461 # grub-insta │ │ │ │ │ +00006430: 6c6c 202f 6465 762f 7364 610a 0a20 2020 ll /dev/sda.. │ │ │ │ │ +00006440: 4c69 6b65 7769 7365 2c20 756e 6465 7220 Likewise, under │ │ │ │ │ +00006450: 474e 552f 4875 7264 2c20 7468 6973 2068 GNU/Hurd, this h │ │ │ │ │ +00006460: 6173 2074 6865 2073 616d 6520 6566 6665 as the same effe │ │ │ │ │ +00006470: 6374 3a0a 0a20 2020 2020 2320 6772 7562 ct:.. # grub │ │ │ │ │ +00006480: 2d69 6e73 7461 6c6c 202f 6465 762f 6864 -install /dev/hd │ │ │ │ │ +00006490: 300a 0a20 2020 4275 7420 616c 6c20 7468 0.. But all th │ │ │ │ │ +000064a0: 6520 6162 6f76 6520 6578 616d 706c 6573 e above examples │ │ │ │ │ +000064b0: 2061 7373 756d 6520 7468 6174 2047 5255 assume that GRU │ │ │ │ │ +000064c0: 4220 7368 6f75 6c64 2070 7574 2069 6d61 B should put ima │ │ │ │ │ +000064d0: 6765 7320 756e 6465 720a 7468 6520 272f ges under.the '/ │ │ │ │ │ +000064e0: 626f 6f74 2720 6469 7265 6374 6f72 792e boot' directory. │ │ │ │ │ +000064f0: 2020 4966 2079 6f75 2077 616e 7420 4752 If you want GR │ │ │ │ │ +00006500: 5542 2074 6f20 7075 7420 696d 6167 6573 UB to put images │ │ │ │ │ +00006510: 2075 6e64 6572 2061 2064 6972 6563 746f under a directo │ │ │ │ │ +00006520: 7279 0a6f 7468 6572 2074 6861 6e20 272f ry.other than '/ │ │ │ │ │ +00006530: 626f 6f74 272c 2079 6f75 206e 6565 6420 boot', you need │ │ │ │ │ +00006540: 746f 2073 7065 6369 6679 2074 6865 206f to specify the o │ │ │ │ │ +00006550: 7074 696f 6e20 272d 2d62 6f6f 742d 6469 ption '--boot-di │ │ │ │ │ +00006560: 7265 6374 6f72 7927 2e0a 5468 6520 7479 rectory'..The ty │ │ │ │ │ +00006570: 7069 6361 6c20 7573 6167 6520 6973 2074 pical usage is t │ │ │ │ │ +00006580: 6861 7420 796f 7520 6372 6561 7465 2061 hat you create a │ │ │ │ │ +00006590: 2047 5255 4220 626f 6f74 2066 6c6f 7070 GRUB boot flopp │ │ │ │ │ +000065a0: 7920 7769 7468 2061 0a66 696c 6573 7973 y with a.filesys │ │ │ │ │ +000065b0: 7465 6d2e 2020 4865 7265 2069 7320 616e tem. Here is an │ │ │ │ │ +000065c0: 2065 7861 6d70 6c65 3a0a 0a20 2020 2020 example:.. │ │ │ │ │ +000065d0: 2320 6d6b 6532 6673 202f 6465 762f 6664 # mke2fs /dev/fd │ │ │ │ │ +000065e0: 300a 2020 2020 2023 206d 6f75 6e74 202d 0. # mount - │ │ │ │ │ +000065f0: 7420 6578 7432 202f 6465 762f 6664 3020 t ext2 /dev/fd0 │ │ │ │ │ +00006600: 2f6d 6e74 0a20 2020 2020 2320 6d6b 6469 /mnt. # mkdi │ │ │ │ │ +00006610: 7220 2f6d 6e74 2f62 6f6f 740a 2020 2020 r /mnt/boot. │ │ │ │ │ +00006620: 2023 2067 7275 622d 696e 7374 616c 6c20 # grub-install │ │ │ │ │ +00006630: 2d2d 626f 6f74 2d64 6972 6563 746f 7279 --boot-directory │ │ │ │ │ +00006640: 3d2f 6d6e 742f 626f 6f74 202f 6465 762f =/mnt/boot /dev/ │ │ │ │ │ +00006650: 6664 300a 2020 2020 2023 2075 6d6f 756e fd0. # umoun │ │ │ │ │ +00006660: 7420 2f6d 6e74 0a0a 2020 2053 6f6d 6520 t /mnt.. Some │ │ │ │ │ +00006670: 4249 4f53 6573 2068 6176 6520 6120 6275 BIOSes have a bu │ │ │ │ │ +00006680: 6720 6f66 2065 7870 6f73 696e 6720 7468 g of exposing th │ │ │ │ │ +00006690: 6520 6669 7273 7420 7061 7274 6974 696f e first partitio │ │ │ │ │ +000066a0: 6e20 6f66 2061 2055 5342 2064 7269 7665 n of a USB drive │ │ │ │ │ +000066b0: 0a61 7320 6120 666c 6f70 7079 2069 6e73 .as a floppy ins │ │ │ │ │ +000066c0: 7465 6164 206f 6620 6578 706f 7369 6e67 tead of exposing │ │ │ │ │ +000066d0: 2074 6865 2055 5342 2064 7269 7665 2061 the USB drive a │ │ │ │ │ +000066e0: 7320 6120 6861 7264 2064 6973 6b20 2874 s a hard disk (t │ │ │ │ │ +000066f0: 6865 7920 6361 6c6c 0a69 7420 2255 5342 hey call.it "USB │ │ │ │ │ +00006700: 2d46 4444 2220 626f 6f74 292e 2020 496e -FDD" boot). In │ │ │ │ │ +00006710: 2073 7563 6820 6361 7365 732c 2079 6f75 such cases, you │ │ │ │ │ +00006720: 206e 6565 6420 746f 2069 6e73 7461 6c6c need to install │ │ │ │ │ +00006730: 206c 696b 6520 7468 6973 3a0a 0a20 2020 like this:.. │ │ │ │ │ +00006740: 2020 2320 6c6f 7365 7475 7020 2f64 6576 # losetup /dev │ │ │ │ │ +00006750: 2f6c 6f6f 7030 202f 6465 762f 7364 6231 /loop0 /dev/sdb1 │ │ │ │ │ +00006760: 0a20 2020 2020 2320 6d6f 756e 7420 2f64 . # mount /d │ │ │ │ │ +00006770: 6576 2f6c 6f6f 7030 202f 6d6e 742f 7573 ev/loop0 /mnt/us │ │ │ │ │ +00006780: 620a 2020 2020 2023 2067 7275 622d 696e b. # grub-in │ │ │ │ │ +00006790: 7374 616c 6c20 2d2d 626f 6f74 2d64 6972 stall --boot-dir │ │ │ │ │ +000067a0: 6563 746f 7279 3d2f 6d6e 742f 7573 622f ectory=/mnt/usb/ │ │ │ │ │ +000067b0: 6275 6762 696f 7320 2d2d 666f 7263 6520 bugbios --force │ │ │ │ │ +000067c0: 2d2d 616c 6c6f 772d 666c 6f70 7079 202f --allow-floppy / │ │ │ │ │ +000067d0: 6465 762f 6c6f 6f70 300a 0a20 2020 5468 dev/loop0.. Th │ │ │ │ │ +000067e0: 6973 2069 6e73 7461 6c6c 2064 6f65 736e is install doesn │ │ │ │ │ +000067f0: 2774 2063 6f6e 666c 6963 7420 7769 7468 't conflict with │ │ │ │ │ +00006800: 2073 7461 6e64 6172 6420 696e 7374 616c standard instal │ │ │ │ │ +00006810: 6c20 6173 206c 6f6e 6720 6173 2074 6865 l as long as the │ │ │ │ │ +00006820: 790a 6172 6520 696e 2073 6570 6172 6174 y.are in separat │ │ │ │ │ +00006830: 6520 6469 7265 6374 6f72 6965 732e 0a0a e directories... │ │ │ │ │ +00006840: 2020 204f 6e20 4546 4920 7379 7374 656d On EFI system │ │ │ │ │ +00006850: 7320 666f 7220 6669 7865 6420 6469 736b s for fixed disk │ │ │ │ │ +00006860: 2069 6e73 7461 6c6c 2079 6f75 2068 6176 install you hav │ │ │ │ │ +00006870: 6520 746f 206d 6f75 6e74 2045 4649 2053 e to mount EFI S │ │ │ │ │ +00006880: 7973 7465 6d0a 5061 7274 6974 696f 6e2e ystem.Partition. │ │ │ │ │ +00006890: 2020 4966 2079 6f75 206d 6f75 6e74 2069 If you mount i │ │ │ │ │ +000068a0: 7420 6174 2027 2f62 6f6f 742f 6566 6927 t at '/boot/efi' │ │ │ │ │ +000068b0: 2074 6865 6e20 796f 7520 646f 6e27 7420 then you don't │ │ │ │ │ +000068c0: 6e65 6564 2061 6e79 0a73 7065 6369 616c need any.special │ │ │ │ │ +000068d0: 2061 7267 756d 656e 7473 3a0a 0a20 2020 arguments:.. │ │ │ │ │ +000068e0: 2020 2320 6772 7562 2d69 6e73 7461 6c6c # grub-install │ │ │ │ │ +000068f0: 0a0a 2020 204f 7468 6572 7769 7365 2079 .. Otherwise y │ │ │ │ │ +00006900: 6f75 206e 6565 6420 746f 2073 7065 6369 ou need to speci │ │ │ │ │ +00006910: 6679 2077 6865 7265 2079 6f75 7220 4546 fy where your EF │ │ │ │ │ +00006920: 4920 5379 7374 656d 2070 6172 7469 7469 I System partiti │ │ │ │ │ +00006930: 6f6e 2069 730a 6d6f 756e 7465 643a 0a0a on is.mounted:.. │ │ │ │ │ +00006940: 2020 2020 2023 2067 7275 622d 696e 7374 # grub-inst │ │ │ │ │ +00006950: 616c 6c20 2d2d 6566 692d 6469 7265 6374 all --efi-direct │ │ │ │ │ +00006960: 6f72 793d 2f6d 6e74 2f65 6669 0a0a 2020 ory=/mnt/efi.. │ │ │ │ │ +00006970: 2046 6f72 2072 656d 6f76 6162 6c65 2069 For removable i │ │ │ │ │ +00006980: 6e73 7461 6c6c 7320 796f 7520 6861 7665 nstalls you have │ │ │ │ │ +00006990: 2074 6f20 7573 6520 272d 2d72 656d 6f76 to use '--remov │ │ │ │ │ +000069a0: 6162 6c65 2720 616e 6420 7370 6563 6966 able' and specif │ │ │ │ │ +000069b0: 7920 626f 7468 0a27 2d2d 626f 6f74 2d64 y both.'--boot-d │ │ │ │ │ +000069c0: 6972 6563 746f 7279 2720 616e 6420 272d irectory' and '- │ │ │ │ │ +000069d0: 2d65 6669 2d64 6972 6563 746f 7279 273a -efi-directory': │ │ │ │ │ +000069e0: 0a0a 2020 2020 2023 2067 7275 622d 696e .. # grub-in │ │ │ │ │ +000069f0: 7374 616c 6c20 2d2d 6566 692d 6469 7265 stall --efi-dire │ │ │ │ │ +00006a00: 6374 6f72 793d 2f6d 6e74 2f75 7362 202d ctory=/mnt/usb - │ │ │ │ │ +00006a10: 2d62 6f6f 742d 6469 7265 6374 6f72 793d -boot-directory= │ │ │ │ │ +00006a20: 2f6d 6e74 2f75 7362 2f62 6f6f 7420 2d2d /mnt/usb/boot -- │ │ │ │ │ +00006a30: 7265 6d6f 7661 626c 650a 0a1f 0a46 696c removable....Fil │ │ │ │ │ +00006a40: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00006a50: 6f64 653a 204d 616b 696e 6720 6120 4752 ode: Making a GR │ │ │ │ │ +00006a60: 5542 2062 6f6f 7461 626c 6520 4344 2d52 UB bootable CD-R │ │ │ │ │ +00006a70: 4f4d 2c20 204e 6578 743a 2044 6576 6963 OM, Next: Devic │ │ │ │ │ +00006a80: 6520 6d61 702c 2020 5072 6576 3a20 496e e map, Prev: In │ │ │ │ │ +00006a90: 7374 616c 6c69 6e67 2047 5255 4220 7573 stalling GRUB us │ │ │ │ │ +00006aa0: 696e 6720 6772 7562 2d69 6e73 7461 6c6c ing grub-install │ │ │ │ │ +00006ab0: 2c20 2055 703a 2049 6e73 7461 6c6c 6174 , Up: Installat │ │ │ │ │ +00006ac0: 696f 6e0a 0a34 2e32 204d 616b 696e 6720 ion..4.2 Making │ │ │ │ │ +00006ad0: 6120 4752 5542 2062 6f6f 7461 626c 6520 a GRUB bootable │ │ │ │ │ +00006ae0: 4344 2d52 4f4d 0a3d 3d3d 3d3d 3d3d 3d3d CD-ROM.========= │ │ │ │ │ 00006af0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00006b00: 3d3d 3d3d 3d3d 0a0a 4752 5542 2073 7570 ======..GRUB sup │ │ │ │ │ -00006b10: 706f 7274 7320 7468 6520 226e 6f20 656d ports the "no em │ │ │ │ │ -00006b20: 756c 6174 696f 6e20 6d6f 6465 2220 696e ulation mode" in │ │ │ │ │ -00006b30: 2074 6865 2045 6c20 546f 7269 746f 2073 the El Torito s │ │ │ │ │ -00006b40: 7065 6369 6669 6361 7469 6f6e 2831 290a pecification(1). │ │ │ │ │ -00006b50: 282a 6e6f 7465 204d 616b 696e 6720 6120 (*note Making a │ │ │ │ │ -00006b60: 4752 5542 2062 6f6f 7461 626c 6520 4344 GRUB bootable CD │ │ │ │ │ -00006b70: 2d52 4f4d 2d46 6f6f 746e 6f74 652d 313a -ROM-Footnote-1: │ │ │ │ │ -00006b80: 3a29 2e20 2054 6869 7320 6d65 616e 7320 :). This means │ │ │ │ │ -00006b90: 7468 6174 2079 6f75 0a63 616e 2075 7365 that you.can use │ │ │ │ │ -00006ba0: 2074 6865 2077 686f 6c65 2043 442d 524f the whole CD-RO │ │ │ │ │ -00006bb0: 4d20 6672 6f6d 2047 5255 4220 616e 6420 M from GRUB and │ │ │ │ │ -00006bc0: 796f 7520 646f 6e27 7420 6861 7665 2074 you don't have t │ │ │ │ │ -00006bd0: 6f20 6d61 6b65 2061 2066 6c6f 7070 790a o make a floppy. │ │ │ │ │ -00006be0: 6f72 2068 6172 6420 6469 736b 2069 6d61 or hard disk ima │ │ │ │ │ -00006bf0: 6765 2066 696c 652c 2077 6869 6368 2063 ge file, which c │ │ │ │ │ -00006c00: 616e 2063 6175 7365 2063 6f6d 7061 7469 an cause compati │ │ │ │ │ -00006c10: 6269 6c69 7479 2070 726f 626c 656d 732e bility problems. │ │ │ │ │ -00006c20: 0a0a 2020 2046 6f72 2062 6f6f 7469 6e67 .. For booting │ │ │ │ │ -00006c30: 2066 726f 6d20 6120 4344 2d52 4f4d 2c20 from a CD-ROM, │ │ │ │ │ -00006c40: 4752 5542 2075 7365 7320 6120 7370 6563 GRUB uses a spec │ │ │ │ │ -00006c50: 6961 6c20 696d 6167 6520 6361 6c6c 6564 ial image called │ │ │ │ │ -00006c60: 0a27 6364 626f 6f74 2e69 6d67 272c 2077 .'cdboot.img', w │ │ │ │ │ -00006c70: 6869 6368 2069 7320 636f 6e63 6174 656e hich is concaten │ │ │ │ │ -00006c80: 6174 6564 2077 6974 6820 2763 6f72 652e ated with 'core. │ │ │ │ │ -00006c90: 696d 6727 2e20 2054 6865 2027 636f 7265 img'. The 'core │ │ │ │ │ -00006ca0: 2e69 6d67 270a 7573 6564 2066 6f72 2074 .img'.used for t │ │ │ │ │ -00006cb0: 6869 7320 7368 6f75 6c64 2062 6520 6275 his should be bu │ │ │ │ │ -00006cc0: 696c 7420 7769 7468 2061 7420 6c65 6173 ilt with at leas │ │ │ │ │ -00006cd0: 7420 7468 6520 2769 736f 3936 3630 2720 t the 'iso9660' │ │ │ │ │ -00006ce0: 616e 6420 2762 696f 7364 6973 6b27 0a6d and 'biosdisk'.m │ │ │ │ │ -00006cf0: 6f64 756c 6573 2e20 2059 6f75 7220 626f odules. Your bo │ │ │ │ │ -00006d00: 6f74 6162 6c65 2043 442d 524f 4d20 7769 otable CD-ROM wi │ │ │ │ │ -00006d10: 6c6c 2075 7375 616c 6c79 2061 6c73 6f20 ll usually also │ │ │ │ │ -00006d20: 6e65 6564 2074 6f20 696e 636c 7564 6520 need to include │ │ │ │ │ -00006d30: 610a 636f 6e66 6967 7572 6174 696f 6e20 a.configuration │ │ │ │ │ -00006d40: 6669 6c65 2027 6772 7562 2e63 6667 2720 file 'grub.cfg' │ │ │ │ │ -00006d50: 616e 6420 736f 6d65 206f 7468 6572 2047 and some other G │ │ │ │ │ -00006d60: 5255 4220 6d6f 6475 6c65 732e 0a0a 2020 RUB modules... │ │ │ │ │ -00006d70: 2054 6f20 6d61 6b65 2061 2073 696d 706c To make a simpl │ │ │ │ │ -00006d80: 6520 6765 6e65 7269 6320 4752 5542 2072 e generic GRUB r │ │ │ │ │ -00006d90: 6573 6375 6520 4344 2c20 796f 7520 6361 escue CD, you ca │ │ │ │ │ -00006da0: 6e20 7573 6520 7468 650a 2767 7275 622d n use the.'grub- │ │ │ │ │ -00006db0: 6d6b 7265 7363 7565 2720 7072 6f67 7261 mkrescue' progra │ │ │ │ │ -00006dc0: 6d20 282a 6e6f 7465 2049 6e76 6f6b 696e m (*note Invokin │ │ │ │ │ -00006dd0: 6720 6772 7562 2d6d 6b72 6573 6375 653a g grub-mkrescue: │ │ │ │ │ -00006de0: 3a29 3a0a 0a20 2020 2020 2420 6772 7562 :):.. $ grub │ │ │ │ │ -00006df0: 2d6d 6b72 6573 6375 6520 2d6f 2067 7275 -mkrescue -o gru │ │ │ │ │ -00006e00: 622e 6973 6f0a 0a20 2020 596f 7520 7769 b.iso.. You wi │ │ │ │ │ -00006e10: 6c6c 206f 6674 656e 206e 6565 6420 746f ll often need to │ │ │ │ │ -00006e20: 2069 6e63 6c75 6465 206f 7468 6572 2066 include other f │ │ │ │ │ -00006e30: 696c 6573 2069 6e20 796f 7572 2069 6d61 iles in your ima │ │ │ │ │ -00006e40: 6765 2e20 2054 6f20 646f 0a74 6869 732c ge. To do.this, │ │ │ │ │ -00006e50: 2066 6972 7374 206d 616b 6520 6120 746f first make a to │ │ │ │ │ -00006e60: 7020 6469 7265 6374 6f72 7920 666f 7220 p directory for │ │ │ │ │ -00006e70: 7468 6520 626f 6f74 6162 6c65 2069 6d61 the bootable ima │ │ │ │ │ -00006e80: 6765 2c20 7361 792c 2027 6973 6f27 3a0a ge, say, 'iso':. │ │ │ │ │ -00006e90: 0a20 2020 2020 2420 6d6b 6469 7220 6973 . $ mkdir is │ │ │ │ │ -00006ea0: 6f0a 0a20 2020 4d61 6b65 2061 2064 6972 o.. Make a dir │ │ │ │ │ -00006eb0: 6563 746f 7279 2066 6f72 2047 5255 423a ectory for GRUB: │ │ │ │ │ -00006ec0: 0a0a 2020 2020 2024 206d 6b64 6972 202d .. $ mkdir - │ │ │ │ │ -00006ed0: 7020 6973 6f2f 626f 6f74 2f67 7275 620a p iso/boot/grub. │ │ │ │ │ -00006ee0: 0a20 2020 4966 2064 6573 6972 6564 2c20 . If desired, │ │ │ │ │ -00006ef0: 6d61 6b65 2074 6865 2063 6f6e 6669 6720 make the config │ │ │ │ │ -00006f00: 6669 6c65 2027 6772 7562 2e63 6667 2720 file 'grub.cfg' │ │ │ │ │ -00006f10: 756e 6465 7220 2769 736f 2f62 6f6f 742f under 'iso/boot/ │ │ │ │ │ -00006f20: 6772 7562 270a 282a 6e6f 7465 2043 6f6e grub'.(*note Con │ │ │ │ │ -00006f30: 6669 6775 7261 7469 6f6e 3a3a 292c 2061 figuration::), a │ │ │ │ │ -00006f40: 6e64 2063 6f70 7920 616e 7920 6669 6c65 nd copy any file │ │ │ │ │ -00006f50: 7320 616e 6420 6469 7265 6374 6f72 6965 s and directorie │ │ │ │ │ -00006f60: 7320 666f 7220 7468 6520 6469 7363 0a74 s for the disc.t │ │ │ │ │ -00006f70: 6f20 7468 6520 6469 7265 6374 6f72 7920 o the directory │ │ │ │ │ -00006f80: 2769 736f 2f27 2e0a 0a20 2020 4669 6e61 'iso/'... Fina │ │ │ │ │ -00006f90: 6c6c 792c 206d 616b 6520 7468 6520 696d lly, make the im │ │ │ │ │ -00006fa0: 6167 653a 0a0a 2020 2020 2024 2067 7275 age:.. $ gru │ │ │ │ │ -00006fb0: 622d 6d6b 7265 7363 7565 202d 6f20 6772 b-mkrescue -o gr │ │ │ │ │ -00006fc0: 7562 2e69 736f 2069 736f 0a0a 2020 2054 ub.iso iso.. T │ │ │ │ │ -00006fd0: 6869 7320 7072 6f64 7563 6573 2061 2066 his produces a f │ │ │ │ │ -00006fe0: 696c 6520 6e61 6d65 6420 2767 7275 622e ile named 'grub. │ │ │ │ │ -00006ff0: 6973 6f27 2c20 7768 6963 6820 7468 656e iso', which then │ │ │ │ │ -00007000: 2063 616e 2062 6520 6275 726e 6564 2069 can be burned i │ │ │ │ │ -00007010: 6e74 6f0a 6120 4344 2028 6f72 2061 2044 nto.a CD (or a D │ │ │ │ │ -00007020: 5644 292c 206f 7220 7772 6974 7465 6e20 VD), or written │ │ │ │ │ -00007030: 746f 2061 2055 5342 206d 6173 7320 7374 to a USB mass st │ │ │ │ │ -00007040: 6f72 6167 6520 6465 7669 6365 2e0a 0a20 orage device... │ │ │ │ │ -00007050: 2020 5468 6520 726f 6f74 2064 6576 6963 The root devic │ │ │ │ │ -00007060: 6520 7769 6c6c 2062 6520 7365 7420 7570 e will be set up │ │ │ │ │ -00007070: 2061 7070 726f 7072 6961 7465 6c79 206f appropriately o │ │ │ │ │ -00007080: 6e20 656e 7465 7269 6e67 2079 6f75 720a n entering your. │ │ │ │ │ -00007090: 2767 7275 622e 6366 6727 2063 6f6e 6669 'grub.cfg' confi │ │ │ │ │ -000070a0: 6775 7261 7469 6f6e 2066 696c 652c 2073 guration file, s │ │ │ │ │ -000070b0: 6f20 796f 7520 6361 6e20 7265 6665 7220 o you can refer │ │ │ │ │ -000070c0: 746f 2066 696c 6520 6e61 6d65 7320 6f6e to file names on │ │ │ │ │ -000070d0: 2074 6865 2043 440a 7769 7468 6f75 7420 the CD.without │ │ │ │ │ -000070e0: 6e65 6564 696e 6720 746f 2075 7365 2061 needing to use a │ │ │ │ │ -000070f0: 6e20 6578 706c 6963 6974 2064 6576 6963 n explicit devic │ │ │ │ │ -00007100: 6520 6e61 6d65 2e20 2054 6869 7320 6d61 e name. This ma │ │ │ │ │ -00007110: 6b65 7320 6974 2065 6173 6965 7220 746f kes it easier to │ │ │ │ │ -00007120: 0a70 726f 6475 6365 2072 6573 6375 6520 .produce rescue │ │ │ │ │ -00007130: 696d 6167 6573 2074 6861 7420 7769 6c6c images that will │ │ │ │ │ -00007140: 2077 6f72 6b20 6f6e 2062 6f74 6820 6f70 work on both op │ │ │ │ │ -00007150: 7469 6361 6c20 6472 6976 6573 2061 6e64 tical drives and │ │ │ │ │ -00007160: 2055 5342 206d 6173 730a 7374 6f72 6167 USB mass.storag │ │ │ │ │ -00007170: 6520 6465 7669 6365 732e 0a0a 1f0a 4669 e devices.....Fi │ │ │ │ │ -00007180: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00007190: 4e6f 6465 3a20 4d61 6b69 6e67 2061 2047 Node: Making a G │ │ │ │ │ -000071a0: 5255 4220 626f 6f74 6162 6c65 2043 442d RUB bootable CD- │ │ │ │ │ -000071b0: 524f 4d2d 466f 6f74 6e6f 7465 732c 2020 ROM-Footnotes, │ │ │ │ │ -000071c0: 5570 3a20 4d61 6b69 6e67 2061 2047 5255 Up: Making a GRU │ │ │ │ │ -000071d0: 4220 626f 6f74 6162 6c65 2043 442d 524f B bootable CD-RO │ │ │ │ │ -000071e0: 4d0a 0a20 2020 2831 2920 456c 2054 6f72 M.. (1) El Tor │ │ │ │ │ -000071f0: 6974 6f20 6973 2061 2073 7065 6369 6669 ito is a specifi │ │ │ │ │ -00007200: 6361 7469 6f6e 2066 6f72 2062 6f6f 7461 cation for boota │ │ │ │ │ -00007210: 626c 6520 4344 2075 7369 6e67 2042 494f ble CD using BIO │ │ │ │ │ -00007220: 530a 6675 6e63 7469 6f6e 732e 0a0a 1f0a S.functions..... │ │ │ │ │ -00007230: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -00007240: 2020 4e6f 6465 3a20 4465 7669 6365 206d Node: Device m │ │ │ │ │ -00007250: 6170 2c20 204e 6578 743a 2042 494f 5320 ap, Next: BIOS │ │ │ │ │ -00007260: 696e 7374 616c 6c61 7469 6f6e 2c20 2050 installation, P │ │ │ │ │ -00007270: 7265 763a 204d 616b 696e 6720 6120 4752 rev: Making a GR │ │ │ │ │ -00007280: 5542 2062 6f6f 7461 626c 6520 4344 2d52 UB bootable CD-R │ │ │ │ │ -00007290: 4f4d 2c20 2055 703a 2049 6e73 7461 6c6c OM, Up: Install │ │ │ │ │ -000072a0: 6174 696f 6e0a 0a34 2e33 2054 6865 206d ation..4.3 The m │ │ │ │ │ -000072b0: 6170 2062 6574 7765 656e 2042 494f 5320 ap between BIOS │ │ │ │ │ -000072c0: 6472 6976 6573 2061 6e64 204f 5320 6465 drives and OS de │ │ │ │ │ -000072d0: 7669 6365 730a 3d3d 3d3d 3d3d 3d3d 3d3d vices.========== │ │ │ │ │ +00006b00: 3d3d 3d3d 3d3d 3d3d 0a0a 4752 5542 2073 ========..GRUB s │ │ │ │ │ +00006b10: 7570 706f 7274 7320 7468 6520 226e 6f20 upports the "no │ │ │ │ │ +00006b20: 656d 756c 6174 696f 6e20 6d6f 6465 2220 emulation mode" │ │ │ │ │ +00006b30: 696e 2074 6865 2045 6c20 546f 7269 746f in the El Torito │ │ │ │ │ +00006b40: 2073 7065 6369 6669 6361 7469 6f6e 2831 specification(1 │ │ │ │ │ +00006b50: 290a 282a 6e6f 7465 204d 616b 696e 6720 ).(*note Making │ │ │ │ │ +00006b60: 6120 4752 5542 2062 6f6f 7461 626c 6520 a GRUB bootable │ │ │ │ │ +00006b70: 4344 2d52 4f4d 2d46 6f6f 746e 6f74 652d CD-ROM-Footnote- │ │ │ │ │ +00006b80: 313a 3a29 2e20 2054 6869 7320 6d65 616e 1::). This mean │ │ │ │ │ +00006b90: 7320 7468 6174 2079 6f75 0a63 616e 2075 s that you.can u │ │ │ │ │ +00006ba0: 7365 2074 6865 2077 686f 6c65 2043 442d se the whole CD- │ │ │ │ │ +00006bb0: 524f 4d20 6672 6f6d 2047 5255 4220 616e ROM from GRUB an │ │ │ │ │ +00006bc0: 6420 796f 7520 646f 6e27 7420 6861 7665 d you don't have │ │ │ │ │ +00006bd0: 2074 6f20 6d61 6b65 2061 2066 6c6f 7070 to make a flopp │ │ │ │ │ +00006be0: 790a 6f72 2068 6172 6420 6469 736b 2069 y.or hard disk i │ │ │ │ │ +00006bf0: 6d61 6765 2066 696c 652c 2077 6869 6368 mage file, which │ │ │ │ │ +00006c00: 2063 616e 2063 6175 7365 2063 6f6d 7061 can cause compa │ │ │ │ │ +00006c10: 7469 6269 6c69 7479 2070 726f 626c 656d tibility problem │ │ │ │ │ +00006c20: 732e 0a0a 2020 2046 6f72 2062 6f6f 7469 s... For booti │ │ │ │ │ +00006c30: 6e67 2066 726f 6d20 6120 4344 2d52 4f4d ng from a CD-ROM │ │ │ │ │ +00006c40: 2c20 4752 5542 2075 7365 7320 6120 7370 , GRUB uses a sp │ │ │ │ │ +00006c50: 6563 6961 6c20 696d 6167 6520 6361 6c6c ecial image call │ │ │ │ │ +00006c60: 6564 0a27 6364 626f 6f74 2e69 6d67 272c ed.'cdboot.img', │ │ │ │ │ +00006c70: 2077 6869 6368 2069 7320 636f 6e63 6174 which is concat │ │ │ │ │ +00006c80: 656e 6174 6564 2077 6974 6820 2763 6f72 enated with 'cor │ │ │ │ │ +00006c90: 652e 696d 6727 2e20 2054 6865 2027 636f e.img'. The 'co │ │ │ │ │ +00006ca0: 7265 2e69 6d67 270a 7573 6564 2066 6f72 re.img'.used for │ │ │ │ │ +00006cb0: 2074 6869 7320 7368 6f75 6c64 2062 6520 this should be │ │ │ │ │ +00006cc0: 6275 696c 7420 7769 7468 2061 7420 6c65 built with at le │ │ │ │ │ +00006cd0: 6173 7420 7468 6520 2769 736f 3936 3630 ast the 'iso9660 │ │ │ │ │ +00006ce0: 2720 616e 6420 2762 696f 7364 6973 6b27 ' and 'biosdisk' │ │ │ │ │ +00006cf0: 0a6d 6f64 756c 6573 2e20 2059 6f75 7220 .modules. Your │ │ │ │ │ +00006d00: 626f 6f74 6162 6c65 2043 442d 524f 4d20 bootable CD-ROM │ │ │ │ │ +00006d10: 7769 6c6c 2075 7375 616c 6c79 2061 6c73 will usually als │ │ │ │ │ +00006d20: 6f20 6e65 6564 2074 6f20 696e 636c 7564 o need to includ │ │ │ │ │ +00006d30: 6520 610a 636f 6e66 6967 7572 6174 696f e a.configuratio │ │ │ │ │ +00006d40: 6e20 6669 6c65 2027 6772 7562 2e63 6667 n file 'grub.cfg │ │ │ │ │ +00006d50: 2720 616e 6420 736f 6d65 206f 7468 6572 ' and some other │ │ │ │ │ +00006d60: 2047 5255 4220 6d6f 6475 6c65 732e 0a0a GRUB modules... │ │ │ │ │ +00006d70: 2020 2054 6f20 6d61 6b65 2061 2073 696d To make a sim │ │ │ │ │ +00006d80: 706c 6520 6765 6e65 7269 6320 4752 5542 ple generic GRUB │ │ │ │ │ +00006d90: 2072 6573 6375 6520 4344 2c20 796f 7520 rescue CD, you │ │ │ │ │ +00006da0: 6361 6e20 7573 6520 7468 650a 2767 7275 can use the.'gru │ │ │ │ │ +00006db0: 622d 6d6b 7265 7363 7565 2720 7072 6f67 b-mkrescue' prog │ │ │ │ │ +00006dc0: 7261 6d20 282a 6e6f 7465 2049 6e76 6f6b ram (*note Invok │ │ │ │ │ +00006dd0: 696e 6720 6772 7562 2d6d 6b72 6573 6375 ing grub-mkrescu │ │ │ │ │ +00006de0: 653a 3a29 3a0a 0a20 2020 2020 2420 6772 e::):.. $ gr │ │ │ │ │ +00006df0: 7562 2d6d 6b72 6573 6375 6520 2d6f 2067 ub-mkrescue -o g │ │ │ │ │ +00006e00: 7275 622e 6973 6f0a 0a20 2020 596f 7520 rub.iso.. You │ │ │ │ │ +00006e10: 7769 6c6c 206f 6674 656e 206e 6565 6420 will often need │ │ │ │ │ +00006e20: 746f 2069 6e63 6c75 6465 206f 7468 6572 to include other │ │ │ │ │ +00006e30: 2066 696c 6573 2069 6e20 796f 7572 2069 files in your i │ │ │ │ │ +00006e40: 6d61 6765 2e20 2054 6f20 646f 0a74 6869 mage. To do.thi │ │ │ │ │ +00006e50: 732c 2066 6972 7374 206d 616b 6520 6120 s, first make a │ │ │ │ │ +00006e60: 746f 7020 6469 7265 6374 6f72 7920 666f top directory fo │ │ │ │ │ +00006e70: 7220 7468 6520 626f 6f74 6162 6c65 2069 r the bootable i │ │ │ │ │ +00006e80: 6d61 6765 2c20 7361 792c 2027 6973 6f27 mage, say, 'iso' │ │ │ │ │ +00006e90: 3a0a 0a20 2020 2020 2420 6d6b 6469 7220 :.. $ mkdir │ │ │ │ │ +00006ea0: 6973 6f0a 0a20 2020 4d61 6b65 2061 2064 iso.. Make a d │ │ │ │ │ +00006eb0: 6972 6563 746f 7279 2066 6f72 2047 5255 irectory for GRU │ │ │ │ │ +00006ec0: 423a 0a0a 2020 2020 2024 206d 6b64 6972 B:.. $ mkdir │ │ │ │ │ +00006ed0: 202d 7020 6973 6f2f 626f 6f74 2f67 7275 -p iso/boot/gru │ │ │ │ │ +00006ee0: 620a 0a20 2020 4966 2064 6573 6972 6564 b.. If desired │ │ │ │ │ +00006ef0: 2c20 6d61 6b65 2074 6865 2063 6f6e 6669 , make the confi │ │ │ │ │ +00006f00: 6720 6669 6c65 2027 6772 7562 2e63 6667 g file 'grub.cfg │ │ │ │ │ +00006f10: 2720 756e 6465 7220 2769 736f 2f62 6f6f ' under 'iso/boo │ │ │ │ │ +00006f20: 742f 6772 7562 270a 282a 6e6f 7465 2043 t/grub'.(*note C │ │ │ │ │ +00006f30: 6f6e 6669 6775 7261 7469 6f6e 3a3a 292c onfiguration::), │ │ │ │ │ +00006f40: 2061 6e64 2063 6f70 7920 616e 7920 6669 and copy any fi │ │ │ │ │ +00006f50: 6c65 7320 616e 6420 6469 7265 6374 6f72 les and director │ │ │ │ │ +00006f60: 6965 7320 666f 7220 7468 6520 6469 7363 ies for the disc │ │ │ │ │ +00006f70: 0a74 6f20 7468 6520 6469 7265 6374 6f72 .to the director │ │ │ │ │ +00006f80: 7920 2769 736f 2f27 2e0a 0a20 2020 4669 y 'iso/'... Fi │ │ │ │ │ +00006f90: 6e61 6c6c 792c 206d 616b 6520 7468 6520 nally, make the │ │ │ │ │ +00006fa0: 696d 6167 653a 0a0a 2020 2020 2024 2067 image:.. $ g │ │ │ │ │ +00006fb0: 7275 622d 6d6b 7265 7363 7565 202d 6f20 rub-mkrescue -o │ │ │ │ │ +00006fc0: 6772 7562 2e69 736f 2069 736f 0a0a 2020 grub.iso iso.. │ │ │ │ │ +00006fd0: 2054 6869 7320 7072 6f64 7563 6573 2061 This produces a │ │ │ │ │ +00006fe0: 2066 696c 6520 6e61 6d65 6420 2767 7275 file named 'gru │ │ │ │ │ +00006ff0: 622e 6973 6f27 2c20 7768 6963 6820 7468 b.iso', which th │ │ │ │ │ +00007000: 656e 2063 616e 2062 6520 6275 726e 6564 en can be burned │ │ │ │ │ +00007010: 2069 6e74 6f0a 6120 4344 2028 6f72 2061 into.a CD (or a │ │ │ │ │ +00007020: 2044 5644 292c 206f 7220 7772 6974 7465 DVD), or writte │ │ │ │ │ +00007030: 6e20 746f 2061 2055 5342 206d 6173 7320 n to a USB mass │ │ │ │ │ +00007040: 7374 6f72 6167 6520 6465 7669 6365 2e0a storage device.. │ │ │ │ │ +00007050: 0a20 2020 5468 6520 726f 6f74 2064 6576 . The root dev │ │ │ │ │ +00007060: 6963 6520 7769 6c6c 2062 6520 7365 7420 ice will be set │ │ │ │ │ +00007070: 7570 2061 7070 726f 7072 6961 7465 6c79 up appropriately │ │ │ │ │ +00007080: 206f 6e20 656e 7465 7269 6e67 2079 6f75 on entering you │ │ │ │ │ +00007090: 720a 2767 7275 622e 6366 6727 2063 6f6e r.'grub.cfg' con │ │ │ │ │ +000070a0: 6669 6775 7261 7469 6f6e 2066 696c 652c figuration file, │ │ │ │ │ +000070b0: 2073 6f20 796f 7520 6361 6e20 7265 6665 so you can refe │ │ │ │ │ +000070c0: 7220 746f 2066 696c 6520 6e61 6d65 7320 r to file names │ │ │ │ │ +000070d0: 6f6e 2074 6865 2043 440a 7769 7468 6f75 on the CD.withou │ │ │ │ │ +000070e0: 7420 6e65 6564 696e 6720 746f 2075 7365 t needing to use │ │ │ │ │ +000070f0: 2061 6e20 6578 706c 6963 6974 2064 6576 an explicit dev │ │ │ │ │ +00007100: 6963 6520 6e61 6d65 2e20 2054 6869 7320 ice name. This │ │ │ │ │ +00007110: 6d61 6b65 7320 6974 2065 6173 6965 7220 makes it easier │ │ │ │ │ +00007120: 746f 0a70 726f 6475 6365 2072 6573 6375 to.produce rescu │ │ │ │ │ +00007130: 6520 696d 6167 6573 2074 6861 7420 7769 e images that wi │ │ │ │ │ +00007140: 6c6c 2077 6f72 6b20 6f6e 2062 6f74 6820 ll work on both │ │ │ │ │ +00007150: 6f70 7469 6361 6c20 6472 6976 6573 2061 optical drives a │ │ │ │ │ +00007160: 6e64 2055 5342 206d 6173 730a 7374 6f72 nd USB mass.stor │ │ │ │ │ +00007170: 6167 6520 6465 7669 6365 732e 0a0a 1f0a age devices..... │ │ │ │ │ +00007180: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00007190: 2020 4e6f 6465 3a20 4d61 6b69 6e67 2061 Node: Making a │ │ │ │ │ +000071a0: 2047 5255 4220 626f 6f74 6162 6c65 2043 GRUB bootable C │ │ │ │ │ +000071b0: 442d 524f 4d2d 466f 6f74 6e6f 7465 732c D-ROM-Footnotes, │ │ │ │ │ +000071c0: 2020 5570 3a20 4d61 6b69 6e67 2061 2047 Up: Making a G │ │ │ │ │ +000071d0: 5255 4220 626f 6f74 6162 6c65 2043 442d RUB bootable CD- │ │ │ │ │ +000071e0: 524f 4d0a 0a20 2020 2831 2920 456c 2054 ROM.. (1) El T │ │ │ │ │ +000071f0: 6f72 6974 6f20 6973 2061 2073 7065 6369 orito is a speci │ │ │ │ │ +00007200: 6669 6361 7469 6f6e 2066 6f72 2062 6f6f fication for boo │ │ │ │ │ +00007210: 7461 626c 6520 4344 2075 7369 6e67 2042 table CD using B │ │ │ │ │ +00007220: 494f 530a 6675 6e63 7469 6f6e 732e 0a0a IOS.functions... │ │ │ │ │ +00007230: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00007240: 6f2c 2020 4e6f 6465 3a20 4465 7669 6365 o, Node: Device │ │ │ │ │ +00007250: 206d 6170 2c20 204e 6578 743a 2042 494f map, Next: BIO │ │ │ │ │ +00007260: 5320 696e 7374 616c 6c61 7469 6f6e 2c20 S installation, │ │ │ │ │ +00007270: 2050 7265 763a 204d 616b 696e 6720 6120 Prev: Making a │ │ │ │ │ +00007280: 4752 5542 2062 6f6f 7461 626c 6520 4344 GRUB bootable CD │ │ │ │ │ +00007290: 2d52 4f4d 2c20 2055 703a 2049 6e73 7461 -ROM, Up: Insta │ │ │ │ │ +000072a0: 6c6c 6174 696f 6e0a 0a34 2e33 2054 6865 llation..4.3 The │ │ │ │ │ +000072b0: 206d 6170 2062 6574 7765 656e 2042 494f map between BIO │ │ │ │ │ +000072c0: 5320 6472 6976 6573 2061 6e64 204f 5320 S drives and OS │ │ │ │ │ +000072d0: 6465 7669 6365 730a 3d3d 3d3d 3d3d 3d3d devices.======== │ │ │ │ │ 000072e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 000072f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00007300: 3d3d 3d3d 0a0a 4966 2074 6865 2064 6576 ====..If the dev │ │ │ │ │ -00007310: 6963 6520 6d61 7020 6669 6c65 2065 7869 ice map file exi │ │ │ │ │ -00007320: 7374 732c 2074 6865 2047 5255 4220 7574 sts, the GRUB ut │ │ │ │ │ -00007330: 696c 6974 6965 7320 2827 6772 7562 2d70 ilities ('grub-p │ │ │ │ │ -00007340: 726f 6265 272c 2065 7463 2e29 0a72 6561 robe', etc.).rea │ │ │ │ │ -00007350: 6420 6974 2074 6f20 6d61 7020 4249 4f53 d it to map BIOS │ │ │ │ │ -00007360: 2064 7269 7665 7320 746f 204f 5320 6465 drives to OS de │ │ │ │ │ -00007370: 7669 6365 732e 2020 5468 6973 2066 696c vices. This fil │ │ │ │ │ -00007380: 6520 636f 6e73 6973 7473 206f 6620 6c69 e consists of li │ │ │ │ │ -00007390: 6e65 730a 6c69 6b65 2074 6869 733a 0a0a nes.like this:.. │ │ │ │ │ -000073a0: 2020 2020 2028 4445 5649 4345 2920 4649 (DEVICE) FI │ │ │ │ │ -000073b0: 4c45 0a0a 2020 2044 4556 4943 4520 6973 LE.. DEVICE is │ │ │ │ │ -000073c0: 2061 2064 7269 7665 2073 7065 6369 6669 a drive specifi │ │ │ │ │ -000073d0: 6564 2069 6e20 7468 6520 4752 5542 2073 ed in the GRUB s │ │ │ │ │ -000073e0: 796e 7461 7820 282a 6e6f 7465 2044 6576 yntax (*note Dev │ │ │ │ │ -000073f0: 6963 650a 7379 6e74 6178 3a3a 292c 2061 ice.syntax::), a │ │ │ │ │ -00007400: 6e64 2046 494c 4520 6973 2061 6e20 4f53 nd FILE is an OS │ │ │ │ │ -00007410: 2066 696c 652c 2077 6869 6368 2069 7320 file, which is │ │ │ │ │ -00007420: 6e6f 726d 616c 6c79 2061 2064 6576 6963 normally a devic │ │ │ │ │ -00007430: 6520 6669 6c65 2e0a 0a20 2020 4869 7374 e file... Hist │ │ │ │ │ -00007440: 6f72 6963 616c 6c79 2c20 7468 6520 6465 orically, the de │ │ │ │ │ -00007450: 7669 6365 206d 6170 2066 696c 6520 7761 vice map file wa │ │ │ │ │ -00007460: 7320 7573 6564 2062 6563 6175 7365 2047 s used because G │ │ │ │ │ -00007470: 5255 4220 6465 7669 6365 206e 616d 6573 RUB device names │ │ │ │ │ -00007480: 0a68 6164 2074 6f20 6265 2075 7365 6420 .had to be used │ │ │ │ │ -00007490: 696e 2074 6865 2063 6f6e 6669 6775 7261 in the configura │ │ │ │ │ -000074a0: 7469 6f6e 2066 696c 652c 2061 6e64 2074 tion file, and t │ │ │ │ │ -000074b0: 6865 7920 7765 7265 2064 6572 6976 6564 hey were derived │ │ │ │ │ -000074c0: 2066 726f 6d0a 4249 4f53 2064 7269 7665 from.BIOS drive │ │ │ │ │ -000074d0: 206e 756d 6265 7273 2e20 2054 6865 206d numbers. The m │ │ │ │ │ -000074e0: 6170 2062 6574 7765 656e 2042 494f 5320 ap between BIOS │ │ │ │ │ -000074f0: 6472 6976 6573 2061 6e64 204f 5320 6465 drives and OS de │ │ │ │ │ -00007500: 7669 6365 7320 6361 6e6e 6f74 0a61 6c77 vices cannot.alw │ │ │ │ │ -00007510: 6179 7320 6265 2067 7565 7373 6564 2063 ays be guessed c │ │ │ │ │ -00007520: 6f72 7265 6374 6c79 3a20 666f 7220 6578 orrectly: for ex │ │ │ │ │ -00007530: 616d 706c 652c 2047 5255 4220 7769 6c6c ample, GRUB will │ │ │ │ │ -00007540: 2067 6574 2074 6865 206f 7264 6572 2077 get the order w │ │ │ │ │ -00007550: 726f 6e67 0a69 6620 796f 7520 6578 6368 rong.if you exch │ │ │ │ │ -00007560: 616e 6765 2074 6865 2062 6f6f 7420 7365 ange the boot se │ │ │ │ │ -00007570: 7175 656e 6365 2062 6574 7765 656e 2049 quence between I │ │ │ │ │ -00007580: 4445 2061 6e64 2053 4353 4920 696e 2079 DE and SCSI in y │ │ │ │ │ -00007590: 6f75 7220 4249 4f53 2e0a 0a20 2020 556e our BIOS... Un │ │ │ │ │ -000075a0: 666f 7274 756e 6174 656c 792c 2065 7665 fortunately, eve │ │ │ │ │ -000075b0: 6e20 4f53 2064 6576 6963 6520 6e61 6d65 n OS device name │ │ │ │ │ -000075c0: 7320 6172 6520 6e6f 7420 616c 7761 7973 s are not always │ │ │ │ │ -000075d0: 2073 7461 626c 652e 2020 4d6f 6465 726e stable. Modern │ │ │ │ │ -000075e0: 0a76 6572 7369 6f6e 7320 6f66 2074 6865 .versions of the │ │ │ │ │ -000075f0: 204c 696e 7578 206b 6572 6e65 6c20 6d61 Linux kernel ma │ │ │ │ │ -00007600: 7920 7072 6f62 6520 6472 6976 6573 2069 y probe drives i │ │ │ │ │ -00007610: 6e20 6120 6469 6666 6572 656e 7420 6f72 n a different or │ │ │ │ │ -00007620: 6465 7220 6672 6f6d 0a62 6f6f 7420 746f der from.boot to │ │ │ │ │ -00007630: 2062 6f6f 742c 2061 6e64 2074 6865 2070 boot, and the p │ │ │ │ │ -00007640: 7265 6669 7820 2827 2f64 6576 2f68 642a refix ('/dev/hd* │ │ │ │ │ -00007650: 2720 7665 7273 7573 2027 2f64 6576 2f73 ' versus '/dev/s │ │ │ │ │ -00007660: 642a 2729 206d 6179 2063 6861 6e67 650a d*') may change. │ │ │ │ │ -00007670: 6465 7065 6e64 696e 6720 6f6e 2074 6865 depending on the │ │ │ │ │ -00007680: 2064 7269 7665 7220 7375 6273 7973 7465 driver subsyste │ │ │ │ │ -00007690: 6d20 696e 2075 7365 2e20 2041 7320 6120 m in use. As a │ │ │ │ │ -000076a0: 7265 7375 6c74 2c20 7468 6520 6465 7669 result, the devi │ │ │ │ │ -000076b0: 6365 206d 6170 0a66 696c 6520 7265 7175 ce map.file requ │ │ │ │ │ -000076c0: 6972 6564 2066 7265 7175 656e 7420 6564 ired frequent ed │ │ │ │ │ -000076d0: 6974 696e 6720 6f6e 2073 6f6d 6520 7379 iting on some sy │ │ │ │ │ -000076e0: 7374 656d 732e 0a0a 2020 2047 5255 4220 stems... GRUB │ │ │ │ │ -000076f0: 6176 6f69 6473 2074 6869 7320 7072 6f62 avoids this prob │ │ │ │ │ -00007700: 6c65 6d20 6e6f 7761 6461 7973 2062 7920 lem nowadays by │ │ │ │ │ -00007710: 7573 696e 6720 5555 4944 7320 6f72 2066 using UUIDs or f │ │ │ │ │ -00007720: 696c 6520 7379 7374 656d 0a6c 6162 656c ile system.label │ │ │ │ │ -00007730: 7320 7768 656e 2067 656e 6572 6174 696e s when generatin │ │ │ │ │ -00007740: 6720 2767 7275 622e 6366 6727 2c20 616e g 'grub.cfg', an │ │ │ │ │ -00007750: 6420 7765 2061 6476 6973 6520 7468 6174 d we advise that │ │ │ │ │ -00007760: 2079 6f75 2064 6f20 7468 6520 7361 6d65 you do the same │ │ │ │ │ -00007770: 0a66 6f72 2061 6e79 2063 7573 746f 6d20 .for any custom │ │ │ │ │ -00007780: 6d65 6e75 2065 6e74 7269 6573 2079 6f75 menu entries you │ │ │ │ │ -00007790: 2077 7269 7465 2e20 2049 6620 7468 6520 write. If the │ │ │ │ │ -000077a0: 6465 7669 6365 206d 6170 2066 696c 6520 device map file │ │ │ │ │ -000077b0: 646f 6573 206e 6f74 0a65 7869 7374 2c20 does not.exist, │ │ │ │ │ -000077c0: 7468 656e 2074 6865 2047 5255 4220 7574 then the GRUB ut │ │ │ │ │ -000077d0: 696c 6974 6965 7320 7769 6c6c 2061 7373 ilities will ass │ │ │ │ │ -000077e0: 756d 6520 6120 7465 6d70 6f72 6172 7920 ume a temporary │ │ │ │ │ -000077f0: 6465 7669 6365 206d 6170 206f 6e20 7468 device map on th │ │ │ │ │ -00007800: 650a 666c 792e 2020 5468 6973 2069 7320 e.fly. This is │ │ │ │ │ -00007810: 6f66 7465 6e20 676f 6f64 2065 6e6f 7567 often good enoug │ │ │ │ │ -00007820: 682c 2070 6172 7469 6375 6c61 726c 7920 h, particularly │ │ │ │ │ -00007830: 696e 2074 6865 2063 6f6d 6d6f 6e20 6361 in the common ca │ │ │ │ │ -00007840: 7365 206f 660a 7369 6e67 6c65 2d64 6973 se of.single-dis │ │ │ │ │ -00007850: 6b20 7379 7374 656d 732e 0a0a 2020 2048 k systems... H │ │ │ │ │ -00007860: 6f77 6576 6572 2c20 7468 6520 6465 7669 owever, the devi │ │ │ │ │ -00007870: 6365 206d 6170 2066 696c 6520 6973 206e ce map file is n │ │ │ │ │ -00007880: 6f74 2065 6e74 6972 656c 7920 6f62 736f ot entirely obso │ │ │ │ │ -00007890: 6c65 7465 2079 6574 2c20 616e 6420 6974 lete yet, and it │ │ │ │ │ -000078a0: 2069 730a 7573 6564 2066 6f72 206f 7665 is.used for ove │ │ │ │ │ -000078b0: 7272 6964 696e 6720 7768 656e 2063 7572 rriding when cur │ │ │ │ │ -000078c0: 7265 6e74 2065 6e76 6972 6f6e 6d65 6e74 rent environment │ │ │ │ │ -000078d0: 2069 7320 6469 6666 6572 656e 7420 6672 is different fr │ │ │ │ │ -000078e0: 6f6d 2074 6865 206f 6e65 0a6f 6e20 626f om the one.on bo │ │ │ │ │ -000078f0: 6f74 2e20 204d 6f73 7420 636f 6d6d 6f6e ot. Most common │ │ │ │ │ -00007900: 2063 6173 6520 6973 2069 6620 796f 7520 case is if you │ │ │ │ │ -00007910: 7573 6520 6120 7061 7274 6974 696f 6e20 use a partition │ │ │ │ │ -00007920: 6f72 206c 6f67 6963 616c 2076 6f6c 756d or logical volum │ │ │ │ │ -00007930: 650a 6173 2061 2064 6973 6b20 666f 7220 e.as a disk for │ │ │ │ │ -00007940: 7669 7274 7561 6c20 6d61 6368 696e 652e virtual machine. │ │ │ │ │ -00007950: 2020 596f 7520 6361 6e20 7075 7420 616e You can put an │ │ │ │ │ -00007960: 7920 636f 6d6d 656e 7473 2069 6e20 7468 y comments in th │ │ │ │ │ -00007970: 6520 6669 6c65 2069 660a 6e65 6564 6564 e file if.needed │ │ │ │ │ -00007980: 2c20 6173 2074 6865 2047 5255 4220 7574 , as the GRUB ut │ │ │ │ │ -00007990: 696c 6974 6965 7320 6173 7375 6d65 2074 ilities assume t │ │ │ │ │ -000079a0: 6861 7420 6120 6c69 6e65 2069 7320 6a75 hat a line is ju │ │ │ │ │ -000079b0: 7374 2061 2063 6f6d 6d65 6e74 2069 660a st a comment if. │ │ │ │ │ -000079c0: 7468 6520 6669 7273 7420 6368 6172 6163 the first charac │ │ │ │ │ -000079d0: 7465 7220 6973 2027 2327 2e0a 0a1f 0a46 ter is '#'.....F │ │ │ │ │ -000079e0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -000079f0: 204e 6f64 653a 2042 494f 5320 696e 7374 Node: BIOS inst │ │ │ │ │ -00007a00: 616c 6c61 7469 6f6e 2c20 2050 7265 763a allation, Prev: │ │ │ │ │ -00007a10: 2044 6576 6963 6520 6d61 702c 2020 5570 Device map, Up │ │ │ │ │ -00007a20: 3a20 496e 7374 616c 6c61 7469 6f6e 0a0a : Installation.. │ │ │ │ │ -00007a30: 342e 3420 4249 4f53 2069 6e73 7461 6c6c 4.4 BIOS install │ │ │ │ │ -00007a40: 6174 696f 6e0a 3d3d 3d3d 3d3d 3d3d 3d3d ation.========== │ │ │ │ │ -00007a50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a4d 4252 ===========..MBR │ │ │ │ │ -00007a60: 0a3d 3d3d 0a0a 5468 6520 7061 7274 6974 .===..The partit │ │ │ │ │ -00007a70: 696f 6e20 7461 626c 6520 666f 726d 6174 ion table format │ │ │ │ │ -00007a80: 2074 7261 6469 7469 6f6e 616c 6c79 2075 traditionally u │ │ │ │ │ -00007a90: 7365 6420 6f6e 2050 4320 4249 4f53 2070 sed on PC BIOS p │ │ │ │ │ -00007aa0: 6c61 7466 6f72 6d73 2069 730a 6361 6c6c latforms is.call │ │ │ │ │ -00007ab0: 6564 2074 6865 204d 6173 7465 7220 426f ed the Master Bo │ │ │ │ │ -00007ac0: 6f74 2052 6563 6f72 6420 284d 4252 2920 ot Record (MBR) │ │ │ │ │ -00007ad0: 666f 726d 6174 3b20 7468 6973 2069 7320 format; this is │ │ │ │ │ -00007ae0: 7468 6520 666f 726d 6174 2074 6861 740a the format that. │ │ │ │ │ -00007af0: 616c 6c6f 7773 2075 7020 746f 2066 6f75 allows up to fou │ │ │ │ │ -00007b00: 7220 7072 696d 6172 7920 7061 7274 6974 r primary partit │ │ │ │ │ -00007b10: 696f 6e73 2061 6e64 2061 6464 6974 696f ions and additio │ │ │ │ │ -00007b20: 6e61 6c20 6c6f 6769 6361 6c20 7061 7274 nal logical part │ │ │ │ │ -00007b30: 6974 696f 6e73 2e0a 5769 7468 2074 6869 itions..With thi │ │ │ │ │ -00007b40: 7320 7061 7274 6974 696f 6e20 7461 626c s partition tabl │ │ │ │ │ -00007b50: 6520 666f 726d 6174 2c20 7468 6572 6520 e format, there │ │ │ │ │ -00007b60: 6172 6520 7477 6f20 7761 7973 2074 6f20 are two ways to │ │ │ │ │ -00007b70: 696e 7374 616c 6c20 4752 5542 3a20 6974 install GRUB: it │ │ │ │ │ -00007b80: 0a63 616e 2062 6520 656d 6265 6464 6564 .can be embedded │ │ │ │ │ -00007b90: 2069 6e20 7468 6520 6172 6561 2062 6574 in the area bet │ │ │ │ │ -00007ba0: 7765 656e 2074 6865 204d 4252 2061 6e64 ween the MBR and │ │ │ │ │ -00007bb0: 2074 6865 2066 6972 7374 2070 6172 7469 the first parti │ │ │ │ │ -00007bc0: 7469 6f6e 0a28 6361 6c6c 6564 2062 7920 tion.(called by │ │ │ │ │ -00007bd0: 7661 7269 6f75 7320 6e61 6d65 732c 2073 various names, s │ │ │ │ │ -00007be0: 7563 6820 6173 2074 6865 2022 626f 6f74 uch as the "boot │ │ │ │ │ -00007bf0: 2074 7261 636b 222c 2022 4d42 5220 6761 track", "MBR ga │ │ │ │ │ -00007c00: 7022 2c20 6f72 0a22 656d 6265 6464 696e p", or."embeddin │ │ │ │ │ -00007c10: 6720 6172 6561 222c 2061 6e64 2077 6869 g area", and whi │ │ │ │ │ -00007c20: 6368 2069 7320 7573 7561 6c6c 7920 6174 ch is usually at │ │ │ │ │ -00007c30: 206c 6561 7374 2031 3030 3020 4b69 4229 least 1000 KiB) │ │ │ │ │ -00007c40: 2c20 6f72 2074 6865 2063 6f72 650a 696d , or the core.im │ │ │ │ │ -00007c50: 6167 6520 6361 6e20 6265 2069 6e73 7461 age can be insta │ │ │ │ │ -00007c60: 6c6c 6564 2069 6e20 6120 6669 6c65 2073 lled in a file s │ │ │ │ │ -00007c70: 7973 7465 6d20 616e 6420 6120 6c69 7374 ystem and a list │ │ │ │ │ -00007c80: 206f 6620 7468 6520 626c 6f63 6b73 2074 of the blocks t │ │ │ │ │ -00007c90: 6861 740a 6d61 6b65 2069 7420 7570 2063 hat.make it up c │ │ │ │ │ -00007ca0: 616e 2062 6520 7374 6f72 6564 2069 6e20 an be stored in │ │ │ │ │ -00007cb0: 7468 6520 6669 7273 7420 7365 6374 6f72 the first sector │ │ │ │ │ -00007cc0: 206f 6620 7468 6174 2070 6172 7469 7469 of that partiti │ │ │ │ │ -00007cd0: 6f6e 2e0a 0a20 2020 4d6f 6465 726e 2074 on... Modern t │ │ │ │ │ -00007ce0: 6f6f 6c73 2075 7375 616c 6c79 206c 6561 ools usually lea │ │ │ │ │ -00007cf0: 7665 204d 4252 2067 6170 206f 6620 6174 ve MBR gap of at │ │ │ │ │ -00007d00: 206c 6561 7374 2031 3032 3320 4b69 422e least 1023 KiB. │ │ │ │ │ -00007d10: 2054 6869 7320 616d 6f75 6e74 0a69 7320 This amount.is │ │ │ │ │ -00007d20: 7375 6666 6963 6965 6e74 2074 6f20 636f sufficient to co │ │ │ │ │ -00007d30: 7665 7220 6d6f 7374 2063 6f6e 6669 6775 ver most configu │ │ │ │ │ -00007d40: 7261 7469 6f6e 732e 2020 4865 6e63 6520 rations. Hence │ │ │ │ │ -00007d50: 7468 6973 2076 616c 7565 2069 730a 7265 this value is.re │ │ │ │ │ -00007d60: 636f 6d6d 656e 6465 6420 6279 2074 6865 commended by the │ │ │ │ │ -00007d70: 2047 5255 4220 7465 616d 2e0a 0a20 2020 GRUB team... │ │ │ │ │ -00007d80: 4869 7374 6f72 6963 616c 6c79 206d 616e Historically man │ │ │ │ │ -00007d90: 7920 746f 6f6c 7320 6c65 6674 206f 6e6c y tools left onl │ │ │ │ │ -00007da0: 7920 3331 204b 6942 206f 6620 7370 6163 y 31 KiB of spac │ │ │ │ │ -00007db0: 652e 2020 5468 6973 2069 7320 6e6f 740a e. This is not. │ │ │ │ │ -00007dc0: 656e 6f75 6768 2074 6f20 7061 7273 6520 enough to parse │ │ │ │ │ -00007dd0: 7265 6c69 6162 6c79 2064 6966 6669 6375 reliably difficu │ │ │ │ │ -00007de0: 6c74 2073 7472 7563 7475 7265 7320 6c69 lt structures li │ │ │ │ │ -00007df0: 6b65 2042 7472 6673 2c20 5a46 532c 2052 ke Btrfs, ZFS, R │ │ │ │ │ -00007e00: 4149 4420 6f72 0a4c 564d 2c20 6f72 2074 AID or.LVM, or t │ │ │ │ │ -00007e10: 6f20 7573 6520 6469 6666 6963 756c 7420 o use difficult │ │ │ │ │ -00007e20: 6469 736b 2061 6363 6573 7320 6d65 7468 disk access meth │ │ │ │ │ -00007e30: 6f64 7320 6c69 6b65 2061 6863 692e 2020 ods like ahci. │ │ │ │ │ -00007e40: 4865 6e63 6520 4752 5542 2077 696c 6c0a Hence GRUB will. │ │ │ │ │ -00007e50: 7761 726e 2069 6620 6174 7465 6d70 7465 warn if attempte │ │ │ │ │ -00007e60: 6420 746f 2069 6e73 7461 6c6c 2069 6e74 d to install int │ │ │ │ │ -00007e70: 6f20 736d 616c 6c20 4d42 5220 6761 7020 o small MBR gap │ │ │ │ │ -00007e80: 6578 6365 7074 2069 6e20 6120 736d 616c except in a smal │ │ │ │ │ -00007e90: 6c20 6e75 6d62 6572 0a6f 6620 636f 6e66 l number.of conf │ │ │ │ │ -00007ea0: 6967 7572 6174 696f 6e73 2074 6861 7420 igurations that │ │ │ │ │ -00007eb0: 7765 7265 2067 7261 6e64 6661 7468 6572 were grandfather │ │ │ │ │ -00007ec0: 6564 2e20 2054 6865 2067 7261 6e64 6661 ed. The grandfa │ │ │ │ │ -00007ed0: 7468 6572 6564 2063 6f6e 6669 670a 6d75 thered config.mu │ │ │ │ │ -00007ee0: 7374 3a0a 0a20 2020 2a20 7573 6520 6269 st:.. * use bi │ │ │ │ │ -00007ef0: 6f73 6469 736b 2061 7320 6469 736b 2061 osdisk as disk a │ │ │ │ │ -00007f00: 6363 6573 7320 6d6f 6475 6c65 2066 6f72 ccess module for │ │ │ │ │ -00007f10: 2027 2f62 6f6f 7427 202a 206e 6f74 2075 '/boot' * not u │ │ │ │ │ -00007f20: 7365 2061 6e79 0a61 6464 6974 696f 6e61 se any.additiona │ │ │ │ │ -00007f30: 6c20 7061 7274 6974 696f 6e20 6d61 7073 l partition maps │ │ │ │ │ -00007f40: 2074 6f20 6163 6365 7373 2027 2f62 6f6f to access '/boo │ │ │ │ │ -00007f50: 7427 202a 2027 2f62 6f6f 7427 206d 7573 t' * '/boot' mus │ │ │ │ │ -00007f60: 7420 6265 206f 6e20 6f6e 6520 6f66 0a66 t be on one of.f │ │ │ │ │ -00007f70: 6f6c 6c6f 7769 6e67 2066 696c 6573 7973 ollowing filesys │ │ │ │ │ -00007f80: 7465 6d73 3a20 2a20 4146 4653 2c20 4146 tems: * AFFS, AF │ │ │ │ │ -00007f90: 532c 2042 4653 2c20 6370 696f 2c20 6e65 S, BFS, cpio, ne │ │ │ │ │ -00007fa0: 7763 2c20 6f64 632c 2065 7874 322f 332f wc, odc, ext2/3/ │ │ │ │ │ -00007fb0: 342c 2046 4154 2c0a 6578 4641 542c 2046 4, FAT,.exFAT, F │ │ │ │ │ -00007fc0: 3246 532c 2048 4653 2c20 756e 636f 6d70 2FS, HFS, uncomp │ │ │ │ │ -00007fd0: 7265 7373 6564 2048 4653 2b2c 2049 534f ressed HFS+, ISO │ │ │ │ │ -00007fe0: 3936 3630 2c20 4a46 532c 204d 696e 6978 9660, JFS, Minix │ │ │ │ │ -00007ff0: 2c20 4d69 6e69 7832 2c0a 4d69 6e69 7833 , Minix2,.Minix3 │ │ │ │ │ -00008000: 2c20 4e49 4c46 5332 2c20 4e54 4653 2c20 , NILFS2, NTFS, │ │ │ │ │ -00008010: 5265 6973 6572 4653 2c20 524f 4d46 532c ReiserFS, ROMFS, │ │ │ │ │ -00008020: 2053 4653 2c20 7461 722c 2055 4446 2c20 SFS, tar, UDF, │ │ │ │ │ -00008030: 5546 5331 2c20 5546 5332 2c20 5846 530a UFS1, UFS2, XFS. │ │ │ │ │ -00008040: 0a20 2020 4d42 5220 6761 7020 6861 7320 . MBR gap has │ │ │ │ │ -00008050: 6665 7720 7465 6368 6e69 6361 6c20 7072 few technical pr │ │ │ │ │ -00008060: 6f62 6c65 6d73 2e20 2054 6865 7265 2069 oblems. There i │ │ │ │ │ -00008070: 7320 6e6f 2077 6179 2074 6f20 7265 7365 s no way to rese │ │ │ │ │ -00008080: 7276 6520 7370 6163 650a 696e 2074 6865 rve space.in the │ │ │ │ │ -00008090: 2065 6d62 6564 6469 6e67 2061 7265 6120 embedding area │ │ │ │ │ -000080a0: 7769 7468 2063 6f6d 706c 6574 6520 7361 with complete sa │ │ │ │ │ -000080b0: 6665 7479 2c20 616e 6420 736f 6d65 2070 fety, and some p │ │ │ │ │ -000080c0: 726f 7072 6965 7461 7279 0a73 6f66 7477 roprietary.softw │ │ │ │ │ -000080d0: 6172 6520 6973 206b 6e6f 776e 2074 6f20 are is known to │ │ │ │ │ -000080e0: 7573 6520 6974 2074 6f20 6d61 6b65 2069 use it to make i │ │ │ │ │ -000080f0: 7420 6469 6666 6963 756c 7420 666f 7220 t difficult for │ │ │ │ │ -00008100: 7573 6572 7320 746f 2077 6f72 6b0a 6172 users to work.ar │ │ │ │ │ -00008110: 6f75 6e64 206c 6963 656e 7369 6e67 2072 ound licensing r │ │ │ │ │ -00008120: 6573 7472 6963 7469 6f6e 732e 2020 4752 estrictions. GR │ │ │ │ │ -00008130: 5542 2077 6f72 6b73 2069 7420 6172 6f75 UB works it arou │ │ │ │ │ -00008140: 6e64 2062 7920 6465 7465 6374 696e 670a nd by detecting. │ │ │ │ │ -00008150: 7365 6374 6f72 7320 6279 206f 7468 6572 sectors by other │ │ │ │ │ -00008160: 2073 6f66 7477 6172 6520 616e 6420 6176 software and av │ │ │ │ │ -00008170: 6f69 6469 6e67 2074 6865 6d20 616e 6420 oiding them and │ │ │ │ │ -00008180: 7072 6f74 6563 7469 6e67 2069 7473 206f protecting its o │ │ │ │ │ -00008190: 776e 0a73 6563 746f 7273 2075 7369 6e67 wn.sectors using │ │ │ │ │ -000081a0: 2052 6565 642d 536f 6c6f 6d6f 6e20 656e Reed-Solomon en │ │ │ │ │ -000081b0: 636f 6469 6e67 2e0a 0a20 2020 4752 5542 coding... GRUB │ │ │ │ │ -000081c0: 2074 6561 6d20 7265 636f 6d6d 656e 6473 team recommends │ │ │ │ │ -000081d0: 2068 6176 696e 6720 4d42 5220 6761 7020 having MBR gap │ │ │ │ │ -000081e0: 6f66 2061 7420 6c65 6173 7420 3130 3030 of at least 1000 │ │ │ │ │ -000081f0: 204b 6942 0a0a 2020 2053 686f 756c 6420 KiB.. Should │ │ │ │ │ -00008200: 6974 2062 6520 6e6f 7420 706f 7373 6962 it be not possib │ │ │ │ │ -00008210: 6c65 2047 5255 4220 6861 7320 7375 7070 le GRUB has supp │ │ │ │ │ -00008220: 6f72 7420 666f 7220 6120 6661 6c6c 6261 ort for a fallba │ │ │ │ │ -00008230: 636b 2073 6f6c 7574 696f 6e0a 7768 6963 ck solution.whic │ │ │ │ │ -00008240: 6820 6973 2068 6561 7669 6c79 2072 6563 h is heavily rec │ │ │ │ │ -00008250: 6f6d 6d65 6e64 6564 2061 6761 696e 7374 ommended against │ │ │ │ │ -00008260: 2e20 2049 6e73 7461 6c6c 696e 6720 746f . Installing to │ │ │ │ │ -00008270: 2061 2066 696c 6573 7973 7465 6d20 6d65 a filesystem me │ │ │ │ │ -00008280: 616e 730a 7468 6174 2047 5255 4220 6973 ans.that GRUB is │ │ │ │ │ -00008290: 2076 756c 6e65 7261 626c 6520 746f 2069 vulnerable to i │ │ │ │ │ -000082a0: 7473 2062 6c6f 636b 7320 6265 696e 6720 ts blocks being │ │ │ │ │ -000082b0: 6d6f 7665 6420 6172 6f75 6e64 2062 7920 moved around by │ │ │ │ │ -000082c0: 6669 6c65 7379 7374 656d 0a66 6561 7475 filesystem.featu │ │ │ │ │ -000082d0: 7265 7320 7375 6368 2061 7320 7461 696c res such as tail │ │ │ │ │ -000082e0: 2070 6163 6b69 6e67 2c20 6f72 2065 7665 packing, or eve │ │ │ │ │ -000082f0: 6e20 6279 2061 6767 7265 7373 6976 6520 n by aggressive │ │ │ │ │ -00008300: 6673 636b 0a69 6d70 6c65 6d65 6e74 6174 fsck.implementat │ │ │ │ │ -00008310: 696f 6e73 2c20 736f 2074 6869 7320 6170 ions, so this ap │ │ │ │ │ -00008320: 7072 6f61 6368 2069 7320 7175 6974 6520 proach is quite │ │ │ │ │ -00008330: 6672 6167 696c 653b 2061 6e64 2074 6869 fragile; and thi │ │ │ │ │ -00008340: 7320 6170 7072 6f61 6368 0a63 616e 206f s approach.can o │ │ │ │ │ -00008350: 6e6c 7920 6265 2075 7365 6420 6966 2074 nly be used if t │ │ │ │ │ -00008360: 6865 2027 2f62 6f6f 7427 2066 696c 6573 he '/boot' files │ │ │ │ │ -00008370: 7973 7465 6d20 6973 206f 6e20 7468 6520 ystem is on the │ │ │ │ │ -00008380: 7361 6d65 2064 6973 6b20 7468 6174 2074 same disk that t │ │ │ │ │ -00008390: 6865 0a42 494f 5320 626f 6f74 7320 6672 he.BIOS boots fr │ │ │ │ │ -000083a0: 6f6d 2c20 736f 2074 6861 7420 4752 5542 om, so that GRUB │ │ │ │ │ -000083b0: 2064 6f65 7320 6e6f 7420 6861 7665 2074 does not have t │ │ │ │ │ -000083c0: 6f20 7265 6c79 206f 6e20 6775 6573 7369 o rely on guessi │ │ │ │ │ -000083d0: 6e67 2042 494f 530a 6472 6976 6520 6e75 ng BIOS.drive nu │ │ │ │ │ -000083e0: 6d62 6572 732e 0a0a 2020 2054 6865 2047 mbers... The G │ │ │ │ │ -000083f0: 5255 4220 6465 7665 6c6f 706d 656e 7420 RUB development │ │ │ │ │ -00008400: 7465 616d 2067 656e 6572 616c 6c79 2072 team generally r │ │ │ │ │ -00008410: 6563 6f6d 6d65 6e64 7320 656d 6265 6464 ecommends embedd │ │ │ │ │ -00008420: 696e 6720 4752 5542 2062 6566 6f72 650a ing GRUB before. │ │ │ │ │ -00008430: 7468 6520 6669 7273 7420 7061 7274 6974 the first partit │ │ │ │ │ -00008440: 696f 6e2c 2075 6e6c 6573 7320 796f 7520 ion, unless you │ │ │ │ │ -00008450: 6861 7665 2073 7065 6369 616c 2072 6571 have special req │ │ │ │ │ -00008460: 7569 7265 6d65 6e74 732e 2020 596f 7520 uirements. You │ │ │ │ │ -00008470: 6d75 7374 0a65 6e73 7572 6520 7468 6174 must.ensure that │ │ │ │ │ -00008480: 2074 6865 2066 6972 7374 2070 6172 7469 the first parti │ │ │ │ │ -00008490: 7469 6f6e 2073 7461 7274 7320 6174 206c tion starts at l │ │ │ │ │ -000084a0: 6561 7374 2031 3030 3020 4b69 4220 2832 east 1000 KiB (2 │ │ │ │ │ -000084b0: 3030 3020 7365 6374 6f72 7329 0a66 726f 000 sectors).fro │ │ │ │ │ -000084c0: 6d20 7468 6520 7374 6172 7420 6f66 2074 m the start of t │ │ │ │ │ -000084d0: 6865 2064 6973 6b3b 206f 6e20 6d6f 6465 he disk; on mode │ │ │ │ │ -000084e0: 726e 2064 6973 6b73 2c20 6974 2069 7320 rn disks, it is │ │ │ │ │ -000084f0: 6f66 7465 6e20 6120 7065 7266 6f72 6d61 often a performa │ │ │ │ │ -00008500: 6e63 650a 6164 7661 6e74 6167 6520 746f nce.advantage to │ │ │ │ │ -00008510: 2061 6c69 676e 2070 6172 7469 7469 6f6e align partition │ │ │ │ │ -00008520: 7320 6f6e 206c 6172 6765 7220 626f 756e s on larger boun │ │ │ │ │ -00008530: 6461 7269 6573 2061 6e79 7761 792c 2073 daries anyway, s │ │ │ │ │ -00008540: 6f20 7468 6520 6669 7273 740a 7061 7274 o the first.part │ │ │ │ │ -00008550: 6974 696f 6e20 6d69 6768 7420 7374 6172 ition might star │ │ │ │ │ -00008560: 7420 3120 4d69 4220 6672 6f6d 2074 6865 t 1 MiB from the │ │ │ │ │ -00008570: 2073 7461 7274 206f 6620 7468 6520 6469 start of the di │ │ │ │ │ -00008580: 736b 2e0a 0a47 5054 0a3d 3d3d 0a0a 536f sk...GPT.===..So │ │ │ │ │ -00008590: 6d65 206e 6577 6572 2073 7973 7465 6d73 me newer systems │ │ │ │ │ -000085a0: 2075 7365 2074 6865 2047 5549 4420 5061 use the GUID Pa │ │ │ │ │ -000085b0: 7274 6974 696f 6e20 5461 626c 6520 2847 rtition Table (G │ │ │ │ │ -000085c0: 5054 2920 666f 726d 6174 2e20 2054 6869 PT) format. Thi │ │ │ │ │ -000085d0: 7320 7761 730a 7370 6563 6966 6965 6420 s was.specified │ │ │ │ │ -000085e0: 6173 2070 6172 7420 6f66 2074 6865 2045 as part of the E │ │ │ │ │ -000085f0: 7874 656e 7369 626c 6520 4669 726d 7761 xtensible Firmwa │ │ │ │ │ -00008600: 7265 2049 6e74 6572 6661 6365 2028 4546 re Interface (EF │ │ │ │ │ -00008610: 4929 2c20 6275 7420 6974 2063 616e 0a61 I), but it can.a │ │ │ │ │ -00008620: 6c73 6f20 6265 2075 7365 6420 6f6e 2042 lso be used on B │ │ │ │ │ -00008630: 494f 5320 706c 6174 666f 726d 7320 6966 IOS platforms if │ │ │ │ │ -00008640: 2073 7973 7465 6d20 736f 6674 7761 7265 system software │ │ │ │ │ -00008650: 2073 7570 706f 7274 7320 6974 3b20 666f supports it; fo │ │ │ │ │ -00008660: 720a 6578 616d 706c 652c 2047 5255 4220 r.example, GRUB │ │ │ │ │ -00008670: 616e 6420 474e 552f 4c69 6e75 7820 6361 and GNU/Linux ca │ │ │ │ │ -00008680: 6e20 6265 2075 7365 6420 696e 2074 6869 n be used in thi │ │ │ │ │ -00008690: 7320 636f 6e66 6967 7572 6174 696f 6e2e s configuration. │ │ │ │ │ -000086a0: 2020 5769 7468 0a74 6869 7320 666f 726d With.this form │ │ │ │ │ -000086b0: 6174 2c20 6974 2069 7320 706f 7373 6962 at, it is possib │ │ │ │ │ -000086c0: 6c65 2074 6f20 7265 7365 7276 6520 6120 le to reserve a │ │ │ │ │ -000086d0: 7768 6f6c 6520 7061 7274 6974 696f 6e20 whole partition │ │ │ │ │ -000086e0: 666f 7220 4752 5542 2c0a 6361 6c6c 6564 for GRUB,.called │ │ │ │ │ -000086f0: 2074 6865 2042 494f 5320 426f 6f74 2050 the BIOS Boot P │ │ │ │ │ -00008700: 6172 7469 7469 6f6e 2e20 2047 5255 4220 artition. GRUB │ │ │ │ │ -00008710: 6361 6e20 7468 656e 2062 6520 656d 6265 can then be embe │ │ │ │ │ -00008720: 6464 6564 2069 6e74 6f20 7468 6174 0a70 dded into that.p │ │ │ │ │ -00008730: 6172 7469 7469 6f6e 2077 6974 686f 7574 artition without │ │ │ │ │ -00008740: 2074 6865 2072 6973 6b20 6f66 2062 6569 the risk of bei │ │ │ │ │ -00008750: 6e67 206f 7665 7277 7269 7474 656e 2062 ng overwritten b │ │ │ │ │ -00008760: 7920 6f74 6865 7220 736f 6674 7761 7265 y other software │ │ │ │ │ -00008770: 2061 6e64 0a77 6974 686f 7574 2062 6569 and.without bei │ │ │ │ │ -00008780: 6e67 2063 6f6e 7461 696e 6564 2069 6e20 ng contained in │ │ │ │ │ -00008790: 6120 6669 6c65 7379 7374 656d 2077 6869 a filesystem whi │ │ │ │ │ -000087a0: 6368 206d 6967 6874 206d 6f76 6520 6974 ch might move it │ │ │ │ │ -000087b0: 7320 626c 6f63 6b73 0a61 726f 756e 642e s blocks.around. │ │ │ │ │ -000087c0: 0a0a 2020 2057 6865 6e20 6372 6561 7469 .. When creati │ │ │ │ │ -000087d0: 6e67 2061 2042 494f 5320 426f 6f74 2050 ng a BIOS Boot P │ │ │ │ │ -000087e0: 6172 7469 7469 6f6e 206f 6e20 6120 4750 artition on a GP │ │ │ │ │ -000087f0: 5420 7379 7374 656d 2c20 796f 7520 7368 T system, you sh │ │ │ │ │ -00008800: 6f75 6c64 206d 616b 650a 7375 7265 2074 ould make.sure t │ │ │ │ │ -00008810: 6861 7420 6974 2069 7320 6174 206c 6561 hat it is at lea │ │ │ │ │ -00008820: 7374 2033 3120 4b69 4220 696e 2073 697a st 31 KiB in siz │ │ │ │ │ -00008830: 652e 2020 2847 5054 2d66 6f72 6d61 7474 e. (GPT-formatt │ │ │ │ │ -00008840: 6564 2064 6973 6b73 2061 7265 206e 6f74 ed disks are not │ │ │ │ │ -00008850: 0a75 7375 616c 6c79 2070 6172 7469 6375 .usually particu │ │ │ │ │ -00008860: 6c61 726c 7920 736d 616c 6c2c 2073 6f20 larly small, so │ │ │ │ │ -00008870: 7765 2072 6563 6f6d 6d65 6e64 2074 6861 we recommend tha │ │ │ │ │ -00008880: 7420 796f 7520 6d61 6b65 2069 7420 6c61 t you make it la │ │ │ │ │ -00008890: 7267 6572 2074 6861 6e0a 7468 6520 6261 rger than.the ba │ │ │ │ │ -000088a0: 7265 206d 696e 696d 756d 2c20 7375 6368 re minimum, such │ │ │ │ │ -000088b0: 2061 7320 3120 4d69 422c 2074 6f20 616c as 1 MiB, to al │ │ │ │ │ -000088c0: 6c6f 7720 706c 656e 7479 206f 6620 726f low plenty of ro │ │ │ │ │ -000088d0: 6f6d 2066 6f72 2067 726f 7774 682e 290a om for growth.). │ │ │ │ │ -000088e0: 596f 7520 6d75 7374 2061 6c73 6f20 6d61 You must also ma │ │ │ │ │ -000088f0: 6b65 2073 7572 6520 7468 6174 2069 7420 ke sure that it │ │ │ │ │ -00008900: 6861 7320 7468 6520 7072 6f70 6572 2070 has the proper p │ │ │ │ │ -00008910: 6172 7469 7469 6f6e 2074 7970 652e 2020 artition type. │ │ │ │ │ -00008920: 5573 696e 670a 474e 5520 5061 7274 6564 Using.GNU Parted │ │ │ │ │ -00008930: 2c20 796f 7520 6361 6e20 7365 7420 7468 , you can set th │ │ │ │ │ -00008940: 6973 2075 7369 6e67 2061 2063 6f6d 6d61 is using a comma │ │ │ │ │ -00008950: 6e64 2073 7563 6820 6173 2074 6865 2066 nd such as the f │ │ │ │ │ -00008960: 6f6c 6c6f 7769 6e67 3a0a 0a20 2020 2020 ollowing:.. │ │ │ │ │ -00008970: 2320 7061 7274 6564 202f 6465 762f 4449 # parted /dev/DI │ │ │ │ │ -00008980: 534b 2073 6574 2050 4152 5449 5449 4f4e SK set PARTITION │ │ │ │ │ -00008990: 2d4e 554d 4245 5220 6269 6f73 5f67 7275 -NUMBER bios_gru │ │ │ │ │ -000089a0: 6220 6f6e 0a0a 2020 2049 6620 796f 7520 b on.. If you │ │ │ │ │ -000089b0: 6172 6520 7573 696e 6720 6764 6973 6b2c are using gdisk, │ │ │ │ │ -000089c0: 2073 6574 2074 6865 2070 6172 7469 7469 set the partiti │ │ │ │ │ -000089d0: 6f6e 2074 7970 6520 746f 2027 3078 4546 on type to '0xEF │ │ │ │ │ -000089e0: 3032 272e 2020 5769 7468 0a70 6172 7469 02'. With.parti │ │ │ │ │ -000089f0: 7469 6f6e 696e 6720 7072 6f67 7261 6d73 tioning programs │ │ │ │ │ -00008a00: 2074 6861 7420 7265 7175 6972 6520 7365 that require se │ │ │ │ │ -00008a10: 7474 696e 6720 7468 6520 4755 4944 2064 tting the GUID d │ │ │ │ │ -00008a20: 6972 6563 746c 792c 2069 7420 7368 6f75 irectly, it shou │ │ │ │ │ -00008a30: 6c64 0a62 6520 2732 3136 3836 3134 382d ld.be '21686148- │ │ │ │ │ -00008a40: 3634 3439 2d36 6536 662d 3734 3465 3635 6449-6e6f-744e65 │ │ │ │ │ -00008a50: 3635 3634 3435 3436 3439 272e 0a0a 2020 6564454649'... │ │ │ │ │ -00008a60: 202a 4361 7574 696f 6e3a 2a20 4265 2076 *Caution:* Be v │ │ │ │ │ -00008a70: 6572 7920 6361 7265 6675 6c20 7768 6963 ery careful whic │ │ │ │ │ -00008a80: 6820 7061 7274 6974 696f 6e20 796f 7520 h partition you │ │ │ │ │ -00008a90: 7365 6c65 6374 2120 2057 6865 6e20 4752 select! When GR │ │ │ │ │ -00008aa0: 5542 0a66 696e 6473 2061 2042 494f 5320 UB.finds a BIOS │ │ │ │ │ -00008ab0: 426f 6f74 2050 6172 7469 7469 6f6e 2064 Boot Partition d │ │ │ │ │ -00008ac0: 7572 696e 6720 696e 7374 616c 6c61 7469 uring installati │ │ │ │ │ -00008ad0: 6f6e 2c20 6974 2077 696c 6c20 6175 746f on, it will auto │ │ │ │ │ -00008ae0: 6d61 7469 6361 6c6c 790a 6f76 6572 7772 matically.overwr │ │ │ │ │ -00008af0: 6974 6520 7061 7274 206f 6620 6974 2e20 ite part of it. │ │ │ │ │ -00008b00: 204d 616b 6520 7375 7265 2074 6861 7420 Make sure that │ │ │ │ │ -00008b10: 7468 6520 7061 7274 6974 696f 6e20 646f the partition do │ │ │ │ │ -00008b20: 6573 206e 6f74 2063 6f6e 7461 696e 2061 es not contain a │ │ │ │ │ -00008b30: 6e79 0a6f 7468 6572 2064 6174 612e 0a0a ny.other data... │ │ │ │ │ -00008b40: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00008b50: 6f2c 2020 4e6f 6465 3a20 426f 6f74 696e o, Node: Bootin │ │ │ │ │ -00008b60: 672c 2020 4e65 7874 3a20 436f 6e66 6967 g, Next: Config │ │ │ │ │ -00008b70: 7572 6174 696f 6e2c 2020 5072 6576 3a20 uration, Prev: │ │ │ │ │ -00008b80: 496e 7374 616c 6c61 7469 6f6e 2c20 2055 Installation, U │ │ │ │ │ -00008b90: 703a 2054 6f70 0a0a 3520 426f 6f74 696e p: Top..5 Bootin │ │ │ │ │ -00008ba0: 670a 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 5255 g.*********..GRU │ │ │ │ │ -00008bb0: 4220 6361 6e20 6c6f 6164 204d 756c 7469 B can load Multi │ │ │ │ │ -00008bc0: 626f 6f74 2d63 6f6d 706c 6961 6e74 206b boot-compliant k │ │ │ │ │ -00008bd0: 6572 6e65 6c73 2069 6e20 6120 636f 6e73 ernels in a cons │ │ │ │ │ -00008be0: 6973 7465 6e74 2077 6179 2c20 6275 7420 istent way, but │ │ │ │ │ -00008bf0: 666f 720a 736f 6d65 2066 7265 6520 6f70 for.some free op │ │ │ │ │ -00008c00: 6572 6174 696e 6720 7379 7374 656d 7320 erating systems │ │ │ │ │ -00008c10: 796f 7520 6e65 6564 2074 6f20 7573 6520 you need to use │ │ │ │ │ -00008c20: 736f 6d65 204f 532d 7370 6563 6966 6963 some OS-specific │ │ │ │ │ -00008c30: 206d 6167 6963 2e0a 0a2a 204d 656e 753a magic...* Menu: │ │ │ │ │ -00008c40: 0a0a 2a20 4765 6e65 7261 6c20 626f 6f74 ..* General boot │ │ │ │ │ -00008c50: 206d 6574 686f 6473 3a3a 2020 2020 2020 methods:: │ │ │ │ │ -00008c60: 2020 486f 7720 746f 2062 6f6f 7420 4f53 How to boot OS │ │ │ │ │ -00008c70: 6573 2077 6974 6820 4752 5542 2067 656e es with GRUB gen │ │ │ │ │ -00008c80: 6572 616c 6c79 0a2a 204c 6f6f 7062 6163 erally.* Loopbac │ │ │ │ │ -00008c90: 6b20 626f 6f74 696e 673a 3a20 2020 2020 k booting:: │ │ │ │ │ -00008ca0: 2020 2020 2020 204e 6f74 6573 206f 6e20 Notes on │ │ │ │ │ -00008cb0: 626f 6f74 696e 6720 6672 6f6d 206c 6f6f booting from loo │ │ │ │ │ -00008cc0: 7062 6163 6b73 0a2a 204c 564d 2063 6163 pbacks.* LVM cac │ │ │ │ │ -00008cd0: 6865 2062 6f6f 7469 6e67 3a3a 2020 2020 he booting:: │ │ │ │ │ -00008ce0: 2020 2020 2020 204e 6f74 6573 206f 6e20 Notes on │ │ │ │ │ -00008cf0: 626f 6f74 696e 6720 6672 6f6d 204c 564d booting from LVM │ │ │ │ │ -00008d00: 2063 6163 6865 206c 6f67 6963 616c 2076 cache logical v │ │ │ │ │ -00008d10: 6f6c 756d 650a 2a20 4f53 2d73 7065 6369 olume.* OS-speci │ │ │ │ │ -00008d20: 6669 6320 6e6f 7465 733a 3a20 2020 2020 fic notes:: │ │ │ │ │ -00008d30: 2020 2020 2020 4e6f 7465 7320 6f6e 2073 Notes on s │ │ │ │ │ -00008d40: 6f6d 6520 6f70 6572 6174 696e 6720 7379 ome operating sy │ │ │ │ │ -00008d50: 7374 656d 730a 0a1f 0a46 696c 653a 2067 stems....File: g │ │ │ │ │ -00008d60: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00008d70: 2047 656e 6572 616c 2062 6f6f 7420 6d65 General boot me │ │ │ │ │ -00008d80: 7468 6f64 732c 2020 4e65 7874 3a20 4c6f thods, Next: Lo │ │ │ │ │ -00008d90: 6f70 6261 636b 2062 6f6f 7469 6e67 2c20 opback booting, │ │ │ │ │ -00008da0: 2055 703a 2042 6f6f 7469 6e67 0a0a 352e Up: Booting..5. │ │ │ │ │ -00008db0: 3120 486f 7720 746f 2062 6f6f 7420 6f70 1 How to boot op │ │ │ │ │ -00008dc0: 6572 6174 696e 6720 7379 7374 656d 730a erating systems. │ │ │ │ │ -00008dd0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00007300: 3d3d 3d3d 3d3d 0a0a 4966 2074 6865 2064 ======..If the d │ │ │ │ │ +00007310: 6576 6963 6520 6d61 7020 6669 6c65 2065 evice map file e │ │ │ │ │ +00007320: 7869 7374 732c 2074 6865 2047 5255 4220 xists, the GRUB │ │ │ │ │ +00007330: 7574 696c 6974 6965 7320 2827 6772 7562 utilities ('grub │ │ │ │ │ +00007340: 2d70 726f 6265 272c 2065 7463 2e29 0a72 -probe', etc.).r │ │ │ │ │ +00007350: 6561 6420 6974 2074 6f20 6d61 7020 4249 ead it to map BI │ │ │ │ │ +00007360: 4f53 2064 7269 7665 7320 746f 204f 5320 OS drives to OS │ │ │ │ │ +00007370: 6465 7669 6365 732e 2020 5468 6973 2066 devices. This f │ │ │ │ │ +00007380: 696c 6520 636f 6e73 6973 7473 206f 6620 ile consists of │ │ │ │ │ +00007390: 6c69 6e65 730a 6c69 6b65 2074 6869 733a lines.like this: │ │ │ │ │ +000073a0: 0a0a 2020 2020 2028 4445 5649 4345 2920 .. (DEVICE) │ │ │ │ │ +000073b0: 4649 4c45 0a0a 2020 2044 4556 4943 4520 FILE.. DEVICE │ │ │ │ │ +000073c0: 6973 2061 2064 7269 7665 2073 7065 6369 is a drive speci │ │ │ │ │ +000073d0: 6669 6564 2069 6e20 7468 6520 4752 5542 fied in the GRUB │ │ │ │ │ +000073e0: 2073 796e 7461 7820 282a 6e6f 7465 2044 syntax (*note D │ │ │ │ │ +000073f0: 6576 6963 650a 7379 6e74 6178 3a3a 292c evice.syntax::), │ │ │ │ │ +00007400: 2061 6e64 2046 494c 4520 6973 2061 6e20 and FILE is an │ │ │ │ │ +00007410: 4f53 2066 696c 652c 2077 6869 6368 2069 OS file, which i │ │ │ │ │ +00007420: 7320 6e6f 726d 616c 6c79 2061 2064 6576 s normally a dev │ │ │ │ │ +00007430: 6963 6520 6669 6c65 2e0a 0a20 2020 4869 ice file... Hi │ │ │ │ │ +00007440: 7374 6f72 6963 616c 6c79 2c20 7468 6520 storically, the │ │ │ │ │ +00007450: 6465 7669 6365 206d 6170 2066 696c 6520 device map file │ │ │ │ │ +00007460: 7761 7320 7573 6564 2062 6563 6175 7365 was used because │ │ │ │ │ +00007470: 2047 5255 4220 6465 7669 6365 206e 616d GRUB device nam │ │ │ │ │ +00007480: 6573 0a68 6164 2074 6f20 6265 2075 7365 es.had to be use │ │ │ │ │ +00007490: 6420 696e 2074 6865 2063 6f6e 6669 6775 d in the configu │ │ │ │ │ +000074a0: 7261 7469 6f6e 2066 696c 652c 2061 6e64 ration file, and │ │ │ │ │ +000074b0: 2074 6865 7920 7765 7265 2064 6572 6976 they were deriv │ │ │ │ │ +000074c0: 6564 2066 726f 6d0a 4249 4f53 2064 7269 ed from.BIOS dri │ │ │ │ │ +000074d0: 7665 206e 756d 6265 7273 2e20 2054 6865 ve numbers. The │ │ │ │ │ +000074e0: 206d 6170 2062 6574 7765 656e 2042 494f map between BIO │ │ │ │ │ +000074f0: 5320 6472 6976 6573 2061 6e64 204f 5320 S drives and OS │ │ │ │ │ +00007500: 6465 7669 6365 7320 6361 6e6e 6f74 0a61 devices cannot.a │ │ │ │ │ +00007510: 6c77 6179 7320 6265 2067 7565 7373 6564 lways be guessed │ │ │ │ │ +00007520: 2063 6f72 7265 6374 6c79 3a20 666f 7220 correctly: for │ │ │ │ │ +00007530: 6578 616d 706c 652c 2047 5255 4220 7769 example, GRUB wi │ │ │ │ │ +00007540: 6c6c 2067 6574 2074 6865 206f 7264 6572 ll get the order │ │ │ │ │ +00007550: 2077 726f 6e67 0a69 6620 796f 7520 6578 wrong.if you ex │ │ │ │ │ +00007560: 6368 616e 6765 2074 6865 2062 6f6f 7420 change the boot │ │ │ │ │ +00007570: 7365 7175 656e 6365 2062 6574 7765 656e sequence between │ │ │ │ │ +00007580: 2049 4445 2061 6e64 2053 4353 4920 696e IDE and SCSI in │ │ │ │ │ +00007590: 2079 6f75 7220 4249 4f53 2e0a 0a20 2020 your BIOS... │ │ │ │ │ +000075a0: 556e 666f 7274 756e 6174 656c 792c 2065 Unfortunately, e │ │ │ │ │ +000075b0: 7665 6e20 4f53 2064 6576 6963 6520 6e61 ven OS device na │ │ │ │ │ +000075c0: 6d65 7320 6172 6520 6e6f 7420 616c 7761 mes are not alwa │ │ │ │ │ +000075d0: 7973 2073 7461 626c 652e 2020 4d6f 6465 ys stable. Mode │ │ │ │ │ +000075e0: 726e 0a76 6572 7369 6f6e 7320 6f66 2074 rn.versions of t │ │ │ │ │ +000075f0: 6865 204c 696e 7578 206b 6572 6e65 6c20 he Linux kernel │ │ │ │ │ +00007600: 6d61 7920 7072 6f62 6520 6472 6976 6573 may probe drives │ │ │ │ │ +00007610: 2069 6e20 6120 6469 6666 6572 656e 7420 in a different │ │ │ │ │ +00007620: 6f72 6465 7220 6672 6f6d 0a62 6f6f 7420 order from.boot │ │ │ │ │ +00007630: 746f 2062 6f6f 742c 2061 6e64 2074 6865 to boot, and the │ │ │ │ │ +00007640: 2070 7265 6669 7820 2827 2f64 6576 2f68 prefix ('/dev/h │ │ │ │ │ +00007650: 642a 2720 7665 7273 7573 2027 2f64 6576 d*' versus '/dev │ │ │ │ │ +00007660: 2f73 642a 2729 206d 6179 2063 6861 6e67 /sd*') may chang │ │ │ │ │ +00007670: 650a 6465 7065 6e64 696e 6720 6f6e 2074 e.depending on t │ │ │ │ │ +00007680: 6865 2064 7269 7665 7220 7375 6273 7973 he driver subsys │ │ │ │ │ +00007690: 7465 6d20 696e 2075 7365 2e20 2041 7320 tem in use. As │ │ │ │ │ +000076a0: 6120 7265 7375 6c74 2c20 7468 6520 6465 a result, the de │ │ │ │ │ +000076b0: 7669 6365 206d 6170 0a66 696c 6520 7265 vice map.file re │ │ │ │ │ +000076c0: 7175 6972 6564 2066 7265 7175 656e 7420 quired frequent │ │ │ │ │ +000076d0: 6564 6974 696e 6720 6f6e 2073 6f6d 6520 editing on some │ │ │ │ │ +000076e0: 7379 7374 656d 732e 0a0a 2020 2047 5255 systems... GRU │ │ │ │ │ +000076f0: 4220 6176 6f69 6473 2074 6869 7320 7072 B avoids this pr │ │ │ │ │ +00007700: 6f62 6c65 6d20 6e6f 7761 6461 7973 2062 oblem nowadays b │ │ │ │ │ +00007710: 7920 7573 696e 6720 5555 4944 7320 6f72 y using UUIDs or │ │ │ │ │ +00007720: 2066 696c 6520 7379 7374 656d 0a6c 6162 file system.lab │ │ │ │ │ +00007730: 656c 7320 7768 656e 2067 656e 6572 6174 els when generat │ │ │ │ │ +00007740: 696e 6720 2767 7275 622e 6366 6727 2c20 ing 'grub.cfg', │ │ │ │ │ +00007750: 616e 6420 7765 2061 6476 6973 6520 7468 and we advise th │ │ │ │ │ +00007760: 6174 2079 6f75 2064 6f20 7468 6520 7361 at you do the sa │ │ │ │ │ +00007770: 6d65 0a66 6f72 2061 6e79 2063 7573 746f me.for any custo │ │ │ │ │ +00007780: 6d20 6d65 6e75 2065 6e74 7269 6573 2079 m menu entries y │ │ │ │ │ +00007790: 6f75 2077 7269 7465 2e20 2049 6620 7468 ou write. If th │ │ │ │ │ +000077a0: 6520 6465 7669 6365 206d 6170 2066 696c e device map fil │ │ │ │ │ +000077b0: 6520 646f 6573 206e 6f74 0a65 7869 7374 e does not.exist │ │ │ │ │ +000077c0: 2c20 7468 656e 2074 6865 2047 5255 4220 , then the GRUB │ │ │ │ │ +000077d0: 7574 696c 6974 6965 7320 7769 6c6c 2061 utilities will a │ │ │ │ │ +000077e0: 7373 756d 6520 6120 7465 6d70 6f72 6172 ssume a temporar │ │ │ │ │ +000077f0: 7920 6465 7669 6365 206d 6170 206f 6e20 y device map on │ │ │ │ │ +00007800: 7468 650a 666c 792e 2020 5468 6973 2069 the.fly. This i │ │ │ │ │ +00007810: 7320 6f66 7465 6e20 676f 6f64 2065 6e6f s often good eno │ │ │ │ │ +00007820: 7567 682c 2070 6172 7469 6375 6c61 726c ugh, particularl │ │ │ │ │ +00007830: 7920 696e 2074 6865 2063 6f6d 6d6f 6e20 y in the common │ │ │ │ │ +00007840: 6361 7365 206f 660a 7369 6e67 6c65 2d64 case of.single-d │ │ │ │ │ +00007850: 6973 6b20 7379 7374 656d 732e 0a0a 2020 isk systems... │ │ │ │ │ +00007860: 2048 6f77 6576 6572 2c20 7468 6520 6465 However, the de │ │ │ │ │ +00007870: 7669 6365 206d 6170 2066 696c 6520 6973 vice map file is │ │ │ │ │ +00007880: 206e 6f74 2065 6e74 6972 656c 7920 6f62 not entirely ob │ │ │ │ │ +00007890: 736f 6c65 7465 2079 6574 2c20 616e 6420 solete yet, and │ │ │ │ │ +000078a0: 6974 2069 730a 7573 6564 2066 6f72 206f it is.used for o │ │ │ │ │ +000078b0: 7665 7272 6964 696e 6720 7768 656e 2063 verriding when c │ │ │ │ │ +000078c0: 7572 7265 6e74 2065 6e76 6972 6f6e 6d65 urrent environme │ │ │ │ │ +000078d0: 6e74 2069 7320 6469 6666 6572 656e 7420 nt is different │ │ │ │ │ +000078e0: 6672 6f6d 2074 6865 206f 6e65 0a6f 6e20 from the one.on │ │ │ │ │ +000078f0: 626f 6f74 2e20 204d 6f73 7420 636f 6d6d boot. Most comm │ │ │ │ │ +00007900: 6f6e 2063 6173 6520 6973 2069 6620 796f on case is if yo │ │ │ │ │ +00007910: 7520 7573 6520 6120 7061 7274 6974 696f u use a partitio │ │ │ │ │ +00007920: 6e20 6f72 206c 6f67 6963 616c 2076 6f6c n or logical vol │ │ │ │ │ +00007930: 756d 650a 6173 2061 2064 6973 6b20 666f ume.as a disk fo │ │ │ │ │ +00007940: 7220 7669 7274 7561 6c20 6d61 6368 696e r virtual machin │ │ │ │ │ +00007950: 652e 2020 596f 7520 6361 6e20 7075 7420 e. You can put │ │ │ │ │ +00007960: 616e 7920 636f 6d6d 656e 7473 2069 6e20 any comments in │ │ │ │ │ +00007970: 7468 6520 6669 6c65 2069 660a 6e65 6564 the file if.need │ │ │ │ │ +00007980: 6564 2c20 6173 2074 6865 2047 5255 4220 ed, as the GRUB │ │ │ │ │ +00007990: 7574 696c 6974 6965 7320 6173 7375 6d65 utilities assume │ │ │ │ │ +000079a0: 2074 6861 7420 6120 6c69 6e65 2069 7320 that a line is │ │ │ │ │ +000079b0: 6a75 7374 2061 2063 6f6d 6d65 6e74 2069 just a comment i │ │ │ │ │ +000079c0: 660a 7468 6520 6669 7273 7420 6368 6172 f.the first char │ │ │ │ │ +000079d0: 6163 7465 7220 6973 2027 2327 2e0a 0a1f acter is '#'.... │ │ │ │ │ +000079e0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +000079f0: 2c20 204e 6f64 653a 2042 494f 5320 696e , Node: BIOS in │ │ │ │ │ +00007a00: 7374 616c 6c61 7469 6f6e 2c20 2050 7265 stallation, Pre │ │ │ │ │ +00007a10: 763a 2044 6576 6963 6520 6d61 702c 2020 v: Device map, │ │ │ │ │ +00007a20: 5570 3a20 496e 7374 616c 6c61 7469 6f6e Up: Installation │ │ │ │ │ +00007a30: 0a0a 342e 3420 4249 4f53 2069 6e73 7461 ..4.4 BIOS insta │ │ │ │ │ +00007a40: 6c6c 6174 696f 6e0a 3d3d 3d3d 3d3d 3d3d llation.======== │ │ │ │ │ +00007a50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a4d =============..M │ │ │ │ │ +00007a60: 4252 0a3d 3d3d 0a0a 5468 6520 7061 7274 BR.===..The part │ │ │ │ │ +00007a70: 6974 696f 6e20 7461 626c 6520 666f 726d ition table form │ │ │ │ │ +00007a80: 6174 2074 7261 6469 7469 6f6e 616c 6c79 at traditionally │ │ │ │ │ +00007a90: 2075 7365 6420 6f6e 2050 4320 4249 4f53 used on PC BIOS │ │ │ │ │ +00007aa0: 2070 6c61 7466 6f72 6d73 2069 730a 6361 platforms is.ca │ │ │ │ │ +00007ab0: 6c6c 6564 2074 6865 204d 6173 7465 7220 lled the Master │ │ │ │ │ +00007ac0: 426f 6f74 2052 6563 6f72 6420 284d 4252 Boot Record (MBR │ │ │ │ │ +00007ad0: 2920 666f 726d 6174 3b20 7468 6973 2069 ) format; this i │ │ │ │ │ +00007ae0: 7320 7468 6520 666f 726d 6174 2074 6861 s the format tha │ │ │ │ │ +00007af0: 740a 616c 6c6f 7773 2075 7020 746f 2066 t.allows up to f │ │ │ │ │ +00007b00: 6f75 7220 7072 696d 6172 7920 7061 7274 our primary part │ │ │ │ │ +00007b10: 6974 696f 6e73 2061 6e64 2061 6464 6974 itions and addit │ │ │ │ │ +00007b20: 696f 6e61 6c20 6c6f 6769 6361 6c20 7061 ional logical pa │ │ │ │ │ +00007b30: 7274 6974 696f 6e73 2e0a 5769 7468 2074 rtitions..With t │ │ │ │ │ +00007b40: 6869 7320 7061 7274 6974 696f 6e20 7461 his partition ta │ │ │ │ │ +00007b50: 626c 6520 666f 726d 6174 2c20 7468 6572 ble format, ther │ │ │ │ │ +00007b60: 6520 6172 6520 7477 6f20 7761 7973 2074 e are two ways t │ │ │ │ │ +00007b70: 6f20 696e 7374 616c 6c20 4752 5542 3a20 o install GRUB: │ │ │ │ │ +00007b80: 6974 0a63 616e 2062 6520 656d 6265 6464 it.can be embedd │ │ │ │ │ +00007b90: 6564 2069 6e20 7468 6520 6172 6561 2062 ed in the area b │ │ │ │ │ +00007ba0: 6574 7765 656e 2074 6865 204d 4252 2061 etween the MBR a │ │ │ │ │ +00007bb0: 6e64 2074 6865 2066 6972 7374 2070 6172 nd the first par │ │ │ │ │ +00007bc0: 7469 7469 6f6e 0a28 6361 6c6c 6564 2062 tition.(called b │ │ │ │ │ +00007bd0: 7920 7661 7269 6f75 7320 6e61 6d65 732c y various names, │ │ │ │ │ +00007be0: 2073 7563 6820 6173 2074 6865 2022 626f such as the "bo │ │ │ │ │ +00007bf0: 6f74 2074 7261 636b 222c 2022 4d42 5220 ot track", "MBR │ │ │ │ │ +00007c00: 6761 7022 2c20 6f72 0a22 656d 6265 6464 gap", or."embedd │ │ │ │ │ +00007c10: 696e 6720 6172 6561 222c 2061 6e64 2077 ing area", and w │ │ │ │ │ +00007c20: 6869 6368 2069 7320 7573 7561 6c6c 7920 hich is usually │ │ │ │ │ +00007c30: 6174 206c 6561 7374 2031 3030 3020 4b69 at least 1000 Ki │ │ │ │ │ +00007c40: 4229 2c20 6f72 2074 6865 2063 6f72 650a B), or the core. │ │ │ │ │ +00007c50: 696d 6167 6520 6361 6e20 6265 2069 6e73 image can be ins │ │ │ │ │ +00007c60: 7461 6c6c 6564 2069 6e20 6120 6669 6c65 talled in a file │ │ │ │ │ +00007c70: 2073 7973 7465 6d20 616e 6420 6120 6c69 system and a li │ │ │ │ │ +00007c80: 7374 206f 6620 7468 6520 626c 6f63 6b73 st of the blocks │ │ │ │ │ +00007c90: 2074 6861 740a 6d61 6b65 2069 7420 7570 that.make it up │ │ │ │ │ +00007ca0: 2063 616e 2062 6520 7374 6f72 6564 2069 can be stored i │ │ │ │ │ +00007cb0: 6e20 7468 6520 6669 7273 7420 7365 6374 n the first sect │ │ │ │ │ +00007cc0: 6f72 206f 6620 7468 6174 2070 6172 7469 or of that parti │ │ │ │ │ +00007cd0: 7469 6f6e 2e0a 0a20 2020 4d6f 6465 726e tion... Modern │ │ │ │ │ +00007ce0: 2074 6f6f 6c73 2075 7375 616c 6c79 206c tools usually l │ │ │ │ │ +00007cf0: 6561 7665 204d 4252 2067 6170 206f 6620 eave MBR gap of │ │ │ │ │ +00007d00: 6174 206c 6561 7374 2031 3032 3320 4b69 at least 1023 Ki │ │ │ │ │ +00007d10: 422e 2054 6869 7320 616d 6f75 6e74 0a69 B. This amount.i │ │ │ │ │ +00007d20: 7320 7375 6666 6963 6965 6e74 2074 6f20 s sufficient to │ │ │ │ │ +00007d30: 636f 7665 7220 6d6f 7374 2063 6f6e 6669 cover most confi │ │ │ │ │ +00007d40: 6775 7261 7469 6f6e 732e 2020 4865 6e63 gurations. Henc │ │ │ │ │ +00007d50: 6520 7468 6973 2076 616c 7565 2069 730a e this value is. │ │ │ │ │ +00007d60: 7265 636f 6d6d 656e 6465 6420 6279 2074 recommended by t │ │ │ │ │ +00007d70: 6865 2047 5255 4220 7465 616d 2e0a 0a20 he GRUB team... │ │ │ │ │ +00007d80: 2020 4869 7374 6f72 6963 616c 6c79 206d Historically m │ │ │ │ │ +00007d90: 616e 7920 746f 6f6c 7320 6c65 6674 206f any tools left o │ │ │ │ │ +00007da0: 6e6c 7920 3331 204b 6942 206f 6620 7370 nly 31 KiB of sp │ │ │ │ │ +00007db0: 6163 652e 2020 5468 6973 2069 7320 6e6f ace. This is no │ │ │ │ │ +00007dc0: 740a 656e 6f75 6768 2074 6f20 7061 7273 t.enough to pars │ │ │ │ │ +00007dd0: 6520 7265 6c69 6162 6c79 2064 6966 6669 e reliably diffi │ │ │ │ │ +00007de0: 6375 6c74 2073 7472 7563 7475 7265 7320 cult structures │ │ │ │ │ +00007df0: 6c69 6b65 2042 7472 6673 2c20 5a46 532c like Btrfs, ZFS, │ │ │ │ │ +00007e00: 2052 4149 4420 6f72 0a4c 564d 2c20 6f72 RAID or.LVM, or │ │ │ │ │ +00007e10: 2074 6f20 7573 6520 6469 6666 6963 756c to use difficul │ │ │ │ │ +00007e20: 7420 6469 736b 2061 6363 6573 7320 6d65 t disk access me │ │ │ │ │ +00007e30: 7468 6f64 7320 6c69 6b65 2061 6863 692e thods like ahci. │ │ │ │ │ +00007e40: 2020 4865 6e63 6520 4752 5542 2077 696c Hence GRUB wil │ │ │ │ │ +00007e50: 6c0a 7761 726e 2069 6620 6174 7465 6d70 l.warn if attemp │ │ │ │ │ +00007e60: 7465 6420 746f 2069 6e73 7461 6c6c 2069 ted to install i │ │ │ │ │ +00007e70: 6e74 6f20 736d 616c 6c20 4d42 5220 6761 nto small MBR ga │ │ │ │ │ +00007e80: 7020 6578 6365 7074 2069 6e20 6120 736d p except in a sm │ │ │ │ │ +00007e90: 616c 6c20 6e75 6d62 6572 0a6f 6620 636f all number.of co │ │ │ │ │ +00007ea0: 6e66 6967 7572 6174 696f 6e73 2074 6861 nfigurations tha │ │ │ │ │ +00007eb0: 7420 7765 7265 2067 7261 6e64 6661 7468 t were grandfath │ │ │ │ │ +00007ec0: 6572 6564 2e20 2054 6865 2067 7261 6e64 ered. The grand │ │ │ │ │ +00007ed0: 6661 7468 6572 6564 2063 6f6e 6669 670a fathered config. │ │ │ │ │ +00007ee0: 6d75 7374 3a0a 0a20 2020 2a20 7573 6520 must:.. * use │ │ │ │ │ +00007ef0: 6269 6f73 6469 736b 2061 7320 6469 736b biosdisk as disk │ │ │ │ │ +00007f00: 2061 6363 6573 7320 6d6f 6475 6c65 2066 access module f │ │ │ │ │ +00007f10: 6f72 2027 2f62 6f6f 7427 202a 206e 6f74 or '/boot' * not │ │ │ │ │ +00007f20: 2075 7365 2061 6e79 0a61 6464 6974 696f use any.additio │ │ │ │ │ +00007f30: 6e61 6c20 7061 7274 6974 696f 6e20 6d61 nal partition ma │ │ │ │ │ +00007f40: 7073 2074 6f20 6163 6365 7373 2027 2f62 ps to access '/b │ │ │ │ │ +00007f50: 6f6f 7427 202a 2027 2f62 6f6f 7427 206d oot' * '/boot' m │ │ │ │ │ +00007f60: 7573 7420 6265 206f 6e20 6f6e 6520 6f66 ust be on one of │ │ │ │ │ +00007f70: 0a66 6f6c 6c6f 7769 6e67 2066 696c 6573 .following files │ │ │ │ │ +00007f80: 7973 7465 6d73 3a20 2a20 4146 4653 2c20 ystems: * AFFS, │ │ │ │ │ +00007f90: 4146 532c 2042 4653 2c20 6370 696f 2c20 AFS, BFS, cpio, │ │ │ │ │ +00007fa0: 6e65 7763 2c20 6f64 632c 2065 7874 322f newc, odc, ext2/ │ │ │ │ │ +00007fb0: 332f 342c 2046 4154 2c0a 6578 4641 542c 3/4, FAT,.exFAT, │ │ │ │ │ +00007fc0: 2046 3246 532c 2048 4653 2c20 756e 636f F2FS, HFS, unco │ │ │ │ │ +00007fd0: 6d70 7265 7373 6564 2048 4653 2b2c 2049 mpressed HFS+, I │ │ │ │ │ +00007fe0: 534f 3936 3630 2c20 4a46 532c 204d 696e SO9660, JFS, Min │ │ │ │ │ +00007ff0: 6978 2c20 4d69 6e69 7832 2c0a 4d69 6e69 ix, Minix2,.Mini │ │ │ │ │ +00008000: 7833 2c20 4e49 4c46 5332 2c20 4e54 4653 x3, NILFS2, NTFS │ │ │ │ │ +00008010: 2c20 5265 6973 6572 4653 2c20 524f 4d46 , ReiserFS, ROMF │ │ │ │ │ +00008020: 532c 2053 4653 2c20 7461 722c 2055 4446 S, SFS, tar, UDF │ │ │ │ │ +00008030: 2c20 5546 5331 2c20 5546 5332 2c20 5846 , UFS1, UFS2, XF │ │ │ │ │ +00008040: 530a 0a20 2020 4d42 5220 6761 7020 6861 S.. MBR gap ha │ │ │ │ │ +00008050: 7320 6665 7720 7465 6368 6e69 6361 6c20 s few technical │ │ │ │ │ +00008060: 7072 6f62 6c65 6d73 2e20 2054 6865 7265 problems. There │ │ │ │ │ +00008070: 2069 7320 6e6f 2077 6179 2074 6f20 7265 is no way to re │ │ │ │ │ +00008080: 7365 7276 6520 7370 6163 650a 696e 2074 serve space.in t │ │ │ │ │ +00008090: 6865 2065 6d62 6564 6469 6e67 2061 7265 he embedding are │ │ │ │ │ +000080a0: 6120 7769 7468 2063 6f6d 706c 6574 6520 a with complete │ │ │ │ │ +000080b0: 7361 6665 7479 2c20 616e 6420 736f 6d65 safety, and some │ │ │ │ │ +000080c0: 2070 726f 7072 6965 7461 7279 0a73 6f66 proprietary.sof │ │ │ │ │ +000080d0: 7477 6172 6520 6973 206b 6e6f 776e 2074 tware is known t │ │ │ │ │ +000080e0: 6f20 7573 6520 6974 2074 6f20 6d61 6b65 o use it to make │ │ │ │ │ +000080f0: 2069 7420 6469 6666 6963 756c 7420 666f it difficult fo │ │ │ │ │ +00008100: 7220 7573 6572 7320 746f 2077 6f72 6b0a r users to work. │ │ │ │ │ +00008110: 6172 6f75 6e64 206c 6963 656e 7369 6e67 around licensing │ │ │ │ │ +00008120: 2072 6573 7472 6963 7469 6f6e 732e 2020 restrictions. │ │ │ │ │ +00008130: 4752 5542 2077 6f72 6b73 2069 7420 6172 GRUB works it ar │ │ │ │ │ +00008140: 6f75 6e64 2062 7920 6465 7465 6374 696e ound by detectin │ │ │ │ │ +00008150: 670a 7365 6374 6f72 7320 6279 206f 7468 g.sectors by oth │ │ │ │ │ +00008160: 6572 2073 6f66 7477 6172 6520 616e 6420 er software and │ │ │ │ │ +00008170: 6176 6f69 6469 6e67 2074 6865 6d20 616e avoiding them an │ │ │ │ │ +00008180: 6420 7072 6f74 6563 7469 6e67 2069 7473 d protecting its │ │ │ │ │ +00008190: 206f 776e 0a73 6563 746f 7273 2075 7369 own.sectors usi │ │ │ │ │ +000081a0: 6e67 2052 6565 642d 536f 6c6f 6d6f 6e20 ng Reed-Solomon │ │ │ │ │ +000081b0: 656e 636f 6469 6e67 2e0a 0a20 2020 4752 encoding... GR │ │ │ │ │ +000081c0: 5542 2074 6561 6d20 7265 636f 6d6d 656e UB team recommen │ │ │ │ │ +000081d0: 6473 2068 6176 696e 6720 4d42 5220 6761 ds having MBR ga │ │ │ │ │ +000081e0: 7020 6f66 2061 7420 6c65 6173 7420 3130 p of at least 10 │ │ │ │ │ +000081f0: 3030 204b 6942 0a0a 2020 2053 686f 756c 00 KiB.. Shoul │ │ │ │ │ +00008200: 6420 6974 2062 6520 6e6f 7420 706f 7373 d it be not poss │ │ │ │ │ +00008210: 6962 6c65 2047 5255 4220 6861 7320 7375 ible GRUB has su │ │ │ │ │ +00008220: 7070 6f72 7420 666f 7220 6120 6661 6c6c pport for a fall │ │ │ │ │ +00008230: 6261 636b 2073 6f6c 7574 696f 6e0a 7768 back solution.wh │ │ │ │ │ +00008240: 6963 6820 6973 2068 6561 7669 6c79 2072 ich is heavily r │ │ │ │ │ +00008250: 6563 6f6d 6d65 6e64 6564 2061 6761 696e ecommended again │ │ │ │ │ +00008260: 7374 2e20 2049 6e73 7461 6c6c 696e 6720 st. Installing │ │ │ │ │ +00008270: 746f 2061 2066 696c 6573 7973 7465 6d20 to a filesystem │ │ │ │ │ +00008280: 6d65 616e 730a 7468 6174 2047 5255 4220 means.that GRUB │ │ │ │ │ +00008290: 6973 2076 756c 6e65 7261 626c 6520 746f is vulnerable to │ │ │ │ │ +000082a0: 2069 7473 2062 6c6f 636b 7320 6265 696e its blocks bein │ │ │ │ │ +000082b0: 6720 6d6f 7665 6420 6172 6f75 6e64 2062 g moved around b │ │ │ │ │ +000082c0: 7920 6669 6c65 7379 7374 656d 0a66 6561 y filesystem.fea │ │ │ │ │ +000082d0: 7475 7265 7320 7375 6368 2061 7320 7461 tures such as ta │ │ │ │ │ +000082e0: 696c 2070 6163 6b69 6e67 2c20 6f72 2065 il packing, or e │ │ │ │ │ +000082f0: 7665 6e20 6279 2061 6767 7265 7373 6976 ven by aggressiv │ │ │ │ │ +00008300: 6520 6673 636b 0a69 6d70 6c65 6d65 6e74 e fsck.implement │ │ │ │ │ +00008310: 6174 696f 6e73 2c20 736f 2074 6869 7320 ations, so this │ │ │ │ │ +00008320: 6170 7072 6f61 6368 2069 7320 7175 6974 approach is quit │ │ │ │ │ +00008330: 6520 6672 6167 696c 653b 2061 6e64 2074 e fragile; and t │ │ │ │ │ +00008340: 6869 7320 6170 7072 6f61 6368 0a63 616e his approach.can │ │ │ │ │ +00008350: 206f 6e6c 7920 6265 2075 7365 6420 6966 only be used if │ │ │ │ │ +00008360: 2074 6865 2027 2f62 6f6f 7427 2066 696c the '/boot' fil │ │ │ │ │ +00008370: 6573 7973 7465 6d20 6973 206f 6e20 7468 esystem is on th │ │ │ │ │ +00008380: 6520 7361 6d65 2064 6973 6b20 7468 6174 e same disk that │ │ │ │ │ +00008390: 2074 6865 0a42 494f 5320 626f 6f74 7320 the.BIOS boots │ │ │ │ │ +000083a0: 6672 6f6d 2c20 736f 2074 6861 7420 4752 from, so that GR │ │ │ │ │ +000083b0: 5542 2064 6f65 7320 6e6f 7420 6861 7665 UB does not have │ │ │ │ │ +000083c0: 2074 6f20 7265 6c79 206f 6e20 6775 6573 to rely on gues │ │ │ │ │ +000083d0: 7369 6e67 2042 494f 530a 6472 6976 6520 sing BIOS.drive │ │ │ │ │ +000083e0: 6e75 6d62 6572 732e 0a0a 2020 2054 6865 numbers... The │ │ │ │ │ +000083f0: 2047 5255 4220 6465 7665 6c6f 706d 656e GRUB developmen │ │ │ │ │ +00008400: 7420 7465 616d 2067 656e 6572 616c 6c79 t team generally │ │ │ │ │ +00008410: 2072 6563 6f6d 6d65 6e64 7320 656d 6265 recommends embe │ │ │ │ │ +00008420: 6464 696e 6720 4752 5542 2062 6566 6f72 dding GRUB befor │ │ │ │ │ +00008430: 650a 7468 6520 6669 7273 7420 7061 7274 e.the first part │ │ │ │ │ +00008440: 6974 696f 6e2c 2075 6e6c 6573 7320 796f ition, unless yo │ │ │ │ │ +00008450: 7520 6861 7665 2073 7065 6369 616c 2072 u have special r │ │ │ │ │ +00008460: 6571 7569 7265 6d65 6e74 732e 2020 596f equirements. Yo │ │ │ │ │ +00008470: 7520 6d75 7374 0a65 6e73 7572 6520 7468 u must.ensure th │ │ │ │ │ +00008480: 6174 2074 6865 2066 6972 7374 2070 6172 at the first par │ │ │ │ │ +00008490: 7469 7469 6f6e 2073 7461 7274 7320 6174 tition starts at │ │ │ │ │ +000084a0: 206c 6561 7374 2031 3030 3020 4b69 4220 least 1000 KiB │ │ │ │ │ +000084b0: 2832 3030 3020 7365 6374 6f72 7329 0a66 (2000 sectors).f │ │ │ │ │ +000084c0: 726f 6d20 7468 6520 7374 6172 7420 6f66 rom the start of │ │ │ │ │ +000084d0: 2074 6865 2064 6973 6b3b 206f 6e20 6d6f the disk; on mo │ │ │ │ │ +000084e0: 6465 726e 2064 6973 6b73 2c20 6974 2069 dern disks, it i │ │ │ │ │ +000084f0: 7320 6f66 7465 6e20 6120 7065 7266 6f72 s often a perfor │ │ │ │ │ +00008500: 6d61 6e63 650a 6164 7661 6e74 6167 6520 mance.advantage │ │ │ │ │ +00008510: 746f 2061 6c69 676e 2070 6172 7469 7469 to align partiti │ │ │ │ │ +00008520: 6f6e 7320 6f6e 206c 6172 6765 7220 626f ons on larger bo │ │ │ │ │ +00008530: 756e 6461 7269 6573 2061 6e79 7761 792c undaries anyway, │ │ │ │ │ +00008540: 2073 6f20 7468 6520 6669 7273 740a 7061 so the first.pa │ │ │ │ │ +00008550: 7274 6974 696f 6e20 6d69 6768 7420 7374 rtition might st │ │ │ │ │ +00008560: 6172 7420 3120 4d69 4220 6672 6f6d 2074 art 1 MiB from t │ │ │ │ │ +00008570: 6865 2073 7461 7274 206f 6620 7468 6520 he start of the │ │ │ │ │ +00008580: 6469 736b 2e0a 0a47 5054 0a3d 3d3d 0a0a disk...GPT.===.. │ │ │ │ │ +00008590: 536f 6d65 206e 6577 6572 2073 7973 7465 Some newer syste │ │ │ │ │ +000085a0: 6d73 2075 7365 2074 6865 2047 5549 4420 ms use the GUID │ │ │ │ │ +000085b0: 5061 7274 6974 696f 6e20 5461 626c 6520 Partition Table │ │ │ │ │ +000085c0: 2847 5054 2920 666f 726d 6174 2e20 2054 (GPT) format. T │ │ │ │ │ +000085d0: 6869 7320 7761 730a 7370 6563 6966 6965 his was.specifie │ │ │ │ │ +000085e0: 6420 6173 2070 6172 7420 6f66 2074 6865 d as part of the │ │ │ │ │ +000085f0: 2045 7874 656e 7369 626c 6520 4669 726d Extensible Firm │ │ │ │ │ +00008600: 7761 7265 2049 6e74 6572 6661 6365 2028 ware Interface ( │ │ │ │ │ +00008610: 4546 4929 2c20 6275 7420 6974 2063 616e EFI), but it can │ │ │ │ │ +00008620: 0a61 6c73 6f20 6265 2075 7365 6420 6f6e .also be used on │ │ │ │ │ +00008630: 2042 494f 5320 706c 6174 666f 726d 7320 BIOS platforms │ │ │ │ │ +00008640: 6966 2073 7973 7465 6d20 736f 6674 7761 if system softwa │ │ │ │ │ +00008650: 7265 2073 7570 706f 7274 7320 6974 3b20 re supports it; │ │ │ │ │ +00008660: 666f 720a 6578 616d 706c 652c 2047 5255 for.example, GRU │ │ │ │ │ +00008670: 4220 616e 6420 474e 552f 4c69 6e75 7820 B and GNU/Linux │ │ │ │ │ +00008680: 6361 6e20 6265 2075 7365 6420 696e 2074 can be used in t │ │ │ │ │ +00008690: 6869 7320 636f 6e66 6967 7572 6174 696f his configuratio │ │ │ │ │ +000086a0: 6e2e 2020 5769 7468 0a74 6869 7320 666f n. With.this fo │ │ │ │ │ +000086b0: 726d 6174 2c20 6974 2069 7320 706f 7373 rmat, it is poss │ │ │ │ │ +000086c0: 6962 6c65 2074 6f20 7265 7365 7276 6520 ible to reserve │ │ │ │ │ +000086d0: 6120 7768 6f6c 6520 7061 7274 6974 696f a whole partitio │ │ │ │ │ +000086e0: 6e20 666f 7220 4752 5542 2c0a 6361 6c6c n for GRUB,.call │ │ │ │ │ +000086f0: 6564 2074 6865 2042 494f 5320 426f 6f74 ed the BIOS Boot │ │ │ │ │ +00008700: 2050 6172 7469 7469 6f6e 2e20 2047 5255 Partition. GRU │ │ │ │ │ +00008710: 4220 6361 6e20 7468 656e 2062 6520 656d B can then be em │ │ │ │ │ +00008720: 6265 6464 6564 2069 6e74 6f20 7468 6174 bedded into that │ │ │ │ │ +00008730: 0a70 6172 7469 7469 6f6e 2077 6974 686f .partition witho │ │ │ │ │ +00008740: 7574 2074 6865 2072 6973 6b20 6f66 2062 ut the risk of b │ │ │ │ │ +00008750: 6569 6e67 206f 7665 7277 7269 7474 656e eing overwritten │ │ │ │ │ +00008760: 2062 7920 6f74 6865 7220 736f 6674 7761 by other softwa │ │ │ │ │ +00008770: 7265 2061 6e64 0a77 6974 686f 7574 2062 re and.without b │ │ │ │ │ +00008780: 6569 6e67 2063 6f6e 7461 696e 6564 2069 eing contained i │ │ │ │ │ +00008790: 6e20 6120 6669 6c65 7379 7374 656d 2077 n a filesystem w │ │ │ │ │ +000087a0: 6869 6368 206d 6967 6874 206d 6f76 6520 hich might move │ │ │ │ │ +000087b0: 6974 7320 626c 6f63 6b73 0a61 726f 756e its blocks.aroun │ │ │ │ │ +000087c0: 642e 0a0a 2020 2057 6865 6e20 6372 6561 d... When crea │ │ │ │ │ +000087d0: 7469 6e67 2061 2042 494f 5320 426f 6f74 ting a BIOS Boot │ │ │ │ │ +000087e0: 2050 6172 7469 7469 6f6e 206f 6e20 6120 Partition on a │ │ │ │ │ +000087f0: 4750 5420 7379 7374 656d 2c20 796f 7520 GPT system, you │ │ │ │ │ +00008800: 7368 6f75 6c64 206d 616b 650a 7375 7265 should make.sure │ │ │ │ │ +00008810: 2074 6861 7420 6974 2069 7320 6174 206c that it is at l │ │ │ │ │ +00008820: 6561 7374 2033 3120 4b69 4220 696e 2073 east 31 KiB in s │ │ │ │ │ +00008830: 697a 652e 2020 2847 5054 2d66 6f72 6d61 ize. (GPT-forma │ │ │ │ │ +00008840: 7474 6564 2064 6973 6b73 2061 7265 206e tted disks are n │ │ │ │ │ +00008850: 6f74 0a75 7375 616c 6c79 2070 6172 7469 ot.usually parti │ │ │ │ │ +00008860: 6375 6c61 726c 7920 736d 616c 6c2c 2073 cularly small, s │ │ │ │ │ +00008870: 6f20 7765 2072 6563 6f6d 6d65 6e64 2074 o we recommend t │ │ │ │ │ +00008880: 6861 7420 796f 7520 6d61 6b65 2069 7420 hat you make it │ │ │ │ │ +00008890: 6c61 7267 6572 2074 6861 6e0a 7468 6520 larger than.the │ │ │ │ │ +000088a0: 6261 7265 206d 696e 696d 756d 2c20 7375 bare minimum, su │ │ │ │ │ +000088b0: 6368 2061 7320 3120 4d69 422c 2074 6f20 ch as 1 MiB, to │ │ │ │ │ +000088c0: 616c 6c6f 7720 706c 656e 7479 206f 6620 allow plenty of │ │ │ │ │ +000088d0: 726f 6f6d 2066 6f72 2067 726f 7774 682e room for growth. │ │ │ │ │ +000088e0: 290a 596f 7520 6d75 7374 2061 6c73 6f20 ).You must also │ │ │ │ │ +000088f0: 6d61 6b65 2073 7572 6520 7468 6174 2069 make sure that i │ │ │ │ │ +00008900: 7420 6861 7320 7468 6520 7072 6f70 6572 t has the proper │ │ │ │ │ +00008910: 2070 6172 7469 7469 6f6e 2074 7970 652e partition type. │ │ │ │ │ +00008920: 2020 5573 696e 670a 474e 5520 5061 7274 Using.GNU Part │ │ │ │ │ +00008930: 6564 2c20 796f 7520 6361 6e20 7365 7420 ed, you can set │ │ │ │ │ +00008940: 7468 6973 2075 7369 6e67 2061 2063 6f6d this using a com │ │ │ │ │ +00008950: 6d61 6e64 2073 7563 6820 6173 2074 6865 mand such as the │ │ │ │ │ +00008960: 2066 6f6c 6c6f 7769 6e67 3a0a 0a20 2020 following:.. │ │ │ │ │ +00008970: 2020 2320 7061 7274 6564 202f 6465 762f # parted /dev/ │ │ │ │ │ +00008980: 4449 534b 2073 6574 2050 4152 5449 5449 DISK set PARTITI │ │ │ │ │ +00008990: 4f4e 2d4e 554d 4245 5220 6269 6f73 5f67 ON-NUMBER bios_g │ │ │ │ │ +000089a0: 7275 6220 6f6e 0a0a 2020 2049 6620 796f rub on.. If yo │ │ │ │ │ +000089b0: 7520 6172 6520 7573 696e 6720 6764 6973 u are using gdis │ │ │ │ │ +000089c0: 6b2c 2073 6574 2074 6865 2070 6172 7469 k, set the parti │ │ │ │ │ +000089d0: 7469 6f6e 2074 7970 6520 746f 2027 3078 tion type to '0x │ │ │ │ │ +000089e0: 4546 3032 272e 2020 5769 7468 0a70 6172 EF02'. With.par │ │ │ │ │ +000089f0: 7469 7469 6f6e 696e 6720 7072 6f67 7261 titioning progra │ │ │ │ │ +00008a00: 6d73 2074 6861 7420 7265 7175 6972 6520 ms that require │ │ │ │ │ +00008a10: 7365 7474 696e 6720 7468 6520 4755 4944 setting the GUID │ │ │ │ │ +00008a20: 2064 6972 6563 746c 792c 2069 7420 7368 directly, it sh │ │ │ │ │ +00008a30: 6f75 6c64 0a62 6520 2732 3136 3836 3134 ould.be '2168614 │ │ │ │ │ +00008a40: 382d 3634 3439 2d36 6536 662d 3734 3465 8-6449-6e6f-744e │ │ │ │ │ +00008a50: 3635 3635 3634 3435 3436 3439 272e 0a0a 656564454649'... │ │ │ │ │ +00008a60: 2020 202a 4361 7574 696f 6e3a 2a20 4265 *Caution:* Be │ │ │ │ │ +00008a70: 2076 6572 7920 6361 7265 6675 6c20 7768 very careful wh │ │ │ │ │ +00008a80: 6963 6820 7061 7274 6974 696f 6e20 796f ich partition yo │ │ │ │ │ +00008a90: 7520 7365 6c65 6374 2120 2057 6865 6e20 u select! When │ │ │ │ │ +00008aa0: 4752 5542 0a66 696e 6473 2061 2042 494f GRUB.finds a BIO │ │ │ │ │ +00008ab0: 5320 426f 6f74 2050 6172 7469 7469 6f6e S Boot Partition │ │ │ │ │ +00008ac0: 2064 7572 696e 6720 696e 7374 616c 6c61 during installa │ │ │ │ │ +00008ad0: 7469 6f6e 2c20 6974 2077 696c 6c20 6175 tion, it will au │ │ │ │ │ +00008ae0: 746f 6d61 7469 6361 6c6c 790a 6f76 6572 tomatically.over │ │ │ │ │ +00008af0: 7772 6974 6520 7061 7274 206f 6620 6974 write part of it │ │ │ │ │ +00008b00: 2e20 204d 616b 6520 7375 7265 2074 6861 . Make sure tha │ │ │ │ │ +00008b10: 7420 7468 6520 7061 7274 6974 696f 6e20 t the partition │ │ │ │ │ +00008b20: 646f 6573 206e 6f74 2063 6f6e 7461 696e does not contain │ │ │ │ │ +00008b30: 2061 6e79 0a6f 7468 6572 2064 6174 612e any.other data. │ │ │ │ │ +00008b40: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00008b50: 6e66 6f2c 2020 4e6f 6465 3a20 426f 6f74 nfo, Node: Boot │ │ │ │ │ +00008b60: 696e 672c 2020 4e65 7874 3a20 436f 6e66 ing, Next: Conf │ │ │ │ │ +00008b70: 6967 7572 6174 696f 6e2c 2020 5072 6576 iguration, Prev │ │ │ │ │ +00008b80: 3a20 496e 7374 616c 6c61 7469 6f6e 2c20 : Installation, │ │ │ │ │ +00008b90: 2055 703a 2054 6f70 0a0a 3520 426f 6f74 Up: Top..5 Boot │ │ │ │ │ +00008ba0: 696e 670a 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 ing.*********..G │ │ │ │ │ +00008bb0: 5255 4220 6361 6e20 6c6f 6164 204d 756c RUB can load Mul │ │ │ │ │ +00008bc0: 7469 626f 6f74 2d63 6f6d 706c 6961 6e74 tiboot-compliant │ │ │ │ │ +00008bd0: 206b 6572 6e65 6c73 2069 6e20 6120 636f kernels in a co │ │ │ │ │ +00008be0: 6e73 6973 7465 6e74 2077 6179 2c20 6275 nsistent way, bu │ │ │ │ │ +00008bf0: 7420 666f 720a 736f 6d65 2066 7265 6520 t for.some free │ │ │ │ │ +00008c00: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +00008c10: 7320 796f 7520 6e65 6564 2074 6f20 7573 s you need to us │ │ │ │ │ +00008c20: 6520 736f 6d65 204f 532d 7370 6563 6966 e some OS-specif │ │ │ │ │ +00008c30: 6963 206d 6167 6963 2e0a 0a2a 204d 656e ic magic...* Men │ │ │ │ │ +00008c40: 753a 0a0a 2a20 4765 6e65 7261 6c20 626f u:..* General bo │ │ │ │ │ +00008c50: 6f74 206d 6574 686f 6473 3a3a 2020 2020 ot methods:: │ │ │ │ │ +00008c60: 2020 2020 486f 7720 746f 2062 6f6f 7420 How to boot │ │ │ │ │ +00008c70: 4f53 6573 2077 6974 6820 4752 5542 2067 OSes with GRUB g │ │ │ │ │ +00008c80: 656e 6572 616c 6c79 0a2a 204c 6f6f 7062 enerally.* Loopb │ │ │ │ │ +00008c90: 6163 6b20 626f 6f74 696e 673a 3a20 2020 ack booting:: │ │ │ │ │ +00008ca0: 2020 2020 2020 2020 204e 6f74 6573 206f Notes o │ │ │ │ │ +00008cb0: 6e20 626f 6f74 696e 6720 6672 6f6d 206c n booting from l │ │ │ │ │ +00008cc0: 6f6f 7062 6163 6b73 0a2a 204c 564d 2063 oopbacks.* LVM c │ │ │ │ │ +00008cd0: 6163 6865 2062 6f6f 7469 6e67 3a3a 2020 ache booting:: │ │ │ │ │ +00008ce0: 2020 2020 2020 2020 204e 6f74 6573 206f Notes o │ │ │ │ │ +00008cf0: 6e20 626f 6f74 696e 6720 6672 6f6d 204c n booting from L │ │ │ │ │ +00008d00: 564d 2063 6163 6865 206c 6f67 6963 616c VM cache logical │ │ │ │ │ +00008d10: 2076 6f6c 756d 650a 2a20 4f53 2d73 7065 volume.* OS-spe │ │ │ │ │ +00008d20: 6369 6669 6320 6e6f 7465 733a 3a20 2020 cific notes:: │ │ │ │ │ +00008d30: 2020 2020 2020 2020 4e6f 7465 7320 6f6e Notes on │ │ │ │ │ +00008d40: 2073 6f6d 6520 6f70 6572 6174 696e 6720 some operating │ │ │ │ │ +00008d50: 7379 7374 656d 730a 0a1f 0a46 696c 653a systems....File: │ │ │ │ │ +00008d60: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00008d70: 653a 2047 656e 6572 616c 2062 6f6f 7420 e: General boot │ │ │ │ │ +00008d80: 6d65 7468 6f64 732c 2020 4e65 7874 3a20 methods, Next: │ │ │ │ │ +00008d90: 4c6f 6f70 6261 636b 2062 6f6f 7469 6e67 Loopback booting │ │ │ │ │ +00008da0: 2c20 2055 703a 2042 6f6f 7469 6e67 0a0a , Up: Booting.. │ │ │ │ │ +00008db0: 352e 3120 486f 7720 746f 2062 6f6f 7420 5.1 How to boot │ │ │ │ │ +00008dc0: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +00008dd0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ │ 00008de0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00008df0: 3d0a 0a47 5255 4220 6861 7320 7477 6f20 =..GRUB has two │ │ │ │ │ -00008e00: 6469 7374 696e 6374 2062 6f6f 7420 6d65 distinct boot me │ │ │ │ │ -00008e10: 7468 6f64 732e 2020 4f6e 6520 6f66 2074 thods. One of t │ │ │ │ │ -00008e20: 6865 2074 776f 2069 7320 746f 206c 6f61 he two is to loa │ │ │ │ │ -00008e30: 6420 616e 0a6f 7065 7261 7469 6e67 2073 d an.operating s │ │ │ │ │ -00008e40: 7973 7465 6d20 6469 7265 6374 6c79 2c20 ystem directly, │ │ │ │ │ -00008e50: 616e 6420 7468 6520 6f74 6865 7220 6973 and the other is │ │ │ │ │ -00008e60: 2074 6f20 6368 6169 6e2d 6c6f 6164 2061 to chain-load a │ │ │ │ │ -00008e70: 6e6f 7468 6572 2062 6f6f 740a 6c6f 6164 nother boot.load │ │ │ │ │ -00008e80: 6572 2077 6869 6368 2074 6865 6e20 7769 er which then wi │ │ │ │ │ -00008e90: 6c6c 206c 6f61 6420 616e 206f 7065 7261 ll load an opera │ │ │ │ │ -00008ea0: 7469 6e67 2073 7973 7465 6d20 6163 7475 ting system actu │ │ │ │ │ -00008eb0: 616c 6c79 2e20 2047 656e 6572 616c 6c79 ally. Generally │ │ │ │ │ -00008ec0: 0a73 7065 616b 696e 672c 2074 6865 2066 .speaking, the f │ │ │ │ │ -00008ed0: 6f72 6d65 7220 6973 206d 6f72 6520 6465 ormer is more de │ │ │ │ │ -00008ee0: 7369 7261 626c 652c 2062 6563 6175 7365 sirable, because │ │ │ │ │ -00008ef0: 2079 6f75 2064 6f6e 2774 206e 6565 6420 you don't need │ │ │ │ │ -00008f00: 746f 0a69 6e73 7461 6c6c 206f 7220 6d61 to.install or ma │ │ │ │ │ -00008f10: 696e 7461 696e 206f 7468 6572 2062 6f6f intain other boo │ │ │ │ │ -00008f20: 7420 6c6f 6164 6572 7320 616e 6420 4752 t loaders and GR │ │ │ │ │ -00008f30: 5542 2069 7320 666c 6578 6962 6c65 2065 UB is flexible e │ │ │ │ │ -00008f40: 6e6f 7567 6820 746f 0a6c 6f61 6420 616e nough to.load an │ │ │ │ │ -00008f50: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ │ -00008f60: 6d20 6672 6f6d 2061 6e20 6172 6269 7472 m from an arbitr │ │ │ │ │ -00008f70: 6172 7920 6469 736b 2f70 6172 7469 7469 ary disk/partiti │ │ │ │ │ -00008f80: 6f6e 2e20 2048 6f77 6576 6572 2c20 7468 on. However, th │ │ │ │ │ -00008f90: 650a 6c61 7474 6572 2069 7320 736f 6d65 e.latter is some │ │ │ │ │ -00008fa0: 7469 6d65 7320 7265 7175 6972 6564 2c20 times required, │ │ │ │ │ -00008fb0: 7369 6e63 6520 4752 5542 2064 6f65 736e since GRUB doesn │ │ │ │ │ -00008fc0: 2774 2073 7570 706f 7274 2061 6c6c 2074 't support all t │ │ │ │ │ -00008fd0: 6865 0a65 7869 7374 696e 6720 6f70 6572 he.existing oper │ │ │ │ │ -00008fe0: 6174 696e 6720 7379 7374 656d 7320 6e61 ating systems na │ │ │ │ │ -00008ff0: 7469 7665 6c79 2e0a 0a2a 204d 656e 753a tively...* Menu: │ │ │ │ │ -00009000: 0a0a 2a20 4c6f 6164 696e 6720 616e 206f ..* Loading an o │ │ │ │ │ -00009010: 7065 7261 7469 6e67 2073 7973 7465 6d20 perating system │ │ │ │ │ -00009020: 6469 7265 6374 6c79 3a3a 0a2a 2043 6861 directly::.* Cha │ │ │ │ │ -00009030: 696e 2d6c 6f61 6469 6e67 3a3a 0a0a 1f0a in-loading::.... │ │ │ │ │ -00009040: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -00009050: 2020 4e6f 6465 3a20 4c6f 6164 696e 6720 Node: Loading │ │ │ │ │ -00009060: 616e 206f 7065 7261 7469 6e67 2073 7973 an operating sys │ │ │ │ │ -00009070: 7465 6d20 6469 7265 6374 6c79 2c20 204e tem directly, N │ │ │ │ │ -00009080: 6578 743a 2043 6861 696e 2d6c 6f61 6469 ext: Chain-loadi │ │ │ │ │ -00009090: 6e67 2c20 2055 703a 2047 656e 6572 616c ng, Up: General │ │ │ │ │ -000090a0: 2062 6f6f 7420 6d65 7468 6f64 730a 0a35 boot methods..5 │ │ │ │ │ -000090b0: 2e31 2e31 2048 6f77 2074 6f20 626f 6f74 .1.1 How to boot │ │ │ │ │ -000090c0: 2061 6e20 4f53 2064 6972 6563 746c 7920 an OS directly │ │ │ │ │ -000090d0: 7769 7468 2047 5255 420a 2d2d 2d2d 2d2d with GRUB.------ │ │ │ │ │ +00008df0: 3d3d 3d0a 0a47 5255 4220 6861 7320 7477 ===..GRUB has tw │ │ │ │ │ +00008e00: 6f20 6469 7374 696e 6374 2062 6f6f 7420 o distinct boot │ │ │ │ │ +00008e10: 6d65 7468 6f64 732e 2020 4f6e 6520 6f66 methods. One of │ │ │ │ │ +00008e20: 2074 6865 2074 776f 2069 7320 746f 206c the two is to l │ │ │ │ │ +00008e30: 6f61 6420 616e 0a6f 7065 7261 7469 6e67 oad an.operating │ │ │ │ │ +00008e40: 2073 7973 7465 6d20 6469 7265 6374 6c79 system directly │ │ │ │ │ +00008e50: 2c20 616e 6420 7468 6520 6f74 6865 7220 , and the other │ │ │ │ │ +00008e60: 6973 2074 6f20 6368 6169 6e2d 6c6f 6164 is to chain-load │ │ │ │ │ +00008e70: 2061 6e6f 7468 6572 2062 6f6f 740a 6c6f another boot.lo │ │ │ │ │ +00008e80: 6164 6572 2077 6869 6368 2074 6865 6e20 ader which then │ │ │ │ │ +00008e90: 7769 6c6c 206c 6f61 6420 616e 206f 7065 will load an ope │ │ │ │ │ +00008ea0: 7261 7469 6e67 2073 7973 7465 6d20 6163 rating system ac │ │ │ │ │ +00008eb0: 7475 616c 6c79 2e20 2047 656e 6572 616c tually. General │ │ │ │ │ +00008ec0: 6c79 0a73 7065 616b 696e 672c 2074 6865 ly.speaking, the │ │ │ │ │ +00008ed0: 2066 6f72 6d65 7220 6973 206d 6f72 6520 former is more │ │ │ │ │ +00008ee0: 6465 7369 7261 626c 652c 2062 6563 6175 desirable, becau │ │ │ │ │ +00008ef0: 7365 2079 6f75 2064 6f6e 2774 206e 6565 se you don't nee │ │ │ │ │ +00008f00: 6420 746f 0a69 6e73 7461 6c6c 206f 7220 d to.install or │ │ │ │ │ +00008f10: 6d61 696e 7461 696e 206f 7468 6572 2062 maintain other b │ │ │ │ │ +00008f20: 6f6f 7420 6c6f 6164 6572 7320 616e 6420 oot loaders and │ │ │ │ │ +00008f30: 4752 5542 2069 7320 666c 6578 6962 6c65 GRUB is flexible │ │ │ │ │ +00008f40: 2065 6e6f 7567 6820 746f 0a6c 6f61 6420 enough to.load │ │ │ │ │ +00008f50: 616e 206f 7065 7261 7469 6e67 2073 7973 an operating sys │ │ │ │ │ +00008f60: 7465 6d20 6672 6f6d 2061 6e20 6172 6269 tem from an arbi │ │ │ │ │ +00008f70: 7472 6172 7920 6469 736b 2f70 6172 7469 trary disk/parti │ │ │ │ │ +00008f80: 7469 6f6e 2e20 2048 6f77 6576 6572 2c20 tion. However, │ │ │ │ │ +00008f90: 7468 650a 6c61 7474 6572 2069 7320 736f the.latter is so │ │ │ │ │ +00008fa0: 6d65 7469 6d65 7320 7265 7175 6972 6564 metimes required │ │ │ │ │ +00008fb0: 2c20 7369 6e63 6520 4752 5542 2064 6f65 , since GRUB doe │ │ │ │ │ +00008fc0: 736e 2774 2073 7570 706f 7274 2061 6c6c sn't support all │ │ │ │ │ +00008fd0: 2074 6865 0a65 7869 7374 696e 6720 6f70 the.existing op │ │ │ │ │ +00008fe0: 6572 6174 696e 6720 7379 7374 656d 7320 erating systems │ │ │ │ │ +00008ff0: 6e61 7469 7665 6c79 2e0a 0a2a 204d 656e natively...* Men │ │ │ │ │ +00009000: 753a 0a0a 2a20 4c6f 6164 696e 6720 616e u:..* Loading an │ │ │ │ │ +00009010: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ │ +00009020: 6d20 6469 7265 6374 6c79 3a3a 0a2a 2043 m directly::.* C │ │ │ │ │ +00009030: 6861 696e 2d6c 6f61 6469 6e67 3a3a 0a0a hain-loading::.. │ │ │ │ │ +00009040: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00009050: 6f2c 2020 4e6f 6465 3a20 4c6f 6164 696e o, Node: Loadin │ │ │ │ │ +00009060: 6720 616e 206f 7065 7261 7469 6e67 2073 g an operating s │ │ │ │ │ +00009070: 7973 7465 6d20 6469 7265 6374 6c79 2c20 ystem directly, │ │ │ │ │ +00009080: 204e 6578 743a 2043 6861 696e 2d6c 6f61 Next: Chain-loa │ │ │ │ │ +00009090: 6469 6e67 2c20 2055 703a 2047 656e 6572 ding, Up: Gener │ │ │ │ │ +000090a0: 616c 2062 6f6f 7420 6d65 7468 6f64 730a al boot methods. │ │ │ │ │ +000090b0: 0a35 2e31 2e31 2048 6f77 2074 6f20 626f .5.1.1 How to bo │ │ │ │ │ +000090c0: 6f74 2061 6e20 4f53 2064 6972 6563 746c ot an OS directl │ │ │ │ │ +000090d0: 7920 7769 7468 2047 5255 420a 2d2d 2d2d y with GRUB.---- │ │ │ │ │ 000090e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 000090f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00009100: 2d2d 2d2d 0a0a 4d75 6c74 6962 6f6f 7420 ----..Multiboot │ │ │ │ │ -00009110: 282a 6e6f 7465 204d 756c 7469 626f 6f74 (*note Multiboot │ │ │ │ │ -00009120: 2053 7065 6369 6669 6361 7469 6f6e 3a20 Specification: │ │ │ │ │ -00009130: 286d 756c 7469 626f 6f74 2954 6f70 2e29 (multiboot)Top.) │ │ │ │ │ -00009140: 2069 7320 7468 6520 6e61 7469 7665 0a66 is the native.f │ │ │ │ │ -00009150: 6f72 6d61 7420 7375 7070 6f72 7465 6420 ormat supported │ │ │ │ │ -00009160: 6279 2047 5255 422e 2046 6f72 2074 6865 by GRUB. For the │ │ │ │ │ -00009170: 2073 616b 6520 6f66 2063 6f6e 7665 6e69 sake of conveni │ │ │ │ │ -00009180: 656e 6365 2c20 7468 6572 6520 6973 2061 ence, there is a │ │ │ │ │ -00009190: 6c73 6f0a 7375 7070 6f72 7420 666f 7220 lso.support for │ │ │ │ │ -000091a0: 4c69 6e75 782c 2046 7265 6542 5344 2c20 Linux, FreeBSD, │ │ │ │ │ -000091b0: 4e65 7442 5344 2061 6e64 204f 7065 6e42 NetBSD and OpenB │ │ │ │ │ -000091c0: 5344 2e20 4966 2079 6f75 2077 616e 7420 SD. If you want │ │ │ │ │ -000091d0: 746f 2062 6f6f 740a 6f74 6865 7220 6f70 to boot.other op │ │ │ │ │ -000091e0: 6572 6174 696e 6720 7379 7374 656d 732c erating systems, │ │ │ │ │ -000091f0: 2079 6f75 2077 696c 6c20 6861 7665 2074 you will have t │ │ │ │ │ -00009200: 6f20 6368 6169 6e2d 6c6f 6164 2074 6865 o chain-load the │ │ │ │ │ -00009210: 6d20 282a 6e6f 7465 0a43 6861 696e 2d6c m (*note.Chain-l │ │ │ │ │ -00009220: 6f61 6469 6e67 3a3a 292e 0a0a 2020 2046 oading::)... F │ │ │ │ │ -00009230: 4958 4d45 3a20 7468 6973 2073 6563 7469 IXME: this secti │ │ │ │ │ -00009240: 6f6e 2069 7320 696e 636f 6d70 6c65 7465 on is incomplete │ │ │ │ │ -00009250: 2e0a 0a20 2031 2e20 5275 6e20 7468 6520 ... 1. Run the │ │ │ │ │ -00009260: 636f 6d6d 616e 6420 2762 6f6f 7427 2028 command 'boot' ( │ │ │ │ │ -00009270: 2a6e 6f74 6520 626f 6f74 3a3a 292e 0a0a *note boot::)... │ │ │ │ │ -00009280: 2020 2048 6f77 6576 6572 2c20 444f 5320 However, DOS │ │ │ │ │ -00009290: 616e 6420 5769 6e64 6f77 7320 6861 7665 and Windows have │ │ │ │ │ -000092a0: 2073 6f6d 6520 6465 6669 6369 656e 6369 some deficienci │ │ │ │ │ -000092b0: 6573 2c20 736f 2079 6f75 206d 6967 6874 es, so you might │ │ │ │ │ -000092c0: 2068 6176 6520 746f 0a75 7365 206d 6f72 have to.use mor │ │ │ │ │ -000092d0: 6520 636f 6d70 6c69 6361 7465 6420 696e e complicated in │ │ │ │ │ -000092e0: 7374 7275 6374 696f 6e73 2e20 202a 4e6f structions. *No │ │ │ │ │ -000092f0: 7465 2044 4f53 2f57 696e 646f 7773 3a3a te DOS/Windows:: │ │ │ │ │ -00009300: 2c20 666f 7220 6d6f 7265 0a69 6e66 6f72 , for more.infor │ │ │ │ │ -00009310: 6d61 7469 6f6e 2e0a 0a1f 0a46 696c 653a mation.....File: │ │ │ │ │ -00009320: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -00009330: 653a 2043 6861 696e 2d6c 6f61 6469 6e67 e: Chain-loading │ │ │ │ │ -00009340: 2c20 2050 7265 763a 204c 6f61 6469 6e67 , Prev: Loading │ │ │ │ │ -00009350: 2061 6e20 6f70 6572 6174 696e 6720 7379 an operating sy │ │ │ │ │ -00009360: 7374 656d 2064 6972 6563 746c 792c 2020 stem directly, │ │ │ │ │ -00009370: 5570 3a20 4765 6e65 7261 6c20 626f 6f74 Up: General boot │ │ │ │ │ -00009380: 206d 6574 686f 6473 0a0a 352e 312e 3220 methods..5.1.2 │ │ │ │ │ -00009390: 4368 6169 6e2d 6c6f 6164 696e 6720 616e Chain-loading an │ │ │ │ │ -000093a0: 204f 530a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d OS.------------ │ │ │ │ │ -000093b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a4f -------------..O │ │ │ │ │ -000093c0: 7065 7261 7469 6e67 2073 7973 7465 6d73 perating systems │ │ │ │ │ -000093d0: 2074 6861 7420 646f 206e 6f74 2073 7570 that do not sup │ │ │ │ │ -000093e0: 706f 7274 204d 756c 7469 626f 6f74 2061 port Multiboot a │ │ │ │ │ -000093f0: 6e64 2064 6f20 6e6f 7420 6861 7665 2073 nd do not have s │ │ │ │ │ -00009400: 7065 6369 6669 630a 7375 7070 6f72 7420 pecific.support │ │ │ │ │ -00009410: 696e 2047 5255 4220 2873 7065 6369 6669 in GRUB (specifi │ │ │ │ │ -00009420: 6320 7375 7070 6f72 7420 6973 2061 7661 c support is ava │ │ │ │ │ -00009430: 696c 6162 6c65 2066 6f72 204c 696e 7578 ilable for Linux │ │ │ │ │ -00009440: 2c20 4672 6565 4253 442c 0a4e 6574 4253 , FreeBSD,.NetBS │ │ │ │ │ -00009450: 4420 616e 6420 4f70 656e 4253 4429 206d D and OpenBSD) m │ │ │ │ │ -00009460: 7573 7420 6265 2063 6861 696e 2d6c 6f61 ust be chain-loa │ │ │ │ │ -00009470: 6465 642c 2077 6869 6368 2069 6e76 6f6c ded, which invol │ │ │ │ │ -00009480: 7665 7320 6c6f 6164 696e 6720 616e 6f74 ves loading anot │ │ │ │ │ -00009490: 6865 720a 626f 6f74 206c 6f61 6465 7220 her.boot loader │ │ │ │ │ -000094a0: 616e 6420 6a75 6d70 696e 6720 746f 2069 and jumping to i │ │ │ │ │ -000094b0: 7420 696e 2072 6561 6c20 6d6f 6465 2e0a t in real mode.. │ │ │ │ │ -000094c0: 0a20 2020 5468 6520 2763 6861 696e 6c6f . The 'chainlo │ │ │ │ │ -000094d0: 6164 6572 2720 636f 6d6d 616e 6420 282a ader' command (* │ │ │ │ │ -000094e0: 6e6f 7465 2063 6861 696e 6c6f 6164 6572 note chainloader │ │ │ │ │ -000094f0: 3a3a 2920 6973 2075 7365 6420 746f 2073 ::) is used to s │ │ │ │ │ -00009500: 6574 2074 6869 730a 7570 2e20 2049 7420 et this.up. It │ │ │ │ │ -00009510: 6973 206e 6f72 6d61 6c6c 7920 616c 736f is normally also │ │ │ │ │ -00009520: 206e 6563 6573 7361 7279 2074 6f20 6c6f necessary to lo │ │ │ │ │ -00009530: 6164 2073 6f6d 6520 4752 5542 206d 6f64 ad some GRUB mod │ │ │ │ │ -00009540: 756c 6573 2061 6e64 2073 6574 2074 6865 ules and set the │ │ │ │ │ -00009550: 0a61 7070 726f 7072 6961 7465 2072 6f6f .appropriate roo │ │ │ │ │ -00009560: 7420 6465 7669 6365 2e20 2050 7574 7469 t device. Putti │ │ │ │ │ -00009570: 6e67 2074 6869 7320 746f 6765 7468 6572 ng this together │ │ │ │ │ -00009580: 2c20 7765 2067 6574 2073 6f6d 6574 6869 , we get somethi │ │ │ │ │ -00009590: 6e67 206c 696b 650a 7468 6973 2c20 666f ng like.this, fo │ │ │ │ │ -000095a0: 7220 6120 5769 6e64 6f77 7320 7379 7374 r a Windows syst │ │ │ │ │ -000095b0: 656d 206f 6e20 7468 6520 6669 7273 7420 em on the first │ │ │ │ │ -000095c0: 7061 7274 6974 696f 6e20 6f66 2074 6865 partition of the │ │ │ │ │ -000095d0: 2066 6972 7374 2068 6172 640a 6469 736b first hard.disk │ │ │ │ │ -000095e0: 3a0a 0a6d 656e 7565 6e74 7279 2022 5769 :..menuentry "Wi │ │ │ │ │ -000095f0: 6e64 6f77 7322 207b 0a09 696e 736d 6f64 ndows" {..insmod │ │ │ │ │ -00009600: 2063 6861 696e 0a09 696e 736d 6f64 206e chain..insmod n │ │ │ │ │ -00009610: 7466 730a 0973 6574 2072 6f6f 743d 2868 tfs..set root=(h │ │ │ │ │ -00009620: 6430 2c31 290a 0963 6861 696e 6c6f 6164 d0,1)..chainload │ │ │ │ │ -00009630: 6572 202b 310a 7d0a 0a20 2020 4f6e 2073 er +1.}.. On s │ │ │ │ │ -00009640: 7973 7465 6d73 2077 6974 6820 6d75 6c74 ystems with mult │ │ │ │ │ -00009650: 6970 6c65 2068 6172 6420 6469 736b 732c iple hard disks, │ │ │ │ │ -00009660: 2061 6e20 6164 6469 7469 6f6e 616c 2077 an additional w │ │ │ │ │ -00009670: 6f72 6b61 726f 756e 6420 6d61 7920 6265 orkaround may be │ │ │ │ │ -00009680: 0a72 6571 7569 7265 642e 2020 2a4e 6f74 .required. *Not │ │ │ │ │ -00009690: 6520 444f 532f 5769 6e64 6f77 733a 3a2e e DOS/Windows::. │ │ │ │ │ -000096a0: 0a0a 2020 2043 6861 696e 2d6c 6f61 6469 .. Chain-loadi │ │ │ │ │ -000096b0: 6e67 2069 7320 6f6e 6c79 2073 7570 706f ng is only suppo │ │ │ │ │ -000096c0: 7274 6564 206f 6e20 5043 2042 494f 5320 rted on PC BIOS │ │ │ │ │ -000096d0: 616e 6420 4546 4920 706c 6174 666f 726d and EFI platform │ │ │ │ │ -000096e0: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ -000096f0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4c6f .info, Node: Lo │ │ │ │ │ -00009700: 6f70 6261 636b 2062 6f6f 7469 6e67 2c20 opback booting, │ │ │ │ │ -00009710: 204e 6578 743a 204c 564d 2063 6163 6865 Next: LVM cache │ │ │ │ │ -00009720: 2062 6f6f 7469 6e67 2c20 2050 7265 763a booting, Prev: │ │ │ │ │ -00009730: 2047 656e 6572 616c 2062 6f6f 7420 6d65 General boot me │ │ │ │ │ -00009740: 7468 6f64 732c 2020 5570 3a20 426f 6f74 thods, Up: Boot │ │ │ │ │ -00009750: 696e 670a 0a35 2e32 204c 6f6f 7062 6163 ing..5.2 Loopbac │ │ │ │ │ -00009760: 6b20 626f 6f74 696e 670a 3d3d 3d3d 3d3d k booting.====== │ │ │ │ │ -00009770: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -00009780: 4752 5542 2069 7320 6162 6c65 2074 6f20 GRUB is able to │ │ │ │ │ -00009790: 7265 6164 2066 726f 6d20 616e 2069 6d61 read from an ima │ │ │ │ │ -000097a0: 6765 2028 6265 2069 7420 6f6e 6520 6f66 ge (be it one of │ │ │ │ │ -000097b0: 2043 4420 6f72 2048 4444 2920 7374 6f72 CD or HDD) stor │ │ │ │ │ -000097c0: 6564 206f 6e0a 616e 7920 6f66 2069 7473 ed on.any of its │ │ │ │ │ -000097d0: 2061 6363 6573 7369 626c 6520 7374 6f72 accessible stor │ │ │ │ │ -000097e0: 6167 6573 2028 7265 6665 7220 746f 202a ages (refer to * │ │ │ │ │ -000097f0: 6e6f 7465 206c 6f6f 7062 6163 6b3a 3a20 note loopback:: │ │ │ │ │ -00009800: 636f 6d6d 616e 6429 2e0a 486f 7765 7665 command)..Howeve │ │ │ │ │ -00009810: 7220 7468 6520 4f53 2069 7473 656c 6620 r the OS itself │ │ │ │ │ -00009820: 7368 6f75 6c64 2062 6520 6162 6c65 2074 should be able t │ │ │ │ │ -00009830: 6f20 6669 6e64 2069 7473 2072 6f6f 742e o find its root. │ │ │ │ │ -00009840: 2020 5468 6973 2075 7375 616c 6c79 0a69 This usually.i │ │ │ │ │ -00009850: 6e76 6f6c 7665 7320 7275 6e6e 696e 6720 nvolves running │ │ │ │ │ -00009860: 6120 7573 6572 7370 6163 6520 7072 6f67 a userspace prog │ │ │ │ │ -00009870: 7261 6d20 7275 6e6e 696e 6720 6265 666f ram running befo │ │ │ │ │ -00009880: 7265 2074 6865 2072 6561 6c20 726f 6f74 re the real root │ │ │ │ │ -00009890: 2069 730a 6469 7363 6f76 6572 6564 2e20 is.discovered. │ │ │ │ │ -000098a0: 2054 6869 7320 6973 2061 6368 6965 7665 This is achieve │ │ │ │ │ -000098b0: 6420 6279 2047 5255 4220 6c6f 6164 696e d by GRUB loadin │ │ │ │ │ -000098c0: 6720 6120 7370 6563 6961 6c6c 7920 6d61 g a specially ma │ │ │ │ │ -000098d0: 6465 2073 6d61 6c6c 0a69 6d61 6765 2061 de small.image a │ │ │ │ │ -000098e0: 6e64 2070 6173 7369 6e67 2069 7420 6173 nd passing it as │ │ │ │ │ -000098f0: 2072 616d 6469 736b 2074 6f20 7468 6520 ramdisk to the │ │ │ │ │ -00009900: 6b65 726e 656c 2e20 2054 6869 7320 6973 kernel. This is │ │ │ │ │ -00009910: 2061 6368 6965 7665 6420 6279 0a63 6f6d achieved by.com │ │ │ │ │ -00009920: 6d61 6e64 7320 276b 6672 6565 6273 645f mands 'kfreebsd_ │ │ │ │ │ -00009930: 6d6f 6475 6c65 272c 2027 6b6e 6574 6273 module', 'knetbs │ │ │ │ │ -00009940: 645f 6d6f 6475 6c65 5f65 6c66 272c 2027 d_module_elf', ' │ │ │ │ │ -00009950: 6b6f 7065 6e62 7364 5f72 616d 6469 736b kopenbsd_ramdisk │ │ │ │ │ -00009960: 272c 0a27 696e 6974 7264 2720 282a 6e6f ',.'initrd' (*no │ │ │ │ │ -00009970: 7465 2069 6e69 7472 643a 3a29 2c20 2769 te initrd::), 'i │ │ │ │ │ -00009980: 6e69 7472 6431 3627 2028 2a6e 6f74 6520 nitrd16' (*note │ │ │ │ │ -00009990: 696e 6974 7264 3a3a 292c 0a27 6d75 6c74 initrd::),.'mult │ │ │ │ │ -000099a0: 6962 6f6f 745f 6d6f 6475 6c65 272c 2027 iboot_module', ' │ │ │ │ │ -000099b0: 6d75 6c74 6962 6f6f 7432 5f6d 6f64 756c multiboot2_modul │ │ │ │ │ -000099c0: 6527 206f 7220 2778 6e75 5f72 616d 6469 e' or 'xnu_ramdi │ │ │ │ │ -000099d0: 736b 2720 6465 7065 6e64 696e 6720 6f6e sk' depending on │ │ │ │ │ -000099e0: 0a74 6865 206c 6f61 6465 722e 2020 4e6f .the loader. No │ │ │ │ │ -000099f0: 7465 2074 6861 7420 666f 7220 6b6e 6574 te that for knet │ │ │ │ │ -00009a00: 6273 6420 7468 6520 696d 6167 6520 6d75 bsd the image mu │ │ │ │ │ -00009a10: 7374 2062 6520 7075 7420 696e 7369 6465 st be put inside │ │ │ │ │ -00009a20: 0a6d 696e 6972 6f6f 742e 6b6d 6f64 2061 .miniroot.kmod a │ │ │ │ │ -00009a30: 6e64 2074 6865 2077 686f 6c65 206d 696e nd the whole min │ │ │ │ │ -00009a40: 6972 6f6f 742e 6b6d 6f64 2068 6173 2074 iroot.kmod has t │ │ │ │ │ -00009a50: 6f20 6265 206c 6f61 6465 642e 2020 496e o be loaded. In │ │ │ │ │ -00009a60: 206b 6f70 656e 6273 640a 7061 796c 6f61 kopenbsd.payloa │ │ │ │ │ -00009a70: 6420 7468 6973 2069 7320 6469 7361 626c d this is disabl │ │ │ │ │ -00009a80: 6564 2062 7920 6465 6661 756c 742e 2020 ed by default. │ │ │ │ │ -00009a90: 4164 6974 696f 6e61 6c6c 7920 6265 6861 Aditionally beha │ │ │ │ │ -00009aa0: 7669 6f75 7220 6f66 2069 6e69 7469 616c viour of initial │ │ │ │ │ -00009ab0: 0a72 616d 6469 736b 2064 6570 656e 6473 .ramdisk depends │ │ │ │ │ -00009ac0: 206f 6e20 636f 6d6d 616e 6420 6c69 6e65 on command line │ │ │ │ │ -00009ad0: 206f 7074 696f 6e73 2e20 2053 6576 6572 options. Sever │ │ │ │ │ -00009ae0: 616c 2064 6973 7472 6962 7574 6f72 7320 al distributors │ │ │ │ │ -00009af0: 7072 6f76 6964 650a 7468 6520 696d 6167 provide.the imag │ │ │ │ │ -00009b00: 6520 666f 7220 7468 6973 2070 7572 706f e for this purpo │ │ │ │ │ -00009b10: 7365 206f 7220 6974 2773 2069 6e74 6567 se or it's integ │ │ │ │ │ -00009b20: 7261 7465 6420 696e 2074 6865 6972 2073 rated in their s │ │ │ │ │ -00009b30: 7461 6e64 6172 6420 7261 6d64 6973 6b0a tandard ramdisk. │ │ │ │ │ -00009b40: 616e 6420 6163 7469 7661 7465 6420 6279 and activated by │ │ │ │ │ -00009b50: 2073 7065 6369 616c 206f 7074 696f 6e2e special option. │ │ │ │ │ -00009b60: 2020 436f 6e73 756c 7420 796f 7572 206b Consult your k │ │ │ │ │ -00009b70: 6572 6e65 6c20 616e 6420 6469 7374 7269 ernel and distri │ │ │ │ │ -00009b80: 6275 7469 6f6e 0a6d 616e 7561 6c20 666f bution.manual fo │ │ │ │ │ -00009b90: 7220 6d6f 7265 2064 6574 6169 6c73 2e20 r more details. │ │ │ │ │ -00009ba0: 204f 7468 6572 206c 6f61 6465 7273 206c Other loaders l │ │ │ │ │ -00009bb0: 696b 6520 6170 706c 656c 6f61 6465 722c ike appleloader, │ │ │ │ │ -00009bc0: 2063 6861 696e 6c6f 6164 6572 0a28 4249 chainloader.(BI │ │ │ │ │ -00009bd0: 4f53 2c20 4546 492c 2063 6f72 6562 6f6f OS, EFI, coreboo │ │ │ │ │ -00009be0: 7429 2c20 6672 6565 646f 732c 206e 746c t), freedos, ntl │ │ │ │ │ -00009bf0: 6472 2061 6e64 2070 6c61 6e39 2070 726f dr and plan9 pro │ │ │ │ │ -00009c00: 7669 6465 206e 6f20 706f 7373 6962 696c vide no possibil │ │ │ │ │ -00009c10: 6974 790a 6f66 206c 6f61 6469 6e67 2069 ity.of loading i │ │ │ │ │ -00009c20: 6e69 7469 616c 2072 616d 6469 736b 2061 nitial ramdisk a │ │ │ │ │ -00009c30: 6e64 2061 7320 6661 7220 6173 2061 7574 nd as far as aut │ │ │ │ │ -00009c40: 686f 7220 6973 2061 7761 7265 2074 6865 hor is aware the │ │ │ │ │ -00009c50: 2070 6179 6c6f 6164 7320 696e 0a71 7565 payloads in.que │ │ │ │ │ -00009c60: 7374 696f 6e20 646f 6e27 7420 7375 7070 stion don't supp │ │ │ │ │ -00009c70: 6f72 7420 6569 7468 6572 2069 6e69 7469 ort either initi │ │ │ │ │ -00009c80: 616c 2072 616d 6469 736b 206f 7220 6469 al ramdisk or di │ │ │ │ │ -00009c90: 7363 6f76 6572 696e 6720 6c6f 6f70 6261 scovering loopba │ │ │ │ │ -00009ca0: 636b 0a62 6f6f 7420 696e 206f 7468 6572 ck.boot in other │ │ │ │ │ -00009cb0: 2077 6179 2061 6e64 2061 7320 7375 6368 way and as such │ │ │ │ │ -00009cc0: 206e 6f74 2062 6f6f 7461 626c 6520 7468 not bootable th │ │ │ │ │ -00009cd0: 6973 2077 6179 2e20 2050 6c65 6173 6520 is way. Please │ │ │ │ │ -00009ce0: 636f 6e73 6964 6572 0a61 6c74 6572 6e61 consider.alterna │ │ │ │ │ -00009cf0: 7469 7665 2062 6f6f 7420 6d65 7468 6f64 tive boot method │ │ │ │ │ -00009d00: 7320 6c69 6b65 2063 6f70 7969 6e67 2061 s like copying a │ │ │ │ │ -00009d10: 6c6c 2066 696c 6573 2066 726f 6d20 7468 ll files from th │ │ │ │ │ -00009d20: 6520 696d 6167 6520 746f 2061 6374 7561 e image to actua │ │ │ │ │ -00009d30: 6c0a 7061 7274 6974 696f 6e2e 2020 436f l.partition. Co │ │ │ │ │ -00009d40: 6e73 756c 7420 796f 7572 204f 5320 646f nsult your OS do │ │ │ │ │ -00009d50: 6375 6d65 6e74 6174 696f 6e20 666f 7220 cumentation for │ │ │ │ │ -00009d60: 6d6f 7265 2064 6574 6169 6c73 0a0a 1f0a more details.... │ │ │ │ │ -00009d70: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -00009d80: 2020 4e6f 6465 3a20 4c56 4d20 6361 6368 Node: LVM cach │ │ │ │ │ -00009d90: 6520 626f 6f74 696e 672c 2020 4e65 7874 e booting, Next │ │ │ │ │ -00009da0: 3a20 4f53 2d73 7065 6369 6669 6320 6e6f : OS-specific no │ │ │ │ │ -00009db0: 7465 732c 2020 5072 6576 3a20 4c6f 6f70 tes, Prev: Loop │ │ │ │ │ -00009dc0: 6261 636b 2062 6f6f 7469 6e67 2c20 2055 back booting, U │ │ │ │ │ -00009dd0: 703a 2042 6f6f 7469 6e67 0a0a 352e 3320 p: Booting..5.3 │ │ │ │ │ -00009de0: 426f 6f74 696e 6720 6672 6f6d 204c 564d Booting from LVM │ │ │ │ │ -00009df0: 2063 6163 6865 206c 6f67 6963 616c 2076 cache logical v │ │ │ │ │ -00009e00: 6f6c 756d 650a 3d3d 3d3d 3d3d 3d3d 3d3d olume.========== │ │ │ │ │ +00009100: 2d2d 2d2d 2d2d 0a0a 4d75 6c74 6962 6f6f ------..Multiboo │ │ │ │ │ +00009110: 7420 282a 6e6f 7465 204d 756c 7469 626f t (*note Multibo │ │ │ │ │ +00009120: 6f74 2053 7065 6369 6669 6361 7469 6f6e ot Specification │ │ │ │ │ +00009130: 3a20 286d 756c 7469 626f 6f74 2954 6f70 : (multiboot)Top │ │ │ │ │ +00009140: 2e29 2069 7320 7468 6520 6e61 7469 7665 .) is the native │ │ │ │ │ +00009150: 0a66 6f72 6d61 7420 7375 7070 6f72 7465 .format supporte │ │ │ │ │ +00009160: 6420 6279 2047 5255 422e 2046 6f72 2074 d by GRUB. For t │ │ │ │ │ +00009170: 6865 2073 616b 6520 6f66 2063 6f6e 7665 he sake of conve │ │ │ │ │ +00009180: 6e69 656e 6365 2c20 7468 6572 6520 6973 nience, there is │ │ │ │ │ +00009190: 2061 6c73 6f0a 7375 7070 6f72 7420 666f also.support fo │ │ │ │ │ +000091a0: 7220 4c69 6e75 782c 2046 7265 6542 5344 r Linux, FreeBSD │ │ │ │ │ +000091b0: 2c20 4e65 7442 5344 2061 6e64 204f 7065 , NetBSD and Ope │ │ │ │ │ +000091c0: 6e42 5344 2e20 4966 2079 6f75 2077 616e nBSD. If you wan │ │ │ │ │ +000091d0: 7420 746f 2062 6f6f 740a 6f74 6865 7220 t to boot.other │ │ │ │ │ +000091e0: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +000091f0: 732c 2079 6f75 2077 696c 6c20 6861 7665 s, you will have │ │ │ │ │ +00009200: 2074 6f20 6368 6169 6e2d 6c6f 6164 2074 to chain-load t │ │ │ │ │ +00009210: 6865 6d20 282a 6e6f 7465 0a43 6861 696e hem (*note.Chain │ │ │ │ │ +00009220: 2d6c 6f61 6469 6e67 3a3a 292e 0a0a 2020 -loading::)... │ │ │ │ │ +00009230: 2046 4958 4d45 3a20 7468 6973 2073 6563 FIXME: this sec │ │ │ │ │ +00009240: 7469 6f6e 2069 7320 696e 636f 6d70 6c65 tion is incomple │ │ │ │ │ +00009250: 7465 2e0a 0a20 2031 2e20 5275 6e20 7468 te... 1. Run th │ │ │ │ │ +00009260: 6520 636f 6d6d 616e 6420 2762 6f6f 7427 e command 'boot' │ │ │ │ │ +00009270: 2028 2a6e 6f74 6520 626f 6f74 3a3a 292e (*note boot::). │ │ │ │ │ +00009280: 0a0a 2020 2048 6f77 6576 6572 2c20 444f .. However, DO │ │ │ │ │ +00009290: 5320 616e 6420 5769 6e64 6f77 7320 6861 S and Windows ha │ │ │ │ │ +000092a0: 7665 2073 6f6d 6520 6465 6669 6369 656e ve some deficien │ │ │ │ │ +000092b0: 6369 6573 2c20 736f 2079 6f75 206d 6967 cies, so you mig │ │ │ │ │ +000092c0: 6874 2068 6176 6520 746f 0a75 7365 206d ht have to.use m │ │ │ │ │ +000092d0: 6f72 6520 636f 6d70 6c69 6361 7465 6420 ore complicated │ │ │ │ │ +000092e0: 696e 7374 7275 6374 696f 6e73 2e20 202a instructions. * │ │ │ │ │ +000092f0: 4e6f 7465 2044 4f53 2f57 696e 646f 7773 Note DOS/Windows │ │ │ │ │ +00009300: 3a3a 2c20 666f 7220 6d6f 7265 0a69 6e66 ::, for more.inf │ │ │ │ │ +00009310: 6f72 6d61 7469 6f6e 2e0a 0a1f 0a46 696c ormation.....Fil │ │ │ │ │ +00009320: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00009330: 6f64 653a 2043 6861 696e 2d6c 6f61 6469 ode: Chain-loadi │ │ │ │ │ +00009340: 6e67 2c20 2050 7265 763a 204c 6f61 6469 ng, Prev: Loadi │ │ │ │ │ +00009350: 6e67 2061 6e20 6f70 6572 6174 696e 6720 ng an operating │ │ │ │ │ +00009360: 7379 7374 656d 2064 6972 6563 746c 792c system directly, │ │ │ │ │ +00009370: 2020 5570 3a20 4765 6e65 7261 6c20 626f Up: General bo │ │ │ │ │ +00009380: 6f74 206d 6574 686f 6473 0a0a 352e 312e ot methods..5.1. │ │ │ │ │ +00009390: 3220 4368 6169 6e2d 6c6f 6164 696e 6720 2 Chain-loading │ │ │ │ │ +000093a0: 616e 204f 530a 2d2d 2d2d 2d2d 2d2d 2d2d an OS.---------- │ │ │ │ │ +000093b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +000093c0: 0a4f 7065 7261 7469 6e67 2073 7973 7465 .Operating syste │ │ │ │ │ +000093d0: 6d73 2074 6861 7420 646f 206e 6f74 2073 ms that do not s │ │ │ │ │ +000093e0: 7570 706f 7274 204d 756c 7469 626f 6f74 upport Multiboot │ │ │ │ │ +000093f0: 2061 6e64 2064 6f20 6e6f 7420 6861 7665 and do not have │ │ │ │ │ +00009400: 2073 7065 6369 6669 630a 7375 7070 6f72 specific.suppor │ │ │ │ │ +00009410: 7420 696e 2047 5255 4220 2873 7065 6369 t in GRUB (speci │ │ │ │ │ +00009420: 6669 6320 7375 7070 6f72 7420 6973 2061 fic support is a │ │ │ │ │ +00009430: 7661 696c 6162 6c65 2066 6f72 204c 696e vailable for Lin │ │ │ │ │ +00009440: 7578 2c20 4672 6565 4253 442c 0a4e 6574 ux, FreeBSD,.Net │ │ │ │ │ +00009450: 4253 4420 616e 6420 4f70 656e 4253 4429 BSD and OpenBSD) │ │ │ │ │ +00009460: 206d 7573 7420 6265 2063 6861 696e 2d6c must be chain-l │ │ │ │ │ +00009470: 6f61 6465 642c 2077 6869 6368 2069 6e76 oaded, which inv │ │ │ │ │ +00009480: 6f6c 7665 7320 6c6f 6164 696e 6720 616e olves loading an │ │ │ │ │ +00009490: 6f74 6865 720a 626f 6f74 206c 6f61 6465 other.boot loade │ │ │ │ │ +000094a0: 7220 616e 6420 6a75 6d70 696e 6720 746f r and jumping to │ │ │ │ │ +000094b0: 2069 7420 696e 2072 6561 6c20 6d6f 6465 it in real mode │ │ │ │ │ +000094c0: 2e0a 0a20 2020 5468 6520 2763 6861 696e ... The 'chain │ │ │ │ │ +000094d0: 6c6f 6164 6572 2720 636f 6d6d 616e 6420 loader' command │ │ │ │ │ +000094e0: 282a 6e6f 7465 2063 6861 696e 6c6f 6164 (*note chainload │ │ │ │ │ +000094f0: 6572 3a3a 2920 6973 2075 7365 6420 746f er::) is used to │ │ │ │ │ +00009500: 2073 6574 2074 6869 730a 7570 2e20 2049 set this.up. I │ │ │ │ │ +00009510: 7420 6973 206e 6f72 6d61 6c6c 7920 616c t is normally al │ │ │ │ │ +00009520: 736f 206e 6563 6573 7361 7279 2074 6f20 so necessary to │ │ │ │ │ +00009530: 6c6f 6164 2073 6f6d 6520 4752 5542 206d load some GRUB m │ │ │ │ │ +00009540: 6f64 756c 6573 2061 6e64 2073 6574 2074 odules and set t │ │ │ │ │ +00009550: 6865 0a61 7070 726f 7072 6961 7465 2072 he.appropriate r │ │ │ │ │ +00009560: 6f6f 7420 6465 7669 6365 2e20 2050 7574 oot device. Put │ │ │ │ │ +00009570: 7469 6e67 2074 6869 7320 746f 6765 7468 ting this togeth │ │ │ │ │ +00009580: 6572 2c20 7765 2067 6574 2073 6f6d 6574 er, we get somet │ │ │ │ │ +00009590: 6869 6e67 206c 696b 650a 7468 6973 2c20 hing like.this, │ │ │ │ │ +000095a0: 666f 7220 6120 5769 6e64 6f77 7320 7379 for a Windows sy │ │ │ │ │ +000095b0: 7374 656d 206f 6e20 7468 6520 6669 7273 stem on the firs │ │ │ │ │ +000095c0: 7420 7061 7274 6974 696f 6e20 6f66 2074 t partition of t │ │ │ │ │ +000095d0: 6865 2066 6972 7374 2068 6172 640a 6469 he first hard.di │ │ │ │ │ +000095e0: 736b 3a0a 0a6d 656e 7565 6e74 7279 2022 sk:..menuentry " │ │ │ │ │ +000095f0: 5769 6e64 6f77 7322 207b 0a09 696e 736d Windows" {..insm │ │ │ │ │ +00009600: 6f64 2063 6861 696e 0a09 696e 736d 6f64 od chain..insmod │ │ │ │ │ +00009610: 206e 7466 730a 0973 6574 2072 6f6f 743d ntfs..set root= │ │ │ │ │ +00009620: 2868 6430 2c31 290a 0963 6861 696e 6c6f (hd0,1)..chainlo │ │ │ │ │ +00009630: 6164 6572 202b 310a 7d0a 0a20 2020 4f6e ader +1.}.. On │ │ │ │ │ +00009640: 2073 7973 7465 6d73 2077 6974 6820 6d75 systems with mu │ │ │ │ │ +00009650: 6c74 6970 6c65 2068 6172 6420 6469 736b ltiple hard disk │ │ │ │ │ +00009660: 732c 2061 6e20 6164 6469 7469 6f6e 616c s, an additional │ │ │ │ │ +00009670: 2077 6f72 6b61 726f 756e 6420 6d61 7920 workaround may │ │ │ │ │ +00009680: 6265 0a72 6571 7569 7265 642e 2020 2a4e be.required. *N │ │ │ │ │ +00009690: 6f74 6520 444f 532f 5769 6e64 6f77 733a ote DOS/Windows: │ │ │ │ │ +000096a0: 3a2e 0a0a 2020 2043 6861 696e 2d6c 6f61 :... Chain-loa │ │ │ │ │ +000096b0: 6469 6e67 2069 7320 6f6e 6c79 2073 7570 ding is only sup │ │ │ │ │ +000096c0: 706f 7274 6564 206f 6e20 5043 2042 494f ported on PC BIO │ │ │ │ │ +000096d0: 5320 616e 6420 4546 4920 706c 6174 666f S and EFI platfo │ │ │ │ │ +000096e0: 726d 732e 0a0a 1f0a 4669 6c65 3a20 6772 rms.....File: gr │ │ │ │ │ +000096f0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00009700: 4c6f 6f70 6261 636b 2062 6f6f 7469 6e67 Loopback booting │ │ │ │ │ +00009710: 2c20 204e 6578 743a 204c 564d 2063 6163 , Next: LVM cac │ │ │ │ │ +00009720: 6865 2062 6f6f 7469 6e67 2c20 2050 7265 he booting, Pre │ │ │ │ │ +00009730: 763a 2047 656e 6572 616c 2062 6f6f 7420 v: General boot │ │ │ │ │ +00009740: 6d65 7468 6f64 732c 2020 5570 3a20 426f methods, Up: Bo │ │ │ │ │ +00009750: 6f74 696e 670a 0a35 2e32 204c 6f6f 7062 oting..5.2 Loopb │ │ │ │ │ +00009760: 6163 6b20 626f 6f74 696e 670a 3d3d 3d3d ack booting.==== │ │ │ │ │ +00009770: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00009780: 0a0a 4752 5542 2069 7320 6162 6c65 2074 ..GRUB is able t │ │ │ │ │ +00009790: 6f20 7265 6164 2066 726f 6d20 616e 2069 o read from an i │ │ │ │ │ +000097a0: 6d61 6765 2028 6265 2069 7420 6f6e 6520 mage (be it one │ │ │ │ │ +000097b0: 6f66 2043 4420 6f72 2048 4444 2920 7374 of CD or HDD) st │ │ │ │ │ +000097c0: 6f72 6564 206f 6e0a 616e 7920 6f66 2069 ored on.any of i │ │ │ │ │ +000097d0: 7473 2061 6363 6573 7369 626c 6520 7374 ts accessible st │ │ │ │ │ +000097e0: 6f72 6167 6573 2028 7265 6665 7220 746f orages (refer to │ │ │ │ │ +000097f0: 202a 6e6f 7465 206c 6f6f 7062 6163 6b3a *note loopback: │ │ │ │ │ +00009800: 3a20 636f 6d6d 616e 6429 2e0a 486f 7765 : command)..Howe │ │ │ │ │ +00009810: 7665 7220 7468 6520 4f53 2069 7473 656c ver the OS itsel │ │ │ │ │ +00009820: 6620 7368 6f75 6c64 2062 6520 6162 6c65 f should be able │ │ │ │ │ +00009830: 2074 6f20 6669 6e64 2069 7473 2072 6f6f to find its roo │ │ │ │ │ +00009840: 742e 2020 5468 6973 2075 7375 616c 6c79 t. This usually │ │ │ │ │ +00009850: 0a69 6e76 6f6c 7665 7320 7275 6e6e 696e .involves runnin │ │ │ │ │ +00009860: 6720 6120 7573 6572 7370 6163 6520 7072 g a userspace pr │ │ │ │ │ +00009870: 6f67 7261 6d20 7275 6e6e 696e 6720 6265 ogram running be │ │ │ │ │ +00009880: 666f 7265 2074 6865 2072 6561 6c20 726f fore the real ro │ │ │ │ │ +00009890: 6f74 2069 730a 6469 7363 6f76 6572 6564 ot is.discovered │ │ │ │ │ +000098a0: 2e20 2054 6869 7320 6973 2061 6368 6965 . This is achie │ │ │ │ │ +000098b0: 7665 6420 6279 2047 5255 4220 6c6f 6164 ved by GRUB load │ │ │ │ │ +000098c0: 696e 6720 6120 7370 6563 6961 6c6c 7920 ing a specially │ │ │ │ │ +000098d0: 6d61 6465 2073 6d61 6c6c 0a69 6d61 6765 made small.image │ │ │ │ │ +000098e0: 2061 6e64 2070 6173 7369 6e67 2069 7420 and passing it │ │ │ │ │ +000098f0: 6173 2072 616d 6469 736b 2074 6f20 7468 as ramdisk to th │ │ │ │ │ +00009900: 6520 6b65 726e 656c 2e20 2054 6869 7320 e kernel. This │ │ │ │ │ +00009910: 6973 2061 6368 6965 7665 6420 6279 0a63 is achieved by.c │ │ │ │ │ +00009920: 6f6d 6d61 6e64 7320 276b 6672 6565 6273 ommands 'kfreebs │ │ │ │ │ +00009930: 645f 6d6f 6475 6c65 272c 2027 6b6e 6574 d_module', 'knet │ │ │ │ │ +00009940: 6273 645f 6d6f 6475 6c65 5f65 6c66 272c bsd_module_elf', │ │ │ │ │ +00009950: 2027 6b6f 7065 6e62 7364 5f72 616d 6469 'kopenbsd_ramdi │ │ │ │ │ +00009960: 736b 272c 0a27 696e 6974 7264 2720 282a sk',.'initrd' (* │ │ │ │ │ +00009970: 6e6f 7465 2069 6e69 7472 643a 3a29 2c20 note initrd::), │ │ │ │ │ +00009980: 2769 6e69 7472 6431 3627 2028 2a6e 6f74 'initrd16' (*not │ │ │ │ │ +00009990: 6520 696e 6974 7264 3a3a 292c 0a27 6d75 e initrd::),.'mu │ │ │ │ │ +000099a0: 6c74 6962 6f6f 745f 6d6f 6475 6c65 272c ltiboot_module', │ │ │ │ │ +000099b0: 2027 6d75 6c74 6962 6f6f 7432 5f6d 6f64 'multiboot2_mod │ │ │ │ │ +000099c0: 756c 6527 206f 7220 2778 6e75 5f72 616d ule' or 'xnu_ram │ │ │ │ │ +000099d0: 6469 736b 2720 6465 7065 6e64 696e 6720 disk' depending │ │ │ │ │ +000099e0: 6f6e 0a74 6865 206c 6f61 6465 722e 2020 on.the loader. │ │ │ │ │ +000099f0: 4e6f 7465 2074 6861 7420 666f 7220 6b6e Note that for kn │ │ │ │ │ +00009a00: 6574 6273 6420 7468 6520 696d 6167 6520 etbsd the image │ │ │ │ │ +00009a10: 6d75 7374 2062 6520 7075 7420 696e 7369 must be put insi │ │ │ │ │ +00009a20: 6465 0a6d 696e 6972 6f6f 742e 6b6d 6f64 de.miniroot.kmod │ │ │ │ │ +00009a30: 2061 6e64 2074 6865 2077 686f 6c65 206d and the whole m │ │ │ │ │ +00009a40: 696e 6972 6f6f 742e 6b6d 6f64 2068 6173 iniroot.kmod has │ │ │ │ │ +00009a50: 2074 6f20 6265 206c 6f61 6465 642e 2020 to be loaded. │ │ │ │ │ +00009a60: 496e 206b 6f70 656e 6273 640a 7061 796c In kopenbsd.payl │ │ │ │ │ +00009a70: 6f61 6420 7468 6973 2069 7320 6469 7361 oad this is disa │ │ │ │ │ +00009a80: 626c 6564 2062 7920 6465 6661 756c 742e bled by default. │ │ │ │ │ +00009a90: 2020 4164 6974 696f 6e61 6c6c 7920 6265 Aditionally be │ │ │ │ │ +00009aa0: 6861 7669 6f75 7220 6f66 2069 6e69 7469 haviour of initi │ │ │ │ │ +00009ab0: 616c 0a72 616d 6469 736b 2064 6570 656e al.ramdisk depen │ │ │ │ │ +00009ac0: 6473 206f 6e20 636f 6d6d 616e 6420 6c69 ds on command li │ │ │ │ │ +00009ad0: 6e65 206f 7074 696f 6e73 2e20 2053 6576 ne options. Sev │ │ │ │ │ +00009ae0: 6572 616c 2064 6973 7472 6962 7574 6f72 eral distributor │ │ │ │ │ +00009af0: 7320 7072 6f76 6964 650a 7468 6520 696d s provide.the im │ │ │ │ │ +00009b00: 6167 6520 666f 7220 7468 6973 2070 7572 age for this pur │ │ │ │ │ +00009b10: 706f 7365 206f 7220 6974 2773 2069 6e74 pose or it's int │ │ │ │ │ +00009b20: 6567 7261 7465 6420 696e 2074 6865 6972 egrated in their │ │ │ │ │ +00009b30: 2073 7461 6e64 6172 6420 7261 6d64 6973 standard ramdis │ │ │ │ │ +00009b40: 6b0a 616e 6420 6163 7469 7661 7465 6420 k.and activated │ │ │ │ │ +00009b50: 6279 2073 7065 6369 616c 206f 7074 696f by special optio │ │ │ │ │ +00009b60: 6e2e 2020 436f 6e73 756c 7420 796f 7572 n. Consult your │ │ │ │ │ +00009b70: 206b 6572 6e65 6c20 616e 6420 6469 7374 kernel and dist │ │ │ │ │ +00009b80: 7269 6275 7469 6f6e 0a6d 616e 7561 6c20 ribution.manual │ │ │ │ │ +00009b90: 666f 7220 6d6f 7265 2064 6574 6169 6c73 for more details │ │ │ │ │ +00009ba0: 2e20 204f 7468 6572 206c 6f61 6465 7273 . Other loaders │ │ │ │ │ +00009bb0: 206c 696b 6520 6170 706c 656c 6f61 6465 like appleloade │ │ │ │ │ +00009bc0: 722c 2063 6861 696e 6c6f 6164 6572 0a28 r, chainloader.( │ │ │ │ │ +00009bd0: 4249 4f53 2c20 4546 492c 2063 6f72 6562 BIOS, EFI, coreb │ │ │ │ │ +00009be0: 6f6f 7429 2c20 6672 6565 646f 732c 206e oot), freedos, n │ │ │ │ │ +00009bf0: 746c 6472 2061 6e64 2070 6c61 6e39 2070 tldr and plan9 p │ │ │ │ │ +00009c00: 726f 7669 6465 206e 6f20 706f 7373 6962 rovide no possib │ │ │ │ │ +00009c10: 696c 6974 790a 6f66 206c 6f61 6469 6e67 ility.of loading │ │ │ │ │ +00009c20: 2069 6e69 7469 616c 2072 616d 6469 736b initial ramdisk │ │ │ │ │ +00009c30: 2061 6e64 2061 7320 6661 7220 6173 2061 and as far as a │ │ │ │ │ +00009c40: 7574 686f 7220 6973 2061 7761 7265 2074 uthor is aware t │ │ │ │ │ +00009c50: 6865 2070 6179 6c6f 6164 7320 696e 0a71 he payloads in.q │ │ │ │ │ +00009c60: 7565 7374 696f 6e20 646f 6e27 7420 7375 uestion don't su │ │ │ │ │ +00009c70: 7070 6f72 7420 6569 7468 6572 2069 6e69 pport either ini │ │ │ │ │ +00009c80: 7469 616c 2072 616d 6469 736b 206f 7220 tial ramdisk or │ │ │ │ │ +00009c90: 6469 7363 6f76 6572 696e 6720 6c6f 6f70 discovering loop │ │ │ │ │ +00009ca0: 6261 636b 0a62 6f6f 7420 696e 206f 7468 back.boot in oth │ │ │ │ │ +00009cb0: 6572 2077 6179 2061 6e64 2061 7320 7375 er way and as su │ │ │ │ │ +00009cc0: 6368 206e 6f74 2062 6f6f 7461 626c 6520 ch not bootable │ │ │ │ │ +00009cd0: 7468 6973 2077 6179 2e20 2050 6c65 6173 this way. Pleas │ │ │ │ │ +00009ce0: 6520 636f 6e73 6964 6572 0a61 6c74 6572 e consider.alter │ │ │ │ │ +00009cf0: 6e61 7469 7665 2062 6f6f 7420 6d65 7468 native boot meth │ │ │ │ │ +00009d00: 6f64 7320 6c69 6b65 2063 6f70 7969 6e67 ods like copying │ │ │ │ │ +00009d10: 2061 6c6c 2066 696c 6573 2066 726f 6d20 all files from │ │ │ │ │ +00009d20: 7468 6520 696d 6167 6520 746f 2061 6374 the image to act │ │ │ │ │ +00009d30: 7561 6c0a 7061 7274 6974 696f 6e2e 2020 ual.partition. │ │ │ │ │ +00009d40: 436f 6e73 756c 7420 796f 7572 204f 5320 Consult your OS │ │ │ │ │ +00009d50: 646f 6375 6d65 6e74 6174 696f 6e20 666f documentation fo │ │ │ │ │ +00009d60: 7220 6d6f 7265 2064 6574 6169 6c73 0a0a r more details.. │ │ │ │ │ +00009d70: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00009d80: 6f2c 2020 4e6f 6465 3a20 4c56 4d20 6361 o, Node: LVM ca │ │ │ │ │ +00009d90: 6368 6520 626f 6f74 696e 672c 2020 4e65 che booting, Ne │ │ │ │ │ +00009da0: 7874 3a20 4f53 2d73 7065 6369 6669 6320 xt: OS-specific │ │ │ │ │ +00009db0: 6e6f 7465 732c 2020 5072 6576 3a20 4c6f notes, Prev: Lo │ │ │ │ │ +00009dc0: 6f70 6261 636b 2062 6f6f 7469 6e67 2c20 opback booting, │ │ │ │ │ +00009dd0: 2055 703a 2042 6f6f 7469 6e67 0a0a 352e Up: Booting..5. │ │ │ │ │ +00009de0: 3320 426f 6f74 696e 6720 6672 6f6d 204c 3 Booting from L │ │ │ │ │ +00009df0: 564d 2063 6163 6865 206c 6f67 6963 616c VM cache logical │ │ │ │ │ +00009e00: 2076 6f6c 756d 650a 3d3d 3d3d 3d3d 3d3d volume.======== │ │ │ │ │ 00009e10: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00009e20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ -00009e30: 0a54 6865 204c 564d 2063 6163 6865 206c .The LVM cache l │ │ │ │ │ -00009e40: 6f67 6963 616c 2076 6f6c 756d 6520 6973 ogical volume is │ │ │ │ │ -00009e50: 2074 6865 206c 6f67 6963 616c 2076 6f6c the logical vol │ │ │ │ │ -00009e60: 756d 6520 636f 6e73 6973 7469 6e67 206f ume consisting o │ │ │ │ │ -00009e70: 6620 7468 650a 6f72 6967 696e 616c 2061 f the.original a │ │ │ │ │ -00009e80: 6e64 2074 6865 2063 6163 6865 2070 6f6f nd the cache poo │ │ │ │ │ -00009e90: 6c20 6c6f 6769 6361 6c20 766f 6c75 6d65 l logical volume │ │ │ │ │ -00009ea0: 2e20 2054 6865 206f 7269 6769 6e61 6c20 . The original │ │ │ │ │ -00009eb0: 6973 2075 7375 616c 6c79 206f 6e0a 6120 is usually on.a │ │ │ │ │ -00009ec0: 6c61 7267 6572 2061 6e64 2073 6c6f 7765 larger and slowe │ │ │ │ │ -00009ed0: 7220 7374 6f72 6167 6520 6465 7669 6365 r storage device │ │ │ │ │ -00009ee0: 2077 6869 6c65 2074 6865 2063 6163 6865 while the cache │ │ │ │ │ -00009ef0: 2070 6f6f 6c20 6973 206f 6e20 6120 736d pool is on a sm │ │ │ │ │ -00009f00: 616c 6c65 720a 616e 6420 6661 7374 6572 aller.and faster │ │ │ │ │ -00009f10: 206f 6e65 2e20 2054 6865 2070 6572 666f one. The perfo │ │ │ │ │ -00009f20: 726d 616e 6365 206f 6620 7468 6520 6f72 rmance of the or │ │ │ │ │ -00009f30: 6967 696e 616c 2076 6f6c 756d 6520 6361 iginal volume ca │ │ │ │ │ -00009f40: 6e20 6265 2069 6d70 726f 7665 640a 6279 n be improved.by │ │ │ │ │ -00009f50: 2073 746f 7269 6e67 2074 6865 2066 7265 storing the fre │ │ │ │ │ -00009f60: 7175 656e 746c 7920 7573 6564 2064 6174 quently used dat │ │ │ │ │ -00009f70: 6120 6f6e 2074 6865 2063 6163 6865 2070 a on the cache p │ │ │ │ │ -00009f80: 6f6f 6c20 746f 2075 7469 6c69 7a65 2074 ool to utilize t │ │ │ │ │ -00009f90: 6865 0a67 7265 6174 6572 2070 6572 666f he.greater perfo │ │ │ │ │ -00009fa0: 726d 616e 6365 206f 6620 6661 7374 6572 rmance of faster │ │ │ │ │ -00009fb0: 2064 6576 6963 652e 0a0a 2020 2047 5255 device... GRU │ │ │ │ │ -00009fc0: 4220 626f 6f74 7320 6672 6f6d 204c 564d B boots from LVM │ │ │ │ │ -00009fd0: 2063 6163 6865 206c 6f67 6963 616c 2076 cache logical v │ │ │ │ │ -00009fe0: 6f6c 756d 6520 6d65 7265 6c79 2062 7920 olume merely by │ │ │ │ │ -00009ff0: 7265 6164 696e 6720 6974 2773 0a6f 7269 reading it's.ori │ │ │ │ │ -0000a000: 6769 6e61 6c20 6c6f 6769 6361 6c20 766f ginal logical vo │ │ │ │ │ -0000a010: 6c75 6d65 2073 6f20 7468 6174 2064 6972 lume so that dir │ │ │ │ │ -0000a020: 7479 2064 6174 6120 696e 2063 6163 6865 ty data in cache │ │ │ │ │ -0000a030: 2070 6f6f 6c20 766f 6c75 6d65 2069 730a pool volume is. │ │ │ │ │ -0000a040: 6469 7372 6567 6172 6465 642e 2020 5468 disregarded. Th │ │ │ │ │ -0000a050: 6973 2069 7320 6e6f 7420 6120 7072 6f62 is is not a prob │ │ │ │ │ -0000a060: 6c65 6d20 666f 7220 2277 7269 7465 7468 lem for "writeth │ │ │ │ │ -0000a070: 726f 7567 6822 2063 6163 6865 206d 6f64 rough" cache mod │ │ │ │ │ -0000a080: 6520 6173 2069 740a 656e 7375 7265 7320 e as it.ensures │ │ │ │ │ -0000a090: 7468 6174 2061 6e79 2064 6174 6120 7772 that any data wr │ │ │ │ │ -0000a0a0: 6974 7465 6e20 7769 6c6c 2062 6520 7374 itten will be st │ │ │ │ │ -0000a0b0: 6f72 6564 2062 6f74 6820 6f6e 2074 6865 ored both on the │ │ │ │ │ -0000a0c0: 2063 6163 6865 2061 6e64 2074 6865 0a6f cache and the.o │ │ │ │ │ -0000a0d0: 7269 6769 6e20 4c56 2e20 466f 7220 7468 rigin LV. For th │ │ │ │ │ -0000a0e0: 6520 6f74 6865 7220 6361 6368 6520 6d6f e other cache mo │ │ │ │ │ -0000a0f0: 6465 2022 7772 6974 6562 6163 6b22 2c20 de "writeback", │ │ │ │ │ -0000a100: 7768 6963 6820 6465 6c61 7973 2077 7269 which delays wri │ │ │ │ │ -0000a110: 7469 6e67 0a66 726f 6d20 7468 6520 6361 ting.from the ca │ │ │ │ │ -0000a120: 6368 6520 706f 6f6c 2062 6163 6b20 746f che pool back to │ │ │ │ │ -0000a130: 2074 6865 206f 7269 6769 6e20 4c56 2074 the origin LV t │ │ │ │ │ -0000a140: 6f20 626f 6f73 7420 7065 7266 6f72 6d61 o boost performa │ │ │ │ │ -0000a150: 6e63 652c 2047 5255 4220 6d61 790a 6661 nce, GRUB may.fa │ │ │ │ │ -0000a160: 696c 2074 6f20 626f 6f74 2069 6e20 7468 il to boot in th │ │ │ │ │ -0000a170: 6520 7761 6b65 206f 6620 6163 6369 6465 e wake of accide │ │ │ │ │ -0000a180: 6e74 616c 2070 6f77 6572 206f 7574 6167 ntal power outag │ │ │ │ │ -0000a190: 6520 6475 6520 746f 2069 7427 730a 696e e due to it's.in │ │ │ │ │ -0000a1a0: 6162 696c 6974 7920 746f 2061 7373 656d ability to assem │ │ │ │ │ -0000a1b0: 626c 6520 7468 6520 6361 6368 6520 6465 ble the cache de │ │ │ │ │ -0000a1c0: 7669 6365 2066 6f72 2072 6561 6469 6e67 vice for reading │ │ │ │ │ -0000a1d0: 2074 6865 2072 6571 7569 7265 6420 6469 the required di │ │ │ │ │ -0000a1e0: 7274 790a 6461 7461 206c 6566 7420 6265 rty.data left be │ │ │ │ │ -0000a1f0: 6869 6e64 2e20 2054 6865 2073 6974 7561 hind. The situa │ │ │ │ │ -0000a200: 7469 6f6e 2077 696c 6c20 6265 2069 6d70 tion will be imp │ │ │ │ │ -0000a210: 726f 7665 6420 6166 7465 7220 6164 6469 roved after addi │ │ │ │ │ -0000a220: 6e67 2066 756c 6c0a 7375 7070 6f72 7420 ng full.support │ │ │ │ │ -0000a230: 746f 2074 6865 204c 564d 2063 6163 6865 to the LVM cache │ │ │ │ │ -0000a240: 206c 6f67 6963 616c 2076 6f6c 756d 6520 logical volume │ │ │ │ │ -0000a250: 696e 2074 6865 2066 7574 7572 652e 0a0a in the future... │ │ │ │ │ -0000a260: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -0000a270: 6f2c 2020 4e6f 6465 3a20 4f53 2d73 7065 o, Node: OS-spe │ │ │ │ │ -0000a280: 6369 6669 6320 6e6f 7465 732c 2020 5072 cific notes, Pr │ │ │ │ │ -0000a290: 6576 3a20 4c56 4d20 6361 6368 6520 626f ev: LVM cache bo │ │ │ │ │ -0000a2a0: 6f74 696e 672c 2020 5570 3a20 426f 6f74 oting, Up: Boot │ │ │ │ │ -0000a2b0: 696e 670a 0a35 2e34 2053 6f6d 6520 6361 ing..5.4 Some ca │ │ │ │ │ -0000a2c0: 7665 6174 7320 6f6e 204f 532d 7370 6563 veats on OS-spec │ │ │ │ │ -0000a2d0: 6966 6963 2069 7373 7565 730a 3d3d 3d3d ific issues.==== │ │ │ │ │ +00009e20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00009e30: 3d0a 0a54 6865 204c 564d 2063 6163 6865 =..The LVM cache │ │ │ │ │ +00009e40: 206c 6f67 6963 616c 2076 6f6c 756d 6520 logical volume │ │ │ │ │ +00009e50: 6973 2074 6865 206c 6f67 6963 616c 2076 is the logical v │ │ │ │ │ +00009e60: 6f6c 756d 6520 636f 6e73 6973 7469 6e67 olume consisting │ │ │ │ │ +00009e70: 206f 6620 7468 650a 6f72 6967 696e 616c of the.original │ │ │ │ │ +00009e80: 2061 6e64 2074 6865 2063 6163 6865 2070 and the cache p │ │ │ │ │ +00009e90: 6f6f 6c20 6c6f 6769 6361 6c20 766f 6c75 ool logical volu │ │ │ │ │ +00009ea0: 6d65 2e20 2054 6865 206f 7269 6769 6e61 me. The origina │ │ │ │ │ +00009eb0: 6c20 6973 2075 7375 616c 6c79 206f 6e0a l is usually on. │ │ │ │ │ +00009ec0: 6120 6c61 7267 6572 2061 6e64 2073 6c6f a larger and slo │ │ │ │ │ +00009ed0: 7765 7220 7374 6f72 6167 6520 6465 7669 wer storage devi │ │ │ │ │ +00009ee0: 6365 2077 6869 6c65 2074 6865 2063 6163 ce while the cac │ │ │ │ │ +00009ef0: 6865 2070 6f6f 6c20 6973 206f 6e20 6120 he pool is on a │ │ │ │ │ +00009f00: 736d 616c 6c65 720a 616e 6420 6661 7374 smaller.and fast │ │ │ │ │ +00009f10: 6572 206f 6e65 2e20 2054 6865 2070 6572 er one. The per │ │ │ │ │ +00009f20: 666f 726d 616e 6365 206f 6620 7468 6520 formance of the │ │ │ │ │ +00009f30: 6f72 6967 696e 616c 2076 6f6c 756d 6520 original volume │ │ │ │ │ +00009f40: 6361 6e20 6265 2069 6d70 726f 7665 640a can be improved. │ │ │ │ │ +00009f50: 6279 2073 746f 7269 6e67 2074 6865 2066 by storing the f │ │ │ │ │ +00009f60: 7265 7175 656e 746c 7920 7573 6564 2064 requently used d │ │ │ │ │ +00009f70: 6174 6120 6f6e 2074 6865 2063 6163 6865 ata on the cache │ │ │ │ │ +00009f80: 2070 6f6f 6c20 746f 2075 7469 6c69 7a65 pool to utilize │ │ │ │ │ +00009f90: 2074 6865 0a67 7265 6174 6572 2070 6572 the.greater per │ │ │ │ │ +00009fa0: 666f 726d 616e 6365 206f 6620 6661 7374 formance of fast │ │ │ │ │ +00009fb0: 6572 2064 6576 6963 652e 0a0a 2020 2047 er device... G │ │ │ │ │ +00009fc0: 5255 4220 626f 6f74 7320 6672 6f6d 204c RUB boots from L │ │ │ │ │ +00009fd0: 564d 2063 6163 6865 206c 6f67 6963 616c VM cache logical │ │ │ │ │ +00009fe0: 2076 6f6c 756d 6520 6d65 7265 6c79 2062 volume merely b │ │ │ │ │ +00009ff0: 7920 7265 6164 696e 6720 6974 2773 0a6f y reading it's.o │ │ │ │ │ +0000a000: 7269 6769 6e61 6c20 6c6f 6769 6361 6c20 riginal logical │ │ │ │ │ +0000a010: 766f 6c75 6d65 2073 6f20 7468 6174 2064 volume so that d │ │ │ │ │ +0000a020: 6972 7479 2064 6174 6120 696e 2063 6163 irty data in cac │ │ │ │ │ +0000a030: 6865 2070 6f6f 6c20 766f 6c75 6d65 2069 he pool volume i │ │ │ │ │ +0000a040: 730a 6469 7372 6567 6172 6465 642e 2020 s.disregarded. │ │ │ │ │ +0000a050: 5468 6973 2069 7320 6e6f 7420 6120 7072 This is not a pr │ │ │ │ │ +0000a060: 6f62 6c65 6d20 666f 7220 2277 7269 7465 oblem for "write │ │ │ │ │ +0000a070: 7468 726f 7567 6822 2063 6163 6865 206d through" cache m │ │ │ │ │ +0000a080: 6f64 6520 6173 2069 740a 656e 7375 7265 ode as it.ensure │ │ │ │ │ +0000a090: 7320 7468 6174 2061 6e79 2064 6174 6120 s that any data │ │ │ │ │ +0000a0a0: 7772 6974 7465 6e20 7769 6c6c 2062 6520 written will be │ │ │ │ │ +0000a0b0: 7374 6f72 6564 2062 6f74 6820 6f6e 2074 stored both on t │ │ │ │ │ +0000a0c0: 6865 2063 6163 6865 2061 6e64 2074 6865 he cache and the │ │ │ │ │ +0000a0d0: 0a6f 7269 6769 6e20 4c56 2e20 466f 7220 .origin LV. For │ │ │ │ │ +0000a0e0: 7468 6520 6f74 6865 7220 6361 6368 6520 the other cache │ │ │ │ │ +0000a0f0: 6d6f 6465 2022 7772 6974 6562 6163 6b22 mode "writeback" │ │ │ │ │ +0000a100: 2c20 7768 6963 6820 6465 6c61 7973 2077 , which delays w │ │ │ │ │ +0000a110: 7269 7469 6e67 0a66 726f 6d20 7468 6520 riting.from the │ │ │ │ │ +0000a120: 6361 6368 6520 706f 6f6c 2062 6163 6b20 cache pool back │ │ │ │ │ +0000a130: 746f 2074 6865 206f 7269 6769 6e20 4c56 to the origin LV │ │ │ │ │ +0000a140: 2074 6f20 626f 6f73 7420 7065 7266 6f72 to boost perfor │ │ │ │ │ +0000a150: 6d61 6e63 652c 2047 5255 4220 6d61 790a mance, GRUB may. │ │ │ │ │ +0000a160: 6661 696c 2074 6f20 626f 6f74 2069 6e20 fail to boot in │ │ │ │ │ +0000a170: 7468 6520 7761 6b65 206f 6620 6163 6369 the wake of acci │ │ │ │ │ +0000a180: 6465 6e74 616c 2070 6f77 6572 206f 7574 dental power out │ │ │ │ │ +0000a190: 6167 6520 6475 6520 746f 2069 7427 730a age due to it's. │ │ │ │ │ +0000a1a0: 696e 6162 696c 6974 7920 746f 2061 7373 inability to ass │ │ │ │ │ +0000a1b0: 656d 626c 6520 7468 6520 6361 6368 6520 emble the cache │ │ │ │ │ +0000a1c0: 6465 7669 6365 2066 6f72 2072 6561 6469 device for readi │ │ │ │ │ +0000a1d0: 6e67 2074 6865 2072 6571 7569 7265 6420 ng the required │ │ │ │ │ +0000a1e0: 6469 7274 790a 6461 7461 206c 6566 7420 dirty.data left │ │ │ │ │ +0000a1f0: 6265 6869 6e64 2e20 2054 6865 2073 6974 behind. The sit │ │ │ │ │ +0000a200: 7561 7469 6f6e 2077 696c 6c20 6265 2069 uation will be i │ │ │ │ │ +0000a210: 6d70 726f 7665 6420 6166 7465 7220 6164 mproved after ad │ │ │ │ │ +0000a220: 6469 6e67 2066 756c 6c0a 7375 7070 6f72 ding full.suppor │ │ │ │ │ +0000a230: 7420 746f 2074 6865 204c 564d 2063 6163 t to the LVM cac │ │ │ │ │ +0000a240: 6865 206c 6f67 6963 616c 2076 6f6c 756d he logical volum │ │ │ │ │ +0000a250: 6520 696e 2074 6865 2066 7574 7572 652e e in the future. │ │ │ │ │ +0000a260: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0000a270: 6e66 6f2c 2020 4e6f 6465 3a20 4f53 2d73 nfo, Node: OS-s │ │ │ │ │ +0000a280: 7065 6369 6669 6320 6e6f 7465 732c 2020 pecific notes, │ │ │ │ │ +0000a290: 5072 6576 3a20 4c56 4d20 6361 6368 6520 Prev: LVM cache │ │ │ │ │ +0000a2a0: 626f 6f74 696e 672c 2020 5570 3a20 426f booting, Up: Bo │ │ │ │ │ +0000a2b0: 6f74 696e 670a 0a35 2e34 2053 6f6d 6520 oting..5.4 Some │ │ │ │ │ +0000a2c0: 6361 7665 6174 7320 6f6e 204f 532d 7370 caveats on OS-sp │ │ │ │ │ +0000a2d0: 6563 6966 6963 2069 7373 7565 730a 3d3d ecific issues.== │ │ │ │ │ 0000a2e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0000a2f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000a300: 3d3d 0a0a 4865 7265 2c20 7765 2064 6573 ==..Here, we des │ │ │ │ │ -0000a310: 6372 6962 6520 736f 6d65 2063 6176 6561 cribe some cavea │ │ │ │ │ -0000a320: 7473 206f 6e20 7365 7665 7261 6c20 6f70 ts on several op │ │ │ │ │ -0000a330: 6572 6174 696e 6720 7379 7374 656d 732e erating systems. │ │ │ │ │ -0000a340: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2047 4e55 ..* Menu:..* GNU │ │ │ │ │ -0000a350: 2f48 7572 643a 3a0a 2a20 474e 552f 4c69 /Hurd::.* GNU/Li │ │ │ │ │ -0000a360: 6e75 783a 3a0a 2a20 4e65 7442 5344 3a3a nux::.* NetBSD:: │ │ │ │ │ -0000a370: 0a2a 2044 4f53 2f57 696e 646f 7773 3a3a .* DOS/Windows:: │ │ │ │ │ -0000a380: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -0000a390: 6e66 6f2c 2020 4e6f 6465 3a20 474e 552f nfo, Node: GNU/ │ │ │ │ │ -0000a3a0: 4875 7264 2c20 204e 6578 743a 2047 4e55 Hurd, Next: GNU │ │ │ │ │ -0000a3b0: 2f4c 696e 7578 2c20 2055 703a 204f 532d /Linux, Up: OS- │ │ │ │ │ -0000a3c0: 7370 6563 6966 6963 206e 6f74 6573 0a0a specific notes.. │ │ │ │ │ -0000a3d0: 352e 342e 3120 474e 552f 4875 7264 0a2d 5.4.1 GNU/Hurd.- │ │ │ │ │ -0000a3e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a53 -------------..S │ │ │ │ │ -0000a3f0: 696e 6365 2047 4e55 2f48 7572 6420 6973 ince GNU/Hurd is │ │ │ │ │ -0000a400: 204d 756c 7469 626f 6f74 2d63 6f6d 706c Multiboot-compl │ │ │ │ │ -0000a410: 6961 6e74 2c20 6974 2069 7320 6561 7379 iant, it is easy │ │ │ │ │ -0000a420: 2074 6f20 626f 6f74 2069 743b 2074 6865 to boot it; the │ │ │ │ │ -0000a430: 7265 2069 730a 6e6f 7468 696e 6720 7370 re is.nothing sp │ │ │ │ │ -0000a440: 6563 6961 6c20 6162 6f75 7420 6974 2e20 ecial about it. │ │ │ │ │ -0000a450: 2042 7574 2064 6f20 6e6f 7420 666f 7267 But do not forg │ │ │ │ │ -0000a460: 6574 2074 6861 7420 796f 7520 6861 7665 et that you have │ │ │ │ │ -0000a470: 2074 6f20 7370 6563 6966 7920 610a 726f to specify a.ro │ │ │ │ │ -0000a480: 6f74 2070 6172 7469 7469 6f6e 2074 6f20 ot partition to │ │ │ │ │ -0000a490: 7468 6520 6b65 726e 656c 2e0a 0a20 2031 the kernel... 1 │ │ │ │ │ -0000a4a0: 2e20 5365 7420 4752 5542 2773 2072 6f6f . Set GRUB's roo │ │ │ │ │ -0000a4b0: 7420 6465 7669 6365 2074 6f20 7468 6520 t device to the │ │ │ │ │ -0000a4c0: 7361 6d65 2064 7269 7665 2061 7320 474e same drive as GN │ │ │ │ │ -0000a4d0: 552f 4875 7264 2773 2e20 2054 6865 0a20 U/Hurd's. The. │ │ │ │ │ -0000a4e0: 2020 2020 636f 6d6d 616e 6420 2773 6561 command 'sea │ │ │ │ │ -0000a4f0: 7263 6820 2d2d 7365 743d 726f 6f74 202d rch --set=root - │ │ │ │ │ -0000a500: 2d66 696c 6520 2f62 6f6f 742f 676e 756d -file /boot/gnum │ │ │ │ │ -0000a510: 6163 682e 677a 2720 6f72 2073 696d 696c ach.gz' or simil │ │ │ │ │ -0000a520: 6172 206d 6179 0a20 2020 2020 6865 6c70 ar may. help │ │ │ │ │ -0000a530: 2079 6f75 2028 2a6e 6f74 6520 7365 6172 you (*note sear │ │ │ │ │ -0000a540: 6368 3a3a 292e 0a0a 2020 322e 204c 6f61 ch::)... 2. Loa │ │ │ │ │ -0000a550: 6420 7468 6520 6b65 726e 656c 2061 6e64 d the kernel and │ │ │ │ │ -0000a560: 2074 6865 206d 6f64 756c 6573 2c20 6c69 the modules, li │ │ │ │ │ -0000a570: 6b65 2074 6869 733a 0a0a 2020 2020 2020 ke this:.. │ │ │ │ │ -0000a580: 2020 2020 6772 7562 3e20 6d75 6c74 6962 grub> multib │ │ │ │ │ -0000a590: 6f6f 7420 2f62 6f6f 742f 676e 756d 6163 oot /boot/gnumac │ │ │ │ │ -0000a5a0: 682e 677a 2072 6f6f 743d 6465 7669 6365 h.gz root=device │ │ │ │ │ -0000a5b0: 3a68 6430 7331 0a20 2020 2020 2020 2020 :hd0s1. │ │ │ │ │ -0000a5c0: 2067 7275 623e 206d 6f64 756c 6520 202f grub> module / │ │ │ │ │ -0000a5d0: 6875 7264 2f65 7874 3266 732e 7374 6174 hurd/ext2fs.stat │ │ │ │ │ -0000a5e0: 6963 2065 7874 3266 7320 2d2d 7265 6164 ic ext2fs --read │ │ │ │ │ -0000a5f0: 6f6e 6c79 205c 0a20 2020 2020 2020 2020 only \. │ │ │ │ │ +0000a300: 3d3d 3d3d 0a0a 4865 7265 2c20 7765 2064 ====..Here, we d │ │ │ │ │ +0000a310: 6573 6372 6962 6520 736f 6d65 2063 6176 escribe some cav │ │ │ │ │ +0000a320: 6561 7473 206f 6e20 7365 7665 7261 6c20 eats on several │ │ │ │ │ +0000a330: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +0000a340: 732e 0a0a 2a20 4d65 6e75 3a0a 0a2a 2047 s...* Menu:..* G │ │ │ │ │ +0000a350: 4e55 2f48 7572 643a 3a0a 2a20 474e 552f NU/Hurd::.* GNU/ │ │ │ │ │ +0000a360: 4c69 6e75 783a 3a0a 2a20 4e65 7442 5344 Linux::.* NetBSD │ │ │ │ │ +0000a370: 3a3a 0a2a 2044 4f53 2f57 696e 646f 7773 ::.* DOS/Windows │ │ │ │ │ +0000a380: 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 7562 ::....File: grub │ │ │ │ │ +0000a390: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 474e .info, Node: GN │ │ │ │ │ +0000a3a0: 552f 4875 7264 2c20 204e 6578 743a 2047 U/Hurd, Next: G │ │ │ │ │ +0000a3b0: 4e55 2f4c 696e 7578 2c20 2055 703a 204f NU/Linux, Up: O │ │ │ │ │ +0000a3c0: 532d 7370 6563 6966 6963 206e 6f74 6573 S-specific notes │ │ │ │ │ +0000a3d0: 0a0a 352e 342e 3120 474e 552f 4875 7264 ..5.4.1 GNU/Hurd │ │ │ │ │ +0000a3e0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a .--------------. │ │ │ │ │ +0000a3f0: 0a53 696e 6365 2047 4e55 2f48 7572 6420 .Since GNU/Hurd │ │ │ │ │ +0000a400: 6973 204d 756c 7469 626f 6f74 2d63 6f6d is Multiboot-com │ │ │ │ │ +0000a410: 706c 6961 6e74 2c20 6974 2069 7320 6561 pliant, it is ea │ │ │ │ │ +0000a420: 7379 2074 6f20 626f 6f74 2069 743b 2074 sy to boot it; t │ │ │ │ │ +0000a430: 6865 7265 2069 730a 6e6f 7468 696e 6720 here is.nothing │ │ │ │ │ +0000a440: 7370 6563 6961 6c20 6162 6f75 7420 6974 special about it │ │ │ │ │ +0000a450: 2e20 2042 7574 2064 6f20 6e6f 7420 666f . But do not fo │ │ │ │ │ +0000a460: 7267 6574 2074 6861 7420 796f 7520 6861 rget that you ha │ │ │ │ │ +0000a470: 7665 2074 6f20 7370 6563 6966 7920 610a ve to specify a. │ │ │ │ │ +0000a480: 726f 6f74 2070 6172 7469 7469 6f6e 2074 root partition t │ │ │ │ │ +0000a490: 6f20 7468 6520 6b65 726e 656c 2e0a 0a20 o the kernel... │ │ │ │ │ +0000a4a0: 2031 2e20 5365 7420 4752 5542 2773 2072 1. Set GRUB's r │ │ │ │ │ +0000a4b0: 6f6f 7420 6465 7669 6365 2074 6f20 7468 oot device to th │ │ │ │ │ +0000a4c0: 6520 7361 6d65 2064 7269 7665 2061 7320 e same drive as │ │ │ │ │ +0000a4d0: 474e 552f 4875 7264 2773 2e20 2054 6865 GNU/Hurd's. The │ │ │ │ │ +0000a4e0: 0a20 2020 2020 636f 6d6d 616e 6420 2773 . command 's │ │ │ │ │ +0000a4f0: 6561 7263 6820 2d2d 7365 743d 726f 6f74 earch --set=root │ │ │ │ │ +0000a500: 202d 2d66 696c 6520 2f62 6f6f 742f 676e --file /boot/gn │ │ │ │ │ +0000a510: 756d 6163 682e 677a 2720 6f72 2073 696d umach.gz' or sim │ │ │ │ │ +0000a520: 696c 6172 206d 6179 0a20 2020 2020 6865 ilar may. he │ │ │ │ │ +0000a530: 6c70 2079 6f75 2028 2a6e 6f74 6520 7365 lp you (*note se │ │ │ │ │ +0000a540: 6172 6368 3a3a 292e 0a0a 2020 322e 204c arch::)... 2. L │ │ │ │ │ +0000a550: 6f61 6420 7468 6520 6b65 726e 656c 2061 oad the kernel a │ │ │ │ │ +0000a560: 6e64 2074 6865 206d 6f64 756c 6573 2c20 nd the modules, │ │ │ │ │ +0000a570: 6c69 6b65 2074 6869 733a 0a0a 2020 2020 like this:.. │ │ │ │ │ +0000a580: 2020 2020 2020 6772 7562 3e20 6d75 6c74 grub> mult │ │ │ │ │ +0000a590: 6962 6f6f 7420 2f62 6f6f 742f 676e 756d iboot /boot/gnum │ │ │ │ │ +0000a5a0: 6163 682e 677a 2072 6f6f 743d 6465 7669 ach.gz root=devi │ │ │ │ │ +0000a5b0: 6365 3a68 6430 7331 0a20 2020 2020 2020 ce:hd0s1. │ │ │ │ │ +0000a5c0: 2020 2067 7275 623e 206d 6f64 756c 6520 grub> module │ │ │ │ │ +0000a5d0: 202f 6875 7264 2f65 7874 3266 732e 7374 /hurd/ext2fs.st │ │ │ │ │ +0000a5e0: 6174 6963 2065 7874 3266 7320 2d2d 7265 atic ext2fs --re │ │ │ │ │ +0000a5f0: 6164 6f6e 6c79 205c 0a20 2020 2020 2020 adonly \. │ │ │ │ │ 0000a600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a610: 2020 2020 2d2d 6d75 6c74 6962 6f6f 742d --multiboot- │ │ │ │ │ -0000a620: 636f 6d6d 616e 642d 6c69 6e65 3d27 247b command-line='${ │ │ │ │ │ -0000a630: 6b65 726e 656c 2d63 6f6d 6d61 6e64 2d6c kernel-command-l │ │ │ │ │ -0000a640: 696e 657d 2720 5c0a 2020 2020 2020 2020 ine}' \. │ │ │ │ │ +0000a610: 2020 2020 2020 2d2d 6d75 6c74 6962 6f6f --multiboo │ │ │ │ │ +0000a620: 742d 636f 6d6d 616e 642d 6c69 6e65 3d27 t-command-line=' │ │ │ │ │ +0000a630: 247b 6b65 726e 656c 2d63 6f6d 6d61 6e64 ${kernel-command │ │ │ │ │ +0000a640: 2d6c 696e 657d 2720 5c0a 2020 2020 2020 -line}' \. │ │ │ │ │ 0000a650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a660: 2020 2020 202d 2d68 6f73 742d 7072 6976 --host-priv │ │ │ │ │ -0000a670: 2d70 6f72 743d 2724 7b68 6f73 742d 706f -port='${host-po │ │ │ │ │ -0000a680: 7274 7d27 205c 0a20 2020 2020 2020 2020 rt}' \. │ │ │ │ │ +0000a660: 2020 2020 2020 202d 2d68 6f73 742d 7072 --host-pr │ │ │ │ │ +0000a670: 6976 2d70 6f72 743d 2724 7b68 6f73 742d iv-port='${host- │ │ │ │ │ +0000a680: 706f 7274 7d27 205c 0a20 2020 2020 2020 port}' \. │ │ │ │ │ 0000a690: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a6a0: 2020 2020 2d2d 6465 7669 6365 2d6d 6173 --device-mas │ │ │ │ │ -0000a6b0: 7465 722d 706f 7274 3d27 247b 6465 7669 ter-port='${devi │ │ │ │ │ -0000a6c0: 6365 2d70 6f72 747d 2720 5c0a 2020 2020 ce-port}' \. │ │ │ │ │ +0000a6a0: 2020 2020 2020 2d2d 6465 7669 6365 2d6d --device-m │ │ │ │ │ +0000a6b0: 6173 7465 722d 706f 7274 3d27 247b 6465 aster-port='${de │ │ │ │ │ +0000a6c0: 7669 6365 2d70 6f72 747d 2720 5c0a 2020 vice-port}' \. │ │ │ │ │ 0000a6d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a6e0: 2020 2020 2020 2020 202d 2d65 7865 632d --exec- │ │ │ │ │ -0000a6f0: 7365 7276 6572 2d74 6173 6b3d 2724 7b65 server-task='${e │ │ │ │ │ -0000a700: 7865 632d 7461 736b 7d27 202d 5420 7479 xec-task}' -T ty │ │ │ │ │ -0000a710: 7065 6420 2724 7b72 6f6f 747d 2720 5c0a ped '${root}' \. │ │ │ │ │ -0000a720: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0000a730: 2020 2020 2020 2020 2020 2020 2027 2428 '$( │ │ │ │ │ -0000a740: 7461 736b 2d63 7265 6174 6529 2720 2724 task-create)' '$ │ │ │ │ │ -0000a750: 2874 6173 6b2d 7265 7375 6d65 2927 0a20 (task-resume)'. │ │ │ │ │ -0000a760: 2020 2020 2020 2020 2067 7275 623e 206d grub> m │ │ │ │ │ -0000a770: 6f64 756c 6520 2f6c 6962 2f6c 642e 736f odule /lib/ld.so │ │ │ │ │ -0000a780: 2e31 2065 7865 6320 2f68 7572 642f 6578 .1 exec /hurd/ex │ │ │ │ │ -0000a790: 6563 2027 2428 6578 6563 2d74 6173 6b3d ec '$(exec-task= │ │ │ │ │ -0000a7a0: 7461 736b 2d63 7265 6174 6529 270a 0a20 task-create)'.. │ │ │ │ │ -0000a7b0: 2033 2e20 4669 6e61 6c6c 792c 2072 756e 3. Finally, run │ │ │ │ │ -0000a7c0: 2074 6865 2063 6f6d 6d61 6e64 2027 626f the command 'bo │ │ │ │ │ -0000a7d0: 6f74 2720 282a 6e6f 7465 2062 6f6f 743a ot' (*note boot: │ │ │ │ │ -0000a7e0: 3a29 2e0a 0a1f 0a46 696c 653a 2067 7275 :).....File: gru │ │ │ │ │ -0000a7f0: 622e 696e 666f 2c20 204e 6f64 653a 2047 b.info, Node: G │ │ │ │ │ -0000a800: 4e55 2f4c 696e 7578 2c20 204e 6578 743a NU/Linux, Next: │ │ │ │ │ -0000a810: 204e 6574 4253 442c 2020 5072 6576 3a20 NetBSD, Prev: │ │ │ │ │ -0000a820: 474e 552f 4875 7264 2c20 2055 703a 204f GNU/Hurd, Up: O │ │ │ │ │ -0000a830: 532d 7370 6563 6966 6963 206e 6f74 6573 S-specific notes │ │ │ │ │ -0000a840: 0a0a 352e 342e 3220 474e 552f 4c69 6e75 ..5.4.2 GNU/Linu │ │ │ │ │ -0000a850: 780a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d x.-------------- │ │ │ │ │ -0000a860: 2d0a 0a49 7420 6973 2072 656c 6174 6976 -..It is relativ │ │ │ │ │ -0000a870: 656c 7920 6561 7379 2074 6f20 626f 6f74 ely easy to boot │ │ │ │ │ -0000a880: 2047 4e55 2f4c 696e 7578 2066 726f 6d20 GNU/Linux from │ │ │ │ │ -0000a890: 4752 5542 2c20 6265 6361 7573 6520 6974 GRUB, because it │ │ │ │ │ -0000a8a0: 2073 6f6d 6577 6861 740a 7265 7365 6d62 somewhat.resemb │ │ │ │ │ -0000a8b0: 6c65 7320 746f 2062 6f6f 7420 6120 4d75 les to boot a Mu │ │ │ │ │ -0000a8c0: 6c74 6962 6f6f 742d 636f 6d70 6c69 616e ltiboot-complian │ │ │ │ │ -0000a8d0: 7420 4f53 2e0a 0a20 2031 2e20 5365 7420 t OS... 1. Set │ │ │ │ │ -0000a8e0: 4752 5542 2773 2072 6f6f 7420 6465 7669 GRUB's root devi │ │ │ │ │ -0000a8f0: 6365 2074 6f20 7468 6520 7361 6d65 2064 ce to the same d │ │ │ │ │ -0000a900: 7269 7665 2061 7320 474e 552f 4c69 6e75 rive as GNU/Linu │ │ │ │ │ -0000a910: 7827 732e 2020 5468 650a 2020 2020 2063 x's. The. c │ │ │ │ │ -0000a920: 6f6d 6d61 6e64 2027 7365 6172 6368 202d ommand 'search - │ │ │ │ │ -0000a930: 2d73 6574 3d72 6f6f 7420 2d2d 6669 6c65 -set=root --file │ │ │ │ │ -0000a940: 202f 766d 6c69 6e75 7a27 206f 7220 7369 /vmlinuz' or si │ │ │ │ │ -0000a950: 6d69 6c61 7220 6d61 7920 6865 6c70 2079 milar may help y │ │ │ │ │ -0000a960: 6f75 0a20 2020 2020 282a 6e6f 7465 2073 ou. (*note s │ │ │ │ │ -0000a970: 6561 7263 683a 3a29 2e0a 0a20 2032 2e20 earch::)... 2. │ │ │ │ │ -0000a980: 4c6f 6164 2074 6865 206b 6572 6e65 6c20 Load the kernel │ │ │ │ │ -0000a990: 7573 696e 6720 7468 6520 636f 6d6d 616e using the comman │ │ │ │ │ -0000a9a0: 6420 276c 696e 7578 2720 282a 6e6f 7465 d 'linux' (*note │ │ │ │ │ -0000a9b0: 206c 696e 7578 3a3a 293a 0a0a 2020 2020 linux::):.. │ │ │ │ │ -0000a9c0: 2020 2020 2020 6772 7562 3e20 6c69 6e75 grub> linu │ │ │ │ │ -0000a9d0: 7820 2f76 6d6c 696e 757a 2072 6f6f 743d x /vmlinuz root= │ │ │ │ │ -0000a9e0: 2f64 6576 2f73 6461 310a 0a20 2020 2020 /dev/sda1.. │ │ │ │ │ -0000a9f0: 4966 2079 6f75 206e 6565 6420 746f 2073 If you need to s │ │ │ │ │ -0000aa00: 7065 6369 6679 2073 6f6d 6520 6b65 726e pecify some kern │ │ │ │ │ -0000aa10: 656c 2070 6172 616d 6574 6572 732c 206a el parameters, j │ │ │ │ │ -0000aa20: 7573 7420 6170 7065 6e64 2074 6865 6d20 ust append them │ │ │ │ │ -0000aa30: 746f 0a20 2020 2020 7468 6520 636f 6d6d to. the comm │ │ │ │ │ -0000aa40: 616e 642e 2020 466f 7220 6578 616d 706c and. For exampl │ │ │ │ │ -0000aa50: 652c 2074 6f20 7365 7420 2761 6370 6927 e, to set 'acpi' │ │ │ │ │ -0000aa60: 2074 6f20 276f 6666 272c 2064 6f20 7468 to 'off', do th │ │ │ │ │ -0000aa70: 6973 3a0a 0a20 2020 2020 2020 2020 2067 is:.. g │ │ │ │ │ -0000aa80: 7275 623e 206c 696e 7578 202f 766d 6c69 rub> linux /vmli │ │ │ │ │ -0000aa90: 6e75 7a20 726f 6f74 3d2f 6465 762f 7364 nuz root=/dev/sd │ │ │ │ │ -0000aaa0: 6131 2061 6370 693d 6f66 660a 0a20 2020 a1 acpi=off.. │ │ │ │ │ -0000aab0: 2020 5365 6520 7468 6520 646f 6375 6d65 See the docume │ │ │ │ │ -0000aac0: 6e74 6174 696f 6e20 696e 2074 6865 204c ntation in the L │ │ │ │ │ -0000aad0: 696e 7578 2073 6f75 7263 6520 7472 6565 inux source tree │ │ │ │ │ -0000aae0: 2066 6f72 2063 6f6d 706c 6574 650a 2020 for complete. │ │ │ │ │ -0000aaf0: 2020 2069 6e66 6f72 6d61 7469 6f6e 206f information o │ │ │ │ │ -0000ab00: 6e20 7468 6520 6176 6169 6c61 626c 6520 n the available │ │ │ │ │ -0000ab10: 6f70 7469 6f6e 732e 0a0a 2020 2020 2057 options... W │ │ │ │ │ -0000ab20: 6974 6820 276c 696e 7578 2720 4752 5542 ith 'linux' GRUB │ │ │ │ │ -0000ab30: 2075 7365 7320 3332 2d62 6974 2070 726f uses 32-bit pro │ │ │ │ │ -0000ab40: 746f 636f 6c2e 2020 536f 6d65 2042 494f tocol. Some BIO │ │ │ │ │ -0000ab50: 5320 7365 7276 6963 6573 206c 696b 650a S services like. │ │ │ │ │ -0000ab60: 2020 2020 2041 504d 206f 7220 4544 4420 APM or EDD │ │ │ │ │ -0000ab70: 6172 656e 2774 2061 7661 696c 6162 6c65 aren't available │ │ │ │ │ -0000ab80: 2077 6974 6820 7468 6973 2070 726f 746f with this proto │ │ │ │ │ -0000ab90: 636f 6c2e 2020 496e 2074 6869 7320 6361 col. In this ca │ │ │ │ │ -0000aba0: 7365 2079 6f75 0a20 2020 2020 6e65 6564 se you. need │ │ │ │ │ -0000abb0: 2074 6f20 7573 6520 276c 696e 7578 3136 to use 'linux16 │ │ │ │ │ -0000abc0: 270a 0a20 2020 2020 2020 2020 2067 7275 '.. gru │ │ │ │ │ -0000abd0: 623e 206c 696e 7578 3136 202f 766d 6c69 b> linux16 /vmli │ │ │ │ │ -0000abe0: 6e75 7a20 726f 6f74 3d2f 6465 762f 7364 nuz root=/dev/sd │ │ │ │ │ -0000abf0: 6131 2061 6370 693d 6f66 660a 0a20 2033 a1 acpi=off.. 3 │ │ │ │ │ -0000ac00: 2e20 4966 2079 6f75 2075 7365 2061 6e20 . If you use an │ │ │ │ │ -0000ac10: 696e 6974 7264 2c20 6578 6563 7574 6520 initrd, execute │ │ │ │ │ -0000ac20: 7468 6520 636f 6d6d 616e 6420 2769 6e69 the command 'ini │ │ │ │ │ -0000ac30: 7472 6427 2028 2a6e 6f74 6520 696e 6974 trd' (*note init │ │ │ │ │ -0000ac40: 7264 3a3a 290a 2020 2020 2061 6674 6572 rd::). after │ │ │ │ │ -0000ac50: 2027 6c69 6e75 7827 3a0a 0a20 2020 2020 'linux':.. │ │ │ │ │ -0000ac60: 2020 2020 2067 7275 623e 2069 6e69 7472 grub> initr │ │ │ │ │ -0000ac70: 6420 2f69 6e69 7472 640a 0a20 2020 2020 d /initrd.. │ │ │ │ │ -0000ac80: 4966 2079 6f75 2075 7365 6420 276c 696e If you used 'lin │ │ │ │ │ -0000ac90: 7578 3136 2720 796f 7520 6e65 6564 2074 ux16' you need t │ │ │ │ │ -0000aca0: 6f20 7573 6520 2769 6e69 7472 6431 3627 o use 'initrd16' │ │ │ │ │ -0000acb0: 3a0a 0a20 2020 2020 2020 2020 2067 7275 :.. gru │ │ │ │ │ -0000acc0: 623e 2069 6e69 7472 6431 3620 2f69 6e69 b> initrd16 /ini │ │ │ │ │ -0000acd0: 7472 640a 0a20 2034 2e20 4669 6e61 6c6c trd.. 4. Finall │ │ │ │ │ -0000ace0: 792c 2072 756e 2074 6865 2063 6f6d 6d61 y, run the comma │ │ │ │ │ -0000acf0: 6e64 2027 626f 6f74 2720 282a 6e6f 7465 nd 'boot' (*note │ │ │ │ │ -0000ad00: 2062 6f6f 743a 3a29 2e0a 0a1f 0a46 696c boot::).....Fil │ │ │ │ │ -0000ad10: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0000ad20: 6f64 653a 204e 6574 4253 442c 2020 4e65 ode: NetBSD, Ne │ │ │ │ │ -0000ad30: 7874 3a20 444f 532f 5769 6e64 6f77 732c xt: DOS/Windows, │ │ │ │ │ -0000ad40: 2020 5072 6576 3a20 474e 552f 4c69 6e75 Prev: GNU/Linu │ │ │ │ │ -0000ad50: 782c 2020 5570 3a20 4f53 2d73 7065 6369 x, Up: OS-speci │ │ │ │ │ -0000ad60: 6669 6320 6e6f 7465 730a 0a35 2e34 2e33 fic notes..5.4.3 │ │ │ │ │ -0000ad70: 204e 6574 4253 440a 2d2d 2d2d 2d2d 2d2d NetBSD.-------- │ │ │ │ │ -0000ad80: 2d2d 2d2d 0a0a 426f 6f74 696e 6720 6120 ----..Booting a │ │ │ │ │ -0000ad90: 4e65 7442 5344 206b 6572 6e65 6c20 6672 NetBSD kernel fr │ │ │ │ │ -0000ada0: 6f6d 2047 5255 4220 6973 2061 6c73 6f20 om GRUB is also │ │ │ │ │ -0000adb0: 7265 6c61 7469 7665 6c79 2065 6173 793a relatively easy: │ │ │ │ │ -0000adc0: 2066 6972 7374 2073 6574 0a47 5255 4227 first set.GRUB' │ │ │ │ │ -0000add0: 7320 726f 6f74 2064 6576 6963 652c 2074 s root device, t │ │ │ │ │ -0000ade0: 6865 6e20 6c6f 6164 2074 6865 206b 6572 hen load the ker │ │ │ │ │ -0000adf0: 6e65 6c20 616e 6420 7468 6520 6d6f 6475 nel and the modu │ │ │ │ │ -0000ae00: 6c65 732c 2061 6e64 2066 696e 616c 6c79 les, and finally │ │ │ │ │ -0000ae10: 0a72 756e 2027 626f 6f74 272e 0a0a 2020 .run 'boot'... │ │ │ │ │ -0000ae20: 312e 2053 6574 2047 5255 4227 7320 726f 1. Set GRUB's ro │ │ │ │ │ -0000ae30: 6f74 2064 6576 6963 6520 746f 2074 6865 ot device to the │ │ │ │ │ -0000ae40: 2070 6172 7469 7469 6f6e 2068 6f6c 6469 partition holdi │ │ │ │ │ -0000ae50: 6e67 2074 6865 204e 6574 4253 4420 726f ng the NetBSD ro │ │ │ │ │ -0000ae60: 6f74 0a20 2020 2020 6669 6c65 2073 7973 ot. file sys │ │ │ │ │ -0000ae70: 7465 6d2e 2020 466f 7220 6120 6469 736b tem. For a disk │ │ │ │ │ -0000ae80: 2077 6974 6820 6120 4e65 7442 5344 2064 with a NetBSD d │ │ │ │ │ -0000ae90: 6973 6b20 6c61 6265 6c2c 2074 6869 7320 isk label, this │ │ │ │ │ -0000aea0: 6973 2075 7375 616c 6c79 0a20 2020 2020 is usually. │ │ │ │ │ -0000aeb0: 7468 6520 6669 7273 7420 7061 7274 6974 the first partit │ │ │ │ │ -0000aec0: 696f 6e20 2861 3a29 2e20 2049 6e20 7468 ion (a:). In th │ │ │ │ │ -0000aed0: 6174 2063 6173 652c 2061 6e64 2061 7373 at case, and ass │ │ │ │ │ -0000aee0: 756d 696e 6720 7468 6174 2074 6865 0a20 uming that the. │ │ │ │ │ -0000aef0: 2020 2020 7061 7274 6974 696f 6e20 6973 partition is │ │ │ │ │ -0000af00: 206f 6e20 7468 6520 6669 7273 7420 6861 on the first ha │ │ │ │ │ -0000af10: 7264 2064 6973 6b2c 2073 6574 2047 5255 rd disk, set GRU │ │ │ │ │ -0000af20: 4227 7320 726f 6f74 2064 6576 6963 6520 B's root device │ │ │ │ │ -0000af30: 6173 0a20 2020 2020 666f 6c6c 6f77 733a as. follows: │ │ │ │ │ -0000af40: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ │ -0000af50: 3e20 696e 736d 6f64 2070 6172 745f 6273 > insmod part_bs │ │ │ │ │ -0000af60: 640a 2020 2020 2020 2020 2020 6772 7562 d. grub │ │ │ │ │ -0000af70: 3e20 7365 7420 726f 6f74 3d28 6864 302c > set root=(hd0, │ │ │ │ │ -0000af80: 6e65 7462 7364 3129 0a0a 2020 2020 2046 netbsd1).. F │ │ │ │ │ -0000af90: 6f72 2061 2064 6973 6b20 7769 7468 2061 or a disk with a │ │ │ │ │ -0000afa0: 2047 5549 4420 5061 7274 6974 696f 6e20 GUID Partition │ │ │ │ │ -0000afb0: 5461 626c 6520 2847 5054 292c 2061 6e64 Table (GPT), and │ │ │ │ │ -0000afc0: 2061 7373 756d 696e 6720 7468 6174 2074 assuming that t │ │ │ │ │ -0000afd0: 6865 0a20 2020 2020 4e65 7442 5344 2072 he. NetBSD r │ │ │ │ │ -0000afe0: 6f6f 7420 7061 7274 6974 696f 6e20 6973 oot partition is │ │ │ │ │ -0000aff0: 2074 6865 2074 6869 7264 2047 5054 2070 the third GPT p │ │ │ │ │ -0000b000: 6172 7469 7469 6f6e 2c20 646f 2074 6869 artition, do thi │ │ │ │ │ -0000b010: 733a 0a0a 2020 2020 2020 2020 2020 6772 s:.. gr │ │ │ │ │ -0000b020: 7562 3e20 696e 736d 6f64 2070 6172 745f ub> insmod part_ │ │ │ │ │ -0000b030: 6770 740a 2020 2020 2020 2020 2020 6772 gpt. gr │ │ │ │ │ -0000b040: 7562 3e20 7365 7420 726f 6f74 3d28 6864 ub> set root=(hd │ │ │ │ │ -0000b050: 302c 6770 7433 290a 0a20 2032 2e20 4c6f 0,gpt3).. 2. Lo │ │ │ │ │ -0000b060: 6164 2074 6865 206b 6572 6e65 6c20 7573 ad the kernel us │ │ │ │ │ -0000b070: 696e 6720 7468 6520 636f 6d6d 616e 6420 ing the command │ │ │ │ │ -0000b080: 276b 6e65 7462 7364 273a 0a0a 2020 2020 'knetbsd':.. │ │ │ │ │ -0000b090: 2020 2020 2020 6772 7562 3e20 6b6e 6574 grub> knet │ │ │ │ │ -0000b0a0: 6273 6420 2f6e 6574 6273 640a 0a20 2020 bsd /netbsd.. │ │ │ │ │ -0000b0b0: 2020 5661 7269 6f75 7320 6f70 7469 6f6e Various option │ │ │ │ │ -0000b0c0: 7320 6d61 7920 6265 2067 6976 656e 2074 s may be given t │ │ │ │ │ -0000b0d0: 6f20 276b 6e65 7462 7364 272e 2020 5468 o 'knetbsd'. Th │ │ │ │ │ -0000b0e0: 6573 6520 6f70 7469 6f6e 7320 6172 652c ese options are, │ │ │ │ │ -0000b0f0: 2066 6f72 0a20 2020 2020 7468 6520 6d6f for. the mo │ │ │ │ │ -0000b100: 7374 2070 6172 742c 2074 6865 2073 616d st part, the sam │ │ │ │ │ -0000b110: 6520 6173 2069 6e20 7468 6520 4e65 7442 e as in the NetB │ │ │ │ │ -0000b120: 5344 2062 6f6f 7420 6c6f 6164 6572 2e20 SD boot loader. │ │ │ │ │ -0000b130: 2046 6f72 0a20 2020 2020 696e 7374 616e For. instan │ │ │ │ │ -0000b140: 6365 2c20 746f 2062 6f6f 7420 7468 6520 ce, to boot the │ │ │ │ │ -0000b150: 7379 7374 656d 2069 6e20 7369 6e67 6c65 system in single │ │ │ │ │ -0000b160: 2d75 7365 7220 6d6f 6465 2061 6e64 2077 -user mode and w │ │ │ │ │ -0000b170: 6974 6820 7665 7262 6f73 650a 2020 2020 ith verbose. │ │ │ │ │ -0000b180: 206d 6573 7361 6765 732c 2064 6f20 7468 messages, do th │ │ │ │ │ -0000b190: 6973 3a0a 0a20 2020 2020 2020 2020 2067 is:.. g │ │ │ │ │ -0000b1a0: 7275 623e 206b 6e65 7462 7364 202f 6e65 rub> knetbsd /ne │ │ │ │ │ -0000b1b0: 7462 7364 202d 7320 2d76 0a0a 2020 332e tbsd -s -v.. 3. │ │ │ │ │ -0000b1c0: 2049 6620 6e65 6564 6564 2c20 6c6f 6164 If needed, load │ │ │ │ │ -0000b1d0: 206b 6572 6e65 6c20 6d6f 6475 6c65 7320 kernel modules │ │ │ │ │ -0000b1e0: 7769 7468 2074 6865 2063 6f6d 6d61 6e64 with the command │ │ │ │ │ -0000b1f0: 0a20 2020 2020 276b 6e65 7462 7364 5f6d . 'knetbsd_m │ │ │ │ │ -0000b200: 6f64 756c 655f 656c 6627 2e20 2041 2074 odule_elf'. A t │ │ │ │ │ -0000b210: 7970 6963 616c 2065 7861 6d70 6c65 2069 ypical example i │ │ │ │ │ -0000b220: 7320 7468 6520 6d6f 6475 6c65 2066 6f72 s the module for │ │ │ │ │ -0000b230: 2074 6865 2072 6f6f 740a 2020 2020 2066 the root. f │ │ │ │ │ -0000b240: 696c 6520 7379 7374 656d 3a0a 0a20 2020 ile system:.. │ │ │ │ │ -0000b250: 2020 2020 2020 2067 7275 623e 206b 6e65 grub> kne │ │ │ │ │ -0000b260: 7462 7364 5f6d 6f64 756c 655f 656c 6620 tbsd_module_elf │ │ │ │ │ -0000b270: 2f73 7461 6e64 2f61 6d64 3634 2f36 2e30 /stand/amd64/6.0 │ │ │ │ │ -0000b280: 2f6d 6f64 756c 6573 2f66 6673 2f66 6673 /modules/ffs/ffs │ │ │ │ │ -0000b290: 2e6b 6d6f 640a 0a20 2034 2e20 4669 6e61 .kmod.. 4. Fina │ │ │ │ │ -0000b2a0: 6c6c 792c 2072 756e 2074 6865 2063 6f6d lly, run the com │ │ │ │ │ -0000b2b0: 6d61 6e64 2027 626f 6f74 2720 282a 6e6f mand 'boot' (*no │ │ │ │ │ -0000b2c0: 7465 2062 6f6f 743a 3a29 2e0a 0a1f 0a46 te boot::).....F │ │ │ │ │ -0000b2d0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -0000b2e0: 204e 6f64 653a 2044 4f53 2f57 696e 646f Node: DOS/Windo │ │ │ │ │ -0000b2f0: 7773 2c20 2050 7265 763a 204e 6574 4253 ws, Prev: NetBS │ │ │ │ │ -0000b300: 442c 2020 5570 3a20 4f53 2d73 7065 6369 D, Up: OS-speci │ │ │ │ │ -0000b310: 6669 6320 6e6f 7465 730a 0a35 2e34 2e34 fic notes..5.4.4 │ │ │ │ │ -0000b320: 2044 4f53 2f57 696e 646f 7773 0a2d 2d2d DOS/Windows.--- │ │ │ │ │ -0000b330: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -0000b340: 4752 5542 2063 616e 6e6f 7420 626f 6f74 GRUB cannot boot │ │ │ │ │ -0000b350: 2044 4f53 206f 7220 5769 6e64 6f77 7320 DOS or Windows │ │ │ │ │ -0000b360: 6469 7265 6374 6c79 2c20 736f 2079 6f75 directly, so you │ │ │ │ │ -0000b370: 206d 7573 7420 6368 6169 6e2d 6c6f 6164 must chain-load │ │ │ │ │ -0000b380: 2074 6865 6d0a 282a 6e6f 7465 2043 6861 them.(*note Cha │ │ │ │ │ -0000b390: 696e 2d6c 6f61 6469 6e67 3a3a 292e 2020 in-loading::). │ │ │ │ │ -0000b3a0: 486f 7765 7665 722c 2074 6865 6972 2062 However, their b │ │ │ │ │ -0000b3b0: 6f6f 7420 6c6f 6164 6572 7320 6861 7665 oot loaders have │ │ │ │ │ -0000b3c0: 2073 6f6d 6520 6372 6974 6963 616c 0a64 some critical.d │ │ │ │ │ -0000b3d0: 6566 6963 6965 6e63 6965 732c 2073 6f20 eficiencies, so │ │ │ │ │ -0000b3e0: 6974 206d 6179 206e 6f74 2077 6f72 6b20 it may not work │ │ │ │ │ -0000b3f0: 746f 206a 7573 7420 6368 6169 6e2d 6c6f to just chain-lo │ │ │ │ │ -0000b400: 6164 2074 6865 6d2e 2020 546f 206f 7665 ad them. To ove │ │ │ │ │ -0000b410: 7263 6f6d 650a 7468 6520 7072 6f62 6c65 rcome.the proble │ │ │ │ │ -0000b420: 6d73 2c20 4752 5542 2070 726f 7669 6465 ms, GRUB provide │ │ │ │ │ -0000b430: 7320 796f 7520 7769 7468 2074 776f 2068 s you with two h │ │ │ │ │ -0000b440: 656c 7065 7220 6675 6e63 7469 6f6e 732e elper functions. │ │ │ │ │ -0000b450: 0a0a 2020 2049 6620 796f 7520 6861 7665 .. If you have │ │ │ │ │ -0000b460: 2069 6e73 7461 6c6c 6564 2044 4f53 2028 installed DOS ( │ │ │ │ │ -0000b470: 6f72 2057 696e 646f 7773 2920 6f6e 2061 or Windows) on a │ │ │ │ │ -0000b480: 206e 6f6e 2d66 6972 7374 2068 6172 6420 non-first hard │ │ │ │ │ -0000b490: 6469 736b 2c20 796f 750a 6861 7665 2074 disk, you.have t │ │ │ │ │ -0000b4a0: 6f20 7573 6520 7468 6520 6469 736b 2073 o use the disk s │ │ │ │ │ -0000b4b0: 7761 7070 696e 6720 7465 6368 6e69 7175 wapping techniqu │ │ │ │ │ -0000b4c0: 652c 2062 6563 6175 7365 2074 6861 7420 e, because that │ │ │ │ │ -0000b4d0: 4f53 2063 616e 6e6f 7420 626f 6f74 0a66 OS cannot boot.f │ │ │ │ │ -0000b4e0: 726f 6d20 616e 7920 6469 736b 7320 6275 rom any disks bu │ │ │ │ │ -0000b4f0: 7420 7468 6520 6669 7273 7420 6f6e 652e t the first one. │ │ │ │ │ -0000b500: 2020 5468 6520 776f 726b 6172 6f75 6e64 The workaround │ │ │ │ │ -0000b510: 2075 7365 6420 696e 2047 5255 4220 6973 used in GRUB is │ │ │ │ │ -0000b520: 2074 6865 0a63 6f6d 6d61 6e64 2027 6472 the.command 'dr │ │ │ │ │ -0000b530: 6976 656d 6170 2720 282a 6e6f 7465 2064 ivemap' (*note d │ │ │ │ │ -0000b540: 7269 7665 6d61 703a 3a29 2c20 6c69 6b65 rivemap::), like │ │ │ │ │ -0000b550: 2074 6869 733a 0a0a 2020 2020 2064 7269 this:.. dri │ │ │ │ │ -0000b560: 7665 6d61 7020 2d73 2028 6864 3029 2028 vemap -s (hd0) ( │ │ │ │ │ -0000b570: 6864 3129 0a0a 2020 2054 6869 7320 7065 hd1).. This pe │ │ │ │ │ -0000b580: 7266 6f72 6d73 2061 2022 7669 7274 7561 rforms a "virtua │ │ │ │ │ -0000b590: 6c22 2073 7761 7020 6265 7477 6565 6e20 l" swap between │ │ │ │ │ -0000b5a0: 796f 7572 2066 6972 7374 2061 6e64 2073 your first and s │ │ │ │ │ -0000b5b0: 6563 6f6e 6420 6861 7264 0a64 7269 7665 econd hard.drive │ │ │ │ │ -0000b5c0: 2e0a 0a20 2020 2a43 6175 7469 6f6e 3a2a ... *Caution:* │ │ │ │ │ -0000b5d0: 2054 6869 7320 6973 2065 6666 6563 7469 This is effecti │ │ │ │ │ -0000b5e0: 7665 206f 6e6c 7920 6966 2044 4f53 2028 ve only if DOS ( │ │ │ │ │ -0000b5f0: 6f72 2057 696e 646f 7773 2920 7573 6573 or Windows) uses │ │ │ │ │ -0000b600: 2042 494f 5320 746f 0a61 6363 6573 7320 BIOS to.access │ │ │ │ │ -0000b610: 7468 6520 7377 6170 7065 6420 6469 736b the swapped disk │ │ │ │ │ -0000b620: 732e 2020 4966 2074 6861 7420 4f53 2075 s. If that OS u │ │ │ │ │ -0000b630: 7365 7320 6120 7370 6563 6961 6c20 6472 ses a special dr │ │ │ │ │ -0000b640: 6976 6572 2066 6f72 2074 6865 0a64 6973 iver for the.dis │ │ │ │ │ -0000b650: 6b73 2c20 7468 6973 2070 726f 6261 626c ks, this probabl │ │ │ │ │ -0000b660: 7920 776f 6e27 7420 776f 726b 2e0a 0a20 y won't work... │ │ │ │ │ -0000b670: 2020 416e 6f74 6865 7220 7072 6f62 6c65 Another proble │ │ │ │ │ -0000b680: 6d20 6172 6973 6573 2069 6620 796f 7520 m arises if you │ │ │ │ │ -0000b690: 696e 7374 616c 6c65 6420 6d6f 7265 2074 installed more t │ │ │ │ │ -0000b6a0: 6861 6e20 6f6e 6520 7365 7420 6f66 0a44 han one set of.D │ │ │ │ │ -0000b6b0: 4f53 2f57 696e 646f 7773 206f 6e74 6f20 OS/Windows onto │ │ │ │ │ -0000b6c0: 6f6e 6520 6469 736b 2c20 6265 6361 7573 one disk, becaus │ │ │ │ │ -0000b6d0: 6520 7468 6579 2063 6f75 6c64 2062 6520 e they could be │ │ │ │ │ -0000b6e0: 636f 6e66 7573 6564 2069 6620 7468 6572 confused if ther │ │ │ │ │ -0000b6f0: 6520 6172 650a 6d6f 7265 2074 6861 6e20 e are.more than │ │ │ │ │ -0000b700: 6f6e 6520 7072 696d 6172 7920 7061 7274 one primary part │ │ │ │ │ -0000b710: 6974 696f 6e73 2066 6f72 2044 4f53 2f57 itions for DOS/W │ │ │ │ │ -0000b720: 696e 646f 7773 2e20 2043 6572 7461 696e indows. Certain │ │ │ │ │ -0000b730: 6c79 2079 6f75 2073 686f 756c 640a 6176 ly you should.av │ │ │ │ │ -0000b740: 6f69 6420 646f 696e 6720 7468 6973 2c20 oid doing this, │ │ │ │ │ -0000b750: 6275 7420 7468 6572 6520 6973 2061 2073 but there is a s │ │ │ │ │ -0000b760: 6f6c 7574 696f 6e20 6966 2079 6f75 2064 olution if you d │ │ │ │ │ -0000b770: 6f20 7761 6e74 2074 6f20 646f 2073 6f2e o want to do so. │ │ │ │ │ -0000b780: 2020 5573 650a 7468 6520 7061 7274 6974 Use.the partit │ │ │ │ │ -0000b790: 696f 6e20 6869 6469 6e67 2f75 6e68 6964 ion hiding/unhid │ │ │ │ │ -0000b7a0: 696e 6720 7465 6368 6e69 7175 652e 0a0a ing technique... │ │ │ │ │ -0000b7b0: 2020 2049 6620 4752 5542 2022 6869 6465 If GRUB "hide │ │ │ │ │ -0000b7c0: 7322 2061 2044 4f53 2028 6f72 2057 696e s" a DOS (or Win │ │ │ │ │ -0000b7d0: 646f 7773 2920 7061 7274 6974 696f 6e20 dows) partition │ │ │ │ │ -0000b7e0: 282a 6e6f 7465 2070 6172 7474 6f6f 6c3a (*note parttool: │ │ │ │ │ -0000b7f0: 3a29 2c20 444f 530a 286f 7220 5769 6e64 :), DOS.(or Wind │ │ │ │ │ -0000b800: 6f77 7329 2077 696c 6c20 6967 6e6f 7265 ows) will ignore │ │ │ │ │ -0000b810: 2074 6865 2070 6172 7469 7469 6f6e 2e20 the partition. │ │ │ │ │ -0000b820: 2049 6620 4752 5542 2022 756e 6869 6465 If GRUB "unhide │ │ │ │ │ -0000b830: 7322 2061 2044 4f53 2028 6f72 0a57 696e s" a DOS (or.Win │ │ │ │ │ -0000b840: 646f 7773 2920 7061 7274 6974 696f 6e2c dows) partition, │ │ │ │ │ -0000b850: 2044 4f53 2028 6f72 2057 696e 646f 7773 DOS (or Windows │ │ │ │ │ -0000b860: 2920 7769 6c6c 2064 6574 6563 7420 7468 ) will detect th │ │ │ │ │ -0000b870: 6520 7061 7274 6974 696f 6e2e 2020 5468 e partition. Th │ │ │ │ │ -0000b880: 7573 2c0a 6966 2079 6f75 2068 6176 6520 us,.if you have │ │ │ │ │ -0000b890: 696e 7374 616c 6c65 6420 444f 5320 286f installed DOS (o │ │ │ │ │ -0000b8a0: 7220 5769 6e64 6f77 7329 206f 6e20 7468 r Windows) on th │ │ │ │ │ -0000b8b0: 6520 6669 7273 7420 616e 6420 7468 6520 e first and the │ │ │ │ │ -0000b8c0: 7365 636f 6e64 0a70 6172 7469 7469 6f6e second.partition │ │ │ │ │ -0000b8d0: 206f 6620 7468 6520 6669 7273 7420 6861 of the first ha │ │ │ │ │ -0000b8e0: 7264 2064 6973 6b2c 2061 6e64 2079 6f75 rd disk, and you │ │ │ │ │ -0000b8f0: 2077 616e 7420 746f 2062 6f6f 7420 7468 want to boot th │ │ │ │ │ -0000b900: 6520 636f 7079 206f 6e20 7468 650a 6669 e copy on the.fi │ │ │ │ │ -0000b910: 7273 7420 7061 7274 6974 696f 6e2c 2064 rst partition, d │ │ │ │ │ -0000b920: 6f20 7468 6520 666f 6c6c 6f77 696e 673a o the following: │ │ │ │ │ -0000b930: 0a0a 2020 2020 2070 6172 7474 6f6f 6c20 .. parttool │ │ │ │ │ -0000b940: 2868 6430 2c31 2920 6869 6464 656e 2d0a (hd0,1) hidden-. │ │ │ │ │ -0000b950: 2020 2020 2070 6172 7474 6f6f 6c20 2868 parttool (h │ │ │ │ │ -0000b960: 6430 2c32 2920 6869 6464 656e 2b0a 2020 d0,2) hidden+. │ │ │ │ │ -0000b970: 2020 2073 6574 2072 6f6f 743d 2868 6430 set root=(hd0 │ │ │ │ │ -0000b980: 2c31 290a 2020 2020 2063 6861 696e 6c6f ,1). chainlo │ │ │ │ │ -0000b990: 6164 6572 202b 310a 2020 2020 2070 6172 ader +1. par │ │ │ │ │ -0000b9a0: 7474 6f6f 6c20 247b 726f 6f74 7d20 626f ttool ${root} bo │ │ │ │ │ -0000b9b0: 6f74 2b0a 2020 2020 2062 6f6f 740a 0a1f ot+. boot... │ │ │ │ │ -0000b9c0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -0000b9d0: 2c20 204e 6f64 653a 2043 6f6e 6669 6775 , Node: Configu │ │ │ │ │ -0000b9e0: 7261 7469 6f6e 2c20 204e 6578 743a 2054 ration, Next: T │ │ │ │ │ -0000b9f0: 6865 6d65 2066 696c 6520 666f 726d 6174 heme file format │ │ │ │ │ -0000ba00: 2c20 2050 7265 763a 2042 6f6f 7469 6e67 , Prev: Booting │ │ │ │ │ -0000ba10: 2c20 2055 703a 2054 6f70 0a0a 3620 5772 , Up: Top..6 Wr │ │ │ │ │ -0000ba20: 6974 696e 6720 796f 7572 206f 776e 2063 iting your own c │ │ │ │ │ -0000ba30: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ │ -0000ba40: 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a e.************** │ │ │ │ │ +0000a6e0: 2020 2020 2020 2020 2020 202d 2d65 7865 --exe │ │ │ │ │ +0000a6f0: 632d 7365 7276 6572 2d74 6173 6b3d 2724 c-server-task='$ │ │ │ │ │ +0000a700: 7b65 7865 632d 7461 736b 7d27 202d 5420 {exec-task}' -T │ │ │ │ │ +0000a710: 7479 7065 6420 2724 7b72 6f6f 747d 2720 typed '${root}' │ │ │ │ │ +0000a720: 5c0a 2020 2020 2020 2020 2020 2020 2020 \. │ │ │ │ │ +0000a730: 2020 2020 2020 2020 2020 2020 2020 2027 ' │ │ │ │ │ +0000a740: 2428 7461 736b 2d63 7265 6174 6529 2720 $(task-create)' │ │ │ │ │ +0000a750: 2724 2874 6173 6b2d 7265 7375 6d65 2927 '$(task-resume)' │ │ │ │ │ +0000a760: 0a20 2020 2020 2020 2020 2067 7275 623e . grub> │ │ │ │ │ +0000a770: 206d 6f64 756c 6520 2f6c 6962 2f6c 642e module /lib/ld. │ │ │ │ │ +0000a780: 736f 2e31 2065 7865 6320 2f68 7572 642f so.1 exec /hurd/ │ │ │ │ │ +0000a790: 6578 6563 2027 2428 6578 6563 2d74 6173 exec '$(exec-tas │ │ │ │ │ +0000a7a0: 6b3d 7461 736b 2d63 7265 6174 6529 270a k=task-create)'. │ │ │ │ │ +0000a7b0: 0a20 2033 2e20 4669 6e61 6c6c 792c 2072 . 3. Finally, r │ │ │ │ │ +0000a7c0: 756e 2074 6865 2063 6f6d 6d61 6e64 2027 un the command ' │ │ │ │ │ +0000a7d0: 626f 6f74 2720 282a 6e6f 7465 2062 6f6f boot' (*note boo │ │ │ │ │ +0000a7e0: 743a 3a29 2e0a 0a1f 0a46 696c 653a 2067 t::).....File: g │ │ │ │ │ +0000a7f0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +0000a800: 2047 4e55 2f4c 696e 7578 2c20 204e 6578 GNU/Linux, Nex │ │ │ │ │ +0000a810: 743a 204e 6574 4253 442c 2020 5072 6576 t: NetBSD, Prev │ │ │ │ │ +0000a820: 3a20 474e 552f 4875 7264 2c20 2055 703a : GNU/Hurd, Up: │ │ │ │ │ +0000a830: 204f 532d 7370 6563 6966 6963 206e 6f74 OS-specific not │ │ │ │ │ +0000a840: 6573 0a0a 352e 342e 3220 474e 552f 4c69 es..5.4.2 GNU/Li │ │ │ │ │ +0000a850: 6e75 780a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d nux.------------ │ │ │ │ │ +0000a860: 2d2d 2d0a 0a49 7420 6973 2072 656c 6174 ---..It is relat │ │ │ │ │ +0000a870: 6976 656c 7920 6561 7379 2074 6f20 626f ively easy to bo │ │ │ │ │ +0000a880: 6f74 2047 4e55 2f4c 696e 7578 2066 726f ot GNU/Linux fro │ │ │ │ │ +0000a890: 6d20 4752 5542 2c20 6265 6361 7573 6520 m GRUB, because │ │ │ │ │ +0000a8a0: 6974 2073 6f6d 6577 6861 740a 7265 7365 it somewhat.rese │ │ │ │ │ +0000a8b0: 6d62 6c65 7320 746f 2062 6f6f 7420 6120 mbles to boot a │ │ │ │ │ +0000a8c0: 4d75 6c74 6962 6f6f 742d 636f 6d70 6c69 Multiboot-compli │ │ │ │ │ +0000a8d0: 616e 7420 4f53 2e0a 0a20 2031 2e20 5365 ant OS... 1. Se │ │ │ │ │ +0000a8e0: 7420 4752 5542 2773 2072 6f6f 7420 6465 t GRUB's root de │ │ │ │ │ +0000a8f0: 7669 6365 2074 6f20 7468 6520 7361 6d65 vice to the same │ │ │ │ │ +0000a900: 2064 7269 7665 2061 7320 474e 552f 4c69 drive as GNU/Li │ │ │ │ │ +0000a910: 6e75 7827 732e 2020 5468 650a 2020 2020 nux's. The. │ │ │ │ │ +0000a920: 2063 6f6d 6d61 6e64 2027 7365 6172 6368 command 'search │ │ │ │ │ +0000a930: 202d 2d73 6574 3d72 6f6f 7420 2d2d 6669 --set=root --fi │ │ │ │ │ +0000a940: 6c65 202f 766d 6c69 6e75 7a27 206f 7220 le /vmlinuz' or │ │ │ │ │ +0000a950: 7369 6d69 6c61 7220 6d61 7920 6865 6c70 similar may help │ │ │ │ │ +0000a960: 2079 6f75 0a20 2020 2020 282a 6e6f 7465 you. (*note │ │ │ │ │ +0000a970: 2073 6561 7263 683a 3a29 2e0a 0a20 2032 search::)... 2 │ │ │ │ │ +0000a980: 2e20 4c6f 6164 2074 6865 206b 6572 6e65 . Load the kerne │ │ │ │ │ +0000a990: 6c20 7573 696e 6720 7468 6520 636f 6d6d l using the comm │ │ │ │ │ +0000a9a0: 616e 6420 276c 696e 7578 2720 282a 6e6f and 'linux' (*no │ │ │ │ │ +0000a9b0: 7465 206c 696e 7578 3a3a 293a 0a0a 2020 te linux::):.. │ │ │ │ │ +0000a9c0: 2020 2020 2020 2020 6772 7562 3e20 6c69 grub> li │ │ │ │ │ +0000a9d0: 6e75 7820 2f76 6d6c 696e 757a 2072 6f6f nux /vmlinuz roo │ │ │ │ │ +0000a9e0: 743d 2f64 6576 2f73 6461 310a 0a20 2020 t=/dev/sda1.. │ │ │ │ │ +0000a9f0: 2020 4966 2079 6f75 206e 6565 6420 746f If you need to │ │ │ │ │ +0000aa00: 2073 7065 6369 6679 2073 6f6d 6520 6b65 specify some ke │ │ │ │ │ +0000aa10: 726e 656c 2070 6172 616d 6574 6572 732c rnel parameters, │ │ │ │ │ +0000aa20: 206a 7573 7420 6170 7065 6e64 2074 6865 just append the │ │ │ │ │ +0000aa30: 6d20 746f 0a20 2020 2020 7468 6520 636f m to. the co │ │ │ │ │ +0000aa40: 6d6d 616e 642e 2020 466f 7220 6578 616d mmand. For exam │ │ │ │ │ +0000aa50: 706c 652c 2074 6f20 7365 7420 2761 6370 ple, to set 'acp │ │ │ │ │ +0000aa60: 6927 2074 6f20 276f 6666 272c 2064 6f20 i' to 'off', do │ │ │ │ │ +0000aa70: 7468 6973 3a0a 0a20 2020 2020 2020 2020 this:.. │ │ │ │ │ +0000aa80: 2067 7275 623e 206c 696e 7578 202f 766d grub> linux /vm │ │ │ │ │ +0000aa90: 6c69 6e75 7a20 726f 6f74 3d2f 6465 762f linuz root=/dev/ │ │ │ │ │ +0000aaa0: 7364 6131 2061 6370 693d 6f66 660a 0a20 sda1 acpi=off.. │ │ │ │ │ +0000aab0: 2020 2020 5365 6520 7468 6520 646f 6375 See the docu │ │ │ │ │ +0000aac0: 6d65 6e74 6174 696f 6e20 696e 2074 6865 mentation in the │ │ │ │ │ +0000aad0: 204c 696e 7578 2073 6f75 7263 6520 7472 Linux source tr │ │ │ │ │ +0000aae0: 6565 2066 6f72 2063 6f6d 706c 6574 650a ee for complete. │ │ │ │ │ +0000aaf0: 2020 2020 2069 6e66 6f72 6d61 7469 6f6e information │ │ │ │ │ +0000ab00: 206f 6e20 7468 6520 6176 6169 6c61 626c on the availabl │ │ │ │ │ +0000ab10: 6520 6f70 7469 6f6e 732e 0a0a 2020 2020 e options... │ │ │ │ │ +0000ab20: 2057 6974 6820 276c 696e 7578 2720 4752 With 'linux' GR │ │ │ │ │ +0000ab30: 5542 2075 7365 7320 3332 2d62 6974 2070 UB uses 32-bit p │ │ │ │ │ +0000ab40: 726f 746f 636f 6c2e 2020 536f 6d65 2042 rotocol. Some B │ │ │ │ │ +0000ab50: 494f 5320 7365 7276 6963 6573 206c 696b IOS services lik │ │ │ │ │ +0000ab60: 650a 2020 2020 2041 504d 206f 7220 4544 e. APM or ED │ │ │ │ │ +0000ab70: 4420 6172 656e 2774 2061 7661 696c 6162 D aren't availab │ │ │ │ │ +0000ab80: 6c65 2077 6974 6820 7468 6973 2070 726f le with this pro │ │ │ │ │ +0000ab90: 746f 636f 6c2e 2020 496e 2074 6869 7320 tocol. In this │ │ │ │ │ +0000aba0: 6361 7365 2079 6f75 0a20 2020 2020 6e65 case you. ne │ │ │ │ │ +0000abb0: 6564 2074 6f20 7573 6520 276c 696e 7578 ed to use 'linux │ │ │ │ │ +0000abc0: 3136 270a 0a20 2020 2020 2020 2020 2067 16'.. g │ │ │ │ │ +0000abd0: 7275 623e 206c 696e 7578 3136 202f 766d rub> linux16 /vm │ │ │ │ │ +0000abe0: 6c69 6e75 7a20 726f 6f74 3d2f 6465 762f linuz root=/dev/ │ │ │ │ │ +0000abf0: 7364 6131 2061 6370 693d 6f66 660a 0a20 sda1 acpi=off.. │ │ │ │ │ +0000ac00: 2033 2e20 4966 2079 6f75 2075 7365 2061 3. If you use a │ │ │ │ │ +0000ac10: 6e20 696e 6974 7264 2c20 6578 6563 7574 n initrd, execut │ │ │ │ │ +0000ac20: 6520 7468 6520 636f 6d6d 616e 6420 2769 e the command 'i │ │ │ │ │ +0000ac30: 6e69 7472 6427 2028 2a6e 6f74 6520 696e nitrd' (*note in │ │ │ │ │ +0000ac40: 6974 7264 3a3a 290a 2020 2020 2061 6674 itrd::). aft │ │ │ │ │ +0000ac50: 6572 2027 6c69 6e75 7827 3a0a 0a20 2020 er 'linux':.. │ │ │ │ │ +0000ac60: 2020 2020 2020 2067 7275 623e 2069 6e69 grub> ini │ │ │ │ │ +0000ac70: 7472 6420 2f69 6e69 7472 640a 0a20 2020 trd /initrd.. │ │ │ │ │ +0000ac80: 2020 4966 2079 6f75 2075 7365 6420 276c If you used 'l │ │ │ │ │ +0000ac90: 696e 7578 3136 2720 796f 7520 6e65 6564 inux16' you need │ │ │ │ │ +0000aca0: 2074 6f20 7573 6520 2769 6e69 7472 6431 to use 'initrd1 │ │ │ │ │ +0000acb0: 3627 3a0a 0a20 2020 2020 2020 2020 2067 6':.. g │ │ │ │ │ +0000acc0: 7275 623e 2069 6e69 7472 6431 3620 2f69 rub> initrd16 /i │ │ │ │ │ +0000acd0: 6e69 7472 640a 0a20 2034 2e20 4669 6e61 nitrd.. 4. Fina │ │ │ │ │ +0000ace0: 6c6c 792c 2072 756e 2074 6865 2063 6f6d lly, run the com │ │ │ │ │ +0000acf0: 6d61 6e64 2027 626f 6f74 2720 282a 6e6f mand 'boot' (*no │ │ │ │ │ +0000ad00: 7465 2062 6f6f 743a 3a29 2e0a 0a1f 0a46 te boot::).....F │ │ │ │ │ +0000ad10: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +0000ad20: 204e 6f64 653a 204e 6574 4253 442c 2020 Node: NetBSD, │ │ │ │ │ +0000ad30: 4e65 7874 3a20 444f 532f 5769 6e64 6f77 Next: DOS/Window │ │ │ │ │ +0000ad40: 732c 2020 5072 6576 3a20 474e 552f 4c69 s, Prev: GNU/Li │ │ │ │ │ +0000ad50: 6e75 782c 2020 5570 3a20 4f53 2d73 7065 nux, Up: OS-spe │ │ │ │ │ +0000ad60: 6369 6669 6320 6e6f 7465 730a 0a35 2e34 cific notes..5.4 │ │ │ │ │ +0000ad70: 2e33 204e 6574 4253 440a 2d2d 2d2d 2d2d .3 NetBSD.------ │ │ │ │ │ +0000ad80: 2d2d 2d2d 2d2d 0a0a 426f 6f74 696e 6720 ------..Booting │ │ │ │ │ +0000ad90: 6120 4e65 7442 5344 206b 6572 6e65 6c20 a NetBSD kernel │ │ │ │ │ +0000ada0: 6672 6f6d 2047 5255 4220 6973 2061 6c73 from GRUB is als │ │ │ │ │ +0000adb0: 6f20 7265 6c61 7469 7665 6c79 2065 6173 o relatively eas │ │ │ │ │ +0000adc0: 793a 2066 6972 7374 2073 6574 0a47 5255 y: first set.GRU │ │ │ │ │ +0000add0: 4227 7320 726f 6f74 2064 6576 6963 652c B's root device, │ │ │ │ │ +0000ade0: 2074 6865 6e20 6c6f 6164 2074 6865 206b then load the k │ │ │ │ │ +0000adf0: 6572 6e65 6c20 616e 6420 7468 6520 6d6f ernel and the mo │ │ │ │ │ +0000ae00: 6475 6c65 732c 2061 6e64 2066 696e 616c dules, and final │ │ │ │ │ +0000ae10: 6c79 0a72 756e 2027 626f 6f74 272e 0a0a ly.run 'boot'... │ │ │ │ │ +0000ae20: 2020 312e 2053 6574 2047 5255 4227 7320 1. Set GRUB's │ │ │ │ │ +0000ae30: 726f 6f74 2064 6576 6963 6520 746f 2074 root device to t │ │ │ │ │ +0000ae40: 6865 2070 6172 7469 7469 6f6e 2068 6f6c he partition hol │ │ │ │ │ +0000ae50: 6469 6e67 2074 6865 204e 6574 4253 4420 ding the NetBSD │ │ │ │ │ +0000ae60: 726f 6f74 0a20 2020 2020 6669 6c65 2073 root. file s │ │ │ │ │ +0000ae70: 7973 7465 6d2e 2020 466f 7220 6120 6469 ystem. For a di │ │ │ │ │ +0000ae80: 736b 2077 6974 6820 6120 4e65 7442 5344 sk with a NetBSD │ │ │ │ │ +0000ae90: 2064 6973 6b20 6c61 6265 6c2c 2074 6869 disk label, thi │ │ │ │ │ +0000aea0: 7320 6973 2075 7375 616c 6c79 0a20 2020 s is usually. │ │ │ │ │ +0000aeb0: 2020 7468 6520 6669 7273 7420 7061 7274 the first part │ │ │ │ │ +0000aec0: 6974 696f 6e20 2861 3a29 2e20 2049 6e20 ition (a:). In │ │ │ │ │ +0000aed0: 7468 6174 2063 6173 652c 2061 6e64 2061 that case, and a │ │ │ │ │ +0000aee0: 7373 756d 696e 6720 7468 6174 2074 6865 ssuming that the │ │ │ │ │ +0000aef0: 0a20 2020 2020 7061 7274 6974 696f 6e20 . partition │ │ │ │ │ +0000af00: 6973 206f 6e20 7468 6520 6669 7273 7420 is on the first │ │ │ │ │ +0000af10: 6861 7264 2064 6973 6b2c 2073 6574 2047 hard disk, set G │ │ │ │ │ +0000af20: 5255 4227 7320 726f 6f74 2064 6576 6963 RUB's root devic │ │ │ │ │ +0000af30: 6520 6173 0a20 2020 2020 666f 6c6c 6f77 e as. follow │ │ │ │ │ +0000af40: 733a 0a0a 2020 2020 2020 2020 2020 6772 s:.. gr │ │ │ │ │ +0000af50: 7562 3e20 696e 736d 6f64 2070 6172 745f ub> insmod part_ │ │ │ │ │ +0000af60: 6273 640a 2020 2020 2020 2020 2020 6772 bsd. gr │ │ │ │ │ +0000af70: 7562 3e20 7365 7420 726f 6f74 3d28 6864 ub> set root=(hd │ │ │ │ │ +0000af80: 302c 6e65 7462 7364 3129 0a0a 2020 2020 0,netbsd1).. │ │ │ │ │ +0000af90: 2046 6f72 2061 2064 6973 6b20 7769 7468 For a disk with │ │ │ │ │ +0000afa0: 2061 2047 5549 4420 5061 7274 6974 696f a GUID Partitio │ │ │ │ │ +0000afb0: 6e20 5461 626c 6520 2847 5054 292c 2061 n Table (GPT), a │ │ │ │ │ +0000afc0: 6e64 2061 7373 756d 696e 6720 7468 6174 nd assuming that │ │ │ │ │ +0000afd0: 2074 6865 0a20 2020 2020 4e65 7442 5344 the. NetBSD │ │ │ │ │ +0000afe0: 2072 6f6f 7420 7061 7274 6974 696f 6e20 root partition │ │ │ │ │ +0000aff0: 6973 2074 6865 2074 6869 7264 2047 5054 is the third GPT │ │ │ │ │ +0000b000: 2070 6172 7469 7469 6f6e 2c20 646f 2074 partition, do t │ │ │ │ │ +0000b010: 6869 733a 0a0a 2020 2020 2020 2020 2020 his:.. │ │ │ │ │ +0000b020: 6772 7562 3e20 696e 736d 6f64 2070 6172 grub> insmod par │ │ │ │ │ +0000b030: 745f 6770 740a 2020 2020 2020 2020 2020 t_gpt. │ │ │ │ │ +0000b040: 6772 7562 3e20 7365 7420 726f 6f74 3d28 grub> set root=( │ │ │ │ │ +0000b050: 6864 302c 6770 7433 290a 0a20 2032 2e20 hd0,gpt3).. 2. │ │ │ │ │ +0000b060: 4c6f 6164 2074 6865 206b 6572 6e65 6c20 Load the kernel │ │ │ │ │ +0000b070: 7573 696e 6720 7468 6520 636f 6d6d 616e using the comman │ │ │ │ │ +0000b080: 6420 276b 6e65 7462 7364 273a 0a0a 2020 d 'knetbsd':.. │ │ │ │ │ +0000b090: 2020 2020 2020 2020 6772 7562 3e20 6b6e grub> kn │ │ │ │ │ +0000b0a0: 6574 6273 6420 2f6e 6574 6273 640a 0a20 etbsd /netbsd.. │ │ │ │ │ +0000b0b0: 2020 2020 5661 7269 6f75 7320 6f70 7469 Various opti │ │ │ │ │ +0000b0c0: 6f6e 7320 6d61 7920 6265 2067 6976 656e ons may be given │ │ │ │ │ +0000b0d0: 2074 6f20 276b 6e65 7462 7364 272e 2020 to 'knetbsd'. │ │ │ │ │ +0000b0e0: 5468 6573 6520 6f70 7469 6f6e 7320 6172 These options ar │ │ │ │ │ +0000b0f0: 652c 2066 6f72 0a20 2020 2020 7468 6520 e, for. the │ │ │ │ │ +0000b100: 6d6f 7374 2070 6172 742c 2074 6865 2073 most part, the s │ │ │ │ │ +0000b110: 616d 6520 6173 2069 6e20 7468 6520 4e65 ame as in the Ne │ │ │ │ │ +0000b120: 7442 5344 2062 6f6f 7420 6c6f 6164 6572 tBSD boot loader │ │ │ │ │ +0000b130: 2e20 2046 6f72 0a20 2020 2020 696e 7374 . For. inst │ │ │ │ │ +0000b140: 616e 6365 2c20 746f 2062 6f6f 7420 7468 ance, to boot th │ │ │ │ │ +0000b150: 6520 7379 7374 656d 2069 6e20 7369 6e67 e system in sing │ │ │ │ │ +0000b160: 6c65 2d75 7365 7220 6d6f 6465 2061 6e64 le-user mode and │ │ │ │ │ +0000b170: 2077 6974 6820 7665 7262 6f73 650a 2020 with verbose. │ │ │ │ │ +0000b180: 2020 206d 6573 7361 6765 732c 2064 6f20 messages, do │ │ │ │ │ +0000b190: 7468 6973 3a0a 0a20 2020 2020 2020 2020 this:.. │ │ │ │ │ +0000b1a0: 2067 7275 623e 206b 6e65 7462 7364 202f grub> knetbsd / │ │ │ │ │ +0000b1b0: 6e65 7462 7364 202d 7320 2d76 0a0a 2020 netbsd -s -v.. │ │ │ │ │ +0000b1c0: 332e 2049 6620 6e65 6564 6564 2c20 6c6f 3. If needed, lo │ │ │ │ │ +0000b1d0: 6164 206b 6572 6e65 6c20 6d6f 6475 6c65 ad kernel module │ │ │ │ │ +0000b1e0: 7320 7769 7468 2074 6865 2063 6f6d 6d61 s with the comma │ │ │ │ │ +0000b1f0: 6e64 0a20 2020 2020 276b 6e65 7462 7364 nd. 'knetbsd │ │ │ │ │ +0000b200: 5f6d 6f64 756c 655f 656c 6627 2e20 2041 _module_elf'. A │ │ │ │ │ +0000b210: 2074 7970 6963 616c 2065 7861 6d70 6c65 typical example │ │ │ │ │ +0000b220: 2069 7320 7468 6520 6d6f 6475 6c65 2066 is the module f │ │ │ │ │ +0000b230: 6f72 2074 6865 2072 6f6f 740a 2020 2020 or the root. │ │ │ │ │ +0000b240: 2066 696c 6520 7379 7374 656d 3a0a 0a20 file system:.. │ │ │ │ │ +0000b250: 2020 2020 2020 2020 2067 7275 623e 206b grub> k │ │ │ │ │ +0000b260: 6e65 7462 7364 5f6d 6f64 756c 655f 656c netbsd_module_el │ │ │ │ │ +0000b270: 6620 2f73 7461 6e64 2f61 6d64 3634 2f36 f /stand/amd64/6 │ │ │ │ │ +0000b280: 2e30 2f6d 6f64 756c 6573 2f66 6673 2f66 .0/modules/ffs/f │ │ │ │ │ +0000b290: 6673 2e6b 6d6f 640a 0a20 2034 2e20 4669 fs.kmod.. 4. Fi │ │ │ │ │ +0000b2a0: 6e61 6c6c 792c 2072 756e 2074 6865 2063 nally, run the c │ │ │ │ │ +0000b2b0: 6f6d 6d61 6e64 2027 626f 6f74 2720 282a ommand 'boot' (* │ │ │ │ │ +0000b2c0: 6e6f 7465 2062 6f6f 743a 3a29 2e0a 0a1f note boot::).... │ │ │ │ │ +0000b2d0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +0000b2e0: 2c20 204e 6f64 653a 2044 4f53 2f57 696e , Node: DOS/Win │ │ │ │ │ +0000b2f0: 646f 7773 2c20 2050 7265 763a 204e 6574 dows, Prev: Net │ │ │ │ │ +0000b300: 4253 442c 2020 5570 3a20 4f53 2d73 7065 BSD, Up: OS-spe │ │ │ │ │ +0000b310: 6369 6669 6320 6e6f 7465 730a 0a35 2e34 cific notes..5.4 │ │ │ │ │ +0000b320: 2e34 2044 4f53 2f57 696e 646f 7773 0a2d .4 DOS/Windows.- │ │ │ │ │ +0000b330: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0000b340: 0a0a 4752 5542 2063 616e 6e6f 7420 626f ..GRUB cannot bo │ │ │ │ │ +0000b350: 6f74 2044 4f53 206f 7220 5769 6e64 6f77 ot DOS or Window │ │ │ │ │ +0000b360: 7320 6469 7265 6374 6c79 2c20 736f 2079 s directly, so y │ │ │ │ │ +0000b370: 6f75 206d 7573 7420 6368 6169 6e2d 6c6f ou must chain-lo │ │ │ │ │ +0000b380: 6164 2074 6865 6d0a 282a 6e6f 7465 2043 ad them.(*note C │ │ │ │ │ +0000b390: 6861 696e 2d6c 6f61 6469 6e67 3a3a 292e hain-loading::). │ │ │ │ │ +0000b3a0: 2020 486f 7765 7665 722c 2074 6865 6972 However, their │ │ │ │ │ +0000b3b0: 2062 6f6f 7420 6c6f 6164 6572 7320 6861 boot loaders ha │ │ │ │ │ +0000b3c0: 7665 2073 6f6d 6520 6372 6974 6963 616c ve some critical │ │ │ │ │ +0000b3d0: 0a64 6566 6963 6965 6e63 6965 732c 2073 .deficiencies, s │ │ │ │ │ +0000b3e0: 6f20 6974 206d 6179 206e 6f74 2077 6f72 o it may not wor │ │ │ │ │ +0000b3f0: 6b20 746f 206a 7573 7420 6368 6169 6e2d k to just chain- │ │ │ │ │ +0000b400: 6c6f 6164 2074 6865 6d2e 2020 546f 206f load them. To o │ │ │ │ │ +0000b410: 7665 7263 6f6d 650a 7468 6520 7072 6f62 vercome.the prob │ │ │ │ │ +0000b420: 6c65 6d73 2c20 4752 5542 2070 726f 7669 lems, GRUB provi │ │ │ │ │ +0000b430: 6465 7320 796f 7520 7769 7468 2074 776f des you with two │ │ │ │ │ +0000b440: 2068 656c 7065 7220 6675 6e63 7469 6f6e helper function │ │ │ │ │ +0000b450: 732e 0a0a 2020 2049 6620 796f 7520 6861 s... If you ha │ │ │ │ │ +0000b460: 7665 2069 6e73 7461 6c6c 6564 2044 4f53 ve installed DOS │ │ │ │ │ +0000b470: 2028 6f72 2057 696e 646f 7773 2920 6f6e (or Windows) on │ │ │ │ │ +0000b480: 2061 206e 6f6e 2d66 6972 7374 2068 6172 a non-first har │ │ │ │ │ +0000b490: 6420 6469 736b 2c20 796f 750a 6861 7665 d disk, you.have │ │ │ │ │ +0000b4a0: 2074 6f20 7573 6520 7468 6520 6469 736b to use the disk │ │ │ │ │ +0000b4b0: 2073 7761 7070 696e 6720 7465 6368 6e69 swapping techni │ │ │ │ │ +0000b4c0: 7175 652c 2062 6563 6175 7365 2074 6861 que, because tha │ │ │ │ │ +0000b4d0: 7420 4f53 2063 616e 6e6f 7420 626f 6f74 t OS cannot boot │ │ │ │ │ +0000b4e0: 0a66 726f 6d20 616e 7920 6469 736b 7320 .from any disks │ │ │ │ │ +0000b4f0: 6275 7420 7468 6520 6669 7273 7420 6f6e but the first on │ │ │ │ │ +0000b500: 652e 2020 5468 6520 776f 726b 6172 6f75 e. The workarou │ │ │ │ │ +0000b510: 6e64 2075 7365 6420 696e 2047 5255 4220 nd used in GRUB │ │ │ │ │ +0000b520: 6973 2074 6865 0a63 6f6d 6d61 6e64 2027 is the.command ' │ │ │ │ │ +0000b530: 6472 6976 656d 6170 2720 282a 6e6f 7465 drivemap' (*note │ │ │ │ │ +0000b540: 2064 7269 7665 6d61 703a 3a29 2c20 6c69 drivemap::), li │ │ │ │ │ +0000b550: 6b65 2074 6869 733a 0a0a 2020 2020 2064 ke this:.. d │ │ │ │ │ +0000b560: 7269 7665 6d61 7020 2d73 2028 6864 3029 rivemap -s (hd0) │ │ │ │ │ +0000b570: 2028 6864 3129 0a0a 2020 2054 6869 7320 (hd1).. This │ │ │ │ │ +0000b580: 7065 7266 6f72 6d73 2061 2022 7669 7274 performs a "virt │ │ │ │ │ +0000b590: 7561 6c22 2073 7761 7020 6265 7477 6565 ual" swap betwee │ │ │ │ │ +0000b5a0: 6e20 796f 7572 2066 6972 7374 2061 6e64 n your first and │ │ │ │ │ +0000b5b0: 2073 6563 6f6e 6420 6861 7264 0a64 7269 second hard.dri │ │ │ │ │ +0000b5c0: 7665 2e0a 0a20 2020 2a43 6175 7469 6f6e ve... *Caution │ │ │ │ │ +0000b5d0: 3a2a 2054 6869 7320 6973 2065 6666 6563 :* This is effec │ │ │ │ │ +0000b5e0: 7469 7665 206f 6e6c 7920 6966 2044 4f53 tive only if DOS │ │ │ │ │ +0000b5f0: 2028 6f72 2057 696e 646f 7773 2920 7573 (or Windows) us │ │ │ │ │ +0000b600: 6573 2042 494f 5320 746f 0a61 6363 6573 es BIOS to.acces │ │ │ │ │ +0000b610: 7320 7468 6520 7377 6170 7065 6420 6469 s the swapped di │ │ │ │ │ +0000b620: 736b 732e 2020 4966 2074 6861 7420 4f53 sks. If that OS │ │ │ │ │ +0000b630: 2075 7365 7320 6120 7370 6563 6961 6c20 uses a special │ │ │ │ │ +0000b640: 6472 6976 6572 2066 6f72 2074 6865 0a64 driver for the.d │ │ │ │ │ +0000b650: 6973 6b73 2c20 7468 6973 2070 726f 6261 isks, this proba │ │ │ │ │ +0000b660: 626c 7920 776f 6e27 7420 776f 726b 2e0a bly won't work.. │ │ │ │ │ +0000b670: 0a20 2020 416e 6f74 6865 7220 7072 6f62 . Another prob │ │ │ │ │ +0000b680: 6c65 6d20 6172 6973 6573 2069 6620 796f lem arises if yo │ │ │ │ │ +0000b690: 7520 696e 7374 616c 6c65 6420 6d6f 7265 u installed more │ │ │ │ │ +0000b6a0: 2074 6861 6e20 6f6e 6520 7365 7420 6f66 than one set of │ │ │ │ │ +0000b6b0: 0a44 4f53 2f57 696e 646f 7773 206f 6e74 .DOS/Windows ont │ │ │ │ │ +0000b6c0: 6f20 6f6e 6520 6469 736b 2c20 6265 6361 o one disk, beca │ │ │ │ │ +0000b6d0: 7573 6520 7468 6579 2063 6f75 6c64 2062 use they could b │ │ │ │ │ +0000b6e0: 6520 636f 6e66 7573 6564 2069 6620 7468 e confused if th │ │ │ │ │ +0000b6f0: 6572 6520 6172 650a 6d6f 7265 2074 6861 ere are.more tha │ │ │ │ │ +0000b700: 6e20 6f6e 6520 7072 696d 6172 7920 7061 n one primary pa │ │ │ │ │ +0000b710: 7274 6974 696f 6e73 2066 6f72 2044 4f53 rtitions for DOS │ │ │ │ │ +0000b720: 2f57 696e 646f 7773 2e20 2043 6572 7461 /Windows. Certa │ │ │ │ │ +0000b730: 696e 6c79 2079 6f75 2073 686f 756c 640a inly you should. │ │ │ │ │ +0000b740: 6176 6f69 6420 646f 696e 6720 7468 6973 avoid doing this │ │ │ │ │ +0000b750: 2c20 6275 7420 7468 6572 6520 6973 2061 , but there is a │ │ │ │ │ +0000b760: 2073 6f6c 7574 696f 6e20 6966 2079 6f75 solution if you │ │ │ │ │ +0000b770: 2064 6f20 7761 6e74 2074 6f20 646f 2073 do want to do s │ │ │ │ │ +0000b780: 6f2e 2020 5573 650a 7468 6520 7061 7274 o. Use.the part │ │ │ │ │ +0000b790: 6974 696f 6e20 6869 6469 6e67 2f75 6e68 ition hiding/unh │ │ │ │ │ +0000b7a0: 6964 696e 6720 7465 6368 6e69 7175 652e iding technique. │ │ │ │ │ +0000b7b0: 0a0a 2020 2049 6620 4752 5542 2022 6869 .. If GRUB "hi │ │ │ │ │ +0000b7c0: 6465 7322 2061 2044 4f53 2028 6f72 2057 des" a DOS (or W │ │ │ │ │ +0000b7d0: 696e 646f 7773 2920 7061 7274 6974 696f indows) partitio │ │ │ │ │ +0000b7e0: 6e20 282a 6e6f 7465 2070 6172 7474 6f6f n (*note parttoo │ │ │ │ │ +0000b7f0: 6c3a 3a29 2c20 444f 530a 286f 7220 5769 l::), DOS.(or Wi │ │ │ │ │ +0000b800: 6e64 6f77 7329 2077 696c 6c20 6967 6e6f ndows) will igno │ │ │ │ │ +0000b810: 7265 2074 6865 2070 6172 7469 7469 6f6e re the partition │ │ │ │ │ +0000b820: 2e20 2049 6620 4752 5542 2022 756e 6869 . If GRUB "unhi │ │ │ │ │ +0000b830: 6465 7322 2061 2044 4f53 2028 6f72 0a57 des" a DOS (or.W │ │ │ │ │ +0000b840: 696e 646f 7773 2920 7061 7274 6974 696f indows) partitio │ │ │ │ │ +0000b850: 6e2c 2044 4f53 2028 6f72 2057 696e 646f n, DOS (or Windo │ │ │ │ │ +0000b860: 7773 2920 7769 6c6c 2064 6574 6563 7420 ws) will detect │ │ │ │ │ +0000b870: 7468 6520 7061 7274 6974 696f 6e2e 2020 the partition. │ │ │ │ │ +0000b880: 5468 7573 2c0a 6966 2079 6f75 2068 6176 Thus,.if you hav │ │ │ │ │ +0000b890: 6520 696e 7374 616c 6c65 6420 444f 5320 e installed DOS │ │ │ │ │ +0000b8a0: 286f 7220 5769 6e64 6f77 7329 206f 6e20 (or Windows) on │ │ │ │ │ +0000b8b0: 7468 6520 6669 7273 7420 616e 6420 7468 the first and th │ │ │ │ │ +0000b8c0: 6520 7365 636f 6e64 0a70 6172 7469 7469 e second.partiti │ │ │ │ │ +0000b8d0: 6f6e 206f 6620 7468 6520 6669 7273 7420 on of the first │ │ │ │ │ +0000b8e0: 6861 7264 2064 6973 6b2c 2061 6e64 2079 hard disk, and y │ │ │ │ │ +0000b8f0: 6f75 2077 616e 7420 746f 2062 6f6f 7420 ou want to boot │ │ │ │ │ +0000b900: 7468 6520 636f 7079 206f 6e20 7468 650a the copy on the. │ │ │ │ │ +0000b910: 6669 7273 7420 7061 7274 6974 696f 6e2c first partition, │ │ │ │ │ +0000b920: 2064 6f20 7468 6520 666f 6c6c 6f77 696e do the followin │ │ │ │ │ +0000b930: 673a 0a0a 2020 2020 2070 6172 7474 6f6f g:.. parttoo │ │ │ │ │ +0000b940: 6c20 2868 6430 2c31 2920 6869 6464 656e l (hd0,1) hidden │ │ │ │ │ +0000b950: 2d0a 2020 2020 2070 6172 7474 6f6f 6c20 -. parttool │ │ │ │ │ +0000b960: 2868 6430 2c32 2920 6869 6464 656e 2b0a (hd0,2) hidden+. │ │ │ │ │ +0000b970: 2020 2020 2073 6574 2072 6f6f 743d 2868 set root=(h │ │ │ │ │ +0000b980: 6430 2c31 290a 2020 2020 2063 6861 696e d0,1). chain │ │ │ │ │ +0000b990: 6c6f 6164 6572 202b 310a 2020 2020 2070 loader +1. p │ │ │ │ │ +0000b9a0: 6172 7474 6f6f 6c20 247b 726f 6f74 7d20 arttool ${root} │ │ │ │ │ +0000b9b0: 626f 6f74 2b0a 2020 2020 2062 6f6f 740a boot+. boot. │ │ │ │ │ +0000b9c0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +0000b9d0: 666f 2c20 204e 6f64 653a 2043 6f6e 6669 fo, Node: Confi │ │ │ │ │ +0000b9e0: 6775 7261 7469 6f6e 2c20 204e 6578 743a guration, Next: │ │ │ │ │ +0000b9f0: 2054 6865 6d65 2066 696c 6520 666f 726d Theme file form │ │ │ │ │ +0000ba00: 6174 2c20 2050 7265 763a 2042 6f6f 7469 at, Prev: Booti │ │ │ │ │ +0000ba10: 6e67 2c20 2055 703a 2054 6f70 0a0a 3620 ng, Up: Top..6 │ │ │ │ │ +0000ba20: 5772 6974 696e 6720 796f 7572 206f 776e Writing your own │ │ │ │ │ +0000ba30: 2063 6f6e 6669 6775 7261 7469 6f6e 2066 configuration f │ │ │ │ │ +0000ba40: 696c 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ile.************ │ │ │ │ │ 0000ba50: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0000ba60: 2a2a 2a2a 2a2a 2a0a 0a47 5255 4220 6973 *******..GRUB is │ │ │ │ │ -0000ba70: 2063 6f6e 6669 6775 7265 6420 7573 696e configured usin │ │ │ │ │ -0000ba80: 6720 2767 7275 622e 6366 6727 2c20 7573 g 'grub.cfg', us │ │ │ │ │ -0000ba90: 7561 6c6c 7920 6c6f 6361 7465 6420 756e ually located un │ │ │ │ │ -0000baa0: 6465 7220 272f 626f 6f74 2f67 7275 6227 der '/boot/grub' │ │ │ │ │ -0000bab0: 2e0a 5468 6973 2066 696c 6520 6973 2071 ..This file is q │ │ │ │ │ -0000bac0: 7569 7465 2066 6c65 7869 626c 652c 2062 uite flexible, b │ │ │ │ │ -0000bad0: 7574 206d 6f73 7420 7573 6572 7320 7769 ut most users wi │ │ │ │ │ -0000bae0: 6c6c 206e 6f74 206e 6565 6420 746f 2077 ll not need to w │ │ │ │ │ -0000baf0: 7269 7465 2074 6865 0a77 686f 6c65 2074 rite the.whole t │ │ │ │ │ -0000bb00: 6869 6e67 2062 7920 6861 6e64 2e0a 0a2a hing by hand...* │ │ │ │ │ -0000bb10: 204d 656e 753a 0a0a 2a20 5369 6d70 6c65 Menu:..* Simple │ │ │ │ │ -0000bb20: 2063 6f6e 6669 6775 7261 7469 6f6e 3a3a configuration:: │ │ │ │ │ -0000bb30: 2020 2020 2020 2020 2020 2020 5265 636f Reco │ │ │ │ │ -0000bb40: 6d6d 656e 6465 6420 666f 7220 6d6f 7374 mmended for most │ │ │ │ │ -0000bb50: 2075 7365 7273 0a2a 2052 6f6f 7420 4964 users.* Root Id │ │ │ │ │ -0000bb60: 656e 7469 6663 6174 696f 6e20 4865 7572 entifcation Heur │ │ │ │ │ -0000bb70: 6973 7469 6373 3a3a 2020 2053 756d 6d61 istics:: Summa │ │ │ │ │ -0000bb80: 7279 206f 6e20 686f 7720 7468 6520 726f ry on how the ro │ │ │ │ │ -0000bb90: 6f74 2066 696c 6520 7379 7374 656d 2069 ot file system i │ │ │ │ │ -0000bba0: 7320 6964 656e 7469 6669 6564 2e0a 2a20 s identified..* │ │ │ │ │ -0000bbb0: 5368 656c 6c2d 6c69 6b65 2073 6372 6970 Shell-like scrip │ │ │ │ │ -0000bbc0: 7469 6e67 3a3a 2020 2020 2020 2020 2020 ting:: │ │ │ │ │ -0000bbd0: 2020 466f 7220 706f 7765 7220 7573 6572 For power user │ │ │ │ │ -0000bbe0: 7320 616e 6420 6465 7665 6c6f 7065 7273 s and developers │ │ │ │ │ -0000bbf0: 0a2a 204d 756c 7469 2d62 6f6f 7420 6d61 .* Multi-boot ma │ │ │ │ │ -0000bc00: 6e75 616c 2063 6f6e 6669 673a 3a20 2020 nual config:: │ │ │ │ │ -0000bc10: 2020 2020 2046 6f72 206e 6f6e 2d73 7461 For non-sta │ │ │ │ │ -0000bc20: 6e64 6172 6420 6d75 6c74 692d 4f53 2073 ndard multi-OS s │ │ │ │ │ -0000bc30: 6365 6e61 7269 6f73 0a2a 2045 6d62 6564 cenarios.* Embed │ │ │ │ │ -0000bc40: 6465 6420 636f 6e66 6967 7572 6174 696f ded configuratio │ │ │ │ │ -0000bc50: 6e3a 3a20 2020 2020 2020 2020 2045 6d62 n:: Emb │ │ │ │ │ -0000bc60: 6564 6469 6e67 2061 2063 6f6e 6669 6775 edding a configu │ │ │ │ │ -0000bc70: 7261 7469 6f6e 2066 696c 6520 696e 746f ration file into │ │ │ │ │ -0000bc80: 2047 5255 420a 0a1f 0a46 696c 653a 2067 GRUB....File: g │ │ │ │ │ -0000bc90: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0000bca0: 2053 696d 706c 6520 636f 6e66 6967 7572 Simple configur │ │ │ │ │ -0000bcb0: 6174 696f 6e2c 2020 4e65 7874 3a20 526f ation, Next: Ro │ │ │ │ │ -0000bcc0: 6f74 2049 6465 6e74 6966 6361 7469 6f6e ot Identifcation │ │ │ │ │ -0000bcd0: 2048 6575 7269 7374 6963 732c 2020 5570 Heuristics, Up │ │ │ │ │ -0000bce0: 3a20 436f 6e66 6967 7572 6174 696f 6e0a : Configuration. │ │ │ │ │ -0000bcf0: 0a36 2e31 2053 696d 706c 6520 636f 6e66 .6.1 Simple conf │ │ │ │ │ -0000bd00: 6967 7572 6174 696f 6e20 6861 6e64 6c69 iguration handli │ │ │ │ │ -0000bd10: 6e67 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ng.============= │ │ │ │ │ +0000ba60: 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 5255 4220 *********..GRUB │ │ │ │ │ +0000ba70: 6973 2063 6f6e 6669 6775 7265 6420 7573 is configured us │ │ │ │ │ +0000ba80: 696e 6720 2767 7275 622e 6366 6727 2c20 ing 'grub.cfg', │ │ │ │ │ +0000ba90: 7573 7561 6c6c 7920 6c6f 6361 7465 6420 usually located │ │ │ │ │ +0000baa0: 756e 6465 7220 272f 626f 6f74 2f67 7275 under '/boot/gru │ │ │ │ │ +0000bab0: 6227 2e0a 5468 6973 2066 696c 6520 6973 b'..This file is │ │ │ │ │ +0000bac0: 2071 7569 7465 2066 6c65 7869 626c 652c quite flexible, │ │ │ │ │ +0000bad0: 2062 7574 206d 6f73 7420 7573 6572 7320 but most users │ │ │ │ │ +0000bae0: 7769 6c6c 206e 6f74 206e 6565 6420 746f will not need to │ │ │ │ │ +0000baf0: 2077 7269 7465 2074 6865 0a77 686f 6c65 write the.whole │ │ │ │ │ +0000bb00: 2074 6869 6e67 2062 7920 6861 6e64 2e0a thing by hand.. │ │ │ │ │ +0000bb10: 0a2a 204d 656e 753a 0a0a 2a20 5369 6d70 .* Menu:..* Simp │ │ │ │ │ +0000bb20: 6c65 2063 6f6e 6669 6775 7261 7469 6f6e le configuration │ │ │ │ │ +0000bb30: 3a3a 2020 2020 2020 2020 2020 2020 5265 :: Re │ │ │ │ │ +0000bb40: 636f 6d6d 656e 6465 6420 666f 7220 6d6f commended for mo │ │ │ │ │ +0000bb50: 7374 2075 7365 7273 0a2a 2052 6f6f 7420 st users.* Root │ │ │ │ │ +0000bb60: 4964 656e 7469 6663 6174 696f 6e20 4865 Identifcation He │ │ │ │ │ +0000bb70: 7572 6973 7469 6373 3a3a 2020 2053 756d uristics:: Sum │ │ │ │ │ +0000bb80: 6d61 7279 206f 6e20 686f 7720 7468 6520 mary on how the │ │ │ │ │ +0000bb90: 726f 6f74 2066 696c 6520 7379 7374 656d root file system │ │ │ │ │ +0000bba0: 2069 7320 6964 656e 7469 6669 6564 2e0a is identified.. │ │ │ │ │ +0000bbb0: 2a20 5368 656c 6c2d 6c69 6b65 2073 6372 * Shell-like scr │ │ │ │ │ +0000bbc0: 6970 7469 6e67 3a3a 2020 2020 2020 2020 ipting:: │ │ │ │ │ +0000bbd0: 2020 2020 466f 7220 706f 7765 7220 7573 For power us │ │ │ │ │ +0000bbe0: 6572 7320 616e 6420 6465 7665 6c6f 7065 ers and develope │ │ │ │ │ +0000bbf0: 7273 0a2a 204d 756c 7469 2d62 6f6f 7420 rs.* Multi-boot │ │ │ │ │ +0000bc00: 6d61 6e75 616c 2063 6f6e 6669 673a 3a20 manual config:: │ │ │ │ │ +0000bc10: 2020 2020 2020 2046 6f72 206e 6f6e 2d73 For non-s │ │ │ │ │ +0000bc20: 7461 6e64 6172 6420 6d75 6c74 692d 4f53 tandard multi-OS │ │ │ │ │ +0000bc30: 2073 6365 6e61 7269 6f73 0a2a 2045 6d62 scenarios.* Emb │ │ │ │ │ +0000bc40: 6564 6465 6420 636f 6e66 6967 7572 6174 edded configurat │ │ │ │ │ +0000bc50: 696f 6e3a 3a20 2020 2020 2020 2020 2045 ion:: E │ │ │ │ │ +0000bc60: 6d62 6564 6469 6e67 2061 2063 6f6e 6669 mbedding a confi │ │ │ │ │ +0000bc70: 6775 7261 7469 6f6e 2066 696c 6520 696e guration file in │ │ │ │ │ +0000bc80: 746f 2047 5255 420a 0a1f 0a46 696c 653a to GRUB....File: │ │ │ │ │ +0000bc90: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0000bca0: 653a 2053 696d 706c 6520 636f 6e66 6967 e: Simple config │ │ │ │ │ +0000bcb0: 7572 6174 696f 6e2c 2020 4e65 7874 3a20 uration, Next: │ │ │ │ │ +0000bcc0: 526f 6f74 2049 6465 6e74 6966 6361 7469 Root Identifcati │ │ │ │ │ +0000bcd0: 6f6e 2048 6575 7269 7374 6963 732c 2020 on Heuristics, │ │ │ │ │ +0000bce0: 5570 3a20 436f 6e66 6967 7572 6174 696f Up: Configuratio │ │ │ │ │ +0000bcf0: 6e0a 0a36 2e31 2053 696d 706c 6520 636f n..6.1 Simple co │ │ │ │ │ +0000bd00: 6e66 6967 7572 6174 696f 6e20 6861 6e64 nfiguration hand │ │ │ │ │ +0000bd10: 6c69 6e67 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ling.=========== │ │ │ │ │ 0000bd20: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0000bd30: 3d3d 3d3d 0a0a 5468 6520 7072 6f67 7261 ====..The progra │ │ │ │ │ -0000bd40: 6d20 2767 7275 622d 6d6b 636f 6e66 6967 m 'grub-mkconfig │ │ │ │ │ -0000bd50: 2720 282a 6e6f 7465 2049 6e76 6f6b 696e ' (*note Invokin │ │ │ │ │ -0000bd60: 6720 6772 7562 2d6d 6b63 6f6e 6669 673a g grub-mkconfig: │ │ │ │ │ -0000bd70: 3a29 2067 656e 6572 6174 6573 0a27 6772 :) generates.'gr │ │ │ │ │ -0000bd80: 7562 2e63 6667 2720 6669 6c65 7320 7375 ub.cfg' files su │ │ │ │ │ -0000bd90: 6974 6162 6c65 2066 6f72 206d 6f73 7420 itable for most │ │ │ │ │ -0000bda0: 6361 7365 732e 2020 4974 2069 7320 7375 cases. It is su │ │ │ │ │ -0000bdb0: 6974 6162 6c65 2066 6f72 2075 7365 2077 itable for use w │ │ │ │ │ -0000bdc0: 6865 6e0a 7570 6772 6164 696e 6720 6120 hen.upgrading a │ │ │ │ │ -0000bdd0: 6469 7374 7269 6275 7469 6f6e 2c20 616e distribution, an │ │ │ │ │ -0000bde0: 6420 7769 6c6c 2064 6973 636f 7665 7220 d will discover │ │ │ │ │ -0000bdf0: 6176 6169 6c61 626c 6520 6b65 726e 656c available kernel │ │ │ │ │ -0000be00: 7320 616e 640a 6174 7465 6d70 7420 746f s and.attempt to │ │ │ │ │ -0000be10: 2067 656e 6572 6174 6520 6d65 6e75 2065 generate menu e │ │ │ │ │ -0000be20: 6e74 7269 6573 2066 6f72 2074 6865 6d2e ntries for them. │ │ │ │ │ -0000be30: 0a0a 2020 2027 6772 7562 2d6d 6b63 6f6e .. 'grub-mkcon │ │ │ │ │ -0000be40: 6669 6727 2064 6f65 7320 6861 7665 2073 fig' does have s │ │ │ │ │ -0000be50: 6f6d 6520 6c69 6d69 7461 7469 6f6e 732e ome limitations. │ │ │ │ │ -0000be60: 2020 5768 696c 6520 6164 6469 6e67 2065 While adding e │ │ │ │ │ -0000be70: 7874 7261 0a63 7573 746f 6d20 6d65 6e75 xtra.custom menu │ │ │ │ │ -0000be80: 2065 6e74 7269 6573 2074 6f20 7468 6520 entries to the │ │ │ │ │ -0000be90: 656e 6420 6f66 2074 6865 206c 6973 7420 end of the list │ │ │ │ │ -0000bea0: 6361 6e20 6265 2064 6f6e 6520 6279 2065 can be done by e │ │ │ │ │ -0000beb0: 6469 7469 6e67 0a27 2f65 7463 2f67 7275 diting.'/etc/gru │ │ │ │ │ -0000bec0: 622e 642f 3430 5f63 7573 746f 6d27 206f b.d/40_custom' o │ │ │ │ │ -0000bed0: 7220 6372 6561 7469 6e67 2027 2f62 6f6f r creating '/boo │ │ │ │ │ -0000bee0: 742f 6772 7562 2f63 7573 746f 6d2e 6366 t/grub/custom.cf │ │ │ │ │ -0000bef0: 6727 2c20 6368 616e 6769 6e67 0a74 6865 g', changing.the │ │ │ │ │ -0000bf00: 206f 7264 6572 206f 6620 6d65 6e75 2065 order of menu e │ │ │ │ │ -0000bf10: 6e74 7269 6573 206f 7220 6368 616e 6769 ntries or changi │ │ │ │ │ -0000bf20: 6e67 2074 6865 6972 2074 6974 6c65 7320 ng their titles │ │ │ │ │ -0000bf30: 6d61 7920 7265 7175 6972 6520 6d61 6b69 may require maki │ │ │ │ │ -0000bf40: 6e67 0a63 6f6d 706c 6578 2063 6861 6e67 ng.complex chang │ │ │ │ │ -0000bf50: 6573 2074 6f20 7368 656c 6c20 7363 7269 es to shell scri │ │ │ │ │ -0000bf60: 7074 7320 7374 6f72 6564 2069 6e20 272f pts stored in '/ │ │ │ │ │ -0000bf70: 6574 632f 6772 7562 2e64 2f27 2e20 2054 etc/grub.d/'. T │ │ │ │ │ -0000bf80: 6869 7320 6d61 7920 6265 0a69 6d70 726f his may be.impro │ │ │ │ │ -0000bf90: 7665 6420 696e 2074 6865 2066 7574 7572 ved in the futur │ │ │ │ │ -0000bfa0: 652e 2020 496e 2074 6865 206d 6561 6e74 e. In the meant │ │ │ │ │ -0000bfb0: 696d 652c 2074 686f 7365 2077 686f 2066 ime, those who f │ │ │ │ │ -0000bfc0: 6565 6c20 7468 6174 2069 7420 776f 756c eel that it woul │ │ │ │ │ -0000bfd0: 640a 6265 2065 6173 6965 7220 746f 2077 d.be easier to w │ │ │ │ │ -0000bfe0: 7269 7465 2027 6772 7562 2e63 6667 2720 rite 'grub.cfg' │ │ │ │ │ -0000bff0: 6469 7265 6374 6c79 2061 7265 2065 6e63 directly are enc │ │ │ │ │ -0000c000: 6f75 7261 6765 6420 746f 2064 6f20 736f ouraged to do so │ │ │ │ │ -0000c010: 2028 2a6e 6f74 650a 426f 6f74 696e 673a (*note.Booting: │ │ │ │ │ -0000c020: 3a2c 2061 6e64 202a 6e6f 7465 2053 6865 :, and *note She │ │ │ │ │ -0000c030: 6c6c 2d6c 696b 6520 7363 7269 7074 696e ll-like scriptin │ │ │ │ │ -0000c040: 673a 3a29 2c20 616e 6420 746f 2064 6973 g::), and to dis │ │ │ │ │ -0000c050: 6162 6c65 2061 6e79 2073 7973 7465 6d0a able any system. │ │ │ │ │ -0000c060: 7072 6f76 6964 6564 2062 7920 7468 6569 provided by thei │ │ │ │ │ -0000c070: 7220 6469 7374 7269 6275 7469 6f6e 2074 r distribution t │ │ │ │ │ -0000c080: 6f20 6175 746f 6d61 7469 6361 6c6c 7920 o automatically │ │ │ │ │ -0000c090: 7275 6e20 2767 7275 622d 6d6b 636f 6e66 run 'grub-mkconf │ │ │ │ │ -0000c0a0: 6967 272e 0a0a 2020 2054 6865 2066 696c ig'... The fil │ │ │ │ │ -0000c0b0: 6520 272f 6574 632f 6465 6661 756c 742f e '/etc/default/ │ │ │ │ │ -0000c0c0: 6772 7562 2720 636f 6e74 726f 6c73 2074 grub' controls t │ │ │ │ │ -0000c0d0: 6865 206f 7065 7261 7469 6f6e 206f 660a he operation of. │ │ │ │ │ -0000c0e0: 2767 7275 622d 6d6b 636f 6e66 6967 272e 'grub-mkconfig'. │ │ │ │ │ -0000c0f0: 2020 4974 2069 7320 736f 7572 6365 6420 It is sourced │ │ │ │ │ -0000c100: 6279 2061 2073 6865 6c6c 2073 6372 6970 by a shell scrip │ │ │ │ │ -0000c110: 742c 2061 6e64 2073 6f20 6d75 7374 2062 t, and so must b │ │ │ │ │ -0000c120: 6520 7661 6c69 640a 504f 5349 5820 7368 e valid.POSIX sh │ │ │ │ │ -0000c130: 656c 6c20 696e 7075 743b 206e 6f72 6d61 ell input; norma │ │ │ │ │ -0000c140: 6c6c 792c 2069 7420 7769 6c6c 206a 7573 lly, it will jus │ │ │ │ │ -0000c150: 7420 6265 2061 2073 6571 7565 6e63 6520 t be a sequence │ │ │ │ │ -0000c160: 6f66 2027 4b45 593d 7661 6c75 6527 0a6c of 'KEY=value'.l │ │ │ │ │ -0000c170: 696e 6573 2c20 6275 7420 6966 2074 6865 ines, but if the │ │ │ │ │ -0000c180: 2076 616c 7565 2063 6f6e 7461 696e 7320 value contains │ │ │ │ │ -0000c190: 7370 6163 6573 206f 7220 6f74 6865 7220 spaces or other │ │ │ │ │ -0000c1a0: 7370 6563 6961 6c20 6368 6172 6163 7465 special characte │ │ │ │ │ -0000c1b0: 7273 2074 6865 6e0a 6974 206d 7573 7420 rs then.it must │ │ │ │ │ -0000c1c0: 6265 2071 756f 7465 642e 2020 466f 7220 be quoted. For │ │ │ │ │ -0000c1d0: 6578 616d 706c 653a 0a0a 2020 2020 2047 example:.. G │ │ │ │ │ -0000c1e0: 5255 425f 5445 524d 494e 414c 5f49 4e50 RUB_TERMINAL_INP │ │ │ │ │ -0000c1f0: 5554 3d22 636f 6e73 6f6c 6520 7365 7269 UT="console seri │ │ │ │ │ -0000c200: 616c 220a 0a20 2020 5661 6c69 6420 6b65 al".. Valid ke │ │ │ │ │ -0000c210: 7973 2069 6e20 272f 6574 632f 6465 6661 ys in '/etc/defa │ │ │ │ │ -0000c220: 756c 742f 6772 7562 2720 6172 6520 6173 ult/grub' are as │ │ │ │ │ -0000c230: 2066 6f6c 6c6f 7773 3a0a 0a27 4752 5542 follows:..'GRUB │ │ │ │ │ -0000c240: 5f44 4546 4155 4c54 270a 2020 2020 2054 _DEFAULT'. T │ │ │ │ │ -0000c250: 6865 2064 6566 6175 6c74 206d 656e 7520 he default menu │ │ │ │ │ -0000c260: 656e 7472 792e 2020 5468 6973 206d 6179 entry. This may │ │ │ │ │ -0000c270: 2062 6520 6120 6e75 6d62 6572 2c20 696e be a number, in │ │ │ │ │ -0000c280: 2077 6869 6368 2063 6173 6520 6974 0a20 which case it. │ │ │ │ │ -0000c290: 2020 2020 6964 656e 7469 6669 6573 2074 identifies t │ │ │ │ │ -0000c2a0: 6865 204e 7468 2065 6e74 7279 2069 6e20 he Nth entry in │ │ │ │ │ -0000c2b0: 7468 6520 6765 6e65 7261 7465 6420 6d65 the generated me │ │ │ │ │ -0000c2c0: 6e75 2063 6f75 6e74 6564 2066 726f 6d20 nu counted from │ │ │ │ │ -0000c2d0: 7a65 726f 2c0a 2020 2020 206f 7220 7468 zero,. or th │ │ │ │ │ -0000c2e0: 6520 7469 746c 6520 6f66 2061 206d 656e e title of a men │ │ │ │ │ -0000c2f0: 7520 656e 7472 792c 206f 7220 7468 6520 u entry, or the │ │ │ │ │ -0000c300: 7370 6563 6961 6c20 7374 7269 6e67 2027 special string ' │ │ │ │ │ -0000c310: 7361 7665 6427 2e20 2055 7369 6e67 0a20 saved'. Using. │ │ │ │ │ -0000c320: 2020 2020 7468 6520 6964 206d 6179 2062 the id may b │ │ │ │ │ -0000c330: 6520 7573 6566 756c 2069 6620 796f 7520 e useful if you │ │ │ │ │ -0000c340: 7761 6e74 2074 6f20 7365 7420 6120 6d65 want to set a me │ │ │ │ │ -0000c350: 6e75 2065 6e74 7279 2061 7320 7468 6520 nu entry as the │ │ │ │ │ -0000c360: 6465 6661 756c 740a 2020 2020 2065 7665 default. eve │ │ │ │ │ -0000c370: 6e20 7468 6f75 6768 2074 6865 7265 206d n though there m │ │ │ │ │ -0000c380: 6179 2062 6520 6120 7661 7269 6162 6c65 ay be a variable │ │ │ │ │ -0000c390: 206e 756d 6265 7220 6f66 2065 6e74 7269 number of entri │ │ │ │ │ -0000c3a0: 6573 2062 6566 6f72 6520 6974 2e0a 0a20 es before it... │ │ │ │ │ -0000c3b0: 2020 2020 466f 7220 6578 616d 706c 652c For example, │ │ │ │ │ -0000c3c0: 2069 6620 796f 7520 6861 7665 3a0a 0a20 if you have:.. │ │ │ │ │ -0000c3d0: 2020 2020 6d65 6e75 656e 7472 7920 2745 menuentry 'E │ │ │ │ │ -0000c3e0: 7861 6d70 6c65 2047 4e55 2f4c 696e 7578 xample GNU/Linux │ │ │ │ │ -0000c3f0: 2064 6973 7472 6962 7574 696f 6e27 202d distribution' - │ │ │ │ │ -0000c400: 2d63 6c61 7373 2067 6e75 2d6c 696e 7578 -class gnu-linux │ │ │ │ │ -0000c410: 202d 2d69 6420 6578 616d 706c 652d 676e --id example-gn │ │ │ │ │ -0000c420: 752d 6c69 6e75 7820 7b0a 2020 2020 2009 u-linux {. . │ │ │ │ │ -0000c430: 2e2e 2e0a 2020 2020 207d 0a0a 2020 2020 .... }.. │ │ │ │ │ -0000c440: 2074 6865 6e20 796f 7520 6361 6e20 6d61 then you can ma │ │ │ │ │ -0000c450: 6b65 2074 6869 7320 7468 6520 6465 6661 ke this the defa │ │ │ │ │ -0000c460: 756c 7420 7573 696e 673a 0a0a 2020 2020 ult using:.. │ │ │ │ │ -0000c470: 2020 2020 2020 4752 5542 5f44 4546 4155 GRUB_DEFAU │ │ │ │ │ -0000c480: 4c54 3d65 7861 6d70 6c65 2d67 6e75 2d6c LT=example-gnu-l │ │ │ │ │ -0000c490: 696e 7578 0a0a 2020 2020 2050 7265 7669 inux.. Previ │ │ │ │ │ -0000c4a0: 6f75 736c 7920 6974 2077 6173 2064 6f63 ously it was doc │ │ │ │ │ -0000c4b0: 756d 656e 7465 6420 7468 6520 7761 7920 umented the way │ │ │ │ │ -0000c4c0: 746f 2075 7365 2065 6e74 7279 2074 6974 to use entry tit │ │ │ │ │ -0000c4d0: 6c65 2e20 2057 6869 6c65 0a20 2020 2020 le. While. │ │ │ │ │ -0000c4e0: 7468 6973 2073 7469 6c6c 2077 6f72 6b73 this still works │ │ │ │ │ -0000c4f0: 2069 7427 7320 6e6f 7420 7265 636f 6d6d it's not recomm │ │ │ │ │ -0000c500: 656e 6465 6420 7369 6e63 6520 7469 746c ended since titl │ │ │ │ │ -0000c510: 6573 206f 6674 656e 2063 6f6e 7461 696e es often contain │ │ │ │ │ -0000c520: 0a20 2020 2020 756e 7374 6162 6c65 2064 . unstable d │ │ │ │ │ -0000c530: 6576 6963 6520 6e61 6d65 7320 616e 6420 evice names and │ │ │ │ │ -0000c540: 6d61 7920 6265 2074 7261 6e73 6c61 7465 may be translate │ │ │ │ │ -0000c550: 640a 0a20 2020 2020 4966 2079 6f75 2073 d.. If you s │ │ │ │ │ -0000c560: 6574 2074 6869 7320 746f 2027 7361 7665 et this to 'save │ │ │ │ │ -0000c570: 6427 2c20 7468 656e 2074 6865 2064 6566 d', then the def │ │ │ │ │ -0000c580: 6175 6c74 206d 656e 7520 656e 7472 7920 ault menu entry │ │ │ │ │ -0000c590: 7769 6c6c 2062 650a 2020 2020 2074 6861 will be. tha │ │ │ │ │ -0000c5a0: 7420 7361 7665 6420 6279 2027 4752 5542 t saved by 'GRUB │ │ │ │ │ -0000c5b0: 5f53 4156 4544 4546 4155 4c54 2720 6f72 _SAVEDEFAULT' or │ │ │ │ │ -0000c5c0: 2027 6772 7562 2d73 6574 2d64 6566 6175 'grub-set-defau │ │ │ │ │ -0000c5d0: 6c74 272e 2020 5468 6973 0a20 2020 2020 lt'. This. │ │ │ │ │ -0000c5e0: 7265 6c69 6573 206f 6e20 7468 6520 656e relies on the en │ │ │ │ │ -0000c5f0: 7669 726f 6e6d 656e 7420 626c 6f63 6b2c vironment block, │ │ │ │ │ -0000c600: 2077 6869 6368 206d 6179 206e 6f74 2062 which may not b │ │ │ │ │ -0000c610: 6520 6176 6169 6c61 626c 6520 696e 2061 e available in a │ │ │ │ │ -0000c620: 6c6c 0a20 2020 2020 7369 7475 6174 696f ll. situatio │ │ │ │ │ -0000c630: 6e73 2028 2a6e 6f74 6520 456e 7669 726f ns (*note Enviro │ │ │ │ │ -0000c640: 6e6d 656e 7420 626c 6f63 6b3a 3a29 2e0a nment block::).. │ │ │ │ │ -0000c650: 0a20 2020 2020 5468 6520 6465 6661 756c . The defaul │ │ │ │ │ -0000c660: 7420 6973 2027 3027 2e0a 0a27 4752 5542 t is '0'...'GRUB │ │ │ │ │ -0000c670: 5f53 4156 4544 4546 4155 4c54 270a 2020 _SAVEDEFAULT'. │ │ │ │ │ -0000c680: 2020 2049 6620 7468 6973 206f 7074 696f If this optio │ │ │ │ │ -0000c690: 6e20 6973 2073 6574 2074 6f20 2774 7275 n is set to 'tru │ │ │ │ │ -0000c6a0: 6527 2c20 7468 656e 2c20 7768 656e 2061 e', then, when a │ │ │ │ │ -0000c6b0: 6e20 656e 7472 7920 6973 2073 656c 6563 n entry is selec │ │ │ │ │ -0000c6c0: 7465 642c 0a20 2020 2020 7361 7665 2069 ted,. save i │ │ │ │ │ -0000c6d0: 7420 6173 2061 206e 6577 2064 6566 6175 t as a new defau │ │ │ │ │ -0000c6e0: 6c74 2065 6e74 7279 2066 6f72 2075 7365 lt entry for use │ │ │ │ │ -0000c6f0: 2062 7920 6675 7475 7265 2072 756e 7320 by future runs │ │ │ │ │ -0000c700: 6f66 2047 5255 422e 2054 6869 730a 2020 of GRUB. This. │ │ │ │ │ -0000c710: 2020 2069 7320 6f6e 6c79 2075 7365 6675 is only usefu │ │ │ │ │ -0000c720: 6c20 6966 2027 4752 5542 5f44 4546 4155 l if 'GRUB_DEFAU │ │ │ │ │ -0000c730: 4c54 3d73 6176 6564 273b 2069 7420 6973 LT=saved'; it is │ │ │ │ │ -0000c740: 2061 2073 6570 6172 6174 6520 6f70 7469 a separate opti │ │ │ │ │ -0000c750: 6f6e 0a20 2020 2020 6265 6361 7573 6520 on. because │ │ │ │ │ -0000c760: 2747 5255 425f 4445 4641 554c 543d 7361 'GRUB_DEFAULT=sa │ │ │ │ │ -0000c770: 7665 6427 2069 7320 7573 6566 756c 2077 ved' is useful w │ │ │ │ │ -0000c780: 6974 686f 7574 2074 6869 7320 6f70 7469 ithout this opti │ │ │ │ │ -0000c790: 6f6e 2c20 696e 0a20 2020 2020 636f 6e6a on, in. conj │ │ │ │ │ -0000c7a0: 756e 6374 696f 6e20 7769 7468 2027 6772 unction with 'gr │ │ │ │ │ -0000c7b0: 7562 2d73 6574 2d64 6566 6175 6c74 272e ub-set-default'. │ │ │ │ │ -0000c7c0: 2020 556e 7365 7420 6279 2064 6566 6175 Unset by defau │ │ │ │ │ -0000c7d0: 6c74 2e20 2054 6869 730a 2020 2020 206f lt. This. o │ │ │ │ │ -0000c7e0: 7074 696f 6e20 7265 6c69 6573 206f 6e20 ption relies on │ │ │ │ │ -0000c7f0: 7468 6520 656e 7669 726f 6e6d 656e 7420 the environment │ │ │ │ │ -0000c800: 626c 6f63 6b2c 2077 6869 6368 206d 6179 block, which may │ │ │ │ │ -0000c810: 206e 6f74 2062 6520 6176 6169 6c61 626c not be availabl │ │ │ │ │ -0000c820: 650a 2020 2020 2069 6e20 616c 6c20 7369 e. in all si │ │ │ │ │ -0000c830: 7475 6174 696f 6e73 2028 2a6e 6f74 6520 tuations (*note │ │ │ │ │ -0000c840: 456e 7669 726f 6e6d 656e 7420 626c 6f63 Environment bloc │ │ │ │ │ -0000c850: 6b3a 3a29 2e0a 0a27 4752 5542 5f54 494d k::)...'GRUB_TIM │ │ │ │ │ -0000c860: 454f 5554 270a 2020 2020 2042 6f6f 7420 EOUT'. Boot │ │ │ │ │ -0000c870: 7468 6520 6465 6661 756c 7420 656e 7472 the default entr │ │ │ │ │ -0000c880: 7920 7468 6973 206d 616e 7920 7365 636f y this many seco │ │ │ │ │ -0000c890: 6e64 7320 6166 7465 7220 7468 6520 6d65 nds after the me │ │ │ │ │ -0000c8a0: 6e75 2069 730a 2020 2020 2064 6973 706c nu is. displ │ │ │ │ │ -0000c8b0: 6179 6564 2c20 756e 6c65 7373 2061 206b ayed, unless a k │ │ │ │ │ -0000c8c0: 6579 2069 7320 7072 6573 7365 642e 2020 ey is pressed. │ │ │ │ │ -0000c8d0: 5468 6520 6465 6661 756c 7420 6973 2027 The default is ' │ │ │ │ │ -0000c8e0: 3527 2e20 2053 6574 2074 6f0a 2020 2020 5'. Set to. │ │ │ │ │ -0000c8f0: 2027 3027 2074 6f20 626f 6f74 2069 6d6d '0' to boot imm │ │ │ │ │ -0000c900: 6564 6961 7465 6c79 2077 6974 686f 7574 ediately without │ │ │ │ │ -0000c910: 2064 6973 706c 6179 696e 6720 7468 6520 displaying the │ │ │ │ │ -0000c920: 6d65 6e75 2c20 6f72 2074 6f20 272d 3127 menu, or to '-1' │ │ │ │ │ -0000c930: 2074 6f0a 2020 2020 2077 6169 7420 696e to. wait in │ │ │ │ │ -0000c940: 6465 6669 6e69 7465 6c79 2e0a 0a20 2020 definitely... │ │ │ │ │ -0000c950: 2020 4966 2027 4752 5542 5f54 494d 454f If 'GRUB_TIMEO │ │ │ │ │ -0000c960: 5554 5f53 5459 4c45 2720 6973 2073 6574 UT_STYLE' is set │ │ │ │ │ -0000c970: 2074 6f20 2763 6f75 6e74 646f 776e 2720 to 'countdown' │ │ │ │ │ -0000c980: 6f72 2027 6869 6464 656e 272c 2074 6865 or 'hidden', the │ │ │ │ │ -0000c990: 0a20 2020 2020 7469 6d65 6f75 7420 6973 . timeout is │ │ │ │ │ -0000c9a0: 2069 6e73 7465 6164 2063 6f75 6e74 6564 instead counted │ │ │ │ │ -0000c9b0: 2062 6566 6f72 6520 7468 6520 6d65 6e75 before the menu │ │ │ │ │ -0000c9c0: 2069 7320 6469 7370 6c61 7965 642e 0a0a is displayed... │ │ │ │ │ -0000c9d0: 2747 5255 425f 5449 4d45 4f55 545f 5354 'GRUB_TIMEOUT_ST │ │ │ │ │ -0000c9e0: 594c 4527 0a20 2020 2020 4966 2074 6869 YLE'. If thi │ │ │ │ │ -0000c9f0: 7320 6f70 7469 6f6e 2069 7320 756e 7365 s option is unse │ │ │ │ │ -0000ca00: 7420 6f72 2073 6574 2074 6f20 276d 656e t or set to 'men │ │ │ │ │ -0000ca10: 7527 2c20 7468 656e 2047 5255 4220 7769 u', then GRUB wi │ │ │ │ │ -0000ca20: 6c6c 2064 6973 706c 6179 0a20 2020 2020 ll display. │ │ │ │ │ -0000ca30: 7468 6520 6d65 6e75 2061 6e64 2074 6865 the menu and the │ │ │ │ │ -0000ca40: 6e20 7761 6974 2066 6f72 2074 6865 2074 n wait for the t │ │ │ │ │ -0000ca50: 696d 656f 7574 2073 6574 2062 7920 2747 imeout set by 'G │ │ │ │ │ -0000ca60: 5255 425f 5449 4d45 4f55 5427 2074 6f0a RUB_TIMEOUT' to. │ │ │ │ │ -0000ca70: 2020 2020 2065 7870 6972 6520 6265 666f expire befo │ │ │ │ │ -0000ca80: 7265 2062 6f6f 7469 6e67 2074 6865 2064 re booting the d │ │ │ │ │ -0000ca90: 6566 6175 6c74 2065 6e74 7279 2e20 2050 efault entry. P │ │ │ │ │ -0000caa0: 7265 7373 696e 6720 6120 6b65 7920 696e ressing a key in │ │ │ │ │ -0000cab0: 7465 7272 7570 7473 0a20 2020 2020 7468 terrupts. th │ │ │ │ │ -0000cac0: 6520 7469 6d65 6f75 742e 0a0a 2020 2020 e timeout... │ │ │ │ │ -0000cad0: 2049 6620 7468 6973 206f 7074 696f 6e20 If this option │ │ │ │ │ -0000cae0: 6973 2073 6574 2074 6f20 2763 6f75 6e74 is set to 'count │ │ │ │ │ -0000caf0: 646f 776e 2720 6f72 2027 6869 6464 656e down' or 'hidden │ │ │ │ │ -0000cb00: 272c 2074 6865 6e2c 2062 6566 6f72 650a ', then, before. │ │ │ │ │ -0000cb10: 2020 2020 2064 6973 706c 6179 696e 6720 displaying │ │ │ │ │ -0000cb20: 7468 6520 6d65 6e75 2c20 4752 5542 2077 the menu, GRUB w │ │ │ │ │ -0000cb30: 696c 6c20 7761 6974 2066 6f72 2074 6865 ill wait for the │ │ │ │ │ -0000cb40: 2074 696d 656f 7574 2073 6574 2062 790a timeout set by. │ │ │ │ │ -0000cb50: 2020 2020 2027 4752 5542 5f54 494d 454f 'GRUB_TIMEO │ │ │ │ │ -0000cb60: 5554 2720 746f 2065 7870 6972 652e 2020 UT' to expire. │ │ │ │ │ -0000cb70: 4966 203c 4553 433e 206f 7220 3c46 343e If or │ │ │ │ │ -0000cb80: 2061 7265 2070 7265 7373 6564 2c20 6f72 are pressed, or │ │ │ │ │ -0000cb90: 203c 5348 4946 543e 0a20 2020 2020 6973 . is │ │ │ │ │ -0000cba0: 2068 656c 6420 646f 776e 2064 7572 696e held down durin │ │ │ │ │ -0000cbb0: 6720 7468 6174 2074 696d 652c 2069 7420 g that time, it │ │ │ │ │ -0000cbc0: 7769 6c6c 2064 6973 706c 6179 2074 6865 will display the │ │ │ │ │ -0000cbd0: 206d 656e 7520 616e 6420 7761 6974 0a20 menu and wait. │ │ │ │ │ -0000cbe0: 2020 2020 666f 7220 696e 7075 742e 2020 for input. │ │ │ │ │ -0000cbf0: 4966 2061 2068 6f74 6b65 7920 6173 736f If a hotkey asso │ │ │ │ │ -0000cc00: 6369 6174 6564 2077 6974 6820 6120 6d65 ciated with a me │ │ │ │ │ -0000cc10: 6e75 2065 6e74 7279 2069 7320 7072 6573 nu entry is pres │ │ │ │ │ -0000cc20: 7365 642c 2069 740a 2020 2020 2077 696c sed, it. wil │ │ │ │ │ -0000cc30: 6c20 626f 6f74 2074 6865 2061 7373 6f63 l boot the assoc │ │ │ │ │ -0000cc40: 6961 7465 6420 6d65 6e75 2065 6e74 7279 iated menu entry │ │ │ │ │ -0000cc50: 2069 6d6d 6564 6961 7465 6c79 2e20 2049 immediately. I │ │ │ │ │ -0000cc60: 6620 7468 6520 7469 6d65 6f75 740a 2020 f the timeout. │ │ │ │ │ -0000cc70: 2020 2065 7870 6972 6573 2062 6566 6f72 expires befor │ │ │ │ │ -0000cc80: 6520 6569 7468 6572 206f 6620 7468 6573 e either of thes │ │ │ │ │ -0000cc90: 6520 6861 7070 656e 732c 2069 7420 7769 e happens, it wi │ │ │ │ │ -0000cca0: 6c6c 2062 6f6f 7420 7468 6520 6465 6661 ll boot the defa │ │ │ │ │ -0000ccb0: 756c 740a 2020 2020 2065 6e74 7279 2e20 ult. entry. │ │ │ │ │ -0000ccc0: 2049 6e20 7468 6520 2763 6f75 6e74 646f In the 'countdo │ │ │ │ │ -0000ccd0: 776e 2720 6361 7365 2c20 6974 2077 696c wn' case, it wil │ │ │ │ │ -0000cce0: 6c20 7368 6f77 2061 206f 6e65 2d6c 696e l show a one-lin │ │ │ │ │ -0000ccf0: 6520 696e 6469 6361 7469 6f6e 0a20 2020 e indication. │ │ │ │ │ -0000cd00: 2020 6f66 2074 6865 2072 656d 6169 6e69 of the remaini │ │ │ │ │ -0000cd10: 6e67 2074 696d 652e 0a0a 2747 5255 425f ng time...'GRUB_ │ │ │ │ │ -0000cd20: 4445 4641 554c 545f 4255 5454 4f4e 270a DEFAULT_BUTTON'. │ │ │ │ │ -0000cd30: 2747 5255 425f 5449 4d45 4f55 545f 4255 'GRUB_TIMEOUT_BU │ │ │ │ │ -0000cd40: 5454 4f4e 270a 2747 5255 425f 5449 4d45 TTON'.'GRUB_TIME │ │ │ │ │ -0000cd50: 4f55 545f 5354 594c 455f 4255 5454 4f4e OUT_STYLE_BUTTON │ │ │ │ │ -0000cd60: 270a 2747 5255 425f 4255 5454 4f4e 5f43 '.'GRUB_BUTTON_C │ │ │ │ │ -0000cd70: 4d4f 535f 4144 4452 4553 5327 0a20 2020 MOS_ADDRESS'. │ │ │ │ │ -0000cd80: 2020 5661 7269 616e 7473 206f 6620 7468 Variants of th │ │ │ │ │ -0000cd90: 6520 636f 7272 6573 706f 6e64 696e 6720 e corresponding │ │ │ │ │ -0000cda0: 7661 7269 6162 6c65 7320 7769 7468 6f75 variables withou │ │ │ │ │ -0000cdb0: 7420 7468 6520 275f 4255 5454 4f4e 270a t the '_BUTTON'. │ │ │ │ │ -0000cdc0: 2020 2020 2073 7566 6669 782c 2075 7365 suffix, use │ │ │ │ │ -0000cdd0: 6420 746f 2073 7570 706f 7274 2076 656e d to support ven │ │ │ │ │ -0000cde0: 646f 722d 7370 6563 6966 6963 2070 6f77 dor-specific pow │ │ │ │ │ -0000cdf0: 6572 2062 7574 746f 6e73 2e20 202a 4e6f er buttons. *No │ │ │ │ │ -0000ce00: 7465 0a20 2020 2020 5665 6e64 6f72 2070 te. Vendor p │ │ │ │ │ -0000ce10: 6f77 6572 2d6f 6e20 6b65 7973 3a3a 2e0a ower-on keys::.. │ │ │ │ │ -0000ce20: 0a27 4752 5542 5f44 4953 5452 4942 5554 .'GRUB_DISTRIBUT │ │ │ │ │ -0000ce30: 4f52 270a 2020 2020 2053 6574 2062 7920 OR'. Set by │ │ │ │ │ -0000ce40: 6469 7374 7269 6275 746f 7273 206f 6620 distributors of │ │ │ │ │ -0000ce50: 4752 5542 2074 6f20 7468 6569 7220 6964 GRUB to their id │ │ │ │ │ -0000ce60: 656e 7469 6679 696e 6720 6e61 6d65 2e20 entifying name. │ │ │ │ │ -0000ce70: 2054 6869 7320 6973 0a20 2020 2020 7573 This is. us │ │ │ │ │ -0000ce80: 6564 2074 6f20 6765 6e65 7261 7465 206d ed to generate m │ │ │ │ │ -0000ce90: 6f72 6520 696e 666f 726d 6174 6976 6520 ore informative │ │ │ │ │ -0000cea0: 6d65 6e75 2065 6e74 7279 2074 6974 6c65 menu entry title │ │ │ │ │ -0000ceb0: 732e 0a0a 2747 5255 425f 5445 524d 494e s...'GRUB_TERMIN │ │ │ │ │ -0000cec0: 414c 5f49 4e50 5554 270a 2020 2020 2053 AL_INPUT'. S │ │ │ │ │ -0000ced0: 656c 6563 7420 7468 6520 7465 726d 696e elect the termin │ │ │ │ │ -0000cee0: 616c 2069 6e70 7574 2064 6576 6963 652e al input device. │ │ │ │ │ -0000cef0: 2020 596f 7520 6d61 7920 7365 6c65 6374 You may select │ │ │ │ │ -0000cf00: 206d 756c 7469 706c 6520 6465 7669 6365 multiple device │ │ │ │ │ -0000cf10: 730a 2020 2020 2068 6572 652c 2073 6570 s. here, sep │ │ │ │ │ -0000cf20: 6172 6174 6564 2062 7920 7370 6163 6573 arated by spaces │ │ │ │ │ -0000cf30: 2e0a 0a20 2020 2020 5661 6c69 6420 7465 ... Valid te │ │ │ │ │ -0000cf40: 726d 696e 616c 2069 6e70 7574 206e 616d rminal input nam │ │ │ │ │ -0000cf50: 6573 2064 6570 656e 6420 6f6e 2074 6865 es depend on the │ │ │ │ │ -0000cf60: 2070 6c61 7466 6f72 6d2c 2062 7574 206d platform, but m │ │ │ │ │ -0000cf70: 6179 2069 6e63 6c75 6465 0a20 2020 2020 ay include. │ │ │ │ │ -0000cf80: 2763 6f6e 736f 6c65 2720 286e 6174 6976 'console' (nativ │ │ │ │ │ -0000cf90: 6520 706c 6174 666f 726d 2063 6f6e 736f e platform conso │ │ │ │ │ -0000cfa0: 6c65 292c 2027 7365 7269 616c 2720 2873 le), 'serial' (s │ │ │ │ │ -0000cfb0: 6572 6961 6c20 7465 726d 696e 616c 292c erial terminal), │ │ │ │ │ -0000cfc0: 0a20 2020 2020 2773 6572 6961 6c5f 3c70 . 'serial_

' (serial te │ │ │ │ │ -0000cfe0: 726d 696e 616c 2077 6974 6820 6578 706c rminal with expl │ │ │ │ │ -0000cff0: 6963 6974 2070 6f72 7420 7365 6c65 6374 icit port select │ │ │ │ │ -0000d000: 696f 6e29 2c0a 2020 2020 2027 6174 5f6b ion),. 'at_k │ │ │ │ │ -0000d010: 6579 626f 6172 6427 2028 5043 2041 5420 eyboard' (PC AT │ │ │ │ │ -0000d020: 6b65 7962 6f61 7264 292c 206f 7220 2775 keyboard), or 'u │ │ │ │ │ -0000d030: 7362 5f6b 6579 626f 6172 6427 2028 5553 sb_keyboard' (US │ │ │ │ │ -0000d040: 4220 6b65 7962 6f61 7264 0a20 2020 2020 B keyboard. │ │ │ │ │ -0000d050: 7573 696e 6720 7468 6520 4849 4420 426f using the HID Bo │ │ │ │ │ -0000d060: 6f74 2050 726f 746f 636f 6c2c 2066 6f72 ot Protocol, for │ │ │ │ │ -0000d070: 2063 6173 6573 2077 6865 7265 2074 6865 cases where the │ │ │ │ │ -0000d080: 2066 6972 6d77 6172 6520 646f 6573 206e firmware does n │ │ │ │ │ -0000d090: 6f74 0a20 2020 2020 6861 6e64 6c65 2074 ot. handle t │ │ │ │ │ -0000d0a0: 6869 7329 2e0a 0a20 2020 2020 5468 6520 his)... The │ │ │ │ │ -0000d0b0: 6465 6661 756c 7420 6973 2074 6f20 7573 default is to us │ │ │ │ │ -0000d0c0: 6520 7468 6520 706c 6174 666f 726d 2773 e the platform's │ │ │ │ │ -0000d0d0: 206e 6174 6976 6520 7465 726d 696e 616c native terminal │ │ │ │ │ -0000d0e0: 2069 6e70 7574 2e0a 0a27 4752 5542 5f54 input...'GRUB_T │ │ │ │ │ -0000d0f0: 4552 4d49 4e41 4c5f 4f55 5450 5554 270a ERMINAL_OUTPUT'. │ │ │ │ │ -0000d100: 2020 2020 2053 656c 6563 7420 7468 6520 Select the │ │ │ │ │ -0000d110: 7465 726d 696e 616c 206f 7574 7075 7420 terminal output │ │ │ │ │ -0000d120: 6465 7669 6365 2e20 2059 6f75 206d 6179 device. You may │ │ │ │ │ -0000d130: 2073 656c 6563 7420 6d75 6c74 6970 6c65 select multiple │ │ │ │ │ -0000d140: 2064 6576 6963 6573 0a20 2020 2020 6865 devices. he │ │ │ │ │ -0000d150: 7265 2c20 7365 7061 7261 7465 6420 6279 re, separated by │ │ │ │ │ -0000d160: 2073 7061 6365 732e 0a0a 2020 2020 2056 spaces... V │ │ │ │ │ -0000d170: 616c 6964 2074 6572 6d69 6e61 6c20 6f75 alid terminal ou │ │ │ │ │ -0000d180: 7470 7574 206e 616d 6573 2064 6570 656e tput names depen │ │ │ │ │ -0000d190: 6420 6f6e 2074 6865 2070 6c61 7466 6f72 d on the platfor │ │ │ │ │ -0000d1a0: 6d2c 2062 7574 206d 6179 2069 6e63 6c75 m, but may inclu │ │ │ │ │ -0000d1b0: 6465 0a20 2020 2020 2763 6f6e 736f 6c65 de. 'console │ │ │ │ │ -0000d1c0: 2720 286e 6174 6976 6520 706c 6174 666f ' (native platfo │ │ │ │ │ -0000d1d0: 726d 2063 6f6e 736f 6c65 292c 2027 7365 rm console), 'se │ │ │ │ │ -0000d1e0: 7269 616c 2720 2873 6572 6961 6c20 7465 rial' (serial te │ │ │ │ │ -0000d1f0: 726d 696e 616c 292c 0a20 2020 2020 2773 rminal),. 's │ │ │ │ │ -0000d200: 6572 6961 6c5f 3c70 6f72 743e 2720 2873 erial_' (s │ │ │ │ │ -0000d210: 6572 6961 6c20 7465 726d 696e 616c 2077 erial terminal w │ │ │ │ │ -0000d220: 6974 6820 6578 706c 6963 6974 2070 6f72 ith explicit por │ │ │ │ │ -0000d230: 7420 7365 6c65 6374 696f 6e29 2c0a 2020 t selection),. │ │ │ │ │ -0000d240: 2020 2027 6766 7874 6572 6d27 2028 6772 'gfxterm' (gr │ │ │ │ │ -0000d250: 6170 6869 6373 2d6d 6f64 6520 6f75 7470 aphics-mode outp │ │ │ │ │ -0000d260: 7574 292c 2027 7667 615f 7465 7874 2720 ut), 'vga_text' │ │ │ │ │ -0000d270: 2856 4741 2074 6578 7420 6f75 7470 7574 (VGA text output │ │ │ │ │ -0000d280: 292c 0a20 2020 2020 276d 6461 5f74 6578 ),. 'mda_tex │ │ │ │ │ -0000d290: 7427 2028 4d44 4120 7465 7874 206f 7574 t' (MDA text out │ │ │ │ │ -0000d2a0: 7075 7429 2c20 276d 6f72 7365 2720 284d put), 'morse' (M │ │ │ │ │ -0000d2b0: 6f72 7365 2d63 6f64 696e 6720 7573 696e orse-coding usin │ │ │ │ │ -0000d2c0: 6720 7379 7374 656d 0a20 2020 2020 6265 g system. be │ │ │ │ │ -0000d2d0: 6570 6572 2920 6f72 2027 7370 6b6d 6f64 eper) or 'spkmod │ │ │ │ │ -0000d2e0: 656d 2720 2873 696d 706c 6520 6461 7461 em' (simple data │ │ │ │ │ -0000d2f0: 2070 726f 746f 636f 6c20 7573 696e 6720 protocol using │ │ │ │ │ -0000d300: 7379 7374 656d 2073 7065 616b 6572 292e system speaker). │ │ │ │ │ -0000d310: 0a0a 2020 2020 2027 7370 6b6d 6f64 656d .. 'spkmodem │ │ │ │ │ -0000d320: 2720 6973 2075 7365 6675 6c20 7768 656e ' is useful when │ │ │ │ │ -0000d330: 206e 6f20 7365 7269 616c 2070 6f72 7420 no serial port │ │ │ │ │ -0000d340: 6973 2061 7661 696c 6162 6c65 2e20 2043 is available. C │ │ │ │ │ -0000d350: 6f6e 6e65 6374 2074 6865 0a20 2020 2020 onnect the. │ │ │ │ │ -0000d360: 6f75 7470 7574 206f 6620 7365 6e64 696e output of sendin │ │ │ │ │ -0000d370: 6720 7379 7374 656d 2028 7768 6572 6520 g system (where │ │ │ │ │ -0000d380: 4752 5542 2069 7320 7275 6e6e 696e 6729 GRUB is running) │ │ │ │ │ -0000d390: 2074 6f20 6c69 6e65 2d69 6e20 6f66 0a20 to line-in of. │ │ │ │ │ -0000d3a0: 2020 2020 7265 6365 6976 696e 6720 7379 receiving sy │ │ │ │ │ -0000d3b0: 7374 656d 2028 7573 7561 6c6c 7920 6465 stem (usually de │ │ │ │ │ -0000d3c0: 7665 6c6f 7065 7220 6d61 6368 696e 6529 veloper machine) │ │ │ │ │ -0000d3d0: 2e20 204f 6e20 7265 6365 6976 696e 6720 . On receiving │ │ │ │ │ -0000d3e0: 7379 7374 656d 0a20 2020 2020 636f 6d70 system. comp │ │ │ │ │ -0000d3f0: 696c 6520 2773 706b 6d6f 6465 6d2d 7265 ile 'spkmodem-re │ │ │ │ │ -0000d400: 6376 2720 6672 6f6d 2027 7574 696c 2f73 cv' from 'util/s │ │ │ │ │ -0000d410: 706b 6d6f 6465 6d2d 7265 6376 2e63 2720 pkmodem-recv.c' │ │ │ │ │ -0000d420: 616e 6420 7275 6e3a 0a0a 2020 2020 2020 and run:.. │ │ │ │ │ -0000d430: 2020 2020 7061 7265 636f 7264 202d 2d63 parecord --c │ │ │ │ │ -0000d440: 6861 6e6e 656c 733d 3120 2d2d 7261 7465 hannels=1 --rate │ │ │ │ │ -0000d450: 3d34 3830 3030 202d 2d66 6f72 6d61 743d =48000 --format= │ │ │ │ │ -0000d460: 7331 366c 6520 7c20 2e2f 7370 6b6d 6f64 s16le | ./spkmod │ │ │ │ │ -0000d470: 656d 2d72 6563 760a 0a20 2020 2020 5468 em-recv.. Th │ │ │ │ │ -0000d480: 6520 6465 6661 756c 7420 6973 2074 6f20 e default is to │ │ │ │ │ -0000d490: 7573 6520 7468 6520 706c 6174 666f 726d use the platform │ │ │ │ │ -0000d4a0: 2773 206e 6174 6976 6520 7465 726d 696e 's native termin │ │ │ │ │ -0000d4b0: 616c 206f 7574 7075 742e 0a0a 2747 5255 al output...'GRU │ │ │ │ │ -0000d4c0: 425f 5445 524d 494e 414c 270a 2020 2020 B_TERMINAL'. │ │ │ │ │ -0000d4d0: 2049 6620 7468 6973 206f 7074 696f 6e20 If this option │ │ │ │ │ -0000d4e0: 6973 2073 6574 2c20 6974 206f 7665 7272 is set, it overr │ │ │ │ │ -0000d4f0: 6964 6573 2062 6f74 6820 2747 5255 425f ides both 'GRUB_ │ │ │ │ │ -0000d500: 5445 524d 494e 414c 5f49 4e50 5554 2720 TERMINAL_INPUT' │ │ │ │ │ -0000d510: 616e 640a 2020 2020 2027 4752 5542 5f54 and. 'GRUB_T │ │ │ │ │ -0000d520: 4552 4d49 4e41 4c5f 4f55 5450 5554 2720 ERMINAL_OUTPUT' │ │ │ │ │ -0000d530: 746f 2074 6865 2073 616d 6520 7661 6c75 to the same valu │ │ │ │ │ -0000d540: 652e 0a0a 2747 5255 425f 5345 5249 414c e...'GRUB_SERIAL │ │ │ │ │ -0000d550: 5f43 4f4d 4d41 4e44 270a 2020 2020 2041 _COMMAND'. A │ │ │ │ │ -0000d560: 2063 6f6d 6d61 6e64 2074 6f20 636f 6e66 command to conf │ │ │ │ │ -0000d570: 6967 7572 6520 7468 6520 7365 7269 616c igure the serial │ │ │ │ │ -0000d580: 2070 6f72 7420 7768 656e 2075 7369 6e67 port when using │ │ │ │ │ -0000d590: 2074 6865 2073 6572 6961 6c0a 2020 2020 the serial. │ │ │ │ │ -0000d5a0: 2063 6f6e 736f 6c65 2e20 202a 4e6f 7465 console. *Note │ │ │ │ │ -0000d5b0: 2073 6572 6961 6c3a 3a2e 2020 4465 6661 serial::. Defa │ │ │ │ │ -0000d5c0: 756c 7473 2074 6f20 2773 6572 6961 6c27 ults to 'serial' │ │ │ │ │ -0000d5d0: 2e0a 0a27 4752 5542 5f43 4d44 4c49 4e45 ...'GRUB_CMDLINE │ │ │ │ │ -0000d5e0: 5f4c 494e 5558 270a 2020 2020 2043 6f6d _LINUX'. Com │ │ │ │ │ -0000d5f0: 6d61 6e64 2d6c 696e 6520 6172 6775 6d65 mand-line argume │ │ │ │ │ -0000d600: 6e74 7320 746f 2061 6464 2074 6f20 6d65 nts to add to me │ │ │ │ │ -0000d610: 6e75 2065 6e74 7269 6573 2066 6f72 2074 nu entries for t │ │ │ │ │ -0000d620: 6865 204c 696e 7578 206b 6572 6e65 6c2e he Linux kernel. │ │ │ │ │ -0000d630: 0a0a 2747 5255 425f 434d 444c 494e 455f ..'GRUB_CMDLINE_ │ │ │ │ │ -0000d640: 4c49 4e55 585f 4445 4641 554c 5427 0a20 LINUX_DEFAULT'. │ │ │ │ │ -0000d650: 2020 2020 556e 6c65 7373 2027 4752 5542 Unless 'GRUB │ │ │ │ │ -0000d660: 5f44 4953 4142 4c45 5f52 4543 4f56 4552 _DISABLE_RECOVER │ │ │ │ │ -0000d670: 5927 2069 7320 7365 7420 746f 2027 7472 Y' is set to 'tr │ │ │ │ │ -0000d680: 7565 272c 2074 776f 206d 656e 7520 656e ue', two menu en │ │ │ │ │ -0000d690: 7472 6965 730a 2020 2020 2077 696c 6c20 tries. will │ │ │ │ │ -0000d6a0: 6265 2067 656e 6572 6174 6564 2066 6f72 be generated for │ │ │ │ │ -0000d6b0: 2065 6163 6820 4c69 6e75 7820 6b65 726e each Linux kern │ │ │ │ │ -0000d6c0: 656c 3a20 6f6e 6520 6465 6661 756c 7420 el: one default │ │ │ │ │ -0000d6d0: 656e 7472 7920 616e 6420 6f6e 650a 2020 entry and one. │ │ │ │ │ -0000d6e0: 2020 2065 6e74 7279 2066 6f72 2072 6563 entry for rec │ │ │ │ │ -0000d6f0: 6f76 6572 7920 6d6f 6465 2e20 2054 6869 overy mode. Thi │ │ │ │ │ -0000d700: 7320 6f70 7469 6f6e 206c 6973 7473 2063 s option lists c │ │ │ │ │ -0000d710: 6f6d 6d61 6e64 2d6c 696e 6520 6172 6775 ommand-line argu │ │ │ │ │ -0000d720: 6d65 6e74 730a 2020 2020 2074 6f20 6164 ments. to ad │ │ │ │ │ -0000d730: 6420 6f6e 6c79 2074 6f20 7468 6520 6465 d only to the de │ │ │ │ │ -0000d740: 6661 756c 7420 6d65 6e75 2065 6e74 7279 fault menu entry │ │ │ │ │ -0000d750: 2c20 6166 7465 7220 7468 6f73 6520 6c69 , after those li │ │ │ │ │ -0000d760: 7374 6564 2069 6e0a 2020 2020 2027 4752 sted in. 'GR │ │ │ │ │ -0000d770: 5542 5f43 4d44 4c49 4e45 5f4c 494e 5558 UB_CMDLINE_LINUX │ │ │ │ │ -0000d780: 272e 0a0a 2747 5255 425f 434d 444c 494e '...'GRUB_CMDLIN │ │ │ │ │ -0000d790: 455f 4e45 5442 5344 270a 2747 5255 425f E_NETBSD'.'GRUB_ │ │ │ │ │ -0000d7a0: 434d 444c 494e 455f 4e45 5442 5344 5f44 CMDLINE_NETBSD_D │ │ │ │ │ -0000d7b0: 4546 4155 4c54 270a 2020 2020 2041 7320 EFAULT'. As │ │ │ │ │ -0000d7c0: 2747 5255 425f 434d 444c 494e 455f 4c49 'GRUB_CMDLINE_LI │ │ │ │ │ -0000d7d0: 4e55 5827 2061 6e64 2027 4752 5542 5f43 NUX' and 'GRUB_C │ │ │ │ │ -0000d7e0: 4d44 4c49 4e45 5f4c 494e 5558 5f44 4546 MDLINE_LINUX_DEF │ │ │ │ │ -0000d7f0: 4155 4c54 272c 2062 7574 2066 6f72 0a20 AULT', but for. │ │ │ │ │ -0000d800: 2020 2020 4e65 7442 5344 2e0a 0a27 4752 NetBSD...'GR │ │ │ │ │ -0000d810: 5542 5f43 4d44 4c49 4e45 5f47 4e55 4d41 UB_CMDLINE_GNUMA │ │ │ │ │ -0000d820: 4348 270a 2020 2020 2041 7320 2747 5255 CH'. As 'GRU │ │ │ │ │ -0000d830: 425f 434d 444c 494e 455f 4c49 4e55 5827 B_CMDLINE_LINUX' │ │ │ │ │ -0000d840: 2c20 6275 7420 666f 7220 474e 5520 4d61 , but for GNU Ma │ │ │ │ │ -0000d850: 6368 2e0a 0a27 4752 5542 5f43 4d44 4c49 ch...'GRUB_CMDLI │ │ │ │ │ -0000d860: 4e45 5f58 454e 270a 2747 5255 425f 434d NE_XEN'.'GRUB_CM │ │ │ │ │ -0000d870: 444c 494e 455f 5845 4e5f 4445 4641 554c DLINE_XEN_DEFAUL │ │ │ │ │ -0000d880: 5427 0a20 2020 2020 5468 6520 7661 6c75 T'. The valu │ │ │ │ │ -0000d890: 6573 206f 6620 7468 6573 6520 6f70 7469 es of these opti │ │ │ │ │ -0000d8a0: 6f6e 7320 6172 6520 7061 7373 6564 2074 ons are passed t │ │ │ │ │ -0000d8b0: 6f20 5865 6e20 6879 7065 7276 6973 6f72 o Xen hypervisor │ │ │ │ │ -0000d8c0: 2058 656e 206d 656e 750a 2020 2020 2065 Xen menu. e │ │ │ │ │ -0000d8d0: 6e74 7269 6573 2c20 666f 7220 616c 6c20 ntries, for all │ │ │ │ │ -0000d8e0: 7265 7370 6563 7469 7665 6c79 206e 6f72 respectively nor │ │ │ │ │ -0000d8f0: 6d61 6c20 656e 7472 6965 732e 0a0a 2747 mal entries...'G │ │ │ │ │ -0000d900: 5255 425f 434d 444c 494e 455f 4c49 4e55 RUB_CMDLINE_LINU │ │ │ │ │ -0000d910: 585f 5845 4e5f 5245 504c 4143 4527 0a27 X_XEN_REPLACE'.' │ │ │ │ │ -0000d920: 4752 5542 5f43 4d44 4c49 4e45 5f4c 494e GRUB_CMDLINE_LIN │ │ │ │ │ -0000d930: 5558 5f58 454e 5f52 4550 4c41 4345 5f44 UX_XEN_REPLACE_D │ │ │ │ │ -0000d940: 4546 4155 4c54 270a 2020 2020 2054 6865 EFAULT'. The │ │ │ │ │ -0000d950: 2076 616c 7565 7320 6f66 2074 6865 7365 values of these │ │ │ │ │ -0000d960: 206f 7074 696f 6e73 2072 6570 6c61 6365 options replace │ │ │ │ │ -0000d970: 2074 6865 2076 616c 7565 7320 6f66 0a20 the values of. │ │ │ │ │ -0000d980: 2020 2020 2747 5255 425f 434d 444c 494e 'GRUB_CMDLIN │ │ │ │ │ -0000d990: 455f 4c49 4e55 5827 2061 6e64 2027 4752 E_LINUX' and 'GR │ │ │ │ │ -0000d9a0: 5542 5f43 4d44 4c49 4e45 5f4c 494e 5558 UB_CMDLINE_LINUX │ │ │ │ │ -0000d9b0: 5f44 4546 4155 4c54 2720 666f 7220 4c69 _DEFAULT' for Li │ │ │ │ │ -0000d9c0: 6e75 7820 616e 640a 2020 2020 2058 656e nux and. Xen │ │ │ │ │ -0000d9d0: 206d 656e 7520 656e 7472 6965 732e 0a0a menu entries... │ │ │ │ │ -0000d9e0: 2747 5255 425f 4541 524c 595f 494e 4954 'GRUB_EARLY_INIT │ │ │ │ │ -0000d9f0: 5244 5f4c 494e 5558 5f43 5553 544f 4d27 RD_LINUX_CUSTOM' │ │ │ │ │ -0000da00: 0a27 4752 5542 5f45 4152 4c59 5f49 4e49 .'GRUB_EARLY_INI │ │ │ │ │ -0000da10: 5452 445f 4c49 4e55 585f 5354 4f43 4b27 TRD_LINUX_STOCK' │ │ │ │ │ -0000da20: 0a20 2020 2020 4c69 7374 206f 6620 7370 . List of sp │ │ │ │ │ -0000da30: 6163 652d 7365 7061 7261 7465 6420 6561 ace-separated ea │ │ │ │ │ -0000da40: 726c 7920 696e 6974 7264 2069 6d61 6765 rly initrd image │ │ │ │ │ -0000da50: 7320 746f 2062 6520 6c6f 6164 6564 2066 s to be loaded f │ │ │ │ │ -0000da60: 726f 6d0a 2020 2020 2027 2f62 6f6f 7427 rom. '/boot' │ │ │ │ │ -0000da70: 2e20 2054 6869 7320 6973 2066 6f72 206c . This is for l │ │ │ │ │ -0000da80: 6f61 6469 6e67 2074 6869 6e67 7320 6c69 oading things li │ │ │ │ │ -0000da90: 6b65 2043 5055 206d 6963 726f 636f 6465 ke CPU microcode │ │ │ │ │ -0000daa0: 2c20 6669 726d 7761 7265 2c0a 2020 2020 , firmware,. │ │ │ │ │ -0000dab0: 2041 4350 4920 7461 626c 6573 2c20 6372 ACPI tables, cr │ │ │ │ │ -0000dac0: 7970 746f 206b 6579 732c 2061 6e64 2073 ypto keys, and s │ │ │ │ │ -0000dad0: 6f20 6f6e 2e20 2054 6865 7365 2065 6172 o on. These ear │ │ │ │ │ -0000dae0: 6c79 2069 6d61 6765 7320 7769 6c6c 2062 ly images will b │ │ │ │ │ -0000daf0: 650a 2020 2020 206c 6f61 6465 6420 696e e. loaded in │ │ │ │ │ -0000db00: 2074 6865 206f 7264 6572 2064 6563 6c61 the order decla │ │ │ │ │ -0000db10: 7265 642c 2061 6e64 2061 6c6c 2077 696c red, and all wil │ │ │ │ │ -0000db20: 6c20 6265 206c 6f61 6465 6420 6265 666f l be loaded befo │ │ │ │ │ -0000db30: 7265 2074 6865 0a20 2020 2020 6163 7475 re the. actu │ │ │ │ │ -0000db40: 616c 2066 756e 6374 696f 6e61 6c20 696e al functional in │ │ │ │ │ -0000db50: 6974 7264 2069 6d61 6765 2e0a 0a20 2020 itrd image... │ │ │ │ │ -0000db60: 2020 2747 5255 425f 4541 524c 595f 494e 'GRUB_EARLY_IN │ │ │ │ │ -0000db70: 4954 5244 5f4c 494e 5558 5f53 544f 434b ITRD_LINUX_STOCK │ │ │ │ │ -0000db80: 2720 6973 2066 6f72 2079 6f75 7220 6469 ' is for your di │ │ │ │ │ -0000db90: 7374 7269 6275 7469 6f6e 2074 6f20 6465 stribution to de │ │ │ │ │ -0000dba0: 636c 6172 650a 2020 2020 2069 6d61 6765 clare. image │ │ │ │ │ -0000dbb0: 7320 7468 6174 2061 7265 2070 726f 7669 s that are provi │ │ │ │ │ -0000dbc0: 6465 6420 6279 2074 6865 2064 6973 7472 ded by the distr │ │ │ │ │ -0000dbd0: 6962 7574 696f 6e2e 2020 4974 2073 686f ibution. It sho │ │ │ │ │ -0000dbe0: 756c 6420 6e6f 7420 6265 0a20 2020 2020 uld not be. │ │ │ │ │ -0000dbf0: 6d6f 6469 6669 6564 2077 6974 686f 7574 modified without │ │ │ │ │ -0000dc00: 2075 6e64 6572 7374 616e 6469 6e67 2074 understanding t │ │ │ │ │ -0000dc10: 6865 2063 6f6e 7365 7175 656e 6365 732e he consequences. │ │ │ │ │ -0000dc20: 2020 5468 6579 2077 696c 6c20 6265 0a20 They will be. │ │ │ │ │ -0000dc30: 2020 2020 6c6f 6164 6564 2066 6972 7374 loaded first │ │ │ │ │ -0000dc40: 2e0a 0a20 2020 2020 2747 5255 425f 4541 ... 'GRUB_EA │ │ │ │ │ -0000dc50: 524c 595f 494e 4954 5244 5f4c 494e 5558 RLY_INITRD_LINUX │ │ │ │ │ -0000dc60: 5f43 5553 544f 4d27 2069 7320 666f 7220 _CUSTOM' is for │ │ │ │ │ -0000dc70: 796f 7572 2063 7573 746f 6d20 6372 6561 your custom crea │ │ │ │ │ -0000dc80: 7465 6420 696d 6167 6573 2e0a 0a20 2020 ted images... │ │ │ │ │ -0000dc90: 2020 5468 6520 6465 6661 756c 7420 7374 The default st │ │ │ │ │ -0000dca0: 6f63 6b20 696d 6167 6573 2061 7265 2061 ock images are a │ │ │ │ │ -0000dcb0: 7320 666f 6c6c 6f77 732c 2074 686f 7567 s follows, thoug │ │ │ │ │ -0000dcc0: 6820 7468 6579 206d 6179 2062 650a 2020 h they may be. │ │ │ │ │ -0000dcd0: 2020 206f 7665 7272 6964 6465 6e20 6279 overridden by │ │ │ │ │ -0000dce0: 2079 6f75 7220 6469 7374 7269 6275 7469 your distributi │ │ │ │ │ -0000dcf0: 6f6e 3a0a 2020 2020 2020 2020 2020 696e on:. in │ │ │ │ │ -0000dd00: 7465 6c2d 7563 2e69 6d67 2069 6e74 656c tel-uc.img intel │ │ │ │ │ -0000dd10: 2d75 636f 6465 2e69 6d67 2061 6d64 2d75 -ucode.img amd-u │ │ │ │ │ -0000dd20: 632e 696d 6720 616d 642d 7563 6f64 652e c.img amd-ucode. │ │ │ │ │ -0000dd30: 696d 6720 6561 726c 795f 7563 6f64 652e img early_ucode. │ │ │ │ │ -0000dd40: 6370 696f 206d 6963 726f 636f 6465 2e63 cpio microcode.c │ │ │ │ │ -0000dd50: 7069 6f0a 0a27 4752 5542 5f44 4953 4142 pio..'GRUB_DISAB │ │ │ │ │ -0000dd60: 4c45 5f4c 494e 5558 5f55 5549 4427 0a20 LE_LINUX_UUID'. │ │ │ │ │ -0000dd70: 2020 2020 4e6f 726d 616c 6c79 2c20 2767 Normally, 'g │ │ │ │ │ -0000dd80: 7275 622d 6d6b 636f 6e66 6967 2720 7769 rub-mkconfig' wi │ │ │ │ │ -0000dd90: 6c6c 2067 656e 6572 6174 6520 6d65 6e75 ll generate menu │ │ │ │ │ -0000dda0: 2065 6e74 7269 6573 2074 6861 7420 7573 entries that us │ │ │ │ │ -0000ddb0: 650a 2020 2020 2075 6e69 7665 7273 616c e. universal │ │ │ │ │ -0000ddc0: 6c79 2d75 6e69 7175 6520 6964 656e 7469 ly-unique identi │ │ │ │ │ -0000ddd0: 6669 6572 7320 2855 5549 4473 2920 746f fiers (UUIDs) to │ │ │ │ │ -0000dde0: 2069 6465 6e74 6966 7920 7468 6520 726f identify the ro │ │ │ │ │ -0000ddf0: 6f74 0a20 2020 2020 6669 6c65 7379 7374 ot. filesyst │ │ │ │ │ -0000de00: 656d 2074 6f20 7468 6520 4c69 6e75 7820 em to the Linux │ │ │ │ │ -0000de10: 6b65 726e 656c 2c20 7573 696e 6720 6120 kernel, using a │ │ │ │ │ -0000de20: 2772 6f6f 743d 5555 4944 3d2e 2e2e 2720 'root=UUID=...' │ │ │ │ │ -0000de30: 6b65 726e 656c 0a20 2020 2020 7061 7261 kernel. para │ │ │ │ │ -0000de40: 6d65 7465 722e 2020 5468 6973 2069 7320 meter. This is │ │ │ │ │ -0000de50: 7573 7561 6c6c 7920 6d6f 7265 2072 656c usually more rel │ │ │ │ │ -0000de60: 6961 626c 652c 2062 7574 2069 6e20 736f iable, but in so │ │ │ │ │ -0000de70: 6d65 2063 6173 6573 2069 7420 6d61 790a me cases it may. │ │ │ │ │ -0000de80: 2020 2020 206e 6f74 2062 6520 6170 7072 not be appr │ │ │ │ │ -0000de90: 6f70 7269 6174 652e 2020 546f 2064 6973 opriate. To dis │ │ │ │ │ -0000dea0: 6162 6c65 2074 6865 2075 7365 206f 6620 able the use of │ │ │ │ │ -0000deb0: 5555 4944 732c 2073 6574 2074 6869 7320 UUIDs, set this │ │ │ │ │ -0000dec0: 6f70 7469 6f6e 0a20 2020 2020 746f 2027 option. to ' │ │ │ │ │ -0000ded0: 7472 7565 272e 0a0a 2747 5255 425f 4449 true'...'GRUB_DI │ │ │ │ │ -0000dee0: 5341 424c 455f 4c49 4e55 585f 5041 5254 SABLE_LINUX_PART │ │ │ │ │ -0000def0: 5555 4944 270a 2020 2020 2049 6620 2767 UUID'. If 'g │ │ │ │ │ -0000df00: 7275 622d 6d6b 636f 6e66 6967 2720 6361 rub-mkconfig' ca │ │ │ │ │ -0000df10: 6e6e 6f74 2069 6465 6e74 6966 7920 7468 nnot identify th │ │ │ │ │ -0000df20: 6520 726f 6f74 2066 696c 6573 7973 7465 e root filesyste │ │ │ │ │ -0000df30: 6d20 7669 6120 6974 730a 2020 2020 2075 m via its. u │ │ │ │ │ -0000df40: 6e69 7665 7273 616c 6c79 2d75 6e69 7175 niversally-uniqu │ │ │ │ │ -0000df50: 6520 696e 6465 6e74 6966 6965 7220 2855 e indentifier (U │ │ │ │ │ -0000df60: 5549 4429 2c20 2767 7275 622d 6d6b 636f UID), 'grub-mkco │ │ │ │ │ -0000df70: 6e66 6967 2720 6361 6e20 7573 6520 7468 nfig' can use th │ │ │ │ │ -0000df80: 650a 2020 2020 2055 5549 4420 6f66 2074 e. UUID of t │ │ │ │ │ -0000df90: 6865 2070 6172 7469 7469 6f6e 2063 6f6e he partition con │ │ │ │ │ -0000dfa0: 7461 696e 696e 6720 7468 6520 6669 6c65 taining the file │ │ │ │ │ -0000dfb0: 7379 7374 656d 2074 6f20 6964 656e 7469 system to identi │ │ │ │ │ -0000dfc0: 6679 2074 6865 0a20 2020 2020 726f 6f74 fy the. root │ │ │ │ │ -0000dfd0: 2066 696c 6573 7973 7465 6d20 746f 2074 filesystem to t │ │ │ │ │ -0000dfe0: 6865 204c 696e 7578 206b 6572 6e65 6c20 he Linux kernel │ │ │ │ │ -0000dff0: 7669 6120 6120 2772 6f6f 743d 5041 5254 via a 'root=PART │ │ │ │ │ -0000e000: 5555 4944 3d2e 2e2e 270a 2020 2020 206b UUID=...'. k │ │ │ │ │ -0000e010: 6572 6e65 6c20 7061 7261 6d65 7465 722e ernel parameter. │ │ │ │ │ -0000e020: 2020 5468 6973 2069 7320 6e6f 7420 6173 This is not as │ │ │ │ │ -0000e030: 2072 656c 6961 626c 6520 6173 2075 7369 reliable as usi │ │ │ │ │ -0000e040: 6e67 2074 6865 2066 696c 6573 7973 7465 ng the filesyste │ │ │ │ │ -0000e050: 6d0a 2020 2020 2055 5549 442c 2062 7574 m. UUID, but │ │ │ │ │ -0000e060: 2069 7320 6d6f 7265 2072 656c 6961 626c is more reliabl │ │ │ │ │ -0000e070: 6520 7468 616e 2075 7369 6e67 2074 6865 e than using the │ │ │ │ │ -0000e080: 204c 696e 7578 2064 6576 6963 6520 6e61 Linux device na │ │ │ │ │ -0000e090: 6d65 732e 2020 5768 656e 0a20 2020 2020 mes. When. │ │ │ │ │ -0000e0a0: 2747 5255 425f 4449 5341 424c 455f 4c49 'GRUB_DISABLE_LI │ │ │ │ │ -0000e0b0: 4e55 585f 5041 5254 5555 4944 2720 6973 NUX_PARTUUID' is │ │ │ │ │ -0000e0c0: 2073 6574 2074 6f20 2766 616c 7365 272c set to 'false', │ │ │ │ │ -0000e0d0: 2074 6865 204c 696e 7578 206b 6572 6e65 the Linux kerne │ │ │ │ │ -0000e0e0: 6c0a 2020 2020 2076 6572 7369 6f6e 206d l. version m │ │ │ │ │ -0000e0f0: 7573 7420 6265 2032 2e36 2e33 3720 2833 ust be 2.6.37 (3 │ │ │ │ │ -0000e100: 2e31 3020 666f 7220 7379 7374 656d 7320 .10 for systems │ │ │ │ │ -0000e110: 7573 696e 6720 7468 6520 4d53 444f 5320 using the MSDOS │ │ │ │ │ -0000e120: 7061 7274 6974 696f 6e0a 2020 2020 2073 partition. s │ │ │ │ │ -0000e130: 6368 656d 6529 206f 7220 6e65 7765 722e cheme) or newer. │ │ │ │ │ -0000e140: 2020 5468 6973 206f 7074 696f 6e20 6465 This option de │ │ │ │ │ -0000e150: 6661 756c 7473 2074 6f20 2774 7275 6527 faults to 'true' │ │ │ │ │ -0000e160: 2e20 2054 6f20 656e 6162 6c65 2074 6865 . To enable the │ │ │ │ │ -0000e170: 0a20 2020 2020 7573 6520 6f66 2070 6172 . use of par │ │ │ │ │ -0000e180: 7469 7469 6f6e 2055 5549 4473 2c20 7365 tition UUIDs, se │ │ │ │ │ -0000e190: 7420 7468 6973 206f 7074 696f 6e20 746f t this option to │ │ │ │ │ -0000e1a0: 2027 6661 6c73 6527 2e0a 0a27 4752 5542 'false'...'GRUB │ │ │ │ │ -0000e1b0: 5f44 4953 4142 4c45 5f52 4543 4f56 4552 _DISABLE_RECOVER │ │ │ │ │ -0000e1c0: 5927 0a20 2020 2020 4966 2074 6869 7320 Y'. If this │ │ │ │ │ -0000e1d0: 6f70 7469 6f6e 2069 7320 7365 7420 746f option is set to │ │ │ │ │ -0000e1e0: 2027 7472 7565 272c 2064 6973 6162 6c65 'true', disable │ │ │ │ │ -0000e1f0: 2074 6865 2067 656e 6572 6174 696f 6e20 the generation │ │ │ │ │ -0000e200: 6f66 2072 6563 6f76 6572 790a 2020 2020 of recovery. │ │ │ │ │ -0000e210: 206d 6f64 6520 6d65 6e75 2065 6e74 7269 mode menu entri │ │ │ │ │ -0000e220: 6573 2e0a 0a27 4752 5542 5f44 4953 4142 es...'GRUB_DISAB │ │ │ │ │ -0000e230: 4c45 5f55 5549 4427 0a20 2020 2020 4e6f LE_UUID'. No │ │ │ │ │ -0000e240: 726d 616c 6c79 2c20 2767 7275 622d 6d6b rmally, 'grub-mk │ │ │ │ │ -0000e250: 636f 6e66 6967 2720 7769 6c6c 2067 656e config' will gen │ │ │ │ │ -0000e260: 6572 6174 6520 6d65 6e75 2065 6e74 7269 erate menu entri │ │ │ │ │ -0000e270: 6573 2074 6861 7420 7573 650a 2020 2020 es that use. │ │ │ │ │ -0000e280: 2075 6e69 7665 7273 616c 6c79 2d75 6e69 universally-uni │ │ │ │ │ -0000e290: 7175 6520 6964 656e 7469 6669 6572 7320 que identifiers │ │ │ │ │ -0000e2a0: 2855 5549 4473 2920 746f 2069 6465 6e74 (UUIDs) to ident │ │ │ │ │ -0000e2b0: 6966 7920 7661 7269 6f75 730a 2020 2020 ify various. │ │ │ │ │ -0000e2c0: 2066 696c 6573 7973 7465 6d73 2074 6f20 filesystems to │ │ │ │ │ -0000e2d0: 7365 6172 6368 2066 6f72 2066 696c 6573 search for files │ │ │ │ │ -0000e2e0: 2e20 2054 6869 7320 6973 2075 7375 616c . This is usual │ │ │ │ │ -0000e2f0: 6c79 206d 6f72 6520 7265 6c69 6162 6c65 ly more reliable │ │ │ │ │ -0000e300: 2c0a 2020 2020 2062 7574 2069 6e20 736f ,. but in so │ │ │ │ │ -0000e310: 6d65 2063 6173 6573 2069 7420 6d61 7920 me cases it may │ │ │ │ │ -0000e320: 6e6f 7420 6265 2061 7070 726f 7072 6961 not be appropria │ │ │ │ │ -0000e330: 7465 2e20 2054 6f20 6469 7361 626c 6520 te. To disable │ │ │ │ │ -0000e340: 7468 6973 2075 7365 0a20 2020 2020 6f66 this use. of │ │ │ │ │ -0000e350: 2055 5549 4473 2c20 7365 7420 7468 6973 UUIDs, set this │ │ │ │ │ -0000e360: 206f 7074 696f 6e20 746f 2027 7472 7565 option to 'true │ │ │ │ │ -0000e370: 272e 2020 5365 7474 696e 6720 7468 6973 '. Setting this │ │ │ │ │ -0000e380: 206f 7074 696f 6e20 746f 0a20 2020 2020 option to. │ │ │ │ │ -0000e390: 2774 7275 6527 2c20 7769 6c6c 2061 6c73 'true', will als │ │ │ │ │ -0000e3a0: 6f20 7365 7420 7468 6520 6f70 7469 6f6e o set the option │ │ │ │ │ -0000e3b0: 7320 2747 5255 425f 4449 5341 424c 455f s 'GRUB_DISABLE_ │ │ │ │ │ -0000e3c0: 4c49 4e55 585f 5555 4944 2720 616e 640a LINUX_UUID' and. │ │ │ │ │ -0000e3d0: 2020 2020 2027 4752 5542 5f44 4953 4142 'GRUB_DISAB │ │ │ │ │ -0000e3e0: 4c45 5f4c 494e 5558 5f50 4152 5455 5549 LE_LINUX_PARTUUI │ │ │ │ │ -0000e3f0: 4427 2074 6f20 2774 7275 6527 2c20 756e D' to 'true', un │ │ │ │ │ -0000e400: 6c65 7373 2074 6865 7920 6861 7665 2062 less they have b │ │ │ │ │ -0000e410: 6565 6e0a 2020 2020 2065 7870 6c69 6369 een. explici │ │ │ │ │ -0000e420: 6c74 7920 7365 7420 746f 2027 6661 6c73 lty set to 'fals │ │ │ │ │ -0000e430: 6527 2e0a 0a27 4752 5542 5f56 4944 454f e'...'GRUB_VIDEO │ │ │ │ │ -0000e440: 5f42 4143 4b45 4e44 270a 2020 2020 2049 _BACKEND'. I │ │ │ │ │ -0000e450: 6620 6772 6170 6869 6361 6c20 7669 6465 f graphical vide │ │ │ │ │ -0000e460: 6f20 7375 7070 6f72 7420 6973 2072 6571 o support is req │ │ │ │ │ -0000e470: 7569 7265 642c 2065 6974 6865 7220 6265 uired, either be │ │ │ │ │ -0000e480: 6361 7573 6520 7468 650a 2020 2020 2027 cause the. ' │ │ │ │ │ -0000e490: 6766 7874 6572 6d27 2067 7261 7068 6963 gfxterm' graphic │ │ │ │ │ -0000e4a0: 616c 2074 6572 6d69 6e61 6c20 6973 2069 al terminal is i │ │ │ │ │ -0000e4b0: 6e20 7573 6520 6f72 2062 6563 6175 7365 n use or because │ │ │ │ │ -0000e4c0: 0a20 2020 2020 2747 5255 425f 4746 5850 . 'GRUB_GFXP │ │ │ │ │ -0000e4d0: 4159 4c4f 4144 5f4c 494e 5558 2720 6973 AYLOAD_LINUX' is │ │ │ │ │ -0000e4e0: 2073 6574 2c20 7468 656e 2027 6772 7562 set, then 'grub │ │ │ │ │ -0000e4f0: 2d6d 6b63 6f6e 6669 6727 2077 696c 6c20 -mkconfig' will │ │ │ │ │ -0000e500: 6e6f 726d 616c 6c79 0a20 2020 2020 6c6f normally. lo │ │ │ │ │ -0000e510: 6164 2061 6c6c 2061 7661 696c 6162 6c65 ad all available │ │ │ │ │ -0000e520: 2047 5255 4220 7669 6465 6f20 6472 6976 GRUB video driv │ │ │ │ │ -0000e530: 6572 7320 616e 6420 7573 6520 7468 6520 ers and use the │ │ │ │ │ -0000e540: 6f6e 6520 6d6f 7374 0a20 2020 2020 6170 one most. ap │ │ │ │ │ -0000e550: 7072 6f70 7269 6174 6520 666f 7220 796f propriate for yo │ │ │ │ │ -0000e560: 7572 2068 6172 6477 6172 652e 2020 4966 ur hardware. If │ │ │ │ │ -0000e570: 2079 6f75 206e 6565 6420 746f 206f 7665 you need to ove │ │ │ │ │ -0000e580: 7272 6964 6520 7468 6973 2066 6f72 0a20 rride this for. │ │ │ │ │ -0000e590: 2020 2020 736f 6d65 2072 6561 736f 6e2c some reason, │ │ │ │ │ -0000e5a0: 2074 6865 6e20 796f 7520 6361 6e20 7365 then you can se │ │ │ │ │ -0000e5b0: 7420 7468 6973 206f 7074 696f 6e2e 0a0a t this option... │ │ │ │ │ -0000e5c0: 2020 2020 2041 6674 6572 2027 6772 7562 After 'grub │ │ │ │ │ -0000e5d0: 2d69 6e73 7461 6c6c 2720 6861 7320 6265 -install' has be │ │ │ │ │ -0000e5e0: 656e 2072 756e 2c20 7468 6520 6176 6169 en run, the avai │ │ │ │ │ -0000e5f0: 6c61 626c 6520 7669 6465 6f20 6472 6976 lable video driv │ │ │ │ │ -0000e600: 6572 7320 6172 650a 2020 2020 206c 6973 ers are. lis │ │ │ │ │ -0000e610: 7465 6420 696e 2027 2f62 6f6f 742f 6772 ted in '/boot/gr │ │ │ │ │ -0000e620: 7562 2f76 6964 656f 2e6c 7374 272e 0a0a ub/video.lst'... │ │ │ │ │ -0000e630: 2747 5255 425f 4746 584d 4f44 4527 0a20 'GRUB_GFXMODE'. │ │ │ │ │ -0000e640: 2020 2020 5365 7420 7468 6520 7265 736f Set the reso │ │ │ │ │ -0000e650: 6c75 7469 6f6e 2075 7365 6420 6f6e 2074 lution used on t │ │ │ │ │ -0000e660: 6865 2027 6766 7874 6572 6d27 2067 7261 he 'gfxterm' gra │ │ │ │ │ -0000e670: 7068 6963 616c 2074 6572 6d69 6e61 6c2e phical terminal. │ │ │ │ │ -0000e680: 2020 4e6f 7465 0a20 2020 2020 7468 6174 Note. that │ │ │ │ │ -0000e690: 2079 6f75 2063 616e 206f 6e6c 7920 7573 you can only us │ │ │ │ │ -0000e6a0: 6520 6d6f 6465 7320 7768 6963 6820 796f e modes which yo │ │ │ │ │ -0000e6b0: 7572 2067 7261 7068 6963 7320 6361 7264 ur graphics card │ │ │ │ │ -0000e6c0: 2073 7570 706f 7274 7320 7669 610a 2020 supports via. │ │ │ │ │ -0000e6d0: 2020 2056 4553 4120 4249 4f53 2045 7874 VESA BIOS Ext │ │ │ │ │ -0000e6e0: 656e 7369 6f6e 7320 2856 4245 292c 2073 ensions (VBE), s │ │ │ │ │ -0000e6f0: 6f20 666f 7220 6578 616d 706c 6520 6e61 o for example na │ │ │ │ │ -0000e700: 7469 7665 204c 4344 2070 616e 656c 0a20 tive LCD panel. │ │ │ │ │ -0000e710: 2020 2020 7265 736f 6c75 7469 6f6e 7320 resolutions │ │ │ │ │ -0000e720: 6d61 7920 6e6f 7420 6265 2061 7661 696c may not be avail │ │ │ │ │ -0000e730: 6162 6c65 2e20 2054 6865 2064 6566 6175 able. The defau │ │ │ │ │ -0000e740: 6c74 2069 7320 2761 7574 6f27 2c20 7768 lt is 'auto', wh │ │ │ │ │ -0000e750: 6963 680a 2020 2020 2074 7269 6573 2074 ich. tries t │ │ │ │ │ -0000e760: 6f20 7365 6c65 6374 2061 2070 7265 6665 o select a prefe │ │ │ │ │ -0000e770: 7272 6564 2072 6573 6f6c 7574 696f 6e2e rred resolution. │ │ │ │ │ -0000e780: 2020 2a4e 6f74 6520 6766 786d 6f64 653a *Note gfxmode: │ │ │ │ │ -0000e790: 3a2e 0a0a 2747 5255 425f 4241 434b 4752 :...'GRUB_BACKGR │ │ │ │ │ -0000e7a0: 4f55 4e44 270a 2020 2020 2053 6574 2061 OUND'. Set a │ │ │ │ │ -0000e7b0: 2062 6163 6b67 726f 756e 6420 696d 6167 background imag │ │ │ │ │ -0000e7c0: 6520 666f 7220 7573 6520 7769 7468 2074 e for use with t │ │ │ │ │ -0000e7d0: 6865 2027 6766 7874 6572 6d27 2067 7261 he 'gfxterm' gra │ │ │ │ │ -0000e7e0: 7068 6963 616c 0a20 2020 2020 7465 726d phical. term │ │ │ │ │ -0000e7f0: 696e 616c 2e20 2054 6865 2076 616c 7565 inal. The value │ │ │ │ │ -0000e800: 206f 6620 7468 6973 206f 7074 696f 6e20 of this option │ │ │ │ │ -0000e810: 6d75 7374 2062 6520 6120 6669 6c65 2072 must be a file r │ │ │ │ │ -0000e820: 6561 6461 626c 6520 6279 2047 5255 420a eadable by GRUB. │ │ │ │ │ -0000e830: 2020 2020 2061 7420 626f 6f74 2074 696d at boot tim │ │ │ │ │ -0000e840: 652c 2061 6e64 2069 7420 6d75 7374 2065 e, and it must e │ │ │ │ │ -0000e850: 6e64 2077 6974 6820 272e 706e 6727 2c20 nd with '.png', │ │ │ │ │ -0000e860: 272e 7467 6127 2c20 272e 6a70 6727 2c20 '.tga', '.jpg', │ │ │ │ │ -0000e870: 6f72 0a20 2020 2020 272e 6a70 6567 272e or. '.jpeg'. │ │ │ │ │ -0000e880: 2020 5468 6520 696d 6167 6520 7769 6c6c The image will │ │ │ │ │ -0000e890: 2062 6520 7363 616c 6564 2069 6620 6e65 be scaled if ne │ │ │ │ │ -0000e8a0: 6365 7373 6172 7920 746f 2066 6974 2074 cessary to fit t │ │ │ │ │ -0000e8b0: 6865 2073 6372 6565 6e2e 0a20 2020 2020 he screen.. │ │ │ │ │ -0000e8c0: 496d 6167 6520 6865 6967 6874 2061 6e64 Image height and │ │ │ │ │ -0000e8d0: 2077 6964 7468 2077 696c 6c20 6265 2072 width will be r │ │ │ │ │ -0000e8e0: 6573 7472 6963 7465 6420 6279 2061 6e20 estricted by an │ │ │ │ │ -0000e8f0: 6172 7469 6669 6369 616c 206c 696d 6974 artificial limit │ │ │ │ │ -0000e900: 206f 660a 2020 2020 2031 3633 3834 2e0a of. 16384.. │ │ │ │ │ -0000e910: 0a27 4752 5542 5f54 4845 4d45 270a 2020 .'GRUB_THEME'. │ │ │ │ │ -0000e920: 2020 2053 6574 2061 2074 6865 6d65 2066 Set a theme f │ │ │ │ │ -0000e930: 6f72 2075 7365 2077 6974 6820 7468 6520 or use with the │ │ │ │ │ -0000e940: 2767 6678 7465 726d 2720 6772 6170 6869 'gfxterm' graphi │ │ │ │ │ -0000e950: 6361 6c20 7465 726d 696e 616c 2e0a 0a27 cal terminal...' │ │ │ │ │ -0000e960: 4752 5542 5f47 4658 5041 594c 4f41 445f GRUB_GFXPAYLOAD_ │ │ │ │ │ -0000e970: 4c49 4e55 5827 0a20 2020 2020 5365 7420 LINUX'. Set │ │ │ │ │ -0000e980: 746f 2027 7465 7874 2720 746f 2066 6f72 to 'text' to for │ │ │ │ │ -0000e990: 6365 2074 6865 204c 696e 7578 206b 6572 ce the Linux ker │ │ │ │ │ -0000e9a0: 6e65 6c20 746f 2062 6f6f 7420 696e 206e nel to boot in n │ │ │ │ │ -0000e9b0: 6f72 6d61 6c20 7465 7874 0a20 2020 2020 ormal text. │ │ │ │ │ -0000e9c0: 6d6f 6465 2c20 276b 6565 7027 2074 6f20 mode, 'keep' to │ │ │ │ │ -0000e9d0: 7072 6573 6572 7665 2074 6865 2067 7261 preserve the gra │ │ │ │ │ -0000e9e0: 7068 6963 7320 6d6f 6465 2073 6574 2075 phics mode set u │ │ │ │ │ -0000e9f0: 7369 6e67 0a20 2020 2020 2747 5255 425f sing. 'GRUB_ │ │ │ │ │ -0000ea00: 4746 584d 4f44 4527 2c20 2757 4944 5448 GFXMODE', 'WIDTH │ │ │ │ │ -0000ea10: 7848 4549 4748 5427 5b27 7844 4550 5448 xHEIGHT'['xDEPTH │ │ │ │ │ -0000ea20: 275d 2074 6f20 7365 7420 6120 7061 7274 '] to set a part │ │ │ │ │ -0000ea30: 6963 756c 6172 0a20 2020 2020 6772 6170 icular. grap │ │ │ │ │ -0000ea40: 6869 6373 206d 6f64 652c 206f 7220 6120 hics mode, or a │ │ │ │ │ -0000ea50: 7365 7175 656e 6365 206f 6620 7468 6573 sequence of thes │ │ │ │ │ -0000ea60: 6520 7365 7061 7261 7465 6420 6279 2063 e separated by c │ │ │ │ │ -0000ea70: 6f6d 6d61 7320 6f72 0a20 2020 2020 7365 ommas or. se │ │ │ │ │ -0000ea80: 6d69 636f 6c6f 6e73 2074 6f20 7472 7920 micolons to try │ │ │ │ │ -0000ea90: 7365 7665 7261 6c20 6d6f 6465 7320 696e several modes in │ │ │ │ │ -0000eaa0: 2073 6571 7565 6e63 652e 2020 2a4e 6f74 sequence. *Not │ │ │ │ │ -0000eab0: 6520 6766 7870 6179 6c6f 6164 3a3a 2e0a e gfxpayload::.. │ │ │ │ │ -0000eac0: 0a20 2020 2020 4465 7065 6e64 696e 6720 . Depending │ │ │ │ │ -0000ead0: 6f6e 2079 6f75 7220 6b65 726e 656c 2c20 on your kernel, │ │ │ │ │ -0000eae0: 796f 7572 2064 6973 7472 6962 7574 696f your distributio │ │ │ │ │ -0000eaf0: 6e2c 2079 6f75 7220 6772 6170 6869 6373 n, your graphics │ │ │ │ │ -0000eb00: 2063 6172 642c 0a20 2020 2020 616e 6420 card,. and │ │ │ │ │ -0000eb10: 7468 6520 7068 6173 6520 6f66 2074 6865 the phase of the │ │ │ │ │ -0000eb20: 206d 6f6f 6e2c 206e 6f74 6520 7468 6174 moon, note that │ │ │ │ │ -0000eb30: 2075 7369 6e67 2074 6869 7320 6f70 7469 using this opti │ │ │ │ │ -0000eb40: 6f6e 206d 6179 2063 6175 7365 0a20 2020 on may cause. │ │ │ │ │ -0000eb50: 2020 474e 552f 4c69 6e75 7820 746f 2073 GNU/Linux to s │ │ │ │ │ -0000eb60: 7566 6665 7220 6672 6f6d 2076 6172 696f uffer from vario │ │ │ │ │ -0000eb70: 7573 2064 6973 706c 6179 2070 726f 626c us display probl │ │ │ │ │ -0000eb80: 656d 732c 2070 6172 7469 6375 6c61 726c ems, particularl │ │ │ │ │ -0000eb90: 790a 2020 2020 2064 7572 696e 6720 7468 y. during th │ │ │ │ │ -0000eba0: 6520 6561 726c 7920 7061 7274 206f 6620 e early part of │ │ │ │ │ -0000ebb0: 7468 6520 626f 6f74 2073 6571 7565 6e63 the boot sequenc │ │ │ │ │ -0000ebc0: 652e 2020 4966 2079 6f75 2068 6176 6520 e. If you have │ │ │ │ │ -0000ebd0: 7072 6f62 6c65 6d73 2c0a 2020 2020 2073 problems,. s │ │ │ │ │ -0000ebe0: 6574 2074 6869 7320 6f70 7469 6f6e 2074 et this option t │ │ │ │ │ -0000ebf0: 6f20 2774 6578 7427 2061 6e64 2047 5255 o 'text' and GRU │ │ │ │ │ -0000ec00: 4220 7769 6c6c 2074 656c 6c20 4c69 6e75 B will tell Linu │ │ │ │ │ -0000ec10: 7820 746f 2062 6f6f 7420 696e 0a20 2020 x to boot in. │ │ │ │ │ -0000ec20: 2020 6e6f 726d 616c 2074 6578 7420 6d6f normal text mo │ │ │ │ │ -0000ec30: 6465 2e0a 0a27 4752 5542 5f44 4953 4142 de...'GRUB_DISAB │ │ │ │ │ -0000ec40: 4c45 5f4f 535f 5052 4f42 4552 270a 2020 LE_OS_PROBER'. │ │ │ │ │ -0000ec50: 2020 2054 6865 2027 6772 7562 2d6d 6b63 The 'grub-mkc │ │ │ │ │ -0000ec60: 6f6e 6669 6727 2068 6173 2061 2066 6561 onfig' has a fea │ │ │ │ │ -0000ec70: 7475 7265 2074 6f20 7573 6520 7468 6520 ture to use the │ │ │ │ │ -0000ec80: 6578 7465 726e 616c 2027 6f73 2d70 726f external 'os-pro │ │ │ │ │ -0000ec90: 6265 7227 0a20 2020 2020 7072 6f67 7261 ber'. progra │ │ │ │ │ -0000eca0: 6d20 746f 2064 6973 636f 7665 7220 6f74 m to discover ot │ │ │ │ │ -0000ecb0: 6865 7220 6f70 6572 6174 696e 6720 7379 her operating sy │ │ │ │ │ -0000ecc0: 7374 656d 7320 696e 7374 616c 6c65 6420 stems installed │ │ │ │ │ -0000ecd0: 6f6e 2074 6865 2073 616d 650a 2020 2020 on the same. │ │ │ │ │ -0000ece0: 206d 6163 6869 6e65 2061 6e64 2067 656e machine and gen │ │ │ │ │ -0000ecf0: 6572 6174 6520 6170 7072 6f70 7269 6174 erate appropriat │ │ │ │ │ -0000ed00: 6520 6d65 6e75 2065 6e74 7269 6573 2066 e menu entries f │ │ │ │ │ -0000ed10: 6f72 2074 6865 6d2e 2020 4974 2069 730a or them. It is. │ │ │ │ │ -0000ed20: 2020 2020 2064 6973 6162 6c65 6420 6279 disabled by │ │ │ │ │ -0000ed30: 2064 6566 6175 6c74 2073 696e 6365 2061 default since a │ │ │ │ │ -0000ed40: 7574 6f6d 6174 6963 2061 6e64 2073 696c utomatic and sil │ │ │ │ │ -0000ed50: 656e 7420 6578 6563 7574 696f 6e20 6f66 ent execution of │ │ │ │ │ -0000ed60: 0a20 2020 2020 276f 732d 7072 6f62 6572 . 'os-prober │ │ │ │ │ -0000ed70: 272c 2061 6e64 2063 7265 6174 696e 6720 ', and creating │ │ │ │ │ -0000ed80: 626f 6f74 2065 6e74 7269 6573 2062 6173 boot entries bas │ │ │ │ │ -0000ed90: 6564 206f 6e20 7468 6174 2064 6174 612c ed on that data, │ │ │ │ │ -0000eda0: 2069 7320 610a 2020 2020 2070 6f74 656e is a. poten │ │ │ │ │ -0000edb0: 7469 616c 2061 7474 6163 6b20 7665 6374 tial attack vect │ │ │ │ │ -0000edc0: 6f72 2e20 2053 6574 2074 6869 7320 6f70 or. Set this op │ │ │ │ │ -0000edd0: 7469 6f6e 2074 6f20 2766 616c 7365 2720 tion to 'false' │ │ │ │ │ -0000ede0: 746f 2065 6e61 626c 6520 7468 6973 0a20 to enable this. │ │ │ │ │ -0000edf0: 2020 2020 6665 6174 7572 6520 696e 2074 feature in t │ │ │ │ │ -0000ee00: 6865 2027 6772 7562 2d6d 6b63 6f6e 6669 he 'grub-mkconfi │ │ │ │ │ -0000ee10: 6727 2063 6f6d 6d61 6e64 2e0a 0a27 4752 g' command...'GR │ │ │ │ │ -0000ee20: 5542 5f4f 535f 5052 4f42 4552 5f53 4b49 UB_OS_PROBER_SKI │ │ │ │ │ -0000ee30: 505f 4c49 5354 270a 2020 2020 204c 6973 P_LIST'. Lis │ │ │ │ │ -0000ee40: 7420 6f66 2073 7061 6365 2d73 6570 6172 t of space-separ │ │ │ │ │ -0000ee50: 6174 6564 2046 5320 5555 4944 7320 6f66 ated FS UUIDs of │ │ │ │ │ -0000ee60: 2066 696c 6573 7973 7465 6d73 2074 6f20 filesystems to │ │ │ │ │ -0000ee70: 6265 2069 676e 6f72 6564 2066 726f 6d0a be ignored from. │ │ │ │ │ -0000ee80: 2020 2020 206f 732d 7072 6f62 6572 206f os-prober o │ │ │ │ │ -0000ee90: 7574 7075 742e 2020 466f 7220 6566 6920 utput. For efi │ │ │ │ │ -0000eea0: 6368 6169 6e6c 6f61 6465 7273 2069 7427 chainloaders it' │ │ │ │ │ -0000eeb0: 7320 3c55 5549 443e 403c 4546 4920 4649 s @..'GRUB_DISAB │ │ │ │ │ -0000eed0: 4c45 5f53 5542 4d45 4e55 270a 2020 2020 LE_SUBMENU'. │ │ │ │ │ -0000eee0: 204e 6f72 6d61 6c6c 792c 2027 6772 7562 Normally, 'grub │ │ │ │ │ -0000eef0: 2d6d 6b63 6f6e 6669 6727 2077 696c 6c20 -mkconfig' will │ │ │ │ │ -0000ef00: 6765 6e65 7261 7465 2074 6f70 206c 6576 generate top lev │ │ │ │ │ -0000ef10: 656c 206d 656e 7520 656e 7472 7920 666f el menu entry fo │ │ │ │ │ -0000ef20: 720a 2020 2020 2074 6865 206b 6572 6e65 r. the kerne │ │ │ │ │ -0000ef30: 6c20 7769 7468 2068 6967 6865 7374 2076 l with highest v │ │ │ │ │ -0000ef40: 6572 7369 6f6e 206e 756d 6265 7220 616e ersion number an │ │ │ │ │ -0000ef50: 6420 7075 7420 616c 6c20 6f74 6865 7220 d put all other │ │ │ │ │ -0000ef60: 666f 756e 640a 2020 2020 206b 6572 6e65 found. kerne │ │ │ │ │ -0000ef70: 6c73 206f 7220 616c 7465 726e 6174 6976 ls or alternativ │ │ │ │ │ -0000ef80: 6520 6d65 6e75 2065 6e74 7269 6573 2066 e menu entries f │ │ │ │ │ -0000ef90: 6f72 2072 6563 6f76 6572 7920 6d6f 6465 or recovery mode │ │ │ │ │ -0000efa0: 2069 6e20 7375 626d 656e 752e 0a20 2020 in submenu.. │ │ │ │ │ -0000efb0: 2020 466f 7220 656e 7472 6965 7320 7265 For entries re │ │ │ │ │ -0000efc0: 7475 726e 6564 2062 7920 276f 732d 7072 turned by 'os-pr │ │ │ │ │ -0000efd0: 6f62 6572 2720 6669 7273 7420 656e 7472 ober' first entr │ │ │ │ │ -0000efe0: 7920 7769 6c6c 2062 6520 7075 7420 6f6e y will be put on │ │ │ │ │ -0000eff0: 2074 6f70 0a20 2020 2020 6c65 7665 6c20 top. level │ │ │ │ │ -0000f000: 616e 6420 616c 6c20 6f74 6865 7273 2069 and all others i │ │ │ │ │ -0000f010: 6e20 7375 626d 656e 752e 2020 4966 2074 n submenu. If t │ │ │ │ │ -0000f020: 6869 7320 6f70 7469 6f6e 2069 7320 7365 his option is se │ │ │ │ │ -0000f030: 7420 746f 2027 7472 7565 272c 0a20 2020 t to 'true',. │ │ │ │ │ -0000f040: 2020 666c 6174 206d 656e 7520 7769 7468 flat menu with │ │ │ │ │ -0000f050: 2061 6c6c 2065 6e74 7269 6573 206f 6e20 all entries on │ │ │ │ │ -0000f060: 746f 7020 6c65 7665 6c20 7769 6c6c 2062 top level will b │ │ │ │ │ -0000f070: 6520 6765 6e65 7261 7465 6420 696e 7374 e generated inst │ │ │ │ │ -0000f080: 6561 642e 0a20 2020 2020 4368 616e 6769 ead.. Changi │ │ │ │ │ -0000f090: 6e67 2074 6869 7320 6f70 7469 6f6e 2077 ng this option w │ │ │ │ │ -0000f0a0: 696c 6c20 7265 7175 6972 6520 6368 616e ill require chan │ │ │ │ │ -0000f0b0: 6769 6e67 2065 7869 7374 696e 6720 7661 ging existing va │ │ │ │ │ -0000f0c0: 6c75 6573 206f 660a 2020 2020 2027 4752 lues of. 'GR │ │ │ │ │ -0000f0d0: 5542 5f44 4546 4155 4c54 272c 2027 6661 UB_DEFAULT', 'fa │ │ │ │ │ -0000f0e0: 6c6c 6261 636b 2720 282a 6e6f 7465 2066 llback' (*note f │ │ │ │ │ -0000f0f0: 616c 6c62 6163 6b3a 3a29 2061 6e64 2027 allback::) and ' │ │ │ │ │ -0000f100: 6465 6661 756c 7427 2028 2a6e 6f74 650a default' (*note. │ │ │ │ │ -0000f110: 2020 2020 2064 6566 6175 6c74 3a3a 2920 default::) │ │ │ │ │ -0000f120: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -0000f130: 6162 6c65 7320 6173 2077 656c 6c20 6173 ables as well as │ │ │ │ │ -0000f140: 2073 6176 6564 2064 6566 6175 6c74 2065 saved default e │ │ │ │ │ -0000f150: 6e74 7279 0a20 2020 2020 7573 696e 6720 ntry. using │ │ │ │ │ -0000f160: 2767 7275 622d 7365 742d 6465 6661 756c 'grub-set-defaul │ │ │ │ │ -0000f170: 7427 2061 6e64 2076 616c 7565 2075 7365 t' and value use │ │ │ │ │ -0000f180: 6420 7769 7468 2027 6772 7562 2d72 6562 d with 'grub-reb │ │ │ │ │ -0000f190: 6f6f 7427 2e0a 0a27 4752 5542 5f45 4e41 oot'...'GRUB_ENA │ │ │ │ │ -0000f1a0: 424c 455f 4352 5950 544f 4449 534b 270a BLE_CRYPTODISK'. │ │ │ │ │ -0000f1b0: 2020 2020 2049 6620 7365 7420 746f 2027 If set to ' │ │ │ │ │ -0000f1c0: 7927 2c20 2767 7275 622d 6d6b 636f 6e66 y', 'grub-mkconf │ │ │ │ │ -0000f1d0: 6967 2720 616e 6420 2767 7275 622d 696e ig' and 'grub-in │ │ │ │ │ -0000f1e0: 7374 616c 6c27 2077 696c 6c20 6368 6563 stall' will chec │ │ │ │ │ -0000f1f0: 6b20 666f 720a 2020 2020 2065 6e63 7279 k for. encry │ │ │ │ │ -0000f200: 7074 6564 2064 6973 6b73 2061 6e64 2067 pted disks and g │ │ │ │ │ -0000f210: 656e 6572 6174 6520 6164 6469 7469 6f6e enerate addition │ │ │ │ │ -0000f220: 616c 2063 6f6d 6d61 6e64 7320 6e65 6564 al commands need │ │ │ │ │ -0000f230: 6564 2074 6f20 6163 6365 7373 0a20 2020 ed to access. │ │ │ │ │ -0000f240: 2020 7468 656d 2064 7572 696e 6720 626f them during bo │ │ │ │ │ -0000f250: 6f74 2e20 204e 6f74 6520 7468 6174 2069 ot. Note that i │ │ │ │ │ -0000f260: 6e20 7468 6973 2063 6173 6520 756e 6174 n this case unat │ │ │ │ │ -0000f270: 7465 6e64 6564 2062 6f6f 7420 6973 206e tended boot is n │ │ │ │ │ -0000f280: 6f74 0a20 2020 2020 706f 7373 6962 6c65 ot. possible │ │ │ │ │ -0000f290: 2062 6563 6175 7365 2047 5255 4220 7769 because GRUB wi │ │ │ │ │ -0000f2a0: 6c6c 2077 6169 7420 666f 7220 7061 7373 ll wait for pass │ │ │ │ │ -0000f2b0: 7068 7261 7365 2074 6f20 756e 6c6f 636b phrase to unlock │ │ │ │ │ -0000f2c0: 2065 6e63 7279 7074 6564 0a20 2020 2020 encrypted. │ │ │ │ │ -0000f2d0: 636f 6e74 6169 6e65 722e 0a0a 2747 5255 container...'GRU │ │ │ │ │ -0000f2e0: 425f 494e 4954 5f54 554e 4527 0a20 2020 B_INIT_TUNE'. │ │ │ │ │ -0000f2f0: 2020 506c 6179 2061 2074 756e 6520 6f6e Play a tune on │ │ │ │ │ -0000f300: 2074 6865 2073 7065 616b 6572 2077 6865 the speaker whe │ │ │ │ │ -0000f310: 6e20 4752 5542 2073 7461 7274 732e 2020 n GRUB starts. │ │ │ │ │ -0000f320: 5468 6973 2069 7320 7061 7274 6963 756c This is particul │ │ │ │ │ -0000f330: 6172 6c79 0a20 2020 2020 7573 6566 756c arly. useful │ │ │ │ │ -0000f340: 2066 6f72 2075 7365 7273 2075 6e61 626c for users unabl │ │ │ │ │ -0000f350: 6520 746f 2073 6565 2074 6865 2073 6372 e to see the scr │ │ │ │ │ -0000f360: 6565 6e2e 2020 5468 6520 7661 6c75 6520 een. The value │ │ │ │ │ -0000f370: 6f66 2074 6869 730a 2020 2020 206f 7074 of this. opt │ │ │ │ │ -0000f380: 696f 6e20 6973 2070 6173 7365 6420 6469 ion is passed di │ │ │ │ │ -0000f390: 7265 6374 6c79 2074 6f20 2a6e 6f74 6520 rectly to *note │ │ │ │ │ -0000f3a0: 706c 6179 3a3a 2e0a 0a27 4752 5542 5f42 play::...'GRUB_B │ │ │ │ │ -0000f3b0: 4144 5241 4d27 0a20 2020 2020 4966 2074 ADRAM'. If t │ │ │ │ │ -0000f3c0: 6869 7320 6f70 7469 6f6e 2069 7320 7365 his option is se │ │ │ │ │ -0000f3d0: 742c 2047 5255 4220 7769 6c6c 2069 7373 t, GRUB will iss │ │ │ │ │ -0000f3e0: 7565 2061 202a 6e6f 7465 2062 6164 7261 ue a *note badra │ │ │ │ │ -0000f3f0: 6d3a 3a20 636f 6d6d 616e 6420 746f 0a20 m:: command to. │ │ │ │ │ -0000f400: 2020 2020 6669 6c74 6572 206f 7574 2073 filter out s │ │ │ │ │ -0000f410: 7065 6369 6669 6564 2072 6567 696f 6e73 pecified regions │ │ │ │ │ -0000f420: 206f 6620 5241 4d2e 0a0a 2747 5255 425f of RAM...'GRUB_ │ │ │ │ │ -0000f430: 5052 454c 4f41 445f 4d4f 4455 4c45 5327 PRELOAD_MODULES' │ │ │ │ │ -0000f440: 0a20 2020 2020 5468 6973 206f 7074 696f . This optio │ │ │ │ │ -0000f450: 6e20 6d61 7920 6265 2073 6574 2074 6f20 n may be set to │ │ │ │ │ -0000f460: 6120 6c69 7374 206f 6620 4752 5542 206d a list of GRUB m │ │ │ │ │ -0000f470: 6f64 756c 6520 6e61 6d65 7320 7365 7061 odule names sepa │ │ │ │ │ -0000f480: 7261 7465 6420 6279 0a20 2020 2020 7370 rated by. sp │ │ │ │ │ -0000f490: 6163 6573 2e20 2045 6163 6820 6d6f 6475 aces. Each modu │ │ │ │ │ -0000f4a0: 6c65 2077 696c 6c20 6265 206c 6f61 6465 le will be loade │ │ │ │ │ -0000f4b0: 6420 6173 2065 6172 6c79 2061 7320 706f d as early as po │ │ │ │ │ -0000f4c0: 7373 6962 6c65 2c20 6174 2074 6865 0a20 ssible, at the. │ │ │ │ │ -0000f4d0: 2020 2020 7374 6172 7420 6f66 2027 6772 start of 'gr │ │ │ │ │ -0000f4e0: 7562 2e63 6667 272e 0a0a 2747 5255 425f ub.cfg'...'GRUB_ │ │ │ │ │ -0000f4f0: 5245 434f 5244 4641 494c 5f54 494d 454f RECORDFAIL_TIMEO │ │ │ │ │ -0000f500: 5554 270a 2020 2020 2049 6620 7468 6973 UT'. If this │ │ │ │ │ -0000f510: 206f 7074 696f 6e20 6973 2073 6574 2c20 option is set, │ │ │ │ │ -0000f520: 6974 206f 7665 7272 6964 6573 2074 6865 it overrides the │ │ │ │ │ -0000f530: 2064 6566 6175 6c74 2072 6563 6f72 6466 default recordf │ │ │ │ │ -0000f540: 6169 6c20 7365 7474 696e 672e 0a20 2020 ail setting.. │ │ │ │ │ -0000f550: 2020 4120 7365 7474 696e 6720 6f66 202d A setting of - │ │ │ │ │ -0000f560: 3120 6361 7573 6573 2047 5255 4220 746f 1 causes GRUB to │ │ │ │ │ -0000f570: 2077 6169 7420 666f 7220 7573 6572 2069 wait for user i │ │ │ │ │ -0000f580: 6e70 7574 2069 6e64 6566 696e 6974 656c nput indefinitel │ │ │ │ │ -0000f590: 792e 0a20 2020 2020 486f 7765 7665 722c y.. However, │ │ │ │ │ -0000f5a0: 2061 2066 616c 7365 2070 6f73 6974 6976 a false positiv │ │ │ │ │ -0000f5b0: 6520 696e 2074 6865 2072 6563 6f72 6466 e in the recordf │ │ │ │ │ -0000f5c0: 6169 6c20 6d65 6368 616e 6973 6d20 6d61 ail mechanism ma │ │ │ │ │ -0000f5d0: 7920 6f63 6375 7220 6966 0a20 2020 2020 y occur if. │ │ │ │ │ -0000f5e0: 706f 7765 7220 6973 206c 6f73 7420 6475 power is lost du │ │ │ │ │ -0000f5f0: 7269 6e67 2062 6f6f 7420 6265 666f 7265 ring boot before │ │ │ │ │ -0000f600: 2062 6f6f 7420 7375 6363 6573 7320 6973 boot success is │ │ │ │ │ -0000f610: 2072 6563 6f72 6465 6420 696e 0a20 2020 recorded in. │ │ │ │ │ -0000f620: 2020 7573 6572 7370 6163 652e 2020 5468 userspace. Th │ │ │ │ │ -0000f630: 6520 6465 6661 756c 7420 7365 7474 696e e default settin │ │ │ │ │ -0000f640: 6720 6973 2033 302c 2077 6869 6368 2063 g is 30, which c │ │ │ │ │ -0000f650: 6175 7365 7320 4752 5542 2074 6f20 7761 auses GRUB to wa │ │ │ │ │ -0000f660: 6974 0a20 2020 2020 666f 7220 7573 6572 it. for user │ │ │ │ │ -0000f670: 2069 6e70 7574 2066 6f72 2074 6869 7274 input for thirt │ │ │ │ │ -0000f680: 7920 7365 636f 6e64 7320 6265 666f 7265 y seconds before │ │ │ │ │ -0000f690: 2063 6f6e 7469 6e75 696e 672e 2020 5468 continuing. Th │ │ │ │ │ -0000f6a0: 6973 2064 6566 6175 6c74 0a20 2020 2020 is default. │ │ │ │ │ -0000f6b0: 616c 6c6f 7773 2069 6e74 6572 6163 7469 allows interacti │ │ │ │ │ -0000f6c0: 7665 2075 7365 7273 2074 6865 206f 7070 ve users the opp │ │ │ │ │ -0000f6d0: 6f72 7475 6e69 7479 2074 6f20 7377 6974 ortunity to swit │ │ │ │ │ -0000f6e0: 6368 2074 6f20 6120 6469 6666 6572 656e ch to a differen │ │ │ │ │ -0000f6f0: 742c 0a20 2020 2020 776f 726b 696e 6720 t,. working │ │ │ │ │ -0000f700: 6b65 726e 656c 2c20 7768 696c 6520 6176 kernel, while av │ │ │ │ │ -0000f710: 6f69 6469 6e67 2061 2066 616c 7365 2070 oiding a false p │ │ │ │ │ -0000f720: 6f73 6974 6976 6520 6361 7573 696e 6720 ositive causing │ │ │ │ │ -0000f730: 7468 6520 626f 6f74 2074 6f0a 2020 2020 the boot to. │ │ │ │ │ -0000f740: 2062 6c6f 636b 2069 6e64 6566 696e 6974 block indefinit │ │ │ │ │ -0000f750: 656c 7920 6f6e 2068 6561 646c 6573 7320 ely on headless │ │ │ │ │ -0000f760: 616e 6420 6170 706c 6961 6e63 6520 7379 and appliance sy │ │ │ │ │ -0000f770: 7374 656d 7320 7768 6572 6520 6163 6365 stems where acce │ │ │ │ │ -0000f780: 7373 0a20 2020 2020 746f 2061 2063 6f6e ss. to a con │ │ │ │ │ -0000f790: 736f 6c65 2069 7320 7265 7374 7269 6374 sole is restrict │ │ │ │ │ -0000f7a0: 6564 206f 7220 6c69 6d69 7465 642e 0a0a ed or limited... │ │ │ │ │ -0000f7b0: 2020 2020 2054 6869 7320 6f70 7469 6f6e This option │ │ │ │ │ -0000f7c0: 2069 7320 6f6e 6c79 2065 6666 6563 7469 is only effecti │ │ │ │ │ -0000f7d0: 7665 2077 6865 6e20 4752 5542 2077 6173 ve when GRUB was │ │ │ │ │ -0000f7e0: 2063 6f6e 6669 6775 7265 6420 7769 7468 configured with │ │ │ │ │ -0000f7f0: 2074 6865 0a20 2020 2020 272d 2d65 6e61 the. '--ena │ │ │ │ │ -0000f800: 626c 652d 7175 6963 6b2d 626f 6f74 2720 ble-quick-boot' │ │ │ │ │ -0000f810: 6f70 7469 6f6e 2e0a 0a27 4752 5542 5f52 option...'GRUB_R │ │ │ │ │ -0000f820: 4543 4f56 4552 595f 5449 544c 4527 0a20 ECOVERY_TITLE'. │ │ │ │ │ -0000f830: 2020 2020 5468 6973 206f 7074 696f 6e20 This option │ │ │ │ │ -0000f840: 7365 7473 2074 6865 2045 6e67 6c69 7368 sets the English │ │ │ │ │ -0000f850: 2074 6578 7420 6f66 2074 6865 2073 7472 text of the str │ │ │ │ │ -0000f860: 696e 6720 7468 6174 2077 696c 6c20 6265 ing that will be │ │ │ │ │ -0000f870: 0a20 2020 2020 6469 7370 6c61 7965 6420 . displayed │ │ │ │ │ -0000f880: 696e 2070 6172 656e 7468 6573 6573 2074 in parentheses t │ │ │ │ │ -0000f890: 6f20 696e 6469 6361 7465 2074 6861 7420 o indicate that │ │ │ │ │ -0000f8a0: 6120 626f 6f74 206f 7074 696f 6e20 6973 a boot option is │ │ │ │ │ -0000f8b0: 2070 726f 7669 6465 640a 2020 2020 2074 provided. t │ │ │ │ │ -0000f8c0: 6f20 6865 6c70 2075 7365 7273 2072 6563 o help users rec │ │ │ │ │ -0000f8d0: 6f76 6572 2061 2062 726f 6b65 6e20 7379 over a broken sy │ │ │ │ │ -0000f8e0: 7374 656d 2e20 2054 6865 2064 6566 6175 stem. The defau │ │ │ │ │ -0000f8f0: 6c74 2069 7320 2272 6563 6f76 6572 790a lt is "recovery. │ │ │ │ │ -0000f900: 2020 2020 206d 6f64 6522 2e0a 0a20 2020 mode"... │ │ │ │ │ -0000f910: 5468 6520 666f 6c6c 6f77 696e 6720 6f70 The following op │ │ │ │ │ -0000f920: 7469 6f6e 7320 6172 6520 7374 696c 6c20 tions are still │ │ │ │ │ -0000f930: 6163 6365 7074 6564 2066 6f72 2063 6f6d accepted for com │ │ │ │ │ -0000f940: 7061 7469 6269 6c69 7479 2077 6974 680a patibility with. │ │ │ │ │ -0000f950: 6578 6973 7469 6e67 2063 6f6e 6669 6775 existing configu │ │ │ │ │ -0000f960: 7261 7469 6f6e 732c 2062 7574 2068 6176 rations, but hav │ │ │ │ │ -0000f970: 6520 6265 7474 6572 2072 6570 6c61 6365 e better replace │ │ │ │ │ -0000f980: 6d65 6e74 733a 0a0a 2747 5255 425f 4849 ments:..'GRUB_HI │ │ │ │ │ -0000f990: 4444 454e 5f54 494d 454f 5554 270a 2020 DDEN_TIMEOUT'. │ │ │ │ │ -0000f9a0: 2020 2057 6169 7420 7468 6973 206d 616e Wait this man │ │ │ │ │ -0000f9b0: 7920 7365 636f 6e64 7320 6265 666f 7265 y seconds before │ │ │ │ │ -0000f9c0: 2064 6973 706c 6179 696e 6720 7468 6520 displaying the │ │ │ │ │ -0000f9d0: 6d65 6e75 2e20 2049 6620 3c45 5343 3e20 menu. If │ │ │ │ │ -0000f9e0: 6f72 0a20 2020 2020 3c46 343e 2061 7265 or. are │ │ │ │ │ -0000f9f0: 2070 7265 7373 6564 2c20 6f72 203c 5348 pressed, or is held dow │ │ │ │ │ -0000fa10: 6e20 6475 7269 6e67 2074 6861 7420 7469 n during that ti │ │ │ │ │ -0000fa20: 6d65 2c20 6469 7370 6c61 790a 2020 2020 me, display. │ │ │ │ │ -0000fa30: 2074 6865 206d 656e 7520 616e 6420 7761 the menu and wa │ │ │ │ │ -0000fa40: 6974 2066 6f72 2069 6e70 7574 2061 6363 it for input acc │ │ │ │ │ -0000fa50: 6f72 6469 6e67 2074 6f20 2747 5255 425f ording to 'GRUB_ │ │ │ │ │ -0000fa60: 5449 4d45 4f55 5427 2e20 2049 6620 610a TIMEOUT'. If a. │ │ │ │ │ -0000fa70: 2020 2020 2068 6f74 6b65 7920 6173 736f hotkey asso │ │ │ │ │ -0000fa80: 6369 6174 6564 2077 6974 6820 6120 6d65 ciated with a me │ │ │ │ │ -0000fa90: 6e75 2065 6e74 7279 2069 7320 7072 6573 nu entry is pres │ │ │ │ │ -0000faa0: 7365 642c 2062 6f6f 7420 7468 6520 6173 sed, boot the as │ │ │ │ │ -0000fab0: 736f 6369 6174 6564 0a20 2020 2020 6d65 sociated. me │ │ │ │ │ -0000fac0: 6e75 2065 6e74 7279 2069 6d6d 6564 6961 nu entry immedia │ │ │ │ │ -0000fad0: 7465 6c79 2e20 2049 6620 7468 6520 7469 tely. If the ti │ │ │ │ │ -0000fae0: 6d65 6f75 7420 6578 7069 7265 7320 6265 meout expires be │ │ │ │ │ -0000faf0: 666f 7265 2065 6974 6865 7220 6f66 0a20 fore either of. │ │ │ │ │ -0000fb00: 2020 2020 7468 6573 6520 6861 7070 656e these happen │ │ │ │ │ -0000fb10: 732c 2064 6973 706c 6179 2074 6865 206d s, display the m │ │ │ │ │ -0000fb20: 656e 7520 666f 7220 7468 6520 6e75 6d62 enu for the numb │ │ │ │ │ -0000fb30: 6572 206f 6620 7365 636f 6e64 7320 7370 er of seconds sp │ │ │ │ │ -0000fb40: 6563 6966 6965 640a 2020 2020 2069 6e20 ecified. in │ │ │ │ │ -0000fb50: 2747 5255 425f 5449 4d45 4f55 5427 2062 'GRUB_TIMEOUT' b │ │ │ │ │ -0000fb60: 6566 6f72 6520 626f 6f74 696e 6720 7468 efore booting th │ │ │ │ │ -0000fb70: 6520 6465 6661 756c 7420 656e 7472 792e e default entry. │ │ │ │ │ -0000fb80: 0a0a 2020 2020 2049 6620 796f 7520 7365 .. If you se │ │ │ │ │ -0000fb90: 7420 2747 5255 425f 4849 4444 454e 5f54 t 'GRUB_HIDDEN_T │ │ │ │ │ -0000fba0: 494d 454f 5554 272c 2079 6f75 2073 686f IMEOUT', you sho │ │ │ │ │ -0000fbb0: 756c 6420 616c 736f 2073 6574 0a20 2020 uld also set. │ │ │ │ │ -0000fbc0: 2020 2747 5255 425f 5449 4d45 4f55 543d 'GRUB_TIMEOUT= │ │ │ │ │ -0000fbd0: 3027 2073 6f20 7468 6174 2074 6865 206d 0' so that the m │ │ │ │ │ -0000fbe0: 656e 7520 6973 206e 6f74 2064 6973 706c enu is not displ │ │ │ │ │ -0000fbf0: 6179 6564 2061 7420 616c 6c20 756e 6c65 ayed at all unle │ │ │ │ │ -0000fc00: 7373 0a20 2020 2020 3c45 5343 3e20 6f72 ss. or │ │ │ │ │ -0000fc10: 203c 4634 3e20 6172 6520 7072 6573 7365 are presse │ │ │ │ │ -0000fc20: 642c 206f 7220 3c53 4849 4654 3e20 6973 d, or is │ │ │ │ │ -0000fc30: 2068 656c 6420 646f 776e 2e0a 0a20 2020 held down... │ │ │ │ │ -0000fc40: 2020 5468 6973 206f 7074 696f 6e20 6973 This option is │ │ │ │ │ -0000fc50: 2075 6e73 6574 2062 7920 6465 6661 756c unset by defaul │ │ │ │ │ -0000fc60: 742c 2061 6e64 2069 7320 6465 7072 6563 t, and is deprec │ │ │ │ │ -0000fc70: 6174 6564 2069 6e20 6661 766f 7572 206f ated in favour o │ │ │ │ │ -0000fc80: 6620 7468 650a 2020 2020 206c 6573 7320 f the. less │ │ │ │ │ -0000fc90: 636f 6e66 7573 696e 6720 2747 5255 425f confusing 'GRUB_ │ │ │ │ │ -0000fca0: 5449 4d45 4f55 545f 5354 594c 453d 636f TIMEOUT_STYLE=co │ │ │ │ │ -0000fcb0: 756e 7464 6f77 6e27 206f 720a 2020 2020 untdown' or. │ │ │ │ │ -0000fcc0: 2027 4752 5542 5f54 494d 454f 5554 5f53 'GRUB_TIMEOUT_S │ │ │ │ │ -0000fcd0: 5459 4c45 3d68 6964 6465 6e27 2e0a 0a27 TYLE=hidden'...' │ │ │ │ │ -0000fce0: 4752 5542 5f48 4944 4445 4e5f 5449 4d45 GRUB_HIDDEN_TIME │ │ │ │ │ -0000fcf0: 4f55 545f 5155 4945 5427 0a20 2020 2020 OUT_QUIET'. │ │ │ │ │ -0000fd00: 496e 2063 6f6e 6a75 6e63 7469 6f6e 2077 In conjunction w │ │ │ │ │ -0000fd10: 6974 6820 2747 5255 425f 4849 4444 454e ith 'GRUB_HIDDEN │ │ │ │ │ -0000fd20: 5f54 494d 454f 5554 272c 2073 6574 2074 _TIMEOUT', set t │ │ │ │ │ -0000fd30: 6869 7320 746f 2027 7472 7565 2720 746f his to 'true' to │ │ │ │ │ -0000fd40: 0a20 2020 2020 7375 7070 7265 7373 2074 . suppress t │ │ │ │ │ -0000fd50: 6865 2076 6572 626f 7365 2063 6f75 6e74 he verbose count │ │ │ │ │ -0000fd60: 646f 776e 2077 6869 6c65 2077 6169 7469 down while waiti │ │ │ │ │ -0000fd70: 6e67 2066 6f72 2061 206b 6579 2074 6f20 ng for a key to │ │ │ │ │ -0000fd80: 6265 0a20 2020 2020 7072 6573 7365 6420 be. pressed │ │ │ │ │ -0000fd90: 6265 666f 7265 2064 6973 706c 6179 696e before displayin │ │ │ │ │ -0000fda0: 6720 7468 6520 6d65 6e75 2e0a 0a20 2020 g the menu... │ │ │ │ │ -0000fdb0: 2020 5468 6973 206f 7074 696f 6e20 6973 This option is │ │ │ │ │ -0000fdc0: 2075 6e73 6574 2062 7920 6465 6661 756c unset by defaul │ │ │ │ │ -0000fdd0: 742c 2061 6e64 2069 7320 6465 7072 6563 t, and is deprec │ │ │ │ │ -0000fde0: 6174 6564 2069 6e20 6661 766f 7572 206f ated in favour o │ │ │ │ │ -0000fdf0: 6620 7468 650a 2020 2020 206c 6573 7320 f the. less │ │ │ │ │ -0000fe00: 636f 6e66 7573 696e 6720 2747 5255 425f confusing 'GRUB_ │ │ │ │ │ -0000fe10: 5449 4d45 4f55 545f 5354 594c 453d 636f TIMEOUT_STYLE=co │ │ │ │ │ -0000fe20: 756e 7464 6f77 6e27 2e0a 0a27 4752 5542 untdown'...'GRUB │ │ │ │ │ -0000fe30: 5f48 4944 4445 4e5f 5449 4d45 4f55 545f _HIDDEN_TIMEOUT_ │ │ │ │ │ -0000fe40: 4255 5454 4f4e 270a 2020 2020 2056 6172 BUTTON'. Var │ │ │ │ │ -0000fe50: 6961 6e74 206f 6620 2747 5255 425f 4849 iant of 'GRUB_HI │ │ │ │ │ -0000fe60: 4444 454e 5f54 494d 454f 5554 272c 2075 DDEN_TIMEOUT', u │ │ │ │ │ -0000fe70: 7365 6420 746f 2073 7570 706f 7274 2076 sed to support v │ │ │ │ │ -0000fe80: 656e 646f 722d 7370 6563 6966 6963 0a20 endor-specific. │ │ │ │ │ -0000fe90: 2020 2020 706f 7765 7220 6275 7474 6f6e power button │ │ │ │ │ -0000fea0: 732e 2020 2a4e 6f74 6520 5665 6e64 6f72 s. *Note Vendor │ │ │ │ │ -0000feb0: 2070 6f77 6572 2d6f 6e20 6b65 7973 3a3a power-on keys:: │ │ │ │ │ -0000fec0: 2e0a 0a20 2020 2020 5468 6973 206f 7074 ... This opt │ │ │ │ │ -0000fed0: 696f 6e20 6973 2075 6e73 6574 2062 7920 ion is unset by │ │ │ │ │ -0000fee0: 6465 6661 756c 742c 2061 6e64 2069 7320 default, and is │ │ │ │ │ -0000fef0: 6465 7072 6563 6174 6564 2069 6e20 6661 deprecated in fa │ │ │ │ │ -0000ff00: 766f 7572 206f 6620 7468 650a 2020 2020 vour of the. │ │ │ │ │ -0000ff10: 206c 6573 7320 636f 6e66 7573 696e 6720 less confusing │ │ │ │ │ -0000ff20: 2747 5255 425f 5449 4d45 4f55 545f 5354 'GRUB_TIMEOUT_ST │ │ │ │ │ -0000ff30: 594c 453d 636f 756e 7464 6f77 6e27 206f YLE=countdown' o │ │ │ │ │ -0000ff40: 720a 2020 2020 2027 4752 5542 5f54 494d r. 'GRUB_TIM │ │ │ │ │ -0000ff50: 454f 5554 5f53 5459 4c45 3d68 6964 6465 EOUT_STYLE=hidde │ │ │ │ │ -0000ff60: 6e27 2e0a 0a20 2020 466f 7220 6d6f 7265 n'... For more │ │ │ │ │ -0000ff70: 2064 6574 6169 6c65 6420 6375 7374 6f6d detailed custom │ │ │ │ │ -0000ff80: 6973 6174 696f 6e20 6f66 2027 6772 7562 isation of 'grub │ │ │ │ │ -0000ff90: 2d6d 6b63 6f6e 6669 6727 2773 206f 7574 -mkconfig''s out │ │ │ │ │ -0000ffa0: 7075 742c 2079 6f75 206d 6179 0a65 6469 put, you may.edi │ │ │ │ │ -0000ffb0: 7420 7468 6520 7363 7269 7074 7320 696e t the scripts in │ │ │ │ │ -0000ffc0: 2027 2f65 7463 2f67 7275 622e 6427 2064 '/etc/grub.d' d │ │ │ │ │ -0000ffd0: 6972 6563 746c 792e 2020 272f 6574 632f irectly. '/etc/ │ │ │ │ │ -0000ffe0: 6772 7562 2e64 2f34 305f 6375 7374 6f6d grub.d/40_custom │ │ │ │ │ -0000fff0: 2720 6973 0a70 6172 7469 6375 6c61 726c ' is.particularl │ │ │ │ │ -00010000: 7920 7573 6566 756c 2066 6f72 2061 6464 y useful for add │ │ │ │ │ -00010010: 696e 6720 656e 7469 7265 2063 7573 746f ing entire custo │ │ │ │ │ -00010020: 6d20 6d65 6e75 2065 6e74 7269 6573 3b20 m menu entries; │ │ │ │ │ -00010030: 7369 6d70 6c79 2074 7970 650a 7468 6520 simply type.the │ │ │ │ │ -00010040: 6d65 6e75 2065 6e74 7269 6573 2079 6f75 menu entries you │ │ │ │ │ -00010050: 2077 616e 7420 746f 2061 6464 2061 7420 want to add at │ │ │ │ │ -00010060: 7468 6520 656e 6420 6f66 2074 6861 7420 the end of that │ │ │ │ │ -00010070: 6669 6c65 2c20 6d61 6b69 6e67 2073 7572 file, making sur │ │ │ │ │ -00010080: 6520 746f 0a6c 6561 7665 2061 7420 6c65 e to.leave at le │ │ │ │ │ -00010090: 6173 7420 7468 6520 6669 7273 7420 7477 ast the first tw │ │ │ │ │ -000100a0: 6f20 6c69 6e65 7320 696e 7461 6374 2e0a o lines intact.. │ │ │ │ │ -000100b0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -000100c0: 666f 2c20 204e 6f64 653a 2052 6f6f 7420 fo, Node: Root │ │ │ │ │ -000100d0: 4964 656e 7469 6663 6174 696f 6e20 4865 Identifcation He │ │ │ │ │ -000100e0: 7572 6973 7469 6373 2c20 204e 6578 743a uristics, Next: │ │ │ │ │ -000100f0: 2053 6865 6c6c 2d6c 696b 6520 7363 7269 Shell-like scri │ │ │ │ │ -00010100: 7074 696e 672c 2020 5072 6576 3a20 5369 pting, Prev: Si │ │ │ │ │ -00010110: 6d70 6c65 2063 6f6e 6669 6775 7261 7469 mple configurati │ │ │ │ │ -00010120: 6f6e 2c20 2055 703a 2043 6f6e 6669 6775 on, Up: Configu │ │ │ │ │ -00010130: 7261 7469 6f6e 0a0a 362e 3220 526f 6f74 ration..6.2 Root │ │ │ │ │ -00010140: 2049 6465 6e74 6966 6361 7469 6f6e 2048 Identifcation H │ │ │ │ │ -00010150: 6575 7269 7374 6963 730a 3d3d 3d3d 3d3d euristics.====== │ │ │ │ │ +0000bd30: 3d3d 3d3d 3d3d 0a0a 5468 6520 7072 6f67 ======..The prog │ │ │ │ │ +0000bd40: 7261 6d20 2767 7275 622d 6d6b 636f 6e66 ram 'grub-mkconf │ │ │ │ │ +0000bd50: 6967 2720 282a 6e6f 7465 2049 6e76 6f6b ig' (*note Invok │ │ │ │ │ +0000bd60: 696e 6720 6772 7562 2d6d 6b63 6f6e 6669 ing grub-mkconfi │ │ │ │ │ +0000bd70: 673a 3a29 2067 656e 6572 6174 6573 0a27 g::) generates.' │ │ │ │ │ +0000bd80: 6772 7562 2e63 6667 2720 6669 6c65 7320 grub.cfg' files │ │ │ │ │ +0000bd90: 7375 6974 6162 6c65 2066 6f72 206d 6f73 suitable for mos │ │ │ │ │ +0000bda0: 7420 6361 7365 732e 2020 4974 2069 7320 t cases. It is │ │ │ │ │ +0000bdb0: 7375 6974 6162 6c65 2066 6f72 2075 7365 suitable for use │ │ │ │ │ +0000bdc0: 2077 6865 6e0a 7570 6772 6164 696e 6720 when.upgrading │ │ │ │ │ +0000bdd0: 6120 6469 7374 7269 6275 7469 6f6e 2c20 a distribution, │ │ │ │ │ +0000bde0: 616e 6420 7769 6c6c 2064 6973 636f 7665 and will discove │ │ │ │ │ +0000bdf0: 7220 6176 6169 6c61 626c 6520 6b65 726e r available kern │ │ │ │ │ +0000be00: 656c 7320 616e 640a 6174 7465 6d70 7420 els and.attempt │ │ │ │ │ +0000be10: 746f 2067 656e 6572 6174 6520 6d65 6e75 to generate menu │ │ │ │ │ +0000be20: 2065 6e74 7269 6573 2066 6f72 2074 6865 entries for the │ │ │ │ │ +0000be30: 6d2e 0a0a 2020 2027 6772 7562 2d6d 6b63 m... 'grub-mkc │ │ │ │ │ +0000be40: 6f6e 6669 6727 2064 6f65 7320 6861 7665 onfig' does have │ │ │ │ │ +0000be50: 2073 6f6d 6520 6c69 6d69 7461 7469 6f6e some limitation │ │ │ │ │ +0000be60: 732e 2020 5768 696c 6520 6164 6469 6e67 s. While adding │ │ │ │ │ +0000be70: 2065 7874 7261 0a63 7573 746f 6d20 6d65 extra.custom me │ │ │ │ │ +0000be80: 6e75 2065 6e74 7269 6573 2074 6f20 7468 nu entries to th │ │ │ │ │ +0000be90: 6520 656e 6420 6f66 2074 6865 206c 6973 e end of the lis │ │ │ │ │ +0000bea0: 7420 6361 6e20 6265 2064 6f6e 6520 6279 t can be done by │ │ │ │ │ +0000beb0: 2065 6469 7469 6e67 0a27 2f65 7463 2f67 editing.'/etc/g │ │ │ │ │ +0000bec0: 7275 622e 642f 3430 5f63 7573 746f 6d27 rub.d/40_custom' │ │ │ │ │ +0000bed0: 206f 7220 6372 6561 7469 6e67 2027 2f62 or creating '/b │ │ │ │ │ +0000bee0: 6f6f 742f 6772 7562 2f63 7573 746f 6d2e oot/grub/custom. │ │ │ │ │ +0000bef0: 6366 6727 2c20 6368 616e 6769 6e67 0a74 cfg', changing.t │ │ │ │ │ +0000bf00: 6865 206f 7264 6572 206f 6620 6d65 6e75 he order of menu │ │ │ │ │ +0000bf10: 2065 6e74 7269 6573 206f 7220 6368 616e entries or chan │ │ │ │ │ +0000bf20: 6769 6e67 2074 6865 6972 2074 6974 6c65 ging their title │ │ │ │ │ +0000bf30: 7320 6d61 7920 7265 7175 6972 6520 6d61 s may require ma │ │ │ │ │ +0000bf40: 6b69 6e67 0a63 6f6d 706c 6578 2063 6861 king.complex cha │ │ │ │ │ +0000bf50: 6e67 6573 2074 6f20 7368 656c 6c20 7363 nges to shell sc │ │ │ │ │ +0000bf60: 7269 7074 7320 7374 6f72 6564 2069 6e20 ripts stored in │ │ │ │ │ +0000bf70: 272f 6574 632f 6772 7562 2e64 2f27 2e20 '/etc/grub.d/'. │ │ │ │ │ +0000bf80: 2054 6869 7320 6d61 7920 6265 0a69 6d70 This may be.imp │ │ │ │ │ +0000bf90: 726f 7665 6420 696e 2074 6865 2066 7574 roved in the fut │ │ │ │ │ +0000bfa0: 7572 652e 2020 496e 2074 6865 206d 6561 ure. In the mea │ │ │ │ │ +0000bfb0: 6e74 696d 652c 2074 686f 7365 2077 686f ntime, those who │ │ │ │ │ +0000bfc0: 2066 6565 6c20 7468 6174 2069 7420 776f feel that it wo │ │ │ │ │ +0000bfd0: 756c 640a 6265 2065 6173 6965 7220 746f uld.be easier to │ │ │ │ │ +0000bfe0: 2077 7269 7465 2027 6772 7562 2e63 6667 write 'grub.cfg │ │ │ │ │ +0000bff0: 2720 6469 7265 6374 6c79 2061 7265 2065 ' directly are e │ │ │ │ │ +0000c000: 6e63 6f75 7261 6765 6420 746f 2064 6f20 ncouraged to do │ │ │ │ │ +0000c010: 736f 2028 2a6e 6f74 650a 426f 6f74 696e so (*note.Bootin │ │ │ │ │ +0000c020: 673a 3a2c 2061 6e64 202a 6e6f 7465 2053 g::, and *note S │ │ │ │ │ +0000c030: 6865 6c6c 2d6c 696b 6520 7363 7269 7074 hell-like script │ │ │ │ │ +0000c040: 696e 673a 3a29 2c20 616e 6420 746f 2064 ing::), and to d │ │ │ │ │ +0000c050: 6973 6162 6c65 2061 6e79 2073 7973 7465 isable any syste │ │ │ │ │ +0000c060: 6d0a 7072 6f76 6964 6564 2062 7920 7468 m.provided by th │ │ │ │ │ +0000c070: 6569 7220 6469 7374 7269 6275 7469 6f6e eir distribution │ │ │ │ │ +0000c080: 2074 6f20 6175 746f 6d61 7469 6361 6c6c to automaticall │ │ │ │ │ +0000c090: 7920 7275 6e20 2767 7275 622d 6d6b 636f y run 'grub-mkco │ │ │ │ │ +0000c0a0: 6e66 6967 272e 0a0a 2020 2054 6865 2066 nfig'... The f │ │ │ │ │ +0000c0b0: 696c 6520 272f 6574 632f 6465 6661 756c ile '/etc/defaul │ │ │ │ │ +0000c0c0: 742f 6772 7562 2720 636f 6e74 726f 6c73 t/grub' controls │ │ │ │ │ +0000c0d0: 2074 6865 206f 7065 7261 7469 6f6e 206f the operation o │ │ │ │ │ +0000c0e0: 660a 2767 7275 622d 6d6b 636f 6e66 6967 f.'grub-mkconfig │ │ │ │ │ +0000c0f0: 272e 2020 4974 2069 7320 736f 7572 6365 '. It is source │ │ │ │ │ +0000c100: 6420 6279 2061 2073 6865 6c6c 2073 6372 d by a shell scr │ │ │ │ │ +0000c110: 6970 742c 2061 6e64 2073 6f20 6d75 7374 ipt, and so must │ │ │ │ │ +0000c120: 2062 6520 7661 6c69 640a 504f 5349 5820 be valid.POSIX │ │ │ │ │ +0000c130: 7368 656c 6c20 696e 7075 743b 206e 6f72 shell input; nor │ │ │ │ │ +0000c140: 6d61 6c6c 792c 2069 7420 7769 6c6c 206a mally, it will j │ │ │ │ │ +0000c150: 7573 7420 6265 2061 2073 6571 7565 6e63 ust be a sequenc │ │ │ │ │ +0000c160: 6520 6f66 2027 4b45 593d 7661 6c75 6527 e of 'KEY=value' │ │ │ │ │ +0000c170: 0a6c 696e 6573 2c20 6275 7420 6966 2074 .lines, but if t │ │ │ │ │ +0000c180: 6865 2076 616c 7565 2063 6f6e 7461 696e he value contain │ │ │ │ │ +0000c190: 7320 7370 6163 6573 206f 7220 6f74 6865 s spaces or othe │ │ │ │ │ +0000c1a0: 7220 7370 6563 6961 6c20 6368 6172 6163 r special charac │ │ │ │ │ +0000c1b0: 7465 7273 2074 6865 6e0a 6974 206d 7573 ters then.it mus │ │ │ │ │ +0000c1c0: 7420 6265 2071 756f 7465 642e 2020 466f t be quoted. Fo │ │ │ │ │ +0000c1d0: 7220 6578 616d 706c 653a 0a0a 2020 2020 r example:.. │ │ │ │ │ +0000c1e0: 2047 5255 425f 5445 524d 494e 414c 5f49 GRUB_TERMINAL_I │ │ │ │ │ +0000c1f0: 4e50 5554 3d22 636f 6e73 6f6c 6520 7365 NPUT="console se │ │ │ │ │ +0000c200: 7269 616c 220a 0a20 2020 5661 6c69 6420 rial".. Valid │ │ │ │ │ +0000c210: 6b65 7973 2069 6e20 272f 6574 632f 6465 keys in '/etc/de │ │ │ │ │ +0000c220: 6661 756c 742f 6772 7562 2720 6172 6520 fault/grub' are │ │ │ │ │ +0000c230: 6173 2066 6f6c 6c6f 7773 3a0a 0a27 4752 as follows:..'GR │ │ │ │ │ +0000c240: 5542 5f44 4546 4155 4c54 270a 2020 2020 UB_DEFAULT'. │ │ │ │ │ +0000c250: 2054 6865 2064 6566 6175 6c74 206d 656e The default men │ │ │ │ │ +0000c260: 7520 656e 7472 792e 2020 5468 6973 206d u entry. This m │ │ │ │ │ +0000c270: 6179 2062 6520 6120 6e75 6d62 6572 2c20 ay be a number, │ │ │ │ │ +0000c280: 696e 2077 6869 6368 2063 6173 6520 6974 in which case it │ │ │ │ │ +0000c290: 0a20 2020 2020 6964 656e 7469 6669 6573 . identifies │ │ │ │ │ +0000c2a0: 2074 6865 204e 7468 2065 6e74 7279 2069 the Nth entry i │ │ │ │ │ +0000c2b0: 6e20 7468 6520 6765 6e65 7261 7465 6420 n the generated │ │ │ │ │ +0000c2c0: 6d65 6e75 2063 6f75 6e74 6564 2066 726f menu counted fro │ │ │ │ │ +0000c2d0: 6d20 7a65 726f 2c0a 2020 2020 206f 7220 m zero,. or │ │ │ │ │ +0000c2e0: 7468 6520 7469 746c 6520 6f66 2061 206d the title of a m │ │ │ │ │ +0000c2f0: 656e 7520 656e 7472 792c 206f 7220 7468 enu entry, or th │ │ │ │ │ +0000c300: 6520 7370 6563 6961 6c20 7374 7269 6e67 e special string │ │ │ │ │ +0000c310: 2027 7361 7665 6427 2e20 2055 7369 6e67 'saved'. Using │ │ │ │ │ +0000c320: 0a20 2020 2020 7468 6520 6964 206d 6179 . the id may │ │ │ │ │ +0000c330: 2062 6520 7573 6566 756c 2069 6620 796f be useful if yo │ │ │ │ │ +0000c340: 7520 7761 6e74 2074 6f20 7365 7420 6120 u want to set a │ │ │ │ │ +0000c350: 6d65 6e75 2065 6e74 7279 2061 7320 7468 menu entry as th │ │ │ │ │ +0000c360: 6520 6465 6661 756c 740a 2020 2020 2065 e default. e │ │ │ │ │ +0000c370: 7665 6e20 7468 6f75 6768 2074 6865 7265 ven though there │ │ │ │ │ +0000c380: 206d 6179 2062 6520 6120 7661 7269 6162 may be a variab │ │ │ │ │ +0000c390: 6c65 206e 756d 6265 7220 6f66 2065 6e74 le number of ent │ │ │ │ │ +0000c3a0: 7269 6573 2062 6566 6f72 6520 6974 2e0a ries before it.. │ │ │ │ │ +0000c3b0: 0a20 2020 2020 466f 7220 6578 616d 706c . For exampl │ │ │ │ │ +0000c3c0: 652c 2069 6620 796f 7520 6861 7665 3a0a e, if you have:. │ │ │ │ │ +0000c3d0: 0a20 2020 2020 6d65 6e75 656e 7472 7920 . menuentry │ │ │ │ │ +0000c3e0: 2745 7861 6d70 6c65 2047 4e55 2f4c 696e 'Example GNU/Lin │ │ │ │ │ +0000c3f0: 7578 2064 6973 7472 6962 7574 696f 6e27 ux distribution' │ │ │ │ │ +0000c400: 202d 2d63 6c61 7373 2067 6e75 2d6c 696e --class gnu-lin │ │ │ │ │ +0000c410: 7578 202d 2d69 6420 6578 616d 706c 652d ux --id example- │ │ │ │ │ +0000c420: 676e 752d 6c69 6e75 7820 7b0a 2020 2020 gnu-linux {. │ │ │ │ │ +0000c430: 2009 2e2e 2e0a 2020 2020 207d 0a0a 2020 ..... }.. │ │ │ │ │ +0000c440: 2020 2074 6865 6e20 796f 7520 6361 6e20 then you can │ │ │ │ │ +0000c450: 6d61 6b65 2074 6869 7320 7468 6520 6465 make this the de │ │ │ │ │ +0000c460: 6661 756c 7420 7573 696e 673a 0a0a 2020 fault using:.. │ │ │ │ │ +0000c470: 2020 2020 2020 2020 4752 5542 5f44 4546 GRUB_DEF │ │ │ │ │ +0000c480: 4155 4c54 3d65 7861 6d70 6c65 2d67 6e75 AULT=example-gnu │ │ │ │ │ +0000c490: 2d6c 696e 7578 0a0a 2020 2020 2050 7265 -linux.. Pre │ │ │ │ │ +0000c4a0: 7669 6f75 736c 7920 6974 2077 6173 2064 viously it was d │ │ │ │ │ +0000c4b0: 6f63 756d 656e 7465 6420 7468 6520 7761 ocumented the wa │ │ │ │ │ +0000c4c0: 7920 746f 2075 7365 2065 6e74 7279 2074 y to use entry t │ │ │ │ │ +0000c4d0: 6974 6c65 2e20 2057 6869 6c65 0a20 2020 itle. While. │ │ │ │ │ +0000c4e0: 2020 7468 6973 2073 7469 6c6c 2077 6f72 this still wor │ │ │ │ │ +0000c4f0: 6b73 2069 7427 7320 6e6f 7420 7265 636f ks it's not reco │ │ │ │ │ +0000c500: 6d6d 656e 6465 6420 7369 6e63 6520 7469 mmended since ti │ │ │ │ │ +0000c510: 746c 6573 206f 6674 656e 2063 6f6e 7461 tles often conta │ │ │ │ │ +0000c520: 696e 0a20 2020 2020 756e 7374 6162 6c65 in. unstable │ │ │ │ │ +0000c530: 2064 6576 6963 6520 6e61 6d65 7320 616e device names an │ │ │ │ │ +0000c540: 6420 6d61 7920 6265 2074 7261 6e73 6c61 d may be transla │ │ │ │ │ +0000c550: 7465 640a 0a20 2020 2020 4966 2079 6f75 ted.. If you │ │ │ │ │ +0000c560: 2073 6574 2074 6869 7320 746f 2027 7361 set this to 'sa │ │ │ │ │ +0000c570: 7665 6427 2c20 7468 656e 2074 6865 2064 ved', then the d │ │ │ │ │ +0000c580: 6566 6175 6c74 206d 656e 7520 656e 7472 efault menu entr │ │ │ │ │ +0000c590: 7920 7769 6c6c 2062 650a 2020 2020 2074 y will be. t │ │ │ │ │ +0000c5a0: 6861 7420 7361 7665 6420 6279 2027 4752 hat saved by 'GR │ │ │ │ │ +0000c5b0: 5542 5f53 4156 4544 4546 4155 4c54 2720 UB_SAVEDEFAULT' │ │ │ │ │ +0000c5c0: 6f72 2027 6772 7562 2d73 6574 2d64 6566 or 'grub-set-def │ │ │ │ │ +0000c5d0: 6175 6c74 272e 2020 5468 6973 0a20 2020 ault'. This. │ │ │ │ │ +0000c5e0: 2020 7265 6c69 6573 206f 6e20 7468 6520 relies on the │ │ │ │ │ +0000c5f0: 656e 7669 726f 6e6d 656e 7420 626c 6f63 environment bloc │ │ │ │ │ +0000c600: 6b2c 2077 6869 6368 206d 6179 206e 6f74 k, which may not │ │ │ │ │ +0000c610: 2062 6520 6176 6169 6c61 626c 6520 696e be available in │ │ │ │ │ +0000c620: 2061 6c6c 0a20 2020 2020 7369 7475 6174 all. situat │ │ │ │ │ +0000c630: 696f 6e73 2028 2a6e 6f74 6520 456e 7669 ions (*note Envi │ │ │ │ │ +0000c640: 726f 6e6d 656e 7420 626c 6f63 6b3a 3a29 ronment block::) │ │ │ │ │ +0000c650: 2e0a 0a20 2020 2020 5468 6520 6465 6661 ... The defa │ │ │ │ │ +0000c660: 756c 7420 6973 2027 3027 2e0a 0a27 4752 ult is '0'...'GR │ │ │ │ │ +0000c670: 5542 5f53 4156 4544 4546 4155 4c54 270a UB_SAVEDEFAULT'. │ │ │ │ │ +0000c680: 2020 2020 2049 6620 7468 6973 206f 7074 If this opt │ │ │ │ │ +0000c690: 696f 6e20 6973 2073 6574 2074 6f20 2774 ion is set to 't │ │ │ │ │ +0000c6a0: 7275 6527 2c20 7468 656e 2c20 7768 656e rue', then, when │ │ │ │ │ +0000c6b0: 2061 6e20 656e 7472 7920 6973 2073 656c an entry is sel │ │ │ │ │ +0000c6c0: 6563 7465 642c 0a20 2020 2020 7361 7665 ected,. save │ │ │ │ │ +0000c6d0: 2069 7420 6173 2061 206e 6577 2064 6566 it as a new def │ │ │ │ │ +0000c6e0: 6175 6c74 2065 6e74 7279 2066 6f72 2075 ault entry for u │ │ │ │ │ +0000c6f0: 7365 2062 7920 6675 7475 7265 2072 756e se by future run │ │ │ │ │ +0000c700: 7320 6f66 2047 5255 422e 2054 6869 730a s of GRUB. This. │ │ │ │ │ +0000c710: 2020 2020 2069 7320 6f6e 6c79 2075 7365 is only use │ │ │ │ │ +0000c720: 6675 6c20 6966 2027 4752 5542 5f44 4546 ful if 'GRUB_DEF │ │ │ │ │ +0000c730: 4155 4c54 3d73 6176 6564 273b 2069 7420 AULT=saved'; it │ │ │ │ │ +0000c740: 6973 2061 2073 6570 6172 6174 6520 6f70 is a separate op │ │ │ │ │ +0000c750: 7469 6f6e 0a20 2020 2020 6265 6361 7573 tion. becaus │ │ │ │ │ +0000c760: 6520 2747 5255 425f 4445 4641 554c 543d e 'GRUB_DEFAULT= │ │ │ │ │ +0000c770: 7361 7665 6427 2069 7320 7573 6566 756c saved' is useful │ │ │ │ │ +0000c780: 2077 6974 686f 7574 2074 6869 7320 6f70 without this op │ │ │ │ │ +0000c790: 7469 6f6e 2c20 696e 0a20 2020 2020 636f tion, in. co │ │ │ │ │ +0000c7a0: 6e6a 756e 6374 696f 6e20 7769 7468 2027 njunction with ' │ │ │ │ │ +0000c7b0: 6772 7562 2d73 6574 2d64 6566 6175 6c74 grub-set-default │ │ │ │ │ +0000c7c0: 272e 2020 556e 7365 7420 6279 2064 6566 '. Unset by def │ │ │ │ │ +0000c7d0: 6175 6c74 2e20 2054 6869 730a 2020 2020 ault. This. │ │ │ │ │ +0000c7e0: 206f 7074 696f 6e20 7265 6c69 6573 206f option relies o │ │ │ │ │ +0000c7f0: 6e20 7468 6520 656e 7669 726f 6e6d 656e n the environmen │ │ │ │ │ +0000c800: 7420 626c 6f63 6b2c 2077 6869 6368 206d t block, which m │ │ │ │ │ +0000c810: 6179 206e 6f74 2062 6520 6176 6169 6c61 ay not be availa │ │ │ │ │ +0000c820: 626c 650a 2020 2020 2069 6e20 616c 6c20 ble. in all │ │ │ │ │ +0000c830: 7369 7475 6174 696f 6e73 2028 2a6e 6f74 situations (*not │ │ │ │ │ +0000c840: 6520 456e 7669 726f 6e6d 656e 7420 626c e Environment bl │ │ │ │ │ +0000c850: 6f63 6b3a 3a29 2e0a 0a27 4752 5542 5f54 ock::)...'GRUB_T │ │ │ │ │ +0000c860: 494d 454f 5554 270a 2020 2020 2042 6f6f IMEOUT'. Boo │ │ │ │ │ +0000c870: 7420 7468 6520 6465 6661 756c 7420 656e t the default en │ │ │ │ │ +0000c880: 7472 7920 7468 6973 206d 616e 7920 7365 try this many se │ │ │ │ │ +0000c890: 636f 6e64 7320 6166 7465 7220 7468 6520 conds after the │ │ │ │ │ +0000c8a0: 6d65 6e75 2069 730a 2020 2020 2064 6973 menu is. dis │ │ │ │ │ +0000c8b0: 706c 6179 6564 2c20 756e 6c65 7373 2061 played, unless a │ │ │ │ │ +0000c8c0: 206b 6579 2069 7320 7072 6573 7365 642e key is pressed. │ │ │ │ │ +0000c8d0: 2020 5468 6520 6465 6661 756c 7420 6973 The default is │ │ │ │ │ +0000c8e0: 2027 3527 2e20 2053 6574 2074 6f0a 2020 '5'. Set to. │ │ │ │ │ +0000c8f0: 2020 2027 3027 2074 6f20 626f 6f74 2069 '0' to boot i │ │ │ │ │ +0000c900: 6d6d 6564 6961 7465 6c79 2077 6974 686f mmediately witho │ │ │ │ │ +0000c910: 7574 2064 6973 706c 6179 696e 6720 7468 ut displaying th │ │ │ │ │ +0000c920: 6520 6d65 6e75 2c20 6f72 2074 6f20 272d e menu, or to '- │ │ │ │ │ +0000c930: 3127 2074 6f0a 2020 2020 2077 6169 7420 1' to. wait │ │ │ │ │ +0000c940: 696e 6465 6669 6e69 7465 6c79 2e0a 0a20 indefinitely... │ │ │ │ │ +0000c950: 2020 2020 4966 2027 4752 5542 5f54 494d If 'GRUB_TIM │ │ │ │ │ +0000c960: 454f 5554 5f53 5459 4c45 2720 6973 2073 EOUT_STYLE' is s │ │ │ │ │ +0000c970: 6574 2074 6f20 2763 6f75 6e74 646f 776e et to 'countdown │ │ │ │ │ +0000c980: 2720 6f72 2027 6869 6464 656e 272c 2074 ' or 'hidden', t │ │ │ │ │ +0000c990: 6865 0a20 2020 2020 7469 6d65 6f75 7420 he. timeout │ │ │ │ │ +0000c9a0: 6973 2069 6e73 7465 6164 2063 6f75 6e74 is instead count │ │ │ │ │ +0000c9b0: 6564 2062 6566 6f72 6520 7468 6520 6d65 ed before the me │ │ │ │ │ +0000c9c0: 6e75 2069 7320 6469 7370 6c61 7965 642e nu is displayed. │ │ │ │ │ +0000c9d0: 0a0a 2747 5255 425f 5449 4d45 4f55 545f ..'GRUB_TIMEOUT_ │ │ │ │ │ +0000c9e0: 5354 594c 4527 0a20 2020 2020 4966 2074 STYLE'. If t │ │ │ │ │ +0000c9f0: 6869 7320 6f70 7469 6f6e 2069 7320 756e his option is un │ │ │ │ │ +0000ca00: 7365 7420 6f72 2073 6574 2074 6f20 276d set or set to 'm │ │ │ │ │ +0000ca10: 656e 7527 2c20 7468 656e 2047 5255 4220 enu', then GRUB │ │ │ │ │ +0000ca20: 7769 6c6c 2064 6973 706c 6179 0a20 2020 will display. │ │ │ │ │ +0000ca30: 2020 7468 6520 6d65 6e75 2061 6e64 2074 the menu and t │ │ │ │ │ +0000ca40: 6865 6e20 7761 6974 2066 6f72 2074 6865 hen wait for the │ │ │ │ │ +0000ca50: 2074 696d 656f 7574 2073 6574 2062 7920 timeout set by │ │ │ │ │ +0000ca60: 2747 5255 425f 5449 4d45 4f55 5427 2074 'GRUB_TIMEOUT' t │ │ │ │ │ +0000ca70: 6f0a 2020 2020 2065 7870 6972 6520 6265 o. expire be │ │ │ │ │ +0000ca80: 666f 7265 2062 6f6f 7469 6e67 2074 6865 fore booting the │ │ │ │ │ +0000ca90: 2064 6566 6175 6c74 2065 6e74 7279 2e20 default entry. │ │ │ │ │ +0000caa0: 2050 7265 7373 696e 6720 6120 6b65 7920 Pressing a key │ │ │ │ │ +0000cab0: 696e 7465 7272 7570 7473 0a20 2020 2020 interrupts. │ │ │ │ │ +0000cac0: 7468 6520 7469 6d65 6f75 742e 0a0a 2020 the timeout... │ │ │ │ │ +0000cad0: 2020 2049 6620 7468 6973 206f 7074 696f If this optio │ │ │ │ │ +0000cae0: 6e20 6973 2073 6574 2074 6f20 2763 6f75 n is set to 'cou │ │ │ │ │ +0000caf0: 6e74 646f 776e 2720 6f72 2027 6869 6464 ntdown' or 'hidd │ │ │ │ │ +0000cb00: 656e 272c 2074 6865 6e2c 2062 6566 6f72 en', then, befor │ │ │ │ │ +0000cb10: 650a 2020 2020 2064 6973 706c 6179 696e e. displayin │ │ │ │ │ +0000cb20: 6720 7468 6520 6d65 6e75 2c20 4752 5542 g the menu, GRUB │ │ │ │ │ +0000cb30: 2077 696c 6c20 7761 6974 2066 6f72 2074 will wait for t │ │ │ │ │ +0000cb40: 6865 2074 696d 656f 7574 2073 6574 2062 he timeout set b │ │ │ │ │ +0000cb50: 790a 2020 2020 2027 4752 5542 5f54 494d y. 'GRUB_TIM │ │ │ │ │ +0000cb60: 454f 5554 2720 746f 2065 7870 6972 652e EOUT' to expire. │ │ │ │ │ +0000cb70: 2020 4966 203c 4553 433e 206f 7220 3c46 If or are pressed, │ │ │ │ │ +0000cb90: 6f72 203c 5348 4946 543e 0a20 2020 2020 or . │ │ │ │ │ +0000cba0: 6973 2068 656c 6420 646f 776e 2064 7572 is held down dur │ │ │ │ │ +0000cbb0: 696e 6720 7468 6174 2074 696d 652c 2069 ing that time, i │ │ │ │ │ +0000cbc0: 7420 7769 6c6c 2064 6973 706c 6179 2074 t will display t │ │ │ │ │ +0000cbd0: 6865 206d 656e 7520 616e 6420 7761 6974 he menu and wait │ │ │ │ │ +0000cbe0: 0a20 2020 2020 666f 7220 696e 7075 742e . for input. │ │ │ │ │ +0000cbf0: 2020 4966 2061 2068 6f74 6b65 7920 6173 If a hotkey as │ │ │ │ │ +0000cc00: 736f 6369 6174 6564 2077 6974 6820 6120 sociated with a │ │ │ │ │ +0000cc10: 6d65 6e75 2065 6e74 7279 2069 7320 7072 menu entry is pr │ │ │ │ │ +0000cc20: 6573 7365 642c 2069 740a 2020 2020 2077 essed, it. w │ │ │ │ │ +0000cc30: 696c 6c20 626f 6f74 2074 6865 2061 7373 ill boot the ass │ │ │ │ │ +0000cc40: 6f63 6961 7465 6420 6d65 6e75 2065 6e74 ociated menu ent │ │ │ │ │ +0000cc50: 7279 2069 6d6d 6564 6961 7465 6c79 2e20 ry immediately. │ │ │ │ │ +0000cc60: 2049 6620 7468 6520 7469 6d65 6f75 740a If the timeout. │ │ │ │ │ +0000cc70: 2020 2020 2065 7870 6972 6573 2062 6566 expires bef │ │ │ │ │ +0000cc80: 6f72 6520 6569 7468 6572 206f 6620 7468 ore either of th │ │ │ │ │ +0000cc90: 6573 6520 6861 7070 656e 732c 2069 7420 ese happens, it │ │ │ │ │ +0000cca0: 7769 6c6c 2062 6f6f 7420 7468 6520 6465 will boot the de │ │ │ │ │ +0000ccb0: 6661 756c 740a 2020 2020 2065 6e74 7279 fault. entry │ │ │ │ │ +0000ccc0: 2e20 2049 6e20 7468 6520 2763 6f75 6e74 . In the 'count │ │ │ │ │ +0000ccd0: 646f 776e 2720 6361 7365 2c20 6974 2077 down' case, it w │ │ │ │ │ +0000cce0: 696c 6c20 7368 6f77 2061 206f 6e65 2d6c ill show a one-l │ │ │ │ │ +0000ccf0: 696e 6520 696e 6469 6361 7469 6f6e 0a20 ine indication. │ │ │ │ │ +0000cd00: 2020 2020 6f66 2074 6865 2072 656d 6169 of the remai │ │ │ │ │ +0000cd10: 6e69 6e67 2074 696d 652e 0a0a 2747 5255 ning time...'GRU │ │ │ │ │ +0000cd20: 425f 4445 4641 554c 545f 4255 5454 4f4e B_DEFAULT_BUTTON │ │ │ │ │ +0000cd30: 270a 2747 5255 425f 5449 4d45 4f55 545f '.'GRUB_TIMEOUT_ │ │ │ │ │ +0000cd40: 4255 5454 4f4e 270a 2747 5255 425f 5449 BUTTON'.'GRUB_TI │ │ │ │ │ +0000cd50: 4d45 4f55 545f 5354 594c 455f 4255 5454 MEOUT_STYLE_BUTT │ │ │ │ │ +0000cd60: 4f4e 270a 2747 5255 425f 4255 5454 4f4e ON'.'GRUB_BUTTON │ │ │ │ │ +0000cd70: 5f43 4d4f 535f 4144 4452 4553 5327 0a20 _CMOS_ADDRESS'. │ │ │ │ │ +0000cd80: 2020 2020 5661 7269 616e 7473 206f 6620 Variants of │ │ │ │ │ +0000cd90: 7468 6520 636f 7272 6573 706f 6e64 696e the correspondin │ │ │ │ │ +0000cda0: 6720 7661 7269 6162 6c65 7320 7769 7468 g variables with │ │ │ │ │ +0000cdb0: 6f75 7420 7468 6520 275f 4255 5454 4f4e out the '_BUTTON │ │ │ │ │ +0000cdc0: 270a 2020 2020 2073 7566 6669 782c 2075 '. suffix, u │ │ │ │ │ +0000cdd0: 7365 6420 746f 2073 7570 706f 7274 2076 sed to support v │ │ │ │ │ +0000cde0: 656e 646f 722d 7370 6563 6966 6963 2070 endor-specific p │ │ │ │ │ +0000cdf0: 6f77 6572 2062 7574 746f 6e73 2e20 202a ower buttons. * │ │ │ │ │ +0000ce00: 4e6f 7465 0a20 2020 2020 5665 6e64 6f72 Note. Vendor │ │ │ │ │ +0000ce10: 2070 6f77 6572 2d6f 6e20 6b65 7973 3a3a power-on keys:: │ │ │ │ │ +0000ce20: 2e0a 0a27 4752 5542 5f44 4953 5452 4942 ...'GRUB_DISTRIB │ │ │ │ │ +0000ce30: 5554 4f52 270a 2020 2020 2053 6574 2062 UTOR'. Set b │ │ │ │ │ +0000ce40: 7920 6469 7374 7269 6275 746f 7273 206f y distributors o │ │ │ │ │ +0000ce50: 6620 4752 5542 2074 6f20 7468 6569 7220 f GRUB to their │ │ │ │ │ +0000ce60: 6964 656e 7469 6679 696e 6720 6e61 6d65 identifying name │ │ │ │ │ +0000ce70: 2e20 2054 6869 7320 6973 0a20 2020 2020 . This is. │ │ │ │ │ +0000ce80: 7573 6564 2074 6f20 6765 6e65 7261 7465 used to generate │ │ │ │ │ +0000ce90: 206d 6f72 6520 696e 666f 726d 6174 6976 more informativ │ │ │ │ │ +0000cea0: 6520 6d65 6e75 2065 6e74 7279 2074 6974 e menu entry tit │ │ │ │ │ +0000ceb0: 6c65 732e 0a0a 2747 5255 425f 5445 524d les...'GRUB_TERM │ │ │ │ │ +0000cec0: 494e 414c 5f49 4e50 5554 270a 2020 2020 INAL_INPUT'. │ │ │ │ │ +0000ced0: 2053 656c 6563 7420 7468 6520 7465 726d Select the term │ │ │ │ │ +0000cee0: 696e 616c 2069 6e70 7574 2064 6576 6963 inal input devic │ │ │ │ │ +0000cef0: 652e 2020 596f 7520 6d61 7920 7365 6c65 e. You may sele │ │ │ │ │ +0000cf00: 6374 206d 756c 7469 706c 6520 6465 7669 ct multiple devi │ │ │ │ │ +0000cf10: 6365 730a 2020 2020 2068 6572 652c 2073 ces. here, s │ │ │ │ │ +0000cf20: 6570 6172 6174 6564 2062 7920 7370 6163 eparated by spac │ │ │ │ │ +0000cf30: 6573 2e0a 0a20 2020 2020 5661 6c69 6420 es... Valid │ │ │ │ │ +0000cf40: 7465 726d 696e 616c 2069 6e70 7574 206e terminal input n │ │ │ │ │ +0000cf50: 616d 6573 2064 6570 656e 6420 6f6e 2074 ames depend on t │ │ │ │ │ +0000cf60: 6865 2070 6c61 7466 6f72 6d2c 2062 7574 he platform, but │ │ │ │ │ +0000cf70: 206d 6179 2069 6e63 6c75 6465 0a20 2020 may include. │ │ │ │ │ +0000cf80: 2020 2763 6f6e 736f 6c65 2720 286e 6174 'console' (nat │ │ │ │ │ +0000cf90: 6976 6520 706c 6174 666f 726d 2063 6f6e ive platform con │ │ │ │ │ +0000cfa0: 736f 6c65 292c 2027 7365 7269 616c 2720 sole), 'serial' │ │ │ │ │ +0000cfb0: 2873 6572 6961 6c20 7465 726d 696e 616c (serial terminal │ │ │ │ │ +0000cfc0: 292c 0a20 2020 2020 2773 6572 6961 6c5f ),. 'serial_ │ │ │ │ │ +0000cfd0: 3c70 6f72 743e 2720 2873 6572 6961 6c20 ' (serial │ │ │ │ │ +0000cfe0: 7465 726d 696e 616c 2077 6974 6820 6578 terminal with ex │ │ │ │ │ +0000cff0: 706c 6963 6974 2070 6f72 7420 7365 6c65 plicit port sele │ │ │ │ │ +0000d000: 6374 696f 6e29 2c0a 2020 2020 2027 6174 ction),. 'at │ │ │ │ │ +0000d010: 5f6b 6579 626f 6172 6427 2028 5043 2041 _keyboard' (PC A │ │ │ │ │ +0000d020: 5420 6b65 7962 6f61 7264 292c 206f 7220 T keyboard), or │ │ │ │ │ +0000d030: 2775 7362 5f6b 6579 626f 6172 6427 2028 'usb_keyboard' ( │ │ │ │ │ +0000d040: 5553 4220 6b65 7962 6f61 7264 0a20 2020 USB keyboard. │ │ │ │ │ +0000d050: 2020 7573 696e 6720 7468 6520 4849 4420 using the HID │ │ │ │ │ +0000d060: 426f 6f74 2050 726f 746f 636f 6c2c 2066 Boot Protocol, f │ │ │ │ │ +0000d070: 6f72 2063 6173 6573 2077 6865 7265 2074 or cases where t │ │ │ │ │ +0000d080: 6865 2066 6972 6d77 6172 6520 646f 6573 he firmware does │ │ │ │ │ +0000d090: 206e 6f74 0a20 2020 2020 6861 6e64 6c65 not. handle │ │ │ │ │ +0000d0a0: 2074 6869 7329 2e0a 0a20 2020 2020 5468 this)... Th │ │ │ │ │ +0000d0b0: 6520 6465 6661 756c 7420 6973 2074 6f20 e default is to │ │ │ │ │ +0000d0c0: 7573 6520 7468 6520 706c 6174 666f 726d use the platform │ │ │ │ │ +0000d0d0: 2773 206e 6174 6976 6520 7465 726d 696e 's native termin │ │ │ │ │ +0000d0e0: 616c 2069 6e70 7574 2e0a 0a27 4752 5542 al input...'GRUB │ │ │ │ │ +0000d0f0: 5f54 4552 4d49 4e41 4c5f 4f55 5450 5554 _TERMINAL_OUTPUT │ │ │ │ │ +0000d100: 270a 2020 2020 2053 656c 6563 7420 7468 '. Select th │ │ │ │ │ +0000d110: 6520 7465 726d 696e 616c 206f 7574 7075 e terminal outpu │ │ │ │ │ +0000d120: 7420 6465 7669 6365 2e20 2059 6f75 206d t device. You m │ │ │ │ │ +0000d130: 6179 2073 656c 6563 7420 6d75 6c74 6970 ay select multip │ │ │ │ │ +0000d140: 6c65 2064 6576 6963 6573 0a20 2020 2020 le devices. │ │ │ │ │ +0000d150: 6865 7265 2c20 7365 7061 7261 7465 6420 here, separated │ │ │ │ │ +0000d160: 6279 2073 7061 6365 732e 0a0a 2020 2020 by spaces... │ │ │ │ │ +0000d170: 2056 616c 6964 2074 6572 6d69 6e61 6c20 Valid terminal │ │ │ │ │ +0000d180: 6f75 7470 7574 206e 616d 6573 2064 6570 output names dep │ │ │ │ │ +0000d190: 656e 6420 6f6e 2074 6865 2070 6c61 7466 end on the platf │ │ │ │ │ +0000d1a0: 6f72 6d2c 2062 7574 206d 6179 2069 6e63 orm, but may inc │ │ │ │ │ +0000d1b0: 6c75 6465 0a20 2020 2020 2763 6f6e 736f lude. 'conso │ │ │ │ │ +0000d1c0: 6c65 2720 286e 6174 6976 6520 706c 6174 le' (native plat │ │ │ │ │ +0000d1d0: 666f 726d 2063 6f6e 736f 6c65 292c 2027 form console), ' │ │ │ │ │ +0000d1e0: 7365 7269 616c 2720 2873 6572 6961 6c20 serial' (serial │ │ │ │ │ +0000d1f0: 7465 726d 696e 616c 292c 0a20 2020 2020 terminal),. │ │ │ │ │ +0000d200: 2773 6572 6961 6c5f 3c70 6f72 743e 2720 'serial_' │ │ │ │ │ +0000d210: 2873 6572 6961 6c20 7465 726d 696e 616c (serial terminal │ │ │ │ │ +0000d220: 2077 6974 6820 6578 706c 6963 6974 2070 with explicit p │ │ │ │ │ +0000d230: 6f72 7420 7365 6c65 6374 696f 6e29 2c0a ort selection),. │ │ │ │ │ +0000d240: 2020 2020 2027 6766 7874 6572 6d27 2028 'gfxterm' ( │ │ │ │ │ +0000d250: 6772 6170 6869 6373 2d6d 6f64 6520 6f75 graphics-mode ou │ │ │ │ │ +0000d260: 7470 7574 292c 2027 7667 615f 7465 7874 tput), 'vga_text │ │ │ │ │ +0000d270: 2720 2856 4741 2074 6578 7420 6f75 7470 ' (VGA text outp │ │ │ │ │ +0000d280: 7574 292c 0a20 2020 2020 276d 6461 5f74 ut),. 'mda_t │ │ │ │ │ +0000d290: 6578 7427 2028 4d44 4120 7465 7874 206f ext' (MDA text o │ │ │ │ │ +0000d2a0: 7574 7075 7429 2c20 276d 6f72 7365 2720 utput), 'morse' │ │ │ │ │ +0000d2b0: 284d 6f72 7365 2d63 6f64 696e 6720 7573 (Morse-coding us │ │ │ │ │ +0000d2c0: 696e 6720 7379 7374 656d 0a20 2020 2020 ing system. │ │ │ │ │ +0000d2d0: 6265 6570 6572 2920 6f72 2027 7370 6b6d beeper) or 'spkm │ │ │ │ │ +0000d2e0: 6f64 656d 2720 2873 696d 706c 6520 6461 odem' (simple da │ │ │ │ │ +0000d2f0: 7461 2070 726f 746f 636f 6c20 7573 696e ta protocol usin │ │ │ │ │ +0000d300: 6720 7379 7374 656d 2073 7065 616b 6572 g system speaker │ │ │ │ │ +0000d310: 292e 0a0a 2020 2020 2027 7370 6b6d 6f64 )... 'spkmod │ │ │ │ │ +0000d320: 656d 2720 6973 2075 7365 6675 6c20 7768 em' is useful wh │ │ │ │ │ +0000d330: 656e 206e 6f20 7365 7269 616c 2070 6f72 en no serial por │ │ │ │ │ +0000d340: 7420 6973 2061 7661 696c 6162 6c65 2e20 t is available. │ │ │ │ │ +0000d350: 2043 6f6e 6e65 6374 2074 6865 0a20 2020 Connect the. │ │ │ │ │ +0000d360: 2020 6f75 7470 7574 206f 6620 7365 6e64 output of send │ │ │ │ │ +0000d370: 696e 6720 7379 7374 656d 2028 7768 6572 ing system (wher │ │ │ │ │ +0000d380: 6520 4752 5542 2069 7320 7275 6e6e 696e e GRUB is runnin │ │ │ │ │ +0000d390: 6729 2074 6f20 6c69 6e65 2d69 6e20 6f66 g) to line-in of │ │ │ │ │ +0000d3a0: 0a20 2020 2020 7265 6365 6976 696e 6720 . receiving │ │ │ │ │ +0000d3b0: 7379 7374 656d 2028 7573 7561 6c6c 7920 system (usually │ │ │ │ │ +0000d3c0: 6465 7665 6c6f 7065 7220 6d61 6368 696e developer machin │ │ │ │ │ +0000d3d0: 6529 2e20 204f 6e20 7265 6365 6976 696e e). On receivin │ │ │ │ │ +0000d3e0: 6720 7379 7374 656d 0a20 2020 2020 636f g system. co │ │ │ │ │ +0000d3f0: 6d70 696c 6520 2773 706b 6d6f 6465 6d2d mpile 'spkmodem- │ │ │ │ │ +0000d400: 7265 6376 2720 6672 6f6d 2027 7574 696c recv' from 'util │ │ │ │ │ +0000d410: 2f73 706b 6d6f 6465 6d2d 7265 6376 2e63 /spkmodem-recv.c │ │ │ │ │ +0000d420: 2720 616e 6420 7275 6e3a 0a0a 2020 2020 ' and run:.. │ │ │ │ │ +0000d430: 2020 2020 2020 7061 7265 636f 7264 202d parecord - │ │ │ │ │ +0000d440: 2d63 6861 6e6e 656c 733d 3120 2d2d 7261 -channels=1 --ra │ │ │ │ │ +0000d450: 7465 3d34 3830 3030 202d 2d66 6f72 6d61 te=48000 --forma │ │ │ │ │ +0000d460: 743d 7331 366c 6520 7c20 2e2f 7370 6b6d t=s16le | ./spkm │ │ │ │ │ +0000d470: 6f64 656d 2d72 6563 760a 0a20 2020 2020 odem-recv.. │ │ │ │ │ +0000d480: 5468 6520 6465 6661 756c 7420 6973 2074 The default is t │ │ │ │ │ +0000d490: 6f20 7573 6520 7468 6520 706c 6174 666f o use the platfo │ │ │ │ │ +0000d4a0: 726d 2773 206e 6174 6976 6520 7465 726d rm's native term │ │ │ │ │ +0000d4b0: 696e 616c 206f 7574 7075 742e 0a0a 2747 inal output...'G │ │ │ │ │ +0000d4c0: 5255 425f 5445 524d 494e 414c 270a 2020 RUB_TERMINAL'. │ │ │ │ │ +0000d4d0: 2020 2049 6620 7468 6973 206f 7074 696f If this optio │ │ │ │ │ +0000d4e0: 6e20 6973 2073 6574 2c20 6974 206f 7665 n is set, it ove │ │ │ │ │ +0000d4f0: 7272 6964 6573 2062 6f74 6820 2747 5255 rrides both 'GRU │ │ │ │ │ +0000d500: 425f 5445 524d 494e 414c 5f49 4e50 5554 B_TERMINAL_INPUT │ │ │ │ │ +0000d510: 2720 616e 640a 2020 2020 2027 4752 5542 ' and. 'GRUB │ │ │ │ │ +0000d520: 5f54 4552 4d49 4e41 4c5f 4f55 5450 5554 _TERMINAL_OUTPUT │ │ │ │ │ +0000d530: 2720 746f 2074 6865 2073 616d 6520 7661 ' to the same va │ │ │ │ │ +0000d540: 6c75 652e 0a0a 2747 5255 425f 5345 5249 lue...'GRUB_SERI │ │ │ │ │ +0000d550: 414c 5f43 4f4d 4d41 4e44 270a 2020 2020 AL_COMMAND'. │ │ │ │ │ +0000d560: 2041 2063 6f6d 6d61 6e64 2074 6f20 636f A command to co │ │ │ │ │ +0000d570: 6e66 6967 7572 6520 7468 6520 7365 7269 nfigure the seri │ │ │ │ │ +0000d580: 616c 2070 6f72 7420 7768 656e 2075 7369 al port when usi │ │ │ │ │ +0000d590: 6e67 2074 6865 2073 6572 6961 6c0a 2020 ng the serial. │ │ │ │ │ +0000d5a0: 2020 2063 6f6e 736f 6c65 2e20 202a 4e6f console. *No │ │ │ │ │ +0000d5b0: 7465 2073 6572 6961 6c3a 3a2e 2020 4465 te serial::. De │ │ │ │ │ +0000d5c0: 6661 756c 7473 2074 6f20 2773 6572 6961 faults to 'seria │ │ │ │ │ +0000d5d0: 6c27 2e0a 0a27 4752 5542 5f43 4d44 4c49 l'...'GRUB_CMDLI │ │ │ │ │ +0000d5e0: 4e45 5f4c 494e 5558 270a 2020 2020 2043 NE_LINUX'. C │ │ │ │ │ +0000d5f0: 6f6d 6d61 6e64 2d6c 696e 6520 6172 6775 ommand-line argu │ │ │ │ │ +0000d600: 6d65 6e74 7320 746f 2061 6464 2074 6f20 ments to add to │ │ │ │ │ +0000d610: 6d65 6e75 2065 6e74 7269 6573 2066 6f72 menu entries for │ │ │ │ │ +0000d620: 2074 6865 204c 696e 7578 206b 6572 6e65 the Linux kerne │ │ │ │ │ +0000d630: 6c2e 0a0a 2747 5255 425f 434d 444c 494e l...'GRUB_CMDLIN │ │ │ │ │ +0000d640: 455f 4c49 4e55 585f 4445 4641 554c 5427 E_LINUX_DEFAULT' │ │ │ │ │ +0000d650: 0a20 2020 2020 556e 6c65 7373 2027 4752 . Unless 'GR │ │ │ │ │ +0000d660: 5542 5f44 4953 4142 4c45 5f52 4543 4f56 UB_DISABLE_RECOV │ │ │ │ │ +0000d670: 4552 5927 2069 7320 7365 7420 746f 2027 ERY' is set to ' │ │ │ │ │ +0000d680: 7472 7565 272c 2074 776f 206d 656e 7520 true', two menu │ │ │ │ │ +0000d690: 656e 7472 6965 730a 2020 2020 2077 696c entries. wil │ │ │ │ │ +0000d6a0: 6c20 6265 2067 656e 6572 6174 6564 2066 l be generated f │ │ │ │ │ +0000d6b0: 6f72 2065 6163 6820 4c69 6e75 7820 6b65 or each Linux ke │ │ │ │ │ +0000d6c0: 726e 656c 3a20 6f6e 6520 6465 6661 756c rnel: one defaul │ │ │ │ │ +0000d6d0: 7420 656e 7472 7920 616e 6420 6f6e 650a t entry and one. │ │ │ │ │ +0000d6e0: 2020 2020 2065 6e74 7279 2066 6f72 2072 entry for r │ │ │ │ │ +0000d6f0: 6563 6f76 6572 7920 6d6f 6465 2e20 2054 ecovery mode. T │ │ │ │ │ +0000d700: 6869 7320 6f70 7469 6f6e 206c 6973 7473 his option lists │ │ │ │ │ +0000d710: 2063 6f6d 6d61 6e64 2d6c 696e 6520 6172 command-line ar │ │ │ │ │ +0000d720: 6775 6d65 6e74 730a 2020 2020 2074 6f20 guments. to │ │ │ │ │ +0000d730: 6164 6420 6f6e 6c79 2074 6f20 7468 6520 add only to the │ │ │ │ │ +0000d740: 6465 6661 756c 7420 6d65 6e75 2065 6e74 default menu ent │ │ │ │ │ +0000d750: 7279 2c20 6166 7465 7220 7468 6f73 6520 ry, after those │ │ │ │ │ +0000d760: 6c69 7374 6564 2069 6e0a 2020 2020 2027 listed in. ' │ │ │ │ │ +0000d770: 4752 5542 5f43 4d44 4c49 4e45 5f4c 494e GRUB_CMDLINE_LIN │ │ │ │ │ +0000d780: 5558 272e 0a0a 2747 5255 425f 434d 444c UX'...'GRUB_CMDL │ │ │ │ │ +0000d790: 494e 455f 4e45 5442 5344 270a 2747 5255 INE_NETBSD'.'GRU │ │ │ │ │ +0000d7a0: 425f 434d 444c 494e 455f 4e45 5442 5344 B_CMDLINE_NETBSD │ │ │ │ │ +0000d7b0: 5f44 4546 4155 4c54 270a 2020 2020 2041 _DEFAULT'. A │ │ │ │ │ +0000d7c0: 7320 2747 5255 425f 434d 444c 494e 455f s 'GRUB_CMDLINE_ │ │ │ │ │ +0000d7d0: 4c49 4e55 5827 2061 6e64 2027 4752 5542 LINUX' and 'GRUB │ │ │ │ │ +0000d7e0: 5f43 4d44 4c49 4e45 5f4c 494e 5558 5f44 _CMDLINE_LINUX_D │ │ │ │ │ +0000d7f0: 4546 4155 4c54 272c 2062 7574 2066 6f72 EFAULT', but for │ │ │ │ │ +0000d800: 0a20 2020 2020 4e65 7442 5344 2e0a 0a27 . NetBSD...' │ │ │ │ │ +0000d810: 4752 5542 5f43 4d44 4c49 4e45 5f47 4e55 GRUB_CMDLINE_GNU │ │ │ │ │ +0000d820: 4d41 4348 270a 2020 2020 2041 7320 2747 MACH'. As 'G │ │ │ │ │ +0000d830: 5255 425f 434d 444c 494e 455f 4c49 4e55 RUB_CMDLINE_LINU │ │ │ │ │ +0000d840: 5827 2c20 6275 7420 666f 7220 474e 5520 X', but for GNU │ │ │ │ │ +0000d850: 4d61 6368 2e0a 0a27 4752 5542 5f43 4d44 Mach...'GRUB_CMD │ │ │ │ │ +0000d860: 4c49 4e45 5f58 454e 270a 2747 5255 425f LINE_XEN'.'GRUB_ │ │ │ │ │ +0000d870: 434d 444c 494e 455f 5845 4e5f 4445 4641 CMDLINE_XEN_DEFA │ │ │ │ │ +0000d880: 554c 5427 0a20 2020 2020 5468 6520 7661 ULT'. The va │ │ │ │ │ +0000d890: 6c75 6573 206f 6620 7468 6573 6520 6f70 lues of these op │ │ │ │ │ +0000d8a0: 7469 6f6e 7320 6172 6520 7061 7373 6564 tions are passed │ │ │ │ │ +0000d8b0: 2074 6f20 5865 6e20 6879 7065 7276 6973 to Xen hypervis │ │ │ │ │ +0000d8c0: 6f72 2058 656e 206d 656e 750a 2020 2020 or Xen menu. │ │ │ │ │ +0000d8d0: 2065 6e74 7269 6573 2c20 666f 7220 616c entries, for al │ │ │ │ │ +0000d8e0: 6c20 7265 7370 6563 7469 7665 6c79 206e l respectively n │ │ │ │ │ +0000d8f0: 6f72 6d61 6c20 656e 7472 6965 732e 0a0a ormal entries... │ │ │ │ │ +0000d900: 2747 5255 425f 434d 444c 494e 455f 4c49 'GRUB_CMDLINE_LI │ │ │ │ │ +0000d910: 4e55 585f 5845 4e5f 5245 504c 4143 4527 NUX_XEN_REPLACE' │ │ │ │ │ +0000d920: 0a27 4752 5542 5f43 4d44 4c49 4e45 5f4c .'GRUB_CMDLINE_L │ │ │ │ │ +0000d930: 494e 5558 5f58 454e 5f52 4550 4c41 4345 INUX_XEN_REPLACE │ │ │ │ │ +0000d940: 5f44 4546 4155 4c54 270a 2020 2020 2054 _DEFAULT'. T │ │ │ │ │ +0000d950: 6865 2076 616c 7565 7320 6f66 2074 6865 he values of the │ │ │ │ │ +0000d960: 7365 206f 7074 696f 6e73 2072 6570 6c61 se options repla │ │ │ │ │ +0000d970: 6365 2074 6865 2076 616c 7565 7320 6f66 ce the values of │ │ │ │ │ +0000d980: 0a20 2020 2020 2747 5255 425f 434d 444c . 'GRUB_CMDL │ │ │ │ │ +0000d990: 494e 455f 4c49 4e55 5827 2061 6e64 2027 INE_LINUX' and ' │ │ │ │ │ +0000d9a0: 4752 5542 5f43 4d44 4c49 4e45 5f4c 494e GRUB_CMDLINE_LIN │ │ │ │ │ +0000d9b0: 5558 5f44 4546 4155 4c54 2720 666f 7220 UX_DEFAULT' for │ │ │ │ │ +0000d9c0: 4c69 6e75 7820 616e 640a 2020 2020 2058 Linux and. X │ │ │ │ │ +0000d9d0: 656e 206d 656e 7520 656e 7472 6965 732e en menu entries. │ │ │ │ │ +0000d9e0: 0a0a 2747 5255 425f 4541 524c 595f 494e ..'GRUB_EARLY_IN │ │ │ │ │ +0000d9f0: 4954 5244 5f4c 494e 5558 5f43 5553 544f ITRD_LINUX_CUSTO │ │ │ │ │ +0000da00: 4d27 0a27 4752 5542 5f45 4152 4c59 5f49 M'.'GRUB_EARLY_I │ │ │ │ │ +0000da10: 4e49 5452 445f 4c49 4e55 585f 5354 4f43 NITRD_LINUX_STOC │ │ │ │ │ +0000da20: 4b27 0a20 2020 2020 4c69 7374 206f 6620 K'. List of │ │ │ │ │ +0000da30: 7370 6163 652d 7365 7061 7261 7465 6420 space-separated │ │ │ │ │ +0000da40: 6561 726c 7920 696e 6974 7264 2069 6d61 early initrd ima │ │ │ │ │ +0000da50: 6765 7320 746f 2062 6520 6c6f 6164 6564 ges to be loaded │ │ │ │ │ +0000da60: 2066 726f 6d0a 2020 2020 2027 2f62 6f6f from. '/boo │ │ │ │ │ +0000da70: 7427 2e20 2054 6869 7320 6973 2066 6f72 t'. This is for │ │ │ │ │ +0000da80: 206c 6f61 6469 6e67 2074 6869 6e67 7320 loading things │ │ │ │ │ +0000da90: 6c69 6b65 2043 5055 206d 6963 726f 636f like CPU microco │ │ │ │ │ +0000daa0: 6465 2c20 6669 726d 7761 7265 2c0a 2020 de, firmware,. │ │ │ │ │ +0000dab0: 2020 2041 4350 4920 7461 626c 6573 2c20 ACPI tables, │ │ │ │ │ +0000dac0: 6372 7970 746f 206b 6579 732c 2061 6e64 crypto keys, and │ │ │ │ │ +0000dad0: 2073 6f20 6f6e 2e20 2054 6865 7365 2065 so on. These e │ │ │ │ │ +0000dae0: 6172 6c79 2069 6d61 6765 7320 7769 6c6c arly images will │ │ │ │ │ +0000daf0: 2062 650a 2020 2020 206c 6f61 6465 6420 be. loaded │ │ │ │ │ +0000db00: 696e 2074 6865 206f 7264 6572 2064 6563 in the order dec │ │ │ │ │ +0000db10: 6c61 7265 642c 2061 6e64 2061 6c6c 2077 lared, and all w │ │ │ │ │ +0000db20: 696c 6c20 6265 206c 6f61 6465 6420 6265 ill be loaded be │ │ │ │ │ +0000db30: 666f 7265 2074 6865 0a20 2020 2020 6163 fore the. ac │ │ │ │ │ +0000db40: 7475 616c 2066 756e 6374 696f 6e61 6c20 tual functional │ │ │ │ │ +0000db50: 696e 6974 7264 2069 6d61 6765 2e0a 0a20 initrd image... │ │ │ │ │ +0000db60: 2020 2020 2747 5255 425f 4541 524c 595f 'GRUB_EARLY_ │ │ │ │ │ +0000db70: 494e 4954 5244 5f4c 494e 5558 5f53 544f INITRD_LINUX_STO │ │ │ │ │ +0000db80: 434b 2720 6973 2066 6f72 2079 6f75 7220 CK' is for your │ │ │ │ │ +0000db90: 6469 7374 7269 6275 7469 6f6e 2074 6f20 distribution to │ │ │ │ │ +0000dba0: 6465 636c 6172 650a 2020 2020 2069 6d61 declare. ima │ │ │ │ │ +0000dbb0: 6765 7320 7468 6174 2061 7265 2070 726f ges that are pro │ │ │ │ │ +0000dbc0: 7669 6465 6420 6279 2074 6865 2064 6973 vided by the dis │ │ │ │ │ +0000dbd0: 7472 6962 7574 696f 6e2e 2020 4974 2073 tribution. It s │ │ │ │ │ +0000dbe0: 686f 756c 6420 6e6f 7420 6265 0a20 2020 hould not be. │ │ │ │ │ +0000dbf0: 2020 6d6f 6469 6669 6564 2077 6974 686f modified witho │ │ │ │ │ +0000dc00: 7574 2075 6e64 6572 7374 616e 6469 6e67 ut understanding │ │ │ │ │ +0000dc10: 2074 6865 2063 6f6e 7365 7175 656e 6365 the consequence │ │ │ │ │ +0000dc20: 732e 2020 5468 6579 2077 696c 6c20 6265 s. They will be │ │ │ │ │ +0000dc30: 0a20 2020 2020 6c6f 6164 6564 2066 6972 . loaded fir │ │ │ │ │ +0000dc40: 7374 2e0a 0a20 2020 2020 2747 5255 425f st... 'GRUB_ │ │ │ │ │ +0000dc50: 4541 524c 595f 494e 4954 5244 5f4c 494e EARLY_INITRD_LIN │ │ │ │ │ +0000dc60: 5558 5f43 5553 544f 4d27 2069 7320 666f UX_CUSTOM' is fo │ │ │ │ │ +0000dc70: 7220 796f 7572 2063 7573 746f 6d20 6372 r your custom cr │ │ │ │ │ +0000dc80: 6561 7465 6420 696d 6167 6573 2e0a 0a20 eated images... │ │ │ │ │ +0000dc90: 2020 2020 5468 6520 6465 6661 756c 7420 The default │ │ │ │ │ +0000dca0: 7374 6f63 6b20 696d 6167 6573 2061 7265 stock images are │ │ │ │ │ +0000dcb0: 2061 7320 666f 6c6c 6f77 732c 2074 686f as follows, tho │ │ │ │ │ +0000dcc0: 7567 6820 7468 6579 206d 6179 2062 650a ugh they may be. │ │ │ │ │ +0000dcd0: 2020 2020 206f 7665 7272 6964 6465 6e20 overridden │ │ │ │ │ +0000dce0: 6279 2079 6f75 7220 6469 7374 7269 6275 by your distribu │ │ │ │ │ +0000dcf0: 7469 6f6e 3a0a 2020 2020 2020 2020 2020 tion:. │ │ │ │ │ +0000dd00: 696e 7465 6c2d 7563 2e69 6d67 2069 6e74 intel-uc.img int │ │ │ │ │ +0000dd10: 656c 2d75 636f 6465 2e69 6d67 2061 6d64 el-ucode.img amd │ │ │ │ │ +0000dd20: 2d75 632e 696d 6720 616d 642d 7563 6f64 -uc.img amd-ucod │ │ │ │ │ +0000dd30: 652e 696d 6720 6561 726c 795f 7563 6f64 e.img early_ucod │ │ │ │ │ +0000dd40: 652e 6370 696f 206d 6963 726f 636f 6465 e.cpio microcode │ │ │ │ │ +0000dd50: 2e63 7069 6f0a 0a27 4752 5542 5f44 4953 .cpio..'GRUB_DIS │ │ │ │ │ +0000dd60: 4142 4c45 5f4c 494e 5558 5f55 5549 4427 ABLE_LINUX_UUID' │ │ │ │ │ +0000dd70: 0a20 2020 2020 4e6f 726d 616c 6c79 2c20 . Normally, │ │ │ │ │ +0000dd80: 2767 7275 622d 6d6b 636f 6e66 6967 2720 'grub-mkconfig' │ │ │ │ │ +0000dd90: 7769 6c6c 2067 656e 6572 6174 6520 6d65 will generate me │ │ │ │ │ +0000dda0: 6e75 2065 6e74 7269 6573 2074 6861 7420 nu entries that │ │ │ │ │ +0000ddb0: 7573 650a 2020 2020 2075 6e69 7665 7273 use. univers │ │ │ │ │ +0000ddc0: 616c 6c79 2d75 6e69 7175 6520 6964 656e ally-unique iden │ │ │ │ │ +0000ddd0: 7469 6669 6572 7320 2855 5549 4473 2920 tifiers (UUIDs) │ │ │ │ │ +0000dde0: 746f 2069 6465 6e74 6966 7920 7468 6520 to identify the │ │ │ │ │ +0000ddf0: 726f 6f74 0a20 2020 2020 6669 6c65 7379 root. filesy │ │ │ │ │ +0000de00: 7374 656d 2074 6f20 7468 6520 4c69 6e75 stem to the Linu │ │ │ │ │ +0000de10: 7820 6b65 726e 656c 2c20 7573 696e 6720 x kernel, using │ │ │ │ │ +0000de20: 6120 2772 6f6f 743d 5555 4944 3d2e 2e2e a 'root=UUID=... │ │ │ │ │ +0000de30: 2720 6b65 726e 656c 0a20 2020 2020 7061 ' kernel. pa │ │ │ │ │ +0000de40: 7261 6d65 7465 722e 2020 5468 6973 2069 rameter. This i │ │ │ │ │ +0000de50: 7320 7573 7561 6c6c 7920 6d6f 7265 2072 s usually more r │ │ │ │ │ +0000de60: 656c 6961 626c 652c 2062 7574 2069 6e20 eliable, but in │ │ │ │ │ +0000de70: 736f 6d65 2063 6173 6573 2069 7420 6d61 some cases it ma │ │ │ │ │ +0000de80: 790a 2020 2020 206e 6f74 2062 6520 6170 y. not be ap │ │ │ │ │ +0000de90: 7072 6f70 7269 6174 652e 2020 546f 2064 propriate. To d │ │ │ │ │ +0000dea0: 6973 6162 6c65 2074 6865 2075 7365 206f isable the use o │ │ │ │ │ +0000deb0: 6620 5555 4944 732c 2073 6574 2074 6869 f UUIDs, set thi │ │ │ │ │ +0000dec0: 7320 6f70 7469 6f6e 0a20 2020 2020 746f s option. to │ │ │ │ │ +0000ded0: 2027 7472 7565 272e 0a0a 2747 5255 425f 'true'...'GRUB_ │ │ │ │ │ +0000dee0: 4449 5341 424c 455f 4c49 4e55 585f 5041 DISABLE_LINUX_PA │ │ │ │ │ +0000def0: 5254 5555 4944 270a 2020 2020 2049 6620 RTUUID'. If │ │ │ │ │ +0000df00: 2767 7275 622d 6d6b 636f 6e66 6967 2720 'grub-mkconfig' │ │ │ │ │ +0000df10: 6361 6e6e 6f74 2069 6465 6e74 6966 7920 cannot identify │ │ │ │ │ +0000df20: 7468 6520 726f 6f74 2066 696c 6573 7973 the root filesys │ │ │ │ │ +0000df30: 7465 6d20 7669 6120 6974 730a 2020 2020 tem via its. │ │ │ │ │ +0000df40: 2075 6e69 7665 7273 616c 6c79 2d75 6e69 universally-uni │ │ │ │ │ +0000df50: 7175 6520 696e 6465 6e74 6966 6965 7220 que indentifier │ │ │ │ │ +0000df60: 2855 5549 4429 2c20 2767 7275 622d 6d6b (UUID), 'grub-mk │ │ │ │ │ +0000df70: 636f 6e66 6967 2720 6361 6e20 7573 6520 config' can use │ │ │ │ │ +0000df80: 7468 650a 2020 2020 2055 5549 4420 6f66 the. UUID of │ │ │ │ │ +0000df90: 2074 6865 2070 6172 7469 7469 6f6e 2063 the partition c │ │ │ │ │ +0000dfa0: 6f6e 7461 696e 696e 6720 7468 6520 6669 ontaining the fi │ │ │ │ │ +0000dfb0: 6c65 7379 7374 656d 2074 6f20 6964 656e lesystem to iden │ │ │ │ │ +0000dfc0: 7469 6679 2074 6865 0a20 2020 2020 726f tify the. ro │ │ │ │ │ +0000dfd0: 6f74 2066 696c 6573 7973 7465 6d20 746f ot filesystem to │ │ │ │ │ +0000dfe0: 2074 6865 204c 696e 7578 206b 6572 6e65 the Linux kerne │ │ │ │ │ +0000dff0: 6c20 7669 6120 6120 2772 6f6f 743d 5041 l via a 'root=PA │ │ │ │ │ +0000e000: 5254 5555 4944 3d2e 2e2e 270a 2020 2020 RTUUID=...'. │ │ │ │ │ +0000e010: 206b 6572 6e65 6c20 7061 7261 6d65 7465 kernel paramete │ │ │ │ │ +0000e020: 722e 2020 5468 6973 2069 7320 6e6f 7420 r. This is not │ │ │ │ │ +0000e030: 6173 2072 656c 6961 626c 6520 6173 2075 as reliable as u │ │ │ │ │ +0000e040: 7369 6e67 2074 6865 2066 696c 6573 7973 sing the filesys │ │ │ │ │ +0000e050: 7465 6d0a 2020 2020 2055 5549 442c 2062 tem. UUID, b │ │ │ │ │ +0000e060: 7574 2069 7320 6d6f 7265 2072 656c 6961 ut is more relia │ │ │ │ │ +0000e070: 626c 6520 7468 616e 2075 7369 6e67 2074 ble than using t │ │ │ │ │ +0000e080: 6865 204c 696e 7578 2064 6576 6963 6520 he Linux device │ │ │ │ │ +0000e090: 6e61 6d65 732e 2020 5768 656e 0a20 2020 names. When. │ │ │ │ │ +0000e0a0: 2020 2747 5255 425f 4449 5341 424c 455f 'GRUB_DISABLE_ │ │ │ │ │ +0000e0b0: 4c49 4e55 585f 5041 5254 5555 4944 2720 LINUX_PARTUUID' │ │ │ │ │ +0000e0c0: 6973 2073 6574 2074 6f20 2766 616c 7365 is set to 'false │ │ │ │ │ +0000e0d0: 272c 2074 6865 204c 696e 7578 206b 6572 ', the Linux ker │ │ │ │ │ +0000e0e0: 6e65 6c0a 2020 2020 2076 6572 7369 6f6e nel. version │ │ │ │ │ +0000e0f0: 206d 7573 7420 6265 2032 2e36 2e33 3720 must be 2.6.37 │ │ │ │ │ +0000e100: 2833 2e31 3020 666f 7220 7379 7374 656d (3.10 for system │ │ │ │ │ +0000e110: 7320 7573 696e 6720 7468 6520 4d53 444f s using the MSDO │ │ │ │ │ +0000e120: 5320 7061 7274 6974 696f 6e0a 2020 2020 S partition. │ │ │ │ │ +0000e130: 2073 6368 656d 6529 206f 7220 6e65 7765 scheme) or newe │ │ │ │ │ +0000e140: 722e 2020 5468 6973 206f 7074 696f 6e20 r. This option │ │ │ │ │ +0000e150: 6465 6661 756c 7473 2074 6f20 2774 7275 defaults to 'tru │ │ │ │ │ +0000e160: 6527 2e20 2054 6f20 656e 6162 6c65 2074 e'. To enable t │ │ │ │ │ +0000e170: 6865 0a20 2020 2020 7573 6520 6f66 2070 he. use of p │ │ │ │ │ +0000e180: 6172 7469 7469 6f6e 2055 5549 4473 2c20 artition UUIDs, │ │ │ │ │ +0000e190: 7365 7420 7468 6973 206f 7074 696f 6e20 set this option │ │ │ │ │ +0000e1a0: 746f 2027 6661 6c73 6527 2e0a 0a27 4752 to 'false'...'GR │ │ │ │ │ +0000e1b0: 5542 5f44 4953 4142 4c45 5f52 4543 4f56 UB_DISABLE_RECOV │ │ │ │ │ +0000e1c0: 4552 5927 0a20 2020 2020 4966 2074 6869 ERY'. If thi │ │ │ │ │ +0000e1d0: 7320 6f70 7469 6f6e 2069 7320 7365 7420 s option is set │ │ │ │ │ +0000e1e0: 746f 2027 7472 7565 272c 2064 6973 6162 to 'true', disab │ │ │ │ │ +0000e1f0: 6c65 2074 6865 2067 656e 6572 6174 696f le the generatio │ │ │ │ │ +0000e200: 6e20 6f66 2072 6563 6f76 6572 790a 2020 n of recovery. │ │ │ │ │ +0000e210: 2020 206d 6f64 6520 6d65 6e75 2065 6e74 mode menu ent │ │ │ │ │ +0000e220: 7269 6573 2e0a 0a27 4752 5542 5f44 4953 ries...'GRUB_DIS │ │ │ │ │ +0000e230: 4142 4c45 5f55 5549 4427 0a20 2020 2020 ABLE_UUID'. │ │ │ │ │ +0000e240: 4e6f 726d 616c 6c79 2c20 2767 7275 622d Normally, 'grub- │ │ │ │ │ +0000e250: 6d6b 636f 6e66 6967 2720 7769 6c6c 2067 mkconfig' will g │ │ │ │ │ +0000e260: 656e 6572 6174 6520 6d65 6e75 2065 6e74 enerate menu ent │ │ │ │ │ +0000e270: 7269 6573 2074 6861 7420 7573 650a 2020 ries that use. │ │ │ │ │ +0000e280: 2020 2075 6e69 7665 7273 616c 6c79 2d75 universally-u │ │ │ │ │ +0000e290: 6e69 7175 6520 6964 656e 7469 6669 6572 nique identifier │ │ │ │ │ +0000e2a0: 7320 2855 5549 4473 2920 746f 2069 6465 s (UUIDs) to ide │ │ │ │ │ +0000e2b0: 6e74 6966 7920 7661 7269 6f75 730a 2020 ntify various. │ │ │ │ │ +0000e2c0: 2020 2066 696c 6573 7973 7465 6d73 2074 filesystems t │ │ │ │ │ +0000e2d0: 6f20 7365 6172 6368 2066 6f72 2066 696c o search for fil │ │ │ │ │ +0000e2e0: 6573 2e20 2054 6869 7320 6973 2075 7375 es. This is usu │ │ │ │ │ +0000e2f0: 616c 6c79 206d 6f72 6520 7265 6c69 6162 ally more reliab │ │ │ │ │ +0000e300: 6c65 2c0a 2020 2020 2062 7574 2069 6e20 le,. but in │ │ │ │ │ +0000e310: 736f 6d65 2063 6173 6573 2069 7420 6d61 some cases it ma │ │ │ │ │ +0000e320: 7920 6e6f 7420 6265 2061 7070 726f 7072 y not be appropr │ │ │ │ │ +0000e330: 6961 7465 2e20 2054 6f20 6469 7361 626c iate. To disabl │ │ │ │ │ +0000e340: 6520 7468 6973 2075 7365 0a20 2020 2020 e this use. │ │ │ │ │ +0000e350: 6f66 2055 5549 4473 2c20 7365 7420 7468 of UUIDs, set th │ │ │ │ │ +0000e360: 6973 206f 7074 696f 6e20 746f 2027 7472 is option to 'tr │ │ │ │ │ +0000e370: 7565 272e 2020 5365 7474 696e 6720 7468 ue'. Setting th │ │ │ │ │ +0000e380: 6973 206f 7074 696f 6e20 746f 0a20 2020 is option to. │ │ │ │ │ +0000e390: 2020 2774 7275 6527 2c20 7769 6c6c 2061 'true', will a │ │ │ │ │ +0000e3a0: 6c73 6f20 7365 7420 7468 6520 6f70 7469 lso set the opti │ │ │ │ │ +0000e3b0: 6f6e 7320 2747 5255 425f 4449 5341 424c ons 'GRUB_DISABL │ │ │ │ │ +0000e3c0: 455f 4c49 4e55 585f 5555 4944 2720 616e E_LINUX_UUID' an │ │ │ │ │ +0000e3d0: 640a 2020 2020 2027 4752 5542 5f44 4953 d. 'GRUB_DIS │ │ │ │ │ +0000e3e0: 4142 4c45 5f4c 494e 5558 5f50 4152 5455 ABLE_LINUX_PARTU │ │ │ │ │ +0000e3f0: 5549 4427 2074 6f20 2774 7275 6527 2c20 UID' to 'true', │ │ │ │ │ +0000e400: 756e 6c65 7373 2074 6865 7920 6861 7665 unless they have │ │ │ │ │ +0000e410: 2062 6565 6e0a 2020 2020 2065 7870 6c69 been. expli │ │ │ │ │ +0000e420: 6369 6c74 7920 7365 7420 746f 2027 6661 cilty set to 'fa │ │ │ │ │ +0000e430: 6c73 6527 2e0a 0a27 4752 5542 5f56 4944 lse'...'GRUB_VID │ │ │ │ │ +0000e440: 454f 5f42 4143 4b45 4e44 270a 2020 2020 EO_BACKEND'. │ │ │ │ │ +0000e450: 2049 6620 6772 6170 6869 6361 6c20 7669 If graphical vi │ │ │ │ │ +0000e460: 6465 6f20 7375 7070 6f72 7420 6973 2072 deo support is r │ │ │ │ │ +0000e470: 6571 7569 7265 642c 2065 6974 6865 7220 equired, either │ │ │ │ │ +0000e480: 6265 6361 7573 6520 7468 650a 2020 2020 because the. │ │ │ │ │ +0000e490: 2027 6766 7874 6572 6d27 2067 7261 7068 'gfxterm' graph │ │ │ │ │ +0000e4a0: 6963 616c 2074 6572 6d69 6e61 6c20 6973 ical terminal is │ │ │ │ │ +0000e4b0: 2069 6e20 7573 6520 6f72 2062 6563 6175 in use or becau │ │ │ │ │ +0000e4c0: 7365 0a20 2020 2020 2747 5255 425f 4746 se. 'GRUB_GF │ │ │ │ │ +0000e4d0: 5850 4159 4c4f 4144 5f4c 494e 5558 2720 XPAYLOAD_LINUX' │ │ │ │ │ +0000e4e0: 6973 2073 6574 2c20 7468 656e 2027 6772 is set, then 'gr │ │ │ │ │ +0000e4f0: 7562 2d6d 6b63 6f6e 6669 6727 2077 696c ub-mkconfig' wil │ │ │ │ │ +0000e500: 6c20 6e6f 726d 616c 6c79 0a20 2020 2020 l normally. │ │ │ │ │ +0000e510: 6c6f 6164 2061 6c6c 2061 7661 696c 6162 load all availab │ │ │ │ │ +0000e520: 6c65 2047 5255 4220 7669 6465 6f20 6472 le GRUB video dr │ │ │ │ │ +0000e530: 6976 6572 7320 616e 6420 7573 6520 7468 ivers and use th │ │ │ │ │ +0000e540: 6520 6f6e 6520 6d6f 7374 0a20 2020 2020 e one most. │ │ │ │ │ +0000e550: 6170 7072 6f70 7269 6174 6520 666f 7220 appropriate for │ │ │ │ │ +0000e560: 796f 7572 2068 6172 6477 6172 652e 2020 your hardware. │ │ │ │ │ +0000e570: 4966 2079 6f75 206e 6565 6420 746f 206f If you need to o │ │ │ │ │ +0000e580: 7665 7272 6964 6520 7468 6973 2066 6f72 verride this for │ │ │ │ │ +0000e590: 0a20 2020 2020 736f 6d65 2072 6561 736f . some reaso │ │ │ │ │ +0000e5a0: 6e2c 2074 6865 6e20 796f 7520 6361 6e20 n, then you can │ │ │ │ │ +0000e5b0: 7365 7420 7468 6973 206f 7074 696f 6e2e set this option. │ │ │ │ │ +0000e5c0: 0a0a 2020 2020 2041 6674 6572 2027 6772 .. After 'gr │ │ │ │ │ +0000e5d0: 7562 2d69 6e73 7461 6c6c 2720 6861 7320 ub-install' has │ │ │ │ │ +0000e5e0: 6265 656e 2072 756e 2c20 7468 6520 6176 been run, the av │ │ │ │ │ +0000e5f0: 6169 6c61 626c 6520 7669 6465 6f20 6472 ailable video dr │ │ │ │ │ +0000e600: 6976 6572 7320 6172 650a 2020 2020 206c ivers are. l │ │ │ │ │ +0000e610: 6973 7465 6420 696e 2027 2f62 6f6f 742f isted in '/boot/ │ │ │ │ │ +0000e620: 6772 7562 2f76 6964 656f 2e6c 7374 272e grub/video.lst'. │ │ │ │ │ +0000e630: 0a0a 2747 5255 425f 4746 584d 4f44 4527 ..'GRUB_GFXMODE' │ │ │ │ │ +0000e640: 0a20 2020 2020 5365 7420 7468 6520 7265 . Set the re │ │ │ │ │ +0000e650: 736f 6c75 7469 6f6e 2075 7365 6420 6f6e solution used on │ │ │ │ │ +0000e660: 2074 6865 2027 6766 7874 6572 6d27 2067 the 'gfxterm' g │ │ │ │ │ +0000e670: 7261 7068 6963 616c 2074 6572 6d69 6e61 raphical termina │ │ │ │ │ +0000e680: 6c2e 2020 4e6f 7465 0a20 2020 2020 7468 l. Note. th │ │ │ │ │ +0000e690: 6174 2079 6f75 2063 616e 206f 6e6c 7920 at you can only │ │ │ │ │ +0000e6a0: 7573 6520 6d6f 6465 7320 7768 6963 6820 use modes which │ │ │ │ │ +0000e6b0: 796f 7572 2067 7261 7068 6963 7320 6361 your graphics ca │ │ │ │ │ +0000e6c0: 7264 2073 7570 706f 7274 7320 7669 610a rd supports via. │ │ │ │ │ +0000e6d0: 2020 2020 2056 4553 4120 4249 4f53 2045 VESA BIOS E │ │ │ │ │ +0000e6e0: 7874 656e 7369 6f6e 7320 2856 4245 292c xtensions (VBE), │ │ │ │ │ +0000e6f0: 2073 6f20 666f 7220 6578 616d 706c 6520 so for example │ │ │ │ │ +0000e700: 6e61 7469 7665 204c 4344 2070 616e 656c native LCD panel │ │ │ │ │ +0000e710: 0a20 2020 2020 7265 736f 6c75 7469 6f6e . resolution │ │ │ │ │ +0000e720: 7320 6d61 7920 6e6f 7420 6265 2061 7661 s may not be ava │ │ │ │ │ +0000e730: 696c 6162 6c65 2e20 2054 6865 2064 6566 ilable. The def │ │ │ │ │ +0000e740: 6175 6c74 2069 7320 2761 7574 6f27 2c20 ault is 'auto', │ │ │ │ │ +0000e750: 7768 6963 680a 2020 2020 2074 7269 6573 which. tries │ │ │ │ │ +0000e760: 2074 6f20 7365 6c65 6374 2061 2070 7265 to select a pre │ │ │ │ │ +0000e770: 6665 7272 6564 2072 6573 6f6c 7574 696f ferred resolutio │ │ │ │ │ +0000e780: 6e2e 2020 2a4e 6f74 6520 6766 786d 6f64 n. *Note gfxmod │ │ │ │ │ +0000e790: 653a 3a2e 0a0a 2747 5255 425f 4241 434b e::...'GRUB_BACK │ │ │ │ │ +0000e7a0: 4752 4f55 4e44 270a 2020 2020 2053 6574 GROUND'. Set │ │ │ │ │ +0000e7b0: 2061 2062 6163 6b67 726f 756e 6420 696d a background im │ │ │ │ │ +0000e7c0: 6167 6520 666f 7220 7573 6520 7769 7468 age for use with │ │ │ │ │ +0000e7d0: 2074 6865 2027 6766 7874 6572 6d27 2067 the 'gfxterm' g │ │ │ │ │ +0000e7e0: 7261 7068 6963 616c 0a20 2020 2020 7465 raphical. te │ │ │ │ │ +0000e7f0: 726d 696e 616c 2e20 2054 6865 2076 616c rminal. The val │ │ │ │ │ +0000e800: 7565 206f 6620 7468 6973 206f 7074 696f ue of this optio │ │ │ │ │ +0000e810: 6e20 6d75 7374 2062 6520 6120 6669 6c65 n must be a file │ │ │ │ │ +0000e820: 2072 6561 6461 626c 6520 6279 2047 5255 readable by GRU │ │ │ │ │ +0000e830: 420a 2020 2020 2061 7420 626f 6f74 2074 B. at boot t │ │ │ │ │ +0000e840: 696d 652c 2061 6e64 2069 7420 6d75 7374 ime, and it must │ │ │ │ │ +0000e850: 2065 6e64 2077 6974 6820 272e 706e 6727 end with '.png' │ │ │ │ │ +0000e860: 2c20 272e 7467 6127 2c20 272e 6a70 6727 , '.tga', '.jpg' │ │ │ │ │ +0000e870: 2c20 6f72 0a20 2020 2020 272e 6a70 6567 , or. '.jpeg │ │ │ │ │ +0000e880: 272e 2020 5468 6520 696d 6167 6520 7769 '. The image wi │ │ │ │ │ +0000e890: 6c6c 2062 6520 7363 616c 6564 2069 6620 ll be scaled if │ │ │ │ │ +0000e8a0: 6e65 6365 7373 6172 7920 746f 2066 6974 necessary to fit │ │ │ │ │ +0000e8b0: 2074 6865 2073 6372 6565 6e2e 0a20 2020 the screen.. │ │ │ │ │ +0000e8c0: 2020 496d 6167 6520 6865 6967 6874 2061 Image height a │ │ │ │ │ +0000e8d0: 6e64 2077 6964 7468 2077 696c 6c20 6265 nd width will be │ │ │ │ │ +0000e8e0: 2072 6573 7472 6963 7465 6420 6279 2061 restricted by a │ │ │ │ │ +0000e8f0: 6e20 6172 7469 6669 6369 616c 206c 696d n artificial lim │ │ │ │ │ +0000e900: 6974 206f 660a 2020 2020 2031 3633 3834 it of. 16384 │ │ │ │ │ +0000e910: 2e0a 0a27 4752 5542 5f54 4845 4d45 270a ...'GRUB_THEME'. │ │ │ │ │ +0000e920: 2020 2020 2053 6574 2061 2074 6865 6d65 Set a theme │ │ │ │ │ +0000e930: 2066 6f72 2075 7365 2077 6974 6820 7468 for use with th │ │ │ │ │ +0000e940: 6520 2767 6678 7465 726d 2720 6772 6170 e 'gfxterm' grap │ │ │ │ │ +0000e950: 6869 6361 6c20 7465 726d 696e 616c 2e0a hical terminal.. │ │ │ │ │ +0000e960: 0a27 4752 5542 5f47 4658 5041 594c 4f41 .'GRUB_GFXPAYLOA │ │ │ │ │ +0000e970: 445f 4c49 4e55 5827 0a20 2020 2020 5365 D_LINUX'. Se │ │ │ │ │ +0000e980: 7420 746f 2027 7465 7874 2720 746f 2066 t to 'text' to f │ │ │ │ │ +0000e990: 6f72 6365 2074 6865 204c 696e 7578 206b orce the Linux k │ │ │ │ │ +0000e9a0: 6572 6e65 6c20 746f 2062 6f6f 7420 696e ernel to boot in │ │ │ │ │ +0000e9b0: 206e 6f72 6d61 6c20 7465 7874 0a20 2020 normal text. │ │ │ │ │ +0000e9c0: 2020 6d6f 6465 2c20 276b 6565 7027 2074 mode, 'keep' t │ │ │ │ │ +0000e9d0: 6f20 7072 6573 6572 7665 2074 6865 2067 o preserve the g │ │ │ │ │ +0000e9e0: 7261 7068 6963 7320 6d6f 6465 2073 6574 raphics mode set │ │ │ │ │ +0000e9f0: 2075 7369 6e67 0a20 2020 2020 2747 5255 using. 'GRU │ │ │ │ │ +0000ea00: 425f 4746 584d 4f44 4527 2c20 2757 4944 B_GFXMODE', 'WID │ │ │ │ │ +0000ea10: 5448 7848 4549 4748 5427 5b27 7844 4550 THxHEIGHT'['xDEP │ │ │ │ │ +0000ea20: 5448 275d 2074 6f20 7365 7420 6120 7061 TH'] to set a pa │ │ │ │ │ +0000ea30: 7274 6963 756c 6172 0a20 2020 2020 6772 rticular. gr │ │ │ │ │ +0000ea40: 6170 6869 6373 206d 6f64 652c 206f 7220 aphics mode, or │ │ │ │ │ +0000ea50: 6120 7365 7175 656e 6365 206f 6620 7468 a sequence of th │ │ │ │ │ +0000ea60: 6573 6520 7365 7061 7261 7465 6420 6279 ese separated by │ │ │ │ │ +0000ea70: 2063 6f6d 6d61 7320 6f72 0a20 2020 2020 commas or. │ │ │ │ │ +0000ea80: 7365 6d69 636f 6c6f 6e73 2074 6f20 7472 semicolons to tr │ │ │ │ │ +0000ea90: 7920 7365 7665 7261 6c20 6d6f 6465 7320 y several modes │ │ │ │ │ +0000eaa0: 696e 2073 6571 7565 6e63 652e 2020 2a4e in sequence. *N │ │ │ │ │ +0000eab0: 6f74 6520 6766 7870 6179 6c6f 6164 3a3a ote gfxpayload:: │ │ │ │ │ +0000eac0: 2e0a 0a20 2020 2020 4465 7065 6e64 696e ... Dependin │ │ │ │ │ +0000ead0: 6720 6f6e 2079 6f75 7220 6b65 726e 656c g on your kernel │ │ │ │ │ +0000eae0: 2c20 796f 7572 2064 6973 7472 6962 7574 , your distribut │ │ │ │ │ +0000eaf0: 696f 6e2c 2079 6f75 7220 6772 6170 6869 ion, your graphi │ │ │ │ │ +0000eb00: 6373 2063 6172 642c 0a20 2020 2020 616e cs card,. an │ │ │ │ │ +0000eb10: 6420 7468 6520 7068 6173 6520 6f66 2074 d the phase of t │ │ │ │ │ +0000eb20: 6865 206d 6f6f 6e2c 206e 6f74 6520 7468 he moon, note th │ │ │ │ │ +0000eb30: 6174 2075 7369 6e67 2074 6869 7320 6f70 at using this op │ │ │ │ │ +0000eb40: 7469 6f6e 206d 6179 2063 6175 7365 0a20 tion may cause. │ │ │ │ │ +0000eb50: 2020 2020 474e 552f 4c69 6e75 7820 746f GNU/Linux to │ │ │ │ │ +0000eb60: 2073 7566 6665 7220 6672 6f6d 2076 6172 suffer from var │ │ │ │ │ +0000eb70: 696f 7573 2064 6973 706c 6179 2070 726f ious display pro │ │ │ │ │ +0000eb80: 626c 656d 732c 2070 6172 7469 6375 6c61 blems, particula │ │ │ │ │ +0000eb90: 726c 790a 2020 2020 2064 7572 696e 6720 rly. during │ │ │ │ │ +0000eba0: 7468 6520 6561 726c 7920 7061 7274 206f the early part o │ │ │ │ │ +0000ebb0: 6620 7468 6520 626f 6f74 2073 6571 7565 f the boot seque │ │ │ │ │ +0000ebc0: 6e63 652e 2020 4966 2079 6f75 2068 6176 nce. If you hav │ │ │ │ │ +0000ebd0: 6520 7072 6f62 6c65 6d73 2c0a 2020 2020 e problems,. │ │ │ │ │ +0000ebe0: 2073 6574 2074 6869 7320 6f70 7469 6f6e set this option │ │ │ │ │ +0000ebf0: 2074 6f20 2774 6578 7427 2061 6e64 2047 to 'text' and G │ │ │ │ │ +0000ec00: 5255 4220 7769 6c6c 2074 656c 6c20 4c69 RUB will tell Li │ │ │ │ │ +0000ec10: 6e75 7820 746f 2062 6f6f 7420 696e 0a20 nux to boot in. │ │ │ │ │ +0000ec20: 2020 2020 6e6f 726d 616c 2074 6578 7420 normal text │ │ │ │ │ +0000ec30: 6d6f 6465 2e0a 0a27 4752 5542 5f44 4953 mode...'GRUB_DIS │ │ │ │ │ +0000ec40: 4142 4c45 5f4f 535f 5052 4f42 4552 270a ABLE_OS_PROBER'. │ │ │ │ │ +0000ec50: 2020 2020 2054 6865 2027 6772 7562 2d6d The 'grub-m │ │ │ │ │ +0000ec60: 6b63 6f6e 6669 6727 2068 6173 2061 2066 kconfig' has a f │ │ │ │ │ +0000ec70: 6561 7475 7265 2074 6f20 7573 6520 7468 eature to use th │ │ │ │ │ +0000ec80: 6520 6578 7465 726e 616c 2027 6f73 2d70 e external 'os-p │ │ │ │ │ +0000ec90: 726f 6265 7227 0a20 2020 2020 7072 6f67 rober'. prog │ │ │ │ │ +0000eca0: 7261 6d20 746f 2064 6973 636f 7665 7220 ram to discover │ │ │ │ │ +0000ecb0: 6f74 6865 7220 6f70 6572 6174 696e 6720 other operating │ │ │ │ │ +0000ecc0: 7379 7374 656d 7320 696e 7374 616c 6c65 systems installe │ │ │ │ │ +0000ecd0: 6420 6f6e 2074 6865 2073 616d 650a 2020 d on the same. │ │ │ │ │ +0000ece0: 2020 206d 6163 6869 6e65 2061 6e64 2067 machine and g │ │ │ │ │ +0000ecf0: 656e 6572 6174 6520 6170 7072 6f70 7269 enerate appropri │ │ │ │ │ +0000ed00: 6174 6520 6d65 6e75 2065 6e74 7269 6573 ate menu entries │ │ │ │ │ +0000ed10: 2066 6f72 2074 6865 6d2e 2020 4974 2069 for them. It i │ │ │ │ │ +0000ed20: 730a 2020 2020 2064 6973 6162 6c65 6420 s. disabled │ │ │ │ │ +0000ed30: 6279 2064 6566 6175 6c74 2073 696e 6365 by default since │ │ │ │ │ +0000ed40: 2061 7574 6f6d 6174 6963 2061 6e64 2073 automatic and s │ │ │ │ │ +0000ed50: 696c 656e 7420 6578 6563 7574 696f 6e20 ilent execution │ │ │ │ │ +0000ed60: 6f66 0a20 2020 2020 276f 732d 7072 6f62 of. 'os-prob │ │ │ │ │ +0000ed70: 6572 272c 2061 6e64 2063 7265 6174 696e er', and creatin │ │ │ │ │ +0000ed80: 6720 626f 6f74 2065 6e74 7269 6573 2062 g boot entries b │ │ │ │ │ +0000ed90: 6173 6564 206f 6e20 7468 6174 2064 6174 ased on that dat │ │ │ │ │ +0000eda0: 612c 2069 7320 610a 2020 2020 2070 6f74 a, is a. pot │ │ │ │ │ +0000edb0: 656e 7469 616c 2061 7474 6163 6b20 7665 ential attack ve │ │ │ │ │ +0000edc0: 6374 6f72 2e20 2053 6574 2074 6869 7320 ctor. Set this │ │ │ │ │ +0000edd0: 6f70 7469 6f6e 2074 6f20 2766 616c 7365 option to 'false │ │ │ │ │ +0000ede0: 2720 746f 2065 6e61 626c 6520 7468 6973 ' to enable this │ │ │ │ │ +0000edf0: 0a20 2020 2020 6665 6174 7572 6520 696e . feature in │ │ │ │ │ +0000ee00: 2074 6865 2027 6772 7562 2d6d 6b63 6f6e the 'grub-mkcon │ │ │ │ │ +0000ee10: 6669 6727 2063 6f6d 6d61 6e64 2e0a 0a27 fig' command...' │ │ │ │ │ +0000ee20: 4752 5542 5f4f 535f 5052 4f42 4552 5f53 GRUB_OS_PROBER_S │ │ │ │ │ +0000ee30: 4b49 505f 4c49 5354 270a 2020 2020 204c KIP_LIST'. L │ │ │ │ │ +0000ee40: 6973 7420 6f66 2073 7061 6365 2d73 6570 ist of space-sep │ │ │ │ │ +0000ee50: 6172 6174 6564 2046 5320 5555 4944 7320 arated FS UUIDs │ │ │ │ │ +0000ee60: 6f66 2066 696c 6573 7973 7465 6d73 2074 of filesystems t │ │ │ │ │ +0000ee70: 6f20 6265 2069 676e 6f72 6564 2066 726f o be ignored fro │ │ │ │ │ +0000ee80: 6d0a 2020 2020 206f 732d 7072 6f62 6572 m. os-prober │ │ │ │ │ +0000ee90: 206f 7574 7075 742e 2020 466f 7220 6566 output. For ef │ │ │ │ │ +0000eea0: 6920 6368 6169 6e6c 6f61 6465 7273 2069 i chainloaders i │ │ │ │ │ +0000eeb0: 7427 7320 3c55 5549 443e 403c 4546 4920 t's @..'GRUB_DIS │ │ │ │ │ +0000eed0: 4142 4c45 5f53 5542 4d45 4e55 270a 2020 ABLE_SUBMENU'. │ │ │ │ │ +0000eee0: 2020 204e 6f72 6d61 6c6c 792c 2027 6772 Normally, 'gr │ │ │ │ │ +0000eef0: 7562 2d6d 6b63 6f6e 6669 6727 2077 696c ub-mkconfig' wil │ │ │ │ │ +0000ef00: 6c20 6765 6e65 7261 7465 2074 6f70 206c l generate top l │ │ │ │ │ +0000ef10: 6576 656c 206d 656e 7520 656e 7472 7920 evel menu entry │ │ │ │ │ +0000ef20: 666f 720a 2020 2020 2074 6865 206b 6572 for. the ker │ │ │ │ │ +0000ef30: 6e65 6c20 7769 7468 2068 6967 6865 7374 nel with highest │ │ │ │ │ +0000ef40: 2076 6572 7369 6f6e 206e 756d 6265 7220 version number │ │ │ │ │ +0000ef50: 616e 6420 7075 7420 616c 6c20 6f74 6865 and put all othe │ │ │ │ │ +0000ef60: 7220 666f 756e 640a 2020 2020 206b 6572 r found. ker │ │ │ │ │ +0000ef70: 6e65 6c73 206f 7220 616c 7465 726e 6174 nels or alternat │ │ │ │ │ +0000ef80: 6976 6520 6d65 6e75 2065 6e74 7269 6573 ive menu entries │ │ │ │ │ +0000ef90: 2066 6f72 2072 6563 6f76 6572 7920 6d6f for recovery mo │ │ │ │ │ +0000efa0: 6465 2069 6e20 7375 626d 656e 752e 0a20 de in submenu.. │ │ │ │ │ +0000efb0: 2020 2020 466f 7220 656e 7472 6965 7320 For entries │ │ │ │ │ +0000efc0: 7265 7475 726e 6564 2062 7920 276f 732d returned by 'os- │ │ │ │ │ +0000efd0: 7072 6f62 6572 2720 6669 7273 7420 656e prober' first en │ │ │ │ │ +0000efe0: 7472 7920 7769 6c6c 2062 6520 7075 7420 try will be put │ │ │ │ │ +0000eff0: 6f6e 2074 6f70 0a20 2020 2020 6c65 7665 on top. leve │ │ │ │ │ +0000f000: 6c20 616e 6420 616c 6c20 6f74 6865 7273 l and all others │ │ │ │ │ +0000f010: 2069 6e20 7375 626d 656e 752e 2020 4966 in submenu. If │ │ │ │ │ +0000f020: 2074 6869 7320 6f70 7469 6f6e 2069 7320 this option is │ │ │ │ │ +0000f030: 7365 7420 746f 2027 7472 7565 272c 0a20 set to 'true',. │ │ │ │ │ +0000f040: 2020 2020 666c 6174 206d 656e 7520 7769 flat menu wi │ │ │ │ │ +0000f050: 7468 2061 6c6c 2065 6e74 7269 6573 206f th all entries o │ │ │ │ │ +0000f060: 6e20 746f 7020 6c65 7665 6c20 7769 6c6c n top level will │ │ │ │ │ +0000f070: 2062 6520 6765 6e65 7261 7465 6420 696e be generated in │ │ │ │ │ +0000f080: 7374 6561 642e 0a20 2020 2020 4368 616e stead.. Chan │ │ │ │ │ +0000f090: 6769 6e67 2074 6869 7320 6f70 7469 6f6e ging this option │ │ │ │ │ +0000f0a0: 2077 696c 6c20 7265 7175 6972 6520 6368 will require ch │ │ │ │ │ +0000f0b0: 616e 6769 6e67 2065 7869 7374 696e 6720 anging existing │ │ │ │ │ +0000f0c0: 7661 6c75 6573 206f 660a 2020 2020 2027 values of. ' │ │ │ │ │ +0000f0d0: 4752 5542 5f44 4546 4155 4c54 272c 2027 GRUB_DEFAULT', ' │ │ │ │ │ +0000f0e0: 6661 6c6c 6261 636b 2720 282a 6e6f 7465 fallback' (*note │ │ │ │ │ +0000f0f0: 2066 616c 6c62 6163 6b3a 3a29 2061 6e64 fallback::) and │ │ │ │ │ +0000f100: 2027 6465 6661 756c 7427 2028 2a6e 6f74 'default' (*not │ │ │ │ │ +0000f110: 650a 2020 2020 2064 6566 6175 6c74 3a3a e. default:: │ │ │ │ │ +0000f120: 2920 656e 7669 726f 6e6d 656e 7420 7661 ) environment va │ │ │ │ │ +0000f130: 7269 6162 6c65 7320 6173 2077 656c 6c20 riables as well │ │ │ │ │ +0000f140: 6173 2073 6176 6564 2064 6566 6175 6c74 as saved default │ │ │ │ │ +0000f150: 2065 6e74 7279 0a20 2020 2020 7573 696e entry. usin │ │ │ │ │ +0000f160: 6720 2767 7275 622d 7365 742d 6465 6661 g 'grub-set-defa │ │ │ │ │ +0000f170: 756c 7427 2061 6e64 2076 616c 7565 2075 ult' and value u │ │ │ │ │ +0000f180: 7365 6420 7769 7468 2027 6772 7562 2d72 sed with 'grub-r │ │ │ │ │ +0000f190: 6562 6f6f 7427 2e0a 0a27 4752 5542 5f45 eboot'...'GRUB_E │ │ │ │ │ +0000f1a0: 4e41 424c 455f 4352 5950 544f 4449 534b NABLE_CRYPTODISK │ │ │ │ │ +0000f1b0: 270a 2020 2020 2049 6620 7365 7420 746f '. If set to │ │ │ │ │ +0000f1c0: 2027 7927 2c20 2767 7275 622d 6d6b 636f 'y', 'grub-mkco │ │ │ │ │ +0000f1d0: 6e66 6967 2720 616e 6420 2767 7275 622d nfig' and 'grub- │ │ │ │ │ +0000f1e0: 696e 7374 616c 6c27 2077 696c 6c20 6368 install' will ch │ │ │ │ │ +0000f1f0: 6563 6b20 666f 720a 2020 2020 2065 6e63 eck for. enc │ │ │ │ │ +0000f200: 7279 7074 6564 2064 6973 6b73 2061 6e64 rypted disks and │ │ │ │ │ +0000f210: 2067 656e 6572 6174 6520 6164 6469 7469 generate additi │ │ │ │ │ +0000f220: 6f6e 616c 2063 6f6d 6d61 6e64 7320 6e65 onal commands ne │ │ │ │ │ +0000f230: 6564 6564 2074 6f20 6163 6365 7373 0a20 eded to access. │ │ │ │ │ +0000f240: 2020 2020 7468 656d 2064 7572 696e 6720 them during │ │ │ │ │ +0000f250: 626f 6f74 2e20 204e 6f74 6520 7468 6174 boot. Note that │ │ │ │ │ +0000f260: 2069 6e20 7468 6973 2063 6173 6520 756e in this case un │ │ │ │ │ +0000f270: 6174 7465 6e64 6564 2062 6f6f 7420 6973 attended boot is │ │ │ │ │ +0000f280: 206e 6f74 0a20 2020 2020 706f 7373 6962 not. possib │ │ │ │ │ +0000f290: 6c65 2062 6563 6175 7365 2047 5255 4220 le because GRUB │ │ │ │ │ +0000f2a0: 7769 6c6c 2077 6169 7420 666f 7220 7061 will wait for pa │ │ │ │ │ +0000f2b0: 7373 7068 7261 7365 2074 6f20 756e 6c6f ssphrase to unlo │ │ │ │ │ +0000f2c0: 636b 2065 6e63 7279 7074 6564 0a20 2020 ck encrypted. │ │ │ │ │ +0000f2d0: 2020 636f 6e74 6169 6e65 722e 0a0a 2747 container...'G │ │ │ │ │ +0000f2e0: 5255 425f 494e 4954 5f54 554e 4527 0a20 RUB_INIT_TUNE'. │ │ │ │ │ +0000f2f0: 2020 2020 506c 6179 2061 2074 756e 6520 Play a tune │ │ │ │ │ +0000f300: 6f6e 2074 6865 2073 7065 616b 6572 2077 on the speaker w │ │ │ │ │ +0000f310: 6865 6e20 4752 5542 2073 7461 7274 732e hen GRUB starts. │ │ │ │ │ +0000f320: 2020 5468 6973 2069 7320 7061 7274 6963 This is partic │ │ │ │ │ +0000f330: 756c 6172 6c79 0a20 2020 2020 7573 6566 ularly. usef │ │ │ │ │ +0000f340: 756c 2066 6f72 2075 7365 7273 2075 6e61 ul for users una │ │ │ │ │ +0000f350: 626c 6520 746f 2073 6565 2074 6865 2073 ble to see the s │ │ │ │ │ +0000f360: 6372 6565 6e2e 2020 5468 6520 7661 6c75 creen. The valu │ │ │ │ │ +0000f370: 6520 6f66 2074 6869 730a 2020 2020 206f e of this. o │ │ │ │ │ +0000f380: 7074 696f 6e20 6973 2070 6173 7365 6420 ption is passed │ │ │ │ │ +0000f390: 6469 7265 6374 6c79 2074 6f20 2a6e 6f74 directly to *not │ │ │ │ │ +0000f3a0: 6520 706c 6179 3a3a 2e0a 0a27 4752 5542 e play::...'GRUB │ │ │ │ │ +0000f3b0: 5f42 4144 5241 4d27 0a20 2020 2020 4966 _BADRAM'. If │ │ │ │ │ +0000f3c0: 2074 6869 7320 6f70 7469 6f6e 2069 7320 this option is │ │ │ │ │ +0000f3d0: 7365 742c 2047 5255 4220 7769 6c6c 2069 set, GRUB will i │ │ │ │ │ +0000f3e0: 7373 7565 2061 202a 6e6f 7465 2062 6164 ssue a *note bad │ │ │ │ │ +0000f3f0: 7261 6d3a 3a20 636f 6d6d 616e 6420 746f ram:: command to │ │ │ │ │ +0000f400: 0a20 2020 2020 6669 6c74 6572 206f 7574 . filter out │ │ │ │ │ +0000f410: 2073 7065 6369 6669 6564 2072 6567 696f specified regio │ │ │ │ │ +0000f420: 6e73 206f 6620 5241 4d2e 0a0a 2747 5255 ns of RAM...'GRU │ │ │ │ │ +0000f430: 425f 5052 454c 4f41 445f 4d4f 4455 4c45 B_PRELOAD_MODULE │ │ │ │ │ +0000f440: 5327 0a20 2020 2020 5468 6973 206f 7074 S'. This opt │ │ │ │ │ +0000f450: 696f 6e20 6d61 7920 6265 2073 6574 2074 ion may be set t │ │ │ │ │ +0000f460: 6f20 6120 6c69 7374 206f 6620 4752 5542 o a list of GRUB │ │ │ │ │ +0000f470: 206d 6f64 756c 6520 6e61 6d65 7320 7365 module names se │ │ │ │ │ +0000f480: 7061 7261 7465 6420 6279 0a20 2020 2020 parated by. │ │ │ │ │ +0000f490: 7370 6163 6573 2e20 2045 6163 6820 6d6f spaces. Each mo │ │ │ │ │ +0000f4a0: 6475 6c65 2077 696c 6c20 6265 206c 6f61 dule will be loa │ │ │ │ │ +0000f4b0: 6465 6420 6173 2065 6172 6c79 2061 7320 ded as early as │ │ │ │ │ +0000f4c0: 706f 7373 6962 6c65 2c20 6174 2074 6865 possible, at the │ │ │ │ │ +0000f4d0: 0a20 2020 2020 7374 6172 7420 6f66 2027 . start of ' │ │ │ │ │ +0000f4e0: 6772 7562 2e63 6667 272e 0a0a 2747 5255 grub.cfg'...'GRU │ │ │ │ │ +0000f4f0: 425f 5245 434f 5244 4641 494c 5f54 494d B_RECORDFAIL_TIM │ │ │ │ │ +0000f500: 454f 5554 270a 2020 2020 2049 6620 7468 EOUT'. If th │ │ │ │ │ +0000f510: 6973 206f 7074 696f 6e20 6973 2073 6574 is option is set │ │ │ │ │ +0000f520: 2c20 6974 206f 7665 7272 6964 6573 2074 , it overrides t │ │ │ │ │ +0000f530: 6865 2064 6566 6175 6c74 2072 6563 6f72 he default recor │ │ │ │ │ +0000f540: 6466 6169 6c20 7365 7474 696e 672e 0a20 dfail setting.. │ │ │ │ │ +0000f550: 2020 2020 4120 7365 7474 696e 6720 6f66 A setting of │ │ │ │ │ +0000f560: 202d 3120 6361 7573 6573 2047 5255 4220 -1 causes GRUB │ │ │ │ │ +0000f570: 746f 2077 6169 7420 666f 7220 7573 6572 to wait for user │ │ │ │ │ +0000f580: 2069 6e70 7574 2069 6e64 6566 696e 6974 input indefinit │ │ │ │ │ +0000f590: 656c 792e 0a20 2020 2020 486f 7765 7665 ely.. Howeve │ │ │ │ │ +0000f5a0: 722c 2061 2066 616c 7365 2070 6f73 6974 r, a false posit │ │ │ │ │ +0000f5b0: 6976 6520 696e 2074 6865 2072 6563 6f72 ive in the recor │ │ │ │ │ +0000f5c0: 6466 6169 6c20 6d65 6368 616e 6973 6d20 dfail mechanism │ │ │ │ │ +0000f5d0: 6d61 7920 6f63 6375 7220 6966 0a20 2020 may occur if. │ │ │ │ │ +0000f5e0: 2020 706f 7765 7220 6973 206c 6f73 7420 power is lost │ │ │ │ │ +0000f5f0: 6475 7269 6e67 2062 6f6f 7420 6265 666f during boot befo │ │ │ │ │ +0000f600: 7265 2062 6f6f 7420 7375 6363 6573 7320 re boot success │ │ │ │ │ +0000f610: 6973 2072 6563 6f72 6465 6420 696e 0a20 is recorded in. │ │ │ │ │ +0000f620: 2020 2020 7573 6572 7370 6163 652e 2020 userspace. │ │ │ │ │ +0000f630: 5468 6520 6465 6661 756c 7420 7365 7474 The default sett │ │ │ │ │ +0000f640: 696e 6720 6973 2033 302c 2077 6869 6368 ing is 30, which │ │ │ │ │ +0000f650: 2063 6175 7365 7320 4752 5542 2074 6f20 causes GRUB to │ │ │ │ │ +0000f660: 7761 6974 0a20 2020 2020 666f 7220 7573 wait. for us │ │ │ │ │ +0000f670: 6572 2069 6e70 7574 2066 6f72 2074 6869 er input for thi │ │ │ │ │ +0000f680: 7274 7920 7365 636f 6e64 7320 6265 666f rty seconds befo │ │ │ │ │ +0000f690: 7265 2063 6f6e 7469 6e75 696e 672e 2020 re continuing. │ │ │ │ │ +0000f6a0: 5468 6973 2064 6566 6175 6c74 0a20 2020 This default. │ │ │ │ │ +0000f6b0: 2020 616c 6c6f 7773 2069 6e74 6572 6163 allows interac │ │ │ │ │ +0000f6c0: 7469 7665 2075 7365 7273 2074 6865 206f tive users the o │ │ │ │ │ +0000f6d0: 7070 6f72 7475 6e69 7479 2074 6f20 7377 pportunity to sw │ │ │ │ │ +0000f6e0: 6974 6368 2074 6f20 6120 6469 6666 6572 itch to a differ │ │ │ │ │ +0000f6f0: 656e 742c 0a20 2020 2020 776f 726b 696e ent,. workin │ │ │ │ │ +0000f700: 6720 6b65 726e 656c 2c20 7768 696c 6520 g kernel, while │ │ │ │ │ +0000f710: 6176 6f69 6469 6e67 2061 2066 616c 7365 avoiding a false │ │ │ │ │ +0000f720: 2070 6f73 6974 6976 6520 6361 7573 696e positive causin │ │ │ │ │ +0000f730: 6720 7468 6520 626f 6f74 2074 6f0a 2020 g the boot to. │ │ │ │ │ +0000f740: 2020 2062 6c6f 636b 2069 6e64 6566 696e block indefin │ │ │ │ │ +0000f750: 6974 656c 7920 6f6e 2068 6561 646c 6573 itely on headles │ │ │ │ │ +0000f760: 7320 616e 6420 6170 706c 6961 6e63 6520 s and appliance │ │ │ │ │ +0000f770: 7379 7374 656d 7320 7768 6572 6520 6163 systems where ac │ │ │ │ │ +0000f780: 6365 7373 0a20 2020 2020 746f 2061 2063 cess. to a c │ │ │ │ │ +0000f790: 6f6e 736f 6c65 2069 7320 7265 7374 7269 onsole is restri │ │ │ │ │ +0000f7a0: 6374 6564 206f 7220 6c69 6d69 7465 642e cted or limited. │ │ │ │ │ +0000f7b0: 0a0a 2020 2020 2054 6869 7320 6f70 7469 .. This opti │ │ │ │ │ +0000f7c0: 6f6e 2069 7320 6f6e 6c79 2065 6666 6563 on is only effec │ │ │ │ │ +0000f7d0: 7469 7665 2077 6865 6e20 4752 5542 2077 tive when GRUB w │ │ │ │ │ +0000f7e0: 6173 2063 6f6e 6669 6775 7265 6420 7769 as configured wi │ │ │ │ │ +0000f7f0: 7468 2074 6865 0a20 2020 2020 272d 2d65 th the. '--e │ │ │ │ │ +0000f800: 6e61 626c 652d 7175 6963 6b2d 626f 6f74 nable-quick-boot │ │ │ │ │ +0000f810: 2720 6f70 7469 6f6e 2e0a 0a27 4752 5542 ' option...'GRUB │ │ │ │ │ +0000f820: 5f52 4543 4f56 4552 595f 5449 544c 4527 _RECOVERY_TITLE' │ │ │ │ │ +0000f830: 0a20 2020 2020 5468 6973 206f 7074 696f . This optio │ │ │ │ │ +0000f840: 6e20 7365 7473 2074 6865 2045 6e67 6c69 n sets the Engli │ │ │ │ │ +0000f850: 7368 2074 6578 7420 6f66 2074 6865 2073 sh text of the s │ │ │ │ │ +0000f860: 7472 696e 6720 7468 6174 2077 696c 6c20 tring that will │ │ │ │ │ +0000f870: 6265 0a20 2020 2020 6469 7370 6c61 7965 be. displaye │ │ │ │ │ +0000f880: 6420 696e 2070 6172 656e 7468 6573 6573 d in parentheses │ │ │ │ │ +0000f890: 2074 6f20 696e 6469 6361 7465 2074 6861 to indicate tha │ │ │ │ │ +0000f8a0: 7420 6120 626f 6f74 206f 7074 696f 6e20 t a boot option │ │ │ │ │ +0000f8b0: 6973 2070 726f 7669 6465 640a 2020 2020 is provided. │ │ │ │ │ +0000f8c0: 2074 6f20 6865 6c70 2075 7365 7273 2072 to help users r │ │ │ │ │ +0000f8d0: 6563 6f76 6572 2061 2062 726f 6b65 6e20 ecover a broken │ │ │ │ │ +0000f8e0: 7379 7374 656d 2e20 2054 6865 2064 6566 system. The def │ │ │ │ │ +0000f8f0: 6175 6c74 2069 7320 2272 6563 6f76 6572 ault is "recover │ │ │ │ │ +0000f900: 790a 2020 2020 206d 6f64 6522 2e0a 0a20 y. mode"... │ │ │ │ │ +0000f910: 2020 5468 6520 666f 6c6c 6f77 696e 6720 The following │ │ │ │ │ +0000f920: 6f70 7469 6f6e 7320 6172 6520 7374 696c options are stil │ │ │ │ │ +0000f930: 6c20 6163 6365 7074 6564 2066 6f72 2063 l accepted for c │ │ │ │ │ +0000f940: 6f6d 7061 7469 6269 6c69 7479 2077 6974 ompatibility wit │ │ │ │ │ +0000f950: 680a 6578 6973 7469 6e67 2063 6f6e 6669 h.existing confi │ │ │ │ │ +0000f960: 6775 7261 7469 6f6e 732c 2062 7574 2068 gurations, but h │ │ │ │ │ +0000f970: 6176 6520 6265 7474 6572 2072 6570 6c61 ave better repla │ │ │ │ │ +0000f980: 6365 6d65 6e74 733a 0a0a 2747 5255 425f cements:..'GRUB_ │ │ │ │ │ +0000f990: 4849 4444 454e 5f54 494d 454f 5554 270a HIDDEN_TIMEOUT'. │ │ │ │ │ +0000f9a0: 2020 2020 2057 6169 7420 7468 6973 206d Wait this m │ │ │ │ │ +0000f9b0: 616e 7920 7365 636f 6e64 7320 6265 666f any seconds befo │ │ │ │ │ +0000f9c0: 7265 2064 6973 706c 6179 696e 6720 7468 re displaying th │ │ │ │ │ +0000f9d0: 6520 6d65 6e75 2e20 2049 6620 3c45 5343 e menu. If or. a │ │ │ │ │ +0000f9f0: 7265 2070 7265 7373 6564 2c20 6f72 203c re pressed, or < │ │ │ │ │ +0000fa00: 5348 4946 543e 2069 7320 6865 6c64 2064 SHIFT> is held d │ │ │ │ │ +0000fa10: 6f77 6e20 6475 7269 6e67 2074 6861 7420 own during that │ │ │ │ │ +0000fa20: 7469 6d65 2c20 6469 7370 6c61 790a 2020 time, display. │ │ │ │ │ +0000fa30: 2020 2074 6865 206d 656e 7520 616e 6420 the menu and │ │ │ │ │ +0000fa40: 7761 6974 2066 6f72 2069 6e70 7574 2061 wait for input a │ │ │ │ │ +0000fa50: 6363 6f72 6469 6e67 2074 6f20 2747 5255 ccording to 'GRU │ │ │ │ │ +0000fa60: 425f 5449 4d45 4f55 5427 2e20 2049 6620 B_TIMEOUT'. If │ │ │ │ │ +0000fa70: 610a 2020 2020 2068 6f74 6b65 7920 6173 a. hotkey as │ │ │ │ │ +0000fa80: 736f 6369 6174 6564 2077 6974 6820 6120 sociated with a │ │ │ │ │ +0000fa90: 6d65 6e75 2065 6e74 7279 2069 7320 7072 menu entry is pr │ │ │ │ │ +0000faa0: 6573 7365 642c 2062 6f6f 7420 7468 6520 essed, boot the │ │ │ │ │ +0000fab0: 6173 736f 6369 6174 6564 0a20 2020 2020 associated. │ │ │ │ │ +0000fac0: 6d65 6e75 2065 6e74 7279 2069 6d6d 6564 menu entry immed │ │ │ │ │ +0000fad0: 6961 7465 6c79 2e20 2049 6620 7468 6520 iately. If the │ │ │ │ │ +0000fae0: 7469 6d65 6f75 7420 6578 7069 7265 7320 timeout expires │ │ │ │ │ +0000faf0: 6265 666f 7265 2065 6974 6865 7220 6f66 before either of │ │ │ │ │ +0000fb00: 0a20 2020 2020 7468 6573 6520 6861 7070 . these happ │ │ │ │ │ +0000fb10: 656e 732c 2064 6973 706c 6179 2074 6865 ens, display the │ │ │ │ │ +0000fb20: 206d 656e 7520 666f 7220 7468 6520 6e75 menu for the nu │ │ │ │ │ +0000fb30: 6d62 6572 206f 6620 7365 636f 6e64 7320 mber of seconds │ │ │ │ │ +0000fb40: 7370 6563 6966 6965 640a 2020 2020 2069 specified. i │ │ │ │ │ +0000fb50: 6e20 2747 5255 425f 5449 4d45 4f55 5427 n 'GRUB_TIMEOUT' │ │ │ │ │ +0000fb60: 2062 6566 6f72 6520 626f 6f74 696e 6720 before booting │ │ │ │ │ +0000fb70: 7468 6520 6465 6661 756c 7420 656e 7472 the default entr │ │ │ │ │ +0000fb80: 792e 0a0a 2020 2020 2049 6620 796f 7520 y... If you │ │ │ │ │ +0000fb90: 7365 7420 2747 5255 425f 4849 4444 454e set 'GRUB_HIDDEN │ │ │ │ │ +0000fba0: 5f54 494d 454f 5554 272c 2079 6f75 2073 _TIMEOUT', you s │ │ │ │ │ +0000fbb0: 686f 756c 6420 616c 736f 2073 6574 0a20 hould also set. │ │ │ │ │ +0000fbc0: 2020 2020 2747 5255 425f 5449 4d45 4f55 'GRUB_TIMEOU │ │ │ │ │ +0000fbd0: 543d 3027 2073 6f20 7468 6174 2074 6865 T=0' so that the │ │ │ │ │ +0000fbe0: 206d 656e 7520 6973 206e 6f74 2064 6973 menu is not dis │ │ │ │ │ +0000fbf0: 706c 6179 6564 2061 7420 616c 6c20 756e played at all un │ │ │ │ │ +0000fc00: 6c65 7373 0a20 2020 2020 3c45 5343 3e20 less. │ │ │ │ │ +0000fc10: 6f72 203c 4634 3e20 6172 6520 7072 6573 or are pres │ │ │ │ │ +0000fc20: 7365 642c 206f 7220 3c53 4849 4654 3e20 sed, or │ │ │ │ │ +0000fc30: 6973 2068 656c 6420 646f 776e 2e0a 0a20 is held down... │ │ │ │ │ +0000fc40: 2020 2020 5468 6973 206f 7074 696f 6e20 This option │ │ │ │ │ +0000fc50: 6973 2075 6e73 6574 2062 7920 6465 6661 is unset by defa │ │ │ │ │ +0000fc60: 756c 742c 2061 6e64 2069 7320 6465 7072 ult, and is depr │ │ │ │ │ +0000fc70: 6563 6174 6564 2069 6e20 6661 766f 7572 ecated in favour │ │ │ │ │ +0000fc80: 206f 6620 7468 650a 2020 2020 206c 6573 of the. les │ │ │ │ │ +0000fc90: 7320 636f 6e66 7573 696e 6720 2747 5255 s confusing 'GRU │ │ │ │ │ +0000fca0: 425f 5449 4d45 4f55 545f 5354 594c 453d B_TIMEOUT_STYLE= │ │ │ │ │ +0000fcb0: 636f 756e 7464 6f77 6e27 206f 720a 2020 countdown' or. │ │ │ │ │ +0000fcc0: 2020 2027 4752 5542 5f54 494d 454f 5554 'GRUB_TIMEOUT │ │ │ │ │ +0000fcd0: 5f53 5459 4c45 3d68 6964 6465 6e27 2e0a _STYLE=hidden'.. │ │ │ │ │ +0000fce0: 0a27 4752 5542 5f48 4944 4445 4e5f 5449 .'GRUB_HIDDEN_TI │ │ │ │ │ +0000fcf0: 4d45 4f55 545f 5155 4945 5427 0a20 2020 MEOUT_QUIET'. │ │ │ │ │ +0000fd00: 2020 496e 2063 6f6e 6a75 6e63 7469 6f6e In conjunction │ │ │ │ │ +0000fd10: 2077 6974 6820 2747 5255 425f 4849 4444 with 'GRUB_HIDD │ │ │ │ │ +0000fd20: 454e 5f54 494d 454f 5554 272c 2073 6574 EN_TIMEOUT', set │ │ │ │ │ +0000fd30: 2074 6869 7320 746f 2027 7472 7565 2720 this to 'true' │ │ │ │ │ +0000fd40: 746f 0a20 2020 2020 7375 7070 7265 7373 to. suppress │ │ │ │ │ +0000fd50: 2074 6865 2076 6572 626f 7365 2063 6f75 the verbose cou │ │ │ │ │ +0000fd60: 6e74 646f 776e 2077 6869 6c65 2077 6169 ntdown while wai │ │ │ │ │ +0000fd70: 7469 6e67 2066 6f72 2061 206b 6579 2074 ting for a key t │ │ │ │ │ +0000fd80: 6f20 6265 0a20 2020 2020 7072 6573 7365 o be. presse │ │ │ │ │ +0000fd90: 6420 6265 666f 7265 2064 6973 706c 6179 d before display │ │ │ │ │ +0000fda0: 696e 6720 7468 6520 6d65 6e75 2e0a 0a20 ing the menu... │ │ │ │ │ +0000fdb0: 2020 2020 5468 6973 206f 7074 696f 6e20 This option │ │ │ │ │ +0000fdc0: 6973 2075 6e73 6574 2062 7920 6465 6661 is unset by defa │ │ │ │ │ +0000fdd0: 756c 742c 2061 6e64 2069 7320 6465 7072 ult, and is depr │ │ │ │ │ +0000fde0: 6563 6174 6564 2069 6e20 6661 766f 7572 ecated in favour │ │ │ │ │ +0000fdf0: 206f 6620 7468 650a 2020 2020 206c 6573 of the. les │ │ │ │ │ +0000fe00: 7320 636f 6e66 7573 696e 6720 2747 5255 s confusing 'GRU │ │ │ │ │ +0000fe10: 425f 5449 4d45 4f55 545f 5354 594c 453d B_TIMEOUT_STYLE= │ │ │ │ │ +0000fe20: 636f 756e 7464 6f77 6e27 2e0a 0a27 4752 countdown'...'GR │ │ │ │ │ +0000fe30: 5542 5f48 4944 4445 4e5f 5449 4d45 4f55 UB_HIDDEN_TIMEOU │ │ │ │ │ +0000fe40: 545f 4255 5454 4f4e 270a 2020 2020 2056 T_BUTTON'. V │ │ │ │ │ +0000fe50: 6172 6961 6e74 206f 6620 2747 5255 425f ariant of 'GRUB_ │ │ │ │ │ +0000fe60: 4849 4444 454e 5f54 494d 454f 5554 272c HIDDEN_TIMEOUT', │ │ │ │ │ +0000fe70: 2075 7365 6420 746f 2073 7570 706f 7274 used to support │ │ │ │ │ +0000fe80: 2076 656e 646f 722d 7370 6563 6966 6963 vendor-specific │ │ │ │ │ +0000fe90: 0a20 2020 2020 706f 7765 7220 6275 7474 . power butt │ │ │ │ │ +0000fea0: 6f6e 732e 2020 2a4e 6f74 6520 5665 6e64 ons. *Note Vend │ │ │ │ │ +0000feb0: 6f72 2070 6f77 6572 2d6f 6e20 6b65 7973 or power-on keys │ │ │ │ │ +0000fec0: 3a3a 2e0a 0a20 2020 2020 5468 6973 206f ::... This o │ │ │ │ │ +0000fed0: 7074 696f 6e20 6973 2075 6e73 6574 2062 ption is unset b │ │ │ │ │ +0000fee0: 7920 6465 6661 756c 742c 2061 6e64 2069 y default, and i │ │ │ │ │ +0000fef0: 7320 6465 7072 6563 6174 6564 2069 6e20 s deprecated in │ │ │ │ │ +0000ff00: 6661 766f 7572 206f 6620 7468 650a 2020 favour of the. │ │ │ │ │ +0000ff10: 2020 206c 6573 7320 636f 6e66 7573 696e less confusin │ │ │ │ │ +0000ff20: 6720 2747 5255 425f 5449 4d45 4f55 545f g 'GRUB_TIMEOUT_ │ │ │ │ │ +0000ff30: 5354 594c 453d 636f 756e 7464 6f77 6e27 STYLE=countdown' │ │ │ │ │ +0000ff40: 206f 720a 2020 2020 2027 4752 5542 5f54 or. 'GRUB_T │ │ │ │ │ +0000ff50: 494d 454f 5554 5f53 5459 4c45 3d68 6964 IMEOUT_STYLE=hid │ │ │ │ │ +0000ff60: 6465 6e27 2e0a 0a20 2020 466f 7220 6d6f den'... For mo │ │ │ │ │ +0000ff70: 7265 2064 6574 6169 6c65 6420 6375 7374 re detailed cust │ │ │ │ │ +0000ff80: 6f6d 6973 6174 696f 6e20 6f66 2027 6772 omisation of 'gr │ │ │ │ │ +0000ff90: 7562 2d6d 6b63 6f6e 6669 6727 2773 206f ub-mkconfig''s o │ │ │ │ │ +0000ffa0: 7574 7075 742c 2079 6f75 206d 6179 0a65 utput, you may.e │ │ │ │ │ +0000ffb0: 6469 7420 7468 6520 7363 7269 7074 7320 dit the scripts │ │ │ │ │ +0000ffc0: 696e 2027 2f65 7463 2f67 7275 622e 6427 in '/etc/grub.d' │ │ │ │ │ +0000ffd0: 2064 6972 6563 746c 792e 2020 272f 6574 directly. '/et │ │ │ │ │ +0000ffe0: 632f 6772 7562 2e64 2f34 305f 6375 7374 c/grub.d/40_cust │ │ │ │ │ +0000fff0: 6f6d 2720 6973 0a70 6172 7469 6375 6c61 om' is.particula │ │ │ │ │ +00010000: 726c 7920 7573 6566 756c 2066 6f72 2061 rly useful for a │ │ │ │ │ +00010010: 6464 696e 6720 656e 7469 7265 2063 7573 dding entire cus │ │ │ │ │ +00010020: 746f 6d20 6d65 6e75 2065 6e74 7269 6573 tom menu entries │ │ │ │ │ +00010030: 3b20 7369 6d70 6c79 2074 7970 650a 7468 ; simply type.th │ │ │ │ │ +00010040: 6520 6d65 6e75 2065 6e74 7269 6573 2079 e menu entries y │ │ │ │ │ +00010050: 6f75 2077 616e 7420 746f 2061 6464 2061 ou want to add a │ │ │ │ │ +00010060: 7420 7468 6520 656e 6420 6f66 2074 6861 t the end of tha │ │ │ │ │ +00010070: 7420 6669 6c65 2c20 6d61 6b69 6e67 2073 t file, making s │ │ │ │ │ +00010080: 7572 6520 746f 0a6c 6561 7665 2061 7420 ure to.leave at │ │ │ │ │ +00010090: 6c65 6173 7420 7468 6520 6669 7273 7420 least the first │ │ │ │ │ +000100a0: 7477 6f20 6c69 6e65 7320 696e 7461 6374 two lines intact │ │ │ │ │ +000100b0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +000100c0: 696e 666f 2c20 204e 6f64 653a 2052 6f6f info, Node: Roo │ │ │ │ │ +000100d0: 7420 4964 656e 7469 6663 6174 696f 6e20 t Identifcation │ │ │ │ │ +000100e0: 4865 7572 6973 7469 6373 2c20 204e 6578 Heuristics, Nex │ │ │ │ │ +000100f0: 743a 2053 6865 6c6c 2d6c 696b 6520 7363 t: Shell-like sc │ │ │ │ │ +00010100: 7269 7074 696e 672c 2020 5072 6576 3a20 ripting, Prev: │ │ │ │ │ +00010110: 5369 6d70 6c65 2063 6f6e 6669 6775 7261 Simple configura │ │ │ │ │ +00010120: 7469 6f6e 2c20 2055 703a 2043 6f6e 6669 tion, Up: Confi │ │ │ │ │ +00010130: 6775 7261 7469 6f6e 0a0a 362e 3220 526f guration..6.2 Ro │ │ │ │ │ +00010140: 6f74 2049 6465 6e74 6966 6361 7469 6f6e ot Identifcation │ │ │ │ │ +00010150: 2048 6575 7269 7374 6963 730a 3d3d 3d3d Heuristics.==== │ │ │ │ │ 00010160: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00010170: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 6620 ===========..If │ │ │ │ │ -00010180: 7468 6520 7461 7267 6574 206f 7065 7261 the target opera │ │ │ │ │ -00010190: 7469 6e67 2073 7973 7465 6d20 7573 6573 ting system uses │ │ │ │ │ -000101a0: 2074 6865 204c 696e 7578 206b 6572 6e65 the Linux kerne │ │ │ │ │ -000101b0: 6c2c 2027 6772 7562 2d6d 6b63 6f6e 6669 l, 'grub-mkconfi │ │ │ │ │ -000101c0: 6727 0a61 7474 656d 7074 7320 746f 2069 g'.attempts to i │ │ │ │ │ -000101d0: 6465 6e74 6966 7920 7468 6520 726f 6f74 dentify the root │ │ │ │ │ -000101e0: 2066 696c 6520 7379 7374 656d 2076 6961 file system via │ │ │ │ │ -000101f0: 2061 2068 6575 7269 7374 6963 2061 6c67 a heuristic alg │ │ │ │ │ -00010200: 6f69 7274 686d 2e0a 5468 6973 2061 6c67 oirthm..This alg │ │ │ │ │ -00010210: 6f72 6974 686d 2073 656c 6563 7473 2074 orithm selects t │ │ │ │ │ -00010220: 6865 2069 6465 6e74 6966 6963 6174 696f he identificatio │ │ │ │ │ -00010230: 6e20 6d65 7468 6f64 206f 6620 7468 6520 n method of the │ │ │ │ │ -00010240: 726f 6f74 2066 696c 6520 7379 7374 656d root file system │ │ │ │ │ -00010250: 0a62 7920 636f 6e73 6964 6572 696e 6720 .by considering │ │ │ │ │ -00010260: 7468 7265 6520 6661 6374 6f72 732e 2020 three factors. │ │ │ │ │ -00010270: 5468 6520 6669 7273 7420 6973 2069 6620 The first is if │ │ │ │ │ -00010280: 616e 2069 6e69 7472 6420 666f 7220 7468 an initrd for th │ │ │ │ │ -00010290: 6520 7461 7267 6574 0a6f 7065 7261 7469 e target.operati │ │ │ │ │ -000102a0: 6e67 2073 7973 7465 6d20 6973 2061 6c73 ng system is als │ │ │ │ │ -000102b0: 6f20 7072 6573 656e 742e 2020 5468 6520 o present. The │ │ │ │ │ -000102c0: 7365 636f 6e64 2069 730a 2747 5255 425f second is.'GRUB_ │ │ │ │ │ -000102d0: 4449 5341 424c 455f 4c49 4e55 585f 5555 DISABLE_LINUX_UU │ │ │ │ │ -000102e0: 4944 2720 616e 6420 6966 2073 6574 2074 ID' and if set t │ │ │ │ │ -000102f0: 6f20 2774 7275 6527 2c20 7072 6576 656e o 'true', preven │ │ │ │ │ -00010300: 7473 2027 6772 7562 2d6d 6b63 6f6e 6669 ts 'grub-mkconfi │ │ │ │ │ -00010310: 6727 0a66 726f 6d20 6964 656e 7469 6679 g'.from identify │ │ │ │ │ -00010320: 696e 6720 7468 6520 726f 6f74 2066 696c ing the root fil │ │ │ │ │ -00010330: 6520 7379 7374 656d 2062 7920 6974 7320 e system by its │ │ │ │ │ -00010340: 5555 4944 2e20 5468 6520 7468 6972 6420 UUID. The third │ │ │ │ │ -00010350: 6973 0a27 4752 5542 5f44 4953 4142 4c45 is.'GRUB_DISABLE │ │ │ │ │ -00010360: 5f4c 494e 5558 5f50 4152 5455 5549 4427 _LINUX_PARTUUID' │ │ │ │ │ -00010370: 2061 6e64 2069 6620 7365 7420 746f 2027 and if set to ' │ │ │ │ │ -00010380: 7472 7565 272c 2070 7265 7665 6e74 730a true', prevents. │ │ │ │ │ -00010390: 2767 7275 622d 6d6b 636f 6e66 6967 2720 'grub-mkconfig' │ │ │ │ │ -000103a0: 6672 6f6d 2069 6465 6e74 6966 7969 6e67 from identifying │ │ │ │ │ -000103b0: 2074 6865 2072 6f6f 7420 6669 6c65 2073 the root file s │ │ │ │ │ -000103c0: 7973 7465 6d20 7669 6120 7468 6520 5555 ystem via the UU │ │ │ │ │ -000103d0: 4944 206f 660a 6974 7320 656e 636c 6f73 ID of.its enclos │ │ │ │ │ -000103e0: 696e 6720 7061 7274 6974 696f 6e2e 2020 ing partition. │ │ │ │ │ -000103f0: 4966 2074 6865 2076 6172 6961 626c 6573 If the variables │ │ │ │ │ -00010400: 2061 7265 2061 7373 6967 6e65 6420 616e are assigned an │ │ │ │ │ -00010410: 7920 6f74 6865 7220 7661 6c75 652c 0a74 y other value,.t │ │ │ │ │ -00010420: 6861 7420 7661 6c75 6520 6973 2063 6f6e hat value is con │ │ │ │ │ -00010430: 7369 6465 7265 6420 6571 7569 7661 6c65 sidered equivale │ │ │ │ │ -00010440: 6e74 2074 6f20 2766 616c 7365 272e 2020 nt to 'false'. │ │ │ │ │ -00010450: 5468 6520 7661 7269 6162 6c65 7320 6172 The variables ar │ │ │ │ │ -00010460: 6520 616c 736f 0a63 6f6e 7369 6465 7265 e also.considere │ │ │ │ │ -00010470: 6420 746f 2062 6520 7365 7420 746f 2027 d to be set to ' │ │ │ │ │ -00010480: 6661 6c73 6527 2069 6620 7468 6579 2061 false' if they a │ │ │ │ │ -00010490: 7265 206e 6f74 2073 6574 2e0a 0a20 2020 re not set... │ │ │ │ │ -000104a0: 5768 656e 2062 6f6f 7469 6e67 2c20 7468 When booting, th │ │ │ │ │ -000104b0: 6520 4c69 6e75 7820 6b65 726e 656c 2077 e Linux kernel w │ │ │ │ │ -000104c0: 696c 6c20 6465 6c65 6761 7465 2074 6865 ill delegate the │ │ │ │ │ -000104d0: 2074 6173 6b20 6f66 206d 6f75 6e74 696e task of mountin │ │ │ │ │ -000104e0: 6720 7468 650a 726f 6f74 2066 696c 6573 g the.root files │ │ │ │ │ -000104f0: 7973 7465 6d20 746f 2074 6865 2069 6e69 ystem to the ini │ │ │ │ │ -00010500: 7472 642e 2020 4d6f 7374 2069 6e69 7472 trd. Most initr │ │ │ │ │ -00010510: 6420 696d 6167 6573 2064 6574 6572 6d69 d images determi │ │ │ │ │ -00010520: 6e65 2074 6865 2072 6f6f 740a 6669 6c65 ne the root.file │ │ │ │ │ -00010530: 2073 7973 7465 6d20 6279 2063 6865 636b system by check │ │ │ │ │ -00010540: 696e 6720 7468 6520 4c69 6e75 7820 6b65 ing the Linux ke │ │ │ │ │ -00010550: 726e 656c 2773 2063 6f6d 6d61 6e64 2d6c rnel's command-l │ │ │ │ │ -00010560: 696e 6520 666f 7220 7468 6520 2772 6f6f ine for the 'roo │ │ │ │ │ -00010570: 7427 0a6b 6579 2061 6e64 2075 7365 2069 t'.key and use i │ │ │ │ │ -00010580: 7473 2076 616c 7565 2061 7320 7468 6520 ts value as the │ │ │ │ │ -00010590: 6964 656e 7469 6669 6361 7469 6f6e 206d identification m │ │ │ │ │ -000105a0: 6574 686f 6420 6f66 2074 6865 2072 6f6f ethod of the roo │ │ │ │ │ -000105b0: 7420 6669 6c65 0a73 7973 7465 6d2e 2020 t file.system. │ │ │ │ │ -000105c0: 546f 2069 6d70 726f 7665 2074 6865 2072 To improve the r │ │ │ │ │ -000105d0: 656c 6961 6269 6c69 7479 206f 6620 626f eliability of bo │ │ │ │ │ -000105e0: 6f74 696e 672c 206d 6f73 7420 696e 6974 oting, most init │ │ │ │ │ -000105f0: 7264 2069 6d61 6765 7320 616c 736f 0a61 rd images also.a │ │ │ │ │ -00010600: 6c6c 6f77 2074 6865 2072 6f6f 7420 6669 llow the root fi │ │ │ │ │ -00010610: 6c65 2073 7973 7465 6d20 746f 2062 6520 le system to be │ │ │ │ │ -00010620: 6964 656e 7469 6669 6564 2062 7920 6974 identified by it │ │ │ │ │ -00010630: 7320 5555 4944 2e20 4265 6361 7573 6520 s UUID. Because │ │ │ │ │ -00010640: 6f66 2074 6869 730a 6265 6861 7669 6f72 of this.behavior │ │ │ │ │ -00010650: 2c20 7468 6520 2767 7275 622d 6d6b 636f , the 'grub-mkco │ │ │ │ │ -00010660: 6e66 6967 2720 636f 6d6d 616e 6420 7769 nfig' command wi │ │ │ │ │ -00010670: 6c6c 2073 6574 2027 726f 6f74 2720 746f ll set 'root' to │ │ │ │ │ -00010680: 2027 726f 6f74 3d55 5549 443d 2e2e 2e27 'root=UUID=...' │ │ │ │ │ -00010690: 0a74 6f20 7072 6f76 6964 6520 7468 6520 .to provide the │ │ │ │ │ -000106a0: 696e 6974 7264 2077 6974 6820 7468 6520 initrd with the │ │ │ │ │ -000106b0: 6669 6c65 7379 7374 656d 2055 5549 4420 filesystem UUID │ │ │ │ │ -000106c0: 6f66 2074 6865 2072 6f6f 7420 6669 6c65 of the root file │ │ │ │ │ -000106d0: 2073 7973 7465 6d2e 0a0a 2020 2049 6620 system... If │ │ │ │ │ -000106e0: 6e6f 2069 6e69 7472 6420 6973 2064 6574 no initrd is det │ │ │ │ │ -000106f0: 6563 7465 6420 6f72 2027 4752 5542 5f44 ected or 'GRUB_D │ │ │ │ │ -00010700: 4953 4142 4c45 5f4c 494e 5558 5f55 5549 ISABLE_LINUX_UUI │ │ │ │ │ -00010710: 4427 2069 7320 7365 7420 746f 0a27 7472 D' is set to.'tr │ │ │ │ │ -00010720: 7565 2720 7468 656e 2027 6772 7562 2d63 ue' then 'grub-c │ │ │ │ │ -00010730: 6f6d 6d61 6e64 2720 7769 6c6c 2069 6465 ommand' will ide │ │ │ │ │ -00010740: 6e74 6966 7920 7468 6520 726f 6f74 2066 ntify the root f │ │ │ │ │ -00010750: 696c 6573 7973 7465 6d20 6279 2073 6574 ilesystem by set │ │ │ │ │ -00010760: 7469 6e67 0a74 6865 206b 6572 6e65 6c20 ting.the kernel │ │ │ │ │ -00010770: 636f 6d6d 616e 642d 6c69 6e65 2076 6172 command-line var │ │ │ │ │ -00010780: 6961 626c 6520 2772 6f6f 7427 2074 6f20 iable 'root' to │ │ │ │ │ -00010790: 2772 6f6f 743d 5041 5254 5555 4944 3d2e 'root=PARTUUID=. │ │ │ │ │ -000107a0: 2e2e 2720 756e 6c65 7373 0a27 4752 5542 ..' unless.'GRUB │ │ │ │ │ -000107b0: 5f44 4953 4142 4c45 5f4c 494e 5558 5f50 _DISABLE_LINUX_P │ │ │ │ │ -000107c0: 4152 5455 5549 4427 2069 7320 616c 736f ARTUUID' is also │ │ │ │ │ -000107d0: 2073 6574 2074 6f20 2774 7275 6527 2e20 set to 'true'. │ │ │ │ │ -000107e0: 2049 660a 2747 5255 425f 4449 5341 424c If.'GRUB_DISABL │ │ │ │ │ -000107f0: 455f 4c49 4e55 585f 5041 5254 5555 4944 E_LINUX_PARTUUID │ │ │ │ │ -00010800: 2720 6973 2061 6c73 6f20 7365 7420 746f ' is also set to │ │ │ │ │ -00010810: 2027 7472 7565 272c 2027 6772 7562 2d63 'true', 'grub-c │ │ │ │ │ -00010820: 6f6d 6d61 6e64 2720 7769 6c6c 0a69 6465 ommand' will.ide │ │ │ │ │ -00010830: 6e74 6966 7920 6279 2069 7473 204c 696e ntify by its Lin │ │ │ │ │ -00010840: 7578 2064 6576 6963 6520 6e61 6d65 2e0a ux device name.. │ │ │ │ │ -00010850: 0a20 2020 5468 6520 666f 6c6c 6f77 696e . The followin │ │ │ │ │ -00010860: 6720 7461 626c 6520 7375 6d6d 6172 697a g table summariz │ │ │ │ │ -00010870: 6573 2074 6865 2062 6568 6176 696f 7220 es the behavior │ │ │ │ │ -00010880: 6f66 2074 6865 2027 6772 7562 2d6d 6b63 of the 'grub-mkc │ │ │ │ │ -00010890: 6f6e 6669 6727 0a63 6f6d 6d61 6e64 2e0a onfig'.command.. │ │ │ │ │ -000108a0: 0a49 6e69 7472 6420 2020 2020 4752 5542 .Initrd GRUB │ │ │ │ │ -000108b0: 5f44 4953 4142 4c45 5f4c 494e 5558 5f50 _DISABLE_LINUX_P │ │ │ │ │ -000108c0: 4152 5455 5549 4420 2020 4752 5542 5f44 ARTUUID GRUB_D │ │ │ │ │ -000108d0: 4953 4142 4c45 5f4c 494e 5558 5f55 5549 ISABLE_LINUX_UUI │ │ │ │ │ -000108e0: 4420 2020 4c69 6e75 7820 526f 6f74 0a64 D Linux Root.d │ │ │ │ │ -000108f0: 6574 6563 7465 6420 2020 5365 7420 546f etected Set To │ │ │ │ │ -00010900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010910: 2020 2020 2020 2020 5365 7420 546f 2020 Set To │ │ │ │ │ +00010170: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 =============..I │ │ │ │ │ +00010180: 6620 7468 6520 7461 7267 6574 206f 7065 f the target ope │ │ │ │ │ +00010190: 7261 7469 6e67 2073 7973 7465 6d20 7573 rating system us │ │ │ │ │ +000101a0: 6573 2074 6865 204c 696e 7578 206b 6572 es the Linux ker │ │ │ │ │ +000101b0: 6e65 6c2c 2027 6772 7562 2d6d 6b63 6f6e nel, 'grub-mkcon │ │ │ │ │ +000101c0: 6669 6727 0a61 7474 656d 7074 7320 746f fig'.attempts to │ │ │ │ │ +000101d0: 2069 6465 6e74 6966 7920 7468 6520 726f identify the ro │ │ │ │ │ +000101e0: 6f74 2066 696c 6520 7379 7374 656d 2076 ot file system v │ │ │ │ │ +000101f0: 6961 2061 2068 6575 7269 7374 6963 2061 ia a heuristic a │ │ │ │ │ +00010200: 6c67 6f69 7274 686d 2e0a 5468 6973 2061 lgoirthm..This a │ │ │ │ │ +00010210: 6c67 6f72 6974 686d 2073 656c 6563 7473 lgorithm selects │ │ │ │ │ +00010220: 2074 6865 2069 6465 6e74 6966 6963 6174 the identificat │ │ │ │ │ +00010230: 696f 6e20 6d65 7468 6f64 206f 6620 7468 ion method of th │ │ │ │ │ +00010240: 6520 726f 6f74 2066 696c 6520 7379 7374 e root file syst │ │ │ │ │ +00010250: 656d 0a62 7920 636f 6e73 6964 6572 696e em.by considerin │ │ │ │ │ +00010260: 6720 7468 7265 6520 6661 6374 6f72 732e g three factors. │ │ │ │ │ +00010270: 2020 5468 6520 6669 7273 7420 6973 2069 The first is i │ │ │ │ │ +00010280: 6620 616e 2069 6e69 7472 6420 666f 7220 f an initrd for │ │ │ │ │ +00010290: 7468 6520 7461 7267 6574 0a6f 7065 7261 the target.opera │ │ │ │ │ +000102a0: 7469 6e67 2073 7973 7465 6d20 6973 2061 ting system is a │ │ │ │ │ +000102b0: 6c73 6f20 7072 6573 656e 742e 2020 5468 lso present. Th │ │ │ │ │ +000102c0: 6520 7365 636f 6e64 2069 730a 2747 5255 e second is.'GRU │ │ │ │ │ +000102d0: 425f 4449 5341 424c 455f 4c49 4e55 585f B_DISABLE_LINUX_ │ │ │ │ │ +000102e0: 5555 4944 2720 616e 6420 6966 2073 6574 UUID' and if set │ │ │ │ │ +000102f0: 2074 6f20 2774 7275 6527 2c20 7072 6576 to 'true', prev │ │ │ │ │ +00010300: 656e 7473 2027 6772 7562 2d6d 6b63 6f6e ents 'grub-mkcon │ │ │ │ │ +00010310: 6669 6727 0a66 726f 6d20 6964 656e 7469 fig'.from identi │ │ │ │ │ +00010320: 6679 696e 6720 7468 6520 726f 6f74 2066 fying the root f │ │ │ │ │ +00010330: 696c 6520 7379 7374 656d 2062 7920 6974 ile system by it │ │ │ │ │ +00010340: 7320 5555 4944 2e20 5468 6520 7468 6972 s UUID. The thir │ │ │ │ │ +00010350: 6420 6973 0a27 4752 5542 5f44 4953 4142 d is.'GRUB_DISAB │ │ │ │ │ +00010360: 4c45 5f4c 494e 5558 5f50 4152 5455 5549 LE_LINUX_PARTUUI │ │ │ │ │ +00010370: 4427 2061 6e64 2069 6620 7365 7420 746f D' and if set to │ │ │ │ │ +00010380: 2027 7472 7565 272c 2070 7265 7665 6e74 'true', prevent │ │ │ │ │ +00010390: 730a 2767 7275 622d 6d6b 636f 6e66 6967 s.'grub-mkconfig │ │ │ │ │ +000103a0: 2720 6672 6f6d 2069 6465 6e74 6966 7969 ' from identifyi │ │ │ │ │ +000103b0: 6e67 2074 6865 2072 6f6f 7420 6669 6c65 ng the root file │ │ │ │ │ +000103c0: 2073 7973 7465 6d20 7669 6120 7468 6520 system via the │ │ │ │ │ +000103d0: 5555 4944 206f 660a 6974 7320 656e 636c UUID of.its encl │ │ │ │ │ +000103e0: 6f73 696e 6720 7061 7274 6974 696f 6e2e osing partition. │ │ │ │ │ +000103f0: 2020 4966 2074 6865 2076 6172 6961 626c If the variabl │ │ │ │ │ +00010400: 6573 2061 7265 2061 7373 6967 6e65 6420 es are assigned │ │ │ │ │ +00010410: 616e 7920 6f74 6865 7220 7661 6c75 652c any other value, │ │ │ │ │ +00010420: 0a74 6861 7420 7661 6c75 6520 6973 2063 .that value is c │ │ │ │ │ +00010430: 6f6e 7369 6465 7265 6420 6571 7569 7661 onsidered equiva │ │ │ │ │ +00010440: 6c65 6e74 2074 6f20 2766 616c 7365 272e lent to 'false'. │ │ │ │ │ +00010450: 2020 5468 6520 7661 7269 6162 6c65 7320 The variables │ │ │ │ │ +00010460: 6172 6520 616c 736f 0a63 6f6e 7369 6465 are also.conside │ │ │ │ │ +00010470: 7265 6420 746f 2062 6520 7365 7420 746f red to be set to │ │ │ │ │ +00010480: 2027 6661 6c73 6527 2069 6620 7468 6579 'false' if they │ │ │ │ │ +00010490: 2061 7265 206e 6f74 2073 6574 2e0a 0a20 are not set... │ │ │ │ │ +000104a0: 2020 5768 656e 2062 6f6f 7469 6e67 2c20 When booting, │ │ │ │ │ +000104b0: 7468 6520 4c69 6e75 7820 6b65 726e 656c the Linux kernel │ │ │ │ │ +000104c0: 2077 696c 6c20 6465 6c65 6761 7465 2074 will delegate t │ │ │ │ │ +000104d0: 6865 2074 6173 6b20 6f66 206d 6f75 6e74 he task of mount │ │ │ │ │ +000104e0: 696e 6720 7468 650a 726f 6f74 2066 696c ing the.root fil │ │ │ │ │ +000104f0: 6573 7973 7465 6d20 746f 2074 6865 2069 esystem to the i │ │ │ │ │ +00010500: 6e69 7472 642e 2020 4d6f 7374 2069 6e69 nitrd. Most ini │ │ │ │ │ +00010510: 7472 6420 696d 6167 6573 2064 6574 6572 trd images deter │ │ │ │ │ +00010520: 6d69 6e65 2074 6865 2072 6f6f 740a 6669 mine the root.fi │ │ │ │ │ +00010530: 6c65 2073 7973 7465 6d20 6279 2063 6865 le system by che │ │ │ │ │ +00010540: 636b 696e 6720 7468 6520 4c69 6e75 7820 cking the Linux │ │ │ │ │ +00010550: 6b65 726e 656c 2773 2063 6f6d 6d61 6e64 kernel's command │ │ │ │ │ +00010560: 2d6c 696e 6520 666f 7220 7468 6520 2772 -line for the 'r │ │ │ │ │ +00010570: 6f6f 7427 0a6b 6579 2061 6e64 2075 7365 oot'.key and use │ │ │ │ │ +00010580: 2069 7473 2076 616c 7565 2061 7320 7468 its value as th │ │ │ │ │ +00010590: 6520 6964 656e 7469 6669 6361 7469 6f6e e identification │ │ │ │ │ +000105a0: 206d 6574 686f 6420 6f66 2074 6865 2072 method of the r │ │ │ │ │ +000105b0: 6f6f 7420 6669 6c65 0a73 7973 7465 6d2e oot file.system. │ │ │ │ │ +000105c0: 2020 546f 2069 6d70 726f 7665 2074 6865 To improve the │ │ │ │ │ +000105d0: 2072 656c 6961 6269 6c69 7479 206f 6620 reliability of │ │ │ │ │ +000105e0: 626f 6f74 696e 672c 206d 6f73 7420 696e booting, most in │ │ │ │ │ +000105f0: 6974 7264 2069 6d61 6765 7320 616c 736f itrd images also │ │ │ │ │ +00010600: 0a61 6c6c 6f77 2074 6865 2072 6f6f 7420 .allow the root │ │ │ │ │ +00010610: 6669 6c65 2073 7973 7465 6d20 746f 2062 file system to b │ │ │ │ │ +00010620: 6520 6964 656e 7469 6669 6564 2062 7920 e identified by │ │ │ │ │ +00010630: 6974 7320 5555 4944 2e20 4265 6361 7573 its UUID. Becaus │ │ │ │ │ +00010640: 6520 6f66 2074 6869 730a 6265 6861 7669 e of this.behavi │ │ │ │ │ +00010650: 6f72 2c20 7468 6520 2767 7275 622d 6d6b or, the 'grub-mk │ │ │ │ │ +00010660: 636f 6e66 6967 2720 636f 6d6d 616e 6420 config' command │ │ │ │ │ +00010670: 7769 6c6c 2073 6574 2027 726f 6f74 2720 will set 'root' │ │ │ │ │ +00010680: 746f 2027 726f 6f74 3d55 5549 443d 2e2e to 'root=UUID=.. │ │ │ │ │ +00010690: 2e27 0a74 6f20 7072 6f76 6964 6520 7468 .'.to provide th │ │ │ │ │ +000106a0: 6520 696e 6974 7264 2077 6974 6820 7468 e initrd with th │ │ │ │ │ +000106b0: 6520 6669 6c65 7379 7374 656d 2055 5549 e filesystem UUI │ │ │ │ │ +000106c0: 4420 6f66 2074 6865 2072 6f6f 7420 6669 D of the root fi │ │ │ │ │ +000106d0: 6c65 2073 7973 7465 6d2e 0a0a 2020 2049 le system... I │ │ │ │ │ +000106e0: 6620 6e6f 2069 6e69 7472 6420 6973 2064 f no initrd is d │ │ │ │ │ +000106f0: 6574 6563 7465 6420 6f72 2027 4752 5542 etected or 'GRUB │ │ │ │ │ +00010700: 5f44 4953 4142 4c45 5f4c 494e 5558 5f55 _DISABLE_LINUX_U │ │ │ │ │ +00010710: 5549 4427 2069 7320 7365 7420 746f 0a27 UID' is set to.' │ │ │ │ │ +00010720: 7472 7565 2720 7468 656e 2027 6772 7562 true' then 'grub │ │ │ │ │ +00010730: 2d63 6f6d 6d61 6e64 2720 7769 6c6c 2069 -command' will i │ │ │ │ │ +00010740: 6465 6e74 6966 7920 7468 6520 726f 6f74 dentify the root │ │ │ │ │ +00010750: 2066 696c 6573 7973 7465 6d20 6279 2073 filesystem by s │ │ │ │ │ +00010760: 6574 7469 6e67 0a74 6865 206b 6572 6e65 etting.the kerne │ │ │ │ │ +00010770: 6c20 636f 6d6d 616e 642d 6c69 6e65 2076 l command-line v │ │ │ │ │ +00010780: 6172 6961 626c 6520 2772 6f6f 7427 2074 ariable 'root' t │ │ │ │ │ +00010790: 6f20 2772 6f6f 743d 5041 5254 5555 4944 o 'root=PARTUUID │ │ │ │ │ +000107a0: 3d2e 2e2e 2720 756e 6c65 7373 0a27 4752 =...' unless.'GR │ │ │ │ │ +000107b0: 5542 5f44 4953 4142 4c45 5f4c 494e 5558 UB_DISABLE_LINUX │ │ │ │ │ +000107c0: 5f50 4152 5455 5549 4427 2069 7320 616c _PARTUUID' is al │ │ │ │ │ +000107d0: 736f 2073 6574 2074 6f20 2774 7275 6527 so set to 'true' │ │ │ │ │ +000107e0: 2e20 2049 660a 2747 5255 425f 4449 5341 . If.'GRUB_DISA │ │ │ │ │ +000107f0: 424c 455f 4c49 4e55 585f 5041 5254 5555 BLE_LINUX_PARTUU │ │ │ │ │ +00010800: 4944 2720 6973 2061 6c73 6f20 7365 7420 ID' is also set │ │ │ │ │ +00010810: 746f 2027 7472 7565 272c 2027 6772 7562 to 'true', 'grub │ │ │ │ │ +00010820: 2d63 6f6d 6d61 6e64 2720 7769 6c6c 0a69 -command' will.i │ │ │ │ │ +00010830: 6465 6e74 6966 7920 6279 2069 7473 204c dentify by its L │ │ │ │ │ +00010840: 696e 7578 2064 6576 6963 6520 6e61 6d65 inux device name │ │ │ │ │ +00010850: 2e0a 0a20 2020 5468 6520 666f 6c6c 6f77 ... The follow │ │ │ │ │ +00010860: 696e 6720 7461 626c 6520 7375 6d6d 6172 ing table summar │ │ │ │ │ +00010870: 697a 6573 2074 6865 2062 6568 6176 696f izes the behavio │ │ │ │ │ +00010880: 7220 6f66 2074 6865 2027 6772 7562 2d6d r of the 'grub-m │ │ │ │ │ +00010890: 6b63 6f6e 6669 6727 0a63 6f6d 6d61 6e64 kconfig'.command │ │ │ │ │ +000108a0: 2e0a 0a49 6e69 7472 6420 2020 2020 4752 ...Initrd GR │ │ │ │ │ +000108b0: 5542 5f44 4953 4142 4c45 5f4c 494e 5558 UB_DISABLE_LINUX │ │ │ │ │ +000108c0: 5f50 4152 5455 5549 4420 2020 4752 5542 _PARTUUID GRUB │ │ │ │ │ +000108d0: 5f44 4953 4142 4c45 5f4c 494e 5558 5f55 _DISABLE_LINUX_U │ │ │ │ │ +000108e0: 5549 4420 2020 4c69 6e75 7820 526f 6f74 UID Linux Root │ │ │ │ │ +000108f0: 0a64 6574 6563 7465 6420 2020 5365 7420 .detected Set │ │ │ │ │ +00010900: 546f 2020 2020 2020 2020 2020 2020 2020 To │ │ │ │ │ +00010910: 2020 2020 2020 2020 2020 5365 7420 546f Set To │ │ │ │ │ 00010920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010930: 2020 4944 204d 6574 686f 640a 2d2d 2d2d ID Method.---- │ │ │ │ │ +00010930: 2020 2020 4944 204d 6574 686f 640a 2d2d ID Method.-- │ │ │ │ │ 00010940: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00010950: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00010960: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00010970: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00010980: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a66 616c ------------.fal │ │ │ │ │ -00010990: 7365 2020 2020 2020 6661 6c73 6520 2020 se false │ │ │ │ │ +00010980: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a66 --------------.f │ │ │ │ │ +00010990: 616c 7365 2020 2020 2020 6661 6c73 6520 alse false │ │ │ │ │ 000109a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000109b0: 2020 2020 2020 6661 6c73 6520 2020 2020 false │ │ │ │ │ +000109b0: 2020 2020 2020 2020 6661 6c73 6520 2020 false │ │ │ │ │ 000109c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000109d0: 7061 7274 2055 5549 440a 6661 6c73 6520 part UUID.false │ │ │ │ │ -000109e0: 2020 2020 2066 616c 7365 2020 2020 2020 false │ │ │ │ │ +000109d0: 2020 7061 7274 2055 5549 440a 6661 6c73 part UUID.fals │ │ │ │ │ +000109e0: 6520 2020 2020 2066 616c 7365 2020 2020 e false │ │ │ │ │ 000109f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010a00: 2020 2074 7275 6520 2020 2020 2020 2020 true │ │ │ │ │ -00010a10: 2020 2020 2020 2020 2020 2020 2070 6172 par │ │ │ │ │ -00010a20: 7420 5555 4944 0a66 616c 7365 2020 2020 t UUID.false │ │ │ │ │ -00010a30: 2020 7472 7565 2020 2020 2020 2020 2020 true │ │ │ │ │ +00010a00: 2020 2020 2074 7275 6520 2020 2020 2020 true │ │ │ │ │ +00010a10: 2020 2020 2020 2020 2020 2020 2020 2070 p │ │ │ │ │ +00010a20: 6172 7420 5555 4944 0a66 616c 7365 2020 art UUID.false │ │ │ │ │ +00010a30: 2020 2020 7472 7565 2020 2020 2020 2020 true │ │ │ │ │ 00010a40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010a50: 6661 6c73 6520 2020 2020 2020 2020 2020 false │ │ │ │ │ -00010a60: 2020 2020 2020 2020 2020 6465 7620 6e61 dev na │ │ │ │ │ -00010a70: 6d65 0a66 616c 7365 2020 2020 2020 7472 me.false tr │ │ │ │ │ -00010a80: 7565 2020 2020 2020 2020 2020 2020 2020 ue │ │ │ │ │ -00010a90: 2020 2020 2020 2020 2020 2020 7472 7565 true │ │ │ │ │ -00010aa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010ab0: 2020 2020 2020 6465 7620 6e61 6d65 0a74 dev name.t │ │ │ │ │ -00010ac0: 7275 6520 2020 2020 2020 6661 6c73 6520 rue false │ │ │ │ │ -00010ad0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010ae0: 2020 2020 2020 2020 6661 6c73 6520 2020 false │ │ │ │ │ +00010a50: 2020 6661 6c73 6520 2020 2020 2020 2020 false │ │ │ │ │ +00010a60: 2020 2020 2020 2020 2020 2020 6465 7620 dev │ │ │ │ │ +00010a70: 6e61 6d65 0a66 616c 7365 2020 2020 2020 name.false │ │ │ │ │ +00010a80: 7472 7565 2020 2020 2020 2020 2020 2020 true │ │ │ │ │ +00010a90: 2020 2020 2020 2020 2020 2020 2020 7472 tr │ │ │ │ │ +00010aa0: 7565 2020 2020 2020 2020 2020 2020 2020 ue │ │ │ │ │ +00010ab0: 2020 2020 2020 2020 6465 7620 6e61 6d65 dev name │ │ │ │ │ +00010ac0: 0a74 7275 6520 2020 2020 2020 6661 6c73 .true fals │ │ │ │ │ +00010ad0: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ │ +00010ae0: 2020 2020 2020 2020 2020 6661 6c73 6520 false │ │ │ │ │ 00010af0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010b00: 2020 6673 2055 5549 440a 7472 7565 2020 fs UUID.true │ │ │ │ │ -00010b10: 2020 2020 2066 616c 7365 2020 2020 2020 false │ │ │ │ │ +00010b00: 2020 2020 6673 2055 5549 440a 7472 7565 fs UUID.true │ │ │ │ │ +00010b10: 2020 2020 2020 2066 616c 7365 2020 2020 false │ │ │ │ │ 00010b20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010b30: 2020 2074 7275 6520 2020 2020 2020 2020 true │ │ │ │ │ -00010b40: 2020 2020 2020 2020 2020 2020 2070 6172 par │ │ │ │ │ -00010b50: 7420 5555 4944 0a74 7275 6520 2020 2020 t UUID.true │ │ │ │ │ -00010b60: 2020 7472 7565 2020 2020 2020 2020 2020 true │ │ │ │ │ +00010b30: 2020 2020 2074 7275 6520 2020 2020 2020 true │ │ │ │ │ +00010b40: 2020 2020 2020 2020 2020 2020 2020 2070 p │ │ │ │ │ +00010b50: 6172 7420 5555 4944 0a74 7275 6520 2020 art UUID.true │ │ │ │ │ +00010b60: 2020 2020 7472 7565 2020 2020 2020 2020 true │ │ │ │ │ 00010b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010b80: 6661 6c73 6520 2020 2020 2020 2020 2020 false │ │ │ │ │ -00010b90: 2020 2020 2020 2020 2020 6673 2055 5549 fs UUI │ │ │ │ │ -00010ba0: 440a 7472 7565 2020 2020 2020 2074 7275 D.true tru │ │ │ │ │ -00010bb0: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ │ -00010bc0: 2020 2020 2020 2020 2020 2074 7275 6520 true │ │ │ │ │ -00010bd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00010be0: 2020 2020 2064 6576 206e 616d 650a 0a20 dev name.. │ │ │ │ │ -00010bf0: 2020 5265 6d65 6d62 6572 2c20 2747 5255 Remember, 'GRU │ │ │ │ │ -00010c00: 425f 4449 5341 424c 455f 4c49 4e55 585f B_DISABLE_LINUX_ │ │ │ │ │ -00010c10: 5041 5254 5555 4944 2720 616e 6420 2747 PARTUUID' and 'G │ │ │ │ │ -00010c20: 5255 425f 4449 5341 424c 455f 4c49 4e55 RUB_DISABLE_LINU │ │ │ │ │ -00010c30: 585f 5555 4944 270a 6172 6520 616c 736f X_UUID'.are also │ │ │ │ │ -00010c40: 2063 6f6e 7369 6465 7265 6420 746f 2062 considered to b │ │ │ │ │ -00010c50: 6520 7365 7420 746f 2027 6661 6c73 6527 e set to 'false' │ │ │ │ │ -00010c60: 2077 6865 6e20 7468 6579 2061 7265 2075 when they are u │ │ │ │ │ -00010c70: 6e73 6574 2e0a 0a1f 0a46 696c 653a 2067 nset.....File: g │ │ │ │ │ -00010c80: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00010c90: 2053 6865 6c6c 2d6c 696b 6520 7363 7269 Shell-like scri │ │ │ │ │ -00010ca0: 7074 696e 672c 2020 4e65 7874 3a20 4d75 pting, Next: Mu │ │ │ │ │ -00010cb0: 6c74 692d 626f 6f74 206d 616e 7561 6c20 lti-boot manual │ │ │ │ │ -00010cc0: 636f 6e66 6967 2c20 2050 7265 763a 2052 config, Prev: R │ │ │ │ │ -00010cd0: 6f6f 7420 4964 656e 7469 6663 6174 696f oot Identifcatio │ │ │ │ │ -00010ce0: 6e20 4865 7572 6973 7469 6373 2c20 2055 n Heuristics, U │ │ │ │ │ -00010cf0: 703a 2043 6f6e 6669 6775 7261 7469 6f6e p: Configuration │ │ │ │ │ -00010d00: 0a0a 362e 3320 5772 6974 696e 6720 6675 ..6.3 Writing fu │ │ │ │ │ -00010d10: 6c6c 2063 6f6e 6669 6775 7261 7469 6f6e ll configuration │ │ │ │ │ -00010d20: 2066 696c 6573 2064 6972 6563 746c 790a files directly. │ │ │ │ │ -00010d30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00010b80: 2020 6661 6c73 6520 2020 2020 2020 2020 false │ │ │ │ │ +00010b90: 2020 2020 2020 2020 2020 2020 6673 2055 fs U │ │ │ │ │ +00010ba0: 5549 440a 7472 7565 2020 2020 2020 2074 UID.true t │ │ │ │ │ +00010bb0: 7275 6520 2020 2020 2020 2020 2020 2020 rue │ │ │ │ │ +00010bc0: 2020 2020 2020 2020 2020 2020 2074 7275 tru │ │ │ │ │ +00010bd0: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ │ +00010be0: 2020 2020 2020 2064 6576 206e 616d 650a dev name. │ │ │ │ │ +00010bf0: 0a20 2020 5265 6d65 6d62 6572 2c20 2747 . Remember, 'G │ │ │ │ │ +00010c00: 5255 425f 4449 5341 424c 455f 4c49 4e55 RUB_DISABLE_LINU │ │ │ │ │ +00010c10: 585f 5041 5254 5555 4944 2720 616e 6420 X_PARTUUID' and │ │ │ │ │ +00010c20: 2747 5255 425f 4449 5341 424c 455f 4c49 'GRUB_DISABLE_LI │ │ │ │ │ +00010c30: 4e55 585f 5555 4944 270a 6172 6520 616c NUX_UUID'.are al │ │ │ │ │ +00010c40: 736f 2063 6f6e 7369 6465 7265 6420 746f so considered to │ │ │ │ │ +00010c50: 2062 6520 7365 7420 746f 2027 6661 6c73 be set to 'fals │ │ │ │ │ +00010c60: 6527 2077 6865 6e20 7468 6579 2061 7265 e' when they are │ │ │ │ │ +00010c70: 2075 6e73 6574 2e0a 0a1f 0a46 696c 653a unset.....File: │ │ │ │ │ +00010c80: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00010c90: 653a 2053 6865 6c6c 2d6c 696b 6520 7363 e: Shell-like sc │ │ │ │ │ +00010ca0: 7269 7074 696e 672c 2020 4e65 7874 3a20 ripting, Next: │ │ │ │ │ +00010cb0: 4d75 6c74 692d 626f 6f74 206d 616e 7561 Multi-boot manua │ │ │ │ │ +00010cc0: 6c20 636f 6e66 6967 2c20 2050 7265 763a l config, Prev: │ │ │ │ │ +00010cd0: 2052 6f6f 7420 4964 656e 7469 6663 6174 Root Identifcat │ │ │ │ │ +00010ce0: 696f 6e20 4865 7572 6973 7469 6373 2c20 ion Heuristics, │ │ │ │ │ +00010cf0: 2055 703a 2043 6f6e 6669 6775 7261 7469 Up: Configurati │ │ │ │ │ +00010d00: 6f6e 0a0a 362e 3320 5772 6974 696e 6720 on..6.3 Writing │ │ │ │ │ +00010d10: 6675 6c6c 2063 6f6e 6669 6775 7261 7469 full configurati │ │ │ │ │ +00010d20: 6f6e 2066 696c 6573 2064 6972 6563 746c on files directl │ │ │ │ │ +00010d30: 790a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d y.============== │ │ │ │ │ 00010d40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00010d50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a27 =============..' │ │ │ │ │ -00010d60: 6772 7562 2e63 6667 2720 6973 2077 7269 grub.cfg' is wri │ │ │ │ │ -00010d70: 7474 656e 2069 6e20 4752 5542 2773 2062 tten in GRUB's b │ │ │ │ │ -00010d80: 7569 6c74 2d69 6e20 7363 7269 7074 696e uilt-in scriptin │ │ │ │ │ -00010d90: 6720 6c61 6e67 7561 6765 2c20 7768 6963 g language, whic │ │ │ │ │ -00010da0: 6820 6861 7320 610a 7379 6e74 6178 2071 h has a.syntax q │ │ │ │ │ -00010db0: 7569 7465 2073 696d 696c 6172 2074 6f20 uite similar to │ │ │ │ │ -00010dc0: 7468 6174 206f 6620 474e 5520 4261 7368 that of GNU Bash │ │ │ │ │ -00010dd0: 2061 6e64 206f 7468 6572 2042 6f75 726e and other Bourn │ │ │ │ │ -00010de0: 6520 7368 656c 6c0a 6465 7269 7661 7469 e shell.derivati │ │ │ │ │ -00010df0: 7665 732e 0a0a 576f 7264 730a 3d3d 3d3d ves...Words.==== │ │ │ │ │ -00010e00: 3d0a 0a41 2022 776f 7264 2220 6973 2061 =..A "word" is a │ │ │ │ │ -00010e10: 2073 6571 7565 6e63 6520 6f66 2063 6861 sequence of cha │ │ │ │ │ -00010e20: 7261 6374 6572 7320 636f 6e73 6964 6572 racters consider │ │ │ │ │ -00010e30: 6564 2061 7320 6120 7369 6e67 6c65 2075 ed as a single u │ │ │ │ │ -00010e40: 6e69 7420 6279 0a47 5255 422e 2057 6f72 nit by.GRUB. Wor │ │ │ │ │ -00010e50: 6473 2061 7265 2073 6570 6172 6174 6564 ds are separated │ │ │ │ │ -00010e60: 2062 7920 226d 6574 6163 6861 7261 6374 by "metacharact │ │ │ │ │ -00010e70: 6572 7322 2c20 7768 6963 6820 6172 6520 ers", which are │ │ │ │ │ -00010e80: 7468 6520 666f 6c6c 6f77 696e 670a 706c the following.pl │ │ │ │ │ -00010e90: 7573 2073 7061 6365 2c20 7461 622c 2061 us space, tab, a │ │ │ │ │ -00010ea0: 6e64 206e 6577 6c69 6e65 3a0a 0a20 2020 nd newline:.. │ │ │ │ │ -00010eb0: 2020 7b20 7d20 7c20 2620 2420 3b20 3c20 { } | & $ ; < │ │ │ │ │ -00010ec0: 3e0a 0a20 2020 5175 6f74 696e 6720 6d61 >.. Quoting ma │ │ │ │ │ -00010ed0: 7920 6265 2075 7365 6420 746f 2069 6e63 y be used to inc │ │ │ │ │ -00010ee0: 6c75 6465 206d 6574 6163 6861 7261 6374 lude metacharact │ │ │ │ │ -00010ef0: 6572 7320 696e 2077 6f72 6473 3b20 7365 ers in words; se │ │ │ │ │ -00010f00: 6520 6265 6c6f 772e 0a0a 5265 7365 7276 e below...Reserv │ │ │ │ │ -00010f10: 6564 2077 6f72 6473 0a3d 3d3d 3d3d 3d3d ed words.======= │ │ │ │ │ -00010f20: 3d3d 3d3d 3d3d 3d0a 0a52 6573 6572 7665 =======..Reserve │ │ │ │ │ -00010f30: 6420 776f 7264 7320 6861 7665 2061 2073 d words have a s │ │ │ │ │ -00010f40: 7065 6369 616c 206d 6561 6e69 6e67 2074 pecial meaning t │ │ │ │ │ -00010f50: 6f20 4752 5542 2e20 5468 6520 666f 6c6c o GRUB. The foll │ │ │ │ │ -00010f60: 6f77 696e 6720 776f 7264 7320 6172 650a owing words are. │ │ │ │ │ -00010f70: 7265 636f 676e 6973 6564 2061 7320 7265 recognised as re │ │ │ │ │ -00010f80: 7365 7276 6564 2077 6865 6e20 756e 7175 served when unqu │ │ │ │ │ -00010f90: 6f74 6564 2061 6e64 2065 6974 6865 7220 oted and either │ │ │ │ │ -00010fa0: 7468 6520 6669 7273 7420 776f 7264 206f the first word o │ │ │ │ │ -00010fb0: 6620 610a 7369 6d70 6c65 2063 6f6d 6d61 f a.simple comma │ │ │ │ │ -00010fc0: 6e64 206f 7220 7468 6520 7468 6972 6420 nd or the third │ │ │ │ │ -00010fd0: 776f 7264 206f 6620 6120 2766 6f72 2720 word of a 'for' │ │ │ │ │ -00010fe0: 636f 6d6d 616e 643a 0a0a 2020 2020 2021 command:.. ! │ │ │ │ │ -00010ff0: 205b 5b20 5d5d 207b 207d 0a20 2020 2020 [[ ]] { }. │ │ │ │ │ -00011000: 6361 7365 2064 6f20 646f 6e65 2065 6c69 case do done eli │ │ │ │ │ -00011010: 6620 656c 7365 2065 7361 6320 6669 2066 f else esac fi f │ │ │ │ │ -00011020: 6f72 2066 756e 6374 696f 6e0a 2020 2020 or function. │ │ │ │ │ -00011030: 2069 6620 696e 206d 656e 7565 6e74 7279 if in menuentry │ │ │ │ │ -00011040: 2073 656c 6563 7420 7468 656e 2074 696d select then tim │ │ │ │ │ -00011050: 6520 756e 7469 6c20 7768 696c 650a 0a20 e until while.. │ │ │ │ │ -00011060: 2020 4e6f 7420 616c 6c20 6f66 2074 6865 Not all of the │ │ │ │ │ -00011070: 7365 2072 6573 6572 7665 6420 776f 7264 se reserved word │ │ │ │ │ -00011080: 7320 6861 7665 2061 2075 7365 6675 6c20 s have a useful │ │ │ │ │ -00011090: 7075 7270 6f73 6520 7965 743b 2073 6f6d purpose yet; som │ │ │ │ │ -000110a0: 6520 6172 650a 7265 7365 7276 6564 2066 e are.reserved f │ │ │ │ │ -000110b0: 6f72 2066 7574 7572 6520 6578 7061 6e73 or future expans │ │ │ │ │ -000110c0: 696f 6e2e 0a0a 5175 6f74 696e 670a 3d3d ion...Quoting.== │ │ │ │ │ -000110d0: 3d3d 3d3d 3d0a 0a51 756f 7469 6e67 2069 =====..Quoting i │ │ │ │ │ -000110e0: 7320 7573 6564 2074 6f20 7265 6d6f 7665 s used to remove │ │ │ │ │ -000110f0: 2074 6865 2073 7065 6369 616c 206d 6561 the special mea │ │ │ │ │ -00011100: 6e69 6e67 206f 6620 6365 7274 6169 6e20 ning of certain │ │ │ │ │ -00011110: 6368 6172 6163 7465 7273 206f 720a 776f characters or.wo │ │ │ │ │ -00011120: 7264 732e 2020 4974 2063 616e 2062 6520 rds. It can be │ │ │ │ │ -00011130: 7573 6564 2074 6f20 7472 6561 7420 6d65 used to treat me │ │ │ │ │ -00011140: 7461 6368 6172 6163 7465 7273 2061 7320 tacharacters as │ │ │ │ │ -00011150: 7061 7274 206f 6620 6120 776f 7264 2c20 part of a word, │ │ │ │ │ -00011160: 746f 0a70 7265 7665 6e74 2072 6573 6572 to.prevent reser │ │ │ │ │ -00011170: 7665 6420 776f 7264 7320 6672 6f6d 2062 ved words from b │ │ │ │ │ -00011180: 6569 6e67 2072 6563 6f67 6e69 7365 6420 eing recognised │ │ │ │ │ -00011190: 6173 2073 7563 682c 2061 6e64 2074 6f20 as such, and to │ │ │ │ │ -000111a0: 7072 6576 656e 740a 7661 7269 6162 6c65 prevent.variable │ │ │ │ │ -000111b0: 2065 7870 616e 7369 6f6e 2e0a 0a20 2020 expansion... │ │ │ │ │ -000111c0: 5468 6572 6520 6172 6520 7468 7265 6520 There are three │ │ │ │ │ -000111d0: 7175 6f74 696e 6720 6d65 6368 616e 6973 quoting mechanis │ │ │ │ │ -000111e0: 6d73 3a20 7468 6520 6573 6361 7065 2063 ms: the escape c │ │ │ │ │ -000111f0: 6861 7261 6374 6572 2c20 7369 6e67 6c65 haracter, single │ │ │ │ │ -00011200: 0a71 756f 7465 732c 2061 6e64 2064 6f75 .quotes, and dou │ │ │ │ │ -00011210: 626c 6520 7175 6f74 6573 2e0a 0a20 2020 ble quotes... │ │ │ │ │ -00011220: 4120 6e6f 6e2d 7175 6f74 6564 2062 6163 A non-quoted bac │ │ │ │ │ -00011230: 6b73 6c61 7368 2028 5c29 2069 7320 7468 kslash (\) is th │ │ │ │ │ -00011240: 6520 2265 7363 6170 6520 6368 6172 6163 e "escape charac │ │ │ │ │ -00011250: 7465 7222 2e20 2049 7420 7072 6573 6572 ter". It preser │ │ │ │ │ -00011260: 7665 730a 7468 6520 6c69 7465 7261 6c20 ves.the literal │ │ │ │ │ -00011270: 7661 6c75 6520 6f66 2074 6865 206e 6578 value of the nex │ │ │ │ │ -00011280: 7420 6368 6172 6163 7465 7220 7468 6174 t character that │ │ │ │ │ -00011290: 2066 6f6c 6c6f 7773 2c20 7769 7468 2074 follows, with t │ │ │ │ │ -000112a0: 6865 2065 7863 6570 7469 6f6e 0a6f 6620 he exception.of │ │ │ │ │ -000112b0: 6e65 776c 696e 652e 0a0a 2020 2045 6e63 newline... Enc │ │ │ │ │ -000112c0: 6c6f 7369 6e67 2063 6861 7261 6374 6572 losing character │ │ │ │ │ -000112d0: 7320 696e 2073 696e 676c 6520 7175 6f74 s in single quot │ │ │ │ │ -000112e0: 6573 2070 7265 7365 7276 6573 2074 6865 es preserves the │ │ │ │ │ -000112f0: 206c 6974 6572 616c 2076 616c 7565 206f literal value o │ │ │ │ │ -00011300: 660a 6561 6368 2063 6861 7261 6374 6572 f.each character │ │ │ │ │ -00011310: 2077 6974 6869 6e20 7468 6520 7175 6f74 within the quot │ │ │ │ │ -00011320: 6573 2e20 2041 2073 696e 676c 6520 7175 es. A single qu │ │ │ │ │ -00011330: 6f74 6520 6d61 7920 6e6f 7420 6f63 6375 ote may not occu │ │ │ │ │ -00011340: 7220 6265 7477 6565 6e0a 7369 6e67 6c65 r between.single │ │ │ │ │ -00011350: 2071 756f 7465 732c 2065 7665 6e20 7768 quotes, even wh │ │ │ │ │ -00011360: 656e 2070 7265 6365 6465 6420 6279 2061 en preceded by a │ │ │ │ │ -00011370: 2062 6163 6b73 6c61 7368 2e0a 0a20 2020 backslash... │ │ │ │ │ -00011380: 456e 636c 6f73 696e 6720 6368 6172 6163 Enclosing charac │ │ │ │ │ -00011390: 7465 7273 2069 6e20 646f 7562 6c65 2071 ters in double q │ │ │ │ │ -000113a0: 756f 7465 7320 7072 6573 6572 7665 7320 uotes preserves │ │ │ │ │ -000113b0: 7468 6520 6c69 7465 7261 6c20 7661 6c75 the literal valu │ │ │ │ │ -000113c0: 6520 6f66 0a61 6c6c 2063 6861 7261 6374 e of.all charact │ │ │ │ │ -000113d0: 6572 7320 7769 7468 696e 2074 6865 2071 ers within the q │ │ │ │ │ -000113e0: 756f 7465 732c 2077 6974 6820 7468 6520 uotes, with the │ │ │ │ │ -000113f0: 6578 6365 7074 696f 6e20 6f66 2027 2427 exception of '$' │ │ │ │ │ -00011400: 2061 6e64 2027 5c27 2e0a 5468 6520 2724 and '\'..The '$ │ │ │ │ │ -00011410: 2720 6368 6172 6163 7465 7220 7265 7461 ' character reta │ │ │ │ │ -00011420: 696e 7320 6974 7320 7370 6563 6961 6c20 ins its special │ │ │ │ │ -00011430: 6d65 616e 696e 6720 7769 7468 696e 2064 meaning within d │ │ │ │ │ -00011440: 6f75 626c 6520 7175 6f74 6573 2e20 2054 ouble quotes. T │ │ │ │ │ -00011450: 6865 0a62 6163 6b73 6c61 7368 2072 6574 he.backslash ret │ │ │ │ │ -00011460: 6169 6e73 2069 7473 2073 7065 6369 616c ains its special │ │ │ │ │ -00011470: 206d 6561 6e69 6e67 206f 6e6c 7920 7768 meaning only wh │ │ │ │ │ -00011480: 656e 2066 6f6c 6c6f 7765 6420 6279 206f en followed by o │ │ │ │ │ -00011490: 6e65 206f 6620 7468 650a 666f 6c6c 6f77 ne of the.follow │ │ │ │ │ -000114a0: 696e 6720 6368 6172 6163 7465 7273 3a20 ing characters: │ │ │ │ │ -000114b0: 2724 272c 2027 2227 2c20 275c 272c 206f '$', '"', '\', o │ │ │ │ │ -000114c0: 7220 6e65 776c 696e 652e 2020 4120 6261 r newline. A ba │ │ │ │ │ -000114d0: 636b 736c 6173 682d 6e65 776c 696e 650a ckslash-newline. │ │ │ │ │ -000114e0: 7061 6972 2069 7320 7472 6561 7465 6420 pair is treated │ │ │ │ │ -000114f0: 6173 2061 206c 696e 6520 636f 6e74 696e as a line contin │ │ │ │ │ -00011500: 7561 7469 6f6e 2028 7468 6174 2069 732c uation (that is, │ │ │ │ │ -00011510: 2069 7420 6973 2072 656d 6f76 6564 2066 it is removed f │ │ │ │ │ -00011520: 726f 6d20 7468 650a 696e 7075 7420 7374 rom the.input st │ │ │ │ │ -00011530: 7265 616d 2061 6e64 2065 6666 6563 7469 ream and effecti │ │ │ │ │ -00011540: 7665 6c79 2069 676e 6f72 6564 2831 2920 vely ignored(1) │ │ │ │ │ -00011550: 282a 6e6f 7465 2053 6865 6c6c 2d6c 696b (*note Shell-lik │ │ │ │ │ -00011560: 650a 7363 7269 7074 696e 672d 466f 6f74 e.scripting-Foot │ │ │ │ │ -00011570: 6e6f 7465 2d31 3a3a 2929 2e20 2041 2064 note-1::)). A d │ │ │ │ │ -00011580: 6f75 626c 6520 7175 6f74 6520 6d61 7920 ouble quote may │ │ │ │ │ -00011590: 6265 2071 756f 7465 6420 7769 7468 696e be quoted within │ │ │ │ │ -000115a0: 2064 6f75 626c 650a 7175 6f74 6573 2062 double.quotes b │ │ │ │ │ -000115b0: 7920 7072 6563 6564 696e 6720 6974 2077 y preceding it w │ │ │ │ │ -000115c0: 6974 6820 6120 6261 636b 736c 6173 682e ith a backslash. │ │ │ │ │ -000115d0: 0a0a 5661 7269 6162 6c65 2065 7870 616e ..Variable expan │ │ │ │ │ -000115e0: 7369 6f6e 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d sion.=========== │ │ │ │ │ -000115f0: 3d3d 3d3d 3d3d 3d0a 0a54 6865 2027 2427 =======..The '$' │ │ │ │ │ -00011600: 2063 6861 7261 6374 6572 2069 6e74 726f character intro │ │ │ │ │ -00011610: 6475 6365 7320 7661 7269 6162 6c65 2065 duces variable e │ │ │ │ │ -00011620: 7870 616e 7369 6f6e 2e20 2054 6865 2076 xpansion. The v │ │ │ │ │ -00011630: 6172 6961 626c 6520 6e61 6d65 2074 6f0a ariable name to. │ │ │ │ │ -00011640: 6265 2065 7870 616e 6465 6420 6d61 7920 be expanded may │ │ │ │ │ -00011650: 6265 2065 6e63 6c6f 7365 6420 696e 2062 be enclosed in b │ │ │ │ │ -00011660: 7261 6365 732c 2077 6869 6368 2061 7265 races, which are │ │ │ │ │ -00011670: 206f 7074 696f 6e61 6c20 6275 7420 7365 optional but se │ │ │ │ │ -00011680: 7276 6520 746f 0a70 726f 7465 6374 2074 rve to.protect t │ │ │ │ │ -00011690: 6865 2076 6172 6961 626c 6520 746f 2062 he variable to b │ │ │ │ │ -000116a0: 6520 6578 7061 6e64 6564 2066 726f 6d20 e expanded from │ │ │ │ │ -000116b0: 6368 6172 6163 7465 7273 2069 6d6d 6564 characters immed │ │ │ │ │ -000116c0: 6961 7465 6c79 0a66 6f6c 6c6f 7769 6e67 iately.following │ │ │ │ │ -000116d0: 2069 7420 7768 6963 6820 636f 756c 6420 it which could │ │ │ │ │ -000116e0: 6265 2069 6e74 6572 7072 6574 6564 2061 be interpreted a │ │ │ │ │ -000116f0: 7320 7061 7274 206f 6620 7468 6520 6e61 s part of the na │ │ │ │ │ -00011700: 6d65 2e0a 0a20 2020 4e6f 726d 616c 2076 me... Normal v │ │ │ │ │ -00011710: 6172 6961 626c 6520 6e61 6d65 7320 6265 ariable names be │ │ │ │ │ -00011720: 6769 6e20 7769 7468 2061 6e20 616c 7068 gin with an alph │ │ │ │ │ -00011730: 6162 6574 6963 2063 6861 7261 6374 6572 abetic character │ │ │ │ │ -00011740: 2c20 666f 6c6c 6f77 6564 2062 790a 7a65 , followed by.ze │ │ │ │ │ -00011750: 726f 206f 7220 6d6f 7265 2061 6c70 6861 ro or more alpha │ │ │ │ │ -00011760: 6e75 6d65 7269 6320 6368 6172 6163 7465 numeric characte │ │ │ │ │ -00011770: 7273 2e20 2054 6865 7365 206e 616d 6573 rs. These names │ │ │ │ │ -00011780: 2072 6566 6572 2074 6f20 656e 7472 6965 refer to entrie │ │ │ │ │ -00011790: 7320 696e 0a74 6865 2047 5255 4220 656e s in.the GRUB en │ │ │ │ │ -000117a0: 7669 726f 6e6d 656e 7420 282a 6e6f 7465 vironment (*note │ │ │ │ │ -000117b0: 2045 6e76 6972 6f6e 6d65 6e74 3a3a 292e Environment::). │ │ │ │ │ -000117c0: 0a0a 2020 2050 6f73 6974 696f 6e61 6c20 .. Positional │ │ │ │ │ -000117d0: 7661 7269 6162 6c65 206e 616d 6573 2063 variable names c │ │ │ │ │ -000117e0: 6f6e 7369 7374 206f 6620 6f6e 6520 6f72 onsist of one or │ │ │ │ │ -000117f0: 206d 6f72 6520 6469 6769 7473 2e20 2054 more digits. T │ │ │ │ │ -00011800: 6865 790a 7265 7072 6573 656e 7420 7061 hey.represent pa │ │ │ │ │ -00011810: 7261 6d65 7465 7273 2070 6173 7365 6420 rameters passed │ │ │ │ │ -00011820: 746f 2066 756e 6374 696f 6e20 6361 6c6c to function call │ │ │ │ │ -00011830: 732c 2077 6974 6820 2724 3127 2072 6570 s, with '$1' rep │ │ │ │ │ -00011840: 7265 7365 6e74 696e 670a 7468 6520 6669 resenting.the fi │ │ │ │ │ -00011850: 7273 7420 7061 7261 6d65 7465 722c 2061 rst parameter, a │ │ │ │ │ -00011860: 6e64 2073 6f20 6f6e 2e0a 0a20 2020 5468 nd so on... Th │ │ │ │ │ -00011870: 6520 7370 6563 6961 6c20 7661 7269 6162 e special variab │ │ │ │ │ -00011880: 6c65 206e 616d 6520 273f 2720 6578 7061 le name '?' expa │ │ │ │ │ -00011890: 6e64 7320 746f 2074 6865 2065 7869 7420 nds to the exit │ │ │ │ │ -000118a0: 7374 6174 7573 206f 6620 7468 6520 6d6f status of the mo │ │ │ │ │ -000118b0: 7374 0a72 6563 656e 746c 7920 6578 6563 st.recently exec │ │ │ │ │ -000118c0: 7574 6564 2063 6f6d 6d61 6e64 2e20 2057 uted command. W │ │ │ │ │ -000118d0: 6865 6e20 706f 7369 7469 6f6e 616c 2076 hen positional v │ │ │ │ │ -000118e0: 6172 6961 626c 6520 6e61 6d65 7320 6172 ariable names ar │ │ │ │ │ -000118f0: 6520 6163 7469 7665 2c0a 6f74 6865 7220 e active,.other │ │ │ │ │ -00011900: 7370 6563 6961 6c20 7661 7269 6162 6c65 special variable │ │ │ │ │ -00011910: 206e 616d 6573 2027 4027 2c20 272a 2720 names '@', '*' │ │ │ │ │ -00011920: 616e 6420 2723 2720 6172 6520 6465 6669 and '#' are defi │ │ │ │ │ -00011930: 6e65 6420 616e 6420 7468 6579 0a65 7870 ned and they.exp │ │ │ │ │ -00011940: 616e 6420 746f 2061 6c6c 2070 6f73 6974 and to all posit │ │ │ │ │ -00011950: 696f 6e61 6c20 7061 7261 6d65 7465 7273 ional parameters │ │ │ │ │ -00011960: 2077 6974 6820 6e65 6365 7373 6172 7920 with necessary │ │ │ │ │ -00011970: 7175 6f74 696e 672c 2070 6f73 6974 696f quoting, positio │ │ │ │ │ -00011980: 6e61 6c0a 7061 7261 6d65 7465 7273 2077 nal.parameters w │ │ │ │ │ -00011990: 6974 686f 7574 2061 6e79 2071 756f 7469 ithout any quoti │ │ │ │ │ -000119a0: 6e67 2c20 616e 6420 706f 7369 7469 6f6e ng, and position │ │ │ │ │ -000119b0: 616c 2070 6172 616d 6574 6572 2063 6f75 al parameter cou │ │ │ │ │ -000119c0: 6e74 0a72 6573 7065 6374 6976 656c 792e nt.respectively. │ │ │ │ │ -000119d0: 0a0a 436f 6d6d 656e 7473 0a3d 3d3d 3d3d ..Comments.===== │ │ │ │ │ -000119e0: 3d3d 3d0a 0a41 2077 6f72 6420 6265 6769 ===..A word begi │ │ │ │ │ -000119f0: 6e6e 696e 6720 7769 7468 2027 2327 2063 nning with '#' c │ │ │ │ │ -00011a00: 6175 7365 7320 7468 6174 2077 6f72 6420 auses that word │ │ │ │ │ -00011a10: 616e 6420 616c 6c20 7265 6d61 696e 696e and all remainin │ │ │ │ │ -00011a20: 6720 6368 6172 6163 7465 7273 0a6f 6e20 g characters.on │ │ │ │ │ -00011a30: 7468 6174 206c 696e 6520 746f 2062 6520 that line to be │ │ │ │ │ -00011a40: 6967 6e6f 7265 642e 0a0a 5369 6d70 6c65 ignored...Simple │ │ │ │ │ -00011a50: 2063 6f6d 6d61 6e64 730a 3d3d 3d3d 3d3d commands.====== │ │ │ │ │ -00011a60: 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 2022 7369 =========..A "si │ │ │ │ │ -00011a70: 6d70 6c65 2063 6f6d 6d61 6e64 2220 6973 mple command" is │ │ │ │ │ -00011a80: 2061 2073 6571 7565 6e63 6520 6f66 2077 a sequence of w │ │ │ │ │ -00011a90: 6f72 6473 2073 6570 6172 6174 6564 2062 ords separated b │ │ │ │ │ -00011aa0: 7920 7370 6163 6573 206f 7220 7461 6273 y spaces or tabs │ │ │ │ │ -00011ab0: 0a61 6e64 2074 6572 6d69 6e61 7465 6420 .and terminated │ │ │ │ │ -00011ac0: 6279 2061 2073 656d 6963 6f6c 6f6e 206f by a semicolon o │ │ │ │ │ -00011ad0: 7220 6120 6e65 776c 696e 652e 2020 5468 r a newline. Th │ │ │ │ │ -00011ae0: 6520 6669 7273 7420 776f 7264 2073 7065 e first word spe │ │ │ │ │ -00011af0: 6369 6669 6573 0a74 6865 2063 6f6d 6d61 cifies.the comma │ │ │ │ │ -00011b00: 6e64 2074 6f20 6265 2065 7865 6375 7465 nd to be execute │ │ │ │ │ -00011b10: 642e 2020 5468 6520 7265 6d61 696e 696e d. The remainin │ │ │ │ │ -00011b20: 6720 776f 7264 7320 6172 6520 7061 7373 g words are pass │ │ │ │ │ -00011b30: 6564 2061 7320 6172 6775 6d65 6e74 730a ed as arguments. │ │ │ │ │ -00011b40: 746f 2074 6865 2069 6e76 6f6b 6564 2063 to the invoked c │ │ │ │ │ -00011b50: 6f6d 6d61 6e64 2e0a 0a20 2020 5468 6520 ommand... The │ │ │ │ │ -00011b60: 7265 7475 726e 2076 616c 7565 206f 6620 return value of │ │ │ │ │ -00011b70: 6120 7369 6d70 6c65 2063 6f6d 6d61 6e64 a simple command │ │ │ │ │ -00011b80: 2069 7320 6974 7320 6578 6974 2073 7461 is its exit sta │ │ │ │ │ -00011b90: 7475 732e 2020 4966 2074 6865 0a72 6573 tus. If the.res │ │ │ │ │ -00011ba0: 6572 7665 6420 776f 7264 2027 2127 2070 erved word '!' p │ │ │ │ │ -00011bb0: 7265 6365 6465 7320 7468 6520 636f 6d6d recedes the comm │ │ │ │ │ -00011bc0: 616e 642c 2074 6865 6e20 7468 6520 7265 and, then the re │ │ │ │ │ -00011bd0: 7475 726e 2076 616c 7565 2069 7320 696e turn value is in │ │ │ │ │ -00011be0: 7374 6561 640a 7468 6520 6c6f 6769 6361 stead.the logica │ │ │ │ │ -00011bf0: 6c20 6e65 6761 7469 6f6e 206f 6620 7468 l negation of th │ │ │ │ │ -00011c00: 6520 636f 6d6d 616e 6427 7320 6578 6974 e command's exit │ │ │ │ │ -00011c10: 2073 7461 7475 732e 0a0a 436f 6d70 6f75 status...Compou │ │ │ │ │ -00011c20: 6e64 2063 6f6d 6d61 6e64 730a 3d3d 3d3d nd commands.==== │ │ │ │ │ -00011c30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 =============..A │ │ │ │ │ -00011c40: 2022 636f 6d70 6f75 6e64 2063 6f6d 6d61 "compound comma │ │ │ │ │ -00011c50: 6e64 2220 6973 206f 6e65 206f 6620 7468 nd" is one of th │ │ │ │ │ -00011c60: 6520 666f 6c6c 6f77 696e 673a 0a0a 666f e following:..fo │ │ │ │ │ -00011c70: 7220 4e41 4d45 2069 6e20 574f 5244 202e r NAME in WORD . │ │ │ │ │ -00011c80: 2e2e 3b20 646f 204c 4953 543b 2064 6f6e ..; do LIST; don │ │ │ │ │ -00011c90: 650a 2020 2020 2054 6865 206c 6973 7420 e. The list │ │ │ │ │ -00011ca0: 6f66 2077 6f72 6473 2066 6f6c 6c6f 7769 of words followi │ │ │ │ │ -00011cb0: 6e67 2027 696e 2720 6973 2065 7870 616e ng 'in' is expan │ │ │ │ │ -00011cc0: 6465 642c 2067 656e 6572 6174 696e 6720 ded, generating │ │ │ │ │ -00011cd0: 6120 6c69 7374 206f 660a 2020 2020 2069 a list of. i │ │ │ │ │ -00011ce0: 7465 6d73 2e20 2054 6865 2076 6172 6961 tems. The varia │ │ │ │ │ -00011cf0: 626c 6520 4e41 4d45 2069 7320 7365 7420 ble NAME is set │ │ │ │ │ -00011d00: 746f 2065 6163 6820 656c 656d 656e 7420 to each element │ │ │ │ │ -00011d10: 6f66 2074 6869 7320 6c69 7374 2069 6e0a of this list in. │ │ │ │ │ -00011d20: 2020 2020 2074 7572 6e2c 2061 6e64 204c turn, and L │ │ │ │ │ -00011d30: 4953 5420 6973 2065 7865 6375 7465 6420 IST is executed │ │ │ │ │ -00011d40: 6561 6368 2074 696d 652e 2020 5468 6520 each time. The │ │ │ │ │ -00011d50: 7265 7475 726e 2076 616c 7565 2069 7320 return value is │ │ │ │ │ -00011d60: 7468 6520 6578 6974 0a20 2020 2020 7374 the exit. st │ │ │ │ │ -00011d70: 6174 7573 206f 6620 7468 6520 6c61 7374 atus of the last │ │ │ │ │ -00011d80: 2063 6f6d 6d61 6e64 2074 6861 7420 6578 command that ex │ │ │ │ │ -00011d90: 6563 7574 6573 2e20 2049 6620 7468 6520 ecutes. If the │ │ │ │ │ -00011da0: 6578 7061 6e73 696f 6e20 6f66 2074 6865 expansion of the │ │ │ │ │ -00011db0: 0a20 2020 2020 6974 656d 7320 666f 6c6c . items foll │ │ │ │ │ -00011dc0: 6f77 696e 6720 2769 6e27 2072 6573 756c owing 'in' resul │ │ │ │ │ -00011dd0: 7473 2069 6e20 616e 2065 6d70 7479 206c ts in an empty l │ │ │ │ │ -00011de0: 6973 742c 206e 6f20 636f 6d6d 616e 6473 ist, no commands │ │ │ │ │ -00011df0: 2061 7265 0a20 2020 2020 6578 6563 7574 are. execut │ │ │ │ │ -00011e00: 6564 2c20 616e 6420 7468 6520 7265 7475 ed, and the retu │ │ │ │ │ -00011e10: 726e 2073 7461 7475 7320 6973 2030 2e0a rn status is 0.. │ │ │ │ │ -00011e20: 0a69 6620 4c49 5354 3b20 7468 656e 204c .if LIST; then L │ │ │ │ │ -00011e30: 4953 543b 205b 656c 6966 204c 4953 543b IST; [elif LIST; │ │ │ │ │ -00011e40: 2074 6865 6e20 4c49 5354 3b5d 202e 2e2e then LIST;] ... │ │ │ │ │ -00011e50: 205b 656c 7365 204c 4953 543b 5d20 6669 [else LIST;] fi │ │ │ │ │ -00011e60: 0a20 2020 2020 5468 6520 2769 6627 204c . The 'if' L │ │ │ │ │ -00011e70: 4953 5420 6973 2065 7865 6375 7465 642e IST is executed. │ │ │ │ │ -00011e80: 2020 4966 2069 7473 2065 7869 7420 7374 If its exit st │ │ │ │ │ -00011e90: 6174 7573 2069 7320 7a65 726f 2c20 7468 atus is zero, th │ │ │ │ │ -00011ea0: 6520 2774 6865 6e27 0a20 2020 2020 4c49 e 'then'. LI │ │ │ │ │ -00011eb0: 5354 2069 7320 6578 6563 7574 6564 2e20 ST is executed. │ │ │ │ │ -00011ec0: 204f 7468 6572 7769 7365 2c20 6561 6368 Otherwise, each │ │ │ │ │ -00011ed0: 2027 656c 6966 2720 4c49 5354 2069 7320 'elif' LIST is │ │ │ │ │ -00011ee0: 6578 6563 7574 6564 2069 6e20 7475 726e executed in turn │ │ │ │ │ -00011ef0: 2c0a 2020 2020 2061 6e64 2069 6620 6974 ,. and if it │ │ │ │ │ -00011f00: 7320 6578 6974 2073 7461 7475 7320 6973 s exit status is │ │ │ │ │ -00011f10: 207a 6572 6f2c 2074 6865 2063 6f72 7265 zero, the corre │ │ │ │ │ -00011f20: 7370 6f6e 6469 6e67 2027 7468 656e 2720 sponding 'then' │ │ │ │ │ -00011f30: 4c49 5354 2069 730a 2020 2020 2065 7865 LIST is. exe │ │ │ │ │ -00011f40: 6375 7465 6420 616e 6420 7468 6520 636f cuted and the co │ │ │ │ │ -00011f50: 6d6d 616e 6420 636f 6d70 6c65 7465 732e mmand completes. │ │ │ │ │ -00011f60: 2020 4f74 6865 7277 6973 652c 2074 6865 Otherwise, the │ │ │ │ │ -00011f70: 2027 656c 7365 2720 4c49 5354 2069 730a 'else' LIST is. │ │ │ │ │ -00011f80: 2020 2020 2065 7865 6375 7465 642c 2069 executed, i │ │ │ │ │ -00011f90: 6620 7072 6573 656e 742e 2020 5468 6520 f present. The │ │ │ │ │ -00011fa0: 6578 6974 2073 7461 7475 7320 6973 2074 exit status is t │ │ │ │ │ -00011fb0: 6865 2065 7869 7420 7374 6174 7573 206f he exit status o │ │ │ │ │ -00011fc0: 6620 7468 650a 2020 2020 206c 6173 7420 f the. last │ │ │ │ │ -00011fd0: 636f 6d6d 616e 6420 6578 6563 7574 6564 command executed │ │ │ │ │ -00011fe0: 2c20 6f72 207a 6572 6f20 6966 206e 6f20 , or zero if no │ │ │ │ │ -00011ff0: 636f 6e64 6974 696f 6e20 7465 7374 6564 condition tested │ │ │ │ │ -00012000: 2074 7275 652e 0a0a 7768 696c 6520 434f true...while CO │ │ │ │ │ -00012010: 4e44 3b20 646f 204c 4953 543b 2064 6f6e ND; do LIST; don │ │ │ │ │ -00012020: 650a 756e 7469 6c20 434f 4e44 3b20 646f e.until COND; do │ │ │ │ │ -00012030: 204c 4953 543b 2064 6f6e 650a 2020 2020 LIST; done. │ │ │ │ │ -00012040: 2054 6865 2027 7768 696c 6527 2063 6f6d The 'while' com │ │ │ │ │ -00012050: 6d61 6e64 2063 6f6e 7469 6e75 6f75 736c mand continuousl │ │ │ │ │ -00012060: 7920 6578 6563 7574 6573 2074 6865 2027 y executes the ' │ │ │ │ │ -00012070: 646f 2720 4c49 5354 2061 7320 6c6f 6e67 do' LIST as long │ │ │ │ │ -00012080: 2061 730a 2020 2020 2074 6865 206c 6173 as. the las │ │ │ │ │ -00012090: 7420 636f 6d6d 616e 6420 696e 2043 4f4e t command in CON │ │ │ │ │ -000120a0: 4420 7265 7475 726e 7320 616e 2065 7869 D returns an exi │ │ │ │ │ -000120b0: 7420 7374 6174 7573 206f 6620 7a65 726f t status of zero │ │ │ │ │ -000120c0: 2e20 2054 6865 0a20 2020 2020 2775 6e74 . The. 'unt │ │ │ │ │ -000120d0: 696c 2720 636f 6d6d 616e 6420 6973 2069 il' command is i │ │ │ │ │ -000120e0: 6465 6e74 6963 616c 2074 6f20 7468 6520 dentical to the │ │ │ │ │ -000120f0: 2777 6869 6c65 2720 636f 6d6d 616e 642c 'while' command, │ │ │ │ │ -00012100: 2065 7863 6570 7420 7468 6174 0a20 2020 except that. │ │ │ │ │ -00012110: 2020 7468 6520 7465 7374 2069 7320 6e65 the test is ne │ │ │ │ │ -00012120: 6761 7465 643b 2074 6865 2027 646f 2720 gated; the 'do' │ │ │ │ │ -00012130: 4c49 5354 2069 7320 6578 6563 7574 6564 LIST is executed │ │ │ │ │ -00012140: 2061 7320 6c6f 6e67 2061 7320 7468 6520 as long as the │ │ │ │ │ -00012150: 6c61 7374 0a20 2020 2020 636f 6d6d 616e last. comman │ │ │ │ │ -00012160: 6420 696e 2043 4f4e 4420 7265 7475 726e d in COND return │ │ │ │ │ -00012170: 7320 6120 6e6f 6e2d 7a65 726f 2065 7869 s a non-zero exi │ │ │ │ │ -00012180: 7420 7374 6174 7573 2e20 2054 6865 2065 t status. The e │ │ │ │ │ -00012190: 7869 7420 7374 6174 7573 206f 660a 2020 xit status of. │ │ │ │ │ -000121a0: 2020 2074 6865 2027 7768 696c 6527 2061 the 'while' a │ │ │ │ │ -000121b0: 6e64 2027 756e 7469 6c27 2063 6f6d 6d61 nd 'until' comma │ │ │ │ │ -000121c0: 6e64 7320 6973 2074 6865 2065 7869 7420 nds is the exit │ │ │ │ │ -000121d0: 7374 6174 7573 206f 6620 7468 6520 6c61 status of the la │ │ │ │ │ -000121e0: 7374 0a20 2020 2020 2764 6f27 204c 4953 st. 'do' LIS │ │ │ │ │ -000121f0: 5420 636f 6d6d 616e 6420 6578 6563 7574 T command execut │ │ │ │ │ -00012200: 6564 2c20 6f72 207a 6572 6f20 6966 206e ed, or zero if n │ │ │ │ │ -00012210: 6f6e 6520 7761 7320 6578 6563 7574 6564 one was executed │ │ │ │ │ -00012220: 2e0a 0a66 756e 6374 696f 6e20 4e41 4d45 ...function NAME │ │ │ │ │ -00012230: 207b 2043 4f4d 4d41 4e44 3b20 2e2e 2e20 { COMMAND; ... │ │ │ │ │ -00012240: 7d0a 2020 2020 2054 6869 7320 6465 6669 }. This defi │ │ │ │ │ -00012250: 6e65 7320 6120 6675 6e63 7469 6f6e 206e nes a function n │ │ │ │ │ -00012260: 616d 6564 204e 414d 452e 2020 5468 6520 amed NAME. The │ │ │ │ │ -00012270: 2262 6f64 7922 206f 6620 7468 6520 6675 "body" of the fu │ │ │ │ │ -00012280: 6e63 7469 6f6e 2069 730a 2020 2020 2074 nction is. t │ │ │ │ │ -00012290: 6865 206c 6973 7420 6f66 2063 6f6d 6d61 he list of comma │ │ │ │ │ -000122a0: 6e64 7320 7769 7468 696e 2062 7261 6365 nds within brace │ │ │ │ │ -000122b0: 732c 2065 6163 6820 6f66 2077 6869 6368 s, each of which │ │ │ │ │ -000122c0: 206d 7573 7420 6265 0a20 2020 2020 7465 must be. te │ │ │ │ │ -000122d0: 726d 696e 6174 6564 2077 6974 6820 6120 rminated with a │ │ │ │ │ -000122e0: 7365 6d69 636f 6c6f 6e20 6f72 2061 206e semicolon or a n │ │ │ │ │ -000122f0: 6577 6c69 6e65 2e20 2054 6869 7320 6c69 ewline. This li │ │ │ │ │ -00012300: 7374 206f 6620 636f 6d6d 616e 6473 0a20 st of commands. │ │ │ │ │ -00012310: 2020 2020 7769 6c6c 2062 6520 6578 6563 will be exec │ │ │ │ │ -00012320: 7574 6564 2077 6865 6e65 7665 7220 4e41 uted whenever NA │ │ │ │ │ -00012330: 4d45 2069 7320 7370 6563 6966 6965 6420 ME is specified │ │ │ │ │ -00012340: 6173 2074 6865 206e 616d 6520 6f66 2061 as the name of a │ │ │ │ │ -00012350: 2073 696d 706c 650a 2020 2020 2063 6f6d simple. com │ │ │ │ │ -00012360: 6d61 6e64 2e20 2046 756e 6374 696f 6e20 mand. Function │ │ │ │ │ -00012370: 6465 6669 6e69 7469 6f6e 7320 646f 206e definitions do n │ │ │ │ │ -00012380: 6f74 2061 6666 6563 7420 7468 6520 6578 ot affect the ex │ │ │ │ │ -00012390: 6974 2073 7461 7475 7320 696e 0a20 2020 it status in. │ │ │ │ │ -000123a0: 2020 2724 3f27 2e20 2057 6865 6e20 6578 '$?'. When ex │ │ │ │ │ -000123b0: 6563 7574 6564 2c20 7468 6520 6578 6974 ecuted, the exit │ │ │ │ │ -000123c0: 2073 7461 7475 7320 6f66 2061 2066 756e status of a fun │ │ │ │ │ -000123d0: 6374 696f 6e20 6973 2074 6865 2065 7869 ction is the exi │ │ │ │ │ -000123e0: 740a 2020 2020 2073 7461 7475 7320 6f66 t. status of │ │ │ │ │ -000123f0: 2074 6865 206c 6173 7420 636f 6d6d 616e the last comman │ │ │ │ │ -00012400: 6420 6578 6563 7574 6564 2069 6e20 7468 d executed in th │ │ │ │ │ -00012410: 6520 626f 6479 2e0a 0a6d 656e 7565 6e74 e body...menuent │ │ │ │ │ -00012420: 7279 2054 4954 4c45 205b 272d 2d63 6c61 ry TITLE ['--cla │ │ │ │ │ -00012430: 7373 3d63 6c61 7373 2720 2e2e 2e5d 205b ss=class' ...] [ │ │ │ │ │ -00012440: 272d 2d75 7365 7273 3d75 7365 7273 275d '--users=users'] │ │ │ │ │ -00012450: 205b 272d 2d75 6e72 6573 7472 6963 7465 ['--unrestricte │ │ │ │ │ -00012460: 6427 5d20 5b27 2d2d 686f 746b 6579 3d6b d'] ['--hotkey=k │ │ │ │ │ -00012470: 6579 275d 205b 272d 2d69 643d 6964 275d ey'] ['--id=id'] │ │ │ │ │ -00012480: 207b 2043 4f4d 4d41 4e44 3b20 2e2e 2e20 { COMMAND; ... │ │ │ │ │ -00012490: 7d0a 2020 2020 202a 4e6f 7465 206d 656e }. *Note men │ │ │ │ │ -000124a0: 7565 6e74 7279 3a3a 2e0a 0a42 7569 6c74 uentry::...Built │ │ │ │ │ -000124b0: 2d69 6e20 436f 6d6d 616e 6473 0a3d 3d3d -in Commands.=== │ │ │ │ │ -000124c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -000124d0: 536f 6d65 2062 7569 6c74 2d69 6e20 636f Some built-in co │ │ │ │ │ -000124e0: 6d6d 616e 6473 2061 7265 2061 6c73 6f20 mmands are also │ │ │ │ │ -000124f0: 7072 6f76 6964 6564 2062 7920 4752 5542 provided by GRUB │ │ │ │ │ -00012500: 2073 6372 6970 7420 746f 2068 656c 7020 script to help │ │ │ │ │ -00012510: 7363 7269 7074 0a77 7269 7465 7273 2070 script.writers p │ │ │ │ │ -00012520: 6572 666f 726d 2061 6374 696f 6e73 2074 erform actions t │ │ │ │ │ -00012530: 6861 7420 6172 6520 6f74 6865 7277 6973 hat are otherwis │ │ │ │ │ -00012540: 6520 6e6f 7420 706f 7373 6962 6c65 2e20 e not possible. │ │ │ │ │ -00012550: 2046 6f72 2065 7861 6d70 6c65 2c0a 7468 For example,.th │ │ │ │ │ -00012560: 6573 6520 696e 636c 7564 6520 636f 6d6d ese include comm │ │ │ │ │ -00012570: 616e 6473 2074 6f20 6a75 6d70 206f 7574 ands to jump out │ │ │ │ │ -00012580: 206f 6620 6120 6c6f 6f70 2077 6974 686f of a loop witho │ │ │ │ │ -00012590: 7574 2066 756c 6c79 2063 6f6d 706c 6574 ut fully complet │ │ │ │ │ -000125a0: 696e 670a 6974 2c20 6574 632e 0a0a 6272 ing.it, etc...br │ │ │ │ │ -000125b0: 6561 6b20 5b27 6e27 5d0a 2020 2020 2045 eak ['n']. E │ │ │ │ │ -000125c0: 7869 7420 6672 6f6d 2077 6974 6869 6e20 xit from within │ │ │ │ │ -000125d0: 6120 2766 6f72 272c 2027 7768 696c 6527 a 'for', 'while' │ │ │ │ │ -000125e0: 2c20 6f72 2027 756e 7469 6c27 206c 6f6f , or 'until' loo │ │ │ │ │ -000125f0: 702e 2020 4966 2027 6e27 2069 730a 2020 p. If 'n' is. │ │ │ │ │ -00012600: 2020 2073 7065 6369 6669 6564 2c20 6272 specified, br │ │ │ │ │ -00012610: 6561 6b20 276e 2720 6c65 7665 6c73 2e20 eak 'n' levels. │ │ │ │ │ -00012620: 2027 6e27 206d 7573 7420 6265 2067 7265 'n' must be gre │ │ │ │ │ -00012630: 6174 6572 2074 6861 6e20 6f72 2065 7175 ater than or equ │ │ │ │ │ -00012640: 616c 2074 6f0a 2020 2020 2031 2e20 2049 al to. 1. I │ │ │ │ │ -00012650: 6620 276e 2720 6973 2067 7265 6174 6572 f 'n' is greater │ │ │ │ │ -00012660: 2074 6861 6e20 7468 6520 6e75 6d62 6572 than the number │ │ │ │ │ -00012670: 206f 6620 656e 636c 6f73 696e 6720 6c6f of enclosing lo │ │ │ │ │ -00012680: 6f70 732c 2061 6c6c 0a20 2020 2020 656e ops, all. en │ │ │ │ │ -00012690: 636c 6f73 696e 6720 6c6f 6f70 7320 6172 closing loops ar │ │ │ │ │ -000126a0: 6520 6578 6974 6564 2e20 2054 6865 2072 e exited. The r │ │ │ │ │ -000126b0: 6574 7572 6e20 7661 6c75 6520 6973 2030 eturn value is 0 │ │ │ │ │ -000126c0: 2075 6e6c 6573 7320 276e 2720 6973 0a20 unless 'n' is. │ │ │ │ │ -000126d0: 2020 2020 6e6f 7420 6772 6561 7465 7220 not greater │ │ │ │ │ -000126e0: 7468 616e 206f 7220 6571 7561 6c20 746f than or equal to │ │ │ │ │ -000126f0: 2031 2e0a 0a63 6f6e 7469 6e75 6520 5b27 1...continue [' │ │ │ │ │ -00012700: 6e27 5d0a 2020 2020 2052 6573 756d 6520 n']. Resume │ │ │ │ │ -00012710: 7468 6520 6e65 7874 2069 7465 7261 7469 the next iterati │ │ │ │ │ -00012720: 6f6e 206f 6620 7468 6520 656e 636c 6f73 on of the enclos │ │ │ │ │ -00012730: 696e 6720 2766 6f72 272c 2027 7768 696c ing 'for', 'whil │ │ │ │ │ -00012740: 6527 206f 720a 2020 2020 2027 756e 7469 e' or. 'unti │ │ │ │ │ -00012750: 6c27 206c 6f6f 702e 2020 4966 2027 6e27 l' loop. If 'n' │ │ │ │ │ -00012760: 2069 7320 7370 6563 6966 6965 642c 2072 is specified, r │ │ │ │ │ -00012770: 6573 756d 6520 6174 2074 6865 2027 6e27 esume at the 'n' │ │ │ │ │ -00012780: 7468 2065 6e63 6c6f 7369 6e67 0a20 2020 th enclosing. │ │ │ │ │ -00012790: 2020 6c6f 6f70 2e20 2027 6e27 206d 7573 loop. 'n' mus │ │ │ │ │ -000127a0: 7420 6265 2067 7265 6174 6572 2074 6861 t be greater tha │ │ │ │ │ -000127b0: 6e20 6f72 2065 7175 616c 2074 6f20 312e n or equal to 1. │ │ │ │ │ -000127c0: 2020 4966 2027 6e27 2069 7320 6772 6561 If 'n' is grea │ │ │ │ │ -000127d0: 7465 720a 2020 2020 2074 6861 6e20 7468 ter. than th │ │ │ │ │ -000127e0: 6520 6e75 6d62 6572 206f 6620 656e 636c e number of encl │ │ │ │ │ -000127f0: 6f73 696e 6720 6c6f 6f70 732c 2074 6865 osing loops, the │ │ │ │ │ -00012800: 206c 6173 7420 656e 636c 6f73 696e 6720 last enclosing │ │ │ │ │ -00012810: 6c6f 6f70 2028 7468 650a 2020 2020 2022 loop (the. " │ │ │ │ │ -00012820: 746f 702d 6c65 7665 6c22 206c 6f6f 7029 top-level" loop) │ │ │ │ │ -00012830: 2069 7320 7265 7375 6d65 642e 2020 5468 is resumed. Th │ │ │ │ │ -00012840: 6520 7265 7475 726e 2076 616c 7565 2069 e return value i │ │ │ │ │ -00012850: 7320 3020 756e 6c65 7373 2027 6e27 2069 s 0 unless 'n' i │ │ │ │ │ -00012860: 730a 2020 2020 206e 6f74 2067 7265 6174 s. not great │ │ │ │ │ -00012870: 6572 2074 6861 6e20 6f72 2065 7175 616c er than or equal │ │ │ │ │ -00012880: 2074 6f20 312e 0a0a 7265 7475 726e 205b to 1...return [ │ │ │ │ │ -00012890: 276e 275d 0a20 2020 2020 4361 7573 6573 'n']. Causes │ │ │ │ │ -000128a0: 2061 2066 756e 6374 696f 6e20 746f 2065 a function to e │ │ │ │ │ -000128b0: 7869 7420 7769 7468 2074 6865 2072 6574 xit with the ret │ │ │ │ │ -000128c0: 7572 6e20 7661 6c75 6520 7370 6563 6966 urn value specif │ │ │ │ │ -000128d0: 6965 6420 6279 2027 6e27 2e0a 2020 2020 ied by 'n'.. │ │ │ │ │ -000128e0: 2049 6620 276e 2720 6973 206f 6d69 7474 If 'n' is omitt │ │ │ │ │ -000128f0: 6564 2c20 7468 6520 7265 7475 726e 2073 ed, the return s │ │ │ │ │ -00012900: 7461 7475 7320 6973 2074 6861 7420 6f66 tatus is that of │ │ │ │ │ -00012910: 2074 6865 206c 6173 7420 636f 6d6d 616e the last comman │ │ │ │ │ -00012920: 640a 2020 2020 2065 7865 6375 7465 6420 d. executed │ │ │ │ │ -00012930: 696e 2074 6865 2066 756e 6374 696f 6e20 in the function │ │ │ │ │ -00012940: 626f 6479 2e20 2049 6620 7573 6564 206f body. If used o │ │ │ │ │ -00012950: 7574 7369 6465 2061 2066 756e 6374 696f utside a functio │ │ │ │ │ -00012960: 6e20 7468 650a 2020 2020 2072 6574 7572 n the. retur │ │ │ │ │ -00012970: 6e20 7374 6174 7573 2069 7320 6661 6c73 n status is fals │ │ │ │ │ -00012980: 652e 0a0a 7365 7470 6172 616d 7320 5b27 e...setparams [' │ │ │ │ │ -00012990: 6172 6727 5d20 2e2e 2e0a 2020 2020 2052 arg'] .... R │ │ │ │ │ -000129a0: 6570 6c61 6365 2070 6f73 6974 696f 6e61 eplace positiona │ │ │ │ │ -000129b0: 6c20 7061 7261 6d65 7465 7273 2073 7461 l parameters sta │ │ │ │ │ -000129c0: 7274 696e 6720 7769 7468 2027 2431 2720 rting with '$1' │ │ │ │ │ -000129d0: 7769 7468 2061 7267 756d 656e 7473 2074 with arguments t │ │ │ │ │ -000129e0: 6f0a 2020 2020 2027 7365 7470 6172 616d o. 'setparam │ │ │ │ │ -000129f0: 7327 2e0a 0a73 6869 6674 205b 276e 275d s'...shift ['n'] │ │ │ │ │ -00012a00: 0a20 2020 2020 5468 6520 706f 7369 7469 . The positi │ │ │ │ │ -00012a10: 6f6e 616c 2070 6172 616d 6574 6572 7320 onal parameters │ │ │ │ │ -00012a20: 6672 6f6d 2027 6e27 2b31 202e 2e2e 2061 from 'n'+1 ... a │ │ │ │ │ -00012a30: 7265 2072 656e 616d 6564 2074 6f20 2724 re renamed to '$ │ │ │ │ │ -00012a40: 3127 2e2e 2e2e 0a20 2020 2020 5061 7261 1'..... Para │ │ │ │ │ -00012a50: 6d65 7465 7273 2072 6570 7265 7365 6e74 meters represent │ │ │ │ │ -00012a60: 6564 2062 7920 7468 6520 6e75 6d62 6572 ed by the number │ │ │ │ │ -00012a70: 7320 2724 2327 2064 6f77 6e20 746f 2027 s '$#' down to ' │ │ │ │ │ -00012a80: 2423 272d 276e 272b 3120 6172 650a 2020 $#'-'n'+1 are. │ │ │ │ │ -00012a90: 2020 2075 6e73 6574 2e20 2027 6e27 206d unset. 'n' m │ │ │ │ │ -00012aa0: 7573 7420 6265 2061 206e 6f6e 2d6e 6567 ust be a non-neg │ │ │ │ │ -00012ab0: 6174 6976 6520 6e75 6d62 6572 206c 6573 ative number les │ │ │ │ │ -00012ac0: 7320 7468 616e 206f 7220 6571 7561 6c20 s than or equal │ │ │ │ │ -00012ad0: 746f 0a20 2020 2020 2724 2327 2e20 2049 to. '$#'. I │ │ │ │ │ -00012ae0: 6620 276e 2720 6973 2030 2c20 6e6f 2070 f 'n' is 0, no p │ │ │ │ │ -00012af0: 6172 616d 6574 6572 7320 6172 6520 6368 arameters are ch │ │ │ │ │ -00012b00: 616e 6765 642e 2020 4966 2027 6e27 2069 anged. If 'n' i │ │ │ │ │ -00012b10: 7320 6e6f 740a 2020 2020 2067 6976 656e s not. given │ │ │ │ │ -00012b20: 2c20 6974 2069 7320 6173 7375 6d65 6420 , it is assumed │ │ │ │ │ -00012b30: 746f 2062 6520 312e 2020 4966 2027 6e27 to be 1. If 'n' │ │ │ │ │ -00012b40: 2069 7320 6772 6561 7465 7220 7468 616e is greater than │ │ │ │ │ -00012b50: 2027 2423 272c 2074 6865 0a20 2020 2020 '$#', the. │ │ │ │ │ -00012b60: 706f 7369 7469 6f6e 616c 2070 6172 616d positional param │ │ │ │ │ -00012b70: 6574 6572 7320 6172 6520 6e6f 7420 6368 eters are not ch │ │ │ │ │ -00012b80: 616e 6765 642e 2020 5468 6520 7265 7475 anged. The retu │ │ │ │ │ -00012b90: 726e 2073 7461 7475 7320 6973 0a20 2020 rn status is. │ │ │ │ │ -00012ba0: 2020 6772 6561 7465 7220 7468 616e 207a greater than z │ │ │ │ │ -00012bb0: 6572 6f20 6966 2027 6e27 2069 7320 6772 ero if 'n' is gr │ │ │ │ │ -00012bc0: 6561 7465 7220 7468 616e 2027 2423 2720 eater than '$#' │ │ │ │ │ -00012bd0: 6f72 206c 6573 7320 7468 616e 207a 6572 or less than zer │ │ │ │ │ -00012be0: 6f3b 0a20 2020 2020 6f74 6865 7277 6973 o;. otherwis │ │ │ │ │ -00012bf0: 6520 302e 0a0a 1f0a 4669 6c65 3a20 6772 e 0.....File: gr │ │ │ │ │ -00012c00: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00012c10: 5368 656c 6c2d 6c69 6b65 2073 6372 6970 Shell-like scrip │ │ │ │ │ -00012c20: 7469 6e67 2d46 6f6f 746e 6f74 6573 2c20 ting-Footnotes, │ │ │ │ │ -00012c30: 2055 703a 2053 6865 6c6c 2d6c 696b 6520 Up: Shell-like │ │ │ │ │ -00012c40: 7363 7269 7074 696e 670a 0a20 2020 2831 scripting.. (1 │ │ │ │ │ -00012c50: 2920 4375 7272 656e 746c 7920 6120 6261 ) Currently a ba │ │ │ │ │ -00012c60: 636b 736c 6173 682d 6e65 776c 696e 6520 ckslash-newline │ │ │ │ │ -00012c70: 7061 6972 2077 6974 6869 6e20 6120 7661 pair within a va │ │ │ │ │ -00012c80: 7269 6162 6c65 206e 616d 6520 6973 206e riable name is n │ │ │ │ │ -00012c90: 6f74 0a68 616e 646c 6564 2070 726f 7065 ot.handled prope │ │ │ │ │ -00012ca0: 726c 792c 2073 6f20 7573 6520 7468 6973 rly, so use this │ │ │ │ │ -00012cb0: 2066 6561 7475 7265 2077 6974 6820 736f feature with so │ │ │ │ │ -00012cc0: 6d65 2063 6172 652e 0a0a 1f0a 4669 6c65 me care.....File │ │ │ │ │ -00012cd0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00012ce0: 6465 3a20 4d75 6c74 692d 626f 6f74 206d de: Multi-boot m │ │ │ │ │ -00012cf0: 616e 7561 6c20 636f 6e66 6967 2c20 204e anual config, N │ │ │ │ │ -00012d00: 6578 743a 2045 6d62 6564 6465 6420 636f ext: Embedded co │ │ │ │ │ -00012d10: 6e66 6967 7572 6174 696f 6e2c 2020 5072 nfiguration, Pr │ │ │ │ │ -00012d20: 6576 3a20 5368 656c 6c2d 6c69 6b65 2073 ev: Shell-like s │ │ │ │ │ -00012d30: 6372 6970 7469 6e67 2c20 2055 703a 2043 cripting, Up: C │ │ │ │ │ -00012d40: 6f6e 6669 6775 7261 7469 6f6e 0a0a 362e onfiguration..6. │ │ │ │ │ -00012d50: 3420 4d75 6c74 692d 626f 6f74 206d 616e 4 Multi-boot man │ │ │ │ │ -00012d60: 7561 6c20 636f 6e66 6967 0a3d 3d3d 3d3d ual config.===== │ │ │ │ │ +00010d50: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00010d60: 0a27 6772 7562 2e63 6667 2720 6973 2077 .'grub.cfg' is w │ │ │ │ │ +00010d70: 7269 7474 656e 2069 6e20 4752 5542 2773 ritten in GRUB's │ │ │ │ │ +00010d80: 2062 7569 6c74 2d69 6e20 7363 7269 7074 built-in script │ │ │ │ │ +00010d90: 696e 6720 6c61 6e67 7561 6765 2c20 7768 ing language, wh │ │ │ │ │ +00010da0: 6963 6820 6861 7320 610a 7379 6e74 6178 ich has a.syntax │ │ │ │ │ +00010db0: 2071 7569 7465 2073 696d 696c 6172 2074 quite similar t │ │ │ │ │ +00010dc0: 6f20 7468 6174 206f 6620 474e 5520 4261 o that of GNU Ba │ │ │ │ │ +00010dd0: 7368 2061 6e64 206f 7468 6572 2042 6f75 sh and other Bou │ │ │ │ │ +00010de0: 726e 6520 7368 656c 6c0a 6465 7269 7661 rne shell.deriva │ │ │ │ │ +00010df0: 7469 7665 732e 0a0a 576f 7264 730a 3d3d tives...Words.== │ │ │ │ │ +00010e00: 3d3d 3d0a 0a41 2022 776f 7264 2220 6973 ===..A "word" is │ │ │ │ │ +00010e10: 2061 2073 6571 7565 6e63 6520 6f66 2063 a sequence of c │ │ │ │ │ +00010e20: 6861 7261 6374 6572 7320 636f 6e73 6964 haracters consid │ │ │ │ │ +00010e30: 6572 6564 2061 7320 6120 7369 6e67 6c65 ered as a single │ │ │ │ │ +00010e40: 2075 6e69 7420 6279 0a47 5255 422e 2057 unit by.GRUB. W │ │ │ │ │ +00010e50: 6f72 6473 2061 7265 2073 6570 6172 6174 ords are separat │ │ │ │ │ +00010e60: 6564 2062 7920 226d 6574 6163 6861 7261 ed by "metachara │ │ │ │ │ +00010e70: 6374 6572 7322 2c20 7768 6963 6820 6172 cters", which ar │ │ │ │ │ +00010e80: 6520 7468 6520 666f 6c6c 6f77 696e 670a e the following. │ │ │ │ │ +00010e90: 706c 7573 2073 7061 6365 2c20 7461 622c plus space, tab, │ │ │ │ │ +00010ea0: 2061 6e64 206e 6577 6c69 6e65 3a0a 0a20 and newline:.. │ │ │ │ │ +00010eb0: 2020 2020 7b20 7d20 7c20 2620 2420 3b20 { } | & $ ; │ │ │ │ │ +00010ec0: 3c20 3e0a 0a20 2020 5175 6f74 696e 6720 < >.. Quoting │ │ │ │ │ +00010ed0: 6d61 7920 6265 2075 7365 6420 746f 2069 may be used to i │ │ │ │ │ +00010ee0: 6e63 6c75 6465 206d 6574 6163 6861 7261 nclude metachara │ │ │ │ │ +00010ef0: 6374 6572 7320 696e 2077 6f72 6473 3b20 cters in words; │ │ │ │ │ +00010f00: 7365 6520 6265 6c6f 772e 0a0a 5265 7365 see below...Rese │ │ │ │ │ +00010f10: 7276 6564 2077 6f72 6473 0a3d 3d3d 3d3d rved words.===== │ │ │ │ │ +00010f20: 3d3d 3d3d 3d3d 3d3d 3d0a 0a52 6573 6572 =========..Reser │ │ │ │ │ +00010f30: 7665 6420 776f 7264 7320 6861 7665 2061 ved words have a │ │ │ │ │ +00010f40: 2073 7065 6369 616c 206d 6561 6e69 6e67 special meaning │ │ │ │ │ +00010f50: 2074 6f20 4752 5542 2e20 5468 6520 666f to GRUB. The fo │ │ │ │ │ +00010f60: 6c6c 6f77 696e 6720 776f 7264 7320 6172 llowing words ar │ │ │ │ │ +00010f70: 650a 7265 636f 676e 6973 6564 2061 7320 e.recognised as │ │ │ │ │ +00010f80: 7265 7365 7276 6564 2077 6865 6e20 756e reserved when un │ │ │ │ │ +00010f90: 7175 6f74 6564 2061 6e64 2065 6974 6865 quoted and eithe │ │ │ │ │ +00010fa0: 7220 7468 6520 6669 7273 7420 776f 7264 r the first word │ │ │ │ │ +00010fb0: 206f 6620 610a 7369 6d70 6c65 2063 6f6d of a.simple com │ │ │ │ │ +00010fc0: 6d61 6e64 206f 7220 7468 6520 7468 6972 mand or the thir │ │ │ │ │ +00010fd0: 6420 776f 7264 206f 6620 6120 2766 6f72 d word of a 'for │ │ │ │ │ +00010fe0: 2720 636f 6d6d 616e 643a 0a0a 2020 2020 ' command:.. │ │ │ │ │ +00010ff0: 2021 205b 5b20 5d5d 207b 207d 0a20 2020 ! [[ ]] { }. │ │ │ │ │ +00011000: 2020 6361 7365 2064 6f20 646f 6e65 2065 case do done e │ │ │ │ │ +00011010: 6c69 6620 656c 7365 2065 7361 6320 6669 lif else esac fi │ │ │ │ │ +00011020: 2066 6f72 2066 756e 6374 696f 6e0a 2020 for function. │ │ │ │ │ +00011030: 2020 2069 6620 696e 206d 656e 7565 6e74 if in menuent │ │ │ │ │ +00011040: 7279 2073 656c 6563 7420 7468 656e 2074 ry select then t │ │ │ │ │ +00011050: 696d 6520 756e 7469 6c20 7768 696c 650a ime until while. │ │ │ │ │ +00011060: 0a20 2020 4e6f 7420 616c 6c20 6f66 2074 . Not all of t │ │ │ │ │ +00011070: 6865 7365 2072 6573 6572 7665 6420 776f hese reserved wo │ │ │ │ │ +00011080: 7264 7320 6861 7665 2061 2075 7365 6675 rds have a usefu │ │ │ │ │ +00011090: 6c20 7075 7270 6f73 6520 7965 743b 2073 l purpose yet; s │ │ │ │ │ +000110a0: 6f6d 6520 6172 650a 7265 7365 7276 6564 ome are.reserved │ │ │ │ │ +000110b0: 2066 6f72 2066 7574 7572 6520 6578 7061 for future expa │ │ │ │ │ +000110c0: 6e73 696f 6e2e 0a0a 5175 6f74 696e 670a nsion...Quoting. │ │ │ │ │ +000110d0: 3d3d 3d3d 3d3d 3d0a 0a51 756f 7469 6e67 =======..Quoting │ │ │ │ │ +000110e0: 2069 7320 7573 6564 2074 6f20 7265 6d6f is used to remo │ │ │ │ │ +000110f0: 7665 2074 6865 2073 7065 6369 616c 206d ve the special m │ │ │ │ │ +00011100: 6561 6e69 6e67 206f 6620 6365 7274 6169 eaning of certai │ │ │ │ │ +00011110: 6e20 6368 6172 6163 7465 7273 206f 720a n characters or. │ │ │ │ │ +00011120: 776f 7264 732e 2020 4974 2063 616e 2062 words. It can b │ │ │ │ │ +00011130: 6520 7573 6564 2074 6f20 7472 6561 7420 e used to treat │ │ │ │ │ +00011140: 6d65 7461 6368 6172 6163 7465 7273 2061 metacharacters a │ │ │ │ │ +00011150: 7320 7061 7274 206f 6620 6120 776f 7264 s part of a word │ │ │ │ │ +00011160: 2c20 746f 0a70 7265 7665 6e74 2072 6573 , to.prevent res │ │ │ │ │ +00011170: 6572 7665 6420 776f 7264 7320 6672 6f6d erved words from │ │ │ │ │ +00011180: 2062 6569 6e67 2072 6563 6f67 6e69 7365 being recognise │ │ │ │ │ +00011190: 6420 6173 2073 7563 682c 2061 6e64 2074 d as such, and t │ │ │ │ │ +000111a0: 6f20 7072 6576 656e 740a 7661 7269 6162 o prevent.variab │ │ │ │ │ +000111b0: 6c65 2065 7870 616e 7369 6f6e 2e0a 0a20 le expansion... │ │ │ │ │ +000111c0: 2020 5468 6572 6520 6172 6520 7468 7265 There are thre │ │ │ │ │ +000111d0: 6520 7175 6f74 696e 6720 6d65 6368 616e e quoting mechan │ │ │ │ │ +000111e0: 6973 6d73 3a20 7468 6520 6573 6361 7065 isms: the escape │ │ │ │ │ +000111f0: 2063 6861 7261 6374 6572 2c20 7369 6e67 character, sing │ │ │ │ │ +00011200: 6c65 0a71 756f 7465 732c 2061 6e64 2064 le.quotes, and d │ │ │ │ │ +00011210: 6f75 626c 6520 7175 6f74 6573 2e0a 0a20 ouble quotes... │ │ │ │ │ +00011220: 2020 4120 6e6f 6e2d 7175 6f74 6564 2062 A non-quoted b │ │ │ │ │ +00011230: 6163 6b73 6c61 7368 2028 5c29 2069 7320 ackslash (\) is │ │ │ │ │ +00011240: 7468 6520 2265 7363 6170 6520 6368 6172 the "escape char │ │ │ │ │ +00011250: 6163 7465 7222 2e20 2049 7420 7072 6573 acter". It pres │ │ │ │ │ +00011260: 6572 7665 730a 7468 6520 6c69 7465 7261 erves.the litera │ │ │ │ │ +00011270: 6c20 7661 6c75 6520 6f66 2074 6865 206e l value of the n │ │ │ │ │ +00011280: 6578 7420 6368 6172 6163 7465 7220 7468 ext character th │ │ │ │ │ +00011290: 6174 2066 6f6c 6c6f 7773 2c20 7769 7468 at follows, with │ │ │ │ │ +000112a0: 2074 6865 2065 7863 6570 7469 6f6e 0a6f the exception.o │ │ │ │ │ +000112b0: 6620 6e65 776c 696e 652e 0a0a 2020 2045 f newline... E │ │ │ │ │ +000112c0: 6e63 6c6f 7369 6e67 2063 6861 7261 6374 nclosing charact │ │ │ │ │ +000112d0: 6572 7320 696e 2073 696e 676c 6520 7175 ers in single qu │ │ │ │ │ +000112e0: 6f74 6573 2070 7265 7365 7276 6573 2074 otes preserves t │ │ │ │ │ +000112f0: 6865 206c 6974 6572 616c 2076 616c 7565 he literal value │ │ │ │ │ +00011300: 206f 660a 6561 6368 2063 6861 7261 6374 of.each charact │ │ │ │ │ +00011310: 6572 2077 6974 6869 6e20 7468 6520 7175 er within the qu │ │ │ │ │ +00011320: 6f74 6573 2e20 2041 2073 696e 676c 6520 otes. A single │ │ │ │ │ +00011330: 7175 6f74 6520 6d61 7920 6e6f 7420 6f63 quote may not oc │ │ │ │ │ +00011340: 6375 7220 6265 7477 6565 6e0a 7369 6e67 cur between.sing │ │ │ │ │ +00011350: 6c65 2071 756f 7465 732c 2065 7665 6e20 le quotes, even │ │ │ │ │ +00011360: 7768 656e 2070 7265 6365 6465 6420 6279 when preceded by │ │ │ │ │ +00011370: 2061 2062 6163 6b73 6c61 7368 2e0a 0a20 a backslash... │ │ │ │ │ +00011380: 2020 456e 636c 6f73 696e 6720 6368 6172 Enclosing char │ │ │ │ │ +00011390: 6163 7465 7273 2069 6e20 646f 7562 6c65 acters in double │ │ │ │ │ +000113a0: 2071 756f 7465 7320 7072 6573 6572 7665 quotes preserve │ │ │ │ │ +000113b0: 7320 7468 6520 6c69 7465 7261 6c20 7661 s the literal va │ │ │ │ │ +000113c0: 6c75 6520 6f66 0a61 6c6c 2063 6861 7261 lue of.all chara │ │ │ │ │ +000113d0: 6374 6572 7320 7769 7468 696e 2074 6865 cters within the │ │ │ │ │ +000113e0: 2071 756f 7465 732c 2077 6974 6820 7468 quotes, with th │ │ │ │ │ +000113f0: 6520 6578 6365 7074 696f 6e20 6f66 2027 e exception of ' │ │ │ │ │ +00011400: 2427 2061 6e64 2027 5c27 2e0a 5468 6520 $' and '\'..The │ │ │ │ │ +00011410: 2724 2720 6368 6172 6163 7465 7220 7265 '$' character re │ │ │ │ │ +00011420: 7461 696e 7320 6974 7320 7370 6563 6961 tains its specia │ │ │ │ │ +00011430: 6c20 6d65 616e 696e 6720 7769 7468 696e l meaning within │ │ │ │ │ +00011440: 2064 6f75 626c 6520 7175 6f74 6573 2e20 double quotes. │ │ │ │ │ +00011450: 2054 6865 0a62 6163 6b73 6c61 7368 2072 The.backslash r │ │ │ │ │ +00011460: 6574 6169 6e73 2069 7473 2073 7065 6369 etains its speci │ │ │ │ │ +00011470: 616c 206d 6561 6e69 6e67 206f 6e6c 7920 al meaning only │ │ │ │ │ +00011480: 7768 656e 2066 6f6c 6c6f 7765 6420 6279 when followed by │ │ │ │ │ +00011490: 206f 6e65 206f 6620 7468 650a 666f 6c6c one of the.foll │ │ │ │ │ +000114a0: 6f77 696e 6720 6368 6172 6163 7465 7273 owing characters │ │ │ │ │ +000114b0: 3a20 2724 272c 2027 2227 2c20 275c 272c : '$', '"', '\', │ │ │ │ │ +000114c0: 206f 7220 6e65 776c 696e 652e 2020 4120 or newline. A │ │ │ │ │ +000114d0: 6261 636b 736c 6173 682d 6e65 776c 696e backslash-newlin │ │ │ │ │ +000114e0: 650a 7061 6972 2069 7320 7472 6561 7465 e.pair is treate │ │ │ │ │ +000114f0: 6420 6173 2061 206c 696e 6520 636f 6e74 d as a line cont │ │ │ │ │ +00011500: 696e 7561 7469 6f6e 2028 7468 6174 2069 inuation (that i │ │ │ │ │ +00011510: 732c 2069 7420 6973 2072 656d 6f76 6564 s, it is removed │ │ │ │ │ +00011520: 2066 726f 6d20 7468 650a 696e 7075 7420 from the.input │ │ │ │ │ +00011530: 7374 7265 616d 2061 6e64 2065 6666 6563 stream and effec │ │ │ │ │ +00011540: 7469 7665 6c79 2069 676e 6f72 6564 2831 tively ignored(1 │ │ │ │ │ +00011550: 2920 282a 6e6f 7465 2053 6865 6c6c 2d6c ) (*note Shell-l │ │ │ │ │ +00011560: 696b 650a 7363 7269 7074 696e 672d 466f ike.scripting-Fo │ │ │ │ │ +00011570: 6f74 6e6f 7465 2d31 3a3a 2929 2e20 2041 otnote-1::)). A │ │ │ │ │ +00011580: 2064 6f75 626c 6520 7175 6f74 6520 6d61 double quote ma │ │ │ │ │ +00011590: 7920 6265 2071 756f 7465 6420 7769 7468 y be quoted with │ │ │ │ │ +000115a0: 696e 2064 6f75 626c 650a 7175 6f74 6573 in double.quotes │ │ │ │ │ +000115b0: 2062 7920 7072 6563 6564 696e 6720 6974 by preceding it │ │ │ │ │ +000115c0: 2077 6974 6820 6120 6261 636b 736c 6173 with a backslas │ │ │ │ │ +000115d0: 682e 0a0a 5661 7269 6162 6c65 2065 7870 h...Variable exp │ │ │ │ │ +000115e0: 616e 7369 6f6e 0a3d 3d3d 3d3d 3d3d 3d3d ansion.========= │ │ │ │ │ +000115f0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 2027 =========..The ' │ │ │ │ │ +00011600: 2427 2063 6861 7261 6374 6572 2069 6e74 $' character int │ │ │ │ │ +00011610: 726f 6475 6365 7320 7661 7269 6162 6c65 roduces variable │ │ │ │ │ +00011620: 2065 7870 616e 7369 6f6e 2e20 2054 6865 expansion. The │ │ │ │ │ +00011630: 2076 6172 6961 626c 6520 6e61 6d65 2074 variable name t │ │ │ │ │ +00011640: 6f0a 6265 2065 7870 616e 6465 6420 6d61 o.be expanded ma │ │ │ │ │ +00011650: 7920 6265 2065 6e63 6c6f 7365 6420 696e y be enclosed in │ │ │ │ │ +00011660: 2062 7261 6365 732c 2077 6869 6368 2061 braces, which a │ │ │ │ │ +00011670: 7265 206f 7074 696f 6e61 6c20 6275 7420 re optional but │ │ │ │ │ +00011680: 7365 7276 6520 746f 0a70 726f 7465 6374 serve to.protect │ │ │ │ │ +00011690: 2074 6865 2076 6172 6961 626c 6520 746f the variable to │ │ │ │ │ +000116a0: 2062 6520 6578 7061 6e64 6564 2066 726f be expanded fro │ │ │ │ │ +000116b0: 6d20 6368 6172 6163 7465 7273 2069 6d6d m characters imm │ │ │ │ │ +000116c0: 6564 6961 7465 6c79 0a66 6f6c 6c6f 7769 ediately.followi │ │ │ │ │ +000116d0: 6e67 2069 7420 7768 6963 6820 636f 756c ng it which coul │ │ │ │ │ +000116e0: 6420 6265 2069 6e74 6572 7072 6574 6564 d be interpreted │ │ │ │ │ +000116f0: 2061 7320 7061 7274 206f 6620 7468 6520 as part of the │ │ │ │ │ +00011700: 6e61 6d65 2e0a 0a20 2020 4e6f 726d 616c name... Normal │ │ │ │ │ +00011710: 2076 6172 6961 626c 6520 6e61 6d65 7320 variable names │ │ │ │ │ +00011720: 6265 6769 6e20 7769 7468 2061 6e20 616c begin with an al │ │ │ │ │ +00011730: 7068 6162 6574 6963 2063 6861 7261 6374 phabetic charact │ │ │ │ │ +00011740: 6572 2c20 666f 6c6c 6f77 6564 2062 790a er, followed by. │ │ │ │ │ +00011750: 7a65 726f 206f 7220 6d6f 7265 2061 6c70 zero or more alp │ │ │ │ │ +00011760: 6861 6e75 6d65 7269 6320 6368 6172 6163 hanumeric charac │ │ │ │ │ +00011770: 7465 7273 2e20 2054 6865 7365 206e 616d ters. These nam │ │ │ │ │ +00011780: 6573 2072 6566 6572 2074 6f20 656e 7472 es refer to entr │ │ │ │ │ +00011790: 6965 7320 696e 0a74 6865 2047 5255 4220 ies in.the GRUB │ │ │ │ │ +000117a0: 656e 7669 726f 6e6d 656e 7420 282a 6e6f environment (*no │ │ │ │ │ +000117b0: 7465 2045 6e76 6972 6f6e 6d65 6e74 3a3a te Environment:: │ │ │ │ │ +000117c0: 292e 0a0a 2020 2050 6f73 6974 696f 6e61 )... Positiona │ │ │ │ │ +000117d0: 6c20 7661 7269 6162 6c65 206e 616d 6573 l variable names │ │ │ │ │ +000117e0: 2063 6f6e 7369 7374 206f 6620 6f6e 6520 consist of one │ │ │ │ │ +000117f0: 6f72 206d 6f72 6520 6469 6769 7473 2e20 or more digits. │ │ │ │ │ +00011800: 2054 6865 790a 7265 7072 6573 656e 7420 They.represent │ │ │ │ │ +00011810: 7061 7261 6d65 7465 7273 2070 6173 7365 parameters passe │ │ │ │ │ +00011820: 6420 746f 2066 756e 6374 696f 6e20 6361 d to function ca │ │ │ │ │ +00011830: 6c6c 732c 2077 6974 6820 2724 3127 2072 lls, with '$1' r │ │ │ │ │ +00011840: 6570 7265 7365 6e74 696e 670a 7468 6520 epresenting.the │ │ │ │ │ +00011850: 6669 7273 7420 7061 7261 6d65 7465 722c first parameter, │ │ │ │ │ +00011860: 2061 6e64 2073 6f20 6f6e 2e0a 0a20 2020 and so on... │ │ │ │ │ +00011870: 5468 6520 7370 6563 6961 6c20 7661 7269 The special vari │ │ │ │ │ +00011880: 6162 6c65 206e 616d 6520 273f 2720 6578 able name '?' ex │ │ │ │ │ +00011890: 7061 6e64 7320 746f 2074 6865 2065 7869 pands to the exi │ │ │ │ │ +000118a0: 7420 7374 6174 7573 206f 6620 7468 6520 t status of the │ │ │ │ │ +000118b0: 6d6f 7374 0a72 6563 656e 746c 7920 6578 most.recently ex │ │ │ │ │ +000118c0: 6563 7574 6564 2063 6f6d 6d61 6e64 2e20 ecuted command. │ │ │ │ │ +000118d0: 2057 6865 6e20 706f 7369 7469 6f6e 616c When positional │ │ │ │ │ +000118e0: 2076 6172 6961 626c 6520 6e61 6d65 7320 variable names │ │ │ │ │ +000118f0: 6172 6520 6163 7469 7665 2c0a 6f74 6865 are active,.othe │ │ │ │ │ +00011900: 7220 7370 6563 6961 6c20 7661 7269 6162 r special variab │ │ │ │ │ +00011910: 6c65 206e 616d 6573 2027 4027 2c20 272a le names '@', '* │ │ │ │ │ +00011920: 2720 616e 6420 2723 2720 6172 6520 6465 ' and '#' are de │ │ │ │ │ +00011930: 6669 6e65 6420 616e 6420 7468 6579 0a65 fined and they.e │ │ │ │ │ +00011940: 7870 616e 6420 746f 2061 6c6c 2070 6f73 xpand to all pos │ │ │ │ │ +00011950: 6974 696f 6e61 6c20 7061 7261 6d65 7465 itional paramete │ │ │ │ │ +00011960: 7273 2077 6974 6820 6e65 6365 7373 6172 rs with necessar │ │ │ │ │ +00011970: 7920 7175 6f74 696e 672c 2070 6f73 6974 y quoting, posit │ │ │ │ │ +00011980: 696f 6e61 6c0a 7061 7261 6d65 7465 7273 ional.parameters │ │ │ │ │ +00011990: 2077 6974 686f 7574 2061 6e79 2071 756f without any quo │ │ │ │ │ +000119a0: 7469 6e67 2c20 616e 6420 706f 7369 7469 ting, and positi │ │ │ │ │ +000119b0: 6f6e 616c 2070 6172 616d 6574 6572 2063 onal parameter c │ │ │ │ │ +000119c0: 6f75 6e74 0a72 6573 7065 6374 6976 656c ount.respectivel │ │ │ │ │ +000119d0: 792e 0a0a 436f 6d6d 656e 7473 0a3d 3d3d y...Comments.=== │ │ │ │ │ +000119e0: 3d3d 3d3d 3d0a 0a41 2077 6f72 6420 6265 =====..A word be │ │ │ │ │ +000119f0: 6769 6e6e 696e 6720 7769 7468 2027 2327 ginning with '#' │ │ │ │ │ +00011a00: 2063 6175 7365 7320 7468 6174 2077 6f72 causes that wor │ │ │ │ │ +00011a10: 6420 616e 6420 616c 6c20 7265 6d61 696e d and all remain │ │ │ │ │ +00011a20: 696e 6720 6368 6172 6163 7465 7273 0a6f ing characters.o │ │ │ │ │ +00011a30: 6e20 7468 6174 206c 696e 6520 746f 2062 n that line to b │ │ │ │ │ +00011a40: 6520 6967 6e6f 7265 642e 0a0a 5369 6d70 e ignored...Simp │ │ │ │ │ +00011a50: 6c65 2063 6f6d 6d61 6e64 730a 3d3d 3d3d le commands.==== │ │ │ │ │ +00011a60: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 2022 ===========..A " │ │ │ │ │ +00011a70: 7369 6d70 6c65 2063 6f6d 6d61 6e64 2220 simple command" │ │ │ │ │ +00011a80: 6973 2061 2073 6571 7565 6e63 6520 6f66 is a sequence of │ │ │ │ │ +00011a90: 2077 6f72 6473 2073 6570 6172 6174 6564 words separated │ │ │ │ │ +00011aa0: 2062 7920 7370 6163 6573 206f 7220 7461 by spaces or ta │ │ │ │ │ +00011ab0: 6273 0a61 6e64 2074 6572 6d69 6e61 7465 bs.and terminate │ │ │ │ │ +00011ac0: 6420 6279 2061 2073 656d 6963 6f6c 6f6e d by a semicolon │ │ │ │ │ +00011ad0: 206f 7220 6120 6e65 776c 696e 652e 2020 or a newline. │ │ │ │ │ +00011ae0: 5468 6520 6669 7273 7420 776f 7264 2073 The first word s │ │ │ │ │ +00011af0: 7065 6369 6669 6573 0a74 6865 2063 6f6d pecifies.the com │ │ │ │ │ +00011b00: 6d61 6e64 2074 6f20 6265 2065 7865 6375 mand to be execu │ │ │ │ │ +00011b10: 7465 642e 2020 5468 6520 7265 6d61 696e ted. The remain │ │ │ │ │ +00011b20: 696e 6720 776f 7264 7320 6172 6520 7061 ing words are pa │ │ │ │ │ +00011b30: 7373 6564 2061 7320 6172 6775 6d65 6e74 ssed as argument │ │ │ │ │ +00011b40: 730a 746f 2074 6865 2069 6e76 6f6b 6564 s.to the invoked │ │ │ │ │ +00011b50: 2063 6f6d 6d61 6e64 2e0a 0a20 2020 5468 command... Th │ │ │ │ │ +00011b60: 6520 7265 7475 726e 2076 616c 7565 206f e return value o │ │ │ │ │ +00011b70: 6620 6120 7369 6d70 6c65 2063 6f6d 6d61 f a simple comma │ │ │ │ │ +00011b80: 6e64 2069 7320 6974 7320 6578 6974 2073 nd is its exit s │ │ │ │ │ +00011b90: 7461 7475 732e 2020 4966 2074 6865 0a72 tatus. If the.r │ │ │ │ │ +00011ba0: 6573 6572 7665 6420 776f 7264 2027 2127 eserved word '!' │ │ │ │ │ +00011bb0: 2070 7265 6365 6465 7320 7468 6520 636f precedes the co │ │ │ │ │ +00011bc0: 6d6d 616e 642c 2074 6865 6e20 7468 6520 mmand, then the │ │ │ │ │ +00011bd0: 7265 7475 726e 2076 616c 7565 2069 7320 return value is │ │ │ │ │ +00011be0: 696e 7374 6561 640a 7468 6520 6c6f 6769 instead.the logi │ │ │ │ │ +00011bf0: 6361 6c20 6e65 6761 7469 6f6e 206f 6620 cal negation of │ │ │ │ │ +00011c00: 7468 6520 636f 6d6d 616e 6427 7320 6578 the command's ex │ │ │ │ │ +00011c10: 6974 2073 7461 7475 732e 0a0a 436f 6d70 it status...Comp │ │ │ │ │ +00011c20: 6f75 6e64 2063 6f6d 6d61 6e64 730a 3d3d ound commands.== │ │ │ │ │ +00011c30: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00011c40: 0a41 2022 636f 6d70 6f75 6e64 2063 6f6d .A "compound com │ │ │ │ │ +00011c50: 6d61 6e64 2220 6973 206f 6e65 206f 6620 mand" is one of │ │ │ │ │ +00011c60: 7468 6520 666f 6c6c 6f77 696e 673a 0a0a the following:.. │ │ │ │ │ +00011c70: 666f 7220 4e41 4d45 2069 6e20 574f 5244 for NAME in WORD │ │ │ │ │ +00011c80: 202e 2e2e 3b20 646f 204c 4953 543b 2064 ...; do LIST; d │ │ │ │ │ +00011c90: 6f6e 650a 2020 2020 2054 6865 206c 6973 one. The lis │ │ │ │ │ +00011ca0: 7420 6f66 2077 6f72 6473 2066 6f6c 6c6f t of words follo │ │ │ │ │ +00011cb0: 7769 6e67 2027 696e 2720 6973 2065 7870 wing 'in' is exp │ │ │ │ │ +00011cc0: 616e 6465 642c 2067 656e 6572 6174 696e anded, generatin │ │ │ │ │ +00011cd0: 6720 6120 6c69 7374 206f 660a 2020 2020 g a list of. │ │ │ │ │ +00011ce0: 2069 7465 6d73 2e20 2054 6865 2076 6172 items. The var │ │ │ │ │ +00011cf0: 6961 626c 6520 4e41 4d45 2069 7320 7365 iable NAME is se │ │ │ │ │ +00011d00: 7420 746f 2065 6163 6820 656c 656d 656e t to each elemen │ │ │ │ │ +00011d10: 7420 6f66 2074 6869 7320 6c69 7374 2069 t of this list i │ │ │ │ │ +00011d20: 6e0a 2020 2020 2074 7572 6e2c 2061 6e64 n. turn, and │ │ │ │ │ +00011d30: 204c 4953 5420 6973 2065 7865 6375 7465 LIST is execute │ │ │ │ │ +00011d40: 6420 6561 6368 2074 696d 652e 2020 5468 d each time. Th │ │ │ │ │ +00011d50: 6520 7265 7475 726e 2076 616c 7565 2069 e return value i │ │ │ │ │ +00011d60: 7320 7468 6520 6578 6974 0a20 2020 2020 s the exit. │ │ │ │ │ +00011d70: 7374 6174 7573 206f 6620 7468 6520 6c61 status of the la │ │ │ │ │ +00011d80: 7374 2063 6f6d 6d61 6e64 2074 6861 7420 st command that │ │ │ │ │ +00011d90: 6578 6563 7574 6573 2e20 2049 6620 7468 executes. If th │ │ │ │ │ +00011da0: 6520 6578 7061 6e73 696f 6e20 6f66 2074 e expansion of t │ │ │ │ │ +00011db0: 6865 0a20 2020 2020 6974 656d 7320 666f he. items fo │ │ │ │ │ +00011dc0: 6c6c 6f77 696e 6720 2769 6e27 2072 6573 llowing 'in' res │ │ │ │ │ +00011dd0: 756c 7473 2069 6e20 616e 2065 6d70 7479 ults in an empty │ │ │ │ │ +00011de0: 206c 6973 742c 206e 6f20 636f 6d6d 616e list, no comman │ │ │ │ │ +00011df0: 6473 2061 7265 0a20 2020 2020 6578 6563 ds are. exec │ │ │ │ │ +00011e00: 7574 6564 2c20 616e 6420 7468 6520 7265 uted, and the re │ │ │ │ │ +00011e10: 7475 726e 2073 7461 7475 7320 6973 2030 turn status is 0 │ │ │ │ │ +00011e20: 2e0a 0a69 6620 4c49 5354 3b20 7468 656e ...if LIST; then │ │ │ │ │ +00011e30: 204c 4953 543b 205b 656c 6966 204c 4953 LIST; [elif LIS │ │ │ │ │ +00011e40: 543b 2074 6865 6e20 4c49 5354 3b5d 202e T; then LIST;] . │ │ │ │ │ +00011e50: 2e2e 205b 656c 7365 204c 4953 543b 5d20 .. [else LIST;] │ │ │ │ │ +00011e60: 6669 0a20 2020 2020 5468 6520 2769 6627 fi. The 'if' │ │ │ │ │ +00011e70: 204c 4953 5420 6973 2065 7865 6375 7465 LIST is execute │ │ │ │ │ +00011e80: 642e 2020 4966 2069 7473 2065 7869 7420 d. If its exit │ │ │ │ │ +00011e90: 7374 6174 7573 2069 7320 7a65 726f 2c20 status is zero, │ │ │ │ │ +00011ea0: 7468 6520 2774 6865 6e27 0a20 2020 2020 the 'then'. │ │ │ │ │ +00011eb0: 4c49 5354 2069 7320 6578 6563 7574 6564 LIST is executed │ │ │ │ │ +00011ec0: 2e20 204f 7468 6572 7769 7365 2c20 6561 . Otherwise, ea │ │ │ │ │ +00011ed0: 6368 2027 656c 6966 2720 4c49 5354 2069 ch 'elif' LIST i │ │ │ │ │ +00011ee0: 7320 6578 6563 7574 6564 2069 6e20 7475 s executed in tu │ │ │ │ │ +00011ef0: 726e 2c0a 2020 2020 2061 6e64 2069 6620 rn,. and if │ │ │ │ │ +00011f00: 6974 7320 6578 6974 2073 7461 7475 7320 its exit status │ │ │ │ │ +00011f10: 6973 207a 6572 6f2c 2074 6865 2063 6f72 is zero, the cor │ │ │ │ │ +00011f20: 7265 7370 6f6e 6469 6e67 2027 7468 656e responding 'then │ │ │ │ │ +00011f30: 2720 4c49 5354 2069 730a 2020 2020 2065 ' LIST is. e │ │ │ │ │ +00011f40: 7865 6375 7465 6420 616e 6420 7468 6520 xecuted and the │ │ │ │ │ +00011f50: 636f 6d6d 616e 6420 636f 6d70 6c65 7465 command complete │ │ │ │ │ +00011f60: 732e 2020 4f74 6865 7277 6973 652c 2074 s. Otherwise, t │ │ │ │ │ +00011f70: 6865 2027 656c 7365 2720 4c49 5354 2069 he 'else' LIST i │ │ │ │ │ +00011f80: 730a 2020 2020 2065 7865 6375 7465 642c s. executed, │ │ │ │ │ +00011f90: 2069 6620 7072 6573 656e 742e 2020 5468 if present. Th │ │ │ │ │ +00011fa0: 6520 6578 6974 2073 7461 7475 7320 6973 e exit status is │ │ │ │ │ +00011fb0: 2074 6865 2065 7869 7420 7374 6174 7573 the exit status │ │ │ │ │ +00011fc0: 206f 6620 7468 650a 2020 2020 206c 6173 of the. las │ │ │ │ │ +00011fd0: 7420 636f 6d6d 616e 6420 6578 6563 7574 t command execut │ │ │ │ │ +00011fe0: 6564 2c20 6f72 207a 6572 6f20 6966 206e ed, or zero if n │ │ │ │ │ +00011ff0: 6f20 636f 6e64 6974 696f 6e20 7465 7374 o condition test │ │ │ │ │ +00012000: 6564 2074 7275 652e 0a0a 7768 696c 6520 ed true...while │ │ │ │ │ +00012010: 434f 4e44 3b20 646f 204c 4953 543b 2064 COND; do LIST; d │ │ │ │ │ +00012020: 6f6e 650a 756e 7469 6c20 434f 4e44 3b20 one.until COND; │ │ │ │ │ +00012030: 646f 204c 4953 543b 2064 6f6e 650a 2020 do LIST; done. │ │ │ │ │ +00012040: 2020 2054 6865 2027 7768 696c 6527 2063 The 'while' c │ │ │ │ │ +00012050: 6f6d 6d61 6e64 2063 6f6e 7469 6e75 6f75 ommand continuou │ │ │ │ │ +00012060: 736c 7920 6578 6563 7574 6573 2074 6865 sly executes the │ │ │ │ │ +00012070: 2027 646f 2720 4c49 5354 2061 7320 6c6f 'do' LIST as lo │ │ │ │ │ +00012080: 6e67 2061 730a 2020 2020 2074 6865 206c ng as. the l │ │ │ │ │ +00012090: 6173 7420 636f 6d6d 616e 6420 696e 2043 ast command in C │ │ │ │ │ +000120a0: 4f4e 4420 7265 7475 726e 7320 616e 2065 OND returns an e │ │ │ │ │ +000120b0: 7869 7420 7374 6174 7573 206f 6620 7a65 xit status of ze │ │ │ │ │ +000120c0: 726f 2e20 2054 6865 0a20 2020 2020 2775 ro. The. 'u │ │ │ │ │ +000120d0: 6e74 696c 2720 636f 6d6d 616e 6420 6973 ntil' command is │ │ │ │ │ +000120e0: 2069 6465 6e74 6963 616c 2074 6f20 7468 identical to th │ │ │ │ │ +000120f0: 6520 2777 6869 6c65 2720 636f 6d6d 616e e 'while' comman │ │ │ │ │ +00012100: 642c 2065 7863 6570 7420 7468 6174 0a20 d, except that. │ │ │ │ │ +00012110: 2020 2020 7468 6520 7465 7374 2069 7320 the test is │ │ │ │ │ +00012120: 6e65 6761 7465 643b 2074 6865 2027 646f negated; the 'do │ │ │ │ │ +00012130: 2720 4c49 5354 2069 7320 6578 6563 7574 ' LIST is execut │ │ │ │ │ +00012140: 6564 2061 7320 6c6f 6e67 2061 7320 7468 ed as long as th │ │ │ │ │ +00012150: 6520 6c61 7374 0a20 2020 2020 636f 6d6d e last. comm │ │ │ │ │ +00012160: 616e 6420 696e 2043 4f4e 4420 7265 7475 and in COND retu │ │ │ │ │ +00012170: 726e 7320 6120 6e6f 6e2d 7a65 726f 2065 rns a non-zero e │ │ │ │ │ +00012180: 7869 7420 7374 6174 7573 2e20 2054 6865 xit status. The │ │ │ │ │ +00012190: 2065 7869 7420 7374 6174 7573 206f 660a exit status of. │ │ │ │ │ +000121a0: 2020 2020 2074 6865 2027 7768 696c 6527 the 'while' │ │ │ │ │ +000121b0: 2061 6e64 2027 756e 7469 6c27 2063 6f6d and 'until' com │ │ │ │ │ +000121c0: 6d61 6e64 7320 6973 2074 6865 2065 7869 mands is the exi │ │ │ │ │ +000121d0: 7420 7374 6174 7573 206f 6620 7468 6520 t status of the │ │ │ │ │ +000121e0: 6c61 7374 0a20 2020 2020 2764 6f27 204c last. 'do' L │ │ │ │ │ +000121f0: 4953 5420 636f 6d6d 616e 6420 6578 6563 IST command exec │ │ │ │ │ +00012200: 7574 6564 2c20 6f72 207a 6572 6f20 6966 uted, or zero if │ │ │ │ │ +00012210: 206e 6f6e 6520 7761 7320 6578 6563 7574 none was execut │ │ │ │ │ +00012220: 6564 2e0a 0a66 756e 6374 696f 6e20 4e41 ed...function NA │ │ │ │ │ +00012230: 4d45 207b 2043 4f4d 4d41 4e44 3b20 2e2e ME { COMMAND; .. │ │ │ │ │ +00012240: 2e20 7d0a 2020 2020 2054 6869 7320 6465 . }. This de │ │ │ │ │ +00012250: 6669 6e65 7320 6120 6675 6e63 7469 6f6e fines a function │ │ │ │ │ +00012260: 206e 616d 6564 204e 414d 452e 2020 5468 named NAME. Th │ │ │ │ │ +00012270: 6520 2262 6f64 7922 206f 6620 7468 6520 e "body" of the │ │ │ │ │ +00012280: 6675 6e63 7469 6f6e 2069 730a 2020 2020 function is. │ │ │ │ │ +00012290: 2074 6865 206c 6973 7420 6f66 2063 6f6d the list of com │ │ │ │ │ +000122a0: 6d61 6e64 7320 7769 7468 696e 2062 7261 mands within bra │ │ │ │ │ +000122b0: 6365 732c 2065 6163 6820 6f66 2077 6869 ces, each of whi │ │ │ │ │ +000122c0: 6368 206d 7573 7420 6265 0a20 2020 2020 ch must be. │ │ │ │ │ +000122d0: 7465 726d 696e 6174 6564 2077 6974 6820 terminated with │ │ │ │ │ +000122e0: 6120 7365 6d69 636f 6c6f 6e20 6f72 2061 a semicolon or a │ │ │ │ │ +000122f0: 206e 6577 6c69 6e65 2e20 2054 6869 7320 newline. This │ │ │ │ │ +00012300: 6c69 7374 206f 6620 636f 6d6d 616e 6473 list of commands │ │ │ │ │ +00012310: 0a20 2020 2020 7769 6c6c 2062 6520 6578 . will be ex │ │ │ │ │ +00012320: 6563 7574 6564 2077 6865 6e65 7665 7220 ecuted whenever │ │ │ │ │ +00012330: 4e41 4d45 2069 7320 7370 6563 6966 6965 NAME is specifie │ │ │ │ │ +00012340: 6420 6173 2074 6865 206e 616d 6520 6f66 d as the name of │ │ │ │ │ +00012350: 2061 2073 696d 706c 650a 2020 2020 2063 a simple. c │ │ │ │ │ +00012360: 6f6d 6d61 6e64 2e20 2046 756e 6374 696f ommand. Functio │ │ │ │ │ +00012370: 6e20 6465 6669 6e69 7469 6f6e 7320 646f n definitions do │ │ │ │ │ +00012380: 206e 6f74 2061 6666 6563 7420 7468 6520 not affect the │ │ │ │ │ +00012390: 6578 6974 2073 7461 7475 7320 696e 0a20 exit status in. │ │ │ │ │ +000123a0: 2020 2020 2724 3f27 2e20 2057 6865 6e20 '$?'. When │ │ │ │ │ +000123b0: 6578 6563 7574 6564 2c20 7468 6520 6578 executed, the ex │ │ │ │ │ +000123c0: 6974 2073 7461 7475 7320 6f66 2061 2066 it status of a f │ │ │ │ │ +000123d0: 756e 6374 696f 6e20 6973 2074 6865 2065 unction is the e │ │ │ │ │ +000123e0: 7869 740a 2020 2020 2073 7461 7475 7320 xit. status │ │ │ │ │ +000123f0: 6f66 2074 6865 206c 6173 7420 636f 6d6d of the last comm │ │ │ │ │ +00012400: 616e 6420 6578 6563 7574 6564 2069 6e20 and executed in │ │ │ │ │ +00012410: 7468 6520 626f 6479 2e0a 0a6d 656e 7565 the body...menue │ │ │ │ │ +00012420: 6e74 7279 2054 4954 4c45 205b 272d 2d63 ntry TITLE ['--c │ │ │ │ │ +00012430: 6c61 7373 3d63 6c61 7373 2720 2e2e 2e5d lass=class' ...] │ │ │ │ │ +00012440: 205b 272d 2d75 7365 7273 3d75 7365 7273 ['--users=users │ │ │ │ │ +00012450: 275d 205b 272d 2d75 6e72 6573 7472 6963 '] ['--unrestric │ │ │ │ │ +00012460: 7465 6427 5d20 5b27 2d2d 686f 746b 6579 ted'] ['--hotkey │ │ │ │ │ +00012470: 3d6b 6579 275d 205b 272d 2d69 643d 6964 =key'] ['--id=id │ │ │ │ │ +00012480: 275d 207b 2043 4f4d 4d41 4e44 3b20 2e2e '] { COMMAND; .. │ │ │ │ │ +00012490: 2e20 7d0a 2020 2020 202a 4e6f 7465 206d . }. *Note m │ │ │ │ │ +000124a0: 656e 7565 6e74 7279 3a3a 2e0a 0a42 7569 enuentry::...Bui │ │ │ │ │ +000124b0: 6c74 2d69 6e20 436f 6d6d 616e 6473 0a3d lt-in Commands.= │ │ │ │ │ +000124c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +000124d0: 0a0a 536f 6d65 2062 7569 6c74 2d69 6e20 ..Some built-in │ │ │ │ │ +000124e0: 636f 6d6d 616e 6473 2061 7265 2061 6c73 commands are als │ │ │ │ │ +000124f0: 6f20 7072 6f76 6964 6564 2062 7920 4752 o provided by GR │ │ │ │ │ +00012500: 5542 2073 6372 6970 7420 746f 2068 656c UB script to hel │ │ │ │ │ +00012510: 7020 7363 7269 7074 0a77 7269 7465 7273 p script.writers │ │ │ │ │ +00012520: 2070 6572 666f 726d 2061 6374 696f 6e73 perform actions │ │ │ │ │ +00012530: 2074 6861 7420 6172 6520 6f74 6865 7277 that are otherw │ │ │ │ │ +00012540: 6973 6520 6e6f 7420 706f 7373 6962 6c65 ise not possible │ │ │ │ │ +00012550: 2e20 2046 6f72 2065 7861 6d70 6c65 2c0a . For example,. │ │ │ │ │ +00012560: 7468 6573 6520 696e 636c 7564 6520 636f these include co │ │ │ │ │ +00012570: 6d6d 616e 6473 2074 6f20 6a75 6d70 206f mmands to jump o │ │ │ │ │ +00012580: 7574 206f 6620 6120 6c6f 6f70 2077 6974 ut of a loop wit │ │ │ │ │ +00012590: 686f 7574 2066 756c 6c79 2063 6f6d 706c hout fully compl │ │ │ │ │ +000125a0: 6574 696e 670a 6974 2c20 6574 632e 0a0a eting.it, etc... │ │ │ │ │ +000125b0: 6272 6561 6b20 5b27 6e27 5d0a 2020 2020 break ['n']. │ │ │ │ │ +000125c0: 2045 7869 7420 6672 6f6d 2077 6974 6869 Exit from withi │ │ │ │ │ +000125d0: 6e20 6120 2766 6f72 272c 2027 7768 696c n a 'for', 'whil │ │ │ │ │ +000125e0: 6527 2c20 6f72 2027 756e 7469 6c27 206c e', or 'until' l │ │ │ │ │ +000125f0: 6f6f 702e 2020 4966 2027 6e27 2069 730a oop. If 'n' is. │ │ │ │ │ +00012600: 2020 2020 2073 7065 6369 6669 6564 2c20 specified, │ │ │ │ │ +00012610: 6272 6561 6b20 276e 2720 6c65 7665 6c73 break 'n' levels │ │ │ │ │ +00012620: 2e20 2027 6e27 206d 7573 7420 6265 2067 . 'n' must be g │ │ │ │ │ +00012630: 7265 6174 6572 2074 6861 6e20 6f72 2065 reater than or e │ │ │ │ │ +00012640: 7175 616c 2074 6f0a 2020 2020 2031 2e20 qual to. 1. │ │ │ │ │ +00012650: 2049 6620 276e 2720 6973 2067 7265 6174 If 'n' is great │ │ │ │ │ +00012660: 6572 2074 6861 6e20 7468 6520 6e75 6d62 er than the numb │ │ │ │ │ +00012670: 6572 206f 6620 656e 636c 6f73 696e 6720 er of enclosing │ │ │ │ │ +00012680: 6c6f 6f70 732c 2061 6c6c 0a20 2020 2020 loops, all. │ │ │ │ │ +00012690: 656e 636c 6f73 696e 6720 6c6f 6f70 7320 enclosing loops │ │ │ │ │ +000126a0: 6172 6520 6578 6974 6564 2e20 2054 6865 are exited. The │ │ │ │ │ +000126b0: 2072 6574 7572 6e20 7661 6c75 6520 6973 return value is │ │ │ │ │ +000126c0: 2030 2075 6e6c 6573 7320 276e 2720 6973 0 unless 'n' is │ │ │ │ │ +000126d0: 0a20 2020 2020 6e6f 7420 6772 6561 7465 . not greate │ │ │ │ │ +000126e0: 7220 7468 616e 206f 7220 6571 7561 6c20 r than or equal │ │ │ │ │ +000126f0: 746f 2031 2e0a 0a63 6f6e 7469 6e75 6520 to 1...continue │ │ │ │ │ +00012700: 5b27 6e27 5d0a 2020 2020 2052 6573 756d ['n']. Resum │ │ │ │ │ +00012710: 6520 7468 6520 6e65 7874 2069 7465 7261 e the next itera │ │ │ │ │ +00012720: 7469 6f6e 206f 6620 7468 6520 656e 636c tion of the encl │ │ │ │ │ +00012730: 6f73 696e 6720 2766 6f72 272c 2027 7768 osing 'for', 'wh │ │ │ │ │ +00012740: 696c 6527 206f 720a 2020 2020 2027 756e ile' or. 'un │ │ │ │ │ +00012750: 7469 6c27 206c 6f6f 702e 2020 4966 2027 til' loop. If ' │ │ │ │ │ +00012760: 6e27 2069 7320 7370 6563 6966 6965 642c n' is specified, │ │ │ │ │ +00012770: 2072 6573 756d 6520 6174 2074 6865 2027 resume at the ' │ │ │ │ │ +00012780: 6e27 7468 2065 6e63 6c6f 7369 6e67 0a20 n'th enclosing. │ │ │ │ │ +00012790: 2020 2020 6c6f 6f70 2e20 2027 6e27 206d loop. 'n' m │ │ │ │ │ +000127a0: 7573 7420 6265 2067 7265 6174 6572 2074 ust be greater t │ │ │ │ │ +000127b0: 6861 6e20 6f72 2065 7175 616c 2074 6f20 han or equal to │ │ │ │ │ +000127c0: 312e 2020 4966 2027 6e27 2069 7320 6772 1. If 'n' is gr │ │ │ │ │ +000127d0: 6561 7465 720a 2020 2020 2074 6861 6e20 eater. than │ │ │ │ │ +000127e0: 7468 6520 6e75 6d62 6572 206f 6620 656e the number of en │ │ │ │ │ +000127f0: 636c 6f73 696e 6720 6c6f 6f70 732c 2074 closing loops, t │ │ │ │ │ +00012800: 6865 206c 6173 7420 656e 636c 6f73 696e he last enclosin │ │ │ │ │ +00012810: 6720 6c6f 6f70 2028 7468 650a 2020 2020 g loop (the. │ │ │ │ │ +00012820: 2022 746f 702d 6c65 7665 6c22 206c 6f6f "top-level" loo │ │ │ │ │ +00012830: 7029 2069 7320 7265 7375 6d65 642e 2020 p) is resumed. │ │ │ │ │ +00012840: 5468 6520 7265 7475 726e 2076 616c 7565 The return value │ │ │ │ │ +00012850: 2069 7320 3020 756e 6c65 7373 2027 6e27 is 0 unless 'n' │ │ │ │ │ +00012860: 2069 730a 2020 2020 206e 6f74 2067 7265 is. not gre │ │ │ │ │ +00012870: 6174 6572 2074 6861 6e20 6f72 2065 7175 ater than or equ │ │ │ │ │ +00012880: 616c 2074 6f20 312e 0a0a 7265 7475 726e al to 1...return │ │ │ │ │ +00012890: 205b 276e 275d 0a20 2020 2020 4361 7573 ['n']. Caus │ │ │ │ │ +000128a0: 6573 2061 2066 756e 6374 696f 6e20 746f es a function to │ │ │ │ │ +000128b0: 2065 7869 7420 7769 7468 2074 6865 2072 exit with the r │ │ │ │ │ +000128c0: 6574 7572 6e20 7661 6c75 6520 7370 6563 eturn value spec │ │ │ │ │ +000128d0: 6966 6965 6420 6279 2027 6e27 2e0a 2020 ified by 'n'.. │ │ │ │ │ +000128e0: 2020 2049 6620 276e 2720 6973 206f 6d69 If 'n' is omi │ │ │ │ │ +000128f0: 7474 6564 2c20 7468 6520 7265 7475 726e tted, the return │ │ │ │ │ +00012900: 2073 7461 7475 7320 6973 2074 6861 7420 status is that │ │ │ │ │ +00012910: 6f66 2074 6865 206c 6173 7420 636f 6d6d of the last comm │ │ │ │ │ +00012920: 616e 640a 2020 2020 2065 7865 6375 7465 and. execute │ │ │ │ │ +00012930: 6420 696e 2074 6865 2066 756e 6374 696f d in the functio │ │ │ │ │ +00012940: 6e20 626f 6479 2e20 2049 6620 7573 6564 n body. If used │ │ │ │ │ +00012950: 206f 7574 7369 6465 2061 2066 756e 6374 outside a funct │ │ │ │ │ +00012960: 696f 6e20 7468 650a 2020 2020 2072 6574 ion the. ret │ │ │ │ │ +00012970: 7572 6e20 7374 6174 7573 2069 7320 6661 urn status is fa │ │ │ │ │ +00012980: 6c73 652e 0a0a 7365 7470 6172 616d 7320 lse...setparams │ │ │ │ │ +00012990: 5b27 6172 6727 5d20 2e2e 2e0a 2020 2020 ['arg'] .... │ │ │ │ │ +000129a0: 2052 6570 6c61 6365 2070 6f73 6974 696f Replace positio │ │ │ │ │ +000129b0: 6e61 6c20 7061 7261 6d65 7465 7273 2073 nal parameters s │ │ │ │ │ +000129c0: 7461 7274 696e 6720 7769 7468 2027 2431 tarting with '$1 │ │ │ │ │ +000129d0: 2720 7769 7468 2061 7267 756d 656e 7473 ' with arguments │ │ │ │ │ +000129e0: 2074 6f0a 2020 2020 2027 7365 7470 6172 to. 'setpar │ │ │ │ │ +000129f0: 616d 7327 2e0a 0a73 6869 6674 205b 276e ams'...shift ['n │ │ │ │ │ +00012a00: 275d 0a20 2020 2020 5468 6520 706f 7369 ']. The posi │ │ │ │ │ +00012a10: 7469 6f6e 616c 2070 6172 616d 6574 6572 tional parameter │ │ │ │ │ +00012a20: 7320 6672 6f6d 2027 6e27 2b31 202e 2e2e s from 'n'+1 ... │ │ │ │ │ +00012a30: 2061 7265 2072 656e 616d 6564 2074 6f20 are renamed to │ │ │ │ │ +00012a40: 2724 3127 2e2e 2e2e 0a20 2020 2020 5061 '$1'..... Pa │ │ │ │ │ +00012a50: 7261 6d65 7465 7273 2072 6570 7265 7365 rameters represe │ │ │ │ │ +00012a60: 6e74 6564 2062 7920 7468 6520 6e75 6d62 nted by the numb │ │ │ │ │ +00012a70: 6572 7320 2724 2327 2064 6f77 6e20 746f ers '$#' down to │ │ │ │ │ +00012a80: 2027 2423 272d 276e 272b 3120 6172 650a '$#'-'n'+1 are. │ │ │ │ │ +00012a90: 2020 2020 2075 6e73 6574 2e20 2027 6e27 unset. 'n' │ │ │ │ │ +00012aa0: 206d 7573 7420 6265 2061 206e 6f6e 2d6e must be a non-n │ │ │ │ │ +00012ab0: 6567 6174 6976 6520 6e75 6d62 6572 206c egative number l │ │ │ │ │ +00012ac0: 6573 7320 7468 616e 206f 7220 6571 7561 ess than or equa │ │ │ │ │ +00012ad0: 6c20 746f 0a20 2020 2020 2724 2327 2e20 l to. '$#'. │ │ │ │ │ +00012ae0: 2049 6620 276e 2720 6973 2030 2c20 6e6f If 'n' is 0, no │ │ │ │ │ +00012af0: 2070 6172 616d 6574 6572 7320 6172 6520 parameters are │ │ │ │ │ +00012b00: 6368 616e 6765 642e 2020 4966 2027 6e27 changed. If 'n' │ │ │ │ │ +00012b10: 2069 7320 6e6f 740a 2020 2020 2067 6976 is not. giv │ │ │ │ │ +00012b20: 656e 2c20 6974 2069 7320 6173 7375 6d65 en, it is assume │ │ │ │ │ +00012b30: 6420 746f 2062 6520 312e 2020 4966 2027 d to be 1. If ' │ │ │ │ │ +00012b40: 6e27 2069 7320 6772 6561 7465 7220 7468 n' is greater th │ │ │ │ │ +00012b50: 616e 2027 2423 272c 2074 6865 0a20 2020 an '$#', the. │ │ │ │ │ +00012b60: 2020 706f 7369 7469 6f6e 616c 2070 6172 positional par │ │ │ │ │ +00012b70: 616d 6574 6572 7320 6172 6520 6e6f 7420 ameters are not │ │ │ │ │ +00012b80: 6368 616e 6765 642e 2020 5468 6520 7265 changed. The re │ │ │ │ │ +00012b90: 7475 726e 2073 7461 7475 7320 6973 0a20 turn status is. │ │ │ │ │ +00012ba0: 2020 2020 6772 6561 7465 7220 7468 616e greater than │ │ │ │ │ +00012bb0: 207a 6572 6f20 6966 2027 6e27 2069 7320 zero if 'n' is │ │ │ │ │ +00012bc0: 6772 6561 7465 7220 7468 616e 2027 2423 greater than '$# │ │ │ │ │ +00012bd0: 2720 6f72 206c 6573 7320 7468 616e 207a ' or less than z │ │ │ │ │ +00012be0: 6572 6f3b 0a20 2020 2020 6f74 6865 7277 ero;. otherw │ │ │ │ │ +00012bf0: 6973 6520 302e 0a0a 1f0a 4669 6c65 3a20 ise 0.....File: │ │ │ │ │ +00012c00: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00012c10: 3a20 5368 656c 6c2d 6c69 6b65 2073 6372 : Shell-like scr │ │ │ │ │ +00012c20: 6970 7469 6e67 2d46 6f6f 746e 6f74 6573 ipting-Footnotes │ │ │ │ │ +00012c30: 2c20 2055 703a 2053 6865 6c6c 2d6c 696b , Up: Shell-lik │ │ │ │ │ +00012c40: 6520 7363 7269 7074 696e 670a 0a20 2020 e scripting.. │ │ │ │ │ +00012c50: 2831 2920 4375 7272 656e 746c 7920 6120 (1) Currently a │ │ │ │ │ +00012c60: 6261 636b 736c 6173 682d 6e65 776c 696e backslash-newlin │ │ │ │ │ +00012c70: 6520 7061 6972 2077 6974 6869 6e20 6120 e pair within a │ │ │ │ │ +00012c80: 7661 7269 6162 6c65 206e 616d 6520 6973 variable name is │ │ │ │ │ +00012c90: 206e 6f74 0a68 616e 646c 6564 2070 726f not.handled pro │ │ │ │ │ +00012ca0: 7065 726c 792c 2073 6f20 7573 6520 7468 perly, so use th │ │ │ │ │ +00012cb0: 6973 2066 6561 7475 7265 2077 6974 6820 is feature with │ │ │ │ │ +00012cc0: 736f 6d65 2063 6172 652e 0a0a 1f0a 4669 some care.....Fi │ │ │ │ │ +00012cd0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +00012ce0: 4e6f 6465 3a20 4d75 6c74 692d 626f 6f74 Node: Multi-boot │ │ │ │ │ +00012cf0: 206d 616e 7561 6c20 636f 6e66 6967 2c20 manual config, │ │ │ │ │ +00012d00: 204e 6578 743a 2045 6d62 6564 6465 6420 Next: Embedded │ │ │ │ │ +00012d10: 636f 6e66 6967 7572 6174 696f 6e2c 2020 configuration, │ │ │ │ │ +00012d20: 5072 6576 3a20 5368 656c 6c2d 6c69 6b65 Prev: Shell-like │ │ │ │ │ +00012d30: 2073 6372 6970 7469 6e67 2c20 2055 703a scripting, Up: │ │ │ │ │ +00012d40: 2043 6f6e 6669 6775 7261 7469 6f6e 0a0a Configuration.. │ │ │ │ │ +00012d50: 362e 3420 4d75 6c74 692d 626f 6f74 206d 6.4 Multi-boot m │ │ │ │ │ +00012d60: 616e 7561 6c20 636f 6e66 6967 0a3d 3d3d anual config.=== │ │ │ │ │ 00012d70: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00012d80: 3d3d 3d3d 3d3d 3d0a 0a43 7572 7265 6e74 =======..Current │ │ │ │ │ -00012d90: 6c79 2061 7574 6f67 656e 6572 6174 696e ly autogeneratin │ │ │ │ │ -00012da0: 6720 636f 6e66 6967 2066 696c 6573 2066 g config files f │ │ │ │ │ -00012db0: 6f72 206d 756c 7469 2d62 6f6f 7420 656e or multi-boot en │ │ │ │ │ -00012dc0: 7669 726f 6e6d 656e 7473 0a64 6570 656e vironments.depen │ │ │ │ │ -00012dd0: 6473 206f 6e20 6f73 2d70 726f 6265 7220 ds on os-prober │ │ │ │ │ -00012de0: 616e 6420 6861 7320 7365 7665 7261 6c20 and has several │ │ │ │ │ -00012df0: 7368 6f72 7463 6f6d 696e 6773 2e20 2044 shortcomings. D │ │ │ │ │ -00012e00: 7565 2074 6f20 7468 6174 2069 7420 6973 ue to that it is │ │ │ │ │ -00012e10: 0a64 6973 6162 6c65 6420 6279 2064 6566 .disabled by def │ │ │ │ │ -00012e20: 6175 6c74 2e20 2049 7420 6973 2061 6476 ault. It is adv │ │ │ │ │ -00012e30: 6973 6564 2074 6f20 7573 6520 7468 6520 ised to use the │ │ │ │ │ -00012e40: 706f 7765 7220 6f66 2047 5255 4220 7379 power of GRUB sy │ │ │ │ │ -00012e50: 6e74 6178 2061 6e64 0a64 6f20 6974 2079 ntax and.do it y │ │ │ │ │ -00012e60: 6f75 7273 656c 662e 2020 4120 706f 7373 ourself. A poss │ │ │ │ │ -00012e70: 6962 6c65 2063 6f6e 6669 6775 7261 7469 ible configurati │ │ │ │ │ -00012e80: 6f6e 2069 7320 6465 7461 696c 6564 2068 on is detailed h │ │ │ │ │ -00012e90: 6572 652c 2066 6565 6c20 6672 6565 2074 ere, feel free t │ │ │ │ │ -00012ea0: 6f0a 6164 6a75 7374 2074 6f20 796f 7572 o.adjust to your │ │ │ │ │ -00012eb0: 206e 6565 6473 2e0a 0a20 2020 4669 7273 needs... Firs │ │ │ │ │ -00012ec0: 7420 6372 6561 7465 2061 2073 6570 6172 t create a separ │ │ │ │ │ -00012ed0: 6174 6520 4752 5542 2070 6172 7469 7469 ate GRUB partiti │ │ │ │ │ -00012ee0: 6f6e 2c20 6269 6720 656e 6f75 6768 2074 on, big enough t │ │ │ │ │ -00012ef0: 6f20 686f 6c64 2047 5255 422e 2053 6f6d o hold GRUB. Som │ │ │ │ │ -00012f00: 650a 6f66 2074 6865 2066 6f6c 6c6f 7769 e.of the followi │ │ │ │ │ -00012f10: 6e67 2065 6e74 7269 6573 2073 686f 7720 ng entries show │ │ │ │ │ -00012f20: 686f 7720 746f 206c 6f61 6420 4f53 2069 how to load OS i │ │ │ │ │ -00012f30: 6e73 7461 6c6c 6572 2069 6d61 6765 7320 nstaller images │ │ │ │ │ -00012f40: 6672 6f6d 2074 6869 730a 7361 6d65 2070 from this.same p │ │ │ │ │ -00012f50: 6172 7469 7469 6f6e 2c20 666f 7220 7468 artition, for th │ │ │ │ │ -00012f60: 6174 2079 6f75 206f 6276 696f 7573 6c79 at you obviously │ │ │ │ │ -00012f70: 206e 6565 6420 746f 206d 616b 6520 7468 need to make th │ │ │ │ │ -00012f80: 6520 7061 7274 6974 696f 6e20 6c61 7267 e partition larg │ │ │ │ │ -00012f90: 650a 656e 6f75 6768 2074 6f20 686f 6c64 e.enough to hold │ │ │ │ │ -00012fa0: 2074 686f 7365 2069 6d61 6765 7320 6173 those images as │ │ │ │ │ -00012fb0: 2077 656c 6c2e 2020 4d6f 756e 7420 7468 well. Mount th │ │ │ │ │ -00012fc0: 6973 2070 6172 7469 7469 6f6e 206f 6e2f is partition on/ │ │ │ │ │ -00012fd0: 6d6e 742f 626f 6f74 0a61 6e64 2064 6973 mnt/boot.and dis │ │ │ │ │ -00012fe0: 6162 6c65 2047 5255 4220 696e 2061 6c6c able GRUB in all │ │ │ │ │ -00012ff0: 204f 5365 7320 616e 6420 6d61 6e75 616c OSes and manual │ │ │ │ │ -00013000: 6c79 2069 6e73 7461 6c6c 2073 656c 662d ly install self- │ │ │ │ │ -00013010: 636f 6d70 696c 6564 206c 6174 6573 740a compiled latest. │ │ │ │ │ -00013020: 4752 5542 2077 6974 683a 0a0a 2020 2027 GRUB with:.. ' │ │ │ │ │ -00013030: 6772 7562 2d69 6e73 7461 6c6c 202d 2d62 grub-install --b │ │ │ │ │ -00013040: 6f6f 742d 6469 7265 6374 6f72 793d 2f6d oot-directory=/m │ │ │ │ │ -00013050: 6e74 2f62 6f6f 7420 2f64 6576 2f73 6461 nt/boot /dev/sda │ │ │ │ │ -00013060: 270a 0a20 2020 496e 2061 6c6c 2074 6865 '.. In all the │ │ │ │ │ -00013070: 204f 5365 7320 696e 7374 616c 6c20 4752 OSes install GR │ │ │ │ │ -00013080: 5542 2074 6f6f 6c73 2062 7574 2064 6973 UB tools but dis │ │ │ │ │ -00013090: 6162 6c65 2069 6e73 7461 6c6c 696e 6720 able installing │ │ │ │ │ -000130a0: 4752 5542 2069 6e0a 626f 6f74 7365 6374 GRUB in.bootsect │ │ │ │ │ -000130b0: 6f72 2c20 736f 2079 6f75 276c 6c20 6861 or, so you'll ha │ │ │ │ │ -000130c0: 7665 206d 656e 752e 6c73 7420 616e 6420 ve menu.lst and │ │ │ │ │ -000130d0: 6772 7562 2e63 6667 2061 7661 696c 6162 grub.cfg availab │ │ │ │ │ -000130e0: 6c65 2066 6f72 2075 7365 2e0a 416c 736f le for use..Also │ │ │ │ │ -000130f0: 2064 6973 6162 6c65 206f 732d 7072 6f62 disable os-prob │ │ │ │ │ -00013100: 6572 2075 7365 2062 7920 7365 7474 696e er use by settin │ │ │ │ │ -00013110: 673a 0a0a 2020 2027 4752 5542 5f44 4953 g:.. 'GRUB_DIS │ │ │ │ │ -00013120: 4142 4c45 5f4f 535f 5052 4f42 4552 3d74 ABLE_OS_PROBER=t │ │ │ │ │ -00013130: 7275 6527 0a0a 2020 2069 6e20 2f65 7463 rue'.. in /etc │ │ │ │ │ -00013140: 2f64 6566 6175 6c74 2f67 7275 620a 0a20 /default/grub.. │ │ │ │ │ -00013150: 2020 5468 656e 2077 7269 7465 2061 2067 Then write a g │ │ │ │ │ -00013160: 7275 622e 6366 6720 282f 6d6e 742f 626f rub.cfg (/mnt/bo │ │ │ │ │ -00013170: 6f74 2f67 7275 622f 6772 7562 2e63 6667 ot/grub/grub.cfg │ │ │ │ │ -00013180: 293a 0a0a 0a20 2020 2020 6d65 6e75 656e ):... menuen │ │ │ │ │ -00013190: 7472 7920 224f 5320 7573 696e 6720 6772 try "OS using gr │ │ │ │ │ -000131a0: 7562 3222 207b 0a20 2020 2020 2020 2069 ub2" {. i │ │ │ │ │ -000131b0: 6e73 6d6f 6420 7866 730a 2020 2020 2020 nsmod xfs. │ │ │ │ │ -000131c0: 2020 7365 6172 6368 202d 2d73 6574 3d72 search --set=r │ │ │ │ │ -000131d0: 6f6f 7420 2d2d 6c61 6265 6c20 4f53 3120 oot --label OS1 │ │ │ │ │ -000131e0: 2d2d 6869 6e74 2068 6430 2c6d 7364 6f73 --hint hd0,msdos │ │ │ │ │ -000131f0: 380a 2020 2020 2020 2020 636f 6e66 6967 8. config │ │ │ │ │ -00013200: 6669 6c65 202f 626f 6f74 2f67 7275 622f file /boot/grub/ │ │ │ │ │ -00013210: 6772 7562 2e63 6667 0a20 2020 2020 7d0a grub.cfg. }. │ │ │ │ │ -00013220: 0a20 2020 2020 6d65 6e75 656e 7472 7920 . menuentry │ │ │ │ │ -00013230: 224f 5320 7573 696e 6720 6772 7562 322d "OS using grub2- │ │ │ │ │ -00013240: 6c65 6761 6379 2220 7b0a 2020 2020 2020 legacy" {. │ │ │ │ │ -00013250: 2020 696e 736d 6f64 2065 7874 320a 2020 insmod ext2. │ │ │ │ │ -00013260: 2020 2020 2020 7365 6172 6368 202d 2d73 search --s │ │ │ │ │ -00013270: 6574 3d72 6f6f 7420 2d2d 6c61 6265 6c20 et=root --label │ │ │ │ │ -00013280: 4f53 3220 2d2d 6869 6e74 2068 6430 2c6d OS2 --hint hd0,m │ │ │ │ │ -00013290: 7364 6f73 360a 2020 2020 2020 2020 6c65 sdos6. le │ │ │ │ │ -000132a0: 6761 6379 5f63 6f6e 6669 6766 696c 6520 gacy_configfile │ │ │ │ │ -000132b0: 2f62 6f6f 742f 6772 7562 2f6d 656e 752e /boot/grub/menu. │ │ │ │ │ -000132c0: 6c73 740a 2020 2020 207d 0a0a 2020 2020 lst. }.. │ │ │ │ │ -000132d0: 206d 656e 7565 6e74 7279 2022 5769 6e64 menuentry "Wind │ │ │ │ │ -000132e0: 6f77 7320 5850 2220 7b0a 2020 2020 2020 ows XP" {. │ │ │ │ │ -000132f0: 2020 696e 736d 6f64 206e 7466 730a 2020 insmod ntfs. │ │ │ │ │ -00013300: 2020 2020 2020 7365 6172 6368 202d 2d73 search --s │ │ │ │ │ -00013310: 6574 3d72 6f6f 7420 2d2d 6c61 6265 6c20 et=root --label │ │ │ │ │ -00013320: 5749 4e44 4f57 535f 5850 202d 2d68 696e WINDOWS_XP --hin │ │ │ │ │ -00013330: 7420 6864 302c 6d73 646f 7331 0a20 2020 t hd0,msdos1. │ │ │ │ │ -00013340: 2020 2020 206e 746c 6472 202f 6e74 6c64 ntldr /ntld │ │ │ │ │ -00013350: 720a 2020 2020 207d 0a0a 2020 2020 206d r. }.. m │ │ │ │ │ -00013360: 656e 7565 6e74 7279 2022 5769 6e64 6f77 enuentry "Window │ │ │ │ │ -00013370: 7320 3722 207b 0a20 2020 2020 2020 2069 s 7" {. i │ │ │ │ │ -00013380: 6e73 6d6f 6420 6e74 6673 0a20 2020 2020 nsmod ntfs. │ │ │ │ │ -00013390: 2020 2073 6561 7263 6820 2d2d 7365 743d search --set= │ │ │ │ │ -000133a0: 726f 6f74 202d 2d6c 6162 656c 2057 494e root --label WIN │ │ │ │ │ -000133b0: 444f 5753 5f37 202d 2d68 696e 7420 6864 DOWS_7 --hint hd │ │ │ │ │ -000133c0: 302c 6d73 646f 7332 0a20 2020 2020 2020 0,msdos2. │ │ │ │ │ -000133d0: 206e 746c 6472 202f 626f 6f74 6d67 720a ntldr /bootmgr. │ │ │ │ │ -000133e0: 2020 2020 207d 0a0a 2020 2020 206d 656e }.. men │ │ │ │ │ -000133f0: 7565 6e74 7279 2022 4672 6565 4253 4422 uentry "FreeBSD" │ │ │ │ │ -00013400: 207b 0a20 2020 2020 2020 2020 2020 2020 {. │ │ │ │ │ -00013410: 2020 696e 736d 6f64 207a 6673 0a20 2020 insmod zfs. │ │ │ │ │ -00013420: 2020 2020 2020 2020 2020 2020 7365 6172 sear │ │ │ │ │ -00013430: 6368 202d 2d73 6574 3d72 6f6f 7420 2d2d ch --set=root -- │ │ │ │ │ -00013440: 6c61 6265 6c20 6672 6565 706f 6f6c 202d label freepool - │ │ │ │ │ -00013450: 2d68 696e 7420 6864 302c 6d73 646f 7337 -hint hd0,msdos7 │ │ │ │ │ -00013460: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00013470: 6b66 7265 6562 7364 202f 6672 6565 6273 kfreebsd /freebs │ │ │ │ │ -00013480: 6440 2f62 6f6f 742f 6b65 726e 656c 2f6b d@/boot/kernel/k │ │ │ │ │ -00013490: 6572 6e65 6c0a 2020 2020 2020 2020 2020 ernel. │ │ │ │ │ -000134a0: 2020 2020 206b 6672 6565 6273 645f 6d6f kfreebsd_mo │ │ │ │ │ -000134b0: 6475 6c65 5f65 6c66 202f 6672 6565 6273 dule_elf /freebs │ │ │ │ │ -000134c0: 6440 2f62 6f6f 742f 6b65 726e 656c 2f6f d@/boot/kernel/o │ │ │ │ │ -000134d0: 7065 6e73 6f6c 6172 6973 2e6b 6f0a 2020 pensolaris.ko. │ │ │ │ │ -000134e0: 2020 2020 2020 2020 2020 2020 206b 6672 kfr │ │ │ │ │ -000134f0: 6565 6273 645f 6d6f 6475 6c65 5f65 6c66 eebsd_module_elf │ │ │ │ │ -00013500: 202f 6672 6565 6273 6440 2f62 6f6f 742f /freebsd@/boot/ │ │ │ │ │ -00013510: 6b65 726e 656c 2f7a 6673 2e6b 6f0a 2020 kernel/zfs.ko. │ │ │ │ │ -00013520: 2020 2020 2020 2020 2020 2020 206b 6672 kfr │ │ │ │ │ -00013530: 6565 6273 645f 6d6f 6475 6c65 202f 6672 eebsd_module /fr │ │ │ │ │ -00013540: 6565 6273 6440 2f62 6f6f 742f 7a66 732f eebsd@/boot/zfs/ │ │ │ │ │ -00013550: 7a70 6f6f 6c2e 6361 6368 6520 7479 7065 zpool.cache type │ │ │ │ │ -00013560: 3d2f 626f 6f74 2f7a 6673 2f7a 706f 6f6c =/boot/zfs/zpool │ │ │ │ │ -00013570: 2e63 6163 6865 0a20 2020 2020 2020 2020 .cache. │ │ │ │ │ -00013580: 2020 2020 2020 7365 7420 6b46 7265 6542 set kFreeB │ │ │ │ │ -00013590: 5344 2e76 6673 2e72 6f6f 742e 6d6f 756e SD.vfs.root.moun │ │ │ │ │ -000135a0: 7466 726f 6d3d 7a66 733a 6672 6565 706f tfrom=zfs:freepo │ │ │ │ │ -000135b0: 6f6c 2f66 7265 6562 7364 0a20 2020 2020 ol/freebsd. │ │ │ │ │ -000135c0: 2020 2020 2020 2020 2020 7365 7420 6b46 set kF │ │ │ │ │ -000135d0: 7265 6542 5344 2e68 772e 7073 6d2e 7379 reeBSD.hw.psm.sy │ │ │ │ │ -000135e0: 6e61 7074 6963 735f 7375 7070 6f72 743d naptics_support= │ │ │ │ │ -000135f0: 310a 2020 2020 207d 0a0a 2020 2020 206d 1. }.. m │ │ │ │ │ -00013600: 656e 7565 6e74 7279 2022 6578 7065 7269 enuentry "experi │ │ │ │ │ -00013610: 6d65 6e74 616c 2047 5255 4222 207b 0a20 mental GRUB" {. │ │ │ │ │ -00013620: 2020 2020 2020 2020 2020 2020 2020 7365 se │ │ │ │ │ -00013630: 6172 6368 202d 2d73 6574 3d72 6f6f 7420 arch --set=root │ │ │ │ │ -00013640: 2d2d 6c61 6265 6c20 4752 5542 202d 2d68 --label GRUB --h │ │ │ │ │ -00013650: 696e 7420 6864 302c 6d73 646f 7335 0a20 int hd0,msdos5. │ │ │ │ │ -00013660: 2020 2020 2020 2020 2020 2020 2020 6d75 mu │ │ │ │ │ -00013670: 6c74 6962 6f6f 7420 2f65 7870 6572 696d ltiboot /experim │ │ │ │ │ -00013680: 656e 7461 6c2f 6772 7562 2f69 3338 362d ental/grub/i386- │ │ │ │ │ -00013690: 7063 2f63 6f72 652e 696d 670a 2020 2020 pc/core.img. │ │ │ │ │ -000136a0: 207d 0a0a 2020 2020 206d 656e 7565 6e74 }.. menuent │ │ │ │ │ -000136b0: 7279 2022 4665 646f 7261 2031 3620 696e ry "Fedora 16 in │ │ │ │ │ -000136c0: 7374 616c 6c65 7222 207b 0a20 2020 2020 staller" {. │ │ │ │ │ -000136d0: 2020 2020 2020 2020 2020 7365 6172 6368 search │ │ │ │ │ -000136e0: 202d 2d73 6574 3d72 6f6f 7420 2d2d 6c61 --set=root --la │ │ │ │ │ -000136f0: 6265 6c20 4752 5542 202d 2d68 696e 7420 bel GRUB --hint │ │ │ │ │ -00013700: 6864 302c 6d73 646f 7335 0a20 2020 2020 hd0,msdos5. │ │ │ │ │ -00013710: 2020 2020 2020 2020 2020 6c69 6e75 7820 linux │ │ │ │ │ -00013720: 2f66 6564 6f72 612f 766d 6c69 6e75 7a20 /fedora/vmlinuz │ │ │ │ │ -00013730: 6c61 6e67 3d65 6e5f 5553 206b 6579 6d61 lang=en_US keyma │ │ │ │ │ -00013740: 703d 7367 2072 6573 6f6c 7574 696f 6e3d p=sg resolution= │ │ │ │ │ -00013750: 3132 3830 7838 3030 0a20 2020 2020 2020 1280x800. │ │ │ │ │ -00013760: 2020 2020 2020 2020 696e 6974 7264 202f initrd / │ │ │ │ │ -00013770: 6665 646f 7261 2f69 6e69 7472 642e 696d fedora/initrd.im │ │ │ │ │ -00013780: 670a 2020 2020 207d 0a0a 2020 2020 206d g. }.. m │ │ │ │ │ -00013790: 656e 7565 6e74 7279 2022 4665 646f 7261 enuentry "Fedora │ │ │ │ │ -000137a0: 2072 6177 6869 6465 2069 6e73 7461 6c6c rawhide install │ │ │ │ │ -000137b0: 6572 2220 7b0a 2020 2020 2020 2020 2020 er" {. │ │ │ │ │ -000137c0: 2020 2020 2073 6561 7263 6820 2d2d 7365 search --se │ │ │ │ │ -000137d0: 743d 726f 6f74 202d 2d6c 6162 656c 2047 t=root --label G │ │ │ │ │ -000137e0: 5255 4220 2d2d 6869 6e74 2068 6430 2c6d RUB --hint hd0,m │ │ │ │ │ -000137f0: 7364 6f73 350a 2020 2020 2020 2020 2020 sdos5. │ │ │ │ │ -00013800: 2020 2020 206c 696e 7578 202f 6665 646f linux /fedo │ │ │ │ │ -00013810: 7261 2f76 6d6c 696e 757a 2072 6570 6f3d ra/vmlinuz repo= │ │ │ │ │ -00013820: 6674 703a 2f2f 6d69 7272 6f72 2e73 7769 ftp://mirror.swi │ │ │ │ │ -00013830: 7463 682e 6368 2f6d 6972 726f 722f 6665 tch.ch/mirror/fe │ │ │ │ │ -00013840: 646f 7261 2f6c 696e 7578 2f64 6576 656c dora/linux/devel │ │ │ │ │ -00013850: 6f70 6d65 6e74 2f72 6177 6869 6465 2f78 opment/rawhide/x │ │ │ │ │ -00013860: 3836 5f36 3420 6c61 6e67 3d65 6e5f 5553 86_64 lang=en_US │ │ │ │ │ -00013870: 206b 6579 6d61 703d 7367 2072 6573 6f6c keymap=sg resol │ │ │ │ │ -00013880: 7574 696f 6e3d 3132 3830 7838 3030 0a20 ution=1280x800. │ │ │ │ │ -00013890: 2020 2020 2020 2020 2020 2020 2020 696e in │ │ │ │ │ -000138a0: 6974 7264 202f 6665 646f 7261 2f69 6e69 itrd /fedora/ini │ │ │ │ │ -000138b0: 7472 642e 696d 670a 2020 2020 207d 0a0a trd.img. }.. │ │ │ │ │ -000138c0: 2020 2020 206d 656e 7565 6e74 7279 2022 menuentry " │ │ │ │ │ -000138d0: 4465 6269 616e 2073 6964 2069 6e73 7461 Debian sid insta │ │ │ │ │ -000138e0: 6c6c 6572 2220 7b0a 2020 2020 2020 2020 ller" {. │ │ │ │ │ -000138f0: 2020 2020 2020 2073 6561 7263 6820 2d2d search -- │ │ │ │ │ -00013900: 7365 743d 726f 6f74 202d 2d6c 6162 656c set=root --label │ │ │ │ │ -00013910: 2047 5255 4220 2d2d 6869 6e74 2068 6430 GRUB --hint hd0 │ │ │ │ │ -00013920: 2c6d 7364 6f73 350a 2020 2020 2020 2020 ,msdos5. │ │ │ │ │ -00013930: 2020 2020 2020 206c 696e 7578 202f 6465 linux /de │ │ │ │ │ -00013940: 6269 616e 2f64 6973 7473 2f73 6964 2f6d bian/dists/sid/m │ │ │ │ │ -00013950: 6169 6e2f 696e 7374 616c 6c65 722d 616d ain/installer-am │ │ │ │ │ -00013960: 6436 342f 6375 7272 656e 742f 696d 6167 d64/current/imag │ │ │ │ │ -00013970: 6573 2f68 642d 6d65 6469 612f 766d 6c69 es/hd-media/vmli │ │ │ │ │ -00013980: 6e75 7a0a 2020 2020 2020 2020 2020 2020 nuz. │ │ │ │ │ -00013990: 2020 2069 6e69 7472 6420 2f64 6562 6961 initrd /debia │ │ │ │ │ -000139a0: 6e2f 6469 7374 732f 7369 642f 6d61 696e n/dists/sid/main │ │ │ │ │ -000139b0: 2f69 6e73 7461 6c6c 6572 2d61 6d64 3634 /installer-amd64 │ │ │ │ │ -000139c0: 2f63 7572 7265 6e74 2f69 6d61 6765 732f /current/images/ │ │ │ │ │ -000139d0: 6864 2d6d 6564 6961 2f69 6e69 7472 642e hd-media/initrd. │ │ │ │ │ -000139e0: 677a 0a20 2020 2020 7d0a 0a0a 2020 204e gz. }... N │ │ │ │ │ -000139f0: 6f74 6573 3a0a 2020 202a 2041 7267 756d otes:. * Argum │ │ │ │ │ -00013a00: 656e 7420 746f 2073 6561 7263 6820 6166 ent to search af │ │ │ │ │ -00013a10: 7465 7220 2d6c 6162 656c 2069 7320 4653 ter -label is FS │ │ │ │ │ -00013a20: 204c 4142 454c 2e20 596f 7520 6361 6e20 LABEL. You can │ │ │ │ │ -00013a30: 616c 736f 2075 7365 2055 5549 4473 0a20 also use UUIDs. │ │ │ │ │ -00013a40: 2020 2020 7769 7468 202d 6673 2d75 7569 with -fs-uui │ │ │ │ │ -00013a50: 6420 5555 4944 2069 6e73 7465 6164 206f d UUID instead o │ │ │ │ │ -00013a60: 6620 2d6c 6162 656c 204c 4142 454c 2e20 f -label LABEL. │ │ │ │ │ -00013a70: 596f 7520 636f 756c 6420 616c 736f 2075 You could also u │ │ │ │ │ -00013a80: 7365 0a20 2020 2020 6469 7265 6374 2027 se. direct ' │ │ │ │ │ -00013a90: 726f 6f74 3d68 6430 2c6d 7364 6f73 5827 root=hd0,msdosX' │ │ │ │ │ -00013aa0: 2062 7574 2074 6869 7320 6973 206e 6f74 but this is not │ │ │ │ │ -00013ab0: 2072 6563 6f6d 6d65 6e64 6564 2064 7565 recommended due │ │ │ │ │ -00013ac0: 2074 6f20 6465 7669 6365 0a20 2020 2020 to device. │ │ │ │ │ -00013ad0: 6e61 6d65 2069 6e73 7461 6269 6c69 7479 name instability │ │ │ │ │ -00013ae0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00013af0: 696e 666f 2c20 204e 6f64 653a 2045 6d62 info, Node: Emb │ │ │ │ │ -00013b00: 6564 6465 6420 636f 6e66 6967 7572 6174 edded configurat │ │ │ │ │ -00013b10: 696f 6e2c 2020 5072 6576 3a20 4d75 6c74 ion, Prev: Mult │ │ │ │ │ -00013b20: 692d 626f 6f74 206d 616e 7561 6c20 636f i-boot manual co │ │ │ │ │ -00013b30: 6e66 6967 2c20 2055 703a 2043 6f6e 6669 nfig, Up: Confi │ │ │ │ │ -00013b40: 6775 7261 7469 6f6e 0a0a 362e 3520 456d guration..6.5 Em │ │ │ │ │ -00013b50: 6265 6464 696e 6720 6120 636f 6e66 6967 bedding a config │ │ │ │ │ -00013b60: 7572 6174 696f 6e20 6669 6c65 2069 6e74 uration file int │ │ │ │ │ -00013b70: 6f20 4752 5542 0a3d 3d3d 3d3d 3d3d 3d3d o GRUB.========= │ │ │ │ │ +00012d80: 3d3d 3d3d 3d3d 3d3d 3d0a 0a43 7572 7265 =========..Curre │ │ │ │ │ +00012d90: 6e74 6c79 2061 7574 6f67 656e 6572 6174 ntly autogenerat │ │ │ │ │ +00012da0: 696e 6720 636f 6e66 6967 2066 696c 6573 ing config files │ │ │ │ │ +00012db0: 2066 6f72 206d 756c 7469 2d62 6f6f 7420 for multi-boot │ │ │ │ │ +00012dc0: 656e 7669 726f 6e6d 656e 7473 0a64 6570 environments.dep │ │ │ │ │ +00012dd0: 656e 6473 206f 6e20 6f73 2d70 726f 6265 ends on os-probe │ │ │ │ │ +00012de0: 7220 616e 6420 6861 7320 7365 7665 7261 r and has severa │ │ │ │ │ +00012df0: 6c20 7368 6f72 7463 6f6d 696e 6773 2e20 l shortcomings. │ │ │ │ │ +00012e00: 2044 7565 2074 6f20 7468 6174 2069 7420 Due to that it │ │ │ │ │ +00012e10: 6973 0a64 6973 6162 6c65 6420 6279 2064 is.disabled by d │ │ │ │ │ +00012e20: 6566 6175 6c74 2e20 2049 7420 6973 2061 efault. It is a │ │ │ │ │ +00012e30: 6476 6973 6564 2074 6f20 7573 6520 7468 dvised to use th │ │ │ │ │ +00012e40: 6520 706f 7765 7220 6f66 2047 5255 4220 e power of GRUB │ │ │ │ │ +00012e50: 7379 6e74 6178 2061 6e64 0a64 6f20 6974 syntax and.do it │ │ │ │ │ +00012e60: 2079 6f75 7273 656c 662e 2020 4120 706f yourself. A po │ │ │ │ │ +00012e70: 7373 6962 6c65 2063 6f6e 6669 6775 7261 ssible configura │ │ │ │ │ +00012e80: 7469 6f6e 2069 7320 6465 7461 696c 6564 tion is detailed │ │ │ │ │ +00012e90: 2068 6572 652c 2066 6565 6c20 6672 6565 here, feel free │ │ │ │ │ +00012ea0: 2074 6f0a 6164 6a75 7374 2074 6f20 796f to.adjust to yo │ │ │ │ │ +00012eb0: 7572 206e 6565 6473 2e0a 0a20 2020 4669 ur needs... Fi │ │ │ │ │ +00012ec0: 7273 7420 6372 6561 7465 2061 2073 6570 rst create a sep │ │ │ │ │ +00012ed0: 6172 6174 6520 4752 5542 2070 6172 7469 arate GRUB parti │ │ │ │ │ +00012ee0: 7469 6f6e 2c20 6269 6720 656e 6f75 6768 tion, big enough │ │ │ │ │ +00012ef0: 2074 6f20 686f 6c64 2047 5255 422e 2053 to hold GRUB. S │ │ │ │ │ +00012f00: 6f6d 650a 6f66 2074 6865 2066 6f6c 6c6f ome.of the follo │ │ │ │ │ +00012f10: 7769 6e67 2065 6e74 7269 6573 2073 686f wing entries sho │ │ │ │ │ +00012f20: 7720 686f 7720 746f 206c 6f61 6420 4f53 w how to load OS │ │ │ │ │ +00012f30: 2069 6e73 7461 6c6c 6572 2069 6d61 6765 installer image │ │ │ │ │ +00012f40: 7320 6672 6f6d 2074 6869 730a 7361 6d65 s from this.same │ │ │ │ │ +00012f50: 2070 6172 7469 7469 6f6e 2c20 666f 7220 partition, for │ │ │ │ │ +00012f60: 7468 6174 2079 6f75 206f 6276 696f 7573 that you obvious │ │ │ │ │ +00012f70: 6c79 206e 6565 6420 746f 206d 616b 6520 ly need to make │ │ │ │ │ +00012f80: 7468 6520 7061 7274 6974 696f 6e20 6c61 the partition la │ │ │ │ │ +00012f90: 7267 650a 656e 6f75 6768 2074 6f20 686f rge.enough to ho │ │ │ │ │ +00012fa0: 6c64 2074 686f 7365 2069 6d61 6765 7320 ld those images │ │ │ │ │ +00012fb0: 6173 2077 656c 6c2e 2020 4d6f 756e 7420 as well. Mount │ │ │ │ │ +00012fc0: 7468 6973 2070 6172 7469 7469 6f6e 206f this partition o │ │ │ │ │ +00012fd0: 6e2f 6d6e 742f 626f 6f74 0a61 6e64 2064 n/mnt/boot.and d │ │ │ │ │ +00012fe0: 6973 6162 6c65 2047 5255 4220 696e 2061 isable GRUB in a │ │ │ │ │ +00012ff0: 6c6c 204f 5365 7320 616e 6420 6d61 6e75 ll OSes and manu │ │ │ │ │ +00013000: 616c 6c79 2069 6e73 7461 6c6c 2073 656c ally install sel │ │ │ │ │ +00013010: 662d 636f 6d70 696c 6564 206c 6174 6573 f-compiled lates │ │ │ │ │ +00013020: 740a 4752 5542 2077 6974 683a 0a0a 2020 t.GRUB with:.. │ │ │ │ │ +00013030: 2027 6772 7562 2d69 6e73 7461 6c6c 202d 'grub-install - │ │ │ │ │ +00013040: 2d62 6f6f 742d 6469 7265 6374 6f72 793d -boot-directory= │ │ │ │ │ +00013050: 2f6d 6e74 2f62 6f6f 7420 2f64 6576 2f73 /mnt/boot /dev/s │ │ │ │ │ +00013060: 6461 270a 0a20 2020 496e 2061 6c6c 2074 da'.. In all t │ │ │ │ │ +00013070: 6865 204f 5365 7320 696e 7374 616c 6c20 he OSes install │ │ │ │ │ +00013080: 4752 5542 2074 6f6f 6c73 2062 7574 2064 GRUB tools but d │ │ │ │ │ +00013090: 6973 6162 6c65 2069 6e73 7461 6c6c 696e isable installin │ │ │ │ │ +000130a0: 6720 4752 5542 2069 6e0a 626f 6f74 7365 g GRUB in.bootse │ │ │ │ │ +000130b0: 6374 6f72 2c20 736f 2079 6f75 276c 6c20 ctor, so you'll │ │ │ │ │ +000130c0: 6861 7665 206d 656e 752e 6c73 7420 616e have menu.lst an │ │ │ │ │ +000130d0: 6420 6772 7562 2e63 6667 2061 7661 696c d grub.cfg avail │ │ │ │ │ +000130e0: 6162 6c65 2066 6f72 2075 7365 2e0a 416c able for use..Al │ │ │ │ │ +000130f0: 736f 2064 6973 6162 6c65 206f 732d 7072 so disable os-pr │ │ │ │ │ +00013100: 6f62 6572 2075 7365 2062 7920 7365 7474 ober use by sett │ │ │ │ │ +00013110: 696e 673a 0a0a 2020 2027 4752 5542 5f44 ing:.. 'GRUB_D │ │ │ │ │ +00013120: 4953 4142 4c45 5f4f 535f 5052 4f42 4552 ISABLE_OS_PROBER │ │ │ │ │ +00013130: 3d74 7275 6527 0a0a 2020 2069 6e20 2f65 =true'.. in /e │ │ │ │ │ +00013140: 7463 2f64 6566 6175 6c74 2f67 7275 620a tc/default/grub. │ │ │ │ │ +00013150: 0a20 2020 5468 656e 2077 7269 7465 2061 . Then write a │ │ │ │ │ +00013160: 2067 7275 622e 6366 6720 282f 6d6e 742f grub.cfg (/mnt/ │ │ │ │ │ +00013170: 626f 6f74 2f67 7275 622f 6772 7562 2e63 boot/grub/grub.c │ │ │ │ │ +00013180: 6667 293a 0a0a 0a20 2020 2020 6d65 6e75 fg):... menu │ │ │ │ │ +00013190: 656e 7472 7920 224f 5320 7573 696e 6720 entry "OS using │ │ │ │ │ +000131a0: 6772 7562 3222 207b 0a20 2020 2020 2020 grub2" {. │ │ │ │ │ +000131b0: 2069 6e73 6d6f 6420 7866 730a 2020 2020 insmod xfs. │ │ │ │ │ +000131c0: 2020 2020 7365 6172 6368 202d 2d73 6574 search --set │ │ │ │ │ +000131d0: 3d72 6f6f 7420 2d2d 6c61 6265 6c20 4f53 =root --label OS │ │ │ │ │ +000131e0: 3120 2d2d 6869 6e74 2068 6430 2c6d 7364 1 --hint hd0,msd │ │ │ │ │ +000131f0: 6f73 380a 2020 2020 2020 2020 636f 6e66 os8. conf │ │ │ │ │ +00013200: 6967 6669 6c65 202f 626f 6f74 2f67 7275 igfile /boot/gru │ │ │ │ │ +00013210: 622f 6772 7562 2e63 6667 0a20 2020 2020 b/grub.cfg. │ │ │ │ │ +00013220: 7d0a 0a20 2020 2020 6d65 6e75 656e 7472 }.. menuentr │ │ │ │ │ +00013230: 7920 224f 5320 7573 696e 6720 6772 7562 y "OS using grub │ │ │ │ │ +00013240: 322d 6c65 6761 6379 2220 7b0a 2020 2020 2-legacy" {. │ │ │ │ │ +00013250: 2020 2020 696e 736d 6f64 2065 7874 320a insmod ext2. │ │ │ │ │ +00013260: 2020 2020 2020 2020 7365 6172 6368 202d search - │ │ │ │ │ +00013270: 2d73 6574 3d72 6f6f 7420 2d2d 6c61 6265 -set=root --labe │ │ │ │ │ +00013280: 6c20 4f53 3220 2d2d 6869 6e74 2068 6430 l OS2 --hint hd0 │ │ │ │ │ +00013290: 2c6d 7364 6f73 360a 2020 2020 2020 2020 ,msdos6. │ │ │ │ │ +000132a0: 6c65 6761 6379 5f63 6f6e 6669 6766 696c legacy_configfil │ │ │ │ │ +000132b0: 6520 2f62 6f6f 742f 6772 7562 2f6d 656e e /boot/grub/men │ │ │ │ │ +000132c0: 752e 6c73 740a 2020 2020 207d 0a0a 2020 u.lst. }.. │ │ │ │ │ +000132d0: 2020 206d 656e 7565 6e74 7279 2022 5769 menuentry "Wi │ │ │ │ │ +000132e0: 6e64 6f77 7320 5850 2220 7b0a 2020 2020 ndows XP" {. │ │ │ │ │ +000132f0: 2020 2020 696e 736d 6f64 206e 7466 730a insmod ntfs. │ │ │ │ │ +00013300: 2020 2020 2020 2020 7365 6172 6368 202d search - │ │ │ │ │ +00013310: 2d73 6574 3d72 6f6f 7420 2d2d 6c61 6265 -set=root --labe │ │ │ │ │ +00013320: 6c20 5749 4e44 4f57 535f 5850 202d 2d68 l WINDOWS_XP --h │ │ │ │ │ +00013330: 696e 7420 6864 302c 6d73 646f 7331 0a20 int hd0,msdos1. │ │ │ │ │ +00013340: 2020 2020 2020 206e 746c 6472 202f 6e74 ntldr /nt │ │ │ │ │ +00013350: 6c64 720a 2020 2020 207d 0a0a 2020 2020 ldr. }.. │ │ │ │ │ +00013360: 206d 656e 7565 6e74 7279 2022 5769 6e64 menuentry "Wind │ │ │ │ │ +00013370: 6f77 7320 3722 207b 0a20 2020 2020 2020 ows 7" {. │ │ │ │ │ +00013380: 2069 6e73 6d6f 6420 6e74 6673 0a20 2020 insmod ntfs. │ │ │ │ │ +00013390: 2020 2020 2073 6561 7263 6820 2d2d 7365 search --se │ │ │ │ │ +000133a0: 743d 726f 6f74 202d 2d6c 6162 656c 2057 t=root --label W │ │ │ │ │ +000133b0: 494e 444f 5753 5f37 202d 2d68 696e 7420 INDOWS_7 --hint │ │ │ │ │ +000133c0: 6864 302c 6d73 646f 7332 0a20 2020 2020 hd0,msdos2. │ │ │ │ │ +000133d0: 2020 206e 746c 6472 202f 626f 6f74 6d67 ntldr /bootmg │ │ │ │ │ +000133e0: 720a 2020 2020 207d 0a0a 2020 2020 206d r. }.. m │ │ │ │ │ +000133f0: 656e 7565 6e74 7279 2022 4672 6565 4253 enuentry "FreeBS │ │ │ │ │ +00013400: 4422 207b 0a20 2020 2020 2020 2020 2020 D" {. │ │ │ │ │ +00013410: 2020 2020 696e 736d 6f64 207a 6673 0a20 insmod zfs. │ │ │ │ │ +00013420: 2020 2020 2020 2020 2020 2020 2020 7365 se │ │ │ │ │ +00013430: 6172 6368 202d 2d73 6574 3d72 6f6f 7420 arch --set=root │ │ │ │ │ +00013440: 2d2d 6c61 6265 6c20 6672 6565 706f 6f6c --label freepool │ │ │ │ │ +00013450: 202d 2d68 696e 7420 6864 302c 6d73 646f --hint hd0,msdo │ │ │ │ │ +00013460: 7337 0a20 2020 2020 2020 2020 2020 2020 s7. │ │ │ │ │ +00013470: 2020 6b66 7265 6562 7364 202f 6672 6565 kfreebsd /free │ │ │ │ │ +00013480: 6273 6440 2f62 6f6f 742f 6b65 726e 656c bsd@/boot/kernel │ │ │ │ │ +00013490: 2f6b 6572 6e65 6c0a 2020 2020 2020 2020 /kernel. │ │ │ │ │ +000134a0: 2020 2020 2020 206b 6672 6565 6273 645f kfreebsd_ │ │ │ │ │ +000134b0: 6d6f 6475 6c65 5f65 6c66 202f 6672 6565 module_elf /free │ │ │ │ │ +000134c0: 6273 6440 2f62 6f6f 742f 6b65 726e 656c bsd@/boot/kernel │ │ │ │ │ +000134d0: 2f6f 7065 6e73 6f6c 6172 6973 2e6b 6f0a /opensolaris.ko. │ │ │ │ │ +000134e0: 2020 2020 2020 2020 2020 2020 2020 206b k │ │ │ │ │ +000134f0: 6672 6565 6273 645f 6d6f 6475 6c65 5f65 freebsd_module_e │ │ │ │ │ +00013500: 6c66 202f 6672 6565 6273 6440 2f62 6f6f lf /freebsd@/boo │ │ │ │ │ +00013510: 742f 6b65 726e 656c 2f7a 6673 2e6b 6f0a t/kernel/zfs.ko. │ │ │ │ │ +00013520: 2020 2020 2020 2020 2020 2020 2020 206b k │ │ │ │ │ +00013530: 6672 6565 6273 645f 6d6f 6475 6c65 202f freebsd_module / │ │ │ │ │ +00013540: 6672 6565 6273 6440 2f62 6f6f 742f 7a66 freebsd@/boot/zf │ │ │ │ │ +00013550: 732f 7a70 6f6f 6c2e 6361 6368 6520 7479 s/zpool.cache ty │ │ │ │ │ +00013560: 7065 3d2f 626f 6f74 2f7a 6673 2f7a 706f pe=/boot/zfs/zpo │ │ │ │ │ +00013570: 6f6c 2e63 6163 6865 0a20 2020 2020 2020 ol.cache. │ │ │ │ │ +00013580: 2020 2020 2020 2020 7365 7420 6b46 7265 set kFre │ │ │ │ │ +00013590: 6542 5344 2e76 6673 2e72 6f6f 742e 6d6f eBSD.vfs.root.mo │ │ │ │ │ +000135a0: 756e 7466 726f 6d3d 7a66 733a 6672 6565 untfrom=zfs:free │ │ │ │ │ +000135b0: 706f 6f6c 2f66 7265 6562 7364 0a20 2020 pool/freebsd. │ │ │ │ │ +000135c0: 2020 2020 2020 2020 2020 2020 7365 7420 set │ │ │ │ │ +000135d0: 6b46 7265 6542 5344 2e68 772e 7073 6d2e kFreeBSD.hw.psm. │ │ │ │ │ +000135e0: 7379 6e61 7074 6963 735f 7375 7070 6f72 synaptics_suppor │ │ │ │ │ +000135f0: 743d 310a 2020 2020 207d 0a0a 2020 2020 t=1. }.. │ │ │ │ │ +00013600: 206d 656e 7565 6e74 7279 2022 6578 7065 menuentry "expe │ │ │ │ │ +00013610: 7269 6d65 6e74 616c 2047 5255 4222 207b rimental GRUB" { │ │ │ │ │ +00013620: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00013630: 7365 6172 6368 202d 2d73 6574 3d72 6f6f search --set=roo │ │ │ │ │ +00013640: 7420 2d2d 6c61 6265 6c20 4752 5542 202d t --label GRUB - │ │ │ │ │ +00013650: 2d68 696e 7420 6864 302c 6d73 646f 7335 -hint hd0,msdos5 │ │ │ │ │ +00013660: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00013670: 6d75 6c74 6962 6f6f 7420 2f65 7870 6572 multiboot /exper │ │ │ │ │ +00013680: 696d 656e 7461 6c2f 6772 7562 2f69 3338 imental/grub/i38 │ │ │ │ │ +00013690: 362d 7063 2f63 6f72 652e 696d 670a 2020 6-pc/core.img. │ │ │ │ │ +000136a0: 2020 207d 0a0a 2020 2020 206d 656e 7565 }.. menue │ │ │ │ │ +000136b0: 6e74 7279 2022 4665 646f 7261 2031 3620 ntry "Fedora 16 │ │ │ │ │ +000136c0: 696e 7374 616c 6c65 7222 207b 0a20 2020 installer" {. │ │ │ │ │ +000136d0: 2020 2020 2020 2020 2020 2020 7365 6172 sear │ │ │ │ │ +000136e0: 6368 202d 2d73 6574 3d72 6f6f 7420 2d2d ch --set=root -- │ │ │ │ │ +000136f0: 6c61 6265 6c20 4752 5542 202d 2d68 696e label GRUB --hin │ │ │ │ │ +00013700: 7420 6864 302c 6d73 646f 7335 0a20 2020 t hd0,msdos5. │ │ │ │ │ +00013710: 2020 2020 2020 2020 2020 2020 6c69 6e75 linu │ │ │ │ │ +00013720: 7820 2f66 6564 6f72 612f 766d 6c69 6e75 x /fedora/vmlinu │ │ │ │ │ +00013730: 7a20 6c61 6e67 3d65 6e5f 5553 206b 6579 z lang=en_US key │ │ │ │ │ +00013740: 6d61 703d 7367 2072 6573 6f6c 7574 696f map=sg resolutio │ │ │ │ │ +00013750: 6e3d 3132 3830 7838 3030 0a20 2020 2020 n=1280x800. │ │ │ │ │ +00013760: 2020 2020 2020 2020 2020 696e 6974 7264 initrd │ │ │ │ │ +00013770: 202f 6665 646f 7261 2f69 6e69 7472 642e /fedora/initrd. │ │ │ │ │ +00013780: 696d 670a 2020 2020 207d 0a0a 2020 2020 img. }.. │ │ │ │ │ +00013790: 206d 656e 7565 6e74 7279 2022 4665 646f menuentry "Fedo │ │ │ │ │ +000137a0: 7261 2072 6177 6869 6465 2069 6e73 7461 ra rawhide insta │ │ │ │ │ +000137b0: 6c6c 6572 2220 7b0a 2020 2020 2020 2020 ller" {. │ │ │ │ │ +000137c0: 2020 2020 2020 2073 6561 7263 6820 2d2d search -- │ │ │ │ │ +000137d0: 7365 743d 726f 6f74 202d 2d6c 6162 656c set=root --label │ │ │ │ │ +000137e0: 2047 5255 4220 2d2d 6869 6e74 2068 6430 GRUB --hint hd0 │ │ │ │ │ +000137f0: 2c6d 7364 6f73 350a 2020 2020 2020 2020 ,msdos5. │ │ │ │ │ +00013800: 2020 2020 2020 206c 696e 7578 202f 6665 linux /fe │ │ │ │ │ +00013810: 646f 7261 2f76 6d6c 696e 757a 2072 6570 dora/vmlinuz rep │ │ │ │ │ +00013820: 6f3d 6674 703a 2f2f 6d69 7272 6f72 2e73 o=ftp://mirror.s │ │ │ │ │ +00013830: 7769 7463 682e 6368 2f6d 6972 726f 722f witch.ch/mirror/ │ │ │ │ │ +00013840: 6665 646f 7261 2f6c 696e 7578 2f64 6576 fedora/linux/dev │ │ │ │ │ +00013850: 656c 6f70 6d65 6e74 2f72 6177 6869 6465 elopment/rawhide │ │ │ │ │ +00013860: 2f78 3836 5f36 3420 6c61 6e67 3d65 6e5f /x86_64 lang=en_ │ │ │ │ │ +00013870: 5553 206b 6579 6d61 703d 7367 2072 6573 US keymap=sg res │ │ │ │ │ +00013880: 6f6c 7574 696f 6e3d 3132 3830 7838 3030 olution=1280x800 │ │ │ │ │ +00013890: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000138a0: 696e 6974 7264 202f 6665 646f 7261 2f69 initrd /fedora/i │ │ │ │ │ +000138b0: 6e69 7472 642e 696d 670a 2020 2020 207d nitrd.img. } │ │ │ │ │ +000138c0: 0a0a 2020 2020 206d 656e 7565 6e74 7279 .. menuentry │ │ │ │ │ +000138d0: 2022 4465 6269 616e 2073 6964 2069 6e73 "Debian sid ins │ │ │ │ │ +000138e0: 7461 6c6c 6572 2220 7b0a 2020 2020 2020 taller" {. │ │ │ │ │ +000138f0: 2020 2020 2020 2020 2073 6561 7263 6820 search │ │ │ │ │ +00013900: 2d2d 7365 743d 726f 6f74 202d 2d6c 6162 --set=root --lab │ │ │ │ │ +00013910: 656c 2047 5255 4220 2d2d 6869 6e74 2068 el GRUB --hint h │ │ │ │ │ +00013920: 6430 2c6d 7364 6f73 350a 2020 2020 2020 d0,msdos5. │ │ │ │ │ +00013930: 2020 2020 2020 2020 206c 696e 7578 202f linux / │ │ │ │ │ +00013940: 6465 6269 616e 2f64 6973 7473 2f73 6964 debian/dists/sid │ │ │ │ │ +00013950: 2f6d 6169 6e2f 696e 7374 616c 6c65 722d /main/installer- │ │ │ │ │ +00013960: 616d 6436 342f 6375 7272 656e 742f 696d amd64/current/im │ │ │ │ │ +00013970: 6167 6573 2f68 642d 6d65 6469 612f 766d ages/hd-media/vm │ │ │ │ │ +00013980: 6c69 6e75 7a0a 2020 2020 2020 2020 2020 linuz. │ │ │ │ │ +00013990: 2020 2020 2069 6e69 7472 6420 2f64 6562 initrd /deb │ │ │ │ │ +000139a0: 6961 6e2f 6469 7374 732f 7369 642f 6d61 ian/dists/sid/ma │ │ │ │ │ +000139b0: 696e 2f69 6e73 7461 6c6c 6572 2d61 6d64 in/installer-amd │ │ │ │ │ +000139c0: 3634 2f63 7572 7265 6e74 2f69 6d61 6765 64/current/image │ │ │ │ │ +000139d0: 732f 6864 2d6d 6564 6961 2f69 6e69 7472 s/hd-media/initr │ │ │ │ │ +000139e0: 642e 677a 0a20 2020 2020 7d0a 0a0a 2020 d.gz. }... │ │ │ │ │ +000139f0: 204e 6f74 6573 3a0a 2020 202a 2041 7267 Notes:. * Arg │ │ │ │ │ +00013a00: 756d 656e 7420 746f 2073 6561 7263 6820 ument to search │ │ │ │ │ +00013a10: 6166 7465 7220 2d6c 6162 656c 2069 7320 after -label is │ │ │ │ │ +00013a20: 4653 204c 4142 454c 2e20 596f 7520 6361 FS LABEL. You ca │ │ │ │ │ +00013a30: 6e20 616c 736f 2075 7365 2055 5549 4473 n also use UUIDs │ │ │ │ │ +00013a40: 0a20 2020 2020 7769 7468 202d 6673 2d75 . with -fs-u │ │ │ │ │ +00013a50: 7569 6420 5555 4944 2069 6e73 7465 6164 uid UUID instead │ │ │ │ │ +00013a60: 206f 6620 2d6c 6162 656c 204c 4142 454c of -label LABEL │ │ │ │ │ +00013a70: 2e20 596f 7520 636f 756c 6420 616c 736f . You could also │ │ │ │ │ +00013a80: 2075 7365 0a20 2020 2020 6469 7265 6374 use. direct │ │ │ │ │ +00013a90: 2027 726f 6f74 3d68 6430 2c6d 7364 6f73 'root=hd0,msdos │ │ │ │ │ +00013aa0: 5827 2062 7574 2074 6869 7320 6973 206e X' but this is n │ │ │ │ │ +00013ab0: 6f74 2072 6563 6f6d 6d65 6e64 6564 2064 ot recommended d │ │ │ │ │ +00013ac0: 7565 2074 6f20 6465 7669 6365 0a20 2020 ue to device. │ │ │ │ │ +00013ad0: 2020 6e61 6d65 2069 6e73 7461 6269 6c69 name instabili │ │ │ │ │ +00013ae0: 7479 2e0a 0a1f 0a46 696c 653a 2067 7275 ty.....File: gru │ │ │ │ │ +00013af0: 622e 696e 666f 2c20 204e 6f64 653a 2045 b.info, Node: E │ │ │ │ │ +00013b00: 6d62 6564 6465 6420 636f 6e66 6967 7572 mbedded configur │ │ │ │ │ +00013b10: 6174 696f 6e2c 2020 5072 6576 3a20 4d75 ation, Prev: Mu │ │ │ │ │ +00013b20: 6c74 692d 626f 6f74 206d 616e 7561 6c20 lti-boot manual │ │ │ │ │ +00013b30: 636f 6e66 6967 2c20 2055 703a 2043 6f6e config, Up: Con │ │ │ │ │ +00013b40: 6669 6775 7261 7469 6f6e 0a0a 362e 3520 figuration..6.5 │ │ │ │ │ +00013b50: 456d 6265 6464 696e 6720 6120 636f 6e66 Embedding a conf │ │ │ │ │ +00013b60: 6967 7572 6174 696f 6e20 6669 6c65 2069 iguration file i │ │ │ │ │ +00013b70: 6e74 6f20 4752 5542 0a3d 3d3d 3d3d 3d3d nto GRUB.======= │ │ │ │ │ 00013b80: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00013b90: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00013ba0: 3d3d 3d0a 0a47 5255 4220 7375 7070 6f72 ===..GRUB suppor │ │ │ │ │ -00013bb0: 7473 2065 6d62 6564 6469 6e67 2061 2063 ts embedding a c │ │ │ │ │ -00013bc0: 6f6e 6669 6775 7261 7469 6f6e 2066 696c onfiguration fil │ │ │ │ │ -00013bd0: 6520 6469 7265 6374 6c79 2069 6e74 6f20 e directly into │ │ │ │ │ -00013be0: 7468 6520 636f 7265 0a69 6d61 6765 2c20 the core.image, │ │ │ │ │ -00013bf0: 736f 2074 6861 7420 6974 2069 7320 6c6f so that it is lo │ │ │ │ │ -00013c00: 6164 6564 2062 6566 6f72 6520 656e 7465 aded before ente │ │ │ │ │ -00013c10: 7269 6e67 206e 6f72 6d61 6c20 6d6f 6465 ring normal mode │ │ │ │ │ -00013c20: 2e20 2054 6869 7320 6973 0a75 7365 6675 . This is.usefu │ │ │ │ │ -00013c30: 6c2c 2066 6f72 2065 7861 6d70 6c65 2c20 l, for example, │ │ │ │ │ -00013c40: 7768 656e 2069 7420 6973 206e 6f74 2073 when it is not s │ │ │ │ │ -00013c50: 7472 6169 6768 7466 6f72 7761 7264 2074 traightforward t │ │ │ │ │ -00013c60: 6f20 6669 6e64 2074 6865 2072 6561 6c0a o find the real. │ │ │ │ │ -00013c70: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ -00013c80: 6c65 2c20 6f72 2077 6865 6e20 796f 7520 le, or when you │ │ │ │ │ -00013c90: 6e65 6564 2074 6f20 6465 6275 6720 7072 need to debug pr │ │ │ │ │ -00013ca0: 6f62 6c65 6d73 2077 6974 6820 6c6f 6164 oblems with load │ │ │ │ │ -00013cb0: 696e 6720 7468 6174 0a66 696c 652e 2020 ing that.file. │ │ │ │ │ -00013cc0: 2767 7275 622d 696e 7374 616c 6c27 2075 'grub-install' u │ │ │ │ │ -00013cd0: 7365 7320 7468 6973 2066 6561 7475 7265 ses this feature │ │ │ │ │ -00013ce0: 2077 6865 6e20 6974 2069 7320 6e6f 7420 when it is not │ │ │ │ │ -00013cf0: 7573 696e 6720 4249 4f53 2064 6973 6b0a using BIOS disk. │ │ │ │ │ -00013d00: 6675 6e63 7469 6f6e 7320 6f72 2077 6865 functions or whe │ │ │ │ │ -00013d10: 6e20 696e 7374 616c 6c69 6e67 2074 6f20 n installing to │ │ │ │ │ -00013d20: 6120 6469 6666 6572 656e 7420 6469 736b a different disk │ │ │ │ │ -00013d30: 2066 726f 6d20 7468 6520 6f6e 6520 636f from the one co │ │ │ │ │ -00013d40: 6e74 6169 6e69 6e67 0a27 2f62 6f6f 742f ntaining.'/boot/ │ │ │ │ │ -00013d50: 6772 7562 272c 2069 6e20 7768 6963 6820 grub', in which │ │ │ │ │ -00013d60: 6361 7365 2069 7420 6e65 6564 7320 746f case it needs to │ │ │ │ │ -00013d70: 2075 7365 2074 6865 2027 7365 6172 6368 use the 'search │ │ │ │ │ -00013d80: 2720 636f 6d6d 616e 6420 282a 6e6f 7465 ' command (*note │ │ │ │ │ -00013d90: 0a73 6561 7263 683a 3a29 2074 6f20 6669 .search::) to fi │ │ │ │ │ -00013da0: 6e64 2027 2f62 6f6f 742f 6772 7562 272e nd '/boot/grub'. │ │ │ │ │ -00013db0: 0a0a 2020 2054 6f20 656d 6265 6420 6120 .. To embed a │ │ │ │ │ -00013dc0: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ -00013dd0: 6c65 2c20 7573 6520 7468 6520 272d 6327 le, use the '-c' │ │ │ │ │ -00013de0: 206f 7074 696f 6e20 746f 2027 6772 7562 option to 'grub │ │ │ │ │ -00013df0: 2d6d 6b69 6d61 6765 272e 0a54 6865 2066 -mkimage'..The f │ │ │ │ │ -00013e00: 696c 6520 6973 2063 6f70 6965 6420 696e ile is copied in │ │ │ │ │ -00013e10: 746f 2074 6865 2063 6f72 6520 696d 6167 to the core imag │ │ │ │ │ -00013e20: 652c 2073 6f20 6974 206d 6179 2072 6573 e, so it may res │ │ │ │ │ -00013e30: 6964 6520 616e 7977 6865 7265 206f 6e20 ide anywhere on │ │ │ │ │ -00013e40: 7468 650a 6669 6c65 2073 7973 7465 6d2c the.file system, │ │ │ │ │ -00013e50: 2061 6e64 206d 6179 2062 6520 7265 6d6f and may be remo │ │ │ │ │ -00013e60: 7665 6420 6166 7465 7220 7275 6e6e 696e ved after runnin │ │ │ │ │ -00013e70: 6720 2767 7275 622d 6d6b 696d 6167 6527 g 'grub-mkimage' │ │ │ │ │ -00013e80: 2e0a 0a20 2020 4166 7465 7220 7468 6520 ... After the │ │ │ │ │ -00013e90: 656d 6265 6464 6564 2063 6f6e 6669 6775 embedded configu │ │ │ │ │ -00013ea0: 7261 7469 6f6e 2066 696c 6520 2869 6620 ration file (if │ │ │ │ │ -00013eb0: 616e 7929 2069 7320 6578 6563 7574 6564 any) is executed │ │ │ │ │ -00013ec0: 2c20 4752 5542 2077 696c 6c0a 6c6f 6164 , GRUB will.load │ │ │ │ │ -00013ed0: 2074 6865 2027 6e6f 726d 616c 2720 6d6f the 'normal' mo │ │ │ │ │ -00013ee0: 6475 6c65 2028 2a6e 6f74 6520 6e6f 726d dule (*note norm │ │ │ │ │ -00013ef0: 616c 3a3a 292c 2077 6869 6368 2077 696c al::), which wil │ │ │ │ │ -00013f00: 6c20 7468 656e 2072 6561 6420 7468 6520 l then read the │ │ │ │ │ -00013f10: 7265 616c 0a63 6f6e 6669 6775 7261 7469 real.configurati │ │ │ │ │ -00013f20: 6f6e 2066 696c 6520 6672 6f6d 2027 2470 on file from '$p │ │ │ │ │ -00013f30: 7265 6669 782f 6772 7562 2e63 6667 272e refix/grub.cfg'. │ │ │ │ │ -00013f40: 2020 4279 2074 6869 7320 706f 696e 742c By this point, │ │ │ │ │ -00013f50: 2074 6865 2027 726f 6f74 270a 7661 7269 the 'root'.vari │ │ │ │ │ -00013f60: 6162 6c65 2077 696c 6c20 616c 736f 2068 able will also h │ │ │ │ │ -00013f70: 6176 6520 6265 656e 2073 6574 2074 6f20 ave been set to │ │ │ │ │ -00013f80: 7468 6520 726f 6f74 2064 6576 6963 6520 the root device │ │ │ │ │ -00013f90: 6e61 6d65 2e20 2046 6f72 2065 7861 6d70 name. For examp │ │ │ │ │ -00013fa0: 6c65 2c0a 2770 7265 6669 7827 206d 6967 le,.'prefix' mig │ │ │ │ │ -00013fb0: 6874 2062 6520 7365 7420 746f 2027 2868 ht be set to '(h │ │ │ │ │ -00013fc0: 6430 2c31 292f 626f 6f74 2f67 7275 6227 d0,1)/boot/grub' │ │ │ │ │ -00013fd0: 2c20 616e 6420 2772 6f6f 7427 206d 6967 , and 'root' mig │ │ │ │ │ -00013fe0: 6874 2062 6520 7365 7420 746f 0a27 6864 ht be set to.'hd │ │ │ │ │ -00013ff0: 302c 3127 2e20 2054 6875 732c 2069 6e20 0,1'. Thus, in │ │ │ │ │ -00014000: 6d6f 7374 2063 6173 6573 2c20 7468 6520 most cases, the │ │ │ │ │ -00014010: 656d 6265 6464 6564 2063 6f6e 6669 6775 embedded configu │ │ │ │ │ -00014020: 7261 7469 6f6e 2066 696c 6520 6f6e 6c79 ration file only │ │ │ │ │ -00014030: 0a6e 6565 6473 2074 6f20 7365 7420 7468 .needs to set th │ │ │ │ │ -00014040: 6520 2770 7265 6669 7827 2061 6e64 2027 e 'prefix' and ' │ │ │ │ │ -00014050: 726f 6f74 2720 7661 7269 6162 6c65 732c root' variables, │ │ │ │ │ -00014060: 2061 6e64 2074 6865 6e20 6472 6f70 2074 and then drop t │ │ │ │ │ -00014070: 6872 6f75 6768 2074 6f0a 4752 5542 2773 hrough to.GRUB's │ │ │ │ │ -00014080: 206e 6f72 6d61 6c20 7072 6f63 6573 7369 normal processi │ │ │ │ │ -00014090: 6e67 2e20 2041 2074 7970 6963 616c 2065 ng. A typical e │ │ │ │ │ -000140a0: 7861 6d70 6c65 206f 6620 7468 6973 206d xample of this m │ │ │ │ │ -000140b0: 6967 6874 206c 6f6f 6b20 6c69 6b65 0a74 ight look like.t │ │ │ │ │ -000140c0: 6869 733a 0a0a 2020 2020 2073 6561 7263 his:.. searc │ │ │ │ │ -000140d0: 682e 6673 5f75 7569 6420 3031 3233 3435 h.fs_uuid 012345 │ │ │ │ │ -000140e0: 3637 2d38 3961 622d 6364 6566 2d30 3132 67-89ab-cdef-012 │ │ │ │ │ -000140f0: 332d 3435 3637 3839 6162 6364 6566 2072 3-456789abcdef r │ │ │ │ │ -00014100: 6f6f 740a 2020 2020 2073 6574 2070 7265 oot. set pre │ │ │ │ │ -00014110: 6669 783d 2824 726f 6f74 292f 626f 6f74 fix=($root)/boot │ │ │ │ │ -00014120: 2f67 7275 620a 0a20 2020 2854 6865 2027 /grub.. (The ' │ │ │ │ │ -00014130: 7365 6172 6368 5f66 735f 7575 6964 2720 search_fs_uuid' │ │ │ │ │ -00014140: 6d6f 6475 6c65 206d 7573 7420 6265 2069 module must be i │ │ │ │ │ -00014150: 6e63 6c75 6465 6420 696e 2074 6865 2063 ncluded in the c │ │ │ │ │ -00014160: 6f72 6520 696d 6167 6520 666f 720a 7468 ore image for.th │ │ │ │ │ -00014170: 6973 2065 7861 6d70 6c65 2074 6f20 776f is example to wo │ │ │ │ │ -00014180: 726b 2e29 0a0a 2020 2049 6e20 6d6f 7265 rk.).. In more │ │ │ │ │ -00014190: 2063 6f6d 706c 6578 2063 6173 6573 2c20 complex cases, │ │ │ │ │ -000141a0: 6974 206d 6179 2062 6520 7573 6566 756c it may be useful │ │ │ │ │ -000141b0: 2074 6f20 7265 6164 206f 7468 6572 2063 to read other c │ │ │ │ │ -000141c0: 6f6e 6669 6775 7261 7469 6f6e 0a66 696c onfiguration.fil │ │ │ │ │ -000141d0: 6573 2064 6972 6563 746c 7920 6672 6f6d es directly from │ │ │ │ │ -000141e0: 2074 6865 2065 6d62 6564 6465 6420 636f the embedded co │ │ │ │ │ -000141f0: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ -00014200: 2e20 2054 6869 7320 616c 6c6f 7773 2073 . This allows s │ │ │ │ │ -00014210: 7563 680a 7468 696e 6773 2061 7320 7265 uch.things as re │ │ │ │ │ -00014220: 6164 696e 6720 6669 6c65 7320 6e6f 7420 ading files not │ │ │ │ │ -00014230: 6361 6c6c 6564 2027 6772 7562 2e63 6667 called 'grub.cfg │ │ │ │ │ -00014240: 272c 206f 7220 7265 6164 696e 6720 6669 ', or reading fi │ │ │ │ │ -00014250: 6c65 7320 6672 6f6d 2061 0a64 6972 6563 les from a.direc │ │ │ │ │ -00014260: 746f 7279 206f 7468 6572 2074 6861 6e20 tory other than │ │ │ │ │ -00014270: 7468 6174 2077 6865 7265 2047 5255 4227 that where GRUB' │ │ │ │ │ -00014280: 7320 6c6f 6164 6162 6c65 206d 6f64 756c s loadable modul │ │ │ │ │ -00014290: 6573 2061 7265 2069 6e73 7461 6c6c 6564 es are installed │ │ │ │ │ -000142a0: 2e0a 546f 2064 6f20 7468 6973 2c20 696e ..To do this, in │ │ │ │ │ -000142b0: 636c 7564 6520 7468 6520 2763 6f6e 6669 clude the 'confi │ │ │ │ │ -000142c0: 6766 696c 6527 2061 6e64 2027 6e6f 726d gfile' and 'norm │ │ │ │ │ -000142d0: 616c 2720 6d6f 6475 6c65 7320 696e 2074 al' modules in t │ │ │ │ │ -000142e0: 6865 2063 6f72 650a 696d 6167 652c 2061 he core.image, a │ │ │ │ │ -000142f0: 6e64 2065 6d62 6564 2061 2063 6f6e 6669 nd embed a confi │ │ │ │ │ -00014300: 6775 7261 7469 6f6e 2066 696c 6520 7468 guration file th │ │ │ │ │ -00014310: 6174 2075 7365 7320 7468 6520 2763 6f6e at uses the 'con │ │ │ │ │ -00014320: 6669 6766 696c 6527 2063 6f6d 6d61 6e64 figfile' command │ │ │ │ │ -00014330: 0a74 6f20 6c6f 6164 2061 6e6f 7468 6572 .to load another │ │ │ │ │ -00014340: 2066 696c 652e 2020 5468 6520 666f 6c6c file. The foll │ │ │ │ │ -00014350: 6f77 696e 6720 6578 616d 706c 6520 6f66 owing example of │ │ │ │ │ -00014360: 2074 6869 7320 616c 736f 2072 6571 7569 this also requi │ │ │ │ │ -00014370: 7265 7320 7468 650a 2765 6368 6f27 2c20 res the.'echo', │ │ │ │ │ -00014380: 2773 6561 7263 685f 6c61 6265 6c27 2c20 'search_label', │ │ │ │ │ -00014390: 616e 6420 2774 6573 7427 206d 6f64 756c and 'test' modul │ │ │ │ │ -000143a0: 6573 2074 6f20 6265 2069 6e63 6c75 6465 es to be include │ │ │ │ │ -000143b0: 6420 696e 2074 6865 2063 6f72 650a 696d d in the core.im │ │ │ │ │ -000143c0: 6167 653a 0a0a 2020 2020 2073 6561 7263 age:.. searc │ │ │ │ │ -000143d0: 682e 6673 5f6c 6162 656c 2067 7275 6220 h.fs_label grub │ │ │ │ │ -000143e0: 726f 6f74 0a20 2020 2020 6966 205b 202d root. if [ - │ │ │ │ │ -000143f0: 6520 2f62 6f6f 742f 6772 7562 2f65 7861 e /boot/grub/exa │ │ │ │ │ -00014400: 6d70 6c65 2f74 6573 7431 2e63 6667 205d mple/test1.cfg ] │ │ │ │ │ -00014410: 3b20 7468 656e 0a20 2020 2020 2020 2020 ; then. │ │ │ │ │ -00014420: 7365 7420 7072 6566 6978 3d28 2472 6f6f set prefix=($roo │ │ │ │ │ -00014430: 7429 2f62 6f6f 742f 6772 7562 0a20 2020 t)/boot/grub. │ │ │ │ │ -00014440: 2020 2020 2020 636f 6e66 6967 6669 6c65 configfile │ │ │ │ │ -00014450: 202f 626f 6f74 2f67 7275 622f 6578 616d /boot/grub/exam │ │ │ │ │ -00014460: 706c 652f 7465 7374 312e 6366 670a 2020 ple/test1.cfg. │ │ │ │ │ -00014470: 2020 2065 6c73 650a 2020 2020 2020 2020 else. │ │ │ │ │ -00014480: 2069 6620 5b20 2d65 202f 626f 6f74 2f67 if [ -e /boot/g │ │ │ │ │ -00014490: 7275 622f 6578 616d 706c 652f 7465 7374 rub/example/test │ │ │ │ │ -000144a0: 322e 6366 6720 5d3b 2074 6865 6e0a 2020 2.cfg ]; then. │ │ │ │ │ -000144b0: 2020 2020 2020 2020 2020 2073 6574 2070 set p │ │ │ │ │ -000144c0: 7265 6669 783d 2824 726f 6f74 292f 626f refix=($root)/bo │ │ │ │ │ -000144d0: 6f74 2f67 7275 620a 2020 2020 2020 2020 ot/grub. │ │ │ │ │ -000144e0: 2020 2020 2063 6f6e 6669 6766 696c 6520 configfile │ │ │ │ │ -000144f0: 2f62 6f6f 742f 6772 7562 2f65 7861 6d70 /boot/grub/examp │ │ │ │ │ -00014500: 6c65 2f74 6573 7432 2e63 6667 0a20 2020 le/test2.cfg. │ │ │ │ │ -00014510: 2020 2020 2020 656c 7365 0a20 2020 2020 else. │ │ │ │ │ -00014520: 2020 2020 2020 2020 6563 686f 2022 436f echo "Co │ │ │ │ │ -00014530: 756c 6420 6e6f 7420 6669 6e64 2061 6e20 uld not find an │ │ │ │ │ -00014540: 6578 616d 706c 6520 636f 6e66 6967 7572 example configur │ │ │ │ │ -00014550: 6174 696f 6e20 6669 6c65 2122 0a20 2020 ation file!". │ │ │ │ │ -00014560: 2020 2020 2020 6669 0a20 2020 2020 6669 fi. fi │ │ │ │ │ -00014570: 0a0a 2020 2054 6865 2065 6d62 6564 6465 .. The embedde │ │ │ │ │ -00014580: 6420 636f 6e66 6967 7572 6174 696f 6e20 d configuration │ │ │ │ │ -00014590: 6669 6c65 206d 6179 206e 6f74 2063 6f6e file may not con │ │ │ │ │ -000145a0: 7461 696e 206d 656e 7520 656e 7472 6965 tain menu entrie │ │ │ │ │ -000145b0: 730a 6469 7265 6374 6c79 2c20 6275 7420 s.directly, but │ │ │ │ │ -000145c0: 6d61 7920 6f6e 6c79 2072 6561 6420 7468 may only read th │ │ │ │ │ -000145d0: 656d 2066 726f 6d20 656c 7365 7768 6572 em from elsewher │ │ │ │ │ -000145e0: 6520 7573 696e 6720 2763 6f6e 6669 6766 e using 'configf │ │ │ │ │ -000145f0: 696c 6527 2e0a 0a1f 0a46 696c 653a 2067 ile'.....File: g │ │ │ │ │ -00014600: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00014610: 2054 6865 6d65 2066 696c 6520 666f 726d Theme file form │ │ │ │ │ -00014620: 6174 2c20 204e 6578 743a 204e 6574 776f at, Next: Netwo │ │ │ │ │ -00014630: 726b 2c20 2050 7265 763a 2043 6f6e 6669 rk, Prev: Confi │ │ │ │ │ -00014640: 6775 7261 7469 6f6e 2c20 2055 703a 2054 guration, Up: T │ │ │ │ │ -00014650: 6f70 0a0a 3720 5468 656d 6520 6669 6c65 op..7 Theme file │ │ │ │ │ -00014660: 2066 6f72 6d61 740a 2a2a 2a2a 2a2a 2a2a format.******** │ │ │ │ │ -00014670: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a37 2e31 ***********..7.1 │ │ │ │ │ -00014680: 2049 6e74 726f 6475 6374 696f 6e0a 3d3d Introduction.== │ │ │ │ │ -00014690: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -000146a0: 5468 6520 4752 5542 2067 7261 7068 6963 The GRUB graphic │ │ │ │ │ -000146b0: 616c 206d 656e 7520 7375 7070 6f72 7473 al menu supports │ │ │ │ │ -000146c0: 2074 6865 6d65 7320 7468 6174 2063 616e themes that can │ │ │ │ │ -000146d0: 2063 7573 746f 6d69 7a65 2074 6865 206c customize the l │ │ │ │ │ -000146e0: 6179 6f75 740a 616e 6420 6170 7065 6172 ayout.and appear │ │ │ │ │ -000146f0: 616e 6365 206f 6620 7468 6520 4752 5542 ance of the GRUB │ │ │ │ │ -00014700: 2062 6f6f 7420 6d65 6e75 2e20 2054 6865 boot menu. The │ │ │ │ │ -00014710: 2074 6865 6d65 2069 7320 636f 6e66 6967 theme is config │ │ │ │ │ -00014720: 7572 6564 2074 6872 6f75 6768 2061 0a70 ured through a.p │ │ │ │ │ -00014730: 6c61 696e 2074 6578 7420 6669 6c65 2074 lain text file t │ │ │ │ │ -00014740: 6861 7420 7370 6563 6966 6965 7320 7468 hat specifies th │ │ │ │ │ -00014750: 6520 6c61 796f 7574 206f 6620 7468 6520 e layout of the │ │ │ │ │ -00014760: 7661 7269 6f75 7320 4755 4920 636f 6d70 various GUI comp │ │ │ │ │ -00014770: 6f6e 656e 7473 0a28 696e 636c 7564 696e onents.(includin │ │ │ │ │ -00014780: 6720 7468 6520 626f 6f74 206d 656e 752c g the boot menu, │ │ │ │ │ -00014790: 2074 696d 656f 7574 2070 726f 6772 6573 timeout progres │ │ │ │ │ -000147a0: 7320 6261 722c 2061 6e64 2074 6578 7420 s bar, and text │ │ │ │ │ -000147b0: 6d65 7373 6167 6573 2920 6173 0a77 656c messages) as.wel │ │ │ │ │ -000147c0: 6c20 6173 2074 6865 2061 7070 6561 7261 l as the appeara │ │ │ │ │ -000147d0: 6e63 6520 7573 696e 6720 636f 6c6f 7273 nce using colors │ │ │ │ │ -000147e0: 2c20 666f 6e74 732c 2061 6e64 2069 6d61 , fonts, and ima │ │ │ │ │ -000147f0: 6765 732e 2020 4578 616d 706c 6520 6973 ges. Example is │ │ │ │ │ -00014800: 0a61 7661 696c 6162 6c65 2069 6e20 646f .available in do │ │ │ │ │ -00014810: 6373 2f65 7861 6d70 6c65 5f74 6865 6d65 cs/example_theme │ │ │ │ │ -00014820: 2e74 7874 0a0a 372e 3220 5468 656d 6520 .txt..7.2 Theme │ │ │ │ │ -00014830: 456c 656d 656e 7473 0a3d 3d3d 3d3d 3d3d Elements.======= │ │ │ │ │ -00014840: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a37 2e32 ===========..7.2 │ │ │ │ │ -00014850: 2e31 2043 6f6c 6f72 730a 2d2d 2d2d 2d2d .1 Colors.------ │ │ │ │ │ -00014860: 2d2d 2d2d 2d2d 0a0a 436f 6c6f 7273 2063 ------..Colors c │ │ │ │ │ -00014870: 616e 2062 6520 7370 6563 6966 6965 6420 an be specified │ │ │ │ │ -00014880: 696e 2073 6576 6572 616c 2077 6179 733a in several ways: │ │ │ │ │ -00014890: 0a0a 2020 202a 2048 544d 4c2d 7374 796c .. * HTML-styl │ │ │ │ │ -000148a0: 6520 2223 5252 4747 4242 2220 6f72 2022 e "#RRGGBB" or " │ │ │ │ │ -000148b0: 2352 4742 2220 666f 726d 6174 2c20 7768 #RGB" format, wh │ │ │ │ │ -000148c0: 6572 6520 2a52 2a2c 202a 472a 2c20 616e ere *R*, *G*, an │ │ │ │ │ -000148d0: 6420 2a42 2a20 6172 650a 2020 2020 2068 d *B* are. h │ │ │ │ │ -000148e0: 6578 6164 6563 696d 616c 2064 6967 6974 exadecimal digit │ │ │ │ │ -000148f0: 7320 2865 2e67 2e2c 2022 2338 3839 3946 s (e.g., "#8899F │ │ │ │ │ -00014900: 4622 290a 2020 202a 2061 7320 636f 6d6d F"). * as comm │ │ │ │ │ -00014910: 612d 7365 7061 7261 7465 6420 6465 6369 a-separated deci │ │ │ │ │ -00014920: 6d61 6c20 5247 4220 7661 6c75 6573 2028 mal RGB values ( │ │ │ │ │ -00014930: 652e 672e 2c20 2231 3238 2c20 3132 382c e.g., "128, 128, │ │ │ │ │ -00014940: 2032 3535 2229 0a20 2020 2a20 7769 7468 255"). * with │ │ │ │ │ -00014950: 2022 5356 4720 312e 3020 636f 6c6f 7220 "SVG 1.0 color │ │ │ │ │ -00014960: 6e61 6d65 7322 2028 652e 672e 2c20 2263 names" (e.g., "c │ │ │ │ │ -00014970: 6f72 6e66 6c6f 7765 7262 6c75 6522 2920 ornflowerblue") │ │ │ │ │ -00014980: 7768 6963 6820 6d75 7374 2062 650a 2020 which must be. │ │ │ │ │ -00014990: 2020 2073 7065 6369 6669 6564 2069 6e20 specified in │ │ │ │ │ -000149a0: 6c6f 7765 7263 6173 652e 0a0a 372e 322e lowercase...7.2. │ │ │ │ │ -000149b0: 3220 466f 6e74 730a 2d2d 2d2d 2d2d 2d2d 2 Fonts.-------- │ │ │ │ │ -000149c0: 2d2d 2d0a 0a54 6865 2066 6f6e 7473 2047 ---..The fonts G │ │ │ │ │ -000149d0: 5255 4220 7573 6573 2022 5046 4632 2066 RUB uses "PFF2 f │ │ │ │ │ -000149e0: 6f6e 7420 666f 726d 6174 2220 6269 746d ont format" bitm │ │ │ │ │ -000149f0: 6170 2066 6f6e 7473 2e20 2046 6f6e 7473 ap fonts. Fonts │ │ │ │ │ -00014a00: 2061 7265 0a73 7065 6369 6669 6564 2077 are.specified w │ │ │ │ │ -00014a10: 6974 6820 6675 6c6c 2066 6f6e 7420 6e61 ith full font na │ │ │ │ │ -00014a20: 6d65 732e 2020 4375 7272 656e 746c 7920 mes. Currently │ │ │ │ │ -00014a30: 7468 6572 6520 6973 206e 6f20 7072 6f76 there is no prov │ │ │ │ │ -00014a40: 6973 696f 6e20 666f 7220 610a 7072 6566 ision for a.pref │ │ │ │ │ -00014a50: 6572 656e 6365 206c 6973 7420 6f66 2066 erence list of f │ │ │ │ │ -00014a60: 6f6e 7473 2c20 6f72 2064 6572 6976 696e onts, or derivin │ │ │ │ │ -00014a70: 6720 6f6e 6520 666f 6e74 2066 726f 6d20 g one font from │ │ │ │ │ -00014a80: 616e 6f74 6865 722e 2020 466f 6e74 7320 another. Fonts │ │ │ │ │ -00014a90: 6172 650a 6c6f 6164 6564 2077 6974 6820 are.loaded with │ │ │ │ │ -00014aa0: 7468 6520 226c 6f61 6466 6f6e 7422 2063 the "loadfont" c │ │ │ │ │ -00014ab0: 6f6d 6d61 6e64 2069 6e20 4752 5542 2028 ommand in GRUB ( │ │ │ │ │ -00014ac0: 2a6e 6f74 6520 6c6f 6164 666f 6e74 3a3a *note loadfont:: │ │ │ │ │ -00014ad0: 292e 2020 546f 2073 6565 0a74 6865 206c ). To see.the l │ │ │ │ │ -00014ae0: 6973 7420 6f66 206c 6f61 6465 6420 666f ist of loaded fo │ │ │ │ │ -00014af0: 6e74 732c 2065 7865 6375 7465 2074 6865 nts, execute the │ │ │ │ │ -00014b00: 2022 6c73 666f 6e74 7322 2063 6f6d 6d61 "lsfonts" comma │ │ │ │ │ -00014b10: 6e64 2028 2a6e 6f74 650a 6c73 666f 6e74 nd (*note.lsfont │ │ │ │ │ -00014b20: 733a 3a29 2e20 2049 6620 7468 6572 6520 s::). If there │ │ │ │ │ -00014b30: 6172 6520 746f 6f20 6d61 6e79 2066 6f6e are too many fon │ │ │ │ │ -00014b40: 7473 2074 6f20 6669 7420 6f6e 2073 6372 ts to fit on scr │ │ │ │ │ -00014b50: 6565 6e2c 2064 6f20 2273 6574 0a70 6167 een, do "set.pag │ │ │ │ │ -00014b60: 6572 3d31 2220 6265 666f 7265 2065 7865 er=1" before exe │ │ │ │ │ -00014b70: 6375 7469 6e67 2022 6c73 666f 6e74 7322 cuting "lsfonts" │ │ │ │ │ -00014b80: 2e0a 0a37 2e32 2e33 2050 726f 6772 6573 ...7.2.3 Progres │ │ │ │ │ -00014b90: 7320 4261 720a 2d2d 2d2d 2d2d 2d2d 2d2d s Bar.---------- │ │ │ │ │ -00014ba0: 2d2d 2d2d 2d2d 2d2d 0a0a 4669 6775 7265 --------..Figure │ │ │ │ │ -00014bb0: 2037 2e31 0a0a 4669 6775 7265 2037 2e32 7.1..Figure 7.2 │ │ │ │ │ -00014bc0: 0a0a 5072 6f67 7265 7373 2062 6172 7320 ..Progress bars │ │ │ │ │ -00014bd0: 6172 6520 7573 6564 2074 6f20 6469 7370 are used to disp │ │ │ │ │ -00014be0: 6c61 7920 7468 6520 7265 6d61 696e 696e lay the remainin │ │ │ │ │ -00014bf0: 6720 7469 6d65 2062 6566 6f72 6520 4752 g time before GR │ │ │ │ │ -00014c00: 5542 2062 6f6f 7473 0a74 6865 2064 6566 UB boots.the def │ │ │ │ │ -00014c10: 6175 6c74 206d 656e 7520 656e 7472 792e ault menu entry. │ │ │ │ │ -00014c20: 2020 546f 2063 7265 6174 6520 6120 7072 To create a pr │ │ │ │ │ -00014c30: 6f67 7265 7373 2062 6172 2074 6861 7420 ogress bar that │ │ │ │ │ -00014c40: 7769 6c6c 2064 6973 706c 6179 2074 6865 will display the │ │ │ │ │ -00014c50: 0a72 656d 6169 6e69 6e67 2074 696d 6520 .remaining time │ │ │ │ │ -00014c60: 6265 666f 7265 2061 7574 6f6d 6174 6963 before automatic │ │ │ │ │ -00014c70: 2062 6f6f 742c 2073 696d 706c 7920 6372 boot, simply cr │ │ │ │ │ -00014c80: 6561 7465 2061 2022 7072 6f67 7265 7373 eate a "progress │ │ │ │ │ -00014c90: 5f62 6172 220a 636f 6d70 6f6e 656e 7420 _bar".component │ │ │ │ │ -00014ca0: 7769 7468 2074 6865 2069 6420 225f 5f74 with the id "__t │ │ │ │ │ -00014cb0: 696d 656f 7574 5f5f 222e 2020 5468 6973 imeout__". This │ │ │ │ │ -00014cc0: 2069 6e64 6963 6174 6573 2074 6f20 4752 indicates to GR │ │ │ │ │ -00014cd0: 5542 2074 6861 7420 7468 650a 7072 6f67 UB that the.prog │ │ │ │ │ -00014ce0: 7265 7373 2062 6172 2073 686f 756c 6420 ress bar should │ │ │ │ │ -00014cf0: 6265 2075 7064 6174 6564 2061 7320 7469 be updated as ti │ │ │ │ │ -00014d00: 6d65 2070 6173 7365 732c 2061 6e64 2069 me passes, and i │ │ │ │ │ -00014d10: 7420 7368 6f75 6c64 2062 6520 6d61 6465 t should be made │ │ │ │ │ -00014d20: 0a69 6e76 6973 6962 6c65 2069 6620 7468 .invisible if th │ │ │ │ │ -00014d30: 6520 636f 756e 7464 6f77 6e20 746f 2061 e countdown to a │ │ │ │ │ -00014d40: 7574 6f6d 6174 6963 2062 6f6f 7420 6973 utomatic boot is │ │ │ │ │ -00014d50: 2069 6e74 6572 7275 7074 6564 2062 7920 interrupted by │ │ │ │ │ -00014d60: 7468 6520 7573 6572 2e0a 0a20 2020 5072 the user... Pr │ │ │ │ │ -00014d70: 6f67 7265 7373 2062 6172 7320 6d61 7920 ogress bars may │ │ │ │ │ -00014d80: 6f70 7469 6f6e 616c 6c79 2068 6176 6520 optionally have │ │ │ │ │ -00014d90: 7465 7874 2064 6973 706c 6179 6564 206f text displayed o │ │ │ │ │ -00014da0: 6e20 7468 656d 2e20 2054 6869 7320 7465 n them. This te │ │ │ │ │ -00014db0: 7874 0a69 7320 636f 6e74 726f 6c6c 6564 xt.is controlled │ │ │ │ │ -00014dc0: 2062 7920 7661 7269 6162 6c65 2022 7465 by variable "te │ │ │ │ │ -00014dd0: 7874 2220 7768 6963 6820 636f 6e74 6169 xt" which contai │ │ │ │ │ -00014de0: 6e73 2061 2070 7269 6e74 6620 7465 6d70 ns a printf temp │ │ │ │ │ -00014df0: 6c61 7465 2077 6974 680a 7468 6520 6f6e late with.the on │ │ │ │ │ -00014e00: 6c79 2061 7267 756d 656e 7420 2564 2069 ly argument %d i │ │ │ │ │ -00014e10: 7320 7468 6520 6e75 6d62 6572 206f 6620 s the number of │ │ │ │ │ -00014e20: 7365 636f 6e64 7320 7265 6d61 696e 696e seconds remainin │ │ │ │ │ -00014e30: 672e 2020 4164 6469 7469 6f6e 616c 6c79 g. Additionally │ │ │ │ │ -00014e40: 0a73 7065 6369 616c 2076 616c 7565 7320 .special values │ │ │ │ │ -00014e50: 2240 5449 4d45 4f55 545f 4e4f 5449 4649 "@TIMEOUT_NOTIFI │ │ │ │ │ -00014e60: 4341 5449 4f4e 5f53 484f 5254 4022 2c0a CATION_SHORT@",. │ │ │ │ │ -00014e70: 2240 5449 4d45 4f55 545f 4e4f 5449 4649 "@TIMEOUT_NOTIFI │ │ │ │ │ -00014e80: 4341 5449 4f4e 5f4d 4944 444c 4540 222c CATION_MIDDLE@", │ │ │ │ │ -00014e90: 2022 4054 494d 454f 5554 5f4e 4f54 4946 "@TIMEOUT_NOTIF │ │ │ │ │ -00014ea0: 4943 4154 494f 4e5f 4c4f 4e47 4022 2061 ICATION_LONG@" a │ │ │ │ │ -00014eb0: 7265 0a72 6570 6c61 6365 6420 7769 7468 re.replaced with │ │ │ │ │ -00014ec0: 2073 7461 6e64 6172 6420 616e 6420 7472 standard and tr │ │ │ │ │ -00014ed0: 616e 736c 6174 6564 2074 656d 706c 6174 anslated templat │ │ │ │ │ -00014ee0: 6573 2e0a 0a37 2e32 2e34 2043 6972 6375 es...7.2.4 Circu │ │ │ │ │ -00014ef0: 6c61 7220 5072 6f67 7265 7373 2049 6e64 lar Progress Ind │ │ │ │ │ -00014f00: 6963 6174 6f72 0a2d 2d2d 2d2d 2d2d 2d2d icator.--------- │ │ │ │ │ +00013ba0: 3d3d 3d3d 3d0a 0a47 5255 4220 7375 7070 =====..GRUB supp │ │ │ │ │ +00013bb0: 6f72 7473 2065 6d62 6564 6469 6e67 2061 orts embedding a │ │ │ │ │ +00013bc0: 2063 6f6e 6669 6775 7261 7469 6f6e 2066 configuration f │ │ │ │ │ +00013bd0: 696c 6520 6469 7265 6374 6c79 2069 6e74 ile directly int │ │ │ │ │ +00013be0: 6f20 7468 6520 636f 7265 0a69 6d61 6765 o the core.image │ │ │ │ │ +00013bf0: 2c20 736f 2074 6861 7420 6974 2069 7320 , so that it is │ │ │ │ │ +00013c00: 6c6f 6164 6564 2062 6566 6f72 6520 656e loaded before en │ │ │ │ │ +00013c10: 7465 7269 6e67 206e 6f72 6d61 6c20 6d6f tering normal mo │ │ │ │ │ +00013c20: 6465 2e20 2054 6869 7320 6973 0a75 7365 de. This is.use │ │ │ │ │ +00013c30: 6675 6c2c 2066 6f72 2065 7861 6d70 6c65 ful, for example │ │ │ │ │ +00013c40: 2c20 7768 656e 2069 7420 6973 206e 6f74 , when it is not │ │ │ │ │ +00013c50: 2073 7472 6169 6768 7466 6f72 7761 7264 straightforward │ │ │ │ │ +00013c60: 2074 6f20 6669 6e64 2074 6865 2072 6561 to find the rea │ │ │ │ │ +00013c70: 6c0a 636f 6e66 6967 7572 6174 696f 6e20 l.configuration │ │ │ │ │ +00013c80: 6669 6c65 2c20 6f72 2077 6865 6e20 796f file, or when yo │ │ │ │ │ +00013c90: 7520 6e65 6564 2074 6f20 6465 6275 6720 u need to debug │ │ │ │ │ +00013ca0: 7072 6f62 6c65 6d73 2077 6974 6820 6c6f problems with lo │ │ │ │ │ +00013cb0: 6164 696e 6720 7468 6174 0a66 696c 652e ading that.file. │ │ │ │ │ +00013cc0: 2020 2767 7275 622d 696e 7374 616c 6c27 'grub-install' │ │ │ │ │ +00013cd0: 2075 7365 7320 7468 6973 2066 6561 7475 uses this featu │ │ │ │ │ +00013ce0: 7265 2077 6865 6e20 6974 2069 7320 6e6f re when it is no │ │ │ │ │ +00013cf0: 7420 7573 696e 6720 4249 4f53 2064 6973 t using BIOS dis │ │ │ │ │ +00013d00: 6b0a 6675 6e63 7469 6f6e 7320 6f72 2077 k.functions or w │ │ │ │ │ +00013d10: 6865 6e20 696e 7374 616c 6c69 6e67 2074 hen installing t │ │ │ │ │ +00013d20: 6f20 6120 6469 6666 6572 656e 7420 6469 o a different di │ │ │ │ │ +00013d30: 736b 2066 726f 6d20 7468 6520 6f6e 6520 sk from the one │ │ │ │ │ +00013d40: 636f 6e74 6169 6e69 6e67 0a27 2f62 6f6f containing.'/boo │ │ │ │ │ +00013d50: 742f 6772 7562 272c 2069 6e20 7768 6963 t/grub', in whic │ │ │ │ │ +00013d60: 6820 6361 7365 2069 7420 6e65 6564 7320 h case it needs │ │ │ │ │ +00013d70: 746f 2075 7365 2074 6865 2027 7365 6172 to use the 'sear │ │ │ │ │ +00013d80: 6368 2720 636f 6d6d 616e 6420 282a 6e6f ch' command (*no │ │ │ │ │ +00013d90: 7465 0a73 6561 7263 683a 3a29 2074 6f20 te.search::) to │ │ │ │ │ +00013da0: 6669 6e64 2027 2f62 6f6f 742f 6772 7562 find '/boot/grub │ │ │ │ │ +00013db0: 272e 0a0a 2020 2054 6f20 656d 6265 6420 '... To embed │ │ │ │ │ +00013dc0: 6120 636f 6e66 6967 7572 6174 696f 6e20 a configuration │ │ │ │ │ +00013dd0: 6669 6c65 2c20 7573 6520 7468 6520 272d file, use the '- │ │ │ │ │ +00013de0: 6327 206f 7074 696f 6e20 746f 2027 6772 c' option to 'gr │ │ │ │ │ +00013df0: 7562 2d6d 6b69 6d61 6765 272e 0a54 6865 ub-mkimage'..The │ │ │ │ │ +00013e00: 2066 696c 6520 6973 2063 6f70 6965 6420 file is copied │ │ │ │ │ +00013e10: 696e 746f 2074 6865 2063 6f72 6520 696d into the core im │ │ │ │ │ +00013e20: 6167 652c 2073 6f20 6974 206d 6179 2072 age, so it may r │ │ │ │ │ +00013e30: 6573 6964 6520 616e 7977 6865 7265 206f eside anywhere o │ │ │ │ │ +00013e40: 6e20 7468 650a 6669 6c65 2073 7973 7465 n the.file syste │ │ │ │ │ +00013e50: 6d2c 2061 6e64 206d 6179 2062 6520 7265 m, and may be re │ │ │ │ │ +00013e60: 6d6f 7665 6420 6166 7465 7220 7275 6e6e moved after runn │ │ │ │ │ +00013e70: 696e 6720 2767 7275 622d 6d6b 696d 6167 ing 'grub-mkimag │ │ │ │ │ +00013e80: 6527 2e0a 0a20 2020 4166 7465 7220 7468 e'... After th │ │ │ │ │ +00013e90: 6520 656d 6265 6464 6564 2063 6f6e 6669 e embedded confi │ │ │ │ │ +00013ea0: 6775 7261 7469 6f6e 2066 696c 6520 2869 guration file (i │ │ │ │ │ +00013eb0: 6620 616e 7929 2069 7320 6578 6563 7574 f any) is execut │ │ │ │ │ +00013ec0: 6564 2c20 4752 5542 2077 696c 6c0a 6c6f ed, GRUB will.lo │ │ │ │ │ +00013ed0: 6164 2074 6865 2027 6e6f 726d 616c 2720 ad the 'normal' │ │ │ │ │ +00013ee0: 6d6f 6475 6c65 2028 2a6e 6f74 6520 6e6f module (*note no │ │ │ │ │ +00013ef0: 726d 616c 3a3a 292c 2077 6869 6368 2077 rmal::), which w │ │ │ │ │ +00013f00: 696c 6c20 7468 656e 2072 6561 6420 7468 ill then read th │ │ │ │ │ +00013f10: 6520 7265 616c 0a63 6f6e 6669 6775 7261 e real.configura │ │ │ │ │ +00013f20: 7469 6f6e 2066 696c 6520 6672 6f6d 2027 tion file from ' │ │ │ │ │ +00013f30: 2470 7265 6669 782f 6772 7562 2e63 6667 $prefix/grub.cfg │ │ │ │ │ +00013f40: 272e 2020 4279 2074 6869 7320 706f 696e '. By this poin │ │ │ │ │ +00013f50: 742c 2074 6865 2027 726f 6f74 270a 7661 t, the 'root'.va │ │ │ │ │ +00013f60: 7269 6162 6c65 2077 696c 6c20 616c 736f riable will also │ │ │ │ │ +00013f70: 2068 6176 6520 6265 656e 2073 6574 2074 have been set t │ │ │ │ │ +00013f80: 6f20 7468 6520 726f 6f74 2064 6576 6963 o the root devic │ │ │ │ │ +00013f90: 6520 6e61 6d65 2e20 2046 6f72 2065 7861 e name. For exa │ │ │ │ │ +00013fa0: 6d70 6c65 2c0a 2770 7265 6669 7827 206d mple,.'prefix' m │ │ │ │ │ +00013fb0: 6967 6874 2062 6520 7365 7420 746f 2027 ight be set to ' │ │ │ │ │ +00013fc0: 2868 6430 2c31 292f 626f 6f74 2f67 7275 (hd0,1)/boot/gru │ │ │ │ │ +00013fd0: 6227 2c20 616e 6420 2772 6f6f 7427 206d b', and 'root' m │ │ │ │ │ +00013fe0: 6967 6874 2062 6520 7365 7420 746f 0a27 ight be set to.' │ │ │ │ │ +00013ff0: 6864 302c 3127 2e20 2054 6875 732c 2069 hd0,1'. Thus, i │ │ │ │ │ +00014000: 6e20 6d6f 7374 2063 6173 6573 2c20 7468 n most cases, th │ │ │ │ │ +00014010: 6520 656d 6265 6464 6564 2063 6f6e 6669 e embedded confi │ │ │ │ │ +00014020: 6775 7261 7469 6f6e 2066 696c 6520 6f6e guration file on │ │ │ │ │ +00014030: 6c79 0a6e 6565 6473 2074 6f20 7365 7420 ly.needs to set │ │ │ │ │ +00014040: 7468 6520 2770 7265 6669 7827 2061 6e64 the 'prefix' and │ │ │ │ │ +00014050: 2027 726f 6f74 2720 7661 7269 6162 6c65 'root' variable │ │ │ │ │ +00014060: 732c 2061 6e64 2074 6865 6e20 6472 6f70 s, and then drop │ │ │ │ │ +00014070: 2074 6872 6f75 6768 2074 6f0a 4752 5542 through to.GRUB │ │ │ │ │ +00014080: 2773 206e 6f72 6d61 6c20 7072 6f63 6573 's normal proces │ │ │ │ │ +00014090: 7369 6e67 2e20 2041 2074 7970 6963 616c sing. A typical │ │ │ │ │ +000140a0: 2065 7861 6d70 6c65 206f 6620 7468 6973 example of this │ │ │ │ │ +000140b0: 206d 6967 6874 206c 6f6f 6b20 6c69 6b65 might look like │ │ │ │ │ +000140c0: 0a74 6869 733a 0a0a 2020 2020 2073 6561 .this:.. sea │ │ │ │ │ +000140d0: 7263 682e 6673 5f75 7569 6420 3031 3233 rch.fs_uuid 0123 │ │ │ │ │ +000140e0: 3435 3637 2d38 3961 622d 6364 6566 2d30 4567-89ab-cdef-0 │ │ │ │ │ +000140f0: 3132 332d 3435 3637 3839 6162 6364 6566 123-456789abcdef │ │ │ │ │ +00014100: 2072 6f6f 740a 2020 2020 2073 6574 2070 root. set p │ │ │ │ │ +00014110: 7265 6669 783d 2824 726f 6f74 292f 626f refix=($root)/bo │ │ │ │ │ +00014120: 6f74 2f67 7275 620a 0a20 2020 2854 6865 ot/grub.. (The │ │ │ │ │ +00014130: 2027 7365 6172 6368 5f66 735f 7575 6964 'search_fs_uuid │ │ │ │ │ +00014140: 2720 6d6f 6475 6c65 206d 7573 7420 6265 ' module must be │ │ │ │ │ +00014150: 2069 6e63 6c75 6465 6420 696e 2074 6865 included in the │ │ │ │ │ +00014160: 2063 6f72 6520 696d 6167 6520 666f 720a core image for. │ │ │ │ │ +00014170: 7468 6973 2065 7861 6d70 6c65 2074 6f20 this example to │ │ │ │ │ +00014180: 776f 726b 2e29 0a0a 2020 2049 6e20 6d6f work.).. In mo │ │ │ │ │ +00014190: 7265 2063 6f6d 706c 6578 2063 6173 6573 re complex cases │ │ │ │ │ +000141a0: 2c20 6974 206d 6179 2062 6520 7573 6566 , it may be usef │ │ │ │ │ +000141b0: 756c 2074 6f20 7265 6164 206f 7468 6572 ul to read other │ │ │ │ │ +000141c0: 2063 6f6e 6669 6775 7261 7469 6f6e 0a66 configuration.f │ │ │ │ │ +000141d0: 696c 6573 2064 6972 6563 746c 7920 6672 iles directly fr │ │ │ │ │ +000141e0: 6f6d 2074 6865 2065 6d62 6564 6465 6420 om the embedded │ │ │ │ │ +000141f0: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ +00014200: 6c65 2e20 2054 6869 7320 616c 6c6f 7773 le. This allows │ │ │ │ │ +00014210: 2073 7563 680a 7468 696e 6773 2061 7320 such.things as │ │ │ │ │ +00014220: 7265 6164 696e 6720 6669 6c65 7320 6e6f reading files no │ │ │ │ │ +00014230: 7420 6361 6c6c 6564 2027 6772 7562 2e63 t called 'grub.c │ │ │ │ │ +00014240: 6667 272c 206f 7220 7265 6164 696e 6720 fg', or reading │ │ │ │ │ +00014250: 6669 6c65 7320 6672 6f6d 2061 0a64 6972 files from a.dir │ │ │ │ │ +00014260: 6563 746f 7279 206f 7468 6572 2074 6861 ectory other tha │ │ │ │ │ +00014270: 6e20 7468 6174 2077 6865 7265 2047 5255 n that where GRU │ │ │ │ │ +00014280: 4227 7320 6c6f 6164 6162 6c65 206d 6f64 B's loadable mod │ │ │ │ │ +00014290: 756c 6573 2061 7265 2069 6e73 7461 6c6c ules are install │ │ │ │ │ +000142a0: 6564 2e0a 546f 2064 6f20 7468 6973 2c20 ed..To do this, │ │ │ │ │ +000142b0: 696e 636c 7564 6520 7468 6520 2763 6f6e include the 'con │ │ │ │ │ +000142c0: 6669 6766 696c 6527 2061 6e64 2027 6e6f figfile' and 'no │ │ │ │ │ +000142d0: 726d 616c 2720 6d6f 6475 6c65 7320 696e rmal' modules in │ │ │ │ │ +000142e0: 2074 6865 2063 6f72 650a 696d 6167 652c the core.image, │ │ │ │ │ +000142f0: 2061 6e64 2065 6d62 6564 2061 2063 6f6e and embed a con │ │ │ │ │ +00014300: 6669 6775 7261 7469 6f6e 2066 696c 6520 figuration file │ │ │ │ │ +00014310: 7468 6174 2075 7365 7320 7468 6520 2763 that uses the 'c │ │ │ │ │ +00014320: 6f6e 6669 6766 696c 6527 2063 6f6d 6d61 onfigfile' comma │ │ │ │ │ +00014330: 6e64 0a74 6f20 6c6f 6164 2061 6e6f 7468 nd.to load anoth │ │ │ │ │ +00014340: 6572 2066 696c 652e 2020 5468 6520 666f er file. The fo │ │ │ │ │ +00014350: 6c6c 6f77 696e 6720 6578 616d 706c 6520 llowing example │ │ │ │ │ +00014360: 6f66 2074 6869 7320 616c 736f 2072 6571 of this also req │ │ │ │ │ +00014370: 7569 7265 7320 7468 650a 2765 6368 6f27 uires the.'echo' │ │ │ │ │ +00014380: 2c20 2773 6561 7263 685f 6c61 6265 6c27 , 'search_label' │ │ │ │ │ +00014390: 2c20 616e 6420 2774 6573 7427 206d 6f64 , and 'test' mod │ │ │ │ │ +000143a0: 756c 6573 2074 6f20 6265 2069 6e63 6c75 ules to be inclu │ │ │ │ │ +000143b0: 6465 6420 696e 2074 6865 2063 6f72 650a ded in the core. │ │ │ │ │ +000143c0: 696d 6167 653a 0a0a 2020 2020 2073 6561 image:.. sea │ │ │ │ │ +000143d0: 7263 682e 6673 5f6c 6162 656c 2067 7275 rch.fs_label gru │ │ │ │ │ +000143e0: 6220 726f 6f74 0a20 2020 2020 6966 205b b root. if [ │ │ │ │ │ +000143f0: 202d 6520 2f62 6f6f 742f 6772 7562 2f65 -e /boot/grub/e │ │ │ │ │ +00014400: 7861 6d70 6c65 2f74 6573 7431 2e63 6667 xample/test1.cfg │ │ │ │ │ +00014410: 205d 3b20 7468 656e 0a20 2020 2020 2020 ]; then. │ │ │ │ │ +00014420: 2020 7365 7420 7072 6566 6978 3d28 2472 set prefix=($r │ │ │ │ │ +00014430: 6f6f 7429 2f62 6f6f 742f 6772 7562 0a20 oot)/boot/grub. │ │ │ │ │ +00014440: 2020 2020 2020 2020 636f 6e66 6967 6669 configfi │ │ │ │ │ +00014450: 6c65 202f 626f 6f74 2f67 7275 622f 6578 le /boot/grub/ex │ │ │ │ │ +00014460: 616d 706c 652f 7465 7374 312e 6366 670a ample/test1.cfg. │ │ │ │ │ +00014470: 2020 2020 2065 6c73 650a 2020 2020 2020 else. │ │ │ │ │ +00014480: 2020 2069 6620 5b20 2d65 202f 626f 6f74 if [ -e /boot │ │ │ │ │ +00014490: 2f67 7275 622f 6578 616d 706c 652f 7465 /grub/example/te │ │ │ │ │ +000144a0: 7374 322e 6366 6720 5d3b 2074 6865 6e0a st2.cfg ]; then. │ │ │ │ │ +000144b0: 2020 2020 2020 2020 2020 2020 2073 6574 set │ │ │ │ │ +000144c0: 2070 7265 6669 783d 2824 726f 6f74 292f prefix=($root)/ │ │ │ │ │ +000144d0: 626f 6f74 2f67 7275 620a 2020 2020 2020 boot/grub. │ │ │ │ │ +000144e0: 2020 2020 2020 2063 6f6e 6669 6766 696c configfil │ │ │ │ │ +000144f0: 6520 2f62 6f6f 742f 6772 7562 2f65 7861 e /boot/grub/exa │ │ │ │ │ +00014500: 6d70 6c65 2f74 6573 7432 2e63 6667 0a20 mple/test2.cfg. │ │ │ │ │ +00014510: 2020 2020 2020 2020 656c 7365 0a20 2020 else. │ │ │ │ │ +00014520: 2020 2020 2020 2020 2020 6563 686f 2022 echo " │ │ │ │ │ +00014530: 436f 756c 6420 6e6f 7420 6669 6e64 2061 Could not find a │ │ │ │ │ +00014540: 6e20 6578 616d 706c 6520 636f 6e66 6967 n example config │ │ │ │ │ +00014550: 7572 6174 696f 6e20 6669 6c65 2122 0a20 uration file!". │ │ │ │ │ +00014560: 2020 2020 2020 2020 6669 0a20 2020 2020 fi. │ │ │ │ │ +00014570: 6669 0a0a 2020 2054 6865 2065 6d62 6564 fi.. The embed │ │ │ │ │ +00014580: 6465 6420 636f 6e66 6967 7572 6174 696f ded configuratio │ │ │ │ │ +00014590: 6e20 6669 6c65 206d 6179 206e 6f74 2063 n file may not c │ │ │ │ │ +000145a0: 6f6e 7461 696e 206d 656e 7520 656e 7472 ontain menu entr │ │ │ │ │ +000145b0: 6965 730a 6469 7265 6374 6c79 2c20 6275 ies.directly, bu │ │ │ │ │ +000145c0: 7420 6d61 7920 6f6e 6c79 2072 6561 6420 t may only read │ │ │ │ │ +000145d0: 7468 656d 2066 726f 6d20 656c 7365 7768 them from elsewh │ │ │ │ │ +000145e0: 6572 6520 7573 696e 6720 2763 6f6e 6669 ere using 'confi │ │ │ │ │ +000145f0: 6766 696c 6527 2e0a 0a1f 0a46 696c 653a gfile'.....File: │ │ │ │ │ +00014600: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00014610: 653a 2054 6865 6d65 2066 696c 6520 666f e: Theme file fo │ │ │ │ │ +00014620: 726d 6174 2c20 204e 6578 743a 204e 6574 rmat, Next: Net │ │ │ │ │ +00014630: 776f 726b 2c20 2050 7265 763a 2043 6f6e work, Prev: Con │ │ │ │ │ +00014640: 6669 6775 7261 7469 6f6e 2c20 2055 703a figuration, Up: │ │ │ │ │ +00014650: 2054 6f70 0a0a 3720 5468 656d 6520 6669 Top..7 Theme fi │ │ │ │ │ +00014660: 6c65 2066 6f72 6d61 740a 2a2a 2a2a 2a2a le format.****** │ │ │ │ │ +00014670: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a37 *************..7 │ │ │ │ │ +00014680: 2e31 2049 6e74 726f 6475 6374 696f 6e0a .1 Introduction. │ │ │ │ │ +00014690: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +000146a0: 0a0a 5468 6520 4752 5542 2067 7261 7068 ..The GRUB graph │ │ │ │ │ +000146b0: 6963 616c 206d 656e 7520 7375 7070 6f72 ical menu suppor │ │ │ │ │ +000146c0: 7473 2074 6865 6d65 7320 7468 6174 2063 ts themes that c │ │ │ │ │ +000146d0: 616e 2063 7573 746f 6d69 7a65 2074 6865 an customize the │ │ │ │ │ +000146e0: 206c 6179 6f75 740a 616e 6420 6170 7065 layout.and appe │ │ │ │ │ +000146f0: 6172 616e 6365 206f 6620 7468 6520 4752 arance of the GR │ │ │ │ │ +00014700: 5542 2062 6f6f 7420 6d65 6e75 2e20 2054 UB boot menu. T │ │ │ │ │ +00014710: 6865 2074 6865 6d65 2069 7320 636f 6e66 he theme is conf │ │ │ │ │ +00014720: 6967 7572 6564 2074 6872 6f75 6768 2061 igured through a │ │ │ │ │ +00014730: 0a70 6c61 696e 2074 6578 7420 6669 6c65 .plain text file │ │ │ │ │ +00014740: 2074 6861 7420 7370 6563 6966 6965 7320 that specifies │ │ │ │ │ +00014750: 7468 6520 6c61 796f 7574 206f 6620 7468 the layout of th │ │ │ │ │ +00014760: 6520 7661 7269 6f75 7320 4755 4920 636f e various GUI co │ │ │ │ │ +00014770: 6d70 6f6e 656e 7473 0a28 696e 636c 7564 mponents.(includ │ │ │ │ │ +00014780: 696e 6720 7468 6520 626f 6f74 206d 656e ing the boot men │ │ │ │ │ +00014790: 752c 2074 696d 656f 7574 2070 726f 6772 u, timeout progr │ │ │ │ │ +000147a0: 6573 7320 6261 722c 2061 6e64 2074 6578 ess bar, and tex │ │ │ │ │ +000147b0: 7420 6d65 7373 6167 6573 2920 6173 0a77 t messages) as.w │ │ │ │ │ +000147c0: 656c 6c20 6173 2074 6865 2061 7070 6561 ell as the appea │ │ │ │ │ +000147d0: 7261 6e63 6520 7573 696e 6720 636f 6c6f rance using colo │ │ │ │ │ +000147e0: 7273 2c20 666f 6e74 732c 2061 6e64 2069 rs, fonts, and i │ │ │ │ │ +000147f0: 6d61 6765 732e 2020 4578 616d 706c 6520 mages. Example │ │ │ │ │ +00014800: 6973 0a61 7661 696c 6162 6c65 2069 6e20 is.available in │ │ │ │ │ +00014810: 646f 6373 2f65 7861 6d70 6c65 5f74 6865 docs/example_the │ │ │ │ │ +00014820: 6d65 2e74 7874 0a0a 372e 3220 5468 656d me.txt..7.2 Them │ │ │ │ │ +00014830: 6520 456c 656d 656e 7473 0a3d 3d3d 3d3d e Elements.===== │ │ │ │ │ +00014840: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a37 =============..7 │ │ │ │ │ +00014850: 2e32 2e31 2043 6f6c 6f72 730a 2d2d 2d2d .2.1 Colors.---- │ │ │ │ │ +00014860: 2d2d 2d2d 2d2d 2d2d 0a0a 436f 6c6f 7273 --------..Colors │ │ │ │ │ +00014870: 2063 616e 2062 6520 7370 6563 6966 6965 can be specifie │ │ │ │ │ +00014880: 6420 696e 2073 6576 6572 616c 2077 6179 d in several way │ │ │ │ │ +00014890: 733a 0a0a 2020 202a 2048 544d 4c2d 7374 s:.. * HTML-st │ │ │ │ │ +000148a0: 796c 6520 2223 5252 4747 4242 2220 6f72 yle "#RRGGBB" or │ │ │ │ │ +000148b0: 2022 2352 4742 2220 666f 726d 6174 2c20 "#RGB" format, │ │ │ │ │ +000148c0: 7768 6572 6520 2a52 2a2c 202a 472a 2c20 where *R*, *G*, │ │ │ │ │ +000148d0: 616e 6420 2a42 2a20 6172 650a 2020 2020 and *B* are. │ │ │ │ │ +000148e0: 2068 6578 6164 6563 696d 616c 2064 6967 hexadecimal dig │ │ │ │ │ +000148f0: 6974 7320 2865 2e67 2e2c 2022 2338 3839 its (e.g., "#889 │ │ │ │ │ +00014900: 3946 4622 290a 2020 202a 2061 7320 636f 9FF"). * as co │ │ │ │ │ +00014910: 6d6d 612d 7365 7061 7261 7465 6420 6465 mma-separated de │ │ │ │ │ +00014920: 6369 6d61 6c20 5247 4220 7661 6c75 6573 cimal RGB values │ │ │ │ │ +00014930: 2028 652e 672e 2c20 2231 3238 2c20 3132 (e.g., "128, 12 │ │ │ │ │ +00014940: 382c 2032 3535 2229 0a20 2020 2a20 7769 8, 255"). * wi │ │ │ │ │ +00014950: 7468 2022 5356 4720 312e 3020 636f 6c6f th "SVG 1.0 colo │ │ │ │ │ +00014960: 7220 6e61 6d65 7322 2028 652e 672e 2c20 r names" (e.g., │ │ │ │ │ +00014970: 2263 6f72 6e66 6c6f 7765 7262 6c75 6522 "cornflowerblue" │ │ │ │ │ +00014980: 2920 7768 6963 6820 6d75 7374 2062 650a ) which must be. │ │ │ │ │ +00014990: 2020 2020 2073 7065 6369 6669 6564 2069 specified i │ │ │ │ │ +000149a0: 6e20 6c6f 7765 7263 6173 652e 0a0a 372e n lowercase...7. │ │ │ │ │ +000149b0: 322e 3220 466f 6e74 730a 2d2d 2d2d 2d2d 2.2 Fonts.------ │ │ │ │ │ +000149c0: 2d2d 2d2d 2d0a 0a54 6865 2066 6f6e 7473 -----..The fonts │ │ │ │ │ +000149d0: 2047 5255 4220 7573 6573 2022 5046 4632 GRUB uses "PFF2 │ │ │ │ │ +000149e0: 2066 6f6e 7420 666f 726d 6174 2220 6269 font format" bi │ │ │ │ │ +000149f0: 746d 6170 2066 6f6e 7473 2e20 2046 6f6e tmap fonts. Fon │ │ │ │ │ +00014a00: 7473 2061 7265 0a73 7065 6369 6669 6564 ts are.specified │ │ │ │ │ +00014a10: 2077 6974 6820 6675 6c6c 2066 6f6e 7420 with full font │ │ │ │ │ +00014a20: 6e61 6d65 732e 2020 4375 7272 656e 746c names. Currentl │ │ │ │ │ +00014a30: 7920 7468 6572 6520 6973 206e 6f20 7072 y there is no pr │ │ │ │ │ +00014a40: 6f76 6973 696f 6e20 666f 7220 610a 7072 ovision for a.pr │ │ │ │ │ +00014a50: 6566 6572 656e 6365 206c 6973 7420 6f66 eference list of │ │ │ │ │ +00014a60: 2066 6f6e 7473 2c20 6f72 2064 6572 6976 fonts, or deriv │ │ │ │ │ +00014a70: 696e 6720 6f6e 6520 666f 6e74 2066 726f ing one font fro │ │ │ │ │ +00014a80: 6d20 616e 6f74 6865 722e 2020 466f 6e74 m another. Font │ │ │ │ │ +00014a90: 7320 6172 650a 6c6f 6164 6564 2077 6974 s are.loaded wit │ │ │ │ │ +00014aa0: 6820 7468 6520 226c 6f61 6466 6f6e 7422 h the "loadfont" │ │ │ │ │ +00014ab0: 2063 6f6d 6d61 6e64 2069 6e20 4752 5542 command in GRUB │ │ │ │ │ +00014ac0: 2028 2a6e 6f74 6520 6c6f 6164 666f 6e74 (*note loadfont │ │ │ │ │ +00014ad0: 3a3a 292e 2020 546f 2073 6565 0a74 6865 ::). To see.the │ │ │ │ │ +00014ae0: 206c 6973 7420 6f66 206c 6f61 6465 6420 list of loaded │ │ │ │ │ +00014af0: 666f 6e74 732c 2065 7865 6375 7465 2074 fonts, execute t │ │ │ │ │ +00014b00: 6865 2022 6c73 666f 6e74 7322 2063 6f6d he "lsfonts" com │ │ │ │ │ +00014b10: 6d61 6e64 2028 2a6e 6f74 650a 6c73 666f mand (*note.lsfo │ │ │ │ │ +00014b20: 6e74 733a 3a29 2e20 2049 6620 7468 6572 nts::). If ther │ │ │ │ │ +00014b30: 6520 6172 6520 746f 6f20 6d61 6e79 2066 e are too many f │ │ │ │ │ +00014b40: 6f6e 7473 2074 6f20 6669 7420 6f6e 2073 onts to fit on s │ │ │ │ │ +00014b50: 6372 6565 6e2c 2064 6f20 2273 6574 0a70 creen, do "set.p │ │ │ │ │ +00014b60: 6167 6572 3d31 2220 6265 666f 7265 2065 ager=1" before e │ │ │ │ │ +00014b70: 7865 6375 7469 6e67 2022 6c73 666f 6e74 xecuting "lsfont │ │ │ │ │ +00014b80: 7322 2e0a 0a37 2e32 2e33 2050 726f 6772 s"...7.2.3 Progr │ │ │ │ │ +00014b90: 6573 7320 4261 720a 2d2d 2d2d 2d2d 2d2d ess Bar.-------- │ │ │ │ │ +00014ba0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4669 6775 ----------..Figu │ │ │ │ │ +00014bb0: 7265 2037 2e31 0a0a 4669 6775 7265 2037 re 7.1..Figure 7 │ │ │ │ │ +00014bc0: 2e32 0a0a 5072 6f67 7265 7373 2062 6172 .2..Progress bar │ │ │ │ │ +00014bd0: 7320 6172 6520 7573 6564 2074 6f20 6469 s are used to di │ │ │ │ │ +00014be0: 7370 6c61 7920 7468 6520 7265 6d61 696e splay the remain │ │ │ │ │ +00014bf0: 696e 6720 7469 6d65 2062 6566 6f72 6520 ing time before │ │ │ │ │ +00014c00: 4752 5542 2062 6f6f 7473 0a74 6865 2064 GRUB boots.the d │ │ │ │ │ +00014c10: 6566 6175 6c74 206d 656e 7520 656e 7472 efault menu entr │ │ │ │ │ +00014c20: 792e 2020 546f 2063 7265 6174 6520 6120 y. To create a │ │ │ │ │ +00014c30: 7072 6f67 7265 7373 2062 6172 2074 6861 progress bar tha │ │ │ │ │ +00014c40: 7420 7769 6c6c 2064 6973 706c 6179 2074 t will display t │ │ │ │ │ +00014c50: 6865 0a72 656d 6169 6e69 6e67 2074 696d he.remaining tim │ │ │ │ │ +00014c60: 6520 6265 666f 7265 2061 7574 6f6d 6174 e before automat │ │ │ │ │ +00014c70: 6963 2062 6f6f 742c 2073 696d 706c 7920 ic boot, simply │ │ │ │ │ +00014c80: 6372 6561 7465 2061 2022 7072 6f67 7265 create a "progre │ │ │ │ │ +00014c90: 7373 5f62 6172 220a 636f 6d70 6f6e 656e ss_bar".componen │ │ │ │ │ +00014ca0: 7420 7769 7468 2074 6865 2069 6420 225f t with the id "_ │ │ │ │ │ +00014cb0: 5f74 696d 656f 7574 5f5f 222e 2020 5468 _timeout__". Th │ │ │ │ │ +00014cc0: 6973 2069 6e64 6963 6174 6573 2074 6f20 is indicates to │ │ │ │ │ +00014cd0: 4752 5542 2074 6861 7420 7468 650a 7072 GRUB that the.pr │ │ │ │ │ +00014ce0: 6f67 7265 7373 2062 6172 2073 686f 756c ogress bar shoul │ │ │ │ │ +00014cf0: 6420 6265 2075 7064 6174 6564 2061 7320 d be updated as │ │ │ │ │ +00014d00: 7469 6d65 2070 6173 7365 732c 2061 6e64 time passes, and │ │ │ │ │ +00014d10: 2069 7420 7368 6f75 6c64 2062 6520 6d61 it should be ma │ │ │ │ │ +00014d20: 6465 0a69 6e76 6973 6962 6c65 2069 6620 de.invisible if │ │ │ │ │ +00014d30: 7468 6520 636f 756e 7464 6f77 6e20 746f the countdown to │ │ │ │ │ +00014d40: 2061 7574 6f6d 6174 6963 2062 6f6f 7420 automatic boot │ │ │ │ │ +00014d50: 6973 2069 6e74 6572 7275 7074 6564 2062 is interrupted b │ │ │ │ │ +00014d60: 7920 7468 6520 7573 6572 2e0a 0a20 2020 y the user... │ │ │ │ │ +00014d70: 5072 6f67 7265 7373 2062 6172 7320 6d61 Progress bars ma │ │ │ │ │ +00014d80: 7920 6f70 7469 6f6e 616c 6c79 2068 6176 y optionally hav │ │ │ │ │ +00014d90: 6520 7465 7874 2064 6973 706c 6179 6564 e text displayed │ │ │ │ │ +00014da0: 206f 6e20 7468 656d 2e20 2054 6869 7320 on them. This │ │ │ │ │ +00014db0: 7465 7874 0a69 7320 636f 6e74 726f 6c6c text.is controll │ │ │ │ │ +00014dc0: 6564 2062 7920 7661 7269 6162 6c65 2022 ed by variable " │ │ │ │ │ +00014dd0: 7465 7874 2220 7768 6963 6820 636f 6e74 text" which cont │ │ │ │ │ +00014de0: 6169 6e73 2061 2070 7269 6e74 6620 7465 ains a printf te │ │ │ │ │ +00014df0: 6d70 6c61 7465 2077 6974 680a 7468 6520 mplate with.the │ │ │ │ │ +00014e00: 6f6e 6c79 2061 7267 756d 656e 7420 2564 only argument %d │ │ │ │ │ +00014e10: 2069 7320 7468 6520 6e75 6d62 6572 206f is the number o │ │ │ │ │ +00014e20: 6620 7365 636f 6e64 7320 7265 6d61 696e f seconds remain │ │ │ │ │ +00014e30: 696e 672e 2020 4164 6469 7469 6f6e 616c ing. Additional │ │ │ │ │ +00014e40: 6c79 0a73 7065 6369 616c 2076 616c 7565 ly.special value │ │ │ │ │ +00014e50: 7320 2240 5449 4d45 4f55 545f 4e4f 5449 s "@TIMEOUT_NOTI │ │ │ │ │ +00014e60: 4649 4341 5449 4f4e 5f53 484f 5254 4022 FICATION_SHORT@" │ │ │ │ │ +00014e70: 2c0a 2240 5449 4d45 4f55 545f 4e4f 5449 ,."@TIMEOUT_NOTI │ │ │ │ │ +00014e80: 4649 4341 5449 4f4e 5f4d 4944 444c 4540 FICATION_MIDDLE@ │ │ │ │ │ +00014e90: 222c 2022 4054 494d 454f 5554 5f4e 4f54 ", "@TIMEOUT_NOT │ │ │ │ │ +00014ea0: 4946 4943 4154 494f 4e5f 4c4f 4e47 4022 IFICATION_LONG@" │ │ │ │ │ +00014eb0: 2061 7265 0a72 6570 6c61 6365 6420 7769 are.replaced wi │ │ │ │ │ +00014ec0: 7468 2073 7461 6e64 6172 6420 616e 6420 th standard and │ │ │ │ │ +00014ed0: 7472 616e 736c 6174 6564 2074 656d 706c translated templ │ │ │ │ │ +00014ee0: 6174 6573 2e0a 0a37 2e32 2e34 2043 6972 ates...7.2.4 Cir │ │ │ │ │ +00014ef0: 6375 6c61 7220 5072 6f67 7265 7373 2049 cular Progress I │ │ │ │ │ +00014f00: 6e64 6963 6174 6f72 0a2d 2d2d 2d2d 2d2d ndicator.------- │ │ │ │ │ 00014f10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00014f20: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 6369 --------..The ci │ │ │ │ │ -00014f30: 7263 756c 6172 2070 726f 6772 6573 7320 rcular progress │ │ │ │ │ -00014f40: 696e 6469 6361 746f 7220 6675 6e63 7469 indicator functi │ │ │ │ │ -00014f50: 6f6e 7320 7369 6d69 6c61 726c 7920 746f ons similarly to │ │ │ │ │ -00014f60: 2074 6865 2070 726f 6772 6573 7320 6261 the progress ba │ │ │ │ │ -00014f70: 722e 0a57 6865 6e20 6769 7665 6e20 616e r..When given an │ │ │ │ │ -00014f80: 2069 6420 6f66 2022 5f5f 7469 6d65 6f75 id of "__timeou │ │ │ │ │ -00014f90: 745f 5f22 2c20 4752 5542 2075 7064 6174 t__", GRUB updat │ │ │ │ │ -00014fa0: 6573 2074 6865 2063 6972 6375 6c61 7220 es the circular │ │ │ │ │ -00014fb0: 7072 6f67 7265 7373 0a69 6e64 6963 6174 progress.indicat │ │ │ │ │ -00014fc0: 6f72 2773 2076 616c 7565 2074 6f20 696e or's value to in │ │ │ │ │ -00014fd0: 6469 6361 7465 2074 6865 2074 696d 6520 dicate the time │ │ │ │ │ -00014fe0: 7265 6d61 696e 696e 672e 2020 466f 7220 remaining. For │ │ │ │ │ -00014ff0: 7468 6520 6369 7263 756c 6172 0a70 726f the circular.pro │ │ │ │ │ -00015000: 6772 6573 7320 696e 6469 6361 746f 722c gress indicator, │ │ │ │ │ -00015010: 2074 6865 7265 2061 7265 2074 776f 2069 there are two i │ │ │ │ │ -00015020: 6d61 6765 7320 7573 6564 2074 6f20 7265 mages used to re │ │ │ │ │ -00015030: 6e64 6572 2069 743a 2074 6865 202a 6365 nder it: the *ce │ │ │ │ │ -00015040: 6e74 6572 2a0a 696d 6167 652c 2061 6e64 nter*.image, and │ │ │ │ │ -00015050: 2074 6865 202a 7469 636b 2a20 696d 6167 the *tick* imag │ │ │ │ │ -00015060: 652e 2020 5468 6520 6365 6e74 6572 2069 e. The center i │ │ │ │ │ -00015070: 6d61 6765 2069 7320 7265 6e64 6572 6564 mage is rendered │ │ │ │ │ -00015080: 2069 6e20 7468 6520 6365 6e74 6572 0a6f in the center.o │ │ │ │ │ -00015090: 6620 7468 6520 636f 6d70 6f6e 656e 742c f the component, │ │ │ │ │ -000150a0: 2077 6869 6c65 2074 6865 2074 6963 6b20 while the tick │ │ │ │ │ -000150b0: 696d 6167 6520 6973 2075 7365 6420 746f image is used to │ │ │ │ │ -000150c0: 2072 656e 6465 7220 6561 6368 206d 6172 render each mar │ │ │ │ │ -000150d0: 6b20 616c 6f6e 670a 7468 6520 6369 7263 k along.the circ │ │ │ │ │ -000150e0: 756d 6665 7265 6e63 6520 6f66 2074 6865 umference of the │ │ │ │ │ -000150f0: 2069 6e64 6963 6174 6f72 2e0a 0a37 2e32 indicator...7.2 │ │ │ │ │ -00015100: 2e35 204c 6162 656c 730a 2d2d 2d2d 2d2d .5 Labels.------ │ │ │ │ │ -00015110: 2d2d 2d2d 2d2d 0a0a 5465 7874 206c 6162 ------..Text lab │ │ │ │ │ -00015120: 656c 7320 6361 6e20 6265 2070 6c61 6365 els can be place │ │ │ │ │ -00015130: 6420 6f6e 2074 6865 2062 6f6f 7420 7363 d on the boot sc │ │ │ │ │ -00015140: 7265 656e 2e20 2054 6865 2066 6f6e 742c reen. The font, │ │ │ │ │ -00015150: 2063 6f6c 6f72 2c20 616e 640a 686f 7269 color, and.hori │ │ │ │ │ -00015160: 7a6f 6e74 616c 2061 6c69 676e 6d65 6e74 zontal alignment │ │ │ │ │ -00015170: 2063 616e 2062 6520 7370 6563 6966 6965 can be specifie │ │ │ │ │ -00015180: 6420 666f 7220 6c61 6265 6c73 2e20 2049 d for labels. I │ │ │ │ │ -00015190: 6620 6120 6c61 6265 6c20 6973 2067 6976 f a label is giv │ │ │ │ │ -000151a0: 656e 0a74 6865 2069 6420 225f 5f74 696d en.the id "__tim │ │ │ │ │ -000151b0: 656f 7574 5f5f 222c 2074 6865 6e20 7468 eout__", then th │ │ │ │ │ -000151c0: 6520 2274 6578 7422 2070 726f 7065 7274 e "text" propert │ │ │ │ │ -000151d0: 7920 666f 7220 7468 6174 206c 6162 656c y for that label │ │ │ │ │ -000151e0: 2069 7320 616c 736f 0a75 7064 6174 6564 is also.updated │ │ │ │ │ -000151f0: 2077 6974 6820 6120 6d65 7373 6167 6520 with a message │ │ │ │ │ -00015200: 696e 666f 726d 696e 6720 7468 6520 7573 informing the us │ │ │ │ │ -00015210: 6572 206f 6620 7468 6520 6e75 6d62 6572 er of the number │ │ │ │ │ -00015220: 206f 6620 7365 636f 6e64 730a 7265 6d61 of seconds.rema │ │ │ │ │ -00015230: 696e 696e 6720 756e 7469 6c20 6175 746f ining until auto │ │ │ │ │ -00015240: 6d61 7469 6320 626f 6f74 2e20 2054 6869 matic boot. Thi │ │ │ │ │ -00015250: 7320 6973 2075 7365 6675 6c20 696e 2063 s is useful in c │ │ │ │ │ -00015260: 6173 6520 796f 7520 7761 6e74 2074 6865 ase you want the │ │ │ │ │ -00015270: 0a74 6578 7420 6469 7370 6c61 7965 6420 .text displayed │ │ │ │ │ -00015280: 736f 6d65 7768 6572 6520 656c 7365 2069 somewhere else i │ │ │ │ │ -00015290: 6e73 7465 6164 206f 6620 6469 7265 6374 nstead of direct │ │ │ │ │ -000152a0: 6c79 206f 6e20 7468 6520 7072 6f67 7265 ly on the progre │ │ │ │ │ -000152b0: 7373 2062 6172 2e0a 0a37 2e32 2e36 2042 ss bar...7.2.6 B │ │ │ │ │ -000152c0: 6f6f 7420 4d65 6e75 0a2d 2d2d 2d2d 2d2d oot Menu.------- │ │ │ │ │ -000152d0: 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 626f --------..The bo │ │ │ │ │ -000152e0: 6f74 206d 656e 7520 7768 6572 6520 4752 ot menu where GR │ │ │ │ │ -000152f0: 5542 2064 6973 706c 6179 7320 7468 6520 UB displays the │ │ │ │ │ -00015300: 6d65 6e75 2065 6e74 7269 6573 2066 726f menu entries fro │ │ │ │ │ -00015310: 6d20 7468 6520 2267 7275 622e 6366 6722 m the "grub.cfg" │ │ │ │ │ -00015320: 0a66 696c 652e 2020 4974 2069 7320 6120 .file. It is a │ │ │ │ │ -00015330: 6c69 7374 206f 6620 6974 656d 732c 2077 list of items, w │ │ │ │ │ -00015340: 6865 7265 2065 6163 6820 6974 656d 2068 here each item h │ │ │ │ │ -00015350: 6173 2061 2074 6974 6c65 2061 6e64 2061 as a title and a │ │ │ │ │ -00015360: 6e0a 6f70 7469 6f6e 616c 2069 636f 6e2e n.optional icon. │ │ │ │ │ -00015370: 2020 5468 6520 6963 6f6e 2069 7320 7365 The icon is se │ │ │ │ │ -00015380: 6c65 6374 6564 2062 6173 6564 206f 6e20 lected based on │ │ │ │ │ -00015390: 7468 6520 2a63 6c61 7373 6573 2a20 7370 the *classes* sp │ │ │ │ │ -000153a0: 6563 6966 6965 640a 666f 7220 7468 6520 ecified.for the │ │ │ │ │ -000153b0: 6d65 6e75 2065 6e74 7279 2e20 2049 6620 menu entry. If │ │ │ │ │ -000153c0: 7468 6572 6520 6973 2061 2050 4e47 2066 there is a PNG f │ │ │ │ │ -000153d0: 696c 6520 6e61 6d65 6420 226d 7963 6c61 ile named "mycla │ │ │ │ │ -000153e0: 7373 2e70 6e67 2220 696e 2074 6865 0a22 ss.png" in the." │ │ │ │ │ -000153f0: 6772 7562 2f74 6865 6d65 732f 6963 6f6e grub/themes/icon │ │ │ │ │ -00015400: 7322 2064 6972 6563 746f 7279 2c20 6974 s" directory, it │ │ │ │ │ -00015410: 2077 696c 6c20 6265 2064 6973 706c 6179 will be display │ │ │ │ │ -00015420: 6564 2066 6f72 2069 7465 6d73 2077 6869 ed for items whi │ │ │ │ │ -00015430: 6368 2068 6176 650a 7468 6520 636c 6173 ch have.the clas │ │ │ │ │ -00015440: 7320 2a6d 7963 6c61 7373 2a2e 2020 5468 s *myclass*. Th │ │ │ │ │ -00015450: 6520 626f 6f74 206d 656e 7520 6361 6e20 e boot menu can │ │ │ │ │ -00015460: 6265 2063 7573 746f 6d69 7a65 6420 696e be customized in │ │ │ │ │ -00015470: 2073 6576 6572 616c 2077 6179 732c 0a73 several ways,.s │ │ │ │ │ -00015480: 7563 6820 6173 2074 6865 2066 6f6e 7420 uch as the font │ │ │ │ │ -00015490: 616e 6420 636f 6c6f 7220 7573 6564 2066 and color used f │ │ │ │ │ -000154a0: 6f72 2074 6865 206d 656e 7520 656e 7472 or the menu entr │ │ │ │ │ -000154b0: 7920 7469 746c 652c 2061 6e64 2062 790a y title, and by. │ │ │ │ │ -000154c0: 7370 6563 6966 7969 6e67 2073 7479 6c65 specifying style │ │ │ │ │ -000154d0: 6420 626f 7865 7320 666f 7220 7468 6520 d boxes for the │ │ │ │ │ -000154e0: 6d65 6e75 2069 7473 656c 6620 616e 6420 menu itself and │ │ │ │ │ -000154f0: 666f 7220 7468 6520 7365 6c65 6374 6564 for the selected │ │ │ │ │ -00015500: 2069 7465 6d0a 6869 6768 6c69 6768 742e item.highlight. │ │ │ │ │ -00015510: 0a0a 372e 322e 3720 5374 796c 6564 2042 ..7.2.7 Styled B │ │ │ │ │ -00015520: 6f78 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d oxes.----------- │ │ │ │ │ -00015530: 2d2d 2d2d 2d2d 2d0a 0a4f 6e65 206f 6620 -------..One of │ │ │ │ │ -00015540: 7468 6520 6d6f 7374 2069 6d70 6f72 7461 the most importa │ │ │ │ │ -00015550: 6e74 2066 6561 7475 7265 7320 666f 7220 nt features for │ │ │ │ │ -00015560: 6375 7374 6f6d 697a 696e 6720 7468 6520 customizing the │ │ │ │ │ -00015570: 6c61 796f 7574 2069 7320 7468 6520 7573 layout is the us │ │ │ │ │ -00015580: 650a 6f66 202a 7374 796c 6564 2062 6f78 e.of *styled box │ │ │ │ │ -00015590: 6573 2a2e 2020 4120 7374 796c 6564 2062 es*. A styled b │ │ │ │ │ -000155a0: 6f78 2069 7320 636f 6d70 6f73 6564 206f ox is composed o │ │ │ │ │ -000155b0: 6620 3920 7265 6374 616e 6775 6c61 7220 f 9 rectangular │ │ │ │ │ -000155c0: 2861 6e64 0a70 6f74 656e 7469 616c 6c79 (and.potentially │ │ │ │ │ -000155d0: 2065 6d70 7479 2920 7265 6769 6f6e 732c empty) regions, │ │ │ │ │ -000155e0: 2077 6869 6368 2061 7265 2075 7365 6420 which are used │ │ │ │ │ -000155f0: 746f 2073 6561 6d6c 6573 736c 7920 6472 to seamlessly dr │ │ │ │ │ -00015600: 6177 2074 6865 2073 7479 6c65 640a 626f aw the styled.bo │ │ │ │ │ -00015610: 7820 6f6e 2073 6372 6565 6e3a 0a0a 4e6f x on screen:..No │ │ │ │ │ -00015620: 7274 6877 6573 7420 286e 7729 2020 2020 rthwest (nw) │ │ │ │ │ -00015630: 2020 2020 204e 6f72 7468 2028 6e29 2020 North (n) │ │ │ │ │ -00015640: 2020 2020 2020 2020 2020 2020 4e6f 7274 Nort │ │ │ │ │ -00015650: 6865 6173 7420 286e 6529 0a57 6573 7420 heast (ne).West │ │ │ │ │ -00015660: 2877 2920 2020 2020 2020 2020 2020 2020 (w) │ │ │ │ │ -00015670: 2020 4365 6e74 6572 2028 6329 2020 2020 Center (c) │ │ │ │ │ -00015680: 2020 2020 2020 2020 2045 6173 7420 2865 East (e │ │ │ │ │ -00015690: 290a 536f 7574 6877 6573 7420 2873 7729 ).Southwest (sw) │ │ │ │ │ -000156a0: 2020 2020 2020 2020 2053 6f75 7468 2028 South ( │ │ │ │ │ -000156b0: 7329 2020 2020 2020 2020 2020 2020 2020 s) │ │ │ │ │ -000156c0: 536f 7574 6865 6173 7420 2873 6529 0a0a Southeast (se).. │ │ │ │ │ -000156d0: 2020 2054 6f20 7375 7070 6f72 7420 616e To support an │ │ │ │ │ -000156e0: 7920 7369 7a65 206f 6620 626f 7820 6f6e y size of box on │ │ │ │ │ -000156f0: 2073 6372 6565 6e2c 2074 6865 2063 656e screen, the cen │ │ │ │ │ -00015700: 7465 7220 736c 6963 6520 616e 6420 7468 ter slice and th │ │ │ │ │ -00015710: 6520 736c 6963 6573 0a66 6f72 2074 6865 e slices.for the │ │ │ │ │ -00015720: 2074 6f70 2c20 626f 7474 6f6d 2c20 616e top, bottom, an │ │ │ │ │ -00015730: 6420 7369 6465 7320 6172 6520 616c 6c20 d sides are all │ │ │ │ │ -00015740: 7363 616c 6564 2074 6f20 7468 6520 636f scaled to the co │ │ │ │ │ -00015750: 7272 6563 7420 7369 7a65 2066 6f72 0a74 rrect size for.t │ │ │ │ │ -00015760: 6865 2063 6f6d 706f 6e65 6e74 206f 6e20 he component on │ │ │ │ │ -00015770: 7363 7265 656e 2c20 7573 696e 6720 7468 screen, using th │ │ │ │ │ -00015780: 6520 666f 6c6c 6f77 696e 6720 7275 6c65 e following rule │ │ │ │ │ -00015790: 733a 0a0a 2020 312e 2054 6865 2065 6467 s:.. 1. The edg │ │ │ │ │ -000157a0: 6520 736c 6963 6573 2028 6e6f 7274 682c e slices (north, │ │ │ │ │ -000157b0: 2073 6f75 7468 2c20 6561 7374 2c20 616e south, east, an │ │ │ │ │ -000157c0: 6420 7765 7374 2920 6172 6520 7363 616c d west) are scal │ │ │ │ │ -000157d0: 6564 2069 6e20 7468 650a 2020 2020 2064 ed in the. d │ │ │ │ │ -000157e0: 6972 6563 7469 6f6e 206f 6620 7468 6520 irection of the │ │ │ │ │ -000157f0: 6564 6765 2074 6865 7920 6172 6520 6164 edge they are ad │ │ │ │ │ -00015800: 6a61 6365 6e74 2074 6f2e 2020 466f 7220 jacent to. For │ │ │ │ │ -00015810: 696e 7374 616e 6365 2c20 7468 6520 7765 instance, the we │ │ │ │ │ -00015820: 7374 0a20 2020 2020 736c 6963 6520 6973 st. slice is │ │ │ │ │ -00015830: 2073 6361 6c65 6420 7665 7274 6963 616c scaled vertical │ │ │ │ │ -00015840: 6c79 2e0a 2020 322e 2054 6865 2063 6f72 ly.. 2. The cor │ │ │ │ │ -00015850: 6e65 7220 736c 6963 6573 2028 6e6f 7274 ner slices (nort │ │ │ │ │ -00015860: 6877 6573 742c 206e 6f72 7468 6561 7374 hwest, northeast │ │ │ │ │ -00015870: 2c20 736f 7574 6865 6173 742c 2061 6e64 , southeast, and │ │ │ │ │ -00015880: 2073 6f75 7468 7765 7374 290a 2020 2020 southwest). │ │ │ │ │ -00015890: 2061 7265 206e 6f74 2073 6361 6c65 642e are not scaled. │ │ │ │ │ -000158a0: 0a20 2033 2e20 5468 6520 6365 6e74 6572 . 3. The center │ │ │ │ │ -000158b0: 2073 6c69 6365 2069 7320 7363 616c 6564 slice is scaled │ │ │ │ │ -000158c0: 2074 6f20 6669 6c6c 2074 6865 2072 656d to fill the rem │ │ │ │ │ -000158d0: 6169 6e69 6e67 2073 7061 6365 2069 6e20 aining space in │ │ │ │ │ -000158e0: 7468 650a 2020 2020 206d 6964 646c 652e the. middle. │ │ │ │ │ -000158f0: 0a0a 2020 2041 7320 616e 2065 7861 6d70 .. As an examp │ │ │ │ │ -00015900: 6c65 206f 6620 686f 7720 616e 2069 6d61 le of how an ima │ │ │ │ │ -00015910: 6765 206d 6967 6874 2062 6520 736c 6963 ge might be slic │ │ │ │ │ -00015920: 6564 2075 702c 2063 6f6e 7369 6465 7220 ed up, consider │ │ │ │ │ -00015930: 7468 6520 7374 796c 6564 0a62 6f78 2075 the styled.box u │ │ │ │ │ -00015940: 7365 6420 666f 7220 6120 7465 726d 696e sed for a termin │ │ │ │ │ -00015950: 616c 2076 6965 772e 0a0a 4669 6775 7265 al view...Figure │ │ │ │ │ -00015960: 2037 2e33 0a0a 372e 322e 3820 4372 6561 7.3..7.2.8 Crea │ │ │ │ │ -00015970: 7469 6e67 2053 7479 6c65 6420 426f 7820 ting Styled Box │ │ │ │ │ -00015980: 496d 6167 6573 0a2d 2d2d 2d2d 2d2d 2d2d Images.--------- │ │ │ │ │ +00014f20: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 ----------..The │ │ │ │ │ +00014f30: 6369 7263 756c 6172 2070 726f 6772 6573 circular progres │ │ │ │ │ +00014f40: 7320 696e 6469 6361 746f 7220 6675 6e63 s indicator func │ │ │ │ │ +00014f50: 7469 6f6e 7320 7369 6d69 6c61 726c 7920 tions similarly │ │ │ │ │ +00014f60: 746f 2074 6865 2070 726f 6772 6573 7320 to the progress │ │ │ │ │ +00014f70: 6261 722e 0a57 6865 6e20 6769 7665 6e20 bar..When given │ │ │ │ │ +00014f80: 616e 2069 6420 6f66 2022 5f5f 7469 6d65 an id of "__time │ │ │ │ │ +00014f90: 6f75 745f 5f22 2c20 4752 5542 2075 7064 out__", GRUB upd │ │ │ │ │ +00014fa0: 6174 6573 2074 6865 2063 6972 6375 6c61 ates the circula │ │ │ │ │ +00014fb0: 7220 7072 6f67 7265 7373 0a69 6e64 6963 r progress.indic │ │ │ │ │ +00014fc0: 6174 6f72 2773 2076 616c 7565 2074 6f20 ator's value to │ │ │ │ │ +00014fd0: 696e 6469 6361 7465 2074 6865 2074 696d indicate the tim │ │ │ │ │ +00014fe0: 6520 7265 6d61 696e 696e 672e 2020 466f e remaining. Fo │ │ │ │ │ +00014ff0: 7220 7468 6520 6369 7263 756c 6172 0a70 r the circular.p │ │ │ │ │ +00015000: 726f 6772 6573 7320 696e 6469 6361 746f rogress indicato │ │ │ │ │ +00015010: 722c 2074 6865 7265 2061 7265 2074 776f r, there are two │ │ │ │ │ +00015020: 2069 6d61 6765 7320 7573 6564 2074 6f20 images used to │ │ │ │ │ +00015030: 7265 6e64 6572 2069 743a 2074 6865 202a render it: the * │ │ │ │ │ +00015040: 6365 6e74 6572 2a0a 696d 6167 652c 2061 center*.image, a │ │ │ │ │ +00015050: 6e64 2074 6865 202a 7469 636b 2a20 696d nd the *tick* im │ │ │ │ │ +00015060: 6167 652e 2020 5468 6520 6365 6e74 6572 age. The center │ │ │ │ │ +00015070: 2069 6d61 6765 2069 7320 7265 6e64 6572 image is render │ │ │ │ │ +00015080: 6564 2069 6e20 7468 6520 6365 6e74 6572 ed in the center │ │ │ │ │ +00015090: 0a6f 6620 7468 6520 636f 6d70 6f6e 656e .of the componen │ │ │ │ │ +000150a0: 742c 2077 6869 6c65 2074 6865 2074 6963 t, while the tic │ │ │ │ │ +000150b0: 6b20 696d 6167 6520 6973 2075 7365 6420 k image is used │ │ │ │ │ +000150c0: 746f 2072 656e 6465 7220 6561 6368 206d to render each m │ │ │ │ │ +000150d0: 6172 6b20 616c 6f6e 670a 7468 6520 6369 ark along.the ci │ │ │ │ │ +000150e0: 7263 756d 6665 7265 6e63 6520 6f66 2074 rcumference of t │ │ │ │ │ +000150f0: 6865 2069 6e64 6963 6174 6f72 2e0a 0a37 he indicator...7 │ │ │ │ │ +00015100: 2e32 2e35 204c 6162 656c 730a 2d2d 2d2d .2.5 Labels.---- │ │ │ │ │ +00015110: 2d2d 2d2d 2d2d 2d2d 0a0a 5465 7874 206c --------..Text l │ │ │ │ │ +00015120: 6162 656c 7320 6361 6e20 6265 2070 6c61 abels can be pla │ │ │ │ │ +00015130: 6365 6420 6f6e 2074 6865 2062 6f6f 7420 ced on the boot │ │ │ │ │ +00015140: 7363 7265 656e 2e20 2054 6865 2066 6f6e screen. The fon │ │ │ │ │ +00015150: 742c 2063 6f6c 6f72 2c20 616e 640a 686f t, color, and.ho │ │ │ │ │ +00015160: 7269 7a6f 6e74 616c 2061 6c69 676e 6d65 rizontal alignme │ │ │ │ │ +00015170: 6e74 2063 616e 2062 6520 7370 6563 6966 nt can be specif │ │ │ │ │ +00015180: 6965 6420 666f 7220 6c61 6265 6c73 2e20 ied for labels. │ │ │ │ │ +00015190: 2049 6620 6120 6c61 6265 6c20 6973 2067 If a label is g │ │ │ │ │ +000151a0: 6976 656e 0a74 6865 2069 6420 225f 5f74 iven.the id "__t │ │ │ │ │ +000151b0: 696d 656f 7574 5f5f 222c 2074 6865 6e20 imeout__", then │ │ │ │ │ +000151c0: 7468 6520 2274 6578 7422 2070 726f 7065 the "text" prope │ │ │ │ │ +000151d0: 7274 7920 666f 7220 7468 6174 206c 6162 rty for that lab │ │ │ │ │ +000151e0: 656c 2069 7320 616c 736f 0a75 7064 6174 el is also.updat │ │ │ │ │ +000151f0: 6564 2077 6974 6820 6120 6d65 7373 6167 ed with a messag │ │ │ │ │ +00015200: 6520 696e 666f 726d 696e 6720 7468 6520 e informing the │ │ │ │ │ +00015210: 7573 6572 206f 6620 7468 6520 6e75 6d62 user of the numb │ │ │ │ │ +00015220: 6572 206f 6620 7365 636f 6e64 730a 7265 er of seconds.re │ │ │ │ │ +00015230: 6d61 696e 696e 6720 756e 7469 6c20 6175 maining until au │ │ │ │ │ +00015240: 746f 6d61 7469 6320 626f 6f74 2e20 2054 tomatic boot. T │ │ │ │ │ +00015250: 6869 7320 6973 2075 7365 6675 6c20 696e his is useful in │ │ │ │ │ +00015260: 2063 6173 6520 796f 7520 7761 6e74 2074 case you want t │ │ │ │ │ +00015270: 6865 0a74 6578 7420 6469 7370 6c61 7965 he.text displaye │ │ │ │ │ +00015280: 6420 736f 6d65 7768 6572 6520 656c 7365 d somewhere else │ │ │ │ │ +00015290: 2069 6e73 7465 6164 206f 6620 6469 7265 instead of dire │ │ │ │ │ +000152a0: 6374 6c79 206f 6e20 7468 6520 7072 6f67 ctly on the prog │ │ │ │ │ +000152b0: 7265 7373 2062 6172 2e0a 0a37 2e32 2e36 ress bar...7.2.6 │ │ │ │ │ +000152c0: 2042 6f6f 7420 4d65 6e75 0a2d 2d2d 2d2d Boot Menu.----- │ │ │ │ │ +000152d0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6520 ----------..The │ │ │ │ │ +000152e0: 626f 6f74 206d 656e 7520 7768 6572 6520 boot menu where │ │ │ │ │ +000152f0: 4752 5542 2064 6973 706c 6179 7320 7468 GRUB displays th │ │ │ │ │ +00015300: 6520 6d65 6e75 2065 6e74 7269 6573 2066 e menu entries f │ │ │ │ │ +00015310: 726f 6d20 7468 6520 2267 7275 622e 6366 rom the "grub.cf │ │ │ │ │ +00015320: 6722 0a66 696c 652e 2020 4974 2069 7320 g".file. It is │ │ │ │ │ +00015330: 6120 6c69 7374 206f 6620 6974 656d 732c a list of items, │ │ │ │ │ +00015340: 2077 6865 7265 2065 6163 6820 6974 656d where each item │ │ │ │ │ +00015350: 2068 6173 2061 2074 6974 6c65 2061 6e64 has a title and │ │ │ │ │ +00015360: 2061 6e0a 6f70 7469 6f6e 616c 2069 636f an.optional ico │ │ │ │ │ +00015370: 6e2e 2020 5468 6520 6963 6f6e 2069 7320 n. The icon is │ │ │ │ │ +00015380: 7365 6c65 6374 6564 2062 6173 6564 206f selected based o │ │ │ │ │ +00015390: 6e20 7468 6520 2a63 6c61 7373 6573 2a20 n the *classes* │ │ │ │ │ +000153a0: 7370 6563 6966 6965 640a 666f 7220 7468 specified.for th │ │ │ │ │ +000153b0: 6520 6d65 6e75 2065 6e74 7279 2e20 2049 e menu entry. I │ │ │ │ │ +000153c0: 6620 7468 6572 6520 6973 2061 2050 4e47 f there is a PNG │ │ │ │ │ +000153d0: 2066 696c 6520 6e61 6d65 6420 226d 7963 file named "myc │ │ │ │ │ +000153e0: 6c61 7373 2e70 6e67 2220 696e 2074 6865 lass.png" in the │ │ │ │ │ +000153f0: 0a22 6772 7562 2f74 6865 6d65 732f 6963 ."grub/themes/ic │ │ │ │ │ +00015400: 6f6e 7322 2064 6972 6563 746f 7279 2c20 ons" directory, │ │ │ │ │ +00015410: 6974 2077 696c 6c20 6265 2064 6973 706c it will be displ │ │ │ │ │ +00015420: 6179 6564 2066 6f72 2069 7465 6d73 2077 ayed for items w │ │ │ │ │ +00015430: 6869 6368 2068 6176 650a 7468 6520 636c hich have.the cl │ │ │ │ │ +00015440: 6173 7320 2a6d 7963 6c61 7373 2a2e 2020 ass *myclass*. │ │ │ │ │ +00015450: 5468 6520 626f 6f74 206d 656e 7520 6361 The boot menu ca │ │ │ │ │ +00015460: 6e20 6265 2063 7573 746f 6d69 7a65 6420 n be customized │ │ │ │ │ +00015470: 696e 2073 6576 6572 616c 2077 6179 732c in several ways, │ │ │ │ │ +00015480: 0a73 7563 6820 6173 2074 6865 2066 6f6e .such as the fon │ │ │ │ │ +00015490: 7420 616e 6420 636f 6c6f 7220 7573 6564 t and color used │ │ │ │ │ +000154a0: 2066 6f72 2074 6865 206d 656e 7520 656e for the menu en │ │ │ │ │ +000154b0: 7472 7920 7469 746c 652c 2061 6e64 2062 try title, and b │ │ │ │ │ +000154c0: 790a 7370 6563 6966 7969 6e67 2073 7479 y.specifying sty │ │ │ │ │ +000154d0: 6c65 6420 626f 7865 7320 666f 7220 7468 led boxes for th │ │ │ │ │ +000154e0: 6520 6d65 6e75 2069 7473 656c 6620 616e e menu itself an │ │ │ │ │ +000154f0: 6420 666f 7220 7468 6520 7365 6c65 6374 d for the select │ │ │ │ │ +00015500: 6564 2069 7465 6d0a 6869 6768 6c69 6768 ed item.highligh │ │ │ │ │ +00015510: 742e 0a0a 372e 322e 3720 5374 796c 6564 t...7.2.7 Styled │ │ │ │ │ +00015520: 2042 6f78 6573 0a2d 2d2d 2d2d 2d2d 2d2d Boxes.--------- │ │ │ │ │ +00015530: 2d2d 2d2d 2d2d 2d2d 2d0a 0a4f 6e65 206f ---------..One o │ │ │ │ │ +00015540: 6620 7468 6520 6d6f 7374 2069 6d70 6f72 f the most impor │ │ │ │ │ +00015550: 7461 6e74 2066 6561 7475 7265 7320 666f tant features fo │ │ │ │ │ +00015560: 7220 6375 7374 6f6d 697a 696e 6720 7468 r customizing th │ │ │ │ │ +00015570: 6520 6c61 796f 7574 2069 7320 7468 6520 e layout is the │ │ │ │ │ +00015580: 7573 650a 6f66 202a 7374 796c 6564 2062 use.of *styled b │ │ │ │ │ +00015590: 6f78 6573 2a2e 2020 4120 7374 796c 6564 oxes*. A styled │ │ │ │ │ +000155a0: 2062 6f78 2069 7320 636f 6d70 6f73 6564 box is composed │ │ │ │ │ +000155b0: 206f 6620 3920 7265 6374 616e 6775 6c61 of 9 rectangula │ │ │ │ │ +000155c0: 7220 2861 6e64 0a70 6f74 656e 7469 616c r (and.potential │ │ │ │ │ +000155d0: 6c79 2065 6d70 7479 2920 7265 6769 6f6e ly empty) region │ │ │ │ │ +000155e0: 732c 2077 6869 6368 2061 7265 2075 7365 s, which are use │ │ │ │ │ +000155f0: 6420 746f 2073 6561 6d6c 6573 736c 7920 d to seamlessly │ │ │ │ │ +00015600: 6472 6177 2074 6865 2073 7479 6c65 640a draw the styled. │ │ │ │ │ +00015610: 626f 7820 6f6e 2073 6372 6565 6e3a 0a0a box on screen:.. │ │ │ │ │ +00015620: 4e6f 7274 6877 6573 7420 286e 7729 2020 Northwest (nw) │ │ │ │ │ +00015630: 2020 2020 2020 204e 6f72 7468 2028 6e29 North (n) │ │ │ │ │ +00015640: 2020 2020 2020 2020 2020 2020 2020 4e6f No │ │ │ │ │ +00015650: 7274 6865 6173 7420 286e 6529 0a57 6573 rtheast (ne).Wes │ │ │ │ │ +00015660: 7420 2877 2920 2020 2020 2020 2020 2020 t (w) │ │ │ │ │ +00015670: 2020 2020 4365 6e74 6572 2028 6329 2020 Center (c) │ │ │ │ │ +00015680: 2020 2020 2020 2020 2020 2045 6173 7420 East │ │ │ │ │ +00015690: 2865 290a 536f 7574 6877 6573 7420 2873 (e).Southwest (s │ │ │ │ │ +000156a0: 7729 2020 2020 2020 2020 2053 6f75 7468 w) South │ │ │ │ │ +000156b0: 2028 7329 2020 2020 2020 2020 2020 2020 (s) │ │ │ │ │ +000156c0: 2020 536f 7574 6865 6173 7420 2873 6529 Southeast (se) │ │ │ │ │ +000156d0: 0a0a 2020 2054 6f20 7375 7070 6f72 7420 .. To support │ │ │ │ │ +000156e0: 616e 7920 7369 7a65 206f 6620 626f 7820 any size of box │ │ │ │ │ +000156f0: 6f6e 2073 6372 6565 6e2c 2074 6865 2063 on screen, the c │ │ │ │ │ +00015700: 656e 7465 7220 736c 6963 6520 616e 6420 enter slice and │ │ │ │ │ +00015710: 7468 6520 736c 6963 6573 0a66 6f72 2074 the slices.for t │ │ │ │ │ +00015720: 6865 2074 6f70 2c20 626f 7474 6f6d 2c20 he top, bottom, │ │ │ │ │ +00015730: 616e 6420 7369 6465 7320 6172 6520 616c and sides are al │ │ │ │ │ +00015740: 6c20 7363 616c 6564 2074 6f20 7468 6520 l scaled to the │ │ │ │ │ +00015750: 636f 7272 6563 7420 7369 7a65 2066 6f72 correct size for │ │ │ │ │ +00015760: 0a74 6865 2063 6f6d 706f 6e65 6e74 206f .the component o │ │ │ │ │ +00015770: 6e20 7363 7265 656e 2c20 7573 696e 6720 n screen, using │ │ │ │ │ +00015780: 7468 6520 666f 6c6c 6f77 696e 6720 7275 the following ru │ │ │ │ │ +00015790: 6c65 733a 0a0a 2020 312e 2054 6865 2065 les:.. 1. The e │ │ │ │ │ +000157a0: 6467 6520 736c 6963 6573 2028 6e6f 7274 dge slices (nort │ │ │ │ │ +000157b0: 682c 2073 6f75 7468 2c20 6561 7374 2c20 h, south, east, │ │ │ │ │ +000157c0: 616e 6420 7765 7374 2920 6172 6520 7363 and west) are sc │ │ │ │ │ +000157d0: 616c 6564 2069 6e20 7468 650a 2020 2020 aled in the. │ │ │ │ │ +000157e0: 2064 6972 6563 7469 6f6e 206f 6620 7468 direction of th │ │ │ │ │ +000157f0: 6520 6564 6765 2074 6865 7920 6172 6520 e edge they are │ │ │ │ │ +00015800: 6164 6a61 6365 6e74 2074 6f2e 2020 466f adjacent to. Fo │ │ │ │ │ +00015810: 7220 696e 7374 616e 6365 2c20 7468 6520 r instance, the │ │ │ │ │ +00015820: 7765 7374 0a20 2020 2020 736c 6963 6520 west. slice │ │ │ │ │ +00015830: 6973 2073 6361 6c65 6420 7665 7274 6963 is scaled vertic │ │ │ │ │ +00015840: 616c 6c79 2e0a 2020 322e 2054 6865 2063 ally.. 2. The c │ │ │ │ │ +00015850: 6f72 6e65 7220 736c 6963 6573 2028 6e6f orner slices (no │ │ │ │ │ +00015860: 7274 6877 6573 742c 206e 6f72 7468 6561 rthwest, northea │ │ │ │ │ +00015870: 7374 2c20 736f 7574 6865 6173 742c 2061 st, southeast, a │ │ │ │ │ +00015880: 6e64 2073 6f75 7468 7765 7374 290a 2020 nd southwest). │ │ │ │ │ +00015890: 2020 2061 7265 206e 6f74 2073 6361 6c65 are not scale │ │ │ │ │ +000158a0: 642e 0a20 2033 2e20 5468 6520 6365 6e74 d.. 3. The cent │ │ │ │ │ +000158b0: 6572 2073 6c69 6365 2069 7320 7363 616c er slice is scal │ │ │ │ │ +000158c0: 6564 2074 6f20 6669 6c6c 2074 6865 2072 ed to fill the r │ │ │ │ │ +000158d0: 656d 6169 6e69 6e67 2073 7061 6365 2069 emaining space i │ │ │ │ │ +000158e0: 6e20 7468 650a 2020 2020 206d 6964 646c n the. middl │ │ │ │ │ +000158f0: 652e 0a0a 2020 2041 7320 616e 2065 7861 e... As an exa │ │ │ │ │ +00015900: 6d70 6c65 206f 6620 686f 7720 616e 2069 mple of how an i │ │ │ │ │ +00015910: 6d61 6765 206d 6967 6874 2062 6520 736c mage might be sl │ │ │ │ │ +00015920: 6963 6564 2075 702c 2063 6f6e 7369 6465 iced up, conside │ │ │ │ │ +00015930: 7220 7468 6520 7374 796c 6564 0a62 6f78 r the styled.box │ │ │ │ │ +00015940: 2075 7365 6420 666f 7220 6120 7465 726d used for a term │ │ │ │ │ +00015950: 696e 616c 2076 6965 772e 0a0a 4669 6775 inal view...Figu │ │ │ │ │ +00015960: 7265 2037 2e33 0a0a 372e 322e 3820 4372 re 7.3..7.2.8 Cr │ │ │ │ │ +00015970: 6561 7469 6e67 2053 7479 6c65 6420 426f eating Styled Bo │ │ │ │ │ +00015980: 7820 496d 6167 6573 0a2d 2d2d 2d2d 2d2d x Images.------- │ │ │ │ │ 00015990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000159a0: 2d2d 2d2d 2d2d 2d0a 0a54 6865 2049 6e6b -------..The Ink │ │ │ │ │ -000159b0: 7363 6170 655f 2073 6361 6c61 626c 6520 scape_ scalable │ │ │ │ │ -000159c0: 7665 6374 6f72 2067 7261 7068 6963 7320 vector graphics │ │ │ │ │ -000159d0: 6564 6974 6f72 2069 7320 6120 7665 7279 editor is a very │ │ │ │ │ -000159e0: 2075 7365 6675 6c20 746f 6f6c 2066 6f72 useful tool for │ │ │ │ │ -000159f0: 0a63 7265 6174 696e 6720 7374 796c 6564 .creating styled │ │ │ │ │ -00015a00: 2062 6f78 2069 6d61 6765 732e 2020 4f6e box images. On │ │ │ │ │ -00015a10: 6520 7072 6f63 6573 7320 7468 6174 2077 e process that w │ │ │ │ │ -00015a20: 6f72 6b73 2077 656c 6c20 666f 7220 736c orks well for sl │ │ │ │ │ -00015a30: 6963 696e 6720 610a 6472 6177 696e 6720 icing a.drawing │ │ │ │ │ -00015a40: 696e 746f 2074 6865 206e 6563 6573 7361 into the necessa │ │ │ │ │ -00015a50: 7279 2069 6d61 6765 2073 6c69 6365 7320 ry image slices │ │ │ │ │ -00015a60: 6973 3a0a 0a20 2031 2e20 4372 6561 7465 is:.. 1. Create │ │ │ │ │ -00015a70: 206f 7220 6f70 656e 2074 6865 2064 7261 or open the dra │ │ │ │ │ -00015a80: 7769 6e67 2079 6f75 2764 206c 696b 6520 wing you'd like │ │ │ │ │ -00015a90: 7573 652e 0a20 2032 2e20 4372 6561 7465 use.. 2. Create │ │ │ │ │ -00015aa0: 2061 206e 6577 206c 6179 6572 206f 6e20 a new layer on │ │ │ │ │ -00015ab0: 7468 6520 746f 7020 6f66 2074 6865 206c the top of the l │ │ │ │ │ -00015ac0: 6179 6572 2073 7461 636b 2e20 204d 616b ayer stack. Mak │ │ │ │ │ -00015ad0: 6520 6974 2076 6973 6962 6c65 2e0a 2020 e it visible.. │ │ │ │ │ -00015ae0: 2020 2053 656c 6563 7420 7468 6973 206c Select this l │ │ │ │ │ -00015af0: 6179 6572 2061 7320 7468 6520 6375 7272 ayer as the curr │ │ │ │ │ -00015b00: 656e 7420 6c61 7965 722e 0a20 2033 2e20 ent layer.. 3. │ │ │ │ │ -00015b10: 4472 6177 2039 2072 6563 7461 6e67 6c65 Draw 9 rectangle │ │ │ │ │ -00015b20: 7320 6f6e 2079 6f75 7220 6472 6177 696e s on your drawin │ │ │ │ │ -00015b30: 6720 7768 6572 6520 796f 7527 6420 6c69 g where you'd li │ │ │ │ │ -00015b40: 6b65 2074 6865 2073 6c69 6365 7320 746f ke the slices to │ │ │ │ │ -00015b50: 0a20 2020 2020 6265 2e20 2043 6c65 6172 . be. Clear │ │ │ │ │ -00015b60: 2074 6865 2066 696c 6c20 6f70 7469 6f6e the fill option │ │ │ │ │ -00015b70: 2c20 616e 6420 7365 7420 7468 6520 7374 , and set the st │ │ │ │ │ -00015b80: 726f 6b65 2074 6f20 3120 7069 7865 6c20 roke to 1 pixel │ │ │ │ │ -00015b90: 7769 6465 0a20 2020 2020 736f 6c69 6420 wide. solid │ │ │ │ │ -00015ba0: 7374 726f 6b65 2e20 2054 6865 2063 6f72 stroke. The cor │ │ │ │ │ -00015bb0: 6e65 7273 206f 6620 7468 6520 736c 6963 ners of the slic │ │ │ │ │ -00015bc0: 6573 206d 7573 7420 6d65 6574 2070 7265 es must meet pre │ │ │ │ │ -00015bd0: 6369 7365 6c79 3b20 6966 2069 740a 2020 cisely; if it. │ │ │ │ │ -00015be0: 2020 2069 7320 6f66 6620 6279 2061 2073 is off by a s │ │ │ │ │ -00015bf0: 696e 676c 6520 7069 7865 6c2c 2069 7420 ingle pixel, it │ │ │ │ │ -00015c00: 7769 6c6c 2070 726f 6261 626c 7920 6265 will probably be │ │ │ │ │ -00015c10: 2065 7669 6465 6e74 2077 6865 6e20 7468 evident when th │ │ │ │ │ -00015c20: 650a 2020 2020 2073 7479 6c65 6420 626f e. styled bo │ │ │ │ │ -00015c30: 7820 6973 2072 656e 6465 7265 6420 696e x is rendered in │ │ │ │ │ -00015c40: 2074 6865 2047 5255 4220 6d65 6e75 2e20 the GRUB menu. │ │ │ │ │ -00015c50: 2059 6f75 2073 686f 756c 6420 7072 6f62 You should prob │ │ │ │ │ -00015c60: 6162 6c79 2067 6f20 746f 0a20 2020 2020 ably go to. │ │ │ │ │ -00015c70: 4669 6c65 207c 2044 6f63 756d 656e 7420 File | Document │ │ │ │ │ -00015c80: 5072 6f70 6572 7469 6573 207c 2047 7269 Properties | Gri │ │ │ │ │ -00015c90: 6473 2061 6e64 2065 6e61 626c 6520 6120 ds and enable a │ │ │ │ │ -00015ca0: 6772 6964 206f 7220 6372 6561 7465 2061 grid or create a │ │ │ │ │ -00015cb0: 0a20 2020 2020 6775 6964 6520 2863 6c69 . guide (cli │ │ │ │ │ -00015cc0: 636b 206f 6e20 6f6e 6520 6f66 2074 6865 ck on one of the │ │ │ │ │ -00015cd0: 2072 756c 6572 7320 6e65 7874 2074 6f20 rulers next to │ │ │ │ │ -00015ce0: 7468 6520 6472 6177 696e 6720 616e 6420 the drawing and │ │ │ │ │ -00015cf0: 6472 6167 206f 7665 720a 2020 2020 2074 drag over. t │ │ │ │ │ -00015d00: 6865 2064 7261 7769 6e67 3b20 7265 6c65 he drawing; rele │ │ │ │ │ -00015d10: 6173 6520 7468 6520 6d6f 7573 6520 6275 ase the mouse bu │ │ │ │ │ -00015d20: 7474 6f6e 2074 6f20 706c 6163 6520 7468 tton to place th │ │ │ │ │ -00015d30: 6520 6775 6964 6529 2074 6f20 6865 6c70 e guide) to help │ │ │ │ │ -00015d40: 0a20 2020 2020 706c 6163 6520 7468 6520 . place the │ │ │ │ │ -00015d50: 7265 6374 616e 676c 6573 2070 7265 6369 rectangles preci │ │ │ │ │ -00015d60: 7365 6c79 2e0a 2020 342e 2052 6967 6874 sely.. 4. Right │ │ │ │ │ -00015d70: 2063 6c69 636b 206f 6e20 7468 6520 6365 click on the ce │ │ │ │ │ -00015d80: 6e74 6572 2073 6c69 6365 2072 6563 7461 nter slice recta │ │ │ │ │ -00015d90: 6e67 6c65 2061 6e64 2063 686f 6f73 6520 ngle and choose │ │ │ │ │ -00015da0: 4f62 6a65 6374 0a20 2020 2020 5072 6f70 Object. Prop │ │ │ │ │ -00015db0: 6572 7469 6573 2e20 2043 6861 6e67 6520 erties. Change │ │ │ │ │ -00015dc0: 7468 6520 2249 6422 2074 6f20 2273 6c69 the "Id" to "sli │ │ │ │ │ -00015dd0: 6365 5f63 2220 616e 6420 636c 6963 6b20 ce_c" and click │ │ │ │ │ -00015de0: 5365 742e 2020 5265 7065 6174 0a20 2020 Set. Repeat. │ │ │ │ │ -00015df0: 2020 7468 6973 2066 6f72 2074 6865 2072 this for the r │ │ │ │ │ -00015e00: 656d 6169 6e69 6e67 2038 2072 6563 7461 emaining 8 recta │ │ │ │ │ -00015e10: 6e67 6c65 732c 2067 6976 696e 6720 7468 ngles, giving th │ │ │ │ │ -00015e20: 656d 2049 6420 7661 6c75 6573 206f 660a em Id values of. │ │ │ │ │ -00015e30: 2020 2020 2022 736c 6963 655f 6e22 2c20 "slice_n", │ │ │ │ │ -00015e40: 2273 6c69 6365 5f6e 6522 2c20 2273 6c69 "slice_ne", "sli │ │ │ │ │ -00015e50: 6365 5f65 222c 2061 6e64 2073 6f20 6f6e ce_e", and so on │ │ │ │ │ -00015e60: 2061 6363 6f72 6469 6e67 2074 6f20 7468 according to th │ │ │ │ │ -00015e70: 650a 2020 2020 206c 6f63 6174 696f 6e2e e. location. │ │ │ │ │ -00015e80: 0a20 2035 2e20 5361 7665 2074 6865 2064 . 5. Save the d │ │ │ │ │ -00015e90: 7261 7769 6e67 2e0a 2020 362e 2053 656c rawing.. 6. Sel │ │ │ │ │ -00015ea0: 6563 7420 616c 6c20 7468 6520 736c 6963 ect all the slic │ │ │ │ │ -00015eb0: 6520 7265 6374 616e 676c 6573 2e20 2057 e rectangles. W │ │ │ │ │ -00015ec0: 6974 6820 7468 6520 736c 6963 6520 6c61 ith the slice la │ │ │ │ │ -00015ed0: 7965 7220 7365 6c65 6374 6564 2c0a 2020 yer selected,. │ │ │ │ │ -00015ee0: 2020 2079 6f75 2063 616e 2073 696d 706c you can simpl │ │ │ │ │ -00015ef0: 7920 7072 6573 7320 4374 726c 2b41 2074 y press Ctrl+A t │ │ │ │ │ -00015f00: 6f20 7365 6c65 6374 2061 6c6c 2072 6563 o select all rec │ │ │ │ │ -00015f10: 7461 6e67 6c65 732e 2020 5468 6520 7374 tangles. The st │ │ │ │ │ -00015f20: 6174 7573 0a20 2020 2020 6261 7220 7368 atus. bar sh │ │ │ │ │ -00015f30: 6f75 6c64 2069 6e64 6963 6174 6520 7468 ould indicate th │ │ │ │ │ -00015f40: 6174 2039 2072 6563 7461 6e67 6c65 7320 at 9 rectangles │ │ │ │ │ -00015f50: 6172 6520 7365 6c65 6374 6564 2e0a 2020 are selected.. │ │ │ │ │ -00015f60: 372e 2043 6c69 636b 2074 6865 206c 6179 7. Click the lay │ │ │ │ │ -00015f70: 6572 2068 6964 6520 6963 6f6e 2066 6f72 er hide icon for │ │ │ │ │ -00015f80: 2074 6865 2073 6c69 6365 206c 6179 6572 the slice layer │ │ │ │ │ -00015f90: 2069 6e20 7468 6520 6c61 7965 7220 7061 in the layer pa │ │ │ │ │ -00015fa0: 6c65 7474 652e 0a20 2020 2020 5468 6520 lette.. The │ │ │ │ │ -00015fb0: 7265 6374 616e 676c 6573 2077 696c 6c20 rectangles will │ │ │ │ │ -00015fc0: 7265 6d61 696e 2073 656c 6563 7465 642c remain selected, │ │ │ │ │ -00015fd0: 2065 7665 6e20 7468 6f75 6768 2074 6865 even though the │ │ │ │ │ -00015fe0: 7920 6172 6520 6869 6464 656e 2e0a 2020 y are hidden.. │ │ │ │ │ -00015ff0: 382e 2043 686f 6f73 6520 4669 6c65 207c 8. Choose File | │ │ │ │ │ -00016000: 2045 7870 6f72 7420 4269 746d 6170 2061 Export Bitmap a │ │ │ │ │ -00016010: 6e64 2063 6865 636b 2074 6865 202a 4261 nd check the *Ba │ │ │ │ │ -00016020: 7463 6820 6578 706f 7274 2039 2073 656c tch export 9 sel │ │ │ │ │ -00016030: 6563 7465 640a 2020 2020 206f 626a 6563 ected. objec │ │ │ │ │ -00016040: 7473 2a20 626f 782e 2020 4d61 6b65 2073 ts* box. Make s │ │ │ │ │ -00016050: 7572 6520 7468 6174 202a 4869 6465 2061 ure that *Hide a │ │ │ │ │ -00016060: 6c6c 2065 7863 6570 7420 7365 6c65 6374 ll except select │ │ │ │ │ -00016070: 6564 2a20 6973 0a20 2020 2020 756e 6368 ed* is. unch │ │ │ │ │ -00016080: 6563 6b65 642e 2020 636c 6963 6b20 2a45 ecked. click *E │ │ │ │ │ -00016090: 7870 6f72 742a 2e20 2054 6869 7320 7769 xport*. This wi │ │ │ │ │ -000160a0: 6c6c 2063 7265 6174 6520 504e 4720 6669 ll create PNG fi │ │ │ │ │ -000160b0: 6c65 7320 696e 2074 6865 2073 616d 650a les in the same. │ │ │ │ │ -000160c0: 2020 2020 2064 6972 6563 746f 7279 2061 directory a │ │ │ │ │ -000160d0: 7320 7468 6520 6472 6177 696e 672c 206e s the drawing, n │ │ │ │ │ -000160e0: 616d 6564 2061 6674 6572 2074 6865 2073 amed after the s │ │ │ │ │ -000160f0: 6c69 6365 732e 2020 5468 6573 6520 6361 lices. These ca │ │ │ │ │ -00016100: 6e20 6e6f 7720 6265 0a20 2020 2020 7573 n now be. us │ │ │ │ │ -00016110: 6564 2066 6f72 2061 2073 7479 6c65 6420 ed for a styled │ │ │ │ │ -00016120: 626f 7820 696e 2061 2047 5255 4220 7468 box in a GRUB th │ │ │ │ │ -00016130: 656d 652e 0a0a 372e 3320 5468 656d 6520 eme...7.3 Theme │ │ │ │ │ -00016140: 4669 6c65 204d 616e 7561 6c0a 3d3d 3d3d File Manual.==== │ │ │ │ │ +000159a0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 2049 ---------..The I │ │ │ │ │ +000159b0: 6e6b 7363 6170 655f 2073 6361 6c61 626c nkscape_ scalabl │ │ │ │ │ +000159c0: 6520 7665 6374 6f72 2067 7261 7068 6963 e vector graphic │ │ │ │ │ +000159d0: 7320 6564 6974 6f72 2069 7320 6120 7665 s editor is a ve │ │ │ │ │ +000159e0: 7279 2075 7365 6675 6c20 746f 6f6c 2066 ry useful tool f │ │ │ │ │ +000159f0: 6f72 0a63 7265 6174 696e 6720 7374 796c or.creating styl │ │ │ │ │ +00015a00: 6564 2062 6f78 2069 6d61 6765 732e 2020 ed box images. │ │ │ │ │ +00015a10: 4f6e 6520 7072 6f63 6573 7320 7468 6174 One process that │ │ │ │ │ +00015a20: 2077 6f72 6b73 2077 656c 6c20 666f 7220 works well for │ │ │ │ │ +00015a30: 736c 6963 696e 6720 610a 6472 6177 696e slicing a.drawin │ │ │ │ │ +00015a40: 6720 696e 746f 2074 6865 206e 6563 6573 g into the neces │ │ │ │ │ +00015a50: 7361 7279 2069 6d61 6765 2073 6c69 6365 sary image slice │ │ │ │ │ +00015a60: 7320 6973 3a0a 0a20 2031 2e20 4372 6561 s is:.. 1. Crea │ │ │ │ │ +00015a70: 7465 206f 7220 6f70 656e 2074 6865 2064 te or open the d │ │ │ │ │ +00015a80: 7261 7769 6e67 2079 6f75 2764 206c 696b rawing you'd lik │ │ │ │ │ +00015a90: 6520 7573 652e 0a20 2032 2e20 4372 6561 e use.. 2. Crea │ │ │ │ │ +00015aa0: 7465 2061 206e 6577 206c 6179 6572 206f te a new layer o │ │ │ │ │ +00015ab0: 6e20 7468 6520 746f 7020 6f66 2074 6865 n the top of the │ │ │ │ │ +00015ac0: 206c 6179 6572 2073 7461 636b 2e20 204d layer stack. M │ │ │ │ │ +00015ad0: 616b 6520 6974 2076 6973 6962 6c65 2e0a ake it visible.. │ │ │ │ │ +00015ae0: 2020 2020 2053 656c 6563 7420 7468 6973 Select this │ │ │ │ │ +00015af0: 206c 6179 6572 2061 7320 7468 6520 6375 layer as the cu │ │ │ │ │ +00015b00: 7272 656e 7420 6c61 7965 722e 0a20 2033 rrent layer.. 3 │ │ │ │ │ +00015b10: 2e20 4472 6177 2039 2072 6563 7461 6e67 . Draw 9 rectang │ │ │ │ │ +00015b20: 6c65 7320 6f6e 2079 6f75 7220 6472 6177 les on your draw │ │ │ │ │ +00015b30: 696e 6720 7768 6572 6520 796f 7527 6420 ing where you'd │ │ │ │ │ +00015b40: 6c69 6b65 2074 6865 2073 6c69 6365 7320 like the slices │ │ │ │ │ +00015b50: 746f 0a20 2020 2020 6265 2e20 2043 6c65 to. be. Cle │ │ │ │ │ +00015b60: 6172 2074 6865 2066 696c 6c20 6f70 7469 ar the fill opti │ │ │ │ │ +00015b70: 6f6e 2c20 616e 6420 7365 7420 7468 6520 on, and set the │ │ │ │ │ +00015b80: 7374 726f 6b65 2074 6f20 3120 7069 7865 stroke to 1 pixe │ │ │ │ │ +00015b90: 6c20 7769 6465 0a20 2020 2020 736f 6c69 l wide. soli │ │ │ │ │ +00015ba0: 6420 7374 726f 6b65 2e20 2054 6865 2063 d stroke. The c │ │ │ │ │ +00015bb0: 6f72 6e65 7273 206f 6620 7468 6520 736c orners of the sl │ │ │ │ │ +00015bc0: 6963 6573 206d 7573 7420 6d65 6574 2070 ices must meet p │ │ │ │ │ +00015bd0: 7265 6369 7365 6c79 3b20 6966 2069 740a recisely; if it. │ │ │ │ │ +00015be0: 2020 2020 2069 7320 6f66 6620 6279 2061 is off by a │ │ │ │ │ +00015bf0: 2073 696e 676c 6520 7069 7865 6c2c 2069 single pixel, i │ │ │ │ │ +00015c00: 7420 7769 6c6c 2070 726f 6261 626c 7920 t will probably │ │ │ │ │ +00015c10: 6265 2065 7669 6465 6e74 2077 6865 6e20 be evident when │ │ │ │ │ +00015c20: 7468 650a 2020 2020 2073 7479 6c65 6420 the. styled │ │ │ │ │ +00015c30: 626f 7820 6973 2072 656e 6465 7265 6420 box is rendered │ │ │ │ │ +00015c40: 696e 2074 6865 2047 5255 4220 6d65 6e75 in the GRUB menu │ │ │ │ │ +00015c50: 2e20 2059 6f75 2073 686f 756c 6420 7072 . You should pr │ │ │ │ │ +00015c60: 6f62 6162 6c79 2067 6f20 746f 0a20 2020 obably go to. │ │ │ │ │ +00015c70: 2020 4669 6c65 207c 2044 6f63 756d 656e File | Documen │ │ │ │ │ +00015c80: 7420 5072 6f70 6572 7469 6573 207c 2047 t Properties | G │ │ │ │ │ +00015c90: 7269 6473 2061 6e64 2065 6e61 626c 6520 rids and enable │ │ │ │ │ +00015ca0: 6120 6772 6964 206f 7220 6372 6561 7465 a grid or create │ │ │ │ │ +00015cb0: 2061 0a20 2020 2020 6775 6964 6520 2863 a. guide (c │ │ │ │ │ +00015cc0: 6c69 636b 206f 6e20 6f6e 6520 6f66 2074 lick on one of t │ │ │ │ │ +00015cd0: 6865 2072 756c 6572 7320 6e65 7874 2074 he rulers next t │ │ │ │ │ +00015ce0: 6f20 7468 6520 6472 6177 696e 6720 616e o the drawing an │ │ │ │ │ +00015cf0: 6420 6472 6167 206f 7665 720a 2020 2020 d drag over. │ │ │ │ │ +00015d00: 2074 6865 2064 7261 7769 6e67 3b20 7265 the drawing; re │ │ │ │ │ +00015d10: 6c65 6173 6520 7468 6520 6d6f 7573 6520 lease the mouse │ │ │ │ │ +00015d20: 6275 7474 6f6e 2074 6f20 706c 6163 6520 button to place │ │ │ │ │ +00015d30: 7468 6520 6775 6964 6529 2074 6f20 6865 the guide) to he │ │ │ │ │ +00015d40: 6c70 0a20 2020 2020 706c 6163 6520 7468 lp. place th │ │ │ │ │ +00015d50: 6520 7265 6374 616e 676c 6573 2070 7265 e rectangles pre │ │ │ │ │ +00015d60: 6369 7365 6c79 2e0a 2020 342e 2052 6967 cisely.. 4. Rig │ │ │ │ │ +00015d70: 6874 2063 6c69 636b 206f 6e20 7468 6520 ht click on the │ │ │ │ │ +00015d80: 6365 6e74 6572 2073 6c69 6365 2072 6563 center slice rec │ │ │ │ │ +00015d90: 7461 6e67 6c65 2061 6e64 2063 686f 6f73 tangle and choos │ │ │ │ │ +00015da0: 6520 4f62 6a65 6374 0a20 2020 2020 5072 e Object. Pr │ │ │ │ │ +00015db0: 6f70 6572 7469 6573 2e20 2043 6861 6e67 operties. Chang │ │ │ │ │ +00015dc0: 6520 7468 6520 2249 6422 2074 6f20 2273 e the "Id" to "s │ │ │ │ │ +00015dd0: 6c69 6365 5f63 2220 616e 6420 636c 6963 lice_c" and clic │ │ │ │ │ +00015de0: 6b20 5365 742e 2020 5265 7065 6174 0a20 k Set. Repeat. │ │ │ │ │ +00015df0: 2020 2020 7468 6973 2066 6f72 2074 6865 this for the │ │ │ │ │ +00015e00: 2072 656d 6169 6e69 6e67 2038 2072 6563 remaining 8 rec │ │ │ │ │ +00015e10: 7461 6e67 6c65 732c 2067 6976 696e 6720 tangles, giving │ │ │ │ │ +00015e20: 7468 656d 2049 6420 7661 6c75 6573 206f them Id values o │ │ │ │ │ +00015e30: 660a 2020 2020 2022 736c 6963 655f 6e22 f. "slice_n" │ │ │ │ │ +00015e40: 2c20 2273 6c69 6365 5f6e 6522 2c20 2273 , "slice_ne", "s │ │ │ │ │ +00015e50: 6c69 6365 5f65 222c 2061 6e64 2073 6f20 lice_e", and so │ │ │ │ │ +00015e60: 6f6e 2061 6363 6f72 6469 6e67 2074 6f20 on according to │ │ │ │ │ +00015e70: 7468 650a 2020 2020 206c 6f63 6174 696f the. locatio │ │ │ │ │ +00015e80: 6e2e 0a20 2035 2e20 5361 7665 2074 6865 n.. 5. Save the │ │ │ │ │ +00015e90: 2064 7261 7769 6e67 2e0a 2020 362e 2053 drawing.. 6. S │ │ │ │ │ +00015ea0: 656c 6563 7420 616c 6c20 7468 6520 736c elect all the sl │ │ │ │ │ +00015eb0: 6963 6520 7265 6374 616e 676c 6573 2e20 ice rectangles. │ │ │ │ │ +00015ec0: 2057 6974 6820 7468 6520 736c 6963 6520 With the slice │ │ │ │ │ +00015ed0: 6c61 7965 7220 7365 6c65 6374 6564 2c0a layer selected,. │ │ │ │ │ +00015ee0: 2020 2020 2079 6f75 2063 616e 2073 696d you can sim │ │ │ │ │ +00015ef0: 706c 7920 7072 6573 7320 4374 726c 2b41 ply press Ctrl+A │ │ │ │ │ +00015f00: 2074 6f20 7365 6c65 6374 2061 6c6c 2072 to select all r │ │ │ │ │ +00015f10: 6563 7461 6e67 6c65 732e 2020 5468 6520 ectangles. The │ │ │ │ │ +00015f20: 7374 6174 7573 0a20 2020 2020 6261 7220 status. bar │ │ │ │ │ +00015f30: 7368 6f75 6c64 2069 6e64 6963 6174 6520 should indicate │ │ │ │ │ +00015f40: 7468 6174 2039 2072 6563 7461 6e67 6c65 that 9 rectangle │ │ │ │ │ +00015f50: 7320 6172 6520 7365 6c65 6374 6564 2e0a s are selected.. │ │ │ │ │ +00015f60: 2020 372e 2043 6c69 636b 2074 6865 206c 7. Click the l │ │ │ │ │ +00015f70: 6179 6572 2068 6964 6520 6963 6f6e 2066 ayer hide icon f │ │ │ │ │ +00015f80: 6f72 2074 6865 2073 6c69 6365 206c 6179 or the slice lay │ │ │ │ │ +00015f90: 6572 2069 6e20 7468 6520 6c61 7965 7220 er in the layer │ │ │ │ │ +00015fa0: 7061 6c65 7474 652e 0a20 2020 2020 5468 palette.. Th │ │ │ │ │ +00015fb0: 6520 7265 6374 616e 676c 6573 2077 696c e rectangles wil │ │ │ │ │ +00015fc0: 6c20 7265 6d61 696e 2073 656c 6563 7465 l remain selecte │ │ │ │ │ +00015fd0: 642c 2065 7665 6e20 7468 6f75 6768 2074 d, even though t │ │ │ │ │ +00015fe0: 6865 7920 6172 6520 6869 6464 656e 2e0a hey are hidden.. │ │ │ │ │ +00015ff0: 2020 382e 2043 686f 6f73 6520 4669 6c65 8. Choose File │ │ │ │ │ +00016000: 207c 2045 7870 6f72 7420 4269 746d 6170 | Export Bitmap │ │ │ │ │ +00016010: 2061 6e64 2063 6865 636b 2074 6865 202a and check the * │ │ │ │ │ +00016020: 4261 7463 6820 6578 706f 7274 2039 2073 Batch export 9 s │ │ │ │ │ +00016030: 656c 6563 7465 640a 2020 2020 206f 626a elected. obj │ │ │ │ │ +00016040: 6563 7473 2a20 626f 782e 2020 4d61 6b65 ects* box. Make │ │ │ │ │ +00016050: 2073 7572 6520 7468 6174 202a 4869 6465 sure that *Hide │ │ │ │ │ +00016060: 2061 6c6c 2065 7863 6570 7420 7365 6c65 all except sele │ │ │ │ │ +00016070: 6374 6564 2a20 6973 0a20 2020 2020 756e cted* is. un │ │ │ │ │ +00016080: 6368 6563 6b65 642e 2020 636c 6963 6b20 checked. click │ │ │ │ │ +00016090: 2a45 7870 6f72 742a 2e20 2054 6869 7320 *Export*. This │ │ │ │ │ +000160a0: 7769 6c6c 2063 7265 6174 6520 504e 4720 will create PNG │ │ │ │ │ +000160b0: 6669 6c65 7320 696e 2074 6865 2073 616d files in the sam │ │ │ │ │ +000160c0: 650a 2020 2020 2064 6972 6563 746f 7279 e. directory │ │ │ │ │ +000160d0: 2061 7320 7468 6520 6472 6177 696e 672c as the drawing, │ │ │ │ │ +000160e0: 206e 616d 6564 2061 6674 6572 2074 6865 named after the │ │ │ │ │ +000160f0: 2073 6c69 6365 732e 2020 5468 6573 6520 slices. These │ │ │ │ │ +00016100: 6361 6e20 6e6f 7720 6265 0a20 2020 2020 can now be. │ │ │ │ │ +00016110: 7573 6564 2066 6f72 2061 2073 7479 6c65 used for a style │ │ │ │ │ +00016120: 6420 626f 7820 696e 2061 2047 5255 4220 d box in a GRUB │ │ │ │ │ +00016130: 7468 656d 652e 0a0a 372e 3320 5468 656d theme...7.3 Them │ │ │ │ │ +00016140: 6520 4669 6c65 204d 616e 7561 6c0a 3d3d e File Manual.== │ │ │ │ │ 00016150: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00016160: 3d0a 0a54 6865 2074 6865 6d65 2066 696c =..The theme fil │ │ │ │ │ -00016170: 6520 6973 2061 2070 6c61 696e 2074 6578 e is a plain tex │ │ │ │ │ -00016180: 7420 6669 6c65 2e20 204c 696e 6573 2074 t file. Lines t │ │ │ │ │ -00016190: 6861 7420 6265 6769 6e20 7769 7468 2022 hat begin with " │ │ │ │ │ -000161a0: 2322 2061 7265 0a69 676e 6f72 6564 2061 #" are.ignored a │ │ │ │ │ -000161b0: 6e64 2063 6f6e 7369 6465 7265 6420 636f nd considered co │ │ │ │ │ -000161c0: 6d6d 656e 7473 2e20 2028 4e6f 7465 3a20 mments. (Note: │ │ │ │ │ -000161d0: 5468 6973 206d 6179 206e 6f74 2062 6520 This may not be │ │ │ │ │ -000161e0: 7468 6520 6361 7365 2069 6620 7468 650a the case if the. │ │ │ │ │ -000161f0: 7072 6576 696f 7573 206c 696e 6520 656e previous line en │ │ │ │ │ -00016200: 6465 6420 7768 6572 6520 6120 7661 6c75 ded where a valu │ │ │ │ │ -00016210: 6520 7761 7320 6578 7065 6374 6564 2e29 e was expected.) │ │ │ │ │ -00016220: 0a0a 2020 2054 6865 2074 6865 6d65 2066 .. The theme f │ │ │ │ │ -00016230: 696c 6520 636f 6e74 6169 6e73 2074 776f ile contains two │ │ │ │ │ -00016240: 2074 7970 6573 206f 6620 7374 6174 656d types of statem │ │ │ │ │ -00016250: 656e 7473 3a0a 2020 312e 2047 6c6f 6261 ents:. 1. Globa │ │ │ │ │ -00016260: 6c20 7072 6f70 6572 7469 6573 2e0a 2020 l properties.. │ │ │ │ │ -00016270: 322e 2043 6f6d 706f 6e65 6e74 2063 6f6e 2. Component con │ │ │ │ │ -00016280: 7374 7275 6374 696f 6e2e 0a0a 372e 332e struction...7.3. │ │ │ │ │ -00016290: 3120 476c 6f62 616c 2050 726f 7065 7274 1 Global Propert │ │ │ │ │ -000162a0: 6965 730a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ies.------------ │ │ │ │ │ -000162b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a37 2e33 -----------..7.3 │ │ │ │ │ -000162c0: 2e32 2046 6f72 6d61 740a 2d2d 2d2d 2d2d .2 Format.------ │ │ │ │ │ -000162d0: 2d2d 2d2d 2d2d 0a0a 476c 6f62 616c 2070 ------..Global p │ │ │ │ │ -000162e0: 726f 7065 7274 6965 7320 6172 6520 7370 roperties are sp │ │ │ │ │ -000162f0: 6563 6966 6965 6420 7769 7468 2074 6865 ecified with the │ │ │ │ │ -00016300: 2073 696d 706c 6520 666f 726d 6174 3a0a simple format:. │ │ │ │ │ -00016310: 2020 202a 206e 616d 6531 3a20 7661 6c75 * name1: valu │ │ │ │ │ -00016320: 6531 0a20 2020 2a20 6e61 6d65 323a 2022 e1. * name2: " │ │ │ │ │ -00016330: 7661 6c75 6520 7768 6963 6820 6d61 7920 value which may │ │ │ │ │ -00016340: 636f 6e74 6169 6e20 7370 6163 6573 220a contain spaces". │ │ │ │ │ -00016350: 2020 202a 206e 616d 6533 3a20 2338 3846 * name3: #88F │ │ │ │ │ -00016360: 0a0a 2020 2049 6e20 7468 6973 2065 7861 .. In this exa │ │ │ │ │ -00016370: 6d70 6c65 2c20 6e61 6d65 3320 6973 2061 mple, name3 is a │ │ │ │ │ -00016380: 7373 6967 6e65 6420 6120 636f 6c6f 7220 ssigned a color │ │ │ │ │ -00016390: 7661 6c75 652e 0a0a 372e 332e 3320 476c value...7.3.3 Gl │ │ │ │ │ -000163a0: 6f62 616c 2050 726f 7065 7274 7920 4c69 obal Property Li │ │ │ │ │ -000163b0: 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d st.------------- │ │ │ │ │ -000163c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a74 -------------..t │ │ │ │ │ -000163d0: 6974 6c65 2d74 6578 7420 2020 2020 2020 itle-text │ │ │ │ │ -000163e0: 2020 2020 2020 5370 6563 6966 6965 7320 Specifies │ │ │ │ │ -000163f0: 7468 6520 7465 7874 2074 6f20 6469 7370 the text to disp │ │ │ │ │ -00016400: 6c61 7920 6174 2074 6865 2074 6f70 0a20 lay at the top. │ │ │ │ │ -00016410: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016420: 2020 2020 2020 6365 6e74 6572 206f 6620 center of │ │ │ │ │ -00016430: 7468 6520 7363 7265 656e 2061 7320 6120 the screen as a │ │ │ │ │ -00016440: 7469 746c 652e 0a74 6974 6c65 2d66 6f6e title..title-fon │ │ │ │ │ -00016450: 7420 2020 2020 2020 2020 2020 2020 4465 t De │ │ │ │ │ -00016460: 6669 6e65 7320 7468 6520 666f 6e74 2075 fines the font u │ │ │ │ │ -00016470: 7365 6420 666f 7220 7468 6520 7469 746c sed for the titl │ │ │ │ │ -00016480: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ -00016490: 2020 2020 2020 2020 206d 6573 7361 6765 message │ │ │ │ │ -000164a0: 2061 7420 7468 6520 746f 7020 6f66 2074 at the top of t │ │ │ │ │ -000164b0: 6865 2073 6372 6565 6e2e 0a74 6974 6c65 he screen..title │ │ │ │ │ -000164c0: 2d63 6f6c 6f72 2020 2020 2020 2020 2020 -color │ │ │ │ │ -000164d0: 2020 4465 6669 6e65 7320 7468 6520 636f Defines the co │ │ │ │ │ -000164e0: 6c6f 7220 6f66 2074 6865 2074 6974 6c65 lor of the title │ │ │ │ │ -000164f0: 206d 6573 7361 6765 2e0a 6d65 7373 6167 message..messag │ │ │ │ │ -00016500: 652d 666f 6e74 2020 2020 2020 2020 2020 e-font │ │ │ │ │ -00016510: 2043 7572 7265 6e74 6c79 2075 6e75 7365 Currently unuse │ │ │ │ │ -00016520: 642e 2020 4c65 6674 2066 6f72 2062 6163 d. Left for bac │ │ │ │ │ -00016530: 6b77 6172 640a 2020 2020 2020 2020 2020 kward. │ │ │ │ │ -00016540: 2020 2020 2020 2020 2020 2020 2063 6f6d com │ │ │ │ │ -00016550: 7061 7469 6269 6c69 7479 2e0a 6d65 7373 patibility..mess │ │ │ │ │ -00016560: 6167 652d 636f 6c6f 7220 2020 2020 2020 age-color │ │ │ │ │ -00016570: 2020 2043 7572 7265 6e74 6c79 2075 6e75 Currently unu │ │ │ │ │ -00016580: 7365 642e 2020 4c65 6674 2066 6f72 2062 sed. Left for b │ │ │ │ │ -00016590: 6163 6b77 6172 640a 2020 2020 2020 2020 ackward. │ │ │ │ │ -000165a0: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ │ -000165b0: 6f6d 7061 7469 6269 6c69 7479 2e0a 6d65 ompatibility..me │ │ │ │ │ -000165c0: 7373 6167 652d 6267 2d63 6f6c 6f72 2020 ssage-bg-color │ │ │ │ │ -000165d0: 2020 2020 2043 7572 7265 6e74 6c79 2075 Currently u │ │ │ │ │ -000165e0: 6e75 7365 642e 2020 4c65 6674 2066 6f72 nused. Left for │ │ │ │ │ -000165f0: 2062 6163 6b77 6172 640a 2020 2020 2020 backward. │ │ │ │ │ +00016160: 3d3d 3d0a 0a54 6865 2074 6865 6d65 2066 ===..The theme f │ │ │ │ │ +00016170: 696c 6520 6973 2061 2070 6c61 696e 2074 ile is a plain t │ │ │ │ │ +00016180: 6578 7420 6669 6c65 2e20 204c 696e 6573 ext file. Lines │ │ │ │ │ +00016190: 2074 6861 7420 6265 6769 6e20 7769 7468 that begin with │ │ │ │ │ +000161a0: 2022 2322 2061 7265 0a69 676e 6f72 6564 "#" are.ignored │ │ │ │ │ +000161b0: 2061 6e64 2063 6f6e 7369 6465 7265 6420 and considered │ │ │ │ │ +000161c0: 636f 6d6d 656e 7473 2e20 2028 4e6f 7465 comments. (Note │ │ │ │ │ +000161d0: 3a20 5468 6973 206d 6179 206e 6f74 2062 : This may not b │ │ │ │ │ +000161e0: 6520 7468 6520 6361 7365 2069 6620 7468 e the case if th │ │ │ │ │ +000161f0: 650a 7072 6576 696f 7573 206c 696e 6520 e.previous line │ │ │ │ │ +00016200: 656e 6465 6420 7768 6572 6520 6120 7661 ended where a va │ │ │ │ │ +00016210: 6c75 6520 7761 7320 6578 7065 6374 6564 lue was expected │ │ │ │ │ +00016220: 2e29 0a0a 2020 2054 6865 2074 6865 6d65 .).. The theme │ │ │ │ │ +00016230: 2066 696c 6520 636f 6e74 6169 6e73 2074 file contains t │ │ │ │ │ +00016240: 776f 2074 7970 6573 206f 6620 7374 6174 wo types of stat │ │ │ │ │ +00016250: 656d 656e 7473 3a0a 2020 312e 2047 6c6f ements:. 1. Glo │ │ │ │ │ +00016260: 6261 6c20 7072 6f70 6572 7469 6573 2e0a bal properties.. │ │ │ │ │ +00016270: 2020 322e 2043 6f6d 706f 6e65 6e74 2063 2. Component c │ │ │ │ │ +00016280: 6f6e 7374 7275 6374 696f 6e2e 0a0a 372e onstruction...7. │ │ │ │ │ +00016290: 332e 3120 476c 6f62 616c 2050 726f 7065 3.1 Global Prope │ │ │ │ │ +000162a0: 7274 6965 730a 2d2d 2d2d 2d2d 2d2d 2d2d rties.---------- │ │ │ │ │ +000162b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a37 -------------..7 │ │ │ │ │ +000162c0: 2e33 2e32 2046 6f72 6d61 740a 2d2d 2d2d .3.2 Format.---- │ │ │ │ │ +000162d0: 2d2d 2d2d 2d2d 2d2d 0a0a 476c 6f62 616c --------..Global │ │ │ │ │ +000162e0: 2070 726f 7065 7274 6965 7320 6172 6520 properties are │ │ │ │ │ +000162f0: 7370 6563 6966 6965 6420 7769 7468 2074 specified with t │ │ │ │ │ +00016300: 6865 2073 696d 706c 6520 666f 726d 6174 he simple format │ │ │ │ │ +00016310: 3a0a 2020 202a 206e 616d 6531 3a20 7661 :. * name1: va │ │ │ │ │ +00016320: 6c75 6531 0a20 2020 2a20 6e61 6d65 323a lue1. * name2: │ │ │ │ │ +00016330: 2022 7661 6c75 6520 7768 6963 6820 6d61 "value which ma │ │ │ │ │ +00016340: 7920 636f 6e74 6169 6e20 7370 6163 6573 y contain spaces │ │ │ │ │ +00016350: 220a 2020 202a 206e 616d 6533 3a20 2338 ". * name3: #8 │ │ │ │ │ +00016360: 3846 0a0a 2020 2049 6e20 7468 6973 2065 8F.. In this e │ │ │ │ │ +00016370: 7861 6d70 6c65 2c20 6e61 6d65 3320 6973 xample, name3 is │ │ │ │ │ +00016380: 2061 7373 6967 6e65 6420 6120 636f 6c6f assigned a colo │ │ │ │ │ +00016390: 7220 7661 6c75 652e 0a0a 372e 332e 3320 r value...7.3.3 │ │ │ │ │ +000163a0: 476c 6f62 616c 2050 726f 7065 7274 7920 Global Property │ │ │ │ │ +000163b0: 4c69 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d List.----------- │ │ │ │ │ +000163c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +000163d0: 0a74 6974 6c65 2d74 6578 7420 2020 2020 .title-text │ │ │ │ │ +000163e0: 2020 2020 2020 2020 5370 6563 6966 6965 Specifie │ │ │ │ │ +000163f0: 7320 7468 6520 7465 7874 2074 6f20 6469 s the text to di │ │ │ │ │ +00016400: 7370 6c61 7920 6174 2074 6865 2074 6f70 splay at the top │ │ │ │ │ +00016410: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00016420: 2020 2020 2020 2020 6365 6e74 6572 206f center o │ │ │ │ │ +00016430: 6620 7468 6520 7363 7265 656e 2061 7320 f the screen as │ │ │ │ │ +00016440: 6120 7469 746c 652e 0a74 6974 6c65 2d66 a title..title-f │ │ │ │ │ +00016450: 6f6e 7420 2020 2020 2020 2020 2020 2020 ont │ │ │ │ │ +00016460: 4465 6669 6e65 7320 7468 6520 666f 6e74 Defines the font │ │ │ │ │ +00016470: 2075 7365 6420 666f 7220 7468 6520 7469 used for the ti │ │ │ │ │ +00016480: 746c 650a 2020 2020 2020 2020 2020 2020 tle. │ │ │ │ │ +00016490: 2020 2020 2020 2020 2020 206d 6573 7361 messa │ │ │ │ │ +000164a0: 6765 2061 7420 7468 6520 746f 7020 6f66 ge at the top of │ │ │ │ │ +000164b0: 2074 6865 2073 6372 6565 6e2e 0a74 6974 the screen..tit │ │ │ │ │ +000164c0: 6c65 2d63 6f6c 6f72 2020 2020 2020 2020 le-color │ │ │ │ │ +000164d0: 2020 2020 4465 6669 6e65 7320 7468 6520 Defines the │ │ │ │ │ +000164e0: 636f 6c6f 7220 6f66 2074 6865 2074 6974 color of the tit │ │ │ │ │ +000164f0: 6c65 206d 6573 7361 6765 2e0a 6d65 7373 le message..mess │ │ │ │ │ +00016500: 6167 652d 666f 6e74 2020 2020 2020 2020 age-font │ │ │ │ │ +00016510: 2020 2043 7572 7265 6e74 6c79 2075 6e75 Currently unu │ │ │ │ │ +00016520: 7365 642e 2020 4c65 6674 2066 6f72 2062 sed. Left for b │ │ │ │ │ +00016530: 6163 6b77 6172 640a 2020 2020 2020 2020 ackward. │ │ │ │ │ +00016540: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ │ +00016550: 6f6d 7061 7469 6269 6c69 7479 2e0a 6d65 ompatibility..me │ │ │ │ │ +00016560: 7373 6167 652d 636f 6c6f 7220 2020 2020 ssage-color │ │ │ │ │ +00016570: 2020 2020 2043 7572 7265 6e74 6c79 2075 Currently u │ │ │ │ │ +00016580: 6e75 7365 642e 2020 4c65 6674 2066 6f72 nused. Left for │ │ │ │ │ +00016590: 2062 6163 6b77 6172 640a 2020 2020 2020 backward. │ │ │ │ │ +000165a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000165b0: 2063 6f6d 7061 7469 6269 6c69 7479 2e0a compatibility.. │ │ │ │ │ +000165c0: 6d65 7373 6167 652d 6267 2d63 6f6c 6f72 message-bg-color │ │ │ │ │ +000165d0: 2020 2020 2020 2043 7572 7265 6e74 6c79 Currently │ │ │ │ │ +000165e0: 2075 6e75 7365 642e 2020 4c65 6674 2066 unused. Left f │ │ │ │ │ +000165f0: 6f72 2062 6163 6b77 6172 640a 2020 2020 or backward. │ │ │ │ │ 00016600: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016610: 2063 6f6d 7061 7469 6269 6c69 7479 2e0a compatibility.. │ │ │ │ │ -00016620: 6465 736b 746f 702d 696d 6167 6520 2020 desktop-image │ │ │ │ │ -00016630: 2020 2020 2020 2053 7065 6369 6669 6573 Specifies │ │ │ │ │ -00016640: 2074 6865 2069 6d61 6765 2074 6f20 7573 the image to us │ │ │ │ │ -00016650: 6520 6173 2074 6865 0a20 2020 2020 2020 e as the. │ │ │ │ │ +00016610: 2020 2063 6f6d 7061 7469 6269 6c69 7479 compatibility │ │ │ │ │ +00016620: 2e0a 6465 736b 746f 702d 696d 6167 6520 ..desktop-image │ │ │ │ │ +00016630: 2020 2020 2020 2020 2053 7065 6369 6669 Specifi │ │ │ │ │ +00016640: 6573 2074 6865 2069 6d61 6765 2074 6f20 es the image to │ │ │ │ │ +00016650: 7573 6520 6173 2074 6865 0a20 2020 2020 use as the. │ │ │ │ │ 00016660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016670: 6261 636b 6772 6f75 6e64 2e20 2049 7420 background. It │ │ │ │ │ -00016680: 7769 6c6c 2062 6520 7363 616c 6564 2074 will be scaled t │ │ │ │ │ -00016690: 6f20 6669 7420 7468 650a 2020 2020 2020 o fit the. │ │ │ │ │ +00016670: 2020 6261 636b 6772 6f75 6e64 2e20 2049 background. I │ │ │ │ │ +00016680: 7420 7769 6c6c 2062 6520 7363 616c 6564 t will be scaled │ │ │ │ │ +00016690: 2074 6f20 6669 7420 7468 650a 2020 2020 to fit the. │ │ │ │ │ 000166a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000166b0: 2073 6372 6565 6e20 7369 7a65 206f 7220 screen size or │ │ │ │ │ -000166c0: 7072 6f70 6f72 7469 6f6e 616c 6c79 2073 proportionally s │ │ │ │ │ -000166d0: 6361 6c65 640a 2020 2020 2020 2020 2020 caled. │ │ │ │ │ -000166e0: 2020 2020 2020 2020 2020 2020 2064 6570 dep │ │ │ │ │ -000166f0: 656e 6469 6e67 206f 6e20 7468 6520 7363 ending on the sc │ │ │ │ │ -00016700: 616c 6520 6d65 7468 6f64 2e0a 6465 736b ale method..desk │ │ │ │ │ -00016710: 746f 702d 696d 6167 652d 7363 616c 652d top-image-scale- │ │ │ │ │ -00016720: 6d65 7468 6f64 5370 6563 6966 6965 7320 methodSpecifies │ │ │ │ │ -00016730: 7468 6520 7363 616c 696e 6720 6d65 7468 the scaling meth │ │ │ │ │ -00016740: 6f64 2066 6f72 2074 6865 0a20 2020 2020 od for the. │ │ │ │ │ +000166b0: 2020 2073 6372 6565 6e20 7369 7a65 206f screen size o │ │ │ │ │ +000166c0: 7220 7072 6f70 6f72 7469 6f6e 616c 6c79 r proportionally │ │ │ │ │ +000166d0: 2073 6361 6c65 640a 2020 2020 2020 2020 scaled. │ │ │ │ │ +000166e0: 2020 2020 2020 2020 2020 2020 2020 2064 d │ │ │ │ │ +000166f0: 6570 656e 6469 6e67 206f 6e20 7468 6520 epending on the │ │ │ │ │ +00016700: 7363 616c 6520 6d65 7468 6f64 2e0a 6465 scale method..de │ │ │ │ │ +00016710: 736b 746f 702d 696d 6167 652d 7363 616c sktop-image-scal │ │ │ │ │ +00016720: 652d 6d65 7468 6f64 5370 6563 6966 6965 e-methodSpecifie │ │ │ │ │ +00016730: 7320 7468 6520 7363 616c 696e 6720 6d65 s the scaling me │ │ │ │ │ +00016740: 7468 6f64 2066 6f72 2074 6865 0a20 2020 thod for the. │ │ │ │ │ 00016750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016760: 2020 2a64 6573 6b74 6f70 2d69 6d61 6765 *desktop-image │ │ │ │ │ -00016770: 2a2e 2020 4f70 7469 6f6e 7320 6172 6520 *. Options are │ │ │ │ │ -00016780: 2273 7472 6574 6368 222c 0a20 2020 2020 "stretch",. │ │ │ │ │ +00016760: 2020 2020 2a64 6573 6b74 6f70 2d69 6d61 *desktop-ima │ │ │ │ │ +00016770: 6765 2a2e 2020 4f70 7469 6f6e 7320 6172 ge*. Options ar │ │ │ │ │ +00016780: 6520 2273 7472 6574 6368 222c 0a20 2020 e "stretch",. │ │ │ │ │ 00016790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000167a0: 2020 2263 726f 7022 2c20 2270 6164 6469 "crop", "paddi │ │ │ │ │ -000167b0: 6e67 222c 2022 6669 7477 6964 7468 222c ng", "fitwidth", │ │ │ │ │ -000167c0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -000167d0: 2020 2020 2020 2020 2266 6974 6865 6967 "fitheig │ │ │ │ │ -000167e0: 6874 222e 2020 2273 7472 6574 6368 2220 ht". "stretch" │ │ │ │ │ -000167f0: 666f 7220 6669 7474 696e 6720 7468 650a for fitting the. │ │ │ │ │ -00016800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016810: 2020 2020 2020 2073 6372 6565 6e20 7369 screen si │ │ │ │ │ -00016820: 7a65 2e20 204f 7468 6572 7769 7365 2069 ze. Otherwise i │ │ │ │ │ -00016830: 7420 6973 0a20 2020 2020 2020 2020 2020 t is. │ │ │ │ │ -00016840: 2020 2020 2020 2020 2020 2020 7072 6f70 prop │ │ │ │ │ -00016850: 6f72 7469 6f6e 616c 2073 6361 6c69 6e67 ortional scaling │ │ │ │ │ -00016860: 206f 6620 6120 7061 7274 206f 660a 2020 of a part of. │ │ │ │ │ +000167a0: 2020 2020 2263 726f 7022 2c20 2270 6164 "crop", "pad │ │ │ │ │ +000167b0: 6469 6e67 222c 2022 6669 7477 6964 7468 ding", "fitwidth │ │ │ │ │ +000167c0: 222c 0a20 2020 2020 2020 2020 2020 2020 ",. │ │ │ │ │ +000167d0: 2020 2020 2020 2020 2020 2266 6974 6865 "fithe │ │ │ │ │ +000167e0: 6967 6874 222e 2020 2273 7472 6574 6368 ight". "stretch │ │ │ │ │ +000167f0: 2220 666f 7220 6669 7474 696e 6720 7468 " for fitting th │ │ │ │ │ +00016800: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ +00016810: 2020 2020 2020 2020 2073 6372 6565 6e20 screen │ │ │ │ │ +00016820: 7369 7a65 2e20 204f 7468 6572 7769 7365 size. Otherwise │ │ │ │ │ +00016830: 2069 7420 6973 0a20 2020 2020 2020 2020 it is. │ │ │ │ │ +00016840: 2020 2020 2020 2020 2020 2020 2020 7072 pr │ │ │ │ │ +00016850: 6f70 6f72 7469 6f6e 616c 2073 6361 6c69 oportional scali │ │ │ │ │ +00016860: 6e67 206f 6620 6120 7061 7274 206f 660a ng of a part of. │ │ │ │ │ 00016870: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016880: 2020 2020 202a 6465 736b 746f 702d 696d *desktop-im │ │ │ │ │ -00016890: 6167 652a 2074 6f20 7468 6520 7061 7274 age* to the part │ │ │ │ │ -000168a0: 206f 6620 7468 650a 2020 2020 2020 2020 of the. │ │ │ │ │ -000168b0: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ -000168c0: 6372 6565 6e2e 2020 2263 726f 7022 2070 creen. "crop" p │ │ │ │ │ -000168d0: 6172 7420 6f66 2074 6865 0a20 2020 2020 art of the. │ │ │ │ │ +00016880: 2020 2020 2020 202a 6465 736b 746f 702d *desktop- │ │ │ │ │ +00016890: 696d 6167 652a 2074 6f20 7468 6520 7061 image* to the pa │ │ │ │ │ +000168a0: 7274 206f 6620 7468 650a 2020 2020 2020 rt of the. │ │ │ │ │ +000168b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000168c0: 2073 6372 6565 6e2e 2020 2263 726f 7022 screen. "crop" │ │ │ │ │ +000168d0: 2070 6172 7420 6f66 2074 6865 0a20 2020 part of the. │ │ │ │ │ 000168e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000168f0: 2020 2a64 6573 6b74 6f70 2d69 6d61 6765 *desktop-image │ │ │ │ │ -00016900: 2a20 7769 6c6c 2062 6520 7072 6f70 6f72 * will be propor │ │ │ │ │ -00016910: 7469 6f6e 616c 6c79 0a20 2020 2020 2020 tionally. │ │ │ │ │ +000168f0: 2020 2020 2a64 6573 6b74 6f70 2d69 6d61 *desktop-ima │ │ │ │ │ +00016900: 6765 2a20 7769 6c6c 2062 6520 7072 6f70 ge* will be prop │ │ │ │ │ +00016910: 6f72 7469 6f6e 616c 6c79 0a20 2020 2020 ortionally. │ │ │ │ │ 00016920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016930: 7363 616c 6564 2074 6f20 6669 7420 7468 scaled to fit th │ │ │ │ │ -00016940: 6520 7363 7265 656e 2073 697a 6573 2e0a e screen sizes.. │ │ │ │ │ -00016950: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016960: 2020 2020 2020 2022 7061 6464 696e 6722 "padding" │ │ │ │ │ -00016970: 2074 6865 2065 6e74 6972 6520 2a64 6573 the entire *des │ │ │ │ │ -00016980: 6b74 6f70 2d69 6d61 6765 2a20 7769 6c6c ktop-image* will │ │ │ │ │ -00016990: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -000169a0: 2020 2020 2020 2020 6265 2063 6f6e 7461 be conta │ │ │ │ │ -000169b0: 696e 6564 206f 6e20 7468 6520 7363 7265 ined on the scre │ │ │ │ │ -000169c0: 656e 2e20 2022 6669 7477 6964 7468 220a en. "fitwidth". │ │ │ │ │ -000169d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000169e0: 2020 2020 2020 2066 6f72 2066 6974 7469 for fitti │ │ │ │ │ -000169f0: 6e67 2074 6865 202a 6465 736b 746f 702d ng the *desktop- │ │ │ │ │ -00016a00: 696d 6167 652a 2773 2077 6964 7468 0a20 image*'s width. │ │ │ │ │ -00016a10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016a20: 2020 2020 2020 7769 7468 2073 6372 6565 with scree │ │ │ │ │ -00016a30: 6e20 7769 6474 682e 2020 2266 6974 6865 n width. "fithe │ │ │ │ │ -00016a40: 6967 6874 2220 666f 720a 2020 2020 2020 ight" for. │ │ │ │ │ +00016930: 2020 7363 616c 6564 2074 6f20 6669 7420 scaled to fit │ │ │ │ │ +00016940: 7468 6520 7363 7265 656e 2073 697a 6573 the screen sizes │ │ │ │ │ +00016950: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00016960: 2020 2020 2020 2020 2022 7061 6464 696e "paddin │ │ │ │ │ +00016970: 6722 2074 6865 2065 6e74 6972 6520 2a64 g" the entire *d │ │ │ │ │ +00016980: 6573 6b74 6f70 2d69 6d61 6765 2a20 7769 esktop-image* wi │ │ │ │ │ +00016990: 6c6c 0a20 2020 2020 2020 2020 2020 2020 ll. │ │ │ │ │ +000169a0: 2020 2020 2020 2020 2020 6265 2063 6f6e be con │ │ │ │ │ +000169b0: 7461 696e 6564 206f 6e20 7468 6520 7363 tained on the sc │ │ │ │ │ +000169c0: 7265 656e 2e20 2022 6669 7477 6964 7468 reen. "fitwidth │ │ │ │ │ +000169d0: 220a 2020 2020 2020 2020 2020 2020 2020 ". │ │ │ │ │ +000169e0: 2020 2020 2020 2020 2066 6f72 2066 6974 for fit │ │ │ │ │ +000169f0: 7469 6e67 2074 6865 202a 6465 736b 746f ting the *deskto │ │ │ │ │ +00016a00: 702d 696d 6167 652a 2773 2077 6964 7468 p-image*'s width │ │ │ │ │ +00016a10: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00016a20: 2020 2020 2020 2020 7769 7468 2073 6372 with scr │ │ │ │ │ +00016a30: 6565 6e20 7769 6474 682e 2020 2266 6974 een width. "fit │ │ │ │ │ +00016a40: 6865 6967 6874 2220 666f 720a 2020 2020 height" for. │ │ │ │ │ 00016a50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016a60: 2066 6974 7469 6e67 2074 6865 202a 6465 fitting the *de │ │ │ │ │ -00016a70: 736b 746f 702d 696d 6167 652a 2773 2068 sktop-image*'s h │ │ │ │ │ -00016a80: 6569 6768 7420 7769 7468 0a20 2020 2020 eight with. │ │ │ │ │ +00016a60: 2020 2066 6974 7469 6e67 2074 6865 202a fitting the * │ │ │ │ │ +00016a70: 6465 736b 746f 702d 696d 6167 652a 2773 desktop-image*'s │ │ │ │ │ +00016a80: 2068 6569 6768 7420 7769 7468 0a20 2020 height with. │ │ │ │ │ 00016a90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016aa0: 2020 7468 6520 7363 7265 656e 2068 6569 the screen hei │ │ │ │ │ -00016ab0: 6768 742e 2020 4465 6661 756c 7420 6973 ght. Default is │ │ │ │ │ -00016ac0: 2022 7374 7265 7463 6822 2e0a 6465 736b "stretch"..desk │ │ │ │ │ -00016ad0: 746f 702d 696d 6167 652d 682d 616c 6967 top-image-h-alig │ │ │ │ │ -00016ae0: 6e20 2053 7065 6369 6669 6573 2074 6865 n Specifies the │ │ │ │ │ -00016af0: 2068 6f72 697a 6f6e 7461 6c20 616c 6967 horizontal alig │ │ │ │ │ -00016b00: 6e6d 656e 7420 6f66 2074 6865 0a20 2020 nment of the. │ │ │ │ │ +00016aa0: 2020 2020 7468 6520 7363 7265 656e 2068 the screen h │ │ │ │ │ +00016ab0: 6569 6768 742e 2020 4465 6661 756c 7420 eight. Default │ │ │ │ │ +00016ac0: 6973 2022 7374 7265 7463 6822 2e0a 6465 is "stretch"..de │ │ │ │ │ +00016ad0: 736b 746f 702d 696d 6167 652d 682d 616c sktop-image-h-al │ │ │ │ │ +00016ae0: 6967 6e20 2053 7065 6369 6669 6573 2074 ign Specifies t │ │ │ │ │ +00016af0: 6865 2068 6f72 697a 6f6e 7461 6c20 616c he horizontal al │ │ │ │ │ +00016b00: 6967 6e6d 656e 7420 6f66 2074 6865 0a20 ignment of the. │ │ │ │ │ 00016b10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016b20: 2020 2020 2a64 6573 6b74 6f70 2d69 6d61 *desktop-ima │ │ │ │ │ -00016b30: 6765 2a20 6966 0a20 2020 2020 2020 2020 ge* if. │ │ │ │ │ -00016b40: 2020 2020 2020 2020 2020 2020 2020 2a64 *d │ │ │ │ │ -00016b50: 6573 6b74 6f70 2d69 6d61 6765 2d73 6361 esktop-image-sca │ │ │ │ │ -00016b60: 6c65 2d6d 6574 686f 642a 2069 736e 2774 le-method* isn't │ │ │ │ │ -00016b70: 2065 7175 6561 6c0a 2020 2020 2020 2020 equeal. │ │ │ │ │ -00016b80: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ │ -00016b90: 6f20 2273 7472 6574 6368 222e 2020 4f70 o "stretch". Op │ │ │ │ │ -00016ba0: 7469 6f6e 7320 6172 6520 226c 6566 7422 tions are "left" │ │ │ │ │ -00016bb0: 2c0a 2020 2020 2020 2020 2020 2020 2020 ,. │ │ │ │ │ -00016bc0: 2020 2020 2020 2020 2022 6365 6e74 6572 "center │ │ │ │ │ -00016bd0: 222c 2022 7269 6768 7422 2e20 2044 6566 ", "right". Def │ │ │ │ │ -00016be0: 6175 6c74 2069 7320 2263 656e 7465 7222 ault is "center" │ │ │ │ │ -00016bf0: 2e0a 6465 736b 746f 702d 696d 6167 652d ..desktop-image- │ │ │ │ │ -00016c00: 762d 616c 6967 6e20 2053 7065 6369 6669 v-align Specifi │ │ │ │ │ -00016c10: 6573 2074 6865 2076 6572 7469 6361 6c20 es the vertical │ │ │ │ │ -00016c20: 616c 6967 6e6d 656e 7420 6f66 2074 6865 alignment of the │ │ │ │ │ -00016c30: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00016c40: 2020 2020 2020 2020 2a64 6573 6b74 6f70 *desktop │ │ │ │ │ -00016c50: 2d69 6d61 6765 2a20 6966 0a20 2020 2020 -image* if. │ │ │ │ │ +00016b20: 2020 2020 2020 2a64 6573 6b74 6f70 2d69 *desktop-i │ │ │ │ │ +00016b30: 6d61 6765 2a20 6966 0a20 2020 2020 2020 mage* if. │ │ │ │ │ +00016b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00016b50: 2a64 6573 6b74 6f70 2d69 6d61 6765 2d73 *desktop-image-s │ │ │ │ │ +00016b60: 6361 6c65 2d6d 6574 686f 642a 2069 736e cale-method* isn │ │ │ │ │ +00016b70: 2774 2065 7175 6561 6c0a 2020 2020 2020 't equeal. │ │ │ │ │ +00016b80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00016b90: 2074 6f20 2273 7472 6574 6368 222e 2020 to "stretch". │ │ │ │ │ +00016ba0: 4f70 7469 6f6e 7320 6172 6520 226c 6566 Options are "lef │ │ │ │ │ +00016bb0: 7422 2c0a 2020 2020 2020 2020 2020 2020 t",. │ │ │ │ │ +00016bc0: 2020 2020 2020 2020 2020 2022 6365 6e74 "cent │ │ │ │ │ +00016bd0: 6572 222c 2022 7269 6768 7422 2e20 2044 er", "right". D │ │ │ │ │ +00016be0: 6566 6175 6c74 2069 7320 2263 656e 7465 efault is "cente │ │ │ │ │ +00016bf0: 7222 2e0a 6465 736b 746f 702d 696d 6167 r"..desktop-imag │ │ │ │ │ +00016c00: 652d 762d 616c 6967 6e20 2053 7065 6369 e-v-align Speci │ │ │ │ │ +00016c10: 6669 6573 2074 6865 2076 6572 7469 6361 fies the vertica │ │ │ │ │ +00016c20: 6c20 616c 6967 6e6d 656e 7420 6f66 2074 l alignment of t │ │ │ │ │ +00016c30: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ │ +00016c40: 2020 2020 2020 2020 2020 2a64 6573 6b74 *deskt │ │ │ │ │ +00016c50: 6f70 2d69 6d61 6765 2a20 6966 0a20 2020 op-image* if. │ │ │ │ │ 00016c60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016c70: 2020 2a64 6573 6b74 6f70 2d69 6d61 6765 *desktop-image │ │ │ │ │ -00016c80: 2d73 6361 6c65 2d6d 6574 686f 642a 2069 -scale-method* i │ │ │ │ │ -00016c90: 736e 2774 2065 7175 6561 6c0a 2020 2020 sn't equeal. │ │ │ │ │ +00016c70: 2020 2020 2a64 6573 6b74 6f70 2d69 6d61 *desktop-ima │ │ │ │ │ +00016c80: 6765 2d73 6361 6c65 2d6d 6574 686f 642a ge-scale-method* │ │ │ │ │ +00016c90: 2069 736e 2774 2065 7175 6561 6c0a 2020 isn't equeal. │ │ │ │ │ 00016ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016cb0: 2020 2074 6f20 2273 7472 6574 6368 222e to "stretch". │ │ │ │ │ -00016cc0: 2020 4f70 7469 6f6e 7320 6172 6520 2274 Options are "t │ │ │ │ │ -00016cd0: 6f70 222c 0a20 2020 2020 2020 2020 2020 op",. │ │ │ │ │ -00016ce0: 2020 2020 2020 2020 2020 2020 2263 656e "cen │ │ │ │ │ -00016cf0: 7465 7222 2c20 2262 6f74 746f 6d22 2e20 ter", "bottom". │ │ │ │ │ -00016d00: 2044 6566 6175 6c74 2069 7320 2263 656e Default is "cen │ │ │ │ │ -00016d10: 7465 7222 2e0a 6465 736b 746f 702d 636f ter"..desktop-co │ │ │ │ │ -00016d20: 6c6f 7220 2020 2020 2020 2020 2053 7065 lor Spe │ │ │ │ │ -00016d30: 6369 6669 6573 2074 6865 2063 6f6c 6f72 cifies the color │ │ │ │ │ -00016d40: 2066 6f72 2074 6865 2062 6163 6b67 726f for the backgro │ │ │ │ │ -00016d50: 756e 6420 6966 0a20 2020 2020 2020 2020 und if. │ │ │ │ │ -00016d60: 2020 2020 2020 2020 2020 2020 2020 2a64 *d │ │ │ │ │ -00016d70: 6573 6b74 6f70 2d69 6d61 6765 2a20 6973 esktop-image* is │ │ │ │ │ -00016d80: 206e 6f74 2073 7065 6369 6669 6564 2e0a not specified.. │ │ │ │ │ -00016d90: 7465 726d 696e 616c 2d62 6f78 2020 2020 terminal-box │ │ │ │ │ -00016da0: 2020 2020 2020 2053 7065 6369 6669 6573 Specifies │ │ │ │ │ -00016db0: 2074 6865 2066 696c 6520 6e61 6d65 2070 the file name p │ │ │ │ │ -00016dc0: 6174 7465 726e 2066 6f72 2074 6865 0a20 attern for the. │ │ │ │ │ -00016dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016de0: 2020 2020 2020 7374 796c 6564 2062 6f78 styled box │ │ │ │ │ -00016df0: 2073 6c69 6365 7320 7573 6564 2066 6f72 slices used for │ │ │ │ │ -00016e00: 2074 6865 2063 6f6d 6d61 6e64 0a20 2020 the command. │ │ │ │ │ +00016cb0: 2020 2020 2074 6f20 2273 7472 6574 6368 to "stretch │ │ │ │ │ +00016cc0: 222e 2020 4f70 7469 6f6e 7320 6172 6520 ". Options are │ │ │ │ │ +00016cd0: 2274 6f70 222c 0a20 2020 2020 2020 2020 "top",. │ │ │ │ │ +00016ce0: 2020 2020 2020 2020 2020 2020 2020 2263 "c │ │ │ │ │ +00016cf0: 656e 7465 7222 2c20 2262 6f74 746f 6d22 enter", "bottom" │ │ │ │ │ +00016d00: 2e20 2044 6566 6175 6c74 2069 7320 2263 . Default is "c │ │ │ │ │ +00016d10: 656e 7465 7222 2e0a 6465 736b 746f 702d enter"..desktop- │ │ │ │ │ +00016d20: 636f 6c6f 7220 2020 2020 2020 2020 2053 color S │ │ │ │ │ +00016d30: 7065 6369 6669 6573 2074 6865 2063 6f6c pecifies the col │ │ │ │ │ +00016d40: 6f72 2066 6f72 2074 6865 2062 6163 6b67 or for the backg │ │ │ │ │ +00016d50: 726f 756e 6420 6966 0a20 2020 2020 2020 round if. │ │ │ │ │ +00016d60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00016d70: 2a64 6573 6b74 6f70 2d69 6d61 6765 2a20 *desktop-image* │ │ │ │ │ +00016d80: 6973 206e 6f74 2073 7065 6369 6669 6564 is not specified │ │ │ │ │ +00016d90: 2e0a 7465 726d 696e 616c 2d62 6f78 2020 ..terminal-box │ │ │ │ │ +00016da0: 2020 2020 2020 2020 2053 7065 6369 6669 Specifi │ │ │ │ │ +00016db0: 6573 2074 6865 2066 696c 6520 6e61 6d65 es the file name │ │ │ │ │ +00016dc0: 2070 6174 7465 726e 2066 6f72 2074 6865 pattern for the │ │ │ │ │ +00016dd0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00016de0: 2020 2020 2020 2020 7374 796c 6564 2062 styled b │ │ │ │ │ +00016df0: 6f78 2073 6c69 6365 7320 7573 6564 2066 ox slices used f │ │ │ │ │ +00016e00: 6f72 2074 6865 2063 6f6d 6d61 6e64 0a20 or the command. │ │ │ │ │ 00016e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016e20: 2020 2020 6c69 6e65 2074 6572 6d69 6e61 line termina │ │ │ │ │ -00016e30: 6c20 7769 6e64 6f77 2e20 2046 6f72 2065 l window. For e │ │ │ │ │ -00016e40: 7861 6d70 6c65 2c0a 2020 2020 2020 2020 xample,. │ │ │ │ │ -00016e50: 2020 2020 2020 2020 2020 2020 2020 2022 " │ │ │ │ │ -00016e60: 7465 726d 696e 616c 2d62 6f78 3a20 7465 terminal-box: te │ │ │ │ │ -00016e70: 726d 696e 616c 5f2a 2e70 6e67 2220 7769 rminal_*.png" wi │ │ │ │ │ -00016e80: 6c6c 2075 7365 0a20 2020 2020 2020 2020 ll use. │ │ │ │ │ -00016e90: 2020 2020 2020 2020 2020 2020 2020 7468 th │ │ │ │ │ -00016ea0: 6520 696d 6167 6573 2022 7465 726d 696e e images "termin │ │ │ │ │ -00016eb0: 616c 5f63 2e70 6e67 2220 6173 2074 6865 al_c.png" as the │ │ │ │ │ -00016ec0: 2063 656e 7465 720a 2020 2020 2020 2020 center. │ │ │ │ │ -00016ed0: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ -00016ee0: 7265 612c 2022 7465 726d 696e 616c 5f6e rea, "terminal_n │ │ │ │ │ -00016ef0: 2e70 6e67 2220 6173 2074 6865 206e 6f72 .png" as the nor │ │ │ │ │ -00016f00: 7468 2028 746f 7029 0a20 2020 2020 2020 th (top). │ │ │ │ │ +00016e20: 2020 2020 2020 6c69 6e65 2074 6572 6d69 line termi │ │ │ │ │ +00016e30: 6e61 6c20 7769 6e64 6f77 2e20 2046 6f72 nal window. For │ │ │ │ │ +00016e40: 2065 7861 6d70 6c65 2c0a 2020 2020 2020 example,. │ │ │ │ │ +00016e50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00016e60: 2022 7465 726d 696e 616c 2d62 6f78 3a20 "terminal-box: │ │ │ │ │ +00016e70: 7465 726d 696e 616c 5f2a 2e70 6e67 2220 terminal_*.png" │ │ │ │ │ +00016e80: 7769 6c6c 2075 7365 0a20 2020 2020 2020 will use. │ │ │ │ │ +00016e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00016ea0: 7468 6520 696d 6167 6573 2022 7465 726d the images "term │ │ │ │ │ +00016eb0: 696e 616c 5f63 2e70 6e67 2220 6173 2074 inal_c.png" as t │ │ │ │ │ +00016ec0: 6865 2063 656e 7465 720a 2020 2020 2020 he center. │ │ │ │ │ +00016ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00016ee0: 2061 7265 612c 2022 7465 726d 696e 616c area, "terminal │ │ │ │ │ +00016ef0: 5f6e 2e70 6e67 2220 6173 2074 6865 206e _n.png" as the n │ │ │ │ │ +00016f00: 6f72 7468 2028 746f 7029 0a20 2020 2020 orth (top). │ │ │ │ │ 00016f10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016f20: 6564 6765 2c20 2274 6572 6d69 6e61 6c5f edge, "terminal_ │ │ │ │ │ -00016f30: 6e77 2e70 6e67 2220 6173 2074 6865 206e nw.png" as the n │ │ │ │ │ -00016f40: 6f72 7468 7765 7374 0a20 2020 2020 2020 orthwest. │ │ │ │ │ +00016f20: 2020 6564 6765 2c20 2274 6572 6d69 6e61 edge, "termina │ │ │ │ │ +00016f30: 6c5f 6e77 2e70 6e67 2220 6173 2074 6865 l_nw.png" as the │ │ │ │ │ +00016f40: 206e 6f72 7468 7765 7374 0a20 2020 2020 northwest. │ │ │ │ │ 00016f50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016f60: 2875 7070 6572 206c 6566 7429 2063 6f72 (upper left) cor │ │ │ │ │ -00016f70: 6e65 722c 2061 6e64 2073 6f20 6f6e 2e20 ner, and so on. │ │ │ │ │ -00016f80: 2049 6620 7468 650a 2020 2020 2020 2020 If the. │ │ │ │ │ -00016f90: 2020 2020 2020 2020 2020 2020 2020 2069 i │ │ │ │ │ -00016fa0: 6d61 6765 2066 6f72 2061 6e79 2073 6c69 mage for any sli │ │ │ │ │ -00016fb0: 6365 2069 7320 6e6f 7420 666f 756e 642c ce is not found, │ │ │ │ │ -00016fc0: 2069 7420 7769 6c6c 0a20 2020 2020 2020 it will. │ │ │ │ │ +00016f60: 2020 2875 7070 6572 206c 6566 7429 2063 (upper left) c │ │ │ │ │ +00016f70: 6f72 6e65 722c 2061 6e64 2073 6f20 6f6e orner, and so on │ │ │ │ │ +00016f80: 2e20 2049 6620 7468 650a 2020 2020 2020 . If the. │ │ │ │ │ +00016f90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00016fa0: 2069 6d61 6765 2066 6f72 2061 6e79 2073 image for any s │ │ │ │ │ +00016fb0: 6c69 6365 2069 7320 6e6f 7420 666f 756e lice is not foun │ │ │ │ │ +00016fc0: 642c 2069 7420 7769 6c6c 0a20 2020 2020 d, it will. │ │ │ │ │ 00016fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00016fe0: 7369 6d70 6c79 2062 6520 6c65 6674 2065 simply be left e │ │ │ │ │ -00016ff0: 6d70 7479 2e0a 7465 726d 696e 616c 2d62 mpty..terminal-b │ │ │ │ │ -00017000: 6f72 6465 7220 2020 2020 2020 2053 7065 order Spe │ │ │ │ │ -00017010: 6369 6669 6573 2074 6865 2062 6f72 6465 cifies the borde │ │ │ │ │ -00017020: 7220 7769 6474 6820 6f66 2074 6865 0a20 r width of the. │ │ │ │ │ -00017030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017040: 2020 2020 2020 7465 726d 696e 616c 2077 terminal w │ │ │ │ │ -00017050: 696e 646f 772e 0a74 6572 6d69 6e61 6c2d indow..terminal- │ │ │ │ │ -00017060: 6c65 6674 2020 2020 2020 2020 2020 5370 left Sp │ │ │ │ │ -00017070: 6563 6966 6965 7320 7468 6520 6c65 6674 ecifies the left │ │ │ │ │ -00017080: 2063 6f6f 7264 696e 6174 6520 6f66 2074 coordinate of t │ │ │ │ │ -00017090: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ │ -000170a0: 2020 2020 2020 2020 2020 7465 726d 696e termin │ │ │ │ │ -000170b0: 616c 2077 696e 646f 772e 0a74 6572 6d69 al window..termi │ │ │ │ │ -000170c0: 6e61 6c2d 746f 7020 2020 2020 2020 2020 nal-top │ │ │ │ │ -000170d0: 2020 5370 6563 6966 6965 7320 7468 6520 Specifies the │ │ │ │ │ -000170e0: 746f 7020 636f 6f72 6469 6e61 7465 206f top coordinate o │ │ │ │ │ -000170f0: 6620 7468 650a 2020 2020 2020 2020 2020 f the. │ │ │ │ │ -00017100: 2020 2020 2020 2020 2020 2020 2074 6572 ter │ │ │ │ │ -00017110: 6d69 6e61 6c20 7769 6e64 6f77 2e0a 7465 minal window..te │ │ │ │ │ -00017120: 726d 696e 616c 2d77 6964 7468 2020 2020 rminal-width │ │ │ │ │ -00017130: 2020 2020 2053 7065 6369 6669 6573 2074 Specifies t │ │ │ │ │ -00017140: 6865 2077 6964 7468 206f 6620 7468 6520 he width of the │ │ │ │ │ -00017150: 7465 726d 696e 616c 0a20 2020 2020 2020 terminal. │ │ │ │ │ +00016fe0: 2020 7369 6d70 6c79 2062 6520 6c65 6674 simply be left │ │ │ │ │ +00016ff0: 2065 6d70 7479 2e0a 7465 726d 696e 616c empty..terminal │ │ │ │ │ +00017000: 2d62 6f72 6465 7220 2020 2020 2020 2053 -border S │ │ │ │ │ +00017010: 7065 6369 6669 6573 2074 6865 2062 6f72 pecifies the bor │ │ │ │ │ +00017020: 6465 7220 7769 6474 6820 6f66 2074 6865 der width of the │ │ │ │ │ +00017030: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00017040: 2020 2020 2020 2020 7465 726d 696e 616c terminal │ │ │ │ │ +00017050: 2077 696e 646f 772e 0a74 6572 6d69 6e61 window..termina │ │ │ │ │ +00017060: 6c2d 6c65 6674 2020 2020 2020 2020 2020 l-left │ │ │ │ │ +00017070: 5370 6563 6966 6965 7320 7468 6520 6c65 Specifies the le │ │ │ │ │ +00017080: 6674 2063 6f6f 7264 696e 6174 6520 6f66 ft coordinate of │ │ │ │ │ +00017090: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ │ +000170a0: 2020 2020 2020 2020 2020 2020 7465 726d term │ │ │ │ │ +000170b0: 696e 616c 2077 696e 646f 772e 0a74 6572 inal window..ter │ │ │ │ │ +000170c0: 6d69 6e61 6c2d 746f 7020 2020 2020 2020 minal-top │ │ │ │ │ +000170d0: 2020 2020 5370 6563 6966 6965 7320 7468 Specifies th │ │ │ │ │ +000170e0: 6520 746f 7020 636f 6f72 6469 6e61 7465 e top coordinate │ │ │ │ │ +000170f0: 206f 6620 7468 650a 2020 2020 2020 2020 of the. │ │ │ │ │ +00017100: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ │ +00017110: 6572 6d69 6e61 6c20 7769 6e64 6f77 2e0a erminal window.. │ │ │ │ │ +00017120: 7465 726d 696e 616c 2d77 6964 7468 2020 terminal-width │ │ │ │ │ +00017130: 2020 2020 2020 2053 7065 6369 6669 6573 Specifies │ │ │ │ │ +00017140: 2074 6865 2077 6964 7468 206f 6620 7468 the width of th │ │ │ │ │ +00017150: 6520 7465 726d 696e 616c 0a20 2020 2020 e terminal. │ │ │ │ │ 00017160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017170: 7769 6e64 6f77 2e0a 7465 726d 696e 616c window..terminal │ │ │ │ │ -00017180: 2d68 6569 6768 7420 2020 2020 2020 2053 -height S │ │ │ │ │ -00017190: 7065 6369 6669 6573 2074 6865 2068 6569 pecifies the hei │ │ │ │ │ -000171a0: 6768 7420 6f66 2074 6865 2074 6572 6d69 ght of the termi │ │ │ │ │ -000171b0: 6e61 6c0a 2020 2020 2020 2020 2020 2020 nal. │ │ │ │ │ -000171c0: 2020 2020 2020 2020 2020 2077 696e 646f windo │ │ │ │ │ -000171d0: 772e 0a0a 372e 332e 3420 436f 6d70 6f6e w...7.3.4 Compon │ │ │ │ │ -000171e0: 656e 7420 436f 6e73 7472 7563 7469 6f6e ent Construction │ │ │ │ │ -000171f0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -00017200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a47 -------------..G │ │ │ │ │ -00017210: 7265 6174 6572 2063 7573 746f 6d69 7a61 reater customiza │ │ │ │ │ -00017220: 6269 6c69 7479 2063 6f6d 6573 2069 7320 bility comes is │ │ │ │ │ -00017230: 7072 6f76 6964 6564 2062 7920 636f 6d70 provided by comp │ │ │ │ │ -00017240: 6f6e 656e 7473 2e20 2041 2074 7265 6520 onents. A tree │ │ │ │ │ -00017250: 6f66 0a63 6f6d 706f 6e65 6e74 7320 666f of.components fo │ │ │ │ │ -00017260: 726d 7320 7468 6520 7573 6572 2069 6e74 rms the user int │ │ │ │ │ -00017270: 6572 6661 6365 2e20 202a 436f 6e74 6169 erface. *Contai │ │ │ │ │ -00017280: 6e65 7273 2a20 6172 6520 636f 6d70 6f6e ners* are compon │ │ │ │ │ -00017290: 656e 7473 2074 6861 740a 6361 6e20 636f ents that.can co │ │ │ │ │ -000172a0: 6e74 6169 6e20 6f74 6865 7220 636f 6d70 ntain other comp │ │ │ │ │ -000172b0: 6f6e 656e 7473 2c20 616e 6420 7468 6572 onents, and ther │ │ │ │ │ -000172c0: 6520 6973 2061 6c77 6179 7320 6120 7369 e is always a si │ │ │ │ │ -000172d0: 6e67 6c65 2072 6f6f 740a 636f 6d70 6f6e ngle root.compon │ │ │ │ │ -000172e0: 656e 7420 7768 6963 6820 6973 2061 6e20 ent which is an │ │ │ │ │ -000172f0: 696e 7374 616e 6365 206f 6620 6120 2a63 instance of a *c │ │ │ │ │ -00017300: 616e 7661 732a 2063 6f6e 7461 696e 6572 anvas* container │ │ │ │ │ -00017310: 2e0a 0a20 2020 436f 6d70 6f6e 656e 7473 ... Components │ │ │ │ │ -00017320: 2061 7265 2063 7265 6174 6564 2069 6e20 are created in │ │ │ │ │ -00017330: 7468 6520 7468 656d 6520 6669 6c65 2062 the theme file b │ │ │ │ │ -00017340: 7920 7072 6566 6978 696e 6720 7468 6520 y prefixing the │ │ │ │ │ -00017350: 7479 7065 206f 660a 636f 6d70 6f6e 656e type of.componen │ │ │ │ │ -00017360: 7420 7769 7468 2061 2027 2b27 2073 6967 t with a '+' sig │ │ │ │ │ -00017370: 6e3a 0a0a 2020 2027 202b 206c 6162 656c n:.. ' + label │ │ │ │ │ -00017380: 207b 2074 6578 743d 2247 5255 4222 2066 { text="GRUB" f │ │ │ │ │ -00017390: 6f6e 743d 2261 7175 6920 3131 2220 636f ont="aqui 11" co │ │ │ │ │ -000173a0: 6c6f 723d 2223 3846 4622 207d 2027 0a0a lor="#8FF" } '.. │ │ │ │ │ -000173b0: 2020 2070 726f 7065 7274 6965 7320 6f66 properties of │ │ │ │ │ -000173c0: 2061 2063 6f6d 706f 6e65 6e74 2061 7265 a component are │ │ │ │ │ -000173d0: 2073 7065 6369 6669 6564 2061 7320 226e specified as "n │ │ │ │ │ -000173e0: 616d 6520 3d20 7661 6c75 6522 2028 7768 ame = value" (wh │ │ │ │ │ -000173f0: 6974 6573 7061 6365 0a73 7572 726f 756e itespace.surroun │ │ │ │ │ -00017400: 6469 6e67 2074 6f6b 656e 7320 6973 206f ding tokens is o │ │ │ │ │ -00017410: 7074 696f 6e61 6c20 616e 6420 6973 2069 ptional and is i │ │ │ │ │ -00017420: 676e 6f72 6564 2920 7768 6572 6520 2a76 gnored) where *v │ │ │ │ │ -00017430: 616c 7565 2a20 6d61 7920 6265 3a0a 2020 alue* may be:. │ │ │ │ │ -00017440: 202a 2061 2073 696e 676c 6520 776f 7264 * a single word │ │ │ │ │ -00017450: 2028 652e 672e 2c20 2261 6c69 676e 203d (e.g., "align = │ │ │ │ │ -00017460: 2063 656e 7465 7222 2c20 2263 6f6c 6f72 center", "color │ │ │ │ │ -00017470: 203d 2023 4646 3830 3830 2229 2c0a 2020 = #FF8080"),. │ │ │ │ │ -00017480: 202a 2061 2071 756f 7465 6420 7374 7269 * a quoted stri │ │ │ │ │ -00017490: 6e67 2028 652e 672e 2c20 2274 6578 7420 ng (e.g., "text │ │ │ │ │ -000174a0: 3d20 2248 656c 6c6f 2c20 576f 726c 6421 = "Hello, World! │ │ │ │ │ -000174b0: 2222 292c 206f 720a 2020 202a 2061 2074 ""), or. * a t │ │ │ │ │ -000174c0: 7570 6c65 2028 652e 672e 2c20 2270 7265 uple (e.g., "pre │ │ │ │ │ -000174d0: 6665 7272 6564 5f73 697a 6520 3d20 2831 ferred_size = (1 │ │ │ │ │ -000174e0: 3230 2c20 3830 2922 292e 0a0a 372e 332e 20, 80)")...7.3. │ │ │ │ │ -000174f0: 3520 436f 6d70 6f6e 656e 7420 4c69 7374 5 Component List │ │ │ │ │ -00017500: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ -00017510: 2d2d 2d2d 2d0a 0a54 6865 2066 6f6c 6c6f -----..The follo │ │ │ │ │ -00017520: 7769 6e67 2069 7320 6120 6c69 7374 206f wing is a list o │ │ │ │ │ -00017530: 6620 7468 6520 636f 6d70 6f6e 656e 7473 f the components │ │ │ │ │ -00017540: 2061 6e64 2074 6865 2070 726f 7065 7274 and the propert │ │ │ │ │ -00017550: 6965 7320 7468 6579 0a73 7570 706f 7274 ies they.support │ │ │ │ │ -00017560: 2e0a 0a20 2020 2a20 6c61 6265 6c20 4120 ... * label A │ │ │ │ │ -00017570: 6c61 6265 6c20 6469 7370 6c61 7973 2061 label displays a │ │ │ │ │ -00017580: 206c 696e 6520 6f66 2074 6578 742e 0a0a line of text... │ │ │ │ │ -00017590: 2020 2020 2050 726f 7065 7274 6965 733a Properties: │ │ │ │ │ -000175a0: 0a20 2020 2020 6964 2020 2020 2020 2020 . id │ │ │ │ │ -000175b0: 2020 2020 2053 6574 2074 6f20 225f 5f74 Set to "__t │ │ │ │ │ -000175c0: 696d 656f 7574 5f5f 2220 746f 2064 6973 imeout__" to dis │ │ │ │ │ -000175d0: 706c 6179 2074 6865 2074 696d 6520 656c play the time el │ │ │ │ │ -000175e0: 6170 7365 640a 2020 2020 2020 2020 2020 apsed. │ │ │ │ │ -000175f0: 2020 2020 2020 2020 2020 746f 2061 6e20 to an │ │ │ │ │ -00017600: 6175 746f 6d61 7469 6361 6c20 626f 6f74 automatical boot │ │ │ │ │ -00017610: 206f 6620 7468 6520 6465 6661 756c 7420 of the default │ │ │ │ │ -00017620: 656e 7472 792e 0a20 2020 2020 7465 7874 entry.. text │ │ │ │ │ -00017630: 2020 2020 2020 2020 2020 2054 6865 2074 The t │ │ │ │ │ -00017640: 6578 7420 746f 2064 6973 706c 6179 2e20 ext to display. │ │ │ │ │ -00017650: 2049 6620 2269 6422 2069 7320 7365 7420 If "id" is set │ │ │ │ │ -00017660: 746f 0a20 2020 2020 2020 2020 2020 2020 to. │ │ │ │ │ -00017670: 2020 2020 2020 2022 5f5f 7469 6d65 6f75 "__timeou │ │ │ │ │ -00017680: 745f 5f22 2061 6e64 206e 6f20 2274 6578 t__" and no "tex │ │ │ │ │ -00017690: 7422 2070 726f 7065 7274 7920 6973 2073 t" property is s │ │ │ │ │ -000176a0: 6574 2074 6865 6e0a 2020 2020 2020 2020 et then. │ │ │ │ │ -000176b0: 2020 2020 2020 2020 2020 2020 7468 6520 the │ │ │ │ │ -000176c0: 616d 6f75 6e74 206f 6620 7365 636f 6e64 amount of second │ │ │ │ │ -000176d0: 7320 7769 6c6c 2062 6520 7368 6f77 6e2e s will be shown. │ │ │ │ │ -000176e0: 2020 4966 2073 6574 2074 6f0a 2020 2020 If set to. │ │ │ │ │ +00017170: 2020 7769 6e64 6f77 2e0a 7465 726d 696e window..termin │ │ │ │ │ +00017180: 616c 2d68 6569 6768 7420 2020 2020 2020 al-height │ │ │ │ │ +00017190: 2053 7065 6369 6669 6573 2074 6865 2068 Specifies the h │ │ │ │ │ +000171a0: 6569 6768 7420 6f66 2074 6865 2074 6572 eight of the ter │ │ │ │ │ +000171b0: 6d69 6e61 6c0a 2020 2020 2020 2020 2020 minal. │ │ │ │ │ +000171c0: 2020 2020 2020 2020 2020 2020 2077 696e win │ │ │ │ │ +000171d0: 646f 772e 0a0a 372e 332e 3420 436f 6d70 dow...7.3.4 Comp │ │ │ │ │ +000171e0: 6f6e 656e 7420 436f 6e73 7472 7563 7469 onent Constructi │ │ │ │ │ +000171f0: 6f6e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d on.------------- │ │ │ │ │ +00017200: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00017210: 0a47 7265 6174 6572 2063 7573 746f 6d69 .Greater customi │ │ │ │ │ +00017220: 7a61 6269 6c69 7479 2063 6f6d 6573 2069 zability comes i │ │ │ │ │ +00017230: 7320 7072 6f76 6964 6564 2062 7920 636f s provided by co │ │ │ │ │ +00017240: 6d70 6f6e 656e 7473 2e20 2041 2074 7265 mponents. A tre │ │ │ │ │ +00017250: 6520 6f66 0a63 6f6d 706f 6e65 6e74 7320 e of.components │ │ │ │ │ +00017260: 666f 726d 7320 7468 6520 7573 6572 2069 forms the user i │ │ │ │ │ +00017270: 6e74 6572 6661 6365 2e20 202a 436f 6e74 nterface. *Cont │ │ │ │ │ +00017280: 6169 6e65 7273 2a20 6172 6520 636f 6d70 ainers* are comp │ │ │ │ │ +00017290: 6f6e 656e 7473 2074 6861 740a 6361 6e20 onents that.can │ │ │ │ │ +000172a0: 636f 6e74 6169 6e20 6f74 6865 7220 636f contain other co │ │ │ │ │ +000172b0: 6d70 6f6e 656e 7473 2c20 616e 6420 7468 mponents, and th │ │ │ │ │ +000172c0: 6572 6520 6973 2061 6c77 6179 7320 6120 ere is always a │ │ │ │ │ +000172d0: 7369 6e67 6c65 2072 6f6f 740a 636f 6d70 single root.comp │ │ │ │ │ +000172e0: 6f6e 656e 7420 7768 6963 6820 6973 2061 onent which is a │ │ │ │ │ +000172f0: 6e20 696e 7374 616e 6365 206f 6620 6120 n instance of a │ │ │ │ │ +00017300: 2a63 616e 7661 732a 2063 6f6e 7461 696e *canvas* contain │ │ │ │ │ +00017310: 6572 2e0a 0a20 2020 436f 6d70 6f6e 656e er... Componen │ │ │ │ │ +00017320: 7473 2061 7265 2063 7265 6174 6564 2069 ts are created i │ │ │ │ │ +00017330: 6e20 7468 6520 7468 656d 6520 6669 6c65 n the theme file │ │ │ │ │ +00017340: 2062 7920 7072 6566 6978 696e 6720 7468 by prefixing th │ │ │ │ │ +00017350: 6520 7479 7065 206f 660a 636f 6d70 6f6e e type of.compon │ │ │ │ │ +00017360: 656e 7420 7769 7468 2061 2027 2b27 2073 ent with a '+' s │ │ │ │ │ +00017370: 6967 6e3a 0a0a 2020 2027 202b 206c 6162 ign:.. ' + lab │ │ │ │ │ +00017380: 656c 207b 2074 6578 743d 2247 5255 4222 el { text="GRUB" │ │ │ │ │ +00017390: 2066 6f6e 743d 2261 7175 6920 3131 2220 font="aqui 11" │ │ │ │ │ +000173a0: 636f 6c6f 723d 2223 3846 4622 207d 2027 color="#8FF" } ' │ │ │ │ │ +000173b0: 0a0a 2020 2070 726f 7065 7274 6965 7320 .. properties │ │ │ │ │ +000173c0: 6f66 2061 2063 6f6d 706f 6e65 6e74 2061 of a component a │ │ │ │ │ +000173d0: 7265 2073 7065 6369 6669 6564 2061 7320 re specified as │ │ │ │ │ +000173e0: 226e 616d 6520 3d20 7661 6c75 6522 2028 "name = value" ( │ │ │ │ │ +000173f0: 7768 6974 6573 7061 6365 0a73 7572 726f whitespace.surro │ │ │ │ │ +00017400: 756e 6469 6e67 2074 6f6b 656e 7320 6973 unding tokens is │ │ │ │ │ +00017410: 206f 7074 696f 6e61 6c20 616e 6420 6973 optional and is │ │ │ │ │ +00017420: 2069 676e 6f72 6564 2920 7768 6572 6520 ignored) where │ │ │ │ │ +00017430: 2a76 616c 7565 2a20 6d61 7920 6265 3a0a *value* may be:. │ │ │ │ │ +00017440: 2020 202a 2061 2073 696e 676c 6520 776f * a single wo │ │ │ │ │ +00017450: 7264 2028 652e 672e 2c20 2261 6c69 676e rd (e.g., "align │ │ │ │ │ +00017460: 203d 2063 656e 7465 7222 2c20 2263 6f6c = center", "col │ │ │ │ │ +00017470: 6f72 203d 2023 4646 3830 3830 2229 2c0a or = #FF8080"),. │ │ │ │ │ +00017480: 2020 202a 2061 2071 756f 7465 6420 7374 * a quoted st │ │ │ │ │ +00017490: 7269 6e67 2028 652e 672e 2c20 2274 6578 ring (e.g., "tex │ │ │ │ │ +000174a0: 7420 3d20 2248 656c 6c6f 2c20 576f 726c t = "Hello, Worl │ │ │ │ │ +000174b0: 6421 2222 292c 206f 720a 2020 202a 2061 d!""), or. * a │ │ │ │ │ +000174c0: 2074 7570 6c65 2028 652e 672e 2c20 2270 tuple (e.g., "p │ │ │ │ │ +000174d0: 7265 6665 7272 6564 5f73 697a 6520 3d20 referred_size = │ │ │ │ │ +000174e0: 2831 3230 2c20 3830 2922 292e 0a0a 372e (120, 80)")...7. │ │ │ │ │ +000174f0: 332e 3520 436f 6d70 6f6e 656e 7420 4c69 3.5 Component Li │ │ │ │ │ +00017500: 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d st.------------- │ │ │ │ │ +00017510: 2d2d 2d2d 2d2d 2d0a 0a54 6865 2066 6f6c -------..The fol │ │ │ │ │ +00017520: 6c6f 7769 6e67 2069 7320 6120 6c69 7374 lowing is a list │ │ │ │ │ +00017530: 206f 6620 7468 6520 636f 6d70 6f6e 656e of the componen │ │ │ │ │ +00017540: 7473 2061 6e64 2074 6865 2070 726f 7065 ts and the prope │ │ │ │ │ +00017550: 7274 6965 7320 7468 6579 0a73 7570 706f rties they.suppo │ │ │ │ │ +00017560: 7274 2e0a 0a20 2020 2a20 6c61 6265 6c20 rt... * label │ │ │ │ │ +00017570: 4120 6c61 6265 6c20 6469 7370 6c61 7973 A label displays │ │ │ │ │ +00017580: 2061 206c 696e 6520 6f66 2074 6578 742e a line of text. │ │ │ │ │ +00017590: 0a0a 2020 2020 2050 726f 7065 7274 6965 .. Propertie │ │ │ │ │ +000175a0: 733a 0a20 2020 2020 6964 2020 2020 2020 s:. id │ │ │ │ │ +000175b0: 2020 2020 2020 2053 6574 2074 6f20 225f Set to "_ │ │ │ │ │ +000175c0: 5f74 696d 656f 7574 5f5f 2220 746f 2064 _timeout__" to d │ │ │ │ │ +000175d0: 6973 706c 6179 2074 6865 2074 696d 6520 isplay the time │ │ │ │ │ +000175e0: 656c 6170 7365 640a 2020 2020 2020 2020 elapsed. │ │ │ │ │ +000175f0: 2020 2020 2020 2020 2020 2020 746f 2061 to a │ │ │ │ │ +00017600: 6e20 6175 746f 6d61 7469 6361 6c20 626f n automatical bo │ │ │ │ │ +00017610: 6f74 206f 6620 7468 6520 6465 6661 756c ot of the defaul │ │ │ │ │ +00017620: 7420 656e 7472 792e 0a20 2020 2020 7465 t entry.. te │ │ │ │ │ +00017630: 7874 2020 2020 2020 2020 2020 2054 6865 xt The │ │ │ │ │ +00017640: 2074 6578 7420 746f 2064 6973 706c 6179 text to display │ │ │ │ │ +00017650: 2e20 2049 6620 2269 6422 2069 7320 7365 . If "id" is se │ │ │ │ │ +00017660: 7420 746f 0a20 2020 2020 2020 2020 2020 t to. │ │ │ │ │ +00017670: 2020 2020 2020 2020 2022 5f5f 7469 6d65 "__time │ │ │ │ │ +00017680: 6f75 745f 5f22 2061 6e64 206e 6f20 2274 out__" and no "t │ │ │ │ │ +00017690: 6578 7422 2070 726f 7065 7274 7920 6973 ext" property is │ │ │ │ │ +000176a0: 2073 6574 2074 6865 6e0a 2020 2020 2020 set then. │ │ │ │ │ +000176b0: 2020 2020 2020 2020 2020 2020 2020 7468 th │ │ │ │ │ +000176c0: 6520 616d 6f75 6e74 206f 6620 7365 636f e amount of seco │ │ │ │ │ +000176d0: 6e64 7320 7769 6c6c 2062 6520 7368 6f77 nds will be show │ │ │ │ │ +000176e0: 6e2e 2020 4966 2073 6574 2074 6f0a 2020 n. If set to. │ │ │ │ │ 000176f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017700: 2240 4b45 594d 4150 5f53 484f 5254 4022 "@KEYMAP_SHORT@" │ │ │ │ │ -00017710: 2c20 2240 4b45 594d 4150 5f4d 4944 444c , "@KEYMAP_MIDDL │ │ │ │ │ -00017720: 4540 2220 6f72 0a20 2020 2020 2020 2020 E@" or. │ │ │ │ │ -00017730: 2020 2020 2020 2020 2020 2022 404b 4559 "@KEY │ │ │ │ │ -00017740: 4d41 505f 4c4f 4e47 4022 2074 6865 6e20 MAP_LONG@" then │ │ │ │ │ -00017750: 7072 6564 6566 696e 6564 2068 6f74 6b65 predefined hotke │ │ │ │ │ -00017760: 790a 2020 2020 2020 2020 2020 2020 2020 y. │ │ │ │ │ -00017770: 2020 2020 2020 696e 666f 726d 6174 696f informatio │ │ │ │ │ -00017780: 6e20 7769 6c6c 2062 6520 7368 6f77 6e2e n will be shown. │ │ │ │ │ -00017790: 0a20 2020 2020 666f 6e74 2020 2020 2020 . font │ │ │ │ │ -000177a0: 2020 2020 2054 6865 2066 6f6e 7420 746f The font to │ │ │ │ │ -000177b0: 2075 7365 2066 6f72 2074 6578 7420 6469 use for text di │ │ │ │ │ -000177c0: 7370 6c61 792e 0a20 2020 2020 636f 6c6f splay.. colo │ │ │ │ │ -000177d0: 7220 2020 2020 2020 2020 2054 6865 2063 r The c │ │ │ │ │ -000177e0: 6f6c 6f72 206f 6620 7468 6520 7465 7874 olor of the text │ │ │ │ │ -000177f0: 2e0a 2020 2020 2061 6c69 676e 2020 2020 .. align │ │ │ │ │ -00017800: 2020 2020 2020 5468 6520 686f 7269 7a6f The horizo │ │ │ │ │ -00017810: 6e74 616c 2061 6c69 676e 6d65 6e74 206f ntal alignment o │ │ │ │ │ -00017820: 6620 7468 6520 7465 7874 2077 6974 6869 f the text withi │ │ │ │ │ -00017830: 6e20 7468 650a 2020 2020 2020 2020 2020 n the. │ │ │ │ │ -00017840: 2020 2020 2020 2020 2020 636f 6d70 6f6e compon │ │ │ │ │ -00017850: 656e 742e 2020 4f70 7469 6f6e 7320 6172 ent. Options ar │ │ │ │ │ -00017860: 6520 226c 6566 7422 2c20 2263 656e 7465 e "left", "cente │ │ │ │ │ -00017870: 7222 2061 6e64 0a20 2020 2020 2020 2020 r" and. │ │ │ │ │ -00017880: 2020 2020 2020 2020 2020 2022 7269 6768 "righ │ │ │ │ │ -00017890: 7422 2e0a 2020 2020 2076 6973 6962 6c65 t".. visible │ │ │ │ │ -000178a0: 2020 2020 2020 2020 5365 7420 746f 2022 Set to " │ │ │ │ │ -000178b0: 6661 6c73 6522 2074 6f20 6869 6465 2074 false" to hide t │ │ │ │ │ -000178c0: 6865 206c 6162 656c 2e0a 0a20 2020 2a20 he label... * │ │ │ │ │ -000178d0: 696d 6167 6520 4120 636f 6d70 6f6e 656e image A componen │ │ │ │ │ -000178e0: 7420 7468 6174 2064 6973 706c 6179 7320 t that displays │ │ │ │ │ -000178f0: 616e 2069 6d61 6765 2e20 2054 6865 2069 an image. The i │ │ │ │ │ -00017900: 6d61 6765 2069 7320 7363 616c 6564 2074 mage is scaled t │ │ │ │ │ -00017910: 6f0a 2020 2020 2066 6974 2074 6865 2063 o. fit the c │ │ │ │ │ -00017920: 6f6d 706f 6e65 6e74 2e0a 0a20 2020 2020 omponent... │ │ │ │ │ -00017930: 5072 6f70 6572 7469 6573 3a0a 0a20 2020 Properties:.. │ │ │ │ │ -00017940: 2020 6669 6c65 2020 2020 2020 2020 2020 file │ │ │ │ │ -00017950: 2054 6865 2066 756c 6c20 7061 7468 2074 The full path t │ │ │ │ │ -00017960: 6f20 7468 6520 696d 6167 6520 6669 6c65 o the image file │ │ │ │ │ -00017970: 2074 6f20 6c6f 6164 2e0a 0a20 2020 2a20 to load... * │ │ │ │ │ -00017980: 7072 6f67 7265 7373 5f62 6172 2044 6973 progress_bar Dis │ │ │ │ │ -00017990: 706c 6179 7320 6120 686f 7269 7a6f 6e74 plays a horizont │ │ │ │ │ -000179a0: 616c 6c79 206f 7269 656e 7465 6420 7072 ally oriented pr │ │ │ │ │ -000179b0: 6f67 7265 7373 2062 6172 2e20 2049 7420 ogress bar. It │ │ │ │ │ -000179c0: 6361 6e0a 2020 2020 2062 6520 7265 6e64 can. be rend │ │ │ │ │ -000179d0: 6572 6564 2075 7369 6e67 2073 696d 706c ered using simpl │ │ │ │ │ -000179e0: 6520 736f 6c69 6420 6669 6c6c 6564 2072 e solid filled r │ │ │ │ │ -000179f0: 6563 7461 6e67 6c65 732c 206f 7220 7573 ectangles, or us │ │ │ │ │ -00017a00: 696e 6720 6120 7061 6972 0a20 2020 2020 ing a pair. │ │ │ │ │ -00017a10: 6f66 2070 6978 6d61 7020 7374 796c 6564 of pixmap styled │ │ │ │ │ -00017a20: 2062 6f78 6573 2e0a 0a20 2020 2020 5072 boxes... Pr │ │ │ │ │ -00017a30: 6f70 6572 7469 6573 3a0a 0a20 2020 2020 operties:.. │ │ │ │ │ -00017a40: 6964 2020 2020 2020 2020 2020 2020 2053 id S │ │ │ │ │ -00017a50: 6574 2074 6f20 225f 5f74 696d 656f 7574 et to "__timeout │ │ │ │ │ -00017a60: 5f5f 2220 746f 2064 6973 706c 6179 2074 __" to display t │ │ │ │ │ -00017a70: 6865 2074 696d 6520 656c 6170 7365 640a he time elapsed. │ │ │ │ │ -00017a80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017a90: 2020 2020 746f 2061 6e20 6175 746f 6d61 to an automa │ │ │ │ │ -00017aa0: 7469 6361 6c20 626f 6f74 206f 6620 7468 tical boot of th │ │ │ │ │ -00017ab0: 6520 6465 6661 756c 7420 656e 7472 792e e default entry. │ │ │ │ │ -00017ac0: 0a20 2020 2020 6667 5f63 6f6c 6f72 2020 . fg_color │ │ │ │ │ -00017ad0: 2020 2020 2054 6865 2066 6f72 6567 726f The foregro │ │ │ │ │ -00017ae0: 756e 6420 636f 6c6f 7220 666f 7220 706c und color for pl │ │ │ │ │ -00017af0: 6169 6e20 736f 6c69 6420 636f 6c6f 720a ain solid color. │ │ │ │ │ -00017b00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017b10: 2020 2020 7265 6e64 6572 696e 672e 0a20 rendering.. │ │ │ │ │ -00017b20: 2020 2020 6267 5f63 6f6c 6f72 2020 2020 bg_color │ │ │ │ │ -00017b30: 2020 2054 6865 2062 6163 6b67 726f 756e The backgroun │ │ │ │ │ -00017b40: 6420 636f 6c6f 7220 666f 7220 706c 6169 d color for plai │ │ │ │ │ -00017b50: 6e20 736f 6c69 6420 636f 6c6f 720a 2020 n solid color. │ │ │ │ │ +00017700: 2020 2240 4b45 594d 4150 5f53 484f 5254 "@KEYMAP_SHORT │ │ │ │ │ +00017710: 4022 2c20 2240 4b45 594d 4150 5f4d 4944 @", "@KEYMAP_MID │ │ │ │ │ +00017720: 444c 4540 2220 6f72 0a20 2020 2020 2020 DLE@" or. │ │ │ │ │ +00017730: 2020 2020 2020 2020 2020 2020 2022 404b "@K │ │ │ │ │ +00017740: 4559 4d41 505f 4c4f 4e47 4022 2074 6865 EYMAP_LONG@" the │ │ │ │ │ +00017750: 6e20 7072 6564 6566 696e 6564 2068 6f74 n predefined hot │ │ │ │ │ +00017760: 6b65 790a 2020 2020 2020 2020 2020 2020 key. │ │ │ │ │ +00017770: 2020 2020 2020 2020 696e 666f 726d 6174 informat │ │ │ │ │ +00017780: 696f 6e20 7769 6c6c 2062 6520 7368 6f77 ion will be show │ │ │ │ │ +00017790: 6e2e 0a20 2020 2020 666f 6e74 2020 2020 n.. font │ │ │ │ │ +000177a0: 2020 2020 2020 2054 6865 2066 6f6e 7420 The font │ │ │ │ │ +000177b0: 746f 2075 7365 2066 6f72 2074 6578 7420 to use for text │ │ │ │ │ +000177c0: 6469 7370 6c61 792e 0a20 2020 2020 636f display.. co │ │ │ │ │ +000177d0: 6c6f 7220 2020 2020 2020 2020 2054 6865 lor The │ │ │ │ │ +000177e0: 2063 6f6c 6f72 206f 6620 7468 6520 7465 color of the te │ │ │ │ │ +000177f0: 7874 2e0a 2020 2020 2061 6c69 676e 2020 xt.. align │ │ │ │ │ +00017800: 2020 2020 2020 2020 5468 6520 686f 7269 The hori │ │ │ │ │ +00017810: 7a6f 6e74 616c 2061 6c69 676e 6d65 6e74 zontal alignment │ │ │ │ │ +00017820: 206f 6620 7468 6520 7465 7874 2077 6974 of the text wit │ │ │ │ │ +00017830: 6869 6e20 7468 650a 2020 2020 2020 2020 hin the. │ │ │ │ │ +00017840: 2020 2020 2020 2020 2020 2020 636f 6d70 comp │ │ │ │ │ +00017850: 6f6e 656e 742e 2020 4f70 7469 6f6e 7320 onent. Options │ │ │ │ │ +00017860: 6172 6520 226c 6566 7422 2c20 2263 656e are "left", "cen │ │ │ │ │ +00017870: 7465 7222 2061 6e64 0a20 2020 2020 2020 ter" and. │ │ │ │ │ +00017880: 2020 2020 2020 2020 2020 2020 2022 7269 "ri │ │ │ │ │ +00017890: 6768 7422 2e0a 2020 2020 2076 6973 6962 ght".. visib │ │ │ │ │ +000178a0: 6c65 2020 2020 2020 2020 5365 7420 746f le Set to │ │ │ │ │ +000178b0: 2022 6661 6c73 6522 2074 6f20 6869 6465 "false" to hide │ │ │ │ │ +000178c0: 2074 6865 206c 6162 656c 2e0a 0a20 2020 the label... │ │ │ │ │ +000178d0: 2a20 696d 6167 6520 4120 636f 6d70 6f6e * image A compon │ │ │ │ │ +000178e0: 656e 7420 7468 6174 2064 6973 706c 6179 ent that display │ │ │ │ │ +000178f0: 7320 616e 2069 6d61 6765 2e20 2054 6865 s an image. The │ │ │ │ │ +00017900: 2069 6d61 6765 2069 7320 7363 616c 6564 image is scaled │ │ │ │ │ +00017910: 2074 6f0a 2020 2020 2066 6974 2074 6865 to. fit the │ │ │ │ │ +00017920: 2063 6f6d 706f 6e65 6e74 2e0a 0a20 2020 component... │ │ │ │ │ +00017930: 2020 5072 6f70 6572 7469 6573 3a0a 0a20 Properties:.. │ │ │ │ │ +00017940: 2020 2020 6669 6c65 2020 2020 2020 2020 file │ │ │ │ │ +00017950: 2020 2054 6865 2066 756c 6c20 7061 7468 The full path │ │ │ │ │ +00017960: 2074 6f20 7468 6520 696d 6167 6520 6669 to the image fi │ │ │ │ │ +00017970: 6c65 2074 6f20 6c6f 6164 2e0a 0a20 2020 le to load... │ │ │ │ │ +00017980: 2a20 7072 6f67 7265 7373 5f62 6172 2044 * progress_bar D │ │ │ │ │ +00017990: 6973 706c 6179 7320 6120 686f 7269 7a6f isplays a horizo │ │ │ │ │ +000179a0: 6e74 616c 6c79 206f 7269 656e 7465 6420 ntally oriented │ │ │ │ │ +000179b0: 7072 6f67 7265 7373 2062 6172 2e20 2049 progress bar. I │ │ │ │ │ +000179c0: 7420 6361 6e0a 2020 2020 2062 6520 7265 t can. be re │ │ │ │ │ +000179d0: 6e64 6572 6564 2075 7369 6e67 2073 696d ndered using sim │ │ │ │ │ +000179e0: 706c 6520 736f 6c69 6420 6669 6c6c 6564 ple solid filled │ │ │ │ │ +000179f0: 2072 6563 7461 6e67 6c65 732c 206f 7220 rectangles, or │ │ │ │ │ +00017a00: 7573 696e 6720 6120 7061 6972 0a20 2020 using a pair. │ │ │ │ │ +00017a10: 2020 6f66 2070 6978 6d61 7020 7374 796c of pixmap styl │ │ │ │ │ +00017a20: 6564 2062 6f78 6573 2e0a 0a20 2020 2020 ed boxes... │ │ │ │ │ +00017a30: 5072 6f70 6572 7469 6573 3a0a 0a20 2020 Properties:.. │ │ │ │ │ +00017a40: 2020 6964 2020 2020 2020 2020 2020 2020 id │ │ │ │ │ +00017a50: 2053 6574 2074 6f20 225f 5f74 696d 656f Set to "__timeo │ │ │ │ │ +00017a60: 7574 5f5f 2220 746f 2064 6973 706c 6179 ut__" to display │ │ │ │ │ +00017a70: 2074 6865 2074 696d 6520 656c 6170 7365 the time elapse │ │ │ │ │ +00017a80: 640a 2020 2020 2020 2020 2020 2020 2020 d. │ │ │ │ │ +00017a90: 2020 2020 2020 746f 2061 6e20 6175 746f to an auto │ │ │ │ │ +00017aa0: 6d61 7469 6361 6c20 626f 6f74 206f 6620 matical boot of │ │ │ │ │ +00017ab0: 7468 6520 6465 6661 756c 7420 656e 7472 the default entr │ │ │ │ │ +00017ac0: 792e 0a20 2020 2020 6667 5f63 6f6c 6f72 y.. fg_color │ │ │ │ │ +00017ad0: 2020 2020 2020 2054 6865 2066 6f72 6567 The foreg │ │ │ │ │ +00017ae0: 726f 756e 6420 636f 6c6f 7220 666f 7220 round color for │ │ │ │ │ +00017af0: 706c 6169 6e20 736f 6c69 6420 636f 6c6f plain solid colo │ │ │ │ │ +00017b00: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ +00017b10: 2020 2020 2020 7265 6e64 6572 696e 672e rendering. │ │ │ │ │ +00017b20: 0a20 2020 2020 6267 5f63 6f6c 6f72 2020 . bg_color │ │ │ │ │ +00017b30: 2020 2020 2054 6865 2062 6163 6b67 726f The backgro │ │ │ │ │ +00017b40: 756e 6420 636f 6c6f 7220 666f 7220 706c und color for pl │ │ │ │ │ +00017b50: 6169 6e20 736f 6c69 6420 636f 6c6f 720a ain solid color. │ │ │ │ │ 00017b60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017b70: 2020 7265 6e64 6572 696e 672e 0a20 2020 rendering.. │ │ │ │ │ -00017b80: 2020 626f 7264 6572 5f63 6f6c 6f72 2020 border_color │ │ │ │ │ -00017b90: 2054 6865 2062 6f72 6465 7220 636f 6c6f The border colo │ │ │ │ │ -00017ba0: 7220 666f 7220 706c 6169 6e20 736f 6c69 r for plain soli │ │ │ │ │ -00017bb0: 6420 636f 6c6f 720a 2020 2020 2020 2020 d color. │ │ │ │ │ -00017bc0: 2020 2020 2020 2020 2020 2020 7265 6e64 rend │ │ │ │ │ -00017bd0: 6572 696e 672e 0a20 2020 2020 7465 7874 ering.. text │ │ │ │ │ -00017be0: 5f63 6f6c 6f72 2020 2020 2054 6865 2074 _color The t │ │ │ │ │ -00017bf0: 6578 7420 636f 6c6f 722e 0a20 2020 2020 ext color.. │ │ │ │ │ -00017c00: 6261 725f 7374 796c 6520 2020 2020 2054 bar_style T │ │ │ │ │ -00017c10: 6865 2073 7479 6c65 6420 626f 7820 7370 he styled box sp │ │ │ │ │ -00017c20: 6563 6966 6963 6174 696f 6e20 666f 7220 ecification for │ │ │ │ │ -00017c30: 7468 6520 6672 616d 6520 6f66 0a20 2020 the frame of. │ │ │ │ │ +00017b70: 2020 2020 7265 6e64 6572 696e 672e 0a20 rendering.. │ │ │ │ │ +00017b80: 2020 2020 626f 7264 6572 5f63 6f6c 6f72 border_color │ │ │ │ │ +00017b90: 2020 2054 6865 2062 6f72 6465 7220 636f The border co │ │ │ │ │ +00017ba0: 6c6f 7220 666f 7220 706c 6169 6e20 736f lor for plain so │ │ │ │ │ +00017bb0: 6c69 6420 636f 6c6f 720a 2020 2020 2020 lid color. │ │ │ │ │ +00017bc0: 2020 2020 2020 2020 2020 2020 2020 7265 re │ │ │ │ │ +00017bd0: 6e64 6572 696e 672e 0a20 2020 2020 7465 ndering.. te │ │ │ │ │ +00017be0: 7874 5f63 6f6c 6f72 2020 2020 2054 6865 xt_color The │ │ │ │ │ +00017bf0: 2074 6578 7420 636f 6c6f 722e 0a20 2020 text color.. │ │ │ │ │ +00017c00: 2020 6261 725f 7374 796c 6520 2020 2020 bar_style │ │ │ │ │ +00017c10: 2054 6865 2073 7479 6c65 6420 626f 7820 The styled box │ │ │ │ │ +00017c20: 7370 6563 6966 6963 6174 696f 6e20 666f specification fo │ │ │ │ │ +00017c30: 7220 7468 6520 6672 616d 6520 6f66 0a20 r the frame of. │ │ │ │ │ 00017c40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017c50: 2074 6865 2070 726f 6772 6573 7320 6261 the progress ba │ │ │ │ │ -00017c60: 722e 2020 4578 616d 706c 653a 0a20 2020 r. Example:. │ │ │ │ │ +00017c50: 2020 2074 6865 2070 726f 6772 6573 7320 the progress │ │ │ │ │ +00017c60: 6261 722e 2020 4578 616d 706c 653a 0a20 bar. Example:. │ │ │ │ │ 00017c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017c80: 2022 7072 6f67 7265 7373 5f66 7261 6d65 "progress_frame │ │ │ │ │ -00017c90: 5f2a 2e70 6e67 2220 4966 2074 6865 2076 _*.png" If the v │ │ │ │ │ -00017ca0: 616c 7565 2069 7320 6571 7561 6c20 746f alue is equal to │ │ │ │ │ -00017cb0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00017cc0: 2020 2020 2022 6869 6768 6c69 6768 745f "highlight_ │ │ │ │ │ -00017cd0: 7374 796c 6522 2074 6865 6e20 6e6f 2073 style" then no s │ │ │ │ │ -00017ce0: 7479 6c65 6420 626f 7865 7320 7769 6c6c tyled boxes will │ │ │ │ │ -00017cf0: 2062 650a 2020 2020 2020 2020 2020 2020 be. │ │ │ │ │ -00017d00: 2020 2020 2020 2020 7368 6f77 6e2e 0a20 shown.. │ │ │ │ │ -00017d10: 2020 2020 6869 6768 6c69 6768 745f 7374 highlight_st │ │ │ │ │ -00017d20: 796c 6554 6865 2073 7479 6c65 6420 626f yleThe styled bo │ │ │ │ │ -00017d30: 7820 7370 6563 6966 6963 6174 696f 6e20 x specification │ │ │ │ │ -00017d40: 666f 7220 7468 6520 6869 6768 6c69 6768 for the highligh │ │ │ │ │ -00017d50: 7465 640a 2020 2020 2020 2020 2020 2020 ted. │ │ │ │ │ -00017d60: 2020 2020 2020 2020 7265 6769 6f6e 206f region o │ │ │ │ │ -00017d70: 6620 7468 6520 7072 6f67 7265 7373 2062 f the progress b │ │ │ │ │ -00017d80: 6172 2e20 2054 6869 7320 626f 7820 7769 ar. This box wi │ │ │ │ │ -00017d90: 6c6c 2062 650a 2020 2020 2020 2020 2020 ll be. │ │ │ │ │ -00017da0: 2020 2020 2020 2020 2020 7573 6564 2074 used t │ │ │ │ │ -00017db0: 6f20 7061 696e 7420 6a75 7374 2074 6865 o paint just the │ │ │ │ │ -00017dc0: 2068 6967 686c 6967 6874 6564 2072 6567 highlighted reg │ │ │ │ │ -00017dd0: 696f 6e20 6f66 2074 6865 0a20 2020 2020 ion of the. │ │ │ │ │ -00017de0: 2020 2020 2020 2020 2020 2020 2020 2062 b │ │ │ │ │ -00017df0: 6172 2c20 616e 6420 7769 6c6c 2062 6520 ar, and will be │ │ │ │ │ -00017e00: 696e 6372 6561 7365 6420 696e 2073 697a increased in siz │ │ │ │ │ -00017e10: 6520 6173 2074 6865 2062 6172 0a20 2020 e as the bar. │ │ │ │ │ +00017c80: 2020 2022 7072 6f67 7265 7373 5f66 7261 "progress_fra │ │ │ │ │ +00017c90: 6d65 5f2a 2e70 6e67 2220 4966 2074 6865 me_*.png" If the │ │ │ │ │ +00017ca0: 2076 616c 7565 2069 7320 6571 7561 6c20 value is equal │ │ │ │ │ +00017cb0: 746f 0a20 2020 2020 2020 2020 2020 2020 to. │ │ │ │ │ +00017cc0: 2020 2020 2020 2022 6869 6768 6c69 6768 "highligh │ │ │ │ │ +00017cd0: 745f 7374 796c 6522 2074 6865 6e20 6e6f t_style" then no │ │ │ │ │ +00017ce0: 2073 7479 6c65 6420 626f 7865 7320 7769 styled boxes wi │ │ │ │ │ +00017cf0: 6c6c 2062 650a 2020 2020 2020 2020 2020 ll be. │ │ │ │ │ +00017d00: 2020 2020 2020 2020 2020 7368 6f77 6e2e shown. │ │ │ │ │ +00017d10: 0a20 2020 2020 6869 6768 6c69 6768 745f . highlight_ │ │ │ │ │ +00017d20: 7374 796c 6554 6865 2073 7479 6c65 6420 styleThe styled │ │ │ │ │ +00017d30: 626f 7820 7370 6563 6966 6963 6174 696f box specificatio │ │ │ │ │ +00017d40: 6e20 666f 7220 7468 6520 6869 6768 6c69 n for the highli │ │ │ │ │ +00017d50: 6768 7465 640a 2020 2020 2020 2020 2020 ghted. │ │ │ │ │ +00017d60: 2020 2020 2020 2020 2020 7265 6769 6f6e region │ │ │ │ │ +00017d70: 206f 6620 7468 6520 7072 6f67 7265 7373 of the progress │ │ │ │ │ +00017d80: 2062 6172 2e20 2054 6869 7320 626f 7820 bar. This box │ │ │ │ │ +00017d90: 7769 6c6c 2062 650a 2020 2020 2020 2020 will be. │ │ │ │ │ +00017da0: 2020 2020 2020 2020 2020 2020 7573 6564 used │ │ │ │ │ +00017db0: 2074 6f20 7061 696e 7420 6a75 7374 2074 to paint just t │ │ │ │ │ +00017dc0: 6865 2068 6967 686c 6967 6874 6564 2072 he highlighted r │ │ │ │ │ +00017dd0: 6567 696f 6e20 6f66 2074 6865 0a20 2020 egion of the. │ │ │ │ │ +00017de0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00017df0: 2062 6172 2c20 616e 6420 7769 6c6c 2062 bar, and will b │ │ │ │ │ +00017e00: 6520 696e 6372 6561 7365 6420 696e 2073 e increased in s │ │ │ │ │ +00017e10: 697a 6520 6173 2074 6865 2062 6172 0a20 ize as the bar. │ │ │ │ │ 00017e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00017e30: 206e 6561 7273 2063 6f6d 706c 6574 696f nears completio │ │ │ │ │ -00017e40: 6e2e 2020 4578 616d 706c 653a 2022 7072 n. Example: "pr │ │ │ │ │ -00017e50: 6f67 7265 7373 5f68 6c5f 2a2e 706e 6722 ogress_hl_*.png" │ │ │ │ │ -00017e60: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ -00017e70: 2020 2020 2020 4966 2074 6865 2076 616c If the val │ │ │ │ │ -00017e80: 7565 2069 7320 6571 7561 6c20 746f 2022 ue is equal to " │ │ │ │ │ -00017e90: 6261 725f 7374 796c 6522 2074 6865 6e20 bar_style" then │ │ │ │ │ -00017ea0: 6e6f 0a20 2020 2020 2020 2020 2020 2020 no. │ │ │ │ │ -00017eb0: 2020 2020 2020 2073 7479 6c65 6420 626f styled bo │ │ │ │ │ -00017ec0: 7865 7320 7769 6c6c 2062 6520 7368 6f77 xes will be show │ │ │ │ │ -00017ed0: 6e2e 0a20 2020 2020 6869 6768 6c69 6768 n.. highligh │ │ │ │ │ -00017ee0: 745f 6f76 6572 6c61 7949 6620 7468 6973 t_overlayIf this │ │ │ │ │ -00017ef0: 206f 7074 696f 6e20 6973 2073 6574 2074 option is set t │ │ │ │ │ -00017f00: 6f20 2274 7275 6522 2074 6865 6e20 7468 o "true" then th │ │ │ │ │ -00017f10: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ -00017f20: 2020 2020 2020 6869 6768 6c69 6768 7420 highlight │ │ │ │ │ -00017f30: 626f 7820 7369 6465 2073 6c69 6365 7320 box side slices │ │ │ │ │ -00017f40: 2865 7665 7279 2073 6c69 6365 2065 7863 (every slice exc │ │ │ │ │ -00017f50: 6570 740a 2020 2020 2020 2020 2020 2020 ept. │ │ │ │ │ -00017f60: 2020 2020 2020 2020 7468 6520 6365 6e74 the cent │ │ │ │ │ -00017f70: 6572 2073 6c69 6365 2920 7769 6c6c 206f er slice) will o │ │ │ │ │ -00017f80: 7665 726c 6179 2074 6865 2066 7261 6d65 verlay the frame │ │ │ │ │ -00017f90: 2062 6f78 0a20 2020 2020 2020 2020 2020 box. │ │ │ │ │ -00017fa0: 2020 2020 2020 2020 2073 6964 6520 736c side sl │ │ │ │ │ -00017fb0: 6963 6573 2e20 2041 6e64 2074 6865 2063 ices. And the c │ │ │ │ │ -00017fc0: 656e 7465 7220 736c 6963 6520 6f66 2074 enter slice of t │ │ │ │ │ -00017fd0: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ │ -00017fe0: 2020 2020 2020 2068 6967 686c 6967 6874 highlight │ │ │ │ │ -00017ff0: 2062 6f78 2063 616e 206d 6f76 6520 616c box can move al │ │ │ │ │ -00018000: 6c20 7468 6520 7761 7920 2866 726f 6d20 l the way (from │ │ │ │ │ -00018010: 746f 7020 746f 0a20 2020 2020 2020 2020 top to. │ │ │ │ │ -00018020: 2020 2020 2020 2020 2020 2062 6f74 746f botto │ │ │ │ │ -00018030: 6d29 2c20 6265 696e 6720 6472 6177 6e20 m), being drawn │ │ │ │ │ -00018040: 6f6e 2074 6865 2063 656e 7465 7220 736c on the center sl │ │ │ │ │ -00018050: 6963 6520 6f66 2074 6865 0a20 2020 2020 ice of the. │ │ │ │ │ -00018060: 2020 2020 2020 2020 2020 2020 2020 2066 f │ │ │ │ │ -00018070: 7261 6d65 2062 6f78 2e20 2054 6861 7420 rame box. That │ │ │ │ │ -00018080: 7761 7920 7765 2063 616e 206d 616b 6520 way we can make │ │ │ │ │ -00018090: 6120 7072 6f67 7265 7373 2062 6172 0a20 a progress bar. │ │ │ │ │ -000180a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000180b0: 2020 2077 6974 6820 726f 756e 642d 7368 with round-sh │ │ │ │ │ -000180c0: 6170 6564 2065 6467 6573 2073 6f20 7468 aped edges so th │ │ │ │ │ -000180d0: 6572 6520 776f 6e27 7420 6265 2061 2066 ere won't be a f │ │ │ │ │ -000180e0: 7265 650a 2020 2020 2020 2020 2020 2020 ree. │ │ │ │ │ -000180f0: 2020 2020 2020 2020 7370 6163 6520 6672 space fr │ │ │ │ │ -00018100: 6f6d 2074 6865 2068 6967 686c 6967 6874 om the highlight │ │ │ │ │ -00018110: 2074 6f20 7468 6520 6672 616d 6520 696e to the frame in │ │ │ │ │ -00018120: 2074 6f70 2061 6e64 0a20 2020 2020 2020 top and. │ │ │ │ │ -00018130: 2020 2020 2020 2020 2020 2020 2062 6f74 bot │ │ │ │ │ -00018140: 746f 6d20 7363 726f 6c6c 6261 7220 706f tom scrollbar po │ │ │ │ │ -00018150: 7369 7469 6f6e 732e 2020 4465 6661 756c sitions. Defaul │ │ │ │ │ -00018160: 7420 6973 2022 6661 6c73 6522 2e0a 2020 t is "false".. │ │ │ │ │ -00018170: 2020 2066 6f6e 7420 2020 2020 2020 2020 font │ │ │ │ │ -00018180: 2020 5468 6520 666f 6e74 2074 6f20 7573 The font to us │ │ │ │ │ -00018190: 6520 666f 7220 7072 6f67 7265 7373 2062 e for progress b │ │ │ │ │ -000181a0: 6172 2e0a 2020 2020 2074 6578 7420 2020 ar.. text │ │ │ │ │ -000181b0: 2020 2020 2020 2020 5468 6520 7465 7874 The text │ │ │ │ │ -000181c0: 2074 6f20 6469 7370 6c61 7920 6f6e 2074 to display on t │ │ │ │ │ -000181d0: 6865 2070 726f 6772 6573 7320 6261 722e he progress bar. │ │ │ │ │ -000181e0: 2020 4966 2074 6865 0a20 2020 2020 2020 If the. │ │ │ │ │ -000181f0: 2020 2020 2020 2020 2020 2020 2070 726f pro │ │ │ │ │ -00018200: 6772 6573 7320 6261 7227 7320 4944 2069 gress bar's ID i │ │ │ │ │ -00018210: 7320 7365 7420 746f 2022 5f5f 7469 6d65 s set to "__time │ │ │ │ │ -00018220: 6f75 745f 5f22 2061 6e64 0a20 2020 2020 out__" and. │ │ │ │ │ -00018230: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ │ -00018240: 6865 2076 616c 7565 206f 6620 7468 6973 he value of this │ │ │ │ │ -00018250: 2070 726f 7065 7274 7920 6973 2073 6574 property is set │ │ │ │ │ -00018260: 2074 6f0a 2020 2020 2020 2020 2020 2020 to. │ │ │ │ │ -00018270: 2020 2020 2020 2020 2240 5449 4d45 4f55 "@TIMEOU │ │ │ │ │ -00018280: 545f 4e4f 5449 4649 4341 5449 4f4e 5f53 T_NOTIFICATION_S │ │ │ │ │ -00018290: 484f 5254 4022 2c0a 2020 2020 2020 2020 HORT@",. │ │ │ │ │ -000182a0: 2020 2020 2020 2020 2020 2020 2240 5449 "@TI │ │ │ │ │ -000182b0: 4d45 4f55 545f 4e4f 5449 4649 4341 5449 MEOUT_NOTIFICATI │ │ │ │ │ -000182c0: 4f4e 5f4d 4944 444c 4540 2220 6f72 0a20 ON_MIDDLE@" or. │ │ │ │ │ -000182d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000182e0: 2020 2022 4054 494d 454f 5554 5f4e 4f54 "@TIMEOUT_NOT │ │ │ │ │ -000182f0: 4946 4943 4154 494f 4e5f 4c4f 4e47 4022 IFICATION_LONG@" │ │ │ │ │ -00018300: 2c20 7468 656e 2047 5255 4220 7769 6c6c , then GRUB will │ │ │ │ │ -00018310: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00018320: 2020 2020 2075 7064 6174 6520 7468 6973 update this │ │ │ │ │ -00018330: 2070 726f 7065 7274 7920 7769 7468 2061 property with a │ │ │ │ │ -00018340: 6e20 696e 666f 726d 6174 6976 6520 6d65 n informative me │ │ │ │ │ -00018350: 7373 6167 650a 2020 2020 2020 2020 2020 ssage. │ │ │ │ │ -00018360: 2020 2020 2020 2020 2020 6173 2074 6865 as the │ │ │ │ │ -00018370: 2074 696d 656f 7574 2061 7070 726f 6163 timeout approac │ │ │ │ │ -00018380: 6865 732e 0a0a 2020 202a 2063 6972 6375 hes... * circu │ │ │ │ │ -00018390: 6c61 725f 7072 6f67 7265 7373 2044 6973 lar_progress Dis │ │ │ │ │ -000183a0: 706c 6179 7320 6120 6369 7263 756c 6172 plays a circular │ │ │ │ │ -000183b0: 2070 726f 6772 6573 7320 696e 6469 6361 progress indica │ │ │ │ │ -000183c0: 746f 722e 2020 5468 650a 2020 2020 2061 tor. The. a │ │ │ │ │ -000183d0: 7070 6561 7261 6e63 6520 6f66 2074 6869 ppearance of thi │ │ │ │ │ -000183e0: 7320 636f 6d70 6f6e 656e 7420 6973 2064 s component is d │ │ │ │ │ -000183f0: 6574 6572 6d69 6e65 6420 6279 2074 776f etermined by two │ │ │ │ │ -00018400: 2069 6d61 6765 733a 2074 6865 0a20 2020 images: the. │ │ │ │ │ -00018410: 2020 2a63 656e 7465 722a 2069 6d61 6765 *center* image │ │ │ │ │ -00018420: 2061 6e64 2074 6865 202a 7469 636b 2a20 and the *tick* │ │ │ │ │ -00018430: 696d 6167 652e 2020 5468 6520 6365 6e74 image. The cent │ │ │ │ │ -00018440: 6572 2069 6d61 6765 2069 7320 6765 6e65 er image is gene │ │ │ │ │ -00018450: 7261 6c6c 790a 2020 2020 206c 6172 6765 rally. large │ │ │ │ │ -00018460: 7220 616e 6420 7769 6c6c 2062 6520 6472 r and will be dr │ │ │ │ │ -00018470: 6177 6e20 696e 2074 6865 2063 656e 7465 awn in the cente │ │ │ │ │ -00018480: 7220 6f66 2074 6865 2063 6f6d 706f 6e65 r of the compone │ │ │ │ │ -00018490: 6e74 2e20 2041 726f 756e 640a 2020 2020 nt. Around. │ │ │ │ │ -000184a0: 2074 6865 2063 6972 6375 6d66 6572 656e the circumferen │ │ │ │ │ -000184b0: 6365 206f 6620 6120 6369 7263 6c65 2077 ce of a circle w │ │ │ │ │ -000184c0: 6974 6869 6e20 7468 6520 636f 6d70 6f6e ithin the compon │ │ │ │ │ -000184d0: 656e 742c 2074 6865 2074 6963 6b20 696d ent, the tick im │ │ │ │ │ -000184e0: 6167 650a 2020 2020 2077 696c 6c20 6265 age. will be │ │ │ │ │ -000184f0: 2064 7261 776e 2061 2063 6572 7461 696e drawn a certain │ │ │ │ │ -00018500: 206e 756d 6265 7220 6f66 2074 696d 6573 number of times │ │ │ │ │ -00018510: 2c20 6465 7065 6e64 696e 6720 6f6e 2074 , depending on t │ │ │ │ │ -00018520: 6865 0a20 2020 2020 7072 6f70 6572 7469 he. properti │ │ │ │ │ -00018530: 6573 206f 6620 7468 6520 636f 6d70 6f6e es of the compon │ │ │ │ │ -00018540: 656e 742e 0a0a 2020 2020 2050 726f 7065 ent... Prope │ │ │ │ │ -00018550: 7274 6965 733a 0a0a 2020 2020 2069 6420 rties:.. id │ │ │ │ │ -00018560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018570: 2020 2020 5365 7420 746f 2022 5f5f 7469 Set to "__ti │ │ │ │ │ -00018580: 6d65 6f75 745f 5f22 2074 6f20 6469 7370 meout__" to disp │ │ │ │ │ -00018590: 6c61 7920 7468 6520 7469 6d65 0a20 2020 lay the time. │ │ │ │ │ +00017e30: 2020 206e 6561 7273 2063 6f6d 706c 6574 nears complet │ │ │ │ │ +00017e40: 696f 6e2e 2020 4578 616d 706c 653a 2022 ion. Example: " │ │ │ │ │ +00017e50: 7072 6f67 7265 7373 5f68 6c5f 2a2e 706e progress_hl_*.pn │ │ │ │ │ +00017e60: 6722 2e0a 2020 2020 2020 2020 2020 2020 g".. │ │ │ │ │ +00017e70: 2020 2020 2020 2020 4966 2074 6865 2076 If the v │ │ │ │ │ +00017e80: 616c 7565 2069 7320 6571 7561 6c20 746f alue is equal to │ │ │ │ │ +00017e90: 2022 6261 725f 7374 796c 6522 2074 6865 "bar_style" the │ │ │ │ │ +00017ea0: 6e20 6e6f 0a20 2020 2020 2020 2020 2020 n no. │ │ │ │ │ +00017eb0: 2020 2020 2020 2020 2073 7479 6c65 6420 styled │ │ │ │ │ +00017ec0: 626f 7865 7320 7769 6c6c 2062 6520 7368 boxes will be sh │ │ │ │ │ +00017ed0: 6f77 6e2e 0a20 2020 2020 6869 6768 6c69 own.. highli │ │ │ │ │ +00017ee0: 6768 745f 6f76 6572 6c61 7949 6620 7468 ght_overlayIf th │ │ │ │ │ +00017ef0: 6973 206f 7074 696f 6e20 6973 2073 6574 is option is set │ │ │ │ │ +00017f00: 2074 6f20 2274 7275 6522 2074 6865 6e20 to "true" then │ │ │ │ │ +00017f10: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ │ +00017f20: 2020 2020 2020 2020 6869 6768 6c69 6768 highligh │ │ │ │ │ +00017f30: 7420 626f 7820 7369 6465 2073 6c69 6365 t box side slice │ │ │ │ │ +00017f40: 7320 2865 7665 7279 2073 6c69 6365 2065 s (every slice e │ │ │ │ │ +00017f50: 7863 6570 740a 2020 2020 2020 2020 2020 xcept. │ │ │ │ │ +00017f60: 2020 2020 2020 2020 2020 7468 6520 6365 the ce │ │ │ │ │ +00017f70: 6e74 6572 2073 6c69 6365 2920 7769 6c6c nter slice) will │ │ │ │ │ +00017f80: 206f 7665 726c 6179 2074 6865 2066 7261 overlay the fra │ │ │ │ │ +00017f90: 6d65 2062 6f78 0a20 2020 2020 2020 2020 me box. │ │ │ │ │ +00017fa0: 2020 2020 2020 2020 2020 2073 6964 6520 side │ │ │ │ │ +00017fb0: 736c 6963 6573 2e20 2041 6e64 2074 6865 slices. And the │ │ │ │ │ +00017fc0: 2063 656e 7465 7220 736c 6963 6520 6f66 center slice of │ │ │ │ │ +00017fd0: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ │ +00017fe0: 2020 2020 2020 2020 2068 6967 686c 6967 highlig │ │ │ │ │ +00017ff0: 6874 2062 6f78 2063 616e 206d 6f76 6520 ht box can move │ │ │ │ │ +00018000: 616c 6c20 7468 6520 7761 7920 2866 726f all the way (fro │ │ │ │ │ +00018010: 6d20 746f 7020 746f 0a20 2020 2020 2020 m top to. │ │ │ │ │ +00018020: 2020 2020 2020 2020 2020 2020 2062 6f74 bot │ │ │ │ │ +00018030: 746f 6d29 2c20 6265 696e 6720 6472 6177 tom), being draw │ │ │ │ │ +00018040: 6e20 6f6e 2074 6865 2063 656e 7465 7220 n on the center │ │ │ │ │ +00018050: 736c 6963 6520 6f66 2074 6865 0a20 2020 slice of the. │ │ │ │ │ +00018060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00018070: 2066 7261 6d65 2062 6f78 2e20 2054 6861 frame box. Tha │ │ │ │ │ +00018080: 7420 7761 7920 7765 2063 616e 206d 616b t way we can mak │ │ │ │ │ +00018090: 6520 6120 7072 6f67 7265 7373 2062 6172 e a progress bar │ │ │ │ │ +000180a0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000180b0: 2020 2020 2077 6974 6820 726f 756e 642d with round- │ │ │ │ │ +000180c0: 7368 6170 6564 2065 6467 6573 2073 6f20 shaped edges so │ │ │ │ │ +000180d0: 7468 6572 6520 776f 6e27 7420 6265 2061 there won't be a │ │ │ │ │ +000180e0: 2066 7265 650a 2020 2020 2020 2020 2020 free. │ │ │ │ │ +000180f0: 2020 2020 2020 2020 2020 7370 6163 6520 space │ │ │ │ │ +00018100: 6672 6f6d 2074 6865 2068 6967 686c 6967 from the highlig │ │ │ │ │ +00018110: 6874 2074 6f20 7468 6520 6672 616d 6520 ht to the frame │ │ │ │ │ +00018120: 696e 2074 6f70 2061 6e64 0a20 2020 2020 in top and. │ │ │ │ │ +00018130: 2020 2020 2020 2020 2020 2020 2020 2062 b │ │ │ │ │ +00018140: 6f74 746f 6d20 7363 726f 6c6c 6261 7220 ottom scrollbar │ │ │ │ │ +00018150: 706f 7369 7469 6f6e 732e 2020 4465 6661 positions. Defa │ │ │ │ │ +00018160: 756c 7420 6973 2022 6661 6c73 6522 2e0a ult is "false".. │ │ │ │ │ +00018170: 2020 2020 2066 6f6e 7420 2020 2020 2020 font │ │ │ │ │ +00018180: 2020 2020 5468 6520 666f 6e74 2074 6f20 The font to │ │ │ │ │ +00018190: 7573 6520 666f 7220 7072 6f67 7265 7373 use for progress │ │ │ │ │ +000181a0: 2062 6172 2e0a 2020 2020 2074 6578 7420 bar.. text │ │ │ │ │ +000181b0: 2020 2020 2020 2020 2020 5468 6520 7465 The te │ │ │ │ │ +000181c0: 7874 2074 6f20 6469 7370 6c61 7920 6f6e xt to display on │ │ │ │ │ +000181d0: 2074 6865 2070 726f 6772 6573 7320 6261 the progress ba │ │ │ │ │ +000181e0: 722e 2020 4966 2074 6865 0a20 2020 2020 r. If the. │ │ │ │ │ +000181f0: 2020 2020 2020 2020 2020 2020 2020 2070 p │ │ │ │ │ +00018200: 726f 6772 6573 7320 6261 7227 7320 4944 rogress bar's ID │ │ │ │ │ +00018210: 2069 7320 7365 7420 746f 2022 5f5f 7469 is set to "__ti │ │ │ │ │ +00018220: 6d65 6f75 745f 5f22 2061 6e64 0a20 2020 meout__" and. │ │ │ │ │ +00018230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00018240: 2074 6865 2076 616c 7565 206f 6620 7468 the value of th │ │ │ │ │ +00018250: 6973 2070 726f 7065 7274 7920 6973 2073 is property is s │ │ │ │ │ +00018260: 6574 2074 6f0a 2020 2020 2020 2020 2020 et to. │ │ │ │ │ +00018270: 2020 2020 2020 2020 2020 2240 5449 4d45 "@TIME │ │ │ │ │ +00018280: 4f55 545f 4e4f 5449 4649 4341 5449 4f4e OUT_NOTIFICATION │ │ │ │ │ +00018290: 5f53 484f 5254 4022 2c0a 2020 2020 2020 _SHORT@",. │ │ │ │ │ +000182a0: 2020 2020 2020 2020 2020 2020 2020 2240 "@ │ │ │ │ │ +000182b0: 5449 4d45 4f55 545f 4e4f 5449 4649 4341 TIMEOUT_NOTIFICA │ │ │ │ │ +000182c0: 5449 4f4e 5f4d 4944 444c 4540 2220 6f72 TION_MIDDLE@" or │ │ │ │ │ +000182d0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000182e0: 2020 2020 2022 4054 494d 454f 5554 5f4e "@TIMEOUT_N │ │ │ │ │ +000182f0: 4f54 4946 4943 4154 494f 4e5f 4c4f 4e47 OTIFICATION_LONG │ │ │ │ │ +00018300: 4022 2c20 7468 656e 2047 5255 4220 7769 @", then GRUB wi │ │ │ │ │ +00018310: 6c6c 0a20 2020 2020 2020 2020 2020 2020 ll. │ │ │ │ │ +00018320: 2020 2020 2020 2075 7064 6174 6520 7468 update th │ │ │ │ │ +00018330: 6973 2070 726f 7065 7274 7920 7769 7468 is property with │ │ │ │ │ +00018340: 2061 6e20 696e 666f 726d 6174 6976 6520 an informative │ │ │ │ │ +00018350: 6d65 7373 6167 650a 2020 2020 2020 2020 message. │ │ │ │ │ +00018360: 2020 2020 2020 2020 2020 2020 6173 2074 as t │ │ │ │ │ +00018370: 6865 2074 696d 656f 7574 2061 7070 726f he timeout appro │ │ │ │ │ +00018380: 6163 6865 732e 0a0a 2020 202a 2063 6972 aches... * cir │ │ │ │ │ +00018390: 6375 6c61 725f 7072 6f67 7265 7373 2044 cular_progress D │ │ │ │ │ +000183a0: 6973 706c 6179 7320 6120 6369 7263 756c isplays a circul │ │ │ │ │ +000183b0: 6172 2070 726f 6772 6573 7320 696e 6469 ar progress indi │ │ │ │ │ +000183c0: 6361 746f 722e 2020 5468 650a 2020 2020 cator. The. │ │ │ │ │ +000183d0: 2061 7070 6561 7261 6e63 6520 6f66 2074 appearance of t │ │ │ │ │ +000183e0: 6869 7320 636f 6d70 6f6e 656e 7420 6973 his component is │ │ │ │ │ +000183f0: 2064 6574 6572 6d69 6e65 6420 6279 2074 determined by t │ │ │ │ │ +00018400: 776f 2069 6d61 6765 733a 2074 6865 0a20 wo images: the. │ │ │ │ │ +00018410: 2020 2020 2a63 656e 7465 722a 2069 6d61 *center* ima │ │ │ │ │ +00018420: 6765 2061 6e64 2074 6865 202a 7469 636b ge and the *tick │ │ │ │ │ +00018430: 2a20 696d 6167 652e 2020 5468 6520 6365 * image. The ce │ │ │ │ │ +00018440: 6e74 6572 2069 6d61 6765 2069 7320 6765 nter image is ge │ │ │ │ │ +00018450: 6e65 7261 6c6c 790a 2020 2020 206c 6172 nerally. lar │ │ │ │ │ +00018460: 6765 7220 616e 6420 7769 6c6c 2062 6520 ger and will be │ │ │ │ │ +00018470: 6472 6177 6e20 696e 2074 6865 2063 656e drawn in the cen │ │ │ │ │ +00018480: 7465 7220 6f66 2074 6865 2063 6f6d 706f ter of the compo │ │ │ │ │ +00018490: 6e65 6e74 2e20 2041 726f 756e 640a 2020 nent. Around. │ │ │ │ │ +000184a0: 2020 2074 6865 2063 6972 6375 6d66 6572 the circumfer │ │ │ │ │ +000184b0: 656e 6365 206f 6620 6120 6369 7263 6c65 ence of a circle │ │ │ │ │ +000184c0: 2077 6974 6869 6e20 7468 6520 636f 6d70 within the comp │ │ │ │ │ +000184d0: 6f6e 656e 742c 2074 6865 2074 6963 6b20 onent, the tick │ │ │ │ │ +000184e0: 696d 6167 650a 2020 2020 2077 696c 6c20 image. will │ │ │ │ │ +000184f0: 6265 2064 7261 776e 2061 2063 6572 7461 be drawn a certa │ │ │ │ │ +00018500: 696e 206e 756d 6265 7220 6f66 2074 696d in number of tim │ │ │ │ │ +00018510: 6573 2c20 6465 7065 6e64 696e 6720 6f6e es, depending on │ │ │ │ │ +00018520: 2074 6865 0a20 2020 2020 7072 6f70 6572 the. proper │ │ │ │ │ +00018530: 7469 6573 206f 6620 7468 6520 636f 6d70 ties of the comp │ │ │ │ │ +00018540: 6f6e 656e 742e 0a0a 2020 2020 2050 726f onent... Pro │ │ │ │ │ +00018550: 7065 7274 6965 733a 0a0a 2020 2020 2069 perties:.. i │ │ │ │ │ +00018560: 6420 2020 2020 2020 2020 2020 2020 2020 d │ │ │ │ │ +00018570: 2020 2020 2020 5365 7420 746f 2022 5f5f Set to "__ │ │ │ │ │ +00018580: 7469 6d65 6f75 745f 5f22 2074 6f20 6469 timeout__" to di │ │ │ │ │ +00018590: 7370 6c61 7920 7468 6520 7469 6d65 0a20 splay the time. │ │ │ │ │ 000185a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000185b0: 2020 2020 2020 2020 2065 6c61 7073 6564 elapsed │ │ │ │ │ -000185c0: 2074 6f20 616e 2061 7574 6f6d 6174 6963 to an automatic │ │ │ │ │ -000185d0: 616c 2062 6f6f 7420 6f66 2074 6865 0a20 al boot of the. │ │ │ │ │ -000185e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000185f0: 2020 2020 2020 2020 2020 2064 6566 6175 defau │ │ │ │ │ -00018600: 6c74 2065 6e74 7279 2e0a 2020 2020 2063 lt entry.. c │ │ │ │ │ -00018610: 656e 7465 725f 6269 746d 6170 2020 2020 enter_bitmap │ │ │ │ │ -00018620: 2020 2020 2020 5468 6520 6669 6c65 206e The file n │ │ │ │ │ -00018630: 616d 6520 6f66 2074 6865 2069 6d61 6765 ame of the image │ │ │ │ │ -00018640: 2074 6f20 6472 6177 2069 6e20 7468 650a to draw in the. │ │ │ │ │ -00018650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018660: 2020 2020 2020 2020 2020 2020 6365 6e74 cent │ │ │ │ │ -00018670: 6572 206f 6620 7468 6520 636f 6d70 6f6e er of the compon │ │ │ │ │ -00018680: 656e 742e 0a20 2020 2020 7469 636b 5f62 ent.. tick_b │ │ │ │ │ -00018690: 6974 6d61 7020 2020 2020 2020 2020 2020 itmap │ │ │ │ │ -000186a0: 2054 6865 2066 696c 6520 6e61 6d65 206f The file name o │ │ │ │ │ -000186b0: 6620 7468 6520 696d 6167 6520 746f 2064 f the image to d │ │ │ │ │ -000186c0: 7261 7720 666f 720a 2020 2020 2020 2020 raw for. │ │ │ │ │ +000185b0: 2020 2020 2020 2020 2020 2065 6c61 7073 elaps │ │ │ │ │ +000185c0: 6564 2074 6f20 616e 2061 7574 6f6d 6174 ed to an automat │ │ │ │ │ +000185d0: 6963 616c 2062 6f6f 7420 6f66 2074 6865 ical boot of the │ │ │ │ │ +000185e0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000185f0: 2020 2020 2020 2020 2020 2020 2064 6566 def │ │ │ │ │ +00018600: 6175 6c74 2065 6e74 7279 2e0a 2020 2020 ault entry.. │ │ │ │ │ +00018610: 2063 656e 7465 725f 6269 746d 6170 2020 center_bitmap │ │ │ │ │ +00018620: 2020 2020 2020 2020 5468 6520 6669 6c65 The file │ │ │ │ │ +00018630: 206e 616d 6520 6f66 2074 6865 2069 6d61 name of the ima │ │ │ │ │ +00018640: 6765 2074 6f20 6472 6177 2069 6e20 7468 ge to draw in th │ │ │ │ │ +00018650: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ +00018660: 2020 2020 2020 2020 2020 2020 2020 6365 ce │ │ │ │ │ +00018670: 6e74 6572 206f 6620 7468 6520 636f 6d70 nter of the comp │ │ │ │ │ +00018680: 6f6e 656e 742e 0a20 2020 2020 7469 636b onent.. tick │ │ │ │ │ +00018690: 5f62 6974 6d61 7020 2020 2020 2020 2020 _bitmap │ │ │ │ │ +000186a0: 2020 2054 6865 2066 696c 6520 6e61 6d65 The file name │ │ │ │ │ +000186b0: 206f 6620 7468 6520 696d 6167 6520 746f of the image to │ │ │ │ │ +000186c0: 2064 7261 7720 666f 720a 2020 2020 2020 draw for. │ │ │ │ │ 000186d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000186e0: 2020 2020 7468 6520 7469 636b 206d 6172 the tick mar │ │ │ │ │ -000186f0: 6b73 2e0a 2020 2020 206e 756d 5f74 6963 ks.. num_tic │ │ │ │ │ -00018700: 6b73 2020 2020 2020 2020 2020 2020 2020 ks │ │ │ │ │ -00018710: 5468 6520 6e75 6d62 6572 206f 6620 7469 The number of ti │ │ │ │ │ -00018720: 636b 7320 7468 6174 206d 616b 6520 7570 cks that make up │ │ │ │ │ -00018730: 2061 2066 756c 6c0a 2020 2020 2020 2020 a full. │ │ │ │ │ +000186e0: 2020 2020 2020 7468 6520 7469 636b 206d the tick m │ │ │ │ │ +000186f0: 6172 6b73 2e0a 2020 2020 206e 756d 5f74 arks.. num_t │ │ │ │ │ +00018700: 6963 6b73 2020 2020 2020 2020 2020 2020 icks │ │ │ │ │ +00018710: 2020 5468 6520 6e75 6d62 6572 206f 6620 The number of │ │ │ │ │ +00018720: 7469 636b 7320 7468 6174 206d 616b 6520 ticks that make │ │ │ │ │ +00018730: 7570 2061 2066 756c 6c0a 2020 2020 2020 up a full. │ │ │ │ │ 00018740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018750: 2020 2020 6369 7263 6c65 2e0a 2020 2020 circle.. │ │ │ │ │ -00018760: 2074 6963 6b73 5f64 6973 6170 7065 6172 ticks_disappear │ │ │ │ │ -00018770: 2020 2020 2020 2020 426f 6f6c 6561 6e20 Boolean │ │ │ │ │ -00018780: 7661 6c75 6520 696e 6469 6361 7469 6e67 value indicating │ │ │ │ │ -00018790: 2077 6865 7468 6572 2074 6963 6b0a 2020 whether tick. │ │ │ │ │ +00018750: 2020 2020 2020 6369 7263 6c65 2e0a 2020 circle.. │ │ │ │ │ +00018760: 2020 2074 6963 6b73 5f64 6973 6170 7065 ticks_disappe │ │ │ │ │ +00018770: 6172 2020 2020 2020 2020 426f 6f6c 6561 ar Boolea │ │ │ │ │ +00018780: 6e20 7661 6c75 6520 696e 6469 6361 7469 n value indicati │ │ │ │ │ +00018790: 6e67 2077 6865 7468 6572 2074 6963 6b0a ng whether tick. │ │ │ │ │ 000187a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000187b0: 2020 2020 2020 2020 2020 6d61 726b 7320 marks │ │ │ │ │ -000187c0: 7368 6f75 6c64 2070 726f 6772 6573 7369 should progressi │ │ │ │ │ -000187d0: 7665 6c79 2061 7070 6561 722c 206f 720a vely appear, or. │ │ │ │ │ -000187e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000187f0: 2020 2020 2020 2020 2020 2020 7072 6f67 prog │ │ │ │ │ -00018800: 7265 7373 6976 656c 7920 6469 7361 7070 ressively disapp │ │ │ │ │ -00018810: 6561 7220 6173 202a 7661 6c75 652a 0a20 ear as *value*. │ │ │ │ │ -00018820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018830: 2020 2020 2020 2020 2020 2061 7070 726f appro │ │ │ │ │ -00018840: 6163 6865 7320 2a65 6e64 2a2e 2020 5370 aches *end*. Sp │ │ │ │ │ -00018850: 6563 6966 7920 2274 7275 6522 206f 720a ecify "true" or. │ │ │ │ │ -00018860: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018870: 2020 2020 2020 2020 2020 2020 2266 616c "fal │ │ │ │ │ -00018880: 7365 222e 2020 4465 6661 756c 7420 6973 se". Default is │ │ │ │ │ -00018890: 2022 6661 6c73 6522 2e0a 2020 2020 2073 "false".. s │ │ │ │ │ -000188a0: 7461 7274 5f61 6e67 6c65 2020 2020 2020 tart_angle │ │ │ │ │ -000188b0: 2020 2020 2020 5468 6520 706f 7369 7469 The positi │ │ │ │ │ -000188c0: 6f6e 206f 6620 7468 6520 6669 7273 7420 on of the first │ │ │ │ │ -000188d0: 7469 636b 206d 6172 6b20 746f 0a20 2020 tick mark to. │ │ │ │ │ +000187b0: 2020 2020 2020 2020 2020 2020 6d61 726b mark │ │ │ │ │ +000187c0: 7320 7368 6f75 6c64 2070 726f 6772 6573 s should progres │ │ │ │ │ +000187d0: 7369 7665 6c79 2061 7070 6561 722c 206f sively appear, o │ │ │ │ │ +000187e0: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ +000187f0: 2020 2020 2020 2020 2020 2020 2020 7072 pr │ │ │ │ │ +00018800: 6f67 7265 7373 6976 656c 7920 6469 7361 ogressively disa │ │ │ │ │ +00018810: 7070 6561 7220 6173 202a 7661 6c75 652a ppear as *value* │ │ │ │ │ +00018820: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00018830: 2020 2020 2020 2020 2020 2020 2061 7070 app │ │ │ │ │ +00018840: 726f 6163 6865 7320 2a65 6e64 2a2e 2020 roaches *end*. │ │ │ │ │ +00018850: 5370 6563 6966 7920 2274 7275 6522 206f Specify "true" o │ │ │ │ │ +00018860: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ +00018870: 2020 2020 2020 2020 2020 2020 2020 2266 "f │ │ │ │ │ +00018880: 616c 7365 222e 2020 4465 6661 756c 7420 alse". Default │ │ │ │ │ +00018890: 6973 2022 6661 6c73 6522 2e0a 2020 2020 is "false".. │ │ │ │ │ +000188a0: 2073 7461 7274 5f61 6e67 6c65 2020 2020 start_angle │ │ │ │ │ +000188b0: 2020 2020 2020 2020 5468 6520 706f 7369 The posi │ │ │ │ │ +000188c0: 7469 6f6e 206f 6620 7468 6520 6669 7273 tion of the firs │ │ │ │ │ +000188d0: 7420 7469 636b 206d 6172 6b20 746f 0a20 t tick mark to. │ │ │ │ │ 000188e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000188f0: 2020 2020 2020 2020 2061 7070 6561 7220 appear │ │ │ │ │ -00018900: 6f72 2064 6973 6170 7065 6172 2e20 204d or disappear. M │ │ │ │ │ -00018910: 6561 7375 7265 6420 696e 0a20 2020 2020 easured in. │ │ │ │ │ +000188f0: 2020 2020 2020 2020 2020 2061 7070 6561 appea │ │ │ │ │ +00018900: 7220 6f72 2064 6973 6170 7065 6172 2e20 r or disappear. │ │ │ │ │ +00018910: 204d 6561 7375 7265 6420 696e 0a20 2020 Measured in. │ │ │ │ │ 00018920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018930: 2020 2020 2020 2022 7061 7272 6f74 7322 "parrots" │ │ │ │ │ -00018940: 2c20 3120 2270 6172 726f 7422 203d 2031 , 1 "parrot" = 1 │ │ │ │ │ -00018950: 202f 2032 3536 206f 6620 7468 650a 2020 / 256 of the. │ │ │ │ │ +00018930: 2020 2020 2020 2020 2022 7061 7272 6f74 "parrot │ │ │ │ │ +00018940: 7322 2c20 3120 2270 6172 726f 7422 203d s", 1 "parrot" = │ │ │ │ │ +00018950: 2031 202f 2032 3536 206f 6620 7468 650a 1 / 256 of the. │ │ │ │ │ 00018960: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018970: 2020 2020 2020 2020 2020 6675 6c6c 2063 full c │ │ │ │ │ -00018980: 6972 636c 652e 2020 5573 6520 7661 6c75 ircle. Use valu │ │ │ │ │ -00018990: 6573 2022 7878 7820 6465 6722 206f 720a es "xxx deg" or. │ │ │ │ │ -000189a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000189b0: 2020 2020 2020 2020 2020 2020 2278 7878 "xxx │ │ │ │ │ -000189c0: 205c 7863 325c 7862 3022 2074 6f20 7365 \xc2\xb0" to se │ │ │ │ │ -000189d0: 7420 7468 6520 616e 676c 6520 696e 0a20 t the angle in. │ │ │ │ │ -000189e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000189f0: 2020 2020 2020 2020 2020 2064 6567 7265 degre │ │ │ │ │ -00018a00: 6573 2e0a 0a20 2020 2a20 626f 6f74 5f6d es... * boot_m │ │ │ │ │ -00018a10: 656e 7520 4469 7370 6c61 7973 2074 6865 enu Displays the │ │ │ │ │ -00018a20: 2047 5255 4220 626f 6f74 206d 656e 752e GRUB boot menu. │ │ │ │ │ -00018a30: 2020 4974 2061 6c6c 6f77 7320 7365 6c65 It allows sele │ │ │ │ │ -00018a40: 6374 696e 6720 6974 656d 730a 2020 2020 cting items. │ │ │ │ │ -00018a50: 2061 6e64 2065 7865 6375 7469 6e67 2074 and executing t │ │ │ │ │ -00018a60: 6865 6d2e 0a0a 2020 2020 2050 726f 7065 hem... Prope │ │ │ │ │ -00018a70: 7274 6965 733a 0a0a 2020 2020 2069 7465 rties:.. ite │ │ │ │ │ -00018a80: 6d5f 666f 6e74 2020 2020 2020 2020 2020 m_font │ │ │ │ │ -00018a90: 2020 2020 2020 2020 2020 2054 6865 2066 The f │ │ │ │ │ -00018aa0: 6f6e 7420 746f 2075 7365 2066 6f72 2074 ont to use for t │ │ │ │ │ -00018ab0: 6865 206d 656e 7520 6974 656d 0a20 2020 he menu item. │ │ │ │ │ +00018970: 2020 2020 2020 2020 2020 2020 6675 6c6c full │ │ │ │ │ +00018980: 2063 6972 636c 652e 2020 5573 6520 7661 circle. Use va │ │ │ │ │ +00018990: 6c75 6573 2022 7878 7820 6465 6722 206f lues "xxx deg" o │ │ │ │ │ +000189a0: 720a 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ +000189b0: 2020 2020 2020 2020 2020 2020 2020 2278 "x │ │ │ │ │ +000189c0: 7878 205c 7863 325c 7862 3022 2074 6f20 xx \xc2\xb0" to │ │ │ │ │ +000189d0: 7365 7420 7468 6520 616e 676c 6520 696e set the angle in │ │ │ │ │ +000189e0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +000189f0: 2020 2020 2020 2020 2020 2020 2064 6567 deg │ │ │ │ │ +00018a00: 7265 6573 2e0a 0a20 2020 2a20 626f 6f74 rees... * boot │ │ │ │ │ +00018a10: 5f6d 656e 7520 4469 7370 6c61 7973 2074 _menu Displays t │ │ │ │ │ +00018a20: 6865 2047 5255 4220 626f 6f74 206d 656e he GRUB boot men │ │ │ │ │ +00018a30: 752e 2020 4974 2061 6c6c 6f77 7320 7365 u. It allows se │ │ │ │ │ +00018a40: 6c65 6374 696e 6720 6974 656d 730a 2020 lecting items. │ │ │ │ │ +00018a50: 2020 2061 6e64 2065 7865 6375 7469 6e67 and executing │ │ │ │ │ +00018a60: 2074 6865 6d2e 0a0a 2020 2020 2050 726f them... Pro │ │ │ │ │ +00018a70: 7065 7274 6965 733a 0a0a 2020 2020 2069 perties:.. i │ │ │ │ │ +00018a80: 7465 6d5f 666f 6e74 2020 2020 2020 2020 tem_font │ │ │ │ │ +00018a90: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ +00018aa0: 2066 6f6e 7420 746f 2075 7365 2066 6f72 font to use for │ │ │ │ │ +00018ab0: 2074 6865 206d 656e 7520 6974 656d 0a20 the menu item. │ │ │ │ │ 00018ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00018ad0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018ae0: 7469 746c 6573 2e0a 2020 2020 2073 656c titles.. sel │ │ │ │ │ -00018af0: 6563 7465 645f 6974 656d 5f66 6f6e 7420 ected_item_font │ │ │ │ │ -00018b00: 2020 2020 2020 2020 2020 2054 6865 2066 The f │ │ │ │ │ -00018b10: 6f6e 7420 746f 2075 7365 2066 6f72 2074 ont to use for t │ │ │ │ │ -00018b20: 6865 2073 656c 6563 7465 640a 2020 2020 he selected. │ │ │ │ │ +00018ae0: 2020 7469 746c 6573 2e0a 2020 2020 2073 titles.. s │ │ │ │ │ +00018af0: 656c 6563 7465 645f 6974 656d 5f66 6f6e elected_item_fon │ │ │ │ │ +00018b00: 7420 2020 2020 2020 2020 2020 2054 6865 t The │ │ │ │ │ +00018b10: 2066 6f6e 7420 746f 2075 7365 2066 6f72 font to use for │ │ │ │ │ +00018b20: 2074 6865 2073 656c 6563 7465 640a 2020 the selected. │ │ │ │ │ 00018b30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018b40: 2020 2020 2020 2020 2020 2020 2020 206d m │ │ │ │ │ -00018b50: 656e 7520 6974 656d 2c20 6f72 2022 696e enu item, or "in │ │ │ │ │ -00018b60: 6865 7269 7422 2028 7468 650a 2020 2020 herit" (the. │ │ │ │ │ +00018b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00018b50: 206d 656e 7520 6974 656d 2c20 6f72 2022 menu item, or " │ │ │ │ │ +00018b60: 696e 6865 7269 7422 2028 7468 650a 2020 inherit" (the. │ │ │ │ │ 00018b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018b80: 2020 2020 2020 2020 2020 2020 2020 2064 d │ │ │ │ │ -00018b90: 6566 6175 6c74 2920 746f 2075 7365 2022 efault) to use " │ │ │ │ │ -00018ba0: 6974 656d 5f66 6f6e 7422 2066 6f72 0a20 item_font" for. │ │ │ │ │ -00018bb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00018b80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00018b90: 2064 6566 6175 6c74 2920 746f 2075 7365 default) to use │ │ │ │ │ +00018ba0: 2022 6974 656d 5f66 6f6e 7422 2066 6f72 "item_font" for │ │ │ │ │ +00018bb0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00018bc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018bd0: 2020 7468 6520 7365 6c65 6374 6564 206d the selected m │ │ │ │ │ -00018be0: 656e 7520 6974 656d 2061 7320 7765 6c6c enu item as well │ │ │ │ │ -00018bf0: 2e0a 2020 2020 2069 7465 6d5f 636f 6c6f .. item_colo │ │ │ │ │ -00018c00: 7220 2020 2020 2020 2020 2020 2020 2020 r │ │ │ │ │ -00018c10: 2020 2020 2054 6865 2063 6f6c 6f72 2074 The color t │ │ │ │ │ -00018c20: 6f20 7573 6520 666f 7220 7468 6520 6d65 o use for the me │ │ │ │ │ -00018c30: 6e75 2069 7465 6d0a 2020 2020 2020 2020 nu item. │ │ │ │ │ +00018bd0: 2020 2020 7468 6520 7365 6c65 6374 6564 the selected │ │ │ │ │ +00018be0: 206d 656e 7520 6974 656d 2061 7320 7765 menu item as we │ │ │ │ │ +00018bf0: 6c6c 2e0a 2020 2020 2069 7465 6d5f 636f ll.. item_co │ │ │ │ │ +00018c00: 6c6f 7220 2020 2020 2020 2020 2020 2020 lor │ │ │ │ │ +00018c10: 2020 2020 2020 2054 6865 2063 6f6c 6f72 The color │ │ │ │ │ +00018c20: 2074 6f20 7573 6520 666f 7220 7468 6520 to use for the │ │ │ │ │ +00018c30: 6d65 6e75 2069 7465 6d0a 2020 2020 2020 menu item. │ │ │ │ │ 00018c40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018c50: 2020 2020 2020 2020 2020 2074 6974 6c65 title │ │ │ │ │ -00018c60: 732e 0a20 2020 2020 7365 6c65 6374 6564 s.. selected │ │ │ │ │ -00018c70: 5f69 7465 6d5f 636f 6c6f 7220 2020 2020 _item_color │ │ │ │ │ -00018c80: 2020 2020 2020 5468 6520 636f 6c6f 7220 The color │ │ │ │ │ -00018c90: 746f 2075 7365 2066 6f72 2074 6865 2073 to use for the s │ │ │ │ │ -00018ca0: 656c 6563 7465 640a 2020 2020 2020 2020 elected. │ │ │ │ │ +00018c50: 2020 2020 2020 2020 2020 2020 2074 6974 tit │ │ │ │ │ +00018c60: 6c65 732e 0a20 2020 2020 7365 6c65 6374 les.. select │ │ │ │ │ +00018c70: 6564 5f69 7465 6d5f 636f 6c6f 7220 2020 ed_item_color │ │ │ │ │ +00018c80: 2020 2020 2020 2020 5468 6520 636f 6c6f The colo │ │ │ │ │ +00018c90: 7220 746f 2075 7365 2066 6f72 2074 6865 r to use for the │ │ │ │ │ +00018ca0: 2073 656c 6563 7465 640a 2020 2020 2020 selected. │ │ │ │ │ 00018cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018cc0: 2020 2020 2020 2020 2020 206d 656e 7520 menu │ │ │ │ │ -00018cd0: 6974 656d 2c20 6f72 2022 696e 6865 7269 item, or "inheri │ │ │ │ │ -00018ce0: 7422 2028 7468 650a 2020 2020 2020 2020 t" (the. │ │ │ │ │ +00018cc0: 2020 2020 2020 2020 2020 2020 206d 656e men │ │ │ │ │ +00018cd0: 7520 6974 656d 2c20 6f72 2022 696e 6865 u item, or "inhe │ │ │ │ │ +00018ce0: 7269 7422 2028 7468 650a 2020 2020 2020 rit" (the. │ │ │ │ │ 00018cf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018d00: 2020 2020 2020 2020 2020 2064 6566 6175 defau │ │ │ │ │ -00018d10: 6c74 2920 746f 2075 7365 2022 6974 656d lt) to use "item │ │ │ │ │ -00018d20: 5f63 6f6c 6f72 2220 666f 720a 2020 2020 _color" for. │ │ │ │ │ +00018d00: 2020 2020 2020 2020 2020 2020 2064 6566 def │ │ │ │ │ +00018d10: 6175 6c74 2920 746f 2075 7365 2022 6974 ault) to use "it │ │ │ │ │ +00018d20: 656d 5f63 6f6c 6f72 2220 666f 720a 2020 em_color" for. │ │ │ │ │ 00018d30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018d40: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ │ -00018d50: 6865 2073 656c 6563 7465 6420 6d65 6e75 he selected menu │ │ │ │ │ -00018d60: 2069 7465 6d20 6173 2077 656c 6c2e 0a20 item as well.. │ │ │ │ │ -00018d70: 2020 2020 6963 6f6e 5f77 6964 7468 2020 icon_width │ │ │ │ │ +00018d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00018d50: 2074 6865 2073 656c 6563 7465 6420 6d65 the selected me │ │ │ │ │ +00018d60: 6e75 2069 7465 6d20 6173 2077 656c 6c2e nu item as well. │ │ │ │ │ +00018d70: 0a20 2020 2020 6963 6f6e 5f77 6964 7468 . icon_width │ │ │ │ │ 00018d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018d90: 2020 5468 6520 7769 6474 6820 6f66 206d The width of m │ │ │ │ │ -00018da0: 656e 7520 6974 656d 2069 636f 6e73 2e0a enu item icons.. │ │ │ │ │ -00018db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00018d90: 2020 2020 5468 6520 7769 6474 6820 6f66 The width of │ │ │ │ │ +00018da0: 206d 656e 7520 6974 656d 2069 636f 6e73 menu item icons │ │ │ │ │ +00018db0: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 00018dc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018dd0: 2020 2049 636f 6e73 2061 7265 2073 6361 Icons are sca │ │ │ │ │ -00018de0: 6c65 6420 746f 2074 6865 2073 7065 6369 led to the speci │ │ │ │ │ -00018df0: 6669 6564 0a20 2020 2020 2020 2020 2020 fied. │ │ │ │ │ +00018dd0: 2020 2020 2049 636f 6e73 2061 7265 2073 Icons are s │ │ │ │ │ +00018de0: 6361 6c65 6420 746f 2074 6865 2073 7065 caled to the spe │ │ │ │ │ +00018df0: 6369 6669 6564 0a20 2020 2020 2020 2020 cified. │ │ │ │ │ 00018e00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018e10: 2020 2020 2020 2020 7369 7a65 2e0a 2020 size.. │ │ │ │ │ -00018e20: 2020 2069 636f 6e5f 6865 6967 6874 2020 icon_height │ │ │ │ │ +00018e10: 2020 2020 2020 2020 2020 7369 7a65 2e0a size.. │ │ │ │ │ +00018e20: 2020 2020 2069 636f 6e5f 6865 6967 6874 icon_height │ │ │ │ │ 00018e30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018e40: 2054 6865 2068 6569 6768 7420 6f66 206d The height of m │ │ │ │ │ -00018e50: 656e 7520 6974 656d 2069 636f 6e73 2e0a enu item icons.. │ │ │ │ │ -00018e60: 2020 2020 2069 7465 6d5f 6865 6967 6874 item_height │ │ │ │ │ -00018e70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018e80: 2020 2054 6865 2068 6569 6768 7420 6f66 The height of │ │ │ │ │ -00018e90: 2065 6163 6820 6d65 6e75 2069 7465 6d20 each menu item │ │ │ │ │ -00018ea0: 696e 0a20 2020 2020 2020 2020 2020 2020 in. │ │ │ │ │ +00018e40: 2020 2054 6865 2068 6569 6768 7420 6f66 The height of │ │ │ │ │ +00018e50: 206d 656e 7520 6974 656d 2069 636f 6e73 menu item icons │ │ │ │ │ +00018e60: 2e0a 2020 2020 2069 7465 6d5f 6865 6967 .. item_heig │ │ │ │ │ +00018e70: 6874 2020 2020 2020 2020 2020 2020 2020 ht │ │ │ │ │ +00018e80: 2020 2020 2054 6865 2068 6569 6768 7420 The height │ │ │ │ │ +00018e90: 6f66 2065 6163 6820 6d65 6e75 2069 7465 of each menu ite │ │ │ │ │ +00018ea0: 6d20 696e 0a20 2020 2020 2020 2020 2020 m in. │ │ │ │ │ 00018eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018ec0: 2020 2020 2020 7069 7865 6c73 2e0a 2020 pixels.. │ │ │ │ │ -00018ed0: 2020 2069 7465 6d5f 7061 6464 696e 6720 item_padding │ │ │ │ │ -00018ee0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018ef0: 2054 6865 2061 6d6f 756e 7420 6f66 2073 The amount of s │ │ │ │ │ -00018f00: 7061 6365 2069 6e20 7069 7865 6c73 2074 pace in pixels t │ │ │ │ │ -00018f10: 6f0a 2020 2020 2020 2020 2020 2020 2020 o. │ │ │ │ │ +00018ec0: 2020 2020 2020 2020 7069 7865 6c73 2e0a pixels.. │ │ │ │ │ +00018ed0: 2020 2020 2069 7465 6d5f 7061 6464 696e item_paddin │ │ │ │ │ +00018ee0: 6720 2020 2020 2020 2020 2020 2020 2020 g │ │ │ │ │ +00018ef0: 2020 2054 6865 2061 6d6f 756e 7420 6f66 The amount of │ │ │ │ │ +00018f00: 2073 7061 6365 2069 6e20 7069 7865 6c73 space in pixels │ │ │ │ │ +00018f10: 2074 6f0a 2020 2020 2020 2020 2020 2020 to. │ │ │ │ │ 00018f20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018f30: 2020 2020 206c 6561 7665 206f 6e20 6561 leave on ea │ │ │ │ │ -00018f40: 6368 2073 6964 6520 6f66 2074 6865 206d ch side of the m │ │ │ │ │ -00018f50: 656e 750a 2020 2020 2020 2020 2020 2020 enu. │ │ │ │ │ +00018f30: 2020 2020 2020 206c 6561 7665 206f 6e20 leave on │ │ │ │ │ +00018f40: 6561 6368 2073 6964 6520 6f66 2074 6865 each side of the │ │ │ │ │ +00018f50: 206d 656e 750a 2020 2020 2020 2020 2020 menu. │ │ │ │ │ 00018f60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018f70: 2020 2020 2020 2069 7465 6d20 636f 6e74 item cont │ │ │ │ │ -00018f80: 656e 7473 2e0a 2020 2020 2069 7465 6d5f ents.. item_ │ │ │ │ │ -00018f90: 6963 6f6e 5f73 7061 6365 2020 2020 2020 icon_space │ │ │ │ │ -00018fa0: 2020 2020 2020 2020 2054 6865 2073 7061 The spa │ │ │ │ │ -00018fb0: 6365 2062 6574 7765 656e 2061 6e20 6974 ce between an it │ │ │ │ │ -00018fc0: 656d 2773 2069 636f 6e0a 2020 2020 2020 em's icon. │ │ │ │ │ +00018f70: 2020 2020 2020 2020 2069 7465 6d20 636f item co │ │ │ │ │ +00018f80: 6e74 656e 7473 2e0a 2020 2020 2069 7465 ntents.. ite │ │ │ │ │ +00018f90: 6d5f 6963 6f6e 5f73 7061 6365 2020 2020 m_icon_space │ │ │ │ │ +00018fa0: 2020 2020 2020 2020 2020 2054 6865 2073 The s │ │ │ │ │ +00018fb0: 7061 6365 2062 6574 7765 656e 2061 6e20 pace between an │ │ │ │ │ +00018fc0: 6974 656d 2773 2069 636f 6e0a 2020 2020 item's icon. │ │ │ │ │ 00018fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00018fe0: 2020 2020 2020 2020 2020 2020 2061 6e64 and │ │ │ │ │ -00018ff0: 2074 6865 2074 6974 6c65 2074 6578 742c the title text, │ │ │ │ │ -00019000: 2069 6e20 7069 7865 6c73 2e0a 2020 2020 in pixels.. │ │ │ │ │ -00019010: 2069 7465 6d5f 7370 6163 696e 6720 2020 item_spacing │ │ │ │ │ -00019020: 2020 2020 2020 2020 2020 2020 2020 2054 T │ │ │ │ │ -00019030: 6865 2061 6d6f 756e 7420 6f66 2073 7061 he amount of spa │ │ │ │ │ -00019040: 6365 2074 6f20 6c65 6176 650a 2020 2020 ce to leave. │ │ │ │ │ +00018fe0: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ +00018ff0: 6e64 2074 6865 2074 6974 6c65 2074 6578 nd the title tex │ │ │ │ │ +00019000: 742c 2069 6e20 7069 7865 6c73 2e0a 2020 t, in pixels.. │ │ │ │ │ +00019010: 2020 2069 7465 6d5f 7370 6163 696e 6720 item_spacing │ │ │ │ │ +00019020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00019030: 2054 6865 2061 6d6f 756e 7420 6f66 2073 The amount of s │ │ │ │ │ +00019040: 7061 6365 2074 6f20 6c65 6176 650a 2020 pace to leave. │ │ │ │ │ 00019050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019060: 2020 2020 2020 2020 2020 2020 2020 2062 b │ │ │ │ │ -00019070: 6574 7765 656e 206d 656e 7520 6974 656d etween menu item │ │ │ │ │ -00019080: 732c 2069 6e20 7069 7865 6c73 2e0a 2020 s, in pixels.. │ │ │ │ │ -00019090: 2020 206d 656e 755f 7069 786d 6170 5f73 menu_pixmap_s │ │ │ │ │ -000190a0: 7479 6c65 2020 2020 2020 2020 2020 2020 tyle │ │ │ │ │ -000190b0: 2054 6865 2069 6d61 6765 2066 696c 6520 The image file │ │ │ │ │ -000190c0: 7061 7474 6572 6e20 666f 7220 7468 650a pattern for the. │ │ │ │ │ -000190d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00019060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00019070: 2062 6574 7765 656e 206d 656e 7520 6974 between menu it │ │ │ │ │ +00019080: 656d 732c 2069 6e20 7069 7865 6c73 2e0a ems, in pixels.. │ │ │ │ │ +00019090: 2020 2020 206d 656e 755f 7069 786d 6170 menu_pixmap │ │ │ │ │ +000190a0: 5f73 7479 6c65 2020 2020 2020 2020 2020 _style │ │ │ │ │ +000190b0: 2020 2054 6865 2069 6d61 6765 2066 696c The image fil │ │ │ │ │ +000190c0: 6520 7061 7474 6572 6e20 666f 7220 7468 e pattern for th │ │ │ │ │ +000190d0: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ 000190e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000190f0: 2020 206d 656e 7520 6672 616d 6520 7374 menu frame st │ │ │ │ │ -00019100: 796c 6564 2062 6f78 2e20 2045 7861 6d70 yled box. Examp │ │ │ │ │ -00019110: 6c65 3a0a 2020 2020 2020 2020 2020 2020 le:. │ │ │ │ │ +000190f0: 2020 2020 206d 656e 7520 6672 616d 6520 menu frame │ │ │ │ │ +00019100: 7374 796c 6564 2062 6f78 2e20 2045 7861 styled box. Exa │ │ │ │ │ +00019110: 6d70 6c65 3a0a 2020 2020 2020 2020 2020 mple:. │ │ │ │ │ 00019120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019130: 2020 2020 2020 2022 6d65 6e75 5f2a 2e70 "menu_*.p │ │ │ │ │ -00019140: 6e67 2220 2874 6869 7320 7769 6c6c 2075 ng" (this will u │ │ │ │ │ -00019150: 7365 2069 6d61 6765 730a 2020 2020 2020 se images. │ │ │ │ │ +00019130: 2020 2020 2020 2020 2022 6d65 6e75 5f2a "menu_* │ │ │ │ │ +00019140: 2e70 6e67 2220 2874 6869 7320 7769 6c6c .png" (this will │ │ │ │ │ +00019150: 2075 7365 2069 6d61 6765 730a 2020 2020 use images. │ │ │ │ │ 00019160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019170: 2020 2020 2020 2020 2020 2020 2073 7563 suc │ │ │ │ │ -00019180: 6820 6173 2022 6d65 6e75 5f63 2e70 6e67 h as "menu_c.png │ │ │ │ │ -00019190: 222c 0a20 2020 2020 2020 2020 2020 2020 ",. │ │ │ │ │ +00019170: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ +00019180: 7563 6820 6173 2022 6d65 6e75 5f63 2e70 uch as "menu_c.p │ │ │ │ │ +00019190: 6e67 222c 0a20 2020 2020 2020 2020 2020 ng",. │ │ │ │ │ 000191a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000191b0: 2020 2020 2020 226d 656e 755f 772e 706e "menu_w.pn │ │ │ │ │ -000191c0: 6722 2c20 276d 656e 755f 6e77 2e70 6e67 g", 'menu_nw.png │ │ │ │ │ -000191d0: 222c 2065 7463 2e29 0a20 2020 2020 6974 ", etc.). it │ │ │ │ │ -000191e0: 656d 5f70 6978 6d61 705f 7374 796c 6520 em_pixmap_style │ │ │ │ │ -000191f0: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ │ -00019200: 696d 6167 6520 6669 6c65 2070 6174 7465 image file patte │ │ │ │ │ -00019210: 726e 2066 6f72 2074 6865 0a20 2020 2020 rn for the. │ │ │ │ │ +000191b0: 2020 2020 2020 2020 226d 656e 755f 772e "menu_w. │ │ │ │ │ +000191c0: 706e 6722 2c20 276d 656e 755f 6e77 2e70 png", 'menu_nw.p │ │ │ │ │ +000191d0: 6e67 222c 2065 7463 2e29 0a20 2020 2020 ng", etc.). │ │ │ │ │ +000191e0: 6974 656d 5f70 6978 6d61 705f 7374 796c item_pixmap_styl │ │ │ │ │ +000191f0: 6520 2020 2020 2020 2020 2020 2020 5468 e Th │ │ │ │ │ +00019200: 6520 696d 6167 6520 6669 6c65 2070 6174 e image file pat │ │ │ │ │ +00019210: 7465 726e 2066 6f72 2074 6865 0a20 2020 tern for the. │ │ │ │ │ 00019220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019230: 2020 2020 2020 2020 2020 2020 2020 6974 it │ │ │ │ │ -00019240: 656d 2073 7479 6c65 6420 626f 782e 0a20 em styled box.. │ │ │ │ │ -00019250: 2020 2020 7365 6c65 6374 6564 5f69 7465 selected_ite │ │ │ │ │ -00019260: 6d5f 7069 786d 6170 5f73 7479 6c65 2020 m_pixmap_style │ │ │ │ │ -00019270: 2020 5468 6520 696d 6167 6520 6669 6c65 The image file │ │ │ │ │ -00019280: 2070 6174 7465 726e 2066 6f72 2074 6865 pattern for the │ │ │ │ │ -00019290: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00019230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00019240: 6974 656d 2073 7479 6c65 6420 626f 782e item styled box. │ │ │ │ │ +00019250: 0a20 2020 2020 7365 6c65 6374 6564 5f69 . selected_i │ │ │ │ │ +00019260: 7465 6d5f 7069 786d 6170 5f73 7479 6c65 tem_pixmap_style │ │ │ │ │ +00019270: 2020 2020 5468 6520 696d 6167 6520 6669 The image fi │ │ │ │ │ +00019280: 6c65 2070 6174 7465 726e 2066 6f72 2074 le pattern for t │ │ │ │ │ +00019290: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ │ 000192a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000192b0: 2020 2020 7365 6c65 6374 6564 2069 7465 selected ite │ │ │ │ │ -000192c0: 6d20 6869 6768 6c69 6768 7420 7374 796c m highlight styl │ │ │ │ │ -000192d0: 6564 0a20 2020 2020 2020 2020 2020 2020 ed. │ │ │ │ │ +000192b0: 2020 2020 2020 7365 6c65 6374 6564 2069 selected i │ │ │ │ │ +000192c0: 7465 6d20 6869 6768 6c69 6768 7420 7374 tem highlight st │ │ │ │ │ +000192d0: 796c 6564 0a20 2020 2020 2020 2020 2020 yled. │ │ │ │ │ 000192e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000192f0: 2020 2020 2020 626f 782e 0a20 2020 2020 box.. │ │ │ │ │ -00019300: 7363 726f 6c6c 6261 7220 2020 2020 2020 scrollbar │ │ │ │ │ -00019310: 2020 2020 2020 2020 2020 2020 2020 426f Bo │ │ │ │ │ -00019320: 6f6c 6561 6e20 7661 6c75 6520 696e 6469 olean value indi │ │ │ │ │ -00019330: 6361 7469 6e67 2077 6865 7468 6572 0a20 cating whether. │ │ │ │ │ -00019340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000192f0: 2020 2020 2020 2020 626f 782e 0a20 2020 box.. │ │ │ │ │ +00019300: 2020 7363 726f 6c6c 6261 7220 2020 2020 scrollbar │ │ │ │ │ +00019310: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00019320: 426f 6f6c 6561 6e20 7661 6c75 6520 696e Boolean value in │ │ │ │ │ +00019330: 6469 6361 7469 6e67 2077 6865 7468 6572 dicating whether │ │ │ │ │ +00019340: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00019350: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019360: 2020 7468 6520 7363 726f 6c6c 2062 6172 the scroll bar │ │ │ │ │ -00019370: 2073 686f 756c 6420 6265 2064 7261 776e should be drawn │ │ │ │ │ -00019380: 2069 660a 2020 2020 2020 2020 2020 2020 if. │ │ │ │ │ +00019360: 2020 2020 7468 6520 7363 726f 6c6c 2062 the scroll b │ │ │ │ │ +00019370: 6172 2073 686f 756c 6420 6265 2064 7261 ar should be dra │ │ │ │ │ +00019380: 776e 2069 660a 2020 2020 2020 2020 2020 wn if. │ │ │ │ │ 00019390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000193a0: 2020 2020 2020 2074 6865 2066 7261 6d65 the frame │ │ │ │ │ -000193b0: 2061 6e64 2074 6875 6d62 2073 7479 6c65 and thumb style │ │ │ │ │ -000193c0: 6420 626f 7865 730a 2020 2020 2020 2020 d boxes. │ │ │ │ │ +000193a0: 2020 2020 2020 2020 2074 6865 2066 7261 the fra │ │ │ │ │ +000193b0: 6d65 2061 6e64 2074 6875 6d62 2073 7479 me and thumb sty │ │ │ │ │ +000193c0: 6c65 6420 626f 7865 730a 2020 2020 2020 led boxes. │ │ │ │ │ 000193d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000193e0: 2020 2020 2020 2020 2020 2061 7265 2063 are c │ │ │ │ │ -000193f0: 6f6e 6669 6775 7265 642e 0a20 2020 2020 onfigured.. │ │ │ │ │ -00019400: 7363 726f 6c6c 6261 725f 6672 616d 6520 scrollbar_frame │ │ │ │ │ -00019410: 2020 2020 2020 2020 2020 2020 2020 5468 Th │ │ │ │ │ -00019420: 6520 696d 6167 6520 6669 6c65 2070 6174 e image file pat │ │ │ │ │ -00019430: 7465 726e 2066 6f72 2074 6865 0a20 2020 tern for the. │ │ │ │ │ +000193e0: 2020 2020 2020 2020 2020 2020 2061 7265 are │ │ │ │ │ +000193f0: 2063 6f6e 6669 6775 7265 642e 0a20 2020 configured.. │ │ │ │ │ +00019400: 2020 7363 726f 6c6c 6261 725f 6672 616d scrollbar_fram │ │ │ │ │ +00019410: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ │ +00019420: 5468 6520 696d 6167 6520 6669 6c65 2070 The image file p │ │ │ │ │ +00019430: 6174 7465 726e 2066 6f72 2074 6865 0a20 attern for the. │ │ │ │ │ 00019440: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019460: 656e 7469 7265 2073 6372 6f6c 6c20 6261 entire scroll ba │ │ │ │ │ -00019470: 722e 2020 4578 616d 706c 653a 0a20 2020 r. Example:. │ │ │ │ │ +00019460: 2020 656e 7469 7265 2073 6372 6f6c 6c20 entire scroll │ │ │ │ │ +00019470: 6261 722e 2020 4578 616d 706c 653a 0a20 bar. Example:. │ │ │ │ │ 00019480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019490: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000194a0: 2273 6372 6f6c 6c62 6172 5f2a 2e70 6e67 "scrollbar_*.png │ │ │ │ │ -000194b0: 220a 2020 2020 2073 6372 6f6c 6c62 6172 ". scrollbar │ │ │ │ │ -000194c0: 5f74 6875 6d62 2020 2020 2020 2020 2020 _thumb │ │ │ │ │ -000194d0: 2020 2020 2054 6865 2069 6d61 6765 2066 The image f │ │ │ │ │ -000194e0: 696c 6520 7061 7474 6572 6e20 666f 7220 ile pattern for │ │ │ │ │ -000194f0: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ │ +000194a0: 2020 2273 6372 6f6c 6c62 6172 5f2a 2e70 "scrollbar_*.p │ │ │ │ │ +000194b0: 6e67 220a 2020 2020 2073 6372 6f6c 6c62 ng". scrollb │ │ │ │ │ +000194c0: 6172 5f74 6875 6d62 2020 2020 2020 2020 ar_thumb │ │ │ │ │ +000194d0: 2020 2020 2020 2054 6865 2069 6d61 6765 The image │ │ │ │ │ +000194e0: 2066 696c 6520 7061 7474 6572 6e20 666f file pattern fo │ │ │ │ │ +000194f0: 7220 7468 650a 2020 2020 2020 2020 2020 r the. │ │ │ │ │ 00019500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019510: 2020 2020 2020 2073 6372 6f6c 6c20 6261 scroll ba │ │ │ │ │ -00019520: 7220 7468 756d 6220 2874 6865 2070 6172 r thumb (the par │ │ │ │ │ -00019530: 7420 6f66 2074 6865 0a20 2020 2020 2020 t of the. │ │ │ │ │ +00019510: 2020 2020 2020 2020 2073 6372 6f6c 6c20 scroll │ │ │ │ │ +00019520: 6261 7220 7468 756d 6220 2874 6865 2070 bar thumb (the p │ │ │ │ │ +00019530: 6172 7420 6f66 2074 6865 0a20 2020 2020 art of the. │ │ │ │ │ 00019540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019550: 2020 2020 2020 2020 2020 2020 7363 726f scro │ │ │ │ │ -00019560: 6c6c 2062 6172 2074 6861 7420 6d6f 7665 ll bar that move │ │ │ │ │ -00019570: 7320 6173 2073 6372 6f6c 6c69 6e67 0a20 s as scrolling. │ │ │ │ │ -00019580: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00019550: 2020 2020 2020 2020 2020 2020 2020 7363 sc │ │ │ │ │ +00019560: 726f 6c6c 2062 6172 2074 6861 7420 6d6f roll bar that mo │ │ │ │ │ +00019570: 7665 7320 6173 2073 6372 6f6c 6c69 6e67 ves as scrolling │ │ │ │ │ +00019580: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00019590: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000195a0: 2020 6f63 6375 7273 292e 2020 4578 616d occurs). Exam │ │ │ │ │ -000195b0: 706c 653a 0a20 2020 2020 2020 2020 2020 ple:. │ │ │ │ │ +000195a0: 2020 2020 6f63 6375 7273 292e 2020 4578 occurs). Ex │ │ │ │ │ +000195b0: 616d 706c 653a 0a20 2020 2020 2020 2020 ample:. │ │ │ │ │ 000195c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000195d0: 2020 2020 2020 2020 2273 6372 6f6c 6c62 "scrollb │ │ │ │ │ -000195e0: 6172 5f74 6875 6d62 5f2a 2e70 6e67 220a ar_thumb_*.png". │ │ │ │ │ -000195f0: 2020 2020 2073 6372 6f6c 6c62 6172 5f74 scrollbar_t │ │ │ │ │ -00019600: 6875 6d62 5f6f 7665 726c 6179 2020 2020 humb_overlay │ │ │ │ │ -00019610: 2020 2049 6620 7468 6973 206f 7074 696f If this optio │ │ │ │ │ -00019620: 6e20 6973 2073 6574 2074 6f20 2274 7275 n is set to "tru │ │ │ │ │ -00019630: 6522 0a20 2020 2020 2020 2020 2020 2020 e". │ │ │ │ │ +000195d0: 2020 2020 2020 2020 2020 2273 6372 6f6c "scrol │ │ │ │ │ +000195e0: 6c62 6172 5f74 6875 6d62 5f2a 2e70 6e67 lbar_thumb_*.png │ │ │ │ │ +000195f0: 220a 2020 2020 2073 6372 6f6c 6c62 6172 ". scrollbar │ │ │ │ │ +00019600: 5f74 6875 6d62 5f6f 7665 726c 6179 2020 _thumb_overlay │ │ │ │ │ +00019610: 2020 2020 2049 6620 7468 6973 206f 7074 If this opt │ │ │ │ │ +00019620: 696f 6e20 6973 2073 6574 2074 6f20 2274 ion is set to "t │ │ │ │ │ +00019630: 7275 6522 0a20 2020 2020 2020 2020 2020 rue". │ │ │ │ │ 00019640: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019650: 2020 2020 2020 7468 656e 2074 6865 2073 then the s │ │ │ │ │ -00019660: 6372 6f6c 6c62 6172 2074 6875 6d62 2073 crollbar thumb s │ │ │ │ │ -00019670: 6964 650a 2020 2020 2020 2020 2020 2020 ide. │ │ │ │ │ +00019650: 2020 2020 2020 2020 7468 656e 2074 6865 then the │ │ │ │ │ +00019660: 2073 6372 6f6c 6c62 6172 2074 6875 6d62 scrollbar thumb │ │ │ │ │ +00019670: 2073 6964 650a 2020 2020 2020 2020 2020 side. │ │ │ │ │ 00019680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019690: 2020 2020 2020 2073 6c69 6365 7320 2865 slices (e │ │ │ │ │ -000196a0: 7665 7279 2073 6c69 6365 2065 7863 6570 very slice excep │ │ │ │ │ -000196b0: 7420 7468 650a 2020 2020 2020 2020 2020 t the. │ │ │ │ │ +00019690: 2020 2020 2020 2020 2073 6c69 6365 7320 slices │ │ │ │ │ +000196a0: 2865 7665 7279 2073 6c69 6365 2065 7863 (every slice exc │ │ │ │ │ +000196b0: 6570 7420 7468 650a 2020 2020 2020 2020 ept the. │ │ │ │ │ 000196c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000196d0: 2020 2020 2020 2020 2063 656e 7465 7220 center │ │ │ │ │ -000196e0: 736c 6963 6529 2077 696c 6c20 6f76 6572 slice) will over │ │ │ │ │ -000196f0: 6c61 7920 7468 650a 2020 2020 2020 2020 lay the. │ │ │ │ │ +000196d0: 2020 2020 2020 2020 2020 2063 656e 7465 cente │ │ │ │ │ +000196e0: 7220 736c 6963 6529 2077 696c 6c20 6f76 r slice) will ov │ │ │ │ │ +000196f0: 6572 6c61 7920 7468 650a 2020 2020 2020 erlay the. │ │ │ │ │ 00019700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019710: 2020 2020 2020 2020 2020 2073 6372 6f6c scrol │ │ │ │ │ -00019720: 6c62 6172 2066 7261 6d65 2073 6964 6520 lbar frame side │ │ │ │ │ -00019730: 736c 6963 6573 2e20 2041 6e64 0a20 2020 slices. And. │ │ │ │ │ +00019710: 2020 2020 2020 2020 2020 2020 2073 6372 scr │ │ │ │ │ +00019720: 6f6c 6c62 6172 2066 7261 6d65 2073 6964 ollbar frame sid │ │ │ │ │ +00019730: 6520 736c 6963 6573 2e20 2041 6e64 0a20 e slices. And. │ │ │ │ │ 00019740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019760: 7468 6520 6365 6e74 6572 2073 6c69 6365 the center slice │ │ │ │ │ -00019770: 206f 6620 7468 650a 2020 2020 2020 2020 of the. │ │ │ │ │ +00019760: 2020 7468 6520 6365 6e74 6572 2073 6c69 the center sli │ │ │ │ │ +00019770: 6365 206f 6620 7468 650a 2020 2020 2020 ce of the. │ │ │ │ │ 00019780: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019790: 2020 2020 2020 2020 2020 2073 6372 6f6c scrol │ │ │ │ │ -000197a0: 6c62 6172 5f74 6875 6d62 2063 616e 206d lbar_thumb can m │ │ │ │ │ -000197b0: 6f76 6520 616c 6c20 7468 650a 2020 2020 ove all the. │ │ │ │ │ +00019790: 2020 2020 2020 2020 2020 2020 2073 6372 scr │ │ │ │ │ +000197a0: 6f6c 6c62 6172 5f74 6875 6d62 2063 616e ollbar_thumb can │ │ │ │ │ +000197b0: 206d 6f76 6520 616c 6c20 7468 650a 2020 move all the. │ │ │ │ │ 000197c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000197d0: 2020 2020 2020 2020 2020 2020 2020 2077 w │ │ │ │ │ -000197e0: 6179 2028 6672 6f6d 2074 6f70 2074 6f20 ay (from top to │ │ │ │ │ -000197f0: 626f 7474 6f6d 292c 2062 6569 6e67 0a20 bottom), being. │ │ │ │ │ -00019800: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000197d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000197e0: 2077 6179 2028 6672 6f6d 2074 6f70 2074 way (from top t │ │ │ │ │ +000197f0: 6f20 626f 7474 6f6d 292c 2062 6569 6e67 o bottom), being │ │ │ │ │ +00019800: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00019810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019820: 2020 6472 6177 6e20 6f6e 2074 6865 2063 drawn on the c │ │ │ │ │ -00019830: 656e 7465 7220 736c 6963 6520 6f66 2074 enter slice of t │ │ │ │ │ -00019840: 6865 0a20 2020 2020 2020 2020 2020 2020 he. │ │ │ │ │ +00019820: 2020 2020 6472 6177 6e20 6f6e 2074 6865 drawn on the │ │ │ │ │ +00019830: 2063 656e 7465 7220 736c 6963 6520 6f66 center slice of │ │ │ │ │ +00019840: 2074 6865 0a20 2020 2020 2020 2020 2020 the. │ │ │ │ │ 00019850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019860: 2020 2020 2020 7363 726f 6c6c 6261 7220 scrollbar │ │ │ │ │ -00019870: 6672 616d 652e 2020 5468 6174 2077 6179 frame. That way │ │ │ │ │ -00019880: 2077 6520 6361 6e0a 2020 2020 2020 2020 we can. │ │ │ │ │ +00019860: 2020 2020 2020 2020 7363 726f 6c6c 6261 scrollba │ │ │ │ │ +00019870: 7220 6672 616d 652e 2020 5468 6174 2077 r frame. That w │ │ │ │ │ +00019880: 6179 2077 6520 6361 6e0a 2020 2020 2020 ay we can. │ │ │ │ │ 00019890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000198a0: 2020 2020 2020 2020 2020 206d 616b 6520 make │ │ │ │ │ -000198b0: 6120 7363 726f 6c6c 6261 7220 7769 7468 a scrollbar with │ │ │ │ │ -000198c0: 2072 6f75 6e64 2d73 6861 7065 640a 2020 round-shaped. │ │ │ │ │ +000198a0: 2020 2020 2020 2020 2020 2020 206d 616b mak │ │ │ │ │ +000198b0: 6520 6120 7363 726f 6c6c 6261 7220 7769 e a scrollbar wi │ │ │ │ │ +000198c0: 7468 2072 6f75 6e64 2d73 6861 7065 640a th round-shaped. │ │ │ │ │ 000198d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 000198e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000198f0: 2065 6467 6573 2073 6f20 7468 6572 6520 edges so there │ │ │ │ │ -00019900: 776f 6e27 7420 6265 2061 2066 7265 650a won't be a free. │ │ │ │ │ -00019910: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000198f0: 2020 2065 6467 6573 2073 6f20 7468 6572 edges so ther │ │ │ │ │ +00019900: 6520 776f 6e27 7420 6265 2061 2066 7265 e won't be a fre │ │ │ │ │ +00019910: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ 00019920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019930: 2020 2073 7061 6365 2066 726f 6d20 7468 space from th │ │ │ │ │ -00019940: 6520 7468 756d 6220 746f 2074 6865 2066 e thumb to the f │ │ │ │ │ -00019950: 7261 6d65 0a20 2020 2020 2020 2020 2020 rame. │ │ │ │ │ +00019930: 2020 2020 2073 7061 6365 2066 726f 6d20 space from │ │ │ │ │ +00019940: 7468 6520 7468 756d 6220 746f 2074 6865 the thumb to the │ │ │ │ │ +00019950: 2066 7261 6d65 0a20 2020 2020 2020 2020 frame. │ │ │ │ │ 00019960: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019970: 2020 2020 2020 2020 696e 2074 6f70 2061 in top a │ │ │ │ │ -00019980: 6e64 2062 6f74 746f 6d20 7363 726f 6c6c nd bottom scroll │ │ │ │ │ -00019990: 6261 720a 2020 2020 2020 2020 2020 2020 bar. │ │ │ │ │ +00019970: 2020 2020 2020 2020 2020 696e 2074 6f70 in top │ │ │ │ │ +00019980: 2061 6e64 2062 6f74 746f 6d20 7363 726f and bottom scro │ │ │ │ │ +00019990: 6c6c 6261 720a 2020 2020 2020 2020 2020 llbar. │ │ │ │ │ 000199a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000199b0: 2020 2020 2020 2070 6f73 6974 696f 6e73 positions │ │ │ │ │ -000199c0: 2e20 2044 6566 6175 6c74 2069 7320 2266 . Default is "f │ │ │ │ │ -000199d0: 616c 7365 222e 0a20 2020 2020 7363 726f alse".. scro │ │ │ │ │ -000199e0: 6c6c 6261 725f 736c 6963 6520 2020 2020 llbar_slice │ │ │ │ │ -000199f0: 2020 2020 2020 2020 2020 5468 6520 6d65 The me │ │ │ │ │ -00019a00: 6e75 2066 7261 6d65 2073 7479 6c65 6420 nu frame styled │ │ │ │ │ -00019a10: 626f 7827 7320 736c 6963 650a 2020 2020 box's slice. │ │ │ │ │ +000199b0: 2020 2020 2020 2020 2070 6f73 6974 696f positio │ │ │ │ │ +000199c0: 6e73 2e20 2044 6566 6175 6c74 2069 7320 ns. Default is │ │ │ │ │ +000199d0: 2266 616c 7365 222e 0a20 2020 2020 7363 "false".. sc │ │ │ │ │ +000199e0: 726f 6c6c 6261 725f 736c 6963 6520 2020 rollbar_slice │ │ │ │ │ +000199f0: 2020 2020 2020 2020 2020 2020 5468 6520 The │ │ │ │ │ +00019a00: 6d65 6e75 2066 7261 6d65 2073 7479 6c65 menu frame style │ │ │ │ │ +00019a10: 6420 626f 7827 7320 736c 6963 650a 2020 d box's slice. │ │ │ │ │ 00019a20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019a30: 2020 2020 2020 2020 2020 2020 2020 2069 i │ │ │ │ │ -00019a40: 6e20 7768 6963 6820 7468 6520 7363 726f n which the scro │ │ │ │ │ -00019a50: 6c6c 6261 7220 7769 6c6c 2062 650a 2020 llbar will be. │ │ │ │ │ +00019a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00019a40: 2069 6e20 7768 6963 6820 7468 6520 7363 in which the sc │ │ │ │ │ +00019a50: 726f 6c6c 6261 7220 7769 6c6c 2062 650a rollbar will be. │ │ │ │ │ 00019a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019a70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019a80: 2064 7261 776e 2e20 2050 6f73 7369 626c drawn. Possibl │ │ │ │ │ -00019a90: 6520 7661 6c75 6573 2061 7265 0a20 2020 e values are. │ │ │ │ │ +00019a80: 2020 2064 7261 776e 2e20 2050 6f73 7369 drawn. Possi │ │ │ │ │ +00019a90: 626c 6520 7661 6c75 6573 2061 7265 0a20 ble values are. │ │ │ │ │ 00019aa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019ac0: 2277 6573 7422 2c20 2263 656e 7465 7222 "west", "center" │ │ │ │ │ -00019ad0: 2c20 2265 6173 7422 0a20 2020 2020 2020 , "east". │ │ │ │ │ +00019ac0: 2020 2277 6573 7422 2c20 2263 656e 7465 "west", "cente │ │ │ │ │ +00019ad0: 7222 2c20 2265 6173 7422 0a20 2020 2020 r", "east". │ │ │ │ │ 00019ae0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019af0: 2020 2020 2020 2020 2020 2020 2864 6566 (def │ │ │ │ │ -00019b00: 6175 6c74 292e 2020 2277 6573 7422 202d ault). "west" - │ │ │ │ │ -00019b10: 2074 6865 2073 6372 6f6c 6c62 6172 0a20 the scrollbar. │ │ │ │ │ -00019b20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00019af0: 2020 2020 2020 2020 2020 2020 2020 2864 (d │ │ │ │ │ +00019b00: 6566 6175 6c74 292e 2020 2277 6573 7422 efault). "west" │ │ │ │ │ +00019b10: 202d 2074 6865 2073 6372 6f6c 6c62 6172 - the scrollbar │ │ │ │ │ +00019b20: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 00019b30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019b40: 2020 7769 6c6c 2062 6520 6472 6177 6e20 will be drawn │ │ │ │ │ -00019b50: 696e 2074 6865 2077 6573 7420 736c 6963 in the west slic │ │ │ │ │ -00019b60: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ +00019b40: 2020 2020 7769 6c6c 2062 6520 6472 6177 will be draw │ │ │ │ │ +00019b50: 6e20 696e 2074 6865 2077 6573 7420 736c n in the west sl │ │ │ │ │ +00019b60: 6963 650a 2020 2020 2020 2020 2020 2020 ice. │ │ │ │ │ 00019b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019b80: 2020 2020 2028 7269 6768 742d 616c 6967 (right-alig │ │ │ │ │ -00019b90: 6e65 6429 2e20 2022 6561 7374 2220 2d20 ned). "east" - │ │ │ │ │ -00019ba0: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ │ +00019b80: 2020 2020 2020 2028 7269 6768 742d 616c (right-al │ │ │ │ │ +00019b90: 6967 6e65 6429 2e20 2022 6561 7374 2220 igned). "east" │ │ │ │ │ +00019ba0: 2d20 7468 650a 2020 2020 2020 2020 2020 - the. │ │ │ │ │ 00019bb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019bc0: 2020 2020 2020 2073 6372 6f6c 6c62 6172 scrollbar │ │ │ │ │ -00019bd0: 2077 696c 6c20 6265 2064 7261 776e 2069 will be drawn i │ │ │ │ │ -00019be0: 6e20 7468 650a 2020 2020 2020 2020 2020 n the. │ │ │ │ │ +00019bc0: 2020 2020 2020 2020 2073 6372 6f6c 6c62 scrollb │ │ │ │ │ +00019bd0: 6172 2077 696c 6c20 6265 2064 7261 776e ar will be drawn │ │ │ │ │ +00019be0: 2069 6e20 7468 650a 2020 2020 2020 2020 in the. │ │ │ │ │ 00019bf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019c00: 2020 2020 2020 2020 2065 6173 7420 736c east sl │ │ │ │ │ -00019c10: 6963 6520 286c 6566 742d 616c 6967 6e65 ice (left-aligne │ │ │ │ │ -00019c20: 6429 2e0a 2020 2020 2020 2020 2020 2020 d).. │ │ │ │ │ +00019c00: 2020 2020 2020 2020 2020 2065 6173 7420 east │ │ │ │ │ +00019c10: 736c 6963 6520 286c 6566 742d 616c 6967 slice (left-alig │ │ │ │ │ +00019c20: 6e65 6429 2e0a 2020 2020 2020 2020 2020 ned).. │ │ │ │ │ 00019c30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019c40: 2020 2020 2020 2022 6365 6e74 6572 2220 "center" │ │ │ │ │ -00019c50: 2d20 7468 6520 7363 726f 6c6c 6261 7220 - the scrollbar │ │ │ │ │ -00019c60: 7769 6c6c 2062 650a 2020 2020 2020 2020 will be. │ │ │ │ │ +00019c40: 2020 2020 2020 2020 2022 6365 6e74 6572 "center │ │ │ │ │ +00019c50: 2220 2d20 7468 6520 7363 726f 6c6c 6261 " - the scrollba │ │ │ │ │ +00019c60: 7220 7769 6c6c 2062 650a 2020 2020 2020 r will be. │ │ │ │ │ 00019c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019c80: 2020 2020 2020 2020 2020 2064 7261 776e drawn │ │ │ │ │ -00019c90: 2069 6e20 7468 6520 6365 6e74 6572 2073 in the center s │ │ │ │ │ -00019ca0: 6c69 6365 2e20 204e 6f74 653a 0a20 2020 lice. Note:. │ │ │ │ │ +00019c80: 2020 2020 2020 2020 2020 2020 2064 7261 dra │ │ │ │ │ +00019c90: 776e 2069 6e20 7468 6520 6365 6e74 6572 wn in the center │ │ │ │ │ +00019ca0: 2073 6c69 6365 2e20 204e 6f74 653a 0a20 slice. Note:. │ │ │ │ │ 00019cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019cc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019cd0: 696e 2063 6173 6520 6f66 2022 6365 6e74 in case of "cent │ │ │ │ │ -00019ce0: 6572 2220 736c 6963 653a 2061 2920 4966 er" slice: a) If │ │ │ │ │ -00019cf0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00019cd0: 2020 696e 2063 6173 6520 6f66 2022 6365 in case of "ce │ │ │ │ │ +00019ce0: 6e74 6572 2220 736c 6963 653a 2061 2920 nter" slice: a) │ │ │ │ │ +00019cf0: 4966 0a20 2020 2020 2020 2020 2020 2020 If. │ │ │ │ │ 00019d00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019d10: 2020 2020 7468 6520 7363 726f 6c6c 6261 the scrollba │ │ │ │ │ -00019d20: 7220 7368 6f75 6c64 2062 6520 6472 6177 r should be draw │ │ │ │ │ -00019d30: 6e20 7468 656e 0a20 2020 2020 2020 2020 n then. │ │ │ │ │ +00019d10: 2020 2020 2020 7468 6520 7363 726f 6c6c the scroll │ │ │ │ │ +00019d20: 6261 7220 7368 6f75 6c64 2062 6520 6472 bar should be dr │ │ │ │ │ +00019d30: 6177 6e20 7468 656e 0a20 2020 2020 2020 awn then. │ │ │ │ │ 00019d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019d50: 2020 2020 2020 2020 2020 626f 6f74 206d boot m │ │ │ │ │ -00019d60: 656e 7520 656e 7472 7927 7320 7769 6474 enu entry's widt │ │ │ │ │ -00019d70: 6820 6973 0a20 2020 2020 2020 2020 2020 h is. │ │ │ │ │ +00019d50: 2020 2020 2020 2020 2020 2020 626f 6f74 boot │ │ │ │ │ +00019d60: 206d 656e 7520 656e 7472 7927 7320 7769 menu entry's wi │ │ │ │ │ +00019d70: 6474 6820 6973 0a20 2020 2020 2020 2020 dth is. │ │ │ │ │ 00019d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019d90: 2020 2020 2020 2020 6465 6372 6561 7365 decrease │ │ │ │ │ -00019da0: 6420 6279 2074 6865 2073 6372 6f6c 6c62 d by the scrollb │ │ │ │ │ -00019db0: 6172 2773 2077 6964 7468 0a20 2020 2020 ar's width. │ │ │ │ │ +00019d90: 2020 2020 2020 2020 2020 6465 6372 6561 decrea │ │ │ │ │ +00019da0: 7365 6420 6279 2074 6865 2073 6372 6f6c sed by the scrol │ │ │ │ │ +00019db0: 6c62 6172 2773 2077 6964 7468 0a20 2020 lbar's width. │ │ │ │ │ 00019dc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019dd0: 2020 2020 2020 2020 2020 2020 2020 616e an │ │ │ │ │ -00019de0: 6420 7468 6520 7363 726f 6c6c 6261 7220 d the scrollbar │ │ │ │ │ -00019df0: 6973 2064 7261 776e 2061 7420 7468 650a is drawn at the. │ │ │ │ │ -00019e00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00019dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00019de0: 616e 6420 7468 6520 7363 726f 6c6c 6261 and the scrollba │ │ │ │ │ +00019df0: 7220 6973 2064 7261 776e 2061 7420 7468 r is drawn at th │ │ │ │ │ +00019e00: 650a 2020 2020 2020 2020 2020 2020 2020 e. │ │ │ │ │ 00019e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019e20: 2020 2072 6967 6874 2073 6964 6520 6f66 right side of │ │ │ │ │ -00019e30: 2074 6865 2063 656e 7465 7220 736c 6963 the center slic │ │ │ │ │ -00019e40: 652e 0a20 2020 2020 2020 2020 2020 2020 e.. │ │ │ │ │ +00019e20: 2020 2020 2072 6967 6874 2073 6964 6520 right side │ │ │ │ │ +00019e30: 6f66 2074 6865 2063 656e 7465 7220 736c of the center sl │ │ │ │ │ +00019e40: 6963 652e 0a20 2020 2020 2020 2020 2020 ice.. │ │ │ │ │ 00019e50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019e60: 2020 2020 2020 6229 2049 6620 7468 6520 b) If the │ │ │ │ │ -00019e70: 7363 726f 6c6c 6261 7220 776f 6e27 7420 scrollbar won't │ │ │ │ │ -00019e80: 6265 2064 7261 776e 0a20 2020 2020 2020 be drawn. │ │ │ │ │ +00019e60: 2020 2020 2020 2020 6229 2049 6620 7468 b) If th │ │ │ │ │ +00019e70: 6520 7363 726f 6c6c 6261 7220 776f 6e27 e scrollbar won' │ │ │ │ │ +00019e80: 7420 6265 2064 7261 776e 0a20 2020 2020 t be drawn. │ │ │ │ │ 00019e90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019ea0: 2020 2020 2020 2020 2020 2020 7468 656e then │ │ │ │ │ -00019eb0: 2074 6865 2062 6f6f 7420 6d65 6e75 2065 the boot menu e │ │ │ │ │ -00019ec0: 6e74 7279 2773 2077 6964 7468 0a20 2020 ntry's width. │ │ │ │ │ +00019ea0: 2020 2020 2020 2020 2020 2020 2020 7468 th │ │ │ │ │ +00019eb0: 656e 2074 6865 2062 6f6f 7420 6d65 6e75 en the boot menu │ │ │ │ │ +00019ec0: 2065 6e74 7279 2773 2077 6964 7468 0a20 entry's width. │ │ │ │ │ 00019ed0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00019ee0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019ef0: 6973 2074 6865 2077 6964 7468 206f 6620 is the width of │ │ │ │ │ -00019f00: 7468 6520 6365 6e74 6572 2073 6c69 6365 the center slice │ │ │ │ │ -00019f10: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +00019ef0: 2020 6973 2074 6865 2077 6964 7468 206f is the width o │ │ │ │ │ +00019f00: 6620 7468 6520 6365 6e74 6572 2073 6c69 f the center sli │ │ │ │ │ +00019f10: 6365 2e0a 2020 2020 2020 2020 2020 2020 ce.. │ │ │ │ │ 00019f20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019f30: 2020 2020 2063 2920 5765 2064 6f6e 2774 c) We don't │ │ │ │ │ -00019f40: 206e 6563 6573 7361 7279 206e 6565 6420 necessary need │ │ │ │ │ -00019f50: 7468 650a 2020 2020 2020 2020 2020 2020 the. │ │ │ │ │ +00019f30: 2020 2020 2020 2063 2920 5765 2064 6f6e c) We don │ │ │ │ │ +00019f40: 2774 206e 6563 6573 7361 7279 206e 6565 't necessary nee │ │ │ │ │ +00019f50: 6420 7468 650a 2020 2020 2020 2020 2020 d the. │ │ │ │ │ 00019f60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019f70: 2020 2020 2020 206d 656e 7520 7069 786d menu pixm │ │ │ │ │ -00019f80: 6170 2062 6f78 2074 6f20 6469 7370 6c61 ap box to displa │ │ │ │ │ -00019f90: 7920 7468 650a 2020 2020 2020 2020 2020 y the. │ │ │ │ │ +00019f70: 2020 2020 2020 2020 206d 656e 7520 7069 menu pi │ │ │ │ │ +00019f80: 786d 6170 2062 6f78 2074 6f20 6469 7370 xmap box to disp │ │ │ │ │ +00019f90: 6c61 7920 7468 650a 2020 2020 2020 2020 lay the. │ │ │ │ │ 00019fa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00019fb0: 2020 2020 2020 2020 2073 6372 6f6c 6c62 scrollb │ │ │ │ │ -00019fc0: 6172 2e0a 2020 2020 2073 6372 6f6c 6c62 ar.. scrollb │ │ │ │ │ -00019fd0: 6172 5f6c 6566 745f 7061 6420 2020 2020 ar_left_pad │ │ │ │ │ -00019fe0: 2020 2020 2020 2054 6865 206c 6566 7420 The left │ │ │ │ │ -00019ff0: 7363 726f 6c6c 6261 7220 7061 6464 696e scrollbar paddin │ │ │ │ │ -0001a000: 6720 696e 0a20 2020 2020 2020 2020 2020 g in. │ │ │ │ │ +00019fb0: 2020 2020 2020 2020 2020 2073 6372 6f6c scrol │ │ │ │ │ +00019fc0: 6c62 6172 2e0a 2020 2020 2073 6372 6f6c lbar.. scrol │ │ │ │ │ +00019fd0: 6c62 6172 5f6c 6566 745f 7061 6420 2020 lbar_left_pad │ │ │ │ │ +00019fe0: 2020 2020 2020 2020 2054 6865 206c 6566 The lef │ │ │ │ │ +00019ff0: 7420 7363 726f 6c6c 6261 7220 7061 6464 t scrollbar padd │ │ │ │ │ +0001a000: 696e 6720 696e 0a20 2020 2020 2020 2020 ing in. │ │ │ │ │ 0001a010: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a020: 2020 2020 2020 2020 7069 7865 6c73 2e20 pixels. │ │ │ │ │ -0001a030: 2055 6e75 7365 6420 6966 0a20 2020 2020 Unused if. │ │ │ │ │ +0001a020: 2020 2020 2020 2020 2020 7069 7865 6c73 pixels │ │ │ │ │ +0001a030: 2e20 2055 6e75 7365 6420 6966 0a20 2020 . Unused if. │ │ │ │ │ 0001a040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a050: 2020 2020 2020 2020 2020 2020 2020 2273 "s │ │ │ │ │ -0001a060: 6372 6f6c 6c62 6172 5f73 6c69 6365 2220 crollbar_slice" │ │ │ │ │ -0001a070: 6973 2022 7765 7374 222e 0a20 2020 2020 is "west".. │ │ │ │ │ -0001a080: 7363 726f 6c6c 6261 725f 7269 6768 745f scrollbar_right_ │ │ │ │ │ -0001a090: 7061 6420 2020 2020 2020 2020 2020 5468 pad Th │ │ │ │ │ -0001a0a0: 6520 7269 6768 7420 7363 726f 6c6c 6261 e right scrollba │ │ │ │ │ -0001a0b0: 7220 7061 6464 696e 6720 696e 0a20 2020 r padding in. │ │ │ │ │ +0001a050: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0001a060: 2273 6372 6f6c 6c62 6172 5f73 6c69 6365 "scrollbar_slice │ │ │ │ │ +0001a070: 2220 6973 2022 7765 7374 222e 0a20 2020 " is "west".. │ │ │ │ │ +0001a080: 2020 7363 726f 6c6c 6261 725f 7269 6768 scrollbar_righ │ │ │ │ │ +0001a090: 745f 7061 6420 2020 2020 2020 2020 2020 t_pad │ │ │ │ │ +0001a0a0: 5468 6520 7269 6768 7420 7363 726f 6c6c The right scroll │ │ │ │ │ +0001a0b0: 6261 7220 7061 6464 696e 6720 696e 0a20 bar padding in. │ │ │ │ │ 0001a0c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0001a0d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a0e0: 7069 7865 6c73 2e20 2055 6e75 7365 6420 pixels. Unused │ │ │ │ │ -0001a0f0: 6966 0a20 2020 2020 2020 2020 2020 2020 if. │ │ │ │ │ +0001a0e0: 2020 7069 7865 6c73 2e20 2055 6e75 7365 pixels. Unuse │ │ │ │ │ +0001a0f0: 6420 6966 0a20 2020 2020 2020 2020 2020 d if. │ │ │ │ │ 0001a100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a110: 2020 2020 2020 2273 6372 6f6c 6c62 6172 "scrollbar │ │ │ │ │ -0001a120: 5f73 6c69 6365 2220 6973 2022 6561 7374 _slice" is "east │ │ │ │ │ -0001a130: 222e 0a20 2020 2020 7363 726f 6c6c 6261 ".. scrollba │ │ │ │ │ -0001a140: 725f 746f 705f 7061 6420 2020 2020 2020 r_top_pad │ │ │ │ │ -0001a150: 2020 2020 2020 5468 6520 746f 7020 7363 The top sc │ │ │ │ │ -0001a160: 726f 6c6c 6261 7220 7061 6464 696e 6720 rollbar padding │ │ │ │ │ -0001a170: 696e 0a20 2020 2020 2020 2020 2020 2020 in. │ │ │ │ │ +0001a110: 2020 2020 2020 2020 2273 6372 6f6c 6c62 "scrollb │ │ │ │ │ +0001a120: 6172 5f73 6c69 6365 2220 6973 2022 6561 ar_slice" is "ea │ │ │ │ │ +0001a130: 7374 222e 0a20 2020 2020 7363 726f 6c6c st".. scroll │ │ │ │ │ +0001a140: 6261 725f 746f 705f 7061 6420 2020 2020 bar_top_pad │ │ │ │ │ +0001a150: 2020 2020 2020 2020 5468 6520 746f 7020 The top │ │ │ │ │ +0001a160: 7363 726f 6c6c 6261 7220 7061 6464 696e scrollbar paddin │ │ │ │ │ +0001a170: 6720 696e 0a20 2020 2020 2020 2020 2020 g in. │ │ │ │ │ 0001a180: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a190: 2020 2020 2020 7069 7865 6c73 2e0a 2020 pixels.. │ │ │ │ │ -0001a1a0: 2020 2073 6372 6f6c 6c62 6172 5f62 6f74 scrollbar_bot │ │ │ │ │ -0001a1b0: 746f 6d5f 7061 6420 2020 2020 2020 2020 tom_pad │ │ │ │ │ -0001a1c0: 2054 6865 2062 6f74 746f 6d20 7363 726f The bottom scro │ │ │ │ │ -0001a1d0: 6c6c 6261 7220 7061 6464 696e 6720 696e llbar padding in │ │ │ │ │ -0001a1e0: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0001a190: 2020 2020 2020 2020 7069 7865 6c73 2e0a pixels.. │ │ │ │ │ +0001a1a0: 2020 2020 2073 6372 6f6c 6c62 6172 5f62 scrollbar_b │ │ │ │ │ +0001a1b0: 6f74 746f 6d5f 7061 6420 2020 2020 2020 ottom_pad │ │ │ │ │ +0001a1c0: 2020 2054 6865 2062 6f74 746f 6d20 7363 The bottom sc │ │ │ │ │ +0001a1d0: 726f 6c6c 6261 7220 7061 6464 696e 6720 rollbar padding │ │ │ │ │ +0001a1e0: 696e 0a20 2020 2020 2020 2020 2020 2020 in. │ │ │ │ │ 0001a1f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a200: 2020 2020 7069 7865 6c73 2e0a 2020 2020 pixels.. │ │ │ │ │ -0001a210: 2076 6973 6962 6c65 2020 2020 2020 2020 visible │ │ │ │ │ -0001a220: 2020 2020 2020 2020 2020 2020 2020 2053 S │ │ │ │ │ -0001a230: 6574 2074 6f20 2266 616c 7365 2220 746f et to "false" to │ │ │ │ │ -0001a240: 2068 6964 6520 7468 6520 626f 6f74 0a20 hide the boot. │ │ │ │ │ -0001a250: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0001a200: 2020 2020 2020 7069 7865 6c73 2e0a 2020 pixels.. │ │ │ │ │ +0001a210: 2020 2076 6973 6962 6c65 2020 2020 2020 visible │ │ │ │ │ +0001a220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0001a230: 2053 6574 2074 6f20 2266 616c 7365 2220 Set to "false" │ │ │ │ │ +0001a240: 746f 2068 6964 6520 7468 6520 626f 6f74 to hide the boot │ │ │ │ │ +0001a250: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ 0001a260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a270: 2020 6d65 6e75 2e0a 0a20 2020 2a20 6361 menu... * ca │ │ │ │ │ -0001a280: 6e76 6173 2043 616e 7661 7320 6973 2061 nvas Canvas is a │ │ │ │ │ -0001a290: 2063 6f6e 7461 696e 6572 2074 6861 7420 container that │ │ │ │ │ -0001a2a0: 616c 6c6f 7773 206d 616e 7561 6c20 706c allows manual pl │ │ │ │ │ -0001a2b0: 6163 656d 656e 7420 6f66 0a20 2020 2020 acement of. │ │ │ │ │ -0001a2c0: 636f 6d70 6f6e 656e 7473 2077 6974 6869 components withi │ │ │ │ │ -0001a2d0: 6e20 6974 2e20 2049 7420 646f 6573 206e n it. It does n │ │ │ │ │ -0001a2e0: 6f74 2061 6c74 6572 2074 6865 2070 6f73 ot alter the pos │ │ │ │ │ -0001a2f0: 6974 696f 6e73 206f 6620 6974 7320 6368 itions of its ch │ │ │ │ │ -0001a300: 696c 640a 2020 2020 2063 6f6d 706f 6e65 ild. compone │ │ │ │ │ -0001a310: 6e74 732e 2020 4974 2061 7373 6967 6e73 nts. It assigns │ │ │ │ │ -0001a320: 2061 6c6c 2063 6869 6c64 2063 6f6d 706f all child compo │ │ │ │ │ -0001a330: 6e65 6e74 7320 7468 6569 7220 7072 6566 nents their pref │ │ │ │ │ -0001a340: 6572 7265 6420 7369 7a65 732e 0a0a 2020 erred sizes... │ │ │ │ │ -0001a350: 202a 2068 626f 7820 5468 6520 2a68 626f * hbox The *hbo │ │ │ │ │ -0001a360: 782a 2063 6f6e 7461 696e 6572 206c 6179 x* container lay │ │ │ │ │ -0001a370: 7320 6f75 7420 6974 7320 6368 696c 6472 s out its childr │ │ │ │ │ -0001a380: 656e 2066 726f 6d20 6c65 6674 2074 6f20 en from left to │ │ │ │ │ -0001a390: 7269 6768 742c 0a20 2020 2020 6769 7669 right,. givi │ │ │ │ │ -0001a3a0: 6e67 2065 6163 6820 6f6e 6520 6974 7320 ng each one its │ │ │ │ │ -0001a3b0: 7072 6566 6572 7265 6420 7769 6474 682e preferred width. │ │ │ │ │ -0001a3c0: 2020 5468 6520 6865 6967 6874 206f 6620 The height of │ │ │ │ │ -0001a3d0: 6561 6368 2063 6869 6c64 2069 730a 2020 each child is. │ │ │ │ │ -0001a3e0: 2020 2073 6574 2074 6f20 7468 6520 6d61 set to the ma │ │ │ │ │ -0001a3f0: 7869 6d75 6d20 6f66 2074 6865 2070 7265 ximum of the pre │ │ │ │ │ -0001a400: 6665 7272 6564 2068 6569 6768 7473 206f ferred heights o │ │ │ │ │ -0001a410: 6620 616c 6c20 6368 696c 6472 656e 2e0a f all children.. │ │ │ │ │ -0001a420: 0a20 2020 2a20 7662 6f78 2054 6865 202a . * vbox The * │ │ │ │ │ -0001a430: 7662 6f78 2a20 636f 6e74 6169 6e65 7220 vbox* container │ │ │ │ │ -0001a440: 6c61 7973 206f 7574 2069 7473 2063 6869 lays out its chi │ │ │ │ │ -0001a450: 6c64 7265 6e20 6672 6f6d 2074 6f70 2074 ldren from top t │ │ │ │ │ -0001a460: 6f20 626f 7474 6f6d 2c0a 2020 2020 2067 o bottom,. g │ │ │ │ │ -0001a470: 6976 696e 6720 6561 6368 206f 6e65 2069 iving each one i │ │ │ │ │ -0001a480: 7473 2070 7265 6665 7272 6564 2068 6569 ts preferred hei │ │ │ │ │ -0001a490: 6768 742e 2020 5468 6520 7769 6474 6820 ght. The width │ │ │ │ │ -0001a4a0: 6f66 2065 6163 6820 6368 696c 6420 6973 of each child is │ │ │ │ │ -0001a4b0: 0a20 2020 2020 7365 7420 746f 2074 6865 . set to the │ │ │ │ │ -0001a4c0: 206d 6178 696d 756d 206f 6620 7468 6520 maximum of the │ │ │ │ │ -0001a4d0: 7072 6566 6572 7265 6420 7769 6474 6873 preferred widths │ │ │ │ │ -0001a4e0: 206f 6620 616c 6c20 6368 696c 6472 656e of all children │ │ │ │ │ -0001a4f0: 2e0a 0a37 2e33 2e36 2043 6f6d 6d6f 6e20 ...7.3.6 Common │ │ │ │ │ -0001a500: 7072 6f70 6572 7469 6573 0a2d 2d2d 2d2d properties.----- │ │ │ │ │ +0001a270: 2020 2020 6d65 6e75 2e0a 0a20 2020 2a20 menu... * │ │ │ │ │ +0001a280: 6361 6e76 6173 2043 616e 7661 7320 6973 canvas Canvas is │ │ │ │ │ +0001a290: 2061 2063 6f6e 7461 696e 6572 2074 6861 a container tha │ │ │ │ │ +0001a2a0: 7420 616c 6c6f 7773 206d 616e 7561 6c20 t allows manual │ │ │ │ │ +0001a2b0: 706c 6163 656d 656e 7420 6f66 0a20 2020 placement of. │ │ │ │ │ +0001a2c0: 2020 636f 6d70 6f6e 656e 7473 2077 6974 components wit │ │ │ │ │ +0001a2d0: 6869 6e20 6974 2e20 2049 7420 646f 6573 hin it. It does │ │ │ │ │ +0001a2e0: 206e 6f74 2061 6c74 6572 2074 6865 2070 not alter the p │ │ │ │ │ +0001a2f0: 6f73 6974 696f 6e73 206f 6620 6974 7320 ositions of its │ │ │ │ │ +0001a300: 6368 696c 640a 2020 2020 2063 6f6d 706f child. compo │ │ │ │ │ +0001a310: 6e65 6e74 732e 2020 4974 2061 7373 6967 nents. It assig │ │ │ │ │ +0001a320: 6e73 2061 6c6c 2063 6869 6c64 2063 6f6d ns all child com │ │ │ │ │ +0001a330: 706f 6e65 6e74 7320 7468 6569 7220 7072 ponents their pr │ │ │ │ │ +0001a340: 6566 6572 7265 6420 7369 7a65 732e 0a0a eferred sizes... │ │ │ │ │ +0001a350: 2020 202a 2068 626f 7820 5468 6520 2a68 * hbox The *h │ │ │ │ │ +0001a360: 626f 782a 2063 6f6e 7461 696e 6572 206c box* container l │ │ │ │ │ +0001a370: 6179 7320 6f75 7420 6974 7320 6368 696c ays out its chil │ │ │ │ │ +0001a380: 6472 656e 2066 726f 6d20 6c65 6674 2074 dren from left t │ │ │ │ │ +0001a390: 6f20 7269 6768 742c 0a20 2020 2020 6769 o right,. gi │ │ │ │ │ +0001a3a0: 7669 6e67 2065 6163 6820 6f6e 6520 6974 ving each one it │ │ │ │ │ +0001a3b0: 7320 7072 6566 6572 7265 6420 7769 6474 s preferred widt │ │ │ │ │ +0001a3c0: 682e 2020 5468 6520 6865 6967 6874 206f h. The height o │ │ │ │ │ +0001a3d0: 6620 6561 6368 2063 6869 6c64 2069 730a f each child is. │ │ │ │ │ +0001a3e0: 2020 2020 2073 6574 2074 6f20 7468 6520 set to the │ │ │ │ │ +0001a3f0: 6d61 7869 6d75 6d20 6f66 2074 6865 2070 maximum of the p │ │ │ │ │ +0001a400: 7265 6665 7272 6564 2068 6569 6768 7473 referred heights │ │ │ │ │ +0001a410: 206f 6620 616c 6c20 6368 696c 6472 656e of all children │ │ │ │ │ +0001a420: 2e0a 0a20 2020 2a20 7662 6f78 2054 6865 ... * vbox The │ │ │ │ │ +0001a430: 202a 7662 6f78 2a20 636f 6e74 6169 6e65 *vbox* containe │ │ │ │ │ +0001a440: 7220 6c61 7973 206f 7574 2069 7473 2063 r lays out its c │ │ │ │ │ +0001a450: 6869 6c64 7265 6e20 6672 6f6d 2074 6f70 hildren from top │ │ │ │ │ +0001a460: 2074 6f20 626f 7474 6f6d 2c0a 2020 2020 to bottom,. │ │ │ │ │ +0001a470: 2067 6976 696e 6720 6561 6368 206f 6e65 giving each one │ │ │ │ │ +0001a480: 2069 7473 2070 7265 6665 7272 6564 2068 its preferred h │ │ │ │ │ +0001a490: 6569 6768 742e 2020 5468 6520 7769 6474 eight. The widt │ │ │ │ │ +0001a4a0: 6820 6f66 2065 6163 6820 6368 696c 6420 h of each child │ │ │ │ │ +0001a4b0: 6973 0a20 2020 2020 7365 7420 746f 2074 is. set to t │ │ │ │ │ +0001a4c0: 6865 206d 6178 696d 756d 206f 6620 7468 he maximum of th │ │ │ │ │ +0001a4d0: 6520 7072 6566 6572 7265 6420 7769 6474 e preferred widt │ │ │ │ │ +0001a4e0: 6873 206f 6620 616c 6c20 6368 696c 6472 hs of all childr │ │ │ │ │ +0001a4f0: 656e 2e0a 0a37 2e33 2e36 2043 6f6d 6d6f en...7.3.6 Commo │ │ │ │ │ +0001a500: 6e20 7072 6f70 6572 7469 6573 0a2d 2d2d n properties.--- │ │ │ │ │ 0001a510: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0001a520: 2d2d 0a0a 5468 6520 666f 6c6c 6f77 696e --..The followin │ │ │ │ │ -0001a530: 6720 7072 6f70 6572 7469 6573 2061 7265 g properties are │ │ │ │ │ -0001a540: 2073 7570 706f 7274 6564 2062 7920 616c supported by al │ │ │ │ │ -0001a550: 6c20 636f 6d70 6f6e 656e 7473 3a0a 276c l components:.'l │ │ │ │ │ -0001a560: 6566 7427 0a20 2020 2020 5468 6520 6469 eft'. The di │ │ │ │ │ -0001a570: 7374 616e 6365 2066 726f 6d20 7468 6520 stance from the │ │ │ │ │ -0001a580: 6c65 6674 2062 6f72 6465 7220 6f66 2063 left border of c │ │ │ │ │ -0001a590: 6f6e 7461 696e 6572 2074 6f20 6c65 6674 ontainer to left │ │ │ │ │ -0001a5a0: 2062 6f72 6465 7220 6f66 0a20 2020 2020 border of. │ │ │ │ │ -0001a5b0: 7468 6520 6f62 6a65 6374 2069 6e20 6569 the object in ei │ │ │ │ │ -0001a5c0: 7468 6572 206f 6620 7468 7265 6520 666f ther of three fo │ │ │ │ │ -0001a5d0: 726d 6174 733a 0a20 2020 2020 7820 2020 rmats:. x │ │ │ │ │ -0001a5e0: 2020 2020 2020 2020 2020 2056 616c 7565 Value │ │ │ │ │ -0001a5f0: 2069 6e20 7069 7865 6c73 0a20 2020 2020 in pixels. │ │ │ │ │ -0001a600: 7025 2020 2020 2020 2020 2020 2020 2050 p% P │ │ │ │ │ -0001a610: 6572 6365 6e74 6167 650a 2020 2020 2070 ercentage. p │ │ │ │ │ -0001a620: 252b 7820 2020 2020 2020 2020 2020 6d69 %+x mi │ │ │ │ │ -0001a630: 7874 7572 6520 6f66 2062 6f74 680a 2774 xture of both.'t │ │ │ │ │ -0001a640: 6f70 270a 2020 2020 2054 6865 2064 6973 op'. The dis │ │ │ │ │ -0001a650: 7461 6e63 6520 6672 6f6d 2074 6865 206c tance from the l │ │ │ │ │ -0001a660: 6566 7420 626f 7264 6572 206f 6620 636f eft border of co │ │ │ │ │ -0001a670: 6e74 6169 6e65 7220 746f 206c 6566 7420 ntainer to left │ │ │ │ │ -0001a680: 626f 7264 6572 206f 660a 2020 2020 2074 border of. t │ │ │ │ │ -0001a690: 6865 206f 626a 6563 7420 696e 2073 616d he object in sam │ │ │ │ │ -0001a6a0: 6520 666f 726d 6174 2e0a 2777 6964 7468 e format..'width │ │ │ │ │ -0001a6b0: 270a 2020 2020 2054 6865 2077 6964 7468 '. The width │ │ │ │ │ -0001a6c0: 206f 6620 6f62 6a65 6374 2069 6e20 7361 of object in sa │ │ │ │ │ -0001a6d0: 6d65 2066 6f72 6d61 742e 0a27 6865 6967 me format..'heig │ │ │ │ │ -0001a6e0: 6874 270a 2020 2020 2054 6865 2068 6569 ht'. The hei │ │ │ │ │ -0001a6f0: 6768 7420 6f66 206f 626a 6563 7420 696e ght of object in │ │ │ │ │ -0001a700: 2073 616d 6520 666f 726d 6174 2e0a 2769 same format..'i │ │ │ │ │ -0001a710: 6427 0a20 2020 2020 5468 6520 6964 656e d'. The iden │ │ │ │ │ -0001a720: 7469 6669 6572 2066 6f72 2074 6865 2063 tifier for the c │ │ │ │ │ -0001a730: 6f6d 706f 6e65 6e74 2e20 2054 6869 7320 omponent. This │ │ │ │ │ -0001a740: 6361 6e20 6265 2061 6e79 2061 7262 6974 can be any arbit │ │ │ │ │ -0001a750: 7261 7279 0a20 2020 2020 7374 7269 6e67 rary. string │ │ │ │ │ -0001a760: 2e20 2054 6865 2049 4420 6361 6e20 6265 . The ID can be │ │ │ │ │ -0001a770: 2075 7365 6420 6279 2073 6372 6970 7473 used by scripts │ │ │ │ │ -0001a780: 2074 6f20 7265 6665 7220 746f 2076 6172 to refer to var │ │ │ │ │ -0001a790: 696f 7573 0a20 2020 2020 636f 6d70 6f6e ious. compon │ │ │ │ │ -0001a7a0: 656e 7473 2069 6e20 7468 6520 4755 4920 ents in the GUI │ │ │ │ │ -0001a7b0: 636f 6d70 6f6e 656e 7420 7472 6565 2e20 component tree. │ │ │ │ │ -0001a7c0: 2043 7572 7265 6e74 6c79 2c20 7468 6572 Currently, ther │ │ │ │ │ -0001a7d0: 6520 6973 206f 6e65 0a20 2020 2020 7370 e is one. sp │ │ │ │ │ -0001a7e0: 6563 6961 6c20 4944 2076 616c 7565 2074 ecial ID value t │ │ │ │ │ -0001a7f0: 6861 7420 4752 5542 2072 6563 6f67 6e69 hat GRUB recogni │ │ │ │ │ -0001a800: 7a65 733a 0a0a 2020 2020 2022 5f5f 7469 zes:.. "__ti │ │ │ │ │ -0001a810: 6d65 6f75 745f 5f22 2020 436f 6d70 6f6e meout__" Compon │ │ │ │ │ -0001a820: 656e 7420 7769 7468 2074 6869 7320 4944 ent with this ID │ │ │ │ │ -0001a830: 2077 696c 6c20 6265 2075 7064 6174 6564 will be updated │ │ │ │ │ -0001a840: 2062 7920 4752 5542 0a20 2020 2020 2020 by GRUB. │ │ │ │ │ -0001a850: 2020 2020 2020 2020 2020 2020 2061 6e64 and │ │ │ │ │ -0001a860: 2077 696c 6c20 696e 6469 6361 7465 2074 will indicate t │ │ │ │ │ -0001a870: 696d 6520 656c 6170 7365 6420 746f 2061 ime elapsed to a │ │ │ │ │ -0001a880: 6e20 6175 746f 6d61 7469 6361 6c0a 2020 n automatical. │ │ │ │ │ +0001a520: 2d2d 2d2d 0a0a 5468 6520 666f 6c6c 6f77 ----..The follow │ │ │ │ │ +0001a530: 696e 6720 7072 6f70 6572 7469 6573 2061 ing properties a │ │ │ │ │ +0001a540: 7265 2073 7570 706f 7274 6564 2062 7920 re supported by │ │ │ │ │ +0001a550: 616c 6c20 636f 6d70 6f6e 656e 7473 3a0a all components:. │ │ │ │ │ +0001a560: 276c 6566 7427 0a20 2020 2020 5468 6520 'left'. The │ │ │ │ │ +0001a570: 6469 7374 616e 6365 2066 726f 6d20 7468 distance from th │ │ │ │ │ +0001a580: 6520 6c65 6674 2062 6f72 6465 7220 6f66 e left border of │ │ │ │ │ +0001a590: 2063 6f6e 7461 696e 6572 2074 6f20 6c65 container to le │ │ │ │ │ +0001a5a0: 6674 2062 6f72 6465 7220 6f66 0a20 2020 ft border of. │ │ │ │ │ +0001a5b0: 2020 7468 6520 6f62 6a65 6374 2069 6e20 the object in │ │ │ │ │ +0001a5c0: 6569 7468 6572 206f 6620 7468 7265 6520 either of three │ │ │ │ │ +0001a5d0: 666f 726d 6174 733a 0a20 2020 2020 7820 formats:. x │ │ │ │ │ +0001a5e0: 2020 2020 2020 2020 2020 2020 2056 616c Val │ │ │ │ │ +0001a5f0: 7565 2069 6e20 7069 7865 6c73 0a20 2020 ue in pixels. │ │ │ │ │ +0001a600: 2020 7025 2020 2020 2020 2020 2020 2020 p% │ │ │ │ │ +0001a610: 2050 6572 6365 6e74 6167 650a 2020 2020 Percentage. │ │ │ │ │ +0001a620: 2070 252b 7820 2020 2020 2020 2020 2020 p%+x │ │ │ │ │ +0001a630: 6d69 7874 7572 6520 6f66 2062 6f74 680a mixture of both. │ │ │ │ │ +0001a640: 2774 6f70 270a 2020 2020 2054 6865 2064 'top'. The d │ │ │ │ │ +0001a650: 6973 7461 6e63 6520 6672 6f6d 2074 6865 istance from the │ │ │ │ │ +0001a660: 206c 6566 7420 626f 7264 6572 206f 6620 left border of │ │ │ │ │ +0001a670: 636f 6e74 6169 6e65 7220 746f 206c 6566 container to lef │ │ │ │ │ +0001a680: 7420 626f 7264 6572 206f 660a 2020 2020 t border of. │ │ │ │ │ +0001a690: 2074 6865 206f 626a 6563 7420 696e 2073 the object in s │ │ │ │ │ +0001a6a0: 616d 6520 666f 726d 6174 2e0a 2777 6964 ame format..'wid │ │ │ │ │ +0001a6b0: 7468 270a 2020 2020 2054 6865 2077 6964 th'. The wid │ │ │ │ │ +0001a6c0: 7468 206f 6620 6f62 6a65 6374 2069 6e20 th of object in │ │ │ │ │ +0001a6d0: 7361 6d65 2066 6f72 6d61 742e 0a27 6865 same format..'he │ │ │ │ │ +0001a6e0: 6967 6874 270a 2020 2020 2054 6865 2068 ight'. The h │ │ │ │ │ +0001a6f0: 6569 6768 7420 6f66 206f 626a 6563 7420 eight of object │ │ │ │ │ +0001a700: 696e 2073 616d 6520 666f 726d 6174 2e0a in same format.. │ │ │ │ │ +0001a710: 2769 6427 0a20 2020 2020 5468 6520 6964 'id'. The id │ │ │ │ │ +0001a720: 656e 7469 6669 6572 2066 6f72 2074 6865 entifier for the │ │ │ │ │ +0001a730: 2063 6f6d 706f 6e65 6e74 2e20 2054 6869 component. Thi │ │ │ │ │ +0001a740: 7320 6361 6e20 6265 2061 6e79 2061 7262 s can be any arb │ │ │ │ │ +0001a750: 6974 7261 7279 0a20 2020 2020 7374 7269 itrary. stri │ │ │ │ │ +0001a760: 6e67 2e20 2054 6865 2049 4420 6361 6e20 ng. The ID can │ │ │ │ │ +0001a770: 6265 2075 7365 6420 6279 2073 6372 6970 be used by scrip │ │ │ │ │ +0001a780: 7473 2074 6f20 7265 6665 7220 746f 2076 ts to refer to v │ │ │ │ │ +0001a790: 6172 696f 7573 0a20 2020 2020 636f 6d70 arious. comp │ │ │ │ │ +0001a7a0: 6f6e 656e 7473 2069 6e20 7468 6520 4755 onents in the GU │ │ │ │ │ +0001a7b0: 4920 636f 6d70 6f6e 656e 7420 7472 6565 I component tree │ │ │ │ │ +0001a7c0: 2e20 2043 7572 7265 6e74 6c79 2c20 7468 . Currently, th │ │ │ │ │ +0001a7d0: 6572 6520 6973 206f 6e65 0a20 2020 2020 ere is one. │ │ │ │ │ +0001a7e0: 7370 6563 6961 6c20 4944 2076 616c 7565 special ID value │ │ │ │ │ +0001a7f0: 2074 6861 7420 4752 5542 2072 6563 6f67 that GRUB recog │ │ │ │ │ +0001a800: 6e69 7a65 733a 0a0a 2020 2020 2022 5f5f nizes:.. "__ │ │ │ │ │ +0001a810: 7469 6d65 6f75 745f 5f22 2020 436f 6d70 timeout__" Comp │ │ │ │ │ +0001a820: 6f6e 656e 7420 7769 7468 2074 6869 7320 onent with this │ │ │ │ │ +0001a830: 4944 2077 696c 6c20 6265 2075 7064 6174 ID will be updat │ │ │ │ │ +0001a840: 6564 2062 7920 4752 5542 0a20 2020 2020 ed by GRUB. │ │ │ │ │ +0001a850: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ +0001a860: 6e64 2077 696c 6c20 696e 6469 6361 7465 nd will indicate │ │ │ │ │ +0001a870: 2074 696d 6520 656c 6170 7365 6420 746f time elapsed to │ │ │ │ │ +0001a880: 2061 6e20 6175 746f 6d61 7469 6361 6c0a an automatical. │ │ │ │ │ 0001a890: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0001a8a0: 2020 626f 6f74 206f 6620 7468 6520 6465 boot of the de │ │ │ │ │ -0001a8b0: 6661 756c 7420 656e 7472 792e 2020 4166 fault entry. Af │ │ │ │ │ -0001a8c0: 6665 6374 6564 2063 6f6d 706f 6e65 6e74 fected component │ │ │ │ │ -0001a8d0: 733a 0a20 2020 2020 2020 2020 2020 2020 s:. │ │ │ │ │ -0001a8e0: 2020 2020 2020 2022 6c61 6265 6c22 2c20 "label", │ │ │ │ │ -0001a8f0: 2263 6972 6375 6c61 725f 7072 6f67 7265 "circular_progre │ │ │ │ │ -0001a900: 7373 222c 2022 7072 6f67 7265 7373 5f62 ss", "progress_b │ │ │ │ │ -0001a910: 6172 222e 0a0a 1f0a 4669 6c65 3a20 6772 ar".....File: gr │ │ │ │ │ -0001a920: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -0001a930: 4e65 7477 6f72 6b2c 2020 4e65 7874 3a20 Network, Next: │ │ │ │ │ -0001a940: 5365 7269 616c 2074 6572 6d69 6e61 6c2c Serial terminal, │ │ │ │ │ -0001a950: 2020 5072 6576 3a20 5468 656d 6520 6669 Prev: Theme fi │ │ │ │ │ -0001a960: 6c65 2066 6f72 6d61 742c 2020 5570 3a20 le format, Up: │ │ │ │ │ -0001a970: 546f 700a 0a38 2042 6f6f 7469 6e67 2047 Top..8 Booting G │ │ │ │ │ -0001a980: 5255 4220 6672 6f6d 2074 6865 206e 6574 RUB from the net │ │ │ │ │ -0001a990: 776f 726b 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a work.*********** │ │ │ │ │ +0001a8a0: 2020 2020 626f 6f74 206f 6620 7468 6520 boot of the │ │ │ │ │ +0001a8b0: 6465 6661 756c 7420 656e 7472 792e 2020 default entry. │ │ │ │ │ +0001a8c0: 4166 6665 6374 6564 2063 6f6d 706f 6e65 Affected compone │ │ │ │ │ +0001a8d0: 6e74 733a 0a20 2020 2020 2020 2020 2020 nts:. │ │ │ │ │ +0001a8e0: 2020 2020 2020 2020 2022 6c61 6265 6c22 "label" │ │ │ │ │ +0001a8f0: 2c20 2263 6972 6375 6c61 725f 7072 6f67 , "circular_prog │ │ │ │ │ +0001a900: 7265 7373 222c 2022 7072 6f67 7265 7373 ress", "progress │ │ │ │ │ +0001a910: 5f62 6172 222e 0a0a 1f0a 4669 6c65 3a20 _bar".....File: │ │ │ │ │ +0001a920: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +0001a930: 3a20 4e65 7477 6f72 6b2c 2020 4e65 7874 : Network, Next │ │ │ │ │ +0001a940: 3a20 5365 7269 616c 2074 6572 6d69 6e61 : Serial termina │ │ │ │ │ +0001a950: 6c2c 2020 5072 6576 3a20 5468 656d 6520 l, Prev: Theme │ │ │ │ │ +0001a960: 6669 6c65 2066 6f72 6d61 742c 2020 5570 file format, Up │ │ │ │ │ +0001a970: 3a20 546f 700a 0a38 2042 6f6f 7469 6e67 : Top..8 Booting │ │ │ │ │ +0001a980: 2047 5255 4220 6672 6f6d 2074 6865 206e GRUB from the n │ │ │ │ │ +0001a990: 6574 776f 726b 0a2a 2a2a 2a2a 2a2a 2a2a etwork.********* │ │ │ │ │ 0001a9a0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001a9b0: 2a2a 2a2a 0a0a 5468 6520 666f 6c6c 6f77 ****..The follow │ │ │ │ │ -0001a9c0: 696e 6720 696e 7374 7275 6374 696f 6e73 ing instructions │ │ │ │ │ -0001a9d0: 2064 6f6e 2774 2077 6f72 6b20 666f 7220 don't work for │ │ │ │ │ -0001a9e0: 2a2d 656d 752c 2069 3338 362d 7165 6d75 *-emu, i386-qemu │ │ │ │ │ -0001a9f0: 2c0a 6933 3836 2d63 6f72 6562 6f6f 742c ,.i386-coreboot, │ │ │ │ │ -0001aa00: 2069 3338 362d 6d75 6c74 6962 6f6f 742c i386-multiboot, │ │ │ │ │ -0001aa10: 206d 6970 735f 6c6f 6f6e 6773 6f6e 2c20 mips_loongson, │ │ │ │ │ -0001aa20: 6d69 7073 2d61 7263 2061 6e64 0a6d 6970 mips-arc and.mip │ │ │ │ │ -0001aa30: 735f 7165 6d75 5f6d 6970 730a 0a20 2020 s_qemu_mips.. │ │ │ │ │ -0001aa40: 546f 2067 656e 6572 6174 6520 6120 6e65 To generate a ne │ │ │ │ │ -0001aa50: 7462 6f6f 7461 626c 6520 6469 7265 6374 tbootable direct │ │ │ │ │ -0001aa60: 6f72 792c 2072 756e 3a0a 0a20 2020 2020 ory, run:.. │ │ │ │ │ -0001aa70: 6772 7562 2d6d 6b6e 6574 6469 7220 2d2d grub-mknetdir -- │ │ │ │ │ -0001aa80: 6e65 742d 6469 7265 6374 6f72 793d 2f73 net-directory=/s │ │ │ │ │ -0001aa90: 7276 2f74 6674 7020 2d2d 7375 6264 6972 rv/tftp --subdir │ │ │ │ │ -0001aaa0: 3d2f 626f 6f74 2f67 7275 6220 2d64 202f =/boot/grub -d / │ │ │ │ │ -0001aab0: 7573 722f 6c69 622f 6772 7562 2f3c 706c usr/lib/grub/.. E.g. │ │ │ │ │ -0001aad0: 2020 666f 7220 6933 3836 2d70 633a 0a0a for i386-pc:.. │ │ │ │ │ -0001aae0: 2020 2020 2067 7275 622d 6d6b 6e65 7464 grub-mknetd │ │ │ │ │ -0001aaf0: 6972 202d 2d6e 6574 2d64 6972 6563 746f ir --net-directo │ │ │ │ │ -0001ab00: 7279 3d2f 7372 762f 7466 7470 202d 2d73 ry=/srv/tftp --s │ │ │ │ │ -0001ab10: 7562 6469 723d 2f62 6f6f 742f 6772 7562 ubdir=/boot/grub │ │ │ │ │ -0001ab20: 202d 6420 2f75 7372 2f6c 6962 2f67 7275 -d /usr/lib/gru │ │ │ │ │ -0001ab30: 622f 6933 3836 2d70 630a 0a20 2020 5468 b/i386-pc.. Th │ │ │ │ │ -0001ab40: 656e 2066 6f6c 6c6f 7720 696e 7374 7275 en follow instru │ │ │ │ │ -0001ab50: 6374 696f 6e73 2070 7269 6e74 6564 206f ctions printed o │ │ │ │ │ -0001ab60: 7574 2062 7920 6772 7562 2d6d 6b6e 6574 ut by grub-mknet │ │ │ │ │ -0001ab70: 6469 7220 6f6e 2063 6f6e 6669 6775 7269 dir on configuri │ │ │ │ │ -0001ab80: 6e67 0a79 6f75 7220 4448 4350 2073 6572 ng.your DHCP ser │ │ │ │ │ -0001ab90: 7665 722e 0a0a 2020 2054 6865 2067 7275 ver... The gru │ │ │ │ │ -0001aba0: 622e 6366 6720 6669 6c65 2069 7320 706c b.cfg file is pl │ │ │ │ │ -0001abb0: 6163 6564 2069 6e20 7468 6520 7361 6d65 aced in the same │ │ │ │ │ -0001abc0: 2064 6972 6563 746f 7279 2061 7320 7468 directory as th │ │ │ │ │ -0001abd0: 6520 7061 7468 206f 7574 7075 740a 6279 e path output.by │ │ │ │ │ -0001abe0: 2067 7275 622d 6d6b 6e65 7464 6972 2068 grub-mknetdir h │ │ │ │ │ -0001abf0: 6572 6561 6674 6572 2072 6566 6572 7265 ereafter referre │ │ │ │ │ -0001ac00: 6420 746f 2061 7320 4657 5041 5448 2e20 d to as FWPATH. │ │ │ │ │ -0001ac10: 4752 5542 2077 696c 6c20 7365 6172 6368 GRUB will search │ │ │ │ │ -0001ac20: 2066 6f72 0a69 7473 2063 6f6e 6669 6775 for.its configu │ │ │ │ │ -0001ac30: 7261 7469 6f6e 2066 696c 6573 2069 6e20 ration files in │ │ │ │ │ -0001ac40: 6f72 6465 7220 7573 696e 6720 7468 6520 order using the │ │ │ │ │ -0001ac50: 666f 6c6c 6f77 696e 6720 7275 6c65 7320 following rules │ │ │ │ │ -0001ac60: 7768 6572 6520 7468 650a 6170 7065 6e64 where the.append │ │ │ │ │ -0001ac70: 6564 2076 616c 7565 2063 6f72 7265 7370 ed value corresp │ │ │ │ │ -0001ac80: 6f6e 6473 2074 6f20 6120 7661 6c75 6520 onds to a value │ │ │ │ │ -0001ac90: 6f6e 2074 6865 2063 6c69 656e 7420 6d61 on the client ma │ │ │ │ │ -0001aca0: 6368 696e 652e 0a0a 2020 2020 2027 2846 chine... '(F │ │ │ │ │ -0001acb0: 5750 4154 4829 272f 6772 7562 2e63 6667 WPATH)'/grub.cfg │ │ │ │ │ -0001acc0: 2d27 2855 5549 4420 4f46 204d 4143 4849 -'(UUID OF MACHI │ │ │ │ │ -0001acd0: 4e45 2927 0a20 2020 2020 2728 4657 5041 NE)'. '(FWPA │ │ │ │ │ -0001ace0: 5448 2927 2f67 7275 622e 6366 672d 2728 TH)'/grub.cfg-'( │ │ │ │ │ -0001acf0: 4d41 4320 4144 4452 4553 5320 4f46 204e MAC ADDRESS OF N │ │ │ │ │ -0001ad00: 4943 2927 0a20 2020 2020 2728 4657 5041 IC)'. '(FWPA │ │ │ │ │ -0001ad10: 5448 2927 2f67 7275 622e 6366 672d 2728 TH)'/grub.cfg-'( │ │ │ │ │ -0001ad20: 4950 7634 204f 5220 4950 7636 2041 4444 IPv4 OR IPv6 ADD │ │ │ │ │ -0001ad30: 5245 5353 2927 0a20 2020 2020 2728 4657 RESS)'. '(FW │ │ │ │ │ -0001ad40: 5041 5448 2927 2f67 7275 622e 6366 670a PATH)'/grub.cfg. │ │ │ │ │ -0001ad50: 0a20 2020 5468 6520 5555 4944 2069 7320 . The UUID is │ │ │ │ │ -0001ad60: 7468 6520 436c 6965 6e74 204d 6163 6869 the Client Machi │ │ │ │ │ -0001ad70: 6e65 2049 6465 6e74 6966 6965 7220 4f70 ne Identifier Op │ │ │ │ │ -0001ad80: 7469 6f6e 2044 6566 696e 6974 696f 6e20 tion Definition │ │ │ │ │ -0001ad90: 6173 0a73 7065 6369 6669 6564 2069 6e20 as.specified in │ │ │ │ │ -0001ada0: 5246 4320 3435 3738 2e20 2054 6865 2063 RFC 4578. The c │ │ │ │ │ -0001adb0: 6c69 656e 7420 7769 6c6c 206f 6e6c 7920 lient will only │ │ │ │ │ -0001adc0: 6174 7465 6d70 7420 746f 206c 6f6f 756b attempt to loouk │ │ │ │ │ -0001add0: 2075 7020 6120 5555 4944 0a63 6f6e 6669 up a UUID.confi │ │ │ │ │ -0001ade0: 6720 6669 6c65 2069 6620 6974 2077 6173 g file if it was │ │ │ │ │ -0001adf0: 2070 726f 7669 6465 6420 6279 2074 6865 provided by the │ │ │ │ │ -0001ae00: 2044 4843 5020 7365 7276 6572 2e0a 0a20 DHCP server... │ │ │ │ │ -0001ae10: 2020 5468 6520 636c 6965 6e74 2077 696c The client wil │ │ │ │ │ -0001ae20: 6c20 6f6e 6c79 2061 7474 656d 7074 2074 l only attempt t │ │ │ │ │ -0001ae30: 6f20 6c6f 6f6b 2075 7020 616e 2049 5076 o look up an IPv │ │ │ │ │ -0001ae40: 3620 6164 6472 6573 7320 636f 6e66 6967 6 address config │ │ │ │ │ -0001ae50: 206f 6e63 652c 0a68 6f77 6576 6572 2c20 once,.however, │ │ │ │ │ -0001ae60: 6974 2077 696c 6c20 7472 7920 7468 6520 it will try the │ │ │ │ │ -0001ae70: 4950 7634 206d 756c 7469 706c 6520 7469 IPv4 multiple ti │ │ │ │ │ -0001ae80: 6d65 732e 2020 5468 6520 636f 6e63 7265 mes. The concre │ │ │ │ │ -0001ae90: 7465 2065 7861 6d70 6c65 0a62 656c 6f77 te example.below │ │ │ │ │ -0001aea0: 2073 686f 7773 2077 6861 7420 776f 756c shows what woul │ │ │ │ │ -0001aeb0: 6420 6861 7070 656e 2075 6e64 6572 2074 d happen under t │ │ │ │ │ -0001aec0: 6865 2049 5076 3420 6361 7365 2e0a 0a20 he IPv4 case... │ │ │ │ │ -0001aed0: 2020 2020 5555 4944 3a20 3737 3236 6136 UUID: 7726a6 │ │ │ │ │ -0001aee0: 3738 2d37 6663 302d 3438 3533 2d61 3466 78-7fc0-4853-a4f │ │ │ │ │ -0001aef0: 362d 6338 3561 6333 3661 3132 3061 0a20 6-c85ac36a120a. │ │ │ │ │ -0001af00: 2020 2020 4d41 433a 2020 3532 3a35 343a MAC: 52:54: │ │ │ │ │ -0001af10: 3030 3a65 633a 3333 3a38 310a 2020 2020 00:ec:33:81. │ │ │ │ │ -0001af20: 2049 5056 343a 2031 302e 302e 302e 3133 IPV4: 10.0.0.13 │ │ │ │ │ -0001af30: 3020 2830 4130 3030 3038 3229 0a0a 2020 0 (0A000082).. │ │ │ │ │ -0001af40: 2020 2027 2846 5750 4154 4829 272f 6772 '(FWPATH)'/gr │ │ │ │ │ -0001af50: 7562 2e63 6667 2d37 3732 3661 3637 382d ub.cfg-7726a678- │ │ │ │ │ -0001af60: 3766 6330 2d34 3835 332d 6134 6636 2d63 7fc0-4853-a4f6-c │ │ │ │ │ -0001af70: 3835 6163 3336 6131 3230 610a 2020 2020 85ac36a120a. │ │ │ │ │ -0001af80: 2027 2846 5750 4154 4829 272f 6772 7562 '(FWPATH)'/grub │ │ │ │ │ -0001af90: 2e63 6667 2d35 322d 3534 2d30 302d 6563 .cfg-52-54-00-ec │ │ │ │ │ -0001afa0: 2d33 332d 3831 0a20 2020 2020 2728 4657 -33-81. '(FW │ │ │ │ │ -0001afb0: 5041 5448 2927 2f67 7275 622e 6366 672d PATH)'/grub.cfg- │ │ │ │ │ -0001afc0: 3041 3030 3030 3832 0a20 2020 2020 2728 0A000082. '( │ │ │ │ │ -0001afd0: 4657 5041 5448 2927 2f67 7275 622e 6366 FWPATH)'/grub.cf │ │ │ │ │ -0001afe0: 672d 3041 3030 3030 380a 2020 2020 2027 g-0A00008. ' │ │ │ │ │ -0001aff0: 2846 5750 4154 4829 272f 6772 7562 2e63 (FWPATH)'/grub.c │ │ │ │ │ -0001b000: 6667 2d30 4130 3030 300a 2020 2020 2027 fg-0A0000. ' │ │ │ │ │ -0001b010: 2846 5750 4154 4829 272f 6772 7562 2e63 (FWPATH)'/grub.c │ │ │ │ │ -0001b020: 6667 2d30 4130 3030 0a20 2020 2020 2728 fg-0A000. '( │ │ │ │ │ -0001b030: 4657 5041 5448 2927 2f67 7275 622e 6366 FWPATH)'/grub.cf │ │ │ │ │ -0001b040: 672d 3041 3030 0a20 2020 2020 2728 4657 g-0A00. '(FW │ │ │ │ │ -0001b050: 5041 5448 2927 2f67 7275 622e 6366 672d PATH)'/grub.cfg- │ │ │ │ │ -0001b060: 3041 300a 2020 2020 2027 2846 5750 4154 0A0. '(FWPAT │ │ │ │ │ -0001b070: 4829 272f 6772 7562 2e63 6667 2d30 410a H)'/grub.cfg-0A. │ │ │ │ │ -0001b080: 2020 2020 2027 2846 5750 4154 4829 272f '(FWPATH)'/ │ │ │ │ │ -0001b090: 6772 7562 2e63 6667 2d30 0a20 2020 2020 grub.cfg-0. │ │ │ │ │ -0001b0a0: 2728 4657 5041 5448 2927 2f67 7275 622e '(FWPATH)'/grub. │ │ │ │ │ -0001b0b0: 6366 670a 0a20 2020 5468 6973 2066 6561 cfg.. This fea │ │ │ │ │ -0001b0c0: 7475 7265 2069 7320 656e 6162 6c65 6420 ture is enabled │ │ │ │ │ -0001b0d0: 6279 2064 6566 6175 6c74 2062 7574 2069 by default but i │ │ │ │ │ -0001b0e0: 7420 6361 6e20 6265 2064 6973 6162 6c65 t can be disable │ │ │ │ │ -0001b0f0: 6420 6279 2073 6574 7469 6e67 0a74 6865 d by setting.the │ │ │ │ │ -0001b100: 2027 6665 6174 7572 655f 6e65 745f 7365 'feature_net_se │ │ │ │ │ -0001b110: 6172 6368 5f63 6667 2720 746f 2027 6e27 arch_cfg' to 'n' │ │ │ │ │ -0001b120: 2e20 2053 696e 6365 2074 6869 7320 6861 . Since this ha │ │ │ │ │ -0001b130: 7070 656e 7320 6265 666f 7265 2074 6865 ppens before the │ │ │ │ │ -0001b140: 0a63 6f6e 6669 6775 7261 7469 6f6e 2066 .configuration f │ │ │ │ │ -0001b150: 696c 6520 6973 2072 6561 6420 6279 2047 ile is read by G │ │ │ │ │ -0001b160: 5255 422c 2074 6869 7320 6f70 7469 6f6e RUB, this option │ │ │ │ │ -0001b170: 2068 6173 2074 6f20 6265 2064 6973 6162 has to be disab │ │ │ │ │ -0001b180: 6c65 6420 696e 2061 6e0a 656d 6265 6464 led in an.embedd │ │ │ │ │ -0001b190: 6564 2063 6f6e 6669 6775 7261 7469 6f6e ed configuration │ │ │ │ │ -0001b1a0: 2066 696c 6520 282a 6e6f 7465 2045 6d62 file (*note Emb │ │ │ │ │ -0001b1b0: 6564 6465 6420 636f 6e66 6967 7572 6174 edded configurat │ │ │ │ │ -0001b1c0: 696f 6e3a 3a29 2e0a 0a20 2020 4166 7465 ion::)... Afte │ │ │ │ │ -0001b1d0: 7220 4752 5542 2068 6173 2073 7461 7274 r GRUB has start │ │ │ │ │ -0001b1e0: 6564 2c20 6669 6c65 7320 6f6e 2074 6865 ed, files on the │ │ │ │ │ -0001b1f0: 2054 4654 5020 7365 7276 6572 2077 696c TFTP server wil │ │ │ │ │ -0001b200: 6c20 6265 2061 6363 6573 7369 626c 650a l be accessible. │ │ │ │ │ -0001b210: 7669 6120 7468 6520 2728 7466 7470 2927 via the '(tftp)' │ │ │ │ │ -0001b220: 2064 6576 6963 652e 0a0a 2020 2054 6865 device... The │ │ │ │ │ -0001b230: 2073 6572 7665 7220 4950 2061 6464 7265 server IP addre │ │ │ │ │ -0001b240: 7373 2063 616e 2062 6520 636f 6e74 726f ss can be contro │ │ │ │ │ -0001b250: 6c6c 6564 2062 7920 6368 616e 6769 6e67 lled by changing │ │ │ │ │ -0001b260: 2074 6865 2027 2874 6674 7029 270a 6465 the '(tftp)'.de │ │ │ │ │ -0001b270: 7669 6365 206e 616d 6520 746f 2027 2874 vice name to '(t │ │ │ │ │ -0001b280: 6674 702c 5345 5256 4552 2d49 5029 272e ftp,SERVER-IP)'. │ │ │ │ │ -0001b290: 2020 4e6f 7465 2074 6861 7420 7468 6973 Note that this │ │ │ │ │ -0001b2a0: 2073 686f 756c 6420 6265 2063 6861 6e67 should be chang │ │ │ │ │ -0001b2b0: 6564 0a62 6f74 6820 696e 2074 6865 2070 ed.both in the p │ │ │ │ │ -0001b2c0: 7265 6669 7820 616e 6420 696e 2061 6e79 refix and in any │ │ │ │ │ -0001b2d0: 2072 6566 6572 656e 6365 7320 746f 2074 references to t │ │ │ │ │ -0001b2e0: 6865 2064 6576 6963 6520 6e61 6d65 2069 he device name i │ │ │ │ │ -0001b2f0: 6e20 7468 650a 636f 6e66 6967 7572 6174 n the.configurat │ │ │ │ │ -0001b300: 696f 6e20 6669 6c65 2e0a 0a20 2020 4752 ion file... GR │ │ │ │ │ -0001b310: 5542 2070 726f 7669 6465 7320 7365 7665 UB provides seve │ │ │ │ │ -0001b320: 7261 6c20 656e 7669 726f 6e6d 656e 7420 ral environment │ │ │ │ │ -0001b330: 7661 7269 6162 6c65 7320 7768 6963 6820 variables which │ │ │ │ │ -0001b340: 6d61 7920 6265 2075 7365 6420 746f 0a69 may be used to.i │ │ │ │ │ -0001b350: 6e73 7065 6374 206f 7220 6368 616e 6765 nspect or change │ │ │ │ │ -0001b360: 2074 6865 2062 6568 6176 696f 7572 206f the behaviour o │ │ │ │ │ -0001b370: 6620 7468 6520 5058 4520 6465 7669 6365 f the PXE device │ │ │ │ │ -0001b380: 2e20 2049 6e20 7468 6520 666f 6c6c 6f77 . In the follow │ │ │ │ │ -0001b390: 696e 670a 6465 7363 7269 7074 696f 6e20 ing.description │ │ │ │ │ -0001b3a0: 3c49 4e54 4552 4641 4345 3e20 6973 2070 is p │ │ │ │ │ -0001b3b0: 6c61 6365 686f 6c64 6572 2066 6f72 2074 laceholder for t │ │ │ │ │ -0001b3c0: 6865 206e 616d 6520 6f66 206e 6574 776f he name of netwo │ │ │ │ │ -0001b3d0: 726b 2069 6e74 6572 6661 6365 0a28 706c rk interface.(pl │ │ │ │ │ -0001b3e0: 6174 666f 726d 2064 6570 656e 6465 6e74 atform dependent │ │ │ │ │ -0001b3f0: 293a 0a0a 276e 6574 5f3c 494e 5445 5246 ):..'net__ip'. Th │ │ │ │ │ -0001b410: 6520 6e65 7477 6f72 6b20 696e 7465 7266 e network interf │ │ │ │ │ -0001b420: 6163 6527 7320 4950 2061 6464 7265 7373 ace's IP address │ │ │ │ │ -0001b430: 2e20 2052 6561 642d 6f6e 6c79 2e0a 0a27 . Read-only...' │ │ │ │ │ -0001b440: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -0001b450: 6d61 6327 0a20 2020 2020 5468 6520 6e65 mac'. The ne │ │ │ │ │ -0001b460: 7477 6f72 6b20 696e 7465 7266 6163 6527 twork interface' │ │ │ │ │ -0001b470: 7320 4d41 4320 6164 6472 6573 732e 2020 s MAC address. │ │ │ │ │ -0001b480: 5265 6164 2d6f 6e6c 792e 0a0a 276e 6574 Read-only...'net │ │ │ │ │ -0001b490: 5f3c 494e 5445 5246 4143 453e 5f68 6f73 __hos │ │ │ │ │ -0001b4a0: 746e 616d 6527 0a20 2020 2020 5468 6520 tname'. The │ │ │ │ │ -0001b4b0: 636c 6965 6e74 2068 6f73 7420 6e61 6d65 client host name │ │ │ │ │ -0001b4c0: 2070 726f 7669 6465 6420 6279 2044 4843 provided by DHC │ │ │ │ │ -0001b4d0: 502e 2052 6561 642d 6f6e 6c79 2e0a 0a27 P. Read-only...' │ │ │ │ │ -0001b4e0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -0001b4f0: 646f 6d61 696e 270a 2020 2020 2054 6865 domain'. The │ │ │ │ │ -0001b500: 2063 6c69 656e 7420 646f 6d61 696e 206e client domain n │ │ │ │ │ -0001b510: 616d 6520 7072 6f76 6964 6564 2062 7920 ame provided by │ │ │ │ │ -0001b520: 4448 4350 2e20 5265 6164 2d6f 6e6c 792e DHCP. Read-only. │ │ │ │ │ -0001b530: 0a0a 276e 6574 5f3c 494e 5445 5246 4143 ..'net__rootpath'. │ │ │ │ │ -0001b550: 2020 5468 6520 7061 7468 2074 6f20 7468 The path to th │ │ │ │ │ -0001b560: 6520 636c 6965 6e74 2773 2072 6f6f 7420 e client's root │ │ │ │ │ -0001b570: 6469 736b 2070 726f 7669 6465 6420 6279 disk provided by │ │ │ │ │ -0001b580: 2044 4843 502e 2052 6561 642d 6f6e 6c79 DHCP. Read-only │ │ │ │ │ -0001b590: 2e0a 0a27 6e65 745f 3c49 4e54 4552 4641 ...'net__extensionspa │ │ │ │ │ -0001b5b0: 7468 270a 2020 2020 2054 6865 2070 6174 th'. The pat │ │ │ │ │ -0001b5c0: 6820 746f 2061 6464 6974 696f 6e61 6c20 h to additional │ │ │ │ │ -0001b5d0: 4448 4350 2076 656e 646f 7220 6578 7465 DHCP vendor exte │ │ │ │ │ -0001b5e0: 6e73 696f 6e73 2070 726f 7669 6465 6420 nsions provided │ │ │ │ │ -0001b5f0: 6279 2044 4843 502e 0a20 2020 2020 5265 by DHCP.. Re │ │ │ │ │ -0001b600: 6164 2d6f 6e6c 792e 0a0a 276e 6574 5f3c ad-only...'net_< │ │ │ │ │ -0001b610: 494e 5445 5246 4143 453e 5f62 6f6f 745f INTERFACE>_boot_ │ │ │ │ │ -0001b620: 6669 6c65 270a 2020 2020 2054 6865 2062 file'. The b │ │ │ │ │ -0001b630: 6f6f 7420 6669 6c65 206e 616d 6520 7072 oot file name pr │ │ │ │ │ -0001b640: 6f76 6964 6564 2062 7920 4448 4350 2e20 ovided by DHCP. │ │ │ │ │ -0001b650: 5265 6164 2d6f 6e6c 792e 0a0a 276e 6574 Read-only...'net │ │ │ │ │ -0001b660: 5f3c 494e 5445 5246 4143 453e 5f64 6863 __dhc │ │ │ │ │ -0001b670: 705f 7365 7276 6572 5f6e 616d 6527 0a20 p_server_name'. │ │ │ │ │ -0001b680: 2020 2020 5468 6520 6e61 6d65 206f 6620 The name of │ │ │ │ │ -0001b690: 7468 6520 4448 4350 2073 6572 7665 7220 the DHCP server │ │ │ │ │ -0001b6a0: 7265 7370 6f6e 7369 626c 6520 666f 7220 responsible for │ │ │ │ │ -0001b6b0: 7468 6573 6520 626f 6f74 2070 6172 616d these boot param │ │ │ │ │ -0001b6c0: 6574 6572 732e 0a20 2020 2020 5265 6164 eters.. Read │ │ │ │ │ -0001b6d0: 2d6f 6e6c 792e 0a0a 276e 6574 5f3c 494e -only...'net__next_se │ │ │ │ │ -0001b6f0: 7276 6572 270a 2020 2020 2054 6865 2049 rver'. The I │ │ │ │ │ -0001b700: 5020 6164 6472 6573 7320 6f66 2074 6865 P address of the │ │ │ │ │ -0001b710: 206e 6578 7420 2875 7375 616c 6c79 2c20 next (usually, │ │ │ │ │ -0001b720: 5446 5450 2920 7365 7276 6572 2070 726f TFTP) server pro │ │ │ │ │ -0001b730: 7669 6465 6420 6279 2044 4843 502e 0a20 vided by DHCP.. │ │ │ │ │ -0001b740: 2020 2020 5265 6164 2d6f 6e6c 792e 0a0a Read-only... │ │ │ │ │ -0001b750: 276e 6574 5f64 6566 6175 6c74 5f69 6e74 'net_default_int │ │ │ │ │ -0001b760: 6572 6661 6365 270a 2020 2020 2049 6e69 erface'. Ini │ │ │ │ │ -0001b770: 7469 616c 6c79 2073 6574 2074 6f20 6e61 tially set to na │ │ │ │ │ -0001b780: 6d65 206f 6620 6e65 7477 6f72 6b20 696e me of network in │ │ │ │ │ -0001b790: 7465 7266 6163 6520 7468 6174 2077 6173 terface that was │ │ │ │ │ -0001b7a0: 2075 7365 6420 746f 206c 6f61 640a 2020 used to load. │ │ │ │ │ -0001b7b0: 2020 2067 7275 622e 2020 5265 6164 2d77 grub. Read-w │ │ │ │ │ -0001b7c0: 7269 7465 2c20 616c 7468 6f75 6768 2073 rite, although s │ │ │ │ │ -0001b7d0: 6574 7469 6e67 2069 7420 6166 6665 6374 etting it affect │ │ │ │ │ -0001b7e0: 7320 6f6e 6c79 2069 6e74 6572 7072 6574 s only interpret │ │ │ │ │ -0001b7f0: 6174 696f 6e0a 2020 2020 206f 6620 276e ation. of 'n │ │ │ │ │ -0001b800: 6574 5f64 6566 6175 6c74 5f69 7027 2061 et_default_ip' a │ │ │ │ │ -0001b810: 6e64 2027 6e65 745f 6465 6661 756c 745f nd 'net_default_ │ │ │ │ │ -0001b820: 6d61 6327 0a0a 276e 6574 5f64 6566 6175 mac'..'net_defau │ │ │ │ │ -0001b830: 6c74 5f69 7027 0a20 2020 2020 5468 6520 lt_ip'. The │ │ │ │ │ -0001b840: 4950 2061 6464 7265 7373 206f 6620 6465 IP address of de │ │ │ │ │ -0001b850: 6661 756c 7420 696e 7465 7266 6163 652e fault interface. │ │ │ │ │ -0001b860: 2020 5265 6164 2d6f 6e6c 792e 2020 5468 Read-only. Th │ │ │ │ │ -0001b870: 6973 2069 7320 616c 6961 7320 666f 720a is is alias for. │ │ │ │ │ -0001b880: 2020 2020 2074 6865 2027 6e65 745f 247b the 'net_${ │ │ │ │ │ -0001b890: 6e65 745f 6465 6661 756c 745f 696e 7465 net_default_inte │ │ │ │ │ -0001b8a0: 7266 6163 657d 5f69 7027 2e0a 0a27 6e65 rface}_ip'...'ne │ │ │ │ │ -0001b8b0: 745f 6465 6661 756c 745f 6d61 6327 0a20 t_default_mac'. │ │ │ │ │ -0001b8c0: 2020 2020 5468 6520 6465 6661 756c 7420 The default │ │ │ │ │ -0001b8d0: 696e 7465 7266 6163 6527 7320 4d41 4320 interface's MAC │ │ │ │ │ -0001b8e0: 6164 6472 6573 732e 2020 5265 6164 2d6f address. Read-o │ │ │ │ │ -0001b8f0: 6e6c 792e 2020 5468 6973 2069 7320 616c nly. This is al │ │ │ │ │ -0001b900: 6961 7320 666f 720a 2020 2020 2074 6865 ias for. the │ │ │ │ │ -0001b910: 2027 6e65 745f 247b 6e65 745f 6465 6661 'net_${net_defa │ │ │ │ │ -0001b920: 756c 745f 696e 7465 7266 6163 657d 5f6d ult_interface}_m │ │ │ │ │ -0001b930: 6163 272e 0a0a 276e 6574 5f64 6566 6175 ac'...'net_defau │ │ │ │ │ -0001b940: 6c74 5f73 6572 7665 7227 0a20 2020 2020 lt_server'. │ │ │ │ │ -0001b950: 5468 6520 6465 6661 756c 7420 7365 7276 The default serv │ │ │ │ │ -0001b960: 6572 2075 7365 6420 6279 206e 6574 776f er used by netwo │ │ │ │ │ -0001b970: 726b 2064 7269 7665 7320 282a 6e6f 7465 rk drives (*note │ │ │ │ │ -0001b980: 2044 6576 6963 6520 7379 6e74 6178 3a3a Device syntax:: │ │ │ │ │ -0001b990: 292e 0a20 2020 2020 5265 6164 2d77 7269 ).. Read-wri │ │ │ │ │ -0001b9a0: 7465 2c20 616c 7468 6f75 6768 2073 6574 te, although set │ │ │ │ │ -0001b9b0: 7469 6e67 2074 6869 7320 6973 206f 6e6c ting this is onl │ │ │ │ │ -0001b9c0: 7920 7573 6566 756c 2062 6566 6f72 6520 y useful before │ │ │ │ │ -0001b9d0: 6f70 656e 696e 6720 610a 2020 2020 206e opening a. n │ │ │ │ │ -0001b9e0: 6574 776f 726b 2064 6576 6963 652e 0a0a etwork device... │ │ │ │ │ -0001b9f0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -0001ba00: 6f2c 2020 4e6f 6465 3a20 5365 7269 616c o, Node: Serial │ │ │ │ │ -0001ba10: 2074 6572 6d69 6e61 6c2c 2020 4e65 7874 terminal, Next │ │ │ │ │ -0001ba20: 3a20 5665 6e64 6f72 2070 6f77 6572 2d6f : Vendor power-o │ │ │ │ │ -0001ba30: 6e20 6b65 7973 2c20 2050 7265 763a 204e n keys, Prev: N │ │ │ │ │ -0001ba40: 6574 776f 726b 2c20 2055 703a 2054 6f70 etwork, Up: Top │ │ │ │ │ -0001ba50: 0a0a 3920 5573 696e 6720 4752 5542 2076 ..9 Using GRUB v │ │ │ │ │ -0001ba60: 6961 2061 2073 6572 6961 6c20 6c69 6e65 ia a serial line │ │ │ │ │ -0001ba70: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ -0001ba80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ -0001ba90: 0a54 6869 7320 6368 6170 7465 7220 6465 .This chapter de │ │ │ │ │ -0001baa0: 7363 7269 6265 7320 686f 7720 746f 2075 scribes how to u │ │ │ │ │ -0001bab0: 7365 2074 6865 2073 6572 6961 6c20 7465 se the serial te │ │ │ │ │ -0001bac0: 726d 696e 616c 2073 7570 706f 7274 2069 rminal support i │ │ │ │ │ -0001bad0: 6e20 4752 5542 2e0a 0a20 2020 4966 2079 n GRUB... If y │ │ │ │ │ -0001bae0: 6f75 2068 6176 6520 6d61 6e79 2063 6f6d ou have many com │ │ │ │ │ -0001baf0: 7075 7465 7273 206f 7220 636f 6d70 7574 puters or comput │ │ │ │ │ -0001bb00: 6572 7320 7769 7468 206e 6f20 6469 7370 ers with no disp │ │ │ │ │ -0001bb10: 6c61 792f 6b65 7962 6f61 7264 2c20 6974 lay/keyboard, it │ │ │ │ │ -0001bb20: 0a63 6f75 6c64 2062 6520 7665 7279 2075 .could be very u │ │ │ │ │ -0001bb30: 7365 6675 6c20 746f 2063 6f6e 7472 6f6c seful to control │ │ │ │ │ -0001bb40: 2074 6865 2063 6f6d 7075 7465 7273 2074 the computers t │ │ │ │ │ -0001bb50: 6872 6f75 6768 2073 6572 6961 6c0a 636f hrough serial.co │ │ │ │ │ -0001bb60: 6d6d 756e 6963 6174 696f 6e73 2e20 2054 mmunications. T │ │ │ │ │ -0001bb70: 6f20 636f 6e6e 6563 7420 6f6e 6520 636f o connect one co │ │ │ │ │ -0001bb80: 6d70 7574 6572 2077 6974 6820 616e 6f74 mputer with anot │ │ │ │ │ -0001bb90: 6865 7220 7669 6120 6120 7365 7269 616c her via a serial │ │ │ │ │ -0001bba0: 206c 696e 652c 0a79 6f75 206e 6565 6420 line,.you need │ │ │ │ │ -0001bbb0: 746f 2070 7265 7061 7265 2061 206e 756c to prepare a nul │ │ │ │ │ -0001bbc0: 6c2d 6d6f 6465 6d20 2863 726f 7373 2920 l-modem (cross) │ │ │ │ │ -0001bbd0: 7365 7269 616c 2063 6162 6c65 2c20 616e serial cable, an │ │ │ │ │ -0001bbe0: 6420 796f 7520 6d61 7920 6e65 6564 0a74 d you may need.t │ │ │ │ │ -0001bbf0: 6f20 6861 7665 206d 756c 7469 706f 7274 o have multiport │ │ │ │ │ -0001bc00: 2073 6572 6961 6c20 626f 6172 6473 2c20 serial boards, │ │ │ │ │ -0001bc10: 6966 2079 6f75 7220 636f 6d70 7574 6572 if your computer │ │ │ │ │ -0001bc20: 2064 6f65 736e 2774 2068 6176 6520 6578 doesn't have ex │ │ │ │ │ -0001bc30: 7472 610a 7365 7269 616c 2070 6f72 7473 tra.serial ports │ │ │ │ │ -0001bc40: 2e20 2049 6e20 6164 6469 7469 6f6e 2c20 . In addition, │ │ │ │ │ -0001bc50: 6120 7465 726d 696e 616c 2065 6d75 6c61 a terminal emula │ │ │ │ │ -0001bc60: 746f 7220 6973 2061 6c73 6f20 7265 7175 tor is also requ │ │ │ │ │ -0001bc70: 6972 6564 2c20 7375 6368 0a61 7320 6d69 ired, such.as mi │ │ │ │ │ -0001bc80: 6e69 636f 6d2e 2020 5265 6665 7220 746f nicom. Refer to │ │ │ │ │ -0001bc90: 2061 206d 616e 7561 6c20 6f66 2079 6f75 a manual of you │ │ │ │ │ -0001bca0: 7220 6f70 6572 6174 696e 6720 7379 7374 r operating syst │ │ │ │ │ -0001bcb0: 656d 2c20 666f 7220 6d6f 7265 0a69 6e66 em, for more.inf │ │ │ │ │ -0001bcc0: 6f72 6d61 7469 6f6e 2e0a 0a20 2020 4173 ormation... As │ │ │ │ │ -0001bcd0: 2066 6f72 2047 5255 422c 2074 6865 2069 for GRUB, the i │ │ │ │ │ -0001bce0: 6e73 7472 7563 7469 6f6e 2074 6f20 7365 nstruction to se │ │ │ │ │ -0001bcf0: 7420 7570 2061 2073 6572 6961 6c20 7465 t up a serial te │ │ │ │ │ -0001bd00: 726d 696e 616c 2069 7320 7175 6974 650a rminal is quite. │ │ │ │ │ -0001bd10: 7369 6d70 6c65 2e20 2048 6572 6520 6973 simple. Here is │ │ │ │ │ -0001bd20: 2061 6e20 6578 616d 706c 653a 0a0a 2020 an example:.. │ │ │ │ │ -0001bd30: 2020 2067 7275 623e 2073 6572 6961 6c20 grub> serial │ │ │ │ │ -0001bd40: 2d2d 756e 6974 3d30 202d 2d73 7065 6564 --unit=0 --speed │ │ │ │ │ -0001bd50: 3d39 3630 300a 2020 2020 2067 7275 623e =9600. grub> │ │ │ │ │ -0001bd60: 2074 6572 6d69 6e61 6c5f 696e 7075 7420 terminal_input │ │ │ │ │ -0001bd70: 7365 7269 616c 3b20 7465 726d 696e 616c serial; terminal │ │ │ │ │ -0001bd80: 5f6f 7574 7075 7420 7365 7269 616c 0a0a _output serial.. │ │ │ │ │ -0001bd90: 2020 2054 6865 2063 6f6d 6d61 6e64 2027 The command ' │ │ │ │ │ -0001bda0: 7365 7269 616c 2720 696e 6974 6961 6c69 serial' initiali │ │ │ │ │ -0001bdb0: 7a65 7320 7468 6520 7365 7269 616c 2075 zes the serial u │ │ │ │ │ -0001bdc0: 6e69 7420 3020 7769 7468 2074 6865 2073 nit 0 with the s │ │ │ │ │ -0001bdd0: 7065 6564 0a39 3630 3062 7073 2e20 2054 peed.9600bps. T │ │ │ │ │ -0001bde0: 6865 2073 6572 6961 6c20 756e 6974 2030 he serial unit 0 │ │ │ │ │ -0001bdf0: 2069 7320 7573 7561 6c6c 7920 6361 6c6c is usually call │ │ │ │ │ -0001be00: 6564 2027 434f 4d31 272c 2073 6f2c 2069 ed 'COM1', so, i │ │ │ │ │ -0001be10: 6620 796f 7520 7761 6e74 2074 6f0a 7573 f you want to.us │ │ │ │ │ -0001be20: 6520 434f 4d32 2c20 796f 7520 6d75 7374 e COM2, you must │ │ │ │ │ -0001be30: 2073 7065 6369 6679 2027 2d2d 756e 6974 specify '--unit │ │ │ │ │ -0001be40: 3d31 2720 696e 7374 6561 642e 2020 5468 =1' instead. Th │ │ │ │ │ -0001be50: 6973 2063 6f6d 6d61 6e64 2061 6363 6570 is command accep │ │ │ │ │ -0001be60: 7473 0a6d 616e 7920 6f74 6865 7220 6f70 ts.many other op │ │ │ │ │ -0001be70: 7469 6f6e 732c 2073 6f20 706c 6561 7365 tions, so please │ │ │ │ │ -0001be80: 2072 6566 6572 2074 6f20 2a6e 6f74 6520 refer to *note │ │ │ │ │ -0001be90: 7365 7269 616c 3a3a 2c20 666f 7220 6d6f serial::, for mo │ │ │ │ │ -0001bea0: 7265 2064 6574 6169 6c73 2e0a 0a20 2020 re details... │ │ │ │ │ -0001beb0: 5468 6520 636f 6d6d 616e 6473 2027 7465 The commands 'te │ │ │ │ │ -0001bec0: 726d 696e 616c 5f69 6e70 7574 2720 282a rminal_input' (* │ │ │ │ │ -0001bed0: 6e6f 7465 2074 6572 6d69 6e61 6c5f 696e note terminal_in │ │ │ │ │ -0001bee0: 7075 743a 3a29 2061 6e64 0a27 7465 726d put::) and.'term │ │ │ │ │ -0001bef0: 696e 616c 5f6f 7574 7075 7427 2028 2a6e inal_output' (*n │ │ │ │ │ -0001bf00: 6f74 6520 7465 726d 696e 616c 5f6f 7574 ote terminal_out │ │ │ │ │ -0001bf10: 7075 743a 3a29 2063 686f 6f73 6520 7768 put::) choose wh │ │ │ │ │ -0001bf20: 6963 6820 7479 7065 206f 660a 7465 726d ich type of.term │ │ │ │ │ -0001bf30: 696e 616c 2079 6f75 2077 616e 7420 746f inal you want to │ │ │ │ │ -0001bf40: 2075 7365 2e20 2049 6e20 7468 6520 6361 use. In the ca │ │ │ │ │ -0001bf50: 7365 2061 626f 7665 2c20 7468 6520 7465 se above, the te │ │ │ │ │ -0001bf60: 726d 696e 616c 2077 696c 6c20 6265 2061 rminal will be a │ │ │ │ │ -0001bf70: 0a73 6572 6961 6c20 7465 726d 696e 616c .serial terminal │ │ │ │ │ -0001bf80: 2c20 6275 7420 796f 7520 6361 6e20 616c , but you can al │ │ │ │ │ -0001bf90: 736f 2070 6173 7320 2763 6f6e 736f 6c65 so pass 'console │ │ │ │ │ -0001bfa0: 2720 746f 2074 6865 2063 6f6d 6d61 6e64 ' to the command │ │ │ │ │ -0001bfb0: 2c20 6173 0a27 7465 726d 696e 616c 5f69 , as.'terminal_i │ │ │ │ │ -0001bfc0: 6e70 7574 2073 6572 6961 6c20 636f 6e73 nput serial cons │ │ │ │ │ -0001bfd0: 6f6c 6527 2e20 2049 6e20 7468 6973 2063 ole'. In this c │ │ │ │ │ -0001bfe0: 6173 652c 2061 2074 6572 6d69 6e61 6c20 ase, a terminal │ │ │ │ │ -0001bff0: 696e 2077 6869 6368 2079 6f75 0a70 7265 in which you.pre │ │ │ │ │ -0001c000: 7373 2061 6e79 206b 6579 2077 696c 6c20 ss any key will │ │ │ │ │ -0001c010: 6265 2073 656c 6563 7465 6420 6173 2061 be selected as a │ │ │ │ │ -0001c020: 2047 5255 4220 7465 726d 696e 616c 2e20 GRUB terminal. │ │ │ │ │ -0001c030: 2049 6e20 7468 6520 6578 616d 706c 650a In the example. │ │ │ │ │ -0001c040: 6162 6f76 652c 206e 6f74 6520 7468 6174 above, note that │ │ │ │ │ -0001c050: 2079 6f75 206e 6565 6420 746f 2070 7574 you need to put │ │ │ │ │ -0001c060: 2062 6f74 6820 636f 6d6d 616e 6473 206f both commands o │ │ │ │ │ -0001c070: 6e20 7468 6520 7361 6d65 2063 6f6d 6d61 n the same comma │ │ │ │ │ -0001c080: 6e64 206c 696e 652c 0a61 7320 796f 7520 nd line,.as you │ │ │ │ │ -0001c090: 7769 6c6c 206c 6f73 6520 7468 6520 6162 will lose the ab │ │ │ │ │ -0001c0a0: 696c 6974 7920 746f 2074 7970 6520 636f ility to type co │ │ │ │ │ -0001c0b0: 6d6d 616e 6473 206f 6e20 7468 6520 636f mmands on the co │ │ │ │ │ -0001c0c0: 6e73 6f6c 6520 6166 7465 7220 7468 650a nsole after the. │ │ │ │ │ -0001c0d0: 6669 7273 7420 636f 6d6d 616e 642e 0a0a first command... │ │ │ │ │ -0001c0e0: 2020 2048 6f77 6576 6572 2c20 6e6f 7465 However, note │ │ │ │ │ -0001c0f0: 2074 6861 7420 4752 5542 2061 7373 756d that GRUB assum │ │ │ │ │ -0001c100: 6573 2074 6861 7420 796f 7572 2074 6572 es that your ter │ │ │ │ │ -0001c110: 6d69 6e61 6c20 656d 756c 6174 6f72 2069 minal emulator i │ │ │ │ │ -0001c120: 730a 636f 6d70 6174 6962 6c65 2077 6974 s.compatible wit │ │ │ │ │ -0001c130: 6820 5654 3130 3020 6279 2064 6566 6175 h VT100 by defau │ │ │ │ │ -0001c140: 6c74 2e20 2054 6869 7320 6973 2074 7275 lt. This is tru │ │ │ │ │ -0001c150: 6520 666f 7220 6d6f 7374 2074 6572 6d69 e for most termi │ │ │ │ │ -0001c160: 6e61 6c0a 656d 756c 6174 6f72 7320 6e6f nal.emulators no │ │ │ │ │ -0001c170: 7761 6461 7973 2c20 6275 7420 796f 7520 wadays, but you │ │ │ │ │ -0001c180: 7368 6f75 6c64 2070 6173 7320 7468 6520 should pass the │ │ │ │ │ -0001c190: 6f70 7469 6f6e 2027 2d2d 6475 6d62 2720 option '--dumb' │ │ │ │ │ -0001c1a0: 746f 2074 6865 0a63 6f6d 6d61 6e64 2069 to the.command i │ │ │ │ │ -0001c1b0: 6620 796f 7572 2074 6572 6d69 6e61 6c20 f your terminal │ │ │ │ │ -0001c1c0: 656d 756c 6174 6f72 2069 7320 6e6f 7420 emulator is not │ │ │ │ │ -0001c1d0: 5654 3130 302d 636f 6d70 6174 6962 6c65 VT100-compatible │ │ │ │ │ -0001c1e0: 206f 7220 696d 706c 656d 656e 7473 0a66 or implements.f │ │ │ │ │ -0001c1f0: 6577 2056 5431 3030 2065 7363 6170 6520 ew VT100 escape │ │ │ │ │ -0001c200: 7365 7175 656e 6365 732e 2020 4966 2079 sequences. If y │ │ │ │ │ -0001c210: 6f75 2073 7065 6369 6679 2074 6869 7320 ou specify this │ │ │ │ │ -0001c220: 6f70 7469 6f6e 2074 6865 6e20 4752 5542 option then GRUB │ │ │ │ │ -0001c230: 0a70 726f 7669 6465 7320 796f 7520 7769 .provides you wi │ │ │ │ │ -0001c240: 7468 2061 6e20 616c 7465 726e 6174 6976 th an alternativ │ │ │ │ │ -0001c250: 6520 6d65 6e75 2069 6e74 6572 6661 6365 e menu interface │ │ │ │ │ -0001c260: 2c20 6265 6361 7573 6520 7468 6520 6e6f , because the no │ │ │ │ │ -0001c270: 726d 616c 206d 656e 750a 7265 7175 6972 rmal menu.requir │ │ │ │ │ -0001c280: 6573 2073 6576 6572 616c 2066 616e 6379 es several fancy │ │ │ │ │ -0001c290: 2066 6561 7475 7265 7320 6f66 2079 6f75 features of you │ │ │ │ │ -0001c2a0: 7220 7465 726d 696e 616c 2e0a 0a1f 0a46 r terminal.....F │ │ │ │ │ -0001c2b0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -0001c2c0: 204e 6f64 653a 2056 656e 646f 7220 706f Node: Vendor po │ │ │ │ │ -0001c2d0: 7765 722d 6f6e 206b 6579 732c 2020 4e65 wer-on keys, Ne │ │ │ │ │ -0001c2e0: 7874 3a20 496d 6167 6573 2c20 2050 7265 xt: Images, Pre │ │ │ │ │ -0001c2f0: 763a 2053 6572 6961 6c20 7465 726d 696e v: Serial termin │ │ │ │ │ -0001c300: 616c 2c20 2055 703a 2054 6f70 0a0a 3130 al, Up: Top..10 │ │ │ │ │ -0001c310: 2055 7369 6e67 2047 5255 4220 7769 7468 Using GRUB with │ │ │ │ │ -0001c320: 2076 656e 646f 7220 706f 7765 722d 6f6e vendor power-on │ │ │ │ │ -0001c330: 206b 6579 730a 2a2a 2a2a 2a2a 2a2a 2a2a keys.********** │ │ │ │ │ +0001a9b0: 2a2a 2a2a 2a2a 0a0a 5468 6520 666f 6c6c ******..The foll │ │ │ │ │ +0001a9c0: 6f77 696e 6720 696e 7374 7275 6374 696f owing instructio │ │ │ │ │ +0001a9d0: 6e73 2064 6f6e 2774 2077 6f72 6b20 666f ns don't work fo │ │ │ │ │ +0001a9e0: 7220 2a2d 656d 752c 2069 3338 362d 7165 r *-emu, i386-qe │ │ │ │ │ +0001a9f0: 6d75 2c0a 6933 3836 2d63 6f72 6562 6f6f mu,.i386-coreboo │ │ │ │ │ +0001aa00: 742c 2069 3338 362d 6d75 6c74 6962 6f6f t, i386-multiboo │ │ │ │ │ +0001aa10: 742c 206d 6970 735f 6c6f 6f6e 6773 6f6e t, mips_loongson │ │ │ │ │ +0001aa20: 2c20 6d69 7073 2d61 7263 2061 6e64 0a6d , mips-arc and.m │ │ │ │ │ +0001aa30: 6970 735f 7165 6d75 5f6d 6970 730a 0a20 ips_qemu_mips.. │ │ │ │ │ +0001aa40: 2020 546f 2067 656e 6572 6174 6520 6120 To generate a │ │ │ │ │ +0001aa50: 6e65 7462 6f6f 7461 626c 6520 6469 7265 netbootable dire │ │ │ │ │ +0001aa60: 6374 6f72 792c 2072 756e 3a0a 0a20 2020 ctory, run:.. │ │ │ │ │ +0001aa70: 2020 6772 7562 2d6d 6b6e 6574 6469 7220 grub-mknetdir │ │ │ │ │ +0001aa80: 2d2d 6e65 742d 6469 7265 6374 6f72 793d --net-directory= │ │ │ │ │ +0001aa90: 2f73 7276 2f74 6674 7020 2d2d 7375 6264 /srv/tftp --subd │ │ │ │ │ +0001aaa0: 6972 3d2f 626f 6f74 2f67 7275 6220 2d64 ir=/boot/grub -d │ │ │ │ │ +0001aab0: 202f 7573 722f 6c69 622f 6772 7562 2f3c /usr/lib/grub/< │ │ │ │ │ +0001aac0: 706c 6174 666f 726d 3e0a 0a20 2020 452e platform>.. E. │ │ │ │ │ +0001aad0: 672e 2020 666f 7220 6933 3836 2d70 633a g. for i386-pc: │ │ │ │ │ +0001aae0: 0a0a 2020 2020 2067 7275 622d 6d6b 6e65 .. grub-mkne │ │ │ │ │ +0001aaf0: 7464 6972 202d 2d6e 6574 2d64 6972 6563 tdir --net-direc │ │ │ │ │ +0001ab00: 746f 7279 3d2f 7372 762f 7466 7470 202d tory=/srv/tftp - │ │ │ │ │ +0001ab10: 2d73 7562 6469 723d 2f62 6f6f 742f 6772 -subdir=/boot/gr │ │ │ │ │ +0001ab20: 7562 202d 6420 2f75 7372 2f6c 6962 2f67 ub -d /usr/lib/g │ │ │ │ │ +0001ab30: 7275 622f 6933 3836 2d70 630a 0a20 2020 rub/i386-pc.. │ │ │ │ │ +0001ab40: 5468 656e 2066 6f6c 6c6f 7720 696e 7374 Then follow inst │ │ │ │ │ +0001ab50: 7275 6374 696f 6e73 2070 7269 6e74 6564 ructions printed │ │ │ │ │ +0001ab60: 206f 7574 2062 7920 6772 7562 2d6d 6b6e out by grub-mkn │ │ │ │ │ +0001ab70: 6574 6469 7220 6f6e 2063 6f6e 6669 6775 etdir on configu │ │ │ │ │ +0001ab80: 7269 6e67 0a79 6f75 7220 4448 4350 2073 ring.your DHCP s │ │ │ │ │ +0001ab90: 6572 7665 722e 0a0a 2020 2054 6865 2067 erver... The g │ │ │ │ │ +0001aba0: 7275 622e 6366 6720 6669 6c65 2069 7320 rub.cfg file is │ │ │ │ │ +0001abb0: 706c 6163 6564 2069 6e20 7468 6520 7361 placed in the sa │ │ │ │ │ +0001abc0: 6d65 2064 6972 6563 746f 7279 2061 7320 me directory as │ │ │ │ │ +0001abd0: 7468 6520 7061 7468 206f 7574 7075 740a the path output. │ │ │ │ │ +0001abe0: 6279 2067 7275 622d 6d6b 6e65 7464 6972 by grub-mknetdir │ │ │ │ │ +0001abf0: 2068 6572 6561 6674 6572 2072 6566 6572 hereafter refer │ │ │ │ │ +0001ac00: 7265 6420 746f 2061 7320 4657 5041 5448 red to as FWPATH │ │ │ │ │ +0001ac10: 2e20 4752 5542 2077 696c 6c20 7365 6172 . GRUB will sear │ │ │ │ │ +0001ac20: 6368 2066 6f72 0a69 7473 2063 6f6e 6669 ch for.its confi │ │ │ │ │ +0001ac30: 6775 7261 7469 6f6e 2066 696c 6573 2069 guration files i │ │ │ │ │ +0001ac40: 6e20 6f72 6465 7220 7573 696e 6720 7468 n order using th │ │ │ │ │ +0001ac50: 6520 666f 6c6c 6f77 696e 6720 7275 6c65 e following rule │ │ │ │ │ +0001ac60: 7320 7768 6572 6520 7468 650a 6170 7065 s where the.appe │ │ │ │ │ +0001ac70: 6e64 6564 2076 616c 7565 2063 6f72 7265 nded value corre │ │ │ │ │ +0001ac80: 7370 6f6e 6473 2074 6f20 6120 7661 6c75 sponds to a valu │ │ │ │ │ +0001ac90: 6520 6f6e 2074 6865 2063 6c69 656e 7420 e on the client │ │ │ │ │ +0001aca0: 6d61 6368 696e 652e 0a0a 2020 2020 2027 machine... ' │ │ │ │ │ +0001acb0: 2846 5750 4154 4829 272f 6772 7562 2e63 (FWPATH)'/grub.c │ │ │ │ │ +0001acc0: 6667 2d27 2855 5549 4420 4f46 204d 4143 fg-'(UUID OF MAC │ │ │ │ │ +0001acd0: 4849 4e45 2927 0a20 2020 2020 2728 4657 HINE)'. '(FW │ │ │ │ │ +0001ace0: 5041 5448 2927 2f67 7275 622e 6366 672d PATH)'/grub.cfg- │ │ │ │ │ +0001acf0: 2728 4d41 4320 4144 4452 4553 5320 4f46 '(MAC ADDRESS OF │ │ │ │ │ +0001ad00: 204e 4943 2927 0a20 2020 2020 2728 4657 NIC)'. '(FW │ │ │ │ │ +0001ad10: 5041 5448 2927 2f67 7275 622e 6366 672d PATH)'/grub.cfg- │ │ │ │ │ +0001ad20: 2728 4950 7634 204f 5220 4950 7636 2041 '(IPv4 OR IPv6 A │ │ │ │ │ +0001ad30: 4444 5245 5353 2927 0a20 2020 2020 2728 DDRESS)'. '( │ │ │ │ │ +0001ad40: 4657 5041 5448 2927 2f67 7275 622e 6366 FWPATH)'/grub.cf │ │ │ │ │ +0001ad50: 670a 0a20 2020 5468 6520 5555 4944 2069 g.. The UUID i │ │ │ │ │ +0001ad60: 7320 7468 6520 436c 6965 6e74 204d 6163 s the Client Mac │ │ │ │ │ +0001ad70: 6869 6e65 2049 6465 6e74 6966 6965 7220 hine Identifier │ │ │ │ │ +0001ad80: 4f70 7469 6f6e 2044 6566 696e 6974 696f Option Definitio │ │ │ │ │ +0001ad90: 6e20 6173 0a73 7065 6369 6669 6564 2069 n as.specified i │ │ │ │ │ +0001ada0: 6e20 5246 4320 3435 3738 2e20 2054 6865 n RFC 4578. The │ │ │ │ │ +0001adb0: 2063 6c69 656e 7420 7769 6c6c 206f 6e6c client will onl │ │ │ │ │ +0001adc0: 7920 6174 7465 6d70 7420 746f 206c 6f6f y attempt to loo │ │ │ │ │ +0001add0: 756b 2075 7020 6120 5555 4944 0a63 6f6e uk up a UUID.con │ │ │ │ │ +0001ade0: 6669 6720 6669 6c65 2069 6620 6974 2077 fig file if it w │ │ │ │ │ +0001adf0: 6173 2070 726f 7669 6465 6420 6279 2074 as provided by t │ │ │ │ │ +0001ae00: 6865 2044 4843 5020 7365 7276 6572 2e0a he DHCP server.. │ │ │ │ │ +0001ae10: 0a20 2020 5468 6520 636c 6965 6e74 2077 . The client w │ │ │ │ │ +0001ae20: 696c 6c20 6f6e 6c79 2061 7474 656d 7074 ill only attempt │ │ │ │ │ +0001ae30: 2074 6f20 6c6f 6f6b 2075 7020 616e 2049 to look up an I │ │ │ │ │ +0001ae40: 5076 3620 6164 6472 6573 7320 636f 6e66 Pv6 address conf │ │ │ │ │ +0001ae50: 6967 206f 6e63 652c 0a68 6f77 6576 6572 ig once,.however │ │ │ │ │ +0001ae60: 2c20 6974 2077 696c 6c20 7472 7920 7468 , it will try th │ │ │ │ │ +0001ae70: 6520 4950 7634 206d 756c 7469 706c 6520 e IPv4 multiple │ │ │ │ │ +0001ae80: 7469 6d65 732e 2020 5468 6520 636f 6e63 times. The conc │ │ │ │ │ +0001ae90: 7265 7465 2065 7861 6d70 6c65 0a62 656c rete example.bel │ │ │ │ │ +0001aea0: 6f77 2073 686f 7773 2077 6861 7420 776f ow shows what wo │ │ │ │ │ +0001aeb0: 756c 6420 6861 7070 656e 2075 6e64 6572 uld happen under │ │ │ │ │ +0001aec0: 2074 6865 2049 5076 3420 6361 7365 2e0a the IPv4 case.. │ │ │ │ │ +0001aed0: 0a20 2020 2020 5555 4944 3a20 3737 3236 . UUID: 7726 │ │ │ │ │ +0001aee0: 6136 3738 2d37 6663 302d 3438 3533 2d61 a678-7fc0-4853-a │ │ │ │ │ +0001aef0: 3466 362d 6338 3561 6333 3661 3132 3061 4f6-c85ac36a120a │ │ │ │ │ +0001af00: 0a20 2020 2020 4d41 433a 2020 3532 3a35 . MAC: 52:5 │ │ │ │ │ +0001af10: 343a 3030 3a65 633a 3333 3a38 310a 2020 4:00:ec:33:81. │ │ │ │ │ +0001af20: 2020 2049 5056 343a 2031 302e 302e 302e IPV4: 10.0.0. │ │ │ │ │ +0001af30: 3133 3020 2830 4130 3030 3038 3229 0a0a 130 (0A000082).. │ │ │ │ │ +0001af40: 2020 2020 2027 2846 5750 4154 4829 272f '(FWPATH)'/ │ │ │ │ │ +0001af50: 6772 7562 2e63 6667 2d37 3732 3661 3637 grub.cfg-7726a67 │ │ │ │ │ +0001af60: 382d 3766 6330 2d34 3835 332d 6134 6636 8-7fc0-4853-a4f6 │ │ │ │ │ +0001af70: 2d63 3835 6163 3336 6131 3230 610a 2020 -c85ac36a120a. │ │ │ │ │ +0001af80: 2020 2027 2846 5750 4154 4829 272f 6772 '(FWPATH)'/gr │ │ │ │ │ +0001af90: 7562 2e63 6667 2d35 322d 3534 2d30 302d ub.cfg-52-54-00- │ │ │ │ │ +0001afa0: 6563 2d33 332d 3831 0a20 2020 2020 2728 ec-33-81. '( │ │ │ │ │ +0001afb0: 4657 5041 5448 2927 2f67 7275 622e 6366 FWPATH)'/grub.cf │ │ │ │ │ +0001afc0: 672d 3041 3030 3030 3832 0a20 2020 2020 g-0A000082. │ │ │ │ │ +0001afd0: 2728 4657 5041 5448 2927 2f67 7275 622e '(FWPATH)'/grub. │ │ │ │ │ +0001afe0: 6366 672d 3041 3030 3030 380a 2020 2020 cfg-0A00008. │ │ │ │ │ +0001aff0: 2027 2846 5750 4154 4829 272f 6772 7562 '(FWPATH)'/grub │ │ │ │ │ +0001b000: 2e63 6667 2d30 4130 3030 300a 2020 2020 .cfg-0A0000. │ │ │ │ │ +0001b010: 2027 2846 5750 4154 4829 272f 6772 7562 '(FWPATH)'/grub │ │ │ │ │ +0001b020: 2e63 6667 2d30 4130 3030 0a20 2020 2020 .cfg-0A000. │ │ │ │ │ +0001b030: 2728 4657 5041 5448 2927 2f67 7275 622e '(FWPATH)'/grub. │ │ │ │ │ +0001b040: 6366 672d 3041 3030 0a20 2020 2020 2728 cfg-0A00. '( │ │ │ │ │ +0001b050: 4657 5041 5448 2927 2f67 7275 622e 6366 FWPATH)'/grub.cf │ │ │ │ │ +0001b060: 672d 3041 300a 2020 2020 2027 2846 5750 g-0A0. '(FWP │ │ │ │ │ +0001b070: 4154 4829 272f 6772 7562 2e63 6667 2d30 ATH)'/grub.cfg-0 │ │ │ │ │ +0001b080: 410a 2020 2020 2027 2846 5750 4154 4829 A. '(FWPATH) │ │ │ │ │ +0001b090: 272f 6772 7562 2e63 6667 2d30 0a20 2020 '/grub.cfg-0. │ │ │ │ │ +0001b0a0: 2020 2728 4657 5041 5448 2927 2f67 7275 '(FWPATH)'/gru │ │ │ │ │ +0001b0b0: 622e 6366 670a 0a20 2020 5468 6973 2066 b.cfg.. This f │ │ │ │ │ +0001b0c0: 6561 7475 7265 2069 7320 656e 6162 6c65 eature is enable │ │ │ │ │ +0001b0d0: 6420 6279 2064 6566 6175 6c74 2062 7574 d by default but │ │ │ │ │ +0001b0e0: 2069 7420 6361 6e20 6265 2064 6973 6162 it can be disab │ │ │ │ │ +0001b0f0: 6c65 6420 6279 2073 6574 7469 6e67 0a74 led by setting.t │ │ │ │ │ +0001b100: 6865 2027 6665 6174 7572 655f 6e65 745f he 'feature_net_ │ │ │ │ │ +0001b110: 7365 6172 6368 5f63 6667 2720 746f 2027 search_cfg' to ' │ │ │ │ │ +0001b120: 6e27 2e20 2053 696e 6365 2074 6869 7320 n'. Since this │ │ │ │ │ +0001b130: 6861 7070 656e 7320 6265 666f 7265 2074 happens before t │ │ │ │ │ +0001b140: 6865 0a63 6f6e 6669 6775 7261 7469 6f6e he.configuration │ │ │ │ │ +0001b150: 2066 696c 6520 6973 2072 6561 6420 6279 file is read by │ │ │ │ │ +0001b160: 2047 5255 422c 2074 6869 7320 6f70 7469 GRUB, this opti │ │ │ │ │ +0001b170: 6f6e 2068 6173 2074 6f20 6265 2064 6973 on has to be dis │ │ │ │ │ +0001b180: 6162 6c65 6420 696e 2061 6e0a 656d 6265 abled in an.embe │ │ │ │ │ +0001b190: 6464 6564 2063 6f6e 6669 6775 7261 7469 dded configurati │ │ │ │ │ +0001b1a0: 6f6e 2066 696c 6520 282a 6e6f 7465 2045 on file (*note E │ │ │ │ │ +0001b1b0: 6d62 6564 6465 6420 636f 6e66 6967 7572 mbedded configur │ │ │ │ │ +0001b1c0: 6174 696f 6e3a 3a29 2e0a 0a20 2020 4166 ation::)... Af │ │ │ │ │ +0001b1d0: 7465 7220 4752 5542 2068 6173 2073 7461 ter GRUB has sta │ │ │ │ │ +0001b1e0: 7274 6564 2c20 6669 6c65 7320 6f6e 2074 rted, files on t │ │ │ │ │ +0001b1f0: 6865 2054 4654 5020 7365 7276 6572 2077 he TFTP server w │ │ │ │ │ +0001b200: 696c 6c20 6265 2061 6363 6573 7369 626c ill be accessibl │ │ │ │ │ +0001b210: 650a 7669 6120 7468 6520 2728 7466 7470 e.via the '(tftp │ │ │ │ │ +0001b220: 2927 2064 6576 6963 652e 0a0a 2020 2054 )' device... T │ │ │ │ │ +0001b230: 6865 2073 6572 7665 7220 4950 2061 6464 he server IP add │ │ │ │ │ +0001b240: 7265 7373 2063 616e 2062 6520 636f 6e74 ress can be cont │ │ │ │ │ +0001b250: 726f 6c6c 6564 2062 7920 6368 616e 6769 rolled by changi │ │ │ │ │ +0001b260: 6e67 2074 6865 2027 2874 6674 7029 270a ng the '(tftp)'. │ │ │ │ │ +0001b270: 6465 7669 6365 206e 616d 6520 746f 2027 device name to ' │ │ │ │ │ +0001b280: 2874 6674 702c 5345 5256 4552 2d49 5029 (tftp,SERVER-IP) │ │ │ │ │ +0001b290: 272e 2020 4e6f 7465 2074 6861 7420 7468 '. Note that th │ │ │ │ │ +0001b2a0: 6973 2073 686f 756c 6420 6265 2063 6861 is should be cha │ │ │ │ │ +0001b2b0: 6e67 6564 0a62 6f74 6820 696e 2074 6865 nged.both in the │ │ │ │ │ +0001b2c0: 2070 7265 6669 7820 616e 6420 696e 2061 prefix and in a │ │ │ │ │ +0001b2d0: 6e79 2072 6566 6572 656e 6365 7320 746f ny references to │ │ │ │ │ +0001b2e0: 2074 6865 2064 6576 6963 6520 6e61 6d65 the device name │ │ │ │ │ +0001b2f0: 2069 6e20 7468 650a 636f 6e66 6967 7572 in the.configur │ │ │ │ │ +0001b300: 6174 696f 6e20 6669 6c65 2e0a 0a20 2020 ation file... │ │ │ │ │ +0001b310: 4752 5542 2070 726f 7669 6465 7320 7365 GRUB provides se │ │ │ │ │ +0001b320: 7665 7261 6c20 656e 7669 726f 6e6d 656e veral environmen │ │ │ │ │ +0001b330: 7420 7661 7269 6162 6c65 7320 7768 6963 t variables whic │ │ │ │ │ +0001b340: 6820 6d61 7920 6265 2075 7365 6420 746f h may be used to │ │ │ │ │ +0001b350: 0a69 6e73 7065 6374 206f 7220 6368 616e .inspect or chan │ │ │ │ │ +0001b360: 6765 2074 6865 2062 6568 6176 696f 7572 ge the behaviour │ │ │ │ │ +0001b370: 206f 6620 7468 6520 5058 4520 6465 7669 of the PXE devi │ │ │ │ │ +0001b380: 6365 2e20 2049 6e20 7468 6520 666f 6c6c ce. In the foll │ │ │ │ │ +0001b390: 6f77 696e 670a 6465 7363 7269 7074 696f owing.descriptio │ │ │ │ │ +0001b3a0: 6e20 3c49 4e54 4552 4641 4345 3e20 6973 n is │ │ │ │ │ +0001b3b0: 2070 6c61 6365 686f 6c64 6572 2066 6f72 placeholder for │ │ │ │ │ +0001b3c0: 2074 6865 206e 616d 6520 6f66 206e 6574 the name of net │ │ │ │ │ +0001b3d0: 776f 726b 2069 6e74 6572 6661 6365 0a28 work interface.( │ │ │ │ │ +0001b3e0: 706c 6174 666f 726d 2064 6570 656e 6465 platform depende │ │ │ │ │ +0001b3f0: 6e74 293a 0a0a 276e 6574 5f3c 494e 5445 nt):..'net__ip'. │ │ │ │ │ +0001b410: 5468 6520 6e65 7477 6f72 6b20 696e 7465 The network inte │ │ │ │ │ +0001b420: 7266 6163 6527 7320 4950 2061 6464 7265 rface's IP addre │ │ │ │ │ +0001b430: 7373 2e20 2052 6561 642d 6f6e 6c79 2e0a ss. Read-only.. │ │ │ │ │ +0001b440: 0a27 6e65 745f 3c49 4e54 4552 4641 4345 .'net__mac'. The │ │ │ │ │ +0001b460: 6e65 7477 6f72 6b20 696e 7465 7266 6163 network interfac │ │ │ │ │ +0001b470: 6527 7320 4d41 4320 6164 6472 6573 732e e's MAC address. │ │ │ │ │ +0001b480: 2020 5265 6164 2d6f 6e6c 792e 0a0a 276e Read-only...'n │ │ │ │ │ +0001b490: 6574 5f3c 494e 5445 5246 4143 453e 5f68 et__h │ │ │ │ │ +0001b4a0: 6f73 746e 616d 6527 0a20 2020 2020 5468 ostname'. Th │ │ │ │ │ +0001b4b0: 6520 636c 6965 6e74 2068 6f73 7420 6e61 e client host na │ │ │ │ │ +0001b4c0: 6d65 2070 726f 7669 6465 6420 6279 2044 me provided by D │ │ │ │ │ +0001b4d0: 4843 502e 2052 6561 642d 6f6e 6c79 2e0a HCP. Read-only.. │ │ │ │ │ +0001b4e0: 0a27 6e65 745f 3c49 4e54 4552 4641 4345 .'net__domain'. T │ │ │ │ │ +0001b500: 6865 2063 6c69 656e 7420 646f 6d61 696e he client domain │ │ │ │ │ +0001b510: 206e 616d 6520 7072 6f76 6964 6564 2062 name provided b │ │ │ │ │ +0001b520: 7920 4448 4350 2e20 5265 6164 2d6f 6e6c y DHCP. Read-onl │ │ │ │ │ +0001b530: 792e 0a0a 276e 6574 5f3c 494e 5445 5246 y...'net__rootpath'. │ │ │ │ │ +0001b550: 2020 2020 5468 6520 7061 7468 2074 6f20 The path to │ │ │ │ │ +0001b560: 7468 6520 636c 6965 6e74 2773 2072 6f6f the client's roo │ │ │ │ │ +0001b570: 7420 6469 736b 2070 726f 7669 6465 6420 t disk provided │ │ │ │ │ +0001b580: 6279 2044 4843 502e 2052 6561 642d 6f6e by DHCP. Read-on │ │ │ │ │ +0001b590: 6c79 2e0a 0a27 6e65 745f 3c49 4e54 4552 ly...'net__extensions │ │ │ │ │ +0001b5b0: 7061 7468 270a 2020 2020 2054 6865 2070 path'. The p │ │ │ │ │ +0001b5c0: 6174 6820 746f 2061 6464 6974 696f 6e61 ath to additiona │ │ │ │ │ +0001b5d0: 6c20 4448 4350 2076 656e 646f 7220 6578 l DHCP vendor ex │ │ │ │ │ +0001b5e0: 7465 6e73 696f 6e73 2070 726f 7669 6465 tensions provide │ │ │ │ │ +0001b5f0: 6420 6279 2044 4843 502e 0a20 2020 2020 d by DHCP.. │ │ │ │ │ +0001b600: 5265 6164 2d6f 6e6c 792e 0a0a 276e 6574 Read-only...'net │ │ │ │ │ +0001b610: 5f3c 494e 5445 5246 4143 453e 5f62 6f6f __boo │ │ │ │ │ +0001b620: 745f 6669 6c65 270a 2020 2020 2054 6865 t_file'. The │ │ │ │ │ +0001b630: 2062 6f6f 7420 6669 6c65 206e 616d 6520 boot file name │ │ │ │ │ +0001b640: 7072 6f76 6964 6564 2062 7920 4448 4350 provided by DHCP │ │ │ │ │ +0001b650: 2e20 5265 6164 2d6f 6e6c 792e 0a0a 276e . Read-only...'n │ │ │ │ │ +0001b660: 6574 5f3c 494e 5445 5246 4143 453e 5f64 et__d │ │ │ │ │ +0001b670: 6863 705f 7365 7276 6572 5f6e 616d 6527 hcp_server_name' │ │ │ │ │ +0001b680: 0a20 2020 2020 5468 6520 6e61 6d65 206f . The name o │ │ │ │ │ +0001b690: 6620 7468 6520 4448 4350 2073 6572 7665 f the DHCP serve │ │ │ │ │ +0001b6a0: 7220 7265 7370 6f6e 7369 626c 6520 666f r responsible fo │ │ │ │ │ +0001b6b0: 7220 7468 6573 6520 626f 6f74 2070 6172 r these boot par │ │ │ │ │ +0001b6c0: 616d 6574 6572 732e 0a20 2020 2020 5265 ameters.. Re │ │ │ │ │ +0001b6d0: 6164 2d6f 6e6c 792e 0a0a 276e 6574 5f3c ad-only...'net_< │ │ │ │ │ +0001b6e0: 494e 5445 5246 4143 453e 5f6e 6578 745f INTERFACE>_next_ │ │ │ │ │ +0001b6f0: 7365 7276 6572 270a 2020 2020 2054 6865 server'. The │ │ │ │ │ +0001b700: 2049 5020 6164 6472 6573 7320 6f66 2074 IP address of t │ │ │ │ │ +0001b710: 6865 206e 6578 7420 2875 7375 616c 6c79 he next (usually │ │ │ │ │ +0001b720: 2c20 5446 5450 2920 7365 7276 6572 2070 , TFTP) server p │ │ │ │ │ +0001b730: 726f 7669 6465 6420 6279 2044 4843 502e rovided by DHCP. │ │ │ │ │ +0001b740: 0a20 2020 2020 5265 6164 2d6f 6e6c 792e . Read-only. │ │ │ │ │ +0001b750: 0a0a 276e 6574 5f64 6566 6175 6c74 5f69 ..'net_default_i │ │ │ │ │ +0001b760: 6e74 6572 6661 6365 270a 2020 2020 2049 nterface'. I │ │ │ │ │ +0001b770: 6e69 7469 616c 6c79 2073 6574 2074 6f20 nitially set to │ │ │ │ │ +0001b780: 6e61 6d65 206f 6620 6e65 7477 6f72 6b20 name of network │ │ │ │ │ +0001b790: 696e 7465 7266 6163 6520 7468 6174 2077 interface that w │ │ │ │ │ +0001b7a0: 6173 2075 7365 6420 746f 206c 6f61 640a as used to load. │ │ │ │ │ +0001b7b0: 2020 2020 2067 7275 622e 2020 5265 6164 grub. Read │ │ │ │ │ +0001b7c0: 2d77 7269 7465 2c20 616c 7468 6f75 6768 -write, although │ │ │ │ │ +0001b7d0: 2073 6574 7469 6e67 2069 7420 6166 6665 setting it affe │ │ │ │ │ +0001b7e0: 6374 7320 6f6e 6c79 2069 6e74 6572 7072 cts only interpr │ │ │ │ │ +0001b7f0: 6574 6174 696f 6e0a 2020 2020 206f 6620 etation. of │ │ │ │ │ +0001b800: 276e 6574 5f64 6566 6175 6c74 5f69 7027 'net_default_ip' │ │ │ │ │ +0001b810: 2061 6e64 2027 6e65 745f 6465 6661 756c and 'net_defaul │ │ │ │ │ +0001b820: 745f 6d61 6327 0a0a 276e 6574 5f64 6566 t_mac'..'net_def │ │ │ │ │ +0001b830: 6175 6c74 5f69 7027 0a20 2020 2020 5468 ault_ip'. Th │ │ │ │ │ +0001b840: 6520 4950 2061 6464 7265 7373 206f 6620 e IP address of │ │ │ │ │ +0001b850: 6465 6661 756c 7420 696e 7465 7266 6163 default interfac │ │ │ │ │ +0001b860: 652e 2020 5265 6164 2d6f 6e6c 792e 2020 e. Read-only. │ │ │ │ │ +0001b870: 5468 6973 2069 7320 616c 6961 7320 666f This is alias fo │ │ │ │ │ +0001b880: 720a 2020 2020 2074 6865 2027 6e65 745f r. the 'net_ │ │ │ │ │ +0001b890: 247b 6e65 745f 6465 6661 756c 745f 696e ${net_default_in │ │ │ │ │ +0001b8a0: 7465 7266 6163 657d 5f69 7027 2e0a 0a27 terface}_ip'...' │ │ │ │ │ +0001b8b0: 6e65 745f 6465 6661 756c 745f 6d61 6327 net_default_mac' │ │ │ │ │ +0001b8c0: 0a20 2020 2020 5468 6520 6465 6661 756c . The defaul │ │ │ │ │ +0001b8d0: 7420 696e 7465 7266 6163 6527 7320 4d41 t interface's MA │ │ │ │ │ +0001b8e0: 4320 6164 6472 6573 732e 2020 5265 6164 C address. Read │ │ │ │ │ +0001b8f0: 2d6f 6e6c 792e 2020 5468 6973 2069 7320 -only. This is │ │ │ │ │ +0001b900: 616c 6961 7320 666f 720a 2020 2020 2074 alias for. t │ │ │ │ │ +0001b910: 6865 2027 6e65 745f 247b 6e65 745f 6465 he 'net_${net_de │ │ │ │ │ +0001b920: 6661 756c 745f 696e 7465 7266 6163 657d fault_interface} │ │ │ │ │ +0001b930: 5f6d 6163 272e 0a0a 276e 6574 5f64 6566 _mac'...'net_def │ │ │ │ │ +0001b940: 6175 6c74 5f73 6572 7665 7227 0a20 2020 ault_server'. │ │ │ │ │ +0001b950: 2020 5468 6520 6465 6661 756c 7420 7365 The default se │ │ │ │ │ +0001b960: 7276 6572 2075 7365 6420 6279 206e 6574 rver used by net │ │ │ │ │ +0001b970: 776f 726b 2064 7269 7665 7320 282a 6e6f work drives (*no │ │ │ │ │ +0001b980: 7465 2044 6576 6963 6520 7379 6e74 6178 te Device syntax │ │ │ │ │ +0001b990: 3a3a 292e 0a20 2020 2020 5265 6164 2d77 ::).. Read-w │ │ │ │ │ +0001b9a0: 7269 7465 2c20 616c 7468 6f75 6768 2073 rite, although s │ │ │ │ │ +0001b9b0: 6574 7469 6e67 2074 6869 7320 6973 206f etting this is o │ │ │ │ │ +0001b9c0: 6e6c 7920 7573 6566 756c 2062 6566 6f72 nly useful befor │ │ │ │ │ +0001b9d0: 6520 6f70 656e 696e 6720 610a 2020 2020 e opening a. │ │ │ │ │ +0001b9e0: 206e 6574 776f 726b 2064 6576 6963 652e network device. │ │ │ │ │ +0001b9f0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0001ba00: 6e66 6f2c 2020 4e6f 6465 3a20 5365 7269 nfo, Node: Seri │ │ │ │ │ +0001ba10: 616c 2074 6572 6d69 6e61 6c2c 2020 4e65 al terminal, Ne │ │ │ │ │ +0001ba20: 7874 3a20 5665 6e64 6f72 2070 6f77 6572 xt: Vendor power │ │ │ │ │ +0001ba30: 2d6f 6e20 6b65 7973 2c20 2050 7265 763a -on keys, Prev: │ │ │ │ │ +0001ba40: 204e 6574 776f 726b 2c20 2055 703a 2054 Network, Up: T │ │ │ │ │ +0001ba50: 6f70 0a0a 3920 5573 696e 6720 4752 5542 op..9 Using GRUB │ │ │ │ │ +0001ba60: 2076 6961 2061 2073 6572 6961 6c20 6c69 via a serial li │ │ │ │ │ +0001ba70: 6e65 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ne.************* │ │ │ │ │ +0001ba80: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +0001ba90: 2a0a 0a54 6869 7320 6368 6170 7465 7220 *..This chapter │ │ │ │ │ +0001baa0: 6465 7363 7269 6265 7320 686f 7720 746f describes how to │ │ │ │ │ +0001bab0: 2075 7365 2074 6865 2073 6572 6961 6c20 use the serial │ │ │ │ │ +0001bac0: 7465 726d 696e 616c 2073 7570 706f 7274 terminal support │ │ │ │ │ +0001bad0: 2069 6e20 4752 5542 2e0a 0a20 2020 4966 in GRUB... If │ │ │ │ │ +0001bae0: 2079 6f75 2068 6176 6520 6d61 6e79 2063 you have many c │ │ │ │ │ +0001baf0: 6f6d 7075 7465 7273 206f 7220 636f 6d70 omputers or comp │ │ │ │ │ +0001bb00: 7574 6572 7320 7769 7468 206e 6f20 6469 uters with no di │ │ │ │ │ +0001bb10: 7370 6c61 792f 6b65 7962 6f61 7264 2c20 splay/keyboard, │ │ │ │ │ +0001bb20: 6974 0a63 6f75 6c64 2062 6520 7665 7279 it.could be very │ │ │ │ │ +0001bb30: 2075 7365 6675 6c20 746f 2063 6f6e 7472 useful to contr │ │ │ │ │ +0001bb40: 6f6c 2074 6865 2063 6f6d 7075 7465 7273 ol the computers │ │ │ │ │ +0001bb50: 2074 6872 6f75 6768 2073 6572 6961 6c0a through serial. │ │ │ │ │ +0001bb60: 636f 6d6d 756e 6963 6174 696f 6e73 2e20 communications. │ │ │ │ │ +0001bb70: 2054 6f20 636f 6e6e 6563 7420 6f6e 6520 To connect one │ │ │ │ │ +0001bb80: 636f 6d70 7574 6572 2077 6974 6820 616e computer with an │ │ │ │ │ +0001bb90: 6f74 6865 7220 7669 6120 6120 7365 7269 other via a seri │ │ │ │ │ +0001bba0: 616c 206c 696e 652c 0a79 6f75 206e 6565 al line,.you nee │ │ │ │ │ +0001bbb0: 6420 746f 2070 7265 7061 7265 2061 206e d to prepare a n │ │ │ │ │ +0001bbc0: 756c 6c2d 6d6f 6465 6d20 2863 726f 7373 ull-modem (cross │ │ │ │ │ +0001bbd0: 2920 7365 7269 616c 2063 6162 6c65 2c20 ) serial cable, │ │ │ │ │ +0001bbe0: 616e 6420 796f 7520 6d61 7920 6e65 6564 and you may need │ │ │ │ │ +0001bbf0: 0a74 6f20 6861 7665 206d 756c 7469 706f .to have multipo │ │ │ │ │ +0001bc00: 7274 2073 6572 6961 6c20 626f 6172 6473 rt serial boards │ │ │ │ │ +0001bc10: 2c20 6966 2079 6f75 7220 636f 6d70 7574 , if your comput │ │ │ │ │ +0001bc20: 6572 2064 6f65 736e 2774 2068 6176 6520 er doesn't have │ │ │ │ │ +0001bc30: 6578 7472 610a 7365 7269 616c 2070 6f72 extra.serial por │ │ │ │ │ +0001bc40: 7473 2e20 2049 6e20 6164 6469 7469 6f6e ts. In addition │ │ │ │ │ +0001bc50: 2c20 6120 7465 726d 696e 616c 2065 6d75 , a terminal emu │ │ │ │ │ +0001bc60: 6c61 746f 7220 6973 2061 6c73 6f20 7265 lator is also re │ │ │ │ │ +0001bc70: 7175 6972 6564 2c20 7375 6368 0a61 7320 quired, such.as │ │ │ │ │ +0001bc80: 6d69 6e69 636f 6d2e 2020 5265 6665 7220 minicom. Refer │ │ │ │ │ +0001bc90: 746f 2061 206d 616e 7561 6c20 6f66 2079 to a manual of y │ │ │ │ │ +0001bca0: 6f75 7220 6f70 6572 6174 696e 6720 7379 our operating sy │ │ │ │ │ +0001bcb0: 7374 656d 2c20 666f 7220 6d6f 7265 0a69 stem, for more.i │ │ │ │ │ +0001bcc0: 6e66 6f72 6d61 7469 6f6e 2e0a 0a20 2020 nformation... │ │ │ │ │ +0001bcd0: 4173 2066 6f72 2047 5255 422c 2074 6865 As for GRUB, the │ │ │ │ │ +0001bce0: 2069 6e73 7472 7563 7469 6f6e 2074 6f20 instruction to │ │ │ │ │ +0001bcf0: 7365 7420 7570 2061 2073 6572 6961 6c20 set up a serial │ │ │ │ │ +0001bd00: 7465 726d 696e 616c 2069 7320 7175 6974 terminal is quit │ │ │ │ │ +0001bd10: 650a 7369 6d70 6c65 2e20 2048 6572 6520 e.simple. Here │ │ │ │ │ +0001bd20: 6973 2061 6e20 6578 616d 706c 653a 0a0a is an example:.. │ │ │ │ │ +0001bd30: 2020 2020 2067 7275 623e 2073 6572 6961 grub> seria │ │ │ │ │ +0001bd40: 6c20 2d2d 756e 6974 3d30 202d 2d73 7065 l --unit=0 --spe │ │ │ │ │ +0001bd50: 6564 3d39 3630 300a 2020 2020 2067 7275 ed=9600. gru │ │ │ │ │ +0001bd60: 623e 2074 6572 6d69 6e61 6c5f 696e 7075 b> terminal_inpu │ │ │ │ │ +0001bd70: 7420 7365 7269 616c 3b20 7465 726d 696e t serial; termin │ │ │ │ │ +0001bd80: 616c 5f6f 7574 7075 7420 7365 7269 616c al_output serial │ │ │ │ │ +0001bd90: 0a0a 2020 2054 6865 2063 6f6d 6d61 6e64 .. The command │ │ │ │ │ +0001bda0: 2027 7365 7269 616c 2720 696e 6974 6961 'serial' initia │ │ │ │ │ +0001bdb0: 6c69 7a65 7320 7468 6520 7365 7269 616c lizes the serial │ │ │ │ │ +0001bdc0: 2075 6e69 7420 3020 7769 7468 2074 6865 unit 0 with the │ │ │ │ │ +0001bdd0: 2073 7065 6564 0a39 3630 3062 7073 2e20 speed.9600bps. │ │ │ │ │ +0001bde0: 2054 6865 2073 6572 6961 6c20 756e 6974 The serial unit │ │ │ │ │ +0001bdf0: 2030 2069 7320 7573 7561 6c6c 7920 6361 0 is usually ca │ │ │ │ │ +0001be00: 6c6c 6564 2027 434f 4d31 272c 2073 6f2c lled 'COM1', so, │ │ │ │ │ +0001be10: 2069 6620 796f 7520 7761 6e74 2074 6f0a if you want to. │ │ │ │ │ +0001be20: 7573 6520 434f 4d32 2c20 796f 7520 6d75 use COM2, you mu │ │ │ │ │ +0001be30: 7374 2073 7065 6369 6679 2027 2d2d 756e st specify '--un │ │ │ │ │ +0001be40: 6974 3d31 2720 696e 7374 6561 642e 2020 it=1' instead. │ │ │ │ │ +0001be50: 5468 6973 2063 6f6d 6d61 6e64 2061 6363 This command acc │ │ │ │ │ +0001be60: 6570 7473 0a6d 616e 7920 6f74 6865 7220 epts.many other │ │ │ │ │ +0001be70: 6f70 7469 6f6e 732c 2073 6f20 706c 6561 options, so plea │ │ │ │ │ +0001be80: 7365 2072 6566 6572 2074 6f20 2a6e 6f74 se refer to *not │ │ │ │ │ +0001be90: 6520 7365 7269 616c 3a3a 2c20 666f 7220 e serial::, for │ │ │ │ │ +0001bea0: 6d6f 7265 2064 6574 6169 6c73 2e0a 0a20 more details... │ │ │ │ │ +0001beb0: 2020 5468 6520 636f 6d6d 616e 6473 2027 The commands ' │ │ │ │ │ +0001bec0: 7465 726d 696e 616c 5f69 6e70 7574 2720 terminal_input' │ │ │ │ │ +0001bed0: 282a 6e6f 7465 2074 6572 6d69 6e61 6c5f (*note terminal_ │ │ │ │ │ +0001bee0: 696e 7075 743a 3a29 2061 6e64 0a27 7465 input::) and.'te │ │ │ │ │ +0001bef0: 726d 696e 616c 5f6f 7574 7075 7427 2028 rminal_output' ( │ │ │ │ │ +0001bf00: 2a6e 6f74 6520 7465 726d 696e 616c 5f6f *note terminal_o │ │ │ │ │ +0001bf10: 7574 7075 743a 3a29 2063 686f 6f73 6520 utput::) choose │ │ │ │ │ +0001bf20: 7768 6963 6820 7479 7065 206f 660a 7465 which type of.te │ │ │ │ │ +0001bf30: 726d 696e 616c 2079 6f75 2077 616e 7420 rminal you want │ │ │ │ │ +0001bf40: 746f 2075 7365 2e20 2049 6e20 7468 6520 to use. In the │ │ │ │ │ +0001bf50: 6361 7365 2061 626f 7665 2c20 7468 6520 case above, the │ │ │ │ │ +0001bf60: 7465 726d 696e 616c 2077 696c 6c20 6265 terminal will be │ │ │ │ │ +0001bf70: 2061 0a73 6572 6961 6c20 7465 726d 696e a.serial termin │ │ │ │ │ +0001bf80: 616c 2c20 6275 7420 796f 7520 6361 6e20 al, but you can │ │ │ │ │ +0001bf90: 616c 736f 2070 6173 7320 2763 6f6e 736f also pass 'conso │ │ │ │ │ +0001bfa0: 6c65 2720 746f 2074 6865 2063 6f6d 6d61 le' to the comma │ │ │ │ │ +0001bfb0: 6e64 2c20 6173 0a27 7465 726d 696e 616c nd, as.'terminal │ │ │ │ │ +0001bfc0: 5f69 6e70 7574 2073 6572 6961 6c20 636f _input serial co │ │ │ │ │ +0001bfd0: 6e73 6f6c 6527 2e20 2049 6e20 7468 6973 nsole'. In this │ │ │ │ │ +0001bfe0: 2063 6173 652c 2061 2074 6572 6d69 6e61 case, a termina │ │ │ │ │ +0001bff0: 6c20 696e 2077 6869 6368 2079 6f75 0a70 l in which you.p │ │ │ │ │ +0001c000: 7265 7373 2061 6e79 206b 6579 2077 696c ress any key wil │ │ │ │ │ +0001c010: 6c20 6265 2073 656c 6563 7465 6420 6173 l be selected as │ │ │ │ │ +0001c020: 2061 2047 5255 4220 7465 726d 696e 616c a GRUB terminal │ │ │ │ │ +0001c030: 2e20 2049 6e20 7468 6520 6578 616d 706c . In the exampl │ │ │ │ │ +0001c040: 650a 6162 6f76 652c 206e 6f74 6520 7468 e.above, note th │ │ │ │ │ +0001c050: 6174 2079 6f75 206e 6565 6420 746f 2070 at you need to p │ │ │ │ │ +0001c060: 7574 2062 6f74 6820 636f 6d6d 616e 6473 ut both commands │ │ │ │ │ +0001c070: 206f 6e20 7468 6520 7361 6d65 2063 6f6d on the same com │ │ │ │ │ +0001c080: 6d61 6e64 206c 696e 652c 0a61 7320 796f mand line,.as yo │ │ │ │ │ +0001c090: 7520 7769 6c6c 206c 6f73 6520 7468 6520 u will lose the │ │ │ │ │ +0001c0a0: 6162 696c 6974 7920 746f 2074 7970 6520 ability to type │ │ │ │ │ +0001c0b0: 636f 6d6d 616e 6473 206f 6e20 7468 6520 commands on the │ │ │ │ │ +0001c0c0: 636f 6e73 6f6c 6520 6166 7465 7220 7468 console after th │ │ │ │ │ +0001c0d0: 650a 6669 7273 7420 636f 6d6d 616e 642e e.first command. │ │ │ │ │ +0001c0e0: 0a0a 2020 2048 6f77 6576 6572 2c20 6e6f .. However, no │ │ │ │ │ +0001c0f0: 7465 2074 6861 7420 4752 5542 2061 7373 te that GRUB ass │ │ │ │ │ +0001c100: 756d 6573 2074 6861 7420 796f 7572 2074 umes that your t │ │ │ │ │ +0001c110: 6572 6d69 6e61 6c20 656d 756c 6174 6f72 erminal emulator │ │ │ │ │ +0001c120: 2069 730a 636f 6d70 6174 6962 6c65 2077 is.compatible w │ │ │ │ │ +0001c130: 6974 6820 5654 3130 3020 6279 2064 6566 ith VT100 by def │ │ │ │ │ +0001c140: 6175 6c74 2e20 2054 6869 7320 6973 2074 ault. This is t │ │ │ │ │ +0001c150: 7275 6520 666f 7220 6d6f 7374 2074 6572 rue for most ter │ │ │ │ │ +0001c160: 6d69 6e61 6c0a 656d 756c 6174 6f72 7320 minal.emulators │ │ │ │ │ +0001c170: 6e6f 7761 6461 7973 2c20 6275 7420 796f nowadays, but yo │ │ │ │ │ +0001c180: 7520 7368 6f75 6c64 2070 6173 7320 7468 u should pass th │ │ │ │ │ +0001c190: 6520 6f70 7469 6f6e 2027 2d2d 6475 6d62 e option '--dumb │ │ │ │ │ +0001c1a0: 2720 746f 2074 6865 0a63 6f6d 6d61 6e64 ' to the.command │ │ │ │ │ +0001c1b0: 2069 6620 796f 7572 2074 6572 6d69 6e61 if your termina │ │ │ │ │ +0001c1c0: 6c20 656d 756c 6174 6f72 2069 7320 6e6f l emulator is no │ │ │ │ │ +0001c1d0: 7420 5654 3130 302d 636f 6d70 6174 6962 t VT100-compatib │ │ │ │ │ +0001c1e0: 6c65 206f 7220 696d 706c 656d 656e 7473 le or implements │ │ │ │ │ +0001c1f0: 0a66 6577 2056 5431 3030 2065 7363 6170 .few VT100 escap │ │ │ │ │ +0001c200: 6520 7365 7175 656e 6365 732e 2020 4966 e sequences. If │ │ │ │ │ +0001c210: 2079 6f75 2073 7065 6369 6679 2074 6869 you specify thi │ │ │ │ │ +0001c220: 7320 6f70 7469 6f6e 2074 6865 6e20 4752 s option then GR │ │ │ │ │ +0001c230: 5542 0a70 726f 7669 6465 7320 796f 7520 UB.provides you │ │ │ │ │ +0001c240: 7769 7468 2061 6e20 616c 7465 726e 6174 with an alternat │ │ │ │ │ +0001c250: 6976 6520 6d65 6e75 2069 6e74 6572 6661 ive menu interfa │ │ │ │ │ +0001c260: 6365 2c20 6265 6361 7573 6520 7468 6520 ce, because the │ │ │ │ │ +0001c270: 6e6f 726d 616c 206d 656e 750a 7265 7175 normal menu.requ │ │ │ │ │ +0001c280: 6972 6573 2073 6576 6572 616c 2066 616e ires several fan │ │ │ │ │ +0001c290: 6379 2066 6561 7475 7265 7320 6f66 2079 cy features of y │ │ │ │ │ +0001c2a0: 6f75 7220 7465 726d 696e 616c 2e0a 0a1f our terminal.... │ │ │ │ │ +0001c2b0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +0001c2c0: 2c20 204e 6f64 653a 2056 656e 646f 7220 , Node: Vendor │ │ │ │ │ +0001c2d0: 706f 7765 722d 6f6e 206b 6579 732c 2020 power-on keys, │ │ │ │ │ +0001c2e0: 4e65 7874 3a20 496d 6167 6573 2c20 2050 Next: Images, P │ │ │ │ │ +0001c2f0: 7265 763a 2053 6572 6961 6c20 7465 726d rev: Serial term │ │ │ │ │ +0001c300: 696e 616c 2c20 2055 703a 2054 6f70 0a0a inal, Up: Top.. │ │ │ │ │ +0001c310: 3130 2055 7369 6e67 2047 5255 4220 7769 10 Using GRUB wi │ │ │ │ │ +0001c320: 7468 2076 656e 646f 7220 706f 7765 722d th vendor power- │ │ │ │ │ +0001c330: 6f6e 206b 6579 730a 2a2a 2a2a 2a2a 2a2a on keys.******** │ │ │ │ │ 0001c340: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001c350: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a53 *************..S │ │ │ │ │ -0001c360: 6f6d 6520 6c61 7074 6f70 2076 656e 646f ome laptop vendo │ │ │ │ │ -0001c370: 7273 2070 726f 7669 6465 2061 6e20 6164 rs provide an ad │ │ │ │ │ -0001c380: 6469 7469 6f6e 616c 2070 6f77 6572 2d6f ditional power-o │ │ │ │ │ -0001c390: 6e20 6275 7474 6f6e 2077 6869 6368 2062 n button which b │ │ │ │ │ -0001c3a0: 6f6f 7473 0a61 6e6f 7468 6572 204f 532e oots.another OS. │ │ │ │ │ -0001c3b0: 2047 5255 4220 7375 7070 6f72 7473 2073 GRUB supports s │ │ │ │ │ -0001c3c0: 7563 6820 6275 7474 6f6e 7320 7769 7468 uch buttons with │ │ │ │ │ -0001c3d0: 2074 6865 2027 4752 5542 5f54 494d 454f the 'GRUB_TIMEO │ │ │ │ │ -0001c3e0: 5554 5f42 5554 544f 4e27 2c0a 2747 5255 UT_BUTTON',.'GRU │ │ │ │ │ -0001c3f0: 425f 5449 4d45 4f55 545f 5354 594c 455f B_TIMEOUT_STYLE_ │ │ │ │ │ -0001c400: 4255 5454 4f4e 272c 2027 4752 5542 5f44 BUTTON', 'GRUB_D │ │ │ │ │ -0001c410: 4546 4155 4c54 5f42 5554 544f 4e27 2c20 EFAULT_BUTTON', │ │ │ │ │ -0001c420: 616e 640a 2747 5255 425f 4255 5454 4f4e and.'GRUB_BUTTON │ │ │ │ │ -0001c430: 5f43 4d4f 535f 4144 4452 4553 5327 2076 _CMOS_ADDRESS' v │ │ │ │ │ -0001c440: 6172 6961 626c 6573 2069 6e20 6465 6661 ariables in defa │ │ │ │ │ -0001c450: 756c 742f 6772 7562 2028 2a6e 6f74 6520 ult/grub (*note │ │ │ │ │ -0001c460: 5369 6d70 6c65 0a63 6f6e 6669 6775 7261 Simple.configura │ │ │ │ │ -0001c470: 7469 6f6e 3a3a 292e 2020 2747 5255 425f tion::). 'GRUB_ │ │ │ │ │ -0001c480: 5449 4d45 4f55 545f 4255 5454 4f4e 272c TIMEOUT_BUTTON', │ │ │ │ │ -0001c490: 2027 4752 5542 5f54 494d 454f 5554 5f53 'GRUB_TIMEOUT_S │ │ │ │ │ -0001c4a0: 5459 4c45 5f42 5554 544f 4e27 2c0a 616e TYLE_BUTTON',.an │ │ │ │ │ -0001c4b0: 6420 2747 5255 425f 4445 4641 554c 545f d 'GRUB_DEFAULT_ │ │ │ │ │ -0001c4c0: 4255 5454 4f4e 2720 6172 6520 7573 6564 BUTTON' are used │ │ │ │ │ -0001c4d0: 2069 6e73 7465 6164 206f 6620 7468 6520 instead of the │ │ │ │ │ -0001c4e0: 636f 7272 6573 706f 6e64 696e 670a 7661 corresponding.va │ │ │ │ │ -0001c4f0: 7269 6162 6c65 7320 7769 7468 6f75 7420 riables without │ │ │ │ │ -0001c500: 7468 6520 275f 4255 5454 4f4e 2720 7375 the '_BUTTON' su │ │ │ │ │ -0001c510: 6666 6978 2077 6865 6e20 706f 7765 7265 ffix when powere │ │ │ │ │ -0001c520: 6420 6f6e 2075 7369 6e67 2074 6865 2073 d on using the s │ │ │ │ │ -0001c530: 7065 6369 616c 0a62 7574 746f 6e2e 2020 pecial.button. │ │ │ │ │ -0001c540: 2747 5255 425f 4255 5454 4f4e 5f43 4d4f 'GRUB_BUTTON_CMO │ │ │ │ │ -0001c550: 535f 4144 4452 4553 5327 2069 7320 7665 S_ADDRESS' is ve │ │ │ │ │ -0001c560: 6e64 6f72 2d73 7065 6369 6669 6320 616e ndor-specific an │ │ │ │ │ -0001c570: 6420 7061 7274 6961 6c6c 790a 6d6f 6465 d partially.mode │ │ │ │ │ -0001c580: 6c2d 7370 6563 6966 6963 2e20 2056 616c l-specific. Val │ │ │ │ │ -0001c590: 7565 7320 6b6e 6f77 6e20 746f 2074 6865 ues known to the │ │ │ │ │ -0001c5a0: 2047 5255 4220 7465 616d 2061 7265 3a0a GRUB team are:. │ │ │ │ │ -0001c5b0: 0a3c 4465 6c6c 2058 5053 204d 3133 3330 .. 121:3.. │ │ │ │ │ -0001c5e0: 2020 2020 3835 3a33 0a3c 4465 6c6c 204c 85:3.. │ │ │ │ │ -0001c600: 2020 2020 3835 3a33 0a3c 4173 7573 2045 85:3.. │ │ │ │ │ -0001c620: 2020 3834 3a31 2028 756e 636f 6e66 6972 84:1 (unconfir │ │ │ │ │ -0001c630: 6d65 6429 0a3c 4c45 4e4f 564f 2054 6869 med).. 101: │ │ │ │ │ -0001c660: 330a 0a20 2020 546f 2074 616b 6520 6675 3.. To take fu │ │ │ │ │ -0001c670: 6c6c 2061 6476 616e 7461 6765 206f 6620 ll advantage of │ │ │ │ │ -0001c680: 7468 6973 2066 756e 6374 696f 6e2c 2069 this function, i │ │ │ │ │ -0001c690: 6e73 7461 6c6c 2047 5255 4220 696e 746f nstall GRUB into │ │ │ │ │ -0001c6a0: 2074 6865 204d 4252 0a28 2a6e 6f74 6520 the MBR.(*note │ │ │ │ │ -0001c6b0: 496e 7374 616c 6c69 6e67 2047 5255 4220 Installing GRUB │ │ │ │ │ -0001c6c0: 7573 696e 6720 6772 7562 2d69 6e73 7461 using grub-insta │ │ │ │ │ -0001c6d0: 6c6c 3a3a 292e 0a0a 2020 2049 6620 796f ll::)... If yo │ │ │ │ │ -0001c6e0: 7520 6861 7665 2061 206c 6170 746f 7020 u have a laptop │ │ │ │ │ -0001c6f0: 7768 6963 6820 6861 7320 6120 7369 6d69 which has a simi │ │ │ │ │ -0001c700: 6c61 7220 6665 6174 7572 6520 616e 6420 lar feature and │ │ │ │ │ -0001c710: 6e6f 7420 696e 2074 6865 2061 626f 7665 not in the above │ │ │ │ │ -0001c720: 0a6c 6973 7420 636f 756c 6420 796f 7520 .list could you │ │ │ │ │ -0001c730: 6669 6775 7265 2079 6f75 7220 6164 6472 figure your addr │ │ │ │ │ -0001c740: 6573 7320 616e 6420 636f 6e74 7269 6275 ess and contribu │ │ │ │ │ -0001c750: 7465 3f20 2054 6f20 6469 7363 6f76 6572 te? To discover │ │ │ │ │ -0001c760: 2074 6865 0a61 6464 7265 7373 2064 6f20 the.address do │ │ │ │ │ -0001c770: 7468 6520 666f 6c6c 6f77 696e 673a 0a20 the following:. │ │ │ │ │ -0001c780: 2020 2a20 626f 6f74 206e 6f72 6d61 6c6c * boot normall │ │ │ │ │ -0001c790: 790a 2020 202a 2020 2020 2020 7375 646f y. * sudo │ │ │ │ │ -0001c7a0: 206d 6f64 7072 6f62 6520 6e76 7261 6d0a modprobe nvram. │ │ │ │ │ -0001c7b0: 2020 2020 2020 2020 2020 7375 646f 2063 sudo c │ │ │ │ │ -0001c7c0: 6174 202f 6465 762f 6e76 7261 6d20 7c20 at /dev/nvram | │ │ │ │ │ -0001c7d0: 7878 6420 3e20 6e6f 726d 616c 5f62 7574 xxd > normal_but │ │ │ │ │ -0001c7e0: 746f 6e2e 7478 740a 2020 202a 2062 6f6f ton.txt. * boo │ │ │ │ │ -0001c7f0: 7420 7573 696e 6720 7665 6e64 6f72 2062 t using vendor b │ │ │ │ │ -0001c800: 7574 746f 6e0a 2020 202a 2020 2020 2020 utton. * │ │ │ │ │ -0001c810: 7375 646f 206d 6f64 7072 6f62 6520 6e76 sudo modprobe nv │ │ │ │ │ -0001c820: 7261 6d0a 2020 2020 2020 2020 2020 7375 ram. su │ │ │ │ │ -0001c830: 646f 2063 6174 202f 6465 762f 6e76 7261 do cat /dev/nvra │ │ │ │ │ -0001c840: 6d20 7c20 7878 6420 3e20 6e6f 726d 616c m | xxd > normal │ │ │ │ │ -0001c850: 5f76 656e 646f 722e 7478 740a 0a20 2020 _vendor.txt.. │ │ │ │ │ -0001c860: 5468 656e 2063 6f6d 7061 7265 2074 6865 Then compare the │ │ │ │ │ -0001c870: 7365 2074 6578 7420 6669 6c65 7320 616e se text files an │ │ │ │ │ -0001c880: 6420 6669 6e64 2077 6865 7265 2061 2062 d find where a b │ │ │ │ │ -0001c890: 6974 2077 6173 2074 6f67 676c 6564 2e20 it was toggled. │ │ │ │ │ -0001c8a0: 2045 2e67 2e0a 696e 2063 6173 6520 6f66 E.g..in case of │ │ │ │ │ -0001c8b0: 2044 656c 6c20 5850 5320 6974 2077 6173 Dell XPS it was │ │ │ │ │ -0001c8c0: 3a0a 2020 2020 2062 7974 6520 3078 3437 :. byte 0x47 │ │ │ │ │ -0001c8d0: 3a20 3230 202d 2d3e 2032 380a 2020 2049 : 20 --> 28. I │ │ │ │ │ -0001c8e0: 7427 7320 6120 6269 7420 6e75 6d62 6572 t's a bit number │ │ │ │ │ -0001c8f0: 2033 2061 7320 7365 656e 2066 726f 6d20 3 as seen from │ │ │ │ │ -0001c900: 666f 6c6c 6f77 696e 6720 7461 626c 653a following table: │ │ │ │ │ -0001c910: 0a30 2020 2020 2020 2020 2020 2020 2020 .0 │ │ │ │ │ -0001c920: 3031 0a31 2020 2020 2020 2020 2020 2020 01.1 │ │ │ │ │ -0001c930: 2020 3032 0a32 2020 2020 2020 2020 2020 02.2 │ │ │ │ │ -0001c940: 2020 2020 3034 0a33 2020 2020 2020 2020 04.3 │ │ │ │ │ -0001c950: 2020 2020 2020 3038 0a34 2020 2020 2020 08.4 │ │ │ │ │ -0001c960: 2020 2020 2020 2020 3130 0a35 2020 2020 10.5 │ │ │ │ │ -0001c970: 2020 2020 2020 2020 2020 3230 0a36 2020 20.6 │ │ │ │ │ -0001c980: 2020 2020 2020 2020 2020 2020 3430 0a37 40.7 │ │ │ │ │ -0001c990: 2020 2020 2020 2020 2020 2020 2020 3830 80 │ │ │ │ │ -0001c9a0: 0a0a 2020 2030 7834 3720 6973 2064 6563 .. 0x47 is dec │ │ │ │ │ -0001c9b0: 696d 616c 2037 312e 2020 4c69 6e75 7820 imal 71. Linux │ │ │ │ │ -0001c9c0: 6e76 7261 6d20 696d 706c 656d 656e 7461 nvram implementa │ │ │ │ │ -0001c9d0: 7469 6f6e 2063 7574 7320 6669 7273 7420 tion cuts first │ │ │ │ │ -0001c9e0: 3134 2062 7974 6573 0a6f 6620 434d 4f53 14 bytes.of CMOS │ │ │ │ │ -0001c9f0: 2e20 536f 2074 6865 2072 6561 6c20 6279 . So the real by │ │ │ │ │ -0001ca00: 7465 2061 6464 7265 7373 2069 6e20 434d te address in CM │ │ │ │ │ -0001ca10: 4f53 2069 7320 3731 2b31 343d 3835 2053 OS is 71+14=85 S │ │ │ │ │ -0001ca20: 6f20 636f 6d70 6c65 7465 0a61 6464 7265 o complete.addre │ │ │ │ │ -0001ca30: 7373 2069 7320 3835 3a33 0a0a 1f0a 4669 ss is 85:3....Fi │ │ │ │ │ -0001ca40: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -0001ca50: 4e6f 6465 3a20 496d 6167 6573 2c20 204e Node: Images, N │ │ │ │ │ -0001ca60: 6578 743a 2043 6f72 6520 696d 6167 6520 ext: Core image │ │ │ │ │ -0001ca70: 7369 7a65 206c 696d 6974 6174 696f 6e2c size limitation, │ │ │ │ │ -0001ca80: 2020 5072 6576 3a20 5665 6e64 6f72 2070 Prev: Vendor p │ │ │ │ │ -0001ca90: 6f77 6572 2d6f 6e20 6b65 7973 2c20 2055 ower-on keys, U │ │ │ │ │ -0001caa0: 703a 2054 6f70 0a0a 3131 2047 5255 4220 p: Top..11 GRUB │ │ │ │ │ -0001cab0: 696d 6167 6520 6669 6c65 730a 2a2a 2a2a image files.**** │ │ │ │ │ -0001cac0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ -0001cad0: 0a47 5255 4220 636f 6e73 6973 7473 206f .GRUB consists o │ │ │ │ │ -0001cae0: 6620 7365 7665 7261 6c20 696d 6167 6573 f several images │ │ │ │ │ -0001caf0: 3a20 6120 7661 7269 6574 7920 6f66 2062 : a variety of b │ │ │ │ │ -0001cb00: 6f6f 7473 7472 6170 2069 6d61 6765 7320 ootstrap images │ │ │ │ │ -0001cb10: 666f 720a 7374 6172 7469 6e67 2047 5255 for.starting GRU │ │ │ │ │ -0001cb20: 4220 696e 2076 6172 696f 7573 2077 6179 B in various way │ │ │ │ │ -0001cb30: 732c 2061 206b 6572 6e65 6c20 696d 6167 s, a kernel imag │ │ │ │ │ -0001cb40: 652c 2061 6e64 2061 2073 6574 206f 6620 e, and a set of │ │ │ │ │ -0001cb50: 6d6f 6475 6c65 730a 7768 6963 6820 6172 modules.which ar │ │ │ │ │ -0001cb60: 6520 636f 6d62 696e 6564 2077 6974 6820 e combined with │ │ │ │ │ -0001cb70: 7468 6520 6b65 726e 656c 2069 6d61 6765 the kernel image │ │ │ │ │ -0001cb80: 2074 6f20 666f 726d 2061 2063 6f72 6520 to form a core │ │ │ │ │ -0001cb90: 696d 6167 652e 2020 4865 7265 2069 730a image. Here is. │ │ │ │ │ -0001cba0: 6120 7368 6f72 7420 6f76 6572 7669 6577 a short overview │ │ │ │ │ -0001cbb0: 206f 6620 7468 656d 2e0a 0a27 626f 6f74 of them...'boot │ │ │ │ │ -0001cbc0: 2e69 6d67 270a 2020 2020 204f 6e20 5043 .img'. On PC │ │ │ │ │ -0001cbd0: 2042 494f 5320 7379 7374 656d 732c 2074 BIOS systems, t │ │ │ │ │ -0001cbe0: 6869 7320 696d 6167 6520 6973 2074 6865 his image is the │ │ │ │ │ -0001cbf0: 2066 6972 7374 2070 6172 7420 6f66 2047 first part of G │ │ │ │ │ -0001cc00: 5255 4220 746f 2073 7461 7274 2e0a 2020 RUB to start.. │ │ │ │ │ -0001cc10: 2020 2049 7420 6973 2077 7269 7474 656e It is written │ │ │ │ │ -0001cc20: 2074 6f20 6120 6d61 7374 6572 2062 6f6f to a master boo │ │ │ │ │ -0001cc30: 7420 7265 636f 7264 2028 4d42 5229 206f t record (MBR) o │ │ │ │ │ -0001cc40: 7220 746f 2074 6865 2062 6f6f 7420 7365 r to the boot se │ │ │ │ │ -0001cc50: 6374 6f72 0a20 2020 2020 6f66 2061 2070 ctor. of a p │ │ │ │ │ -0001cc60: 6172 7469 7469 6f6e 2e20 2042 6563 6175 artition. Becau │ │ │ │ │ -0001cc70: 7365 2061 2050 4320 626f 6f74 2073 6563 se a PC boot sec │ │ │ │ │ -0001cc80: 746f 7220 6973 2035 3132 2062 7974 6573 tor is 512 bytes │ │ │ │ │ -0001cc90: 2c20 7468 6520 7369 7a65 206f 660a 2020 , the size of. │ │ │ │ │ -0001cca0: 2020 2074 6869 7320 696d 6167 6520 6973 this image is │ │ │ │ │ -0001ccb0: 2065 7861 6374 6c79 2035 3132 2062 7974 exactly 512 byt │ │ │ │ │ -0001ccc0: 6573 2e0a 0a20 2020 2020 5468 6520 736f es... The so │ │ │ │ │ -0001ccd0: 6c65 2066 756e 6374 696f 6e20 6f66 2027 le function of ' │ │ │ │ │ -0001cce0: 626f 6f74 2e69 6d67 2720 6973 2074 6f20 boot.img' is to │ │ │ │ │ -0001ccf0: 7265 6164 2074 6865 2066 6972 7374 2073 read the first s │ │ │ │ │ -0001cd00: 6563 746f 7220 6f66 2074 6865 0a20 2020 ector of the. │ │ │ │ │ -0001cd10: 2020 636f 7265 2069 6d61 6765 2066 726f core image fro │ │ │ │ │ -0001cd20: 6d20 6120 6c6f 6361 6c20 6469 736b 2061 m a local disk a │ │ │ │ │ -0001cd30: 6e64 206a 756d 7020 746f 2069 742e 2020 nd jump to it. │ │ │ │ │ -0001cd40: 4265 6361 7573 6520 6f66 2074 6865 2073 Because of the s │ │ │ │ │ -0001cd50: 697a 650a 2020 2020 2072 6573 7472 6963 ize. restric │ │ │ │ │ -0001cd60: 7469 6f6e 2c20 2762 6f6f 742e 696d 6727 tion, 'boot.img' │ │ │ │ │ -0001cd70: 2063 616e 6e6f 7420 756e 6465 7273 7461 cannot understa │ │ │ │ │ -0001cd80: 6e64 2061 6e79 2066 696c 6520 7379 7374 nd any file syst │ │ │ │ │ -0001cd90: 656d 0a20 2020 2020 7374 7275 6374 7572 em. structur │ │ │ │ │ -0001cda0: 652c 2073 6f20 2767 7275 622d 696e 7374 e, so 'grub-inst │ │ │ │ │ -0001cdb0: 616c 6c27 2068 6172 6463 6f64 6573 2074 all' hardcodes t │ │ │ │ │ -0001cdc0: 6865 206c 6f63 6174 696f 6e20 6f66 2074 he location of t │ │ │ │ │ -0001cdd0: 6865 2066 6972 7374 0a20 2020 2020 7365 he first. se │ │ │ │ │ -0001cde0: 6374 6f72 206f 6620 7468 6520 636f 7265 ctor of the core │ │ │ │ │ -0001cdf0: 2069 6d61 6765 2069 6e74 6f20 2762 6f6f image into 'boo │ │ │ │ │ -0001ce00: 742e 696d 6727 2077 6865 6e20 696e 7374 t.img' when inst │ │ │ │ │ -0001ce10: 616c 6c69 6e67 2047 5255 422e 0a0a 2764 alling GRUB...'d │ │ │ │ │ -0001ce20: 6973 6b62 6f6f 742e 696d 6727 0a20 2020 iskboot.img'. │ │ │ │ │ -0001ce30: 2020 5468 6973 2069 6d61 6765 2069 7320 This image is │ │ │ │ │ -0001ce40: 7573 6564 2061 7320 7468 6520 6669 7273 used as the firs │ │ │ │ │ -0001ce50: 7420 7365 6374 6f72 206f 6620 7468 6520 t sector of the │ │ │ │ │ -0001ce60: 636f 7265 2069 6d61 6765 2077 6865 6e0a core image when. │ │ │ │ │ -0001ce70: 2020 2020 2062 6f6f 7469 6e67 2066 726f booting fro │ │ │ │ │ -0001ce80: 6d20 6120 6861 7264 2064 6973 6b2e 2020 m a hard disk. │ │ │ │ │ -0001ce90: 4974 2072 6561 6473 2074 6865 2072 6573 It reads the res │ │ │ │ │ -0001cea0: 7420 6f66 2074 6865 2063 6f72 6520 696d t of the core im │ │ │ │ │ -0001ceb0: 6167 6520 696e 746f 0a20 2020 2020 6d65 age into. me │ │ │ │ │ -0001cec0: 6d6f 7279 2061 6e64 2073 7461 7274 7320 mory and starts │ │ │ │ │ -0001ced0: 7468 6520 6b65 726e 656c 2e20 2053 696e the kernel. Sin │ │ │ │ │ -0001cee0: 6365 2066 696c 6520 7379 7374 656d 2068 ce file system h │ │ │ │ │ -0001cef0: 616e 646c 696e 6720 6973 206e 6f74 0a20 andling is not. │ │ │ │ │ -0001cf00: 2020 2020 7965 7420 6176 6169 6c61 626c yet availabl │ │ │ │ │ -0001cf10: 652c 2069 7420 656e 636f 6465 7320 7468 e, it encodes th │ │ │ │ │ -0001cf20: 6520 6c6f 6361 7469 6f6e 206f 6620 7468 e location of th │ │ │ │ │ -0001cf30: 6520 636f 7265 2069 6d61 6765 2075 7369 e core image usi │ │ │ │ │ -0001cf40: 6e67 2061 0a20 2020 2020 626c 6f63 6b20 ng a. block │ │ │ │ │ -0001cf50: 6c69 7374 2066 6f72 6d61 742e 0a0a 2763 list format...'c │ │ │ │ │ -0001cf60: 6462 6f6f 742e 696d 6727 0a20 2020 2020 dboot.img'. │ │ │ │ │ -0001cf70: 5468 6973 2069 6d61 6765 2069 7320 7573 This image is us │ │ │ │ │ -0001cf80: 6564 2061 7320 7468 6520 6669 7273 7420 ed as the first │ │ │ │ │ -0001cf90: 7365 6374 6f72 206f 6620 7468 6520 636f sector of the co │ │ │ │ │ -0001cfa0: 7265 2069 6d61 6765 2077 6865 6e0a 2020 re image when. │ │ │ │ │ -0001cfb0: 2020 2062 6f6f 7469 6e67 2066 726f 6d20 booting from │ │ │ │ │ -0001cfc0: 6120 4344 2d52 4f4d 2064 7269 7665 2e20 a CD-ROM drive. │ │ │ │ │ -0001cfd0: 2049 7420 7065 7266 6f72 6d73 2061 2073 It performs a s │ │ │ │ │ -0001cfe0: 696d 696c 6172 2066 756e 6374 696f 6e20 imilar function │ │ │ │ │ -0001cff0: 746f 0a20 2020 2020 2764 6973 6b62 6f6f to. 'diskboo │ │ │ │ │ -0001d000: 742e 696d 6727 2e0a 0a27 7078 6562 6f6f t.img'...'pxeboo │ │ │ │ │ -0001d010: 742e 696d 6727 0a20 2020 2020 5468 6973 t.img'. This │ │ │ │ │ -0001d020: 2069 6d61 6765 2069 7320 7573 6564 2061 image is used a │ │ │ │ │ -0001d030: 7320 7468 6520 7374 6172 7420 6f66 2074 s the start of t │ │ │ │ │ -0001d040: 6865 2063 6f72 6520 696d 6167 6520 7768 he core image wh │ │ │ │ │ -0001d050: 656e 2062 6f6f 7469 6e67 2066 726f 6d0a en booting from. │ │ │ │ │ -0001d060: 2020 2020 2074 6865 206e 6574 776f 726b the network │ │ │ │ │ -0001d070: 2075 7369 6e67 2050 5845 2e20 2a4e 6f74 using PXE. *Not │ │ │ │ │ -0001d080: 6520 4e65 7477 6f72 6b3a 3a2e 0a0a 276c e Network::...'l │ │ │ │ │ -0001d090: 6e78 626f 6f74 2e69 6d67 270a 2020 2020 nxboot.img'. │ │ │ │ │ -0001d0a0: 2054 6869 7320 696d 6167 6520 6d61 7920 This image may │ │ │ │ │ -0001d0b0: 6265 2070 6c61 6365 6420 6174 2074 6865 be placed at the │ │ │ │ │ -0001d0c0: 2073 7461 7274 206f 6620 7468 6520 636f start of the co │ │ │ │ │ -0001d0d0: 7265 2069 6d61 6765 2069 6e20 6f72 6465 re image in orde │ │ │ │ │ -0001d0e0: 7220 746f 0a20 2020 2020 6d61 6b65 2047 r to. make G │ │ │ │ │ -0001d0f0: 5255 4220 6c6f 6f6b 2065 6e6f 7567 6820 RUB look enough │ │ │ │ │ -0001d100: 6c69 6b65 2061 204c 696e 7578 206b 6572 like a Linux ker │ │ │ │ │ -0001d110: 6e65 6c20 7468 6174 2069 7420 6361 6e20 nel that it can │ │ │ │ │ -0001d120: 6265 2062 6f6f 7465 6420 6279 0a20 2020 be booted by. │ │ │ │ │ -0001d130: 2020 4c49 4c4f 2075 7369 6e67 2061 6e20 LILO using an │ │ │ │ │ -0001d140: 2769 6d61 6765 3d27 2073 6563 7469 6f6e 'image=' section │ │ │ │ │ -0001d150: 2e0a 0a27 6b65 726e 656c 2e69 6d67 270a ...'kernel.img'. │ │ │ │ │ -0001d160: 2020 2020 2054 6869 7320 696d 6167 6520 This image │ │ │ │ │ -0001d170: 636f 6e74 6169 6e73 2047 5255 4227 7320 contains GRUB's │ │ │ │ │ -0001d180: 6261 7369 6320 7275 6e2d 7469 6d65 2066 basic run-time f │ │ │ │ │ -0001d190: 6163 696c 6974 6965 733a 2066 7261 6d65 acilities: frame │ │ │ │ │ -0001d1a0: 776f 726b 730a 2020 2020 2066 6f72 2064 works. for d │ │ │ │ │ -0001d1b0: 6576 6963 6520 616e 6420 6669 6c65 2068 evice and file h │ │ │ │ │ -0001d1c0: 616e 646c 696e 672c 2065 6e76 6972 6f6e andling, environ │ │ │ │ │ -0001d1d0: 6d65 6e74 2076 6172 6961 626c 6573 2c20 ment variables, │ │ │ │ │ -0001d1e0: 7468 6520 7265 7363 7565 0a20 2020 2020 the rescue. │ │ │ │ │ -0001d1f0: 6d6f 6465 2063 6f6d 6d61 6e64 2d6c 696e mode command-lin │ │ │ │ │ -0001d200: 6520 7061 7273 6572 2c20 616e 6420 736f e parser, and so │ │ │ │ │ -0001d210: 206f 6e2e 2020 4974 2069 7320 7261 7265 on. It is rare │ │ │ │ │ -0001d220: 6c79 2075 7365 6420 6469 7265 6374 6c79 ly used directly │ │ │ │ │ -0001d230: 2c0a 2020 2020 2062 7574 2069 7320 6275 ,. but is bu │ │ │ │ │ -0001d240: 696c 7420 696e 746f 2061 6c6c 2063 6f72 ilt into all cor │ │ │ │ │ -0001d250: 6520 696d 6167 6573 2e0a 0a27 636f 7265 e images...'core │ │ │ │ │ -0001d260: 2e69 6d67 270a 2020 2020 2054 6869 7320 .img'. This │ │ │ │ │ -0001d270: 6973 2074 6865 2063 6f72 6520 696d 6167 is the core imag │ │ │ │ │ -0001d280: 6520 6f66 2047 5255 422e 2049 7420 6973 e of GRUB. It is │ │ │ │ │ -0001d290: 2062 7569 6c74 2064 796e 616d 6963 616c built dynamical │ │ │ │ │ -0001d2a0: 6c79 2066 726f 6d20 7468 650a 2020 2020 ly from the. │ │ │ │ │ -0001d2b0: 206b 6572 6e65 6c20 696d 6167 6520 616e kernel image an │ │ │ │ │ -0001d2c0: 6420 616e 2061 7262 6974 7261 7279 206c d an arbitrary l │ │ │ │ │ -0001d2d0: 6973 7420 6f66 206d 6f64 756c 6573 2062 ist of modules b │ │ │ │ │ -0001d2e0: 7920 7468 6520 2767 7275 622d 6d6b 696d y the 'grub-mkim │ │ │ │ │ -0001d2f0: 6167 6527 0a20 2020 2020 7072 6f67 7261 age'. progra │ │ │ │ │ -0001d300: 6d2e 2020 5573 7561 6c6c 792c 2069 7420 m. Usually, it │ │ │ │ │ -0001d310: 636f 6e74 6169 6e73 2065 6e6f 7567 6820 contains enough │ │ │ │ │ -0001d320: 6d6f 6475 6c65 7320 746f 2061 6363 6573 modules to acces │ │ │ │ │ -0001d330: 730a 2020 2020 2027 2f62 6f6f 742f 6772 s. '/boot/gr │ │ │ │ │ -0001d340: 7562 272c 2061 6e64 206c 6f61 6473 2065 ub', and loads e │ │ │ │ │ -0001d350: 7665 7279 7468 696e 6720 656c 7365 2028 verything else ( │ │ │ │ │ -0001d360: 696e 636c 7564 696e 6720 6d65 6e75 2068 including menu h │ │ │ │ │ -0001d370: 616e 646c 696e 672c 0a20 2020 2020 7468 andling,. th │ │ │ │ │ -0001d380: 6520 6162 696c 6974 7920 746f 206c 6f61 e ability to loa │ │ │ │ │ -0001d390: 6420 7461 7267 6574 206f 7065 7261 7469 d target operati │ │ │ │ │ -0001d3a0: 6e67 2073 7973 7465 6d73 2c20 616e 6420 ng systems, and │ │ │ │ │ -0001d3b0: 736f 206f 6e29 2066 726f 6d20 7468 650a so on) from the. │ │ │ │ │ -0001d3c0: 2020 2020 2066 696c 6520 7379 7374 656d file system │ │ │ │ │ -0001d3d0: 2061 7420 7275 6e2d 7469 6d65 2e20 2054 at run-time. T │ │ │ │ │ -0001d3e0: 6865 206d 6f64 756c 6172 2064 6573 6967 he modular desig │ │ │ │ │ -0001d3f0: 6e20 616c 6c6f 7773 2074 6865 2063 6f72 n allows the cor │ │ │ │ │ -0001d400: 6520 696d 6167 650a 2020 2020 2074 6f20 e image. to │ │ │ │ │ -0001d410: 6265 206b 6570 7420 736d 616c 6c2c 2073 be kept small, s │ │ │ │ │ -0001d420: 696e 6365 2074 6865 2061 7265 6173 206f ince the areas o │ │ │ │ │ -0001d430: 6620 6469 736b 2077 6865 7265 2069 7420 f disk where it │ │ │ │ │ -0001d440: 6d75 7374 2062 650a 2020 2020 2069 6e73 must be. ins │ │ │ │ │ -0001d450: 7461 6c6c 6564 2061 7265 206f 6674 656e talled are often │ │ │ │ │ -0001d460: 2061 7320 736d 616c 6c20 6173 2033 324b as small as 32K │ │ │ │ │ -0001d470: 422e 0a0a 2020 2020 202a 4e6f 7465 2042 B... *Note B │ │ │ │ │ -0001d480: 494f 5320 696e 7374 616c 6c61 7469 6f6e IOS installation │ │ │ │ │ -0001d490: 3a3a 2c20 666f 7220 6465 7461 696c 7320 ::, for details │ │ │ │ │ -0001d4a0: 6f6e 2077 6865 7265 2074 6865 2063 6f72 on where the cor │ │ │ │ │ -0001d4b0: 6520 696d 6167 6520 6361 6e0a 2020 2020 e image can. │ │ │ │ │ -0001d4c0: 2062 6520 696e 7374 616c 6c65 6420 6f6e be installed on │ │ │ │ │ -0001d4d0: 2050 4320 7379 7374 656d 732e 0a0a 272a PC systems...'* │ │ │ │ │ -0001d4e0: 2e6d 6f64 270a 2020 2020 2045 7665 7279 .mod'. Every │ │ │ │ │ -0001d4f0: 7468 696e 6720 656c 7365 2069 6e20 4752 thing else in GR │ │ │ │ │ -0001d500: 5542 2072 6573 6964 6573 2069 6e20 6479 UB resides in dy │ │ │ │ │ -0001d510: 6e61 6d69 6361 6c6c 7920 6c6f 6164 6162 namically loadab │ │ │ │ │ -0001d520: 6c65 206d 6f64 756c 6573 2e0a 2020 2020 le modules.. │ │ │ │ │ -0001d530: 2054 6865 7365 2061 7265 206f 6674 656e These are often │ │ │ │ │ -0001d540: 206c 6f61 6465 6420 6175 746f 6d61 7469 loaded automati │ │ │ │ │ -0001d550: 6361 6c6c 792c 206f 7220 6275 696c 7420 cally, or built │ │ │ │ │ -0001d560: 696e 746f 2074 6865 2063 6f72 6520 696d into the core im │ │ │ │ │ -0001d570: 6167 650a 2020 2020 2069 6620 7468 6579 age. if they │ │ │ │ │ -0001d580: 2061 7265 2065 7373 656e 7469 616c 2c20 are essential, │ │ │ │ │ -0001d590: 6275 7420 6d61 7920 616c 736f 2062 6520 but may also be │ │ │ │ │ -0001d5a0: 6c6f 6164 6564 206d 616e 7561 6c6c 7920 loaded manually │ │ │ │ │ -0001d5b0: 7573 696e 6720 7468 650a 2020 2020 2027 using the. ' │ │ │ │ │ -0001d5c0: 696e 736d 6f64 2720 636f 6d6d 616e 6420 insmod' command │ │ │ │ │ -0001d5d0: 282a 6e6f 7465 2069 6e73 6d6f 643a 3a29 (*note insmod::) │ │ │ │ │ -0001d5e0: 2e0a 0a46 6f72 2047 5255 4220 4c65 6761 ...For GRUB Lega │ │ │ │ │ -0001d5f0: 6379 2075 7365 7273 0a3d 3d3d 3d3d 3d3d cy users.======= │ │ │ │ │ -0001d600: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -0001d610: 4752 5542 2032 2068 6173 2061 2064 6966 GRUB 2 has a dif │ │ │ │ │ -0001d620: 6665 7265 6e74 2064 6573 6967 6e20 6672 ferent design fr │ │ │ │ │ -0001d630: 6f6d 2047 5255 4220 4c65 6761 6379 2c20 om GRUB Legacy, │ │ │ │ │ -0001d640: 616e 6420 736f 2063 6f72 7265 7370 6f6e and so correspon │ │ │ │ │ -0001d650: 6465 6e63 6573 0a77 6974 6820 7468 6520 dences.with the │ │ │ │ │ -0001d660: 696d 6167 6573 2069 7420 7573 6564 2063 images it used c │ │ │ │ │ -0001d670: 616e 6e6f 7420 6265 2065 7861 6374 2e20 annot be exact. │ │ │ │ │ -0001d680: 204e 6576 6572 7468 656c 6573 732c 2047 Nevertheless, G │ │ │ │ │ -0001d690: 5255 4220 4c65 6761 6379 0a75 7365 7273 RUB Legacy.users │ │ │ │ │ -0001d6a0: 206f 6674 656e 2061 736b 2071 7565 7374 often ask quest │ │ │ │ │ -0001d6b0: 696f 6e73 2069 6e20 7468 6520 7465 726d ions in the term │ │ │ │ │ -0001d6c0: 7320 7468 6579 2061 7265 2066 616d 696c s they are famil │ │ │ │ │ -0001d6d0: 6961 7220 7769 7468 2c20 616e 6420 736f iar with, and so │ │ │ │ │ -0001d6e0: 0a68 6572 6520 6973 2061 2062 7269 6566 .here is a brief │ │ │ │ │ -0001d6f0: 2067 7569 6465 2074 6f20 686f 7720 4752 guide to how GR │ │ │ │ │ -0001d700: 5542 2032 2773 2069 6d61 6765 7320 7265 UB 2's images re │ │ │ │ │ -0001d710: 6c61 7465 2074 6f20 7468 6174 2e0a 0a27 late to that...' │ │ │ │ │ -0001d720: 7374 6167 6531 270a 2020 2020 2053 7461 stage1'. Sta │ │ │ │ │ -0001d730: 6765 2031 2066 726f 6d20 4752 5542 204c ge 1 from GRUB L │ │ │ │ │ -0001d740: 6567 6163 7920 7761 7320 7665 7279 2073 egacy was very s │ │ │ │ │ -0001d750: 696d 696c 6172 2074 6f20 2762 6f6f 742e imilar to 'boot. │ │ │ │ │ -0001d760: 696d 6727 2069 6e20 4752 5542 2032 2c0a img' in GRUB 2,. │ │ │ │ │ -0001d770: 2020 2020 2061 6e64 2074 6865 7920 7365 and they se │ │ │ │ │ -0001d780: 7276 6520 7468 6520 7361 6d65 2066 756e rve the same fun │ │ │ │ │ -0001d790: 6374 696f 6e2e 0a0a 272a 5f73 7461 6765 ction...'*_stage │ │ │ │ │ -0001d7a0: 315f 3527 0a20 2020 2020 496e 2047 5255 1_5'. In GRU │ │ │ │ │ -0001d7b0: 4220 4c65 6761 6379 2c20 5374 6167 6520 B Legacy, Stage │ │ │ │ │ -0001d7c0: 312e 3527 7320 6675 6e63 7469 6f6e 2077 1.5's function w │ │ │ │ │ -0001d7d0: 6173 2074 6f20 696e 636c 7564 6520 656e as to include en │ │ │ │ │ -0001d7e0: 6f75 6768 0a20 2020 2020 6669 6c65 7379 ough. filesy │ │ │ │ │ -0001d7f0: 7374 656d 2063 6f64 6520 746f 2061 6c6c stem code to all │ │ │ │ │ -0001d800: 6f77 2074 6865 206d 7563 6820 6c61 7267 ow the much larg │ │ │ │ │ -0001d810: 6572 2053 7461 6765 2032 2074 6f20 6265 er Stage 2 to be │ │ │ │ │ -0001d820: 2072 6561 6420 6672 6f6d 2061 6e0a 2020 read from an. │ │ │ │ │ -0001d830: 2020 206f 7264 696e 6172 7920 6669 6c65 ordinary file │ │ │ │ │ -0001d840: 7379 7374 656d 2e20 2049 6e20 7468 6973 system. In this │ │ │ │ │ -0001d850: 2072 6573 7065 6374 2c20 6974 7320 6675 respect, its fu │ │ │ │ │ -0001d860: 6e63 7469 6f6e 2077 6173 2073 696d 696c nction was simil │ │ │ │ │ -0001d870: 6172 2074 6f0a 2020 2020 2027 636f 7265 ar to. 'core │ │ │ │ │ -0001d880: 2e69 6d67 2720 696e 2047 5255 4220 322e .img' in GRUB 2. │ │ │ │ │ -0001d890: 2020 486f 7765 7665 722c 2027 636f 7265 However, 'core │ │ │ │ │ -0001d8a0: 2e69 6d67 2720 6973 206d 7563 6820 6d6f .img' is much mo │ │ │ │ │ -0001d8b0: 7265 2063 6170 6162 6c65 0a20 2020 2020 re capable. │ │ │ │ │ -0001d8c0: 7468 616e 2053 7461 6765 2031 2e35 2077 than Stage 1.5 w │ │ │ │ │ -0001d8d0: 6173 3b20 7369 6e63 6520 6974 206f 6666 as; since it off │ │ │ │ │ -0001d8e0: 6572 7320 6120 7265 7363 7565 2073 6865 ers a rescue she │ │ │ │ │ -0001d8f0: 6c6c 2c20 6974 2069 7320 736f 6d65 7469 ll, it is someti │ │ │ │ │ -0001d900: 6d65 730a 2020 2020 2070 6f73 7369 626c mes. possibl │ │ │ │ │ -0001d910: 6520 746f 2072 6563 6f76 6572 206d 616e e to recover man │ │ │ │ │ -0001d920: 7561 6c6c 7920 696e 2074 6865 2065 7665 ually in the eve │ │ │ │ │ -0001d930: 6e74 2074 6861 7420 6974 2069 7320 756e nt that it is un │ │ │ │ │ -0001d940: 6162 6c65 2074 6f20 6c6f 6164 0a20 2020 able to load. │ │ │ │ │ -0001d950: 2020 616e 7920 6f74 6865 7220 6d6f 6475 any other modu │ │ │ │ │ -0001d960: 6c65 732c 2066 6f72 2065 7861 6d70 6c65 les, for example │ │ │ │ │ -0001d970: 2069 6620 7061 7274 6974 696f 6e20 6e75 if partition nu │ │ │ │ │ -0001d980: 6d62 6572 7320 6861 7665 2063 6861 6e67 mbers have chang │ │ │ │ │ -0001d990: 6564 2e0a 2020 2020 2027 636f 7265 2e69 ed.. 'core.i │ │ │ │ │ -0001d9a0: 6d67 2720 6973 2062 7569 6c74 2069 6e20 mg' is built in │ │ │ │ │ -0001d9b0: 6120 6d6f 7265 2066 6c65 7869 626c 6520 a more flexible │ │ │ │ │ -0001d9c0: 7761 792c 2061 6c6c 6f77 696e 6720 4752 way, allowing GR │ │ │ │ │ -0001d9d0: 5542 2032 2074 6f0a 2020 2020 2073 7570 UB 2 to. sup │ │ │ │ │ -0001d9e0: 706f 7274 2072 6561 6469 6e67 206d 6f64 port reading mod │ │ │ │ │ -0001d9f0: 756c 6573 2066 726f 6d20 6164 7661 6e63 ules from advanc │ │ │ │ │ -0001da00: 6564 2064 6973 6b20 7479 7065 7320 7375 ed disk types su │ │ │ │ │ -0001da10: 6368 2061 7320 4c56 4d20 616e 640a 2020 ch as LVM and. │ │ │ │ │ -0001da20: 2020 2052 4149 442e 0a0a 2020 2020 2047 RAID... G │ │ │ │ │ -0001da30: 5255 4220 4c65 6761 6379 2063 6f75 6c64 RUB Legacy could │ │ │ │ │ -0001da40: 2072 756e 2077 6974 6820 6f6e 6c79 2053 run with only S │ │ │ │ │ -0001da50: 7461 6765 2031 2061 6e64 2053 7461 6765 tage 1 and Stage │ │ │ │ │ -0001da60: 2032 2069 6e20 736f 6d65 206c 696d 6974 2 in some limit │ │ │ │ │ -0001da70: 6564 0a20 2020 2020 636f 6e66 6967 7572 ed. configur │ │ │ │ │ -0001da80: 6174 696f 6e73 2c20 7768 696c 6520 4752 ations, while GR │ │ │ │ │ -0001da90: 5542 2032 2072 6571 7569 7265 7320 2763 UB 2 requires 'c │ │ │ │ │ -0001daa0: 6f72 652e 696d 6727 2061 6e64 2063 616e ore.img' and can │ │ │ │ │ -0001dab0: 6e6f 7420 776f 726b 0a20 2020 2020 7769 not work. wi │ │ │ │ │ -0001dac0: 7468 6f75 7420 6974 2e0a 0a27 7374 6167 thout it...'stag │ │ │ │ │ -0001dad0: 6532 270a 2020 2020 2047 5255 4220 3220 e2'. GRUB 2 │ │ │ │ │ -0001dae0: 6861 7320 6e6f 2073 696e 676c 6520 5374 has no single St │ │ │ │ │ -0001daf0: 6167 6520 3220 696d 6167 652e 2020 496e age 2 image. In │ │ │ │ │ -0001db00: 7374 6561 642c 2069 7420 6c6f 6164 7320 stead, it loads │ │ │ │ │ -0001db10: 6d6f 6475 6c65 7320 6672 6f6d 0a20 2020 modules from. │ │ │ │ │ -0001db20: 2020 272f 626f 6f74 2f67 7275 6227 2061 '/boot/grub' a │ │ │ │ │ -0001db30: 7420 7275 6e2d 7469 6d65 2e0a 0a27 7374 t run-time...'st │ │ │ │ │ -0001db40: 6167 6532 5f65 6c74 6f72 6974 6f27 0a20 age2_eltorito'. │ │ │ │ │ -0001db50: 2020 2020 496e 2047 5255 4220 322c 2069 In GRUB 2, i │ │ │ │ │ -0001db60: 6d61 6765 7320 666f 7220 626f 6f74 696e mages for bootin │ │ │ │ │ -0001db70: 6720 6672 6f6d 2043 442d 524f 4d20 6472 g from CD-ROM dr │ │ │ │ │ -0001db80: 6976 6573 2061 7265 206e 6f77 0a20 2020 ives are now. │ │ │ │ │ -0001db90: 2020 636f 6e73 7472 7563 7465 6420 7573 constructed us │ │ │ │ │ -0001dba0: 696e 6720 2763 6462 6f6f 742e 696d 6727 ing 'cdboot.img' │ │ │ │ │ -0001dbb0: 2061 6e64 2027 636f 7265 2e69 6d67 272c and 'core.img', │ │ │ │ │ -0001dbc0: 206d 616b 696e 6720 7375 7265 2074 6861 making sure tha │ │ │ │ │ -0001dbd0: 7420 7468 650a 2020 2020 2063 6f72 6520 t the. core │ │ │ │ │ -0001dbe0: 696d 6167 6520 636f 6e74 6169 6e73 2074 image contains t │ │ │ │ │ -0001dbf0: 6865 2027 6973 6f39 3636 3027 206d 6f64 he 'iso9660' mod │ │ │ │ │ -0001dc00: 756c 652e 2020 4974 2069 7320 7573 7561 ule. It is usua │ │ │ │ │ -0001dc10: 6c6c 7920 6265 7374 2074 6f0a 2020 2020 lly best to. │ │ │ │ │ -0001dc20: 2075 7365 2074 6865 2027 6772 7562 2d6d use the 'grub-m │ │ │ │ │ -0001dc30: 6b72 6573 6375 6527 2070 726f 6772 616d krescue' program │ │ │ │ │ -0001dc40: 2066 6f72 2074 6869 732e 0a0a 276e 6267 for this...'nbg │ │ │ │ │ -0001dc50: 7275 6227 0a20 2020 2020 5468 6572 6520 rub'. There │ │ │ │ │ -0001dc60: 6973 2061 7320 7965 7420 6e6f 2065 7175 is as yet no equ │ │ │ │ │ -0001dc70: 6976 616c 656e 7420 666f 7220 276e 6267 ivalent for 'nbg │ │ │ │ │ -0001dc80: 7275 6227 2069 6e20 4752 5542 2032 3b20 rub' in GRUB 2; │ │ │ │ │ -0001dc90: 6974 2077 6173 2075 7365 640a 2020 2020 it was used. │ │ │ │ │ -0001dca0: 2062 7920 4574 6865 7262 6f6f 7420 616e by Etherboot an │ │ │ │ │ -0001dcb0: 6420 736f 6d65 206f 7468 6572 206e 6574 d some other net │ │ │ │ │ -0001dcc0: 776f 726b 2062 6f6f 7420 6c6f 6164 6572 work boot loader │ │ │ │ │ -0001dcd0: 732e 0a0a 2770 7865 6772 7562 270a 2020 s...'pxegrub'. │ │ │ │ │ -0001dce0: 2020 2049 6e20 4752 5542 2032 2c20 696d In GRUB 2, im │ │ │ │ │ -0001dcf0: 6167 6573 2066 6f72 2050 5845 206e 6574 ages for PXE net │ │ │ │ │ -0001dd00: 776f 726b 2062 6f6f 7469 6e67 2061 7265 work booting are │ │ │ │ │ -0001dd10: 206e 6f77 2063 6f6e 7374 7275 6374 6564 now constructed │ │ │ │ │ -0001dd20: 2075 7369 6e67 0a20 2020 2020 2770 7865 using. 'pxe │ │ │ │ │ -0001dd30: 626f 6f74 2e69 6d67 2720 616e 6420 2763 boot.img' and 'c │ │ │ │ │ -0001dd40: 6f72 652e 696d 6727 2c20 6d61 6b69 6e67 ore.img', making │ │ │ │ │ -0001dd50: 2073 7572 6520 7468 6174 2074 6865 2063 sure that the c │ │ │ │ │ -0001dd60: 6f72 6520 696d 6167 650a 2020 2020 2063 ore image. c │ │ │ │ │ -0001dd70: 6f6e 7461 696e 7320 7468 6520 2770 7865 ontains the 'pxe │ │ │ │ │ -0001dd80: 2720 616e 6420 2770 7865 636d 6427 206d ' and 'pxecmd' m │ │ │ │ │ -0001dd90: 6f64 756c 6573 2e20 202a 4e6f 7465 204e odules. *Note N │ │ │ │ │ -0001dda0: 6574 776f 726b 3a3a 2e0a 0a1f 0a46 696c etwork::.....Fil │ │ │ │ │ -0001ddb0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0001ddc0: 6f64 653a 2043 6f72 6520 696d 6167 6520 ode: Core image │ │ │ │ │ -0001ddd0: 7369 7a65 206c 696d 6974 6174 696f 6e2c size limitation, │ │ │ │ │ -0001dde0: 2020 4e65 7874 3a20 4669 6c65 7379 7374 Next: Filesyst │ │ │ │ │ -0001ddf0: 656d 2c20 2050 7265 763a 2049 6d61 6765 em, Prev: Image │ │ │ │ │ -0001de00: 732c 2020 5570 3a20 546f 700a 0a31 3220 s, Up: Top..12 │ │ │ │ │ -0001de10: 436f 7265 2069 6d61 6765 2073 697a 6520 Core image size │ │ │ │ │ -0001de20: 6c69 6d69 7461 7469 6f6e 0a2a 2a2a 2a2a limitation.***** │ │ │ │ │ +0001c350: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ +0001c360: 0a53 6f6d 6520 6c61 7074 6f70 2076 656e .Some laptop ven │ │ │ │ │ +0001c370: 646f 7273 2070 726f 7669 6465 2061 6e20 dors provide an │ │ │ │ │ +0001c380: 6164 6469 7469 6f6e 616c 2070 6f77 6572 additional power │ │ │ │ │ +0001c390: 2d6f 6e20 6275 7474 6f6e 2077 6869 6368 -on button which │ │ │ │ │ +0001c3a0: 2062 6f6f 7473 0a61 6e6f 7468 6572 204f boots.another O │ │ │ │ │ +0001c3b0: 532e 2047 5255 4220 7375 7070 6f72 7473 S. GRUB supports │ │ │ │ │ +0001c3c0: 2073 7563 6820 6275 7474 6f6e 7320 7769 such buttons wi │ │ │ │ │ +0001c3d0: 7468 2074 6865 2027 4752 5542 5f54 494d th the 'GRUB_TIM │ │ │ │ │ +0001c3e0: 454f 5554 5f42 5554 544f 4e27 2c0a 2747 EOUT_BUTTON',.'G │ │ │ │ │ +0001c3f0: 5255 425f 5449 4d45 4f55 545f 5354 594c RUB_TIMEOUT_STYL │ │ │ │ │ +0001c400: 455f 4255 5454 4f4e 272c 2027 4752 5542 E_BUTTON', 'GRUB │ │ │ │ │ +0001c410: 5f44 4546 4155 4c54 5f42 5554 544f 4e27 _DEFAULT_BUTTON' │ │ │ │ │ +0001c420: 2c20 616e 640a 2747 5255 425f 4255 5454 , and.'GRUB_BUTT │ │ │ │ │ +0001c430: 4f4e 5f43 4d4f 535f 4144 4452 4553 5327 ON_CMOS_ADDRESS' │ │ │ │ │ +0001c440: 2076 6172 6961 626c 6573 2069 6e20 6465 variables in de │ │ │ │ │ +0001c450: 6661 756c 742f 6772 7562 2028 2a6e 6f74 fault/grub (*not │ │ │ │ │ +0001c460: 6520 5369 6d70 6c65 0a63 6f6e 6669 6775 e Simple.configu │ │ │ │ │ +0001c470: 7261 7469 6f6e 3a3a 292e 2020 2747 5255 ration::). 'GRU │ │ │ │ │ +0001c480: 425f 5449 4d45 4f55 545f 4255 5454 4f4e B_TIMEOUT_BUTTON │ │ │ │ │ +0001c490: 272c 2027 4752 5542 5f54 494d 454f 5554 ', 'GRUB_TIMEOUT │ │ │ │ │ +0001c4a0: 5f53 5459 4c45 5f42 5554 544f 4e27 2c0a _STYLE_BUTTON',. │ │ │ │ │ +0001c4b0: 616e 6420 2747 5255 425f 4445 4641 554c and 'GRUB_DEFAUL │ │ │ │ │ +0001c4c0: 545f 4255 5454 4f4e 2720 6172 6520 7573 T_BUTTON' are us │ │ │ │ │ +0001c4d0: 6564 2069 6e73 7465 6164 206f 6620 7468 ed instead of th │ │ │ │ │ +0001c4e0: 6520 636f 7272 6573 706f 6e64 696e 670a e corresponding. │ │ │ │ │ +0001c4f0: 7661 7269 6162 6c65 7320 7769 7468 6f75 variables withou │ │ │ │ │ +0001c500: 7420 7468 6520 275f 4255 5454 4f4e 2720 t the '_BUTTON' │ │ │ │ │ +0001c510: 7375 6666 6978 2077 6865 6e20 706f 7765 suffix when powe │ │ │ │ │ +0001c520: 7265 6420 6f6e 2075 7369 6e67 2074 6865 red on using the │ │ │ │ │ +0001c530: 2073 7065 6369 616c 0a62 7574 746f 6e2e special.button. │ │ │ │ │ +0001c540: 2020 2747 5255 425f 4255 5454 4f4e 5f43 'GRUB_BUTTON_C │ │ │ │ │ +0001c550: 4d4f 535f 4144 4452 4553 5327 2069 7320 MOS_ADDRESS' is │ │ │ │ │ +0001c560: 7665 6e64 6f72 2d73 7065 6369 6669 6320 vendor-specific │ │ │ │ │ +0001c570: 616e 6420 7061 7274 6961 6c6c 790a 6d6f and partially.mo │ │ │ │ │ +0001c580: 6465 6c2d 7370 6563 6966 6963 2e20 2056 del-specific. V │ │ │ │ │ +0001c590: 616c 7565 7320 6b6e 6f77 6e20 746f 2074 alues known to t │ │ │ │ │ +0001c5a0: 6865 2047 5255 4220 7465 616d 2061 7265 he GRUB team are │ │ │ │ │ +0001c5b0: 3a0a 0a3c 4465 6c6c 2058 5053 204d 3133 :... 121:3. │ │ │ │ │ +0001c5d0: 3c44 656c 6c20 5850 5320 4d31 3533 303e │ │ │ │ │ +0001c5e0: 0a20 2020 2020 3835 3a33 0a3c 4465 6c6c . 85:3. │ │ │ │ │ +0001c600: 0a20 2020 2020 3835 3a33 0a3c 4173 7573 . 85:3.. │ │ │ │ │ +0001c620: 2020 2020 3834 3a31 2028 756e 636f 6e66 84:1 (unconf │ │ │ │ │ +0001c630: 6972 6d65 6429 0a3c 4c45 4e4f 564f 2054 irmed).. 10 │ │ │ │ │ +0001c660: 313a 330a 0a20 2020 546f 2074 616b 6520 1:3.. To take │ │ │ │ │ +0001c670: 6675 6c6c 2061 6476 616e 7461 6765 206f full advantage o │ │ │ │ │ +0001c680: 6620 7468 6973 2066 756e 6374 696f 6e2c f this function, │ │ │ │ │ +0001c690: 2069 6e73 7461 6c6c 2047 5255 4220 696e install GRUB in │ │ │ │ │ +0001c6a0: 746f 2074 6865 204d 4252 0a28 2a6e 6f74 to the MBR.(*not │ │ │ │ │ +0001c6b0: 6520 496e 7374 616c 6c69 6e67 2047 5255 e Installing GRU │ │ │ │ │ +0001c6c0: 4220 7573 696e 6720 6772 7562 2d69 6e73 B using grub-ins │ │ │ │ │ +0001c6d0: 7461 6c6c 3a3a 292e 0a0a 2020 2049 6620 tall::)... If │ │ │ │ │ +0001c6e0: 796f 7520 6861 7665 2061 206c 6170 746f you have a lapto │ │ │ │ │ +0001c6f0: 7020 7768 6963 6820 6861 7320 6120 7369 p which has a si │ │ │ │ │ +0001c700: 6d69 6c61 7220 6665 6174 7572 6520 616e milar feature an │ │ │ │ │ +0001c710: 6420 6e6f 7420 696e 2074 6865 2061 626f d not in the abo │ │ │ │ │ +0001c720: 7665 0a6c 6973 7420 636f 756c 6420 796f ve.list could yo │ │ │ │ │ +0001c730: 7520 6669 6775 7265 2079 6f75 7220 6164 u figure your ad │ │ │ │ │ +0001c740: 6472 6573 7320 616e 6420 636f 6e74 7269 dress and contri │ │ │ │ │ +0001c750: 6275 7465 3f20 2054 6f20 6469 7363 6f76 bute? To discov │ │ │ │ │ +0001c760: 6572 2074 6865 0a61 6464 7265 7373 2064 er the.address d │ │ │ │ │ +0001c770: 6f20 7468 6520 666f 6c6c 6f77 696e 673a o the following: │ │ │ │ │ +0001c780: 0a20 2020 2a20 626f 6f74 206e 6f72 6d61 . * boot norma │ │ │ │ │ +0001c790: 6c6c 790a 2020 202a 2020 2020 2020 7375 lly. * su │ │ │ │ │ +0001c7a0: 646f 206d 6f64 7072 6f62 6520 6e76 7261 do modprobe nvra │ │ │ │ │ +0001c7b0: 6d0a 2020 2020 2020 2020 2020 7375 646f m. sudo │ │ │ │ │ +0001c7c0: 2063 6174 202f 6465 762f 6e76 7261 6d20 cat /dev/nvram │ │ │ │ │ +0001c7d0: 7c20 7878 6420 3e20 6e6f 726d 616c 5f62 | xxd > normal_b │ │ │ │ │ +0001c7e0: 7574 746f 6e2e 7478 740a 2020 202a 2062 utton.txt. * b │ │ │ │ │ +0001c7f0: 6f6f 7420 7573 696e 6720 7665 6e64 6f72 oot using vendor │ │ │ │ │ +0001c800: 2062 7574 746f 6e0a 2020 202a 2020 2020 button. * │ │ │ │ │ +0001c810: 2020 7375 646f 206d 6f64 7072 6f62 6520 sudo modprobe │ │ │ │ │ +0001c820: 6e76 7261 6d0a 2020 2020 2020 2020 2020 nvram. │ │ │ │ │ +0001c830: 7375 646f 2063 6174 202f 6465 762f 6e76 sudo cat /dev/nv │ │ │ │ │ +0001c840: 7261 6d20 7c20 7878 6420 3e20 6e6f 726d ram | xxd > norm │ │ │ │ │ +0001c850: 616c 5f76 656e 646f 722e 7478 740a 0a20 al_vendor.txt.. │ │ │ │ │ +0001c860: 2020 5468 656e 2063 6f6d 7061 7265 2074 Then compare t │ │ │ │ │ +0001c870: 6865 7365 2074 6578 7420 6669 6c65 7320 hese text files │ │ │ │ │ +0001c880: 616e 6420 6669 6e64 2077 6865 7265 2061 and find where a │ │ │ │ │ +0001c890: 2062 6974 2077 6173 2074 6f67 676c 6564 bit was toggled │ │ │ │ │ +0001c8a0: 2e20 2045 2e67 2e0a 696e 2063 6173 6520 . E.g..in case │ │ │ │ │ +0001c8b0: 6f66 2044 656c 6c20 5850 5320 6974 2077 of Dell XPS it w │ │ │ │ │ +0001c8c0: 6173 3a0a 2020 2020 2062 7974 6520 3078 as:. byte 0x │ │ │ │ │ +0001c8d0: 3437 3a20 3230 202d 2d3e 2032 380a 2020 47: 20 --> 28. │ │ │ │ │ +0001c8e0: 2049 7427 7320 6120 6269 7420 6e75 6d62 It's a bit numb │ │ │ │ │ +0001c8f0: 6572 2033 2061 7320 7365 656e 2066 726f er 3 as seen fro │ │ │ │ │ +0001c900: 6d20 666f 6c6c 6f77 696e 6720 7461 626c m following tabl │ │ │ │ │ +0001c910: 653a 0a30 2020 2020 2020 2020 2020 2020 e:.0 │ │ │ │ │ +0001c920: 2020 3031 0a31 2020 2020 2020 2020 2020 01.1 │ │ │ │ │ +0001c930: 2020 2020 3032 0a32 2020 2020 2020 2020 02.2 │ │ │ │ │ +0001c940: 2020 2020 2020 3034 0a33 2020 2020 2020 04.3 │ │ │ │ │ +0001c950: 2020 2020 2020 2020 3038 0a34 2020 2020 08.4 │ │ │ │ │ +0001c960: 2020 2020 2020 2020 2020 3130 0a35 2020 10.5 │ │ │ │ │ +0001c970: 2020 2020 2020 2020 2020 2020 3230 0a36 20.6 │ │ │ │ │ +0001c980: 2020 2020 2020 2020 2020 2020 2020 3430 40 │ │ │ │ │ +0001c990: 0a37 2020 2020 2020 2020 2020 2020 2020 .7 │ │ │ │ │ +0001c9a0: 3830 0a0a 2020 2030 7834 3720 6973 2064 80.. 0x47 is d │ │ │ │ │ +0001c9b0: 6563 696d 616c 2037 312e 2020 4c69 6e75 ecimal 71. Linu │ │ │ │ │ +0001c9c0: 7820 6e76 7261 6d20 696d 706c 656d 656e x nvram implemen │ │ │ │ │ +0001c9d0: 7461 7469 6f6e 2063 7574 7320 6669 7273 tation cuts firs │ │ │ │ │ +0001c9e0: 7420 3134 2062 7974 6573 0a6f 6620 434d t 14 bytes.of CM │ │ │ │ │ +0001c9f0: 4f53 2e20 536f 2074 6865 2072 6561 6c20 OS. So the real │ │ │ │ │ +0001ca00: 6279 7465 2061 6464 7265 7373 2069 6e20 byte address in │ │ │ │ │ +0001ca10: 434d 4f53 2069 7320 3731 2b31 343d 3835 CMOS is 71+14=85 │ │ │ │ │ +0001ca20: 2053 6f20 636f 6d70 6c65 7465 0a61 6464 So complete.add │ │ │ │ │ +0001ca30: 7265 7373 2069 7320 3835 3a33 0a0a 1f0a ress is 85:3.... │ │ │ │ │ +0001ca40: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +0001ca50: 2020 4e6f 6465 3a20 496d 6167 6573 2c20 Node: Images, │ │ │ │ │ +0001ca60: 204e 6578 743a 2043 6f72 6520 696d 6167 Next: Core imag │ │ │ │ │ +0001ca70: 6520 7369 7a65 206c 696d 6974 6174 696f e size limitatio │ │ │ │ │ +0001ca80: 6e2c 2020 5072 6576 3a20 5665 6e64 6f72 n, Prev: Vendor │ │ │ │ │ +0001ca90: 2070 6f77 6572 2d6f 6e20 6b65 7973 2c20 power-on keys, │ │ │ │ │ +0001caa0: 2055 703a 2054 6f70 0a0a 3131 2047 5255 Up: Top..11 GRU │ │ │ │ │ +0001cab0: 4220 696d 6167 6520 6669 6c65 730a 2a2a B image files.** │ │ │ │ │ +0001cac0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +0001cad0: 2a0a 0a47 5255 4220 636f 6e73 6973 7473 *..GRUB consists │ │ │ │ │ +0001cae0: 206f 6620 7365 7665 7261 6c20 696d 6167 of several imag │ │ │ │ │ +0001caf0: 6573 3a20 6120 7661 7269 6574 7920 6f66 es: a variety of │ │ │ │ │ +0001cb00: 2062 6f6f 7473 7472 6170 2069 6d61 6765 bootstrap image │ │ │ │ │ +0001cb10: 7320 666f 720a 7374 6172 7469 6e67 2047 s for.starting G │ │ │ │ │ +0001cb20: 5255 4220 696e 2076 6172 696f 7573 2077 RUB in various w │ │ │ │ │ +0001cb30: 6179 732c 2061 206b 6572 6e65 6c20 696d ays, a kernel im │ │ │ │ │ +0001cb40: 6167 652c 2061 6e64 2061 2073 6574 206f age, and a set o │ │ │ │ │ +0001cb50: 6620 6d6f 6475 6c65 730a 7768 6963 6820 f modules.which │ │ │ │ │ +0001cb60: 6172 6520 636f 6d62 696e 6564 2077 6974 are combined wit │ │ │ │ │ +0001cb70: 6820 7468 6520 6b65 726e 656c 2069 6d61 h the kernel ima │ │ │ │ │ +0001cb80: 6765 2074 6f20 666f 726d 2061 2063 6f72 ge to form a cor │ │ │ │ │ +0001cb90: 6520 696d 6167 652e 2020 4865 7265 2069 e image. Here i │ │ │ │ │ +0001cba0: 730a 6120 7368 6f72 7420 6f76 6572 7669 s.a short overvi │ │ │ │ │ +0001cbb0: 6577 206f 6620 7468 656d 2e0a 0a27 626f ew of them...'bo │ │ │ │ │ +0001cbc0: 6f74 2e69 6d67 270a 2020 2020 204f 6e20 ot.img'. On │ │ │ │ │ +0001cbd0: 5043 2042 494f 5320 7379 7374 656d 732c PC BIOS systems, │ │ │ │ │ +0001cbe0: 2074 6869 7320 696d 6167 6520 6973 2074 this image is t │ │ │ │ │ +0001cbf0: 6865 2066 6972 7374 2070 6172 7420 6f66 he first part of │ │ │ │ │ +0001cc00: 2047 5255 4220 746f 2073 7461 7274 2e0a GRUB to start.. │ │ │ │ │ +0001cc10: 2020 2020 2049 7420 6973 2077 7269 7474 It is writt │ │ │ │ │ +0001cc20: 656e 2074 6f20 6120 6d61 7374 6572 2062 en to a master b │ │ │ │ │ +0001cc30: 6f6f 7420 7265 636f 7264 2028 4d42 5229 oot record (MBR) │ │ │ │ │ +0001cc40: 206f 7220 746f 2074 6865 2062 6f6f 7420 or to the boot │ │ │ │ │ +0001cc50: 7365 6374 6f72 0a20 2020 2020 6f66 2061 sector. of a │ │ │ │ │ +0001cc60: 2070 6172 7469 7469 6f6e 2e20 2042 6563 partition. Bec │ │ │ │ │ +0001cc70: 6175 7365 2061 2050 4320 626f 6f74 2073 ause a PC boot s │ │ │ │ │ +0001cc80: 6563 746f 7220 6973 2035 3132 2062 7974 ector is 512 byt │ │ │ │ │ +0001cc90: 6573 2c20 7468 6520 7369 7a65 206f 660a es, the size of. │ │ │ │ │ +0001cca0: 2020 2020 2074 6869 7320 696d 6167 6520 this image │ │ │ │ │ +0001ccb0: 6973 2065 7861 6374 6c79 2035 3132 2062 is exactly 512 b │ │ │ │ │ +0001ccc0: 7974 6573 2e0a 0a20 2020 2020 5468 6520 ytes... The │ │ │ │ │ +0001ccd0: 736f 6c65 2066 756e 6374 696f 6e20 6f66 sole function of │ │ │ │ │ +0001cce0: 2027 626f 6f74 2e69 6d67 2720 6973 2074 'boot.img' is t │ │ │ │ │ +0001ccf0: 6f20 7265 6164 2074 6865 2066 6972 7374 o read the first │ │ │ │ │ +0001cd00: 2073 6563 746f 7220 6f66 2074 6865 0a20 sector of the. │ │ │ │ │ +0001cd10: 2020 2020 636f 7265 2069 6d61 6765 2066 core image f │ │ │ │ │ +0001cd20: 726f 6d20 6120 6c6f 6361 6c20 6469 736b rom a local disk │ │ │ │ │ +0001cd30: 2061 6e64 206a 756d 7020 746f 2069 742e and jump to it. │ │ │ │ │ +0001cd40: 2020 4265 6361 7573 6520 6f66 2074 6865 Because of the │ │ │ │ │ +0001cd50: 2073 697a 650a 2020 2020 2072 6573 7472 size. restr │ │ │ │ │ +0001cd60: 6963 7469 6f6e 2c20 2762 6f6f 742e 696d iction, 'boot.im │ │ │ │ │ +0001cd70: 6727 2063 616e 6e6f 7420 756e 6465 7273 g' cannot unders │ │ │ │ │ +0001cd80: 7461 6e64 2061 6e79 2066 696c 6520 7379 tand any file sy │ │ │ │ │ +0001cd90: 7374 656d 0a20 2020 2020 7374 7275 6374 stem. struct │ │ │ │ │ +0001cda0: 7572 652c 2073 6f20 2767 7275 622d 696e ure, so 'grub-in │ │ │ │ │ +0001cdb0: 7374 616c 6c27 2068 6172 6463 6f64 6573 stall' hardcodes │ │ │ │ │ +0001cdc0: 2074 6865 206c 6f63 6174 696f 6e20 6f66 the location of │ │ │ │ │ +0001cdd0: 2074 6865 2066 6972 7374 0a20 2020 2020 the first. │ │ │ │ │ +0001cde0: 7365 6374 6f72 206f 6620 7468 6520 636f sector of the co │ │ │ │ │ +0001cdf0: 7265 2069 6d61 6765 2069 6e74 6f20 2762 re image into 'b │ │ │ │ │ +0001ce00: 6f6f 742e 696d 6727 2077 6865 6e20 696e oot.img' when in │ │ │ │ │ +0001ce10: 7374 616c 6c69 6e67 2047 5255 422e 0a0a stalling GRUB... │ │ │ │ │ +0001ce20: 2764 6973 6b62 6f6f 742e 696d 6727 0a20 'diskboot.img'. │ │ │ │ │ +0001ce30: 2020 2020 5468 6973 2069 6d61 6765 2069 This image i │ │ │ │ │ +0001ce40: 7320 7573 6564 2061 7320 7468 6520 6669 s used as the fi │ │ │ │ │ +0001ce50: 7273 7420 7365 6374 6f72 206f 6620 7468 rst sector of th │ │ │ │ │ +0001ce60: 6520 636f 7265 2069 6d61 6765 2077 6865 e core image whe │ │ │ │ │ +0001ce70: 6e0a 2020 2020 2062 6f6f 7469 6e67 2066 n. booting f │ │ │ │ │ +0001ce80: 726f 6d20 6120 6861 7264 2064 6973 6b2e rom a hard disk. │ │ │ │ │ +0001ce90: 2020 4974 2072 6561 6473 2074 6865 2072 It reads the r │ │ │ │ │ +0001cea0: 6573 7420 6f66 2074 6865 2063 6f72 6520 est of the core │ │ │ │ │ +0001ceb0: 696d 6167 6520 696e 746f 0a20 2020 2020 image into. │ │ │ │ │ +0001cec0: 6d65 6d6f 7279 2061 6e64 2073 7461 7274 memory and start │ │ │ │ │ +0001ced0: 7320 7468 6520 6b65 726e 656c 2e20 2053 s the kernel. S │ │ │ │ │ +0001cee0: 696e 6365 2066 696c 6520 7379 7374 656d ince file system │ │ │ │ │ +0001cef0: 2068 616e 646c 696e 6720 6973 206e 6f74 handling is not │ │ │ │ │ +0001cf00: 0a20 2020 2020 7965 7420 6176 6169 6c61 . yet availa │ │ │ │ │ +0001cf10: 626c 652c 2069 7420 656e 636f 6465 7320 ble, it encodes │ │ │ │ │ +0001cf20: 7468 6520 6c6f 6361 7469 6f6e 206f 6620 the location of │ │ │ │ │ +0001cf30: 7468 6520 636f 7265 2069 6d61 6765 2075 the core image u │ │ │ │ │ +0001cf40: 7369 6e67 2061 0a20 2020 2020 626c 6f63 sing a. bloc │ │ │ │ │ +0001cf50: 6b20 6c69 7374 2066 6f72 6d61 742e 0a0a k list format... │ │ │ │ │ +0001cf60: 2763 6462 6f6f 742e 696d 6727 0a20 2020 'cdboot.img'. │ │ │ │ │ +0001cf70: 2020 5468 6973 2069 6d61 6765 2069 7320 This image is │ │ │ │ │ +0001cf80: 7573 6564 2061 7320 7468 6520 6669 7273 used as the firs │ │ │ │ │ +0001cf90: 7420 7365 6374 6f72 206f 6620 7468 6520 t sector of the │ │ │ │ │ +0001cfa0: 636f 7265 2069 6d61 6765 2077 6865 6e0a core image when. │ │ │ │ │ +0001cfb0: 2020 2020 2062 6f6f 7469 6e67 2066 726f booting fro │ │ │ │ │ +0001cfc0: 6d20 6120 4344 2d52 4f4d 2064 7269 7665 m a CD-ROM drive │ │ │ │ │ +0001cfd0: 2e20 2049 7420 7065 7266 6f72 6d73 2061 . It performs a │ │ │ │ │ +0001cfe0: 2073 696d 696c 6172 2066 756e 6374 696f similar functio │ │ │ │ │ +0001cff0: 6e20 746f 0a20 2020 2020 2764 6973 6b62 n to. 'diskb │ │ │ │ │ +0001d000: 6f6f 742e 696d 6727 2e0a 0a27 7078 6562 oot.img'...'pxeb │ │ │ │ │ +0001d010: 6f6f 742e 696d 6727 0a20 2020 2020 5468 oot.img'. Th │ │ │ │ │ +0001d020: 6973 2069 6d61 6765 2069 7320 7573 6564 is image is used │ │ │ │ │ +0001d030: 2061 7320 7468 6520 7374 6172 7420 6f66 as the start of │ │ │ │ │ +0001d040: 2074 6865 2063 6f72 6520 696d 6167 6520 the core image │ │ │ │ │ +0001d050: 7768 656e 2062 6f6f 7469 6e67 2066 726f when booting fro │ │ │ │ │ +0001d060: 6d0a 2020 2020 2074 6865 206e 6574 776f m. the netwo │ │ │ │ │ +0001d070: 726b 2075 7369 6e67 2050 5845 2e20 2a4e rk using PXE. *N │ │ │ │ │ +0001d080: 6f74 6520 4e65 7477 6f72 6b3a 3a2e 0a0a ote Network::... │ │ │ │ │ +0001d090: 276c 6e78 626f 6f74 2e69 6d67 270a 2020 'lnxboot.img'. │ │ │ │ │ +0001d0a0: 2020 2054 6869 7320 696d 6167 6520 6d61 This image ma │ │ │ │ │ +0001d0b0: 7920 6265 2070 6c61 6365 6420 6174 2074 y be placed at t │ │ │ │ │ +0001d0c0: 6865 2073 7461 7274 206f 6620 7468 6520 he start of the │ │ │ │ │ +0001d0d0: 636f 7265 2069 6d61 6765 2069 6e20 6f72 core image in or │ │ │ │ │ +0001d0e0: 6465 7220 746f 0a20 2020 2020 6d61 6b65 der to. make │ │ │ │ │ +0001d0f0: 2047 5255 4220 6c6f 6f6b 2065 6e6f 7567 GRUB look enoug │ │ │ │ │ +0001d100: 6820 6c69 6b65 2061 204c 696e 7578 206b h like a Linux k │ │ │ │ │ +0001d110: 6572 6e65 6c20 7468 6174 2069 7420 6361 ernel that it ca │ │ │ │ │ +0001d120: 6e20 6265 2062 6f6f 7465 6420 6279 0a20 n be booted by. │ │ │ │ │ +0001d130: 2020 2020 4c49 4c4f 2075 7369 6e67 2061 LILO using a │ │ │ │ │ +0001d140: 6e20 2769 6d61 6765 3d27 2073 6563 7469 n 'image=' secti │ │ │ │ │ +0001d150: 6f6e 2e0a 0a27 6b65 726e 656c 2e69 6d67 on...'kernel.img │ │ │ │ │ +0001d160: 270a 2020 2020 2054 6869 7320 696d 6167 '. This imag │ │ │ │ │ +0001d170: 6520 636f 6e74 6169 6e73 2047 5255 4227 e contains GRUB' │ │ │ │ │ +0001d180: 7320 6261 7369 6320 7275 6e2d 7469 6d65 s basic run-time │ │ │ │ │ +0001d190: 2066 6163 696c 6974 6965 733a 2066 7261 facilities: fra │ │ │ │ │ +0001d1a0: 6d65 776f 726b 730a 2020 2020 2066 6f72 meworks. for │ │ │ │ │ +0001d1b0: 2064 6576 6963 6520 616e 6420 6669 6c65 device and file │ │ │ │ │ +0001d1c0: 2068 616e 646c 696e 672c 2065 6e76 6972 handling, envir │ │ │ │ │ +0001d1d0: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ +0001d1e0: 2c20 7468 6520 7265 7363 7565 0a20 2020 , the rescue. │ │ │ │ │ +0001d1f0: 2020 6d6f 6465 2063 6f6d 6d61 6e64 2d6c mode command-l │ │ │ │ │ +0001d200: 696e 6520 7061 7273 6572 2c20 616e 6420 ine parser, and │ │ │ │ │ +0001d210: 736f 206f 6e2e 2020 4974 2069 7320 7261 so on. It is ra │ │ │ │ │ +0001d220: 7265 6c79 2075 7365 6420 6469 7265 6374 rely used direct │ │ │ │ │ +0001d230: 6c79 2c0a 2020 2020 2062 7574 2069 7320 ly,. but is │ │ │ │ │ +0001d240: 6275 696c 7420 696e 746f 2061 6c6c 2063 built into all c │ │ │ │ │ +0001d250: 6f72 6520 696d 6167 6573 2e0a 0a27 636f ore images...'co │ │ │ │ │ +0001d260: 7265 2e69 6d67 270a 2020 2020 2054 6869 re.img'. Thi │ │ │ │ │ +0001d270: 7320 6973 2074 6865 2063 6f72 6520 696d s is the core im │ │ │ │ │ +0001d280: 6167 6520 6f66 2047 5255 422e 2049 7420 age of GRUB. It │ │ │ │ │ +0001d290: 6973 2062 7569 6c74 2064 796e 616d 6963 is built dynamic │ │ │ │ │ +0001d2a0: 616c 6c79 2066 726f 6d20 7468 650a 2020 ally from the. │ │ │ │ │ +0001d2b0: 2020 206b 6572 6e65 6c20 696d 6167 6520 kernel image │ │ │ │ │ +0001d2c0: 616e 6420 616e 2061 7262 6974 7261 7279 and an arbitrary │ │ │ │ │ +0001d2d0: 206c 6973 7420 6f66 206d 6f64 756c 6573 list of modules │ │ │ │ │ +0001d2e0: 2062 7920 7468 6520 2767 7275 622d 6d6b by the 'grub-mk │ │ │ │ │ +0001d2f0: 696d 6167 6527 0a20 2020 2020 7072 6f67 image'. prog │ │ │ │ │ +0001d300: 7261 6d2e 2020 5573 7561 6c6c 792c 2069 ram. Usually, i │ │ │ │ │ +0001d310: 7420 636f 6e74 6169 6e73 2065 6e6f 7567 t contains enoug │ │ │ │ │ +0001d320: 6820 6d6f 6475 6c65 7320 746f 2061 6363 h modules to acc │ │ │ │ │ +0001d330: 6573 730a 2020 2020 2027 2f62 6f6f 742f ess. '/boot/ │ │ │ │ │ +0001d340: 6772 7562 272c 2061 6e64 206c 6f61 6473 grub', and loads │ │ │ │ │ +0001d350: 2065 7665 7279 7468 696e 6720 656c 7365 everything else │ │ │ │ │ +0001d360: 2028 696e 636c 7564 696e 6720 6d65 6e75 (including menu │ │ │ │ │ +0001d370: 2068 616e 646c 696e 672c 0a20 2020 2020 handling,. │ │ │ │ │ +0001d380: 7468 6520 6162 696c 6974 7920 746f 206c the ability to l │ │ │ │ │ +0001d390: 6f61 6420 7461 7267 6574 206f 7065 7261 oad target opera │ │ │ │ │ +0001d3a0: 7469 6e67 2073 7973 7465 6d73 2c20 616e ting systems, an │ │ │ │ │ +0001d3b0: 6420 736f 206f 6e29 2066 726f 6d20 7468 d so on) from th │ │ │ │ │ +0001d3c0: 650a 2020 2020 2066 696c 6520 7379 7374 e. file syst │ │ │ │ │ +0001d3d0: 656d 2061 7420 7275 6e2d 7469 6d65 2e20 em at run-time. │ │ │ │ │ +0001d3e0: 2054 6865 206d 6f64 756c 6172 2064 6573 The modular des │ │ │ │ │ +0001d3f0: 6967 6e20 616c 6c6f 7773 2074 6865 2063 ign allows the c │ │ │ │ │ +0001d400: 6f72 6520 696d 6167 650a 2020 2020 2074 ore image. t │ │ │ │ │ +0001d410: 6f20 6265 206b 6570 7420 736d 616c 6c2c o be kept small, │ │ │ │ │ +0001d420: 2073 696e 6365 2074 6865 2061 7265 6173 since the areas │ │ │ │ │ +0001d430: 206f 6620 6469 736b 2077 6865 7265 2069 of disk where i │ │ │ │ │ +0001d440: 7420 6d75 7374 2062 650a 2020 2020 2069 t must be. i │ │ │ │ │ +0001d450: 6e73 7461 6c6c 6564 2061 7265 206f 6674 nstalled are oft │ │ │ │ │ +0001d460: 656e 2061 7320 736d 616c 6c20 6173 2033 en as small as 3 │ │ │ │ │ +0001d470: 324b 422e 0a0a 2020 2020 202a 4e6f 7465 2KB... *Note │ │ │ │ │ +0001d480: 2042 494f 5320 696e 7374 616c 6c61 7469 BIOS installati │ │ │ │ │ +0001d490: 6f6e 3a3a 2c20 666f 7220 6465 7461 696c on::, for detail │ │ │ │ │ +0001d4a0: 7320 6f6e 2077 6865 7265 2074 6865 2063 s on where the c │ │ │ │ │ +0001d4b0: 6f72 6520 696d 6167 6520 6361 6e0a 2020 ore image can. │ │ │ │ │ +0001d4c0: 2020 2062 6520 696e 7374 616c 6c65 6420 be installed │ │ │ │ │ +0001d4d0: 6f6e 2050 4320 7379 7374 656d 732e 0a0a on PC systems... │ │ │ │ │ +0001d4e0: 272a 2e6d 6f64 270a 2020 2020 2045 7665 '*.mod'. Eve │ │ │ │ │ +0001d4f0: 7279 7468 696e 6720 656c 7365 2069 6e20 rything else in │ │ │ │ │ +0001d500: 4752 5542 2072 6573 6964 6573 2069 6e20 GRUB resides in │ │ │ │ │ +0001d510: 6479 6e61 6d69 6361 6c6c 7920 6c6f 6164 dynamically load │ │ │ │ │ +0001d520: 6162 6c65 206d 6f64 756c 6573 2e0a 2020 able modules.. │ │ │ │ │ +0001d530: 2020 2054 6865 7365 2061 7265 206f 6674 These are oft │ │ │ │ │ +0001d540: 656e 206c 6f61 6465 6420 6175 746f 6d61 en loaded automa │ │ │ │ │ +0001d550: 7469 6361 6c6c 792c 206f 7220 6275 696c tically, or buil │ │ │ │ │ +0001d560: 7420 696e 746f 2074 6865 2063 6f72 6520 t into the core │ │ │ │ │ +0001d570: 696d 6167 650a 2020 2020 2069 6620 7468 image. if th │ │ │ │ │ +0001d580: 6579 2061 7265 2065 7373 656e 7469 616c ey are essential │ │ │ │ │ +0001d590: 2c20 6275 7420 6d61 7920 616c 736f 2062 , but may also b │ │ │ │ │ +0001d5a0: 6520 6c6f 6164 6564 206d 616e 7561 6c6c e loaded manuall │ │ │ │ │ +0001d5b0: 7920 7573 696e 6720 7468 650a 2020 2020 y using the. │ │ │ │ │ +0001d5c0: 2027 696e 736d 6f64 2720 636f 6d6d 616e 'insmod' comman │ │ │ │ │ +0001d5d0: 6420 282a 6e6f 7465 2069 6e73 6d6f 643a d (*note insmod: │ │ │ │ │ +0001d5e0: 3a29 2e0a 0a46 6f72 2047 5255 4220 4c65 :)...For GRUB Le │ │ │ │ │ +0001d5f0: 6761 6379 2075 7365 7273 0a3d 3d3d 3d3d gacy users.===== │ │ │ │ │ +0001d600: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +0001d610: 0a0a 4752 5542 2032 2068 6173 2061 2064 ..GRUB 2 has a d │ │ │ │ │ +0001d620: 6966 6665 7265 6e74 2064 6573 6967 6e20 ifferent design │ │ │ │ │ +0001d630: 6672 6f6d 2047 5255 4220 4c65 6761 6379 from GRUB Legacy │ │ │ │ │ +0001d640: 2c20 616e 6420 736f 2063 6f72 7265 7370 , and so corresp │ │ │ │ │ +0001d650: 6f6e 6465 6e63 6573 0a77 6974 6820 7468 ondences.with th │ │ │ │ │ +0001d660: 6520 696d 6167 6573 2069 7420 7573 6564 e images it used │ │ │ │ │ +0001d670: 2063 616e 6e6f 7420 6265 2065 7861 6374 cannot be exact │ │ │ │ │ +0001d680: 2e20 204e 6576 6572 7468 656c 6573 732c . Nevertheless, │ │ │ │ │ +0001d690: 2047 5255 4220 4c65 6761 6379 0a75 7365 GRUB Legacy.use │ │ │ │ │ +0001d6a0: 7273 206f 6674 656e 2061 736b 2071 7565 rs often ask que │ │ │ │ │ +0001d6b0: 7374 696f 6e73 2069 6e20 7468 6520 7465 stions in the te │ │ │ │ │ +0001d6c0: 726d 7320 7468 6579 2061 7265 2066 616d rms they are fam │ │ │ │ │ +0001d6d0: 696c 6961 7220 7769 7468 2c20 616e 6420 iliar with, and │ │ │ │ │ +0001d6e0: 736f 0a68 6572 6520 6973 2061 2062 7269 so.here is a bri │ │ │ │ │ +0001d6f0: 6566 2067 7569 6465 2074 6f20 686f 7720 ef guide to how │ │ │ │ │ +0001d700: 4752 5542 2032 2773 2069 6d61 6765 7320 GRUB 2's images │ │ │ │ │ +0001d710: 7265 6c61 7465 2074 6f20 7468 6174 2e0a relate to that.. │ │ │ │ │ +0001d720: 0a27 7374 6167 6531 270a 2020 2020 2053 .'stage1'. S │ │ │ │ │ +0001d730: 7461 6765 2031 2066 726f 6d20 4752 5542 tage 1 from GRUB │ │ │ │ │ +0001d740: 204c 6567 6163 7920 7761 7320 7665 7279 Legacy was very │ │ │ │ │ +0001d750: 2073 696d 696c 6172 2074 6f20 2762 6f6f similar to 'boo │ │ │ │ │ +0001d760: 742e 696d 6727 2069 6e20 4752 5542 2032 t.img' in GRUB 2 │ │ │ │ │ +0001d770: 2c0a 2020 2020 2061 6e64 2074 6865 7920 ,. and they │ │ │ │ │ +0001d780: 7365 7276 6520 7468 6520 7361 6d65 2066 serve the same f │ │ │ │ │ +0001d790: 756e 6374 696f 6e2e 0a0a 272a 5f73 7461 unction...'*_sta │ │ │ │ │ +0001d7a0: 6765 315f 3527 0a20 2020 2020 496e 2047 ge1_5'. In G │ │ │ │ │ +0001d7b0: 5255 4220 4c65 6761 6379 2c20 5374 6167 RUB Legacy, Stag │ │ │ │ │ +0001d7c0: 6520 312e 3527 7320 6675 6e63 7469 6f6e e 1.5's function │ │ │ │ │ +0001d7d0: 2077 6173 2074 6f20 696e 636c 7564 6520 was to include │ │ │ │ │ +0001d7e0: 656e 6f75 6768 0a20 2020 2020 6669 6c65 enough. file │ │ │ │ │ +0001d7f0: 7379 7374 656d 2063 6f64 6520 746f 2061 system code to a │ │ │ │ │ +0001d800: 6c6c 6f77 2074 6865 206d 7563 6820 6c61 llow the much la │ │ │ │ │ +0001d810: 7267 6572 2053 7461 6765 2032 2074 6f20 rger Stage 2 to │ │ │ │ │ +0001d820: 6265 2072 6561 6420 6672 6f6d 2061 6e0a be read from an. │ │ │ │ │ +0001d830: 2020 2020 206f 7264 696e 6172 7920 6669 ordinary fi │ │ │ │ │ +0001d840: 6c65 7379 7374 656d 2e20 2049 6e20 7468 lesystem. In th │ │ │ │ │ +0001d850: 6973 2072 6573 7065 6374 2c20 6974 7320 is respect, its │ │ │ │ │ +0001d860: 6675 6e63 7469 6f6e 2077 6173 2073 696d function was sim │ │ │ │ │ +0001d870: 696c 6172 2074 6f0a 2020 2020 2027 636f ilar to. 'co │ │ │ │ │ +0001d880: 7265 2e69 6d67 2720 696e 2047 5255 4220 re.img' in GRUB │ │ │ │ │ +0001d890: 322e 2020 486f 7765 7665 722c 2027 636f 2. However, 'co │ │ │ │ │ +0001d8a0: 7265 2e69 6d67 2720 6973 206d 7563 6820 re.img' is much │ │ │ │ │ +0001d8b0: 6d6f 7265 2063 6170 6162 6c65 0a20 2020 more capable. │ │ │ │ │ +0001d8c0: 2020 7468 616e 2053 7461 6765 2031 2e35 than Stage 1.5 │ │ │ │ │ +0001d8d0: 2077 6173 3b20 7369 6e63 6520 6974 206f was; since it o │ │ │ │ │ +0001d8e0: 6666 6572 7320 6120 7265 7363 7565 2073 ffers a rescue s │ │ │ │ │ +0001d8f0: 6865 6c6c 2c20 6974 2069 7320 736f 6d65 hell, it is some │ │ │ │ │ +0001d900: 7469 6d65 730a 2020 2020 2070 6f73 7369 times. possi │ │ │ │ │ +0001d910: 626c 6520 746f 2072 6563 6f76 6572 206d ble to recover m │ │ │ │ │ +0001d920: 616e 7561 6c6c 7920 696e 2074 6865 2065 anually in the e │ │ │ │ │ +0001d930: 7665 6e74 2074 6861 7420 6974 2069 7320 vent that it is │ │ │ │ │ +0001d940: 756e 6162 6c65 2074 6f20 6c6f 6164 0a20 unable to load. │ │ │ │ │ +0001d950: 2020 2020 616e 7920 6f74 6865 7220 6d6f any other mo │ │ │ │ │ +0001d960: 6475 6c65 732c 2066 6f72 2065 7861 6d70 dules, for examp │ │ │ │ │ +0001d970: 6c65 2069 6620 7061 7274 6974 696f 6e20 le if partition │ │ │ │ │ +0001d980: 6e75 6d62 6572 7320 6861 7665 2063 6861 numbers have cha │ │ │ │ │ +0001d990: 6e67 6564 2e0a 2020 2020 2027 636f 7265 nged.. 'core │ │ │ │ │ +0001d9a0: 2e69 6d67 2720 6973 2062 7569 6c74 2069 .img' is built i │ │ │ │ │ +0001d9b0: 6e20 6120 6d6f 7265 2066 6c65 7869 626c n a more flexibl │ │ │ │ │ +0001d9c0: 6520 7761 792c 2061 6c6c 6f77 696e 6720 e way, allowing │ │ │ │ │ +0001d9d0: 4752 5542 2032 2074 6f0a 2020 2020 2073 GRUB 2 to. s │ │ │ │ │ +0001d9e0: 7570 706f 7274 2072 6561 6469 6e67 206d upport reading m │ │ │ │ │ +0001d9f0: 6f64 756c 6573 2066 726f 6d20 6164 7661 odules from adva │ │ │ │ │ +0001da00: 6e63 6564 2064 6973 6b20 7479 7065 7320 nced disk types │ │ │ │ │ +0001da10: 7375 6368 2061 7320 4c56 4d20 616e 640a such as LVM and. │ │ │ │ │ +0001da20: 2020 2020 2052 4149 442e 0a0a 2020 2020 RAID... │ │ │ │ │ +0001da30: 2047 5255 4220 4c65 6761 6379 2063 6f75 GRUB Legacy cou │ │ │ │ │ +0001da40: 6c64 2072 756e 2077 6974 6820 6f6e 6c79 ld run with only │ │ │ │ │ +0001da50: 2053 7461 6765 2031 2061 6e64 2053 7461 Stage 1 and Sta │ │ │ │ │ +0001da60: 6765 2032 2069 6e20 736f 6d65 206c 696d ge 2 in some lim │ │ │ │ │ +0001da70: 6974 6564 0a20 2020 2020 636f 6e66 6967 ited. config │ │ │ │ │ +0001da80: 7572 6174 696f 6e73 2c20 7768 696c 6520 urations, while │ │ │ │ │ +0001da90: 4752 5542 2032 2072 6571 7569 7265 7320 GRUB 2 requires │ │ │ │ │ +0001daa0: 2763 6f72 652e 696d 6727 2061 6e64 2063 'core.img' and c │ │ │ │ │ +0001dab0: 616e 6e6f 7420 776f 726b 0a20 2020 2020 annot work. │ │ │ │ │ +0001dac0: 7769 7468 6f75 7420 6974 2e0a 0a27 7374 without it...'st │ │ │ │ │ +0001dad0: 6167 6532 270a 2020 2020 2047 5255 4220 age2'. GRUB │ │ │ │ │ +0001dae0: 3220 6861 7320 6e6f 2073 696e 676c 6520 2 has no single │ │ │ │ │ +0001daf0: 5374 6167 6520 3220 696d 6167 652e 2020 Stage 2 image. │ │ │ │ │ +0001db00: 496e 7374 6561 642c 2069 7420 6c6f 6164 Instead, it load │ │ │ │ │ +0001db10: 7320 6d6f 6475 6c65 7320 6672 6f6d 0a20 s modules from. │ │ │ │ │ +0001db20: 2020 2020 272f 626f 6f74 2f67 7275 6227 '/boot/grub' │ │ │ │ │ +0001db30: 2061 7420 7275 6e2d 7469 6d65 2e0a 0a27 at run-time...' │ │ │ │ │ +0001db40: 7374 6167 6532 5f65 6c74 6f72 6974 6f27 stage2_eltorito' │ │ │ │ │ +0001db50: 0a20 2020 2020 496e 2047 5255 4220 322c . In GRUB 2, │ │ │ │ │ +0001db60: 2069 6d61 6765 7320 666f 7220 626f 6f74 images for boot │ │ │ │ │ +0001db70: 696e 6720 6672 6f6d 2043 442d 524f 4d20 ing from CD-ROM │ │ │ │ │ +0001db80: 6472 6976 6573 2061 7265 206e 6f77 0a20 drives are now. │ │ │ │ │ +0001db90: 2020 2020 636f 6e73 7472 7563 7465 6420 constructed │ │ │ │ │ +0001dba0: 7573 696e 6720 2763 6462 6f6f 742e 696d using 'cdboot.im │ │ │ │ │ +0001dbb0: 6727 2061 6e64 2027 636f 7265 2e69 6d67 g' and 'core.img │ │ │ │ │ +0001dbc0: 272c 206d 616b 696e 6720 7375 7265 2074 ', making sure t │ │ │ │ │ +0001dbd0: 6861 7420 7468 650a 2020 2020 2063 6f72 hat the. cor │ │ │ │ │ +0001dbe0: 6520 696d 6167 6520 636f 6e74 6169 6e73 e image contains │ │ │ │ │ +0001dbf0: 2074 6865 2027 6973 6f39 3636 3027 206d the 'iso9660' m │ │ │ │ │ +0001dc00: 6f64 756c 652e 2020 4974 2069 7320 7573 odule. It is us │ │ │ │ │ +0001dc10: 7561 6c6c 7920 6265 7374 2074 6f0a 2020 ually best to. │ │ │ │ │ +0001dc20: 2020 2075 7365 2074 6865 2027 6772 7562 use the 'grub │ │ │ │ │ +0001dc30: 2d6d 6b72 6573 6375 6527 2070 726f 6772 -mkrescue' progr │ │ │ │ │ +0001dc40: 616d 2066 6f72 2074 6869 732e 0a0a 276e am for this...'n │ │ │ │ │ +0001dc50: 6267 7275 6227 0a20 2020 2020 5468 6572 bgrub'. Ther │ │ │ │ │ +0001dc60: 6520 6973 2061 7320 7965 7420 6e6f 2065 e is as yet no e │ │ │ │ │ +0001dc70: 7175 6976 616c 656e 7420 666f 7220 276e quivalent for 'n │ │ │ │ │ +0001dc80: 6267 7275 6227 2069 6e20 4752 5542 2032 bgrub' in GRUB 2 │ │ │ │ │ +0001dc90: 3b20 6974 2077 6173 2075 7365 640a 2020 ; it was used. │ │ │ │ │ +0001dca0: 2020 2062 7920 4574 6865 7262 6f6f 7420 by Etherboot │ │ │ │ │ +0001dcb0: 616e 6420 736f 6d65 206f 7468 6572 206e and some other n │ │ │ │ │ +0001dcc0: 6574 776f 726b 2062 6f6f 7420 6c6f 6164 etwork boot load │ │ │ │ │ +0001dcd0: 6572 732e 0a0a 2770 7865 6772 7562 270a ers...'pxegrub'. │ │ │ │ │ +0001dce0: 2020 2020 2049 6e20 4752 5542 2032 2c20 In GRUB 2, │ │ │ │ │ +0001dcf0: 696d 6167 6573 2066 6f72 2050 5845 206e images for PXE n │ │ │ │ │ +0001dd00: 6574 776f 726b 2062 6f6f 7469 6e67 2061 etwork booting a │ │ │ │ │ +0001dd10: 7265 206e 6f77 2063 6f6e 7374 7275 6374 re now construct │ │ │ │ │ +0001dd20: 6564 2075 7369 6e67 0a20 2020 2020 2770 ed using. 'p │ │ │ │ │ +0001dd30: 7865 626f 6f74 2e69 6d67 2720 616e 6420 xeboot.img' and │ │ │ │ │ +0001dd40: 2763 6f72 652e 696d 6727 2c20 6d61 6b69 'core.img', maki │ │ │ │ │ +0001dd50: 6e67 2073 7572 6520 7468 6174 2074 6865 ng sure that the │ │ │ │ │ +0001dd60: 2063 6f72 6520 696d 6167 650a 2020 2020 core image. │ │ │ │ │ +0001dd70: 2063 6f6e 7461 696e 7320 7468 6520 2770 contains the 'p │ │ │ │ │ +0001dd80: 7865 2720 616e 6420 2770 7865 636d 6427 xe' and 'pxecmd' │ │ │ │ │ +0001dd90: 206d 6f64 756c 6573 2e20 202a 4e6f 7465 modules. *Note │ │ │ │ │ +0001dda0: 204e 6574 776f 726b 3a3a 2e0a 0a1f 0a46 Network::.....F │ │ │ │ │ +0001ddb0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +0001ddc0: 204e 6f64 653a 2043 6f72 6520 696d 6167 Node: Core imag │ │ │ │ │ +0001ddd0: 6520 7369 7a65 206c 696d 6974 6174 696f e size limitatio │ │ │ │ │ +0001dde0: 6e2c 2020 4e65 7874 3a20 4669 6c65 7379 n, Next: Filesy │ │ │ │ │ +0001ddf0: 7374 656d 2c20 2050 7265 763a 2049 6d61 stem, Prev: Ima │ │ │ │ │ +0001de00: 6765 732c 2020 5570 3a20 546f 700a 0a31 ges, Up: Top..1 │ │ │ │ │ +0001de10: 3220 436f 7265 2069 6d61 6765 2073 697a 2 Core image siz │ │ │ │ │ +0001de20: 6520 6c69 6d69 7461 7469 6f6e 0a2a 2a2a e limitation.*** │ │ │ │ │ 0001de30: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001de40: 2a2a 2a2a 2a2a 2a2a 0a0a 4865 6176 696c ********..Heavil │ │ │ │ │ -0001de50: 7920 6c69 6d69 7465 6420 706c 6174 666f y limited platfo │ │ │ │ │ -0001de60: 726d 733a 0a20 2020 2a20 6933 3836 2d70 rms:. * i386-p │ │ │ │ │ -0001de70: 6320 286e 6f72 6d61 6c20 616e 6420 5058 c (normal and PX │ │ │ │ │ -0001de80: 4529 3a20 7468 6520 636f 7265 2069 6d61 E): the core ima │ │ │ │ │ -0001de90: 6765 2073 697a 6520 2863 6f6d 7072 6573 ge size (compres │ │ │ │ │ -0001dea0: 7365 6429 2069 730a 2020 2020 206c 696d sed) is. lim │ │ │ │ │ -0001deb0: 6974 6564 2062 7920 3435 3832 3430 2062 ited by 458240 b │ │ │ │ │ -0001dec0: 7974 6573 2e20 206b 6572 6e65 6c2e 696d ytes. kernel.im │ │ │ │ │ -0001ded0: 6720 282e 7465 7874 202b 202e 6461 7461 g (.text + .data │ │ │ │ │ -0001dee0: 202b 202e 6273 732c 0a20 2020 2020 756e + .bss,. un │ │ │ │ │ -0001def0: 636f 6d70 7265 7373 6564 2920 6973 206c compressed) is l │ │ │ │ │ -0001df00: 696d 6974 6564 2062 7920 3339 3237 3034 imited by 392704 │ │ │ │ │ -0001df10: 2062 7974 6573 2e20 206d 6f64 756c 6520 bytes. module │ │ │ │ │ -0001df20: 7369 7a65 0a20 2020 2020 2875 6e63 6f6d size. (uncom │ │ │ │ │ -0001df30: 7072 6573 7365 6429 202b 206b 6572 6e65 pressed) + kerne │ │ │ │ │ -0001df40: 6c2e 696d 6720 282e 7465 7874 202b 202e l.img (.text + . │ │ │ │ │ -0001df50: 6461 7461 2c20 756e 636f 6d70 7265 7373 data, uncompress │ │ │ │ │ -0001df60: 6564 2920 6973 0a20 2020 2020 6c69 6d69 ed) is. limi │ │ │ │ │ -0001df70: 7465 6420 6279 2074 6865 2073 697a 6520 ted by the size │ │ │ │ │ -0001df80: 6f66 2063 6f6e 7469 6775 6f75 7320 6368 of contiguous ch │ │ │ │ │ -0001df90: 756e 6b20 6174 2031 4d20 6164 6472 6573 unk at 1M addres │ │ │ │ │ -0001dfa0: 732e 0a20 2020 2a20 7370 6172 6336 342d s.. * sparc64- │ │ │ │ │ -0001dfb0: 6965 6565 3132 3735 3a20 6b65 726e 656c ieee1275: kernel │ │ │ │ │ -0001dfc0: 2e69 6d67 2028 2e74 6578 7420 2b20 2e64 .img (.text + .d │ │ │ │ │ -0001dfd0: 6174 6120 2b20 2e62 7373 2920 2b20 6d6f ata + .bss) + mo │ │ │ │ │ -0001dfe0: 6475 6c65 7320 2b0a 2020 2020 2032 3536 dules +. 256 │ │ │ │ │ -0001dff0: 4b20 2873 7461 636b 2920 2b20 324d 2028 K (stack) + 2M ( │ │ │ │ │ -0001e000: 6865 6170 2920 6973 206c 696d 6974 6564 heap) is limited │ │ │ │ │ -0001e010: 2062 7920 7370 6163 6520 6176 6169 6c61 by space availa │ │ │ │ │ -0001e020: 626c 6520 6174 2030 7834 3430 302e 0a20 ble at 0x4400.. │ │ │ │ │ -0001e030: 2020 2020 4f6e 206d 6f73 7420 706c 6174 On most plat │ │ │ │ │ -0001e040: 666f 726d 7320 6974 2773 206a 7573 7420 forms it's just │ │ │ │ │ -0001e050: 3320 6f72 2034 4d20 7369 6e63 6520 6965 3 or 4M since ie │ │ │ │ │ -0001e060: 6565 3132 3735 206d 6170 7320 6f6e 6c79 ee1275 maps only │ │ │ │ │ -0001e070: 2073 6f0a 2020 2020 206d 7563 682e 0a20 so. much.. │ │ │ │ │ -0001e080: 2020 2a20 6933 3836 2d69 6565 6531 3237 * i386-ieee127 │ │ │ │ │ -0001e090: 353a 206b 6572 6e65 6c2e 696d 6720 282e 5: kernel.img (. │ │ │ │ │ -0001e0a0: 7465 7874 202b 202e 6461 7461 202b 202e text + .data + . │ │ │ │ │ -0001e0b0: 6273 7329 202b 206d 6f64 756c 6573 2069 bss) + modules i │ │ │ │ │ -0001e0c0: 730a 2020 2020 206c 696d 6974 6564 2062 s. limited b │ │ │ │ │ -0001e0d0: 7920 6d65 6d6f 7279 2061 7661 696c 6162 y memory availab │ │ │ │ │ -0001e0e0: 6c65 2061 7420 3078 3130 3030 302c 2061 le at 0x10000, a │ │ │ │ │ -0001e0f0: 7420 6d6f 7374 2035 3936 4b0a 0a20 2020 t most 596K.. │ │ │ │ │ -0001e100: 4c69 6768 746c 7920 6c69 6d69 7465 6420 Lightly limited │ │ │ │ │ -0001e110: 706c 6174 666f 726d 733a 0a0a 2020 202a platforms:.. * │ │ │ │ │ -0001e120: 202a 2d78 656e 3a20 6c69 6d69 7465 6420 *-xen: limited │ │ │ │ │ -0001e130: 6f6e 6c79 2062 7920 6164 7265 7373 2073 only by adress s │ │ │ │ │ -0001e140: 7061 6365 2061 6e64 2052 414d 2073 697a pace and RAM siz │ │ │ │ │ -0001e150: 652e 0a20 2020 2a20 6933 3836 2d71 656d e.. * i386-qem │ │ │ │ │ -0001e160: 753a 206b 6572 6e65 6c2e 696d 6720 282e u: kernel.img (. │ │ │ │ │ -0001e170: 7465 7874 202b 202e 6461 7461 202b 202e text + .data + . │ │ │ │ │ -0001e180: 6273 7329 2069 7320 6c69 6d69 7465 6420 bss) is limited │ │ │ │ │ -0001e190: 6279 2033 3932 3730 340a 2020 2020 2062 by 392704. b │ │ │ │ │ -0001e1a0: 7974 6573 2e20 2028 636f 7265 2e69 6d67 ytes. (core.img │ │ │ │ │ -0001e1b0: 2077 6f75 6c64 2062 6520 6c69 6d69 7465 would be limite │ │ │ │ │ -0001e1c0: 6420 6279 2052 4f4d 2073 697a 6520 6275 d by ROM size bu │ │ │ │ │ -0001e1d0: 7420 6974 2773 2075 6e6c 696d 6974 6564 t it's unlimited │ │ │ │ │ -0001e1e0: 0a20 2020 2020 6f6e 2071 656d 750a 2020 . on qemu. │ │ │ │ │ -0001e1f0: 202a 2041 6c6c 2045 4649 2070 6c61 7466 * All EFI platf │ │ │ │ │ -0001e200: 6f72 6d73 3a20 6c69 6d69 7465 6420 6279 orms: limited by │ │ │ │ │ -0001e210: 2063 6f6e 7469 6775 6f75 7320 5241 4d20 contiguous RAM │ │ │ │ │ -0001e220: 7369 7a65 2061 6e64 2070 6f73 7369 626c size and possibl │ │ │ │ │ -0001e230: 790a 2020 2020 2066 6972 6d77 6172 6520 y. firmware │ │ │ │ │ -0001e240: 6275 6773 0a20 2020 2a20 436f 7265 626f bugs. * Corebo │ │ │ │ │ -0001e250: 6f74 2061 6e64 206d 756c 7469 626f 6f74 ot and multiboot │ │ │ │ │ -0001e260: 2e20 206b 6572 6e65 6c2e 696d 6720 282e . kernel.img (. │ │ │ │ │ -0001e270: 7465 7874 202b 202e 6461 7461 202b 202e text + .data + . │ │ │ │ │ -0001e280: 6273 7329 2069 730a 2020 2020 206c 696d bss) is. lim │ │ │ │ │ -0001e290: 6974 6564 2062 7920 3339 3237 3034 2062 ited by 392704 b │ │ │ │ │ -0001e2a0: 7974 6573 2e20 206d 6f64 756c 6520 7369 ytes. module si │ │ │ │ │ -0001e2b0: 7a65 2069 7320 6c69 6d69 7465 6420 6279 ze is limited by │ │ │ │ │ -0001e2c0: 2074 6865 2073 697a 6520 6f66 0a20 2020 the size of. │ │ │ │ │ -0001e2d0: 2020 636f 6e74 6967 756f 7573 2063 6875 contiguous chu │ │ │ │ │ -0001e2e0: 6e6b 2061 7420 314d 2061 6464 7265 7373 nk at 1M address │ │ │ │ │ -0001e2f0: 2e0a 2020 202a 206d 6970 7365 6c2d 6c6f .. * mipsel-lo │ │ │ │ │ -0001e300: 6f6e 6773 6f6e 2028 454c 4629 2c20 6d69 ongson (ELF), mi │ │ │ │ │ -0001e310: 7073 2865 6c29 2d71 656d 755f 6d69 7073 ps(el)-qemu_mips │ │ │ │ │ -0001e320: 2028 454c 4629 3a20 6966 2075 6e63 6f6d (ELF): if uncom │ │ │ │ │ -0001e330: 7072 6573 7365 643a 0a20 2020 2020 6b65 pressed:. ke │ │ │ │ │ -0001e340: 726e 656c 2e69 6d67 2028 2e74 6578 7420 rnel.img (.text │ │ │ │ │ -0001e350: 2b20 2e64 6174 6129 202b 206d 6f64 756c + .data) + modul │ │ │ │ │ -0001e360: 6573 2069 7320 6c69 6d69 7465 6420 6279 es is limited by │ │ │ │ │ -0001e370: 2074 6865 2073 7061 6365 2066 726f 6d0a the space from. │ │ │ │ │ -0001e380: 2020 2020 2038 3032 3030 3030 3020 666f 80200000 fo │ │ │ │ │ -0001e390: 7277 6172 6420 6966 2063 6f6d 7072 6573 rward if compres │ │ │ │ │ -0001e3a0: 7365 643a 206b 6572 6e65 6c2e 696d 6720 sed: kernel.img │ │ │ │ │ -0001e3b0: 282e 7465 7874 202b 202e 6461 7461 2c0a (.text + .data,. │ │ │ │ │ -0001e3c0: 2020 2020 2075 6e63 6f6d 7072 6573 7365 uncompresse │ │ │ │ │ -0001e3d0: 6429 202b 206d 6f64 756c 6573 2028 756e d) + modules (un │ │ │ │ │ -0001e3e0: 636f 6d70 7265 7373 6564 2920 2b20 286d compressed) + (m │ │ │ │ │ -0001e3f0: 6f64 756c 6573 202b 206b 6572 6e65 6c2e odules + kernel. │ │ │ │ │ -0001e400: 696d 670a 2020 2020 2028 2e74 6578 7420 img. (.text │ │ │ │ │ -0001e410: 2b20 2e64 6174 6129 2920 2863 6f6d 7072 + .data)) (compr │ │ │ │ │ -0001e420: 6573 7365 6429 202b 2064 6563 6f6d 7072 essed) + decompr │ │ │ │ │ -0001e430: 6573 736f 7220 6973 206c 696d 6974 6564 essor is limited │ │ │ │ │ -0001e440: 2062 7920 7468 650a 2020 2020 2073 7061 by the. spa │ │ │ │ │ -0001e450: 6365 2066 726f 6d20 3830 3230 3030 3030 ce from 80200000 │ │ │ │ │ -0001e460: 2066 6f72 7761 7264 0a20 2020 2a20 6d69 forward. * mi │ │ │ │ │ -0001e470: 7073 656c 2d6c 6f6f 6e67 736f 6e20 2846 psel-loongson (F │ │ │ │ │ -0001e480: 6c61 7368 292c 206d 6970 7328 656c 292d lash), mips(el)- │ │ │ │ │ -0001e490: 7165 6d75 5f6d 6970 7320 2846 6c61 7368 qemu_mips (Flash │ │ │ │ │ -0001e4a0: 293a 206b 6572 6e65 6c2e 696d 670a 2020 ): kernel.img. │ │ │ │ │ -0001e4b0: 2020 2028 2e74 6578 7420 2b20 2e64 6174 (.text + .dat │ │ │ │ │ -0001e4c0: 6129 202b 206d 6f64 756c 6573 2069 7320 a) + modules is │ │ │ │ │ -0001e4d0: 6c69 6d69 7465 6420 6279 2074 6865 2073 limited by the s │ │ │ │ │ -0001e4e0: 7061 6365 2066 726f 6d20 3830 3230 3030 pace from 802000 │ │ │ │ │ -0001e4f0: 3030 0a20 2020 2020 666f 7277 6172 6420 00. forward │ │ │ │ │ -0001e500: 636f 7265 2e69 6d67 2028 6669 6e61 6c29 core.img (final) │ │ │ │ │ -0001e510: 2069 7320 6c69 6d69 7465 6420 6279 2066 is limited by f │ │ │ │ │ -0001e520: 6c61 7368 2073 697a 6520 2835 3132 4b20 lash size (512K │ │ │ │ │ -0001e530: 6f6e 2079 6565 6c6f 6f6e 670a 2020 2020 on yeeloong. │ │ │ │ │ -0001e540: 2061 6e64 2066 756c 6f6f 6f6e 6729 0a20 and fulooong). │ │ │ │ │ -0001e550: 2020 2a20 6d69 7073 2d61 7263 3a20 6966 * mips-arc: if │ │ │ │ │ -0001e560: 2075 6e63 6f6d 7072 6573 7365 643a 206b uncompressed: k │ │ │ │ │ -0001e570: 6572 6e65 6c2e 696d 6720 282e 7465 7874 ernel.img (.text │ │ │ │ │ -0001e580: 202b 202e 6461 7461 2920 6973 206c 696d + .data) is lim │ │ │ │ │ -0001e590: 6974 6564 2062 790a 2020 2020 2074 6865 ited by. the │ │ │ │ │ -0001e5a0: 2073 7061 6365 2066 726f 6d20 3862 6430 space from 8bd0 │ │ │ │ │ -0001e5b0: 3030 3030 2066 6f72 7761 7264 206d 6f64 0000 forward mod │ │ │ │ │ -0001e5c0: 756c 6573 202b 2064 756d 6d79 2064 6563 ules + dummy dec │ │ │ │ │ -0001e5d0: 6f6d 7072 6573 736f 7220 6973 0a20 2020 ompressor is. │ │ │ │ │ -0001e5e0: 2020 6c69 6d69 7465 6420 6279 2074 6865 limited by the │ │ │ │ │ -0001e5f0: 2073 7061 6365 2066 726f 6d20 3862 6430 space from 8bd0 │ │ │ │ │ -0001e600: 3030 3030 2062 6163 6b77 6172 6420 6966 0000 backward if │ │ │ │ │ -0001e610: 2063 6f6d 7072 6573 7365 643a 0a20 2020 compressed:. │ │ │ │ │ -0001e620: 2020 6b65 726e 656c 2e69 6d67 2028 2e74 kernel.img (.t │ │ │ │ │ -0001e630: 6578 7420 2b20 2e64 6174 612c 2075 6e63 ext + .data, unc │ │ │ │ │ -0001e640: 6f6d 7072 6573 7365 6429 2069 7320 6c69 ompressed) is li │ │ │ │ │ -0001e650: 6d69 7465 6420 6279 2074 6865 2073 7061 mited by the spa │ │ │ │ │ -0001e660: 6365 0a20 2020 2020 6672 6f6d 2038 6264 ce. from 8bd │ │ │ │ │ -0001e670: 3030 3030 3020 666f 7277 6172 6420 6d6f 00000 forward mo │ │ │ │ │ -0001e680: 6475 6c65 7320 2875 6e63 6f6d 7072 6573 dules (uncompres │ │ │ │ │ -0001e690: 7365 6429 202b 2028 6d6f 6475 6c65 7320 sed) + (modules │ │ │ │ │ -0001e6a0: 2b0a 2020 2020 206b 6572 6e65 6c2e 696d +. kernel.im │ │ │ │ │ -0001e6b0: 6720 282e 7465 7874 202b 202e 6461 7461 g (.text + .data │ │ │ │ │ -0001e6c0: 2929 2028 636f 6d70 7265 7373 6564 2c20 )) (compressed, │ │ │ │ │ -0001e6d0: 616c 6967 6e65 6420 746f 2031 4d29 202b aligned to 1M) + │ │ │ │ │ -0001e6e0: 2031 4d0a 2020 2020 2028 6465 636f 6d70 1M. (decomp │ │ │ │ │ -0001e6f0: 7265 7373 6f72 202b 2073 6372 6174 6368 ressor + scratch │ │ │ │ │ -0001e700: 2073 7061 6365 2920 6973 206c 696d 6974 space) is limit │ │ │ │ │ -0001e710: 6564 2062 7920 7468 6520 7370 6163 6520 ed by the space │ │ │ │ │ -0001e720: 6672 6f6d 0a20 2020 2020 3862 6430 3030 from. 8bd000 │ │ │ │ │ -0001e730: 3030 2062 6163 6b77 6172 640a 2020 202a 00 backward. * │ │ │ │ │ -0001e740: 2070 6f77 6572 7063 2d69 6565 6531 3237 powerpc-ieee127 │ │ │ │ │ -0001e750: 353a 206b 6572 6e65 6c2e 696d 6720 282e 5: kernel.img (. │ │ │ │ │ -0001e760: 7465 7874 202b 202e 6461 7461 202b 202e text + .data + . │ │ │ │ │ -0001e770: 6273 7329 202b 206d 6f64 756c 6573 2069 bss) + modules i │ │ │ │ │ -0001e780: 730a 2020 2020 206c 696d 6974 6564 2062 s. limited b │ │ │ │ │ -0001e790: 7920 7370 6163 6520 6176 6169 6c61 626c y space availabl │ │ │ │ │ -0001e7a0: 6520 6174 2030 7832 3030 3030 300a 0a1f e at 0x200000... │ │ │ │ │ -0001e7b0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -0001e7c0: 2c20 204e 6f64 653a 2046 696c 6573 7973 , Node: Filesys │ │ │ │ │ -0001e7d0: 7465 6d2c 2020 4e65 7874 3a20 496e 7465 tem, Next: Inte │ │ │ │ │ -0001e7e0: 7266 6163 652c 2020 5072 6576 3a20 436f rface, Prev: Co │ │ │ │ │ -0001e7f0: 7265 2069 6d61 6765 2073 697a 6520 6c69 re image size li │ │ │ │ │ -0001e800: 6d69 7461 7469 6f6e 2c20 2055 703a 2054 mitation, Up: T │ │ │ │ │ -0001e810: 6f70 0a0a 3133 2046 696c 6573 7973 7465 op..13 Filesyste │ │ │ │ │ -0001e820: 6d20 7379 6e74 6178 2061 6e64 2073 656d m syntax and sem │ │ │ │ │ -0001e830: 616e 7469 6373 0a2a 2a2a 2a2a 2a2a 2a2a antics.********* │ │ │ │ │ +0001de40: 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4865 6176 **********..Heav │ │ │ │ │ +0001de50: 696c 7920 6c69 6d69 7465 6420 706c 6174 ily limited plat │ │ │ │ │ +0001de60: 666f 726d 733a 0a20 2020 2a20 6933 3836 forms:. * i386 │ │ │ │ │ +0001de70: 2d70 6320 286e 6f72 6d61 6c20 616e 6420 -pc (normal and │ │ │ │ │ +0001de80: 5058 4529 3a20 7468 6520 636f 7265 2069 PXE): the core i │ │ │ │ │ +0001de90: 6d61 6765 2073 697a 6520 2863 6f6d 7072 mage size (compr │ │ │ │ │ +0001dea0: 6573 7365 6429 2069 730a 2020 2020 206c essed) is. l │ │ │ │ │ +0001deb0: 696d 6974 6564 2062 7920 3435 3832 3430 imited by 458240 │ │ │ │ │ +0001dec0: 2062 7974 6573 2e20 206b 6572 6e65 6c2e bytes. kernel. │ │ │ │ │ +0001ded0: 696d 6720 282e 7465 7874 202b 202e 6461 img (.text + .da │ │ │ │ │ +0001dee0: 7461 202b 202e 6273 732c 0a20 2020 2020 ta + .bss,. │ │ │ │ │ +0001def0: 756e 636f 6d70 7265 7373 6564 2920 6973 uncompressed) is │ │ │ │ │ +0001df00: 206c 696d 6974 6564 2062 7920 3339 3237 limited by 3927 │ │ │ │ │ +0001df10: 3034 2062 7974 6573 2e20 206d 6f64 756c 04 bytes. modul │ │ │ │ │ +0001df20: 6520 7369 7a65 0a20 2020 2020 2875 6e63 e size. (unc │ │ │ │ │ +0001df30: 6f6d 7072 6573 7365 6429 202b 206b 6572 ompressed) + ker │ │ │ │ │ +0001df40: 6e65 6c2e 696d 6720 282e 7465 7874 202b nel.img (.text + │ │ │ │ │ +0001df50: 202e 6461 7461 2c20 756e 636f 6d70 7265 .data, uncompre │ │ │ │ │ +0001df60: 7373 6564 2920 6973 0a20 2020 2020 6c69 ssed) is. li │ │ │ │ │ +0001df70: 6d69 7465 6420 6279 2074 6865 2073 697a mited by the siz │ │ │ │ │ +0001df80: 6520 6f66 2063 6f6e 7469 6775 6f75 7320 e of contiguous │ │ │ │ │ +0001df90: 6368 756e 6b20 6174 2031 4d20 6164 6472 chunk at 1M addr │ │ │ │ │ +0001dfa0: 6573 732e 0a20 2020 2a20 7370 6172 6336 ess.. * sparc6 │ │ │ │ │ +0001dfb0: 342d 6965 6565 3132 3735 3a20 6b65 726e 4-ieee1275: kern │ │ │ │ │ +0001dfc0: 656c 2e69 6d67 2028 2e74 6578 7420 2b20 el.img (.text + │ │ │ │ │ +0001dfd0: 2e64 6174 6120 2b20 2e62 7373 2920 2b20 .data + .bss) + │ │ │ │ │ +0001dfe0: 6d6f 6475 6c65 7320 2b0a 2020 2020 2032 modules +. 2 │ │ │ │ │ +0001dff0: 3536 4b20 2873 7461 636b 2920 2b20 324d 56K (stack) + 2M │ │ │ │ │ +0001e000: 2028 6865 6170 2920 6973 206c 696d 6974 (heap) is limit │ │ │ │ │ +0001e010: 6564 2062 7920 7370 6163 6520 6176 6169 ed by space avai │ │ │ │ │ +0001e020: 6c61 626c 6520 6174 2030 7834 3430 302e lable at 0x4400. │ │ │ │ │ +0001e030: 0a20 2020 2020 4f6e 206d 6f73 7420 706c . On most pl │ │ │ │ │ +0001e040: 6174 666f 726d 7320 6974 2773 206a 7573 atforms it's jus │ │ │ │ │ +0001e050: 7420 3320 6f72 2034 4d20 7369 6e63 6520 t 3 or 4M since │ │ │ │ │ +0001e060: 6965 6565 3132 3735 206d 6170 7320 6f6e ieee1275 maps on │ │ │ │ │ +0001e070: 6c79 2073 6f0a 2020 2020 206d 7563 682e ly so. much. │ │ │ │ │ +0001e080: 0a20 2020 2a20 6933 3836 2d69 6565 6531 . * i386-ieee1 │ │ │ │ │ +0001e090: 3237 353a 206b 6572 6e65 6c2e 696d 6720 275: kernel.img │ │ │ │ │ +0001e0a0: 282e 7465 7874 202b 202e 6461 7461 202b (.text + .data + │ │ │ │ │ +0001e0b0: 202e 6273 7329 202b 206d 6f64 756c 6573 .bss) + modules │ │ │ │ │ +0001e0c0: 2069 730a 2020 2020 206c 696d 6974 6564 is. limited │ │ │ │ │ +0001e0d0: 2062 7920 6d65 6d6f 7279 2061 7661 696c by memory avail │ │ │ │ │ +0001e0e0: 6162 6c65 2061 7420 3078 3130 3030 302c able at 0x10000, │ │ │ │ │ +0001e0f0: 2061 7420 6d6f 7374 2035 3936 4b0a 0a20 at most 596K.. │ │ │ │ │ +0001e100: 2020 4c69 6768 746c 7920 6c69 6d69 7465 Lightly limite │ │ │ │ │ +0001e110: 6420 706c 6174 666f 726d 733a 0a0a 2020 d platforms:.. │ │ │ │ │ +0001e120: 202a 202a 2d78 656e 3a20 6c69 6d69 7465 * *-xen: limite │ │ │ │ │ +0001e130: 6420 6f6e 6c79 2062 7920 6164 7265 7373 d only by adress │ │ │ │ │ +0001e140: 2073 7061 6365 2061 6e64 2052 414d 2073 space and RAM s │ │ │ │ │ +0001e150: 697a 652e 0a20 2020 2a20 6933 3836 2d71 ize.. * i386-q │ │ │ │ │ +0001e160: 656d 753a 206b 6572 6e65 6c2e 696d 6720 emu: kernel.img │ │ │ │ │ +0001e170: 282e 7465 7874 202b 202e 6461 7461 202b (.text + .data + │ │ │ │ │ +0001e180: 202e 6273 7329 2069 7320 6c69 6d69 7465 .bss) is limite │ │ │ │ │ +0001e190: 6420 6279 2033 3932 3730 340a 2020 2020 d by 392704. │ │ │ │ │ +0001e1a0: 2062 7974 6573 2e20 2028 636f 7265 2e69 bytes. (core.i │ │ │ │ │ +0001e1b0: 6d67 2077 6f75 6c64 2062 6520 6c69 6d69 mg would be limi │ │ │ │ │ +0001e1c0: 7465 6420 6279 2052 4f4d 2073 697a 6520 ted by ROM size │ │ │ │ │ +0001e1d0: 6275 7420 6974 2773 2075 6e6c 696d 6974 but it's unlimit │ │ │ │ │ +0001e1e0: 6564 0a20 2020 2020 6f6e 2071 656d 750a ed. on qemu. │ │ │ │ │ +0001e1f0: 2020 202a 2041 6c6c 2045 4649 2070 6c61 * All EFI pla │ │ │ │ │ +0001e200: 7466 6f72 6d73 3a20 6c69 6d69 7465 6420 tforms: limited │ │ │ │ │ +0001e210: 6279 2063 6f6e 7469 6775 6f75 7320 5241 by contiguous RA │ │ │ │ │ +0001e220: 4d20 7369 7a65 2061 6e64 2070 6f73 7369 M size and possi │ │ │ │ │ +0001e230: 626c 790a 2020 2020 2066 6972 6d77 6172 bly. firmwar │ │ │ │ │ +0001e240: 6520 6275 6773 0a20 2020 2a20 436f 7265 e bugs. * Core │ │ │ │ │ +0001e250: 626f 6f74 2061 6e64 206d 756c 7469 626f boot and multibo │ │ │ │ │ +0001e260: 6f74 2e20 206b 6572 6e65 6c2e 696d 6720 ot. kernel.img │ │ │ │ │ +0001e270: 282e 7465 7874 202b 202e 6461 7461 202b (.text + .data + │ │ │ │ │ +0001e280: 202e 6273 7329 2069 730a 2020 2020 206c .bss) is. l │ │ │ │ │ +0001e290: 696d 6974 6564 2062 7920 3339 3237 3034 imited by 392704 │ │ │ │ │ +0001e2a0: 2062 7974 6573 2e20 206d 6f64 756c 6520 bytes. module │ │ │ │ │ +0001e2b0: 7369 7a65 2069 7320 6c69 6d69 7465 6420 size is limited │ │ │ │ │ +0001e2c0: 6279 2074 6865 2073 697a 6520 6f66 0a20 by the size of. │ │ │ │ │ +0001e2d0: 2020 2020 636f 6e74 6967 756f 7573 2063 contiguous c │ │ │ │ │ +0001e2e0: 6875 6e6b 2061 7420 314d 2061 6464 7265 hunk at 1M addre │ │ │ │ │ +0001e2f0: 7373 2e0a 2020 202a 206d 6970 7365 6c2d ss.. * mipsel- │ │ │ │ │ +0001e300: 6c6f 6f6e 6773 6f6e 2028 454c 4629 2c20 loongson (ELF), │ │ │ │ │ +0001e310: 6d69 7073 2865 6c29 2d71 656d 755f 6d69 mips(el)-qemu_mi │ │ │ │ │ +0001e320: 7073 2028 454c 4629 3a20 6966 2075 6e63 ps (ELF): if unc │ │ │ │ │ +0001e330: 6f6d 7072 6573 7365 643a 0a20 2020 2020 ompressed:. │ │ │ │ │ +0001e340: 6b65 726e 656c 2e69 6d67 2028 2e74 6578 kernel.img (.tex │ │ │ │ │ +0001e350: 7420 2b20 2e64 6174 6129 202b 206d 6f64 t + .data) + mod │ │ │ │ │ +0001e360: 756c 6573 2069 7320 6c69 6d69 7465 6420 ules is limited │ │ │ │ │ +0001e370: 6279 2074 6865 2073 7061 6365 2066 726f by the space fro │ │ │ │ │ +0001e380: 6d0a 2020 2020 2038 3032 3030 3030 3020 m. 80200000 │ │ │ │ │ +0001e390: 666f 7277 6172 6420 6966 2063 6f6d 7072 forward if compr │ │ │ │ │ +0001e3a0: 6573 7365 643a 206b 6572 6e65 6c2e 696d essed: kernel.im │ │ │ │ │ +0001e3b0: 6720 282e 7465 7874 202b 202e 6461 7461 g (.text + .data │ │ │ │ │ +0001e3c0: 2c0a 2020 2020 2075 6e63 6f6d 7072 6573 ,. uncompres │ │ │ │ │ +0001e3d0: 7365 6429 202b 206d 6f64 756c 6573 2028 sed) + modules ( │ │ │ │ │ +0001e3e0: 756e 636f 6d70 7265 7373 6564 2920 2b20 uncompressed) + │ │ │ │ │ +0001e3f0: 286d 6f64 756c 6573 202b 206b 6572 6e65 (modules + kerne │ │ │ │ │ +0001e400: 6c2e 696d 670a 2020 2020 2028 2e74 6578 l.img. (.tex │ │ │ │ │ +0001e410: 7420 2b20 2e64 6174 6129 2920 2863 6f6d t + .data)) (com │ │ │ │ │ +0001e420: 7072 6573 7365 6429 202b 2064 6563 6f6d pressed) + decom │ │ │ │ │ +0001e430: 7072 6573 736f 7220 6973 206c 696d 6974 pressor is limit │ │ │ │ │ +0001e440: 6564 2062 7920 7468 650a 2020 2020 2073 ed by the. s │ │ │ │ │ +0001e450: 7061 6365 2066 726f 6d20 3830 3230 3030 pace from 802000 │ │ │ │ │ +0001e460: 3030 2066 6f72 7761 7264 0a20 2020 2a20 00 forward. * │ │ │ │ │ +0001e470: 6d69 7073 656c 2d6c 6f6f 6e67 736f 6e20 mipsel-loongson │ │ │ │ │ +0001e480: 2846 6c61 7368 292c 206d 6970 7328 656c (Flash), mips(el │ │ │ │ │ +0001e490: 292d 7165 6d75 5f6d 6970 7320 2846 6c61 )-qemu_mips (Fla │ │ │ │ │ +0001e4a0: 7368 293a 206b 6572 6e65 6c2e 696d 670a sh): kernel.img. │ │ │ │ │ +0001e4b0: 2020 2020 2028 2e74 6578 7420 2b20 2e64 (.text + .d │ │ │ │ │ +0001e4c0: 6174 6129 202b 206d 6f64 756c 6573 2069 ata) + modules i │ │ │ │ │ +0001e4d0: 7320 6c69 6d69 7465 6420 6279 2074 6865 s limited by the │ │ │ │ │ +0001e4e0: 2073 7061 6365 2066 726f 6d20 3830 3230 space from 8020 │ │ │ │ │ +0001e4f0: 3030 3030 0a20 2020 2020 666f 7277 6172 0000. forwar │ │ │ │ │ +0001e500: 6420 636f 7265 2e69 6d67 2028 6669 6e61 d core.img (fina │ │ │ │ │ +0001e510: 6c29 2069 7320 6c69 6d69 7465 6420 6279 l) is limited by │ │ │ │ │ +0001e520: 2066 6c61 7368 2073 697a 6520 2835 3132 flash size (512 │ │ │ │ │ +0001e530: 4b20 6f6e 2079 6565 6c6f 6f6e 670a 2020 K on yeeloong. │ │ │ │ │ +0001e540: 2020 2061 6e64 2066 756c 6f6f 6f6e 6729 and fulooong) │ │ │ │ │ +0001e550: 0a20 2020 2a20 6d69 7073 2d61 7263 3a20 . * mips-arc: │ │ │ │ │ +0001e560: 6966 2075 6e63 6f6d 7072 6573 7365 643a if uncompressed: │ │ │ │ │ +0001e570: 206b 6572 6e65 6c2e 696d 6720 282e 7465 kernel.img (.te │ │ │ │ │ +0001e580: 7874 202b 202e 6461 7461 2920 6973 206c xt + .data) is l │ │ │ │ │ +0001e590: 696d 6974 6564 2062 790a 2020 2020 2074 imited by. t │ │ │ │ │ +0001e5a0: 6865 2073 7061 6365 2066 726f 6d20 3862 he space from 8b │ │ │ │ │ +0001e5b0: 6430 3030 3030 2066 6f72 7761 7264 206d d00000 forward m │ │ │ │ │ +0001e5c0: 6f64 756c 6573 202b 2064 756d 6d79 2064 odules + dummy d │ │ │ │ │ +0001e5d0: 6563 6f6d 7072 6573 736f 7220 6973 0a20 ecompressor is. │ │ │ │ │ +0001e5e0: 2020 2020 6c69 6d69 7465 6420 6279 2074 limited by t │ │ │ │ │ +0001e5f0: 6865 2073 7061 6365 2066 726f 6d20 3862 he space from 8b │ │ │ │ │ +0001e600: 6430 3030 3030 2062 6163 6b77 6172 6420 d00000 backward │ │ │ │ │ +0001e610: 6966 2063 6f6d 7072 6573 7365 643a 0a20 if compressed:. │ │ │ │ │ +0001e620: 2020 2020 6b65 726e 656c 2e69 6d67 2028 kernel.img ( │ │ │ │ │ +0001e630: 2e74 6578 7420 2b20 2e64 6174 612c 2075 .text + .data, u │ │ │ │ │ +0001e640: 6e63 6f6d 7072 6573 7365 6429 2069 7320 ncompressed) is │ │ │ │ │ +0001e650: 6c69 6d69 7465 6420 6279 2074 6865 2073 limited by the s │ │ │ │ │ +0001e660: 7061 6365 0a20 2020 2020 6672 6f6d 2038 pace. from 8 │ │ │ │ │ +0001e670: 6264 3030 3030 3020 666f 7277 6172 6420 bd00000 forward │ │ │ │ │ +0001e680: 6d6f 6475 6c65 7320 2875 6e63 6f6d 7072 modules (uncompr │ │ │ │ │ +0001e690: 6573 7365 6429 202b 2028 6d6f 6475 6c65 essed) + (module │ │ │ │ │ +0001e6a0: 7320 2b0a 2020 2020 206b 6572 6e65 6c2e s +. kernel. │ │ │ │ │ +0001e6b0: 696d 6720 282e 7465 7874 202b 202e 6461 img (.text + .da │ │ │ │ │ +0001e6c0: 7461 2929 2028 636f 6d70 7265 7373 6564 ta)) (compressed │ │ │ │ │ +0001e6d0: 2c20 616c 6967 6e65 6420 746f 2031 4d29 , aligned to 1M) │ │ │ │ │ +0001e6e0: 202b 2031 4d0a 2020 2020 2028 6465 636f + 1M. (deco │ │ │ │ │ +0001e6f0: 6d70 7265 7373 6f72 202b 2073 6372 6174 mpressor + scrat │ │ │ │ │ +0001e700: 6368 2073 7061 6365 2920 6973 206c 696d ch space) is lim │ │ │ │ │ +0001e710: 6974 6564 2062 7920 7468 6520 7370 6163 ited by the spac │ │ │ │ │ +0001e720: 6520 6672 6f6d 0a20 2020 2020 3862 6430 e from. 8bd0 │ │ │ │ │ +0001e730: 3030 3030 2062 6163 6b77 6172 640a 2020 0000 backward. │ │ │ │ │ +0001e740: 202a 2070 6f77 6572 7063 2d69 6565 6531 * powerpc-ieee1 │ │ │ │ │ +0001e750: 3237 353a 206b 6572 6e65 6c2e 696d 6720 275: kernel.img │ │ │ │ │ +0001e760: 282e 7465 7874 202b 202e 6461 7461 202b (.text + .data + │ │ │ │ │ +0001e770: 202e 6273 7329 202b 206d 6f64 756c 6573 .bss) + modules │ │ │ │ │ +0001e780: 2069 730a 2020 2020 206c 696d 6974 6564 is. limited │ │ │ │ │ +0001e790: 2062 7920 7370 6163 6520 6176 6169 6c61 by space availa │ │ │ │ │ +0001e7a0: 626c 6520 6174 2030 7832 3030 3030 300a ble at 0x200000. │ │ │ │ │ +0001e7b0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +0001e7c0: 666f 2c20 204e 6f64 653a 2046 696c 6573 fo, Node: Files │ │ │ │ │ +0001e7d0: 7973 7465 6d2c 2020 4e65 7874 3a20 496e ystem, Next: In │ │ │ │ │ +0001e7e0: 7465 7266 6163 652c 2020 5072 6576 3a20 terface, Prev: │ │ │ │ │ +0001e7f0: 436f 7265 2069 6d61 6765 2073 697a 6520 Core image size │ │ │ │ │ +0001e800: 6c69 6d69 7461 7469 6f6e 2c20 2055 703a limitation, Up: │ │ │ │ │ +0001e810: 2054 6f70 0a0a 3133 2046 696c 6573 7973 Top..13 Filesys │ │ │ │ │ +0001e820: 7465 6d20 7379 6e74 6178 2061 6e64 2073 tem syntax and s │ │ │ │ │ +0001e830: 656d 616e 7469 6373 0a2a 2a2a 2a2a 2a2a emantics.******* │ │ │ │ │ 0001e840: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0001e850: 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 5255 4220 *********..GRUB │ │ │ │ │ -0001e860: 7573 6573 2061 2073 7065 6369 616c 2073 uses a special s │ │ │ │ │ -0001e870: 796e 7461 7820 666f 7220 7370 6563 6966 yntax for specif │ │ │ │ │ -0001e880: 7969 6e67 2064 6973 6b20 6472 6976 6573 ying disk drives │ │ │ │ │ -0001e890: 2077 6869 6368 2063 616e 2062 650a 6163 which can be.ac │ │ │ │ │ -0001e8a0: 6365 7373 6564 2062 7920 4249 4f53 2e20 cessed by BIOS. │ │ │ │ │ -0001e8b0: 4265 6361 7573 6520 6f66 2042 494f 5320 Because of BIOS │ │ │ │ │ -0001e8c0: 6c69 6d69 7461 7469 6f6e 732c 2047 5255 limitations, GRU │ │ │ │ │ -0001e8d0: 4220 6361 6e6e 6f74 2064 6973 7469 6e67 B cannot disting │ │ │ │ │ -0001e8e0: 7569 7368 0a62 6574 7765 656e 2049 4445 uish.between IDE │ │ │ │ │ -0001e8f0: 2c20 4553 4449 2c20 5343 5349 2c20 6f72 , ESDI, SCSI, or │ │ │ │ │ -0001e900: 206f 7468 6572 732e 2020 596f 7520 6d75 others. You mu │ │ │ │ │ -0001e910: 7374 206b 6e6f 7720 796f 7572 7365 6c66 st know yourself │ │ │ │ │ -0001e920: 2077 6869 6368 2042 494f 530a 6465 7669 which BIOS.devi │ │ │ │ │ -0001e930: 6365 2069 7320 6571 7569 7661 6c65 6e74 ce is equivalent │ │ │ │ │ -0001e940: 2074 6f20 7768 6963 6820 4f53 2064 6576 to which OS dev │ │ │ │ │ -0001e950: 6963 652e 2020 4e6f 726d 616c 6c79 2c20 ice. Normally, │ │ │ │ │ -0001e960: 7468 6174 2077 696c 6c20 6265 2063 6c65 that will be cle │ │ │ │ │ -0001e970: 6172 0a69 6620 796f 7520 7365 6520 7468 ar.if you see th │ │ │ │ │ -0001e980: 6520 6669 6c65 7320 696e 2061 2064 6576 e files in a dev │ │ │ │ │ -0001e990: 6963 6520 6f72 2075 7365 2074 6865 2063 ice or use the c │ │ │ │ │ -0001e9a0: 6f6d 6d61 6e64 2027 7365 6172 6368 2720 ommand 'search' │ │ │ │ │ -0001e9b0: 282a 6e6f 7465 0a73 6561 7263 683a 3a29 (*note.search::) │ │ │ │ │ -0001e9c0: 2e0a 0a2a 204d 656e 753a 0a0a 2a20 4465 ...* Menu:..* De │ │ │ │ │ -0001e9d0: 7669 6365 2073 796e 7461 783a 3a20 2020 vice syntax:: │ │ │ │ │ -0001e9e0: 2020 2020 2020 2020 2020 2020 486f 7720 How │ │ │ │ │ -0001e9f0: 746f 2073 7065 6369 6679 2064 6576 6963 to specify devic │ │ │ │ │ -0001ea00: 6573 0a2a 2046 696c 6520 6e61 6d65 2073 es.* File name s │ │ │ │ │ -0001ea10: 796e 7461 783a 3a20 2020 2020 2020 2020 yntax:: │ │ │ │ │ -0001ea20: 2020 2048 6f77 2074 6f20 7370 6563 6966 How to specif │ │ │ │ │ -0001ea30: 7920 6669 6c65 730a 2a20 426c 6f63 6b20 y files.* Block │ │ │ │ │ -0001ea40: 6c69 7374 2073 796e 7461 783a 3a20 2020 list syntax:: │ │ │ │ │ -0001ea50: 2020 2020 2020 2020 486f 7720 746f 2073 How to s │ │ │ │ │ -0001ea60: 7065 6369 6679 2062 6c6f 636b 206c 6973 pecify block lis │ │ │ │ │ -0001ea70: 7473 0a0a 1f0a 4669 6c65 3a20 6772 7562 ts....File: grub │ │ │ │ │ -0001ea80: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4465 .info, Node: De │ │ │ │ │ -0001ea90: 7669 6365 2073 796e 7461 782c 2020 4e65 vice syntax, Ne │ │ │ │ │ -0001eaa0: 7874 3a20 4669 6c65 206e 616d 6520 7379 xt: File name sy │ │ │ │ │ -0001eab0: 6e74 6178 2c20 2055 703a 2046 696c 6573 ntax, Up: Files │ │ │ │ │ -0001eac0: 7973 7465 6d0a 0a31 332e 3120 486f 7720 ystem..13.1 How │ │ │ │ │ -0001ead0: 746f 2073 7065 6369 6679 2064 6576 6963 to specify devic │ │ │ │ │ -0001eae0: 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d es.============= │ │ │ │ │ -0001eaf0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -0001eb00: 5468 6520 6465 7669 6365 2073 796e 7461 The device synta │ │ │ │ │ -0001eb10: 7820 6973 206c 696b 6520 7468 6973 3a0a x is like this:. │ │ │ │ │ -0001eb20: 0a20 2020 2020 2844 4556 4943 455b 2c50 . (DEVICE[,P │ │ │ │ │ -0001eb30: 4152 544d 4150 2d4e 414d 4531 5041 5254 ARTMAP-NAME1PART │ │ │ │ │ -0001eb40: 2d4e 554d 315b 2c50 4152 544d 4150 2d4e -NUM1[,PARTMAP-N │ │ │ │ │ -0001eb50: 414d 4532 5041 5254 2d4e 554d 325b 2c2e AME2PART-NUM2[,. │ │ │ │ │ -0001eb60: 2e2e 5d5d 5d29 0a0a 2020 2027 5b5d 2720 ..]]]).. '[]' │ │ │ │ │ -0001eb70: 6d65 616e 7320 7468 6520 7061 7261 6d65 means the parame │ │ │ │ │ -0001eb80: 7465 7220 6973 206f 7074 696f 6e61 6c2e ter is optional. │ │ │ │ │ -0001eb90: 2020 4445 5649 4345 2064 6570 656e 6473 DEVICE depends │ │ │ │ │ -0001eba0: 206f 6e20 7468 6520 6469 736b 0a64 7269 on the disk.dri │ │ │ │ │ -0001ebb0: 7665 7220 696e 2075 7365 2e20 2042 494f ver in use. BIO │ │ │ │ │ -0001ebc0: 5320 616e 6420 4546 4920 6469 736b 7320 S and EFI disks │ │ │ │ │ -0001ebd0: 7573 6520 6569 7468 6572 2027 6664 2720 use either 'fd' │ │ │ │ │ -0001ebe0: 6f72 2027 6864 2720 666f 6c6c 6f77 6564 or 'hd' followed │ │ │ │ │ -0001ebf0: 2062 7920 610a 6469 6769 742c 206c 696b by a.digit, lik │ │ │ │ │ -0001ec00: 6520 2766 6430 272c 206f 7220 2763 6427 e 'fd0', or 'cd' │ │ │ │ │ -0001ec10: 2e20 2041 4843 492c 2050 4154 4120 2861 . AHCI, PATA (a │ │ │ │ │ -0001ec20: 7461 292c 2063 7279 7074 6f2c 2055 5342 ta), crypto, USB │ │ │ │ │ -0001ec30: 2075 7365 2074 6865 206e 616d 650a 6f66 use the name.of │ │ │ │ │ -0001ec40: 2064 7269 7665 7220 666f 6c6c 6f77 6564 driver followed │ │ │ │ │ -0001ec50: 2062 7920 6120 6e75 6d62 6572 2e20 204d by a number. M │ │ │ │ │ -0001ec60: 656d 6469 736b 2061 6e64 2068 6f73 7420 emdisk and host │ │ │ │ │ -0001ec70: 6172 6520 6c69 6d69 7465 6420 746f 206f are limited to o │ │ │ │ │ -0001ec80: 6e65 0a64 6973 6b20 616e 6420 736f 2069 ne.disk and so i │ │ │ │ │ -0001ec90: 7427 7320 7265 6665 7265 6420 6a75 7374 t's refered just │ │ │ │ │ -0001eca0: 2062 7920 6472 6976 6572 206e 616d 652e by driver name. │ │ │ │ │ -0001ecb0: 2020 5241 4944 2028 6d64 292c 206f 6664 RAID (md), ofd │ │ │ │ │ -0001ecc0: 6973 6b0a 2869 6565 6531 3237 3520 616e isk.(ieee1275 an │ │ │ │ │ -0001ecd0: 6420 6e61 6e64 292c 204c 564d 2028 6c76 d nand), LVM (lv │ │ │ │ │ -0001ece0: 6d29 2c20 4c44 4d2c 2076 6972 7469 6f20 m), LDM, virtio │ │ │ │ │ -0001ecf0: 2876 6473 6b29 2061 6e64 2061 7263 6469 (vdsk) and arcdi │ │ │ │ │ -0001ed00: 736b 2028 6172 6329 2075 7365 0a69 6e74 sk (arc) use.int │ │ │ │ │ -0001ed10: 7269 6e73 6963 206e 616d 6520 6f66 2064 rinsic name of d │ │ │ │ │ -0001ed20: 6973 6b20 7072 6566 6978 6564 2062 7920 isk prefixed by │ │ │ │ │ -0001ed30: 6472 6976 6572 206e 616d 652e 2020 4164 driver name. Ad │ │ │ │ │ -0001ed40: 6469 7469 6f6e 616c 6c79 206a 7573 740a ditionally just. │ │ │ │ │ -0001ed50: 226e 616e 6422 2072 6566 6572 7320 746f "nand" refers to │ │ │ │ │ -0001ed60: 2074 6865 2064 6973 6b20 616c 6961 7365 the disk aliase │ │ │ │ │ -0001ed70: 6420 6173 2022 6e61 6e64 222e 2020 436f d as "nand". Co │ │ │ │ │ -0001ed80: 6e66 6c69 6374 7320 6172 6520 736f 6c76 nflicts are solv │ │ │ │ │ -0001ed90: 6564 2062 790a 7375 6666 6978 696e 6720 ed by.suffixing │ │ │ │ │ -0001eda0: 6120 6e75 6d62 6572 2069 6620 6e65 6365 a number if nece │ │ │ │ │ -0001edb0: 7373 6172 7279 2e20 2043 6f6d 6d61 7320 ssarry. Commas │ │ │ │ │ -0001edc0: 6e65 6564 2074 6f20 6265 2065 7363 6170 need to be escap │ │ │ │ │ -0001edd0: 6564 2e20 204c 6f6f 7062 6163 6b0a 7573 ed. Loopback.us │ │ │ │ │ -0001ede0: 6573 2077 6861 7465 7665 7220 6e61 6d65 es whatever name │ │ │ │ │ -0001edf0: 2073 7065 6369 6669 6564 2074 6f20 276c specified to 'l │ │ │ │ │ -0001ee00: 6f6f 7062 6163 6b27 2063 6f6d 6d61 6e64 oopback' command │ │ │ │ │ -0001ee10: 2e20 2048 6f73 7464 6973 6b20 7573 6573 . Hostdisk uses │ │ │ │ │ -0001ee20: 206e 616d 6573 0a73 7065 6369 6669 6564 names.specified │ │ │ │ │ -0001ee30: 2069 6e20 6465 7669 6365 2e6d 6170 2061 in device.map a │ │ │ │ │ -0001ee40: 7320 6c6f 6e67 2061 7320 6974 2773 206f s long as it's o │ │ │ │ │ -0001ee50: 6620 7468 6520 666f 726d 205b 6668 635d f the form [fhc] │ │ │ │ │ -0001ee60: 645b 302d 395d 2a20 6f72 0a68 6f73 7464 d[0-9]* or.hostd │ │ │ │ │ -0001ee70: 6973 6b2f 3c4f 5320 4445 5649 4345 3e2e isk/. │ │ │ │ │ -0001ee80: 2020 466f 7220 6372 7970 746f 2061 6e64 For crypto and │ │ │ │ │ -0001ee90: 2052 4149 4420 286d 6429 2061 6464 6974 RAID (md) addit │ │ │ │ │ -0001eea0: 696f 6e61 6c6c 7920 796f 7520 6361 6e20 ionally you can │ │ │ │ │ -0001eeb0: 7573 650a 7468 6520 7379 6e74 6178 203c use.the syntax < │ │ │ │ │ -0001eec0: 6472 6976 6572 206e 616d 653e 7575 6964 driver name>uuid │ │ │ │ │ -0001eed0: 2f3c 7575 6964 3e2e 2020 466f 7220 4c56 /. For LV │ │ │ │ │ -0001eee0: 4d20 6164 6469 7469 6f6e 616c 6c79 2079 M additionally y │ │ │ │ │ -0001eef0: 6f75 2063 616e 2075 7365 0a74 6865 2073 ou can use.the s │ │ │ │ │ -0001ef00: 796e 7461 7820 6c76 6d69 642f 3c76 6f6c yntax lvmid// │ │ │ │ │ -0001ef20: 3c76 6f6c 756d 652d 7575 6964 3e2e 0a0a ... │ │ │ │ │ -0001ef30: 2020 2020 2028 6664 3029 0a20 2020 2020 (fd0). │ │ │ │ │ -0001ef40: 2868 6430 290a 2020 2020 2028 6364 290a (hd0). (cd). │ │ │ │ │ -0001ef50: 2020 2020 2028 6168 6369 3029 0a20 2020 (ahci0). │ │ │ │ │ -0001ef60: 2020 2861 7461 3029 0a20 2020 2020 2863 (ata0). (c │ │ │ │ │ -0001ef70: 7279 7074 6f30 290a 2020 2020 2028 7573 rypto0). (us │ │ │ │ │ -0001ef80: 6230 290a 2020 2020 2028 6372 7970 746f b0). (crypto │ │ │ │ │ -0001ef90: 7575 6964 2f31 3233 3435 3637 3839 6162 uuid/123456789ab │ │ │ │ │ -0001efa0: 6364 6566 3031 3233 3435 3637 3839 6162 cdef0123456789ab │ │ │ │ │ -0001efb0: 6364 6566 3029 0a20 2020 2020 286d 6475 cdef0). (mdu │ │ │ │ │ -0001efc0: 7569 642f 3132 3334 3536 3738 3961 6263 uid/123456789abc │ │ │ │ │ -0001efd0: 6465 6630 3132 3334 3536 3738 3961 6263 def0123456789abc │ │ │ │ │ -0001efe0: 6465 6630 290a 2020 2020 2028 6c76 6d2f def0). (lvm/ │ │ │ │ │ -0001eff0: 7379 7374 656d 2d72 6f6f 7429 0a20 2020 system-root). │ │ │ │ │ -0001f000: 2020 286c 766d 6964 2f46 3169 6b67 442d (lvmid/F1ikgD- │ │ │ │ │ -0001f010: 3252 4553 2d33 3036 472d 696c 394d 2d37 2RES-306G-il9M-7 │ │ │ │ │ -0001f020: 6977 612d 344e 4b57 2d45 6256 314e 562f iwa-4NKW-EbV1NV/ │ │ │ │ │ -0001f030: 654c 4775 4351 2d4c 344b 612d 5855 6752 eLGuCQ-L4Ka-XUgR │ │ │ │ │ -0001f040: 2d73 6a74 4a2d 6666 6368 2d62 616a 722d -sjtJ-ffch-bajr- │ │ │ │ │ -0001f050: 6643 4e66 7a35 290a 2020 2020 2028 6d64 fCNfz5). (md │ │ │ │ │ -0001f060: 2f6d 7972 6169 6429 0a20 2020 2020 286d /myraid). (m │ │ │ │ │ -0001f070: 642f 3029 0a20 2020 2020 2869 6565 6531 d/0). (ieee1 │ │ │ │ │ -0001f080: 3237 352f 6469 736b 3229 0a20 2020 2020 275/disk2). │ │ │ │ │ -0001f090: 2869 6565 6531 3237 352f 2f70 6369 4031 (ieee1275//pci@1 │ │ │ │ │ -0001f0a0: 665c 2c30 2f69 6465 4064 2f64 6973 6b40 f\,0/ide@d/disk@ │ │ │ │ │ -0001f0b0: 3229 0a20 2020 2020 286e 616e 6429 0a20 2). (nand). │ │ │ │ │ -0001f0c0: 2020 2020 286d 656d 6469 736b 290a 2020 (memdisk). │ │ │ │ │ -0001f0d0: 2020 2028 686f 7374 290a 2020 2020 2028 (host). ( │ │ │ │ │ -0001f0e0: 6d79 6c6f 6f70 290a 2020 2020 2028 686f myloop). (ho │ │ │ │ │ -0001f0f0: 7374 6469 736b 2f2f 6465 762f 7364 6129 stdisk//dev/sda) │ │ │ │ │ -0001f100: 0a0a 2020 2050 4152 542d 4e55 4d20 7265 .. PART-NUM re │ │ │ │ │ -0001f110: 7072 6573 656e 7473 2074 6865 2070 6172 presents the par │ │ │ │ │ -0001f120: 7469 7469 6f6e 206e 756d 6265 7220 6f66 tition number of │ │ │ │ │ -0001f130: 2044 4556 4943 452c 2073 7461 7274 696e DEVICE, startin │ │ │ │ │ -0001f140: 6720 6672 6f6d 0a6f 6e65 2e20 2050 4152 g from.one. PAR │ │ │ │ │ -0001f150: 544e 414d 4520 6973 206f 7074 696f 6e61 TNAME is optiona │ │ │ │ │ -0001f160: 6c20 6275 7420 6973 2072 6563 6f6d 6d65 l but is recomme │ │ │ │ │ -0001f170: 6e64 6564 2073 696e 6365 2064 6973 6b20 nded since disk │ │ │ │ │ -0001f180: 6d61 7920 6861 7665 0a73 6576 6572 616c may have.several │ │ │ │ │ -0001f190: 2074 6f70 2d6c 6576 656c 2070 6172 746d top-level partm │ │ │ │ │ -0001f1a0: 6170 732e 2020 5370 6563 6966 7969 6e67 aps. Specifying │ │ │ │ │ -0001f1b0: 2074 6869 7264 2061 6e64 206c 6174 6572 third and later │ │ │ │ │ -0001f1c0: 2063 6f6d 706f 6e65 6e74 2079 6f75 0a63 component you.c │ │ │ │ │ -0001f1d0: 616e 2061 6363 6573 7320 746f 2073 7562 an access to sub │ │ │ │ │ -0001f1e0: 7061 7274 6974 696f 6e73 2e0a 0a20 2020 partitions... │ │ │ │ │ -0001f1f0: 5468 6520 7379 6e74 6178 2027 2868 6430 The syntax '(hd0 │ │ │ │ │ -0001f200: 2927 2072 6570 7265 7365 6e74 7320 7573 )' represents us │ │ │ │ │ -0001f210: 696e 6720 7468 6520 656e 7469 7265 2064 ing the entire d │ │ │ │ │ -0001f220: 6973 6b20 286f 7220 7468 6520 4d42 5220 isk (or the MBR │ │ │ │ │ -0001f230: 7768 656e 0a69 6e73 7461 6c6c 696e 6720 when.installing │ │ │ │ │ -0001f240: 4752 5542 292c 2077 6869 6c65 2074 6865 GRUB), while the │ │ │ │ │ -0001f250: 2073 796e 7461 7820 2728 6864 302c 3129 syntax '(hd0,1) │ │ │ │ │ -0001f260: 2720 7265 7072 6573 656e 7473 2075 7369 ' represents usi │ │ │ │ │ -0001f270: 6e67 2074 6865 2066 6972 7374 0a70 6172 ng the first.par │ │ │ │ │ -0001f280: 7469 7469 6f6e 206f 6620 7468 6520 6469 tition of the di │ │ │ │ │ -0001f290: 736b 2028 6f72 2074 6865 2062 6f6f 7420 sk (or the boot │ │ │ │ │ -0001f2a0: 7365 6374 6f72 206f 6620 7468 6520 7061 sector of the pa │ │ │ │ │ -0001f2b0: 7274 6974 696f 6e20 7768 656e 0a69 6e73 rtition when.ins │ │ │ │ │ -0001f2c0: 7461 6c6c 696e 6720 4752 5542 292e 0a0a talling GRUB)... │ │ │ │ │ -0001f2d0: 2020 2020 2028 6864 302c 6d73 646f 7331 (hd0,msdos1 │ │ │ │ │ -0001f2e0: 290a 2020 2020 2028 6864 302c 6d73 646f ). (hd0,msdo │ │ │ │ │ -0001f2f0: 7331 2c6d 7364 6f73 3529 0a20 2020 2020 s1,msdos5). │ │ │ │ │ -0001f300: 2868 6430 2c6d 7364 6f73 312c 6273 6433 (hd0,msdos1,bsd3 │ │ │ │ │ -0001f310: 290a 2020 2020 2028 6864 302c 6e65 7462 ). (hd0,netb │ │ │ │ │ -0001f320: 7364 3129 0a20 2020 2020 2868 6430 2c67 sd1). (hd0,g │ │ │ │ │ -0001f330: 7074 3129 0a20 2020 2020 2868 6430 2c31 pt1). (hd0,1 │ │ │ │ │ -0001f340: 2c33 290a 0a20 2020 4966 2079 6f75 2065 ,3).. If you e │ │ │ │ │ -0001f350: 6e61 626c 6564 2074 6865 206e 6574 776f nabled the netwo │ │ │ │ │ -0001f360: 726b 2073 7570 706f 7274 2c20 7468 6520 rk support, the │ │ │ │ │ -0001f370: 7370 6563 6961 6c20 6472 6976 6573 0a27 special drives.' │ │ │ │ │ -0001f380: 2850 524f 544f 434f 4c5b 2c53 4552 5645 (PROTOCOL[,SERVE │ │ │ │ │ -0001f390: 525d 2927 2061 7265 2061 6c73 6f20 6176 R])' are also av │ │ │ │ │ -0001f3a0: 6169 6c61 626c 652e 2020 5375 7070 6f72 ailable. Suppor │ │ │ │ │ -0001f3b0: 7465 6420 7072 6f74 6f63 6f6c 7320 6172 ted protocols ar │ │ │ │ │ -0001f3c0: 650a 2768 7474 7027 2061 6e64 2027 7466 e.'http' and 'tf │ │ │ │ │ -0001f3d0: 7470 272e 2020 4966 2053 4552 5645 5220 tp'. If SERVER │ │ │ │ │ -0001f3e0: 6973 206f 6d69 7474 6564 2c20 7661 6c75 is omitted, valu │ │ │ │ │ -0001f3f0: 6520 6f66 2065 6e76 6972 6f6e 6d65 6e74 e of environment │ │ │ │ │ -0001f400: 2076 6172 6961 626c 650a 276e 6574 5f64 variable.'net_d │ │ │ │ │ -0001f410: 6566 6175 6c74 5f73 6572 7665 7227 2069 efault_server' i │ │ │ │ │ -0001f420: 7320 7573 6564 2e20 2042 6566 6f72 6520 s used. Before │ │ │ │ │ -0001f430: 7573 696e 6720 7468 6520 6e65 7477 6f72 using the networ │ │ │ │ │ -0001f440: 6b20 6472 6976 652c 2079 6f75 206d 7573 k drive, you mus │ │ │ │ │ -0001f450: 740a 696e 6974 6961 6c69 7a65 2074 6865 t.initialize the │ │ │ │ │ -0001f460: 206e 6574 776f 726b 2e20 202a 4e6f 7465 network. *Note │ │ │ │ │ -0001f470: 204e 6574 776f 726b 3a3a 2c20 666f 7220 Network::, for │ │ │ │ │ -0001f480: 6d6f 7265 2069 6e66 6f72 6d61 7469 6f6e more information │ │ │ │ │ -0001f490: 2e0a 0a20 2020 4966 2079 6f75 2062 6f6f ... If you boo │ │ │ │ │ -0001f4a0: 7420 4752 5542 2066 726f 6d20 6120 4344 t GRUB from a CD │ │ │ │ │ -0001f4b0: 2d52 4f4d 2c20 2728 6364 2927 2069 7320 -ROM, '(cd)' is │ │ │ │ │ -0001f4c0: 6176 6169 6c61 626c 652e 2020 2a4e 6f74 available. *Not │ │ │ │ │ -0001f4d0: 6520 4d61 6b69 6e67 2061 0a47 5255 4220 e Making a.GRUB │ │ │ │ │ -0001f4e0: 626f 6f74 6162 6c65 2043 442d 524f 4d3a bootable CD-ROM: │ │ │ │ │ -0001f4f0: 3a2c 2066 6f72 2064 6574 6169 6c73 2e0a :, for details.. │ │ │ │ │ -0001f500: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -0001f510: 666f 2c20 204e 6f64 653a 2046 696c 6520 fo, Node: File │ │ │ │ │ -0001f520: 6e61 6d65 2073 796e 7461 782c 2020 4e65 name syntax, Ne │ │ │ │ │ -0001f530: 7874 3a20 426c 6f63 6b20 6c69 7374 2073 xt: Block list s │ │ │ │ │ -0001f540: 796e 7461 782c 2020 5072 6576 3a20 4465 yntax, Prev: De │ │ │ │ │ -0001f550: 7669 6365 2073 796e 7461 782c 2020 5570 vice syntax, Up │ │ │ │ │ -0001f560: 3a20 4669 6c65 7379 7374 656d 0a0a 3133 : Filesystem..13 │ │ │ │ │ -0001f570: 2e32 2048 6f77 2074 6f20 7370 6563 6966 .2 How to specif │ │ │ │ │ -0001f580: 7920 6669 6c65 730a 3d3d 3d3d 3d3d 3d3d y files.======== │ │ │ │ │ +0001e850: 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a 0a47 5255 ***********..GRU │ │ │ │ │ +0001e860: 4220 7573 6573 2061 2073 7065 6369 616c B uses a special │ │ │ │ │ +0001e870: 2073 796e 7461 7820 666f 7220 7370 6563 syntax for spec │ │ │ │ │ +0001e880: 6966 7969 6e67 2064 6973 6b20 6472 6976 ifying disk driv │ │ │ │ │ +0001e890: 6573 2077 6869 6368 2063 616e 2062 650a es which can be. │ │ │ │ │ +0001e8a0: 6163 6365 7373 6564 2062 7920 4249 4f53 accessed by BIOS │ │ │ │ │ +0001e8b0: 2e20 4265 6361 7573 6520 6f66 2042 494f . Because of BIO │ │ │ │ │ +0001e8c0: 5320 6c69 6d69 7461 7469 6f6e 732c 2047 S limitations, G │ │ │ │ │ +0001e8d0: 5255 4220 6361 6e6e 6f74 2064 6973 7469 RUB cannot disti │ │ │ │ │ +0001e8e0: 6e67 7569 7368 0a62 6574 7765 656e 2049 nguish.between I │ │ │ │ │ +0001e8f0: 4445 2c20 4553 4449 2c20 5343 5349 2c20 DE, ESDI, SCSI, │ │ │ │ │ +0001e900: 6f72 206f 7468 6572 732e 2020 596f 7520 or others. You │ │ │ │ │ +0001e910: 6d75 7374 206b 6e6f 7720 796f 7572 7365 must know yourse │ │ │ │ │ +0001e920: 6c66 2077 6869 6368 2042 494f 530a 6465 lf which BIOS.de │ │ │ │ │ +0001e930: 7669 6365 2069 7320 6571 7569 7661 6c65 vice is equivale │ │ │ │ │ +0001e940: 6e74 2074 6f20 7768 6963 6820 4f53 2064 nt to which OS d │ │ │ │ │ +0001e950: 6576 6963 652e 2020 4e6f 726d 616c 6c79 evice. Normally │ │ │ │ │ +0001e960: 2c20 7468 6174 2077 696c 6c20 6265 2063 , that will be c │ │ │ │ │ +0001e970: 6c65 6172 0a69 6620 796f 7520 7365 6520 lear.if you see │ │ │ │ │ +0001e980: 7468 6520 6669 6c65 7320 696e 2061 2064 the files in a d │ │ │ │ │ +0001e990: 6576 6963 6520 6f72 2075 7365 2074 6865 evice or use the │ │ │ │ │ +0001e9a0: 2063 6f6d 6d61 6e64 2027 7365 6172 6368 command 'search │ │ │ │ │ +0001e9b0: 2720 282a 6e6f 7465 0a73 6561 7263 683a ' (*note.search: │ │ │ │ │ +0001e9c0: 3a29 2e0a 0a2a 204d 656e 753a 0a0a 2a20 :)...* Menu:..* │ │ │ │ │ +0001e9d0: 4465 7669 6365 2073 796e 7461 783a 3a20 Device syntax:: │ │ │ │ │ +0001e9e0: 2020 2020 2020 2020 2020 2020 2020 486f Ho │ │ │ │ │ +0001e9f0: 7720 746f 2073 7065 6369 6679 2064 6576 w to specify dev │ │ │ │ │ +0001ea00: 6963 6573 0a2a 2046 696c 6520 6e61 6d65 ices.* File name │ │ │ │ │ +0001ea10: 2073 796e 7461 783a 3a20 2020 2020 2020 syntax:: │ │ │ │ │ +0001ea20: 2020 2020 2048 6f77 2074 6f20 7370 6563 How to spec │ │ │ │ │ +0001ea30: 6966 7920 6669 6c65 730a 2a20 426c 6f63 ify files.* Bloc │ │ │ │ │ +0001ea40: 6b20 6c69 7374 2073 796e 7461 783a 3a20 k list syntax:: │ │ │ │ │ +0001ea50: 2020 2020 2020 2020 2020 486f 7720 746f How to │ │ │ │ │ +0001ea60: 2073 7065 6369 6679 2062 6c6f 636b 206c specify block l │ │ │ │ │ +0001ea70: 6973 7473 0a0a 1f0a 4669 6c65 3a20 6772 ists....File: gr │ │ │ │ │ +0001ea80: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +0001ea90: 4465 7669 6365 2073 796e 7461 782c 2020 Device syntax, │ │ │ │ │ +0001eaa0: 4e65 7874 3a20 4669 6c65 206e 616d 6520 Next: File name │ │ │ │ │ +0001eab0: 7379 6e74 6178 2c20 2055 703a 2046 696c syntax, Up: Fil │ │ │ │ │ +0001eac0: 6573 7973 7465 6d0a 0a31 332e 3120 486f esystem..13.1 Ho │ │ │ │ │ +0001ead0: 7720 746f 2073 7065 6369 6679 2064 6576 w to specify dev │ │ │ │ │ +0001eae0: 6963 6573 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d ices.=========== │ │ │ │ │ +0001eaf0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +0001eb00: 0a0a 5468 6520 6465 7669 6365 2073 796e ..The device syn │ │ │ │ │ +0001eb10: 7461 7820 6973 206c 696b 6520 7468 6973 tax is like this │ │ │ │ │ +0001eb20: 3a0a 0a20 2020 2020 2844 4556 4943 455b :.. (DEVICE[ │ │ │ │ │ +0001eb30: 2c50 4152 544d 4150 2d4e 414d 4531 5041 ,PARTMAP-NAME1PA │ │ │ │ │ +0001eb40: 5254 2d4e 554d 315b 2c50 4152 544d 4150 RT-NUM1[,PARTMAP │ │ │ │ │ +0001eb50: 2d4e 414d 4532 5041 5254 2d4e 554d 325b -NAME2PART-NUM2[ │ │ │ │ │ +0001eb60: 2c2e 2e2e 5d5d 5d29 0a0a 2020 2027 5b5d ,...]]]).. '[] │ │ │ │ │ +0001eb70: 2720 6d65 616e 7320 7468 6520 7061 7261 ' means the para │ │ │ │ │ +0001eb80: 6d65 7465 7220 6973 206f 7074 696f 6e61 meter is optiona │ │ │ │ │ +0001eb90: 6c2e 2020 4445 5649 4345 2064 6570 656e l. DEVICE depen │ │ │ │ │ +0001eba0: 6473 206f 6e20 7468 6520 6469 736b 0a64 ds on the disk.d │ │ │ │ │ +0001ebb0: 7269 7665 7220 696e 2075 7365 2e20 2042 river in use. B │ │ │ │ │ +0001ebc0: 494f 5320 616e 6420 4546 4920 6469 736b IOS and EFI disk │ │ │ │ │ +0001ebd0: 7320 7573 6520 6569 7468 6572 2027 6664 s use either 'fd │ │ │ │ │ +0001ebe0: 2720 6f72 2027 6864 2720 666f 6c6c 6f77 ' or 'hd' follow │ │ │ │ │ +0001ebf0: 6564 2062 7920 610a 6469 6769 742c 206c ed by a.digit, l │ │ │ │ │ +0001ec00: 696b 6520 2766 6430 272c 206f 7220 2763 ike 'fd0', or 'c │ │ │ │ │ +0001ec10: 6427 2e20 2041 4843 492c 2050 4154 4120 d'. AHCI, PATA │ │ │ │ │ +0001ec20: 2861 7461 292c 2063 7279 7074 6f2c 2055 (ata), crypto, U │ │ │ │ │ +0001ec30: 5342 2075 7365 2074 6865 206e 616d 650a SB use the name. │ │ │ │ │ +0001ec40: 6f66 2064 7269 7665 7220 666f 6c6c 6f77 of driver follow │ │ │ │ │ +0001ec50: 6564 2062 7920 6120 6e75 6d62 6572 2e20 ed by a number. │ │ │ │ │ +0001ec60: 204d 656d 6469 736b 2061 6e64 2068 6f73 Memdisk and hos │ │ │ │ │ +0001ec70: 7420 6172 6520 6c69 6d69 7465 6420 746f t are limited to │ │ │ │ │ +0001ec80: 206f 6e65 0a64 6973 6b20 616e 6420 736f one.disk and so │ │ │ │ │ +0001ec90: 2069 7427 7320 7265 6665 7265 6420 6a75 it's refered ju │ │ │ │ │ +0001eca0: 7374 2062 7920 6472 6976 6572 206e 616d st by driver nam │ │ │ │ │ +0001ecb0: 652e 2020 5241 4944 2028 6d64 292c 206f e. RAID (md), o │ │ │ │ │ +0001ecc0: 6664 6973 6b0a 2869 6565 6531 3237 3520 fdisk.(ieee1275 │ │ │ │ │ +0001ecd0: 616e 6420 6e61 6e64 292c 204c 564d 2028 and nand), LVM ( │ │ │ │ │ +0001ece0: 6c76 6d29 2c20 4c44 4d2c 2076 6972 7469 lvm), LDM, virti │ │ │ │ │ +0001ecf0: 6f20 2876 6473 6b29 2061 6e64 2061 7263 o (vdsk) and arc │ │ │ │ │ +0001ed00: 6469 736b 2028 6172 6329 2075 7365 0a69 disk (arc) use.i │ │ │ │ │ +0001ed10: 6e74 7269 6e73 6963 206e 616d 6520 6f66 ntrinsic name of │ │ │ │ │ +0001ed20: 2064 6973 6b20 7072 6566 6978 6564 2062 disk prefixed b │ │ │ │ │ +0001ed30: 7920 6472 6976 6572 206e 616d 652e 2020 y driver name. │ │ │ │ │ +0001ed40: 4164 6469 7469 6f6e 616c 6c79 206a 7573 Additionally jus │ │ │ │ │ +0001ed50: 740a 226e 616e 6422 2072 6566 6572 7320 t."nand" refers │ │ │ │ │ +0001ed60: 746f 2074 6865 2064 6973 6b20 616c 6961 to the disk alia │ │ │ │ │ +0001ed70: 7365 6420 6173 2022 6e61 6e64 222e 2020 sed as "nand". │ │ │ │ │ +0001ed80: 436f 6e66 6c69 6374 7320 6172 6520 736f Conflicts are so │ │ │ │ │ +0001ed90: 6c76 6564 2062 790a 7375 6666 6978 696e lved by.suffixin │ │ │ │ │ +0001eda0: 6720 6120 6e75 6d62 6572 2069 6620 6e65 g a number if ne │ │ │ │ │ +0001edb0: 6365 7373 6172 7279 2e20 2043 6f6d 6d61 cessarry. Comma │ │ │ │ │ +0001edc0: 7320 6e65 6564 2074 6f20 6265 2065 7363 s need to be esc │ │ │ │ │ +0001edd0: 6170 6564 2e20 204c 6f6f 7062 6163 6b0a aped. Loopback. │ │ │ │ │ +0001ede0: 7573 6573 2077 6861 7465 7665 7220 6e61 uses whatever na │ │ │ │ │ +0001edf0: 6d65 2073 7065 6369 6669 6564 2074 6f20 me specified to │ │ │ │ │ +0001ee00: 276c 6f6f 7062 6163 6b27 2063 6f6d 6d61 'loopback' comma │ │ │ │ │ +0001ee10: 6e64 2e20 2048 6f73 7464 6973 6b20 7573 nd. Hostdisk us │ │ │ │ │ +0001ee20: 6573 206e 616d 6573 0a73 7065 6369 6669 es names.specifi │ │ │ │ │ +0001ee30: 6564 2069 6e20 6465 7669 6365 2e6d 6170 ed in device.map │ │ │ │ │ +0001ee40: 2061 7320 6c6f 6e67 2061 7320 6974 2773 as long as it's │ │ │ │ │ +0001ee50: 206f 6620 7468 6520 666f 726d 205b 6668 of the form [fh │ │ │ │ │ +0001ee60: 635d 645b 302d 395d 2a20 6f72 0a68 6f73 c]d[0-9]* or.hos │ │ │ │ │ +0001ee70: 7464 6973 6b2f 3c4f 5320 4445 5649 4345 tdisk/. For crypto a │ │ │ │ │ +0001ee90: 6e64 2052 4149 4420 286d 6429 2061 6464 nd RAID (md) add │ │ │ │ │ +0001eea0: 6974 696f 6e61 6c6c 7920 796f 7520 6361 itionally you ca │ │ │ │ │ +0001eeb0: 6e20 7573 650a 7468 6520 7379 6e74 6178 n use.the syntax │ │ │ │ │ +0001eec0: 203c 6472 6976 6572 206e 616d 653e 7575 uu │ │ │ │ │ +0001eed0: 6964 2f3c 7575 6964 3e2e 2020 466f 7220 id/. For │ │ │ │ │ +0001eee0: 4c56 4d20 6164 6469 7469 6f6e 616c 6c79 LVM additionally │ │ │ │ │ +0001eef0: 2079 6f75 2063 616e 2075 7365 0a74 6865 you can use.the │ │ │ │ │ +0001ef00: 2073 796e 7461 7820 6c76 6d69 642f 3c76 syntax lvmid//. │ │ │ │ │ +0001ef30: 0a0a 2020 2020 2028 6664 3029 0a20 2020 .. (fd0). │ │ │ │ │ +0001ef40: 2020 2868 6430 290a 2020 2020 2028 6364 (hd0). (cd │ │ │ │ │ +0001ef50: 290a 2020 2020 2028 6168 6369 3029 0a20 ). (ahci0). │ │ │ │ │ +0001ef60: 2020 2020 2861 7461 3029 0a20 2020 2020 (ata0). │ │ │ │ │ +0001ef70: 2863 7279 7074 6f30 290a 2020 2020 2028 (crypto0). ( │ │ │ │ │ +0001ef80: 7573 6230 290a 2020 2020 2028 6372 7970 usb0). (cryp │ │ │ │ │ +0001ef90: 746f 7575 6964 2f31 3233 3435 3637 3839 touuid/123456789 │ │ │ │ │ +0001efa0: 6162 6364 6566 3031 3233 3435 3637 3839 abcdef0123456789 │ │ │ │ │ +0001efb0: 6162 6364 6566 3029 0a20 2020 2020 286d abcdef0). (m │ │ │ │ │ +0001efc0: 6475 7569 642f 3132 3334 3536 3738 3961 duuid/123456789a │ │ │ │ │ +0001efd0: 6263 6465 6630 3132 3334 3536 3738 3961 bcdef0123456789a │ │ │ │ │ +0001efe0: 6263 6465 6630 290a 2020 2020 2028 6c76 bcdef0). (lv │ │ │ │ │ +0001eff0: 6d2f 7379 7374 656d 2d72 6f6f 7429 0a20 m/system-root). │ │ │ │ │ +0001f000: 2020 2020 286c 766d 6964 2f46 3169 6b67 (lvmid/F1ikg │ │ │ │ │ +0001f010: 442d 3252 4553 2d33 3036 472d 696c 394d D-2RES-306G-il9M │ │ │ │ │ +0001f020: 2d37 6977 612d 344e 4b57 2d45 6256 314e -7iwa-4NKW-EbV1N │ │ │ │ │ +0001f030: 562f 654c 4775 4351 2d4c 344b 612d 5855 V/eLGuCQ-L4Ka-XU │ │ │ │ │ +0001f040: 6752 2d73 6a74 4a2d 6666 6368 2d62 616a gR-sjtJ-ffch-baj │ │ │ │ │ +0001f050: 722d 6643 4e66 7a35 290a 2020 2020 2028 r-fCNfz5). ( │ │ │ │ │ +0001f060: 6d64 2f6d 7972 6169 6429 0a20 2020 2020 md/myraid). │ │ │ │ │ +0001f070: 286d 642f 3029 0a20 2020 2020 2869 6565 (md/0). (iee │ │ │ │ │ +0001f080: 6531 3237 352f 6469 736b 3229 0a20 2020 e1275/disk2). │ │ │ │ │ +0001f090: 2020 2869 6565 6531 3237 352f 2f70 6369 (ieee1275//pci │ │ │ │ │ +0001f0a0: 4031 665c 2c30 2f69 6465 4064 2f64 6973 @1f\,0/ide@d/dis │ │ │ │ │ +0001f0b0: 6b40 3229 0a20 2020 2020 286e 616e 6429 k@2). (nand) │ │ │ │ │ +0001f0c0: 0a20 2020 2020 286d 656d 6469 736b 290a . (memdisk). │ │ │ │ │ +0001f0d0: 2020 2020 2028 686f 7374 290a 2020 2020 (host). │ │ │ │ │ +0001f0e0: 2028 6d79 6c6f 6f70 290a 2020 2020 2028 (myloop). ( │ │ │ │ │ +0001f0f0: 686f 7374 6469 736b 2f2f 6465 762f 7364 hostdisk//dev/sd │ │ │ │ │ +0001f100: 6129 0a0a 2020 2050 4152 542d 4e55 4d20 a).. PART-NUM │ │ │ │ │ +0001f110: 7265 7072 6573 656e 7473 2074 6865 2070 represents the p │ │ │ │ │ +0001f120: 6172 7469 7469 6f6e 206e 756d 6265 7220 artition number │ │ │ │ │ +0001f130: 6f66 2044 4556 4943 452c 2073 7461 7274 of DEVICE, start │ │ │ │ │ +0001f140: 696e 6720 6672 6f6d 0a6f 6e65 2e20 2050 ing from.one. P │ │ │ │ │ +0001f150: 4152 544e 414d 4520 6973 206f 7074 696f ARTNAME is optio │ │ │ │ │ +0001f160: 6e61 6c20 6275 7420 6973 2072 6563 6f6d nal but is recom │ │ │ │ │ +0001f170: 6d65 6e64 6564 2073 696e 6365 2064 6973 mended since dis │ │ │ │ │ +0001f180: 6b20 6d61 7920 6861 7665 0a73 6576 6572 k may have.sever │ │ │ │ │ +0001f190: 616c 2074 6f70 2d6c 6576 656c 2070 6172 al top-level par │ │ │ │ │ +0001f1a0: 746d 6170 732e 2020 5370 6563 6966 7969 tmaps. Specifyi │ │ │ │ │ +0001f1b0: 6e67 2074 6869 7264 2061 6e64 206c 6174 ng third and lat │ │ │ │ │ +0001f1c0: 6572 2063 6f6d 706f 6e65 6e74 2079 6f75 er component you │ │ │ │ │ +0001f1d0: 0a63 616e 2061 6363 6573 7320 746f 2073 .can access to s │ │ │ │ │ +0001f1e0: 7562 7061 7274 6974 696f 6e73 2e0a 0a20 ubpartitions... │ │ │ │ │ +0001f1f0: 2020 5468 6520 7379 6e74 6178 2027 2868 The syntax '(h │ │ │ │ │ +0001f200: 6430 2927 2072 6570 7265 7365 6e74 7320 d0)' represents │ │ │ │ │ +0001f210: 7573 696e 6720 7468 6520 656e 7469 7265 using the entire │ │ │ │ │ +0001f220: 2064 6973 6b20 286f 7220 7468 6520 4d42 disk (or the MB │ │ │ │ │ +0001f230: 5220 7768 656e 0a69 6e73 7461 6c6c 696e R when.installin │ │ │ │ │ +0001f240: 6720 4752 5542 292c 2077 6869 6c65 2074 g GRUB), while t │ │ │ │ │ +0001f250: 6865 2073 796e 7461 7820 2728 6864 302c he syntax '(hd0, │ │ │ │ │ +0001f260: 3129 2720 7265 7072 6573 656e 7473 2075 1)' represents u │ │ │ │ │ +0001f270: 7369 6e67 2074 6865 2066 6972 7374 0a70 sing the first.p │ │ │ │ │ +0001f280: 6172 7469 7469 6f6e 206f 6620 7468 6520 artition of the │ │ │ │ │ +0001f290: 6469 736b 2028 6f72 2074 6865 2062 6f6f disk (or the boo │ │ │ │ │ +0001f2a0: 7420 7365 6374 6f72 206f 6620 7468 6520 t sector of the │ │ │ │ │ +0001f2b0: 7061 7274 6974 696f 6e20 7768 656e 0a69 partition when.i │ │ │ │ │ +0001f2c0: 6e73 7461 6c6c 696e 6720 4752 5542 292e nstalling GRUB). │ │ │ │ │ +0001f2d0: 0a0a 2020 2020 2028 6864 302c 6d73 646f .. (hd0,msdo │ │ │ │ │ +0001f2e0: 7331 290a 2020 2020 2028 6864 302c 6d73 s1). (hd0,ms │ │ │ │ │ +0001f2f0: 646f 7331 2c6d 7364 6f73 3529 0a20 2020 dos1,msdos5). │ │ │ │ │ +0001f300: 2020 2868 6430 2c6d 7364 6f73 312c 6273 (hd0,msdos1,bs │ │ │ │ │ +0001f310: 6433 290a 2020 2020 2028 6864 302c 6e65 d3). (hd0,ne │ │ │ │ │ +0001f320: 7462 7364 3129 0a20 2020 2020 2868 6430 tbsd1). (hd0 │ │ │ │ │ +0001f330: 2c67 7074 3129 0a20 2020 2020 2868 6430 ,gpt1). (hd0 │ │ │ │ │ +0001f340: 2c31 2c33 290a 0a20 2020 4966 2079 6f75 ,1,3).. If you │ │ │ │ │ +0001f350: 2065 6e61 626c 6564 2074 6865 206e 6574 enabled the net │ │ │ │ │ +0001f360: 776f 726b 2073 7570 706f 7274 2c20 7468 work support, th │ │ │ │ │ +0001f370: 6520 7370 6563 6961 6c20 6472 6976 6573 e special drives │ │ │ │ │ +0001f380: 0a27 2850 524f 544f 434f 4c5b 2c53 4552 .'(PROTOCOL[,SER │ │ │ │ │ +0001f390: 5645 525d 2927 2061 7265 2061 6c73 6f20 VER])' are also │ │ │ │ │ +0001f3a0: 6176 6169 6c61 626c 652e 2020 5375 7070 available. Supp │ │ │ │ │ +0001f3b0: 6f72 7465 6420 7072 6f74 6f63 6f6c 7320 orted protocols │ │ │ │ │ +0001f3c0: 6172 650a 2768 7474 7027 2061 6e64 2027 are.'http' and ' │ │ │ │ │ +0001f3d0: 7466 7470 272e 2020 4966 2053 4552 5645 tftp'. If SERVE │ │ │ │ │ +0001f3e0: 5220 6973 206f 6d69 7474 6564 2c20 7661 R is omitted, va │ │ │ │ │ +0001f3f0: 6c75 6520 6f66 2065 6e76 6972 6f6e 6d65 lue of environme │ │ │ │ │ +0001f400: 6e74 2076 6172 6961 626c 650a 276e 6574 nt variable.'net │ │ │ │ │ +0001f410: 5f64 6566 6175 6c74 5f73 6572 7665 7227 _default_server' │ │ │ │ │ +0001f420: 2069 7320 7573 6564 2e20 2042 6566 6f72 is used. Befor │ │ │ │ │ +0001f430: 6520 7573 696e 6720 7468 6520 6e65 7477 e using the netw │ │ │ │ │ +0001f440: 6f72 6b20 6472 6976 652c 2079 6f75 206d ork drive, you m │ │ │ │ │ +0001f450: 7573 740a 696e 6974 6961 6c69 7a65 2074 ust.initialize t │ │ │ │ │ +0001f460: 6865 206e 6574 776f 726b 2e20 202a 4e6f he network. *No │ │ │ │ │ +0001f470: 7465 204e 6574 776f 726b 3a3a 2c20 666f te Network::, fo │ │ │ │ │ +0001f480: 7220 6d6f 7265 2069 6e66 6f72 6d61 7469 r more informati │ │ │ │ │ +0001f490: 6f6e 2e0a 0a20 2020 4966 2079 6f75 2062 on... If you b │ │ │ │ │ +0001f4a0: 6f6f 7420 4752 5542 2066 726f 6d20 6120 oot GRUB from a │ │ │ │ │ +0001f4b0: 4344 2d52 4f4d 2c20 2728 6364 2927 2069 CD-ROM, '(cd)' i │ │ │ │ │ +0001f4c0: 7320 6176 6169 6c61 626c 652e 2020 2a4e s available. *N │ │ │ │ │ +0001f4d0: 6f74 6520 4d61 6b69 6e67 2061 0a47 5255 ote Making a.GRU │ │ │ │ │ +0001f4e0: 4220 626f 6f74 6162 6c65 2043 442d 524f B bootable CD-RO │ │ │ │ │ +0001f4f0: 4d3a 3a2c 2066 6f72 2064 6574 6169 6c73 M::, for details │ │ │ │ │ +0001f500: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +0001f510: 696e 666f 2c20 204e 6f64 653a 2046 696c info, Node: Fil │ │ │ │ │ +0001f520: 6520 6e61 6d65 2073 796e 7461 782c 2020 e name syntax, │ │ │ │ │ +0001f530: 4e65 7874 3a20 426c 6f63 6b20 6c69 7374 Next: Block list │ │ │ │ │ +0001f540: 2073 796e 7461 782c 2020 5072 6576 3a20 syntax, Prev: │ │ │ │ │ +0001f550: 4465 7669 6365 2073 796e 7461 782c 2020 Device syntax, │ │ │ │ │ +0001f560: 5570 3a20 4669 6c65 7379 7374 656d 0a0a Up: Filesystem.. │ │ │ │ │ +0001f570: 3133 2e32 2048 6f77 2074 6f20 7370 6563 13.2 How to spec │ │ │ │ │ +0001f580: 6966 7920 6669 6c65 730a 3d3d 3d3d 3d3d ify files.====== │ │ │ │ │ 0001f590: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001f5a0: 3d0a 0a54 6865 7265 2061 7265 2074 776f =..There are two │ │ │ │ │ -0001f5b0: 2077 6179 7320 746f 2073 7065 6369 6679 ways to specify │ │ │ │ │ -0001f5c0: 2066 696c 6573 2c20 6279 2022 6162 736f files, by "abso │ │ │ │ │ -0001f5d0: 6c75 7465 2066 696c 6520 6e61 6d65 2220 lute file name" │ │ │ │ │ -0001f5e0: 616e 6420 6279 0a22 626c 6f63 6b20 6c69 and by."block li │ │ │ │ │ -0001f5f0: 7374 222e 0a0a 2020 2041 6e20 6162 736f st"... An abso │ │ │ │ │ -0001f600: 6c75 7465 2066 696c 6520 6e61 6d65 2072 lute file name r │ │ │ │ │ -0001f610: 6573 656d 626c 6573 2061 2055 6e69 7820 esembles a Unix │ │ │ │ │ -0001f620: 6162 736f 6c75 7465 2066 696c 6520 6e61 absolute file na │ │ │ │ │ -0001f630: 6d65 2c20 7573 696e 6720 272f 270a 666f me, using '/'.fo │ │ │ │ │ -0001f640: 7220 7468 6520 6469 7265 6374 6f72 7920 r the directory │ │ │ │ │ -0001f650: 7365 7061 7261 746f 7220 286e 6f74 2027 separator (not ' │ │ │ │ │ -0001f660: 5c27 2061 7320 696e 2044 4f53 292e 204f \' as in DOS). O │ │ │ │ │ -0001f670: 6e65 2065 7861 6d70 6c65 2069 730a 2728 ne example is.'( │ │ │ │ │ -0001f680: 6864 302c 3129 2f62 6f6f 742f 6772 7562 hd0,1)/boot/grub │ │ │ │ │ -0001f690: 2f67 7275 622e 6366 6727 2e20 2054 6869 /grub.cfg'. Thi │ │ │ │ │ -0001f6a0: 7320 6d65 616e 7320 7468 6520 6669 6c65 s means the file │ │ │ │ │ -0001f6b0: 2027 2f62 6f6f 742f 6772 7562 2f67 7275 '/boot/grub/gru │ │ │ │ │ -0001f6c0: 622e 6366 6727 0a69 6e20 7468 6520 6669 b.cfg'.in the fi │ │ │ │ │ -0001f6d0: 7273 7420 7061 7274 6974 696f 6e20 6f66 rst partition of │ │ │ │ │ -0001f6e0: 2074 6865 2066 6972 7374 2068 6172 6420 the first hard │ │ │ │ │ -0001f6f0: 6469 736b 2e20 2049 6620 796f 7520 6f6d disk. If you om │ │ │ │ │ -0001f700: 6974 2074 6865 2064 6576 6963 650a 6e61 it the device.na │ │ │ │ │ -0001f710: 6d65 2069 6e20 616e 2061 6273 6f6c 7574 me in an absolut │ │ │ │ │ -0001f720: 6520 6669 6c65 206e 616d 652c 2047 5255 e file name, GRU │ │ │ │ │ -0001f730: 4220 7573 6573 2047 5255 4227 7320 2272 B uses GRUB's "r │ │ │ │ │ -0001f740: 6f6f 7420 6465 7669 6365 220a 696d 706c oot device".impl │ │ │ │ │ -0001f750: 6963 6974 6c79 2e20 2053 6f20 6966 2079 icitly. So if y │ │ │ │ │ -0001f760: 6f75 2073 6574 2074 6865 2072 6f6f 7420 ou set the root │ │ │ │ │ -0001f770: 6465 7669 6365 2074 6f2c 2073 6179 2c20 device to, say, │ │ │ │ │ -0001f780: 2728 6864 312c 3129 2720 6279 2074 6865 '(hd1,1)' by the │ │ │ │ │ -0001f790: 0a63 6f6d 6d61 6e64 2027 7365 7420 726f .command 'set ro │ │ │ │ │ -0001f7a0: 6f74 3d28 6864 312c 3129 2720 282a 6e6f ot=(hd1,1)' (*no │ │ │ │ │ -0001f7b0: 7465 2073 6574 3a3a 292c 2074 6865 6e20 te set::), then │ │ │ │ │ -0001f7c0: 272f 626f 6f74 2f6b 6572 6e65 6c27 2069 '/boot/kernel' i │ │ │ │ │ -0001f7d0: 7320 7468 650a 7361 6d65 2061 7320 2728 s the.same as '( │ │ │ │ │ -0001f7e0: 6864 312c 3129 2f62 6f6f 742f 6b65 726e hd1,1)/boot/kern │ │ │ │ │ -0001f7f0: 656c 272e 0a0a 2020 204f 6e20 5a46 5320 el'... On ZFS │ │ │ │ │ -0001f800: 6669 6c65 7379 7374 656d 2074 6865 2066 filesystem the f │ │ │ │ │ -0001f810: 6972 7374 2070 6174 6820 636f 6d70 6f6e irst path compon │ │ │ │ │ -0001f820: 656e 7420 6d75 7374 2062 650a 564f 4c55 ent must be.VOLU │ │ │ │ │ -0001f830: 4d45 2740 275b 534e 4150 5348 4f54 5d2e ME'@'[SNAPSHOT]. │ │ │ │ │ -0001f840: 2020 536f 2027 2f72 6f6f 7476 6f6c 4073 So '/rootvol@s │ │ │ │ │ -0001f850: 6e61 702d 3132 392f 626f 6f74 2f67 7275 nap-129/boot/gru │ │ │ │ │ -0001f860: 622f 6772 7562 2e63 6667 2720 7265 6665 b/grub.cfg' refe │ │ │ │ │ -0001f870: 7273 0a74 6f20 6669 6c65 2027 2f62 6f6f rs.to file '/boo │ │ │ │ │ -0001f880: 742f 6772 7562 2f67 7275 622e 6366 6727 t/grub/grub.cfg' │ │ │ │ │ -0001f890: 2069 6e20 736e 6170 7368 6f74 206f 6620 in snapshot of │ │ │ │ │ -0001f8a0: 766f 6c75 6d65 2027 726f 6f74 766f 6c27 volume 'rootvol' │ │ │ │ │ -0001f8b0: 2077 6974 6820 6e61 6d65 0a27 736e 6170 with name.'snap │ │ │ │ │ -0001f8c0: 2d31 3239 272e 2020 5472 6169 6c69 6e67 -129'. Trailing │ │ │ │ │ -0001f8d0: 2027 4027 2061 6674 6572 2076 6f6c 756d '@' after volum │ │ │ │ │ -0001f8e0: 6520 6e61 6d65 2069 7320 6d61 6e64 6174 e name is mandat │ │ │ │ │ -0001f8f0: 6f72 7920 6576 656e 2069 660a 736e 6170 ory even if.snap │ │ │ │ │ -0001f900: 7368 6f74 206e 616d 6520 6973 206f 6d69 shot name is omi │ │ │ │ │ -0001f910: 7474 6564 2e0a 0a1f 0a46 696c 653a 2067 tted.....File: g │ │ │ │ │ -0001f920: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0001f930: 2042 6c6f 636b 206c 6973 7420 7379 6e74 Block list synt │ │ │ │ │ -0001f940: 6178 2c20 2050 7265 763a 2046 696c 6520 ax, Prev: File │ │ │ │ │ -0001f950: 6e61 6d65 2073 796e 7461 782c 2020 5570 name syntax, Up │ │ │ │ │ -0001f960: 3a20 4669 6c65 7379 7374 656d 0a0a 3133 : Filesystem..13 │ │ │ │ │ -0001f970: 2e33 2048 6f77 2074 6f20 7370 6563 6966 .3 How to specif │ │ │ │ │ -0001f980: 7920 626c 6f63 6b20 6c69 7374 730a 3d3d y block lists.== │ │ │ │ │ +0001f5a0: 3d3d 3d0a 0a54 6865 7265 2061 7265 2074 ===..There are t │ │ │ │ │ +0001f5b0: 776f 2077 6179 7320 746f 2073 7065 6369 wo ways to speci │ │ │ │ │ +0001f5c0: 6679 2066 696c 6573 2c20 6279 2022 6162 fy files, by "ab │ │ │ │ │ +0001f5d0: 736f 6c75 7465 2066 696c 6520 6e61 6d65 solute file name │ │ │ │ │ +0001f5e0: 2220 616e 6420 6279 0a22 626c 6f63 6b20 " and by."block │ │ │ │ │ +0001f5f0: 6c69 7374 222e 0a0a 2020 2041 6e20 6162 list"... An ab │ │ │ │ │ +0001f600: 736f 6c75 7465 2066 696c 6520 6e61 6d65 solute file name │ │ │ │ │ +0001f610: 2072 6573 656d 626c 6573 2061 2055 6e69 resembles a Uni │ │ │ │ │ +0001f620: 7820 6162 736f 6c75 7465 2066 696c 6520 x absolute file │ │ │ │ │ +0001f630: 6e61 6d65 2c20 7573 696e 6720 272f 270a name, using '/'. │ │ │ │ │ +0001f640: 666f 7220 7468 6520 6469 7265 6374 6f72 for the director │ │ │ │ │ +0001f650: 7920 7365 7061 7261 746f 7220 286e 6f74 y separator (not │ │ │ │ │ +0001f660: 2027 5c27 2061 7320 696e 2044 4f53 292e '\' as in DOS). │ │ │ │ │ +0001f670: 204f 6e65 2065 7861 6d70 6c65 2069 730a One example is. │ │ │ │ │ +0001f680: 2728 6864 302c 3129 2f62 6f6f 742f 6772 '(hd0,1)/boot/gr │ │ │ │ │ +0001f690: 7562 2f67 7275 622e 6366 6727 2e20 2054 ub/grub.cfg'. T │ │ │ │ │ +0001f6a0: 6869 7320 6d65 616e 7320 7468 6520 6669 his means the fi │ │ │ │ │ +0001f6b0: 6c65 2027 2f62 6f6f 742f 6772 7562 2f67 le '/boot/grub/g │ │ │ │ │ +0001f6c0: 7275 622e 6366 6727 0a69 6e20 7468 6520 rub.cfg'.in the │ │ │ │ │ +0001f6d0: 6669 7273 7420 7061 7274 6974 696f 6e20 first partition │ │ │ │ │ +0001f6e0: 6f66 2074 6865 2066 6972 7374 2068 6172 of the first har │ │ │ │ │ +0001f6f0: 6420 6469 736b 2e20 2049 6620 796f 7520 d disk. If you │ │ │ │ │ +0001f700: 6f6d 6974 2074 6865 2064 6576 6963 650a omit the device. │ │ │ │ │ +0001f710: 6e61 6d65 2069 6e20 616e 2061 6273 6f6c name in an absol │ │ │ │ │ +0001f720: 7574 6520 6669 6c65 206e 616d 652c 2047 ute file name, G │ │ │ │ │ +0001f730: 5255 4220 7573 6573 2047 5255 4227 7320 RUB uses GRUB's │ │ │ │ │ +0001f740: 2272 6f6f 7420 6465 7669 6365 220a 696d "root device".im │ │ │ │ │ +0001f750: 706c 6963 6974 6c79 2e20 2053 6f20 6966 plicitly. So if │ │ │ │ │ +0001f760: 2079 6f75 2073 6574 2074 6865 2072 6f6f you set the roo │ │ │ │ │ +0001f770: 7420 6465 7669 6365 2074 6f2c 2073 6179 t device to, say │ │ │ │ │ +0001f780: 2c20 2728 6864 312c 3129 2720 6279 2074 , '(hd1,1)' by t │ │ │ │ │ +0001f790: 6865 0a63 6f6d 6d61 6e64 2027 7365 7420 he.command 'set │ │ │ │ │ +0001f7a0: 726f 6f74 3d28 6864 312c 3129 2720 282a root=(hd1,1)' (* │ │ │ │ │ +0001f7b0: 6e6f 7465 2073 6574 3a3a 292c 2074 6865 note set::), the │ │ │ │ │ +0001f7c0: 6e20 272f 626f 6f74 2f6b 6572 6e65 6c27 n '/boot/kernel' │ │ │ │ │ +0001f7d0: 2069 7320 7468 650a 7361 6d65 2061 7320 is the.same as │ │ │ │ │ +0001f7e0: 2728 6864 312c 3129 2f62 6f6f 742f 6b65 '(hd1,1)/boot/ke │ │ │ │ │ +0001f7f0: 726e 656c 272e 0a0a 2020 204f 6e20 5a46 rnel'... On ZF │ │ │ │ │ +0001f800: 5320 6669 6c65 7379 7374 656d 2074 6865 S filesystem the │ │ │ │ │ +0001f810: 2066 6972 7374 2070 6174 6820 636f 6d70 first path comp │ │ │ │ │ +0001f820: 6f6e 656e 7420 6d75 7374 2062 650a 564f onent must be.VO │ │ │ │ │ +0001f830: 4c55 4d45 2740 275b 534e 4150 5348 4f54 LUME'@'[SNAPSHOT │ │ │ │ │ +0001f840: 5d2e 2020 536f 2027 2f72 6f6f 7476 6f6c ]. So '/rootvol │ │ │ │ │ +0001f850: 4073 6e61 702d 3132 392f 626f 6f74 2f67 @snap-129/boot/g │ │ │ │ │ +0001f860: 7275 622f 6772 7562 2e63 6667 2720 7265 rub/grub.cfg' re │ │ │ │ │ +0001f870: 6665 7273 0a74 6f20 6669 6c65 2027 2f62 fers.to file '/b │ │ │ │ │ +0001f880: 6f6f 742f 6772 7562 2f67 7275 622e 6366 oot/grub/grub.cf │ │ │ │ │ +0001f890: 6727 2069 6e20 736e 6170 7368 6f74 206f g' in snapshot o │ │ │ │ │ +0001f8a0: 6620 766f 6c75 6d65 2027 726f 6f74 766f f volume 'rootvo │ │ │ │ │ +0001f8b0: 6c27 2077 6974 6820 6e61 6d65 0a27 736e l' with name.'sn │ │ │ │ │ +0001f8c0: 6170 2d31 3239 272e 2020 5472 6169 6c69 ap-129'. Traili │ │ │ │ │ +0001f8d0: 6e67 2027 4027 2061 6674 6572 2076 6f6c ng '@' after vol │ │ │ │ │ +0001f8e0: 756d 6520 6e61 6d65 2069 7320 6d61 6e64 ume name is mand │ │ │ │ │ +0001f8f0: 6174 6f72 7920 6576 656e 2069 660a 736e atory even if.sn │ │ │ │ │ +0001f900: 6170 7368 6f74 206e 616d 6520 6973 206f apshot name is o │ │ │ │ │ +0001f910: 6d69 7474 6564 2e0a 0a1f 0a46 696c 653a mitted.....File: │ │ │ │ │ +0001f920: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0001f930: 653a 2042 6c6f 636b 206c 6973 7420 7379 e: Block list sy │ │ │ │ │ +0001f940: 6e74 6178 2c20 2050 7265 763a 2046 696c ntax, Prev: Fil │ │ │ │ │ +0001f950: 6520 6e61 6d65 2073 796e 7461 782c 2020 e name syntax, │ │ │ │ │ +0001f960: 5570 3a20 4669 6c65 7379 7374 656d 0a0a Up: Filesystem.. │ │ │ │ │ +0001f970: 3133 2e33 2048 6f77 2074 6f20 7370 6563 13.3 How to spec │ │ │ │ │ +0001f980: 6966 7920 626c 6f63 6b20 6c69 7374 730a ify block lists. │ │ │ │ │ 0001f990: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001f9a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a41 =============..A │ │ │ │ │ -0001f9b0: 2062 6c6f 636b 206c 6973 7420 6973 2075 block list is u │ │ │ │ │ -0001f9c0: 7365 6420 666f 7220 7370 6563 6966 7969 sed for specifyi │ │ │ │ │ -0001f9d0: 6e67 2061 2066 696c 6520 7468 6174 2064 ng a file that d │ │ │ │ │ -0001f9e0: 6f65 736e 2774 2061 7070 6561 7220 696e oesn't appear in │ │ │ │ │ -0001f9f0: 2074 6865 0a66 696c 6573 7973 7465 6d2c the.filesystem, │ │ │ │ │ -0001fa00: 206c 696b 6520 6120 6368 6169 6e6c 6f61 like a chainloa │ │ │ │ │ -0001fa10: 6465 722e 2020 5468 6520 7379 6e74 6178 der. The syntax │ │ │ │ │ -0001fa20: 2069 730a 275b 4f46 4653 4554 5d2b 4c45 is.'[OFFSET]+LE │ │ │ │ │ -0001fa30: 4e47 5448 5b2c 5b4f 4646 5345 545d 2b4c NGTH[,[OFFSET]+L │ │ │ │ │ -0001fa40: 454e 4754 485d 2e2e 2e27 2e20 2048 6572 ENGTH]...'. Her │ │ │ │ │ -0001fa50: 6520 6973 2061 6e20 6578 616d 706c 653a e is an example: │ │ │ │ │ -0001fa60: 0a0a 2020 2020 2030 2b31 3030 2c32 3030 .. 0+100,200 │ │ │ │ │ -0001fa70: 2b31 2c33 3030 2b33 3030 0a0a 2020 2054 +1,300+300.. T │ │ │ │ │ -0001fa80: 6869 7320 7265 7072 6573 656e 7473 2074 his represents t │ │ │ │ │ -0001fa90: 6861 7420 4752 5542 2073 686f 756c 6420 hat GRUB should │ │ │ │ │ -0001faa0: 7265 6164 2062 6c6f 636b 7320 3020 7468 read blocks 0 th │ │ │ │ │ -0001fab0: 726f 7567 6820 3939 2c20 626c 6f63 6b20 rough 99, block │ │ │ │ │ -0001fac0: 3230 302c 0a61 6e64 2062 6c6f 636b 7320 200,.and blocks │ │ │ │ │ -0001fad0: 3330 3020 7468 726f 7567 6820 3539 392e 300 through 599. │ │ │ │ │ -0001fae0: 2020 4966 2079 6f75 206f 6d69 7420 616e If you omit an │ │ │ │ │ -0001faf0: 206f 6666 7365 742c 2074 6865 6e20 4752 offset, then GR │ │ │ │ │ -0001fb00: 5542 2061 7373 756d 6573 0a74 6865 206f UB assumes.the o │ │ │ │ │ -0001fb10: 6666 7365 7420 6973 207a 6572 6f2e 0a0a ffset is zero... │ │ │ │ │ -0001fb20: 2020 204c 696b 6520 7468 6520 6669 6c65 Like the file │ │ │ │ │ -0001fb30: 206e 616d 6520 7379 6e74 6178 2028 2a6e name syntax (*n │ │ │ │ │ -0001fb40: 6f74 6520 4669 6c65 206e 616d 6520 7379 ote File name sy │ │ │ │ │ -0001fb50: 6e74 6178 3a3a 292c 2069 6620 6120 626c ntax::), if a bl │ │ │ │ │ -0001fb60: 6f63 6b6c 6973 740a 646f 6573 206e 6f74 ocklist.does not │ │ │ │ │ -0001fb70: 2063 6f6e 7461 696e 2061 2064 6576 6963 contain a devic │ │ │ │ │ -0001fb80: 6520 6e61 6d65 2c20 7468 656e 2047 5255 e name, then GRU │ │ │ │ │ -0001fb90: 4220 7573 6573 2047 5255 4227 7320 2272 B uses GRUB's "r │ │ │ │ │ -0001fba0: 6f6f 7420 6465 7669 6365 222e 2020 536f oot device". So │ │ │ │ │ -0001fbb0: 0a27 2868 6430 2c32 292b 3127 2069 7320 .'(hd0,2)+1' is │ │ │ │ │ -0001fbc0: 7468 6520 7361 6d65 2061 7320 272b 3127 the same as '+1' │ │ │ │ │ -0001fbd0: 2077 6865 6e20 7468 6520 726f 6f74 2064 when the root d │ │ │ │ │ -0001fbe0: 6576 6963 6520 6973 2027 2868 6430 2c32 evice is '(hd0,2 │ │ │ │ │ -0001fbf0: 2927 2e0a 0a1f 0a46 696c 653a 2067 7275 )'.....File: gru │ │ │ │ │ -0001fc00: 622e 696e 666f 2c20 204e 6f64 653a 2049 b.info, Node: I │ │ │ │ │ -0001fc10: 6e74 6572 6661 6365 2c20 204e 6578 743a nterface, Next: │ │ │ │ │ -0001fc20: 2045 6e76 6972 6f6e 6d65 6e74 2c20 2050 Environment, P │ │ │ │ │ -0001fc30: 7265 763a 2046 696c 6573 7973 7465 6d2c rev: Filesystem, │ │ │ │ │ -0001fc40: 2020 5570 3a20 546f 700a 0a31 3420 4752 Up: Top..14 GR │ │ │ │ │ -0001fc50: 5542 2773 2075 7365 7220 696e 7465 7266 UB's user interf │ │ │ │ │ -0001fc60: 6163 650a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ace.************ │ │ │ │ │ -0001fc70: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 4752 ************..GR │ │ │ │ │ -0001fc80: 5542 2068 6173 2062 6f74 6820 6120 7369 UB has both a si │ │ │ │ │ -0001fc90: 6d70 6c65 206d 656e 7520 696e 7465 7266 mple menu interf │ │ │ │ │ -0001fca0: 6163 6520 666f 7220 6368 6f6f 7369 6e67 ace for choosing │ │ │ │ │ -0001fcb0: 2070 7265 7365 7420 656e 7472 6965 7320 preset entries │ │ │ │ │ -0001fcc0: 6672 6f6d 2061 0a63 6f6e 6669 6775 7261 from a.configura │ │ │ │ │ -0001fcd0: 7469 6f6e 2066 696c 652c 2061 6e64 2061 tion file, and a │ │ │ │ │ -0001fce0: 2068 6967 686c 7920 666c 6578 6962 6c65 highly flexible │ │ │ │ │ -0001fcf0: 2063 6f6d 6d61 6e64 2d6c 696e 6520 666f command-line fo │ │ │ │ │ -0001fd00: 7220 7065 7266 6f72 6d69 6e67 0a61 6e79 r performing.any │ │ │ │ │ -0001fd10: 2064 6573 6972 6564 2063 6f6d 6269 6e61 desired combina │ │ │ │ │ -0001fd20: 7469 6f6e 206f 6620 626f 6f74 2063 6f6d tion of boot com │ │ │ │ │ -0001fd30: 6d61 6e64 732e 0a0a 2020 2047 5255 4220 mands... GRUB │ │ │ │ │ -0001fd40: 6c6f 6f6b 7320 666f 7220 6974 7320 636f looks for its co │ │ │ │ │ -0001fd50: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ -0001fd60: 2061 7320 736f 6f6e 2061 7320 6974 2069 as soon as it i │ │ │ │ │ -0001fd70: 7320 6c6f 6164 6564 2e20 2049 660a 6f6e s loaded. If.on │ │ │ │ │ -0001fd80: 6520 6973 2066 6f75 6e64 2c20 7468 656e e is found, then │ │ │ │ │ -0001fd90: 2074 6865 2066 756c 6c20 6d65 6e75 2069 the full menu i │ │ │ │ │ -0001fda0: 6e74 6572 6661 6365 2069 7320 6163 7469 nterface is acti │ │ │ │ │ -0001fdb0: 7661 7465 6420 7573 696e 6720 7768 6174 vated using what │ │ │ │ │ -0001fdc0: 6576 6572 0a65 6e74 7269 6573 2077 6572 ever.entries wer │ │ │ │ │ -0001fdd0: 6520 666f 756e 6420 696e 2074 6865 2066 e found in the f │ │ │ │ │ -0001fde0: 696c 652e 2020 4966 2079 6f75 2063 686f ile. If you cho │ │ │ │ │ -0001fdf0: 6f73 6520 7468 6520 2263 6f6d 6d61 6e64 ose the "command │ │ │ │ │ -0001fe00: 2d6c 696e 6522 206d 656e 750a 6f70 7469 -line" menu.opti │ │ │ │ │ -0001fe10: 6f6e 2c20 6f72 2069 6620 7468 6520 636f on, or if the co │ │ │ │ │ -0001fe20: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ -0001fe30: 2077 6173 206e 6f74 2066 6f75 6e64 2c20 was not found, │ │ │ │ │ -0001fe40: 7468 656e 2047 5255 4220 6472 6f70 7320 then GRUB drops │ │ │ │ │ -0001fe50: 746f 0a74 6865 2063 6f6d 6d61 6e64 2d6c to.the command-l │ │ │ │ │ -0001fe60: 696e 6520 696e 7465 7266 6163 652e 0a0a ine interface... │ │ │ │ │ -0001fe70: 2a20 4d65 6e75 3a0a 0a2a 2043 6f6d 6d61 * Menu:..* Comma │ │ │ │ │ -0001fe80: 6e64 2d6c 696e 6520 696e 7465 7266 6163 nd-line interfac │ │ │ │ │ -0001fe90: 653a 3a20 2020 2020 2054 6865 2066 6c65 e:: The fle │ │ │ │ │ -0001fea0: 7869 626c 6520 636f 6d6d 616e 642d 6c69 xible command-li │ │ │ │ │ -0001feb0: 6e65 2069 6e74 6572 6661 6365 0a2a 204d ne interface.* M │ │ │ │ │ -0001fec0: 656e 7520 696e 7465 7266 6163 653a 3a20 enu interface:: │ │ │ │ │ -0001fed0: 2020 2020 2020 2020 2020 2020 2054 6865 The │ │ │ │ │ -0001fee0: 2073 696d 706c 6520 6d65 6e75 2069 6e74 simple menu int │ │ │ │ │ -0001fef0: 6572 6661 6365 0a2a 204d 656e 7520 656e erface.* Menu en │ │ │ │ │ -0001ff00: 7472 7920 6564 6974 6f72 3a3a 2020 2020 try editor:: │ │ │ │ │ -0001ff10: 2020 2020 2020 2045 6469 7469 6e67 2061 Editing a │ │ │ │ │ -0001ff20: 206d 656e 7520 656e 7472 790a 0a1f 0a46 menu entry....F │ │ │ │ │ -0001ff30: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -0001ff40: 204e 6f64 653a 2043 6f6d 6d61 6e64 2d6c Node: Command-l │ │ │ │ │ -0001ff50: 696e 6520 696e 7465 7266 6163 652c 2020 ine interface, │ │ │ │ │ -0001ff60: 4e65 7874 3a20 4d65 6e75 2069 6e74 6572 Next: Menu inter │ │ │ │ │ -0001ff70: 6661 6365 2c20 2055 703a 2049 6e74 6572 face, Up: Inter │ │ │ │ │ -0001ff80: 6661 6365 0a0a 3134 2e31 2054 6865 2066 face..14.1 The f │ │ │ │ │ -0001ff90: 6c65 7869 626c 6520 636f 6d6d 616e 642d lexible command- │ │ │ │ │ -0001ffa0: 6c69 6e65 2069 6e74 6572 6661 6365 0a3d line interface.= │ │ │ │ │ -0001ffb0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +0001f9a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +0001f9b0: 0a41 2062 6c6f 636b 206c 6973 7420 6973 .A block list is │ │ │ │ │ +0001f9c0: 2075 7365 6420 666f 7220 7370 6563 6966 used for specif │ │ │ │ │ +0001f9d0: 7969 6e67 2061 2066 696c 6520 7468 6174 ying a file that │ │ │ │ │ +0001f9e0: 2064 6f65 736e 2774 2061 7070 6561 7220 doesn't appear │ │ │ │ │ +0001f9f0: 696e 2074 6865 0a66 696c 6573 7973 7465 in the.filesyste │ │ │ │ │ +0001fa00: 6d2c 206c 696b 6520 6120 6368 6169 6e6c m, like a chainl │ │ │ │ │ +0001fa10: 6f61 6465 722e 2020 5468 6520 7379 6e74 oader. The synt │ │ │ │ │ +0001fa20: 6178 2069 730a 275b 4f46 4653 4554 5d2b ax is.'[OFFSET]+ │ │ │ │ │ +0001fa30: 4c45 4e47 5448 5b2c 5b4f 4646 5345 545d LENGTH[,[OFFSET] │ │ │ │ │ +0001fa40: 2b4c 454e 4754 485d 2e2e 2e27 2e20 2048 +LENGTH]...'. H │ │ │ │ │ +0001fa50: 6572 6520 6973 2061 6e20 6578 616d 706c ere is an exampl │ │ │ │ │ +0001fa60: 653a 0a0a 2020 2020 2030 2b31 3030 2c32 e:.. 0+100,2 │ │ │ │ │ +0001fa70: 3030 2b31 2c33 3030 2b33 3030 0a0a 2020 00+1,300+300.. │ │ │ │ │ +0001fa80: 2054 6869 7320 7265 7072 6573 656e 7473 This represents │ │ │ │ │ +0001fa90: 2074 6861 7420 4752 5542 2073 686f 756c that GRUB shoul │ │ │ │ │ +0001faa0: 6420 7265 6164 2062 6c6f 636b 7320 3020 d read blocks 0 │ │ │ │ │ +0001fab0: 7468 726f 7567 6820 3939 2c20 626c 6f63 through 99, bloc │ │ │ │ │ +0001fac0: 6b20 3230 302c 0a61 6e64 2062 6c6f 636b k 200,.and block │ │ │ │ │ +0001fad0: 7320 3330 3020 7468 726f 7567 6820 3539 s 300 through 59 │ │ │ │ │ +0001fae0: 392e 2020 4966 2079 6f75 206f 6d69 7420 9. If you omit │ │ │ │ │ +0001faf0: 616e 206f 6666 7365 742c 2074 6865 6e20 an offset, then │ │ │ │ │ +0001fb00: 4752 5542 2061 7373 756d 6573 0a74 6865 GRUB assumes.the │ │ │ │ │ +0001fb10: 206f 6666 7365 7420 6973 207a 6572 6f2e offset is zero. │ │ │ │ │ +0001fb20: 0a0a 2020 204c 696b 6520 7468 6520 6669 .. Like the fi │ │ │ │ │ +0001fb30: 6c65 206e 616d 6520 7379 6e74 6178 2028 le name syntax ( │ │ │ │ │ +0001fb40: 2a6e 6f74 6520 4669 6c65 206e 616d 6520 *note File name │ │ │ │ │ +0001fb50: 7379 6e74 6178 3a3a 292c 2069 6620 6120 syntax::), if a │ │ │ │ │ +0001fb60: 626c 6f63 6b6c 6973 740a 646f 6573 206e blocklist.does n │ │ │ │ │ +0001fb70: 6f74 2063 6f6e 7461 696e 2061 2064 6576 ot contain a dev │ │ │ │ │ +0001fb80: 6963 6520 6e61 6d65 2c20 7468 656e 2047 ice name, then G │ │ │ │ │ +0001fb90: 5255 4220 7573 6573 2047 5255 4227 7320 RUB uses GRUB's │ │ │ │ │ +0001fba0: 2272 6f6f 7420 6465 7669 6365 222e 2020 "root device". │ │ │ │ │ +0001fbb0: 536f 0a27 2868 6430 2c32 292b 3127 2069 So.'(hd0,2)+1' i │ │ │ │ │ +0001fbc0: 7320 7468 6520 7361 6d65 2061 7320 272b s the same as '+ │ │ │ │ │ +0001fbd0: 3127 2077 6865 6e20 7468 6520 726f 6f74 1' when the root │ │ │ │ │ +0001fbe0: 2064 6576 6963 6520 6973 2027 2868 6430 device is '(hd0 │ │ │ │ │ +0001fbf0: 2c32 2927 2e0a 0a1f 0a46 696c 653a 2067 ,2)'.....File: g │ │ │ │ │ +0001fc00: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +0001fc10: 2049 6e74 6572 6661 6365 2c20 204e 6578 Interface, Nex │ │ │ │ │ +0001fc20: 743a 2045 6e76 6972 6f6e 6d65 6e74 2c20 t: Environment, │ │ │ │ │ +0001fc30: 2050 7265 763a 2046 696c 6573 7973 7465 Prev: Filesyste │ │ │ │ │ +0001fc40: 6d2c 2020 5570 3a20 546f 700a 0a31 3420 m, Up: Top..14 │ │ │ │ │ +0001fc50: 4752 5542 2773 2075 7365 7220 696e 7465 GRUB's user inte │ │ │ │ │ +0001fc60: 7266 6163 650a 2a2a 2a2a 2a2a 2a2a 2a2a rface.********** │ │ │ │ │ +0001fc70: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ +0001fc80: 4752 5542 2068 6173 2062 6f74 6820 6120 GRUB has both a │ │ │ │ │ +0001fc90: 7369 6d70 6c65 206d 656e 7520 696e 7465 simple menu inte │ │ │ │ │ +0001fca0: 7266 6163 6520 666f 7220 6368 6f6f 7369 rface for choosi │ │ │ │ │ +0001fcb0: 6e67 2070 7265 7365 7420 656e 7472 6965 ng preset entrie │ │ │ │ │ +0001fcc0: 7320 6672 6f6d 2061 0a63 6f6e 6669 6775 s from a.configu │ │ │ │ │ +0001fcd0: 7261 7469 6f6e 2066 696c 652c 2061 6e64 ration file, and │ │ │ │ │ +0001fce0: 2061 2068 6967 686c 7920 666c 6578 6962 a highly flexib │ │ │ │ │ +0001fcf0: 6c65 2063 6f6d 6d61 6e64 2d6c 696e 6520 le command-line │ │ │ │ │ +0001fd00: 666f 7220 7065 7266 6f72 6d69 6e67 0a61 for performing.a │ │ │ │ │ +0001fd10: 6e79 2064 6573 6972 6564 2063 6f6d 6269 ny desired combi │ │ │ │ │ +0001fd20: 6e61 7469 6f6e 206f 6620 626f 6f74 2063 nation of boot c │ │ │ │ │ +0001fd30: 6f6d 6d61 6e64 732e 0a0a 2020 2047 5255 ommands... GRU │ │ │ │ │ +0001fd40: 4220 6c6f 6f6b 7320 666f 7220 6974 7320 B looks for its │ │ │ │ │ +0001fd50: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ +0001fd60: 6c65 2061 7320 736f 6f6e 2061 7320 6974 le as soon as it │ │ │ │ │ +0001fd70: 2069 7320 6c6f 6164 6564 2e20 2049 660a is loaded. If. │ │ │ │ │ +0001fd80: 6f6e 6520 6973 2066 6f75 6e64 2c20 7468 one is found, th │ │ │ │ │ +0001fd90: 656e 2074 6865 2066 756c 6c20 6d65 6e75 en the full menu │ │ │ │ │ +0001fda0: 2069 6e74 6572 6661 6365 2069 7320 6163 interface is ac │ │ │ │ │ +0001fdb0: 7469 7661 7465 6420 7573 696e 6720 7768 tivated using wh │ │ │ │ │ +0001fdc0: 6174 6576 6572 0a65 6e74 7269 6573 2077 atever.entries w │ │ │ │ │ +0001fdd0: 6572 6520 666f 756e 6420 696e 2074 6865 ere found in the │ │ │ │ │ +0001fde0: 2066 696c 652e 2020 4966 2079 6f75 2063 file. If you c │ │ │ │ │ +0001fdf0: 686f 6f73 6520 7468 6520 2263 6f6d 6d61 hoose the "comma │ │ │ │ │ +0001fe00: 6e64 2d6c 696e 6522 206d 656e 750a 6f70 nd-line" menu.op │ │ │ │ │ +0001fe10: 7469 6f6e 2c20 6f72 2069 6620 7468 6520 tion, or if the │ │ │ │ │ +0001fe20: 636f 6e66 6967 7572 6174 696f 6e20 6669 configuration fi │ │ │ │ │ +0001fe30: 6c65 2077 6173 206e 6f74 2066 6f75 6e64 le was not found │ │ │ │ │ +0001fe40: 2c20 7468 656e 2047 5255 4220 6472 6f70 , then GRUB drop │ │ │ │ │ +0001fe50: 7320 746f 0a74 6865 2063 6f6d 6d61 6e64 s to.the command │ │ │ │ │ +0001fe60: 2d6c 696e 6520 696e 7465 7266 6163 652e -line interface. │ │ │ │ │ +0001fe70: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2043 6f6d ..* Menu:..* Com │ │ │ │ │ +0001fe80: 6d61 6e64 2d6c 696e 6520 696e 7465 7266 mand-line interf │ │ │ │ │ +0001fe90: 6163 653a 3a20 2020 2020 2054 6865 2066 ace:: The f │ │ │ │ │ +0001fea0: 6c65 7869 626c 6520 636f 6d6d 616e 642d lexible command- │ │ │ │ │ +0001feb0: 6c69 6e65 2069 6e74 6572 6661 6365 0a2a line interface.* │ │ │ │ │ +0001fec0: 204d 656e 7520 696e 7465 7266 6163 653a Menu interface: │ │ │ │ │ +0001fed0: 3a20 2020 2020 2020 2020 2020 2020 2054 : T │ │ │ │ │ +0001fee0: 6865 2073 696d 706c 6520 6d65 6e75 2069 he simple menu i │ │ │ │ │ +0001fef0: 6e74 6572 6661 6365 0a2a 204d 656e 7520 nterface.* Menu │ │ │ │ │ +0001ff00: 656e 7472 7920 6564 6974 6f72 3a3a 2020 entry editor:: │ │ │ │ │ +0001ff10: 2020 2020 2020 2020 2045 6469 7469 6e67 Editing │ │ │ │ │ +0001ff20: 2061 206d 656e 7520 656e 7472 790a 0a1f a menu entry... │ │ │ │ │ +0001ff30: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +0001ff40: 2c20 204e 6f64 653a 2043 6f6d 6d61 6e64 , Node: Command │ │ │ │ │ +0001ff50: 2d6c 696e 6520 696e 7465 7266 6163 652c -line interface, │ │ │ │ │ +0001ff60: 2020 4e65 7874 3a20 4d65 6e75 2069 6e74 Next: Menu int │ │ │ │ │ +0001ff70: 6572 6661 6365 2c20 2055 703a 2049 6e74 erface, Up: Int │ │ │ │ │ +0001ff80: 6572 6661 6365 0a0a 3134 2e31 2054 6865 erface..14.1 The │ │ │ │ │ +0001ff90: 2066 6c65 7869 626c 6520 636f 6d6d 616e flexible comman │ │ │ │ │ +0001ffa0: 642d 6c69 6e65 2069 6e74 6572 6661 6365 d-line interface │ │ │ │ │ +0001ffb0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ 0001ffc0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0001ffd0: 3d3d 3d3d 3d3d 3d0a 0a54 6865 2063 6f6d =======..The com │ │ │ │ │ -0001ffe0: 6d61 6e64 2d6c 696e 6520 696e 7465 7266 mand-line interf │ │ │ │ │ -0001fff0: 6163 6520 7072 6f76 6964 6573 2061 2070 ace provides a p │ │ │ │ │ -00020000: 726f 6d70 7420 616e 6420 6166 7465 7220 rompt and after │ │ │ │ │ -00020010: 6974 2061 6e20 6564 6974 6162 6c65 0a74 it an editable.t │ │ │ │ │ -00020020: 6578 7420 6172 6561 206d 7563 6820 6c69 ext area much li │ │ │ │ │ -00020030: 6b65 2061 2063 6f6d 6d61 6e64 2d6c 696e ke a command-lin │ │ │ │ │ -00020040: 6520 696e 2055 6e69 7820 6f72 2044 4f53 e in Unix or DOS │ │ │ │ │ -00020050: 2e20 4561 6368 2063 6f6d 6d61 6e64 2069 . Each command i │ │ │ │ │ -00020060: 730a 696d 6d65 6469 6174 656c 7920 6578 s.immediately ex │ │ │ │ │ -00020070: 6563 7574 6564 2061 6674 6572 2069 7420 ecuted after it │ │ │ │ │ -00020080: 6973 2065 6e74 6572 6564 2831 2920 282a is entered(1) (* │ │ │ │ │ -00020090: 6e6f 7465 2043 6f6d 6d61 6e64 2d6c 696e note Command-lin │ │ │ │ │ -000200a0: 650a 696e 7465 7266 6163 652d 466f 6f74 e.interface-Foot │ │ │ │ │ -000200b0: 6e6f 7465 2d31 3a3a 292e 2020 5468 6520 note-1::). The │ │ │ │ │ -000200c0: 636f 6d6d 616e 6473 2028 2a6e 6f74 6520 commands (*note │ │ │ │ │ -000200d0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -000200e0: 206d 656e 750a 656e 7472 7920 636f 6d6d menu.entry comm │ │ │ │ │ -000200f0: 616e 6473 3a3a 2920 6172 6520 6120 7375 ands::) are a su │ │ │ │ │ -00020100: 6273 6574 206f 6620 7468 6f73 6520 6176 bset of those av │ │ │ │ │ -00020110: 6169 6c61 626c 6520 696e 2074 6865 2063 ailable in the c │ │ │ │ │ -00020120: 6f6e 6669 6775 7261 7469 6f6e 0a66 696c onfiguration.fil │ │ │ │ │ -00020130: 652c 2075 7365 6420 7769 7468 2065 7861 e, used with exa │ │ │ │ │ -00020140: 6374 6c79 2074 6865 2073 616d 6520 7379 ctly the same sy │ │ │ │ │ -00020150: 6e74 6178 2e0a 0a20 2020 4375 7273 6f72 ntax... Cursor │ │ │ │ │ -00020160: 206d 6f76 656d 656e 7420 616e 6420 6564 movement and ed │ │ │ │ │ -00020170: 6974 696e 6720 6f66 2074 6865 2074 6578 iting of the tex │ │ │ │ │ -00020180: 7420 6f6e 2074 6865 206c 696e 6520 6361 t on the line ca │ │ │ │ │ -00020190: 6e20 6265 2064 6f6e 6520 7669 6120 610a n be done via a. │ │ │ │ │ -000201a0: 7375 6273 6574 206f 6620 7468 6520 6675 subset of the fu │ │ │ │ │ -000201b0: 6e63 7469 6f6e 7320 6176 6169 6c61 626c nctions availabl │ │ │ │ │ -000201c0: 6520 696e 2074 6865 2042 6173 6820 7368 e in the Bash sh │ │ │ │ │ -000201d0: 656c 6c3a 0a0a 3c43 2d66 3e0a 3c50 4320 ell:.... │ │ │ │ │ -000201f0: 4d6f 7665 2066 6f72 7761 7264 206f 6e65 Move forward one │ │ │ │ │ -00020200: 2063 6861 7261 6374 6572 2e0a 0a3c 432d character.... │ │ │ │ │ -00020220: 0a20 2020 2020 4d6f 7665 2062 6163 6b20 . Move back │ │ │ │ │ -00020230: 6f6e 6520 6368 6172 6163 7465 722e 0a0a one character... │ │ │ │ │ -00020240: 3c43 2d61 3e0a 3c48 4f4d 453e 0a20 2020 .. │ │ │ │ │ -00020250: 2020 4d6f 7665 2074 6f20 7468 6520 7374 Move to the st │ │ │ │ │ -00020260: 6172 7420 6f66 2074 6865 206c 696e 652e art of the line. │ │ │ │ │ -00020270: 0a0a 3c43 2d65 3e0a 3c45 4e44 3e0a 2020 .... │ │ │ │ │ -00020280: 2020 204d 6f76 6520 7468 6520 7468 6520 Move the the │ │ │ │ │ -00020290: 656e 6420 6f66 2074 6865 206c 696e 652e end of the line. │ │ │ │ │ -000202a0: 0a0a 3c43 2d64 3e0a 3c44 454c 3e0a 2020 .... │ │ │ │ │ -000202b0: 2020 2044 656c 6574 6520 7468 6520 6368 Delete the ch │ │ │ │ │ -000202c0: 6172 6163 7465 7220 756e 6465 726e 6561 aracter undernea │ │ │ │ │ -000202d0: 7468 2074 6865 2063 7572 736f 722e 0a0a th the cursor... │ │ │ │ │ -000202e0: 3c43 2d68 3e0a 3c42 533e 0a20 2020 2020 .. │ │ │ │ │ -000202f0: 4465 6c65 7465 2074 6865 2063 6861 7261 Delete the chara │ │ │ │ │ -00020300: 6374 6572 2074 6f20 7468 6520 6c65 6674 cter to the left │ │ │ │ │ -00020310: 206f 6620 7468 6520 6375 7273 6f72 2e0a of the cursor.. │ │ │ │ │ -00020320: 0a3c 432d 6b3e 0a20 2020 2020 4b69 6c6c .. Kill │ │ │ │ │ -00020330: 2074 6865 2074 6578 7420 6672 6f6d 2074 the text from t │ │ │ │ │ -00020340: 6865 2063 7572 7265 6e74 2063 7572 736f he current curso │ │ │ │ │ -00020350: 7220 706f 7369 7469 6f6e 2074 6f20 7468 r position to th │ │ │ │ │ -00020360: 6520 656e 6420 6f66 2074 6865 0a20 2020 e end of the. │ │ │ │ │ -00020370: 2020 6c69 6e65 2e0a 0a3c 432d 753e 0a20 line.... │ │ │ │ │ -00020380: 2020 2020 4b69 6c6c 2062 6163 6b77 6172 Kill backwar │ │ │ │ │ -00020390: 6420 6672 6f6d 2074 6865 2063 7572 736f d from the curso │ │ │ │ │ -000203a0: 7220 746f 2074 6865 2062 6567 696e 6e69 r to the beginni │ │ │ │ │ -000203b0: 6e67 206f 6620 7468 6520 6c69 6e65 2e0a ng of the line.. │ │ │ │ │ -000203c0: 0a3c 432d 793e 0a20 2020 2020 5961 6e6b .. Yank │ │ │ │ │ -000203d0: 2074 6865 206b 696c 6c65 6420 7465 7874 the killed text │ │ │ │ │ -000203e0: 2062 6163 6b20 696e 746f 2074 6865 2062 back into the b │ │ │ │ │ -000203f0: 7566 6665 7220 6174 2074 6865 2063 7572 uffer at the cur │ │ │ │ │ -00020400: 736f 722e 0a0a 3c43 2d70 3e0a 3c50 4320 sor..... Mov │ │ │ │ │ -00020420: 6520 7570 2074 6872 6f75 6768 2074 6865 e up through the │ │ │ │ │ -00020430: 2068 6973 746f 7279 206c 6973 742e 0a0a history list... │ │ │ │ │ -00020440: 3c43 2d6e 3e0a 3c50 4320 646f 776e 206b .. Move do │ │ │ │ │ -00020460: 776e 2074 6872 6f75 6768 2074 6865 2068 wn through the h │ │ │ │ │ -00020470: 6973 746f 7279 206c 6973 742e 0a0a 2020 istory list... │ │ │ │ │ -00020480: 2057 6865 6e20 7479 7069 6e67 2063 6f6d When typing com │ │ │ │ │ -00020490: 6d61 6e64 7320 696e 7465 7261 6374 6976 mands interactiv │ │ │ │ │ -000204a0: 656c 792c 2069 6620 7468 6520 6375 7273 ely, if the curs │ │ │ │ │ -000204b0: 6f72 2069 7320 7769 7468 696e 206f 7220 or is within or │ │ │ │ │ -000204c0: 6265 666f 7265 0a74 6865 2066 6972 7374 before.the first │ │ │ │ │ -000204d0: 2077 6f72 6420 696e 2074 6865 2063 6f6d word in the com │ │ │ │ │ -000204e0: 6d61 6e64 2d6c 696e 652c 2070 7265 7373 mand-line, press │ │ │ │ │ -000204f0: 696e 6720 7468 6520 3c54 4142 3e20 6b65 ing the ke │ │ │ │ │ -00020500: 7920 286f 7220 3c43 2d69 3e29 0a77 696c y (or ).wil │ │ │ │ │ -00020510: 6c20 6469 7370 6c61 7920 6120 6c69 7374 l display a list │ │ │ │ │ -00020520: 696e 6720 6f66 2074 6865 2061 7661 696c ing of the avail │ │ │ │ │ -00020530: 6162 6c65 2063 6f6d 6d61 6e64 732c 2061 able commands, a │ │ │ │ │ -00020540: 6e64 2069 6620 7468 6520 6375 7273 6f72 nd if the cursor │ │ │ │ │ -00020550: 2069 730a 6166 7465 7220 7468 6520 6669 is.after the fi │ │ │ │ │ -00020560: 7273 7420 776f 7264 2c20 7468 6520 273c rst word, the '< │ │ │ │ │ -00020570: 5441 423e 2720 7769 6c6c 2070 726f 7669 TAB>' will provi │ │ │ │ │ -00020580: 6465 2061 2063 6f6d 706c 6574 696f 6e20 de a completion │ │ │ │ │ -00020590: 6c69 7374 696e 6720 6f66 0a64 6973 6b73 listing of.disks │ │ │ │ │ -000205a0: 2c20 7061 7274 6974 696f 6e73 2c20 616e , partitions, an │ │ │ │ │ -000205b0: 6420 6669 6c65 206e 616d 6573 2064 6570 d file names dep │ │ │ │ │ -000205c0: 656e 6469 6e67 206f 6e20 7468 6520 636f ending on the co │ │ │ │ │ -000205d0: 6e74 6578 742e 2020 4e6f 7465 2074 6861 ntext. Note tha │ │ │ │ │ -000205e0: 740a 746f 206f 6274 6169 6e20 6120 6c69 t.to obtain a li │ │ │ │ │ -000205f0: 7374 206f 6620 6472 6976 6573 2c20 6f6e st of drives, on │ │ │ │ │ -00020600: 6520 6d75 7374 206f 7065 6e20 6120 7061 e must open a pa │ │ │ │ │ -00020610: 7265 6e74 6865 7369 732c 2061 7320 2772 renthesis, as 'r │ │ │ │ │ -00020620: 6f6f 7420 2827 2e0a 0a20 2020 4e6f 7465 oot ('... Note │ │ │ │ │ -00020630: 2074 6861 7420 796f 7520 6361 6e6e 6f74 that you cannot │ │ │ │ │ -00020640: 2075 7365 2074 6865 2063 6f6d 706c 6574 use the complet │ │ │ │ │ -00020650: 696f 6e20 6675 6e63 7469 6f6e 616c 6974 ion functionalit │ │ │ │ │ -00020660: 7920 696e 2074 6865 2054 4654 500a 6669 y in the TFTP.fi │ │ │ │ │ -00020670: 6c65 7379 7374 656d 2e20 2054 6869 7320 lesystem. This │ │ │ │ │ -00020680: 6973 2062 6563 6175 7365 2054 4654 5020 is because TFTP │ │ │ │ │ -00020690: 646f 6573 6e27 7420 7375 7070 6f72 7420 doesn't support │ │ │ │ │ -000206a0: 6669 6c65 206e 616d 6520 6c69 7374 696e file name listin │ │ │ │ │ -000206b0: 6720 666f 720a 7468 6520 7365 6375 7269 g for.the securi │ │ │ │ │ -000206c0: 7479 2e0a 0a1f 0a46 696c 653a 2067 7275 ty.....File: gru │ │ │ │ │ -000206d0: 622e 696e 666f 2c20 204e 6f64 653a 2043 b.info, Node: C │ │ │ │ │ -000206e0: 6f6d 6d61 6e64 2d6c 696e 6520 696e 7465 ommand-line inte │ │ │ │ │ -000206f0: 7266 6163 652d 466f 6f74 6e6f 7465 732c rface-Footnotes, │ │ │ │ │ -00020700: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ -00020710: 6e65 2069 6e74 6572 6661 6365 0a0a 2020 ne interface.. │ │ │ │ │ -00020720: 2028 3129 2048 6f77 6576 6572 2c20 7468 (1) However, th │ │ │ │ │ -00020730: 6973 2062 6568 6176 696f 7220 7769 6c6c is behavior will │ │ │ │ │ -00020740: 2062 6520 6368 616e 6765 6420 696e 2074 be changed in t │ │ │ │ │ -00020750: 6865 2066 7574 7572 6520 7665 7273 696f he future versio │ │ │ │ │ -00020760: 6e2c 2069 6e0a 6120 7573 6572 2d69 6e76 n, in.a user-inv │ │ │ │ │ -00020770: 6973 6962 6c65 2077 6179 2e0a 0a1f 0a46 isible way.....F │ │ │ │ │ -00020780: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -00020790: 204e 6f64 653a 204d 656e 7520 696e 7465 Node: Menu inte │ │ │ │ │ -000207a0: 7266 6163 652c 2020 4e65 7874 3a20 4d65 rface, Next: Me │ │ │ │ │ -000207b0: 6e75 2065 6e74 7279 2065 6469 746f 722c nu entry editor, │ │ │ │ │ -000207c0: 2020 5072 6576 3a20 436f 6d6d 616e 642d Prev: Command- │ │ │ │ │ -000207d0: 6c69 6e65 2069 6e74 6572 6661 6365 2c20 line interface, │ │ │ │ │ -000207e0: 2055 703a 2049 6e74 6572 6661 6365 0a0a Up: Interface.. │ │ │ │ │ -000207f0: 3134 2e32 2054 6865 2073 696d 706c 6520 14.2 The simple │ │ │ │ │ -00020800: 6d65 6e75 2069 6e74 6572 6661 6365 0a3d menu interface.= │ │ │ │ │ -00020810: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00020820: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 =============..T │ │ │ │ │ -00020830: 6865 206d 656e 7520 696e 7465 7266 6163 he menu interfac │ │ │ │ │ -00020840: 6520 6973 2071 7569 7465 2065 6173 7920 e is quite easy │ │ │ │ │ -00020850: 746f 2075 7365 2e20 2049 7473 2063 6f6d to use. Its com │ │ │ │ │ -00020860: 6d61 6e64 7320 6172 6520 626f 7468 0a72 mands are both.r │ │ │ │ │ -00020870: 6561 736f 6e61 626c 7920 696e 7475 6974 easonably intuit │ │ │ │ │ -00020880: 6976 6520 616e 6420 6465 7363 7269 6265 ive and describe │ │ │ │ │ -00020890: 6420 6f6e 2073 6372 6565 6e2e 0a0a 2020 d on screen... │ │ │ │ │ -000208a0: 2042 6173 6963 616c 6c79 2c20 7468 6520 Basically, the │ │ │ │ │ -000208b0: 6d65 6e75 2069 6e74 6572 6661 6365 2070 menu interface p │ │ │ │ │ -000208c0: 726f 7669 6465 7320 6120 6c69 7374 206f rovides a list o │ │ │ │ │ -000208d0: 6620 2262 6f6f 7420 656e 7472 6965 7322 f "boot entries" │ │ │ │ │ -000208e0: 2074 6f0a 7468 6520 7573 6572 2074 6f20 to.the user to │ │ │ │ │ -000208f0: 6368 6f6f 7365 2066 726f 6d2e 2020 5573 choose from. Us │ │ │ │ │ -00020900: 6520 7468 6520 6172 726f 7720 6b65 7973 e the arrow keys │ │ │ │ │ -00020910: 2074 6f20 7365 6c65 6374 2074 6865 2065 to select the e │ │ │ │ │ -00020920: 6e74 7279 206f 660a 6368 6f69 6365 2c20 ntry of.choice, │ │ │ │ │ -00020930: 7468 656e 2070 7265 7373 203c 5245 543e then press │ │ │ │ │ -00020940: 2074 6f20 7275 6e20 6974 2e20 2041 6e20 to run it. An │ │ │ │ │ -00020950: 6f70 7469 6f6e 616c 2074 696d 656f 7574 optional timeout │ │ │ │ │ -00020960: 2069 7320 6176 6169 6c61 626c 6520 746f is available to │ │ │ │ │ -00020970: 0a62 6f6f 7420 7468 6520 6465 6661 756c .boot the defaul │ │ │ │ │ -00020980: 7420 656e 7472 7920 2874 6865 2066 6972 t entry (the fir │ │ │ │ │ -00020990: 7374 206f 6e65 2069 6620 6e6f 7420 7365 st one if not se │ │ │ │ │ -000209a0: 7429 2c20 7768 6963 6820 6973 2061 626f t), which is abo │ │ │ │ │ -000209b0: 7274 6564 2062 790a 7072 6573 7369 6e67 rted by.pressing │ │ │ │ │ -000209c0: 2061 6e79 206b 6579 2e0a 0a20 2020 436f any key... Co │ │ │ │ │ -000209d0: 6d6d 616e 6473 2061 7265 2061 7661 696c mmands are avail │ │ │ │ │ -000209e0: 6162 6c65 2074 6f20 656e 7465 7220 6120 able to enter a │ │ │ │ │ -000209f0: 6261 7265 2063 6f6d 6d61 6e64 2d6c 696e bare command-lin │ │ │ │ │ -00020a00: 6520 6279 2070 7265 7373 696e 6720 3c63 e by pressing .(which operate │ │ │ │ │ -00020a20: 7320 6578 6163 746c 7920 6c69 6b65 2074 s exactly like t │ │ │ │ │ -00020a30: 6865 206e 6f6e 2d63 6f6e 6669 672d 6669 he non-config-fi │ │ │ │ │ -00020a40: 6c65 2076 6572 7369 6f6e 206f 6620 4752 le version of GR │ │ │ │ │ -00020a50: 5542 2c20 6275 740a 616c 6c6f 7773 206f UB, but.allows o │ │ │ │ │ -00020a60: 6e65 2074 6f20 7265 7475 726e 2074 6f20 ne to return to │ │ │ │ │ -00020a70: 7468 6520 6d65 6e75 2069 6620 6465 7369 the menu if desi │ │ │ │ │ -00020a80: 7265 6420 6279 2070 7265 7373 696e 6720 red by pressing │ │ │ │ │ -00020a90: 3c45 5343 3e29 206f 7220 746f 0a65 6469 ) or to.edi │ │ │ │ │ -00020aa0: 7420 616e 7920 6f66 2074 6865 2022 626f t any of the "bo │ │ │ │ │ -00020ab0: 6f74 2065 6e74 7269 6573 2220 6279 2070 ot entries" by p │ │ │ │ │ -00020ac0: 7265 7373 696e 6720 3c65 3e2e 0a0a 2020 ressing ... │ │ │ │ │ -00020ad0: 2049 6620 796f 7520 7072 6f74 6563 7420 If you protect │ │ │ │ │ -00020ae0: 7468 6520 6d65 6e75 2069 6e74 6572 6661 the menu interfa │ │ │ │ │ -00020af0: 6365 2077 6974 6820 6120 7061 7373 776f ce with a passwo │ │ │ │ │ -00020b00: 7264 2028 2a6e 6f74 6520 5365 6375 7269 rd (*note Securi │ │ │ │ │ -00020b10: 7479 3a3a 292c 0a61 6c6c 2079 6f75 2063 ty::),.all you c │ │ │ │ │ -00020b20: 616e 2064 6f20 6973 2063 686f 6f73 6520 an do is choose │ │ │ │ │ -00020b30: 616e 2065 6e74 7279 2062 7920 7072 6573 an entry by pres │ │ │ │ │ -00020b40: 7369 6e67 203c 5245 543e 2c20 6f72 2070 sing , or p │ │ │ │ │ -00020b50: 7265 7373 203c 703e 2074 6f0a 656e 7465 ress

to.ente │ │ │ │ │ -00020b60: 7220 7468 6520 7061 7373 776f 7264 2e0a r the password.. │ │ │ │ │ -00020b70: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00020b80: 666f 2c20 204e 6f64 653a 204d 656e 7520 fo, Node: Menu │ │ │ │ │ -00020b90: 656e 7472 7920 6564 6974 6f72 2c20 2050 entry editor, P │ │ │ │ │ -00020ba0: 7265 763a 204d 656e 7520 696e 7465 7266 rev: Menu interf │ │ │ │ │ -00020bb0: 6163 652c 2020 5570 3a20 496e 7465 7266 ace, Up: Interf │ │ │ │ │ -00020bc0: 6163 650a 0a31 342e 3320 4564 6974 696e ace..14.3 Editin │ │ │ │ │ -00020bd0: 6720 6120 6d65 6e75 2065 6e74 7279 0a3d g a menu entry.= │ │ │ │ │ -00020be0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00020bf0: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 6d65 ========..The me │ │ │ │ │ -00020c00: 6e75 2065 6e74 7279 2065 6469 746f 7220 nu entry editor │ │ │ │ │ -00020c10: 6c6f 6f6b 7320 6d75 6368 206c 696b 6520 looks much like │ │ │ │ │ -00020c20: 7468 6520 6d61 696e 206d 656e 7520 696e the main menu in │ │ │ │ │ -00020c30: 7465 7266 6163 652c 2062 7574 2074 6865 terface, but the │ │ │ │ │ -00020c40: 0a6c 696e 6573 2069 6e20 7468 6520 6d65 .lines in the me │ │ │ │ │ -00020c50: 6e75 2061 7265 2069 6e64 6976 6964 7561 nu are individua │ │ │ │ │ -00020c60: 6c20 636f 6d6d 616e 6473 2069 6e20 7468 l commands in th │ │ │ │ │ -00020c70: 6520 7365 6c65 6374 6564 2065 6e74 7279 e selected entry │ │ │ │ │ -00020c80: 2069 6e73 7465 6164 0a6f 6620 656e 7472 instead.of entr │ │ │ │ │ -00020c90: 7920 6e61 6d65 732e 0a0a 2020 2049 6620 y names... If │ │ │ │ │ -00020ca0: 616e 203c 4553 433e 2069 7320 7072 6573 an is pres │ │ │ │ │ -00020cb0: 7365 6420 696e 2074 6865 2065 6469 746f sed in the edito │ │ │ │ │ -00020cc0: 722c 2069 7420 6162 6f72 7473 2061 6c6c r, it aborts all │ │ │ │ │ -00020cd0: 2074 6865 2063 6861 6e67 6573 206d 6164 the changes mad │ │ │ │ │ -00020ce0: 650a 746f 2074 6865 2063 6f6e 6669 6775 e.to the configu │ │ │ │ │ -00020cf0: 7261 7469 6f6e 2065 6e74 7279 2061 6e64 ration entry and │ │ │ │ │ -00020d00: 2072 6574 7572 6e73 2074 6f20 7468 6520 returns to the │ │ │ │ │ -00020d10: 6d61 696e 206d 656e 7520 696e 7465 7266 main menu interf │ │ │ │ │ -00020d20: 6163 652e 0a0a 2020 2045 6163 6820 6c69 ace... Each li │ │ │ │ │ -00020d30: 6e65 2069 6e20 7468 6520 6d65 6e75 2065 ne in the menu e │ │ │ │ │ -00020d40: 6e74 7279 2063 616e 2062 6520 6564 6974 ntry can be edit │ │ │ │ │ -00020d50: 6564 2066 7265 656c 792c 2061 6e64 2079 ed freely, and y │ │ │ │ │ -00020d60: 6f75 2063 616e 2061 6464 206e 6577 0a6c ou can add new.l │ │ │ │ │ -00020d70: 696e 6573 2062 7920 7072 6573 7369 6e67 ines by pressing │ │ │ │ │ -00020d80: 203c 5245 543e 2061 7420 7468 6520 656e at the en │ │ │ │ │ -00020d90: 6420 6f66 2061 206c 696e 652e 2020 546f d of a line. To │ │ │ │ │ -00020da0: 2062 6f6f 7420 7468 6520 6564 6974 6564 boot the edited │ │ │ │ │ -00020db0: 2065 6e74 7279 2c0a 7072 6573 7320 3c43 entry,.press ... Alth │ │ │ │ │ -00020dd0: 6f75 6768 2047 5255 4220 756e 666f 7274 ough GRUB unfort │ │ │ │ │ -00020de0: 756e 6174 656c 7920 646f 6573 206e 6f74 unately does not │ │ │ │ │ -00020df0: 2073 7570 706f 7274 2022 756e 646f 222c support "undo", │ │ │ │ │ -00020e00: 2079 6f75 2063 616e 2064 6f0a 616c 6d6f you can do.almo │ │ │ │ │ -00020e10: 7374 2074 6865 2073 616d 6520 7468 696e st the same thin │ │ │ │ │ -00020e20: 6720 6279 206a 7573 7420 7265 7475 726e g by just return │ │ │ │ │ -00020e30: 696e 6720 746f 2074 6865 206d 6169 6e20 ing to the main │ │ │ │ │ -00020e40: 6d65 6e75 2075 7369 6e67 203c 4553 433e menu using │ │ │ │ │ -00020e50: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00020e60: 696e 666f 2c20 204e 6f64 653a 2045 6e76 info, Node: Env │ │ │ │ │ -00020e70: 6972 6f6e 6d65 6e74 2c20 204e 6578 743a ironment, Next: │ │ │ │ │ -00020e80: 2043 6f6d 6d61 6e64 732c 2020 5072 6576 Commands, Prev │ │ │ │ │ -00020e90: 3a20 496e 7465 7266 6163 652c 2020 5570 : Interface, Up │ │ │ │ │ -00020ea0: 3a20 546f 700a 0a31 3520 4752 5542 2065 : Top..15 GRUB e │ │ │ │ │ -00020eb0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -00020ec0: 626c 6573 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a bles.*********** │ │ │ │ │ +0001ffd0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 2063 =========..The c │ │ │ │ │ +0001ffe0: 6f6d 6d61 6e64 2d6c 696e 6520 696e 7465 ommand-line inte │ │ │ │ │ +0001fff0: 7266 6163 6520 7072 6f76 6964 6573 2061 rface provides a │ │ │ │ │ +00020000: 2070 726f 6d70 7420 616e 6420 6166 7465 prompt and afte │ │ │ │ │ +00020010: 7220 6974 2061 6e20 6564 6974 6162 6c65 r it an editable │ │ │ │ │ +00020020: 0a74 6578 7420 6172 6561 206d 7563 6820 .text area much │ │ │ │ │ +00020030: 6c69 6b65 2061 2063 6f6d 6d61 6e64 2d6c like a command-l │ │ │ │ │ +00020040: 696e 6520 696e 2055 6e69 7820 6f72 2044 ine in Unix or D │ │ │ │ │ +00020050: 4f53 2e20 4561 6368 2063 6f6d 6d61 6e64 OS. Each command │ │ │ │ │ +00020060: 2069 730a 696d 6d65 6469 6174 656c 7920 is.immediately │ │ │ │ │ +00020070: 6578 6563 7574 6564 2061 6674 6572 2069 executed after i │ │ │ │ │ +00020080: 7420 6973 2065 6e74 6572 6564 2831 2920 t is entered(1) │ │ │ │ │ +00020090: 282a 6e6f 7465 2043 6f6d 6d61 6e64 2d6c (*note Command-l │ │ │ │ │ +000200a0: 696e 650a 696e 7465 7266 6163 652d 466f ine.interface-Fo │ │ │ │ │ +000200b0: 6f74 6e6f 7465 2d31 3a3a 292e 2020 5468 otnote-1::). Th │ │ │ │ │ +000200c0: 6520 636f 6d6d 616e 6473 2028 2a6e 6f74 e commands (*not │ │ │ │ │ +000200d0: 6520 436f 6d6d 616e 642d 6c69 6e65 2061 e Command-line a │ │ │ │ │ +000200e0: 6e64 206d 656e 750a 656e 7472 7920 636f nd menu.entry co │ │ │ │ │ +000200f0: 6d6d 616e 6473 3a3a 2920 6172 6520 6120 mmands::) are a │ │ │ │ │ +00020100: 7375 6273 6574 206f 6620 7468 6f73 6520 subset of those │ │ │ │ │ +00020110: 6176 6169 6c61 626c 6520 696e 2074 6865 available in the │ │ │ │ │ +00020120: 2063 6f6e 6669 6775 7261 7469 6f6e 0a66 configuration.f │ │ │ │ │ +00020130: 696c 652c 2075 7365 6420 7769 7468 2065 ile, used with e │ │ │ │ │ +00020140: 7861 6374 6c79 2074 6865 2073 616d 6520 xactly the same │ │ │ │ │ +00020150: 7379 6e74 6178 2e0a 0a20 2020 4375 7273 syntax... Curs │ │ │ │ │ +00020160: 6f72 206d 6f76 656d 656e 7420 616e 6420 or movement and │ │ │ │ │ +00020170: 6564 6974 696e 6720 6f66 2074 6865 2074 editing of the t │ │ │ │ │ +00020180: 6578 7420 6f6e 2074 6865 206c 696e 6520 ext on the line │ │ │ │ │ +00020190: 6361 6e20 6265 2064 6f6e 6520 7669 6120 can be done via │ │ │ │ │ +000201a0: 610a 7375 6273 6574 206f 6620 7468 6520 a.subset of the │ │ │ │ │ +000201b0: 6675 6e63 7469 6f6e 7320 6176 6169 6c61 functions availa │ │ │ │ │ +000201c0: 626c 6520 696e 2074 6865 2042 6173 6820 ble in the Bash │ │ │ │ │ +000201d0: 7368 656c 6c3a 0a0a 3c43 2d66 3e0a 3c50 shell:...

. │ │ │ │ │ +000201f0: 2020 4d6f 7665 2066 6f72 7761 7264 206f Move forward o │ │ │ │ │ +00020200: 6e65 2063 6861 7261 6374 6572 2e0a 0a3c ne character...< │ │ │ │ │ +00020210: 432d 623e 0a3c 5043 206c 6566 7420 6b65 C-b>.. Move bac │ │ │ │ │ +00020230: 6b20 6f6e 6520 6368 6172 6163 7465 722e k one character. │ │ │ │ │ +00020240: 0a0a 3c43 2d61 3e0a 3c48 4f4d 453e 0a20 .... │ │ │ │ │ +00020250: 2020 2020 4d6f 7665 2074 6f20 7468 6520 Move to the │ │ │ │ │ +00020260: 7374 6172 7420 6f66 2074 6865 206c 696e start of the lin │ │ │ │ │ +00020270: 652e 0a0a 3c43 2d65 3e0a 3c45 4e44 3e0a e..... │ │ │ │ │ +00020280: 2020 2020 204d 6f76 6520 7468 6520 7468 Move the th │ │ │ │ │ +00020290: 6520 656e 6420 6f66 2074 6865 206c 696e e end of the lin │ │ │ │ │ +000202a0: 652e 0a0a 3c43 2d64 3e0a 3c44 454c 3e0a e..... │ │ │ │ │ +000202b0: 2020 2020 2044 656c 6574 6520 7468 6520 Delete the │ │ │ │ │ +000202c0: 6368 6172 6163 7465 7220 756e 6465 726e character undern │ │ │ │ │ +000202d0: 6561 7468 2074 6865 2063 7572 736f 722e eath the cursor. │ │ │ │ │ +000202e0: 0a0a 3c43 2d68 3e0a 3c42 533e 0a20 2020 .... │ │ │ │ │ +000202f0: 2020 4465 6c65 7465 2074 6865 2063 6861 Delete the cha │ │ │ │ │ +00020300: 7261 6374 6572 2074 6f20 7468 6520 6c65 racter to the le │ │ │ │ │ +00020310: 6674 206f 6620 7468 6520 6375 7273 6f72 ft of the cursor │ │ │ │ │ +00020320: 2e0a 0a3c 432d 6b3e 0a20 2020 2020 4b69 .... Ki │ │ │ │ │ +00020330: 6c6c 2074 6865 2074 6578 7420 6672 6f6d ll the text from │ │ │ │ │ +00020340: 2074 6865 2063 7572 7265 6e74 2063 7572 the current cur │ │ │ │ │ +00020350: 736f 7220 706f 7369 7469 6f6e 2074 6f20 sor position to │ │ │ │ │ +00020360: 7468 6520 656e 6420 6f66 2074 6865 0a20 the end of the. │ │ │ │ │ +00020370: 2020 2020 6c69 6e65 2e0a 0a3c 432d 753e line... │ │ │ │ │ +00020380: 0a20 2020 2020 4b69 6c6c 2062 6163 6b77 . Kill backw │ │ │ │ │ +00020390: 6172 6420 6672 6f6d 2074 6865 2063 7572 ard from the cur │ │ │ │ │ +000203a0: 736f 7220 746f 2074 6865 2062 6567 696e sor to the begin │ │ │ │ │ +000203b0: 6e69 6e67 206f 6620 7468 6520 6c69 6e65 ning of the line │ │ │ │ │ +000203c0: 2e0a 0a3c 432d 793e 0a20 2020 2020 5961 .... Ya │ │ │ │ │ +000203d0: 6e6b 2074 6865 206b 696c 6c65 6420 7465 nk the killed te │ │ │ │ │ +000203e0: 7874 2062 6163 6b20 696e 746f 2074 6865 xt back into the │ │ │ │ │ +000203f0: 2062 7566 6665 7220 6174 2074 6865 2063 buffer at the c │ │ │ │ │ +00020400: 7572 736f 722e 0a0a 3c43 2d70 3e0a 3c50 ursor....

. M │ │ │ │ │ +00020420: 6f76 6520 7570 2074 6872 6f75 6768 2074 ove up through t │ │ │ │ │ +00020430: 6865 2068 6973 746f 7279 206c 6973 742e he history list. │ │ │ │ │ +00020440: 0a0a 3c43 2d6e 3e0a 3c50 4320 646f 776e .... Move │ │ │ │ │ +00020460: 646f 776e 2074 6872 6f75 6768 2074 6865 down through the │ │ │ │ │ +00020470: 2068 6973 746f 7279 206c 6973 742e 0a0a history list... │ │ │ │ │ +00020480: 2020 2057 6865 6e20 7479 7069 6e67 2063 When typing c │ │ │ │ │ +00020490: 6f6d 6d61 6e64 7320 696e 7465 7261 6374 ommands interact │ │ │ │ │ +000204a0: 6976 656c 792c 2069 6620 7468 6520 6375 ively, if the cu │ │ │ │ │ +000204b0: 7273 6f72 2069 7320 7769 7468 696e 206f rsor is within o │ │ │ │ │ +000204c0: 7220 6265 666f 7265 0a74 6865 2066 6972 r before.the fir │ │ │ │ │ +000204d0: 7374 2077 6f72 6420 696e 2074 6865 2063 st word in the c │ │ │ │ │ +000204e0: 6f6d 6d61 6e64 2d6c 696e 652c 2070 7265 ommand-line, pre │ │ │ │ │ +000204f0: 7373 696e 6720 7468 6520 3c54 4142 3e20 ssing the │ │ │ │ │ +00020500: 6b65 7920 286f 7220 3c43 2d69 3e29 0a77 key (or ).w │ │ │ │ │ +00020510: 696c 6c20 6469 7370 6c61 7920 6120 6c69 ill display a li │ │ │ │ │ +00020520: 7374 696e 6720 6f66 2074 6865 2061 7661 sting of the ava │ │ │ │ │ +00020530: 696c 6162 6c65 2063 6f6d 6d61 6e64 732c ilable commands, │ │ │ │ │ +00020540: 2061 6e64 2069 6620 7468 6520 6375 7273 and if the curs │ │ │ │ │ +00020550: 6f72 2069 730a 6166 7465 7220 7468 6520 or is.after the │ │ │ │ │ +00020560: 6669 7273 7420 776f 7264 2c20 7468 6520 first word, the │ │ │ │ │ +00020570: 273c 5441 423e 2720 7769 6c6c 2070 726f '' will pro │ │ │ │ │ +00020580: 7669 6465 2061 2063 6f6d 706c 6574 696f vide a completio │ │ │ │ │ +00020590: 6e20 6c69 7374 696e 6720 6f66 0a64 6973 n listing of.dis │ │ │ │ │ +000205a0: 6b73 2c20 7061 7274 6974 696f 6e73 2c20 ks, partitions, │ │ │ │ │ +000205b0: 616e 6420 6669 6c65 206e 616d 6573 2064 and file names d │ │ │ │ │ +000205c0: 6570 656e 6469 6e67 206f 6e20 7468 6520 epending on the │ │ │ │ │ +000205d0: 636f 6e74 6578 742e 2020 4e6f 7465 2074 context. Note t │ │ │ │ │ +000205e0: 6861 740a 746f 206f 6274 6169 6e20 6120 hat.to obtain a │ │ │ │ │ +000205f0: 6c69 7374 206f 6620 6472 6976 6573 2c20 list of drives, │ │ │ │ │ +00020600: 6f6e 6520 6d75 7374 206f 7065 6e20 6120 one must open a │ │ │ │ │ +00020610: 7061 7265 6e74 6865 7369 732c 2061 7320 parenthesis, as │ │ │ │ │ +00020620: 2772 6f6f 7420 2827 2e0a 0a20 2020 4e6f 'root ('... No │ │ │ │ │ +00020630: 7465 2074 6861 7420 796f 7520 6361 6e6e te that you cann │ │ │ │ │ +00020640: 6f74 2075 7365 2074 6865 2063 6f6d 706c ot use the compl │ │ │ │ │ +00020650: 6574 696f 6e20 6675 6e63 7469 6f6e 616c etion functional │ │ │ │ │ +00020660: 6974 7920 696e 2074 6865 2054 4654 500a ity in the TFTP. │ │ │ │ │ +00020670: 6669 6c65 7379 7374 656d 2e20 2054 6869 filesystem. Thi │ │ │ │ │ +00020680: 7320 6973 2062 6563 6175 7365 2054 4654 s is because TFT │ │ │ │ │ +00020690: 5020 646f 6573 6e27 7420 7375 7070 6f72 P doesn't suppor │ │ │ │ │ +000206a0: 7420 6669 6c65 206e 616d 6520 6c69 7374 t file name list │ │ │ │ │ +000206b0: 696e 6720 666f 720a 7468 6520 7365 6375 ing for.the secu │ │ │ │ │ +000206c0: 7269 7479 2e0a 0a1f 0a46 696c 653a 2067 rity.....File: g │ │ │ │ │ +000206d0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +000206e0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 696e Command-line in │ │ │ │ │ +000206f0: 7465 7266 6163 652d 466f 6f74 6e6f 7465 terface-Footnote │ │ │ │ │ +00020700: 732c 2020 5570 3a20 436f 6d6d 616e 642d s, Up: Command- │ │ │ │ │ +00020710: 6c69 6e65 2069 6e74 6572 6661 6365 0a0a line interface.. │ │ │ │ │ +00020720: 2020 2028 3129 2048 6f77 6576 6572 2c20 (1) However, │ │ │ │ │ +00020730: 7468 6973 2062 6568 6176 696f 7220 7769 this behavior wi │ │ │ │ │ +00020740: 6c6c 2062 6520 6368 616e 6765 6420 696e ll be changed in │ │ │ │ │ +00020750: 2074 6865 2066 7574 7572 6520 7665 7273 the future vers │ │ │ │ │ +00020760: 696f 6e2c 2069 6e0a 6120 7573 6572 2d69 ion, in.a user-i │ │ │ │ │ +00020770: 6e76 6973 6962 6c65 2077 6179 2e0a 0a1f nvisible way.... │ │ │ │ │ +00020780: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +00020790: 2c20 204e 6f64 653a 204d 656e 7520 696e , Node: Menu in │ │ │ │ │ +000207a0: 7465 7266 6163 652c 2020 4e65 7874 3a20 terface, Next: │ │ │ │ │ +000207b0: 4d65 6e75 2065 6e74 7279 2065 6469 746f Menu entry edito │ │ │ │ │ +000207c0: 722c 2020 5072 6576 3a20 436f 6d6d 616e r, Prev: Comman │ │ │ │ │ +000207d0: 642d 6c69 6e65 2069 6e74 6572 6661 6365 d-line interface │ │ │ │ │ +000207e0: 2c20 2055 703a 2049 6e74 6572 6661 6365 , Up: Interface │ │ │ │ │ +000207f0: 0a0a 3134 2e32 2054 6865 2073 696d 706c ..14.2 The simpl │ │ │ │ │ +00020800: 6520 6d65 6e75 2069 6e74 6572 6661 6365 e menu interface │ │ │ │ │ +00020810: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ +00020820: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00020830: 0a54 6865 206d 656e 7520 696e 7465 7266 .The menu interf │ │ │ │ │ +00020840: 6163 6520 6973 2071 7569 7465 2065 6173 ace is quite eas │ │ │ │ │ +00020850: 7920 746f 2075 7365 2e20 2049 7473 2063 y to use. Its c │ │ │ │ │ +00020860: 6f6d 6d61 6e64 7320 6172 6520 626f 7468 ommands are both │ │ │ │ │ +00020870: 0a72 6561 736f 6e61 626c 7920 696e 7475 .reasonably intu │ │ │ │ │ +00020880: 6974 6976 6520 616e 6420 6465 7363 7269 itive and descri │ │ │ │ │ +00020890: 6265 6420 6f6e 2073 6372 6565 6e2e 0a0a bed on screen... │ │ │ │ │ +000208a0: 2020 2042 6173 6963 616c 6c79 2c20 7468 Basically, th │ │ │ │ │ +000208b0: 6520 6d65 6e75 2069 6e74 6572 6661 6365 e menu interface │ │ │ │ │ +000208c0: 2070 726f 7669 6465 7320 6120 6c69 7374 provides a list │ │ │ │ │ +000208d0: 206f 6620 2262 6f6f 7420 656e 7472 6965 of "boot entrie │ │ │ │ │ +000208e0: 7322 2074 6f0a 7468 6520 7573 6572 2074 s" to.the user t │ │ │ │ │ +000208f0: 6f20 6368 6f6f 7365 2066 726f 6d2e 2020 o choose from. │ │ │ │ │ +00020900: 5573 6520 7468 6520 6172 726f 7720 6b65 Use the arrow ke │ │ │ │ │ +00020910: 7973 2074 6f20 7365 6c65 6374 2074 6865 ys to select the │ │ │ │ │ +00020920: 2065 6e74 7279 206f 660a 6368 6f69 6365 entry of.choice │ │ │ │ │ +00020930: 2c20 7468 656e 2070 7265 7373 203c 5245 , then press to run it. A │ │ │ │ │ +00020950: 6e20 6f70 7469 6f6e 616c 2074 696d 656f n optional timeo │ │ │ │ │ +00020960: 7574 2069 7320 6176 6169 6c61 626c 6520 ut is available │ │ │ │ │ +00020970: 746f 0a62 6f6f 7420 7468 6520 6465 6661 to.boot the defa │ │ │ │ │ +00020980: 756c 7420 656e 7472 7920 2874 6865 2066 ult entry (the f │ │ │ │ │ +00020990: 6972 7374 206f 6e65 2069 6620 6e6f 7420 irst one if not │ │ │ │ │ +000209a0: 7365 7429 2c20 7768 6963 6820 6973 2061 set), which is a │ │ │ │ │ +000209b0: 626f 7274 6564 2062 790a 7072 6573 7369 borted by.pressi │ │ │ │ │ +000209c0: 6e67 2061 6e79 206b 6579 2e0a 0a20 2020 ng any key... │ │ │ │ │ +000209d0: 436f 6d6d 616e 6473 2061 7265 2061 7661 Commands are ava │ │ │ │ │ +000209e0: 696c 6162 6c65 2074 6f20 656e 7465 7220 ilable to enter │ │ │ │ │ +000209f0: 6120 6261 7265 2063 6f6d 6d61 6e64 2d6c a bare command-l │ │ │ │ │ +00020a00: 696e 6520 6279 2070 7265 7373 696e 6720 ine by pressing │ │ │ │ │ +00020a10: 3c63 3e0a 2877 6869 6368 206f 7065 7261 .(which opera │ │ │ │ │ +00020a20: 7465 7320 6578 6163 746c 7920 6c69 6b65 tes exactly like │ │ │ │ │ +00020a30: 2074 6865 206e 6f6e 2d63 6f6e 6669 672d the non-config- │ │ │ │ │ +00020a40: 6669 6c65 2076 6572 7369 6f6e 206f 6620 file version of │ │ │ │ │ +00020a50: 4752 5542 2c20 6275 740a 616c 6c6f 7773 GRUB, but.allows │ │ │ │ │ +00020a60: 206f 6e65 2074 6f20 7265 7475 726e 2074 one to return t │ │ │ │ │ +00020a70: 6f20 7468 6520 6d65 6e75 2069 6620 6465 o the menu if de │ │ │ │ │ +00020a80: 7369 7265 6420 6279 2070 7265 7373 696e sired by pressin │ │ │ │ │ +00020a90: 6720 3c45 5343 3e29 206f 7220 746f 0a65 g ) or to.e │ │ │ │ │ +00020aa0: 6469 7420 616e 7920 6f66 2074 6865 2022 dit any of the " │ │ │ │ │ +00020ab0: 626f 6f74 2065 6e74 7269 6573 2220 6279 boot entries" by │ │ │ │ │ +00020ac0: 2070 7265 7373 696e 6720 3c65 3e2e 0a0a pressing ... │ │ │ │ │ +00020ad0: 2020 2049 6620 796f 7520 7072 6f74 6563 If you protec │ │ │ │ │ +00020ae0: 7420 7468 6520 6d65 6e75 2069 6e74 6572 t the menu inter │ │ │ │ │ +00020af0: 6661 6365 2077 6974 6820 6120 7061 7373 face with a pass │ │ │ │ │ +00020b00: 776f 7264 2028 2a6e 6f74 6520 5365 6375 word (*note Secu │ │ │ │ │ +00020b10: 7269 7479 3a3a 292c 0a61 6c6c 2079 6f75 rity::),.all you │ │ │ │ │ +00020b20: 2063 616e 2064 6f20 6973 2063 686f 6f73 can do is choos │ │ │ │ │ +00020b30: 6520 616e 2065 6e74 7279 2062 7920 7072 e an entry by pr │ │ │ │ │ +00020b40: 6573 7369 6e67 203c 5245 543e 2c20 6f72 essing , or │ │ │ │ │ +00020b50: 2070 7265 7373 203c 703e 2074 6f0a 656e press

to.en │ │ │ │ │ +00020b60: 7465 7220 7468 6520 7061 7373 776f 7264 ter the password │ │ │ │ │ +00020b70: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00020b80: 696e 666f 2c20 204e 6f64 653a 204d 656e info, Node: Men │ │ │ │ │ +00020b90: 7520 656e 7472 7920 6564 6974 6f72 2c20 u entry editor, │ │ │ │ │ +00020ba0: 2050 7265 763a 204d 656e 7520 696e 7465 Prev: Menu inte │ │ │ │ │ +00020bb0: 7266 6163 652c 2020 5570 3a20 496e 7465 rface, Up: Inte │ │ │ │ │ +00020bc0: 7266 6163 650a 0a31 342e 3320 4564 6974 rface..14.3 Edit │ │ │ │ │ +00020bd0: 696e 6720 6120 6d65 6e75 2065 6e74 7279 ing a menu entry │ │ │ │ │ +00020be0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ +00020bf0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ │ +00020c00: 6d65 6e75 2065 6e74 7279 2065 6469 746f menu entry edito │ │ │ │ │ +00020c10: 7220 6c6f 6f6b 7320 6d75 6368 206c 696b r looks much lik │ │ │ │ │ +00020c20: 6520 7468 6520 6d61 696e 206d 656e 7520 e the main menu │ │ │ │ │ +00020c30: 696e 7465 7266 6163 652c 2062 7574 2074 interface, but t │ │ │ │ │ +00020c40: 6865 0a6c 696e 6573 2069 6e20 7468 6520 he.lines in the │ │ │ │ │ +00020c50: 6d65 6e75 2061 7265 2069 6e64 6976 6964 menu are individ │ │ │ │ │ +00020c60: 7561 6c20 636f 6d6d 616e 6473 2069 6e20 ual commands in │ │ │ │ │ +00020c70: 7468 6520 7365 6c65 6374 6564 2065 6e74 the selected ent │ │ │ │ │ +00020c80: 7279 2069 6e73 7465 6164 0a6f 6620 656e ry instead.of en │ │ │ │ │ +00020c90: 7472 7920 6e61 6d65 732e 0a0a 2020 2049 try names... I │ │ │ │ │ +00020ca0: 6620 616e 203c 4553 433e 2069 7320 7072 f an is pr │ │ │ │ │ +00020cb0: 6573 7365 6420 696e 2074 6865 2065 6469 essed in the edi │ │ │ │ │ +00020cc0: 746f 722c 2069 7420 6162 6f72 7473 2061 tor, it aborts a │ │ │ │ │ +00020cd0: 6c6c 2074 6865 2063 6861 6e67 6573 206d ll the changes m │ │ │ │ │ +00020ce0: 6164 650a 746f 2074 6865 2063 6f6e 6669 ade.to the confi │ │ │ │ │ +00020cf0: 6775 7261 7469 6f6e 2065 6e74 7279 2061 guration entry a │ │ │ │ │ +00020d00: 6e64 2072 6574 7572 6e73 2074 6f20 7468 nd returns to th │ │ │ │ │ +00020d10: 6520 6d61 696e 206d 656e 7520 696e 7465 e main menu inte │ │ │ │ │ +00020d20: 7266 6163 652e 0a0a 2020 2045 6163 6820 rface... Each │ │ │ │ │ +00020d30: 6c69 6e65 2069 6e20 7468 6520 6d65 6e75 line in the menu │ │ │ │ │ +00020d40: 2065 6e74 7279 2063 616e 2062 6520 6564 entry can be ed │ │ │ │ │ +00020d50: 6974 6564 2066 7265 656c 792c 2061 6e64 ited freely, and │ │ │ │ │ +00020d60: 2079 6f75 2063 616e 2061 6464 206e 6577 you can add new │ │ │ │ │ +00020d70: 0a6c 696e 6573 2062 7920 7072 6573 7369 .lines by pressi │ │ │ │ │ +00020d80: 6e67 203c 5245 543e 2061 7420 7468 6520 ng at the │ │ │ │ │ +00020d90: 656e 6420 6f66 2061 206c 696e 652e 2020 end of a line. │ │ │ │ │ +00020da0: 546f 2062 6f6f 7420 7468 6520 6564 6974 To boot the edit │ │ │ │ │ +00020db0: 6564 2065 6e74 7279 2c0a 7072 6573 7320 ed entry,.press │ │ │ │ │ +00020dc0: 3c43 7472 6c2d 783e 2e0a 0a20 2020 416c ... Al │ │ │ │ │ +00020dd0: 7468 6f75 6768 2047 5255 4220 756e 666f though GRUB unfo │ │ │ │ │ +00020de0: 7274 756e 6174 656c 7920 646f 6573 206e rtunately does n │ │ │ │ │ +00020df0: 6f74 2073 7570 706f 7274 2022 756e 646f ot support "undo │ │ │ │ │ +00020e00: 222c 2079 6f75 2063 616e 2064 6f0a 616c ", you can do.al │ │ │ │ │ +00020e10: 6d6f 7374 2074 6865 2073 616d 6520 7468 most the same th │ │ │ │ │ +00020e20: 696e 6720 6279 206a 7573 7420 7265 7475 ing by just retu │ │ │ │ │ +00020e30: 726e 696e 6720 746f 2074 6865 206d 6169 rning to the mai │ │ │ │ │ +00020e40: 6e20 6d65 6e75 2075 7369 6e67 203c 4553 n menu using .....File: gru │ │ │ │ │ +00020e60: 622e 696e 666f 2c20 204e 6f64 653a 2045 b.info, Node: E │ │ │ │ │ +00020e70: 6e76 6972 6f6e 6d65 6e74 2c20 204e 6578 nvironment, Nex │ │ │ │ │ +00020e80: 743a 2043 6f6d 6d61 6e64 732c 2020 5072 t: Commands, Pr │ │ │ │ │ +00020e90: 6576 3a20 496e 7465 7266 6163 652c 2020 ev: Interface, │ │ │ │ │ +00020ea0: 5570 3a20 546f 700a 0a31 3520 4752 5542 Up: Top..15 GRUB │ │ │ │ │ +00020eb0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +00020ec0: 6961 626c 6573 0a2a 2a2a 2a2a 2a2a 2a2a iables.********* │ │ │ │ │ 00020ed0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00020ee0: 2a2a 0a0a 4752 5542 2073 7570 706f 7274 **..GRUB support │ │ │ │ │ -00020ef0: 7320 656e 7669 726f 6e6d 656e 7420 7661 s environment va │ │ │ │ │ -00020f00: 7269 6162 6c65 7320 7768 6963 6820 6172 riables which ar │ │ │ │ │ -00020f10: 6520 7261 7468 6572 206c 696b 6520 7468 e rather like th │ │ │ │ │ -00020f20: 6f73 6520 6f66 6665 7265 640a 6279 2061 ose offered.by a │ │ │ │ │ -00020f30: 6c6c 2055 6e69 782d 6c69 6b65 2073 7973 ll Unix-like sys │ │ │ │ │ -00020f40: 7465 6d73 2e20 2045 6e76 6972 6f6e 6d65 tems. Environme │ │ │ │ │ -00020f50: 6e74 2076 6172 6961 626c 6573 2068 6176 nt variables hav │ │ │ │ │ -00020f60: 6520 6120 6e61 6d65 2c20 7768 6963 6820 e a name, which │ │ │ │ │ -00020f70: 6973 0a75 6e69 7175 6520 616e 6420 6973 is.unique and is │ │ │ │ │ -00020f80: 2075 7375 616c 6c79 2061 2073 686f 7274 usually a short │ │ │ │ │ -00020f90: 2069 6465 6e74 6966 6965 722c 2061 6e64 identifier, and │ │ │ │ │ -00020fa0: 2061 2076 616c 7565 2c20 7768 6963 6820 a value, which │ │ │ │ │ -00020fb0: 6973 2061 6e0a 6172 6269 7472 6172 7920 is an.arbitrary │ │ │ │ │ -00020fc0: 7374 7269 6e67 206f 6620 6368 6172 6163 string of charac │ │ │ │ │ -00020fd0: 7465 7273 2e20 2054 6865 7920 6d61 7920 ters. They may │ │ │ │ │ -00020fe0: 6265 2073 6574 2028 2a6e 6f74 6520 7365 be set (*note se │ │ │ │ │ -00020ff0: 743a 3a29 2c20 756e 7365 740a 282a 6e6f t::), unset.(*no │ │ │ │ │ -00021000: 7465 2075 6e73 6574 3a3a 292c 206f 7220 te unset::), or │ │ │ │ │ -00021010: 6c6f 6f6b 6564 2075 7020 282a 6e6f 7465 looked up (*note │ │ │ │ │ -00021020: 2053 6865 6c6c 2d6c 696b 6520 7363 7269 Shell-like scri │ │ │ │ │ -00021030: 7074 696e 673a 3a29 2062 7920 6e61 6d65 pting::) by name │ │ │ │ │ -00021040: 2e0a 0a20 2020 4120 6e75 6d62 6572 206f ... A number o │ │ │ │ │ -00021050: 6620 656e 7669 726f 6e6d 656e 7420 7661 f environment va │ │ │ │ │ -00021060: 7269 6162 6c65 7320 6861 7665 2073 7065 riables have spe │ │ │ │ │ -00021070: 6369 616c 206d 6561 6e69 6e67 7320 746f cial meanings to │ │ │ │ │ -00021080: 2076 6172 696f 7573 0a70 6172 7473 206f various.parts o │ │ │ │ │ -00021090: 6620 4752 5542 2e20 4f74 6865 7273 206d f GRUB. Others m │ │ │ │ │ -000210a0: 6179 2062 6520 7573 6564 2066 7265 656c ay be used freel │ │ │ │ │ -000210b0: 7920 696e 2047 5255 4220 636f 6e66 6967 y in GRUB config │ │ │ │ │ -000210c0: 7572 6174 696f 6e20 6669 6c65 732e 0a0a uration files... │ │ │ │ │ -000210d0: 2a20 4d65 6e75 3a0a 0a2a 2053 7065 6369 * Menu:..* Speci │ │ │ │ │ -000210e0: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ │ -000210f0: 6172 6961 626c 6573 3a3a 0a2a 2045 6e76 ariables::.* Env │ │ │ │ │ -00021100: 6972 6f6e 6d65 6e74 2062 6c6f 636b 3a3a ironment block:: │ │ │ │ │ -00021110: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00021120: 6e66 6f2c 2020 4e6f 6465 3a20 5370 6563 nfo, Node: Spec │ │ │ │ │ -00021130: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ -00021140: 7661 7269 6162 6c65 732c 2020 4e65 7874 variables, Next │ │ │ │ │ -00021150: 3a20 456e 7669 726f 6e6d 656e 7420 626c : Environment bl │ │ │ │ │ -00021160: 6f63 6b2c 2020 5570 3a20 456e 7669 726f ock, Up: Enviro │ │ │ │ │ -00021170: 6e6d 656e 740a 0a31 352e 3120 5370 6563 nment..15.1 Spec │ │ │ │ │ -00021180: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ -00021190: 7661 7269 6162 6c65 730a 3d3d 3d3d 3d3d variables.====== │ │ │ │ │ +00020ee0: 2a2a 2a2a 0a0a 4752 5542 2073 7570 706f ****..GRUB suppo │ │ │ │ │ +00020ef0: 7274 7320 656e 7669 726f 6e6d 656e 7420 rts environment │ │ │ │ │ +00020f00: 7661 7269 6162 6c65 7320 7768 6963 6820 variables which │ │ │ │ │ +00020f10: 6172 6520 7261 7468 6572 206c 696b 6520 are rather like │ │ │ │ │ +00020f20: 7468 6f73 6520 6f66 6665 7265 640a 6279 those offered.by │ │ │ │ │ +00020f30: 2061 6c6c 2055 6e69 782d 6c69 6b65 2073 all Unix-like s │ │ │ │ │ +00020f40: 7973 7465 6d73 2e20 2045 6e76 6972 6f6e ystems. Environ │ │ │ │ │ +00020f50: 6d65 6e74 2076 6172 6961 626c 6573 2068 ment variables h │ │ │ │ │ +00020f60: 6176 6520 6120 6e61 6d65 2c20 7768 6963 ave a name, whic │ │ │ │ │ +00020f70: 6820 6973 0a75 6e69 7175 6520 616e 6420 h is.unique and │ │ │ │ │ +00020f80: 6973 2075 7375 616c 6c79 2061 2073 686f is usually a sho │ │ │ │ │ +00020f90: 7274 2069 6465 6e74 6966 6965 722c 2061 rt identifier, a │ │ │ │ │ +00020fa0: 6e64 2061 2076 616c 7565 2c20 7768 6963 nd a value, whic │ │ │ │ │ +00020fb0: 6820 6973 2061 6e0a 6172 6269 7472 6172 h is an.arbitrar │ │ │ │ │ +00020fc0: 7920 7374 7269 6e67 206f 6620 6368 6172 y string of char │ │ │ │ │ +00020fd0: 6163 7465 7273 2e20 2054 6865 7920 6d61 acters. They ma │ │ │ │ │ +00020fe0: 7920 6265 2073 6574 2028 2a6e 6f74 6520 y be set (*note │ │ │ │ │ +00020ff0: 7365 743a 3a29 2c20 756e 7365 740a 282a set::), unset.(* │ │ │ │ │ +00021000: 6e6f 7465 2075 6e73 6574 3a3a 292c 206f note unset::), o │ │ │ │ │ +00021010: 7220 6c6f 6f6b 6564 2075 7020 282a 6e6f r looked up (*no │ │ │ │ │ +00021020: 7465 2053 6865 6c6c 2d6c 696b 6520 7363 te Shell-like sc │ │ │ │ │ +00021030: 7269 7074 696e 673a 3a29 2062 7920 6e61 ripting::) by na │ │ │ │ │ +00021040: 6d65 2e0a 0a20 2020 4120 6e75 6d62 6572 me... A number │ │ │ │ │ +00021050: 206f 6620 656e 7669 726f 6e6d 656e 7420 of environment │ │ │ │ │ +00021060: 7661 7269 6162 6c65 7320 6861 7665 2073 variables have s │ │ │ │ │ +00021070: 7065 6369 616c 206d 6561 6e69 6e67 7320 pecial meanings │ │ │ │ │ +00021080: 746f 2076 6172 696f 7573 0a70 6172 7473 to various.parts │ │ │ │ │ +00021090: 206f 6620 4752 5542 2e20 4f74 6865 7273 of GRUB. Others │ │ │ │ │ +000210a0: 206d 6179 2062 6520 7573 6564 2066 7265 may be used fre │ │ │ │ │ +000210b0: 656c 7920 696e 2047 5255 4220 636f 6e66 ely in GRUB conf │ │ │ │ │ +000210c0: 6967 7572 6174 696f 6e20 6669 6c65 732e iguration files. │ │ │ │ │ +000210d0: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2053 7065 ..* Menu:..* Spe │ │ │ │ │ +000210e0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ +000210f0: 2076 6172 6961 626c 6573 3a3a 0a2a 2045 variables::.* E │ │ │ │ │ +00021100: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ │ +00021110: 3a3a 0a0a 1f0a 4669 6c65 3a20 6772 7562 ::....File: grub │ │ │ │ │ +00021120: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5370 .info, Node: Sp │ │ │ │ │ +00021130: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ +00021140: 7420 7661 7269 6162 6c65 732c 2020 4e65 t variables, Ne │ │ │ │ │ +00021150: 7874 3a20 456e 7669 726f 6e6d 656e 7420 xt: Environment │ │ │ │ │ +00021160: 626c 6f63 6b2c 2020 5570 3a20 456e 7669 block, Up: Envi │ │ │ │ │ +00021170: 726f 6e6d 656e 740a 0a31 352e 3120 5370 ronment..15.1 Sp │ │ │ │ │ +00021180: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ +00021190: 7420 7661 7269 6162 6c65 730a 3d3d 3d3d t variables.==== │ │ │ │ │ 000211a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000211b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ │ -000211c0: 6573 6520 7661 7269 6162 6c65 7320 6861 ese variables ha │ │ │ │ │ -000211d0: 7665 2073 7065 6369 616c 206d 6561 6e69 ve special meani │ │ │ │ │ -000211e0: 6e67 2074 6f20 4752 5542 2e0a 0a2a 204d ng to GRUB...* M │ │ │ │ │ -000211f0: 656e 753a 0a0a 2a20 6269 6f73 6e75 6d3a enu:..* biosnum: │ │ │ │ │ -00021200: 3a0a 2a20 6368 6563 6b5f 7369 676e 6174 :.* check_signat │ │ │ │ │ -00021210: 7572 6573 3a3a 0a2a 2063 686f 7365 6e3a ures::.* chosen: │ │ │ │ │ -00021220: 3a0a 2a20 636d 6470 6174 683a 3a0a 2a20 :.* cmdpath::.* │ │ │ │ │ -00021230: 636f 6c6f 725f 6869 6768 6c69 6768 743a color_highlight: │ │ │ │ │ -00021240: 3a0a 2a20 636f 6c6f 725f 6e6f 726d 616c :.* color_normal │ │ │ │ │ -00021250: 3a3a 0a2a 2063 6f6e 6669 675f 6469 7265 ::.* config_dire │ │ │ │ │ -00021260: 6374 6f72 793a 3a0a 2a20 636f 6e66 6967 ctory::.* config │ │ │ │ │ -00021270: 5f66 696c 653a 3a0a 2a20 6465 6275 673a _file::.* debug: │ │ │ │ │ -00021280: 3a0a 2a20 6465 6661 756c 743a 3a0a 2a20 :.* default::.* │ │ │ │ │ -00021290: 6661 6c6c 6261 636b 3a3a 0a2a 2067 6678 fallback::.* gfx │ │ │ │ │ -000212a0: 6d6f 6465 3a3a 0a2a 2067 6678 7061 796c mode::.* gfxpayl │ │ │ │ │ -000212b0: 6f61 643a 3a0a 2a20 6766 7874 6572 6d5f oad::.* gfxterm_ │ │ │ │ │ -000212c0: 666f 6e74 3a3a 0a2a 2067 7275 625f 6370 font::.* grub_cp │ │ │ │ │ -000212d0: 753a 3a0a 2a20 6772 7562 5f70 6c61 7466 u::.* grub_platf │ │ │ │ │ -000212e0: 6f72 6d3a 3a0a 2a20 6963 6f6e 6469 723a orm::.* icondir: │ │ │ │ │ -000212f0: 3a0a 2a20 6c61 6e67 3a3a 0a2a 206c 6f63 :.* lang::.* loc │ │ │ │ │ -00021300: 616c 655f 6469 723a 3a0a 2a20 6d65 6e75 ale_dir::.* menu │ │ │ │ │ -00021310: 5f63 6f6c 6f72 5f68 6967 686c 6967 6874 _color_highlight │ │ │ │ │ -00021320: 3a3a 0a2a 206d 656e 755f 636f 6c6f 725f ::.* menu_color_ │ │ │ │ │ -00021330: 6e6f 726d 616c 3a3a 0a2a 206e 6574 5f3c normal::.* net_< │ │ │ │ │ -00021340: 494e 5445 5246 4143 453e 5f62 6f6f 745f INTERFACE>_boot_ │ │ │ │ │ -00021350: 6669 6c65 3a3a 0a2a 206e 6574 5f3c 494e file::.* net__dhcp_se │ │ │ │ │ -00021370: 7276 6572 5f6e 616d 653a 3a0a 2a20 6e65 rver_name::.* ne │ │ │ │ │ -00021380: 745f 3c49 4e54 4552 4641 4345 3e5f 646f t__do │ │ │ │ │ -00021390: 6d61 696e 3a3a 0a2a 206e 6574 5f3c 494e main::.* net__extensi │ │ │ │ │ -000213b0: 6f6e 7370 6174 683a 3a0a 2a20 6e65 745f onspath::.* net_ │ │ │ │ │ -000213c0: 3c49 4e54 4552 4641 4345 3e5f 686f 7374 _host │ │ │ │ │ -000213d0: 6e61 6d65 3a3a 0a2a 206e 6574 5f3c 494e name::.* net__ip::.* │ │ │ │ │ -000213f0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -00021400: 6d61 633a 3a0a 2a20 6e65 745f 3c49 4e54 mac::.* net__next_ser │ │ │ │ │ -00021420: 7665 723a 3a0a 2a20 6e65 745f 3c49 4e54 ver::.* net__rootpath │ │ │ │ │ -00021440: 3a3a 0a2a 206e 6574 5f64 6566 6175 6c74 ::.* net_default │ │ │ │ │ -00021450: 5f69 6e74 6572 6661 6365 3a3a 0a2a 206e _interface::.* n │ │ │ │ │ -00021460: 6574 5f64 6566 6175 6c74 5f69 703a 3a0a et_default_ip::. │ │ │ │ │ -00021470: 2a20 6e65 745f 6465 6661 756c 745f 6d61 * net_default_ma │ │ │ │ │ -00021480: 633a 3a0a 2a20 6e65 745f 6465 6661 756c c::.* net_defaul │ │ │ │ │ -00021490: 745f 7365 7276 6572 3a3a 0a2a 2070 6167 t_server::.* pag │ │ │ │ │ -000214a0: 6572 3a3a 0a2a 2070 7265 6669 783a 3a0a er::.* prefix::. │ │ │ │ │ -000214b0: 2a20 7078 655f 626c 6b73 697a 653a 3a0a * pxe_blksize::. │ │ │ │ │ -000214c0: 2a20 7078 655f 6465 6661 756c 745f 6761 * pxe_default_ga │ │ │ │ │ -000214d0: 7465 7761 793a 3a0a 2a20 7078 655f 6465 teway::.* pxe_de │ │ │ │ │ -000214e0: 6661 756c 745f 7365 7276 6572 3a3a 0a2a fault_server::.* │ │ │ │ │ -000214f0: 2072 6f6f 743a 3a0a 2a20 7375 7065 7275 root::.* superu │ │ │ │ │ -00021500: 7365 7273 3a3a 0a2a 2074 6865 6d65 3a3a sers::.* theme:: │ │ │ │ │ -00021510: 0a2a 2074 696d 656f 7574 3a3a 0a2a 2074 .* timeout::.* t │ │ │ │ │ -00021520: 696d 656f 7574 5f73 7479 6c65 3a3a 0a0a imeout_style::.. │ │ │ │ │ -00021530: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00021540: 6f2c 2020 4e6f 6465 3a20 6269 6f73 6e75 o, Node: biosnu │ │ │ │ │ -00021550: 6d2c 2020 4e65 7874 3a20 6368 6563 6b5f m, Next: check_ │ │ │ │ │ -00021560: 7369 676e 6174 7572 6573 2c20 2055 703a signatures, Up: │ │ │ │ │ -00021570: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ -00021580: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ │ -00021590: 3135 2e31 2e31 2062 696f 736e 756d 0a2d 15.1.1 biosnum.- │ │ │ │ │ -000215a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a57 -------------..W │ │ │ │ │ -000215b0: 6865 6e20 6368 6169 6e2d 6c6f 6164 696e hen chain-loadin │ │ │ │ │ -000215c0: 6720 616e 6f74 6865 7220 626f 6f74 206c g another boot l │ │ │ │ │ -000215d0: 6f61 6465 7220 282a 6e6f 7465 2043 6861 oader (*note Cha │ │ │ │ │ -000215e0: 696e 2d6c 6f61 6469 6e67 3a3a 292c 2047 in-loading::), G │ │ │ │ │ -000215f0: 5255 4220 6d61 790a 6e65 6564 2074 6f20 RUB may.need to │ │ │ │ │ -00021600: 6b6e 6f77 2077 6861 7420 4249 4f53 2064 know what BIOS d │ │ │ │ │ -00021610: 7269 7665 206e 756d 6265 7220 636f 7272 rive number corr │ │ │ │ │ -00021620: 6573 706f 6e64 7320 746f 2074 6865 2072 esponds to the r │ │ │ │ │ -00021630: 6f6f 7420 6465 7669 6365 0a28 2a6e 6f74 oot device.(*not │ │ │ │ │ -00021640: 6520 726f 6f74 3a3a 2920 736f 2074 6861 e root::) so tha │ │ │ │ │ -00021650: 7420 6974 2063 616e 2073 6574 2075 7020 t it can set up │ │ │ │ │ -00021660: 7265 6769 7374 6572 7320 7072 6f70 6572 registers proper │ │ │ │ │ -00021670: 6c79 2e20 2049 6620 7468 6520 4249 4f53 ly. If the BIOS │ │ │ │ │ -00021680: 4e55 4d0a 7661 7269 6162 6c65 2069 7320 NUM.variable is │ │ │ │ │ -00021690: 7365 742c 2069 7420 6f76 6572 7269 6465 set, it override │ │ │ │ │ -000216a0: 7320 4752 5542 2773 206f 776e 206d 6561 s GRUB's own mea │ │ │ │ │ -000216b0: 6e73 206f 6620 6775 6573 7369 6e67 2074 ns of guessing t │ │ │ │ │ -000216c0: 6869 732e 0a0a 2020 2046 6f72 2061 6e20 his... For an │ │ │ │ │ -000216d0: 616c 7465 726e 6174 6976 6520 6170 7072 alternative appr │ │ │ │ │ -000216e0: 6f61 6368 2077 6869 6368 2061 6c73 6f20 oach which also │ │ │ │ │ -000216f0: 6368 616e 6765 7320 4249 4f53 2064 7269 changes BIOS dri │ │ │ │ │ -00021700: 7665 206d 6170 7069 6e67 730a 666f 7220 ve mappings.for │ │ │ │ │ -00021710: 7468 6520 6368 6169 6e2d 6c6f 6164 6564 the chain-loaded │ │ │ │ │ -00021720: 2073 7973 7465 6d2c 202a 6e6f 7465 2064 system, *note d │ │ │ │ │ -00021730: 7269 7665 6d61 703a 3a2e 0a0a 1f0a 4669 rivemap::.....Fi │ │ │ │ │ -00021740: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00021750: 4e6f 6465 3a20 6368 6563 6b5f 7369 676e Node: check_sign │ │ │ │ │ -00021760: 6174 7572 6573 2c20 204e 6578 743a 2063 atures, Next: c │ │ │ │ │ -00021770: 686f 7365 6e2c 2020 5072 6576 3a20 6269 hosen, Prev: bi │ │ │ │ │ -00021780: 6f73 6e75 6d2c 2020 5570 3a20 5370 6563 osnum, Up: Spec │ │ │ │ │ -00021790: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ -000217a0: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ -000217b0: 3220 6368 6563 6b5f 7369 676e 6174 7572 2 check_signatur │ │ │ │ │ -000217c0: 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d es.------------- │ │ │ │ │ -000217d0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 6973 ----------..This │ │ │ │ │ -000217e0: 2076 6172 6961 626c 6520 636f 6e74 726f variable contro │ │ │ │ │ -000217f0: 6c73 2077 6865 7468 6572 2047 5255 4220 ls whether GRUB │ │ │ │ │ -00021800: 656e 666f 7263 6573 2064 6967 6974 616c enforces digital │ │ │ │ │ -00021810: 2073 6967 6e61 7475 7265 0a76 616c 6964 signature.valid │ │ │ │ │ -00021820: 6174 696f 6e20 6f6e 206c 6f61 6465 6420 ation on loaded │ │ │ │ │ -00021830: 6669 6c65 732e 2020 2a4e 6f74 6520 5573 files. *Note Us │ │ │ │ │ -00021840: 696e 6720 6469 6769 7461 6c20 7369 676e ing digital sign │ │ │ │ │ -00021850: 6174 7572 6573 3a3a 2e0a 0a1f 0a46 696c atures::.....Fil │ │ │ │ │ -00021860: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00021870: 6f64 653a 2063 686f 7365 6e2c 2020 4e65 ode: chosen, Ne │ │ │ │ │ -00021880: 7874 3a20 636d 6470 6174 682c 2020 5072 xt: cmdpath, Pr │ │ │ │ │ -00021890: 6576 3a20 6368 6563 6b5f 7369 676e 6174 ev: check_signat │ │ │ │ │ -000218a0: 7572 6573 2c20 2055 703a 2053 7065 6369 ures, Up: Speci │ │ │ │ │ -000218b0: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ │ -000218c0: 6172 6961 626c 6573 0a0a 3135 2e31 2e33 ariables..15.1.3 │ │ │ │ │ -000218d0: 2063 686f 7365 6e0a 2d2d 2d2d 2d2d 2d2d chosen.-------- │ │ │ │ │ -000218e0: 2d2d 2d2d 2d0a 0a57 6865 6e20 6578 6563 -----..When exec │ │ │ │ │ -000218f0: 7574 696e 6720 6120 6d65 6e75 2065 6e74 uting a menu ent │ │ │ │ │ -00021900: 7279 2c20 4752 5542 2073 6574 7320 7468 ry, GRUB sets th │ │ │ │ │ -00021910: 6520 4348 4f53 454e 2076 6172 6961 626c e CHOSEN variabl │ │ │ │ │ -00021920: 6520 746f 2074 6865 2074 6974 6c65 0a6f e to the title.o │ │ │ │ │ -00021930: 6620 7468 6520 656e 7472 7920 6265 696e f the entry bein │ │ │ │ │ -00021940: 6720 6578 6563 7574 6564 2e0a 0a20 2020 g executed... │ │ │ │ │ -00021950: 4966 2074 6865 206d 656e 7520 656e 7472 If the menu entr │ │ │ │ │ -00021960: 7920 6973 2069 6e20 6f6e 6520 6f72 206d y is in one or m │ │ │ │ │ -00021970: 6f72 6520 7375 626d 656e 7573 2c20 7468 ore submenus, th │ │ │ │ │ -00021980: 656e 2043 484f 5345 4e20 6973 2073 6574 en CHOSEN is set │ │ │ │ │ -00021990: 2074 6f0a 7468 6520 7469 746c 6573 206f to.the titles o │ │ │ │ │ -000219a0: 6620 6561 6368 206f 6620 7468 6520 7375 f each of the su │ │ │ │ │ -000219b0: 626d 656e 7573 2073 7461 7274 696e 6720 bmenus starting │ │ │ │ │ -000219c0: 6672 6f6d 2074 6865 2074 6f70 206c 6576 from the top lev │ │ │ │ │ -000219d0: 656c 2066 6f6c 6c6f 7765 640a 6279 2074 el followed.by t │ │ │ │ │ -000219e0: 6865 2074 6974 6c65 206f 6620 7468 6520 he title of the │ │ │ │ │ -000219f0: 6d65 6e75 2065 6e74 7279 2069 7473 656c menu entry itsel │ │ │ │ │ -00021a00: 662c 2073 6570 6172 6174 6564 2062 7920 f, separated by │ │ │ │ │ -00021a10: 273e 272e 0a0a 1f0a 4669 6c65 3a20 6772 '>'.....File: gr │ │ │ │ │ -00021a20: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00021a30: 636d 6470 6174 682c 2020 4e65 7874 3a20 cmdpath, Next: │ │ │ │ │ -00021a40: 636f 6c6f 725f 6869 6768 6c69 6768 742c color_highlight, │ │ │ │ │ -00021a50: 2020 5072 6576 3a20 6368 6f73 656e 2c20 Prev: chosen, │ │ │ │ │ -00021a60: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ -00021a70: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -00021a80: 6573 0a0a 3135 2e31 2e34 2063 6d64 7061 es..15.1.4 cmdpa │ │ │ │ │ -00021a90: 7468 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d th.------------- │ │ │ │ │ -00021aa0: 2d0a 0a54 6865 206c 6f63 6174 696f 6e20 -..The location │ │ │ │ │ -00021ab0: 6672 6f6d 2077 6869 6368 2027 636f 7265 from which 'core │ │ │ │ │ -00021ac0: 2e69 6d67 2720 7761 7320 6c6f 6164 6564 .img' was loaded │ │ │ │ │ -00021ad0: 2061 7320 616e 2061 6273 6f6c 7574 6520 as an absolute │ │ │ │ │ -00021ae0: 6469 7265 6374 6f72 790a 6e61 6d65 2028 directory.name ( │ │ │ │ │ -00021af0: 2a6e 6f74 6520 4669 6c65 206e 616d 6520 *note File name │ │ │ │ │ -00021b00: 7379 6e74 6178 3a3a 292e 2020 5468 6973 syntax::). This │ │ │ │ │ -00021b10: 2069 7320 7365 7420 6279 2047 5255 4220 is set by GRUB │ │ │ │ │ -00021b20: 6174 2073 7461 7274 7570 2062 6173 6564 at startup based │ │ │ │ │ -00021b30: 0a6f 6e20 696e 666f 726d 6174 696f 6e20 .on information │ │ │ │ │ -00021b40: 7265 7475 726e 6564 2062 7920 706c 6174 returned by plat │ │ │ │ │ -00021b50: 666f 726d 2066 6972 6d77 6172 652e 2020 form firmware. │ │ │ │ │ -00021b60: 4e6f 7420 6576 6572 7920 706c 6174 666f Not every platfo │ │ │ │ │ -00021b70: 726d 0a70 726f 7669 6465 7320 7468 6973 rm.provides this │ │ │ │ │ -00021b80: 2069 6e66 6f72 6d61 7469 6f6e 2061 6e64 information and │ │ │ │ │ -00021b90: 2073 6f6d 6520 6d61 7920 7265 7475 726e some may return │ │ │ │ │ -00021ba0: 206f 6e6c 7920 6465 7669 6365 2077 6974 only device wit │ │ │ │ │ -00021bb0: 686f 7574 2070 6174 680a 6e61 6d65 2e0a hout path.name.. │ │ │ │ │ -00021bc0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00021bd0: 666f 2c20 204e 6f64 653a 2063 6f6c 6f72 fo, Node: color │ │ │ │ │ -00021be0: 5f68 6967 686c 6967 6874 2c20 204e 6578 _highlight, Nex │ │ │ │ │ -00021bf0: 743a 2063 6f6c 6f72 5f6e 6f72 6d61 6c2c t: color_normal, │ │ │ │ │ -00021c00: 2020 5072 6576 3a20 636d 6470 6174 682c Prev: cmdpath, │ │ │ │ │ -00021c10: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ │ -00021c20: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ -00021c30: 6c65 730a 0a31 352e 312e 3520 636f 6c6f les..15.1.5 colo │ │ │ │ │ -00021c40: 725f 6869 6768 6c69 6768 740a 2d2d 2d2d r_highlight.---- │ │ │ │ │ +000211b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +000211c0: 5468 6573 6520 7661 7269 6162 6c65 7320 These variables │ │ │ │ │ +000211d0: 6861 7665 2073 7065 6369 616c 206d 6561 have special mea │ │ │ │ │ +000211e0: 6e69 6e67 2074 6f20 4752 5542 2e0a 0a2a ning to GRUB...* │ │ │ │ │ +000211f0: 204d 656e 753a 0a0a 2a20 6269 6f73 6e75 Menu:..* biosnu │ │ │ │ │ +00021200: 6d3a 3a0a 2a20 6368 6563 6b5f 7369 676e m::.* check_sign │ │ │ │ │ +00021210: 6174 7572 6573 3a3a 0a2a 2063 686f 7365 atures::.* chose │ │ │ │ │ +00021220: 6e3a 3a0a 2a20 636d 6470 6174 683a 3a0a n::.* cmdpath::. │ │ │ │ │ +00021230: 2a20 636f 6c6f 725f 6869 6768 6c69 6768 * color_highligh │ │ │ │ │ +00021240: 743a 3a0a 2a20 636f 6c6f 725f 6e6f 726d t::.* color_norm │ │ │ │ │ +00021250: 616c 3a3a 0a2a 2063 6f6e 6669 675f 6469 al::.* config_di │ │ │ │ │ +00021260: 7265 6374 6f72 793a 3a0a 2a20 636f 6e66 rectory::.* conf │ │ │ │ │ +00021270: 6967 5f66 696c 653a 3a0a 2a20 6465 6275 ig_file::.* debu │ │ │ │ │ +00021280: 673a 3a0a 2a20 6465 6661 756c 743a 3a0a g::.* default::. │ │ │ │ │ +00021290: 2a20 6661 6c6c 6261 636b 3a3a 0a2a 2067 * fallback::.* g │ │ │ │ │ +000212a0: 6678 6d6f 6465 3a3a 0a2a 2067 6678 7061 fxmode::.* gfxpa │ │ │ │ │ +000212b0: 796c 6f61 643a 3a0a 2a20 6766 7874 6572 yload::.* gfxter │ │ │ │ │ +000212c0: 6d5f 666f 6e74 3a3a 0a2a 2067 7275 625f m_font::.* grub_ │ │ │ │ │ +000212d0: 6370 753a 3a0a 2a20 6772 7562 5f70 6c61 cpu::.* grub_pla │ │ │ │ │ +000212e0: 7466 6f72 6d3a 3a0a 2a20 6963 6f6e 6469 tform::.* icondi │ │ │ │ │ +000212f0: 723a 3a0a 2a20 6c61 6e67 3a3a 0a2a 206c r::.* lang::.* l │ │ │ │ │ +00021300: 6f63 616c 655f 6469 723a 3a0a 2a20 6d65 ocale_dir::.* me │ │ │ │ │ +00021310: 6e75 5f63 6f6c 6f72 5f68 6967 686c 6967 nu_color_highlig │ │ │ │ │ +00021320: 6874 3a3a 0a2a 206d 656e 755f 636f 6c6f ht::.* menu_colo │ │ │ │ │ +00021330: 725f 6e6f 726d 616c 3a3a 0a2a 206e 6574 r_normal::.* net │ │ │ │ │ +00021340: 5f3c 494e 5445 5246 4143 453e 5f62 6f6f __boo │ │ │ │ │ +00021350: 745f 6669 6c65 3a3a 0a2a 206e 6574 5f3c t_file::.* net_< │ │ │ │ │ +00021360: 494e 5445 5246 4143 453e 5f64 6863 705f INTERFACE>_dhcp_ │ │ │ │ │ +00021370: 7365 7276 6572 5f6e 616d 653a 3a0a 2a20 server_name::.* │ │ │ │ │ +00021380: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ +00021390: 646f 6d61 696e 3a3a 0a2a 206e 6574 5f3c domain::.* net_< │ │ │ │ │ +000213a0: 494e 5445 5246 4143 453e 5f65 7874 656e INTERFACE>_exten │ │ │ │ │ +000213b0: 7369 6f6e 7370 6174 683a 3a0a 2a20 6e65 sionspath::.* ne │ │ │ │ │ +000213c0: 745f 3c49 4e54 4552 4641 4345 3e5f 686f t__ho │ │ │ │ │ +000213d0: 7374 6e61 6d65 3a3a 0a2a 206e 6574 5f3c stname::.* net_< │ │ │ │ │ +000213e0: 494e 5445 5246 4143 453e 5f69 703a 3a0a INTERFACE>_ip::. │ │ │ │ │ +000213f0: 2a20 6e65 745f 3c49 4e54 4552 4641 4345 * net__mac::.* net__next_s │ │ │ │ │ +00021420: 6572 7665 723a 3a0a 2a20 6e65 745f 3c49 erver::.* net__rootpa │ │ │ │ │ +00021440: 7468 3a3a 0a2a 206e 6574 5f64 6566 6175 th::.* net_defau │ │ │ │ │ +00021450: 6c74 5f69 6e74 6572 6661 6365 3a3a 0a2a lt_interface::.* │ │ │ │ │ +00021460: 206e 6574 5f64 6566 6175 6c74 5f69 703a net_default_ip: │ │ │ │ │ +00021470: 3a0a 2a20 6e65 745f 6465 6661 756c 745f :.* net_default_ │ │ │ │ │ +00021480: 6d61 633a 3a0a 2a20 6e65 745f 6465 6661 mac::.* net_defa │ │ │ │ │ +00021490: 756c 745f 7365 7276 6572 3a3a 0a2a 2070 ult_server::.* p │ │ │ │ │ +000214a0: 6167 6572 3a3a 0a2a 2070 7265 6669 783a ager::.* prefix: │ │ │ │ │ +000214b0: 3a0a 2a20 7078 655f 626c 6b73 697a 653a :.* pxe_blksize: │ │ │ │ │ +000214c0: 3a0a 2a20 7078 655f 6465 6661 756c 745f :.* pxe_default_ │ │ │ │ │ +000214d0: 6761 7465 7761 793a 3a0a 2a20 7078 655f gateway::.* pxe_ │ │ │ │ │ +000214e0: 6465 6661 756c 745f 7365 7276 6572 3a3a default_server:: │ │ │ │ │ +000214f0: 0a2a 2072 6f6f 743a 3a0a 2a20 7375 7065 .* root::.* supe │ │ │ │ │ +00021500: 7275 7365 7273 3a3a 0a2a 2074 6865 6d65 rusers::.* theme │ │ │ │ │ +00021510: 3a3a 0a2a 2074 696d 656f 7574 3a3a 0a2a ::.* timeout::.* │ │ │ │ │ +00021520: 2074 696d 656f 7574 5f73 7479 6c65 3a3a timeout_style:: │ │ │ │ │ +00021530: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00021540: 6e66 6f2c 2020 4e6f 6465 3a20 6269 6f73 nfo, Node: bios │ │ │ │ │ +00021550: 6e75 6d2c 2020 4e65 7874 3a20 6368 6563 num, Next: chec │ │ │ │ │ +00021560: 6b5f 7369 676e 6174 7572 6573 2c20 2055 k_signatures, U │ │ │ │ │ +00021570: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ +00021580: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ +00021590: 0a0a 3135 2e31 2e31 2062 696f 736e 756d ..15.1.1 biosnum │ │ │ │ │ +000215a0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a .--------------. │ │ │ │ │ +000215b0: 0a57 6865 6e20 6368 6169 6e2d 6c6f 6164 .When chain-load │ │ │ │ │ +000215c0: 696e 6720 616e 6f74 6865 7220 626f 6f74 ing another boot │ │ │ │ │ +000215d0: 206c 6f61 6465 7220 282a 6e6f 7465 2043 loader (*note C │ │ │ │ │ +000215e0: 6861 696e 2d6c 6f61 6469 6e67 3a3a 292c hain-loading::), │ │ │ │ │ +000215f0: 2047 5255 4220 6d61 790a 6e65 6564 2074 GRUB may.need t │ │ │ │ │ +00021600: 6f20 6b6e 6f77 2077 6861 7420 4249 4f53 o know what BIOS │ │ │ │ │ +00021610: 2064 7269 7665 206e 756d 6265 7220 636f drive number co │ │ │ │ │ +00021620: 7272 6573 706f 6e64 7320 746f 2074 6865 rresponds to the │ │ │ │ │ +00021630: 2072 6f6f 7420 6465 7669 6365 0a28 2a6e root device.(*n │ │ │ │ │ +00021640: 6f74 6520 726f 6f74 3a3a 2920 736f 2074 ote root::) so t │ │ │ │ │ +00021650: 6861 7420 6974 2063 616e 2073 6574 2075 hat it can set u │ │ │ │ │ +00021660: 7020 7265 6769 7374 6572 7320 7072 6f70 p registers prop │ │ │ │ │ +00021670: 6572 6c79 2e20 2049 6620 7468 6520 4249 erly. If the BI │ │ │ │ │ +00021680: 4f53 4e55 4d0a 7661 7269 6162 6c65 2069 OSNUM.variable i │ │ │ │ │ +00021690: 7320 7365 742c 2069 7420 6f76 6572 7269 s set, it overri │ │ │ │ │ +000216a0: 6465 7320 4752 5542 2773 206f 776e 206d des GRUB's own m │ │ │ │ │ +000216b0: 6561 6e73 206f 6620 6775 6573 7369 6e67 eans of guessing │ │ │ │ │ +000216c0: 2074 6869 732e 0a0a 2020 2046 6f72 2061 this... For a │ │ │ │ │ +000216d0: 6e20 616c 7465 726e 6174 6976 6520 6170 n alternative ap │ │ │ │ │ +000216e0: 7072 6f61 6368 2077 6869 6368 2061 6c73 proach which als │ │ │ │ │ +000216f0: 6f20 6368 616e 6765 7320 4249 4f53 2064 o changes BIOS d │ │ │ │ │ +00021700: 7269 7665 206d 6170 7069 6e67 730a 666f rive mappings.fo │ │ │ │ │ +00021710: 7220 7468 6520 6368 6169 6e2d 6c6f 6164 r the chain-load │ │ │ │ │ +00021720: 6564 2073 7973 7465 6d2c 202a 6e6f 7465 ed system, *note │ │ │ │ │ +00021730: 2064 7269 7665 6d61 703a 3a2e 0a0a 1f0a drivemap::..... │ │ │ │ │ +00021740: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00021750: 2020 4e6f 6465 3a20 6368 6563 6b5f 7369 Node: check_si │ │ │ │ │ +00021760: 676e 6174 7572 6573 2c20 204e 6578 743a gnatures, Next: │ │ │ │ │ +00021770: 2063 686f 7365 6e2c 2020 5072 6576 3a20 chosen, Prev: │ │ │ │ │ +00021780: 6269 6f73 6e75 6d2c 2020 5570 3a20 5370 biosnum, Up: Sp │ │ │ │ │ +00021790: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ +000217a0: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ │ +000217b0: 312e 3220 6368 6563 6b5f 7369 676e 6174 1.2 check_signat │ │ │ │ │ +000217c0: 7572 6573 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d ures.----------- │ │ │ │ │ +000217d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 ------------..Th │ │ │ │ │ +000217e0: 6973 2076 6172 6961 626c 6520 636f 6e74 is variable cont │ │ │ │ │ +000217f0: 726f 6c73 2077 6865 7468 6572 2047 5255 rols whether GRU │ │ │ │ │ +00021800: 4220 656e 666f 7263 6573 2064 6967 6974 B enforces digit │ │ │ │ │ +00021810: 616c 2073 6967 6e61 7475 7265 0a76 616c al signature.val │ │ │ │ │ +00021820: 6964 6174 696f 6e20 6f6e 206c 6f61 6465 idation on loade │ │ │ │ │ +00021830: 6420 6669 6c65 732e 2020 2a4e 6f74 6520 d files. *Note │ │ │ │ │ +00021840: 5573 696e 6720 6469 6769 7461 6c20 7369 Using digital si │ │ │ │ │ +00021850: 676e 6174 7572 6573 3a3a 2e0a 0a1f 0a46 gnatures::.....F │ │ │ │ │ +00021860: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00021870: 204e 6f64 653a 2063 686f 7365 6e2c 2020 Node: chosen, │ │ │ │ │ +00021880: 4e65 7874 3a20 636d 6470 6174 682c 2020 Next: cmdpath, │ │ │ │ │ +00021890: 5072 6576 3a20 6368 6563 6b5f 7369 676e Prev: check_sign │ │ │ │ │ +000218a0: 6174 7572 6573 2c20 2055 703a 2053 7065 atures, Up: Spe │ │ │ │ │ +000218b0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ +000218c0: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ │ +000218d0: 2e33 2063 686f 7365 6e0a 2d2d 2d2d 2d2d .3 chosen.------ │ │ │ │ │ +000218e0: 2d2d 2d2d 2d2d 2d0a 0a57 6865 6e20 6578 -------..When ex │ │ │ │ │ +000218f0: 6563 7574 696e 6720 6120 6d65 6e75 2065 ecuting a menu e │ │ │ │ │ +00021900: 6e74 7279 2c20 4752 5542 2073 6574 7320 ntry, GRUB sets │ │ │ │ │ +00021910: 7468 6520 4348 4f53 454e 2076 6172 6961 the CHOSEN varia │ │ │ │ │ +00021920: 626c 6520 746f 2074 6865 2074 6974 6c65 ble to the title │ │ │ │ │ +00021930: 0a6f 6620 7468 6520 656e 7472 7920 6265 .of the entry be │ │ │ │ │ +00021940: 696e 6720 6578 6563 7574 6564 2e0a 0a20 ing executed... │ │ │ │ │ +00021950: 2020 4966 2074 6865 206d 656e 7520 656e If the menu en │ │ │ │ │ +00021960: 7472 7920 6973 2069 6e20 6f6e 6520 6f72 try is in one or │ │ │ │ │ +00021970: 206d 6f72 6520 7375 626d 656e 7573 2c20 more submenus, │ │ │ │ │ +00021980: 7468 656e 2043 484f 5345 4e20 6973 2073 then CHOSEN is s │ │ │ │ │ +00021990: 6574 2074 6f0a 7468 6520 7469 746c 6573 et to.the titles │ │ │ │ │ +000219a0: 206f 6620 6561 6368 206f 6620 7468 6520 of each of the │ │ │ │ │ +000219b0: 7375 626d 656e 7573 2073 7461 7274 696e submenus startin │ │ │ │ │ +000219c0: 6720 6672 6f6d 2074 6865 2074 6f70 206c g from the top l │ │ │ │ │ +000219d0: 6576 656c 2066 6f6c 6c6f 7765 640a 6279 evel followed.by │ │ │ │ │ +000219e0: 2074 6865 2074 6974 6c65 206f 6620 7468 the title of th │ │ │ │ │ +000219f0: 6520 6d65 6e75 2065 6e74 7279 2069 7473 e menu entry its │ │ │ │ │ +00021a00: 656c 662c 2073 6570 6172 6174 6564 2062 elf, separated b │ │ │ │ │ +00021a10: 7920 273e 272e 0a0a 1f0a 4669 6c65 3a20 y '>'.....File: │ │ │ │ │ +00021a20: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00021a30: 3a20 636d 6470 6174 682c 2020 4e65 7874 : cmdpath, Next │ │ │ │ │ +00021a40: 3a20 636f 6c6f 725f 6869 6768 6c69 6768 : color_highligh │ │ │ │ │ +00021a50: 742c 2020 5072 6576 3a20 6368 6f73 656e t, Prev: chosen │ │ │ │ │ +00021a60: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ +00021a70: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00021a80: 626c 6573 0a0a 3135 2e31 2e34 2063 6d64 bles..15.1.4 cmd │ │ │ │ │ +00021a90: 7061 7468 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d path.----------- │ │ │ │ │ +00021aa0: 2d2d 2d0a 0a54 6865 206c 6f63 6174 696f ---..The locatio │ │ │ │ │ +00021ab0: 6e20 6672 6f6d 2077 6869 6368 2027 636f n from which 'co │ │ │ │ │ +00021ac0: 7265 2e69 6d67 2720 7761 7320 6c6f 6164 re.img' was load │ │ │ │ │ +00021ad0: 6564 2061 7320 616e 2061 6273 6f6c 7574 ed as an absolut │ │ │ │ │ +00021ae0: 6520 6469 7265 6374 6f72 790a 6e61 6d65 e directory.name │ │ │ │ │ +00021af0: 2028 2a6e 6f74 6520 4669 6c65 206e 616d (*note File nam │ │ │ │ │ +00021b00: 6520 7379 6e74 6178 3a3a 292e 2020 5468 e syntax::). Th │ │ │ │ │ +00021b10: 6973 2069 7320 7365 7420 6279 2047 5255 is is set by GRU │ │ │ │ │ +00021b20: 4220 6174 2073 7461 7274 7570 2062 6173 B at startup bas │ │ │ │ │ +00021b30: 6564 0a6f 6e20 696e 666f 726d 6174 696f ed.on informatio │ │ │ │ │ +00021b40: 6e20 7265 7475 726e 6564 2062 7920 706c n returned by pl │ │ │ │ │ +00021b50: 6174 666f 726d 2066 6972 6d77 6172 652e atform firmware. │ │ │ │ │ +00021b60: 2020 4e6f 7420 6576 6572 7920 706c 6174 Not every plat │ │ │ │ │ +00021b70: 666f 726d 0a70 726f 7669 6465 7320 7468 form.provides th │ │ │ │ │ +00021b80: 6973 2069 6e66 6f72 6d61 7469 6f6e 2061 is information a │ │ │ │ │ +00021b90: 6e64 2073 6f6d 6520 6d61 7920 7265 7475 nd some may retu │ │ │ │ │ +00021ba0: 726e 206f 6e6c 7920 6465 7669 6365 2077 rn only device w │ │ │ │ │ +00021bb0: 6974 686f 7574 2070 6174 680a 6e61 6d65 ithout path.name │ │ │ │ │ +00021bc0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00021bd0: 696e 666f 2c20 204e 6f64 653a 2063 6f6c info, Node: col │ │ │ │ │ +00021be0: 6f72 5f68 6967 686c 6967 6874 2c20 204e or_highlight, N │ │ │ │ │ +00021bf0: 6578 743a 2063 6f6c 6f72 5f6e 6f72 6d61 ext: color_norma │ │ │ │ │ +00021c00: 6c2c 2020 5072 6576 3a20 636d 6470 6174 l, Prev: cmdpat │ │ │ │ │ +00021c10: 682c 2020 5570 3a20 5370 6563 6961 6c20 h, Up: Special │ │ │ │ │ +00021c20: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ +00021c30: 6162 6c65 730a 0a31 352e 312e 3520 636f ables..15.1.5 co │ │ │ │ │ +00021c40: 6c6f 725f 6869 6768 6c69 6768 740a 2d2d lor_highlight.-- │ │ │ │ │ 00021c50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00021c60: 2d2d 0a0a 5468 6973 2076 6172 6961 626c --..This variabl │ │ │ │ │ -00021c70: 6520 636f 6e74 6169 6e73 2074 6865 2022 e contains the " │ │ │ │ │ -00021c80: 6869 6768 6c69 6768 7422 2066 6f72 6567 highlight" foreg │ │ │ │ │ -00021c90: 726f 756e 6420 616e 6420 6261 636b 6772 round and backgr │ │ │ │ │ -00021ca0: 6f75 6e64 0a74 6572 6d69 6e61 6c20 636f ound.terminal co │ │ │ │ │ -00021cb0: 6c6f 7273 2c20 7365 7061 7261 7465 6420 lors, separated │ │ │ │ │ -00021cc0: 6279 2061 2073 6c61 7368 2028 272f 2729 by a slash ('/') │ │ │ │ │ -00021cd0: 2e20 2053 6574 7469 6e67 2074 6869 7320 . Setting this │ │ │ │ │ -00021ce0: 7661 7269 6162 6c65 0a63 6861 6e67 6573 variable.changes │ │ │ │ │ -00021cf0: 2074 686f 7365 2063 6f6c 6f72 732e 2020 those colors. │ │ │ │ │ -00021d00: 466f 7220 7468 6520 6176 6169 6c61 626c For the availabl │ │ │ │ │ -00021d10: 6520 636f 6c6f 7220 6e61 6d65 732c 202a e color names, * │ │ │ │ │ -00021d20: 6e6f 7465 0a63 6f6c 6f72 5f6e 6f72 6d61 note.color_norma │ │ │ │ │ -00021d30: 6c3a 3a2e 0a0a 2020 2054 6865 2064 6566 l::... The def │ │ │ │ │ -00021d40: 6175 6c74 2069 7320 2762 6c61 636b 2f6c ault is 'black/l │ │ │ │ │ -00021d50: 6967 6874 2d67 7261 7927 2e0a 0a1f 0a46 ight-gray'.....F │ │ │ │ │ -00021d60: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -00021d70: 204e 6f64 653a 2063 6f6c 6f72 5f6e 6f72 Node: color_nor │ │ │ │ │ -00021d80: 6d61 6c2c 2020 4e65 7874 3a20 636f 6e66 mal, Next: conf │ │ │ │ │ -00021d90: 6967 5f64 6972 6563 746f 7279 2c20 2050 ig_directory, P │ │ │ │ │ -00021da0: 7265 763a 2063 6f6c 6f72 5f68 6967 686c rev: color_highl │ │ │ │ │ -00021db0: 6967 6874 2c20 2055 703a 2053 7065 6369 ight, Up: Speci │ │ │ │ │ -00021dc0: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ │ -00021dd0: 6172 6961 626c 6573 0a0a 3135 2e31 2e36 ariables..15.1.6 │ │ │ │ │ -00021de0: 2063 6f6c 6f72 5f6e 6f72 6d61 6c0a 2d2d color_normal.-- │ │ │ │ │ +00021c60: 2d2d 2d2d 0a0a 5468 6973 2076 6172 6961 ----..This varia │ │ │ │ │ +00021c70: 626c 6520 636f 6e74 6169 6e73 2074 6865 ble contains the │ │ │ │ │ +00021c80: 2022 6869 6768 6c69 6768 7422 2066 6f72 "highlight" for │ │ │ │ │ +00021c90: 6567 726f 756e 6420 616e 6420 6261 636b eground and back │ │ │ │ │ +00021ca0: 6772 6f75 6e64 0a74 6572 6d69 6e61 6c20 ground.terminal │ │ │ │ │ +00021cb0: 636f 6c6f 7273 2c20 7365 7061 7261 7465 colors, separate │ │ │ │ │ +00021cc0: 6420 6279 2061 2073 6c61 7368 2028 272f d by a slash ('/ │ │ │ │ │ +00021cd0: 2729 2e20 2053 6574 7469 6e67 2074 6869 '). Setting thi │ │ │ │ │ +00021ce0: 7320 7661 7269 6162 6c65 0a63 6861 6e67 s variable.chang │ │ │ │ │ +00021cf0: 6573 2074 686f 7365 2063 6f6c 6f72 732e es those colors. │ │ │ │ │ +00021d00: 2020 466f 7220 7468 6520 6176 6169 6c61 For the availa │ │ │ │ │ +00021d10: 626c 6520 636f 6c6f 7220 6e61 6d65 732c ble color names, │ │ │ │ │ +00021d20: 202a 6e6f 7465 0a63 6f6c 6f72 5f6e 6f72 *note.color_nor │ │ │ │ │ +00021d30: 6d61 6c3a 3a2e 0a0a 2020 2054 6865 2064 mal::... The d │ │ │ │ │ +00021d40: 6566 6175 6c74 2069 7320 2762 6c61 636b efault is 'black │ │ │ │ │ +00021d50: 2f6c 6967 6874 2d67 7261 7927 2e0a 0a1f /light-gray'.... │ │ │ │ │ +00021d60: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +00021d70: 2c20 204e 6f64 653a 2063 6f6c 6f72 5f6e , Node: color_n │ │ │ │ │ +00021d80: 6f72 6d61 6c2c 2020 4e65 7874 3a20 636f ormal, Next: co │ │ │ │ │ +00021d90: 6e66 6967 5f64 6972 6563 746f 7279 2c20 nfig_directory, │ │ │ │ │ +00021da0: 2050 7265 763a 2063 6f6c 6f72 5f68 6967 Prev: color_hig │ │ │ │ │ +00021db0: 686c 6967 6874 2c20 2055 703a 2053 7065 hlight, Up: Spe │ │ │ │ │ +00021dc0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ +00021dd0: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ │ +00021de0: 2e36 2063 6f6c 6f72 5f6e 6f72 6d61 6c0a .6 color_normal. │ │ │ │ │ 00021df0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00021e00: 2d0a 0a54 6869 7320 7661 7269 6162 6c65 -..This variable │ │ │ │ │ -00021e10: 2063 6f6e 7461 696e 7320 7468 6520 226e contains the "n │ │ │ │ │ -00021e20: 6f72 6d61 6c22 2066 6f72 6567 726f 756e ormal" foregroun │ │ │ │ │ -00021e30: 6420 616e 6420 6261 636b 6772 6f75 6e64 d and background │ │ │ │ │ -00021e40: 2074 6572 6d69 6e61 6c0a 636f 6c6f 7273 terminal.colors │ │ │ │ │ -00021e50: 2c20 7365 7061 7261 7465 6420 6279 2061 , separated by a │ │ │ │ │ -00021e60: 2073 6c61 7368 2028 272f 2729 2e20 2053 slash ('/'). S │ │ │ │ │ -00021e70: 6574 7469 6e67 2074 6869 7320 7661 7269 etting this vari │ │ │ │ │ -00021e80: 6162 6c65 2063 6861 6e67 6573 2074 686f able changes tho │ │ │ │ │ -00021e90: 7365 0a63 6f6c 6f72 732e 2020 4561 6368 se.colors. Each │ │ │ │ │ -00021ea0: 2063 6f6c 6f72 206d 7573 7420 6265 2061 color must be a │ │ │ │ │ -00021eb0: 206e 616d 6520 6672 6f6d 2074 6865 2066 name from the f │ │ │ │ │ -00021ec0: 6f6c 6c6f 7769 6e67 206c 6973 743a 0a0a ollowing list:.. │ │ │ │ │ -00021ed0: 2020 202a 2062 6c61 636b 0a20 2020 2a20 * black. * │ │ │ │ │ -00021ee0: 626c 7565 0a20 2020 2a20 6772 6565 6e0a blue. * green. │ │ │ │ │ -00021ef0: 2020 202a 2063 7961 6e0a 2020 202a 2072 * cyan. * r │ │ │ │ │ -00021f00: 6564 0a20 2020 2a20 6d61 6765 6e74 610a ed. * magenta. │ │ │ │ │ -00021f10: 2020 202a 2062 726f 776e 0a20 2020 2a20 * brown. * │ │ │ │ │ -00021f20: 6c69 6768 742d 6772 6179 0a20 2020 2a20 light-gray. * │ │ │ │ │ -00021f30: 6461 726b 2d67 7261 790a 2020 202a 206c dark-gray. * l │ │ │ │ │ -00021f40: 6967 6874 2d62 6c75 650a 2020 202a 206c ight-blue. * l │ │ │ │ │ -00021f50: 6967 6874 2d67 7265 656e 0a20 2020 2a20 ight-green. * │ │ │ │ │ -00021f60: 6c69 6768 742d 6379 616e 0a20 2020 2a20 light-cyan. * │ │ │ │ │ -00021f70: 6c69 6768 742d 7265 640a 2020 202a 206c light-red. * l │ │ │ │ │ -00021f80: 6967 6874 2d6d 6167 656e 7461 0a20 2020 ight-magenta. │ │ │ │ │ -00021f90: 2a20 7965 6c6c 6f77 0a20 2020 2a20 7768 * yellow. * wh │ │ │ │ │ -00021fa0: 6974 650a 0a20 2020 5468 6520 6465 6661 ite.. The defa │ │ │ │ │ -00021fb0: 756c 7420 6973 2027 6c69 6768 742d 6772 ult is 'light-gr │ │ │ │ │ -00021fc0: 6179 2f62 6c61 636b 272e 0a0a 2020 2054 ay/black'... T │ │ │ │ │ -00021fd0: 6865 2063 6f6c 6f72 2073 7570 706f 7274 he color support │ │ │ │ │ -00021fe0: 2073 7570 706f 7274 2076 6172 6965 7320 support varies │ │ │ │ │ -00021ff0: 6672 6f6d 2074 6572 6d69 6e61 6c20 746f from terminal to │ │ │ │ │ -00022000: 2074 6572 6d69 6e61 6c2e 0a0a 2020 2027 terminal... ' │ │ │ │ │ -00022010: 6d6f 7273 6527 2068 6173 206e 6f20 636f morse' has no co │ │ │ │ │ -00022020: 6c6f 7220 7375 7070 6f72 7420 6174 2061 lor support at a │ │ │ │ │ -00022030: 6c6c 2e0a 0a20 2020 276d 6461 5f74 6578 ll... 'mda_tex │ │ │ │ │ -00022040: 7427 2063 6f6c 6f72 2073 7570 706f 7274 t' color support │ │ │ │ │ -00022050: 2069 7320 6c69 6d69 7465 6420 746f 2068 is limited to h │ │ │ │ │ -00022060: 6967 686c 6967 6874 696e 6720 6279 2062 ighlighting by b │ │ │ │ │ -00022070: 6c61 636b 2f77 6869 7465 0a72 6576 6572 lack/white.rever │ │ │ │ │ -00022080: 7361 6c2e 0a0a 2020 2027 636f 6e73 6f6c sal... 'consol │ │ │ │ │ -00022090: 6527 206f 6e20 4152 432c 2045 4d55 2061 e' on ARC, EMU a │ │ │ │ │ -000220a0: 6e64 2049 4545 4531 3237 352c 2027 7365 nd IEEE1275, 'se │ │ │ │ │ -000220b0: 7269 616c 5f2a 2720 616e 6420 2773 706b rial_*' and 'spk │ │ │ │ │ -000220c0: 6d6f 6465 6d27 2061 7265 0a67 6f76 6572 modem' are.gover │ │ │ │ │ -000220d0: 6e65 6420 6279 2074 6572 6d69 6e66 6f20 ned by terminfo │ │ │ │ │ -000220e0: 616e 6420 7375 7070 6f72 7420 6f6e 6c79 and support only │ │ │ │ │ -000220f0: 2038 2063 6f6c 6f72 7320 6966 2069 6e20 8 colors if in │ │ │ │ │ -00022100: 6d6f 6465 7320 2776 7431 3030 2d63 6f6c modes 'vt100-col │ │ │ │ │ -00022110: 6f72 270a 2864 6566 6175 6c74 2066 6f72 or'.(default for │ │ │ │ │ -00022120: 2063 6f6e 736f 6c65 206f 6e20 656d 7529 console on emu) │ │ │ │ │ -00022130: 2c20 2761 7263 2720 2864 6566 6175 6c74 , 'arc' (default │ │ │ │ │ -00022140: 2066 6f72 2063 6f6e 736f 6c65 206f 6e20 for console on │ │ │ │ │ -00022150: 4152 4329 2c0a 2769 6565 6531 3237 3527 ARC),.'ieee1275' │ │ │ │ │ -00022160: 2028 6465 6661 756c 7420 666f 7220 636f (default for co │ │ │ │ │ -00022170: 6e73 6f6c 6520 6f6e 2049 4545 4531 3237 nsole on IEEE127 │ │ │ │ │ -00022180: 3529 2e20 2057 6865 6e20 696e 206d 6f64 5). When in mod │ │ │ │ │ -00022190: 6520 2776 7431 3030 2720 7468 656e 0a74 e 'vt100' then.t │ │ │ │ │ -000221a0: 6865 2063 6f6c 6f72 2073 7570 706f 7274 he color support │ │ │ │ │ -000221b0: 2069 7320 6c69 6d69 7465 6420 746f 2068 is limited to h │ │ │ │ │ -000221c0: 6967 686c 6967 6874 696e 6720 6279 2062 ighlighting by b │ │ │ │ │ -000221d0: 6c61 636b 2f77 6869 7465 2072 6576 6572 lack/white rever │ │ │ │ │ -000221e0: 7361 6c2e 0a57 6865 6e20 696e 206d 6f64 sal..When in mod │ │ │ │ │ -000221f0: 6520 2764 756d 6227 2074 6865 7265 2069 e 'dumb' there i │ │ │ │ │ -00022200: 7320 6e6f 2063 6f6c 6f72 2073 7570 706f s no color suppo │ │ │ │ │ -00022210: 7274 2e0a 0a20 2020 5768 656e 2063 6f6e rt... When con │ │ │ │ │ -00022220: 736f 6c65 2073 7570 706f 7274 7320 6e6f sole supports no │ │ │ │ │ -00022230: 2063 6f6c 6f72 7320 7468 6973 2073 6574 colors this set │ │ │ │ │ -00022240: 7469 6e67 2069 7320 6967 6e6f 7265 642e ting is ignored. │ │ │ │ │ -00022250: 2020 5768 656e 0a63 6f6e 736f 6c65 2073 When.console s │ │ │ │ │ -00022260: 7570 706f 7274 7320 3820 636f 6c6f 7273 upports 8 colors │ │ │ │ │ -00022270: 2c20 7468 656e 2074 6865 2063 6f6c 6f72 , then the color │ │ │ │ │ -00022280: 7320 6672 6f6d 2074 6865 2073 6563 6f6e s from the secon │ │ │ │ │ -00022290: 6420 6861 6c66 206f 6620 7468 650a 7072 d half of the.pr │ │ │ │ │ -000222a0: 6576 696f 7573 206c 6973 7420 6172 6520 evious list are │ │ │ │ │ -000222b0: 6d61 7070 6564 2074 6f20 7468 6520 6d61 mapped to the ma │ │ │ │ │ -000222c0: 7463 6869 6e67 2063 6f6c 6f72 7320 6f66 tching colors of │ │ │ │ │ -000222d0: 2066 6972 7374 2068 616c 662e 0a0a 2020 first half... │ │ │ │ │ -000222e0: 2027 636f 6e73 6f6c 6527 206f 6e20 4546 'console' on EF │ │ │ │ │ -000222f0: 4920 616e 6420 4249 4f53 2061 6e64 2027 I and BIOS and ' │ │ │ │ │ -00022300: 7667 615f 7465 7874 2720 7375 7070 6f72 vga_text' suppor │ │ │ │ │ -00022310: 7420 616c 6c20 3136 2063 6f6c 6f72 732e t all 16 colors. │ │ │ │ │ -00022320: 0a0a 2020 2027 6766 7874 6572 6d27 2073 .. 'gfxterm' s │ │ │ │ │ -00022330: 7570 706f 7274 7320 616c 6c20 3136 2063 upports all 16 c │ │ │ │ │ -00022340: 6f6c 6f72 7320 616e 6420 776f 756c 6420 olors and would │ │ │ │ │ -00022350: 6265 2074 6865 6f72 6574 6963 616c 6c79 be theoretically │ │ │ │ │ -00022360: 0a65 7874 656e 6461 626c 6520 746f 2073 .extendable to s │ │ │ │ │ -00022370: 7570 706f 7274 2077 686f 6c65 2072 6762 upport whole rgb │ │ │ │ │ -00022380: 3234 2070 616c 6574 7465 2062 7574 2063 24 palette but c │ │ │ │ │ -00022390: 7572 7265 6e74 6c79 2074 6865 7265 2069 urrently there i │ │ │ │ │ -000223a0: 7320 6e6f 0a63 6f6d 7065 6c6c 696e 6720 s no.compelling │ │ │ │ │ -000223b0: 7265 6173 6f6e 2074 6f20 676f 2062 6579 reason to go bey │ │ │ │ │ -000223c0: 6f6e 6420 7468 6520 6375 7272 656e 7420 ond the current │ │ │ │ │ -000223d0: 3136 2063 6f6c 6f72 732e 0a0a 1f0a 4669 16 colors.....Fi │ │ │ │ │ -000223e0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -000223f0: 4e6f 6465 3a20 636f 6e66 6967 5f64 6972 Node: config_dir │ │ │ │ │ -00022400: 6563 746f 7279 2c20 204e 6578 743a 2063 ectory, Next: c │ │ │ │ │ -00022410: 6f6e 6669 675f 6669 6c65 2c20 2050 7265 onfig_file, Pre │ │ │ │ │ -00022420: 763a 2063 6f6c 6f72 5f6e 6f72 6d61 6c2c v: color_normal, │ │ │ │ │ -00022430: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ │ -00022440: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ -00022450: 6c65 730a 0a31 352e 312e 3720 636f 6e66 les..15.1.7 conf │ │ │ │ │ -00022460: 6967 5f64 6972 6563 746f 7279 0a2d 2d2d ig_directory.--- │ │ │ │ │ +00021e00: 2d2d 2d0a 0a54 6869 7320 7661 7269 6162 ---..This variab │ │ │ │ │ +00021e10: 6c65 2063 6f6e 7461 696e 7320 7468 6520 le contains the │ │ │ │ │ +00021e20: 226e 6f72 6d61 6c22 2066 6f72 6567 726f "normal" foregro │ │ │ │ │ +00021e30: 756e 6420 616e 6420 6261 636b 6772 6f75 und and backgrou │ │ │ │ │ +00021e40: 6e64 2074 6572 6d69 6e61 6c0a 636f 6c6f nd terminal.colo │ │ │ │ │ +00021e50: 7273 2c20 7365 7061 7261 7465 6420 6279 rs, separated by │ │ │ │ │ +00021e60: 2061 2073 6c61 7368 2028 272f 2729 2e20 a slash ('/'). │ │ │ │ │ +00021e70: 2053 6574 7469 6e67 2074 6869 7320 7661 Setting this va │ │ │ │ │ +00021e80: 7269 6162 6c65 2063 6861 6e67 6573 2074 riable changes t │ │ │ │ │ +00021e90: 686f 7365 0a63 6f6c 6f72 732e 2020 4561 hose.colors. Ea │ │ │ │ │ +00021ea0: 6368 2063 6f6c 6f72 206d 7573 7420 6265 ch color must be │ │ │ │ │ +00021eb0: 2061 206e 616d 6520 6672 6f6d 2074 6865 a name from the │ │ │ │ │ +00021ec0: 2066 6f6c 6c6f 7769 6e67 206c 6973 743a following list: │ │ │ │ │ +00021ed0: 0a0a 2020 202a 2062 6c61 636b 0a20 2020 .. * black. │ │ │ │ │ +00021ee0: 2a20 626c 7565 0a20 2020 2a20 6772 6565 * blue. * gree │ │ │ │ │ +00021ef0: 6e0a 2020 202a 2063 7961 6e0a 2020 202a n. * cyan. * │ │ │ │ │ +00021f00: 2072 6564 0a20 2020 2a20 6d61 6765 6e74 red. * magent │ │ │ │ │ +00021f10: 610a 2020 202a 2062 726f 776e 0a20 2020 a. * brown. │ │ │ │ │ +00021f20: 2a20 6c69 6768 742d 6772 6179 0a20 2020 * light-gray. │ │ │ │ │ +00021f30: 2a20 6461 726b 2d67 7261 790a 2020 202a * dark-gray. * │ │ │ │ │ +00021f40: 206c 6967 6874 2d62 6c75 650a 2020 202a light-blue. * │ │ │ │ │ +00021f50: 206c 6967 6874 2d67 7265 656e 0a20 2020 light-green. │ │ │ │ │ +00021f60: 2a20 6c69 6768 742d 6379 616e 0a20 2020 * light-cyan. │ │ │ │ │ +00021f70: 2a20 6c69 6768 742d 7265 640a 2020 202a * light-red. * │ │ │ │ │ +00021f80: 206c 6967 6874 2d6d 6167 656e 7461 0a20 light-magenta. │ │ │ │ │ +00021f90: 2020 2a20 7965 6c6c 6f77 0a20 2020 2a20 * yellow. * │ │ │ │ │ +00021fa0: 7768 6974 650a 0a20 2020 5468 6520 6465 white.. The de │ │ │ │ │ +00021fb0: 6661 756c 7420 6973 2027 6c69 6768 742d fault is 'light- │ │ │ │ │ +00021fc0: 6772 6179 2f62 6c61 636b 272e 0a0a 2020 gray/black'... │ │ │ │ │ +00021fd0: 2054 6865 2063 6f6c 6f72 2073 7570 706f The color suppo │ │ │ │ │ +00021fe0: 7274 2073 7570 706f 7274 2076 6172 6965 rt support varie │ │ │ │ │ +00021ff0: 7320 6672 6f6d 2074 6572 6d69 6e61 6c20 s from terminal │ │ │ │ │ +00022000: 746f 2074 6572 6d69 6e61 6c2e 0a0a 2020 to terminal... │ │ │ │ │ +00022010: 2027 6d6f 7273 6527 2068 6173 206e 6f20 'morse' has no │ │ │ │ │ +00022020: 636f 6c6f 7220 7375 7070 6f72 7420 6174 color support at │ │ │ │ │ +00022030: 2061 6c6c 2e0a 0a20 2020 276d 6461 5f74 all... 'mda_t │ │ │ │ │ +00022040: 6578 7427 2063 6f6c 6f72 2073 7570 706f ext' color suppo │ │ │ │ │ +00022050: 7274 2069 7320 6c69 6d69 7465 6420 746f rt is limited to │ │ │ │ │ +00022060: 2068 6967 686c 6967 6874 696e 6720 6279 highlighting by │ │ │ │ │ +00022070: 2062 6c61 636b 2f77 6869 7465 0a72 6576 black/white.rev │ │ │ │ │ +00022080: 6572 7361 6c2e 0a0a 2020 2027 636f 6e73 ersal... 'cons │ │ │ │ │ +00022090: 6f6c 6527 206f 6e20 4152 432c 2045 4d55 ole' on ARC, EMU │ │ │ │ │ +000220a0: 2061 6e64 2049 4545 4531 3237 352c 2027 and IEEE1275, ' │ │ │ │ │ +000220b0: 7365 7269 616c 5f2a 2720 616e 6420 2773 serial_*' and 's │ │ │ │ │ +000220c0: 706b 6d6f 6465 6d27 2061 7265 0a67 6f76 pkmodem' are.gov │ │ │ │ │ +000220d0: 6572 6e65 6420 6279 2074 6572 6d69 6e66 erned by terminf │ │ │ │ │ +000220e0: 6f20 616e 6420 7375 7070 6f72 7420 6f6e o and support on │ │ │ │ │ +000220f0: 6c79 2038 2063 6f6c 6f72 7320 6966 2069 ly 8 colors if i │ │ │ │ │ +00022100: 6e20 6d6f 6465 7320 2776 7431 3030 2d63 n modes 'vt100-c │ │ │ │ │ +00022110: 6f6c 6f72 270a 2864 6566 6175 6c74 2066 olor'.(default f │ │ │ │ │ +00022120: 6f72 2063 6f6e 736f 6c65 206f 6e20 656d or console on em │ │ │ │ │ +00022130: 7529 2c20 2761 7263 2720 2864 6566 6175 u), 'arc' (defau │ │ │ │ │ +00022140: 6c74 2066 6f72 2063 6f6e 736f 6c65 206f lt for console o │ │ │ │ │ +00022150: 6e20 4152 4329 2c0a 2769 6565 6531 3237 n ARC),.'ieee127 │ │ │ │ │ +00022160: 3527 2028 6465 6661 756c 7420 666f 7220 5' (default for │ │ │ │ │ +00022170: 636f 6e73 6f6c 6520 6f6e 2049 4545 4531 console on IEEE1 │ │ │ │ │ +00022180: 3237 3529 2e20 2057 6865 6e20 696e 206d 275). When in m │ │ │ │ │ +00022190: 6f64 6520 2776 7431 3030 2720 7468 656e ode 'vt100' then │ │ │ │ │ +000221a0: 0a74 6865 2063 6f6c 6f72 2073 7570 706f .the color suppo │ │ │ │ │ +000221b0: 7274 2069 7320 6c69 6d69 7465 6420 746f rt is limited to │ │ │ │ │ +000221c0: 2068 6967 686c 6967 6874 696e 6720 6279 highlighting by │ │ │ │ │ +000221d0: 2062 6c61 636b 2f77 6869 7465 2072 6576 black/white rev │ │ │ │ │ +000221e0: 6572 7361 6c2e 0a57 6865 6e20 696e 206d ersal..When in m │ │ │ │ │ +000221f0: 6f64 6520 2764 756d 6227 2074 6865 7265 ode 'dumb' there │ │ │ │ │ +00022200: 2069 7320 6e6f 2063 6f6c 6f72 2073 7570 is no color sup │ │ │ │ │ +00022210: 706f 7274 2e0a 0a20 2020 5768 656e 2063 port... When c │ │ │ │ │ +00022220: 6f6e 736f 6c65 2073 7570 706f 7274 7320 onsole supports │ │ │ │ │ +00022230: 6e6f 2063 6f6c 6f72 7320 7468 6973 2073 no colors this s │ │ │ │ │ +00022240: 6574 7469 6e67 2069 7320 6967 6e6f 7265 etting is ignore │ │ │ │ │ +00022250: 642e 2020 5768 656e 0a63 6f6e 736f 6c65 d. When.console │ │ │ │ │ +00022260: 2073 7570 706f 7274 7320 3820 636f 6c6f supports 8 colo │ │ │ │ │ +00022270: 7273 2c20 7468 656e 2074 6865 2063 6f6c rs, then the col │ │ │ │ │ +00022280: 6f72 7320 6672 6f6d 2074 6865 2073 6563 ors from the sec │ │ │ │ │ +00022290: 6f6e 6420 6861 6c66 206f 6620 7468 650a ond half of the. │ │ │ │ │ +000222a0: 7072 6576 696f 7573 206c 6973 7420 6172 previous list ar │ │ │ │ │ +000222b0: 6520 6d61 7070 6564 2074 6f20 7468 6520 e mapped to the │ │ │ │ │ +000222c0: 6d61 7463 6869 6e67 2063 6f6c 6f72 7320 matching colors │ │ │ │ │ +000222d0: 6f66 2066 6972 7374 2068 616c 662e 0a0a of first half... │ │ │ │ │ +000222e0: 2020 2027 636f 6e73 6f6c 6527 206f 6e20 'console' on │ │ │ │ │ +000222f0: 4546 4920 616e 6420 4249 4f53 2061 6e64 EFI and BIOS and │ │ │ │ │ +00022300: 2027 7667 615f 7465 7874 2720 7375 7070 'vga_text' supp │ │ │ │ │ +00022310: 6f72 7420 616c 6c20 3136 2063 6f6c 6f72 ort all 16 color │ │ │ │ │ +00022320: 732e 0a0a 2020 2027 6766 7874 6572 6d27 s... 'gfxterm' │ │ │ │ │ +00022330: 2073 7570 706f 7274 7320 616c 6c20 3136 supports all 16 │ │ │ │ │ +00022340: 2063 6f6c 6f72 7320 616e 6420 776f 756c colors and woul │ │ │ │ │ +00022350: 6420 6265 2074 6865 6f72 6574 6963 616c d be theoretical │ │ │ │ │ +00022360: 6c79 0a65 7874 656e 6461 626c 6520 746f ly.extendable to │ │ │ │ │ +00022370: 2073 7570 706f 7274 2077 686f 6c65 2072 support whole r │ │ │ │ │ +00022380: 6762 3234 2070 616c 6574 7465 2062 7574 gb24 palette but │ │ │ │ │ +00022390: 2063 7572 7265 6e74 6c79 2074 6865 7265 currently there │ │ │ │ │ +000223a0: 2069 7320 6e6f 0a63 6f6d 7065 6c6c 696e is no.compellin │ │ │ │ │ +000223b0: 6720 7265 6173 6f6e 2074 6f20 676f 2062 g reason to go b │ │ │ │ │ +000223c0: 6579 6f6e 6420 7468 6520 6375 7272 656e eyond the curren │ │ │ │ │ +000223d0: 7420 3136 2063 6f6c 6f72 732e 0a0a 1f0a t 16 colors..... │ │ │ │ │ +000223e0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +000223f0: 2020 4e6f 6465 3a20 636f 6e66 6967 5f64 Node: config_d │ │ │ │ │ +00022400: 6972 6563 746f 7279 2c20 204e 6578 743a irectory, Next: │ │ │ │ │ +00022410: 2063 6f6e 6669 675f 6669 6c65 2c20 2050 config_file, P │ │ │ │ │ +00022420: 7265 763a 2063 6f6c 6f72 5f6e 6f72 6d61 rev: color_norma │ │ │ │ │ +00022430: 6c2c 2020 5570 3a20 5370 6563 6961 6c20 l, Up: Special │ │ │ │ │ +00022440: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ +00022450: 6162 6c65 730a 0a31 352e 312e 3720 636f ables..15.1.7 co │ │ │ │ │ +00022460: 6e66 6967 5f64 6972 6563 746f 7279 0a2d nfig_directory.- │ │ │ │ │ 00022470: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00022480: 2d2d 2d2d 0a0a 5468 6973 2076 6172 6961 ----..This varia │ │ │ │ │ -00022490: 626c 6520 6973 2061 7574 6f6d 6174 6963 ble is automatic │ │ │ │ │ -000224a0: 616c 6c79 2073 6574 2062 7920 4752 5542 ally set by GRUB │ │ │ │ │ -000224b0: 2074 6f20 7468 6520 6469 7265 6374 6f72 to the director │ │ │ │ │ -000224c0: 7920 7061 7274 206f 660a 6375 7272 656e y part of.curren │ │ │ │ │ -000224d0: 7420 636f 6e66 6967 7572 6174 696f 6e20 t configuration │ │ │ │ │ -000224e0: 6669 6c65 206e 616d 6520 282a 6e6f 7465 file name (*note │ │ │ │ │ -000224f0: 2063 6f6e 6669 675f 6669 6c65 3a3a 292e config_file::). │ │ │ │ │ -00022500: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00022510: 6e66 6f2c 2020 4e6f 6465 3a20 636f 6e66 nfo, Node: conf │ │ │ │ │ -00022520: 6967 5f66 696c 652c 2020 4e65 7874 3a20 ig_file, Next: │ │ │ │ │ -00022530: 6465 6275 672c 2020 5072 6576 3a20 636f debug, Prev: co │ │ │ │ │ -00022540: 6e66 6967 5f64 6972 6563 746f 7279 2c20 nfig_directory, │ │ │ │ │ -00022550: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ -00022560: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -00022570: 6573 0a0a 3135 2e31 2e38 2063 6f6e 6669 es..15.1.8 confi │ │ │ │ │ -00022580: 675f 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d g_file.--------- │ │ │ │ │ -00022590: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6869 7320 ---------..This │ │ │ │ │ -000225a0: 7661 7269 6162 6c65 2069 7320 6175 746f variable is auto │ │ │ │ │ -000225b0: 6d61 7469 6361 6c6c 7920 7365 7420 6279 matically set by │ │ │ │ │ -000225c0: 2047 5255 4220 746f 2074 6865 206e 616d GRUB to the nam │ │ │ │ │ -000225d0: 6520 6f66 2063 6f6e 6669 6775 7261 7469 e of configurati │ │ │ │ │ -000225e0: 6f6e 0a66 696c 6520 7468 6174 2069 7320 on.file that is │ │ │ │ │ -000225f0: 6265 696e 6720 7072 6f63 6573 7365 6420 being processed │ │ │ │ │ -00022600: 6279 2063 6f6d 6d61 6e64 7320 2763 6f6e by commands 'con │ │ │ │ │ -00022610: 6669 6766 696c 6527 2028 2a6e 6f74 650a figfile' (*note. │ │ │ │ │ -00022620: 636f 6e66 6967 6669 6c65 3a3a 2920 6f72 configfile::) or │ │ │ │ │ -00022630: 2027 6e6f 726d 616c 2720 282a 6e6f 7465 'normal' (*note │ │ │ │ │ -00022640: 206e 6f72 6d61 6c3a 3a29 2e20 2049 7420 normal::). It │ │ │ │ │ -00022650: 6973 2072 6573 746f 7265 6420 746f 2074 is restored to t │ │ │ │ │ -00022660: 6865 0a70 7265 7669 6f75 7320 7661 6c75 he.previous valu │ │ │ │ │ -00022670: 6520 7768 656e 2063 6f6d 6d61 6e64 2063 e when command c │ │ │ │ │ -00022680: 6f6d 706c 6574 6573 2e0a 0a1f 0a46 696c ompletes.....Fil │ │ │ │ │ -00022690: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -000226a0: 6f64 653a 2064 6562 7567 2c20 204e 6578 ode: debug, Nex │ │ │ │ │ -000226b0: 743a 2064 6566 6175 6c74 2c20 2050 7265 t: default, Pre │ │ │ │ │ -000226c0: 763a 2063 6f6e 6669 675f 6669 6c65 2c20 v: config_file, │ │ │ │ │ -000226d0: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ -000226e0: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -000226f0: 6573 0a0a 3135 2e31 2e39 2064 6562 7567 es..15.1.9 debug │ │ │ │ │ -00022700: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 .------------..T │ │ │ │ │ -00022710: 6869 7320 7661 7269 6162 6c65 206d 6179 his variable may │ │ │ │ │ -00022720: 2062 6520 7365 7420 746f 2065 6e61 626c be set to enabl │ │ │ │ │ -00022730: 6520 6465 6275 6767 696e 6720 6f75 7470 e debugging outp │ │ │ │ │ -00022740: 7574 2066 726f 6d20 7661 7269 6f75 730a ut from various. │ │ │ │ │ -00022750: 636f 6d70 6f6e 656e 7473 206f 6620 4752 components of GR │ │ │ │ │ -00022760: 5542 2e20 5468 6520 7661 6c75 6520 6973 UB. The value is │ │ │ │ │ -00022770: 2061 206c 6973 7420 6f66 2064 6562 7567 a list of debug │ │ │ │ │ -00022780: 2066 6163 696c 6974 7920 6e61 6d65 730a facility names. │ │ │ │ │ -00022790: 7365 7061 7261 7465 6420 6279 2077 6869 separated by whi │ │ │ │ │ -000227a0: 7465 7370 6163 6520 6f72 2027 2c27 2c20 tespace or ',', │ │ │ │ │ -000227b0: 6f72 2027 616c 6c27 2074 6f20 656e 6162 or 'all' to enab │ │ │ │ │ -000227c0: 6c65 2061 6c6c 2061 7661 696c 6162 6c65 le all available │ │ │ │ │ -000227d0: 0a64 6562 7567 6769 6e67 206f 7574 7075 .debugging outpu │ │ │ │ │ -000227e0: 742e 2020 5468 6520 6661 6369 6c69 7479 t. The facility │ │ │ │ │ -000227f0: 206e 616d 6573 2061 7265 2074 6865 2066 names are the f │ │ │ │ │ -00022800: 6972 7374 2061 7267 756d 656e 7420 746f irst argument to │ │ │ │ │ -00022810: 0a67 7275 625f 6470 7269 6e74 662e 2020 .grub_dprintf. │ │ │ │ │ -00022820: 436f 6e73 756c 7420 736f 7572 6365 2066 Consult source f │ │ │ │ │ -00022830: 6f72 206d 6f72 6520 6465 7461 696c 732e or more details. │ │ │ │ │ -00022840: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00022850: 6e66 6f2c 2020 4e6f 6465 3a20 6465 6661 nfo, Node: defa │ │ │ │ │ -00022860: 756c 742c 2020 4e65 7874 3a20 6661 6c6c ult, Next: fall │ │ │ │ │ -00022870: 6261 636b 2c20 2050 7265 763a 2064 6562 back, Prev: deb │ │ │ │ │ -00022880: 7567 2c20 2055 703a 2053 7065 6369 616c ug, Up: Special │ │ │ │ │ -00022890: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -000228a0: 6961 626c 6573 0a0a 3135 2e31 2e31 3020 iables..15.1.10 │ │ │ │ │ -000228b0: 6465 6661 756c 740a 2d2d 2d2d 2d2d 2d2d default.-------- │ │ │ │ │ -000228c0: 2d2d 2d2d 2d2d 2d0a 0a49 6620 7468 6973 -------..If this │ │ │ │ │ -000228d0: 2076 6172 6961 626c 6520 6973 2073 6574 variable is set │ │ │ │ │ -000228e0: 2c20 6974 2069 6465 6e74 6966 6965 7320 , it identifies │ │ │ │ │ -000228f0: 6120 6d65 6e75 2065 6e74 7279 2074 6861 a menu entry tha │ │ │ │ │ -00022900: 7420 7368 6f75 6c64 2062 650a 7365 6c65 t should be.sele │ │ │ │ │ -00022910: 6374 6564 2062 7920 6465 6661 756c 742c cted by default, │ │ │ │ │ -00022920: 2070 6f73 7369 626c 7920 6166 7465 7220 possibly after │ │ │ │ │ -00022930: 6120 7469 6d65 6f75 7420 282a 6e6f 7465 a timeout (*note │ │ │ │ │ -00022940: 2074 696d 656f 7574 3a3a 292e 2020 5468 timeout::). Th │ │ │ │ │ -00022950: 650a 656e 7472 7920 6d61 7920 6265 2069 e.entry may be i │ │ │ │ │ -00022960: 6465 6e74 6966 6965 6420 6279 206e 756d dentified by num │ │ │ │ │ -00022970: 6265 7220 2873 7461 7274 696e 6720 6672 ber (starting fr │ │ │ │ │ -00022980: 6f6d 2030 2061 7420 6561 6368 206c 6576 om 0 at each lev │ │ │ │ │ -00022990: 656c 206f 6620 7468 650a 6869 6572 6172 el of the.hierar │ │ │ │ │ -000229a0: 6368 7929 2c20 6279 2074 6974 6c65 2c20 chy), by title, │ │ │ │ │ -000229b0: 6f72 2062 7920 6964 2e0a 0a20 2020 466f or by id... Fo │ │ │ │ │ -000229c0: 7220 6578 616d 706c 652c 2069 6620 796f r example, if yo │ │ │ │ │ -000229d0: 7520 6861 7665 3a0a 0a6d 656e 7565 6e74 u have:..menuent │ │ │ │ │ -000229e0: 7279 2027 4578 616d 706c 6520 474e 552f ry 'Example GNU/ │ │ │ │ │ -000229f0: 4c69 6e75 7820 6469 7374 7269 6275 7469 Linux distributi │ │ │ │ │ -00022a00: 6f6e 2720 2d2d 636c 6173 7320 676e 752d on' --class gnu- │ │ │ │ │ -00022a10: 6c69 6e75 7820 2d2d 6964 2065 7861 6d70 linux --id examp │ │ │ │ │ -00022a20: 6c65 2d67 6e75 2d6c 696e 7578 207b 0a09 le-gnu-linux {.. │ │ │ │ │ -00022a30: 2e2e 2e0a 7d0a 0a20 2020 7468 656e 2079 ....}.. then y │ │ │ │ │ -00022a40: 6f75 2063 616e 206d 616b 6520 7468 6973 ou can make this │ │ │ │ │ -00022a50: 2074 6865 2064 6566 6175 6c74 2075 7369 the default usi │ │ │ │ │ -00022a60: 6e67 3a0a 0a20 2020 2020 6465 6661 756c ng:.. defaul │ │ │ │ │ -00022a70: 743d 6578 616d 706c 652d 676e 752d 6c69 t=example-gnu-li │ │ │ │ │ -00022a80: 6e75 780a 0a20 2020 4966 2074 6865 2065 nux.. If the e │ │ │ │ │ -00022a90: 6e74 7279 2069 7320 696e 2061 2073 7562 ntry is in a sub │ │ │ │ │ -00022aa0: 6d65 6e75 2c20 7468 656e 2069 7420 6d75 menu, then it mu │ │ │ │ │ -00022ab0: 7374 2062 6520 6964 656e 7469 6669 6564 st be identified │ │ │ │ │ -00022ac0: 2075 7369 6e67 2074 6865 0a6e 756d 6265 using the.numbe │ │ │ │ │ -00022ad0: 722c 2074 6974 6c65 2c20 6f72 2069 6420 r, title, or id │ │ │ │ │ -00022ae0: 6f66 2065 6163 6820 6f66 2074 6865 2073 of each of the s │ │ │ │ │ -00022af0: 7562 6d65 6e75 7320 7374 6172 7469 6e67 ubmenus starting │ │ │ │ │ -00022b00: 2066 726f 6d20 7468 6520 746f 700a 6c65 from the top.le │ │ │ │ │ -00022b10: 7665 6c2c 2066 6f6c 6c6f 7765 6420 6279 vel, followed by │ │ │ │ │ -00022b20: 2074 6865 206e 756d 6265 722c 2074 6974 the number, tit │ │ │ │ │ -00022b30: 6c65 2c20 6f72 2069 6420 6f66 2074 6865 le, or id of the │ │ │ │ │ -00022b40: 206d 656e 7520 656e 7472 7920 6974 7365 menu entry itse │ │ │ │ │ -00022b50: 6c66 2c0a 7769 7468 2065 6163 6820 656c lf,.with each el │ │ │ │ │ -00022b60: 656d 656e 7420 7365 7061 7261 7465 6420 ement separated │ │ │ │ │ -00022b70: 6279 2027 3e27 2e20 2046 6f72 2065 7861 by '>'. For exa │ │ │ │ │ -00022b80: 6d70 6c65 2c20 7461 6b65 2074 6865 2066 mple, take the f │ │ │ │ │ -00022b90: 6f6c 6c6f 7769 6e67 0a6d 656e 7520 7374 ollowing.menu st │ │ │ │ │ -00022ba0: 7275 6374 7572 653a 0a0a 2020 2020 2047 ructure:.. G │ │ │ │ │ -00022bb0: 4e55 2f48 7572 6420 2d2d 6964 2067 6e75 NU/Hurd --id gnu │ │ │ │ │ -00022bc0: 2d68 7572 640a 2020 2020 2020 2053 7461 -hurd. Sta │ │ │ │ │ -00022bd0: 6e64 6172 6420 426f 6f74 202d 2d69 643d ndard Boot --id= │ │ │ │ │ -00022be0: 676e 752d 6875 7264 2d73 7464 0a20 2020 gnu-hurd-std. │ │ │ │ │ -00022bf0: 2020 2020 5265 7363 7565 2073 6865 6c6c Rescue shell │ │ │ │ │ -00022c00: 202d 2d69 643d 676e 752d 6875 7264 2d72 --id=gnu-hurd-r │ │ │ │ │ -00022c10: 6573 6375 650a 2020 2020 204f 7468 6572 escue. Other │ │ │ │ │ -00022c20: 2070 6c61 7466 6f72 6d73 202d 2d69 643d platforms --id= │ │ │ │ │ -00022c30: 6f74 6865 720a 2020 2020 2020 204d 696e other. Min │ │ │ │ │ -00022c40: 6978 202d 2d69 643d 6d69 6e69 780a 2020 ix --id=minix. │ │ │ │ │ -00022c50: 2020 2020 2020 2056 6572 7369 6f6e 2033 Version 3 │ │ │ │ │ -00022c60: 2e34 2e30 202d 2d69 643d 6d69 6e69 782d .4.0 --id=minix- │ │ │ │ │ -00022c70: 332e 342e 300a 2020 2020 2020 2020 2056 3.4.0. V │ │ │ │ │ -00022c80: 6572 7369 6f6e 2033 2e33 2e30 202d 2d69 ersion 3.3.0 --i │ │ │ │ │ -00022c90: 643d 6d69 6e69 782d 332e 332e 300a 2020 d=minix-3.3.0. │ │ │ │ │ -00022ca0: 2020 2020 2047 5255 4220 496e 7661 6465 GRUB Invade │ │ │ │ │ -00022cb0: 7273 202d 2d69 643d 6772 7562 2d69 6e76 rs --id=grub-inv │ │ │ │ │ -00022cc0: 6164 6572 730a 0a20 2020 5468 6520 6d6f aders.. The mo │ │ │ │ │ -00022cd0: 7265 2072 6563 656e 7420 7265 6c65 6173 re recent releas │ │ │ │ │ -00022ce0: 6520 6f66 204d 696e 6978 2077 6f75 6c64 e of Minix would │ │ │ │ │ -00022cf0: 2074 6865 6e20 6265 2069 6465 6e74 6966 then be identif │ │ │ │ │ -00022d00: 6965 6420 6173 2027 4f74 6865 720a 706c ied as 'Other.pl │ │ │ │ │ -00022d10: 6174 666f 726d 733e 4d69 6e69 783e 5665 atforms>Minix>Ve │ │ │ │ │ -00022d20: 7273 696f 6e20 332e 342e 3027 2c20 6f72 rsion 3.4.0', or │ │ │ │ │ -00022d30: 2061 7320 2731 3e30 3e30 272c 206f 7220 as '1>0>0', or │ │ │ │ │ -00022d40: 6173 0a27 6f74 6865 723e 6d69 6e69 783e as.'other>minix> │ │ │ │ │ -00022d50: 6d69 6e69 782d 332e 342e 3027 2e0a 0a20 minix-3.4.0'... │ │ │ │ │ -00022d60: 2020 5468 6973 2076 6172 6961 626c 6520 This variable │ │ │ │ │ -00022d70: 6973 206f 6674 656e 2073 6574 2062 7920 is often set by │ │ │ │ │ -00022d80: 2747 5255 425f 4445 4641 554c 5427 2028 'GRUB_DEFAULT' ( │ │ │ │ │ -00022d90: 2a6e 6f74 6520 5369 6d70 6c65 0a63 6f6e *note Simple.con │ │ │ │ │ -00022da0: 6669 6775 7261 7469 6f6e 3a3a 292c 2027 figuration::), ' │ │ │ │ │ -00022db0: 6772 7562 2d73 6574 2d64 6566 6175 6c74 grub-set-default │ │ │ │ │ -00022dc0: 272c 206f 7220 2767 7275 622d 7265 626f ', or 'grub-rebo │ │ │ │ │ -00022dd0: 6f74 272e 0a0a 1f0a 4669 6c65 3a20 6772 ot'.....File: gr │ │ │ │ │ -00022de0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00022df0: 6661 6c6c 6261 636b 2c20 204e 6578 743a fallback, Next: │ │ │ │ │ -00022e00: 2067 6678 6d6f 6465 2c20 2050 7265 763a gfxmode, Prev: │ │ │ │ │ -00022e10: 2064 6566 6175 6c74 2c20 2055 703a 2053 default, Up: S │ │ │ │ │ -00022e20: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ -00022e30: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ │ -00022e40: 2e31 2e31 3120 6661 6c6c 6261 636b 0a2d .1.11 fallback.- │ │ │ │ │ -00022e50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -00022e60: 0a49 6620 7468 6973 2076 6172 6961 626c .If this variabl │ │ │ │ │ -00022e70: 6520 6973 2073 6574 2c20 6974 2069 6465 e is set, it ide │ │ │ │ │ -00022e80: 6e74 6966 6965 7320 6120 6d65 6e75 2065 ntifies a menu e │ │ │ │ │ -00022e90: 6e74 7279 2074 6861 7420 7368 6f75 6c64 ntry that should │ │ │ │ │ -00022ea0: 2062 650a 7365 6c65 6374 6564 2069 6620 be.selected if │ │ │ │ │ -00022eb0: 7468 6520 6465 6661 756c 7420 6d65 6e75 the default menu │ │ │ │ │ -00022ec0: 2065 6e74 7279 2066 6169 6c73 2074 6f20 entry fails to │ │ │ │ │ -00022ed0: 626f 6f74 2e20 2045 6e74 7269 6573 2061 boot. Entries a │ │ │ │ │ -00022ee0: 7265 0a69 6465 6e74 6966 6965 6420 696e re.identified in │ │ │ │ │ -00022ef0: 2074 6865 2073 616d 6520 7761 7920 6173 the same way as │ │ │ │ │ -00022f00: 2066 6f72 2027 6465 6661 756c 7427 2028 for 'default' ( │ │ │ │ │ -00022f10: 2a6e 6f74 6520 6465 6661 756c 743a 3a29 *note default::) │ │ │ │ │ -00022f20: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00022f30: 696e 666f 2c20 204e 6f64 653a 2067 6678 info, Node: gfx │ │ │ │ │ -00022f40: 6d6f 6465 2c20 204e 6578 743a 2067 6678 mode, Next: gfx │ │ │ │ │ -00022f50: 7061 796c 6f61 642c 2020 5072 6576 3a20 payload, Prev: │ │ │ │ │ -00022f60: 6661 6c6c 6261 636b 2c20 2055 703a 2053 fallback, Up: S │ │ │ │ │ -00022f70: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ -00022f80: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ │ -00022f90: 2e31 2e31 3220 6766 786d 6f64 650a 2d2d .1.12 gfxmode.-- │ │ │ │ │ -00022fa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 -------------..I │ │ │ │ │ -00022fb0: 6620 7468 6973 2076 6172 6961 626c 6520 f this variable │ │ │ │ │ -00022fc0: 6973 2073 6574 2c20 6974 2073 6574 7320 is set, it sets │ │ │ │ │ -00022fd0: 7468 6520 7265 736f 6c75 7469 6f6e 2075 the resolution u │ │ │ │ │ -00022fe0: 7365 6420 6f6e 2074 6865 2027 6766 7874 sed on the 'gfxt │ │ │ │ │ -00022ff0: 6572 6d27 0a67 7261 7068 6963 616c 2074 erm'.graphical t │ │ │ │ │ -00023000: 6572 6d69 6e61 6c2e 2020 4e6f 7465 2074 erminal. Note t │ │ │ │ │ -00023010: 6861 7420 796f 7520 6361 6e20 6f6e 6c79 hat you can only │ │ │ │ │ -00023020: 2075 7365 206d 6f64 6573 2077 6869 6368 use modes which │ │ │ │ │ -00023030: 2079 6f75 720a 6772 6170 6869 6373 2063 your.graphics c │ │ │ │ │ -00023040: 6172 6420 7375 7070 6f72 7473 2076 6961 ard supports via │ │ │ │ │ -00023050: 2056 4553 4120 4249 4f53 2045 7874 656e VESA BIOS Exten │ │ │ │ │ -00023060: 7369 6f6e 7320 2856 4245 292c 2073 6f20 sions (VBE), so │ │ │ │ │ -00023070: 666f 7220 6578 616d 706c 650a 6e61 7469 for example.nati │ │ │ │ │ -00023080: 7665 204c 4344 2070 616e 656c 2072 6573 ve LCD panel res │ │ │ │ │ -00023090: 6f6c 7574 696f 6e73 206d 6179 206e 6f74 olutions may not │ │ │ │ │ -000230a0: 2062 6520 6176 6169 6c61 626c 652e 2020 be available. │ │ │ │ │ -000230b0: 5468 6520 6465 6661 756c 7420 6973 0a27 The default is.' │ │ │ │ │ -000230c0: 6175 746f 272c 2077 6869 6368 2073 656c auto', which sel │ │ │ │ │ -000230d0: 6563 7473 2061 2070 6c61 7466 6f72 6d2d ects a platform- │ │ │ │ │ -000230e0: 7370 6563 6966 6963 2064 6566 6175 6c74 specific default │ │ │ │ │ -000230f0: 2074 6861 7420 7368 6f75 6c64 206c 6f6f that should loo │ │ │ │ │ -00023100: 6b0a 7265 6173 6f6e 6162 6c65 2e20 2053 k.reasonable. S │ │ │ │ │ -00023110: 7570 706f 7274 6564 206d 6f64 6573 2063 upported modes c │ │ │ │ │ -00023120: 616e 2062 6520 6c69 7374 6564 2062 7920 an be listed by │ │ │ │ │ -00023130: 2776 6964 656f 696e 666f 2720 636f 6d6d 'videoinfo' comm │ │ │ │ │ -00023140: 616e 6420 696e 0a47 5255 422e 0a0a 2020 and in.GRUB... │ │ │ │ │ -00023150: 2054 6865 2072 6573 6f6c 7574 696f 6e20 The resolution │ │ │ │ │ -00023160: 6d61 7920 6265 2073 7065 6369 6669 6564 may be specified │ │ │ │ │ -00023170: 2061 7320 6120 7365 7175 656e 6365 206f as a sequence o │ │ │ │ │ -00023180: 6620 6f6e 6520 6f72 206d 6f72 6520 6d6f f one or more mo │ │ │ │ │ -00023190: 6465 732c 0a73 6570 6172 6174 6564 2062 des,.separated b │ │ │ │ │ -000231a0: 7920 636f 6d6d 6173 2028 272c 2729 206f y commas (',') o │ │ │ │ │ -000231b0: 7220 7365 6d69 636f 6c6f 6e73 2028 273b r semicolons ('; │ │ │ │ │ -000231c0: 2729 3b20 6561 6368 2077 696c 6c20 6265 '); each will be │ │ │ │ │ -000231d0: 2074 7269 6564 2069 6e0a 7475 726e 2075 tried in.turn u │ │ │ │ │ -000231e0: 6e74 696c 206f 6e65 2069 7320 666f 756e ntil one is foun │ │ │ │ │ -000231f0: 642e 2020 4561 6368 206d 6f64 6520 7368 d. Each mode sh │ │ │ │ │ -00023200: 6f75 6c64 2062 6520 6569 7468 6572 2027 ould be either ' │ │ │ │ │ -00023210: 6175 746f 272c 0a27 5749 4454 4878 4845 auto',.'WIDTHxHE │ │ │ │ │ -00023220: 4947 4854 272c 206f 7220 2757 4944 5448 IGHT', or 'WIDTH │ │ │ │ │ -00023230: 7848 4549 4748 5478 4445 5054 4827 2e0a xHEIGHTxDEPTH'.. │ │ │ │ │ -00023240: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00023250: 666f 2c20 204e 6f64 653a 2067 6678 7061 fo, Node: gfxpa │ │ │ │ │ -00023260: 796c 6f61 642c 2020 4e65 7874 3a20 6766 yload, Next: gf │ │ │ │ │ -00023270: 7874 6572 6d5f 666f 6e74 2c20 2050 7265 xterm_font, Pre │ │ │ │ │ -00023280: 763a 2067 6678 6d6f 6465 2c20 2055 703a v: gfxmode, Up: │ │ │ │ │ -00023290: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ -000232a0: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ │ -000232b0: 3135 2e31 2e31 3320 6766 7870 6179 6c6f 15.1.13 gfxpaylo │ │ │ │ │ -000232c0: 6164 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ad.------------- │ │ │ │ │ -000232d0: 2d2d 2d2d 2d0a 0a49 6620 7468 6973 2076 -----..If this v │ │ │ │ │ -000232e0: 6172 6961 626c 6520 6973 2073 6574 2c20 ariable is set, │ │ │ │ │ -000232f0: 6974 2063 6f6e 7472 6f6c 7320 7468 6520 it controls the │ │ │ │ │ -00023300: 7669 6465 6f20 6d6f 6465 2069 6e20 7768 video mode in wh │ │ │ │ │ -00023310: 6963 6820 7468 6520 4c69 6e75 780a 6b65 ich the Linux.ke │ │ │ │ │ -00023320: 726e 656c 2073 7461 7274 7320 7570 2c20 rnel starts up, │ │ │ │ │ -00023330: 7265 706c 6163 696e 6720 7468 6520 2776 replacing the 'v │ │ │ │ │ -00023340: 6761 3d27 2062 6f6f 7420 6f70 7469 6f6e ga=' boot option │ │ │ │ │ -00023350: 2028 2a6e 6f74 6520 6c69 6e75 783a 3a29 (*note linux::) │ │ │ │ │ -00023360: 2e20 2049 740a 6d61 7920 6265 2073 6574 . It.may be set │ │ │ │ │ -00023370: 2074 6f20 2774 6578 7427 2074 6f20 666f to 'text' to fo │ │ │ │ │ -00023380: 7263 6520 7468 6520 4c69 6e75 7820 6b65 rce the Linux ke │ │ │ │ │ -00023390: 726e 656c 2074 6f20 626f 6f74 2069 6e20 rnel to boot in │ │ │ │ │ -000233a0: 6e6f 726d 616c 2074 6578 740a 6d6f 6465 normal text.mode │ │ │ │ │ -000233b0: 2c20 276b 6565 7027 2074 6f20 7072 6573 , 'keep' to pres │ │ │ │ │ -000233c0: 6572 7665 2074 6865 2067 7261 7068 6963 erve the graphic │ │ │ │ │ -000233d0: 7320 6d6f 6465 2073 6574 2075 7369 6e67 s mode set using │ │ │ │ │ -000233e0: 2027 6766 786d 6f64 6527 2c20 6f72 2061 'gfxmode', or a │ │ │ │ │ -000233f0: 6e79 0a6f 6620 7468 6520 7065 726d 6974 ny.of the permit │ │ │ │ │ -00023400: 7465 6420 7661 6c75 6573 2066 6f72 2027 ted values for ' │ │ │ │ │ -00023410: 6766 786d 6f64 6527 2074 6f20 7365 7420 gfxmode' to set │ │ │ │ │ -00023420: 6120 7061 7274 6963 756c 6172 2067 7261 a particular gra │ │ │ │ │ -00023430: 7068 6963 7320 6d6f 6465 0a28 2a6e 6f74 phics mode.(*not │ │ │ │ │ -00023440: 6520 6766 786d 6f64 653a 3a29 2e0a 0a20 e gfxmode::)... │ │ │ │ │ -00023450: 2020 4465 7065 6e64 696e 6720 6f6e 2079 Depending on y │ │ │ │ │ -00023460: 6f75 7220 6b65 726e 656c 2c20 796f 7572 our kernel, your │ │ │ │ │ -00023470: 2064 6973 7472 6962 7574 696f 6e2c 2079 distribution, y │ │ │ │ │ -00023480: 6f75 7220 6772 6170 6869 6373 2063 6172 our graphics car │ │ │ │ │ -00023490: 642c 2061 6e64 0a74 6865 2070 6861 7365 d, and.the phase │ │ │ │ │ -000234a0: 206f 6620 7468 6520 6d6f 6f6e 2c20 6e6f of the moon, no │ │ │ │ │ -000234b0: 7465 2074 6861 7420 7573 696e 6720 7468 te that using th │ │ │ │ │ -000234c0: 6973 206f 7074 696f 6e20 6d61 7920 6361 is option may ca │ │ │ │ │ -000234d0: 7573 6520 474e 552f 4c69 6e75 780a 746f use GNU/Linux.to │ │ │ │ │ -000234e0: 2073 7566 6665 7220 6672 6f6d 2076 6172 suffer from var │ │ │ │ │ -000234f0: 696f 7573 2064 6973 706c 6179 2070 726f ious display pro │ │ │ │ │ -00023500: 626c 656d 732c 2070 6172 7469 6375 6c61 blems, particula │ │ │ │ │ -00023510: 726c 7920 6475 7269 6e67 2074 6865 2065 rly during the e │ │ │ │ │ -00023520: 6172 6c79 0a70 6172 7420 6f66 2074 6865 arly.part of the │ │ │ │ │ -00023530: 2062 6f6f 7420 7365 7175 656e 6365 2e20 boot sequence. │ │ │ │ │ -00023540: 2049 6620 796f 7520 6861 7665 2070 726f If you have pro │ │ │ │ │ -00023550: 626c 656d 732c 2073 6574 2074 6869 7320 blems, set this │ │ │ │ │ -00023560: 7661 7269 6162 6c65 2074 6f0a 2774 6578 variable to.'tex │ │ │ │ │ -00023570: 7427 2061 6e64 2047 5255 4220 7769 6c6c t' and GRUB will │ │ │ │ │ -00023580: 2074 656c 6c20 4c69 6e75 7820 746f 2062 tell Linux to b │ │ │ │ │ -00023590: 6f6f 7420 696e 206e 6f72 6d61 6c20 7465 oot in normal te │ │ │ │ │ -000235a0: 7874 206d 6f64 652e 0a0a 2020 2054 6865 xt mode... The │ │ │ │ │ -000235b0: 2064 6566 6175 6c74 2069 7320 706c 6174 default is plat │ │ │ │ │ -000235c0: 666f 726d 2d73 7065 6369 6669 632e 2020 form-specific. │ │ │ │ │ -000235d0: 4f6e 2070 6c61 7466 6f72 6d73 2077 6974 On platforms wit │ │ │ │ │ -000235e0: 6820 6120 6e61 7469 7665 2074 6578 740a h a native text. │ │ │ │ │ -000235f0: 6d6f 6465 2028 7375 6368 2061 7320 5043 mode (such as PC │ │ │ │ │ -00023600: 2042 494f 5320 706c 6174 666f 726d 7329 BIOS platforms) │ │ │ │ │ -00023610: 2c20 7468 6520 6465 6661 756c 7420 6973 , the default is │ │ │ │ │ -00023620: 2027 7465 7874 272e 2020 4f74 6865 7277 'text'. Otherw │ │ │ │ │ -00023630: 6973 6520 7468 650a 6465 6661 756c 7420 ise the.default │ │ │ │ │ -00023640: 6d61 7920 6265 2027 6175 746f 2720 6f72 may be 'auto' or │ │ │ │ │ -00023650: 2061 2073 7065 6369 6669 6320 7669 6465 a specific vide │ │ │ │ │ -00023660: 6f20 6d6f 6465 2e0a 0a20 2020 5468 6973 o mode... This │ │ │ │ │ -00023670: 2076 6172 6961 626c 6520 6973 206f 6674 variable is oft │ │ │ │ │ -00023680: 656e 2073 6574 2062 7920 2747 5255 425f en set by 'GRUB_ │ │ │ │ │ -00023690: 4746 5850 4159 4c4f 4144 5f4c 494e 5558 GFXPAYLOAD_LINUX │ │ │ │ │ -000236a0: 2720 282a 6e6f 7465 2053 696d 706c 650a ' (*note Simple. │ │ │ │ │ -000236b0: 636f 6e66 6967 7572 6174 696f 6e3a 3a29 configuration::) │ │ │ │ │ -000236c0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -000236d0: 696e 666f 2c20 204e 6f64 653a 2067 6678 info, Node: gfx │ │ │ │ │ -000236e0: 7465 726d 5f66 6f6e 742c 2020 4e65 7874 term_font, Next │ │ │ │ │ -000236f0: 3a20 6772 7562 5f63 7075 2c20 2050 7265 : grub_cpu, Pre │ │ │ │ │ -00023700: 763a 2067 6678 7061 796c 6f61 642c 2020 v: gfxpayload, │ │ │ │ │ -00023710: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ │ -00023720: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ -00023730: 730a 0a31 352e 312e 3134 2067 6678 7465 s..15.1.14 gfxte │ │ │ │ │ -00023740: 726d 5f66 6f6e 740a 2d2d 2d2d 2d2d 2d2d rm_font.-------- │ │ │ │ │ -00023750: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4966 ------------..If │ │ │ │ │ -00023760: 2074 6869 7320 7661 7269 6162 6c65 2069 this variable i │ │ │ │ │ -00023770: 7320 7365 742c 2069 7420 6e61 6d65 7320 s set, it names │ │ │ │ │ -00023780: 6120 666f 6e74 2074 6f20 7573 6520 666f a font to use fo │ │ │ │ │ -00023790: 7220 7465 7874 206f 6e20 7468 650a 2767 r text on the.'g │ │ │ │ │ -000237a0: 6678 7465 726d 2720 6772 6170 6869 6361 fxterm' graphica │ │ │ │ │ -000237b0: 6c20 7465 726d 696e 616c 2e20 204f 7468 l terminal. Oth │ │ │ │ │ -000237c0: 6572 7769 7365 2c20 2767 6678 7465 726d erwise, 'gfxterm │ │ │ │ │ -000237d0: 2720 6d61 7920 7573 6520 616e 790a 6176 ' may use any.av │ │ │ │ │ -000237e0: 6169 6c61 626c 6520 666f 6e74 2e0a 0a1f ailable font.... │ │ │ │ │ -000237f0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00023800: 2c20 204e 6f64 653a 2067 7275 625f 6370 , Node: grub_cp │ │ │ │ │ -00023810: 752c 2020 4e65 7874 3a20 6772 7562 5f70 u, Next: grub_p │ │ │ │ │ -00023820: 6c61 7466 6f72 6d2c 2020 5072 6576 3a20 latform, Prev: │ │ │ │ │ -00023830: 6766 7874 6572 6d5f 666f 6e74 2c20 2055 gfxterm_font, U │ │ │ │ │ -00023840: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ -00023850: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ -00023860: 0a0a 3135 2e31 2e31 3520 6772 7562 5f63 ..15.1.15 grub_c │ │ │ │ │ -00023870: 7075 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d pu.------------- │ │ │ │ │ -00023880: 2d2d 2d0a 0a49 6e20 6e6f 726d 616c 206d ---..In normal m │ │ │ │ │ -00023890: 6f64 6520 282a 6e6f 7465 206e 6f72 6d61 ode (*note norma │ │ │ │ │ -000238a0: 6c3a 3a29 2c20 4752 5542 2073 6574 7320 l::), GRUB sets │ │ │ │ │ -000238b0: 7468 6520 2767 7275 625f 6370 7527 2076 the 'grub_cpu' v │ │ │ │ │ -000238c0: 6172 6961 626c 6520 746f 0a74 6865 2043 ariable to.the C │ │ │ │ │ -000238d0: 5055 2074 7970 6520 666f 7220 7768 6963 PU type for whic │ │ │ │ │ -000238e0: 6820 4752 5542 2077 6173 2062 7569 6c74 h GRUB was built │ │ │ │ │ -000238f0: 2028 652e 672e 2020 2769 3338 3627 206f (e.g. 'i386' o │ │ │ │ │ -00023900: 7220 2770 6f77 6572 7063 2729 2e0a 0a1f r 'powerpc').... │ │ │ │ │ -00023910: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00023920: 2c20 204e 6f64 653a 2067 7275 625f 706c , Node: grub_pl │ │ │ │ │ -00023930: 6174 666f 726d 2c20 204e 6578 743a 2069 atform, Next: i │ │ │ │ │ -00023940: 636f 6e64 6972 2c20 2050 7265 763a 2067 condir, Prev: g │ │ │ │ │ -00023950: 7275 625f 6370 752c 2020 5570 3a20 5370 rub_cpu, Up: Sp │ │ │ │ │ -00023960: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ -00023970: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ │ -00023980: 312e 3136 2067 7275 625f 706c 6174 666f 1.16 grub_platfo │ │ │ │ │ -00023990: 726d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d rm.------------- │ │ │ │ │ -000239a0: 2d2d 2d2d 2d2d 2d2d 0a0a 496e 206e 6f72 --------..In nor │ │ │ │ │ -000239b0: 6d61 6c20 6d6f 6465 2028 2a6e 6f74 6520 mal mode (*note │ │ │ │ │ -000239c0: 6e6f 726d 616c 3a3a 292c 2047 5255 4220 normal::), GRUB │ │ │ │ │ -000239d0: 7365 7473 2074 6865 2027 6772 7562 5f70 sets the 'grub_p │ │ │ │ │ -000239e0: 6c61 7466 6f72 6d27 2076 6172 6961 626c latform' variabl │ │ │ │ │ -000239f0: 650a 746f 2074 6865 2070 6c61 7466 6f72 e.to the platfor │ │ │ │ │ -00023a00: 6d20 666f 7220 7768 6963 6820 4752 5542 m for which GRUB │ │ │ │ │ -00023a10: 2077 6173 2062 7569 6c74 2028 652e 672e was built (e.g. │ │ │ │ │ -00023a20: 2020 2770 6327 206f 7220 2765 6669 2729 'pc' or 'efi') │ │ │ │ │ -00023a30: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00023a40: 696e 666f 2c20 204e 6f64 653a 2069 636f info, Node: ico │ │ │ │ │ -00023a50: 6e64 6972 2c20 204e 6578 743a 206c 616e ndir, Next: lan │ │ │ │ │ -00023a60: 672c 2020 5072 6576 3a20 6772 7562 5f70 g, Prev: grub_p │ │ │ │ │ -00023a70: 6c61 7466 6f72 6d2c 2020 5570 3a20 5370 latform, Up: Sp │ │ │ │ │ -00023a80: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ -00023a90: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ │ -00023aa0: 312e 3137 2069 636f 6e64 6972 0a2d 2d2d 1.17 icondir.--- │ │ │ │ │ -00023ab0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4966 ------------..If │ │ │ │ │ -00023ac0: 2074 6869 7320 7661 7269 6162 6c65 2069 this variable i │ │ │ │ │ -00023ad0: 7320 7365 742c 2069 7420 6e61 6d65 7320 s set, it names │ │ │ │ │ -00023ae0: 6120 6469 7265 6374 6f72 7920 696e 2077 a directory in w │ │ │ │ │ -00023af0: 6869 6368 2074 6865 2047 5255 420a 6772 hich the GRUB.gr │ │ │ │ │ -00023b00: 6170 6869 6361 6c20 6d65 6e75 2073 686f aphical menu sho │ │ │ │ │ -00023b10: 756c 6420 6c6f 6f6b 2066 6f72 2069 636f uld look for ico │ │ │ │ │ -00023b20: 6e73 2061 6674 6572 206c 6f6f 6b69 6e67 ns after looking │ │ │ │ │ -00023b30: 2069 6e20 7468 6520 7468 656d 6527 730a in the theme's. │ │ │ │ │ -00023b40: 2769 636f 6e73 2720 6469 7265 6374 6f72 'icons' director │ │ │ │ │ -00023b50: 792e 2020 2a4e 6f74 6520 5468 656d 6520 y. *Note Theme │ │ │ │ │ -00023b60: 6669 6c65 2066 6f72 6d61 743a 3a2e 0a0a file format::... │ │ │ │ │ -00023b70: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00023b80: 6f2c 2020 4e6f 6465 3a20 6c61 6e67 2c20 o, Node: lang, │ │ │ │ │ -00023b90: 204e 6578 743a 206c 6f63 616c 655f 6469 Next: locale_di │ │ │ │ │ -00023ba0: 722c 2020 5072 6576 3a20 6963 6f6e 6469 r, Prev: icondi │ │ │ │ │ -00023bb0: 722c 2020 5570 3a20 5370 6563 6961 6c20 r, Up: Special │ │ │ │ │ -00023bc0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -00023bd0: 6162 6c65 730a 0a31 352e 312e 3138 206c ables..15.1.18 l │ │ │ │ │ -00023be0: 616e 670a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ang.------------ │ │ │ │ │ -00023bf0: 0a0a 4966 2074 6869 7320 7661 7269 6162 ..If this variab │ │ │ │ │ -00023c00: 6c65 2069 7320 7365 742c 2069 7420 6e61 le is set, it na │ │ │ │ │ -00023c10: 6d65 7320 7468 6520 6c61 6e67 7561 6765 mes the language │ │ │ │ │ -00023c20: 2063 6f64 6520 7468 6174 2074 6865 2027 code that the ' │ │ │ │ │ -00023c30: 6765 7474 6578 7427 0a63 6f6d 6d61 6e64 gettext'.command │ │ │ │ │ -00023c40: 2028 2a6e 6f74 6520 6765 7474 6578 743a (*note gettext: │ │ │ │ │ -00023c50: 3a29 2075 7365 7320 746f 2074 7261 6e73 :) uses to trans │ │ │ │ │ -00023c60: 6c61 7465 2073 7472 696e 6773 2e20 2046 late strings. F │ │ │ │ │ -00023c70: 6f72 2065 7861 6d70 6c65 2c0a 4672 656e or example,.Fren │ │ │ │ │ -00023c80: 6368 2077 6f75 6c64 2062 6520 6e61 6d65 ch would be name │ │ │ │ │ -00023c90: 6420 6173 2027 6672 272c 2061 6e64 2053 d as 'fr', and S │ │ │ │ │ -00023ca0: 696d 706c 6966 6965 6420 4368 696e 6573 implified Chines │ │ │ │ │ -00023cb0: 6520 6173 2027 7a68 5f43 4e27 2e0a 0a20 e as 'zh_CN'... │ │ │ │ │ -00023cc0: 2020 2767 7275 622d 6d6b 636f 6e66 6967 'grub-mkconfig │ │ │ │ │ -00023cd0: 2720 282a 6e6f 7465 2053 696d 706c 6520 ' (*note Simple │ │ │ │ │ -00023ce0: 636f 6e66 6967 7572 6174 696f 6e3a 3a29 configuration::) │ │ │ │ │ -00023cf0: 2077 696c 6c20 7472 7920 746f 2073 6574 will try to set │ │ │ │ │ -00023d00: 2061 0a72 6561 736f 6e61 626c 6520 6465 a.reasonable de │ │ │ │ │ -00023d10: 6661 756c 7420 666f 7220 7468 6973 2076 fault for this v │ │ │ │ │ -00023d20: 6172 6961 626c 6520 6261 7365 6420 6f6e ariable based on │ │ │ │ │ -00023d30: 2074 6865 2073 7973 7465 6d20 6c6f 6361 the system loca │ │ │ │ │ -00023d40: 6c65 2e0a 0a1f 0a46 696c 653a 2067 7275 le.....File: gru │ │ │ │ │ -00023d50: 622e 696e 666f 2c20 204e 6f64 653a 206c b.info, Node: l │ │ │ │ │ -00023d60: 6f63 616c 655f 6469 722c 2020 4e65 7874 ocale_dir, Next │ │ │ │ │ -00023d70: 3a20 6d65 6e75 5f63 6f6c 6f72 5f68 6967 : menu_color_hig │ │ │ │ │ -00023d80: 686c 6967 6874 2c20 2050 7265 763a 206c hlight, Prev: l │ │ │ │ │ -00023d90: 616e 672c 2020 5570 3a20 5370 6563 6961 ang, Up: Specia │ │ │ │ │ -00023da0: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ -00023db0: 7269 6162 6c65 730a 0a31 352e 312e 3139 riables..15.1.19 │ │ │ │ │ -00023dc0: 206c 6f63 616c 655f 6469 720a 2d2d 2d2d locale_dir.---- │ │ │ │ │ -00023dd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -00023de0: 4966 2074 6869 7320 7661 7269 6162 6c65 If this variable │ │ │ │ │ -00023df0: 2069 7320 7365 742c 2069 7420 6e61 6d65 is set, it name │ │ │ │ │ -00023e00: 7320 7468 6520 6469 7265 6374 6f72 7920 s the directory │ │ │ │ │ -00023e10: 7768 6572 6520 7472 616e 736c 6174 696f where translatio │ │ │ │ │ -00023e20: 6e20 6669 6c65 730a 6d61 7920 6265 2066 n files.may be f │ │ │ │ │ -00023e30: 6f75 6e64 2028 2a6e 6f74 6520 6765 7474 ound (*note gett │ │ │ │ │ -00023e40: 6578 743a 3a29 2c20 7573 7561 6c6c 7920 ext::), usually │ │ │ │ │ -00023e50: 272f 626f 6f74 2f67 7275 622f 6c6f 6361 '/boot/grub/loca │ │ │ │ │ -00023e60: 6c65 272e 2020 4f74 6865 7277 6973 652c le'. Otherwise, │ │ │ │ │ -00023e70: 0a69 6e74 6572 6e61 7469 6f6e 616c 697a .internationaliz │ │ │ │ │ -00023e80: 6174 696f 6e20 6973 2064 6973 6162 6c65 ation is disable │ │ │ │ │ -00023e90: 642e 0a0a 2020 2027 6772 7562 2d6d 6b63 d... 'grub-mkc │ │ │ │ │ -00023ea0: 6f6e 6669 6727 2028 2a6e 6f74 6520 5369 onfig' (*note Si │ │ │ │ │ -00023eb0: 6d70 6c65 2063 6f6e 6669 6775 7261 7469 mple configurati │ │ │ │ │ -00023ec0: 6f6e 3a3a 2920 7769 6c6c 2073 6574 2061 on::) will set a │ │ │ │ │ -00023ed0: 2072 6561 736f 6e61 626c 650a 6465 6661 reasonable.defa │ │ │ │ │ -00023ee0: 756c 7420 666f 7220 7468 6973 2076 6172 ult for this var │ │ │ │ │ -00023ef0: 6961 626c 6520 6966 2069 6e74 6572 6e61 iable if interna │ │ │ │ │ -00023f00: 7469 6f6e 616c 697a 6174 696f 6e20 6973 tionalization is │ │ │ │ │ -00023f10: 206e 6565 6465 6420 616e 6420 616e 790a needed and any. │ │ │ │ │ -00023f20: 7472 616e 736c 6174 696f 6e20 6669 6c65 translation file │ │ │ │ │ -00023f30: 7320 6172 6520 6176 6169 6c61 626c 652e s are available. │ │ │ │ │ -00023f40: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00023f50: 6e66 6f2c 2020 4e6f 6465 3a20 6d65 6e75 nfo, Node: menu │ │ │ │ │ -00023f60: 5f63 6f6c 6f72 5f68 6967 686c 6967 6874 _color_highlight │ │ │ │ │ -00023f70: 2c20 204e 6578 743a 206d 656e 755f 636f , Next: menu_co │ │ │ │ │ -00023f80: 6c6f 725f 6e6f 726d 616c 2c20 2050 7265 lor_normal, Pre │ │ │ │ │ -00023f90: 763a 206c 6f63 616c 655f 6469 722c 2020 v: locale_dir, │ │ │ │ │ -00023fa0: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ │ -00023fb0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ -00023fc0: 730a 0a31 352e 312e 3230 206d 656e 755f s..15.1.20 menu_ │ │ │ │ │ -00023fd0: 636f 6c6f 725f 6869 6768 6c69 6768 740a color_highlight. │ │ │ │ │ -00023fe0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00023ff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 ------------..Th │ │ │ │ │ -00024000: 6973 2076 6172 6961 626c 6520 636f 6e74 is variable cont │ │ │ │ │ -00024010: 6169 6e73 2074 6865 2066 6f72 6567 726f ains the foregro │ │ │ │ │ -00024020: 756e 6420 616e 6420 6261 636b 6772 6f75 und and backgrou │ │ │ │ │ -00024030: 6e64 2063 6f6c 6f72 7320 746f 2062 6520 nd colors to be │ │ │ │ │ -00024040: 7573 6564 0a66 6f72 2074 6865 2068 6967 used.for the hig │ │ │ │ │ -00024050: 686c 6967 6874 6564 206d 656e 7520 656e hlighted menu en │ │ │ │ │ -00024060: 7472 792c 2073 6570 6172 6174 6564 2062 try, separated b │ │ │ │ │ -00024070: 7920 6120 736c 6173 6820 2827 2f27 292e y a slash ('/'). │ │ │ │ │ -00024080: 2020 5365 7474 696e 670a 7468 6973 2076 Setting.this v │ │ │ │ │ -00024090: 6172 6961 626c 6520 6368 616e 6765 7320 ariable changes │ │ │ │ │ -000240a0: 7468 6f73 6520 636f 6c6f 7273 2e20 2046 those colors. F │ │ │ │ │ -000240b0: 6f72 2074 6865 2061 7661 696c 6162 6c65 or the available │ │ │ │ │ -000240c0: 2063 6f6c 6f72 206e 616d 6573 2c0a 2a6e color names,.*n │ │ │ │ │ -000240d0: 6f74 6520 636f 6c6f 725f 6e6f 726d 616c ote color_normal │ │ │ │ │ -000240e0: 3a3a 2e0a 0a20 2020 5468 6520 6465 6661 ::... The defa │ │ │ │ │ -000240f0: 756c 7420 6973 2074 6865 2076 616c 7565 ult is the value │ │ │ │ │ -00024100: 206f 6620 2763 6f6c 6f72 5f68 6967 686c of 'color_highl │ │ │ │ │ -00024110: 6967 6874 2720 282a 6e6f 7465 0a63 6f6c ight' (*note.col │ │ │ │ │ -00024120: 6f72 5f68 6967 686c 6967 6874 3a3a 292e or_highlight::). │ │ │ │ │ -00024130: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00024140: 6e66 6f2c 2020 4e6f 6465 3a20 6d65 6e75 nfo, Node: menu │ │ │ │ │ -00024150: 5f63 6f6c 6f72 5f6e 6f72 6d61 6c2c 2020 _color_normal, │ │ │ │ │ -00024160: 4e65 7874 3a20 6e65 745f 3c49 4e54 4552 Next: net__boot_file, │ │ │ │ │ -00024180: 2020 5072 6576 3a20 6d65 6e75 5f63 6f6c Prev: menu_col │ │ │ │ │ -00024190: 6f72 5f68 6967 686c 6967 6874 2c20 2055 or_highlight, U │ │ │ │ │ -000241a0: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ -000241b0: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ -000241c0: 0a0a 3135 2e31 2e32 3120 6d65 6e75 5f63 ..15.1.21 menu_c │ │ │ │ │ -000241d0: 6f6c 6f72 5f6e 6f72 6d61 6c0a 2d2d 2d2d olor_normal.---- │ │ │ │ │ +00022480: 2d2d 2d2d 2d2d 0a0a 5468 6973 2076 6172 ------..This var │ │ │ │ │ +00022490: 6961 626c 6520 6973 2061 7574 6f6d 6174 iable is automat │ │ │ │ │ +000224a0: 6963 616c 6c79 2073 6574 2062 7920 4752 ically set by GR │ │ │ │ │ +000224b0: 5542 2074 6f20 7468 6520 6469 7265 6374 UB to the direct │ │ │ │ │ +000224c0: 6f72 7920 7061 7274 206f 660a 6375 7272 ory part of.curr │ │ │ │ │ +000224d0: 656e 7420 636f 6e66 6967 7572 6174 696f ent configuratio │ │ │ │ │ +000224e0: 6e20 6669 6c65 206e 616d 6520 282a 6e6f n file name (*no │ │ │ │ │ +000224f0: 7465 2063 6f6e 6669 675f 6669 6c65 3a3a te config_file:: │ │ │ │ │ +00022500: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ │ +00022510: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 636f .info, Node: co │ │ │ │ │ +00022520: 6e66 6967 5f66 696c 652c 2020 4e65 7874 nfig_file, Next │ │ │ │ │ +00022530: 3a20 6465 6275 672c 2020 5072 6576 3a20 : debug, Prev: │ │ │ │ │ +00022540: 636f 6e66 6967 5f64 6972 6563 746f 7279 config_directory │ │ │ │ │ +00022550: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ +00022560: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00022570: 626c 6573 0a0a 3135 2e31 2e38 2063 6f6e bles..15.1.8 con │ │ │ │ │ +00022580: 6669 675f 6669 6c65 0a2d 2d2d 2d2d 2d2d fig_file.------- │ │ │ │ │ +00022590: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6869 -----------..Thi │ │ │ │ │ +000225a0: 7320 7661 7269 6162 6c65 2069 7320 6175 s variable is au │ │ │ │ │ +000225b0: 746f 6d61 7469 6361 6c6c 7920 7365 7420 tomatically set │ │ │ │ │ +000225c0: 6279 2047 5255 4220 746f 2074 6865 206e by GRUB to the n │ │ │ │ │ +000225d0: 616d 6520 6f66 2063 6f6e 6669 6775 7261 ame of configura │ │ │ │ │ +000225e0: 7469 6f6e 0a66 696c 6520 7468 6174 2069 tion.file that i │ │ │ │ │ +000225f0: 7320 6265 696e 6720 7072 6f63 6573 7365 s being processe │ │ │ │ │ +00022600: 6420 6279 2063 6f6d 6d61 6e64 7320 2763 d by commands 'c │ │ │ │ │ +00022610: 6f6e 6669 6766 696c 6527 2028 2a6e 6f74 onfigfile' (*not │ │ │ │ │ +00022620: 650a 636f 6e66 6967 6669 6c65 3a3a 2920 e.configfile::) │ │ │ │ │ +00022630: 6f72 2027 6e6f 726d 616c 2720 282a 6e6f or 'normal' (*no │ │ │ │ │ +00022640: 7465 206e 6f72 6d61 6c3a 3a29 2e20 2049 te normal::). I │ │ │ │ │ +00022650: 7420 6973 2072 6573 746f 7265 6420 746f t is restored to │ │ │ │ │ +00022660: 2074 6865 0a70 7265 7669 6f75 7320 7661 the.previous va │ │ │ │ │ +00022670: 6c75 6520 7768 656e 2063 6f6d 6d61 6e64 lue when command │ │ │ │ │ +00022680: 2063 6f6d 706c 6574 6573 2e0a 0a1f 0a46 completes.....F │ │ │ │ │ +00022690: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +000226a0: 204e 6f64 653a 2064 6562 7567 2c20 204e Node: debug, N │ │ │ │ │ +000226b0: 6578 743a 2064 6566 6175 6c74 2c20 2050 ext: default, P │ │ │ │ │ +000226c0: 7265 763a 2063 6f6e 6669 675f 6669 6c65 rev: config_file │ │ │ │ │ +000226d0: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ +000226e0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +000226f0: 626c 6573 0a0a 3135 2e31 2e39 2064 6562 bles..15.1.9 deb │ │ │ │ │ +00022700: 7567 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ug.------------. │ │ │ │ │ +00022710: 0a54 6869 7320 7661 7269 6162 6c65 206d .This variable m │ │ │ │ │ +00022720: 6179 2062 6520 7365 7420 746f 2065 6e61 ay be set to ena │ │ │ │ │ +00022730: 626c 6520 6465 6275 6767 696e 6720 6f75 ble debugging ou │ │ │ │ │ +00022740: 7470 7574 2066 726f 6d20 7661 7269 6f75 tput from variou │ │ │ │ │ +00022750: 730a 636f 6d70 6f6e 656e 7473 206f 6620 s.components of │ │ │ │ │ +00022760: 4752 5542 2e20 5468 6520 7661 6c75 6520 GRUB. The value │ │ │ │ │ +00022770: 6973 2061 206c 6973 7420 6f66 2064 6562 is a list of deb │ │ │ │ │ +00022780: 7567 2066 6163 696c 6974 7920 6e61 6d65 ug facility name │ │ │ │ │ +00022790: 730a 7365 7061 7261 7465 6420 6279 2077 s.separated by w │ │ │ │ │ +000227a0: 6869 7465 7370 6163 6520 6f72 2027 2c27 hitespace or ',' │ │ │ │ │ +000227b0: 2c20 6f72 2027 616c 6c27 2074 6f20 656e , or 'all' to en │ │ │ │ │ +000227c0: 6162 6c65 2061 6c6c 2061 7661 696c 6162 able all availab │ │ │ │ │ +000227d0: 6c65 0a64 6562 7567 6769 6e67 206f 7574 le.debugging out │ │ │ │ │ +000227e0: 7075 742e 2020 5468 6520 6661 6369 6c69 put. The facili │ │ │ │ │ +000227f0: 7479 206e 616d 6573 2061 7265 2074 6865 ty names are the │ │ │ │ │ +00022800: 2066 6972 7374 2061 7267 756d 656e 7420 first argument │ │ │ │ │ +00022810: 746f 0a67 7275 625f 6470 7269 6e74 662e to.grub_dprintf. │ │ │ │ │ +00022820: 2020 436f 6e73 756c 7420 736f 7572 6365 Consult source │ │ │ │ │ +00022830: 2066 6f72 206d 6f72 6520 6465 7461 696c for more detail │ │ │ │ │ +00022840: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ +00022850: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6465 .info, Node: de │ │ │ │ │ +00022860: 6661 756c 742c 2020 4e65 7874 3a20 6661 fault, Next: fa │ │ │ │ │ +00022870: 6c6c 6261 636b 2c20 2050 7265 763a 2064 llback, Prev: d │ │ │ │ │ +00022880: 6562 7567 2c20 2055 703a 2053 7065 6369 ebug, Up: Speci │ │ │ │ │ +00022890: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ │ +000228a0: 6172 6961 626c 6573 0a0a 3135 2e31 2e31 ariables..15.1.1 │ │ │ │ │ +000228b0: 3020 6465 6661 756c 740a 2d2d 2d2d 2d2d 0 default.------ │ │ │ │ │ +000228c0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a49 6620 7468 ---------..If th │ │ │ │ │ +000228d0: 6973 2076 6172 6961 626c 6520 6973 2073 is variable is s │ │ │ │ │ +000228e0: 6574 2c20 6974 2069 6465 6e74 6966 6965 et, it identifie │ │ │ │ │ +000228f0: 7320 6120 6d65 6e75 2065 6e74 7279 2074 s a menu entry t │ │ │ │ │ +00022900: 6861 7420 7368 6f75 6c64 2062 650a 7365 hat should be.se │ │ │ │ │ +00022910: 6c65 6374 6564 2062 7920 6465 6661 756c lected by defaul │ │ │ │ │ +00022920: 742c 2070 6f73 7369 626c 7920 6166 7465 t, possibly afte │ │ │ │ │ +00022930: 7220 6120 7469 6d65 6f75 7420 282a 6e6f r a timeout (*no │ │ │ │ │ +00022940: 7465 2074 696d 656f 7574 3a3a 292e 2020 te timeout::). │ │ │ │ │ +00022950: 5468 650a 656e 7472 7920 6d61 7920 6265 The.entry may be │ │ │ │ │ +00022960: 2069 6465 6e74 6966 6965 6420 6279 206e identified by n │ │ │ │ │ +00022970: 756d 6265 7220 2873 7461 7274 696e 6720 umber (starting │ │ │ │ │ +00022980: 6672 6f6d 2030 2061 7420 6561 6368 206c from 0 at each l │ │ │ │ │ +00022990: 6576 656c 206f 6620 7468 650a 6869 6572 evel of the.hier │ │ │ │ │ +000229a0: 6172 6368 7929 2c20 6279 2074 6974 6c65 archy), by title │ │ │ │ │ +000229b0: 2c20 6f72 2062 7920 6964 2e0a 0a20 2020 , or by id... │ │ │ │ │ +000229c0: 466f 7220 6578 616d 706c 652c 2069 6620 For example, if │ │ │ │ │ +000229d0: 796f 7520 6861 7665 3a0a 0a6d 656e 7565 you have:..menue │ │ │ │ │ +000229e0: 6e74 7279 2027 4578 616d 706c 6520 474e ntry 'Example GN │ │ │ │ │ +000229f0: 552f 4c69 6e75 7820 6469 7374 7269 6275 U/Linux distribu │ │ │ │ │ +00022a00: 7469 6f6e 2720 2d2d 636c 6173 7320 676e tion' --class gn │ │ │ │ │ +00022a10: 752d 6c69 6e75 7820 2d2d 6964 2065 7861 u-linux --id exa │ │ │ │ │ +00022a20: 6d70 6c65 2d67 6e75 2d6c 696e 7578 207b mple-gnu-linux { │ │ │ │ │ +00022a30: 0a09 2e2e 2e0a 7d0a 0a20 2020 7468 656e ......}.. then │ │ │ │ │ +00022a40: 2079 6f75 2063 616e 206d 616b 6520 7468 you can make th │ │ │ │ │ +00022a50: 6973 2074 6865 2064 6566 6175 6c74 2075 is the default u │ │ │ │ │ +00022a60: 7369 6e67 3a0a 0a20 2020 2020 6465 6661 sing:.. defa │ │ │ │ │ +00022a70: 756c 743d 6578 616d 706c 652d 676e 752d ult=example-gnu- │ │ │ │ │ +00022a80: 6c69 6e75 780a 0a20 2020 4966 2074 6865 linux.. If the │ │ │ │ │ +00022a90: 2065 6e74 7279 2069 7320 696e 2061 2073 entry is in a s │ │ │ │ │ +00022aa0: 7562 6d65 6e75 2c20 7468 656e 2069 7420 ubmenu, then it │ │ │ │ │ +00022ab0: 6d75 7374 2062 6520 6964 656e 7469 6669 must be identifi │ │ │ │ │ +00022ac0: 6564 2075 7369 6e67 2074 6865 0a6e 756d ed using the.num │ │ │ │ │ +00022ad0: 6265 722c 2074 6974 6c65 2c20 6f72 2069 ber, title, or i │ │ │ │ │ +00022ae0: 6420 6f66 2065 6163 6820 6f66 2074 6865 d of each of the │ │ │ │ │ +00022af0: 2073 7562 6d65 6e75 7320 7374 6172 7469 submenus starti │ │ │ │ │ +00022b00: 6e67 2066 726f 6d20 7468 6520 746f 700a ng from the top. │ │ │ │ │ +00022b10: 6c65 7665 6c2c 2066 6f6c 6c6f 7765 6420 level, followed │ │ │ │ │ +00022b20: 6279 2074 6865 206e 756d 6265 722c 2074 by the number, t │ │ │ │ │ +00022b30: 6974 6c65 2c20 6f72 2069 6420 6f66 2074 itle, or id of t │ │ │ │ │ +00022b40: 6865 206d 656e 7520 656e 7472 7920 6974 he menu entry it │ │ │ │ │ +00022b50: 7365 6c66 2c0a 7769 7468 2065 6163 6820 self,.with each │ │ │ │ │ +00022b60: 656c 656d 656e 7420 7365 7061 7261 7465 element separate │ │ │ │ │ +00022b70: 6420 6279 2027 3e27 2e20 2046 6f72 2065 d by '>'. For e │ │ │ │ │ +00022b80: 7861 6d70 6c65 2c20 7461 6b65 2074 6865 xample, take the │ │ │ │ │ +00022b90: 2066 6f6c 6c6f 7769 6e67 0a6d 656e 7520 following.menu │ │ │ │ │ +00022ba0: 7374 7275 6374 7572 653a 0a0a 2020 2020 structure:.. │ │ │ │ │ +00022bb0: 2047 4e55 2f48 7572 6420 2d2d 6964 2067 GNU/Hurd --id g │ │ │ │ │ +00022bc0: 6e75 2d68 7572 640a 2020 2020 2020 2053 nu-hurd. S │ │ │ │ │ +00022bd0: 7461 6e64 6172 6420 426f 6f74 202d 2d69 tandard Boot --i │ │ │ │ │ +00022be0: 643d 676e 752d 6875 7264 2d73 7464 0a20 d=gnu-hurd-std. │ │ │ │ │ +00022bf0: 2020 2020 2020 5265 7363 7565 2073 6865 Rescue she │ │ │ │ │ +00022c00: 6c6c 202d 2d69 643d 676e 752d 6875 7264 ll --id=gnu-hurd │ │ │ │ │ +00022c10: 2d72 6573 6375 650a 2020 2020 204f 7468 -rescue. Oth │ │ │ │ │ +00022c20: 6572 2070 6c61 7466 6f72 6d73 202d 2d69 er platforms --i │ │ │ │ │ +00022c30: 643d 6f74 6865 720a 2020 2020 2020 204d d=other. M │ │ │ │ │ +00022c40: 696e 6978 202d 2d69 643d 6d69 6e69 780a inix --id=minix. │ │ │ │ │ +00022c50: 2020 2020 2020 2020 2056 6572 7369 6f6e Version │ │ │ │ │ +00022c60: 2033 2e34 2e30 202d 2d69 643d 6d69 6e69 3.4.0 --id=mini │ │ │ │ │ +00022c70: 782d 332e 342e 300a 2020 2020 2020 2020 x-3.4.0. │ │ │ │ │ +00022c80: 2056 6572 7369 6f6e 2033 2e33 2e30 202d Version 3.3.0 - │ │ │ │ │ +00022c90: 2d69 643d 6d69 6e69 782d 332e 332e 300a -id=minix-3.3.0. │ │ │ │ │ +00022ca0: 2020 2020 2020 2047 5255 4220 496e 7661 GRUB Inva │ │ │ │ │ +00022cb0: 6465 7273 202d 2d69 643d 6772 7562 2d69 ders --id=grub-i │ │ │ │ │ +00022cc0: 6e76 6164 6572 730a 0a20 2020 5468 6520 nvaders.. The │ │ │ │ │ +00022cd0: 6d6f 7265 2072 6563 656e 7420 7265 6c65 more recent rele │ │ │ │ │ +00022ce0: 6173 6520 6f66 204d 696e 6978 2077 6f75 ase of Minix wou │ │ │ │ │ +00022cf0: 6c64 2074 6865 6e20 6265 2069 6465 6e74 ld then be ident │ │ │ │ │ +00022d00: 6966 6965 6420 6173 2027 4f74 6865 720a ified as 'Other. │ │ │ │ │ +00022d10: 706c 6174 666f 726d 733e 4d69 6e69 783e platforms>Minix> │ │ │ │ │ +00022d20: 5665 7273 696f 6e20 332e 342e 3027 2c20 Version 3.4.0', │ │ │ │ │ +00022d30: 6f72 2061 7320 2731 3e30 3e30 272c 206f or as '1>0>0', o │ │ │ │ │ +00022d40: 7220 6173 0a27 6f74 6865 723e 6d69 6e69 r as.'other>mini │ │ │ │ │ +00022d50: 783e 6d69 6e69 782d 332e 342e 3027 2e0a x>minix-3.4.0'.. │ │ │ │ │ +00022d60: 0a20 2020 5468 6973 2076 6172 6961 626c . This variabl │ │ │ │ │ +00022d70: 6520 6973 206f 6674 656e 2073 6574 2062 e is often set b │ │ │ │ │ +00022d80: 7920 2747 5255 425f 4445 4641 554c 5427 y 'GRUB_DEFAULT' │ │ │ │ │ +00022d90: 2028 2a6e 6f74 6520 5369 6d70 6c65 0a63 (*note Simple.c │ │ │ │ │ +00022da0: 6f6e 6669 6775 7261 7469 6f6e 3a3a 292c onfiguration::), │ │ │ │ │ +00022db0: 2027 6772 7562 2d73 6574 2d64 6566 6175 'grub-set-defau │ │ │ │ │ +00022dc0: 6c74 272c 206f 7220 2767 7275 622d 7265 lt', or 'grub-re │ │ │ │ │ +00022dd0: 626f 6f74 272e 0a0a 1f0a 4669 6c65 3a20 boot'.....File: │ │ │ │ │ +00022de0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00022df0: 3a20 6661 6c6c 6261 636b 2c20 204e 6578 : fallback, Nex │ │ │ │ │ +00022e00: 743a 2067 6678 6d6f 6465 2c20 2050 7265 t: gfxmode, Pre │ │ │ │ │ +00022e10: 763a 2064 6566 6175 6c74 2c20 2055 703a v: default, Up: │ │ │ │ │ +00022e20: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ +00022e30: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ │ +00022e40: 3135 2e31 2e31 3120 6661 6c6c 6261 636b 15.1.11 fallback │ │ │ │ │ +00022e50: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +00022e60: 2d0a 0a49 6620 7468 6973 2076 6172 6961 -..If this varia │ │ │ │ │ +00022e70: 626c 6520 6973 2073 6574 2c20 6974 2069 ble is set, it i │ │ │ │ │ +00022e80: 6465 6e74 6966 6965 7320 6120 6d65 6e75 dentifies a menu │ │ │ │ │ +00022e90: 2065 6e74 7279 2074 6861 7420 7368 6f75 entry that shou │ │ │ │ │ +00022ea0: 6c64 2062 650a 7365 6c65 6374 6564 2069 ld be.selected i │ │ │ │ │ +00022eb0: 6620 7468 6520 6465 6661 756c 7420 6d65 f the default me │ │ │ │ │ +00022ec0: 6e75 2065 6e74 7279 2066 6169 6c73 2074 nu entry fails t │ │ │ │ │ +00022ed0: 6f20 626f 6f74 2e20 2045 6e74 7269 6573 o boot. Entries │ │ │ │ │ +00022ee0: 2061 7265 0a69 6465 6e74 6966 6965 6420 are.identified │ │ │ │ │ +00022ef0: 696e 2074 6865 2073 616d 6520 7761 7920 in the same way │ │ │ │ │ +00022f00: 6173 2066 6f72 2027 6465 6661 756c 7427 as for 'default' │ │ │ │ │ +00022f10: 2028 2a6e 6f74 6520 6465 6661 756c 743a (*note default: │ │ │ │ │ +00022f20: 3a29 2e0a 0a1f 0a46 696c 653a 2067 7275 :).....File: gru │ │ │ │ │ +00022f30: 622e 696e 666f 2c20 204e 6f64 653a 2067 b.info, Node: g │ │ │ │ │ +00022f40: 6678 6d6f 6465 2c20 204e 6578 743a 2067 fxmode, Next: g │ │ │ │ │ +00022f50: 6678 7061 796c 6f61 642c 2020 5072 6576 fxpayload, Prev │ │ │ │ │ +00022f60: 3a20 6661 6c6c 6261 636b 2c20 2055 703a : fallback, Up: │ │ │ │ │ +00022f70: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ +00022f80: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ │ +00022f90: 3135 2e31 2e31 3220 6766 786d 6f64 650a 15.1.12 gfxmode. │ │ │ │ │ +00022fa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00022fb0: 0a49 6620 7468 6973 2076 6172 6961 626c .If this variabl │ │ │ │ │ +00022fc0: 6520 6973 2073 6574 2c20 6974 2073 6574 e is set, it set │ │ │ │ │ +00022fd0: 7320 7468 6520 7265 736f 6c75 7469 6f6e s the resolution │ │ │ │ │ +00022fe0: 2075 7365 6420 6f6e 2074 6865 2027 6766 used on the 'gf │ │ │ │ │ +00022ff0: 7874 6572 6d27 0a67 7261 7068 6963 616c xterm'.graphical │ │ │ │ │ +00023000: 2074 6572 6d69 6e61 6c2e 2020 4e6f 7465 terminal. Note │ │ │ │ │ +00023010: 2074 6861 7420 796f 7520 6361 6e20 6f6e that you can on │ │ │ │ │ +00023020: 6c79 2075 7365 206d 6f64 6573 2077 6869 ly use modes whi │ │ │ │ │ +00023030: 6368 2079 6f75 720a 6772 6170 6869 6373 ch your.graphics │ │ │ │ │ +00023040: 2063 6172 6420 7375 7070 6f72 7473 2076 card supports v │ │ │ │ │ +00023050: 6961 2056 4553 4120 4249 4f53 2045 7874 ia VESA BIOS Ext │ │ │ │ │ +00023060: 656e 7369 6f6e 7320 2856 4245 292c 2073 ensions (VBE), s │ │ │ │ │ +00023070: 6f20 666f 7220 6578 616d 706c 650a 6e61 o for example.na │ │ │ │ │ +00023080: 7469 7665 204c 4344 2070 616e 656c 2072 tive LCD panel r │ │ │ │ │ +00023090: 6573 6f6c 7574 696f 6e73 206d 6179 206e esolutions may n │ │ │ │ │ +000230a0: 6f74 2062 6520 6176 6169 6c61 626c 652e ot be available. │ │ │ │ │ +000230b0: 2020 5468 6520 6465 6661 756c 7420 6973 The default is │ │ │ │ │ +000230c0: 0a27 6175 746f 272c 2077 6869 6368 2073 .'auto', which s │ │ │ │ │ +000230d0: 656c 6563 7473 2061 2070 6c61 7466 6f72 elects a platfor │ │ │ │ │ +000230e0: 6d2d 7370 6563 6966 6963 2064 6566 6175 m-specific defau │ │ │ │ │ +000230f0: 6c74 2074 6861 7420 7368 6f75 6c64 206c lt that should l │ │ │ │ │ +00023100: 6f6f 6b0a 7265 6173 6f6e 6162 6c65 2e20 ook.reasonable. │ │ │ │ │ +00023110: 2053 7570 706f 7274 6564 206d 6f64 6573 Supported modes │ │ │ │ │ +00023120: 2063 616e 2062 6520 6c69 7374 6564 2062 can be listed b │ │ │ │ │ +00023130: 7920 2776 6964 656f 696e 666f 2720 636f y 'videoinfo' co │ │ │ │ │ +00023140: 6d6d 616e 6420 696e 0a47 5255 422e 0a0a mmand in.GRUB... │ │ │ │ │ +00023150: 2020 2054 6865 2072 6573 6f6c 7574 696f The resolutio │ │ │ │ │ +00023160: 6e20 6d61 7920 6265 2073 7065 6369 6669 n may be specifi │ │ │ │ │ +00023170: 6564 2061 7320 6120 7365 7175 656e 6365 ed as a sequence │ │ │ │ │ +00023180: 206f 6620 6f6e 6520 6f72 206d 6f72 6520 of one or more │ │ │ │ │ +00023190: 6d6f 6465 732c 0a73 6570 6172 6174 6564 modes,.separated │ │ │ │ │ +000231a0: 2062 7920 636f 6d6d 6173 2028 272c 2729 by commas (',') │ │ │ │ │ +000231b0: 206f 7220 7365 6d69 636f 6c6f 6e73 2028 or semicolons ( │ │ │ │ │ +000231c0: 273b 2729 3b20 6561 6368 2077 696c 6c20 ';'); each will │ │ │ │ │ +000231d0: 6265 2074 7269 6564 2069 6e0a 7475 726e be tried in.turn │ │ │ │ │ +000231e0: 2075 6e74 696c 206f 6e65 2069 7320 666f until one is fo │ │ │ │ │ +000231f0: 756e 642e 2020 4561 6368 206d 6f64 6520 und. Each mode │ │ │ │ │ +00023200: 7368 6f75 6c64 2062 6520 6569 7468 6572 should be either │ │ │ │ │ +00023210: 2027 6175 746f 272c 0a27 5749 4454 4878 'auto',.'WIDTHx │ │ │ │ │ +00023220: 4845 4947 4854 272c 206f 7220 2757 4944 HEIGHT', or 'WID │ │ │ │ │ +00023230: 5448 7848 4549 4748 5478 4445 5054 4827 THxHEIGHTxDEPTH' │ │ │ │ │ +00023240: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00023250: 696e 666f 2c20 204e 6f64 653a 2067 6678 info, Node: gfx │ │ │ │ │ +00023260: 7061 796c 6f61 642c 2020 4e65 7874 3a20 payload, Next: │ │ │ │ │ +00023270: 6766 7874 6572 6d5f 666f 6e74 2c20 2050 gfxterm_font, P │ │ │ │ │ +00023280: 7265 763a 2067 6678 6d6f 6465 2c20 2055 rev: gfxmode, U │ │ │ │ │ +00023290: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ +000232a0: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ +000232b0: 0a0a 3135 2e31 2e31 3320 6766 7870 6179 ..15.1.13 gfxpay │ │ │ │ │ +000232c0: 6c6f 6164 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d load.----------- │ │ │ │ │ +000232d0: 2d2d 2d2d 2d2d 2d0a 0a49 6620 7468 6973 -------..If this │ │ │ │ │ +000232e0: 2076 6172 6961 626c 6520 6973 2073 6574 variable is set │ │ │ │ │ +000232f0: 2c20 6974 2063 6f6e 7472 6f6c 7320 7468 , it controls th │ │ │ │ │ +00023300: 6520 7669 6465 6f20 6d6f 6465 2069 6e20 e video mode in │ │ │ │ │ +00023310: 7768 6963 6820 7468 6520 4c69 6e75 780a which the Linux. │ │ │ │ │ +00023320: 6b65 726e 656c 2073 7461 7274 7320 7570 kernel starts up │ │ │ │ │ +00023330: 2c20 7265 706c 6163 696e 6720 7468 6520 , replacing the │ │ │ │ │ +00023340: 2776 6761 3d27 2062 6f6f 7420 6f70 7469 'vga=' boot opti │ │ │ │ │ +00023350: 6f6e 2028 2a6e 6f74 6520 6c69 6e75 783a on (*note linux: │ │ │ │ │ +00023360: 3a29 2e20 2049 740a 6d61 7920 6265 2073 :). It.may be s │ │ │ │ │ +00023370: 6574 2074 6f20 2774 6578 7427 2074 6f20 et to 'text' to │ │ │ │ │ +00023380: 666f 7263 6520 7468 6520 4c69 6e75 7820 force the Linux │ │ │ │ │ +00023390: 6b65 726e 656c 2074 6f20 626f 6f74 2069 kernel to boot i │ │ │ │ │ +000233a0: 6e20 6e6f 726d 616c 2074 6578 740a 6d6f n normal text.mo │ │ │ │ │ +000233b0: 6465 2c20 276b 6565 7027 2074 6f20 7072 de, 'keep' to pr │ │ │ │ │ +000233c0: 6573 6572 7665 2074 6865 2067 7261 7068 eserve the graph │ │ │ │ │ +000233d0: 6963 7320 6d6f 6465 2073 6574 2075 7369 ics mode set usi │ │ │ │ │ +000233e0: 6e67 2027 6766 786d 6f64 6527 2c20 6f72 ng 'gfxmode', or │ │ │ │ │ +000233f0: 2061 6e79 0a6f 6620 7468 6520 7065 726d any.of the perm │ │ │ │ │ +00023400: 6974 7465 6420 7661 6c75 6573 2066 6f72 itted values for │ │ │ │ │ +00023410: 2027 6766 786d 6f64 6527 2074 6f20 7365 'gfxmode' to se │ │ │ │ │ +00023420: 7420 6120 7061 7274 6963 756c 6172 2067 t a particular g │ │ │ │ │ +00023430: 7261 7068 6963 7320 6d6f 6465 0a28 2a6e raphics mode.(*n │ │ │ │ │ +00023440: 6f74 6520 6766 786d 6f64 653a 3a29 2e0a ote gfxmode::).. │ │ │ │ │ +00023450: 0a20 2020 4465 7065 6e64 696e 6720 6f6e . Depending on │ │ │ │ │ +00023460: 2079 6f75 7220 6b65 726e 656c 2c20 796f your kernel, yo │ │ │ │ │ +00023470: 7572 2064 6973 7472 6962 7574 696f 6e2c ur distribution, │ │ │ │ │ +00023480: 2079 6f75 7220 6772 6170 6869 6373 2063 your graphics c │ │ │ │ │ +00023490: 6172 642c 2061 6e64 0a74 6865 2070 6861 ard, and.the pha │ │ │ │ │ +000234a0: 7365 206f 6620 7468 6520 6d6f 6f6e 2c20 se of the moon, │ │ │ │ │ +000234b0: 6e6f 7465 2074 6861 7420 7573 696e 6720 note that using │ │ │ │ │ +000234c0: 7468 6973 206f 7074 696f 6e20 6d61 7920 this option may │ │ │ │ │ +000234d0: 6361 7573 6520 474e 552f 4c69 6e75 780a cause GNU/Linux. │ │ │ │ │ +000234e0: 746f 2073 7566 6665 7220 6672 6f6d 2076 to suffer from v │ │ │ │ │ +000234f0: 6172 696f 7573 2064 6973 706c 6179 2070 arious display p │ │ │ │ │ +00023500: 726f 626c 656d 732c 2070 6172 7469 6375 roblems, particu │ │ │ │ │ +00023510: 6c61 726c 7920 6475 7269 6e67 2074 6865 larly during the │ │ │ │ │ +00023520: 2065 6172 6c79 0a70 6172 7420 6f66 2074 early.part of t │ │ │ │ │ +00023530: 6865 2062 6f6f 7420 7365 7175 656e 6365 he boot sequence │ │ │ │ │ +00023540: 2e20 2049 6620 796f 7520 6861 7665 2070 . If you have p │ │ │ │ │ +00023550: 726f 626c 656d 732c 2073 6574 2074 6869 roblems, set thi │ │ │ │ │ +00023560: 7320 7661 7269 6162 6c65 2074 6f0a 2774 s variable to.'t │ │ │ │ │ +00023570: 6578 7427 2061 6e64 2047 5255 4220 7769 ext' and GRUB wi │ │ │ │ │ +00023580: 6c6c 2074 656c 6c20 4c69 6e75 7820 746f ll tell Linux to │ │ │ │ │ +00023590: 2062 6f6f 7420 696e 206e 6f72 6d61 6c20 boot in normal │ │ │ │ │ +000235a0: 7465 7874 206d 6f64 652e 0a0a 2020 2054 text mode... T │ │ │ │ │ +000235b0: 6865 2064 6566 6175 6c74 2069 7320 706c he default is pl │ │ │ │ │ +000235c0: 6174 666f 726d 2d73 7065 6369 6669 632e atform-specific. │ │ │ │ │ +000235d0: 2020 4f6e 2070 6c61 7466 6f72 6d73 2077 On platforms w │ │ │ │ │ +000235e0: 6974 6820 6120 6e61 7469 7665 2074 6578 ith a native tex │ │ │ │ │ +000235f0: 740a 6d6f 6465 2028 7375 6368 2061 7320 t.mode (such as │ │ │ │ │ +00023600: 5043 2042 494f 5320 706c 6174 666f 726d PC BIOS platform │ │ │ │ │ +00023610: 7329 2c20 7468 6520 6465 6661 756c 7420 s), the default │ │ │ │ │ +00023620: 6973 2027 7465 7874 272e 2020 4f74 6865 is 'text'. Othe │ │ │ │ │ +00023630: 7277 6973 6520 7468 650a 6465 6661 756c rwise the.defaul │ │ │ │ │ +00023640: 7420 6d61 7920 6265 2027 6175 746f 2720 t may be 'auto' │ │ │ │ │ +00023650: 6f72 2061 2073 7065 6369 6669 6320 7669 or a specific vi │ │ │ │ │ +00023660: 6465 6f20 6d6f 6465 2e0a 0a20 2020 5468 deo mode... Th │ │ │ │ │ +00023670: 6973 2076 6172 6961 626c 6520 6973 206f is variable is o │ │ │ │ │ +00023680: 6674 656e 2073 6574 2062 7920 2747 5255 ften set by 'GRU │ │ │ │ │ +00023690: 425f 4746 5850 4159 4c4f 4144 5f4c 494e B_GFXPAYLOAD_LIN │ │ │ │ │ +000236a0: 5558 2720 282a 6e6f 7465 2053 696d 706c UX' (*note Simpl │ │ │ │ │ +000236b0: 650a 636f 6e66 6967 7572 6174 696f 6e3a e.configuration: │ │ │ │ │ +000236c0: 3a29 2e0a 0a1f 0a46 696c 653a 2067 7275 :).....File: gru │ │ │ │ │ +000236d0: 622e 696e 666f 2c20 204e 6f64 653a 2067 b.info, Node: g │ │ │ │ │ +000236e0: 6678 7465 726d 5f66 6f6e 742c 2020 4e65 fxterm_font, Ne │ │ │ │ │ +000236f0: 7874 3a20 6772 7562 5f63 7075 2c20 2050 xt: grub_cpu, P │ │ │ │ │ +00023700: 7265 763a 2067 6678 7061 796c 6f61 642c rev: gfxpayload, │ │ │ │ │ +00023710: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ │ +00023720: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +00023730: 6c65 730a 0a31 352e 312e 3134 2067 6678 les..15.1.14 gfx │ │ │ │ │ +00023740: 7465 726d 5f66 6f6e 740a 2d2d 2d2d 2d2d term_font.------ │ │ │ │ │ +00023750: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00023760: 4966 2074 6869 7320 7661 7269 6162 6c65 If this variable │ │ │ │ │ +00023770: 2069 7320 7365 742c 2069 7420 6e61 6d65 is set, it name │ │ │ │ │ +00023780: 7320 6120 666f 6e74 2074 6f20 7573 6520 s a font to use │ │ │ │ │ +00023790: 666f 7220 7465 7874 206f 6e20 7468 650a for text on the. │ │ │ │ │ +000237a0: 2767 6678 7465 726d 2720 6772 6170 6869 'gfxterm' graphi │ │ │ │ │ +000237b0: 6361 6c20 7465 726d 696e 616c 2e20 204f cal terminal. O │ │ │ │ │ +000237c0: 7468 6572 7769 7365 2c20 2767 6678 7465 therwise, 'gfxte │ │ │ │ │ +000237d0: 726d 2720 6d61 7920 7573 6520 616e 790a rm' may use any. │ │ │ │ │ +000237e0: 6176 6169 6c61 626c 6520 666f 6e74 2e0a available font.. │ │ │ │ │ +000237f0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00023800: 666f 2c20 204e 6f64 653a 2067 7275 625f fo, Node: grub_ │ │ │ │ │ +00023810: 6370 752c 2020 4e65 7874 3a20 6772 7562 cpu, Next: grub │ │ │ │ │ +00023820: 5f70 6c61 7466 6f72 6d2c 2020 5072 6576 _platform, Prev │ │ │ │ │ +00023830: 3a20 6766 7874 6572 6d5f 666f 6e74 2c20 : gfxterm_font, │ │ │ │ │ +00023840: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ +00023850: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +00023860: 6573 0a0a 3135 2e31 2e31 3520 6772 7562 es..15.1.15 grub │ │ │ │ │ +00023870: 5f63 7075 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d _cpu.----------- │ │ │ │ │ +00023880: 2d2d 2d2d 2d0a 0a49 6e20 6e6f 726d 616c -----..In normal │ │ │ │ │ +00023890: 206d 6f64 6520 282a 6e6f 7465 206e 6f72 mode (*note nor │ │ │ │ │ +000238a0: 6d61 6c3a 3a29 2c20 4752 5542 2073 6574 mal::), GRUB set │ │ │ │ │ +000238b0: 7320 7468 6520 2767 7275 625f 6370 7527 s the 'grub_cpu' │ │ │ │ │ +000238c0: 2076 6172 6961 626c 6520 746f 0a74 6865 variable to.the │ │ │ │ │ +000238d0: 2043 5055 2074 7970 6520 666f 7220 7768 CPU type for wh │ │ │ │ │ +000238e0: 6963 6820 4752 5542 2077 6173 2062 7569 ich GRUB was bui │ │ │ │ │ +000238f0: 6c74 2028 652e 672e 2020 2769 3338 3627 lt (e.g. 'i386' │ │ │ │ │ +00023900: 206f 7220 2770 6f77 6572 7063 2729 2e0a or 'powerpc').. │ │ │ │ │ +00023910: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00023920: 666f 2c20 204e 6f64 653a 2067 7275 625f fo, Node: grub_ │ │ │ │ │ +00023930: 706c 6174 666f 726d 2c20 204e 6578 743a platform, Next: │ │ │ │ │ +00023940: 2069 636f 6e64 6972 2c20 2050 7265 763a icondir, Prev: │ │ │ │ │ +00023950: 2067 7275 625f 6370 752c 2020 5570 3a20 grub_cpu, Up: │ │ │ │ │ +00023960: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ │ +00023970: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ │ +00023980: 352e 312e 3136 2067 7275 625f 706c 6174 5.1.16 grub_plat │ │ │ │ │ +00023990: 666f 726d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d form.----------- │ │ │ │ │ +000239a0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 496e 206e ----------..In n │ │ │ │ │ +000239b0: 6f72 6d61 6c20 6d6f 6465 2028 2a6e 6f74 ormal mode (*not │ │ │ │ │ +000239c0: 6520 6e6f 726d 616c 3a3a 292c 2047 5255 e normal::), GRU │ │ │ │ │ +000239d0: 4220 7365 7473 2074 6865 2027 6772 7562 B sets the 'grub │ │ │ │ │ +000239e0: 5f70 6c61 7466 6f72 6d27 2076 6172 6961 _platform' varia │ │ │ │ │ +000239f0: 626c 650a 746f 2074 6865 2070 6c61 7466 ble.to the platf │ │ │ │ │ +00023a00: 6f72 6d20 666f 7220 7768 6963 6820 4752 orm for which GR │ │ │ │ │ +00023a10: 5542 2077 6173 2062 7569 6c74 2028 652e UB was built (e. │ │ │ │ │ +00023a20: 672e 2020 2770 6327 206f 7220 2765 6669 g. 'pc' or 'efi │ │ │ │ │ +00023a30: 2729 2e0a 0a1f 0a46 696c 653a 2067 7275 ').....File: gru │ │ │ │ │ +00023a40: 622e 696e 666f 2c20 204e 6f64 653a 2069 b.info, Node: i │ │ │ │ │ +00023a50: 636f 6e64 6972 2c20 204e 6578 743a 206c condir, Next: l │ │ │ │ │ +00023a60: 616e 672c 2020 5072 6576 3a20 6772 7562 ang, Prev: grub │ │ │ │ │ +00023a70: 5f70 6c61 7466 6f72 6d2c 2020 5570 3a20 _platform, Up: │ │ │ │ │ +00023a80: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ │ +00023a90: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ │ +00023aa0: 352e 312e 3137 2069 636f 6e64 6972 0a2d 5.1.17 icondir.- │ │ │ │ │ +00023ab0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00023ac0: 4966 2074 6869 7320 7661 7269 6162 6c65 If this variable │ │ │ │ │ +00023ad0: 2069 7320 7365 742c 2069 7420 6e61 6d65 is set, it name │ │ │ │ │ +00023ae0: 7320 6120 6469 7265 6374 6f72 7920 696e s a directory in │ │ │ │ │ +00023af0: 2077 6869 6368 2074 6865 2047 5255 420a which the GRUB. │ │ │ │ │ +00023b00: 6772 6170 6869 6361 6c20 6d65 6e75 2073 graphical menu s │ │ │ │ │ +00023b10: 686f 756c 6420 6c6f 6f6b 2066 6f72 2069 hould look for i │ │ │ │ │ +00023b20: 636f 6e73 2061 6674 6572 206c 6f6f 6b69 cons after looki │ │ │ │ │ +00023b30: 6e67 2069 6e20 7468 6520 7468 656d 6527 ng in the theme' │ │ │ │ │ +00023b40: 730a 2769 636f 6e73 2720 6469 7265 6374 s.'icons' direct │ │ │ │ │ +00023b50: 6f72 792e 2020 2a4e 6f74 6520 5468 656d ory. *Note Them │ │ │ │ │ +00023b60: 6520 6669 6c65 2066 6f72 6d61 743a 3a2e e file format::. │ │ │ │ │ +00023b70: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00023b80: 6e66 6f2c 2020 4e6f 6465 3a20 6c61 6e67 nfo, Node: lang │ │ │ │ │ +00023b90: 2c20 204e 6578 743a 206c 6f63 616c 655f , Next: locale_ │ │ │ │ │ +00023ba0: 6469 722c 2020 5072 6576 3a20 6963 6f6e dir, Prev: icon │ │ │ │ │ +00023bb0: 6469 722c 2020 5570 3a20 5370 6563 6961 dir, Up: Specia │ │ │ │ │ +00023bc0: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ +00023bd0: 7269 6162 6c65 730a 0a31 352e 312e 3138 riables..15.1.18 │ │ │ │ │ +00023be0: 206c 616e 670a 2d2d 2d2d 2d2d 2d2d 2d2d lang.---------- │ │ │ │ │ +00023bf0: 2d2d 0a0a 4966 2074 6869 7320 7661 7269 --..If this vari │ │ │ │ │ +00023c00: 6162 6c65 2069 7320 7365 742c 2069 7420 able is set, it │ │ │ │ │ +00023c10: 6e61 6d65 7320 7468 6520 6c61 6e67 7561 names the langua │ │ │ │ │ +00023c20: 6765 2063 6f64 6520 7468 6174 2074 6865 ge code that the │ │ │ │ │ +00023c30: 2027 6765 7474 6578 7427 0a63 6f6d 6d61 'gettext'.comma │ │ │ │ │ +00023c40: 6e64 2028 2a6e 6f74 6520 6765 7474 6578 nd (*note gettex │ │ │ │ │ +00023c50: 743a 3a29 2075 7365 7320 746f 2074 7261 t::) uses to tra │ │ │ │ │ +00023c60: 6e73 6c61 7465 2073 7472 696e 6773 2e20 nslate strings. │ │ │ │ │ +00023c70: 2046 6f72 2065 7861 6d70 6c65 2c0a 4672 For example,.Fr │ │ │ │ │ +00023c80: 656e 6368 2077 6f75 6c64 2062 6520 6e61 ench would be na │ │ │ │ │ +00023c90: 6d65 6420 6173 2027 6672 272c 2061 6e64 med as 'fr', and │ │ │ │ │ +00023ca0: 2053 696d 706c 6966 6965 6420 4368 696e Simplified Chin │ │ │ │ │ +00023cb0: 6573 6520 6173 2027 7a68 5f43 4e27 2e0a ese as 'zh_CN'.. │ │ │ │ │ +00023cc0: 0a20 2020 2767 7275 622d 6d6b 636f 6e66 . 'grub-mkconf │ │ │ │ │ +00023cd0: 6967 2720 282a 6e6f 7465 2053 696d 706c ig' (*note Simpl │ │ │ │ │ +00023ce0: 6520 636f 6e66 6967 7572 6174 696f 6e3a e configuration: │ │ │ │ │ +00023cf0: 3a29 2077 696c 6c20 7472 7920 746f 2073 :) will try to s │ │ │ │ │ +00023d00: 6574 2061 0a72 6561 736f 6e61 626c 6520 et a.reasonable │ │ │ │ │ +00023d10: 6465 6661 756c 7420 666f 7220 7468 6973 default for this │ │ │ │ │ +00023d20: 2076 6172 6961 626c 6520 6261 7365 6420 variable based │ │ │ │ │ +00023d30: 6f6e 2074 6865 2073 7973 7465 6d20 6c6f on the system lo │ │ │ │ │ +00023d40: 6361 6c65 2e0a 0a1f 0a46 696c 653a 2067 cale.....File: g │ │ │ │ │ +00023d50: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +00023d60: 206c 6f63 616c 655f 6469 722c 2020 4e65 locale_dir, Ne │ │ │ │ │ +00023d70: 7874 3a20 6d65 6e75 5f63 6f6c 6f72 5f68 xt: menu_color_h │ │ │ │ │ +00023d80: 6967 686c 6967 6874 2c20 2050 7265 763a ighlight, Prev: │ │ │ │ │ +00023d90: 206c 616e 672c 2020 5570 3a20 5370 6563 lang, Up: Spec │ │ │ │ │ +00023da0: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ +00023db0: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ +00023dc0: 3139 206c 6f63 616c 655f 6469 720a 2d2d 19 locale_dir.-- │ │ │ │ │ +00023dd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00023de0: 0a0a 4966 2074 6869 7320 7661 7269 6162 ..If this variab │ │ │ │ │ +00023df0: 6c65 2069 7320 7365 742c 2069 7420 6e61 le is set, it na │ │ │ │ │ +00023e00: 6d65 7320 7468 6520 6469 7265 6374 6f72 mes the director │ │ │ │ │ +00023e10: 7920 7768 6572 6520 7472 616e 736c 6174 y where translat │ │ │ │ │ +00023e20: 696f 6e20 6669 6c65 730a 6d61 7920 6265 ion files.may be │ │ │ │ │ +00023e30: 2066 6f75 6e64 2028 2a6e 6f74 6520 6765 found (*note ge │ │ │ │ │ +00023e40: 7474 6578 743a 3a29 2c20 7573 7561 6c6c ttext::), usuall │ │ │ │ │ +00023e50: 7920 272f 626f 6f74 2f67 7275 622f 6c6f y '/boot/grub/lo │ │ │ │ │ +00023e60: 6361 6c65 272e 2020 4f74 6865 7277 6973 cale'. Otherwis │ │ │ │ │ +00023e70: 652c 0a69 6e74 6572 6e61 7469 6f6e 616c e,.international │ │ │ │ │ +00023e80: 697a 6174 696f 6e20 6973 2064 6973 6162 ization is disab │ │ │ │ │ +00023e90: 6c65 642e 0a0a 2020 2027 6772 7562 2d6d led... 'grub-m │ │ │ │ │ +00023ea0: 6b63 6f6e 6669 6727 2028 2a6e 6f74 6520 kconfig' (*note │ │ │ │ │ +00023eb0: 5369 6d70 6c65 2063 6f6e 6669 6775 7261 Simple configura │ │ │ │ │ +00023ec0: 7469 6f6e 3a3a 2920 7769 6c6c 2073 6574 tion::) will set │ │ │ │ │ +00023ed0: 2061 2072 6561 736f 6e61 626c 650a 6465 a reasonable.de │ │ │ │ │ +00023ee0: 6661 756c 7420 666f 7220 7468 6973 2076 fault for this v │ │ │ │ │ +00023ef0: 6172 6961 626c 6520 6966 2069 6e74 6572 ariable if inter │ │ │ │ │ +00023f00: 6e61 7469 6f6e 616c 697a 6174 696f 6e20 nationalization │ │ │ │ │ +00023f10: 6973 206e 6565 6465 6420 616e 6420 616e is needed and an │ │ │ │ │ +00023f20: 790a 7472 616e 736c 6174 696f 6e20 6669 y.translation fi │ │ │ │ │ +00023f30: 6c65 7320 6172 6520 6176 6169 6c61 626c les are availabl │ │ │ │ │ +00023f40: 652e 0a0a 1f0a 4669 6c65 3a20 6772 7562 e.....File: grub │ │ │ │ │ +00023f50: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6d65 .info, Node: me │ │ │ │ │ +00023f60: 6e75 5f63 6f6c 6f72 5f68 6967 686c 6967 nu_color_highlig │ │ │ │ │ +00023f70: 6874 2c20 204e 6578 743a 206d 656e 755f ht, Next: menu_ │ │ │ │ │ +00023f80: 636f 6c6f 725f 6e6f 726d 616c 2c20 2050 color_normal, P │ │ │ │ │ +00023f90: 7265 763a 206c 6f63 616c 655f 6469 722c rev: locale_dir, │ │ │ │ │ +00023fa0: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ │ +00023fb0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +00023fc0: 6c65 730a 0a31 352e 312e 3230 206d 656e les..15.1.20 men │ │ │ │ │ +00023fd0: 755f 636f 6c6f 725f 6869 6768 6c69 6768 u_color_highligh │ │ │ │ │ +00023fe0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ │ +00023ff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00024000: 5468 6973 2076 6172 6961 626c 6520 636f This variable co │ │ │ │ │ +00024010: 6e74 6169 6e73 2074 6865 2066 6f72 6567 ntains the foreg │ │ │ │ │ +00024020: 726f 756e 6420 616e 6420 6261 636b 6772 round and backgr │ │ │ │ │ +00024030: 6f75 6e64 2063 6f6c 6f72 7320 746f 2062 ound colors to b │ │ │ │ │ +00024040: 6520 7573 6564 0a66 6f72 2074 6865 2068 e used.for the h │ │ │ │ │ +00024050: 6967 686c 6967 6874 6564 206d 656e 7520 ighlighted menu │ │ │ │ │ +00024060: 656e 7472 792c 2073 6570 6172 6174 6564 entry, separated │ │ │ │ │ +00024070: 2062 7920 6120 736c 6173 6820 2827 2f27 by a slash ('/' │ │ │ │ │ +00024080: 292e 2020 5365 7474 696e 670a 7468 6973 ). Setting.this │ │ │ │ │ +00024090: 2076 6172 6961 626c 6520 6368 616e 6765 variable change │ │ │ │ │ +000240a0: 7320 7468 6f73 6520 636f 6c6f 7273 2e20 s those colors. │ │ │ │ │ +000240b0: 2046 6f72 2074 6865 2061 7661 696c 6162 For the availab │ │ │ │ │ +000240c0: 6c65 2063 6f6c 6f72 206e 616d 6573 2c0a le color names,. │ │ │ │ │ +000240d0: 2a6e 6f74 6520 636f 6c6f 725f 6e6f 726d *note color_norm │ │ │ │ │ +000240e0: 616c 3a3a 2e0a 0a20 2020 5468 6520 6465 al::... The de │ │ │ │ │ +000240f0: 6661 756c 7420 6973 2074 6865 2076 616c fault is the val │ │ │ │ │ +00024100: 7565 206f 6620 2763 6f6c 6f72 5f68 6967 ue of 'color_hig │ │ │ │ │ +00024110: 686c 6967 6874 2720 282a 6e6f 7465 0a63 hlight' (*note.c │ │ │ │ │ +00024120: 6f6c 6f72 5f68 6967 686c 6967 6874 3a3a olor_highlight:: │ │ │ │ │ +00024130: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ │ +00024140: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6d65 .info, Node: me │ │ │ │ │ +00024150: 6e75 5f63 6f6c 6f72 5f6e 6f72 6d61 6c2c nu_color_normal, │ │ │ │ │ +00024160: 2020 4e65 7874 3a20 6e65 745f 3c49 4e54 Next: net__boot_fil │ │ │ │ │ +00024180: 652c 2020 5072 6576 3a20 6d65 6e75 5f63 e, Prev: menu_c │ │ │ │ │ +00024190: 6f6c 6f72 5f68 6967 686c 6967 6874 2c20 olor_highlight, │ │ │ │ │ +000241a0: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ +000241b0: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +000241c0: 6573 0a0a 3135 2e31 2e32 3120 6d65 6e75 es..15.1.21 menu │ │ │ │ │ +000241d0: 5f63 6f6c 6f72 5f6e 6f72 6d61 6c0a 2d2d _color_normal.-- │ │ │ │ │ 000241e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000241f0: 2d2d 2d2d 2d0a 0a54 6869 7320 7661 7269 -----..This vari │ │ │ │ │ -00024200: 6162 6c65 2063 6f6e 7461 696e 7320 7468 able contains th │ │ │ │ │ -00024210: 6520 666f 7265 6772 6f75 6e64 2061 6e64 e foreground and │ │ │ │ │ -00024220: 2062 6163 6b67 726f 756e 6420 636f 6c6f background colo │ │ │ │ │ -00024230: 7273 2074 6f20 6265 2075 7365 640a 666f rs to be used.fo │ │ │ │ │ -00024240: 7220 6e6f 6e2d 6869 6768 6c69 6768 7465 r non-highlighte │ │ │ │ │ -00024250: 6420 6d65 6e75 2065 6e74 7269 6573 2c20 d menu entries, │ │ │ │ │ -00024260: 7365 7061 7261 7465 6420 6279 2061 2073 separated by a s │ │ │ │ │ -00024270: 6c61 7368 2028 272f 2729 2e20 2053 6574 lash ('/'). Set │ │ │ │ │ -00024280: 7469 6e67 0a74 6869 7320 7661 7269 6162 ting.this variab │ │ │ │ │ -00024290: 6c65 2063 6861 6e67 6573 2074 686f 7365 le changes those │ │ │ │ │ -000242a0: 2063 6f6c 6f72 732e 2020 466f 7220 7468 colors. For th │ │ │ │ │ -000242b0: 6520 6176 6169 6c61 626c 6520 636f 6c6f e available colo │ │ │ │ │ -000242c0: 7220 6e61 6d65 732c 0a2a 6e6f 7465 2063 r names,.*note c │ │ │ │ │ -000242d0: 6f6c 6f72 5f6e 6f72 6d61 6c3a 3a2e 0a0a olor_normal::... │ │ │ │ │ -000242e0: 2020 2054 6865 2064 6566 6175 6c74 2069 The default i │ │ │ │ │ -000242f0: 7320 7468 6520 7661 6c75 6520 6f66 2027 s the value of ' │ │ │ │ │ -00024300: 636f 6c6f 725f 6e6f 726d 616c 2720 282a color_normal' (* │ │ │ │ │ -00024310: 6e6f 7465 2063 6f6c 6f72 5f6e 6f72 6d61 note color_norma │ │ │ │ │ -00024320: 6c3a 3a29 2e0a 0a1f 0a46 696c 653a 2067 l::).....File: g │ │ │ │ │ -00024330: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00024340: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ -00024350: 5f62 6f6f 745f 6669 6c65 2c20 204e 6578 _boot_file, Nex │ │ │ │ │ -00024360: 743a 206e 6574 5f3c 494e 5445 5246 4143 t: net__dhcp_server_n │ │ │ │ │ -00024380: 616d 652c 2020 5072 6576 3a20 6d65 6e75 ame, Prev: menu │ │ │ │ │ -00024390: 5f63 6f6c 6f72 5f6e 6f72 6d61 6c2c 2020 _color_normal, │ │ │ │ │ -000243a0: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ │ -000243b0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ -000243c0: 730a 0a31 352e 312e 3232 206e 6574 5f3c s..15.1.22 net_< │ │ │ │ │ -000243d0: 494e 5445 5246 4143 453e 5f62 6f6f 745f INTERFACE>_boot_ │ │ │ │ │ -000243e0: 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d file.----------- │ │ │ │ │ +000241f0: 2d2d 2d2d 2d2d 2d0a 0a54 6869 7320 7661 -------..This va │ │ │ │ │ +00024200: 7269 6162 6c65 2063 6f6e 7461 696e 7320 riable contains │ │ │ │ │ +00024210: 7468 6520 666f 7265 6772 6f75 6e64 2061 the foreground a │ │ │ │ │ +00024220: 6e64 2062 6163 6b67 726f 756e 6420 636f nd background co │ │ │ │ │ +00024230: 6c6f 7273 2074 6f20 6265 2075 7365 640a lors to be used. │ │ │ │ │ +00024240: 666f 7220 6e6f 6e2d 6869 6768 6c69 6768 for non-highligh │ │ │ │ │ +00024250: 7465 6420 6d65 6e75 2065 6e74 7269 6573 ted menu entries │ │ │ │ │ +00024260: 2c20 7365 7061 7261 7465 6420 6279 2061 , separated by a │ │ │ │ │ +00024270: 2073 6c61 7368 2028 272f 2729 2e20 2053 slash ('/'). S │ │ │ │ │ +00024280: 6574 7469 6e67 0a74 6869 7320 7661 7269 etting.this vari │ │ │ │ │ +00024290: 6162 6c65 2063 6861 6e67 6573 2074 686f able changes tho │ │ │ │ │ +000242a0: 7365 2063 6f6c 6f72 732e 2020 466f 7220 se colors. For │ │ │ │ │ +000242b0: 7468 6520 6176 6169 6c61 626c 6520 636f the available co │ │ │ │ │ +000242c0: 6c6f 7220 6e61 6d65 732c 0a2a 6e6f 7465 lor names,.*note │ │ │ │ │ +000242d0: 2063 6f6c 6f72 5f6e 6f72 6d61 6c3a 3a2e color_normal::. │ │ │ │ │ +000242e0: 0a0a 2020 2054 6865 2064 6566 6175 6c74 .. The default │ │ │ │ │ +000242f0: 2069 7320 7468 6520 7661 6c75 6520 6f66 is the value of │ │ │ │ │ +00024300: 2027 636f 6c6f 725f 6e6f 726d 616c 2720 'color_normal' │ │ │ │ │ +00024310: 282a 6e6f 7465 2063 6f6c 6f72 5f6e 6f72 (*note color_nor │ │ │ │ │ +00024320: 6d61 6c3a 3a29 2e0a 0a1f 0a46 696c 653a mal::).....File: │ │ │ │ │ +00024330: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00024340: 653a 206e 6574 5f3c 494e 5445 5246 4143 e: net__boot_file, N │ │ │ │ │ +00024360: 6578 743a 206e 6574 5f3c 494e 5445 5246 ext: net__dhcp_server │ │ │ │ │ +00024380: 5f6e 616d 652c 2020 5072 6576 3a20 6d65 _name, Prev: me │ │ │ │ │ +00024390: 6e75 5f63 6f6c 6f72 5f6e 6f72 6d61 6c2c nu_color_normal, │ │ │ │ │ +000243a0: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ │ +000243b0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +000243c0: 6c65 730a 0a31 352e 312e 3232 206e 6574 les..15.1.22 net │ │ │ │ │ +000243d0: 5f3c 494e 5445 5246 4143 453e 5f62 6f6f __boo │ │ │ │ │ +000243e0: 745f 6669 6c65 0a2d 2d2d 2d2d 2d2d 2d2d t_file.--------- │ │ │ │ │ 000243f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024400: 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 ------..*Note Ne │ │ │ │ │ -00024410: 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 twork::.....File │ │ │ │ │ -00024420: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -00024430: 6465 3a20 6e65 745f 3c49 4e54 4552 4641 de: net__dhcp_server_ │ │ │ │ │ -00024450: 6e61 6d65 2c20 204e 6578 743a 206e 6574 name, Next: net │ │ │ │ │ -00024460: 5f3c 494e 5445 5246 4143 453e 5f64 6f6d __dom │ │ │ │ │ -00024470: 6169 6e2c 2020 5072 6576 3a20 6e65 745f ain, Prev: net_ │ │ │ │ │ -00024480: 3c49 4e54 4552 4641 4345 3e5f 626f 6f74 _boot │ │ │ │ │ -00024490: 5f66 696c 652c 2020 5570 3a20 5370 6563 _file, Up: Spec │ │ │ │ │ -000244a0: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ -000244b0: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ -000244c0: 3233 206e 6574 5f3c 494e 5445 5246 4143 23 net__dhcp_server_n │ │ │ │ │ -000244e0: 616d 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ame.------------ │ │ │ │ │ +00024400: 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 --------..*Note │ │ │ │ │ +00024410: 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 Network::.....Fi │ │ │ │ │ +00024420: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +00024430: 4e6f 6465 3a20 6e65 745f 3c49 4e54 4552 Node: net__dhcp_serve │ │ │ │ │ +00024450: 725f 6e61 6d65 2c20 204e 6578 743a 206e r_name, Next: n │ │ │ │ │ +00024460: 6574 5f3c 494e 5445 5246 4143 453e 5f64 et__d │ │ │ │ │ +00024470: 6f6d 6169 6e2c 2020 5072 6576 3a20 6e65 omain, Prev: ne │ │ │ │ │ +00024480: 745f 3c49 4e54 4552 4641 4345 3e5f 626f t__bo │ │ │ │ │ +00024490: 6f74 5f66 696c 652c 2020 5570 3a20 5370 ot_file, Up: Sp │ │ │ │ │ +000244a0: 6563 6961 6c20 656e 7669 726f 6e6d 656e ecial environmen │ │ │ │ │ +000244b0: 7420 7661 7269 6162 6c65 730a 0a31 352e t variables..15. │ │ │ │ │ +000244c0: 312e 3233 206e 6574 5f3c 494e 5445 5246 1.23 net__dhcp_server │ │ │ │ │ +000244e0: 5f6e 616d 650a 2d2d 2d2d 2d2d 2d2d 2d2d _name.---------- │ │ │ │ │ 000244f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e ------------..*N │ │ │ │ │ -00024510: 6f74 6520 4e65 7477 6f72 6b3a 3a2e 0a0a ote Network::... │ │ │ │ │ -00024520: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00024530: 6f2c 2020 4e6f 6465 3a20 6e65 745f 3c49 o, Node: net__domain │ │ │ │ │ -00024550: 2c20 204e 6578 743a 206e 6574 5f3c 494e , Next: net__extensi │ │ │ │ │ -00024570: 6f6e 7370 6174 682c 2020 5072 6576 3a20 onspath, Prev: │ │ │ │ │ -00024580: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -00024590: 6468 6370 5f73 6572 7665 725f 6e61 6d65 dhcp_server_name │ │ │ │ │ -000245a0: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ -000245b0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -000245c0: 626c 6573 0a0a 3135 2e31 2e32 3420 6e65 bles..15.1.24 ne │ │ │ │ │ -000245d0: 745f 3c49 4e54 4552 4641 4345 3e5f 646f t__do │ │ │ │ │ -000245e0: 6d61 696e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d main.----------- │ │ │ │ │ +00024500: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00024510: 2a4e 6f74 6520 4e65 7477 6f72 6b3a 3a2e *Note Network::. │ │ │ │ │ +00024520: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00024530: 6e66 6f2c 2020 4e6f 6465 3a20 6e65 745f nfo, Node: net_ │ │ │ │ │ +00024540: 3c49 4e54 4552 4641 4345 3e5f 646f 6d61 _doma │ │ │ │ │ +00024550: 696e 2c20 204e 6578 743a 206e 6574 5f3c in, Next: net_< │ │ │ │ │ +00024560: 494e 5445 5246 4143 453e 5f65 7874 656e INTERFACE>_exten │ │ │ │ │ +00024570: 7369 6f6e 7370 6174 682c 2020 5072 6576 sionspath, Prev │ │ │ │ │ +00024580: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__dhcp_server_na │ │ │ │ │ +000245a0: 6d65 2c20 2055 703a 2053 7065 6369 616c me, Up: Special │ │ │ │ │ +000245b0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +000245c0: 6961 626c 6573 0a0a 3135 2e31 2e32 3420 iables..15.1.24 │ │ │ │ │ +000245d0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ +000245e0: 646f 6d61 696e 0a2d 2d2d 2d2d 2d2d 2d2d domain.--------- │ │ │ │ │ 000245f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024600: 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 776f ---..*Note Netwo │ │ │ │ │ -00024610: 726b 3a3a 2e0a 0a1f 0a46 696c 653a 2067 rk::.....File: g │ │ │ │ │ -00024620: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00024630: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ -00024640: 5f65 7874 656e 7369 6f6e 7370 6174 682c _extensionspath, │ │ │ │ │ -00024650: 2020 4e65 7874 3a20 6e65 745f 3c49 4e54 Next: net__hostname │ │ │ │ │ -00024670: 2c20 2050 7265 763a 206e 6574 5f3c 494e , Prev: net__domain, │ │ │ │ │ -00024690: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ │ -000246a0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ -000246b0: 6c65 730a 0a31 352e 312e 3235 206e 6574 les..15.1.25 net │ │ │ │ │ -000246c0: 5f3c 494e 5445 5246 4143 453e 5f65 7874 __ext │ │ │ │ │ -000246d0: 656e 7369 6f6e 7370 6174 680a 2d2d 2d2d ensionspath.---- │ │ │ │ │ +00024600: 2d2d 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 -----..*Note Net │ │ │ │ │ +00024610: 776f 726b 3a3a 2e0a 0a1f 0a46 696c 653a work::.....File: │ │ │ │ │ +00024620: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00024630: 653a 206e 6574 5f3c 494e 5445 5246 4143 e: net__extensionspat │ │ │ │ │ +00024650: 682c 2020 4e65 7874 3a20 6e65 745f 3c49 h, Next: net__hostna │ │ │ │ │ +00024670: 6d65 2c20 2050 7265 763a 206e 6574 5f3c me, Prev: net_< │ │ │ │ │ +00024680: 494e 5445 5246 4143 453e 5f64 6f6d 6169 INTERFACE>_domai │ │ │ │ │ +00024690: 6e2c 2020 5570 3a20 5370 6563 6961 6c20 n, Up: Special │ │ │ │ │ +000246a0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ +000246b0: 6162 6c65 730a 0a31 352e 312e 3235 206e ables..15.1.25 n │ │ │ │ │ +000246c0: 6574 5f3c 494e 5445 5246 4143 453e 5f65 et__e │ │ │ │ │ +000246d0: 7874 656e 7369 6f6e 7370 6174 680a 2d2d xtensionspath.-- │ │ │ │ │ 000246e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 000246f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024700: 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 6f72 --..*Note Networ │ │ │ │ │ -00024710: 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 k::.....File: gr │ │ │ │ │ -00024720: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00024730: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -00024740: 686f 7374 6e61 6d65 2c20 204e 6578 743a hostname, Next: │ │ │ │ │ -00024750: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ -00024760: 5f69 702c 2020 5072 6576 3a20 6e65 745f _ip, Prev: net_ │ │ │ │ │ -00024770: 3c49 4e54 4552 4641 4345 3e5f 6578 7465 _exte │ │ │ │ │ -00024780: 6e73 696f 6e73 7061 7468 2c20 2055 703a nsionspath, Up: │ │ │ │ │ -00024790: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ -000247a0: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ │ -000247b0: 3135 2e31 2e32 3620 6e65 745f 3c49 4e54 15.1.26 net__hostname │ │ │ │ │ -000247d0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +00024700: 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 ----..*Note Netw │ │ │ │ │ +00024710: 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 ork::.....File: │ │ │ │ │ +00024720: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00024730: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__hostname, Nex │ │ │ │ │ +00024750: 743a 206e 6574 5f3c 494e 5445 5246 4143 t: net__ip, Prev: ne │ │ │ │ │ +00024770: 745f 3c49 4e54 4552 4641 4345 3e5f 6578 t__ex │ │ │ │ │ +00024780: 7465 6e73 696f 6e73 7061 7468 2c20 2055 tensionspath, U │ │ │ │ │ +00024790: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ +000247a0: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ +000247b0: 0a0a 3135 2e31 2e32 3620 6e65 745f 3c49 ..15.1.26 net__hostna │ │ │ │ │ +000247d0: 6d65 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d me.------------- │ │ │ │ │ 000247e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000247f0: 2d0a 0a2a 4e6f 7465 204e 6574 776f 726b -..*Note Network │ │ │ │ │ -00024800: 3a3a 2e0a 0a1f 0a46 696c 653a 2067 7275 ::.....File: gru │ │ │ │ │ -00024810: 622e 696e 666f 2c20 204e 6f64 653a 206e b.info, Node: n │ │ │ │ │ -00024820: 6574 5f3c 494e 5445 5246 4143 453e 5f69 et__i │ │ │ │ │ -00024830: 702c 2020 4e65 7874 3a20 6e65 745f 3c49 p, Next: net__mac, │ │ │ │ │ -00024850: 5072 6576 3a20 6e65 745f 3c49 4e54 4552 Prev: net__hostname, │ │ │ │ │ -00024870: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ -00024880: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -00024890: 6573 0a0a 3135 2e31 2e32 3720 6e65 745f es..15.1.27 net_ │ │ │ │ │ -000248a0: 3c49 4e54 4552 4641 4345 3e5f 6970 0a2d _ip.- │ │ │ │ │ -000248b0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000248c0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f 7465 ---------..*Note │ │ │ │ │ -000248d0: 204e 6574 776f 726b 3a3a 2e0a 0a1f 0a46 Network::.....F │ │ │ │ │ -000248e0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -000248f0: 204e 6f64 653a 206e 6574 5f3c 494e 5445 Node: net__mac, Nex │ │ │ │ │ -00024910: 743a 206e 6574 5f3c 494e 5445 5246 4143 t: net__next_server, │ │ │ │ │ -00024930: 2050 7265 763a 206e 6574 5f3c 494e 5445 Prev: net__ip, Up: │ │ │ │ │ -00024950: 5370 6563 6961 6c20 656e 7669 726f 6e6d Special environm │ │ │ │ │ -00024960: 656e 7420 7661 7269 6162 6c65 730a 0a31 ent variables..1 │ │ │ │ │ -00024970: 352e 312e 3238 206e 6574 5f3c 494e 5445 5.1.28 net__mac.----- │ │ │ │ │ +000247f0: 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 776f ---..*Note Netwo │ │ │ │ │ +00024800: 726b 3a3a 2e0a 0a1f 0a46 696c 653a 2067 rk::.....File: g │ │ │ │ │ +00024810: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +00024820: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ +00024830: 5f69 702c 2020 4e65 7874 3a20 6e65 745f _ip, Next: net_ │ │ │ │ │ +00024840: 3c49 4e54 4552 4641 4345 3e5f 6d61 632c _mac, │ │ │ │ │ +00024850: 2020 5072 6576 3a20 6e65 745f 3c49 4e54 Prev: net__hostname │ │ │ │ │ +00024870: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ +00024880: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00024890: 626c 6573 0a0a 3135 2e31 2e32 3720 6e65 bles..15.1.27 ne │ │ │ │ │ +000248a0: 745f 3c49 4e54 4552 4641 4345 3e5f 6970 t__ip │ │ │ │ │ +000248b0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +000248c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f -----------..*No │ │ │ │ │ +000248d0: 7465 204e 6574 776f 726b 3a3a 2e0a 0a1f te Network::.... │ │ │ │ │ +000248e0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +000248f0: 2c20 204e 6f64 653a 206e 6574 5f3c 494e , Node: net__mac, N │ │ │ │ │ +00024910: 6578 743a 206e 6574 5f3c 494e 5445 5246 ext: net__next_server │ │ │ │ │ +00024930: 2c20 2050 7265 763a 206e 6574 5f3c 494e , Prev: net__ip, Up │ │ │ │ │ +00024950: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ │ +00024960: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ │ +00024970: 0a31 352e 312e 3238 206e 6574 5f3c 494e .15.1.28 net__mac.--- │ │ │ │ │ 00024990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000249a0: 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 ------..*Note Ne │ │ │ │ │ -000249b0: 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 twork::.....File │ │ │ │ │ -000249c0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -000249d0: 6465 3a20 6e65 745f 3c49 4e54 4552 4641 de: net__next_server, │ │ │ │ │ -000249f0: 2020 4e65 7874 3a20 6e65 745f 3c49 4e54 Next: net__rootpath │ │ │ │ │ -00024a10: 2c20 2050 7265 763a 206e 6574 5f3c 494e , Prev: net__mac, U │ │ │ │ │ -00024a30: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ -00024a40: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ -00024a50: 0a0a 3135 2e31 2e32 3920 6e65 745f 3c49 ..15.1.29 net__next_s │ │ │ │ │ -00024a70: 6572 7665 720a 2d2d 2d2d 2d2d 2d2d 2d2d erver.---------- │ │ │ │ │ +000249a0: 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 --------..*Note │ │ │ │ │ +000249b0: 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 Network::.....Fi │ │ │ │ │ +000249c0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +000249d0: 4e6f 6465 3a20 6e65 745f 3c49 4e54 4552 Node: net__next_serve │ │ │ │ │ +000249f0: 722c 2020 4e65 7874 3a20 6e65 745f 3c49 r, Next: net__rootpa │ │ │ │ │ +00024a10: 7468 2c20 2050 7265 763a 206e 6574 5f3c th, Prev: net_< │ │ │ │ │ +00024a20: 494e 5445 5246 4143 453e 5f6d 6163 2c20 INTERFACE>_mac, │ │ │ │ │ +00024a30: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ +00024a40: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +00024a50: 6573 0a0a 3135 2e31 2e32 3920 6e65 745f es..15.1.29 net_ │ │ │ │ │ +00024a60: 3c49 4e54 4552 4641 4345 3e5f 6e65 7874 _next │ │ │ │ │ +00024a70: 5f73 6572 7665 720a 2d2d 2d2d 2d2d 2d2d _server.-------- │ │ │ │ │ 00024a80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024a90: 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f 7465 ---------..*Note │ │ │ │ │ -00024aa0: 204e 6574 776f 726b 3a3a 2e0a 0a1f 0a46 Network::.....F │ │ │ │ │ -00024ab0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -00024ac0: 204e 6f64 653a 206e 6574 5f3c 494e 5445 Node: net__rootpath, │ │ │ │ │ -00024ae0: 2020 4e65 7874 3a20 6e65 745f 6465 6661 Next: net_defa │ │ │ │ │ -00024af0: 756c 745f 696e 7465 7266 6163 652c 2020 ult_interface, │ │ │ │ │ -00024b00: 5072 6576 3a20 6e65 745f 3c49 4e54 4552 Prev: net__next_serve │ │ │ │ │ -00024b20: 722c 2020 5570 3a20 5370 6563 6961 6c20 r, Up: Special │ │ │ │ │ -00024b30: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -00024b40: 6162 6c65 730a 0a31 352e 312e 3330 206e ables..15.1.30 n │ │ │ │ │ -00024b50: 6574 5f3c 494e 5445 5246 4143 453e 5f72 et__r │ │ │ │ │ -00024b60: 6f6f 7470 6174 680a 2d2d 2d2d 2d2d 2d2d ootpath.-------- │ │ │ │ │ +00024a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f -----------..*No │ │ │ │ │ +00024aa0: 7465 204e 6574 776f 726b 3a3a 2e0a 0a1f te Network::.... │ │ │ │ │ +00024ab0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +00024ac0: 2c20 204e 6f64 653a 206e 6574 5f3c 494e , Node: net__rootpat │ │ │ │ │ +00024ae0: 682c 2020 4e65 7874 3a20 6e65 745f 6465 h, Next: net_de │ │ │ │ │ +00024af0: 6661 756c 745f 696e 7465 7266 6163 652c fault_interface, │ │ │ │ │ +00024b00: 2020 5072 6576 3a20 6e65 745f 3c49 4e54 Prev: net__next_ser │ │ │ │ │ +00024b20: 7665 722c 2020 5570 3a20 5370 6563 6961 ver, Up: Specia │ │ │ │ │ +00024b30: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ +00024b40: 7269 6162 6c65 730a 0a31 352e 312e 3330 riables..15.1.30 │ │ │ │ │ +00024b50: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ +00024b60: 5f72 6f6f 7470 6174 680a 2d2d 2d2d 2d2d _rootpath.------ │ │ │ │ │ 00024b70: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024b80: 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 --------..*Note │ │ │ │ │ -00024b90: 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 Network::.....Fi │ │ │ │ │ -00024ba0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00024bb0: 4e6f 6465 3a20 6e65 745f 6465 6661 756c Node: net_defaul │ │ │ │ │ -00024bc0: 745f 696e 7465 7266 6163 652c 2020 4e65 t_interface, Ne │ │ │ │ │ -00024bd0: 7874 3a20 6e65 745f 6465 6661 756c 745f xt: net_default_ │ │ │ │ │ -00024be0: 6970 2c20 2050 7265 763a 206e 6574 5f3c ip, Prev: net_< │ │ │ │ │ -00024bf0: 494e 5445 5246 4143 453e 5f72 6f6f 7470 INTERFACE>_rootp │ │ │ │ │ -00024c00: 6174 682c 2020 5570 3a20 5370 6563 6961 ath, Up: Specia │ │ │ │ │ -00024c10: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ -00024c20: 7269 6162 6c65 730a 0a31 352e 312e 3331 riables..15.1.31 │ │ │ │ │ -00024c30: 206e 6574 5f64 6566 6175 6c74 5f69 6e74 net_default_int │ │ │ │ │ -00024c40: 6572 6661 6365 0a2d 2d2d 2d2d 2d2d 2d2d erface.--------- │ │ │ │ │ +00024b80: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 ----------..*Not │ │ │ │ │ +00024b90: 6520 4e65 7477 6f72 6b3a 3a2e 0a0a 1f0a e Network::..... │ │ │ │ │ +00024ba0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00024bb0: 2020 4e6f 6465 3a20 6e65 745f 6465 6661 Node: net_defa │ │ │ │ │ +00024bc0: 756c 745f 696e 7465 7266 6163 652c 2020 ult_interface, │ │ │ │ │ +00024bd0: 4e65 7874 3a20 6e65 745f 6465 6661 756c Next: net_defaul │ │ │ │ │ +00024be0: 745f 6970 2c20 2050 7265 763a 206e 6574 t_ip, Prev: net │ │ │ │ │ +00024bf0: 5f3c 494e 5445 5246 4143 453e 5f72 6f6f __roo │ │ │ │ │ +00024c00: 7470 6174 682c 2020 5570 3a20 5370 6563 tpath, Up: Spec │ │ │ │ │ +00024c10: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ +00024c20: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ +00024c30: 3331 206e 6574 5f64 6566 6175 6c74 5f69 31 net_default_i │ │ │ │ │ +00024c40: 6e74 6572 6661 6365 0a2d 2d2d 2d2d 2d2d nterface.------- │ │ │ │ │ 00024c50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00024c60: 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 ----..*Note Netw │ │ │ │ │ -00024c70: 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 ork::.....File: │ │ │ │ │ -00024c80: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00024c90: 3a20 6e65 745f 6465 6661 756c 745f 6970 : net_default_ip │ │ │ │ │ -00024ca0: 2c20 204e 6578 743a 206e 6574 5f64 6566 , Next: net_def │ │ │ │ │ -00024cb0: 6175 6c74 5f6d 6163 2c20 2050 7265 763a ault_mac, Prev: │ │ │ │ │ -00024cc0: 206e 6574 5f64 6566 6175 6c74 5f69 6e74 net_default_int │ │ │ │ │ -00024cd0: 6572 6661 6365 2c20 2055 703a 2053 7065 erface, Up: Spe │ │ │ │ │ -00024ce0: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ -00024cf0: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ │ -00024d00: 2e33 3220 6e65 745f 6465 6661 756c 745f .32 net_default_ │ │ │ │ │ -00024d10: 6970 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ip.------------- │ │ │ │ │ -00024d20: 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f 7465 ---------..*Note │ │ │ │ │ -00024d30: 204e 6574 776f 726b 3a3a 2e0a 0a1f 0a46 Network::.....F │ │ │ │ │ -00024d40: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -00024d50: 204e 6f64 653a 206e 6574 5f64 6566 6175 Node: net_defau │ │ │ │ │ -00024d60: 6c74 5f6d 6163 2c20 204e 6578 743a 206e lt_mac, Next: n │ │ │ │ │ -00024d70: 6574 5f64 6566 6175 6c74 5f73 6572 7665 et_default_serve │ │ │ │ │ -00024d80: 722c 2020 5072 6576 3a20 6e65 745f 6465 r, Prev: net_de │ │ │ │ │ -00024d90: 6661 756c 745f 6970 2c20 2055 703a 2053 fault_ip, Up: S │ │ │ │ │ -00024da0: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ -00024db0: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ │ -00024dc0: 2e31 2e33 3320 6e65 745f 6465 6661 756c .1.33 net_defaul │ │ │ │ │ -00024dd0: 745f 6d61 630a 2d2d 2d2d 2d2d 2d2d 2d2d t_mac.---------- │ │ │ │ │ -00024de0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a -------------..* │ │ │ │ │ -00024df0: 4e6f 7465 204e 6574 776f 726b 3a3a 2e0a Note Network::.. │ │ │ │ │ -00024e00: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00024e10: 666f 2c20 204e 6f64 653a 206e 6574 5f64 fo, Node: net_d │ │ │ │ │ -00024e20: 6566 6175 6c74 5f73 6572 7665 722c 2020 efault_server, │ │ │ │ │ -00024e30: 4e65 7874 3a20 7061 6765 722c 2020 5072 Next: pager, Pr │ │ │ │ │ -00024e40: 6576 3a20 6e65 745f 6465 6661 756c 745f ev: net_default_ │ │ │ │ │ -00024e50: 6d61 632c 2020 5570 3a20 5370 6563 6961 mac, Up: Specia │ │ │ │ │ -00024e60: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ -00024e70: 7269 6162 6c65 730a 0a31 352e 312e 3334 riables..15.1.34 │ │ │ │ │ -00024e80: 206e 6574 5f64 6566 6175 6c74 5f73 6572 net_default_ser │ │ │ │ │ -00024e90: 7665 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ver.------------ │ │ │ │ │ -00024ea0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -00024eb0: 2a4e 6f74 6520 4e65 7477 6f72 6b3a 3a2e *Note Network::. │ │ │ │ │ -00024ec0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00024ed0: 6e66 6f2c 2020 4e6f 6465 3a20 7061 6765 nfo, Node: page │ │ │ │ │ -00024ee0: 722c 2020 4e65 7874 3a20 7072 6566 6978 r, Next: prefix │ │ │ │ │ -00024ef0: 2c20 2050 7265 763a 206e 6574 5f64 6566 , Prev: net_def │ │ │ │ │ -00024f00: 6175 6c74 5f73 6572 7665 722c 2020 5570 ault_server, Up │ │ │ │ │ -00024f10: 3a20 5370 6563 6961 6c20 656e 7669 726f : Special enviro │ │ │ │ │ -00024f20: 6e6d 656e 7420 7661 7269 6162 6c65 730a nment variables. │ │ │ │ │ -00024f30: 0a31 352e 312e 3335 2070 6167 6572 0a2d .15.1.35 pager.- │ │ │ │ │ -00024f40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 4966 ------------..If │ │ │ │ │ -00024f50: 2073 6574 2074 6f20 2731 272c 2070 6175 set to '1', pau │ │ │ │ │ -00024f60: 7365 206f 7574 7075 7420 6166 7465 7220 se output after │ │ │ │ │ -00024f70: 6561 6368 2073 6372 6565 6e66 756c 2061 each screenful a │ │ │ │ │ -00024f80: 6e64 2077 6169 7420 666f 7220 6b65 7962 nd wait for keyb │ │ │ │ │ -00024f90: 6f61 7264 0a69 6e70 7574 2e20 2054 6865 oard.input. The │ │ │ │ │ -00024fa0: 2064 6566 6175 6c74 2069 7320 6e6f 7420 default is not │ │ │ │ │ -00024fb0: 746f 2070 6175 7365 206f 7574 7075 742e to pause output. │ │ │ │ │ -00024fc0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00024fd0: 6e66 6f2c 2020 4e6f 6465 3a20 7072 6566 nfo, Node: pref │ │ │ │ │ -00024fe0: 6978 2c20 204e 6578 743a 2070 7865 5f62 ix, Next: pxe_b │ │ │ │ │ -00024ff0: 6c6b 7369 7a65 2c20 2050 7265 763a 2070 lksize, Prev: p │ │ │ │ │ -00025000: 6167 6572 2c20 2055 703a 2053 7065 6369 ager, Up: Speci │ │ │ │ │ -00025010: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ │ -00025020: 6172 6961 626c 6573 0a0a 3135 2e31 2e33 ariables..15.1.3 │ │ │ │ │ -00025030: 3620 7072 6566 6978 0a2d 2d2d 2d2d 2d2d 6 prefix.------- │ │ │ │ │ -00025040: 2d2d 2d2d 2d2d 2d0a 0a54 6865 206c 6f63 -------..The loc │ │ │ │ │ -00025050: 6174 696f 6e20 6f66 2074 6865 2027 2f62 ation of the '/b │ │ │ │ │ -00025060: 6f6f 742f 6772 7562 2720 6469 7265 6374 oot/grub' direct │ │ │ │ │ -00025070: 6f72 7920 6173 2061 6e20 6162 736f 6c75 ory as an absolu │ │ │ │ │ -00025080: 7465 2066 696c 6520 6e61 6d65 0a28 2a6e te file name.(*n │ │ │ │ │ -00025090: 6f74 6520 4669 6c65 206e 616d 6520 7379 ote File name sy │ │ │ │ │ -000250a0: 6e74 6178 3a3a 292e 2020 5468 6973 2069 ntax::). This i │ │ │ │ │ -000250b0: 7320 6e6f 726d 616c 6c79 2073 6574 2062 s normally set b │ │ │ │ │ -000250c0: 7920 4752 5542 2061 7420 7374 6172 7475 y GRUB at startu │ │ │ │ │ -000250d0: 700a 6261 7365 6420 6f6e 2069 6e66 6f72 p.based on infor │ │ │ │ │ -000250e0: 6d61 7469 6f6e 2070 726f 7669 6465 6420 mation provided │ │ │ │ │ -000250f0: 6279 2027 6772 7562 2d69 6e73 7461 6c6c by 'grub-install │ │ │ │ │ -00025100: 272e 2020 4752 5542 206d 6f64 756c 6573 '. GRUB modules │ │ │ │ │ -00025110: 2061 7265 0a64 796e 616d 6963 616c 6c79 are.dynamically │ │ │ │ │ -00025120: 206c 6f61 6465 6420 6672 6f6d 2074 6869 loaded from thi │ │ │ │ │ -00025130: 7320 6469 7265 6374 6f72 792c 2073 6f20 s directory, so │ │ │ │ │ -00025140: 6974 206d 7573 7420 6265 2073 6574 2063 it must be set c │ │ │ │ │ -00025150: 6f72 7265 6374 6c79 2069 6e0a 6f72 6465 orrectly in.orde │ │ │ │ │ -00025160: 7220 666f 7220 6d61 6e79 2070 6172 7473 r for many parts │ │ │ │ │ -00025170: 206f 6620 4752 5542 2074 6f20 776f 726b of GRUB to work │ │ │ │ │ -00025180: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -00025190: 696e 666f 2c20 204e 6f64 653a 2070 7865 info, Node: pxe │ │ │ │ │ -000251a0: 5f62 6c6b 7369 7a65 2c20 204e 6578 743a _blksize, Next: │ │ │ │ │ -000251b0: 2070 7865 5f64 6566 6175 6c74 5f67 6174 pxe_default_gat │ │ │ │ │ -000251c0: 6577 6179 2c20 2050 7265 763a 2070 7265 eway, Prev: pre │ │ │ │ │ -000251d0: 6669 782c 2020 5570 3a20 5370 6563 6961 fix, Up: Specia │ │ │ │ │ -000251e0: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ -000251f0: 7269 6162 6c65 730a 0a31 352e 312e 3337 riables..15.1.37 │ │ │ │ │ -00025200: 2070 7865 5f62 6c6b 7369 7a65 0a2d 2d2d pxe_blksize.--- │ │ │ │ │ +00024c60: 2d2d 2d2d 2d2d 0a0a 2a4e 6f74 6520 4e65 ------..*Note Ne │ │ │ │ │ +00024c70: 7477 6f72 6b3a 3a2e 0a0a 1f0a 4669 6c65 twork::.....File │ │ │ │ │ +00024c80: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00024c90: 6465 3a20 6e65 745f 6465 6661 756c 745f de: net_default_ │ │ │ │ │ +00024ca0: 6970 2c20 204e 6578 743a 206e 6574 5f64 ip, Next: net_d │ │ │ │ │ +00024cb0: 6566 6175 6c74 5f6d 6163 2c20 2050 7265 efault_mac, Pre │ │ │ │ │ +00024cc0: 763a 206e 6574 5f64 6566 6175 6c74 5f69 v: net_default_i │ │ │ │ │ +00024cd0: 6e74 6572 6661 6365 2c20 2055 703a 2053 nterface, Up: S │ │ │ │ │ +00024ce0: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ +00024cf0: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ │ +00024d00: 2e31 2e33 3220 6e65 745f 6465 6661 756c .1.32 net_defaul │ │ │ │ │ +00024d10: 745f 6970 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d t_ip.----------- │ │ │ │ │ +00024d20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a 4e6f -----------..*No │ │ │ │ │ +00024d30: 7465 204e 6574 776f 726b 3a3a 2e0a 0a1f te Network::.... │ │ │ │ │ +00024d40: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +00024d50: 2c20 204e 6f64 653a 206e 6574 5f64 6566 , Node: net_def │ │ │ │ │ +00024d60: 6175 6c74 5f6d 6163 2c20 204e 6578 743a ault_mac, Next: │ │ │ │ │ +00024d70: 206e 6574 5f64 6566 6175 6c74 5f73 6572 net_default_ser │ │ │ │ │ +00024d80: 7665 722c 2020 5072 6576 3a20 6e65 745f ver, Prev: net_ │ │ │ │ │ +00024d90: 6465 6661 756c 745f 6970 2c20 2055 703a default_ip, Up: │ │ │ │ │ +00024da0: 2053 7065 6369 616c 2065 6e76 6972 6f6e Special environ │ │ │ │ │ +00024db0: 6d65 6e74 2076 6172 6961 626c 6573 0a0a ment variables.. │ │ │ │ │ +00024dc0: 3135 2e31 2e33 3320 6e65 745f 6465 6661 15.1.33 net_defa │ │ │ │ │ +00024dd0: 756c 745f 6d61 630a 2d2d 2d2d 2d2d 2d2d ult_mac.-------- │ │ │ │ │ +00024de0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00024df0: 0a2a 4e6f 7465 204e 6574 776f 726b 3a3a .*Note Network:: │ │ │ │ │ +00024e00: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00024e10: 696e 666f 2c20 204e 6f64 653a 206e 6574 info, Node: net │ │ │ │ │ +00024e20: 5f64 6566 6175 6c74 5f73 6572 7665 722c _default_server, │ │ │ │ │ +00024e30: 2020 4e65 7874 3a20 7061 6765 722c 2020 Next: pager, │ │ │ │ │ +00024e40: 5072 6576 3a20 6e65 745f 6465 6661 756c Prev: net_defaul │ │ │ │ │ +00024e50: 745f 6d61 632c 2020 5570 3a20 5370 6563 t_mac, Up: Spec │ │ │ │ │ +00024e60: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ +00024e70: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ +00024e80: 3334 206e 6574 5f64 6566 6175 6c74 5f73 34 net_default_s │ │ │ │ │ +00024e90: 6572 7665 720a 2d2d 2d2d 2d2d 2d2d 2d2d erver.---------- │ │ │ │ │ +00024ea0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00024eb0: 0a0a 2a4e 6f74 6520 4e65 7477 6f72 6b3a ..*Note Network: │ │ │ │ │ +00024ec0: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ │ +00024ed0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7061 .info, Node: pa │ │ │ │ │ +00024ee0: 6765 722c 2020 4e65 7874 3a20 7072 6566 ger, Next: pref │ │ │ │ │ +00024ef0: 6978 2c20 2050 7265 763a 206e 6574 5f64 ix, Prev: net_d │ │ │ │ │ +00024f00: 6566 6175 6c74 5f73 6572 7665 722c 2020 efault_server, │ │ │ │ │ +00024f10: 5570 3a20 5370 6563 6961 6c20 656e 7669 Up: Special envi │ │ │ │ │ +00024f20: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ +00024f30: 730a 0a31 352e 312e 3335 2070 6167 6572 s..15.1.35 pager │ │ │ │ │ +00024f40: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a .-------------.. │ │ │ │ │ +00024f50: 4966 2073 6574 2074 6f20 2731 272c 2070 If set to '1', p │ │ │ │ │ +00024f60: 6175 7365 206f 7574 7075 7420 6166 7465 ause output afte │ │ │ │ │ +00024f70: 7220 6561 6368 2073 6372 6565 6e66 756c r each screenful │ │ │ │ │ +00024f80: 2061 6e64 2077 6169 7420 666f 7220 6b65 and wait for ke │ │ │ │ │ +00024f90: 7962 6f61 7264 0a69 6e70 7574 2e20 2054 yboard.input. T │ │ │ │ │ +00024fa0: 6865 2064 6566 6175 6c74 2069 7320 6e6f he default is no │ │ │ │ │ +00024fb0: 7420 746f 2070 6175 7365 206f 7574 7075 t to pause outpu │ │ │ │ │ +00024fc0: 742e 0a0a 1f0a 4669 6c65 3a20 6772 7562 t.....File: grub │ │ │ │ │ +00024fd0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7072 .info, Node: pr │ │ │ │ │ +00024fe0: 6566 6978 2c20 204e 6578 743a 2070 7865 efix, Next: pxe │ │ │ │ │ +00024ff0: 5f62 6c6b 7369 7a65 2c20 2050 7265 763a _blksize, Prev: │ │ │ │ │ +00025000: 2070 6167 6572 2c20 2055 703a 2053 7065 pager, Up: Spe │ │ │ │ │ +00025010: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ +00025020: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ │ +00025030: 2e33 3620 7072 6566 6978 0a2d 2d2d 2d2d .36 prefix.----- │ │ │ │ │ +00025040: 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 6865 206c ---------..The l │ │ │ │ │ +00025050: 6f63 6174 696f 6e20 6f66 2074 6865 2027 ocation of the ' │ │ │ │ │ +00025060: 2f62 6f6f 742f 6772 7562 2720 6469 7265 /boot/grub' dire │ │ │ │ │ +00025070: 6374 6f72 7920 6173 2061 6e20 6162 736f ctory as an abso │ │ │ │ │ +00025080: 6c75 7465 2066 696c 6520 6e61 6d65 0a28 lute file name.( │ │ │ │ │ +00025090: 2a6e 6f74 6520 4669 6c65 206e 616d 6520 *note File name │ │ │ │ │ +000250a0: 7379 6e74 6178 3a3a 292e 2020 5468 6973 syntax::). This │ │ │ │ │ +000250b0: 2069 7320 6e6f 726d 616c 6c79 2073 6574 is normally set │ │ │ │ │ +000250c0: 2062 7920 4752 5542 2061 7420 7374 6172 by GRUB at star │ │ │ │ │ +000250d0: 7475 700a 6261 7365 6420 6f6e 2069 6e66 tup.based on inf │ │ │ │ │ +000250e0: 6f72 6d61 7469 6f6e 2070 726f 7669 6465 ormation provide │ │ │ │ │ +000250f0: 6420 6279 2027 6772 7562 2d69 6e73 7461 d by 'grub-insta │ │ │ │ │ +00025100: 6c6c 272e 2020 4752 5542 206d 6f64 756c ll'. GRUB modul │ │ │ │ │ +00025110: 6573 2061 7265 0a64 796e 616d 6963 616c es are.dynamical │ │ │ │ │ +00025120: 6c79 206c 6f61 6465 6420 6672 6f6d 2074 ly loaded from t │ │ │ │ │ +00025130: 6869 7320 6469 7265 6374 6f72 792c 2073 his directory, s │ │ │ │ │ +00025140: 6f20 6974 206d 7573 7420 6265 2073 6574 o it must be set │ │ │ │ │ +00025150: 2063 6f72 7265 6374 6c79 2069 6e0a 6f72 correctly in.or │ │ │ │ │ +00025160: 6465 7220 666f 7220 6d61 6e79 2070 6172 der for many par │ │ │ │ │ +00025170: 7473 206f 6620 4752 5542 2074 6f20 776f ts of GRUB to wo │ │ │ │ │ +00025180: 726b 2e0a 0a1f 0a46 696c 653a 2067 7275 rk.....File: gru │ │ │ │ │ +00025190: 622e 696e 666f 2c20 204e 6f64 653a 2070 b.info, Node: p │ │ │ │ │ +000251a0: 7865 5f62 6c6b 7369 7a65 2c20 204e 6578 xe_blksize, Nex │ │ │ │ │ +000251b0: 743a 2070 7865 5f64 6566 6175 6c74 5f67 t: pxe_default_g │ │ │ │ │ +000251c0: 6174 6577 6179 2c20 2050 7265 763a 2070 ateway, Prev: p │ │ │ │ │ +000251d0: 7265 6669 782c 2020 5570 3a20 5370 6563 refix, Up: Spec │ │ │ │ │ +000251e0: 6961 6c20 656e 7669 726f 6e6d 656e 7420 ial environment │ │ │ │ │ +000251f0: 7661 7269 6162 6c65 730a 0a31 352e 312e variables..15.1. │ │ │ │ │ +00025200: 3337 2070 7865 5f62 6c6b 7369 7a65 0a2d 37 pxe_blksize.- │ │ │ │ │ 00025210: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00025220: 0a0a 2a4e 6f74 6520 4e65 7477 6f72 6b3a ..*Note Network: │ │ │ │ │ -00025230: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ │ -00025240: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7078 .info, Node: px │ │ │ │ │ -00025250: 655f 6465 6661 756c 745f 6761 7465 7761 e_default_gatewa │ │ │ │ │ -00025260: 792c 2020 4e65 7874 3a20 7078 655f 6465 y, Next: pxe_de │ │ │ │ │ -00025270: 6661 756c 745f 7365 7276 6572 2c20 2050 fault_server, P │ │ │ │ │ -00025280: 7265 763a 2070 7865 5f62 6c6b 7369 7a65 rev: pxe_blksize │ │ │ │ │ -00025290: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ -000252a0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -000252b0: 626c 6573 0a0a 3135 2e31 2e33 3820 7078 bles..15.1.38 px │ │ │ │ │ -000252c0: 655f 6465 6661 756c 745f 6761 7465 7761 e_default_gatewa │ │ │ │ │ -000252d0: 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d y.-------------- │ │ │ │ │ -000252e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a2a -------------..* │ │ │ │ │ -000252f0: 4e6f 7465 204e 6574 776f 726b 3a3a 2e0a Note Network::.. │ │ │ │ │ -00025300: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00025310: 666f 2c20 204e 6f64 653a 2070 7865 5f64 fo, Node: pxe_d │ │ │ │ │ -00025320: 6566 6175 6c74 5f73 6572 7665 722c 2020 efault_server, │ │ │ │ │ -00025330: 4e65 7874 3a20 726f 6f74 2c20 2050 7265 Next: root, Pre │ │ │ │ │ -00025340: 763a 2070 7865 5f64 6566 6175 6c74 5f67 v: pxe_default_g │ │ │ │ │ -00025350: 6174 6577 6179 2c20 2055 703a 2053 7065 ateway, Up: Spe │ │ │ │ │ -00025360: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ -00025370: 2076 6172 6961 626c 6573 0a0a 3135 2e31 variables..15.1 │ │ │ │ │ -00025380: 2e33 3920 7078 655f 6465 6661 756c 745f .39 pxe_default_ │ │ │ │ │ -00025390: 7365 7276 6572 0a2d 2d2d 2d2d 2d2d 2d2d server.--------- │ │ │ │ │ +00025220: 2d2d 0a0a 2a4e 6f74 6520 4e65 7477 6f72 --..*Note Networ │ │ │ │ │ +00025230: 6b3a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 k::.....File: gr │ │ │ │ │ +00025240: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00025250: 7078 655f 6465 6661 756c 745f 6761 7465 pxe_default_gate │ │ │ │ │ +00025260: 7761 792c 2020 4e65 7874 3a20 7078 655f way, Next: pxe_ │ │ │ │ │ +00025270: 6465 6661 756c 745f 7365 7276 6572 2c20 default_server, │ │ │ │ │ +00025280: 2050 7265 763a 2070 7865 5f62 6c6b 7369 Prev: pxe_blksi │ │ │ │ │ +00025290: 7a65 2c20 2055 703a 2053 7065 6369 616c ze, Up: Special │ │ │ │ │ +000252a0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +000252b0: 6961 626c 6573 0a0a 3135 2e31 2e33 3820 iables..15.1.38 │ │ │ │ │ +000252c0: 7078 655f 6465 6661 756c 745f 6761 7465 pxe_default_gate │ │ │ │ │ +000252d0: 7761 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d way.------------ │ │ │ │ │ +000252e0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +000252f0: 0a2a 4e6f 7465 204e 6574 776f 726b 3a3a .*Note Network:: │ │ │ │ │ +00025300: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00025310: 696e 666f 2c20 204e 6f64 653a 2070 7865 info, Node: pxe │ │ │ │ │ +00025320: 5f64 6566 6175 6c74 5f73 6572 7665 722c _default_server, │ │ │ │ │ +00025330: 2020 4e65 7874 3a20 726f 6f74 2c20 2050 Next: root, P │ │ │ │ │ +00025340: 7265 763a 2070 7865 5f64 6566 6175 6c74 rev: pxe_default │ │ │ │ │ +00025350: 5f67 6174 6577 6179 2c20 2055 703a 2053 _gateway, Up: S │ │ │ │ │ +00025360: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ +00025370: 6e74 2076 6172 6961 626c 6573 0a0a 3135 nt variables..15 │ │ │ │ │ +00025380: 2e31 2e33 3920 7078 655f 6465 6661 756c .1.39 pxe_defaul │ │ │ │ │ +00025390: 745f 7365 7276 6572 0a2d 2d2d 2d2d 2d2d t_server.------- │ │ │ │ │ 000253a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000253b0: 2d0a 0a2a 4e6f 7465 204e 6574 776f 726b -..*Note Network │ │ │ │ │ -000253c0: 3a3a 2e0a 0a1f 0a46 696c 653a 2067 7275 ::.....File: gru │ │ │ │ │ -000253d0: 622e 696e 666f 2c20 204e 6f64 653a 2072 b.info, Node: r │ │ │ │ │ -000253e0: 6f6f 742c 2020 4e65 7874 3a20 7375 7065 oot, Next: supe │ │ │ │ │ -000253f0: 7275 7365 7273 2c20 2050 7265 763a 2070 rusers, Prev: p │ │ │ │ │ -00025400: 7865 5f64 6566 6175 6c74 5f73 6572 7665 xe_default_serve │ │ │ │ │ -00025410: 722c 2020 5570 3a20 5370 6563 6961 6c20 r, Up: Special │ │ │ │ │ -00025420: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -00025430: 6162 6c65 730a 0a31 352e 312e 3430 2072 ables..15.1.40 r │ │ │ │ │ -00025440: 6f6f 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d oot.------------ │ │ │ │ │ -00025450: 0a0a 5468 6520 726f 6f74 2064 6576 6963 ..The root devic │ │ │ │ │ -00025460: 6520 6e61 6d65 2028 2a6e 6f74 6520 4465 e name (*note De │ │ │ │ │ -00025470: 7669 6365 2073 796e 7461 783a 3a29 2e20 vice syntax::). │ │ │ │ │ -00025480: 2041 6e79 2066 696c 6520 6e61 6d65 7320 Any file names │ │ │ │ │ -00025490: 7468 6174 2064 6f0a 6e6f 7420 7370 6563 that do.not spec │ │ │ │ │ -000254a0: 6966 7920 616e 2065 7870 6c69 6369 7420 ify an explicit │ │ │ │ │ -000254b0: 6465 7669 6365 206e 616d 6520 6172 6520 device name are │ │ │ │ │ -000254c0: 7265 6164 2066 726f 6d20 7468 6973 2064 read from this d │ │ │ │ │ -000254d0: 6576 6963 652e 2020 5468 650a 6465 6661 evice. The.defa │ │ │ │ │ -000254e0: 756c 7420 6973 206e 6f72 6d61 6c6c 7920 ult is normally │ │ │ │ │ -000254f0: 7365 7420 6279 2047 5255 4220 6174 2073 set by GRUB at s │ │ │ │ │ -00025500: 7461 7274 7570 2062 6173 6564 206f 6e20 tartup based on │ │ │ │ │ -00025510: 7468 6520 7661 6c75 6520 6f66 0a27 7072 the value of.'pr │ │ │ │ │ -00025520: 6566 6978 2720 282a 6e6f 7465 2070 7265 efix' (*note pre │ │ │ │ │ -00025530: 6669 783a 3a29 2e0a 0a20 2020 466f 7220 fix::)... For │ │ │ │ │ -00025540: 6578 616d 706c 652c 2069 6620 4752 5542 example, if GRUB │ │ │ │ │ -00025550: 2077 6173 2069 6e73 7461 6c6c 6564 2074 was installed t │ │ │ │ │ -00025560: 6f20 7468 6520 6669 7273 7420 7061 7274 o the first part │ │ │ │ │ -00025570: 6974 696f 6e20 6f66 2074 6865 0a66 6972 ition of the.fir │ │ │ │ │ -00025580: 7374 2068 6172 6420 6469 736b 2c20 7468 st hard disk, th │ │ │ │ │ -00025590: 656e 2027 7072 6566 6978 2720 6d69 6768 en 'prefix' migh │ │ │ │ │ -000255a0: 7420 6265 2073 6574 2074 6f20 2728 6864 t be set to '(hd │ │ │ │ │ -000255b0: 302c 6d73 646f 7331 292f 626f 6f74 2f67 0,msdos1)/boot/g │ │ │ │ │ -000255c0: 7275 6227 0a61 6e64 2027 726f 6f74 2720 rub'.and 'root' │ │ │ │ │ -000255d0: 746f 2027 6864 302c 6d73 646f 7331 272e to 'hd0,msdos1'. │ │ │ │ │ -000255e0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -000255f0: 6e66 6f2c 2020 4e6f 6465 3a20 7375 7065 nfo, Node: supe │ │ │ │ │ -00025600: 7275 7365 7273 2c20 204e 6578 743a 2074 rusers, Next: t │ │ │ │ │ -00025610: 6865 6d65 2c20 2050 7265 763a 2072 6f6f heme, Prev: roo │ │ │ │ │ -00025620: 742c 2020 5570 3a20 5370 6563 6961 6c20 t, Up: Special │ │ │ │ │ -00025630: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -00025640: 6162 6c65 730a 0a31 352e 312e 3431 2073 ables..15.1.41 s │ │ │ │ │ -00025650: 7570 6572 7573 6572 730a 2d2d 2d2d 2d2d uperusers.------ │ │ │ │ │ -00025660: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 5468 ------------..Th │ │ │ │ │ -00025670: 6973 2076 6172 6961 626c 6520 6d61 7920 is variable may │ │ │ │ │ -00025680: 6265 2073 6574 2074 6f20 6120 6c69 7374 be set to a list │ │ │ │ │ -00025690: 206f 6620 7375 7065 7275 7365 7220 6e61 of superuser na │ │ │ │ │ -000256a0: 6d65 7320 746f 2065 6e61 626c 650a 6175 mes to enable.au │ │ │ │ │ -000256b0: 7468 656e 7469 6361 7469 6f6e 2073 7570 thentication sup │ │ │ │ │ -000256c0: 706f 7274 2e20 202a 4e6f 7465 2053 6563 port. *Note Sec │ │ │ │ │ -000256d0: 7572 6974 793a 3a2e 0a0a 1f0a 4669 6c65 urity::.....File │ │ │ │ │ -000256e0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -000256f0: 6465 3a20 7468 656d 652c 2020 4e65 7874 de: theme, Next │ │ │ │ │ -00025700: 3a20 7469 6d65 6f75 742c 2020 5072 6576 : timeout, Prev │ │ │ │ │ -00025710: 3a20 7375 7065 7275 7365 7273 2c20 2055 : superusers, U │ │ │ │ │ -00025720: 703a 2053 7065 6369 616c 2065 6e76 6972 p: Special envir │ │ │ │ │ -00025730: 6f6e 6d65 6e74 2076 6172 6961 626c 6573 onment variables │ │ │ │ │ -00025740: 0a0a 3135 2e31 2e34 3220 7468 656d 650a ..15.1.42 theme. │ │ │ │ │ -00025750: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a54 -------------..T │ │ │ │ │ -00025760: 6869 7320 7661 7269 6162 6c65 206d 6179 his variable may │ │ │ │ │ -00025770: 2062 6520 7365 7420 746f 2061 2064 6972 be set to a dir │ │ │ │ │ -00025780: 6563 746f 7279 2063 6f6e 7461 696e 696e ectory containin │ │ │ │ │ -00025790: 6720 6120 4752 5542 2067 7261 7068 6963 g a GRUB graphic │ │ │ │ │ -000257a0: 616c 206d 656e 750a 7468 656d 652e 2020 al menu.theme. │ │ │ │ │ -000257b0: 2a4e 6f74 6520 5468 656d 6520 6669 6c65 *Note Theme file │ │ │ │ │ -000257c0: 2066 6f72 6d61 743a 3a2e 0a0a 2020 2054 format::... T │ │ │ │ │ -000257d0: 6869 7320 7661 7269 6162 6c65 2069 7320 his variable is │ │ │ │ │ -000257e0: 6f66 7465 6e20 7365 7420 6279 2027 4752 often set by 'GR │ │ │ │ │ -000257f0: 5542 5f54 4845 4d45 2720 282a 6e6f 7465 UB_THEME' (*note │ │ │ │ │ -00025800: 2053 696d 706c 650a 636f 6e66 6967 7572 Simple.configur │ │ │ │ │ -00025810: 6174 696f 6e3a 3a29 2e0a 0a1f 0a46 696c ation::).....Fil │ │ │ │ │ -00025820: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00025830: 6f64 653a 2074 696d 656f 7574 2c20 204e ode: timeout, N │ │ │ │ │ -00025840: 6578 743a 2074 696d 656f 7574 5f73 7479 ext: timeout_sty │ │ │ │ │ -00025850: 6c65 2c20 2050 7265 763a 2074 6865 6d65 le, Prev: theme │ │ │ │ │ -00025860: 2c20 2055 703a 2053 7065 6369 616c 2065 , Up: Special e │ │ │ │ │ -00025870: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -00025880: 626c 6573 0a0a 3135 2e31 2e34 3320 7469 bles..15.1.43 ti │ │ │ │ │ -00025890: 6d65 6f75 740a 2d2d 2d2d 2d2d 2d2d 2d2d meout.---------- │ │ │ │ │ -000258a0: 2d2d 2d2d 2d0a 0a49 6620 7468 6973 2076 -----..If this v │ │ │ │ │ -000258b0: 6172 6961 626c 6520 6973 2073 6574 2c20 ariable is set, │ │ │ │ │ -000258c0: 6974 2073 7065 6369 6669 6573 2074 6865 it specifies the │ │ │ │ │ -000258d0: 2074 696d 6520 696e 2073 6563 6f6e 6473 time in seconds │ │ │ │ │ -000258e0: 2074 6f20 7761 6974 2066 6f72 0a6b 6579 to wait for.key │ │ │ │ │ -000258f0: 626f 6172 6420 696e 7075 7420 6265 666f board input befo │ │ │ │ │ -00025900: 7265 2062 6f6f 7469 6e67 2074 6865 2064 re booting the d │ │ │ │ │ -00025910: 6566 6175 6c74 206d 656e 7520 656e 7472 efault menu entr │ │ │ │ │ -00025920: 792e 2020 4120 7469 6d65 6f75 7420 6f66 y. A timeout of │ │ │ │ │ -00025930: 2027 3027 0a6d 6561 6e73 2074 6f20 626f '0'.means to bo │ │ │ │ │ -00025940: 6f74 2074 6865 2064 6566 6175 6c74 2065 ot the default e │ │ │ │ │ -00025950: 6e74 7279 2069 6d6d 6564 6961 7465 6c79 ntry immediately │ │ │ │ │ -00025960: 2077 6974 686f 7574 2064 6973 706c 6179 without display │ │ │ │ │ -00025970: 696e 6720 7468 6520 6d65 6e75 3b0a 6120 ing the menu;.a │ │ │ │ │ -00025980: 7469 6d65 6f75 7420 6f66 2027 2d31 2720 timeout of '-1' │ │ │ │ │ -00025990: 286f 7220 756e 7365 7429 206d 6561 6e73 (or unset) means │ │ │ │ │ -000259a0: 2074 6f20 7761 6974 2069 6e64 6566 696e to wait indefin │ │ │ │ │ -000259b0: 6974 656c 792e 0a0a 2020 2049 6620 2774 itely... If 't │ │ │ │ │ -000259c0: 696d 656f 7574 5f73 7479 6c65 2720 282a imeout_style' (* │ │ │ │ │ -000259d0: 6e6f 7465 2074 696d 656f 7574 5f73 7479 note timeout_sty │ │ │ │ │ -000259e0: 6c65 3a3a 2920 6973 2073 6574 2074 6f20 le::) is set to │ │ │ │ │ -000259f0: 2763 6f75 6e74 646f 776e 2720 6f72 0a27 'countdown' or.' │ │ │ │ │ -00025a00: 6869 6464 656e 272c 2074 6865 2074 696d hidden', the tim │ │ │ │ │ -00025a10: 656f 7574 2069 7320 696e 7374 6561 6420 eout is instead │ │ │ │ │ -00025a20: 636f 756e 7465 6420 6265 666f 7265 2074 counted before t │ │ │ │ │ -00025a30: 6865 206d 656e 7520 6973 2064 6973 706c he menu is displ │ │ │ │ │ -00025a40: 6179 6564 2e0a 0a20 2020 5468 6973 2076 ayed... This v │ │ │ │ │ -00025a50: 6172 6961 626c 6520 6973 206f 6674 656e ariable is often │ │ │ │ │ -00025a60: 2073 6574 2062 7920 2747 5255 425f 5449 set by 'GRUB_TI │ │ │ │ │ -00025a70: 4d45 4f55 5427 2028 2a6e 6f74 6520 5369 MEOUT' (*note Si │ │ │ │ │ -00025a80: 6d70 6c65 0a63 6f6e 6669 6775 7261 7469 mple.configurati │ │ │ │ │ -00025a90: 6f6e 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 on::).....File: │ │ │ │ │ -00025aa0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00025ab0: 3a20 7469 6d65 6f75 745f 7374 796c 652c : timeout_style, │ │ │ │ │ -00025ac0: 2020 5072 6576 3a20 7469 6d65 6f75 742c Prev: timeout, │ │ │ │ │ -00025ad0: 2020 5570 3a20 5370 6563 6961 6c20 656e Up: Special en │ │ │ │ │ -00025ae0: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ -00025af0: 6c65 730a 0a31 352e 312e 3434 2074 696d les..15.1.44 tim │ │ │ │ │ -00025b00: 656f 7574 5f73 7479 6c65 0a2d 2d2d 2d2d eout_style.----- │ │ │ │ │ +000253b0: 2d2d 2d0a 0a2a 4e6f 7465 204e 6574 776f ---..*Note Netwo │ │ │ │ │ +000253c0: 726b 3a3a 2e0a 0a1f 0a46 696c 653a 2067 rk::.....File: g │ │ │ │ │ +000253d0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +000253e0: 2072 6f6f 742c 2020 4e65 7874 3a20 7375 root, Next: su │ │ │ │ │ +000253f0: 7065 7275 7365 7273 2c20 2050 7265 763a perusers, Prev: │ │ │ │ │ +00025400: 2070 7865 5f64 6566 6175 6c74 5f73 6572 pxe_default_ser │ │ │ │ │ +00025410: 7665 722c 2020 5570 3a20 5370 6563 6961 ver, Up: Specia │ │ │ │ │ +00025420: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ +00025430: 7269 6162 6c65 730a 0a31 352e 312e 3430 riables..15.1.40 │ │ │ │ │ +00025440: 2072 6f6f 740a 2d2d 2d2d 2d2d 2d2d 2d2d root.---------- │ │ │ │ │ +00025450: 2d2d 0a0a 5468 6520 726f 6f74 2064 6576 --..The root dev │ │ │ │ │ +00025460: 6963 6520 6e61 6d65 2028 2a6e 6f74 6520 ice name (*note │ │ │ │ │ +00025470: 4465 7669 6365 2073 796e 7461 783a 3a29 Device syntax::) │ │ │ │ │ +00025480: 2e20 2041 6e79 2066 696c 6520 6e61 6d65 . Any file name │ │ │ │ │ +00025490: 7320 7468 6174 2064 6f0a 6e6f 7420 7370 s that do.not sp │ │ │ │ │ +000254a0: 6563 6966 7920 616e 2065 7870 6c69 6369 ecify an explici │ │ │ │ │ +000254b0: 7420 6465 7669 6365 206e 616d 6520 6172 t device name ar │ │ │ │ │ +000254c0: 6520 7265 6164 2066 726f 6d20 7468 6973 e read from this │ │ │ │ │ +000254d0: 2064 6576 6963 652e 2020 5468 650a 6465 device. The.de │ │ │ │ │ +000254e0: 6661 756c 7420 6973 206e 6f72 6d61 6c6c fault is normall │ │ │ │ │ +000254f0: 7920 7365 7420 6279 2047 5255 4220 6174 y set by GRUB at │ │ │ │ │ +00025500: 2073 7461 7274 7570 2062 6173 6564 206f startup based o │ │ │ │ │ +00025510: 6e20 7468 6520 7661 6c75 6520 6f66 0a27 n the value of.' │ │ │ │ │ +00025520: 7072 6566 6978 2720 282a 6e6f 7465 2070 prefix' (*note p │ │ │ │ │ +00025530: 7265 6669 783a 3a29 2e0a 0a20 2020 466f refix::)... Fo │ │ │ │ │ +00025540: 7220 6578 616d 706c 652c 2069 6620 4752 r example, if GR │ │ │ │ │ +00025550: 5542 2077 6173 2069 6e73 7461 6c6c 6564 UB was installed │ │ │ │ │ +00025560: 2074 6f20 7468 6520 6669 7273 7420 7061 to the first pa │ │ │ │ │ +00025570: 7274 6974 696f 6e20 6f66 2074 6865 0a66 rtition of the.f │ │ │ │ │ +00025580: 6972 7374 2068 6172 6420 6469 736b 2c20 irst hard disk, │ │ │ │ │ +00025590: 7468 656e 2027 7072 6566 6978 2720 6d69 then 'prefix' mi │ │ │ │ │ +000255a0: 6768 7420 6265 2073 6574 2074 6f20 2728 ght be set to '( │ │ │ │ │ +000255b0: 6864 302c 6d73 646f 7331 292f 626f 6f74 hd0,msdos1)/boot │ │ │ │ │ +000255c0: 2f67 7275 6227 0a61 6e64 2027 726f 6f74 /grub'.and 'root │ │ │ │ │ +000255d0: 2720 746f 2027 6864 302c 6d73 646f 7331 ' to 'hd0,msdos1 │ │ │ │ │ +000255e0: 272e 0a0a 1f0a 4669 6c65 3a20 6772 7562 '.....File: grub │ │ │ │ │ +000255f0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7375 .info, Node: su │ │ │ │ │ +00025600: 7065 7275 7365 7273 2c20 204e 6578 743a perusers, Next: │ │ │ │ │ +00025610: 2074 6865 6d65 2c20 2050 7265 763a 2072 theme, Prev: r │ │ │ │ │ +00025620: 6f6f 742c 2020 5570 3a20 5370 6563 6961 oot, Up: Specia │ │ │ │ │ +00025630: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ +00025640: 7269 6162 6c65 730a 0a31 352e 312e 3431 riables..15.1.41 │ │ │ │ │ +00025650: 2073 7570 6572 7573 6572 730a 2d2d 2d2d superusers.---- │ │ │ │ │ +00025660: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00025670: 5468 6973 2076 6172 6961 626c 6520 6d61 This variable ma │ │ │ │ │ +00025680: 7920 6265 2073 6574 2074 6f20 6120 6c69 y be set to a li │ │ │ │ │ +00025690: 7374 206f 6620 7375 7065 7275 7365 7220 st of superuser │ │ │ │ │ +000256a0: 6e61 6d65 7320 746f 2065 6e61 626c 650a names to enable. │ │ │ │ │ +000256b0: 6175 7468 656e 7469 6361 7469 6f6e 2073 authentication s │ │ │ │ │ +000256c0: 7570 706f 7274 2e20 202a 4e6f 7465 2053 upport. *Note S │ │ │ │ │ +000256d0: 6563 7572 6974 793a 3a2e 0a0a 1f0a 4669 ecurity::.....Fi │ │ │ │ │ +000256e0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +000256f0: 4e6f 6465 3a20 7468 656d 652c 2020 4e65 Node: theme, Ne │ │ │ │ │ +00025700: 7874 3a20 7469 6d65 6f75 742c 2020 5072 xt: timeout, Pr │ │ │ │ │ +00025710: 6576 3a20 7375 7065 7275 7365 7273 2c20 ev: superusers, │ │ │ │ │ +00025720: 2055 703a 2053 7065 6369 616c 2065 6e76 Up: Special env │ │ │ │ │ +00025730: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +00025740: 6573 0a0a 3135 2e31 2e34 3220 7468 656d es..15.1.42 them │ │ │ │ │ +00025750: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a e.-------------. │ │ │ │ │ +00025760: 0a54 6869 7320 7661 7269 6162 6c65 206d .This variable m │ │ │ │ │ +00025770: 6179 2062 6520 7365 7420 746f 2061 2064 ay be set to a d │ │ │ │ │ +00025780: 6972 6563 746f 7279 2063 6f6e 7461 696e irectory contain │ │ │ │ │ +00025790: 696e 6720 6120 4752 5542 2067 7261 7068 ing a GRUB graph │ │ │ │ │ +000257a0: 6963 616c 206d 656e 750a 7468 656d 652e ical menu.theme. │ │ │ │ │ +000257b0: 2020 2a4e 6f74 6520 5468 656d 6520 6669 *Note Theme fi │ │ │ │ │ +000257c0: 6c65 2066 6f72 6d61 743a 3a2e 0a0a 2020 le format::... │ │ │ │ │ +000257d0: 2054 6869 7320 7661 7269 6162 6c65 2069 This variable i │ │ │ │ │ +000257e0: 7320 6f66 7465 6e20 7365 7420 6279 2027 s often set by ' │ │ │ │ │ +000257f0: 4752 5542 5f54 4845 4d45 2720 282a 6e6f GRUB_THEME' (*no │ │ │ │ │ +00025800: 7465 2053 696d 706c 650a 636f 6e66 6967 te Simple.config │ │ │ │ │ +00025810: 7572 6174 696f 6e3a 3a29 2e0a 0a1f 0a46 uration::).....F │ │ │ │ │ +00025820: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00025830: 204e 6f64 653a 2074 696d 656f 7574 2c20 Node: timeout, │ │ │ │ │ +00025840: 204e 6578 743a 2074 696d 656f 7574 5f73 Next: timeout_s │ │ │ │ │ +00025850: 7479 6c65 2c20 2050 7265 763a 2074 6865 tyle, Prev: the │ │ │ │ │ +00025860: 6d65 2c20 2055 703a 2053 7065 6369 616c me, Up: Special │ │ │ │ │ +00025870: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +00025880: 6961 626c 6573 0a0a 3135 2e31 2e34 3320 iables..15.1.43 │ │ │ │ │ +00025890: 7469 6d65 6f75 740a 2d2d 2d2d 2d2d 2d2d timeout.-------- │ │ │ │ │ +000258a0: 2d2d 2d2d 2d2d 2d0a 0a49 6620 7468 6973 -------..If this │ │ │ │ │ +000258b0: 2076 6172 6961 626c 6520 6973 2073 6574 variable is set │ │ │ │ │ +000258c0: 2c20 6974 2073 7065 6369 6669 6573 2074 , it specifies t │ │ │ │ │ +000258d0: 6865 2074 696d 6520 696e 2073 6563 6f6e he time in secon │ │ │ │ │ +000258e0: 6473 2074 6f20 7761 6974 2066 6f72 0a6b ds to wait for.k │ │ │ │ │ +000258f0: 6579 626f 6172 6420 696e 7075 7420 6265 eyboard input be │ │ │ │ │ +00025900: 666f 7265 2062 6f6f 7469 6e67 2074 6865 fore booting the │ │ │ │ │ +00025910: 2064 6566 6175 6c74 206d 656e 7520 656e default menu en │ │ │ │ │ +00025920: 7472 792e 2020 4120 7469 6d65 6f75 7420 try. A timeout │ │ │ │ │ +00025930: 6f66 2027 3027 0a6d 6561 6e73 2074 6f20 of '0'.means to │ │ │ │ │ +00025940: 626f 6f74 2074 6865 2064 6566 6175 6c74 boot the default │ │ │ │ │ +00025950: 2065 6e74 7279 2069 6d6d 6564 6961 7465 entry immediate │ │ │ │ │ +00025960: 6c79 2077 6974 686f 7574 2064 6973 706c ly without displ │ │ │ │ │ +00025970: 6179 696e 6720 7468 6520 6d65 6e75 3b0a aying the menu;. │ │ │ │ │ +00025980: 6120 7469 6d65 6f75 7420 6f66 2027 2d31 a timeout of '-1 │ │ │ │ │ +00025990: 2720 286f 7220 756e 7365 7429 206d 6561 ' (or unset) mea │ │ │ │ │ +000259a0: 6e73 2074 6f20 7761 6974 2069 6e64 6566 ns to wait indef │ │ │ │ │ +000259b0: 696e 6974 656c 792e 0a0a 2020 2049 6620 initely... If │ │ │ │ │ +000259c0: 2774 696d 656f 7574 5f73 7479 6c65 2720 'timeout_style' │ │ │ │ │ +000259d0: 282a 6e6f 7465 2074 696d 656f 7574 5f73 (*note timeout_s │ │ │ │ │ +000259e0: 7479 6c65 3a3a 2920 6973 2073 6574 2074 tyle::) is set t │ │ │ │ │ +000259f0: 6f20 2763 6f75 6e74 646f 776e 2720 6f72 o 'countdown' or │ │ │ │ │ +00025a00: 0a27 6869 6464 656e 272c 2074 6865 2074 .'hidden', the t │ │ │ │ │ +00025a10: 696d 656f 7574 2069 7320 696e 7374 6561 imeout is instea │ │ │ │ │ +00025a20: 6420 636f 756e 7465 6420 6265 666f 7265 d counted before │ │ │ │ │ +00025a30: 2074 6865 206d 656e 7520 6973 2064 6973 the menu is dis │ │ │ │ │ +00025a40: 706c 6179 6564 2e0a 0a20 2020 5468 6973 played... This │ │ │ │ │ +00025a50: 2076 6172 6961 626c 6520 6973 206f 6674 variable is oft │ │ │ │ │ +00025a60: 656e 2073 6574 2062 7920 2747 5255 425f en set by 'GRUB_ │ │ │ │ │ +00025a70: 5449 4d45 4f55 5427 2028 2a6e 6f74 6520 TIMEOUT' (*note │ │ │ │ │ +00025a80: 5369 6d70 6c65 0a63 6f6e 6669 6775 7261 Simple.configura │ │ │ │ │ +00025a90: 7469 6f6e 3a3a 292e 0a0a 1f0a 4669 6c65 tion::).....File │ │ │ │ │ +00025aa0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00025ab0: 6465 3a20 7469 6d65 6f75 745f 7374 796c de: timeout_styl │ │ │ │ │ +00025ac0: 652c 2020 5072 6576 3a20 7469 6d65 6f75 e, Prev: timeou │ │ │ │ │ +00025ad0: 742c 2020 5570 3a20 5370 6563 6961 6c20 t, Up: Special │ │ │ │ │ +00025ae0: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ +00025af0: 6162 6c65 730a 0a31 352e 312e 3434 2074 ables..15.1.44 t │ │ │ │ │ +00025b00: 696d 656f 7574 5f73 7479 6c65 0a2d 2d2d imeout_style.--- │ │ │ │ │ 00025b10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00025b20: 0a0a 5468 6973 2076 6172 6961 626c 6520 ..This variable │ │ │ │ │ -00025b30: 6d61 7920 6265 2073 6574 2074 6f20 276d may be set to 'm │ │ │ │ │ -00025b40: 656e 7527 2c20 2763 6f75 6e74 646f 776e enu', 'countdown │ │ │ │ │ -00025b50: 272c 206f 7220 2768 6964 6465 6e27 2074 ', or 'hidden' t │ │ │ │ │ -00025b60: 6f20 636f 6e74 726f 6c0a 7468 6520 7761 o control.the wa │ │ │ │ │ -00025b70: 7920 696e 2077 6869 6368 2074 6865 2074 y in which the t │ │ │ │ │ -00025b80: 696d 656f 7574 2028 2a6e 6f74 6520 7469 imeout (*note ti │ │ │ │ │ -00025b90: 6d65 6f75 743a 3a29 2069 6e74 6572 6163 meout::) interac │ │ │ │ │ -00025ba0: 7473 2077 6974 6820 6469 7370 6c61 7969 ts with displayi │ │ │ │ │ -00025bb0: 6e67 0a74 6865 206d 656e 752e 2020 5365 ng.the menu. Se │ │ │ │ │ -00025bc0: 6520 7468 6520 646f 6375 6d65 6e74 6174 e the documentat │ │ │ │ │ -00025bd0: 696f 6e20 6f66 2027 4752 5542 5f54 494d ion of 'GRUB_TIM │ │ │ │ │ -00025be0: 454f 5554 5f53 5459 4c45 2720 282a 6e6f EOUT_STYLE' (*no │ │ │ │ │ -00025bf0: 7465 2053 696d 706c 650a 636f 6e66 6967 te Simple.config │ │ │ │ │ -00025c00: 7572 6174 696f 6e3a 3a29 2066 6f72 2064 uration::) for d │ │ │ │ │ -00025c10: 6574 6169 6c73 2e0a 0a1f 0a46 696c 653a etails.....File: │ │ │ │ │ -00025c20: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -00025c30: 653a 2045 6e76 6972 6f6e 6d65 6e74 2062 e: Environment b │ │ │ │ │ -00025c40: 6c6f 636b 2c20 2050 7265 763a 2053 7065 lock, Prev: Spe │ │ │ │ │ -00025c50: 6369 616c 2065 6e76 6972 6f6e 6d65 6e74 cial environment │ │ │ │ │ -00025c60: 2076 6172 6961 626c 6573 2c20 2055 703a variables, Up: │ │ │ │ │ -00025c70: 2045 6e76 6972 6f6e 6d65 6e74 0a0a 3135 Environment..15 │ │ │ │ │ -00025c80: 2e32 2054 6865 2047 5255 4220 656e 7669 .2 The GRUB envi │ │ │ │ │ -00025c90: 726f 6e6d 656e 7420 626c 6f63 6b0a 3d3d ronment block.== │ │ │ │ │ +00025b20: 2d2d 0a0a 5468 6973 2076 6172 6961 626c --..This variabl │ │ │ │ │ +00025b30: 6520 6d61 7920 6265 2073 6574 2074 6f20 e may be set to │ │ │ │ │ +00025b40: 276d 656e 7527 2c20 2763 6f75 6e74 646f 'menu', 'countdo │ │ │ │ │ +00025b50: 776e 272c 206f 7220 2768 6964 6465 6e27 wn', or 'hidden' │ │ │ │ │ +00025b60: 2074 6f20 636f 6e74 726f 6c0a 7468 6520 to control.the │ │ │ │ │ +00025b70: 7761 7920 696e 2077 6869 6368 2074 6865 way in which the │ │ │ │ │ +00025b80: 2074 696d 656f 7574 2028 2a6e 6f74 6520 timeout (*note │ │ │ │ │ +00025b90: 7469 6d65 6f75 743a 3a29 2069 6e74 6572 timeout::) inter │ │ │ │ │ +00025ba0: 6163 7473 2077 6974 6820 6469 7370 6c61 acts with displa │ │ │ │ │ +00025bb0: 7969 6e67 0a74 6865 206d 656e 752e 2020 ying.the menu. │ │ │ │ │ +00025bc0: 5365 6520 7468 6520 646f 6375 6d65 6e74 See the document │ │ │ │ │ +00025bd0: 6174 696f 6e20 6f66 2027 4752 5542 5f54 ation of 'GRUB_T │ │ │ │ │ +00025be0: 494d 454f 5554 5f53 5459 4c45 2720 282a IMEOUT_STYLE' (* │ │ │ │ │ +00025bf0: 6e6f 7465 2053 696d 706c 650a 636f 6e66 note Simple.conf │ │ │ │ │ +00025c00: 6967 7572 6174 696f 6e3a 3a29 2066 6f72 iguration::) for │ │ │ │ │ +00025c10: 2064 6574 6169 6c73 2e0a 0a1f 0a46 696c details.....Fil │ │ │ │ │ +00025c20: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00025c30: 6f64 653a 2045 6e76 6972 6f6e 6d65 6e74 ode: Environment │ │ │ │ │ +00025c40: 2062 6c6f 636b 2c20 2050 7265 763a 2053 block, Prev: S │ │ │ │ │ +00025c50: 7065 6369 616c 2065 6e76 6972 6f6e 6d65 pecial environme │ │ │ │ │ +00025c60: 6e74 2076 6172 6961 626c 6573 2c20 2055 nt variables, U │ │ │ │ │ +00025c70: 703a 2045 6e76 6972 6f6e 6d65 6e74 0a0a p: Environment.. │ │ │ │ │ +00025c80: 3135 2e32 2054 6865 2047 5255 4220 656e 15.2 The GRUB en │ │ │ │ │ +00025c90: 7669 726f 6e6d 656e 7420 626c 6f63 6b0a vironment block. │ │ │ │ │ 00025ca0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00025cb0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a49 =============..I │ │ │ │ │ -00025cc0: 7420 6973 206f 6674 656e 2075 7365 6675 t is often usefu │ │ │ │ │ -00025cd0: 6c20 746f 2062 6520 6162 6c65 2074 6f20 l to be able to │ │ │ │ │ -00025ce0: 7265 6d65 6d62 6572 2061 2073 6d61 6c6c remember a small │ │ │ │ │ -00025cf0: 2061 6d6f 756e 7420 6f66 2069 6e66 6f72 amount of infor │ │ │ │ │ -00025d00: 6d61 7469 6f6e 0a66 726f 6d20 6f6e 6520 mation.from one │ │ │ │ │ -00025d10: 626f 6f74 2074 6f20 7468 6520 6e65 7874 boot to the next │ │ │ │ │ -00025d20: 2e20 2046 6f72 2065 7861 6d70 6c65 2c20 . For example, │ │ │ │ │ -00025d30: 796f 7520 6d69 6768 7420 7761 6e74 2074 you might want t │ │ │ │ │ -00025d40: 6f20 7365 7420 7468 650a 6465 6661 756c o set the.defaul │ │ │ │ │ -00025d50: 7420 6d65 6e75 2065 6e74 7279 2062 6173 t menu entry bas │ │ │ │ │ -00025d60: 6564 206f 6e20 7768 6174 2077 6173 2073 ed on what was s │ │ │ │ │ -00025d70: 656c 6563 7465 6420 7468 6520 6c61 7374 elected the last │ │ │ │ │ -00025d80: 2074 696d 652e 2020 4752 5542 0a64 656c time. GRUB.del │ │ │ │ │ -00025d90: 6962 6572 6174 656c 7920 646f 6573 206e iberately does n │ │ │ │ │ -00025da0: 6f74 2069 6d70 6c65 6d65 6e74 2073 7570 ot implement sup │ │ │ │ │ -00025db0: 706f 7274 2066 6f72 2077 7269 7469 6e67 port for writing │ │ │ │ │ -00025dc0: 2066 696c 6573 2069 6e20 6f72 6465 7220 files in order │ │ │ │ │ -00025dd0: 746f 0a6d 696e 696d 6973 6520 7468 6520 to.minimise the │ │ │ │ │ -00025de0: 706f 7373 6962 696c 6974 7920 6f66 2074 possibility of t │ │ │ │ │ -00025df0: 6865 2062 6f6f 7420 6c6f 6164 6572 2062 he boot loader b │ │ │ │ │ -00025e00: 6569 6e67 2072 6573 706f 6e73 6962 6c65 eing responsible │ │ │ │ │ -00025e10: 2066 6f72 2066 696c 650a 7379 7374 656d for file.system │ │ │ │ │ -00025e20: 2063 6f72 7275 7074 696f 6e2c 2073 6f20 corruption, so │ │ │ │ │ -00025e30: 6120 4752 5542 2063 6f6e 6669 6775 7261 a GRUB configura │ │ │ │ │ -00025e40: 7469 6f6e 2066 696c 6520 6361 6e6e 6f74 tion file cannot │ │ │ │ │ -00025e50: 206a 7573 7420 6372 6561 7465 2061 0a66 just create a.f │ │ │ │ │ -00025e60: 696c 6520 696e 2074 6865 206f 7264 696e ile in the ordin │ │ │ │ │ -00025e70: 6172 7920 7761 792e 2020 486f 7765 7665 ary way. Howeve │ │ │ │ │ -00025e80: 722c 2047 5255 4220 7072 6f76 6964 6573 r, GRUB provides │ │ │ │ │ -00025e90: 2061 6e20 2265 6e76 6972 6f6e 6d65 6e74 an "environment │ │ │ │ │ -00025ea0: 2062 6c6f 636b 220a 7768 6963 6820 6361 block".which ca │ │ │ │ │ -00025eb0: 6e20 6265 2075 7365 6420 746f 2073 6176 n be used to sav │ │ │ │ │ -00025ec0: 6520 6120 736d 616c 6c20 616d 6f75 6e74 e a small amount │ │ │ │ │ -00025ed0: 206f 6620 7374 6174 652e 0a0a 2020 2054 of state... T │ │ │ │ │ -00025ee0: 6865 2065 6e76 6972 6f6e 6d65 6e74 2062 he environment b │ │ │ │ │ -00025ef0: 6c6f 636b 2069 7320 6120 7072 6561 6c6c lock is a preall │ │ │ │ │ -00025f00: 6f63 6174 6564 2031 3032 342d 6279 7465 ocated 1024-byte │ │ │ │ │ -00025f10: 2066 696c 652c 2077 6869 6368 0a6e 6f72 file, which.nor │ │ │ │ │ -00025f20: 6d61 6c6c 7920 6c69 7665 7320 696e 2027 mally lives in ' │ │ │ │ │ -00025f30: 2f62 6f6f 742f 6772 7562 2f67 7275 6265 /boot/grub/grube │ │ │ │ │ -00025f40: 6e76 2720 2861 6c74 686f 7567 6820 796f nv' (although yo │ │ │ │ │ -00025f50: 7520 7368 6f75 6c64 206e 6f74 2061 7373 u should not ass │ │ │ │ │ -00025f60: 756d 650a 7468 6973 292e 2020 4174 2062 ume.this). At b │ │ │ │ │ -00025f70: 6f6f 7420 7469 6d65 2c20 7468 6520 276c oot time, the 'l │ │ │ │ │ -00025f80: 6f61 645f 656e 7627 2063 6f6d 6d61 6e64 oad_env' command │ │ │ │ │ -00025f90: 2028 2a6e 6f74 6520 6c6f 6164 5f65 6e76 (*note load_env │ │ │ │ │ -00025fa0: 3a3a 2920 6c6f 6164 730a 656e 7669 726f ::) loads.enviro │ │ │ │ │ -00025fb0: 6e6d 656e 7420 7661 7269 6162 6c65 7320 nment variables │ │ │ │ │ -00025fc0: 6672 6f6d 2069 742c 2061 6e64 2074 6865 from it, and the │ │ │ │ │ -00025fd0: 2027 7361 7665 5f65 6e76 2720 282a 6e6f 'save_env' (*no │ │ │ │ │ -00025fe0: 7465 2073 6176 655f 656e 763a 3a29 0a63 te save_env::).c │ │ │ │ │ -00025ff0: 6f6d 6d61 6e64 2073 6176 6573 2065 6e76 ommand saves env │ │ │ │ │ -00026000: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -00026010: 6573 2074 6f20 6974 2e20 2046 726f 6d20 es to it. From │ │ │ │ │ -00026020: 6120 7275 6e6e 696e 6720 7379 7374 656d a running system │ │ │ │ │ -00026030: 2c20 7468 650a 2767 7275 622d 6564 6974 , the.'grub-edit │ │ │ │ │ -00026040: 656e 7627 2075 7469 6c69 7479 2063 616e env' utility can │ │ │ │ │ -00026050: 2062 6520 7573 6564 2074 6f20 6564 6974 be used to edit │ │ │ │ │ -00026060: 2074 6865 2065 6e76 6972 6f6e 6d65 6e74 the environment │ │ │ │ │ -00026070: 2062 6c6f 636b 2e0a 0a20 2020 466f 7220 block... For │ │ │ │ │ -00026080: 7361 6665 7479 2072 6561 736f 6e73 2c20 safety reasons, │ │ │ │ │ -00026090: 7468 6973 2073 746f 7261 6765 2069 7320 this storage is │ │ │ │ │ -000260a0: 6f6e 6c79 2061 7661 696c 6162 6c65 2077 only available w │ │ │ │ │ -000260b0: 6865 6e20 696e 7374 616c 6c65 6420 6f6e hen installed on │ │ │ │ │ -000260c0: 0a61 2070 6c61 696e 2064 6973 6b20 286e .a plain disk (n │ │ │ │ │ -000260d0: 6f20 4c56 4d20 6f72 2052 4149 4429 2c20 o LVM or RAID), │ │ │ │ │ -000260e0: 7573 696e 6720 6120 6e6f 6e2d 6368 6563 using a non-chec │ │ │ │ │ -000260f0: 6b73 756d 6d69 6e67 2066 696c 6573 7973 ksumming filesys │ │ │ │ │ -00026100: 7465 6d20 286e 6f0a 5a46 5329 2c20 616e tem (no.ZFS), an │ │ │ │ │ -00026110: 6420 7573 696e 6720 4249 4f53 206f 7220 d using BIOS or │ │ │ │ │ -00026120: 4546 4920 6675 6e63 7469 6f6e 7320 286e EFI functions (n │ │ │ │ │ -00026130: 6f20 4154 412c 2055 5342 206f 7220 4945 o ATA, USB or IE │ │ │ │ │ -00026140: 4545 3132 3735 292e 0a0a 2020 2027 6772 EE1275)... 'gr │ │ │ │ │ -00026150: 7562 2d6d 6b63 6f6e 6669 6727 2075 7365 ub-mkconfig' use │ │ │ │ │ -00026160: 7320 7468 6973 2066 6163 696c 6974 7920 s this facility │ │ │ │ │ -00026170: 746f 2069 6d70 6c65 6d65 6e74 2027 4752 to implement 'GR │ │ │ │ │ -00026180: 5542 5f53 4156 4544 4546 4155 4c54 270a UB_SAVEDEFAULT'. │ │ │ │ │ -00026190: 282a 6e6f 7465 2053 696d 706c 6520 636f (*note Simple co │ │ │ │ │ -000261a0: 6e66 6967 7572 6174 696f 6e3a 3a29 2e0a nfiguration::).. │ │ │ │ │ -000261b0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -000261c0: 666f 2c20 204e 6f64 653a 2043 6f6d 6d61 fo, Node: Comma │ │ │ │ │ -000261d0: 6e64 732c 2020 4e65 7874 3a20 496e 7465 nds, Next: Inte │ │ │ │ │ -000261e0: 726e 6174 696f 6e61 6c69 7361 7469 6f6e rnationalisation │ │ │ │ │ -000261f0: 2c20 2050 7265 763a 2045 6e76 6972 6f6e , Prev: Environ │ │ │ │ │ -00026200: 6d65 6e74 2c20 2055 703a 2054 6f70 0a0a ment, Up: Top.. │ │ │ │ │ -00026210: 3136 2054 6865 206c 6973 7420 6f66 2061 16 The list of a │ │ │ │ │ -00026220: 7661 696c 6162 6c65 2063 6f6d 6d61 6e64 vailable command │ │ │ │ │ -00026230: 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a s.************** │ │ │ │ │ +00025cb0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ +00025cc0: 0a49 7420 6973 206f 6674 656e 2075 7365 .It is often use │ │ │ │ │ +00025cd0: 6675 6c20 746f 2062 6520 6162 6c65 2074 ful to be able t │ │ │ │ │ +00025ce0: 6f20 7265 6d65 6d62 6572 2061 2073 6d61 o remember a sma │ │ │ │ │ +00025cf0: 6c6c 2061 6d6f 756e 7420 6f66 2069 6e66 ll amount of inf │ │ │ │ │ +00025d00: 6f72 6d61 7469 6f6e 0a66 726f 6d20 6f6e ormation.from on │ │ │ │ │ +00025d10: 6520 626f 6f74 2074 6f20 7468 6520 6e65 e boot to the ne │ │ │ │ │ +00025d20: 7874 2e20 2046 6f72 2065 7861 6d70 6c65 xt. For example │ │ │ │ │ +00025d30: 2c20 796f 7520 6d69 6768 7420 7761 6e74 , you might want │ │ │ │ │ +00025d40: 2074 6f20 7365 7420 7468 650a 6465 6661 to set the.defa │ │ │ │ │ +00025d50: 756c 7420 6d65 6e75 2065 6e74 7279 2062 ult menu entry b │ │ │ │ │ +00025d60: 6173 6564 206f 6e20 7768 6174 2077 6173 ased on what was │ │ │ │ │ +00025d70: 2073 656c 6563 7465 6420 7468 6520 6c61 selected the la │ │ │ │ │ +00025d80: 7374 2074 696d 652e 2020 4752 5542 0a64 st time. GRUB.d │ │ │ │ │ +00025d90: 656c 6962 6572 6174 656c 7920 646f 6573 eliberately does │ │ │ │ │ +00025da0: 206e 6f74 2069 6d70 6c65 6d65 6e74 2073 not implement s │ │ │ │ │ +00025db0: 7570 706f 7274 2066 6f72 2077 7269 7469 upport for writi │ │ │ │ │ +00025dc0: 6e67 2066 696c 6573 2069 6e20 6f72 6465 ng files in orde │ │ │ │ │ +00025dd0: 7220 746f 0a6d 696e 696d 6973 6520 7468 r to.minimise th │ │ │ │ │ +00025de0: 6520 706f 7373 6962 696c 6974 7920 6f66 e possibility of │ │ │ │ │ +00025df0: 2074 6865 2062 6f6f 7420 6c6f 6164 6572 the boot loader │ │ │ │ │ +00025e00: 2062 6569 6e67 2072 6573 706f 6e73 6962 being responsib │ │ │ │ │ +00025e10: 6c65 2066 6f72 2066 696c 650a 7379 7374 le for file.syst │ │ │ │ │ +00025e20: 656d 2063 6f72 7275 7074 696f 6e2c 2073 em corruption, s │ │ │ │ │ +00025e30: 6f20 6120 4752 5542 2063 6f6e 6669 6775 o a GRUB configu │ │ │ │ │ +00025e40: 7261 7469 6f6e 2066 696c 6520 6361 6e6e ration file cann │ │ │ │ │ +00025e50: 6f74 206a 7573 7420 6372 6561 7465 2061 ot just create a │ │ │ │ │ +00025e60: 0a66 696c 6520 696e 2074 6865 206f 7264 .file in the ord │ │ │ │ │ +00025e70: 696e 6172 7920 7761 792e 2020 486f 7765 inary way. Howe │ │ │ │ │ +00025e80: 7665 722c 2047 5255 4220 7072 6f76 6964 ver, GRUB provid │ │ │ │ │ +00025e90: 6573 2061 6e20 2265 6e76 6972 6f6e 6d65 es an "environme │ │ │ │ │ +00025ea0: 6e74 2062 6c6f 636b 220a 7768 6963 6820 nt block".which │ │ │ │ │ +00025eb0: 6361 6e20 6265 2075 7365 6420 746f 2073 can be used to s │ │ │ │ │ +00025ec0: 6176 6520 6120 736d 616c 6c20 616d 6f75 ave a small amou │ │ │ │ │ +00025ed0: 6e74 206f 6620 7374 6174 652e 0a0a 2020 nt of state... │ │ │ │ │ +00025ee0: 2054 6865 2065 6e76 6972 6f6e 6d65 6e74 The environment │ │ │ │ │ +00025ef0: 2062 6c6f 636b 2069 7320 6120 7072 6561 block is a prea │ │ │ │ │ +00025f00: 6c6c 6f63 6174 6564 2031 3032 342d 6279 llocated 1024-by │ │ │ │ │ +00025f10: 7465 2066 696c 652c 2077 6869 6368 0a6e te file, which.n │ │ │ │ │ +00025f20: 6f72 6d61 6c6c 7920 6c69 7665 7320 696e ormally lives in │ │ │ │ │ +00025f30: 2027 2f62 6f6f 742f 6772 7562 2f67 7275 '/boot/grub/gru │ │ │ │ │ +00025f40: 6265 6e76 2720 2861 6c74 686f 7567 6820 benv' (although │ │ │ │ │ +00025f50: 796f 7520 7368 6f75 6c64 206e 6f74 2061 you should not a │ │ │ │ │ +00025f60: 7373 756d 650a 7468 6973 292e 2020 4174 ssume.this). At │ │ │ │ │ +00025f70: 2062 6f6f 7420 7469 6d65 2c20 7468 6520 boot time, the │ │ │ │ │ +00025f80: 276c 6f61 645f 656e 7627 2063 6f6d 6d61 'load_env' comma │ │ │ │ │ +00025f90: 6e64 2028 2a6e 6f74 6520 6c6f 6164 5f65 nd (*note load_e │ │ │ │ │ +00025fa0: 6e76 3a3a 2920 6c6f 6164 730a 656e 7669 nv::) loads.envi │ │ │ │ │ +00025fb0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ +00025fc0: 7320 6672 6f6d 2069 742c 2061 6e64 2074 s from it, and t │ │ │ │ │ +00025fd0: 6865 2027 7361 7665 5f65 6e76 2720 282a he 'save_env' (* │ │ │ │ │ +00025fe0: 6e6f 7465 2073 6176 655f 656e 763a 3a29 note save_env::) │ │ │ │ │ +00025ff0: 0a63 6f6d 6d61 6e64 2073 6176 6573 2065 .command saves e │ │ │ │ │ +00026000: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00026010: 626c 6573 2074 6f20 6974 2e20 2046 726f bles to it. Fro │ │ │ │ │ +00026020: 6d20 6120 7275 6e6e 696e 6720 7379 7374 m a running syst │ │ │ │ │ +00026030: 656d 2c20 7468 650a 2767 7275 622d 6564 em, the.'grub-ed │ │ │ │ │ +00026040: 6974 656e 7627 2075 7469 6c69 7479 2063 itenv' utility c │ │ │ │ │ +00026050: 616e 2062 6520 7573 6564 2074 6f20 6564 an be used to ed │ │ │ │ │ +00026060: 6974 2074 6865 2065 6e76 6972 6f6e 6d65 it the environme │ │ │ │ │ +00026070: 6e74 2062 6c6f 636b 2e0a 0a20 2020 466f nt block... Fo │ │ │ │ │ +00026080: 7220 7361 6665 7479 2072 6561 736f 6e73 r safety reasons │ │ │ │ │ +00026090: 2c20 7468 6973 2073 746f 7261 6765 2069 , this storage i │ │ │ │ │ +000260a0: 7320 6f6e 6c79 2061 7661 696c 6162 6c65 s only available │ │ │ │ │ +000260b0: 2077 6865 6e20 696e 7374 616c 6c65 6420 when installed │ │ │ │ │ +000260c0: 6f6e 0a61 2070 6c61 696e 2064 6973 6b20 on.a plain disk │ │ │ │ │ +000260d0: 286e 6f20 4c56 4d20 6f72 2052 4149 4429 (no LVM or RAID) │ │ │ │ │ +000260e0: 2c20 7573 696e 6720 6120 6e6f 6e2d 6368 , using a non-ch │ │ │ │ │ +000260f0: 6563 6b73 756d 6d69 6e67 2066 696c 6573 ecksumming files │ │ │ │ │ +00026100: 7973 7465 6d20 286e 6f0a 5a46 5329 2c20 ystem (no.ZFS), │ │ │ │ │ +00026110: 616e 6420 7573 696e 6720 4249 4f53 206f and using BIOS o │ │ │ │ │ +00026120: 7220 4546 4920 6675 6e63 7469 6f6e 7320 r EFI functions │ │ │ │ │ +00026130: 286e 6f20 4154 412c 2055 5342 206f 7220 (no ATA, USB or │ │ │ │ │ +00026140: 4945 4545 3132 3735 292e 0a0a 2020 2027 IEEE1275)... ' │ │ │ │ │ +00026150: 6772 7562 2d6d 6b63 6f6e 6669 6727 2075 grub-mkconfig' u │ │ │ │ │ +00026160: 7365 7320 7468 6973 2066 6163 696c 6974 ses this facilit │ │ │ │ │ +00026170: 7920 746f 2069 6d70 6c65 6d65 6e74 2027 y to implement ' │ │ │ │ │ +00026180: 4752 5542 5f53 4156 4544 4546 4155 4c54 GRUB_SAVEDEFAULT │ │ │ │ │ +00026190: 270a 282a 6e6f 7465 2053 696d 706c 6520 '.(*note Simple │ │ │ │ │ +000261a0: 636f 6e66 6967 7572 6174 696f 6e3a 3a29 configuration::) │ │ │ │ │ +000261b0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +000261c0: 696e 666f 2c20 204e 6f64 653a 2043 6f6d info, Node: Com │ │ │ │ │ +000261d0: 6d61 6e64 732c 2020 4e65 7874 3a20 496e mands, Next: In │ │ │ │ │ +000261e0: 7465 726e 6174 696f 6e61 6c69 7361 7469 ternationalisati │ │ │ │ │ +000261f0: 6f6e 2c20 2050 7265 763a 2045 6e76 6972 on, Prev: Envir │ │ │ │ │ +00026200: 6f6e 6d65 6e74 2c20 2055 703a 2054 6f70 onment, Up: Top │ │ │ │ │ +00026210: 0a0a 3136 2054 6865 206c 6973 7420 6f66 ..16 The list of │ │ │ │ │ +00026220: 2061 7661 696c 6162 6c65 2063 6f6d 6d61 available comma │ │ │ │ │ +00026230: 6e64 730a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a nds.************ │ │ │ │ │ 00026240: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00026250: 2a2a 2a0a 0a49 6e20 7468 6973 2063 6861 ***..In this cha │ │ │ │ │ -00026260: 7074 6572 2c20 7765 206c 6973 7420 616c pter, we list al │ │ │ │ │ -00026270: 6c20 636f 6d6d 616e 6473 2074 6861 7420 l commands that │ │ │ │ │ -00026280: 6172 6520 6176 6169 6c61 626c 6520 696e are available in │ │ │ │ │ -00026290: 2047 5255 422e 0a0a 2020 2043 6f6d 6d61 GRUB... Comma │ │ │ │ │ -000262a0: 6e64 7320 6265 6c6f 6e67 2074 6f20 6469 nds belong to di │ │ │ │ │ -000262b0: 6666 6572 656e 7420 6772 6f75 7073 2e20 fferent groups. │ │ │ │ │ -000262c0: 2041 2066 6577 2063 616e 206f 6e6c 7920 A few can only │ │ │ │ │ -000262d0: 6265 2075 7365 6420 696e 2074 6865 0a67 be used in the.g │ │ │ │ │ -000262e0: 6c6f 6261 6c20 7365 6374 696f 6e20 6f66 lobal section of │ │ │ │ │ -000262f0: 2074 6865 2063 6f6e 6669 6775 7261 7469 the configurati │ │ │ │ │ -00026300: 6f6e 2066 696c 6520 286f 7220 226d 656e on file (or "men │ │ │ │ │ -00026310: 7522 293b 206d 6f73 7420 6f66 2074 6865 u"); most of the │ │ │ │ │ -00026320: 6d20 6361 6e0a 6265 2065 6e74 6572 6564 m can.be entered │ │ │ │ │ -00026330: 206f 6e20 7468 6520 636f 6d6d 616e 642d on the command- │ │ │ │ │ -00026340: 6c69 6e65 2061 6e64 2063 616e 2062 6520 line and can be │ │ │ │ │ -00026350: 7573 6564 2065 6974 6865 7220 616e 7977 used either anyw │ │ │ │ │ -00026360: 6865 7265 2069 6e20 7468 650a 6d65 6e75 here in the.menu │ │ │ │ │ -00026370: 206f 7220 7370 6563 6966 6963 616c 6c79 or specifically │ │ │ │ │ -00026380: 2069 6e20 7468 6520 6d65 6e75 2065 6e74 in the menu ent │ │ │ │ │ -00026390: 7269 6573 2e0a 0a20 2020 496e 2072 6573 ries... In res │ │ │ │ │ -000263a0: 6375 6520 6d6f 6465 2c20 6f6e 6c79 2074 cue mode, only t │ │ │ │ │ -000263b0: 6865 2027 696e 736d 6f64 2720 282a 6e6f he 'insmod' (*no │ │ │ │ │ -000263c0: 7465 2069 6e73 6d6f 643a 3a29 2c20 276c te insmod::), 'l │ │ │ │ │ -000263d0: 7327 2028 2a6e 6f74 650a 6c73 3a3a 292c s' (*note.ls::), │ │ │ │ │ -000263e0: 2027 7365 7427 2028 2a6e 6f74 6520 7365 'set' (*note se │ │ │ │ │ -000263f0: 743a 3a29 2c20 616e 6420 2775 6e73 6574 t::), and 'unset │ │ │ │ │ -00026400: 2720 282a 6e6f 7465 2075 6e73 6574 3a3a ' (*note unset:: │ │ │ │ │ -00026410: 2920 636f 6d6d 616e 6473 2061 7265 0a6e ) commands are.n │ │ │ │ │ -00026420: 6f72 6d61 6c6c 7920 6176 6169 6c61 626c ormally availabl │ │ │ │ │ -00026430: 652e 2020 4966 2079 6f75 2065 6e64 2075 e. If you end u │ │ │ │ │ -00026440: 7020 696e 2072 6573 6375 6520 6d6f 6465 p in rescue mode │ │ │ │ │ -00026450: 2061 6e64 2064 6f20 6e6f 7420 6b6e 6f77 and do not know │ │ │ │ │ -00026460: 2077 6861 740a 746f 2064 6f2c 2074 6865 what.to do, the │ │ │ │ │ -00026470: 6e20 2a6e 6f74 6520 4752 5542 206f 6e6c n *note GRUB onl │ │ │ │ │ -00026480: 7920 6f66 6665 7273 2061 2072 6573 6375 y offers a rescu │ │ │ │ │ -00026490: 6520 7368 656c 6c3a 3a2e 0a0a 2a20 4d65 e shell::...* Me │ │ │ │ │ -000264a0: 6e75 3a0a 0a2a 204d 656e 752d 7370 6563 nu:..* Menu-spec │ │ │ │ │ -000264b0: 6966 6963 2063 6f6d 6d61 6e64 733a 3a0a ific commands::. │ │ │ │ │ -000264c0: 2a20 4765 6e65 7261 6c20 636f 6d6d 616e * General comman │ │ │ │ │ -000264d0: 6473 3a3a 0a2a 2043 6f6d 6d61 6e64 2d6c ds::.* Command-l │ │ │ │ │ -000264e0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -000264f0: 7279 2063 6f6d 6d61 6e64 733a 3a0a 2a20 ry commands::.* │ │ │ │ │ -00026500: 4e65 7477 6f72 6b69 6e67 2063 6f6d 6d61 Networking comma │ │ │ │ │ -00026510: 6e64 733a 3a0a 0a1f 0a46 696c 653a 2067 nds::....File: g │ │ │ │ │ -00026520: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00026530: 204d 656e 752d 7370 6563 6966 6963 2063 Menu-specific c │ │ │ │ │ -00026540: 6f6d 6d61 6e64 732c 2020 4e65 7874 3a20 ommands, Next: │ │ │ │ │ -00026550: 4765 6e65 7261 6c20 636f 6d6d 616e 6473 General commands │ │ │ │ │ -00026560: 2c20 2055 703a 2043 6f6d 6d61 6e64 730a , Up: Commands. │ │ │ │ │ -00026570: 0a31 362e 3120 5468 6520 6c69 7374 206f .16.1 The list o │ │ │ │ │ -00026580: 6620 636f 6d6d 616e 6473 2066 6f72 2074 f commands for t │ │ │ │ │ -00026590: 6865 206d 656e 7520 6f6e 6c79 0a3d 3d3d he menu only.=== │ │ │ │ │ +00026250: 2a2a 2a2a 2a0a 0a49 6e20 7468 6973 2063 *****..In this c │ │ │ │ │ +00026260: 6861 7074 6572 2c20 7765 206c 6973 7420 hapter, we list │ │ │ │ │ +00026270: 616c 6c20 636f 6d6d 616e 6473 2074 6861 all commands tha │ │ │ │ │ +00026280: 7420 6172 6520 6176 6169 6c61 626c 6520 t are available │ │ │ │ │ +00026290: 696e 2047 5255 422e 0a0a 2020 2043 6f6d in GRUB... Com │ │ │ │ │ +000262a0: 6d61 6e64 7320 6265 6c6f 6e67 2074 6f20 mands belong to │ │ │ │ │ +000262b0: 6469 6666 6572 656e 7420 6772 6f75 7073 different groups │ │ │ │ │ +000262c0: 2e20 2041 2066 6577 2063 616e 206f 6e6c . A few can onl │ │ │ │ │ +000262d0: 7920 6265 2075 7365 6420 696e 2074 6865 y be used in the │ │ │ │ │ +000262e0: 0a67 6c6f 6261 6c20 7365 6374 696f 6e20 .global section │ │ │ │ │ +000262f0: 6f66 2074 6865 2063 6f6e 6669 6775 7261 of the configura │ │ │ │ │ +00026300: 7469 6f6e 2066 696c 6520 286f 7220 226d tion file (or "m │ │ │ │ │ +00026310: 656e 7522 293b 206d 6f73 7420 6f66 2074 enu"); most of t │ │ │ │ │ +00026320: 6865 6d20 6361 6e0a 6265 2065 6e74 6572 hem can.be enter │ │ │ │ │ +00026330: 6564 206f 6e20 7468 6520 636f 6d6d 616e ed on the comman │ │ │ │ │ +00026340: 642d 6c69 6e65 2061 6e64 2063 616e 2062 d-line and can b │ │ │ │ │ +00026350: 6520 7573 6564 2065 6974 6865 7220 616e e used either an │ │ │ │ │ +00026360: 7977 6865 7265 2069 6e20 7468 650a 6d65 ywhere in the.me │ │ │ │ │ +00026370: 6e75 206f 7220 7370 6563 6966 6963 616c nu or specifical │ │ │ │ │ +00026380: 6c79 2069 6e20 7468 6520 6d65 6e75 2065 ly in the menu e │ │ │ │ │ +00026390: 6e74 7269 6573 2e0a 0a20 2020 496e 2072 ntries... In r │ │ │ │ │ +000263a0: 6573 6375 6520 6d6f 6465 2c20 6f6e 6c79 escue mode, only │ │ │ │ │ +000263b0: 2074 6865 2027 696e 736d 6f64 2720 282a the 'insmod' (* │ │ │ │ │ +000263c0: 6e6f 7465 2069 6e73 6d6f 643a 3a29 2c20 note insmod::), │ │ │ │ │ +000263d0: 276c 7327 2028 2a6e 6f74 650a 6c73 3a3a 'ls' (*note.ls:: │ │ │ │ │ +000263e0: 292c 2027 7365 7427 2028 2a6e 6f74 6520 ), 'set' (*note │ │ │ │ │ +000263f0: 7365 743a 3a29 2c20 616e 6420 2775 6e73 set::), and 'uns │ │ │ │ │ +00026400: 6574 2720 282a 6e6f 7465 2075 6e73 6574 et' (*note unset │ │ │ │ │ +00026410: 3a3a 2920 636f 6d6d 616e 6473 2061 7265 ::) commands are │ │ │ │ │ +00026420: 0a6e 6f72 6d61 6c6c 7920 6176 6169 6c61 .normally availa │ │ │ │ │ +00026430: 626c 652e 2020 4966 2079 6f75 2065 6e64 ble. If you end │ │ │ │ │ +00026440: 2075 7020 696e 2072 6573 6375 6520 6d6f up in rescue mo │ │ │ │ │ +00026450: 6465 2061 6e64 2064 6f20 6e6f 7420 6b6e de and do not kn │ │ │ │ │ +00026460: 6f77 2077 6861 740a 746f 2064 6f2c 2074 ow what.to do, t │ │ │ │ │ +00026470: 6865 6e20 2a6e 6f74 6520 4752 5542 206f hen *note GRUB o │ │ │ │ │ +00026480: 6e6c 7920 6f66 6665 7273 2061 2072 6573 nly offers a res │ │ │ │ │ +00026490: 6375 6520 7368 656c 6c3a 3a2e 0a0a 2a20 cue shell::...* │ │ │ │ │ +000264a0: 4d65 6e75 3a0a 0a2a 204d 656e 752d 7370 Menu:..* Menu-sp │ │ │ │ │ +000264b0: 6563 6966 6963 2063 6f6d 6d61 6e64 733a ecific commands: │ │ │ │ │ +000264c0: 3a0a 2a20 4765 6e65 7261 6c20 636f 6d6d :.* General comm │ │ │ │ │ +000264d0: 616e 6473 3a3a 0a2a 2043 6f6d 6d61 6e64 ands::.* Command │ │ │ │ │ +000264e0: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +000264f0: 6e74 7279 2063 6f6d 6d61 6e64 733a 3a0a ntry commands::. │ │ │ │ │ +00026500: 2a20 4e65 7477 6f72 6b69 6e67 2063 6f6d * Networking com │ │ │ │ │ +00026510: 6d61 6e64 733a 3a0a 0a1f 0a46 696c 653a mands::....File: │ │ │ │ │ +00026520: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00026530: 653a 204d 656e 752d 7370 6563 6966 6963 e: Menu-specific │ │ │ │ │ +00026540: 2063 6f6d 6d61 6e64 732c 2020 4e65 7874 commands, Next │ │ │ │ │ +00026550: 3a20 4765 6e65 7261 6c20 636f 6d6d 616e : General comman │ │ │ │ │ +00026560: 6473 2c20 2055 703a 2043 6f6d 6d61 6e64 ds, Up: Command │ │ │ │ │ +00026570: 730a 0a31 362e 3120 5468 6520 6c69 7374 s..16.1 The list │ │ │ │ │ +00026580: 206f 6620 636f 6d6d 616e 6473 2066 6f72 of commands for │ │ │ │ │ +00026590: 2074 6865 206d 656e 7520 6f6e 6c79 0a3d the menu only.= │ │ │ │ │ 000265a0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 000265b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000265c0: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 7365 ========..The se │ │ │ │ │ -000265d0: 6d61 6e74 6963 7320 7573 6564 2069 6e20 mantics used in │ │ │ │ │ -000265e0: 7061 7273 696e 6720 7468 6520 636f 6e66 parsing the conf │ │ │ │ │ -000265f0: 6967 7572 6174 696f 6e20 6669 6c65 2061 iguration file a │ │ │ │ │ -00026600: 7265 2074 6865 2066 6f6c 6c6f 7769 6e67 re the following │ │ │ │ │ -00026610: 3a0a 0a20 2020 2a20 5468 6520 6669 6c65 :.. * The file │ │ │ │ │ -00026620: 7320 5f6d 7573 745f 2062 6520 696e 2070 s _must_ be in p │ │ │ │ │ -00026630: 6c61 696e 2d74 6578 7420 666f 726d 6174 lain-text format │ │ │ │ │ -00026640: 2e0a 0a20 2020 2a20 2723 2720 6174 2074 ... * '#' at t │ │ │ │ │ -00026650: 6865 2062 6567 696e 6e69 6e67 206f 6620 he beginning of │ │ │ │ │ -00026660: 6120 6c69 6e65 2069 6e20 6120 636f 6e66 a line in a conf │ │ │ │ │ -00026670: 6967 7572 6174 696f 6e20 6669 6c65 206d iguration file m │ │ │ │ │ -00026680: 6561 6e73 2069 7420 6973 0a20 2020 2020 eans it is. │ │ │ │ │ -00026690: 6f6e 6c79 2061 2063 6f6d 6d65 6e74 2e0a only a comment.. │ │ │ │ │ -000266a0: 0a20 2020 2a20 4f70 7469 6f6e 7320 6172 . * Options ar │ │ │ │ │ -000266b0: 6520 7365 7061 7261 7465 6420 6279 2073 e separated by s │ │ │ │ │ -000266c0: 7061 6365 732e 0a0a 2020 202a 2041 6c6c paces... * All │ │ │ │ │ -000266d0: 206e 756d 6265 7273 2063 616e 2062 6520 numbers can be │ │ │ │ │ -000266e0: 6569 7468 6572 2064 6563 696d 616c 206f either decimal o │ │ │ │ │ -000266f0: 7220 6865 7861 6465 6369 6d61 6c2e 2020 r hexadecimal. │ │ │ │ │ -00026700: 4120 6865 7861 6465 6369 6d61 6c0a 2020 A hexadecimal. │ │ │ │ │ -00026710: 2020 206e 756d 6265 7220 6d75 7374 2062 number must b │ │ │ │ │ -00026720: 6520 7072 6563 6564 6564 2062 7920 2730 e preceded by '0 │ │ │ │ │ -00026730: 7827 2c20 616e 6420 6973 2063 6173 652d x', and is case- │ │ │ │ │ -00026740: 696e 7365 6e73 6974 6976 652e 0a0a 2020 insensitive... │ │ │ │ │ -00026750: 2054 6865 7365 2063 6f6d 6d61 6e64 7320 These commands │ │ │ │ │ -00026760: 6361 6e20 6f6e 6c79 2062 6520 7573 6564 can only be used │ │ │ │ │ -00026770: 2069 6e20 7468 6520 6d65 6e75 3a0a 0a2a in the menu:..* │ │ │ │ │ -00026780: 204d 656e 753a 0a0a 2a20 6d65 6e75 656e Menu:..* menuen │ │ │ │ │ -00026790: 7472 793a 3a20 2020 2020 2020 2020 2020 try:: │ │ │ │ │ -000267a0: 2020 2020 2020 2020 5374 6172 7420 6120 Start a │ │ │ │ │ -000267b0: 6d65 6e75 2065 6e74 7279 0a2a 2073 7562 menu entry.* sub │ │ │ │ │ -000267c0: 6d65 6e75 3a3a 2020 2020 2020 2020 2020 menu:: │ │ │ │ │ -000267d0: 2020 2020 2020 2020 2020 2047 726f 7570 Group │ │ │ │ │ -000267e0: 206d 656e 7520 656e 7472 6965 730a 0a1f menu entries... │ │ │ │ │ -000267f0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00026800: 2c20 204e 6f64 653a 206d 656e 7565 6e74 , Node: menuent │ │ │ │ │ -00026810: 7279 2c20 204e 6578 743a 2073 7562 6d65 ry, Next: subme │ │ │ │ │ -00026820: 6e75 2c20 2055 703a 204d 656e 752d 7370 nu, Up: Menu-sp │ │ │ │ │ -00026830: 6563 6966 6963 2063 6f6d 6d61 6e64 730a ecific commands. │ │ │ │ │ -00026840: 0a31 362e 312e 3120 6d65 6e75 656e 7472 .16.1.1 menuentr │ │ │ │ │ -00026850: 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d y.-------------- │ │ │ │ │ -00026860: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -00026870: 206d 656e 7565 6e74 7279 2054 4954 4c45 menuentry TITLE │ │ │ │ │ -00026880: 205b 2d2d 636c 6173 733d 636c 6173 7320 [--class=class │ │ │ │ │ -00026890: 2e2e 2e5d 205b 2d2d 7573 6572 733d 7573 ...] [--users=us │ │ │ │ │ -000268a0: 6572 735d 0a20 2020 2020 2020 2020 205b ers]. [ │ │ │ │ │ -000268b0: 2d2d 756e 7265 7374 7269 6374 6564 5d20 --unrestricted] │ │ │ │ │ -000268c0: 5b2d 2d68 6f74 6b65 793d 6b65 795d 205b [--hotkey=key] [ │ │ │ │ │ -000268d0: 2d2d 6964 3d69 645d 205b 4152 4720 2e2e --id=id] [ARG .. │ │ │ │ │ -000268e0: 2e5d 207b 2043 4f4d 4d41 4e44 3b0a 2020 .] { COMMAND;. │ │ │ │ │ -000268f0: 2020 2020 2020 2020 2e2e 2e20 7d0a 2020 ... }. │ │ │ │ │ -00026900: 2020 2054 6869 7320 6465 6669 6e65 7320 This defines │ │ │ │ │ -00026910: 6120 4752 5542 206d 656e 7520 656e 7472 a GRUB menu entr │ │ │ │ │ -00026920: 7920 6e61 6d65 6420 5449 544c 452e 2020 y named TITLE. │ │ │ │ │ -00026930: 5768 656e 2074 6869 7320 656e 7472 7920 When this entry │ │ │ │ │ -00026940: 6973 0a20 2020 2020 7365 6c65 6374 6564 is. selected │ │ │ │ │ -00026950: 2066 726f 6d20 7468 6520 6d65 6e75 2c20 from the menu, │ │ │ │ │ -00026960: 4752 5542 2077 696c 6c20 7365 7420 7468 GRUB will set th │ │ │ │ │ -00026970: 6520 4348 4f53 454e 2065 6e76 6972 6f6e e CHOSEN environ │ │ │ │ │ -00026980: 6d65 6e74 0a20 2020 2020 7661 7269 6162 ment. variab │ │ │ │ │ -00026990: 6c65 2074 6f20 7661 6c75 6520 6f66 2027 le to value of ' │ │ │ │ │ -000269a0: 2d2d 6964 2720 6966 2027 2d2d 6964 2720 --id' if '--id' │ │ │ │ │ -000269b0: 6973 2067 6976 656e 2c20 6578 6563 7574 is given, execut │ │ │ │ │ -000269c0: 6520 7468 6520 6c69 7374 206f 660a 2020 e the list of. │ │ │ │ │ -000269d0: 2020 2063 6f6d 6d61 6e64 7320 6769 7665 commands give │ │ │ │ │ -000269e0: 6e20 7769 7468 696e 2062 7261 6365 732c n within braces, │ │ │ │ │ -000269f0: 2061 6e64 2069 6620 7468 6520 6c61 7374 and if the last │ │ │ │ │ -00026a00: 2063 6f6d 6d61 6e64 2069 6e20 7468 6520 command in the │ │ │ │ │ -00026a10: 6c69 7374 0a20 2020 2020 7265 7475 726e list. return │ │ │ │ │ -00026a20: 6564 2073 7563 6365 7373 6675 6c6c 7920 ed successfully │ │ │ │ │ -00026a30: 616e 6420 6120 6b65 726e 656c 2077 6173 and a kernel was │ │ │ │ │ -00026a40: 206c 6f61 6465 6420 6974 2077 696c 6c20 loaded it will │ │ │ │ │ -00026a50: 6578 6563 7574 6520 7468 650a 2020 2020 execute the. │ │ │ │ │ -00026a60: 2027 626f 6f74 2720 636f 6d6d 616e 642e 'boot' command. │ │ │ │ │ -00026a70: 0a0a 2020 2020 2054 6865 2027 2d2d 636c .. The '--cl │ │ │ │ │ -00026a80: 6173 7327 206f 7074 696f 6e20 6d61 7920 ass' option may │ │ │ │ │ -00026a90: 6265 2075 7365 6420 616e 7920 6e75 6d62 be used any numb │ │ │ │ │ -00026aa0: 6572 206f 6620 7469 6d65 7320 746f 2067 er of times to g │ │ │ │ │ -00026ab0: 726f 7570 206d 656e 750a 2020 2020 2065 roup menu. e │ │ │ │ │ -00026ac0: 6e74 7269 6573 2069 6e74 6f20 636c 6173 ntries into clas │ │ │ │ │ -00026ad0: 7365 732e 2020 4d65 6e75 2074 6865 6d65 ses. Menu theme │ │ │ │ │ -00026ae0: 7320 6d61 7920 6469 7370 6c61 7920 6469 s may display di │ │ │ │ │ -00026af0: 6666 6572 656e 7420 636c 6173 7365 730a fferent classes. │ │ │ │ │ -00026b00: 2020 2020 2075 7369 6e67 2064 6966 6665 using diffe │ │ │ │ │ -00026b10: 7265 6e74 2073 7479 6c65 732e 0a0a 2020 rent styles... │ │ │ │ │ -00026b20: 2020 2054 6865 2027 2d2d 7573 6572 7327 The '--users' │ │ │ │ │ -00026b30: 206f 7074 696f 6e20 6772 616e 7473 2073 option grants s │ │ │ │ │ -00026b40: 7065 6369 6669 6320 7573 6572 7320 6163 pecific users ac │ │ │ │ │ -00026b50: 6365 7373 2074 6f20 7370 6563 6966 6963 cess to specific │ │ │ │ │ -00026b60: 206d 656e 750a 2020 2020 2065 6e74 7269 menu. entri │ │ │ │ │ -00026b70: 6573 2e20 202a 4e6f 7465 2053 6563 7572 es. *Note Secur │ │ │ │ │ -00026b80: 6974 793a 3a2e 0a0a 2020 2020 2054 6865 ity::... The │ │ │ │ │ -00026b90: 2027 2d2d 756e 7265 7374 7269 6374 6564 '--unrestricted │ │ │ │ │ -00026ba0: 2720 6f70 7469 6f6e 2067 7261 6e74 7320 ' option grants │ │ │ │ │ -00026bb0: 616c 6c20 7573 6572 7320 6163 6365 7373 all users access │ │ │ │ │ -00026bc0: 2074 6f20 7370 6563 6966 6963 0a20 2020 to specific. │ │ │ │ │ -00026bd0: 2020 6d65 6e75 2065 6e74 7269 6573 2e20 menu entries. │ │ │ │ │ -00026be0: 202a 4e6f 7465 2053 6563 7572 6974 793a *Note Security: │ │ │ │ │ -00026bf0: 3a2e 0a0a 2020 2020 2054 6865 2027 2d2d :... The '-- │ │ │ │ │ -00026c00: 686f 746b 6579 2720 6f70 7469 6f6e 2061 hotkey' option a │ │ │ │ │ -00026c10: 7373 6f63 6961 7465 7320 6120 686f 746b ssociates a hotk │ │ │ │ │ -00026c20: 6579 2077 6974 6820 6120 6d65 6e75 2065 ey with a menu e │ │ │ │ │ -00026c30: 6e74 7279 2e20 204b 4559 0a20 2020 2020 ntry. KEY. │ │ │ │ │ -00026c40: 6d61 7920 6265 2061 2073 696e 676c 6520 may be a single │ │ │ │ │ -00026c50: 6c65 7474 6572 2c20 6f72 206f 6e65 206f letter, or one o │ │ │ │ │ -00026c60: 6620 7468 6520 616c 6961 7365 7320 2762 f the aliases 'b │ │ │ │ │ -00026c70: 6163 6b73 7061 6365 272c 2027 7461 6227 ackspace', 'tab' │ │ │ │ │ -00026c80: 2c0a 2020 2020 206f 7220 2764 656c 6574 ,. or 'delet │ │ │ │ │ -00026c90: 6527 2e0a 0a20 2020 2020 5468 6520 272d e'... The '- │ │ │ │ │ -00026ca0: 2d69 6427 206d 6179 2062 6520 7573 6564 -id' may be used │ │ │ │ │ -00026cb0: 2074 6f20 6173 736f 6369 6174 6520 756e to associate un │ │ │ │ │ -00026cc0: 6971 7565 2069 6465 6e74 6966 6965 7220 ique identifier │ │ │ │ │ -00026cd0: 7769 7468 2061 206d 656e 750a 2020 2020 with a menu. │ │ │ │ │ -00026ce0: 2065 6e74 7279 2e20 2049 4420 6973 2073 entry. ID is s │ │ │ │ │ -00026cf0: 7472 696e 6720 6f66 2041 5343 4949 2061 tring of ASCII a │ │ │ │ │ -00026d00: 7068 616e 756d 6572 6963 2063 6861 7261 phanumeric chara │ │ │ │ │ -00026d10: 6374 6572 732c 2075 6e64 6572 7363 6f72 cters, underscor │ │ │ │ │ -00026d20: 650a 2020 2020 2061 6e64 2068 7970 6865 e. and hyphe │ │ │ │ │ -00026d30: 6e20 616e 6420 7368 6f75 6c64 206e 6f74 n and should not │ │ │ │ │ -00026d40: 2073 7461 7274 2077 6974 6820 6120 6469 start with a di │ │ │ │ │ -00026d50: 6769 742e 0a0a 2020 2020 2041 6c6c 206f git... All o │ │ │ │ │ -00026d60: 7468 6572 2061 7267 756d 656e 7473 2069 ther arguments i │ │ │ │ │ -00026d70: 6e63 6c75 6469 6e67 2054 4954 4c45 2061 ncluding TITLE a │ │ │ │ │ -00026d80: 7265 2070 6173 7365 6420 6173 2070 6f73 re passed as pos │ │ │ │ │ -00026d90: 6974 696f 6e61 6c0a 2020 2020 2070 6172 itional. par │ │ │ │ │ -00026da0: 616d 6574 6572 7320 7768 656e 206c 6973 ameters when lis │ │ │ │ │ -00026db0: 7420 6f66 2063 6f6d 6d61 6e64 7320 6973 t of commands is │ │ │ │ │ -00026dc0: 2065 7865 6375 7465 6420 7769 7468 2054 executed with T │ │ │ │ │ -00026dd0: 4954 4c45 2061 6c77 6179 730a 2020 2020 ITLE always. │ │ │ │ │ -00026de0: 2061 7373 6967 6e65 6420 746f 2027 2431 assigned to '$1 │ │ │ │ │ -00026df0: 272e 0a0a 1f0a 4669 6c65 3a20 6772 7562 '.....File: grub │ │ │ │ │ -00026e00: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7375 .info, Node: su │ │ │ │ │ -00026e10: 626d 656e 752c 2020 5072 6576 3a20 6d65 bmenu, Prev: me │ │ │ │ │ -00026e20: 6e75 656e 7472 792c 2020 5570 3a20 4d65 nuentry, Up: Me │ │ │ │ │ -00026e30: 6e75 2d73 7065 6369 6669 6320 636f 6d6d nu-specific comm │ │ │ │ │ -00026e40: 616e 6473 0a0a 3136 2e31 2e32 2073 7562 ands..16.1.2 sub │ │ │ │ │ -00026e50: 6d65 6e75 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d menu.----------- │ │ │ │ │ -00026e60: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -00026e70: 3a20 7375 626d 656e 7520 5449 544c 4520 : submenu TITLE │ │ │ │ │ -00026e80: 5b2d 2d63 6c61 7373 3d63 6c61 7373 202e [--class=class . │ │ │ │ │ -00026e90: 2e2e 5d20 5b2d 2d75 7365 7273 3d75 7365 ..] [--users=use │ │ │ │ │ -00026ea0: 7273 5d0a 2020 2020 2020 2020 2020 5b2d rs]. [- │ │ │ │ │ -00026eb0: 2d75 6e72 6573 7472 6963 7465 645d 205b -unrestricted] [ │ │ │ │ │ -00026ec0: 2d2d 686f 746b 6579 3d6b 6579 5d20 5b2d --hotkey=key] [- │ │ │ │ │ -00026ed0: 2d69 643d 6964 5d20 7b20 4d45 4e55 2045 -id=id] { MENU E │ │ │ │ │ -00026ee0: 4e54 5249 4553 202e 2e2e 207d 0a20 2020 NTRIES ... }. │ │ │ │ │ -00026ef0: 2020 5468 6973 2064 6566 696e 6573 2061 This defines a │ │ │ │ │ -00026f00: 2073 7562 6d65 6e75 2e20 2041 6e20 656e submenu. An en │ │ │ │ │ -00026f10: 7472 7920 6361 6c6c 6564 2054 4954 4c45 try called TITLE │ │ │ │ │ -00026f20: 2077 696c 6c20 6265 2061 6464 6564 2074 will be added t │ │ │ │ │ -00026f30: 6f20 7468 650a 2020 2020 206d 656e 753b o the. menu; │ │ │ │ │ -00026f40: 2077 6865 6e20 7468 6174 2065 6e74 7279 when that entry │ │ │ │ │ -00026f50: 2069 7320 7365 6c65 6374 6564 2c20 6120 is selected, a │ │ │ │ │ -00026f60: 6e65 7720 6d65 6e75 2077 696c 6c20 6265 new menu will be │ │ │ │ │ -00026f70: 2064 6973 706c 6179 6564 0a20 2020 2020 displayed. │ │ │ │ │ -00026f80: 7368 6f77 696e 6720 616c 6c20 7468 6520 showing all the │ │ │ │ │ -00026f90: 656e 7472 6965 7320 7769 7468 696e 2074 entries within t │ │ │ │ │ -00026fa0: 6869 7320 7375 626d 656e 752e 0a0a 2020 his submenu... │ │ │ │ │ -00026fb0: 2020 2041 6c6c 206f 7074 696f 6e73 2061 All options a │ │ │ │ │ -00026fc0: 7265 2074 6865 2073 616d 6520 6173 2069 re the same as i │ │ │ │ │ -00026fd0: 6e20 7468 6520 276d 656e 7565 6e74 7279 n the 'menuentry │ │ │ │ │ -00026fe0: 2720 636f 6d6d 616e 6420 282a 6e6f 7465 ' command (*note │ │ │ │ │ -00026ff0: 0a20 2020 2020 6d65 6e75 656e 7472 793a . menuentry: │ │ │ │ │ -00027000: 3a29 2e0a 0a1f 0a46 696c 653a 2067 7275 :).....File: gru │ │ │ │ │ -00027010: 622e 696e 666f 2c20 204e 6f64 653a 2047 b.info, Node: G │ │ │ │ │ -00027020: 656e 6572 616c 2063 6f6d 6d61 6e64 732c eneral commands, │ │ │ │ │ -00027030: 2020 4e65 7874 3a20 436f 6d6d 616e 642d Next: Command- │ │ │ │ │ -00027040: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ -00027050: 7472 7920 636f 6d6d 616e 6473 2c20 2050 try commands, P │ │ │ │ │ -00027060: 7265 763a 204d 656e 752d 7370 6563 6966 rev: Menu-specif │ │ │ │ │ -00027070: 6963 2063 6f6d 6d61 6e64 732c 2020 5570 ic commands, Up │ │ │ │ │ -00027080: 3a20 436f 6d6d 616e 6473 0a0a 3136 2e32 : Commands..16.2 │ │ │ │ │ -00027090: 2054 6865 206c 6973 7420 6f66 2067 656e The list of gen │ │ │ │ │ -000270a0: 6572 616c 2063 6f6d 6d61 6e64 730a 3d3d eral commands.== │ │ │ │ │ +000265c0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ │ +000265d0: 7365 6d61 6e74 6963 7320 7573 6564 2069 semantics used i │ │ │ │ │ +000265e0: 6e20 7061 7273 696e 6720 7468 6520 636f n parsing the co │ │ │ │ │ +000265f0: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ +00026600: 2061 7265 2074 6865 2066 6f6c 6c6f 7769 are the followi │ │ │ │ │ +00026610: 6e67 3a0a 0a20 2020 2a20 5468 6520 6669 ng:.. * The fi │ │ │ │ │ +00026620: 6c65 7320 5f6d 7573 745f 2062 6520 696e les _must_ be in │ │ │ │ │ +00026630: 2070 6c61 696e 2d74 6578 7420 666f 726d plain-text form │ │ │ │ │ +00026640: 6174 2e0a 0a20 2020 2a20 2723 2720 6174 at... * '#' at │ │ │ │ │ +00026650: 2074 6865 2062 6567 696e 6e69 6e67 206f the beginning o │ │ │ │ │ +00026660: 6620 6120 6c69 6e65 2069 6e20 6120 636f f a line in a co │ │ │ │ │ +00026670: 6e66 6967 7572 6174 696f 6e20 6669 6c65 nfiguration file │ │ │ │ │ +00026680: 206d 6561 6e73 2069 7420 6973 0a20 2020 means it is. │ │ │ │ │ +00026690: 2020 6f6e 6c79 2061 2063 6f6d 6d65 6e74 only a comment │ │ │ │ │ +000266a0: 2e0a 0a20 2020 2a20 4f70 7469 6f6e 7320 ... * Options │ │ │ │ │ +000266b0: 6172 6520 7365 7061 7261 7465 6420 6279 are separated by │ │ │ │ │ +000266c0: 2073 7061 6365 732e 0a0a 2020 202a 2041 spaces... * A │ │ │ │ │ +000266d0: 6c6c 206e 756d 6265 7273 2063 616e 2062 ll numbers can b │ │ │ │ │ +000266e0: 6520 6569 7468 6572 2064 6563 696d 616c e either decimal │ │ │ │ │ +000266f0: 206f 7220 6865 7861 6465 6369 6d61 6c2e or hexadecimal. │ │ │ │ │ +00026700: 2020 4120 6865 7861 6465 6369 6d61 6c0a A hexadecimal. │ │ │ │ │ +00026710: 2020 2020 206e 756d 6265 7220 6d75 7374 number must │ │ │ │ │ +00026720: 2062 6520 7072 6563 6564 6564 2062 7920 be preceded by │ │ │ │ │ +00026730: 2730 7827 2c20 616e 6420 6973 2063 6173 '0x', and is cas │ │ │ │ │ +00026740: 652d 696e 7365 6e73 6974 6976 652e 0a0a e-insensitive... │ │ │ │ │ +00026750: 2020 2054 6865 7365 2063 6f6d 6d61 6e64 These command │ │ │ │ │ +00026760: 7320 6361 6e20 6f6e 6c79 2062 6520 7573 s can only be us │ │ │ │ │ +00026770: 6564 2069 6e20 7468 6520 6d65 6e75 3a0a ed in the menu:. │ │ │ │ │ +00026780: 0a2a 204d 656e 753a 0a0a 2a20 6d65 6e75 .* Menu:..* menu │ │ │ │ │ +00026790: 656e 7472 793a 3a20 2020 2020 2020 2020 entry:: │ │ │ │ │ +000267a0: 2020 2020 2020 2020 2020 5374 6172 7420 Start │ │ │ │ │ +000267b0: 6120 6d65 6e75 2065 6e74 7279 0a2a 2073 a menu entry.* s │ │ │ │ │ +000267c0: 7562 6d65 6e75 3a3a 2020 2020 2020 2020 ubmenu:: │ │ │ │ │ +000267d0: 2020 2020 2020 2020 2020 2020 2047 726f Gro │ │ │ │ │ +000267e0: 7570 206d 656e 7520 656e 7472 6965 730a up menu entries. │ │ │ │ │ +000267f0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00026800: 666f 2c20 204e 6f64 653a 206d 656e 7565 fo, Node: menue │ │ │ │ │ +00026810: 6e74 7279 2c20 204e 6578 743a 2073 7562 ntry, Next: sub │ │ │ │ │ +00026820: 6d65 6e75 2c20 2055 703a 204d 656e 752d menu, Up: Menu- │ │ │ │ │ +00026830: 7370 6563 6966 6963 2063 6f6d 6d61 6e64 specific command │ │ │ │ │ +00026840: 730a 0a31 362e 312e 3120 6d65 6e75 656e s..16.1.1 menuen │ │ │ │ │ +00026850: 7472 790a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d try.------------ │ │ │ │ │ +00026860: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +00026870: 643a 206d 656e 7565 6e74 7279 2054 4954 d: menuentry TIT │ │ │ │ │ +00026880: 4c45 205b 2d2d 636c 6173 733d 636c 6173 LE [--class=clas │ │ │ │ │ +00026890: 7320 2e2e 2e5d 205b 2d2d 7573 6572 733d s ...] [--users= │ │ │ │ │ +000268a0: 7573 6572 735d 0a20 2020 2020 2020 2020 users]. │ │ │ │ │ +000268b0: 205b 2d2d 756e 7265 7374 7269 6374 6564 [--unrestricted │ │ │ │ │ +000268c0: 5d20 5b2d 2d68 6f74 6b65 793d 6b65 795d ] [--hotkey=key] │ │ │ │ │ +000268d0: 205b 2d2d 6964 3d69 645d 205b 4152 4720 [--id=id] [ARG │ │ │ │ │ +000268e0: 2e2e 2e5d 207b 2043 4f4d 4d41 4e44 3b0a ...] { COMMAND;. │ │ │ │ │ +000268f0: 2020 2020 2020 2020 2020 2e2e 2e20 7d0a ... }. │ │ │ │ │ +00026900: 2020 2020 2054 6869 7320 6465 6669 6e65 This define │ │ │ │ │ +00026910: 7320 6120 4752 5542 206d 656e 7520 656e s a GRUB menu en │ │ │ │ │ +00026920: 7472 7920 6e61 6d65 6420 5449 544c 452e try named TITLE. │ │ │ │ │ +00026930: 2020 5768 656e 2074 6869 7320 656e 7472 When this entr │ │ │ │ │ +00026940: 7920 6973 0a20 2020 2020 7365 6c65 6374 y is. select │ │ │ │ │ +00026950: 6564 2066 726f 6d20 7468 6520 6d65 6e75 ed from the menu │ │ │ │ │ +00026960: 2c20 4752 5542 2077 696c 6c20 7365 7420 , GRUB will set │ │ │ │ │ +00026970: 7468 6520 4348 4f53 454e 2065 6e76 6972 the CHOSEN envir │ │ │ │ │ +00026980: 6f6e 6d65 6e74 0a20 2020 2020 7661 7269 onment. vari │ │ │ │ │ +00026990: 6162 6c65 2074 6f20 7661 6c75 6520 6f66 able to value of │ │ │ │ │ +000269a0: 2027 2d2d 6964 2720 6966 2027 2d2d 6964 '--id' if '--id │ │ │ │ │ +000269b0: 2720 6973 2067 6976 656e 2c20 6578 6563 ' is given, exec │ │ │ │ │ +000269c0: 7574 6520 7468 6520 6c69 7374 206f 660a ute the list of. │ │ │ │ │ +000269d0: 2020 2020 2063 6f6d 6d61 6e64 7320 6769 commands gi │ │ │ │ │ +000269e0: 7665 6e20 7769 7468 696e 2062 7261 6365 ven within brace │ │ │ │ │ +000269f0: 732c 2061 6e64 2069 6620 7468 6520 6c61 s, and if the la │ │ │ │ │ +00026a00: 7374 2063 6f6d 6d61 6e64 2069 6e20 7468 st command in th │ │ │ │ │ +00026a10: 6520 6c69 7374 0a20 2020 2020 7265 7475 e list. retu │ │ │ │ │ +00026a20: 726e 6564 2073 7563 6365 7373 6675 6c6c rned successfull │ │ │ │ │ +00026a30: 7920 616e 6420 6120 6b65 726e 656c 2077 y and a kernel w │ │ │ │ │ +00026a40: 6173 206c 6f61 6465 6420 6974 2077 696c as loaded it wil │ │ │ │ │ +00026a50: 6c20 6578 6563 7574 6520 7468 650a 2020 l execute the. │ │ │ │ │ +00026a60: 2020 2027 626f 6f74 2720 636f 6d6d 616e 'boot' comman │ │ │ │ │ +00026a70: 642e 0a0a 2020 2020 2054 6865 2027 2d2d d... The '-- │ │ │ │ │ +00026a80: 636c 6173 7327 206f 7074 696f 6e20 6d61 class' option ma │ │ │ │ │ +00026a90: 7920 6265 2075 7365 6420 616e 7920 6e75 y be used any nu │ │ │ │ │ +00026aa0: 6d62 6572 206f 6620 7469 6d65 7320 746f mber of times to │ │ │ │ │ +00026ab0: 2067 726f 7570 206d 656e 750a 2020 2020 group menu. │ │ │ │ │ +00026ac0: 2065 6e74 7269 6573 2069 6e74 6f20 636c entries into cl │ │ │ │ │ +00026ad0: 6173 7365 732e 2020 4d65 6e75 2074 6865 asses. Menu the │ │ │ │ │ +00026ae0: 6d65 7320 6d61 7920 6469 7370 6c61 7920 mes may display │ │ │ │ │ +00026af0: 6469 6666 6572 656e 7420 636c 6173 7365 different classe │ │ │ │ │ +00026b00: 730a 2020 2020 2075 7369 6e67 2064 6966 s. using dif │ │ │ │ │ +00026b10: 6665 7265 6e74 2073 7479 6c65 732e 0a0a ferent styles... │ │ │ │ │ +00026b20: 2020 2020 2054 6865 2027 2d2d 7573 6572 The '--user │ │ │ │ │ +00026b30: 7327 206f 7074 696f 6e20 6772 616e 7473 s' option grants │ │ │ │ │ +00026b40: 2073 7065 6369 6669 6320 7573 6572 7320 specific users │ │ │ │ │ +00026b50: 6163 6365 7373 2074 6f20 7370 6563 6966 access to specif │ │ │ │ │ +00026b60: 6963 206d 656e 750a 2020 2020 2065 6e74 ic menu. ent │ │ │ │ │ +00026b70: 7269 6573 2e20 202a 4e6f 7465 2053 6563 ries. *Note Sec │ │ │ │ │ +00026b80: 7572 6974 793a 3a2e 0a0a 2020 2020 2054 urity::... T │ │ │ │ │ +00026b90: 6865 2027 2d2d 756e 7265 7374 7269 6374 he '--unrestrict │ │ │ │ │ +00026ba0: 6564 2720 6f70 7469 6f6e 2067 7261 6e74 ed' option grant │ │ │ │ │ +00026bb0: 7320 616c 6c20 7573 6572 7320 6163 6365 s all users acce │ │ │ │ │ +00026bc0: 7373 2074 6f20 7370 6563 6966 6963 0a20 ss to specific. │ │ │ │ │ +00026bd0: 2020 2020 6d65 6e75 2065 6e74 7269 6573 menu entries │ │ │ │ │ +00026be0: 2e20 202a 4e6f 7465 2053 6563 7572 6974 . *Note Securit │ │ │ │ │ +00026bf0: 793a 3a2e 0a0a 2020 2020 2054 6865 2027 y::... The ' │ │ │ │ │ +00026c00: 2d2d 686f 746b 6579 2720 6f70 7469 6f6e --hotkey' option │ │ │ │ │ +00026c10: 2061 7373 6f63 6961 7465 7320 6120 686f associates a ho │ │ │ │ │ +00026c20: 746b 6579 2077 6974 6820 6120 6d65 6e75 tkey with a menu │ │ │ │ │ +00026c30: 2065 6e74 7279 2e20 204b 4559 0a20 2020 entry. KEY. │ │ │ │ │ +00026c40: 2020 6d61 7920 6265 2061 2073 696e 676c may be a singl │ │ │ │ │ +00026c50: 6520 6c65 7474 6572 2c20 6f72 206f 6e65 e letter, or one │ │ │ │ │ +00026c60: 206f 6620 7468 6520 616c 6961 7365 7320 of the aliases │ │ │ │ │ +00026c70: 2762 6163 6b73 7061 6365 272c 2027 7461 'backspace', 'ta │ │ │ │ │ +00026c80: 6227 2c0a 2020 2020 206f 7220 2764 656c b',. or 'del │ │ │ │ │ +00026c90: 6574 6527 2e0a 0a20 2020 2020 5468 6520 ete'... The │ │ │ │ │ +00026ca0: 272d 2d69 6427 206d 6179 2062 6520 7573 '--id' may be us │ │ │ │ │ +00026cb0: 6564 2074 6f20 6173 736f 6369 6174 6520 ed to associate │ │ │ │ │ +00026cc0: 756e 6971 7565 2069 6465 6e74 6966 6965 unique identifie │ │ │ │ │ +00026cd0: 7220 7769 7468 2061 206d 656e 750a 2020 r with a menu. │ │ │ │ │ +00026ce0: 2020 2065 6e74 7279 2e20 2049 4420 6973 entry. ID is │ │ │ │ │ +00026cf0: 2073 7472 696e 6720 6f66 2041 5343 4949 string of ASCII │ │ │ │ │ +00026d00: 2061 7068 616e 756d 6572 6963 2063 6861 aphanumeric cha │ │ │ │ │ +00026d10: 7261 6374 6572 732c 2075 6e64 6572 7363 racters, undersc │ │ │ │ │ +00026d20: 6f72 650a 2020 2020 2061 6e64 2068 7970 ore. and hyp │ │ │ │ │ +00026d30: 6865 6e20 616e 6420 7368 6f75 6c64 206e hen and should n │ │ │ │ │ +00026d40: 6f74 2073 7461 7274 2077 6974 6820 6120 ot start with a │ │ │ │ │ +00026d50: 6469 6769 742e 0a0a 2020 2020 2041 6c6c digit... All │ │ │ │ │ +00026d60: 206f 7468 6572 2061 7267 756d 656e 7473 other arguments │ │ │ │ │ +00026d70: 2069 6e63 6c75 6469 6e67 2054 4954 4c45 including TITLE │ │ │ │ │ +00026d80: 2061 7265 2070 6173 7365 6420 6173 2070 are passed as p │ │ │ │ │ +00026d90: 6f73 6974 696f 6e61 6c0a 2020 2020 2070 ositional. p │ │ │ │ │ +00026da0: 6172 616d 6574 6572 7320 7768 656e 206c arameters when l │ │ │ │ │ +00026db0: 6973 7420 6f66 2063 6f6d 6d61 6e64 7320 ist of commands │ │ │ │ │ +00026dc0: 6973 2065 7865 6375 7465 6420 7769 7468 is executed with │ │ │ │ │ +00026dd0: 2054 4954 4c45 2061 6c77 6179 730a 2020 TITLE always. │ │ │ │ │ +00026de0: 2020 2061 7373 6967 6e65 6420 746f 2027 assigned to ' │ │ │ │ │ +00026df0: 2431 272e 0a0a 1f0a 4669 6c65 3a20 6772 $1'.....File: gr │ │ │ │ │ +00026e00: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00026e10: 7375 626d 656e 752c 2020 5072 6576 3a20 submenu, Prev: │ │ │ │ │ +00026e20: 6d65 6e75 656e 7472 792c 2020 5570 3a20 menuentry, Up: │ │ │ │ │ +00026e30: 4d65 6e75 2d73 7065 6369 6669 6320 636f Menu-specific co │ │ │ │ │ +00026e40: 6d6d 616e 6473 0a0a 3136 2e31 2e32 2073 mmands..16.1.2 s │ │ │ │ │ +00026e50: 7562 6d65 6e75 0a2d 2d2d 2d2d 2d2d 2d2d ubmenu.--------- │ │ │ │ │ +00026e60: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +00026e70: 6e64 3a20 7375 626d 656e 7520 5449 544c nd: submenu TITL │ │ │ │ │ +00026e80: 4520 5b2d 2d63 6c61 7373 3d63 6c61 7373 E [--class=class │ │ │ │ │ +00026e90: 202e 2e2e 5d20 5b2d 2d75 7365 7273 3d75 ...] [--users=u │ │ │ │ │ +00026ea0: 7365 7273 5d0a 2020 2020 2020 2020 2020 sers]. │ │ │ │ │ +00026eb0: 5b2d 2d75 6e72 6573 7472 6963 7465 645d [--unrestricted] │ │ │ │ │ +00026ec0: 205b 2d2d 686f 746b 6579 3d6b 6579 5d20 [--hotkey=key] │ │ │ │ │ +00026ed0: 5b2d 2d69 643d 6964 5d20 7b20 4d45 4e55 [--id=id] { MENU │ │ │ │ │ +00026ee0: 2045 4e54 5249 4553 202e 2e2e 207d 0a20 ENTRIES ... }. │ │ │ │ │ +00026ef0: 2020 2020 5468 6973 2064 6566 696e 6573 This defines │ │ │ │ │ +00026f00: 2061 2073 7562 6d65 6e75 2e20 2041 6e20 a submenu. An │ │ │ │ │ +00026f10: 656e 7472 7920 6361 6c6c 6564 2054 4954 entry called TIT │ │ │ │ │ +00026f20: 4c45 2077 696c 6c20 6265 2061 6464 6564 LE will be added │ │ │ │ │ +00026f30: 2074 6f20 7468 650a 2020 2020 206d 656e to the. men │ │ │ │ │ +00026f40: 753b 2077 6865 6e20 7468 6174 2065 6e74 u; when that ent │ │ │ │ │ +00026f50: 7279 2069 7320 7365 6c65 6374 6564 2c20 ry is selected, │ │ │ │ │ +00026f60: 6120 6e65 7720 6d65 6e75 2077 696c 6c20 a new menu will │ │ │ │ │ +00026f70: 6265 2064 6973 706c 6179 6564 0a20 2020 be displayed. │ │ │ │ │ +00026f80: 2020 7368 6f77 696e 6720 616c 6c20 7468 showing all th │ │ │ │ │ +00026f90: 6520 656e 7472 6965 7320 7769 7468 696e e entries within │ │ │ │ │ +00026fa0: 2074 6869 7320 7375 626d 656e 752e 0a0a this submenu... │ │ │ │ │ +00026fb0: 2020 2020 2041 6c6c 206f 7074 696f 6e73 All options │ │ │ │ │ +00026fc0: 2061 7265 2074 6865 2073 616d 6520 6173 are the same as │ │ │ │ │ +00026fd0: 2069 6e20 7468 6520 276d 656e 7565 6e74 in the 'menuent │ │ │ │ │ +00026fe0: 7279 2720 636f 6d6d 616e 6420 282a 6e6f ry' command (*no │ │ │ │ │ +00026ff0: 7465 0a20 2020 2020 6d65 6e75 656e 7472 te. menuentr │ │ │ │ │ +00027000: 793a 3a29 2e0a 0a1f 0a46 696c 653a 2067 y::).....File: g │ │ │ │ │ +00027010: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +00027020: 2047 656e 6572 616c 2063 6f6d 6d61 6e64 General command │ │ │ │ │ +00027030: 732c 2020 4e65 7874 3a20 436f 6d6d 616e s, Next: Comman │ │ │ │ │ +00027040: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ +00027050: 656e 7472 7920 636f 6d6d 616e 6473 2c20 entry commands, │ │ │ │ │ +00027060: 2050 7265 763a 204d 656e 752d 7370 6563 Prev: Menu-spec │ │ │ │ │ +00027070: 6966 6963 2063 6f6d 6d61 6e64 732c 2020 ific commands, │ │ │ │ │ +00027080: 5570 3a20 436f 6d6d 616e 6473 0a0a 3136 Up: Commands..16 │ │ │ │ │ +00027090: 2e32 2054 6865 206c 6973 7420 6f66 2067 .2 The list of g │ │ │ │ │ +000270a0: 656e 6572 616c 2063 6f6d 6d61 6e64 730a eneral commands. │ │ │ │ │ 000270b0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000270c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a ===============. │ │ │ │ │ -000270d0: 0a43 6f6d 6d61 6e64 7320 7573 6162 6c65 .Commands usable │ │ │ │ │ -000270e0: 2061 6e79 7768 6572 6520 696e 2074 6865 anywhere in the │ │ │ │ │ -000270f0: 206d 656e 7520 616e 6420 696e 2074 6865 menu and in the │ │ │ │ │ -00027100: 2063 6f6d 6d61 6e64 2d6c 696e 652e 0a0a command-line... │ │ │ │ │ -00027110: 2a20 4d65 6e75 3a0a 0a2a 2073 6572 6961 * Menu:..* seria │ │ │ │ │ -00027120: 6c3a 3a20 2020 2020 2020 2020 2020 2020 l:: │ │ │ │ │ -00027130: 2020 2020 2020 2020 2053 6574 2075 7020 Set up │ │ │ │ │ -00027140: 6120 7365 7269 616c 2064 6576 6963 650a a serial device. │ │ │ │ │ -00027150: 2a20 7465 726d 696e 616c 5f69 6e70 7574 * terminal_input │ │ │ │ │ -00027160: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00027170: 4d61 6e61 6765 2069 6e70 7574 2074 6572 Manage input ter │ │ │ │ │ -00027180: 6d69 6e61 6c73 0a2a 2074 6572 6d69 6e61 minals.* termina │ │ │ │ │ -00027190: 6c5f 6f75 7470 7574 3a3a 2020 2020 2020 l_output:: │ │ │ │ │ -000271a0: 2020 2020 2020 204d 616e 6167 6520 6f75 Manage ou │ │ │ │ │ -000271b0: 7470 7574 2074 6572 6d69 6e61 6c73 0a2a tput terminals.* │ │ │ │ │ -000271c0: 2074 6572 6d69 6e66 6f3a 3a20 2020 2020 terminfo:: │ │ │ │ │ -000271d0: 2020 2020 2020 2020 2020 2020 2020 2044 D │ │ │ │ │ -000271e0: 6566 696e 6520 7465 726d 696e 616c 2074 efine terminal t │ │ │ │ │ -000271f0: 7970 650a 0a1f 0a46 696c 653a 2067 7275 ype....File: gru │ │ │ │ │ -00027200: 622e 696e 666f 2c20 204e 6f64 653a 2073 b.info, Node: s │ │ │ │ │ -00027210: 6572 6961 6c2c 2020 4e65 7874 3a20 7465 erial, Next: te │ │ │ │ │ -00027220: 726d 696e 616c 5f69 6e70 7574 2c20 2055 rminal_input, U │ │ │ │ │ -00027230: 703a 2047 656e 6572 616c 2063 6f6d 6d61 p: General comma │ │ │ │ │ -00027240: 6e64 730a 0a31 362e 322e 3120 7365 7269 nds..16.2.1 seri │ │ │ │ │ -00027250: 616c 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d al.------------- │ │ │ │ │ -00027260: 0a0a 202d 2d20 436f 6d6d 616e 643a 2073 .. -- Command: s │ │ │ │ │ -00027270: 6572 6961 6c20 5b2d 2d75 6e69 743d 756e erial [--unit=un │ │ │ │ │ -00027280: 6974 5d20 5b2d 2d70 6f72 743d 706f 7274 it] [--port=port │ │ │ │ │ -00027290: 5d20 5b2d 2d73 7065 6564 3d73 7065 6564 ] [--speed=speed │ │ │ │ │ -000272a0: 5d0a 2020 2020 2020 2020 2020 5b2d 2d77 ]. [--w │ │ │ │ │ -000272b0: 6f72 643d 776f 7264 5d20 5b2d 2d70 6172 ord=word] [--par │ │ │ │ │ -000272c0: 6974 793d 7061 7269 7479 5d20 5b2d 2d73 ity=parity] [--s │ │ │ │ │ -000272d0: 746f 703d 7374 6f70 5d0a 2020 2020 2049 top=stop]. I │ │ │ │ │ -000272e0: 6e69 7469 616c 697a 6520 6120 7365 7269 nitialize a seri │ │ │ │ │ -000272f0: 616c 2064 6576 6963 652e 2020 554e 4954 al device. UNIT │ │ │ │ │ -00027300: 2069 7320 6120 6e75 6d62 6572 2069 6e20 is a number in │ │ │ │ │ -00027310: 7468 6520 7261 6e67 6520 302d 330a 2020 the range 0-3. │ │ │ │ │ -00027320: 2020 2073 7065 6369 6679 696e 6720 7768 specifying wh │ │ │ │ │ -00027330: 6963 6820 7365 7269 616c 2070 6f72 7420 ich serial port │ │ │ │ │ -00027340: 746f 2075 7365 3b20 6465 6661 756c 7420 to use; default │ │ │ │ │ -00027350: 6973 2030 2c20 7768 6963 680a 2020 2020 is 0, which. │ │ │ │ │ -00027360: 2063 6f72 7265 7370 6f6e 6473 2074 6f20 corresponds to │ │ │ │ │ -00027370: 7468 6520 706f 7274 206f 6674 656e 2063 the port often c │ │ │ │ │ -00027380: 616c 6c65 6420 434f 4d31 2e20 2050 4f52 alled COM1. POR │ │ │ │ │ -00027390: 5420 6973 2074 6865 2049 2f4f 2070 6f72 T is the I/O por │ │ │ │ │ -000273a0: 740a 2020 2020 2077 6865 7265 2074 6865 t. where the │ │ │ │ │ -000273b0: 2055 4152 5420 6973 2074 6f20 6265 2066 UART is to be f │ │ │ │ │ -000273c0: 6f75 6e64 3b20 6966 2073 7065 6369 6669 ound; if specifi │ │ │ │ │ -000273d0: 6564 2069 7420 7461 6b65 7320 7072 6563 ed it takes prec │ │ │ │ │ -000273e0: 6564 656e 6365 0a20 2020 2020 6f76 6572 edence. over │ │ │ │ │ -000273f0: 2055 4e49 542e 2020 5350 4545 4420 6973 UNIT. SPEED is │ │ │ │ │ -00027400: 2074 6865 2074 7261 6e73 6d69 7373 696f the transmissio │ │ │ │ │ -00027410: 6e20 7370 6565 643b 2064 6566 6175 6c74 n speed; default │ │ │ │ │ -00027420: 2069 7320 3936 3030 2e20 2057 4f52 440a is 9600. WORD. │ │ │ │ │ -00027430: 2020 2020 2061 6e64 2053 544f 5020 6172 and STOP ar │ │ │ │ │ -00027440: 6520 7468 6520 6e75 6d62 6572 206f 6620 e the number of │ │ │ │ │ -00027450: 6461 7461 2062 6974 7320 616e 6420 7374 data bits and st │ │ │ │ │ -00027460: 6f70 2062 6974 732e 2020 4461 7461 2062 op bits. Data b │ │ │ │ │ -00027470: 6974 7320 6d75 7374 0a20 2020 2020 6265 its must. be │ │ │ │ │ -00027480: 2069 6e20 7468 6520 7261 6e67 6520 352d in the range 5- │ │ │ │ │ -00027490: 3820 616e 6420 7374 6f70 2062 6974 7320 8 and stop bits │ │ │ │ │ -000274a0: 6d75 7374 2062 6520 3120 6f72 2032 2e20 must be 1 or 2. │ │ │ │ │ -000274b0: 2044 6566 6175 6c74 2069 7320 380a 2020 Default is 8. │ │ │ │ │ -000274c0: 2020 2064 6174 6120 6269 7473 2061 6e64 data bits and │ │ │ │ │ -000274d0: 206f 6e65 2073 746f 7020 6269 742e 2020 one stop bit. │ │ │ │ │ -000274e0: 5041 5249 5459 2069 7320 6f6e 6520 6f66 PARITY is one of │ │ │ │ │ -000274f0: 2027 6e6f 272c 2027 6f64 6427 2c20 2765 'no', 'odd', 'e │ │ │ │ │ -00027500: 7665 6e27 0a20 2020 2020 616e 6420 6465 ven'. and de │ │ │ │ │ -00027510: 6661 756c 7473 2074 6f20 276e 6f27 2e0a faults to 'no'.. │ │ │ │ │ -00027520: 0a20 2020 2020 5468 6520 7365 7269 616c . The serial │ │ │ │ │ -00027530: 2070 6f72 7420 6973 206e 6f74 2075 7365 port is not use │ │ │ │ │ -00027540: 6420 6173 2061 2063 6f6d 6d75 6e69 6361 d as a communica │ │ │ │ │ -00027550: 7469 6f6e 2063 6861 6e6e 656c 2075 6e6c tion channel unl │ │ │ │ │ -00027560: 6573 7320 7468 650a 2020 2020 2027 7465 ess the. 'te │ │ │ │ │ -00027570: 726d 696e 616c 5f69 6e70 7574 2720 6f72 rminal_input' or │ │ │ │ │ -00027580: 2027 7465 726d 696e 616c 5f6f 7574 7075 'terminal_outpu │ │ │ │ │ -00027590: 7427 2063 6f6d 6d61 6e64 2069 7320 7573 t' command is us │ │ │ │ │ -000275a0: 6564 2028 2a6e 6f74 650a 2020 2020 2074 ed (*note. t │ │ │ │ │ -000275b0: 6572 6d69 6e61 6c5f 696e 7075 743a 3a2c erminal_input::, │ │ │ │ │ -000275c0: 202a 6e6f 7465 2074 6572 6d69 6e61 6c5f *note terminal_ │ │ │ │ │ -000275d0: 6f75 7470 7574 3a3a 292e 0a0a 2020 2020 output::)... │ │ │ │ │ -000275e0: 2053 6565 2061 6c73 6f20 2a6e 6f74 6520 See also *note │ │ │ │ │ -000275f0: 5365 7269 616c 2074 6572 6d69 6e61 6c3a Serial terminal: │ │ │ │ │ -00027600: 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 :.....File: grub │ │ │ │ │ -00027610: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7465 .info, Node: te │ │ │ │ │ -00027620: 726d 696e 616c 5f69 6e70 7574 2c20 204e rminal_input, N │ │ │ │ │ -00027630: 6578 743a 2074 6572 6d69 6e61 6c5f 6f75 ext: terminal_ou │ │ │ │ │ -00027640: 7470 7574 2c20 2050 7265 763a 2073 6572 tput, Prev: ser │ │ │ │ │ -00027650: 6961 6c2c 2020 5570 3a20 4765 6e65 7261 ial, Up: Genera │ │ │ │ │ -00027660: 6c20 636f 6d6d 616e 6473 0a0a 3136 2e32 l commands..16.2 │ │ │ │ │ -00027670: 2e32 2074 6572 6d69 6e61 6c5f 696e 7075 .2 terminal_inpu │ │ │ │ │ -00027680: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ │ -00027690: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ -000276a0: 6d61 6e64 3a20 7465 726d 696e 616c 5f69 mand: terminal_i │ │ │ │ │ -000276b0: 6e70 7574 205b 2d2d 6170 7065 6e64 7c2d nput [--append|- │ │ │ │ │ -000276c0: 2d72 656d 6f76 655d 205b 7465 726d 696e -remove] [termin │ │ │ │ │ -000276d0: 616c 315d 205b 7465 726d 696e 616c 325d al1] [terminal2] │ │ │ │ │ -000276e0: 0a20 2020 2020 2020 2020 202e 2e2e 0a20 . .... │ │ │ │ │ -000276f0: 2020 2020 4c69 7374 206f 7220 7365 6c65 List or sele │ │ │ │ │ -00027700: 6374 2061 6e20 696e 7075 7420 7465 726d ct an input term │ │ │ │ │ -00027710: 696e 616c 2e0a 0a20 2020 2020 5769 7468 inal... With │ │ │ │ │ -00027720: 206e 6f20 6172 6775 6d65 6e74 732c 206c no arguments, l │ │ │ │ │ -00027730: 6973 7420 7468 6520 6163 7469 7665 2061 ist the active a │ │ │ │ │ -00027740: 6e64 2061 7661 696c 6162 6c65 2069 6e70 nd available inp │ │ │ │ │ -00027750: 7574 2074 6572 6d69 6e61 6c73 2e0a 0a20 ut terminals... │ │ │ │ │ -00027760: 2020 2020 5769 7468 2027 2d2d 6170 7065 With '--appe │ │ │ │ │ -00027770: 6e64 272c 2061 6464 2074 6865 206e 616d nd', add the nam │ │ │ │ │ -00027780: 6564 2074 6572 6d69 6e61 6c73 2074 6f20 ed terminals to │ │ │ │ │ -00027790: 7468 6520 6c69 7374 206f 6620 6163 7469 the list of acti │ │ │ │ │ -000277a0: 7665 0a20 2020 2020 696e 7075 7420 7465 ve. input te │ │ │ │ │ -000277b0: 726d 696e 616c 733b 2061 6e79 206f 6620 rminals; any of │ │ │ │ │ -000277c0: 7468 6573 6520 6d61 7920 6265 2075 7365 these may be use │ │ │ │ │ -000277d0: 6420 746f 2070 726f 7669 6465 2069 6e70 d to provide inp │ │ │ │ │ -000277e0: 7574 2074 6f20 4752 5542 2e0a 0a20 2020 ut to GRUB... │ │ │ │ │ -000277f0: 2020 5769 7468 2027 2d2d 7265 6d6f 7665 With '--remove │ │ │ │ │ -00027800: 272c 2072 656d 6f76 6520 7468 6520 6e61 ', remove the na │ │ │ │ │ -00027810: 6d65 6420 7465 726d 696e 616c 7320 6672 med terminals fr │ │ │ │ │ -00027820: 6f6d 2074 6865 2061 6374 6976 6520 6c69 om the active li │ │ │ │ │ -00027830: 7374 2e0a 0a20 2020 2020 5769 7468 206e st... With n │ │ │ │ │ -00027840: 6f20 6f70 7469 6f6e 7320 6275 7420 6120 o options but a │ │ │ │ │ -00027850: 6c69 7374 206f 6620 7465 726d 696e 616c list of terminal │ │ │ │ │ -00027860: 206e 616d 6573 2c20 6d61 6b65 206f 6e6c names, make onl │ │ │ │ │ -00027870: 7920 7468 6520 6c69 7374 6564 0a20 2020 y the listed. │ │ │ │ │ -00027880: 2020 7465 726d 696e 616c 206e 616d 6573 terminal names │ │ │ │ │ -00027890: 2061 6374 6976 652e 0a0a 1f0a 4669 6c65 active.....File │ │ │ │ │ -000278a0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -000278b0: 6465 3a20 7465 726d 696e 616c 5f6f 7574 de: terminal_out │ │ │ │ │ -000278c0: 7075 742c 2020 4e65 7874 3a20 7465 726d put, Next: term │ │ │ │ │ -000278d0: 696e 666f 2c20 2050 7265 763a 2074 6572 info, Prev: ter │ │ │ │ │ -000278e0: 6d69 6e61 6c5f 696e 7075 742c 2020 5570 minal_input, Up │ │ │ │ │ -000278f0: 3a20 4765 6e65 7261 6c20 636f 6d6d 616e : General comman │ │ │ │ │ -00027900: 6473 0a0a 3136 2e32 2e33 2074 6572 6d69 ds..16.2.3 termi │ │ │ │ │ -00027910: 6e61 6c5f 6f75 7470 7574 0a2d 2d2d 2d2d nal_output.----- │ │ │ │ │ +000270c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +000270d0: 3d0a 0a43 6f6d 6d61 6e64 7320 7573 6162 =..Commands usab │ │ │ │ │ +000270e0: 6c65 2061 6e79 7768 6572 6520 696e 2074 le anywhere in t │ │ │ │ │ +000270f0: 6865 206d 656e 7520 616e 6420 696e 2074 he menu and in t │ │ │ │ │ +00027100: 6865 2063 6f6d 6d61 6e64 2d6c 696e 652e he command-line. │ │ │ │ │ +00027110: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2073 6572 ..* Menu:..* ser │ │ │ │ │ +00027120: 6961 6c3a 3a20 2020 2020 2020 2020 2020 ial:: │ │ │ │ │ +00027130: 2020 2020 2020 2020 2020 2053 6574 2075 Set u │ │ │ │ │ +00027140: 7020 6120 7365 7269 616c 2064 6576 6963 p a serial devic │ │ │ │ │ +00027150: 650a 2a20 7465 726d 696e 616c 5f69 6e70 e.* terminal_inp │ │ │ │ │ +00027160: 7574 3a3a 2020 2020 2020 2020 2020 2020 ut:: │ │ │ │ │ +00027170: 2020 4d61 6e61 6765 2069 6e70 7574 2074 Manage input t │ │ │ │ │ +00027180: 6572 6d69 6e61 6c73 0a2a 2074 6572 6d69 erminals.* termi │ │ │ │ │ +00027190: 6e61 6c5f 6f75 7470 7574 3a3a 2020 2020 nal_output:: │ │ │ │ │ +000271a0: 2020 2020 2020 2020 204d 616e 6167 6520 Manage │ │ │ │ │ +000271b0: 6f75 7470 7574 2074 6572 6d69 6e61 6c73 output terminals │ │ │ │ │ +000271c0: 0a2a 2074 6572 6d69 6e66 6f3a 3a20 2020 .* terminfo:: │ │ │ │ │ +000271d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000271e0: 2044 6566 696e 6520 7465 726d 696e 616c Define terminal │ │ │ │ │ +000271f0: 2074 7970 650a 0a1f 0a46 696c 653a 2067 type....File: g │ │ │ │ │ +00027200: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +00027210: 2073 6572 6961 6c2c 2020 4e65 7874 3a20 serial, Next: │ │ │ │ │ +00027220: 7465 726d 696e 616c 5f69 6e70 7574 2c20 terminal_input, │ │ │ │ │ +00027230: 2055 703a 2047 656e 6572 616c 2063 6f6d Up: General com │ │ │ │ │ +00027240: 6d61 6e64 730a 0a31 362e 322e 3120 7365 mands..16.2.1 se │ │ │ │ │ +00027250: 7269 616c 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d rial.----------- │ │ │ │ │ +00027260: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ +00027270: 2073 6572 6961 6c20 5b2d 2d75 6e69 743d serial [--unit= │ │ │ │ │ +00027280: 756e 6974 5d20 5b2d 2d70 6f72 743d 706f unit] [--port=po │ │ │ │ │ +00027290: 7274 5d20 5b2d 2d73 7065 6564 3d73 7065 rt] [--speed=spe │ │ │ │ │ +000272a0: 6564 5d0a 2020 2020 2020 2020 2020 5b2d ed]. [- │ │ │ │ │ +000272b0: 2d77 6f72 643d 776f 7264 5d20 5b2d 2d70 -word=word] [--p │ │ │ │ │ +000272c0: 6172 6974 793d 7061 7269 7479 5d20 5b2d arity=parity] [- │ │ │ │ │ +000272d0: 2d73 746f 703d 7374 6f70 5d0a 2020 2020 -stop=stop]. │ │ │ │ │ +000272e0: 2049 6e69 7469 616c 697a 6520 6120 7365 Initialize a se │ │ │ │ │ +000272f0: 7269 616c 2064 6576 6963 652e 2020 554e rial device. UN │ │ │ │ │ +00027300: 4954 2069 7320 6120 6e75 6d62 6572 2069 IT is a number i │ │ │ │ │ +00027310: 6e20 7468 6520 7261 6e67 6520 302d 330a n the range 0-3. │ │ │ │ │ +00027320: 2020 2020 2073 7065 6369 6679 696e 6720 specifying │ │ │ │ │ +00027330: 7768 6963 6820 7365 7269 616c 2070 6f72 which serial por │ │ │ │ │ +00027340: 7420 746f 2075 7365 3b20 6465 6661 756c t to use; defaul │ │ │ │ │ +00027350: 7420 6973 2030 2c20 7768 6963 680a 2020 t is 0, which. │ │ │ │ │ +00027360: 2020 2063 6f72 7265 7370 6f6e 6473 2074 corresponds t │ │ │ │ │ +00027370: 6f20 7468 6520 706f 7274 206f 6674 656e o the port often │ │ │ │ │ +00027380: 2063 616c 6c65 6420 434f 4d31 2e20 2050 called COM1. P │ │ │ │ │ +00027390: 4f52 5420 6973 2074 6865 2049 2f4f 2070 ORT is the I/O p │ │ │ │ │ +000273a0: 6f72 740a 2020 2020 2077 6865 7265 2074 ort. where t │ │ │ │ │ +000273b0: 6865 2055 4152 5420 6973 2074 6f20 6265 he UART is to be │ │ │ │ │ +000273c0: 2066 6f75 6e64 3b20 6966 2073 7065 6369 found; if speci │ │ │ │ │ +000273d0: 6669 6564 2069 7420 7461 6b65 7320 7072 fied it takes pr │ │ │ │ │ +000273e0: 6563 6564 656e 6365 0a20 2020 2020 6f76 ecedence. ov │ │ │ │ │ +000273f0: 6572 2055 4e49 542e 2020 5350 4545 4420 er UNIT. SPEED │ │ │ │ │ +00027400: 6973 2074 6865 2074 7261 6e73 6d69 7373 is the transmiss │ │ │ │ │ +00027410: 696f 6e20 7370 6565 643b 2064 6566 6175 ion speed; defau │ │ │ │ │ +00027420: 6c74 2069 7320 3936 3030 2e20 2057 4f52 lt is 9600. WOR │ │ │ │ │ +00027430: 440a 2020 2020 2061 6e64 2053 544f 5020 D. and STOP │ │ │ │ │ +00027440: 6172 6520 7468 6520 6e75 6d62 6572 206f are the number o │ │ │ │ │ +00027450: 6620 6461 7461 2062 6974 7320 616e 6420 f data bits and │ │ │ │ │ +00027460: 7374 6f70 2062 6974 732e 2020 4461 7461 stop bits. Data │ │ │ │ │ +00027470: 2062 6974 7320 6d75 7374 0a20 2020 2020 bits must. │ │ │ │ │ +00027480: 6265 2069 6e20 7468 6520 7261 6e67 6520 be in the range │ │ │ │ │ +00027490: 352d 3820 616e 6420 7374 6f70 2062 6974 5-8 and stop bit │ │ │ │ │ +000274a0: 7320 6d75 7374 2062 6520 3120 6f72 2032 s must be 1 or 2 │ │ │ │ │ +000274b0: 2e20 2044 6566 6175 6c74 2069 7320 380a . Default is 8. │ │ │ │ │ +000274c0: 2020 2020 2064 6174 6120 6269 7473 2061 data bits a │ │ │ │ │ +000274d0: 6e64 206f 6e65 2073 746f 7020 6269 742e nd one stop bit. │ │ │ │ │ +000274e0: 2020 5041 5249 5459 2069 7320 6f6e 6520 PARITY is one │ │ │ │ │ +000274f0: 6f66 2027 6e6f 272c 2027 6f64 6427 2c20 of 'no', 'odd', │ │ │ │ │ +00027500: 2765 7665 6e27 0a20 2020 2020 616e 6420 'even'. and │ │ │ │ │ +00027510: 6465 6661 756c 7473 2074 6f20 276e 6f27 defaults to 'no' │ │ │ │ │ +00027520: 2e0a 0a20 2020 2020 5468 6520 7365 7269 ... The seri │ │ │ │ │ +00027530: 616c 2070 6f72 7420 6973 206e 6f74 2075 al port is not u │ │ │ │ │ +00027540: 7365 6420 6173 2061 2063 6f6d 6d75 6e69 sed as a communi │ │ │ │ │ +00027550: 6361 7469 6f6e 2063 6861 6e6e 656c 2075 cation channel u │ │ │ │ │ +00027560: 6e6c 6573 7320 7468 650a 2020 2020 2027 nless the. ' │ │ │ │ │ +00027570: 7465 726d 696e 616c 5f69 6e70 7574 2720 terminal_input' │ │ │ │ │ +00027580: 6f72 2027 7465 726d 696e 616c 5f6f 7574 or 'terminal_out │ │ │ │ │ +00027590: 7075 7427 2063 6f6d 6d61 6e64 2069 7320 put' command is │ │ │ │ │ +000275a0: 7573 6564 2028 2a6e 6f74 650a 2020 2020 used (*note. │ │ │ │ │ +000275b0: 2074 6572 6d69 6e61 6c5f 696e 7075 743a terminal_input: │ │ │ │ │ +000275c0: 3a2c 202a 6e6f 7465 2074 6572 6d69 6e61 :, *note termina │ │ │ │ │ +000275d0: 6c5f 6f75 7470 7574 3a3a 292e 0a0a 2020 l_output::)... │ │ │ │ │ +000275e0: 2020 2053 6565 2061 6c73 6f20 2a6e 6f74 See also *not │ │ │ │ │ +000275f0: 6520 5365 7269 616c 2074 6572 6d69 6e61 e Serial termina │ │ │ │ │ +00027600: 6c3a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 l::.....File: gr │ │ │ │ │ +00027610: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00027620: 7465 726d 696e 616c 5f69 6e70 7574 2c20 terminal_input, │ │ │ │ │ +00027630: 204e 6578 743a 2074 6572 6d69 6e61 6c5f Next: terminal_ │ │ │ │ │ +00027640: 6f75 7470 7574 2c20 2050 7265 763a 2073 output, Prev: s │ │ │ │ │ +00027650: 6572 6961 6c2c 2020 5570 3a20 4765 6e65 erial, Up: Gene │ │ │ │ │ +00027660: 7261 6c20 636f 6d6d 616e 6473 0a0a 3136 ral commands..16 │ │ │ │ │ +00027670: 2e32 2e32 2074 6572 6d69 6e61 6c5f 696e .2.2 terminal_in │ │ │ │ │ +00027680: 7075 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d put.------------ │ │ │ │ │ +00027690: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ +000276a0: 6f6d 6d61 6e64 3a20 7465 726d 696e 616c ommand: terminal │ │ │ │ │ +000276b0: 5f69 6e70 7574 205b 2d2d 6170 7065 6e64 _input [--append │ │ │ │ │ +000276c0: 7c2d 2d72 656d 6f76 655d 205b 7465 726d |--remove] [term │ │ │ │ │ +000276d0: 696e 616c 315d 205b 7465 726d 696e 616c inal1] [terminal │ │ │ │ │ +000276e0: 325d 0a20 2020 2020 2020 2020 202e 2e2e 2]. ... │ │ │ │ │ +000276f0: 0a20 2020 2020 4c69 7374 206f 7220 7365 . List or se │ │ │ │ │ +00027700: 6c65 6374 2061 6e20 696e 7075 7420 7465 lect an input te │ │ │ │ │ +00027710: 726d 696e 616c 2e0a 0a20 2020 2020 5769 rminal... Wi │ │ │ │ │ +00027720: 7468 206e 6f20 6172 6775 6d65 6e74 732c th no arguments, │ │ │ │ │ +00027730: 206c 6973 7420 7468 6520 6163 7469 7665 list the active │ │ │ │ │ +00027740: 2061 6e64 2061 7661 696c 6162 6c65 2069 and available i │ │ │ │ │ +00027750: 6e70 7574 2074 6572 6d69 6e61 6c73 2e0a nput terminals.. │ │ │ │ │ +00027760: 0a20 2020 2020 5769 7468 2027 2d2d 6170 . With '--ap │ │ │ │ │ +00027770: 7065 6e64 272c 2061 6464 2074 6865 206e pend', add the n │ │ │ │ │ +00027780: 616d 6564 2074 6572 6d69 6e61 6c73 2074 amed terminals t │ │ │ │ │ +00027790: 6f20 7468 6520 6c69 7374 206f 6620 6163 o the list of ac │ │ │ │ │ +000277a0: 7469 7665 0a20 2020 2020 696e 7075 7420 tive. input │ │ │ │ │ +000277b0: 7465 726d 696e 616c 733b 2061 6e79 206f terminals; any o │ │ │ │ │ +000277c0: 6620 7468 6573 6520 6d61 7920 6265 2075 f these may be u │ │ │ │ │ +000277d0: 7365 6420 746f 2070 726f 7669 6465 2069 sed to provide i │ │ │ │ │ +000277e0: 6e70 7574 2074 6f20 4752 5542 2e0a 0a20 nput to GRUB... │ │ │ │ │ +000277f0: 2020 2020 5769 7468 2027 2d2d 7265 6d6f With '--remo │ │ │ │ │ +00027800: 7665 272c 2072 656d 6f76 6520 7468 6520 ve', remove the │ │ │ │ │ +00027810: 6e61 6d65 6420 7465 726d 696e 616c 7320 named terminals │ │ │ │ │ +00027820: 6672 6f6d 2074 6865 2061 6374 6976 6520 from the active │ │ │ │ │ +00027830: 6c69 7374 2e0a 0a20 2020 2020 5769 7468 list... With │ │ │ │ │ +00027840: 206e 6f20 6f70 7469 6f6e 7320 6275 7420 no options but │ │ │ │ │ +00027850: 6120 6c69 7374 206f 6620 7465 726d 696e a list of termin │ │ │ │ │ +00027860: 616c 206e 616d 6573 2c20 6d61 6b65 206f al names, make o │ │ │ │ │ +00027870: 6e6c 7920 7468 6520 6c69 7374 6564 0a20 nly the listed. │ │ │ │ │ +00027880: 2020 2020 7465 726d 696e 616c 206e 616d terminal nam │ │ │ │ │ +00027890: 6573 2061 6374 6976 652e 0a0a 1f0a 4669 es active.....Fi │ │ │ │ │ +000278a0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +000278b0: 4e6f 6465 3a20 7465 726d 696e 616c 5f6f Node: terminal_o │ │ │ │ │ +000278c0: 7574 7075 742c 2020 4e65 7874 3a20 7465 utput, Next: te │ │ │ │ │ +000278d0: 726d 696e 666f 2c20 2050 7265 763a 2074 rminfo, Prev: t │ │ │ │ │ +000278e0: 6572 6d69 6e61 6c5f 696e 7075 742c 2020 erminal_input, │ │ │ │ │ +000278f0: 5570 3a20 4765 6e65 7261 6c20 636f 6d6d Up: General comm │ │ │ │ │ +00027900: 616e 6473 0a0a 3136 2e32 2e33 2074 6572 ands..16.2.3 ter │ │ │ │ │ +00027910: 6d69 6e61 6c5f 6f75 7470 7574 0a2d 2d2d minal_output.--- │ │ │ │ │ 00027920: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00027930: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -00027940: 7465 726d 696e 616c 5f6f 7574 7075 7420 terminal_output │ │ │ │ │ -00027950: 5b2d 2d61 7070 656e 647c 2d2d 7265 6d6f [--append|--remo │ │ │ │ │ -00027960: 7665 5d20 5b74 6572 6d69 6e61 6c31 5d20 ve] [terminal1] │ │ │ │ │ -00027970: 5b74 6572 6d69 6e61 6c32 5d0a 2020 2020 [terminal2]. │ │ │ │ │ -00027980: 2020 2020 2020 2e2e 2e0a 2020 2020 204c .... L │ │ │ │ │ -00027990: 6973 7420 6f72 2073 656c 6563 7420 616e ist or select an │ │ │ │ │ -000279a0: 206f 7574 7075 7420 7465 726d 696e 616c output terminal │ │ │ │ │ -000279b0: 2e0a 0a20 2020 2020 5769 7468 206e 6f20 ... With no │ │ │ │ │ -000279c0: 6172 6775 6d65 6e74 732c 206c 6973 7420 arguments, list │ │ │ │ │ -000279d0: 7468 6520 6163 7469 7665 2061 6e64 2061 the active and a │ │ │ │ │ -000279e0: 7661 696c 6162 6c65 206f 7574 7075 7420 vailable output │ │ │ │ │ -000279f0: 7465 726d 696e 616c 732e 0a0a 2020 2020 terminals... │ │ │ │ │ -00027a00: 2057 6974 6820 272d 2d61 7070 656e 6427 With '--append' │ │ │ │ │ -00027a10: 2c20 6164 6420 7468 6520 6e61 6d65 6420 , add the named │ │ │ │ │ -00027a20: 7465 726d 696e 616c 7320 746f 2074 6865 terminals to the │ │ │ │ │ -00027a30: 206c 6973 7420 6f66 2061 6374 6976 650a list of active. │ │ │ │ │ -00027a40: 2020 2020 206f 7574 7075 7420 7465 726d output term │ │ │ │ │ -00027a50: 696e 616c 733b 2061 6c6c 206f 6620 7468 inals; all of th │ │ │ │ │ -00027a60: 6573 6520 7769 6c6c 2072 6563 6569 7665 ese will receive │ │ │ │ │ -00027a70: 206f 7574 7075 7420 6672 6f6d 2047 5255 output from GRU │ │ │ │ │ -00027a80: 422e 0a0a 2020 2020 2057 6974 6820 272d B... With '- │ │ │ │ │ -00027a90: 2d72 656d 6f76 6527 2c20 7265 6d6f 7665 -remove', remove │ │ │ │ │ -00027aa0: 2074 6865 206e 616d 6564 2074 6572 6d69 the named termi │ │ │ │ │ -00027ab0: 6e61 6c73 2066 726f 6d20 7468 6520 6163 nals from the ac │ │ │ │ │ -00027ac0: 7469 7665 206c 6973 742e 0a0a 2020 2020 tive list... │ │ │ │ │ -00027ad0: 2057 6974 6820 6e6f 206f 7074 696f 6e73 With no options │ │ │ │ │ -00027ae0: 2062 7574 2061 206c 6973 7420 6f66 2074 but a list of t │ │ │ │ │ -00027af0: 6572 6d69 6e61 6c20 6e61 6d65 732c 206d erminal names, m │ │ │ │ │ -00027b00: 616b 6520 6f6e 6c79 2074 6865 206c 6973 ake only the lis │ │ │ │ │ -00027b10: 7465 640a 2020 2020 2074 6572 6d69 6e61 ted. termina │ │ │ │ │ -00027b20: 6c20 6e61 6d65 7320 6163 7469 7665 2e0a l names active.. │ │ │ │ │ -00027b30: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00027b40: 666f 2c20 204e 6f64 653a 2074 6572 6d69 fo, Node: termi │ │ │ │ │ -00027b50: 6e66 6f2c 2020 5072 6576 3a20 7465 726d nfo, Prev: term │ │ │ │ │ -00027b60: 696e 616c 5f6f 7574 7075 742c 2020 5570 inal_output, Up │ │ │ │ │ -00027b70: 3a20 4765 6e65 7261 6c20 636f 6d6d 616e : General comman │ │ │ │ │ -00027b80: 6473 0a0a 3136 2e32 2e34 2074 6572 6d69 ds..16.2.4 termi │ │ │ │ │ -00027b90: 6e66 6f0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d nfo.------------ │ │ │ │ │ -00027ba0: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -00027bb0: 3a20 7465 726d 696e 666f 205b 2d61 7c2d : terminfo [-a|- │ │ │ │ │ -00027bc0: 757c 2d76 5d20 5b2d 6720 5778 485d 205b u|-v] [-g WxH] [ │ │ │ │ │ -00027bd0: 7465 726d 5d20 5b74 7970 655d 0a20 2020 term] [type]. │ │ │ │ │ -00027be0: 2020 4465 6669 6e65 2074 6865 2063 6170 Define the cap │ │ │ │ │ -00027bf0: 6162 696c 6974 6965 7320 6f66 2079 6f75 abilities of you │ │ │ │ │ -00027c00: 7220 7465 726d 696e 616c 2062 7920 6769 r terminal by gi │ │ │ │ │ -00027c10: 7669 6e67 2074 6865 206e 616d 6520 6f66 ving the name of │ │ │ │ │ -00027c20: 2061 6e0a 2020 2020 2065 6e74 7279 2069 an. entry i │ │ │ │ │ -00027c30: 6e20 7468 6520 7465 726d 696e 666f 2064 n the terminfo d │ │ │ │ │ -00027c40: 6174 6162 6173 652c 2077 6869 6368 2073 atabase, which s │ │ │ │ │ -00027c50: 686f 756c 6420 636f 7272 6573 706f 6e64 hould correspond │ │ │ │ │ -00027c60: 2072 6f75 6768 6c79 2074 6f0a 2020 2020 roughly to. │ │ │ │ │ -00027c70: 2061 2027 5445 524d 2720 656e 7669 726f a 'TERM' enviro │ │ │ │ │ -00027c80: 6e6d 656e 7420 7661 7269 6162 6c65 2069 nment variable i │ │ │ │ │ -00027c90: 6e20 556e 6978 2e0a 0a20 2020 2020 5468 n Unix... Th │ │ │ │ │ -00027ca0: 6520 6375 7272 656e 746c 7920 6176 6169 e currently avai │ │ │ │ │ -00027cb0: 6c61 626c 6520 7465 726d 696e 616c 2074 lable terminal t │ │ │ │ │ -00027cc0: 7970 6573 2061 7265 2027 7674 3130 3027 ypes are 'vt100' │ │ │ │ │ -00027cd0: 2c20 2776 7431 3030 2d63 6f6c 6f72 272c , 'vt100-color', │ │ │ │ │ -00027ce0: 0a20 2020 2020 2769 6565 6531 3237 3527 . 'ieee1275' │ │ │ │ │ -00027cf0: 2c20 616e 6420 2764 756d 6227 2e20 2049 , and 'dumb'. I │ │ │ │ │ -00027d00: 6620 796f 7520 6e65 6564 206f 7468 6572 f you need other │ │ │ │ │ -00027d10: 2074 6572 6d69 6e61 6c20 7479 7065 732c terminal types, │ │ │ │ │ -00027d20: 2070 6c65 6173 650a 2020 2020 2063 6f6e please. con │ │ │ │ │ -00027d30: 7461 6374 2075 7320 746f 2064 6973 6375 tact us to discu │ │ │ │ │ -00027d40: 7373 2074 6865 2062 6573 7420 7761 7920 ss the best way │ │ │ │ │ -00027d50: 746f 2069 6e63 6c75 6465 2073 7570 706f to include suppo │ │ │ │ │ -00027d60: 7274 2066 6f72 2074 6865 7365 2069 6e0a rt for these in. │ │ │ │ │ -00027d70: 2020 2020 2047 5255 422e 0a0a 2020 2020 GRUB... │ │ │ │ │ -00027d80: 2054 6865 2027 2d61 2720 2827 2d2d 6173 The '-a' ('--as │ │ │ │ │ -00027d90: 6369 6927 292c 2027 2d75 2720 2827 2d2d cii'), '-u' ('-- │ │ │ │ │ -00027da0: 7574 6638 2729 2c20 616e 6420 272d 7627 utf8'), and '-v' │ │ │ │ │ -00027db0: 2028 272d 2d76 6973 7561 6c2d 7574 6638 ('--visual-utf8 │ │ │ │ │ -00027dc0: 2729 0a20 2020 2020 6f70 7469 6f6e 7320 '). options │ │ │ │ │ -00027dd0: 636f 6e74 726f 6c20 686f 7720 6e6f 6e2d control how non- │ │ │ │ │ -00027de0: 4153 4349 4920 7465 7874 2069 7320 6469 ASCII text is di │ │ │ │ │ -00027df0: 7370 6c61 7965 642e 2020 272d 6127 2073 splayed. '-a' s │ │ │ │ │ -00027e00: 7065 6369 6669 6573 2061 6e0a 2020 2020 pecifies an. │ │ │ │ │ -00027e10: 2041 5343 4949 2d6f 6e6c 7920 7465 726d ASCII-only term │ │ │ │ │ -00027e20: 696e 616c 3b20 272d 7527 2073 7065 6369 inal; '-u' speci │ │ │ │ │ -00027e30: 6669 6573 206c 6f67 6963 616c 6c79 2d6f fies logically-o │ │ │ │ │ -00027e40: 7264 6572 6564 2055 5446 2d38 3b20 616e rdered UTF-8; an │ │ │ │ │ -00027e50: 640a 2020 2020 2027 2d76 2720 7370 6563 d. '-v' spec │ │ │ │ │ -00027e60: 6966 6965 7320 2276 6973 7561 6c6c 792d ifies "visually- │ │ │ │ │ -00027e70: 6f72 6465 7265 6420 5554 462d 3822 2028 ordered UTF-8" ( │ │ │ │ │ -00027e80: 696e 206f 7468 6572 2077 6f72 6473 2c20 in other words, │ │ │ │ │ -00027e90: 6172 7261 6e67 6564 0a20 2020 2020 7375 arranged. su │ │ │ │ │ -00027ea0: 6368 2074 6861 7420 6120 7465 726d 696e ch that a termin │ │ │ │ │ -00027eb0: 616c 2065 6d75 6c61 746f 7220 7769 7468 al emulator with │ │ │ │ │ -00027ec0: 6f75 7420 6269 6469 7265 6374 696f 6e61 out bidirectiona │ │ │ │ │ -00027ed0: 6c20 7465 7874 2073 7570 706f 7274 0a20 l text support. │ │ │ │ │ -00027ee0: 2020 2020 7769 6c6c 2064 6973 706c 6179 will display │ │ │ │ │ -00027ef0: 2072 6967 6874 2d74 6f2d 6c65 6674 2074 right-to-left t │ │ │ │ │ -00027f00: 6578 7420 696e 2074 6865 2070 726f 7065 ext in the prope │ │ │ │ │ -00027f10: 7220 6f72 6465 723b 2074 6869 7320 6973 r order; this is │ │ │ │ │ -00027f20: 206e 6f74 0a20 2020 2020 7265 616c 6c79 not. really │ │ │ │ │ -00027f30: 2070 726f 7065 7220 5554 462d 382c 2062 proper UTF-8, b │ │ │ │ │ -00027f40: 7574 2061 2077 6f72 6b61 726f 756e 6429 ut a workaround) │ │ │ │ │ -00027f50: 2e0a 0a20 2020 2020 5468 6520 272d 6727 ... The '-g' │ │ │ │ │ -00027f60: 2028 272d 2d67 656f 6d65 7472 7927 2920 ('--geometry') │ │ │ │ │ -00027f70: 6361 6e20 6265 2075 7365 6420 746f 2073 can be used to s │ │ │ │ │ -00027f80: 7065 6369 6679 2074 6572 6d69 6e61 6c20 pecify terminal │ │ │ │ │ -00027f90: 6765 6f6d 6574 7279 2e0a 0a20 2020 2020 geometry... │ │ │ │ │ -00027fa0: 4966 206e 6f20 6f70 7469 6f6e 206f 7220 If no option or │ │ │ │ │ -00027fb0: 7465 726d 696e 616c 2074 7970 6520 6973 terminal type is │ │ │ │ │ -00027fc0: 2073 7065 6369 6669 6564 2c20 7468 6520 specified, the │ │ │ │ │ -00027fd0: 6375 7272 656e 7420 7465 726d 696e 616c current terminal │ │ │ │ │ -00027fe0: 0a20 2020 2020 7479 7065 2069 7320 7072 . type is pr │ │ │ │ │ -00027ff0: 696e 7465 642e 0a0a 1f0a 4669 6c65 3a20 inted.....File: │ │ │ │ │ -00028000: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00028010: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00028020: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00028030: 6d6d 616e 6473 2c20 204e 6578 743a 204e mmands, Next: N │ │ │ │ │ -00028040: 6574 776f 726b 696e 6720 636f 6d6d 616e etworking comman │ │ │ │ │ -00028050: 6473 2c20 2050 7265 763a 2047 656e 6572 ds, Prev: Gener │ │ │ │ │ -00028060: 616c 2063 6f6d 6d61 6e64 732c 2020 5570 al commands, Up │ │ │ │ │ -00028070: 3a20 436f 6d6d 616e 6473 0a0a 3136 2e33 : Commands..16.3 │ │ │ │ │ -00028080: 2054 6865 206c 6973 7420 6f66 2063 6f6d The list of com │ │ │ │ │ -00028090: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ -000280a0: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ -000280b0: 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d s.============== │ │ │ │ │ +00027930: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ +00027940: 3a20 7465 726d 696e 616c 5f6f 7574 7075 : terminal_outpu │ │ │ │ │ +00027950: 7420 5b2d 2d61 7070 656e 647c 2d2d 7265 t [--append|--re │ │ │ │ │ +00027960: 6d6f 7665 5d20 5b74 6572 6d69 6e61 6c31 move] [terminal1 │ │ │ │ │ +00027970: 5d20 5b74 6572 6d69 6e61 6c32 5d0a 2020 ] [terminal2]. │ │ │ │ │ +00027980: 2020 2020 2020 2020 2e2e 2e0a 2020 2020 .... │ │ │ │ │ +00027990: 204c 6973 7420 6f72 2073 656c 6563 7420 List or select │ │ │ │ │ +000279a0: 616e 206f 7574 7075 7420 7465 726d 696e an output termin │ │ │ │ │ +000279b0: 616c 2e0a 0a20 2020 2020 5769 7468 206e al... With n │ │ │ │ │ +000279c0: 6f20 6172 6775 6d65 6e74 732c 206c 6973 o arguments, lis │ │ │ │ │ +000279d0: 7420 7468 6520 6163 7469 7665 2061 6e64 t the active and │ │ │ │ │ +000279e0: 2061 7661 696c 6162 6c65 206f 7574 7075 available outpu │ │ │ │ │ +000279f0: 7420 7465 726d 696e 616c 732e 0a0a 2020 t terminals... │ │ │ │ │ +00027a00: 2020 2057 6974 6820 272d 2d61 7070 656e With '--appen │ │ │ │ │ +00027a10: 6427 2c20 6164 6420 7468 6520 6e61 6d65 d', add the name │ │ │ │ │ +00027a20: 6420 7465 726d 696e 616c 7320 746f 2074 d terminals to t │ │ │ │ │ +00027a30: 6865 206c 6973 7420 6f66 2061 6374 6976 he list of activ │ │ │ │ │ +00027a40: 650a 2020 2020 206f 7574 7075 7420 7465 e. output te │ │ │ │ │ +00027a50: 726d 696e 616c 733b 2061 6c6c 206f 6620 rminals; all of │ │ │ │ │ +00027a60: 7468 6573 6520 7769 6c6c 2072 6563 6569 these will recei │ │ │ │ │ +00027a70: 7665 206f 7574 7075 7420 6672 6f6d 2047 ve output from G │ │ │ │ │ +00027a80: 5255 422e 0a0a 2020 2020 2057 6974 6820 RUB... With │ │ │ │ │ +00027a90: 272d 2d72 656d 6f76 6527 2c20 7265 6d6f '--remove', remo │ │ │ │ │ +00027aa0: 7665 2074 6865 206e 616d 6564 2074 6572 ve the named ter │ │ │ │ │ +00027ab0: 6d69 6e61 6c73 2066 726f 6d20 7468 6520 minals from the │ │ │ │ │ +00027ac0: 6163 7469 7665 206c 6973 742e 0a0a 2020 active list... │ │ │ │ │ +00027ad0: 2020 2057 6974 6820 6e6f 206f 7074 696f With no optio │ │ │ │ │ +00027ae0: 6e73 2062 7574 2061 206c 6973 7420 6f66 ns but a list of │ │ │ │ │ +00027af0: 2074 6572 6d69 6e61 6c20 6e61 6d65 732c terminal names, │ │ │ │ │ +00027b00: 206d 616b 6520 6f6e 6c79 2074 6865 206c make only the l │ │ │ │ │ +00027b10: 6973 7465 640a 2020 2020 2074 6572 6d69 isted. termi │ │ │ │ │ +00027b20: 6e61 6c20 6e61 6d65 7320 6163 7469 7665 nal names active │ │ │ │ │ +00027b30: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00027b40: 696e 666f 2c20 204e 6f64 653a 2074 6572 info, Node: ter │ │ │ │ │ +00027b50: 6d69 6e66 6f2c 2020 5072 6576 3a20 7465 minfo, Prev: te │ │ │ │ │ +00027b60: 726d 696e 616c 5f6f 7574 7075 742c 2020 rminal_output, │ │ │ │ │ +00027b70: 5570 3a20 4765 6e65 7261 6c20 636f 6d6d Up: General comm │ │ │ │ │ +00027b80: 616e 6473 0a0a 3136 2e32 2e34 2074 6572 ands..16.2.4 ter │ │ │ │ │ +00027b90: 6d69 6e66 6f0a 2d2d 2d2d 2d2d 2d2d 2d2d minfo.---------- │ │ │ │ │ +00027ba0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +00027bb0: 6e64 3a20 7465 726d 696e 666f 205b 2d61 nd: terminfo [-a │ │ │ │ │ +00027bc0: 7c2d 757c 2d76 5d20 5b2d 6720 5778 485d |-u|-v] [-g WxH] │ │ │ │ │ +00027bd0: 205b 7465 726d 5d20 5b74 7970 655d 0a20 [term] [type]. │ │ │ │ │ +00027be0: 2020 2020 4465 6669 6e65 2074 6865 2063 Define the c │ │ │ │ │ +00027bf0: 6170 6162 696c 6974 6965 7320 6f66 2079 apabilities of y │ │ │ │ │ +00027c00: 6f75 7220 7465 726d 696e 616c 2062 7920 our terminal by │ │ │ │ │ +00027c10: 6769 7669 6e67 2074 6865 206e 616d 6520 giving the name │ │ │ │ │ +00027c20: 6f66 2061 6e0a 2020 2020 2065 6e74 7279 of an. entry │ │ │ │ │ +00027c30: 2069 6e20 7468 6520 7465 726d 696e 666f in the terminfo │ │ │ │ │ +00027c40: 2064 6174 6162 6173 652c 2077 6869 6368 database, which │ │ │ │ │ +00027c50: 2073 686f 756c 6420 636f 7272 6573 706f should correspo │ │ │ │ │ +00027c60: 6e64 2072 6f75 6768 6c79 2074 6f0a 2020 nd roughly to. │ │ │ │ │ +00027c70: 2020 2061 2027 5445 524d 2720 656e 7669 a 'TERM' envi │ │ │ │ │ +00027c80: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ +00027c90: 2069 6e20 556e 6978 2e0a 0a20 2020 2020 in Unix... │ │ │ │ │ +00027ca0: 5468 6520 6375 7272 656e 746c 7920 6176 The currently av │ │ │ │ │ +00027cb0: 6169 6c61 626c 6520 7465 726d 696e 616c ailable terminal │ │ │ │ │ +00027cc0: 2074 7970 6573 2061 7265 2027 7674 3130 types are 'vt10 │ │ │ │ │ +00027cd0: 3027 2c20 2776 7431 3030 2d63 6f6c 6f72 0', 'vt100-color │ │ │ │ │ +00027ce0: 272c 0a20 2020 2020 2769 6565 6531 3237 ',. 'ieee127 │ │ │ │ │ +00027cf0: 3527 2c20 616e 6420 2764 756d 6227 2e20 5', and 'dumb'. │ │ │ │ │ +00027d00: 2049 6620 796f 7520 6e65 6564 206f 7468 If you need oth │ │ │ │ │ +00027d10: 6572 2074 6572 6d69 6e61 6c20 7479 7065 er terminal type │ │ │ │ │ +00027d20: 732c 2070 6c65 6173 650a 2020 2020 2063 s, please. c │ │ │ │ │ +00027d30: 6f6e 7461 6374 2075 7320 746f 2064 6973 ontact us to dis │ │ │ │ │ +00027d40: 6375 7373 2074 6865 2062 6573 7420 7761 cuss the best wa │ │ │ │ │ +00027d50: 7920 746f 2069 6e63 6c75 6465 2073 7570 y to include sup │ │ │ │ │ +00027d60: 706f 7274 2066 6f72 2074 6865 7365 2069 port for these i │ │ │ │ │ +00027d70: 6e0a 2020 2020 2047 5255 422e 0a0a 2020 n. GRUB... │ │ │ │ │ +00027d80: 2020 2054 6865 2027 2d61 2720 2827 2d2d The '-a' ('-- │ │ │ │ │ +00027d90: 6173 6369 6927 292c 2027 2d75 2720 2827 ascii'), '-u' (' │ │ │ │ │ +00027da0: 2d2d 7574 6638 2729 2c20 616e 6420 272d --utf8'), and '- │ │ │ │ │ +00027db0: 7627 2028 272d 2d76 6973 7561 6c2d 7574 v' ('--visual-ut │ │ │ │ │ +00027dc0: 6638 2729 0a20 2020 2020 6f70 7469 6f6e f8'). option │ │ │ │ │ +00027dd0: 7320 636f 6e74 726f 6c20 686f 7720 6e6f s control how no │ │ │ │ │ +00027de0: 6e2d 4153 4349 4920 7465 7874 2069 7320 n-ASCII text is │ │ │ │ │ +00027df0: 6469 7370 6c61 7965 642e 2020 272d 6127 displayed. '-a' │ │ │ │ │ +00027e00: 2073 7065 6369 6669 6573 2061 6e0a 2020 specifies an. │ │ │ │ │ +00027e10: 2020 2041 5343 4949 2d6f 6e6c 7920 7465 ASCII-only te │ │ │ │ │ +00027e20: 726d 696e 616c 3b20 272d 7527 2073 7065 rminal; '-u' spe │ │ │ │ │ +00027e30: 6369 6669 6573 206c 6f67 6963 616c 6c79 cifies logically │ │ │ │ │ +00027e40: 2d6f 7264 6572 6564 2055 5446 2d38 3b20 -ordered UTF-8; │ │ │ │ │ +00027e50: 616e 640a 2020 2020 2027 2d76 2720 7370 and. '-v' sp │ │ │ │ │ +00027e60: 6563 6966 6965 7320 2276 6973 7561 6c6c ecifies "visuall │ │ │ │ │ +00027e70: 792d 6f72 6465 7265 6420 5554 462d 3822 y-ordered UTF-8" │ │ │ │ │ +00027e80: 2028 696e 206f 7468 6572 2077 6f72 6473 (in other words │ │ │ │ │ +00027e90: 2c20 6172 7261 6e67 6564 0a20 2020 2020 , arranged. │ │ │ │ │ +00027ea0: 7375 6368 2074 6861 7420 6120 7465 726d such that a term │ │ │ │ │ +00027eb0: 696e 616c 2065 6d75 6c61 746f 7220 7769 inal emulator wi │ │ │ │ │ +00027ec0: 7468 6f75 7420 6269 6469 7265 6374 696f thout bidirectio │ │ │ │ │ +00027ed0: 6e61 6c20 7465 7874 2073 7570 706f 7274 nal text support │ │ │ │ │ +00027ee0: 0a20 2020 2020 7769 6c6c 2064 6973 706c . will displ │ │ │ │ │ +00027ef0: 6179 2072 6967 6874 2d74 6f2d 6c65 6674 ay right-to-left │ │ │ │ │ +00027f00: 2074 6578 7420 696e 2074 6865 2070 726f text in the pro │ │ │ │ │ +00027f10: 7065 7220 6f72 6465 723b 2074 6869 7320 per order; this │ │ │ │ │ +00027f20: 6973 206e 6f74 0a20 2020 2020 7265 616c is not. real │ │ │ │ │ +00027f30: 6c79 2070 726f 7065 7220 5554 462d 382c ly proper UTF-8, │ │ │ │ │ +00027f40: 2062 7574 2061 2077 6f72 6b61 726f 756e but a workaroun │ │ │ │ │ +00027f50: 6429 2e0a 0a20 2020 2020 5468 6520 272d d)... The '- │ │ │ │ │ +00027f60: 6727 2028 272d 2d67 656f 6d65 7472 7927 g' ('--geometry' │ │ │ │ │ +00027f70: 2920 6361 6e20 6265 2075 7365 6420 746f ) can be used to │ │ │ │ │ +00027f80: 2073 7065 6369 6679 2074 6572 6d69 6e61 specify termina │ │ │ │ │ +00027f90: 6c20 6765 6f6d 6574 7279 2e0a 0a20 2020 l geometry... │ │ │ │ │ +00027fa0: 2020 4966 206e 6f20 6f70 7469 6f6e 206f If no option o │ │ │ │ │ +00027fb0: 7220 7465 726d 696e 616c 2074 7970 6520 r terminal type │ │ │ │ │ +00027fc0: 6973 2073 7065 6369 6669 6564 2c20 7468 is specified, th │ │ │ │ │ +00027fd0: 6520 6375 7272 656e 7420 7465 726d 696e e current termin │ │ │ │ │ +00027fe0: 616c 0a20 2020 2020 7479 7065 2069 7320 al. type is │ │ │ │ │ +00027ff0: 7072 696e 7465 642e 0a0a 1f0a 4669 6c65 printed.....File │ │ │ │ │ +00028000: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00028010: 6465 3a20 436f 6d6d 616e 642d 6c69 6e65 de: Command-line │ │ │ │ │ +00028020: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +00028030: 636f 6d6d 616e 6473 2c20 204e 6578 743a commands, Next: │ │ │ │ │ +00028040: 204e 6574 776f 726b 696e 6720 636f 6d6d Networking comm │ │ │ │ │ +00028050: 616e 6473 2c20 2050 7265 763a 2047 656e ands, Prev: Gen │ │ │ │ │ +00028060: 6572 616c 2063 6f6d 6d61 6e64 732c 2020 eral commands, │ │ │ │ │ +00028070: 5570 3a20 436f 6d6d 616e 6473 0a0a 3136 Up: Commands..16 │ │ │ │ │ +00028080: 2e33 2054 6865 206c 6973 7420 6f66 2063 .3 The list of c │ │ │ │ │ +00028090: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +000280a0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +000280b0: 6e64 730a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d nds.============ │ │ │ │ │ 000280c0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 000280d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -000280e0: 3d3d 3d3d 3d3d 3d0a 0a54 6865 7365 2063 =======..These c │ │ │ │ │ -000280f0: 6f6d 6d61 6e64 7320 6172 6520 7573 6162 ommands are usab │ │ │ │ │ -00028100: 6c65 2069 6e20 7468 6520 636f 6d6d 616e le in the comman │ │ │ │ │ -00028110: 642d 6c69 6e65 2061 6e64 2069 6e20 6d65 d-line and in me │ │ │ │ │ -00028120: 6e75 2065 6e74 7269 6573 2e20 2049 660a nu entries. If. │ │ │ │ │ -00028130: 796f 7520 666f 7267 6574 2061 2063 6f6d you forget a com │ │ │ │ │ -00028140: 6d61 6e64 2c20 796f 7520 6361 6e20 7275 mand, you can ru │ │ │ │ │ -00028150: 6e20 7468 6520 636f 6d6d 616e 6420 2768 n the command 'h │ │ │ │ │ -00028160: 656c 7027 2028 2a6e 6f74 6520 6865 6c70 elp' (*note help │ │ │ │ │ -00028170: 3a3a 292e 0a0a 2a20 4d65 6e75 3a0a 0a2a ::)...* Menu:..* │ │ │ │ │ -00028180: 205b 3a3a 2020 2020 2020 2020 2020 2020 [:: │ │ │ │ │ -00028190: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ │ -000281a0: 6865 636b 2066 696c 6520 7479 7065 7320 heck file types │ │ │ │ │ -000281b0: 616e 6420 636f 6d70 6172 6520 7661 6c75 and compare valu │ │ │ │ │ -000281c0: 6573 0a2a 2061 6370 693a 3a20 2020 2020 es.* acpi:: │ │ │ │ │ +000280e0: 3d3d 3d3d 3d3d 3d3d 3d0a 0a54 6865 7365 =========..These │ │ │ │ │ +000280f0: 2063 6f6d 6d61 6e64 7320 6172 6520 7573 commands are us │ │ │ │ │ +00028100: 6162 6c65 2069 6e20 7468 6520 636f 6d6d able in the comm │ │ │ │ │ +00028110: 616e 642d 6c69 6e65 2061 6e64 2069 6e20 and-line and in │ │ │ │ │ +00028120: 6d65 6e75 2065 6e74 7269 6573 2e20 2049 menu entries. I │ │ │ │ │ +00028130: 660a 796f 7520 666f 7267 6574 2061 2063 f.you forget a c │ │ │ │ │ +00028140: 6f6d 6d61 6e64 2c20 796f 7520 6361 6e20 ommand, you can │ │ │ │ │ +00028150: 7275 6e20 7468 6520 636f 6d6d 616e 6420 run the command │ │ │ │ │ +00028160: 2768 656c 7027 2028 2a6e 6f74 6520 6865 'help' (*note he │ │ │ │ │ +00028170: 6c70 3a3a 292e 0a0a 2a20 4d65 6e75 3a0a lp::)...* Menu:. │ │ │ │ │ +00028180: 0a2a 205b 3a3a 2020 2020 2020 2020 2020 .* [:: │ │ │ │ │ +00028190: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000281a0: 2043 6865 636b 2066 696c 6520 7479 7065 Check file type │ │ │ │ │ +000281b0: 7320 616e 6420 636f 6d70 6172 6520 7661 s and compare va │ │ │ │ │ +000281c0: 6c75 6573 0a2a 2061 6370 693a 3a20 2020 lues.* acpi:: │ │ │ │ │ 000281d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000281e0: 2020 204c 6f61 6420 4143 5049 2074 6162 Load ACPI tab │ │ │ │ │ -000281f0: 6c65 730a 2a20 6175 7468 656e 7469 6361 les.* authentica │ │ │ │ │ -00028200: 7465 3a3a 2020 2020 2020 2020 2020 2020 te:: │ │ │ │ │ -00028210: 2020 2020 4368 6563 6b20 7768 6574 6865 Check whethe │ │ │ │ │ -00028220: 7220 7573 6572 2069 7320 696e 2075 7365 r user is in use │ │ │ │ │ -00028230: 7220 6c69 7374 0a2a 2062 6163 6b67 726f r list.* backgro │ │ │ │ │ -00028240: 756e 645f 636f 6c6f 723a 3a20 2020 2020 und_color:: │ │ │ │ │ -00028250: 2020 2020 2020 2053 6574 2062 6163 6b67 Set backg │ │ │ │ │ -00028260: 726f 756e 6420 636f 6c6f 7220 666f 7220 round color for │ │ │ │ │ -00028270: 6163 7469 7665 2074 6572 6d69 6e61 6c0a active terminal. │ │ │ │ │ -00028280: 2a20 6261 636b 6772 6f75 6e64 5f69 6d61 * background_ima │ │ │ │ │ -00028290: 6765 3a3a 2020 2020 2020 2020 2020 2020 ge:: │ │ │ │ │ -000282a0: 4c6f 6164 2062 6163 6b67 726f 756e 6420 Load background │ │ │ │ │ -000282b0: 696d 6167 6520 666f 7220 6163 7469 7665 image for active │ │ │ │ │ -000282c0: 2074 6572 6d69 6e61 6c0a 2a20 6261 6472 terminal.* badr │ │ │ │ │ -000282d0: 616d 3a3a 2020 2020 2020 2020 2020 2020 am:: │ │ │ │ │ -000282e0: 2020 2020 2020 2020 2020 4669 6c74 6572 Filter │ │ │ │ │ -000282f0: 206f 7574 2062 6164 2072 6567 696f 6e73 out bad regions │ │ │ │ │ -00028300: 206f 6620 5241 4d0a 2a20 626c 6f63 6b6c of RAM.* blockl │ │ │ │ │ -00028310: 6973 743a 3a20 2020 2020 2020 2020 2020 ist:: │ │ │ │ │ -00028320: 2020 2020 2020 2020 5072 696e 7420 6120 Print a │ │ │ │ │ -00028330: 626c 6f63 6b20 6c69 7374 0a2a 2062 6f6f block list.* boo │ │ │ │ │ -00028340: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ -00028350: 2020 2020 2020 2020 2020 2053 7461 7274 Start │ │ │ │ │ -00028360: 2075 7020 796f 7572 206f 7065 7261 7469 up your operati │ │ │ │ │ -00028370: 6e67 2073 7973 7465 6d0a 2a20 6361 743a ng system.* cat: │ │ │ │ │ -00028380: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00028390: 2020 2020 2020 2020 2020 5368 6f77 2074 Show t │ │ │ │ │ -000283a0: 6865 2063 6f6e 7465 6e74 7320 6f66 2061 he contents of a │ │ │ │ │ -000283b0: 2066 696c 650a 2a20 6368 6169 6e6c 6f61 file.* chainloa │ │ │ │ │ -000283c0: 6465 723a 3a20 2020 2020 2020 2020 2020 der:: │ │ │ │ │ -000283d0: 2020 2020 2020 4368 6169 6e2d 6c6f 6164 Chain-load │ │ │ │ │ -000283e0: 2061 6e6f 7468 6572 2062 6f6f 7420 6c6f another boot lo │ │ │ │ │ -000283f0: 6164 6572 0a2a 2063 6c65 6172 3a3a 2020 ader.* clear:: │ │ │ │ │ +000281e0: 2020 2020 204c 6f61 6420 4143 5049 2074 Load ACPI t │ │ │ │ │ +000281f0: 6162 6c65 730a 2a20 6175 7468 656e 7469 ables.* authenti │ │ │ │ │ +00028200: 6361 7465 3a3a 2020 2020 2020 2020 2020 cate:: │ │ │ │ │ +00028210: 2020 2020 2020 4368 6563 6b20 7768 6574 Check whet │ │ │ │ │ +00028220: 6865 7220 7573 6572 2069 7320 696e 2075 her user is in u │ │ │ │ │ +00028230: 7365 7220 6c69 7374 0a2a 2062 6163 6b67 ser list.* backg │ │ │ │ │ +00028240: 726f 756e 645f 636f 6c6f 723a 3a20 2020 round_color:: │ │ │ │ │ +00028250: 2020 2020 2020 2020 2053 6574 2062 6163 Set bac │ │ │ │ │ +00028260: 6b67 726f 756e 6420 636f 6c6f 7220 666f kground color fo │ │ │ │ │ +00028270: 7220 6163 7469 7665 2074 6572 6d69 6e61 r active termina │ │ │ │ │ +00028280: 6c0a 2a20 6261 636b 6772 6f75 6e64 5f69 l.* background_i │ │ │ │ │ +00028290: 6d61 6765 3a3a 2020 2020 2020 2020 2020 mage:: │ │ │ │ │ +000282a0: 2020 4c6f 6164 2062 6163 6b67 726f 756e Load backgroun │ │ │ │ │ +000282b0: 6420 696d 6167 6520 666f 7220 6163 7469 d image for acti │ │ │ │ │ +000282c0: 7665 2074 6572 6d69 6e61 6c0a 2a20 6261 ve terminal.* ba │ │ │ │ │ +000282d0: 6472 616d 3a3a 2020 2020 2020 2020 2020 dram:: │ │ │ │ │ +000282e0: 2020 2020 2020 2020 2020 2020 4669 6c74 Filt │ │ │ │ │ +000282f0: 6572 206f 7574 2062 6164 2072 6567 696f er out bad regio │ │ │ │ │ +00028300: 6e73 206f 6620 5241 4d0a 2a20 626c 6f63 ns of RAM.* bloc │ │ │ │ │ +00028310: 6b6c 6973 743a 3a20 2020 2020 2020 2020 klist:: │ │ │ │ │ +00028320: 2020 2020 2020 2020 2020 5072 696e 7420 Print │ │ │ │ │ +00028330: 6120 626c 6f63 6b20 6c69 7374 0a2a 2062 a block list.* b │ │ │ │ │ +00028340: 6f6f 743a 3a20 2020 2020 2020 2020 2020 oot:: │ │ │ │ │ +00028350: 2020 2020 2020 2020 2020 2020 2053 7461 Sta │ │ │ │ │ +00028360: 7274 2075 7020 796f 7572 206f 7065 7261 rt up your opera │ │ │ │ │ +00028370: 7469 6e67 2073 7973 7465 6d0a 2a20 6361 ting system.* ca │ │ │ │ │ +00028380: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ +00028390: 2020 2020 2020 2020 2020 2020 5368 6f77 Show │ │ │ │ │ +000283a0: 2074 6865 2063 6f6e 7465 6e74 7320 6f66 the contents of │ │ │ │ │ +000283b0: 2061 2066 696c 650a 2a20 6368 6169 6e6c a file.* chainl │ │ │ │ │ +000283c0: 6f61 6465 723a 3a20 2020 2020 2020 2020 oader:: │ │ │ │ │ +000283d0: 2020 2020 2020 2020 4368 6169 6e2d 6c6f Chain-lo │ │ │ │ │ +000283e0: 6164 2061 6e6f 7468 6572 2062 6f6f 7420 ad another boot │ │ │ │ │ +000283f0: 6c6f 6164 6572 0a2a 2063 6c65 6172 3a3a loader.* clear:: │ │ │ │ │ 00028400: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028410: 2020 2020 2043 6c65 6172 2074 6865 2073 Clear the s │ │ │ │ │ -00028420: 6372 6565 6e0a 2a20 636d 6f73 636c 6561 creen.* cmosclea │ │ │ │ │ -00028430: 6e3a 3a20 2020 2020 2020 2020 2020 2020 n:: │ │ │ │ │ -00028440: 2020 2020 2020 436c 6561 7220 6269 7420 Clear bit │ │ │ │ │ -00028450: 696e 2043 4d4f 530a 2a20 636d 6f73 6475 in CMOS.* cmosdu │ │ │ │ │ -00028460: 6d70 3a3a 2020 2020 2020 2020 2020 2020 mp:: │ │ │ │ │ -00028470: 2020 2020 2020 2020 4475 6d70 2043 4d4f Dump CMO │ │ │ │ │ -00028480: 5320 636f 6e74 656e 7473 0a2a 2063 6d6f S contents.* cmo │ │ │ │ │ -00028490: 7374 6573 743a 3a20 2020 2020 2020 2020 stest:: │ │ │ │ │ -000284a0: 2020 2020 2020 2020 2020 2054 6573 7420 Test │ │ │ │ │ -000284b0: 6269 7420 696e 2043 4d4f 530a 2a20 636d bit in CMOS.* cm │ │ │ │ │ -000284c0: 703a 3a20 2020 2020 2020 2020 2020 2020 p:: │ │ │ │ │ -000284d0: 2020 2020 2020 2020 2020 2020 436f 6d70 Comp │ │ │ │ │ -000284e0: 6172 6520 7477 6f20 6669 6c65 730a 2a20 are two files.* │ │ │ │ │ -000284f0: 636f 6e66 6967 6669 6c65 3a3a 2020 2020 configfile:: │ │ │ │ │ -00028500: 2020 2020 2020 2020 2020 2020 2020 4c6f Lo │ │ │ │ │ -00028510: 6164 2061 2063 6f6e 6669 6775 7261 7469 ad a configurati │ │ │ │ │ -00028520: 6f6e 2066 696c 650a 2a20 6370 7569 643a on file.* cpuid: │ │ │ │ │ -00028530: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00028540: 2020 2020 2020 2020 4368 6563 6b20 666f Check fo │ │ │ │ │ -00028550: 7220 4350 5520 6665 6174 7572 6573 0a2a r CPU features.* │ │ │ │ │ -00028560: 2063 7263 3a3a 2020 2020 2020 2020 2020 crc:: │ │ │ │ │ -00028570: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ │ -00028580: 6f6d 7075 7465 206f 7220 6368 6563 6b20 ompute or check │ │ │ │ │ -00028590: 4352 4333 3220 6368 6563 6b73 756d 730a CRC32 checksums. │ │ │ │ │ -000285a0: 2a20 6372 7970 746f 6d6f 756e 743a 3a20 * cryptomount:: │ │ │ │ │ -000285b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000285c0: 4d6f 756e 7420 6120 6372 7970 746f 2064 Mount a crypto d │ │ │ │ │ -000285d0: 6576 6963 650a 2a20 6375 746d 656d 3a3a evice.* cutmem:: │ │ │ │ │ -000285e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000285f0: 2020 2020 2020 5265 6d6f 7665 206d 656d Remove mem │ │ │ │ │ -00028600: 6f72 7920 7265 6769 6f6e 730a 2a20 6461 ory regions.* da │ │ │ │ │ -00028610: 7465 3a3a 2020 2020 2020 2020 2020 2020 te:: │ │ │ │ │ -00028620: 2020 2020 2020 2020 2020 2020 4469 7370 Disp │ │ │ │ │ -00028630: 6c61 7920 6f72 2073 6574 2063 7572 7265 lay or set curre │ │ │ │ │ -00028640: 6e74 2064 6174 6520 616e 6420 7469 6d65 nt date and time │ │ │ │ │ -00028650: 0a2a 2064 6576 6963 6574 7265 653a 3a20 .* devicetree:: │ │ │ │ │ -00028660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028670: 204c 6f61 6420 6120 6465 7669 6365 2074 Load a device t │ │ │ │ │ -00028680: 7265 6520 626c 6f62 0a2a 2064 6973 7472 ree blob.* distr │ │ │ │ │ -00028690: 7573 743a 3a20 2020 2020 2020 2020 2020 ust:: │ │ │ │ │ -000286a0: 2020 2020 2020 2020 2052 656d 6f76 6520 Remove │ │ │ │ │ -000286b0: 6120 7075 626b 6579 2066 726f 6d20 7472 a pubkey from tr │ │ │ │ │ -000286c0: 7573 7465 6420 6b65 7973 0a2a 2064 7269 usted keys.* dri │ │ │ │ │ -000286d0: 7665 6d61 703a 3a20 2020 2020 2020 2020 vemap:: │ │ │ │ │ -000286e0: 2020 2020 2020 2020 2020 204d 6170 2061 Map a │ │ │ │ │ -000286f0: 2064 7269 7665 2074 6f20 616e 6f74 6865 drive to anothe │ │ │ │ │ -00028700: 720a 2a20 6563 686f 3a3a 2020 2020 2020 r.* echo:: │ │ │ │ │ +00028410: 2020 2020 2020 2043 6c65 6172 2074 6865 Clear the │ │ │ │ │ +00028420: 2073 6372 6565 6e0a 2a20 636d 6f73 636c screen.* cmoscl │ │ │ │ │ +00028430: 6561 6e3a 3a20 2020 2020 2020 2020 2020 ean:: │ │ │ │ │ +00028440: 2020 2020 2020 2020 436c 6561 7220 6269 Clear bi │ │ │ │ │ +00028450: 7420 696e 2043 4d4f 530a 2a20 636d 6f73 t in CMOS.* cmos │ │ │ │ │ +00028460: 6475 6d70 3a3a 2020 2020 2020 2020 2020 dump:: │ │ │ │ │ +00028470: 2020 2020 2020 2020 2020 4475 6d70 2043 Dump C │ │ │ │ │ +00028480: 4d4f 5320 636f 6e74 656e 7473 0a2a 2063 MOS contents.* c │ │ │ │ │ +00028490: 6d6f 7374 6573 743a 3a20 2020 2020 2020 mostest:: │ │ │ │ │ +000284a0: 2020 2020 2020 2020 2020 2020 2054 6573 Tes │ │ │ │ │ +000284b0: 7420 6269 7420 696e 2043 4d4f 530a 2a20 t bit in CMOS.* │ │ │ │ │ +000284c0: 636d 703a 3a20 2020 2020 2020 2020 2020 cmp:: │ │ │ │ │ +000284d0: 2020 2020 2020 2020 2020 2020 2020 436f Co │ │ │ │ │ +000284e0: 6d70 6172 6520 7477 6f20 6669 6c65 730a mpare two files. │ │ │ │ │ +000284f0: 2a20 636f 6e66 6967 6669 6c65 3a3a 2020 * configfile:: │ │ │ │ │ +00028500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00028510: 4c6f 6164 2061 2063 6f6e 6669 6775 7261 Load a configura │ │ │ │ │ +00028520: 7469 6f6e 2066 696c 650a 2a20 6370 7569 tion file.* cpui │ │ │ │ │ +00028530: 643a 3a20 2020 2020 2020 2020 2020 2020 d:: │ │ │ │ │ +00028540: 2020 2020 2020 2020 2020 4368 6563 6b20 Check │ │ │ │ │ +00028550: 666f 7220 4350 5520 6665 6174 7572 6573 for CPU features │ │ │ │ │ +00028560: 0a2a 2063 7263 3a3a 2020 2020 2020 2020 .* crc:: │ │ │ │ │ +00028570: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00028580: 2043 6f6d 7075 7465 206f 7220 6368 6563 Compute or chec │ │ │ │ │ +00028590: 6b20 4352 4333 3220 6368 6563 6b73 756d k CRC32 checksum │ │ │ │ │ +000285a0: 730a 2a20 6372 7970 746f 6d6f 756e 743a s.* cryptomount: │ │ │ │ │ +000285b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000285c0: 2020 4d6f 756e 7420 6120 6372 7970 746f Mount a crypto │ │ │ │ │ +000285d0: 2064 6576 6963 650a 2a20 6375 746d 656d device.* cutmem │ │ │ │ │ +000285e0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +000285f0: 2020 2020 2020 2020 5265 6d6f 7665 206d Remove m │ │ │ │ │ +00028600: 656d 6f72 7920 7265 6769 6f6e 730a 2a20 emory regions.* │ │ │ │ │ +00028610: 6461 7465 3a3a 2020 2020 2020 2020 2020 date:: │ │ │ │ │ +00028620: 2020 2020 2020 2020 2020 2020 2020 4469 Di │ │ │ │ │ +00028630: 7370 6c61 7920 6f72 2073 6574 2063 7572 splay or set cur │ │ │ │ │ +00028640: 7265 6e74 2064 6174 6520 616e 6420 7469 rent date and ti │ │ │ │ │ +00028650: 6d65 0a2a 2064 6576 6963 6574 7265 653a me.* devicetree: │ │ │ │ │ +00028660: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00028670: 2020 204c 6f61 6420 6120 6465 7669 6365 Load a device │ │ │ │ │ +00028680: 2074 7265 6520 626c 6f62 0a2a 2064 6973 tree blob.* dis │ │ │ │ │ +00028690: 7472 7573 743a 3a20 2020 2020 2020 2020 trust:: │ │ │ │ │ +000286a0: 2020 2020 2020 2020 2020 2052 656d 6f76 Remov │ │ │ │ │ +000286b0: 6520 6120 7075 626b 6579 2066 726f 6d20 e a pubkey from │ │ │ │ │ +000286c0: 7472 7573 7465 6420 6b65 7973 0a2a 2064 trusted keys.* d │ │ │ │ │ +000286d0: 7269 7665 6d61 703a 3a20 2020 2020 2020 rivemap:: │ │ │ │ │ +000286e0: 2020 2020 2020 2020 2020 2020 204d 6170 Map │ │ │ │ │ +000286f0: 2061 2064 7269 7665 2074 6f20 616e 6f74 a drive to anot │ │ │ │ │ +00028700: 6865 720a 2a20 6563 686f 3a3a 2020 2020 her.* echo:: │ │ │ │ │ 00028710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028720: 2020 4469 7370 6c61 7920 6120 6c69 6e65 Display a line │ │ │ │ │ -00028730: 206f 6620 7465 7874 0a2a 2065 7661 6c3a of text.* eval: │ │ │ │ │ -00028740: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00028750: 2020 2020 2020 2020 2045 7661 6c75 6174 Evaluat │ │ │ │ │ -00028760: 6520 6167 7275 6d65 6e74 7320 6173 2047 e agruments as G │ │ │ │ │ -00028770: 5255 4220 636f 6d6d 616e 6473 0a2a 2065 RUB commands.* e │ │ │ │ │ -00028780: 7870 6f72 743a 3a20 2020 2020 2020 2020 xport:: │ │ │ │ │ -00028790: 2020 2020 2020 2020 2020 2020 2045 7870 Exp │ │ │ │ │ -000287a0: 6f72 7420 616e 2065 6e76 6972 6f6e 6d65 ort an environme │ │ │ │ │ -000287b0: 6e74 2076 6172 6961 626c 650a 2a20 6661 nt variable.* fa │ │ │ │ │ -000287c0: 6c73 653a 3a20 2020 2020 2020 2020 2020 lse:: │ │ │ │ │ -000287d0: 2020 2020 2020 2020 2020 2020 446f 206e Do n │ │ │ │ │ -000287e0: 6f74 6869 6e67 2c20 756e 7375 6363 6573 othing, unsucces │ │ │ │ │ -000287f0: 7366 756c 6c79 0a2a 2067 6574 7465 7874 sfully.* gettext │ │ │ │ │ -00028800: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -00028810: 2020 2020 2020 2054 7261 6e73 6c61 7465 Translate │ │ │ │ │ -00028820: 2061 2073 7472 696e 670a 2a20 6770 7473 a string.* gpts │ │ │ │ │ -00028830: 796e 633a 3a20 2020 2020 2020 2020 2020 ync:: │ │ │ │ │ -00028840: 2020 2020 2020 2020 2020 4669 6c6c 2061 Fill a │ │ │ │ │ -00028850: 6e20 4d42 5220 6261 7365 6420 6f6e 2047 n MBR based on G │ │ │ │ │ -00028860: 5054 2065 6e74 7269 6573 0a2a 2068 616c PT entries.* hal │ │ │ │ │ -00028870: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ -00028880: 2020 2020 2020 2020 2020 2053 6875 7420 Shut │ │ │ │ │ -00028890: 646f 776e 2079 6f75 7220 636f 6d70 7574 down your comput │ │ │ │ │ -000288a0: 6572 0a2a 2068 6173 6873 756d 3a3a 2020 er.* hashsum:: │ │ │ │ │ +00028720: 2020 2020 4469 7370 6c61 7920 6120 6c69 Display a li │ │ │ │ │ +00028730: 6e65 206f 6620 7465 7874 0a2a 2065 7661 ne of text.* eva │ │ │ │ │ +00028740: 6c3a 3a20 2020 2020 2020 2020 2020 2020 l:: │ │ │ │ │ +00028750: 2020 2020 2020 2020 2020 2045 7661 6c75 Evalu │ │ │ │ │ +00028760: 6174 6520 6167 7275 6d65 6e74 7320 6173 ate agruments as │ │ │ │ │ +00028770: 2047 5255 4220 636f 6d6d 616e 6473 0a2a GRUB commands.* │ │ │ │ │ +00028780: 2065 7870 6f72 743a 3a20 2020 2020 2020 export:: │ │ │ │ │ +00028790: 2020 2020 2020 2020 2020 2020 2020 2045 E │ │ │ │ │ +000287a0: 7870 6f72 7420 616e 2065 6e76 6972 6f6e xport an environ │ │ │ │ │ +000287b0: 6d65 6e74 2076 6172 6961 626c 650a 2a20 ment variable.* │ │ │ │ │ +000287c0: 6661 6c73 653a 3a20 2020 2020 2020 2020 false:: │ │ │ │ │ +000287d0: 2020 2020 2020 2020 2020 2020 2020 446f Do │ │ │ │ │ +000287e0: 206e 6f74 6869 6e67 2c20 756e 7375 6363 nothing, unsucc │ │ │ │ │ +000287f0: 6573 7366 756c 6c79 0a2a 2067 6574 7465 essfully.* gette │ │ │ │ │ +00028800: 7874 3a3a 2020 2020 2020 2020 2020 2020 xt:: │ │ │ │ │ +00028810: 2020 2020 2020 2020 2054 7261 6e73 6c61 Transla │ │ │ │ │ +00028820: 7465 2061 2073 7472 696e 670a 2a20 6770 te a string.* gp │ │ │ │ │ +00028830: 7473 796e 633a 3a20 2020 2020 2020 2020 tsync:: │ │ │ │ │ +00028840: 2020 2020 2020 2020 2020 2020 4669 6c6c Fill │ │ │ │ │ +00028850: 2061 6e20 4d42 5220 6261 7365 6420 6f6e an MBR based on │ │ │ │ │ +00028860: 2047 5054 2065 6e74 7269 6573 0a2a 2068 GPT entries.* h │ │ │ │ │ +00028870: 616c 743a 3a20 2020 2020 2020 2020 2020 alt:: │ │ │ │ │ +00028880: 2020 2020 2020 2020 2020 2020 2053 6875 Shu │ │ │ │ │ +00028890: 7420 646f 776e 2079 6f75 7220 636f 6d70 t down your comp │ │ │ │ │ +000288a0: 7574 6572 0a2a 2068 6173 6873 756d 3a3a uter.* hashsum:: │ │ │ │ │ 000288b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000288c0: 2020 2043 6f6d 7075 7465 206f 7220 6368 Compute or ch │ │ │ │ │ -000288d0: 6563 6b20 6861 7368 2063 6865 636b 7375 eck hash checksu │ │ │ │ │ -000288e0: 6d0a 2a20 6865 6c70 3a3a 2020 2020 2020 m.* help:: │ │ │ │ │ +000288c0: 2020 2020 2043 6f6d 7075 7465 206f 7220 Compute or │ │ │ │ │ +000288d0: 6368 6563 6b20 6861 7368 2063 6865 636b check hash check │ │ │ │ │ +000288e0: 7375 6d0a 2a20 6865 6c70 3a3a 2020 2020 sum.* help:: │ │ │ │ │ 000288f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028900: 2020 5368 6f77 2068 656c 7020 6d65 7373 Show help mess │ │ │ │ │ -00028910: 6167 6573 0a2a 2069 6e69 7472 643a 3a20 ages.* initrd:: │ │ │ │ │ -00028920: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028930: 2020 2020 204c 6f61 6420 6120 4c69 6e75 Load a Linu │ │ │ │ │ -00028940: 7820 696e 6974 7264 0a2a 2069 6e69 7472 x initrd.* initr │ │ │ │ │ -00028950: 6431 363a 3a20 2020 2020 2020 2020 2020 d16:: │ │ │ │ │ -00028960: 2020 2020 2020 2020 204c 6f61 6420 6120 Load a │ │ │ │ │ -00028970: 4c69 6e75 7820 696e 6974 7264 2028 3136 Linux initrd (16 │ │ │ │ │ -00028980: 2d62 6974 206d 6f64 6529 0a2a 2069 6e73 -bit mode).* ins │ │ │ │ │ -00028990: 6d6f 643a 3a20 2020 2020 2020 2020 2020 mod:: │ │ │ │ │ -000289a0: 2020 2020 2020 2020 2020 2049 6e73 6572 Inser │ │ │ │ │ -000289b0: 7420 6120 6d6f 6475 6c65 0a2a 206b 6579 t a module.* key │ │ │ │ │ -000289c0: 7374 6174 7573 3a3a 2020 2020 2020 2020 status:: │ │ │ │ │ -000289d0: 2020 2020 2020 2020 2020 2043 6865 636b Check │ │ │ │ │ -000289e0: 206b 6579 206d 6f64 6966 6965 7220 7374 key modifier st │ │ │ │ │ -000289f0: 6174 7573 0a2a 206c 696e 7578 3a3a 2020 atus.* linux:: │ │ │ │ │ +00028900: 2020 2020 5368 6f77 2068 656c 7020 6d65 Show help me │ │ │ │ │ +00028910: 7373 6167 6573 0a2a 2069 6e69 7472 643a ssages.* initrd: │ │ │ │ │ +00028920: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00028930: 2020 2020 2020 204c 6f61 6420 6120 4c69 Load a Li │ │ │ │ │ +00028940: 6e75 7820 696e 6974 7264 0a2a 2069 6e69 nux initrd.* ini │ │ │ │ │ +00028950: 7472 6431 363a 3a20 2020 2020 2020 2020 trd16:: │ │ │ │ │ +00028960: 2020 2020 2020 2020 2020 204c 6f61 6420 Load │ │ │ │ │ +00028970: 6120 4c69 6e75 7820 696e 6974 7264 2028 a Linux initrd ( │ │ │ │ │ +00028980: 3136 2d62 6974 206d 6f64 6529 0a2a 2069 16-bit mode).* i │ │ │ │ │ +00028990: 6e73 6d6f 643a 3a20 2020 2020 2020 2020 nsmod:: │ │ │ │ │ +000289a0: 2020 2020 2020 2020 2020 2020 2049 6e73 Ins │ │ │ │ │ +000289b0: 6572 7420 6120 6d6f 6475 6c65 0a2a 206b ert a module.* k │ │ │ │ │ +000289c0: 6579 7374 6174 7573 3a3a 2020 2020 2020 eystatus:: │ │ │ │ │ +000289d0: 2020 2020 2020 2020 2020 2020 2043 6865 Che │ │ │ │ │ +000289e0: 636b 206b 6579 206d 6f64 6966 6965 7220 ck key modifier │ │ │ │ │ +000289f0: 7374 6174 7573 0a2a 206c 696e 7578 3a3a status.* linux:: │ │ │ │ │ 00028a00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028a10: 2020 2020 204c 6f61 6420 6120 4c69 6e75 Load a Linu │ │ │ │ │ -00028a20: 7820 6b65 726e 656c 0a2a 206c 696e 7578 x kernel.* linux │ │ │ │ │ -00028a30: 3136 3a3a 2020 2020 2020 2020 2020 2020 16:: │ │ │ │ │ -00028a40: 2020 2020 2020 2020 204c 6f61 6420 6120 Load a │ │ │ │ │ -00028a50: 4c69 6e75 7820 6b65 726e 656c 2028 3136 Linux kernel (16 │ │ │ │ │ -00028a60: 2d62 6974 206d 6f64 6529 0a2a 206c 6973 -bit mode).* lis │ │ │ │ │ -00028a70: 745f 656e 763a 3a20 2020 2020 2020 2020 t_env:: │ │ │ │ │ -00028a80: 2020 2020 2020 2020 2020 204c 6973 7420 List │ │ │ │ │ -00028a90: 7661 7269 6162 6c65 7320 696e 2065 6e76 variables in env │ │ │ │ │ -00028aa0: 6972 6f6e 6d65 6e74 2062 6c6f 636b 0a2a ironment block.* │ │ │ │ │ -00028ab0: 206c 6973 745f 7472 7573 7465 643a 3a20 list_trusted:: │ │ │ │ │ -00028ac0: 2020 2020 2020 2020 2020 2020 2020 204c L │ │ │ │ │ -00028ad0: 6973 7420 7472 7573 7465 6420 7075 626c ist trusted publ │ │ │ │ │ -00028ae0: 6963 206b 6579 730a 2a20 6c6f 6164 5f65 ic keys.* load_e │ │ │ │ │ -00028af0: 6e76 3a3a 2020 2020 2020 2020 2020 2020 nv:: │ │ │ │ │ -00028b00: 2020 2020 2020 2020 4c6f 6164 2076 6172 Load var │ │ │ │ │ -00028b10: 6961 626c 6573 2066 726f 6d20 656e 7669 iables from envi │ │ │ │ │ -00028b20: 726f 6e6d 656e 7420 626c 6f63 6b0a 2a20 ronment block.* │ │ │ │ │ -00028b30: 6c6f 6164 666f 6e74 3a3a 2020 2020 2020 loadfont:: │ │ │ │ │ -00028b40: 2020 2020 2020 2020 2020 2020 2020 4c6f Lo │ │ │ │ │ -00028b50: 6164 2066 6f6e 7420 6669 6c65 730a 2a20 ad font files.* │ │ │ │ │ -00028b60: 6c6f 6f70 6261 636b 3a3a 2020 2020 2020 loopback:: │ │ │ │ │ -00028b70: 2020 2020 2020 2020 2020 2020 2020 4d61 Ma │ │ │ │ │ -00028b80: 6b65 2061 2064 6576 6963 6520 6672 6f6d ke a device from │ │ │ │ │ -00028b90: 2061 2066 696c 6573 7973 7465 6d20 696d a filesystem im │ │ │ │ │ -00028ba0: 6167 650a 2a20 6c73 3a3a 2020 2020 2020 age.* ls:: │ │ │ │ │ +00028a10: 2020 2020 2020 204c 6f61 6420 6120 4c69 Load a Li │ │ │ │ │ +00028a20: 6e75 7820 6b65 726e 656c 0a2a 206c 696e nux kernel.* lin │ │ │ │ │ +00028a30: 7578 3136 3a3a 2020 2020 2020 2020 2020 ux16:: │ │ │ │ │ +00028a40: 2020 2020 2020 2020 2020 204c 6f61 6420 Load │ │ │ │ │ +00028a50: 6120 4c69 6e75 7820 6b65 726e 656c 2028 a Linux kernel ( │ │ │ │ │ +00028a60: 3136 2d62 6974 206d 6f64 6529 0a2a 206c 16-bit mode).* l │ │ │ │ │ +00028a70: 6973 745f 656e 763a 3a20 2020 2020 2020 ist_env:: │ │ │ │ │ +00028a80: 2020 2020 2020 2020 2020 2020 204c 6973 Lis │ │ │ │ │ +00028a90: 7420 7661 7269 6162 6c65 7320 696e 2065 t variables in e │ │ │ │ │ +00028aa0: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ │ +00028ab0: 0a2a 206c 6973 745f 7472 7573 7465 643a .* list_trusted: │ │ │ │ │ +00028ac0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00028ad0: 204c 6973 7420 7472 7573 7465 6420 7075 List trusted pu │ │ │ │ │ +00028ae0: 626c 6963 206b 6579 730a 2a20 6c6f 6164 blic keys.* load │ │ │ │ │ +00028af0: 5f65 6e76 3a3a 2020 2020 2020 2020 2020 _env:: │ │ │ │ │ +00028b00: 2020 2020 2020 2020 2020 4c6f 6164 2076 Load v │ │ │ │ │ +00028b10: 6172 6961 626c 6573 2066 726f 6d20 656e ariables from en │ │ │ │ │ +00028b20: 7669 726f 6e6d 656e 7420 626c 6f63 6b0a vironment block. │ │ │ │ │ +00028b30: 2a20 6c6f 6164 666f 6e74 3a3a 2020 2020 * loadfont:: │ │ │ │ │ +00028b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00028b50: 4c6f 6164 2066 6f6e 7420 6669 6c65 730a Load font files. │ │ │ │ │ +00028b60: 2a20 6c6f 6f70 6261 636b 3a3a 2020 2020 * loopback:: │ │ │ │ │ +00028b70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00028b80: 4d61 6b65 2061 2064 6576 6963 6520 6672 Make a device fr │ │ │ │ │ +00028b90: 6f6d 2061 2066 696c 6573 7973 7465 6d20 om a filesystem │ │ │ │ │ +00028ba0: 696d 6167 650a 2a20 6c73 3a3a 2020 2020 image.* ls:: │ │ │ │ │ 00028bb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028bc0: 2020 2020 4c69 7374 2064 6576 6963 6573 List devices │ │ │ │ │ -00028bd0: 206f 7220 6669 6c65 730a 2a20 6c73 666f or files.* lsfo │ │ │ │ │ -00028be0: 6e74 733a 3a20 2020 2020 2020 2020 2020 nts:: │ │ │ │ │ -00028bf0: 2020 2020 2020 2020 2020 4c69 7374 206c List l │ │ │ │ │ -00028c00: 6f61 6465 6420 666f 6e74 730a 2a20 6c73 oaded fonts.* ls │ │ │ │ │ -00028c10: 6d6f 643a 3a20 2020 2020 2020 2020 2020 mod:: │ │ │ │ │ -00028c20: 2020 2020 2020 2020 2020 2020 5368 6f77 Show │ │ │ │ │ -00028c30: 206c 6f61 6465 6420 6d6f 6475 6c65 730a loaded modules. │ │ │ │ │ -00028c40: 2a20 6d64 3573 756d 3a3a 2020 2020 2020 * md5sum:: │ │ │ │ │ +00028bc0: 2020 2020 2020 4c69 7374 2064 6576 6963 List devic │ │ │ │ │ +00028bd0: 6573 206f 7220 6669 6c65 730a 2a20 6c73 es or files.* ls │ │ │ │ │ +00028be0: 666f 6e74 733a 3a20 2020 2020 2020 2020 fonts:: │ │ │ │ │ +00028bf0: 2020 2020 2020 2020 2020 2020 4c69 7374 List │ │ │ │ │ +00028c00: 206c 6f61 6465 6420 666f 6e74 730a 2a20 loaded fonts.* │ │ │ │ │ +00028c10: 6c73 6d6f 643a 3a20 2020 2020 2020 2020 lsmod:: │ │ │ │ │ +00028c20: 2020 2020 2020 2020 2020 2020 2020 5368 Sh │ │ │ │ │ +00028c30: 6f77 206c 6f61 6465 6420 6d6f 6475 6c65 ow loaded module │ │ │ │ │ +00028c40: 730a 2a20 6d64 3573 756d 3a3a 2020 2020 s.* md5sum:: │ │ │ │ │ 00028c50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028c60: 436f 6d70 7574 6520 6f72 2063 6865 636b Compute or check │ │ │ │ │ -00028c70: 204d 4435 2068 6173 680a 2a20 6d6f 6475 MD5 hash.* modu │ │ │ │ │ -00028c80: 6c65 3a3a 2020 2020 2020 2020 2020 2020 le:: │ │ │ │ │ -00028c90: 2020 2020 2020 2020 2020 4c6f 6164 206d Load m │ │ │ │ │ -00028ca0: 6f64 756c 6520 666f 7220 6d75 6c74 6962 odule for multib │ │ │ │ │ -00028cb0: 6f6f 7420 6b65 726e 656c 0a2a 206d 756c oot kernel.* mul │ │ │ │ │ -00028cc0: 7469 626f 6f74 3a3a 2020 2020 2020 2020 tiboot:: │ │ │ │ │ -00028cd0: 2020 2020 2020 2020 2020 204c 6f61 6420 Load │ │ │ │ │ -00028ce0: 6d75 6c74 6962 6f6f 7420 636f 6d70 6c69 multiboot compli │ │ │ │ │ -00028cf0: 616e 7420 6b65 726e 656c 0a2a 206e 6174 ant kernel.* nat │ │ │ │ │ -00028d00: 6976 6564 6973 6b3a 3a20 2020 2020 2020 ivedisk:: │ │ │ │ │ -00028d10: 2020 2020 2020 2020 2020 2053 7769 7463 Switc │ │ │ │ │ -00028d20: 6820 746f 206e 6174 6976 6520 6469 736b h to native disk │ │ │ │ │ -00028d30: 2064 7269 7665 7273 0a2a 206e 6f72 6d61 drivers.* norma │ │ │ │ │ -00028d40: 6c3a 3a20 2020 2020 2020 2020 2020 2020 l:: │ │ │ │ │ -00028d50: 2020 2020 2020 2020 2045 6e74 6572 206e Enter n │ │ │ │ │ -00028d60: 6f72 6d61 6c20 6d6f 6465 0a2a 206e 6f72 ormal mode.* nor │ │ │ │ │ -00028d70: 6d61 6c5f 6578 6974 3a3a 2020 2020 2020 mal_exit:: │ │ │ │ │ -00028d80: 2020 2020 2020 2020 2020 2045 7869 7420 Exit │ │ │ │ │ -00028d90: 6672 6f6d 206e 6f72 6d61 6c20 6d6f 6465 from normal mode │ │ │ │ │ -00028da0: 0a2a 2070 6172 7474 6f6f 6c3a 3a20 2020 .* parttool:: │ │ │ │ │ +00028c60: 2020 436f 6d70 7574 6520 6f72 2063 6865 Compute or che │ │ │ │ │ +00028c70: 636b 204d 4435 2068 6173 680a 2a20 6d6f ck MD5 hash.* mo │ │ │ │ │ +00028c80: 6475 6c65 3a3a 2020 2020 2020 2020 2020 dule:: │ │ │ │ │ +00028c90: 2020 2020 2020 2020 2020 2020 4c6f 6164 Load │ │ │ │ │ +00028ca0: 206d 6f64 756c 6520 666f 7220 6d75 6c74 module for mult │ │ │ │ │ +00028cb0: 6962 6f6f 7420 6b65 726e 656c 0a2a 206d iboot kernel.* m │ │ │ │ │ +00028cc0: 756c 7469 626f 6f74 3a3a 2020 2020 2020 ultiboot:: │ │ │ │ │ +00028cd0: 2020 2020 2020 2020 2020 2020 204c 6f61 Loa │ │ │ │ │ +00028ce0: 6420 6d75 6c74 6962 6f6f 7420 636f 6d70 d multiboot comp │ │ │ │ │ +00028cf0: 6c69 616e 7420 6b65 726e 656c 0a2a 206e liant kernel.* n │ │ │ │ │ +00028d00: 6174 6976 6564 6973 6b3a 3a20 2020 2020 ativedisk:: │ │ │ │ │ +00028d10: 2020 2020 2020 2020 2020 2020 2053 7769 Swi │ │ │ │ │ +00028d20: 7463 6820 746f 206e 6174 6976 6520 6469 tch to native di │ │ │ │ │ +00028d30: 736b 2064 7269 7665 7273 0a2a 206e 6f72 sk drivers.* nor │ │ │ │ │ +00028d40: 6d61 6c3a 3a20 2020 2020 2020 2020 2020 mal:: │ │ │ │ │ +00028d50: 2020 2020 2020 2020 2020 2045 6e74 6572 Enter │ │ │ │ │ +00028d60: 206e 6f72 6d61 6c20 6d6f 6465 0a2a 206e normal mode.* n │ │ │ │ │ +00028d70: 6f72 6d61 6c5f 6578 6974 3a3a 2020 2020 ormal_exit:: │ │ │ │ │ +00028d80: 2020 2020 2020 2020 2020 2020 2045 7869 Exi │ │ │ │ │ +00028d90: 7420 6672 6f6d 206e 6f72 6d61 6c20 6d6f t from normal mo │ │ │ │ │ +00028da0: 6465 0a2a 2070 6172 7474 6f6f 6c3a 3a20 de.* parttool:: │ │ │ │ │ 00028db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028dc0: 204d 6f64 6966 7920 7061 7274 6974 696f Modify partitio │ │ │ │ │ -00028dd0: 6e20 7461 626c 6520 656e 7472 6965 730a n table entries. │ │ │ │ │ -00028de0: 2a20 7061 7373 776f 7264 3a3a 2020 2020 * password:: │ │ │ │ │ +00028dc0: 2020 204d 6f64 6966 7920 7061 7274 6974 Modify partit │ │ │ │ │ +00028dd0: 696f 6e20 7461 626c 6520 656e 7472 6965 ion table entrie │ │ │ │ │ +00028de0: 730a 2a20 7061 7373 776f 7264 3a3a 2020 s.* password:: │ │ │ │ │ 00028df0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028e00: 5365 7420 6120 636c 6561 722d 7465 7874 Set a clear-text │ │ │ │ │ -00028e10: 2070 6173 7377 6f72 640a 2a20 7061 7373 password.* pass │ │ │ │ │ -00028e20: 776f 7264 5f70 626b 6466 323a 3a20 2020 word_pbkdf2:: │ │ │ │ │ -00028e30: 2020 2020 2020 2020 2020 5365 7420 6120 Set a │ │ │ │ │ -00028e40: 6861 7368 6564 2070 6173 7377 6f72 640a hashed password. │ │ │ │ │ -00028e50: 2a20 706c 6179 3a3a 2020 2020 2020 2020 * play:: │ │ │ │ │ +00028e00: 2020 5365 7420 6120 636c 6561 722d 7465 Set a clear-te │ │ │ │ │ +00028e10: 7874 2070 6173 7377 6f72 640a 2a20 7061 xt password.* pa │ │ │ │ │ +00028e20: 7373 776f 7264 5f70 626b 6466 323a 3a20 ssword_pbkdf2:: │ │ │ │ │ +00028e30: 2020 2020 2020 2020 2020 2020 5365 7420 Set │ │ │ │ │ +00028e40: 6120 6861 7368 6564 2070 6173 7377 6f72 a hashed passwor │ │ │ │ │ +00028e50: 640a 2a20 706c 6179 3a3a 2020 2020 2020 d.* play:: │ │ │ │ │ 00028e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028e70: 506c 6179 2061 2074 756e 650a 2a20 7072 Play a tune.* pr │ │ │ │ │ -00028e80: 6f62 653a 3a20 2020 2020 2020 2020 2020 obe:: │ │ │ │ │ -00028e90: 2020 2020 2020 2020 2020 2020 5265 7472 Retr │ │ │ │ │ -00028ea0: 6965 7665 2064 6576 6963 6520 696e 666f ieve device info │ │ │ │ │ -00028eb0: 0a2a 2072 646d 7372 3a3a 2020 2020 2020 .* rdmsr:: │ │ │ │ │ +00028e70: 2020 506c 6179 2061 2074 756e 650a 2a20 Play a tune.* │ │ │ │ │ +00028e80: 7072 6f62 653a 3a20 2020 2020 2020 2020 probe:: │ │ │ │ │ +00028e90: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ │ +00028ea0: 7472 6965 7665 2064 6576 6963 6520 696e trieve device in │ │ │ │ │ +00028eb0: 666f 0a2a 2072 646d 7372 3a3a 2020 2020 fo.* rdmsr:: │ │ │ │ │ 00028ec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028ed0: 2052 6561 6420 7661 6c75 6573 2066 726f Read values fro │ │ │ │ │ -00028ee0: 6d20 6d6f 6465 6c2d 7370 6563 6966 6963 m model-specific │ │ │ │ │ -00028ef0: 2072 6567 6973 7465 7273 0a2a 2072 6561 registers.* rea │ │ │ │ │ -00028f00: 643a 3a20 2020 2020 2020 2020 2020 2020 d:: │ │ │ │ │ -00028f10: 2020 2020 2020 2020 2020 2052 6561 6420 Read │ │ │ │ │ -00028f20: 7573 6572 2069 6e70 7574 0a2a 2072 6562 user input.* reb │ │ │ │ │ -00028f30: 6f6f 743a 3a20 2020 2020 2020 2020 2020 oot:: │ │ │ │ │ -00028f40: 2020 2020 2020 2020 2020 2052 6562 6f6f Reboo │ │ │ │ │ -00028f50: 7420 796f 7572 2063 6f6d 7075 7465 720a t your computer. │ │ │ │ │ -00028f60: 2a20 7265 6765 7870 3a3a 2020 2020 2020 * regexp:: │ │ │ │ │ +00028ed0: 2020 2052 6561 6420 7661 6c75 6573 2066 Read values f │ │ │ │ │ +00028ee0: 726f 6d20 6d6f 6465 6c2d 7370 6563 6966 rom model-specif │ │ │ │ │ +00028ef0: 6963 2072 6567 6973 7465 7273 0a2a 2072 ic registers.* r │ │ │ │ │ +00028f00: 6561 643a 3a20 2020 2020 2020 2020 2020 ead:: │ │ │ │ │ +00028f10: 2020 2020 2020 2020 2020 2020 2052 6561 Rea │ │ │ │ │ +00028f20: 6420 7573 6572 2069 6e70 7574 0a2a 2072 d user input.* r │ │ │ │ │ +00028f30: 6562 6f6f 743a 3a20 2020 2020 2020 2020 eboot:: │ │ │ │ │ +00028f40: 2020 2020 2020 2020 2020 2020 2052 6562 Reb │ │ │ │ │ +00028f50: 6f6f 7420 796f 7572 2063 6f6d 7075 7465 oot your compute │ │ │ │ │ +00028f60: 720a 2a20 7265 6765 7870 3a3a 2020 2020 r.* regexp:: │ │ │ │ │ 00028f70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00028f80: 5465 7374 2069 6620 7265 6775 6c61 7220 Test if regular │ │ │ │ │ -00028f90: 6578 7072 6573 7369 6f6e 206d 6174 6368 expression match │ │ │ │ │ -00028fa0: 6573 2073 7472 696e 670a 2a20 726d 6d6f es string.* rmmo │ │ │ │ │ -00028fb0: 643a 3a20 2020 2020 2020 2020 2020 2020 d:: │ │ │ │ │ -00028fc0: 2020 2020 2020 2020 2020 5265 6d6f 7665 Remove │ │ │ │ │ -00028fd0: 2061 206d 6f64 756c 650a 2a20 7361 7665 a module.* save │ │ │ │ │ -00028fe0: 5f65 6e76 3a3a 2020 2020 2020 2020 2020 _env:: │ │ │ │ │ -00028ff0: 2020 2020 2020 2020 2020 5361 7665 2076 Save v │ │ │ │ │ -00029000: 6172 6961 626c 6573 2074 6f20 656e 7669 ariables to envi │ │ │ │ │ -00029010: 726f 6e6d 656e 7420 626c 6f63 6b0a 2a20 ronment block.* │ │ │ │ │ -00029020: 7365 6172 6368 3a3a 2020 2020 2020 2020 search:: │ │ │ │ │ -00029030: 2020 2020 2020 2020 2020 2020 2020 5365 Se │ │ │ │ │ -00029040: 6172 6368 2064 6576 6963 6573 2062 7920 arch devices by │ │ │ │ │ -00029050: 6669 6c65 2c20 6c61 6265 6c2c 206f 7220 file, label, or │ │ │ │ │ -00029060: 5555 4944 0a2a 2073 656e 646b 6579 3a3a UUID.* sendkey:: │ │ │ │ │ -00029070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00029080: 2020 2020 2045 6d75 6c61 7465 206b 6579 Emulate key │ │ │ │ │ -00029090: 7374 726f 6b65 730a 2a20 7365 743a 3a20 strokes.* set:: │ │ │ │ │ -000290a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000290b0: 2020 2020 2020 2020 5365 7420 616e 2065 Set an e │ │ │ │ │ -000290c0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -000290d0: 626c 650a 2a20 7368 6131 7375 6d3a 3a20 ble.* sha1sum:: │ │ │ │ │ -000290e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000290f0: 2020 2020 436f 6d70 7574 6520 6f72 2063 Compute or c │ │ │ │ │ -00029100: 6865 636b 2053 4841 3120 6861 7368 0a2a heck SHA1 hash.* │ │ │ │ │ -00029110: 2073 6861 3235 3673 756d 3a3a 2020 2020 sha256sum:: │ │ │ │ │ -00029120: 2020 2020 2020 2020 2020 2020 2020 2043 C │ │ │ │ │ -00029130: 6f6d 7075 7465 206f 7220 6368 6563 6b20 ompute or check │ │ │ │ │ -00029140: 5348 4132 3536 2068 6173 680a 2a20 7368 SHA256 hash.* sh │ │ │ │ │ -00029150: 6135 3132 7375 6d3a 3a20 2020 2020 2020 a512sum:: │ │ │ │ │ -00029160: 2020 2020 2020 2020 2020 2020 436f 6d70 Comp │ │ │ │ │ -00029170: 7574 6520 6f72 2063 6865 636b 2053 4841 ute or check SHA │ │ │ │ │ -00029180: 3531 3220 6861 7368 0a2a 2073 6c65 6570 512 hash.* sleep │ │ │ │ │ -00029190: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -000291a0: 2020 2020 2020 2020 2057 6169 7420 666f Wait fo │ │ │ │ │ -000291b0: 7220 6120 7370 6563 6966 6965 6420 6e75 r a specified nu │ │ │ │ │ -000291c0: 6d62 6572 206f 6620 7365 636f 6e64 730a mber of seconds. │ │ │ │ │ -000291d0: 2a20 736d 6269 6f73 3a3a 2020 2020 2020 * smbios:: │ │ │ │ │ +00028f80: 2020 5465 7374 2069 6620 7265 6775 6c61 Test if regula │ │ │ │ │ +00028f90: 7220 6578 7072 6573 7369 6f6e 206d 6174 r expression mat │ │ │ │ │ +00028fa0: 6368 6573 2073 7472 696e 670a 2a20 726d ches string.* rm │ │ │ │ │ +00028fb0: 6d6f 643a 3a20 2020 2020 2020 2020 2020 mod:: │ │ │ │ │ +00028fc0: 2020 2020 2020 2020 2020 2020 5265 6d6f Remo │ │ │ │ │ +00028fd0: 7665 2061 206d 6f64 756c 650a 2a20 7361 ve a module.* sa │ │ │ │ │ +00028fe0: 7665 5f65 6e76 3a3a 2020 2020 2020 2020 ve_env:: │ │ │ │ │ +00028ff0: 2020 2020 2020 2020 2020 2020 5361 7665 Save │ │ │ │ │ +00029000: 2076 6172 6961 626c 6573 2074 6f20 656e variables to en │ │ │ │ │ +00029010: 7669 726f 6e6d 656e 7420 626c 6f63 6b0a vironment block. │ │ │ │ │ +00029020: 2a20 7365 6172 6368 3a3a 2020 2020 2020 * search:: │ │ │ │ │ +00029030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00029040: 5365 6172 6368 2064 6576 6963 6573 2062 Search devices b │ │ │ │ │ +00029050: 7920 6669 6c65 2c20 6c61 6265 6c2c 206f y file, label, o │ │ │ │ │ +00029060: 7220 5555 4944 0a2a 2073 656e 646b 6579 r UUID.* sendkey │ │ │ │ │ +00029070: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +00029080: 2020 2020 2020 2045 6d75 6c61 7465 206b Emulate k │ │ │ │ │ +00029090: 6579 7374 726f 6b65 730a 2a20 7365 743a eystrokes.* set: │ │ │ │ │ +000290a0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000290b0: 2020 2020 2020 2020 2020 5365 7420 616e Set an │ │ │ │ │ +000290c0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +000290d0: 6961 626c 650a 2a20 7368 6131 7375 6d3a iable.* sha1sum: │ │ │ │ │ +000290e0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000290f0: 2020 2020 2020 436f 6d70 7574 6520 6f72 Compute or │ │ │ │ │ +00029100: 2063 6865 636b 2053 4841 3120 6861 7368 check SHA1 hash │ │ │ │ │ +00029110: 0a2a 2073 6861 3235 3673 756d 3a3a 2020 .* sha256sum:: │ │ │ │ │ +00029120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00029130: 2043 6f6d 7075 7465 206f 7220 6368 6563 Compute or chec │ │ │ │ │ +00029140: 6b20 5348 4132 3536 2068 6173 680a 2a20 k SHA256 hash.* │ │ │ │ │ +00029150: 7368 6135 3132 7375 6d3a 3a20 2020 2020 sha512sum:: │ │ │ │ │ +00029160: 2020 2020 2020 2020 2020 2020 2020 436f Co │ │ │ │ │ +00029170: 6d70 7574 6520 6f72 2063 6865 636b 2053 mpute or check S │ │ │ │ │ +00029180: 4841 3531 3220 6861 7368 0a2a 2073 6c65 HA512 hash.* sle │ │ │ │ │ +00029190: 6570 3a3a 2020 2020 2020 2020 2020 2020 ep:: │ │ │ │ │ +000291a0: 2020 2020 2020 2020 2020 2057 6169 7420 Wait │ │ │ │ │ +000291b0: 666f 7220 6120 7370 6563 6966 6965 6420 for a specified │ │ │ │ │ +000291c0: 6e75 6d62 6572 206f 6620 7365 636f 6e64 number of second │ │ │ │ │ +000291d0: 730a 2a20 736d 6269 6f73 3a3a 2020 2020 s.* smbios:: │ │ │ │ │ 000291e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000291f0: 5265 7472 6965 7665 2053 4d42 494f 5320 Retrieve SMBIOS │ │ │ │ │ -00029200: 696e 666f 726d 6174 696f 6e0a 2a20 736f information.* so │ │ │ │ │ -00029210: 7572 6365 3a3a 2020 2020 2020 2020 2020 urce:: │ │ │ │ │ -00029220: 2020 2020 2020 2020 2020 2020 5265 6164 Read │ │ │ │ │ -00029230: 2061 2063 6f6e 6669 6775 7261 7469 6f6e a configuration │ │ │ │ │ -00029240: 2066 696c 6520 696e 2073 616d 6520 636f file in same co │ │ │ │ │ -00029250: 6e74 6578 740a 2a20 7465 7374 3a3a 2020 ntext.* test:: │ │ │ │ │ +000291f0: 2020 5265 7472 6965 7665 2053 4d42 494f Retrieve SMBIO │ │ │ │ │ +00029200: 5320 696e 666f 726d 6174 696f 6e0a 2a20 S information.* │ │ │ │ │ +00029210: 736f 7572 6365 3a3a 2020 2020 2020 2020 source:: │ │ │ │ │ +00029220: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ │ +00029230: 6164 2061 2063 6f6e 6669 6775 7261 7469 ad a configurati │ │ │ │ │ +00029240: 6f6e 2066 696c 6520 696e 2073 616d 6520 on file in same │ │ │ │ │ +00029250: 636f 6e74 6578 740a 2a20 7465 7374 3a3a context.* test:: │ │ │ │ │ 00029260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00029270: 2020 2020 2020 4368 6563 6b20 6669 6c65 Check file │ │ │ │ │ -00029280: 2074 7970 6573 2061 6e64 2063 6f6d 7061 types and compa │ │ │ │ │ -00029290: 7265 2076 616c 7565 730a 2a20 7472 7565 re values.* true │ │ │ │ │ -000292a0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ -000292b0: 2020 2020 2020 2020 2020 446f 206e 6f74 Do not │ │ │ │ │ -000292c0: 6869 6e67 2c20 7375 6363 6573 7366 756c hing, successful │ │ │ │ │ -000292d0: 6c79 0a2a 2074 7275 7374 3a3a 2020 2020 ly.* trust:: │ │ │ │ │ +00029270: 2020 2020 2020 2020 4368 6563 6b20 6669 Check fi │ │ │ │ │ +00029280: 6c65 2074 7970 6573 2061 6e64 2063 6f6d le types and com │ │ │ │ │ +00029290: 7061 7265 2076 616c 7565 730a 2a20 7472 pare values.* tr │ │ │ │ │ +000292a0: 7565 3a3a 2020 2020 2020 2020 2020 2020 ue:: │ │ │ │ │ +000292b0: 2020 2020 2020 2020 2020 2020 446f 206e Do n │ │ │ │ │ +000292c0: 6f74 6869 6e67 2c20 7375 6363 6573 7366 othing, successf │ │ │ │ │ +000292d0: 756c 6c79 0a2a 2074 7275 7374 3a3a 2020 ully.* trust:: │ │ │ │ │ 000292e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000292f0: 2020 2041 6464 2070 7562 6c69 6320 6b65 Add public ke │ │ │ │ │ -00029300: 7920 746f 206c 6973 7420 6f66 2074 7275 y to list of tru │ │ │ │ │ -00029310: 7374 6564 206b 6579 730a 2a20 756e 7365 sted keys.* unse │ │ │ │ │ -00029320: 743a 3a20 2020 2020 2020 2020 2020 2020 t:: │ │ │ │ │ -00029330: 2020 2020 2020 2020 2020 556e 7365 7420 Unset │ │ │ │ │ -00029340: 616e 2065 6e76 6972 6f6e 6d65 6e74 2076 an environment v │ │ │ │ │ -00029350: 6172 6961 626c 650a 2a20 7665 7269 6679 ariable.* verify │ │ │ │ │ -00029360: 5f64 6574 6163 6865 643a 3a20 2020 2020 _detached:: │ │ │ │ │ -00029370: 2020 2020 2020 2020 5665 7269 6679 2064 Verify d │ │ │ │ │ -00029380: 6574 6163 6865 6420 6469 6769 7461 6c20 etached digital │ │ │ │ │ -00029390: 7369 676e 6174 7572 650a 2a20 7669 6465 signature.* vide │ │ │ │ │ -000293a0: 6f69 6e66 6f3a 3a20 2020 2020 2020 2020 oinfo:: │ │ │ │ │ -000293b0: 2020 2020 2020 2020 2020 4c69 7374 2061 List a │ │ │ │ │ -000293c0: 7661 696c 6162 6c65 2076 6964 656f 206d vailable video m │ │ │ │ │ -000293d0: 6f64 6573 0a2a 2077 726d 7372 3a3a 2020 odes.* wrmsr:: │ │ │ │ │ +000292f0: 2020 2020 2041 6464 2070 7562 6c69 6320 Add public │ │ │ │ │ +00029300: 6b65 7920 746f 206c 6973 7420 6f66 2074 key to list of t │ │ │ │ │ +00029310: 7275 7374 6564 206b 6579 730a 2a20 756e rusted keys.* un │ │ │ │ │ +00029320: 7365 743a 3a20 2020 2020 2020 2020 2020 set:: │ │ │ │ │ +00029330: 2020 2020 2020 2020 2020 2020 556e 7365 Unse │ │ │ │ │ +00029340: 7420 616e 2065 6e76 6972 6f6e 6d65 6e74 t an environment │ │ │ │ │ +00029350: 2076 6172 6961 626c 650a 2a20 7665 7269 variable.* veri │ │ │ │ │ +00029360: 6679 5f64 6574 6163 6865 643a 3a20 2020 fy_detached:: │ │ │ │ │ +00029370: 2020 2020 2020 2020 2020 5665 7269 6679 Verify │ │ │ │ │ +00029380: 2064 6574 6163 6865 6420 6469 6769 7461 detached digita │ │ │ │ │ +00029390: 6c20 7369 676e 6174 7572 650a 2a20 7669 l signature.* vi │ │ │ │ │ +000293a0: 6465 6f69 6e66 6f3a 3a20 2020 2020 2020 deoinfo:: │ │ │ │ │ +000293b0: 2020 2020 2020 2020 2020 2020 4c69 7374 List │ │ │ │ │ +000293c0: 2061 7661 696c 6162 6c65 2076 6964 656f available video │ │ │ │ │ +000293d0: 206d 6f64 6573 0a2a 2077 726d 7372 3a3a modes.* wrmsr:: │ │ │ │ │ 000293e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000293f0: 2020 2020 2057 7269 7465 2076 616c 7565 Write value │ │ │ │ │ -00029400: 7320 746f 206d 6f64 656c 2d73 7065 6369 s to model-speci │ │ │ │ │ -00029410: 6669 6320 7265 6769 7374 6572 730a 2a20 fic registers.* │ │ │ │ │ -00029420: 7865 6e5f 6879 7065 7276 6973 6f72 3a3a xen_hypervisor:: │ │ │ │ │ -00029430: 2020 2020 2020 2020 2020 2020 2020 4c6f Lo │ │ │ │ │ -00029440: 6164 2078 656e 2068 7970 6572 7669 736f ad xen hyperviso │ │ │ │ │ -00029450: 7220 6269 6e61 7279 2028 6f6e 6c79 206f r binary (only o │ │ │ │ │ -00029460: 6e20 4141 7263 6836 3429 0a2a 2078 656e n AArch64).* xen │ │ │ │ │ -00029470: 5f6d 6f64 756c 653a 3a20 2020 2020 2020 _module:: │ │ │ │ │ -00029480: 2020 2020 2020 2020 2020 204c 6f61 6420 Load │ │ │ │ │ -00029490: 7865 6e20 6d6f 6475 6c65 7320 666f 7220 xen modules for │ │ │ │ │ -000294a0: 7865 6e20 6879 7065 7276 6973 6f72 2028 xen hypervisor ( │ │ │ │ │ -000294b0: 6f6e 6c79 206f 6e20 4141 7263 6836 3429 only on AArch64) │ │ │ │ │ -000294c0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -000294d0: 6e66 6f2c 2020 4e6f 6465 3a20 5b2c 2020 nfo, Node: [, │ │ │ │ │ -000294e0: 4e65 7874 3a20 6163 7069 2c20 2055 703a Next: acpi, Up: │ │ │ │ │ -000294f0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ -00029500: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ -00029510: 6d61 6e64 730a 0a31 362e 332e 3120 5b0a mands..16.3.1 [. │ │ │ │ │ -00029520: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -00029530: 6d6d 616e 643a 205b 2065 7870 7265 7373 mmand: [ express │ │ │ │ │ -00029540: 696f 6e20 5d0a 2020 2020 2041 6c69 6173 ion ]. Alias │ │ │ │ │ -00029550: 2066 6f72 2027 7465 7374 2045 5850 5245 for 'test EXPRE │ │ │ │ │ -00029560: 5353 494f 4e27 2028 2a6e 6f74 6520 7465 SSION' (*note te │ │ │ │ │ -00029570: 7374 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 st::).....File: │ │ │ │ │ -00029580: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00029590: 3a20 6163 7069 2c20 204e 6578 743a 2061 : acpi, Next: a │ │ │ │ │ -000295a0: 7574 6865 6e74 6963 6174 652c 2020 5072 uthenticate, Pr │ │ │ │ │ -000295b0: 6576 3a20 5b2c 2020 5570 3a20 436f 6d6d ev: [, Up: Comm │ │ │ │ │ -000295c0: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -000295d0: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -000295e0: 0a0a 3136 2e33 2e32 2061 6370 690a 2d2d ..16.3.2 acpi.-- │ │ │ │ │ -000295f0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -00029600: 6f6d 6d61 6e64 3a20 6163 7069 205b 2d31 ommand: acpi [-1 │ │ │ │ │ -00029610: 7c2d 325d 205b 2d2d 6578 636c 7564 653d |-2] [--exclude= │ │ │ │ │ -00029620: 7461 626c 6531 2c2e 2e2e 7c2d 2d6c 6f61 table1,...|--loa │ │ │ │ │ -00029630: 642d 6f6e 6c79 3d74 6162 6c65 312c 2e2e d-only=table1,.. │ │ │ │ │ -00029640: 2e5d 0a20 2020 2020 2020 2020 205b 2d2d .]. [-- │ │ │ │ │ -00029650: 6f65 6d69 643d 6964 5d20 5b2d 2d6f 656d oemid=id] [--oem │ │ │ │ │ -00029660: 7461 626c 653d 7461 626c 655d 205b 2d2d table=table] [-- │ │ │ │ │ -00029670: 6f65 6d74 6162 6c65 7265 763d 7265 765d oemtablerev=rev] │ │ │ │ │ -00029680: 0a20 2020 2020 2020 2020 205b 2d2d 6f65 . [--oe │ │ │ │ │ -00029690: 6d74 6162 6c65 6372 6561 746f 723d 6372 mtablecreator=cr │ │ │ │ │ -000296a0: 6561 746f 725d 205b 2d2d 6f65 6d74 6162 eator] [--oemtab │ │ │ │ │ -000296b0: 6c65 6372 6561 746f 7272 6576 3d72 6576 lecreatorrev=rev │ │ │ │ │ -000296c0: 5d0a 2020 2020 2020 2020 2020 5b2d 2d6e ]. [--n │ │ │ │ │ -000296d0: 6f2d 6562 6461 5d20 6669 6c65 6e61 6d65 o-ebda] filename │ │ │ │ │ -000296e0: 202e 2e2e 0a20 2020 2020 4d6f 6465 726e .... Modern │ │ │ │ │ -000296f0: 2042 494f 5320 7379 7374 656d 7320 6e6f BIOS systems no │ │ │ │ │ -00029700: 726d 616c 6c79 2069 6d70 6c65 6d65 6e74 rmally implement │ │ │ │ │ -00029710: 2074 6865 2041 6476 616e 6365 6420 436f the Advanced Co │ │ │ │ │ -00029720: 6e66 6967 7572 6174 696f 6e0a 2020 2020 nfiguration. │ │ │ │ │ -00029730: 2061 6e64 2050 6f77 6572 2049 6e74 6572 and Power Inter │ │ │ │ │ -00029740: 6661 6365 2028 4143 5049 292c 2061 6e64 face (ACPI), and │ │ │ │ │ -00029750: 2064 6566 696e 6520 7661 7269 6f75 7320 define various │ │ │ │ │ -00029760: 7461 626c 6573 2074 6861 7420 6465 7363 tables that desc │ │ │ │ │ -00029770: 7269 6265 0a20 2020 2020 7468 6520 696e ribe. the in │ │ │ │ │ -00029780: 7465 7266 6163 6520 6265 7477 6565 6e20 terface between │ │ │ │ │ -00029790: 616e 2041 4350 492d 636f 6d70 6c69 616e an ACPI-complian │ │ │ │ │ -000297a0: 7420 6f70 6572 6174 696e 6720 7379 7374 t operating syst │ │ │ │ │ -000297b0: 656d 2061 6e64 2074 6865 0a20 2020 2020 em and the. │ │ │ │ │ -000297c0: 6669 726d 7761 7265 2e20 2049 6e20 736f firmware. In so │ │ │ │ │ -000297d0: 6d65 2063 6173 6573 2c20 7468 6520 7461 me cases, the ta │ │ │ │ │ -000297e0: 626c 6573 2070 726f 7669 6465 6420 6279 bles provided by │ │ │ │ │ -000297f0: 2064 6566 6175 6c74 206f 6e6c 7920 776f default only wo │ │ │ │ │ -00029800: 726b 0a20 2020 2020 7765 6c6c 2077 6974 rk. well wit │ │ │ │ │ -00029810: 6820 6365 7274 6169 6e20 6f70 6572 6174 h certain operat │ │ │ │ │ -00029820: 696e 6720 7379 7374 656d 732c 2061 6e64 ing systems, and │ │ │ │ │ -00029830: 2069 7420 6d61 7920 6265 206e 6563 6573 it may be neces │ │ │ │ │ -00029840: 7361 7279 2074 6f0a 2020 2020 2072 6570 sary to. rep │ │ │ │ │ -00029850: 6c61 6365 2073 6f6d 6520 6f66 2074 6865 lace some of the │ │ │ │ │ -00029860: 6d2e 0a0a 2020 2020 204e 6f72 6d61 6c6c m... Normall │ │ │ │ │ -00029870: 792c 2074 6869 7320 636f 6d6d 616e 6420 y, this command │ │ │ │ │ -00029880: 7769 6c6c 2072 6570 6c61 6365 2074 6865 will replace the │ │ │ │ │ -00029890: 2052 6f6f 7420 5379 7374 656d 2044 6573 Root System Des │ │ │ │ │ -000298a0: 6372 6970 7469 6f6e 0a20 2020 2020 506f cription. Po │ │ │ │ │ -000298b0: 696e 7465 7220 2852 5344 5029 2069 6e20 inter (RSDP) in │ │ │ │ │ -000298c0: 7468 6520 4578 7465 6e64 6564 2042 494f the Extended BIO │ │ │ │ │ -000298d0: 5320 4461 7461 2041 7265 6120 746f 2070 S Data Area to p │ │ │ │ │ -000298e0: 6f69 6e74 2074 6f20 7468 6520 6e65 770a oint to the new. │ │ │ │ │ -000298f0: 2020 2020 2074 6162 6c65 732e 2020 4966 tables. If │ │ │ │ │ -00029900: 2074 6865 2027 2d2d 6e6f 2d65 6264 6127 the '--no-ebda' │ │ │ │ │ -00029910: 206f 7074 696f 6e20 6973 2075 7365 642c option is used, │ │ │ │ │ -00029920: 2074 6865 206e 6577 2074 6162 6c65 7320 the new tables │ │ │ │ │ -00029930: 7769 6c6c 2062 650a 2020 2020 206b 6e6f will be. kno │ │ │ │ │ -00029940: 776e 206f 6e6c 7920 746f 2047 5255 422c wn only to GRUB, │ │ │ │ │ -00029950: 2062 7574 206d 6179 2062 6520 7573 6564 but may be used │ │ │ │ │ -00029960: 2062 7920 4752 5542 2773 2045 4649 2065 by GRUB's EFI e │ │ │ │ │ -00029970: 6d75 6c61 7469 6f6e 2e0a 0a20 2020 2020 mulation... │ │ │ │ │ -00029980: 4e6f 7465 3a20 5468 6520 636f 6d6d 616e Note: The comman │ │ │ │ │ -00029990: 6420 6973 206e 6f74 2061 6c6c 6f77 6564 d is not allowed │ │ │ │ │ -000299a0: 2077 6865 6e20 6c6f 636b 646f 776e 2069 when lockdown i │ │ │ │ │ -000299b0: 7320 656e 666f 7263 6564 2028 2a6e 6f74 s enforced (*not │ │ │ │ │ -000299c0: 650a 2020 2020 204c 6f63 6b64 6f77 6e3a e. Lockdown: │ │ │ │ │ -000299d0: 3a29 2e20 204f 7468 6572 7769 7365 2061 :). Otherwise a │ │ │ │ │ -000299e0: 6e20 6174 7461 636b 6572 2063 616e 2069 n attacker can i │ │ │ │ │ -000299f0: 6e73 7472 7563 7420 7468 6520 4752 5542 nstruct the GRUB │ │ │ │ │ -00029a00: 2074 6f20 6c6f 6164 0a20 2020 2020 616e to load. an │ │ │ │ │ -00029a10: 2053 5344 5420 7461 626c 6520 746f 206f SSDT table to o │ │ │ │ │ -00029a20: 7665 7277 7269 7465 2074 6865 206b 6572 verwrite the ker │ │ │ │ │ -00029a30: 6e65 6c20 6c6f 636b 646f 776e 2063 6f6e nel lockdown con │ │ │ │ │ -00029a40: 6669 6775 7261 7469 6f6e 2061 6e64 0a20 figuration and. │ │ │ │ │ -00029a50: 2020 2020 6c61 7465 7220 6c6f 6164 2061 later load a │ │ │ │ │ -00029a60: 6e64 2065 7865 6375 7465 2075 6e73 6967 nd execute unsig │ │ │ │ │ -00029a70: 6e65 6420 636f 6465 2e0a 0a1f 0a46 696c ned code.....Fil │ │ │ │ │ -00029a80: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00029a90: 6f64 653a 2061 7574 6865 6e74 6963 6174 ode: authenticat │ │ │ │ │ -00029aa0: 652c 2020 4e65 7874 3a20 6261 636b 6772 e, Next: backgr │ │ │ │ │ -00029ab0: 6f75 6e64 5f63 6f6c 6f72 2c20 2050 7265 ound_color, Pre │ │ │ │ │ -00029ac0: 763a 2061 6370 692c 2020 5570 3a20 436f v: acpi, Up: Co │ │ │ │ │ -00029ad0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -00029ae0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -00029af0: 6473 0a0a 3136 2e33 2e33 2061 7574 6865 ds..16.3.3 authe │ │ │ │ │ -00029b00: 6e74 6963 6174 650a 2d2d 2d2d 2d2d 2d2d nticate.-------- │ │ │ │ │ -00029b10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ -00029b20: 2043 6f6d 6d61 6e64 3a20 6175 7468 656e Command: authen │ │ │ │ │ -00029b30: 7469 6361 7465 205b 7573 6572 6c69 7374 ticate [userlist │ │ │ │ │ -00029b40: 5d0a 2020 2020 2043 6865 636b 2077 6865 ]. Check whe │ │ │ │ │ -00029b50: 7468 6572 2075 7365 7220 6973 2069 6e20 ther user is in │ │ │ │ │ -00029b60: 5553 4552 4c49 5354 206f 7220 6c69 7374 USERLIST or list │ │ │ │ │ -00029b70: 6564 2069 6e20 7468 6520 7661 6c75 6520 ed in the value │ │ │ │ │ -00029b80: 6f66 0a20 2020 2020 7661 7269 6162 6c65 of. variable │ │ │ │ │ -00029b90: 2027 7375 7065 7275 7365 7273 272e 2020 'superusers'. │ │ │ │ │ -00029ba0: 5365 6520 2a6e 6f74 6520 7375 7065 7275 See *note superu │ │ │ │ │ -00029bb0: 7365 7273 3a3a 2066 6f72 2076 616c 6964 sers:: for valid │ │ │ │ │ -00029bc0: 2075 7365 7220 6c69 7374 0a20 2020 2020 user list. │ │ │ │ │ -00029bd0: 666f 726d 6174 2e20 2049 6620 2773 7570 format. If 'sup │ │ │ │ │ -00029be0: 6572 7573 6572 7327 2069 7320 656d 7074 erusers' is empt │ │ │ │ │ -00029bf0: 792c 2074 6869 7320 636f 6d6d 616e 6420 y, this command │ │ │ │ │ -00029c00: 7265 7475 726e 7320 7472 7565 2e0a 2020 returns true.. │ │ │ │ │ -00029c10: 2020 202a 4e6f 7465 2053 6563 7572 6974 *Note Securit │ │ │ │ │ -00029c20: 793a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 y::.....File: gr │ │ │ │ │ -00029c30: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00029c40: 6261 636b 6772 6f75 6e64 5f63 6f6c 6f72 background_color │ │ │ │ │ -00029c50: 2c20 204e 6578 743a 2062 6163 6b67 726f , Next: backgro │ │ │ │ │ -00029c60: 756e 645f 696d 6167 652c 2020 5072 6576 und_image, Prev │ │ │ │ │ -00029c70: 3a20 6175 7468 656e 7469 6361 7465 2c20 : authenticate, │ │ │ │ │ -00029c80: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ -00029c90: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ -00029ca0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ -00029cb0: 3420 6261 636b 6772 6f75 6e64 5f63 6f6c 4 background_col │ │ │ │ │ -00029cc0: 6f72 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d or.------------- │ │ │ │ │ -00029cd0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -00029ce0: 436f 6d6d 616e 643a 2062 6163 6b67 726f Command: backgro │ │ │ │ │ -00029cf0: 756e 645f 636f 6c6f 7220 636f 6c6f 720a und_color color. │ │ │ │ │ -00029d00: 2020 2020 2053 6574 2062 6163 6b67 726f Set backgro │ │ │ │ │ -00029d10: 756e 6420 636f 6c6f 7220 666f 7220 6163 und color for ac │ │ │ │ │ -00029d20: 7469 7665 2074 6572 6d69 6e61 6c2e 2020 tive terminal. │ │ │ │ │ -00029d30: 466f 7220 7661 6c69 6420 636f 6c6f 720a For valid color. │ │ │ │ │ -00029d40: 2020 2020 2073 7065 6369 6669 6361 7469 specificati │ │ │ │ │ -00029d50: 6f6e 7320 7365 6520 2a6e 6f74 6520 436f ons see *note Co │ │ │ │ │ -00029d60: 6c6f 7273 3a20 5468 656d 6520 6669 6c65 lors: Theme file │ │ │ │ │ -00029d70: 2066 6f72 6d61 742e 2020 4261 636b 6772 format. Backgr │ │ │ │ │ -00029d80: 6f75 6e64 0a20 2020 2020 636f 6c6f 7220 ound. color │ │ │ │ │ -00029d90: 6361 6e20 6265 2063 6861 6e67 6564 206f can be changed o │ │ │ │ │ -00029da0: 6e6c 7920 7768 656e 2075 7369 6e67 2027 nly when using ' │ │ │ │ │ -00029db0: 6766 7874 6572 6d27 2066 6f72 2074 6572 gfxterm' for ter │ │ │ │ │ -00029dc0: 6d69 6e61 6c20 6f75 7470 7574 2e0a 0a20 minal output... │ │ │ │ │ -00029dd0: 2020 2020 5468 6973 2063 6f6d 6d61 6e64 This command │ │ │ │ │ -00029de0: 2073 6574 7320 636f 6c6f 7220 6f66 2065 sets color of e │ │ │ │ │ -00029df0: 6d70 7479 2061 7265 6173 2077 6974 686f mpty areas witho │ │ │ │ │ -00029e00: 7574 2074 6578 742e 2020 5465 7874 0a20 ut text. Text. │ │ │ │ │ -00029e10: 2020 2020 6261 636b 6772 6f75 6e64 2063 background c │ │ │ │ │ -00029e20: 6f6c 6f72 2069 7320 636f 6e74 726f 6c6c olor is controll │ │ │ │ │ -00029e30: 6564 2062 7920 656e 7669 726f 6e6d 656e ed by environmen │ │ │ │ │ -00029e40: 7420 7661 7269 6162 6c65 730a 2020 2020 t variables. │ │ │ │ │ -00029e50: 2043 4f4c 4f52 5f4e 4f52 4d41 4c2c 2043 COLOR_NORMAL, C │ │ │ │ │ -00029e60: 4f4c 4f52 5f48 4947 484c 4947 4854 2c20 OLOR_HIGHLIGHT, │ │ │ │ │ -00029e70: 4d45 4e55 5f43 4f4c 4f52 5f4e 4f52 4d41 MENU_COLOR_NORMA │ │ │ │ │ -00029e80: 4c2c 0a20 2020 2020 4d45 4e55 5f43 4f4c L,. MENU_COL │ │ │ │ │ -00029e90: 4f52 5f48 4947 484c 4947 4854 2e20 202a OR_HIGHLIGHT. * │ │ │ │ │ -00029ea0: 4e6f 7465 2053 7065 6369 616c 2065 6e76 Note Special env │ │ │ │ │ -00029eb0: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -00029ec0: 6573 3a3a 2e0a 0a1f 0a46 696c 653a 2067 es::.....File: g │ │ │ │ │ -00029ed0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00029ee0: 2062 6163 6b67 726f 756e 645f 696d 6167 background_imag │ │ │ │ │ -00029ef0: 652c 2020 4e65 7874 3a20 6261 6472 616d e, Next: badram │ │ │ │ │ -00029f00: 2c20 2050 7265 763a 2062 6163 6b67 726f , Prev: backgro │ │ │ │ │ -00029f10: 756e 645f 636f 6c6f 722c 2020 5570 3a20 und_color, Up: │ │ │ │ │ -00029f20: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -00029f30: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -00029f40: 616e 6473 0a0a 3136 2e33 2e35 2062 6163 ands..16.3.5 bac │ │ │ │ │ -00029f50: 6b67 726f 756e 645f 696d 6167 650a 2d2d kground_image.-- │ │ │ │ │ +000293f0: 2020 2020 2020 2057 7269 7465 2076 616c Write val │ │ │ │ │ +00029400: 7565 7320 746f 206d 6f64 656c 2d73 7065 ues to model-spe │ │ │ │ │ +00029410: 6369 6669 6320 7265 6769 7374 6572 730a cific registers. │ │ │ │ │ +00029420: 2a20 7865 6e5f 6879 7065 7276 6973 6f72 * xen_hypervisor │ │ │ │ │ +00029430: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +00029440: 4c6f 6164 2078 656e 2068 7970 6572 7669 Load xen hypervi │ │ │ │ │ +00029450: 736f 7220 6269 6e61 7279 2028 6f6e 6c79 sor binary (only │ │ │ │ │ +00029460: 206f 6e20 4141 7263 6836 3429 0a2a 2078 on AArch64).* x │ │ │ │ │ +00029470: 656e 5f6d 6f64 756c 653a 3a20 2020 2020 en_module:: │ │ │ │ │ +00029480: 2020 2020 2020 2020 2020 2020 204c 6f61 Loa │ │ │ │ │ +00029490: 6420 7865 6e20 6d6f 6475 6c65 7320 666f d xen modules fo │ │ │ │ │ +000294a0: 7220 7865 6e20 6879 7065 7276 6973 6f72 r xen hypervisor │ │ │ │ │ +000294b0: 2028 6f6e 6c79 206f 6e20 4141 7263 6836 (only on AArch6 │ │ │ │ │ +000294c0: 3429 0a0a 1f0a 4669 6c65 3a20 6772 7562 4)....File: grub │ │ │ │ │ +000294d0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5b2c .info, Node: [, │ │ │ │ │ +000294e0: 2020 4e65 7874 3a20 6163 7069 2c20 2055 Next: acpi, U │ │ │ │ │ +000294f0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ +00029500: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ +00029510: 6f6d 6d61 6e64 730a 0a31 362e 332e 3120 ommands..16.3.1 │ │ │ │ │ +00029520: 5b0a 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 [.--------.. -- │ │ │ │ │ +00029530: 436f 6d6d 616e 643a 205b 2065 7870 7265 Command: [ expre │ │ │ │ │ +00029540: 7373 696f 6e20 5d0a 2020 2020 2041 6c69 ssion ]. Ali │ │ │ │ │ +00029550: 6173 2066 6f72 2027 7465 7374 2045 5850 as for 'test EXP │ │ │ │ │ +00029560: 5245 5353 494f 4e27 2028 2a6e 6f74 6520 RESSION' (*note │ │ │ │ │ +00029570: 7465 7374 3a3a 292e 0a0a 1f0a 4669 6c65 test::).....File │ │ │ │ │ +00029580: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00029590: 6465 3a20 6163 7069 2c20 204e 6578 743a de: acpi, Next: │ │ │ │ │ +000295a0: 2061 7574 6865 6e74 6963 6174 652c 2020 authenticate, │ │ │ │ │ +000295b0: 5072 6576 3a20 5b2c 2020 5570 3a20 436f Prev: [, Up: Co │ │ │ │ │ +000295c0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +000295d0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +000295e0: 6473 0a0a 3136 2e33 2e32 2061 6370 690a ds..16.3.2 acpi. │ │ │ │ │ +000295f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +00029600: 2043 6f6d 6d61 6e64 3a20 6163 7069 205b Command: acpi [ │ │ │ │ │ +00029610: 2d31 7c2d 325d 205b 2d2d 6578 636c 7564 -1|-2] [--exclud │ │ │ │ │ +00029620: 653d 7461 626c 6531 2c2e 2e2e 7c2d 2d6c e=table1,...|--l │ │ │ │ │ +00029630: 6f61 642d 6f6e 6c79 3d74 6162 6c65 312c oad-only=table1, │ │ │ │ │ +00029640: 2e2e 2e5d 0a20 2020 2020 2020 2020 205b ...]. [ │ │ │ │ │ +00029650: 2d2d 6f65 6d69 643d 6964 5d20 5b2d 2d6f --oemid=id] [--o │ │ │ │ │ +00029660: 656d 7461 626c 653d 7461 626c 655d 205b emtable=table] [ │ │ │ │ │ +00029670: 2d2d 6f65 6d74 6162 6c65 7265 763d 7265 --oemtablerev=re │ │ │ │ │ +00029680: 765d 0a20 2020 2020 2020 2020 205b 2d2d v]. [-- │ │ │ │ │ +00029690: 6f65 6d74 6162 6c65 6372 6561 746f 723d oemtablecreator= │ │ │ │ │ +000296a0: 6372 6561 746f 725d 205b 2d2d 6f65 6d74 creator] [--oemt │ │ │ │ │ +000296b0: 6162 6c65 6372 6561 746f 7272 6576 3d72 ablecreatorrev=r │ │ │ │ │ +000296c0: 6576 5d0a 2020 2020 2020 2020 2020 5b2d ev]. [- │ │ │ │ │ +000296d0: 2d6e 6f2d 6562 6461 5d20 6669 6c65 6e61 -no-ebda] filena │ │ │ │ │ +000296e0: 6d65 202e 2e2e 0a20 2020 2020 4d6f 6465 me .... Mode │ │ │ │ │ +000296f0: 726e 2042 494f 5320 7379 7374 656d 7320 rn BIOS systems │ │ │ │ │ +00029700: 6e6f 726d 616c 6c79 2069 6d70 6c65 6d65 normally impleme │ │ │ │ │ +00029710: 6e74 2074 6865 2041 6476 616e 6365 6420 nt the Advanced │ │ │ │ │ +00029720: 436f 6e66 6967 7572 6174 696f 6e0a 2020 Configuration. │ │ │ │ │ +00029730: 2020 2061 6e64 2050 6f77 6572 2049 6e74 and Power Int │ │ │ │ │ +00029740: 6572 6661 6365 2028 4143 5049 292c 2061 erface (ACPI), a │ │ │ │ │ +00029750: 6e64 2064 6566 696e 6520 7661 7269 6f75 nd define variou │ │ │ │ │ +00029760: 7320 7461 626c 6573 2074 6861 7420 6465 s tables that de │ │ │ │ │ +00029770: 7363 7269 6265 0a20 2020 2020 7468 6520 scribe. the │ │ │ │ │ +00029780: 696e 7465 7266 6163 6520 6265 7477 6565 interface betwee │ │ │ │ │ +00029790: 6e20 616e 2041 4350 492d 636f 6d70 6c69 n an ACPI-compli │ │ │ │ │ +000297a0: 616e 7420 6f70 6572 6174 696e 6720 7379 ant operating sy │ │ │ │ │ +000297b0: 7374 656d 2061 6e64 2074 6865 0a20 2020 stem and the. │ │ │ │ │ +000297c0: 2020 6669 726d 7761 7265 2e20 2049 6e20 firmware. In │ │ │ │ │ +000297d0: 736f 6d65 2063 6173 6573 2c20 7468 6520 some cases, the │ │ │ │ │ +000297e0: 7461 626c 6573 2070 726f 7669 6465 6420 tables provided │ │ │ │ │ +000297f0: 6279 2064 6566 6175 6c74 206f 6e6c 7920 by default only │ │ │ │ │ +00029800: 776f 726b 0a20 2020 2020 7765 6c6c 2077 work. well w │ │ │ │ │ +00029810: 6974 6820 6365 7274 6169 6e20 6f70 6572 ith certain oper │ │ │ │ │ +00029820: 6174 696e 6720 7379 7374 656d 732c 2061 ating systems, a │ │ │ │ │ +00029830: 6e64 2069 7420 6d61 7920 6265 206e 6563 nd it may be nec │ │ │ │ │ +00029840: 6573 7361 7279 2074 6f0a 2020 2020 2072 essary to. r │ │ │ │ │ +00029850: 6570 6c61 6365 2073 6f6d 6520 6f66 2074 eplace some of t │ │ │ │ │ +00029860: 6865 6d2e 0a0a 2020 2020 204e 6f72 6d61 hem... Norma │ │ │ │ │ +00029870: 6c6c 792c 2074 6869 7320 636f 6d6d 616e lly, this comman │ │ │ │ │ +00029880: 6420 7769 6c6c 2072 6570 6c61 6365 2074 d will replace t │ │ │ │ │ +00029890: 6865 2052 6f6f 7420 5379 7374 656d 2044 he Root System D │ │ │ │ │ +000298a0: 6573 6372 6970 7469 6f6e 0a20 2020 2020 escription. │ │ │ │ │ +000298b0: 506f 696e 7465 7220 2852 5344 5029 2069 Pointer (RSDP) i │ │ │ │ │ +000298c0: 6e20 7468 6520 4578 7465 6e64 6564 2042 n the Extended B │ │ │ │ │ +000298d0: 494f 5320 4461 7461 2041 7265 6120 746f IOS Data Area to │ │ │ │ │ +000298e0: 2070 6f69 6e74 2074 6f20 7468 6520 6e65 point to the ne │ │ │ │ │ +000298f0: 770a 2020 2020 2074 6162 6c65 732e 2020 w. tables. │ │ │ │ │ +00029900: 4966 2074 6865 2027 2d2d 6e6f 2d65 6264 If the '--no-ebd │ │ │ │ │ +00029910: 6127 206f 7074 696f 6e20 6973 2075 7365 a' option is use │ │ │ │ │ +00029920: 642c 2074 6865 206e 6577 2074 6162 6c65 d, the new table │ │ │ │ │ +00029930: 7320 7769 6c6c 2062 650a 2020 2020 206b s will be. k │ │ │ │ │ +00029940: 6e6f 776e 206f 6e6c 7920 746f 2047 5255 nown only to GRU │ │ │ │ │ +00029950: 422c 2062 7574 206d 6179 2062 6520 7573 B, but may be us │ │ │ │ │ +00029960: 6564 2062 7920 4752 5542 2773 2045 4649 ed by GRUB's EFI │ │ │ │ │ +00029970: 2065 6d75 6c61 7469 6f6e 2e0a 0a20 2020 emulation... │ │ │ │ │ +00029980: 2020 4e6f 7465 3a20 5468 6520 636f 6d6d Note: The comm │ │ │ │ │ +00029990: 616e 6420 6973 206e 6f74 2061 6c6c 6f77 and is not allow │ │ │ │ │ +000299a0: 6564 2077 6865 6e20 6c6f 636b 646f 776e ed when lockdown │ │ │ │ │ +000299b0: 2069 7320 656e 666f 7263 6564 2028 2a6e is enforced (*n │ │ │ │ │ +000299c0: 6f74 650a 2020 2020 204c 6f63 6b64 6f77 ote. Lockdow │ │ │ │ │ +000299d0: 6e3a 3a29 2e20 204f 7468 6572 7769 7365 n::). Otherwise │ │ │ │ │ +000299e0: 2061 6e20 6174 7461 636b 6572 2063 616e an attacker can │ │ │ │ │ +000299f0: 2069 6e73 7472 7563 7420 7468 6520 4752 instruct the GR │ │ │ │ │ +00029a00: 5542 2074 6f20 6c6f 6164 0a20 2020 2020 UB to load. │ │ │ │ │ +00029a10: 616e 2053 5344 5420 7461 626c 6520 746f an SSDT table to │ │ │ │ │ +00029a20: 206f 7665 7277 7269 7465 2074 6865 206b overwrite the k │ │ │ │ │ +00029a30: 6572 6e65 6c20 6c6f 636b 646f 776e 2063 ernel lockdown c │ │ │ │ │ +00029a40: 6f6e 6669 6775 7261 7469 6f6e 2061 6e64 onfiguration and │ │ │ │ │ +00029a50: 0a20 2020 2020 6c61 7465 7220 6c6f 6164 . later load │ │ │ │ │ +00029a60: 2061 6e64 2065 7865 6375 7465 2075 6e73 and execute uns │ │ │ │ │ +00029a70: 6967 6e65 6420 636f 6465 2e0a 0a1f 0a46 igned code.....F │ │ │ │ │ +00029a80: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00029a90: 204e 6f64 653a 2061 7574 6865 6e74 6963 Node: authentic │ │ │ │ │ +00029aa0: 6174 652c 2020 4e65 7874 3a20 6261 636b ate, Next: back │ │ │ │ │ +00029ab0: 6772 6f75 6e64 5f63 6f6c 6f72 2c20 2050 ground_color, P │ │ │ │ │ +00029ac0: 7265 763a 2061 6370 692c 2020 5570 3a20 rev: acpi, Up: │ │ │ │ │ +00029ad0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00029ae0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00029af0: 616e 6473 0a0a 3136 2e33 2e33 2061 7574 ands..16.3.3 aut │ │ │ │ │ +00029b00: 6865 6e74 6963 6174 650a 2d2d 2d2d 2d2d henticate.------ │ │ │ │ │ +00029b10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +00029b20: 2d2d 2043 6f6d 6d61 6e64 3a20 6175 7468 -- Command: auth │ │ │ │ │ +00029b30: 656e 7469 6361 7465 205b 7573 6572 6c69 enticate [userli │ │ │ │ │ +00029b40: 7374 5d0a 2020 2020 2043 6865 636b 2077 st]. Check w │ │ │ │ │ +00029b50: 6865 7468 6572 2075 7365 7220 6973 2069 hether user is i │ │ │ │ │ +00029b60: 6e20 5553 4552 4c49 5354 206f 7220 6c69 n USERLIST or li │ │ │ │ │ +00029b70: 7374 6564 2069 6e20 7468 6520 7661 6c75 sted in the valu │ │ │ │ │ +00029b80: 6520 6f66 0a20 2020 2020 7661 7269 6162 e of. variab │ │ │ │ │ +00029b90: 6c65 2027 7375 7065 7275 7365 7273 272e le 'superusers'. │ │ │ │ │ +00029ba0: 2020 5365 6520 2a6e 6f74 6520 7375 7065 See *note supe │ │ │ │ │ +00029bb0: 7275 7365 7273 3a3a 2066 6f72 2076 616c rusers:: for val │ │ │ │ │ +00029bc0: 6964 2075 7365 7220 6c69 7374 0a20 2020 id user list. │ │ │ │ │ +00029bd0: 2020 666f 726d 6174 2e20 2049 6620 2773 format. If 's │ │ │ │ │ +00029be0: 7570 6572 7573 6572 7327 2069 7320 656d uperusers' is em │ │ │ │ │ +00029bf0: 7074 792c 2074 6869 7320 636f 6d6d 616e pty, this comman │ │ │ │ │ +00029c00: 6420 7265 7475 726e 7320 7472 7565 2e0a d returns true.. │ │ │ │ │ +00029c10: 2020 2020 202a 4e6f 7465 2053 6563 7572 *Note Secur │ │ │ │ │ +00029c20: 6974 793a 3a2e 0a0a 1f0a 4669 6c65 3a20 ity::.....File: │ │ │ │ │ +00029c30: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00029c40: 3a20 6261 636b 6772 6f75 6e64 5f63 6f6c : background_col │ │ │ │ │ +00029c50: 6f72 2c20 204e 6578 743a 2062 6163 6b67 or, Next: backg │ │ │ │ │ +00029c60: 726f 756e 645f 696d 6167 652c 2020 5072 round_image, Pr │ │ │ │ │ +00029c70: 6576 3a20 6175 7468 656e 7469 6361 7465 ev: authenticate │ │ │ │ │ +00029c80: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ +00029c90: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ +00029ca0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ +00029cb0: 332e 3420 6261 636b 6772 6f75 6e64 5f63 3.4 background_c │ │ │ │ │ +00029cc0: 6f6c 6f72 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d olor.----------- │ │ │ │ │ +00029cd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ +00029ce0: 2d20 436f 6d6d 616e 643a 2062 6163 6b67 - Command: backg │ │ │ │ │ +00029cf0: 726f 756e 645f 636f 6c6f 7220 636f 6c6f round_color colo │ │ │ │ │ +00029d00: 720a 2020 2020 2053 6574 2062 6163 6b67 r. Set backg │ │ │ │ │ +00029d10: 726f 756e 6420 636f 6c6f 7220 666f 7220 round color for │ │ │ │ │ +00029d20: 6163 7469 7665 2074 6572 6d69 6e61 6c2e active terminal. │ │ │ │ │ +00029d30: 2020 466f 7220 7661 6c69 6420 636f 6c6f For valid colo │ │ │ │ │ +00029d40: 720a 2020 2020 2073 7065 6369 6669 6361 r. specifica │ │ │ │ │ +00029d50: 7469 6f6e 7320 7365 6520 2a6e 6f74 6520 tions see *note │ │ │ │ │ +00029d60: 436f 6c6f 7273 3a20 5468 656d 6520 6669 Colors: Theme fi │ │ │ │ │ +00029d70: 6c65 2066 6f72 6d61 742e 2020 4261 636b le format. Back │ │ │ │ │ +00029d80: 6772 6f75 6e64 0a20 2020 2020 636f 6c6f ground. colo │ │ │ │ │ +00029d90: 7220 6361 6e20 6265 2063 6861 6e67 6564 r can be changed │ │ │ │ │ +00029da0: 206f 6e6c 7920 7768 656e 2075 7369 6e67 only when using │ │ │ │ │ +00029db0: 2027 6766 7874 6572 6d27 2066 6f72 2074 'gfxterm' for t │ │ │ │ │ +00029dc0: 6572 6d69 6e61 6c20 6f75 7470 7574 2e0a erminal output.. │ │ │ │ │ +00029dd0: 0a20 2020 2020 5468 6973 2063 6f6d 6d61 . This comma │ │ │ │ │ +00029de0: 6e64 2073 6574 7320 636f 6c6f 7220 6f66 nd sets color of │ │ │ │ │ +00029df0: 2065 6d70 7479 2061 7265 6173 2077 6974 empty areas wit │ │ │ │ │ +00029e00: 686f 7574 2074 6578 742e 2020 5465 7874 hout text. Text │ │ │ │ │ +00029e10: 0a20 2020 2020 6261 636b 6772 6f75 6e64 . background │ │ │ │ │ +00029e20: 2063 6f6c 6f72 2069 7320 636f 6e74 726f color is contro │ │ │ │ │ +00029e30: 6c6c 6564 2062 7920 656e 7669 726f 6e6d lled by environm │ │ │ │ │ +00029e40: 656e 7420 7661 7269 6162 6c65 730a 2020 ent variables. │ │ │ │ │ +00029e50: 2020 2043 4f4c 4f52 5f4e 4f52 4d41 4c2c COLOR_NORMAL, │ │ │ │ │ +00029e60: 2043 4f4c 4f52 5f48 4947 484c 4947 4854 COLOR_HIGHLIGHT │ │ │ │ │ +00029e70: 2c20 4d45 4e55 5f43 4f4c 4f52 5f4e 4f52 , MENU_COLOR_NOR │ │ │ │ │ +00029e80: 4d41 4c2c 0a20 2020 2020 4d45 4e55 5f43 MAL,. MENU_C │ │ │ │ │ +00029e90: 4f4c 4f52 5f48 4947 484c 4947 4854 2e20 OLOR_HIGHLIGHT. │ │ │ │ │ +00029ea0: 202a 4e6f 7465 2053 7065 6369 616c 2065 *Note Special e │ │ │ │ │ +00029eb0: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00029ec0: 626c 6573 3a3a 2e0a 0a1f 0a46 696c 653a bles::.....File: │ │ │ │ │ +00029ed0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00029ee0: 653a 2062 6163 6b67 726f 756e 645f 696d e: background_im │ │ │ │ │ +00029ef0: 6167 652c 2020 4e65 7874 3a20 6261 6472 age, Next: badr │ │ │ │ │ +00029f00: 616d 2c20 2050 7265 763a 2062 6163 6b67 am, Prev: backg │ │ │ │ │ +00029f10: 726f 756e 645f 636f 6c6f 722c 2020 5570 round_color, Up │ │ │ │ │ +00029f20: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +00029f30: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +00029f40: 6d6d 616e 6473 0a0a 3136 2e33 2e35 2062 mmands..16.3.5 b │ │ │ │ │ +00029f50: 6163 6b67 726f 756e 645f 696d 6167 650a ackground_image. │ │ │ │ │ 00029f60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00029f70: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -00029f80: 6e64 3a20 6261 636b 6772 6f75 6e64 5f69 nd: background_i │ │ │ │ │ -00029f90: 6d61 6765 205b 5b2d 2d6d 6f64 6520 7374 mage [[--mode st │ │ │ │ │ -00029fa0: 7265 7463 687c 6e6f 726d 616c 5d20 6669 retch|normal] fi │ │ │ │ │ -00029fb0: 6c65 5d0a 2020 2020 204c 6f61 6420 6261 le]. Load ba │ │ │ │ │ -00029fc0: 636b 6772 6f75 6e64 2069 6d61 6765 2066 ckground image f │ │ │ │ │ -00029fd0: 6f72 2061 6374 6976 6520 7465 726d 696e or active termin │ │ │ │ │ -00029fe0: 616c 2066 726f 6d20 4649 4c45 2e20 2049 al from FILE. I │ │ │ │ │ -00029ff0: 6d61 6765 2069 730a 2020 2020 2073 7472 mage is. str │ │ │ │ │ -0002a000: 6574 6368 6564 2074 6f20 6669 6c6c 2075 etched to fill u │ │ │ │ │ -0002a010: 7020 656e 7469 7265 2073 6372 6565 6e20 p entire screen │ │ │ │ │ -0002a020: 756e 6c65 7373 206f 7074 696f 6e20 272d unless option '- │ │ │ │ │ -0002a030: 2d6d 6f64 6527 2027 6e6f 726d 616c 270a -mode' 'normal'. │ │ │ │ │ -0002a040: 2020 2020 2069 7320 6769 7665 6e2e 2020 is given. │ │ │ │ │ -0002a050: 5769 7468 6f75 7420 6172 6775 6d65 6e74 Without argument │ │ │ │ │ -0002a060: 7320 7265 6d6f 7665 2063 7572 7265 6e74 s remove current │ │ │ │ │ -0002a070: 6c79 206c 6f61 6465 6420 6261 636b 6772 ly loaded backgr │ │ │ │ │ -0002a080: 6f75 6e64 0a20 2020 2020 696d 6167 652e ound. image. │ │ │ │ │ -0002a090: 2020 4261 636b 6772 6f75 6e64 2069 6d61 Background ima │ │ │ │ │ -0002a0a0: 6765 2063 616e 2062 6520 6368 616e 6765 ge can be change │ │ │ │ │ -0002a0b0: 6420 6f6e 6c79 2077 6865 6e20 7573 696e d only when usin │ │ │ │ │ -0002a0c0: 6720 2767 6678 7465 726d 270a 2020 2020 g 'gfxterm'. │ │ │ │ │ -0002a0d0: 2066 6f72 2074 6572 6d69 6e61 6c20 6f75 for terminal ou │ │ │ │ │ -0002a0e0: 7470 7574 2e0a 0a1f 0a46 696c 653a 2067 tput.....File: g │ │ │ │ │ -0002a0f0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0002a100: 2062 6164 7261 6d2c 2020 4e65 7874 3a20 badram, Next: │ │ │ │ │ -0002a110: 626c 6f63 6b6c 6973 742c 2020 5072 6576 blocklist, Prev │ │ │ │ │ -0002a120: 3a20 6261 636b 6772 6f75 6e64 5f69 6d61 : background_ima │ │ │ │ │ -0002a130: 6765 2c20 2055 703a 2043 6f6d 6d61 6e64 ge, Up: Command │ │ │ │ │ -0002a140: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ -0002a150: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ -0002a160: 362e 332e 3620 6261 6472 616d 0a2d 2d2d 6.3.6 badram.--- │ │ │ │ │ -0002a170: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -0002a180: 436f 6d6d 616e 643a 2062 6164 7261 6d20 Command: badram │ │ │ │ │ -0002a190: 6164 6472 2c6d 6173 6b5b 2c61 6464 722c addr,mask[,addr, │ │ │ │ │ -0002a1a0: 6d61 736b 2e2e 2e5d 0a20 2020 2020 4669 mask...]. Fi │ │ │ │ │ -0002a1b0: 6c74 6572 206f 7574 2062 6164 2052 414d lter out bad RAM │ │ │ │ │ -0002a1c0: 2e0a 0a20 2020 2020 5468 6973 2063 6f6d ... This com │ │ │ │ │ -0002a1d0: 6d61 6e64 206e 6f74 6966 6965 7320 7468 mand notifies th │ │ │ │ │ -0002a1e0: 6520 6d65 6d6f 7279 206d 616e 6167 6572 e memory manager │ │ │ │ │ -0002a1f0: 2074 6861 7420 7370 6563 6966 6965 6420 that specified │ │ │ │ │ -0002a200: 7265 6769 6f6e 7320 6f66 0a20 2020 2020 regions of. │ │ │ │ │ -0002a210: 5241 4d20 6f75 6768 7420 746f 2062 6520 RAM ought to be │ │ │ │ │ -0002a220: 6669 6c74 6572 6564 206f 7574 2028 7573 filtered out (us │ │ │ │ │ -0002a230: 7561 6c6c 792c 2062 6563 6175 7365 2074 ually, because t │ │ │ │ │ -0002a240: 6865 7927 7265 2064 616d 6167 6564 292e hey're damaged). │ │ │ │ │ -0002a250: 0a20 2020 2020 5468 6973 2072 656d 6169 . This remai │ │ │ │ │ -0002a260: 6e73 2069 6e20 6566 6665 6374 2061 6674 ns in effect aft │ │ │ │ │ -0002a270: 6572 2061 2070 6179 6c6f 6164 206b 6572 er a payload ker │ │ │ │ │ -0002a280: 6e65 6c20 6861 7320 6265 656e 206c 6f61 nel has been loa │ │ │ │ │ -0002a290: 6465 6420 6279 0a20 2020 2020 4752 5542 ded by. GRUB │ │ │ │ │ -0002a2a0: 2c20 6173 206c 6f6e 6720 6173 2074 6865 , as long as the │ │ │ │ │ -0002a2b0: 206c 6f61 6465 6420 6b65 726e 656c 206f loaded kernel o │ │ │ │ │ -0002a2c0: 6274 6169 6e73 2069 7473 206d 656d 6f72 btains its memor │ │ │ │ │ -0002a2d0: 7920 6d61 7020 6672 6f6d 0a20 2020 2020 y map from. │ │ │ │ │ -0002a2e0: 4752 5542 2e20 4b65 726e 656c 7320 7468 GRUB. Kernels th │ │ │ │ │ -0002a2f0: 6174 2073 7570 706f 7274 2074 6869 7320 at support this │ │ │ │ │ -0002a300: 696e 636c 7564 6520 4c69 6e75 782c 2047 include Linux, G │ │ │ │ │ -0002a310: 4e55 204d 6163 682c 2074 6865 206b 6572 NU Mach, the ker │ │ │ │ │ -0002a320: 6e65 6c0a 2020 2020 206f 6620 4672 6565 nel. of Free │ │ │ │ │ -0002a330: 4253 4420 616e 6420 4d75 6c74 6962 6f6f BSD and Multiboo │ │ │ │ │ -0002a340: 7420 6b65 726e 656c 7320 696e 2067 656e t kernels in gen │ │ │ │ │ -0002a350: 6572 616c 2e0a 0a20 2020 2020 5379 6e74 eral... Synt │ │ │ │ │ -0002a360: 6178 2069 7320 7468 6520 7361 6d65 2061 ax is the same a │ │ │ │ │ -0002a370: 7320 7072 6f76 6964 6564 2062 7920 7468 s provided by th │ │ │ │ │ -0002a380: 6520 4d65 6d74 6573 7438 362b 2075 7469 e Memtest86+ uti │ │ │ │ │ -0002a390: 6c69 7479 0a20 2020 2020 2868 7474 703a lity. (http: │ │ │ │ │ -0002a3a0: 2f2f 7777 772e 6d65 6d74 6573 742e 6f72 //www.memtest.or │ │ │ │ │ -0002a3b0: 672f 293a 2061 206c 6973 7420 6f66 2061 g/): a list of a │ │ │ │ │ -0002a3c0: 6464 7265 7373 2f6d 6173 6b20 7061 6972 ddress/mask pair │ │ │ │ │ -0002a3d0: 732e 2020 4769 7665 6e20 610a 2020 2020 s. Given a. │ │ │ │ │ -0002a3e0: 2070 6167 652d 616c 6967 6e65 6420 6164 page-aligned ad │ │ │ │ │ -0002a3f0: 6472 6573 7320 616e 6420 6120 6261 7365 dress and a base │ │ │ │ │ -0002a400: 2061 6464 7265 7373 202f 206d 6173 6b20 address / mask │ │ │ │ │ -0002a410: 7061 6972 2c20 6966 2061 6c6c 2074 6865 pair, if all the │ │ │ │ │ -0002a420: 0a20 2020 2020 6269 7473 206f 6620 7468 . bits of th │ │ │ │ │ -0002a430: 6520 7061 6765 2d61 6c69 676e 6564 2061 e page-aligned a │ │ │ │ │ -0002a440: 6464 7265 7373 2074 6861 7420 6172 6520 ddress that are │ │ │ │ │ -0002a450: 656e 6162 6c65 6420 6279 2074 6865 206d enabled by the m │ │ │ │ │ -0002a460: 6173 6b20 6d61 7463 680a 2020 2020 2077 ask match. w │ │ │ │ │ -0002a470: 6974 6820 7468 6520 6261 7365 2061 6464 ith the base add │ │ │ │ │ -0002a480: 7265 7373 2c20 6974 206d 6561 6e73 2074 ress, it means t │ │ │ │ │ -0002a490: 6869 7320 7061 6765 2069 7320 746f 2062 his page is to b │ │ │ │ │ -0002a4a0: 6520 6669 6c74 6572 6564 2e20 2054 6869 e filtered. Thi │ │ │ │ │ -0002a4b0: 730a 2020 2020 2073 796e 7461 7820 6d61 s. syntax ma │ │ │ │ │ -0002a4c0: 6b65 7320 6974 2065 6173 7920 746f 2072 kes it easy to r │ │ │ │ │ -0002a4d0: 6570 7265 7365 6e74 2070 6174 7465 726e epresent pattern │ │ │ │ │ -0002a4e0: 7320 7468 6174 2061 7265 206f 6674 656e s that are often │ │ │ │ │ -0002a4f0: 2072 6573 756c 7420 6f66 0a20 2020 2020 result of. │ │ │ │ │ -0002a500: 6d65 6d6f 7279 2064 616d 6167 652c 2064 memory damage, d │ │ │ │ │ -0002a510: 7565 2074 6f20 7068 7973 6963 616c 2064 ue to physical d │ │ │ │ │ -0002a520: 6973 7472 6962 7574 696f 6e20 6f66 206d istribution of m │ │ │ │ │ -0002a530: 656d 6f72 7920 6365 6c6c 732e 0a0a 2020 emory cells... │ │ │ │ │ -0002a540: 2020 2054 6865 2063 6f6d 6d61 6e64 2069 The command i │ │ │ │ │ -0002a550: 7320 7369 6d69 6c61 7220 746f 2027 6375 s similar to 'cu │ │ │ │ │ -0002a560: 746d 656d 2720 636f 6d6d 616e 642e 0a0a tmem' command... │ │ │ │ │ -0002a570: 2020 2020 204e 6f74 653a 2054 6865 2063 Note: The c │ │ │ │ │ -0002a580: 6f6d 6d61 6e64 2069 7320 6e6f 7420 616c ommand is not al │ │ │ │ │ -0002a590: 6c6f 7765 6420 7768 656e 206c 6f63 6b64 lowed when lockd │ │ │ │ │ -0002a5a0: 6f77 6e20 6973 2065 6e66 6f72 6365 6420 own is enforced │ │ │ │ │ -0002a5b0: 282a 6e6f 7465 0a20 2020 2020 4c6f 636b (*note. Lock │ │ │ │ │ -0002a5c0: 646f 776e 3a3a 292e 2020 5468 6973 2070 down::). This p │ │ │ │ │ -0002a5d0: 7265 7665 6e74 7320 7265 6d6f 7669 6e67 revents removing │ │ │ │ │ -0002a5e0: 2045 4649 206d 656d 6f72 7920 7265 6769 EFI memory regi │ │ │ │ │ -0002a5f0: 6f6e 7320 746f 0a20 2020 2020 706f 7465 ons to. pote │ │ │ │ │ -0002a600: 6e74 6961 6c6c 7920 7375 6276 6572 7420 ntially subvert │ │ │ │ │ -0002a610: 7468 6520 7365 6375 7269 7479 206d 6563 the security mec │ │ │ │ │ -0002a620: 6861 6e69 736d 7320 7072 6f76 6964 6564 hanisms provided │ │ │ │ │ -0002a630: 2062 7920 7468 6520 5545 4649 0a20 2020 by the UEFI. │ │ │ │ │ -0002a640: 2020 7365 6375 7265 2062 6f6f 742e 0a0a secure boot... │ │ │ │ │ -0002a650: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -0002a660: 6f2c 2020 4e6f 6465 3a20 626c 6f63 6b6c o, Node: blockl │ │ │ │ │ -0002a670: 6973 742c 2020 4e65 7874 3a20 626f 6f74 ist, Next: boot │ │ │ │ │ -0002a680: 2c20 2050 7265 763a 2062 6164 7261 6d2c , Prev: badram, │ │ │ │ │ -0002a690: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ -0002a6a0: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ -0002a6b0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ -0002a6c0: 2e37 2062 6c6f 636b 6c69 7374 0a2d 2d2d .7 blocklist.--- │ │ │ │ │ -0002a6d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ -0002a6e0: 2d2d 2043 6f6d 6d61 6e64 3a20 626c 6f63 -- Command: bloc │ │ │ │ │ -0002a6f0: 6b6c 6973 7420 6669 6c65 0a20 2020 2020 klist file. │ │ │ │ │ -0002a700: 5072 696e 7420 6120 626c 6f63 6b20 6c69 Print a block li │ │ │ │ │ -0002a710: 7374 2028 2a6e 6f74 6520 426c 6f63 6b20 st (*note Block │ │ │ │ │ -0002a720: 6c69 7374 2073 796e 7461 783a 3a29 2066 list syntax::) f │ │ │ │ │ -0002a730: 6f72 2046 494c 452e 0a0a 1f0a 4669 6c65 or FILE.....File │ │ │ │ │ -0002a740: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -0002a750: 6465 3a20 626f 6f74 2c20 204e 6578 743a de: boot, Next: │ │ │ │ │ -0002a760: 2063 6174 2c20 2050 7265 763a 2062 6c6f cat, Prev: blo │ │ │ │ │ -0002a770: 636b 6c69 7374 2c20 2055 703a 2043 6f6d cklist, Up: Com │ │ │ │ │ -0002a780: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ -0002a790: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ -0002a7a0: 730a 0a31 362e 332e 3820 626f 6f74 0a2d s..16.3.8 boot.- │ │ │ │ │ -0002a7b0: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -0002a7c0: 436f 6d6d 616e 643a 2062 6f6f 740a 2020 Command: boot. │ │ │ │ │ -0002a7d0: 2020 2042 6f6f 7420 7468 6520 4f53 206f Boot the OS o │ │ │ │ │ -0002a7e0: 7220 6368 6169 6e2d 6c6f 6164 6572 2077 r chain-loader w │ │ │ │ │ -0002a7f0: 6869 6368 2068 6173 2062 6565 6e20 6c6f hich has been lo │ │ │ │ │ -0002a800: 6164 6564 2e20 204f 6e6c 7920 6e65 6365 aded. Only nece │ │ │ │ │ -0002a810: 7373 6172 790a 2020 2020 2069 6620 7275 ssary. if ru │ │ │ │ │ -0002a820: 6e6e 696e 6720 7468 6520 6675 6c6c 7920 nning the fully │ │ │ │ │ -0002a830: 696e 7465 7261 6374 6976 6520 636f 6d6d interactive comm │ │ │ │ │ -0002a840: 616e 642d 6c69 6e65 2028 6974 2069 7320 and-line (it is │ │ │ │ │ -0002a850: 696d 706c 6963 6974 2061 740a 2020 2020 implicit at. │ │ │ │ │ -0002a860: 2074 6865 2065 6e64 206f 6620 6120 6d65 the end of a me │ │ │ │ │ -0002a870: 6e75 2065 6e74 7279 292e 0a0a 1f0a 4669 nu entry).....Fi │ │ │ │ │ -0002a880: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -0002a890: 4e6f 6465 3a20 6361 742c 2020 4e65 7874 Node: cat, Next │ │ │ │ │ -0002a8a0: 3a20 6368 6169 6e6c 6f61 6465 722c 2020 : chainloader, │ │ │ │ │ -0002a8b0: 5072 6576 3a20 626f 6f74 2c20 2055 703a Prev: boot, Up: │ │ │ │ │ -0002a8c0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ -0002a8d0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ -0002a8e0: 6d61 6e64 730a 0a31 362e 332e 3920 6361 mands..16.3.9 ca │ │ │ │ │ -0002a8f0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d t.----------.. - │ │ │ │ │ -0002a900: 2d20 436f 6d6d 616e 643a 2063 6174 205b - Command: cat [ │ │ │ │ │ -0002a910: 2d2d 646f 735d 2066 696c 650a 2020 2020 --dos] file. │ │ │ │ │ -0002a920: 2044 6973 706c 6179 2074 6865 2063 6f6e Display the con │ │ │ │ │ -0002a930: 7465 6e74 7320 6f66 2074 6865 2066 696c tents of the fil │ │ │ │ │ -0002a940: 6520 4649 4c45 2e20 2054 6869 7320 636f e FILE. This co │ │ │ │ │ -0002a950: 6d6d 616e 6420 6d61 7920 6265 2075 7365 mmand may be use │ │ │ │ │ -0002a960: 6675 6c0a 2020 2020 2074 6f20 7265 6d69 ful. to remi │ │ │ │ │ -0002a970: 6e64 2079 6f75 206f 6620 796f 7572 204f nd you of your O │ │ │ │ │ -0002a980: 5327 7320 726f 6f74 2070 6172 7469 7469 S's root partiti │ │ │ │ │ -0002a990: 6f6e 3a0a 0a20 2020 2020 2020 2020 2067 on:.. g │ │ │ │ │ -0002a9a0: 7275 623e 2063 6174 202f 6574 632f 6673 rub> cat /etc/fs │ │ │ │ │ -0002a9b0: 7461 620a 0a20 2020 2020 4966 2074 6865 tab.. If the │ │ │ │ │ -0002a9c0: 2027 2d2d 646f 7327 206f 7074 696f 6e20 '--dos' option │ │ │ │ │ -0002a9d0: 6973 2075 7365 642c 2074 6865 6e20 6361 is used, then ca │ │ │ │ │ -0002a9e0: 7272 6961 6765 2072 6574 7572 6e20 2f20 rriage return / │ │ │ │ │ -0002a9f0: 6e65 7720 6c69 6e65 0a20 2020 2020 7061 new line. pa │ │ │ │ │ -0002aa00: 6972 7320 7769 6c6c 2062 6520 6469 7370 irs will be disp │ │ │ │ │ -0002aa10: 6c61 7965 6420 6173 2061 2073 696d 706c layed as a simpl │ │ │ │ │ -0002aa20: 6520 6e65 7720 6c69 6e65 2e20 204f 7468 e new line. Oth │ │ │ │ │ -0002aa30: 6572 7769 7365 2c20 7468 650a 2020 2020 erwise, the. │ │ │ │ │ -0002aa40: 2063 6172 7269 6167 6520 7265 7475 726e carriage return │ │ │ │ │ -0002aa50: 2077 696c 6c20 6265 2064 6973 706c 6179 will be display │ │ │ │ │ -0002aa60: 6564 2061 7320 6120 636f 6e74 726f 6c20 ed as a control │ │ │ │ │ -0002aa70: 6368 6172 6163 7465 7220 2827 3c64 3e27 character ('' │ │ │ │ │ -0002aa80: 2920 746f 0a20 2020 2020 6d61 6b65 2069 ) to. make i │ │ │ │ │ -0002aa90: 7420 6561 7369 6572 2074 6f20 7365 6520 t easier to see │ │ │ │ │ -0002aaa0: 7768 656e 2062 6f6f 7420 7072 6f62 6c65 when boot proble │ │ │ │ │ -0002aab0: 6d73 2061 7265 2063 6175 7365 6420 6279 ms are caused by │ │ │ │ │ -0002aac0: 2061 2066 696c 650a 2020 2020 2066 6f72 a file. for │ │ │ │ │ -0002aad0: 6d61 7474 6564 2075 7369 6e67 2044 4f53 matted using DOS │ │ │ │ │ -0002aae0: 2d73 7479 6c65 206c 696e 6520 656e 6469 -style line endi │ │ │ │ │ -0002aaf0: 6e67 732e 0a0a 1f0a 4669 6c65 3a20 6772 ngs.....File: gr │ │ │ │ │ -0002ab00: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -0002ab10: 6368 6169 6e6c 6f61 6465 722c 2020 4e65 chainloader, Ne │ │ │ │ │ -0002ab20: 7874 3a20 636c 6561 722c 2020 5072 6576 xt: clear, Prev │ │ │ │ │ -0002ab30: 3a20 6361 742c 2020 5570 3a20 436f 6d6d : cat, Up: Comm │ │ │ │ │ -0002ab40: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -0002ab50: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -0002ab60: 0a0a 3136 2e33 2e31 3020 6368 6169 6e6c ..16.3.10 chainl │ │ │ │ │ -0002ab70: 6f61 6465 720a 2d2d 2d2d 2d2d 2d2d 2d2d oader.---------- │ │ │ │ │ -0002ab80: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -0002ab90: 6f6d 6d61 6e64 3a20 6368 6169 6e6c 6f61 ommand: chainloa │ │ │ │ │ -0002aba0: 6465 7220 5b2d 2d66 6f72 6365 5d20 6669 der [--force] fi │ │ │ │ │ -0002abb0: 6c65 0a20 2020 2020 4c6f 6164 2046 494c le. Load FIL │ │ │ │ │ -0002abc0: 4520 6173 2061 2063 6861 696e 2d6c 6f61 E as a chain-loa │ │ │ │ │ -0002abd0: 6465 722e 2020 4c69 6b65 2061 6e79 206f der. Like any o │ │ │ │ │ -0002abe0: 7468 6572 2066 696c 6520 6c6f 6164 6564 ther file loaded │ │ │ │ │ -0002abf0: 2062 7920 7468 650a 2020 2020 2066 696c by the. fil │ │ │ │ │ -0002ac00: 6573 7973 7465 6d20 636f 6465 2c20 6974 esystem code, it │ │ │ │ │ -0002ac10: 2063 616e 2075 7365 2074 6865 2062 6c6f can use the blo │ │ │ │ │ -0002ac20: 636b 6c69 7374 206e 6f74 6174 696f 6e20 cklist notation │ │ │ │ │ -0002ac30: 282a 6e6f 7465 2042 6c6f 636b 0a20 2020 (*note Block. │ │ │ │ │ -0002ac40: 2020 6c69 7374 2073 796e 7461 783a 3a29 list syntax::) │ │ │ │ │ -0002ac50: 2074 6f20 6772 6162 2074 6865 2066 6972 to grab the fir │ │ │ │ │ -0002ac60: 7374 2073 6563 746f 7220 6f66 2074 6865 st sector of the │ │ │ │ │ -0002ac70: 2063 7572 7265 6e74 2070 6172 7469 7469 current partiti │ │ │ │ │ -0002ac80: 6f6e 0a20 2020 2020 7769 7468 2027 2b31 on. with '+1 │ │ │ │ │ -0002ac90: 272e 2020 4966 2079 6f75 2073 7065 6369 '. If you speci │ │ │ │ │ -0002aca0: 6679 2074 6865 206f 7074 696f 6e20 272d fy the option '- │ │ │ │ │ -0002acb0: 2d66 6f72 6365 272c 2074 6865 6e20 6c6f -force', then lo │ │ │ │ │ -0002acc0: 6164 2046 494c 450a 2020 2020 2066 6f72 ad FILE. for │ │ │ │ │ -0002acd0: 6369 626c 792c 2077 6865 7468 6572 2069 cibly, whether i │ │ │ │ │ -0002ace0: 7420 6861 7320 6120 636f 7272 6563 7420 t has a correct │ │ │ │ │ -0002acf0: 7369 676e 6174 7572 6520 6f72 206e 6f74 signature or not │ │ │ │ │ -0002ad00: 2e20 2054 6869 7320 6973 0a20 2020 2020 . This is. │ │ │ │ │ -0002ad10: 7265 7175 6972 6564 2077 6865 6e20 796f required when yo │ │ │ │ │ -0002ad20: 7520 7761 6e74 2074 6f20 6c6f 6164 2061 u want to load a │ │ │ │ │ -0002ad30: 2064 6566 6563 7469 7665 2062 6f6f 7420 defective boot │ │ │ │ │ -0002ad40: 6c6f 6164 6572 2c20 7375 6368 2061 7320 loader, such as │ │ │ │ │ -0002ad50: 5343 4f0a 2020 2020 2055 6e69 7857 6172 SCO. UnixWar │ │ │ │ │ -0002ad60: 6520 372e 312e 0a0a 1f0a 4669 6c65 3a20 e 7.1.....File: │ │ │ │ │ -0002ad70: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -0002ad80: 3a20 636c 6561 722c 2020 4e65 7874 3a20 : clear, Next: │ │ │ │ │ -0002ad90: 636d 6f73 636c 6561 6e2c 2020 5072 6576 cmosclean, Prev │ │ │ │ │ -0002ada0: 3a20 6368 6169 6e6c 6f61 6465 722c 2020 : chainloader, │ │ │ │ │ -0002adb0: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ -0002adc0: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ -0002add0: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e31 commands..16.3.1 │ │ │ │ │ -0002ade0: 3120 636c 6561 720a 2d2d 2d2d 2d2d 2d2d 1 clear.-------- │ │ │ │ │ -0002adf0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -0002ae00: 6e64 3a20 636c 6561 720a 2020 2020 2043 nd: clear. C │ │ │ │ │ -0002ae10: 6c65 6172 2074 6865 2073 6372 6565 6e2e lear the screen. │ │ │ │ │ -0002ae20: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -0002ae30: 6e66 6f2c 2020 4e6f 6465 3a20 636d 6f73 nfo, Node: cmos │ │ │ │ │ -0002ae40: 636c 6561 6e2c 2020 4e65 7874 3a20 636d clean, Next: cm │ │ │ │ │ -0002ae50: 6f73 6475 6d70 2c20 2050 7265 763a 2063 osdump, Prev: c │ │ │ │ │ -0002ae60: 6c65 6172 2c20 2055 703a 2043 6f6d 6d61 lear, Up: Comma │ │ │ │ │ -0002ae70: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -0002ae80: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ -0002ae90: 0a31 362e 332e 3132 2063 6d6f 7363 6c65 .16.3.12 cmoscle │ │ │ │ │ -0002aea0: 616e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d an.------------- │ │ │ │ │ -0002aeb0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -0002aec0: 643a 2063 6d6f 7363 6c65 616e 2062 7974 d: cmosclean byt │ │ │ │ │ -0002aed0: 653a 6269 740a 2020 2020 2043 6c65 6172 e:bit. Clear │ │ │ │ │ -0002aee0: 2076 616c 7565 206f 6620 6269 7420 696e value of bit in │ │ │ │ │ -0002aef0: 2043 4d4f 5320 6174 206c 6f63 6174 696f CMOS at locatio │ │ │ │ │ -0002af00: 6e20 4259 5445 3a42 4954 2e20 2054 6869 n BYTE:BIT. Thi │ │ │ │ │ -0002af10: 7320 636f 6d6d 616e 6420 6973 0a20 2020 s command is. │ │ │ │ │ -0002af20: 2020 6176 6169 6c61 626c 6520 6f6e 6c79 available only │ │ │ │ │ -0002af30: 206f 6e20 706c 6174 666f 726d 7320 7468 on platforms th │ │ │ │ │ -0002af40: 6174 2073 7570 706f 7274 2043 4d4f 532e at support CMOS. │ │ │ │ │ -0002af50: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -0002af60: 6e66 6f2c 2020 4e6f 6465 3a20 636d 6f73 nfo, Node: cmos │ │ │ │ │ -0002af70: 6475 6d70 2c20 204e 6578 743a 2063 6d6f dump, Next: cmo │ │ │ │ │ -0002af80: 7374 6573 742c 2020 5072 6576 3a20 636d stest, Prev: cm │ │ │ │ │ -0002af90: 6f73 636c 6561 6e2c 2020 5570 3a20 436f osclean, Up: Co │ │ │ │ │ -0002afa0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -0002afb0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -0002afc0: 6473 0a0a 3136 2e33 2e31 3320 636d 6f73 ds..16.3.13 cmos │ │ │ │ │ -0002afd0: 6475 6d70 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d dump.----------- │ │ │ │ │ -0002afe0: 2d2d 2d2d 2d0a 0a20 2d2d 2044 756d 703a -----.. -- Dump: │ │ │ │ │ -0002aff0: 2043 4d4f 5320 636f 6e74 656e 7473 0a20 CMOS contents. │ │ │ │ │ -0002b000: 2020 2020 4475 6d70 2066 756c 6c20 434d Dump full CM │ │ │ │ │ -0002b010: 4f53 2063 6f6e 7465 6e74 7320 6173 2068 OS contents as h │ │ │ │ │ -0002b020: 6578 6164 6563 696d 616c 2076 616c 7565 exadecimal value │ │ │ │ │ -0002b030: 732e 2020 5468 6973 2063 6f6d 6d61 6e64 s. This command │ │ │ │ │ -0002b040: 2069 730a 2020 2020 2061 7661 696c 6162 is. availab │ │ │ │ │ -0002b050: 6c65 206f 6e6c 7920 6f6e 2070 6c61 7466 le only on platf │ │ │ │ │ -0002b060: 6f72 6d73 2074 6861 7420 7375 7070 6f72 orms that suppor │ │ │ │ │ -0002b070: 7420 434d 4f53 2e0a 0a1f 0a46 696c 653a t CMOS.....File: │ │ │ │ │ -0002b080: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -0002b090: 653a 2063 6d6f 7374 6573 742c 2020 4e65 e: cmostest, Ne │ │ │ │ │ -0002b0a0: 7874 3a20 636d 702c 2020 5072 6576 3a20 xt: cmp, Prev: │ │ │ │ │ -0002b0b0: 636d 6f73 6475 6d70 2c20 2055 703a 2043 cmosdump, Up: C │ │ │ │ │ -0002b0c0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ -0002b0d0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ -0002b0e0: 6e64 730a 0a31 362e 332e 3134 2063 6d6f nds..16.3.14 cmo │ │ │ │ │ -0002b0f0: 7374 6573 740a 2d2d 2d2d 2d2d 2d2d 2d2d stest.---------- │ │ │ │ │ -0002b100: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -0002b110: 616e 643a 2063 6d6f 7374 6573 7420 6279 and: cmostest by │ │ │ │ │ -0002b120: 7465 3a62 6974 0a20 2020 2020 5465 7374 te:bit. Test │ │ │ │ │ -0002b130: 2076 616c 7565 206f 6620 6269 7420 696e value of bit in │ │ │ │ │ -0002b140: 2043 4d4f 5320 6174 206c 6f63 6174 696f CMOS at locatio │ │ │ │ │ -0002b150: 6e20 4259 5445 3a42 4954 2e20 2045 7869 n BYTE:BIT. Exi │ │ │ │ │ -0002b160: 7420 7374 6174 7573 2069 730a 2020 2020 t status is. │ │ │ │ │ -0002b170: 207a 6572 6f20 6966 2062 6974 2069 7320 zero if bit is │ │ │ │ │ -0002b180: 7365 742c 206e 6f6e 207a 6572 6f20 6f74 set, non zero ot │ │ │ │ │ -0002b190: 6865 7277 6973 652e 2020 5468 6973 2063 herwise. This c │ │ │ │ │ -0002b1a0: 6f6d 6d61 6e64 2069 7320 6176 6169 6c61 ommand is availa │ │ │ │ │ -0002b1b0: 626c 650a 2020 2020 206f 6e6c 7920 6f6e ble. only on │ │ │ │ │ -0002b1c0: 2070 6c61 7466 6f72 6d73 2074 6861 7420 platforms that │ │ │ │ │ -0002b1d0: 7375 7070 6f72 7420 434d 4f53 2e0a 0a1f support CMOS.... │ │ │ │ │ -0002b1e0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -0002b1f0: 2c20 204e 6f64 653a 2063 6d70 2c20 204e , Node: cmp, N │ │ │ │ │ -0002b200: 6578 743a 2063 6f6e 6669 6766 696c 652c ext: configfile, │ │ │ │ │ -0002b210: 2020 5072 6576 3a20 636d 6f73 7465 7374 Prev: cmostest │ │ │ │ │ -0002b220: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -0002b230: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -0002b240: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -0002b250: 332e 3135 2063 6d70 0a2d 2d2d 2d2d 2d2d 3.15 cmp.------- │ │ │ │ │ -0002b260: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -0002b270: 643a 2063 6d70 2066 696c 6531 2066 696c d: cmp file1 fil │ │ │ │ │ -0002b280: 6532 0a20 2020 2020 436f 6d70 6172 6520 e2. Compare │ │ │ │ │ -0002b290: 7468 6520 6669 6c65 2046 494c 4531 2077 the file FILE1 w │ │ │ │ │ -0002b2a0: 6974 6820 7468 6520 6669 6c65 2046 494c ith the file FIL │ │ │ │ │ -0002b2b0: 4532 2e20 2049 6620 7468 6579 2064 6966 E2. If they dif │ │ │ │ │ -0002b2c0: 6665 7220 696e 0a20 2020 2020 7369 7a65 fer in. size │ │ │ │ │ -0002b2d0: 2c20 7072 696e 7420 7468 6520 7369 7a65 , print the size │ │ │ │ │ -0002b2e0: 7320 6c69 6b65 2074 6869 733a 0a0a 2020 s like this:.. │ │ │ │ │ -0002b2f0: 2020 2020 2020 2020 4469 6666 6572 2069 Differ i │ │ │ │ │ -0002b300: 6e20 7369 7a65 3a20 3078 3132 3334 205b n size: 0x1234 [ │ │ │ │ │ -0002b310: 666f 6f5d 2c20 3078 3433 3231 205b 6261 foo], 0x4321 [ba │ │ │ │ │ -0002b320: 725d 0a0a 2020 2020 2049 6620 7468 6520 r].. If the │ │ │ │ │ -0002b330: 7369 7a65 7320 6172 6520 6571 7561 6c20 sizes are equal │ │ │ │ │ -0002b340: 6275 7420 7468 6520 6279 7465 7320 6174 but the bytes at │ │ │ │ │ -0002b350: 2061 6e20 6f66 6673 6574 2064 6966 6665 an offset diffe │ │ │ │ │ -0002b360: 722c 2074 6865 6e0a 2020 2020 2070 7269 r, then. pri │ │ │ │ │ -0002b370: 6e74 2074 6865 2062 7974 6573 206c 696b nt the bytes lik │ │ │ │ │ -0002b380: 6520 7468 6973 3a0a 0a20 2020 2020 2020 e this:.. │ │ │ │ │ -0002b390: 2020 2044 6966 6665 7220 6174 2074 6865 Differ at the │ │ │ │ │ -0002b3a0: 206f 6666 7365 7420 3737 373a 2030 7862 offset 777: 0xb │ │ │ │ │ -0002b3b0: 6520 5b66 6f6f 5d2c 2030 7865 6620 5b62 e [foo], 0xef [b │ │ │ │ │ -0002b3c0: 6172 5d0a 0a20 2020 2020 4966 2074 6865 ar].. If the │ │ │ │ │ -0002b3d0: 7920 6172 6520 636f 6d70 6c65 7465 6c79 y are completely │ │ │ │ │ -0002b3e0: 2069 6465 6e74 6963 616c 2c20 6e6f 7468 identical, noth │ │ │ │ │ -0002b3f0: 696e 6720 7769 6c6c 2062 6520 7072 696e ing will be prin │ │ │ │ │ -0002b400: 7465 642e 0a0a 1f0a 4669 6c65 3a20 6772 ted.....File: gr │ │ │ │ │ -0002b410: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -0002b420: 636f 6e66 6967 6669 6c65 2c20 204e 6578 configfile, Nex │ │ │ │ │ -0002b430: 743a 2063 7075 6964 2c20 2050 7265 763a t: cpuid, Prev: │ │ │ │ │ -0002b440: 2063 6d70 2c20 2055 703a 2043 6f6d 6d61 cmp, Up: Comma │ │ │ │ │ -0002b450: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -0002b460: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ -0002b470: 0a31 362e 332e 3136 2063 6f6e 6669 6766 .16.3.16 configf │ │ │ │ │ -0002b480: 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ile.------------ │ │ │ │ │ -0002b490: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -0002b4a0: 616e 643a 2063 6f6e 6669 6766 696c 6520 and: configfile │ │ │ │ │ -0002b4b0: 6669 6c65 0a20 2020 2020 4c6f 6164 2046 file. Load F │ │ │ │ │ -0002b4c0: 494c 4520 6173 2061 2063 6f6e 6669 6775 ILE as a configu │ │ │ │ │ -0002b4d0: 7261 7469 6f6e 2066 696c 652e 2020 4966 ration file. If │ │ │ │ │ -0002b4e0: 2046 494c 4520 6465 6669 6e65 7320 616e FILE defines an │ │ │ │ │ -0002b4f0: 7920 6d65 6e75 0a20 2020 2020 656e 7472 y menu. entr │ │ │ │ │ -0002b500: 6965 732c 2074 6865 6e20 7368 6f77 2061 ies, then show a │ │ │ │ │ -0002b510: 206d 656e 7520 636f 6e74 6169 6e69 6e67 menu containing │ │ │ │ │ -0002b520: 2074 6865 6d20 696d 6d65 6469 6174 656c them immediatel │ │ │ │ │ -0002b530: 792e 2020 416e 790a 2020 2020 2065 6e76 y. Any. env │ │ │ │ │ -0002b540: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -0002b550: 6520 6368 616e 6765 7320 6d61 6465 2062 e changes made b │ │ │ │ │ -0002b560: 7920 7468 6520 636f 6d6d 616e 6473 2069 y the commands i │ │ │ │ │ -0002b570: 6e20 4649 4c45 2077 696c 6c20 6e6f 740a n FILE will not. │ │ │ │ │ -0002b580: 2020 2020 2062 6520 7072 6573 6572 7665 be preserve │ │ │ │ │ -0002b590: 6420 6166 7465 7220 2763 6f6e 6669 6766 d after 'configf │ │ │ │ │ -0002b5a0: 696c 6527 2072 6574 7572 6e73 2e0a 0a1f ile' returns.... │ │ │ │ │ -0002b5b0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -0002b5c0: 2c20 204e 6f64 653a 2063 7075 6964 2c20 , Node: cpuid, │ │ │ │ │ -0002b5d0: 204e 6578 743a 2063 7263 2c20 2050 7265 Next: crc, Pre │ │ │ │ │ -0002b5e0: 763a 2063 6f6e 6669 6766 696c 652c 2020 v: configfile, │ │ │ │ │ -0002b5f0: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ -0002b600: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ -0002b610: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e31 commands..16.3.1 │ │ │ │ │ -0002b620: 3720 6370 7569 640a 2d2d 2d2d 2d2d 2d2d 7 cpuid.-------- │ │ │ │ │ -0002b630: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -0002b640: 6e64 3a20 6370 7569 6420 5b2d 6c5d 205b nd: cpuid [-l] [ │ │ │ │ │ -0002b650: 2d70 5d0a 2020 2020 2043 6865 636b 2066 -p]. Check f │ │ │ │ │ -0002b660: 6f72 2043 5055 2066 6561 7475 7265 732e or CPU features. │ │ │ │ │ -0002b670: 2020 5468 6973 2063 6f6d 6d61 6e64 2069 This command i │ │ │ │ │ -0002b680: 7320 6f6e 6c79 2061 7661 696c 6162 6c65 s only available │ │ │ │ │ -0002b690: 206f 6e20 7838 360a 2020 2020 2073 7973 on x86. sys │ │ │ │ │ -0002b6a0: 7465 6d73 2e0a 0a20 2020 2020 5769 7468 tems... With │ │ │ │ │ -0002b6b0: 2074 6865 2027 2d6c 2720 6f70 7469 6f6e the '-l' option │ │ │ │ │ -0002b6c0: 2c20 7265 7475 726e 2074 7275 6520 6966 , return true if │ │ │ │ │ -0002b6d0: 2074 6865 2043 5055 2073 7570 706f 7274 the CPU support │ │ │ │ │ -0002b6e0: 7320 6c6f 6e67 206d 6f64 650a 2020 2020 s long mode. │ │ │ │ │ -0002b6f0: 2028 3634 2d62 6974 292e 0a0a 2020 2020 (64-bit)... │ │ │ │ │ -0002b700: 2057 6974 6820 7468 6520 272d 7027 206f With the '-p' o │ │ │ │ │ -0002b710: 7074 696f 6e2c 2072 6574 7572 6e20 7472 ption, return tr │ │ │ │ │ -0002b720: 7565 2069 6620 7468 6520 4350 5520 7375 ue if the CPU su │ │ │ │ │ -0002b730: 7070 6f72 7473 2050 6879 7369 6361 6c0a pports Physical. │ │ │ │ │ -0002b740: 2020 2020 2041 6464 7265 7373 2045 7874 Address Ext │ │ │ │ │ -0002b750: 656e 7369 6f6e 2028 5041 4529 2e0a 0a20 ension (PAE)... │ │ │ │ │ -0002b760: 2020 2020 4966 2069 6e76 6f6b 6564 2077 If invoked w │ │ │ │ │ -0002b770: 6974 686f 7574 206f 7074 696f 6e73 2c20 ithout options, │ │ │ │ │ -0002b780: 7468 6973 2063 6f6d 6d61 6e64 2063 7572 this command cur │ │ │ │ │ -0002b790: 7265 6e74 6c79 2062 6568 6176 6573 2061 rently behaves a │ │ │ │ │ -0002b7a0: 7320 6966 2069 740a 2020 2020 2068 6164 s if it. had │ │ │ │ │ -0002b7b0: 2062 6565 6e20 696e 766f 6b65 6420 7769 been invoked wi │ │ │ │ │ -0002b7c0: 7468 2027 2d6c 272e 2020 5468 6973 206d th '-l'. This m │ │ │ │ │ -0002b7d0: 6179 2063 6861 6e67 6520 696e 2074 6865 ay change in the │ │ │ │ │ -0002b7e0: 2066 7574 7572 652e 0a0a 1f0a 4669 6c65 future.....File │ │ │ │ │ -0002b7f0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -0002b800: 6465 3a20 6372 632c 2020 4e65 7874 3a20 de: crc, Next: │ │ │ │ │ -0002b810: 6372 7970 746f 6d6f 756e 742c 2020 5072 cryptomount, Pr │ │ │ │ │ -0002b820: 6576 3a20 6370 7569 642c 2020 5570 3a20 ev: cpuid, Up: │ │ │ │ │ -0002b830: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -0002b840: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -0002b850: 616e 6473 0a0a 3136 2e33 2e31 3820 6372 ands..16.3.18 cr │ │ │ │ │ -0002b860: 630a 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 c.-----------.. │ │ │ │ │ -0002b870: 2d2d 2043 6f6d 6d61 6e64 3a20 6372 6320 -- Command: crc │ │ │ │ │ -0002b880: 6172 6720 2e2e 2e0a 2020 2020 2041 6c69 arg .... Ali │ │ │ │ │ -0002b890: 6173 2066 6f72 2027 6861 7368 7375 6d20 as for 'hashsum │ │ │ │ │ -0002b8a0: 2d2d 6861 7368 2063 7263 3332 2061 7267 --hash crc32 arg │ │ │ │ │ -0002b8b0: 202e 2e2e 272e 2020 5365 6520 636f 6d6d ...'. See comm │ │ │ │ │ -0002b8c0: 616e 6420 2768 6173 6873 756d 270a 2020 and 'hashsum'. │ │ │ │ │ -0002b8d0: 2020 2028 2a6e 6f74 6520 6861 7368 7375 (*note hashsu │ │ │ │ │ -0002b8e0: 6d3a 3a29 2066 6f72 2066 756c 6c20 6465 m::) for full de │ │ │ │ │ -0002b8f0: 7363 7269 7074 696f 6e2e 0a0a 1f0a 4669 scription.....Fi │ │ │ │ │ -0002b900: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -0002b910: 4e6f 6465 3a20 6372 7970 746f 6d6f 756e Node: cryptomoun │ │ │ │ │ -0002b920: 742c 2020 4e65 7874 3a20 6375 746d 656d t, Next: cutmem │ │ │ │ │ -0002b930: 2c20 2050 7265 763a 2063 7263 2c20 2055 , Prev: crc, U │ │ │ │ │ -0002b940: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -0002b950: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -0002b960: 6f6d 6d61 6e64 730a 0a31 362e 332e 3139 ommands..16.3.19 │ │ │ │ │ -0002b970: 2063 7279 7074 6f6d 6f75 6e74 0a2d 2d2d cryptomount.--- │ │ │ │ │ +00029f70: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +00029f80: 6d61 6e64 3a20 6261 636b 6772 6f75 6e64 mand: background │ │ │ │ │ +00029f90: 5f69 6d61 6765 205b 5b2d 2d6d 6f64 6520 _image [[--mode │ │ │ │ │ +00029fa0: 7374 7265 7463 687c 6e6f 726d 616c 5d20 stretch|normal] │ │ │ │ │ +00029fb0: 6669 6c65 5d0a 2020 2020 204c 6f61 6420 file]. Load │ │ │ │ │ +00029fc0: 6261 636b 6772 6f75 6e64 2069 6d61 6765 background image │ │ │ │ │ +00029fd0: 2066 6f72 2061 6374 6976 6520 7465 726d for active term │ │ │ │ │ +00029fe0: 696e 616c 2066 726f 6d20 4649 4c45 2e20 inal from FILE. │ │ │ │ │ +00029ff0: 2049 6d61 6765 2069 730a 2020 2020 2073 Image is. s │ │ │ │ │ +0002a000: 7472 6574 6368 6564 2074 6f20 6669 6c6c tretched to fill │ │ │ │ │ +0002a010: 2075 7020 656e 7469 7265 2073 6372 6565 up entire scree │ │ │ │ │ +0002a020: 6e20 756e 6c65 7373 206f 7074 696f 6e20 n unless option │ │ │ │ │ +0002a030: 272d 2d6d 6f64 6527 2027 6e6f 726d 616c '--mode' 'normal │ │ │ │ │ +0002a040: 270a 2020 2020 2069 7320 6769 7665 6e2e '. is given. │ │ │ │ │ +0002a050: 2020 5769 7468 6f75 7420 6172 6775 6d65 Without argume │ │ │ │ │ +0002a060: 6e74 7320 7265 6d6f 7665 2063 7572 7265 nts remove curre │ │ │ │ │ +0002a070: 6e74 6c79 206c 6f61 6465 6420 6261 636b ntly loaded back │ │ │ │ │ +0002a080: 6772 6f75 6e64 0a20 2020 2020 696d 6167 ground. imag │ │ │ │ │ +0002a090: 652e 2020 4261 636b 6772 6f75 6e64 2069 e. Background i │ │ │ │ │ +0002a0a0: 6d61 6765 2063 616e 2062 6520 6368 616e mage can be chan │ │ │ │ │ +0002a0b0: 6765 6420 6f6e 6c79 2077 6865 6e20 7573 ged only when us │ │ │ │ │ +0002a0c0: 696e 6720 2767 6678 7465 726d 270a 2020 ing 'gfxterm'. │ │ │ │ │ +0002a0d0: 2020 2066 6f72 2074 6572 6d69 6e61 6c20 for terminal │ │ │ │ │ +0002a0e0: 6f75 7470 7574 2e0a 0a1f 0a46 696c 653a output.....File: │ │ │ │ │ +0002a0f0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002a100: 653a 2062 6164 7261 6d2c 2020 4e65 7874 e: badram, Next │ │ │ │ │ +0002a110: 3a20 626c 6f63 6b6c 6973 742c 2020 5072 : blocklist, Pr │ │ │ │ │ +0002a120: 6576 3a20 6261 636b 6772 6f75 6e64 5f69 ev: background_i │ │ │ │ │ +0002a130: 6d61 6765 2c20 2055 703a 2043 6f6d 6d61 mage, Up: Comma │ │ │ │ │ +0002a140: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ +0002a150: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ +0002a160: 0a31 362e 332e 3620 6261 6472 616d 0a2d .16.3.6 badram.- │ │ │ │ │ +0002a170: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ +0002a180: 2d20 436f 6d6d 616e 643a 2062 6164 7261 - Command: badra │ │ │ │ │ +0002a190: 6d20 6164 6472 2c6d 6173 6b5b 2c61 6464 m addr,mask[,add │ │ │ │ │ +0002a1a0: 722c 6d61 736b 2e2e 2e5d 0a20 2020 2020 r,mask...]. │ │ │ │ │ +0002a1b0: 4669 6c74 6572 206f 7574 2062 6164 2052 Filter out bad R │ │ │ │ │ +0002a1c0: 414d 2e0a 0a20 2020 2020 5468 6973 2063 AM... This c │ │ │ │ │ +0002a1d0: 6f6d 6d61 6e64 206e 6f74 6966 6965 7320 ommand notifies │ │ │ │ │ +0002a1e0: 7468 6520 6d65 6d6f 7279 206d 616e 6167 the memory manag │ │ │ │ │ +0002a1f0: 6572 2074 6861 7420 7370 6563 6966 6965 er that specifie │ │ │ │ │ +0002a200: 6420 7265 6769 6f6e 7320 6f66 0a20 2020 d regions of. │ │ │ │ │ +0002a210: 2020 5241 4d20 6f75 6768 7420 746f 2062 RAM ought to b │ │ │ │ │ +0002a220: 6520 6669 6c74 6572 6564 206f 7574 2028 e filtered out ( │ │ │ │ │ +0002a230: 7573 7561 6c6c 792c 2062 6563 6175 7365 usually, because │ │ │ │ │ +0002a240: 2074 6865 7927 7265 2064 616d 6167 6564 they're damaged │ │ │ │ │ +0002a250: 292e 0a20 2020 2020 5468 6973 2072 656d ).. This rem │ │ │ │ │ +0002a260: 6169 6e73 2069 6e20 6566 6665 6374 2061 ains in effect a │ │ │ │ │ +0002a270: 6674 6572 2061 2070 6179 6c6f 6164 206b fter a payload k │ │ │ │ │ +0002a280: 6572 6e65 6c20 6861 7320 6265 656e 206c ernel has been l │ │ │ │ │ +0002a290: 6f61 6465 6420 6279 0a20 2020 2020 4752 oaded by. GR │ │ │ │ │ +0002a2a0: 5542 2c20 6173 206c 6f6e 6720 6173 2074 UB, as long as t │ │ │ │ │ +0002a2b0: 6865 206c 6f61 6465 6420 6b65 726e 656c he loaded kernel │ │ │ │ │ +0002a2c0: 206f 6274 6169 6e73 2069 7473 206d 656d obtains its mem │ │ │ │ │ +0002a2d0: 6f72 7920 6d61 7020 6672 6f6d 0a20 2020 ory map from. │ │ │ │ │ +0002a2e0: 2020 4752 5542 2e20 4b65 726e 656c 7320 GRUB. Kernels │ │ │ │ │ +0002a2f0: 7468 6174 2073 7570 706f 7274 2074 6869 that support thi │ │ │ │ │ +0002a300: 7320 696e 636c 7564 6520 4c69 6e75 782c s include Linux, │ │ │ │ │ +0002a310: 2047 4e55 204d 6163 682c 2074 6865 206b GNU Mach, the k │ │ │ │ │ +0002a320: 6572 6e65 6c0a 2020 2020 206f 6620 4672 ernel. of Fr │ │ │ │ │ +0002a330: 6565 4253 4420 616e 6420 4d75 6c74 6962 eeBSD and Multib │ │ │ │ │ +0002a340: 6f6f 7420 6b65 726e 656c 7320 696e 2067 oot kernels in g │ │ │ │ │ +0002a350: 656e 6572 616c 2e0a 0a20 2020 2020 5379 eneral... Sy │ │ │ │ │ +0002a360: 6e74 6178 2069 7320 7468 6520 7361 6d65 ntax is the same │ │ │ │ │ +0002a370: 2061 7320 7072 6f76 6964 6564 2062 7920 as provided by │ │ │ │ │ +0002a380: 7468 6520 4d65 6d74 6573 7438 362b 2075 the Memtest86+ u │ │ │ │ │ +0002a390: 7469 6c69 7479 0a20 2020 2020 2868 7474 tility. (htt │ │ │ │ │ +0002a3a0: 703a 2f2f 7777 772e 6d65 6d74 6573 742e p://www.memtest. │ │ │ │ │ +0002a3b0: 6f72 672f 293a 2061 206c 6973 7420 6f66 org/): a list of │ │ │ │ │ +0002a3c0: 2061 6464 7265 7373 2f6d 6173 6b20 7061 address/mask pa │ │ │ │ │ +0002a3d0: 6972 732e 2020 4769 7665 6e20 610a 2020 irs. Given a. │ │ │ │ │ +0002a3e0: 2020 2070 6167 652d 616c 6967 6e65 6420 page-aligned │ │ │ │ │ +0002a3f0: 6164 6472 6573 7320 616e 6420 6120 6261 address and a ba │ │ │ │ │ +0002a400: 7365 2061 6464 7265 7373 202f 206d 6173 se address / mas │ │ │ │ │ +0002a410: 6b20 7061 6972 2c20 6966 2061 6c6c 2074 k pair, if all t │ │ │ │ │ +0002a420: 6865 0a20 2020 2020 6269 7473 206f 6620 he. bits of │ │ │ │ │ +0002a430: 7468 6520 7061 6765 2d61 6c69 676e 6564 the page-aligned │ │ │ │ │ +0002a440: 2061 6464 7265 7373 2074 6861 7420 6172 address that ar │ │ │ │ │ +0002a450: 6520 656e 6162 6c65 6420 6279 2074 6865 e enabled by the │ │ │ │ │ +0002a460: 206d 6173 6b20 6d61 7463 680a 2020 2020 mask match. │ │ │ │ │ +0002a470: 2077 6974 6820 7468 6520 6261 7365 2061 with the base a │ │ │ │ │ +0002a480: 6464 7265 7373 2c20 6974 206d 6561 6e73 ddress, it means │ │ │ │ │ +0002a490: 2074 6869 7320 7061 6765 2069 7320 746f this page is to │ │ │ │ │ +0002a4a0: 2062 6520 6669 6c74 6572 6564 2e20 2054 be filtered. T │ │ │ │ │ +0002a4b0: 6869 730a 2020 2020 2073 796e 7461 7820 his. syntax │ │ │ │ │ +0002a4c0: 6d61 6b65 7320 6974 2065 6173 7920 746f makes it easy to │ │ │ │ │ +0002a4d0: 2072 6570 7265 7365 6e74 2070 6174 7465 represent patte │ │ │ │ │ +0002a4e0: 726e 7320 7468 6174 2061 7265 206f 6674 rns that are oft │ │ │ │ │ +0002a4f0: 656e 2072 6573 756c 7420 6f66 0a20 2020 en result of. │ │ │ │ │ +0002a500: 2020 6d65 6d6f 7279 2064 616d 6167 652c memory damage, │ │ │ │ │ +0002a510: 2064 7565 2074 6f20 7068 7973 6963 616c due to physical │ │ │ │ │ +0002a520: 2064 6973 7472 6962 7574 696f 6e20 6f66 distribution of │ │ │ │ │ +0002a530: 206d 656d 6f72 7920 6365 6c6c 732e 0a0a memory cells... │ │ │ │ │ +0002a540: 2020 2020 2054 6865 2063 6f6d 6d61 6e64 The command │ │ │ │ │ +0002a550: 2069 7320 7369 6d69 6c61 7220 746f 2027 is similar to ' │ │ │ │ │ +0002a560: 6375 746d 656d 2720 636f 6d6d 616e 642e cutmem' command. │ │ │ │ │ +0002a570: 0a0a 2020 2020 204e 6f74 653a 2054 6865 .. Note: The │ │ │ │ │ +0002a580: 2063 6f6d 6d61 6e64 2069 7320 6e6f 7420 command is not │ │ │ │ │ +0002a590: 616c 6c6f 7765 6420 7768 656e 206c 6f63 allowed when loc │ │ │ │ │ +0002a5a0: 6b64 6f77 6e20 6973 2065 6e66 6f72 6365 kdown is enforce │ │ │ │ │ +0002a5b0: 6420 282a 6e6f 7465 0a20 2020 2020 4c6f d (*note. Lo │ │ │ │ │ +0002a5c0: 636b 646f 776e 3a3a 292e 2020 5468 6973 ckdown::). This │ │ │ │ │ +0002a5d0: 2070 7265 7665 6e74 7320 7265 6d6f 7669 prevents removi │ │ │ │ │ +0002a5e0: 6e67 2045 4649 206d 656d 6f72 7920 7265 ng EFI memory re │ │ │ │ │ +0002a5f0: 6769 6f6e 7320 746f 0a20 2020 2020 706f gions to. po │ │ │ │ │ +0002a600: 7465 6e74 6961 6c6c 7920 7375 6276 6572 tentially subver │ │ │ │ │ +0002a610: 7420 7468 6520 7365 6375 7269 7479 206d t the security m │ │ │ │ │ +0002a620: 6563 6861 6e69 736d 7320 7072 6f76 6964 echanisms provid │ │ │ │ │ +0002a630: 6564 2062 7920 7468 6520 5545 4649 0a20 ed by the UEFI. │ │ │ │ │ +0002a640: 2020 2020 7365 6375 7265 2062 6f6f 742e secure boot. │ │ │ │ │ +0002a650: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0002a660: 6e66 6f2c 2020 4e6f 6465 3a20 626c 6f63 nfo, Node: bloc │ │ │ │ │ +0002a670: 6b6c 6973 742c 2020 4e65 7874 3a20 626f klist, Next: bo │ │ │ │ │ +0002a680: 6f74 2c20 2050 7265 763a 2062 6164 7261 ot, Prev: badra │ │ │ │ │ +0002a690: 6d2c 2020 5570 3a20 436f 6d6d 616e 642d m, Up: Command- │ │ │ │ │ +0002a6a0: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ +0002a6b0: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ +0002a6c0: 2e33 2e37 2062 6c6f 636b 6c69 7374 0a2d .3.7 blocklist.- │ │ │ │ │ +0002a6d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +0002a6e0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 626c . -- Command: bl │ │ │ │ │ +0002a6f0: 6f63 6b6c 6973 7420 6669 6c65 0a20 2020 ocklist file. │ │ │ │ │ +0002a700: 2020 5072 696e 7420 6120 626c 6f63 6b20 Print a block │ │ │ │ │ +0002a710: 6c69 7374 2028 2a6e 6f74 6520 426c 6f63 list (*note Bloc │ │ │ │ │ +0002a720: 6b20 6c69 7374 2073 796e 7461 783a 3a29 k list syntax::) │ │ │ │ │ +0002a730: 2066 6f72 2046 494c 452e 0a0a 1f0a 4669 for FILE.....Fi │ │ │ │ │ +0002a740: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +0002a750: 4e6f 6465 3a20 626f 6f74 2c20 204e 6578 Node: boot, Nex │ │ │ │ │ +0002a760: 743a 2063 6174 2c20 2050 7265 763a 2062 t: cat, Prev: b │ │ │ │ │ +0002a770: 6c6f 636b 6c69 7374 2c20 2055 703a 2043 locklist, Up: C │ │ │ │ │ +0002a780: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +0002a790: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +0002a7a0: 6e64 730a 0a31 362e 332e 3820 626f 6f74 nds..16.3.8 boot │ │ │ │ │ +0002a7b0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d .-----------.. - │ │ │ │ │ +0002a7c0: 2d20 436f 6d6d 616e 643a 2062 6f6f 740a - Command: boot. │ │ │ │ │ +0002a7d0: 2020 2020 2042 6f6f 7420 7468 6520 4f53 Boot the OS │ │ │ │ │ +0002a7e0: 206f 7220 6368 6169 6e2d 6c6f 6164 6572 or chain-loader │ │ │ │ │ +0002a7f0: 2077 6869 6368 2068 6173 2062 6565 6e20 which has been │ │ │ │ │ +0002a800: 6c6f 6164 6564 2e20 204f 6e6c 7920 6e65 loaded. Only ne │ │ │ │ │ +0002a810: 6365 7373 6172 790a 2020 2020 2069 6620 cessary. if │ │ │ │ │ +0002a820: 7275 6e6e 696e 6720 7468 6520 6675 6c6c running the full │ │ │ │ │ +0002a830: 7920 696e 7465 7261 6374 6976 6520 636f y interactive co │ │ │ │ │ +0002a840: 6d6d 616e 642d 6c69 6e65 2028 6974 2069 mmand-line (it i │ │ │ │ │ +0002a850: 7320 696d 706c 6963 6974 2061 740a 2020 s implicit at. │ │ │ │ │ +0002a860: 2020 2074 6865 2065 6e64 206f 6620 6120 the end of a │ │ │ │ │ +0002a870: 6d65 6e75 2065 6e74 7279 292e 0a0a 1f0a menu entry)..... │ │ │ │ │ +0002a880: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +0002a890: 2020 4e6f 6465 3a20 6361 742c 2020 4e65 Node: cat, Ne │ │ │ │ │ +0002a8a0: 7874 3a20 6368 6169 6e6c 6f61 6465 722c xt: chainloader, │ │ │ │ │ +0002a8b0: 2020 5072 6576 3a20 626f 6f74 2c20 2055 Prev: boot, U │ │ │ │ │ +0002a8c0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ +0002a8d0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ +0002a8e0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3920 ommands..16.3.9 │ │ │ │ │ +0002a8f0: 6361 740a 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a cat.----------.. │ │ │ │ │ +0002a900: 202d 2d20 436f 6d6d 616e 643a 2063 6174 -- Command: cat │ │ │ │ │ +0002a910: 205b 2d2d 646f 735d 2066 696c 650a 2020 [--dos] file. │ │ │ │ │ +0002a920: 2020 2044 6973 706c 6179 2074 6865 2063 Display the c │ │ │ │ │ +0002a930: 6f6e 7465 6e74 7320 6f66 2074 6865 2066 ontents of the f │ │ │ │ │ +0002a940: 696c 6520 4649 4c45 2e20 2054 6869 7320 ile FILE. This │ │ │ │ │ +0002a950: 636f 6d6d 616e 6420 6d61 7920 6265 2075 command may be u │ │ │ │ │ +0002a960: 7365 6675 6c0a 2020 2020 2074 6f20 7265 seful. to re │ │ │ │ │ +0002a970: 6d69 6e64 2079 6f75 206f 6620 796f 7572 mind you of your │ │ │ │ │ +0002a980: 204f 5327 7320 726f 6f74 2070 6172 7469 OS's root parti │ │ │ │ │ +0002a990: 7469 6f6e 3a0a 0a20 2020 2020 2020 2020 tion:.. │ │ │ │ │ +0002a9a0: 2067 7275 623e 2063 6174 202f 6574 632f grub> cat /etc/ │ │ │ │ │ +0002a9b0: 6673 7461 620a 0a20 2020 2020 4966 2074 fstab.. If t │ │ │ │ │ +0002a9c0: 6865 2027 2d2d 646f 7327 206f 7074 696f he '--dos' optio │ │ │ │ │ +0002a9d0: 6e20 6973 2075 7365 642c 2074 6865 6e20 n is used, then │ │ │ │ │ +0002a9e0: 6361 7272 6961 6765 2072 6574 7572 6e20 carriage return │ │ │ │ │ +0002a9f0: 2f20 6e65 7720 6c69 6e65 0a20 2020 2020 / new line. │ │ │ │ │ +0002aa00: 7061 6972 7320 7769 6c6c 2062 6520 6469 pairs will be di │ │ │ │ │ +0002aa10: 7370 6c61 7965 6420 6173 2061 2073 696d splayed as a sim │ │ │ │ │ +0002aa20: 706c 6520 6e65 7720 6c69 6e65 2e20 204f ple new line. O │ │ │ │ │ +0002aa30: 7468 6572 7769 7365 2c20 7468 650a 2020 therwise, the. │ │ │ │ │ +0002aa40: 2020 2063 6172 7269 6167 6520 7265 7475 carriage retu │ │ │ │ │ +0002aa50: 726e 2077 696c 6c20 6265 2064 6973 706c rn will be displ │ │ │ │ │ +0002aa60: 6179 6564 2061 7320 6120 636f 6e74 726f ayed as a contro │ │ │ │ │ +0002aa70: 6c20 6368 6172 6163 7465 7220 2827 3c64 l character ('') to. make │ │ │ │ │ +0002aa90: 2069 7420 6561 7369 6572 2074 6f20 7365 it easier to se │ │ │ │ │ +0002aaa0: 6520 7768 656e 2062 6f6f 7420 7072 6f62 e when boot prob │ │ │ │ │ +0002aab0: 6c65 6d73 2061 7265 2063 6175 7365 6420 lems are caused │ │ │ │ │ +0002aac0: 6279 2061 2066 696c 650a 2020 2020 2066 by a file. f │ │ │ │ │ +0002aad0: 6f72 6d61 7474 6564 2075 7369 6e67 2044 ormatted using D │ │ │ │ │ +0002aae0: 4f53 2d73 7479 6c65 206c 696e 6520 656e OS-style line en │ │ │ │ │ +0002aaf0: 6469 6e67 732e 0a0a 1f0a 4669 6c65 3a20 dings.....File: │ │ │ │ │ +0002ab00: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +0002ab10: 3a20 6368 6169 6e6c 6f61 6465 722c 2020 : chainloader, │ │ │ │ │ +0002ab20: 4e65 7874 3a20 636c 6561 722c 2020 5072 Next: clear, Pr │ │ │ │ │ +0002ab30: 6576 3a20 6361 742c 2020 5570 3a20 436f ev: cat, Up: Co │ │ │ │ │ +0002ab40: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +0002ab50: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +0002ab60: 6473 0a0a 3136 2e33 2e31 3020 6368 6169 ds..16.3.10 chai │ │ │ │ │ +0002ab70: 6e6c 6f61 6465 720a 2d2d 2d2d 2d2d 2d2d nloader.-------- │ │ │ │ │ +0002ab80: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +0002ab90: 2043 6f6d 6d61 6e64 3a20 6368 6169 6e6c Command: chainl │ │ │ │ │ +0002aba0: 6f61 6465 7220 5b2d 2d66 6f72 6365 5d20 oader [--force] │ │ │ │ │ +0002abb0: 6669 6c65 0a20 2020 2020 4c6f 6164 2046 file. Load F │ │ │ │ │ +0002abc0: 494c 4520 6173 2061 2063 6861 696e 2d6c ILE as a chain-l │ │ │ │ │ +0002abd0: 6f61 6465 722e 2020 4c69 6b65 2061 6e79 oader. Like any │ │ │ │ │ +0002abe0: 206f 7468 6572 2066 696c 6520 6c6f 6164 other file load │ │ │ │ │ +0002abf0: 6564 2062 7920 7468 650a 2020 2020 2066 ed by the. f │ │ │ │ │ +0002ac00: 696c 6573 7973 7465 6d20 636f 6465 2c20 ilesystem code, │ │ │ │ │ +0002ac10: 6974 2063 616e 2075 7365 2074 6865 2062 it can use the b │ │ │ │ │ +0002ac20: 6c6f 636b 6c69 7374 206e 6f74 6174 696f locklist notatio │ │ │ │ │ +0002ac30: 6e20 282a 6e6f 7465 2042 6c6f 636b 0a20 n (*note Block. │ │ │ │ │ +0002ac40: 2020 2020 6c69 7374 2073 796e 7461 783a list syntax: │ │ │ │ │ +0002ac50: 3a29 2074 6f20 6772 6162 2074 6865 2066 :) to grab the f │ │ │ │ │ +0002ac60: 6972 7374 2073 6563 746f 7220 6f66 2074 irst sector of t │ │ │ │ │ +0002ac70: 6865 2063 7572 7265 6e74 2070 6172 7469 he current parti │ │ │ │ │ +0002ac80: 7469 6f6e 0a20 2020 2020 7769 7468 2027 tion. with ' │ │ │ │ │ +0002ac90: 2b31 272e 2020 4966 2079 6f75 2073 7065 +1'. If you spe │ │ │ │ │ +0002aca0: 6369 6679 2074 6865 206f 7074 696f 6e20 cify the option │ │ │ │ │ +0002acb0: 272d 2d66 6f72 6365 272c 2074 6865 6e20 '--force', then │ │ │ │ │ +0002acc0: 6c6f 6164 2046 494c 450a 2020 2020 2066 load FILE. f │ │ │ │ │ +0002acd0: 6f72 6369 626c 792c 2077 6865 7468 6572 orcibly, whether │ │ │ │ │ +0002ace0: 2069 7420 6861 7320 6120 636f 7272 6563 it has a correc │ │ │ │ │ +0002acf0: 7420 7369 676e 6174 7572 6520 6f72 206e t signature or n │ │ │ │ │ +0002ad00: 6f74 2e20 2054 6869 7320 6973 0a20 2020 ot. This is. │ │ │ │ │ +0002ad10: 2020 7265 7175 6972 6564 2077 6865 6e20 required when │ │ │ │ │ +0002ad20: 796f 7520 7761 6e74 2074 6f20 6c6f 6164 you want to load │ │ │ │ │ +0002ad30: 2061 2064 6566 6563 7469 7665 2062 6f6f a defective boo │ │ │ │ │ +0002ad40: 7420 6c6f 6164 6572 2c20 7375 6368 2061 t loader, such a │ │ │ │ │ +0002ad50: 7320 5343 4f0a 2020 2020 2055 6e69 7857 s SCO. UnixW │ │ │ │ │ +0002ad60: 6172 6520 372e 312e 0a0a 1f0a 4669 6c65 are 7.1.....File │ │ │ │ │ +0002ad70: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0002ad80: 6465 3a20 636c 6561 722c 2020 4e65 7874 de: clear, Next │ │ │ │ │ +0002ad90: 3a20 636d 6f73 636c 6561 6e2c 2020 5072 : cmosclean, Pr │ │ │ │ │ +0002ada0: 6576 3a20 6368 6169 6e6c 6f61 6465 722c ev: chainloader, │ │ │ │ │ +0002adb0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ +0002adc0: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ +0002add0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ +0002ade0: 2e31 3120 636c 6561 720a 2d2d 2d2d 2d2d .11 clear.------ │ │ │ │ │ +0002adf0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +0002ae00: 6d61 6e64 3a20 636c 6561 720a 2020 2020 mand: clear. │ │ │ │ │ +0002ae10: 2043 6c65 6172 2074 6865 2073 6372 6565 Clear the scree │ │ │ │ │ +0002ae20: 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 n.....File: grub │ │ │ │ │ +0002ae30: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 636d .info, Node: cm │ │ │ │ │ +0002ae40: 6f73 636c 6561 6e2c 2020 4e65 7874 3a20 osclean, Next: │ │ │ │ │ +0002ae50: 636d 6f73 6475 6d70 2c20 2050 7265 763a cmosdump, Prev: │ │ │ │ │ +0002ae60: 2063 6c65 6172 2c20 2055 703a 2043 6f6d clear, Up: Com │ │ │ │ │ +0002ae70: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ +0002ae80: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ +0002ae90: 730a 0a31 362e 332e 3132 2063 6d6f 7363 s..16.3.12 cmosc │ │ │ │ │ +0002aea0: 6c65 616e 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d lean.----------- │ │ │ │ │ +0002aeb0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +0002aec0: 616e 643a 2063 6d6f 7363 6c65 616e 2062 and: cmosclean b │ │ │ │ │ +0002aed0: 7974 653a 6269 740a 2020 2020 2043 6c65 yte:bit. Cle │ │ │ │ │ +0002aee0: 6172 2076 616c 7565 206f 6620 6269 7420 ar value of bit │ │ │ │ │ +0002aef0: 696e 2043 4d4f 5320 6174 206c 6f63 6174 in CMOS at locat │ │ │ │ │ +0002af00: 696f 6e20 4259 5445 3a42 4954 2e20 2054 ion BYTE:BIT. T │ │ │ │ │ +0002af10: 6869 7320 636f 6d6d 616e 6420 6973 0a20 his command is. │ │ │ │ │ +0002af20: 2020 2020 6176 6169 6c61 626c 6520 6f6e available on │ │ │ │ │ +0002af30: 6c79 206f 6e20 706c 6174 666f 726d 7320 ly on platforms │ │ │ │ │ +0002af40: 7468 6174 2073 7570 706f 7274 2043 4d4f that support CMO │ │ │ │ │ +0002af50: 532e 0a0a 1f0a 4669 6c65 3a20 6772 7562 S.....File: grub │ │ │ │ │ +0002af60: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 636d .info, Node: cm │ │ │ │ │ +0002af70: 6f73 6475 6d70 2c20 204e 6578 743a 2063 osdump, Next: c │ │ │ │ │ +0002af80: 6d6f 7374 6573 742c 2020 5072 6576 3a20 mostest, Prev: │ │ │ │ │ +0002af90: 636d 6f73 636c 6561 6e2c 2020 5570 3a20 cmosclean, Up: │ │ │ │ │ +0002afa0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +0002afb0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +0002afc0: 616e 6473 0a0a 3136 2e33 2e31 3320 636d ands..16.3.13 cm │ │ │ │ │ +0002afd0: 6f73 6475 6d70 0a2d 2d2d 2d2d 2d2d 2d2d osdump.--------- │ │ │ │ │ +0002afe0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2044 756d -------.. -- Dum │ │ │ │ │ +0002aff0: 703a 2043 4d4f 5320 636f 6e74 656e 7473 p: CMOS contents │ │ │ │ │ +0002b000: 0a20 2020 2020 4475 6d70 2066 756c 6c20 . Dump full │ │ │ │ │ +0002b010: 434d 4f53 2063 6f6e 7465 6e74 7320 6173 CMOS contents as │ │ │ │ │ +0002b020: 2068 6578 6164 6563 696d 616c 2076 616c hexadecimal val │ │ │ │ │ +0002b030: 7565 732e 2020 5468 6973 2063 6f6d 6d61 ues. This comma │ │ │ │ │ +0002b040: 6e64 2069 730a 2020 2020 2061 7661 696c nd is. avail │ │ │ │ │ +0002b050: 6162 6c65 206f 6e6c 7920 6f6e 2070 6c61 able only on pla │ │ │ │ │ +0002b060: 7466 6f72 6d73 2074 6861 7420 7375 7070 tforms that supp │ │ │ │ │ +0002b070: 6f72 7420 434d 4f53 2e0a 0a1f 0a46 696c ort CMOS.....Fil │ │ │ │ │ +0002b080: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +0002b090: 6f64 653a 2063 6d6f 7374 6573 742c 2020 ode: cmostest, │ │ │ │ │ +0002b0a0: 4e65 7874 3a20 636d 702c 2020 5072 6576 Next: cmp, Prev │ │ │ │ │ +0002b0b0: 3a20 636d 6f73 6475 6d70 2c20 2055 703a : cmosdump, Up: │ │ │ │ │ +0002b0c0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +0002b0d0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +0002b0e0: 6d61 6e64 730a 0a31 362e 332e 3134 2063 mands..16.3.14 c │ │ │ │ │ +0002b0f0: 6d6f 7374 6573 740a 2d2d 2d2d 2d2d 2d2d mostest.-------- │ │ │ │ │ +0002b100: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +0002b110: 6d6d 616e 643a 2063 6d6f 7374 6573 7420 mmand: cmostest │ │ │ │ │ +0002b120: 6279 7465 3a62 6974 0a20 2020 2020 5465 byte:bit. Te │ │ │ │ │ +0002b130: 7374 2076 616c 7565 206f 6620 6269 7420 st value of bit │ │ │ │ │ +0002b140: 696e 2043 4d4f 5320 6174 206c 6f63 6174 in CMOS at locat │ │ │ │ │ +0002b150: 696f 6e20 4259 5445 3a42 4954 2e20 2045 ion BYTE:BIT. E │ │ │ │ │ +0002b160: 7869 7420 7374 6174 7573 2069 730a 2020 xit status is. │ │ │ │ │ +0002b170: 2020 207a 6572 6f20 6966 2062 6974 2069 zero if bit i │ │ │ │ │ +0002b180: 7320 7365 742c 206e 6f6e 207a 6572 6f20 s set, non zero │ │ │ │ │ +0002b190: 6f74 6865 7277 6973 652e 2020 5468 6973 otherwise. This │ │ │ │ │ +0002b1a0: 2063 6f6d 6d61 6e64 2069 7320 6176 6169 command is avai │ │ │ │ │ +0002b1b0: 6c61 626c 650a 2020 2020 206f 6e6c 7920 lable. only │ │ │ │ │ +0002b1c0: 6f6e 2070 6c61 7466 6f72 6d73 2074 6861 on platforms tha │ │ │ │ │ +0002b1d0: 7420 7375 7070 6f72 7420 434d 4f53 2e0a t support CMOS.. │ │ │ │ │ +0002b1e0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +0002b1f0: 666f 2c20 204e 6f64 653a 2063 6d70 2c20 fo, Node: cmp, │ │ │ │ │ +0002b200: 204e 6578 743a 2063 6f6e 6669 6766 696c Next: configfil │ │ │ │ │ +0002b210: 652c 2020 5072 6576 3a20 636d 6f73 7465 e, Prev: cmoste │ │ │ │ │ +0002b220: 7374 2c20 2055 703a 2043 6f6d 6d61 6e64 st, Up: Command │ │ │ │ │ +0002b230: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +0002b240: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +0002b250: 362e 332e 3135 2063 6d70 0a2d 2d2d 2d2d 6.3.15 cmp.----- │ │ │ │ │ +0002b260: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +0002b270: 616e 643a 2063 6d70 2066 696c 6531 2066 and: cmp file1 f │ │ │ │ │ +0002b280: 696c 6532 0a20 2020 2020 436f 6d70 6172 ile2. Compar │ │ │ │ │ +0002b290: 6520 7468 6520 6669 6c65 2046 494c 4531 e the file FILE1 │ │ │ │ │ +0002b2a0: 2077 6974 6820 7468 6520 6669 6c65 2046 with the file F │ │ │ │ │ +0002b2b0: 494c 4532 2e20 2049 6620 7468 6579 2064 ILE2. If they d │ │ │ │ │ +0002b2c0: 6966 6665 7220 696e 0a20 2020 2020 7369 iffer in. si │ │ │ │ │ +0002b2d0: 7a65 2c20 7072 696e 7420 7468 6520 7369 ze, print the si │ │ │ │ │ +0002b2e0: 7a65 7320 6c69 6b65 2074 6869 733a 0a0a zes like this:.. │ │ │ │ │ +0002b2f0: 2020 2020 2020 2020 2020 4469 6666 6572 Differ │ │ │ │ │ +0002b300: 2069 6e20 7369 7a65 3a20 3078 3132 3334 in size: 0x1234 │ │ │ │ │ +0002b310: 205b 666f 6f5d 2c20 3078 3433 3231 205b [foo], 0x4321 [ │ │ │ │ │ +0002b320: 6261 725d 0a0a 2020 2020 2049 6620 7468 bar].. If th │ │ │ │ │ +0002b330: 6520 7369 7a65 7320 6172 6520 6571 7561 e sizes are equa │ │ │ │ │ +0002b340: 6c20 6275 7420 7468 6520 6279 7465 7320 l but the bytes │ │ │ │ │ +0002b350: 6174 2061 6e20 6f66 6673 6574 2064 6966 at an offset dif │ │ │ │ │ +0002b360: 6665 722c 2074 6865 6e0a 2020 2020 2070 fer, then. p │ │ │ │ │ +0002b370: 7269 6e74 2074 6865 2062 7974 6573 206c rint the bytes l │ │ │ │ │ +0002b380: 696b 6520 7468 6973 3a0a 0a20 2020 2020 ike this:.. │ │ │ │ │ +0002b390: 2020 2020 2044 6966 6665 7220 6174 2074 Differ at t │ │ │ │ │ +0002b3a0: 6865 206f 6666 7365 7420 3737 373a 2030 he offset 777: 0 │ │ │ │ │ +0002b3b0: 7862 6520 5b66 6f6f 5d2c 2030 7865 6620 xbe [foo], 0xef │ │ │ │ │ +0002b3c0: 5b62 6172 5d0a 0a20 2020 2020 4966 2074 [bar].. If t │ │ │ │ │ +0002b3d0: 6865 7920 6172 6520 636f 6d70 6c65 7465 hey are complete │ │ │ │ │ +0002b3e0: 6c79 2069 6465 6e74 6963 616c 2c20 6e6f ly identical, no │ │ │ │ │ +0002b3f0: 7468 696e 6720 7769 6c6c 2062 6520 7072 thing will be pr │ │ │ │ │ +0002b400: 696e 7465 642e 0a0a 1f0a 4669 6c65 3a20 inted.....File: │ │ │ │ │ +0002b410: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +0002b420: 3a20 636f 6e66 6967 6669 6c65 2c20 204e : configfile, N │ │ │ │ │ +0002b430: 6578 743a 2063 7075 6964 2c20 2050 7265 ext: cpuid, Pre │ │ │ │ │ +0002b440: 763a 2063 6d70 2c20 2055 703a 2043 6f6d v: cmp, Up: Com │ │ │ │ │ +0002b450: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ +0002b460: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ +0002b470: 730a 0a31 362e 332e 3136 2063 6f6e 6669 s..16.3.16 confi │ │ │ │ │ +0002b480: 6766 696c 650a 2d2d 2d2d 2d2d 2d2d 2d2d gfile.---------- │ │ │ │ │ +0002b490: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +0002b4a0: 6d6d 616e 643a 2063 6f6e 6669 6766 696c mmand: configfil │ │ │ │ │ +0002b4b0: 6520 6669 6c65 0a20 2020 2020 4c6f 6164 e file. Load │ │ │ │ │ +0002b4c0: 2046 494c 4520 6173 2061 2063 6f6e 6669 FILE as a confi │ │ │ │ │ +0002b4d0: 6775 7261 7469 6f6e 2066 696c 652e 2020 guration file. │ │ │ │ │ +0002b4e0: 4966 2046 494c 4520 6465 6669 6e65 7320 If FILE defines │ │ │ │ │ +0002b4f0: 616e 7920 6d65 6e75 0a20 2020 2020 656e any menu. en │ │ │ │ │ +0002b500: 7472 6965 732c 2074 6865 6e20 7368 6f77 tries, then show │ │ │ │ │ +0002b510: 2061 206d 656e 7520 636f 6e74 6169 6e69 a menu containi │ │ │ │ │ +0002b520: 6e67 2074 6865 6d20 696d 6d65 6469 6174 ng them immediat │ │ │ │ │ +0002b530: 656c 792e 2020 416e 790a 2020 2020 2065 ely. Any. e │ │ │ │ │ +0002b540: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +0002b550: 626c 6520 6368 616e 6765 7320 6d61 6465 ble changes made │ │ │ │ │ +0002b560: 2062 7920 7468 6520 636f 6d6d 616e 6473 by the commands │ │ │ │ │ +0002b570: 2069 6e20 4649 4c45 2077 696c 6c20 6e6f in FILE will no │ │ │ │ │ +0002b580: 740a 2020 2020 2062 6520 7072 6573 6572 t. be preser │ │ │ │ │ +0002b590: 7665 6420 6166 7465 7220 2763 6f6e 6669 ved after 'confi │ │ │ │ │ +0002b5a0: 6766 696c 6527 2072 6574 7572 6e73 2e0a gfile' returns.. │ │ │ │ │ +0002b5b0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +0002b5c0: 666f 2c20 204e 6f64 653a 2063 7075 6964 fo, Node: cpuid │ │ │ │ │ +0002b5d0: 2c20 204e 6578 743a 2063 7263 2c20 2050 , Next: crc, P │ │ │ │ │ +0002b5e0: 7265 763a 2063 6f6e 6669 6766 696c 652c rev: configfile, │ │ │ │ │ +0002b5f0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ +0002b600: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ +0002b610: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ +0002b620: 2e31 3720 6370 7569 640a 2d2d 2d2d 2d2d .17 cpuid.------ │ │ │ │ │ +0002b630: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +0002b640: 6d61 6e64 3a20 6370 7569 6420 5b2d 6c5d mand: cpuid [-l] │ │ │ │ │ +0002b650: 205b 2d70 5d0a 2020 2020 2043 6865 636b [-p]. Check │ │ │ │ │ +0002b660: 2066 6f72 2043 5055 2066 6561 7475 7265 for CPU feature │ │ │ │ │ +0002b670: 732e 2020 5468 6973 2063 6f6d 6d61 6e64 s. This command │ │ │ │ │ +0002b680: 2069 7320 6f6e 6c79 2061 7661 696c 6162 is only availab │ │ │ │ │ +0002b690: 6c65 206f 6e20 7838 360a 2020 2020 2073 le on x86. s │ │ │ │ │ +0002b6a0: 7973 7465 6d73 2e0a 0a20 2020 2020 5769 ystems... Wi │ │ │ │ │ +0002b6b0: 7468 2074 6865 2027 2d6c 2720 6f70 7469 th the '-l' opti │ │ │ │ │ +0002b6c0: 6f6e 2c20 7265 7475 726e 2074 7275 6520 on, return true │ │ │ │ │ +0002b6d0: 6966 2074 6865 2043 5055 2073 7570 706f if the CPU suppo │ │ │ │ │ +0002b6e0: 7274 7320 6c6f 6e67 206d 6f64 650a 2020 rts long mode. │ │ │ │ │ +0002b6f0: 2020 2028 3634 2d62 6974 292e 0a0a 2020 (64-bit)... │ │ │ │ │ +0002b700: 2020 2057 6974 6820 7468 6520 272d 7027 With the '-p' │ │ │ │ │ +0002b710: 206f 7074 696f 6e2c 2072 6574 7572 6e20 option, return │ │ │ │ │ +0002b720: 7472 7565 2069 6620 7468 6520 4350 5520 true if the CPU │ │ │ │ │ +0002b730: 7375 7070 6f72 7473 2050 6879 7369 6361 supports Physica │ │ │ │ │ +0002b740: 6c0a 2020 2020 2041 6464 7265 7373 2045 l. Address E │ │ │ │ │ +0002b750: 7874 656e 7369 6f6e 2028 5041 4529 2e0a xtension (PAE).. │ │ │ │ │ +0002b760: 0a20 2020 2020 4966 2069 6e76 6f6b 6564 . If invoked │ │ │ │ │ +0002b770: 2077 6974 686f 7574 206f 7074 696f 6e73 without options │ │ │ │ │ +0002b780: 2c20 7468 6973 2063 6f6d 6d61 6e64 2063 , this command c │ │ │ │ │ +0002b790: 7572 7265 6e74 6c79 2062 6568 6176 6573 urrently behaves │ │ │ │ │ +0002b7a0: 2061 7320 6966 2069 740a 2020 2020 2068 as if it. h │ │ │ │ │ +0002b7b0: 6164 2062 6565 6e20 696e 766f 6b65 6420 ad been invoked │ │ │ │ │ +0002b7c0: 7769 7468 2027 2d6c 272e 2020 5468 6973 with '-l'. This │ │ │ │ │ +0002b7d0: 206d 6179 2063 6861 6e67 6520 696e 2074 may change in t │ │ │ │ │ +0002b7e0: 6865 2066 7574 7572 652e 0a0a 1f0a 4669 he future.....Fi │ │ │ │ │ +0002b7f0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +0002b800: 4e6f 6465 3a20 6372 632c 2020 4e65 7874 Node: crc, Next │ │ │ │ │ +0002b810: 3a20 6372 7970 746f 6d6f 756e 742c 2020 : cryptomount, │ │ │ │ │ +0002b820: 5072 6576 3a20 6370 7569 642c 2020 5570 Prev: cpuid, Up │ │ │ │ │ +0002b830: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +0002b840: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +0002b850: 6d6d 616e 6473 0a0a 3136 2e33 2e31 3820 mmands..16.3.18 │ │ │ │ │ +0002b860: 6372 630a 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a crc.-----------. │ │ │ │ │ +0002b870: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6372 . -- Command: cr │ │ │ │ │ +0002b880: 6320 6172 6720 2e2e 2e0a 2020 2020 2041 c arg .... A │ │ │ │ │ +0002b890: 6c69 6173 2066 6f72 2027 6861 7368 7375 lias for 'hashsu │ │ │ │ │ +0002b8a0: 6d20 2d2d 6861 7368 2063 7263 3332 2061 m --hash crc32 a │ │ │ │ │ +0002b8b0: 7267 202e 2e2e 272e 2020 5365 6520 636f rg ...'. See co │ │ │ │ │ +0002b8c0: 6d6d 616e 6420 2768 6173 6873 756d 270a mmand 'hashsum'. │ │ │ │ │ +0002b8d0: 2020 2020 2028 2a6e 6f74 6520 6861 7368 (*note hash │ │ │ │ │ +0002b8e0: 7375 6d3a 3a29 2066 6f72 2066 756c 6c20 sum::) for full │ │ │ │ │ +0002b8f0: 6465 7363 7269 7074 696f 6e2e 0a0a 1f0a description..... │ │ │ │ │ +0002b900: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +0002b910: 2020 4e6f 6465 3a20 6372 7970 746f 6d6f Node: cryptomo │ │ │ │ │ +0002b920: 756e 742c 2020 4e65 7874 3a20 6375 746d unt, Next: cutm │ │ │ │ │ +0002b930: 656d 2c20 2050 7265 763a 2063 7263 2c20 em, Prev: crc, │ │ │ │ │ +0002b940: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +0002b950: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +0002b960: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +0002b970: 3139 2063 7279 7074 6f6d 6f75 6e74 0a2d 19 cryptomount.- │ │ │ │ │ 0002b980: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002b990: 0a0a 202d 2d20 436f 6d6d 616e 643a 2063 .. -- Command: c │ │ │ │ │ -0002b9a0: 7279 7074 6f6d 6f75 6e74 2064 6576 6963 ryptomount devic │ │ │ │ │ -0002b9b0: 657c 2d75 2075 7569 647c 2d61 7c2d 620a e|-u uuid|-a|-b. │ │ │ │ │ -0002b9c0: 2020 2020 2053 6574 7570 2061 6363 6573 Setup acces │ │ │ │ │ -0002b9d0: 7320 746f 2065 6e63 7279 7074 6564 2064 s to encrypted d │ │ │ │ │ -0002b9e0: 6576 6963 652e 2020 4966 206e 6563 6573 evice. If neces │ │ │ │ │ -0002b9f0: 7361 7279 2c20 7061 7373 7068 7261 7365 sary, passphrase │ │ │ │ │ -0002ba00: 2069 730a 2020 2020 2072 6571 7565 7374 is. request │ │ │ │ │ -0002ba10: 6564 2069 6e74 6572 6163 7469 7665 6c79 ed interactively │ │ │ │ │ -0002ba20: 2e20 204f 7074 696f 6e20 4445 5649 4345 . Option DEVICE │ │ │ │ │ -0002ba30: 2063 6f6e 6669 6775 7265 7320 7370 6563 configures spec │ │ │ │ │ -0002ba40: 6966 6963 2067 7275 620a 2020 2020 2064 ific grub. d │ │ │ │ │ -0002ba50: 6576 6963 6520 282a 6e6f 7465 204e 616d evice (*note Nam │ │ │ │ │ -0002ba60: 696e 6720 636f 6e76 656e 7469 6f6e 3a3a ing convention:: │ │ │ │ │ -0002ba70: 293b 206f 7074 696f 6e20 272d 7527 2055 ); option '-u' U │ │ │ │ │ -0002ba80: 5549 4420 636f 6e66 6967 7572 6573 0a20 UID configures. │ │ │ │ │ -0002ba90: 2020 2020 6465 7669 6365 2077 6974 6820 device with │ │ │ │ │ -0002baa0: 7370 6563 6966 6965 6420 5555 4944 3b20 specified UUID; │ │ │ │ │ -0002bab0: 6f70 7469 6f6e 2027 2d61 2720 636f 6e66 option '-a' conf │ │ │ │ │ -0002bac0: 6967 7572 6573 2061 6c6c 2064 6574 6563 igures all detec │ │ │ │ │ -0002bad0: 7465 640a 2020 2020 2065 6e63 7279 7074 ted. encrypt │ │ │ │ │ -0002bae0: 6564 2064 6576 6963 6573 3b20 6f70 7469 ed devices; opti │ │ │ │ │ -0002baf0: 6f6e 2027 2d62 2720 636f 6e66 6967 7572 on '-b' configur │ │ │ │ │ -0002bb00: 6573 2061 6c6c 2067 656c 6920 636f 6e74 es all geli cont │ │ │ │ │ -0002bb10: 6169 6e65 7273 2074 6861 740a 2020 2020 ainers that. │ │ │ │ │ -0002bb20: 2068 6176 6520 626f 6f74 2066 6c61 6720 have boot flag │ │ │ │ │ -0002bb30: 7365 742e 0a0a 2020 2020 2047 5255 4220 set... GRUB │ │ │ │ │ -0002bb40: 7375 706f 7274 7320 6465 7669 6365 7320 suports devices │ │ │ │ │ -0002bb50: 656e 6372 7970 7465 6420 7573 696e 6720 encrypted using │ │ │ │ │ -0002bb60: 4c55 4b53 2c20 4c55 4b53 3220 616e 6420 LUKS, LUKS2 and │ │ │ │ │ -0002bb70: 6765 6c69 2e20 204e 6f74 650a 2020 2020 geli. Note. │ │ │ │ │ -0002bb80: 2074 6861 7420 6e65 6365 7373 6172 7920 that necessary │ │ │ │ │ -0002bb90: 6d6f 6475 6c65 7320 284c 554b 532c 204c modules (LUKS, L │ │ │ │ │ -0002bba0: 554b 5332 2061 6e64 2047 454c 4929 2068 UKS2 and GELI) h │ │ │ │ │ -0002bbb0: 6176 6520 746f 2062 6520 6c6f 6164 6564 ave to be loaded │ │ │ │ │ -0002bbc0: 0a20 2020 2020 6d61 6e75 616c 6c79 2062 . manually b │ │ │ │ │ -0002bbd0: 6566 6f72 6520 7468 6973 2063 6f6d 6d61 efore this comma │ │ │ │ │ -0002bbe0: 6e64 2063 616e 2062 6520 7573 6564 2e20 nd can be used. │ │ │ │ │ -0002bbf0: 2046 6f72 204c 554b 5332 206f 6e6c 7920 For LUKS2 only │ │ │ │ │ -0002bc00: 7468 650a 2020 2020 2050 424b 4446 3220 the. PBKDF2 │ │ │ │ │ -0002bc10: 6b65 7920 6465 7269 7661 7469 6f6e 2066 key derivation f │ │ │ │ │ -0002bc20: 756e 6374 696f 6e20 6973 2073 7570 706f unction is suppo │ │ │ │ │ -0002bc30: 7274 6564 2c20 6173 2041 7267 6f6e 3220 rted, as Argon2 │ │ │ │ │ -0002bc40: 6973 206e 6f74 2079 6574 0a20 2020 2020 is not yet. │ │ │ │ │ -0002bc50: 7375 7070 6f72 7465 642e 0a0a 2020 2020 supported... │ │ │ │ │ -0002bc60: 2041 6c73 6f2c 206e 6f74 6520 7468 6174 Also, note that │ │ │ │ │ -0002bc70: 2c20 756e 6c69 6b65 2066 696c 6573 7973 , unlike filesys │ │ │ │ │ -0002bc80: 7465 6d20 5555 4944 732c 2055 5549 4473 tem UUIDs, UUIDs │ │ │ │ │ -0002bc90: 2066 6f72 2065 6e63 7279 7074 6564 0a20 for encrypted. │ │ │ │ │ -0002bca0: 2020 2020 6465 7669 6365 7320 6d75 7374 devices must │ │ │ │ │ -0002bcb0: 2062 6520 7370 6563 6966 6965 6420 7769 be specified wi │ │ │ │ │ -0002bcc0: 7468 6f75 7420 6461 7368 2073 6570 6172 thout dash separ │ │ │ │ │ -0002bcd0: 6174 6f72 732e 0a0a 1f0a 4669 6c65 3a20 ators.....File: │ │ │ │ │ -0002bce0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -0002bcf0: 3a20 6375 746d 656d 2c20 204e 6578 743a : cutmem, Next: │ │ │ │ │ -0002bd00: 2064 6174 652c 2020 5072 6576 3a20 6372 date, Prev: cr │ │ │ │ │ -0002bd10: 7970 746f 6d6f 756e 742c 2020 5570 3a20 yptomount, Up: │ │ │ │ │ -0002bd20: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -0002bd30: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -0002bd40: 616e 6473 0a0a 3136 2e33 2e32 3020 6375 ands..16.3.20 cu │ │ │ │ │ -0002bd50: 746d 656d 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d tmem.----------- │ │ │ │ │ -0002bd60: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -0002bd70: 3a20 6375 746d 656d 2066 726f 6d5b 4b7c : cutmem from[K| │ │ │ │ │ -0002bd80: 4d7c 475d 2074 6f5b 4b7c 4d7c 475d 0a20 M|G] to[K|M|G]. │ │ │ │ │ -0002bd90: 2020 2020 5265 6d6f 7665 2061 6e79 206d Remove any m │ │ │ │ │ -0002bda0: 656d 6f72 7920 7265 6769 6f6e 7320 696e emory regions in │ │ │ │ │ -0002bdb0: 2073 7065 6369 6669 6564 2072 616e 6765 specified range │ │ │ │ │ -0002bdc0: 2e0a 0a20 2020 2020 5468 6973 2063 6f6d ... This com │ │ │ │ │ -0002bdd0: 6d61 6e64 206e 6f74 6966 6965 7320 7468 mand notifies th │ │ │ │ │ -0002bde0: 6520 6d65 6d6f 7279 206d 616e 6167 6572 e memory manager │ │ │ │ │ -0002bdf0: 2074 6861 7420 7370 6563 6966 6965 6420 that specified │ │ │ │ │ -0002be00: 7265 6769 6f6e 7320 6f66 0a20 2020 2020 regions of. │ │ │ │ │ -0002be10: 5241 4d20 6f75 6768 7420 746f 2062 6520 RAM ought to be │ │ │ │ │ -0002be20: 6669 6c74 6572 6564 206f 7574 2e20 2054 filtered out. T │ │ │ │ │ -0002be30: 6869 7320 7265 6d61 696e 7320 696e 2065 his remains in e │ │ │ │ │ -0002be40: 6666 6563 7420 6166 7465 7220 610a 2020 ffect after a. │ │ │ │ │ -0002be50: 2020 2070 6179 6c6f 6164 206b 6572 6e65 payload kerne │ │ │ │ │ -0002be60: 6c20 6861 7320 6265 656e 206c 6f61 6465 l has been loade │ │ │ │ │ -0002be70: 6420 6279 2047 5255 422c 2061 7320 6c6f d by GRUB, as lo │ │ │ │ │ -0002be80: 6e67 2061 7320 7468 6520 6c6f 6164 6564 ng as the loaded │ │ │ │ │ -0002be90: 0a20 2020 2020 6b65 726e 656c 206f 6274 . kernel obt │ │ │ │ │ -0002bea0: 6169 6e73 2069 7473 206d 656d 6f72 7920 ains its memory │ │ │ │ │ -0002beb0: 6d61 7020 6672 6f6d 2047 5255 422e 204b map from GRUB. K │ │ │ │ │ -0002bec0: 6572 6e65 6c73 2074 6861 7420 7375 7070 ernels that supp │ │ │ │ │ -0002bed0: 6f72 7420 7468 6973 0a20 2020 2020 696e ort this. in │ │ │ │ │ -0002bee0: 636c 7564 6520 4c69 6e75 782c 2047 4e55 clude Linux, GNU │ │ │ │ │ -0002bef0: 204d 6163 682c 2074 6865 206b 6572 6e65 Mach, the kerne │ │ │ │ │ -0002bf00: 6c20 6f66 2046 7265 6542 5344 2061 6e64 l of FreeBSD and │ │ │ │ │ -0002bf10: 204d 756c 7469 626f 6f74 0a20 2020 2020 Multiboot. │ │ │ │ │ -0002bf20: 6b65 726e 656c 7320 696e 2067 656e 6572 kernels in gener │ │ │ │ │ -0002bf30: 616c 2e0a 0a20 2020 2020 5468 6520 636f al... The co │ │ │ │ │ -0002bf40: 6d6d 616e 6420 6973 2073 696d 696c 6172 mmand is similar │ │ │ │ │ -0002bf50: 2074 6f20 2762 6164 7261 6d27 2063 6f6d to 'badram' com │ │ │ │ │ -0002bf60: 6d61 6e64 2e0a 0a20 2020 2020 4e6f 7465 mand... Note │ │ │ │ │ -0002bf70: 3a20 5468 6520 636f 6d6d 616e 6420 6973 : The command is │ │ │ │ │ -0002bf80: 206e 6f74 2061 6c6c 6f77 6564 2077 6865 not allowed whe │ │ │ │ │ -0002bf90: 6e20 6c6f 636b 646f 776e 2069 7320 656e n lockdown is en │ │ │ │ │ -0002bfa0: 666f 7263 6564 2028 2a6e 6f74 650a 2020 forced (*note. │ │ │ │ │ -0002bfb0: 2020 204c 6f63 6b64 6f77 6e3a 3a29 2e20 Lockdown::). │ │ │ │ │ -0002bfc0: 2054 6869 7320 7072 6576 656e 7473 2072 This prevents r │ │ │ │ │ -0002bfd0: 656d 6f76 696e 6720 4546 4920 6d65 6d6f emoving EFI memo │ │ │ │ │ -0002bfe0: 7279 2072 6567 696f 6e73 2074 6f0a 2020 ry regions to. │ │ │ │ │ -0002bff0: 2020 2070 6f74 656e 7469 616c 6c79 2073 potentially s │ │ │ │ │ -0002c000: 7562 7665 7274 2074 6865 2073 6563 7572 ubvert the secur │ │ │ │ │ -0002c010: 6974 7920 6d65 6368 616e 6973 6d73 2070 ity mechanisms p │ │ │ │ │ -0002c020: 726f 7669 6465 6420 6279 2074 6865 2055 rovided by the U │ │ │ │ │ -0002c030: 4546 490a 2020 2020 2073 6563 7572 6520 EFI. secure │ │ │ │ │ -0002c040: 626f 6f74 2e0a 0a1f 0a46 696c 653a 2067 boot.....File: g │ │ │ │ │ -0002c050: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0002c060: 2064 6174 652c 2020 4e65 7874 3a20 6465 date, Next: de │ │ │ │ │ -0002c070: 7669 6365 7472 6565 2c20 2050 7265 763a vicetree, Prev: │ │ │ │ │ -0002c080: 2063 7574 6d65 6d2c 2020 5570 3a20 436f cutmem, Up: Co │ │ │ │ │ -0002c090: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -0002c0a0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -0002c0b0: 6473 0a0a 3136 2e33 2e32 3120 6461 7465 ds..16.3.21 date │ │ │ │ │ -0002c0c0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 .------------.. │ │ │ │ │ -0002c0d0: 2d2d 2043 6f6d 6d61 6e64 3a20 6461 7465 -- Command: date │ │ │ │ │ -0002c0e0: 205b 5b79 6561 722d 5d6d 6f6e 7468 2d64 [[year-]month-d │ │ │ │ │ -0002c0f0: 6179 5d20 5b68 6f75 723a 6d69 6e75 7465 ay] [hour:minute │ │ │ │ │ -0002c100: 5b3a 7365 636f 6e64 5d5d 0a20 2020 2020 [:second]]. │ │ │ │ │ -0002c110: 5769 7468 206e 6f20 6172 6775 6d65 6e74 With no argument │ │ │ │ │ -0002c120: 732c 2070 7269 6e74 2074 6865 2063 7572 s, print the cur │ │ │ │ │ -0002c130: 7265 6e74 2064 6174 6520 616e 6420 7469 rent date and ti │ │ │ │ │ -0002c140: 6d65 2e0a 0a20 2020 2020 4f74 6865 7277 me... Otherw │ │ │ │ │ -0002c150: 6973 652c 2074 616b 6520 7468 6520 6375 ise, take the cu │ │ │ │ │ -0002c160: 7272 656e 7420 6461 7465 2061 6e64 2074 rrent date and t │ │ │ │ │ -0002c170: 696d 652c 2063 6861 6e67 6520 616e 7920 ime, change any │ │ │ │ │ -0002c180: 656c 656d 656e 7473 0a20 2020 2020 7370 elements. sp │ │ │ │ │ -0002c190: 6563 6966 6965 6420 6173 2061 7267 756d ecified as argum │ │ │ │ │ -0002c1a0: 656e 7473 2c20 616e 6420 7365 7420 7468 ents, and set th │ │ │ │ │ -0002c1b0: 6520 7265 7375 6c74 2061 7320 7468 6520 e result as the │ │ │ │ │ -0002c1c0: 6e65 7720 6461 7465 2061 6e64 0a20 2020 new date and. │ │ │ │ │ -0002c1d0: 2020 7469 6d65 2e20 2046 6f72 2065 7861 time. For exa │ │ │ │ │ -0002c1e0: 6d70 6c65 2c20 2764 6174 6520 3031 2d30 mple, 'date 01-0 │ │ │ │ │ -0002c1f0: 3127 2077 696c 6c20 7365 7420 7468 6520 1' will set the │ │ │ │ │ -0002c200: 6375 7272 656e 7420 6d6f 6e74 6820 616e current month an │ │ │ │ │ -0002c210: 6420 6461 790a 2020 2020 2074 6f20 4a61 d day. to Ja │ │ │ │ │ -0002c220: 6e75 6172 7920 312c 2062 7574 206c 6561 nuary 1, but lea │ │ │ │ │ -0002c230: 7665 2074 6865 2079 6561 722c 2068 6f75 ve the year, hou │ │ │ │ │ -0002c240: 722c 206d 696e 7574 652c 2061 6e64 2073 r, minute, and s │ │ │ │ │ -0002c250: 6563 6f6e 640a 2020 2020 2075 6e63 6861 econd. uncha │ │ │ │ │ -0002c260: 6e67 6564 2e0a 0a1f 0a46 696c 653a 2067 nged.....File: g │ │ │ │ │ -0002c270: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0002c280: 2064 6576 6963 6574 7265 652c 2020 4e65 devicetree, Ne │ │ │ │ │ -0002c290: 7874 3a20 6469 7374 7275 7374 2c20 2050 xt: distrust, P │ │ │ │ │ -0002c2a0: 7265 763a 2064 6174 652c 2020 5570 3a20 rev: date, Up: │ │ │ │ │ -0002c2b0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -0002c2c0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -0002c2d0: 616e 6473 0a0a 3136 2e33 2e32 3220 6465 ands..16.3.22 de │ │ │ │ │ -0002c2e0: 7669 6365 7472 6565 0a2d 2d2d 2d2d 2d2d vicetree.------- │ │ │ │ │ -0002c2f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ -0002c300: 2043 6f6d 6d61 6e64 3a20 6465 7669 6365 Command: device │ │ │ │ │ -0002c310: 7472 6565 2066 696c 650a 2020 2020 204c tree file. L │ │ │ │ │ -0002c320: 6f61 6420 6120 6465 7669 6365 2074 7265 oad a device tre │ │ │ │ │ -0002c330: 6520 626c 6f62 2028 2e64 7462 2920 6672 e blob (.dtb) fr │ │ │ │ │ -0002c340: 6f6d 2061 2066 696c 6573 7973 7465 6d2c om a filesystem, │ │ │ │ │ -0002c350: 2066 6f72 206c 6174 6572 2075 7365 2062 for later use b │ │ │ │ │ -0002c360: 790a 2020 2020 2061 204c 696e 7578 206b y. a Linux k │ │ │ │ │ -0002c370: 6572 6e65 6c2e 2020 446f 6573 206e 6f74 ernel. Does not │ │ │ │ │ -0002c380: 2070 6572 666f 726d 206d 6572 6769 6e67 perform merging │ │ │ │ │ -0002c390: 2077 6974 6820 616e 7920 6465 7669 6365 with any device │ │ │ │ │ -0002c3a0: 2074 7265 650a 2020 2020 2073 7570 706c tree. suppl │ │ │ │ │ -0002c3b0: 6965 6420 6279 2066 6972 6d77 6172 652c ied by firmware, │ │ │ │ │ -0002c3c0: 2062 7574 2072 6174 6865 7220 7265 706c but rather repl │ │ │ │ │ -0002c3d0: 6163 6573 2069 7420 636f 6d70 6c65 7465 aces it complete │ │ │ │ │ -0002c3e0: 6c79 2e0a 0a20 2020 2020 4e6f 7465 3a20 ly... Note: │ │ │ │ │ -0002c3f0: 5468 6520 636f 6d6d 616e 6420 6973 206e The command is n │ │ │ │ │ -0002c400: 6f74 2061 6c6c 6f77 6564 2077 6865 6e20 ot allowed when │ │ │ │ │ -0002c410: 6c6f 636b 646f 776e 2069 7320 656e 666f lockdown is enfo │ │ │ │ │ -0002c420: 7263 6564 2028 2a6e 6f74 650a 2020 2020 rced (*note. │ │ │ │ │ -0002c430: 204c 6f63 6b64 6f77 6e3a 3a29 2e20 2054 Lockdown::). T │ │ │ │ │ -0002c440: 6869 7320 6973 2064 6f6e 6520 746f 2070 his is done to p │ │ │ │ │ -0002c450: 7265 7665 6e74 2073 7562 7665 7274 696e revent subvertin │ │ │ │ │ -0002c460: 6720 7661 7269 6f75 7320 7365 6375 7269 g various securi │ │ │ │ │ -0002c470: 7479 0a20 2020 2020 6d65 6368 616e 6973 ty. mechanis │ │ │ │ │ -0002c480: 6d73 2e0a 0a1f 0a46 696c 653a 2067 7275 ms.....File: gru │ │ │ │ │ -0002c490: 622e 696e 666f 2c20 204e 6f64 653a 2064 b.info, Node: d │ │ │ │ │ -0002c4a0: 6973 7472 7573 742c 2020 4e65 7874 3a20 istrust, Next: │ │ │ │ │ -0002c4b0: 6472 6976 656d 6170 2c20 2050 7265 763a drivemap, Prev: │ │ │ │ │ -0002c4c0: 2064 6576 6963 6574 7265 652c 2020 5570 devicetree, Up │ │ │ │ │ -0002c4d0: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -0002c4e0: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -0002c4f0: 6d6d 616e 6473 0a0a 3136 2e33 2e32 3320 mmands..16.3.23 │ │ │ │ │ -0002c500: 6469 7374 7275 7374 0a2d 2d2d 2d2d 2d2d distrust.------- │ │ │ │ │ -0002c510: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -0002c520: 6f6d 6d61 6e64 3a20 6469 7374 7275 7374 ommand: distrust │ │ │ │ │ -0002c530: 2070 7562 6b65 795f 6964 0a20 2020 2020 pubkey_id. │ │ │ │ │ -0002c540: 5265 6d6f 7665 2070 7562 6c69 6320 6b65 Remove public ke │ │ │ │ │ -0002c550: 7920 5055 424b 4559 5f49 4420 6672 6f6d y PUBKEY_ID from │ │ │ │ │ -0002c560: 2047 5255 4227 7320 6b65 7972 696e 6720 GRUB's keyring │ │ │ │ │ -0002c570: 6f66 2074 7275 7374 6564 206b 6579 732e of trusted keys. │ │ │ │ │ -0002c580: 0a20 2020 2020 5055 424b 4559 5f49 4420 . PUBKEY_ID │ │ │ │ │ -0002c590: 6973 2074 6865 206c 6173 7420 666f 7572 is the last four │ │ │ │ │ -0002c5a0: 2062 7974 6573 2028 6569 6768 7420 6865 bytes (eight he │ │ │ │ │ -0002c5b0: 7861 6465 6369 6d61 6c20 6469 6769 7473 xadecimal digits │ │ │ │ │ -0002c5c0: 2920 6f66 2074 6865 0a20 2020 2020 4750 ) of the. GP │ │ │ │ │ -0002c5d0: 4720 7634 206b 6579 2069 642c 2077 6869 G v4 key id, whi │ │ │ │ │ -0002c5e0: 6368 2069 7320 616c 736f 2074 6865 206f ch is also the o │ │ │ │ │ -0002c5f0: 7574 7075 7420 6f66 2027 6c69 7374 5f74 utput of 'list_t │ │ │ │ │ -0002c600: 7275 7374 6564 2720 282a 6e6f 7465 0a20 rusted' (*note. │ │ │ │ │ -0002c610: 2020 2020 6c69 7374 5f74 7275 7374 6564 list_trusted │ │ │ │ │ -0002c620: 3a3a 292e 2020 4f75 7473 6964 6520 6f66 ::). Outside of │ │ │ │ │ -0002c630: 2047 5255 422c 2074 6865 206b 6579 2069 GRUB, the key i │ │ │ │ │ -0002c640: 6420 6361 6e20 6265 206f 6274 6169 6e65 d can be obtaine │ │ │ │ │ -0002c650: 6420 7573 696e 670a 2020 2020 2027 6770 d using. 'gp │ │ │ │ │ -0002c660: 6720 2d2d 6669 6e67 6572 7072 696e 7427 g --fingerprint' │ │ │ │ │ -0002c670: 292e 2020 5468 6573 6520 6b65 7973 2061 ). These keys a │ │ │ │ │ -0002c680: 7265 2075 7365 6420 746f 2076 616c 6964 re used to valid │ │ │ │ │ -0002c690: 6174 6520 7369 676e 6174 7572 6573 0a20 ate signatures. │ │ │ │ │ -0002c6a0: 2020 2020 7768 656e 2065 6e76 6972 6f6e when environ │ │ │ │ │ -0002c6b0: 6d65 6e74 2076 6172 6961 626c 6520 2763 ment variable 'c │ │ │ │ │ -0002c6c0: 6865 636b 5f73 6967 6e61 7475 7265 7327 heck_signatures' │ │ │ │ │ -0002c6d0: 2069 7320 7365 7420 746f 2027 656e 666f is set to 'enfo │ │ │ │ │ -0002c6e0: 7263 6527 0a20 2020 2020 282a 6e6f 7465 rce'. (*note │ │ │ │ │ -0002c6f0: 2063 6865 636b 5f73 6967 6e61 7475 7265 check_signature │ │ │ │ │ -0002c700: 733a 3a29 2c20 616e 6420 6279 2073 6f6d s::), and by som │ │ │ │ │ -0002c710: 6520 696e 766f 6361 7469 6f6e 7320 6f66 e invocations of │ │ │ │ │ -0002c720: 0a20 2020 2020 2776 6572 6966 795f 6465 . 'verify_de │ │ │ │ │ -0002c730: 7461 6368 6564 2720 282a 6e6f 7465 2076 tached' (*note v │ │ │ │ │ -0002c740: 6572 6966 795f 6465 7461 6368 6564 3a3a erify_detached:: │ │ │ │ │ -0002c750: 292e 2020 2a4e 6f74 6520 5573 696e 6720 ). *Note Using │ │ │ │ │ -0002c760: 6469 6769 7461 6c0a 2020 2020 2073 6967 digital. sig │ │ │ │ │ -0002c770: 6e61 7475 7265 733a 3a2c 2066 6f72 206d natures::, for m │ │ │ │ │ -0002c780: 6f72 6520 696e 666f 726d 6174 696f 6e2e ore information. │ │ │ │ │ -0002c790: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -0002c7a0: 6e66 6f2c 2020 4e6f 6465 3a20 6472 6976 nfo, Node: driv │ │ │ │ │ -0002c7b0: 656d 6170 2c20 204e 6578 743a 2065 6368 emap, Next: ech │ │ │ │ │ -0002c7c0: 6f2c 2020 5072 6576 3a20 6469 7374 7275 o, Prev: distru │ │ │ │ │ -0002c7d0: 7374 2c20 2055 703a 2043 6f6d 6d61 6e64 st, Up: Command │ │ │ │ │ -0002c7e0: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ -0002c7f0: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ -0002c800: 362e 332e 3234 2064 7269 7665 6d61 700a 6.3.24 drivemap. │ │ │ │ │ -0002c810: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0002c820: 0a0a 202d 2d20 436f 6d6d 616e 643a 2064 .. -- Command: d │ │ │ │ │ -0002c830: 7269 7665 6d61 7020 2d6c 7c2d 727c 5b2d rivemap -l|-r|[- │ │ │ │ │ -0002c840: 735d 2066 726f 6d5f 6472 6976 6520 746f s] from_drive to │ │ │ │ │ -0002c850: 5f64 7269 7665 0a20 2020 2020 5769 7468 _drive. With │ │ │ │ │ -0002c860: 6f75 7420 6f70 7469 6f6e 732c 206d 6170 out options, map │ │ │ │ │ -0002c870: 2074 6865 2064 7269 7665 2046 524f 4d5f the drive FROM_ │ │ │ │ │ -0002c880: 4452 4956 4520 746f 2074 6865 2064 7269 DRIVE to the dri │ │ │ │ │ -0002c890: 7665 2054 4f5f 4452 4956 452e 0a20 2020 ve TO_DRIVE.. │ │ │ │ │ -0002c8a0: 2020 5468 6973 2069 7320 6e65 6365 7373 This is necess │ │ │ │ │ -0002c8b0: 6172 7920 7768 656e 2079 6f75 2063 6861 ary when you cha │ │ │ │ │ -0002c8c0: 696e 2d6c 6f61 6420 736f 6d65 206f 7065 in-load some ope │ │ │ │ │ -0002c8d0: 7261 7469 6e67 2073 7973 7465 6d73 2c20 rating systems, │ │ │ │ │ -0002c8e0: 7375 6368 0a20 2020 2020 6173 2044 4f53 such. as DOS │ │ │ │ │ -0002c8f0: 2c20 6966 2073 7563 6820 616e 204f 5320 , if such an OS │ │ │ │ │ -0002c900: 7265 7369 6465 7320 6174 2061 206e 6f6e resides at a non │ │ │ │ │ -0002c910: 2d66 6972 7374 2064 7269 7665 2e20 2046 -first drive. F │ │ │ │ │ -0002c920: 6f72 0a20 2020 2020 636f 6e76 656e 6965 or. convenie │ │ │ │ │ -0002c930: 6e63 652c 2061 6e79 2070 6172 7469 7469 nce, any partiti │ │ │ │ │ -0002c940: 6f6e 2073 7566 6669 7820 6f6e 2074 6865 on suffix on the │ │ │ │ │ -0002c950: 2064 7269 7665 2069 7320 6967 6e6f 7265 drive is ignore │ │ │ │ │ -0002c960: 642c 2073 6f20 796f 750a 2020 2020 2063 d, so you. c │ │ │ │ │ -0002c970: 616e 2073 6166 656c 7920 7573 6520 247b an safely use ${ │ │ │ │ │ -0002c980: 726f 6f74 7d20 6173 2061 2064 7269 7665 root} as a drive │ │ │ │ │ -0002c990: 2073 7065 6369 6669 6361 7469 6f6e 2e0a specification.. │ │ │ │ │ -0002c9a0: 0a20 2020 2020 5769 7468 2074 6865 2027 . With the ' │ │ │ │ │ -0002c9b0: 2d73 2720 6f70 7469 6f6e 2c20 7065 7266 -s' option, perf │ │ │ │ │ -0002c9c0: 6f72 6d20 7468 6520 7265 7665 7273 6520 orm the reverse │ │ │ │ │ -0002c9d0: 6d61 7070 696e 6720 6173 2077 656c 6c2c mapping as well, │ │ │ │ │ -0002c9e0: 2073 7761 7070 696e 670a 2020 2020 2074 swapping. t │ │ │ │ │ -0002c9f0: 6865 2074 776f 2064 7269 7665 732e 0a0a he two drives... │ │ │ │ │ -0002ca00: 2020 2020 2057 6974 6820 7468 6520 272d With the '- │ │ │ │ │ -0002ca10: 6c27 206f 7074 696f 6e2c 206c 6973 7420 l' option, list │ │ │ │ │ -0002ca20: 7468 6520 6375 7272 656e 7420 6d61 7070 the current mapp │ │ │ │ │ -0002ca30: 696e 6773 2e0a 0a20 2020 2020 5769 7468 ings... With │ │ │ │ │ -0002ca40: 2074 6865 2027 2d72 2720 6f70 7469 6f6e the '-r' option │ │ │ │ │ -0002ca50: 2c20 7265 7365 7420 616c 6c20 6d61 7070 , reset all mapp │ │ │ │ │ -0002ca60: 696e 6773 2074 6f20 7468 6520 6465 6661 ings to the defa │ │ │ │ │ -0002ca70: 756c 7420 7661 6c75 6573 2e0a 0a20 2020 ult values... │ │ │ │ │ -0002ca80: 2020 466f 7220 6578 616d 706c 653a 0a0a For example:.. │ │ │ │ │ -0002ca90: 2020 2020 2020 2020 2020 6472 6976 656d drivem │ │ │ │ │ -0002caa0: 6170 202d 7320 2868 6430 2920 2868 6431 ap -s (hd0) (hd1 │ │ │ │ │ -0002cab0: 290a 0a1f 0a46 696c 653a 2067 7275 622e )....File: grub. │ │ │ │ │ -0002cac0: 696e 666f 2c20 204e 6f64 653a 2065 6368 info, Node: ech │ │ │ │ │ -0002cad0: 6f2c 2020 4e65 7874 3a20 6576 616c 2c20 o, Next: eval, │ │ │ │ │ -0002cae0: 2050 7265 763a 2064 7269 7665 6d61 702c Prev: drivemap, │ │ │ │ │ -0002caf0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ -0002cb00: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ -0002cb10: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ -0002cb20: 2e32 3520 6563 686f 0a2d 2d2d 2d2d 2d2d .25 echo.------- │ │ │ │ │ -0002cb30: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -0002cb40: 6e64 3a20 6563 686f 205b 2d6e 5d20 5b2d nd: echo [-n] [- │ │ │ │ │ -0002cb50: 655d 2073 7472 696e 6720 2e2e 2e0a 2020 e] string .... │ │ │ │ │ -0002cb60: 2020 2044 6973 706c 6179 2074 6865 2072 Display the r │ │ │ │ │ -0002cb70: 6571 7565 7374 6564 2074 6578 7420 616e equested text an │ │ │ │ │ -0002cb80: 642c 2075 6e6c 6573 7320 7468 6520 272d d, unless the '- │ │ │ │ │ -0002cb90: 6e27 206f 7074 696f 6e20 6973 2075 7365 n' option is use │ │ │ │ │ -0002cba0: 642c 2061 0a20 2020 2020 7472 6169 6c69 d, a. traili │ │ │ │ │ -0002cbb0: 6e67 206e 6577 206c 696e 652e 2020 4966 ng new line. If │ │ │ │ │ -0002cbc0: 2074 6865 7265 2069 7320 6d6f 7265 2074 there is more t │ │ │ │ │ -0002cbd0: 6861 6e20 6f6e 6520 7374 7269 6e67 2c20 han one string, │ │ │ │ │ -0002cbe0: 7468 6579 2061 7265 0a20 2020 2020 7365 they are. se │ │ │ │ │ -0002cbf0: 7061 7261 7465 6420 6279 2073 7061 6365 parated by space │ │ │ │ │ -0002cc00: 7320 696e 2074 6865 206f 7574 7075 742e s in the output. │ │ │ │ │ -0002cc10: 2020 4173 2075 7375 616c 2069 6e20 4752 As usual in GR │ │ │ │ │ -0002cc20: 5542 2063 6f6d 6d61 6e64 732c 0a20 2020 UB commands,. │ │ │ │ │ -0002cc30: 2020 7661 7269 6162 6c65 7320 6d61 7920 variables may │ │ │ │ │ -0002cc40: 6265 2073 7562 7374 6974 7574 6564 2075 be substituted u │ │ │ │ │ -0002cc50: 7369 6e67 2027 247b 7661 727d 272e 0a0a sing '${var}'... │ │ │ │ │ -0002cc60: 2020 2020 2054 6865 2027 2d65 2720 6f70 The '-e' op │ │ │ │ │ -0002cc70: 7469 6f6e 2065 6e61 626c 6573 2069 6e74 tion enables int │ │ │ │ │ -0002cc80: 6572 7072 6574 6174 696f 6e20 6f66 2062 erpretation of b │ │ │ │ │ -0002cc90: 6163 6b73 6c61 7368 2065 7363 6170 6573 ackslash escapes │ │ │ │ │ -0002cca0: 2e20 2054 6865 0a20 2020 2020 666f 6c6c . The. foll │ │ │ │ │ -0002ccb0: 6f77 696e 6720 7365 7175 656e 6365 7320 owing sequences │ │ │ │ │ -0002ccc0: 6172 6520 7265 636f 676e 6973 6564 3a0a are recognised:. │ │ │ │ │ -0002ccd0: 0a20 2020 2020 275c 5c27 0a20 2020 2020 . '\\'. │ │ │ │ │ -0002cce0: 2020 2020 2062 6163 6b73 6c61 7368 0a0a backslash.. │ │ │ │ │ -0002ccf0: 2020 2020 2027 5c61 270a 2020 2020 2020 '\a'. │ │ │ │ │ -0002cd00: 2020 2020 616c 6572 7420 2842 454c 290a alert (BEL). │ │ │ │ │ -0002cd10: 0a20 2020 2020 275c 6327 0a20 2020 2020 . '\c'. │ │ │ │ │ -0002cd20: 2020 2020 2073 7570 7072 6573 7320 7472 suppress tr │ │ │ │ │ -0002cd30: 6169 6c69 6e67 206e 6577 206c 696e 650a ailing new line. │ │ │ │ │ -0002cd40: 0a20 2020 2020 275c 6627 0a20 2020 2020 . '\f'. │ │ │ │ │ -0002cd50: 2020 2020 2066 6f72 6d20 6665 6564 0a0a form feed.. │ │ │ │ │ -0002cd60: 2020 2020 2027 5c6e 270a 2020 2020 2020 '\n'. │ │ │ │ │ -0002cd70: 2020 2020 6e65 7720 6c69 6e65 0a0a 2020 new line.. │ │ │ │ │ -0002cd80: 2020 2027 5c72 270a 2020 2020 2020 2020 '\r'. │ │ │ │ │ -0002cd90: 2020 6361 7272 6961 6765 2072 6574 7572 carriage retur │ │ │ │ │ -0002cda0: 6e0a 0a20 2020 2020 275c 7427 0a20 2020 n.. '\t'. │ │ │ │ │ -0002cdb0: 2020 2020 2020 2068 6f72 697a 6f6e 7461 horizonta │ │ │ │ │ -0002cdc0: 6c20 7461 620a 0a20 2020 2020 275c 7627 l tab.. '\v' │ │ │ │ │ -0002cdd0: 0a20 2020 2020 2020 2020 2076 6572 7469 . verti │ │ │ │ │ -0002cde0: 6361 6c20 7461 620a 0a20 2020 2020 5768 cal tab.. Wh │ │ │ │ │ -0002cdf0: 656e 2069 6e74 6572 7072 6574 696e 6720 en interpreting │ │ │ │ │ -0002ce00: 6261 636b 736c 6173 6820 6573 6361 7065 backslash escape │ │ │ │ │ -0002ce10: 732c 2062 6163 6b73 6c61 7368 2066 6f6c s, backslash fol │ │ │ │ │ -0002ce20: 6c6f 7765 6420 6279 2061 6e79 0a20 2020 lowed by any. │ │ │ │ │ -0002ce30: 2020 6f74 6865 7220 6368 6172 6163 7465 other characte │ │ │ │ │ -0002ce40: 7220 7769 6c6c 2070 7269 6e74 2074 6861 r will print tha │ │ │ │ │ -0002ce50: 7420 6368 6172 6163 7465 722e 0a0a 1f0a t character..... │ │ │ │ │ -0002ce60: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -0002ce70: 2020 4e6f 6465 3a20 6576 616c 2c20 204e Node: eval, N │ │ │ │ │ -0002ce80: 6578 743a 2065 7870 6f72 742c 2020 5072 ext: export, Pr │ │ │ │ │ -0002ce90: 6576 3a20 6563 686f 2c20 2055 703a 2043 ev: echo, Up: C │ │ │ │ │ -0002cea0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ -0002ceb0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ -0002cec0: 6e64 730a 0a31 362e 332e 3236 2065 7661 nds..16.3.26 eva │ │ │ │ │ -0002ced0: 6c0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a l.------------.. │ │ │ │ │ -0002cee0: 202d 2d20 436f 6d6d 616e 643a 2065 7661 -- Command: eva │ │ │ │ │ -0002cef0: 6c20 7374 7269 6e67 202e 2e2e 0a20 2020 l string .... │ │ │ │ │ -0002cf00: 2020 436f 6e63 6174 656e 6174 6520 6172 Concatenate ar │ │ │ │ │ -0002cf10: 6775 6d65 6e74 7320 746f 6765 7468 6572 guments together │ │ │ │ │ -0002cf20: 2075 7369 6e67 2073 696e 676c 6520 7370 using single sp │ │ │ │ │ -0002cf30: 6163 6520 6173 2073 6570 6172 6174 6f72 ace as separator │ │ │ │ │ -0002cf40: 2061 6e64 0a20 2020 2020 6576 616c 7561 and. evalua │ │ │ │ │ -0002cf50: 7465 2072 6573 756c 7420 6173 2073 6571 te result as seq │ │ │ │ │ -0002cf60: 7565 6e63 6520 6f66 2047 5255 4220 636f uence of GRUB co │ │ │ │ │ -0002cf70: 6d6d 616e 6473 2e0a 0a1f 0a46 696c 653a mmands.....File: │ │ │ │ │ -0002cf80: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -0002cf90: 653a 2065 7870 6f72 742c 2020 4e65 7874 e: export, Next │ │ │ │ │ -0002cfa0: 3a20 6661 6c73 652c 2020 5072 6576 3a20 : false, Prev: │ │ │ │ │ -0002cfb0: 6576 616c 2c20 2055 703a 2043 6f6d 6d61 eval, Up: Comma │ │ │ │ │ -0002cfc0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -0002cfd0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ -0002cfe0: 0a31 362e 332e 3237 2065 7870 6f72 740a .16.3.27 export. │ │ │ │ │ -0002cff0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -0002d000: 202d 2d20 436f 6d6d 616e 643a 2065 7870 -- Command: exp │ │ │ │ │ -0002d010: 6f72 7420 656e 7676 6172 0a20 2020 2020 ort envvar. │ │ │ │ │ -0002d020: 4578 706f 7274 2074 6865 2065 6e76 6972 Export the envir │ │ │ │ │ -0002d030: 6f6e 6d65 6e74 2076 6172 6961 626c 6520 onment variable │ │ │ │ │ -0002d040: 454e 5656 4152 2e20 2045 7870 6f72 7465 ENVVAR. Exporte │ │ │ │ │ -0002d050: 6420 7661 7269 6162 6c65 7320 6172 650a d variables are. │ │ │ │ │ -0002d060: 2020 2020 2076 6973 6962 6c65 2074 6f20 visible to │ │ │ │ │ -0002d070: 7375 6273 6964 6961 7279 2063 6f6e 6669 subsidiary confi │ │ │ │ │ -0002d080: 6775 7261 7469 6f6e 2066 696c 6573 206c guration files l │ │ │ │ │ -0002d090: 6f61 6465 6420 7573 696e 670a 2020 2020 oaded using. │ │ │ │ │ -0002d0a0: 2027 636f 6e66 6967 6669 6c65 272e 0a0a 'configfile'... │ │ │ │ │ -0002d0b0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -0002d0c0: 6f2c 2020 4e6f 6465 3a20 6661 6c73 652c o, Node: false, │ │ │ │ │ -0002d0d0: 2020 4e65 7874 3a20 6765 7474 6578 742c Next: gettext, │ │ │ │ │ -0002d0e0: 2020 5072 6576 3a20 6578 706f 7274 2c20 Prev: export, │ │ │ │ │ -0002d0f0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ -0002d100: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ -0002d110: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ -0002d120: 3238 2066 616c 7365 0a2d 2d2d 2d2d 2d2d 28 false.------- │ │ │ │ │ -0002d130: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -0002d140: 616e 643a 2066 616c 7365 0a20 2020 2020 and: false. │ │ │ │ │ -0002d150: 446f 206e 6f74 6869 6e67 2c20 756e 7375 Do nothing, unsu │ │ │ │ │ -0002d160: 6363 6573 7366 756c 6c79 2e20 2054 6869 ccessfully. Thi │ │ │ │ │ -0002d170: 7320 6973 206d 6169 6e6c 7920 7573 6566 s is mainly usef │ │ │ │ │ -0002d180: 756c 2069 6e20 636f 6e74 726f 6c0a 2020 ul in control. │ │ │ │ │ -0002d190: 2020 2063 6f6e 7374 7275 6374 7320 7375 constructs su │ │ │ │ │ -0002d1a0: 6368 2061 7320 2769 6627 2061 6e64 2027 ch as 'if' and ' │ │ │ │ │ -0002d1b0: 7768 696c 6527 2028 2a6e 6f74 6520 5368 while' (*note Sh │ │ │ │ │ -0002d1c0: 656c 6c2d 6c69 6b65 2073 6372 6970 7469 ell-like scripti │ │ │ │ │ -0002d1d0: 6e67 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 ng::).....File: │ │ │ │ │ -0002d1e0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -0002d1f0: 3a20 6765 7474 6578 742c 2020 4e65 7874 : gettext, Next │ │ │ │ │ -0002d200: 3a20 6770 7473 796e 632c 2020 5072 6576 : gptsync, Prev │ │ │ │ │ -0002d210: 3a20 6661 6c73 652c 2020 5570 3a20 436f : false, Up: Co │ │ │ │ │ -0002d220: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -0002d230: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -0002d240: 6473 0a0a 3136 2e33 2e32 3920 6765 7474 ds..16.3.29 gett │ │ │ │ │ -0002d250: 6578 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ext.------------ │ │ │ │ │ -0002d260: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -0002d270: 3a20 6765 7474 6578 7420 7374 7269 6e67 : gettext string │ │ │ │ │ -0002d280: 0a20 2020 2020 5472 616e 736c 6174 6520 . Translate │ │ │ │ │ -0002d290: 5354 5249 4e47 2069 6e74 6f20 7468 6520 STRING into the │ │ │ │ │ -0002d2a0: 6375 7272 656e 7420 6c61 6e67 7561 6765 current language │ │ │ │ │ -0002d2b0: 2e0a 0a20 2020 2020 5468 6520 6375 7272 ... The curr │ │ │ │ │ -0002d2c0: 656e 7420 6c61 6e67 7561 6765 2063 6f64 ent language cod │ │ │ │ │ -0002d2d0: 6520 6973 2073 746f 7265 6420 696e 2074 e is stored in t │ │ │ │ │ -0002d2e0: 6865 2027 6c61 6e67 2720 7661 7269 6162 he 'lang' variab │ │ │ │ │ -0002d2f0: 6c65 2069 6e0a 2020 2020 2047 5255 4227 le in. GRUB' │ │ │ │ │ -0002d300: 7320 656e 7669 726f 6e6d 656e 7420 282a s environment (* │ │ │ │ │ -0002d310: 6e6f 7465 206c 616e 673a 3a29 2e20 2054 note lang::). T │ │ │ │ │ -0002d320: 7261 6e73 6c61 7469 6f6e 2066 696c 6573 ranslation files │ │ │ │ │ -0002d330: 2069 6e20 4d4f 2066 6f72 6d61 740a 2020 in MO format. │ │ │ │ │ -0002d340: 2020 2061 7265 2072 6561 6420 6672 6f6d are read from │ │ │ │ │ -0002d350: 2027 6c6f 6361 6c65 5f64 6972 2720 282a 'locale_dir' (* │ │ │ │ │ -0002d360: 6e6f 7465 206c 6f63 616c 655f 6469 723a note locale_dir: │ │ │ │ │ -0002d370: 3a29 2c20 7573 7561 6c6c 790a 2020 2020 :), usually. │ │ │ │ │ -0002d380: 2027 2f62 6f6f 742f 6772 7562 2f6c 6f63 '/boot/grub/loc │ │ │ │ │ -0002d390: 616c 6527 2e0a 0a1f 0a46 696c 653a 2067 ale'.....File: g │ │ │ │ │ -0002d3a0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0002d3b0: 2067 7074 7379 6e63 2c20 204e 6578 743a gptsync, Next: │ │ │ │ │ -0002d3c0: 2068 616c 742c 2020 5072 6576 3a20 6765 halt, Prev: ge │ │ │ │ │ -0002d3d0: 7474 6578 742c 2020 5570 3a20 436f 6d6d ttext, Up: Comm │ │ │ │ │ -0002d3e0: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -0002d3f0: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -0002d400: 0a0a 3136 2e33 2e33 3020 6770 7473 796e ..16.3.30 gptsyn │ │ │ │ │ -0002d410: 630a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d c.-------------- │ │ │ │ │ -0002d420: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -0002d430: 6770 7473 796e 6320 6465 7669 6365 205b gptsync device [ │ │ │ │ │ -0002d440: 7061 7274 6974 696f 6e5b 2b2f 2d5b 7479 partition[+/-[ty │ │ │ │ │ -0002d450: 7065 5d5d 5d20 2e2e 2e0a 2020 2020 2044 pe]]] .... D │ │ │ │ │ -0002d460: 6973 6b73 2075 7369 6e67 2074 6865 2047 isks using the G │ │ │ │ │ -0002d470: 5549 4420 5061 7274 6974 696f 6e20 5461 UID Partition Ta │ │ │ │ │ -0002d480: 626c 6520 2847 5054 2920 616c 736f 2068 ble (GPT) also h │ │ │ │ │ -0002d490: 6176 6520 6120 6c65 6761 6379 0a20 2020 ave a legacy. │ │ │ │ │ -0002d4a0: 2020 4d61 7374 6572 2042 6f6f 7420 5265 Master Boot Re │ │ │ │ │ -0002d4b0: 636f 7264 2028 4d42 5229 2070 6172 7469 cord (MBR) parti │ │ │ │ │ -0002d4c0: 7469 6f6e 2074 6162 6c65 2066 6f72 2063 tion table for c │ │ │ │ │ -0002d4d0: 6f6d 7061 7469 6269 6c69 7479 2077 6974 ompatibility wit │ │ │ │ │ -0002d4e0: 6820 7468 650a 2020 2020 2042 494f 5320 h the. BIOS │ │ │ │ │ -0002d4f0: 616e 6420 7769 7468 206f 6c64 6572 206f and with older o │ │ │ │ │ -0002d500: 7065 7261 7469 6e67 2073 7973 7465 6d73 perating systems │ │ │ │ │ -0002d510: 2e20 2054 6865 206c 6567 6163 7920 4d42 . The legacy MB │ │ │ │ │ -0002d520: 5220 6361 6e20 6f6e 6c79 0a20 2020 2020 R can only. │ │ │ │ │ -0002d530: 7265 7072 6573 656e 7420 6120 6c69 6d69 represent a limi │ │ │ │ │ -0002d540: 7465 6420 7375 6273 6574 206f 6620 4750 ted subset of GP │ │ │ │ │ -0002d550: 5420 7061 7274 6974 696f 6e20 656e 7472 T partition entr │ │ │ │ │ -0002d560: 6965 732e 0a0a 2020 2020 2054 6869 7320 ies... This │ │ │ │ │ -0002d570: 636f 6d6d 616e 6420 706f 7075 6c61 7465 command populate │ │ │ │ │ -0002d580: 7320 7468 6520 6c65 6761 6379 204d 4252 s the legacy MBR │ │ │ │ │ -0002d590: 2077 6974 6820 7468 6520 7370 6563 6966 with the specif │ │ │ │ │ -0002d5a0: 6965 6420 5041 5254 4954 494f 4e0a 2020 ied PARTITION. │ │ │ │ │ -0002d5b0: 2020 2065 6e74 7269 6573 206f 6e20 4445 entries on DE │ │ │ │ │ -0002d5c0: 5649 4345 2e20 2055 7020 746f 2074 6872 VICE. Up to thr │ │ │ │ │ -0002d5d0: 6565 2070 6172 7469 7469 6f6e 7320 6d61 ee partitions ma │ │ │ │ │ -0002d5e0: 7920 6265 2075 7365 642e 0a0a 2020 2020 y be used... │ │ │ │ │ -0002d5f0: 2054 5950 4520 6973 2061 6e20 4d42 5220 TYPE is an MBR │ │ │ │ │ -0002d600: 7061 7274 6974 696f 6e20 7479 7065 2063 partition type c │ │ │ │ │ -0002d610: 6f64 653b 2070 7265 6669 7820 7769 7468 ode; prefix with │ │ │ │ │ -0002d620: 2027 3078 2720 6966 2079 6f75 2077 616e '0x' if you wan │ │ │ │ │ -0002d630: 7420 746f 0a20 2020 2020 656e 7465 7220 t to. enter │ │ │ │ │ -0002d640: 7468 6973 2069 6e20 6865 7861 6465 6369 this in hexadeci │ │ │ │ │ -0002d650: 6d61 6c2e 2020 5468 6520 7365 7061 7261 mal. The separa │ │ │ │ │ -0002d660: 746f 7220 6265 7477 6565 6e20 5041 5254 tor between PART │ │ │ │ │ -0002d670: 4954 494f 4e20 616e 640a 2020 2020 2054 ITION and. T │ │ │ │ │ -0002d680: 5950 4520 6d61 7920 6265 2027 2b27 2074 YPE may be '+' t │ │ │ │ │ -0002d690: 6f20 6d61 6b65 2074 6865 2070 6172 7469 o make the parti │ │ │ │ │ -0002d6a0: 7469 6f6e 2061 6374 6976 652c 206f 7220 tion active, or │ │ │ │ │ -0002d6b0: 272d 2720 746f 206d 616b 6520 6974 0a20 '-' to make it. │ │ │ │ │ -0002d6c0: 2020 2020 696e 6163 7469 7665 3b20 6f6e inactive; on │ │ │ │ │ -0002d6d0: 6c79 206f 6e65 2070 6172 7469 7469 6f6e ly one partition │ │ │ │ │ -0002d6e0: 206d 6179 2062 6520 6163 7469 7665 2e20 may be active. │ │ │ │ │ -0002d6f0: 2049 6620 626f 7468 2074 6865 2073 6570 If both the sep │ │ │ │ │ -0002d700: 6172 6174 6f72 0a20 2020 2020 616e 6420 arator. and │ │ │ │ │ -0002d710: 7479 7065 2061 7265 206f 6d69 7474 6564 type are omitted │ │ │ │ │ -0002d720: 2c20 7468 656e 2074 6865 2070 6172 7469 , then the parti │ │ │ │ │ -0002d730: 7469 6f6e 2077 696c 6c20 6265 2069 6e61 tion will be ina │ │ │ │ │ -0002d740: 6374 6976 652e 0a0a 1f0a 4669 6c65 3a20 ctive.....File: │ │ │ │ │ -0002d750: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -0002d760: 3a20 6861 6c74 2c20 204e 6578 743a 2068 : halt, Next: h │ │ │ │ │ -0002d770: 6173 6873 756d 2c20 2050 7265 763a 2067 ashsum, Prev: g │ │ │ │ │ -0002d780: 7074 7379 6e63 2c20 2055 703a 2043 6f6d ptsync, Up: Com │ │ │ │ │ -0002d790: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ -0002d7a0: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ -0002d7b0: 730a 0a31 362e 332e 3331 2068 616c 740a s..16.3.31 halt. │ │ │ │ │ -0002d7c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ -0002d7d0: 2d20 436f 6d6d 616e 643a 2068 616c 7420 - Command: halt │ │ │ │ │ -0002d7e0: 2d2d 6e6f 2d61 706d 0a20 2020 2020 5468 --no-apm. Th │ │ │ │ │ -0002d7f0: 6520 636f 6d6d 616e 6420 6861 6c74 7320 e command halts │ │ │ │ │ -0002d800: 7468 6520 636f 6d70 7574 6572 2e20 2049 the computer. I │ │ │ │ │ -0002d810: 6620 7468 6520 272d 2d6e 6f2d 6170 6d27 f the '--no-apm' │ │ │ │ │ -0002d820: 206f 7074 696f 6e20 6973 0a20 2020 2020 option is. │ │ │ │ │ -0002d830: 7370 6563 6966 6965 642c 206e 6f20 4150 specified, no AP │ │ │ │ │ -0002d840: 4d20 4249 4f53 2063 616c 6c20 6973 2070 M BIOS call is p │ │ │ │ │ -0002d850: 6572 666f 726d 6564 2e20 204f 7468 6572 erformed. Other │ │ │ │ │ -0002d860: 7769 7365 2c20 7468 6520 636f 6d70 7574 wise, the comput │ │ │ │ │ -0002d870: 6572 0a20 2020 2020 6973 2073 6875 7420 er. is shut │ │ │ │ │ -0002d880: 646f 776e 2075 7369 6e67 2041 504d 2e0a down using APM.. │ │ │ │ │ -0002d890: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -0002d8a0: 666f 2c20 204e 6f64 653a 2068 6173 6873 fo, Node: hashs │ │ │ │ │ -0002d8b0: 756d 2c20 204e 6578 743a 2068 656c 702c um, Next: help, │ │ │ │ │ -0002d8c0: 2020 5072 6576 3a20 6861 6c74 2c20 2055 Prev: halt, U │ │ │ │ │ -0002d8d0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -0002d8e0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -0002d8f0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3332 ommands..16.3.32 │ │ │ │ │ -0002d900: 2068 6173 6873 756d 0a2d 2d2d 2d2d 2d2d hashsum.------- │ │ │ │ │ -0002d910: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -0002d920: 6d6d 616e 643a 2068 6173 6873 756d 202d mmand: hashsum - │ │ │ │ │ -0002d930: 2d68 6173 6820 6861 7368 202d 2d6b 6565 -hash hash --kee │ │ │ │ │ -0002d940: 702d 676f 696e 6720 2d2d 756e 636f 6d70 p-going --uncomp │ │ │ │ │ -0002d950: 7265 7373 202d 2d63 6865 636b 2066 696c ress --check fil │ │ │ │ │ -0002d960: 650a 2020 2020 2020 2020 2020 5b2d 2d70 e. [--p │ │ │ │ │ -0002d970: 7265 6669 7820 6469 725d 7c66 696c 6520 refix dir]|file │ │ │ │ │ -0002d980: 2e2e 2e0a 2020 2020 2043 6f6d 7075 7465 .... Compute │ │ │ │ │ -0002d990: 206f 7220 7665 7269 6679 2066 696c 6520 or verify file │ │ │ │ │ -0002d9a0: 6861 7368 6573 2e20 2048 6173 6820 7479 hashes. Hash ty │ │ │ │ │ -0002d9b0: 7065 2069 7320 7365 6c65 6374 6564 2077 pe is selected w │ │ │ │ │ -0002d9c0: 6974 6820 6f70 7469 6f6e 0a20 2020 2020 ith option. │ │ │ │ │ -0002d9d0: 272d 2d68 6173 6827 2e20 2053 7570 706f '--hash'. Suppo │ │ │ │ │ -0002d9e0: 7274 6564 2068 6173 6865 7320 6172 653a rted hashes are: │ │ │ │ │ -0002d9f0: 2027 6164 6c65 7233 3227 2c20 2763 7263 'adler32', 'crc │ │ │ │ │ -0002da00: 3634 272c 2027 6372 6333 3227 2c0a 2020 64', 'crc32',. │ │ │ │ │ -0002da10: 2020 2027 6372 6333 3272 6663 3135 3130 'crc32rfc1510 │ │ │ │ │ -0002da20: 272c 2027 6372 6332 3472 6663 3234 3430 ', 'crc24rfc2440 │ │ │ │ │ -0002da30: 272c 2027 6d64 3427 2c20 276d 6435 272c ', 'md4', 'md5', │ │ │ │ │ -0002da40: 2027 7269 7065 6d64 3136 3027 2c20 2773 'ripemd160', 's │ │ │ │ │ -0002da50: 6861 3127 2c0a 2020 2020 2027 7368 6132 ha1',. 'sha2 │ │ │ │ │ -0002da60: 3234 272c 2027 7368 6132 3536 272c 2027 24', 'sha256', ' │ │ │ │ │ -0002da70: 7368 6135 3132 272c 2027 7368 6133 3834 sha512', 'sha384 │ │ │ │ │ -0002da80: 272c 2027 7469 6765 7231 3932 272c 2027 ', 'tiger192', ' │ │ │ │ │ -0002da90: 7469 6765 7227 2c0a 2020 2020 2027 7469 tiger',. 'ti │ │ │ │ │ -0002daa0: 6765 7232 272c 2027 7768 6972 6c70 6f6f ger2', 'whirlpoo │ │ │ │ │ -0002dab0: 6c27 2e20 204f 7074 696f 6e20 272d 2d75 l'. Option '--u │ │ │ │ │ -0002dac0: 6e63 6f6d 7072 6573 7327 2075 6e63 6f6d ncompress' uncom │ │ │ │ │ -0002dad0: 7072 6573 7365 7320 6669 6c65 730a 2020 presses files. │ │ │ │ │ -0002dae0: 2020 2062 6566 6f72 6520 636f 6d70 7574 before comput │ │ │ │ │ -0002daf0: 696e 6720 6861 7368 2e0a 0a20 2020 2020 ing hash... │ │ │ │ │ -0002db00: 5768 656e 206c 6973 7420 6f66 2066 696c When list of fil │ │ │ │ │ -0002db10: 6573 2069 7320 6769 7665 6e2c 2068 6173 es is given, has │ │ │ │ │ -0002db20: 6820 6f66 2065 6163 6820 6669 6c65 2069 h of each file i │ │ │ │ │ -0002db30: 7320 636f 6d70 7574 6564 2061 6e64 0a20 s computed and. │ │ │ │ │ -0002db40: 2020 2020 7072 696e 7465 642c 2066 6f6c printed, fol │ │ │ │ │ -0002db50: 6c6f 7765 6420 6279 2066 696c 6520 6e61 lowed by file na │ │ │ │ │ -0002db60: 6d65 2c20 6561 6368 2066 696c 6520 6f6e me, each file on │ │ │ │ │ -0002db70: 2061 206e 6577 206c 696e 652e 0a0a 2020 a new line... │ │ │ │ │ -0002db80: 2020 2057 6865 6e20 6f70 7469 6f6e 2027 When option ' │ │ │ │ │ -0002db90: 2d2d 6368 6563 6b27 2069 7320 6769 7665 --check' is give │ │ │ │ │ -0002dba0: 6e2c 2069 7420 706f 696e 7473 2074 6f20 n, it points to │ │ │ │ │ -0002dbb0: 6120 6669 6c65 2074 6861 7420 636f 6e74 a file that cont │ │ │ │ │ -0002dbc0: 6169 6e73 0a20 2020 2020 6c69 7374 206f ains. list o │ │ │ │ │ -0002dbd0: 6620 4841 5348 204e 414d 4520 7061 6972 f HASH NAME pair │ │ │ │ │ -0002dbe0: 7320 696e 2074 6865 2073 616d 6520 666f s in the same fo │ │ │ │ │ -0002dbf0: 726d 6174 2061 7320 7573 6564 2062 7920 rmat as used by │ │ │ │ │ -0002dc00: 554e 4958 2027 6d64 3573 756d 270a 2020 UNIX 'md5sum'. │ │ │ │ │ -0002dc10: 2020 2063 6f6d 6d61 6e64 2e20 204f 7074 command. Opt │ │ │ │ │ -0002dc20: 696f 6e20 272d 2d70 7265 6669 7827 206d ion '--prefix' m │ │ │ │ │ -0002dc30: 6179 2062 6520 7573 6564 2074 6f20 6769 ay be used to gi │ │ │ │ │ -0002dc40: 7665 2064 6972 6563 746f 7279 2077 6865 ve directory whe │ │ │ │ │ -0002dc50: 7265 0a20 2020 2020 6669 6c65 7320 6172 re. files ar │ │ │ │ │ -0002dc60: 6520 6c6f 6361 7465 642e 2020 4861 7368 e located. Hash │ │ │ │ │ -0002dc70: 2076 6572 6966 6963 6174 696f 6e20 7374 verification st │ │ │ │ │ -0002dc80: 6f70 7320 6166 7465 7220 7468 6520 6669 ops after the fi │ │ │ │ │ -0002dc90: 7273 740a 2020 2020 206d 6973 6d61 7463 rst. mismatc │ │ │ │ │ -0002dca0: 6820 7761 7320 666f 756e 6420 756e 6c65 h was found unle │ │ │ │ │ -0002dcb0: 7373 206f 7074 696f 6e20 272d 2d6b 6565 ss option '--kee │ │ │ │ │ -0002dcc0: 702d 676f 696e 6727 2077 6173 2067 6976 p-going' was giv │ │ │ │ │ -0002dcd0: 656e 2e20 2054 6865 0a20 2020 2020 6578 en. The. ex │ │ │ │ │ -0002dce0: 6974 2063 6f64 6520 2724 3f27 2069 7320 it code '$?' is │ │ │ │ │ -0002dcf0: 7365 7420 746f 2030 2069 6620 6861 7368 set to 0 if hash │ │ │ │ │ -0002dd00: 2076 6572 6966 6963 6174 696f 6e20 6973 verification is │ │ │ │ │ -0002dd10: 2073 7563 6365 7373 6675 6c2e 2020 4966 successful. If │ │ │ │ │ -0002dd20: 0a20 2020 2020 6974 2066 6169 6c73 2c20 . it fails, │ │ │ │ │ -0002dd30: 2724 3f27 2069 7320 7365 7420 746f 2061 '$?' is set to a │ │ │ │ │ -0002dd40: 206e 6f6e 7a65 726f 2076 616c 7565 2e0a nonzero value.. │ │ │ │ │ -0002dd50: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -0002dd60: 666f 2c20 204e 6f64 653a 2068 656c 702c fo, Node: help, │ │ │ │ │ -0002dd70: 2020 4e65 7874 3a20 696e 6974 7264 2c20 Next: initrd, │ │ │ │ │ -0002dd80: 2050 7265 763a 2068 6173 6873 756d 2c20 Prev: hashsum, │ │ │ │ │ -0002dd90: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ -0002dda0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ -0002ddb0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ -0002ddc0: 3333 2068 656c 700a 2d2d 2d2d 2d2d 2d2d 33 help.-------- │ │ │ │ │ -0002ddd0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -0002dde0: 643a 2068 656c 7020 5b70 6174 7465 726e d: help [pattern │ │ │ │ │ -0002ddf0: 202e 2e2e 5d0a 2020 2020 2044 6973 706c ...]. Displ │ │ │ │ │ -0002de00: 6179 2068 656c 7066 756c 2069 6e66 6f72 ay helpful infor │ │ │ │ │ -0002de10: 6d61 7469 6f6e 2061 626f 7574 2062 7569 mation about bui │ │ │ │ │ -0002de20: 6c74 696e 2063 6f6d 6d61 6e64 732e 2020 ltin commands. │ │ │ │ │ -0002de30: 4966 2079 6f75 2064 6f20 6e6f 740a 2020 If you do not. │ │ │ │ │ -0002de40: 2020 2073 7065 6369 6679 2050 4154 5445 specify PATTE │ │ │ │ │ -0002de50: 524e 2c20 7468 6973 2063 6f6d 6d61 6e64 RN, this command │ │ │ │ │ -0002de60: 2073 686f 7773 2073 686f 7274 2064 6573 shows short des │ │ │ │ │ -0002de70: 6372 6970 7469 6f6e 7320 6f66 2061 6c6c criptions of all │ │ │ │ │ -0002de80: 0a20 2020 2020 6176 6169 6c61 626c 6520 . available │ │ │ │ │ -0002de90: 636f 6d6d 616e 6473 2e0a 0a20 2020 2020 commands... │ │ │ │ │ -0002dea0: 4966 2079 6f75 2073 7065 6369 6679 2061 If you specify a │ │ │ │ │ -0002deb0: 6e79 2050 4154 5445 524e 532c 2069 7420 ny PATTERNS, it │ │ │ │ │ -0002dec0: 6469 7370 6c61 7973 206c 6f6e 6765 7220 displays longer │ │ │ │ │ -0002ded0: 696e 666f 726d 6174 696f 6e20 6162 6f75 information abou │ │ │ │ │ -0002dee0: 740a 2020 2020 2065 6163 6820 6f66 2074 t. each of t │ │ │ │ │ -0002def0: 6865 2063 6f6d 6d61 6e64 7320 7768 6f73 he commands whos │ │ │ │ │ -0002df00: 6520 6e61 6d65 7320 6265 6769 6e20 7769 e names begin wi │ │ │ │ │ -0002df10: 7468 2074 686f 7365 2050 4154 5445 524e th those PATTERN │ │ │ │ │ -0002df20: 532e 0a0a 1f0a 4669 6c65 3a20 6772 7562 S.....File: grub │ │ │ │ │ -0002df30: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 696e .info, Node: in │ │ │ │ │ -0002df40: 6974 7264 2c20 204e 6578 743a 2069 6e69 itrd, Next: ini │ │ │ │ │ -0002df50: 7472 6431 362c 2020 5072 6576 3a20 6865 trd16, Prev: he │ │ │ │ │ -0002df60: 6c70 2c20 2055 703a 2043 6f6d 6d61 6e64 lp, Up: Command │ │ │ │ │ -0002df70: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ -0002df80: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ -0002df90: 362e 332e 3334 2069 6e69 7472 640a 2d2d 6.3.34 initrd.-- │ │ │ │ │ -0002dfa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ -0002dfb0: 2d20 436f 6d6d 616e 643a 2069 6e69 7472 - Command: initr │ │ │ │ │ -0002dfc0: 6420 6669 6c65 205b 6669 6c65 202e 2e2e d file [file ... │ │ │ │ │ -0002dfd0: 5d0a 2020 2020 204c 6f61 642c 2069 6e20 ]. Load, in │ │ │ │ │ -0002dfe0: 6f72 6465 722c 2061 6c6c 2069 6e69 7469 order, all initi │ │ │ │ │ -0002dff0: 616c 2072 616d 6469 736b 7320 666f 7220 al ramdisks for │ │ │ │ │ -0002e000: 6120 4c69 6e75 7820 6b65 726e 656c 2069 a Linux kernel i │ │ │ │ │ -0002e010: 6d61 6765 2c20 616e 640a 2020 2020 2073 mage, and. s │ │ │ │ │ -0002e020: 6574 2074 6865 2061 7070 726f 7072 6961 et the appropria │ │ │ │ │ -0002e030: 7465 2070 6172 616d 6574 6572 7320 696e te parameters in │ │ │ │ │ -0002e040: 2074 6865 204c 696e 7578 2073 6574 7570 the Linux setup │ │ │ │ │ -0002e050: 2061 7265 6120 696e 206d 656d 6f72 792e area in memory. │ │ │ │ │ -0002e060: 0a20 2020 2020 5468 6973 206d 6179 206f . This may o │ │ │ │ │ -0002e070: 6e6c 7920 6265 2075 7365 6420 6166 7465 nly be used afte │ │ │ │ │ -0002e080: 7220 7468 6520 276c 696e 7578 2720 636f r the 'linux' co │ │ │ │ │ -0002e090: 6d6d 616e 6420 282a 6e6f 7465 206c 696e mmand (*note lin │ │ │ │ │ -0002e0a0: 7578 3a3a 2920 6861 730a 2020 2020 2062 ux::) has. b │ │ │ │ │ -0002e0b0: 6565 6e20 7275 6e2e 2020 5365 6520 616c een run. See al │ │ │ │ │ -0002e0c0: 736f 202a 6e6f 7465 2047 4e55 2f4c 696e so *note GNU/Lin │ │ │ │ │ -0002e0d0: 7578 3a3a 2e0a 0a1f 0a46 696c 653a 2067 ux::.....File: g │ │ │ │ │ -0002e0e0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0002e0f0: 2069 6e69 7472 6431 362c 2020 4e65 7874 initrd16, Next │ │ │ │ │ -0002e100: 3a20 696e 736d 6f64 2c20 2050 7265 763a : insmod, Prev: │ │ │ │ │ -0002e110: 2069 6e69 7472 642c 2020 5570 3a20 436f initrd, Up: Co │ │ │ │ │ -0002e120: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -0002e130: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -0002e140: 6473 0a0a 3136 2e33 2e33 3520 696e 6974 ds..16.3.35 init │ │ │ │ │ -0002e150: 7264 3136 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d rd16.----------- │ │ │ │ │ -0002e160: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -0002e170: 6e64 3a20 696e 6974 7264 3136 2066 696c nd: initrd16 fil │ │ │ │ │ -0002e180: 6520 5b66 696c 6520 2e2e 2e5d 0a20 2020 e [file ...]. │ │ │ │ │ -0002e190: 2020 4c6f 6164 2c20 696e 206f 7264 6572 Load, in order │ │ │ │ │ -0002e1a0: 2c20 616c 6c20 696e 6974 6961 6c20 7261 , all initial ra │ │ │ │ │ -0002e1b0: 6d64 6973 6b73 2066 6f72 2061 204c 696e mdisks for a Lin │ │ │ │ │ -0002e1c0: 7578 206b 6572 6e65 6c20 696d 6167 6520 ux kernel image │ │ │ │ │ -0002e1d0: 746f 2062 650a 2020 2020 2062 6f6f 7465 to be. boote │ │ │ │ │ -0002e1e0: 6420 696e 2031 362d 6269 7420 6d6f 6465 d in 16-bit mode │ │ │ │ │ -0002e1f0: 2c20 616e 6420 7365 7420 7468 6520 6170 , and set the ap │ │ │ │ │ -0002e200: 7072 6f70 7269 6174 6520 7061 7261 6d65 propriate parame │ │ │ │ │ -0002e210: 7465 7273 2069 6e20 7468 650a 2020 2020 ters in the. │ │ │ │ │ -0002e220: 204c 696e 7578 2073 6574 7570 2061 7265 Linux setup are │ │ │ │ │ -0002e230: 6120 696e 206d 656d 6f72 792e 2020 5468 a in memory. Th │ │ │ │ │ -0002e240: 6973 206d 6179 206f 6e6c 7920 6265 2075 is may only be u │ │ │ │ │ -0002e250: 7365 6420 6166 7465 7220 7468 650a 2020 sed after the. │ │ │ │ │ -0002e260: 2020 2027 6c69 6e75 7831 3627 2063 6f6d 'linux16' com │ │ │ │ │ -0002e270: 6d61 6e64 2028 2a6e 6f74 6520 6c69 6e75 mand (*note linu │ │ │ │ │ -0002e280: 7831 363a 3a29 2068 6173 2062 6565 6e20 x16::) has been │ │ │ │ │ -0002e290: 7275 6e2e 2020 5365 6520 616c 736f 202a run. See also * │ │ │ │ │ -0002e2a0: 6e6f 7465 0a20 2020 2020 474e 552f 4c69 note. GNU/Li │ │ │ │ │ -0002e2b0: 6e75 783a 3a2e 0a0a 2020 2020 2054 6869 nux::... Thi │ │ │ │ │ -0002e2c0: 7320 636f 6d6d 616e 6420 6973 206f 6e6c s command is onl │ │ │ │ │ -0002e2d0: 7920 6176 6169 6c61 626c 6520 6f6e 2078 y available on x │ │ │ │ │ -0002e2e0: 3836 2073 7973 7465 6d73 2e0a 0a1f 0a46 86 systems.....F │ │ │ │ │ -0002e2f0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -0002e300: 204e 6f64 653a 2069 6e73 6d6f 642c 2020 Node: insmod, │ │ │ │ │ -0002e310: 4e65 7874 3a20 6b65 7973 7461 7475 732c Next: keystatus, │ │ │ │ │ -0002e320: 2020 5072 6576 3a20 696e 6974 7264 3136 Prev: initrd16 │ │ │ │ │ -0002e330: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -0002e340: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -0002e350: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -0002e360: 332e 3336 2069 6e73 6d6f 640a 2d2d 2d2d 3.36 insmod.---- │ │ │ │ │ -0002e370: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -0002e380: 436f 6d6d 616e 643a 2069 6e73 6d6f 6420 Command: insmod │ │ │ │ │ -0002e390: 6d6f 6475 6c65 0a20 2020 2020 496e 7365 module. Inse │ │ │ │ │ -0002e3a0: 7274 2074 6865 2064 796e 616d 6963 2047 rt the dynamic G │ │ │ │ │ -0002e3b0: 5255 4220 6d6f 6475 6c65 2063 616c 6c65 RUB module calle │ │ │ │ │ -0002e3c0: 6420 4d4f 4455 4c45 2e0a 0a1f 0a46 696c d MODULE.....Fil │ │ │ │ │ -0002e3d0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0002e3e0: 6f64 653a 206b 6579 7374 6174 7573 2c20 ode: keystatus, │ │ │ │ │ -0002e3f0: 204e 6578 743a 206c 696e 7578 2c20 2050 Next: linux, P │ │ │ │ │ -0002e400: 7265 763a 2069 6e73 6d6f 642c 2020 5570 rev: insmod, Up │ │ │ │ │ -0002e410: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -0002e420: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -0002e430: 6d6d 616e 6473 0a0a 3136 2e33 2e33 3720 mmands..16.3.37 │ │ │ │ │ -0002e440: 6b65 7973 7461 7475 730a 2d2d 2d2d 2d2d keystatus.------ │ │ │ │ │ -0002e450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ -0002e460: 2043 6f6d 6d61 6e64 3a20 6b65 7973 7461 Command: keysta │ │ │ │ │ -0002e470: 7475 7320 5b2d 2d73 6869 6674 5d20 5b2d tus [--shift] [- │ │ │ │ │ -0002e480: 2d63 7472 6c5d 205b 2d2d 616c 745d 0a20 -ctrl] [--alt]. │ │ │ │ │ -0002e490: 2020 2020 5265 7475 726e 2074 7275 6520 Return true │ │ │ │ │ -0002e4a0: 6966 2074 6865 2053 6869 6674 2c20 436f if the Shift, Co │ │ │ │ │ -0002e4b0: 6e74 726f 6c2c 206f 7220 416c 7420 6d6f ntrol, or Alt mo │ │ │ │ │ -0002e4c0: 6469 6669 6572 206b 6579 7320 6172 6520 difier keys are │ │ │ │ │ -0002e4d0: 6865 6c64 0a20 2020 2020 646f 776e 2c20 held. down, │ │ │ │ │ -0002e4e0: 6173 2072 6571 7565 7374 6564 2062 7920 as requested by │ │ │ │ │ -0002e4f0: 6f70 7469 6f6e 732e 2020 5468 6973 2069 options. This i │ │ │ │ │ -0002e500: 7320 7573 6566 756c 2069 6e20 7363 7269 s useful in scri │ │ │ │ │ -0002e510: 7074 696e 672c 2074 6f0a 2020 2020 2061 pting, to. a │ │ │ │ │ -0002e520: 6c6c 6f77 2073 6f6d 6520 7573 6572 2063 llow some user c │ │ │ │ │ -0002e530: 6f6e 7472 6f6c 206f 7665 7220 6265 6861 ontrol over beha │ │ │ │ │ -0002e540: 7669 6f75 7220 7769 7468 6f75 7420 6861 viour without ha │ │ │ │ │ -0002e550: 7669 6e67 2074 6f20 7761 6974 2066 6f72 ving to wait for │ │ │ │ │ -0002e560: 2061 0a20 2020 2020 6b65 7970 7265 7373 a. keypress │ │ │ │ │ -0002e570: 2e0a 0a20 2020 2020 4368 6563 6b69 6e67 ... Checking │ │ │ │ │ -0002e580: 206b 6579 206d 6f64 6966 6965 7220 7374 key modifier st │ │ │ │ │ -0002e590: 6174 7573 2069 7320 6f6e 6c79 2073 7570 atus is only sup │ │ │ │ │ -0002e5a0: 706f 7274 6564 206f 6e20 736f 6d65 2070 ported on some p │ │ │ │ │ -0002e5b0: 6c61 7466 6f72 6d73 2e0a 2020 2020 2049 latforms.. I │ │ │ │ │ -0002e5c0: 6620 696e 766f 6b65 6420 7769 7468 6f75 f invoked withou │ │ │ │ │ -0002e5d0: 7420 616e 7920 6f70 7469 6f6e 732c 2074 t any options, t │ │ │ │ │ -0002e5e0: 6865 2027 6b65 7973 7461 7475 7327 2063 he 'keystatus' c │ │ │ │ │ -0002e5f0: 6f6d 6d61 6e64 2072 6574 7572 6e73 0a20 ommand returns. │ │ │ │ │ -0002e600: 2020 2020 7472 7565 2069 6620 616e 6420 true if and │ │ │ │ │ -0002e610: 6f6e 6c79 2069 6620 6368 6563 6b69 6e67 only if checking │ │ │ │ │ -0002e620: 206b 6579 206d 6f64 6966 6965 7220 7374 key modifier st │ │ │ │ │ -0002e630: 6174 7573 2069 7320 7375 7070 6f72 7465 atus is supporte │ │ │ │ │ -0002e640: 642e 0a0a 1f0a 4669 6c65 3a20 6772 7562 d.....File: grub │ │ │ │ │ -0002e650: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6c69 .info, Node: li │ │ │ │ │ -0002e660: 6e75 782c 2020 4e65 7874 3a20 6c69 6e75 nux, Next: linu │ │ │ │ │ -0002e670: 7831 362c 2020 5072 6576 3a20 6b65 7973 x16, Prev: keys │ │ │ │ │ -0002e680: 7461 7475 732c 2020 5570 3a20 436f 6d6d tatus, Up: Comm │ │ │ │ │ -0002e690: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -0002e6a0: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -0002e6b0: 0a0a 3136 2e33 2e33 3820 6c69 6e75 780a ..16.3.38 linux. │ │ │ │ │ -0002e6c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ -0002e6d0: 2d2d 2043 6f6d 6d61 6e64 3a20 6c69 6e75 -- Command: linu │ │ │ │ │ -0002e6e0: 7820 6669 6c65 202e 2e2e 0a20 2020 2020 x file .... │ │ │ │ │ -0002e6f0: 4c6f 6164 2061 204c 696e 7578 206b 6572 Load a Linux ker │ │ │ │ │ -0002e700: 6e65 6c20 696d 6167 6520 6672 6f6d 2046 nel image from F │ │ │ │ │ -0002e710: 494c 452e 2020 5468 6520 7265 7374 206f ILE. The rest o │ │ │ │ │ -0002e720: 6620 7468 6520 6c69 6e65 2069 730a 2020 f the line is. │ │ │ │ │ -0002e730: 2020 2070 6173 7365 6420 7665 7262 6174 passed verbat │ │ │ │ │ -0002e740: 696d 2061 7320 7468 6520 226b 6572 6e65 im as the "kerne │ │ │ │ │ -0002e750: 6c20 636f 6d6d 616e 642d 6c69 6e65 222e l command-line". │ │ │ │ │ -0002e760: 2020 416e 7920 696e 6974 7264 206d 7573 Any initrd mus │ │ │ │ │ -0002e770: 7420 6265 0a20 2020 2020 7265 6c6f 6164 t be. reload │ │ │ │ │ -0002e780: 6564 2061 6674 6572 2075 7369 6e67 2074 ed after using t │ │ │ │ │ -0002e790: 6869 7320 636f 6d6d 616e 6420 282a 6e6f his command (*no │ │ │ │ │ -0002e7a0: 7465 2069 6e69 7472 643a 3a29 2e0a 0a20 te initrd::)... │ │ │ │ │ -0002e7b0: 2020 2020 4f6e 2078 3836 2073 7973 7465 On x86 syste │ │ │ │ │ -0002e7c0: 6d73 2c20 7468 6520 6b65 726e 656c 2077 ms, the kernel w │ │ │ │ │ -0002e7d0: 696c 6c20 6265 2062 6f6f 7465 6420 7573 ill be booted us │ │ │ │ │ -0002e7e0: 696e 6720 7468 6520 3332 2d62 6974 2062 ing the 32-bit b │ │ │ │ │ -0002e7f0: 6f6f 740a 2020 2020 2070 726f 746f 636f oot. protoco │ │ │ │ │ -0002e800: 6c2e 2020 4e6f 7465 2074 6861 7420 7468 l. Note that th │ │ │ │ │ -0002e810: 6973 206d 6561 6e73 2074 6861 7420 7468 is means that th │ │ │ │ │ -0002e820: 6520 2776 6761 3d27 2062 6f6f 7420 6f70 e 'vga=' boot op │ │ │ │ │ -0002e830: 7469 6f6e 2077 696c 6c0a 2020 2020 206e tion will. n │ │ │ │ │ -0002e840: 6f74 2077 6f72 6b3b 2069 6620 796f 7520 ot work; if you │ │ │ │ │ -0002e850: 7761 6e74 2074 6f20 7365 7420 6120 7370 want to set a sp │ │ │ │ │ -0002e860: 6563 6961 6c20 7669 6465 6f20 6d6f 6465 ecial video mode │ │ │ │ │ -0002e870: 2c20 796f 7520 7769 6c6c 206e 6565 6420 , you will need │ │ │ │ │ -0002e880: 746f 0a20 2020 2020 7573 6520 4752 5542 to. use GRUB │ │ │ │ │ -0002e890: 2063 6f6d 6d61 6e64 7320 7375 6368 2061 commands such a │ │ │ │ │ -0002e8a0: 7320 2773 6574 2067 6678 7061 796c 6f61 s 'set gfxpayloa │ │ │ │ │ -0002e8b0: 643d 3130 3234 7837 3638 2720 6f72 2027 d=1024x768' or ' │ │ │ │ │ -0002e8c0: 7365 740a 2020 2020 2067 6678 7061 796c set. gfxpayl │ │ │ │ │ -0002e8d0: 6f61 643d 6b65 6570 2720 2874 6f20 6b65 oad=keep' (to ke │ │ │ │ │ -0002e8e0: 6570 2074 6865 2073 616d 6520 6d6f 6465 ep the same mode │ │ │ │ │ -0002e8f0: 2061 7320 7573 6564 2069 6e20 4752 5542 as used in GRUB │ │ │ │ │ -0002e900: 2920 696e 7374 6561 642e 0a20 2020 2020 ) instead.. │ │ │ │ │ -0002e910: 4752 5542 2063 616e 2061 7574 6f6d 6174 GRUB can automat │ │ │ │ │ -0002e920: 6963 616c 6c79 2064 6574 6563 7420 736f ically detect so │ │ │ │ │ -0002e930: 6d65 2075 7365 7320 6f66 2027 7667 613d me uses of 'vga= │ │ │ │ │ -0002e940: 2720 616e 6420 7472 616e 736c 6174 650a ' and translate. │ │ │ │ │ -0002e950: 2020 2020 2074 6865 6d20 746f 2061 7070 them to app │ │ │ │ │ -0002e960: 726f 7072 6961 7465 2073 6574 7469 6e67 ropriate setting │ │ │ │ │ -0002e970: 7320 6f66 2027 6766 7870 6179 6c6f 6164 s of 'gfxpayload │ │ │ │ │ -0002e980: 272e 2020 5468 6520 276c 696e 7578 3136 '. The 'linux16 │ │ │ │ │ -0002e990: 270a 2020 2020 2063 6f6d 6d61 6e64 2028 '. command ( │ │ │ │ │ -0002e9a0: 2a6e 6f74 6520 6c69 6e75 7831 363a 3a29 *note linux16::) │ │ │ │ │ -0002e9b0: 2061 766f 6964 7320 7468 6973 2072 6573 avoids this res │ │ │ │ │ -0002e9c0: 7472 6963 7469 6f6e 2e0a 0a1f 0a46 696c triction.....Fil │ │ │ │ │ -0002e9d0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0002e9e0: 6f64 653a 206c 696e 7578 3136 2c20 204e ode: linux16, N │ │ │ │ │ -0002e9f0: 6578 743a 206c 6973 745f 656e 762c 2020 ext: list_env, │ │ │ │ │ -0002ea00: 5072 6576 3a20 6c69 6e75 782c 2020 5570 Prev: linux, Up │ │ │ │ │ -0002ea10: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -0002ea20: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -0002ea30: 6d6d 616e 6473 0a0a 3136 2e33 2e33 3920 mmands..16.3.39 │ │ │ │ │ -0002ea40: 6c69 6e75 7831 360a 2d2d 2d2d 2d2d 2d2d linux16.-------- │ │ │ │ │ -0002ea50: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ -0002ea60: 6d61 6e64 3a20 6c69 6e75 7831 3620 6669 mand: linux16 fi │ │ │ │ │ -0002ea70: 6c65 202e 2e2e 0a20 2020 2020 4c6f 6164 le .... Load │ │ │ │ │ -0002ea80: 2061 204c 696e 7578 206b 6572 6e65 6c20 a Linux kernel │ │ │ │ │ -0002ea90: 696d 6167 6520 6672 6f6d 2046 494c 4520 image from FILE │ │ │ │ │ -0002eaa0: 696e 2031 362d 6269 7420 6d6f 6465 2e20 in 16-bit mode. │ │ │ │ │ -0002eab0: 2054 6865 2072 6573 7420 6f66 0a20 2020 The rest of. │ │ │ │ │ -0002eac0: 2020 7468 6520 6c69 6e65 2069 7320 7061 the line is pa │ │ │ │ │ -0002ead0: 7373 6564 2076 6572 6261 7469 6d20 6173 ssed verbatim as │ │ │ │ │ -0002eae0: 2074 6865 2022 6b65 726e 656c 2063 6f6d the "kernel com │ │ │ │ │ -0002eaf0: 6d61 6e64 2d6c 696e 6522 2e20 2041 6e79 mand-line". Any │ │ │ │ │ -0002eb00: 0a20 2020 2020 696e 6974 7264 206d 7573 . initrd mus │ │ │ │ │ -0002eb10: 7420 6265 2072 656c 6f61 6465 6420 6166 t be reloaded af │ │ │ │ │ -0002eb20: 7465 7220 7573 696e 6720 7468 6973 2063 ter using this c │ │ │ │ │ -0002eb30: 6f6d 6d61 6e64 2028 2a6e 6f74 650a 2020 ommand (*note. │ │ │ │ │ -0002eb40: 2020 2069 6e69 7472 6431 363a 3a29 2e0a initrd16::).. │ │ │ │ │ -0002eb50: 0a20 2020 2020 5468 6520 6b65 726e 656c . The kernel │ │ │ │ │ -0002eb60: 2077 696c 6c20 6265 2062 6f6f 7465 6420 will be booted │ │ │ │ │ -0002eb70: 7573 696e 6720 7468 6520 7472 6164 6974 using the tradit │ │ │ │ │ -0002eb80: 696f 6e61 6c20 3136 2d62 6974 2062 6f6f ional 16-bit boo │ │ │ │ │ -0002eb90: 740a 2020 2020 2070 726f 746f 636f 6c2e t. protocol. │ │ │ │ │ -0002eba0: 2020 4173 2077 656c 6c20 6173 2062 7970 As well as byp │ │ │ │ │ -0002ebb0: 6173 7369 6e67 2070 726f 626c 656d 7320 assing problems │ │ │ │ │ -0002ebc0: 7769 7468 2027 7667 613d 2720 6465 7363 with 'vga=' desc │ │ │ │ │ -0002ebd0: 7269 6265 6420 696e 0a20 2020 2020 2a6e ribed in. *n │ │ │ │ │ -0002ebe0: 6f74 6520 6c69 6e75 783a 3a2c 2074 6869 ote linux::, thi │ │ │ │ │ -0002ebf0: 7320 7065 726d 6974 7320 626f 6f74 696e s permits bootin │ │ │ │ │ -0002ec00: 6720 736f 6d65 206f 7468 6572 2070 726f g some other pro │ │ │ │ │ -0002ec10: 6772 616d 7320 7468 6174 0a20 2020 2020 grams that. │ │ │ │ │ -0002ec20: 696d 706c 656d 656e 7420 7468 6520 4c69 implement the Li │ │ │ │ │ -0002ec30: 6e75 7820 626f 6f74 2070 726f 746f 636f nux boot protoco │ │ │ │ │ -0002ec40: 6c20 666f 7220 7468 6520 7361 6b65 206f l for the sake o │ │ │ │ │ -0002ec50: 6620 636f 6e76 656e 6965 6e63 652e 0a0a f convenience... │ │ │ │ │ -0002ec60: 2020 2020 2054 6869 7320 636f 6d6d 616e This comman │ │ │ │ │ -0002ec70: 6420 6973 206f 6e6c 7920 6176 6169 6c61 d is only availa │ │ │ │ │ -0002ec80: 626c 6520 6f6e 2078 3836 2073 7973 7465 ble on x86 syste │ │ │ │ │ -0002ec90: 6d73 2e0a 0a1f 0a46 696c 653a 2067 7275 ms.....File: gru │ │ │ │ │ -0002eca0: 622e 696e 666f 2c20 204e 6f64 653a 206c b.info, Node: l │ │ │ │ │ -0002ecb0: 6973 745f 656e 762c 2020 4e65 7874 3a20 ist_env, Next: │ │ │ │ │ -0002ecc0: 6c69 7374 5f74 7275 7374 6564 2c20 2050 list_trusted, P │ │ │ │ │ -0002ecd0: 7265 763a 206c 696e 7578 3136 2c20 2055 rev: linux16, U │ │ │ │ │ -0002ece0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -0002ecf0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -0002ed00: 6f6d 6d61 6e64 730a 0a31 362e 332e 3430 ommands..16.3.40 │ │ │ │ │ -0002ed10: 206c 6973 745f 656e 760a 2d2d 2d2d 2d2d list_env.------ │ │ │ │ │ -0002ed20: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -0002ed30: 436f 6d6d 616e 643a 206c 6973 745f 656e Command: list_en │ │ │ │ │ -0002ed40: 7620 5b2d 2d66 696c 6520 6669 6c65 5d0a v [--file file]. │ │ │ │ │ -0002ed50: 2020 2020 204c 6973 7420 616c 6c20 7661 List all va │ │ │ │ │ -0002ed60: 7269 6162 6c65 7320 696e 2074 6865 2065 riables in the e │ │ │ │ │ -0002ed70: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ │ -0002ed80: 2066 696c 652e 2020 2a4e 6f74 650a 2020 file. *Note. │ │ │ │ │ -0002ed90: 2020 2045 6e76 6972 6f6e 6d65 6e74 2062 Environment b │ │ │ │ │ -0002eda0: 6c6f 636b 3a3a 2e0a 0a20 2020 2020 5468 lock::... Th │ │ │ │ │ -0002edb0: 6520 272d 2d66 696c 6527 206f 7074 696f e '--file' optio │ │ │ │ │ -0002edc0: 6e20 6f76 6572 7269 6465 7320 7468 6520 n overrides the │ │ │ │ │ -0002edd0: 6465 6661 756c 7420 6c6f 6361 7469 6f6e default location │ │ │ │ │ -0002ede0: 206f 6620 7468 650a 2020 2020 2065 6e76 of the. env │ │ │ │ │ -0002edf0: 6972 6f6e 6d65 6e74 2062 6c6f 636b 2e0a ironment block.. │ │ │ │ │ -0002ee00: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -0002ee10: 666f 2c20 204e 6f64 653a 206c 6973 745f fo, Node: list_ │ │ │ │ │ -0002ee20: 7472 7573 7465 642c 2020 4e65 7874 3a20 trusted, Next: │ │ │ │ │ -0002ee30: 6c6f 6164 5f65 6e76 2c20 2050 7265 763a load_env, Prev: │ │ │ │ │ -0002ee40: 206c 6973 745f 656e 762c 2020 5570 3a20 list_env, Up: │ │ │ │ │ -0002ee50: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -0002ee60: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -0002ee70: 616e 6473 0a0a 3136 2e33 2e34 3120 6c69 ands..16.3.41 li │ │ │ │ │ -0002ee80: 7374 5f74 7275 7374 6564 0a2d 2d2d 2d2d st_trusted.----- │ │ │ │ │ -0002ee90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -0002eea0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6c69 . -- Command: li │ │ │ │ │ -0002eeb0: 7374 5f74 7275 7374 6564 0a20 2020 2020 st_trusted. │ │ │ │ │ -0002eec0: 4c69 7374 2061 6c6c 2070 7562 6c69 6320 List all public │ │ │ │ │ -0002eed0: 6b65 7973 2074 7275 7374 6564 2062 7920 keys trusted by │ │ │ │ │ -0002eee0: 4752 5542 2066 6f72 2076 616c 6964 6174 GRUB for validat │ │ │ │ │ -0002eef0: 696e 6720 7369 676e 6174 7572 6573 2e0a ing signatures.. │ │ │ │ │ -0002ef00: 2020 2020 2054 6865 206f 7574 7075 7420 The output │ │ │ │ │ -0002ef10: 6973 2069 6e20 4750 4727 7320 7634 206b is in GPG's v4 k │ │ │ │ │ -0002ef20: 6579 2066 696e 6765 7270 7269 6e74 2066 ey fingerprint f │ │ │ │ │ -0002ef30: 6f72 6d61 7420 2869 2e65 2e2c 2074 6865 ormat (i.e., the │ │ │ │ │ -0002ef40: 206f 7574 7075 740a 2020 2020 206f 6620 output. of │ │ │ │ │ -0002ef50: 2767 7067 202d 2d66 696e 6765 7270 7269 'gpg --fingerpri │ │ │ │ │ -0002ef60: 6e74 2729 2e20 2054 6865 206c 6561 7374 nt'). The least │ │ │ │ │ -0002ef70: 2073 6967 6e69 6669 6361 6e74 2066 6f75 significant fou │ │ │ │ │ -0002ef80: 7220 6279 7465 7320 286c 6173 740a 2020 r bytes (last. │ │ │ │ │ -0002ef90: 2020 2065 6967 6874 2068 6578 6164 6563 eight hexadec │ │ │ │ │ -0002efa0: 696d 616c 2064 6967 6974 7329 2063 616e imal digits) can │ │ │ │ │ -0002efb0: 2062 6520 7573 6564 2061 7320 616e 2061 be used as an a │ │ │ │ │ -0002efc0: 7267 756d 656e 7420 746f 2027 6469 7374 rgument to 'dist │ │ │ │ │ -0002efd0: 7275 7374 270a 2020 2020 2028 2a6e 6f74 rust'. (*not │ │ │ │ │ -0002efe0: 6520 6469 7374 7275 7374 3a3a 292e 2020 e distrust::). │ │ │ │ │ -0002eff0: 2a4e 6f74 6520 5573 696e 6720 6469 6769 *Note Using digi │ │ │ │ │ -0002f000: 7461 6c20 7369 676e 6174 7572 6573 3a3a tal signatures:: │ │ │ │ │ -0002f010: 2c20 666f 7220 6d6f 7265 0a20 2020 2020 , for more. │ │ │ │ │ -0002f020: 696e 666f 726d 6174 696f 6e20 6162 6f75 information abou │ │ │ │ │ -0002f030: 7420 7573 6573 2066 6f72 2074 6865 7365 t uses for these │ │ │ │ │ -0002f040: 206b 6579 732e 0a0a 1f0a 4669 6c65 3a20 keys.....File: │ │ │ │ │ -0002f050: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -0002f060: 3a20 6c6f 6164 5f65 6e76 2c20 204e 6578 : load_env, Nex │ │ │ │ │ -0002f070: 743a 206c 6f61 6466 6f6e 742c 2020 5072 t: loadfont, Pr │ │ │ │ │ -0002f080: 6576 3a20 6c69 7374 5f74 7275 7374 6564 ev: list_trusted │ │ │ │ │ -0002f090: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -0002f0a0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -0002f0b0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -0002f0c0: 332e 3432 206c 6f61 645f 656e 760a 2d2d 3.42 load_env.-- │ │ │ │ │ -0002f0d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -0002f0e0: 202d 2d20 436f 6d6d 616e 643a 206c 6f61 -- Command: loa │ │ │ │ │ -0002f0f0: 645f 656e 7620 5b2d 2d66 696c 6520 6669 d_env [--file fi │ │ │ │ │ -0002f100: 6c65 5d20 5b2d 2d73 6b69 702d 7369 675d le] [--skip-sig] │ │ │ │ │ -0002f110: 0a20 2020 2020 2020 2020 205b 7768 6974 . [whit │ │ │ │ │ -0002f120: 656c 6973 7465 645f 7661 7269 6162 6c65 elisted_variable │ │ │ │ │ -0002f130: 5f6e 616d 655d 202e 2e2e 0a20 2020 2020 _name] .... │ │ │ │ │ -0002f140: 4c6f 6164 2061 6c6c 2076 6172 6961 626c Load all variabl │ │ │ │ │ -0002f150: 6573 2066 726f 6d20 7468 6520 656e 7669 es from the envi │ │ │ │ │ -0002f160: 726f 6e6d 656e 7420 626c 6f63 6b20 6669 ronment block fi │ │ │ │ │ -0002f170: 6c65 2069 6e74 6f20 7468 650a 2020 2020 le into the. │ │ │ │ │ -0002f180: 2065 6e76 6972 6f6e 6d65 6e74 2e20 202a environment. * │ │ │ │ │ -0002f190: 4e6f 7465 2045 6e76 6972 6f6e 6d65 6e74 Note Environment │ │ │ │ │ -0002f1a0: 2062 6c6f 636b 3a3a 2e0a 0a20 2020 2020 block::... │ │ │ │ │ -0002f1b0: 5468 6520 272d 2d66 696c 6527 206f 7074 The '--file' opt │ │ │ │ │ -0002f1c0: 696f 6e20 6f76 6572 7269 6465 7320 7468 ion overrides th │ │ │ │ │ -0002f1d0: 6520 6465 6661 756c 7420 6c6f 6361 7469 e default locati │ │ │ │ │ -0002f1e0: 6f6e 206f 6620 7468 650a 2020 2020 2065 on of the. e │ │ │ │ │ -0002f1f0: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ │ -0002f200: 2e0a 0a20 2020 2020 5468 6520 272d 2d73 ... The '--s │ │ │ │ │ -0002f210: 6b69 702d 7369 6727 206f 7074 696f 6e20 kip-sig' option │ │ │ │ │ -0002f220: 736b 6970 7320 7369 676e 6174 7572 6520 skips signature │ │ │ │ │ -0002f230: 6368 6563 6b69 6e67 2065 7665 6e20 7768 checking even wh │ │ │ │ │ -0002f240: 656e 2074 6865 0a20 2020 2020 7661 6c75 en the. valu │ │ │ │ │ -0002f250: 6520 6f66 2065 6e76 6972 6f6e 6d65 6e74 e of environment │ │ │ │ │ -0002f260: 2076 6172 6961 626c 6520 2763 6865 636b variable 'check │ │ │ │ │ -0002f270: 5f73 6967 6e61 7475 7265 7327 2069 7320 _signatures' is │ │ │ │ │ -0002f280: 7365 7420 746f 0a20 2020 2020 2765 6e66 set to. 'enf │ │ │ │ │ -0002f290: 6f72 6365 2720 282a 6e6f 7465 2063 6865 orce' (*note che │ │ │ │ │ -0002f2a0: 636b 5f73 6967 6e61 7475 7265 733a 3a29 ck_signatures::) │ │ │ │ │ -0002f2b0: 2e0a 0a20 2020 2020 4966 206f 6e65 206f ... If one o │ │ │ │ │ -0002f2c0: 7220 6d6f 7265 2076 6172 6961 626c 6520 r more variable │ │ │ │ │ -0002f2d0: 6e61 6d65 7320 6172 6520 7072 6f76 6964 names are provid │ │ │ │ │ -0002f2e0: 6564 2061 7320 6172 6775 6d65 6e74 732c ed as arguments, │ │ │ │ │ -0002f2f0: 2074 6865 7920 6172 650a 2020 2020 2069 they are. i │ │ │ │ │ -0002f300: 6e74 6572 7072 6574 6564 2061 7320 6120 nterpreted as a │ │ │ │ │ -0002f310: 7768 6974 656c 6973 7420 6f66 2076 6172 whitelist of var │ │ │ │ │ -0002f320: 6961 626c 6573 2074 6f20 6c6f 6164 2066 iables to load f │ │ │ │ │ -0002f330: 726f 6d20 7468 650a 2020 2020 2065 6e76 rom the. env │ │ │ │ │ -0002f340: 6972 6f6e 6d65 6e74 2062 6c6f 636b 2066 ironment block f │ │ │ │ │ -0002f350: 696c 652e 2020 5661 7269 6162 6c65 7320 ile. Variables │ │ │ │ │ -0002f360: 7365 7420 696e 2074 6865 2066 696c 6520 set in the file │ │ │ │ │ -0002f370: 6275 7420 6e6f 7420 7072 6573 656e 740a but not present. │ │ │ │ │ -0002f380: 2020 2020 2069 6e20 7468 6520 7768 6974 in the whit │ │ │ │ │ -0002f390: 656c 6973 7420 6172 6520 6967 6e6f 7265 elist are ignore │ │ │ │ │ -0002f3a0: 642e 0a0a 2020 2020 2054 6865 2027 2d2d d... The '-- │ │ │ │ │ -0002f3b0: 736b 6970 2d73 6967 2720 6f70 7469 6f6e skip-sig' option │ │ │ │ │ -0002f3c0: 2073 686f 756c 6420 6265 2075 7365 6420 should be used │ │ │ │ │ -0002f3d0: 7769 7468 2063 6172 652c 2061 6e64 2073 with care, and s │ │ │ │ │ -0002f3e0: 686f 756c 6420 616c 7761 7973 0a20 2020 hould always. │ │ │ │ │ -0002f3f0: 2020 6265 2075 7365 6420 696e 2063 6f6e be used in con │ │ │ │ │ -0002f400: 6365 7274 2077 6974 6820 6120 7768 6974 cert with a whit │ │ │ │ │ -0002f410: 656c 6973 7420 6f66 2061 6363 6570 7461 elist of accepta │ │ │ │ │ -0002f420: 626c 6520 7661 7269 6162 6c65 7320 7768 ble variables wh │ │ │ │ │ -0002f430: 6f73 650a 2020 2020 2076 616c 7565 7320 ose. values │ │ │ │ │ -0002f440: 7368 6f75 6c64 2062 6520 7365 742e 2020 should be set. │ │ │ │ │ -0002f450: 4661 696c 7572 6520 746f 2065 6d70 6c6f Failure to emplo │ │ │ │ │ -0002f460: 7920 6120 6361 7265 6675 6c6c 7920 636f y a carefully co │ │ │ │ │ -0002f470: 6e73 7472 7563 7465 640a 2020 2020 2077 nstructed. w │ │ │ │ │ -0002f480: 6869 7465 6c69 7374 2063 6f75 6c64 2072 hitelist could r │ │ │ │ │ -0002f490: 6573 756c 7420 696e 2072 6561 6469 6e67 esult in reading │ │ │ │ │ -0002f4a0: 2061 206d 616c 6963 696f 7573 2076 616c a malicious val │ │ │ │ │ -0002f4b0: 7565 2069 6e74 6f20 6372 6974 6963 616c ue into critical │ │ │ │ │ -0002f4c0: 0a20 2020 2020 656e 7669 726f 6e6d 656e . environmen │ │ │ │ │ -0002f4d0: 7420 7661 7269 6162 6c65 7320 6672 6f6d t variables from │ │ │ │ │ -0002f4e0: 2074 6865 2066 696c 652c 2073 7563 6820 the file, such │ │ │ │ │ -0002f4f0: 6173 2073 6574 7469 6e67 0a20 2020 2020 as setting. │ │ │ │ │ -0002f500: 2763 6865 636b 5f73 6967 6e61 7475 7265 'check_signature │ │ │ │ │ -0002f510: 733d 6e6f 272c 206d 6f64 6966 7969 6e67 s=no', modifying │ │ │ │ │ -0002f520: 2027 7072 6566 6978 2720 746f 2062 6f6f 'prefix' to boo │ │ │ │ │ -0002f530: 7420 6672 6f6d 2061 6e0a 2020 2020 2075 t from an. u │ │ │ │ │ -0002f540: 6e65 7870 6563 7465 6420 6c6f 6361 7469 nexpected locati │ │ │ │ │ -0002f550: 6f6e 206f 7220 6e6f 7420 6174 2061 6c6c on or not at all │ │ │ │ │ -0002f560: 2c20 6574 632e 0a0a 2020 2020 2057 6865 , etc... Whe │ │ │ │ │ -0002f570: 6e20 7573 6564 2077 6974 6820 6361 7265 n used with care │ │ │ │ │ -0002f580: 2c20 272d 2d73 6b69 702d 7369 6727 2061 , '--skip-sig' a │ │ │ │ │ -0002f590: 6e64 2074 6865 2077 6869 7465 6c69 7374 nd the whitelist │ │ │ │ │ -0002f5a0: 2065 6e61 626c 6520 616e 0a20 2020 2020 enable an. │ │ │ │ │ -0002f5b0: 6164 6d69 6e69 7374 7261 746f 7220 746f administrator to │ │ │ │ │ -0002f5c0: 2063 6f6e 6669 6775 7265 2061 2073 7973 configure a sys │ │ │ │ │ -0002f5d0: 7465 6d20 746f 2062 6f6f 7420 6f6e 6c79 tem to boot only │ │ │ │ │ -0002f5e0: 2073 6967 6e65 640a 2020 2020 2063 6f6e signed. con │ │ │ │ │ -0002f5f0: 6669 6775 7261 7469 6f6e 732c 2062 7574 figurations, but │ │ │ │ │ -0002f600: 2074 6f20 616c 6c6f 7720 7468 6520 7573 to allow the us │ │ │ │ │ -0002f610: 6572 2074 6f20 7365 6c65 6374 2066 726f er to select fro │ │ │ │ │ -0002f620: 6d20 616d 6f6e 6720 6d75 6c74 6970 6c65 m among multiple │ │ │ │ │ -0002f630: 0a20 2020 2020 636f 6e66 6967 7572 6174 . configurat │ │ │ │ │ -0002f640: 696f 6e73 2c20 616e 6420 746f 2065 6e61 ions, and to ena │ │ │ │ │ -0002f650: 626c 6520 226f 6e65 2d73 686f 7422 2062 ble "one-shot" b │ │ │ │ │ -0002f660: 6f6f 7420 6174 7465 6d70 7473 2061 6e64 oot attempts and │ │ │ │ │ -0002f670: 0a20 2020 2020 2273 6176 6564 6566 6175 . "savedefau │ │ │ │ │ -0002f680: 6c74 2220 6265 6861 7669 6f72 2e20 202a lt" behavior. * │ │ │ │ │ -0002f690: 4e6f 7465 2055 7369 6e67 2064 6967 6974 Note Using digit │ │ │ │ │ -0002f6a0: 616c 2073 6967 6e61 7475 7265 733a 3a2c al signatures::, │ │ │ │ │ -0002f6b0: 2066 6f72 206d 6f72 650a 2020 2020 2069 for more. i │ │ │ │ │ -0002f6c0: 6e66 6f72 6d61 7469 6f6e 2e0a 0a1f 0a46 nformation.....F │ │ │ │ │ -0002f6d0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -0002f6e0: 204e 6f64 653a 206c 6f61 6466 6f6e 742c Node: loadfont, │ │ │ │ │ -0002f6f0: 2020 4e65 7874 3a20 6c6f 6f70 6261 636b Next: loopback │ │ │ │ │ -0002f700: 2c20 2050 7265 763a 206c 6f61 645f 656e , Prev: load_en │ │ │ │ │ -0002f710: 762c 2020 5570 3a20 436f 6d6d 616e 642d v, Up: Command- │ │ │ │ │ -0002f720: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ -0002f730: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ -0002f740: 2e33 2e34 3320 6c6f 6164 666f 6e74 0a2d .3.43 loadfont.- │ │ │ │ │ -0002f750: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -0002f760: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6c6f . -- Command: lo │ │ │ │ │ -0002f770: 6164 666f 6e74 2066 696c 6520 2e2e 2e0a adfont file .... │ │ │ │ │ -0002f780: 2020 2020 204c 6f61 6420 7370 6563 6966 Load specif │ │ │ │ │ -0002f790: 6965 6420 666f 6e74 2066 696c 6573 2e20 ied font files. │ │ │ │ │ -0002f7a0: 2055 6e6c 6573 7320 6162 736f 6c75 7465 Unless absolute │ │ │ │ │ -0002f7b0: 2070 6174 686e 616d 6520 6973 2067 6976 pathname is giv │ │ │ │ │ -0002f7c0: 656e 2c20 4649 4c45 0a20 2020 2020 6973 en, FILE. is │ │ │ │ │ -0002f7d0: 2061 7373 756d 6564 2074 6f20 6265 2069 assumed to be i │ │ │ │ │ -0002f7e0: 6e20 6469 7265 6374 6f72 7920 2724 7072 n directory '$pr │ │ │ │ │ -0002f7f0: 6566 6978 2f66 6f6e 7473 2720 7769 7468 efix/fonts' with │ │ │ │ │ -0002f800: 2073 7566 6669 7820 272e 7066 3227 0a20 suffix '.pf2'. │ │ │ │ │ -0002f810: 2020 2020 6170 7065 6e64 6564 2e20 202a appended. * │ │ │ │ │ -0002f820: 4e6f 7465 2046 6f6e 7473 3a20 5468 656d Note Fonts: Them │ │ │ │ │ -0002f830: 6520 6669 6c65 2066 6f72 6d61 742e 0a0a e file format... │ │ │ │ │ -0002f840: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -0002f850: 6f2c 2020 4e6f 6465 3a20 6c6f 6f70 6261 o, Node: loopba │ │ │ │ │ -0002f860: 636b 2c20 204e 6578 743a 206c 732c 2020 ck, Next: ls, │ │ │ │ │ -0002f870: 5072 6576 3a20 6c6f 6164 666f 6e74 2c20 Prev: loadfont, │ │ │ │ │ -0002f880: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ -0002f890: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ -0002f8a0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ -0002f8b0: 3434 206c 6f6f 7062 6163 6b0a 2d2d 2d2d 44 loopback.---- │ │ │ │ │ -0002f8c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ -0002f8d0: 2d20 436f 6d6d 616e 643a 206c 6f6f 7062 - Command: loopb │ │ │ │ │ -0002f8e0: 6163 6b20 5b2d 645d 2064 6576 6963 6520 ack [-d] device │ │ │ │ │ -0002f8f0: 6669 6c65 0a20 2020 2020 4d61 6b65 2074 file. Make t │ │ │ │ │ -0002f900: 6865 2064 6576 6963 6520 6e61 6d65 6420 he device named │ │ │ │ │ -0002f910: 4445 5649 4345 2063 6f72 7265 7370 6f6e DEVICE correspon │ │ │ │ │ -0002f920: 6420 746f 2074 6865 2063 6f6e 7465 6e74 d to the content │ │ │ │ │ -0002f930: 7320 6f66 2074 6865 0a20 2020 2020 6669 s of the. fi │ │ │ │ │ -0002f940: 6c65 7379 7374 656d 2069 6d61 6765 2069 lesystem image i │ │ │ │ │ -0002f950: 6e20 4649 4c45 2e20 2046 6f72 2065 7861 n FILE. For exa │ │ │ │ │ -0002f960: 6d70 6c65 3a0a 0a20 2020 2020 2020 2020 mple:.. │ │ │ │ │ -0002f970: 206c 6f6f 7062 6163 6b20 6c6f 6f70 3020 loopback loop0 │ │ │ │ │ -0002f980: 2f70 6174 682f 746f 2f69 6d61 6765 0a20 /path/to/image. │ │ │ │ │ -0002f990: 2020 2020 2020 2020 206c 7320 286c 6f6f ls (loo │ │ │ │ │ -0002f9a0: 7030 292f 0a0a 2020 2020 2057 6974 6820 p0)/.. With │ │ │ │ │ -0002f9b0: 7468 6520 272d 6427 206f 7074 696f 6e2c the '-d' option, │ │ │ │ │ -0002f9c0: 2064 656c 6574 6520 6120 6465 7669 6365 delete a device │ │ │ │ │ -0002f9d0: 2070 7265 7669 6f75 736c 7920 6372 6561 previously crea │ │ │ │ │ -0002f9e0: 7465 6420 7573 696e 6720 7468 6973 0a20 ted using this. │ │ │ │ │ -0002f9f0: 2020 2020 636f 6d6d 616e 642e 0a0a 1f0a command..... │ │ │ │ │ -0002fa00: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -0002fa10: 2020 4e6f 6465 3a20 6c73 2c20 204e 6578 Node: ls, Nex │ │ │ │ │ -0002fa20: 743a 206c 7366 6f6e 7473 2c20 2050 7265 t: lsfonts, Pre │ │ │ │ │ -0002fa30: 763a 206c 6f6f 7062 6163 6b2c 2020 5570 v: loopback, Up │ │ │ │ │ -0002fa40: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -0002fa50: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -0002fa60: 6d6d 616e 6473 0a0a 3136 2e33 2e34 3520 mmands..16.3.45 │ │ │ │ │ -0002fa70: 6c73 0a2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 ls.----------.. │ │ │ │ │ -0002fa80: 2d2d 2043 6f6d 6d61 6e64 3a20 6c73 205b -- Command: ls [ │ │ │ │ │ -0002fa90: 6172 6720 2e2e 2e5d 0a20 2020 2020 4c69 arg ...]. Li │ │ │ │ │ -0002faa0: 7374 2064 6576 6963 6573 206f 7220 6669 st devices or fi │ │ │ │ │ -0002fab0: 6c65 732e 0a0a 2020 2020 2057 6974 6820 les... With │ │ │ │ │ -0002fac0: 6e6f 2061 7267 756d 656e 7473 2c20 7072 no arguments, pr │ │ │ │ │ -0002fad0: 696e 7420 616c 6c20 6465 7669 6365 7320 int all devices │ │ │ │ │ -0002fae0: 6b6e 6f77 6e20 746f 2047 5255 422e 0a0a known to GRUB... │ │ │ │ │ -0002faf0: 2020 2020 2049 6620 7468 6520 6172 6775 If the argu │ │ │ │ │ -0002fb00: 6d65 6e74 2069 7320 6120 6465 7669 6365 ment is a device │ │ │ │ │ -0002fb10: 206e 616d 6520 656e 636c 6f73 6564 2069 name enclosed i │ │ │ │ │ -0002fb20: 6e20 7061 7265 6e74 6865 7365 7320 282a n parentheses (* │ │ │ │ │ -0002fb30: 6e6f 7465 0a20 2020 2020 4465 7669 6365 note. Device │ │ │ │ │ -0002fb40: 2073 796e 7461 783a 3a29 2c20 7468 656e syntax::), then │ │ │ │ │ -0002fb50: 2070 7269 6e74 2074 6865 206e 616d 6520 print the name │ │ │ │ │ -0002fb60: 6f66 2074 6865 2066 696c 6573 7973 7465 of the filesyste │ │ │ │ │ -0002fb70: 6d20 6f66 2074 6861 740a 2020 2020 2064 m of that. d │ │ │ │ │ -0002fb80: 6576 6963 652e 0a0a 2020 2020 2049 6620 evice... If │ │ │ │ │ -0002fb90: 7468 6520 6172 6775 6d65 6e74 2069 7320 the argument is │ │ │ │ │ -0002fba0: 6120 6469 7265 6374 6f72 7920 6769 7665 a directory give │ │ │ │ │ -0002fbb0: 6e20 6173 2061 6e20 6162 736f 6c75 7465 n as an absolute │ │ │ │ │ -0002fbc0: 2066 696c 6520 6e61 6d65 0a20 2020 2020 file name. │ │ │ │ │ -0002fbd0: 282a 6e6f 7465 2046 696c 6520 6e61 6d65 (*note File name │ │ │ │ │ -0002fbe0: 2073 796e 7461 783a 3a29 2c20 7468 656e syntax::), then │ │ │ │ │ -0002fbf0: 206c 6973 7420 7468 6520 636f 6e74 656e list the conten │ │ │ │ │ -0002fc00: 7473 206f 6620 7468 6174 0a20 2020 2020 ts of that. │ │ │ │ │ -0002fc10: 6469 7265 6374 6f72 792e 0a0a 1f0a 4669 directory.....Fi │ │ │ │ │ -0002fc20: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -0002fc30: 4e6f 6465 3a20 6c73 666f 6e74 732c 2020 Node: lsfonts, │ │ │ │ │ -0002fc40: 4e65 7874 3a20 6c73 6d6f 642c 2020 5072 Next: lsmod, Pr │ │ │ │ │ -0002fc50: 6576 3a20 6c73 2c20 2055 703a 2043 6f6d ev: ls, Up: Com │ │ │ │ │ -0002fc60: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ -0002fc70: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ -0002fc80: 730a 0a31 362e 332e 3436 206c 7366 6f6e s..16.3.46 lsfon │ │ │ │ │ -0002fc90: 7473 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ts.------------- │ │ │ │ │ -0002fca0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -0002fcb0: 206c 7366 6f6e 7473 0a20 2020 2020 4c69 lsfonts. Li │ │ │ │ │ -0002fcc0: 7374 206c 6f61 6465 6420 666f 6e74 732e st loaded fonts. │ │ │ │ │ -0002fcd0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -0002fce0: 6e66 6f2c 2020 4e6f 6465 3a20 6c73 6d6f nfo, Node: lsmo │ │ │ │ │ -0002fcf0: 642c 2020 4e65 7874 3a20 6d64 3573 756d d, Next: md5sum │ │ │ │ │ -0002fd00: 2c20 2050 7265 763a 206c 7366 6f6e 7473 , Prev: lsfonts │ │ │ │ │ -0002fd10: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -0002fd20: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -0002fd30: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -0002fd40: 332e 3437 206c 736d 6f64 0a2d 2d2d 2d2d 3.47 lsmod.----- │ │ │ │ │ -0002fd50: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -0002fd60: 6d6d 616e 643a 206c 736d 6f64 0a20 2020 mmand: lsmod. │ │ │ │ │ -0002fd70: 2020 5368 6f77 206c 6973 7420 6f66 206c Show list of l │ │ │ │ │ -0002fd80: 6f61 6465 6420 6d6f 6475 6c65 732e 0a0a oaded modules... │ │ │ │ │ -0002fd90: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -0002fda0: 6f2c 2020 4e6f 6465 3a20 6d64 3573 756d o, Node: md5sum │ │ │ │ │ -0002fdb0: 2c20 204e 6578 743a 206d 6f64 756c 652c , Next: module, │ │ │ │ │ -0002fdc0: 2020 5072 6576 3a20 6c73 6d6f 642c 2020 Prev: lsmod, │ │ │ │ │ -0002fdd0: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ -0002fde0: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ -0002fdf0: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e34 commands..16.3.4 │ │ │ │ │ -0002fe00: 3820 6d64 3573 756d 0a2d 2d2d 2d2d 2d2d 8 md5sum.------- │ │ │ │ │ -0002fe10: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ -0002fe20: 6d61 6e64 3a20 6d64 3573 756d 2061 7267 mand: md5sum arg │ │ │ │ │ -0002fe30: 202e 2e2e 0a20 2020 2020 416c 6961 7320 .... Alias │ │ │ │ │ -0002fe40: 666f 7220 2768 6173 6873 756d 202d 2d68 for 'hashsum --h │ │ │ │ │ -0002fe50: 6173 6820 6d64 3520 6172 6720 2e2e 2e27 ash md5 arg ...' │ │ │ │ │ -0002fe60: 2e20 2053 6565 2063 6f6d 6d61 6e64 2027 . See command ' │ │ │ │ │ -0002fe70: 6861 7368 7375 6d27 0a20 2020 2020 282a hashsum'. (* │ │ │ │ │ -0002fe80: 6e6f 7465 2068 6173 6873 756d 3a3a 2920 note hashsum::) │ │ │ │ │ -0002fe90: 666f 7220 6675 6c6c 2064 6573 6372 6970 for full descrip │ │ │ │ │ -0002fea0: 7469 6f6e 2e0a 0a1f 0a46 696c 653a 2067 tion.....File: g │ │ │ │ │ -0002feb0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0002fec0: 206d 6f64 756c 652c 2020 4e65 7874 3a20 module, Next: │ │ │ │ │ -0002fed0: 6d75 6c74 6962 6f6f 742c 2020 5072 6576 multiboot, Prev │ │ │ │ │ -0002fee0: 3a20 6d64 3573 756d 2c20 2055 703a 2043 : md5sum, Up: C │ │ │ │ │ -0002fef0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ -0002ff00: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ -0002ff10: 6e64 730a 0a31 362e 332e 3439 206d 6f64 nds..16.3.49 mod │ │ │ │ │ -0002ff20: 756c 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ule.------------ │ │ │ │ │ -0002ff30: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -0002ff40: 206d 6f64 756c 6520 5b2d 2d6e 6f75 6e7a module [--nounz │ │ │ │ │ -0002ff50: 6970 5d20 6669 6c65 205b 6172 6775 6d65 ip] file [argume │ │ │ │ │ -0002ff60: 6e74 735d 0a20 2020 2020 4c6f 6164 2061 nts]. Load a │ │ │ │ │ -0002ff70: 206d 6f64 756c 6520 666f 7220 6d75 6c74 module for mult │ │ │ │ │ -0002ff80: 6962 6f6f 7420 6b65 726e 656c 2069 6d61 iboot kernel ima │ │ │ │ │ -0002ff90: 6765 2e20 2054 6865 2072 6573 7420 6f66 ge. The rest of │ │ │ │ │ -0002ffa0: 2074 6865 206c 696e 6520 6973 0a20 2020 the line is. │ │ │ │ │ -0002ffb0: 2020 7061 7373 6564 2076 6572 6261 7469 passed verbati │ │ │ │ │ -0002ffc0: 6d20 6173 2074 6865 206d 6f64 756c 6520 m as the module │ │ │ │ │ -0002ffd0: 636f 6d6d 616e 6420 6c69 6e65 2e0a 0a1f command line.... │ │ │ │ │ -0002ffe0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -0002fff0: 2c20 204e 6f64 653a 206d 756c 7469 626f , Node: multibo │ │ │ │ │ -00030000: 6f74 2c20 204e 6578 743a 206e 6174 6976 ot, Next: nativ │ │ │ │ │ -00030010: 6564 6973 6b2c 2020 5072 6576 3a20 6d6f edisk, Prev: mo │ │ │ │ │ -00030020: 6475 6c65 2c20 2055 703a 2043 6f6d 6d61 dule, Up: Comma │ │ │ │ │ -00030030: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -00030040: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ -00030050: 0a31 362e 332e 3530 206d 756c 7469 626f .16.3.50 multibo │ │ │ │ │ -00030060: 6f74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ot.------------- │ │ │ │ │ -00030070: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -00030080: 643a 206d 756c 7469 626f 6f74 205b 2d2d d: multiboot [-- │ │ │ │ │ -00030090: 7175 6972 6b2d 6261 642d 6b6c 7564 6765 quirk-bad-kludge │ │ │ │ │ -000300a0: 5d0a 2020 2020 2020 2020 2020 5b2d 2d71 ]. [--q │ │ │ │ │ -000300b0: 7569 726b 2d6d 6f64 756c 6573 2d61 6674 uirk-modules-aft │ │ │ │ │ -000300c0: 6572 2d6b 6572 6e65 6c5d 2066 696c 6520 er-kernel] file │ │ │ │ │ -000300d0: 2e2e 2e0a 2020 2020 204c 6f61 6420 6120 .... Load a │ │ │ │ │ -000300e0: 6d75 6c74 6962 6f6f 7420 6b65 726e 656c multiboot kernel │ │ │ │ │ -000300f0: 2069 6d61 6765 2066 726f 6d20 4649 4c45 image from FILE │ │ │ │ │ -00030100: 2e20 2054 6865 2072 6573 7420 6f66 2074 . The rest of t │ │ │ │ │ -00030110: 6865 206c 696e 6520 6973 0a20 2020 2020 he line is. │ │ │ │ │ -00030120: 7061 7373 6564 2076 6572 6261 7469 6d20 passed verbatim │ │ │ │ │ -00030130: 6173 2074 6865 2022 6b65 726e 656c 2063 as the "kernel c │ │ │ │ │ -00030140: 6f6d 6d61 6e64 2d6c 696e 6522 2e20 2041 ommand-line". A │ │ │ │ │ -00030150: 6e79 206d 6f64 756c 6520 6d75 7374 2062 ny module must b │ │ │ │ │ -00030160: 650a 2020 2020 2072 656c 6f61 6465 6420 e. reloaded │ │ │ │ │ -00030170: 6166 7465 7220 7573 696e 6720 7468 6973 after using this │ │ │ │ │ -00030180: 2063 6f6d 6d61 6e64 2028 2a6e 6f74 6520 command (*note │ │ │ │ │ -00030190: 6d6f 6475 6c65 3a3a 292e 0a0a 2020 2020 module::)... │ │ │ │ │ -000301a0: 2053 6f6d 6520 6b65 726e 656c 7320 6861 Some kernels ha │ │ │ │ │ -000301b0: 7665 206b 6e6f 776e 2070 726f 626c 656d ve known problem │ │ │ │ │ -000301c0: 732e 2020 596f 7520 6e65 6564 2074 6f20 s. You need to │ │ │ │ │ -000301d0: 7370 6563 6966 7920 2d71 7569 726b 2d2a specify -quirk-* │ │ │ │ │ -000301e0: 2066 6f72 0a20 2020 2020 7468 6f73 652e for. those. │ │ │ │ │ -000301f0: 2020 2d71 7569 726b 2d62 6164 2d6b 6c75 -quirk-bad-klu │ │ │ │ │ -00030200: 6467 6520 6973 2061 2070 726f 626c 656d dge is a problem │ │ │ │ │ -00030210: 2073 6565 6e20 696e 2073 6576 6572 616c seen in several │ │ │ │ │ -00030220: 2070 726f 6475 6374 730a 2020 2020 2074 products. t │ │ │ │ │ -00030230: 6861 7420 7468 6579 2069 6e63 6c75 6465 hat they include │ │ │ │ │ -00030240: 206c 6f61 6469 6e67 206b 6c75 6467 6520 loading kludge │ │ │ │ │ -00030250: 696e 666f 726d 6174 696f 6e20 7769 7468 information with │ │ │ │ │ -00030260: 2069 6e76 616c 6964 2064 6174 6120 696e invalid data in │ │ │ │ │ -00030270: 0a20 2020 2020 454c 4620 6669 6c65 2e20 . ELF file. │ │ │ │ │ -00030280: 2047 5255 4220 7072 696f 7220 746f 2030 GRUB prior to 0 │ │ │ │ │ -00030290: 2e39 3720 616e 6420 736f 6d65 2063 7573 .97 and some cus │ │ │ │ │ -000302a0: 746f 6d20 6275 696c 6473 2070 7265 6665 tom builds prefe │ │ │ │ │ -000302b0: 7272 6564 2045 4c46 0a20 2020 2020 696e rred ELF. in │ │ │ │ │ -000302c0: 666f 726d 6174 696f 6e20 7768 696c 6520 formation while │ │ │ │ │ -000302d0: 302e 3937 2061 6e64 2047 5255 4220 3220 0.97 and GRUB 2 │ │ │ │ │ -000302e0: 7573 6520 6b6c 7564 6765 2e20 2055 7365 use kludge. Use │ │ │ │ │ -000302f0: 2074 6869 7320 6f70 7469 6f6e 2074 6f0a this option to. │ │ │ │ │ -00030300: 2020 2020 2069 676e 6f72 6520 6b6c 7564 ignore klud │ │ │ │ │ -00030310: 6765 2e20 204b 6e6f 776e 2061 6666 6563 ge. Known affec │ │ │ │ │ -00030320: 7465 6420 7379 7374 656d 733a 206f 6c64 ted systems: old │ │ │ │ │ -00030330: 2053 6f6c 6172 6973 2c20 536b 794f 532e Solaris, SkyOS. │ │ │ │ │ -00030340: 0a0a 2020 2020 202d 7175 6972 6b2d 6d6f .. -quirk-mo │ │ │ │ │ -00030350: 6475 6c65 732d 6166 7465 722d 6b65 726e dules-after-kern │ │ │ │ │ -00030360: 656c 2069 7320 6e65 6564 6564 2066 6f72 el is needed for │ │ │ │ │ -00030370: 206b 6572 6e65 6c73 2077 6869 6368 206c kernels which l │ │ │ │ │ -00030380: 6f61 6420 6174 0a20 2020 2020 7265 6c61 oad at. rela │ │ │ │ │ -00030390: 7469 7665 6c79 2068 6967 6820 6164 6472 tively high addr │ │ │ │ │ -000303a0: 6573 7320 652e 672e 2020 3136 4d69 4220 ess e.g. 16MiB │ │ │ │ │ -000303b0: 6d61 726b 2061 6e64 2063 616e 2774 2063 mark and can't c │ │ │ │ │ -000303c0: 6f70 6520 7769 7468 0a20 2020 2020 6d6f ope with. mo │ │ │ │ │ -000303d0: 6475 6c65 7320 7374 7566 6665 6420 6265 dules stuffed be │ │ │ │ │ -000303e0: 7477 6565 6e20 314d 6942 206d 6172 6b20 tween 1MiB mark │ │ │ │ │ -000303f0: 616e 6420 6265 6769 6e6e 696e 6720 6f66 and beginning of │ │ │ │ │ -00030400: 2074 6865 206b 6572 6e65 6c2e 0a20 2020 the kernel.. │ │ │ │ │ -00030410: 2020 4b6e 6f77 6e20 6166 6674 6563 7465 Known afftecte │ │ │ │ │ -00030420: 6420 7379 7374 656d 733a 2056 4d57 6172 d systems: VMWar │ │ │ │ │ -00030430: 652e 0a0a 1f0a 4669 6c65 3a20 6772 7562 e.....File: grub │ │ │ │ │ -00030440: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e61 .info, Node: na │ │ │ │ │ -00030450: 7469 7665 6469 736b 2c20 204e 6578 743a tivedisk, Next: │ │ │ │ │ -00030460: 206e 6f72 6d61 6c2c 2020 5072 6576 3a20 normal, Prev: │ │ │ │ │ -00030470: 6d75 6c74 6962 6f6f 742c 2020 5570 3a20 multiboot, Up: │ │ │ │ │ -00030480: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -00030490: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -000304a0: 616e 6473 0a0a 3136 2e33 2e35 3120 6e61 ands..16.3.51 na │ │ │ │ │ -000304b0: 7469 7665 6469 736b 0a2d 2d2d 2d2d 2d2d tivedisk.------- │ │ │ │ │ -000304c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ -000304d0: 2043 6f6d 6d61 6e64 3a20 6e61 7469 7665 Command: native │ │ │ │ │ -000304e0: 6469 736b 0a20 2020 2020 5377 6974 6368 disk. Switch │ │ │ │ │ -000304f0: 2066 726f 6d20 6669 726d 7761 7265 2064 from firmware d │ │ │ │ │ -00030500: 6973 6b20 6472 6976 6572 7320 746f 206e isk drivers to n │ │ │ │ │ -00030510: 6174 6976 6520 6f6e 6573 2e20 2052 6561 ative ones. Rea │ │ │ │ │ -00030520: 6c6c 7920 7573 6566 756c 0a20 2020 2020 lly useful. │ │ │ │ │ -00030530: 6f6e 6c79 206f 6e20 706c 6174 666f 726d only on platform │ │ │ │ │ -00030540: 7320 7768 6572 6520 626f 7468 2066 6972 s where both fir │ │ │ │ │ -00030550: 6d77 6172 6520 616e 6420 6e61 7469 7665 mware and native │ │ │ │ │ -00030560: 2064 6973 6b20 6472 6976 6573 2061 7265 disk drives are │ │ │ │ │ -00030570: 0a20 2020 2020 6176 6169 6c61 626c 652e . available. │ │ │ │ │ -00030580: 2020 4375 7272 656e 746c 7920 6933 3836 Currently i386 │ │ │ │ │ -00030590: 2d70 632c 2069 3338 362d 6566 692c 2069 -pc, i386-efi, i │ │ │ │ │ -000305a0: 3338 362d 6965 6565 3132 3735 2061 6e64 386-ieee1275 and │ │ │ │ │ -000305b0: 0a20 2020 2020 7838 365f 3634 2d65 6669 . x86_64-efi │ │ │ │ │ -000305c0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -000305d0: 696e 666f 2c20 204e 6f64 653a 206e 6f72 info, Node: nor │ │ │ │ │ -000305e0: 6d61 6c2c 2020 4e65 7874 3a20 6e6f 726d mal, Next: norm │ │ │ │ │ -000305f0: 616c 5f65 7869 742c 2020 5072 6576 3a20 al_exit, Prev: │ │ │ │ │ -00030600: 6e61 7469 7665 6469 736b 2c20 2055 703a nativedisk, Up: │ │ │ │ │ -00030610: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ -00030620: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ -00030630: 6d61 6e64 730a 0a31 362e 332e 3532 206e mands..16.3.52 n │ │ │ │ │ -00030640: 6f72 6d61 6c0a 2d2d 2d2d 2d2d 2d2d 2d2d ormal.---------- │ │ │ │ │ -00030650: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -00030660: 643a 206e 6f72 6d61 6c20 5b66 696c 655d d: normal [file] │ │ │ │ │ -00030670: 0a20 2020 2020 456e 7465 7220 6e6f 726d . Enter norm │ │ │ │ │ -00030680: 616c 206d 6f64 6520 616e 6420 6469 7370 al mode and disp │ │ │ │ │ -00030690: 6c61 7920 7468 6520 4752 5542 206d 656e lay the GRUB men │ │ │ │ │ -000306a0: 752e 0a0a 2020 2020 2049 6e20 6e6f 726d u... In norm │ │ │ │ │ -000306b0: 616c 206d 6f64 652c 2063 6f6d 6d61 6e64 al mode, command │ │ │ │ │ -000306c0: 732c 2066 696c 6573 7973 7465 6d20 6d6f s, filesystem mo │ │ │ │ │ -000306d0: 6475 6c65 732c 2061 6e64 2063 7279 7074 dules, and crypt │ │ │ │ │ -000306e0: 6f67 7261 7068 790a 2020 2020 206d 6f64 ography. mod │ │ │ │ │ -000306f0: 756c 6573 2061 7265 2061 7574 6f6d 6174 ules are automat │ │ │ │ │ -00030700: 6963 616c 6c79 206c 6f61 6465 642c 2061 ically loaded, a │ │ │ │ │ -00030710: 6e64 2074 6865 2066 756c 6c20 4752 5542 nd the full GRUB │ │ │ │ │ -00030720: 2073 6372 6970 7420 7061 7273 6572 0a20 script parser. │ │ │ │ │ -00030730: 2020 2020 6973 2061 7661 696c 6162 6c65 is available │ │ │ │ │ -00030740: 2e20 204f 7468 6572 206d 6f64 756c 6573 . Other modules │ │ │ │ │ -00030750: 206d 6179 2062 6520 6578 706c 6963 6974 may be explicit │ │ │ │ │ -00030760: 6c79 206c 6f61 6465 6420 7573 696e 670a ly loaded using. │ │ │ │ │ -00030770: 2020 2020 2027 696e 736d 6f64 2720 282a 'insmod' (* │ │ │ │ │ -00030780: 6e6f 7465 2069 6e73 6d6f 643a 3a29 2e0a note insmod::).. │ │ │ │ │ -00030790: 0a20 2020 2020 4966 2061 2046 494c 4520 . If a FILE │ │ │ │ │ -000307a0: 6973 2067 6976 656e 2c20 7468 656e 2063 is given, then c │ │ │ │ │ -000307b0: 6f6d 6d61 6e64 7320 7769 6c6c 2062 6520 ommands will be │ │ │ │ │ -000307c0: 7265 6164 2066 726f 6d20 7468 6174 2066 read from that f │ │ │ │ │ -000307d0: 696c 652e 0a20 2020 2020 4f74 6865 7277 ile.. Otherw │ │ │ │ │ -000307e0: 6973 652c 2074 6865 7920 7769 6c6c 2062 ise, they will b │ │ │ │ │ -000307f0: 6520 7265 6164 2066 726f 6d20 2724 7072 e read from '$pr │ │ │ │ │ -00030800: 6566 6978 2f67 7275 622e 6366 6727 2069 efix/grub.cfg' i │ │ │ │ │ -00030810: 6620 6974 2065 7869 7374 732e 0a0a 2020 f it exists... │ │ │ │ │ -00030820: 2020 2027 6e6f 726d 616c 2720 6d61 7920 'normal' may │ │ │ │ │ -00030830: 6265 2063 616c 6c65 6420 6672 6f6d 2077 be called from w │ │ │ │ │ -00030840: 6974 6869 6e20 6e6f 726d 616c 206d 6f64 ithin normal mod │ │ │ │ │ -00030850: 652c 2063 7265 6174 696e 6720 6120 6e65 e, creating a ne │ │ │ │ │ -00030860: 7374 6564 0a20 2020 2020 656e 7669 726f sted. enviro │ │ │ │ │ -00030870: 6e6d 656e 742e 2020 4974 2069 7320 6d6f nment. It is mo │ │ │ │ │ -00030880: 7265 2075 7375 616c 2074 6f20 7573 6520 re usual to use │ │ │ │ │ -00030890: 2763 6f6e 6669 6766 696c 6527 2028 2a6e 'configfile' (*n │ │ │ │ │ -000308a0: 6f74 650a 2020 2020 2063 6f6e 6669 6766 ote. configf │ │ │ │ │ -000308b0: 696c 653a 3a29 2066 6f72 2074 6869 732e ile::) for this. │ │ │ │ │ -000308c0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -000308d0: 6e66 6f2c 2020 4e6f 6465 3a20 6e6f 726d nfo, Node: norm │ │ │ │ │ -000308e0: 616c 5f65 7869 742c 2020 4e65 7874 3a20 al_exit, Next: │ │ │ │ │ -000308f0: 7061 7274 746f 6f6c 2c20 2050 7265 763a parttool, Prev: │ │ │ │ │ -00030900: 206e 6f72 6d61 6c2c 2020 5570 3a20 436f normal, Up: Co │ │ │ │ │ -00030910: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -00030920: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -00030930: 6473 0a0a 3136 2e33 2e35 3320 6e6f 726d ds..16.3.53 norm │ │ │ │ │ -00030940: 616c 5f65 7869 740a 2d2d 2d2d 2d2d 2d2d al_exit.-------- │ │ │ │ │ -00030950: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ -00030960: 2043 6f6d 6d61 6e64 3a20 6e6f 726d 616c Command: normal │ │ │ │ │ -00030970: 5f65 7869 740a 2020 2020 2045 7869 7420 _exit. Exit │ │ │ │ │ -00030980: 6e6f 726d 616c 206d 6f64 6520 282a 6e6f normal mode (*no │ │ │ │ │ -00030990: 7465 206e 6f72 6d61 6c3a 3a29 2e20 2049 te normal::). I │ │ │ │ │ -000309a0: 6620 7468 6973 2069 6e73 7461 6e63 6520 f this instance │ │ │ │ │ -000309b0: 6f66 206e 6f72 6d61 6c20 6d6f 6465 0a20 of normal mode. │ │ │ │ │ -000309c0: 2020 2020 7761 7320 6e6f 7420 6e65 7374 was not nest │ │ │ │ │ -000309d0: 6564 2077 6974 6869 6e20 616e 6f74 6865 ed within anothe │ │ │ │ │ -000309e0: 7220 6f6e 652c 2074 6865 6e20 7265 7475 r one, then retu │ │ │ │ │ -000309f0: 726e 2074 6f20 7265 7363 7565 206d 6f64 rn to rescue mod │ │ │ │ │ -00030a00: 652e 0a0a 1f0a 4669 6c65 3a20 6772 7562 e.....File: grub │ │ │ │ │ -00030a10: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7061 .info, Node: pa │ │ │ │ │ -00030a20: 7274 746f 6f6c 2c20 204e 6578 743a 2070 rttool, Next: p │ │ │ │ │ -00030a30: 6173 7377 6f72 642c 2020 5072 6576 3a20 assword, Prev: │ │ │ │ │ -00030a40: 6e6f 726d 616c 5f65 7869 742c 2020 5570 normal_exit, Up │ │ │ │ │ -00030a50: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ -00030a60: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ -00030a70: 6d6d 616e 6473 0a0a 3136 2e33 2e35 3420 mmands..16.3.54 │ │ │ │ │ -00030a80: 7061 7274 746f 6f6c 0a2d 2d2d 2d2d 2d2d parttool.------- │ │ │ │ │ -00030a90: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -00030aa0: 6f6d 6d61 6e64 3a20 7061 7274 746f 6f6c ommand: parttool │ │ │ │ │ -00030ab0: 2070 6172 7469 7469 6f6e 2063 6f6d 6d61 partition comma │ │ │ │ │ -00030ac0: 6e64 730a 2020 2020 204d 616b 6520 7661 nds. Make va │ │ │ │ │ -00030ad0: 7269 6f75 7320 6d6f 6469 6669 6361 7469 rious modificati │ │ │ │ │ -00030ae0: 6f6e 7320 746f 2070 6172 7469 7469 6f6e ons to partition │ │ │ │ │ -00030af0: 2074 6162 6c65 2065 6e74 7269 6573 2e0a table entries.. │ │ │ │ │ -00030b00: 0a20 2020 2020 4561 6368 2043 4f4d 4d41 . Each COMMA │ │ │ │ │ -00030b10: 4e44 2069 7320 6569 7468 6572 2061 2062 ND is either a b │ │ │ │ │ -00030b20: 6f6f 6c65 616e 206f 7074 696f 6e2c 2069 oolean option, i │ │ │ │ │ -00030b30: 6e20 7768 6963 6820 6361 7365 2069 7420 n which case it │ │ │ │ │ -00030b40: 6d75 7374 2062 650a 2020 2020 2066 6f6c must be. fol │ │ │ │ │ -00030b50: 6c6f 7765 6420 7769 7468 2027 2b27 206f lowed with '+' o │ │ │ │ │ -00030b60: 7220 272d 2720 2877 6974 6820 6e6f 2069 r '-' (with no i │ │ │ │ │ -00030b70: 6e74 6572 7665 6e69 6e67 2073 7061 6365 ntervening space │ │ │ │ │ -00030b80: 2920 746f 2065 6e61 626c 6520 6f72 0a20 ) to enable or. │ │ │ │ │ -00030b90: 2020 2020 6469 7361 626c 6520 7468 6174 disable that │ │ │ │ │ -00030ba0: 206f 7074 696f 6e2c 206f 7220 656c 7365 option, or else │ │ │ │ │ -00030bb0: 2069 7420 7461 6b65 7320 6120 7661 6c75 it takes a valu │ │ │ │ │ -00030bc0: 6520 696e 2074 6865 2066 6f72 6d0a 2020 e in the form. │ │ │ │ │ -00030bd0: 2020 2027 434f 4d4d 414e 443d 5641 4c55 'COMMAND=VALU │ │ │ │ │ -00030be0: 4527 2e0a 0a20 2020 2020 4375 7272 656e E'... Curren │ │ │ │ │ -00030bf0: 746c 792c 2027 7061 7274 746f 6f6c 2720 tly, 'parttool' │ │ │ │ │ -00030c00: 6973 206f 6e6c 7920 7573 6566 756c 206f is only useful o │ │ │ │ │ -00030c10: 6e20 444f 5320 7061 7274 6974 696f 6e20 n DOS partition │ │ │ │ │ -00030c20: 7461 626c 6573 2028 616c 736f 0a20 2020 tables (also. │ │ │ │ │ -00030c30: 2020 6b6e 6f77 6e20 6173 204d 6173 7465 known as Maste │ │ │ │ │ -00030c40: 7220 426f 6f74 2052 6563 6f72 642c 206f r Boot Record, o │ │ │ │ │ -00030c50: 7220 4d42 5229 2e20 4f6e 2074 6865 7365 r MBR). On these │ │ │ │ │ -00030c60: 2070 6172 7469 7469 6f6e 2074 6162 6c65 partition table │ │ │ │ │ -00030c70: 732c 0a20 2020 2020 7468 6520 666f 6c6c s,. the foll │ │ │ │ │ -00030c80: 6f77 696e 6720 636f 6d6d 616e 6473 2061 owing commands a │ │ │ │ │ -00030c90: 7265 2061 7661 696c 6162 6c65 3a0a 0a20 re available:.. │ │ │ │ │ -00030ca0: 2020 2020 2762 6f6f 7427 2028 626f 6f6c 'boot' (bool │ │ │ │ │ -00030cb0: 6561 6e29 0a20 2020 2020 2020 2020 2057 ean). W │ │ │ │ │ -00030cc0: 6865 6e20 656e 6162 6c65 642c 2074 6869 hen enabled, thi │ │ │ │ │ -00030cd0: 7320 6d61 6b65 7320 7468 6520 7365 6c65 s makes the sele │ │ │ │ │ -00030ce0: 6374 6564 2070 6172 7469 7469 6f6e 2062 cted partition b │ │ │ │ │ -00030cf0: 6520 7468 6520 6163 7469 7665 0a20 2020 e the active. │ │ │ │ │ -00030d00: 2020 2020 2020 2028 626f 6f74 6162 6c65 (bootable │ │ │ │ │ -00030d10: 2920 7061 7274 6974 696f 6e20 6f6e 2069 ) partition on i │ │ │ │ │ -00030d20: 7473 2064 6973 6b2c 2063 6c65 6172 696e ts disk, clearin │ │ │ │ │ -00030d30: 6720 7468 6520 6163 7469 7665 2066 6c61 g the active fla │ │ │ │ │ -00030d40: 6720 6f6e 0a20 2020 2020 2020 2020 2061 g on. a │ │ │ │ │ -00030d50: 6c6c 206f 7468 6572 2070 6172 7469 7469 ll other partiti │ │ │ │ │ -00030d60: 6f6e 732e 2020 5468 6973 2063 6f6d 6d61 ons. This comma │ │ │ │ │ -00030d70: 6e64 2069 7320 6c69 6d69 7465 6420 746f nd is limited to │ │ │ │ │ -00030d80: 205f 7072 696d 6172 795f 0a20 2020 2020 _primary_. │ │ │ │ │ -00030d90: 2020 2020 2070 6172 7469 7469 6f6e 732e partitions. │ │ │ │ │ -00030da0: 0a0a 2020 2020 2027 7479 7065 2720 2876 .. 'type' (v │ │ │ │ │ -00030db0: 616c 7565 290a 2020 2020 2020 2020 2020 alue). │ │ │ │ │ -00030dc0: 4368 616e 6765 2074 6865 2074 7970 6520 Change the type │ │ │ │ │ -00030dd0: 6f66 2061 6e20 6578 6973 7469 6e67 2070 of an existing p │ │ │ │ │ -00030de0: 6172 7469 7469 6f6e 2e20 2054 6865 2076 artition. The v │ │ │ │ │ -00030df0: 616c 7565 206d 7573 7420 6265 2061 0a20 alue must be a. │ │ │ │ │ -00030e00: 2020 2020 2020 2020 206e 756d 6265 7220 number │ │ │ │ │ -00030e10: 696e 2074 6865 2072 616e 6765 2030 2d30 in the range 0-0 │ │ │ │ │ -00030e20: 7846 4620 2870 7265 6669 7820 7769 7468 xFF (prefix with │ │ │ │ │ -00030e30: 2027 3078 2720 746f 2065 6e74 6572 2069 '0x' to enter i │ │ │ │ │ -00030e40: 7420 696e 0a20 2020 2020 2020 2020 2068 t in. h │ │ │ │ │ -00030e50: 6578 6164 6563 696d 616c 292e 0a0a 2020 exadecimal)... │ │ │ │ │ -00030e60: 2020 2027 6869 6464 656e 2720 2862 6f6f 'hidden' (boo │ │ │ │ │ -00030e70: 6c65 616e 290a 2020 2020 2020 2020 2020 lean). │ │ │ │ │ -00030e80: 5768 656e 2065 6e61 626c 6564 2c20 7468 When enabled, th │ │ │ │ │ -00030e90: 6973 2068 6964 6573 2074 6865 2073 656c is hides the sel │ │ │ │ │ -00030ea0: 6563 7465 6420 7061 7274 6974 696f 6e20 ected partition │ │ │ │ │ -00030eb0: 6279 2073 6574 7469 6e67 2074 6865 0a20 by setting the. │ │ │ │ │ -00030ec0: 2020 2020 2020 2020 2022 6869 6464 656e "hidden │ │ │ │ │ -00030ed0: 2220 6269 7420 696e 2069 7473 2070 6172 " bit in its par │ │ │ │ │ -00030ee0: 7469 7469 6f6e 2074 7970 6520 636f 6465 tition type code │ │ │ │ │ -00030ef0: 3b20 7768 656e 2064 6973 6162 6c65 642c ; when disabled, │ │ │ │ │ -00030f00: 0a20 2020 2020 2020 2020 2075 6e68 6964 . unhid │ │ │ │ │ -00030f10: 6573 2074 6865 2073 656c 6563 7465 6420 es the selected │ │ │ │ │ -00030f20: 7061 7274 6974 696f 6e20 6279 2063 6c65 partition by cle │ │ │ │ │ -00030f30: 6172 696e 6720 7468 6973 2062 6974 2e20 aring this bit. │ │ │ │ │ -00030f40: 2054 6869 7320 6973 0a20 2020 2020 2020 This is. │ │ │ │ │ -00030f50: 2020 2075 7365 6675 6c20 6f6e 6c79 2077 useful only w │ │ │ │ │ -00030f60: 6865 6e20 626f 6f74 696e 6720 444f 5320 hen booting DOS │ │ │ │ │ -00030f70: 6f72 2057 696e 646f 7773 2061 6e64 206d or Windows and m │ │ │ │ │ -00030f80: 756c 7469 706c 6520 7072 696d 6172 790a ultiple primary. │ │ │ │ │ -00030f90: 2020 2020 2020 2020 2020 4641 5420 7061 FAT pa │ │ │ │ │ -00030fa0: 7274 6974 696f 6e73 2065 7869 7374 2069 rtitions exist i │ │ │ │ │ -00030fb0: 6e20 6f6e 6520 6469 736b 2e20 2053 6565 n one disk. See │ │ │ │ │ -00030fc0: 2061 6c73 6f20 2a6e 6f74 650a 2020 2020 also *note. │ │ │ │ │ -00030fd0: 2020 2020 2020 444f 532f 5769 6e64 6f77 DOS/Window │ │ │ │ │ -00030fe0: 733a 3a2e 0a0a 1f0a 4669 6c65 3a20 6772 s::.....File: gr │ │ │ │ │ -00030ff0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00031000: 7061 7373 776f 7264 2c20 204e 6578 743a password, Next: │ │ │ │ │ -00031010: 2070 6173 7377 6f72 645f 7062 6b64 6632 password_pbkdf2 │ │ │ │ │ -00031020: 2c20 2050 7265 763a 2070 6172 7474 6f6f , Prev: parttoo │ │ │ │ │ -00031030: 6c2c 2020 5570 3a20 436f 6d6d 616e 642d l, Up: Command- │ │ │ │ │ -00031040: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ -00031050: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ -00031060: 2e33 2e35 3520 7061 7373 776f 7264 0a2d .3.55 password.- │ │ │ │ │ -00031070: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -00031080: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7061 . -- Command: pa │ │ │ │ │ -00031090: 7373 776f 7264 2075 7365 7220 636c 6561 ssword user clea │ │ │ │ │ -000310a0: 722d 7061 7373 776f 7264 0a20 2020 2020 r-password. │ │ │ │ │ -000310b0: 4465 6669 6e65 2061 2075 7365 7220 6e61 Define a user na │ │ │ │ │ -000310c0: 6d65 6420 5553 4552 2077 6974 6820 7061 med USER with pa │ │ │ │ │ -000310d0: 7373 776f 7264 2043 4c45 4152 2d50 4153 ssword CLEAR-PAS │ │ │ │ │ -000310e0: 5357 4f52 442e 2020 2a4e 6f74 650a 2020 SWORD. *Note. │ │ │ │ │ -000310f0: 2020 2053 6563 7572 6974 793a 3a2e 0a0a Security::... │ │ │ │ │ -00031100: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00031110: 6f2c 2020 4e6f 6465 3a20 7061 7373 776f o, Node: passwo │ │ │ │ │ -00031120: 7264 5f70 626b 6466 322c 2020 4e65 7874 rd_pbkdf2, Next │ │ │ │ │ -00031130: 3a20 706c 6179 2c20 2050 7265 763a 2070 : play, Prev: p │ │ │ │ │ -00031140: 6173 7377 6f72 642c 2020 5570 3a20 436f assword, Up: Co │ │ │ │ │ -00031150: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -00031160: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -00031170: 6473 0a0a 3136 2e33 2e35 3620 7061 7373 ds..16.3.56 pass │ │ │ │ │ -00031180: 776f 7264 5f70 626b 6466 320a 2d2d 2d2d word_pbkdf2.---- │ │ │ │ │ +0002b990: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ +0002b9a0: 2063 7279 7074 6f6d 6f75 6e74 2064 6576 cryptomount dev │ │ │ │ │ +0002b9b0: 6963 657c 2d75 2075 7569 647c 2d61 7c2d ice|-u uuid|-a|- │ │ │ │ │ +0002b9c0: 620a 2020 2020 2053 6574 7570 2061 6363 b. Setup acc │ │ │ │ │ +0002b9d0: 6573 7320 746f 2065 6e63 7279 7074 6564 ess to encrypted │ │ │ │ │ +0002b9e0: 2064 6576 6963 652e 2020 4966 206e 6563 device. If nec │ │ │ │ │ +0002b9f0: 6573 7361 7279 2c20 7061 7373 7068 7261 essary, passphra │ │ │ │ │ +0002ba00: 7365 2069 730a 2020 2020 2072 6571 7565 se is. reque │ │ │ │ │ +0002ba10: 7374 6564 2069 6e74 6572 6163 7469 7665 sted interactive │ │ │ │ │ +0002ba20: 6c79 2e20 204f 7074 696f 6e20 4445 5649 ly. Option DEVI │ │ │ │ │ +0002ba30: 4345 2063 6f6e 6669 6775 7265 7320 7370 CE configures sp │ │ │ │ │ +0002ba40: 6563 6966 6963 2067 7275 620a 2020 2020 ecific grub. │ │ │ │ │ +0002ba50: 2064 6576 6963 6520 282a 6e6f 7465 204e device (*note N │ │ │ │ │ +0002ba60: 616d 696e 6720 636f 6e76 656e 7469 6f6e aming convention │ │ │ │ │ +0002ba70: 3a3a 293b 206f 7074 696f 6e20 272d 7527 ::); option '-u' │ │ │ │ │ +0002ba80: 2055 5549 4420 636f 6e66 6967 7572 6573 UUID configures │ │ │ │ │ +0002ba90: 0a20 2020 2020 6465 7669 6365 2077 6974 . device wit │ │ │ │ │ +0002baa0: 6820 7370 6563 6966 6965 6420 5555 4944 h specified UUID │ │ │ │ │ +0002bab0: 3b20 6f70 7469 6f6e 2027 2d61 2720 636f ; option '-a' co │ │ │ │ │ +0002bac0: 6e66 6967 7572 6573 2061 6c6c 2064 6574 nfigures all det │ │ │ │ │ +0002bad0: 6563 7465 640a 2020 2020 2065 6e63 7279 ected. encry │ │ │ │ │ +0002bae0: 7074 6564 2064 6576 6963 6573 3b20 6f70 pted devices; op │ │ │ │ │ +0002baf0: 7469 6f6e 2027 2d62 2720 636f 6e66 6967 tion '-b' config │ │ │ │ │ +0002bb00: 7572 6573 2061 6c6c 2067 656c 6920 636f ures all geli co │ │ │ │ │ +0002bb10: 6e74 6169 6e65 7273 2074 6861 740a 2020 ntainers that. │ │ │ │ │ +0002bb20: 2020 2068 6176 6520 626f 6f74 2066 6c61 have boot fla │ │ │ │ │ +0002bb30: 6720 7365 742e 0a0a 2020 2020 2047 5255 g set... GRU │ │ │ │ │ +0002bb40: 4220 7375 706f 7274 7320 6465 7669 6365 B suports device │ │ │ │ │ +0002bb50: 7320 656e 6372 7970 7465 6420 7573 696e s encrypted usin │ │ │ │ │ +0002bb60: 6720 4c55 4b53 2c20 4c55 4b53 3220 616e g LUKS, LUKS2 an │ │ │ │ │ +0002bb70: 6420 6765 6c69 2e20 204e 6f74 650a 2020 d geli. Note. │ │ │ │ │ +0002bb80: 2020 2074 6861 7420 6e65 6365 7373 6172 that necessar │ │ │ │ │ +0002bb90: 7920 6d6f 6475 6c65 7320 284c 554b 532c y modules (LUKS, │ │ │ │ │ +0002bba0: 204c 554b 5332 2061 6e64 2047 454c 4929 LUKS2 and GELI) │ │ │ │ │ +0002bbb0: 2068 6176 6520 746f 2062 6520 6c6f 6164 have to be load │ │ │ │ │ +0002bbc0: 6564 0a20 2020 2020 6d61 6e75 616c 6c79 ed. manually │ │ │ │ │ +0002bbd0: 2062 6566 6f72 6520 7468 6973 2063 6f6d before this com │ │ │ │ │ +0002bbe0: 6d61 6e64 2063 616e 2062 6520 7573 6564 mand can be used │ │ │ │ │ +0002bbf0: 2e20 2046 6f72 204c 554b 5332 206f 6e6c . For LUKS2 onl │ │ │ │ │ +0002bc00: 7920 7468 650a 2020 2020 2050 424b 4446 y the. PBKDF │ │ │ │ │ +0002bc10: 3220 6b65 7920 6465 7269 7661 7469 6f6e 2 key derivation │ │ │ │ │ +0002bc20: 2066 756e 6374 696f 6e20 6973 2073 7570 function is sup │ │ │ │ │ +0002bc30: 706f 7274 6564 2c20 6173 2041 7267 6f6e ported, as Argon │ │ │ │ │ +0002bc40: 3220 6973 206e 6f74 2079 6574 0a20 2020 2 is not yet. │ │ │ │ │ +0002bc50: 2020 7375 7070 6f72 7465 642e 0a0a 2020 supported... │ │ │ │ │ +0002bc60: 2020 2041 6c73 6f2c 206e 6f74 6520 7468 Also, note th │ │ │ │ │ +0002bc70: 6174 2c20 756e 6c69 6b65 2066 696c 6573 at, unlike files │ │ │ │ │ +0002bc80: 7973 7465 6d20 5555 4944 732c 2055 5549 ystem UUIDs, UUI │ │ │ │ │ +0002bc90: 4473 2066 6f72 2065 6e63 7279 7074 6564 Ds for encrypted │ │ │ │ │ +0002bca0: 0a20 2020 2020 6465 7669 6365 7320 6d75 . devices mu │ │ │ │ │ +0002bcb0: 7374 2062 6520 7370 6563 6966 6965 6420 st be specified │ │ │ │ │ +0002bcc0: 7769 7468 6f75 7420 6461 7368 2073 6570 without dash sep │ │ │ │ │ +0002bcd0: 6172 6174 6f72 732e 0a0a 1f0a 4669 6c65 arators.....File │ │ │ │ │ +0002bce0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0002bcf0: 6465 3a20 6375 746d 656d 2c20 204e 6578 de: cutmem, Nex │ │ │ │ │ +0002bd00: 743a 2064 6174 652c 2020 5072 6576 3a20 t: date, Prev: │ │ │ │ │ +0002bd10: 6372 7970 746f 6d6f 756e 742c 2020 5570 cryptomount, Up │ │ │ │ │ +0002bd20: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +0002bd30: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +0002bd40: 6d6d 616e 6473 0a0a 3136 2e33 2e32 3020 mmands..16.3.20 │ │ │ │ │ +0002bd50: 6375 746d 656d 0a2d 2d2d 2d2d 2d2d 2d2d cutmem.--------- │ │ │ │ │ +0002bd60: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +0002bd70: 6e64 3a20 6375 746d 656d 2066 726f 6d5b nd: cutmem from[ │ │ │ │ │ +0002bd80: 4b7c 4d7c 475d 2074 6f5b 4b7c 4d7c 475d K|M|G] to[K|M|G] │ │ │ │ │ +0002bd90: 0a20 2020 2020 5265 6d6f 7665 2061 6e79 . Remove any │ │ │ │ │ +0002bda0: 206d 656d 6f72 7920 7265 6769 6f6e 7320 memory regions │ │ │ │ │ +0002bdb0: 696e 2073 7065 6369 6669 6564 2072 616e in specified ran │ │ │ │ │ +0002bdc0: 6765 2e0a 0a20 2020 2020 5468 6973 2063 ge... This c │ │ │ │ │ +0002bdd0: 6f6d 6d61 6e64 206e 6f74 6966 6965 7320 ommand notifies │ │ │ │ │ +0002bde0: 7468 6520 6d65 6d6f 7279 206d 616e 6167 the memory manag │ │ │ │ │ +0002bdf0: 6572 2074 6861 7420 7370 6563 6966 6965 er that specifie │ │ │ │ │ +0002be00: 6420 7265 6769 6f6e 7320 6f66 0a20 2020 d regions of. │ │ │ │ │ +0002be10: 2020 5241 4d20 6f75 6768 7420 746f 2062 RAM ought to b │ │ │ │ │ +0002be20: 6520 6669 6c74 6572 6564 206f 7574 2e20 e filtered out. │ │ │ │ │ +0002be30: 2054 6869 7320 7265 6d61 696e 7320 696e This remains in │ │ │ │ │ +0002be40: 2065 6666 6563 7420 6166 7465 7220 610a effect after a. │ │ │ │ │ +0002be50: 2020 2020 2070 6179 6c6f 6164 206b 6572 payload ker │ │ │ │ │ +0002be60: 6e65 6c20 6861 7320 6265 656e 206c 6f61 nel has been loa │ │ │ │ │ +0002be70: 6465 6420 6279 2047 5255 422c 2061 7320 ded by GRUB, as │ │ │ │ │ +0002be80: 6c6f 6e67 2061 7320 7468 6520 6c6f 6164 long as the load │ │ │ │ │ +0002be90: 6564 0a20 2020 2020 6b65 726e 656c 206f ed. kernel o │ │ │ │ │ +0002bea0: 6274 6169 6e73 2069 7473 206d 656d 6f72 btains its memor │ │ │ │ │ +0002beb0: 7920 6d61 7020 6672 6f6d 2047 5255 422e y map from GRUB. │ │ │ │ │ +0002bec0: 204b 6572 6e65 6c73 2074 6861 7420 7375 Kernels that su │ │ │ │ │ +0002bed0: 7070 6f72 7420 7468 6973 0a20 2020 2020 pport this. │ │ │ │ │ +0002bee0: 696e 636c 7564 6520 4c69 6e75 782c 2047 include Linux, G │ │ │ │ │ +0002bef0: 4e55 204d 6163 682c 2074 6865 206b 6572 NU Mach, the ker │ │ │ │ │ +0002bf00: 6e65 6c20 6f66 2046 7265 6542 5344 2061 nel of FreeBSD a │ │ │ │ │ +0002bf10: 6e64 204d 756c 7469 626f 6f74 0a20 2020 nd Multiboot. │ │ │ │ │ +0002bf20: 2020 6b65 726e 656c 7320 696e 2067 656e kernels in gen │ │ │ │ │ +0002bf30: 6572 616c 2e0a 0a20 2020 2020 5468 6520 eral... The │ │ │ │ │ +0002bf40: 636f 6d6d 616e 6420 6973 2073 696d 696c command is simil │ │ │ │ │ +0002bf50: 6172 2074 6f20 2762 6164 7261 6d27 2063 ar to 'badram' c │ │ │ │ │ +0002bf60: 6f6d 6d61 6e64 2e0a 0a20 2020 2020 4e6f ommand... No │ │ │ │ │ +0002bf70: 7465 3a20 5468 6520 636f 6d6d 616e 6420 te: The command │ │ │ │ │ +0002bf80: 6973 206e 6f74 2061 6c6c 6f77 6564 2077 is not allowed w │ │ │ │ │ +0002bf90: 6865 6e20 6c6f 636b 646f 776e 2069 7320 hen lockdown is │ │ │ │ │ +0002bfa0: 656e 666f 7263 6564 2028 2a6e 6f74 650a enforced (*note. │ │ │ │ │ +0002bfb0: 2020 2020 204c 6f63 6b64 6f77 6e3a 3a29 Lockdown::) │ │ │ │ │ +0002bfc0: 2e20 2054 6869 7320 7072 6576 656e 7473 . This prevents │ │ │ │ │ +0002bfd0: 2072 656d 6f76 696e 6720 4546 4920 6d65 removing EFI me │ │ │ │ │ +0002bfe0: 6d6f 7279 2072 6567 696f 6e73 2074 6f0a mory regions to. │ │ │ │ │ +0002bff0: 2020 2020 2070 6f74 656e 7469 616c 6c79 potentially │ │ │ │ │ +0002c000: 2073 7562 7665 7274 2074 6865 2073 6563 subvert the sec │ │ │ │ │ +0002c010: 7572 6974 7920 6d65 6368 616e 6973 6d73 urity mechanisms │ │ │ │ │ +0002c020: 2070 726f 7669 6465 6420 6279 2074 6865 provided by the │ │ │ │ │ +0002c030: 2055 4546 490a 2020 2020 2073 6563 7572 UEFI. secur │ │ │ │ │ +0002c040: 6520 626f 6f74 2e0a 0a1f 0a46 696c 653a e boot.....File: │ │ │ │ │ +0002c050: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002c060: 653a 2064 6174 652c 2020 4e65 7874 3a20 e: date, Next: │ │ │ │ │ +0002c070: 6465 7669 6365 7472 6565 2c20 2050 7265 devicetree, Pre │ │ │ │ │ +0002c080: 763a 2063 7574 6d65 6d2c 2020 5570 3a20 v: cutmem, Up: │ │ │ │ │ +0002c090: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +0002c0a0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +0002c0b0: 616e 6473 0a0a 3136 2e33 2e32 3120 6461 ands..16.3.21 da │ │ │ │ │ +0002c0c0: 7465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a te.------------. │ │ │ │ │ +0002c0d0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6461 . -- Command: da │ │ │ │ │ +0002c0e0: 7465 205b 5b79 6561 722d 5d6d 6f6e 7468 te [[year-]month │ │ │ │ │ +0002c0f0: 2d64 6179 5d20 5b68 6f75 723a 6d69 6e75 -day] [hour:minu │ │ │ │ │ +0002c100: 7465 5b3a 7365 636f 6e64 5d5d 0a20 2020 te[:second]]. │ │ │ │ │ +0002c110: 2020 5769 7468 206e 6f20 6172 6775 6d65 With no argume │ │ │ │ │ +0002c120: 6e74 732c 2070 7269 6e74 2074 6865 2063 nts, print the c │ │ │ │ │ +0002c130: 7572 7265 6e74 2064 6174 6520 616e 6420 urrent date and │ │ │ │ │ +0002c140: 7469 6d65 2e0a 0a20 2020 2020 4f74 6865 time... Othe │ │ │ │ │ +0002c150: 7277 6973 652c 2074 616b 6520 7468 6520 rwise, take the │ │ │ │ │ +0002c160: 6375 7272 656e 7420 6461 7465 2061 6e64 current date and │ │ │ │ │ +0002c170: 2074 696d 652c 2063 6861 6e67 6520 616e time, change an │ │ │ │ │ +0002c180: 7920 656c 656d 656e 7473 0a20 2020 2020 y elements. │ │ │ │ │ +0002c190: 7370 6563 6966 6965 6420 6173 2061 7267 specified as arg │ │ │ │ │ +0002c1a0: 756d 656e 7473 2c20 616e 6420 7365 7420 uments, and set │ │ │ │ │ +0002c1b0: 7468 6520 7265 7375 6c74 2061 7320 7468 the result as th │ │ │ │ │ +0002c1c0: 6520 6e65 7720 6461 7465 2061 6e64 0a20 e new date and. │ │ │ │ │ +0002c1d0: 2020 2020 7469 6d65 2e20 2046 6f72 2065 time. For e │ │ │ │ │ +0002c1e0: 7861 6d70 6c65 2c20 2764 6174 6520 3031 xample, 'date 01 │ │ │ │ │ +0002c1f0: 2d30 3127 2077 696c 6c20 7365 7420 7468 -01' will set th │ │ │ │ │ +0002c200: 6520 6375 7272 656e 7420 6d6f 6e74 6820 e current month │ │ │ │ │ +0002c210: 616e 6420 6461 790a 2020 2020 2074 6f20 and day. to │ │ │ │ │ +0002c220: 4a61 6e75 6172 7920 312c 2062 7574 206c January 1, but l │ │ │ │ │ +0002c230: 6561 7665 2074 6865 2079 6561 722c 2068 eave the year, h │ │ │ │ │ +0002c240: 6f75 722c 206d 696e 7574 652c 2061 6e64 our, minute, and │ │ │ │ │ +0002c250: 2073 6563 6f6e 640a 2020 2020 2075 6e63 second. unc │ │ │ │ │ +0002c260: 6861 6e67 6564 2e0a 0a1f 0a46 696c 653a hanged.....File: │ │ │ │ │ +0002c270: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002c280: 653a 2064 6576 6963 6574 7265 652c 2020 e: devicetree, │ │ │ │ │ +0002c290: 4e65 7874 3a20 6469 7374 7275 7374 2c20 Next: distrust, │ │ │ │ │ +0002c2a0: 2050 7265 763a 2064 6174 652c 2020 5570 Prev: date, Up │ │ │ │ │ +0002c2b0: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +0002c2c0: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +0002c2d0: 6d6d 616e 6473 0a0a 3136 2e33 2e32 3220 mmands..16.3.22 │ │ │ │ │ +0002c2e0: 6465 7669 6365 7472 6565 0a2d 2d2d 2d2d devicetree.----- │ │ │ │ │ +0002c2f0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +0002c300: 2d2d 2043 6f6d 6d61 6e64 3a20 6465 7669 -- Command: devi │ │ │ │ │ +0002c310: 6365 7472 6565 2066 696c 650a 2020 2020 cetree file. │ │ │ │ │ +0002c320: 204c 6f61 6420 6120 6465 7669 6365 2074 Load a device t │ │ │ │ │ +0002c330: 7265 6520 626c 6f62 2028 2e64 7462 2920 ree blob (.dtb) │ │ │ │ │ +0002c340: 6672 6f6d 2061 2066 696c 6573 7973 7465 from a filesyste │ │ │ │ │ +0002c350: 6d2c 2066 6f72 206c 6174 6572 2075 7365 m, for later use │ │ │ │ │ +0002c360: 2062 790a 2020 2020 2061 204c 696e 7578 by. a Linux │ │ │ │ │ +0002c370: 206b 6572 6e65 6c2e 2020 446f 6573 206e kernel. Does n │ │ │ │ │ +0002c380: 6f74 2070 6572 666f 726d 206d 6572 6769 ot perform mergi │ │ │ │ │ +0002c390: 6e67 2077 6974 6820 616e 7920 6465 7669 ng with any devi │ │ │ │ │ +0002c3a0: 6365 2074 7265 650a 2020 2020 2073 7570 ce tree. sup │ │ │ │ │ +0002c3b0: 706c 6965 6420 6279 2066 6972 6d77 6172 plied by firmwar │ │ │ │ │ +0002c3c0: 652c 2062 7574 2072 6174 6865 7220 7265 e, but rather re │ │ │ │ │ +0002c3d0: 706c 6163 6573 2069 7420 636f 6d70 6c65 places it comple │ │ │ │ │ +0002c3e0: 7465 6c79 2e0a 0a20 2020 2020 4e6f 7465 tely... Note │ │ │ │ │ +0002c3f0: 3a20 5468 6520 636f 6d6d 616e 6420 6973 : The command is │ │ │ │ │ +0002c400: 206e 6f74 2061 6c6c 6f77 6564 2077 6865 not allowed whe │ │ │ │ │ +0002c410: 6e20 6c6f 636b 646f 776e 2069 7320 656e n lockdown is en │ │ │ │ │ +0002c420: 666f 7263 6564 2028 2a6e 6f74 650a 2020 forced (*note. │ │ │ │ │ +0002c430: 2020 204c 6f63 6b64 6f77 6e3a 3a29 2e20 Lockdown::). │ │ │ │ │ +0002c440: 2054 6869 7320 6973 2064 6f6e 6520 746f This is done to │ │ │ │ │ +0002c450: 2070 7265 7665 6e74 2073 7562 7665 7274 prevent subvert │ │ │ │ │ +0002c460: 696e 6720 7661 7269 6f75 7320 7365 6375 ing various secu │ │ │ │ │ +0002c470: 7269 7479 0a20 2020 2020 6d65 6368 616e rity. mechan │ │ │ │ │ +0002c480: 6973 6d73 2e0a 0a1f 0a46 696c 653a 2067 isms.....File: g │ │ │ │ │ +0002c490: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +0002c4a0: 2064 6973 7472 7573 742c 2020 4e65 7874 distrust, Next │ │ │ │ │ +0002c4b0: 3a20 6472 6976 656d 6170 2c20 2050 7265 : drivemap, Pre │ │ │ │ │ +0002c4c0: 763a 2064 6576 6963 6574 7265 652c 2020 v: devicetree, │ │ │ │ │ +0002c4d0: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ +0002c4e0: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +0002c4f0: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e32 commands..16.3.2 │ │ │ │ │ +0002c500: 3320 6469 7374 7275 7374 0a2d 2d2d 2d2d 3 distrust.----- │ │ │ │ │ +0002c510: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +0002c520: 2043 6f6d 6d61 6e64 3a20 6469 7374 7275 Command: distru │ │ │ │ │ +0002c530: 7374 2070 7562 6b65 795f 6964 0a20 2020 st pubkey_id. │ │ │ │ │ +0002c540: 2020 5265 6d6f 7665 2070 7562 6c69 6320 Remove public │ │ │ │ │ +0002c550: 6b65 7920 5055 424b 4559 5f49 4420 6672 key PUBKEY_ID fr │ │ │ │ │ +0002c560: 6f6d 2047 5255 4227 7320 6b65 7972 696e om GRUB's keyrin │ │ │ │ │ +0002c570: 6720 6f66 2074 7275 7374 6564 206b 6579 g of trusted key │ │ │ │ │ +0002c580: 732e 0a20 2020 2020 5055 424b 4559 5f49 s.. PUBKEY_I │ │ │ │ │ +0002c590: 4420 6973 2074 6865 206c 6173 7420 666f D is the last fo │ │ │ │ │ +0002c5a0: 7572 2062 7974 6573 2028 6569 6768 7420 ur bytes (eight │ │ │ │ │ +0002c5b0: 6865 7861 6465 6369 6d61 6c20 6469 6769 hexadecimal digi │ │ │ │ │ +0002c5c0: 7473 2920 6f66 2074 6865 0a20 2020 2020 ts) of the. │ │ │ │ │ +0002c5d0: 4750 4720 7634 206b 6579 2069 642c 2077 GPG v4 key id, w │ │ │ │ │ +0002c5e0: 6869 6368 2069 7320 616c 736f 2074 6865 hich is also the │ │ │ │ │ +0002c5f0: 206f 7574 7075 7420 6f66 2027 6c69 7374 output of 'list │ │ │ │ │ +0002c600: 5f74 7275 7374 6564 2720 282a 6e6f 7465 _trusted' (*note │ │ │ │ │ +0002c610: 0a20 2020 2020 6c69 7374 5f74 7275 7374 . list_trust │ │ │ │ │ +0002c620: 6564 3a3a 292e 2020 4f75 7473 6964 6520 ed::). Outside │ │ │ │ │ +0002c630: 6f66 2047 5255 422c 2074 6865 206b 6579 of GRUB, the key │ │ │ │ │ +0002c640: 2069 6420 6361 6e20 6265 206f 6274 6169 id can be obtai │ │ │ │ │ +0002c650: 6e65 6420 7573 696e 670a 2020 2020 2027 ned using. ' │ │ │ │ │ +0002c660: 6770 6720 2d2d 6669 6e67 6572 7072 696e gpg --fingerprin │ │ │ │ │ +0002c670: 7427 292e 2020 5468 6573 6520 6b65 7973 t'). These keys │ │ │ │ │ +0002c680: 2061 7265 2075 7365 6420 746f 2076 616c are used to val │ │ │ │ │ +0002c690: 6964 6174 6520 7369 676e 6174 7572 6573 idate signatures │ │ │ │ │ +0002c6a0: 0a20 2020 2020 7768 656e 2065 6e76 6972 . when envir │ │ │ │ │ +0002c6b0: 6f6e 6d65 6e74 2076 6172 6961 626c 6520 onment variable │ │ │ │ │ +0002c6c0: 2763 6865 636b 5f73 6967 6e61 7475 7265 'check_signature │ │ │ │ │ +0002c6d0: 7327 2069 7320 7365 7420 746f 2027 656e s' is set to 'en │ │ │ │ │ +0002c6e0: 666f 7263 6527 0a20 2020 2020 282a 6e6f force'. (*no │ │ │ │ │ +0002c6f0: 7465 2063 6865 636b 5f73 6967 6e61 7475 te check_signatu │ │ │ │ │ +0002c700: 7265 733a 3a29 2c20 616e 6420 6279 2073 res::), and by s │ │ │ │ │ +0002c710: 6f6d 6520 696e 766f 6361 7469 6f6e 7320 ome invocations │ │ │ │ │ +0002c720: 6f66 0a20 2020 2020 2776 6572 6966 795f of. 'verify_ │ │ │ │ │ +0002c730: 6465 7461 6368 6564 2720 282a 6e6f 7465 detached' (*note │ │ │ │ │ +0002c740: 2076 6572 6966 795f 6465 7461 6368 6564 verify_detached │ │ │ │ │ +0002c750: 3a3a 292e 2020 2a4e 6f74 6520 5573 696e ::). *Note Usin │ │ │ │ │ +0002c760: 6720 6469 6769 7461 6c0a 2020 2020 2073 g digital. s │ │ │ │ │ +0002c770: 6967 6e61 7475 7265 733a 3a2c 2066 6f72 ignatures::, for │ │ │ │ │ +0002c780: 206d 6f72 6520 696e 666f 726d 6174 696f more informatio │ │ │ │ │ +0002c790: 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 n.....File: grub │ │ │ │ │ +0002c7a0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6472 .info, Node: dr │ │ │ │ │ +0002c7b0: 6976 656d 6170 2c20 204e 6578 743a 2065 ivemap, Next: e │ │ │ │ │ +0002c7c0: 6368 6f2c 2020 5072 6576 3a20 6469 7374 cho, Prev: dist │ │ │ │ │ +0002c7d0: 7275 7374 2c20 2055 703a 2043 6f6d 6d61 rust, Up: Comma │ │ │ │ │ +0002c7e0: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ +0002c7f0: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ +0002c800: 0a31 362e 332e 3234 2064 7269 7665 6d61 .16.3.24 drivema │ │ │ │ │ +0002c810: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d p.-------------- │ │ │ │ │ +0002c820: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ +0002c830: 2064 7269 7665 6d61 7020 2d6c 7c2d 727c drivemap -l|-r| │ │ │ │ │ +0002c840: 5b2d 735d 2066 726f 6d5f 6472 6976 6520 [-s] from_drive │ │ │ │ │ +0002c850: 746f 5f64 7269 7665 0a20 2020 2020 5769 to_drive. Wi │ │ │ │ │ +0002c860: 7468 6f75 7420 6f70 7469 6f6e 732c 206d thout options, m │ │ │ │ │ +0002c870: 6170 2074 6865 2064 7269 7665 2046 524f ap the drive FRO │ │ │ │ │ +0002c880: 4d5f 4452 4956 4520 746f 2074 6865 2064 M_DRIVE to the d │ │ │ │ │ +0002c890: 7269 7665 2054 4f5f 4452 4956 452e 0a20 rive TO_DRIVE.. │ │ │ │ │ +0002c8a0: 2020 2020 5468 6973 2069 7320 6e65 6365 This is nece │ │ │ │ │ +0002c8b0: 7373 6172 7920 7768 656e 2079 6f75 2063 ssary when you c │ │ │ │ │ +0002c8c0: 6861 696e 2d6c 6f61 6420 736f 6d65 206f hain-load some o │ │ │ │ │ +0002c8d0: 7065 7261 7469 6e67 2073 7973 7465 6d73 perating systems │ │ │ │ │ +0002c8e0: 2c20 7375 6368 0a20 2020 2020 6173 2044 , such. as D │ │ │ │ │ +0002c8f0: 4f53 2c20 6966 2073 7563 6820 616e 204f OS, if such an O │ │ │ │ │ +0002c900: 5320 7265 7369 6465 7320 6174 2061 206e S resides at a n │ │ │ │ │ +0002c910: 6f6e 2d66 6972 7374 2064 7269 7665 2e20 on-first drive. │ │ │ │ │ +0002c920: 2046 6f72 0a20 2020 2020 636f 6e76 656e For. conven │ │ │ │ │ +0002c930: 6965 6e63 652c 2061 6e79 2070 6172 7469 ience, any parti │ │ │ │ │ +0002c940: 7469 6f6e 2073 7566 6669 7820 6f6e 2074 tion suffix on t │ │ │ │ │ +0002c950: 6865 2064 7269 7665 2069 7320 6967 6e6f he drive is igno │ │ │ │ │ +0002c960: 7265 642c 2073 6f20 796f 750a 2020 2020 red, so you. │ │ │ │ │ +0002c970: 2063 616e 2073 6166 656c 7920 7573 6520 can safely use │ │ │ │ │ +0002c980: 247b 726f 6f74 7d20 6173 2061 2064 7269 ${root} as a dri │ │ │ │ │ +0002c990: 7665 2073 7065 6369 6669 6361 7469 6f6e ve specification │ │ │ │ │ +0002c9a0: 2e0a 0a20 2020 2020 5769 7468 2074 6865 ... With the │ │ │ │ │ +0002c9b0: 2027 2d73 2720 6f70 7469 6f6e 2c20 7065 '-s' option, pe │ │ │ │ │ +0002c9c0: 7266 6f72 6d20 7468 6520 7265 7665 7273 rform the revers │ │ │ │ │ +0002c9d0: 6520 6d61 7070 696e 6720 6173 2077 656c e mapping as wel │ │ │ │ │ +0002c9e0: 6c2c 2073 7761 7070 696e 670a 2020 2020 l, swapping. │ │ │ │ │ +0002c9f0: 2074 6865 2074 776f 2064 7269 7665 732e the two drives. │ │ │ │ │ +0002ca00: 0a0a 2020 2020 2057 6974 6820 7468 6520 .. With the │ │ │ │ │ +0002ca10: 272d 6c27 206f 7074 696f 6e2c 206c 6973 '-l' option, lis │ │ │ │ │ +0002ca20: 7420 7468 6520 6375 7272 656e 7420 6d61 t the current ma │ │ │ │ │ +0002ca30: 7070 696e 6773 2e0a 0a20 2020 2020 5769 ppings... Wi │ │ │ │ │ +0002ca40: 7468 2074 6865 2027 2d72 2720 6f70 7469 th the '-r' opti │ │ │ │ │ +0002ca50: 6f6e 2c20 7265 7365 7420 616c 6c20 6d61 on, reset all ma │ │ │ │ │ +0002ca60: 7070 696e 6773 2074 6f20 7468 6520 6465 ppings to the de │ │ │ │ │ +0002ca70: 6661 756c 7420 7661 6c75 6573 2e0a 0a20 fault values... │ │ │ │ │ +0002ca80: 2020 2020 466f 7220 6578 616d 706c 653a For example: │ │ │ │ │ +0002ca90: 0a0a 2020 2020 2020 2020 2020 6472 6976 .. driv │ │ │ │ │ +0002caa0: 656d 6170 202d 7320 2868 6430 2920 2868 emap -s (hd0) (h │ │ │ │ │ +0002cab0: 6431 290a 0a1f 0a46 696c 653a 2067 7275 d1)....File: gru │ │ │ │ │ +0002cac0: 622e 696e 666f 2c20 204e 6f64 653a 2065 b.info, Node: e │ │ │ │ │ +0002cad0: 6368 6f2c 2020 4e65 7874 3a20 6576 616c cho, Next: eval │ │ │ │ │ +0002cae0: 2c20 2050 7265 763a 2064 7269 7665 6d61 , Prev: drivema │ │ │ │ │ +0002caf0: 702c 2020 5570 3a20 436f 6d6d 616e 642d p, Up: Command- │ │ │ │ │ +0002cb00: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ +0002cb10: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ +0002cb20: 2e33 2e32 3520 6563 686f 0a2d 2d2d 2d2d .3.25 echo.----- │ │ │ │ │ +0002cb30: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +0002cb40: 6d61 6e64 3a20 6563 686f 205b 2d6e 5d20 mand: echo [-n] │ │ │ │ │ +0002cb50: 5b2d 655d 2073 7472 696e 6720 2e2e 2e0a [-e] string .... │ │ │ │ │ +0002cb60: 2020 2020 2044 6973 706c 6179 2074 6865 Display the │ │ │ │ │ +0002cb70: 2072 6571 7565 7374 6564 2074 6578 7420 requested text │ │ │ │ │ +0002cb80: 616e 642c 2075 6e6c 6573 7320 7468 6520 and, unless the │ │ │ │ │ +0002cb90: 272d 6e27 206f 7074 696f 6e20 6973 2075 '-n' option is u │ │ │ │ │ +0002cba0: 7365 642c 2061 0a20 2020 2020 7472 6169 sed, a. trai │ │ │ │ │ +0002cbb0: 6c69 6e67 206e 6577 206c 696e 652e 2020 ling new line. │ │ │ │ │ +0002cbc0: 4966 2074 6865 7265 2069 7320 6d6f 7265 If there is more │ │ │ │ │ +0002cbd0: 2074 6861 6e20 6f6e 6520 7374 7269 6e67 than one string │ │ │ │ │ +0002cbe0: 2c20 7468 6579 2061 7265 0a20 2020 2020 , they are. │ │ │ │ │ +0002cbf0: 7365 7061 7261 7465 6420 6279 2073 7061 separated by spa │ │ │ │ │ +0002cc00: 6365 7320 696e 2074 6865 206f 7574 7075 ces in the outpu │ │ │ │ │ +0002cc10: 742e 2020 4173 2075 7375 616c 2069 6e20 t. As usual in │ │ │ │ │ +0002cc20: 4752 5542 2063 6f6d 6d61 6e64 732c 0a20 GRUB commands,. │ │ │ │ │ +0002cc30: 2020 2020 7661 7269 6162 6c65 7320 6d61 variables ma │ │ │ │ │ +0002cc40: 7920 6265 2073 7562 7374 6974 7574 6564 y be substituted │ │ │ │ │ +0002cc50: 2075 7369 6e67 2027 247b 7661 727d 272e using '${var}'. │ │ │ │ │ +0002cc60: 0a0a 2020 2020 2054 6865 2027 2d65 2720 .. The '-e' │ │ │ │ │ +0002cc70: 6f70 7469 6f6e 2065 6e61 626c 6573 2069 option enables i │ │ │ │ │ +0002cc80: 6e74 6572 7072 6574 6174 696f 6e20 6f66 nterpretation of │ │ │ │ │ +0002cc90: 2062 6163 6b73 6c61 7368 2065 7363 6170 backslash escap │ │ │ │ │ +0002cca0: 6573 2e20 2054 6865 0a20 2020 2020 666f es. The. fo │ │ │ │ │ +0002ccb0: 6c6c 6f77 696e 6720 7365 7175 656e 6365 llowing sequence │ │ │ │ │ +0002ccc0: 7320 6172 6520 7265 636f 676e 6973 6564 s are recognised │ │ │ │ │ +0002ccd0: 3a0a 0a20 2020 2020 275c 5c27 0a20 2020 :.. '\\'. │ │ │ │ │ +0002cce0: 2020 2020 2020 2062 6163 6b73 6c61 7368 backslash │ │ │ │ │ +0002ccf0: 0a0a 2020 2020 2027 5c61 270a 2020 2020 .. '\a'. │ │ │ │ │ +0002cd00: 2020 2020 2020 616c 6572 7420 2842 454c alert (BEL │ │ │ │ │ +0002cd10: 290a 0a20 2020 2020 275c 6327 0a20 2020 ).. '\c'. │ │ │ │ │ +0002cd20: 2020 2020 2020 2073 7570 7072 6573 7320 suppress │ │ │ │ │ +0002cd30: 7472 6169 6c69 6e67 206e 6577 206c 696e trailing new lin │ │ │ │ │ +0002cd40: 650a 0a20 2020 2020 275c 6627 0a20 2020 e.. '\f'. │ │ │ │ │ +0002cd50: 2020 2020 2020 2066 6f72 6d20 6665 6564 form feed │ │ │ │ │ +0002cd60: 0a0a 2020 2020 2027 5c6e 270a 2020 2020 .. '\n'. │ │ │ │ │ +0002cd70: 2020 2020 2020 6e65 7720 6c69 6e65 0a0a new line.. │ │ │ │ │ +0002cd80: 2020 2020 2027 5c72 270a 2020 2020 2020 '\r'. │ │ │ │ │ +0002cd90: 2020 2020 6361 7272 6961 6765 2072 6574 carriage ret │ │ │ │ │ +0002cda0: 7572 6e0a 0a20 2020 2020 275c 7427 0a20 urn.. '\t'. │ │ │ │ │ +0002cdb0: 2020 2020 2020 2020 2068 6f72 697a 6f6e horizon │ │ │ │ │ +0002cdc0: 7461 6c20 7461 620a 0a20 2020 2020 275c tal tab.. '\ │ │ │ │ │ +0002cdd0: 7627 0a20 2020 2020 2020 2020 2076 6572 v'. ver │ │ │ │ │ +0002cde0: 7469 6361 6c20 7461 620a 0a20 2020 2020 tical tab.. │ │ │ │ │ +0002cdf0: 5768 656e 2069 6e74 6572 7072 6574 696e When interpretin │ │ │ │ │ +0002ce00: 6720 6261 636b 736c 6173 6820 6573 6361 g backslash esca │ │ │ │ │ +0002ce10: 7065 732c 2062 6163 6b73 6c61 7368 2066 pes, backslash f │ │ │ │ │ +0002ce20: 6f6c 6c6f 7765 6420 6279 2061 6e79 0a20 ollowed by any. │ │ │ │ │ +0002ce30: 2020 2020 6f74 6865 7220 6368 6172 6163 other charac │ │ │ │ │ +0002ce40: 7465 7220 7769 6c6c 2070 7269 6e74 2074 ter will print t │ │ │ │ │ +0002ce50: 6861 7420 6368 6172 6163 7465 722e 0a0a hat character... │ │ │ │ │ +0002ce60: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +0002ce70: 6f2c 2020 4e6f 6465 3a20 6576 616c 2c20 o, Node: eval, │ │ │ │ │ +0002ce80: 204e 6578 743a 2065 7870 6f72 742c 2020 Next: export, │ │ │ │ │ +0002ce90: 5072 6576 3a20 6563 686f 2c20 2055 703a Prev: echo, Up: │ │ │ │ │ +0002cea0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +0002ceb0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +0002cec0: 6d61 6e64 730a 0a31 362e 332e 3236 2065 mands..16.3.26 e │ │ │ │ │ +0002ced0: 7661 6c0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d val.------------ │ │ │ │ │ +0002cee0: 0a0a 202d 2d20 436f 6d6d 616e 643a 2065 .. -- Command: e │ │ │ │ │ +0002cef0: 7661 6c20 7374 7269 6e67 202e 2e2e 0a20 val string .... │ │ │ │ │ +0002cf00: 2020 2020 436f 6e63 6174 656e 6174 6520 Concatenate │ │ │ │ │ +0002cf10: 6172 6775 6d65 6e74 7320 746f 6765 7468 arguments togeth │ │ │ │ │ +0002cf20: 6572 2075 7369 6e67 2073 696e 676c 6520 er using single │ │ │ │ │ +0002cf30: 7370 6163 6520 6173 2073 6570 6172 6174 space as separat │ │ │ │ │ +0002cf40: 6f72 2061 6e64 0a20 2020 2020 6576 616c or and. eval │ │ │ │ │ +0002cf50: 7561 7465 2072 6573 756c 7420 6173 2073 uate result as s │ │ │ │ │ +0002cf60: 6571 7565 6e63 6520 6f66 2047 5255 4220 equence of GRUB │ │ │ │ │ +0002cf70: 636f 6d6d 616e 6473 2e0a 0a1f 0a46 696c commands.....Fil │ │ │ │ │ +0002cf80: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +0002cf90: 6f64 653a 2065 7870 6f72 742c 2020 4e65 ode: export, Ne │ │ │ │ │ +0002cfa0: 7874 3a20 6661 6c73 652c 2020 5072 6576 xt: false, Prev │ │ │ │ │ +0002cfb0: 3a20 6576 616c 2c20 2055 703a 2043 6f6d : eval, Up: Com │ │ │ │ │ +0002cfc0: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ +0002cfd0: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ +0002cfe0: 730a 0a31 362e 332e 3237 2065 7870 6f72 s..16.3.27 expor │ │ │ │ │ +0002cff0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d t.-------------- │ │ │ │ │ +0002d000: 0a0a 202d 2d20 436f 6d6d 616e 643a 2065 .. -- Command: e │ │ │ │ │ +0002d010: 7870 6f72 7420 656e 7676 6172 0a20 2020 xport envvar. │ │ │ │ │ +0002d020: 2020 4578 706f 7274 2074 6865 2065 6e76 Export the env │ │ │ │ │ +0002d030: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +0002d040: 6520 454e 5656 4152 2e20 2045 7870 6f72 e ENVVAR. Expor │ │ │ │ │ +0002d050: 7465 6420 7661 7269 6162 6c65 7320 6172 ted variables ar │ │ │ │ │ +0002d060: 650a 2020 2020 2076 6973 6962 6c65 2074 e. visible t │ │ │ │ │ +0002d070: 6f20 7375 6273 6964 6961 7279 2063 6f6e o subsidiary con │ │ │ │ │ +0002d080: 6669 6775 7261 7469 6f6e 2066 696c 6573 figuration files │ │ │ │ │ +0002d090: 206c 6f61 6465 6420 7573 696e 670a 2020 loaded using. │ │ │ │ │ +0002d0a0: 2020 2027 636f 6e66 6967 6669 6c65 272e 'configfile'. │ │ │ │ │ +0002d0b0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0002d0c0: 6e66 6f2c 2020 4e6f 6465 3a20 6661 6c73 nfo, Node: fals │ │ │ │ │ +0002d0d0: 652c 2020 4e65 7874 3a20 6765 7474 6578 e, Next: gettex │ │ │ │ │ +0002d0e0: 742c 2020 5072 6576 3a20 6578 706f 7274 t, Prev: export │ │ │ │ │ +0002d0f0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ +0002d100: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ +0002d110: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ +0002d120: 332e 3238 2066 616c 7365 0a2d 2d2d 2d2d 3.28 false.----- │ │ │ │ │ +0002d130: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +0002d140: 6d6d 616e 643a 2066 616c 7365 0a20 2020 mmand: false. │ │ │ │ │ +0002d150: 2020 446f 206e 6f74 6869 6e67 2c20 756e Do nothing, un │ │ │ │ │ +0002d160: 7375 6363 6573 7366 756c 6c79 2e20 2054 successfully. T │ │ │ │ │ +0002d170: 6869 7320 6973 206d 6169 6e6c 7920 7573 his is mainly us │ │ │ │ │ +0002d180: 6566 756c 2069 6e20 636f 6e74 726f 6c0a eful in control. │ │ │ │ │ +0002d190: 2020 2020 2063 6f6e 7374 7275 6374 7320 constructs │ │ │ │ │ +0002d1a0: 7375 6368 2061 7320 2769 6627 2061 6e64 such as 'if' and │ │ │ │ │ +0002d1b0: 2027 7768 696c 6527 2028 2a6e 6f74 6520 'while' (*note │ │ │ │ │ +0002d1c0: 5368 656c 6c2d 6c69 6b65 2073 6372 6970 Shell-like scrip │ │ │ │ │ +0002d1d0: 7469 6e67 3a3a 292e 0a0a 1f0a 4669 6c65 ting::).....File │ │ │ │ │ +0002d1e0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0002d1f0: 6465 3a20 6765 7474 6578 742c 2020 4e65 de: gettext, Ne │ │ │ │ │ +0002d200: 7874 3a20 6770 7473 796e 632c 2020 5072 xt: gptsync, Pr │ │ │ │ │ +0002d210: 6576 3a20 6661 6c73 652c 2020 5570 3a20 ev: false, Up: │ │ │ │ │ +0002d220: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +0002d230: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +0002d240: 616e 6473 0a0a 3136 2e33 2e32 3920 6765 ands..16.3.29 ge │ │ │ │ │ +0002d250: 7474 6578 740a 2d2d 2d2d 2d2d 2d2d 2d2d ttext.---------- │ │ │ │ │ +0002d260: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +0002d270: 6e64 3a20 6765 7474 6578 7420 7374 7269 nd: gettext stri │ │ │ │ │ +0002d280: 6e67 0a20 2020 2020 5472 616e 736c 6174 ng. Translat │ │ │ │ │ +0002d290: 6520 5354 5249 4e47 2069 6e74 6f20 7468 e STRING into th │ │ │ │ │ +0002d2a0: 6520 6375 7272 656e 7420 6c61 6e67 7561 e current langua │ │ │ │ │ +0002d2b0: 6765 2e0a 0a20 2020 2020 5468 6520 6375 ge... The cu │ │ │ │ │ +0002d2c0: 7272 656e 7420 6c61 6e67 7561 6765 2063 rrent language c │ │ │ │ │ +0002d2d0: 6f64 6520 6973 2073 746f 7265 6420 696e ode is stored in │ │ │ │ │ +0002d2e0: 2074 6865 2027 6c61 6e67 2720 7661 7269 the 'lang' vari │ │ │ │ │ +0002d2f0: 6162 6c65 2069 6e0a 2020 2020 2047 5255 able in. GRU │ │ │ │ │ +0002d300: 4227 7320 656e 7669 726f 6e6d 656e 7420 B's environment │ │ │ │ │ +0002d310: 282a 6e6f 7465 206c 616e 673a 3a29 2e20 (*note lang::). │ │ │ │ │ +0002d320: 2054 7261 6e73 6c61 7469 6f6e 2066 696c Translation fil │ │ │ │ │ +0002d330: 6573 2069 6e20 4d4f 2066 6f72 6d61 740a es in MO format. │ │ │ │ │ +0002d340: 2020 2020 2061 7265 2072 6561 6420 6672 are read fr │ │ │ │ │ +0002d350: 6f6d 2027 6c6f 6361 6c65 5f64 6972 2720 om 'locale_dir' │ │ │ │ │ +0002d360: 282a 6e6f 7465 206c 6f63 616c 655f 6469 (*note locale_di │ │ │ │ │ +0002d370: 723a 3a29 2c20 7573 7561 6c6c 790a 2020 r::), usually. │ │ │ │ │ +0002d380: 2020 2027 2f62 6f6f 742f 6772 7562 2f6c '/boot/grub/l │ │ │ │ │ +0002d390: 6f63 616c 6527 2e0a 0a1f 0a46 696c 653a ocale'.....File: │ │ │ │ │ +0002d3a0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002d3b0: 653a 2067 7074 7379 6e63 2c20 204e 6578 e: gptsync, Nex │ │ │ │ │ +0002d3c0: 743a 2068 616c 742c 2020 5072 6576 3a20 t: halt, Prev: │ │ │ │ │ +0002d3d0: 6765 7474 6578 742c 2020 5570 3a20 436f gettext, Up: Co │ │ │ │ │ +0002d3e0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +0002d3f0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +0002d400: 6473 0a0a 3136 2e33 2e33 3020 6770 7473 ds..16.3.30 gpts │ │ │ │ │ +0002d410: 796e 630a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ync.------------ │ │ │ │ │ +0002d420: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ +0002d430: 3a20 6770 7473 796e 6320 6465 7669 6365 : gptsync device │ │ │ │ │ +0002d440: 205b 7061 7274 6974 696f 6e5b 2b2f 2d5b [partition[+/-[ │ │ │ │ │ +0002d450: 7479 7065 5d5d 5d20 2e2e 2e0a 2020 2020 type]]] .... │ │ │ │ │ +0002d460: 2044 6973 6b73 2075 7369 6e67 2074 6865 Disks using the │ │ │ │ │ +0002d470: 2047 5549 4420 5061 7274 6974 696f 6e20 GUID Partition │ │ │ │ │ +0002d480: 5461 626c 6520 2847 5054 2920 616c 736f Table (GPT) also │ │ │ │ │ +0002d490: 2068 6176 6520 6120 6c65 6761 6379 0a20 have a legacy. │ │ │ │ │ +0002d4a0: 2020 2020 4d61 7374 6572 2042 6f6f 7420 Master Boot │ │ │ │ │ +0002d4b0: 5265 636f 7264 2028 4d42 5229 2070 6172 Record (MBR) par │ │ │ │ │ +0002d4c0: 7469 7469 6f6e 2074 6162 6c65 2066 6f72 tition table for │ │ │ │ │ +0002d4d0: 2063 6f6d 7061 7469 6269 6c69 7479 2077 compatibility w │ │ │ │ │ +0002d4e0: 6974 6820 7468 650a 2020 2020 2042 494f ith the. BIO │ │ │ │ │ +0002d4f0: 5320 616e 6420 7769 7468 206f 6c64 6572 S and with older │ │ │ │ │ +0002d500: 206f 7065 7261 7469 6e67 2073 7973 7465 operating syste │ │ │ │ │ +0002d510: 6d73 2e20 2054 6865 206c 6567 6163 7920 ms. The legacy │ │ │ │ │ +0002d520: 4d42 5220 6361 6e20 6f6e 6c79 0a20 2020 MBR can only. │ │ │ │ │ +0002d530: 2020 7265 7072 6573 656e 7420 6120 6c69 represent a li │ │ │ │ │ +0002d540: 6d69 7465 6420 7375 6273 6574 206f 6620 mited subset of │ │ │ │ │ +0002d550: 4750 5420 7061 7274 6974 696f 6e20 656e GPT partition en │ │ │ │ │ +0002d560: 7472 6965 732e 0a0a 2020 2020 2054 6869 tries... Thi │ │ │ │ │ +0002d570: 7320 636f 6d6d 616e 6420 706f 7075 6c61 s command popula │ │ │ │ │ +0002d580: 7465 7320 7468 6520 6c65 6761 6379 204d tes the legacy M │ │ │ │ │ +0002d590: 4252 2077 6974 6820 7468 6520 7370 6563 BR with the spec │ │ │ │ │ +0002d5a0: 6966 6965 6420 5041 5254 4954 494f 4e0a ified PARTITION. │ │ │ │ │ +0002d5b0: 2020 2020 2065 6e74 7269 6573 206f 6e20 entries on │ │ │ │ │ +0002d5c0: 4445 5649 4345 2e20 2055 7020 746f 2074 DEVICE. Up to t │ │ │ │ │ +0002d5d0: 6872 6565 2070 6172 7469 7469 6f6e 7320 hree partitions │ │ │ │ │ +0002d5e0: 6d61 7920 6265 2075 7365 642e 0a0a 2020 may be used... │ │ │ │ │ +0002d5f0: 2020 2054 5950 4520 6973 2061 6e20 4d42 TYPE is an MB │ │ │ │ │ +0002d600: 5220 7061 7274 6974 696f 6e20 7479 7065 R partition type │ │ │ │ │ +0002d610: 2063 6f64 653b 2070 7265 6669 7820 7769 code; prefix wi │ │ │ │ │ +0002d620: 7468 2027 3078 2720 6966 2079 6f75 2077 th '0x' if you w │ │ │ │ │ +0002d630: 616e 7420 746f 0a20 2020 2020 656e 7465 ant to. ente │ │ │ │ │ +0002d640: 7220 7468 6973 2069 6e20 6865 7861 6465 r this in hexade │ │ │ │ │ +0002d650: 6369 6d61 6c2e 2020 5468 6520 7365 7061 cimal. The sepa │ │ │ │ │ +0002d660: 7261 746f 7220 6265 7477 6565 6e20 5041 rator between PA │ │ │ │ │ +0002d670: 5254 4954 494f 4e20 616e 640a 2020 2020 RTITION and. │ │ │ │ │ +0002d680: 2054 5950 4520 6d61 7920 6265 2027 2b27 TYPE may be '+' │ │ │ │ │ +0002d690: 2074 6f20 6d61 6b65 2074 6865 2070 6172 to make the par │ │ │ │ │ +0002d6a0: 7469 7469 6f6e 2061 6374 6976 652c 206f tition active, o │ │ │ │ │ +0002d6b0: 7220 272d 2720 746f 206d 616b 6520 6974 r '-' to make it │ │ │ │ │ +0002d6c0: 0a20 2020 2020 696e 6163 7469 7665 3b20 . inactive; │ │ │ │ │ +0002d6d0: 6f6e 6c79 206f 6e65 2070 6172 7469 7469 only one partiti │ │ │ │ │ +0002d6e0: 6f6e 206d 6179 2062 6520 6163 7469 7665 on may be active │ │ │ │ │ +0002d6f0: 2e20 2049 6620 626f 7468 2074 6865 2073 . If both the s │ │ │ │ │ +0002d700: 6570 6172 6174 6f72 0a20 2020 2020 616e eparator. an │ │ │ │ │ +0002d710: 6420 7479 7065 2061 7265 206f 6d69 7474 d type are omitt │ │ │ │ │ +0002d720: 6564 2c20 7468 656e 2074 6865 2070 6172 ed, then the par │ │ │ │ │ +0002d730: 7469 7469 6f6e 2077 696c 6c20 6265 2069 tition will be i │ │ │ │ │ +0002d740: 6e61 6374 6976 652e 0a0a 1f0a 4669 6c65 nactive.....File │ │ │ │ │ +0002d750: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0002d760: 6465 3a20 6861 6c74 2c20 204e 6578 743a de: halt, Next: │ │ │ │ │ +0002d770: 2068 6173 6873 756d 2c20 2050 7265 763a hashsum, Prev: │ │ │ │ │ +0002d780: 2067 7074 7379 6e63 2c20 2055 703a 2043 gptsync, Up: C │ │ │ │ │ +0002d790: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +0002d7a0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +0002d7b0: 6e64 730a 0a31 362e 332e 3331 2068 616c nds..16.3.31 hal │ │ │ │ │ +0002d7c0: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a t.------------.. │ │ │ │ │ +0002d7d0: 202d 2d20 436f 6d6d 616e 643a 2068 616c -- Command: hal │ │ │ │ │ +0002d7e0: 7420 2d2d 6e6f 2d61 706d 0a20 2020 2020 t --no-apm. │ │ │ │ │ +0002d7f0: 5468 6520 636f 6d6d 616e 6420 6861 6c74 The command halt │ │ │ │ │ +0002d800: 7320 7468 6520 636f 6d70 7574 6572 2e20 s the computer. │ │ │ │ │ +0002d810: 2049 6620 7468 6520 272d 2d6e 6f2d 6170 If the '--no-ap │ │ │ │ │ +0002d820: 6d27 206f 7074 696f 6e20 6973 0a20 2020 m' option is. │ │ │ │ │ +0002d830: 2020 7370 6563 6966 6965 642c 206e 6f20 specified, no │ │ │ │ │ +0002d840: 4150 4d20 4249 4f53 2063 616c 6c20 6973 APM BIOS call is │ │ │ │ │ +0002d850: 2070 6572 666f 726d 6564 2e20 204f 7468 performed. Oth │ │ │ │ │ +0002d860: 6572 7769 7365 2c20 7468 6520 636f 6d70 erwise, the comp │ │ │ │ │ +0002d870: 7574 6572 0a20 2020 2020 6973 2073 6875 uter. is shu │ │ │ │ │ +0002d880: 7420 646f 776e 2075 7369 6e67 2041 504d t down using APM │ │ │ │ │ +0002d890: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +0002d8a0: 696e 666f 2c20 204e 6f64 653a 2068 6173 info, Node: has │ │ │ │ │ +0002d8b0: 6873 756d 2c20 204e 6578 743a 2068 656c hsum, Next: hel │ │ │ │ │ +0002d8c0: 702c 2020 5072 6576 3a20 6861 6c74 2c20 p, Prev: halt, │ │ │ │ │ +0002d8d0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +0002d8e0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +0002d8f0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +0002d900: 3332 2068 6173 6873 756d 0a2d 2d2d 2d2d 32 hashsum.----- │ │ │ │ │ +0002d910: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ +0002d920: 436f 6d6d 616e 643a 2068 6173 6873 756d Command: hashsum │ │ │ │ │ +0002d930: 202d 2d68 6173 6820 6861 7368 202d 2d6b --hash hash --k │ │ │ │ │ +0002d940: 6565 702d 676f 696e 6720 2d2d 756e 636f eep-going --unco │ │ │ │ │ +0002d950: 6d70 7265 7373 202d 2d63 6865 636b 2066 mpress --check f │ │ │ │ │ +0002d960: 696c 650a 2020 2020 2020 2020 2020 5b2d ile. [- │ │ │ │ │ +0002d970: 2d70 7265 6669 7820 6469 725d 7c66 696c -prefix dir]|fil │ │ │ │ │ +0002d980: 6520 2e2e 2e0a 2020 2020 2043 6f6d 7075 e .... Compu │ │ │ │ │ +0002d990: 7465 206f 7220 7665 7269 6679 2066 696c te or verify fil │ │ │ │ │ +0002d9a0: 6520 6861 7368 6573 2e20 2048 6173 6820 e hashes. Hash │ │ │ │ │ +0002d9b0: 7479 7065 2069 7320 7365 6c65 6374 6564 type is selected │ │ │ │ │ +0002d9c0: 2077 6974 6820 6f70 7469 6f6e 0a20 2020 with option. │ │ │ │ │ +0002d9d0: 2020 272d 2d68 6173 6827 2e20 2053 7570 '--hash'. Sup │ │ │ │ │ +0002d9e0: 706f 7274 6564 2068 6173 6865 7320 6172 ported hashes ar │ │ │ │ │ +0002d9f0: 653a 2027 6164 6c65 7233 3227 2c20 2763 e: 'adler32', 'c │ │ │ │ │ +0002da00: 7263 3634 272c 2027 6372 6333 3227 2c0a rc64', 'crc32',. │ │ │ │ │ +0002da10: 2020 2020 2027 6372 6333 3272 6663 3135 'crc32rfc15 │ │ │ │ │ +0002da20: 3130 272c 2027 6372 6332 3472 6663 3234 10', 'crc24rfc24 │ │ │ │ │ +0002da30: 3430 272c 2027 6d64 3427 2c20 276d 6435 40', 'md4', 'md5 │ │ │ │ │ +0002da40: 272c 2027 7269 7065 6d64 3136 3027 2c20 ', 'ripemd160', │ │ │ │ │ +0002da50: 2773 6861 3127 2c0a 2020 2020 2027 7368 'sha1',. 'sh │ │ │ │ │ +0002da60: 6132 3234 272c 2027 7368 6132 3536 272c a224', 'sha256', │ │ │ │ │ +0002da70: 2027 7368 6135 3132 272c 2027 7368 6133 'sha512', 'sha3 │ │ │ │ │ +0002da80: 3834 272c 2027 7469 6765 7231 3932 272c 84', 'tiger192', │ │ │ │ │ +0002da90: 2027 7469 6765 7227 2c0a 2020 2020 2027 'tiger',. ' │ │ │ │ │ +0002daa0: 7469 6765 7232 272c 2027 7768 6972 6c70 tiger2', 'whirlp │ │ │ │ │ +0002dab0: 6f6f 6c27 2e20 204f 7074 696f 6e20 272d ool'. Option '- │ │ │ │ │ +0002dac0: 2d75 6e63 6f6d 7072 6573 7327 2075 6e63 -uncompress' unc │ │ │ │ │ +0002dad0: 6f6d 7072 6573 7365 7320 6669 6c65 730a ompresses files. │ │ │ │ │ +0002dae0: 2020 2020 2062 6566 6f72 6520 636f 6d70 before comp │ │ │ │ │ +0002daf0: 7574 696e 6720 6861 7368 2e0a 0a20 2020 uting hash... │ │ │ │ │ +0002db00: 2020 5768 656e 206c 6973 7420 6f66 2066 When list of f │ │ │ │ │ +0002db10: 696c 6573 2069 7320 6769 7665 6e2c 2068 iles is given, h │ │ │ │ │ +0002db20: 6173 6820 6f66 2065 6163 6820 6669 6c65 ash of each file │ │ │ │ │ +0002db30: 2069 7320 636f 6d70 7574 6564 2061 6e64 is computed and │ │ │ │ │ +0002db40: 0a20 2020 2020 7072 696e 7465 642c 2066 . printed, f │ │ │ │ │ +0002db50: 6f6c 6c6f 7765 6420 6279 2066 696c 6520 ollowed by file │ │ │ │ │ +0002db60: 6e61 6d65 2c20 6561 6368 2066 696c 6520 name, each file │ │ │ │ │ +0002db70: 6f6e 2061 206e 6577 206c 696e 652e 0a0a on a new line... │ │ │ │ │ +0002db80: 2020 2020 2057 6865 6e20 6f70 7469 6f6e When option │ │ │ │ │ +0002db90: 2027 2d2d 6368 6563 6b27 2069 7320 6769 '--check' is gi │ │ │ │ │ +0002dba0: 7665 6e2c 2069 7420 706f 696e 7473 2074 ven, it points t │ │ │ │ │ +0002dbb0: 6f20 6120 6669 6c65 2074 6861 7420 636f o a file that co │ │ │ │ │ +0002dbc0: 6e74 6169 6e73 0a20 2020 2020 6c69 7374 ntains. list │ │ │ │ │ +0002dbd0: 206f 6620 4841 5348 204e 414d 4520 7061 of HASH NAME pa │ │ │ │ │ +0002dbe0: 6972 7320 696e 2074 6865 2073 616d 6520 irs in the same │ │ │ │ │ +0002dbf0: 666f 726d 6174 2061 7320 7573 6564 2062 format as used b │ │ │ │ │ +0002dc00: 7920 554e 4958 2027 6d64 3573 756d 270a y UNIX 'md5sum'. │ │ │ │ │ +0002dc10: 2020 2020 2063 6f6d 6d61 6e64 2e20 204f command. O │ │ │ │ │ +0002dc20: 7074 696f 6e20 272d 2d70 7265 6669 7827 ption '--prefix' │ │ │ │ │ +0002dc30: 206d 6179 2062 6520 7573 6564 2074 6f20 may be used to │ │ │ │ │ +0002dc40: 6769 7665 2064 6972 6563 746f 7279 2077 give directory w │ │ │ │ │ +0002dc50: 6865 7265 0a20 2020 2020 6669 6c65 7320 here. files │ │ │ │ │ +0002dc60: 6172 6520 6c6f 6361 7465 642e 2020 4861 are located. Ha │ │ │ │ │ +0002dc70: 7368 2076 6572 6966 6963 6174 696f 6e20 sh verification │ │ │ │ │ +0002dc80: 7374 6f70 7320 6166 7465 7220 7468 6520 stops after the │ │ │ │ │ +0002dc90: 6669 7273 740a 2020 2020 206d 6973 6d61 first. misma │ │ │ │ │ +0002dca0: 7463 6820 7761 7320 666f 756e 6420 756e tch was found un │ │ │ │ │ +0002dcb0: 6c65 7373 206f 7074 696f 6e20 272d 2d6b less option '--k │ │ │ │ │ +0002dcc0: 6565 702d 676f 696e 6727 2077 6173 2067 eep-going' was g │ │ │ │ │ +0002dcd0: 6976 656e 2e20 2054 6865 0a20 2020 2020 iven. The. │ │ │ │ │ +0002dce0: 6578 6974 2063 6f64 6520 2724 3f27 2069 exit code '$?' i │ │ │ │ │ +0002dcf0: 7320 7365 7420 746f 2030 2069 6620 6861 s set to 0 if ha │ │ │ │ │ +0002dd00: 7368 2076 6572 6966 6963 6174 696f 6e20 sh verification │ │ │ │ │ +0002dd10: 6973 2073 7563 6365 7373 6675 6c2e 2020 is successful. │ │ │ │ │ +0002dd20: 4966 0a20 2020 2020 6974 2066 6169 6c73 If. it fails │ │ │ │ │ +0002dd30: 2c20 2724 3f27 2069 7320 7365 7420 746f , '$?' is set to │ │ │ │ │ +0002dd40: 2061 206e 6f6e 7a65 726f 2076 616c 7565 a nonzero value │ │ │ │ │ +0002dd50: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +0002dd60: 696e 666f 2c20 204e 6f64 653a 2068 656c info, Node: hel │ │ │ │ │ +0002dd70: 702c 2020 4e65 7874 3a20 696e 6974 7264 p, Next: initrd │ │ │ │ │ +0002dd80: 2c20 2050 7265 763a 2068 6173 6873 756d , Prev: hashsum │ │ │ │ │ +0002dd90: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ +0002dda0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ +0002ddb0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ +0002ddc0: 332e 3333 2068 656c 700a 2d2d 2d2d 2d2d 3.33 help.------ │ │ │ │ │ +0002ddd0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +0002dde0: 616e 643a 2068 656c 7020 5b70 6174 7465 and: help [patte │ │ │ │ │ +0002ddf0: 726e 202e 2e2e 5d0a 2020 2020 2044 6973 rn ...]. Dis │ │ │ │ │ +0002de00: 706c 6179 2068 656c 7066 756c 2069 6e66 play helpful inf │ │ │ │ │ +0002de10: 6f72 6d61 7469 6f6e 2061 626f 7574 2062 ormation about b │ │ │ │ │ +0002de20: 7569 6c74 696e 2063 6f6d 6d61 6e64 732e uiltin commands. │ │ │ │ │ +0002de30: 2020 4966 2079 6f75 2064 6f20 6e6f 740a If you do not. │ │ │ │ │ +0002de40: 2020 2020 2073 7065 6369 6679 2050 4154 specify PAT │ │ │ │ │ +0002de50: 5445 524e 2c20 7468 6973 2063 6f6d 6d61 TERN, this comma │ │ │ │ │ +0002de60: 6e64 2073 686f 7773 2073 686f 7274 2064 nd shows short d │ │ │ │ │ +0002de70: 6573 6372 6970 7469 6f6e 7320 6f66 2061 escriptions of a │ │ │ │ │ +0002de80: 6c6c 0a20 2020 2020 6176 6169 6c61 626c ll. availabl │ │ │ │ │ +0002de90: 6520 636f 6d6d 616e 6473 2e0a 0a20 2020 e commands... │ │ │ │ │ +0002dea0: 2020 4966 2079 6f75 2073 7065 6369 6679 If you specify │ │ │ │ │ +0002deb0: 2061 6e79 2050 4154 5445 524e 532c 2069 any PATTERNS, i │ │ │ │ │ +0002dec0: 7420 6469 7370 6c61 7973 206c 6f6e 6765 t displays longe │ │ │ │ │ +0002ded0: 7220 696e 666f 726d 6174 696f 6e20 6162 r information ab │ │ │ │ │ +0002dee0: 6f75 740a 2020 2020 2065 6163 6820 6f66 out. each of │ │ │ │ │ +0002def0: 2074 6865 2063 6f6d 6d61 6e64 7320 7768 the commands wh │ │ │ │ │ +0002df00: 6f73 6520 6e61 6d65 7320 6265 6769 6e20 ose names begin │ │ │ │ │ +0002df10: 7769 7468 2074 686f 7365 2050 4154 5445 with those PATTE │ │ │ │ │ +0002df20: 524e 532e 0a0a 1f0a 4669 6c65 3a20 6772 RNS.....File: gr │ │ │ │ │ +0002df30: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +0002df40: 696e 6974 7264 2c20 204e 6578 743a 2069 initrd, Next: i │ │ │ │ │ +0002df50: 6e69 7472 6431 362c 2020 5072 6576 3a20 nitrd16, Prev: │ │ │ │ │ +0002df60: 6865 6c70 2c20 2055 703a 2043 6f6d 6d61 help, Up: Comma │ │ │ │ │ +0002df70: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ +0002df80: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ +0002df90: 0a31 362e 332e 3334 2069 6e69 7472 640a .16.3.34 initrd. │ │ │ │ │ +0002dfa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0002dfb0: 202d 2d20 436f 6d6d 616e 643a 2069 6e69 -- Command: ini │ │ │ │ │ +0002dfc0: 7472 6420 6669 6c65 205b 6669 6c65 202e trd file [file . │ │ │ │ │ +0002dfd0: 2e2e 5d0a 2020 2020 204c 6f61 642c 2069 ..]. Load, i │ │ │ │ │ +0002dfe0: 6e20 6f72 6465 722c 2061 6c6c 2069 6e69 n order, all ini │ │ │ │ │ +0002dff0: 7469 616c 2072 616d 6469 736b 7320 666f tial ramdisks fo │ │ │ │ │ +0002e000: 7220 6120 4c69 6e75 7820 6b65 726e 656c r a Linux kernel │ │ │ │ │ +0002e010: 2069 6d61 6765 2c20 616e 640a 2020 2020 image, and. │ │ │ │ │ +0002e020: 2073 6574 2074 6865 2061 7070 726f 7072 set the appropr │ │ │ │ │ +0002e030: 6961 7465 2070 6172 616d 6574 6572 7320 iate parameters │ │ │ │ │ +0002e040: 696e 2074 6865 204c 696e 7578 2073 6574 in the Linux set │ │ │ │ │ +0002e050: 7570 2061 7265 6120 696e 206d 656d 6f72 up area in memor │ │ │ │ │ +0002e060: 792e 0a20 2020 2020 5468 6973 206d 6179 y.. This may │ │ │ │ │ +0002e070: 206f 6e6c 7920 6265 2075 7365 6420 6166 only be used af │ │ │ │ │ +0002e080: 7465 7220 7468 6520 276c 696e 7578 2720 ter the 'linux' │ │ │ │ │ +0002e090: 636f 6d6d 616e 6420 282a 6e6f 7465 206c command (*note l │ │ │ │ │ +0002e0a0: 696e 7578 3a3a 2920 6861 730a 2020 2020 inux::) has. │ │ │ │ │ +0002e0b0: 2062 6565 6e20 7275 6e2e 2020 5365 6520 been run. See │ │ │ │ │ +0002e0c0: 616c 736f 202a 6e6f 7465 2047 4e55 2f4c also *note GNU/L │ │ │ │ │ +0002e0d0: 696e 7578 3a3a 2e0a 0a1f 0a46 696c 653a inux::.....File: │ │ │ │ │ +0002e0e0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002e0f0: 653a 2069 6e69 7472 6431 362c 2020 4e65 e: initrd16, Ne │ │ │ │ │ +0002e100: 7874 3a20 696e 736d 6f64 2c20 2050 7265 xt: insmod, Pre │ │ │ │ │ +0002e110: 763a 2069 6e69 7472 642c 2020 5570 3a20 v: initrd, Up: │ │ │ │ │ +0002e120: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +0002e130: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +0002e140: 616e 6473 0a0a 3136 2e33 2e33 3520 696e ands..16.3.35 in │ │ │ │ │ +0002e150: 6974 7264 3136 0a2d 2d2d 2d2d 2d2d 2d2d itrd16.--------- │ │ │ │ │ +0002e160: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +0002e170: 6d61 6e64 3a20 696e 6974 7264 3136 2066 mand: initrd16 f │ │ │ │ │ +0002e180: 696c 6520 5b66 696c 6520 2e2e 2e5d 0a20 ile [file ...]. │ │ │ │ │ +0002e190: 2020 2020 4c6f 6164 2c20 696e 206f 7264 Load, in ord │ │ │ │ │ +0002e1a0: 6572 2c20 616c 6c20 696e 6974 6961 6c20 er, all initial │ │ │ │ │ +0002e1b0: 7261 6d64 6973 6b73 2066 6f72 2061 204c ramdisks for a L │ │ │ │ │ +0002e1c0: 696e 7578 206b 6572 6e65 6c20 696d 6167 inux kernel imag │ │ │ │ │ +0002e1d0: 6520 746f 2062 650a 2020 2020 2062 6f6f e to be. boo │ │ │ │ │ +0002e1e0: 7465 6420 696e 2031 362d 6269 7420 6d6f ted in 16-bit mo │ │ │ │ │ +0002e1f0: 6465 2c20 616e 6420 7365 7420 7468 6520 de, and set the │ │ │ │ │ +0002e200: 6170 7072 6f70 7269 6174 6520 7061 7261 appropriate para │ │ │ │ │ +0002e210: 6d65 7465 7273 2069 6e20 7468 650a 2020 meters in the. │ │ │ │ │ +0002e220: 2020 204c 696e 7578 2073 6574 7570 2061 Linux setup a │ │ │ │ │ +0002e230: 7265 6120 696e 206d 656d 6f72 792e 2020 rea in memory. │ │ │ │ │ +0002e240: 5468 6973 206d 6179 206f 6e6c 7920 6265 This may only be │ │ │ │ │ +0002e250: 2075 7365 6420 6166 7465 7220 7468 650a used after the. │ │ │ │ │ +0002e260: 2020 2020 2027 6c69 6e75 7831 3627 2063 'linux16' c │ │ │ │ │ +0002e270: 6f6d 6d61 6e64 2028 2a6e 6f74 6520 6c69 ommand (*note li │ │ │ │ │ +0002e280: 6e75 7831 363a 3a29 2068 6173 2062 6565 nux16::) has bee │ │ │ │ │ +0002e290: 6e20 7275 6e2e 2020 5365 6520 616c 736f n run. See also │ │ │ │ │ +0002e2a0: 202a 6e6f 7465 0a20 2020 2020 474e 552f *note. GNU/ │ │ │ │ │ +0002e2b0: 4c69 6e75 783a 3a2e 0a0a 2020 2020 2054 Linux::... T │ │ │ │ │ +0002e2c0: 6869 7320 636f 6d6d 616e 6420 6973 206f his command is o │ │ │ │ │ +0002e2d0: 6e6c 7920 6176 6169 6c61 626c 6520 6f6e nly available on │ │ │ │ │ +0002e2e0: 2078 3836 2073 7973 7465 6d73 2e0a 0a1f x86 systems.... │ │ │ │ │ +0002e2f0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +0002e300: 2c20 204e 6f64 653a 2069 6e73 6d6f 642c , Node: insmod, │ │ │ │ │ +0002e310: 2020 4e65 7874 3a20 6b65 7973 7461 7475 Next: keystatu │ │ │ │ │ +0002e320: 732c 2020 5072 6576 3a20 696e 6974 7264 s, Prev: initrd │ │ │ │ │ +0002e330: 3136 2c20 2055 703a 2043 6f6d 6d61 6e64 16, Up: Command │ │ │ │ │ +0002e340: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +0002e350: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +0002e360: 362e 332e 3336 2069 6e73 6d6f 640a 2d2d 6.3.36 insmod.-- │ │ │ │ │ +0002e370: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ +0002e380: 2d20 436f 6d6d 616e 643a 2069 6e73 6d6f - Command: insmo │ │ │ │ │ +0002e390: 6420 6d6f 6475 6c65 0a20 2020 2020 496e d module. In │ │ │ │ │ +0002e3a0: 7365 7274 2074 6865 2064 796e 616d 6963 sert the dynamic │ │ │ │ │ +0002e3b0: 2047 5255 4220 6d6f 6475 6c65 2063 616c GRUB module cal │ │ │ │ │ +0002e3c0: 6c65 6420 4d4f 4455 4c45 2e0a 0a1f 0a46 led MODULE.....F │ │ │ │ │ +0002e3d0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +0002e3e0: 204e 6f64 653a 206b 6579 7374 6174 7573 Node: keystatus │ │ │ │ │ +0002e3f0: 2c20 204e 6578 743a 206c 696e 7578 2c20 , Next: linux, │ │ │ │ │ +0002e400: 2050 7265 763a 2069 6e73 6d6f 642c 2020 Prev: insmod, │ │ │ │ │ +0002e410: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ +0002e420: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +0002e430: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e33 commands..16.3.3 │ │ │ │ │ +0002e440: 3720 6b65 7973 7461 7475 730a 2d2d 2d2d 7 keystatus.---- │ │ │ │ │ +0002e450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +0002e460: 2d2d 2043 6f6d 6d61 6e64 3a20 6b65 7973 -- Command: keys │ │ │ │ │ +0002e470: 7461 7475 7320 5b2d 2d73 6869 6674 5d20 tatus [--shift] │ │ │ │ │ +0002e480: 5b2d 2d63 7472 6c5d 205b 2d2d 616c 745d [--ctrl] [--alt] │ │ │ │ │ +0002e490: 0a20 2020 2020 5265 7475 726e 2074 7275 . Return tru │ │ │ │ │ +0002e4a0: 6520 6966 2074 6865 2053 6869 6674 2c20 e if the Shift, │ │ │ │ │ +0002e4b0: 436f 6e74 726f 6c2c 206f 7220 416c 7420 Control, or Alt │ │ │ │ │ +0002e4c0: 6d6f 6469 6669 6572 206b 6579 7320 6172 modifier keys ar │ │ │ │ │ +0002e4d0: 6520 6865 6c64 0a20 2020 2020 646f 776e e held. down │ │ │ │ │ +0002e4e0: 2c20 6173 2072 6571 7565 7374 6564 2062 , as requested b │ │ │ │ │ +0002e4f0: 7920 6f70 7469 6f6e 732e 2020 5468 6973 y options. This │ │ │ │ │ +0002e500: 2069 7320 7573 6566 756c 2069 6e20 7363 is useful in sc │ │ │ │ │ +0002e510: 7269 7074 696e 672c 2074 6f0a 2020 2020 ripting, to. │ │ │ │ │ +0002e520: 2061 6c6c 6f77 2073 6f6d 6520 7573 6572 allow some user │ │ │ │ │ +0002e530: 2063 6f6e 7472 6f6c 206f 7665 7220 6265 control over be │ │ │ │ │ +0002e540: 6861 7669 6f75 7220 7769 7468 6f75 7420 haviour without │ │ │ │ │ +0002e550: 6861 7669 6e67 2074 6f20 7761 6974 2066 having to wait f │ │ │ │ │ +0002e560: 6f72 2061 0a20 2020 2020 6b65 7970 7265 or a. keypre │ │ │ │ │ +0002e570: 7373 2e0a 0a20 2020 2020 4368 6563 6b69 ss... Checki │ │ │ │ │ +0002e580: 6e67 206b 6579 206d 6f64 6966 6965 7220 ng key modifier │ │ │ │ │ +0002e590: 7374 6174 7573 2069 7320 6f6e 6c79 2073 status is only s │ │ │ │ │ +0002e5a0: 7570 706f 7274 6564 206f 6e20 736f 6d65 upported on some │ │ │ │ │ +0002e5b0: 2070 6c61 7466 6f72 6d73 2e0a 2020 2020 platforms.. │ │ │ │ │ +0002e5c0: 2049 6620 696e 766f 6b65 6420 7769 7468 If invoked with │ │ │ │ │ +0002e5d0: 6f75 7420 616e 7920 6f70 7469 6f6e 732c out any options, │ │ │ │ │ +0002e5e0: 2074 6865 2027 6b65 7973 7461 7475 7327 the 'keystatus' │ │ │ │ │ +0002e5f0: 2063 6f6d 6d61 6e64 2072 6574 7572 6e73 command returns │ │ │ │ │ +0002e600: 0a20 2020 2020 7472 7565 2069 6620 616e . true if an │ │ │ │ │ +0002e610: 6420 6f6e 6c79 2069 6620 6368 6563 6b69 d only if checki │ │ │ │ │ +0002e620: 6e67 206b 6579 206d 6f64 6966 6965 7220 ng key modifier │ │ │ │ │ +0002e630: 7374 6174 7573 2069 7320 7375 7070 6f72 status is suppor │ │ │ │ │ +0002e640: 7465 642e 0a0a 1f0a 4669 6c65 3a20 6772 ted.....File: gr │ │ │ │ │ +0002e650: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +0002e660: 6c69 6e75 782c 2020 4e65 7874 3a20 6c69 linux, Next: li │ │ │ │ │ +0002e670: 6e75 7831 362c 2020 5072 6576 3a20 6b65 nux16, Prev: ke │ │ │ │ │ +0002e680: 7973 7461 7475 732c 2020 5570 3a20 436f ystatus, Up: Co │ │ │ │ │ +0002e690: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +0002e6a0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +0002e6b0: 6473 0a0a 3136 2e33 2e33 3820 6c69 6e75 ds..16.3.38 linu │ │ │ │ │ +0002e6c0: 780a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a x.-------------. │ │ │ │ │ +0002e6d0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6c69 . -- Command: li │ │ │ │ │ +0002e6e0: 6e75 7820 6669 6c65 202e 2e2e 0a20 2020 nux file .... │ │ │ │ │ +0002e6f0: 2020 4c6f 6164 2061 204c 696e 7578 206b Load a Linux k │ │ │ │ │ +0002e700: 6572 6e65 6c20 696d 6167 6520 6672 6f6d ernel image from │ │ │ │ │ +0002e710: 2046 494c 452e 2020 5468 6520 7265 7374 FILE. The rest │ │ │ │ │ +0002e720: 206f 6620 7468 6520 6c69 6e65 2069 730a of the line is. │ │ │ │ │ +0002e730: 2020 2020 2070 6173 7365 6420 7665 7262 passed verb │ │ │ │ │ +0002e740: 6174 696d 2061 7320 7468 6520 226b 6572 atim as the "ker │ │ │ │ │ +0002e750: 6e65 6c20 636f 6d6d 616e 642d 6c69 6e65 nel command-line │ │ │ │ │ +0002e760: 222e 2020 416e 7920 696e 6974 7264 206d ". Any initrd m │ │ │ │ │ +0002e770: 7573 7420 6265 0a20 2020 2020 7265 6c6f ust be. relo │ │ │ │ │ +0002e780: 6164 6564 2061 6674 6572 2075 7369 6e67 aded after using │ │ │ │ │ +0002e790: 2074 6869 7320 636f 6d6d 616e 6420 282a this command (* │ │ │ │ │ +0002e7a0: 6e6f 7465 2069 6e69 7472 643a 3a29 2e0a note initrd::).. │ │ │ │ │ +0002e7b0: 0a20 2020 2020 4f6e 2078 3836 2073 7973 . On x86 sys │ │ │ │ │ +0002e7c0: 7465 6d73 2c20 7468 6520 6b65 726e 656c tems, the kernel │ │ │ │ │ +0002e7d0: 2077 696c 6c20 6265 2062 6f6f 7465 6420 will be booted │ │ │ │ │ +0002e7e0: 7573 696e 6720 7468 6520 3332 2d62 6974 using the 32-bit │ │ │ │ │ +0002e7f0: 2062 6f6f 740a 2020 2020 2070 726f 746f boot. proto │ │ │ │ │ +0002e800: 636f 6c2e 2020 4e6f 7465 2074 6861 7420 col. Note that │ │ │ │ │ +0002e810: 7468 6973 206d 6561 6e73 2074 6861 7420 this means that │ │ │ │ │ +0002e820: 7468 6520 2776 6761 3d27 2062 6f6f 7420 the 'vga=' boot │ │ │ │ │ +0002e830: 6f70 7469 6f6e 2077 696c 6c0a 2020 2020 option will. │ │ │ │ │ +0002e840: 206e 6f74 2077 6f72 6b3b 2069 6620 796f not work; if yo │ │ │ │ │ +0002e850: 7520 7761 6e74 2074 6f20 7365 7420 6120 u want to set a │ │ │ │ │ +0002e860: 7370 6563 6961 6c20 7669 6465 6f20 6d6f special video mo │ │ │ │ │ +0002e870: 6465 2c20 796f 7520 7769 6c6c 206e 6565 de, you will nee │ │ │ │ │ +0002e880: 6420 746f 0a20 2020 2020 7573 6520 4752 d to. use GR │ │ │ │ │ +0002e890: 5542 2063 6f6d 6d61 6e64 7320 7375 6368 UB commands such │ │ │ │ │ +0002e8a0: 2061 7320 2773 6574 2067 6678 7061 796c as 'set gfxpayl │ │ │ │ │ +0002e8b0: 6f61 643d 3130 3234 7837 3638 2720 6f72 oad=1024x768' or │ │ │ │ │ +0002e8c0: 2027 7365 740a 2020 2020 2067 6678 7061 'set. gfxpa │ │ │ │ │ +0002e8d0: 796c 6f61 643d 6b65 6570 2720 2874 6f20 yload=keep' (to │ │ │ │ │ +0002e8e0: 6b65 6570 2074 6865 2073 616d 6520 6d6f keep the same mo │ │ │ │ │ +0002e8f0: 6465 2061 7320 7573 6564 2069 6e20 4752 de as used in GR │ │ │ │ │ +0002e900: 5542 2920 696e 7374 6561 642e 0a20 2020 UB) instead.. │ │ │ │ │ +0002e910: 2020 4752 5542 2063 616e 2061 7574 6f6d GRUB can autom │ │ │ │ │ +0002e920: 6174 6963 616c 6c79 2064 6574 6563 7420 atically detect │ │ │ │ │ +0002e930: 736f 6d65 2075 7365 7320 6f66 2027 7667 some uses of 'vg │ │ │ │ │ +0002e940: 613d 2720 616e 6420 7472 616e 736c 6174 a=' and translat │ │ │ │ │ +0002e950: 650a 2020 2020 2074 6865 6d20 746f 2061 e. them to a │ │ │ │ │ +0002e960: 7070 726f 7072 6961 7465 2073 6574 7469 ppropriate setti │ │ │ │ │ +0002e970: 6e67 7320 6f66 2027 6766 7870 6179 6c6f ngs of 'gfxpaylo │ │ │ │ │ +0002e980: 6164 272e 2020 5468 6520 276c 696e 7578 ad'. The 'linux │ │ │ │ │ +0002e990: 3136 270a 2020 2020 2063 6f6d 6d61 6e64 16'. command │ │ │ │ │ +0002e9a0: 2028 2a6e 6f74 6520 6c69 6e75 7831 363a (*note linux16: │ │ │ │ │ +0002e9b0: 3a29 2061 766f 6964 7320 7468 6973 2072 :) avoids this r │ │ │ │ │ +0002e9c0: 6573 7472 6963 7469 6f6e 2e0a 0a1f 0a46 estriction.....F │ │ │ │ │ +0002e9d0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +0002e9e0: 204e 6f64 653a 206c 696e 7578 3136 2c20 Node: linux16, │ │ │ │ │ +0002e9f0: 204e 6578 743a 206c 6973 745f 656e 762c Next: list_env, │ │ │ │ │ +0002ea00: 2020 5072 6576 3a20 6c69 6e75 782c 2020 Prev: linux, │ │ │ │ │ +0002ea10: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ +0002ea20: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +0002ea30: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e33 commands..16.3.3 │ │ │ │ │ +0002ea40: 3920 6c69 6e75 7831 360a 2d2d 2d2d 2d2d 9 linux16.------ │ │ │ │ │ +0002ea50: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ +0002ea60: 6f6d 6d61 6e64 3a20 6c69 6e75 7831 3620 ommand: linux16 │ │ │ │ │ +0002ea70: 6669 6c65 202e 2e2e 0a20 2020 2020 4c6f file .... Lo │ │ │ │ │ +0002ea80: 6164 2061 204c 696e 7578 206b 6572 6e65 ad a Linux kerne │ │ │ │ │ +0002ea90: 6c20 696d 6167 6520 6672 6f6d 2046 494c l image from FIL │ │ │ │ │ +0002eaa0: 4520 696e 2031 362d 6269 7420 6d6f 6465 E in 16-bit mode │ │ │ │ │ +0002eab0: 2e20 2054 6865 2072 6573 7420 6f66 0a20 . The rest of. │ │ │ │ │ +0002eac0: 2020 2020 7468 6520 6c69 6e65 2069 7320 the line is │ │ │ │ │ +0002ead0: 7061 7373 6564 2076 6572 6261 7469 6d20 passed verbatim │ │ │ │ │ +0002eae0: 6173 2074 6865 2022 6b65 726e 656c 2063 as the "kernel c │ │ │ │ │ +0002eaf0: 6f6d 6d61 6e64 2d6c 696e 6522 2e20 2041 ommand-line". A │ │ │ │ │ +0002eb00: 6e79 0a20 2020 2020 696e 6974 7264 206d ny. initrd m │ │ │ │ │ +0002eb10: 7573 7420 6265 2072 656c 6f61 6465 6420 ust be reloaded │ │ │ │ │ +0002eb20: 6166 7465 7220 7573 696e 6720 7468 6973 after using this │ │ │ │ │ +0002eb30: 2063 6f6d 6d61 6e64 2028 2a6e 6f74 650a command (*note. │ │ │ │ │ +0002eb40: 2020 2020 2069 6e69 7472 6431 363a 3a29 initrd16::) │ │ │ │ │ +0002eb50: 2e0a 0a20 2020 2020 5468 6520 6b65 726e ... The kern │ │ │ │ │ +0002eb60: 656c 2077 696c 6c20 6265 2062 6f6f 7465 el will be boote │ │ │ │ │ +0002eb70: 6420 7573 696e 6720 7468 6520 7472 6164 d using the trad │ │ │ │ │ +0002eb80: 6974 696f 6e61 6c20 3136 2d62 6974 2062 itional 16-bit b │ │ │ │ │ +0002eb90: 6f6f 740a 2020 2020 2070 726f 746f 636f oot. protoco │ │ │ │ │ +0002eba0: 6c2e 2020 4173 2077 656c 6c20 6173 2062 l. As well as b │ │ │ │ │ +0002ebb0: 7970 6173 7369 6e67 2070 726f 626c 656d ypassing problem │ │ │ │ │ +0002ebc0: 7320 7769 7468 2027 7667 613d 2720 6465 s with 'vga=' de │ │ │ │ │ +0002ebd0: 7363 7269 6265 6420 696e 0a20 2020 2020 scribed in. │ │ │ │ │ +0002ebe0: 2a6e 6f74 6520 6c69 6e75 783a 3a2c 2074 *note linux::, t │ │ │ │ │ +0002ebf0: 6869 7320 7065 726d 6974 7320 626f 6f74 his permits boot │ │ │ │ │ +0002ec00: 696e 6720 736f 6d65 206f 7468 6572 2070 ing some other p │ │ │ │ │ +0002ec10: 726f 6772 616d 7320 7468 6174 0a20 2020 rograms that. │ │ │ │ │ +0002ec20: 2020 696d 706c 656d 656e 7420 7468 6520 implement the │ │ │ │ │ +0002ec30: 4c69 6e75 7820 626f 6f74 2070 726f 746f Linux boot proto │ │ │ │ │ +0002ec40: 636f 6c20 666f 7220 7468 6520 7361 6b65 col for the sake │ │ │ │ │ +0002ec50: 206f 6620 636f 6e76 656e 6965 6e63 652e of convenience. │ │ │ │ │ +0002ec60: 0a0a 2020 2020 2054 6869 7320 636f 6d6d .. This comm │ │ │ │ │ +0002ec70: 616e 6420 6973 206f 6e6c 7920 6176 6169 and is only avai │ │ │ │ │ +0002ec80: 6c61 626c 6520 6f6e 2078 3836 2073 7973 lable on x86 sys │ │ │ │ │ +0002ec90: 7465 6d73 2e0a 0a1f 0a46 696c 653a 2067 tems.....File: g │ │ │ │ │ +0002eca0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +0002ecb0: 206c 6973 745f 656e 762c 2020 4e65 7874 list_env, Next │ │ │ │ │ +0002ecc0: 3a20 6c69 7374 5f74 7275 7374 6564 2c20 : list_trusted, │ │ │ │ │ +0002ecd0: 2050 7265 763a 206c 696e 7578 3136 2c20 Prev: linux16, │ │ │ │ │ +0002ece0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +0002ecf0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +0002ed00: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +0002ed10: 3430 206c 6973 745f 656e 760a 2d2d 2d2d 40 list_env.---- │ │ │ │ │ +0002ed20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ +0002ed30: 2d20 436f 6d6d 616e 643a 206c 6973 745f - Command: list_ │ │ │ │ │ +0002ed40: 656e 7620 5b2d 2d66 696c 6520 6669 6c65 env [--file file │ │ │ │ │ +0002ed50: 5d0a 2020 2020 204c 6973 7420 616c 6c20 ]. List all │ │ │ │ │ +0002ed60: 7661 7269 6162 6c65 7320 696e 2074 6865 variables in the │ │ │ │ │ +0002ed70: 2065 6e76 6972 6f6e 6d65 6e74 2062 6c6f environment blo │ │ │ │ │ +0002ed80: 636b 2066 696c 652e 2020 2a4e 6f74 650a ck file. *Note. │ │ │ │ │ +0002ed90: 2020 2020 2045 6e76 6972 6f6e 6d65 6e74 Environment │ │ │ │ │ +0002eda0: 2062 6c6f 636b 3a3a 2e0a 0a20 2020 2020 block::... │ │ │ │ │ +0002edb0: 5468 6520 272d 2d66 696c 6527 206f 7074 The '--file' opt │ │ │ │ │ +0002edc0: 696f 6e20 6f76 6572 7269 6465 7320 7468 ion overrides th │ │ │ │ │ +0002edd0: 6520 6465 6661 756c 7420 6c6f 6361 7469 e default locati │ │ │ │ │ +0002ede0: 6f6e 206f 6620 7468 650a 2020 2020 2065 on of the. e │ │ │ │ │ +0002edf0: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ │ +0002ee00: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +0002ee10: 696e 666f 2c20 204e 6f64 653a 206c 6973 info, Node: lis │ │ │ │ │ +0002ee20: 745f 7472 7573 7465 642c 2020 4e65 7874 t_trusted, Next │ │ │ │ │ +0002ee30: 3a20 6c6f 6164 5f65 6e76 2c20 2050 7265 : load_env, Pre │ │ │ │ │ +0002ee40: 763a 206c 6973 745f 656e 762c 2020 5570 v: list_env, Up │ │ │ │ │ +0002ee50: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +0002ee60: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +0002ee70: 6d6d 616e 6473 0a0a 3136 2e33 2e34 3120 mmands..16.3.41 │ │ │ │ │ +0002ee80: 6c69 7374 5f74 7275 7374 6564 0a2d 2d2d list_trusted.--- │ │ │ │ │ +0002ee90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0002eea0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +0002eeb0: 6c69 7374 5f74 7275 7374 6564 0a20 2020 list_trusted. │ │ │ │ │ +0002eec0: 2020 4c69 7374 2061 6c6c 2070 7562 6c69 List all publi │ │ │ │ │ +0002eed0: 6320 6b65 7973 2074 7275 7374 6564 2062 c keys trusted b │ │ │ │ │ +0002eee0: 7920 4752 5542 2066 6f72 2076 616c 6964 y GRUB for valid │ │ │ │ │ +0002eef0: 6174 696e 6720 7369 676e 6174 7572 6573 ating signatures │ │ │ │ │ +0002ef00: 2e0a 2020 2020 2054 6865 206f 7574 7075 .. The outpu │ │ │ │ │ +0002ef10: 7420 6973 2069 6e20 4750 4727 7320 7634 t is in GPG's v4 │ │ │ │ │ +0002ef20: 206b 6579 2066 696e 6765 7270 7269 6e74 key fingerprint │ │ │ │ │ +0002ef30: 2066 6f72 6d61 7420 2869 2e65 2e2c 2074 format (i.e., t │ │ │ │ │ +0002ef40: 6865 206f 7574 7075 740a 2020 2020 206f he output. o │ │ │ │ │ +0002ef50: 6620 2767 7067 202d 2d66 696e 6765 7270 f 'gpg --fingerp │ │ │ │ │ +0002ef60: 7269 6e74 2729 2e20 2054 6865 206c 6561 rint'). The lea │ │ │ │ │ +0002ef70: 7374 2073 6967 6e69 6669 6361 6e74 2066 st significant f │ │ │ │ │ +0002ef80: 6f75 7220 6279 7465 7320 286c 6173 740a our bytes (last. │ │ │ │ │ +0002ef90: 2020 2020 2065 6967 6874 2068 6578 6164 eight hexad │ │ │ │ │ +0002efa0: 6563 696d 616c 2064 6967 6974 7329 2063 ecimal digits) c │ │ │ │ │ +0002efb0: 616e 2062 6520 7573 6564 2061 7320 616e an be used as an │ │ │ │ │ +0002efc0: 2061 7267 756d 656e 7420 746f 2027 6469 argument to 'di │ │ │ │ │ +0002efd0: 7374 7275 7374 270a 2020 2020 2028 2a6e strust'. (*n │ │ │ │ │ +0002efe0: 6f74 6520 6469 7374 7275 7374 3a3a 292e ote distrust::). │ │ │ │ │ +0002eff0: 2020 2a4e 6f74 6520 5573 696e 6720 6469 *Note Using di │ │ │ │ │ +0002f000: 6769 7461 6c20 7369 676e 6174 7572 6573 gital signatures │ │ │ │ │ +0002f010: 3a3a 2c20 666f 7220 6d6f 7265 0a20 2020 ::, for more. │ │ │ │ │ +0002f020: 2020 696e 666f 726d 6174 696f 6e20 6162 information ab │ │ │ │ │ +0002f030: 6f75 7420 7573 6573 2066 6f72 2074 6865 out uses for the │ │ │ │ │ +0002f040: 7365 206b 6579 732e 0a0a 1f0a 4669 6c65 se keys.....File │ │ │ │ │ +0002f050: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0002f060: 6465 3a20 6c6f 6164 5f65 6e76 2c20 204e de: load_env, N │ │ │ │ │ +0002f070: 6578 743a 206c 6f61 6466 6f6e 742c 2020 ext: loadfont, │ │ │ │ │ +0002f080: 5072 6576 3a20 6c69 7374 5f74 7275 7374 Prev: list_trust │ │ │ │ │ +0002f090: 6564 2c20 2055 703a 2043 6f6d 6d61 6e64 ed, Up: Command │ │ │ │ │ +0002f0a0: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +0002f0b0: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +0002f0c0: 362e 332e 3432 206c 6f61 645f 656e 760a 6.3.42 load_env. │ │ │ │ │ +0002f0d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +0002f0e0: 0a0a 202d 2d20 436f 6d6d 616e 643a 206c .. -- Command: l │ │ │ │ │ +0002f0f0: 6f61 645f 656e 7620 5b2d 2d66 696c 6520 oad_env [--file │ │ │ │ │ +0002f100: 6669 6c65 5d20 5b2d 2d73 6b69 702d 7369 file] [--skip-si │ │ │ │ │ +0002f110: 675d 0a20 2020 2020 2020 2020 205b 7768 g]. [wh │ │ │ │ │ +0002f120: 6974 656c 6973 7465 645f 7661 7269 6162 itelisted_variab │ │ │ │ │ +0002f130: 6c65 5f6e 616d 655d 202e 2e2e 0a20 2020 le_name] .... │ │ │ │ │ +0002f140: 2020 4c6f 6164 2061 6c6c 2076 6172 6961 Load all varia │ │ │ │ │ +0002f150: 626c 6573 2066 726f 6d20 7468 6520 656e bles from the en │ │ │ │ │ +0002f160: 7669 726f 6e6d 656e 7420 626c 6f63 6b20 vironment block │ │ │ │ │ +0002f170: 6669 6c65 2069 6e74 6f20 7468 650a 2020 file into the. │ │ │ │ │ +0002f180: 2020 2065 6e76 6972 6f6e 6d65 6e74 2e20 environment. │ │ │ │ │ +0002f190: 202a 4e6f 7465 2045 6e76 6972 6f6e 6d65 *Note Environme │ │ │ │ │ +0002f1a0: 6e74 2062 6c6f 636b 3a3a 2e0a 0a20 2020 nt block::... │ │ │ │ │ +0002f1b0: 2020 5468 6520 272d 2d66 696c 6527 206f The '--file' o │ │ │ │ │ +0002f1c0: 7074 696f 6e20 6f76 6572 7269 6465 7320 ption overrides │ │ │ │ │ +0002f1d0: 7468 6520 6465 6661 756c 7420 6c6f 6361 the default loca │ │ │ │ │ +0002f1e0: 7469 6f6e 206f 6620 7468 650a 2020 2020 tion of the. │ │ │ │ │ +0002f1f0: 2065 6e76 6972 6f6e 6d65 6e74 2062 6c6f environment blo │ │ │ │ │ +0002f200: 636b 2e0a 0a20 2020 2020 5468 6520 272d ck... The '- │ │ │ │ │ +0002f210: 2d73 6b69 702d 7369 6727 206f 7074 696f -skip-sig' optio │ │ │ │ │ +0002f220: 6e20 736b 6970 7320 7369 676e 6174 7572 n skips signatur │ │ │ │ │ +0002f230: 6520 6368 6563 6b69 6e67 2065 7665 6e20 e checking even │ │ │ │ │ +0002f240: 7768 656e 2074 6865 0a20 2020 2020 7661 when the. va │ │ │ │ │ +0002f250: 6c75 6520 6f66 2065 6e76 6972 6f6e 6d65 lue of environme │ │ │ │ │ +0002f260: 6e74 2076 6172 6961 626c 6520 2763 6865 nt variable 'che │ │ │ │ │ +0002f270: 636b 5f73 6967 6e61 7475 7265 7327 2069 ck_signatures' i │ │ │ │ │ +0002f280: 7320 7365 7420 746f 0a20 2020 2020 2765 s set to. 'e │ │ │ │ │ +0002f290: 6e66 6f72 6365 2720 282a 6e6f 7465 2063 nforce' (*note c │ │ │ │ │ +0002f2a0: 6865 636b 5f73 6967 6e61 7475 7265 733a heck_signatures: │ │ │ │ │ +0002f2b0: 3a29 2e0a 0a20 2020 2020 4966 206f 6e65 :)... If one │ │ │ │ │ +0002f2c0: 206f 7220 6d6f 7265 2076 6172 6961 626c or more variabl │ │ │ │ │ +0002f2d0: 6520 6e61 6d65 7320 6172 6520 7072 6f76 e names are prov │ │ │ │ │ +0002f2e0: 6964 6564 2061 7320 6172 6775 6d65 6e74 ided as argument │ │ │ │ │ +0002f2f0: 732c 2074 6865 7920 6172 650a 2020 2020 s, they are. │ │ │ │ │ +0002f300: 2069 6e74 6572 7072 6574 6564 2061 7320 interpreted as │ │ │ │ │ +0002f310: 6120 7768 6974 656c 6973 7420 6f66 2076 a whitelist of v │ │ │ │ │ +0002f320: 6172 6961 626c 6573 2074 6f20 6c6f 6164 ariables to load │ │ │ │ │ +0002f330: 2066 726f 6d20 7468 650a 2020 2020 2065 from the. e │ │ │ │ │ +0002f340: 6e76 6972 6f6e 6d65 6e74 2062 6c6f 636b nvironment block │ │ │ │ │ +0002f350: 2066 696c 652e 2020 5661 7269 6162 6c65 file. Variable │ │ │ │ │ +0002f360: 7320 7365 7420 696e 2074 6865 2066 696c s set in the fil │ │ │ │ │ +0002f370: 6520 6275 7420 6e6f 7420 7072 6573 656e e but not presen │ │ │ │ │ +0002f380: 740a 2020 2020 2069 6e20 7468 6520 7768 t. in the wh │ │ │ │ │ +0002f390: 6974 656c 6973 7420 6172 6520 6967 6e6f itelist are igno │ │ │ │ │ +0002f3a0: 7265 642e 0a0a 2020 2020 2054 6865 2027 red... The ' │ │ │ │ │ +0002f3b0: 2d2d 736b 6970 2d73 6967 2720 6f70 7469 --skip-sig' opti │ │ │ │ │ +0002f3c0: 6f6e 2073 686f 756c 6420 6265 2075 7365 on should be use │ │ │ │ │ +0002f3d0: 6420 7769 7468 2063 6172 652c 2061 6e64 d with care, and │ │ │ │ │ +0002f3e0: 2073 686f 756c 6420 616c 7761 7973 0a20 should always. │ │ │ │ │ +0002f3f0: 2020 2020 6265 2075 7365 6420 696e 2063 be used in c │ │ │ │ │ +0002f400: 6f6e 6365 7274 2077 6974 6820 6120 7768 oncert with a wh │ │ │ │ │ +0002f410: 6974 656c 6973 7420 6f66 2061 6363 6570 itelist of accep │ │ │ │ │ +0002f420: 7461 626c 6520 7661 7269 6162 6c65 7320 table variables │ │ │ │ │ +0002f430: 7768 6f73 650a 2020 2020 2076 616c 7565 whose. value │ │ │ │ │ +0002f440: 7320 7368 6f75 6c64 2062 6520 7365 742e s should be set. │ │ │ │ │ +0002f450: 2020 4661 696c 7572 6520 746f 2065 6d70 Failure to emp │ │ │ │ │ +0002f460: 6c6f 7920 6120 6361 7265 6675 6c6c 7920 loy a carefully │ │ │ │ │ +0002f470: 636f 6e73 7472 7563 7465 640a 2020 2020 constructed. │ │ │ │ │ +0002f480: 2077 6869 7465 6c69 7374 2063 6f75 6c64 whitelist could │ │ │ │ │ +0002f490: 2072 6573 756c 7420 696e 2072 6561 6469 result in readi │ │ │ │ │ +0002f4a0: 6e67 2061 206d 616c 6963 696f 7573 2076 ng a malicious v │ │ │ │ │ +0002f4b0: 616c 7565 2069 6e74 6f20 6372 6974 6963 alue into critic │ │ │ │ │ +0002f4c0: 616c 0a20 2020 2020 656e 7669 726f 6e6d al. environm │ │ │ │ │ +0002f4d0: 656e 7420 7661 7269 6162 6c65 7320 6672 ent variables fr │ │ │ │ │ +0002f4e0: 6f6d 2074 6865 2066 696c 652c 2073 7563 om the file, suc │ │ │ │ │ +0002f4f0: 6820 6173 2073 6574 7469 6e67 0a20 2020 h as setting. │ │ │ │ │ +0002f500: 2020 2763 6865 636b 5f73 6967 6e61 7475 'check_signatu │ │ │ │ │ +0002f510: 7265 733d 6e6f 272c 206d 6f64 6966 7969 res=no', modifyi │ │ │ │ │ +0002f520: 6e67 2027 7072 6566 6978 2720 746f 2062 ng 'prefix' to b │ │ │ │ │ +0002f530: 6f6f 7420 6672 6f6d 2061 6e0a 2020 2020 oot from an. │ │ │ │ │ +0002f540: 2075 6e65 7870 6563 7465 6420 6c6f 6361 unexpected loca │ │ │ │ │ +0002f550: 7469 6f6e 206f 7220 6e6f 7420 6174 2061 tion or not at a │ │ │ │ │ +0002f560: 6c6c 2c20 6574 632e 0a0a 2020 2020 2057 ll, etc... W │ │ │ │ │ +0002f570: 6865 6e20 7573 6564 2077 6974 6820 6361 hen used with ca │ │ │ │ │ +0002f580: 7265 2c20 272d 2d73 6b69 702d 7369 6727 re, '--skip-sig' │ │ │ │ │ +0002f590: 2061 6e64 2074 6865 2077 6869 7465 6c69 and the whiteli │ │ │ │ │ +0002f5a0: 7374 2065 6e61 626c 6520 616e 0a20 2020 st enable an. │ │ │ │ │ +0002f5b0: 2020 6164 6d69 6e69 7374 7261 746f 7220 administrator │ │ │ │ │ +0002f5c0: 746f 2063 6f6e 6669 6775 7265 2061 2073 to configure a s │ │ │ │ │ +0002f5d0: 7973 7465 6d20 746f 2062 6f6f 7420 6f6e ystem to boot on │ │ │ │ │ +0002f5e0: 6c79 2073 6967 6e65 640a 2020 2020 2063 ly signed. c │ │ │ │ │ +0002f5f0: 6f6e 6669 6775 7261 7469 6f6e 732c 2062 onfigurations, b │ │ │ │ │ +0002f600: 7574 2074 6f20 616c 6c6f 7720 7468 6520 ut to allow the │ │ │ │ │ +0002f610: 7573 6572 2074 6f20 7365 6c65 6374 2066 user to select f │ │ │ │ │ +0002f620: 726f 6d20 616d 6f6e 6720 6d75 6c74 6970 rom among multip │ │ │ │ │ +0002f630: 6c65 0a20 2020 2020 636f 6e66 6967 7572 le. configur │ │ │ │ │ +0002f640: 6174 696f 6e73 2c20 616e 6420 746f 2065 ations, and to e │ │ │ │ │ +0002f650: 6e61 626c 6520 226f 6e65 2d73 686f 7422 nable "one-shot" │ │ │ │ │ +0002f660: 2062 6f6f 7420 6174 7465 6d70 7473 2061 boot attempts a │ │ │ │ │ +0002f670: 6e64 0a20 2020 2020 2273 6176 6564 6566 nd. "savedef │ │ │ │ │ +0002f680: 6175 6c74 2220 6265 6861 7669 6f72 2e20 ault" behavior. │ │ │ │ │ +0002f690: 202a 4e6f 7465 2055 7369 6e67 2064 6967 *Note Using dig │ │ │ │ │ +0002f6a0: 6974 616c 2073 6967 6e61 7475 7265 733a ital signatures: │ │ │ │ │ +0002f6b0: 3a2c 2066 6f72 206d 6f72 650a 2020 2020 :, for more. │ │ │ │ │ +0002f6c0: 2069 6e66 6f72 6d61 7469 6f6e 2e0a 0a1f information.... │ │ │ │ │ +0002f6d0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +0002f6e0: 2c20 204e 6f64 653a 206c 6f61 6466 6f6e , Node: loadfon │ │ │ │ │ +0002f6f0: 742c 2020 4e65 7874 3a20 6c6f 6f70 6261 t, Next: loopba │ │ │ │ │ +0002f700: 636b 2c20 2050 7265 763a 206c 6f61 645f ck, Prev: load_ │ │ │ │ │ +0002f710: 656e 762c 2020 5570 3a20 436f 6d6d 616e env, Up: Comman │ │ │ │ │ +0002f720: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ +0002f730: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ │ +0002f740: 3136 2e33 2e34 3320 6c6f 6164 666f 6e74 16.3.43 loadfont │ │ │ │ │ +0002f750: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +0002f760: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +0002f770: 6c6f 6164 666f 6e74 2066 696c 6520 2e2e loadfont file .. │ │ │ │ │ +0002f780: 2e0a 2020 2020 204c 6f61 6420 7370 6563 .. Load spec │ │ │ │ │ +0002f790: 6966 6965 6420 666f 6e74 2066 696c 6573 ified font files │ │ │ │ │ +0002f7a0: 2e20 2055 6e6c 6573 7320 6162 736f 6c75 . Unless absolu │ │ │ │ │ +0002f7b0: 7465 2070 6174 686e 616d 6520 6973 2067 te pathname is g │ │ │ │ │ +0002f7c0: 6976 656e 2c20 4649 4c45 0a20 2020 2020 iven, FILE. │ │ │ │ │ +0002f7d0: 6973 2061 7373 756d 6564 2074 6f20 6265 is assumed to be │ │ │ │ │ +0002f7e0: 2069 6e20 6469 7265 6374 6f72 7920 2724 in directory '$ │ │ │ │ │ +0002f7f0: 7072 6566 6978 2f66 6f6e 7473 2720 7769 prefix/fonts' wi │ │ │ │ │ +0002f800: 7468 2073 7566 6669 7820 272e 7066 3227 th suffix '.pf2' │ │ │ │ │ +0002f810: 0a20 2020 2020 6170 7065 6e64 6564 2e20 . appended. │ │ │ │ │ +0002f820: 202a 4e6f 7465 2046 6f6e 7473 3a20 5468 *Note Fonts: Th │ │ │ │ │ +0002f830: 656d 6520 6669 6c65 2066 6f72 6d61 742e eme file format. │ │ │ │ │ +0002f840: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0002f850: 6e66 6f2c 2020 4e6f 6465 3a20 6c6f 6f70 nfo, Node: loop │ │ │ │ │ +0002f860: 6261 636b 2c20 204e 6578 743a 206c 732c back, Next: ls, │ │ │ │ │ +0002f870: 2020 5072 6576 3a20 6c6f 6164 666f 6e74 Prev: loadfont │ │ │ │ │ +0002f880: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ +0002f890: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ +0002f8a0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ +0002f8b0: 332e 3434 206c 6f6f 7062 6163 6b0a 2d2d 3.44 loopback.-- │ │ │ │ │ +0002f8c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +0002f8d0: 202d 2d20 436f 6d6d 616e 643a 206c 6f6f -- Command: loo │ │ │ │ │ +0002f8e0: 7062 6163 6b20 5b2d 645d 2064 6576 6963 pback [-d] devic │ │ │ │ │ +0002f8f0: 6520 6669 6c65 0a20 2020 2020 4d61 6b65 e file. Make │ │ │ │ │ +0002f900: 2074 6865 2064 6576 6963 6520 6e61 6d65 the device name │ │ │ │ │ +0002f910: 6420 4445 5649 4345 2063 6f72 7265 7370 d DEVICE corresp │ │ │ │ │ +0002f920: 6f6e 6420 746f 2074 6865 2063 6f6e 7465 ond to the conte │ │ │ │ │ +0002f930: 6e74 7320 6f66 2074 6865 0a20 2020 2020 nts of the. │ │ │ │ │ +0002f940: 6669 6c65 7379 7374 656d 2069 6d61 6765 filesystem image │ │ │ │ │ +0002f950: 2069 6e20 4649 4c45 2e20 2046 6f72 2065 in FILE. For e │ │ │ │ │ +0002f960: 7861 6d70 6c65 3a0a 0a20 2020 2020 2020 xample:.. │ │ │ │ │ +0002f970: 2020 206c 6f6f 7062 6163 6b20 6c6f 6f70 loopback loop │ │ │ │ │ +0002f980: 3020 2f70 6174 682f 746f 2f69 6d61 6765 0 /path/to/image │ │ │ │ │ +0002f990: 0a20 2020 2020 2020 2020 206c 7320 286c . ls (l │ │ │ │ │ +0002f9a0: 6f6f 7030 292f 0a0a 2020 2020 2057 6974 oop0)/.. Wit │ │ │ │ │ +0002f9b0: 6820 7468 6520 272d 6427 206f 7074 696f h the '-d' optio │ │ │ │ │ +0002f9c0: 6e2c 2064 656c 6574 6520 6120 6465 7669 n, delete a devi │ │ │ │ │ +0002f9d0: 6365 2070 7265 7669 6f75 736c 7920 6372 ce previously cr │ │ │ │ │ +0002f9e0: 6561 7465 6420 7573 696e 6720 7468 6973 eated using this │ │ │ │ │ +0002f9f0: 0a20 2020 2020 636f 6d6d 616e 642e 0a0a . command... │ │ │ │ │ +0002fa00: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +0002fa10: 6f2c 2020 4e6f 6465 3a20 6c73 2c20 204e o, Node: ls, N │ │ │ │ │ +0002fa20: 6578 743a 206c 7366 6f6e 7473 2c20 2050 ext: lsfonts, P │ │ │ │ │ +0002fa30: 7265 763a 206c 6f6f 7062 6163 6b2c 2020 rev: loopback, │ │ │ │ │ +0002fa40: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ +0002fa50: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +0002fa60: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e34 commands..16.3.4 │ │ │ │ │ +0002fa70: 3520 6c73 0a2d 2d2d 2d2d 2d2d 2d2d 2d0a 5 ls.----------. │ │ │ │ │ +0002fa80: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6c73 . -- Command: ls │ │ │ │ │ +0002fa90: 205b 6172 6720 2e2e 2e5d 0a20 2020 2020 [arg ...]. │ │ │ │ │ +0002faa0: 4c69 7374 2064 6576 6963 6573 206f 7220 List devices or │ │ │ │ │ +0002fab0: 6669 6c65 732e 0a0a 2020 2020 2057 6974 files... Wit │ │ │ │ │ +0002fac0: 6820 6e6f 2061 7267 756d 656e 7473 2c20 h no arguments, │ │ │ │ │ +0002fad0: 7072 696e 7420 616c 6c20 6465 7669 6365 print all device │ │ │ │ │ +0002fae0: 7320 6b6e 6f77 6e20 746f 2047 5255 422e s known to GRUB. │ │ │ │ │ +0002faf0: 0a0a 2020 2020 2049 6620 7468 6520 6172 .. If the ar │ │ │ │ │ +0002fb00: 6775 6d65 6e74 2069 7320 6120 6465 7669 gument is a devi │ │ │ │ │ +0002fb10: 6365 206e 616d 6520 656e 636c 6f73 6564 ce name enclosed │ │ │ │ │ +0002fb20: 2069 6e20 7061 7265 6e74 6865 7365 7320 in parentheses │ │ │ │ │ +0002fb30: 282a 6e6f 7465 0a20 2020 2020 4465 7669 (*note. Devi │ │ │ │ │ +0002fb40: 6365 2073 796e 7461 783a 3a29 2c20 7468 ce syntax::), th │ │ │ │ │ +0002fb50: 656e 2070 7269 6e74 2074 6865 206e 616d en print the nam │ │ │ │ │ +0002fb60: 6520 6f66 2074 6865 2066 696c 6573 7973 e of the filesys │ │ │ │ │ +0002fb70: 7465 6d20 6f66 2074 6861 740a 2020 2020 tem of that. │ │ │ │ │ +0002fb80: 2064 6576 6963 652e 0a0a 2020 2020 2049 device... I │ │ │ │ │ +0002fb90: 6620 7468 6520 6172 6775 6d65 6e74 2069 f the argument i │ │ │ │ │ +0002fba0: 7320 6120 6469 7265 6374 6f72 7920 6769 s a directory gi │ │ │ │ │ +0002fbb0: 7665 6e20 6173 2061 6e20 6162 736f 6c75 ven as an absolu │ │ │ │ │ +0002fbc0: 7465 2066 696c 6520 6e61 6d65 0a20 2020 te file name. │ │ │ │ │ +0002fbd0: 2020 282a 6e6f 7465 2046 696c 6520 6e61 (*note File na │ │ │ │ │ +0002fbe0: 6d65 2073 796e 7461 783a 3a29 2c20 7468 me syntax::), th │ │ │ │ │ +0002fbf0: 656e 206c 6973 7420 7468 6520 636f 6e74 en list the cont │ │ │ │ │ +0002fc00: 656e 7473 206f 6620 7468 6174 0a20 2020 ents of that. │ │ │ │ │ +0002fc10: 2020 6469 7265 6374 6f72 792e 0a0a 1f0a directory..... │ │ │ │ │ +0002fc20: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +0002fc30: 2020 4e6f 6465 3a20 6c73 666f 6e74 732c Node: lsfonts, │ │ │ │ │ +0002fc40: 2020 4e65 7874 3a20 6c73 6d6f 642c 2020 Next: lsmod, │ │ │ │ │ +0002fc50: 5072 6576 3a20 6c73 2c20 2055 703a 2043 Prev: ls, Up: C │ │ │ │ │ +0002fc60: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +0002fc70: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +0002fc80: 6e64 730a 0a31 362e 332e 3436 206c 7366 nds..16.3.46 lsf │ │ │ │ │ +0002fc90: 6f6e 7473 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d onts.----------- │ │ │ │ │ +0002fca0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +0002fcb0: 643a 206c 7366 6f6e 7473 0a20 2020 2020 d: lsfonts. │ │ │ │ │ +0002fcc0: 4c69 7374 206c 6f61 6465 6420 666f 6e74 List loaded font │ │ │ │ │ +0002fcd0: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ +0002fce0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6c73 .info, Node: ls │ │ │ │ │ +0002fcf0: 6d6f 642c 2020 4e65 7874 3a20 6d64 3573 mod, Next: md5s │ │ │ │ │ +0002fd00: 756d 2c20 2050 7265 763a 206c 7366 6f6e um, Prev: lsfon │ │ │ │ │ +0002fd10: 7473 2c20 2055 703a 2043 6f6d 6d61 6e64 ts, Up: Command │ │ │ │ │ +0002fd20: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +0002fd30: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +0002fd40: 362e 332e 3437 206c 736d 6f64 0a2d 2d2d 6.3.47 lsmod.--- │ │ │ │ │ +0002fd50: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ +0002fd60: 436f 6d6d 616e 643a 206c 736d 6f64 0a20 Command: lsmod. │ │ │ │ │ +0002fd70: 2020 2020 5368 6f77 206c 6973 7420 6f66 Show list of │ │ │ │ │ +0002fd80: 206c 6f61 6465 6420 6d6f 6475 6c65 732e loaded modules. │ │ │ │ │ +0002fd90: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +0002fda0: 6e66 6f2c 2020 4e6f 6465 3a20 6d64 3573 nfo, Node: md5s │ │ │ │ │ +0002fdb0: 756d 2c20 204e 6578 743a 206d 6f64 756c um, Next: modul │ │ │ │ │ +0002fdc0: 652c 2020 5072 6576 3a20 6c73 6d6f 642c e, Prev: lsmod, │ │ │ │ │ +0002fdd0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ +0002fde0: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ +0002fdf0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ +0002fe00: 2e34 3820 6d64 3573 756d 0a2d 2d2d 2d2d .48 md5sum.----- │ │ │ │ │ +0002fe10: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ +0002fe20: 6f6d 6d61 6e64 3a20 6d64 3573 756d 2061 ommand: md5sum a │ │ │ │ │ +0002fe30: 7267 202e 2e2e 0a20 2020 2020 416c 6961 rg .... Alia │ │ │ │ │ +0002fe40: 7320 666f 7220 2768 6173 6873 756d 202d s for 'hashsum - │ │ │ │ │ +0002fe50: 2d68 6173 6820 6d64 3520 6172 6720 2e2e -hash md5 arg .. │ │ │ │ │ +0002fe60: 2e27 2e20 2053 6565 2063 6f6d 6d61 6e64 .'. See command │ │ │ │ │ +0002fe70: 2027 6861 7368 7375 6d27 0a20 2020 2020 'hashsum'. │ │ │ │ │ +0002fe80: 282a 6e6f 7465 2068 6173 6873 756d 3a3a (*note hashsum:: │ │ │ │ │ +0002fe90: 2920 666f 7220 6675 6c6c 2064 6573 6372 ) for full descr │ │ │ │ │ +0002fea0: 6970 7469 6f6e 2e0a 0a1f 0a46 696c 653a iption.....File: │ │ │ │ │ +0002feb0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0002fec0: 653a 206d 6f64 756c 652c 2020 4e65 7874 e: module, Next │ │ │ │ │ +0002fed0: 3a20 6d75 6c74 6962 6f6f 742c 2020 5072 : multiboot, Pr │ │ │ │ │ +0002fee0: 6576 3a20 6d64 3573 756d 2c20 2055 703a ev: md5sum, Up: │ │ │ │ │ +0002fef0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +0002ff00: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +0002ff10: 6d61 6e64 730a 0a31 362e 332e 3439 206d mands..16.3.49 m │ │ │ │ │ +0002ff20: 6f64 756c 650a 2d2d 2d2d 2d2d 2d2d 2d2d odule.---------- │ │ │ │ │ +0002ff30: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +0002ff40: 643a 206d 6f64 756c 6520 5b2d 2d6e 6f75 d: module [--nou │ │ │ │ │ +0002ff50: 6e7a 6970 5d20 6669 6c65 205b 6172 6775 nzip] file [argu │ │ │ │ │ +0002ff60: 6d65 6e74 735d 0a20 2020 2020 4c6f 6164 ments]. Load │ │ │ │ │ +0002ff70: 2061 206d 6f64 756c 6520 666f 7220 6d75 a module for mu │ │ │ │ │ +0002ff80: 6c74 6962 6f6f 7420 6b65 726e 656c 2069 ltiboot kernel i │ │ │ │ │ +0002ff90: 6d61 6765 2e20 2054 6865 2072 6573 7420 mage. The rest │ │ │ │ │ +0002ffa0: 6f66 2074 6865 206c 696e 6520 6973 0a20 of the line is. │ │ │ │ │ +0002ffb0: 2020 2020 7061 7373 6564 2076 6572 6261 passed verba │ │ │ │ │ +0002ffc0: 7469 6d20 6173 2074 6865 206d 6f64 756c tim as the modul │ │ │ │ │ +0002ffd0: 6520 636f 6d6d 616e 6420 6c69 6e65 2e0a e command line.. │ │ │ │ │ +0002ffe0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +0002fff0: 666f 2c20 204e 6f64 653a 206d 756c 7469 fo, Node: multi │ │ │ │ │ +00030000: 626f 6f74 2c20 204e 6578 743a 206e 6174 boot, Next: nat │ │ │ │ │ +00030010: 6976 6564 6973 6b2c 2020 5072 6576 3a20 ivedisk, Prev: │ │ │ │ │ +00030020: 6d6f 6475 6c65 2c20 2055 703a 2043 6f6d module, Up: Com │ │ │ │ │ +00030030: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ +00030040: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ +00030050: 730a 0a31 362e 332e 3530 206d 756c 7469 s..16.3.50 multi │ │ │ │ │ +00030060: 626f 6f74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d boot.----------- │ │ │ │ │ +00030070: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +00030080: 616e 643a 206d 756c 7469 626f 6f74 205b and: multiboot [ │ │ │ │ │ +00030090: 2d2d 7175 6972 6b2d 6261 642d 6b6c 7564 --quirk-bad-klud │ │ │ │ │ +000300a0: 6765 5d0a 2020 2020 2020 2020 2020 5b2d ge]. [- │ │ │ │ │ +000300b0: 2d71 7569 726b 2d6d 6f64 756c 6573 2d61 -quirk-modules-a │ │ │ │ │ +000300c0: 6674 6572 2d6b 6572 6e65 6c5d 2066 696c fter-kernel] fil │ │ │ │ │ +000300d0: 6520 2e2e 2e0a 2020 2020 204c 6f61 6420 e .... Load │ │ │ │ │ +000300e0: 6120 6d75 6c74 6962 6f6f 7420 6b65 726e a multiboot kern │ │ │ │ │ +000300f0: 656c 2069 6d61 6765 2066 726f 6d20 4649 el image from FI │ │ │ │ │ +00030100: 4c45 2e20 2054 6865 2072 6573 7420 6f66 LE. The rest of │ │ │ │ │ +00030110: 2074 6865 206c 696e 6520 6973 0a20 2020 the line is. │ │ │ │ │ +00030120: 2020 7061 7373 6564 2076 6572 6261 7469 passed verbati │ │ │ │ │ +00030130: 6d20 6173 2074 6865 2022 6b65 726e 656c m as the "kernel │ │ │ │ │ +00030140: 2063 6f6d 6d61 6e64 2d6c 696e 6522 2e20 command-line". │ │ │ │ │ +00030150: 2041 6e79 206d 6f64 756c 6520 6d75 7374 Any module must │ │ │ │ │ +00030160: 2062 650a 2020 2020 2072 656c 6f61 6465 be. reloade │ │ │ │ │ +00030170: 6420 6166 7465 7220 7573 696e 6720 7468 d after using th │ │ │ │ │ +00030180: 6973 2063 6f6d 6d61 6e64 2028 2a6e 6f74 is command (*not │ │ │ │ │ +00030190: 6520 6d6f 6475 6c65 3a3a 292e 0a0a 2020 e module::)... │ │ │ │ │ +000301a0: 2020 2053 6f6d 6520 6b65 726e 656c 7320 Some kernels │ │ │ │ │ +000301b0: 6861 7665 206b 6e6f 776e 2070 726f 626c have known probl │ │ │ │ │ +000301c0: 656d 732e 2020 596f 7520 6e65 6564 2074 ems. You need t │ │ │ │ │ +000301d0: 6f20 7370 6563 6966 7920 2d71 7569 726b o specify -quirk │ │ │ │ │ +000301e0: 2d2a 2066 6f72 0a20 2020 2020 7468 6f73 -* for. thos │ │ │ │ │ +000301f0: 652e 2020 2d71 7569 726b 2d62 6164 2d6b e. -quirk-bad-k │ │ │ │ │ +00030200: 6c75 6467 6520 6973 2061 2070 726f 626c ludge is a probl │ │ │ │ │ +00030210: 656d 2073 6565 6e20 696e 2073 6576 6572 em seen in sever │ │ │ │ │ +00030220: 616c 2070 726f 6475 6374 730a 2020 2020 al products. │ │ │ │ │ +00030230: 2074 6861 7420 7468 6579 2069 6e63 6c75 that they inclu │ │ │ │ │ +00030240: 6465 206c 6f61 6469 6e67 206b 6c75 6467 de loading kludg │ │ │ │ │ +00030250: 6520 696e 666f 726d 6174 696f 6e20 7769 e information wi │ │ │ │ │ +00030260: 7468 2069 6e76 616c 6964 2064 6174 6120 th invalid data │ │ │ │ │ +00030270: 696e 0a20 2020 2020 454c 4620 6669 6c65 in. ELF file │ │ │ │ │ +00030280: 2e20 2047 5255 4220 7072 696f 7220 746f . GRUB prior to │ │ │ │ │ +00030290: 2030 2e39 3720 616e 6420 736f 6d65 2063 0.97 and some c │ │ │ │ │ +000302a0: 7573 746f 6d20 6275 696c 6473 2070 7265 ustom builds pre │ │ │ │ │ +000302b0: 6665 7272 6564 2045 4c46 0a20 2020 2020 ferred ELF. │ │ │ │ │ +000302c0: 696e 666f 726d 6174 696f 6e20 7768 696c information whil │ │ │ │ │ +000302d0: 6520 302e 3937 2061 6e64 2047 5255 4220 e 0.97 and GRUB │ │ │ │ │ +000302e0: 3220 7573 6520 6b6c 7564 6765 2e20 2055 2 use kludge. U │ │ │ │ │ +000302f0: 7365 2074 6869 7320 6f70 7469 6f6e 2074 se this option t │ │ │ │ │ +00030300: 6f0a 2020 2020 2069 676e 6f72 6520 6b6c o. ignore kl │ │ │ │ │ +00030310: 7564 6765 2e20 204b 6e6f 776e 2061 6666 udge. Known aff │ │ │ │ │ +00030320: 6563 7465 6420 7379 7374 656d 733a 206f ected systems: o │ │ │ │ │ +00030330: 6c64 2053 6f6c 6172 6973 2c20 536b 794f ld Solaris, SkyO │ │ │ │ │ +00030340: 532e 0a0a 2020 2020 202d 7175 6972 6b2d S... -quirk- │ │ │ │ │ +00030350: 6d6f 6475 6c65 732d 6166 7465 722d 6b65 modules-after-ke │ │ │ │ │ +00030360: 726e 656c 2069 7320 6e65 6564 6564 2066 rnel is needed f │ │ │ │ │ +00030370: 6f72 206b 6572 6e65 6c73 2077 6869 6368 or kernels which │ │ │ │ │ +00030380: 206c 6f61 6420 6174 0a20 2020 2020 7265 load at. re │ │ │ │ │ +00030390: 6c61 7469 7665 6c79 2068 6967 6820 6164 latively high ad │ │ │ │ │ +000303a0: 6472 6573 7320 652e 672e 2020 3136 4d69 dress e.g. 16Mi │ │ │ │ │ +000303b0: 4220 6d61 726b 2061 6e64 2063 616e 2774 B mark and can't │ │ │ │ │ +000303c0: 2063 6f70 6520 7769 7468 0a20 2020 2020 cope with. │ │ │ │ │ +000303d0: 6d6f 6475 6c65 7320 7374 7566 6665 6420 modules stuffed │ │ │ │ │ +000303e0: 6265 7477 6565 6e20 314d 6942 206d 6172 between 1MiB mar │ │ │ │ │ +000303f0: 6b20 616e 6420 6265 6769 6e6e 696e 6720 k and beginning │ │ │ │ │ +00030400: 6f66 2074 6865 206b 6572 6e65 6c2e 0a20 of the kernel.. │ │ │ │ │ +00030410: 2020 2020 4b6e 6f77 6e20 6166 6674 6563 Known afftec │ │ │ │ │ +00030420: 7465 6420 7379 7374 656d 733a 2056 4d57 ted systems: VMW │ │ │ │ │ +00030430: 6172 652e 0a0a 1f0a 4669 6c65 3a20 6772 are.....File: gr │ │ │ │ │ +00030440: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00030450: 6e61 7469 7665 6469 736b 2c20 204e 6578 nativedisk, Nex │ │ │ │ │ +00030460: 743a 206e 6f72 6d61 6c2c 2020 5072 6576 t: normal, Prev │ │ │ │ │ +00030470: 3a20 6d75 6c74 6962 6f6f 742c 2020 5570 : multiboot, Up │ │ │ │ │ +00030480: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +00030490: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +000304a0: 6d6d 616e 6473 0a0a 3136 2e33 2e35 3120 mmands..16.3.51 │ │ │ │ │ +000304b0: 6e61 7469 7665 6469 736b 0a2d 2d2d 2d2d nativedisk.----- │ │ │ │ │ +000304c0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +000304d0: 2d2d 2043 6f6d 6d61 6e64 3a20 6e61 7469 -- Command: nati │ │ │ │ │ +000304e0: 7665 6469 736b 0a20 2020 2020 5377 6974 vedisk. Swit │ │ │ │ │ +000304f0: 6368 2066 726f 6d20 6669 726d 7761 7265 ch from firmware │ │ │ │ │ +00030500: 2064 6973 6b20 6472 6976 6572 7320 746f disk drivers to │ │ │ │ │ +00030510: 206e 6174 6976 6520 6f6e 6573 2e20 2052 native ones. R │ │ │ │ │ +00030520: 6561 6c6c 7920 7573 6566 756c 0a20 2020 eally useful. │ │ │ │ │ +00030530: 2020 6f6e 6c79 206f 6e20 706c 6174 666f only on platfo │ │ │ │ │ +00030540: 726d 7320 7768 6572 6520 626f 7468 2066 rms where both f │ │ │ │ │ +00030550: 6972 6d77 6172 6520 616e 6420 6e61 7469 irmware and nati │ │ │ │ │ +00030560: 7665 2064 6973 6b20 6472 6976 6573 2061 ve disk drives a │ │ │ │ │ +00030570: 7265 0a20 2020 2020 6176 6169 6c61 626c re. availabl │ │ │ │ │ +00030580: 652e 2020 4375 7272 656e 746c 7920 6933 e. Currently i3 │ │ │ │ │ +00030590: 3836 2d70 632c 2069 3338 362d 6566 692c 86-pc, i386-efi, │ │ │ │ │ +000305a0: 2069 3338 362d 6965 6565 3132 3735 2061 i386-ieee1275 a │ │ │ │ │ +000305b0: 6e64 0a20 2020 2020 7838 365f 3634 2d65 nd. x86_64-e │ │ │ │ │ +000305c0: 6669 2e0a 0a1f 0a46 696c 653a 2067 7275 fi.....File: gru │ │ │ │ │ +000305d0: 622e 696e 666f 2c20 204e 6f64 653a 206e b.info, Node: n │ │ │ │ │ +000305e0: 6f72 6d61 6c2c 2020 4e65 7874 3a20 6e6f ormal, Next: no │ │ │ │ │ +000305f0: 726d 616c 5f65 7869 742c 2020 5072 6576 rmal_exit, Prev │ │ │ │ │ +00030600: 3a20 6e61 7469 7665 6469 736b 2c20 2055 : nativedisk, U │ │ │ │ │ +00030610: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ +00030620: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ +00030630: 6f6d 6d61 6e64 730a 0a31 362e 332e 3532 ommands..16.3.52 │ │ │ │ │ +00030640: 206e 6f72 6d61 6c0a 2d2d 2d2d 2d2d 2d2d normal.-------- │ │ │ │ │ +00030650: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +00030660: 616e 643a 206e 6f72 6d61 6c20 5b66 696c and: normal [fil │ │ │ │ │ +00030670: 655d 0a20 2020 2020 456e 7465 7220 6e6f e]. Enter no │ │ │ │ │ +00030680: 726d 616c 206d 6f64 6520 616e 6420 6469 rmal mode and di │ │ │ │ │ +00030690: 7370 6c61 7920 7468 6520 4752 5542 206d splay the GRUB m │ │ │ │ │ +000306a0: 656e 752e 0a0a 2020 2020 2049 6e20 6e6f enu... In no │ │ │ │ │ +000306b0: 726d 616c 206d 6f64 652c 2063 6f6d 6d61 rmal mode, comma │ │ │ │ │ +000306c0: 6e64 732c 2066 696c 6573 7973 7465 6d20 nds, filesystem │ │ │ │ │ +000306d0: 6d6f 6475 6c65 732c 2061 6e64 2063 7279 modules, and cry │ │ │ │ │ +000306e0: 7074 6f67 7261 7068 790a 2020 2020 206d ptography. m │ │ │ │ │ +000306f0: 6f64 756c 6573 2061 7265 2061 7574 6f6d odules are autom │ │ │ │ │ +00030700: 6174 6963 616c 6c79 206c 6f61 6465 642c atically loaded, │ │ │ │ │ +00030710: 2061 6e64 2074 6865 2066 756c 6c20 4752 and the full GR │ │ │ │ │ +00030720: 5542 2073 6372 6970 7420 7061 7273 6572 UB script parser │ │ │ │ │ +00030730: 0a20 2020 2020 6973 2061 7661 696c 6162 . is availab │ │ │ │ │ +00030740: 6c65 2e20 204f 7468 6572 206d 6f64 756c le. Other modul │ │ │ │ │ +00030750: 6573 206d 6179 2062 6520 6578 706c 6963 es may be explic │ │ │ │ │ +00030760: 6974 6c79 206c 6f61 6465 6420 7573 696e itly loaded usin │ │ │ │ │ +00030770: 670a 2020 2020 2027 696e 736d 6f64 2720 g. 'insmod' │ │ │ │ │ +00030780: 282a 6e6f 7465 2069 6e73 6d6f 643a 3a29 (*note insmod::) │ │ │ │ │ +00030790: 2e0a 0a20 2020 2020 4966 2061 2046 494c ... If a FIL │ │ │ │ │ +000307a0: 4520 6973 2067 6976 656e 2c20 7468 656e E is given, then │ │ │ │ │ +000307b0: 2063 6f6d 6d61 6e64 7320 7769 6c6c 2062 commands will b │ │ │ │ │ +000307c0: 6520 7265 6164 2066 726f 6d20 7468 6174 e read from that │ │ │ │ │ +000307d0: 2066 696c 652e 0a20 2020 2020 4f74 6865 file.. Othe │ │ │ │ │ +000307e0: 7277 6973 652c 2074 6865 7920 7769 6c6c rwise, they will │ │ │ │ │ +000307f0: 2062 6520 7265 6164 2066 726f 6d20 2724 be read from '$ │ │ │ │ │ +00030800: 7072 6566 6978 2f67 7275 622e 6366 6727 prefix/grub.cfg' │ │ │ │ │ +00030810: 2069 6620 6974 2065 7869 7374 732e 0a0a if it exists... │ │ │ │ │ +00030820: 2020 2020 2027 6e6f 726d 616c 2720 6d61 'normal' ma │ │ │ │ │ +00030830: 7920 6265 2063 616c 6c65 6420 6672 6f6d y be called from │ │ │ │ │ +00030840: 2077 6974 6869 6e20 6e6f 726d 616c 206d within normal m │ │ │ │ │ +00030850: 6f64 652c 2063 7265 6174 696e 6720 6120 ode, creating a │ │ │ │ │ +00030860: 6e65 7374 6564 0a20 2020 2020 656e 7669 nested. envi │ │ │ │ │ +00030870: 726f 6e6d 656e 742e 2020 4974 2069 7320 ronment. It is │ │ │ │ │ +00030880: 6d6f 7265 2075 7375 616c 2074 6f20 7573 more usual to us │ │ │ │ │ +00030890: 6520 2763 6f6e 6669 6766 696c 6527 2028 e 'configfile' ( │ │ │ │ │ +000308a0: 2a6e 6f74 650a 2020 2020 2063 6f6e 6669 *note. confi │ │ │ │ │ +000308b0: 6766 696c 653a 3a29 2066 6f72 2074 6869 gfile::) for thi │ │ │ │ │ +000308c0: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ +000308d0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e6f .info, Node: no │ │ │ │ │ +000308e0: 726d 616c 5f65 7869 742c 2020 4e65 7874 rmal_exit, Next │ │ │ │ │ +000308f0: 3a20 7061 7274 746f 6f6c 2c20 2050 7265 : parttool, Pre │ │ │ │ │ +00030900: 763a 206e 6f72 6d61 6c2c 2020 5570 3a20 v: normal, Up: │ │ │ │ │ +00030910: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00030920: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00030930: 616e 6473 0a0a 3136 2e33 2e35 3320 6e6f ands..16.3.53 no │ │ │ │ │ +00030940: 726d 616c 5f65 7869 740a 2d2d 2d2d 2d2d rmal_exit.------ │ │ │ │ │ +00030950: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +00030960: 2d2d 2043 6f6d 6d61 6e64 3a20 6e6f 726d -- Command: norm │ │ │ │ │ +00030970: 616c 5f65 7869 740a 2020 2020 2045 7869 al_exit. Exi │ │ │ │ │ +00030980: 7420 6e6f 726d 616c 206d 6f64 6520 282a t normal mode (* │ │ │ │ │ +00030990: 6e6f 7465 206e 6f72 6d61 6c3a 3a29 2e20 note normal::). │ │ │ │ │ +000309a0: 2049 6620 7468 6973 2069 6e73 7461 6e63 If this instanc │ │ │ │ │ +000309b0: 6520 6f66 206e 6f72 6d61 6c20 6d6f 6465 e of normal mode │ │ │ │ │ +000309c0: 0a20 2020 2020 7761 7320 6e6f 7420 6e65 . was not ne │ │ │ │ │ +000309d0: 7374 6564 2077 6974 6869 6e20 616e 6f74 sted within anot │ │ │ │ │ +000309e0: 6865 7220 6f6e 652c 2074 6865 6e20 7265 her one, then re │ │ │ │ │ +000309f0: 7475 726e 2074 6f20 7265 7363 7565 206d turn to rescue m │ │ │ │ │ +00030a00: 6f64 652e 0a0a 1f0a 4669 6c65 3a20 6772 ode.....File: gr │ │ │ │ │ +00030a10: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00030a20: 7061 7274 746f 6f6c 2c20 204e 6578 743a parttool, Next: │ │ │ │ │ +00030a30: 2070 6173 7377 6f72 642c 2020 5072 6576 password, Prev │ │ │ │ │ +00030a40: 3a20 6e6f 726d 616c 5f65 7869 742c 2020 : normal_exit, │ │ │ │ │ +00030a50: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ +00030a60: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ +00030a70: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e35 commands..16.3.5 │ │ │ │ │ +00030a80: 3420 7061 7274 746f 6f6c 0a2d 2d2d 2d2d 4 parttool.----- │ │ │ │ │ +00030a90: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +00030aa0: 2043 6f6d 6d61 6e64 3a20 7061 7274 746f Command: partto │ │ │ │ │ +00030ab0: 6f6c 2070 6172 7469 7469 6f6e 2063 6f6d ol partition com │ │ │ │ │ +00030ac0: 6d61 6e64 730a 2020 2020 204d 616b 6520 mands. Make │ │ │ │ │ +00030ad0: 7661 7269 6f75 7320 6d6f 6469 6669 6361 various modifica │ │ │ │ │ +00030ae0: 7469 6f6e 7320 746f 2070 6172 7469 7469 tions to partiti │ │ │ │ │ +00030af0: 6f6e 2074 6162 6c65 2065 6e74 7269 6573 on table entries │ │ │ │ │ +00030b00: 2e0a 0a20 2020 2020 4561 6368 2043 4f4d ... Each COM │ │ │ │ │ +00030b10: 4d41 4e44 2069 7320 6569 7468 6572 2061 MAND is either a │ │ │ │ │ +00030b20: 2062 6f6f 6c65 616e 206f 7074 696f 6e2c boolean option, │ │ │ │ │ +00030b30: 2069 6e20 7768 6963 6820 6361 7365 2069 in which case i │ │ │ │ │ +00030b40: 7420 6d75 7374 2062 650a 2020 2020 2066 t must be. f │ │ │ │ │ +00030b50: 6f6c 6c6f 7765 6420 7769 7468 2027 2b27 ollowed with '+' │ │ │ │ │ +00030b60: 206f 7220 272d 2720 2877 6974 6820 6e6f or '-' (with no │ │ │ │ │ +00030b70: 2069 6e74 6572 7665 6e69 6e67 2073 7061 intervening spa │ │ │ │ │ +00030b80: 6365 2920 746f 2065 6e61 626c 6520 6f72 ce) to enable or │ │ │ │ │ +00030b90: 0a20 2020 2020 6469 7361 626c 6520 7468 . disable th │ │ │ │ │ +00030ba0: 6174 206f 7074 696f 6e2c 206f 7220 656c at option, or el │ │ │ │ │ +00030bb0: 7365 2069 7420 7461 6b65 7320 6120 7661 se it takes a va │ │ │ │ │ +00030bc0: 6c75 6520 696e 2074 6865 2066 6f72 6d0a lue in the form. │ │ │ │ │ +00030bd0: 2020 2020 2027 434f 4d4d 414e 443d 5641 'COMMAND=VA │ │ │ │ │ +00030be0: 4c55 4527 2e0a 0a20 2020 2020 4375 7272 LUE'... Curr │ │ │ │ │ +00030bf0: 656e 746c 792c 2027 7061 7274 746f 6f6c ently, 'parttool │ │ │ │ │ +00030c00: 2720 6973 206f 6e6c 7920 7573 6566 756c ' is only useful │ │ │ │ │ +00030c10: 206f 6e20 444f 5320 7061 7274 6974 696f on DOS partitio │ │ │ │ │ +00030c20: 6e20 7461 626c 6573 2028 616c 736f 0a20 n tables (also. │ │ │ │ │ +00030c30: 2020 2020 6b6e 6f77 6e20 6173 204d 6173 known as Mas │ │ │ │ │ +00030c40: 7465 7220 426f 6f74 2052 6563 6f72 642c ter Boot Record, │ │ │ │ │ +00030c50: 206f 7220 4d42 5229 2e20 4f6e 2074 6865 or MBR). On the │ │ │ │ │ +00030c60: 7365 2070 6172 7469 7469 6f6e 2074 6162 se partition tab │ │ │ │ │ +00030c70: 6c65 732c 0a20 2020 2020 7468 6520 666f les,. the fo │ │ │ │ │ +00030c80: 6c6c 6f77 696e 6720 636f 6d6d 616e 6473 llowing commands │ │ │ │ │ +00030c90: 2061 7265 2061 7661 696c 6162 6c65 3a0a are available:. │ │ │ │ │ +00030ca0: 0a20 2020 2020 2762 6f6f 7427 2028 626f . 'boot' (bo │ │ │ │ │ +00030cb0: 6f6c 6561 6e29 0a20 2020 2020 2020 2020 olean). │ │ │ │ │ +00030cc0: 2057 6865 6e20 656e 6162 6c65 642c 2074 When enabled, t │ │ │ │ │ +00030cd0: 6869 7320 6d61 6b65 7320 7468 6520 7365 his makes the se │ │ │ │ │ +00030ce0: 6c65 6374 6564 2070 6172 7469 7469 6f6e lected partition │ │ │ │ │ +00030cf0: 2062 6520 7468 6520 6163 7469 7665 0a20 be the active. │ │ │ │ │ +00030d00: 2020 2020 2020 2020 2028 626f 6f74 6162 (bootab │ │ │ │ │ +00030d10: 6c65 2920 7061 7274 6974 696f 6e20 6f6e le) partition on │ │ │ │ │ +00030d20: 2069 7473 2064 6973 6b2c 2063 6c65 6172 its disk, clear │ │ │ │ │ +00030d30: 696e 6720 7468 6520 6163 7469 7665 2066 ing the active f │ │ │ │ │ +00030d40: 6c61 6720 6f6e 0a20 2020 2020 2020 2020 lag on. │ │ │ │ │ +00030d50: 2061 6c6c 206f 7468 6572 2070 6172 7469 all other parti │ │ │ │ │ +00030d60: 7469 6f6e 732e 2020 5468 6973 2063 6f6d tions. This com │ │ │ │ │ +00030d70: 6d61 6e64 2069 7320 6c69 6d69 7465 6420 mand is limited │ │ │ │ │ +00030d80: 746f 205f 7072 696d 6172 795f 0a20 2020 to _primary_. │ │ │ │ │ +00030d90: 2020 2020 2020 2070 6172 7469 7469 6f6e partition │ │ │ │ │ +00030da0: 732e 0a0a 2020 2020 2027 7479 7065 2720 s... 'type' │ │ │ │ │ +00030db0: 2876 616c 7565 290a 2020 2020 2020 2020 (value). │ │ │ │ │ +00030dc0: 2020 4368 616e 6765 2074 6865 2074 7970 Change the typ │ │ │ │ │ +00030dd0: 6520 6f66 2061 6e20 6578 6973 7469 6e67 e of an existing │ │ │ │ │ +00030de0: 2070 6172 7469 7469 6f6e 2e20 2054 6865 partition. The │ │ │ │ │ +00030df0: 2076 616c 7565 206d 7573 7420 6265 2061 value must be a │ │ │ │ │ +00030e00: 0a20 2020 2020 2020 2020 206e 756d 6265 . numbe │ │ │ │ │ +00030e10: 7220 696e 2074 6865 2072 616e 6765 2030 r in the range 0 │ │ │ │ │ +00030e20: 2d30 7846 4620 2870 7265 6669 7820 7769 -0xFF (prefix wi │ │ │ │ │ +00030e30: 7468 2027 3078 2720 746f 2065 6e74 6572 th '0x' to enter │ │ │ │ │ +00030e40: 2069 7420 696e 0a20 2020 2020 2020 2020 it in. │ │ │ │ │ +00030e50: 2068 6578 6164 6563 696d 616c 292e 0a0a hexadecimal)... │ │ │ │ │ +00030e60: 2020 2020 2027 6869 6464 656e 2720 2862 'hidden' (b │ │ │ │ │ +00030e70: 6f6f 6c65 616e 290a 2020 2020 2020 2020 oolean). │ │ │ │ │ +00030e80: 2020 5768 656e 2065 6e61 626c 6564 2c20 When enabled, │ │ │ │ │ +00030e90: 7468 6973 2068 6964 6573 2074 6865 2073 this hides the s │ │ │ │ │ +00030ea0: 656c 6563 7465 6420 7061 7274 6974 696f elected partitio │ │ │ │ │ +00030eb0: 6e20 6279 2073 6574 7469 6e67 2074 6865 n by setting the │ │ │ │ │ +00030ec0: 0a20 2020 2020 2020 2020 2022 6869 6464 . "hidd │ │ │ │ │ +00030ed0: 656e 2220 6269 7420 696e 2069 7473 2070 en" bit in its p │ │ │ │ │ +00030ee0: 6172 7469 7469 6f6e 2074 7970 6520 636f artition type co │ │ │ │ │ +00030ef0: 6465 3b20 7768 656e 2064 6973 6162 6c65 de; when disable │ │ │ │ │ +00030f00: 642c 0a20 2020 2020 2020 2020 2075 6e68 d,. unh │ │ │ │ │ +00030f10: 6964 6573 2074 6865 2073 656c 6563 7465 ides the selecte │ │ │ │ │ +00030f20: 6420 7061 7274 6974 696f 6e20 6279 2063 d partition by c │ │ │ │ │ +00030f30: 6c65 6172 696e 6720 7468 6973 2062 6974 learing this bit │ │ │ │ │ +00030f40: 2e20 2054 6869 7320 6973 0a20 2020 2020 . This is. │ │ │ │ │ +00030f50: 2020 2020 2075 7365 6675 6c20 6f6e 6c79 useful only │ │ │ │ │ +00030f60: 2077 6865 6e20 626f 6f74 696e 6720 444f when booting DO │ │ │ │ │ +00030f70: 5320 6f72 2057 696e 646f 7773 2061 6e64 S or Windows and │ │ │ │ │ +00030f80: 206d 756c 7469 706c 6520 7072 696d 6172 multiple primar │ │ │ │ │ +00030f90: 790a 2020 2020 2020 2020 2020 4641 5420 y. FAT │ │ │ │ │ +00030fa0: 7061 7274 6974 696f 6e73 2065 7869 7374 partitions exist │ │ │ │ │ +00030fb0: 2069 6e20 6f6e 6520 6469 736b 2e20 2053 in one disk. S │ │ │ │ │ +00030fc0: 6565 2061 6c73 6f20 2a6e 6f74 650a 2020 ee also *note. │ │ │ │ │ +00030fd0: 2020 2020 2020 2020 444f 532f 5769 6e64 DOS/Wind │ │ │ │ │ +00030fe0: 6f77 733a 3a2e 0a0a 1f0a 4669 6c65 3a20 ows::.....File: │ │ │ │ │ +00030ff0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00031000: 3a20 7061 7373 776f 7264 2c20 204e 6578 : password, Nex │ │ │ │ │ +00031010: 743a 2070 6173 7377 6f72 645f 7062 6b64 t: password_pbkd │ │ │ │ │ +00031020: 6632 2c20 2050 7265 763a 2070 6172 7474 f2, Prev: partt │ │ │ │ │ +00031030: 6f6f 6c2c 2020 5570 3a20 436f 6d6d 616e ool, Up: Comman │ │ │ │ │ +00031040: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ +00031050: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ │ +00031060: 3136 2e33 2e35 3520 7061 7373 776f 7264 16.3.55 password │ │ │ │ │ +00031070: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d .--------------- │ │ │ │ │ +00031080: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00031090: 7061 7373 776f 7264 2075 7365 7220 636c password user cl │ │ │ │ │ +000310a0: 6561 722d 7061 7373 776f 7264 0a20 2020 ear-password. │ │ │ │ │ +000310b0: 2020 4465 6669 6e65 2061 2075 7365 7220 Define a user │ │ │ │ │ +000310c0: 6e61 6d65 6420 5553 4552 2077 6974 6820 named USER with │ │ │ │ │ +000310d0: 7061 7373 776f 7264 2043 4c45 4152 2d50 password CLEAR-P │ │ │ │ │ +000310e0: 4153 5357 4f52 442e 2020 2a4e 6f74 650a ASSWORD. *Note. │ │ │ │ │ +000310f0: 2020 2020 2053 6563 7572 6974 793a 3a2e Security::. │ │ │ │ │ +00031100: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00031110: 6e66 6f2c 2020 4e6f 6465 3a20 7061 7373 nfo, Node: pass │ │ │ │ │ +00031120: 776f 7264 5f70 626b 6466 322c 2020 4e65 word_pbkdf2, Ne │ │ │ │ │ +00031130: 7874 3a20 706c 6179 2c20 2050 7265 763a xt: play, Prev: │ │ │ │ │ +00031140: 2070 6173 7377 6f72 642c 2020 5570 3a20 password, Up: │ │ │ │ │ +00031150: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00031160: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00031170: 616e 6473 0a0a 3136 2e33 2e35 3620 7061 ands..16.3.56 pa │ │ │ │ │ +00031180: 7373 776f 7264 5f70 626b 6466 320a 2d2d ssword_pbkdf2.-- │ │ │ │ │ 00031190: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000311a0: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -000311b0: 3a20 7061 7373 776f 7264 5f70 626b 6466 : password_pbkdf │ │ │ │ │ -000311c0: 3220 7573 6572 2068 6173 6865 642d 7061 2 user hashed-pa │ │ │ │ │ -000311d0: 7373 776f 7264 0a20 2020 2020 4465 6669 ssword. Defi │ │ │ │ │ -000311e0: 6e65 2061 2075 7365 7220 6e61 6d65 6420 ne a user named │ │ │ │ │ -000311f0: 5553 4552 2077 6974 6820 7061 7373 776f USER with passwo │ │ │ │ │ -00031200: 7264 2068 6173 6820 4841 5348 4544 2d50 rd hash HASHED-P │ │ │ │ │ -00031210: 4153 5357 4f52 442e 2020 5573 650a 2020 ASSWORD. Use. │ │ │ │ │ -00031220: 2020 2027 6772 7562 2d6d 6b70 6173 7377 'grub-mkpassw │ │ │ │ │ -00031230: 642d 7062 6b64 6632 2720 282a 6e6f 7465 d-pbkdf2' (*note │ │ │ │ │ -00031240: 2049 6e76 6f6b 696e 6720 6772 7562 2d6d Invoking grub-m │ │ │ │ │ -00031250: 6b70 6173 7377 642d 7062 6b64 6632 3a3a kpasswd-pbkdf2:: │ │ │ │ │ -00031260: 2920 746f 0a20 2020 2020 6765 6e65 7261 ) to. genera │ │ │ │ │ -00031270: 7465 2070 6173 7377 6f72 6420 6861 7368 te password hash │ │ │ │ │ -00031280: 6573 2e20 202a 4e6f 7465 2053 6563 7572 es. *Note Secur │ │ │ │ │ -00031290: 6974 793a 3a2e 0a0a 1f0a 4669 6c65 3a20 ity::.....File: │ │ │ │ │ -000312a0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -000312b0: 3a20 706c 6179 2c20 204e 6578 743a 2070 : play, Next: p │ │ │ │ │ -000312c0: 726f 6265 2c20 2050 7265 763a 2070 6173 robe, Prev: pas │ │ │ │ │ -000312d0: 7377 6f72 645f 7062 6b64 6632 2c20 2055 sword_pbkdf2, U │ │ │ │ │ -000312e0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -000312f0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -00031300: 6f6d 6d61 6e64 730a 0a31 362e 332e 3537 ommands..16.3.57 │ │ │ │ │ -00031310: 2070 6c61 790a 2d2d 2d2d 2d2d 2d2d 2d2d play.---------- │ │ │ │ │ -00031320: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -00031330: 2070 6c61 7920 6669 6c65 207c 2074 656d play file | tem │ │ │ │ │ -00031340: 706f 205b 7069 7463 6831 2064 7572 6174 po [pitch1 durat │ │ │ │ │ -00031350: 696f 6e31 5d20 5b70 6974 6368 3220 6475 ion1] [pitch2 du │ │ │ │ │ -00031360: 7261 7469 6f6e 325d 202e 2e2e 0a20 2020 ration2] .... │ │ │ │ │ -00031370: 2020 506c 6179 7320 6120 7475 6e65 0a0a Plays a tune.. │ │ │ │ │ -00031380: 2020 2020 2049 6620 7468 6520 6172 6775 If the argu │ │ │ │ │ -00031390: 6d65 6e74 2069 7320 6120 6669 6c65 206e ment is a file n │ │ │ │ │ -000313a0: 616d 6520 282a 6e6f 7465 2046 696c 6520 ame (*note File │ │ │ │ │ -000313b0: 6e61 6d65 2073 796e 7461 783a 3a29 2c20 name syntax::), │ │ │ │ │ -000313c0: 706c 6179 2074 6865 0a20 2020 2020 7475 play the. tu │ │ │ │ │ -000313d0: 6e65 2072 6563 6f72 6465 6420 696e 2069 ne recorded in i │ │ │ │ │ -000313e0: 742e 2020 5468 6520 6669 6c65 2066 6f72 t. The file for │ │ │ │ │ -000313f0: 6d61 7420 6973 2066 6972 7374 2074 6865 mat is first the │ │ │ │ │ -00031400: 2074 656d 706f 2061 7320 616e 0a20 2020 tempo as an. │ │ │ │ │ -00031410: 2020 756e 7369 676e 6564 2033 3262 6974 unsigned 32bit │ │ │ │ │ -00031420: 206c 6974 746c 652d 656e 6469 616e 206e little-endian n │ │ │ │ │ -00031430: 756d 6265 722c 2074 6865 6e20 7061 6972 umber, then pair │ │ │ │ │ -00031440: 7320 6f66 2075 6e73 6967 6e65 6420 3136 s of unsigned 16 │ │ │ │ │ -00031450: 6269 740a 2020 2020 206c 6974 746c 652d bit. little- │ │ │ │ │ -00031460: 656e 6469 616e 206e 756d 6265 7273 2066 endian numbers f │ │ │ │ │ -00031470: 6f72 2070 6974 6368 2061 6e64 2064 7572 or pitch and dur │ │ │ │ │ -00031480: 6174 696f 6e20 7061 6972 732e 0a0a 2020 ation pairs... │ │ │ │ │ -00031490: 2020 2049 6620 7468 6520 6172 6775 6d65 If the argume │ │ │ │ │ -000314a0: 6e74 7320 6172 6520 6120 7365 7269 6573 nts are a series │ │ │ │ │ -000314b0: 206f 6620 6e75 6d62 6572 732c 2070 6c61 of numbers, pla │ │ │ │ │ -000314c0: 7920 7468 6520 696e 6c69 6e65 2074 756e y the inline tun │ │ │ │ │ -000314d0: 652e 0a0a 2020 2020 2054 6865 2074 656d e... The tem │ │ │ │ │ -000314e0: 706f 2069 7320 7468 6520 6261 7365 2066 po is the base f │ │ │ │ │ -000314f0: 6f72 2061 6c6c 206e 6f74 6520 6475 7261 or all note dura │ │ │ │ │ -00031500: 7469 6f6e 732e 2020 3630 2067 6976 6573 tions. 60 gives │ │ │ │ │ -00031510: 2061 2031 2d73 6563 6f6e 640a 2020 2020 a 1-second. │ │ │ │ │ -00031520: 2062 6173 652c 2031 3230 2067 6976 6573 base, 120 gives │ │ │ │ │ -00031530: 2061 2068 616c 662d 7365 636f 6e64 2062 a half-second b │ │ │ │ │ -00031540: 6173 652c 2065 7463 2e20 2050 6974 6368 ase, etc. Pitch │ │ │ │ │ -00031550: 6573 2061 7265 2048 7a2e 2020 5365 740a es are Hz. Set. │ │ │ │ │ -00031560: 2020 2020 2070 6974 6368 2074 6f20 3020 pitch to 0 │ │ │ │ │ -00031570: 746f 2070 726f 6475 6365 2061 2072 6573 to produce a res │ │ │ │ │ -00031580: 742e 0a0a 1f0a 4669 6c65 3a20 6772 7562 t.....File: grub │ │ │ │ │ -00031590: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7072 .info, Node: pr │ │ │ │ │ -000315a0: 6f62 652c 2020 4e65 7874 3a20 7264 6d73 obe, Next: rdms │ │ │ │ │ -000315b0: 722c 2020 5072 6576 3a20 706c 6179 2c20 r, Prev: play, │ │ │ │ │ -000315c0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ -000315d0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ -000315e0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ -000315f0: 3538 2070 726f 6265 0a2d 2d2d 2d2d 2d2d 58 probe.------- │ │ │ │ │ -00031600: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -00031610: 616e 643a 2070 726f 6265 205b 2d2d 7365 and: probe [--se │ │ │ │ │ -00031620: 7420 7661 725d 0a20 2020 2020 2020 2020 t var]. │ │ │ │ │ -00031630: 202d 2d64 7269 7665 727c 2d2d 7061 7274 --driver|--part │ │ │ │ │ -00031640: 6d61 707c 2d2d 6673 7c2d 2d66 732d 7575 map|--fs|--fs-uu │ │ │ │ │ -00031650: 6964 7c2d 2d6c 6162 656c 7c2d 2d70 6172 id|--label|--par │ │ │ │ │ -00031660: 742d 7575 6964 2064 6576 6963 650a 2020 t-uuid device. │ │ │ │ │ -00031670: 2020 2052 6574 7269 6576 6520 6465 7669 Retrieve devi │ │ │ │ │ -00031680: 6365 2069 6e66 6f72 6d61 7469 6f6e 2e20 ce information. │ │ │ │ │ -00031690: 2049 6620 6f70 7469 6f6e 2027 2d2d 7365 If option '--se │ │ │ │ │ -000316a0: 7427 2069 7320 6769 7665 6e2c 2061 7373 t' is given, ass │ │ │ │ │ -000316b0: 6967 6e0a 2020 2020 2072 6573 756c 7420 ign. result │ │ │ │ │ -000316c0: 746f 2076 6172 6961 626c 6520 5641 522c to variable VAR, │ │ │ │ │ -000316d0: 206f 7468 6572 7769 7365 2070 7269 6e74 otherwise print │ │ │ │ │ -000316e0: 2069 6e66 6f72 6d61 7469 6f6e 206f 6e20 information on │ │ │ │ │ -000316f0: 7468 6520 7363 7265 656e 2e0a 0a20 2020 the screen... │ │ │ │ │ -00031700: 2020 5468 6520 6f70 7469 6f6e 2027 2d2d The option '-- │ │ │ │ │ -00031710: 7061 7274 2d75 7569 6427 2069 7320 6375 part-uuid' is cu │ │ │ │ │ -00031720: 7272 656e 746c 7920 6f6e 6c79 2069 6d70 rrently only imp │ │ │ │ │ -00031730: 6c65 6d65 6e74 6564 2066 6f72 204d 5344 lemented for MSD │ │ │ │ │ -00031740: 4f53 0a20 2020 2020 616e 6420 4750 5420 OS. and GPT │ │ │ │ │ -00031750: 666f 726d 6174 7465 6420 6469 736b 732e formatted disks. │ │ │ │ │ -00031760: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00031770: 6e66 6f2c 2020 4e6f 6465 3a20 7264 6d73 nfo, Node: rdms │ │ │ │ │ -00031780: 722c 2020 4e65 7874 3a20 7265 6164 2c20 r, Next: read, │ │ │ │ │ -00031790: 2050 7265 763a 2070 726f 6265 2c20 2055 Prev: probe, U │ │ │ │ │ -000317a0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -000317b0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -000317c0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3539 ommands..16.3.59 │ │ │ │ │ -000317d0: 2072 646d 7372 0a2d 2d2d 2d2d 2d2d 2d2d rdmsr.--------- │ │ │ │ │ -000317e0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -000317f0: 643a 3a20 7264 6d73 7220 3078 4144 4452 d:: rdmsr 0xADDR │ │ │ │ │ -00031800: 205b 2d76 2056 4152 4e41 4d45 5d0a 2020 [-v VARNAME]. │ │ │ │ │ -00031810: 2020 2052 6561 6420 6120 6d6f 6465 6c2d Read a model- │ │ │ │ │ -00031820: 7370 6563 6966 6963 2072 6567 6973 7465 specific registe │ │ │ │ │ -00031830: 7220 6174 2061 6464 7265 7373 2030 7841 r at address 0xA │ │ │ │ │ -00031840: 4444 522e 2049 6620 7468 6520 7061 7261 DDR. If the para │ │ │ │ │ -00031850: 6d65 7465 720a 2020 2020 2027 2d76 2720 meter. '-v' │ │ │ │ │ -00031860: 6973 2075 7365 6420 616e 6420 616e 2065 is used and an e │ │ │ │ │ -00031870: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ -00031880: 626c 6520 5641 524e 414d 4520 6973 2067 ble VARNAME is g │ │ │ │ │ -00031890: 6976 656e 2c20 7365 7420 7468 6174 0a20 iven, set that. │ │ │ │ │ -000318a0: 2020 2020 656e 7669 726f 6e6d 656e 7420 environment │ │ │ │ │ -000318b0: 7661 7269 6162 6c65 2074 6f20 7468 6520 variable to the │ │ │ │ │ -000318c0: 7661 6c75 6520 7468 6174 2077 6173 2072 value that was r │ │ │ │ │ -000318d0: 6561 642e 0a0a 2020 2020 2050 6c65 6173 ead... Pleas │ │ │ │ │ -000318e0: 6520 6e6f 7465 2074 6861 7420 6f6e 2053 e note that on S │ │ │ │ │ -000318f0: 4d50 2073 7973 7465 6d73 2c20 7265 6164 MP systems, read │ │ │ │ │ -00031900: 696e 6720 6672 6f6d 2061 204d 5352 2074 ing from a MSR t │ │ │ │ │ -00031910: 6861 7420 6861 7320 610a 2020 2020 2073 hat has a. s │ │ │ │ │ -00031920: 636f 7065 2070 6572 2068 6172 6477 6172 cope per hardwar │ │ │ │ │ -00031930: 6520 7468 7265 6164 2c20 696d 706c 6965 e thread, implie │ │ │ │ │ -00031940: 7320 7468 6174 2074 6865 2076 616c 7565 s that the value │ │ │ │ │ -00031950: 2074 6861 7420 6973 2072 6574 7572 6e65 that is returne │ │ │ │ │ -00031960: 640a 2020 2020 206f 6e6c 7920 6170 706c d. only appl │ │ │ │ │ -00031970: 6965 7320 746f 2074 6865 2070 6172 7469 ies to the parti │ │ │ │ │ -00031980: 6375 6c61 7220 6370 752f 636f 7265 2f74 cular cpu/core/t │ │ │ │ │ -00031990: 6872 6561 6420 7468 6174 2072 756e 7320 hread that runs │ │ │ │ │ -000319a0: 7468 650a 2020 2020 2063 6f6d 6d61 6e64 the. command │ │ │ │ │ -000319b0: 2e0a 0a20 2020 2020 416c 736f 2c20 6966 ... Also, if │ │ │ │ │ -000319c0: 2079 6f75 2073 7065 6369 6679 2061 2072 you specify a r │ │ │ │ │ -000319d0: 6573 6572 7665 6420 6f72 2075 6e69 6d70 eserved or unimp │ │ │ │ │ -000319e0: 6c65 6d65 6e74 6564 204d 5352 2061 6464 lemented MSR add │ │ │ │ │ -000319f0: 7265 7373 2c20 6974 0a20 2020 2020 7769 ress, it. wi │ │ │ │ │ -00031a00: 6c6c 2063 6175 7365 2061 2067 656e 6572 ll cause a gener │ │ │ │ │ -00031a10: 616c 2070 726f 7465 6374 696f 6e20 6578 al protection ex │ │ │ │ │ -00031a20: 6365 7074 696f 6e20 2877 6869 6368 2069 ception (which i │ │ │ │ │ -00031a30: 7320 6e6f 7420 6375 7272 656e 746c 790a s not currently. │ │ │ │ │ -00031a40: 2020 2020 2062 6569 6e67 2068 616e 646c being handl │ │ │ │ │ -00031a50: 6564 2920 616e 6420 7468 6520 7379 7374 ed) and the syst │ │ │ │ │ -00031a60: 656d 2077 696c 6c20 7265 626f 6f74 2e0a em will reboot.. │ │ │ │ │ -00031a70: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00031a80: 666f 2c20 204e 6f64 653a 2072 6561 642c fo, Node: read, │ │ │ │ │ -00031a90: 2020 4e65 7874 3a20 7265 626f 6f74 2c20 Next: reboot, │ │ │ │ │ -00031aa0: 2050 7265 763a 2072 646d 7372 2c20 2055 Prev: rdmsr, U │ │ │ │ │ -00031ab0: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -00031ac0: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -00031ad0: 6f6d 6d61 6e64 730a 0a31 362e 332e 3630 ommands..16.3.60 │ │ │ │ │ -00031ae0: 2072 6561 640a 2d2d 2d2d 2d2d 2d2d 2d2d read.---------- │ │ │ │ │ -00031af0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -00031b00: 2072 6561 6420 5b76 6172 5d0a 2020 2020 read [var]. │ │ │ │ │ -00031b10: 2052 6561 6420 6120 6c69 6e65 206f 6620 Read a line of │ │ │ │ │ -00031b20: 696e 7075 7420 6672 6f6d 2074 6865 2075 input from the u │ │ │ │ │ -00031b30: 7365 722e 2020 4966 2061 6e20 656e 7669 ser. If an envi │ │ │ │ │ -00031b40: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ -00031b50: 2056 4152 0a20 2020 2020 6973 2067 6976 VAR. is giv │ │ │ │ │ -00031b60: 656e 2c20 7365 7420 7468 6174 2065 6e76 en, set that env │ │ │ │ │ -00031b70: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -00031b80: 6520 746f 2074 6865 206c 696e 6520 6f66 e to the line of │ │ │ │ │ -00031b90: 2069 6e70 7574 2074 6861 740a 2020 2020 input that. │ │ │ │ │ -00031ba0: 2077 6173 2072 6561 642c 2077 6974 6820 was read, with │ │ │ │ │ -00031bb0: 6e6f 2074 6572 6d69 6e61 7469 6e67 206e no terminating n │ │ │ │ │ -00031bc0: 6577 6c69 6e65 2e0a 0a1f 0a46 696c 653a ewline.....File: │ │ │ │ │ -00031bd0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -00031be0: 653a 2072 6562 6f6f 742c 2020 4e65 7874 e: reboot, Next │ │ │ │ │ -00031bf0: 3a20 7265 6765 7870 2c20 2050 7265 763a : regexp, Prev: │ │ │ │ │ -00031c00: 2072 6561 642c 2020 5570 3a20 436f 6d6d read, Up: Comm │ │ │ │ │ -00031c10: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -00031c20: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -00031c30: 0a0a 3136 2e33 2e36 3120 7265 626f 6f74 ..16.3.61 reboot │ │ │ │ │ -00031c40: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a .--------------. │ │ │ │ │ -00031c50: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7265 . -- Command: re │ │ │ │ │ -00031c60: 626f 6f74 0a20 2020 2020 5265 626f 6f74 boot. Reboot │ │ │ │ │ -00031c70: 2074 6865 2063 6f6d 7075 7465 722e 0a0a the computer... │ │ │ │ │ -00031c80: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00031c90: 6f2c 2020 4e6f 6465 3a20 7265 6765 7870 o, Node: regexp │ │ │ │ │ -00031ca0: 2c20 204e 6578 743a 2072 6d6d 6f64 2c20 , Next: rmmod, │ │ │ │ │ -00031cb0: 2050 7265 763a 2072 6562 6f6f 742c 2020 Prev: reboot, │ │ │ │ │ -00031cc0: 5570 3a20 436f 6d6d 616e 642d 6c69 6e65 Up: Command-line │ │ │ │ │ -00031cd0: 2061 6e64 206d 656e 7520 656e 7472 7920 and menu entry │ │ │ │ │ -00031ce0: 636f 6d6d 616e 6473 0a0a 3136 2e33 2e36 commands..16.3.6 │ │ │ │ │ -00031cf0: 3220 7265 6765 7870 0a2d 2d2d 2d2d 2d2d 2 regexp.------- │ │ │ │ │ -00031d00: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ -00031d10: 6d61 6e64 3a20 7265 6765 7870 205b 2d2d mand: regexp [-- │ │ │ │ │ -00031d20: 7365 7420 5b6e 756d 6265 723a 5d76 6172 set [number:]var │ │ │ │ │ -00031d30: 5d20 7265 6765 7870 2073 7472 696e 670a ] regexp string. │ │ │ │ │ -00031d40: 2020 2020 2054 6573 7420 6966 2072 6567 Test if reg │ │ │ │ │ -00031d50: 756c 6172 2065 7870 7265 7373 696f 6e20 ular expression │ │ │ │ │ -00031d60: 5245 4745 5850 206d 6174 6368 6573 2053 REGEXP matches S │ │ │ │ │ -00031d70: 5452 494e 472e 2020 5375 7070 6f72 7465 TRING. Supporte │ │ │ │ │ -00031d80: 640a 2020 2020 2072 6567 756c 6172 2065 d. regular e │ │ │ │ │ -00031d90: 7870 7265 7373 696f 6e73 2061 7265 2050 xpressions are P │ │ │ │ │ -00031da0: 4f53 4958 2e32 2045 7874 656e 6465 6420 OSIX.2 Extended │ │ │ │ │ -00031db0: 5265 6775 6c61 7220 4578 7072 6573 7369 Regular Expressi │ │ │ │ │ -00031dc0: 6f6e 732e 2020 4966 0a20 2020 2020 6f70 ons. If. op │ │ │ │ │ -00031dd0: 7469 6f6e 2027 2d2d 7365 7427 2069 7320 tion '--set' is │ │ │ │ │ -00031de0: 6769 7665 6e2c 2073 746f 7265 204e 554d given, store NUM │ │ │ │ │ -00031df0: 4245 5274 6820 6d61 7463 6865 6420 7375 BERth matched su │ │ │ │ │ -00031e00: 6265 7870 7265 7373 696f 6e20 696e 0a20 bexpression in. │ │ │ │ │ -00031e10: 2020 2020 7661 7269 6162 6c65 2056 4152 variable VAR │ │ │ │ │ -00031e20: 2e20 2053 7562 6578 7072 6573 7369 6f6e . Subexpression │ │ │ │ │ -00031e30: 7320 6172 6520 6e75 6d62 6572 6564 2069 s are numbered i │ │ │ │ │ -00031e40: 6e20 6f72 6465 7220 6f66 2074 6865 6972 n order of their │ │ │ │ │ -00031e50: 0a20 2020 2020 6f70 656e 696e 6720 7061 . opening pa │ │ │ │ │ -00031e60: 7265 6e74 6865 7365 7320 7374 6172 7469 rentheses starti │ │ │ │ │ -00031e70: 6e67 2066 726f 6d20 2731 272e 2020 4e55 ng from '1'. NU │ │ │ │ │ -00031e80: 4d42 4552 2064 6566 6175 6c74 7320 746f MBER defaults to │ │ │ │ │ -00031e90: 2027 3127 2e0a 0a1f 0a46 696c 653a 2067 '1'.....File: g │ │ │ │ │ -00031ea0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00031eb0: 2072 6d6d 6f64 2c20 204e 6578 743a 2073 rmmod, Next: s │ │ │ │ │ -00031ec0: 6176 655f 656e 762c 2020 5072 6576 3a20 ave_env, Prev: │ │ │ │ │ -00031ed0: 7265 6765 7870 2c20 2055 703a 2043 6f6d regexp, Up: Com │ │ │ │ │ -00031ee0: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ -00031ef0: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ -00031f00: 730a 0a31 362e 332e 3633 2072 6d6d 6f64 s..16.3.63 rmmod │ │ │ │ │ -00031f10: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a .-------------.. │ │ │ │ │ -00031f20: 202d 2d20 436f 6d6d 616e 643a 2072 6d6d -- Command: rmm │ │ │ │ │ -00031f30: 6f64 206d 6f64 756c 650a 2020 2020 2052 od module. R │ │ │ │ │ -00031f40: 656d 6f76 6520 6120 6c6f 6164 6564 204d emove a loaded M │ │ │ │ │ -00031f50: 4f44 554c 452e 0a0a 1f0a 4669 6c65 3a20 ODULE.....File: │ │ │ │ │ -00031f60: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00031f70: 3a20 7361 7665 5f65 6e76 2c20 204e 6578 : save_env, Nex │ │ │ │ │ -00031f80: 743a 2073 6561 7263 682c 2020 5072 6576 t: search, Prev │ │ │ │ │ -00031f90: 3a20 726d 6d6f 642c 2020 5570 3a20 436f : rmmod, Up: Co │ │ │ │ │ -00031fa0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -00031fb0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -00031fc0: 6473 0a0a 3136 2e33 2e36 3420 7361 7665 ds..16.3.64 save │ │ │ │ │ -00031fd0: 5f65 6e76 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d _env.----------- │ │ │ │ │ -00031fe0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -00031ff0: 6e64 3a20 7361 7665 5f65 6e76 205b 2d2d nd: save_env [-- │ │ │ │ │ -00032000: 6669 6c65 2066 696c 655d 2076 6172 202e file file] var . │ │ │ │ │ -00032010: 2e2e 0a20 2020 2020 5361 7665 2074 6865 ... Save the │ │ │ │ │ -00032020: 206e 616d 6564 2076 6172 6961 626c 6573 named variables │ │ │ │ │ -00032030: 2066 726f 6d20 7468 6520 656e 7669 726f from the enviro │ │ │ │ │ -00032040: 6e6d 656e 7420 746f 2074 6865 2065 6e76 nment to the env │ │ │ │ │ -00032050: 6972 6f6e 6d65 6e74 0a20 2020 2020 626c ironment. bl │ │ │ │ │ -00032060: 6f63 6b20 6669 6c65 2e20 202a 4e6f 7465 ock file. *Note │ │ │ │ │ -00032070: 2045 6e76 6972 6f6e 6d65 6e74 2062 6c6f Environment blo │ │ │ │ │ -00032080: 636b 3a3a 2e0a 0a20 2020 2020 5468 6520 ck::... The │ │ │ │ │ -00032090: 272d 2d66 696c 6527 206f 7074 696f 6e20 '--file' option │ │ │ │ │ -000320a0: 6f76 6572 7269 6465 7320 7468 6520 6465 overrides the de │ │ │ │ │ -000320b0: 6661 756c 7420 6c6f 6361 7469 6f6e 206f fault location o │ │ │ │ │ -000320c0: 6620 7468 650a 2020 2020 2065 6e76 6972 f the. envir │ │ │ │ │ -000320d0: 6f6e 6d65 6e74 2062 6c6f 636b 2e0a 0a20 onment block... │ │ │ │ │ -000320e0: 2020 2020 5468 6973 2063 6f6d 6d61 6e64 This command │ │ │ │ │ -000320f0: 2077 696c 6c20 6f70 6572 6174 6520 7375 will operate su │ │ │ │ │ -00032100: 6363 6573 7366 756c 6c79 2065 7665 6e20 ccessfully even │ │ │ │ │ -00032110: 7768 656e 2065 6e76 6972 6f6e 6d65 6e74 when environment │ │ │ │ │ -00032120: 0a20 2020 2020 7661 7269 6162 6c65 2027 . variable ' │ │ │ │ │ -00032130: 6368 6563 6b5f 7369 676e 6174 7572 6573 check_signatures │ │ │ │ │ -00032140: 2720 6973 2073 6574 2074 6f20 2765 6e66 ' is set to 'enf │ │ │ │ │ -00032150: 6f72 6365 2720 282a 6e6f 7465 0a20 2020 orce' (*note. │ │ │ │ │ -00032160: 2020 6368 6563 6b5f 7369 676e 6174 7572 check_signatur │ │ │ │ │ -00032170: 6573 3a3a 292c 2073 696e 6365 2069 7420 es::), since it │ │ │ │ │ -00032180: 7772 6974 6573 2074 6f20 6469 736b 2061 writes to disk a │ │ │ │ │ -00032190: 6e64 2064 6f65 7320 6e6f 7420 616c 7465 nd does not alte │ │ │ │ │ -000321a0: 7220 7468 650a 2020 2020 2062 6568 6176 r the. behav │ │ │ │ │ -000321b0: 696f 7220 6f66 2047 5255 4220 6261 7365 ior of GRUB base │ │ │ │ │ -000321c0: 6420 6f6e 2061 6e79 2063 6f6e 7465 6e74 d on any content │ │ │ │ │ -000321d0: 7320 6f66 2064 6973 6b20 7468 6174 2068 s of disk that h │ │ │ │ │ -000321e0: 6176 6520 6265 656e 2072 6561 642e 0a20 ave been read.. │ │ │ │ │ -000321f0: 2020 2020 4974 2069 7320 706f 7373 6962 It is possib │ │ │ │ │ -00032200: 6c65 2074 6f20 6d6f 6469 6679 2061 2064 le to modify a d │ │ │ │ │ -00032210: 6967 6974 616c 6c79 2073 6967 6e65 6420 igitally signed │ │ │ │ │ -00032220: 656e 7669 726f 6e6d 656e 7420 626c 6f63 environment bloc │ │ │ │ │ -00032230: 6b20 6669 6c65 0a20 2020 2020 6672 6f6d k file. from │ │ │ │ │ -00032240: 2077 6974 6869 6e20 4752 5542 2075 7369 within GRUB usi │ │ │ │ │ -00032250: 6e67 2074 6869 7320 636f 6d6d 616e 642c ng this command, │ │ │ │ │ -00032260: 2073 7563 6820 7468 6174 2069 7473 2073 such that its s │ │ │ │ │ -00032270: 6967 6e61 7475 7265 2077 696c 6c0a 2020 ignature will. │ │ │ │ │ -00032280: 2020 206e 6f20 6c6f 6e67 6572 2062 6520 no longer be │ │ │ │ │ -00032290: 7661 6c69 6420 6f6e 2073 7562 7365 7175 valid on subsequ │ │ │ │ │ -000322a0: 656e 7420 626f 6f74 732e 2020 4361 7265 ent boots. Care │ │ │ │ │ -000322b0: 2073 686f 756c 6420 6265 2074 616b 656e should be taken │ │ │ │ │ -000322c0: 2069 6e0a 2020 2020 2073 7563 6820 6164 in. such ad │ │ │ │ │ -000322d0: 7661 6e63 6564 2063 6f6e 6669 6775 7261 vanced configura │ │ │ │ │ -000322e0: 7469 6f6e 7320 746f 2061 766f 6964 2072 tions to avoid r │ │ │ │ │ -000322f0: 656e 6465 7269 6e67 2074 6865 2073 7973 endering the sys │ │ │ │ │ -00032300: 7465 6d0a 2020 2020 2075 6e62 6f6f 7461 tem. unboota │ │ │ │ │ -00032310: 626c 652e 2020 2a4e 6f74 6520 5573 696e ble. *Note Usin │ │ │ │ │ -00032320: 6720 6469 6769 7461 6c20 7369 676e 6174 g digital signat │ │ │ │ │ -00032330: 7572 6573 3a3a 2c20 666f 7220 6d6f 7265 ures::, for more │ │ │ │ │ -00032340: 0a20 2020 2020 696e 666f 726d 6174 696f . informatio │ │ │ │ │ -00032350: 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 n.....File: grub │ │ │ │ │ -00032360: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7365 .info, Node: se │ │ │ │ │ -00032370: 6172 6368 2c20 204e 6578 743a 2073 656e arch, Next: sen │ │ │ │ │ -00032380: 646b 6579 2c20 2050 7265 763a 2073 6176 dkey, Prev: sav │ │ │ │ │ -00032390: 655f 656e 762c 2020 5570 3a20 436f 6d6d e_env, Up: Comm │ │ │ │ │ -000323a0: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -000323b0: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -000323c0: 0a0a 3136 2e33 2e36 3520 7365 6172 6368 ..16.3.65 search │ │ │ │ │ -000323d0: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a .--------------. │ │ │ │ │ -000323e0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7365 . -- Command: se │ │ │ │ │ -000323f0: 6172 6368 205b 2d2d 6669 6c65 7c2d 2d6c arch [--file|--l │ │ │ │ │ -00032400: 6162 656c 7c2d 2d66 732d 7575 6964 5d20 abel|--fs-uuid] │ │ │ │ │ -00032410: 5b2d 2d73 6574 205b 7661 725d 5d0a 2020 [--set [var]]. │ │ │ │ │ -00032420: 2020 2020 2020 2020 5b2d 2d6e 6f2d 666c [--no-fl │ │ │ │ │ -00032430: 6f70 7079 5d20 6e61 6d65 0a20 2020 2020 oppy] name. │ │ │ │ │ -00032440: 5365 6172 6368 2064 6576 6963 6573 2062 Search devices b │ │ │ │ │ -00032450: 7920 6669 6c65 2028 272d 6627 2c20 272d y file ('-f', '- │ │ │ │ │ -00032460: 2d66 696c 6527 292c 2066 696c 6573 7973 -file'), filesys │ │ │ │ │ -00032470: 7465 6d20 6c61 6265 6c20 2827 2d6c 272c tem label ('-l', │ │ │ │ │ -00032480: 0a20 2020 2020 272d 2d6c 6162 656c 2729 . '--label') │ │ │ │ │ -00032490: 2c20 6f72 2066 696c 6573 7973 7465 6d20 , or filesystem │ │ │ │ │ -000324a0: 5555 4944 2028 272d 7527 2c20 272d 2d66 UUID ('-u', '--f │ │ │ │ │ -000324b0: 732d 7575 6964 2729 2e0a 0a20 2020 2020 s-uuid')... │ │ │ │ │ -000324c0: 4966 2074 6865 2027 2d2d 7365 7427 206f If the '--set' o │ │ │ │ │ -000324d0: 7074 696f 6e20 6973 2075 7365 642c 2074 ption is used, t │ │ │ │ │ -000324e0: 6865 2066 6972 7374 2064 6576 6963 6520 he first device │ │ │ │ │ -000324f0: 666f 756e 6420 6973 2073 6574 2061 7320 found is set as │ │ │ │ │ -00032500: 7468 650a 2020 2020 2076 616c 7565 206f the. value o │ │ │ │ │ -00032510: 6620 656e 7669 726f 6e6d 656e 7420 7661 f environment va │ │ │ │ │ -00032520: 7269 6162 6c65 2056 4152 2e20 2054 6865 riable VAR. The │ │ │ │ │ -00032530: 2064 6566 6175 6c74 2076 6172 6961 626c default variabl │ │ │ │ │ -00032540: 6520 6973 2027 726f 6f74 272e 0a0a 2020 e is 'root'... │ │ │ │ │ -00032550: 2020 2054 6865 2027 2d2d 6e6f 2d66 6c6f The '--no-flo │ │ │ │ │ -00032560: 7070 7927 206f 7074 696f 6e20 7072 6576 ppy' option prev │ │ │ │ │ -00032570: 656e 7473 2073 6561 7263 6869 6e67 2066 ents searching f │ │ │ │ │ -00032580: 6c6f 7070 7920 6465 7669 6365 732c 2077 loppy devices, w │ │ │ │ │ -00032590: 6869 6368 0a20 2020 2020 6361 6e20 6265 hich. can be │ │ │ │ │ -000325a0: 2073 6c6f 772e 0a0a 2020 2020 2054 6865 slow... The │ │ │ │ │ -000325b0: 2027 7365 6172 6368 2e66 696c 6527 2c20 'search.file', │ │ │ │ │ -000325c0: 2773 6561 7263 682e 6673 5f6c 6162 656c 'search.fs_label │ │ │ │ │ -000325d0: 272c 2061 6e64 2027 7365 6172 6368 2e66 ', and 'search.f │ │ │ │ │ -000325e0: 735f 7575 6964 2720 636f 6d6d 616e 6473 s_uuid' commands │ │ │ │ │ -000325f0: 0a20 2020 2020 6172 6520 616c 6961 7365 . are aliase │ │ │ │ │ -00032600: 7320 666f 7220 2773 6561 7263 6820 2d2d s for 'search -- │ │ │ │ │ -00032610: 6669 6c65 272c 2027 7365 6172 6368 202d file', 'search - │ │ │ │ │ -00032620: 2d6c 6162 656c 272c 2061 6e64 2027 7365 -label', and 'se │ │ │ │ │ -00032630: 6172 6368 0a20 2020 2020 2d2d 6673 2d75 arch. --fs-u │ │ │ │ │ -00032640: 7569 6427 2072 6573 7065 6374 6976 656c uid' respectivel │ │ │ │ │ -00032650: 792e 0a0a 1f0a 4669 6c65 3a20 6772 7562 y.....File: grub │ │ │ │ │ -00032660: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7365 .info, Node: se │ │ │ │ │ -00032670: 6e64 6b65 792c 2020 4e65 7874 3a20 7365 ndkey, Next: se │ │ │ │ │ -00032680: 742c 2020 5072 6576 3a20 7365 6172 6368 t, Prev: search │ │ │ │ │ -00032690: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -000326a0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -000326b0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -000326c0: 332e 3636 2073 656e 646b 6579 0a2d 2d2d 3.66 sendkey.--- │ │ │ │ │ -000326d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ -000326e0: 2d20 436f 6d6d 616e 643a 2073 656e 646b - Command: sendk │ │ │ │ │ -000326f0: 6579 0a20 2020 2020 2020 2020 205b 2d2d ey. [-- │ │ │ │ │ -00032700: 6e75 6d7c 2d2d 6361 7073 7c2d 2d73 6372 num|--caps|--scr │ │ │ │ │ -00032710: 6f6c 6c7c 2d2d 696e 7365 7274 7c2d 2d70 oll|--insert|--p │ │ │ │ │ -00032720: 6175 7365 7c2d 2d6c 6566 742d 7368 6966 ause|--left-shif │ │ │ │ │ -00032730: 747c 2d2d 7269 6768 742d 7368 6966 747c t|--right-shift| │ │ │ │ │ -00032740: 2d2d 7379 7372 717c 2d2d 6e75 6d6b 6579 --sysrq|--numkey │ │ │ │ │ -00032750: 7c2d 2d63 6170 736b 6579 7c2d 2d73 6372 |--capskey|--scr │ │ │ │ │ -00032760: 6f6c 6c6b 6579 7c2d 2d69 6e73 6572 746b ollkey|--insertk │ │ │ │ │ -00032770: 6579 7c2d 2d6c 6566 742d 616c 747c 2d2d ey|--left-alt|-- │ │ │ │ │ -00032780: 7269 6768 742d 616c 747c 2d2d 6c65 6674 right-alt|--left │ │ │ │ │ -00032790: 2d63 7472 6c7c 2d2d 7269 6768 742d 6374 -ctrl|--right-ct │ │ │ │ │ -000327a0: 726c 0a20 2020 2020 2020 2020 206f 6e7c rl. on| │ │ │ │ │ -000327b0: 6f66 665d 2e2e 2e20 5b6e 6f2d 6c65 645d off]... [no-led] │ │ │ │ │ -000327c0: 206b 6579 7374 726f 6b65 0a20 2020 2020 keystroke. │ │ │ │ │ -000327d0: 496e 7365 7274 206b 6579 7374 726f 6b65 Insert keystroke │ │ │ │ │ -000327e0: 7320 696e 746f 2074 6865 206b 6579 626f s into the keybo │ │ │ │ │ -000327f0: 6172 6420 6275 6666 6572 2077 6865 6e20 ard buffer when │ │ │ │ │ -00032800: 626f 6f74 696e 672e 2020 536f 6d65 7469 booting. Someti │ │ │ │ │ -00032810: 6d65 730a 2020 2020 2061 6e20 6f70 6572 mes. an oper │ │ │ │ │ -00032820: 6174 696e 6720 7379 7374 656d 206f 7220 ating system or │ │ │ │ │ -00032830: 6368 6169 6e6c 6f61 6465 6420 626f 6f74 chainloaded boot │ │ │ │ │ -00032840: 206c 6f61 6465 7220 7265 7175 6972 6573 loader requires │ │ │ │ │ -00032850: 2070 6172 7469 6375 6c61 720a 2020 2020 particular. │ │ │ │ │ -00032860: 206b 6579 7320 746f 2062 6520 7072 6573 keys to be pres │ │ │ │ │ -00032870: 7365 643a 2066 6f72 2065 7861 6d70 6c65 sed: for example │ │ │ │ │ -00032880: 2c20 6f6e 6520 6d69 6768 7420 6e65 6564 , one might need │ │ │ │ │ -00032890: 2074 6f20 7072 6573 7320 610a 2020 2020 to press a. │ │ │ │ │ -000328a0: 2070 6172 7469 6375 6c61 7220 6b65 7920 particular key │ │ │ │ │ -000328b0: 746f 2065 6e74 6572 2022 7361 6665 206d to enter "safe m │ │ │ │ │ -000328c0: 6f64 6522 2c20 6f72 2077 6865 6e20 6368 ode", or when ch │ │ │ │ │ -000328d0: 6169 6e6c 6f61 6469 6e67 2061 6e6f 7468 ainloading anoth │ │ │ │ │ -000328e0: 6572 0a20 2020 2020 626f 6f74 206c 6f61 er. boot loa │ │ │ │ │ -000328f0: 6465 7220 6f6e 6520 6d69 6768 7420 7365 der one might se │ │ │ │ │ -00032900: 6e64 206b 6579 7374 726f 6b65 7320 746f nd keystrokes to │ │ │ │ │ -00032910: 2069 7420 746f 206e 6176 6967 6174 6520 it to navigate │ │ │ │ │ -00032920: 6974 7320 6d65 6e75 2e0a 0a20 2020 2020 its menu... │ │ │ │ │ -00032930: 596f 7520 6d61 7920 7072 6f76 6964 6520 You may provide │ │ │ │ │ -00032940: 7570 2074 6f20 3136 206b 6579 7374 726f up to 16 keystro │ │ │ │ │ -00032950: 6b65 7320 2874 6865 206c 656e 6774 6820 kes (the length │ │ │ │ │ -00032960: 6f66 2074 6865 2042 494f 530a 2020 2020 of the BIOS. │ │ │ │ │ -00032970: 206b 6579 626f 6172 6420 6275 6666 6572 keyboard buffer │ │ │ │ │ -00032980: 292e 2020 4b65 7973 7472 6f6b 6520 6e61 ). Keystroke na │ │ │ │ │ -00032990: 6d65 7320 6d61 7920 6265 2075 7070 6572 mes may be upper │ │ │ │ │ -000329a0: 2d63 6173 6520 6f72 206c 6f77 6572 2d63 -case or lower-c │ │ │ │ │ -000329b0: 6173 650a 2020 2020 206c 6574 7465 7273 ase. letters │ │ │ │ │ -000329c0: 2c20 6469 6769 7473 2c20 6f72 2074 616b , digits, or tak │ │ │ │ │ -000329d0: 656e 2066 726f 6d20 7468 6520 666f 6c6c en from the foll │ │ │ │ │ -000329e0: 6f77 696e 6720 7461 626c 653a 0a0a 2020 owing table:.. │ │ │ │ │ -000329f0: 2020 204e 616d 6520 2020 2020 2020 2020 Name │ │ │ │ │ +000311a0: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +000311b0: 6e64 3a20 7061 7373 776f 7264 5f70 626b nd: password_pbk │ │ │ │ │ +000311c0: 6466 3220 7573 6572 2068 6173 6865 642d df2 user hashed- │ │ │ │ │ +000311d0: 7061 7373 776f 7264 0a20 2020 2020 4465 password. De │ │ │ │ │ +000311e0: 6669 6e65 2061 2075 7365 7220 6e61 6d65 fine a user name │ │ │ │ │ +000311f0: 6420 5553 4552 2077 6974 6820 7061 7373 d USER with pass │ │ │ │ │ +00031200: 776f 7264 2068 6173 6820 4841 5348 4544 word hash HASHED │ │ │ │ │ +00031210: 2d50 4153 5357 4f52 442e 2020 5573 650a -PASSWORD. Use. │ │ │ │ │ +00031220: 2020 2020 2027 6772 7562 2d6d 6b70 6173 'grub-mkpas │ │ │ │ │ +00031230: 7377 642d 7062 6b64 6632 2720 282a 6e6f swd-pbkdf2' (*no │ │ │ │ │ +00031240: 7465 2049 6e76 6f6b 696e 6720 6772 7562 te Invoking grub │ │ │ │ │ +00031250: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ │ +00031260: 3a3a 2920 746f 0a20 2020 2020 6765 6e65 ::) to. gene │ │ │ │ │ +00031270: 7261 7465 2070 6173 7377 6f72 6420 6861 rate password ha │ │ │ │ │ +00031280: 7368 6573 2e20 202a 4e6f 7465 2053 6563 shes. *Note Sec │ │ │ │ │ +00031290: 7572 6974 793a 3a2e 0a0a 1f0a 4669 6c65 urity::.....File │ │ │ │ │ +000312a0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +000312b0: 6465 3a20 706c 6179 2c20 204e 6578 743a de: play, Next: │ │ │ │ │ +000312c0: 2070 726f 6265 2c20 2050 7265 763a 2070 probe, Prev: p │ │ │ │ │ +000312d0: 6173 7377 6f72 645f 7062 6b64 6632 2c20 assword_pbkdf2, │ │ │ │ │ +000312e0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +000312f0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +00031300: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +00031310: 3537 2070 6c61 790a 2d2d 2d2d 2d2d 2d2d 57 play.-------- │ │ │ │ │ +00031320: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +00031330: 643a 2070 6c61 7920 6669 6c65 207c 2074 d: play file | t │ │ │ │ │ +00031340: 656d 706f 205b 7069 7463 6831 2064 7572 empo [pitch1 dur │ │ │ │ │ +00031350: 6174 696f 6e31 5d20 5b70 6974 6368 3220 ation1] [pitch2 │ │ │ │ │ +00031360: 6475 7261 7469 6f6e 325d 202e 2e2e 0a20 duration2] .... │ │ │ │ │ +00031370: 2020 2020 506c 6179 7320 6120 7475 6e65 Plays a tune │ │ │ │ │ +00031380: 0a0a 2020 2020 2049 6620 7468 6520 6172 .. If the ar │ │ │ │ │ +00031390: 6775 6d65 6e74 2069 7320 6120 6669 6c65 gument is a file │ │ │ │ │ +000313a0: 206e 616d 6520 282a 6e6f 7465 2046 696c name (*note Fil │ │ │ │ │ +000313b0: 6520 6e61 6d65 2073 796e 7461 783a 3a29 e name syntax::) │ │ │ │ │ +000313c0: 2c20 706c 6179 2074 6865 0a20 2020 2020 , play the. │ │ │ │ │ +000313d0: 7475 6e65 2072 6563 6f72 6465 6420 696e tune recorded in │ │ │ │ │ +000313e0: 2069 742e 2020 5468 6520 6669 6c65 2066 it. The file f │ │ │ │ │ +000313f0: 6f72 6d61 7420 6973 2066 6972 7374 2074 ormat is first t │ │ │ │ │ +00031400: 6865 2074 656d 706f 2061 7320 616e 0a20 he tempo as an. │ │ │ │ │ +00031410: 2020 2020 756e 7369 676e 6564 2033 3262 unsigned 32b │ │ │ │ │ +00031420: 6974 206c 6974 746c 652d 656e 6469 616e it little-endian │ │ │ │ │ +00031430: 206e 756d 6265 722c 2074 6865 6e20 7061 number, then pa │ │ │ │ │ +00031440: 6972 7320 6f66 2075 6e73 6967 6e65 6420 irs of unsigned │ │ │ │ │ +00031450: 3136 6269 740a 2020 2020 206c 6974 746c 16bit. littl │ │ │ │ │ +00031460: 652d 656e 6469 616e 206e 756d 6265 7273 e-endian numbers │ │ │ │ │ +00031470: 2066 6f72 2070 6974 6368 2061 6e64 2064 for pitch and d │ │ │ │ │ +00031480: 7572 6174 696f 6e20 7061 6972 732e 0a0a uration pairs... │ │ │ │ │ +00031490: 2020 2020 2049 6620 7468 6520 6172 6775 If the argu │ │ │ │ │ +000314a0: 6d65 6e74 7320 6172 6520 6120 7365 7269 ments are a seri │ │ │ │ │ +000314b0: 6573 206f 6620 6e75 6d62 6572 732c 2070 es of numbers, p │ │ │ │ │ +000314c0: 6c61 7920 7468 6520 696e 6c69 6e65 2074 lay the inline t │ │ │ │ │ +000314d0: 756e 652e 0a0a 2020 2020 2054 6865 2074 une... The t │ │ │ │ │ +000314e0: 656d 706f 2069 7320 7468 6520 6261 7365 empo is the base │ │ │ │ │ +000314f0: 2066 6f72 2061 6c6c 206e 6f74 6520 6475 for all note du │ │ │ │ │ +00031500: 7261 7469 6f6e 732e 2020 3630 2067 6976 rations. 60 giv │ │ │ │ │ +00031510: 6573 2061 2031 2d73 6563 6f6e 640a 2020 es a 1-second. │ │ │ │ │ +00031520: 2020 2062 6173 652c 2031 3230 2067 6976 base, 120 giv │ │ │ │ │ +00031530: 6573 2061 2068 616c 662d 7365 636f 6e64 es a half-second │ │ │ │ │ +00031540: 2062 6173 652c 2065 7463 2e20 2050 6974 base, etc. Pit │ │ │ │ │ +00031550: 6368 6573 2061 7265 2048 7a2e 2020 5365 ches are Hz. Se │ │ │ │ │ +00031560: 740a 2020 2020 2070 6974 6368 2074 6f20 t. pitch to │ │ │ │ │ +00031570: 3020 746f 2070 726f 6475 6365 2061 2072 0 to produce a r │ │ │ │ │ +00031580: 6573 742e 0a0a 1f0a 4669 6c65 3a20 6772 est.....File: gr │ │ │ │ │ +00031590: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +000315a0: 7072 6f62 652c 2020 4e65 7874 3a20 7264 probe, Next: rd │ │ │ │ │ +000315b0: 6d73 722c 2020 5072 6576 3a20 706c 6179 msr, Prev: play │ │ │ │ │ +000315c0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ +000315d0: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ +000315e0: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ +000315f0: 332e 3538 2070 726f 6265 0a2d 2d2d 2d2d 3.58 probe.----- │ │ │ │ │ +00031600: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +00031610: 6d6d 616e 643a 2070 726f 6265 205b 2d2d mmand: probe [-- │ │ │ │ │ +00031620: 7365 7420 7661 725d 0a20 2020 2020 2020 set var]. │ │ │ │ │ +00031630: 2020 202d 2d64 7269 7665 727c 2d2d 7061 --driver|--pa │ │ │ │ │ +00031640: 7274 6d61 707c 2d2d 6673 7c2d 2d66 732d rtmap|--fs|--fs- │ │ │ │ │ +00031650: 7575 6964 7c2d 2d6c 6162 656c 7c2d 2d70 uuid|--label|--p │ │ │ │ │ +00031660: 6172 742d 7575 6964 2064 6576 6963 650a art-uuid device. │ │ │ │ │ +00031670: 2020 2020 2052 6574 7269 6576 6520 6465 Retrieve de │ │ │ │ │ +00031680: 7669 6365 2069 6e66 6f72 6d61 7469 6f6e vice information │ │ │ │ │ +00031690: 2e20 2049 6620 6f70 7469 6f6e 2027 2d2d . If option '-- │ │ │ │ │ +000316a0: 7365 7427 2069 7320 6769 7665 6e2c 2061 set' is given, a │ │ │ │ │ +000316b0: 7373 6967 6e0a 2020 2020 2072 6573 756c ssign. resul │ │ │ │ │ +000316c0: 7420 746f 2076 6172 6961 626c 6520 5641 t to variable VA │ │ │ │ │ +000316d0: 522c 206f 7468 6572 7769 7365 2070 7269 R, otherwise pri │ │ │ │ │ +000316e0: 6e74 2069 6e66 6f72 6d61 7469 6f6e 206f nt information o │ │ │ │ │ +000316f0: 6e20 7468 6520 7363 7265 656e 2e0a 0a20 n the screen... │ │ │ │ │ +00031700: 2020 2020 5468 6520 6f70 7469 6f6e 2027 The option ' │ │ │ │ │ +00031710: 2d2d 7061 7274 2d75 7569 6427 2069 7320 --part-uuid' is │ │ │ │ │ +00031720: 6375 7272 656e 746c 7920 6f6e 6c79 2069 currently only i │ │ │ │ │ +00031730: 6d70 6c65 6d65 6e74 6564 2066 6f72 204d mplemented for M │ │ │ │ │ +00031740: 5344 4f53 0a20 2020 2020 616e 6420 4750 SDOS. and GP │ │ │ │ │ +00031750: 5420 666f 726d 6174 7465 6420 6469 736b T formatted disk │ │ │ │ │ +00031760: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ +00031770: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 7264 .info, Node: rd │ │ │ │ │ +00031780: 6d73 722c 2020 4e65 7874 3a20 7265 6164 msr, Next: read │ │ │ │ │ +00031790: 2c20 2050 7265 763a 2070 726f 6265 2c20 , Prev: probe, │ │ │ │ │ +000317a0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +000317b0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +000317c0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +000317d0: 3539 2072 646d 7372 0a2d 2d2d 2d2d 2d2d 59 rdmsr.------- │ │ │ │ │ +000317e0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +000317f0: 616e 643a 3a20 7264 6d73 7220 3078 4144 and:: rdmsr 0xAD │ │ │ │ │ +00031800: 4452 205b 2d76 2056 4152 4e41 4d45 5d0a DR [-v VARNAME]. │ │ │ │ │ +00031810: 2020 2020 2052 6561 6420 6120 6d6f 6465 Read a mode │ │ │ │ │ +00031820: 6c2d 7370 6563 6966 6963 2072 6567 6973 l-specific regis │ │ │ │ │ +00031830: 7465 7220 6174 2061 6464 7265 7373 2030 ter at address 0 │ │ │ │ │ +00031840: 7841 4444 522e 2049 6620 7468 6520 7061 xADDR. If the pa │ │ │ │ │ +00031850: 7261 6d65 7465 720a 2020 2020 2027 2d76 rameter. '-v │ │ │ │ │ +00031860: 2720 6973 2075 7365 6420 616e 6420 616e ' is used and an │ │ │ │ │ +00031870: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ +00031880: 6961 626c 6520 5641 524e 414d 4520 6973 iable VARNAME is │ │ │ │ │ +00031890: 2067 6976 656e 2c20 7365 7420 7468 6174 given, set that │ │ │ │ │ +000318a0: 0a20 2020 2020 656e 7669 726f 6e6d 656e . environmen │ │ │ │ │ +000318b0: 7420 7661 7269 6162 6c65 2074 6f20 7468 t variable to th │ │ │ │ │ +000318c0: 6520 7661 6c75 6520 7468 6174 2077 6173 e value that was │ │ │ │ │ +000318d0: 2072 6561 642e 0a0a 2020 2020 2050 6c65 read... Ple │ │ │ │ │ +000318e0: 6173 6520 6e6f 7465 2074 6861 7420 6f6e ase note that on │ │ │ │ │ +000318f0: 2053 4d50 2073 7973 7465 6d73 2c20 7265 SMP systems, re │ │ │ │ │ +00031900: 6164 696e 6720 6672 6f6d 2061 204d 5352 ading from a MSR │ │ │ │ │ +00031910: 2074 6861 7420 6861 7320 610a 2020 2020 that has a. │ │ │ │ │ +00031920: 2073 636f 7065 2070 6572 2068 6172 6477 scope per hardw │ │ │ │ │ +00031930: 6172 6520 7468 7265 6164 2c20 696d 706c are thread, impl │ │ │ │ │ +00031940: 6965 7320 7468 6174 2074 6865 2076 616c ies that the val │ │ │ │ │ +00031950: 7565 2074 6861 7420 6973 2072 6574 7572 ue that is retur │ │ │ │ │ +00031960: 6e65 640a 2020 2020 206f 6e6c 7920 6170 ned. only ap │ │ │ │ │ +00031970: 706c 6965 7320 746f 2074 6865 2070 6172 plies to the par │ │ │ │ │ +00031980: 7469 6375 6c61 7220 6370 752f 636f 7265 ticular cpu/core │ │ │ │ │ +00031990: 2f74 6872 6561 6420 7468 6174 2072 756e /thread that run │ │ │ │ │ +000319a0: 7320 7468 650a 2020 2020 2063 6f6d 6d61 s the. comma │ │ │ │ │ +000319b0: 6e64 2e0a 0a20 2020 2020 416c 736f 2c20 nd... Also, │ │ │ │ │ +000319c0: 6966 2079 6f75 2073 7065 6369 6679 2061 if you specify a │ │ │ │ │ +000319d0: 2072 6573 6572 7665 6420 6f72 2075 6e69 reserved or uni │ │ │ │ │ +000319e0: 6d70 6c65 6d65 6e74 6564 204d 5352 2061 mplemented MSR a │ │ │ │ │ +000319f0: 6464 7265 7373 2c20 6974 0a20 2020 2020 ddress, it. │ │ │ │ │ +00031a00: 7769 6c6c 2063 6175 7365 2061 2067 656e will cause a gen │ │ │ │ │ +00031a10: 6572 616c 2070 726f 7465 6374 696f 6e20 eral protection │ │ │ │ │ +00031a20: 6578 6365 7074 696f 6e20 2877 6869 6368 exception (which │ │ │ │ │ +00031a30: 2069 7320 6e6f 7420 6375 7272 656e 746c is not currentl │ │ │ │ │ +00031a40: 790a 2020 2020 2062 6569 6e67 2068 616e y. being han │ │ │ │ │ +00031a50: 646c 6564 2920 616e 6420 7468 6520 7379 dled) and the sy │ │ │ │ │ +00031a60: 7374 656d 2077 696c 6c20 7265 626f 6f74 stem will reboot │ │ │ │ │ +00031a70: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00031a80: 696e 666f 2c20 204e 6f64 653a 2072 6561 info, Node: rea │ │ │ │ │ +00031a90: 642c 2020 4e65 7874 3a20 7265 626f 6f74 d, Next: reboot │ │ │ │ │ +00031aa0: 2c20 2050 7265 763a 2072 646d 7372 2c20 , Prev: rdmsr, │ │ │ │ │ +00031ab0: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +00031ac0: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +00031ad0: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +00031ae0: 3630 2072 6561 640a 2d2d 2d2d 2d2d 2d2d 60 read.-------- │ │ │ │ │ +00031af0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +00031b00: 643a 2072 6561 6420 5b76 6172 5d0a 2020 d: read [var]. │ │ │ │ │ +00031b10: 2020 2052 6561 6420 6120 6c69 6e65 206f Read a line o │ │ │ │ │ +00031b20: 6620 696e 7075 7420 6672 6f6d 2074 6865 f input from the │ │ │ │ │ +00031b30: 2075 7365 722e 2020 4966 2061 6e20 656e user. If an en │ │ │ │ │ +00031b40: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +00031b50: 6c65 2056 4152 0a20 2020 2020 6973 2067 le VAR. is g │ │ │ │ │ +00031b60: 6976 656e 2c20 7365 7420 7468 6174 2065 iven, set that e │ │ │ │ │ +00031b70: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00031b80: 626c 6520 746f 2074 6865 206c 696e 6520 ble to the line │ │ │ │ │ +00031b90: 6f66 2069 6e70 7574 2074 6861 740a 2020 of input that. │ │ │ │ │ +00031ba0: 2020 2077 6173 2072 6561 642c 2077 6974 was read, wit │ │ │ │ │ +00031bb0: 6820 6e6f 2074 6572 6d69 6e61 7469 6e67 h no terminating │ │ │ │ │ +00031bc0: 206e 6577 6c69 6e65 2e0a 0a1f 0a46 696c newline.....Fil │ │ │ │ │ +00031bd0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00031be0: 6f64 653a 2072 6562 6f6f 742c 2020 4e65 ode: reboot, Ne │ │ │ │ │ +00031bf0: 7874 3a20 7265 6765 7870 2c20 2050 7265 xt: regexp, Pre │ │ │ │ │ +00031c00: 763a 2072 6561 642c 2020 5570 3a20 436f v: read, Up: Co │ │ │ │ │ +00031c10: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +00031c20: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +00031c30: 6473 0a0a 3136 2e33 2e36 3120 7265 626f ds..16.3.61 rebo │ │ │ │ │ +00031c40: 6f74 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ot.------------- │ │ │ │ │ +00031c50: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00031c60: 7265 626f 6f74 0a20 2020 2020 5265 626f reboot. Rebo │ │ │ │ │ +00031c70: 6f74 2074 6865 2063 6f6d 7075 7465 722e ot the computer. │ │ │ │ │ +00031c80: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00031c90: 6e66 6f2c 2020 4e6f 6465 3a20 7265 6765 nfo, Node: rege │ │ │ │ │ +00031ca0: 7870 2c20 204e 6578 743a 2072 6d6d 6f64 xp, Next: rmmod │ │ │ │ │ +00031cb0: 2c20 2050 7265 763a 2072 6562 6f6f 742c , Prev: reboot, │ │ │ │ │ +00031cc0: 2020 5570 3a20 436f 6d6d 616e 642d 6c69 Up: Command-li │ │ │ │ │ +00031cd0: 6e65 2061 6e64 206d 656e 7520 656e 7472 ne and menu entr │ │ │ │ │ +00031ce0: 7920 636f 6d6d 616e 6473 0a0a 3136 2e33 y commands..16.3 │ │ │ │ │ +00031cf0: 2e36 3220 7265 6765 7870 0a2d 2d2d 2d2d .62 regexp.----- │ │ │ │ │ +00031d00: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ +00031d10: 6f6d 6d61 6e64 3a20 7265 6765 7870 205b ommand: regexp [ │ │ │ │ │ +00031d20: 2d2d 7365 7420 5b6e 756d 6265 723a 5d76 --set [number:]v │ │ │ │ │ +00031d30: 6172 5d20 7265 6765 7870 2073 7472 696e ar] regexp strin │ │ │ │ │ +00031d40: 670a 2020 2020 2054 6573 7420 6966 2072 g. Test if r │ │ │ │ │ +00031d50: 6567 756c 6172 2065 7870 7265 7373 696f egular expressio │ │ │ │ │ +00031d60: 6e20 5245 4745 5850 206d 6174 6368 6573 n REGEXP matches │ │ │ │ │ +00031d70: 2053 5452 494e 472e 2020 5375 7070 6f72 STRING. Suppor │ │ │ │ │ +00031d80: 7465 640a 2020 2020 2072 6567 756c 6172 ted. regular │ │ │ │ │ +00031d90: 2065 7870 7265 7373 696f 6e73 2061 7265 expressions are │ │ │ │ │ +00031da0: 2050 4f53 4958 2e32 2045 7874 656e 6465 POSIX.2 Extende │ │ │ │ │ +00031db0: 6420 5265 6775 6c61 7220 4578 7072 6573 d Regular Expres │ │ │ │ │ +00031dc0: 7369 6f6e 732e 2020 4966 0a20 2020 2020 sions. If. │ │ │ │ │ +00031dd0: 6f70 7469 6f6e 2027 2d2d 7365 7427 2069 option '--set' i │ │ │ │ │ +00031de0: 7320 6769 7665 6e2c 2073 746f 7265 204e s given, store N │ │ │ │ │ +00031df0: 554d 4245 5274 6820 6d61 7463 6865 6420 UMBERth matched │ │ │ │ │ +00031e00: 7375 6265 7870 7265 7373 696f 6e20 696e subexpression in │ │ │ │ │ +00031e10: 0a20 2020 2020 7661 7269 6162 6c65 2056 . variable V │ │ │ │ │ +00031e20: 4152 2e20 2053 7562 6578 7072 6573 7369 AR. Subexpressi │ │ │ │ │ +00031e30: 6f6e 7320 6172 6520 6e75 6d62 6572 6564 ons are numbered │ │ │ │ │ +00031e40: 2069 6e20 6f72 6465 7220 6f66 2074 6865 in order of the │ │ │ │ │ +00031e50: 6972 0a20 2020 2020 6f70 656e 696e 6720 ir. opening │ │ │ │ │ +00031e60: 7061 7265 6e74 6865 7365 7320 7374 6172 parentheses star │ │ │ │ │ +00031e70: 7469 6e67 2066 726f 6d20 2731 272e 2020 ting from '1'. │ │ │ │ │ +00031e80: 4e55 4d42 4552 2064 6566 6175 6c74 7320 NUMBER defaults │ │ │ │ │ +00031e90: 746f 2027 3127 2e0a 0a1f 0a46 696c 653a to '1'.....File: │ │ │ │ │ +00031ea0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00031eb0: 653a 2072 6d6d 6f64 2c20 204e 6578 743a e: rmmod, Next: │ │ │ │ │ +00031ec0: 2073 6176 655f 656e 762c 2020 5072 6576 save_env, Prev │ │ │ │ │ +00031ed0: 3a20 7265 6765 7870 2c20 2055 703a 2043 : regexp, Up: C │ │ │ │ │ +00031ee0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +00031ef0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +00031f00: 6e64 730a 0a31 362e 332e 3633 2072 6d6d nds..16.3.63 rmm │ │ │ │ │ +00031f10: 6f64 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d od.------------- │ │ │ │ │ +00031f20: 0a0a 202d 2d20 436f 6d6d 616e 643a 2072 .. -- Command: r │ │ │ │ │ +00031f30: 6d6d 6f64 206d 6f64 756c 650a 2020 2020 mmod module. │ │ │ │ │ +00031f40: 2052 656d 6f76 6520 6120 6c6f 6164 6564 Remove a loaded │ │ │ │ │ +00031f50: 204d 4f44 554c 452e 0a0a 1f0a 4669 6c65 MODULE.....File │ │ │ │ │ +00031f60: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00031f70: 6465 3a20 7361 7665 5f65 6e76 2c20 204e de: save_env, N │ │ │ │ │ +00031f80: 6578 743a 2073 6561 7263 682c 2020 5072 ext: search, Pr │ │ │ │ │ +00031f90: 6576 3a20 726d 6d6f 642c 2020 5570 3a20 ev: rmmod, Up: │ │ │ │ │ +00031fa0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00031fb0: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00031fc0: 616e 6473 0a0a 3136 2e33 2e36 3420 7361 ands..16.3.64 sa │ │ │ │ │ +00031fd0: 7665 5f65 6e76 0a2d 2d2d 2d2d 2d2d 2d2d ve_env.--------- │ │ │ │ │ +00031fe0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +00031ff0: 6d61 6e64 3a20 7361 7665 5f65 6e76 205b mand: save_env [ │ │ │ │ │ +00032000: 2d2d 6669 6c65 2066 696c 655d 2076 6172 --file file] var │ │ │ │ │ +00032010: 202e 2e2e 0a20 2020 2020 5361 7665 2074 .... Save t │ │ │ │ │ +00032020: 6865 206e 616d 6564 2076 6172 6961 626c he named variabl │ │ │ │ │ +00032030: 6573 2066 726f 6d20 7468 6520 656e 7669 es from the envi │ │ │ │ │ +00032040: 726f 6e6d 656e 7420 746f 2074 6865 2065 ronment to the e │ │ │ │ │ +00032050: 6e76 6972 6f6e 6d65 6e74 0a20 2020 2020 nvironment. │ │ │ │ │ +00032060: 626c 6f63 6b20 6669 6c65 2e20 202a 4e6f block file. *No │ │ │ │ │ +00032070: 7465 2045 6e76 6972 6f6e 6d65 6e74 2062 te Environment b │ │ │ │ │ +00032080: 6c6f 636b 3a3a 2e0a 0a20 2020 2020 5468 lock::... Th │ │ │ │ │ +00032090: 6520 272d 2d66 696c 6527 206f 7074 696f e '--file' optio │ │ │ │ │ +000320a0: 6e20 6f76 6572 7269 6465 7320 7468 6520 n overrides the │ │ │ │ │ +000320b0: 6465 6661 756c 7420 6c6f 6361 7469 6f6e default location │ │ │ │ │ +000320c0: 206f 6620 7468 650a 2020 2020 2065 6e76 of the. env │ │ │ │ │ +000320d0: 6972 6f6e 6d65 6e74 2062 6c6f 636b 2e0a ironment block.. │ │ │ │ │ +000320e0: 0a20 2020 2020 5468 6973 2063 6f6d 6d61 . This comma │ │ │ │ │ +000320f0: 6e64 2077 696c 6c20 6f70 6572 6174 6520 nd will operate │ │ │ │ │ +00032100: 7375 6363 6573 7366 756c 6c79 2065 7665 successfully eve │ │ │ │ │ +00032110: 6e20 7768 656e 2065 6e76 6972 6f6e 6d65 n when environme │ │ │ │ │ +00032120: 6e74 0a20 2020 2020 7661 7269 6162 6c65 nt. variable │ │ │ │ │ +00032130: 2027 6368 6563 6b5f 7369 676e 6174 7572 'check_signatur │ │ │ │ │ +00032140: 6573 2720 6973 2073 6574 2074 6f20 2765 es' is set to 'e │ │ │ │ │ +00032150: 6e66 6f72 6365 2720 282a 6e6f 7465 0a20 nforce' (*note. │ │ │ │ │ +00032160: 2020 2020 6368 6563 6b5f 7369 676e 6174 check_signat │ │ │ │ │ +00032170: 7572 6573 3a3a 292c 2073 696e 6365 2069 ures::), since i │ │ │ │ │ +00032180: 7420 7772 6974 6573 2074 6f20 6469 736b t writes to disk │ │ │ │ │ +00032190: 2061 6e64 2064 6f65 7320 6e6f 7420 616c and does not al │ │ │ │ │ +000321a0: 7465 7220 7468 650a 2020 2020 2062 6568 ter the. beh │ │ │ │ │ +000321b0: 6176 696f 7220 6f66 2047 5255 4220 6261 avior of GRUB ba │ │ │ │ │ +000321c0: 7365 6420 6f6e 2061 6e79 2063 6f6e 7465 sed on any conte │ │ │ │ │ +000321d0: 6e74 7320 6f66 2064 6973 6b20 7468 6174 nts of disk that │ │ │ │ │ +000321e0: 2068 6176 6520 6265 656e 2072 6561 642e have been read. │ │ │ │ │ +000321f0: 0a20 2020 2020 4974 2069 7320 706f 7373 . It is poss │ │ │ │ │ +00032200: 6962 6c65 2074 6f20 6d6f 6469 6679 2061 ible to modify a │ │ │ │ │ +00032210: 2064 6967 6974 616c 6c79 2073 6967 6e65 digitally signe │ │ │ │ │ +00032220: 6420 656e 7669 726f 6e6d 656e 7420 626c d environment bl │ │ │ │ │ +00032230: 6f63 6b20 6669 6c65 0a20 2020 2020 6672 ock file. fr │ │ │ │ │ +00032240: 6f6d 2077 6974 6869 6e20 4752 5542 2075 om within GRUB u │ │ │ │ │ +00032250: 7369 6e67 2074 6869 7320 636f 6d6d 616e sing this comman │ │ │ │ │ +00032260: 642c 2073 7563 6820 7468 6174 2069 7473 d, such that its │ │ │ │ │ +00032270: 2073 6967 6e61 7475 7265 2077 696c 6c0a signature will. │ │ │ │ │ +00032280: 2020 2020 206e 6f20 6c6f 6e67 6572 2062 no longer b │ │ │ │ │ +00032290: 6520 7661 6c69 6420 6f6e 2073 7562 7365 e valid on subse │ │ │ │ │ +000322a0: 7175 656e 7420 626f 6f74 732e 2020 4361 quent boots. Ca │ │ │ │ │ +000322b0: 7265 2073 686f 756c 6420 6265 2074 616b re should be tak │ │ │ │ │ +000322c0: 656e 2069 6e0a 2020 2020 2073 7563 6820 en in. such │ │ │ │ │ +000322d0: 6164 7661 6e63 6564 2063 6f6e 6669 6775 advanced configu │ │ │ │ │ +000322e0: 7261 7469 6f6e 7320 746f 2061 766f 6964 rations to avoid │ │ │ │ │ +000322f0: 2072 656e 6465 7269 6e67 2074 6865 2073 rendering the s │ │ │ │ │ +00032300: 7973 7465 6d0a 2020 2020 2075 6e62 6f6f ystem. unboo │ │ │ │ │ +00032310: 7461 626c 652e 2020 2a4e 6f74 6520 5573 table. *Note Us │ │ │ │ │ +00032320: 696e 6720 6469 6769 7461 6c20 7369 676e ing digital sign │ │ │ │ │ +00032330: 6174 7572 6573 3a3a 2c20 666f 7220 6d6f atures::, for mo │ │ │ │ │ +00032340: 7265 0a20 2020 2020 696e 666f 726d 6174 re. informat │ │ │ │ │ +00032350: 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 ion.....File: gr │ │ │ │ │ +00032360: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00032370: 7365 6172 6368 2c20 204e 6578 743a 2073 search, Next: s │ │ │ │ │ +00032380: 656e 646b 6579 2c20 2050 7265 763a 2073 endkey, Prev: s │ │ │ │ │ +00032390: 6176 655f 656e 762c 2020 5570 3a20 436f ave_env, Up: Co │ │ │ │ │ +000323a0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +000323b0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +000323c0: 6473 0a0a 3136 2e33 2e36 3520 7365 6172 ds..16.3.65 sear │ │ │ │ │ +000323d0: 6368 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ch.------------- │ │ │ │ │ +000323e0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +000323f0: 7365 6172 6368 205b 2d2d 6669 6c65 7c2d search [--file|- │ │ │ │ │ +00032400: 2d6c 6162 656c 7c2d 2d66 732d 7575 6964 -label|--fs-uuid │ │ │ │ │ +00032410: 5d20 5b2d 2d73 6574 205b 7661 725d 5d0a ] [--set [var]]. │ │ │ │ │ +00032420: 2020 2020 2020 2020 2020 5b2d 2d6e 6f2d [--no- │ │ │ │ │ +00032430: 666c 6f70 7079 5d20 6e61 6d65 0a20 2020 floppy] name. │ │ │ │ │ +00032440: 2020 5365 6172 6368 2064 6576 6963 6573 Search devices │ │ │ │ │ +00032450: 2062 7920 6669 6c65 2028 272d 6627 2c20 by file ('-f', │ │ │ │ │ +00032460: 272d 2d66 696c 6527 292c 2066 696c 6573 '--file'), files │ │ │ │ │ +00032470: 7973 7465 6d20 6c61 6265 6c20 2827 2d6c ystem label ('-l │ │ │ │ │ +00032480: 272c 0a20 2020 2020 272d 2d6c 6162 656c ',. '--label │ │ │ │ │ +00032490: 2729 2c20 6f72 2066 696c 6573 7973 7465 '), or filesyste │ │ │ │ │ +000324a0: 6d20 5555 4944 2028 272d 7527 2c20 272d m UUID ('-u', '- │ │ │ │ │ +000324b0: 2d66 732d 7575 6964 2729 2e0a 0a20 2020 -fs-uuid')... │ │ │ │ │ +000324c0: 2020 4966 2074 6865 2027 2d2d 7365 7427 If the '--set' │ │ │ │ │ +000324d0: 206f 7074 696f 6e20 6973 2075 7365 642c option is used, │ │ │ │ │ +000324e0: 2074 6865 2066 6972 7374 2064 6576 6963 the first devic │ │ │ │ │ +000324f0: 6520 666f 756e 6420 6973 2073 6574 2061 e found is set a │ │ │ │ │ +00032500: 7320 7468 650a 2020 2020 2076 616c 7565 s the. value │ │ │ │ │ +00032510: 206f 6620 656e 7669 726f 6e6d 656e 7420 of environment │ │ │ │ │ +00032520: 7661 7269 6162 6c65 2056 4152 2e20 2054 variable VAR. T │ │ │ │ │ +00032530: 6865 2064 6566 6175 6c74 2076 6172 6961 he default varia │ │ │ │ │ +00032540: 626c 6520 6973 2027 726f 6f74 272e 0a0a ble is 'root'... │ │ │ │ │ +00032550: 2020 2020 2054 6865 2027 2d2d 6e6f 2d66 The '--no-f │ │ │ │ │ +00032560: 6c6f 7070 7927 206f 7074 696f 6e20 7072 loppy' option pr │ │ │ │ │ +00032570: 6576 656e 7473 2073 6561 7263 6869 6e67 events searching │ │ │ │ │ +00032580: 2066 6c6f 7070 7920 6465 7669 6365 732c floppy devices, │ │ │ │ │ +00032590: 2077 6869 6368 0a20 2020 2020 6361 6e20 which. can │ │ │ │ │ +000325a0: 6265 2073 6c6f 772e 0a0a 2020 2020 2054 be slow... T │ │ │ │ │ +000325b0: 6865 2027 7365 6172 6368 2e66 696c 6527 he 'search.file' │ │ │ │ │ +000325c0: 2c20 2773 6561 7263 682e 6673 5f6c 6162 , 'search.fs_lab │ │ │ │ │ +000325d0: 656c 272c 2061 6e64 2027 7365 6172 6368 el', and 'search │ │ │ │ │ +000325e0: 2e66 735f 7575 6964 2720 636f 6d6d 616e .fs_uuid' comman │ │ │ │ │ +000325f0: 6473 0a20 2020 2020 6172 6520 616c 6961 ds. are alia │ │ │ │ │ +00032600: 7365 7320 666f 7220 2773 6561 7263 6820 ses for 'search │ │ │ │ │ +00032610: 2d2d 6669 6c65 272c 2027 7365 6172 6368 --file', 'search │ │ │ │ │ +00032620: 202d 2d6c 6162 656c 272c 2061 6e64 2027 --label', and ' │ │ │ │ │ +00032630: 7365 6172 6368 0a20 2020 2020 2d2d 6673 search. --fs │ │ │ │ │ +00032640: 2d75 7569 6427 2072 6573 7065 6374 6976 -uuid' respectiv │ │ │ │ │ +00032650: 656c 792e 0a0a 1f0a 4669 6c65 3a20 6772 ely.....File: gr │ │ │ │ │ +00032660: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00032670: 7365 6e64 6b65 792c 2020 4e65 7874 3a20 sendkey, Next: │ │ │ │ │ +00032680: 7365 742c 2020 5072 6576 3a20 7365 6172 set, Prev: sear │ │ │ │ │ +00032690: 6368 2c20 2055 703a 2043 6f6d 6d61 6e64 ch, Up: Command │ │ │ │ │ +000326a0: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +000326b0: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +000326c0: 362e 332e 3636 2073 656e 646b 6579 0a2d 6.3.66 sendkey.- │ │ │ │ │ +000326d0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +000326e0: 202d 2d20 436f 6d6d 616e 643a 2073 656e -- Command: sen │ │ │ │ │ +000326f0: 646b 6579 0a20 2020 2020 2020 2020 205b dkey. [ │ │ │ │ │ +00032700: 2d2d 6e75 6d7c 2d2d 6361 7073 7c2d 2d73 --num|--caps|--s │ │ │ │ │ +00032710: 6372 6f6c 6c7c 2d2d 696e 7365 7274 7c2d croll|--insert|- │ │ │ │ │ +00032720: 2d70 6175 7365 7c2d 2d6c 6566 742d 7368 -pause|--left-sh │ │ │ │ │ +00032730: 6966 747c 2d2d 7269 6768 742d 7368 6966 ift|--right-shif │ │ │ │ │ +00032740: 747c 2d2d 7379 7372 717c 2d2d 6e75 6d6b t|--sysrq|--numk │ │ │ │ │ +00032750: 6579 7c2d 2d63 6170 736b 6579 7c2d 2d73 ey|--capskey|--s │ │ │ │ │ +00032760: 6372 6f6c 6c6b 6579 7c2d 2d69 6e73 6572 crollkey|--inser │ │ │ │ │ +00032770: 746b 6579 7c2d 2d6c 6566 742d 616c 747c tkey|--left-alt| │ │ │ │ │ +00032780: 2d2d 7269 6768 742d 616c 747c 2d2d 6c65 --right-alt|--le │ │ │ │ │ +00032790: 6674 2d63 7472 6c7c 2d2d 7269 6768 742d ft-ctrl|--right- │ │ │ │ │ +000327a0: 6374 726c 0a20 2020 2020 2020 2020 206f ctrl. o │ │ │ │ │ +000327b0: 6e7c 6f66 665d 2e2e 2e20 5b6e 6f2d 6c65 n|off]... [no-le │ │ │ │ │ +000327c0: 645d 206b 6579 7374 726f 6b65 0a20 2020 d] keystroke. │ │ │ │ │ +000327d0: 2020 496e 7365 7274 206b 6579 7374 726f Insert keystro │ │ │ │ │ +000327e0: 6b65 7320 696e 746f 2074 6865 206b 6579 kes into the key │ │ │ │ │ +000327f0: 626f 6172 6420 6275 6666 6572 2077 6865 board buffer whe │ │ │ │ │ +00032800: 6e20 626f 6f74 696e 672e 2020 536f 6d65 n booting. Some │ │ │ │ │ +00032810: 7469 6d65 730a 2020 2020 2061 6e20 6f70 times. an op │ │ │ │ │ +00032820: 6572 6174 696e 6720 7379 7374 656d 206f erating system o │ │ │ │ │ +00032830: 7220 6368 6169 6e6c 6f61 6465 6420 626f r chainloaded bo │ │ │ │ │ +00032840: 6f74 206c 6f61 6465 7220 7265 7175 6972 ot loader requir │ │ │ │ │ +00032850: 6573 2070 6172 7469 6375 6c61 720a 2020 es particular. │ │ │ │ │ +00032860: 2020 206b 6579 7320 746f 2062 6520 7072 keys to be pr │ │ │ │ │ +00032870: 6573 7365 643a 2066 6f72 2065 7861 6d70 essed: for examp │ │ │ │ │ +00032880: 6c65 2c20 6f6e 6520 6d69 6768 7420 6e65 le, one might ne │ │ │ │ │ +00032890: 6564 2074 6f20 7072 6573 7320 610a 2020 ed to press a. │ │ │ │ │ +000328a0: 2020 2070 6172 7469 6375 6c61 7220 6b65 particular ke │ │ │ │ │ +000328b0: 7920 746f 2065 6e74 6572 2022 7361 6665 y to enter "safe │ │ │ │ │ +000328c0: 206d 6f64 6522 2c20 6f72 2077 6865 6e20 mode", or when │ │ │ │ │ +000328d0: 6368 6169 6e6c 6f61 6469 6e67 2061 6e6f chainloading ano │ │ │ │ │ +000328e0: 7468 6572 0a20 2020 2020 626f 6f74 206c ther. boot l │ │ │ │ │ +000328f0: 6f61 6465 7220 6f6e 6520 6d69 6768 7420 oader one might │ │ │ │ │ +00032900: 7365 6e64 206b 6579 7374 726f 6b65 7320 send keystrokes │ │ │ │ │ +00032910: 746f 2069 7420 746f 206e 6176 6967 6174 to it to navigat │ │ │ │ │ +00032920: 6520 6974 7320 6d65 6e75 2e0a 0a20 2020 e its menu... │ │ │ │ │ +00032930: 2020 596f 7520 6d61 7920 7072 6f76 6964 You may provid │ │ │ │ │ +00032940: 6520 7570 2074 6f20 3136 206b 6579 7374 e up to 16 keyst │ │ │ │ │ +00032950: 726f 6b65 7320 2874 6865 206c 656e 6774 rokes (the lengt │ │ │ │ │ +00032960: 6820 6f66 2074 6865 2042 494f 530a 2020 h of the BIOS. │ │ │ │ │ +00032970: 2020 206b 6579 626f 6172 6420 6275 6666 keyboard buff │ │ │ │ │ +00032980: 6572 292e 2020 4b65 7973 7472 6f6b 6520 er). Keystroke │ │ │ │ │ +00032990: 6e61 6d65 7320 6d61 7920 6265 2075 7070 names may be upp │ │ │ │ │ +000329a0: 6572 2d63 6173 6520 6f72 206c 6f77 6572 er-case or lower │ │ │ │ │ +000329b0: 2d63 6173 650a 2020 2020 206c 6574 7465 -case. lette │ │ │ │ │ +000329c0: 7273 2c20 6469 6769 7473 2c20 6f72 2074 rs, digits, or t │ │ │ │ │ +000329d0: 616b 656e 2066 726f 6d20 7468 6520 666f aken from the fo │ │ │ │ │ +000329e0: 6c6c 6f77 696e 6720 7461 626c 653a 0a0a llowing table:.. │ │ │ │ │ +000329f0: 2020 2020 204e 616d 6520 2020 2020 2020 Name │ │ │ │ │ 00032a00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032a10: 204b 6579 0a20 2020 2020 2d2d 2d2d 2d2d Key. ------ │ │ │ │ │ +00032a10: 2020 204b 6579 0a20 2020 2020 2d2d 2d2d Key. ---- │ │ │ │ │ 00032a20: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00032a30: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 00032a40: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00032a50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 2020 -------------. │ │ │ │ │ -00032a60: 2020 2065 7363 6170 6520 2020 2020 2020 escape │ │ │ │ │ +00032a50: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00032a60: 2020 2020 2065 7363 6170 6520 2020 2020 escape │ │ │ │ │ 00032a70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032a80: 2045 7363 6170 650a 2020 2020 2065 7863 Escape. exc │ │ │ │ │ -00032a90: 6c61 6d20 2020 2020 2020 2020 2020 2020 lam │ │ │ │ │ -00032aa0: 2020 2020 2020 2020 2020 2021 0a20 2020 !. │ │ │ │ │ -00032ab0: 2020 6174 2020 2020 2020 2020 2020 2020 at │ │ │ │ │ +00032a80: 2020 2045 7363 6170 650a 2020 2020 2065 Escape. e │ │ │ │ │ +00032a90: 7863 6c61 6d20 2020 2020 2020 2020 2020 xclam │ │ │ │ │ +00032aa0: 2020 2020 2020 2020 2020 2020 2021 0a20 !. │ │ │ │ │ +00032ab0: 2020 2020 6174 2020 2020 2020 2020 2020 at │ │ │ │ │ 00032ac0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032ad0: 400a 2020 2020 206e 756d 6265 7273 6967 @. numbersig │ │ │ │ │ -00032ae0: 6e20 2020 2020 2020 2020 2020 2020 2020 n │ │ │ │ │ -00032af0: 2020 2020 2023 0a20 2020 2020 646f 6c6c #. doll │ │ │ │ │ -00032b00: 6172 2020 2020 2020 2020 2020 2020 2020 ar │ │ │ │ │ -00032b10: 2020 2020 2020 2020 2020 240a 2020 2020 $. │ │ │ │ │ -00032b20: 2070 6572 6365 6e74 2020 2020 2020 2020 percent │ │ │ │ │ -00032b30: 2020 2020 2020 2020 2020 2020 2020 2025 % │ │ │ │ │ -00032b40: 0a20 2020 2020 6361 7265 7420 2020 2020 . caret │ │ │ │ │ +00032ad0: 2020 400a 2020 2020 206e 756d 6265 7273 @. numbers │ │ │ │ │ +00032ae0: 6967 6e20 2020 2020 2020 2020 2020 2020 ign │ │ │ │ │ +00032af0: 2020 2020 2020 2023 0a20 2020 2020 646f #. do │ │ │ │ │ +00032b00: 6c6c 6172 2020 2020 2020 2020 2020 2020 llar │ │ │ │ │ +00032b10: 2020 2020 2020 2020 2020 2020 240a 2020 $. │ │ │ │ │ +00032b20: 2020 2070 6572 6365 6e74 2020 2020 2020 percent │ │ │ │ │ +00032b30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032b40: 2025 0a20 2020 2020 6361 7265 7420 2020 %. caret │ │ │ │ │ 00032b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032b60: 2020 2020 5e0a 2020 2020 2061 6d70 6572 ^. amper │ │ │ │ │ -00032b70: 7361 6e64 2020 2020 2020 2020 2020 2020 sand │ │ │ │ │ -00032b80: 2020 2020 2020 2020 2026 0a20 2020 2020 &. │ │ │ │ │ -00032b90: 6173 7465 7269 736b 2020 2020 2020 2020 asterisk │ │ │ │ │ -00032ba0: 2020 2020 2020 2020 2020 2020 2020 2a0a *. │ │ │ │ │ -00032bb0: 2020 2020 2070 6172 656e 6c65 6674 2020 parenleft │ │ │ │ │ +00032b60: 2020 2020 2020 5e0a 2020 2020 2061 6d70 ^. amp │ │ │ │ │ +00032b70: 6572 7361 6e64 2020 2020 2020 2020 2020 ersand │ │ │ │ │ +00032b80: 2020 2020 2020 2020 2020 2026 0a20 2020 &. │ │ │ │ │ +00032b90: 2020 6173 7465 7269 736b 2020 2020 2020 asterisk │ │ │ │ │ +00032ba0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032bb0: 2a0a 2020 2020 2070 6172 656e 6c65 6674 *. parenleft │ │ │ │ │ 00032bc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032bd0: 2020 2028 0a20 2020 2020 7061 7265 6e72 (. parenr │ │ │ │ │ -00032be0: 6967 6874 2020 2020 2020 2020 2020 2020 ight │ │ │ │ │ -00032bf0: 2020 2020 2020 2020 290a 2020 2020 206d ). m │ │ │ │ │ -00032c00: 696e 7573 2020 2020 2020 2020 2020 2020 inus │ │ │ │ │ -00032c10: 2020 2020 2020 2020 2020 2020 202d 0a20 -. │ │ │ │ │ -00032c20: 2020 2020 756e 6465 7273 636f 7265 2020 underscore │ │ │ │ │ +00032bd0: 2020 2020 2028 0a20 2020 2020 7061 7265 (. pare │ │ │ │ │ +00032be0: 6e72 6967 6874 2020 2020 2020 2020 2020 nright │ │ │ │ │ +00032bf0: 2020 2020 2020 2020 2020 290a 2020 2020 ). │ │ │ │ │ +00032c00: 206d 696e 7573 2020 2020 2020 2020 2020 minus │ │ │ │ │ +00032c10: 2020 2020 2020 2020 2020 2020 2020 202d - │ │ │ │ │ +00032c20: 0a20 2020 2020 756e 6465 7273 636f 7265 . underscore │ │ │ │ │ 00032c30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032c40: 2020 5f0a 2020 2020 2065 7175 616c 2020 _. equal │ │ │ │ │ +00032c40: 2020 2020 5f0a 2020 2020 2065 7175 616c _. equal │ │ │ │ │ 00032c50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032c60: 2020 2020 2020 203d 0a20 2020 2020 706c =. pl │ │ │ │ │ -00032c70: 7573 2020 2020 2020 2020 2020 2020 2020 us │ │ │ │ │ -00032c80: 2020 2020 2020 2020 2020 2020 2b0a 2020 +. │ │ │ │ │ -00032c90: 2020 2062 6163 6b73 7061 6365 2020 2020 backspace │ │ │ │ │ +00032c60: 2020 2020 2020 2020 203d 0a20 2020 2020 =. │ │ │ │ │ +00032c70: 706c 7573 2020 2020 2020 2020 2020 2020 plus │ │ │ │ │ +00032c80: 2020 2020 2020 2020 2020 2020 2020 2b0a +. │ │ │ │ │ +00032c90: 2020 2020 2062 6163 6b73 7061 6365 2020 backspace │ │ │ │ │ 00032ca0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032cb0: 2042 6163 6b73 7061 6365 0a20 2020 2020 Backspace. │ │ │ │ │ -00032cc0: 7461 6220 2020 2020 2020 2020 2020 2020 tab │ │ │ │ │ -00032cd0: 2020 2020 2020 2020 2020 2020 2020 5461 Ta │ │ │ │ │ -00032ce0: 620a 2020 2020 2062 7261 636b 6574 6c65 b. bracketle │ │ │ │ │ -00032cf0: 6674 2020 2020 2020 2020 2020 2020 2020 ft │ │ │ │ │ -00032d00: 2020 2020 205b 0a20 2020 2020 6272 6163 [. brac │ │ │ │ │ -00032d10: 656c 6566 7420 2020 2020 2020 2020 2020 eleft │ │ │ │ │ -00032d20: 2020 2020 2020 2020 2020 7b0a 2020 2020 {. │ │ │ │ │ -00032d30: 2062 7261 636b 6574 7269 6768 7420 2020 bracketright │ │ │ │ │ -00032d40: 2020 2020 2020 2020 2020 2020 2020 205d ] │ │ │ │ │ -00032d50: 0a20 2020 2020 6272 6163 6572 6967 6874 . braceright │ │ │ │ │ -00032d60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032d70: 2020 2020 7d0a 2020 2020 2065 6e74 6572 }. enter │ │ │ │ │ -00032d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032d90: 2020 2020 2020 2020 2045 6e74 6572 0a20 Enter. │ │ │ │ │ -00032da0: 2020 2020 636f 6e74 726f 6c20 2020 2020 control │ │ │ │ │ +00032cb0: 2020 2042 6163 6b73 7061 6365 0a20 2020 Backspace. │ │ │ │ │ +00032cc0: 2020 7461 6220 2020 2020 2020 2020 2020 tab │ │ │ │ │ +00032cd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032ce0: 5461 620a 2020 2020 2062 7261 636b 6574 Tab. bracket │ │ │ │ │ +00032cf0: 6c65 6674 2020 2020 2020 2020 2020 2020 left │ │ │ │ │ +00032d00: 2020 2020 2020 205b 0a20 2020 2020 6272 [. br │ │ │ │ │ +00032d10: 6163 656c 6566 7420 2020 2020 2020 2020 aceleft │ │ │ │ │ +00032d20: 2020 2020 2020 2020 2020 2020 7b0a 2020 {. │ │ │ │ │ +00032d30: 2020 2062 7261 636b 6574 7269 6768 7420 bracketright │ │ │ │ │ +00032d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032d50: 205d 0a20 2020 2020 6272 6163 6572 6967 ]. bracerig │ │ │ │ │ +00032d60: 6874 2020 2020 2020 2020 2020 2020 2020 ht │ │ │ │ │ +00032d70: 2020 2020 2020 7d0a 2020 2020 2065 6e74 }. ent │ │ │ │ │ +00032d80: 6572 2020 2020 2020 2020 2020 2020 2020 er │ │ │ │ │ +00032d90: 2020 2020 2020 2020 2020 2045 6e74 6572 Enter │ │ │ │ │ +00032da0: 0a20 2020 2020 636f 6e74 726f 6c20 2020 . control │ │ │ │ │ 00032db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032dc0: 2020 7072 6573 7320 616e 6420 7265 6c65 press and rele │ │ │ │ │ -00032dd0: 6173 6520 436f 6e74 726f 6c0a 2020 2020 ase Control. │ │ │ │ │ -00032de0: 2073 656d 6963 6f6c 6f6e 2020 2020 2020 semicolon │ │ │ │ │ -00032df0: 2020 2020 2020 2020 2020 2020 2020 203b ; │ │ │ │ │ -00032e00: 0a20 2020 2020 636f 6c6f 6e20 2020 2020 . colon │ │ │ │ │ +00032dc0: 2020 2020 7072 6573 7320 616e 6420 7265 press and re │ │ │ │ │ +00032dd0: 6c65 6173 6520 436f 6e74 726f 6c0a 2020 lease Control. │ │ │ │ │ +00032de0: 2020 2073 656d 6963 6f6c 6f6e 2020 2020 semicolon │ │ │ │ │ +00032df0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032e00: 203b 0a20 2020 2020 636f 6c6f 6e20 2020 ;. colon │ │ │ │ │ 00032e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032e20: 2020 2020 3a0a 2020 2020 2071 756f 7465 :. quote │ │ │ │ │ -00032e30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032e40: 2020 2020 2020 2020 2027 0a20 2020 2020 '. │ │ │ │ │ -00032e50: 646f 7562 6c65 7175 6f74 6520 2020 2020 doublequote │ │ │ │ │ -00032e60: 2020 2020 2020 2020 2020 2020 2020 220a ". │ │ │ │ │ -00032e70: 2020 2020 2062 6163 6b71 756f 7465 2020 backquote │ │ │ │ │ +00032e20: 2020 2020 2020 3a0a 2020 2020 2071 756f :. quo │ │ │ │ │ +00032e30: 7465 2020 2020 2020 2020 2020 2020 2020 te │ │ │ │ │ +00032e40: 2020 2020 2020 2020 2020 2027 0a20 2020 '. │ │ │ │ │ +00032e50: 2020 646f 7562 6c65 7175 6f74 6520 2020 doublequote │ │ │ │ │ +00032e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00032e70: 220a 2020 2020 2062 6163 6b71 756f 7465 ". backquote │ │ │ │ │ 00032e80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032e90: 2020 2027 0a20 2020 2020 7469 6c64 6520 '. tilde │ │ │ │ │ -00032ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032eb0: 2020 2020 2020 2020 7e0a 2020 2020 2073 ~. s │ │ │ │ │ -00032ec0: 6869 6674 2020 2020 2020 2020 2020 2020 hift │ │ │ │ │ -00032ed0: 2020 2020 2020 2020 2020 2020 2070 7265 pre │ │ │ │ │ -00032ee0: 7373 2061 6e64 2072 656c 6561 7365 206c ss and release l │ │ │ │ │ -00032ef0: 6566 7420 5368 6966 740a 2020 2020 2062 eft Shift. b │ │ │ │ │ -00032f00: 6163 6b73 6c61 7368 2020 2020 2020 2020 ackslash │ │ │ │ │ -00032f10: 2020 2020 2020 2020 2020 2020 205c 0a20 \. │ │ │ │ │ -00032f20: 2020 2020 6261 7220 2020 2020 2020 2020 bar │ │ │ │ │ +00032e90: 2020 2020 2027 0a20 2020 2020 7469 6c64 '. tild │ │ │ │ │ +00032ea0: 6520 2020 2020 2020 2020 2020 2020 2020 e │ │ │ │ │ +00032eb0: 2020 2020 2020 2020 2020 7e0a 2020 2020 ~. │ │ │ │ │ +00032ec0: 2073 6869 6674 2020 2020 2020 2020 2020 shift │ │ │ │ │ +00032ed0: 2020 2020 2020 2020 2020 2020 2020 2070 p │ │ │ │ │ +00032ee0: 7265 7373 2061 6e64 2072 656c 6561 7365 ress and release │ │ │ │ │ +00032ef0: 206c 6566 7420 5368 6966 740a 2020 2020 left Shift. │ │ │ │ │ +00032f00: 2062 6163 6b73 6c61 7368 2020 2020 2020 backslash │ │ │ │ │ +00032f10: 2020 2020 2020 2020 2020 2020 2020 205c \ │ │ │ │ │ +00032f20: 0a20 2020 2020 6261 7220 2020 2020 2020 . bar │ │ │ │ │ 00032f30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032f40: 2020 7c0a 2020 2020 2063 6f6d 6d61 2020 |. comma │ │ │ │ │ +00032f40: 2020 2020 7c0a 2020 2020 2063 6f6d 6d61 |. comma │ │ │ │ │ 00032f50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032f60: 2020 2020 2020 202c 0a20 2020 2020 6c65 ,. le │ │ │ │ │ -00032f70: 7373 2020 2020 2020 2020 2020 2020 2020 ss │ │ │ │ │ -00032f80: 2020 2020 2020 2020 2020 2020 3c0a 2020 <. │ │ │ │ │ -00032f90: 2020 2070 6572 696f 6420 2020 2020 2020 period │ │ │ │ │ +00032f60: 2020 2020 2020 2020 202c 0a20 2020 2020 ,. │ │ │ │ │ +00032f70: 6c65 7373 2020 2020 2020 2020 2020 2020 less │ │ │ │ │ +00032f80: 2020 2020 2020 2020 2020 2020 2020 3c0a <. │ │ │ │ │ +00032f90: 2020 2020 2070 6572 696f 6420 2020 2020 period │ │ │ │ │ 00032fa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032fb0: 202e 0a20 2020 2020 6772 6561 7465 7220 .. greater │ │ │ │ │ -00032fc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00032fd0: 2020 2020 2020 3e0a 2020 2020 2073 6c61 >. sla │ │ │ │ │ -00032fe0: 7368 2020 2020 2020 2020 2020 2020 2020 sh │ │ │ │ │ -00032ff0: 2020 2020 2020 2020 2020 202f 0a20 2020 /. │ │ │ │ │ -00033000: 2020 7175 6573 7469 6f6e 2020 2020 2020 question │ │ │ │ │ +00032fb0: 2020 202e 0a20 2020 2020 6772 6561 7465 .. greate │ │ │ │ │ +00032fc0: 7220 2020 2020 2020 2020 2020 2020 2020 r │ │ │ │ │ +00032fd0: 2020 2020 2020 2020 3e0a 2020 2020 2073 >. s │ │ │ │ │ +00032fe0: 6c61 7368 2020 2020 2020 2020 2020 2020 lash │ │ │ │ │ +00032ff0: 2020 2020 2020 2020 2020 2020 202f 0a20 /. │ │ │ │ │ +00033000: 2020 2020 7175 6573 7469 6f6e 2020 2020 question │ │ │ │ │ 00033010: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033020: 3f0a 2020 2020 2072 7368 6966 7420 2020 ?. rshift │ │ │ │ │ +00033020: 2020 3f0a 2020 2020 2072 7368 6966 7420 ?. rshift │ │ │ │ │ 00033030: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033040: 2020 2020 2070 7265 7373 2061 6e64 2072 press and r │ │ │ │ │ -00033050: 656c 6561 7365 2072 6967 6874 2053 6869 elease right Shi │ │ │ │ │ -00033060: 6674 0a20 2020 2020 616c 7420 2020 2020 ft. alt │ │ │ │ │ +00033040: 2020 2020 2020 2070 7265 7373 2061 6e64 press and │ │ │ │ │ +00033050: 2072 656c 6561 7365 2072 6967 6874 2053 release right S │ │ │ │ │ +00033060: 6869 6674 0a20 2020 2020 616c 7420 2020 hift. alt │ │ │ │ │ 00033070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033080: 2020 2020 2020 7072 6573 7320 616e 6420 press and │ │ │ │ │ -00033090: 7265 6c65 6173 6520 416c 740a 2020 2020 release Alt. │ │ │ │ │ -000330a0: 2073 7061 6365 2020 2020 2020 2020 2020 space │ │ │ │ │ -000330b0: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ -000330c0: 7061 6365 2062 6172 0a20 2020 2020 6361 pace bar. ca │ │ │ │ │ -000330d0: 7073 6c6f 636b 2020 2020 2020 2020 2020 pslock │ │ │ │ │ -000330e0: 2020 2020 2020 2020 2020 2020 4361 7073 Caps │ │ │ │ │ -000330f0: 204c 6f63 6b0a 2020 2020 2046 3120 2020 Lock. F1 │ │ │ │ │ +00033080: 2020 2020 2020 2020 7072 6573 7320 616e press an │ │ │ │ │ +00033090: 6420 7265 6c65 6173 6520 416c 740a 2020 d release Alt. │ │ │ │ │ +000330a0: 2020 2073 7061 6365 2020 2020 2020 2020 space │ │ │ │ │ +000330b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000330c0: 2073 7061 6365 2062 6172 0a20 2020 2020 space bar. │ │ │ │ │ +000330d0: 6361 7073 6c6f 636b 2020 2020 2020 2020 capslock │ │ │ │ │ +000330e0: 2020 2020 2020 2020 2020 2020 2020 4361 Ca │ │ │ │ │ +000330f0: 7073 204c 6f63 6b0a 2020 2020 2046 3120 ps Lock. F1 │ │ │ │ │ 00033100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033110: 2020 2020 2020 2020 2046 310a 2020 2020 F1. │ │ │ │ │ -00033120: 2046 3220 2020 2020 2020 2020 2020 2020 F2 │ │ │ │ │ -00033130: 2020 2020 2020 2020 2020 2020 2020 2046 F │ │ │ │ │ -00033140: 320a 2020 2020 2046 3320 2020 2020 2020 2. F3 │ │ │ │ │ +00033110: 2020 2020 2020 2020 2020 2046 310a 2020 F1. │ │ │ │ │ +00033120: 2020 2046 3220 2020 2020 2020 2020 2020 F2 │ │ │ │ │ +00033130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033140: 2046 320a 2020 2020 2046 3320 2020 2020 F2. F3 │ │ │ │ │ 00033150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033160: 2020 2020 2046 330a 2020 2020 2046 3420 F3. F4 │ │ │ │ │ -00033170: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033180: 2020 2020 2020 2020 2020 2046 340a 2020 F4. │ │ │ │ │ -00033190: 2020 2046 3520 2020 2020 2020 2020 2020 F5 │ │ │ │ │ +00033160: 2020 2020 2020 2046 330a 2020 2020 2046 F3. F │ │ │ │ │ +00033170: 3420 2020 2020 2020 2020 2020 2020 2020 4 │ │ │ │ │ +00033180: 2020 2020 2020 2020 2020 2020 2046 340a F4. │ │ │ │ │ +00033190: 2020 2020 2046 3520 2020 2020 2020 2020 F5 │ │ │ │ │ 000331a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000331b0: 2046 350a 2020 2020 2046 3620 2020 2020 F5. F6 │ │ │ │ │ +000331b0: 2020 2046 350a 2020 2020 2046 3620 2020 F5. F6 │ │ │ │ │ 000331c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000331d0: 2020 2020 2020 2046 360a 2020 2020 2046 F6. F │ │ │ │ │ -000331e0: 3720 2020 2020 2020 2020 2020 2020 2020 7 │ │ │ │ │ -000331f0: 2020 2020 2020 2020 2020 2020 2046 370a F7. │ │ │ │ │ -00033200: 2020 2020 2046 3820 2020 2020 2020 2020 F8 │ │ │ │ │ +000331d0: 2020 2020 2020 2020 2046 360a 2020 2020 F6. │ │ │ │ │ +000331e0: 2046 3720 2020 2020 2020 2020 2020 2020 F7 │ │ │ │ │ +000331f0: 2020 2020 2020 2020 2020 2020 2020 2046 F │ │ │ │ │ +00033200: 370a 2020 2020 2046 3820 2020 2020 2020 7. F8 │ │ │ │ │ 00033210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033220: 2020 2046 380a 2020 2020 2046 3920 2020 F8. F9 │ │ │ │ │ +00033220: 2020 2020 2046 380a 2020 2020 2046 3920 F8. F9 │ │ │ │ │ 00033230: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033240: 2020 2020 2020 2020 2046 390a 2020 2020 F9. │ │ │ │ │ -00033250: 2046 3130 2020 2020 2020 2020 2020 2020 F10 │ │ │ │ │ -00033260: 2020 2020 2020 2020 2020 2020 2020 2046 F │ │ │ │ │ -00033270: 3130 0a20 2020 2020 4631 3120 2020 2020 10. F11 │ │ │ │ │ +00033240: 2020 2020 2020 2020 2020 2046 390a 2020 F9. │ │ │ │ │ +00033250: 2020 2046 3130 2020 2020 2020 2020 2020 F10 │ │ │ │ │ +00033260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033270: 2046 3130 0a20 2020 2020 4631 3120 2020 F10. F11 │ │ │ │ │ 00033280: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033290: 2020 2020 2020 4631 310a 2020 2020 2046 F11. F │ │ │ │ │ -000332a0: 3132 2020 2020 2020 2020 2020 2020 2020 12 │ │ │ │ │ -000332b0: 2020 2020 2020 2020 2020 2020 2046 3132 F12 │ │ │ │ │ -000332c0: 0a20 2020 2020 6e75 6d31 2020 2020 2020 . num1 │ │ │ │ │ +00033290: 2020 2020 2020 2020 4631 310a 2020 2020 F11. │ │ │ │ │ +000332a0: 2046 3132 2020 2020 2020 2020 2020 2020 F12 │ │ │ │ │ +000332b0: 2020 2020 2020 2020 2020 2020 2020 2046 F │ │ │ │ │ +000332c0: 3132 0a20 2020 2020 6e75 6d31 2020 2020 12. num1 │ │ │ │ │ 000332d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000332e0: 2020 2020 3120 286e 756d 6572 6963 206b 1 (numeric k │ │ │ │ │ -000332f0: 6579 7061 6429 0a20 2020 2020 6e75 6d32 eypad). num2 │ │ │ │ │ -00033300: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033310: 2020 2020 2020 2020 2020 3220 286e 756d 2 (num │ │ │ │ │ -00033320: 6572 6963 206b 6579 7061 6429 0a20 2020 eric keypad). │ │ │ │ │ -00033330: 2020 6e75 6d33 2020 2020 2020 2020 2020 num3 │ │ │ │ │ +000332e0: 2020 2020 2020 3120 286e 756d 6572 6963 1 (numeric │ │ │ │ │ +000332f0: 206b 6579 7061 6429 0a20 2020 2020 6e75 keypad). nu │ │ │ │ │ +00033300: 6d32 2020 2020 2020 2020 2020 2020 2020 m2 │ │ │ │ │ +00033310: 2020 2020 2020 2020 2020 2020 3220 286e 2 (n │ │ │ │ │ +00033320: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ │ +00033330: 2020 2020 6e75 6d33 2020 2020 2020 2020 num3 │ │ │ │ │ 00033340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033350: 3320 286e 756d 6572 6963 206b 6579 7061 3 (numeric keypa │ │ │ │ │ -00033360: 6429 0a20 2020 2020 6e75 6d34 2020 2020 d). num4 │ │ │ │ │ +00033350: 2020 3320 286e 756d 6572 6963 206b 6579 3 (numeric key │ │ │ │ │ +00033360: 7061 6429 0a20 2020 2020 6e75 6d34 2020 pad). num4 │ │ │ │ │ 00033370: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033380: 2020 2020 2020 3420 286e 756d 6572 6963 4 (numeric │ │ │ │ │ -00033390: 206b 6579 7061 6429 0a20 2020 2020 6e75 keypad). nu │ │ │ │ │ -000333a0: 6d35 2020 2020 2020 2020 2020 2020 2020 m5 │ │ │ │ │ -000333b0: 2020 2020 2020 2020 2020 2020 3520 286e 5 (n │ │ │ │ │ -000333c0: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ │ -000333d0: 2020 2020 6e75 6d36 2020 2020 2020 2020 num6 │ │ │ │ │ +00033380: 2020 2020 2020 2020 3420 286e 756d 6572 4 (numer │ │ │ │ │ +00033390: 6963 206b 6579 7061 6429 0a20 2020 2020 ic keypad). │ │ │ │ │ +000333a0: 6e75 6d35 2020 2020 2020 2020 2020 2020 num5 │ │ │ │ │ +000333b0: 2020 2020 2020 2020 2020 2020 2020 3520 5 │ │ │ │ │ +000333c0: 286e 756d 6572 6963 206b 6579 7061 6429 (numeric keypad) │ │ │ │ │ +000333d0: 0a20 2020 2020 6e75 6d36 2020 2020 2020 . num6 │ │ │ │ │ 000333e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000333f0: 2020 3620 286e 756d 6572 6963 206b 6579 6 (numeric key │ │ │ │ │ -00033400: 7061 6429 0a20 2020 2020 6e75 6d37 2020 pad). num7 │ │ │ │ │ +000333f0: 2020 2020 3620 286e 756d 6572 6963 206b 6 (numeric k │ │ │ │ │ +00033400: 6579 7061 6429 0a20 2020 2020 6e75 6d37 eypad). num7 │ │ │ │ │ 00033410: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033420: 2020 2020 2020 2020 3720 286e 756d 6572 7 (numer │ │ │ │ │ -00033430: 6963 206b 6579 7061 6429 0a20 2020 2020 ic keypad). │ │ │ │ │ -00033440: 6e75 6d38 2020 2020 2020 2020 2020 2020 num8 │ │ │ │ │ -00033450: 2020 2020 2020 2020 2020 2020 2020 3820 8 │ │ │ │ │ -00033460: 286e 756d 6572 6963 206b 6579 7061 6429 (numeric keypad) │ │ │ │ │ -00033470: 0a20 2020 2020 6e75 6d39 2020 2020 2020 . num9 │ │ │ │ │ +00033420: 2020 2020 2020 2020 2020 3720 286e 756d 7 (num │ │ │ │ │ +00033430: 6572 6963 206b 6579 7061 6429 0a20 2020 eric keypad). │ │ │ │ │ +00033440: 2020 6e75 6d38 2020 2020 2020 2020 2020 num8 │ │ │ │ │ +00033450: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033460: 3820 286e 756d 6572 6963 206b 6579 7061 8 (numeric keypa │ │ │ │ │ +00033470: 6429 0a20 2020 2020 6e75 6d39 2020 2020 d). num9 │ │ │ │ │ 00033480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033490: 2020 2020 3920 286e 756d 6572 6963 206b 9 (numeric k │ │ │ │ │ -000334a0: 6579 7061 6429 0a20 2020 2020 6e75 6d30 eypad). num0 │ │ │ │ │ -000334b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000334c0: 2020 2020 2020 2020 2020 3020 286e 756d 0 (num │ │ │ │ │ -000334d0: 6572 6963 206b 6579 7061 6429 0a20 2020 eric keypad). │ │ │ │ │ -000334e0: 2020 6e75 6d70 6572 696f 6420 2020 2020 numperiod │ │ │ │ │ +00033490: 2020 2020 2020 3920 286e 756d 6572 6963 9 (numeric │ │ │ │ │ +000334a0: 206b 6579 7061 6429 0a20 2020 2020 6e75 keypad). nu │ │ │ │ │ +000334b0: 6d30 2020 2020 2020 2020 2020 2020 2020 m0 │ │ │ │ │ +000334c0: 2020 2020 2020 2020 2020 2020 3020 286e 0 (n │ │ │ │ │ +000334d0: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ │ +000334e0: 2020 2020 6e75 6d70 6572 696f 6420 2020 numperiod │ │ │ │ │ 000334f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033500: 2e20 2028 6e75 6d65 7269 6320 6b65 7970 . (numeric keyp │ │ │ │ │ -00033510: 6164 290a 2020 2020 206e 756d 656e 6420 ad). numend │ │ │ │ │ -00033520: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033530: 2020 2020 2020 2045 6e64 2028 6e75 6d65 End (nume │ │ │ │ │ -00033540: 7269 6320 6b65 7970 6164 290a 2020 2020 ric keypad). │ │ │ │ │ -00033550: 206e 756d 646f 776e 2020 2020 2020 2020 numdown │ │ │ │ │ -00033560: 2020 2020 2020 2020 2020 2020 2020 2044 D │ │ │ │ │ -00033570: 6f77 6e20 286e 756d 6572 6963 206b 6579 own (numeric key │ │ │ │ │ -00033580: 7061 6429 0a20 2020 2020 6e75 6d70 6764 pad). numpgd │ │ │ │ │ -00033590: 6f77 6e20 2020 2020 2020 2020 2020 2020 own │ │ │ │ │ -000335a0: 2020 2020 2020 2020 5061 6765 2044 6f77 Page Dow │ │ │ │ │ -000335b0: 6e20 286e 756d 6572 6963 206b 6579 7061 n (numeric keypa │ │ │ │ │ -000335c0: 6429 0a20 2020 2020 6e75 6d6c 6566 7420 d). numleft │ │ │ │ │ -000335d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000335e0: 2020 2020 2020 4c65 6674 2028 6e75 6d65 Left (nume │ │ │ │ │ -000335f0: 7269 6320 6b65 7970 6164 290a 2020 2020 ric keypad). │ │ │ │ │ -00033600: 206e 756d 6365 6e74 6572 2020 2020 2020 numcenter │ │ │ │ │ -00033610: 2020 2020 2020 2020 2020 2020 2020 2035 5 │ │ │ │ │ -00033620: 2077 6974 6820 4e75 6d20 4c6f 636b 2069 with Num Lock i │ │ │ │ │ -00033630: 6e61 6374 6976 6520 286e 756d 6572 6963 nactive (numeric │ │ │ │ │ -00033640: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00033500: 2020 2e20 2028 6e75 6d65 7269 6320 6b65 . (numeric ke │ │ │ │ │ +00033510: 7970 6164 290a 2020 2020 206e 756d 656e ypad). numen │ │ │ │ │ +00033520: 6420 2020 2020 2020 2020 2020 2020 2020 d │ │ │ │ │ +00033530: 2020 2020 2020 2020 2045 6e64 2028 6e75 End (nu │ │ │ │ │ +00033540: 6d65 7269 6320 6b65 7970 6164 290a 2020 meric keypad). │ │ │ │ │ +00033550: 2020 206e 756d 646f 776e 2020 2020 2020 numdown │ │ │ │ │ +00033560: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033570: 2044 6f77 6e20 286e 756d 6572 6963 206b Down (numeric k │ │ │ │ │ +00033580: 6579 7061 6429 0a20 2020 2020 6e75 6d70 eypad). nump │ │ │ │ │ +00033590: 6764 6f77 6e20 2020 2020 2020 2020 2020 gdown │ │ │ │ │ +000335a0: 2020 2020 2020 2020 2020 5061 6765 2044 Page D │ │ │ │ │ +000335b0: 6f77 6e20 286e 756d 6572 6963 206b 6579 own (numeric key │ │ │ │ │ +000335c0: 7061 6429 0a20 2020 2020 6e75 6d6c 6566 pad). numlef │ │ │ │ │ +000335d0: 7420 2020 2020 2020 2020 2020 2020 2020 t │ │ │ │ │ +000335e0: 2020 2020 2020 2020 4c65 6674 2028 6e75 Left (nu │ │ │ │ │ +000335f0: 6d65 7269 6320 6b65 7970 6164 290a 2020 meric keypad). │ │ │ │ │ +00033600: 2020 206e 756d 6365 6e74 6572 2020 2020 numcenter │ │ │ │ │ +00033610: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033620: 2035 2077 6974 6820 4e75 6d20 4c6f 636b 5 with Num Lock │ │ │ │ │ +00033630: 2069 6e61 6374 6976 6520 286e 756d 6572 inactive (numer │ │ │ │ │ +00033640: 6963 0a20 2020 2020 2020 2020 2020 2020 ic. │ │ │ │ │ 00033650: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033660: 2020 2020 6b65 7970 6164 290a 2020 2020 keypad). │ │ │ │ │ -00033670: 206e 756d 7269 6768 7420 2020 2020 2020 numright │ │ │ │ │ -00033680: 2020 2020 2020 2020 2020 2020 2020 2052 R │ │ │ │ │ -00033690: 6967 6874 2028 6e75 6d65 7269 6320 6b65 ight (numeric ke │ │ │ │ │ -000336a0: 7970 6164 290a 2020 2020 206e 756d 686f ypad). numho │ │ │ │ │ -000336b0: 6d65 2020 2020 2020 2020 2020 2020 2020 me │ │ │ │ │ -000336c0: 2020 2020 2020 2020 2048 6f6d 6520 286e Home (n │ │ │ │ │ -000336d0: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ │ -000336e0: 2020 2020 6e75 6d75 7020 2020 2020 2020 numup │ │ │ │ │ +00033660: 2020 2020 2020 6b65 7970 6164 290a 2020 keypad). │ │ │ │ │ +00033670: 2020 206e 756d 7269 6768 7420 2020 2020 numright │ │ │ │ │ +00033680: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033690: 2052 6967 6874 2028 6e75 6d65 7269 6320 Right (numeric │ │ │ │ │ +000336a0: 6b65 7970 6164 290a 2020 2020 206e 756d keypad). num │ │ │ │ │ +000336b0: 686f 6d65 2020 2020 2020 2020 2020 2020 home │ │ │ │ │ +000336c0: 2020 2020 2020 2020 2020 2048 6f6d 6520 Home │ │ │ │ │ +000336d0: 286e 756d 6572 6963 206b 6579 7061 6429 (numeric keypad) │ │ │ │ │ +000336e0: 0a20 2020 2020 6e75 6d75 7020 2020 2020 . numup │ │ │ │ │ 000336f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033700: 2020 5570 2028 6e75 6d65 7269 6320 6b65 Up (numeric ke │ │ │ │ │ -00033710: 7970 6164 290a 2020 2020 206e 756d 7067 ypad). numpg │ │ │ │ │ -00033720: 7570 2020 2020 2020 2020 2020 2020 2020 up │ │ │ │ │ -00033730: 2020 2020 2020 2020 2050 6167 6520 5570 Page Up │ │ │ │ │ -00033740: 2028 6e75 6d65 7269 6320 6b65 7970 6164 (numeric keypad │ │ │ │ │ -00033750: 290a 2020 2020 206e 756d 696e 7365 7274 ). numinsert │ │ │ │ │ -00033760: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033770: 2020 2020 2049 6e73 6572 7420 286e 756d Insert (num │ │ │ │ │ -00033780: 6572 6963 206b 6579 7061 6429 0a20 2020 eric keypad). │ │ │ │ │ -00033790: 2020 6e75 6d64 656c 6574 6520 2020 2020 numdelete │ │ │ │ │ +00033700: 2020 2020 5570 2028 6e75 6d65 7269 6320 Up (numeric │ │ │ │ │ +00033710: 6b65 7970 6164 290a 2020 2020 206e 756d keypad). num │ │ │ │ │ +00033720: 7067 7570 2020 2020 2020 2020 2020 2020 pgup │ │ │ │ │ +00033730: 2020 2020 2020 2020 2020 2050 6167 6520 Page │ │ │ │ │ +00033740: 5570 2028 6e75 6d65 7269 6320 6b65 7970 Up (numeric keyp │ │ │ │ │ +00033750: 6164 290a 2020 2020 206e 756d 696e 7365 ad). numinse │ │ │ │ │ +00033760: 7274 2020 2020 2020 2020 2020 2020 2020 rt │ │ │ │ │ +00033770: 2020 2020 2020 2049 6e73 6572 7420 286e Insert (n │ │ │ │ │ +00033780: 756d 6572 6963 206b 6579 7061 6429 0a20 umeric keypad). │ │ │ │ │ +00033790: 2020 2020 6e75 6d64 656c 6574 6520 2020 numdelete │ │ │ │ │ 000337a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000337b0: 4465 6c65 7465 2028 6e75 6d65 7269 6320 Delete (numeric │ │ │ │ │ -000337c0: 6b65 7970 6164 290a 2020 2020 206e 756d keypad). num │ │ │ │ │ -000337d0: 6173 7465 7269 736b 2020 2020 2020 2020 asterisk │ │ │ │ │ -000337e0: 2020 2020 2020 2020 2020 202a 2028 6e75 * (nu │ │ │ │ │ -000337f0: 6d65 7269 6320 6b65 7970 6164 290a 2020 meric keypad). │ │ │ │ │ -00033800: 2020 206e 756d 6d69 6e75 7320 2020 2020 numminus │ │ │ │ │ +000337b0: 2020 4465 6c65 7465 2028 6e75 6d65 7269 Delete (numeri │ │ │ │ │ +000337c0: 6320 6b65 7970 6164 290a 2020 2020 206e c keypad). n │ │ │ │ │ +000337d0: 756d 6173 7465 7269 736b 2020 2020 2020 umasterisk │ │ │ │ │ +000337e0: 2020 2020 2020 2020 2020 2020 202a 2028 * ( │ │ │ │ │ +000337f0: 6e75 6d65 7269 6320 6b65 7970 6164 290a numeric keypad). │ │ │ │ │ +00033800: 2020 2020 206e 756d 6d69 6e75 7320 2020 numminus │ │ │ │ │ 00033810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033820: 202d 2028 6e75 6d65 7269 6320 6b65 7970 - (numeric keyp │ │ │ │ │ -00033830: 6164 290a 2020 2020 206e 756d 706c 7573 ad). numplus │ │ │ │ │ -00033840: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033850: 2020 2020 2020 202b 2028 6e75 6d65 7269 + (numeri │ │ │ │ │ -00033860: 6320 6b65 7970 6164 290a 2020 2020 206e c keypad). n │ │ │ │ │ -00033870: 756d 736c 6173 6820 2020 2020 2020 2020 umslash │ │ │ │ │ -00033880: 2020 2020 2020 2020 2020 2020 202f 2028 / ( │ │ │ │ │ -00033890: 6e75 6d65 7269 6320 6b65 7970 6164 290a numeric keypad). │ │ │ │ │ -000338a0: 2020 2020 206e 756d 656e 7465 7220 2020 numenter │ │ │ │ │ +00033820: 2020 202d 2028 6e75 6d65 7269 6320 6b65 - (numeric ke │ │ │ │ │ +00033830: 7970 6164 290a 2020 2020 206e 756d 706c ypad). numpl │ │ │ │ │ +00033840: 7573 2020 2020 2020 2020 2020 2020 2020 us │ │ │ │ │ +00033850: 2020 2020 2020 2020 202b 2028 6e75 6d65 + (nume │ │ │ │ │ +00033860: 7269 6320 6b65 7970 6164 290a 2020 2020 ric keypad). │ │ │ │ │ +00033870: 206e 756d 736c 6173 6820 2020 2020 2020 numslash │ │ │ │ │ +00033880: 2020 2020 2020 2020 2020 2020 2020 202f / │ │ │ │ │ +00033890: 2028 6e75 6d65 7269 6320 6b65 7970 6164 (numeric keypad │ │ │ │ │ +000338a0: 290a 2020 2020 206e 756d 656e 7465 7220 ). numenter │ │ │ │ │ 000338b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000338c0: 2020 2045 6e74 6572 2028 6e75 6d65 7269 Enter (numeri │ │ │ │ │ -000338d0: 6320 6b65 7970 6164 290a 2020 2020 2064 c keypad). d │ │ │ │ │ -000338e0: 656c 6574 6520 2020 2020 2020 2020 2020 elete │ │ │ │ │ -000338f0: 2020 2020 2020 2020 2020 2020 2044 656c Del │ │ │ │ │ -00033900: 6574 650a 2020 2020 2069 6e73 6572 7420 ete. insert │ │ │ │ │ -00033910: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033920: 2020 2020 2020 2049 6e73 6572 740a 2020 Insert. │ │ │ │ │ -00033930: 2020 2068 6f6d 6520 2020 2020 2020 2020 home │ │ │ │ │ +000338c0: 2020 2020 2045 6e74 6572 2028 6e75 6d65 Enter (nume │ │ │ │ │ +000338d0: 7269 6320 6b65 7970 6164 290a 2020 2020 ric keypad). │ │ │ │ │ +000338e0: 2064 656c 6574 6520 2020 2020 2020 2020 delete │ │ │ │ │ +000338f0: 2020 2020 2020 2020 2020 2020 2020 2044 D │ │ │ │ │ +00033900: 656c 6574 650a 2020 2020 2069 6e73 6572 elete. inser │ │ │ │ │ +00033910: 7420 2020 2020 2020 2020 2020 2020 2020 t │ │ │ │ │ +00033920: 2020 2020 2020 2020 2049 6e73 6572 740a Insert. │ │ │ │ │ +00033930: 2020 2020 2068 6f6d 6520 2020 2020 2020 home │ │ │ │ │ 00033940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033950: 2048 6f6d 650a 2020 2020 2065 6e64 2020 Home. end │ │ │ │ │ +00033950: 2020 2048 6f6d 650a 2020 2020 2065 6e64 Home. end │ │ │ │ │ 00033960: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033970: 2020 2020 2020 2020 2045 6e64 0a20 2020 End. │ │ │ │ │ -00033980: 2020 7067 646f 776e 2020 2020 2020 2020 pgdown │ │ │ │ │ +00033970: 2020 2020 2020 2020 2020 2045 6e64 0a20 End. │ │ │ │ │ +00033980: 2020 2020 7067 646f 776e 2020 2020 2020 pgdown │ │ │ │ │ 00033990: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000339a0: 5061 6765 2044 6f77 6e0a 2020 2020 2070 Page Down. p │ │ │ │ │ -000339b0: 6775 7020 2020 2020 2020 2020 2020 2020 gup │ │ │ │ │ -000339c0: 2020 2020 2020 2020 2020 2020 2050 6167 Pag │ │ │ │ │ -000339d0: 6520 5570 0a20 2020 2020 646f 776e 2020 e Up. down │ │ │ │ │ +000339a0: 2020 5061 6765 2044 6f77 6e0a 2020 2020 Page Down. │ │ │ │ │ +000339b0: 2070 6775 7020 2020 2020 2020 2020 2020 pgup │ │ │ │ │ +000339c0: 2020 2020 2020 2020 2020 2020 2020 2050 P │ │ │ │ │ +000339d0: 6167 6520 5570 0a20 2020 2020 646f 776e age Up. down │ │ │ │ │ 000339e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000339f0: 2020 2020 2020 2020 446f 776e 0a20 2020 Down. │ │ │ │ │ -00033a00: 2020 7570 2020 2020 2020 2020 2020 2020 up │ │ │ │ │ +000339f0: 2020 2020 2020 2020 2020 446f 776e 0a20 Down. │ │ │ │ │ +00033a00: 2020 2020 7570 2020 2020 2020 2020 2020 up │ │ │ │ │ 00033a10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033a20: 5570 0a20 2020 2020 6c65 6674 2020 2020 Up. left │ │ │ │ │ +00033a20: 2020 5570 0a20 2020 2020 6c65 6674 2020 Up. left │ │ │ │ │ 00033a30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00033a40: 2020 2020 2020 4c65 6674 0a20 2020 2020 Left. │ │ │ │ │ -00033a50: 7269 6768 7420 2020 2020 2020 2020 2020 right │ │ │ │ │ -00033a60: 2020 2020 2020 2020 2020 2020 2020 5269 Ri │ │ │ │ │ -00033a70: 6768 740a 0a20 2020 2020 4173 2077 656c ght.. As wel │ │ │ │ │ -00033a80: 6c20 6173 206b 6579 7374 726f 6b65 732c l as keystrokes, │ │ │ │ │ -00033a90: 2074 6865 2027 7365 6e64 6b65 7927 2063 the 'sendkey' c │ │ │ │ │ -00033aa0: 6f6d 6d61 6e64 2074 616b 6573 2076 6172 ommand takes var │ │ │ │ │ -00033ab0: 696f 7573 206f 7074 696f 6e73 0a20 2020 ious options. │ │ │ │ │ -00033ac0: 2020 7468 6174 2061 6666 6563 7420 7468 that affect th │ │ │ │ │ -00033ad0: 6520 4249 4f53 206b 6579 626f 6172 6420 e BIOS keyboard │ │ │ │ │ -00033ae0: 7374 6174 7573 2066 6c61 6773 2e20 2054 status flags. T │ │ │ │ │ -00033af0: 6865 7365 206f 7074 696f 6e73 2074 616b hese options tak │ │ │ │ │ -00033b00: 6520 616e 0a20 2020 2020 276f 6e27 206f e an. 'on' o │ │ │ │ │ -00033b10: 7220 276f 6666 2720 7061 7261 6d65 7465 r 'off' paramete │ │ │ │ │ -00033b20: 722c 2073 7065 6369 6679 696e 6720 7468 r, specifying th │ │ │ │ │ -00033b30: 6174 2074 6865 2063 6f72 7265 7370 6f6e at the correspon │ │ │ │ │ -00033b40: 6469 6e67 2073 7461 7475 730a 2020 2020 ding status. │ │ │ │ │ -00033b50: 2066 6c61 6720 6265 2073 6574 206f 7220 flag be set or │ │ │ │ │ -00033b60: 756e 7365 743b 206f 6d69 7474 696e 6720 unset; omitting │ │ │ │ │ -00033b70: 7468 6520 6f70 7469 6f6e 2066 6f72 2061 the option for a │ │ │ │ │ -00033b80: 2067 6976 656e 2073 7461 7475 7320 666c given status fl │ │ │ │ │ -00033b90: 6167 0a20 2020 2020 7769 6c6c 206c 6561 ag. will lea │ │ │ │ │ -00033ba0: 7665 2074 6861 7420 666c 6167 2061 7420 ve that flag at │ │ │ │ │ -00033bb0: 6974 7320 696e 6974 6961 6c20 7374 6174 its initial stat │ │ │ │ │ -00033bc0: 6520 6174 2062 6f6f 742e 2020 5468 6520 e at boot. The │ │ │ │ │ -00033bd0: 272d 2d6e 756d 272c 0a20 2020 2020 272d '--num',. '- │ │ │ │ │ -00033be0: 2d63 6170 7327 2c20 272d 2d73 6372 6f6c -caps', '--scrol │ │ │ │ │ -00033bf0: 6c27 2c20 616e 6420 272d 2d69 6e73 6572 l', and '--inser │ │ │ │ │ -00033c00: 7427 206f 7074 696f 6e73 2065 6d75 6c61 t' options emula │ │ │ │ │ -00033c10: 7465 2073 6574 7469 6e67 2074 6865 0a20 te setting the. │ │ │ │ │ -00033c20: 2020 2020 636f 7272 6573 706f 6e64 696e correspondin │ │ │ │ │ -00033c30: 6720 6d6f 6465 2c20 7768 696c 6520 7468 g mode, while th │ │ │ │ │ -00033c40: 6520 272d 2d6e 756d 6b65 7927 2c20 272d e '--numkey', '- │ │ │ │ │ -00033c50: 2d63 6170 736b 6579 272c 0a20 2020 2020 -capskey',. │ │ │ │ │ -00033c60: 272d 2d73 6372 6f6c 6c6b 6579 272c 2061 '--scrollkey', a │ │ │ │ │ -00033c70: 6e64 2027 2d2d 696e 7365 7274 6b65 7927 nd '--insertkey' │ │ │ │ │ -00033c80: 206f 7074 696f 6e73 2065 6d75 6c61 7465 options emulate │ │ │ │ │ -00033c90: 2070 7265 7373 696e 6720 616e 640a 2020 pressing and. │ │ │ │ │ -00033ca0: 2020 2068 6f6c 6469 6e67 2074 6865 2063 holding the c │ │ │ │ │ -00033cb0: 6f72 7265 7370 6f6e 6469 6e67 206b 6579 orresponding key │ │ │ │ │ -00033cc0: 2e20 2054 6865 206f 7468 6572 2073 7461 . The other sta │ │ │ │ │ -00033cd0: 7475 7320 666c 6167 206f 7074 696f 6e73 tus flag options │ │ │ │ │ -00033ce0: 2061 7265 0a20 2020 2020 7365 6c66 2d65 are. self-e │ │ │ │ │ -00033cf0: 7870 6c61 6e61 746f 7279 2e0a 0a20 2020 xplanatory... │ │ │ │ │ -00033d00: 2020 4966 2074 6865 2027 2d2d 6e6f 2d6c If the '--no-l │ │ │ │ │ -00033d10: 6564 2720 6f70 7469 6f6e 2069 7320 6769 ed' option is gi │ │ │ │ │ -00033d20: 7665 6e2c 2074 6865 2073 7461 7475 7320 ven, the status │ │ │ │ │ -00033d30: 666c 6167 206f 7074 696f 6e73 2077 696c flag options wil │ │ │ │ │ -00033d40: 6c0a 2020 2020 2068 6176 6520 6e6f 2065 l. have no e │ │ │ │ │ -00033d50: 6666 6563 7420 6f6e 206b 6579 626f 6172 ffect on keyboar │ │ │ │ │ -00033d60: 6420 4c45 4473 2e0a 0a20 2020 2020 4966 d LEDs... If │ │ │ │ │ -00033d70: 2074 6865 2027 7365 6e64 6b65 7927 2063 the 'sendkey' c │ │ │ │ │ -00033d80: 6f6d 6d61 6e64 2069 7320 6769 7665 6e20 ommand is given │ │ │ │ │ -00033d90: 6d75 6c74 6970 6c65 2074 696d 6573 2c20 multiple times, │ │ │ │ │ -00033da0: 7468 656e 206f 6e6c 7920 7468 650a 2020 then only the. │ │ │ │ │ -00033db0: 2020 206c 6173 7420 696e 766f 6361 7469 last invocati │ │ │ │ │ -00033dc0: 6f6e 2068 6173 2061 6e79 2065 6666 6563 on has any effec │ │ │ │ │ -00033dd0: 742e 0a0a 2020 2020 2053 696e 6365 2027 t... Since ' │ │ │ │ │ -00033de0: 7365 6e64 6b65 7927 206d 616e 6970 756c sendkey' manipul │ │ │ │ │ -00033df0: 6174 6573 2074 6865 2042 494f 5320 6b65 ates the BIOS ke │ │ │ │ │ -00033e00: 7962 6f61 7264 2062 7566 6665 722c 2069 yboard buffer, i │ │ │ │ │ -00033e10: 7420 6d61 7920 6361 7573 650a 2020 2020 t may cause. │ │ │ │ │ -00033e20: 2068 616e 6773 2c20 7265 626f 6f74 732c hangs, reboots, │ │ │ │ │ -00033e30: 206f 7220 6f74 6865 7220 6d69 7362 6568 or other misbeh │ │ │ │ │ -00033e40: 6176 696f 7572 206f 6e20 736f 6d65 2073 aviour on some s │ │ │ │ │ -00033e50: 7973 7465 6d73 2e20 2049 6620 7468 650a ystems. If the. │ │ │ │ │ -00033e60: 2020 2020 206f 7065 7261 7469 6e67 2073 operating s │ │ │ │ │ -00033e70: 7973 7465 6d20 6f72 2062 6f6f 7420 6c6f ystem or boot lo │ │ │ │ │ -00033e80: 6164 6572 2074 6861 7420 7275 6e73 2061 ader that runs a │ │ │ │ │ -00033e90: 6674 6572 2047 5255 4220 7573 6573 2069 fter GRUB uses i │ │ │ │ │ -00033ea0: 7473 206f 776e 0a20 2020 2020 6b65 7962 ts own. keyb │ │ │ │ │ -00033eb0: 6f61 7264 2064 7269 7665 7220 7261 7468 oard driver rath │ │ │ │ │ -00033ec0: 6572 2074 6861 6e20 7468 6520 4249 4f53 er than the BIOS │ │ │ │ │ -00033ed0: 206b 6579 626f 6172 6420 6675 6e63 7469 keyboard functi │ │ │ │ │ -00033ee0: 6f6e 732c 2074 6865 6e0a 2020 2020 2027 ons, then. ' │ │ │ │ │ -00033ef0: 7365 6e64 6b65 7927 2077 696c 6c20 6861 sendkey' will ha │ │ │ │ │ -00033f00: 7665 206e 6f20 6566 6665 6374 2e0a 0a20 ve no effect... │ │ │ │ │ -00033f10: 2020 2020 5468 6973 2063 6f6d 6d61 6e64 This command │ │ │ │ │ -00033f20: 2069 7320 6f6e 6c79 2061 7661 696c 6162 is only availab │ │ │ │ │ -00033f30: 6c65 206f 6e20 5043 2042 494f 5320 7379 le on PC BIOS sy │ │ │ │ │ -00033f40: 7374 656d 732e 0a0a 1f0a 4669 6c65 3a20 stems.....File: │ │ │ │ │ -00033f50: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00033f60: 3a20 7365 742c 2020 4e65 7874 3a20 7368 : set, Next: sh │ │ │ │ │ -00033f70: 6131 7375 6d2c 2020 5072 6576 3a20 7365 a1sum, Prev: se │ │ │ │ │ -00033f80: 6e64 6b65 792c 2020 5570 3a20 436f 6d6d ndkey, Up: Comm │ │ │ │ │ -00033f90: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -00033fa0: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -00033fb0: 0a0a 3136 2e33 2e36 3720 7365 740a 2d2d ..16.3.67 set.-- │ │ │ │ │ -00033fc0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -00033fd0: 6f6d 6d61 6e64 3a20 7365 7420 5b65 6e76 ommand: set [env │ │ │ │ │ -00033fe0: 7661 723d 7661 6c75 655d 0a20 2020 2020 var=value]. │ │ │ │ │ -00033ff0: 5365 7420 7468 6520 656e 7669 726f 6e6d Set the environm │ │ │ │ │ -00034000: 656e 7420 7661 7269 6162 6c65 2045 4e56 ent variable ENV │ │ │ │ │ -00034010: 5641 5220 746f 2056 414c 5545 2e20 2049 VAR to VALUE. I │ │ │ │ │ -00034020: 6620 696e 766f 6b65 6420 7769 7468 206e f invoked with n │ │ │ │ │ -00034030: 6f0a 2020 2020 2061 7267 756d 656e 7473 o. arguments │ │ │ │ │ -00034040: 2c20 7072 696e 7420 616c 6c20 656e 7669 , print all envi │ │ │ │ │ -00034050: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ -00034060: 7320 7769 7468 2074 6865 6972 2076 616c s with their val │ │ │ │ │ -00034070: 7565 732e 0a0a 1f0a 4669 6c65 3a20 6772 ues.....File: gr │ │ │ │ │ -00034080: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00034090: 7368 6131 7375 6d2c 2020 4e65 7874 3a20 sha1sum, Next: │ │ │ │ │ -000340a0: 7368 6132 3536 7375 6d2c 2020 5072 6576 sha256sum, Prev │ │ │ │ │ -000340b0: 3a20 7365 742c 2020 5570 3a20 436f 6d6d : set, Up: Comm │ │ │ │ │ -000340c0: 616e 642d 6c69 6e65 2061 6e64 206d 656e and-line and men │ │ │ │ │ -000340d0: 7520 656e 7472 7920 636f 6d6d 616e 6473 u entry commands │ │ │ │ │ -000340e0: 0a0a 3136 2e33 2e36 3820 7368 6131 7375 ..16.3.68 sha1su │ │ │ │ │ -000340f0: 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d m.-------------- │ │ │ │ │ -00034100: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -00034110: 7368 6131 7375 6d20 6172 6720 2e2e 2e0a sha1sum arg .... │ │ │ │ │ -00034120: 2020 2020 2041 6c69 6173 2066 6f72 2027 Alias for ' │ │ │ │ │ -00034130: 6861 7368 7375 6d20 2d2d 6861 7368 2073 hashsum --hash s │ │ │ │ │ -00034140: 6861 3120 6172 6720 2e2e 2e27 2e20 2053 ha1 arg ...'. S │ │ │ │ │ -00034150: 6565 2063 6f6d 6d61 6e64 2027 6861 7368 ee command 'hash │ │ │ │ │ -00034160: 7375 6d27 0a20 2020 2020 282a 6e6f 7465 sum'. (*note │ │ │ │ │ -00034170: 2068 6173 6873 756d 3a3a 2920 666f 7220 hashsum::) for │ │ │ │ │ -00034180: 6675 6c6c 2064 6573 6372 6970 7469 6f6e full description │ │ │ │ │ -00034190: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -000341a0: 696e 666f 2c20 204e 6f64 653a 2073 6861 info, Node: sha │ │ │ │ │ -000341b0: 3235 3673 756d 2c20 204e 6578 743a 2073 256sum, Next: s │ │ │ │ │ -000341c0: 6861 3531 3273 756d 2c20 2050 7265 763a ha512sum, Prev: │ │ │ │ │ -000341d0: 2073 6861 3173 756d 2c20 2055 703a 2043 sha1sum, Up: C │ │ │ │ │ -000341e0: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ -000341f0: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ -00034200: 6e64 730a 0a31 362e 332e 3639 2073 6861 nds..16.3.69 sha │ │ │ │ │ -00034210: 3235 3673 756d 0a2d 2d2d 2d2d 2d2d 2d2d 256sum.--------- │ │ │ │ │ -00034220: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -00034230: 6d6d 616e 643a 2073 6861 3235 3673 756d mmand: sha256sum │ │ │ │ │ -00034240: 2061 7267 202e 2e2e 0a20 2020 2020 416c arg .... Al │ │ │ │ │ -00034250: 6961 7320 666f 7220 2768 6173 6873 756d ias for 'hashsum │ │ │ │ │ -00034260: 202d 2d68 6173 6820 7368 6132 3536 2061 --hash sha256 a │ │ │ │ │ -00034270: 7267 202e 2e2e 272e 2020 5365 6520 636f rg ...'. See co │ │ │ │ │ -00034280: 6d6d 616e 6420 2768 6173 6873 756d 270a mmand 'hashsum'. │ │ │ │ │ -00034290: 2020 2020 2028 2a6e 6f74 6520 6861 7368 (*note hash │ │ │ │ │ -000342a0: 7375 6d3a 3a29 2066 6f72 2066 756c 6c20 sum::) for full │ │ │ │ │ -000342b0: 6465 7363 7269 7074 696f 6e2e 0a0a 1f0a description..... │ │ │ │ │ -000342c0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -000342d0: 2020 4e6f 6465 3a20 7368 6135 3132 7375 Node: sha512su │ │ │ │ │ -000342e0: 6d2c 2020 4e65 7874 3a20 736c 6565 702c m, Next: sleep, │ │ │ │ │ -000342f0: 2020 5072 6576 3a20 7368 6132 3536 7375 Prev: sha256su │ │ │ │ │ -00034300: 6d2c 2020 5570 3a20 436f 6d6d 616e 642d m, Up: Command- │ │ │ │ │ -00034310: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ -00034320: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ -00034330: 2e33 2e37 3020 7368 6135 3132 7375 6d0a .3.70 sha512sum. │ │ │ │ │ -00034340: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00034350: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ -00034360: 7368 6135 3132 7375 6d20 6172 6720 2e2e sha512sum arg .. │ │ │ │ │ -00034370: 2e0a 2020 2020 2041 6c69 6173 2066 6f72 .. Alias for │ │ │ │ │ -00034380: 2027 6861 7368 7375 6d20 2d2d 6861 7368 'hashsum --hash │ │ │ │ │ -00034390: 2073 6861 3531 3220 6172 6720 2e2e 2e27 sha512 arg ...' │ │ │ │ │ -000343a0: 2e20 2053 6565 2063 6f6d 6d61 6e64 2027 . See command ' │ │ │ │ │ -000343b0: 6861 7368 7375 6d27 0a20 2020 2020 282a hashsum'. (* │ │ │ │ │ -000343c0: 6e6f 7465 2068 6173 6873 756d 3a3a 2920 note hashsum::) │ │ │ │ │ -000343d0: 666f 7220 6675 6c6c 2064 6573 6372 6970 for full descrip │ │ │ │ │ -000343e0: 7469 6f6e 2e0a 0a1f 0a46 696c 653a 2067 tion.....File: g │ │ │ │ │ -000343f0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00034400: 2073 6c65 6570 2c20 204e 6578 743a 2073 sleep, Next: s │ │ │ │ │ -00034410: 6d62 696f 732c 2020 5072 6576 3a20 7368 mbios, Prev: sh │ │ │ │ │ -00034420: 6135 3132 7375 6d2c 2020 5570 3a20 436f a512sum, Up: Co │ │ │ │ │ -00034430: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -00034440: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -00034450: 6473 0a0a 3136 2e33 2e37 3120 736c 6565 ds..16.3.71 slee │ │ │ │ │ -00034460: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a p.-------------. │ │ │ │ │ -00034470: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 736c . -- Command: sl │ │ │ │ │ -00034480: 6565 7020 5b2d 2d76 6572 626f 7365 5d20 eep [--verbose] │ │ │ │ │ -00034490: 5b2d 2d69 6e74 6572 7275 7074 6962 6c65 [--interruptible │ │ │ │ │ -000344a0: 5d20 636f 756e 740a 2020 2020 2053 6c65 ] count. Sle │ │ │ │ │ -000344b0: 6570 2066 6f72 2043 4f55 4e54 2073 6563 ep for COUNT sec │ │ │ │ │ -000344c0: 6f6e 6473 2e20 2049 6620 6f70 7469 6f6e onds. If option │ │ │ │ │ -000344d0: 2027 2d2d 696e 7465 7272 7570 7469 626c '--interruptibl │ │ │ │ │ -000344e0: 6527 2069 7320 6769 7665 6e2c 0a20 2020 e' is given,. │ │ │ │ │ -000344f0: 2020 616c 6c6f 7720 7072 6573 7369 6e67 allow pressing │ │ │ │ │ -00034500: 203c 4553 433e 2c20 3c46 343e 206f 7220 , or │ │ │ │ │ -00034510: 686f 6c64 696e 6720 646f 776e 203c 5348 holding down to interrup │ │ │ │ │ -00034530: 740a 2020 2020 2073 6c65 6570 2e20 2057 t. sleep. W │ │ │ │ │ -00034540: 6974 6820 272d 2d76 6572 626f 7365 2720 ith '--verbose' │ │ │ │ │ -00034550: 7368 6f77 2063 6f75 6e74 646f 776e 206f show countdown o │ │ │ │ │ -00034560: 6620 7265 6d61 696e 696e 6720 7365 636f f remaining seco │ │ │ │ │ -00034570: 6e64 732e 2020 4578 6974 0a20 2020 2020 nds. Exit. │ │ │ │ │ -00034580: 636f 6465 2069 7320 7365 7420 746f 2030 code is set to 0 │ │ │ │ │ -00034590: 2069 6620 7469 6d65 6f75 7420 6578 7069 if timeout expi │ │ │ │ │ -000345a0: 7265 6420 616e 6420 746f 2031 2069 6620 red and to 1 if │ │ │ │ │ -000345b0: 7469 6d65 6f75 7420 7761 730a 2020 2020 timeout was. │ │ │ │ │ -000345c0: 2069 6e74 6572 7275 7074 6564 2075 7369 interrupted usi │ │ │ │ │ -000345d0: 6e67 2061 6e79 206f 6620 7468 6520 6d65 ng any of the me │ │ │ │ │ -000345e0: 6e74 696f 6e65 6420 6b65 7973 2e0a 0a1f ntioned keys.... │ │ │ │ │ -000345f0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00034600: 2c20 204e 6f64 653a 2073 6d62 696f 732c , Node: smbios, │ │ │ │ │ -00034610: 2020 4e65 7874 3a20 736f 7572 6365 2c20 Next: source, │ │ │ │ │ -00034620: 2050 7265 763a 2073 6c65 6570 2c20 2055 Prev: sleep, U │ │ │ │ │ -00034630: 703a 2043 6f6d 6d61 6e64 2d6c 696e 6520 p: Command-line │ │ │ │ │ -00034640: 616e 6420 6d65 6e75 2065 6e74 7279 2063 and menu entry c │ │ │ │ │ -00034650: 6f6d 6d61 6e64 730a 0a31 362e 332e 3732 ommands..16.3.72 │ │ │ │ │ -00034660: 2073 6d62 696f 730a 2d2d 2d2d 2d2d 2d2d smbios.-------- │ │ │ │ │ -00034670: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -00034680: 616e 643a 2073 6d62 696f 7320 5b2d 2d74 and: smbios [--t │ │ │ │ │ -00034690: 7970 6520 5459 5045 5d20 5b2d 2d68 616e ype TYPE] [--han │ │ │ │ │ -000346a0: 646c 6520 4841 4e44 4c45 5d20 5b2d 2d6d dle HANDLE] [--m │ │ │ │ │ -000346b0: 6174 6368 204d 4154 4348 5d0a 2020 2020 atch MATCH]. │ │ │ │ │ -000346c0: 2020 2020 2020 282d 2d67 6574 2d62 7974 (--get-byt │ │ │ │ │ -000346d0: 6520 7c20 2d2d 6765 742d 776f 7264 207c e | --get-word | │ │ │ │ │ -000346e0: 202d 2d67 6574 2d64 776f 7264 207c 202d --get-dword | - │ │ │ │ │ -000346f0: 2d67 6574 2d71 776f 7264 207c 0a20 2020 -get-qword |. │ │ │ │ │ -00034700: 2020 2020 2020 202d 2d67 6574 2d73 7472 --get-str │ │ │ │ │ -00034710: 696e 6720 7c20 2d2d 6765 742d 7575 6964 ing | --get-uuid │ │ │ │ │ -00034720: 2920 4f46 4653 4554 205b 2d2d 7365 7420 ) OFFSET [--set │ │ │ │ │ -00034730: 5641 5249 4142 4c45 5d0a 2020 2020 2052 VARIABLE]. R │ │ │ │ │ -00034740: 6574 7269 6576 6520 534d 4249 4f53 2069 etrieve SMBIOS i │ │ │ │ │ -00034750: 6e66 6f72 6d61 7469 6f6e 2e0a 0a20 2020 nformation... │ │ │ │ │ -00034760: 2020 5468 6520 2773 6d62 696f 7327 2063 The 'smbios' c │ │ │ │ │ -00034770: 6f6d 6d61 6e64 2072 6574 7572 6e73 2074 ommand returns t │ │ │ │ │ -00034780: 6865 2076 616c 7565 206f 6620 6120 6669 he value of a fi │ │ │ │ │ -00034790: 656c 6420 696e 2061 6e20 534d 4249 4f53 eld in an SMBIOS │ │ │ │ │ -000347a0: 0a20 2020 2020 7374 7275 6374 7572 652e . structure. │ │ │ │ │ -000347b0: 2020 5468 6520 666f 6c6c 6f77 696e 6720 The following │ │ │ │ │ -000347c0: 6f70 7469 6f6e 7320 6465 7465 726d 696e options determin │ │ │ │ │ -000347d0: 6520 7768 6963 6820 7374 7275 6374 7572 e which structur │ │ │ │ │ -000347e0: 6520 746f 0a20 2020 2020 7365 6c65 6374 e to. select │ │ │ │ │ -000347f0: 2e0a 0a20 2020 2020 2020 202a 2053 7065 ... * Spe │ │ │ │ │ -00034800: 6369 6679 696e 6720 272d 2d74 7970 6527 cifying '--type' │ │ │ │ │ -00034810: 2077 696c 6c20 7365 6c65 6374 2073 7472 will select str │ │ │ │ │ -00034820: 7563 7475 7265 7320 7769 7468 2061 206d uctures with a m │ │ │ │ │ -00034830: 6174 6368 696e 670a 2020 2020 2020 2020 atching. │ │ │ │ │ -00034840: 2020 5459 5045 2e20 2054 6865 2074 7970 TYPE. The typ │ │ │ │ │ -00034850: 6520 6361 6e20 6265 2061 6e79 2069 6e74 e can be any int │ │ │ │ │ -00034860: 6567 6572 2066 726f 6d20 3020 746f 2032 eger from 0 to 2 │ │ │ │ │ -00034870: 3535 2e0a 2020 2020 2020 2020 2a20 5370 55.. * Sp │ │ │ │ │ -00034880: 6563 6966 7969 6e67 2027 2d2d 6861 6e64 ecifying '--hand │ │ │ │ │ -00034890: 6c65 2720 7769 6c6c 2073 656c 6563 7420 le' will select │ │ │ │ │ -000348a0: 7374 7275 6374 7572 6573 2077 6974 6820 structures with │ │ │ │ │ -000348b0: 6120 6d61 7463 6869 6e67 0a20 2020 2020 a matching. │ │ │ │ │ -000348c0: 2020 2020 2048 414e 444c 452e 2020 5468 HANDLE. Th │ │ │ │ │ -000348d0: 6520 6861 6e64 6c65 2063 616e 2062 6520 e handle can be │ │ │ │ │ -000348e0: 616e 7920 696e 7465 6765 7220 6672 6f6d any integer from │ │ │ │ │ -000348f0: 2030 2074 6f20 3635 3533 352e 0a20 2020 0 to 65535.. │ │ │ │ │ -00034900: 2020 2020 202a 2053 7065 6369 6679 696e * Specifyin │ │ │ │ │ -00034910: 6720 272d 2d6d 6174 6368 2720 7769 6c6c g '--match' will │ │ │ │ │ -00034920: 2073 656c 6563 7420 7374 7275 6374 7572 select structur │ │ │ │ │ -00034930: 6520 6e75 6d62 6572 204d 4154 4348 2069 e number MATCH i │ │ │ │ │ -00034940: 6e20 7468 650a 2020 2020 2020 2020 2020 n the. │ │ │ │ │ -00034950: 6669 6c74 6572 6564 206c 6973 7420 6f66 filtered list of │ │ │ │ │ -00034960: 2073 7472 7563 7475 7265 733b 2065 2e67 structures; e.g │ │ │ │ │ -00034970: 2e20 2027 736d 6269 6f73 202d 2d74 7970 . 'smbios --typ │ │ │ │ │ -00034980: 6520 3420 2d2d 6d61 7463 6820 3227 0a20 e 4 --match 2'. │ │ │ │ │ -00034990: 2020 2020 2020 2020 2077 696c 6c20 7365 will se │ │ │ │ │ -000349a0: 6c65 6374 2074 6865 2073 6563 6f6e 6420 lect the second │ │ │ │ │ -000349b0: 5072 6f63 6573 7320 496e 666f 726d 6174 Process Informat │ │ │ │ │ -000349c0: 696f 6e20 2854 7970 6520 3429 2073 7472 ion (Type 4) str │ │ │ │ │ -000349d0: 7563 7475 7265 2e0a 2020 2020 2020 2020 ucture.. │ │ │ │ │ -000349e0: 2020 5468 6520 6c69 7374 2069 7320 616c The list is al │ │ │ │ │ -000349f0: 7761 7973 206f 7264 6572 6564 2074 6865 ways ordered the │ │ │ │ │ -00034a00: 2073 616d 6520 6173 2074 6865 2068 6172 same as the har │ │ │ │ │ -00034a10: 6477 6172 6527 7320 534d 4249 4f53 0a20 dware's SMBIOS. │ │ │ │ │ -00034a20: 2020 2020 2020 2020 2074 6162 6c65 2e20 table. │ │ │ │ │ -00034a30: 2054 6865 206d 6174 6368 206e 756d 6265 The match numbe │ │ │ │ │ -00034a40: 7220 6d75 7374 2062 6520 6120 706f 7369 r must be a posi │ │ │ │ │ -00034a50: 7469 7665 2069 6e74 6567 6572 2e20 2049 tive integer. I │ │ │ │ │ -00034a60: 660a 2020 2020 2020 2020 2020 756e 7370 f. unsp │ │ │ │ │ -00034a70: 6563 6966 6965 642c 2074 6865 2066 6972 ecified, the fir │ │ │ │ │ -00034a80: 7374 206d 6174 6368 696e 6720 7374 7275 st matching stru │ │ │ │ │ -00034a90: 6374 7572 6520 7769 6c6c 2062 6520 7365 cture will be se │ │ │ │ │ -00034aa0: 6c65 6374 6564 2e0a 0a20 2020 2020 5468 lected... Th │ │ │ │ │ -00034ab0: 6520 7265 6d61 696e 696e 6720 6f70 7469 e remaining opti │ │ │ │ │ -00034ac0: 6f6e 7320 6465 7465 726d 696e 6520 7768 ons determine wh │ │ │ │ │ -00034ad0: 6963 6820 6669 656c 6420 696e 2074 6865 ich field in the │ │ │ │ │ -00034ae0: 2073 656c 6563 7465 6420 534d 4249 4f53 selected SMBIOS │ │ │ │ │ -00034af0: 0a20 2020 2020 7374 7275 6374 7572 6520 . structure │ │ │ │ │ -00034b00: 746f 2072 6574 7572 6e2e 2020 4f6e 6c79 to return. Only │ │ │ │ │ -00034b10: 206f 6e65 206f 6620 7468 6573 6520 6f70 one of these op │ │ │ │ │ -00034b20: 7469 6f6e 7320 6d61 7920 6265 2073 7065 tions may be spe │ │ │ │ │ -00034b30: 6369 6669 6564 2061 740a 2020 2020 2061 cified at. a │ │ │ │ │ -00034b40: 2074 696d 652e 0a0a 2020 2020 2020 2020 time... │ │ │ │ │ -00034b50: 2a20 5768 656e 2067 6976 656e 2027 2d2d * When given '-- │ │ │ │ │ -00034b60: 6765 742d 6279 7465 272c 2072 6574 7572 get-byte', retur │ │ │ │ │ -00034b70: 6e20 7468 6520 7661 6c75 6520 6f66 2074 n the value of t │ │ │ │ │ -00034b80: 6865 2062 7974 6520 6174 0a20 2020 2020 he byte at. │ │ │ │ │ -00034b90: 2020 2020 204f 4646 5345 5420 6279 7465 OFFSET byte │ │ │ │ │ -00034ba0: 7320 696e 746f 2074 6865 2073 656c 6563 s into the selec │ │ │ │ │ -00034bb0: 7465 6420 534d 4249 4f53 2073 7472 7563 ted SMBIOS struc │ │ │ │ │ -00034bc0: 7475 7265 2e20 2049 7420 7769 6c6c 2062 ture. It will b │ │ │ │ │ -00034bd0: 650a 2020 2020 2020 2020 2020 666f 726d e. form │ │ │ │ │ -00034be0: 6174 7465 6420 6173 2061 6e20 756e 7369 atted as an unsi │ │ │ │ │ -00034bf0: 676e 6564 2064 6563 696d 616c 2069 6e74 gned decimal int │ │ │ │ │ -00034c00: 6567 6572 2e0a 2020 2020 2020 2020 2a20 eger.. * │ │ │ │ │ -00034c10: 5768 656e 2067 6976 656e 2027 2d2d 6765 When given '--ge │ │ │ │ │ -00034c20: 742d 776f 7264 272c 2072 6574 7572 6e20 t-word', return │ │ │ │ │ -00034c30: 7468 6520 7661 6c75 6520 6f66 2074 6865 the value of the │ │ │ │ │ -00034c40: 2077 6f72 6420 2874 776f 0a20 2020 2020 word (two. │ │ │ │ │ -00034c50: 2020 2020 2062 7974 6573 2920 6174 204f bytes) at O │ │ │ │ │ -00034c60: 4646 5345 5420 6279 7465 7320 696e 746f FFSET bytes into │ │ │ │ │ -00034c70: 2074 6865 2073 656c 6563 7465 6420 534d the selected SM │ │ │ │ │ -00034c80: 4249 4f53 2073 7472 7563 7475 7265 2e20 BIOS structure. │ │ │ │ │ -00034c90: 2049 740a 2020 2020 2020 2020 2020 7769 It. wi │ │ │ │ │ -00034ca0: 6c6c 2062 6520 666f 726d 6174 7465 6420 ll be formatted │ │ │ │ │ -00034cb0: 6173 2061 6e20 756e 7369 676e 6564 2064 as an unsigned d │ │ │ │ │ -00034cc0: 6563 696d 616c 2069 6e74 6567 6572 2e0a ecimal integer.. │ │ │ │ │ -00034cd0: 2020 2020 2020 2020 2a20 5768 656e 2067 * When g │ │ │ │ │ -00034ce0: 6976 656e 2027 2d2d 6765 742d 6477 6f72 iven '--get-dwor │ │ │ │ │ -00034cf0: 6427 2c20 7265 7475 726e 2074 6865 2076 d', return the v │ │ │ │ │ -00034d00: 616c 7565 206f 6620 7468 6520 6477 6f72 alue of the dwor │ │ │ │ │ -00034d10: 6420 2866 6f75 720a 2020 2020 2020 2020 d (four. │ │ │ │ │ -00034d20: 2020 6279 7465 7329 2061 7420 4f46 4653 bytes) at OFFS │ │ │ │ │ -00034d30: 4554 2062 7974 6573 2069 6e74 6f20 7468 ET bytes into th │ │ │ │ │ -00034d40: 6520 7365 6c65 6374 6564 2053 4d42 494f e selected SMBIO │ │ │ │ │ -00034d50: 5320 7374 7275 6374 7572 652e 2020 4974 S structure. It │ │ │ │ │ -00034d60: 0a20 2020 2020 2020 2020 2077 696c 6c20 . will │ │ │ │ │ -00034d70: 6265 2066 6f72 6d61 7474 6564 2061 7320 be formatted as │ │ │ │ │ -00034d80: 616e 2075 6e73 6967 6e65 6420 6465 6369 an unsigned deci │ │ │ │ │ -00034d90: 6d61 6c20 696e 7465 6765 722e 0a20 2020 mal integer.. │ │ │ │ │ -00034da0: 2020 2020 202a 2057 6865 6e20 6769 7665 * When give │ │ │ │ │ -00034db0: 6e20 272d 2d67 6574 2d71 776f 7264 272c n '--get-qword', │ │ │ │ │ -00034dc0: 2072 6574 7572 6e20 7468 6520 7661 6c75 return the valu │ │ │ │ │ -00034dd0: 6520 6f66 2074 6865 2071 776f 7264 2028 e of the qword ( │ │ │ │ │ -00034de0: 6569 6768 740a 2020 2020 2020 2020 2020 eight. │ │ │ │ │ -00034df0: 6279 7465 7329 2061 7420 4f46 4653 4554 bytes) at OFFSET │ │ │ │ │ -00034e00: 2062 7974 6573 2069 6e74 6f20 7468 6520 bytes into the │ │ │ │ │ -00034e10: 7365 6c65 6374 6564 2053 4d42 494f 5320 selected SMBIOS │ │ │ │ │ -00034e20: 7374 7275 6374 7572 652e 2020 4974 0a20 structure. It. │ │ │ │ │ -00034e30: 2020 2020 2020 2020 2077 696c 6c20 6265 will be │ │ │ │ │ -00034e40: 2066 6f72 6d61 7474 6564 2061 7320 616e formatted as an │ │ │ │ │ -00034e50: 2075 6e73 6967 6e65 6420 6465 6369 6d61 unsigned decima │ │ │ │ │ -00034e60: 6c20 696e 7465 6765 722e 0a20 2020 2020 l integer.. │ │ │ │ │ -00034e70: 2020 202a 2057 6865 6e20 6769 7665 6e20 * When given │ │ │ │ │ -00034e80: 272d 2d67 6574 2d73 7472 696e 6727 2c20 '--get-string', │ │ │ │ │ -00034e90: 7265 7475 726e 2074 6865 2073 7472 696e return the strin │ │ │ │ │ -00034ea0: 6720 7769 7468 2069 7473 2069 6e64 6578 g with its index │ │ │ │ │ -00034eb0: 0a20 2020 2020 2020 2020 2066 6f75 6e64 . found │ │ │ │ │ -00034ec0: 2061 7420 4f46 4653 4554 2062 7974 6573 at OFFSET bytes │ │ │ │ │ -00034ed0: 2069 6e74 6f20 7468 6520 7365 6c65 6374 into the select │ │ │ │ │ -00034ee0: 6564 2053 4d42 494f 5320 7374 7275 6374 ed SMBIOS struct │ │ │ │ │ -00034ef0: 7572 652e 0a20 2020 2020 2020 202a 2057 ure.. * W │ │ │ │ │ -00034f00: 6865 6e20 6769 7665 6e20 272d 2d67 6574 hen given '--get │ │ │ │ │ -00034f10: 2d75 7569 6427 2c20 7265 7475 726e 2074 -uuid', return t │ │ │ │ │ -00034f20: 6865 2076 616c 7565 206f 6620 7468 6520 he value of the │ │ │ │ │ -00034f30: 5555 4944 2028 7369 7874 6565 6e0a 2020 UUID (sixteen. │ │ │ │ │ -00034f40: 2020 2020 2020 2020 6279 7465 7329 2061 bytes) a │ │ │ │ │ -00034f50: 7420 4f46 4653 4554 2062 7974 6573 2069 t OFFSET bytes i │ │ │ │ │ -00034f60: 6e74 6f20 7468 6520 7365 6c65 6374 6564 nto the selected │ │ │ │ │ -00034f70: 2053 4d42 494f 5320 7374 7275 6374 7572 SMBIOS structur │ │ │ │ │ -00034f80: 652e 2020 4974 0a20 2020 2020 2020 2020 e. It. │ │ │ │ │ -00034f90: 2077 696c 6c20 6265 2066 6f72 6d61 7474 will be formatt │ │ │ │ │ -00034fa0: 6564 2061 7320 6c6f 7765 722d 6361 7365 ed as lower-case │ │ │ │ │ -00034fb0: 2068 7970 6865 6e61 7465 6420 6865 7861 hyphenated hexa │ │ │ │ │ -00034fc0: 6465 6369 6d61 6c20 6469 6769 7473 2c0a decimal digits,. │ │ │ │ │ -00034fd0: 2020 2020 2020 2020 2020 7769 7468 2074 with t │ │ │ │ │ -00034fe0: 6865 2066 6972 7374 2074 6872 6565 2066 he first three f │ │ │ │ │ -00034ff0: 6965 6c64 7320 6173 206c 6974 746c 652d ields as little- │ │ │ │ │ -00035000: 656e 6469 616e 2c20 616e 6420 7468 6520 endian, and the │ │ │ │ │ -00035010: 7265 7374 0a20 2020 2020 2020 2020 2070 rest. p │ │ │ │ │ -00035020: 7269 6e74 6564 2062 7974 652d 6279 2d62 rinted byte-by-b │ │ │ │ │ -00035030: 7974 652e 0a0a 2020 2020 2054 6865 2064 yte... The d │ │ │ │ │ -00035040: 6566 6175 6c74 2061 6374 696f 6e20 6973 efault action is │ │ │ │ │ -00035050: 2074 6f20 7072 696e 7420 7468 6520 7661 to print the va │ │ │ │ │ -00035060: 6c75 6520 6f66 2074 6865 2072 6571 7565 lue of the reque │ │ │ │ │ -00035070: 7374 6564 2066 6965 6c64 2074 6f0a 2020 sted field to. │ │ │ │ │ -00035080: 2020 2074 6865 2063 6f6e 736f 6c65 2c20 the console, │ │ │ │ │ -00035090: 6275 7420 6120 7661 7269 6162 6c65 206e but a variable n │ │ │ │ │ -000350a0: 616d 6520 6361 6e20 6265 2073 7065 6369 ame can be speci │ │ │ │ │ -000350b0: 6669 6564 2077 6974 6820 272d 2d73 6574 fied with '--set │ │ │ │ │ -000350c0: 2720 746f 0a20 2020 2020 7374 6f72 6520 ' to. store │ │ │ │ │ -000350d0: 7468 6520 7661 6c75 6520 696e 7374 6561 the value instea │ │ │ │ │ -000350e0: 6420 6f66 2070 7269 6e74 696e 6720 6974 d of printing it │ │ │ │ │ -000350f0: 2e0a 0a20 2020 2020 466f 7220 6578 616d ... For exam │ │ │ │ │ -00035100: 706c 652c 2074 6869 7320 7769 6c6c 2073 ple, this will s │ │ │ │ │ -00035110: 746f 7265 2061 6e64 2074 6865 6e20 6469 tore and then di │ │ │ │ │ -00035120: 7370 6c61 7920 7468 6520 7379 7374 656d splay the system │ │ │ │ │ -00035130: 0a20 2020 2020 6d61 6e75 6661 6374 7572 . manufactur │ │ │ │ │ -00035140: 6572 2773 206e 616d 652e 0a0a 2020 2020 er's name... │ │ │ │ │ -00035150: 2020 2020 2020 736d 6269 6f73 202d 2d74 smbios --t │ │ │ │ │ -00035160: 7970 6520 3120 2d2d 6765 742d 7374 7269 ype 1 --get-stri │ │ │ │ │ -00035170: 6e67 2034 202d 2d73 6574 2073 7973 7465 ng 4 --set syste │ │ │ │ │ -00035180: 6d5f 6d61 6e75 6661 6374 7572 6572 0a20 m_manufacturer. │ │ │ │ │ -00035190: 2020 2020 2020 2020 2065 6368 6f20 2473 echo $s │ │ │ │ │ -000351a0: 7973 7465 6d5f 6d61 6e75 6661 6374 7572 ystem_manufactur │ │ │ │ │ -000351b0: 6572 0a0a 1f0a 4669 6c65 3a20 6772 7562 er....File: grub │ │ │ │ │ -000351c0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 736f .info, Node: so │ │ │ │ │ -000351d0: 7572 6365 2c20 204e 6578 743a 2074 6573 urce, Next: tes │ │ │ │ │ -000351e0: 742c 2020 5072 6576 3a20 736d 6269 6f73 t, Prev: smbios │ │ │ │ │ -000351f0: 2c20 2055 703a 2043 6f6d 6d61 6e64 2d6c , Up: Command-l │ │ │ │ │ -00035200: 696e 6520 616e 6420 6d65 6e75 2065 6e74 ine and menu ent │ │ │ │ │ -00035210: 7279 2063 6f6d 6d61 6e64 730a 0a31 362e ry commands..16. │ │ │ │ │ -00035220: 332e 3733 2073 6f75 7263 650a 2d2d 2d2d 3.73 source.---- │ │ │ │ │ -00035230: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ -00035240: 436f 6d6d 616e 643a 2073 6f75 7263 6520 Command: source │ │ │ │ │ -00035250: 6669 6c65 0a20 2020 2020 5265 6164 2046 file. Read F │ │ │ │ │ -00035260: 494c 4520 6173 2061 2063 6f6e 6669 6775 ILE as a configu │ │ │ │ │ -00035270: 7261 7469 6f6e 2066 696c 652c 2061 7320 ration file, as │ │ │ │ │ -00035280: 6966 2069 7473 2063 6f6e 7465 6e74 7320 if its contents │ │ │ │ │ -00035290: 6861 6420 6265 656e 0a20 2020 2020 696e had been. in │ │ │ │ │ -000352a0: 636f 7270 6f72 6174 6564 2064 6972 6563 corporated direc │ │ │ │ │ -000352b0: 746c 7920 696e 746f 2074 6865 2073 6f75 tly into the sou │ │ │ │ │ -000352c0: 7263 696e 6720 6669 6c65 2e20 2055 6e6c rcing file. Unl │ │ │ │ │ -000352d0: 696b 6520 2763 6f6e 6669 6766 696c 6527 ike 'configfile' │ │ │ │ │ -000352e0: 0a20 2020 2020 282a 6e6f 7465 2063 6f6e . (*note con │ │ │ │ │ -000352f0: 6669 6766 696c 653a 3a29 2c20 7468 6973 figfile::), this │ │ │ │ │ -00035300: 2065 7865 6375 7465 7320 7468 6520 636f executes the co │ │ │ │ │ -00035310: 6e74 656e 7473 206f 6620 4649 4c45 2077 ntents of FILE w │ │ │ │ │ -00035320: 6974 686f 7574 0a20 2020 2020 6368 616e ithout. chan │ │ │ │ │ -00035330: 6769 6e67 2063 6f6e 7465 7874 3a20 616e ging context: an │ │ │ │ │ -00035340: 7920 656e 7669 726f 6e6d 656e 7420 7661 y environment va │ │ │ │ │ -00035350: 7269 6162 6c65 2063 6861 6e67 6573 206d riable changes m │ │ │ │ │ -00035360: 6164 6520 6279 2074 6865 0a20 2020 2020 ade by the. │ │ │ │ │ -00035370: 636f 6d6d 616e 6473 2069 6e20 4649 4c45 commands in FILE │ │ │ │ │ -00035380: 2077 696c 6c20 6265 2070 7265 7365 7276 will be preserv │ │ │ │ │ -00035390: 6564 2061 6674 6572 2027 736f 7572 6365 ed after 'source │ │ │ │ │ -000353a0: 2720 7265 7475 726e 732c 2061 6e64 2074 ' returns, and t │ │ │ │ │ -000353b0: 6865 0a20 2020 2020 6d65 6e75 2077 696c he. menu wil │ │ │ │ │ -000353c0: 6c20 6e6f 7420 6265 2073 686f 776e 2069 l not be shown i │ │ │ │ │ -000353d0: 6d6d 6564 6961 7465 6c79 2e0a 0a1f 0a46 mmediately.....F │ │ │ │ │ -000353e0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ -000353f0: 204e 6f64 653a 2074 6573 742c 2020 4e65 Node: test, Ne │ │ │ │ │ -00035400: 7874 3a20 7472 7565 2c20 2050 7265 763a xt: true, Prev: │ │ │ │ │ -00035410: 2073 6f75 7263 652c 2020 5570 3a20 436f source, Up: Co │ │ │ │ │ -00035420: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -00035430: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -00035440: 6473 0a0a 3136 2e33 2e37 3420 7465 7374 ds..16.3.74 test │ │ │ │ │ -00035450: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 .------------.. │ │ │ │ │ -00035460: 2d2d 2043 6f6d 6d61 6e64 3a20 7465 7374 -- Command: test │ │ │ │ │ -00035470: 2065 7870 7265 7373 696f 6e0a 2020 2020 expression. │ │ │ │ │ -00035480: 2045 7661 6c75 6174 6520 4558 5052 4553 Evaluate EXPRES │ │ │ │ │ -00035490: 5349 4f4e 2061 6e64 2072 6574 7572 6e20 SION and return │ │ │ │ │ -000354a0: 7a65 726f 2065 7869 7420 7374 6174 7573 zero exit status │ │ │ │ │ -000354b0: 2069 6620 7265 7375 6c74 2069 7320 7472 if result is tr │ │ │ │ │ -000354c0: 7565 2c0a 2020 2020 206e 6f6e 207a 6572 ue,. non zer │ │ │ │ │ -000354d0: 6f20 7374 6174 7573 206f 7468 6572 7769 o status otherwi │ │ │ │ │ -000354e0: 7365 2e0a 0a20 2020 2020 4558 5052 4553 se... EXPRES │ │ │ │ │ -000354f0: 5349 4f4e 2069 7320 6f6e 6520 6f66 3a0a SION is one of:. │ │ │ │ │ -00035500: 0a20 2020 2020 5354 5249 4e47 3120 273d . STRING1 '= │ │ │ │ │ -00035510: 3d27 2053 5452 494e 4732 0a20 2020 2020 =' STRING2. │ │ │ │ │ -00035520: 2020 2020 2074 6865 2073 7472 696e 6773 the strings │ │ │ │ │ -00035530: 2061 7265 2065 7175 616c 0a20 2020 2020 are equal. │ │ │ │ │ -00035540: 5354 5249 4e47 3120 2721 3d27 2053 5452 STRING1 '!=' STR │ │ │ │ │ -00035550: 494e 4732 0a20 2020 2020 2020 2020 2074 ING2. t │ │ │ │ │ -00035560: 6865 2073 7472 696e 6773 2061 7265 206e he strings are n │ │ │ │ │ -00035570: 6f74 2065 7175 616c 0a20 2020 2020 5354 ot equal. ST │ │ │ │ │ -00035580: 5249 4e47 3120 273c 2720 5354 5249 4e47 RING1 '<' STRING │ │ │ │ │ -00035590: 320a 2020 2020 2020 2020 2020 5354 5249 2. STRI │ │ │ │ │ -000355a0: 4e47 3120 6973 206c 6578 6963 6f67 7261 NG1 is lexicogra │ │ │ │ │ -000355b0: 7068 6963 616c 6c79 206c 6573 7320 7468 phically less th │ │ │ │ │ -000355c0: 616e 2053 5452 494e 4732 0a20 2020 2020 an STRING2. │ │ │ │ │ -000355d0: 5354 5249 4e47 3120 273c 3d27 2053 5452 STRING1 '<=' STR │ │ │ │ │ -000355e0: 494e 4732 0a20 2020 2020 2020 2020 2053 ING2. S │ │ │ │ │ -000355f0: 5452 494e 4731 2069 7320 6c65 7869 636f TRING1 is lexico │ │ │ │ │ -00035600: 6772 6170 6869 6361 6c6c 7920 6c65 7373 graphically less │ │ │ │ │ -00035610: 206f 7220 6571 7561 6c20 7468 616e 2053 or equal than S │ │ │ │ │ -00035620: 5452 494e 4732 0a20 2020 2020 5354 5249 TRING2. STRI │ │ │ │ │ -00035630: 4e47 3120 273e 2720 5354 5249 4e47 320a NG1 '>' STRING2. │ │ │ │ │ -00035640: 2020 2020 2020 2020 2020 5354 5249 4e47 STRING │ │ │ │ │ -00035650: 3120 6973 206c 6578 6963 6f67 7261 7068 1 is lexicograph │ │ │ │ │ -00035660: 6963 616c 6c79 2067 7265 6174 6572 2074 ically greater t │ │ │ │ │ -00035670: 6861 6e20 5354 5249 4e47 320a 2020 2020 han STRING2. │ │ │ │ │ -00035680: 2053 5452 494e 4731 2027 3e3d 2720 5354 STRING1 '>=' ST │ │ │ │ │ -00035690: 5249 4e47 320a 2020 2020 2020 2020 2020 RING2. │ │ │ │ │ -000356a0: 5354 5249 4e47 3120 6973 206c 6578 6963 STRING1 is lexic │ │ │ │ │ -000356b0: 6f67 7261 7068 6963 616c 6c79 2067 7265 ographically gre │ │ │ │ │ -000356c0: 6174 6572 206f 7220 6571 7561 6c20 7468 ater or equal th │ │ │ │ │ -000356d0: 616e 2053 5452 494e 4732 0a20 2020 2020 an STRING2. │ │ │ │ │ -000356e0: 494e 5445 4745 5231 2027 2d65 7127 2049 INTEGER1 '-eq' I │ │ │ │ │ -000356f0: 4e54 4547 4552 320a 2020 2020 2020 2020 NTEGER2. │ │ │ │ │ -00035700: 2020 494e 5445 4745 5231 2069 7320 6571 INTEGER1 is eq │ │ │ │ │ -00035710: 7561 6c20 746f 2049 4e54 4547 4552 320a ual to INTEGER2. │ │ │ │ │ -00035720: 2020 2020 2049 4e54 4547 4552 3120 272d INTEGER1 '- │ │ │ │ │ -00035730: 6765 2720 494e 5445 4745 5232 0a20 2020 ge' INTEGER2. │ │ │ │ │ -00035740: 2020 2020 2020 2049 4e54 4547 4552 3120 INTEGER1 │ │ │ │ │ -00035750: 6973 2067 7265 6174 6572 2074 6861 6e20 is greater than │ │ │ │ │ -00035760: 6f72 2065 7175 616c 2074 6f20 494e 5445 or equal to INTE │ │ │ │ │ -00035770: 4745 5232 0a20 2020 2020 494e 5445 4745 GER2. INTEGE │ │ │ │ │ -00035780: 5231 2027 2d67 7427 2049 4e54 4547 4552 R1 '-gt' INTEGER │ │ │ │ │ -00035790: 320a 2020 2020 2020 2020 2020 494e 5445 2. INTE │ │ │ │ │ -000357a0: 4745 5231 2069 7320 6772 6561 7465 7220 GER1 is greater │ │ │ │ │ -000357b0: 7468 616e 2049 4e54 4547 4552 320a 2020 than INTEGER2. │ │ │ │ │ -000357c0: 2020 2049 4e54 4547 4552 3120 272d 6c65 INTEGER1 '-le │ │ │ │ │ -000357d0: 2720 494e 5445 4745 5232 0a20 2020 2020 ' INTEGER2. │ │ │ │ │ -000357e0: 2020 2020 2049 4e54 4547 4552 3120 6973 INTEGER1 is │ │ │ │ │ -000357f0: 206c 6573 7320 7468 616e 206f 7220 6571 less than or eq │ │ │ │ │ -00035800: 7561 6c20 746f 2049 4e54 4547 4552 320a ual to INTEGER2. │ │ │ │ │ -00035810: 2020 2020 2049 4e54 4547 4552 3120 272d INTEGER1 '- │ │ │ │ │ -00035820: 6c74 2720 494e 5445 4745 5232 0a20 2020 lt' INTEGER2. │ │ │ │ │ -00035830: 2020 2020 2020 2049 4e54 4547 4552 3120 INTEGER1 │ │ │ │ │ -00035840: 6973 206c 6573 7320 7468 616e 2049 4e54 is less than INT │ │ │ │ │ -00035850: 4547 4552 320a 2020 2020 2049 4e54 4547 EGER2. INTEG │ │ │ │ │ -00035860: 4552 3120 272d 6e65 2720 494e 5445 4745 ER1 '-ne' INTEGE │ │ │ │ │ -00035870: 5232 0a20 2020 2020 2020 2020 2049 4e54 R2. INT │ │ │ │ │ -00035880: 4547 4552 3120 6973 206e 6f74 2065 7175 EGER1 is not equ │ │ │ │ │ -00035890: 616c 2074 6f20 494e 5445 4745 5232 0a20 al to INTEGER2. │ │ │ │ │ -000358a0: 2020 2020 5052 4546 4958 494e 5445 4745 PREFIXINTEGE │ │ │ │ │ -000358b0: 5231 2027 2d70 6774 2720 5052 4546 4958 R1 '-pgt' PREFIX │ │ │ │ │ -000358c0: 494e 5445 4745 5232 0a20 2020 2020 2020 INTEGER2. │ │ │ │ │ -000358d0: 2020 2049 4e54 4547 4552 3120 6973 2067 INTEGER1 is g │ │ │ │ │ -000358e0: 7265 6174 6572 2074 6861 6e20 494e 5445 reater than INTE │ │ │ │ │ -000358f0: 4745 5232 2061 6674 6572 2073 7472 6970 GER2 after strip │ │ │ │ │ -00035900: 7069 6e67 206f 6666 2063 6f6d 6d6f 6e0a ping off common. │ │ │ │ │ -00035910: 2020 2020 2020 2020 2020 6e6f 6e2d 6e75 non-nu │ │ │ │ │ -00035920: 6d65 7269 6320 5052 4546 4958 2e0a 2020 meric PREFIX.. │ │ │ │ │ -00035930: 2020 2050 5245 4649 5849 4e54 4547 4552 PREFIXINTEGER │ │ │ │ │ -00035940: 3120 272d 706c 7427 2050 5245 4649 5849 1 '-plt' PREFIXI │ │ │ │ │ -00035950: 4e54 4547 4552 320a 2020 2020 2020 2020 NTEGER2. │ │ │ │ │ -00035960: 2020 494e 5445 4745 5231 2069 7320 6c65 INTEGER1 is le │ │ │ │ │ -00035970: 7373 2074 6861 6e20 494e 5445 4745 5232 ss than INTEGER2 │ │ │ │ │ -00035980: 2061 6674 6572 2073 7472 6970 7069 6e67 after stripping │ │ │ │ │ -00035990: 206f 6666 2063 6f6d 6d6f 6e0a 2020 2020 off common. │ │ │ │ │ -000359a0: 2020 2020 2020 6e6f 6e2d 6e75 6d65 7269 non-numeri │ │ │ │ │ -000359b0: 6320 5052 4546 4958 2e0a 2020 2020 2046 c PREFIX.. F │ │ │ │ │ -000359c0: 494c 4531 2027 2d6e 7427 2046 494c 4532 ILE1 '-nt' FILE2 │ │ │ │ │ -000359d0: 0a20 2020 2020 2020 2020 2046 494c 4531 . FILE1 │ │ │ │ │ -000359e0: 2069 7320 6e65 7765 7220 7468 616e 2046 is newer than F │ │ │ │ │ -000359f0: 494c 4532 2028 6d6f 6469 6669 6361 7469 ILE2 (modificati │ │ │ │ │ -00035a00: 6f6e 2074 696d 6529 2e20 204f 7074 696f on time). Optio │ │ │ │ │ -00035a10: 6e61 6c6c 790a 2020 2020 2020 2020 2020 nally. │ │ │ │ │ -00035a20: 6e75 6d65 7269 6320 4249 4153 206d 6179 numeric BIAS may │ │ │ │ │ -00035a30: 2062 6520 6469 7265 6374 6c79 2061 7070 be directly app │ │ │ │ │ -00035a40: 656e 6465 6420 746f 2027 2d6e 7427 2069 ended to '-nt' i │ │ │ │ │ -00035a50: 6e20 7768 6963 6820 6361 7365 0a20 2020 n which case. │ │ │ │ │ -00035a60: 2020 2020 2020 2069 7420 6973 2061 6464 it is add │ │ │ │ │ -00035a70: 6564 2074 6f20 7468 6520 6669 7273 7420 ed to the first │ │ │ │ │ -00035a80: 6669 6c65 206d 6f64 6966 6963 6174 696f file modificatio │ │ │ │ │ -00035a90: 6e20 7469 6d65 2e0a 2020 2020 2046 494c n time.. FIL │ │ │ │ │ -00035aa0: 4531 2027 2d6f 7427 2046 494c 4532 0a20 E1 '-ot' FILE2. │ │ │ │ │ -00035ab0: 2020 2020 2020 2020 2046 494c 4531 2069 FILE1 i │ │ │ │ │ -00035ac0: 7320 6f6c 6465 7220 7468 616e 2046 494c s older than FIL │ │ │ │ │ -00035ad0: 4532 2028 6d6f 6469 6669 6361 7469 6f6e E2 (modification │ │ │ │ │ -00035ae0: 2074 696d 6529 2e20 204f 7074 696f 6e61 time). Optiona │ │ │ │ │ -00035af0: 6c6c 790a 2020 2020 2020 2020 2020 6e75 lly. nu │ │ │ │ │ -00035b00: 6d65 7269 6320 4249 4153 206d 6179 2062 meric BIAS may b │ │ │ │ │ -00035b10: 6520 6469 7265 6374 6c79 2061 7070 656e e directly appen │ │ │ │ │ -00035b20: 6465 6420 746f 2027 2d6f 7427 2069 6e20 ded to '-ot' in │ │ │ │ │ -00035b30: 7768 6963 6820 6361 7365 0a20 2020 2020 which case. │ │ │ │ │ -00035b40: 2020 2020 2069 7420 6973 2061 6464 6564 it is added │ │ │ │ │ -00035b50: 2074 6f20 7468 6520 6669 7273 7420 6669 to the first fi │ │ │ │ │ -00035b60: 6c65 206d 6f64 6966 6963 6174 696f 6e20 le modification │ │ │ │ │ -00035b70: 7469 6d65 2e0a 2020 2020 2027 2d64 2720 time.. '-d' │ │ │ │ │ -00035b80: 4649 4c45 0a20 2020 2020 2020 2020 2046 FILE. F │ │ │ │ │ -00035b90: 494c 4520 6578 6973 7473 2061 6e64 2069 ILE exists and i │ │ │ │ │ -00035ba0: 7320 6120 6469 7265 6374 6f72 790a 2020 s a directory. │ │ │ │ │ -00035bb0: 2020 2027 2d65 2720 4649 4c45 0a20 2020 '-e' FILE. │ │ │ │ │ -00035bc0: 2020 2020 2020 2046 494c 4520 6578 6973 FILE exis │ │ │ │ │ -00035bd0: 7473 0a20 2020 2020 272d 6627 2046 494c ts. '-f' FIL │ │ │ │ │ -00035be0: 450a 2020 2020 2020 2020 2020 4649 4c45 E. FILE │ │ │ │ │ -00035bf0: 2065 7869 7374 7320 616e 6420 6973 206e exists and is n │ │ │ │ │ -00035c00: 6f74 2061 2064 6972 6563 746f 7279 0a20 ot a directory. │ │ │ │ │ -00035c10: 2020 2020 272d 7327 2046 494c 450a 2020 '-s' FILE. │ │ │ │ │ -00035c20: 2020 2020 2020 2020 4649 4c45 2065 7869 FILE exi │ │ │ │ │ -00035c30: 7374 7320 616e 6420 6861 7320 6120 7369 sts and has a si │ │ │ │ │ -00035c40: 7a65 2067 7265 6174 6572 2074 6861 6e20 ze greater than │ │ │ │ │ -00035c50: 7a65 726f 0a20 2020 2020 272d 6e27 2053 zero. '-n' S │ │ │ │ │ -00035c60: 5452 494e 470a 2020 2020 2020 2020 2020 TRING. │ │ │ │ │ -00035c70: 7468 6520 6c65 6e67 7468 206f 6620 5354 the length of ST │ │ │ │ │ -00035c80: 5249 4e47 2069 7320 6e6f 6e7a 6572 6f0a RING is nonzero. │ │ │ │ │ -00035c90: 2020 2020 2053 5452 494e 470a 2020 2020 STRING. │ │ │ │ │ -00035ca0: 2020 2020 2020 5354 5249 4e47 2069 7320 STRING is │ │ │ │ │ -00035cb0: 6571 7569 7661 6c65 6e74 2074 6f20 272d equivalent to '- │ │ │ │ │ -00035cc0: 6e20 5354 5249 4e47 270a 2020 2020 2027 n STRING'. ' │ │ │ │ │ -00035cd0: 2d7a 2720 5354 5249 4e47 0a20 2020 2020 -z' STRING. │ │ │ │ │ -00035ce0: 2020 2020 2074 6865 206c 656e 6774 6820 the length │ │ │ │ │ -00035cf0: 6f66 2053 5452 494e 4720 6973 207a 6572 of STRING is zer │ │ │ │ │ -00035d00: 6f0a 2020 2020 2027 2827 2045 5850 5245 o. '(' EXPRE │ │ │ │ │ -00035d10: 5353 494f 4e20 2729 270a 2020 2020 2020 SSION ')'. │ │ │ │ │ -00035d20: 2020 2020 4558 5052 4553 5349 4f4e 2069 EXPRESSION i │ │ │ │ │ -00035d30: 7320 7472 7565 0a20 2020 2020 2721 2720 s true. '!' │ │ │ │ │ -00035d40: 4558 5052 4553 5349 4f4e 0a20 2020 2020 EXPRESSION. │ │ │ │ │ -00035d50: 2020 2020 2045 5850 5245 5353 494f 4e20 EXPRESSION │ │ │ │ │ -00035d60: 6973 2066 616c 7365 0a20 2020 2020 4558 is false. EX │ │ │ │ │ -00035d70: 5052 4553 5349 4f4e 3120 272d 6127 2045 PRESSION1 '-a' E │ │ │ │ │ -00035d80: 5850 5245 5353 494f 4e32 0a20 2020 2020 XPRESSION2. │ │ │ │ │ -00035d90: 2020 2020 2062 6f74 6820 4558 5052 4553 both EXPRES │ │ │ │ │ -00035da0: 5349 4f4e 3120 616e 6420 4558 5052 4553 SION1 and EXPRES │ │ │ │ │ -00035db0: 5349 4f4e 3220 6172 6520 7472 7565 0a20 SION2 are true. │ │ │ │ │ -00035dc0: 2020 2020 4558 5052 4553 5349 4f4e 3120 EXPRESSION1 │ │ │ │ │ -00035dd0: 4558 5052 4553 5349 4f4e 320a 2020 2020 EXPRESSION2. │ │ │ │ │ -00035de0: 2020 2020 2020 626f 7468 2045 5850 5245 both EXPRE │ │ │ │ │ -00035df0: 5353 494f 4e31 2061 6e64 2045 5850 5245 SSION1 and EXPRE │ │ │ │ │ -00035e00: 5353 494f 4e32 2061 7265 2074 7275 652e SSION2 are true. │ │ │ │ │ -00035e10: 2020 5468 6973 2073 796e 7461 7820 6973 This syntax is │ │ │ │ │ -00035e20: 206e 6f74 0a20 2020 2020 2020 2020 2050 not. P │ │ │ │ │ -00035e30: 4f53 4958 2d63 6f6d 706c 6961 6e74 2061 OSIX-compliant a │ │ │ │ │ -00035e40: 6e64 2069 7320 6e6f 7420 7265 636f 6d6d nd is not recomm │ │ │ │ │ -00035e50: 656e 6465 642e 0a20 2020 2020 4558 5052 ended.. EXPR │ │ │ │ │ -00035e60: 4553 5349 4f4e 3120 272d 6f27 2045 5850 ESSION1 '-o' EXP │ │ │ │ │ -00035e70: 5245 5353 494f 4e32 0a20 2020 2020 2020 RESSION2. │ │ │ │ │ -00035e80: 2020 2065 6974 6865 7220 4558 5052 4553 either EXPRES │ │ │ │ │ -00035e90: 5349 4f4e 3120 6f72 2045 5850 5245 5353 SION1 or EXPRESS │ │ │ │ │ -00035ea0: 494f 4e32 2069 7320 7472 7565 0a0a 1f0a ION2 is true.... │ │ │ │ │ -00035eb0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -00035ec0: 2020 4e6f 6465 3a20 7472 7565 2c20 204e Node: true, N │ │ │ │ │ -00035ed0: 6578 743a 2074 7275 7374 2c20 2050 7265 ext: trust, Pre │ │ │ │ │ -00035ee0: 763a 2074 6573 742c 2020 5570 3a20 436f v: test, Up: Co │ │ │ │ │ -00035ef0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -00035f00: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -00035f10: 6473 0a0a 3136 2e33 2e37 3520 7472 7565 ds..16.3.75 true │ │ │ │ │ -00035f20: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 .------------.. │ │ │ │ │ -00035f30: 2d2d 2043 6f6d 6d61 6e64 3a20 7472 7565 -- Command: true │ │ │ │ │ -00035f40: 0a20 2020 2020 446f 206e 6f74 6869 6e67 . Do nothing │ │ │ │ │ -00035f50: 2c20 7375 6363 6573 7366 756c 6c79 2e20 , successfully. │ │ │ │ │ -00035f60: 2054 6869 7320 6973 206d 6169 6e6c 7920 This is mainly │ │ │ │ │ -00035f70: 7573 6566 756c 2069 6e20 636f 6e74 726f useful in contro │ │ │ │ │ -00035f80: 6c0a 2020 2020 2063 6f6e 7374 7275 6374 l. construct │ │ │ │ │ -00035f90: 7320 7375 6368 2061 7320 2769 6627 2061 s such as 'if' a │ │ │ │ │ -00035fa0: 6e64 2027 7768 696c 6527 2028 2a6e 6f74 nd 'while' (*not │ │ │ │ │ -00035fb0: 6520 5368 656c 6c2d 6c69 6b65 2073 6372 e Shell-like scr │ │ │ │ │ -00035fc0: 6970 7469 6e67 3a3a 292e 0a0a 1f0a 4669 ipting::).....Fi │ │ │ │ │ -00035fd0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00035fe0: 4e6f 6465 3a20 7472 7573 742c 2020 4e65 Node: trust, Ne │ │ │ │ │ -00035ff0: 7874 3a20 756e 7365 742c 2020 5072 6576 xt: unset, Prev │ │ │ │ │ -00036000: 3a20 7472 7565 2c20 2055 703a 2043 6f6d : true, Up: Com │ │ │ │ │ -00036010: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ -00036020: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ -00036030: 730a 0a31 362e 332e 3736 2074 7275 7374 s..16.3.76 trust │ │ │ │ │ -00036040: 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a .-------------.. │ │ │ │ │ -00036050: 202d 2d20 436f 6d6d 616e 643a 2074 7275 -- Command: tru │ │ │ │ │ -00036060: 7374 205b 2d2d 736b 6970 2d73 6967 5d20 st [--skip-sig] │ │ │ │ │ -00036070: 7075 626b 6579 5f66 696c 650a 2020 2020 pubkey_file. │ │ │ │ │ -00036080: 2052 6561 6420 7075 626c 6963 206b 6579 Read public key │ │ │ │ │ -00036090: 2066 726f 6d20 5055 424b 4559 5f46 494c from PUBKEY_FIL │ │ │ │ │ -000360a0: 4520 616e 6420 6164 6420 6974 2074 6f20 E and add it to │ │ │ │ │ -000360b0: 4752 5542 2773 2069 6e74 6572 6e61 6c20 GRUB's internal │ │ │ │ │ -000360c0: 6c69 7374 0a20 2020 2020 6f66 2074 7275 list. of tru │ │ │ │ │ -000360d0: 7374 6564 2070 7562 6c69 6320 6b65 7973 sted public keys │ │ │ │ │ -000360e0: 2e20 2054 6865 7365 206b 6579 7320 6172 . These keys ar │ │ │ │ │ -000360f0: 6520 7573 6564 2074 6f20 7661 6c69 6461 e used to valida │ │ │ │ │ -00036100: 7465 2064 6967 6974 616c 0a20 2020 2020 te digital. │ │ │ │ │ -00036110: 7369 676e 6174 7572 6573 2077 6865 6e20 signatures when │ │ │ │ │ -00036120: 656e 7669 726f 6e6d 656e 7420 7661 7269 environment vari │ │ │ │ │ -00036130: 6162 6c65 2027 6368 6563 6b5f 7369 676e able 'check_sign │ │ │ │ │ -00036140: 6174 7572 6573 2720 6973 2073 6574 2074 atures' is set t │ │ │ │ │ -00036150: 6f0a 2020 2020 2027 656e 666f 7263 6527 o. 'enforce' │ │ │ │ │ -00036160: 2e20 204e 6f74 6520 7468 6174 2069 6620 . Note that if │ │ │ │ │ -00036170: 2763 6865 636b 5f73 6967 6e61 7475 7265 'check_signature │ │ │ │ │ -00036180: 7327 2069 7320 7365 7420 746f 2027 656e s' is set to 'en │ │ │ │ │ -00036190: 666f 7263 6527 0a20 2020 2020 7768 656e force'. when │ │ │ │ │ -000361a0: 2027 7472 7573 7427 2065 7865 6375 7465 'trust' execute │ │ │ │ │ -000361b0: 732c 2074 6865 6e20 5055 424b 4559 5f46 s, then PUBKEY_F │ │ │ │ │ -000361c0: 494c 4520 6d75 7374 2069 7473 656c 6620 ILE must itself │ │ │ │ │ -000361d0: 6265 2070 726f 7065 726c 790a 2020 2020 be properly. │ │ │ │ │ -000361e0: 2073 6967 6e65 642e 2020 5468 6520 272d signed. The '- │ │ │ │ │ -000361f0: 2d73 6b69 702d 7369 6727 206f 7074 696f -skip-sig' optio │ │ │ │ │ -00036200: 6e20 6361 6e20 6265 2075 7365 6420 746f n can be used to │ │ │ │ │ -00036210: 2064 6973 6162 6c65 0a20 2020 2020 7369 disable. si │ │ │ │ │ -00036220: 676e 6174 7572 652d 6368 6563 6b69 6e67 gnature-checking │ │ │ │ │ -00036230: 2077 6865 6e20 7265 6164 696e 6720 5055 when reading PU │ │ │ │ │ -00036240: 424b 4559 5f46 494c 4520 6974 7365 6c66 BKEY_FILE itself │ │ │ │ │ -00036250: 2e20 2049 7420 6973 2065 7870 6563 7465 . It is expecte │ │ │ │ │ -00036260: 640a 2020 2020 2074 6861 7420 272d 2d73 d. that '--s │ │ │ │ │ -00036270: 6b69 702d 7369 6727 2069 7320 7573 6566 kip-sig' is usef │ │ │ │ │ -00036280: 756c 2066 6f72 2074 6573 7469 6e67 2061 ul for testing a │ │ │ │ │ -00036290: 6e64 206d 616e 7561 6c20 626f 6f74 696e nd manual bootin │ │ │ │ │ -000362a0: 672e 2020 2a4e 6f74 650a 2020 2020 2055 g. *Note. U │ │ │ │ │ -000362b0: 7369 6e67 2064 6967 6974 616c 2073 6967 sing digital sig │ │ │ │ │ -000362c0: 6e61 7475 7265 733a 3a2c 2066 6f72 206d natures::, for m │ │ │ │ │ -000362d0: 6f72 6520 696e 666f 726d 6174 696f 6e2e ore information. │ │ │ │ │ -000362e0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -000362f0: 6e66 6f2c 2020 4e6f 6465 3a20 756e 7365 nfo, Node: unse │ │ │ │ │ -00036300: 742c 2020 4e65 7874 3a20 7665 7269 6679 t, Next: verify │ │ │ │ │ -00036310: 5f64 6574 6163 6865 642c 2020 5072 6576 _detached, Prev │ │ │ │ │ -00036320: 3a20 7472 7573 742c 2020 5570 3a20 436f : trust, Up: Co │ │ │ │ │ -00036330: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -00036340: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -00036350: 6473 0a0a 3136 2e33 2e37 3720 756e 7365 ds..16.3.77 unse │ │ │ │ │ -00036360: 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a t.-------------. │ │ │ │ │ -00036370: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 756e . -- Command: un │ │ │ │ │ -00036380: 7365 7420 656e 7676 6172 0a20 2020 2020 set envvar. │ │ │ │ │ -00036390: 556e 7365 7420 7468 6520 656e 7669 726f Unset the enviro │ │ │ │ │ -000363a0: 6e6d 656e 7420 7661 7269 6162 6c65 2045 nment variable E │ │ │ │ │ -000363b0: 4e56 5641 522e 0a0a 1f0a 4669 6c65 3a20 NVVAR.....File: │ │ │ │ │ -000363c0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -000363d0: 3a20 7665 7269 6679 5f64 6574 6163 6865 : verify_detache │ │ │ │ │ -000363e0: 642c 2020 4e65 7874 3a20 7669 6465 6f69 d, Next: videoi │ │ │ │ │ -000363f0: 6e66 6f2c 2020 5072 6576 3a20 756e 7365 nfo, Prev: unse │ │ │ │ │ -00036400: 742c 2020 5570 3a20 436f 6d6d 616e 642d t, Up: Command- │ │ │ │ │ -00036410: 6c69 6e65 2061 6e64 206d 656e 7520 656e line and menu en │ │ │ │ │ -00036420: 7472 7920 636f 6d6d 616e 6473 0a0a 3136 try commands..16 │ │ │ │ │ -00036430: 2e33 2e37 3820 7665 7269 6679 5f64 6574 .3.78 verify_det │ │ │ │ │ -00036440: 6163 6865 640a 2d2d 2d2d 2d2d 2d2d 2d2d ached.---------- │ │ │ │ │ -00036450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ -00036460: 2d2d 2043 6f6d 6d61 6e64 3a20 7665 7269 -- Command: veri │ │ │ │ │ -00036470: 6679 5f64 6574 6163 6865 6420 5b2d 2d73 fy_detached [--s │ │ │ │ │ -00036480: 6b69 702d 7369 675d 2066 696c 6520 7369 kip-sig] file si │ │ │ │ │ -00036490: 676e 6174 7572 655f 6669 6c65 0a20 2020 gnature_file. │ │ │ │ │ -000364a0: 2020 2020 2020 205b 7075 626b 6579 5f66 [pubkey_f │ │ │ │ │ -000364b0: 696c 655d 0a20 2020 2020 5665 7269 6669 ile]. Verifi │ │ │ │ │ -000364c0: 6573 2061 2047 5047 2d73 7479 6c65 2064 es a GPG-style d │ │ │ │ │ -000364d0: 6574 6163 6865 6420 7369 676e 6174 7572 etached signatur │ │ │ │ │ -000364e0: 652c 2077 6865 7265 2074 6865 2073 6967 e, where the sig │ │ │ │ │ -000364f0: 6e65 6420 6669 6c65 2069 730a 2020 2020 ned file is. │ │ │ │ │ -00036500: 2046 494c 452c 2061 6e64 2074 6865 2073 FILE, and the s │ │ │ │ │ -00036510: 6967 6e61 7475 7265 2069 7473 656c 6620 ignature itself │ │ │ │ │ -00036520: 6973 2069 6e20 6669 6c65 2053 4947 4e41 is in file SIGNA │ │ │ │ │ -00036530: 5455 5245 5f46 494c 452e 0a20 2020 2020 TURE_FILE.. │ │ │ │ │ -00036540: 4f70 7469 6f6e 616c 6c79 2c20 6120 7370 Optionally, a sp │ │ │ │ │ -00036550: 6563 6966 6963 2070 7562 6c69 6320 6b65 ecific public ke │ │ │ │ │ -00036560: 7920 746f 2075 7365 2063 616e 2062 6520 y to use can be │ │ │ │ │ -00036570: 7370 6563 6966 6965 6420 7573 696e 670a specified using. │ │ │ │ │ -00036580: 2020 2020 2050 5542 4b45 595f 4649 4c45 PUBKEY_FILE │ │ │ │ │ -00036590: 2e20 2057 6865 6e20 656e 7669 726f 6e6d . When environm │ │ │ │ │ -000365a0: 656e 7420 7661 7269 6162 6c65 2027 6368 ent variable 'ch │ │ │ │ │ -000365b0: 6563 6b5f 7369 676e 6174 7572 6573 2720 eck_signatures' │ │ │ │ │ -000365c0: 6973 2073 6574 0a20 2020 2020 746f 2027 is set. to ' │ │ │ │ │ -000365d0: 656e 666f 7263 6527 2c20 7468 656e 2050 enforce', then P │ │ │ │ │ -000365e0: 5542 4b45 595f 4649 4c45 206d 7573 7420 UBKEY_FILE must │ │ │ │ │ -000365f0: 6974 7365 6c66 2062 6520 7072 6f70 6572 itself be proper │ │ │ │ │ -00036600: 6c79 2073 6967 6e65 6420 6279 2061 6e0a ly signed by an. │ │ │ │ │ -00036610: 2020 2020 2061 6c72 6561 6479 2d74 7275 already-tru │ │ │ │ │ -00036620: 7374 6564 206b 6579 2e20 2041 6e20 756e sted key. An un │ │ │ │ │ -00036630: 7369 676e 6564 2050 5542 4b45 595f 4649 signed PUBKEY_FI │ │ │ │ │ -00036640: 4c45 2063 616e 2062 6520 6c6f 6164 6564 LE can be loaded │ │ │ │ │ -00036650: 2062 790a 2020 2020 2073 7065 6369 6679 by. specify │ │ │ │ │ -00036660: 696e 6720 272d 2d73 6b69 702d 7369 6727 ing '--skip-sig' │ │ │ │ │ -00036670: 2e20 2049 6620 5055 424b 4559 5f46 494c . If PUBKEY_FIL │ │ │ │ │ -00036680: 4520 6973 206f 6d69 7474 6564 2c20 7468 E is omitted, th │ │ │ │ │ -00036690: 656e 2070 7562 6c69 630a 2020 2020 206b en public. k │ │ │ │ │ -000366a0: 6579 7320 6672 6f6d 2047 5255 4227 7320 eys from GRUB's │ │ │ │ │ -000366b0: 7472 7573 7465 6420 6b65 7973 2028 2a6e trusted keys (*n │ │ │ │ │ -000366c0: 6f74 6520 6c69 7374 5f74 7275 7374 6564 ote list_trusted │ │ │ │ │ -000366d0: 3a3a 2c20 2a6e 6f74 6520 7472 7573 743a ::, *note trust: │ │ │ │ │ -000366e0: 3a2c 0a20 2020 2020 616e 6420 2a6e 6f74 :,. and *not │ │ │ │ │ -000366f0: 6520 6469 7374 7275 7374 3a3a 2920 6172 e distrust::) ar │ │ │ │ │ -00036700: 6520 7472 6965 642e 0a0a 2020 2020 2045 e tried... E │ │ │ │ │ -00036710: 7869 7420 636f 6465 2027 243f 2720 6973 xit code '$?' is │ │ │ │ │ -00036720: 2073 6574 2074 6f20 3020 6966 2074 6865 set to 0 if the │ │ │ │ │ -00036730: 2073 6967 6e61 7475 7265 2076 616c 6964 signature valid │ │ │ │ │ -00036740: 6174 6573 2073 7563 6365 7373 6675 6c6c ates successfull │ │ │ │ │ -00036750: 792e 0a20 2020 2020 4966 2076 616c 6964 y.. If valid │ │ │ │ │ -00036760: 6174 696f 6e20 6661 696c 732c 2069 7420 ation fails, it │ │ │ │ │ -00036770: 6973 2073 6574 2074 6f20 6120 6e6f 6e2d is set to a non- │ │ │ │ │ -00036780: 7a65 726f 2076 616c 7565 2e20 202a 4e6f zero value. *No │ │ │ │ │ -00036790: 7465 2055 7369 6e67 0a20 2020 2020 6469 te Using. di │ │ │ │ │ -000367a0: 6769 7461 6c20 7369 676e 6174 7572 6573 gital signatures │ │ │ │ │ -000367b0: 3a3a 2c20 666f 7220 6d6f 7265 2069 6e66 ::, for more inf │ │ │ │ │ -000367c0: 6f72 6d61 7469 6f6e 2e0a 0a1f 0a46 696c ormation.....Fil │ │ │ │ │ -000367d0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -000367e0: 6f64 653a 2076 6964 656f 696e 666f 2c20 ode: videoinfo, │ │ │ │ │ -000367f0: 204e 6578 743a 2077 726d 7372 2c20 2050 Next: wrmsr, P │ │ │ │ │ -00036800: 7265 763a 2076 6572 6966 795f 6465 7461 rev: verify_deta │ │ │ │ │ -00036810: 6368 6564 2c20 2055 703a 2043 6f6d 6d61 ched, Up: Comma │ │ │ │ │ -00036820: 6e64 2d6c 696e 6520 616e 6420 6d65 6e75 nd-line and menu │ │ │ │ │ -00036830: 2065 6e74 7279 2063 6f6d 6d61 6e64 730a entry commands. │ │ │ │ │ -00036840: 0a31 362e 332e 3739 2076 6964 656f 696e .16.3.79 videoin │ │ │ │ │ -00036850: 666f 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d fo.------------- │ │ │ │ │ -00036860: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -00036870: 643a 2076 6964 656f 696e 666f 205b 5b57 d: videoinfo [[W │ │ │ │ │ -00036880: 7848 5d78 445d 0a20 2020 2020 4c69 7374 xH]xD]. List │ │ │ │ │ -00036890: 2061 7661 696c 6162 6c65 2076 6964 656f available video │ │ │ │ │ -000368a0: 206d 6f64 6573 2e20 2049 6620 7265 736f modes. If reso │ │ │ │ │ -000368b0: 6c75 7469 6f6e 2069 7320 6769 7665 6e2c lution is given, │ │ │ │ │ -000368c0: 2073 686f 7720 6f6e 6c79 0a20 2020 2020 show only. │ │ │ │ │ -000368d0: 6d61 7463 6869 6e67 206d 6f64 6573 2e0a matching modes.. │ │ │ │ │ -000368e0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -000368f0: 666f 2c20 204e 6f64 653a 2077 726d 7372 fo, Node: wrmsr │ │ │ │ │ -00036900: 2c20 204e 6578 743a 2078 656e 5f68 7970 , Next: xen_hyp │ │ │ │ │ -00036910: 6572 7669 736f 722c 2020 5072 6576 3a20 ervisor, Prev: │ │ │ │ │ -00036920: 7669 6465 6f69 6e66 6f2c 2020 5570 3a20 videoinfo, Up: │ │ │ │ │ -00036930: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -00036940: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -00036950: 616e 6473 0a0a 3136 2e33 2e38 3020 7772 ands..16.3.80 wr │ │ │ │ │ -00036960: 6d73 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d msr.------------ │ │ │ │ │ -00036970: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a3a -.. -- Command:: │ │ │ │ │ -00036980: 2077 726d 7372 2030 7841 4444 5220 3078 wrmsr 0xADDR 0x │ │ │ │ │ -00036990: 5641 4c55 450a 2020 2020 2057 7269 7465 VALUE. Write │ │ │ │ │ -000369a0: 2061 2030 7856 414c 5545 2074 6f20 6120 a 0xVALUE to a │ │ │ │ │ -000369b0: 6d6f 6465 6c2d 7370 6563 6966 6963 2072 model-specific r │ │ │ │ │ -000369c0: 6567 6973 7465 7220 6174 2061 6464 7265 egister at addre │ │ │ │ │ -000369d0: 7373 2030 7841 4444 522e 0a0a 2020 2020 ss 0xADDR... │ │ │ │ │ -000369e0: 2050 6c65 6173 6520 6e6f 7465 2074 6861 Please note tha │ │ │ │ │ -000369f0: 7420 6f6e 2053 4d50 2073 7973 7465 6d73 t on SMP systems │ │ │ │ │ -00036a00: 2c20 7772 6974 696e 6720 746f 2061 204d , writing to a M │ │ │ │ │ -00036a10: 5352 2074 6861 7420 6861 7320 6120 7363 SR that has a sc │ │ │ │ │ -00036a20: 6f70 650a 2020 2020 2070 6572 2068 6172 ope. per har │ │ │ │ │ -00036a30: 6477 6172 6520 7468 7265 6164 2c20 696d dware thread, im │ │ │ │ │ -00036a40: 706c 6965 7320 7468 6174 2074 6865 2076 plies that the v │ │ │ │ │ -00036a50: 616c 7565 2074 6861 7420 6973 2077 7269 alue that is wri │ │ │ │ │ -00036a60: 7474 656e 206f 6e6c 790a 2020 2020 2061 tten only. a │ │ │ │ │ -00036a70: 7070 6c69 6573 2074 6f20 7468 6520 7061 pplies to the pa │ │ │ │ │ -00036a80: 7274 6963 756c 6172 2063 7075 2f63 6f72 rticular cpu/cor │ │ │ │ │ -00036a90: 652f 7468 7265 6164 2074 6861 7420 7275 e/thread that ru │ │ │ │ │ -00036aa0: 6e73 2074 6865 2063 6f6d 6d61 6e64 2e0a ns the command.. │ │ │ │ │ -00036ab0: 0a20 2020 2020 416c 736f 2c20 6966 2079 . Also, if y │ │ │ │ │ -00036ac0: 6f75 2073 7065 6369 6679 2061 2072 6573 ou specify a res │ │ │ │ │ -00036ad0: 6572 7665 6420 6f72 2075 6e69 6d70 6c65 erved or unimple │ │ │ │ │ -00036ae0: 6d65 6e74 6564 204d 5352 2061 6464 7265 mented MSR addre │ │ │ │ │ -00036af0: 7373 2c20 6974 0a20 2020 2020 7769 6c6c ss, it. will │ │ │ │ │ -00036b00: 2063 6175 7365 2061 2067 656e 6572 616c cause a general │ │ │ │ │ -00036b10: 2070 726f 7465 6374 696f 6e20 6578 6365 protection exce │ │ │ │ │ -00036b20: 7074 696f 6e20 2877 6869 6368 2069 7320 ption (which is │ │ │ │ │ -00036b30: 6e6f 7420 6375 7272 656e 746c 790a 2020 not currently. │ │ │ │ │ -00036b40: 2020 2062 6569 6e67 2068 616e 646c 6564 being handled │ │ │ │ │ -00036b50: 2920 616e 6420 7468 6520 7379 7374 656d ) and the system │ │ │ │ │ -00036b60: 2077 696c 6c20 7265 626f 6f74 2e0a 0a20 will reboot... │ │ │ │ │ -00036b70: 2020 2020 4e6f 7465 3a20 5468 6520 636f Note: The co │ │ │ │ │ -00036b80: 6d6d 616e 6420 6973 206e 6f74 2061 6c6c mmand is not all │ │ │ │ │ -00036b90: 6f77 6564 2077 6865 6e20 6c6f 636b 646f owed when lockdo │ │ │ │ │ -00036ba0: 776e 2069 7320 656e 666f 7263 6564 2028 wn is enforced ( │ │ │ │ │ -00036bb0: 2a6e 6f74 650a 2020 2020 204c 6f63 6b64 *note. Lockd │ │ │ │ │ -00036bc0: 6f77 6e3a 3a29 2e20 2054 6869 7320 6973 own::). This is │ │ │ │ │ -00036bd0: 2064 6f6e 6520 746f 2070 7265 7665 6e74 done to prevent │ │ │ │ │ -00036be0: 2073 7562 7665 7274 696e 6720 7661 7269 subverting vari │ │ │ │ │ -00036bf0: 6f75 7320 7365 6375 7269 7479 0a20 2020 ous security. │ │ │ │ │ -00036c00: 2020 6d65 6368 616e 6973 6d73 2e0a 0a1f mechanisms.... │ │ │ │ │ -00036c10: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00036c20: 2c20 204e 6f64 653a 2078 656e 5f68 7970 , Node: xen_hyp │ │ │ │ │ -00036c30: 6572 7669 736f 722c 2020 4e65 7874 3a20 ervisor, Next: │ │ │ │ │ -00036c40: 7865 6e5f 6d6f 6475 6c65 2c20 2050 7265 xen_module, Pre │ │ │ │ │ -00036c50: 763a 2077 726d 7372 2c20 2055 703a 2043 v: wrmsr, Up: C │ │ │ │ │ -00036c60: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ -00036c70: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ -00036c80: 6e64 730a 0a31 362e 332e 3831 2078 656e nds..16.3.81 xen │ │ │ │ │ -00036c90: 5f68 7970 6572 7669 736f 720a 2d2d 2d2d _hypervisor.---- │ │ │ │ │ +00033a40: 2020 2020 2020 2020 4c65 6674 0a20 2020 Left. │ │ │ │ │ +00033a50: 2020 7269 6768 7420 2020 2020 2020 2020 right │ │ │ │ │ +00033a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00033a70: 5269 6768 740a 0a20 2020 2020 4173 2077 Right.. As w │ │ │ │ │ +00033a80: 656c 6c20 6173 206b 6579 7374 726f 6b65 ell as keystroke │ │ │ │ │ +00033a90: 732c 2074 6865 2027 7365 6e64 6b65 7927 s, the 'sendkey' │ │ │ │ │ +00033aa0: 2063 6f6d 6d61 6e64 2074 616b 6573 2076 command takes v │ │ │ │ │ +00033ab0: 6172 696f 7573 206f 7074 696f 6e73 0a20 arious options. │ │ │ │ │ +00033ac0: 2020 2020 7468 6174 2061 6666 6563 7420 that affect │ │ │ │ │ +00033ad0: 7468 6520 4249 4f53 206b 6579 626f 6172 the BIOS keyboar │ │ │ │ │ +00033ae0: 6420 7374 6174 7573 2066 6c61 6773 2e20 d status flags. │ │ │ │ │ +00033af0: 2054 6865 7365 206f 7074 696f 6e73 2074 These options t │ │ │ │ │ +00033b00: 616b 6520 616e 0a20 2020 2020 276f 6e27 ake an. 'on' │ │ │ │ │ +00033b10: 206f 7220 276f 6666 2720 7061 7261 6d65 or 'off' parame │ │ │ │ │ +00033b20: 7465 722c 2073 7065 6369 6679 696e 6720 ter, specifying │ │ │ │ │ +00033b30: 7468 6174 2074 6865 2063 6f72 7265 7370 that the corresp │ │ │ │ │ +00033b40: 6f6e 6469 6e67 2073 7461 7475 730a 2020 onding status. │ │ │ │ │ +00033b50: 2020 2066 6c61 6720 6265 2073 6574 206f flag be set o │ │ │ │ │ +00033b60: 7220 756e 7365 743b 206f 6d69 7474 696e r unset; omittin │ │ │ │ │ +00033b70: 6720 7468 6520 6f70 7469 6f6e 2066 6f72 g the option for │ │ │ │ │ +00033b80: 2061 2067 6976 656e 2073 7461 7475 7320 a given status │ │ │ │ │ +00033b90: 666c 6167 0a20 2020 2020 7769 6c6c 206c flag. will l │ │ │ │ │ +00033ba0: 6561 7665 2074 6861 7420 666c 6167 2061 eave that flag a │ │ │ │ │ +00033bb0: 7420 6974 7320 696e 6974 6961 6c20 7374 t its initial st │ │ │ │ │ +00033bc0: 6174 6520 6174 2062 6f6f 742e 2020 5468 ate at boot. Th │ │ │ │ │ +00033bd0: 6520 272d 2d6e 756d 272c 0a20 2020 2020 e '--num',. │ │ │ │ │ +00033be0: 272d 2d63 6170 7327 2c20 272d 2d73 6372 '--caps', '--scr │ │ │ │ │ +00033bf0: 6f6c 6c27 2c20 616e 6420 272d 2d69 6e73 oll', and '--ins │ │ │ │ │ +00033c00: 6572 7427 206f 7074 696f 6e73 2065 6d75 ert' options emu │ │ │ │ │ +00033c10: 6c61 7465 2073 6574 7469 6e67 2074 6865 late setting the │ │ │ │ │ +00033c20: 0a20 2020 2020 636f 7272 6573 706f 6e64 . correspond │ │ │ │ │ +00033c30: 696e 6720 6d6f 6465 2c20 7768 696c 6520 ing mode, while │ │ │ │ │ +00033c40: 7468 6520 272d 2d6e 756d 6b65 7927 2c20 the '--numkey', │ │ │ │ │ +00033c50: 272d 2d63 6170 736b 6579 272c 0a20 2020 '--capskey',. │ │ │ │ │ +00033c60: 2020 272d 2d73 6372 6f6c 6c6b 6579 272c '--scrollkey', │ │ │ │ │ +00033c70: 2061 6e64 2027 2d2d 696e 7365 7274 6b65 and '--insertke │ │ │ │ │ +00033c80: 7927 206f 7074 696f 6e73 2065 6d75 6c61 y' options emula │ │ │ │ │ +00033c90: 7465 2070 7265 7373 696e 6720 616e 640a te pressing and. │ │ │ │ │ +00033ca0: 2020 2020 2068 6f6c 6469 6e67 2074 6865 holding the │ │ │ │ │ +00033cb0: 2063 6f72 7265 7370 6f6e 6469 6e67 206b corresponding k │ │ │ │ │ +00033cc0: 6579 2e20 2054 6865 206f 7468 6572 2073 ey. The other s │ │ │ │ │ +00033cd0: 7461 7475 7320 666c 6167 206f 7074 696f tatus flag optio │ │ │ │ │ +00033ce0: 6e73 2061 7265 0a20 2020 2020 7365 6c66 ns are. self │ │ │ │ │ +00033cf0: 2d65 7870 6c61 6e61 746f 7279 2e0a 0a20 -explanatory... │ │ │ │ │ +00033d00: 2020 2020 4966 2074 6865 2027 2d2d 6e6f If the '--no │ │ │ │ │ +00033d10: 2d6c 6564 2720 6f70 7469 6f6e 2069 7320 -led' option is │ │ │ │ │ +00033d20: 6769 7665 6e2c 2074 6865 2073 7461 7475 given, the statu │ │ │ │ │ +00033d30: 7320 666c 6167 206f 7074 696f 6e73 2077 s flag options w │ │ │ │ │ +00033d40: 696c 6c0a 2020 2020 2068 6176 6520 6e6f ill. have no │ │ │ │ │ +00033d50: 2065 6666 6563 7420 6f6e 206b 6579 626f effect on keybo │ │ │ │ │ +00033d60: 6172 6420 4c45 4473 2e0a 0a20 2020 2020 ard LEDs... │ │ │ │ │ +00033d70: 4966 2074 6865 2027 7365 6e64 6b65 7927 If the 'sendkey' │ │ │ │ │ +00033d80: 2063 6f6d 6d61 6e64 2069 7320 6769 7665 command is give │ │ │ │ │ +00033d90: 6e20 6d75 6c74 6970 6c65 2074 696d 6573 n multiple times │ │ │ │ │ +00033da0: 2c20 7468 656e 206f 6e6c 7920 7468 650a , then only the. │ │ │ │ │ +00033db0: 2020 2020 206c 6173 7420 696e 766f 6361 last invoca │ │ │ │ │ +00033dc0: 7469 6f6e 2068 6173 2061 6e79 2065 6666 tion has any eff │ │ │ │ │ +00033dd0: 6563 742e 0a0a 2020 2020 2053 696e 6365 ect... Since │ │ │ │ │ +00033de0: 2027 7365 6e64 6b65 7927 206d 616e 6970 'sendkey' manip │ │ │ │ │ +00033df0: 756c 6174 6573 2074 6865 2042 494f 5320 ulates the BIOS │ │ │ │ │ +00033e00: 6b65 7962 6f61 7264 2062 7566 6665 722c keyboard buffer, │ │ │ │ │ +00033e10: 2069 7420 6d61 7920 6361 7573 650a 2020 it may cause. │ │ │ │ │ +00033e20: 2020 2068 616e 6773 2c20 7265 626f 6f74 hangs, reboot │ │ │ │ │ +00033e30: 732c 206f 7220 6f74 6865 7220 6d69 7362 s, or other misb │ │ │ │ │ +00033e40: 6568 6176 696f 7572 206f 6e20 736f 6d65 ehaviour on some │ │ │ │ │ +00033e50: 2073 7973 7465 6d73 2e20 2049 6620 7468 systems. If th │ │ │ │ │ +00033e60: 650a 2020 2020 206f 7065 7261 7469 6e67 e. operating │ │ │ │ │ +00033e70: 2073 7973 7465 6d20 6f72 2062 6f6f 7420 system or boot │ │ │ │ │ +00033e80: 6c6f 6164 6572 2074 6861 7420 7275 6e73 loader that runs │ │ │ │ │ +00033e90: 2061 6674 6572 2047 5255 4220 7573 6573 after GRUB uses │ │ │ │ │ +00033ea0: 2069 7473 206f 776e 0a20 2020 2020 6b65 its own. ke │ │ │ │ │ +00033eb0: 7962 6f61 7264 2064 7269 7665 7220 7261 yboard driver ra │ │ │ │ │ +00033ec0: 7468 6572 2074 6861 6e20 7468 6520 4249 ther than the BI │ │ │ │ │ +00033ed0: 4f53 206b 6579 626f 6172 6420 6675 6e63 OS keyboard func │ │ │ │ │ +00033ee0: 7469 6f6e 732c 2074 6865 6e0a 2020 2020 tions, then. │ │ │ │ │ +00033ef0: 2027 7365 6e64 6b65 7927 2077 696c 6c20 'sendkey' will │ │ │ │ │ +00033f00: 6861 7665 206e 6f20 6566 6665 6374 2e0a have no effect.. │ │ │ │ │ +00033f10: 0a20 2020 2020 5468 6973 2063 6f6d 6d61 . This comma │ │ │ │ │ +00033f20: 6e64 2069 7320 6f6e 6c79 2061 7661 696c nd is only avail │ │ │ │ │ +00033f30: 6162 6c65 206f 6e20 5043 2042 494f 5320 able on PC BIOS │ │ │ │ │ +00033f40: 7379 7374 656d 732e 0a0a 1f0a 4669 6c65 systems.....File │ │ │ │ │ +00033f50: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00033f60: 6465 3a20 7365 742c 2020 4e65 7874 3a20 de: set, Next: │ │ │ │ │ +00033f70: 7368 6131 7375 6d2c 2020 5072 6576 3a20 sha1sum, Prev: │ │ │ │ │ +00033f80: 7365 6e64 6b65 792c 2020 5570 3a20 436f sendkey, Up: Co │ │ │ │ │ +00033f90: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +00033fa0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +00033fb0: 6473 0a0a 3136 2e33 2e36 3720 7365 740a ds..16.3.67 set. │ │ │ │ │ +00033fc0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +00033fd0: 2043 6f6d 6d61 6e64 3a20 7365 7420 5b65 Command: set [e │ │ │ │ │ +00033fe0: 6e76 7661 723d 7661 6c75 655d 0a20 2020 nvvar=value]. │ │ │ │ │ +00033ff0: 2020 5365 7420 7468 6520 656e 7669 726f Set the enviro │ │ │ │ │ +00034000: 6e6d 656e 7420 7661 7269 6162 6c65 2045 nment variable E │ │ │ │ │ +00034010: 4e56 5641 5220 746f 2056 414c 5545 2e20 NVVAR to VALUE. │ │ │ │ │ +00034020: 2049 6620 696e 766f 6b65 6420 7769 7468 If invoked with │ │ │ │ │ +00034030: 206e 6f0a 2020 2020 2061 7267 756d 656e no. argumen │ │ │ │ │ +00034040: 7473 2c20 7072 696e 7420 616c 6c20 656e ts, print all en │ │ │ │ │ +00034050: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +00034060: 6c65 7320 7769 7468 2074 6865 6972 2076 les with their v │ │ │ │ │ +00034070: 616c 7565 732e 0a0a 1f0a 4669 6c65 3a20 alues.....File: │ │ │ │ │ +00034080: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00034090: 3a20 7368 6131 7375 6d2c 2020 4e65 7874 : sha1sum, Next │ │ │ │ │ +000340a0: 3a20 7368 6132 3536 7375 6d2c 2020 5072 : sha256sum, Pr │ │ │ │ │ +000340b0: 6576 3a20 7365 742c 2020 5570 3a20 436f ev: set, Up: Co │ │ │ │ │ +000340c0: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ +000340d0: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ +000340e0: 6473 0a0a 3136 2e33 2e36 3820 7368 6131 ds..16.3.68 sha1 │ │ │ │ │ +000340f0: 7375 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d sum.------------ │ │ │ │ │ +00034100: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ +00034110: 3a20 7368 6131 7375 6d20 6172 6720 2e2e : sha1sum arg .. │ │ │ │ │ +00034120: 2e0a 2020 2020 2041 6c69 6173 2066 6f72 .. Alias for │ │ │ │ │ +00034130: 2027 6861 7368 7375 6d20 2d2d 6861 7368 'hashsum --hash │ │ │ │ │ +00034140: 2073 6861 3120 6172 6720 2e2e 2e27 2e20 sha1 arg ...'. │ │ │ │ │ +00034150: 2053 6565 2063 6f6d 6d61 6e64 2027 6861 See command 'ha │ │ │ │ │ +00034160: 7368 7375 6d27 0a20 2020 2020 282a 6e6f shsum'. (*no │ │ │ │ │ +00034170: 7465 2068 6173 6873 756d 3a3a 2920 666f te hashsum::) fo │ │ │ │ │ +00034180: 7220 6675 6c6c 2064 6573 6372 6970 7469 r full descripti │ │ │ │ │ +00034190: 6f6e 2e0a 0a1f 0a46 696c 653a 2067 7275 on.....File: gru │ │ │ │ │ +000341a0: 622e 696e 666f 2c20 204e 6f64 653a 2073 b.info, Node: s │ │ │ │ │ +000341b0: 6861 3235 3673 756d 2c20 204e 6578 743a ha256sum, Next: │ │ │ │ │ +000341c0: 2073 6861 3531 3273 756d 2c20 2050 7265 sha512sum, Pre │ │ │ │ │ +000341d0: 763a 2073 6861 3173 756d 2c20 2055 703a v: sha1sum, Up: │ │ │ │ │ +000341e0: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +000341f0: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +00034200: 6d61 6e64 730a 0a31 362e 332e 3639 2073 mands..16.3.69 s │ │ │ │ │ +00034210: 6861 3235 3673 756d 0a2d 2d2d 2d2d 2d2d ha256sum.------- │ │ │ │ │ +00034220: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ +00034230: 436f 6d6d 616e 643a 2073 6861 3235 3673 Command: sha256s │ │ │ │ │ +00034240: 756d 2061 7267 202e 2e2e 0a20 2020 2020 um arg .... │ │ │ │ │ +00034250: 416c 6961 7320 666f 7220 2768 6173 6873 Alias for 'hashs │ │ │ │ │ +00034260: 756d 202d 2d68 6173 6820 7368 6132 3536 um --hash sha256 │ │ │ │ │ +00034270: 2061 7267 202e 2e2e 272e 2020 5365 6520 arg ...'. See │ │ │ │ │ +00034280: 636f 6d6d 616e 6420 2768 6173 6873 756d command 'hashsum │ │ │ │ │ +00034290: 270a 2020 2020 2028 2a6e 6f74 6520 6861 '. (*note ha │ │ │ │ │ +000342a0: 7368 7375 6d3a 3a29 2066 6f72 2066 756c shsum::) for ful │ │ │ │ │ +000342b0: 6c20 6465 7363 7269 7074 696f 6e2e 0a0a l description... │ │ │ │ │ +000342c0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +000342d0: 6f2c 2020 4e6f 6465 3a20 7368 6135 3132 o, Node: sha512 │ │ │ │ │ +000342e0: 7375 6d2c 2020 4e65 7874 3a20 736c 6565 sum, Next: slee │ │ │ │ │ +000342f0: 702c 2020 5072 6576 3a20 7368 6132 3536 p, Prev: sha256 │ │ │ │ │ +00034300: 7375 6d2c 2020 5570 3a20 436f 6d6d 616e sum, Up: Comman │ │ │ │ │ +00034310: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ +00034320: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ │ +00034330: 3136 2e33 2e37 3020 7368 6135 3132 7375 16.3.70 sha512su │ │ │ │ │ +00034340: 6d0a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d m.-------------- │ │ │ │ │ +00034350: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ +00034360: 3a20 7368 6135 3132 7375 6d20 6172 6720 : sha512sum arg │ │ │ │ │ +00034370: 2e2e 2e0a 2020 2020 2041 6c69 6173 2066 .... Alias f │ │ │ │ │ +00034380: 6f72 2027 6861 7368 7375 6d20 2d2d 6861 or 'hashsum --ha │ │ │ │ │ +00034390: 7368 2073 6861 3531 3220 6172 6720 2e2e sh sha512 arg .. │ │ │ │ │ +000343a0: 2e27 2e20 2053 6565 2063 6f6d 6d61 6e64 .'. See command │ │ │ │ │ +000343b0: 2027 6861 7368 7375 6d27 0a20 2020 2020 'hashsum'. │ │ │ │ │ +000343c0: 282a 6e6f 7465 2068 6173 6873 756d 3a3a (*note hashsum:: │ │ │ │ │ +000343d0: 2920 666f 7220 6675 6c6c 2064 6573 6372 ) for full descr │ │ │ │ │ +000343e0: 6970 7469 6f6e 2e0a 0a1f 0a46 696c 653a iption.....File: │ │ │ │ │ +000343f0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00034400: 653a 2073 6c65 6570 2c20 204e 6578 743a e: sleep, Next: │ │ │ │ │ +00034410: 2073 6d62 696f 732c 2020 5072 6576 3a20 smbios, Prev: │ │ │ │ │ +00034420: 7368 6135 3132 7375 6d2c 2020 5570 3a20 sha512sum, Up: │ │ │ │ │ +00034430: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00034440: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00034450: 616e 6473 0a0a 3136 2e33 2e37 3120 736c ands..16.3.71 sl │ │ │ │ │ +00034460: 6565 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d eep.------------ │ │ │ │ │ +00034470: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00034480: 736c 6565 7020 5b2d 2d76 6572 626f 7365 sleep [--verbose │ │ │ │ │ +00034490: 5d20 5b2d 2d69 6e74 6572 7275 7074 6962 ] [--interruptib │ │ │ │ │ +000344a0: 6c65 5d20 636f 756e 740a 2020 2020 2053 le] count. S │ │ │ │ │ +000344b0: 6c65 6570 2066 6f72 2043 4f55 4e54 2073 leep for COUNT s │ │ │ │ │ +000344c0: 6563 6f6e 6473 2e20 2049 6620 6f70 7469 econds. If opti │ │ │ │ │ +000344d0: 6f6e 2027 2d2d 696e 7465 7272 7570 7469 on '--interrupti │ │ │ │ │ +000344e0: 626c 6527 2069 7320 6769 7665 6e2c 0a20 ble' is given,. │ │ │ │ │ +000344f0: 2020 2020 616c 6c6f 7720 7072 6573 7369 allow pressi │ │ │ │ │ +00034500: 6e67 203c 4553 433e 2c20 3c46 343e 206f ng , o │ │ │ │ │ +00034510: 7220 686f 6c64 696e 6720 646f 776e 203c r holding down < │ │ │ │ │ +00034520: 5348 4946 543e 2074 6f20 696e 7465 7272 SHIFT> to interr │ │ │ │ │ +00034530: 7570 740a 2020 2020 2073 6c65 6570 2e20 upt. sleep. │ │ │ │ │ +00034540: 2057 6974 6820 272d 2d76 6572 626f 7365 With '--verbose │ │ │ │ │ +00034550: 2720 7368 6f77 2063 6f75 6e74 646f 776e ' show countdown │ │ │ │ │ +00034560: 206f 6620 7265 6d61 696e 696e 6720 7365 of remaining se │ │ │ │ │ +00034570: 636f 6e64 732e 2020 4578 6974 0a20 2020 conds. Exit. │ │ │ │ │ +00034580: 2020 636f 6465 2069 7320 7365 7420 746f code is set to │ │ │ │ │ +00034590: 2030 2069 6620 7469 6d65 6f75 7420 6578 0 if timeout ex │ │ │ │ │ +000345a0: 7069 7265 6420 616e 6420 746f 2031 2069 pired and to 1 i │ │ │ │ │ +000345b0: 6620 7469 6d65 6f75 7420 7761 730a 2020 f timeout was. │ │ │ │ │ +000345c0: 2020 2069 6e74 6572 7275 7074 6564 2075 interrupted u │ │ │ │ │ +000345d0: 7369 6e67 2061 6e79 206f 6620 7468 6520 sing any of the │ │ │ │ │ +000345e0: 6d65 6e74 696f 6e65 6420 6b65 7973 2e0a mentioned keys.. │ │ │ │ │ +000345f0: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00034600: 666f 2c20 204e 6f64 653a 2073 6d62 696f fo, Node: smbio │ │ │ │ │ +00034610: 732c 2020 4e65 7874 3a20 736f 7572 6365 s, Next: source │ │ │ │ │ +00034620: 2c20 2050 7265 763a 2073 6c65 6570 2c20 , Prev: sleep, │ │ │ │ │ +00034630: 2055 703a 2043 6f6d 6d61 6e64 2d6c 696e Up: Command-lin │ │ │ │ │ +00034640: 6520 616e 6420 6d65 6e75 2065 6e74 7279 e and menu entry │ │ │ │ │ +00034650: 2063 6f6d 6d61 6e64 730a 0a31 362e 332e commands..16.3. │ │ │ │ │ +00034660: 3732 2073 6d62 696f 730a 2d2d 2d2d 2d2d 72 smbios.------ │ │ │ │ │ +00034670: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +00034680: 6d6d 616e 643a 2073 6d62 696f 7320 5b2d mmand: smbios [- │ │ │ │ │ +00034690: 2d74 7970 6520 5459 5045 5d20 5b2d 2d68 -type TYPE] [--h │ │ │ │ │ +000346a0: 616e 646c 6520 4841 4e44 4c45 5d20 5b2d andle HANDLE] [- │ │ │ │ │ +000346b0: 2d6d 6174 6368 204d 4154 4348 5d0a 2020 -match MATCH]. │ │ │ │ │ +000346c0: 2020 2020 2020 2020 282d 2d67 6574 2d62 (--get-b │ │ │ │ │ +000346d0: 7974 6520 7c20 2d2d 6765 742d 776f 7264 yte | --get-word │ │ │ │ │ +000346e0: 207c 202d 2d67 6574 2d64 776f 7264 207c | --get-dword | │ │ │ │ │ +000346f0: 202d 2d67 6574 2d71 776f 7264 207c 0a20 --get-qword |. │ │ │ │ │ +00034700: 2020 2020 2020 2020 202d 2d67 6574 2d73 --get-s │ │ │ │ │ +00034710: 7472 696e 6720 7c20 2d2d 6765 742d 7575 tring | --get-uu │ │ │ │ │ +00034720: 6964 2920 4f46 4653 4554 205b 2d2d 7365 id) OFFSET [--se │ │ │ │ │ +00034730: 7420 5641 5249 4142 4c45 5d0a 2020 2020 t VARIABLE]. │ │ │ │ │ +00034740: 2052 6574 7269 6576 6520 534d 4249 4f53 Retrieve SMBIOS │ │ │ │ │ +00034750: 2069 6e66 6f72 6d61 7469 6f6e 2e0a 0a20 information... │ │ │ │ │ +00034760: 2020 2020 5468 6520 2773 6d62 696f 7327 The 'smbios' │ │ │ │ │ +00034770: 2063 6f6d 6d61 6e64 2072 6574 7572 6e73 command returns │ │ │ │ │ +00034780: 2074 6865 2076 616c 7565 206f 6620 6120 the value of a │ │ │ │ │ +00034790: 6669 656c 6420 696e 2061 6e20 534d 4249 field in an SMBI │ │ │ │ │ +000347a0: 4f53 0a20 2020 2020 7374 7275 6374 7572 OS. structur │ │ │ │ │ +000347b0: 652e 2020 5468 6520 666f 6c6c 6f77 696e e. The followin │ │ │ │ │ +000347c0: 6720 6f70 7469 6f6e 7320 6465 7465 726d g options determ │ │ │ │ │ +000347d0: 696e 6520 7768 6963 6820 7374 7275 6374 ine which struct │ │ │ │ │ +000347e0: 7572 6520 746f 0a20 2020 2020 7365 6c65 ure to. sele │ │ │ │ │ +000347f0: 6374 2e0a 0a20 2020 2020 2020 202a 2053 ct... * S │ │ │ │ │ +00034800: 7065 6369 6679 696e 6720 272d 2d74 7970 pecifying '--typ │ │ │ │ │ +00034810: 6527 2077 696c 6c20 7365 6c65 6374 2073 e' will select s │ │ │ │ │ +00034820: 7472 7563 7475 7265 7320 7769 7468 2061 tructures with a │ │ │ │ │ +00034830: 206d 6174 6368 696e 670a 2020 2020 2020 matching. │ │ │ │ │ +00034840: 2020 2020 5459 5045 2e20 2054 6865 2074 TYPE. The t │ │ │ │ │ +00034850: 7970 6520 6361 6e20 6265 2061 6e79 2069 ype can be any i │ │ │ │ │ +00034860: 6e74 6567 6572 2066 726f 6d20 3020 746f nteger from 0 to │ │ │ │ │ +00034870: 2032 3535 2e0a 2020 2020 2020 2020 2a20 255.. * │ │ │ │ │ +00034880: 5370 6563 6966 7969 6e67 2027 2d2d 6861 Specifying '--ha │ │ │ │ │ +00034890: 6e64 6c65 2720 7769 6c6c 2073 656c 6563 ndle' will selec │ │ │ │ │ +000348a0: 7420 7374 7275 6374 7572 6573 2077 6974 t structures wit │ │ │ │ │ +000348b0: 6820 6120 6d61 7463 6869 6e67 0a20 2020 h a matching. │ │ │ │ │ +000348c0: 2020 2020 2020 2048 414e 444c 452e 2020 HANDLE. │ │ │ │ │ +000348d0: 5468 6520 6861 6e64 6c65 2063 616e 2062 The handle can b │ │ │ │ │ +000348e0: 6520 616e 7920 696e 7465 6765 7220 6672 e any integer fr │ │ │ │ │ +000348f0: 6f6d 2030 2074 6f20 3635 3533 352e 0a20 om 0 to 65535.. │ │ │ │ │ +00034900: 2020 2020 2020 202a 2053 7065 6369 6679 * Specify │ │ │ │ │ +00034910: 696e 6720 272d 2d6d 6174 6368 2720 7769 ing '--match' wi │ │ │ │ │ +00034920: 6c6c 2073 656c 6563 7420 7374 7275 6374 ll select struct │ │ │ │ │ +00034930: 7572 6520 6e75 6d62 6572 204d 4154 4348 ure number MATCH │ │ │ │ │ +00034940: 2069 6e20 7468 650a 2020 2020 2020 2020 in the. │ │ │ │ │ +00034950: 2020 6669 6c74 6572 6564 206c 6973 7420 filtered list │ │ │ │ │ +00034960: 6f66 2073 7472 7563 7475 7265 733b 2065 of structures; e │ │ │ │ │ +00034970: 2e67 2e20 2027 736d 6269 6f73 202d 2d74 .g. 'smbios --t │ │ │ │ │ +00034980: 7970 6520 3420 2d2d 6d61 7463 6820 3227 ype 4 --match 2' │ │ │ │ │ +00034990: 0a20 2020 2020 2020 2020 2077 696c 6c20 . will │ │ │ │ │ +000349a0: 7365 6c65 6374 2074 6865 2073 6563 6f6e select the secon │ │ │ │ │ +000349b0: 6420 5072 6f63 6573 7320 496e 666f 726d d Process Inform │ │ │ │ │ +000349c0: 6174 696f 6e20 2854 7970 6520 3429 2073 ation (Type 4) s │ │ │ │ │ +000349d0: 7472 7563 7475 7265 2e0a 2020 2020 2020 tructure.. │ │ │ │ │ +000349e0: 2020 2020 5468 6520 6c69 7374 2069 7320 The list is │ │ │ │ │ +000349f0: 616c 7761 7973 206f 7264 6572 6564 2074 always ordered t │ │ │ │ │ +00034a00: 6865 2073 616d 6520 6173 2074 6865 2068 he same as the h │ │ │ │ │ +00034a10: 6172 6477 6172 6527 7320 534d 4249 4f53 ardware's SMBIOS │ │ │ │ │ +00034a20: 0a20 2020 2020 2020 2020 2074 6162 6c65 . table │ │ │ │ │ +00034a30: 2e20 2054 6865 206d 6174 6368 206e 756d . The match num │ │ │ │ │ +00034a40: 6265 7220 6d75 7374 2062 6520 6120 706f ber must be a po │ │ │ │ │ +00034a50: 7369 7469 7665 2069 6e74 6567 6572 2e20 sitive integer. │ │ │ │ │ +00034a60: 2049 660a 2020 2020 2020 2020 2020 756e If. un │ │ │ │ │ +00034a70: 7370 6563 6966 6965 642c 2074 6865 2066 specified, the f │ │ │ │ │ +00034a80: 6972 7374 206d 6174 6368 696e 6720 7374 irst matching st │ │ │ │ │ +00034a90: 7275 6374 7572 6520 7769 6c6c 2062 6520 ructure will be │ │ │ │ │ +00034aa0: 7365 6c65 6374 6564 2e0a 0a20 2020 2020 selected... │ │ │ │ │ +00034ab0: 5468 6520 7265 6d61 696e 696e 6720 6f70 The remaining op │ │ │ │ │ +00034ac0: 7469 6f6e 7320 6465 7465 726d 696e 6520 tions determine │ │ │ │ │ +00034ad0: 7768 6963 6820 6669 656c 6420 696e 2074 which field in t │ │ │ │ │ +00034ae0: 6865 2073 656c 6563 7465 6420 534d 4249 he selected SMBI │ │ │ │ │ +00034af0: 4f53 0a20 2020 2020 7374 7275 6374 7572 OS. structur │ │ │ │ │ +00034b00: 6520 746f 2072 6574 7572 6e2e 2020 4f6e e to return. On │ │ │ │ │ +00034b10: 6c79 206f 6e65 206f 6620 7468 6573 6520 ly one of these │ │ │ │ │ +00034b20: 6f70 7469 6f6e 7320 6d61 7920 6265 2073 options may be s │ │ │ │ │ +00034b30: 7065 6369 6669 6564 2061 740a 2020 2020 pecified at. │ │ │ │ │ +00034b40: 2061 2074 696d 652e 0a0a 2020 2020 2020 a time... │ │ │ │ │ +00034b50: 2020 2a20 5768 656e 2067 6976 656e 2027 * When given ' │ │ │ │ │ +00034b60: 2d2d 6765 742d 6279 7465 272c 2072 6574 --get-byte', ret │ │ │ │ │ +00034b70: 7572 6e20 7468 6520 7661 6c75 6520 6f66 urn the value of │ │ │ │ │ +00034b80: 2074 6865 2062 7974 6520 6174 0a20 2020 the byte at. │ │ │ │ │ +00034b90: 2020 2020 2020 204f 4646 5345 5420 6279 OFFSET by │ │ │ │ │ +00034ba0: 7465 7320 696e 746f 2074 6865 2073 656c tes into the sel │ │ │ │ │ +00034bb0: 6563 7465 6420 534d 4249 4f53 2073 7472 ected SMBIOS str │ │ │ │ │ +00034bc0: 7563 7475 7265 2e20 2049 7420 7769 6c6c ucture. It will │ │ │ │ │ +00034bd0: 2062 650a 2020 2020 2020 2020 2020 666f be. fo │ │ │ │ │ +00034be0: 726d 6174 7465 6420 6173 2061 6e20 756e rmatted as an un │ │ │ │ │ +00034bf0: 7369 676e 6564 2064 6563 696d 616c 2069 signed decimal i │ │ │ │ │ +00034c00: 6e74 6567 6572 2e0a 2020 2020 2020 2020 nteger.. │ │ │ │ │ +00034c10: 2a20 5768 656e 2067 6976 656e 2027 2d2d * When given '-- │ │ │ │ │ +00034c20: 6765 742d 776f 7264 272c 2072 6574 7572 get-word', retur │ │ │ │ │ +00034c30: 6e20 7468 6520 7661 6c75 6520 6f66 2074 n the value of t │ │ │ │ │ +00034c40: 6865 2077 6f72 6420 2874 776f 0a20 2020 he word (two. │ │ │ │ │ +00034c50: 2020 2020 2020 2062 7974 6573 2920 6174 bytes) at │ │ │ │ │ +00034c60: 204f 4646 5345 5420 6279 7465 7320 696e OFFSET bytes in │ │ │ │ │ +00034c70: 746f 2074 6865 2073 656c 6563 7465 6420 to the selected │ │ │ │ │ +00034c80: 534d 4249 4f53 2073 7472 7563 7475 7265 SMBIOS structure │ │ │ │ │ +00034c90: 2e20 2049 740a 2020 2020 2020 2020 2020 . It. │ │ │ │ │ +00034ca0: 7769 6c6c 2062 6520 666f 726d 6174 7465 will be formatte │ │ │ │ │ +00034cb0: 6420 6173 2061 6e20 756e 7369 676e 6564 d as an unsigned │ │ │ │ │ +00034cc0: 2064 6563 696d 616c 2069 6e74 6567 6572 decimal integer │ │ │ │ │ +00034cd0: 2e0a 2020 2020 2020 2020 2a20 5768 656e .. * When │ │ │ │ │ +00034ce0: 2067 6976 656e 2027 2d2d 6765 742d 6477 given '--get-dw │ │ │ │ │ +00034cf0: 6f72 6427 2c20 7265 7475 726e 2074 6865 ord', return the │ │ │ │ │ +00034d00: 2076 616c 7565 206f 6620 7468 6520 6477 value of the dw │ │ │ │ │ +00034d10: 6f72 6420 2866 6f75 720a 2020 2020 2020 ord (four. │ │ │ │ │ +00034d20: 2020 2020 6279 7465 7329 2061 7420 4f46 bytes) at OF │ │ │ │ │ +00034d30: 4653 4554 2062 7974 6573 2069 6e74 6f20 FSET bytes into │ │ │ │ │ +00034d40: 7468 6520 7365 6c65 6374 6564 2053 4d42 the selected SMB │ │ │ │ │ +00034d50: 494f 5320 7374 7275 6374 7572 652e 2020 IOS structure. │ │ │ │ │ +00034d60: 4974 0a20 2020 2020 2020 2020 2077 696c It. wil │ │ │ │ │ +00034d70: 6c20 6265 2066 6f72 6d61 7474 6564 2061 l be formatted a │ │ │ │ │ +00034d80: 7320 616e 2075 6e73 6967 6e65 6420 6465 s an unsigned de │ │ │ │ │ +00034d90: 6369 6d61 6c20 696e 7465 6765 722e 0a20 cimal integer.. │ │ │ │ │ +00034da0: 2020 2020 2020 202a 2057 6865 6e20 6769 * When gi │ │ │ │ │ +00034db0: 7665 6e20 272d 2d67 6574 2d71 776f 7264 ven '--get-qword │ │ │ │ │ +00034dc0: 272c 2072 6574 7572 6e20 7468 6520 7661 ', return the va │ │ │ │ │ +00034dd0: 6c75 6520 6f66 2074 6865 2071 776f 7264 lue of the qword │ │ │ │ │ +00034de0: 2028 6569 6768 740a 2020 2020 2020 2020 (eight. │ │ │ │ │ +00034df0: 2020 6279 7465 7329 2061 7420 4f46 4653 bytes) at OFFS │ │ │ │ │ +00034e00: 4554 2062 7974 6573 2069 6e74 6f20 7468 ET bytes into th │ │ │ │ │ +00034e10: 6520 7365 6c65 6374 6564 2053 4d42 494f e selected SMBIO │ │ │ │ │ +00034e20: 5320 7374 7275 6374 7572 652e 2020 4974 S structure. It │ │ │ │ │ +00034e30: 0a20 2020 2020 2020 2020 2077 696c 6c20 . will │ │ │ │ │ +00034e40: 6265 2066 6f72 6d61 7474 6564 2061 7320 be formatted as │ │ │ │ │ +00034e50: 616e 2075 6e73 6967 6e65 6420 6465 6369 an unsigned deci │ │ │ │ │ +00034e60: 6d61 6c20 696e 7465 6765 722e 0a20 2020 mal integer.. │ │ │ │ │ +00034e70: 2020 2020 202a 2057 6865 6e20 6769 7665 * When give │ │ │ │ │ +00034e80: 6e20 272d 2d67 6574 2d73 7472 696e 6727 n '--get-string' │ │ │ │ │ +00034e90: 2c20 7265 7475 726e 2074 6865 2073 7472 , return the str │ │ │ │ │ +00034ea0: 696e 6720 7769 7468 2069 7473 2069 6e64 ing with its ind │ │ │ │ │ +00034eb0: 6578 0a20 2020 2020 2020 2020 2066 6f75 ex. fou │ │ │ │ │ +00034ec0: 6e64 2061 7420 4f46 4653 4554 2062 7974 nd at OFFSET byt │ │ │ │ │ +00034ed0: 6573 2069 6e74 6f20 7468 6520 7365 6c65 es into the sele │ │ │ │ │ +00034ee0: 6374 6564 2053 4d42 494f 5320 7374 7275 cted SMBIOS stru │ │ │ │ │ +00034ef0: 6374 7572 652e 0a20 2020 2020 2020 202a cture.. * │ │ │ │ │ +00034f00: 2057 6865 6e20 6769 7665 6e20 272d 2d67 When given '--g │ │ │ │ │ +00034f10: 6574 2d75 7569 6427 2c20 7265 7475 726e et-uuid', return │ │ │ │ │ +00034f20: 2074 6865 2076 616c 7565 206f 6620 7468 the value of th │ │ │ │ │ +00034f30: 6520 5555 4944 2028 7369 7874 6565 6e0a e UUID (sixteen. │ │ │ │ │ +00034f40: 2020 2020 2020 2020 2020 6279 7465 7329 bytes) │ │ │ │ │ +00034f50: 2061 7420 4f46 4653 4554 2062 7974 6573 at OFFSET bytes │ │ │ │ │ +00034f60: 2069 6e74 6f20 7468 6520 7365 6c65 6374 into the select │ │ │ │ │ +00034f70: 6564 2053 4d42 494f 5320 7374 7275 6374 ed SMBIOS struct │ │ │ │ │ +00034f80: 7572 652e 2020 4974 0a20 2020 2020 2020 ure. It. │ │ │ │ │ +00034f90: 2020 2077 696c 6c20 6265 2066 6f72 6d61 will be forma │ │ │ │ │ +00034fa0: 7474 6564 2061 7320 6c6f 7765 722d 6361 tted as lower-ca │ │ │ │ │ +00034fb0: 7365 2068 7970 6865 6e61 7465 6420 6865 se hyphenated he │ │ │ │ │ +00034fc0: 7861 6465 6369 6d61 6c20 6469 6769 7473 xadecimal digits │ │ │ │ │ +00034fd0: 2c0a 2020 2020 2020 2020 2020 7769 7468 ,. with │ │ │ │ │ +00034fe0: 2074 6865 2066 6972 7374 2074 6872 6565 the first three │ │ │ │ │ +00034ff0: 2066 6965 6c64 7320 6173 206c 6974 746c fields as littl │ │ │ │ │ +00035000: 652d 656e 6469 616e 2c20 616e 6420 7468 e-endian, and th │ │ │ │ │ +00035010: 6520 7265 7374 0a20 2020 2020 2020 2020 e rest. │ │ │ │ │ +00035020: 2070 7269 6e74 6564 2062 7974 652d 6279 printed byte-by │ │ │ │ │ +00035030: 2d62 7974 652e 0a0a 2020 2020 2054 6865 -byte... The │ │ │ │ │ +00035040: 2064 6566 6175 6c74 2061 6374 696f 6e20 default action │ │ │ │ │ +00035050: 6973 2074 6f20 7072 696e 7420 7468 6520 is to print the │ │ │ │ │ +00035060: 7661 6c75 6520 6f66 2074 6865 2072 6571 value of the req │ │ │ │ │ +00035070: 7565 7374 6564 2066 6965 6c64 2074 6f0a uested field to. │ │ │ │ │ +00035080: 2020 2020 2074 6865 2063 6f6e 736f 6c65 the console │ │ │ │ │ +00035090: 2c20 6275 7420 6120 7661 7269 6162 6c65 , but a variable │ │ │ │ │ +000350a0: 206e 616d 6520 6361 6e20 6265 2073 7065 name can be spe │ │ │ │ │ +000350b0: 6369 6669 6564 2077 6974 6820 272d 2d73 cified with '--s │ │ │ │ │ +000350c0: 6574 2720 746f 0a20 2020 2020 7374 6f72 et' to. stor │ │ │ │ │ +000350d0: 6520 7468 6520 7661 6c75 6520 696e 7374 e the value inst │ │ │ │ │ +000350e0: 6561 6420 6f66 2070 7269 6e74 696e 6720 ead of printing │ │ │ │ │ +000350f0: 6974 2e0a 0a20 2020 2020 466f 7220 6578 it... For ex │ │ │ │ │ +00035100: 616d 706c 652c 2074 6869 7320 7769 6c6c ample, this will │ │ │ │ │ +00035110: 2073 746f 7265 2061 6e64 2074 6865 6e20 store and then │ │ │ │ │ +00035120: 6469 7370 6c61 7920 7468 6520 7379 7374 display the syst │ │ │ │ │ +00035130: 656d 0a20 2020 2020 6d61 6e75 6661 6374 em. manufact │ │ │ │ │ +00035140: 7572 6572 2773 206e 616d 652e 0a0a 2020 urer's name... │ │ │ │ │ +00035150: 2020 2020 2020 2020 736d 6269 6f73 202d smbios - │ │ │ │ │ +00035160: 2d74 7970 6520 3120 2d2d 6765 742d 7374 -type 1 --get-st │ │ │ │ │ +00035170: 7269 6e67 2034 202d 2d73 6574 2073 7973 ring 4 --set sys │ │ │ │ │ +00035180: 7465 6d5f 6d61 6e75 6661 6374 7572 6572 tem_manufacturer │ │ │ │ │ +00035190: 0a20 2020 2020 2020 2020 2065 6368 6f20 . echo │ │ │ │ │ +000351a0: 2473 7973 7465 6d5f 6d61 6e75 6661 6374 $system_manufact │ │ │ │ │ +000351b0: 7572 6572 0a0a 1f0a 4669 6c65 3a20 6772 urer....File: gr │ │ │ │ │ +000351c0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +000351d0: 736f 7572 6365 2c20 204e 6578 743a 2074 source, Next: t │ │ │ │ │ +000351e0: 6573 742c 2020 5072 6576 3a20 736d 6269 est, Prev: smbi │ │ │ │ │ +000351f0: 6f73 2c20 2055 703a 2043 6f6d 6d61 6e64 os, Up: Command │ │ │ │ │ +00035200: 2d6c 696e 6520 616e 6420 6d65 6e75 2065 -line and menu e │ │ │ │ │ +00035210: 6e74 7279 2063 6f6d 6d61 6e64 730a 0a31 ntry commands..1 │ │ │ │ │ +00035220: 362e 332e 3733 2073 6f75 7263 650a 2d2d 6.3.73 source.-- │ │ │ │ │ +00035230: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ +00035240: 2d20 436f 6d6d 616e 643a 2073 6f75 7263 - Command: sourc │ │ │ │ │ +00035250: 6520 6669 6c65 0a20 2020 2020 5265 6164 e file. Read │ │ │ │ │ +00035260: 2046 494c 4520 6173 2061 2063 6f6e 6669 FILE as a confi │ │ │ │ │ +00035270: 6775 7261 7469 6f6e 2066 696c 652c 2061 guration file, a │ │ │ │ │ +00035280: 7320 6966 2069 7473 2063 6f6e 7465 6e74 s if its content │ │ │ │ │ +00035290: 7320 6861 6420 6265 656e 0a20 2020 2020 s had been. │ │ │ │ │ +000352a0: 696e 636f 7270 6f72 6174 6564 2064 6972 incorporated dir │ │ │ │ │ +000352b0: 6563 746c 7920 696e 746f 2074 6865 2073 ectly into the s │ │ │ │ │ +000352c0: 6f75 7263 696e 6720 6669 6c65 2e20 2055 ourcing file. U │ │ │ │ │ +000352d0: 6e6c 696b 6520 2763 6f6e 6669 6766 696c nlike 'configfil │ │ │ │ │ +000352e0: 6527 0a20 2020 2020 282a 6e6f 7465 2063 e'. (*note c │ │ │ │ │ +000352f0: 6f6e 6669 6766 696c 653a 3a29 2c20 7468 onfigfile::), th │ │ │ │ │ +00035300: 6973 2065 7865 6375 7465 7320 7468 6520 is executes the │ │ │ │ │ +00035310: 636f 6e74 656e 7473 206f 6620 4649 4c45 contents of FILE │ │ │ │ │ +00035320: 2077 6974 686f 7574 0a20 2020 2020 6368 without. ch │ │ │ │ │ +00035330: 616e 6769 6e67 2063 6f6e 7465 7874 3a20 anging context: │ │ │ │ │ +00035340: 616e 7920 656e 7669 726f 6e6d 656e 7420 any environment │ │ │ │ │ +00035350: 7661 7269 6162 6c65 2063 6861 6e67 6573 variable changes │ │ │ │ │ +00035360: 206d 6164 6520 6279 2074 6865 0a20 2020 made by the. │ │ │ │ │ +00035370: 2020 636f 6d6d 616e 6473 2069 6e20 4649 commands in FI │ │ │ │ │ +00035380: 4c45 2077 696c 6c20 6265 2070 7265 7365 LE will be prese │ │ │ │ │ +00035390: 7276 6564 2061 6674 6572 2027 736f 7572 rved after 'sour │ │ │ │ │ +000353a0: 6365 2720 7265 7475 726e 732c 2061 6e64 ce' returns, and │ │ │ │ │ +000353b0: 2074 6865 0a20 2020 2020 6d65 6e75 2077 the. menu w │ │ │ │ │ +000353c0: 696c 6c20 6e6f 7420 6265 2073 686f 776e ill not be shown │ │ │ │ │ +000353d0: 2069 6d6d 6564 6961 7465 6c79 2e0a 0a1f immediately.... │ │ │ │ │ +000353e0: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ +000353f0: 2c20 204e 6f64 653a 2074 6573 742c 2020 , Node: test, │ │ │ │ │ +00035400: 4e65 7874 3a20 7472 7565 2c20 2050 7265 Next: true, Pre │ │ │ │ │ +00035410: 763a 2073 6f75 7263 652c 2020 5570 3a20 v: source, Up: │ │ │ │ │ +00035420: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00035430: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00035440: 616e 6473 0a0a 3136 2e33 2e37 3420 7465 ands..16.3.74 te │ │ │ │ │ +00035450: 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a st.------------. │ │ │ │ │ +00035460: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7465 . -- Command: te │ │ │ │ │ +00035470: 7374 2065 7870 7265 7373 696f 6e0a 2020 st expression. │ │ │ │ │ +00035480: 2020 2045 7661 6c75 6174 6520 4558 5052 Evaluate EXPR │ │ │ │ │ +00035490: 4553 5349 4f4e 2061 6e64 2072 6574 7572 ESSION and retur │ │ │ │ │ +000354a0: 6e20 7a65 726f 2065 7869 7420 7374 6174 n zero exit stat │ │ │ │ │ +000354b0: 7573 2069 6620 7265 7375 6c74 2069 7320 us if result is │ │ │ │ │ +000354c0: 7472 7565 2c0a 2020 2020 206e 6f6e 207a true,. non z │ │ │ │ │ +000354d0: 6572 6f20 7374 6174 7573 206f 7468 6572 ero status other │ │ │ │ │ +000354e0: 7769 7365 2e0a 0a20 2020 2020 4558 5052 wise... EXPR │ │ │ │ │ +000354f0: 4553 5349 4f4e 2069 7320 6f6e 6520 6f66 ESSION is one of │ │ │ │ │ +00035500: 3a0a 0a20 2020 2020 5354 5249 4e47 3120 :.. STRING1 │ │ │ │ │ +00035510: 273d 3d27 2053 5452 494e 4732 0a20 2020 '==' STRING2. │ │ │ │ │ +00035520: 2020 2020 2020 2074 6865 2073 7472 696e the strin │ │ │ │ │ +00035530: 6773 2061 7265 2065 7175 616c 0a20 2020 gs are equal. │ │ │ │ │ +00035540: 2020 5354 5249 4e47 3120 2721 3d27 2053 STRING1 '!=' S │ │ │ │ │ +00035550: 5452 494e 4732 0a20 2020 2020 2020 2020 TRING2. │ │ │ │ │ +00035560: 2074 6865 2073 7472 696e 6773 2061 7265 the strings are │ │ │ │ │ +00035570: 206e 6f74 2065 7175 616c 0a20 2020 2020 not equal. │ │ │ │ │ +00035580: 5354 5249 4e47 3120 273c 2720 5354 5249 STRING1 '<' STRI │ │ │ │ │ +00035590: 4e47 320a 2020 2020 2020 2020 2020 5354 NG2. ST │ │ │ │ │ +000355a0: 5249 4e47 3120 6973 206c 6578 6963 6f67 RING1 is lexicog │ │ │ │ │ +000355b0: 7261 7068 6963 616c 6c79 206c 6573 7320 raphically less │ │ │ │ │ +000355c0: 7468 616e 2053 5452 494e 4732 0a20 2020 than STRING2. │ │ │ │ │ +000355d0: 2020 5354 5249 4e47 3120 273c 3d27 2053 STRING1 '<=' S │ │ │ │ │ +000355e0: 5452 494e 4732 0a20 2020 2020 2020 2020 TRING2. │ │ │ │ │ +000355f0: 2053 5452 494e 4731 2069 7320 6c65 7869 STRING1 is lexi │ │ │ │ │ +00035600: 636f 6772 6170 6869 6361 6c6c 7920 6c65 cographically le │ │ │ │ │ +00035610: 7373 206f 7220 6571 7561 6c20 7468 616e ss or equal than │ │ │ │ │ +00035620: 2053 5452 494e 4732 0a20 2020 2020 5354 STRING2. ST │ │ │ │ │ +00035630: 5249 4e47 3120 273e 2720 5354 5249 4e47 RING1 '>' STRING │ │ │ │ │ +00035640: 320a 2020 2020 2020 2020 2020 5354 5249 2. STRI │ │ │ │ │ +00035650: 4e47 3120 6973 206c 6578 6963 6f67 7261 NG1 is lexicogra │ │ │ │ │ +00035660: 7068 6963 616c 6c79 2067 7265 6174 6572 phically greater │ │ │ │ │ +00035670: 2074 6861 6e20 5354 5249 4e47 320a 2020 than STRING2. │ │ │ │ │ +00035680: 2020 2053 5452 494e 4731 2027 3e3d 2720 STRING1 '>=' │ │ │ │ │ +00035690: 5354 5249 4e47 320a 2020 2020 2020 2020 STRING2. │ │ │ │ │ +000356a0: 2020 5354 5249 4e47 3120 6973 206c 6578 STRING1 is lex │ │ │ │ │ +000356b0: 6963 6f67 7261 7068 6963 616c 6c79 2067 icographically g │ │ │ │ │ +000356c0: 7265 6174 6572 206f 7220 6571 7561 6c20 reater or equal │ │ │ │ │ +000356d0: 7468 616e 2053 5452 494e 4732 0a20 2020 than STRING2. │ │ │ │ │ +000356e0: 2020 494e 5445 4745 5231 2027 2d65 7127 INTEGER1 '-eq' │ │ │ │ │ +000356f0: 2049 4e54 4547 4552 320a 2020 2020 2020 INTEGER2. │ │ │ │ │ +00035700: 2020 2020 494e 5445 4745 5231 2069 7320 INTEGER1 is │ │ │ │ │ +00035710: 6571 7561 6c20 746f 2049 4e54 4547 4552 equal to INTEGER │ │ │ │ │ +00035720: 320a 2020 2020 2049 4e54 4547 4552 3120 2. INTEGER1 │ │ │ │ │ +00035730: 272d 6765 2720 494e 5445 4745 5232 0a20 '-ge' INTEGER2. │ │ │ │ │ +00035740: 2020 2020 2020 2020 2049 4e54 4547 4552 INTEGER │ │ │ │ │ +00035750: 3120 6973 2067 7265 6174 6572 2074 6861 1 is greater tha │ │ │ │ │ +00035760: 6e20 6f72 2065 7175 616c 2074 6f20 494e n or equal to IN │ │ │ │ │ +00035770: 5445 4745 5232 0a20 2020 2020 494e 5445 TEGER2. INTE │ │ │ │ │ +00035780: 4745 5231 2027 2d67 7427 2049 4e54 4547 GER1 '-gt' INTEG │ │ │ │ │ +00035790: 4552 320a 2020 2020 2020 2020 2020 494e ER2. IN │ │ │ │ │ +000357a0: 5445 4745 5231 2069 7320 6772 6561 7465 TEGER1 is greate │ │ │ │ │ +000357b0: 7220 7468 616e 2049 4e54 4547 4552 320a r than INTEGER2. │ │ │ │ │ +000357c0: 2020 2020 2049 4e54 4547 4552 3120 272d INTEGER1 '- │ │ │ │ │ +000357d0: 6c65 2720 494e 5445 4745 5232 0a20 2020 le' INTEGER2. │ │ │ │ │ +000357e0: 2020 2020 2020 2049 4e54 4547 4552 3120 INTEGER1 │ │ │ │ │ +000357f0: 6973 206c 6573 7320 7468 616e 206f 7220 is less than or │ │ │ │ │ +00035800: 6571 7561 6c20 746f 2049 4e54 4547 4552 equal to INTEGER │ │ │ │ │ +00035810: 320a 2020 2020 2049 4e54 4547 4552 3120 2. INTEGER1 │ │ │ │ │ +00035820: 272d 6c74 2720 494e 5445 4745 5232 0a20 '-lt' INTEGER2. │ │ │ │ │ +00035830: 2020 2020 2020 2020 2049 4e54 4547 4552 INTEGER │ │ │ │ │ +00035840: 3120 6973 206c 6573 7320 7468 616e 2049 1 is less than I │ │ │ │ │ +00035850: 4e54 4547 4552 320a 2020 2020 2049 4e54 NTEGER2. INT │ │ │ │ │ +00035860: 4547 4552 3120 272d 6e65 2720 494e 5445 EGER1 '-ne' INTE │ │ │ │ │ +00035870: 4745 5232 0a20 2020 2020 2020 2020 2049 GER2. I │ │ │ │ │ +00035880: 4e54 4547 4552 3120 6973 206e 6f74 2065 NTEGER1 is not e │ │ │ │ │ +00035890: 7175 616c 2074 6f20 494e 5445 4745 5232 qual to INTEGER2 │ │ │ │ │ +000358a0: 0a20 2020 2020 5052 4546 4958 494e 5445 . PREFIXINTE │ │ │ │ │ +000358b0: 4745 5231 2027 2d70 6774 2720 5052 4546 GER1 '-pgt' PREF │ │ │ │ │ +000358c0: 4958 494e 5445 4745 5232 0a20 2020 2020 IXINTEGER2. │ │ │ │ │ +000358d0: 2020 2020 2049 4e54 4547 4552 3120 6973 INTEGER1 is │ │ │ │ │ +000358e0: 2067 7265 6174 6572 2074 6861 6e20 494e greater than IN │ │ │ │ │ +000358f0: 5445 4745 5232 2061 6674 6572 2073 7472 TEGER2 after str │ │ │ │ │ +00035900: 6970 7069 6e67 206f 6666 2063 6f6d 6d6f ipping off commo │ │ │ │ │ +00035910: 6e0a 2020 2020 2020 2020 2020 6e6f 6e2d n. non- │ │ │ │ │ +00035920: 6e75 6d65 7269 6320 5052 4546 4958 2e0a numeric PREFIX.. │ │ │ │ │ +00035930: 2020 2020 2050 5245 4649 5849 4e54 4547 PREFIXINTEG │ │ │ │ │ +00035940: 4552 3120 272d 706c 7427 2050 5245 4649 ER1 '-plt' PREFI │ │ │ │ │ +00035950: 5849 4e54 4547 4552 320a 2020 2020 2020 XINTEGER2. │ │ │ │ │ +00035960: 2020 2020 494e 5445 4745 5231 2069 7320 INTEGER1 is │ │ │ │ │ +00035970: 6c65 7373 2074 6861 6e20 494e 5445 4745 less than INTEGE │ │ │ │ │ +00035980: 5232 2061 6674 6572 2073 7472 6970 7069 R2 after strippi │ │ │ │ │ +00035990: 6e67 206f 6666 2063 6f6d 6d6f 6e0a 2020 ng off common. │ │ │ │ │ +000359a0: 2020 2020 2020 2020 6e6f 6e2d 6e75 6d65 non-nume │ │ │ │ │ +000359b0: 7269 6320 5052 4546 4958 2e0a 2020 2020 ric PREFIX.. │ │ │ │ │ +000359c0: 2046 494c 4531 2027 2d6e 7427 2046 494c FILE1 '-nt' FIL │ │ │ │ │ +000359d0: 4532 0a20 2020 2020 2020 2020 2046 494c E2. FIL │ │ │ │ │ +000359e0: 4531 2069 7320 6e65 7765 7220 7468 616e E1 is newer than │ │ │ │ │ +000359f0: 2046 494c 4532 2028 6d6f 6469 6669 6361 FILE2 (modifica │ │ │ │ │ +00035a00: 7469 6f6e 2074 696d 6529 2e20 204f 7074 tion time). Opt │ │ │ │ │ +00035a10: 696f 6e61 6c6c 790a 2020 2020 2020 2020 ionally. │ │ │ │ │ +00035a20: 2020 6e75 6d65 7269 6320 4249 4153 206d numeric BIAS m │ │ │ │ │ +00035a30: 6179 2062 6520 6469 7265 6374 6c79 2061 ay be directly a │ │ │ │ │ +00035a40: 7070 656e 6465 6420 746f 2027 2d6e 7427 ppended to '-nt' │ │ │ │ │ +00035a50: 2069 6e20 7768 6963 6820 6361 7365 0a20 in which case. │ │ │ │ │ +00035a60: 2020 2020 2020 2020 2069 7420 6973 2061 it is a │ │ │ │ │ +00035a70: 6464 6564 2074 6f20 7468 6520 6669 7273 dded to the firs │ │ │ │ │ +00035a80: 7420 6669 6c65 206d 6f64 6966 6963 6174 t file modificat │ │ │ │ │ +00035a90: 696f 6e20 7469 6d65 2e0a 2020 2020 2046 ion time.. F │ │ │ │ │ +00035aa0: 494c 4531 2027 2d6f 7427 2046 494c 4532 ILE1 '-ot' FILE2 │ │ │ │ │ +00035ab0: 0a20 2020 2020 2020 2020 2046 494c 4531 . FILE1 │ │ │ │ │ +00035ac0: 2069 7320 6f6c 6465 7220 7468 616e 2046 is older than F │ │ │ │ │ +00035ad0: 494c 4532 2028 6d6f 6469 6669 6361 7469 ILE2 (modificati │ │ │ │ │ +00035ae0: 6f6e 2074 696d 6529 2e20 204f 7074 696f on time). Optio │ │ │ │ │ +00035af0: 6e61 6c6c 790a 2020 2020 2020 2020 2020 nally. │ │ │ │ │ +00035b00: 6e75 6d65 7269 6320 4249 4153 206d 6179 numeric BIAS may │ │ │ │ │ +00035b10: 2062 6520 6469 7265 6374 6c79 2061 7070 be directly app │ │ │ │ │ +00035b20: 656e 6465 6420 746f 2027 2d6f 7427 2069 ended to '-ot' i │ │ │ │ │ +00035b30: 6e20 7768 6963 6820 6361 7365 0a20 2020 n which case. │ │ │ │ │ +00035b40: 2020 2020 2020 2069 7420 6973 2061 6464 it is add │ │ │ │ │ +00035b50: 6564 2074 6f20 7468 6520 6669 7273 7420 ed to the first │ │ │ │ │ +00035b60: 6669 6c65 206d 6f64 6966 6963 6174 696f file modificatio │ │ │ │ │ +00035b70: 6e20 7469 6d65 2e0a 2020 2020 2027 2d64 n time.. '-d │ │ │ │ │ +00035b80: 2720 4649 4c45 0a20 2020 2020 2020 2020 ' FILE. │ │ │ │ │ +00035b90: 2046 494c 4520 6578 6973 7473 2061 6e64 FILE exists and │ │ │ │ │ +00035ba0: 2069 7320 6120 6469 7265 6374 6f72 790a is a directory. │ │ │ │ │ +00035bb0: 2020 2020 2027 2d65 2720 4649 4c45 0a20 '-e' FILE. │ │ │ │ │ +00035bc0: 2020 2020 2020 2020 2046 494c 4520 6578 FILE ex │ │ │ │ │ +00035bd0: 6973 7473 0a20 2020 2020 272d 6627 2046 ists. '-f' F │ │ │ │ │ +00035be0: 494c 450a 2020 2020 2020 2020 2020 4649 ILE. FI │ │ │ │ │ +00035bf0: 4c45 2065 7869 7374 7320 616e 6420 6973 LE exists and is │ │ │ │ │ +00035c00: 206e 6f74 2061 2064 6972 6563 746f 7279 not a directory │ │ │ │ │ +00035c10: 0a20 2020 2020 272d 7327 2046 494c 450a . '-s' FILE. │ │ │ │ │ +00035c20: 2020 2020 2020 2020 2020 4649 4c45 2065 FILE e │ │ │ │ │ +00035c30: 7869 7374 7320 616e 6420 6861 7320 6120 xists and has a │ │ │ │ │ +00035c40: 7369 7a65 2067 7265 6174 6572 2074 6861 size greater tha │ │ │ │ │ +00035c50: 6e20 7a65 726f 0a20 2020 2020 272d 6e27 n zero. '-n' │ │ │ │ │ +00035c60: 2053 5452 494e 470a 2020 2020 2020 2020 STRING. │ │ │ │ │ +00035c70: 2020 7468 6520 6c65 6e67 7468 206f 6620 the length of │ │ │ │ │ +00035c80: 5354 5249 4e47 2069 7320 6e6f 6e7a 6572 STRING is nonzer │ │ │ │ │ +00035c90: 6f0a 2020 2020 2053 5452 494e 470a 2020 o. STRING. │ │ │ │ │ +00035ca0: 2020 2020 2020 2020 5354 5249 4e47 2069 STRING i │ │ │ │ │ +00035cb0: 7320 6571 7569 7661 6c65 6e74 2074 6f20 s equivalent to │ │ │ │ │ +00035cc0: 272d 6e20 5354 5249 4e47 270a 2020 2020 '-n STRING'. │ │ │ │ │ +00035cd0: 2027 2d7a 2720 5354 5249 4e47 0a20 2020 '-z' STRING. │ │ │ │ │ +00035ce0: 2020 2020 2020 2074 6865 206c 656e 6774 the lengt │ │ │ │ │ +00035cf0: 6820 6f66 2053 5452 494e 4720 6973 207a h of STRING is z │ │ │ │ │ +00035d00: 6572 6f0a 2020 2020 2027 2827 2045 5850 ero. '(' EXP │ │ │ │ │ +00035d10: 5245 5353 494f 4e20 2729 270a 2020 2020 RESSION ')'. │ │ │ │ │ +00035d20: 2020 2020 2020 4558 5052 4553 5349 4f4e EXPRESSION │ │ │ │ │ +00035d30: 2069 7320 7472 7565 0a20 2020 2020 2721 is true. '! │ │ │ │ │ +00035d40: 2720 4558 5052 4553 5349 4f4e 0a20 2020 ' EXPRESSION. │ │ │ │ │ +00035d50: 2020 2020 2020 2045 5850 5245 5353 494f EXPRESSIO │ │ │ │ │ +00035d60: 4e20 6973 2066 616c 7365 0a20 2020 2020 N is false. │ │ │ │ │ +00035d70: 4558 5052 4553 5349 4f4e 3120 272d 6127 EXPRESSION1 '-a' │ │ │ │ │ +00035d80: 2045 5850 5245 5353 494f 4e32 0a20 2020 EXPRESSION2. │ │ │ │ │ +00035d90: 2020 2020 2020 2062 6f74 6820 4558 5052 both EXPR │ │ │ │ │ +00035da0: 4553 5349 4f4e 3120 616e 6420 4558 5052 ESSION1 and EXPR │ │ │ │ │ +00035db0: 4553 5349 4f4e 3220 6172 6520 7472 7565 ESSION2 are true │ │ │ │ │ +00035dc0: 0a20 2020 2020 4558 5052 4553 5349 4f4e . EXPRESSION │ │ │ │ │ +00035dd0: 3120 4558 5052 4553 5349 4f4e 320a 2020 1 EXPRESSION2. │ │ │ │ │ +00035de0: 2020 2020 2020 2020 626f 7468 2045 5850 both EXP │ │ │ │ │ +00035df0: 5245 5353 494f 4e31 2061 6e64 2045 5850 RESSION1 and EXP │ │ │ │ │ +00035e00: 5245 5353 494f 4e32 2061 7265 2074 7275 RESSION2 are tru │ │ │ │ │ +00035e10: 652e 2020 5468 6973 2073 796e 7461 7820 e. This syntax │ │ │ │ │ +00035e20: 6973 206e 6f74 0a20 2020 2020 2020 2020 is not. │ │ │ │ │ +00035e30: 2050 4f53 4958 2d63 6f6d 706c 6961 6e74 POSIX-compliant │ │ │ │ │ +00035e40: 2061 6e64 2069 7320 6e6f 7420 7265 636f and is not reco │ │ │ │ │ +00035e50: 6d6d 656e 6465 642e 0a20 2020 2020 4558 mmended.. EX │ │ │ │ │ +00035e60: 5052 4553 5349 4f4e 3120 272d 6f27 2045 PRESSION1 '-o' E │ │ │ │ │ +00035e70: 5850 5245 5353 494f 4e32 0a20 2020 2020 XPRESSION2. │ │ │ │ │ +00035e80: 2020 2020 2065 6974 6865 7220 4558 5052 either EXPR │ │ │ │ │ +00035e90: 4553 5349 4f4e 3120 6f72 2045 5850 5245 ESSION1 or EXPRE │ │ │ │ │ +00035ea0: 5353 494f 4e32 2069 7320 7472 7565 0a0a SSION2 is true.. │ │ │ │ │ +00035eb0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00035ec0: 6f2c 2020 4e6f 6465 3a20 7472 7565 2c20 o, Node: true, │ │ │ │ │ +00035ed0: 204e 6578 743a 2074 7275 7374 2c20 2050 Next: trust, P │ │ │ │ │ +00035ee0: 7265 763a 2074 6573 742c 2020 5570 3a20 rev: test, Up: │ │ │ │ │ +00035ef0: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00035f00: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00035f10: 616e 6473 0a0a 3136 2e33 2e37 3520 7472 ands..16.3.75 tr │ │ │ │ │ +00035f20: 7565 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ue.------------. │ │ │ │ │ +00035f30: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7472 . -- Command: tr │ │ │ │ │ +00035f40: 7565 0a20 2020 2020 446f 206e 6f74 6869 ue. Do nothi │ │ │ │ │ +00035f50: 6e67 2c20 7375 6363 6573 7366 756c 6c79 ng, successfully │ │ │ │ │ +00035f60: 2e20 2054 6869 7320 6973 206d 6169 6e6c . This is mainl │ │ │ │ │ +00035f70: 7920 7573 6566 756c 2069 6e20 636f 6e74 y useful in cont │ │ │ │ │ +00035f80: 726f 6c0a 2020 2020 2063 6f6e 7374 7275 rol. constru │ │ │ │ │ +00035f90: 6374 7320 7375 6368 2061 7320 2769 6627 cts such as 'if' │ │ │ │ │ +00035fa0: 2061 6e64 2027 7768 696c 6527 2028 2a6e and 'while' (*n │ │ │ │ │ +00035fb0: 6f74 6520 5368 656c 6c2d 6c69 6b65 2073 ote Shell-like s │ │ │ │ │ +00035fc0: 6372 6970 7469 6e67 3a3a 292e 0a0a 1f0a cripting::)..... │ │ │ │ │ +00035fd0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00035fe0: 2020 4e6f 6465 3a20 7472 7573 742c 2020 Node: trust, │ │ │ │ │ +00035ff0: 4e65 7874 3a20 756e 7365 742c 2020 5072 Next: unset, Pr │ │ │ │ │ +00036000: 6576 3a20 7472 7565 2c20 2055 703a 2043 ev: true, Up: C │ │ │ │ │ +00036010: 6f6d 6d61 6e64 2d6c 696e 6520 616e 6420 ommand-line and │ │ │ │ │ +00036020: 6d65 6e75 2065 6e74 7279 2063 6f6d 6d61 menu entry comma │ │ │ │ │ +00036030: 6e64 730a 0a31 362e 332e 3736 2074 7275 nds..16.3.76 tru │ │ │ │ │ +00036040: 7374 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d st.------------- │ │ │ │ │ +00036050: 0a0a 202d 2d20 436f 6d6d 616e 643a 2074 .. -- Command: t │ │ │ │ │ +00036060: 7275 7374 205b 2d2d 736b 6970 2d73 6967 rust [--skip-sig │ │ │ │ │ +00036070: 5d20 7075 626b 6579 5f66 696c 650a 2020 ] pubkey_file. │ │ │ │ │ +00036080: 2020 2052 6561 6420 7075 626c 6963 206b Read public k │ │ │ │ │ +00036090: 6579 2066 726f 6d20 5055 424b 4559 5f46 ey from PUBKEY_F │ │ │ │ │ +000360a0: 494c 4520 616e 6420 6164 6420 6974 2074 ILE and add it t │ │ │ │ │ +000360b0: 6f20 4752 5542 2773 2069 6e74 6572 6e61 o GRUB's interna │ │ │ │ │ +000360c0: 6c20 6c69 7374 0a20 2020 2020 6f66 2074 l list. of t │ │ │ │ │ +000360d0: 7275 7374 6564 2070 7562 6c69 6320 6b65 rusted public ke │ │ │ │ │ +000360e0: 7973 2e20 2054 6865 7365 206b 6579 7320 ys. These keys │ │ │ │ │ +000360f0: 6172 6520 7573 6564 2074 6f20 7661 6c69 are used to vali │ │ │ │ │ +00036100: 6461 7465 2064 6967 6974 616c 0a20 2020 date digital. │ │ │ │ │ +00036110: 2020 7369 676e 6174 7572 6573 2077 6865 signatures whe │ │ │ │ │ +00036120: 6e20 656e 7669 726f 6e6d 656e 7420 7661 n environment va │ │ │ │ │ +00036130: 7269 6162 6c65 2027 6368 6563 6b5f 7369 riable 'check_si │ │ │ │ │ +00036140: 676e 6174 7572 6573 2720 6973 2073 6574 gnatures' is set │ │ │ │ │ +00036150: 2074 6f0a 2020 2020 2027 656e 666f 7263 to. 'enforc │ │ │ │ │ +00036160: 6527 2e20 204e 6f74 6520 7468 6174 2069 e'. Note that i │ │ │ │ │ +00036170: 6620 2763 6865 636b 5f73 6967 6e61 7475 f 'check_signatu │ │ │ │ │ +00036180: 7265 7327 2069 7320 7365 7420 746f 2027 res' is set to ' │ │ │ │ │ +00036190: 656e 666f 7263 6527 0a20 2020 2020 7768 enforce'. wh │ │ │ │ │ +000361a0: 656e 2027 7472 7573 7427 2065 7865 6375 en 'trust' execu │ │ │ │ │ +000361b0: 7465 732c 2074 6865 6e20 5055 424b 4559 tes, then PUBKEY │ │ │ │ │ +000361c0: 5f46 494c 4520 6d75 7374 2069 7473 656c _FILE must itsel │ │ │ │ │ +000361d0: 6620 6265 2070 726f 7065 726c 790a 2020 f be properly. │ │ │ │ │ +000361e0: 2020 2073 6967 6e65 642e 2020 5468 6520 signed. The │ │ │ │ │ +000361f0: 272d 2d73 6b69 702d 7369 6727 206f 7074 '--skip-sig' opt │ │ │ │ │ +00036200: 696f 6e20 6361 6e20 6265 2075 7365 6420 ion can be used │ │ │ │ │ +00036210: 746f 2064 6973 6162 6c65 0a20 2020 2020 to disable. │ │ │ │ │ +00036220: 7369 676e 6174 7572 652d 6368 6563 6b69 signature-checki │ │ │ │ │ +00036230: 6e67 2077 6865 6e20 7265 6164 696e 6720 ng when reading │ │ │ │ │ +00036240: 5055 424b 4559 5f46 494c 4520 6974 7365 PUBKEY_FILE itse │ │ │ │ │ +00036250: 6c66 2e20 2049 7420 6973 2065 7870 6563 lf. It is expec │ │ │ │ │ +00036260: 7465 640a 2020 2020 2074 6861 7420 272d ted. that '- │ │ │ │ │ +00036270: 2d73 6b69 702d 7369 6727 2069 7320 7573 -skip-sig' is us │ │ │ │ │ +00036280: 6566 756c 2066 6f72 2074 6573 7469 6e67 eful for testing │ │ │ │ │ +00036290: 2061 6e64 206d 616e 7561 6c20 626f 6f74 and manual boot │ │ │ │ │ +000362a0: 696e 672e 2020 2a4e 6f74 650a 2020 2020 ing. *Note. │ │ │ │ │ +000362b0: 2055 7369 6e67 2064 6967 6974 616c 2073 Using digital s │ │ │ │ │ +000362c0: 6967 6e61 7475 7265 733a 3a2c 2066 6f72 ignatures::, for │ │ │ │ │ +000362d0: 206d 6f72 6520 696e 666f 726d 6174 696f more informatio │ │ │ │ │ +000362e0: 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 n.....File: grub │ │ │ │ │ +000362f0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 756e .info, Node: un │ │ │ │ │ +00036300: 7365 742c 2020 4e65 7874 3a20 7665 7269 set, Next: veri │ │ │ │ │ +00036310: 6679 5f64 6574 6163 6865 642c 2020 5072 fy_detached, Pr │ │ │ │ │ +00036320: 6576 3a20 7472 7573 742c 2020 5570 3a20 ev: trust, Up: │ │ │ │ │ +00036330: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00036340: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00036350: 616e 6473 0a0a 3136 2e33 2e37 3720 756e ands..16.3.77 un │ │ │ │ │ +00036360: 7365 740a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d set.------------ │ │ │ │ │ +00036370: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00036380: 756e 7365 7420 656e 7676 6172 0a20 2020 unset envvar. │ │ │ │ │ +00036390: 2020 556e 7365 7420 7468 6520 656e 7669 Unset the envi │ │ │ │ │ +000363a0: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ +000363b0: 2045 4e56 5641 522e 0a0a 1f0a 4669 6c65 ENVVAR.....File │ │ │ │ │ +000363c0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +000363d0: 6465 3a20 7665 7269 6679 5f64 6574 6163 de: verify_detac │ │ │ │ │ +000363e0: 6865 642c 2020 4e65 7874 3a20 7669 6465 hed, Next: vide │ │ │ │ │ +000363f0: 6f69 6e66 6f2c 2020 5072 6576 3a20 756e oinfo, Prev: un │ │ │ │ │ +00036400: 7365 742c 2020 5570 3a20 436f 6d6d 616e set, Up: Comman │ │ │ │ │ +00036410: 642d 6c69 6e65 2061 6e64 206d 656e 7520 d-line and menu │ │ │ │ │ +00036420: 656e 7472 7920 636f 6d6d 616e 6473 0a0a entry commands.. │ │ │ │ │ +00036430: 3136 2e33 2e37 3820 7665 7269 6679 5f64 16.3.78 verify_d │ │ │ │ │ +00036440: 6574 6163 6865 640a 2d2d 2d2d 2d2d 2d2d etached.-------- │ │ │ │ │ +00036450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +00036460: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 7665 . -- Command: ve │ │ │ │ │ +00036470: 7269 6679 5f64 6574 6163 6865 6420 5b2d rify_detached [- │ │ │ │ │ +00036480: 2d73 6b69 702d 7369 675d 2066 696c 6520 -skip-sig] file │ │ │ │ │ +00036490: 7369 676e 6174 7572 655f 6669 6c65 0a20 signature_file. │ │ │ │ │ +000364a0: 2020 2020 2020 2020 205b 7075 626b 6579 [pubkey │ │ │ │ │ +000364b0: 5f66 696c 655d 0a20 2020 2020 5665 7269 _file]. Veri │ │ │ │ │ +000364c0: 6669 6573 2061 2047 5047 2d73 7479 6c65 fies a GPG-style │ │ │ │ │ +000364d0: 2064 6574 6163 6865 6420 7369 676e 6174 detached signat │ │ │ │ │ +000364e0: 7572 652c 2077 6865 7265 2074 6865 2073 ure, where the s │ │ │ │ │ +000364f0: 6967 6e65 6420 6669 6c65 2069 730a 2020 igned file is. │ │ │ │ │ +00036500: 2020 2046 494c 452c 2061 6e64 2074 6865 FILE, and the │ │ │ │ │ +00036510: 2073 6967 6e61 7475 7265 2069 7473 656c signature itsel │ │ │ │ │ +00036520: 6620 6973 2069 6e20 6669 6c65 2053 4947 f is in file SIG │ │ │ │ │ +00036530: 4e41 5455 5245 5f46 494c 452e 0a20 2020 NATURE_FILE.. │ │ │ │ │ +00036540: 2020 4f70 7469 6f6e 616c 6c79 2c20 6120 Optionally, a │ │ │ │ │ +00036550: 7370 6563 6966 6963 2070 7562 6c69 6320 specific public │ │ │ │ │ +00036560: 6b65 7920 746f 2075 7365 2063 616e 2062 key to use can b │ │ │ │ │ +00036570: 6520 7370 6563 6966 6965 6420 7573 696e e specified usin │ │ │ │ │ +00036580: 670a 2020 2020 2050 5542 4b45 595f 4649 g. PUBKEY_FI │ │ │ │ │ +00036590: 4c45 2e20 2057 6865 6e20 656e 7669 726f LE. When enviro │ │ │ │ │ +000365a0: 6e6d 656e 7420 7661 7269 6162 6c65 2027 nment variable ' │ │ │ │ │ +000365b0: 6368 6563 6b5f 7369 676e 6174 7572 6573 check_signatures │ │ │ │ │ +000365c0: 2720 6973 2073 6574 0a20 2020 2020 746f ' is set. to │ │ │ │ │ +000365d0: 2027 656e 666f 7263 6527 2c20 7468 656e 'enforce', then │ │ │ │ │ +000365e0: 2050 5542 4b45 595f 4649 4c45 206d 7573 PUBKEY_FILE mus │ │ │ │ │ +000365f0: 7420 6974 7365 6c66 2062 6520 7072 6f70 t itself be prop │ │ │ │ │ +00036600: 6572 6c79 2073 6967 6e65 6420 6279 2061 erly signed by a │ │ │ │ │ +00036610: 6e0a 2020 2020 2061 6c72 6561 6479 2d74 n. already-t │ │ │ │ │ +00036620: 7275 7374 6564 206b 6579 2e20 2041 6e20 rusted key. An │ │ │ │ │ +00036630: 756e 7369 676e 6564 2050 5542 4b45 595f unsigned PUBKEY_ │ │ │ │ │ +00036640: 4649 4c45 2063 616e 2062 6520 6c6f 6164 FILE can be load │ │ │ │ │ +00036650: 6564 2062 790a 2020 2020 2073 7065 6369 ed by. speci │ │ │ │ │ +00036660: 6679 696e 6720 272d 2d73 6b69 702d 7369 fying '--skip-si │ │ │ │ │ +00036670: 6727 2e20 2049 6620 5055 424b 4559 5f46 g'. If PUBKEY_F │ │ │ │ │ +00036680: 494c 4520 6973 206f 6d69 7474 6564 2c20 ILE is omitted, │ │ │ │ │ +00036690: 7468 656e 2070 7562 6c69 630a 2020 2020 then public. │ │ │ │ │ +000366a0: 206b 6579 7320 6672 6f6d 2047 5255 4227 keys from GRUB' │ │ │ │ │ +000366b0: 7320 7472 7573 7465 6420 6b65 7973 2028 s trusted keys ( │ │ │ │ │ +000366c0: 2a6e 6f74 6520 6c69 7374 5f74 7275 7374 *note list_trust │ │ │ │ │ +000366d0: 6564 3a3a 2c20 2a6e 6f74 6520 7472 7573 ed::, *note trus │ │ │ │ │ +000366e0: 743a 3a2c 0a20 2020 2020 616e 6420 2a6e t::,. and *n │ │ │ │ │ +000366f0: 6f74 6520 6469 7374 7275 7374 3a3a 2920 ote distrust::) │ │ │ │ │ +00036700: 6172 6520 7472 6965 642e 0a0a 2020 2020 are tried... │ │ │ │ │ +00036710: 2045 7869 7420 636f 6465 2027 243f 2720 Exit code '$?' │ │ │ │ │ +00036720: 6973 2073 6574 2074 6f20 3020 6966 2074 is set to 0 if t │ │ │ │ │ +00036730: 6865 2073 6967 6e61 7475 7265 2076 616c he signature val │ │ │ │ │ +00036740: 6964 6174 6573 2073 7563 6365 7373 6675 idates successfu │ │ │ │ │ +00036750: 6c6c 792e 0a20 2020 2020 4966 2076 616c lly.. If val │ │ │ │ │ +00036760: 6964 6174 696f 6e20 6661 696c 732c 2069 idation fails, i │ │ │ │ │ +00036770: 7420 6973 2073 6574 2074 6f20 6120 6e6f t is set to a no │ │ │ │ │ +00036780: 6e2d 7a65 726f 2076 616c 7565 2e20 202a n-zero value. * │ │ │ │ │ +00036790: 4e6f 7465 2055 7369 6e67 0a20 2020 2020 Note Using. │ │ │ │ │ +000367a0: 6469 6769 7461 6c20 7369 676e 6174 7572 digital signatur │ │ │ │ │ +000367b0: 6573 3a3a 2c20 666f 7220 6d6f 7265 2069 es::, for more i │ │ │ │ │ +000367c0: 6e66 6f72 6d61 7469 6f6e 2e0a 0a1f 0a46 nformation.....F │ │ │ │ │ +000367d0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +000367e0: 204e 6f64 653a 2076 6964 656f 696e 666f Node: videoinfo │ │ │ │ │ +000367f0: 2c20 204e 6578 743a 2077 726d 7372 2c20 , Next: wrmsr, │ │ │ │ │ +00036800: 2050 7265 763a 2076 6572 6966 795f 6465 Prev: verify_de │ │ │ │ │ +00036810: 7461 6368 6564 2c20 2055 703a 2043 6f6d tached, Up: Com │ │ │ │ │ +00036820: 6d61 6e64 2d6c 696e 6520 616e 6420 6d65 mand-line and me │ │ │ │ │ +00036830: 6e75 2065 6e74 7279 2063 6f6d 6d61 6e64 nu entry command │ │ │ │ │ +00036840: 730a 0a31 362e 332e 3739 2076 6964 656f s..16.3.79 video │ │ │ │ │ +00036850: 696e 666f 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d info.----------- │ │ │ │ │ +00036860: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +00036870: 616e 643a 2076 6964 656f 696e 666f 205b and: videoinfo [ │ │ │ │ │ +00036880: 5b57 7848 5d78 445d 0a20 2020 2020 4c69 [WxH]xD]. Li │ │ │ │ │ +00036890: 7374 2061 7661 696c 6162 6c65 2076 6964 st available vid │ │ │ │ │ +000368a0: 656f 206d 6f64 6573 2e20 2049 6620 7265 eo modes. If re │ │ │ │ │ +000368b0: 736f 6c75 7469 6f6e 2069 7320 6769 7665 solution is give │ │ │ │ │ +000368c0: 6e2c 2073 686f 7720 6f6e 6c79 0a20 2020 n, show only. │ │ │ │ │ +000368d0: 2020 6d61 7463 6869 6e67 206d 6f64 6573 matching modes │ │ │ │ │ +000368e0: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +000368f0: 696e 666f 2c20 204e 6f64 653a 2077 726d info, Node: wrm │ │ │ │ │ +00036900: 7372 2c20 204e 6578 743a 2078 656e 5f68 sr, Next: xen_h │ │ │ │ │ +00036910: 7970 6572 7669 736f 722c 2020 5072 6576 ypervisor, Prev │ │ │ │ │ +00036920: 3a20 7669 6465 6f69 6e66 6f2c 2020 5570 : videoinfo, Up │ │ │ │ │ +00036930: 3a20 436f 6d6d 616e 642d 6c69 6e65 2061 : Command-line a │ │ │ │ │ +00036940: 6e64 206d 656e 7520 656e 7472 7920 636f nd menu entry co │ │ │ │ │ +00036950: 6d6d 616e 6473 0a0a 3136 2e33 2e38 3020 mmands..16.3.80 │ │ │ │ │ +00036960: 7772 6d73 720a 2d2d 2d2d 2d2d 2d2d 2d2d wrmsr.---------- │ │ │ │ │ +00036970: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ +00036980: 3a3a 2077 726d 7372 2030 7841 4444 5220 :: wrmsr 0xADDR │ │ │ │ │ +00036990: 3078 5641 4c55 450a 2020 2020 2057 7269 0xVALUE. Wri │ │ │ │ │ +000369a0: 7465 2061 2030 7856 414c 5545 2074 6f20 te a 0xVALUE to │ │ │ │ │ +000369b0: 6120 6d6f 6465 6c2d 7370 6563 6966 6963 a model-specific │ │ │ │ │ +000369c0: 2072 6567 6973 7465 7220 6174 2061 6464 register at add │ │ │ │ │ +000369d0: 7265 7373 2030 7841 4444 522e 0a0a 2020 ress 0xADDR... │ │ │ │ │ +000369e0: 2020 2050 6c65 6173 6520 6e6f 7465 2074 Please note t │ │ │ │ │ +000369f0: 6861 7420 6f6e 2053 4d50 2073 7973 7465 hat on SMP syste │ │ │ │ │ +00036a00: 6d73 2c20 7772 6974 696e 6720 746f 2061 ms, writing to a │ │ │ │ │ +00036a10: 204d 5352 2074 6861 7420 6861 7320 6120 MSR that has a │ │ │ │ │ +00036a20: 7363 6f70 650a 2020 2020 2070 6572 2068 scope. per h │ │ │ │ │ +00036a30: 6172 6477 6172 6520 7468 7265 6164 2c20 ardware thread, │ │ │ │ │ +00036a40: 696d 706c 6965 7320 7468 6174 2074 6865 implies that the │ │ │ │ │ +00036a50: 2076 616c 7565 2074 6861 7420 6973 2077 value that is w │ │ │ │ │ +00036a60: 7269 7474 656e 206f 6e6c 790a 2020 2020 ritten only. │ │ │ │ │ +00036a70: 2061 7070 6c69 6573 2074 6f20 7468 6520 applies to the │ │ │ │ │ +00036a80: 7061 7274 6963 756c 6172 2063 7075 2f63 particular cpu/c │ │ │ │ │ +00036a90: 6f72 652f 7468 7265 6164 2074 6861 7420 ore/thread that │ │ │ │ │ +00036aa0: 7275 6e73 2074 6865 2063 6f6d 6d61 6e64 runs the command │ │ │ │ │ +00036ab0: 2e0a 0a20 2020 2020 416c 736f 2c20 6966 ... Also, if │ │ │ │ │ +00036ac0: 2079 6f75 2073 7065 6369 6679 2061 2072 you specify a r │ │ │ │ │ +00036ad0: 6573 6572 7665 6420 6f72 2075 6e69 6d70 eserved or unimp │ │ │ │ │ +00036ae0: 6c65 6d65 6e74 6564 204d 5352 2061 6464 lemented MSR add │ │ │ │ │ +00036af0: 7265 7373 2c20 6974 0a20 2020 2020 7769 ress, it. wi │ │ │ │ │ +00036b00: 6c6c 2063 6175 7365 2061 2067 656e 6572 ll cause a gener │ │ │ │ │ +00036b10: 616c 2070 726f 7465 6374 696f 6e20 6578 al protection ex │ │ │ │ │ +00036b20: 6365 7074 696f 6e20 2877 6869 6368 2069 ception (which i │ │ │ │ │ +00036b30: 7320 6e6f 7420 6375 7272 656e 746c 790a s not currently. │ │ │ │ │ +00036b40: 2020 2020 2062 6569 6e67 2068 616e 646c being handl │ │ │ │ │ +00036b50: 6564 2920 616e 6420 7468 6520 7379 7374 ed) and the syst │ │ │ │ │ +00036b60: 656d 2077 696c 6c20 7265 626f 6f74 2e0a em will reboot.. │ │ │ │ │ +00036b70: 0a20 2020 2020 4e6f 7465 3a20 5468 6520 . Note: The │ │ │ │ │ +00036b80: 636f 6d6d 616e 6420 6973 206e 6f74 2061 command is not a │ │ │ │ │ +00036b90: 6c6c 6f77 6564 2077 6865 6e20 6c6f 636b llowed when lock │ │ │ │ │ +00036ba0: 646f 776e 2069 7320 656e 666f 7263 6564 down is enforced │ │ │ │ │ +00036bb0: 2028 2a6e 6f74 650a 2020 2020 204c 6f63 (*note. Loc │ │ │ │ │ +00036bc0: 6b64 6f77 6e3a 3a29 2e20 2054 6869 7320 kdown::). This │ │ │ │ │ +00036bd0: 6973 2064 6f6e 6520 746f 2070 7265 7665 is done to preve │ │ │ │ │ +00036be0: 6e74 2073 7562 7665 7274 696e 6720 7661 nt subverting va │ │ │ │ │ +00036bf0: 7269 6f75 7320 7365 6375 7269 7479 0a20 rious security. │ │ │ │ │ +00036c00: 2020 2020 6d65 6368 616e 6973 6d73 2e0a mechanisms.. │ │ │ │ │ +00036c10: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00036c20: 666f 2c20 204e 6f64 653a 2078 656e 5f68 fo, Node: xen_h │ │ │ │ │ +00036c30: 7970 6572 7669 736f 722c 2020 4e65 7874 ypervisor, Next │ │ │ │ │ +00036c40: 3a20 7865 6e5f 6d6f 6475 6c65 2c20 2050 : xen_module, P │ │ │ │ │ +00036c50: 7265 763a 2077 726d 7372 2c20 2055 703a rev: wrmsr, Up: │ │ │ │ │ +00036c60: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +00036c70: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +00036c80: 6d61 6e64 730a 0a31 362e 332e 3831 2078 mands..16.3.81 x │ │ │ │ │ +00036c90: 656e 5f68 7970 6572 7669 736f 720a 2d2d en_hypervisor.-- │ │ │ │ │ 00036ca0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00036cb0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -00036cc0: 2078 656e 5f68 7970 6572 7669 736f 7220 xen_hypervisor │ │ │ │ │ -00036cd0: 6669 6c65 205b 6172 6775 6d65 6e74 735d file [arguments] │ │ │ │ │ -00036ce0: 202e 2e2e 0a20 2020 2020 4c6f 6164 2061 .... Load a │ │ │ │ │ -00036cf0: 2058 656e 2068 7970 6572 7669 736f 7220 Xen hypervisor │ │ │ │ │ -00036d00: 6269 6e61 7279 2066 726f 6d20 4649 4c45 binary from FILE │ │ │ │ │ -00036d10: 2e20 2054 6865 2072 6573 7420 6f66 2074 . The rest of t │ │ │ │ │ -00036d20: 6865 206c 696e 6520 6973 0a20 2020 2020 he line is. │ │ │ │ │ -00036d30: 7061 7373 6564 2076 6572 6261 7469 6d20 passed verbatim │ │ │ │ │ -00036d40: 6173 2074 6865 2022 6b65 726e 656c 2063 as the "kernel c │ │ │ │ │ -00036d50: 6f6d 6d61 6e64 2d6c 696e 6522 2e20 2041 ommand-line". A │ │ │ │ │ -00036d60: 6e79 206f 7468 6572 2062 696e 6172 6965 ny other binarie │ │ │ │ │ -00036d70: 730a 2020 2020 206d 7573 7420 6265 2072 s. must be r │ │ │ │ │ -00036d80: 656c 6f61 6465 6420 6166 7465 7220 7573 eloaded after us │ │ │ │ │ -00036d90: 696e 6720 7468 6973 2063 6f6d 6d61 6e64 ing this command │ │ │ │ │ -00036da0: 2e20 2054 6869 7320 636f 6d6d 616e 6420 . This command │ │ │ │ │ -00036db0: 6973 206f 6e6c 790a 2020 2020 2061 7661 is only. ava │ │ │ │ │ -00036dc0: 696c 6162 6c65 206f 6e20 4141 7263 6836 ilable on AArch6 │ │ │ │ │ -00036dd0: 3420 7379 7374 656d 732e 0a0a 1f0a 4669 4 systems.....Fi │ │ │ │ │ -00036de0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00036df0: 4e6f 6465 3a20 7865 6e5f 6d6f 6475 6c65 Node: xen_module │ │ │ │ │ -00036e00: 2c20 2050 7265 763a 2078 656e 5f68 7970 , Prev: xen_hyp │ │ │ │ │ -00036e10: 6572 7669 736f 722c 2020 5570 3a20 436f ervisor, Up: Co │ │ │ │ │ -00036e20: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -00036e30: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -00036e40: 6473 0a0a 3136 2e33 2e38 3220 7865 6e5f ds..16.3.82 xen_ │ │ │ │ │ -00036e50: 6d6f 6475 6c65 0a2d 2d2d 2d2d 2d2d 2d2d module.--------- │ │ │ │ │ -00036e60: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ -00036e70: 6f6d 6d61 6e64 3a20 7865 6e5f 6d6f 6475 ommand: xen_modu │ │ │ │ │ -00036e80: 6c65 205b 2d2d 6e6f 756e 7a69 705d 2066 le [--nounzip] f │ │ │ │ │ -00036e90: 696c 6520 5b61 7267 756d 656e 7473 5d0a ile [arguments]. │ │ │ │ │ -00036ea0: 2020 2020 204c 6f61 6420 6120 6d6f 6475 Load a modu │ │ │ │ │ -00036eb0: 6c65 2066 6f72 2078 656e 2068 7970 6572 le for xen hyper │ │ │ │ │ -00036ec0: 7669 736f 7220 6174 2074 6865 2062 6f6f visor at the boo │ │ │ │ │ -00036ed0: 7469 6e67 2070 726f 6365 7373 206f 6620 ting process of │ │ │ │ │ -00036ee0: 7865 6e2e 0a20 2020 2020 5468 6520 7265 xen.. The re │ │ │ │ │ -00036ef0: 7374 206f 6620 7468 6520 6c69 6e65 2069 st of the line i │ │ │ │ │ -00036f00: 7320 7061 7373 6564 2076 6572 6261 7469 s passed verbati │ │ │ │ │ -00036f10: 6d20 6173 2074 6865 206d 6f64 756c 6520 m as the module │ │ │ │ │ -00036f20: 636f 6d6d 616e 6420 6c69 6e65 2e0a 2020 command line.. │ │ │ │ │ -00036f30: 2020 204d 6f64 756c 6573 2073 686f 756c Modules shoul │ │ │ │ │ -00036f40: 6420 6265 206c 6f61 6465 6420 696e 2074 d be loaded in t │ │ │ │ │ -00036f50: 6865 2066 6f6c 6c6f 7769 6e67 206f 7264 he following ord │ │ │ │ │ -00036f60: 6572 3a20 2d20 646f 6d30 206b 6572 6e65 er: - dom0 kerne │ │ │ │ │ -00036f70: 6c0a 2020 2020 2069 6d61 6765 202d 2064 l. image - d │ │ │ │ │ -00036f80: 6f6d 3020 7261 6d64 6973 6b20 6966 2070 om0 ramdisk if p │ │ │ │ │ -00036f90: 7265 7365 6e74 202d 2058 534d 2070 6f6c resent - XSM pol │ │ │ │ │ -00036fa0: 6963 7920 6966 2070 7265 7365 6e74 2054 icy if present T │ │ │ │ │ -00036fb0: 6869 730a 2020 2020 2063 6f6d 6d61 6e64 his. command │ │ │ │ │ -00036fc0: 2069 7320 6f6e 6c79 2061 7661 696c 6162 is only availab │ │ │ │ │ -00036fd0: 6c65 206f 6e20 4141 7263 6836 3420 7379 le on AArch64 sy │ │ │ │ │ -00036fe0: 7374 656d 732e 0a0a 1f0a 4669 6c65 3a20 stems.....File: │ │ │ │ │ -00036ff0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00037000: 3a20 4e65 7477 6f72 6b69 6e67 2063 6f6d : Networking com │ │ │ │ │ -00037010: 6d61 6e64 732c 2020 5072 6576 3a20 436f mands, Prev: Co │ │ │ │ │ -00037020: 6d6d 616e 642d 6c69 6e65 2061 6e64 206d mmand-line and m │ │ │ │ │ -00037030: 656e 7520 656e 7472 7920 636f 6d6d 616e enu entry comman │ │ │ │ │ -00037040: 6473 2c20 2055 703a 2043 6f6d 6d61 6e64 ds, Up: Command │ │ │ │ │ -00037050: 730a 0a31 362e 3420 5468 6520 6c69 7374 s..16.4 The list │ │ │ │ │ -00037060: 206f 6620 6e65 7477 6f72 6b69 6e67 2063 of networking c │ │ │ │ │ -00037070: 6f6d 6d61 6e64 730a 3d3d 3d3d 3d3d 3d3d ommands.======== │ │ │ │ │ +00036cb0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +00036cc0: 643a 2078 656e 5f68 7970 6572 7669 736f d: xen_hyperviso │ │ │ │ │ +00036cd0: 7220 6669 6c65 205b 6172 6775 6d65 6e74 r file [argument │ │ │ │ │ +00036ce0: 735d 202e 2e2e 0a20 2020 2020 4c6f 6164 s] .... Load │ │ │ │ │ +00036cf0: 2061 2058 656e 2068 7970 6572 7669 736f a Xen hyperviso │ │ │ │ │ +00036d00: 7220 6269 6e61 7279 2066 726f 6d20 4649 r binary from FI │ │ │ │ │ +00036d10: 4c45 2e20 2054 6865 2072 6573 7420 6f66 LE. The rest of │ │ │ │ │ +00036d20: 2074 6865 206c 696e 6520 6973 0a20 2020 the line is. │ │ │ │ │ +00036d30: 2020 7061 7373 6564 2076 6572 6261 7469 passed verbati │ │ │ │ │ +00036d40: 6d20 6173 2074 6865 2022 6b65 726e 656c m as the "kernel │ │ │ │ │ +00036d50: 2063 6f6d 6d61 6e64 2d6c 696e 6522 2e20 command-line". │ │ │ │ │ +00036d60: 2041 6e79 206f 7468 6572 2062 696e 6172 Any other binar │ │ │ │ │ +00036d70: 6965 730a 2020 2020 206d 7573 7420 6265 ies. must be │ │ │ │ │ +00036d80: 2072 656c 6f61 6465 6420 6166 7465 7220 reloaded after │ │ │ │ │ +00036d90: 7573 696e 6720 7468 6973 2063 6f6d 6d61 using this comma │ │ │ │ │ +00036da0: 6e64 2e20 2054 6869 7320 636f 6d6d 616e nd. This comman │ │ │ │ │ +00036db0: 6420 6973 206f 6e6c 790a 2020 2020 2061 d is only. a │ │ │ │ │ +00036dc0: 7661 696c 6162 6c65 206f 6e20 4141 7263 vailable on AArc │ │ │ │ │ +00036dd0: 6836 3420 7379 7374 656d 732e 0a0a 1f0a h64 systems..... │ │ │ │ │ +00036de0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00036df0: 2020 4e6f 6465 3a20 7865 6e5f 6d6f 6475 Node: xen_modu │ │ │ │ │ +00036e00: 6c65 2c20 2050 7265 763a 2078 656e 5f68 le, Prev: xen_h │ │ │ │ │ +00036e10: 7970 6572 7669 736f 722c 2020 5570 3a20 ypervisor, Up: │ │ │ │ │ +00036e20: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00036e30: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00036e40: 616e 6473 0a0a 3136 2e33 2e38 3220 7865 ands..16.3.82 xe │ │ │ │ │ +00036e50: 6e5f 6d6f 6475 6c65 0a2d 2d2d 2d2d 2d2d n_module.------- │ │ │ │ │ +00036e60: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ +00036e70: 2043 6f6d 6d61 6e64 3a20 7865 6e5f 6d6f Command: xen_mo │ │ │ │ │ +00036e80: 6475 6c65 205b 2d2d 6e6f 756e 7a69 705d dule [--nounzip] │ │ │ │ │ +00036e90: 2066 696c 6520 5b61 7267 756d 656e 7473 file [arguments │ │ │ │ │ +00036ea0: 5d0a 2020 2020 204c 6f61 6420 6120 6d6f ]. Load a mo │ │ │ │ │ +00036eb0: 6475 6c65 2066 6f72 2078 656e 2068 7970 dule for xen hyp │ │ │ │ │ +00036ec0: 6572 7669 736f 7220 6174 2074 6865 2062 ervisor at the b │ │ │ │ │ +00036ed0: 6f6f 7469 6e67 2070 726f 6365 7373 206f ooting process o │ │ │ │ │ +00036ee0: 6620 7865 6e2e 0a20 2020 2020 5468 6520 f xen.. The │ │ │ │ │ +00036ef0: 7265 7374 206f 6620 7468 6520 6c69 6e65 rest of the line │ │ │ │ │ +00036f00: 2069 7320 7061 7373 6564 2076 6572 6261 is passed verba │ │ │ │ │ +00036f10: 7469 6d20 6173 2074 6865 206d 6f64 756c tim as the modul │ │ │ │ │ +00036f20: 6520 636f 6d6d 616e 6420 6c69 6e65 2e0a e command line.. │ │ │ │ │ +00036f30: 2020 2020 204d 6f64 756c 6573 2073 686f Modules sho │ │ │ │ │ +00036f40: 756c 6420 6265 206c 6f61 6465 6420 696e uld be loaded in │ │ │ │ │ +00036f50: 2074 6865 2066 6f6c 6c6f 7769 6e67 206f the following o │ │ │ │ │ +00036f60: 7264 6572 3a20 2d20 646f 6d30 206b 6572 rder: - dom0 ker │ │ │ │ │ +00036f70: 6e65 6c0a 2020 2020 2069 6d61 6765 202d nel. image - │ │ │ │ │ +00036f80: 2064 6f6d 3020 7261 6d64 6973 6b20 6966 dom0 ramdisk if │ │ │ │ │ +00036f90: 2070 7265 7365 6e74 202d 2058 534d 2070 present - XSM p │ │ │ │ │ +00036fa0: 6f6c 6963 7920 6966 2070 7265 7365 6e74 olicy if present │ │ │ │ │ +00036fb0: 2054 6869 730a 2020 2020 2063 6f6d 6d61 This. comma │ │ │ │ │ +00036fc0: 6e64 2069 7320 6f6e 6c79 2061 7661 696c nd is only avail │ │ │ │ │ +00036fd0: 6162 6c65 206f 6e20 4141 7263 6836 3420 able on AArch64 │ │ │ │ │ +00036fe0: 7379 7374 656d 732e 0a0a 1f0a 4669 6c65 systems.....File │ │ │ │ │ +00036ff0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00037000: 6465 3a20 4e65 7477 6f72 6b69 6e67 2063 de: Networking c │ │ │ │ │ +00037010: 6f6d 6d61 6e64 732c 2020 5072 6576 3a20 ommands, Prev: │ │ │ │ │ +00037020: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ +00037030: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ +00037040: 616e 6473 2c20 2055 703a 2043 6f6d 6d61 ands, Up: Comma │ │ │ │ │ +00037050: 6e64 730a 0a31 362e 3420 5468 6520 6c69 nds..16.4 The li │ │ │ │ │ +00037060: 7374 206f 6620 6e65 7477 6f72 6b69 6e67 st of networking │ │ │ │ │ +00037070: 2063 6f6d 6d61 6e64 730a 3d3d 3d3d 3d3d commands.====== │ │ │ │ │ 00037080: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00037090: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 2a20 ============..* │ │ │ │ │ -000370a0: 4d65 6e75 3a0a 0a2a 206e 6574 5f61 6464 Menu:..* net_add │ │ │ │ │ -000370b0: 5f61 6464 723a 3a20 2020 2020 2020 2020 _addr:: │ │ │ │ │ -000370c0: 2020 2020 2020 2041 6464 2061 206e 6574 Add a net │ │ │ │ │ -000370d0: 776f 726b 2061 6464 7265 7373 0a2a 206e work address.* n │ │ │ │ │ -000370e0: 6574 5f61 6464 5f64 6e73 3a3a 2020 2020 et_add_dns:: │ │ │ │ │ -000370f0: 2020 2020 2020 2020 2020 2020 2041 6464 Add │ │ │ │ │ -00037100: 2061 2044 4e53 2073 6572 7665 720a 2a20 a DNS server.* │ │ │ │ │ -00037110: 6e65 745f 6164 645f 726f 7574 653a 3a20 net_add_route:: │ │ │ │ │ -00037120: 2020 2020 2020 2020 2020 2020 2020 4164 Ad │ │ │ │ │ -00037130: 6420 726f 7574 696e 6720 656e 7472 790a d routing entry. │ │ │ │ │ -00037140: 2a20 6e65 745f 626f 6f74 703a 3a20 2020 * net_bootp:: │ │ │ │ │ +00037090: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +000370a0: 2a20 4d65 6e75 3a0a 0a2a 206e 6574 5f61 * Menu:..* net_a │ │ │ │ │ +000370b0: 6464 5f61 6464 723a 3a20 2020 2020 2020 dd_addr:: │ │ │ │ │ +000370c0: 2020 2020 2020 2020 2041 6464 2061 206e Add a n │ │ │ │ │ +000370d0: 6574 776f 726b 2061 6464 7265 7373 0a2a etwork address.* │ │ │ │ │ +000370e0: 206e 6574 5f61 6464 5f64 6e73 3a3a 2020 net_add_dns:: │ │ │ │ │ +000370f0: 2020 2020 2020 2020 2020 2020 2020 2041 A │ │ │ │ │ +00037100: 6464 2061 2044 4e53 2073 6572 7665 720a dd a DNS server. │ │ │ │ │ +00037110: 2a20 6e65 745f 6164 645f 726f 7574 653a * net_add_route: │ │ │ │ │ +00037120: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00037130: 4164 6420 726f 7574 696e 6720 656e 7472 Add routing entr │ │ │ │ │ +00037140: 790a 2a20 6e65 745f 626f 6f74 703a 3a20 y.* net_bootp:: │ │ │ │ │ 00037150: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037160: 5065 7266 6f72 6d20 6120 626f 6f74 702f Perform a bootp/ │ │ │ │ │ -00037170: 4448 4350 2061 7574 6f63 6f6e 6669 6775 DHCP autoconfigu │ │ │ │ │ -00037180: 7261 7469 6f6e 0a2a 206e 6574 5f64 656c ration.* net_del │ │ │ │ │ -00037190: 5f61 6464 723a 3a20 2020 2020 2020 2020 _addr:: │ │ │ │ │ -000371a0: 2020 2020 2020 2052 656d 6f76 6520 4950 Remove IP │ │ │ │ │ -000371b0: 2061 6464 7265 7373 2066 726f 6d20 696e address from in │ │ │ │ │ -000371c0: 7465 7266 6163 650a 2a20 6e65 745f 6465 terface.* net_de │ │ │ │ │ -000371d0: 6c5f 646e 733a 3a20 2020 2020 2020 2020 l_dns:: │ │ │ │ │ -000371e0: 2020 2020 2020 2020 5265 6d6f 7665 2061 Remove a │ │ │ │ │ -000371f0: 2044 4e53 2073 6572 7665 720a 2a20 6e65 DNS server.* ne │ │ │ │ │ -00037200: 745f 6465 6c5f 726f 7574 653a 3a20 2020 t_del_route:: │ │ │ │ │ -00037210: 2020 2020 2020 2020 2020 2020 5265 6d6f Remo │ │ │ │ │ -00037220: 7665 2061 2072 6f75 7465 2065 6e74 7279 ve a route entry │ │ │ │ │ -00037230: 0a2a 206e 6574 5f64 6863 703a 3a20 2020 .* net_dhcp:: │ │ │ │ │ +00037160: 2020 5065 7266 6f72 6d20 6120 626f 6f74 Perform a boot │ │ │ │ │ +00037170: 702f 4448 4350 2061 7574 6f63 6f6e 6669 p/DHCP autoconfi │ │ │ │ │ +00037180: 6775 7261 7469 6f6e 0a2a 206e 6574 5f64 guration.* net_d │ │ │ │ │ +00037190: 656c 5f61 6464 723a 3a20 2020 2020 2020 el_addr:: │ │ │ │ │ +000371a0: 2020 2020 2020 2020 2052 656d 6f76 6520 Remove │ │ │ │ │ +000371b0: 4950 2061 6464 7265 7373 2066 726f 6d20 IP address from │ │ │ │ │ +000371c0: 696e 7465 7266 6163 650a 2a20 6e65 745f interface.* net_ │ │ │ │ │ +000371d0: 6465 6c5f 646e 733a 3a20 2020 2020 2020 del_dns:: │ │ │ │ │ +000371e0: 2020 2020 2020 2020 2020 5265 6d6f 7665 Remove │ │ │ │ │ +000371f0: 2061 2044 4e53 2073 6572 7665 720a 2a20 a DNS server.* │ │ │ │ │ +00037200: 6e65 745f 6465 6c5f 726f 7574 653a 3a20 net_del_route:: │ │ │ │ │ +00037210: 2020 2020 2020 2020 2020 2020 2020 5265 Re │ │ │ │ │ +00037220: 6d6f 7665 2061 2072 6f75 7465 2065 6e74 move a route ent │ │ │ │ │ +00037230: 7279 0a2a 206e 6574 5f64 6863 703a 3a20 ry.* net_dhcp:: │ │ │ │ │ 00037240: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00037250: 2050 6572 666f 726d 2061 2044 4843 5020 Perform a DHCP │ │ │ │ │ -00037260: 6175 746f 636f 6e66 6967 7572 6174 696f autoconfiguratio │ │ │ │ │ -00037270: 6e0a 2a20 6e65 745f 6765 745f 6468 6370 n.* net_get_dhcp │ │ │ │ │ -00037280: 5f6f 7074 696f 6e3a 3a20 2020 2020 2020 _option:: │ │ │ │ │ -00037290: 2020 5265 7472 6965 7665 2044 4843 5020 Retrieve DHCP │ │ │ │ │ -000372a0: 6f70 7469 6f6e 730a 2a20 6e65 745f 6970 options.* net_ip │ │ │ │ │ -000372b0: 7636 5f61 7574 6f63 6f6e 663a 3a20 2020 v6_autoconf:: │ │ │ │ │ -000372c0: 2020 2020 2020 2020 5065 7266 6f72 6d20 Perform │ │ │ │ │ -000372d0: 4950 7636 2061 7574 6f63 6f6e 6669 6775 IPv6 autoconfigu │ │ │ │ │ -000372e0: 7261 7469 6f6e 0a2a 206e 6574 5f6c 735f ration.* net_ls_ │ │ │ │ │ -000372f0: 6164 6472 3a3a 2020 2020 2020 2020 2020 addr:: │ │ │ │ │ -00037300: 2020 2020 2020 204c 6973 7420 696e 7465 List inte │ │ │ │ │ -00037310: 7266 6163 6573 0a2a 206e 6574 5f6c 735f rfaces.* net_ls_ │ │ │ │ │ -00037320: 6361 7264 733a 3a20 2020 2020 2020 2020 cards:: │ │ │ │ │ -00037330: 2020 2020 2020 204c 6973 7420 6e65 7477 List netw │ │ │ │ │ -00037340: 6f72 6b20 6361 7264 730a 2a20 6e65 745f ork cards.* net_ │ │ │ │ │ -00037350: 6c73 5f64 6e73 3a3a 2020 2020 2020 2020 ls_dns:: │ │ │ │ │ -00037360: 2020 2020 2020 2020 2020 4c69 7374 2044 List D │ │ │ │ │ -00037370: 4e53 2073 6572 7665 7273 0a2a 206e 6574 NS servers.* net │ │ │ │ │ -00037380: 5f6c 735f 726f 7574 6573 3a3a 2020 2020 _ls_routes:: │ │ │ │ │ -00037390: 2020 2020 2020 2020 2020 204c 6973 7420 List │ │ │ │ │ -000373a0: 726f 7574 696e 6720 656e 7472 6965 730a routing entries. │ │ │ │ │ -000373b0: 2a20 6e65 745f 6e73 6c6f 6f6b 7570 3a3a * net_nslookup:: │ │ │ │ │ -000373c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000373d0: 5065 7266 6f72 6d20 6120 444e 5320 6c6f Perform a DNS lo │ │ │ │ │ -000373e0: 6f6b 7570 0a0a 1f0a 4669 6c65 3a20 6772 okup....File: gr │ │ │ │ │ -000373f0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00037400: 6e65 745f 6164 645f 6164 6472 2c20 204e net_add_addr, N │ │ │ │ │ -00037410: 6578 743a 206e 6574 5f61 6464 5f64 6e73 ext: net_add_dns │ │ │ │ │ -00037420: 2c20 2055 703a 204e 6574 776f 726b 696e , Up: Networkin │ │ │ │ │ -00037430: 6720 636f 6d6d 616e 6473 0a0a 3136 2e34 g commands..16.4 │ │ │ │ │ -00037440: 2e31 206e 6574 5f61 6464 5f61 6464 720a .1 net_add_addr. │ │ │ │ │ -00037450: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00037460: 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 ---.. -- Command │ │ │ │ │ -00037470: 3a20 6e65 745f 6164 645f 6164 6472 2049 : net_add_addr I │ │ │ │ │ -00037480: 4e54 4552 4641 4345 2043 4152 4420 4144 NTERFACE CARD AD │ │ │ │ │ -00037490: 4452 4553 530a 2020 2020 2043 6f6e 6669 DRESS. Confi │ │ │ │ │ -000374a0: 6775 7265 2061 6464 6974 696f 6e61 6c20 gure additional │ │ │ │ │ -000374b0: 6e65 7477 6f72 6b20 494e 5445 5246 4143 network INTERFAC │ │ │ │ │ -000374c0: 4520 7769 7468 2041 4444 5245 5353 206f E with ADDRESS o │ │ │ │ │ -000374d0: 6e20 6120 6e65 7477 6f72 6b0a 2020 2020 n a network. │ │ │ │ │ -000374e0: 2043 4152 442e 2020 4144 4452 4553 5320 CARD. ADDRESS │ │ │ │ │ -000374f0: 6361 6e20 6265 2065 6974 6865 7220 4950 can be either IP │ │ │ │ │ -00037500: 2069 6e20 646f 7474 6564 2064 6563 696d in dotted decim │ │ │ │ │ -00037510: 616c 206e 6f74 6174 696f 6e2c 206f 720a al notation, or. │ │ │ │ │ -00037520: 2020 2020 2073 796d 626f 6c69 6320 6e61 symbolic na │ │ │ │ │ -00037530: 6d65 2077 6869 6368 2069 7320 7265 736f me which is reso │ │ │ │ │ -00037540: 6c76 6564 2075 7369 6e67 2044 4e53 206c lved using DNS l │ │ │ │ │ -00037550: 6f6f 6b75 702e 2020 4966 2073 7563 6365 ookup. If succe │ │ │ │ │ -00037560: 7373 6675 6c2c 0a20 2020 2020 7468 6973 ssful,. this │ │ │ │ │ -00037570: 2063 6f6d 6d61 6e64 2061 6c73 6f20 6164 command also ad │ │ │ │ │ -00037580: 6473 206c 6f63 616c 206c 696e 6b20 726f ds local link ro │ │ │ │ │ -00037590: 7574 696e 6720 656e 7472 7920 746f 2074 uting entry to t │ │ │ │ │ -000375a0: 6865 2064 6566 6175 6c74 0a20 2020 2020 he default. │ │ │ │ │ -000375b0: 7375 626e 6574 206f 6620 4144 4452 4553 subnet of ADDRES │ │ │ │ │ -000375c0: 5320 7769 7468 206e 616d 6520 494e 5445 S with name INTE │ │ │ │ │ -000375d0: 5246 4143 4527 3a6c 6f63 616c 2720 7669 RFACE':local' vi │ │ │ │ │ -000375e0: 6120 494e 5445 5246 4143 452e 0a0a 1f0a a INTERFACE..... │ │ │ │ │ -000375f0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -00037600: 2020 4e6f 6465 3a20 6e65 745f 6164 645f Node: net_add_ │ │ │ │ │ -00037610: 646e 732c 2020 4e65 7874 3a20 6e65 745f dns, Next: net_ │ │ │ │ │ -00037620: 6164 645f 726f 7574 652c 2020 5072 6576 add_route, Prev │ │ │ │ │ -00037630: 3a20 6e65 745f 6164 645f 6164 6472 2c20 : net_add_addr, │ │ │ │ │ -00037640: 2055 703a 204e 6574 776f 726b 696e 6720 Up: Networking │ │ │ │ │ -00037650: 636f 6d6d 616e 6473 0a0a 3136 2e34 2e32 commands..16.4.2 │ │ │ │ │ -00037660: 206e 6574 5f61 6464 5f64 6e73 0a2d 2d2d net_add_dns.--- │ │ │ │ │ -00037670: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -00037680: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 . -- Command: ne │ │ │ │ │ -00037690: 745f 6164 645f 646e 7320 5345 5256 4552 t_add_dns SERVER │ │ │ │ │ -000376a0: 0a20 2020 2020 5265 736f 6c76 6520 5345 . Resolve SE │ │ │ │ │ -000376b0: 5256 4552 2049 5020 6164 6472 6573 7320 RVER IP address │ │ │ │ │ -000376c0: 616e 6420 6164 6420 746f 2074 6865 206c and add to the l │ │ │ │ │ -000376d0: 6973 7420 6f66 2044 4e53 2073 6572 7665 ist of DNS serve │ │ │ │ │ -000376e0: 7273 2075 7365 640a 2020 2020 2064 7572 rs used. dur │ │ │ │ │ -000376f0: 696e 6720 6e61 6d65 206c 6f6f 6b75 702e ing name lookup. │ │ │ │ │ -00037700: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00037710: 6e66 6f2c 2020 4e6f 6465 3a20 6e65 745f nfo, Node: net_ │ │ │ │ │ -00037720: 6164 645f 726f 7574 652c 2020 4e65 7874 add_route, Next │ │ │ │ │ -00037730: 3a20 6e65 745f 626f 6f74 702c 2020 5072 : net_bootp, Pr │ │ │ │ │ -00037740: 6576 3a20 6e65 745f 6164 645f 646e 732c ev: net_add_dns, │ │ │ │ │ -00037750: 2020 5570 3a20 4e65 7477 6f72 6b69 6e67 Up: Networking │ │ │ │ │ -00037760: 2063 6f6d 6d61 6e64 730a 0a31 362e 342e commands..16.4. │ │ │ │ │ -00037770: 3320 6e65 745f 6164 645f 726f 7574 650a 3 net_add_route. │ │ │ │ │ -00037780: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00037790: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -000377a0: 643a 206e 6574 5f61 6464 5f72 6f75 7465 d: net_add_route │ │ │ │ │ -000377b0: 2053 484f 5254 4e41 4d45 2049 505b 2f50 SHORTNAME IP[/P │ │ │ │ │ -000377c0: 5245 4649 585d 205b 494e 5445 5246 4143 REFIX] [INTERFAC │ │ │ │ │ -000377d0: 4520 7c20 6777 0a20 2020 2020 2020 2020 E | gw. │ │ │ │ │ -000377e0: 2047 4154 4557 4159 5d0a 2020 2020 2041 GATEWAY]. A │ │ │ │ │ -000377f0: 6464 2072 6f75 7465 2074 6f20 6e65 7477 dd route to netw │ │ │ │ │ -00037800: 6f72 6b20 7769 7468 2061 6464 7265 7373 ork with address │ │ │ │ │ -00037810: 2049 5020 6173 206d 6f64 6966 6965 6420 IP as modified │ │ │ │ │ -00037820: 6279 2050 5245 4649 5820 7669 610a 2020 by PREFIX via. │ │ │ │ │ -00037830: 2020 2065 6974 6865 7220 6c6f 6361 6c20 either local │ │ │ │ │ -00037840: 494e 5445 5246 4143 4520 6f72 2047 4154 INTERFACE or GAT │ │ │ │ │ -00037850: 4557 4159 2e20 2050 5245 4649 5820 6973 EWAY. PREFIX is │ │ │ │ │ -00037860: 206f 7074 696f 6e61 6c20 616e 6420 6465 optional and de │ │ │ │ │ -00037870: 6661 756c 7473 0a20 2020 2020 746f 2033 faults. to 3 │ │ │ │ │ -00037880: 3220 666f 7220 4950 7634 2061 6464 7265 2 for IPv4 addre │ │ │ │ │ -00037890: 7373 2061 6e64 2031 3238 2066 6f72 2049 ss and 128 for I │ │ │ │ │ -000378a0: 5076 3620 6164 6472 6573 732e 2020 526f Pv6 address. Ro │ │ │ │ │ -000378b0: 7574 6520 6973 0a20 2020 2020 6964 656e ute is. iden │ │ │ │ │ -000378c0: 7469 6669 6564 2062 7920 5348 4f52 544e tified by SHORTN │ │ │ │ │ -000378d0: 414d 4520 7768 6963 6820 6361 6e20 6265 AME which can be │ │ │ │ │ -000378e0: 2075 7365 6420 746f 2072 656d 6f76 6520 used to remove │ │ │ │ │ -000378f0: 6974 2028 2a6e 6f74 650a 2020 2020 206e it (*note. n │ │ │ │ │ -00037900: 6574 5f64 656c 5f72 6f75 7465 3a3a 292e et_del_route::). │ │ │ │ │ -00037910: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -00037920: 6e66 6f2c 2020 4e6f 6465 3a20 6e65 745f nfo, Node: net_ │ │ │ │ │ -00037930: 626f 6f74 702c 2020 4e65 7874 3a20 6e65 bootp, Next: ne │ │ │ │ │ -00037940: 745f 6465 6c5f 6164 6472 2c20 2050 7265 t_del_addr, Pre │ │ │ │ │ -00037950: 763a 206e 6574 5f61 6464 5f72 6f75 7465 v: net_add_route │ │ │ │ │ -00037960: 2c20 2055 703a 204e 6574 776f 726b 696e , Up: Networkin │ │ │ │ │ -00037970: 6720 636f 6d6d 616e 6473 0a0a 3136 2e34 g commands..16.4 │ │ │ │ │ -00037980: 2e34 206e 6574 5f62 6f6f 7470 0a2d 2d2d .4 net_bootp.--- │ │ │ │ │ -00037990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ -000379a0: 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 745f -- Command: net_ │ │ │ │ │ -000379b0: 626f 6f74 7020 5b43 4152 445d 0a20 2020 bootp [CARD]. │ │ │ │ │ -000379c0: 2020 416c 6961 7320 666f 7220 6e65 745f Alias for net_ │ │ │ │ │ -000379d0: 6468 6370 2c20 666f 7220 636f 6d70 6174 dhcp, for compat │ │ │ │ │ -000379e0: 6962 696c 6974 7920 7769 7468 206f 6c64 ibility with old │ │ │ │ │ -000379f0: 6572 2047 7275 6220 7665 7273 696f 6e73 er Grub versions │ │ │ │ │ -00037a00: 2e0a 2020 2020 2057 696c 6c20 7065 7266 .. Will perf │ │ │ │ │ -00037a10: 6f72 6d20 7468 6520 7361 6d65 2044 4843 orm the same DHC │ │ │ │ │ -00037a20: 5020 6861 6e64 7368 616b 6520 7769 7468 P handshake with │ │ │ │ │ -00037a30: 2070 6f74 656e 7469 616c 2066 616c 6c62 potential fallb │ │ │ │ │ -00037a40: 6163 6b20 746f 0a20 2020 2020 424f 4f54 ack to. BOOT │ │ │ │ │ -00037a50: 5020 6173 2074 6865 206e 6574 5f64 6863 P as the net_dhc │ │ │ │ │ -00037a60: 7020 636f 6d6d 616e 6420 282a 6e6f 7465 p command (*note │ │ │ │ │ -00037a70: 206e 6574 5f64 6863 703a 3a29 2e0a 0a1f net_dhcp::).... │ │ │ │ │ -00037a80: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00037a90: 2c20 204e 6f64 653a 206e 6574 5f64 656c , Node: net_del │ │ │ │ │ -00037aa0: 5f61 6464 722c 2020 4e65 7874 3a20 6e65 _addr, Next: ne │ │ │ │ │ -00037ab0: 745f 6465 6c5f 646e 732c 2020 5072 6576 t_del_dns, Prev │ │ │ │ │ -00037ac0: 3a20 6e65 745f 626f 6f74 702c 2020 5570 : net_bootp, Up │ │ │ │ │ -00037ad0: 3a20 4e65 7477 6f72 6b69 6e67 2063 6f6d : Networking com │ │ │ │ │ -00037ae0: 6d61 6e64 730a 0a31 362e 342e 3520 6e65 mands..16.4.5 ne │ │ │ │ │ -00037af0: 745f 6465 6c5f 6164 6472 0a2d 2d2d 2d2d t_del_addr.----- │ │ │ │ │ -00037b00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ -00037b10: 202d 2d20 436f 6d6d 616e 643a 206e 6574 -- Command: net │ │ │ │ │ -00037b20: 5f64 656c 5f61 6464 7220 494e 5445 5246 _del_addr INTERF │ │ │ │ │ -00037b30: 4143 450a 2020 2020 2052 656d 6f76 6520 ACE. Remove │ │ │ │ │ -00037b40: 636f 6e66 6967 7572 6564 2049 4e54 4552 configured INTER │ │ │ │ │ -00037b50: 4641 4345 2077 6974 6820 6173 736f 6369 FACE with associ │ │ │ │ │ -00037b60: 6174 6564 2061 6464 7265 7373 2e0a 0a1f ated address.... │ │ │ │ │ -00037b70: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00037b80: 2c20 204e 6f64 653a 206e 6574 5f64 656c , Node: net_del │ │ │ │ │ -00037b90: 5f64 6e73 2c20 204e 6578 743a 206e 6574 _dns, Next: net │ │ │ │ │ -00037ba0: 5f64 656c 5f72 6f75 7465 2c20 2050 7265 _del_route, Pre │ │ │ │ │ -00037bb0: 763a 206e 6574 5f64 656c 5f61 6464 722c v: net_del_addr, │ │ │ │ │ -00037bc0: 2020 5570 3a20 4e65 7477 6f72 6b69 6e67 Up: Networking │ │ │ │ │ -00037bd0: 2063 6f6d 6d61 6e64 730a 0a31 362e 342e commands..16.4. │ │ │ │ │ -00037be0: 3620 6e65 745f 6465 6c5f 646e 730a 2d2d 6 net_del_dns.-- │ │ │ │ │ +00037250: 2020 2050 6572 666f 726d 2061 2044 4843 Perform a DHC │ │ │ │ │ +00037260: 5020 6175 746f 636f 6e66 6967 7572 6174 P autoconfigurat │ │ │ │ │ +00037270: 696f 6e0a 2a20 6e65 745f 6765 745f 6468 ion.* net_get_dh │ │ │ │ │ +00037280: 6370 5f6f 7074 696f 6e3a 3a20 2020 2020 cp_option:: │ │ │ │ │ +00037290: 2020 2020 5265 7472 6965 7665 2044 4843 Retrieve DHC │ │ │ │ │ +000372a0: 5020 6f70 7469 6f6e 730a 2a20 6e65 745f P options.* net_ │ │ │ │ │ +000372b0: 6970 7636 5f61 7574 6f63 6f6e 663a 3a20 ipv6_autoconf:: │ │ │ │ │ +000372c0: 2020 2020 2020 2020 2020 5065 7266 6f72 Perfor │ │ │ │ │ +000372d0: 6d20 4950 7636 2061 7574 6f63 6f6e 6669 m IPv6 autoconfi │ │ │ │ │ +000372e0: 6775 7261 7469 6f6e 0a2a 206e 6574 5f6c guration.* net_l │ │ │ │ │ +000372f0: 735f 6164 6472 3a3a 2020 2020 2020 2020 s_addr:: │ │ │ │ │ +00037300: 2020 2020 2020 2020 204c 6973 7420 696e List in │ │ │ │ │ +00037310: 7465 7266 6163 6573 0a2a 206e 6574 5f6c terfaces.* net_l │ │ │ │ │ +00037320: 735f 6361 7264 733a 3a20 2020 2020 2020 s_cards:: │ │ │ │ │ +00037330: 2020 2020 2020 2020 204c 6973 7420 6e65 List ne │ │ │ │ │ +00037340: 7477 6f72 6b20 6361 7264 730a 2a20 6e65 twork cards.* ne │ │ │ │ │ +00037350: 745f 6c73 5f64 6e73 3a3a 2020 2020 2020 t_ls_dns:: │ │ │ │ │ +00037360: 2020 2020 2020 2020 2020 2020 4c69 7374 List │ │ │ │ │ +00037370: 2044 4e53 2073 6572 7665 7273 0a2a 206e DNS servers.* n │ │ │ │ │ +00037380: 6574 5f6c 735f 726f 7574 6573 3a3a 2020 et_ls_routes:: │ │ │ │ │ +00037390: 2020 2020 2020 2020 2020 2020 204c 6973 Lis │ │ │ │ │ +000373a0: 7420 726f 7574 696e 6720 656e 7472 6965 t routing entrie │ │ │ │ │ +000373b0: 730a 2a20 6e65 745f 6e73 6c6f 6f6b 7570 s.* net_nslookup │ │ │ │ │ +000373c0: 3a3a 2020 2020 2020 2020 2020 2020 2020 :: │ │ │ │ │ +000373d0: 2020 5065 7266 6f72 6d20 6120 444e 5320 Perform a DNS │ │ │ │ │ +000373e0: 6c6f 6f6b 7570 0a0a 1f0a 4669 6c65 3a20 lookup....File: │ │ │ │ │ +000373f0: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00037400: 3a20 6e65 745f 6164 645f 6164 6472 2c20 : net_add_addr, │ │ │ │ │ +00037410: 204e 6578 743a 206e 6574 5f61 6464 5f64 Next: net_add_d │ │ │ │ │ +00037420: 6e73 2c20 2055 703a 204e 6574 776f 726b ns, Up: Network │ │ │ │ │ +00037430: 696e 6720 636f 6d6d 616e 6473 0a0a 3136 ing commands..16 │ │ │ │ │ +00037440: 2e34 2e31 206e 6574 5f61 6464 5f61 6464 .4.1 net_add_add │ │ │ │ │ +00037450: 720a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d r.-------------- │ │ │ │ │ +00037460: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ +00037470: 6e64 3a20 6e65 745f 6164 645f 6164 6472 nd: net_add_addr │ │ │ │ │ +00037480: 2049 4e54 4552 4641 4345 2043 4152 4420 INTERFACE CARD │ │ │ │ │ +00037490: 4144 4452 4553 530a 2020 2020 2043 6f6e ADDRESS. Con │ │ │ │ │ +000374a0: 6669 6775 7265 2061 6464 6974 696f 6e61 figure additiona │ │ │ │ │ +000374b0: 6c20 6e65 7477 6f72 6b20 494e 5445 5246 l network INTERF │ │ │ │ │ +000374c0: 4143 4520 7769 7468 2041 4444 5245 5353 ACE with ADDRESS │ │ │ │ │ +000374d0: 206f 6e20 6120 6e65 7477 6f72 6b0a 2020 on a network. │ │ │ │ │ +000374e0: 2020 2043 4152 442e 2020 4144 4452 4553 CARD. ADDRES │ │ │ │ │ +000374f0: 5320 6361 6e20 6265 2065 6974 6865 7220 S can be either │ │ │ │ │ +00037500: 4950 2069 6e20 646f 7474 6564 2064 6563 IP in dotted dec │ │ │ │ │ +00037510: 696d 616c 206e 6f74 6174 696f 6e2c 206f imal notation, o │ │ │ │ │ +00037520: 720a 2020 2020 2073 796d 626f 6c69 6320 r. symbolic │ │ │ │ │ +00037530: 6e61 6d65 2077 6869 6368 2069 7320 7265 name which is re │ │ │ │ │ +00037540: 736f 6c76 6564 2075 7369 6e67 2044 4e53 solved using DNS │ │ │ │ │ +00037550: 206c 6f6f 6b75 702e 2020 4966 2073 7563 lookup. If suc │ │ │ │ │ +00037560: 6365 7373 6675 6c2c 0a20 2020 2020 7468 cessful,. th │ │ │ │ │ +00037570: 6973 2063 6f6d 6d61 6e64 2061 6c73 6f20 is command also │ │ │ │ │ +00037580: 6164 6473 206c 6f63 616c 206c 696e 6b20 adds local link │ │ │ │ │ +00037590: 726f 7574 696e 6720 656e 7472 7920 746f routing entry to │ │ │ │ │ +000375a0: 2074 6865 2064 6566 6175 6c74 0a20 2020 the default. │ │ │ │ │ +000375b0: 2020 7375 626e 6574 206f 6620 4144 4452 subnet of ADDR │ │ │ │ │ +000375c0: 4553 5320 7769 7468 206e 616d 6520 494e ESS with name IN │ │ │ │ │ +000375d0: 5445 5246 4143 4527 3a6c 6f63 616c 2720 TERFACE':local' │ │ │ │ │ +000375e0: 7669 6120 494e 5445 5246 4143 452e 0a0a via INTERFACE... │ │ │ │ │ +000375f0: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +00037600: 6f2c 2020 4e6f 6465 3a20 6e65 745f 6164 o, Node: net_ad │ │ │ │ │ +00037610: 645f 646e 732c 2020 4e65 7874 3a20 6e65 d_dns, Next: ne │ │ │ │ │ +00037620: 745f 6164 645f 726f 7574 652c 2020 5072 t_add_route, Pr │ │ │ │ │ +00037630: 6576 3a20 6e65 745f 6164 645f 6164 6472 ev: net_add_addr │ │ │ │ │ +00037640: 2c20 2055 703a 204e 6574 776f 726b 696e , Up: Networkin │ │ │ │ │ +00037650: 6720 636f 6d6d 616e 6473 0a0a 3136 2e34 g commands..16.4 │ │ │ │ │ +00037660: 2e32 206e 6574 5f61 6464 5f64 6e73 0a2d .2 net_add_dns.- │ │ │ │ │ +00037670: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00037680: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00037690: 6e65 745f 6164 645f 646e 7320 5345 5256 net_add_dns SERV │ │ │ │ │ +000376a0: 4552 0a20 2020 2020 5265 736f 6c76 6520 ER. Resolve │ │ │ │ │ +000376b0: 5345 5256 4552 2049 5020 6164 6472 6573 SERVER IP addres │ │ │ │ │ +000376c0: 7320 616e 6420 6164 6420 746f 2074 6865 s and add to the │ │ │ │ │ +000376d0: 206c 6973 7420 6f66 2044 4e53 2073 6572 list of DNS ser │ │ │ │ │ +000376e0: 7665 7273 2075 7365 640a 2020 2020 2064 vers used. d │ │ │ │ │ +000376f0: 7572 696e 6720 6e61 6d65 206c 6f6f 6b75 uring name looku │ │ │ │ │ +00037700: 702e 0a0a 1f0a 4669 6c65 3a20 6772 7562 p.....File: grub │ │ │ │ │ +00037710: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e65 .info, Node: ne │ │ │ │ │ +00037720: 745f 6164 645f 726f 7574 652c 2020 4e65 t_add_route, Ne │ │ │ │ │ +00037730: 7874 3a20 6e65 745f 626f 6f74 702c 2020 xt: net_bootp, │ │ │ │ │ +00037740: 5072 6576 3a20 6e65 745f 6164 645f 646e Prev: net_add_dn │ │ │ │ │ +00037750: 732c 2020 5570 3a20 4e65 7477 6f72 6b69 s, Up: Networki │ │ │ │ │ +00037760: 6e67 2063 6f6d 6d61 6e64 730a 0a31 362e ng commands..16. │ │ │ │ │ +00037770: 342e 3320 6e65 745f 6164 645f 726f 7574 4.3 net_add_rout │ │ │ │ │ +00037780: 650a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d e.-------------- │ │ │ │ │ +00037790: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +000377a0: 616e 643a 206e 6574 5f61 6464 5f72 6f75 and: net_add_rou │ │ │ │ │ +000377b0: 7465 2053 484f 5254 4e41 4d45 2049 505b te SHORTNAME IP[ │ │ │ │ │ +000377c0: 2f50 5245 4649 585d 205b 494e 5445 5246 /PREFIX] [INTERF │ │ │ │ │ +000377d0: 4143 4520 7c20 6777 0a20 2020 2020 2020 ACE | gw. │ │ │ │ │ +000377e0: 2020 2047 4154 4557 4159 5d0a 2020 2020 GATEWAY]. │ │ │ │ │ +000377f0: 2041 6464 2072 6f75 7465 2074 6f20 6e65 Add route to ne │ │ │ │ │ +00037800: 7477 6f72 6b20 7769 7468 2061 6464 7265 twork with addre │ │ │ │ │ +00037810: 7373 2049 5020 6173 206d 6f64 6966 6965 ss IP as modifie │ │ │ │ │ +00037820: 6420 6279 2050 5245 4649 5820 7669 610a d by PREFIX via. │ │ │ │ │ +00037830: 2020 2020 2065 6974 6865 7220 6c6f 6361 either loca │ │ │ │ │ +00037840: 6c20 494e 5445 5246 4143 4520 6f72 2047 l INTERFACE or G │ │ │ │ │ +00037850: 4154 4557 4159 2e20 2050 5245 4649 5820 ATEWAY. PREFIX │ │ │ │ │ +00037860: 6973 206f 7074 696f 6e61 6c20 616e 6420 is optional and │ │ │ │ │ +00037870: 6465 6661 756c 7473 0a20 2020 2020 746f defaults. to │ │ │ │ │ +00037880: 2033 3220 666f 7220 4950 7634 2061 6464 32 for IPv4 add │ │ │ │ │ +00037890: 7265 7373 2061 6e64 2031 3238 2066 6f72 ress and 128 for │ │ │ │ │ +000378a0: 2049 5076 3620 6164 6472 6573 732e 2020 IPv6 address. │ │ │ │ │ +000378b0: 526f 7574 6520 6973 0a20 2020 2020 6964 Route is. id │ │ │ │ │ +000378c0: 656e 7469 6669 6564 2062 7920 5348 4f52 entified by SHOR │ │ │ │ │ +000378d0: 544e 414d 4520 7768 6963 6820 6361 6e20 TNAME which can │ │ │ │ │ +000378e0: 6265 2075 7365 6420 746f 2072 656d 6f76 be used to remov │ │ │ │ │ +000378f0: 6520 6974 2028 2a6e 6f74 650a 2020 2020 e it (*note. │ │ │ │ │ +00037900: 206e 6574 5f64 656c 5f72 6f75 7465 3a3a net_del_route:: │ │ │ │ │ +00037910: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ │ +00037920: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 6e65 .info, Node: ne │ │ │ │ │ +00037930: 745f 626f 6f74 702c 2020 4e65 7874 3a20 t_bootp, Next: │ │ │ │ │ +00037940: 6e65 745f 6465 6c5f 6164 6472 2c20 2050 net_del_addr, P │ │ │ │ │ +00037950: 7265 763a 206e 6574 5f61 6464 5f72 6f75 rev: net_add_rou │ │ │ │ │ +00037960: 7465 2c20 2055 703a 204e 6574 776f 726b te, Up: Network │ │ │ │ │ +00037970: 696e 6720 636f 6d6d 616e 6473 0a0a 3136 ing commands..16 │ │ │ │ │ +00037980: 2e34 2e34 206e 6574 5f62 6f6f 7470 0a2d .4.4 net_bootp.- │ │ │ │ │ +00037990: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ +000379a0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 . -- Command: ne │ │ │ │ │ +000379b0: 745f 626f 6f74 7020 5b43 4152 445d 0a20 t_bootp [CARD]. │ │ │ │ │ +000379c0: 2020 2020 416c 6961 7320 666f 7220 6e65 Alias for ne │ │ │ │ │ +000379d0: 745f 6468 6370 2c20 666f 7220 636f 6d70 t_dhcp, for comp │ │ │ │ │ +000379e0: 6174 6962 696c 6974 7920 7769 7468 206f atibility with o │ │ │ │ │ +000379f0: 6c64 6572 2047 7275 6220 7665 7273 696f lder Grub versio │ │ │ │ │ +00037a00: 6e73 2e0a 2020 2020 2057 696c 6c20 7065 ns.. Will pe │ │ │ │ │ +00037a10: 7266 6f72 6d20 7468 6520 7361 6d65 2044 rform the same D │ │ │ │ │ +00037a20: 4843 5020 6861 6e64 7368 616b 6520 7769 HCP handshake wi │ │ │ │ │ +00037a30: 7468 2070 6f74 656e 7469 616c 2066 616c th potential fal │ │ │ │ │ +00037a40: 6c62 6163 6b20 746f 0a20 2020 2020 424f lback to. BO │ │ │ │ │ +00037a50: 4f54 5020 6173 2074 6865 206e 6574 5f64 OTP as the net_d │ │ │ │ │ +00037a60: 6863 7020 636f 6d6d 616e 6420 282a 6e6f hcp command (*no │ │ │ │ │ +00037a70: 7465 206e 6574 5f64 6863 703a 3a29 2e0a te net_dhcp::).. │ │ │ │ │ +00037a80: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00037a90: 666f 2c20 204e 6f64 653a 206e 6574 5f64 fo, Node: net_d │ │ │ │ │ +00037aa0: 656c 5f61 6464 722c 2020 4e65 7874 3a20 el_addr, Next: │ │ │ │ │ +00037ab0: 6e65 745f 6465 6c5f 646e 732c 2020 5072 net_del_dns, Pr │ │ │ │ │ +00037ac0: 6576 3a20 6e65 745f 626f 6f74 702c 2020 ev: net_bootp, │ │ │ │ │ +00037ad0: 5570 3a20 4e65 7477 6f72 6b69 6e67 2063 Up: Networking c │ │ │ │ │ +00037ae0: 6f6d 6d61 6e64 730a 0a31 362e 342e 3520 ommands..16.4.5 │ │ │ │ │ +00037af0: 6e65 745f 6465 6c5f 6164 6472 0a2d 2d2d net_del_addr.--- │ │ │ │ │ +00037b00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ +00037b10: 0a0a 202d 2d20 436f 6d6d 616e 643a 206e .. -- Command: n │ │ │ │ │ +00037b20: 6574 5f64 656c 5f61 6464 7220 494e 5445 et_del_addr INTE │ │ │ │ │ +00037b30: 5246 4143 450a 2020 2020 2052 656d 6f76 RFACE. Remov │ │ │ │ │ +00037b40: 6520 636f 6e66 6967 7572 6564 2049 4e54 e configured INT │ │ │ │ │ +00037b50: 4552 4641 4345 2077 6974 6820 6173 736f ERFACE with asso │ │ │ │ │ +00037b60: 6369 6174 6564 2061 6464 7265 7373 2e0a ciated address.. │ │ │ │ │ +00037b70: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00037b80: 666f 2c20 204e 6f64 653a 206e 6574 5f64 fo, Node: net_d │ │ │ │ │ +00037b90: 656c 5f64 6e73 2c20 204e 6578 743a 206e el_dns, Next: n │ │ │ │ │ +00037ba0: 6574 5f64 656c 5f72 6f75 7465 2c20 2050 et_del_route, P │ │ │ │ │ +00037bb0: 7265 763a 206e 6574 5f64 656c 5f61 6464 rev: net_del_add │ │ │ │ │ +00037bc0: 722c 2020 5570 3a20 4e65 7477 6f72 6b69 r, Up: Networki │ │ │ │ │ +00037bd0: 6e67 2063 6f6d 6d61 6e64 730a 0a31 362e ng commands..16. │ │ │ │ │ +00037be0: 342e 3620 6e65 745f 6465 6c5f 646e 730a 4.6 net_del_dns. │ │ │ │ │ 00037bf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00037c00: 0a0a 202d 2d20 436f 6d6d 616e 643a 206e .. -- Command: n │ │ │ │ │ -00037c10: 6574 5f64 656c 5f64 6e73 2041 4444 5245 et_del_dns ADDRE │ │ │ │ │ -00037c20: 5353 0a20 2020 2020 5265 6d6f 7665 2041 SS. Remove A │ │ │ │ │ -00037c30: 4444 5245 5353 2066 726f 6d20 6c69 7374 DDRESS from list │ │ │ │ │ -00037c40: 206f 6620 7365 7276 6572 7320 7573 6564 of servers used │ │ │ │ │ -00037c50: 2064 7572 696e 6720 6e61 6d65 206c 6f6f during name loo │ │ │ │ │ -00037c60: 6b75 702e 0a0a 1f0a 4669 6c65 3a20 6772 kup.....File: gr │ │ │ │ │ -00037c70: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00037c80: 6e65 745f 6465 6c5f 726f 7574 652c 2020 net_del_route, │ │ │ │ │ -00037c90: 4e65 7874 3a20 6e65 745f 6468 6370 2c20 Next: net_dhcp, │ │ │ │ │ -00037ca0: 2050 7265 763a 206e 6574 5f64 656c 5f64 Prev: net_del_d │ │ │ │ │ -00037cb0: 6e73 2c20 2055 703a 204e 6574 776f 726b ns, Up: Network │ │ │ │ │ -00037cc0: 696e 6720 636f 6d6d 616e 6473 0a0a 3136 ing commands..16 │ │ │ │ │ -00037cd0: 2e34 2e37 206e 6574 5f64 656c 5f72 6f75 .4.7 net_del_rou │ │ │ │ │ -00037ce0: 7465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d te.------------- │ │ │ │ │ -00037cf0: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ -00037d00: 6d61 6e64 3a20 6e65 745f 6465 6c5f 726f mand: net_del_ro │ │ │ │ │ -00037d10: 7574 6520 5348 4f52 544e 414d 450a 2020 ute SHORTNAME. │ │ │ │ │ -00037d20: 2020 2052 656d 6f76 6520 726f 7574 6520 Remove route │ │ │ │ │ -00037d30: 656e 7472 7920 6964 656e 7469 6669 6564 entry identified │ │ │ │ │ -00037d40: 2062 7920 5348 4f52 544e 414d 452e 0a0a by SHORTNAME... │ │ │ │ │ -00037d50: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ -00037d60: 6f2c 2020 4e6f 6465 3a20 6e65 745f 6468 o, Node: net_dh │ │ │ │ │ -00037d70: 6370 2c20 204e 6578 743a 206e 6574 5f67 cp, Next: net_g │ │ │ │ │ -00037d80: 6574 5f64 6863 705f 6f70 7469 6f6e 2c20 et_dhcp_option, │ │ │ │ │ -00037d90: 2050 7265 763a 206e 6574 5f64 656c 5f72 Prev: net_del_r │ │ │ │ │ -00037da0: 6f75 7465 2c20 2055 703a 204e 6574 776f oute, Up: Netwo │ │ │ │ │ -00037db0: 726b 696e 6720 636f 6d6d 616e 6473 0a0a rking commands.. │ │ │ │ │ -00037dc0: 3136 2e34 2e38 206e 6574 5f64 6863 700a 16.4.8 net_dhcp. │ │ │ │ │ -00037dd0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a ---------------. │ │ │ │ │ -00037de0: 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 . -- Command: ne │ │ │ │ │ -00037df0: 745f 6468 6370 205b 4341 5244 5d0a 2020 t_dhcp [CARD]. │ │ │ │ │ -00037e00: 2020 2050 6572 666f 726d 2063 6f6e 6669 Perform confi │ │ │ │ │ -00037e10: 6775 7261 7469 6f6e 206f 6620 4341 5244 guration of CARD │ │ │ │ │ -00037e20: 2075 7369 6e67 2044 4843 5020 7072 6f74 using DHCP prot │ │ │ │ │ -00037e30: 6f63 6f6c 2e20 2049 6620 6e6f 2063 6172 ocol. If no car │ │ │ │ │ -00037e40: 6420 6e61 6d65 0a20 2020 2020 6973 2073 d name. is s │ │ │ │ │ -00037e50: 7065 6369 6669 6564 2c20 7472 7920 746f pecified, try to │ │ │ │ │ -00037e60: 2063 6f6e 6669 6775 7265 2061 6c6c 2065 configure all e │ │ │ │ │ -00037e70: 7869 7374 696e 6720 6361 7264 732e 2020 xisting cards. │ │ │ │ │ -00037e80: 4661 6c6c 7320 6261 636b 2074 6f0a 2020 Falls back to. │ │ │ │ │ -00037e90: 2020 2074 6865 2042 4f4f 5450 2070 726f the BOOTP pro │ │ │ │ │ -00037ea0: 746f 636f 6c2c 2069 6620 6e65 6564 6564 tocol, if needed │ │ │ │ │ -00037eb0: 2e20 2049 6620 636f 6e66 6967 7572 6174 . If configurat │ │ │ │ │ -00037ec0: 696f 6e20 7761 7320 7375 6363 6573 7366 ion was successf │ │ │ │ │ -00037ed0: 756c 2c0a 2020 2020 2069 6e74 6572 6661 ul,. interfa │ │ │ │ │ -00037ee0: 6365 2077 6974 6820 6e61 6d65 2043 4152 ce with name CAR │ │ │ │ │ -00037ef0: 4427 3a64 6863 7027 2061 6e64 2063 6f6e D':dhcp' and con │ │ │ │ │ -00037f00: 6669 6775 7265 6420 6164 6472 6573 7320 figured address │ │ │ │ │ -00037f10: 6973 2061 6464 6564 2074 6f0a 2020 2020 is added to. │ │ │ │ │ -00037f20: 2043 4152 442e 2020 4164 6469 7469 6f6e CARD. Addition │ │ │ │ │ -00037f30: 616c 6c79 2074 6865 2066 6f6c 6c6f 7769 ally the followi │ │ │ │ │ -00037f40: 6e67 2044 4843 5020 6f70 7469 6f6e 7320 ng DHCP options │ │ │ │ │ -00037f50: 6172 6520 7265 636f 676e 697a 6564 2061 are recognized a │ │ │ │ │ -00037f60: 6e64 0a20 2020 2020 7072 6f63 6573 7365 nd. processe │ │ │ │ │ -00037f70: 643a 0a0a 2020 2020 2027 3120 2853 7562 d:.. '1 (Sub │ │ │ │ │ -00037f80: 6e65 7420 4d61 736b 2927 0a20 2020 2020 net Mask)'. │ │ │ │ │ -00037f90: 2020 2020 2055 7365 6420 746f 2063 616c Used to cal │ │ │ │ │ -00037fa0: 6375 6c61 7465 206e 6574 776f 726b 206c culate network l │ │ │ │ │ -00037fb0: 6f63 616c 2072 6f75 7469 6e67 2065 6e74 ocal routing ent │ │ │ │ │ -00037fc0: 7279 2066 6f72 2069 6e74 6572 6661 6365 ry for interface │ │ │ │ │ -00037fd0: 0a20 2020 2020 2020 2020 2043 4152 4427 . CARD' │ │ │ │ │ -00037fe0: 3a64 6863 7027 2e0a 2020 2020 2027 3320 :dhcp'.. '3 │ │ │ │ │ -00037ff0: 2852 6f75 7465 7229 270a 2020 2020 2020 (Router)'. │ │ │ │ │ -00038000: 2020 2020 4164 6473 2064 6566 6175 6c74 Adds default │ │ │ │ │ -00038010: 2072 6f75 7465 2065 6e74 7279 2077 6974 route entry wit │ │ │ │ │ -00038020: 6820 7468 6520 6e61 6d65 2043 4152 4427 h the name CARD' │ │ │ │ │ -00038030: 3a64 6863 703a 6465 6661 756c 7427 2076 :dhcp:default' v │ │ │ │ │ -00038040: 6961 0a20 2020 2020 2020 2020 2067 6174 ia. gat │ │ │ │ │ -00038050: 6577 6179 2066 726f 6d20 4448 4350 206f eway from DHCP o │ │ │ │ │ -00038060: 7074 696f 6e2e 2020 4e6f 7465 2074 6861 ption. Note tha │ │ │ │ │ -00038070: 7420 6f6e 6c79 206f 7074 696f 6e20 7769 t only option wi │ │ │ │ │ -00038080: 7468 2073 696e 676c 650a 2020 2020 2020 th single. │ │ │ │ │ -00038090: 2020 2020 726f 7574 6520 6973 2061 6363 route is acc │ │ │ │ │ -000380a0: 6570 7465 642e 0a20 2020 2020 2736 2028 epted.. '6 ( │ │ │ │ │ -000380b0: 446f 6d61 696e 204e 616d 6520 5365 7276 Domain Name Serv │ │ │ │ │ -000380c0: 6572 2927 0a20 2020 2020 2020 2020 2041 er)'. A │ │ │ │ │ -000380d0: 6464 7320 616c 6c20 7365 7276 6572 7320 dds all servers │ │ │ │ │ -000380e0: 6672 6f6d 206f 7074 696f 6e20 7661 6c75 from option valu │ │ │ │ │ -000380f0: 6520 746f 2074 6865 206c 6973 7420 6f66 e to the list of │ │ │ │ │ -00038100: 2073 6572 7665 7273 2075 7365 640a 2020 servers used. │ │ │ │ │ -00038110: 2020 2020 2020 2020 6475 7269 6e67 206e during n │ │ │ │ │ -00038120: 616d 6520 7265 736f 6c75 7469 6f6e 2e0a ame resolution.. │ │ │ │ │ -00038130: 2020 2020 2027 3132 2028 486f 7374 204e '12 (Host N │ │ │ │ │ -00038140: 616d 6529 270a 2020 2020 2020 2020 2020 ame)'. │ │ │ │ │ -00038150: 5365 7473 2065 6e76 6972 6f6e 6d65 6e74 Sets environment │ │ │ │ │ -00038160: 2076 6172 6961 626c 6520 276e 6574 5f27 variable 'net_' │ │ │ │ │ -00038170: 3c43 4152 443e 275f 6468 6370 5f68 6f73 '_dhcp_hos │ │ │ │ │ -00038180: 746e 616d 6527 2028 2a6e 6f74 650a 2020 tname' (*note. │ │ │ │ │ -00038190: 2020 2020 2020 2020 6e65 745f 3c49 4e54 net__hostname │ │ │ │ │ -000381b0: 3a3a 2920 746f 2074 6865 2076 616c 7565 ::) to the value │ │ │ │ │ -000381c0: 206f 6620 6f70 7469 6f6e 2e0a 2020 2020 of option.. │ │ │ │ │ -000381d0: 2027 3135 2028 446f 6d61 696e 204e 616d '15 (Domain Nam │ │ │ │ │ -000381e0: 6529 270a 2020 2020 2020 2020 2020 5365 e)'. Se │ │ │ │ │ -000381f0: 7473 2065 6e76 6972 6f6e 6d65 6e74 2076 ts environment v │ │ │ │ │ -00038200: 6172 6961 626c 6520 276e 6574 5f27 3c43 ariable 'net_''_dhcp_domai │ │ │ │ │ -00038220: 6e27 2028 2a6e 6f74 650a 2020 2020 2020 n' (*note. │ │ │ │ │ -00038230: 2020 2020 6e65 745f 3c49 4e54 4552 4641 net__domain::) to │ │ │ │ │ -00038250: 2074 6865 2076 616c 7565 206f 6620 6f70 the value of op │ │ │ │ │ -00038260: 7469 6f6e 2e0a 2020 2020 2027 3137 2028 tion.. '17 ( │ │ │ │ │ -00038270: 526f 6f74 2050 6174 6829 270a 2020 2020 Root Path)'. │ │ │ │ │ -00038280: 2020 2020 2020 5365 7473 2065 6e76 6972 Sets envir │ │ │ │ │ -00038290: 6f6e 6d65 6e74 2076 6172 6961 626c 6520 onment variable │ │ │ │ │ -000382a0: 276e 6574 5f27 3c43 4152 443e 275f 6468 'net_''_dh │ │ │ │ │ -000382b0: 6370 5f72 6f6f 7470 6174 6827 2028 2a6e cp_rootpath' (*n │ │ │ │ │ -000382c0: 6f74 650a 2020 2020 2020 2020 2020 6e65 ote. ne │ │ │ │ │ -000382d0: 745f 3c49 4e54 4552 4641 4345 3e5f 726f t__ro │ │ │ │ │ -000382e0: 6f74 7061 7468 3a3a 2920 746f 2074 6865 otpath::) to the │ │ │ │ │ -000382f0: 2076 616c 7565 206f 6620 6f70 7469 6f6e value of option │ │ │ │ │ -00038300: 2e0a 2020 2020 2027 3138 2028 4578 7465 .. '18 (Exte │ │ │ │ │ -00038310: 6e73 696f 6e73 2050 6174 6829 270a 2020 nsions Path)'. │ │ │ │ │ -00038320: 2020 2020 2020 2020 5365 7473 2065 6e76 Sets env │ │ │ │ │ -00038330: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ -00038340: 6520 276e 6574 5f27 3c43 4152 443e 275f e 'net_''_ │ │ │ │ │ -00038350: 6468 6370 5f65 7874 656e 7369 6f6e 7370 dhcp_extensionsp │ │ │ │ │ -00038360: 6174 6827 0a20 2020 2020 2020 2020 2028 ath'. ( │ │ │ │ │ -00038370: 2a6e 6f74 6520 6e65 745f 3c49 4e54 4552 *note net__extensions │ │ │ │ │ -00038390: 7061 7468 3a3a 2920 746f 2074 6865 2076 path::) to the v │ │ │ │ │ -000383a0: 616c 7565 206f 660a 2020 2020 2020 2020 alue of. │ │ │ │ │ -000383b0: 2020 6f70 7469 6f6e 2e0a 2020 2020 2027 option.. ' │ │ │ │ │ -000383c0: 3636 2028 5446 5450 2053 6572 7665 7220 66 (TFTP Server │ │ │ │ │ -000383d0: 4e61 6d65 2927 0a20 2020 2020 2020 2020 Name)'. │ │ │ │ │ -000383e0: 2053 6574 7320 656e 7669 726f 6e6d 656e Sets environmen │ │ │ │ │ -000383f0: 7420 7661 7269 6162 6c65 2027 6e65 745f t variable 'net_ │ │ │ │ │ -00038400: 273c 4341 5244 3e27 5f64 6863 705f 7365 ''_dhcp_se │ │ │ │ │ -00038410: 7276 6572 5f6e 616d 6527 0a20 2020 2020 rver_name'. │ │ │ │ │ -00038420: 2020 2020 2028 2a6e 6f74 6520 6e65 745f (*note net_ │ │ │ │ │ -00038430: 3c49 4e54 4552 4641 4345 3e5f 6468 6370 _dhcp │ │ │ │ │ -00038440: 5f73 6572 7665 725f 6e61 6d65 3a3a 2920 _server_name::) │ │ │ │ │ -00038450: 746f 2074 6865 2076 616c 7565 206f 660a to the value of. │ │ │ │ │ -00038460: 2020 2020 2020 2020 2020 6f70 7469 6f6e option │ │ │ │ │ -00038470: 2e0a 2020 2020 2027 3637 2028 4669 6c65 .. '67 (File │ │ │ │ │ -00038480: 6e61 6d65 2927 0a20 2020 2020 2020 2020 name)'. │ │ │ │ │ -00038490: 2053 6574 7320 656e 7669 726f 6e6d 656e Sets environmen │ │ │ │ │ -000384a0: 7420 7661 7269 6162 6c65 2027 6e65 745f t variable 'net_ │ │ │ │ │ -000384b0: 273c 4341 5244 3e27 5f62 6f6f 745f 6669 ''_boot_fi │ │ │ │ │ -000384c0: 6c65 2720 282a 6e6f 7465 0a20 2020 2020 le' (*note. │ │ │ │ │ -000384d0: 2020 2020 206e 6574 5f3c 494e 5445 5246 net__boot_file:: │ │ │ │ │ -000384f0: 2920 746f 2074 6865 2076 616c 7565 206f ) to the value o │ │ │ │ │ -00038500: 6620 6f70 7469 6f6e 2e0a 0a1f 0a46 696c f option.....Fil │ │ │ │ │ -00038510: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00038520: 6f64 653a 206e 6574 5f67 6574 5f64 6863 ode: net_get_dhc │ │ │ │ │ -00038530: 705f 6f70 7469 6f6e 2c20 204e 6578 743a p_option, Next: │ │ │ │ │ -00038540: 206e 6574 5f69 7076 365f 6175 746f 636f net_ipv6_autoco │ │ │ │ │ -00038550: 6e66 2c20 2050 7265 763a 206e 6574 5f64 nf, Prev: net_d │ │ │ │ │ -00038560: 6863 702c 2020 5570 3a20 4e65 7477 6f72 hcp, Up: Networ │ │ │ │ │ -00038570: 6b69 6e67 2063 6f6d 6d61 6e64 730a 0a31 king commands..1 │ │ │ │ │ -00038580: 362e 342e 3920 6e65 745f 6765 745f 6468 6.4.9 net_get_dh │ │ │ │ │ -00038590: 6370 5f6f 7074 696f 6e0a 2d2d 2d2d 2d2d cp_option.------ │ │ │ │ │ +00037c00: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ +00037c10: 206e 6574 5f64 656c 5f64 6e73 2041 4444 net_del_dns ADD │ │ │ │ │ +00037c20: 5245 5353 0a20 2020 2020 5265 6d6f 7665 RESS. Remove │ │ │ │ │ +00037c30: 2041 4444 5245 5353 2066 726f 6d20 6c69 ADDRESS from li │ │ │ │ │ +00037c40: 7374 206f 6620 7365 7276 6572 7320 7573 st of servers us │ │ │ │ │ +00037c50: 6564 2064 7572 696e 6720 6e61 6d65 206c ed during name l │ │ │ │ │ +00037c60: 6f6f 6b75 702e 0a0a 1f0a 4669 6c65 3a20 ookup.....File: │ │ │ │ │ +00037c70: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00037c80: 3a20 6e65 745f 6465 6c5f 726f 7574 652c : net_del_route, │ │ │ │ │ +00037c90: 2020 4e65 7874 3a20 6e65 745f 6468 6370 Next: net_dhcp │ │ │ │ │ +00037ca0: 2c20 2050 7265 763a 206e 6574 5f64 656c , Prev: net_del │ │ │ │ │ +00037cb0: 5f64 6e73 2c20 2055 703a 204e 6574 776f _dns, Up: Netwo │ │ │ │ │ +00037cc0: 726b 696e 6720 636f 6d6d 616e 6473 0a0a rking commands.. │ │ │ │ │ +00037cd0: 3136 2e34 2e37 206e 6574 5f64 656c 5f72 16.4.7 net_del_r │ │ │ │ │ +00037ce0: 6f75 7465 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d oute.----------- │ │ │ │ │ +00037cf0: 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 ---------.. -- C │ │ │ │ │ +00037d00: 6f6d 6d61 6e64 3a20 6e65 745f 6465 6c5f ommand: net_del_ │ │ │ │ │ +00037d10: 726f 7574 6520 5348 4f52 544e 414d 450a route SHORTNAME. │ │ │ │ │ +00037d20: 2020 2020 2052 656d 6f76 6520 726f 7574 Remove rout │ │ │ │ │ +00037d30: 6520 656e 7472 7920 6964 656e 7469 6669 e entry identifi │ │ │ │ │ +00037d40: 6564 2062 7920 5348 4f52 544e 414d 452e ed by SHORTNAME. │ │ │ │ │ +00037d50: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ +00037d60: 6e66 6f2c 2020 4e6f 6465 3a20 6e65 745f nfo, Node: net_ │ │ │ │ │ +00037d70: 6468 6370 2c20 204e 6578 743a 206e 6574 dhcp, Next: net │ │ │ │ │ +00037d80: 5f67 6574 5f64 6863 705f 6f70 7469 6f6e _get_dhcp_option │ │ │ │ │ +00037d90: 2c20 2050 7265 763a 206e 6574 5f64 656c , Prev: net_del │ │ │ │ │ +00037da0: 5f72 6f75 7465 2c20 2055 703a 204e 6574 _route, Up: Net │ │ │ │ │ +00037db0: 776f 726b 696e 6720 636f 6d6d 616e 6473 working commands │ │ │ │ │ +00037dc0: 0a0a 3136 2e34 2e38 206e 6574 5f64 6863 ..16.4.8 net_dhc │ │ │ │ │ +00037dd0: 700a 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d p.-------------- │ │ │ │ │ +00037de0: 2d0a 0a20 2d2d 2043 6f6d 6d61 6e64 3a20 -.. -- Command: │ │ │ │ │ +00037df0: 6e65 745f 6468 6370 205b 4341 5244 5d0a net_dhcp [CARD]. │ │ │ │ │ +00037e00: 2020 2020 2050 6572 666f 726d 2063 6f6e Perform con │ │ │ │ │ +00037e10: 6669 6775 7261 7469 6f6e 206f 6620 4341 figuration of CA │ │ │ │ │ +00037e20: 5244 2075 7369 6e67 2044 4843 5020 7072 RD using DHCP pr │ │ │ │ │ +00037e30: 6f74 6f63 6f6c 2e20 2049 6620 6e6f 2063 otocol. If no c │ │ │ │ │ +00037e40: 6172 6420 6e61 6d65 0a20 2020 2020 6973 ard name. is │ │ │ │ │ +00037e50: 2073 7065 6369 6669 6564 2c20 7472 7920 specified, try │ │ │ │ │ +00037e60: 746f 2063 6f6e 6669 6775 7265 2061 6c6c to configure all │ │ │ │ │ +00037e70: 2065 7869 7374 696e 6720 6361 7264 732e existing cards. │ │ │ │ │ +00037e80: 2020 4661 6c6c 7320 6261 636b 2074 6f0a Falls back to. │ │ │ │ │ +00037e90: 2020 2020 2074 6865 2042 4f4f 5450 2070 the BOOTP p │ │ │ │ │ +00037ea0: 726f 746f 636f 6c2c 2069 6620 6e65 6564 rotocol, if need │ │ │ │ │ +00037eb0: 6564 2e20 2049 6620 636f 6e66 6967 7572 ed. If configur │ │ │ │ │ +00037ec0: 6174 696f 6e20 7761 7320 7375 6363 6573 ation was succes │ │ │ │ │ +00037ed0: 7366 756c 2c0a 2020 2020 2069 6e74 6572 sful,. inter │ │ │ │ │ +00037ee0: 6661 6365 2077 6974 6820 6e61 6d65 2043 face with name C │ │ │ │ │ +00037ef0: 4152 4427 3a64 6863 7027 2061 6e64 2063 ARD':dhcp' and c │ │ │ │ │ +00037f00: 6f6e 6669 6775 7265 6420 6164 6472 6573 onfigured addres │ │ │ │ │ +00037f10: 7320 6973 2061 6464 6564 2074 6f0a 2020 s is added to. │ │ │ │ │ +00037f20: 2020 2043 4152 442e 2020 4164 6469 7469 CARD. Additi │ │ │ │ │ +00037f30: 6f6e 616c 6c79 2074 6865 2066 6f6c 6c6f onally the follo │ │ │ │ │ +00037f40: 7769 6e67 2044 4843 5020 6f70 7469 6f6e wing DHCP option │ │ │ │ │ +00037f50: 7320 6172 6520 7265 636f 676e 697a 6564 s are recognized │ │ │ │ │ +00037f60: 2061 6e64 0a20 2020 2020 7072 6f63 6573 and. proces │ │ │ │ │ +00037f70: 7365 643a 0a0a 2020 2020 2027 3120 2853 sed:.. '1 (S │ │ │ │ │ +00037f80: 7562 6e65 7420 4d61 736b 2927 0a20 2020 ubnet Mask)'. │ │ │ │ │ +00037f90: 2020 2020 2020 2055 7365 6420 746f 2063 Used to c │ │ │ │ │ +00037fa0: 616c 6375 6c61 7465 206e 6574 776f 726b alculate network │ │ │ │ │ +00037fb0: 206c 6f63 616c 2072 6f75 7469 6e67 2065 local routing e │ │ │ │ │ +00037fc0: 6e74 7279 2066 6f72 2069 6e74 6572 6661 ntry for interfa │ │ │ │ │ +00037fd0: 6365 0a20 2020 2020 2020 2020 2043 4152 ce. CAR │ │ │ │ │ +00037fe0: 4427 3a64 6863 7027 2e0a 2020 2020 2027 D':dhcp'.. ' │ │ │ │ │ +00037ff0: 3320 2852 6f75 7465 7229 270a 2020 2020 3 (Router)'. │ │ │ │ │ +00038000: 2020 2020 2020 4164 6473 2064 6566 6175 Adds defau │ │ │ │ │ +00038010: 6c74 2072 6f75 7465 2065 6e74 7279 2077 lt route entry w │ │ │ │ │ +00038020: 6974 6820 7468 6520 6e61 6d65 2043 4152 ith the name CAR │ │ │ │ │ +00038030: 4427 3a64 6863 703a 6465 6661 756c 7427 D':dhcp:default' │ │ │ │ │ +00038040: 2076 6961 0a20 2020 2020 2020 2020 2067 via. g │ │ │ │ │ +00038050: 6174 6577 6179 2066 726f 6d20 4448 4350 ateway from DHCP │ │ │ │ │ +00038060: 206f 7074 696f 6e2e 2020 4e6f 7465 2074 option. Note t │ │ │ │ │ +00038070: 6861 7420 6f6e 6c79 206f 7074 696f 6e20 hat only option │ │ │ │ │ +00038080: 7769 7468 2073 696e 676c 650a 2020 2020 with single. │ │ │ │ │ +00038090: 2020 2020 2020 726f 7574 6520 6973 2061 route is a │ │ │ │ │ +000380a0: 6363 6570 7465 642e 0a20 2020 2020 2736 ccepted.. '6 │ │ │ │ │ +000380b0: 2028 446f 6d61 696e 204e 616d 6520 5365 (Domain Name Se │ │ │ │ │ +000380c0: 7276 6572 2927 0a20 2020 2020 2020 2020 rver)'. │ │ │ │ │ +000380d0: 2041 6464 7320 616c 6c20 7365 7276 6572 Adds all server │ │ │ │ │ +000380e0: 7320 6672 6f6d 206f 7074 696f 6e20 7661 s from option va │ │ │ │ │ +000380f0: 6c75 6520 746f 2074 6865 206c 6973 7420 lue to the list │ │ │ │ │ +00038100: 6f66 2073 6572 7665 7273 2075 7365 640a of servers used. │ │ │ │ │ +00038110: 2020 2020 2020 2020 2020 6475 7269 6e67 during │ │ │ │ │ +00038120: 206e 616d 6520 7265 736f 6c75 7469 6f6e name resolution │ │ │ │ │ +00038130: 2e0a 2020 2020 2027 3132 2028 486f 7374 .. '12 (Host │ │ │ │ │ +00038140: 204e 616d 6529 270a 2020 2020 2020 2020 Name)'. │ │ │ │ │ +00038150: 2020 5365 7473 2065 6e76 6972 6f6e 6d65 Sets environme │ │ │ │ │ +00038160: 6e74 2076 6172 6961 626c 6520 276e 6574 nt variable 'net │ │ │ │ │ +00038170: 5f27 3c43 4152 443e 275f 6468 6370 5f68 _''_dhcp_h │ │ │ │ │ +00038180: 6f73 746e 616d 6527 2028 2a6e 6f74 650a ostname' (*note. │ │ │ │ │ +00038190: 2020 2020 2020 2020 2020 6e65 745f 3c49 net__hostna │ │ │ │ │ +000381b0: 6d65 3a3a 2920 746f 2074 6865 2076 616c me::) to the val │ │ │ │ │ +000381c0: 7565 206f 6620 6f70 7469 6f6e 2e0a 2020 ue of option.. │ │ │ │ │ +000381d0: 2020 2027 3135 2028 446f 6d61 696e 204e '15 (Domain N │ │ │ │ │ +000381e0: 616d 6529 270a 2020 2020 2020 2020 2020 ame)'. │ │ │ │ │ +000381f0: 5365 7473 2065 6e76 6972 6f6e 6d65 6e74 Sets environment │ │ │ │ │ +00038200: 2076 6172 6961 626c 6520 276e 6574 5f27 variable 'net_' │ │ │ │ │ +00038210: 3c43 4152 443e 275f 6468 6370 5f64 6f6d '_dhcp_dom │ │ │ │ │ +00038220: 6169 6e27 2028 2a6e 6f74 650a 2020 2020 ain' (*note. │ │ │ │ │ +00038230: 2020 2020 2020 6e65 745f 3c49 4e54 4552 net__domain::) │ │ │ │ │ +00038250: 746f 2074 6865 2076 616c 7565 206f 6620 to the value of │ │ │ │ │ +00038260: 6f70 7469 6f6e 2e0a 2020 2020 2027 3137 option.. '17 │ │ │ │ │ +00038270: 2028 526f 6f74 2050 6174 6829 270a 2020 (Root Path)'. │ │ │ │ │ +00038280: 2020 2020 2020 2020 5365 7473 2065 6e76 Sets env │ │ │ │ │ +00038290: 6972 6f6e 6d65 6e74 2076 6172 6961 626c ironment variabl │ │ │ │ │ +000382a0: 6520 276e 6574 5f27 3c43 4152 443e 275f e 'net_''_ │ │ │ │ │ +000382b0: 6468 6370 5f72 6f6f 7470 6174 6827 2028 dhcp_rootpath' ( │ │ │ │ │ +000382c0: 2a6e 6f74 650a 2020 2020 2020 2020 2020 *note. │ │ │ │ │ +000382d0: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ +000382e0: 726f 6f74 7061 7468 3a3a 2920 746f 2074 rootpath::) to t │ │ │ │ │ +000382f0: 6865 2076 616c 7565 206f 6620 6f70 7469 he value of opti │ │ │ │ │ +00038300: 6f6e 2e0a 2020 2020 2027 3138 2028 4578 on.. '18 (Ex │ │ │ │ │ +00038310: 7465 6e73 696f 6e73 2050 6174 6829 270a tensions Path)'. │ │ │ │ │ +00038320: 2020 2020 2020 2020 2020 5365 7473 2065 Sets e │ │ │ │ │ +00038330: 6e76 6972 6f6e 6d65 6e74 2076 6172 6961 nvironment varia │ │ │ │ │ +00038340: 626c 6520 276e 6574 5f27 3c43 4152 443e ble 'net_' │ │ │ │ │ +00038350: 275f 6468 6370 5f65 7874 656e 7369 6f6e '_dhcp_extension │ │ │ │ │ +00038360: 7370 6174 6827 0a20 2020 2020 2020 2020 spath'. │ │ │ │ │ +00038370: 2028 2a6e 6f74 6520 6e65 745f 3c49 4e54 (*note net__extensio │ │ │ │ │ +00038390: 6e73 7061 7468 3a3a 2920 746f 2074 6865 nspath::) to the │ │ │ │ │ +000383a0: 2076 616c 7565 206f 660a 2020 2020 2020 value of. │ │ │ │ │ +000383b0: 2020 2020 6f70 7469 6f6e 2e0a 2020 2020 option.. │ │ │ │ │ +000383c0: 2027 3636 2028 5446 5450 2053 6572 7665 '66 (TFTP Serve │ │ │ │ │ +000383d0: 7220 4e61 6d65 2927 0a20 2020 2020 2020 r Name)'. │ │ │ │ │ +000383e0: 2020 2053 6574 7320 656e 7669 726f 6e6d Sets environm │ │ │ │ │ +000383f0: 656e 7420 7661 7269 6162 6c65 2027 6e65 ent variable 'ne │ │ │ │ │ +00038400: 745f 273c 4341 5244 3e27 5f64 6863 705f t_''_dhcp_ │ │ │ │ │ +00038410: 7365 7276 6572 5f6e 616d 6527 0a20 2020 server_name'. │ │ │ │ │ +00038420: 2020 2020 2020 2028 2a6e 6f74 6520 6e65 (*note ne │ │ │ │ │ +00038430: 745f 3c49 4e54 4552 4641 4345 3e5f 6468 t__dh │ │ │ │ │ +00038440: 6370 5f73 6572 7665 725f 6e61 6d65 3a3a cp_server_name:: │ │ │ │ │ +00038450: 2920 746f 2074 6865 2076 616c 7565 206f ) to the value o │ │ │ │ │ +00038460: 660a 2020 2020 2020 2020 2020 6f70 7469 f. opti │ │ │ │ │ +00038470: 6f6e 2e0a 2020 2020 2027 3637 2028 4669 on.. '67 (Fi │ │ │ │ │ +00038480: 6c65 6e61 6d65 2927 0a20 2020 2020 2020 lename)'. │ │ │ │ │ +00038490: 2020 2053 6574 7320 656e 7669 726f 6e6d Sets environm │ │ │ │ │ +000384a0: 656e 7420 7661 7269 6162 6c65 2027 6e65 ent variable 'ne │ │ │ │ │ +000384b0: 745f 273c 4341 5244 3e27 5f62 6f6f 745f t_''_boot_ │ │ │ │ │ +000384c0: 6669 6c65 2720 282a 6e6f 7465 0a20 2020 file' (*note. │ │ │ │ │ +000384d0: 2020 2020 2020 206e 6574 5f3c 494e 5445 net__boot_file │ │ │ │ │ +000384f0: 3a3a 2920 746f 2074 6865 2076 616c 7565 ::) to the value │ │ │ │ │ +00038500: 206f 6620 6f70 7469 6f6e 2e0a 0a1f 0a46 of option.....F │ │ │ │ │ +00038510: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00038520: 204e 6f64 653a 206e 6574 5f67 6574 5f64 Node: net_get_d │ │ │ │ │ +00038530: 6863 705f 6f70 7469 6f6e 2c20 204e 6578 hcp_option, Nex │ │ │ │ │ +00038540: 743a 206e 6574 5f69 7076 365f 6175 746f t: net_ipv6_auto │ │ │ │ │ +00038550: 636f 6e66 2c20 2050 7265 763a 206e 6574 conf, Prev: net │ │ │ │ │ +00038560: 5f64 6863 702c 2020 5570 3a20 4e65 7477 _dhcp, Up: Netw │ │ │ │ │ +00038570: 6f72 6b69 6e67 2063 6f6d 6d61 6e64 730a orking commands. │ │ │ │ │ +00038580: 0a31 362e 342e 3920 6e65 745f 6765 745f .16.4.9 net_get_ │ │ │ │ │ +00038590: 6468 6370 5f6f 7074 696f 6e0a 2d2d 2d2d dhcp_option.---- │ │ │ │ │ 000385a0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -000385b0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ -000385c0: 643a 206e 6574 5f67 6574 5f64 6863 705f d: net_get_dhcp_ │ │ │ │ │ -000385d0: 6f70 7469 6f6e 2056 4152 2049 4e54 4552 option VAR INTER │ │ │ │ │ -000385e0: 4641 4345 204e 554d 4245 5220 5459 5045 FACE NUMBER TYPE │ │ │ │ │ -000385f0: 0a20 2020 2020 5265 7175 6573 7420 4448 . Request DH │ │ │ │ │ -00038600: 4350 206f 7074 696f 6e20 4e55 4d42 4552 CP option NUMBER │ │ │ │ │ -00038610: 206f 6620 5459 5045 2076 6961 2049 4e54 of TYPE via INT │ │ │ │ │ -00038620: 4552 4641 4345 2e20 2054 5950 4520 6361 ERFACE. TYPE ca │ │ │ │ │ -00038630: 6e20 6265 206f 6e65 0a20 2020 2020 6f66 n be one. of │ │ │ │ │ -00038640: 2027 7374 7269 6e67 272c 2027 6e75 6d62 'string', 'numb │ │ │ │ │ -00038650: 6572 2720 6f72 2027 6865 7827 2e20 2049 er' or 'hex'. I │ │ │ │ │ -00038660: 6620 6f70 7469 6f6e 2069 7320 666f 756e f option is foun │ │ │ │ │ -00038670: 642c 2061 7373 6967 6e20 6974 730a 2020 d, assign its. │ │ │ │ │ -00038680: 2020 2076 616c 7565 2074 6f20 7661 7269 value to vari │ │ │ │ │ -00038690: 6162 6c65 2056 4152 2e20 2056 616c 7565 able VAR. Value │ │ │ │ │ -000386a0: 7320 6f66 2074 7970 6573 2027 6e75 6d62 s of types 'numb │ │ │ │ │ -000386b0: 6572 2720 616e 6420 2768 6578 2720 6172 er' and 'hex' ar │ │ │ │ │ -000386c0: 650a 2020 2020 2063 6f6e 7665 7274 6564 e. converted │ │ │ │ │ -000386d0: 2074 6f20 7374 7269 6e67 2072 6570 7265 to string repre │ │ │ │ │ -000386e0: 7365 6e74 6174 696f 6e2e 0a0a 1f0a 4669 sentation.....Fi │ │ │ │ │ -000386f0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00038700: 4e6f 6465 3a20 6e65 745f 6970 7636 5f61 Node: net_ipv6_a │ │ │ │ │ -00038710: 7574 6f63 6f6e 662c 2020 4e65 7874 3a20 utoconf, Next: │ │ │ │ │ -00038720: 6e65 745f 6c73 5f61 6464 722c 2020 5072 net_ls_addr, Pr │ │ │ │ │ -00038730: 6576 3a20 6e65 745f 6765 745f 6468 6370 ev: net_get_dhcp │ │ │ │ │ -00038740: 5f6f 7074 696f 6e2c 2020 5570 3a20 4e65 _option, Up: Ne │ │ │ │ │ -00038750: 7477 6f72 6b69 6e67 2063 6f6d 6d61 6e64 tworking command │ │ │ │ │ -00038760: 730a 0a31 362e 342e 3130 206e 6574 5f69 s..16.4.10 net_i │ │ │ │ │ -00038770: 7076 365f 6175 746f 636f 6e66 0a2d 2d2d pv6_autoconf.--- │ │ │ │ │ +000385b0: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ +000385c0: 616e 643a 206e 6574 5f67 6574 5f64 6863 and: net_get_dhc │ │ │ │ │ +000385d0: 705f 6f70 7469 6f6e 2056 4152 2049 4e54 p_option VAR INT │ │ │ │ │ +000385e0: 4552 4641 4345 204e 554d 4245 5220 5459 ERFACE NUMBER TY │ │ │ │ │ +000385f0: 5045 0a20 2020 2020 5265 7175 6573 7420 PE. Request │ │ │ │ │ +00038600: 4448 4350 206f 7074 696f 6e20 4e55 4d42 DHCP option NUMB │ │ │ │ │ +00038610: 4552 206f 6620 5459 5045 2076 6961 2049 ER of TYPE via I │ │ │ │ │ +00038620: 4e54 4552 4641 4345 2e20 2054 5950 4520 NTERFACE. TYPE │ │ │ │ │ +00038630: 6361 6e20 6265 206f 6e65 0a20 2020 2020 can be one. │ │ │ │ │ +00038640: 6f66 2027 7374 7269 6e67 272c 2027 6e75 of 'string', 'nu │ │ │ │ │ +00038650: 6d62 6572 2720 6f72 2027 6865 7827 2e20 mber' or 'hex'. │ │ │ │ │ +00038660: 2049 6620 6f70 7469 6f6e 2069 7320 666f If option is fo │ │ │ │ │ +00038670: 756e 642c 2061 7373 6967 6e20 6974 730a und, assign its. │ │ │ │ │ +00038680: 2020 2020 2076 616c 7565 2074 6f20 7661 value to va │ │ │ │ │ +00038690: 7269 6162 6c65 2056 4152 2e20 2056 616c riable VAR. Val │ │ │ │ │ +000386a0: 7565 7320 6f66 2074 7970 6573 2027 6e75 ues of types 'nu │ │ │ │ │ +000386b0: 6d62 6572 2720 616e 6420 2768 6578 2720 mber' and 'hex' │ │ │ │ │ +000386c0: 6172 650a 2020 2020 2063 6f6e 7665 7274 are. convert │ │ │ │ │ +000386d0: 6564 2074 6f20 7374 7269 6e67 2072 6570 ed to string rep │ │ │ │ │ +000386e0: 7265 7365 6e74 6174 696f 6e2e 0a0a 1f0a resentation..... │ │ │ │ │ +000386f0: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00038700: 2020 4e6f 6465 3a20 6e65 745f 6970 7636 Node: net_ipv6 │ │ │ │ │ +00038710: 5f61 7574 6f63 6f6e 662c 2020 4e65 7874 _autoconf, Next │ │ │ │ │ +00038720: 3a20 6e65 745f 6c73 5f61 6464 722c 2020 : net_ls_addr, │ │ │ │ │ +00038730: 5072 6576 3a20 6e65 745f 6765 745f 6468 Prev: net_get_dh │ │ │ │ │ +00038740: 6370 5f6f 7074 696f 6e2c 2020 5570 3a20 cp_option, Up: │ │ │ │ │ +00038750: 4e65 7477 6f72 6b69 6e67 2063 6f6d 6d61 Networking comma │ │ │ │ │ +00038760: 6e64 730a 0a31 362e 342e 3130 206e 6574 nds..16.4.10 net │ │ │ │ │ +00038770: 5f69 7076 365f 6175 746f 636f 6e66 0a2d _ipv6_autoconf.- │ │ │ │ │ 00038780: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00038790: 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d ------.. -- Comm │ │ │ │ │ -000387a0: 616e 643a 206e 6574 5f69 7076 365f 6175 and: net_ipv6_au │ │ │ │ │ -000387b0: 746f 636f 6e66 205b 4341 5244 5d0a 2020 toconf [CARD]. │ │ │ │ │ -000387c0: 2020 2050 6572 666f 726d 2049 5076 3620 Perform IPv6 │ │ │ │ │ -000387d0: 6175 746f 636f 6e66 6967 7572 6174 696f autoconfiguratio │ │ │ │ │ -000387e0: 6e20 6279 2061 6464 696e 6720 746f 2074 n by adding to t │ │ │ │ │ -000387f0: 6865 2043 4152 4420 696e 7465 7266 6163 he CARD interfac │ │ │ │ │ -00038800: 6520 7769 7468 0a20 2020 2020 6e61 6d65 e with. name │ │ │ │ │ -00038810: 2043 4152 4427 3a6c 696e 6b27 2061 6e64 CARD':link' and │ │ │ │ │ -00038820: 206c 696e 6b20 6c6f 6361 6c20 4d41 432d link local MAC- │ │ │ │ │ -00038830: 6261 7365 6420 6164 6472 6573 732e 2020 based address. │ │ │ │ │ -00038840: 4966 206e 6f20 6361 7264 2069 730a 2020 If no card is. │ │ │ │ │ -00038850: 2020 2073 7065 6369 6669 6564 2c20 7065 specified, pe │ │ │ │ │ -00038860: 7266 6f72 6d20 6175 746f 636f 6e66 6967 rform autoconfig │ │ │ │ │ -00038870: 7572 6174 696f 6e20 666f 7220 616c 6c20 uration for all │ │ │ │ │ -00038880: 6578 6973 7469 6e67 2063 6172 6473 2e0a existing cards.. │ │ │ │ │ -00038890: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -000388a0: 666f 2c20 204e 6f64 653a 206e 6574 5f6c fo, Node: net_l │ │ │ │ │ -000388b0: 735f 6164 6472 2c20 204e 6578 743a 206e s_addr, Next: n │ │ │ │ │ -000388c0: 6574 5f6c 735f 6361 7264 732c 2020 5072 et_ls_cards, Pr │ │ │ │ │ -000388d0: 6576 3a20 6e65 745f 6970 7636 5f61 7574 ev: net_ipv6_aut │ │ │ │ │ -000388e0: 6f63 6f6e 662c 2020 5570 3a20 4e65 7477 oconf, Up: Netw │ │ │ │ │ -000388f0: 6f72 6b69 6e67 2063 6f6d 6d61 6e64 730a orking commands. │ │ │ │ │ -00038900: 0a31 362e 342e 3131 206e 6574 5f6c 735f .16.4.11 net_ls_ │ │ │ │ │ -00038910: 6164 6472 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d addr.----------- │ │ │ │ │ -00038920: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ -00038930: 6d6d 616e 643a 206e 6574 5f6c 735f 6164 mmand: net_ls_ad │ │ │ │ │ -00038940: 6472 0a20 2020 2020 4c69 7374 2061 6c6c dr. List all │ │ │ │ │ -00038950: 2063 6f6e 6669 6775 7265 6420 696e 7465 configured inte │ │ │ │ │ -00038960: 7266 6163 6573 2077 6974 6820 7468 6569 rfaces with thei │ │ │ │ │ -00038970: 7220 4d41 4320 616e 6420 4950 2061 6464 r MAC and IP add │ │ │ │ │ -00038980: 7265 7373 6573 2e0a 0a1f 0a46 696c 653a resses.....File: │ │ │ │ │ -00038990: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -000389a0: 653a 206e 6574 5f6c 735f 6361 7264 732c e: net_ls_cards, │ │ │ │ │ -000389b0: 2020 4e65 7874 3a20 6e65 745f 6c73 5f64 Next: net_ls_d │ │ │ │ │ -000389c0: 6e73 2c20 2050 7265 763a 206e 6574 5f6c ns, Prev: net_l │ │ │ │ │ -000389d0: 735f 6164 6472 2c20 2055 703a 204e 6574 s_addr, Up: Net │ │ │ │ │ -000389e0: 776f 726b 696e 6720 636f 6d6d 616e 6473 working commands │ │ │ │ │ -000389f0: 0a0a 3136 2e34 2e31 3220 6e65 745f 6c73 ..16.4.12 net_ls │ │ │ │ │ -00038a00: 5f63 6172 6473 0a2d 2d2d 2d2d 2d2d 2d2d _cards.--------- │ │ │ │ │ -00038a10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 2d2d -----------.. -- │ │ │ │ │ -00038a20: 2043 6f6d 6d61 6e64 3a20 6e65 745f 6c73 Command: net_ls │ │ │ │ │ -00038a30: 5f63 6172 6473 0a20 2020 2020 4c69 7374 _cards. List │ │ │ │ │ -00038a40: 2061 6c6c 2064 6574 6563 7465 6420 6e65 all detected ne │ │ │ │ │ -00038a50: 7477 6f72 6b20 6361 7264 7320 7769 7468 twork cards with │ │ │ │ │ -00038a60: 2074 6865 6972 204d 4143 2061 6464 7265 their MAC addre │ │ │ │ │ -00038a70: 7373 2e0a 0a1f 0a46 696c 653a 2067 7275 ss.....File: gru │ │ │ │ │ -00038a80: 622e 696e 666f 2c20 204e 6f64 653a 206e b.info, Node: n │ │ │ │ │ -00038a90: 6574 5f6c 735f 646e 732c 2020 4e65 7874 et_ls_dns, Next │ │ │ │ │ -00038aa0: 3a20 6e65 745f 6c73 5f72 6f75 7465 732c : net_ls_routes, │ │ │ │ │ -00038ab0: 2020 5072 6576 3a20 6e65 745f 6c73 5f63 Prev: net_ls_c │ │ │ │ │ -00038ac0: 6172 6473 2c20 2055 703a 204e 6574 776f ards, Up: Netwo │ │ │ │ │ -00038ad0: 726b 696e 6720 636f 6d6d 616e 6473 0a0a rking commands.. │ │ │ │ │ -00038ae0: 3136 2e34 2e31 3320 6e65 745f 6c73 5f64 16.4.13 net_ls_d │ │ │ │ │ -00038af0: 6e73 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ns.------------- │ │ │ │ │ -00038b00: 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d 6d61 -----.. -- Comma │ │ │ │ │ -00038b10: 6e64 3a20 6e65 745f 6c73 5f64 6e73 0a20 nd: net_ls_dns. │ │ │ │ │ -00038b20: 2020 2020 4c69 7374 2061 6464 7265 7373 List address │ │ │ │ │ -00038b30: 6573 206f 6620 444e 5320 7365 7276 6572 es of DNS server │ │ │ │ │ -00038b40: 7320 7573 6564 2064 7572 696e 6720 6e61 s used during na │ │ │ │ │ -00038b50: 6d65 206c 6f6f 6b75 702e 0a0a 1f0a 4669 me lookup.....Fi │ │ │ │ │ -00038b60: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00038b70: 4e6f 6465 3a20 6e65 745f 6c73 5f72 6f75 Node: net_ls_rou │ │ │ │ │ -00038b80: 7465 732c 2020 4e65 7874 3a20 6e65 745f tes, Next: net_ │ │ │ │ │ -00038b90: 6e73 6c6f 6f6b 7570 2c20 2050 7265 763a nslookup, Prev: │ │ │ │ │ -00038ba0: 206e 6574 5f6c 735f 646e 732c 2020 5570 net_ls_dns, Up │ │ │ │ │ -00038bb0: 3a20 4e65 7477 6f72 6b69 6e67 2063 6f6d : Networking com │ │ │ │ │ -00038bc0: 6d61 6e64 730a 0a31 362e 342e 3134 206e mands..16.4.14 n │ │ │ │ │ -00038bd0: 6574 5f6c 735f 726f 7574 6573 0a2d 2d2d et_ls_routes.--- │ │ │ │ │ +00038790: 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 436f --------.. -- Co │ │ │ │ │ +000387a0: 6d6d 616e 643a 206e 6574 5f69 7076 365f mmand: net_ipv6_ │ │ │ │ │ +000387b0: 6175 746f 636f 6e66 205b 4341 5244 5d0a autoconf [CARD]. │ │ │ │ │ +000387c0: 2020 2020 2050 6572 666f 726d 2049 5076 Perform IPv │ │ │ │ │ +000387d0: 3620 6175 746f 636f 6e66 6967 7572 6174 6 autoconfigurat │ │ │ │ │ +000387e0: 696f 6e20 6279 2061 6464 696e 6720 746f ion by adding to │ │ │ │ │ +000387f0: 2074 6865 2043 4152 4420 696e 7465 7266 the CARD interf │ │ │ │ │ +00038800: 6163 6520 7769 7468 0a20 2020 2020 6e61 ace with. na │ │ │ │ │ +00038810: 6d65 2043 4152 4427 3a6c 696e 6b27 2061 me CARD':link' a │ │ │ │ │ +00038820: 6e64 206c 696e 6b20 6c6f 6361 6c20 4d41 nd link local MA │ │ │ │ │ +00038830: 432d 6261 7365 6420 6164 6472 6573 732e C-based address. │ │ │ │ │ +00038840: 2020 4966 206e 6f20 6361 7264 2069 730a If no card is. │ │ │ │ │ +00038850: 2020 2020 2073 7065 6369 6669 6564 2c20 specified, │ │ │ │ │ +00038860: 7065 7266 6f72 6d20 6175 746f 636f 6e66 perform autoconf │ │ │ │ │ +00038870: 6967 7572 6174 696f 6e20 666f 7220 616c iguration for al │ │ │ │ │ +00038880: 6c20 6578 6973 7469 6e67 2063 6172 6473 l existing cards │ │ │ │ │ +00038890: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +000388a0: 696e 666f 2c20 204e 6f64 653a 206e 6574 info, Node: net │ │ │ │ │ +000388b0: 5f6c 735f 6164 6472 2c20 204e 6578 743a _ls_addr, Next: │ │ │ │ │ +000388c0: 206e 6574 5f6c 735f 6361 7264 732c 2020 net_ls_cards, │ │ │ │ │ +000388d0: 5072 6576 3a20 6e65 745f 6970 7636 5f61 Prev: net_ipv6_a │ │ │ │ │ +000388e0: 7574 6f63 6f6e 662c 2020 5570 3a20 4e65 utoconf, Up: Ne │ │ │ │ │ +000388f0: 7477 6f72 6b69 6e67 2063 6f6d 6d61 6e64 tworking command │ │ │ │ │ +00038900: 730a 0a31 362e 342e 3131 206e 6574 5f6c s..16.4.11 net_l │ │ │ │ │ +00038910: 735f 6164 6472 0a2d 2d2d 2d2d 2d2d 2d2d s_addr.--------- │ │ │ │ │ +00038920: 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d 2d20 ----------.. -- │ │ │ │ │ +00038930: 436f 6d6d 616e 643a 206e 6574 5f6c 735f Command: net_ls_ │ │ │ │ │ +00038940: 6164 6472 0a20 2020 2020 4c69 7374 2061 addr. List a │ │ │ │ │ +00038950: 6c6c 2063 6f6e 6669 6775 7265 6420 696e ll configured in │ │ │ │ │ +00038960: 7465 7266 6163 6573 2077 6974 6820 7468 terfaces with th │ │ │ │ │ +00038970: 6569 7220 4d41 4320 616e 6420 4950 2061 eir MAC and IP a │ │ │ │ │ +00038980: 6464 7265 7373 6573 2e0a 0a1f 0a46 696c ddresses.....Fil │ │ │ │ │ +00038990: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +000389a0: 6f64 653a 206e 6574 5f6c 735f 6361 7264 ode: net_ls_card │ │ │ │ │ +000389b0: 732c 2020 4e65 7874 3a20 6e65 745f 6c73 s, Next: net_ls │ │ │ │ │ +000389c0: 5f64 6e73 2c20 2050 7265 763a 206e 6574 _dns, Prev: net │ │ │ │ │ +000389d0: 5f6c 735f 6164 6472 2c20 2055 703a 204e _ls_addr, Up: N │ │ │ │ │ +000389e0: 6574 776f 726b 696e 6720 636f 6d6d 616e etworking comman │ │ │ │ │ +000389f0: 6473 0a0a 3136 2e34 2e31 3220 6e65 745f ds..16.4.12 net_ │ │ │ │ │ +00038a00: 6c73 5f63 6172 6473 0a2d 2d2d 2d2d 2d2d ls_cards.------- │ │ │ │ │ +00038a10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d0a 0a20 -------------.. │ │ │ │ │ +00038a20: 2d2d 2043 6f6d 6d61 6e64 3a20 6e65 745f -- Command: net_ │ │ │ │ │ +00038a30: 6c73 5f63 6172 6473 0a20 2020 2020 4c69 ls_cards. Li │ │ │ │ │ +00038a40: 7374 2061 6c6c 2064 6574 6563 7465 6420 st all detected │ │ │ │ │ +00038a50: 6e65 7477 6f72 6b20 6361 7264 7320 7769 network cards wi │ │ │ │ │ +00038a60: 7468 2074 6865 6972 204d 4143 2061 6464 th their MAC add │ │ │ │ │ +00038a70: 7265 7373 2e0a 0a1f 0a46 696c 653a 2067 ress.....File: g │ │ │ │ │ +00038a80: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +00038a90: 206e 6574 5f6c 735f 646e 732c 2020 4e65 net_ls_dns, Ne │ │ │ │ │ +00038aa0: 7874 3a20 6e65 745f 6c73 5f72 6f75 7465 xt: net_ls_route │ │ │ │ │ +00038ab0: 732c 2020 5072 6576 3a20 6e65 745f 6c73 s, Prev: net_ls │ │ │ │ │ +00038ac0: 5f63 6172 6473 2c20 2055 703a 204e 6574 _cards, Up: Net │ │ │ │ │ +00038ad0: 776f 726b 696e 6720 636f 6d6d 616e 6473 working commands │ │ │ │ │ +00038ae0: 0a0a 3136 2e34 2e31 3320 6e65 745f 6c73 ..16.4.13 net_ls │ │ │ │ │ +00038af0: 5f64 6e73 0a2d 2d2d 2d2d 2d2d 2d2d 2d2d _dns.----------- │ │ │ │ │ +00038b00: 2d2d 2d2d 2d2d 2d0a 0a20 2d2d 2043 6f6d -------.. -- Com │ │ │ │ │ +00038b10: 6d61 6e64 3a20 6e65 745f 6c73 5f64 6e73 mand: net_ls_dns │ │ │ │ │ +00038b20: 0a20 2020 2020 4c69 7374 2061 6464 7265 . List addre │ │ │ │ │ +00038b30: 7373 6573 206f 6620 444e 5320 7365 7276 sses of DNS serv │ │ │ │ │ +00038b40: 6572 7320 7573 6564 2064 7572 696e 6720 ers used during │ │ │ │ │ +00038b50: 6e61 6d65 206c 6f6f 6b75 702e 0a0a 1f0a name lookup..... │ │ │ │ │ +00038b60: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00038b70: 2020 4e6f 6465 3a20 6e65 745f 6c73 5f72 Node: net_ls_r │ │ │ │ │ +00038b80: 6f75 7465 732c 2020 4e65 7874 3a20 6e65 outes, Next: ne │ │ │ │ │ +00038b90: 745f 6e73 6c6f 6f6b 7570 2c20 2050 7265 t_nslookup, Pre │ │ │ │ │ +00038ba0: 763a 206e 6574 5f6c 735f 646e 732c 2020 v: net_ls_dns, │ │ │ │ │ +00038bb0: 5570 3a20 4e65 7477 6f72 6b69 6e67 2063 Up: Networking c │ │ │ │ │ +00038bc0: 6f6d 6d61 6e64 730a 0a31 362e 342e 3134 ommands..16.4.14 │ │ │ │ │ +00038bd0: 206e 6574 5f6c 735f 726f 7574 6573 0a2d net_ls_routes.- │ │ │ │ │ 00038be0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -00038bf0: 2d2d 0a0a 202d 2d20 436f 6d6d 616e 643a --.. -- Command: │ │ │ │ │ -00038c00: 206e 6574 5f6c 735f 726f 7574 6573 0a20 net_ls_routes. │ │ │ │ │ -00038c10: 2020 2020 4c69 7374 2072 6f75 7469 6e67 List routing │ │ │ │ │ -00038c20: 2065 6e74 7269 6573 2e0a 0a1f 0a46 696c entries.....Fil │ │ │ │ │ -00038c30: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00038c40: 6f64 653a 206e 6574 5f6e 736c 6f6f 6b75 ode: net_nslooku │ │ │ │ │ -00038c50: 702c 2020 5072 6576 3a20 6e65 745f 6c73 p, Prev: net_ls │ │ │ │ │ -00038c60: 5f72 6f75 7465 732c 2020 5570 3a20 4e65 _routes, Up: Ne │ │ │ │ │ -00038c70: 7477 6f72 6b69 6e67 2063 6f6d 6d61 6e64 tworking command │ │ │ │ │ -00038c80: 730a 0a31 362e 342e 3135 206e 6574 5f6e s..16.4.15 net_n │ │ │ │ │ -00038c90: 736c 6f6f 6b75 700a 2d2d 2d2d 2d2d 2d2d slookup.-------- │ │ │ │ │ -00038ca0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a 202d ------------.. - │ │ │ │ │ -00038cb0: 2d20 436f 6d6d 616e 643a 206e 6574 5f6e - Command: net_n │ │ │ │ │ -00038cc0: 736c 6f6f 6b75 7020 4e41 4d45 205b 5345 slookup NAME [SE │ │ │ │ │ -00038cd0: 5256 4552 5d0a 2020 2020 2052 6573 6f6c RVER]. Resol │ │ │ │ │ -00038ce0: 7665 2061 6464 7265 7373 206f 6620 4e41 ve address of NA │ │ │ │ │ -00038cf0: 4d45 2075 7369 6e67 2044 4e53 2073 6572 ME using DNS ser │ │ │ │ │ -00038d00: 7665 7220 5345 5256 4552 2e20 2049 6620 ver SERVER. If │ │ │ │ │ -00038d10: 6e6f 2073 6572 7665 7220 6973 0a20 2020 no server is. │ │ │ │ │ -00038d20: 2020 6769 7665 6e2c 2075 7365 2064 6566 given, use def │ │ │ │ │ -00038d30: 6175 6c74 206c 6973 7420 6f66 2073 6572 ault list of ser │ │ │ │ │ -00038d40: 7665 7273 2e0a 0a1f 0a46 696c 653a 2067 vers.....File: g │ │ │ │ │ -00038d50: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -00038d60: 2049 6e74 6572 6e61 7469 6f6e 616c 6973 Internationalis │ │ │ │ │ -00038d70: 6174 696f 6e2c 2020 4e65 7874 3a20 5365 ation, Next: Se │ │ │ │ │ -00038d80: 6375 7269 7479 2c20 2050 7265 763a 2043 curity, Prev: C │ │ │ │ │ -00038d90: 6f6d 6d61 6e64 732c 2020 5570 3a20 546f ommands, Up: To │ │ │ │ │ -00038da0: 700a 0a31 3720 496e 7465 726e 6174 696f p..17 Internatio │ │ │ │ │ -00038db0: 6e61 6c69 7361 7469 6f6e 0a2a 2a2a 2a2a nalisation.***** │ │ │ │ │ +00038bf0: 2d2d 2d2d 0a0a 202d 2d20 436f 6d6d 616e ----.. -- Comman │ │ │ │ │ +00038c00: 643a 206e 6574 5f6c 735f 726f 7574 6573 d: net_ls_routes │ │ │ │ │ +00038c10: 0a20 2020 2020 4c69 7374 2072 6f75 7469 . List routi │ │ │ │ │ +00038c20: 6e67 2065 6e74 7269 6573 2e0a 0a1f 0a46 ng entries.....F │ │ │ │ │ +00038c30: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00038c40: 204e 6f64 653a 206e 6574 5f6e 736c 6f6f Node: net_nsloo │ │ │ │ │ +00038c50: 6b75 702c 2020 5072 6576 3a20 6e65 745f kup, Prev: net_ │ │ │ │ │ +00038c60: 6c73 5f72 6f75 7465 732c 2020 5570 3a20 ls_routes, Up: │ │ │ │ │ +00038c70: 4e65 7477 6f72 6b69 6e67 2063 6f6d 6d61 Networking comma │ │ │ │ │ +00038c80: 6e64 730a 0a31 362e 342e 3135 206e 6574 nds..16.4.15 net │ │ │ │ │ +00038c90: 5f6e 736c 6f6f 6b75 700a 2d2d 2d2d 2d2d _nslookup.------ │ │ │ │ │ +00038ca0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 0a0a --------------.. │ │ │ │ │ +00038cb0: 202d 2d20 436f 6d6d 616e 643a 206e 6574 -- Command: net │ │ │ │ │ +00038cc0: 5f6e 736c 6f6f 6b75 7020 4e41 4d45 205b _nslookup NAME [ │ │ │ │ │ +00038cd0: 5345 5256 4552 5d0a 2020 2020 2052 6573 SERVER]. Res │ │ │ │ │ +00038ce0: 6f6c 7665 2061 6464 7265 7373 206f 6620 olve address of │ │ │ │ │ +00038cf0: 4e41 4d45 2075 7369 6e67 2044 4e53 2073 NAME using DNS s │ │ │ │ │ +00038d00: 6572 7665 7220 5345 5256 4552 2e20 2049 erver SERVER. I │ │ │ │ │ +00038d10: 6620 6e6f 2073 6572 7665 7220 6973 0a20 f no server is. │ │ │ │ │ +00038d20: 2020 2020 6769 7665 6e2c 2075 7365 2064 given, use d │ │ │ │ │ +00038d30: 6566 6175 6c74 206c 6973 7420 6f66 2073 efault list of s │ │ │ │ │ +00038d40: 6572 7665 7273 2e0a 0a1f 0a46 696c 653a ervers.....File: │ │ │ │ │ +00038d50: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +00038d60: 653a 2049 6e74 6572 6e61 7469 6f6e 616c e: International │ │ │ │ │ +00038d70: 6973 6174 696f 6e2c 2020 4e65 7874 3a20 isation, Next: │ │ │ │ │ +00038d80: 5365 6375 7269 7479 2c20 2050 7265 763a Security, Prev: │ │ │ │ │ +00038d90: 2043 6f6d 6d61 6e64 732c 2020 5570 3a20 Commands, Up: │ │ │ │ │ +00038da0: 546f 700a 0a31 3720 496e 7465 726e 6174 Top..17 Internat │ │ │ │ │ +00038db0: 696f 6e61 6c69 7361 7469 6f6e 0a2a 2a2a ionalisation.*** │ │ │ │ │ 00038dc0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00038dd0: 2a2a 0a0a 3137 2e31 2043 6861 7273 6574 **..17.1 Charset │ │ │ │ │ -00038de0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a47 .============..G │ │ │ │ │ -00038df0: 5255 4220 7573 6573 2055 5446 2d38 2069 RUB uses UTF-8 i │ │ │ │ │ -00038e00: 6e74 6572 6e61 6c6c 7920 6f74 6865 7220 nternally other │ │ │ │ │ -00038e10: 7468 616e 2069 6e20 7265 6e64 6572 696e than in renderin │ │ │ │ │ -00038e20: 6720 7768 6572 6520 736f 6d65 0a47 5255 g where some.GRU │ │ │ │ │ -00038e30: 422d 7370 6563 6966 6963 2061 7070 726f B-specific appro │ │ │ │ │ -00038e40: 7072 6961 7465 2072 6570 7265 7365 6e74 priate represent │ │ │ │ │ -00038e50: 6174 696f 6e20 6973 2075 7365 642e 2020 ation is used. │ │ │ │ │ -00038e60: 416c 6c20 7465 7874 2066 696c 6573 0a28 All text files.( │ │ │ │ │ -00038e70: 696e 636c 7564 696e 6720 636f 6e66 6967 including config │ │ │ │ │ -00038e80: 2920 6172 6520 6173 7375 6d65 6420 746f ) are assumed to │ │ │ │ │ -00038e90: 2062 6520 656e 636f 6465 6420 696e 2055 be encoded in U │ │ │ │ │ -00038ea0: 5446 2d38 2e0a 0a31 372e 3220 4669 6c65 TF-8...17.2 File │ │ │ │ │ -00038eb0: 7379 7374 656d 730a 3d3d 3d3d 3d3d 3d3d systems.======== │ │ │ │ │ -00038ec0: 3d3d 3d3d 3d3d 3d3d 0a0a 4e54 4653 2c20 ========..NTFS, │ │ │ │ │ -00038ed0: 4a46 532c 2055 4446 2c20 4846 532b 2c20 JFS, UDF, HFS+, │ │ │ │ │ -00038ee0: 6578 4641 542c 206c 6f6e 6720 6669 6c65 exFAT, long file │ │ │ │ │ -00038ef0: 6e61 6d65 7320 696e 2046 4154 2c20 4a6f names in FAT, Jo │ │ │ │ │ -00038f00: 6c69 6574 2070 6172 7420 6f66 0a49 534f liet part of.ISO │ │ │ │ │ -00038f10: 3936 3630 2061 7265 2074 7265 6174 6564 9660 are treated │ │ │ │ │ -00038f20: 2061 7320 5554 462d 3136 2061 7320 7065 as UTF-16 as pe │ │ │ │ │ -00038f30: 7220 7370 6563 6966 6963 6174 696f 6e2e r specification. │ │ │ │ │ -00038f40: 2020 4146 5320 616e 6420 4246 5320 6172 AFS and BFS ar │ │ │ │ │ -00038f50: 650a 7265 6164 2061 7320 5554 462d 382c e.read as UTF-8, │ │ │ │ │ -00038f60: 2061 6761 696e 2061 6363 6f72 6469 6e67 again according │ │ │ │ │ -00038f70: 2074 6f20 7370 6563 6966 6963 6174 696f to specificatio │ │ │ │ │ -00038f80: 6e2e 2020 4274 7246 532c 2063 7069 6f2c n. BtrFS, cpio, │ │ │ │ │ -00038f90: 2074 6172 2c0a 7371 7561 7368 342c 206d tar,.squash4, m │ │ │ │ │ -00038fa0: 696e 6978 2c20 6d69 6e69 7832 2c20 6d69 inix, minix2, mi │ │ │ │ │ -00038fb0: 6e69 7833 2c20 524f 4d46 532c 2052 6569 nix3, ROMFS, Rei │ │ │ │ │ -00038fc0: 7365 7246 532c 2058 4653 2c20 6578 7432 serFS, XFS, ext2 │ │ │ │ │ -00038fd0: 2c20 6578 7433 2c20 6578 7434 2c0a 4641 , ext3, ext4,.FA │ │ │ │ │ -00038fe0: 5420 2873 686f 7274 206e 616d 6573 292c T (short names), │ │ │ │ │ -00038ff0: 2046 3246 532c 2052 6f63 6b52 6964 6765 F2FS, RockRidge │ │ │ │ │ -00039000: 2070 6172 7420 6f66 2049 534f 3936 3630 part of ISO9660 │ │ │ │ │ -00039010: 2c20 6e69 6c66 7332 2c20 5546 5331 2c20 , nilfs2, UFS1, │ │ │ │ │ -00039020: 5546 5332 0a61 6e64 205a 4653 2061 7265 UFS2.and ZFS are │ │ │ │ │ -00039030: 2061 7373 756d 6564 2074 6f20 6265 2055 assumed to be U │ │ │ │ │ -00039040: 5446 2d38 2e20 2054 6869 7320 6d69 6768 TF-8. This migh │ │ │ │ │ -00039050: 7420 6265 2066 616c 7365 206f 6e20 7379 t be false on sy │ │ │ │ │ -00039060: 7374 656d 730a 636f 6e66 6967 7572 6564 stems.configured │ │ │ │ │ -00039070: 2077 6974 6820 6c65 6761 6379 2063 6861 with legacy cha │ │ │ │ │ -00039080: 7273 6574 2062 7574 2061 7320 6c6f 6e67 rset but as long │ │ │ │ │ -00039090: 2061 7320 7468 6520 6368 6172 7365 7420 as the charset │ │ │ │ │ -000390a0: 7573 6564 2069 730a 7375 7065 7273 6574 used is.superset │ │ │ │ │ -000390b0: 206f 6620 4153 4349 4920 796f 7520 7368 of ASCII you sh │ │ │ │ │ -000390c0: 6f75 6c64 2062 6520 6162 6c65 2074 6f20 ould be able to │ │ │ │ │ -000390d0: 6163 6365 7373 2041 5343 4949 2d6e 616d access ASCII-nam │ │ │ │ │ -000390e0: 6564 2066 696c 6573 2e20 2041 6e64 0a69 ed files. And.i │ │ │ │ │ -000390f0: 7427 7320 7265 636f 6d6d 656e 6465 6420 t's recommended │ │ │ │ │ -00039100: 746f 2063 6f6e 6669 6775 7265 2079 6f75 to configure you │ │ │ │ │ -00039110: 7220 7379 7374 656d 2074 6f20 7573 6520 r system to use │ │ │ │ │ -00039120: 5554 462d 3820 746f 2061 6363 6573 7320 UTF-8 to access │ │ │ │ │ -00039130: 7468 650a 6669 6c65 7379 7374 656d 2c20 the.filesystem, │ │ │ │ │ -00039140: 636f 6e76 6d76 206d 6179 2068 656c 7020 convmv may help │ │ │ │ │ -00039150: 7769 7468 206d 6967 7261 7469 6f6e 2e20 with migration. │ │ │ │ │ -00039160: 2049 534f 3936 3630 2028 706c 6169 6e29 ISO9660 (plain) │ │ │ │ │ -00039170: 2066 696c 656e 616d 6573 0a61 7265 2073 filenames.are s │ │ │ │ │ -00039180: 7065 6369 6669 6564 2061 7320 6265 696e pecified as bein │ │ │ │ │ -00039190: 6720 4153 4349 4920 6f72 2062 6569 6e67 g ASCII or being │ │ │ │ │ -000391a0: 2064 6573 6372 6962 6564 2077 6974 6820 described with │ │ │ │ │ -000391b0: 756e 7370 6563 6966 6965 6420 6573 6361 unspecified esca │ │ │ │ │ -000391c0: 7065 0a73 6571 7565 6e63 6573 2e20 2047 pe.sequences. G │ │ │ │ │ -000391d0: 5255 4220 6173 7375 6d65 7320 7468 6174 RUB assumes that │ │ │ │ │ -000391e0: 2074 6865 2049 534f 3936 3630 206e 616d the ISO9660 nam │ │ │ │ │ -000391f0: 6573 2061 7265 2055 5446 2d38 2028 7369 es are UTF-8 (si │ │ │ │ │ -00039200: 6e63 6520 616e 790a 4153 4349 4920 6973 nce any.ASCII is │ │ │ │ │ -00039210: 2076 616c 6964 2055 5446 2d38 292e 2020 valid UTF-8). │ │ │ │ │ -00039220: 5468 6572 6520 6172 6520 736f 6d65 206f There are some o │ │ │ │ │ -00039230: 6c64 2043 442d 524f 4d73 2077 6869 6368 ld CD-ROMs which │ │ │ │ │ -00039240: 2075 7365 2043 5034 3337 2069 6e0a 6e6f use CP437 in.no │ │ │ │ │ -00039250: 6e2d 636f 6d70 6c69 616e 7420 7761 792e n-compliant way. │ │ │ │ │ -00039260: 2020 596f 7527 7265 2073 7469 6c6c 2061 You're still a │ │ │ │ │ -00039270: 626c 6520 746f 2061 6363 6573 7320 6669 ble to access fi │ │ │ │ │ -00039280: 6c65 7320 7769 7468 206e 616d 6573 0a63 les with names.c │ │ │ │ │ -00039290: 6f6e 7461 696e 696e 6720 6f6e 6c79 2041 ontaining only A │ │ │ │ │ -000392a0: 5343 4949 2063 6861 7261 6374 6572 7320 SCII characters │ │ │ │ │ -000392b0: 6f6e 2073 7563 6820 6669 6c65 7379 7374 on such filesyst │ │ │ │ │ -000392c0: 656d 7320 7468 6f75 6768 2e20 2059 6f75 ems though. You │ │ │ │ │ -000392d0: 2772 650a 616c 736f 2061 626c 6520 746f 're.also able to │ │ │ │ │ -000392e0: 2061 6363 6573 7320 616e 7920 6669 6c65 access any file │ │ │ │ │ -000392f0: 2069 6620 7468 6520 6669 6c65 7379 7374 if the filesyst │ │ │ │ │ -00039300: 656d 2063 6f6e 7461 696e 7320 7661 6c69 em contains vali │ │ │ │ │ -00039310: 6420 4a6f 6c69 6574 0a28 5554 462d 3136 d Joliet.(UTF-16 │ │ │ │ │ -00039320: 2920 6f72 2052 6f63 6b52 6964 6765 2028 ) or RockRidge ( │ │ │ │ │ -00039330: 5554 462d 3829 2e20 2041 4646 532c 2053 UTF-8). AFFS, S │ │ │ │ │ -00039340: 4653 2061 6e64 2048 4653 206e 6576 6572 FS and HFS never │ │ │ │ │ -00039350: 2075 7365 2075 6e69 636f 6465 2061 6e64 use unicode and │ │ │ │ │ -00039360: 0a47 5255 4220 6173 7375 6d65 7320 7468 .GRUB assumes th │ │ │ │ │ -00039370: 656d 2074 6f20 6265 2069 6e20 4c61 7469 em to be in Lati │ │ │ │ │ -00039380: 6e31 2c20 4c61 7469 6e31 2061 6e64 204d n1, Latin1 and M │ │ │ │ │ -00039390: 6163 526f 6d61 6e20 7265 7370 6563 7469 acRoman respecti │ │ │ │ │ -000393a0: 7665 6c79 2e0a 4752 5542 2068 616e 646c vely..GRUB handl │ │ │ │ │ -000393b0: 6573 2066 696c 6573 7973 7465 6d20 6361 es filesystem ca │ │ │ │ │ -000393c0: 7365 2d69 6e73 656e 7369 7469 7669 7479 se-insensitivity │ │ │ │ │ -000393d0: 2068 6f77 6576 6572 206e 6f20 6174 7465 however no atte │ │ │ │ │ -000393e0: 6d70 7420 6973 0a70 6572 666f 726d 6564 mpt is.performed │ │ │ │ │ -000393f0: 2061 7420 6361 7365 2063 6f6e 7665 7273 at case convers │ │ │ │ │ -00039400: 696f 6e20 6f66 2069 6e74 6572 6e61 7469 ion of internati │ │ │ │ │ -00039410: 6f6e 616c 2063 6861 7261 6374 6572 7320 onal characters │ │ │ │ │ -00039420: 736f 2065 2e67 2e20 2061 2066 696c 650a so e.g. a file. │ │ │ │ │ -00039430: 6e61 6d65 6420 6c6f 7765 7263 6173 6520 named lowercase │ │ │ │ │ -00039440: 6772 6565 6b20 616c 7068 6120 6973 2074 greek alpha is t │ │ │ │ │ -00039450: 7265 6174 6564 2061 7320 6469 6666 6572 reated as differ │ │ │ │ │ -00039460: 656e 7420 6672 6f6d 2074 6865 206f 6e65 ent from the one │ │ │ │ │ -00039470: 206e 616d 6564 0a61 7320 7570 7065 7263 named.as upperc │ │ │ │ │ -00039480: 6173 6520 616c 7068 612e 2020 5468 6520 ase alpha. The │ │ │ │ │ -00039490: 6669 6c65 7379 7374 656d 7320 696e 2071 filesystems in q │ │ │ │ │ -000394a0: 7565 7374 696f 6e73 2061 7265 204e 5446 uestions are NTF │ │ │ │ │ -000394b0: 5320 2865 7863 6570 7420 504f 5349 580a S (except POSIX. │ │ │ │ │ -000394c0: 6e61 6d65 7370 6163 6529 2c20 4846 532b namespace), HFS+ │ │ │ │ │ -000394d0: 2028 636f 6e66 6967 7572 6162 6c65 2061 (configurable a │ │ │ │ │ -000394e0: 7420 6d6b 6673 2074 696d 652c 2064 6566 t mkfs time, def │ │ │ │ │ -000394f0: 6175 6c74 2069 6e73 656e 7369 7469 7665 ault insensitive │ │ │ │ │ -00039500: 292c 2053 4653 0a28 636f 6e66 6967 7572 ), SFS.(configur │ │ │ │ │ -00039510: 6162 6c65 2061 7420 6d6b 6673 2074 696d able at mkfs tim │ │ │ │ │ -00039520: 652c 2064 6566 6175 6c74 2069 6e73 656e e, default insen │ │ │ │ │ -00039530: 7369 7469 7665 292c 204a 4653 2028 636f sitive), JFS (co │ │ │ │ │ -00039540: 6e66 6967 7572 6162 6c65 2061 740a 6d6b nfigurable at.mk │ │ │ │ │ -00039550: 6673 2074 696d 652c 2064 6566 6175 6c74 fs time, default │ │ │ │ │ -00039560: 2073 656e 7369 7469 7665 292c 2048 4653 sensitive), HFS │ │ │ │ │ -00039570: 2c20 4146 4653 2c20 4641 542c 2065 7846 , AFFS, FAT, exF │ │ │ │ │ -00039580: 4154 2061 6e64 205a 4653 0a28 636f 6e66 AT and ZFS.(conf │ │ │ │ │ -00039590: 6967 7572 6162 6c65 206f 6e20 7065 722d igurable on per- │ │ │ │ │ -000395a0: 7375 6276 6f6c 756d 6520 6261 7369 7320 subvolume basis │ │ │ │ │ -000395b0: 6279 2070 726f 7065 7274 7920 2263 6173 by property "cas │ │ │ │ │ -000395c0: 6573 656e 7369 7469 7669 7479 222c 0a64 esensitivity",.d │ │ │ │ │ -000395d0: 6566 6175 6c74 2073 656e 7369 7469 7665 efault sensitive │ │ │ │ │ -000395e0: 292e 2020 4f6e 205a 4653 2073 7562 766f ). On ZFS subvo │ │ │ │ │ -000395f0: 6c75 6d65 7320 6d61 726b 6564 2061 7320 lumes marked as │ │ │ │ │ -00039600: 6361 7365 2069 6e73 656e 7369 7469 7665 case insensitive │ │ │ │ │ -00039610: 2066 696c 6573 0a63 6f6e 7461 696e 696e files.containin │ │ │ │ │ -00039620: 6720 6c6f 7765 7263 6173 6520 696e 7465 g lowercase inte │ │ │ │ │ -00039630: 726e 6174 696f 6e61 6c20 6368 6172 6163 rnational charac │ │ │ │ │ -00039640: 7465 7273 2061 7265 2069 6e61 6363 6573 ters are inacces │ │ │ │ │ -00039650: 7369 626c 652e 2020 416c 736f 0a6c 696b sible. Also.lik │ │ │ │ │ -00039660: 6520 616c 6c20 7375 7070 6f72 7465 6420 e all supported │ │ │ │ │ -00039670: 6669 6c65 7379 7374 656d 7320 6578 6365 filesystems exce │ │ │ │ │ -00039680: 7074 2048 4653 2b20 616e 6420 5a46 5320 pt HFS+ and ZFS │ │ │ │ │ -00039690: 2863 6f6e 6669 6775 7261 626c 6520 6f6e (configurable on │ │ │ │ │ -000396a0: 0a70 6572 2d73 7562 766f 6c75 6d65 2062 .per-subvolume b │ │ │ │ │ -000396b0: 6173 6973 2062 7920 7072 6f70 6572 7479 asis by property │ │ │ │ │ -000396c0: 2022 6e6f 726d 616c 697a 6174 696f 6e22 "normalization" │ │ │ │ │ -000396d0: 2c20 6465 6661 756c 7420 6e6f 6e65 2920 , default none) │ │ │ │ │ -000396e0: 4752 5542 0a6d 616b 6573 206e 6f20 6174 GRUB.makes no at │ │ │ │ │ -000396f0: 7465 6d70 7420 6174 2063 6865 636b 206f tempt at check o │ │ │ │ │ -00039700: 6620 6361 6e6f 6e69 6361 6c20 6571 7569 f canonical equi │ │ │ │ │ -00039710: 7661 6c65 6e63 6520 736f 2061 2066 696c valence so a fil │ │ │ │ │ -00039720: 6520 6e61 6d65 0a75 2d64 6961 7265 7369 e name.u-diaresi │ │ │ │ │ -00039730: 7320 6973 2074 7265 6174 6564 2061 7320 s is treated as │ │ │ │ │ -00039740: 6469 7374 696e 6374 2066 726f 6d20 752b distinct from u+ │ │ │ │ │ -00039750: 636f 6d62 696e 696e 6720 6469 6172 6573 combining diares │ │ │ │ │ -00039760: 6973 2e20 2054 6869 730a 686f 7765 7665 is. This.howeve │ │ │ │ │ -00039770: 7220 6d65 616e 7320 7468 6174 2069 6e20 r means that in │ │ │ │ │ -00039780: 6f72 6465 7220 746f 2061 6363 6573 7320 order to access │ │ │ │ │ -00039790: 6669 6c65 206f 6e20 4846 532b 2069 7473 file on HFS+ its │ │ │ │ │ -000397a0: 206e 616d 6520 6d75 7374 2062 650a 7370 name must be.sp │ │ │ │ │ -000397b0: 6563 6966 6965 6420 696e 206e 6f72 6d61 ecified in norma │ │ │ │ │ -000397c0: 6c69 7361 7469 6f6e 2066 6f72 6d20 442e lisation form D. │ │ │ │ │ -000397d0: 204f 6e20 6e6f 726d 616c 697a 6564 205a On normalized Z │ │ │ │ │ -000397e0: 4653 2073 7562 766f 6c75 6d65 730a 6669 FS subvolumes.fi │ │ │ │ │ -000397f0: 6c65 6e61 6d65 7320 6f75 7420 6f66 206e lenames out of n │ │ │ │ │ -00039800: 6f72 6d61 6c69 7361 7469 6f6e 2061 7265 ormalisation are │ │ │ │ │ -00039810: 2069 6e61 6363 6573 7369 626c 652e 0a0a inaccessible... │ │ │ │ │ -00039820: 3137 2e33 204f 7574 7075 7420 7465 726d 17.3 Output term │ │ │ │ │ -00039830: 696e 616c 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d inal.=========== │ │ │ │ │ -00039840: 3d3d 3d3d 3d3d 3d3d 3d0a 0a46 6972 6d77 =========..Firmw │ │ │ │ │ -00039850: 6172 6520 6f75 7470 7574 2063 6f6e 736f are output conso │ │ │ │ │ -00039860: 6c65 2022 636f 6e73 6f6c 6522 206f 6e20 le "console" on │ │ │ │ │ -00039870: 4152 4320 616e 6420 4945 4545 3132 3735 ARC and IEEE1275 │ │ │ │ │ -00039880: 2061 7265 206c 696d 6974 6564 2074 6f0a are limited to. │ │ │ │ │ -00039890: 4153 4349 492e 0a0a 2020 2042 494f 5320 ASCII... BIOS │ │ │ │ │ -000398a0: 6669 726d 7761 7265 2063 6f6e 736f 6c65 firmware console │ │ │ │ │ -000398b0: 2061 6e64 2056 4741 2074 6578 7420 6172 and VGA text ar │ │ │ │ │ -000398c0: 6520 6c69 6d69 7465 6420 746f 2041 5343 e limited to ASC │ │ │ │ │ -000398d0: 4949 2061 6e64 2073 6f6d 650a 7073 6575 II and some.pseu │ │ │ │ │ -000398e0: 646f 6772 6170 6869 6373 2e0a 0a20 2020 dographics... │ │ │ │ │ -000398f0: 4e6f 6e65 206f 6620 6162 6f76 6520 6d65 None of above me │ │ │ │ │ -00039900: 6e74 696f 6e65 6420 6973 2061 7070 726f ntioned is appro │ │ │ │ │ -00039910: 7072 6961 7465 2066 6f72 2064 6973 706c priate for displ │ │ │ │ │ -00039920: 6179 696e 6720 696e 7465 726e 6174 696f aying internatio │ │ │ │ │ -00039930: 6e61 6c0a 616e 6420 616e 7920 756e 7375 nal.and any unsu │ │ │ │ │ -00039940: 7070 6f72 7465 6420 6368 6172 6163 7465 pported characte │ │ │ │ │ -00039950: 7220 6973 2072 6570 6c61 6365 6420 7769 r is replaced wi │ │ │ │ │ -00039960: 7468 2071 7565 7374 696f 6e20 6d61 726b th question mark │ │ │ │ │ -00039970: 2065 7863 6570 740a 7073 6575 646f 6772 except.pseudogr │ │ │ │ │ -00039980: 6170 6869 6373 2077 6869 6368 2077 6520 aphics which we │ │ │ │ │ -00039990: 6174 7465 6d70 7420 746f 2061 7070 726f attempt to appro │ │ │ │ │ -000399a0: 7869 6d61 7465 2077 6974 6820 4153 4349 ximate with ASCI │ │ │ │ │ -000399b0: 492e 0a0a 2020 2045 4649 2063 6f6e 736f I... EFI conso │ │ │ │ │ -000399c0: 6c65 206f 6e20 7468 6520 6f74 6865 7220 le on the other │ │ │ │ │ -000399d0: 6861 6e64 206e 6f6d 696e 616c 6c79 2073 hand nominally s │ │ │ │ │ -000399e0: 7570 706f 7274 7320 5554 462d 3136 2062 upports UTF-16 b │ │ │ │ │ -000399f0: 7574 2061 6374 7561 6c0a 6c61 6e67 7561 ut actual.langua │ │ │ │ │ -00039a00: 6765 2063 6f76 6572 6167 6520 6465 7065 ge coverage depe │ │ │ │ │ -00039a10: 6e64 7320 6f6e 2066 6972 6d77 6172 6520 nds on firmware │ │ │ │ │ -00039a20: 616e 6420 6d61 7920 6265 2076 6572 7920 and may be very │ │ │ │ │ -00039a30: 6c69 6d69 7465 642e 0a0a 2020 2054 6865 limited... The │ │ │ │ │ -00039a40: 2065 6e63 6f64 696e 6720 7573 6564 206f encoding used o │ │ │ │ │ -00039a50: 6e20 7365 7269 616c 2063 616e 2062 6520 n serial can be │ │ │ │ │ -00039a60: 6368 6f73 656e 2077 6974 6820 2774 6572 chosen with 'ter │ │ │ │ │ -00039a70: 6d69 6e66 6f27 2061 7320 6569 7468 6572 minfo' as either │ │ │ │ │ -00039a80: 0a41 5343 4949 2c20 5554 462d 3820 6f72 .ASCII, UTF-8 or │ │ │ │ │ -00039a90: 2022 7669 7375 616c 2055 5446 2d38 222e "visual UTF-8". │ │ │ │ │ -00039aa0: 2020 4c61 7374 206f 6e65 2069 7320 6167 Last one is ag │ │ │ │ │ -00039ab0: 6169 6e73 7420 7468 6520 7370 6563 6966 ainst the specif │ │ │ │ │ -00039ac0: 6963 6174 696f 6e0a 6275 7420 7265 7375 ication.but resu │ │ │ │ │ -00039ad0: 6c74 7320 696e 2063 6f72 7265 6374 2072 lts in correct r │ │ │ │ │ -00039ae0: 656e 6465 7269 6e67 206f 6620 7269 6768 endering of righ │ │ │ │ │ -00039af0: 742d 746f 2d6c 6566 7420 6f6e 2073 6f6d t-to-left on som │ │ │ │ │ -00039b00: 6520 7265 6164 6572 7320 7768 6963 680a e readers which. │ │ │ │ │ -00039b10: 646f 6e27 7420 6861 7665 206f 776e 2062 don't have own b │ │ │ │ │ -00039b20: 6964 6920 696d 706c 656d 656e 7461 7469 idi implementati │ │ │ │ │ -00039b30: 6f6e 2e0a 0a20 2020 4f6e 2065 6d75 2047 on... On emu G │ │ │ │ │ -00039b40: 5255 4220 6368 6563 6b73 2069 6620 6368 RUB checks if ch │ │ │ │ │ -00039b50: 6172 7365 7420 6973 2055 5446 2d38 2061 arset is UTF-8 a │ │ │ │ │ -00039b60: 6e64 2075 7365 7320 6974 2069 6620 736f nd uses it if so │ │ │ │ │ -00039b70: 2061 6e64 2075 7365 730a 4153 4349 4920 and uses.ASCII │ │ │ │ │ -00039b80: 6f74 6865 7277 6973 652e 0a0a 2020 2057 otherwise... W │ │ │ │ │ -00039b90: 6865 6e20 7573 696e 6720 6766 7874 6572 hen using gfxter │ │ │ │ │ -00039ba0: 6d20 6f72 2067 6678 6d65 6e75 2047 5255 m or gfxmenu GRU │ │ │ │ │ -00039bb0: 4220 6974 7365 6c66 2069 7320 7265 7370 B itself is resp │ │ │ │ │ -00039bc0: 6f6e 7369 626c 6520 666f 720a 7265 6e64 onsible for.rend │ │ │ │ │ -00039bd0: 6572 696e 6720 7468 6520 7465 7874 2e20 ering the text. │ │ │ │ │ -00039be0: 2049 6e20 7468 6973 2063 6173 6520 4752 In this case GR │ │ │ │ │ -00039bf0: 5542 2069 7320 6c69 6d69 7465 6420 6279 UB is limited by │ │ │ │ │ -00039c00: 206c 6f61 6465 6420 666f 6e74 732e 2020 loaded fonts. │ │ │ │ │ -00039c10: 4966 0a66 6f6e 7473 2063 6f6e 7461 696e If.fonts contain │ │ │ │ │ -00039c20: 2061 6c6c 2072 6571 7569 7265 6420 6368 all required ch │ │ │ │ │ -00039c30: 6172 6163 7465 7273 2074 6865 6e20 6269 aracters then bi │ │ │ │ │ -00039c40: 6469 7265 6374 696f 6e61 6c20 7465 7874 directional text │ │ │ │ │ -00039c50: 2c20 6375 7273 6976 650a 7661 7269 616e , cursive.varian │ │ │ │ │ -00039c60: 7473 2061 6e64 2063 6f6d 6269 6e69 6e67 ts and combining │ │ │ │ │ -00039c70: 206d 6172 6b73 206f 7468 6572 2074 6861 marks other tha │ │ │ │ │ -00039c80: 6e20 656e 636c 6f73 696e 672c 2068 616c n enclosing, hal │ │ │ │ │ -00039c90: 6620 2865 2e67 2e20 206c 6566 7420 6861 f (e.g. left ha │ │ │ │ │ -00039ca0: 6c66 0a74 696c 6465 206f 7220 636f 6d62 lf.tilde or comb │ │ │ │ │ -00039cb0: 696e 696e 6720 6f76 6572 6c69 6e65 2920 ining overline) │ │ │ │ │ -00039cc0: 616e 6420 646f 7562 6c65 206f 6e65 732e and double ones. │ │ │ │ │ -00039cd0: 2020 4c69 6761 7475 7265 7320 6172 656e Ligatures aren │ │ │ │ │ -00039ce0: 2774 0a73 7570 706f 7274 6564 2074 686f 't.supported tho │ │ │ │ │ -00039cf0: 7567 682e 2020 5468 6973 2073 686f 756c ugh. This shoul │ │ │ │ │ -00039d00: 6420 636f 7665 7220 4575 726f 7065 616e d cover European │ │ │ │ │ -00039d10: 2c20 4d69 6464 6c65 2045 6173 7465 726e , Middle Eastern │ │ │ │ │ -00039d20: 2028 6966 2079 6f75 0a64 6f6e 2774 206d (if you.don't m │ │ │ │ │ -00039d30: 696e 6420 6c61 636b 206f 6620 6c61 6d2d ind lack of lam- │ │ │ │ │ -00039d40: 616c 6966 206c 6967 6174 7572 6520 696e alif ligature in │ │ │ │ │ -00039d50: 2041 7261 6269 6329 2061 6e64 2045 6173 Arabic) and Eas │ │ │ │ │ -00039d60: 7420 4173 6961 6e20 7363 7269 7074 732e t Asian scripts. │ │ │ │ │ -00039d70: 0a4e 6f74 6162 6c65 2075 6e73 7570 706f .Notable unsuppo │ │ │ │ │ -00039d80: 7274 6564 2073 6372 6970 7473 2061 7265 rted scripts are │ │ │ │ │ -00039d90: 2042 7261 686d 6963 2066 616d 696c 7920 Brahmic family │ │ │ │ │ -00039da0: 616e 6420 6465 7269 7665 6420 6173 2077 and derived as w │ │ │ │ │ -00039db0: 656c 6c20 6173 0a4d 6f6e 676f 6c69 616e ell as.Mongolian │ │ │ │ │ -00039dc0: 2c20 5469 6669 6e61 6768 2c20 4b6f 7265 , Tifinagh, Kore │ │ │ │ │ -00039dd0: 616e 204a 616d 6f20 2870 7265 636f 6d70 an Jamo (precomp │ │ │ │ │ -00039de0: 6f73 6564 2063 6861 7261 6374 6572 7320 osed characters │ │ │ │ │ -00039df0: 6861 7665 206e 6f0a 7072 6f62 6c65 6d29 have no.problem) │ │ │ │ │ -00039e00: 2061 6e64 2074 6f6e 616c 2077 7269 7469 and tonal writi │ │ │ │ │ -00039e10: 6e67 2028 3265 352d 3265 3929 2e20 2047 ng (2e5-2e9). G │ │ │ │ │ -00039e20: 5255 4220 616c 736f 2069 676e 6f72 6573 RUB also ignores │ │ │ │ │ -00039e30: 2064 6570 7265 6361 7465 6420 2861 730a deprecated (as. │ │ │ │ │ -00039e40: 7370 6563 6966 6965 6420 696e 2055 6e69 specified in Uni │ │ │ │ │ -00039e50: 636f 6465 2920 6368 6172 6163 7465 7273 code) characters │ │ │ │ │ -00039e60: 2028 652e 672e 2020 7461 6773 292e 2020 (e.g. tags). │ │ │ │ │ -00039e70: 4752 5542 2061 6c73 6f20 646f 6573 6e27 GRUB also doesn' │ │ │ │ │ -00039e80: 7420 6861 6e64 6c65 0a73 6f20 6361 6c6c t handle.so call │ │ │ │ │ -00039e90: 6564 2022 616e 6e6f 7461 7469 6f6e 2063 ed "annotation c │ │ │ │ │ -00039ea0: 6861 7261 6374 6572 7322 2049 6620 796f haracters" If yo │ │ │ │ │ -00039eb0: 7520 6361 6e20 636f 6d70 6c65 7465 2065 u can complete e │ │ │ │ │ -00039ec0: 6974 6865 7220 6f66 2074 776f 0a6c 6973 ither of two.lis │ │ │ │ │ -00039ed0: 7473 206f 722c 2062 6574 7465 722c 2070 ts or, better, p │ │ │ │ │ -00039ee0: 726f 706f 7365 2061 2070 6174 6368 2074 ropose a patch t │ │ │ │ │ -00039ef0: 6f20 696d 7072 6f76 6520 7265 6e64 6572 o improve render │ │ │ │ │ -00039f00: 696e 672c 2070 6c65 6173 6520 636f 6e74 ing, please cont │ │ │ │ │ -00039f10: 6163 740a 6465 7665 6c6f 7065 7220 7465 act.developer te │ │ │ │ │ -00039f20: 616d 2e0a 0a31 372e 3420 496e 7075 7420 am...17.4 Input │ │ │ │ │ -00039f30: 7465 726d 696e 616c 0a3d 3d3d 3d3d 3d3d terminal.======= │ │ │ │ │ -00039f40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4669 ============..Fi │ │ │ │ │ -00039f50: 726d 7761 7265 2063 6f6e 736f 6c65 206f rmware console o │ │ │ │ │ -00039f60: 6e20 4249 4f53 2c20 4945 4545 3132 3735 n BIOS, IEEE1275 │ │ │ │ │ -00039f70: 2061 6e64 2041 5243 2064 6f65 736e 2774 and ARC doesn't │ │ │ │ │ -00039f80: 2061 6c6c 6f77 2079 6f75 2074 6f20 656e allow you to en │ │ │ │ │ -00039f90: 7465 720a 6e6f 6e2d 4153 4349 4920 6368 ter.non-ASCII ch │ │ │ │ │ -00039fa0: 6172 6163 7465 7273 2e20 2045 4649 2073 aracters. EFI s │ │ │ │ │ -00039fb0: 7065 6369 6669 6361 7469 6f6e 2061 6c6c pecification all │ │ │ │ │ -00039fc0: 6f77 7320 666f 7220 7375 6368 2062 7574 ows for such but │ │ │ │ │ -00039fd0: 2061 7574 686f 7220 6973 0a75 6e61 7761 author is.unawa │ │ │ │ │ -00039fe0: 7265 206f 6620 616e 7920 6163 7475 616c re of any actual │ │ │ │ │ -00039ff0: 2069 6d70 6c65 6d65 6e74 6174 696f 6e73 implementations │ │ │ │ │ -0003a000: 2e20 2053 6572 6961 6c20 696e 7075 7420 . Serial input │ │ │ │ │ -0003a010: 6973 2063 7572 7265 6e74 6c79 0a6c 696d is currently.lim │ │ │ │ │ -0003a020: 6974 6564 2066 6f72 206c 6174 696e 3120 ited for latin1 │ │ │ │ │ -0003a030: 2875 6e6c 696b 656c 7920 746f 2063 6861 (unlikely to cha │ │ │ │ │ -0003a040: 6e67 6529 2e20 204f 776e 206b 6579 626f nge). Own keybo │ │ │ │ │ -0003a050: 6172 6420 696d 706c 656d 656e 7461 7469 ard implementati │ │ │ │ │ -0003a060: 6f6e 730a 2861 745f 6b65 7962 6f61 7264 ons.(at_keyboard │ │ │ │ │ -0003a070: 2061 6e64 2075 7362 5f6b 6579 626f 6172 and usb_keyboar │ │ │ │ │ -0003a080: 6429 2073 7570 706f 7274 7320 616e 7920 d) supports any │ │ │ │ │ -0003a090: 6b65 7920 6275 7420 776f 726b 206f 6e0a key but work on. │ │ │ │ │ -0003a0a0: 6f6e 652d 6368 6172 2d70 6572 2d6b 6579 one-char-per-key │ │ │ │ │ -0003a0b0: 7374 726f 6b65 2e20 2053 6f20 6e6f 2064 stroke. So no d │ │ │ │ │ -0003a0c0: 6561 6420 6b65 7973 206f 7220 6164 7661 ead keys or adva │ │ │ │ │ -0003a0d0: 6e63 6564 2069 6e70 7574 206d 6574 686f nced input metho │ │ │ │ │ -0003a0e0: 642e 2020 416c 736f 0a74 6865 7265 2069 d. Also.there i │ │ │ │ │ -0003a0f0: 7320 6e6f 206b 6579 6d61 7020 6368 616e s no keymap chan │ │ │ │ │ -0003a100: 6765 2068 6f74 6b65 792e 2020 496e 2070 ge hotkey. In p │ │ │ │ │ -0003a110: 7261 6374 6963 6520 6974 206d 616b 6573 ractice it makes │ │ │ │ │ -0003a120: 2064 6966 6669 6375 6c74 2074 6f0a 656e difficult to.en │ │ │ │ │ -0003a130: 7465 7220 616e 7920 7465 7874 2075 7369 ter any text usi │ │ │ │ │ -0003a140: 6e67 206e 6f6e 2d4c 6174 696e 2061 6c70 ng non-Latin alp │ │ │ │ │ -0003a150: 6861 6265 742e 2020 4d6f 7265 6f76 6572 habet. Moreover │ │ │ │ │ -0003a160: 2061 6c6c 2063 7572 7265 6e74 2069 6e70 all current inp │ │ │ │ │ -0003a170: 7574 0a63 6f6e 7375 6d65 7273 2061 7265 ut.consumers are │ │ │ │ │ -0003a180: 206c 696d 6974 6564 2074 6f20 4153 4349 limited to ASCI │ │ │ │ │ -0003a190: 492e 0a0a 3137 2e35 2047 6574 7465 7874 I...17.5 Gettext │ │ │ │ │ -0003a1a0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a47 .============..G │ │ │ │ │ -0003a1b0: 5255 4220 7375 7070 6f72 7473 2062 6569 RUB supports bei │ │ │ │ │ -0003a1c0: 6e67 2074 7261 6e73 6c61 7465 642e 2020 ng translated. │ │ │ │ │ -0003a1d0: 466f 7220 7468 6973 2079 6f75 206e 6565 For this you nee │ │ │ │ │ -0003a1e0: 6420 746f 2068 6176 6520 6c61 6e67 7561 d to have langua │ │ │ │ │ -0003a1f0: 6765 202a 2e6d 6f0a 6669 6c65 7320 696e ge *.mo.files in │ │ │ │ │ -0003a200: 2024 7072 6566 6978 2f6c 6f63 616c 652c $prefix/locale, │ │ │ │ │ -0003a210: 206c 6f61 6420 6765 7474 6578 7420 6d6f load gettext mo │ │ │ │ │ -0003a220: 6475 6c65 2061 6e64 2073 6574 2022 6c61 dule and set "la │ │ │ │ │ -0003a230: 6e67 2220 7661 7269 6162 6c65 2e0a 0a31 ng" variable...1 │ │ │ │ │ -0003a240: 372e 3620 5265 6765 7870 0a3d 3d3d 3d3d 7.6 Regexp.===== │ │ │ │ │ -0003a250: 3d3d 3d3d 3d3d 0a0a 5265 6765 7870 7320 ======..Regexps │ │ │ │ │ -0003a260: 776f 726b 206f 6e20 756e 6963 6f64 6520 work on unicode │ │ │ │ │ -0003a270: 6368 6172 6163 7465 7273 2c20 686f 7765 characters, howe │ │ │ │ │ -0003a280: 7665 7220 6e6f 2061 7474 656d 7074 2061 ver no attempt a │ │ │ │ │ -0003a290: 7420 6368 6563 6b69 6e67 0a63 616e 6e6f t checking.canno │ │ │ │ │ -0003a2a0: 6e69 6361 6c20 6571 7569 7661 6c65 6e63 nical equivalenc │ │ │ │ │ -0003a2b0: 6520 6861 7320 6265 656e 206d 6164 652e e has been made. │ │ │ │ │ -0003a2c0: 2020 4d6f 7265 6f76 6572 2074 6865 2063 Moreover the c │ │ │ │ │ -0003a2d0: 6c61 7373 6573 206c 696b 650a 5b3a 616c lasses like.[:al │ │ │ │ │ -0003a2e0: 7068 613a 5d20 6d61 7463 6820 6f6e 6c79 pha:] match only │ │ │ │ │ -0003a2f0: 2041 5343 4949 2073 7562 7365 742e 0a0a ASCII subset... │ │ │ │ │ -0003a300: 3137 2e37 204f 7468 6572 0a3d 3d3d 3d3d 17.7 Other.===== │ │ │ │ │ -0003a310: 3d3d 3d3d 3d0a 0a43 7572 7265 6e74 6c79 =====..Currently │ │ │ │ │ -0003a320: 2047 5255 4220 616c 7761 7973 2075 7365 GRUB always use │ │ │ │ │ -0003a330: 7320 5945 4152 2d4d 4f4e 5448 2d44 4159 s YEAR-MONTH-DAY │ │ │ │ │ -0003a340: 2048 4f55 523a 4d49 4e55 5445 3a53 4543 HOUR:MINUTE:SEC │ │ │ │ │ -0003a350: 4f4e 4420 5b57 4545 4b44 4159 5d0a 3234 OND [WEEKDAY].24 │ │ │ │ │ -0003a360: 2d68 6f75 7220 6461 7465 7469 6d65 2066 -hour datetime f │ │ │ │ │ -0003a370: 6f72 6d61 7420 6275 7420 7765 656b 6461 ormat but weekda │ │ │ │ │ -0003a380: 7973 2061 7265 2074 7261 6e73 6c61 7465 ys are translate │ │ │ │ │ -0003a390: 642e 2020 4752 5542 2061 6c77 6179 7320 d. GRUB always │ │ │ │ │ -0003a3a0: 7573 6573 0a74 6865 2064 6563 696d 616c uses.the decimal │ │ │ │ │ -0003a3b0: 206e 756d 6265 7220 666f 726d 6174 2077 number format w │ │ │ │ │ -0003a3c0: 6974 6820 5b30 2d39 5d20 6173 2064 6967 ith [0-9] as dig │ │ │ │ │ -0003a3d0: 6974 7320 616e 6420 2e20 2061 7320 6465 its and . as de │ │ │ │ │ -0003a3e0: 7363 696d 616c 0a73 6570 6172 6174 6f72 scimal.separator │ │ │ │ │ -0003a3f0: 2061 6e64 206e 6f20 6772 6f75 7020 7365 and no group se │ │ │ │ │ -0003a400: 7061 7261 746f 722e 2020 4945 4545 3132 parator. IEEE12 │ │ │ │ │ -0003a410: 3735 2061 6c69 6173 6573 2061 7265 206d 75 aliases are m │ │ │ │ │ -0003a420: 6174 6368 6564 0a63 6173 652d 696e 7365 atched.case-inse │ │ │ │ │ -0003a430: 6e73 6974 6976 656c 7920 6578 6365 7074 nsitively except │ │ │ │ │ -0003a440: 206e 6f6e 2d41 5343 4949 2077 6869 6368 non-ASCII which │ │ │ │ │ -0003a450: 2069 7320 6d61 7463 6865 6420 6173 2062 is matched as b │ │ │ │ │ -0003a460: 696e 6172 792e 2020 5369 6d69 6c61 720a inary. Similar. │ │ │ │ │ -0003a470: 6265 6861 7669 6f75 7220 6973 2066 6f72 behaviour is for │ │ │ │ │ -0003a480: 206d 6174 6368 696e 6720 4f53 4275 6e64 matching OSBund │ │ │ │ │ -0003a490: 6c65 5265 7175 6972 6564 2e20 2053 696e leRequired. Sin │ │ │ │ │ -0003a4a0: 6365 2049 4545 4531 3237 3520 616c 6961 ce IEEE1275 alia │ │ │ │ │ -0003a4b0: 7365 7320 616e 640a 4f53 4275 6e64 6c65 ses and.OSBundle │ │ │ │ │ -0003a4c0: 5265 7175 6972 6564 2064 6f6e 2774 2063 Required don't c │ │ │ │ │ -0003a4d0: 6f6e 7461 696e 2061 6e79 206e 6f6e 2d41 ontain any non-A │ │ │ │ │ -0003a4e0: 5343 4949 2069 7420 7368 6f75 6c64 206e SCII it should n │ │ │ │ │ -0003a4f0: 6576 6572 2062 6520 610a 7072 6f62 6c65 ever be a.proble │ │ │ │ │ -0003a500: 6d20 696e 2070 7261 6374 6963 652e 2020 m in practice. │ │ │ │ │ -0003a510: 4361 7365 2d73 656e 7369 7469 7665 2069 Case-sensitive i │ │ │ │ │ -0003a520: 6465 6e74 6966 6965 7273 2061 7265 206d dentifiers are m │ │ │ │ │ -0003a530: 6174 6368 6564 2061 7320 7261 770a 7374 atched as raw.st │ │ │ │ │ -0003a540: 7269 6e67 732c 206e 6f20 6361 6e6f 6e69 rings, no canoni │ │ │ │ │ -0003a550: 6361 6c20 6571 7569 7661 6c65 6e63 6520 cal equivalence │ │ │ │ │ -0003a560: 6368 6563 6b20 6973 2070 6572 666f 726d check is perform │ │ │ │ │ -0003a570: 6564 2e20 2043 6173 652d 696e 7365 6e73 ed. Case-insens │ │ │ │ │ -0003a580: 7469 7665 0a69 6465 6e74 6966 6965 7273 tive.identifiers │ │ │ │ │ -0003a590: 2061 7265 206d 6174 6368 6564 2061 7320 are matched as │ │ │ │ │ -0003a5a0: 5241 5720 6275 7420 6164 6469 7469 6f6e RAW but addition │ │ │ │ │ -0003a5b0: 616c 6c79 205b 612d 7a5d 2069 7320 6571 ally [a-z] is eq │ │ │ │ │ -0003a5c0: 7569 7661 6c65 6e74 2074 6f0a 5b41 2d5a uivalent to.[A-Z │ │ │ │ │ -0003a5d0: 5d2e 2047 5255 422d 6465 6669 6e65 6420 ]. GRUB-defined │ │ │ │ │ -0003a5e0: 6964 656e 7469 6669 6572 7320 7573 6520 identifiers use │ │ │ │ │ -0003a5f0: 6f6e 6c79 2041 5343 4949 2061 6e64 2073 only ASCII and s │ │ │ │ │ -0003a600: 6f20 7368 6f75 6c64 0a75 7365 722d 6465 o should.user-de │ │ │ │ │ -0003a610: 6669 6e65 6420 6f6e 6573 2e20 2049 6465 fined ones. Ide │ │ │ │ │ -0003a620: 6e74 6966 6965 7273 2063 6f6e 7461 696e ntifiers contain │ │ │ │ │ -0003a630: 696e 6720 6e6f 6e2d 4153 4349 4920 6d61 ing non-ASCII ma │ │ │ │ │ -0003a640: 7920 776f 726b 2062 7574 2061 7265 6e27 y work but aren' │ │ │ │ │ -0003a650: 740a 7375 7070 6f72 7465 642e 2020 4f6e t.supported. On │ │ │ │ │ -0003a660: 6c79 2074 6865 2041 5343 4949 2073 7061 ly the ASCII spa │ │ │ │ │ -0003a670: 6365 2063 6861 7261 6374 6572 7320 2873 ce characters (s │ │ │ │ │ -0003a680: 7061 6365 2055 2b30 3032 302c 2074 6162 pace U+0020, tab │ │ │ │ │ -0003a690: 2055 2b30 3030 622c 0a43 5220 552b 3030 U+000b,.CR U+00 │ │ │ │ │ -0003a6a0: 3064 2061 6e64 204c 4620 552b 3030 3061 0d and LF U+000a │ │ │ │ │ -0003a6b0: 2920 6172 6520 7265 636f 676e 6973 6564 ) are recognised │ │ │ │ │ -0003a6c0: 2e20 204f 7468 6572 2075 6e69 636f 6465 . Other unicode │ │ │ │ │ -0003a6d0: 2073 7061 6365 2063 6861 7261 6374 6572 space character │ │ │ │ │ -0003a6e0: 730a 6172 656e 2774 2061 2076 616c 6964 s.aren't a valid │ │ │ │ │ -0003a6f0: 2066 6965 6c64 2073 6570 6172 6174 6f72 field separator │ │ │ │ │ -0003a700: 2e20 2027 7465 7374 2720 282a 6e6f 7465 . 'test' (*note │ │ │ │ │ -0003a710: 2074 6573 743a 3a29 2074 6573 7473 203c test::) tests < │ │ │ │ │ -0003a720: 2c20 3e2c 203c 3d2c 0a3e 3d2c 202d 7067 , >, <=,.>=, -pg │ │ │ │ │ -0003a730: 7420 616e 6420 2d70 6c74 2063 6f6d 7061 t and -plt compa │ │ │ │ │ -0003a740: 7265 2074 6865 2073 7472 696e 6773 2069 re the strings i │ │ │ │ │ -0003a750: 6e20 7468 6520 6c65 7869 636f 6772 6170 n the lexicograp │ │ │ │ │ -0003a760: 6869 6361 6c20 6f72 6465 7220 6f66 0a75 hical order of.u │ │ │ │ │ -0003a770: 6e69 636f 6465 2063 6f64 6570 6f69 6e74 nicode codepoint │ │ │ │ │ -0003a780: 732c 2072 6570 6c69 6361 7469 6e67 2074 s, replicating t │ │ │ │ │ -0003a790: 6865 2062 6568 6176 696f 7572 206f 6620 he behaviour of │ │ │ │ │ -0003a7a0: 7465 7374 2066 726f 6d20 636f 7265 7574 test from coreut │ │ │ │ │ -0003a7b0: 696c 732e 0a65 6e76 6972 6f6e 6d65 6e74 ils..environment │ │ │ │ │ -0003a7c0: 2076 6172 6961 626c 6573 2061 6e64 2063 variables and c │ │ │ │ │ -0003a7d0: 6f6d 6d61 6e64 7320 6172 6520 6c69 7374 ommands are list │ │ │ │ │ -0003a7e0: 6564 2069 6e20 7468 6520 7361 6d65 206f ed in the same o │ │ │ │ │ -0003a7f0: 7264 6572 2e0a 0a1f 0a46 696c 653a 2067 rder.....File: g │ │ │ │ │ -0003a800: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0003a810: 2053 6563 7572 6974 792c 2020 4e65 7874 Security, Next │ │ │ │ │ -0003a820: 3a20 506c 6174 666f 726d 206c 696d 6974 : Platform limit │ │ │ │ │ -0003a830: 6174 696f 6e73 2c20 2050 7265 763a 2049 ations, Prev: I │ │ │ │ │ -0003a840: 6e74 6572 6e61 7469 6f6e 616c 6973 6174 nternationalisat │ │ │ │ │ -0003a850: 696f 6e2c 2020 5570 3a20 546f 700a 0a31 ion, Up: Top..1 │ │ │ │ │ -0003a860: 3820 5365 6375 7269 7479 0a2a 2a2a 2a2a 8 Security.***** │ │ │ │ │ -0003a870: 2a2a 2a2a 2a2a 0a0a 2a20 4d65 6e75 3a0a ******..* Menu:. │ │ │ │ │ -0003a880: 0a2a 2041 7574 6865 6e74 6963 6174 696f .* Authenticatio │ │ │ │ │ -0003a890: 6e20 616e 6420 6175 7468 6f72 6973 6174 n and authorisat │ │ │ │ │ -0003a8a0: 696f 6e3a 3a20 5573 6572 7320 616e 6420 ion:: Users and │ │ │ │ │ -0003a8b0: 6163 6365 7373 2063 6f6e 7472 6f6c 0a2a access control.* │ │ │ │ │ -0003a8c0: 2055 7369 6e67 2064 6967 6974 616c 2073 Using digital s │ │ │ │ │ -0003a8d0: 6967 6e61 7475 7265 733a 3a20 2020 2020 ignatures:: │ │ │ │ │ -0003a8e0: 2020 2020 426f 6f74 696e 6720 6469 6769 Booting digi │ │ │ │ │ -0003a8f0: 7461 6c6c 7920 7369 676e 6564 2063 6f64 tally signed cod │ │ │ │ │ -0003a900: 650a 2a20 5545 4649 2073 6563 7572 6520 e.* UEFI secure │ │ │ │ │ -0003a910: 626f 6f74 2061 6e64 2073 6869 6d3a 3a20 boot and shim:: │ │ │ │ │ -0003a920: 2020 2020 2020 2042 6f6f 7469 6e67 2064 Booting d │ │ │ │ │ -0003a930: 6967 6974 616c 6c79 2073 6967 6e65 6420 igitally signed │ │ │ │ │ -0003a940: 5045 2066 696c 6573 0a2a 2053 6563 7572 PE files.* Secur │ │ │ │ │ -0003a950: 6520 426f 6f74 2041 6476 616e 6365 6420 e Boot Advanced │ │ │ │ │ -0003a960: 5461 7267 6574 696e 673a 3a20 2020 456d Targeting:: Em │ │ │ │ │ -0003a970: 6265 6464 6564 2069 6e66 6f72 6d61 7469 bedded informati │ │ │ │ │ -0003a980: 6f6e 2066 6f72 2067 656e 6572 6174 696f on for generatio │ │ │ │ │ -0003a990: 6e20 6e75 6d62 6572 2062 6173 6564 2072 n number based r │ │ │ │ │ -0003a9a0: 6576 6f63 6174 696f 6e0a 2a20 4d65 6173 evocation.* Meas │ │ │ │ │ -0003a9b0: 7572 6564 2042 6f6f 743a 3a20 2020 2020 ured Boot:: │ │ │ │ │ -0003a9c0: 2020 2020 2020 2020 2020 2020 2020 204d M │ │ │ │ │ -0003a9d0: 6561 7375 7269 6e67 2062 6f6f 7420 636f easuring boot co │ │ │ │ │ -0003a9e0: 6d70 6f6e 656e 7473 0a2a 204c 6f63 6b64 mponents.* Lockd │ │ │ │ │ -0003a9f0: 6f77 6e3a 3a20 2020 2020 2020 2020 2020 own:: │ │ │ │ │ -0003aa00: 2020 2020 2020 2020 2020 2020 2020 4c6f Lo │ │ │ │ │ -0003aa10: 636b 646f 776e 2077 6865 6e20 626f 6f74 ckdown when boot │ │ │ │ │ -0003aa20: 696e 6720 6f6e 2061 2073 6563 7572 6520 ing on a secure │ │ │ │ │ -0003aa30: 7365 7475 700a 0a1f 0a46 696c 653a 2067 setup....File: g │ │ │ │ │ -0003aa40: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0003aa50: 2041 7574 6865 6e74 6963 6174 696f 6e20 Authentication │ │ │ │ │ -0003aa60: 616e 6420 6175 7468 6f72 6973 6174 696f and authorisatio │ │ │ │ │ -0003aa70: 6e2c 2020 4e65 7874 3a20 5573 696e 6720 n, Next: Using │ │ │ │ │ -0003aa80: 6469 6769 7461 6c20 7369 676e 6174 7572 digital signatur │ │ │ │ │ -0003aa90: 6573 2c20 2055 703a 2053 6563 7572 6974 es, Up: Securit │ │ │ │ │ -0003aaa0: 790a 0a31 382e 3120 4175 7468 656e 7469 y..18.1 Authenti │ │ │ │ │ -0003aab0: 6361 7469 6f6e 2061 6e64 2061 7574 686f cation and autho │ │ │ │ │ -0003aac0: 7269 7361 7469 6f6e 2069 6e20 4752 5542 risation in GRUB │ │ │ │ │ -0003aad0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ +00038dd0: 2a2a 2a2a 0a0a 3137 2e31 2043 6861 7273 ****..17.1 Chars │ │ │ │ │ +00038de0: 6574 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a et.============. │ │ │ │ │ +00038df0: 0a47 5255 4220 7573 6573 2055 5446 2d38 .GRUB uses UTF-8 │ │ │ │ │ +00038e00: 2069 6e74 6572 6e61 6c6c 7920 6f74 6865 internally othe │ │ │ │ │ +00038e10: 7220 7468 616e 2069 6e20 7265 6e64 6572 r than in render │ │ │ │ │ +00038e20: 696e 6720 7768 6572 6520 736f 6d65 0a47 ing where some.G │ │ │ │ │ +00038e30: 5255 422d 7370 6563 6966 6963 2061 7070 RUB-specific app │ │ │ │ │ +00038e40: 726f 7072 6961 7465 2072 6570 7265 7365 ropriate represe │ │ │ │ │ +00038e50: 6e74 6174 696f 6e20 6973 2075 7365 642e ntation is used. │ │ │ │ │ +00038e60: 2020 416c 6c20 7465 7874 2066 696c 6573 All text files │ │ │ │ │ +00038e70: 0a28 696e 636c 7564 696e 6720 636f 6e66 .(including conf │ │ │ │ │ +00038e80: 6967 2920 6172 6520 6173 7375 6d65 6420 ig) are assumed │ │ │ │ │ +00038e90: 746f 2062 6520 656e 636f 6465 6420 696e to be encoded in │ │ │ │ │ +00038ea0: 2055 5446 2d38 2e0a 0a31 372e 3220 4669 UTF-8...17.2 Fi │ │ │ │ │ +00038eb0: 6c65 7379 7374 656d 730a 3d3d 3d3d 3d3d lesystems.====== │ │ │ │ │ +00038ec0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4e54 4653 ==========..NTFS │ │ │ │ │ +00038ed0: 2c20 4a46 532c 2055 4446 2c20 4846 532b , JFS, UDF, HFS+ │ │ │ │ │ +00038ee0: 2c20 6578 4641 542c 206c 6f6e 6720 6669 , exFAT, long fi │ │ │ │ │ +00038ef0: 6c65 6e61 6d65 7320 696e 2046 4154 2c20 lenames in FAT, │ │ │ │ │ +00038f00: 4a6f 6c69 6574 2070 6172 7420 6f66 0a49 Joliet part of.I │ │ │ │ │ +00038f10: 534f 3936 3630 2061 7265 2074 7265 6174 SO9660 are treat │ │ │ │ │ +00038f20: 6564 2061 7320 5554 462d 3136 2061 7320 ed as UTF-16 as │ │ │ │ │ +00038f30: 7065 7220 7370 6563 6966 6963 6174 696f per specificatio │ │ │ │ │ +00038f40: 6e2e 2020 4146 5320 616e 6420 4246 5320 n. AFS and BFS │ │ │ │ │ +00038f50: 6172 650a 7265 6164 2061 7320 5554 462d are.read as UTF- │ │ │ │ │ +00038f60: 382c 2061 6761 696e 2061 6363 6f72 6469 8, again accordi │ │ │ │ │ +00038f70: 6e67 2074 6f20 7370 6563 6966 6963 6174 ng to specificat │ │ │ │ │ +00038f80: 696f 6e2e 2020 4274 7246 532c 2063 7069 ion. BtrFS, cpi │ │ │ │ │ +00038f90: 6f2c 2074 6172 2c0a 7371 7561 7368 342c o, tar,.squash4, │ │ │ │ │ +00038fa0: 206d 696e 6978 2c20 6d69 6e69 7832 2c20 minix, minix2, │ │ │ │ │ +00038fb0: 6d69 6e69 7833 2c20 524f 4d46 532c 2052 minix3, ROMFS, R │ │ │ │ │ +00038fc0: 6569 7365 7246 532c 2058 4653 2c20 6578 eiserFS, XFS, ex │ │ │ │ │ +00038fd0: 7432 2c20 6578 7433 2c20 6578 7434 2c0a t2, ext3, ext4,. │ │ │ │ │ +00038fe0: 4641 5420 2873 686f 7274 206e 616d 6573 FAT (short names │ │ │ │ │ +00038ff0: 292c 2046 3246 532c 2052 6f63 6b52 6964 ), F2FS, RockRid │ │ │ │ │ +00039000: 6765 2070 6172 7420 6f66 2049 534f 3936 ge part of ISO96 │ │ │ │ │ +00039010: 3630 2c20 6e69 6c66 7332 2c20 5546 5331 60, nilfs2, UFS1 │ │ │ │ │ +00039020: 2c20 5546 5332 0a61 6e64 205a 4653 2061 , UFS2.and ZFS a │ │ │ │ │ +00039030: 7265 2061 7373 756d 6564 2074 6f20 6265 re assumed to be │ │ │ │ │ +00039040: 2055 5446 2d38 2e20 2054 6869 7320 6d69 UTF-8. This mi │ │ │ │ │ +00039050: 6768 7420 6265 2066 616c 7365 206f 6e20 ght be false on │ │ │ │ │ +00039060: 7379 7374 656d 730a 636f 6e66 6967 7572 systems.configur │ │ │ │ │ +00039070: 6564 2077 6974 6820 6c65 6761 6379 2063 ed with legacy c │ │ │ │ │ +00039080: 6861 7273 6574 2062 7574 2061 7320 6c6f harset but as lo │ │ │ │ │ +00039090: 6e67 2061 7320 7468 6520 6368 6172 7365 ng as the charse │ │ │ │ │ +000390a0: 7420 7573 6564 2069 730a 7375 7065 7273 t used is.supers │ │ │ │ │ +000390b0: 6574 206f 6620 4153 4349 4920 796f 7520 et of ASCII you │ │ │ │ │ +000390c0: 7368 6f75 6c64 2062 6520 6162 6c65 2074 should be able t │ │ │ │ │ +000390d0: 6f20 6163 6365 7373 2041 5343 4949 2d6e o access ASCII-n │ │ │ │ │ +000390e0: 616d 6564 2066 696c 6573 2e20 2041 6e64 amed files. And │ │ │ │ │ +000390f0: 0a69 7427 7320 7265 636f 6d6d 656e 6465 .it's recommende │ │ │ │ │ +00039100: 6420 746f 2063 6f6e 6669 6775 7265 2079 d to configure y │ │ │ │ │ +00039110: 6f75 7220 7379 7374 656d 2074 6f20 7573 our system to us │ │ │ │ │ +00039120: 6520 5554 462d 3820 746f 2061 6363 6573 e UTF-8 to acces │ │ │ │ │ +00039130: 7320 7468 650a 6669 6c65 7379 7374 656d s the.filesystem │ │ │ │ │ +00039140: 2c20 636f 6e76 6d76 206d 6179 2068 656c , convmv may hel │ │ │ │ │ +00039150: 7020 7769 7468 206d 6967 7261 7469 6f6e p with migration │ │ │ │ │ +00039160: 2e20 2049 534f 3936 3630 2028 706c 6169 . ISO9660 (plai │ │ │ │ │ +00039170: 6e29 2066 696c 656e 616d 6573 0a61 7265 n) filenames.are │ │ │ │ │ +00039180: 2073 7065 6369 6669 6564 2061 7320 6265 specified as be │ │ │ │ │ +00039190: 696e 6720 4153 4349 4920 6f72 2062 6569 ing ASCII or bei │ │ │ │ │ +000391a0: 6e67 2064 6573 6372 6962 6564 2077 6974 ng described wit │ │ │ │ │ +000391b0: 6820 756e 7370 6563 6966 6965 6420 6573 h unspecified es │ │ │ │ │ +000391c0: 6361 7065 0a73 6571 7565 6e63 6573 2e20 cape.sequences. │ │ │ │ │ +000391d0: 2047 5255 4220 6173 7375 6d65 7320 7468 GRUB assumes th │ │ │ │ │ +000391e0: 6174 2074 6865 2049 534f 3936 3630 206e at the ISO9660 n │ │ │ │ │ +000391f0: 616d 6573 2061 7265 2055 5446 2d38 2028 ames are UTF-8 ( │ │ │ │ │ +00039200: 7369 6e63 6520 616e 790a 4153 4349 4920 since any.ASCII │ │ │ │ │ +00039210: 6973 2076 616c 6964 2055 5446 2d38 292e is valid UTF-8). │ │ │ │ │ +00039220: 2020 5468 6572 6520 6172 6520 736f 6d65 There are some │ │ │ │ │ +00039230: 206f 6c64 2043 442d 524f 4d73 2077 6869 old CD-ROMs whi │ │ │ │ │ +00039240: 6368 2075 7365 2043 5034 3337 2069 6e0a ch use CP437 in. │ │ │ │ │ +00039250: 6e6f 6e2d 636f 6d70 6c69 616e 7420 7761 non-compliant wa │ │ │ │ │ +00039260: 792e 2020 596f 7527 7265 2073 7469 6c6c y. You're still │ │ │ │ │ +00039270: 2061 626c 6520 746f 2061 6363 6573 7320 able to access │ │ │ │ │ +00039280: 6669 6c65 7320 7769 7468 206e 616d 6573 files with names │ │ │ │ │ +00039290: 0a63 6f6e 7461 696e 696e 6720 6f6e 6c79 .containing only │ │ │ │ │ +000392a0: 2041 5343 4949 2063 6861 7261 6374 6572 ASCII character │ │ │ │ │ +000392b0: 7320 6f6e 2073 7563 6820 6669 6c65 7379 s on such filesy │ │ │ │ │ +000392c0: 7374 656d 7320 7468 6f75 6768 2e20 2059 stems though. Y │ │ │ │ │ +000392d0: 6f75 2772 650a 616c 736f 2061 626c 6520 ou're.also able │ │ │ │ │ +000392e0: 746f 2061 6363 6573 7320 616e 7920 6669 to access any fi │ │ │ │ │ +000392f0: 6c65 2069 6620 7468 6520 6669 6c65 7379 le if the filesy │ │ │ │ │ +00039300: 7374 656d 2063 6f6e 7461 696e 7320 7661 stem contains va │ │ │ │ │ +00039310: 6c69 6420 4a6f 6c69 6574 0a28 5554 462d lid Joliet.(UTF- │ │ │ │ │ +00039320: 3136 2920 6f72 2052 6f63 6b52 6964 6765 16) or RockRidge │ │ │ │ │ +00039330: 2028 5554 462d 3829 2e20 2041 4646 532c (UTF-8). AFFS, │ │ │ │ │ +00039340: 2053 4653 2061 6e64 2048 4653 206e 6576 SFS and HFS nev │ │ │ │ │ +00039350: 6572 2075 7365 2075 6e69 636f 6465 2061 er use unicode a │ │ │ │ │ +00039360: 6e64 0a47 5255 4220 6173 7375 6d65 7320 nd.GRUB assumes │ │ │ │ │ +00039370: 7468 656d 2074 6f20 6265 2069 6e20 4c61 them to be in La │ │ │ │ │ +00039380: 7469 6e31 2c20 4c61 7469 6e31 2061 6e64 tin1, Latin1 and │ │ │ │ │ +00039390: 204d 6163 526f 6d61 6e20 7265 7370 6563 MacRoman respec │ │ │ │ │ +000393a0: 7469 7665 6c79 2e0a 4752 5542 2068 616e tively..GRUB han │ │ │ │ │ +000393b0: 646c 6573 2066 696c 6573 7973 7465 6d20 dles filesystem │ │ │ │ │ +000393c0: 6361 7365 2d69 6e73 656e 7369 7469 7669 case-insensitivi │ │ │ │ │ +000393d0: 7479 2068 6f77 6576 6572 206e 6f20 6174 ty however no at │ │ │ │ │ +000393e0: 7465 6d70 7420 6973 0a70 6572 666f 726d tempt is.perform │ │ │ │ │ +000393f0: 6564 2061 7420 6361 7365 2063 6f6e 7665 ed at case conve │ │ │ │ │ +00039400: 7273 696f 6e20 6f66 2069 6e74 6572 6e61 rsion of interna │ │ │ │ │ +00039410: 7469 6f6e 616c 2063 6861 7261 6374 6572 tional character │ │ │ │ │ +00039420: 7320 736f 2065 2e67 2e20 2061 2066 696c s so e.g. a fil │ │ │ │ │ +00039430: 650a 6e61 6d65 6420 6c6f 7765 7263 6173 e.named lowercas │ │ │ │ │ +00039440: 6520 6772 6565 6b20 616c 7068 6120 6973 e greek alpha is │ │ │ │ │ +00039450: 2074 7265 6174 6564 2061 7320 6469 6666 treated as diff │ │ │ │ │ +00039460: 6572 656e 7420 6672 6f6d 2074 6865 206f erent from the o │ │ │ │ │ +00039470: 6e65 206e 616d 6564 0a61 7320 7570 7065 ne named.as uppe │ │ │ │ │ +00039480: 7263 6173 6520 616c 7068 612e 2020 5468 rcase alpha. Th │ │ │ │ │ +00039490: 6520 6669 6c65 7379 7374 656d 7320 696e e filesystems in │ │ │ │ │ +000394a0: 2071 7565 7374 696f 6e73 2061 7265 204e questions are N │ │ │ │ │ +000394b0: 5446 5320 2865 7863 6570 7420 504f 5349 TFS (except POSI │ │ │ │ │ +000394c0: 580a 6e61 6d65 7370 6163 6529 2c20 4846 X.namespace), HF │ │ │ │ │ +000394d0: 532b 2028 636f 6e66 6967 7572 6162 6c65 S+ (configurable │ │ │ │ │ +000394e0: 2061 7420 6d6b 6673 2074 696d 652c 2064 at mkfs time, d │ │ │ │ │ +000394f0: 6566 6175 6c74 2069 6e73 656e 7369 7469 efault insensiti │ │ │ │ │ +00039500: 7665 292c 2053 4653 0a28 636f 6e66 6967 ve), SFS.(config │ │ │ │ │ +00039510: 7572 6162 6c65 2061 7420 6d6b 6673 2074 urable at mkfs t │ │ │ │ │ +00039520: 696d 652c 2064 6566 6175 6c74 2069 6e73 ime, default ins │ │ │ │ │ +00039530: 656e 7369 7469 7665 292c 204a 4653 2028 ensitive), JFS ( │ │ │ │ │ +00039540: 636f 6e66 6967 7572 6162 6c65 2061 740a configurable at. │ │ │ │ │ +00039550: 6d6b 6673 2074 696d 652c 2064 6566 6175 mkfs time, defau │ │ │ │ │ +00039560: 6c74 2073 656e 7369 7469 7665 292c 2048 lt sensitive), H │ │ │ │ │ +00039570: 4653 2c20 4146 4653 2c20 4641 542c 2065 FS, AFFS, FAT, e │ │ │ │ │ +00039580: 7846 4154 2061 6e64 205a 4653 0a28 636f xFAT and ZFS.(co │ │ │ │ │ +00039590: 6e66 6967 7572 6162 6c65 206f 6e20 7065 nfigurable on pe │ │ │ │ │ +000395a0: 722d 7375 6276 6f6c 756d 6520 6261 7369 r-subvolume basi │ │ │ │ │ +000395b0: 7320 6279 2070 726f 7065 7274 7920 2263 s by property "c │ │ │ │ │ +000395c0: 6173 6573 656e 7369 7469 7669 7479 222c asesensitivity", │ │ │ │ │ +000395d0: 0a64 6566 6175 6c74 2073 656e 7369 7469 .default sensiti │ │ │ │ │ +000395e0: 7665 292e 2020 4f6e 205a 4653 2073 7562 ve). On ZFS sub │ │ │ │ │ +000395f0: 766f 6c75 6d65 7320 6d61 726b 6564 2061 volumes marked a │ │ │ │ │ +00039600: 7320 6361 7365 2069 6e73 656e 7369 7469 s case insensiti │ │ │ │ │ +00039610: 7665 2066 696c 6573 0a63 6f6e 7461 696e ve files.contain │ │ │ │ │ +00039620: 696e 6720 6c6f 7765 7263 6173 6520 696e ing lowercase in │ │ │ │ │ +00039630: 7465 726e 6174 696f 6e61 6c20 6368 6172 ternational char │ │ │ │ │ +00039640: 6163 7465 7273 2061 7265 2069 6e61 6363 acters are inacc │ │ │ │ │ +00039650: 6573 7369 626c 652e 2020 416c 736f 0a6c essible. Also.l │ │ │ │ │ +00039660: 696b 6520 616c 6c20 7375 7070 6f72 7465 ike all supporte │ │ │ │ │ +00039670: 6420 6669 6c65 7379 7374 656d 7320 6578 d filesystems ex │ │ │ │ │ +00039680: 6365 7074 2048 4653 2b20 616e 6420 5a46 cept HFS+ and ZF │ │ │ │ │ +00039690: 5320 2863 6f6e 6669 6775 7261 626c 6520 S (configurable │ │ │ │ │ +000396a0: 6f6e 0a70 6572 2d73 7562 766f 6c75 6d65 on.per-subvolume │ │ │ │ │ +000396b0: 2062 6173 6973 2062 7920 7072 6f70 6572 basis by proper │ │ │ │ │ +000396c0: 7479 2022 6e6f 726d 616c 697a 6174 696f ty "normalizatio │ │ │ │ │ +000396d0: 6e22 2c20 6465 6661 756c 7420 6e6f 6e65 n", default none │ │ │ │ │ +000396e0: 2920 4752 5542 0a6d 616b 6573 206e 6f20 ) GRUB.makes no │ │ │ │ │ +000396f0: 6174 7465 6d70 7420 6174 2063 6865 636b attempt at check │ │ │ │ │ +00039700: 206f 6620 6361 6e6f 6e69 6361 6c20 6571 of canonical eq │ │ │ │ │ +00039710: 7569 7661 6c65 6e63 6520 736f 2061 2066 uivalence so a f │ │ │ │ │ +00039720: 696c 6520 6e61 6d65 0a75 2d64 6961 7265 ile name.u-diare │ │ │ │ │ +00039730: 7369 7320 6973 2074 7265 6174 6564 2061 sis is treated a │ │ │ │ │ +00039740: 7320 6469 7374 696e 6374 2066 726f 6d20 s distinct from │ │ │ │ │ +00039750: 752b 636f 6d62 696e 696e 6720 6469 6172 u+combining diar │ │ │ │ │ +00039760: 6573 6973 2e20 2054 6869 730a 686f 7765 esis. This.howe │ │ │ │ │ +00039770: 7665 7220 6d65 616e 7320 7468 6174 2069 ver means that i │ │ │ │ │ +00039780: 6e20 6f72 6465 7220 746f 2061 6363 6573 n order to acces │ │ │ │ │ +00039790: 7320 6669 6c65 206f 6e20 4846 532b 2069 s file on HFS+ i │ │ │ │ │ +000397a0: 7473 206e 616d 6520 6d75 7374 2062 650a ts name must be. │ │ │ │ │ +000397b0: 7370 6563 6966 6965 6420 696e 206e 6f72 specified in nor │ │ │ │ │ +000397c0: 6d61 6c69 7361 7469 6f6e 2066 6f72 6d20 malisation form │ │ │ │ │ +000397d0: 442e 204f 6e20 6e6f 726d 616c 697a 6564 D. On normalized │ │ │ │ │ +000397e0: 205a 4653 2073 7562 766f 6c75 6d65 730a ZFS subvolumes. │ │ │ │ │ +000397f0: 6669 6c65 6e61 6d65 7320 6f75 7420 6f66 filenames out of │ │ │ │ │ +00039800: 206e 6f72 6d61 6c69 7361 7469 6f6e 2061 normalisation a │ │ │ │ │ +00039810: 7265 2069 6e61 6363 6573 7369 626c 652e re inaccessible. │ │ │ │ │ +00039820: 0a0a 3137 2e33 204f 7574 7075 7420 7465 ..17.3 Output te │ │ │ │ │ +00039830: 726d 696e 616c 0a3d 3d3d 3d3d 3d3d 3d3d rminal.========= │ │ │ │ │ +00039840: 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a 0a46 6972 ===========..Fir │ │ │ │ │ +00039850: 6d77 6172 6520 6f75 7470 7574 2063 6f6e mware output con │ │ │ │ │ +00039860: 736f 6c65 2022 636f 6e73 6f6c 6522 206f sole "console" o │ │ │ │ │ +00039870: 6e20 4152 4320 616e 6420 4945 4545 3132 n ARC and IEEE12 │ │ │ │ │ +00039880: 3735 2061 7265 206c 696d 6974 6564 2074 75 are limited t │ │ │ │ │ +00039890: 6f0a 4153 4349 492e 0a0a 2020 2042 494f o.ASCII... BIO │ │ │ │ │ +000398a0: 5320 6669 726d 7761 7265 2063 6f6e 736f S firmware conso │ │ │ │ │ +000398b0: 6c65 2061 6e64 2056 4741 2074 6578 7420 le and VGA text │ │ │ │ │ +000398c0: 6172 6520 6c69 6d69 7465 6420 746f 2041 are limited to A │ │ │ │ │ +000398d0: 5343 4949 2061 6e64 2073 6f6d 650a 7073 SCII and some.ps │ │ │ │ │ +000398e0: 6575 646f 6772 6170 6869 6373 2e0a 0a20 eudographics... │ │ │ │ │ +000398f0: 2020 4e6f 6e65 206f 6620 6162 6f76 6520 None of above │ │ │ │ │ +00039900: 6d65 6e74 696f 6e65 6420 6973 2061 7070 mentioned is app │ │ │ │ │ +00039910: 726f 7072 6961 7465 2066 6f72 2064 6973 ropriate for dis │ │ │ │ │ +00039920: 706c 6179 696e 6720 696e 7465 726e 6174 playing internat │ │ │ │ │ +00039930: 696f 6e61 6c0a 616e 6420 616e 7920 756e ional.and any un │ │ │ │ │ +00039940: 7375 7070 6f72 7465 6420 6368 6172 6163 supported charac │ │ │ │ │ +00039950: 7465 7220 6973 2072 6570 6c61 6365 6420 ter is replaced │ │ │ │ │ +00039960: 7769 7468 2071 7565 7374 696f 6e20 6d61 with question ma │ │ │ │ │ +00039970: 726b 2065 7863 6570 740a 7073 6575 646f rk except.pseudo │ │ │ │ │ +00039980: 6772 6170 6869 6373 2077 6869 6368 2077 graphics which w │ │ │ │ │ +00039990: 6520 6174 7465 6d70 7420 746f 2061 7070 e attempt to app │ │ │ │ │ +000399a0: 726f 7869 6d61 7465 2077 6974 6820 4153 roximate with AS │ │ │ │ │ +000399b0: 4349 492e 0a0a 2020 2045 4649 2063 6f6e CII... EFI con │ │ │ │ │ +000399c0: 736f 6c65 206f 6e20 7468 6520 6f74 6865 sole on the othe │ │ │ │ │ +000399d0: 7220 6861 6e64 206e 6f6d 696e 616c 6c79 r hand nominally │ │ │ │ │ +000399e0: 2073 7570 706f 7274 7320 5554 462d 3136 supports UTF-16 │ │ │ │ │ +000399f0: 2062 7574 2061 6374 7561 6c0a 6c61 6e67 but actual.lang │ │ │ │ │ +00039a00: 7561 6765 2063 6f76 6572 6167 6520 6465 uage coverage de │ │ │ │ │ +00039a10: 7065 6e64 7320 6f6e 2066 6972 6d77 6172 pends on firmwar │ │ │ │ │ +00039a20: 6520 616e 6420 6d61 7920 6265 2076 6572 e and may be ver │ │ │ │ │ +00039a30: 7920 6c69 6d69 7465 642e 0a0a 2020 2054 y limited... T │ │ │ │ │ +00039a40: 6865 2065 6e63 6f64 696e 6720 7573 6564 he encoding used │ │ │ │ │ +00039a50: 206f 6e20 7365 7269 616c 2063 616e 2062 on serial can b │ │ │ │ │ +00039a60: 6520 6368 6f73 656e 2077 6974 6820 2774 e chosen with 't │ │ │ │ │ +00039a70: 6572 6d69 6e66 6f27 2061 7320 6569 7468 erminfo' as eith │ │ │ │ │ +00039a80: 6572 0a41 5343 4949 2c20 5554 462d 3820 er.ASCII, UTF-8 │ │ │ │ │ +00039a90: 6f72 2022 7669 7375 616c 2055 5446 2d38 or "visual UTF-8 │ │ │ │ │ +00039aa0: 222e 2020 4c61 7374 206f 6e65 2069 7320 ". Last one is │ │ │ │ │ +00039ab0: 6167 6169 6e73 7420 7468 6520 7370 6563 against the spec │ │ │ │ │ +00039ac0: 6966 6963 6174 696f 6e0a 6275 7420 7265 ification.but re │ │ │ │ │ +00039ad0: 7375 6c74 7320 696e 2063 6f72 7265 6374 sults in correct │ │ │ │ │ +00039ae0: 2072 656e 6465 7269 6e67 206f 6620 7269 rendering of ri │ │ │ │ │ +00039af0: 6768 742d 746f 2d6c 6566 7420 6f6e 2073 ght-to-left on s │ │ │ │ │ +00039b00: 6f6d 6520 7265 6164 6572 7320 7768 6963 ome readers whic │ │ │ │ │ +00039b10: 680a 646f 6e27 7420 6861 7665 206f 776e h.don't have own │ │ │ │ │ +00039b20: 2062 6964 6920 696d 706c 656d 656e 7461 bidi implementa │ │ │ │ │ +00039b30: 7469 6f6e 2e0a 0a20 2020 4f6e 2065 6d75 tion... On emu │ │ │ │ │ +00039b40: 2047 5255 4220 6368 6563 6b73 2069 6620 GRUB checks if │ │ │ │ │ +00039b50: 6368 6172 7365 7420 6973 2055 5446 2d38 charset is UTF-8 │ │ │ │ │ +00039b60: 2061 6e64 2075 7365 7320 6974 2069 6620 and uses it if │ │ │ │ │ +00039b70: 736f 2061 6e64 2075 7365 730a 4153 4349 so and uses.ASCI │ │ │ │ │ +00039b80: 4920 6f74 6865 7277 6973 652e 0a0a 2020 I otherwise... │ │ │ │ │ +00039b90: 2057 6865 6e20 7573 696e 6720 6766 7874 When using gfxt │ │ │ │ │ +00039ba0: 6572 6d20 6f72 2067 6678 6d65 6e75 2047 erm or gfxmenu G │ │ │ │ │ +00039bb0: 5255 4220 6974 7365 6c66 2069 7320 7265 RUB itself is re │ │ │ │ │ +00039bc0: 7370 6f6e 7369 626c 6520 666f 720a 7265 sponsible for.re │ │ │ │ │ +00039bd0: 6e64 6572 696e 6720 7468 6520 7465 7874 ndering the text │ │ │ │ │ +00039be0: 2e20 2049 6e20 7468 6973 2063 6173 6520 . In this case │ │ │ │ │ +00039bf0: 4752 5542 2069 7320 6c69 6d69 7465 6420 GRUB is limited │ │ │ │ │ +00039c00: 6279 206c 6f61 6465 6420 666f 6e74 732e by loaded fonts. │ │ │ │ │ +00039c10: 2020 4966 0a66 6f6e 7473 2063 6f6e 7461 If.fonts conta │ │ │ │ │ +00039c20: 696e 2061 6c6c 2072 6571 7569 7265 6420 in all required │ │ │ │ │ +00039c30: 6368 6172 6163 7465 7273 2074 6865 6e20 characters then │ │ │ │ │ +00039c40: 6269 6469 7265 6374 696f 6e61 6c20 7465 bidirectional te │ │ │ │ │ +00039c50: 7874 2c20 6375 7273 6976 650a 7661 7269 xt, cursive.vari │ │ │ │ │ +00039c60: 616e 7473 2061 6e64 2063 6f6d 6269 6e69 ants and combini │ │ │ │ │ +00039c70: 6e67 206d 6172 6b73 206f 7468 6572 2074 ng marks other t │ │ │ │ │ +00039c80: 6861 6e20 656e 636c 6f73 696e 672c 2068 han enclosing, h │ │ │ │ │ +00039c90: 616c 6620 2865 2e67 2e20 206c 6566 7420 alf (e.g. left │ │ │ │ │ +00039ca0: 6861 6c66 0a74 696c 6465 206f 7220 636f half.tilde or co │ │ │ │ │ +00039cb0: 6d62 696e 696e 6720 6f76 6572 6c69 6e65 mbining overline │ │ │ │ │ +00039cc0: 2920 616e 6420 646f 7562 6c65 206f 6e65 ) and double one │ │ │ │ │ +00039cd0: 732e 2020 4c69 6761 7475 7265 7320 6172 s. Ligatures ar │ │ │ │ │ +00039ce0: 656e 2774 0a73 7570 706f 7274 6564 2074 en't.supported t │ │ │ │ │ +00039cf0: 686f 7567 682e 2020 5468 6973 2073 686f hough. This sho │ │ │ │ │ +00039d00: 756c 6420 636f 7665 7220 4575 726f 7065 uld cover Europe │ │ │ │ │ +00039d10: 616e 2c20 4d69 6464 6c65 2045 6173 7465 an, Middle Easte │ │ │ │ │ +00039d20: 726e 2028 6966 2079 6f75 0a64 6f6e 2774 rn (if you.don't │ │ │ │ │ +00039d30: 206d 696e 6420 6c61 636b 206f 6620 6c61 mind lack of la │ │ │ │ │ +00039d40: 6d2d 616c 6966 206c 6967 6174 7572 6520 m-alif ligature │ │ │ │ │ +00039d50: 696e 2041 7261 6269 6329 2061 6e64 2045 in Arabic) and E │ │ │ │ │ +00039d60: 6173 7420 4173 6961 6e20 7363 7269 7074 ast Asian script │ │ │ │ │ +00039d70: 732e 0a4e 6f74 6162 6c65 2075 6e73 7570 s..Notable unsup │ │ │ │ │ +00039d80: 706f 7274 6564 2073 6372 6970 7473 2061 ported scripts a │ │ │ │ │ +00039d90: 7265 2042 7261 686d 6963 2066 616d 696c re Brahmic famil │ │ │ │ │ +00039da0: 7920 616e 6420 6465 7269 7665 6420 6173 y and derived as │ │ │ │ │ +00039db0: 2077 656c 6c20 6173 0a4d 6f6e 676f 6c69 well as.Mongoli │ │ │ │ │ +00039dc0: 616e 2c20 5469 6669 6e61 6768 2c20 4b6f an, Tifinagh, Ko │ │ │ │ │ +00039dd0: 7265 616e 204a 616d 6f20 2870 7265 636f rean Jamo (preco │ │ │ │ │ +00039de0: 6d70 6f73 6564 2063 6861 7261 6374 6572 mposed character │ │ │ │ │ +00039df0: 7320 6861 7665 206e 6f0a 7072 6f62 6c65 s have no.proble │ │ │ │ │ +00039e00: 6d29 2061 6e64 2074 6f6e 616c 2077 7269 m) and tonal wri │ │ │ │ │ +00039e10: 7469 6e67 2028 3265 352d 3265 3929 2e20 ting (2e5-2e9). │ │ │ │ │ +00039e20: 2047 5255 4220 616c 736f 2069 676e 6f72 GRUB also ignor │ │ │ │ │ +00039e30: 6573 2064 6570 7265 6361 7465 6420 2861 es deprecated (a │ │ │ │ │ +00039e40: 730a 7370 6563 6966 6965 6420 696e 2055 s.specified in U │ │ │ │ │ +00039e50: 6e69 636f 6465 2920 6368 6172 6163 7465 nicode) characte │ │ │ │ │ +00039e60: 7273 2028 652e 672e 2020 7461 6773 292e rs (e.g. tags). │ │ │ │ │ +00039e70: 2020 4752 5542 2061 6c73 6f20 646f 6573 GRUB also does │ │ │ │ │ +00039e80: 6e27 7420 6861 6e64 6c65 0a73 6f20 6361 n't handle.so ca │ │ │ │ │ +00039e90: 6c6c 6564 2022 616e 6e6f 7461 7469 6f6e lled "annotation │ │ │ │ │ +00039ea0: 2063 6861 7261 6374 6572 7322 2049 6620 characters" If │ │ │ │ │ +00039eb0: 796f 7520 6361 6e20 636f 6d70 6c65 7465 you can complete │ │ │ │ │ +00039ec0: 2065 6974 6865 7220 6f66 2074 776f 0a6c either of two.l │ │ │ │ │ +00039ed0: 6973 7473 206f 722c 2062 6574 7465 722c ists or, better, │ │ │ │ │ +00039ee0: 2070 726f 706f 7365 2061 2070 6174 6368 propose a patch │ │ │ │ │ +00039ef0: 2074 6f20 696d 7072 6f76 6520 7265 6e64 to improve rend │ │ │ │ │ +00039f00: 6572 696e 672c 2070 6c65 6173 6520 636f ering, please co │ │ │ │ │ +00039f10: 6e74 6163 740a 6465 7665 6c6f 7065 7220 ntact.developer │ │ │ │ │ +00039f20: 7465 616d 2e0a 0a31 372e 3420 496e 7075 team...17.4 Inpu │ │ │ │ │ +00039f30: 7420 7465 726d 696e 616c 0a3d 3d3d 3d3d t terminal.===== │ │ │ │ │ +00039f40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +00039f50: 4669 726d 7761 7265 2063 6f6e 736f 6c65 Firmware console │ │ │ │ │ +00039f60: 206f 6e20 4249 4f53 2c20 4945 4545 3132 on BIOS, IEEE12 │ │ │ │ │ +00039f70: 3735 2061 6e64 2041 5243 2064 6f65 736e 75 and ARC doesn │ │ │ │ │ +00039f80: 2774 2061 6c6c 6f77 2079 6f75 2074 6f20 't allow you to │ │ │ │ │ +00039f90: 656e 7465 720a 6e6f 6e2d 4153 4349 4920 enter.non-ASCII │ │ │ │ │ +00039fa0: 6368 6172 6163 7465 7273 2e20 2045 4649 characters. EFI │ │ │ │ │ +00039fb0: 2073 7065 6369 6669 6361 7469 6f6e 2061 specification a │ │ │ │ │ +00039fc0: 6c6c 6f77 7320 666f 7220 7375 6368 2062 llows for such b │ │ │ │ │ +00039fd0: 7574 2061 7574 686f 7220 6973 0a75 6e61 ut author is.una │ │ │ │ │ +00039fe0: 7761 7265 206f 6620 616e 7920 6163 7475 ware of any actu │ │ │ │ │ +00039ff0: 616c 2069 6d70 6c65 6d65 6e74 6174 696f al implementatio │ │ │ │ │ +0003a000: 6e73 2e20 2053 6572 6961 6c20 696e 7075 ns. Serial inpu │ │ │ │ │ +0003a010: 7420 6973 2063 7572 7265 6e74 6c79 0a6c t is currently.l │ │ │ │ │ +0003a020: 696d 6974 6564 2066 6f72 206c 6174 696e imited for latin │ │ │ │ │ +0003a030: 3120 2875 6e6c 696b 656c 7920 746f 2063 1 (unlikely to c │ │ │ │ │ +0003a040: 6861 6e67 6529 2e20 204f 776e 206b 6579 hange). Own key │ │ │ │ │ +0003a050: 626f 6172 6420 696d 706c 656d 656e 7461 board implementa │ │ │ │ │ +0003a060: 7469 6f6e 730a 2861 745f 6b65 7962 6f61 tions.(at_keyboa │ │ │ │ │ +0003a070: 7264 2061 6e64 2075 7362 5f6b 6579 626f rd and usb_keybo │ │ │ │ │ +0003a080: 6172 6429 2073 7570 706f 7274 7320 616e ard) supports an │ │ │ │ │ +0003a090: 7920 6b65 7920 6275 7420 776f 726b 206f y key but work o │ │ │ │ │ +0003a0a0: 6e0a 6f6e 652d 6368 6172 2d70 6572 2d6b n.one-char-per-k │ │ │ │ │ +0003a0b0: 6579 7374 726f 6b65 2e20 2053 6f20 6e6f eystroke. So no │ │ │ │ │ +0003a0c0: 2064 6561 6420 6b65 7973 206f 7220 6164 dead keys or ad │ │ │ │ │ +0003a0d0: 7661 6e63 6564 2069 6e70 7574 206d 6574 vanced input met │ │ │ │ │ +0003a0e0: 686f 642e 2020 416c 736f 0a74 6865 7265 hod. Also.there │ │ │ │ │ +0003a0f0: 2069 7320 6e6f 206b 6579 6d61 7020 6368 is no keymap ch │ │ │ │ │ +0003a100: 616e 6765 2068 6f74 6b65 792e 2020 496e ange hotkey. In │ │ │ │ │ +0003a110: 2070 7261 6374 6963 6520 6974 206d 616b practice it mak │ │ │ │ │ +0003a120: 6573 2064 6966 6669 6375 6c74 2074 6f0a es difficult to. │ │ │ │ │ +0003a130: 656e 7465 7220 616e 7920 7465 7874 2075 enter any text u │ │ │ │ │ +0003a140: 7369 6e67 206e 6f6e 2d4c 6174 696e 2061 sing non-Latin a │ │ │ │ │ +0003a150: 6c70 6861 6265 742e 2020 4d6f 7265 6f76 lphabet. Moreov │ │ │ │ │ +0003a160: 6572 2061 6c6c 2063 7572 7265 6e74 2069 er all current i │ │ │ │ │ +0003a170: 6e70 7574 0a63 6f6e 7375 6d65 7273 2061 nput.consumers a │ │ │ │ │ +0003a180: 7265 206c 696d 6974 6564 2074 6f20 4153 re limited to AS │ │ │ │ │ +0003a190: 4349 492e 0a0a 3137 2e35 2047 6574 7465 CII...17.5 Gette │ │ │ │ │ +0003a1a0: 7874 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d0a xt.============. │ │ │ │ │ +0003a1b0: 0a47 5255 4220 7375 7070 6f72 7473 2062 .GRUB supports b │ │ │ │ │ +0003a1c0: 6569 6e67 2074 7261 6e73 6c61 7465 642e eing translated. │ │ │ │ │ +0003a1d0: 2020 466f 7220 7468 6973 2079 6f75 206e For this you n │ │ │ │ │ +0003a1e0: 6565 6420 746f 2068 6176 6520 6c61 6e67 eed to have lang │ │ │ │ │ +0003a1f0: 7561 6765 202a 2e6d 6f0a 6669 6c65 7320 uage *.mo.files │ │ │ │ │ +0003a200: 696e 2024 7072 6566 6978 2f6c 6f63 616c in $prefix/local │ │ │ │ │ +0003a210: 652c 206c 6f61 6420 6765 7474 6578 7420 e, load gettext │ │ │ │ │ +0003a220: 6d6f 6475 6c65 2061 6e64 2073 6574 2022 module and set " │ │ │ │ │ +0003a230: 6c61 6e67 2220 7661 7269 6162 6c65 2e0a lang" variable.. │ │ │ │ │ +0003a240: 0a31 372e 3620 5265 6765 7870 0a3d 3d3d .17.6 Regexp.=== │ │ │ │ │ +0003a250: 3d3d 3d3d 3d3d 3d3d 0a0a 5265 6765 7870 ========..Regexp │ │ │ │ │ +0003a260: 7320 776f 726b 206f 6e20 756e 6963 6f64 s work on unicod │ │ │ │ │ +0003a270: 6520 6368 6172 6163 7465 7273 2c20 686f e characters, ho │ │ │ │ │ +0003a280: 7765 7665 7220 6e6f 2061 7474 656d 7074 wever no attempt │ │ │ │ │ +0003a290: 2061 7420 6368 6563 6b69 6e67 0a63 616e at checking.can │ │ │ │ │ +0003a2a0: 6e6f 6e69 6361 6c20 6571 7569 7661 6c65 nonical equivale │ │ │ │ │ +0003a2b0: 6e63 6520 6861 7320 6265 656e 206d 6164 nce has been mad │ │ │ │ │ +0003a2c0: 652e 2020 4d6f 7265 6f76 6572 2074 6865 e. Moreover the │ │ │ │ │ +0003a2d0: 2063 6c61 7373 6573 206c 696b 650a 5b3a classes like.[: │ │ │ │ │ +0003a2e0: 616c 7068 613a 5d20 6d61 7463 6820 6f6e alpha:] match on │ │ │ │ │ +0003a2f0: 6c79 2041 5343 4949 2073 7562 7365 742e ly ASCII subset. │ │ │ │ │ +0003a300: 0a0a 3137 2e37 204f 7468 6572 0a3d 3d3d ..17.7 Other.=== │ │ │ │ │ +0003a310: 3d3d 3d3d 3d3d 3d0a 0a43 7572 7265 6e74 =======..Current │ │ │ │ │ +0003a320: 6c79 2047 5255 4220 616c 7761 7973 2075 ly GRUB always u │ │ │ │ │ +0003a330: 7365 7320 5945 4152 2d4d 4f4e 5448 2d44 ses YEAR-MONTH-D │ │ │ │ │ +0003a340: 4159 2048 4f55 523a 4d49 4e55 5445 3a53 AY HOUR:MINUTE:S │ │ │ │ │ +0003a350: 4543 4f4e 4420 5b57 4545 4b44 4159 5d0a ECOND [WEEKDAY]. │ │ │ │ │ +0003a360: 3234 2d68 6f75 7220 6461 7465 7469 6d65 24-hour datetime │ │ │ │ │ +0003a370: 2066 6f72 6d61 7420 6275 7420 7765 656b format but week │ │ │ │ │ +0003a380: 6461 7973 2061 7265 2074 7261 6e73 6c61 days are transla │ │ │ │ │ +0003a390: 7465 642e 2020 4752 5542 2061 6c77 6179 ted. GRUB alway │ │ │ │ │ +0003a3a0: 7320 7573 6573 0a74 6865 2064 6563 696d s uses.the decim │ │ │ │ │ +0003a3b0: 616c 206e 756d 6265 7220 666f 726d 6174 al number format │ │ │ │ │ +0003a3c0: 2077 6974 6820 5b30 2d39 5d20 6173 2064 with [0-9] as d │ │ │ │ │ +0003a3d0: 6967 6974 7320 616e 6420 2e20 2061 7320 igits and . as │ │ │ │ │ +0003a3e0: 6465 7363 696d 616c 0a73 6570 6172 6174 descimal.separat │ │ │ │ │ +0003a3f0: 6f72 2061 6e64 206e 6f20 6772 6f75 7020 or and no group │ │ │ │ │ +0003a400: 7365 7061 7261 746f 722e 2020 4945 4545 separator. IEEE │ │ │ │ │ +0003a410: 3132 3735 2061 6c69 6173 6573 2061 7265 1275 aliases are │ │ │ │ │ +0003a420: 206d 6174 6368 6564 0a63 6173 652d 696e matched.case-in │ │ │ │ │ +0003a430: 7365 6e73 6974 6976 656c 7920 6578 6365 sensitively exce │ │ │ │ │ +0003a440: 7074 206e 6f6e 2d41 5343 4949 2077 6869 pt non-ASCII whi │ │ │ │ │ +0003a450: 6368 2069 7320 6d61 7463 6865 6420 6173 ch is matched as │ │ │ │ │ +0003a460: 2062 696e 6172 792e 2020 5369 6d69 6c61 binary. Simila │ │ │ │ │ +0003a470: 720a 6265 6861 7669 6f75 7220 6973 2066 r.behaviour is f │ │ │ │ │ +0003a480: 6f72 206d 6174 6368 696e 6720 4f53 4275 or matching OSBu │ │ │ │ │ +0003a490: 6e64 6c65 5265 7175 6972 6564 2e20 2053 ndleRequired. S │ │ │ │ │ +0003a4a0: 696e 6365 2049 4545 4531 3237 3520 616c ince IEEE1275 al │ │ │ │ │ +0003a4b0: 6961 7365 7320 616e 640a 4f53 4275 6e64 iases and.OSBund │ │ │ │ │ +0003a4c0: 6c65 5265 7175 6972 6564 2064 6f6e 2774 leRequired don't │ │ │ │ │ +0003a4d0: 2063 6f6e 7461 696e 2061 6e79 206e 6f6e contain any non │ │ │ │ │ +0003a4e0: 2d41 5343 4949 2069 7420 7368 6f75 6c64 -ASCII it should │ │ │ │ │ +0003a4f0: 206e 6576 6572 2062 6520 610a 7072 6f62 never be a.prob │ │ │ │ │ +0003a500: 6c65 6d20 696e 2070 7261 6374 6963 652e lem in practice. │ │ │ │ │ +0003a510: 2020 4361 7365 2d73 656e 7369 7469 7665 Case-sensitive │ │ │ │ │ +0003a520: 2069 6465 6e74 6966 6965 7273 2061 7265 identifiers are │ │ │ │ │ +0003a530: 206d 6174 6368 6564 2061 7320 7261 770a matched as raw. │ │ │ │ │ +0003a540: 7374 7269 6e67 732c 206e 6f20 6361 6e6f strings, no cano │ │ │ │ │ +0003a550: 6e69 6361 6c20 6571 7569 7661 6c65 6e63 nical equivalenc │ │ │ │ │ +0003a560: 6520 6368 6563 6b20 6973 2070 6572 666f e check is perfo │ │ │ │ │ +0003a570: 726d 6564 2e20 2043 6173 652d 696e 7365 rmed. Case-inse │ │ │ │ │ +0003a580: 6e73 7469 7665 0a69 6465 6e74 6966 6965 nstive.identifie │ │ │ │ │ +0003a590: 7273 2061 7265 206d 6174 6368 6564 2061 rs are matched a │ │ │ │ │ +0003a5a0: 7320 5241 5720 6275 7420 6164 6469 7469 s RAW but additi │ │ │ │ │ +0003a5b0: 6f6e 616c 6c79 205b 612d 7a5d 2069 7320 onally [a-z] is │ │ │ │ │ +0003a5c0: 6571 7569 7661 6c65 6e74 2074 6f0a 5b41 equivalent to.[A │ │ │ │ │ +0003a5d0: 2d5a 5d2e 2047 5255 422d 6465 6669 6e65 -Z]. GRUB-define │ │ │ │ │ +0003a5e0: 6420 6964 656e 7469 6669 6572 7320 7573 d identifiers us │ │ │ │ │ +0003a5f0: 6520 6f6e 6c79 2041 5343 4949 2061 6e64 e only ASCII and │ │ │ │ │ +0003a600: 2073 6f20 7368 6f75 6c64 0a75 7365 722d so should.user- │ │ │ │ │ +0003a610: 6465 6669 6e65 6420 6f6e 6573 2e20 2049 defined ones. I │ │ │ │ │ +0003a620: 6465 6e74 6966 6965 7273 2063 6f6e 7461 dentifiers conta │ │ │ │ │ +0003a630: 696e 696e 6720 6e6f 6e2d 4153 4349 4920 ining non-ASCII │ │ │ │ │ +0003a640: 6d61 7920 776f 726b 2062 7574 2061 7265 may work but are │ │ │ │ │ +0003a650: 6e27 740a 7375 7070 6f72 7465 642e 2020 n't.supported. │ │ │ │ │ +0003a660: 4f6e 6c79 2074 6865 2041 5343 4949 2073 Only the ASCII s │ │ │ │ │ +0003a670: 7061 6365 2063 6861 7261 6374 6572 7320 pace characters │ │ │ │ │ +0003a680: 2873 7061 6365 2055 2b30 3032 302c 2074 (space U+0020, t │ │ │ │ │ +0003a690: 6162 2055 2b30 3030 622c 0a43 5220 552b ab U+000b,.CR U+ │ │ │ │ │ +0003a6a0: 3030 3064 2061 6e64 204c 4620 552b 3030 000d and LF U+00 │ │ │ │ │ +0003a6b0: 3061 2920 6172 6520 7265 636f 676e 6973 0a) are recognis │ │ │ │ │ +0003a6c0: 6564 2e20 204f 7468 6572 2075 6e69 636f ed. Other unico │ │ │ │ │ +0003a6d0: 6465 2073 7061 6365 2063 6861 7261 6374 de space charact │ │ │ │ │ +0003a6e0: 6572 730a 6172 656e 2774 2061 2076 616c ers.aren't a val │ │ │ │ │ +0003a6f0: 6964 2066 6965 6c64 2073 6570 6172 6174 id field separat │ │ │ │ │ +0003a700: 6f72 2e20 2027 7465 7374 2720 282a 6e6f or. 'test' (*no │ │ │ │ │ +0003a710: 7465 2074 6573 743a 3a29 2074 6573 7473 te test::) tests │ │ │ │ │ +0003a720: 203c 2c20 3e2c 203c 3d2c 0a3e 3d2c 202d <, >, <=,.>=, - │ │ │ │ │ +0003a730: 7067 7420 616e 6420 2d70 6c74 2063 6f6d pgt and -plt com │ │ │ │ │ +0003a740: 7061 7265 2074 6865 2073 7472 696e 6773 pare the strings │ │ │ │ │ +0003a750: 2069 6e20 7468 6520 6c65 7869 636f 6772 in the lexicogr │ │ │ │ │ +0003a760: 6170 6869 6361 6c20 6f72 6465 7220 6f66 aphical order of │ │ │ │ │ +0003a770: 0a75 6e69 636f 6465 2063 6f64 6570 6f69 .unicode codepoi │ │ │ │ │ +0003a780: 6e74 732c 2072 6570 6c69 6361 7469 6e67 nts, replicating │ │ │ │ │ +0003a790: 2074 6865 2062 6568 6176 696f 7572 206f the behaviour o │ │ │ │ │ +0003a7a0: 6620 7465 7374 2066 726f 6d20 636f 7265 f test from core │ │ │ │ │ +0003a7b0: 7574 696c 732e 0a65 6e76 6972 6f6e 6d65 utils..environme │ │ │ │ │ +0003a7c0: 6e74 2076 6172 6961 626c 6573 2061 6e64 nt variables and │ │ │ │ │ +0003a7d0: 2063 6f6d 6d61 6e64 7320 6172 6520 6c69 commands are li │ │ │ │ │ +0003a7e0: 7374 6564 2069 6e20 7468 6520 7361 6d65 sted in the same │ │ │ │ │ +0003a7f0: 206f 7264 6572 2e0a 0a1f 0a46 696c 653a order.....File: │ │ │ │ │ +0003a800: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0003a810: 653a 2053 6563 7572 6974 792c 2020 4e65 e: Security, Ne │ │ │ │ │ +0003a820: 7874 3a20 506c 6174 666f 726d 206c 696d xt: Platform lim │ │ │ │ │ +0003a830: 6974 6174 696f 6e73 2c20 2050 7265 763a itations, Prev: │ │ │ │ │ +0003a840: 2049 6e74 6572 6e61 7469 6f6e 616c 6973 Internationalis │ │ │ │ │ +0003a850: 6174 696f 6e2c 2020 5570 3a20 546f 700a ation, Up: Top. │ │ │ │ │ +0003a860: 0a31 3820 5365 6375 7269 7479 0a2a 2a2a .18 Security.*** │ │ │ │ │ +0003a870: 2a2a 2a2a 2a2a 2a2a 0a0a 2a20 4d65 6e75 ********..* Menu │ │ │ │ │ +0003a880: 3a0a 0a2a 2041 7574 6865 6e74 6963 6174 :..* Authenticat │ │ │ │ │ +0003a890: 696f 6e20 616e 6420 6175 7468 6f72 6973 ion and authoris │ │ │ │ │ +0003a8a0: 6174 696f 6e3a 3a20 5573 6572 7320 616e ation:: Users an │ │ │ │ │ +0003a8b0: 6420 6163 6365 7373 2063 6f6e 7472 6f6c d access control │ │ │ │ │ +0003a8c0: 0a2a 2055 7369 6e67 2064 6967 6974 616c .* Using digital │ │ │ │ │ +0003a8d0: 2073 6967 6e61 7475 7265 733a 3a20 2020 signatures:: │ │ │ │ │ +0003a8e0: 2020 2020 2020 426f 6f74 696e 6720 6469 Booting di │ │ │ │ │ +0003a8f0: 6769 7461 6c6c 7920 7369 676e 6564 2063 gitally signed c │ │ │ │ │ +0003a900: 6f64 650a 2a20 5545 4649 2073 6563 7572 ode.* UEFI secur │ │ │ │ │ +0003a910: 6520 626f 6f74 2061 6e64 2073 6869 6d3a e boot and shim: │ │ │ │ │ +0003a920: 3a20 2020 2020 2020 2042 6f6f 7469 6e67 : Booting │ │ │ │ │ +0003a930: 2064 6967 6974 616c 6c79 2073 6967 6e65 digitally signe │ │ │ │ │ +0003a940: 6420 5045 2066 696c 6573 0a2a 2053 6563 d PE files.* Sec │ │ │ │ │ +0003a950: 7572 6520 426f 6f74 2041 6476 616e 6365 ure Boot Advance │ │ │ │ │ +0003a960: 6420 5461 7267 6574 696e 673a 3a20 2020 d Targeting:: │ │ │ │ │ +0003a970: 456d 6265 6464 6564 2069 6e66 6f72 6d61 Embedded informa │ │ │ │ │ +0003a980: 7469 6f6e 2066 6f72 2067 656e 6572 6174 tion for generat │ │ │ │ │ +0003a990: 696f 6e20 6e75 6d62 6572 2062 6173 6564 ion number based │ │ │ │ │ +0003a9a0: 2072 6576 6f63 6174 696f 6e0a 2a20 4d65 revocation.* Me │ │ │ │ │ +0003a9b0: 6173 7572 6564 2042 6f6f 743a 3a20 2020 asured Boot:: │ │ │ │ │ +0003a9c0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003a9d0: 204d 6561 7375 7269 6e67 2062 6f6f 7420 Measuring boot │ │ │ │ │ +0003a9e0: 636f 6d70 6f6e 656e 7473 0a2a 204c 6f63 components.* Loc │ │ │ │ │ +0003a9f0: 6b64 6f77 6e3a 3a20 2020 2020 2020 2020 kdown:: │ │ │ │ │ +0003aa00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003aa10: 4c6f 636b 646f 776e 2077 6865 6e20 626f Lockdown when bo │ │ │ │ │ +0003aa20: 6f74 696e 6720 6f6e 2061 2073 6563 7572 oting on a secur │ │ │ │ │ +0003aa30: 6520 7365 7475 700a 0a1f 0a46 696c 653a e setup....File: │ │ │ │ │ +0003aa40: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0003aa50: 653a 2041 7574 6865 6e74 6963 6174 696f e: Authenticatio │ │ │ │ │ +0003aa60: 6e20 616e 6420 6175 7468 6f72 6973 6174 n and authorisat │ │ │ │ │ +0003aa70: 696f 6e2c 2020 4e65 7874 3a20 5573 696e ion, Next: Usin │ │ │ │ │ +0003aa80: 6720 6469 6769 7461 6c20 7369 676e 6174 g digital signat │ │ │ │ │ +0003aa90: 7572 6573 2c20 2055 703a 2053 6563 7572 ures, Up: Secur │ │ │ │ │ +0003aaa0: 6974 790a 0a31 382e 3120 4175 7468 656e ity..18.1 Authen │ │ │ │ │ +0003aab0: 7469 6361 7469 6f6e 2061 6e64 2061 7574 tication and aut │ │ │ │ │ +0003aac0: 686f 7269 7361 7469 6f6e 2069 6e20 4752 horisation in GR │ │ │ │ │ +0003aad0: 5542 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d UB.============= │ │ │ │ │ 0003aae0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003aaf0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ -0003ab00: 4279 2064 6566 6175 6c74 2c20 7468 6520 By default, the │ │ │ │ │ -0003ab10: 626f 6f74 206c 6f61 6465 7220 696e 7465 boot loader inte │ │ │ │ │ -0003ab20: 7266 6163 6520 6973 2061 6363 6573 7369 rface is accessi │ │ │ │ │ -0003ab30: 626c 6520 746f 2061 6e79 6f6e 6520 7769 ble to anyone wi │ │ │ │ │ -0003ab40: 7468 0a70 6879 7369 6361 6c20 6163 6365 th.physical acce │ │ │ │ │ -0003ab50: 7373 2074 6f20 7468 6520 636f 6e73 6f6c ss to the consol │ │ │ │ │ -0003ab60: 653a 2061 6e79 6f6e 6520 6361 6e20 7365 e: anyone can se │ │ │ │ │ -0003ab70: 6c65 6374 2061 6e64 2065 6469 7420 616e lect and edit an │ │ │ │ │ -0003ab80: 7920 6d65 6e75 0a65 6e74 7279 2c20 616e y menu.entry, an │ │ │ │ │ -0003ab90: 6420 616e 796f 6e65 2063 616e 2067 6574 d anyone can get │ │ │ │ │ -0003aba0: 2064 6972 6563 7420 6163 6365 7373 2074 direct access t │ │ │ │ │ -0003abb0: 6f20 6120 4752 5542 2073 6865 6c6c 2070 o a GRUB shell p │ │ │ │ │ -0003abc0: 726f 6d70 742e 2020 466f 720a 6d6f 7374 rompt. For.most │ │ │ │ │ -0003abd0: 2073 7973 7465 6d73 2c20 7468 6973 2069 systems, this i │ │ │ │ │ -0003abe0: 7320 7265 6173 6f6e 6162 6c65 2073 696e s reasonable sin │ │ │ │ │ -0003abf0: 6365 2061 6e79 6f6e 6520 7769 7468 2064 ce anyone with d │ │ │ │ │ -0003ac00: 6972 6563 7420 7068 7973 6963 616c 0a61 irect physical.a │ │ │ │ │ -0003ac10: 6363 6573 7320 6861 7320 6120 7661 7269 ccess has a vari │ │ │ │ │ -0003ac20: 6574 7920 6f66 206f 7468 6572 2077 6179 ety of other way │ │ │ │ │ -0003ac30: 7320 746f 2067 6169 6e20 6675 6c6c 2061 s to gain full a │ │ │ │ │ -0003ac40: 6363 6573 732c 2061 6e64 2072 6571 7569 ccess, and requi │ │ │ │ │ -0003ac50: 7269 6e67 0a61 7574 6865 6e74 6963 6174 ring.authenticat │ │ │ │ │ -0003ac60: 696f 6e20 6174 2074 6865 2062 6f6f 7420 ion at the boot │ │ │ │ │ -0003ac70: 6c6f 6164 6572 206c 6576 656c 2077 6f75 loader level wou │ │ │ │ │ -0003ac80: 6c64 206f 6e6c 7920 7365 7276 6520 746f ld only serve to │ │ │ │ │ -0003ac90: 206d 616b 6520 6974 0a64 6966 6669 6375 make it.difficu │ │ │ │ │ -0003aca0: 6c74 2074 6f20 7265 636f 7665 7220 6272 lt to recover br │ │ │ │ │ -0003acb0: 6f6b 656e 2073 7973 7465 6d73 2e0a 0a20 oken systems... │ │ │ │ │ -0003acc0: 2020 486f 7765 7665 722c 2069 6e20 736f However, in so │ │ │ │ │ -0003acd0: 6d65 2065 6e76 6972 6f6e 6d65 6e74 732c me environments, │ │ │ │ │ -0003ace0: 2073 7563 6820 6173 206b 696f 736b 732c such as kiosks, │ │ │ │ │ -0003acf0: 2069 7420 6d61 7920 6265 2061 7070 726f it may be appro │ │ │ │ │ -0003ad00: 7072 6961 7465 0a74 6f20 6c6f 636b 2064 priate.to lock d │ │ │ │ │ -0003ad10: 6f77 6e20 7468 6520 626f 6f74 206c 6f61 own the boot loa │ │ │ │ │ -0003ad20: 6465 7220 746f 2072 6571 7569 7265 2061 der to require a │ │ │ │ │ -0003ad30: 7574 6865 6e74 6963 6174 696f 6e20 6265 uthentication be │ │ │ │ │ -0003ad40: 666f 7265 2070 6572 666f 726d 696e 670a fore performing. │ │ │ │ │ -0003ad50: 6365 7274 6169 6e20 6f70 6572 6174 696f certain operatio │ │ │ │ │ -0003ad60: 6e73 2e0a 0a20 2020 5468 6520 2770 6173 ns... The 'pas │ │ │ │ │ -0003ad70: 7377 6f72 6427 2028 2a6e 6f74 6520 7061 sword' (*note pa │ │ │ │ │ -0003ad80: 7373 776f 7264 3a3a 2920 616e 6420 2770 ssword::) and 'p │ │ │ │ │ -0003ad90: 6173 7377 6f72 645f 7062 6b64 6632 2720 assword_pbkdf2' │ │ │ │ │ -0003ada0: 282a 6e6f 7465 0a70 6173 7377 6f72 645f (*note.password_ │ │ │ │ │ -0003adb0: 7062 6b64 6632 3a3a 2920 636f 6d6d 616e pbkdf2::) comman │ │ │ │ │ -0003adc0: 6473 2063 616e 2062 6520 7573 6564 2074 ds can be used t │ │ │ │ │ -0003add0: 6f20 6465 6669 6e65 2075 7365 7273 2c20 o define users, │ │ │ │ │ -0003ade0: 6561 6368 206f 6620 7768 6963 680a 6861 each of which.ha │ │ │ │ │ -0003adf0: 7320 616e 2061 7373 6f63 6961 7465 6420 s an associated │ │ │ │ │ -0003ae00: 7061 7373 776f 7264 2e20 2027 7061 7373 password. 'pass │ │ │ │ │ -0003ae10: 776f 7264 2720 7365 7473 2074 6865 2070 word' sets the p │ │ │ │ │ -0003ae20: 6173 7377 6f72 6420 696e 2070 6c61 696e assword in plain │ │ │ │ │ -0003ae30: 2074 6578 742c 0a72 6571 7569 7269 6e67 text,.requiring │ │ │ │ │ -0003ae40: 2027 6772 7562 2e63 6667 2720 746f 2062 'grub.cfg' to b │ │ │ │ │ -0003ae50: 6520 7365 6375 7265 3b20 2770 6173 7377 e secure; 'passw │ │ │ │ │ -0003ae60: 6f72 645f 7062 6b64 6632 2720 7365 7473 ord_pbkdf2' sets │ │ │ │ │ -0003ae70: 2074 6865 2070 6173 7377 6f72 640a 6861 the password.ha │ │ │ │ │ -0003ae80: 7368 6564 2075 7369 6e67 2074 6865 2050 shed using the P │ │ │ │ │ -0003ae90: 6173 7377 6f72 642d 4261 7365 6420 4b65 assword-Based Ke │ │ │ │ │ -0003aea0: 7920 4465 7269 7661 7469 6f6e 2046 756e y Derivation Fun │ │ │ │ │ -0003aeb0: 6374 696f 6e20 2852 4643 2032 3839 3829 ction (RFC 2898) │ │ │ │ │ -0003aec0: 2c0a 7265 7175 6972 696e 6720 7468 6520 ,.requiring the │ │ │ │ │ -0003aed0: 7573 6520 6f66 2027 6772 7562 2d6d 6b70 use of 'grub-mkp │ │ │ │ │ -0003aee0: 6173 7377 642d 7062 6b64 6632 2720 282a asswd-pbkdf2' (* │ │ │ │ │ -0003aef0: 6e6f 7465 2049 6e76 6f6b 696e 670a 6772 note Invoking.gr │ │ │ │ │ -0003af00: 7562 2d6d 6b70 6173 7377 642d 7062 6b64 ub-mkpasswd-pbkd │ │ │ │ │ -0003af10: 6632 3a3a 2920 746f 2067 656e 6572 6174 f2::) to generat │ │ │ │ │ -0003af20: 6520 7061 7373 776f 7264 2068 6173 6865 e password hashe │ │ │ │ │ -0003af30: 732e 0a0a 2020 2049 6e20 6f72 6465 7220 s... In order │ │ │ │ │ -0003af40: 746f 2065 6e61 626c 6520 6175 7468 656e to enable authen │ │ │ │ │ -0003af50: 7469 6361 7469 6f6e 2073 7570 706f 7274 tication support │ │ │ │ │ -0003af60: 2c20 7468 6520 2773 7570 6572 7573 6572 , the 'superuser │ │ │ │ │ -0003af70: 7327 0a65 6e76 6972 6f6e 6d65 6e74 2076 s'.environment v │ │ │ │ │ -0003af80: 6172 6961 626c 6520 6d75 7374 2062 6520 ariable must be │ │ │ │ │ -0003af90: 7365 7420 746f 2061 206c 6973 7420 6f66 set to a list of │ │ │ │ │ -0003afa0: 2075 7365 726e 616d 6573 2c20 7365 7061 usernames, sepa │ │ │ │ │ -0003afb0: 7261 7465 6420 6279 0a61 6e79 206f 6620 rated by.any of │ │ │ │ │ -0003afc0: 7370 6163 6573 2c20 636f 6d6d 6173 2c20 spaces, commas, │ │ │ │ │ -0003afd0: 7365 6d69 636f 6c6f 6e73 2c20 7069 7065 semicolons, pipe │ │ │ │ │ -0003afe0: 732c 206f 7220 616d 7065 7273 616e 6473 s, or ampersands │ │ │ │ │ -0003aff0: 2e20 2053 7570 6572 7573 6572 7320 6172 . Superusers ar │ │ │ │ │ -0003b000: 650a 7065 726d 6974 7465 6420 746f 2075 e.permitted to u │ │ │ │ │ -0003b010: 7365 2074 6865 2047 5255 4220 636f 6d6d se the GRUB comm │ │ │ │ │ -0003b020: 616e 6420 6c69 6e65 2c20 6564 6974 206d and line, edit m │ │ │ │ │ -0003b030: 656e 7520 656e 7472 6965 732c 2061 6e64 enu entries, and │ │ │ │ │ -0003b040: 2065 7865 6375 7465 0a61 6e79 206d 656e execute.any men │ │ │ │ │ -0003b050: 7520 656e 7472 792e 2020 4966 2027 7375 u entry. If 'su │ │ │ │ │ -0003b060: 7065 7275 7365 7273 2720 6973 2073 6574 perusers' is set │ │ │ │ │ -0003b070: 2c20 7468 656e 2075 7365 206f 6620 7468 , then use of th │ │ │ │ │ -0003b080: 6520 636f 6d6d 616e 6420 6c69 6e65 0a61 e command line.a │ │ │ │ │ -0003b090: 6e64 2065 6469 7469 6e67 206f 6620 6d65 nd editing of me │ │ │ │ │ -0003b0a0: 6e75 2065 6e74 7269 6573 2061 7265 2061 nu entries are a │ │ │ │ │ -0003b0b0: 7574 6f6d 6174 6963 616c 6c79 2072 6573 utomatically res │ │ │ │ │ -0003b0c0: 7472 6963 7465 6420 746f 2073 7570 6572 tricted to super │ │ │ │ │ -0003b0d0: 7573 6572 732e 0a53 6574 7469 6e67 2027 users..Setting ' │ │ │ │ │ -0003b0e0: 7375 7065 7275 7365 7273 2720 746f 2065 superusers' to e │ │ │ │ │ -0003b0f0: 6d70 7479 2073 7472 696e 6720 6566 6665 mpty string effe │ │ │ │ │ -0003b100: 6374 6976 656c 7920 6469 7361 626c 6573 ctively disables │ │ │ │ │ -0003b110: 2062 6f74 6820 6163 6365 7373 2074 6f0a both access to. │ │ │ │ │ -0003b120: 434c 4920 616e 6420 6564 6974 696e 6720 CLI and editing │ │ │ │ │ -0003b130: 6f66 206d 656e 7520 656e 7472 6965 732e of menu entries. │ │ │ │ │ -0003b140: 2020 4e6f 7465 3a20 5468 6520 656e 7669 Note: The envi │ │ │ │ │ -0003b150: 726f 6e6d 656e 7420 7661 7269 6162 6c65 ronment variable │ │ │ │ │ -0003b160: 206e 6565 6473 0a74 6f20 6265 2065 7870 needs.to be exp │ │ │ │ │ -0003b170: 6f72 7465 6420 746f 2061 6c73 6f20 6166 orted to also af │ │ │ │ │ -0003b180: 6665 6374 2074 6865 2073 6563 7469 6f6e fect the section │ │ │ │ │ -0003b190: 2064 6566 696e 6564 2062 7920 7468 6520 defined by the │ │ │ │ │ -0003b1a0: 2773 7562 6d65 6e75 270a 636f 6d6d 616e 'submenu'.comman │ │ │ │ │ -0003b1b0: 6420 282a 6e6f 7465 2073 7562 6d65 6e75 d (*note submenu │ │ │ │ │ -0003b1c0: 3a3a 292e 0a0a 2020 204f 7468 6572 2075 ::)... Other u │ │ │ │ │ -0003b1d0: 7365 7273 206d 6179 2062 6520 616c 6c6f sers may be allo │ │ │ │ │ -0003b1e0: 7765 6420 746f 2065 7865 6375 7465 2073 wed to execute s │ │ │ │ │ -0003b1f0: 7065 6369 6669 6320 6d65 6e75 2065 6e74 pecific menu ent │ │ │ │ │ -0003b200: 7269 6573 2062 7920 6769 7669 6e67 0a61 ries by giving.a │ │ │ │ │ -0003b210: 206c 6973 7420 6f66 2075 7365 726e 616d list of usernam │ │ │ │ │ -0003b220: 6573 2028 6173 2061 626f 7665 2920 7573 es (as above) us │ │ │ │ │ -0003b230: 696e 6720 7468 6520 272d 2d75 7365 7273 ing the '--users │ │ │ │ │ -0003b240: 2720 6f70 7469 6f6e 2074 6f20 7468 650a ' option to the. │ │ │ │ │ -0003b250: 276d 656e 7565 6e74 7279 2720 636f 6d6d 'menuentry' comm │ │ │ │ │ -0003b260: 616e 6420 282a 6e6f 7465 206d 656e 7565 and (*note menue │ │ │ │ │ -0003b270: 6e74 7279 3a3a 292e 2020 4966 2074 6865 ntry::). If the │ │ │ │ │ -0003b280: 2027 2d2d 756e 7265 7374 7269 6374 6564 '--unrestricted │ │ │ │ │ -0003b290: 2720 6f70 7469 6f6e 0a69 7320 7573 6564 ' option.is used │ │ │ │ │ -0003b2a0: 2066 6f72 2061 206d 656e 7520 656e 7472 for a menu entr │ │ │ │ │ -0003b2b0: 792c 2074 6865 6e20 7468 6174 2065 6e74 y, then that ent │ │ │ │ │ -0003b2c0: 7279 2069 7320 756e 7265 7374 7269 6374 ry is unrestrict │ │ │ │ │ -0003b2d0: 6564 2e20 2049 6620 7468 650a 272d 2d75 ed. If the.'--u │ │ │ │ │ -0003b2e0: 7365 7273 2720 6f70 7469 6f6e 2069 7320 sers' option is │ │ │ │ │ -0003b2f0: 6e6f 7420 7573 6564 2066 6f72 2061 206d not used for a m │ │ │ │ │ -0003b300: 656e 7520 656e 7472 792c 2074 6865 6e20 enu entry, then │ │ │ │ │ -0003b310: 7468 6174 206f 6e6c 7920 7375 7065 7275 that only superu │ │ │ │ │ -0003b320: 7365 7273 0a61 7265 2061 626c 6520 746f sers.are able to │ │ │ │ │ -0003b330: 2075 7365 2069 742e 0a0a 2020 2050 7574 use it... Put │ │ │ │ │ -0003b340: 7469 6e67 2074 6869 7320 746f 6765 7468 ting this togeth │ │ │ │ │ -0003b350: 6572 2c20 6120 7479 7069 6361 6c20 2767 er, a typical 'g │ │ │ │ │ -0003b360: 7275 622e 6366 6727 2066 7261 676d 656e rub.cfg' fragmen │ │ │ │ │ -0003b370: 7420 6d69 6768 7420 6c6f 6f6b 206c 696b t might look lik │ │ │ │ │ -0003b380: 650a 7468 6973 3a0a 0a20 2020 2020 7365 e.this:.. se │ │ │ │ │ -0003b390: 7420 7375 7065 7275 7365 7273 3d22 726f t superusers="ro │ │ │ │ │ -0003b3a0: 6f74 220a 2020 2020 2070 6173 7377 6f72 ot". passwor │ │ │ │ │ -0003b3b0: 645f 7062 6b64 6632 2072 6f6f 7420 6772 d_pbkdf2 root gr │ │ │ │ │ -0003b3c0: 7562 2e70 626b 6466 322e 7368 6135 3132 ub.pbkdf2.sha512 │ │ │ │ │ -0003b3d0: 2e31 3030 3030 2e62 6967 6c6f 6e67 7374 .10000.biglongst │ │ │ │ │ -0003b3e0: 7269 6e67 0a20 2020 2020 7061 7373 776f ring. passwo │ │ │ │ │ -0003b3f0: 7264 2075 7365 7231 2069 6e73 6563 7572 rd user1 insecur │ │ │ │ │ -0003b400: 650a 0a20 2020 2020 6d65 6e75 656e 7472 e.. menuentr │ │ │ │ │ -0003b410: 7920 224d 6179 2062 6520 7275 6e20 6279 y "May be run by │ │ │ │ │ -0003b420: 2061 6e79 2075 7365 7222 202d 2d75 6e72 any user" --unr │ │ │ │ │ -0003b430: 6573 7472 6963 7465 6420 7b0a 2020 2020 estricted {. │ │ │ │ │ -0003b440: 2009 7365 7420 726f 6f74 3d28 6864 302c .set root=(hd0, │ │ │ │ │ -0003b450: 3129 0a20 2020 2020 096c 696e 7578 202f 1). .linux / │ │ │ │ │ -0003b460: 766d 6c69 6e75 7a0a 2020 2020 207d 0a0a vmlinuz. }.. │ │ │ │ │ -0003b470: 2020 2020 206d 656e 7565 6e74 7279 2022 menuentry " │ │ │ │ │ -0003b480: 5375 7065 7275 7365 7273 206f 6e6c 7922 Superusers only" │ │ │ │ │ -0003b490: 202d 2d75 7365 7273 2022 2220 7b0a 2020 --users "" {. │ │ │ │ │ -0003b4a0: 2020 2009 7365 7420 726f 6f74 3d28 6864 .set root=(hd │ │ │ │ │ -0003b4b0: 302c 3129 0a20 2020 2020 096c 696e 7578 0,1). .linux │ │ │ │ │ -0003b4c0: 202f 766d 6c69 6e75 7a20 7369 6e67 6c65 /vmlinuz single │ │ │ │ │ -0003b4d0: 0a20 2020 2020 7d0a 0a20 2020 2020 6d65 . }.. me │ │ │ │ │ -0003b4e0: 6e75 656e 7472 7920 224d 6179 2062 6520 nuentry "May be │ │ │ │ │ -0003b4f0: 7275 6e20 6279 2075 7365 7231 206f 7220 run by user1 or │ │ │ │ │ -0003b500: 6120 7375 7065 7275 7365 7222 202d 2d75 a superuser" --u │ │ │ │ │ -0003b510: 7365 7273 2075 7365 7231 207b 0a20 2020 sers user1 {. │ │ │ │ │ -0003b520: 2020 0973 6574 2072 6f6f 743d 2868 6430 .set root=(hd0 │ │ │ │ │ -0003b530: 2c32 290a 2020 2020 2009 6368 6169 6e6c ,2). .chainl │ │ │ │ │ -0003b540: 6f61 6465 7220 2b31 0a20 2020 2020 7d0a oader +1. }. │ │ │ │ │ -0003b550: 0a20 2020 5468 6520 2767 7275 622d 6d6b . The 'grub-mk │ │ │ │ │ -0003b560: 636f 6e66 6967 2720 7072 6f67 7261 6d20 config' program │ │ │ │ │ -0003b570: 646f 6573 206e 6f74 2079 6574 2068 6176 does not yet hav │ │ │ │ │ -0003b580: 6520 6275 696c 742d 696e 2073 7570 706f e built-in suppo │ │ │ │ │ -0003b590: 7274 2066 6f72 0a67 656e 6572 6174 696e rt for.generatin │ │ │ │ │ -0003b5a0: 6720 636f 6e66 6967 7572 6174 696f 6e20 g configuration │ │ │ │ │ -0003b5b0: 6669 6c65 7320 7769 7468 2061 7574 6865 files with authe │ │ │ │ │ -0003b5c0: 6e74 6963 6174 696f 6e2e 2020 596f 7520 ntication. You │ │ │ │ │ -0003b5d0: 6361 6e20 7573 650a 272f 6574 632f 6772 can use.'/etc/gr │ │ │ │ │ -0003b5e0: 7562 2e64 2f34 305f 6375 7374 6f6d 2720 ub.d/40_custom' │ │ │ │ │ -0003b5f0: 746f 2061 6464 2073 696d 706c 6520 7375 to add simple su │ │ │ │ │ -0003b600: 7065 7275 7365 7220 6175 7468 656e 7469 peruser authenti │ │ │ │ │ -0003b610: 6361 7469 6f6e 2c20 6279 0a61 6464 696e cation, by.addin │ │ │ │ │ -0003b620: 6720 2773 6574 2073 7570 6572 7573 6572 g 'set superuser │ │ │ │ │ -0003b630: 733d 2720 616e 6420 2770 6173 7377 6f72 s=' and 'passwor │ │ │ │ │ -0003b640: 6427 206f 7220 2770 6173 7377 6f72 645f d' or 'password_ │ │ │ │ │ -0003b650: 7062 6b64 6632 2720 636f 6d6d 616e 6473 pbkdf2' commands │ │ │ │ │ -0003b660: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ -0003b670: 696e 666f 2c20 204e 6f64 653a 2055 7369 info, Node: Usi │ │ │ │ │ -0003b680: 6e67 2064 6967 6974 616c 2073 6967 6e61 ng digital signa │ │ │ │ │ -0003b690: 7475 7265 732c 2020 4e65 7874 3a20 5545 tures, Next: UE │ │ │ │ │ -0003b6a0: 4649 2073 6563 7572 6520 626f 6f74 2061 FI secure boot a │ │ │ │ │ -0003b6b0: 6e64 2073 6869 6d2c 2020 5072 6576 3a20 nd shim, Prev: │ │ │ │ │ -0003b6c0: 4175 7468 656e 7469 6361 7469 6f6e 2061 Authentication a │ │ │ │ │ -0003b6d0: 6e64 2061 7574 686f 7269 7361 7469 6f6e nd authorisation │ │ │ │ │ -0003b6e0: 2c20 2055 703a 2053 6563 7572 6974 790a , Up: Security. │ │ │ │ │ -0003b6f0: 0a31 382e 3220 5573 696e 6720 6469 6769 .18.2 Using digi │ │ │ │ │ -0003b700: 7461 6c20 7369 676e 6174 7572 6573 2069 tal signatures i │ │ │ │ │ -0003b710: 6e20 4752 5542 0a3d 3d3d 3d3d 3d3d 3d3d n GRUB.========= │ │ │ │ │ +0003aaf0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +0003ab00: 0a0a 4279 2064 6566 6175 6c74 2c20 7468 ..By default, th │ │ │ │ │ +0003ab10: 6520 626f 6f74 206c 6f61 6465 7220 696e e boot loader in │ │ │ │ │ +0003ab20: 7465 7266 6163 6520 6973 2061 6363 6573 terface is acces │ │ │ │ │ +0003ab30: 7369 626c 6520 746f 2061 6e79 6f6e 6520 sible to anyone │ │ │ │ │ +0003ab40: 7769 7468 0a70 6879 7369 6361 6c20 6163 with.physical ac │ │ │ │ │ +0003ab50: 6365 7373 2074 6f20 7468 6520 636f 6e73 cess to the cons │ │ │ │ │ +0003ab60: 6f6c 653a 2061 6e79 6f6e 6520 6361 6e20 ole: anyone can │ │ │ │ │ +0003ab70: 7365 6c65 6374 2061 6e64 2065 6469 7420 select and edit │ │ │ │ │ +0003ab80: 616e 7920 6d65 6e75 0a65 6e74 7279 2c20 any menu.entry, │ │ │ │ │ +0003ab90: 616e 6420 616e 796f 6e65 2063 616e 2067 and anyone can g │ │ │ │ │ +0003aba0: 6574 2064 6972 6563 7420 6163 6365 7373 et direct access │ │ │ │ │ +0003abb0: 2074 6f20 6120 4752 5542 2073 6865 6c6c to a GRUB shell │ │ │ │ │ +0003abc0: 2070 726f 6d70 742e 2020 466f 720a 6d6f prompt. For.mo │ │ │ │ │ +0003abd0: 7374 2073 7973 7465 6d73 2c20 7468 6973 st systems, this │ │ │ │ │ +0003abe0: 2069 7320 7265 6173 6f6e 6162 6c65 2073 is reasonable s │ │ │ │ │ +0003abf0: 696e 6365 2061 6e79 6f6e 6520 7769 7468 ince anyone with │ │ │ │ │ +0003ac00: 2064 6972 6563 7420 7068 7973 6963 616c direct physical │ │ │ │ │ +0003ac10: 0a61 6363 6573 7320 6861 7320 6120 7661 .access has a va │ │ │ │ │ +0003ac20: 7269 6574 7920 6f66 206f 7468 6572 2077 riety of other w │ │ │ │ │ +0003ac30: 6179 7320 746f 2067 6169 6e20 6675 6c6c ays to gain full │ │ │ │ │ +0003ac40: 2061 6363 6573 732c 2061 6e64 2072 6571 access, and req │ │ │ │ │ +0003ac50: 7569 7269 6e67 0a61 7574 6865 6e74 6963 uiring.authentic │ │ │ │ │ +0003ac60: 6174 696f 6e20 6174 2074 6865 2062 6f6f ation at the boo │ │ │ │ │ +0003ac70: 7420 6c6f 6164 6572 206c 6576 656c 2077 t loader level w │ │ │ │ │ +0003ac80: 6f75 6c64 206f 6e6c 7920 7365 7276 6520 ould only serve │ │ │ │ │ +0003ac90: 746f 206d 616b 6520 6974 0a64 6966 6669 to make it.diffi │ │ │ │ │ +0003aca0: 6375 6c74 2074 6f20 7265 636f 7665 7220 cult to recover │ │ │ │ │ +0003acb0: 6272 6f6b 656e 2073 7973 7465 6d73 2e0a broken systems.. │ │ │ │ │ +0003acc0: 0a20 2020 486f 7765 7665 722c 2069 6e20 . However, in │ │ │ │ │ +0003acd0: 736f 6d65 2065 6e76 6972 6f6e 6d65 6e74 some environment │ │ │ │ │ +0003ace0: 732c 2073 7563 6820 6173 206b 696f 736b s, such as kiosk │ │ │ │ │ +0003acf0: 732c 2069 7420 6d61 7920 6265 2061 7070 s, it may be app │ │ │ │ │ +0003ad00: 726f 7072 6961 7465 0a74 6f20 6c6f 636b ropriate.to lock │ │ │ │ │ +0003ad10: 2064 6f77 6e20 7468 6520 626f 6f74 206c down the boot l │ │ │ │ │ +0003ad20: 6f61 6465 7220 746f 2072 6571 7569 7265 oader to require │ │ │ │ │ +0003ad30: 2061 7574 6865 6e74 6963 6174 696f 6e20 authentication │ │ │ │ │ +0003ad40: 6265 666f 7265 2070 6572 666f 726d 696e before performin │ │ │ │ │ +0003ad50: 670a 6365 7274 6169 6e20 6f70 6572 6174 g.certain operat │ │ │ │ │ +0003ad60: 696f 6e73 2e0a 0a20 2020 5468 6520 2770 ions... The 'p │ │ │ │ │ +0003ad70: 6173 7377 6f72 6427 2028 2a6e 6f74 6520 assword' (*note │ │ │ │ │ +0003ad80: 7061 7373 776f 7264 3a3a 2920 616e 6420 password::) and │ │ │ │ │ +0003ad90: 2770 6173 7377 6f72 645f 7062 6b64 6632 'password_pbkdf2 │ │ │ │ │ +0003ada0: 2720 282a 6e6f 7465 0a70 6173 7377 6f72 ' (*note.passwor │ │ │ │ │ +0003adb0: 645f 7062 6b64 6632 3a3a 2920 636f 6d6d d_pbkdf2::) comm │ │ │ │ │ +0003adc0: 616e 6473 2063 616e 2062 6520 7573 6564 ands can be used │ │ │ │ │ +0003add0: 2074 6f20 6465 6669 6e65 2075 7365 7273 to define users │ │ │ │ │ +0003ade0: 2c20 6561 6368 206f 6620 7768 6963 680a , each of which. │ │ │ │ │ +0003adf0: 6861 7320 616e 2061 7373 6f63 6961 7465 has an associate │ │ │ │ │ +0003ae00: 6420 7061 7373 776f 7264 2e20 2027 7061 d password. 'pa │ │ │ │ │ +0003ae10: 7373 776f 7264 2720 7365 7473 2074 6865 ssword' sets the │ │ │ │ │ +0003ae20: 2070 6173 7377 6f72 6420 696e 2070 6c61 password in pla │ │ │ │ │ +0003ae30: 696e 2074 6578 742c 0a72 6571 7569 7269 in text,.requiri │ │ │ │ │ +0003ae40: 6e67 2027 6772 7562 2e63 6667 2720 746f ng 'grub.cfg' to │ │ │ │ │ +0003ae50: 2062 6520 7365 6375 7265 3b20 2770 6173 be secure; 'pas │ │ │ │ │ +0003ae60: 7377 6f72 645f 7062 6b64 6632 2720 7365 sword_pbkdf2' se │ │ │ │ │ +0003ae70: 7473 2074 6865 2070 6173 7377 6f72 640a ts the password. │ │ │ │ │ +0003ae80: 6861 7368 6564 2075 7369 6e67 2074 6865 hashed using the │ │ │ │ │ +0003ae90: 2050 6173 7377 6f72 642d 4261 7365 6420 Password-Based │ │ │ │ │ +0003aea0: 4b65 7920 4465 7269 7661 7469 6f6e 2046 Key Derivation F │ │ │ │ │ +0003aeb0: 756e 6374 696f 6e20 2852 4643 2032 3839 unction (RFC 289 │ │ │ │ │ +0003aec0: 3829 2c0a 7265 7175 6972 696e 6720 7468 8),.requiring th │ │ │ │ │ +0003aed0: 6520 7573 6520 6f66 2027 6772 7562 2d6d e use of 'grub-m │ │ │ │ │ +0003aee0: 6b70 6173 7377 642d 7062 6b64 6632 2720 kpasswd-pbkdf2' │ │ │ │ │ +0003aef0: 282a 6e6f 7465 2049 6e76 6f6b 696e 670a (*note Invoking. │ │ │ │ │ +0003af00: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ +0003af10: 6b64 6632 3a3a 2920 746f 2067 656e 6572 kdf2::) to gener │ │ │ │ │ +0003af20: 6174 6520 7061 7373 776f 7264 2068 6173 ate password has │ │ │ │ │ +0003af30: 6865 732e 0a0a 2020 2049 6e20 6f72 6465 hes... In orde │ │ │ │ │ +0003af40: 7220 746f 2065 6e61 626c 6520 6175 7468 r to enable auth │ │ │ │ │ +0003af50: 656e 7469 6361 7469 6f6e 2073 7570 706f entication suppo │ │ │ │ │ +0003af60: 7274 2c20 7468 6520 2773 7570 6572 7573 rt, the 'superus │ │ │ │ │ +0003af70: 6572 7327 0a65 6e76 6972 6f6e 6d65 6e74 ers'.environment │ │ │ │ │ +0003af80: 2076 6172 6961 626c 6520 6d75 7374 2062 variable must b │ │ │ │ │ +0003af90: 6520 7365 7420 746f 2061 206c 6973 7420 e set to a list │ │ │ │ │ +0003afa0: 6f66 2075 7365 726e 616d 6573 2c20 7365 of usernames, se │ │ │ │ │ +0003afb0: 7061 7261 7465 6420 6279 0a61 6e79 206f parated by.any o │ │ │ │ │ +0003afc0: 6620 7370 6163 6573 2c20 636f 6d6d 6173 f spaces, commas │ │ │ │ │ +0003afd0: 2c20 7365 6d69 636f 6c6f 6e73 2c20 7069 , semicolons, pi │ │ │ │ │ +0003afe0: 7065 732c 206f 7220 616d 7065 7273 616e pes, or ampersan │ │ │ │ │ +0003aff0: 6473 2e20 2053 7570 6572 7573 6572 7320 ds. Superusers │ │ │ │ │ +0003b000: 6172 650a 7065 726d 6974 7465 6420 746f are.permitted to │ │ │ │ │ +0003b010: 2075 7365 2074 6865 2047 5255 4220 636f use the GRUB co │ │ │ │ │ +0003b020: 6d6d 616e 6420 6c69 6e65 2c20 6564 6974 mmand line, edit │ │ │ │ │ +0003b030: 206d 656e 7520 656e 7472 6965 732c 2061 menu entries, a │ │ │ │ │ +0003b040: 6e64 2065 7865 6375 7465 0a61 6e79 206d nd execute.any m │ │ │ │ │ +0003b050: 656e 7520 656e 7472 792e 2020 4966 2027 enu entry. If ' │ │ │ │ │ +0003b060: 7375 7065 7275 7365 7273 2720 6973 2073 superusers' is s │ │ │ │ │ +0003b070: 6574 2c20 7468 656e 2075 7365 206f 6620 et, then use of │ │ │ │ │ +0003b080: 7468 6520 636f 6d6d 616e 6420 6c69 6e65 the command line │ │ │ │ │ +0003b090: 0a61 6e64 2065 6469 7469 6e67 206f 6620 .and editing of │ │ │ │ │ +0003b0a0: 6d65 6e75 2065 6e74 7269 6573 2061 7265 menu entries are │ │ │ │ │ +0003b0b0: 2061 7574 6f6d 6174 6963 616c 6c79 2072 automatically r │ │ │ │ │ +0003b0c0: 6573 7472 6963 7465 6420 746f 2073 7570 estricted to sup │ │ │ │ │ +0003b0d0: 6572 7573 6572 732e 0a53 6574 7469 6e67 erusers..Setting │ │ │ │ │ +0003b0e0: 2027 7375 7065 7275 7365 7273 2720 746f 'superusers' to │ │ │ │ │ +0003b0f0: 2065 6d70 7479 2073 7472 696e 6720 6566 empty string ef │ │ │ │ │ +0003b100: 6665 6374 6976 656c 7920 6469 7361 626c fectively disabl │ │ │ │ │ +0003b110: 6573 2062 6f74 6820 6163 6365 7373 2074 es both access t │ │ │ │ │ +0003b120: 6f0a 434c 4920 616e 6420 6564 6974 696e o.CLI and editin │ │ │ │ │ +0003b130: 6720 6f66 206d 656e 7520 656e 7472 6965 g of menu entrie │ │ │ │ │ +0003b140: 732e 2020 4e6f 7465 3a20 5468 6520 656e s. Note: The en │ │ │ │ │ +0003b150: 7669 726f 6e6d 656e 7420 7661 7269 6162 vironment variab │ │ │ │ │ +0003b160: 6c65 206e 6565 6473 0a74 6f20 6265 2065 le needs.to be e │ │ │ │ │ +0003b170: 7870 6f72 7465 6420 746f 2061 6c73 6f20 xported to also │ │ │ │ │ +0003b180: 6166 6665 6374 2074 6865 2073 6563 7469 affect the secti │ │ │ │ │ +0003b190: 6f6e 2064 6566 696e 6564 2062 7920 7468 on defined by th │ │ │ │ │ +0003b1a0: 6520 2773 7562 6d65 6e75 270a 636f 6d6d e 'submenu'.comm │ │ │ │ │ +0003b1b0: 616e 6420 282a 6e6f 7465 2073 7562 6d65 and (*note subme │ │ │ │ │ +0003b1c0: 6e75 3a3a 292e 0a0a 2020 204f 7468 6572 nu::)... Other │ │ │ │ │ +0003b1d0: 2075 7365 7273 206d 6179 2062 6520 616c users may be al │ │ │ │ │ +0003b1e0: 6c6f 7765 6420 746f 2065 7865 6375 7465 lowed to execute │ │ │ │ │ +0003b1f0: 2073 7065 6369 6669 6320 6d65 6e75 2065 specific menu e │ │ │ │ │ +0003b200: 6e74 7269 6573 2062 7920 6769 7669 6e67 ntries by giving │ │ │ │ │ +0003b210: 0a61 206c 6973 7420 6f66 2075 7365 726e .a list of usern │ │ │ │ │ +0003b220: 616d 6573 2028 6173 2061 626f 7665 2920 ames (as above) │ │ │ │ │ +0003b230: 7573 696e 6720 7468 6520 272d 2d75 7365 using the '--use │ │ │ │ │ +0003b240: 7273 2720 6f70 7469 6f6e 2074 6f20 7468 rs' option to th │ │ │ │ │ +0003b250: 650a 276d 656e 7565 6e74 7279 2720 636f e.'menuentry' co │ │ │ │ │ +0003b260: 6d6d 616e 6420 282a 6e6f 7465 206d 656e mmand (*note men │ │ │ │ │ +0003b270: 7565 6e74 7279 3a3a 292e 2020 4966 2074 uentry::). If t │ │ │ │ │ +0003b280: 6865 2027 2d2d 756e 7265 7374 7269 6374 he '--unrestrict │ │ │ │ │ +0003b290: 6564 2720 6f70 7469 6f6e 0a69 7320 7573 ed' option.is us │ │ │ │ │ +0003b2a0: 6564 2066 6f72 2061 206d 656e 7520 656e ed for a menu en │ │ │ │ │ +0003b2b0: 7472 792c 2074 6865 6e20 7468 6174 2065 try, then that e │ │ │ │ │ +0003b2c0: 6e74 7279 2069 7320 756e 7265 7374 7269 ntry is unrestri │ │ │ │ │ +0003b2d0: 6374 6564 2e20 2049 6620 7468 650a 272d cted. If the.'- │ │ │ │ │ +0003b2e0: 2d75 7365 7273 2720 6f70 7469 6f6e 2069 -users' option i │ │ │ │ │ +0003b2f0: 7320 6e6f 7420 7573 6564 2066 6f72 2061 s not used for a │ │ │ │ │ +0003b300: 206d 656e 7520 656e 7472 792c 2074 6865 menu entry, the │ │ │ │ │ +0003b310: 6e20 7468 6174 206f 6e6c 7920 7375 7065 n that only supe │ │ │ │ │ +0003b320: 7275 7365 7273 0a61 7265 2061 626c 6520 rusers.are able │ │ │ │ │ +0003b330: 746f 2075 7365 2069 742e 0a0a 2020 2050 to use it... P │ │ │ │ │ +0003b340: 7574 7469 6e67 2074 6869 7320 746f 6765 utting this toge │ │ │ │ │ +0003b350: 7468 6572 2c20 6120 7479 7069 6361 6c20 ther, a typical │ │ │ │ │ +0003b360: 2767 7275 622e 6366 6727 2066 7261 676d 'grub.cfg' fragm │ │ │ │ │ +0003b370: 656e 7420 6d69 6768 7420 6c6f 6f6b 206c ent might look l │ │ │ │ │ +0003b380: 696b 650a 7468 6973 3a0a 0a20 2020 2020 ike.this:.. │ │ │ │ │ +0003b390: 7365 7420 7375 7065 7275 7365 7273 3d22 set superusers=" │ │ │ │ │ +0003b3a0: 726f 6f74 220a 2020 2020 2070 6173 7377 root". passw │ │ │ │ │ +0003b3b0: 6f72 645f 7062 6b64 6632 2072 6f6f 7420 ord_pbkdf2 root │ │ │ │ │ +0003b3c0: 6772 7562 2e70 626b 6466 322e 7368 6135 grub.pbkdf2.sha5 │ │ │ │ │ +0003b3d0: 3132 2e31 3030 3030 2e62 6967 6c6f 6e67 12.10000.biglong │ │ │ │ │ +0003b3e0: 7374 7269 6e67 0a20 2020 2020 7061 7373 string. pass │ │ │ │ │ +0003b3f0: 776f 7264 2075 7365 7231 2069 6e73 6563 word user1 insec │ │ │ │ │ +0003b400: 7572 650a 0a20 2020 2020 6d65 6e75 656e ure.. menuen │ │ │ │ │ +0003b410: 7472 7920 224d 6179 2062 6520 7275 6e20 try "May be run │ │ │ │ │ +0003b420: 6279 2061 6e79 2075 7365 7222 202d 2d75 by any user" --u │ │ │ │ │ +0003b430: 6e72 6573 7472 6963 7465 6420 7b0a 2020 nrestricted {. │ │ │ │ │ +0003b440: 2020 2009 7365 7420 726f 6f74 3d28 6864 .set root=(hd │ │ │ │ │ +0003b450: 302c 3129 0a20 2020 2020 096c 696e 7578 0,1). .linux │ │ │ │ │ +0003b460: 202f 766d 6c69 6e75 7a0a 2020 2020 207d /vmlinuz. } │ │ │ │ │ +0003b470: 0a0a 2020 2020 206d 656e 7565 6e74 7279 .. menuentry │ │ │ │ │ +0003b480: 2022 5375 7065 7275 7365 7273 206f 6e6c "Superusers onl │ │ │ │ │ +0003b490: 7922 202d 2d75 7365 7273 2022 2220 7b0a y" --users "" {. │ │ │ │ │ +0003b4a0: 2020 2020 2009 7365 7420 726f 6f74 3d28 .set root=( │ │ │ │ │ +0003b4b0: 6864 302c 3129 0a20 2020 2020 096c 696e hd0,1). .lin │ │ │ │ │ +0003b4c0: 7578 202f 766d 6c69 6e75 7a20 7369 6e67 ux /vmlinuz sing │ │ │ │ │ +0003b4d0: 6c65 0a20 2020 2020 7d0a 0a20 2020 2020 le. }.. │ │ │ │ │ +0003b4e0: 6d65 6e75 656e 7472 7920 224d 6179 2062 menuentry "May b │ │ │ │ │ +0003b4f0: 6520 7275 6e20 6279 2075 7365 7231 206f e run by user1 o │ │ │ │ │ +0003b500: 7220 6120 7375 7065 7275 7365 7222 202d r a superuser" - │ │ │ │ │ +0003b510: 2d75 7365 7273 2075 7365 7231 207b 0a20 -users user1 {. │ │ │ │ │ +0003b520: 2020 2020 0973 6574 2072 6f6f 743d 2868 .set root=(h │ │ │ │ │ +0003b530: 6430 2c32 290a 2020 2020 2009 6368 6169 d0,2). .chai │ │ │ │ │ +0003b540: 6e6c 6f61 6465 7220 2b31 0a20 2020 2020 nloader +1. │ │ │ │ │ +0003b550: 7d0a 0a20 2020 5468 6520 2767 7275 622d }.. The 'grub- │ │ │ │ │ +0003b560: 6d6b 636f 6e66 6967 2720 7072 6f67 7261 mkconfig' progra │ │ │ │ │ +0003b570: 6d20 646f 6573 206e 6f74 2079 6574 2068 m does not yet h │ │ │ │ │ +0003b580: 6176 6520 6275 696c 742d 696e 2073 7570 ave built-in sup │ │ │ │ │ +0003b590: 706f 7274 2066 6f72 0a67 656e 6572 6174 port for.generat │ │ │ │ │ +0003b5a0: 696e 6720 636f 6e66 6967 7572 6174 696f ing configuratio │ │ │ │ │ +0003b5b0: 6e20 6669 6c65 7320 7769 7468 2061 7574 n files with aut │ │ │ │ │ +0003b5c0: 6865 6e74 6963 6174 696f 6e2e 2020 596f hentication. Yo │ │ │ │ │ +0003b5d0: 7520 6361 6e20 7573 650a 272f 6574 632f u can use.'/etc/ │ │ │ │ │ +0003b5e0: 6772 7562 2e64 2f34 305f 6375 7374 6f6d grub.d/40_custom │ │ │ │ │ +0003b5f0: 2720 746f 2061 6464 2073 696d 706c 6520 ' to add simple │ │ │ │ │ +0003b600: 7375 7065 7275 7365 7220 6175 7468 656e superuser authen │ │ │ │ │ +0003b610: 7469 6361 7469 6f6e 2c20 6279 0a61 6464 tication, by.add │ │ │ │ │ +0003b620: 696e 6720 2773 6574 2073 7570 6572 7573 ing 'set superus │ │ │ │ │ +0003b630: 6572 733d 2720 616e 6420 2770 6173 7377 ers=' and 'passw │ │ │ │ │ +0003b640: 6f72 6427 206f 7220 2770 6173 7377 6f72 ord' or 'passwor │ │ │ │ │ +0003b650: 645f 7062 6b64 6632 2720 636f 6d6d 616e d_pbkdf2' comman │ │ │ │ │ +0003b660: 6473 2e0a 0a1f 0a46 696c 653a 2067 7275 ds.....File: gru │ │ │ │ │ +0003b670: 622e 696e 666f 2c20 204e 6f64 653a 2055 b.info, Node: U │ │ │ │ │ +0003b680: 7369 6e67 2064 6967 6974 616c 2073 6967 sing digital sig │ │ │ │ │ +0003b690: 6e61 7475 7265 732c 2020 4e65 7874 3a20 natures, Next: │ │ │ │ │ +0003b6a0: 5545 4649 2073 6563 7572 6520 626f 6f74 UEFI secure boot │ │ │ │ │ +0003b6b0: 2061 6e64 2073 6869 6d2c 2020 5072 6576 and shim, Prev │ │ │ │ │ +0003b6c0: 3a20 4175 7468 656e 7469 6361 7469 6f6e : Authentication │ │ │ │ │ +0003b6d0: 2061 6e64 2061 7574 686f 7269 7361 7469 and authorisati │ │ │ │ │ +0003b6e0: 6f6e 2c20 2055 703a 2053 6563 7572 6974 on, Up: Securit │ │ │ │ │ +0003b6f0: 790a 0a31 382e 3220 5573 696e 6720 6469 y..18.2 Using di │ │ │ │ │ +0003b700: 6769 7461 6c20 7369 676e 6174 7572 6573 gital signatures │ │ │ │ │ +0003b710: 2069 6e20 4752 5542 0a3d 3d3d 3d3d 3d3d in GRUB.======= │ │ │ │ │ 0003b720: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003b730: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4752 ============..GR │ │ │ │ │ -0003b740: 5542 2773 2027 636f 7265 2e69 6d67 2720 UB's 'core.img' │ │ │ │ │ -0003b750: 6361 6e20 6f70 7469 6f6e 616c 6c79 2070 can optionally p │ │ │ │ │ -0003b760: 726f 7669 6465 2065 6e66 6f72 6365 6d65 rovide enforceme │ │ │ │ │ -0003b770: 6e74 2074 6861 7420 616c 6c20 6669 6c65 nt that all file │ │ │ │ │ -0003b780: 730a 7375 6273 6571 7565 6e74 6c79 2072 s.subsequently r │ │ │ │ │ -0003b790: 6561 6420 6672 6f6d 2064 6973 6b20 6172 ead from disk ar │ │ │ │ │ -0003b7a0: 6520 636f 7665 7265 6420 6279 2061 2076 e covered by a v │ │ │ │ │ -0003b7b0: 616c 6964 2064 6967 6974 616c 2073 6967 alid digital sig │ │ │ │ │ -0003b7c0: 6e61 7475 7265 2e0a 5468 6973 2064 6f63 nature..This doc │ │ │ │ │ -0003b7d0: 756d 656e 7420 646f 6573 202a 6e6f 742a ument does *not* │ │ │ │ │ -0003b7e0: 2063 6f76 6572 2068 6f77 2074 6f20 656e cover how to en │ │ │ │ │ -0003b7f0: 7375 7265 2074 6861 7420 796f 7572 2070 sure that your p │ │ │ │ │ -0003b800: 6c61 7466 6f72 6d27 730a 6669 726d 7761 latform's.firmwa │ │ │ │ │ -0003b810: 7265 2028 652e 672e 2c20 436f 7265 626f re (e.g., Corebo │ │ │ │ │ -0003b820: 6f74 2920 7661 6c69 6461 7465 7320 2763 ot) validates 'c │ │ │ │ │ -0003b830: 6f72 652e 696d 6727 2e0a 0a20 2020 4966 ore.img'... If │ │ │ │ │ -0003b840: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -0003b850: 6961 626c 6520 2763 6865 636b 5f73 6967 iable 'check_sig │ │ │ │ │ -0003b860: 6e61 7475 7265 7327 2028 2a6e 6f74 6520 natures' (*note │ │ │ │ │ -0003b870: 6368 6563 6b5f 7369 676e 6174 7572 6573 check_signatures │ │ │ │ │ -0003b880: 3a3a 290a 6973 2073 6574 2074 6f20 2765 ::).is set to 'e │ │ │ │ │ -0003b890: 6e66 6f72 6365 272c 2074 6865 6e20 6576 nforce', then ev │ │ │ │ │ -0003b8a0: 6572 7920 6174 7465 6d70 7420 6279 2074 ery attempt by t │ │ │ │ │ -0003b8b0: 6865 2047 5255 4220 2763 6f72 652e 696d he GRUB 'core.im │ │ │ │ │ -0003b8c0: 6727 2074 6f20 6c6f 6164 0a61 6e6f 7468 g' to load.anoth │ │ │ │ │ -0003b8d0: 6572 2066 696c 6520 2766 6f6f 2720 696d er file 'foo' im │ │ │ │ │ -0003b8e0: 706c 6963 6974 6c79 2069 6e76 6f6b 6573 plicitly invokes │ │ │ │ │ -0003b8f0: 2027 7665 7269 6679 5f64 6574 6163 6865 'verify_detache │ │ │ │ │ -0003b900: 6420 666f 6f20 666f 6f2e 7369 6727 0a28 d foo foo.sig'.( │ │ │ │ │ -0003b910: 2a6e 6f74 6520 7665 7269 6679 5f64 6574 *note verify_det │ │ │ │ │ -0003b920: 6163 6865 643a 3a29 2e20 2027 666f 6f2e ached::). 'foo. │ │ │ │ │ -0003b930: 7369 6727 206d 7573 7420 636f 6e74 6169 sig' must contai │ │ │ │ │ -0003b940: 6e20 6120 7661 6c69 6420 6469 6769 7461 n a valid digita │ │ │ │ │ -0003b950: 6c0a 7369 676e 6174 7572 6520 6f76 6572 l.signature over │ │ │ │ │ -0003b960: 2074 6865 2063 6f6e 7465 6e74 7320 6f66 the contents of │ │ │ │ │ -0003b970: 2027 666f 6f27 2c20 7768 6963 6820 6361 'foo', which ca │ │ │ │ │ -0003b980: 6e20 6265 2076 6572 6966 6965 6420 7769 n be verified wi │ │ │ │ │ -0003b990: 7468 2061 0a70 7562 6c69 6320 6b65 7920 th a.public key │ │ │ │ │ -0003b9a0: 6375 7272 656e 746c 7920 7472 7573 7465 currently truste │ │ │ │ │ -0003b9b0: 6420 6279 2047 5255 4220 282a 6e6f 7465 d by GRUB (*note │ │ │ │ │ -0003b9c0: 206c 6973 745f 7472 7573 7465 643a 3a2c list_trusted::, │ │ │ │ │ -0003b9d0: 202a 6e6f 7465 0a74 7275 7374 3a3a 2c20 *note.trust::, │ │ │ │ │ -0003b9e0: 616e 6420 2a6e 6f74 6520 6469 7374 7275 and *note distru │ │ │ │ │ -0003b9f0: 7374 3a3a 292e 2020 4966 2076 616c 6964 st::). If valid │ │ │ │ │ -0003ba00: 6174 696f 6e20 6661 696c 732c 2074 6865 ation fails, the │ │ │ │ │ -0003ba10: 6e20 6669 6c65 2027 666f 6f27 0a63 616e n file 'foo'.can │ │ │ │ │ -0003ba20: 6e6f 7420 6265 206f 7065 6e65 642e 2020 not be opened. │ │ │ │ │ -0003ba30: 5468 6973 2066 6169 6c75 7265 206d 6179 This failure may │ │ │ │ │ -0003ba40: 2068 616c 7420 6f72 206f 7468 6572 7769 halt or otherwi │ │ │ │ │ -0003ba50: 7365 2069 6d70 6163 7420 7468 6520 626f se impact the bo │ │ │ │ │ -0003ba60: 6f74 0a70 726f 6365 7373 2e0a 0a20 2020 ot.process... │ │ │ │ │ -0003ba70: 416e 2069 6e69 7469 616c 2074 7275 7374 An initial trust │ │ │ │ │ -0003ba80: 6564 2070 7562 6c69 6320 6b65 7920 6361 ed public key ca │ │ │ │ │ -0003ba90: 6e20 6265 2065 6d62 6564 6465 6420 7769 n be embedded wi │ │ │ │ │ -0003baa0: 7468 696e 2074 6865 2047 5255 420a 2763 thin the GRUB.'c │ │ │ │ │ -0003bab0: 6f72 652e 696d 6727 2075 7369 6e67 2074 ore.img' using t │ │ │ │ │ -0003bac0: 6865 2027 2d2d 7075 626b 6579 2720 6f70 he '--pubkey' op │ │ │ │ │ -0003bad0: 7469 6f6e 2074 6f20 2767 7275 622d 696e tion to 'grub-in │ │ │ │ │ -0003bae0: 7374 616c 6c27 2028 2a6e 6f74 6520 496e stall' (*note In │ │ │ │ │ -0003baf0: 766f 6b69 6e67 0a67 7275 622d 696e 7374 voking.grub-inst │ │ │ │ │ -0003bb00: 616c 6c3a 3a29 2e0a 0a20 2020 4752 5542 all::)... GRUB │ │ │ │ │ -0003bb10: 2075 7365 7320 4750 472d 7374 796c 6520 uses GPG-style │ │ │ │ │ -0003bb20: 6465 7461 6368 6564 2073 6967 6e61 7475 detached signatu │ │ │ │ │ -0003bb30: 7265 7320 286d 6561 6e69 6e67 2074 6861 res (meaning tha │ │ │ │ │ -0003bb40: 7420 6120 6669 6c65 0a27 666f 6f2e 7369 t a file.'foo.si │ │ │ │ │ -0003bb50: 6727 2077 696c 6c20 6265 2070 726f 6475 g' will be produ │ │ │ │ │ -0003bb60: 6365 6420 7768 656e 2066 696c 6520 2766 ced when file 'f │ │ │ │ │ -0003bb70: 6f6f 2720 6973 2073 6967 6e65 6429 2c20 oo' is signed), │ │ │ │ │ -0003bb80: 616e 6420 6375 7272 656e 746c 790a 7375 and currently.su │ │ │ │ │ -0003bb90: 7070 6f72 7473 2074 6865 2044 5341 2061 pports the DSA a │ │ │ │ │ -0003bba0: 6e64 2052 5341 2073 6967 6e69 6e67 2061 nd RSA signing a │ │ │ │ │ -0003bbb0: 6c67 6f72 6974 686d 732e 2020 4120 7369 lgorithms. A si │ │ │ │ │ -0003bbc0: 676e 696e 6720 6b65 7920 6361 6e20 6265 gning key can be │ │ │ │ │ -0003bbd0: 0a67 656e 6572 6174 6564 2061 7320 666f .generated as fo │ │ │ │ │ -0003bbe0: 6c6c 6f77 733a 0a0a 2020 2020 2067 7067 llows:.. gpg │ │ │ │ │ -0003bbf0: 202d 2d67 656e 2d6b 6579 0a0a 2020 2041 --gen-key.. A │ │ │ │ │ -0003bc00: 6e20 696e 6469 7669 6475 616c 2066 696c n individual fil │ │ │ │ │ -0003bc10: 6520 6361 6e20 6265 2073 6967 6e65 6420 e can be signed │ │ │ │ │ -0003bc20: 6173 2066 6f6c 6c6f 7773 3a0a 0a20 2020 as follows:.. │ │ │ │ │ -0003bc30: 2020 6770 6720 2d2d 6465 7461 6368 2d73 gpg --detach-s │ │ │ │ │ -0003bc40: 6967 6e20 2f70 6174 682f 746f 2f66 696c ign /path/to/fil │ │ │ │ │ -0003bc50: 650a 0a20 2020 466f 7220 7375 6363 6573 e.. For succes │ │ │ │ │ -0003bc60: 7366 756c 2076 616c 6964 6174 696f 6e20 sful validation │ │ │ │ │ -0003bc70: 6f66 2061 6c6c 206f 6620 4752 5542 2773 of all of GRUB's │ │ │ │ │ -0003bc80: 2073 7562 636f 6d70 6f6e 656e 7473 2061 subcomponents a │ │ │ │ │ -0003bc90: 6e64 2074 6865 0a6c 6f61 6465 6420 4f53 nd the.loaded OS │ │ │ │ │ -0003bca0: 206b 6572 6e65 6c2c 2074 6865 7920 6d75 kernel, they mu │ │ │ │ │ -0003bcb0: 7374 2061 6c6c 2062 6520 7369 676e 6564 st all be signed │ │ │ │ │ -0003bcc0: 2e20 204f 6e65 2077 6179 2074 6f20 6163 . One way to ac │ │ │ │ │ -0003bcd0: 636f 6d70 6c69 7368 2074 6869 730a 6973 complish this.is │ │ │ │ │ -0003bce0: 2074 6865 2066 6f6c 6c6f 7769 6e67 2028 the following ( │ │ │ │ │ -0003bcf0: 6166 7465 7220 6861 7669 6e67 2061 6c72 after having alr │ │ │ │ │ -0003bd00: 6561 6479 2070 726f 6475 6365 6420 7468 eady produced th │ │ │ │ │ -0003bd10: 6520 6465 7369 7265 6420 2767 7275 622e e desired 'grub. │ │ │ │ │ -0003bd20: 6366 6727 0a66 696c 652c 2065 2e67 2e2c cfg'.file, e.g., │ │ │ │ │ -0003bd30: 2062 7920 7275 6e6e 696e 6720 2767 7275 by running 'gru │ │ │ │ │ -0003bd40: 622d 6d6b 636f 6e66 6967 2720 282a 6e6f b-mkconfig' (*no │ │ │ │ │ -0003bd50: 7465 2049 6e76 6f6b 696e 6720 6772 7562 te Invoking grub │ │ │ │ │ -0003bd60: 2d6d 6b63 6f6e 6669 673a 3a29 3a0a 0a20 -mkconfig::):.. │ │ │ │ │ -0003bd70: 2020 2020 2320 4564 6974 202f 6465 762f # Edit /dev/ │ │ │ │ │ -0003bd80: 7368 6d2f 7061 7373 7068 7261 7365 2e74 shm/passphrase.t │ │ │ │ │ -0003bd90: 7874 2074 6f20 636f 6e74 6169 6e20 796f xt to contain yo │ │ │ │ │ -0003bda0: 7572 2073 6967 6e69 6e67 206b 6579 2773 ur signing key's │ │ │ │ │ -0003bdb0: 2070 6173 7370 6872 6173 650a 2020 2020 passphrase. │ │ │ │ │ -0003bdc0: 2066 6f72 2069 2069 6e20 6066 696e 6420 for i in `find │ │ │ │ │ -0003bdd0: 2f62 6f6f 7420 2d6e 616d 6520 222a 2e63 /boot -name "*.c │ │ │ │ │ -0003bde0: 6667 2220 2d6f 7220 2d6e 616d 6520 222a fg" -or -name "* │ │ │ │ │ -0003bdf0: 2e6c 7374 2220 2d6f 7220 5c0a 2020 2020 .lst" -or \. │ │ │ │ │ -0003be00: 2020 202d 6e61 6d65 2022 2a2e 6d6f 6422 -name "*.mod" │ │ │ │ │ -0003be10: 202d 6f72 202d 6e61 6d65 2022 766d 6c69 -or -name "vmli │ │ │ │ │ -0003be20: 6e75 7a2a 2220 2d6f 7220 2d6e 616d 6520 nuz*" -or -name │ │ │ │ │ -0003be30: 2269 6e69 7472 642a 2220 2d6f 7220 5c0a "initrd*" -or \. │ │ │ │ │ -0003be40: 2020 2020 2020 202d 6e61 6d65 2022 6772 -name "gr │ │ │ │ │ -0003be50: 7562 656e 7622 603b 0a20 2020 2020 646f ubenv"`;. do │ │ │ │ │ -0003be60: 0a20 2020 2020 2020 6770 6720 2d2d 6261 . gpg --ba │ │ │ │ │ -0003be70: 7463 6820 2d2d 6465 7461 6368 2d73 6967 tch --detach-sig │ │ │ │ │ -0003be80: 6e20 2d2d 7061 7373 7068 7261 7365 2d66 n --passphrase-f │ │ │ │ │ -0003be90: 6420 3020 2469 203c 205c 0a20 2020 2020 d 0 $i < \. │ │ │ │ │ -0003bea0: 2020 2020 2f64 6576 2f73 686d 2f70 6173 /dev/shm/pas │ │ │ │ │ -0003beb0: 7370 6872 6173 652e 7478 740a 2020 2020 sphrase.txt. │ │ │ │ │ -0003bec0: 2064 6f6e 650a 2020 2020 2073 6872 6564 done. shred │ │ │ │ │ -0003bed0: 202f 6465 762f 7368 6d2f 7061 7373 7068 /dev/shm/passph │ │ │ │ │ -0003bee0: 7261 7365 2e74 7874 0a0a 2020 2053 6565 rase.txt.. See │ │ │ │ │ -0003bef0: 2061 6c73 6f3a 202a 6e6f 7465 2063 6865 also: *note che │ │ │ │ │ -0003bf00: 636b 5f73 6967 6e61 7475 7265 733a 3a2c ck_signatures::, │ │ │ │ │ -0003bf10: 202a 6e6f 7465 2076 6572 6966 795f 6465 *note verify_de │ │ │ │ │ -0003bf20: 7461 6368 6564 3a3a 2c20 2a6e 6f74 650a tached::, *note. │ │ │ │ │ -0003bf30: 7472 7573 743a 3a2c 202a 6e6f 7465 206c trust::, *note l │ │ │ │ │ -0003bf40: 6973 745f 7472 7573 7465 643a 3a2c 202a ist_trusted::, * │ │ │ │ │ -0003bf50: 6e6f 7465 2064 6973 7472 7573 743a 3a2c note distrust::, │ │ │ │ │ -0003bf60: 202a 6e6f 7465 206c 6f61 645f 656e 763a *note load_env: │ │ │ │ │ -0003bf70: 3a2c 202a 6e6f 7465 0a73 6176 655f 656e :, *note.save_en │ │ │ │ │ -0003bf80: 763a 3a2e 0a0a 2020 204e 6f74 6520 7468 v::... Note th │ │ │ │ │ -0003bf90: 6174 2069 6e74 6572 6e61 6c6c 7920 7369 at internally si │ │ │ │ │ -0003bfa0: 676e 6174 7572 6520 656e 666f 7263 656d gnature enforcem │ │ │ │ │ -0003bfb0: 656e 7420 6973 2063 6f6e 7472 6f6c 6c65 ent is controlle │ │ │ │ │ -0003bfc0: 6420 6279 2073 6574 7469 6e67 0a74 6865 d by setting.the │ │ │ │ │ -0003bfd0: 2065 6e76 6972 6f6e 6d65 6e74 2076 6172 environment var │ │ │ │ │ -0003bfe0: 6961 626c 6520 2763 6865 636b 5f73 6967 iable 'check_sig │ │ │ │ │ -0003bff0: 6e61 7475 7265 7327 2065 7175 616c 2074 natures' equal t │ │ │ │ │ -0003c000: 6f20 2765 6e66 6f72 6365 272e 2020 5061 o 'enforce'. Pa │ │ │ │ │ -0003c010: 7373 696e 670a 6f6e 6520 6f72 206d 6f72 ssing.one or mor │ │ │ │ │ -0003c020: 6520 272d 2d70 7562 6b65 7927 206f 7074 e '--pubkey' opt │ │ │ │ │ -0003c030: 696f 6e73 2074 6f20 2767 7275 622d 6d6b ions to 'grub-mk │ │ │ │ │ -0003c040: 696d 6167 6527 2069 6d70 6c69 6369 746c image' implicitl │ │ │ │ │ -0003c050: 7920 6465 6669 6e65 730a 2763 6865 636b y defines.'check │ │ │ │ │ -0003c060: 5f73 6967 6e61 7475 7265 7327 2065 7175 _signatures' equ │ │ │ │ │ -0003c070: 616c 2074 6f20 2765 6e66 6f72 6365 2720 al to 'enforce' │ │ │ │ │ -0003c080: 696e 2027 636f 7265 2e69 6d67 2720 7072 in 'core.img' pr │ │ │ │ │ -0003c090: 696f 7220 746f 2070 726f 6365 7373 696e ior to processin │ │ │ │ │ -0003c0a0: 670a 616e 7920 636f 6e66 6967 7572 6174 g.any configurat │ │ │ │ │ -0003c0b0: 696f 6e20 6669 6c65 732e 0a0a 2020 204e ion files... N │ │ │ │ │ -0003c0c0: 6f74 6520 7468 6174 2073 6967 6e61 7475 ote that signatu │ │ │ │ │ -0003c0d0: 7265 2063 6865 636b 696e 6720 646f 6573 re checking does │ │ │ │ │ -0003c0e0: 202a 6e6f 742a 2070 7265 7665 6e74 2061 *not* prevent a │ │ │ │ │ -0003c0f0: 6e20 6174 7461 636b 6572 2077 6974 680a n attacker with. │ │ │ │ │ -0003c100: 2873 6572 6961 6c2c 2070 6879 7369 6361 (serial, physica │ │ │ │ │ -0003c110: 6c2c 202e 2e2e 2920 2063 6f6e 736f 6c65 l, ...) console │ │ │ │ │ -0003c120: 2061 6363 6573 7320 6672 6f6d 2064 726f access from dro │ │ │ │ │ -0003c130: 7070 696e 6720 6d61 6e75 616c 6c79 2074 pping manually t │ │ │ │ │ -0003c140: 6f20 7468 650a 4752 5542 2063 6f6e 736f o the.GRUB conso │ │ │ │ │ -0003c150: 6c65 2061 6e64 2065 7865 6375 7469 6e67 le and executing │ │ │ │ │ -0003c160: 3a0a 0a20 2020 2020 7365 7420 6368 6563 :.. set chec │ │ │ │ │ -0003c170: 6b5f 7369 676e 6174 7572 6573 3d6e 6f0a k_signatures=no. │ │ │ │ │ -0003c180: 0a20 2020 546f 2070 7265 7665 6e74 2074 . To prevent t │ │ │ │ │ -0003c190: 6869 732c 2070 6173 7377 6f72 642d 7072 his, password-pr │ │ │ │ │ -0003c1a0: 6f74 6563 7469 6f6e 2028 2a6e 6f74 6520 otection (*note │ │ │ │ │ -0003c1b0: 4175 7468 656e 7469 6361 7469 6f6e 2061 Authentication a │ │ │ │ │ -0003c1c0: 6e64 0a61 7574 686f 7269 7361 7469 6f6e nd.authorisation │ │ │ │ │ -0003c1d0: 3a3a 2920 6973 2065 7373 656e 7469 616c ::) is essential │ │ │ │ │ -0003c1e0: 2e20 204e 6f74 6520 7468 6174 2065 7665 . Note that eve │ │ │ │ │ -0003c1f0: 6e20 7769 7468 2047 5255 4220 7061 7373 n with GRUB pass │ │ │ │ │ -0003c200: 776f 7264 0a70 726f 7465 6374 696f 6e2c word.protection, │ │ │ │ │ -0003c210: 2047 5255 4220 6974 7365 6c66 2063 616e GRUB itself can │ │ │ │ │ -0003c220: 6e6f 7420 7072 6576 656e 7420 736f 6d65 not prevent some │ │ │ │ │ -0003c230: 6f6e 6520 7769 7468 2070 6879 7369 6361 one with physica │ │ │ │ │ -0003c240: 6c20 6163 6365 7373 2074 6f0a 7468 6520 l access to.the │ │ │ │ │ -0003c250: 6d61 6368 696e 6520 6672 6f6d 2061 6c74 machine from alt │ │ │ │ │ -0003c260: 6572 696e 6720 7468 6174 206d 6163 6869 ering that machi │ │ │ │ │ -0003c270: 6e65 2773 2066 6972 6d77 6172 6520 2865 ne's firmware (e │ │ │ │ │ -0003c280: 2e67 2e2c 2043 6f72 6562 6f6f 7420 6f72 .g., Coreboot or │ │ │ │ │ -0003c290: 0a42 494f 5329 2063 6f6e 6669 6775 7261 .BIOS) configura │ │ │ │ │ -0003c2a0: 7469 6f6e 2074 6f20 6361 7573 6520 7468 tion to cause th │ │ │ │ │ -0003c2b0: 6520 6d61 6368 696e 6520 746f 2062 6f6f e machine to boo │ │ │ │ │ -0003c2c0: 7420 6672 6f6d 2061 2064 6966 6665 7265 t from a differe │ │ │ │ │ -0003c2d0: 6e74 0a28 6174 7461 636b 6572 2d63 6f6e nt.(attacker-con │ │ │ │ │ -0003c2e0: 7472 6f6c 6c65 6429 2064 6576 6963 652e trolled) device. │ │ │ │ │ -0003c2f0: 2020 4752 5542 2069 7320 6174 2062 6573 GRUB is at bes │ │ │ │ │ -0003c300: 7420 6f6e 6c79 206f 6e65 206c 696e 6b20 t only one link │ │ │ │ │ -0003c310: 696e 2061 2073 6563 7572 650a 626f 6f74 in a secure.boot │ │ │ │ │ -0003c320: 2063 6861 696e 2e0a 0a1f 0a46 696c 653a chain.....File: │ │ │ │ │ -0003c330: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -0003c340: 653a 2055 4546 4920 7365 6375 7265 2062 e: UEFI secure b │ │ │ │ │ -0003c350: 6f6f 7420 616e 6420 7368 696d 2c20 204e oot and shim, N │ │ │ │ │ -0003c360: 6578 743a 2053 6563 7572 6520 426f 6f74 ext: Secure Boot │ │ │ │ │ -0003c370: 2041 6476 616e 6365 6420 5461 7267 6574 Advanced Target │ │ │ │ │ -0003c380: 696e 672c 2020 5072 6576 3a20 5573 696e ing, Prev: Usin │ │ │ │ │ -0003c390: 6720 6469 6769 7461 6c20 7369 676e 6174 g digital signat │ │ │ │ │ -0003c3a0: 7572 6573 2c20 2055 703a 2053 6563 7572 ures, Up: Secur │ │ │ │ │ -0003c3b0: 6974 790a 0a31 382e 3320 5545 4649 2073 ity..18.3 UEFI s │ │ │ │ │ -0003c3c0: 6563 7572 6520 626f 6f74 2061 6e64 2073 ecure boot and s │ │ │ │ │ -0003c3d0: 6869 6d20 7375 7070 6f72 740a 3d3d 3d3d him support.==== │ │ │ │ │ +0003b730: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a ==============.. │ │ │ │ │ +0003b740: 4752 5542 2773 2027 636f 7265 2e69 6d67 GRUB's 'core.img │ │ │ │ │ +0003b750: 2720 6361 6e20 6f70 7469 6f6e 616c 6c79 ' can optionally │ │ │ │ │ +0003b760: 2070 726f 7669 6465 2065 6e66 6f72 6365 provide enforce │ │ │ │ │ +0003b770: 6d65 6e74 2074 6861 7420 616c 6c20 6669 ment that all fi │ │ │ │ │ +0003b780: 6c65 730a 7375 6273 6571 7565 6e74 6c79 les.subsequently │ │ │ │ │ +0003b790: 2072 6561 6420 6672 6f6d 2064 6973 6b20 read from disk │ │ │ │ │ +0003b7a0: 6172 6520 636f 7665 7265 6420 6279 2061 are covered by a │ │ │ │ │ +0003b7b0: 2076 616c 6964 2064 6967 6974 616c 2073 valid digital s │ │ │ │ │ +0003b7c0: 6967 6e61 7475 7265 2e0a 5468 6973 2064 ignature..This d │ │ │ │ │ +0003b7d0: 6f63 756d 656e 7420 646f 6573 202a 6e6f ocument does *no │ │ │ │ │ +0003b7e0: 742a 2063 6f76 6572 2068 6f77 2074 6f20 t* cover how to │ │ │ │ │ +0003b7f0: 656e 7375 7265 2074 6861 7420 796f 7572 ensure that your │ │ │ │ │ +0003b800: 2070 6c61 7466 6f72 6d27 730a 6669 726d platform's.firm │ │ │ │ │ +0003b810: 7761 7265 2028 652e 672e 2c20 436f 7265 ware (e.g., Core │ │ │ │ │ +0003b820: 626f 6f74 2920 7661 6c69 6461 7465 7320 boot) validates │ │ │ │ │ +0003b830: 2763 6f72 652e 696d 6727 2e0a 0a20 2020 'core.img'... │ │ │ │ │ +0003b840: 4966 2065 6e76 6972 6f6e 6d65 6e74 2076 If environment v │ │ │ │ │ +0003b850: 6172 6961 626c 6520 2763 6865 636b 5f73 ariable 'check_s │ │ │ │ │ +0003b860: 6967 6e61 7475 7265 7327 2028 2a6e 6f74 ignatures' (*not │ │ │ │ │ +0003b870: 6520 6368 6563 6b5f 7369 676e 6174 7572 e check_signatur │ │ │ │ │ +0003b880: 6573 3a3a 290a 6973 2073 6574 2074 6f20 es::).is set to │ │ │ │ │ +0003b890: 2765 6e66 6f72 6365 272c 2074 6865 6e20 'enforce', then │ │ │ │ │ +0003b8a0: 6576 6572 7920 6174 7465 6d70 7420 6279 every attempt by │ │ │ │ │ +0003b8b0: 2074 6865 2047 5255 4220 2763 6f72 652e the GRUB 'core. │ │ │ │ │ +0003b8c0: 696d 6727 2074 6f20 6c6f 6164 0a61 6e6f img' to load.ano │ │ │ │ │ +0003b8d0: 7468 6572 2066 696c 6520 2766 6f6f 2720 ther file 'foo' │ │ │ │ │ +0003b8e0: 696d 706c 6963 6974 6c79 2069 6e76 6f6b implicitly invok │ │ │ │ │ +0003b8f0: 6573 2027 7665 7269 6679 5f64 6574 6163 es 'verify_detac │ │ │ │ │ +0003b900: 6865 6420 666f 6f20 666f 6f2e 7369 6727 hed foo foo.sig' │ │ │ │ │ +0003b910: 0a28 2a6e 6f74 6520 7665 7269 6679 5f64 .(*note verify_d │ │ │ │ │ +0003b920: 6574 6163 6865 643a 3a29 2e20 2027 666f etached::). 'fo │ │ │ │ │ +0003b930: 6f2e 7369 6727 206d 7573 7420 636f 6e74 o.sig' must cont │ │ │ │ │ +0003b940: 6169 6e20 6120 7661 6c69 6420 6469 6769 ain a valid digi │ │ │ │ │ +0003b950: 7461 6c0a 7369 676e 6174 7572 6520 6f76 tal.signature ov │ │ │ │ │ +0003b960: 6572 2074 6865 2063 6f6e 7465 6e74 7320 er the contents │ │ │ │ │ +0003b970: 6f66 2027 666f 6f27 2c20 7768 6963 6820 of 'foo', which │ │ │ │ │ +0003b980: 6361 6e20 6265 2076 6572 6966 6965 6420 can be verified │ │ │ │ │ +0003b990: 7769 7468 2061 0a70 7562 6c69 6320 6b65 with a.public ke │ │ │ │ │ +0003b9a0: 7920 6375 7272 656e 746c 7920 7472 7573 y currently trus │ │ │ │ │ +0003b9b0: 7465 6420 6279 2047 5255 4220 282a 6e6f ted by GRUB (*no │ │ │ │ │ +0003b9c0: 7465 206c 6973 745f 7472 7573 7465 643a te list_trusted: │ │ │ │ │ +0003b9d0: 3a2c 202a 6e6f 7465 0a74 7275 7374 3a3a :, *note.trust:: │ │ │ │ │ +0003b9e0: 2c20 616e 6420 2a6e 6f74 6520 6469 7374 , and *note dist │ │ │ │ │ +0003b9f0: 7275 7374 3a3a 292e 2020 4966 2076 616c rust::). If val │ │ │ │ │ +0003ba00: 6964 6174 696f 6e20 6661 696c 732c 2074 idation fails, t │ │ │ │ │ +0003ba10: 6865 6e20 6669 6c65 2027 666f 6f27 0a63 hen file 'foo'.c │ │ │ │ │ +0003ba20: 616e 6e6f 7420 6265 206f 7065 6e65 642e annot be opened. │ │ │ │ │ +0003ba30: 2020 5468 6973 2066 6169 6c75 7265 206d This failure m │ │ │ │ │ +0003ba40: 6179 2068 616c 7420 6f72 206f 7468 6572 ay halt or other │ │ │ │ │ +0003ba50: 7769 7365 2069 6d70 6163 7420 7468 6520 wise impact the │ │ │ │ │ +0003ba60: 626f 6f74 0a70 726f 6365 7373 2e0a 0a20 boot.process... │ │ │ │ │ +0003ba70: 2020 416e 2069 6e69 7469 616c 2074 7275 An initial tru │ │ │ │ │ +0003ba80: 7374 6564 2070 7562 6c69 6320 6b65 7920 sted public key │ │ │ │ │ +0003ba90: 6361 6e20 6265 2065 6d62 6564 6465 6420 can be embedded │ │ │ │ │ +0003baa0: 7769 7468 696e 2074 6865 2047 5255 420a within the GRUB. │ │ │ │ │ +0003bab0: 2763 6f72 652e 696d 6727 2075 7369 6e67 'core.img' using │ │ │ │ │ +0003bac0: 2074 6865 2027 2d2d 7075 626b 6579 2720 the '--pubkey' │ │ │ │ │ +0003bad0: 6f70 7469 6f6e 2074 6f20 2767 7275 622d option to 'grub- │ │ │ │ │ +0003bae0: 696e 7374 616c 6c27 2028 2a6e 6f74 6520 install' (*note │ │ │ │ │ +0003baf0: 496e 766f 6b69 6e67 0a67 7275 622d 696e Invoking.grub-in │ │ │ │ │ +0003bb00: 7374 616c 6c3a 3a29 2e0a 0a20 2020 4752 stall::)... GR │ │ │ │ │ +0003bb10: 5542 2075 7365 7320 4750 472d 7374 796c UB uses GPG-styl │ │ │ │ │ +0003bb20: 6520 6465 7461 6368 6564 2073 6967 6e61 e detached signa │ │ │ │ │ +0003bb30: 7475 7265 7320 286d 6561 6e69 6e67 2074 tures (meaning t │ │ │ │ │ +0003bb40: 6861 7420 6120 6669 6c65 0a27 666f 6f2e hat a file.'foo. │ │ │ │ │ +0003bb50: 7369 6727 2077 696c 6c20 6265 2070 726f sig' will be pro │ │ │ │ │ +0003bb60: 6475 6365 6420 7768 656e 2066 696c 6520 duced when file │ │ │ │ │ +0003bb70: 2766 6f6f 2720 6973 2073 6967 6e65 6429 'foo' is signed) │ │ │ │ │ +0003bb80: 2c20 616e 6420 6375 7272 656e 746c 790a , and currently. │ │ │ │ │ +0003bb90: 7375 7070 6f72 7473 2074 6865 2044 5341 supports the DSA │ │ │ │ │ +0003bba0: 2061 6e64 2052 5341 2073 6967 6e69 6e67 and RSA signing │ │ │ │ │ +0003bbb0: 2061 6c67 6f72 6974 686d 732e 2020 4120 algorithms. A │ │ │ │ │ +0003bbc0: 7369 676e 696e 6720 6b65 7920 6361 6e20 signing key can │ │ │ │ │ +0003bbd0: 6265 0a67 656e 6572 6174 6564 2061 7320 be.generated as │ │ │ │ │ +0003bbe0: 666f 6c6c 6f77 733a 0a0a 2020 2020 2067 follows:.. g │ │ │ │ │ +0003bbf0: 7067 202d 2d67 656e 2d6b 6579 0a0a 2020 pg --gen-key.. │ │ │ │ │ +0003bc00: 2041 6e20 696e 6469 7669 6475 616c 2066 An individual f │ │ │ │ │ +0003bc10: 696c 6520 6361 6e20 6265 2073 6967 6e65 ile can be signe │ │ │ │ │ +0003bc20: 6420 6173 2066 6f6c 6c6f 7773 3a0a 0a20 d as follows:.. │ │ │ │ │ +0003bc30: 2020 2020 6770 6720 2d2d 6465 7461 6368 gpg --detach │ │ │ │ │ +0003bc40: 2d73 6967 6e20 2f70 6174 682f 746f 2f66 -sign /path/to/f │ │ │ │ │ +0003bc50: 696c 650a 0a20 2020 466f 7220 7375 6363 ile.. For succ │ │ │ │ │ +0003bc60: 6573 7366 756c 2076 616c 6964 6174 696f essful validatio │ │ │ │ │ +0003bc70: 6e20 6f66 2061 6c6c 206f 6620 4752 5542 n of all of GRUB │ │ │ │ │ +0003bc80: 2773 2073 7562 636f 6d70 6f6e 656e 7473 's subcomponents │ │ │ │ │ +0003bc90: 2061 6e64 2074 6865 0a6c 6f61 6465 6420 and the.loaded │ │ │ │ │ +0003bca0: 4f53 206b 6572 6e65 6c2c 2074 6865 7920 OS kernel, they │ │ │ │ │ +0003bcb0: 6d75 7374 2061 6c6c 2062 6520 7369 676e must all be sign │ │ │ │ │ +0003bcc0: 6564 2e20 204f 6e65 2077 6179 2074 6f20 ed. One way to │ │ │ │ │ +0003bcd0: 6163 636f 6d70 6c69 7368 2074 6869 730a accomplish this. │ │ │ │ │ +0003bce0: 6973 2074 6865 2066 6f6c 6c6f 7769 6e67 is the following │ │ │ │ │ +0003bcf0: 2028 6166 7465 7220 6861 7669 6e67 2061 (after having a │ │ │ │ │ +0003bd00: 6c72 6561 6479 2070 726f 6475 6365 6420 lready produced │ │ │ │ │ +0003bd10: 7468 6520 6465 7369 7265 6420 2767 7275 the desired 'gru │ │ │ │ │ +0003bd20: 622e 6366 6727 0a66 696c 652c 2065 2e67 b.cfg'.file, e.g │ │ │ │ │ +0003bd30: 2e2c 2062 7920 7275 6e6e 696e 6720 2767 ., by running 'g │ │ │ │ │ +0003bd40: 7275 622d 6d6b 636f 6e66 6967 2720 282a rub-mkconfig' (* │ │ │ │ │ +0003bd50: 6e6f 7465 2049 6e76 6f6b 696e 6720 6772 note Invoking gr │ │ │ │ │ +0003bd60: 7562 2d6d 6b63 6f6e 6669 673a 3a29 3a0a ub-mkconfig::):. │ │ │ │ │ +0003bd70: 0a20 2020 2020 2320 4564 6974 202f 6465 . # Edit /de │ │ │ │ │ +0003bd80: 762f 7368 6d2f 7061 7373 7068 7261 7365 v/shm/passphrase │ │ │ │ │ +0003bd90: 2e74 7874 2074 6f20 636f 6e74 6169 6e20 .txt to contain │ │ │ │ │ +0003bda0: 796f 7572 2073 6967 6e69 6e67 206b 6579 your signing key │ │ │ │ │ +0003bdb0: 2773 2070 6173 7370 6872 6173 650a 2020 's passphrase. │ │ │ │ │ +0003bdc0: 2020 2066 6f72 2069 2069 6e20 6066 696e for i in `fin │ │ │ │ │ +0003bdd0: 6420 2f62 6f6f 7420 2d6e 616d 6520 222a d /boot -name "* │ │ │ │ │ +0003bde0: 2e63 6667 2220 2d6f 7220 2d6e 616d 6520 .cfg" -or -name │ │ │ │ │ +0003bdf0: 222a 2e6c 7374 2220 2d6f 7220 5c0a 2020 "*.lst" -or \. │ │ │ │ │ +0003be00: 2020 2020 202d 6e61 6d65 2022 2a2e 6d6f -name "*.mo │ │ │ │ │ +0003be10: 6422 202d 6f72 202d 6e61 6d65 2022 766d d" -or -name "vm │ │ │ │ │ +0003be20: 6c69 6e75 7a2a 2220 2d6f 7220 2d6e 616d linuz*" -or -nam │ │ │ │ │ +0003be30: 6520 2269 6e69 7472 642a 2220 2d6f 7220 e "initrd*" -or │ │ │ │ │ +0003be40: 5c0a 2020 2020 2020 202d 6e61 6d65 2022 \. -name " │ │ │ │ │ +0003be50: 6772 7562 656e 7622 603b 0a20 2020 2020 grubenv"`;. │ │ │ │ │ +0003be60: 646f 0a20 2020 2020 2020 6770 6720 2d2d do. gpg -- │ │ │ │ │ +0003be70: 6261 7463 6820 2d2d 6465 7461 6368 2d73 batch --detach-s │ │ │ │ │ +0003be80: 6967 6e20 2d2d 7061 7373 7068 7261 7365 ign --passphrase │ │ │ │ │ +0003be90: 2d66 6420 3020 2469 203c 205c 0a20 2020 -fd 0 $i < \. │ │ │ │ │ +0003bea0: 2020 2020 2020 2f64 6576 2f73 686d 2f70 /dev/shm/p │ │ │ │ │ +0003beb0: 6173 7370 6872 6173 652e 7478 740a 2020 assphrase.txt. │ │ │ │ │ +0003bec0: 2020 2064 6f6e 650a 2020 2020 2073 6872 done. shr │ │ │ │ │ +0003bed0: 6564 202f 6465 762f 7368 6d2f 7061 7373 ed /dev/shm/pass │ │ │ │ │ +0003bee0: 7068 7261 7365 2e74 7874 0a0a 2020 2053 phrase.txt.. S │ │ │ │ │ +0003bef0: 6565 2061 6c73 6f3a 202a 6e6f 7465 2063 ee also: *note c │ │ │ │ │ +0003bf00: 6865 636b 5f73 6967 6e61 7475 7265 733a heck_signatures: │ │ │ │ │ +0003bf10: 3a2c 202a 6e6f 7465 2076 6572 6966 795f :, *note verify_ │ │ │ │ │ +0003bf20: 6465 7461 6368 6564 3a3a 2c20 2a6e 6f74 detached::, *not │ │ │ │ │ +0003bf30: 650a 7472 7573 743a 3a2c 202a 6e6f 7465 e.trust::, *note │ │ │ │ │ +0003bf40: 206c 6973 745f 7472 7573 7465 643a 3a2c list_trusted::, │ │ │ │ │ +0003bf50: 202a 6e6f 7465 2064 6973 7472 7573 743a *note distrust: │ │ │ │ │ +0003bf60: 3a2c 202a 6e6f 7465 206c 6f61 645f 656e :, *note load_en │ │ │ │ │ +0003bf70: 763a 3a2c 202a 6e6f 7465 0a73 6176 655f v::, *note.save_ │ │ │ │ │ +0003bf80: 656e 763a 3a2e 0a0a 2020 204e 6f74 6520 env::... Note │ │ │ │ │ +0003bf90: 7468 6174 2069 6e74 6572 6e61 6c6c 7920 that internally │ │ │ │ │ +0003bfa0: 7369 676e 6174 7572 6520 656e 666f 7263 signature enforc │ │ │ │ │ +0003bfb0: 656d 656e 7420 6973 2063 6f6e 7472 6f6c ement is control │ │ │ │ │ +0003bfc0: 6c65 6420 6279 2073 6574 7469 6e67 0a74 led by setting.t │ │ │ │ │ +0003bfd0: 6865 2065 6e76 6972 6f6e 6d65 6e74 2076 he environment v │ │ │ │ │ +0003bfe0: 6172 6961 626c 6520 2763 6865 636b 5f73 ariable 'check_s │ │ │ │ │ +0003bff0: 6967 6e61 7475 7265 7327 2065 7175 616c ignatures' equal │ │ │ │ │ +0003c000: 2074 6f20 2765 6e66 6f72 6365 272e 2020 to 'enforce'. │ │ │ │ │ +0003c010: 5061 7373 696e 670a 6f6e 6520 6f72 206d Passing.one or m │ │ │ │ │ +0003c020: 6f72 6520 272d 2d70 7562 6b65 7927 206f ore '--pubkey' o │ │ │ │ │ +0003c030: 7074 696f 6e73 2074 6f20 2767 7275 622d ptions to 'grub- │ │ │ │ │ +0003c040: 6d6b 696d 6167 6527 2069 6d70 6c69 6369 mkimage' implici │ │ │ │ │ +0003c050: 746c 7920 6465 6669 6e65 730a 2763 6865 tly defines.'che │ │ │ │ │ +0003c060: 636b 5f73 6967 6e61 7475 7265 7327 2065 ck_signatures' e │ │ │ │ │ +0003c070: 7175 616c 2074 6f20 2765 6e66 6f72 6365 qual to 'enforce │ │ │ │ │ +0003c080: 2720 696e 2027 636f 7265 2e69 6d67 2720 ' in 'core.img' │ │ │ │ │ +0003c090: 7072 696f 7220 746f 2070 726f 6365 7373 prior to process │ │ │ │ │ +0003c0a0: 696e 670a 616e 7920 636f 6e66 6967 7572 ing.any configur │ │ │ │ │ +0003c0b0: 6174 696f 6e20 6669 6c65 732e 0a0a 2020 ation files... │ │ │ │ │ +0003c0c0: 204e 6f74 6520 7468 6174 2073 6967 6e61 Note that signa │ │ │ │ │ +0003c0d0: 7475 7265 2063 6865 636b 696e 6720 646f ture checking do │ │ │ │ │ +0003c0e0: 6573 202a 6e6f 742a 2070 7265 7665 6e74 es *not* prevent │ │ │ │ │ +0003c0f0: 2061 6e20 6174 7461 636b 6572 2077 6974 an attacker wit │ │ │ │ │ +0003c100: 680a 2873 6572 6961 6c2c 2070 6879 7369 h.(serial, physi │ │ │ │ │ +0003c110: 6361 6c2c 202e 2e2e 2920 2063 6f6e 736f cal, ...) conso │ │ │ │ │ +0003c120: 6c65 2061 6363 6573 7320 6672 6f6d 2064 le access from d │ │ │ │ │ +0003c130: 726f 7070 696e 6720 6d61 6e75 616c 6c79 ropping manually │ │ │ │ │ +0003c140: 2074 6f20 7468 650a 4752 5542 2063 6f6e to the.GRUB con │ │ │ │ │ +0003c150: 736f 6c65 2061 6e64 2065 7865 6375 7469 sole and executi │ │ │ │ │ +0003c160: 6e67 3a0a 0a20 2020 2020 7365 7420 6368 ng:.. set ch │ │ │ │ │ +0003c170: 6563 6b5f 7369 676e 6174 7572 6573 3d6e eck_signatures=n │ │ │ │ │ +0003c180: 6f0a 0a20 2020 546f 2070 7265 7665 6e74 o.. To prevent │ │ │ │ │ +0003c190: 2074 6869 732c 2070 6173 7377 6f72 642d this, password- │ │ │ │ │ +0003c1a0: 7072 6f74 6563 7469 6f6e 2028 2a6e 6f74 protection (*not │ │ │ │ │ +0003c1b0: 6520 4175 7468 656e 7469 6361 7469 6f6e e Authentication │ │ │ │ │ +0003c1c0: 2061 6e64 0a61 7574 686f 7269 7361 7469 and.authorisati │ │ │ │ │ +0003c1d0: 6f6e 3a3a 2920 6973 2065 7373 656e 7469 on::) is essenti │ │ │ │ │ +0003c1e0: 616c 2e20 204e 6f74 6520 7468 6174 2065 al. Note that e │ │ │ │ │ +0003c1f0: 7665 6e20 7769 7468 2047 5255 4220 7061 ven with GRUB pa │ │ │ │ │ +0003c200: 7373 776f 7264 0a70 726f 7465 6374 696f ssword.protectio │ │ │ │ │ +0003c210: 6e2c 2047 5255 4220 6974 7365 6c66 2063 n, GRUB itself c │ │ │ │ │ +0003c220: 616e 6e6f 7420 7072 6576 656e 7420 736f annot prevent so │ │ │ │ │ +0003c230: 6d65 6f6e 6520 7769 7468 2070 6879 7369 meone with physi │ │ │ │ │ +0003c240: 6361 6c20 6163 6365 7373 2074 6f0a 7468 cal access to.th │ │ │ │ │ +0003c250: 6520 6d61 6368 696e 6520 6672 6f6d 2061 e machine from a │ │ │ │ │ +0003c260: 6c74 6572 696e 6720 7468 6174 206d 6163 ltering that mac │ │ │ │ │ +0003c270: 6869 6e65 2773 2066 6972 6d77 6172 6520 hine's firmware │ │ │ │ │ +0003c280: 2865 2e67 2e2c 2043 6f72 6562 6f6f 7420 (e.g., Coreboot │ │ │ │ │ +0003c290: 6f72 0a42 494f 5329 2063 6f6e 6669 6775 or.BIOS) configu │ │ │ │ │ +0003c2a0: 7261 7469 6f6e 2074 6f20 6361 7573 6520 ration to cause │ │ │ │ │ +0003c2b0: 7468 6520 6d61 6368 696e 6520 746f 2062 the machine to b │ │ │ │ │ +0003c2c0: 6f6f 7420 6672 6f6d 2061 2064 6966 6665 oot from a diffe │ │ │ │ │ +0003c2d0: 7265 6e74 0a28 6174 7461 636b 6572 2d63 rent.(attacker-c │ │ │ │ │ +0003c2e0: 6f6e 7472 6f6c 6c65 6429 2064 6576 6963 ontrolled) devic │ │ │ │ │ +0003c2f0: 652e 2020 4752 5542 2069 7320 6174 2062 e. GRUB is at b │ │ │ │ │ +0003c300: 6573 7420 6f6e 6c79 206f 6e65 206c 696e est only one lin │ │ │ │ │ +0003c310: 6b20 696e 2061 2073 6563 7572 650a 626f k in a secure.bo │ │ │ │ │ +0003c320: 6f74 2063 6861 696e 2e0a 0a1f 0a46 696c ot chain.....Fil │ │ │ │ │ +0003c330: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +0003c340: 6f64 653a 2055 4546 4920 7365 6375 7265 ode: UEFI secure │ │ │ │ │ +0003c350: 2062 6f6f 7420 616e 6420 7368 696d 2c20 boot and shim, │ │ │ │ │ +0003c360: 204e 6578 743a 2053 6563 7572 6520 426f Next: Secure Bo │ │ │ │ │ +0003c370: 6f74 2041 6476 616e 6365 6420 5461 7267 ot Advanced Targ │ │ │ │ │ +0003c380: 6574 696e 672c 2020 5072 6576 3a20 5573 eting, Prev: Us │ │ │ │ │ +0003c390: 696e 6720 6469 6769 7461 6c20 7369 676e ing digital sign │ │ │ │ │ +0003c3a0: 6174 7572 6573 2c20 2055 703a 2053 6563 atures, Up: Sec │ │ │ │ │ +0003c3b0: 7572 6974 790a 0a31 382e 3320 5545 4649 urity..18.3 UEFI │ │ │ │ │ +0003c3c0: 2073 6563 7572 6520 626f 6f74 2061 6e64 secure boot and │ │ │ │ │ +0003c3d0: 2073 6869 6d20 7375 7070 6f72 740a 3d3d shim support.== │ │ │ │ │ 0003c3e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003c3f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003c400: 3d3d 0a0a 5468 6520 4752 5542 2c20 6578 ==..The GRUB, ex │ │ │ │ │ -0003c410: 6365 7074 2074 6865 2027 6368 6169 6e6c cept the 'chainl │ │ │ │ │ -0003c420: 6f61 6465 7227 2063 6f6d 6d61 6e64 2c20 oader' command, │ │ │ │ │ -0003c430: 776f 726b 7320 7769 7468 2074 6865 2055 works with the U │ │ │ │ │ -0003c440: 4546 4920 7365 6375 7265 0a62 6f6f 7420 EFI secure.boot │ │ │ │ │ -0003c450: 616e 6420 7468 6520 7368 696d 2e20 2054 and the shim. T │ │ │ │ │ -0003c460: 6869 7320 6675 6e63 7469 6f6e 616c 6974 his functionalit │ │ │ │ │ -0003c470: 7920 6973 2070 726f 7669 6465 6420 6279 y is provided by │ │ │ │ │ -0003c480: 2074 6865 2073 6869 6d5f 6c6f 636b 0a76 the shim_lock.v │ │ │ │ │ -0003c490: 6572 6966 6965 722e 2020 4974 2069 7320 erifier. It is │ │ │ │ │ -0003c4a0: 6275 696c 7420 696e 746f 2074 6865 2027 built into the ' │ │ │ │ │ -0003c4b0: 636f 7265 2e69 6d67 2720 616e 6420 6973 core.img' and is │ │ │ │ │ -0003c4c0: 2072 6567 6973 7465 7265 6420 6966 2074 registered if t │ │ │ │ │ -0003c4d0: 6865 2055 4546 490a 7365 6375 7265 2062 he UEFI.secure b │ │ │ │ │ -0003c4e0: 6f6f 7420 6973 2065 6e61 626c 6564 2e20 oot is enabled. │ │ │ │ │ -0003c4f0: 2054 6865 2027 7368 696d 5f6c 6f63 6b27 The 'shim_lock' │ │ │ │ │ -0003c500: 2076 6172 6961 626c 6520 6973 2073 6574 variable is set │ │ │ │ │ -0003c510: 2074 6f20 2779 2720 7768 656e 0a73 6869 to 'y' when.shi │ │ │ │ │ -0003c520: 6d5f 6c6f 636b 2076 6572 6966 6965 7220 m_lock verifier │ │ │ │ │ -0003c530: 6973 2072 6567 6973 7465 7265 642e 2020 is registered. │ │ │ │ │ -0003c540: 4966 2069 7420 6973 2064 6573 6972 6564 If it is desired │ │ │ │ │ -0003c550: 2074 6f20 7573 6520 5545 4649 2073 6563 to use UEFI sec │ │ │ │ │ -0003c560: 7572 650a 626f 6f74 2077 6974 686f 7574 ure.boot without │ │ │ │ │ -0003c570: 2073 6869 6d2c 206f 6e65 2063 616e 2064 shim, one can d │ │ │ │ │ -0003c580: 6973 6162 6c65 2073 6869 6d5f 6c6f 636b isable shim_lock │ │ │ │ │ -0003c590: 2062 7920 6469 7361 626c 696e 6720 7368 by disabling sh │ │ │ │ │ -0003c5a0: 696d 0a76 6572 6966 6963 6174 696f 6e20 im.verification │ │ │ │ │ -0003c5b0: 7769 7468 204d 6f6b 5362 5374 6174 6520 with MokSbState │ │ │ │ │ -0003c5c0: 5545 4649 2076 6172 6961 626c 6520 6f72 UEFI variable or │ │ │ │ │ -0003c5d0: 2062 7920 6275 696c 6469 6e67 2067 7275 by building gru │ │ │ │ │ -0003c5e0: 6220 696d 6167 650a 7769 7468 2027 2d2d b image.with '-- │ │ │ │ │ -0003c5f0: 6469 7361 626c 652d 7368 696d 2d6c 6f63 disable-shim-loc │ │ │ │ │ -0003c600: 6b27 206f 7074 696f 6e2e 0a0a 2020 2041 k' option... A │ │ │ │ │ -0003c610: 6c6c 2047 5255 4220 6d6f 6475 6c65 7320 ll GRUB modules │ │ │ │ │ -0003c620: 6e6f 7420 7374 6f72 6564 2069 6e20 7468 not stored in th │ │ │ │ │ -0003c630: 6520 2763 6f72 652e 696d 6727 2c20 4f53 e 'core.img', OS │ │ │ │ │ -0003c640: 206b 6572 6e65 6c73 2c20 4143 5049 0a74 kernels, ACPI.t │ │ │ │ │ -0003c650: 6162 6c65 732c 2044 6576 6963 6520 5472 ables, Device Tr │ │ │ │ │ -0003c660: 6565 732c 2065 7463 2e20 2068 6176 6520 ees, etc. have │ │ │ │ │ -0003c670: 746f 2062 6520 7369 676e 6564 2c20 652e to be signed, e. │ │ │ │ │ -0003c680: 672c 2075 7369 6e67 2050 4750 2e0a 4164 g, using PGP..Ad │ │ │ │ │ -0003c690: 6469 7469 6f6e 616c 6c79 2c20 7468 6520 ditionally, the │ │ │ │ │ -0003c6a0: 636f 6d6d 616e 6473 2074 6861 7420 6361 commands that ca │ │ │ │ │ -0003c6b0: 6e20 6265 2075 7365 6420 746f 2073 7562 n be used to sub │ │ │ │ │ -0003c6c0: 7665 7274 2074 6865 2055 4546 4920 7365 vert the UEFI se │ │ │ │ │ -0003c6d0: 6375 7265 0a62 6f6f 7420 6d65 6368 616e cure.boot mechan │ │ │ │ │ -0003c6e0: 6973 6d2c 2073 7563 6820 6173 2027 696f ism, such as 'io │ │ │ │ │ -0003c6f0: 7277 2720 616e 6420 276d 656d 7277 2720 rw' and 'memrw' │ │ │ │ │ -0003c700: 7769 6c6c 206e 6f74 2062 6520 6176 6169 will not be avai │ │ │ │ │ -0003c710: 6c61 626c 6520 7768 656e 0a74 6865 2055 lable when.the U │ │ │ │ │ -0003c720: 4546 4920 7365 6375 7265 2062 6f6f 7420 EFI secure boot │ │ │ │ │ -0003c730: 6973 2065 6e61 626c 6564 2e20 2054 6869 is enabled. Thi │ │ │ │ │ -0003c740: 7320 6973 2064 6f6e 6520 666f 7220 7365 s is done for se │ │ │ │ │ -0003c750: 6375 7269 7479 2072 6561 736f 6e73 2061 curity reasons a │ │ │ │ │ -0003c760: 6e64 0a61 7265 2065 6e66 6f72 6365 6420 nd.are enforced │ │ │ │ │ -0003c770: 6279 2074 6865 2047 5255 4220 4c6f 636b by the GRUB Lock │ │ │ │ │ -0003c780: 646f 776e 206d 6563 6861 6e69 736d 2028 down mechanism ( │ │ │ │ │ -0003c790: 2a6e 6f74 6520 4c6f 636b 646f 776e 3a3a *note Lockdown:: │ │ │ │ │ -0003c7a0: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ │ -0003c7b0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5365 .info, Node: Se │ │ │ │ │ -0003c7c0: 6375 7265 2042 6f6f 7420 4164 7661 6e63 cure Boot Advanc │ │ │ │ │ -0003c7d0: 6564 2054 6172 6765 7469 6e67 2c20 204e ed Targeting, N │ │ │ │ │ -0003c7e0: 6578 743a 204d 6561 7375 7265 6420 426f ext: Measured Bo │ │ │ │ │ -0003c7f0: 6f74 2c20 2050 7265 763a 2055 4546 4920 ot, Prev: UEFI │ │ │ │ │ -0003c800: 7365 6375 7265 2062 6f6f 7420 616e 6420 secure boot and │ │ │ │ │ -0003c810: 7368 696d 2c20 2055 703a 2053 6563 7572 shim, Up: Secur │ │ │ │ │ -0003c820: 6974 790a 0a31 382e 3420 456d 6265 6464 ity..18.4 Embedd │ │ │ │ │ -0003c830: 6564 2069 6e66 6f72 6d61 7469 6f6e 2066 ed information f │ │ │ │ │ -0003c840: 6f72 2067 656e 6572 6174 696f 6e20 6e75 or generation nu │ │ │ │ │ -0003c850: 6d62 6572 2062 6173 6564 2072 6576 6f63 mber based revoc │ │ │ │ │ -0003c860: 6174 696f 6e0a 3d3d 3d3d 3d3d 3d3d 3d3d ation.========== │ │ │ │ │ +0003c400: 3d3d 3d3d 0a0a 5468 6520 4752 5542 2c20 ====..The GRUB, │ │ │ │ │ +0003c410: 6578 6365 7074 2074 6865 2027 6368 6169 except the 'chai │ │ │ │ │ +0003c420: 6e6c 6f61 6465 7227 2063 6f6d 6d61 6e64 nloader' command │ │ │ │ │ +0003c430: 2c20 776f 726b 7320 7769 7468 2074 6865 , works with the │ │ │ │ │ +0003c440: 2055 4546 4920 7365 6375 7265 0a62 6f6f UEFI secure.boo │ │ │ │ │ +0003c450: 7420 616e 6420 7468 6520 7368 696d 2e20 t and the shim. │ │ │ │ │ +0003c460: 2054 6869 7320 6675 6e63 7469 6f6e 616c This functional │ │ │ │ │ +0003c470: 6974 7920 6973 2070 726f 7669 6465 6420 ity is provided │ │ │ │ │ +0003c480: 6279 2074 6865 2073 6869 6d5f 6c6f 636b by the shim_lock │ │ │ │ │ +0003c490: 0a76 6572 6966 6965 722e 2020 4974 2069 .verifier. It i │ │ │ │ │ +0003c4a0: 7320 6275 696c 7420 696e 746f 2074 6865 s built into the │ │ │ │ │ +0003c4b0: 2027 636f 7265 2e69 6d67 2720 616e 6420 'core.img' and │ │ │ │ │ +0003c4c0: 6973 2072 6567 6973 7465 7265 6420 6966 is registered if │ │ │ │ │ +0003c4d0: 2074 6865 2055 4546 490a 7365 6375 7265 the UEFI.secure │ │ │ │ │ +0003c4e0: 2062 6f6f 7420 6973 2065 6e61 626c 6564 boot is enabled │ │ │ │ │ +0003c4f0: 2e20 2054 6865 2027 7368 696d 5f6c 6f63 . The 'shim_loc │ │ │ │ │ +0003c500: 6b27 2076 6172 6961 626c 6520 6973 2073 k' variable is s │ │ │ │ │ +0003c510: 6574 2074 6f20 2779 2720 7768 656e 0a73 et to 'y' when.s │ │ │ │ │ +0003c520: 6869 6d5f 6c6f 636b 2076 6572 6966 6965 him_lock verifie │ │ │ │ │ +0003c530: 7220 6973 2072 6567 6973 7465 7265 642e r is registered. │ │ │ │ │ +0003c540: 2020 4966 2069 7420 6973 2064 6573 6972 If it is desir │ │ │ │ │ +0003c550: 6564 2074 6f20 7573 6520 5545 4649 2073 ed to use UEFI s │ │ │ │ │ +0003c560: 6563 7572 650a 626f 6f74 2077 6974 686f ecure.boot witho │ │ │ │ │ +0003c570: 7574 2073 6869 6d2c 206f 6e65 2063 616e ut shim, one can │ │ │ │ │ +0003c580: 2064 6973 6162 6c65 2073 6869 6d5f 6c6f disable shim_lo │ │ │ │ │ +0003c590: 636b 2062 7920 6469 7361 626c 696e 6720 ck by disabling │ │ │ │ │ +0003c5a0: 7368 696d 0a76 6572 6966 6963 6174 696f shim.verificatio │ │ │ │ │ +0003c5b0: 6e20 7769 7468 204d 6f6b 5362 5374 6174 n with MokSbStat │ │ │ │ │ +0003c5c0: 6520 5545 4649 2076 6172 6961 626c 6520 e UEFI variable │ │ │ │ │ +0003c5d0: 6f72 2062 7920 6275 696c 6469 6e67 2067 or by building g │ │ │ │ │ +0003c5e0: 7275 6220 696d 6167 650a 7769 7468 2027 rub image.with ' │ │ │ │ │ +0003c5f0: 2d2d 6469 7361 626c 652d 7368 696d 2d6c --disable-shim-l │ │ │ │ │ +0003c600: 6f63 6b27 206f 7074 696f 6e2e 0a0a 2020 ock' option... │ │ │ │ │ +0003c610: 2041 6c6c 2047 5255 4220 6d6f 6475 6c65 All GRUB module │ │ │ │ │ +0003c620: 7320 6e6f 7420 7374 6f72 6564 2069 6e20 s not stored in │ │ │ │ │ +0003c630: 7468 6520 2763 6f72 652e 696d 6727 2c20 the 'core.img', │ │ │ │ │ +0003c640: 4f53 206b 6572 6e65 6c73 2c20 4143 5049 OS kernels, ACPI │ │ │ │ │ +0003c650: 0a74 6162 6c65 732c 2044 6576 6963 6520 .tables, Device │ │ │ │ │ +0003c660: 5472 6565 732c 2065 7463 2e20 2068 6176 Trees, etc. hav │ │ │ │ │ +0003c670: 6520 746f 2062 6520 7369 676e 6564 2c20 e to be signed, │ │ │ │ │ +0003c680: 652e 672c 2075 7369 6e67 2050 4750 2e0a e.g, using PGP.. │ │ │ │ │ +0003c690: 4164 6469 7469 6f6e 616c 6c79 2c20 7468 Additionally, th │ │ │ │ │ +0003c6a0: 6520 636f 6d6d 616e 6473 2074 6861 7420 e commands that │ │ │ │ │ +0003c6b0: 6361 6e20 6265 2075 7365 6420 746f 2073 can be used to s │ │ │ │ │ +0003c6c0: 7562 7665 7274 2074 6865 2055 4546 4920 ubvert the UEFI │ │ │ │ │ +0003c6d0: 7365 6375 7265 0a62 6f6f 7420 6d65 6368 secure.boot mech │ │ │ │ │ +0003c6e0: 616e 6973 6d2c 2073 7563 6820 6173 2027 anism, such as ' │ │ │ │ │ +0003c6f0: 696f 7277 2720 616e 6420 276d 656d 7277 iorw' and 'memrw │ │ │ │ │ +0003c700: 2720 7769 6c6c 206e 6f74 2062 6520 6176 ' will not be av │ │ │ │ │ +0003c710: 6169 6c61 626c 6520 7768 656e 0a74 6865 ailable when.the │ │ │ │ │ +0003c720: 2055 4546 4920 7365 6375 7265 2062 6f6f UEFI secure boo │ │ │ │ │ +0003c730: 7420 6973 2065 6e61 626c 6564 2e20 2054 t is enabled. T │ │ │ │ │ +0003c740: 6869 7320 6973 2064 6f6e 6520 666f 7220 his is done for │ │ │ │ │ +0003c750: 7365 6375 7269 7479 2072 6561 736f 6e73 security reasons │ │ │ │ │ +0003c760: 2061 6e64 0a61 7265 2065 6e66 6f72 6365 and.are enforce │ │ │ │ │ +0003c770: 6420 6279 2074 6865 2047 5255 4220 4c6f d by the GRUB Lo │ │ │ │ │ +0003c780: 636b 646f 776e 206d 6563 6861 6e69 736d ckdown mechanism │ │ │ │ │ +0003c790: 2028 2a6e 6f74 6520 4c6f 636b 646f 776e (*note Lockdown │ │ │ │ │ +0003c7a0: 3a3a 292e 0a0a 1f0a 4669 6c65 3a20 6772 ::).....File: gr │ │ │ │ │ +0003c7b0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +0003c7c0: 5365 6375 7265 2042 6f6f 7420 4164 7661 Secure Boot Adva │ │ │ │ │ +0003c7d0: 6e63 6564 2054 6172 6765 7469 6e67 2c20 nced Targeting, │ │ │ │ │ +0003c7e0: 204e 6578 743a 204d 6561 7375 7265 6420 Next: Measured │ │ │ │ │ +0003c7f0: 426f 6f74 2c20 2050 7265 763a 2055 4546 Boot, Prev: UEF │ │ │ │ │ +0003c800: 4920 7365 6375 7265 2062 6f6f 7420 616e I secure boot an │ │ │ │ │ +0003c810: 6420 7368 696d 2c20 2055 703a 2053 6563 d shim, Up: Sec │ │ │ │ │ +0003c820: 7572 6974 790a 0a31 382e 3420 456d 6265 urity..18.4 Embe │ │ │ │ │ +0003c830: 6464 6564 2069 6e66 6f72 6d61 7469 6f6e dded information │ │ │ │ │ +0003c840: 2066 6f72 2067 656e 6572 6174 696f 6e20 for generation │ │ │ │ │ +0003c850: 6e75 6d62 6572 2062 6173 6564 2072 6576 number based rev │ │ │ │ │ +0003c860: 6f63 6174 696f 6e0a 3d3d 3d3d 3d3d 3d3d ocation.======== │ │ │ │ │ 0003c870: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003c880: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003c890: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003c8a0: 3d3d 3d3d 3d3d 0a0a 5468 6520 5365 6375 ======..The Secu │ │ │ │ │ -0003c8b0: 7265 2042 6f6f 7420 4164 7661 6e63 6564 re Boot Advanced │ │ │ │ │ -0003c8c0: 2054 6172 6765 7469 6e67 2028 5342 4154 Targeting (SBAT │ │ │ │ │ -0003c8d0: 2920 6973 2061 206d 6563 6861 6e69 736d ) is a mechanism │ │ │ │ │ -0003c8e0: 2074 6f20 616c 6c6f 7720 7468 650a 7265 to allow the.re │ │ │ │ │ -0003c8f0: 766f 6361 7469 6f6e 206f 6620 636f 6d70 vocation of comp │ │ │ │ │ -0003c900: 6f6e 656e 7473 2069 6e20 7468 6520 626f onents in the bo │ │ │ │ │ -0003c910: 6f74 2070 6174 6820 6279 2075 7369 6e67 ot path by using │ │ │ │ │ -0003c920: 2067 656e 6572 6174 696f 6e20 6e75 6d62 generation numb │ │ │ │ │ -0003c930: 6572 730a 656d 6265 6464 6564 2069 6e74 ers.embedded int │ │ │ │ │ -0003c940: 6f20 7468 6520 4546 4920 6269 6e61 7269 o the EFI binari │ │ │ │ │ -0003c950: 6573 2e20 2054 6865 2053 4241 5420 6d65 es. The SBAT me │ │ │ │ │ -0003c960: 7461 6461 7461 2069 7320 6c6f 6361 7465 tadata is locate │ │ │ │ │ -0003c970: 6420 696e 2061 6e0a 2e73 6261 7420 6461 d in an..sbat da │ │ │ │ │ -0003c980: 7461 2073 6563 7469 6f6e 2074 6861 7420 ta section that │ │ │ │ │ -0003c990: 6861 7320 7365 7420 6f66 2055 5446 2d38 has set of UTF-8 │ │ │ │ │ -0003c9a0: 2073 7472 696e 6773 2061 7320 636f 6d6d strings as comm │ │ │ │ │ -0003c9b0: 612d 7365 7061 7261 7465 640a 7661 6c75 a-separated.valu │ │ │ │ │ -0003c9c0: 6573 2028 4353 5629 2e20 5365 6520 3c68 es (CSV). See │ │ │ │ │ -0003ca00: 2066 6f72 0a6d 6f72 6520 6465 7461 696c for.more detail │ │ │ │ │ -0003ca10: 732e 0a0a 2020 2054 6f20 6164 6420 6120 s... To add a │ │ │ │ │ -0003ca20: 6461 7461 2073 6563 7469 6f6e 2063 6f6e data section con │ │ │ │ │ -0003ca30: 7461 696e 696e 6720 7468 6520 5342 4154 taining the SBAT │ │ │ │ │ -0003ca40: 2069 6e66 6f72 6d61 7469 6f6e 2069 6e74 information int │ │ │ │ │ -0003ca50: 6f20 7468 650a 6269 6e61 7279 2c20 7468 o the.binary, th │ │ │ │ │ -0003ca60: 6520 272d 2d73 6261 7427 206f 7074 696f e '--sbat' optio │ │ │ │ │ -0003ca70: 6e20 6f66 2027 6772 7562 2d6d 6b69 6d61 n of 'grub-mkima │ │ │ │ │ -0003ca80: 6765 2720 636f 6d6d 616e 6420 7368 6f75 ge' command shou │ │ │ │ │ -0003ca90: 6c64 2062 6520 7573 6564 2e0a 5468 6520 ld be used..The │ │ │ │ │ -0003caa0: 636f 6e74 656e 7420 6f66 2061 2043 5356 content of a CSV │ │ │ │ │ -0003cab0: 2066 696c 652c 2065 6e63 6f64 6564 2077 file, encoded w │ │ │ │ │ -0003cac0: 6974 6820 5554 462d 382c 2069 7320 636f ith UTF-8, is co │ │ │ │ │ -0003cad0: 7069 6564 2061 7320 6973 2074 6f20 7468 pied as is to th │ │ │ │ │ -0003cae0: 650a 2e73 6261 7420 6461 7461 2073 6563 e..sbat data sec │ │ │ │ │ -0003caf0: 7469 6f6e 2069 6e74 6f20 7468 6520 6765 tion into the ge │ │ │ │ │ -0003cb00: 6e65 7261 7465 6420 4546 4920 6269 6e61 nerated EFI bina │ │ │ │ │ -0003cb10: 7279 2e20 2054 6865 2043 5356 2066 696c ry. The CSV fil │ │ │ │ │ -0003cb20: 6520 6361 6e20 6265 0a73 746f 7265 6420 e can be.stored │ │ │ │ │ -0003cb30: 616e 7977 6865 7265 206f 6e20 7468 6520 anywhere on the │ │ │ │ │ -0003cb40: 6669 6c65 2073 7973 7465 6d2e 0a0a 2020 file system... │ │ │ │ │ -0003cb50: 2020 2067 7275 622d 6d6b 696d 6167 6520 grub-mkimage │ │ │ │ │ -0003cb60: 2d4f 2078 3836 5f36 342d 6566 6920 2d6f -O x86_64-efi -o │ │ │ │ │ -0003cb70: 2067 7275 6278 3634 2e65 6669 202d 7020 grubx64.efi -p │ │ │ │ │ -0003cb80: 2728 7466 7470 292f 6772 7562 2720 2d2d '(tftp)/grub' -- │ │ │ │ │ -0003cb90: 7362 6174 2073 6261 742e 6373 7620 6566 sbat sbat.csv ef │ │ │ │ │ -0003cba0: 696e 6574 2074 6674 700a 0a1f 0a46 696c inet tftp....Fil │ │ │ │ │ -0003cbb0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -0003cbc0: 6f64 653a 204d 6561 7375 7265 6420 426f ode: Measured Bo │ │ │ │ │ -0003cbd0: 6f74 2c20 204e 6578 743a 204c 6f63 6b64 ot, Next: Lockd │ │ │ │ │ -0003cbe0: 6f77 6e2c 2020 5072 6576 3a20 5365 6375 own, Prev: Secu │ │ │ │ │ -0003cbf0: 7265 2042 6f6f 7420 4164 7661 6e63 6564 re Boot Advanced │ │ │ │ │ -0003cc00: 2054 6172 6765 7469 6e67 2c20 2055 703a Targeting, Up: │ │ │ │ │ -0003cc10: 2053 6563 7572 6974 790a 0a31 382e 3520 Security..18.5 │ │ │ │ │ -0003cc20: 4d65 6173 7572 696e 6720 626f 6f74 2063 Measuring boot c │ │ │ │ │ -0003cc30: 6f6d 706f 6e65 6e74 730a 3d3d 3d3d 3d3d omponents.====== │ │ │ │ │ +0003c8a0: 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 5365 ========..The Se │ │ │ │ │ +0003c8b0: 6375 7265 2042 6f6f 7420 4164 7661 6e63 cure Boot Advanc │ │ │ │ │ +0003c8c0: 6564 2054 6172 6765 7469 6e67 2028 5342 ed Targeting (SB │ │ │ │ │ +0003c8d0: 4154 2920 6973 2061 206d 6563 6861 6e69 AT) is a mechani │ │ │ │ │ +0003c8e0: 736d 2074 6f20 616c 6c6f 7720 7468 650a sm to allow the. │ │ │ │ │ +0003c8f0: 7265 766f 6361 7469 6f6e 206f 6620 636f revocation of co │ │ │ │ │ +0003c900: 6d70 6f6e 656e 7473 2069 6e20 7468 6520 mponents in the │ │ │ │ │ +0003c910: 626f 6f74 2070 6174 6820 6279 2075 7369 boot path by usi │ │ │ │ │ +0003c920: 6e67 2067 656e 6572 6174 696f 6e20 6e75 ng generation nu │ │ │ │ │ +0003c930: 6d62 6572 730a 656d 6265 6464 6564 2069 mbers.embedded i │ │ │ │ │ +0003c940: 6e74 6f20 7468 6520 4546 4920 6269 6e61 nto the EFI bina │ │ │ │ │ +0003c950: 7269 6573 2e20 2054 6865 2053 4241 5420 ries. The SBAT │ │ │ │ │ +0003c960: 6d65 7461 6461 7461 2069 7320 6c6f 6361 metadata is loca │ │ │ │ │ +0003c970: 7465 6420 696e 2061 6e0a 2e73 6261 7420 ted in an..sbat │ │ │ │ │ +0003c980: 6461 7461 2073 6563 7469 6f6e 2074 6861 data section tha │ │ │ │ │ +0003c990: 7420 6861 7320 7365 7420 6f66 2055 5446 t has set of UTF │ │ │ │ │ +0003c9a0: 2d38 2073 7472 696e 6773 2061 7320 636f -8 strings as co │ │ │ │ │ +0003c9b0: 6d6d 612d 7365 7061 7261 7465 640a 7661 mma-separated.va │ │ │ │ │ +0003c9c0: 6c75 6573 2028 4353 5629 2e20 5365 6520 lues (CSV). See │ │ │ │ │ +0003c9d0: 3c68 7474 7073 3a2f 2f67 6974 6875 622e for.more deta │ │ │ │ │ +0003ca10: 696c 732e 0a0a 2020 2054 6f20 6164 6420 ils... To add │ │ │ │ │ +0003ca20: 6120 6461 7461 2073 6563 7469 6f6e 2063 a data section c │ │ │ │ │ +0003ca30: 6f6e 7461 696e 696e 6720 7468 6520 5342 ontaining the SB │ │ │ │ │ +0003ca40: 4154 2069 6e66 6f72 6d61 7469 6f6e 2069 AT information i │ │ │ │ │ +0003ca50: 6e74 6f20 7468 650a 6269 6e61 7279 2c20 nto the.binary, │ │ │ │ │ +0003ca60: 7468 6520 272d 2d73 6261 7427 206f 7074 the '--sbat' opt │ │ │ │ │ +0003ca70: 696f 6e20 6f66 2027 6772 7562 2d6d 6b69 ion of 'grub-mki │ │ │ │ │ +0003ca80: 6d61 6765 2720 636f 6d6d 616e 6420 7368 mage' command sh │ │ │ │ │ +0003ca90: 6f75 6c64 2062 6520 7573 6564 2e0a 5468 ould be used..Th │ │ │ │ │ +0003caa0: 6520 636f 6e74 656e 7420 6f66 2061 2043 e content of a C │ │ │ │ │ +0003cab0: 5356 2066 696c 652c 2065 6e63 6f64 6564 SV file, encoded │ │ │ │ │ +0003cac0: 2077 6974 6820 5554 462d 382c 2069 7320 with UTF-8, is │ │ │ │ │ +0003cad0: 636f 7069 6564 2061 7320 6973 2074 6f20 copied as is to │ │ │ │ │ +0003cae0: 7468 650a 2e73 6261 7420 6461 7461 2073 the..sbat data s │ │ │ │ │ +0003caf0: 6563 7469 6f6e 2069 6e74 6f20 7468 6520 ection into the │ │ │ │ │ +0003cb00: 6765 6e65 7261 7465 6420 4546 4920 6269 generated EFI bi │ │ │ │ │ +0003cb10: 6e61 7279 2e20 2054 6865 2043 5356 2066 nary. The CSV f │ │ │ │ │ +0003cb20: 696c 6520 6361 6e20 6265 0a73 746f 7265 ile can be.store │ │ │ │ │ +0003cb30: 6420 616e 7977 6865 7265 206f 6e20 7468 d anywhere on th │ │ │ │ │ +0003cb40: 6520 6669 6c65 2073 7973 7465 6d2e 0a0a e file system... │ │ │ │ │ +0003cb50: 2020 2020 2067 7275 622d 6d6b 696d 6167 grub-mkimag │ │ │ │ │ +0003cb60: 6520 2d4f 2078 3836 5f36 342d 6566 6920 e -O x86_64-efi │ │ │ │ │ +0003cb70: 2d6f 2067 7275 6278 3634 2e65 6669 202d -o grubx64.efi - │ │ │ │ │ +0003cb80: 7020 2728 7466 7470 292f 6772 7562 2720 p '(tftp)/grub' │ │ │ │ │ +0003cb90: 2d2d 7362 6174 2073 6261 742e 6373 7620 --sbat sbat.csv │ │ │ │ │ +0003cba0: 6566 696e 6574 2074 6674 700a 0a1f 0a46 efinet tftp....F │ │ │ │ │ +0003cbb0: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +0003cbc0: 204e 6f64 653a 204d 6561 7375 7265 6420 Node: Measured │ │ │ │ │ +0003cbd0: 426f 6f74 2c20 204e 6578 743a 204c 6f63 Boot, Next: Loc │ │ │ │ │ +0003cbe0: 6b64 6f77 6e2c 2020 5072 6576 3a20 5365 kdown, Prev: Se │ │ │ │ │ +0003cbf0: 6375 7265 2042 6f6f 7420 4164 7661 6e63 cure Boot Advanc │ │ │ │ │ +0003cc00: 6564 2054 6172 6765 7469 6e67 2c20 2055 ed Targeting, U │ │ │ │ │ +0003cc10: 703a 2053 6563 7572 6974 790a 0a31 382e p: Security..18. │ │ │ │ │ +0003cc20: 3520 4d65 6173 7572 696e 6720 626f 6f74 5 Measuring boot │ │ │ │ │ +0003cc30: 2063 6f6d 706f 6e65 6e74 730a 3d3d 3d3d components.==== │ │ │ │ │ 0003cc40: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003cc50: 3d3d 3d3d 3d3d 3d3d 0a0a 4966 2074 6865 ========..If the │ │ │ │ │ -0003cc60: 2074 706d 206d 6f64 756c 6520 6973 206c tpm module is l │ │ │ │ │ -0003cc70: 6f61 6465 6420 616e 6420 7468 6520 706c oaded and the pl │ │ │ │ │ -0003cc80: 6174 666f 726d 2068 6173 2061 2054 7275 atform has a Tru │ │ │ │ │ -0003cc90: 7374 6564 2050 6c61 7466 6f72 6d0a 4d6f sted Platform.Mo │ │ │ │ │ -0003cca0: 6475 6c65 2069 6e73 7461 6c6c 6564 2c20 dule installed, │ │ │ │ │ -0003ccb0: 4752 5542 2077 696c 6c20 6c6f 6720 6561 GRUB will log ea │ │ │ │ │ -0003ccc0: 6368 2063 6f6d 6d61 6e64 2065 7865 6375 ch command execu │ │ │ │ │ -0003ccd0: 7465 6420 616e 6420 6561 6368 2066 696c ted and each fil │ │ │ │ │ -0003cce0: 650a 6c6f 6164 6564 2069 6e74 6f20 7468 e.loaded into th │ │ │ │ │ -0003ccf0: 6520 5450 4d20 6576 656e 7420 6c6f 6720 e TPM event log │ │ │ │ │ -0003cd00: 616e 6420 6578 7465 6e64 2074 6865 2050 and extend the P │ │ │ │ │ -0003cd10: 4352 2076 616c 7565 7320 696e 2074 6865 CR values in the │ │ │ │ │ -0003cd20: 2054 504d 0a63 6f72 7265 7370 6f6e 6469 TPM.correspondi │ │ │ │ │ -0003cd30: 6e67 6c79 2e20 2041 6c6c 2065 7665 6e74 ngly. All event │ │ │ │ │ -0003cd40: 7320 7769 6c6c 2062 6520 6c6f 6767 6564 s will be logged │ │ │ │ │ -0003cd50: 2069 6e74 6f20 7468 6520 5043 5220 6465 into the PCR de │ │ │ │ │ -0003cd60: 7363 7269 6265 6420 6265 6c6f 770a 7769 scribed below.wi │ │ │ │ │ -0003cd70: 7468 2061 2074 7970 6520 6f66 2045 565f th a type of EV_ │ │ │ │ │ -0003cd80: 4950 4c20 616e 6420 616e 2065 7665 6e74 IPL and an event │ │ │ │ │ -0003cd90: 2064 6573 6372 6970 7469 6f6e 2061 7320 description as │ │ │ │ │ -0003cda0: 6465 7363 7269 6265 6420 6265 6c6f 772e described below. │ │ │ │ │ -0003cdb0: 0a0a 4576 656e 7420 7479 7065 2020 2020 ..Event type │ │ │ │ │ -0003cdc0: 2020 2020 2020 2020 2050 4352 2020 2020 PCR │ │ │ │ │ -0003cdd0: 2044 6573 6372 6970 7469 6f6e 0a2d 2d2d Description.--- │ │ │ │ │ +0003cc50: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 4966 2074 ==========..If t │ │ │ │ │ +0003cc60: 6865 2074 706d 206d 6f64 756c 6520 6973 he tpm module is │ │ │ │ │ +0003cc70: 206c 6f61 6465 6420 616e 6420 7468 6520 loaded and the │ │ │ │ │ +0003cc80: 706c 6174 666f 726d 2068 6173 2061 2054 platform has a T │ │ │ │ │ +0003cc90: 7275 7374 6564 2050 6c61 7466 6f72 6d0a rusted Platform. │ │ │ │ │ +0003cca0: 4d6f 6475 6c65 2069 6e73 7461 6c6c 6564 Module installed │ │ │ │ │ +0003ccb0: 2c20 4752 5542 2077 696c 6c20 6c6f 6720 , GRUB will log │ │ │ │ │ +0003ccc0: 6561 6368 2063 6f6d 6d61 6e64 2065 7865 each command exe │ │ │ │ │ +0003ccd0: 6375 7465 6420 616e 6420 6561 6368 2066 cuted and each f │ │ │ │ │ +0003cce0: 696c 650a 6c6f 6164 6564 2069 6e74 6f20 ile.loaded into │ │ │ │ │ +0003ccf0: 7468 6520 5450 4d20 6576 656e 7420 6c6f the TPM event lo │ │ │ │ │ +0003cd00: 6720 616e 6420 6578 7465 6e64 2074 6865 g and extend the │ │ │ │ │ +0003cd10: 2050 4352 2076 616c 7565 7320 696e 2074 PCR values in t │ │ │ │ │ +0003cd20: 6865 2054 504d 0a63 6f72 7265 7370 6f6e he TPM.correspon │ │ │ │ │ +0003cd30: 6469 6e67 6c79 2e20 2041 6c6c 2065 7665 dingly. All eve │ │ │ │ │ +0003cd40: 6e74 7320 7769 6c6c 2062 6520 6c6f 6767 nts will be logg │ │ │ │ │ +0003cd50: 6564 2069 6e74 6f20 7468 6520 5043 5220 ed into the PCR │ │ │ │ │ +0003cd60: 6465 7363 7269 6265 6420 6265 6c6f 770a described below. │ │ │ │ │ +0003cd70: 7769 7468 2061 2074 7970 6520 6f66 2045 with a type of E │ │ │ │ │ +0003cd80: 565f 4950 4c20 616e 6420 616e 2065 7665 V_IPL and an eve │ │ │ │ │ +0003cd90: 6e74 2064 6573 6372 6970 7469 6f6e 2061 nt description a │ │ │ │ │ +0003cda0: 7320 6465 7363 7269 6265 6420 6265 6c6f s described belo │ │ │ │ │ +0003cdb0: 772e 0a0a 4576 656e 7420 7479 7065 2020 w...Event type │ │ │ │ │ +0003cdc0: 2020 2020 2020 2020 2020 2050 4352 2020 PCR │ │ │ │ │ +0003cdd0: 2020 2044 6573 6372 6970 7469 6f6e 0a2d Description.- │ │ │ │ │ 0003cde0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0003cdf0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0003ce00: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0003ce10: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0003ce20: 2d2d 2d2d 2d2d 2d2d 0a43 6f6d 6d61 6e64 --------.Command │ │ │ │ │ -0003ce30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ce40: 3820 2020 2020 2020 416c 6c20 6578 6563 8 All exec │ │ │ │ │ -0003ce50: 7574 6564 2063 6f6d 6d61 6e64 7320 2869 uted commands (i │ │ │ │ │ -0003ce60: 6e63 6c75 6469 6e67 2074 686f 7365 0a20 ncluding those. │ │ │ │ │ -0003ce70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ce80: 2020 2020 2020 2020 2020 2020 2020 6672 fr │ │ │ │ │ -0003ce90: 6f6d 2063 6f6e 6669 6775 7261 7469 6f6e om configuration │ │ │ │ │ -0003cea0: 2066 696c 6573 2920 7769 6c6c 2062 6520 files) will be │ │ │ │ │ -0003ceb0: 6c6f 6767 6564 0a20 2020 2020 2020 2020 logged. │ │ │ │ │ +0003ce20: 2d2d 2d2d 2d2d 2d2d 2d2d 0a43 6f6d 6d61 ----------.Comma │ │ │ │ │ +0003ce30: 6e64 2020 2020 2020 2020 2020 2020 2020 nd │ │ │ │ │ +0003ce40: 2020 3820 2020 2020 2020 416c 6c20 6578 8 All ex │ │ │ │ │ +0003ce50: 6563 7574 6564 2063 6f6d 6d61 6e64 7320 ecuted commands │ │ │ │ │ +0003ce60: 2869 6e63 6c75 6469 6e67 2074 686f 7365 (including those │ │ │ │ │ +0003ce70: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003ce80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003ce90: 6672 6f6d 2063 6f6e 6669 6775 7261 7469 from configurati │ │ │ │ │ +0003cea0: 6f6e 2066 696c 6573 2920 7769 6c6c 2062 on files) will b │ │ │ │ │ +0003ceb0: 6520 6c6f 6767 6564 0a20 2020 2020 2020 e logged. │ │ │ │ │ 0003cec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ced0: 2020 2020 2020 616e 6420 6d65 6173 7572 and measur │ │ │ │ │ -0003cee0: 6564 2061 7320 656e 7465 7265 6420 7769 ed as entered wi │ │ │ │ │ -0003cef0: 7468 2061 2070 7265 6669 7820 6f66 0a20 th a prefix of. │ │ │ │ │ -0003cf00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cf10: 2020 2020 2020 2020 2020 2020 2020 2267 "g │ │ │ │ │ -0003cf20: 7275 625f 636d 643a 2022 0a4b 6572 6e65 rub_cmd: ".Kerne │ │ │ │ │ -0003cf30: 6c20 636f 6d6d 616e 6420 6c69 6e65 2020 l command line │ │ │ │ │ -0003cf40: 2020 3820 2020 2020 2020 416e 7920 636f 8 Any co │ │ │ │ │ -0003cf50: 6d6d 616e 6420 6c69 6e65 2070 6173 7365 mmand line passe │ │ │ │ │ -0003cf60: 6420 746f 2061 206b 6572 6e65 6c20 7769 d to a kernel wi │ │ │ │ │ -0003cf70: 6c6c 0a20 2020 2020 2020 2020 2020 2020 ll. │ │ │ │ │ +0003ced0: 2020 2020 2020 2020 616e 6420 6d65 6173 and meas │ │ │ │ │ +0003cee0: 7572 6564 2061 7320 656e 7465 7265 6420 ured as entered │ │ │ │ │ +0003cef0: 7769 7468 2061 2070 7265 6669 7820 6f66 with a prefix of │ │ │ │ │ +0003cf00: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003cf10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003cf20: 2267 7275 625f 636d 643a 2022 0a4b 6572 "grub_cmd: ".Ker │ │ │ │ │ +0003cf30: 6e65 6c20 636f 6d6d 616e 6420 6c69 6e65 nel command line │ │ │ │ │ +0003cf40: 2020 2020 3820 2020 2020 2020 416e 7920 8 Any │ │ │ │ │ +0003cf50: 636f 6d6d 616e 6420 6c69 6e65 2070 6173 command line pas │ │ │ │ │ +0003cf60: 7365 6420 746f 2061 206b 6572 6e65 6c20 sed to a kernel │ │ │ │ │ +0003cf70: 7769 6c6c 0a20 2020 2020 2020 2020 2020 will. │ │ │ │ │ 0003cf80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cf90: 2020 6265 206c 6f67 6765 6420 616e 6420 be logged and │ │ │ │ │ -0003cfa0: 6d65 6173 7572 6564 2061 7320 656e 7465 measured as ente │ │ │ │ │ -0003cfb0: 7265 6420 7769 7468 2061 0a20 2020 2020 red with a. │ │ │ │ │ +0003cf90: 2020 2020 6265 206c 6f67 6765 6420 616e be logged an │ │ │ │ │ +0003cfa0: 6420 6d65 6173 7572 6564 2061 7320 656e d measured as en │ │ │ │ │ +0003cfb0: 7465 7265 6420 7769 7468 2061 0a20 2020 tered with a. │ │ │ │ │ 0003cfc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003cfd0: 2020 2020 2020 2020 2020 7072 6566 6978 prefix │ │ │ │ │ -0003cfe0: 206f 6620 226b 6572 6e65 6c5f 636d 646c of "kernel_cmdl │ │ │ │ │ -0003cff0: 696e 653a 2022 0a4d 6f64 756c 6520 636f ine: ".Module co │ │ │ │ │ -0003d000: 6d6d 616e 6420 6c69 6e65 2020 2020 3820 mmand line 8 │ │ │ │ │ -0003d010: 2020 2020 2020 416e 7920 636f 6d6d 616e Any comman │ │ │ │ │ -0003d020: 6420 6c69 6e65 2070 6173 7365 6420 746f d line passed to │ │ │ │ │ -0003d030: 2061 206b 6572 6e65 6c0a 2020 2020 2020 a kernel. │ │ │ │ │ +0003cfd0: 2020 2020 2020 2020 2020 2020 7072 6566 pref │ │ │ │ │ +0003cfe0: 6978 206f 6620 226b 6572 6e65 6c5f 636d ix of "kernel_cm │ │ │ │ │ +0003cff0: 646c 696e 653a 2022 0a4d 6f64 756c 6520 dline: ".Module │ │ │ │ │ +0003d000: 636f 6d6d 616e 6420 6c69 6e65 2020 2020 command line │ │ │ │ │ +0003d010: 3820 2020 2020 2020 416e 7920 636f 6d6d 8 Any comm │ │ │ │ │ +0003d020: 616e 6420 6c69 6e65 2070 6173 7365 6420 and line passed │ │ │ │ │ +0003d030: 746f 2061 206b 6572 6e65 6c0a 2020 2020 to a kernel. │ │ │ │ │ 0003d040: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d050: 2020 2020 2020 2020 206d 6f64 756c 6520 module │ │ │ │ │ -0003d060: 7769 6c6c 2062 6520 6c6f 6767 6564 2061 will be logged a │ │ │ │ │ -0003d070: 6e64 206d 6561 7375 7265 6420 6173 0a20 nd measured as. │ │ │ │ │ -0003d080: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d090: 2020 2020 2020 2020 2020 2020 2020 656e en │ │ │ │ │ -0003d0a0: 7465 7265 6420 7769 7468 2061 2070 7265 tered with a pre │ │ │ │ │ -0003d0b0: 6669 7820 6f66 2022 6d6f 6475 6c65 5f63 fix of "module_c │ │ │ │ │ -0003d0c0: 6d64 6c69 6e65 3a0a 2020 2020 2020 2020 mdline:. │ │ │ │ │ +0003d050: 2020 2020 2020 2020 2020 206d 6f64 756c modul │ │ │ │ │ +0003d060: 6520 7769 6c6c 2062 6520 6c6f 6767 6564 e will be logged │ │ │ │ │ +0003d070: 2061 6e64 206d 6561 7375 7265 6420 6173 and measured as │ │ │ │ │ +0003d080: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003d090: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003d0a0: 656e 7465 7265 6420 7769 7468 2061 2070 entered with a p │ │ │ │ │ +0003d0b0: 7265 6669 7820 6f66 2022 6d6f 6475 6c65 refix of "module │ │ │ │ │ +0003d0c0: 5f63 6d64 6c69 6e65 3a0a 2020 2020 2020 _cmdline:. │ │ │ │ │ 0003d0d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d0e0: 2020 2020 2020 2022 0a46 696c 6573 2020 ".Files │ │ │ │ │ +0003d0e0: 2020 2020 2020 2020 2022 0a46 696c 6573 ".Files │ │ │ │ │ 0003d0f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d100: 3920 2020 2020 2020 416e 7920 6669 6c65 9 Any file │ │ │ │ │ -0003d110: 2072 6561 6420 6279 2047 5255 4220 7769 read by GRUB wi │ │ │ │ │ -0003d120: 6c6c 2062 6520 6c6f 6767 6564 2061 6e64 ll be logged and │ │ │ │ │ -0003d130: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003d100: 2020 3920 2020 2020 2020 416e 7920 6669 9 Any fi │ │ │ │ │ +0003d110: 6c65 2072 6561 6420 6279 2047 5255 4220 le read by GRUB │ │ │ │ │ +0003d120: 7769 6c6c 2062 6520 6c6f 6767 6564 2061 will be logged a │ │ │ │ │ +0003d130: 6e64 0a20 2020 2020 2020 2020 2020 2020 nd. │ │ │ │ │ 0003d140: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d150: 6d65 6173 7572 6564 2077 6974 6820 6120 measured with a │ │ │ │ │ -0003d160: 6465 7363 7269 7074 6976 6520 7465 7874 descriptive text │ │ │ │ │ -0003d170: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +0003d150: 2020 6d65 6173 7572 6564 2077 6974 6820 measured with │ │ │ │ │ +0003d160: 6120 6465 7363 7269 7074 6976 6520 7465 a descriptive te │ │ │ │ │ +0003d170: 7874 0a20 2020 2020 2020 2020 2020 2020 xt. │ │ │ │ │ 0003d180: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003d190: 636f 7272 6573 706f 6e64 696e 6720 746f corresponding to │ │ │ │ │ -0003d1a0: 2074 6865 2066 696c 656e 616d 652e 0a0a the filename... │ │ │ │ │ -0003d1b0: 2020 2047 5255 4220 7769 6c6c 206e 6f74 GRUB will not │ │ │ │ │ -0003d1c0: 206d 6561 7375 7265 2069 7473 206f 776e measure its own │ │ │ │ │ -0003d1d0: 2027 636f 7265 2e69 6d67 2720 2d20 6974 'core.img' - it │ │ │ │ │ -0003d1e0: 2069 7320 6578 7065 6374 6564 2074 6861 is expected tha │ │ │ │ │ -0003d1f0: 740a 6669 726d 7761 7265 2077 696c 6c20 t.firmware will │ │ │ │ │ -0003d200: 6361 7272 7920 7468 6973 206f 7574 2e20 carry this out. │ │ │ │ │ -0003d210: 2047 5255 4220 7769 6c6c 2061 6c73 6f20 GRUB will also │ │ │ │ │ -0003d220: 6e6f 7420 7065 7266 6f72 6d20 616e 790a not perform any. │ │ │ │ │ -0003d230: 6d65 6173 7572 656d 656e 7473 2075 6e74 measurements unt │ │ │ │ │ -0003d240: 696c 2074 6865 2074 706d 206d 6f64 756c il the tpm modul │ │ │ │ │ -0003d250: 6520 6973 206c 6f61 6465 642e 2020 4173 e is loaded. As │ │ │ │ │ -0003d260: 2073 7563 6820 6974 2069 7320 7265 636f such it is reco │ │ │ │ │ -0003d270: 6d6d 656e 6465 640a 7468 6174 2074 6865 mmended.that the │ │ │ │ │ -0003d280: 2074 706d 206d 6f64 756c 6520 6265 2062 tpm module be b │ │ │ │ │ -0003d290: 7569 6c74 2069 6e74 6f20 2763 6f72 652e uilt into 'core. │ │ │ │ │ -0003d2a0: 696d 6727 2069 6e20 6f72 6465 7220 746f img' in order to │ │ │ │ │ -0003d2b0: 2061 766f 6964 2061 0a70 6f74 656e 7469 avoid a.potenti │ │ │ │ │ -0003d2c0: 616c 2067 6170 2069 6e20 6d65 6173 7572 al gap in measur │ │ │ │ │ -0003d2d0: 656d 656e 7420 6265 7477 6565 6e20 2763 ement between 'c │ │ │ │ │ -0003d2e0: 6f72 652e 696d 6727 2062 6569 6e67 206c ore.img' being l │ │ │ │ │ -0003d2f0: 6f61 6465 6420 616e 6420 7468 6520 7470 oaded and the tp │ │ │ │ │ -0003d300: 6d0a 6d6f 6475 6c65 2062 6569 6e67 206c m.module being l │ │ │ │ │ -0003d310: 6f61 6465 642e 0a0a 2020 204d 6561 7375 oaded... Measu │ │ │ │ │ -0003d320: 7265 6420 626f 6f74 2069 7320 6375 7272 red boot is curr │ │ │ │ │ -0003d330: 656e 746c 7920 6f6e 6c79 2073 7570 706f ently only suppo │ │ │ │ │ -0003d340: 7274 6564 206f 6e20 4546 4920 706c 6174 rted on EFI plat │ │ │ │ │ -0003d350: 666f 726d 732e 0a0a 1f0a 4669 6c65 3a20 forms.....File: │ │ │ │ │ -0003d360: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -0003d370: 3a20 4c6f 636b 646f 776e 2c20 2050 7265 : Lockdown, Pre │ │ │ │ │ -0003d380: 763a 204d 6561 7375 7265 6420 426f 6f74 v: Measured Boot │ │ │ │ │ -0003d390: 2c20 2055 703a 2053 6563 7572 6974 790a , Up: Security. │ │ │ │ │ -0003d3a0: 0a31 382e 3620 4c6f 636b 646f 776e 2077 .18.6 Lockdown w │ │ │ │ │ -0003d3b0: 6865 6e20 626f 6f74 696e 6720 6f6e 2061 hen booting on a │ │ │ │ │ -0003d3c0: 2073 6563 7572 6520 7365 7475 700a 3d3d secure setup.== │ │ │ │ │ +0003d190: 2020 636f 7272 6573 706f 6e64 696e 6720 corresponding │ │ │ │ │ +0003d1a0: 746f 2074 6865 2066 696c 656e 616d 652e to the filename. │ │ │ │ │ +0003d1b0: 0a0a 2020 2047 5255 4220 7769 6c6c 206e .. GRUB will n │ │ │ │ │ +0003d1c0: 6f74 206d 6561 7375 7265 2069 7473 206f ot measure its o │ │ │ │ │ +0003d1d0: 776e 2027 636f 7265 2e69 6d67 2720 2d20 wn 'core.img' - │ │ │ │ │ +0003d1e0: 6974 2069 7320 6578 7065 6374 6564 2074 it is expected t │ │ │ │ │ +0003d1f0: 6861 740a 6669 726d 7761 7265 2077 696c hat.firmware wil │ │ │ │ │ +0003d200: 6c20 6361 7272 7920 7468 6973 206f 7574 l carry this out │ │ │ │ │ +0003d210: 2e20 2047 5255 4220 7769 6c6c 2061 6c73 . GRUB will als │ │ │ │ │ +0003d220: 6f20 6e6f 7420 7065 7266 6f72 6d20 616e o not perform an │ │ │ │ │ +0003d230: 790a 6d65 6173 7572 656d 656e 7473 2075 y.measurements u │ │ │ │ │ +0003d240: 6e74 696c 2074 6865 2074 706d 206d 6f64 ntil the tpm mod │ │ │ │ │ +0003d250: 756c 6520 6973 206c 6f61 6465 642e 2020 ule is loaded. │ │ │ │ │ +0003d260: 4173 2073 7563 6820 6974 2069 7320 7265 As such it is re │ │ │ │ │ +0003d270: 636f 6d6d 656e 6465 640a 7468 6174 2074 commended.that t │ │ │ │ │ +0003d280: 6865 2074 706d 206d 6f64 756c 6520 6265 he tpm module be │ │ │ │ │ +0003d290: 2062 7569 6c74 2069 6e74 6f20 2763 6f72 built into 'cor │ │ │ │ │ +0003d2a0: 652e 696d 6727 2069 6e20 6f72 6465 7220 e.img' in order │ │ │ │ │ +0003d2b0: 746f 2061 766f 6964 2061 0a70 6f74 656e to avoid a.poten │ │ │ │ │ +0003d2c0: 7469 616c 2067 6170 2069 6e20 6d65 6173 tial gap in meas │ │ │ │ │ +0003d2d0: 7572 656d 656e 7420 6265 7477 6565 6e20 urement between │ │ │ │ │ +0003d2e0: 2763 6f72 652e 696d 6727 2062 6569 6e67 'core.img' being │ │ │ │ │ +0003d2f0: 206c 6f61 6465 6420 616e 6420 7468 6520 loaded and the │ │ │ │ │ +0003d300: 7470 6d0a 6d6f 6475 6c65 2062 6569 6e67 tpm.module being │ │ │ │ │ +0003d310: 206c 6f61 6465 642e 0a0a 2020 204d 6561 loaded... Mea │ │ │ │ │ +0003d320: 7375 7265 6420 626f 6f74 2069 7320 6375 sured boot is cu │ │ │ │ │ +0003d330: 7272 656e 746c 7920 6f6e 6c79 2073 7570 rrently only sup │ │ │ │ │ +0003d340: 706f 7274 6564 206f 6e20 4546 4920 706c ported on EFI pl │ │ │ │ │ +0003d350: 6174 666f 726d 732e 0a0a 1f0a 4669 6c65 atforms.....File │ │ │ │ │ +0003d360: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +0003d370: 6465 3a20 4c6f 636b 646f 776e 2c20 2050 de: Lockdown, P │ │ │ │ │ +0003d380: 7265 763a 204d 6561 7375 7265 6420 426f rev: Measured Bo │ │ │ │ │ +0003d390: 6f74 2c20 2055 703a 2053 6563 7572 6974 ot, Up: Securit │ │ │ │ │ +0003d3a0: 790a 0a31 382e 3620 4c6f 636b 646f 776e y..18.6 Lockdown │ │ │ │ │ +0003d3b0: 2077 6865 6e20 626f 6f74 696e 6720 6f6e when booting on │ │ │ │ │ +0003d3c0: 2061 2073 6563 7572 6520 7365 7475 700a a secure setup. │ │ │ │ │ 0003d3d0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 0003d3e0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -0003d3f0: 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 6520 ==========..The │ │ │ │ │ -0003d400: 4752 5542 2063 616e 2062 6520 6c6f 636b GRUB can be lock │ │ │ │ │ -0003d410: 6564 2064 6f77 6e20 7768 656e 2062 6f6f ed down when boo │ │ │ │ │ -0003d420: 7465 6420 6f6e 2061 2073 6563 7572 6520 ted on a secure │ │ │ │ │ -0003d430: 626f 6f74 2065 6e76 6972 6f6e 6d65 6e74 boot environment │ │ │ │ │ -0003d440: 2c0a 666f 7220 6578 616d 706c 6520 6966 ,.for example if │ │ │ │ │ -0003d450: 2074 6865 2055 4546 4920 7365 6375 7265 the UEFI secure │ │ │ │ │ -0003d460: 2062 6f6f 7420 6973 2065 6e61 626c 6564 boot is enabled │ │ │ │ │ -0003d470: 2e20 204f 6e20 6120 6c6f 636b 6564 2064 . On a locked d │ │ │ │ │ -0003d480: 6f77 6e0a 636f 6e66 6967 7572 6174 696f own.configuratio │ │ │ │ │ -0003d490: 6e2c 2074 6865 2047 5255 4220 7769 6c6c n, the GRUB will │ │ │ │ │ -0003d4a0: 2062 6520 7265 7374 7269 6374 6564 2061 be restricted a │ │ │ │ │ -0003d4b0: 6e64 2073 6f6d 6520 6f70 6572 6174 696f nd some operatio │ │ │ │ │ -0003d4c0: 6e73 2f63 6f6d 6d61 6e64 730a 6361 6e6e ns/commands.cann │ │ │ │ │ -0003d4d0: 6f74 2062 6520 6578 6563 7574 6564 2e0a ot be executed.. │ │ │ │ │ -0003d4e0: 0a20 2020 5468 6520 276c 6f63 6b64 6f77 . The 'lockdow │ │ │ │ │ -0003d4f0: 6e27 2076 6172 6961 626c 6520 6973 2073 n' variable is s │ │ │ │ │ -0003d500: 6574 2074 6f20 2779 2720 7768 656e 2074 et to 'y' when t │ │ │ │ │ -0003d510: 6865 2047 5255 4220 6973 206c 6f63 6b65 he GRUB is locke │ │ │ │ │ -0003d520: 6420 646f 776e 2e0a 4f74 6865 7277 6973 d down..Otherwis │ │ │ │ │ -0003d530: 6520 6974 2064 6f65 7320 6e6f 7420 6578 e it does not ex │ │ │ │ │ -0003d540: 6974 2e0a 0a1f 0a46 696c 653a 2067 7275 it.....File: gru │ │ │ │ │ -0003d550: 622e 696e 666f 2c20 204e 6f64 653a 2050 b.info, Node: P │ │ │ │ │ -0003d560: 6c61 7466 6f72 6d20 6c69 6d69 7461 7469 latform limitati │ │ │ │ │ -0003d570: 6f6e 732c 2020 4e65 7874 3a20 506c 6174 ons, Next: Plat │ │ │ │ │ -0003d580: 666f 726d 2d73 7065 6369 6669 6320 6f70 form-specific op │ │ │ │ │ -0003d590: 6572 6174 696f 6e73 2c20 2050 7265 763a erations, Prev: │ │ │ │ │ -0003d5a0: 2053 6563 7572 6974 792c 2020 5570 3a20 Security, Up: │ │ │ │ │ -0003d5b0: 546f 700a 0a31 3920 506c 6174 666f 726d Top..19 Platform │ │ │ │ │ -0003d5c0: 206c 696d 6974 6174 696f 6e73 0a2a 2a2a limitations.*** │ │ │ │ │ +0003d3f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 0a0a 5468 ============..Th │ │ │ │ │ +0003d400: 6520 4752 5542 2063 616e 2062 6520 6c6f e GRUB can be lo │ │ │ │ │ +0003d410: 636b 6564 2064 6f77 6e20 7768 656e 2062 cked down when b │ │ │ │ │ +0003d420: 6f6f 7465 6420 6f6e 2061 2073 6563 7572 ooted on a secur │ │ │ │ │ +0003d430: 6520 626f 6f74 2065 6e76 6972 6f6e 6d65 e boot environme │ │ │ │ │ +0003d440: 6e74 2c0a 666f 7220 6578 616d 706c 6520 nt,.for example │ │ │ │ │ +0003d450: 6966 2074 6865 2055 4546 4920 7365 6375 if the UEFI secu │ │ │ │ │ +0003d460: 7265 2062 6f6f 7420 6973 2065 6e61 626c re boot is enabl │ │ │ │ │ +0003d470: 6564 2e20 204f 6e20 6120 6c6f 636b 6564 ed. On a locked │ │ │ │ │ +0003d480: 2064 6f77 6e0a 636f 6e66 6967 7572 6174 down.configurat │ │ │ │ │ +0003d490: 696f 6e2c 2074 6865 2047 5255 4220 7769 ion, the GRUB wi │ │ │ │ │ +0003d4a0: 6c6c 2062 6520 7265 7374 7269 6374 6564 ll be restricted │ │ │ │ │ +0003d4b0: 2061 6e64 2073 6f6d 6520 6f70 6572 6174 and some operat │ │ │ │ │ +0003d4c0: 696f 6e73 2f63 6f6d 6d61 6e64 730a 6361 ions/commands.ca │ │ │ │ │ +0003d4d0: 6e6e 6f74 2062 6520 6578 6563 7574 6564 nnot be executed │ │ │ │ │ +0003d4e0: 2e0a 0a20 2020 5468 6520 276c 6f63 6b64 ... The 'lockd │ │ │ │ │ +0003d4f0: 6f77 6e27 2076 6172 6961 626c 6520 6973 own' variable is │ │ │ │ │ +0003d500: 2073 6574 2074 6f20 2779 2720 7768 656e set to 'y' when │ │ │ │ │ +0003d510: 2074 6865 2047 5255 4220 6973 206c 6f63 the GRUB is loc │ │ │ │ │ +0003d520: 6b65 6420 646f 776e 2e0a 4f74 6865 7277 ked down..Otherw │ │ │ │ │ +0003d530: 6973 6520 6974 2064 6f65 7320 6e6f 7420 ise it does not │ │ │ │ │ +0003d540: 6578 6974 2e0a 0a1f 0a46 696c 653a 2067 exit.....File: g │ │ │ │ │ +0003d550: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ +0003d560: 2050 6c61 7466 6f72 6d20 6c69 6d69 7461 Platform limita │ │ │ │ │ +0003d570: 7469 6f6e 732c 2020 4e65 7874 3a20 506c tions, Next: Pl │ │ │ │ │ +0003d580: 6174 666f 726d 2d73 7065 6369 6669 6320 atform-specific │ │ │ │ │ +0003d590: 6f70 6572 6174 696f 6e73 2c20 2050 7265 operations, Pre │ │ │ │ │ +0003d5a0: 763a 2053 6563 7572 6974 792c 2020 5570 v: Security, Up │ │ │ │ │ +0003d5b0: 3a20 546f 700a 0a31 3920 506c 6174 666f : Top..19 Platfo │ │ │ │ │ +0003d5c0: 726d 206c 696d 6974 6174 696f 6e73 0a2a rm limitations.* │ │ │ │ │ 0003d5d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -0003d5e0: 2a2a 2a2a 0a0a 4752 5542 3220 6973 2064 ****..GRUB2 is d │ │ │ │ │ -0003d5f0: 6573 6967 6e65 6420 746f 2062 6520 706f esigned to be po │ │ │ │ │ -0003d600: 7274 6162 6c65 2061 6e64 2069 7320 6163 rtable and is ac │ │ │ │ │ -0003d610: 7475 616c 6c79 2070 6f72 7465 6420 6163 tually ported ac │ │ │ │ │ -0003d620: 726f 7373 0a70 6c61 7466 6f72 6d73 2e20 ross.platforms. │ │ │ │ │ -0003d630: 2057 6520 7472 7920 746f 206b 6565 7020 We try to keep │ │ │ │ │ -0003d640: 616c 6c20 706c 6174 666f 726d 7320 6174 all platforms at │ │ │ │ │ -0003d650: 2074 6865 206c 6576 656c 2e20 2055 6e66 the level. Unf │ │ │ │ │ -0003d660: 6f72 7475 6e61 7465 6c79 0a73 6f6d 6520 ortunately.some │ │ │ │ │ -0003d670: 706c 6174 666f 726d 7320 6172 6520 6265 platforms are be │ │ │ │ │ -0003d680: 7474 6572 2073 7570 706f 7274 6564 2074 tter supported t │ │ │ │ │ -0003d690: 6861 6e20 6f74 6865 7273 2e20 2054 6869 han others. Thi │ │ │ │ │ -0003d6a0: 7320 6973 2064 6574 6169 6c65 6420 696e s is detailed in │ │ │ │ │ -0003d6b0: 0a63 7572 7265 6e74 2061 6e64 2032 2066 .current and 2 f │ │ │ │ │ -0003d6c0: 6f6c 6c6f 7769 6e67 2073 6563 7469 6f6e ollowing section │ │ │ │ │ -0003d6d0: 732e 0a0a 2020 2041 6c6c 2070 6c61 7466 s... All platf │ │ │ │ │ -0003d6e0: 6f72 6d73 2068 6176 6520 616e 2061 7274 orms have an art │ │ │ │ │ -0003d6f0: 6966 6963 6961 6c6c 7920 4752 5542 2069 ificially GRUB i │ │ │ │ │ -0003d700: 6d70 6f73 6564 2064 6973 6b20 7369 7a65 mposed disk size │ │ │ │ │ -0003d710: 2072 6573 7472 6963 7469 6f6e 0a6f 6620 restriction.of │ │ │ │ │ -0003d720: 3120 4569 422e 2049 6e20 736f 6d65 2063 1 EiB. In some c │ │ │ │ │ -0003d730: 6173 6573 2c20 6c61 7267 6572 2064 6973 ases, larger dis │ │ │ │ │ -0003d740: 6b20 7369 7a65 7320 6361 6e20 6265 2075 k sizes can be u │ │ │ │ │ -0003d750: 7365 642c 2062 7574 2061 6363 6573 7320 sed, but access │ │ │ │ │ -0003d760: 7769 6c6c 0a6e 6f74 2062 6520 616c 6c6f will.not be allo │ │ │ │ │ -0003d770: 7765 6420 6265 796f 6e64 2031 2045 6942 wed beyond 1 EiB │ │ │ │ │ -0003d780: 2e0a 0a20 2020 4c55 4b53 3220 6465 7669 ... LUKS2 devi │ │ │ │ │ -0003d790: 6365 7320 7769 7468 2073 697a 6520 6c61 ces with size la │ │ │ │ │ -0003d7a0: 7267 6572 2074 6861 6e20 3136 2045 6942 rger than 16 EiB │ │ │ │ │ -0003d7b0: 2061 7265 2063 7572 7265 6e74 6c79 206e are currently n │ │ │ │ │ -0003d7c0: 6f74 0a73 7570 706f 7274 6564 2e20 2054 ot.supported. T │ │ │ │ │ -0003d7d0: 6865 7920 6361 6e20 6e6f 7420 6265 2063 hey can not be c │ │ │ │ │ -0003d7e0: 7265 6174 6564 2061 7320 6372 7970 746f reated as crypto │ │ │ │ │ -0003d7f0: 2064 6576 6963 6573 2062 7920 6372 7970 devices by cryp │ │ │ │ │ -0003d800: 746f 6d6f 756e 742c 2073 6f0a 6361 6e20 tomount, so.can │ │ │ │ │ -0003d810: 6e6f 7420 6576 656e 2062 6520 7061 7274 not even be part │ │ │ │ │ -0003d820: 6961 6c6c 7920 7265 6164 2066 726f 6d2e ially read from. │ │ │ │ │ -0003d830: 2020 4c55 4b53 2068 6176 6520 6e6f 206c LUKS have no l │ │ │ │ │ -0003d840: 696d 6974 6174 696f 6e73 206f 7468 6572 imitations other │ │ │ │ │ -0003d850: 0a74 6861 6e20 7468 6f73 6520 696d 706f .than those impo │ │ │ │ │ -0003d860: 7365 6420 6279 2074 6865 2066 6f72 6d61 sed by the forma │ │ │ │ │ -0003d870: 742e 0a0a 2020 2041 5243 2070 6c61 7466 t... ARC platf │ │ │ │ │ -0003d880: 6f72 6d20 6973 2075 6e61 626c 6520 746f orm is unable to │ │ │ │ │ -0003d890: 2063 6861 6e67 6520 6461 7465 7469 6d65 change datetime │ │ │ │ │ -0003d8a0: 2028 6669 726d 7761 7265 2064 6f65 736e (firmware doesn │ │ │ │ │ -0003d8b0: 2774 2073 6565 6d20 746f 0a70 726f 7669 't seem to.provi │ │ │ │ │ -0003d8c0: 6465 2061 2066 756e 6374 696f 6e20 666f de a function fo │ │ │ │ │ -0003d8d0: 7220 6974 292e 2020 454d 5520 6861 7320 r it). EMU has │ │ │ │ │ -0003d8e0: 7369 6d69 6c61 7220 6c69 6d69 7461 7469 similar limitati │ │ │ │ │ -0003d8f0: 6f6e 2e0a 0a20 2020 4f6e 2045 4d55 2070 on... On EMU p │ │ │ │ │ -0003d900: 6c61 7466 6f72 6d20 6e6f 2073 6572 6961 latform no seria │ │ │ │ │ -0003d910: 6c20 706f 7274 2069 7320 6176 6169 6c61 l port is availa │ │ │ │ │ -0003d920: 626c 652e 0a0a 2020 2043 6f6e 736f 6c65 ble... Console │ │ │ │ │ -0003d930: 2063 6861 7273 6574 2072 6566 6572 7320 charset refers │ │ │ │ │ -0003d940: 6f6e 6c79 2074 6f20 6669 726d 7761 7265 only to firmware │ │ │ │ │ -0003d950: 2d61 7373 6973 7465 6420 636f 6e73 6f6c -assisted consol │ │ │ │ │ -0003d960: 652e 2020 6766 7874 6572 6d20 6973 0a61 e. gfxterm is.a │ │ │ │ │ -0003d970: 6c77 6179 7320 556e 6963 6f64 6520 2873 lways Unicode (s │ │ │ │ │ -0003d980: 6565 2049 6e74 6572 6e61 7469 6f6e 616c ee International │ │ │ │ │ -0003d990: 6973 6174 696f 6e20 7365 6374 696f 6e20 isation section │ │ │ │ │ -0003d9a0: 666f 7220 6974 7320 6c69 6d69 7461 7469 for its limitati │ │ │ │ │ -0003d9b0: 6f6e 7329 2e0a 5365 7269 616c 2069 7320 ons)..Serial is │ │ │ │ │ -0003d9c0: 636f 6e66 6967 7572 6162 6c65 2074 6f20 configurable to │ │ │ │ │ -0003d9d0: 5554 462d 3820 6f72 2041 5343 4949 2028 UTF-8 or ASCII ( │ │ │ │ │ -0003d9e0: 7365 6520 496e 7465 726e 6174 696f 6e61 see Internationa │ │ │ │ │ -0003d9f0: 6c69 7361 7469 6f6e 292e 2020 496e 0a63 lisation). In.c │ │ │ │ │ -0003da00: 6173 6520 6f66 2071 656d 7520 616e 6420 ase of qemu and │ │ │ │ │ -0003da10: 636f 7265 626f 6f74 2070 6f72 7473 2074 coreboot ports t │ │ │ │ │ -0003da20: 6865 2072 6566 6572 6564 2063 6f6e 736f he refered conso │ │ │ │ │ -0003da30: 6c65 2069 7320 7667 615f 7465 7874 2e0a le is vga_text.. │ │ │ │ │ -0003da40: 4c6f 6f6e 6773 6f6e 2061 6c77 6179 7320 Loongson always │ │ │ │ │ -0003da50: 7573 6573 2067 6678 7465 726d 2e0a 0a20 uses gfxterm... │ │ │ │ │ -0003da60: 2020 4d6f 7374 206c 696d 6974 6564 206f Most limited o │ │ │ │ │ -0003da70: 6e65 2069 7320 4153 4349 492e 2043 5034 ne is ASCII. CP4 │ │ │ │ │ -0003da80: 3337 2070 726f 7669 6465 7320 6164 6469 37 provides addi │ │ │ │ │ -0003da90: 7469 6f6e 616c 6c79 0a70 7365 7564 6f67 tionally.pseudog │ │ │ │ │ -0003daa0: 7261 7068 6963 732e 2020 4752 5542 3220 raphics. GRUB2 │ │ │ │ │ -0003dab0: 646f 6573 6e27 7420 7573 6520 616e 7920 doesn't use any │ │ │ │ │ -0003dac0: 6c61 6e67 7561 6765 2063 6861 7261 6374 language charact │ │ │ │ │ -0003dad0: 6572 7320 6672 6f6d 2043 5034 3337 2061 ers from CP437 a │ │ │ │ │ -0003dae0: 730a 6f66 7465 6e20 4350 3433 3720 6973 s.often CP437 is │ │ │ │ │ -0003daf0: 2072 6570 6c61 6365 6420 6279 206e 6174 replaced by nat │ │ │ │ │ -0003db00: 696f 6e61 6c20 656e 636f 6469 6e67 2063 ional encoding c │ │ │ │ │ -0003db10: 6f6d 7061 7469 626c 6520 6f6e 6c79 2069 ompatible only i │ │ │ │ │ -0003db20: 6e0a 7073 6575 646f 6772 6170 6869 6373 n.pseudographics │ │ │ │ │ -0003db30: 2e20 2055 6e69 636f 6465 2069 7320 7468 . Unicode is th │ │ │ │ │ -0003db40: 6520 6d6f 7374 2076 6572 7361 7469 6c65 e most versatile │ │ │ │ │ -0003db50: 2063 6861 7273 6574 2077 6869 6368 2073 charset which s │ │ │ │ │ -0003db60: 7570 706f 7274 730a 6d61 6e79 206c 616e upports.many lan │ │ │ │ │ -0003db70: 6775 6167 6573 2e20 2048 6f77 6576 6572 guages. However │ │ │ │ │ -0003db80: 2074 6865 2061 6374 7561 6c20 636f 6e73 the actual cons │ │ │ │ │ -0003db90: 6f6c 6520 6d61 7920 6265 206d 7563 6820 ole may be much │ │ │ │ │ -0003dba0: 6d6f 7265 206c 696d 6974 6564 0a64 6570 more limited.dep │ │ │ │ │ -0003dbb0: 656e 6469 6e67 206f 6e20 6669 726d 7761 ending on firmwa │ │ │ │ │ -0003dbc0: 7265 0a0a 2020 204f 6e20 4249 4f53 2c20 re.. On BIOS, │ │ │ │ │ -0003dbd0: 6e65 7477 6f72 6b20 6973 2073 7570 706f network is suppo │ │ │ │ │ -0003dbe0: 7274 6564 206f 6e6c 7920 6966 2074 6865 rted only if the │ │ │ │ │ -0003dbf0: 2069 6d61 6765 2069 7320 6c6f 6164 6564 image is loaded │ │ │ │ │ -0003dc00: 2074 6872 6f75 6768 0a6e 6574 776f 726b through.network │ │ │ │ │ -0003dc10: 2e20 204f 6e20 7370 6172 6336 342c 2047 . On sparc64, G │ │ │ │ │ -0003dc20: 5255 4220 6973 2075 6e61 626c 6520 746f RUB is unable to │ │ │ │ │ -0003dc30: 2064 6574 6572 6d69 6e65 2077 6869 6368 determine which │ │ │ │ │ -0003dc40: 2073 6572 7665 7220 6974 2077 6173 0a62 server it was.b │ │ │ │ │ -0003dc50: 6f6f 7465 6420 6672 6f6d 2e0a 0a20 2020 ooted from... │ │ │ │ │ -0003dc60: 4469 7265 6374 2041 5441 2f41 4843 4920 Direct ATA/AHCI │ │ │ │ │ -0003dc70: 7375 7070 6f72 7420 616c 6c6f 7773 2074 support allows t │ │ │ │ │ -0003dc80: 6f20 6369 7263 756d 7665 6e74 2076 6172 o circumvent var │ │ │ │ │ -0003dc90: 696f 7573 2066 6972 6d77 6172 650a 6c69 ious firmware.li │ │ │ │ │ -0003dca0: 6d69 7461 7469 6f6e 7320 6275 7420 6973 mitations but is │ │ │ │ │ -0003dcb0: 6e27 7420 6e65 6564 6564 2066 6f72 206e n't needed for n │ │ │ │ │ -0003dcc0: 6f72 6d61 6c20 6f70 6572 6174 696f 6e20 ormal operation │ │ │ │ │ -0003dcd0: 6578 6365 7074 206f 6e20 6261 7265 6d65 except on bareme │ │ │ │ │ -0003dce0: 7461 6c0a 706f 7274 732e 0a0a 2020 2041 tal.ports... A │ │ │ │ │ -0003dcf0: 5420 6b65 7962 6f61 7264 2073 7570 706f T keyboard suppo │ │ │ │ │ -0003dd00: 7274 2061 6c6c 6f77 7320 6b65 7962 6f61 rt allows keyboa │ │ │ │ │ -0003dd10: 7264 206c 6179 6f75 7420 7265 6d61 7070 rd layout remapp │ │ │ │ │ -0003dd20: 696e 6720 616e 6420 7375 7070 6f72 7420 ing and support │ │ │ │ │ -0003dd30: 666f 720a 6b65 7973 206e 6f74 2061 7661 for.keys not ava │ │ │ │ │ -0003dd40: 696c 6162 6c65 2074 6872 6f75 6768 2066 ilable through f │ │ │ │ │ -0003dd50: 6972 6d77 6172 652e 2020 4974 2069 736e irmware. It isn │ │ │ │ │ -0003dd60: 2774 206e 6565 6465 6420 666f 7220 6e6f 't needed for no │ │ │ │ │ -0003dd70: 726d 616c 0a6f 7065 7261 7469 6f6e 2065 rmal.operation e │ │ │ │ │ -0003dd80: 7863 6570 7420 6261 7265 6d65 7461 6c20 xcept baremetal │ │ │ │ │ -0003dd90: 706f 7274 732e 0a0a 2020 2053 7065 616b ports... Speak │ │ │ │ │ -0003dda0: 6572 2061 6c6c 6f77 7320 6d6f 7273 6520 er allows morse │ │ │ │ │ -0003ddb0: 616e 6420 7370 6b6d 6f64 656d 2063 6f6d and spkmodem com │ │ │ │ │ -0003ddc0: 6d75 6e69 6361 7469 6f6e 2e0a 0a20 2020 munication... │ │ │ │ │ -0003ddd0: 5553 4220 7375 7070 6f72 7420 7072 6f76 USB support prov │ │ │ │ │ -0003dde0: 6964 6573 2062 656e 6566 6974 7320 7369 ides benefits si │ │ │ │ │ -0003ddf0: 6d69 6c61 7220 746f 2041 5441 2028 666f milar to ATA (fo │ │ │ │ │ -0003de00: 7220 5553 4220 6469 736b 7329 206f 7220 r USB disks) or │ │ │ │ │ -0003de10: 4154 0a28 666f 7220 5553 4220 6b65 7962 AT.(for USB keyb │ │ │ │ │ -0003de20: 6f61 7264 7329 2e20 2049 6e20 6164 6469 oards). In addi │ │ │ │ │ -0003de30: 7469 6f6e 2069 7420 616c 6c6f 7773 2055 tion it allows U │ │ │ │ │ -0003de40: 5342 7365 7269 616c 2e0a 0a20 2020 4368 SBserial... Ch │ │ │ │ │ -0003de50: 6169 6e6c 6f61 6469 6e67 2072 6566 6572 ainloading refer │ │ │ │ │ -0003de60: 7320 746f 2074 6865 2061 6269 6c69 7479 s to the ability │ │ │ │ │ -0003de70: 2074 6f20 6c6f 6164 2061 6e6f 7468 6572 to load another │ │ │ │ │ -0003de80: 2062 6f6f 746c 6f61 6465 7220 7468 726f bootloader thro │ │ │ │ │ -0003de90: 7567 680a 7468 6520 7361 6d65 2070 726f ugh.the same pro │ │ │ │ │ -0003dea0: 746f 636f 6c0a 0a20 2020 4869 6e74 7320 tocol.. Hints │ │ │ │ │ -0003deb0: 616c 6c6f 7720 6661 7374 6572 2064 6973 allow faster dis │ │ │ │ │ -0003dec0: 6b20 6469 7363 6f76 6572 7920 6279 2061 k discovery by a │ │ │ │ │ -0003ded0: 6c72 6561 6479 206b 6e6f 7769 6e67 2069 lready knowing i │ │ │ │ │ -0003dee0: 6e20 6164 7661 6e63 6520 7768 6963 680a n advance which. │ │ │ │ │ -0003def0: 6973 2074 6865 2064 6973 6b20 696e 2071 is the disk in q │ │ │ │ │ -0003df00: 7565 7374 696f 6e2e 2020 4f6e 2073 6f6d uestion. On som │ │ │ │ │ -0003df10: 6520 706c 6174 666f 726d 7320 6869 6e74 e platforms hint │ │ │ │ │ -0003df20: 7320 6172 6520 636f 7272 6563 7420 756e s are correct un │ │ │ │ │ -0003df30: 6c65 7373 2079 6f75 0a6d 6f76 6520 7468 less you.move th │ │ │ │ │ -0003df40: 6520 6469 736b 2062 6574 7765 656e 2062 e disk between b │ │ │ │ │ -0003df50: 6f6f 7473 2e20 204f 6e20 6f74 6865 7220 oots. On other │ │ │ │ │ -0003df60: 706c 6174 666f 726d 7320 6974 2773 206a platforms it's j │ │ │ │ │ -0003df70: 7573 7420 616e 2065 6475 6361 7465 640a ust an educated. │ │ │ │ │ -0003df80: 6775 6573 732e 2020 4e6f 7465 2074 6861 guess. Note tha │ │ │ │ │ -0003df90: 7420 6869 6e74 2066 6169 6c75 7265 2072 t hint failure r │ │ │ │ │ -0003dfa0: 6573 756c 7473 2069 6e20 6a75 7374 2072 esults in just r │ │ │ │ │ -0003dfb0: 6564 7563 6564 2070 6572 666f 726d 616e educed performan │ │ │ │ │ -0003dfc0: 6365 2c20 6e6f 740a 6120 6661 696c 7572 ce, not.a failur │ │ │ │ │ -0003dfd0: 650a 0a20 2020 4261 6452 414d 2069 7320 e.. BadRAM is │ │ │ │ │ -0003dfe0: 7468 6520 6162 696c 6974 7920 746f 206d the ability to m │ │ │ │ │ -0003dff0: 6172 6b20 736f 6d65 206f 6620 7468 6520 ark some of the │ │ │ │ │ -0003e000: 5241 4d20 6173 2022 6261 6422 2e20 204e RAM as "bad". N │ │ │ │ │ -0003e010: 6f74 653a 2064 7565 2074 6f0a 7072 6f74 ote: due to.prot │ │ │ │ │ -0003e020: 6f63 6f6c 206c 696d 6974 6174 696f 6e73 ocol limitations │ │ │ │ │ -0003e030: 206d 6970 732d 6c6f 6f6e 6773 6f6e 2028 mips-loongson ( │ │ │ │ │ -0003e040: 7769 7468 204c 696e 7578 2070 726f 746f with Linux proto │ │ │ │ │ -0003e050: 636f 6c29 2061 6e64 0a6d 6970 732d 7165 col) and.mips-qe │ │ │ │ │ -0003e060: 6d75 5f6d 6970 7320 6361 6e20 7573 6520 mu_mips can use │ │ │ │ │ -0003e070: 6f6e 6c79 206d 656d 6f72 7920 7570 2074 only memory up t │ │ │ │ │ -0003e080: 6f20 6669 7273 7420 686f 6c65 2e0a 0a20 o first hole... │ │ │ │ │ -0003e090: 2020 426f 6f74 6c6f 6361 7469 6f6e 2069 Bootlocation i │ │ │ │ │ -0003e0a0: 7320 6162 696c 6974 7920 6f66 2047 5255 s ability of GRU │ │ │ │ │ -0003e0b0: 4220 746f 2061 7574 6f6d 6174 6963 616c B to automatical │ │ │ │ │ -0003e0c0: 6c79 2064 6574 6563 7420 7768 6572 6520 ly detect where │ │ │ │ │ -0003e0d0: 6974 0a62 6f6f 7473 2066 726f 6d2e 2020 it.boots from. │ │ │ │ │ -0003e0e0: 2264 6973 6b22 206d 6561 6e73 2074 6865 "disk" means the │ │ │ │ │ -0003e0f0: 2064 6574 6563 7469 6f6e 2069 7320 6c69 detection is li │ │ │ │ │ -0003e100: 6d69 7465 6420 746f 2064 6574 6563 7469 mited to detecti │ │ │ │ │ -0003e110: 6e67 2074 6865 2064 6973 6b0a 7769 7468 ng the disk.with │ │ │ │ │ -0003e120: 2070 6172 7469 7469 6f6e 2062 6569 6e67 partition being │ │ │ │ │ -0003e130: 2064 6973 636f 7665 7265 6420 6f6e 2069 discovered on i │ │ │ │ │ -0003e140: 6e73 7461 6c6c 2074 696d 652e 2020 2270 nstall time. "p │ │ │ │ │ -0003e150: 6172 7469 7469 6f6e 2220 6d65 616e 7320 artition" means │ │ │ │ │ -0003e160: 7468 6174 0a64 6973 6b20 616e 6420 7061 that.disk and pa │ │ │ │ │ -0003e170: 7274 6974 6f6e 2063 616e 2062 6520 6175 rtiton can be au │ │ │ │ │ -0003e180: 746f 6d61 7469 6361 6c6c 7920 6469 7363 tomatically disc │ │ │ │ │ -0003e190: 6f76 6572 6564 2e20 2022 6669 6c65 2220 overed. "file" │ │ │ │ │ -0003e1a0: 6d65 616e 7320 7468 6174 0a62 6f6f 7420 means that.boot │ │ │ │ │ -0003e1b0: 696d 6167 6520 6669 6c65 206e 616d 6520 image file name │ │ │ │ │ -0003e1c0: 6173 2077 656c 6c20 6173 2064 6973 6b20 as well as disk │ │ │ │ │ -0003e1d0: 616e 6420 7061 7274 6974 696f 6e20 6361 and partition ca │ │ │ │ │ -0003e1e0: 6e20 6265 2064 6973 636f 7665 7265 642e n be discovered. │ │ │ │ │ -0003e1f0: 0a46 6f72 2063 6f6e 7369 7374 656e 6379 .For consistency │ │ │ │ │ -0003e200: 2c20 6465 6661 756c 7420 696e 7374 616c , default instal │ │ │ │ │ -0003e210: 6c20 6967 6e6f 7265 7320 7061 7274 6974 l ignores partit │ │ │ │ │ -0003e220: 696f 6e20 616e 6420 7265 6c69 6573 2073 ion and relies s │ │ │ │ │ -0003e230: 6f6c 656c 7920 6f6e 0a64 6973 6b20 6465 olely on.disk de │ │ │ │ │ -0003e240: 7465 6374 696f 6e2e 2020 4966 206e 6f20 tection. If no │ │ │ │ │ -0003e250: 626f 6f74 6c6f 6361 7469 6f6e 2064 6973 bootlocation dis │ │ │ │ │ -0003e260: 636f 7665 7279 2069 7320 6176 6169 6c61 covery is availa │ │ │ │ │ -0003e270: 626c 6520 6f72 2062 6f6f 7420 616e 640a ble or boot and. │ │ │ │ │ -0003e280: 6772 7562 2d72 6f6f 7420 6469 736b 7320 grub-root disks │ │ │ │ │ -0003e290: 6172 6520 6469 6666 6572 656e 742c 2055 are different, U │ │ │ │ │ -0003e2a0: 5549 4420 6973 2075 7365 6420 696e 7374 UID is used inst │ │ │ │ │ -0003e2b0: 6561 642e 2020 4f6e 2041 5243 2069 6620 ead. On ARC if │ │ │ │ │ -0003e2c0: 6e6f 0a64 6576 6963 6520 746f 2069 6e73 no.device to ins │ │ │ │ │ -0003e2d0: 7461 6c6c 2074 6f20 6973 2073 7065 6369 tall to is speci │ │ │ │ │ -0003e2e0: 6669 6564 2c20 5555 4944 2069 7320 7573 fied, UUID is us │ │ │ │ │ -0003e2f0: 6564 2069 6e73 7465 6164 2061 7320 7765 ed instead as we │ │ │ │ │ -0003e300: 6c6c 2e0a 0a20 2020 2020 2020 2020 2020 ll... │ │ │ │ │ -0003e310: 2020 2020 4249 4f53 2020 2020 2020 2020 BIOS │ │ │ │ │ -0003e320: 2020 2043 6f72 6562 6f6f 7420 2020 2020 Coreboot │ │ │ │ │ -0003e330: 2020 4d75 6c74 6962 6f6f 7420 2020 2020 Multiboot │ │ │ │ │ -0003e340: 2051 656d 750a 7669 6465 6f20 2020 2020 Qemu.video │ │ │ │ │ -0003e350: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ -0003e360: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ -0003e370: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e380: 2020 7965 730a 636f 6e73 6f6c 6520 2020 yes.console │ │ │ │ │ -0003e390: 2020 2020 2043 5034 3337 2020 2020 2020 CP437 │ │ │ │ │ -0003e3a0: 2020 2020 4350 3433 3720 2020 2020 2020 CP437 │ │ │ │ │ -0003e3b0: 2020 2043 5034 3337 2020 2020 2020 2020 CP437 │ │ │ │ │ -0003e3c0: 2020 4350 3433 370a 6368 6172 7365 740a CP437.charset. │ │ │ │ │ -0003e3d0: 6e65 7477 6f72 6b20 2020 2020 2020 2079 network y │ │ │ │ │ -0003e3e0: 6573 2028 2a29 2020 2020 2020 2020 6e6f es (*) no │ │ │ │ │ -0003e3f0: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ -0003e400: 2020 2020 2020 2020 2020 2020 6e6f 0a41 no.A │ │ │ │ │ -0003e410: 5441 2f41 4843 4920 2020 2020 2020 7965 TA/AHCI ye │ │ │ │ │ -0003e420: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ -0003e430: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003e440: 2020 2020 2020 2020 2020 2079 6573 0a41 yes.A │ │ │ │ │ -0003e450: 5420 6b65 7962 6f61 7264 2020 2020 7965 T keyboard ye │ │ │ │ │ -0003e460: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ -0003e470: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003e480: 2020 2020 2020 2020 2020 2079 6573 0a53 yes.S │ │ │ │ │ -0003e490: 7065 616b 6572 2020 2020 2020 2020 7965 peaker ye │ │ │ │ │ -0003e4a0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ -0003e4b0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003e4c0: 2020 2020 2020 2020 2020 2079 6573 0a55 yes.U │ │ │ │ │ -0003e4d0: 5342 2020 2020 2020 2020 2020 2020 7965 SB ye │ │ │ │ │ -0003e4e0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ -0003e4f0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003e500: 2020 2020 2020 2020 2020 2079 6573 0a63 yes.c │ │ │ │ │ -0003e510: 6861 696e 6c6f 6164 6572 2020 2020 6c6f hainloader lo │ │ │ │ │ -0003e520: 6361 6c20 2020 2020 2020 2020 2079 6573 cal yes │ │ │ │ │ -0003e530: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003e540: 2020 2020 2020 2020 2020 206e 6f0a 6370 no.cp │ │ │ │ │ -0003e550: 7569 6420 2020 2020 2020 2020 2070 6172 uid par │ │ │ │ │ -0003e560: 7469 616c 2020 2020 2020 2020 7061 7274 tial part │ │ │ │ │ -0003e570: 6961 6c20 2020 2020 2020 2070 6172 7469 ial parti │ │ │ │ │ -0003e580: 616c 2020 2020 2020 2020 7061 7274 6961 al partia │ │ │ │ │ -0003e590: 6c0a 7264 6d73 7220 2020 2020 2020 2020 l.rdmsr │ │ │ │ │ -0003e5a0: 2070 6172 7469 616c 2020 2020 2020 2020 partial │ │ │ │ │ -0003e5b0: 7061 7274 6961 6c20 2020 2020 2020 2070 partial p │ │ │ │ │ -0003e5c0: 6172 7469 616c 2020 2020 2020 2020 7061 artial pa │ │ │ │ │ -0003e5d0: 7274 6961 6c0a 7772 6d73 7220 2020 2020 rtial.wrmsr │ │ │ │ │ -0003e5e0: 2020 2020 2070 6172 7469 616c 2020 2020 partial │ │ │ │ │ -0003e5f0: 2020 2020 7061 7274 6961 6c20 2020 2020 partial │ │ │ │ │ -0003e600: 2020 2070 6172 7469 616c 2020 2020 2020 partial │ │ │ │ │ -0003e610: 2020 7061 7274 6961 6c0a 6869 6e74 7320 partial.hints │ │ │ │ │ -0003e620: 2020 2020 2020 2020 2067 7565 7373 2020 guess │ │ │ │ │ -0003e630: 2020 2020 2020 2020 6775 6573 7320 2020 guess │ │ │ │ │ -0003e640: 2020 2020 2020 2067 7565 7373 2020 2020 guess │ │ │ │ │ -0003e650: 2020 2020 2020 6775 6573 730a 5043 4920 guess.PCI │ │ │ │ │ -0003e660: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ -0003e670: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ -0003e680: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -0003e690: 2020 2020 2020 2020 7965 730a 6261 6472 yes.badr │ │ │ │ │ -0003e6a0: 616d 2020 2020 2020 2020 2079 6573 2020 am yes │ │ │ │ │ -0003e6b0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ -0003e6c0: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -0003e6d0: 2020 2020 2020 2020 7965 730a 636f 6d70 yes.comp │ │ │ │ │ -0003e6e0: 7265 7373 696f 6e20 2020 2061 6c77 6179 ression alway │ │ │ │ │ -0003e6f0: 7320 2020 2020 2020 2020 706f 696e 746c s pointl │ │ │ │ │ -0003e700: 6573 7320 2020 2020 206e 6f20 2020 2020 ess no │ │ │ │ │ -0003e710: 2020 2020 2020 2020 6e6f 0a65 7869 7420 no.exit │ │ │ │ │ -0003e720: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ -0003e730: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ -0003e740: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ -0003e750: 2020 2020 2020 206e 6f0a 626f 6f74 6c6f no.bootlo │ │ │ │ │ -0003e760: 6361 7469 6f6e 2020 2064 6973 6b20 2020 cation disk │ │ │ │ │ -0003e770: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ -0003e780: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ -0003e790: 2020 2020 2020 6e6f 0a0a 2020 2020 2020 no.. │ │ │ │ │ -0003e7a0: 2020 2020 2020 2020 2069 6133 3220 4546 ia32 EF │ │ │ │ │ -0003e7b0: 4920 2020 2020 2020 616d 6436 3420 4546 I amd64 EF │ │ │ │ │ -0003e7c0: 4920 2020 2020 2069 6133 3220 2020 2020 I ia32 │ │ │ │ │ -0003e7d0: 2020 2020 2020 4974 616e 6975 6d0a 2020 Itanium. │ │ │ │ │ +0003d5e0: 2a2a 2a2a 2a2a 0a0a 4752 5542 3220 6973 ******..GRUB2 is │ │ │ │ │ +0003d5f0: 2064 6573 6967 6e65 6420 746f 2062 6520 designed to be │ │ │ │ │ +0003d600: 706f 7274 6162 6c65 2061 6e64 2069 7320 portable and is │ │ │ │ │ +0003d610: 6163 7475 616c 6c79 2070 6f72 7465 6420 actually ported │ │ │ │ │ +0003d620: 6163 726f 7373 0a70 6c61 7466 6f72 6d73 across.platforms │ │ │ │ │ +0003d630: 2e20 2057 6520 7472 7920 746f 206b 6565 . We try to kee │ │ │ │ │ +0003d640: 7020 616c 6c20 706c 6174 666f 726d 7320 p all platforms │ │ │ │ │ +0003d650: 6174 2074 6865 206c 6576 656c 2e20 2055 at the level. U │ │ │ │ │ +0003d660: 6e66 6f72 7475 6e61 7465 6c79 0a73 6f6d nfortunately.som │ │ │ │ │ +0003d670: 6520 706c 6174 666f 726d 7320 6172 6520 e platforms are │ │ │ │ │ +0003d680: 6265 7474 6572 2073 7570 706f 7274 6564 better supported │ │ │ │ │ +0003d690: 2074 6861 6e20 6f74 6865 7273 2e20 2054 than others. T │ │ │ │ │ +0003d6a0: 6869 7320 6973 2064 6574 6169 6c65 6420 his is detailed │ │ │ │ │ +0003d6b0: 696e 0a63 7572 7265 6e74 2061 6e64 2032 in.current and 2 │ │ │ │ │ +0003d6c0: 2066 6f6c 6c6f 7769 6e67 2073 6563 7469 following secti │ │ │ │ │ +0003d6d0: 6f6e 732e 0a0a 2020 2041 6c6c 2070 6c61 ons... All pla │ │ │ │ │ +0003d6e0: 7466 6f72 6d73 2068 6176 6520 616e 2061 tforms have an a │ │ │ │ │ +0003d6f0: 7274 6966 6963 6961 6c6c 7920 4752 5542 rtificially GRUB │ │ │ │ │ +0003d700: 2069 6d70 6f73 6564 2064 6973 6b20 7369 imposed disk si │ │ │ │ │ +0003d710: 7a65 2072 6573 7472 6963 7469 6f6e 0a6f ze restriction.o │ │ │ │ │ +0003d720: 6620 3120 4569 422e 2049 6e20 736f 6d65 f 1 EiB. In some │ │ │ │ │ +0003d730: 2063 6173 6573 2c20 6c61 7267 6572 2064 cases, larger d │ │ │ │ │ +0003d740: 6973 6b20 7369 7a65 7320 6361 6e20 6265 isk sizes can be │ │ │ │ │ +0003d750: 2075 7365 642c 2062 7574 2061 6363 6573 used, but acces │ │ │ │ │ +0003d760: 7320 7769 6c6c 0a6e 6f74 2062 6520 616c s will.not be al │ │ │ │ │ +0003d770: 6c6f 7765 6420 6265 796f 6e64 2031 2045 lowed beyond 1 E │ │ │ │ │ +0003d780: 6942 2e0a 0a20 2020 4c55 4b53 3220 6465 iB... LUKS2 de │ │ │ │ │ +0003d790: 7669 6365 7320 7769 7468 2073 697a 6520 vices with size │ │ │ │ │ +0003d7a0: 6c61 7267 6572 2074 6861 6e20 3136 2045 larger than 16 E │ │ │ │ │ +0003d7b0: 6942 2061 7265 2063 7572 7265 6e74 6c79 iB are currently │ │ │ │ │ +0003d7c0: 206e 6f74 0a73 7570 706f 7274 6564 2e20 not.supported. │ │ │ │ │ +0003d7d0: 2054 6865 7920 6361 6e20 6e6f 7420 6265 They can not be │ │ │ │ │ +0003d7e0: 2063 7265 6174 6564 2061 7320 6372 7970 created as cryp │ │ │ │ │ +0003d7f0: 746f 2064 6576 6963 6573 2062 7920 6372 to devices by cr │ │ │ │ │ +0003d800: 7970 746f 6d6f 756e 742c 2073 6f0a 6361 yptomount, so.ca │ │ │ │ │ +0003d810: 6e20 6e6f 7420 6576 656e 2062 6520 7061 n not even be pa │ │ │ │ │ +0003d820: 7274 6961 6c6c 7920 7265 6164 2066 726f rtially read fro │ │ │ │ │ +0003d830: 6d2e 2020 4c55 4b53 2068 6176 6520 6e6f m. LUKS have no │ │ │ │ │ +0003d840: 206c 696d 6974 6174 696f 6e73 206f 7468 limitations oth │ │ │ │ │ +0003d850: 6572 0a74 6861 6e20 7468 6f73 6520 696d er.than those im │ │ │ │ │ +0003d860: 706f 7365 6420 6279 2074 6865 2066 6f72 posed by the for │ │ │ │ │ +0003d870: 6d61 742e 0a0a 2020 2041 5243 2070 6c61 mat... ARC pla │ │ │ │ │ +0003d880: 7466 6f72 6d20 6973 2075 6e61 626c 6520 tform is unable │ │ │ │ │ +0003d890: 746f 2063 6861 6e67 6520 6461 7465 7469 to change dateti │ │ │ │ │ +0003d8a0: 6d65 2028 6669 726d 7761 7265 2064 6f65 me (firmware doe │ │ │ │ │ +0003d8b0: 736e 2774 2073 6565 6d20 746f 0a70 726f sn't seem to.pro │ │ │ │ │ +0003d8c0: 7669 6465 2061 2066 756e 6374 696f 6e20 vide a function │ │ │ │ │ +0003d8d0: 666f 7220 6974 292e 2020 454d 5520 6861 for it). EMU ha │ │ │ │ │ +0003d8e0: 7320 7369 6d69 6c61 7220 6c69 6d69 7461 s similar limita │ │ │ │ │ +0003d8f0: 7469 6f6e 2e0a 0a20 2020 4f6e 2045 4d55 tion... On EMU │ │ │ │ │ +0003d900: 2070 6c61 7466 6f72 6d20 6e6f 2073 6572 platform no ser │ │ │ │ │ +0003d910: 6961 6c20 706f 7274 2069 7320 6176 6169 ial port is avai │ │ │ │ │ +0003d920: 6c61 626c 652e 0a0a 2020 2043 6f6e 736f lable... Conso │ │ │ │ │ +0003d930: 6c65 2063 6861 7273 6574 2072 6566 6572 le charset refer │ │ │ │ │ +0003d940: 7320 6f6e 6c79 2074 6f20 6669 726d 7761 s only to firmwa │ │ │ │ │ +0003d950: 7265 2d61 7373 6973 7465 6420 636f 6e73 re-assisted cons │ │ │ │ │ +0003d960: 6f6c 652e 2020 6766 7874 6572 6d20 6973 ole. gfxterm is │ │ │ │ │ +0003d970: 0a61 6c77 6179 7320 556e 6963 6f64 6520 .always Unicode │ │ │ │ │ +0003d980: 2873 6565 2049 6e74 6572 6e61 7469 6f6e (see Internation │ │ │ │ │ +0003d990: 616c 6973 6174 696f 6e20 7365 6374 696f alisation sectio │ │ │ │ │ +0003d9a0: 6e20 666f 7220 6974 7320 6c69 6d69 7461 n for its limita │ │ │ │ │ +0003d9b0: 7469 6f6e 7329 2e0a 5365 7269 616c 2069 tions)..Serial i │ │ │ │ │ +0003d9c0: 7320 636f 6e66 6967 7572 6162 6c65 2074 s configurable t │ │ │ │ │ +0003d9d0: 6f20 5554 462d 3820 6f72 2041 5343 4949 o UTF-8 or ASCII │ │ │ │ │ +0003d9e0: 2028 7365 6520 496e 7465 726e 6174 696f (see Internatio │ │ │ │ │ +0003d9f0: 6e61 6c69 7361 7469 6f6e 292e 2020 496e nalisation). In │ │ │ │ │ +0003da00: 0a63 6173 6520 6f66 2071 656d 7520 616e .case of qemu an │ │ │ │ │ +0003da10: 6420 636f 7265 626f 6f74 2070 6f72 7473 d coreboot ports │ │ │ │ │ +0003da20: 2074 6865 2072 6566 6572 6564 2063 6f6e the refered con │ │ │ │ │ +0003da30: 736f 6c65 2069 7320 7667 615f 7465 7874 sole is vga_text │ │ │ │ │ +0003da40: 2e0a 4c6f 6f6e 6773 6f6e 2061 6c77 6179 ..Loongson alway │ │ │ │ │ +0003da50: 7320 7573 6573 2067 6678 7465 726d 2e0a s uses gfxterm.. │ │ │ │ │ +0003da60: 0a20 2020 4d6f 7374 206c 696d 6974 6564 . Most limited │ │ │ │ │ +0003da70: 206f 6e65 2069 7320 4153 4349 492e 2043 one is ASCII. C │ │ │ │ │ +0003da80: 5034 3337 2070 726f 7669 6465 7320 6164 P437 provides ad │ │ │ │ │ +0003da90: 6469 7469 6f6e 616c 6c79 0a70 7365 7564 ditionally.pseud │ │ │ │ │ +0003daa0: 6f67 7261 7068 6963 732e 2020 4752 5542 ographics. GRUB │ │ │ │ │ +0003dab0: 3220 646f 6573 6e27 7420 7573 6520 616e 2 doesn't use an │ │ │ │ │ +0003dac0: 7920 6c61 6e67 7561 6765 2063 6861 7261 y language chara │ │ │ │ │ +0003dad0: 6374 6572 7320 6672 6f6d 2043 5034 3337 cters from CP437 │ │ │ │ │ +0003dae0: 2061 730a 6f66 7465 6e20 4350 3433 3720 as.often CP437 │ │ │ │ │ +0003daf0: 6973 2072 6570 6c61 6365 6420 6279 206e is replaced by n │ │ │ │ │ +0003db00: 6174 696f 6e61 6c20 656e 636f 6469 6e67 ational encoding │ │ │ │ │ +0003db10: 2063 6f6d 7061 7469 626c 6520 6f6e 6c79 compatible only │ │ │ │ │ +0003db20: 2069 6e0a 7073 6575 646f 6772 6170 6869 in.pseudographi │ │ │ │ │ +0003db30: 6373 2e20 2055 6e69 636f 6465 2069 7320 cs. Unicode is │ │ │ │ │ +0003db40: 7468 6520 6d6f 7374 2076 6572 7361 7469 the most versati │ │ │ │ │ +0003db50: 6c65 2063 6861 7273 6574 2077 6869 6368 le charset which │ │ │ │ │ +0003db60: 2073 7570 706f 7274 730a 6d61 6e79 206c supports.many l │ │ │ │ │ +0003db70: 616e 6775 6167 6573 2e20 2048 6f77 6576 anguages. Howev │ │ │ │ │ +0003db80: 6572 2074 6865 2061 6374 7561 6c20 636f er the actual co │ │ │ │ │ +0003db90: 6e73 6f6c 6520 6d61 7920 6265 206d 7563 nsole may be muc │ │ │ │ │ +0003dba0: 6820 6d6f 7265 206c 696d 6974 6564 0a64 h more limited.d │ │ │ │ │ +0003dbb0: 6570 656e 6469 6e67 206f 6e20 6669 726d epending on firm │ │ │ │ │ +0003dbc0: 7761 7265 0a0a 2020 204f 6e20 4249 4f53 ware.. On BIOS │ │ │ │ │ +0003dbd0: 2c20 6e65 7477 6f72 6b20 6973 2073 7570 , network is sup │ │ │ │ │ +0003dbe0: 706f 7274 6564 206f 6e6c 7920 6966 2074 ported only if t │ │ │ │ │ +0003dbf0: 6865 2069 6d61 6765 2069 7320 6c6f 6164 he image is load │ │ │ │ │ +0003dc00: 6564 2074 6872 6f75 6768 0a6e 6574 776f ed through.netwo │ │ │ │ │ +0003dc10: 726b 2e20 204f 6e20 7370 6172 6336 342c rk. On sparc64, │ │ │ │ │ +0003dc20: 2047 5255 4220 6973 2075 6e61 626c 6520 GRUB is unable │ │ │ │ │ +0003dc30: 746f 2064 6574 6572 6d69 6e65 2077 6869 to determine whi │ │ │ │ │ +0003dc40: 6368 2073 6572 7665 7220 6974 2077 6173 ch server it was │ │ │ │ │ +0003dc50: 0a62 6f6f 7465 6420 6672 6f6d 2e0a 0a20 .booted from... │ │ │ │ │ +0003dc60: 2020 4469 7265 6374 2041 5441 2f41 4843 Direct ATA/AHC │ │ │ │ │ +0003dc70: 4920 7375 7070 6f72 7420 616c 6c6f 7773 I support allows │ │ │ │ │ +0003dc80: 2074 6f20 6369 7263 756d 7665 6e74 2076 to circumvent v │ │ │ │ │ +0003dc90: 6172 696f 7573 2066 6972 6d77 6172 650a arious firmware. │ │ │ │ │ +0003dca0: 6c69 6d69 7461 7469 6f6e 7320 6275 7420 limitations but │ │ │ │ │ +0003dcb0: 6973 6e27 7420 6e65 6564 6564 2066 6f72 isn't needed for │ │ │ │ │ +0003dcc0: 206e 6f72 6d61 6c20 6f70 6572 6174 696f normal operatio │ │ │ │ │ +0003dcd0: 6e20 6578 6365 7074 206f 6e20 6261 7265 n except on bare │ │ │ │ │ +0003dce0: 6d65 7461 6c0a 706f 7274 732e 0a0a 2020 metal.ports... │ │ │ │ │ +0003dcf0: 2041 5420 6b65 7962 6f61 7264 2073 7570 AT keyboard sup │ │ │ │ │ +0003dd00: 706f 7274 2061 6c6c 6f77 7320 6b65 7962 port allows keyb │ │ │ │ │ +0003dd10: 6f61 7264 206c 6179 6f75 7420 7265 6d61 oard layout rema │ │ │ │ │ +0003dd20: 7070 696e 6720 616e 6420 7375 7070 6f72 pping and suppor │ │ │ │ │ +0003dd30: 7420 666f 720a 6b65 7973 206e 6f74 2061 t for.keys not a │ │ │ │ │ +0003dd40: 7661 696c 6162 6c65 2074 6872 6f75 6768 vailable through │ │ │ │ │ +0003dd50: 2066 6972 6d77 6172 652e 2020 4974 2069 firmware. It i │ │ │ │ │ +0003dd60: 736e 2774 206e 6565 6465 6420 666f 7220 sn't needed for │ │ │ │ │ +0003dd70: 6e6f 726d 616c 0a6f 7065 7261 7469 6f6e normal.operation │ │ │ │ │ +0003dd80: 2065 7863 6570 7420 6261 7265 6d65 7461 except baremeta │ │ │ │ │ +0003dd90: 6c20 706f 7274 732e 0a0a 2020 2053 7065 l ports... Spe │ │ │ │ │ +0003dda0: 616b 6572 2061 6c6c 6f77 7320 6d6f 7273 aker allows mors │ │ │ │ │ +0003ddb0: 6520 616e 6420 7370 6b6d 6f64 656d 2063 e and spkmodem c │ │ │ │ │ +0003ddc0: 6f6d 6d75 6e69 6361 7469 6f6e 2e0a 0a20 ommunication... │ │ │ │ │ +0003ddd0: 2020 5553 4220 7375 7070 6f72 7420 7072 USB support pr │ │ │ │ │ +0003dde0: 6f76 6964 6573 2062 656e 6566 6974 7320 ovides benefits │ │ │ │ │ +0003ddf0: 7369 6d69 6c61 7220 746f 2041 5441 2028 similar to ATA ( │ │ │ │ │ +0003de00: 666f 7220 5553 4220 6469 736b 7329 206f for USB disks) o │ │ │ │ │ +0003de10: 7220 4154 0a28 666f 7220 5553 4220 6b65 r AT.(for USB ke │ │ │ │ │ +0003de20: 7962 6f61 7264 7329 2e20 2049 6e20 6164 yboards). In ad │ │ │ │ │ +0003de30: 6469 7469 6f6e 2069 7420 616c 6c6f 7773 dition it allows │ │ │ │ │ +0003de40: 2055 5342 7365 7269 616c 2e0a 0a20 2020 USBserial... │ │ │ │ │ +0003de50: 4368 6169 6e6c 6f61 6469 6e67 2072 6566 Chainloading ref │ │ │ │ │ +0003de60: 6572 7320 746f 2074 6865 2061 6269 6c69 ers to the abili │ │ │ │ │ +0003de70: 7479 2074 6f20 6c6f 6164 2061 6e6f 7468 ty to load anoth │ │ │ │ │ +0003de80: 6572 2062 6f6f 746c 6f61 6465 7220 7468 er bootloader th │ │ │ │ │ +0003de90: 726f 7567 680a 7468 6520 7361 6d65 2070 rough.the same p │ │ │ │ │ +0003dea0: 726f 746f 636f 6c0a 0a20 2020 4869 6e74 rotocol.. Hint │ │ │ │ │ +0003deb0: 7320 616c 6c6f 7720 6661 7374 6572 2064 s allow faster d │ │ │ │ │ +0003dec0: 6973 6b20 6469 7363 6f76 6572 7920 6279 isk discovery by │ │ │ │ │ +0003ded0: 2061 6c72 6561 6479 206b 6e6f 7769 6e67 already knowing │ │ │ │ │ +0003dee0: 2069 6e20 6164 7661 6e63 6520 7768 6963 in advance whic │ │ │ │ │ +0003def0: 680a 6973 2074 6865 2064 6973 6b20 696e h.is the disk in │ │ │ │ │ +0003df00: 2071 7565 7374 696f 6e2e 2020 4f6e 2073 question. On s │ │ │ │ │ +0003df10: 6f6d 6520 706c 6174 666f 726d 7320 6869 ome platforms hi │ │ │ │ │ +0003df20: 6e74 7320 6172 6520 636f 7272 6563 7420 nts are correct │ │ │ │ │ +0003df30: 756e 6c65 7373 2079 6f75 0a6d 6f76 6520 unless you.move │ │ │ │ │ +0003df40: 7468 6520 6469 736b 2062 6574 7765 656e the disk between │ │ │ │ │ +0003df50: 2062 6f6f 7473 2e20 204f 6e20 6f74 6865 boots. On othe │ │ │ │ │ +0003df60: 7220 706c 6174 666f 726d 7320 6974 2773 r platforms it's │ │ │ │ │ +0003df70: 206a 7573 7420 616e 2065 6475 6361 7465 just an educate │ │ │ │ │ +0003df80: 640a 6775 6573 732e 2020 4e6f 7465 2074 d.guess. Note t │ │ │ │ │ +0003df90: 6861 7420 6869 6e74 2066 6169 6c75 7265 hat hint failure │ │ │ │ │ +0003dfa0: 2072 6573 756c 7473 2069 6e20 6a75 7374 results in just │ │ │ │ │ +0003dfb0: 2072 6564 7563 6564 2070 6572 666f 726d reduced perform │ │ │ │ │ +0003dfc0: 616e 6365 2c20 6e6f 740a 6120 6661 696c ance, not.a fail │ │ │ │ │ +0003dfd0: 7572 650a 0a20 2020 4261 6452 414d 2069 ure.. BadRAM i │ │ │ │ │ +0003dfe0: 7320 7468 6520 6162 696c 6974 7920 746f s the ability to │ │ │ │ │ +0003dff0: 206d 6172 6b20 736f 6d65 206f 6620 7468 mark some of th │ │ │ │ │ +0003e000: 6520 5241 4d20 6173 2022 6261 6422 2e20 e RAM as "bad". │ │ │ │ │ +0003e010: 204e 6f74 653a 2064 7565 2074 6f0a 7072 Note: due to.pr │ │ │ │ │ +0003e020: 6f74 6f63 6f6c 206c 696d 6974 6174 696f otocol limitatio │ │ │ │ │ +0003e030: 6e73 206d 6970 732d 6c6f 6f6e 6773 6f6e ns mips-loongson │ │ │ │ │ +0003e040: 2028 7769 7468 204c 696e 7578 2070 726f (with Linux pro │ │ │ │ │ +0003e050: 746f 636f 6c29 2061 6e64 0a6d 6970 732d tocol) and.mips- │ │ │ │ │ +0003e060: 7165 6d75 5f6d 6970 7320 6361 6e20 7573 qemu_mips can us │ │ │ │ │ +0003e070: 6520 6f6e 6c79 206d 656d 6f72 7920 7570 e only memory up │ │ │ │ │ +0003e080: 2074 6f20 6669 7273 7420 686f 6c65 2e0a to first hole.. │ │ │ │ │ +0003e090: 0a20 2020 426f 6f74 6c6f 6361 7469 6f6e . Bootlocation │ │ │ │ │ +0003e0a0: 2069 7320 6162 696c 6974 7920 6f66 2047 is ability of G │ │ │ │ │ +0003e0b0: 5255 4220 746f 2061 7574 6f6d 6174 6963 RUB to automatic │ │ │ │ │ +0003e0c0: 616c 6c79 2064 6574 6563 7420 7768 6572 ally detect wher │ │ │ │ │ +0003e0d0: 6520 6974 0a62 6f6f 7473 2066 726f 6d2e e it.boots from. │ │ │ │ │ +0003e0e0: 2020 2264 6973 6b22 206d 6561 6e73 2074 "disk" means t │ │ │ │ │ +0003e0f0: 6865 2064 6574 6563 7469 6f6e 2069 7320 he detection is │ │ │ │ │ +0003e100: 6c69 6d69 7465 6420 746f 2064 6574 6563 limited to detec │ │ │ │ │ +0003e110: 7469 6e67 2074 6865 2064 6973 6b0a 7769 ting the disk.wi │ │ │ │ │ +0003e120: 7468 2070 6172 7469 7469 6f6e 2062 6569 th partition bei │ │ │ │ │ +0003e130: 6e67 2064 6973 636f 7665 7265 6420 6f6e ng discovered on │ │ │ │ │ +0003e140: 2069 6e73 7461 6c6c 2074 696d 652e 2020 install time. │ │ │ │ │ +0003e150: 2270 6172 7469 7469 6f6e 2220 6d65 616e "partition" mean │ │ │ │ │ +0003e160: 7320 7468 6174 0a64 6973 6b20 616e 6420 s that.disk and │ │ │ │ │ +0003e170: 7061 7274 6974 6f6e 2063 616e 2062 6520 partiton can be │ │ │ │ │ +0003e180: 6175 746f 6d61 7469 6361 6c6c 7920 6469 automatically di │ │ │ │ │ +0003e190: 7363 6f76 6572 6564 2e20 2022 6669 6c65 scovered. "file │ │ │ │ │ +0003e1a0: 2220 6d65 616e 7320 7468 6174 0a62 6f6f " means that.boo │ │ │ │ │ +0003e1b0: 7420 696d 6167 6520 6669 6c65 206e 616d t image file nam │ │ │ │ │ +0003e1c0: 6520 6173 2077 656c 6c20 6173 2064 6973 e as well as dis │ │ │ │ │ +0003e1d0: 6b20 616e 6420 7061 7274 6974 696f 6e20 k and partition │ │ │ │ │ +0003e1e0: 6361 6e20 6265 2064 6973 636f 7665 7265 can be discovere │ │ │ │ │ +0003e1f0: 642e 0a46 6f72 2063 6f6e 7369 7374 656e d..For consisten │ │ │ │ │ +0003e200: 6379 2c20 6465 6661 756c 7420 696e 7374 cy, default inst │ │ │ │ │ +0003e210: 616c 6c20 6967 6e6f 7265 7320 7061 7274 all ignores part │ │ │ │ │ +0003e220: 6974 696f 6e20 616e 6420 7265 6c69 6573 ition and relies │ │ │ │ │ +0003e230: 2073 6f6c 656c 7920 6f6e 0a64 6973 6b20 solely on.disk │ │ │ │ │ +0003e240: 6465 7465 6374 696f 6e2e 2020 4966 206e detection. If n │ │ │ │ │ +0003e250: 6f20 626f 6f74 6c6f 6361 7469 6f6e 2064 o bootlocation d │ │ │ │ │ +0003e260: 6973 636f 7665 7279 2069 7320 6176 6169 iscovery is avai │ │ │ │ │ +0003e270: 6c61 626c 6520 6f72 2062 6f6f 7420 616e lable or boot an │ │ │ │ │ +0003e280: 640a 6772 7562 2d72 6f6f 7420 6469 736b d.grub-root disk │ │ │ │ │ +0003e290: 7320 6172 6520 6469 6666 6572 656e 742c s are different, │ │ │ │ │ +0003e2a0: 2055 5549 4420 6973 2075 7365 6420 696e UUID is used in │ │ │ │ │ +0003e2b0: 7374 6561 642e 2020 4f6e 2041 5243 2069 stead. On ARC i │ │ │ │ │ +0003e2c0: 6620 6e6f 0a64 6576 6963 6520 746f 2069 f no.device to i │ │ │ │ │ +0003e2d0: 6e73 7461 6c6c 2074 6f20 6973 2073 7065 nstall to is spe │ │ │ │ │ +0003e2e0: 6369 6669 6564 2c20 5555 4944 2069 7320 cified, UUID is │ │ │ │ │ +0003e2f0: 7573 6564 2069 6e73 7465 6164 2061 7320 used instead as │ │ │ │ │ +0003e300: 7765 6c6c 2e0a 0a20 2020 2020 2020 2020 well... │ │ │ │ │ +0003e310: 2020 2020 2020 4249 4f53 2020 2020 2020 BIOS │ │ │ │ │ +0003e320: 2020 2020 2043 6f72 6562 6f6f 7420 2020 Coreboot │ │ │ │ │ +0003e330: 2020 2020 4d75 6c74 6962 6f6f 7420 2020 Multiboot │ │ │ │ │ +0003e340: 2020 2051 656d 750a 7669 6465 6f20 2020 Qemu.video │ │ │ │ │ +0003e350: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +0003e360: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ │ +0003e370: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +0003e380: 2020 2020 7965 730a 636f 6e73 6f6c 6520 yes.console │ │ │ │ │ +0003e390: 2020 2020 2020 2043 5034 3337 2020 2020 CP437 │ │ │ │ │ +0003e3a0: 2020 2020 2020 4350 3433 3720 2020 2020 CP437 │ │ │ │ │ +0003e3b0: 2020 2020 2043 5034 3337 2020 2020 2020 CP437 │ │ │ │ │ +0003e3c0: 2020 2020 4350 3433 370a 6368 6172 7365 CP437.charse │ │ │ │ │ +0003e3d0: 740a 6e65 7477 6f72 6b20 2020 2020 2020 t.network │ │ │ │ │ +0003e3e0: 2079 6573 2028 2a29 2020 2020 2020 2020 yes (*) │ │ │ │ │ +0003e3f0: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ │ +0003e400: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ +0003e410: 0a41 5441 2f41 4843 4920 2020 2020 2020 .ATA/AHCI │ │ │ │ │ +0003e420: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e430: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e440: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e450: 0a41 5420 6b65 7962 6f61 7264 2020 2020 .AT keyboard │ │ │ │ │ +0003e460: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e470: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e480: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e490: 0a53 7065 616b 6572 2020 2020 2020 2020 .Speaker │ │ │ │ │ +0003e4a0: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e4b0: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e4c0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e4d0: 0a55 5342 2020 2020 2020 2020 2020 2020 .USB │ │ │ │ │ +0003e4e0: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e4f0: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e500: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e510: 0a63 6861 696e 6c6f 6164 6572 2020 2020 .chainloader │ │ │ │ │ +0003e520: 6c6f 6361 6c20 2020 2020 2020 2020 2079 local y │ │ │ │ │ +0003e530: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e540: 7320 2020 2020 2020 2020 2020 206e 6f0a s no. │ │ │ │ │ +0003e550: 6370 7569 6420 2020 2020 2020 2020 2070 cpuid p │ │ │ │ │ +0003e560: 6172 7469 616c 2020 2020 2020 2020 7061 artial pa │ │ │ │ │ +0003e570: 7274 6961 6c20 2020 2020 2020 2070 6172 rtial par │ │ │ │ │ +0003e580: 7469 616c 2020 2020 2020 2020 7061 7274 tial part │ │ │ │ │ +0003e590: 6961 6c0a 7264 6d73 7220 2020 2020 2020 ial.rdmsr │ │ │ │ │ +0003e5a0: 2020 2070 6172 7469 616c 2020 2020 2020 partial │ │ │ │ │ +0003e5b0: 2020 7061 7274 6961 6c20 2020 2020 2020 partial │ │ │ │ │ +0003e5c0: 2070 6172 7469 616c 2020 2020 2020 2020 partial │ │ │ │ │ +0003e5d0: 7061 7274 6961 6c0a 7772 6d73 7220 2020 partial.wrmsr │ │ │ │ │ +0003e5e0: 2020 2020 2020 2070 6172 7469 616c 2020 partial │ │ │ │ │ +0003e5f0: 2020 2020 2020 7061 7274 6961 6c20 2020 partial │ │ │ │ │ +0003e600: 2020 2020 2070 6172 7469 616c 2020 2020 partial │ │ │ │ │ +0003e610: 2020 2020 7061 7274 6961 6c0a 6869 6e74 partial.hint │ │ │ │ │ +0003e620: 7320 2020 2020 2020 2020 2067 7565 7373 s guess │ │ │ │ │ +0003e630: 2020 2020 2020 2020 2020 6775 6573 7320 guess │ │ │ │ │ +0003e640: 2020 2020 2020 2020 2067 7565 7373 2020 guess │ │ │ │ │ +0003e650: 2020 2020 2020 2020 6775 6573 730a 5043 guess.PC │ │ │ │ │ +0003e660: 4920 2020 2020 2020 2020 2020 2079 6573 I yes │ │ │ │ │ +0003e670: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003e680: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003e690: 2020 2020 2020 2020 2020 7965 730a 6261 yes.ba │ │ │ │ │ +0003e6a0: 6472 616d 2020 2020 2020 2020 2079 6573 dram yes │ │ │ │ │ +0003e6b0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003e6c0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003e6d0: 2020 2020 2020 2020 2020 7965 730a 636f yes.co │ │ │ │ │ +0003e6e0: 6d70 7265 7373 696f 6e20 2020 2061 6c77 mpression alw │ │ │ │ │ +0003e6f0: 6179 7320 2020 2020 2020 2020 706f 696e ays poin │ │ │ │ │ +0003e700: 746c 6573 7320 2020 2020 206e 6f20 2020 tless no │ │ │ │ │ +0003e710: 2020 2020 2020 2020 2020 6e6f 0a65 7869 no.exi │ │ │ │ │ +0003e720: 7420 2020 2020 2020 2020 2020 7965 7320 t yes │ │ │ │ │ +0003e730: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ +0003e740: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003e750: 2020 2020 2020 2020 206e 6f0a 626f 6f74 no.boot │ │ │ │ │ +0003e760: 6c6f 6361 7469 6f6e 2020 2064 6973 6b20 location disk │ │ │ │ │ +0003e770: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003e780: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003e790: 2020 2020 2020 2020 6e6f 0a0a 2020 2020 no.. │ │ │ │ │ +0003e7a0: 2020 2020 2020 2020 2020 2069 6133 3220 ia32 │ │ │ │ │ +0003e7b0: 4546 4920 2020 2020 2020 616d 6436 3420 EFI amd64 │ │ │ │ │ +0003e7c0: 4546 4920 2020 2020 2069 6133 3220 2020 EFI ia32 │ │ │ │ │ +0003e7d0: 2020 2020 2020 2020 4974 616e 6975 6d0a Itanium. │ │ │ │ │ 0003e7e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003e7f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003e800: 2020 2020 2020 2020 2020 2049 4545 4531 IEEE1 │ │ │ │ │ -0003e810: 3237 350a 7669 6465 6f20 2020 2020 2020 275.video │ │ │ │ │ -0003e820: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e830: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003e840: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003e850: 6e6f 0a63 6f6e 736f 6c65 2020 2020 2020 no.console │ │ │ │ │ -0003e860: 2020 556e 6963 6f64 6520 2020 2020 2020 Unicode │ │ │ │ │ -0003e870: 2055 6e69 636f 6465 2020 2020 2020 2020 Unicode │ │ │ │ │ -0003e880: 4153 4349 4920 2020 2020 2020 2020 2055 ASCII U │ │ │ │ │ -0003e890: 6e69 636f 6465 0a63 6861 7273 6574 0a6e nicode.charset.n │ │ │ │ │ -0003e8a0: 6574 776f 726b 2020 2020 2020 2020 7965 etwork ye │ │ │ │ │ -0003e8b0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ -0003e8c0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003e8d0: 2020 2020 2020 2020 2020 2079 6573 0a41 yes.A │ │ │ │ │ -0003e8e0: 5441 2f41 4843 4920 2020 2020 2020 7965 TA/AHCI ye │ │ │ │ │ -0003e8f0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ -0003e900: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003e910: 2020 2020 2020 2020 2020 206e 6f0a 4154 no.AT │ │ │ │ │ -0003e920: 206b 6579 626f 6172 6420 2020 2079 6573 keyboard yes │ │ │ │ │ -0003e930: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003e940: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ -0003e950: 2020 2020 2020 2020 2020 6e6f 0a53 7065 no.Spe │ │ │ │ │ -0003e960: 616b 6572 2020 2020 2020 2020 7965 7320 aker yes │ │ │ │ │ -0003e970: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ -0003e980: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ -0003e990: 2020 2020 2020 2020 206e 6f0a 5553 4220 no.USB │ │ │ │ │ -0003e9a0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ -0003e9b0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ -0003e9c0: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -0003e9d0: 2020 2020 2020 2020 6e6f 0a63 6861 696e no.chain │ │ │ │ │ -0003e9e0: 6c6f 6164 6572 2020 2020 6c6f 6361 6c20 loader local │ │ │ │ │ -0003e9f0: 2020 2020 2020 2020 206c 6f63 616c 2020 local │ │ │ │ │ -0003ea00: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ -0003ea10: 2020 2020 2020 206c 6f63 616c 0a63 7075 local.cpu │ │ │ │ │ -0003ea20: 6964 2020 2020 2020 2020 2020 7061 7274 id part │ │ │ │ │ -0003ea30: 6961 6c20 2020 2020 2020 2070 6172 7469 ial parti │ │ │ │ │ -0003ea40: 616c 2020 2020 2020 2020 7061 7274 6961 al partia │ │ │ │ │ -0003ea50: 6c20 2020 2020 2020 206e 6f0a 7264 6d73 l no.rdms │ │ │ │ │ -0003ea60: 7220 2020 2020 2020 2020 2070 6172 7469 r parti │ │ │ │ │ -0003ea70: 616c 2020 2020 2020 2020 7061 7274 6961 al partia │ │ │ │ │ -0003ea80: 6c20 2020 2020 2020 2070 6172 7469 616c l partial │ │ │ │ │ -0003ea90: 2020 2020 2020 2020 6e6f 0a77 726d 7372 no.wrmsr │ │ │ │ │ -0003eaa0: 2020 2020 2020 2020 2020 7061 7274 6961 partia │ │ │ │ │ -0003eab0: 6c20 2020 2020 2020 2070 6172 7469 616c l partial │ │ │ │ │ -0003eac0: 2020 2020 2020 2020 7061 7274 6961 6c20 partial │ │ │ │ │ -0003ead0: 2020 2020 2020 206e 6f0a 6869 6e74 7320 no.hints │ │ │ │ │ -0003eae0: 2020 2020 2020 2020 2067 7565 7373 2020 guess │ │ │ │ │ -0003eaf0: 2020 2020 2020 2020 6775 6573 7320 2020 guess │ │ │ │ │ -0003eb00: 2020 2020 2020 2067 6f6f 6420 2020 2020 good │ │ │ │ │ -0003eb10: 2020 2020 2020 6775 6573 730a 5043 4920 guess.PCI │ │ │ │ │ -0003eb20: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ -0003eb30: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ -0003eb40: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -0003eb50: 2020 2020 2020 2020 6e6f 0a62 6164 7261 no.badra │ │ │ │ │ -0003eb60: 6d20 2020 2020 2020 2020 7965 7320 2020 m yes │ │ │ │ │ -0003eb70: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -0003eb80: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ -0003eb90: 2020 2020 2020 2079 6573 0a63 6f6d 7072 yes.compr │ │ │ │ │ -0003eba0: 6573 7369 6f6e 2020 2020 6e6f 2020 2020 ession no │ │ │ │ │ -0003ebb0: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ -0003ebc0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ -0003ebd0: 2020 2020 2020 206e 6f0a 6578 6974 2020 no.exit │ │ │ │ │ -0003ebe0: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -0003ebf0: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ │ -0003ec00: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ -0003ec10: 2020 2020 2020 7965 730a 626f 6f74 6c6f yes.bootlo │ │ │ │ │ -0003ec20: 6361 7469 6f6e 2020 2066 696c 6520 2020 cation file │ │ │ │ │ -0003ec30: 2020 2020 2020 2020 6669 6c65 2020 2020 file │ │ │ │ │ -0003ec40: 2020 2020 2020 2066 696c 652c 2020 2020 file, │ │ │ │ │ -0003ec50: 2020 2020 2020 6669 6c65 0a20 2020 2020 file. │ │ │ │ │ +0003e800: 2020 2020 2020 2020 2020 2020 2049 4545 IEE │ │ │ │ │ +0003e810: 4531 3237 350a 7669 6465 6f20 2020 2020 E1275.video │ │ │ │ │ +0003e820: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +0003e830: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ +0003e840: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003e850: 2020 6e6f 0a63 6f6e 736f 6c65 2020 2020 no.console │ │ │ │ │ +0003e860: 2020 2020 556e 6963 6f64 6520 2020 2020 Unicode │ │ │ │ │ +0003e870: 2020 2055 6e69 636f 6465 2020 2020 2020 Unicode │ │ │ │ │ +0003e880: 2020 4153 4349 4920 2020 2020 2020 2020 ASCII │ │ │ │ │ +0003e890: 2055 6e69 636f 6465 0a63 6861 7273 6574 Unicode.charset │ │ │ │ │ +0003e8a0: 0a6e 6574 776f 726b 2020 2020 2020 2020 .network │ │ │ │ │ +0003e8b0: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e8c0: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e8d0: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e8e0: 0a41 5441 2f41 4843 4920 2020 2020 2020 .ATA/AHCI │ │ │ │ │ +0003e8f0: 7965 7320 2020 2020 2020 2020 2020 2079 yes y │ │ │ │ │ +0003e900: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e910: 7320 2020 2020 2020 2020 2020 206e 6f0a s no. │ │ │ │ │ +0003e920: 4154 206b 6579 626f 6172 6420 2020 2079 AT keyboard y │ │ │ │ │ +0003e930: 6573 2020 2020 2020 2020 2020 2020 7965 es ye │ │ │ │ │ +0003e940: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e950: 2020 2020 2020 2020 2020 2020 6e6f 0a53 no.S │ │ │ │ │ +0003e960: 7065 616b 6572 2020 2020 2020 2020 7965 peaker ye │ │ │ │ │ +0003e970: 7320 2020 2020 2020 2020 2020 2079 6573 s yes │ │ │ │ │ +0003e980: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003e990: 2020 2020 2020 2020 2020 206e 6f0a 5553 no.US │ │ │ │ │ +0003e9a0: 4220 2020 2020 2020 2020 2020 2079 6573 B yes │ │ │ │ │ +0003e9b0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003e9c0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003e9d0: 2020 2020 2020 2020 2020 6e6f 0a63 6861 no.cha │ │ │ │ │ +0003e9e0: 696e 6c6f 6164 6572 2020 2020 6c6f 6361 inloader loca │ │ │ │ │ +0003e9f0: 6c20 2020 2020 2020 2020 206c 6f63 616c l local │ │ │ │ │ +0003ea00: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003ea10: 2020 2020 2020 2020 206c 6f63 616c 0a63 local.c │ │ │ │ │ +0003ea20: 7075 6964 2020 2020 2020 2020 2020 7061 puid pa │ │ │ │ │ +0003ea30: 7274 6961 6c20 2020 2020 2020 2070 6172 rtial par │ │ │ │ │ +0003ea40: 7469 616c 2020 2020 2020 2020 7061 7274 tial part │ │ │ │ │ +0003ea50: 6961 6c20 2020 2020 2020 206e 6f0a 7264 ial no.rd │ │ │ │ │ +0003ea60: 6d73 7220 2020 2020 2020 2020 2070 6172 msr par │ │ │ │ │ +0003ea70: 7469 616c 2020 2020 2020 2020 7061 7274 tial part │ │ │ │ │ +0003ea80: 6961 6c20 2020 2020 2020 2070 6172 7469 ial parti │ │ │ │ │ +0003ea90: 616c 2020 2020 2020 2020 6e6f 0a77 726d al no.wrm │ │ │ │ │ +0003eaa0: 7372 2020 2020 2020 2020 2020 7061 7274 sr part │ │ │ │ │ +0003eab0: 6961 6c20 2020 2020 2020 2070 6172 7469 ial parti │ │ │ │ │ +0003eac0: 616c 2020 2020 2020 2020 7061 7274 6961 al partia │ │ │ │ │ +0003ead0: 6c20 2020 2020 2020 206e 6f0a 6869 6e74 l no.hint │ │ │ │ │ +0003eae0: 7320 2020 2020 2020 2020 2067 7565 7373 s guess │ │ │ │ │ +0003eaf0: 2020 2020 2020 2020 2020 6775 6573 7320 guess │ │ │ │ │ +0003eb00: 2020 2020 2020 2020 2067 6f6f 6420 2020 good │ │ │ │ │ +0003eb10: 2020 2020 2020 2020 6775 6573 730a 5043 guess.PC │ │ │ │ │ +0003eb20: 4920 2020 2020 2020 2020 2020 2079 6573 I yes │ │ │ │ │ +0003eb30: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003eb40: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003eb50: 2020 2020 2020 2020 2020 6e6f 0a62 6164 no.bad │ │ │ │ │ +0003eb60: 7261 6d20 2020 2020 2020 2020 7965 7320 ram yes │ │ │ │ │ +0003eb70: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003eb80: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003eb90: 2020 2020 2020 2020 2079 6573 0a63 6f6d yes.com │ │ │ │ │ +0003eba0: 7072 6573 7369 6f6e 2020 2020 6e6f 2020 pression no │ │ │ │ │ +0003ebb0: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ +0003ebc0: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003ebd0: 2020 2020 2020 2020 206e 6f0a 6578 6974 no.exit │ │ │ │ │ +0003ebe0: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +0003ebf0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ +0003ec00: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ +0003ec10: 2020 2020 2020 2020 7965 730a 626f 6f74 yes.boot │ │ │ │ │ +0003ec20: 6c6f 6361 7469 6f6e 2020 2066 696c 6520 location file │ │ │ │ │ +0003ec30: 2020 2020 2020 2020 2020 6669 6c65 2020 file │ │ │ │ │ +0003ec40: 2020 2020 2020 2020 2066 696c 652c 2020 file, │ │ │ │ │ +0003ec50: 2020 2020 2020 2020 6669 6c65 0a20 2020 file. │ │ │ │ │ 0003ec60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 0003ec70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ec80: 2020 2020 2020 2020 6967 6e6f 7265 640a ignored. │ │ │ │ │ -0003ec90: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -0003eca0: 4c6f 6f6e 6773 6f6e 2020 2020 2020 2073 Loongson s │ │ │ │ │ -0003ecb0: 7061 7263 3634 2020 2020 2020 2020 506f parc64 Po │ │ │ │ │ -0003ecc0: 7765 7270 6320 2020 2020 2020 2041 5243 werpc ARC │ │ │ │ │ -0003ecd0: 0a76 6964 656f 2020 2020 2020 2020 2020 .video │ │ │ │ │ -0003ece0: 7965 7320 2020 2020 2020 2020 2020 206e yes n │ │ │ │ │ -0003ecf0: 6f20 2020 2020 2020 2020 2020 2020 7965 o ye │ │ │ │ │ -0003ed00: 7320 2020 2020 2020 2020 2020 206e 6f0a s no. │ │ │ │ │ -0003ed10: 636f 6e73 6f6c 6520 2020 2020 2020 204e console N │ │ │ │ │ -0003ed20: 2f41 2020 2020 2020 2020 2020 2020 4153 /A AS │ │ │ │ │ -0003ed30: 4349 4920 2020 2020 2020 2020 2041 5343 CII ASC │ │ │ │ │ -0003ed40: 4949 2020 2020 2020 2020 2020 4153 4349 II ASCI │ │ │ │ │ -0003ed50: 490a 6368 6172 7365 740a 6e65 7477 6f72 I.charset.networ │ │ │ │ │ -0003ed60: 6b20 2020 2020 2020 206e 6f20 2020 2020 k no │ │ │ │ │ -0003ed70: 2020 2020 2020 2020 7965 7320 282a 2920 yes (*) │ │ │ │ │ -0003ed80: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ -0003ed90: 2020 2020 2020 6e6f 0a41 5441 2f41 4843 no.ATA/AHC │ │ │ │ │ -0003eda0: 4920 2020 2020 2020 7965 7320 2020 2020 I yes │ │ │ │ │ -0003edb0: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ -0003edc0: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ │ -0003edd0: 2020 2020 206e 6f0a 4154 206b 6579 626f no.AT keybo │ │ │ │ │ -0003ede0: 6172 6420 2020 2079 6573 2020 2020 2020 ard yes │ │ │ │ │ -0003edf0: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ │ -0003ee00: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ -0003ee10: 2020 2020 6e6f 0a53 7065 616b 6572 2020 no.Speaker │ │ │ │ │ -0003ee20: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ │ -0003ee30: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ -0003ee40: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ee50: 2020 206e 6f0a 5553 4220 2020 2020 2020 no.USB │ │ │ │ │ -0003ee60: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ -0003ee70: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ee80: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ee90: 2020 6e6f 0a63 6861 696e 6c6f 6164 6572 no.chainloader │ │ │ │ │ -0003eea0: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ -0003eeb0: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003eec0: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003eed0: 206e 6f0a 6370 7569 6420 2020 2020 2020 no.cpuid │ │ │ │ │ -0003eee0: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003eef0: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ef00: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ef10: 6e6f 0a72 646d 7372 2020 2020 2020 2020 no.rdmsr │ │ │ │ │ -0003ef20: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ef30: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ef40: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ │ -0003ef50: 6f0a 7772 6d73 7220 2020 2020 2020 2020 o.wrmsr │ │ │ │ │ -0003ef60: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ -0003ef70: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ │ -0003ef80: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ -0003ef90: 0a68 696e 7473 2020 2020 2020 2020 2020 .hints │ │ │ │ │ -0003efa0: 676f 6f64 2020 2020 2020 2020 2020 2067 good g │ │ │ │ │ -0003efb0: 6f6f 6420 2020 2020 2020 2020 2020 676f ood go │ │ │ │ │ -0003efc0: 6f64 2020 2020 2020 2020 2020 206e 6f0a od no. │ │ │ │ │ -0003efd0: 5043 4920 2020 2020 2020 2020 2020 2079 PCI y │ │ │ │ │ -0003efe0: 6573 2020 2020 2020 2020 2020 2020 6e6f es no │ │ │ │ │ -0003eff0: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ -0003f000: 2020 2020 2020 2020 2020 2020 6e6f 0a62 no.b │ │ │ │ │ -0003f010: 6164 7261 6d20 2020 2020 2020 2020 7965 adram ye │ │ │ │ │ -0003f020: 7320 282a 2920 2020 2020 2020 206e 6f20 s (*) no │ │ │ │ │ -0003f030: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ │ -0003f040: 2020 2020 2020 2020 2020 206e 6f0a 636f no.co │ │ │ │ │ -0003f050: 6d70 7265 7373 696f 6e20 2020 2063 6f6e mpression con │ │ │ │ │ -0003f060: 6669 6775 7261 626c 6520 2020 6e6f 2020 figurable no │ │ │ │ │ -0003f070: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ -0003f080: 2020 2020 2020 2020 2020 636f 6e66 6967 config │ │ │ │ │ -0003f090: 7572 6162 6c65 0a65 7869 7420 2020 2020 urable.exit │ │ │ │ │ -0003f0a0: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ │ -0003f0b0: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ -0003f0c0: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ -0003f0d0: 2020 2079 6573 0a62 6f6f 746c 6f63 6174 yes.bootlocat │ │ │ │ │ -0003f0e0: 696f 6e20 2020 6e6f 2020 2020 2020 2020 ion no │ │ │ │ │ -0003f0f0: 2020 2020 2070 6172 7469 7469 6f6e 2020 partition │ │ │ │ │ -0003f100: 2020 2020 6669 6c65 2020 2020 2020 2020 file │ │ │ │ │ -0003f110: 2020 2066 696c 6520 282a 290a 0a20 2020 file (*).. │ │ │ │ │ -0003f120: 2020 2020 2020 2020 2020 2020 4d49 5053 MIPS │ │ │ │ │ -0003f130: 2071 656d 7520 2020 2020 2065 6d75 2020 qemu emu │ │ │ │ │ -0003f140: 2020 2020 2020 2020 2020 7865 6e0a 7669 xen.vi │ │ │ │ │ -0003f150: 6465 6f20 2020 2020 2020 2020 206e 6f20 deo no │ │ │ │ │ -0003f160: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003f170: 2020 2020 2020 2020 2020 206e 6f0a 636f no.co │ │ │ │ │ -0003f180: 6e73 6f6c 6520 2020 2020 2020 2043 5034 nsole CP4 │ │ │ │ │ -0003f190: 3337 2020 2020 2020 2020 2020 556e 6963 37 Unic │ │ │ │ │ -0003f1a0: 6f64 6520 282a 2920 2020 2041 5343 4949 ode (*) ASCII │ │ │ │ │ -0003f1b0: 0a63 6861 7273 6574 0a6e 6574 776f 726b .charset.network │ │ │ │ │ -0003f1c0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ -0003f1d0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ -0003f1e0: 2020 2020 2020 6e6f 0a41 5441 2f41 4843 no.ATA/AHC │ │ │ │ │ -0003f1f0: 4920 2020 2020 2020 7965 7320 2020 2020 I yes │ │ │ │ │ -0003f200: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ -0003f210: 2020 2020 2020 6e6f 0a41 5420 6b65 7962 no.AT keyb │ │ │ │ │ -0003f220: 6f61 7264 2020 2020 7965 7320 2020 2020 oard yes │ │ │ │ │ -0003f230: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ -0003f240: 2020 2020 2020 6e6f 0a53 7065 616b 6572 no.Speaker │ │ │ │ │ -0003f250: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ -0003f260: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ -0003f270: 2020 2020 2020 6e6f 0a55 5342 2020 2020 no.USB │ │ │ │ │ -0003f280: 2020 2020 2020 2020 4e2f 4120 2020 2020 N/A │ │ │ │ │ -0003f290: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ -0003f2a0: 2020 2020 2020 6e6f 0a63 6861 696e 6c6f no.chainlo │ │ │ │ │ -0003f2b0: 6164 6572 2020 2020 7965 7320 2020 2020 ader yes │ │ │ │ │ -0003f2c0: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ -0003f2d0: 2020 2020 2020 7965 730a 6370 7569 6420 yes.cpuid │ │ │ │ │ -0003f2e0: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ -0003f2f0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ -0003f300: 2020 2020 2020 2079 6573 0a72 646d 7372 yes.rdmsr │ │ │ │ │ -0003f310: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ -0003f320: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ -0003f330: 2020 2020 2020 2020 7965 730a 7772 6d73 yes.wrms │ │ │ │ │ -0003f340: 7220 2020 2020 2020 2020 206e 6f20 2020 r no │ │ │ │ │ -0003f350: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ -0003f360: 2020 2020 2020 2020 2079 6573 0a68 696e yes.hin │ │ │ │ │ -0003f370: 7473 2020 2020 2020 2020 2020 6775 6573 ts gues │ │ │ │ │ -0003f380: 7320 2020 2020 2020 2020 206e 6f20 2020 s no │ │ │ │ │ -0003f390: 2020 2020 2020 2020 2020 6e6f 0a50 4349 no.PCI │ │ │ │ │ -0003f3a0: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ │ -0003f3b0: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ -0003f3c0: 2020 2020 2020 2020 2020 6e6f 0a62 6164 no.bad │ │ │ │ │ -0003f3d0: 7261 6d20 2020 2020 2020 2020 7965 7320 ram yes │ │ │ │ │ -0003f3e0: 282a 2920 2020 2020 2020 206e 6f20 2020 (*) no │ │ │ │ │ -0003f3f0: 2020 2020 2020 2020 2020 6e6f 0a63 6f6d no.com │ │ │ │ │ -0003f400: 7072 6573 7369 6f6e 2020 2020 636f 6e66 pression conf │ │ │ │ │ -0003f410: 6967 7572 6162 6c65 2020 206e 6f20 2020 igurable no │ │ │ │ │ -0003f420: 2020 2020 2020 2020 2020 6e6f 0a65 7869 no.exi │ │ │ │ │ -0003f430: 7420 2020 2020 2020 2020 2020 6e6f 2020 t no │ │ │ │ │ -0003f440: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ -0003f450: 2020 2020 2020 2020 2020 6e6f 0a62 6f6f no.boo │ │ │ │ │ -0003f460: 746c 6f63 6174 696f 6e20 2020 6e6f 2020 tlocation no │ │ │ │ │ -0003f470: 2020 2020 2020 2020 2020 2066 696c 6520 file │ │ │ │ │ -0003f480: 2020 2020 2020 2020 2020 6e6f 0a0a 1f0a no.... │ │ │ │ │ -0003f490: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ -0003f4a0: 2020 4e6f 6465 3a20 506c 6174 666f 726d Node: Platform │ │ │ │ │ -0003f4b0: 2d73 7065 6369 6669 6320 6f70 6572 6174 -specific operat │ │ │ │ │ -0003f4c0: 696f 6e73 2c20 204e 6578 743a 2053 7570 ions, Next: Sup │ │ │ │ │ -0003f4d0: 706f 7274 6564 206b 6572 6e65 6c73 2c20 ported kernels, │ │ │ │ │ -0003f4e0: 2050 7265 763a 2050 6c61 7466 6f72 6d20 Prev: Platform │ │ │ │ │ -0003f4f0: 6c69 6d69 7461 7469 6f6e 732c 2020 5570 limitations, Up │ │ │ │ │ -0003f500: 3a20 546f 700a 0a32 3020 4f75 746c 696e : Top..20 Outlin │ │ │ │ │ -0003f510: 650a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 536f e.**********..So │ │ │ │ │ -0003f520: 6d65 2070 6c61 7466 6f72 6d73 2068 6176 me platforms hav │ │ │ │ │ -0003f530: 6520 6665 6174 7572 6573 2077 6869 6368 e features which │ │ │ │ │ -0003f540: 2061 6c6c 6f77 7320 746f 2069 6d70 6c65 allows to imple │ │ │ │ │ -0003f550: 6d65 6e74 2073 6f6d 6520 636f 6d6d 616e ment some comman │ │ │ │ │ -0003f560: 6473 0a75 7365 6c65 7373 206f 7220 6e6f ds.useless or no │ │ │ │ │ -0003f570: 7420 696d 706c 656d 656e 7461 626c 6520 t implementable │ │ │ │ │ -0003f580: 6f6e 206f 7468 6572 732e 0a0a 2020 2051 on others... Q │ │ │ │ │ -0003f590: 7569 636b 2073 756d 6d61 7279 3a0a 0a20 uick summary:.. │ │ │ │ │ -0003f5a0: 2020 496e 666f 726d 6174 696f 6e20 7265 Information re │ │ │ │ │ -0003f5b0: 7472 6965 7661 6c3a 0a0a 2020 202a 206d trieval:.. * m │ │ │ │ │ -0003f5c0: 6970 7365 6c2d 6c6f 6f6e 6773 6f6e 3a20 ipsel-loongson: │ │ │ │ │ -0003f5d0: 6c73 7370 640a 2020 202a 206d 6970 732d lsspd. * mips- │ │ │ │ │ -0003f5e0: 6172 633a 206c 7364 6576 0a20 2020 2a20 arc: lsdev. * │ │ │ │ │ -0003f5f0: 6566 693a 206c 7365 6669 7379 7374 6162 efi: lsefisystab │ │ │ │ │ -0003f600: 2c20 6c73 7361 6c2c 206c 7365 6669 6d6d , lssal, lsefimm │ │ │ │ │ -0003f610: 6170 2c20 6c73 6566 690a 2020 202a 2069 ap, lsefi. * i │ │ │ │ │ -0003f620: 3338 362d 7063 3a20 6c73 6170 6d0a 2020 386-pc: lsapm. │ │ │ │ │ -0003f630: 202a 2069 3338 362d 636f 7265 626f 6f74 * i386-coreboot │ │ │ │ │ -0003f640: 3a20 6c73 636f 7265 626f 6f74 2c20 636f : lscoreboot, co │ │ │ │ │ -0003f650: 7265 626f 6f74 5f62 6f6f 7474 696d 652c reboot_boottime, │ │ │ │ │ -0003f660: 2063 626d 656d 630a 2020 202a 2061 6370 cbmemc. * acp │ │ │ │ │ -0003f670: 692d 656e 6162 6c65 6420 2869 3338 362d i-enabled (i386- │ │ │ │ │ -0003f680: 7063 2c20 6933 3836 2d63 6f72 6562 6f6f pc, i386-coreboo │ │ │ │ │ -0003f690: 742c 2069 3338 362d 6d75 6c74 6962 6f6f t, i386-multiboo │ │ │ │ │ -0003f6a0: 742c 202a 2d65 6669 293a 0a20 2020 2020 t, *-efi):. │ │ │ │ │ -0003f6b0: 6c73 6163 7069 0a0a 2020 2057 6f72 6b61 lsacpi.. Worka │ │ │ │ │ -0003f6c0: 726f 756e 6473 2066 6f72 2070 6c61 7466 rounds for platf │ │ │ │ │ -0003f6d0: 6f72 6d2d 7370 6563 6966 6963 2069 7373 orm-specific iss │ │ │ │ │ -0003f6e0: 7565 733a 0a20 2020 2a20 6933 3836 2d65 ues:. * i386-e │ │ │ │ │ -0003f6f0: 6669 2f78 3836 5f36 342d 6566 693a 206c fi/x86_64-efi: l │ │ │ │ │ -0003f700: 6f61 6462 696f 732c 2066 616b 6562 696f oadbios, fakebio │ │ │ │ │ -0003f710: 732c 2066 6978 5f76 6964 656f 0a20 2020 s, fix_video. │ │ │ │ │ -0003f720: 2a20 6163 7069 2d65 6e61 626c 6564 2028 * acpi-enabled ( │ │ │ │ │ -0003f730: 6933 3836 2d70 632c 2069 3338 362d 636f i386-pc, i386-co │ │ │ │ │ -0003f740: 7265 626f 6f74 2c20 6933 3836 2d6d 756c reboot, i386-mul │ │ │ │ │ -0003f750: 7469 626f 6f74 2c20 2a2d 6566 6929 3a20 tiboot, *-efi): │ │ │ │ │ -0003f760: 6163 7069 0a20 2020 2020 286f 7665 7272 acpi. (overr │ │ │ │ │ -0003f770: 6964 6520 4143 5049 2074 6162 6c65 7329 ide ACPI tables) │ │ │ │ │ -0003f780: 0a20 2020 2a20 6933 3836 2d70 633a 2064 . * i386-pc: d │ │ │ │ │ -0003f790: 7269 7665 6d61 700a 2020 202a 2069 3338 rivemap. * i38 │ │ │ │ │ -0003f7a0: 362d 7063 3a20 7365 6e64 6b65 790a 0a20 6-pc: sendkey.. │ │ │ │ │ -0003f7b0: 2020 4164 7661 6e63 6564 206f 7065 7261 Advanced opera │ │ │ │ │ -0003f7c0: 7469 6f6e 7320 666f 7220 706f 7765 7220 tions for power │ │ │ │ │ -0003f7d0: 7573 6572 733a 0a20 2020 2a20 7838 363a users:. * x86: │ │ │ │ │ -0003f7e0: 2069 6f72 7720 2864 6972 6563 7420 6163 iorw (direct ac │ │ │ │ │ -0003f7f0: 6365 7373 2074 6f20 492f 4f20 706f 7274 cess to I/O port │ │ │ │ │ -0003f800: 7329 0a0a 2020 204d 6973 6365 6c61 6e65 s).. Miscelane │ │ │ │ │ -0003f810: 6f75 733a 0a20 2020 2a20 636d 6f73 2028 ous:. * cmos ( │ │ │ │ │ -0003f820: 7838 362d 2a2c 2069 6565 6531 3237 352c x86-*, ieee1275, │ │ │ │ │ -0003f830: 206d 6970 732d 7165 6d75 5f6d 6970 732c mips-qemu_mips, │ │ │ │ │ -0003f840: 206d 6970 732d 6c6f 6f6e 6773 6f6e 293a mips-loongson): │ │ │ │ │ -0003f850: 2063 6d6f 7374 6573 740a 2020 2020 2028 cmostest. ( │ │ │ │ │ -0003f860: 7573 6564 206f 6e20 736f 6d65 206c 6170 used on some lap │ │ │ │ │ -0003f870: 746f 7073 2074 6f20 6368 6563 6b20 666f tops to check fo │ │ │ │ │ -0003f880: 7220 7370 6563 6961 6c20 706f 7765 722d r special power- │ │ │ │ │ -0003f890: 6f6e 206b 6579 292c 2063 6d6f 7363 6c65 on key), cmoscle │ │ │ │ │ -0003f8a0: 616e 0a20 2020 2a20 6933 3836 2d70 633a an. * i386-pc: │ │ │ │ │ -0003f8b0: 2070 6c61 790a 0a1f 0a46 696c 653a 2067 play....File: g │ │ │ │ │ -0003f8c0: 7275 622e 696e 666f 2c20 204e 6f64 653a rub.info, Node: │ │ │ │ │ -0003f8d0: 2053 7570 706f 7274 6564 206b 6572 6e65 Supported kerne │ │ │ │ │ -0003f8e0: 6c73 2c20 204e 6578 743a 2054 726f 7562 ls, Next: Troub │ │ │ │ │ -0003f8f0: 6c65 7368 6f6f 7469 6e67 2c20 2050 7265 leshooting, Pre │ │ │ │ │ -0003f900: 763a 2050 6c61 7466 6f72 6d2d 7370 6563 v: Platform-spec │ │ │ │ │ -0003f910: 6966 6963 206f 7065 7261 7469 6f6e 732c ific operations, │ │ │ │ │ -0003f920: 2020 5570 3a20 546f 700a 0a32 3120 5375 Up: Top..21 Su │ │ │ │ │ -0003f930: 7070 6f72 7465 6420 626f 6f74 2074 6172 pported boot tar │ │ │ │ │ -0003f940: 6765 7473 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a gets.*********** │ │ │ │ │ -0003f950: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ -0003f960: 5838 3620 7375 7070 6f72 7420 6973 2073 X86 support is s │ │ │ │ │ -0003f970: 756d 6d61 7269 7365 6420 696e 2074 6865 ummarised in the │ │ │ │ │ -0003f980: 2066 6f6c 6c6f 7769 6e67 2074 6162 6c65 following table │ │ │ │ │ -0003f990: 2e20 2022 5965 7322 206d 6561 6e73 2074 . "Yes" means t │ │ │ │ │ -0003f9a0: 6861 7420 7468 650a 6b65 726e 656c 2077 hat the.kernel w │ │ │ │ │ -0003f9b0: 6f72 6b73 206f 6e20 7468 6520 6769 7665 orks on the give │ │ │ │ │ -0003f9c0: 6e20 706c 6174 666f 726d 2c20 2263 7261 n platform, "cra │ │ │ │ │ -0003f9d0: 7368 6573 2220 6d65 616e 7320 616e 2065 shes" means an e │ │ │ │ │ -0003f9e0: 6172 6c79 206b 6572 6e65 6c0a 6372 6173 arly kernel.cras │ │ │ │ │ -0003f9f0: 6820 7768 6963 6820 7765 2068 6f70 6520 h which we hope │ │ │ │ │ -0003fa00: 7769 6c6c 2062 6520 6669 7865 6420 6279 will be fixed by │ │ │ │ │ -0003fa10: 2063 6f6e 6365 726e 6564 206b 6572 6e65 concerned kerne │ │ │ │ │ -0003fa20: 6c20 6465 7665 6c6f 7065 7273 2e20 2022 l developers. " │ │ │ │ │ -0003fa30: 6e6f 220a 6d65 616e 7320 4752 5542 2064 no".means GRUB d │ │ │ │ │ -0003fa40: 6f65 736e 2774 206c 6f61 6420 7468 6520 oesn't load the │ │ │ │ │ -0003fa50: 6769 7665 6e20 6b65 726e 656c 206f 6e20 given kernel on │ │ │ │ │ -0003fa60: 6120 6769 7665 6e20 706c 6174 666f 726d a given platform │ │ │ │ │ -0003fa70: 2e0a 2268 6561 646c 6573 7322 206d 6561 .."headless" mea │ │ │ │ │ -0003fa80: 6e73 2074 6861 7420 7468 6520 6b65 726e ns that the kern │ │ │ │ │ -0003fa90: 656c 2077 6f72 6b73 2062 7574 206c 6163 el works but lac │ │ │ │ │ -0003faa0: 6b73 2063 6f6e 736f 6c65 2064 7269 7665 ks console drive │ │ │ │ │ -0003fab0: 7273 2028 796f 750a 6361 6e20 7374 696c rs (you.can stil │ │ │ │ │ -0003fac0: 6c20 7573 6520 7365 7269 616c 206f 7220 l use serial or │ │ │ │ │ -0003fad0: 6e65 7477 6f72 6b20 636f 6e73 6f6c 6529 network console) │ │ │ │ │ -0003fae0: 2e20 2049 6e20 6361 7365 206f 6620 226e . In case of "n │ │ │ │ │ -0003faf0: 6f22 2061 6e64 2022 6372 6173 6865 7322 o" and "crashes" │ │ │ │ │ -0003fb00: 0a74 6865 2072 6561 736f 6e20 6973 2067 .the reason is g │ │ │ │ │ -0003fb10: 6976 656e 2069 6e20 666f 6f74 6e6f 7465 iven in footnote │ │ │ │ │ -0003fb20: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ +0003ec80: 2020 2020 2020 2020 2020 6967 6e6f 7265 ignore │ │ │ │ │ +0003ec90: 640a 0a20 2020 2020 2020 2020 2020 2020 d.. │ │ │ │ │ +0003eca0: 2020 4c6f 6f6e 6773 6f6e 2020 2020 2020 Loongson │ │ │ │ │ +0003ecb0: 2073 7061 7263 3634 2020 2020 2020 2020 sparc64 │ │ │ │ │ +0003ecc0: 506f 7765 7270 6320 2020 2020 2020 2041 Powerpc A │ │ │ │ │ +0003ecd0: 5243 0a76 6964 656f 2020 2020 2020 2020 RC.video │ │ │ │ │ +0003ece0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003ecf0: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ed00: 7965 7320 2020 2020 2020 2020 2020 206e yes n │ │ │ │ │ +0003ed10: 6f0a 636f 6e73 6f6c 6520 2020 2020 2020 o.console │ │ │ │ │ +0003ed20: 204e 2f41 2020 2020 2020 2020 2020 2020 N/A │ │ │ │ │ +0003ed30: 4153 4349 4920 2020 2020 2020 2020 2041 ASCII A │ │ │ │ │ +0003ed40: 5343 4949 2020 2020 2020 2020 2020 4153 SCII AS │ │ │ │ │ +0003ed50: 4349 490a 6368 6172 7365 740a 6e65 7477 CII.charset.netw │ │ │ │ │ +0003ed60: 6f72 6b20 2020 2020 2020 206e 6f20 2020 ork no │ │ │ │ │ +0003ed70: 2020 2020 2020 2020 2020 7965 7320 282a yes (* │ │ │ │ │ +0003ed80: 2920 2020 2020 2020 2079 6573 2020 2020 ) yes │ │ │ │ │ +0003ed90: 2020 2020 2020 2020 6e6f 0a41 5441 2f41 no.ATA/A │ │ │ │ │ +0003eda0: 4843 4920 2020 2020 2020 7965 7320 2020 HCI yes │ │ │ │ │ +0003edb0: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003edc0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ +0003edd0: 2020 2020 2020 206e 6f0a 4154 206b 6579 no.AT key │ │ │ │ │ +0003ede0: 626f 6172 6420 2020 2079 6573 2020 2020 board yes │ │ │ │ │ +0003edf0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ +0003ee00: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ +0003ee10: 2020 2020 2020 6e6f 0a53 7065 616b 6572 no.Speaker │ │ │ │ │ +0003ee20: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ +0003ee30: 2020 2020 2020 206e 6f20 2020 2020 2020 no │ │ │ │ │ +0003ee40: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ │ +0003ee50: 2020 2020 206e 6f0a 5553 4220 2020 2020 no.USB │ │ │ │ │ +0003ee60: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +0003ee70: 2020 2020 2020 6e6f 2020 2020 2020 2020 no │ │ │ │ │ +0003ee80: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ +0003ee90: 2020 2020 6e6f 0a63 6861 696e 6c6f 6164 no.chainload │ │ │ │ │ +0003eea0: 6572 2020 2020 7965 7320 2020 2020 2020 er yes │ │ │ │ │ +0003eeb0: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ +0003eec0: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003eed0: 2020 206e 6f0a 6370 7569 6420 2020 2020 no.cpuid │ │ │ │ │ +0003eee0: 2020 2020 206e 6f20 2020 2020 2020 2020 no │ │ │ │ │ +0003eef0: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef00: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef10: 2020 6e6f 0a72 646d 7372 2020 2020 2020 no.rdmsr │ │ │ │ │ +0003ef20: 2020 2020 6e6f 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef30: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef40: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef50: 206e 6f0a 7772 6d73 7220 2020 2020 2020 no.wrmsr │ │ │ │ │ +0003ef60: 2020 206e 6f20 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef70: 2020 6e6f 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef80: 206e 6f20 2020 2020 2020 2020 2020 2020 no │ │ │ │ │ +0003ef90: 6e6f 0a68 696e 7473 2020 2020 2020 2020 no.hints │ │ │ │ │ +0003efa0: 2020 676f 6f64 2020 2020 2020 2020 2020 good │ │ │ │ │ +0003efb0: 2067 6f6f 6420 2020 2020 2020 2020 2020 good │ │ │ │ │ +0003efc0: 676f 6f64 2020 2020 2020 2020 2020 206e good n │ │ │ │ │ +0003efd0: 6f0a 5043 4920 2020 2020 2020 2020 2020 o.PCI │ │ │ │ │ +0003efe0: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003eff0: 6e6f 2020 2020 2020 2020 2020 2020 206e no n │ │ │ │ │ +0003f000: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ +0003f010: 0a62 6164 7261 6d20 2020 2020 2020 2020 .badram │ │ │ │ │ +0003f020: 7965 7320 282a 2920 2020 2020 2020 206e yes (*) n │ │ │ │ │ +0003f030: 6f20 2020 2020 2020 2020 2020 2020 6e6f o no │ │ │ │ │ +0003f040: 2020 2020 2020 2020 2020 2020 206e 6f0a no. │ │ │ │ │ +0003f050: 636f 6d70 7265 7373 696f 6e20 2020 2063 compression c │ │ │ │ │ +0003f060: 6f6e 6669 6775 7261 626c 6520 2020 6e6f onfigurable no │ │ │ │ │ +0003f070: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ +0003f080: 2020 2020 2020 2020 2020 2020 636f 6e66 conf │ │ │ │ │ +0003f090: 6967 7572 6162 6c65 0a65 7869 7420 2020 igurable.exit │ │ │ │ │ +0003f0a0: 2020 2020 2020 2020 6e6f 2020 2020 2020 no │ │ │ │ │ +0003f0b0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +0003f0c0: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ │ +0003f0d0: 2020 2020 2079 6573 0a62 6f6f 746c 6f63 yes.bootloc │ │ │ │ │ +0003f0e0: 6174 696f 6e20 2020 6e6f 2020 2020 2020 ation no │ │ │ │ │ +0003f0f0: 2020 2020 2020 2070 6172 7469 7469 6f6e partition │ │ │ │ │ +0003f100: 2020 2020 2020 6669 6c65 2020 2020 2020 file │ │ │ │ │ +0003f110: 2020 2020 2066 696c 6520 282a 290a 0a20 file (*).. │ │ │ │ │ +0003f120: 2020 2020 2020 2020 2020 2020 2020 4d49 MI │ │ │ │ │ +0003f130: 5053 2071 656d 7520 2020 2020 2065 6d75 PS qemu emu │ │ │ │ │ +0003f140: 2020 2020 2020 2020 2020 2020 7865 6e0a xen. │ │ │ │ │ +0003f150: 7669 6465 6f20 2020 2020 2020 2020 206e video n │ │ │ │ │ +0003f160: 6f20 2020 2020 2020 2020 2020 2020 7965 o ye │ │ │ │ │ +0003f170: 7320 2020 2020 2020 2020 2020 206e 6f0a s no. │ │ │ │ │ +0003f180: 636f 6e73 6f6c 6520 2020 2020 2020 2043 console C │ │ │ │ │ +0003f190: 5034 3337 2020 2020 2020 2020 2020 556e P437 Un │ │ │ │ │ +0003f1a0: 6963 6f64 6520 282a 2920 2020 2041 5343 icode (*) ASC │ │ │ │ │ +0003f1b0: 4949 0a63 6861 7273 6574 0a6e 6574 776f II.charset.netwo │ │ │ │ │ +0003f1c0: 726b 2020 2020 2020 2020 6e6f 2020 2020 rk no │ │ │ │ │ +0003f1d0: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ +0003f1e0: 2020 2020 2020 2020 6e6f 0a41 5441 2f41 no.ATA/A │ │ │ │ │ +0003f1f0: 4843 4920 2020 2020 2020 7965 7320 2020 HCI yes │ │ │ │ │ +0003f200: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003f210: 2020 2020 2020 2020 6e6f 0a41 5420 6b65 no.AT ke │ │ │ │ │ +0003f220: 7962 6f61 7264 2020 2020 7965 7320 2020 yboard yes │ │ │ │ │ +0003f230: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003f240: 2020 2020 2020 2020 6e6f 0a53 7065 616b no.Speak │ │ │ │ │ +0003f250: 6572 2020 2020 2020 2020 6e6f 2020 2020 er no │ │ │ │ │ +0003f260: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003f270: 2020 2020 2020 2020 6e6f 0a55 5342 2020 no.USB │ │ │ │ │ +0003f280: 2020 2020 2020 2020 2020 4e2f 4120 2020 N/A │ │ │ │ │ +0003f290: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ +0003f2a0: 2020 2020 2020 2020 6e6f 0a63 6861 696e no.chain │ │ │ │ │ +0003f2b0: 6c6f 6164 6572 2020 2020 7965 7320 2020 loader yes │ │ │ │ │ +0003f2c0: 2020 2020 2020 2020 206e 6f20 2020 2020 no │ │ │ │ │ +0003f2d0: 2020 2020 2020 2020 7965 730a 6370 7569 yes.cpui │ │ │ │ │ +0003f2e0: 6420 2020 2020 2020 2020 206e 6f20 2020 d no │ │ │ │ │ +0003f2f0: 2020 2020 2020 2020 2020 6e6f 2020 2020 no │ │ │ │ │ +0003f300: 2020 2020 2020 2020 2079 6573 0a72 646d yes.rdm │ │ │ │ │ +0003f310: 7372 2020 2020 2020 2020 2020 6e6f 2020 sr no │ │ │ │ │ +0003f320: 2020 2020 2020 2020 2020 206e 6f20 2020 no │ │ │ │ │ +0003f330: 2020 2020 2020 2020 2020 7965 730a 7772 yes.wr │ │ │ │ │ +0003f340: 6d73 7220 2020 2020 2020 2020 206e 6f20 msr no │ │ │ │ │ +0003f350: 2020 2020 2020 2020 2020 2020 6e6f 2020 no │ │ │ │ │ +0003f360: 2020 2020 2020 2020 2020 2079 6573 0a68 yes.h │ │ │ │ │ +0003f370: 696e 7473 2020 2020 2020 2020 2020 6775 ints gu │ │ │ │ │ +0003f380: 6573 7320 2020 2020 2020 2020 206e 6f20 ess no │ │ │ │ │ +0003f390: 2020 2020 2020 2020 2020 2020 6e6f 0a50 no.P │ │ │ │ │ +0003f3a0: 4349 2020 2020 2020 2020 2020 2020 6e6f CI no │ │ │ │ │ +0003f3b0: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ +0003f3c0: 2020 2020 2020 2020 2020 2020 6e6f 0a62 no.b │ │ │ │ │ +0003f3d0: 6164 7261 6d20 2020 2020 2020 2020 7965 adram ye │ │ │ │ │ +0003f3e0: 7320 282a 2920 2020 2020 2020 206e 6f20 s (*) no │ │ │ │ │ +0003f3f0: 2020 2020 2020 2020 2020 2020 6e6f 0a63 no.c │ │ │ │ │ +0003f400: 6f6d 7072 6573 7369 6f6e 2020 2020 636f ompression co │ │ │ │ │ +0003f410: 6e66 6967 7572 6162 6c65 2020 206e 6f20 nfigurable no │ │ │ │ │ +0003f420: 2020 2020 2020 2020 2020 2020 6e6f 0a65 no.e │ │ │ │ │ +0003f430: 7869 7420 2020 2020 2020 2020 2020 6e6f xit no │ │ │ │ │ +0003f440: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ +0003f450: 2020 2020 2020 2020 2020 2020 6e6f 0a62 no.b │ │ │ │ │ +0003f460: 6f6f 746c 6f63 6174 696f 6e20 2020 6e6f ootlocation no │ │ │ │ │ +0003f470: 2020 2020 2020 2020 2020 2020 2066 696c fil │ │ │ │ │ +0003f480: 6520 2020 2020 2020 2020 2020 6e6f 0a0a e no.. │ │ │ │ │ +0003f490: 1f0a 4669 6c65 3a20 6772 7562 2e69 6e66 ..File: grub.inf │ │ │ │ │ +0003f4a0: 6f2c 2020 4e6f 6465 3a20 506c 6174 666f o, Node: Platfo │ │ │ │ │ +0003f4b0: 726d 2d73 7065 6369 6669 6320 6f70 6572 rm-specific oper │ │ │ │ │ +0003f4c0: 6174 696f 6e73 2c20 204e 6578 743a 2053 ations, Next: S │ │ │ │ │ +0003f4d0: 7570 706f 7274 6564 206b 6572 6e65 6c73 upported kernels │ │ │ │ │ +0003f4e0: 2c20 2050 7265 763a 2050 6c61 7466 6f72 , Prev: Platfor │ │ │ │ │ +0003f4f0: 6d20 6c69 6d69 7461 7469 6f6e 732c 2020 m limitations, │ │ │ │ │ +0003f500: 5570 3a20 546f 700a 0a32 3020 4f75 746c Up: Top..20 Outl │ │ │ │ │ +0003f510: 696e 650a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a ine.**********.. │ │ │ │ │ +0003f520: 536f 6d65 2070 6c61 7466 6f72 6d73 2068 Some platforms h │ │ │ │ │ +0003f530: 6176 6520 6665 6174 7572 6573 2077 6869 ave features whi │ │ │ │ │ +0003f540: 6368 2061 6c6c 6f77 7320 746f 2069 6d70 ch allows to imp │ │ │ │ │ +0003f550: 6c65 6d65 6e74 2073 6f6d 6520 636f 6d6d lement some comm │ │ │ │ │ +0003f560: 616e 6473 0a75 7365 6c65 7373 206f 7220 ands.useless or │ │ │ │ │ +0003f570: 6e6f 7420 696d 706c 656d 656e 7461 626c not implementabl │ │ │ │ │ +0003f580: 6520 6f6e 206f 7468 6572 732e 0a0a 2020 e on others... │ │ │ │ │ +0003f590: 2051 7569 636b 2073 756d 6d61 7279 3a0a Quick summary:. │ │ │ │ │ +0003f5a0: 0a20 2020 496e 666f 726d 6174 696f 6e20 . Information │ │ │ │ │ +0003f5b0: 7265 7472 6965 7661 6c3a 0a0a 2020 202a retrieval:.. * │ │ │ │ │ +0003f5c0: 206d 6970 7365 6c2d 6c6f 6f6e 6773 6f6e mipsel-loongson │ │ │ │ │ +0003f5d0: 3a20 6c73 7370 640a 2020 202a 206d 6970 : lsspd. * mip │ │ │ │ │ +0003f5e0: 732d 6172 633a 206c 7364 6576 0a20 2020 s-arc: lsdev. │ │ │ │ │ +0003f5f0: 2a20 6566 693a 206c 7365 6669 7379 7374 * efi: lsefisyst │ │ │ │ │ +0003f600: 6162 2c20 6c73 7361 6c2c 206c 7365 6669 ab, lssal, lsefi │ │ │ │ │ +0003f610: 6d6d 6170 2c20 6c73 6566 690a 2020 202a mmap, lsefi. * │ │ │ │ │ +0003f620: 2069 3338 362d 7063 3a20 6c73 6170 6d0a i386-pc: lsapm. │ │ │ │ │ +0003f630: 2020 202a 2069 3338 362d 636f 7265 626f * i386-corebo │ │ │ │ │ +0003f640: 6f74 3a20 6c73 636f 7265 626f 6f74 2c20 ot: lscoreboot, │ │ │ │ │ +0003f650: 636f 7265 626f 6f74 5f62 6f6f 7474 696d coreboot_boottim │ │ │ │ │ +0003f660: 652c 2063 626d 656d 630a 2020 202a 2061 e, cbmemc. * a │ │ │ │ │ +0003f670: 6370 692d 656e 6162 6c65 6420 2869 3338 cpi-enabled (i38 │ │ │ │ │ +0003f680: 362d 7063 2c20 6933 3836 2d63 6f72 6562 6-pc, i386-coreb │ │ │ │ │ +0003f690: 6f6f 742c 2069 3338 362d 6d75 6c74 6962 oot, i386-multib │ │ │ │ │ +0003f6a0: 6f6f 742c 202a 2d65 6669 293a 0a20 2020 oot, *-efi):. │ │ │ │ │ +0003f6b0: 2020 6c73 6163 7069 0a0a 2020 2057 6f72 lsacpi.. Wor │ │ │ │ │ +0003f6c0: 6b61 726f 756e 6473 2066 6f72 2070 6c61 karounds for pla │ │ │ │ │ +0003f6d0: 7466 6f72 6d2d 7370 6563 6966 6963 2069 tform-specific i │ │ │ │ │ +0003f6e0: 7373 7565 733a 0a20 2020 2a20 6933 3836 ssues:. * i386 │ │ │ │ │ +0003f6f0: 2d65 6669 2f78 3836 5f36 342d 6566 693a -efi/x86_64-efi: │ │ │ │ │ +0003f700: 206c 6f61 6462 696f 732c 2066 616b 6562 loadbios, fakeb │ │ │ │ │ +0003f710: 696f 732c 2066 6978 5f76 6964 656f 0a20 ios, fix_video. │ │ │ │ │ +0003f720: 2020 2a20 6163 7069 2d65 6e61 626c 6564 * acpi-enabled │ │ │ │ │ +0003f730: 2028 6933 3836 2d70 632c 2069 3338 362d (i386-pc, i386- │ │ │ │ │ +0003f740: 636f 7265 626f 6f74 2c20 6933 3836 2d6d coreboot, i386-m │ │ │ │ │ +0003f750: 756c 7469 626f 6f74 2c20 2a2d 6566 6929 ultiboot, *-efi) │ │ │ │ │ +0003f760: 3a20 6163 7069 0a20 2020 2020 286f 7665 : acpi. (ove │ │ │ │ │ +0003f770: 7272 6964 6520 4143 5049 2074 6162 6c65 rride ACPI table │ │ │ │ │ +0003f780: 7329 0a20 2020 2a20 6933 3836 2d70 633a s). * i386-pc: │ │ │ │ │ +0003f790: 2064 7269 7665 6d61 700a 2020 202a 2069 drivemap. * i │ │ │ │ │ +0003f7a0: 3338 362d 7063 3a20 7365 6e64 6b65 790a 386-pc: sendkey. │ │ │ │ │ +0003f7b0: 0a20 2020 4164 7661 6e63 6564 206f 7065 . Advanced ope │ │ │ │ │ +0003f7c0: 7261 7469 6f6e 7320 666f 7220 706f 7765 rations for powe │ │ │ │ │ +0003f7d0: 7220 7573 6572 733a 0a20 2020 2a20 7838 r users:. * x8 │ │ │ │ │ +0003f7e0: 363a 2069 6f72 7720 2864 6972 6563 7420 6: iorw (direct │ │ │ │ │ +0003f7f0: 6163 6365 7373 2074 6f20 492f 4f20 706f access to I/O po │ │ │ │ │ +0003f800: 7274 7329 0a0a 2020 204d 6973 6365 6c61 rts).. Miscela │ │ │ │ │ +0003f810: 6e65 6f75 733a 0a20 2020 2a20 636d 6f73 neous:. * cmos │ │ │ │ │ +0003f820: 2028 7838 362d 2a2c 2069 6565 6531 3237 (x86-*, ieee127 │ │ │ │ │ +0003f830: 352c 206d 6970 732d 7165 6d75 5f6d 6970 5, mips-qemu_mip │ │ │ │ │ +0003f840: 732c 206d 6970 732d 6c6f 6f6e 6773 6f6e s, mips-loongson │ │ │ │ │ +0003f850: 293a 2063 6d6f 7374 6573 740a 2020 2020 ): cmostest. │ │ │ │ │ +0003f860: 2028 7573 6564 206f 6e20 736f 6d65 206c (used on some l │ │ │ │ │ +0003f870: 6170 746f 7073 2074 6f20 6368 6563 6b20 aptops to check │ │ │ │ │ +0003f880: 666f 7220 7370 6563 6961 6c20 706f 7765 for special powe │ │ │ │ │ +0003f890: 722d 6f6e 206b 6579 292c 2063 6d6f 7363 r-on key), cmosc │ │ │ │ │ +0003f8a0: 6c65 616e 0a20 2020 2a20 6933 3836 2d70 lean. * i386-p │ │ │ │ │ +0003f8b0: 633a 2070 6c61 790a 0a1f 0a46 696c 653a c: play....File: │ │ │ │ │ +0003f8c0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ +0003f8d0: 653a 2053 7570 706f 7274 6564 206b 6572 e: Supported ker │ │ │ │ │ +0003f8e0: 6e65 6c73 2c20 204e 6578 743a 2054 726f nels, Next: Tro │ │ │ │ │ +0003f8f0: 7562 6c65 7368 6f6f 7469 6e67 2c20 2050 ubleshooting, P │ │ │ │ │ +0003f900: 7265 763a 2050 6c61 7466 6f72 6d2d 7370 rev: Platform-sp │ │ │ │ │ +0003f910: 6563 6966 6963 206f 7065 7261 7469 6f6e ecific operation │ │ │ │ │ +0003f920: 732c 2020 5570 3a20 546f 700a 0a32 3120 s, Up: Top..21 │ │ │ │ │ +0003f930: 5375 7070 6f72 7465 6420 626f 6f74 2074 Supported boot t │ │ │ │ │ +0003f940: 6172 6765 7473 0a2a 2a2a 2a2a 2a2a 2a2a argets.********* │ │ │ │ │ +0003f950: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +0003f960: 0a0a 5838 3620 7375 7070 6f72 7420 6973 ..X86 support is │ │ │ │ │ +0003f970: 2073 756d 6d61 7269 7365 6420 696e 2074 summarised in t │ │ │ │ │ +0003f980: 6865 2066 6f6c 6c6f 7769 6e67 2074 6162 he following tab │ │ │ │ │ +0003f990: 6c65 2e20 2022 5965 7322 206d 6561 6e73 le. "Yes" means │ │ │ │ │ +0003f9a0: 2074 6861 7420 7468 650a 6b65 726e 656c that the.kernel │ │ │ │ │ +0003f9b0: 2077 6f72 6b73 206f 6e20 7468 6520 6769 works on the gi │ │ │ │ │ +0003f9c0: 7665 6e20 706c 6174 666f 726d 2c20 2263 ven platform, "c │ │ │ │ │ +0003f9d0: 7261 7368 6573 2220 6d65 616e 7320 616e rashes" means an │ │ │ │ │ +0003f9e0: 2065 6172 6c79 206b 6572 6e65 6c0a 6372 early kernel.cr │ │ │ │ │ +0003f9f0: 6173 6820 7768 6963 6820 7765 2068 6f70 ash which we hop │ │ │ │ │ +0003fa00: 6520 7769 6c6c 2062 6520 6669 7865 6420 e will be fixed │ │ │ │ │ +0003fa10: 6279 2063 6f6e 6365 726e 6564 206b 6572 by concerned ker │ │ │ │ │ +0003fa20: 6e65 6c20 6465 7665 6c6f 7065 7273 2e20 nel developers. │ │ │ │ │ +0003fa30: 2022 6e6f 220a 6d65 616e 7320 4752 5542 "no".means GRUB │ │ │ │ │ +0003fa40: 2064 6f65 736e 2774 206c 6f61 6420 7468 doesn't load th │ │ │ │ │ +0003fa50: 6520 6769 7665 6e20 6b65 726e 656c 206f e given kernel o │ │ │ │ │ +0003fa60: 6e20 6120 6769 7665 6e20 706c 6174 666f n a given platfo │ │ │ │ │ +0003fa70: 726d 2e0a 2268 6561 646c 6573 7322 206d rm.."headless" m │ │ │ │ │ +0003fa80: 6561 6e73 2074 6861 7420 7468 6520 6b65 eans that the ke │ │ │ │ │ +0003fa90: 726e 656c 2077 6f72 6b73 2062 7574 206c rnel works but l │ │ │ │ │ +0003faa0: 6163 6b73 2063 6f6e 736f 6c65 2064 7269 acks console dri │ │ │ │ │ +0003fab0: 7665 7273 2028 796f 750a 6361 6e20 7374 vers (you.can st │ │ │ │ │ +0003fac0: 696c 6c20 7573 6520 7365 7269 616c 206f ill use serial o │ │ │ │ │ +0003fad0: 7220 6e65 7477 6f72 6b20 636f 6e73 6f6c r network consol │ │ │ │ │ +0003fae0: 6529 2e20 2049 6e20 6361 7365 206f 6620 e). In case of │ │ │ │ │ +0003faf0: 226e 6f22 2061 6e64 2022 6372 6173 6865 "no" and "crashe │ │ │ │ │ +0003fb00: 7322 0a74 6865 2072 6561 736f 6e20 6973 s".the reason is │ │ │ │ │ +0003fb10: 2067 6976 656e 2069 6e20 666f 6f74 6e6f given in footno │ │ │ │ │ +0003fb20: 7465 2e0a 2020 2020 2020 2020 2020 2020 te.. │ │ │ │ │ 0003fb30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fb40: 2020 2020 2020 2042 494f 5320 2020 2020 BIOS │ │ │ │ │ -0003fb50: 2020 2020 2020 2020 436f 7265 626f 6f74 Coreboot │ │ │ │ │ -0003fb60: 0a42 494f 5320 6368 6169 6e6c 6f61 6469 .BIOS chainloadi │ │ │ │ │ -0003fb70: 6e67 2020 2020 2020 2020 2020 2020 2020 ng │ │ │ │ │ -0003fb80: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ │ -0003fb90: 2020 2020 2020 206e 6f20 2831 290a 4e54 no (1).NT │ │ │ │ │ -0003fba0: 4c44 5220 2020 2020 2020 2020 2020 2020 LDR │ │ │ │ │ +0003fb40: 2020 2020 2020 2020 2042 494f 5320 2020 BIOS │ │ │ │ │ +0003fb50: 2020 2020 2020 2020 2020 436f 7265 626f Corebo │ │ │ │ │ +0003fb60: 6f74 0a42 494f 5320 6368 6169 6e6c 6f61 ot.BIOS chainloa │ │ │ │ │ +0003fb70: 6469 6e67 2020 2020 2020 2020 2020 2020 ding │ │ │ │ │ +0003fb80: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ │ +0003fb90: 2020 2020 2020 2020 206e 6f20 2831 290a no (1). │ │ │ │ │ +0003fba0: 4e54 4c44 5220 2020 2020 2020 2020 2020 NTLDR │ │ │ │ │ 0003fbb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fbc0: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003fbd0: 2020 2020 6e6f 2028 3129 0a50 6c61 6e39 no (1).Plan9 │ │ │ │ │ -0003fbe0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003fbc0: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +0003fbd0: 2020 2020 2020 6e6f 2028 3129 0a50 6c61 no (1).Pla │ │ │ │ │ +0003fbe0: 6e39 2020 2020 2020 2020 2020 2020 2020 n9 │ │ │ │ │ 0003fbf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fc00: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003fc10: 206e 6f20 2831 290a 4672 6565 646f 7320 no (1).Freedos │ │ │ │ │ -0003fc20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fc30: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ -0003fc40: 2020 2020 2020 2020 2020 2020 2020 6e6f no │ │ │ │ │ -0003fc50: 2028 3129 0a46 7265 6542 5344 2062 6f6f (1).FreeBSD boo │ │ │ │ │ -0003fc60: 746c 6f61 6465 7220 2020 2020 2020 2020 tloader │ │ │ │ │ -0003fc70: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ -0003fc80: 2020 2020 2020 2020 2020 2063 7261 7368 crash │ │ │ │ │ -0003fc90: 6573 2028 3129 0a33 322d 6269 7420 6b46 es (1).32-bit kF │ │ │ │ │ -0003fca0: 7265 6542 5344 2020 2020 2020 2020 2020 reeBSD │ │ │ │ │ -0003fcb0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ -0003fcc0: 2020 2020 2020 2020 2020 2020 2063 7261 cra │ │ │ │ │ -0003fcd0: 7368 6573 2028 3529 0a36 342d 6269 7420 shes (5).64-bit │ │ │ │ │ -0003fce0: 6b46 7265 6542 5344 2020 2020 2020 2020 kFreeBSD │ │ │ │ │ -0003fcf0: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ -0003fd00: 7320 2020 2020 2020 2020 2020 2020 2063 s c │ │ │ │ │ -0003fd10: 7261 7368 6573 2028 3529 0a33 322d 6269 rashes (5).32-bi │ │ │ │ │ -0003fd20: 7420 6b4e 6574 4253 4420 2020 2020 2020 t kNetBSD │ │ │ │ │ +0003fc00: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003fc10: 2020 206e 6f20 2831 290a 4672 6565 646f no (1).Freedo │ │ │ │ │ +0003fc20: 7320 2020 2020 2020 2020 2020 2020 2020 s │ │ │ │ │ +0003fc30: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ │ +0003fc40: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ │ +0003fc50: 6e6f 2028 3129 0a46 7265 6542 5344 2062 no (1).FreeBSD b │ │ │ │ │ +0003fc60: 6f6f 746c 6f61 6465 7220 2020 2020 2020 ootloader │ │ │ │ │ +0003fc70: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003fc80: 2020 2020 2020 2020 2020 2020 2063 7261 cra │ │ │ │ │ +0003fc90: 7368 6573 2028 3129 0a33 322d 6269 7420 shes (1).32-bit │ │ │ │ │ +0003fca0: 6b46 7265 6542 5344 2020 2020 2020 2020 kFreeBSD │ │ │ │ │ +0003fcb0: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ +0003fcc0: 7320 2020 2020 2020 2020 2020 2020 2063 s c │ │ │ │ │ +0003fcd0: 7261 7368 6573 2028 3529 0a36 342d 6269 rashes (5).64-bi │ │ │ │ │ +0003fce0: 7420 6b46 7265 6542 5344 2020 2020 2020 t kFreeBSD │ │ │ │ │ +0003fcf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003fd00: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003fd10: 2063 7261 7368 6573 2028 3529 0a33 322d crashes (5).32- │ │ │ │ │ +0003fd20: 6269 7420 6b4e 6574 4253 4420 2020 2020 bit kNetBSD │ │ │ │ │ 0003fd30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fd40: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003fd50: 2063 7261 7368 6573 2028 3129 0a36 342d crashes (1).64- │ │ │ │ │ -0003fd60: 6269 7420 6b4e 6574 4253 4420 2020 2020 bit kNetBSD │ │ │ │ │ +0003fd40: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003fd50: 2020 2063 7261 7368 6573 2028 3129 0a36 crashes (1).6 │ │ │ │ │ +0003fd60: 342d 6269 7420 6b4e 6574 4253 4420 2020 4-bit kNetBSD │ │ │ │ │ 0003fd70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fd80: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003fd90: 2020 2063 7261 7368 6573 0a33 322d 6269 crashes.32-bi │ │ │ │ │ -0003fda0: 7420 6b4f 7065 6e42 5344 2020 2020 2020 t kOpenBSD │ │ │ │ │ +0003fd80: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ +0003fd90: 2020 2020 2063 7261 7368 6573 0a33 322d crashes.32- │ │ │ │ │ +0003fda0: 6269 7420 6b4f 7065 6e42 5344 2020 2020 bit kOpenBSD │ │ │ │ │ 0003fdb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fdc0: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003fdd0: 2079 6573 0a36 342d 6269 7420 6b4f 7065 yes.64-bit kOpe │ │ │ │ │ -0003fde0: 6e42 5344 2020 2020 2020 2020 2020 2020 nBSD │ │ │ │ │ -0003fdf0: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ -0003fe00: 2020 2020 2020 2020 2020 2079 6573 0a4d yes.M │ │ │ │ │ -0003fe10: 756c 7469 626f 6f74 2020 2020 2020 2020 ultiboot │ │ │ │ │ +0003fdc0: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003fdd0: 2020 2079 6573 0a36 342d 6269 7420 6b4f yes.64-bit kO │ │ │ │ │ +0003fde0: 7065 6e42 5344 2020 2020 2020 2020 2020 penBSD │ │ │ │ │ +0003fdf0: 2020 2020 2020 2020 2020 2020 7965 7320 yes │ │ │ │ │ +0003fe00: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ +0003fe10: 0a4d 756c 7469 626f 6f74 2020 2020 2020 .Multiboot │ │ │ │ │ 0003fe20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003fe30: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ -0003fe40: 2020 2020 2079 6573 0a4d 756c 7469 626f yes.Multibo │ │ │ │ │ -0003fe50: 6f74 3220 2020 2020 2020 2020 2020 2020 ot2 │ │ │ │ │ -0003fe60: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ -0003fe70: 7320 2020 2020 2020 2020 2020 2020 2079 s y │ │ │ │ │ -0003fe80: 6573 0a33 322d 6269 7420 4c69 6e75 7820 es.32-bit Linux │ │ │ │ │ -0003fe90: 286c 6567 6163 7920 7072 6f74 6f63 6f6c (legacy protocol │ │ │ │ │ -0003fea0: 2920 2020 2020 2020 7965 7320 2020 2020 ) yes │ │ │ │ │ -0003feb0: 2020 2020 2020 2020 206e 6f20 2831 290a no (1). │ │ │ │ │ -0003fec0: 3634 2d62 6974 204c 696e 7578 2028 6c65 64-bit Linux (le │ │ │ │ │ -0003fed0: 6761 6379 2070 726f 746f 636f 6c29 2020 gacy protocol) │ │ │ │ │ -0003fee0: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ -0003fef0: 2020 2020 2020 6e6f 2028 3129 0a33 322d no (1).32- │ │ │ │ │ -0003ff00: 6269 7420 4c69 6e75 7820 286d 6f64 6572 bit Linux (moder │ │ │ │ │ -0003ff10: 6e20 7072 6f74 6f63 6f6c 2920 2020 2020 n protocol) │ │ │ │ │ -0003ff20: 2020 7965 7320 2020 2020 2020 2020 2020 yes │ │ │ │ │ -0003ff30: 2020 2079 6573 0a36 342d 6269 7420 4c69 yes.64-bit Li │ │ │ │ │ -0003ff40: 6e75 7820 286d 6f64 6572 6e20 7072 6f74 nux (modern prot │ │ │ │ │ -0003ff50: 6f63 6f6c 2920 2020 2020 2020 7965 7320 ocol) yes │ │ │ │ │ -0003ff60: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ -0003ff70: 0a33 322d 6269 7420 584e 5520 2020 2020 .32-bit XNU │ │ │ │ │ +0003fe30: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ │ +0003fe40: 2020 2020 2020 2079 6573 0a4d 756c 7469 yes.Multi │ │ │ │ │ +0003fe50: 626f 6f74 3220 2020 2020 2020 2020 2020 boot2 │ │ │ │ │ +0003fe60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003fe70: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003fe80: 2079 6573 0a33 322d 6269 7420 4c69 6e75 yes.32-bit Linu │ │ │ │ │ +0003fe90: 7820 286c 6567 6163 7920 7072 6f74 6f63 x (legacy protoc │ │ │ │ │ +0003fea0: 6f6c 2920 2020 2020 2020 7965 7320 2020 ol) yes │ │ │ │ │ +0003feb0: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ │ +0003fec0: 290a 3634 2d62 6974 204c 696e 7578 2028 ).64-bit Linux ( │ │ │ │ │ +0003fed0: 6c65 6761 6379 2070 726f 746f 636f 6c29 legacy protocol) │ │ │ │ │ +0003fee0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +0003fef0: 2020 2020 2020 2020 6e6f 2028 3129 0a33 no (1).3 │ │ │ │ │ +0003ff00: 322d 6269 7420 4c69 6e75 7820 286d 6f64 2-bit Linux (mod │ │ │ │ │ +0003ff10: 6572 6e20 7072 6f74 6f63 6f6c 2920 2020 ern protocol) │ │ │ │ │ +0003ff20: 2020 2020 7965 7320 2020 2020 2020 2020 yes │ │ │ │ │ +0003ff30: 2020 2020 2079 6573 0a36 342d 6269 7420 yes.64-bit │ │ │ │ │ +0003ff40: 4c69 6e75 7820 286d 6f64 6572 6e20 7072 Linux (modern pr │ │ │ │ │ +0003ff50: 6f74 6f63 6f6c 2920 2020 2020 2020 7965 otocol) ye │ │ │ │ │ +0003ff60: 7320 2020 2020 2020 2020 2020 2020 2079 s y │ │ │ │ │ +0003ff70: 6573 0a33 322d 6269 7420 584e 5520 2020 es.32-bit XNU │ │ │ │ │ 0003ff80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -0003ff90: 2020 2020 2020 7965 7320 2020 2020 2020 yes │ │ │ │ │ -0003ffa0: 2020 2020 2020 203f 0a36 342d 6269 7420 ?.64-bit │ │ │ │ │ -0003ffb0: 584e 5520 2020 2020 2020 2020 2020 2020 XNU │ │ │ │ │ -0003ffc0: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ -0003ffd0: 7320 2020 2020 2020 2020 2020 2020 203f s ? │ │ │ │ │ -0003ffe0: 0a33 322d 6269 7420 4546 4920 6368 6169 .32-bit EFI chai │ │ │ │ │ -0003fff0: 6e6c 6f61 6465 7220 2020 2020 2020 2020 nloader │ │ │ │ │ -00040000: 2020 2020 2020 6e6f 2028 3229 2020 2020 no (2) │ │ │ │ │ -00040010: 2020 2020 2020 206e 6f20 2832 290a 3634 no (2).64 │ │ │ │ │ -00040020: 2d62 6974 2045 4649 2063 6861 696e 6c6f -bit EFI chainlo │ │ │ │ │ -00040030: 6164 6572 2020 2020 2020 2020 2020 2020 ader │ │ │ │ │ -00040040: 2020 206e 6f20 2832 2920 2020 2020 2020 no (2) │ │ │ │ │ -00040050: 2020 2020 6e6f 2028 3229 0a41 7070 6c65 no (2).Apple │ │ │ │ │ -00040060: 6c6f 6164 6572 2020 2020 2020 2020 2020 loader │ │ │ │ │ +0003ff90: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ │ +0003ffa0: 2020 2020 2020 2020 203f 0a36 342d 6269 ?.64-bi │ │ │ │ │ +0003ffb0: 7420 584e 5520 2020 2020 2020 2020 2020 t XNU │ │ │ │ │ +0003ffc0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +0003ffd0: 7965 7320 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ +0003ffe0: 203f 0a33 322d 6269 7420 4546 4920 6368 ?.32-bit EFI ch │ │ │ │ │ +0003fff0: 6169 6e6c 6f61 6465 7220 2020 2020 2020 ainloader │ │ │ │ │ +00040000: 2020 2020 2020 2020 6e6f 2028 3229 2020 no (2) │ │ │ │ │ +00040010: 2020 2020 2020 2020 206e 6f20 2832 290a no (2). │ │ │ │ │ +00040020: 3634 2d62 6974 2045 4649 2063 6861 696e 64-bit EFI chain │ │ │ │ │ +00040030: 6c6f 6164 6572 2020 2020 2020 2020 2020 loader │ │ │ │ │ +00040040: 2020 2020 206e 6f20 2832 2920 2020 2020 no (2) │ │ │ │ │ +00040050: 2020 2020 2020 6e6f 2028 3229 0a41 7070 no (2).App │ │ │ │ │ +00040060: 6c65 6c6f 6164 6572 2020 2020 2020 2020 leloader │ │ │ │ │ 00040070: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040080: 6e6f 2028 3229 2020 2020 2020 2020 2020 no (2) │ │ │ │ │ -00040090: 206e 6f20 2832 290a 0a20 2020 2020 2020 no (2).. │ │ │ │ │ +00040080: 2020 6e6f 2028 3229 2020 2020 2020 2020 no (2) │ │ │ │ │ +00040090: 2020 206e 6f20 2832 290a 0a20 2020 2020 no (2).. │ │ │ │ │ 000400a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000400b0: 2020 2020 2020 2020 2020 2020 2020 4d75 Mu │ │ │ │ │ -000400c0: 6c74 6962 6f6f 7420 2020 2020 2020 2051 ltiboot Q │ │ │ │ │ -000400d0: 656d 750a 4249 4f53 2063 6861 696e 6c6f emu.BIOS chainlo │ │ │ │ │ -000400e0: 6164 696e 6720 2020 2020 2020 2020 2020 ading │ │ │ │ │ -000400f0: 2020 2020 2020 2020 206e 6f20 2831 2920 no (1) │ │ │ │ │ -00040100: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ │ -00040110: 0a4e 544c 4452 2020 2020 2020 2020 2020 .NTLDR │ │ │ │ │ +000400b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000400c0: 4d75 6c74 6962 6f6f 7420 2020 2020 2020 Multiboot │ │ │ │ │ +000400d0: 2051 656d 750a 4249 4f53 2063 6861 696e Qemu.BIOS chain │ │ │ │ │ +000400e0: 6c6f 6164 696e 6720 2020 2020 2020 2020 loading │ │ │ │ │ +000400f0: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ │ +00040100: 2920 2020 2020 2020 2020 2020 6e6f 2028 ) no ( │ │ │ │ │ +00040110: 3129 0a4e 544c 4452 2020 2020 2020 2020 1).NTLDR │ │ │ │ │ 00040120: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040130: 2020 2020 2020 6e6f 2028 3129 2020 2020 no (1) │ │ │ │ │ -00040140: 2020 2020 2020 206e 6f20 2831 290a 506c no (1).Pl │ │ │ │ │ -00040150: 616e 3920 2020 2020 2020 2020 2020 2020 an9 │ │ │ │ │ +00040130: 2020 2020 2020 2020 6e6f 2028 3129 2020 no (1) │ │ │ │ │ +00040140: 2020 2020 2020 2020 206e 6f20 2831 290a no (1). │ │ │ │ │ +00040150: 506c 616e 3920 2020 2020 2020 2020 2020 Plan9 │ │ │ │ │ 00040160: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040170: 2020 206e 6f20 2831 2920 2020 2020 2020 no (1) │ │ │ │ │ -00040180: 2020 2020 6e6f 2028 3129 0a46 7265 6544 no (1).FreeD │ │ │ │ │ -00040190: 4f53 2020 2020 2020 2020 2020 2020 2020 OS │ │ │ │ │ +00040170: 2020 2020 206e 6f20 2831 2920 2020 2020 no (1) │ │ │ │ │ +00040180: 2020 2020 2020 6e6f 2028 3129 0a46 7265 no (1).Fre │ │ │ │ │ +00040190: 6544 4f53 2020 2020 2020 2020 2020 2020 eDOS │ │ │ │ │ 000401a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000401b0: 6e6f 2028 3129 2020 2020 2020 2020 2020 no (1) │ │ │ │ │ -000401c0: 206e 6f20 2831 290a 4672 6565 4253 4420 no (1).FreeBSD │ │ │ │ │ -000401d0: 626f 6f74 6c6f 6164 6572 2020 2020 2020 bootloader │ │ │ │ │ -000401e0: 2020 2020 2020 2020 2020 2020 2063 7261 cra │ │ │ │ │ -000401f0: 7368 6573 2028 3129 2020 2020 2020 6372 shes (1) cr │ │ │ │ │ -00040200: 6173 6865 7320 2831 290a 3332 2d62 6974 ashes (1).32-bit │ │ │ │ │ -00040210: 206b 4672 6565 4253 4420 2020 2020 2020 kFreeBSD │ │ │ │ │ -00040220: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ │ -00040230: 7261 7368 6573 2028 3529 2020 2020 2020 rashes (5) │ │ │ │ │ -00040240: 6372 6173 6865 7320 2835 290a 3634 2d62 crashes (5).64-b │ │ │ │ │ -00040250: 6974 206b 4672 6565 4253 4420 2020 2020 it kFreeBSD │ │ │ │ │ +000401b0: 2020 6e6f 2028 3129 2020 2020 2020 2020 no (1) │ │ │ │ │ +000401c0: 2020 206e 6f20 2831 290a 4672 6565 4253 no (1).FreeBS │ │ │ │ │ +000401d0: 4420 626f 6f74 6c6f 6164 6572 2020 2020 D bootloader │ │ │ │ │ +000401e0: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ │ +000401f0: 7261 7368 6573 2028 3129 2020 2020 2020 rashes (1) │ │ │ │ │ +00040200: 6372 6173 6865 7320 2831 290a 3332 2d62 crashes (1).32-b │ │ │ │ │ +00040210: 6974 206b 4672 6565 4253 4420 2020 2020 it kFreeBSD │ │ │ │ │ +00040220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00040230: 2063 7261 7368 6573 2028 3529 2020 2020 crashes (5) │ │ │ │ │ +00040240: 2020 6372 6173 6865 7320 2835 290a 3634 crashes (5).64 │ │ │ │ │ +00040250: 2d62 6974 206b 4672 6565 4253 4420 2020 -bit kFreeBSD │ │ │ │ │ 00040260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040270: 2063 7261 7368 6573 2028 3529 2020 2020 crashes (5) │ │ │ │ │ -00040280: 2020 6372 6173 6865 7320 2835 290a 3332 crashes (5).32 │ │ │ │ │ -00040290: 2d62 6974 206b 4e65 7442 5344 2020 2020 -bit kNetBSD │ │ │ │ │ +00040270: 2020 2063 7261 7368 6573 2028 3529 2020 crashes (5) │ │ │ │ │ +00040280: 2020 2020 6372 6173 6865 7320 2835 290a crashes (5). │ │ │ │ │ +00040290: 3332 2d62 6974 206b 4e65 7442 5344 2020 32-bit kNetBSD │ │ │ │ │ 000402a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000402b0: 2020 2063 7261 7368 6573 2028 3129 2020 crashes (1) │ │ │ │ │ -000402c0: 2020 2020 6372 6173 6865 7320 2831 290a crashes (1). │ │ │ │ │ -000402d0: 3634 2d62 6974 206b 4e65 7442 5344 2020 64-bit kNetBSD │ │ │ │ │ +000402b0: 2020 2020 2063 7261 7368 6573 2028 3129 crashes (1) │ │ │ │ │ +000402c0: 2020 2020 2020 6372 6173 6865 7320 2831 crashes (1 │ │ │ │ │ +000402d0: 290a 3634 2d62 6974 206b 4e65 7442 5344 ).64-bit kNetBSD │ │ │ │ │ 000402e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000402f0: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ -00040300: 2020 2020 2020 7965 730a 3332 2d62 6974 yes.32-bit │ │ │ │ │ -00040310: 206b 4f70 656e 4253 4420 2020 2020 2020 kOpenBSD │ │ │ │ │ -00040320: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ │ -00040330: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ │ -00040340: 7965 730a 3634 2d62 6974 206b 4f70 656e yes.64-bit kOpen │ │ │ │ │ -00040350: 4253 4420 2020 2020 2020 2020 2020 2020 BSD │ │ │ │ │ -00040360: 2020 2020 2020 2020 2079 6573 2020 2020 yes │ │ │ │ │ -00040370: 2020 2020 2020 2020 2020 7965 730a 4d75 yes.Mu │ │ │ │ │ -00040380: 6c74 6962 6f6f 7420 2020 2020 2020 2020 ltiboot │ │ │ │ │ +000402f0: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +00040300: 2020 2020 2020 2020 7965 730a 3332 2d62 yes.32-b │ │ │ │ │ +00040310: 6974 206b 4f70 656e 4253 4420 2020 2020 it kOpenBSD │ │ │ │ │ +00040320: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00040330: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ +00040340: 2020 7965 730a 3634 2d62 6974 206b 4f70 yes.64-bit kOp │ │ │ │ │ +00040350: 656e 4253 4420 2020 2020 2020 2020 2020 enBSD │ │ │ │ │ +00040360: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ +00040370: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ │ +00040380: 4d75 6c74 6962 6f6f 7420 2020 2020 2020 Multiboot │ │ │ │ │ 00040390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000403a0: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ -000403b0: 2020 2020 7965 730a 4d75 6c74 6962 6f6f yes.Multiboo │ │ │ │ │ -000403c0: 7432 2020 2020 2020 2020 2020 2020 2020 t2 │ │ │ │ │ -000403d0: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ -000403e0: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ -000403f0: 730a 3332 2d62 6974 204c 696e 7578 2028 s.32-bit Linux ( │ │ │ │ │ -00040400: 6c65 6761 6379 2070 726f 746f 636f 6c29 legacy protocol) │ │ │ │ │ -00040410: 2020 2020 2020 206e 6f20 2831 2920 2020 no (1) │ │ │ │ │ -00040420: 2020 2020 2020 2020 6e6f 2028 3129 0a36 no (1).6 │ │ │ │ │ -00040430: 342d 6269 7420 4c69 6e75 7820 286c 6567 4-bit Linux (leg │ │ │ │ │ -00040440: 6163 7920 7072 6f74 6f63 6f6c 2920 2020 acy protocol) │ │ │ │ │ -00040450: 2020 2020 6e6f 2028 3129 2020 2020 2020 no (1) │ │ │ │ │ -00040460: 2020 2020 206e 6f20 2831 290a 3332 2d62 no (1).32-b │ │ │ │ │ -00040470: 6974 204c 696e 7578 2028 6d6f 6465 726e it Linux (modern │ │ │ │ │ -00040480: 2070 726f 746f 636f 6c29 2020 2020 2020 protocol) │ │ │ │ │ -00040490: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -000404a0: 2020 7965 730a 3634 2d62 6974 204c 696e yes.64-bit Lin │ │ │ │ │ -000404b0: 7578 2028 6d6f 6465 726e 2070 726f 746f ux (modern proto │ │ │ │ │ -000404c0: 636f 6c29 2020 2020 2020 2079 6573 2020 col) yes │ │ │ │ │ -000404d0: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ │ -000404e0: 3332 2d62 6974 2058 4e55 2020 2020 2020 32-bit XNU │ │ │ │ │ +000403a0: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +000403b0: 2020 2020 2020 7965 730a 4d75 6c74 6962 yes.Multib │ │ │ │ │ +000403c0: 6f6f 7432 2020 2020 2020 2020 2020 2020 oot2 │ │ │ │ │ +000403d0: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ │ +000403e0: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ │ +000403f0: 7965 730a 3332 2d62 6974 204c 696e 7578 yes.32-bit Linux │ │ │ │ │ +00040400: 2028 6c65 6761 6379 2070 726f 746f 636f (legacy protoco │ │ │ │ │ +00040410: 6c29 2020 2020 2020 206e 6f20 2831 2920 l) no (1) │ │ │ │ │ +00040420: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ │ +00040430: 0a36 342d 6269 7420 4c69 6e75 7820 286c .64-bit Linux (l │ │ │ │ │ +00040440: 6567 6163 7920 7072 6f74 6f63 6f6c 2920 egacy protocol) │ │ │ │ │ +00040450: 2020 2020 2020 6e6f 2028 3129 2020 2020 no (1) │ │ │ │ │ +00040460: 2020 2020 2020 206e 6f20 2831 290a 3332 no (1).32 │ │ │ │ │ +00040470: 2d62 6974 204c 696e 7578 2028 6d6f 6465 -bit Linux (mode │ │ │ │ │ +00040480: 726e 2070 726f 746f 636f 6c29 2020 2020 rn protocol) │ │ │ │ │ +00040490: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ +000404a0: 2020 2020 7965 730a 3634 2d62 6974 204c yes.64-bit L │ │ │ │ │ +000404b0: 696e 7578 2028 6d6f 6465 726e 2070 726f inux (modern pro │ │ │ │ │ +000404c0: 746f 636f 6c29 2020 2020 2020 2079 6573 tocol) yes │ │ │ │ │ +000404d0: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ +000404e0: 730a 3332 2d62 6974 2058 4e55 2020 2020 s.32-bit XNU │ │ │ │ │ 000404f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040500: 2020 2020 203f 2020 2020 2020 2020 2020 ? │ │ │ │ │ -00040510: 2020 2020 2020 3f0a 3634 2d62 6974 2058 ?.64-bit X │ │ │ │ │ -00040520: 4e55 2020 2020 2020 2020 2020 2020 2020 NU │ │ │ │ │ -00040530: 2020 2020 2020 2020 2020 2020 203f 2020 ? │ │ │ │ │ -00040540: 2020 2020 2020 2020 2020 2020 2020 3f0a ?. │ │ │ │ │ -00040550: 3332 2d62 6974 2045 4649 2063 6861 696e 32-bit EFI chain │ │ │ │ │ -00040560: 6c6f 6164 6572 2020 2020 2020 2020 2020 loader │ │ │ │ │ -00040570: 2020 2020 206e 6f20 2832 2920 2020 2020 no (2) │ │ │ │ │ -00040580: 2020 2020 2020 6e6f 2028 3229 0a36 342d no (2).64- │ │ │ │ │ -00040590: 6269 7420 4546 4920 6368 6169 6e6c 6f61 bit EFI chainloa │ │ │ │ │ -000405a0: 6465 7220 2020 2020 2020 2020 2020 2020 der │ │ │ │ │ -000405b0: 2020 6e6f 2028 3229 2020 2020 2020 2020 no (2) │ │ │ │ │ -000405c0: 2020 206e 6f20 2832 290a 4170 706c 656c no (2).Applel │ │ │ │ │ -000405d0: 6f61 6465 7220 2020 2020 2020 2020 2020 oader │ │ │ │ │ -000405e0: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ │ -000405f0: 6f20 2832 2920 2020 2020 2020 2020 2020 o (2) │ │ │ │ │ -00040600: 6e6f 2028 3229 0a0a 2020 2020 2020 2020 no (2).. │ │ │ │ │ +00040500: 2020 2020 2020 203f 2020 2020 2020 2020 ? │ │ │ │ │ +00040510: 2020 2020 2020 2020 3f0a 3634 2d62 6974 ?.64-bit │ │ │ │ │ +00040520: 2058 4e55 2020 2020 2020 2020 2020 2020 XNU │ │ │ │ │ +00040530: 2020 2020 2020 2020 2020 2020 2020 203f ? │ │ │ │ │ +00040540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00040550: 3f0a 3332 2d62 6974 2045 4649 2063 6861 ?.32-bit EFI cha │ │ │ │ │ +00040560: 696e 6c6f 6164 6572 2020 2020 2020 2020 inloader │ │ │ │ │ +00040570: 2020 2020 2020 206e 6f20 2832 2920 2020 no (2) │ │ │ │ │ +00040580: 2020 2020 2020 2020 6e6f 2028 3229 0a36 no (2).6 │ │ │ │ │ +00040590: 342d 6269 7420 4546 4920 6368 6169 6e6c 4-bit EFI chainl │ │ │ │ │ +000405a0: 6f61 6465 7220 2020 2020 2020 2020 2020 oader │ │ │ │ │ +000405b0: 2020 2020 6e6f 2028 3229 2020 2020 2020 no (2) │ │ │ │ │ +000405c0: 2020 2020 206e 6f20 2832 290a 4170 706c no (2).Appl │ │ │ │ │ +000405d0: 656c 6f61 6465 7220 2020 2020 2020 2020 eloader │ │ │ │ │ +000405e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000405f0: 206e 6f20 2832 2920 2020 2020 2020 2020 no (2) │ │ │ │ │ +00040600: 2020 6e6f 2028 3229 0a0a 2020 2020 2020 no (2).. │ │ │ │ │ 00040610: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040620: 2020 2020 2020 2020 2020 2020 2069 6133 ia3 │ │ │ │ │ -00040630: 3220 4546 4920 2020 2020 2020 2020 616d 2 EFI am │ │ │ │ │ -00040640: 6436 3420 4546 490a 4249 4f53 2063 6861 d64 EFI.BIOS cha │ │ │ │ │ -00040650: 696e 6c6f 6164 696e 6720 2020 2020 2020 inloading │ │ │ │ │ -00040660: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ -00040670: 2831 2920 2020 2020 2020 2020 2020 6e6f (1) no │ │ │ │ │ -00040680: 2028 3129 0a4e 544c 4452 2020 2020 2020 (1).NTLDR │ │ │ │ │ +00040620: 2020 2020 2020 2020 2020 2020 2020 2069 i │ │ │ │ │ +00040630: 6133 3220 4546 4920 2020 2020 2020 2020 a32 EFI │ │ │ │ │ +00040640: 616d 6436 3420 4546 490a 4249 4f53 2063 amd64 EFI.BIOS c │ │ │ │ │ +00040650: 6861 696e 6c6f 6164 696e 6720 2020 2020 hainloading │ │ │ │ │ +00040660: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ │ +00040670: 6f20 2831 2920 2020 2020 2020 2020 2020 o (1) │ │ │ │ │ +00040680: 6e6f 2028 3129 0a4e 544c 4452 2020 2020 no (1).NTLDR │ │ │ │ │ 00040690: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000406a0: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ │ -000406b0: 2020 2020 2020 2020 2020 206e 6f20 2831 no (1 │ │ │ │ │ -000406c0: 290a 506c 616e 3920 2020 2020 2020 2020 ).Plan9 │ │ │ │ │ +000406a0: 2020 2020 2020 2020 2020 2020 6e6f 2028 no ( │ │ │ │ │ +000406b0: 3129 2020 2020 2020 2020 2020 206e 6f20 1) no │ │ │ │ │ +000406c0: 2831 290a 506c 616e 3920 2020 2020 2020 (1).Plan9 │ │ │ │ │ 000406d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000406e0: 2020 2020 2020 206e 6f20 2831 2920 2020 no (1) │ │ │ │ │ -000406f0: 2020 2020 2020 2020 6e6f 2028 3129 0a46 no (1).F │ │ │ │ │ -00040700: 7265 6544 4f53 2020 2020 2020 2020 2020 reeDOS │ │ │ │ │ +000406e0: 2020 2020 2020 2020 206e 6f20 2831 2920 no (1) │ │ │ │ │ +000406f0: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ │ +00040700: 0a46 7265 6544 4f53 2020 2020 2020 2020 .FreeDOS │ │ │ │ │ 00040710: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040720: 2020 2020 6e6f 2028 3129 2020 2020 2020 no (1) │ │ │ │ │ -00040730: 2020 2020 206e 6f20 2831 290a 4672 6565 no (1).Free │ │ │ │ │ -00040740: 4253 4420 626f 6f74 6c6f 6164 6572 2020 BSD bootloader │ │ │ │ │ +00040720: 2020 2020 2020 6e6f 2028 3129 2020 2020 no (1) │ │ │ │ │ +00040730: 2020 2020 2020 206e 6f20 2831 290a 4672 no (1).Fr │ │ │ │ │ +00040740: 6565 4253 4420 626f 6f74 6c6f 6164 6572 eeBSD bootloader │ │ │ │ │ 00040750: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040760: 2063 7261 7368 6573 2028 3129 2020 2020 crashes (1) │ │ │ │ │ -00040770: 2020 6372 6173 6865 7320 2831 290a 3332 crashes (1).32 │ │ │ │ │ -00040780: 2d62 6974 206b 4672 6565 4253 4420 2020 -bit kFreeBSD │ │ │ │ │ +00040760: 2020 2063 7261 7368 6573 2028 3129 2020 crashes (1) │ │ │ │ │ +00040770: 2020 2020 6372 6173 6865 7320 2831 290a crashes (1). │ │ │ │ │ +00040780: 3332 2d62 6974 206b 4672 6565 4253 4420 32-bit kFreeBSD │ │ │ │ │ 00040790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000407a0: 2020 2068 6561 646c 6573 7320 2020 2020 headless │ │ │ │ │ -000407b0: 2020 2020 6865 6164 6c65 7373 0a36 342d headless.64- │ │ │ │ │ -000407c0: 6269 7420 6b46 7265 6542 5344 2020 2020 bit kFreeBSD │ │ │ │ │ +000407a0: 2020 2020 2068 6561 646c 6573 7320 2020 headless │ │ │ │ │ +000407b0: 2020 2020 2020 6865 6164 6c65 7373 0a36 headless.6 │ │ │ │ │ +000407c0: 342d 6269 7420 6b46 7265 6542 5344 2020 4-bit kFreeBSD │ │ │ │ │ 000407d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000407e0: 2020 6865 6164 6c65 7373 2020 2020 2020 headless │ │ │ │ │ -000407f0: 2020 2068 6561 646c 6573 730a 3332 2d62 headless.32-b │ │ │ │ │ -00040800: 6974 206b 4e65 7442 5344 2020 2020 2020 it kNetBSD │ │ │ │ │ +000407e0: 2020 2020 6865 6164 6c65 7373 2020 2020 headless │ │ │ │ │ +000407f0: 2020 2020 2068 6561 646c 6573 730a 3332 headless.32 │ │ │ │ │ +00040800: 2d62 6974 206b 4e65 7442 5344 2020 2020 -bit kNetBSD │ │ │ │ │ 00040810: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040820: 2063 7261 7368 6573 2028 3129 2020 2020 crashes (1) │ │ │ │ │ -00040830: 2020 6372 6173 6865 7320 2831 290a 3634 crashes (1).64 │ │ │ │ │ -00040840: 2d62 6974 206b 4e65 7442 5344 2020 2020 -bit kNetBSD │ │ │ │ │ +00040820: 2020 2063 7261 7368 6573 2028 3129 2020 crashes (1) │ │ │ │ │ +00040830: 2020 2020 6372 6173 6865 7320 2831 290a crashes (1). │ │ │ │ │ +00040840: 3634 2d62 6974 206b 4e65 7442 5344 2020 64-bit kNetBSD │ │ │ │ │ 00040850: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040860: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ -00040870: 2020 2020 7965 730a 3332 2d62 6974 206b yes.32-bit k │ │ │ │ │ -00040880: 4f70 656e 4253 4420 2020 2020 2020 2020 OpenBSD │ │ │ │ │ -00040890: 2020 2020 2020 2020 2020 2020 2068 6561 hea │ │ │ │ │ -000408a0: 646c 6573 7320 2020 2020 2020 2020 6865 dless he │ │ │ │ │ -000408b0: 6164 6c65 7373 0a36 342d 6269 7420 6b4f adless.64-bit kO │ │ │ │ │ -000408c0: 7065 6e42 5344 2020 2020 2020 2020 2020 penBSD │ │ │ │ │ -000408d0: 2020 2020 2020 2020 2020 2020 6865 6164 head │ │ │ │ │ -000408e0: 6c65 7373 2020 2020 2020 2020 2068 6561 less hea │ │ │ │ │ -000408f0: 646c 6573 730a 4d75 6c74 6962 6f6f 7420 dless.Multiboot │ │ │ │ │ -00040900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040910: 2020 2020 2020 2020 2020 2079 6573 2020 yes │ │ │ │ │ -00040920: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ │ -00040930: 4d75 6c74 6962 6f6f 7432 2020 2020 2020 Multiboot2 │ │ │ │ │ +00040860: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +00040870: 2020 2020 2020 7965 730a 3332 2d62 6974 yes.32-bit │ │ │ │ │ +00040880: 206b 4f70 656e 4253 4420 2020 2020 2020 kOpenBSD │ │ │ │ │ +00040890: 2020 2020 2020 2020 2020 2020 2020 2068 h │ │ │ │ │ +000408a0: 6561 646c 6573 7320 2020 2020 2020 2020 eadless │ │ │ │ │ +000408b0: 6865 6164 6c65 7373 0a36 342d 6269 7420 headless.64-bit │ │ │ │ │ +000408c0: 6b4f 7065 6e42 5344 2020 2020 2020 2020 kOpenBSD │ │ │ │ │ +000408d0: 2020 2020 2020 2020 2020 2020 2020 6865 he │ │ │ │ │ +000408e0: 6164 6c65 7373 2020 2020 2020 2020 2068 adless h │ │ │ │ │ +000408f0: 6561 646c 6573 730a 4d75 6c74 6962 6f6f eadless.Multiboo │ │ │ │ │ +00040900: 7420 2020 2020 2020 2020 2020 2020 2020 t │ │ │ │ │ +00040910: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ +00040920: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ +00040930: 730a 4d75 6c74 6962 6f6f 7432 2020 2020 s.Multiboot2 │ │ │ │ │ 00040940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040950: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ -00040960: 2020 2020 2020 7965 730a 3332 2d62 6974 yes.32-bit │ │ │ │ │ -00040970: 204c 696e 7578 2028 6c65 6761 6379 2070 Linux (legacy p │ │ │ │ │ -00040980: 726f 746f 636f 6c29 2020 2020 2020 206e rotocol) n │ │ │ │ │ -00040990: 6f20 2831 2920 2020 2020 2020 2020 2020 o (1) │ │ │ │ │ -000409a0: 6e6f 2028 3129 0a36 342d 6269 7420 4c69 no (1).64-bit Li │ │ │ │ │ -000409b0: 6e75 7820 286c 6567 6163 7920 7072 6f74 nux (legacy prot │ │ │ │ │ -000409c0: 6f63 6f6c 2920 2020 2020 2020 6e6f 2028 ocol) no ( │ │ │ │ │ -000409d0: 3129 2020 2020 2020 2020 2020 206e 6f20 1) no │ │ │ │ │ -000409e0: 2831 290a 3332 2d62 6974 204c 696e 7578 (1).32-bit Linux │ │ │ │ │ -000409f0: 2028 6d6f 6465 726e 2070 726f 746f 636f (modern protoco │ │ │ │ │ -00040a00: 6c29 2020 2020 2020 2079 6573 2020 2020 l) yes │ │ │ │ │ -00040a10: 2020 2020 2020 2020 2020 7965 730a 3634 yes.64 │ │ │ │ │ -00040a20: 2d62 6974 204c 696e 7578 2028 6d6f 6465 -bit Linux (mode │ │ │ │ │ -00040a30: 726e 2070 726f 746f 636f 6c29 2020 2020 rn protocol) │ │ │ │ │ -00040a40: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ -00040a50: 2020 2020 7965 730a 3332 2d62 6974 2058 yes.32-bit X │ │ │ │ │ -00040a60: 4e55 2020 2020 2020 2020 2020 2020 2020 NU │ │ │ │ │ -00040a70: 2020 2020 2020 2020 2020 2020 2079 6573 yes │ │ │ │ │ -00040a80: 2020 2020 2020 2020 2020 2020 2020 7965 ye │ │ │ │ │ -00040a90: 730a 3634 2d62 6974 2058 4e55 2020 2020 s.64-bit XNU │ │ │ │ │ +00040950: 2020 2020 2020 2079 6573 2020 2020 2020 yes │ │ │ │ │ +00040960: 2020 2020 2020 2020 7965 730a 3332 2d62 yes.32-b │ │ │ │ │ +00040970: 6974 204c 696e 7578 2028 6c65 6761 6379 it Linux (legacy │ │ │ │ │ +00040980: 2070 726f 746f 636f 6c29 2020 2020 2020 protocol) │ │ │ │ │ +00040990: 206e 6f20 2831 2920 2020 2020 2020 2020 no (1) │ │ │ │ │ +000409a0: 2020 6e6f 2028 3129 0a36 342d 6269 7420 no (1).64-bit │ │ │ │ │ +000409b0: 4c69 6e75 7820 286c 6567 6163 7920 7072 Linux (legacy pr │ │ │ │ │ +000409c0: 6f74 6f63 6f6c 2920 2020 2020 2020 6e6f otocol) no │ │ │ │ │ +000409d0: 2028 3129 2020 2020 2020 2020 2020 206e (1) n │ │ │ │ │ +000409e0: 6f20 2831 290a 3332 2d62 6974 204c 696e o (1).32-bit Lin │ │ │ │ │ +000409f0: 7578 2028 6d6f 6465 726e 2070 726f 746f ux (modern proto │ │ │ │ │ +00040a00: 636f 6c29 2020 2020 2020 2079 6573 2020 col) yes │ │ │ │ │ +00040a10: 2020 2020 2020 2020 2020 2020 7965 730a yes. │ │ │ │ │ +00040a20: 3634 2d62 6974 204c 696e 7578 2028 6d6f 64-bit Linux (mo │ │ │ │ │ +00040a30: 6465 726e 2070 726f 746f 636f 6c29 2020 dern protocol) │ │ │ │ │ +00040a40: 2020 2020 2079 6573 2020 2020 2020 2020 yes │ │ │ │ │ +00040a50: 2020 2020 2020 7965 730a 3332 2d62 6974 yes.32-bit │ │ │ │ │ +00040a60: 2058 4e55 2020 2020 2020 2020 2020 2020 XNU │ │ │ │ │ +00040a70: 2020 2020 2020 2020 2020 2020 2020 2079 y │ │ │ │ │ +00040a80: 6573 2020 2020 2020 2020 2020 2020 2020 es │ │ │ │ │ +00040a90: 7965 730a 3634 2d62 6974 2058 4e55 2020 yes.64-bit XNU │ │ │ │ │ 00040aa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040ab0: 2020 2020 2020 2079 6573 2028 3429 2020 yes (4) │ │ │ │ │ -00040ac0: 2020 2020 2020 2020 7965 730a 3332 2d62 yes.32-b │ │ │ │ │ -00040ad0: 6974 2045 4649 2063 6861 696e 6c6f 6164 it EFI chainload │ │ │ │ │ -00040ae0: 6572 2020 2020 2020 2020 2020 2020 2020 er │ │ │ │ │ -00040af0: 2079 6573 2020 2020 2020 2020 2020 2020 yes │ │ │ │ │ -00040b00: 2020 6e6f 2028 3329 0a36 342d 6269 7420 no (3).64-bit │ │ │ │ │ -00040b10: 4546 4920 6368 6169 6e6c 6f61 6465 7220 EFI chainloader │ │ │ │ │ -00040b20: 2020 2020 2020 2020 2020 2020 2020 6e6f no │ │ │ │ │ -00040b30: 2028 3329 2020 2020 2020 2020 2020 2079 (3) y │ │ │ │ │ -00040b40: 6573 0a41 7070 6c65 6c6f 6164 6572 2020 es.Appleloader │ │ │ │ │ +00040ab0: 2020 2020 2020 2020 2079 6573 2028 3429 yes (4) │ │ │ │ │ +00040ac0: 2020 2020 2020 2020 2020 7965 730a 3332 yes.32 │ │ │ │ │ +00040ad0: 2d62 6974 2045 4649 2063 6861 696e 6c6f -bit EFI chainlo │ │ │ │ │ +00040ae0: 6164 6572 2020 2020 2020 2020 2020 2020 ader │ │ │ │ │ +00040af0: 2020 2079 6573 2020 2020 2020 2020 2020 yes │ │ │ │ │ +00040b00: 2020 2020 6e6f 2028 3329 0a36 342d 6269 no (3).64-bi │ │ │ │ │ +00040b10: 7420 4546 4920 6368 6169 6e6c 6f61 6465 t EFI chainloade │ │ │ │ │ +00040b20: 7220 2020 2020 2020 2020 2020 2020 2020 r │ │ │ │ │ +00040b30: 6e6f 2028 3329 2020 2020 2020 2020 2020 no (3) │ │ │ │ │ +00040b40: 2079 6573 0a41 7070 6c65 6c6f 6164 6572 yes.Appleloader │ │ │ │ │ 00040b50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040b60: 2020 2020 2020 2020 7965 7320 2020 2020 yes │ │ │ │ │ -00040b70: 2020 2020 2020 2020 2079 6573 0a0a 2020 yes.. │ │ │ │ │ +00040b60: 2020 2020 2020 2020 2020 7965 7320 2020 yes │ │ │ │ │ +00040b70: 2020 2020 2020 2020 2020 2079 6573 0a0a yes.. │ │ │ │ │ 00040b80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00040b90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040ba0: 2020 2069 6133 3220 4945 4545 3132 3735 ia32 IEEE1275 │ │ │ │ │ -00040bb0: 0a42 494f 5320 6368 6169 6e6c 6f61 6469 .BIOS chainloadi │ │ │ │ │ -00040bc0: 6e67 2020 2020 2020 2020 2020 2020 2020 ng │ │ │ │ │ -00040bd0: 2020 2020 2020 6e6f 2028 3129 0a4e 544c no (1).NTL │ │ │ │ │ -00040be0: 4452 2020 2020 2020 2020 2020 2020 2020 DR │ │ │ │ │ +00040ba0: 2020 2020 2069 6133 3220 4945 4545 3132 ia32 IEEE12 │ │ │ │ │ +00040bb0: 3735 0a42 494f 5320 6368 6169 6e6c 6f61 75.BIOS chainloa │ │ │ │ │ +00040bc0: 6469 6e67 2020 2020 2020 2020 2020 2020 ding │ │ │ │ │ +00040bd0: 2020 2020 2020 2020 6e6f 2028 3129 0a4e no (1).N │ │ │ │ │ +00040be0: 544c 4452 2020 2020 2020 2020 2020 2020 TLDR │ │ │ │ │ 00040bf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040c00: 2020 6e6f 2028 3129 0a50 6c61 6e39 2020 no (1).Plan9 │ │ │ │ │ +00040c00: 2020 2020 6e6f 2028 3129 0a50 6c61 6e39 no (1).Plan9 │ │ │ │ │ 00040c10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040c20: 2020 2020 2020 2020 2020 2020 2020 6e6f no │ │ │ │ │ -00040c30: 2028 3129 0a46 7265 6544 4f53 2020 2020 (1).FreeDOS │ │ │ │ │ +00040c20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00040c30: 6e6f 2028 3129 0a46 7265 6544 4f53 2020 no (1).FreeDOS │ │ │ │ │ 00040c40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040c50: 2020 2020 2020 2020 2020 6e6f 2028 3129 no (1) │ │ │ │ │ -00040c60: 0a46 7265 6542 5344 2062 6f6f 746c 6f61 .FreeBSD bootloa │ │ │ │ │ -00040c70: 6465 7220 2020 2020 2020 2020 2020 2020 der │ │ │ │ │ -00040c80: 2020 2020 2020 6372 6173 6865 7320 2831 crashes (1 │ │ │ │ │ -00040c90: 290a 3332 2d62 6974 206b 4672 6565 4253 ).32-bit kFreeBS │ │ │ │ │ -00040ca0: 4420 2020 2020 2020 2020 2020 2020 2020 D │ │ │ │ │ -00040cb0: 2020 2020 2020 2063 7261 7368 6573 2028 crashes ( │ │ │ │ │ -00040cc0: 3529 0a36 342d 6269 7420 6b46 7265 6542 5).64-bit kFreeB │ │ │ │ │ -00040cd0: 5344 2020 2020 2020 2020 2020 2020 2020 SD │ │ │ │ │ -00040ce0: 2020 2020 2020 2020 6372 6173 6865 7320 crashes │ │ │ │ │ -00040cf0: 2835 290a 3332 2d62 6974 206b 4e65 7442 (5).32-bit kNetB │ │ │ │ │ -00040d00: 5344 2020 2020 2020 2020 2020 2020 2020 SD │ │ │ │ │ -00040d10: 2020 2020 2020 2020 2063 7261 7368 6573 crashes │ │ │ │ │ -00040d20: 2028 3129 0a36 342d 6269 7420 6b4e 6574 (1).64-bit kNet │ │ │ │ │ -00040d30: 4253 4420 2020 2020 2020 2020 2020 2020 BSD │ │ │ │ │ -00040d40: 2020 2020 2020 2020 2020 3f0a 3332 2d62 ?.32-b │ │ │ │ │ -00040d50: 6974 206b 4f70 656e 4253 4420 2020 2020 it kOpenBSD │ │ │ │ │ +00040c50: 2020 2020 2020 2020 2020 2020 6e6f 2028 no ( │ │ │ │ │ +00040c60: 3129 0a46 7265 6542 5344 2062 6f6f 746c 1).FreeBSD bootl │ │ │ │ │ +00040c70: 6f61 6465 7220 2020 2020 2020 2020 2020 oader │ │ │ │ │ +00040c80: 2020 2020 2020 2020 6372 6173 6865 7320 crashes │ │ │ │ │ +00040c90: 2831 290a 3332 2d62 6974 206b 4672 6565 (1).32-bit kFree │ │ │ │ │ +00040ca0: 4253 4420 2020 2020 2020 2020 2020 2020 BSD │ │ │ │ │ +00040cb0: 2020 2020 2020 2020 2063 7261 7368 6573 crashes │ │ │ │ │ +00040cc0: 2028 3529 0a36 342d 6269 7420 6b46 7265 (5).64-bit kFre │ │ │ │ │ +00040cd0: 6542 5344 2020 2020 2020 2020 2020 2020 eBSD │ │ │ │ │ +00040ce0: 2020 2020 2020 2020 2020 6372 6173 6865 crashe │ │ │ │ │ +00040cf0: 7320 2835 290a 3332 2d62 6974 206b 4e65 s (5).32-bit kNe │ │ │ │ │ +00040d00: 7442 5344 2020 2020 2020 2020 2020 2020 tBSD │ │ │ │ │ +00040d10: 2020 2020 2020 2020 2020 2063 7261 7368 crash │ │ │ │ │ +00040d20: 6573 2028 3129 0a36 342d 6269 7420 6b4e es (1).64-bit kN │ │ │ │ │ +00040d30: 6574 4253 4420 2020 2020 2020 2020 2020 etBSD │ │ │ │ │ +00040d40: 2020 2020 2020 2020 2020 2020 3f0a 3332 ?.32 │ │ │ │ │ +00040d50: 2d62 6974 206b 4f70 656e 4253 4420 2020 -bit kOpenBSD │ │ │ │ │ 00040d60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040d70: 203f 0a36 342d 6269 7420 6b4f 7065 6e42 ?.64-bit kOpenB │ │ │ │ │ -00040d80: 5344 2020 2020 2020 2020 2020 2020 2020 SD │ │ │ │ │ -00040d90: 2020 2020 2020 2020 3f0a 4d75 6c74 6962 ?.Multib │ │ │ │ │ -00040da0: 6f6f 7420 2020 2020 2020 2020 2020 2020 oot │ │ │ │ │ -00040db0: 2020 2020 2020 2020 2020 2020 2020 203f ? │ │ │ │ │ -00040dc0: 0a4d 756c 7469 626f 6f74 3220 2020 2020 .Multiboot2 │ │ │ │ │ +00040d70: 2020 203f 0a36 342d 6269 7420 6b4f 7065 ?.64-bit kOpe │ │ │ │ │ +00040d80: 6e42 5344 2020 2020 2020 2020 2020 2020 nBSD │ │ │ │ │ +00040d90: 2020 2020 2020 2020 2020 3f0a 4d75 6c74 ?.Mult │ │ │ │ │ +00040da0: 6962 6f6f 7420 2020 2020 2020 2020 2020 iboot │ │ │ │ │ +00040db0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00040dc0: 203f 0a4d 756c 7469 626f 6f74 3220 2020 ?.Multiboot2 │ │ │ │ │ 00040dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040de0: 2020 2020 2020 3f0a 3332 2d62 6974 204c ?.32-bit L │ │ │ │ │ -00040df0: 696e 7578 2028 6c65 6761 6379 2070 726f inux (legacy pro │ │ │ │ │ -00040e00: 746f 636f 6c29 2020 2020 2020 206e 6f20 tocol) no │ │ │ │ │ -00040e10: 2831 290a 3634 2d62 6974 204c 696e 7578 (1).64-bit Linux │ │ │ │ │ -00040e20: 2028 6c65 6761 6379 2070 726f 746f 636f (legacy protoco │ │ │ │ │ -00040e30: 6c29 2020 2020 2020 206e 6f20 2831 290a l) no (1). │ │ │ │ │ -00040e40: 3332 2d62 6974 204c 696e 7578 2028 6d6f 32-bit Linux (mo │ │ │ │ │ -00040e50: 6465 726e 2070 726f 746f 636f 6c29 2020 dern protocol) │ │ │ │ │ -00040e60: 2020 2020 203f 0a36 342d 6269 7420 4c69 ?.64-bit Li │ │ │ │ │ -00040e70: 6e75 7820 286d 6f64 6572 6e20 7072 6f74 nux (modern prot │ │ │ │ │ -00040e80: 6f63 6f6c 2920 2020 2020 2020 3f0a 3332 ocol) ?.32 │ │ │ │ │ -00040e90: 2d62 6974 2058 4e55 2020 2020 2020 2020 -bit XNU │ │ │ │ │ +00040de0: 2020 2020 2020 2020 3f0a 3332 2d62 6974 ?.32-bit │ │ │ │ │ +00040df0: 204c 696e 7578 2028 6c65 6761 6379 2070 Linux (legacy p │ │ │ │ │ +00040e00: 726f 746f 636f 6c29 2020 2020 2020 206e rotocol) n │ │ │ │ │ +00040e10: 6f20 2831 290a 3634 2d62 6974 204c 696e o (1).64-bit Lin │ │ │ │ │ +00040e20: 7578 2028 6c65 6761 6379 2070 726f 746f ux (legacy proto │ │ │ │ │ +00040e30: 636f 6c29 2020 2020 2020 206e 6f20 2831 col) no (1 │ │ │ │ │ +00040e40: 290a 3332 2d62 6974 204c 696e 7578 2028 ).32-bit Linux ( │ │ │ │ │ +00040e50: 6d6f 6465 726e 2070 726f 746f 636f 6c29 modern protocol) │ │ │ │ │ +00040e60: 2020 2020 2020 203f 0a36 342d 6269 7420 ?.64-bit │ │ │ │ │ +00040e70: 4c69 6e75 7820 286d 6f64 6572 6e20 7072 Linux (modern pr │ │ │ │ │ +00040e80: 6f74 6f63 6f6c 2920 2020 2020 2020 3f0a otocol) ?. │ │ │ │ │ +00040e90: 3332 2d62 6974 2058 4e55 2020 2020 2020 32-bit XNU │ │ │ │ │ 00040ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040eb0: 2020 203f 0a36 342d 6269 7420 584e 5520 ?.64-bit XNU │ │ │ │ │ -00040ec0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040ed0: 2020 2020 2020 2020 2020 3f0a 3332 2d62 ?.32-b │ │ │ │ │ -00040ee0: 6974 2045 4649 2063 6861 696e 6c6f 6164 it EFI chainload │ │ │ │ │ -00040ef0: 6572 2020 2020 2020 2020 2020 2020 2020 er │ │ │ │ │ -00040f00: 206e 6f20 2832 290a 3634 2d62 6974 2045 no (2).64-bit E │ │ │ │ │ -00040f10: 4649 2063 6861 696e 6c6f 6164 6572 2020 FI chainloader │ │ │ │ │ -00040f20: 2020 2020 2020 2020 2020 2020 206e 6f20 no │ │ │ │ │ -00040f30: 2832 290a 4170 706c 656c 6f61 6465 7220 (2).Appleloader │ │ │ │ │ -00040f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00040f50: 2020 2020 2020 2020 206e 6f20 2832 290a no (2). │ │ │ │ │ -00040f60: 0a20 2031 2e20 5265 7175 6972 6573 2042 . 1. Requires B │ │ │ │ │ -00040f70: 494f 530a 2020 322e 2045 4649 206f 6e6c IOS. 2. EFI onl │ │ │ │ │ -00040f80: 790a 2020 332e 2033 322d 6269 7420 616e y. 3. 32-bit an │ │ │ │ │ -00040f90: 6420 3634 2d62 6974 2045 4649 2068 6176 d 64-bit EFI hav │ │ │ │ │ -00040fa0: 6520 6469 6666 6572 656e 7420 7374 7275 e different stru │ │ │ │ │ -00040fb0: 6374 7572 6573 2061 6e64 2077 6f72 6b20 ctures and work │ │ │ │ │ -00040fc0: 696e 0a20 2020 2020 6469 6666 6572 656e in. differen │ │ │ │ │ -00040fd0: 7420 4350 5520 6d6f 6465 7320 736f 2069 t CPU modes so i │ │ │ │ │ -00040fe0: 7427 7320 6e6f 7420 706f 7373 6962 6c65 t's not possible │ │ │ │ │ -00040ff0: 2074 6f20 6368 6169 6e6c 6f61 6420 3332 to chainload 32 │ │ │ │ │ -00041000: 2d62 6974 0a20 2020 2020 626f 6f74 6c6f -bit. bootlo │ │ │ │ │ -00041010: 6164 6572 206f 6e20 3634 2d62 6974 2070 ader on 64-bit p │ │ │ │ │ -00041020: 6c61 7466 6f72 6d20 616e 6420 7669 6365 latform and vice │ │ │ │ │ -00041030: 2d76 6572 7361 0a20 2034 2e20 536f 6d65 -versa. 4. Some │ │ │ │ │ -00041040: 206d 6f64 756c 6573 206d 6179 206e 6565 modules may nee │ │ │ │ │ -00041050: 6420 746f 2062 6520 6469 7361 626c 6564 d to be disabled │ │ │ │ │ -00041060: 0a20 2035 2e20 5265 7175 6972 6573 2041 . 5. Requires A │ │ │ │ │ -00041070: 4350 490a 0a20 2020 506f 7765 7250 432c CPI.. PowerPC, │ │ │ │ │ -00041080: 2049 4136 3420 616e 6420 5370 6172 6336 IA64 and Sparc6 │ │ │ │ │ -00041090: 3420 706f 7274 7320 7375 7070 6f72 7420 4 ports support │ │ │ │ │ -000410a0: 6f6e 6c79 204c 696e 7578 2e20 204d 4950 only Linux. MIP │ │ │ │ │ -000410b0: 5320 706f 7274 0a73 7570 706f 7274 7320 S port.supports │ │ │ │ │ -000410c0: 4c69 6e75 7820 616e 6420 6d75 6c74 6962 Linux and multib │ │ │ │ │ -000410d0: 6f6f 7432 2e0a 0a32 312e 3120 426f 6f74 oot2...21.1 Boot │ │ │ │ │ -000410e0: 2074 6573 7473 0a3d 3d3d 3d3d 3d3d 3d3d tests.========= │ │ │ │ │ -000410f0: 3d3d 3d3d 3d3d 0a0a 4173 2079 6f75 2068 ======..As you h │ │ │ │ │ -00041100: 6176 6520 7365 656e 2069 6e20 7072 6576 ave seen in prev │ │ │ │ │ -00041110: 696f 7573 2063 6861 7074 6572 2074 6865 ious chapter the │ │ │ │ │ -00041120: 2073 7570 706f 7274 206d 6174 7269 7820 support matrix │ │ │ │ │ -00041130: 6973 2070 7265 7474 7920 6269 670a 616e is pretty big.an │ │ │ │ │ -00041140: 6420 736f 6d65 206f 6620 7468 6520 636f d some of the co │ │ │ │ │ -00041150: 6e66 6967 7572 6174 696f 6e73 2061 7265 nfigurations are │ │ │ │ │ -00041160: 206f 6e6c 7920 7261 7265 6c79 2075 7365 only rarely use │ │ │ │ │ -00041170: 642e 2020 546f 2065 6e73 7572 6520 7468 d. To ensure th │ │ │ │ │ -00041180: 650a 7175 616c 6974 7920 626f 6f74 6368 e.quality bootch │ │ │ │ │ -00041190: 6563 6b73 2061 7265 2061 7661 696c 6162 ecks are availab │ │ │ │ │ -000411a0: 6c65 2066 6f72 2061 6c6c 2078 3836 2074 le for all x86 t │ │ │ │ │ -000411b0: 6172 6765 7473 2065 7863 6570 7420 4546 argets except EF │ │ │ │ │ -000411c0: 490a 6368 6169 6e6c 6f61 6465 722c 2041 I.chainloader, A │ │ │ │ │ -000411d0: 7070 6c65 6c6f 6164 6572 2061 6e64 2058 ppleloader and X │ │ │ │ │ -000411e0: 4e55 2e20 416c 6c20 7838 3620 706c 6174 NU. All x86 plat │ │ │ │ │ -000411f0: 666f 726d 7320 6861 7665 2062 6f6f 7463 forms have bootc │ │ │ │ │ -00041200: 6865 636b 0a66 6163 696c 6974 7920 6578 heck.facility ex │ │ │ │ │ -00041210: 6365 7074 2069 6565 6531 3237 352e 2020 cept ieee1275. │ │ │ │ │ -00041220: 4d75 6c74 6962 6f6f 742c 206d 756c 7469 Multiboot, multi │ │ │ │ │ -00041230: 626f 6f74 322c 2042 494f 5320 6368 6169 boot2, BIOS chai │ │ │ │ │ -00041240: 6e6c 6f61 6465 722c 0a6e 746c 6472 2061 nloader,.ntldr a │ │ │ │ │ -00041250: 6e64 2066 7265 6562 7364 2d62 6f6f 746c nd freebsd-bootl │ │ │ │ │ -00041260: 6f61 6465 7220 626f 6f74 2074 6172 6765 oader boot targe │ │ │ │ │ -00041270: 7473 2061 7265 2074 6573 7465 6420 6f6e ts are tested on │ │ │ │ │ -00041280: 6c79 2077 6974 6820 6120 6661 6b65 0a6b ly with a fake.k │ │ │ │ │ -00041290: 6572 6e65 6c20 696d 6167 6573 2e20 204f ernel images. O │ │ │ │ │ -000412a0: 6e6c 7920 4c69 6e75 7820 6973 2074 6573 nly Linux is tes │ │ │ │ │ -000412b0: 7465 6420 616d 6f6e 6720 7468 6520 7061 ted among the pa │ │ │ │ │ -000412c0: 796c 6f61 6473 2075 7369 6e67 204c 696e yloads using Lin │ │ │ │ │ -000412d0: 7578 0a70 726f 746f 636f 6c73 2e0a 0a20 ux.protocols... │ │ │ │ │ -000412e0: 2020 466f 6c6c 6f77 696e 6720 7661 7269 Following vari │ │ │ │ │ -000412f0: 6162 6c65 7320 6d75 7374 2062 6520 6465 ables must be de │ │ │ │ │ -00041300: 6669 6e65 643a 0a0a 4752 5542 5f50 4159 fined:..GRUB_PAY │ │ │ │ │ -00041310: 4c4f 4144 535f 4449 5220 2020 2020 2064 LOADS_DIR d │ │ │ │ │ -00041320: 6972 6563 746f 7279 2063 6f6e 7461 696e irectory contain │ │ │ │ │ -00041330: 696e 6720 7468 6520 7265 7175 6972 6564 ing the required │ │ │ │ │ -00041340: 206b 6572 6e65 6c73 0a47 5255 425f 4342 kernels.GRUB_CB │ │ │ │ │ -00041350: 4653 544f 4f4c 2020 2020 2020 2020 2020 FSTOOL │ │ │ │ │ -00041360: 6362 6673 746f 6f6c 2066 726f 6d20 436f cbfstool from Co │ │ │ │ │ -00041370: 7265 626f 6f74 2070 6163 6b61 6765 2028 reboot package ( │ │ │ │ │ -00041380: 666f 7220 636f 7265 626f 6f74 0a20 2020 for coreboot. │ │ │ │ │ +00040eb0: 2020 2020 203f 0a36 342d 6269 7420 584e ?.64-bit XN │ │ │ │ │ +00040ec0: 5520 2020 2020 2020 2020 2020 2020 2020 U │ │ │ │ │ +00040ed0: 2020 2020 2020 2020 2020 2020 3f0a 3332 ?.32 │ │ │ │ │ +00040ee0: 2d62 6974 2045 4649 2063 6861 696e 6c6f -bit EFI chainlo │ │ │ │ │ +00040ef0: 6164 6572 2020 2020 2020 2020 2020 2020 ader │ │ │ │ │ +00040f00: 2020 206e 6f20 2832 290a 3634 2d62 6974 no (2).64-bit │ │ │ │ │ +00040f10: 2045 4649 2063 6861 696e 6c6f 6164 6572 EFI chainloader │ │ │ │ │ +00040f20: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ │ +00040f30: 6f20 2832 290a 4170 706c 656c 6f61 6465 o (2).Appleloade │ │ │ │ │ +00040f40: 7220 2020 2020 2020 2020 2020 2020 2020 r │ │ │ │ │ +00040f50: 2020 2020 2020 2020 2020 206e 6f20 2832 no (2 │ │ │ │ │ +00040f60: 290a 0a20 2031 2e20 5265 7175 6972 6573 ).. 1. Requires │ │ │ │ │ +00040f70: 2042 494f 530a 2020 322e 2045 4649 206f BIOS. 2. EFI o │ │ │ │ │ +00040f80: 6e6c 790a 2020 332e 2033 322d 6269 7420 nly. 3. 32-bit │ │ │ │ │ +00040f90: 616e 6420 3634 2d62 6974 2045 4649 2068 and 64-bit EFI h │ │ │ │ │ +00040fa0: 6176 6520 6469 6666 6572 656e 7420 7374 ave different st │ │ │ │ │ +00040fb0: 7275 6374 7572 6573 2061 6e64 2077 6f72 ructures and wor │ │ │ │ │ +00040fc0: 6b20 696e 0a20 2020 2020 6469 6666 6572 k in. differ │ │ │ │ │ +00040fd0: 656e 7420 4350 5520 6d6f 6465 7320 736f ent CPU modes so │ │ │ │ │ +00040fe0: 2069 7427 7320 6e6f 7420 706f 7373 6962 it's not possib │ │ │ │ │ +00040ff0: 6c65 2074 6f20 6368 6169 6e6c 6f61 6420 le to chainload │ │ │ │ │ +00041000: 3332 2d62 6974 0a20 2020 2020 626f 6f74 32-bit. boot │ │ │ │ │ +00041010: 6c6f 6164 6572 206f 6e20 3634 2d62 6974 loader on 64-bit │ │ │ │ │ +00041020: 2070 6c61 7466 6f72 6d20 616e 6420 7669 platform and vi │ │ │ │ │ +00041030: 6365 2d76 6572 7361 0a20 2034 2e20 536f ce-versa. 4. So │ │ │ │ │ +00041040: 6d65 206d 6f64 756c 6573 206d 6179 206e me modules may n │ │ │ │ │ +00041050: 6565 6420 746f 2062 6520 6469 7361 626c eed to be disabl │ │ │ │ │ +00041060: 6564 0a20 2035 2e20 5265 7175 6972 6573 ed. 5. Requires │ │ │ │ │ +00041070: 2041 4350 490a 0a20 2020 506f 7765 7250 ACPI.. PowerP │ │ │ │ │ +00041080: 432c 2049 4136 3420 616e 6420 5370 6172 C, IA64 and Spar │ │ │ │ │ +00041090: 6336 3420 706f 7274 7320 7375 7070 6f72 c64 ports suppor │ │ │ │ │ +000410a0: 7420 6f6e 6c79 204c 696e 7578 2e20 204d t only Linux. M │ │ │ │ │ +000410b0: 4950 5320 706f 7274 0a73 7570 706f 7274 IPS port.support │ │ │ │ │ +000410c0: 7320 4c69 6e75 7820 616e 6420 6d75 6c74 s Linux and mult │ │ │ │ │ +000410d0: 6962 6f6f 7432 2e0a 0a32 312e 3120 426f iboot2...21.1 Bo │ │ │ │ │ +000410e0: 6f74 2074 6573 7473 0a3d 3d3d 3d3d 3d3d ot tests.======= │ │ │ │ │ +000410f0: 3d3d 3d3d 3d3d 3d3d 0a0a 4173 2079 6f75 ========..As you │ │ │ │ │ +00041100: 2068 6176 6520 7365 656e 2069 6e20 7072 have seen in pr │ │ │ │ │ +00041110: 6576 696f 7573 2063 6861 7074 6572 2074 evious chapter t │ │ │ │ │ +00041120: 6865 2073 7570 706f 7274 206d 6174 7269 he support matri │ │ │ │ │ +00041130: 7820 6973 2070 7265 7474 7920 6269 670a x is pretty big. │ │ │ │ │ +00041140: 616e 6420 736f 6d65 206f 6620 7468 6520 and some of the │ │ │ │ │ +00041150: 636f 6e66 6967 7572 6174 696f 6e73 2061 configurations a │ │ │ │ │ +00041160: 7265 206f 6e6c 7920 7261 7265 6c79 2075 re only rarely u │ │ │ │ │ +00041170: 7365 642e 2020 546f 2065 6e73 7572 6520 sed. To ensure │ │ │ │ │ +00041180: 7468 650a 7175 616c 6974 7920 626f 6f74 the.quality boot │ │ │ │ │ +00041190: 6368 6563 6b73 2061 7265 2061 7661 696c checks are avail │ │ │ │ │ +000411a0: 6162 6c65 2066 6f72 2061 6c6c 2078 3836 able for all x86 │ │ │ │ │ +000411b0: 2074 6172 6765 7473 2065 7863 6570 7420 targets except │ │ │ │ │ +000411c0: 4546 490a 6368 6169 6e6c 6f61 6465 722c EFI.chainloader, │ │ │ │ │ +000411d0: 2041 7070 6c65 6c6f 6164 6572 2061 6e64 Appleloader and │ │ │ │ │ +000411e0: 2058 4e55 2e20 416c 6c20 7838 3620 706c XNU. All x86 pl │ │ │ │ │ +000411f0: 6174 666f 726d 7320 6861 7665 2062 6f6f atforms have boo │ │ │ │ │ +00041200: 7463 6865 636b 0a66 6163 696c 6974 7920 tcheck.facility │ │ │ │ │ +00041210: 6578 6365 7074 2069 6565 6531 3237 352e except ieee1275. │ │ │ │ │ +00041220: 2020 4d75 6c74 6962 6f6f 742c 206d 756c Multiboot, mul │ │ │ │ │ +00041230: 7469 626f 6f74 322c 2042 494f 5320 6368 tiboot2, BIOS ch │ │ │ │ │ +00041240: 6169 6e6c 6f61 6465 722c 0a6e 746c 6472 ainloader,.ntldr │ │ │ │ │ +00041250: 2061 6e64 2066 7265 6562 7364 2d62 6f6f and freebsd-boo │ │ │ │ │ +00041260: 746c 6f61 6465 7220 626f 6f74 2074 6172 tloader boot tar │ │ │ │ │ +00041270: 6765 7473 2061 7265 2074 6573 7465 6420 gets are tested │ │ │ │ │ +00041280: 6f6e 6c79 2077 6974 6820 6120 6661 6b65 only with a fake │ │ │ │ │ +00041290: 0a6b 6572 6e65 6c20 696d 6167 6573 2e20 .kernel images. │ │ │ │ │ +000412a0: 204f 6e6c 7920 4c69 6e75 7820 6973 2074 Only Linux is t │ │ │ │ │ +000412b0: 6573 7465 6420 616d 6f6e 6720 7468 6520 ested among the │ │ │ │ │ +000412c0: 7061 796c 6f61 6473 2075 7369 6e67 204c payloads using L │ │ │ │ │ +000412d0: 696e 7578 0a70 726f 746f 636f 6c73 2e0a inux.protocols.. │ │ │ │ │ +000412e0: 0a20 2020 466f 6c6c 6f77 696e 6720 7661 . Following va │ │ │ │ │ +000412f0: 7269 6162 6c65 7320 6d75 7374 2062 6520 riables must be │ │ │ │ │ +00041300: 6465 6669 6e65 643a 0a0a 4752 5542 5f50 defined:..GRUB_P │ │ │ │ │ +00041310: 4159 4c4f 4144 535f 4449 5220 2020 2020 AYLOADS_DIR │ │ │ │ │ +00041320: 2064 6972 6563 746f 7279 2063 6f6e 7461 directory conta │ │ │ │ │ +00041330: 696e 696e 6720 7468 6520 7265 7175 6972 ining the requir │ │ │ │ │ +00041340: 6564 206b 6572 6e65 6c73 0a47 5255 425f ed kernels.GRUB_ │ │ │ │ │ +00041350: 4342 4653 544f 4f4c 2020 2020 2020 2020 CBFSTOOL │ │ │ │ │ +00041360: 2020 6362 6673 746f 6f6c 2066 726f 6d20 cbfstool from │ │ │ │ │ +00041370: 436f 7265 626f 6f74 2070 6163 6b61 6765 Coreboot package │ │ │ │ │ +00041380: 2028 666f 7220 636f 7265 626f 6f74 0a20 (for coreboot. │ │ │ │ │ 00041390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000413a0: 2020 2020 706c 6174 666f 726d 206f 6e6c platform onl │ │ │ │ │ -000413b0: 7929 0a47 5255 425f 434f 5245 424f 4f54 y).GRUB_COREBOOT │ │ │ │ │ -000413c0: 5f52 4f4d 2020 2020 2020 656d 7074 7920 _ROM empty │ │ │ │ │ -000413d0: 436f 7265 626f 6f74 2052 4f4d 0a47 5255 Coreboot ROM.GRU │ │ │ │ │ -000413e0: 425f 5145 4d55 5f4f 5054 5320 2020 2020 B_QEMU_OPTS │ │ │ │ │ -000413f0: 2020 2020 6164 6469 7469 6f6e 616c 206f additional o │ │ │ │ │ -00041400: 7074 696f 6e73 2074 6f20 6265 2073 7570 ptions to be sup │ │ │ │ │ -00041410: 706c 6965 6420 746f 2051 454d 550a 0a20 plied to QEMU.. │ │ │ │ │ -00041420: 2020 5265 7175 6972 6564 2066 696c 6573 Required files │ │ │ │ │ -00041430: 2061 7265 3a0a 0a6b 6672 6565 6273 645f are:..kfreebsd_ │ │ │ │ │ -00041440: 656e 762e 6933 3836 2020 2020 2020 2020 env.i386 │ │ │ │ │ -00041450: 2020 2020 2033 322d 6269 7420 6b46 7265 32-bit kFre │ │ │ │ │ -00041460: 6542 5344 2064 6576 6963 6520 6869 6e74 eBSD device hint │ │ │ │ │ -00041470: 730a 6b66 7265 6562 7364 2e69 3338 3620 s.kfreebsd.i386 │ │ │ │ │ -00041480: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041490: 3332 2d62 6974 2046 7265 6542 5344 206b 32-bit FreeBSD k │ │ │ │ │ -000414a0: 6572 6e65 6c20 696d 6167 650a 6b66 7265 ernel image.kfre │ │ │ │ │ -000414b0: 6562 7364 2e78 3836 5f36 342c 2020 2020 ebsd.x86_64, │ │ │ │ │ -000414c0: 2020 2020 2020 2020 2020 7361 6d65 2066 same f │ │ │ │ │ -000414d0: 726f 6d20 3634 2d62 6974 206b 4672 6565 rom 64-bit kFree │ │ │ │ │ -000414e0: 4253 440a 6b66 7265 6562 7364 5f65 6e76 BSD.kfreebsd_env │ │ │ │ │ -000414f0: 2e78 3836 5f36 340a 6b6e 6574 6273 642e .x86_64.knetbsd. │ │ │ │ │ -00041500: 6933 3836 2020 2020 2020 2020 2020 2020 i386 │ │ │ │ │ -00041510: 2020 2020 2020 3332 2d62 6974 204e 6574 32-bit Net │ │ │ │ │ -00041520: 4253 4420 6b65 726e 656c 2069 6d61 6765 BSD kernel image │ │ │ │ │ -00041530: 0a6b 6e65 7462 7364 2e6d 696e 6972 6f6f .knetbsd.miniroo │ │ │ │ │ -00041540: 742e 6933 3836 2020 2020 2020 2020 2033 t.i386 3 │ │ │ │ │ -00041550: 322d 6269 7420 6b4e 6574 4253 4420 6d69 2-bit kNetBSD mi │ │ │ │ │ -00041560: 6e69 726f 6f74 2e6b 6d6f 642e 0a6b 6e65 niroot.kmod..kne │ │ │ │ │ -00041570: 7462 7364 2e78 3836 5f36 342c 2020 2020 tbsd.x86_64, │ │ │ │ │ -00041580: 2020 2020 2020 2020 2020 2073 616d 6520 same │ │ │ │ │ -00041590: 6672 6f6d 2036 342d 6269 7420 6b4e 6574 from 64-bit kNet │ │ │ │ │ -000415a0: 4253 440a 6b6e 6574 6273 642e 6d69 6e69 BSD.knetbsd.mini │ │ │ │ │ -000415b0: 726f 6f74 2e78 3836 5f36 340a 6b6f 7065 root.x86_64.kope │ │ │ │ │ -000415c0: 6e62 7364 2e69 3338 3620 2020 2020 2020 nbsd.i386 │ │ │ │ │ -000415d0: 2020 2020 2020 2020 2020 3332 2d62 6974 32-bit │ │ │ │ │ -000415e0: 204f 7065 6e42 5344 206b 6572 6e65 6c20 OpenBSD kernel │ │ │ │ │ -000415f0: 6273 642e 7264 2069 6d61 6765 0a6b 6f70 bsd.rd image.kop │ │ │ │ │ -00041600: 656e 6273 642e 7838 365f 3634 2020 2020 enbsd.x86_64 │ │ │ │ │ -00041610: 2020 2020 2020 2020 2020 2073 616d 6520 same │ │ │ │ │ -00041620: 6672 6f6d 2036 342d 6269 7420 6b4f 7065 from 64-bit kOpe │ │ │ │ │ -00041630: 6e42 5344 0a6c 696e 7578 2e69 3338 3620 nBSD.linux.i386 │ │ │ │ │ -00041640: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00041650: 2020 2033 322d 6269 7420 4c69 6e75 780a 32-bit Linux. │ │ │ │ │ -00041660: 6c69 6e75 782e 7838 365f 3634 2020 2020 linux.x86_64 │ │ │ │ │ -00041670: 2020 2020 2020 2020 2020 2020 2020 3634 64 │ │ │ │ │ -00041680: 2d62 6974 204c 696e 7578 0a0a 1f0a 4669 -bit Linux....Fi │ │ │ │ │ -00041690: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -000416a0: 4e6f 6465 3a20 5472 6f75 626c 6573 686f Node: Troublesho │ │ │ │ │ -000416b0: 6f74 696e 672c 2020 4e65 7874 3a20 496e oting, Next: In │ │ │ │ │ -000416c0: 766f 6b69 6e67 2067 7275 622d 696e 7374 voking grub-inst │ │ │ │ │ -000416d0: 616c 6c2c 2020 5072 6576 3a20 5375 7070 all, Prev: Supp │ │ │ │ │ -000416e0: 6f72 7465 6420 6b65 726e 656c 732c 2020 orted kernels, │ │ │ │ │ -000416f0: 5570 3a20 546f 700a 0a32 3220 4572 726f Up: Top..22 Erro │ │ │ │ │ -00041700: 7220 6d65 7373 6167 6573 2070 726f 6475 r messages produ │ │ │ │ │ -00041710: 6365 6420 6279 2047 5255 420a 2a2a 2a2a ced by GRUB.**** │ │ │ │ │ +000413a0: 2020 2020 2020 706c 6174 666f 726d 206f platform o │ │ │ │ │ +000413b0: 6e6c 7929 0a47 5255 425f 434f 5245 424f nly).GRUB_COREBO │ │ │ │ │ +000413c0: 4f54 5f52 4f4d 2020 2020 2020 656d 7074 OT_ROM empt │ │ │ │ │ +000413d0: 7920 436f 7265 626f 6f74 2052 4f4d 0a47 y Coreboot ROM.G │ │ │ │ │ +000413e0: 5255 425f 5145 4d55 5f4f 5054 5320 2020 RUB_QEMU_OPTS │ │ │ │ │ +000413f0: 2020 2020 2020 6164 6469 7469 6f6e 616c additional │ │ │ │ │ +00041400: 206f 7074 696f 6e73 2074 6f20 6265 2073 options to be s │ │ │ │ │ +00041410: 7570 706c 6965 6420 746f 2051 454d 550a upplied to QEMU. │ │ │ │ │ +00041420: 0a20 2020 5265 7175 6972 6564 2066 696c . Required fil │ │ │ │ │ +00041430: 6573 2061 7265 3a0a 0a6b 6672 6565 6273 es are:..kfreebs │ │ │ │ │ +00041440: 645f 656e 762e 6933 3836 2020 2020 2020 d_env.i386 │ │ │ │ │ +00041450: 2020 2020 2020 2033 322d 6269 7420 6b46 32-bit kF │ │ │ │ │ +00041460: 7265 6542 5344 2064 6576 6963 6520 6869 reeBSD device hi │ │ │ │ │ +00041470: 6e74 730a 6b66 7265 6562 7364 2e69 3338 nts.kfreebsd.i38 │ │ │ │ │ +00041480: 3620 2020 2020 2020 2020 2020 2020 2020 6 │ │ │ │ │ +00041490: 2020 3332 2d62 6974 2046 7265 6542 5344 32-bit FreeBSD │ │ │ │ │ +000414a0: 206b 6572 6e65 6c20 696d 6167 650a 6b66 kernel image.kf │ │ │ │ │ +000414b0: 7265 6562 7364 2e78 3836 5f36 342c 2020 reebsd.x86_64, │ │ │ │ │ +000414c0: 2020 2020 2020 2020 2020 2020 7361 6d65 same │ │ │ │ │ +000414d0: 2066 726f 6d20 3634 2d62 6974 206b 4672 from 64-bit kFr │ │ │ │ │ +000414e0: 6565 4253 440a 6b66 7265 6562 7364 5f65 eeBSD.kfreebsd_e │ │ │ │ │ +000414f0: 6e76 2e78 3836 5f36 340a 6b6e 6574 6273 nv.x86_64.knetbs │ │ │ │ │ +00041500: 642e 6933 3836 2020 2020 2020 2020 2020 d.i386 │ │ │ │ │ +00041510: 2020 2020 2020 2020 3332 2d62 6974 204e 32-bit N │ │ │ │ │ +00041520: 6574 4253 4420 6b65 726e 656c 2069 6d61 etBSD kernel ima │ │ │ │ │ +00041530: 6765 0a6b 6e65 7462 7364 2e6d 696e 6972 ge.knetbsd.minir │ │ │ │ │ +00041540: 6f6f 742e 6933 3836 2020 2020 2020 2020 oot.i386 │ │ │ │ │ +00041550: 2033 322d 6269 7420 6b4e 6574 4253 4420 32-bit kNetBSD │ │ │ │ │ +00041560: 6d69 6e69 726f 6f74 2e6b 6d6f 642e 0a6b miniroot.kmod..k │ │ │ │ │ +00041570: 6e65 7462 7364 2e78 3836 5f36 342c 2020 netbsd.x86_64, │ │ │ │ │ +00041580: 2020 2020 2020 2020 2020 2020 2073 616d sam │ │ │ │ │ +00041590: 6520 6672 6f6d 2036 342d 6269 7420 6b4e e from 64-bit kN │ │ │ │ │ +000415a0: 6574 4253 440a 6b6e 6574 6273 642e 6d69 etBSD.knetbsd.mi │ │ │ │ │ +000415b0: 6e69 726f 6f74 2e78 3836 5f36 340a 6b6f niroot.x86_64.ko │ │ │ │ │ +000415c0: 7065 6e62 7364 2e69 3338 3620 2020 2020 penbsd.i386 │ │ │ │ │ +000415d0: 2020 2020 2020 2020 2020 2020 3332 2d62 32-b │ │ │ │ │ +000415e0: 6974 204f 7065 6e42 5344 206b 6572 6e65 it OpenBSD kerne │ │ │ │ │ +000415f0: 6c20 6273 642e 7264 2069 6d61 6765 0a6b l bsd.rd image.k │ │ │ │ │ +00041600: 6f70 656e 6273 642e 7838 365f 3634 2020 openbsd.x86_64 │ │ │ │ │ +00041610: 2020 2020 2020 2020 2020 2020 2073 616d sam │ │ │ │ │ +00041620: 6520 6672 6f6d 2036 342d 6269 7420 6b4f e from 64-bit kO │ │ │ │ │ +00041630: 7065 6e42 5344 0a6c 696e 7578 2e69 3338 penBSD.linux.i38 │ │ │ │ │ +00041640: 3620 2020 2020 2020 2020 2020 2020 2020 6 │ │ │ │ │ +00041650: 2020 2020 2033 322d 6269 7420 4c69 6e75 32-bit Linu │ │ │ │ │ +00041660: 780a 6c69 6e75 782e 7838 365f 3634 2020 x.linux.x86_64 │ │ │ │ │ +00041670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00041680: 3634 2d62 6974 204c 696e 7578 0a0a 1f0a 64-bit Linux.... │ │ │ │ │ +00041690: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +000416a0: 2020 4e6f 6465 3a20 5472 6f75 626c 6573 Node: Troubles │ │ │ │ │ +000416b0: 686f 6f74 696e 672c 2020 4e65 7874 3a20 hooting, Next: │ │ │ │ │ +000416c0: 496e 766f 6b69 6e67 2067 7275 622d 696e Invoking grub-in │ │ │ │ │ +000416d0: 7374 616c 6c2c 2020 5072 6576 3a20 5375 stall, Prev: Su │ │ │ │ │ +000416e0: 7070 6f72 7465 6420 6b65 726e 656c 732c pported kernels, │ │ │ │ │ +000416f0: 2020 5570 3a20 546f 700a 0a32 3220 4572 Up: Top..22 Er │ │ │ │ │ +00041700: 726f 7220 6d65 7373 6167 6573 2070 726f ror messages pro │ │ │ │ │ +00041710: 6475 6365 6420 6279 2047 5255 420a 2a2a duced by GRUB.** │ │ │ │ │ 00041720: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00041730: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ -00041740: 2a20 4d65 6e75 3a0a 0a2a 2047 5255 4220 * Menu:..* GRUB │ │ │ │ │ -00041750: 6f6e 6c79 206f 6666 6572 7320 6120 7265 only offers a re │ │ │ │ │ -00041760: 7363 7565 2073 6865 6c6c 3a3a 0a2a 2046 scue shell::.* F │ │ │ │ │ -00041770: 6972 6d77 6172 6520 7374 616c 6c73 2069 irmware stalls i │ │ │ │ │ -00041780: 6e73 7465 6164 206f 6620 626f 6f74 696e nstead of bootin │ │ │ │ │ -00041790: 6720 4752 5542 3a3a 0a0a 1f0a 4669 6c65 g GRUB::....File │ │ │ │ │ -000417a0: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ -000417b0: 6465 3a20 4752 5542 206f 6e6c 7920 6f66 de: GRUB only of │ │ │ │ │ -000417c0: 6665 7273 2061 2072 6573 6375 6520 7368 fers a rescue sh │ │ │ │ │ -000417d0: 656c 6c2c 2020 4e65 7874 3a20 4669 726d ell, Next: Firm │ │ │ │ │ -000417e0: 7761 7265 2073 7461 6c6c 7320 696e 7374 ware stalls inst │ │ │ │ │ -000417f0: 6561 6420 6f66 2062 6f6f 7469 6e67 2047 ead of booting G │ │ │ │ │ -00041800: 5255 422c 2020 5570 3a20 5472 6f75 626c RUB, Up: Troubl │ │ │ │ │ -00041810: 6573 686f 6f74 696e 670a 0a32 322e 3120 eshooting..22.1 │ │ │ │ │ -00041820: 4752 5542 206f 6e6c 7920 6f66 6665 7273 GRUB only offers │ │ │ │ │ -00041830: 2061 2072 6573 6375 6520 7368 656c 6c0a a rescue shell. │ │ │ │ │ -00041840: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00041730: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +00041740: 0a0a 2a20 4d65 6e75 3a0a 0a2a 2047 5255 ..* Menu:..* GRU │ │ │ │ │ +00041750: 4220 6f6e 6c79 206f 6666 6572 7320 6120 B only offers a │ │ │ │ │ +00041760: 7265 7363 7565 2073 6865 6c6c 3a3a 0a2a rescue shell::.* │ │ │ │ │ +00041770: 2046 6972 6d77 6172 6520 7374 616c 6c73 Firmware stalls │ │ │ │ │ +00041780: 2069 6e73 7465 6164 206f 6620 626f 6f74 instead of boot │ │ │ │ │ +00041790: 696e 6720 4752 5542 3a3a 0a0a 1f0a 4669 ing GRUB::....Fi │ │ │ │ │ +000417a0: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ +000417b0: 4e6f 6465 3a20 4752 5542 206f 6e6c 7920 Node: GRUB only │ │ │ │ │ +000417c0: 6f66 6665 7273 2061 2072 6573 6375 6520 offers a rescue │ │ │ │ │ +000417d0: 7368 656c 6c2c 2020 4e65 7874 3a20 4669 shell, Next: Fi │ │ │ │ │ +000417e0: 726d 7761 7265 2073 7461 6c6c 7320 696e rmware stalls in │ │ │ │ │ +000417f0: 7374 6561 6420 6f66 2062 6f6f 7469 6e67 stead of booting │ │ │ │ │ +00041800: 2047 5255 422c 2020 5570 3a20 5472 6f75 GRUB, Up: Trou │ │ │ │ │ +00041810: 626c 6573 686f 6f74 696e 670a 0a32 322e bleshooting..22. │ │ │ │ │ +00041820: 3120 4752 5542 206f 6e6c 7920 6f66 6665 1 GRUB only offe │ │ │ │ │ +00041830: 7273 2061 2072 6573 6375 6520 7368 656c rs a rescue shel │ │ │ │ │ +00041840: 6c0a 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d l.============== │ │ │ │ │ 00041850: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00041860: 3d3d 3d3d 0a0a 4752 5542 2773 206e 6f72 ====..GRUB's nor │ │ │ │ │ -00041870: 6d61 6c20 7374 6172 742d 7570 2070 726f mal start-up pro │ │ │ │ │ -00041880: 6365 6475 7265 2069 6e76 6f6c 7665 7320 cedure involves │ │ │ │ │ -00041890: 7365 7474 696e 6720 7468 6520 2770 7265 setting the 'pre │ │ │ │ │ -000418a0: 6669 7827 0a65 6e76 6972 6f6e 6d65 6e74 fix'.environment │ │ │ │ │ -000418b0: 2076 6172 6961 626c 6520 746f 2061 2076 variable to a v │ │ │ │ │ -000418c0: 616c 7565 2073 6574 2069 6e20 7468 6520 alue set in the │ │ │ │ │ -000418d0: 636f 7265 2069 6d61 6765 2062 7920 2767 core image by 'g │ │ │ │ │ -000418e0: 7275 622d 696e 7374 616c 6c27 2c0a 7365 rub-install',.se │ │ │ │ │ -000418f0: 7474 696e 6720 7468 6520 2772 6f6f 7427 tting the 'root' │ │ │ │ │ -00041900: 2076 6172 6961 626c 6520 746f 206d 6174 variable to mat │ │ │ │ │ -00041910: 6368 2c20 6c6f 6164 696e 6720 7468 6520 ch, loading the │ │ │ │ │ -00041920: 276e 6f72 6d61 6c27 206d 6f64 756c 6520 'normal' module │ │ │ │ │ -00041930: 6672 6f6d 0a74 6865 2070 7265 6669 782c from.the prefix, │ │ │ │ │ -00041940: 2061 6e64 2072 756e 6e69 6e67 2074 6865 and running the │ │ │ │ │ -00041950: 2027 6e6f 726d 616c 2720 636f 6d6d 616e 'normal' comman │ │ │ │ │ -00041960: 6420 282a 6e6f 7465 206e 6f72 6d61 6c3a d (*note normal: │ │ │ │ │ -00041970: 3a29 2e20 2054 6869 730a 636f 6d6d 616e :). This.comman │ │ │ │ │ -00041980: 6420 6973 2072 6573 706f 6e73 6962 6c65 d is responsible │ │ │ │ │ -00041990: 2066 6f72 2072 6561 6469 6e67 2027 2f62 for reading '/b │ │ │ │ │ -000419a0: 6f6f 742f 6772 7562 2f67 7275 622e 6366 oot/grub/grub.cf │ │ │ │ │ -000419b0: 6727 2c20 7275 6e6e 696e 6720 7468 650a g', running the. │ │ │ │ │ -000419c0: 6d65 6e75 2c20 616e 6420 646f 696e 6720 menu, and doing │ │ │ │ │ -000419d0: 616c 6c20 7468 6520 7573 6566 756c 2074 all the useful t │ │ │ │ │ -000419e0: 6869 6e67 7320 4752 5542 2069 7320 7375 hings GRUB is su │ │ │ │ │ -000419f0: 7070 6f73 6564 2074 6f20 646f 2e0a 0a20 pposed to do... │ │ │ │ │ -00041a00: 2020 4966 2c20 696e 7374 6561 642c 2079 If, instead, y │ │ │ │ │ -00041a10: 6f75 206f 6e6c 7920 6765 7420 6120 7265 ou only get a re │ │ │ │ │ -00041a20: 7363 7565 2073 6865 6c6c 2c20 7468 6973 scue shell, this │ │ │ │ │ -00041a30: 2075 7375 616c 6c79 206d 6561 6e73 2074 usually means t │ │ │ │ │ -00041a40: 6861 740a 4752 5542 2066 6169 6c65 6420 hat.GRUB failed │ │ │ │ │ -00041a50: 746f 206c 6f61 6420 7468 6520 276e 6f72 to load the 'nor │ │ │ │ │ -00041a60: 6d61 6c27 206d 6f64 756c 6520 666f 7220 mal' module for │ │ │ │ │ -00041a70: 736f 6d65 2072 6561 736f 6e2e 2020 4974 some reason. It │ │ │ │ │ -00041a80: 206d 6179 2062 650a 706f 7373 6962 6c65 may be.possible │ │ │ │ │ -00041a90: 2074 6f20 776f 726b 2061 726f 756e 6420 to work around │ │ │ │ │ -00041aa0: 7468 6973 2074 656d 706f 7261 7269 6c79 this temporarily │ │ │ │ │ -00041ab0: 3a20 666f 7220 696e 7374 616e 6365 2c20 : for instance, │ │ │ │ │ -00041ac0: 6966 2074 6865 2072 6561 736f 6e0a 666f if the reason.fo │ │ │ │ │ -00041ad0: 7220 7468 6520 6661 696c 7572 6520 6973 r the failure is │ │ │ │ │ -00041ae0: 2074 6861 7420 2770 7265 6669 7827 2069 that 'prefix' i │ │ │ │ │ -00041af0: 7320 7772 6f6e 6720 2870 6572 6861 7073 s wrong (perhaps │ │ │ │ │ -00041b00: 2069 7420 7265 6665 7273 2074 6f20 7468 it refers to th │ │ │ │ │ -00041b10: 650a 7772 6f6e 6720 6465 7669 6365 2c20 e.wrong device, │ │ │ │ │ -00041b20: 6f72 2070 6572 6861 7073 2074 6865 2070 or perhaps the p │ │ │ │ │ -00041b30: 6174 6820 746f 2027 2f62 6f6f 742f 6772 ath to '/boot/gr │ │ │ │ │ -00041b40: 7562 2720 7761 7320 6e6f 7420 636f 7272 ub' was not corr │ │ │ │ │ -00041b50: 6563 746c 7920 6d61 6465 0a72 656c 6174 ectly made.relat │ │ │ │ │ -00041b60: 6976 6520 746f 2074 6865 2064 6576 6963 ive to the devic │ │ │ │ │ -00041b70: 6529 2c20 7468 656e 2079 6f75 2063 616e e), then you can │ │ │ │ │ -00041b80: 2063 6f72 7265 6374 2074 6869 7320 616e correct this an │ │ │ │ │ -00041b90: 6420 656e 7465 7220 6e6f 726d 616c 206d d enter normal m │ │ │ │ │ -00041ba0: 6f64 650a 6d61 6e75 616c 6c79 3a0a 0a20 ode.manually:.. │ │ │ │ │ -00041bb0: 2020 2020 2320 496e 7370 6563 7420 7468 # Inspect th │ │ │ │ │ -00041bc0: 6520 6375 7272 656e 7420 7072 6566 6978 e current prefix │ │ │ │ │ -00041bd0: 2028 616e 6420 6f74 6865 7220 7072 6573 (and other pres │ │ │ │ │ -00041be0: 6574 2076 6172 6961 626c 6573 293a 0a20 et variables):. │ │ │ │ │ -00041bf0: 2020 2020 7365 740a 2020 2020 2023 2046 set. # F │ │ │ │ │ -00041c00: 696e 6420 6f75 7420 7768 6963 6820 6465 ind out which de │ │ │ │ │ -00041c10: 7669 6365 7320 6172 6520 6176 6169 6c61 vices are availa │ │ │ │ │ -00041c20: 626c 653a 0a20 2020 2020 6c73 0a20 2020 ble:. ls. │ │ │ │ │ -00041c30: 2020 2320 5365 7420 746f 2074 6865 2063 # Set to the c │ │ │ │ │ -00041c40: 6f72 7265 6374 2076 616c 7565 2c20 7768 orrect value, wh │ │ │ │ │ -00041c50: 6963 6820 6d69 6768 7420 6265 2073 6f6d ich might be som │ │ │ │ │ -00041c60: 6574 6869 6e67 206c 696b 6520 7468 6973 ething like this │ │ │ │ │ -00041c70: 3a0a 2020 2020 2073 6574 2070 7265 6669 :. set prefi │ │ │ │ │ -00041c80: 783d 2868 6430 2c31 292f 6772 7562 0a20 x=(hd0,1)/grub. │ │ │ │ │ -00041c90: 2020 2020 7365 7420 726f 6f74 3d28 6864 set root=(hd │ │ │ │ │ -00041ca0: 302c 3129 0a20 2020 2020 696e 736d 6f64 0,1). insmod │ │ │ │ │ -00041cb0: 206e 6f72 6d61 6c0a 2020 2020 206e 6f72 normal. nor │ │ │ │ │ -00041cc0: 6d61 6c0a 0a20 2020 486f 7765 7665 722c mal.. However, │ │ │ │ │ -00041cd0: 2061 6e79 2070 726f 626c 656d 2074 6861 any problem tha │ │ │ │ │ -00041ce0: 7420 6c65 6176 6573 2079 6f75 2069 6e20 t leaves you in │ │ │ │ │ -00041cf0: 7468 6520 7265 7363 7565 2073 6865 6c6c the rescue shell │ │ │ │ │ -00041d00: 2070 726f 6261 626c 790a 6d65 616e 7320 probably.means │ │ │ │ │ -00041d10: 7468 6174 2047 5255 4220 7761 7320 6e6f that GRUB was no │ │ │ │ │ -00041d20: 7420 636f 7272 6563 746c 7920 696e 7374 t correctly inst │ │ │ │ │ -00041d30: 616c 6c65 642e 2020 4974 206d 6179 2062 alled. It may b │ │ │ │ │ -00041d40: 6520 6d6f 7265 2075 7365 6675 6c20 746f e more useful to │ │ │ │ │ -00041d50: 0a74 7279 2074 6f20 7265 696e 7374 616c .try to reinstal │ │ │ │ │ -00041d60: 6c20 6974 2070 726f 7065 726c 7920 7573 l it properly us │ │ │ │ │ -00041d70: 696e 6720 2767 7275 622d 696e 7374 616c ing 'grub-instal │ │ │ │ │ -00041d80: 6c20 4445 5649 4345 2720 282a 6e6f 7465 l DEVICE' (*note │ │ │ │ │ -00041d90: 2049 6e76 6f6b 696e 670a 6772 7562 2d69 Invoking.grub-i │ │ │ │ │ -00041da0: 6e73 7461 6c6c 3a3a 292e 2020 5768 656e nstall::). When │ │ │ │ │ -00041db0: 2064 6f69 6e67 2074 6869 732c 2074 6865 doing this, the │ │ │ │ │ -00041dc0: 7265 2061 7265 2061 2066 6577 2074 6869 re are a few thi │ │ │ │ │ -00041dd0: 6e67 7320 746f 2072 656d 656d 6265 723a ngs to remember: │ │ │ │ │ -00041de0: 0a0a 2020 202a 2044 7269 7665 206f 7264 .. * Drive ord │ │ │ │ │ -00041df0: 6572 696e 6720 696e 2079 6f75 7220 6f70 ering in your op │ │ │ │ │ -00041e00: 6572 6174 696e 6720 7379 7374 656d 206d erating system m │ │ │ │ │ -00041e10: 6179 206e 6f74 2062 6520 7468 6520 7361 ay not be the sa │ │ │ │ │ -00041e20: 6d65 2061 7320 7468 650a 2020 2020 2062 me as the. b │ │ │ │ │ -00041e30: 6f6f 7420 6472 6976 6520 6f72 6465 7269 oot drive orderi │ │ │ │ │ -00041e40: 6e67 2075 7365 6420 6279 2079 6f75 7220 ng used by your │ │ │ │ │ -00041e50: 6669 726d 7761 7265 2e20 2044 6f20 6e6f firmware. Do no │ │ │ │ │ -00041e60: 7420 6173 7375 6d65 2074 6861 7420 796f t assume that yo │ │ │ │ │ -00041e70: 7572 0a20 2020 2020 6669 7273 7420 6861 ur. first ha │ │ │ │ │ -00041e80: 7264 2064 7269 7665 2028 652e 672e 2020 rd drive (e.g. │ │ │ │ │ -00041e90: 272f 6465 762f 7364 6127 2920 6973 2074 '/dev/sda') is t │ │ │ │ │ -00041ea0: 6865 206f 6e65 2074 6861 7420 796f 7572 he one that your │ │ │ │ │ -00041eb0: 2066 6972 6d77 6172 650a 2020 2020 2077 firmware. w │ │ │ │ │ -00041ec0: 696c 6c20 626f 6f74 2066 726f 6d2e 2020 ill boot from. │ │ │ │ │ -00041ed0: 2764 6576 6963 652e 6d61 7027 2028 2a6e 'device.map' (*n │ │ │ │ │ -00041ee0: 6f74 6520 4465 7669 6365 206d 6170 3a3a ote Device map:: │ │ │ │ │ -00041ef0: 2920 6361 6e20 6265 2075 7365 6420 746f ) can be used to │ │ │ │ │ -00041f00: 0a20 2020 2020 6f76 6572 7269 6465 2074 . override t │ │ │ │ │ -00041f10: 6869 732c 2062 7574 2069 7420 6973 2075 his, but it is u │ │ │ │ │ -00041f20: 7375 616c 6c79 2062 6574 7465 7220 746f sually better to │ │ │ │ │ -00041f30: 2075 7365 2055 5549 4473 206f 7220 6669 use UUIDs or fi │ │ │ │ │ -00041f40: 6c65 2073 7973 7465 6d0a 2020 2020 206c le system. l │ │ │ │ │ -00041f50: 6162 656c 7320 616e 6420 6176 6f69 6420 abels and avoid │ │ │ │ │ -00041f60: 6465 7065 6e64 696e 6720 6f6e 2064 7269 depending on dri │ │ │ │ │ -00041f70: 7665 206f 7264 6572 696e 6720 656e 7469 ve ordering enti │ │ │ │ │ -00041f80: 7265 6c79 2e0a 0a20 2020 2a20 4174 206c rely... * At l │ │ │ │ │ -00041f90: 6561 7374 206f 6e20 4249 4f53 2073 7973 east on BIOS sys │ │ │ │ │ -00041fa0: 7465 6d73 2c20 6966 2079 6f75 2074 656c tems, if you tel │ │ │ │ │ -00041fb0: 6c20 2767 7275 622d 696e 7374 616c 6c27 l 'grub-install' │ │ │ │ │ -00041fc0: 2074 6f20 696e 7374 616c 6c0a 2020 2020 to install. │ │ │ │ │ -00041fd0: 2047 5255 4220 746f 2061 2070 6172 7469 GRUB to a parti │ │ │ │ │ -00041fe0: 7469 6f6e 2062 7574 2047 5255 4220 6861 tion but GRUB ha │ │ │ │ │ -00041ff0: 7320 616c 7265 6164 7920 6265 656e 2069 s already been i │ │ │ │ │ -00042000: 6e73 7461 6c6c 6564 2069 6e20 7468 650a nstalled in the. │ │ │ │ │ -00042010: 2020 2020 206d 6173 7465 7220 626f 6f74 master boot │ │ │ │ │ -00042020: 2072 6563 6f72 642c 2074 6865 6e20 7468 record, then th │ │ │ │ │ -00042030: 6520 4752 5542 2069 6e73 7461 6c6c 6174 e GRUB installat │ │ │ │ │ -00042040: 696f 6e20 696e 2074 6865 2070 6172 7469 ion in the parti │ │ │ │ │ -00042050: 7469 6f6e 0a20 2020 2020 7769 6c6c 2062 tion. will b │ │ │ │ │ -00042060: 6520 6967 6e6f 7265 642e 0a0a 2020 202a e ignored... * │ │ │ │ │ -00042070: 2049 6620 706f 7373 6962 6c65 2c20 6974 If possible, it │ │ │ │ │ -00042080: 2069 7320 6765 6e65 7261 6c6c 7920 6265 is generally be │ │ │ │ │ -00042090: 7374 2074 6f20 6176 6f69 6420 696e 7374 st to avoid inst │ │ │ │ │ -000420a0: 616c 6c69 6e67 2047 5255 4220 746f 2061 alling GRUB to a │ │ │ │ │ -000420b0: 0a20 2020 2020 7061 7274 6974 696f 6e20 . partition │ │ │ │ │ -000420c0: 2875 6e6c 6573 7320 6974 2069 7320 6120 (unless it is a │ │ │ │ │ -000420d0: 7370 6563 6961 6c20 7061 7274 6974 696f special partitio │ │ │ │ │ -000420e0: 6e20 666f 7220 7468 6520 7573 6520 6f66 n for the use of │ │ │ │ │ -000420f0: 2047 5255 420a 2020 2020 2061 6c6f 6e65 GRUB. alone │ │ │ │ │ -00042100: 2c20 7375 6368 2061 7320 7468 6520 4249 , such as the BI │ │ │ │ │ -00042110: 4f53 2042 6f6f 7420 5061 7274 6974 696f OS Boot Partitio │ │ │ │ │ -00042120: 6e20 7573 6564 206f 6e20 4750 5429 2e20 n used on GPT). │ │ │ │ │ -00042130: 446f 696e 6720 7468 6973 0a20 2020 2020 Doing this. │ │ │ │ │ -00042140: 6d65 616e 7320 7468 6174 2047 5255 4220 means that GRUB │ │ │ │ │ -00042150: 6d61 7920 7374 6f70 2062 6569 6e67 2061 may stop being a │ │ │ │ │ -00042160: 626c 6520 746f 2072 6561 6420 6974 7320 ble to read its │ │ │ │ │ -00042170: 636f 7265 2069 6d61 6765 2064 7565 2074 core image due t │ │ │ │ │ -00042180: 6f20 610a 2020 2020 2066 696c 6520 7379 o a. file sy │ │ │ │ │ -00042190: 7374 656d 206d 6f76 696e 6720 626c 6f63 stem moving bloc │ │ │ │ │ -000421a0: 6b73 2061 726f 756e 642c 2073 7563 6820 ks around, such │ │ │ │ │ -000421b0: 6173 2077 6869 6c65 2064 6566 7261 676d as while defragm │ │ │ │ │ -000421c0: 656e 7469 6e67 2c0a 2020 2020 2072 756e enting,. run │ │ │ │ │ -000421d0: 6e69 6e67 2063 6865 636b 732c 206f 7220 ning checks, or │ │ │ │ │ -000421e0: 6576 656e 2064 7572 696e 6720 6e6f 726d even during norm │ │ │ │ │ -000421f0: 616c 206f 7065 7261 7469 6f6e 2e20 2049 al operation. I │ │ │ │ │ -00042200: 6e73 7461 6c6c 696e 6720 746f 2074 6865 nstalling to the │ │ │ │ │ -00042210: 0a20 2020 2020 7768 6f6c 6520 6469 736b . whole disk │ │ │ │ │ -00042220: 2064 6576 6963 6520 6973 206e 6f72 6d61 device is norma │ │ │ │ │ -00042230: 6c6c 7920 6d6f 7265 2072 6f62 7573 742e lly more robust. │ │ │ │ │ -00042240: 0a0a 2020 202a 2043 6865 636b 2074 6861 .. * Check tha │ │ │ │ │ -00042250: 7420 4752 5542 2061 6374 7561 6c6c 7920 t GRUB actually │ │ │ │ │ -00042260: 6b6e 6f77 7320 686f 7720 746f 2072 6561 knows how to rea │ │ │ │ │ -00042270: 6420 6672 6f6d 2074 6865 2064 6576 6963 d from the devic │ │ │ │ │ -00042280: 6520 616e 6420 6669 6c65 0a20 2020 2020 e and file. │ │ │ │ │ -00042290: 7379 7374 656d 2063 6f6e 7461 696e 696e system containin │ │ │ │ │ -000422a0: 6720 272f 626f 6f74 2f67 7275 6227 2e20 g '/boot/grub'. │ │ │ │ │ -000422b0: 2049 7420 7769 6c6c 206e 6f74 2062 6520 It will not be │ │ │ │ │ -000422c0: 6162 6c65 2074 6f20 7265 6164 2066 726f able to read fro │ │ │ │ │ -000422d0: 6d0a 2020 2020 2065 6e63 7279 7074 6564 m. encrypted │ │ │ │ │ -000422e0: 2064 6576 6963 6573 2077 6974 6820 756e devices with un │ │ │ │ │ -000422f0: 7375 7070 6f72 7465 6420 656e 6372 7970 supported encryp │ │ │ │ │ -00042300: 7469 6f6e 2073 6368 656d 652c 206e 6f72 tion scheme, nor │ │ │ │ │ -00042310: 2066 726f 6d20 6669 6c65 0a20 2020 2020 from file. │ │ │ │ │ -00042320: 7379 7374 656d 7320 666f 7220 7768 6963 systems for whic │ │ │ │ │ -00042330: 6820 7375 7070 6f72 7420 6861 7320 6e6f h support has no │ │ │ │ │ -00042340: 7420 7965 7420 6265 656e 2061 6464 6564 t yet been added │ │ │ │ │ -00042350: 2074 6f20 4752 5542 2e0a 0a1f 0a46 696c to GRUB.....Fil │ │ │ │ │ -00042360: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ -00042370: 6f64 653a 2046 6972 6d77 6172 6520 7374 ode: Firmware st │ │ │ │ │ -00042380: 616c 6c73 2069 6e73 7465 6164 206f 6620 alls instead of │ │ │ │ │ -00042390: 626f 6f74 696e 6720 4752 5542 2c20 2050 booting GRUB, P │ │ │ │ │ -000423a0: 7265 763a 2047 5255 4220 6f6e 6c79 206f rev: GRUB only o │ │ │ │ │ -000423b0: 6666 6572 7320 6120 7265 7363 7565 2073 ffers a rescue s │ │ │ │ │ -000423c0: 6865 6c6c 2c20 2055 703a 2054 726f 7562 hell, Up: Troub │ │ │ │ │ -000423d0: 6c65 7368 6f6f 7469 6e67 0a0a 3232 2e32 leshooting..22.2 │ │ │ │ │ -000423e0: 2046 6972 6d77 6172 6520 7374 616c 6c73 Firmware stalls │ │ │ │ │ -000423f0: 2069 6e73 7465 6164 206f 6620 626f 6f74 instead of boot │ │ │ │ │ -00042400: 696e 6720 4752 5542 0a3d 3d3d 3d3d 3d3d ing GRUB.======= │ │ │ │ │ +00041860: 3d3d 3d3d 3d3d 0a0a 4752 5542 2773 206e ======..GRUB's n │ │ │ │ │ +00041870: 6f72 6d61 6c20 7374 6172 742d 7570 2070 ormal start-up p │ │ │ │ │ +00041880: 726f 6365 6475 7265 2069 6e76 6f6c 7665 rocedure involve │ │ │ │ │ +00041890: 7320 7365 7474 696e 6720 7468 6520 2770 s setting the 'p │ │ │ │ │ +000418a0: 7265 6669 7827 0a65 6e76 6972 6f6e 6d65 refix'.environme │ │ │ │ │ +000418b0: 6e74 2076 6172 6961 626c 6520 746f 2061 nt variable to a │ │ │ │ │ +000418c0: 2076 616c 7565 2073 6574 2069 6e20 7468 value set in th │ │ │ │ │ +000418d0: 6520 636f 7265 2069 6d61 6765 2062 7920 e core image by │ │ │ │ │ +000418e0: 2767 7275 622d 696e 7374 616c 6c27 2c0a 'grub-install',. │ │ │ │ │ +000418f0: 7365 7474 696e 6720 7468 6520 2772 6f6f setting the 'roo │ │ │ │ │ +00041900: 7427 2076 6172 6961 626c 6520 746f 206d t' variable to m │ │ │ │ │ +00041910: 6174 6368 2c20 6c6f 6164 696e 6720 7468 atch, loading th │ │ │ │ │ +00041920: 6520 276e 6f72 6d61 6c27 206d 6f64 756c e 'normal' modul │ │ │ │ │ +00041930: 6520 6672 6f6d 0a74 6865 2070 7265 6669 e from.the prefi │ │ │ │ │ +00041940: 782c 2061 6e64 2072 756e 6e69 6e67 2074 x, and running t │ │ │ │ │ +00041950: 6865 2027 6e6f 726d 616c 2720 636f 6d6d he 'normal' comm │ │ │ │ │ +00041960: 616e 6420 282a 6e6f 7465 206e 6f72 6d61 and (*note norma │ │ │ │ │ +00041970: 6c3a 3a29 2e20 2054 6869 730a 636f 6d6d l::). This.comm │ │ │ │ │ +00041980: 616e 6420 6973 2072 6573 706f 6e73 6962 and is responsib │ │ │ │ │ +00041990: 6c65 2066 6f72 2072 6561 6469 6e67 2027 le for reading ' │ │ │ │ │ +000419a0: 2f62 6f6f 742f 6772 7562 2f67 7275 622e /boot/grub/grub. │ │ │ │ │ +000419b0: 6366 6727 2c20 7275 6e6e 696e 6720 7468 cfg', running th │ │ │ │ │ +000419c0: 650a 6d65 6e75 2c20 616e 6420 646f 696e e.menu, and doin │ │ │ │ │ +000419d0: 6720 616c 6c20 7468 6520 7573 6566 756c g all the useful │ │ │ │ │ +000419e0: 2074 6869 6e67 7320 4752 5542 2069 7320 things GRUB is │ │ │ │ │ +000419f0: 7375 7070 6f73 6564 2074 6f20 646f 2e0a supposed to do.. │ │ │ │ │ +00041a00: 0a20 2020 4966 2c20 696e 7374 6561 642c . If, instead, │ │ │ │ │ +00041a10: 2079 6f75 206f 6e6c 7920 6765 7420 6120 you only get a │ │ │ │ │ +00041a20: 7265 7363 7565 2073 6865 6c6c 2c20 7468 rescue shell, th │ │ │ │ │ +00041a30: 6973 2075 7375 616c 6c79 206d 6561 6e73 is usually means │ │ │ │ │ +00041a40: 2074 6861 740a 4752 5542 2066 6169 6c65 that.GRUB faile │ │ │ │ │ +00041a50: 6420 746f 206c 6f61 6420 7468 6520 276e d to load the 'n │ │ │ │ │ +00041a60: 6f72 6d61 6c27 206d 6f64 756c 6520 666f ormal' module fo │ │ │ │ │ +00041a70: 7220 736f 6d65 2072 6561 736f 6e2e 2020 r some reason. │ │ │ │ │ +00041a80: 4974 206d 6179 2062 650a 706f 7373 6962 It may be.possib │ │ │ │ │ +00041a90: 6c65 2074 6f20 776f 726b 2061 726f 756e le to work aroun │ │ │ │ │ +00041aa0: 6420 7468 6973 2074 656d 706f 7261 7269 d this temporari │ │ │ │ │ +00041ab0: 6c79 3a20 666f 7220 696e 7374 616e 6365 ly: for instance │ │ │ │ │ +00041ac0: 2c20 6966 2074 6865 2072 6561 736f 6e0a , if the reason. │ │ │ │ │ +00041ad0: 666f 7220 7468 6520 6661 696c 7572 6520 for the failure │ │ │ │ │ +00041ae0: 6973 2074 6861 7420 2770 7265 6669 7827 is that 'prefix' │ │ │ │ │ +00041af0: 2069 7320 7772 6f6e 6720 2870 6572 6861 is wrong (perha │ │ │ │ │ +00041b00: 7073 2069 7420 7265 6665 7273 2074 6f20 ps it refers to │ │ │ │ │ +00041b10: 7468 650a 7772 6f6e 6720 6465 7669 6365 the.wrong device │ │ │ │ │ +00041b20: 2c20 6f72 2070 6572 6861 7073 2074 6865 , or perhaps the │ │ │ │ │ +00041b30: 2070 6174 6820 746f 2027 2f62 6f6f 742f path to '/boot/ │ │ │ │ │ +00041b40: 6772 7562 2720 7761 7320 6e6f 7420 636f grub' was not co │ │ │ │ │ +00041b50: 7272 6563 746c 7920 6d61 6465 0a72 656c rrectly made.rel │ │ │ │ │ +00041b60: 6174 6976 6520 746f 2074 6865 2064 6576 ative to the dev │ │ │ │ │ +00041b70: 6963 6529 2c20 7468 656e 2079 6f75 2063 ice), then you c │ │ │ │ │ +00041b80: 616e 2063 6f72 7265 6374 2074 6869 7320 an correct this │ │ │ │ │ +00041b90: 616e 6420 656e 7465 7220 6e6f 726d 616c and enter normal │ │ │ │ │ +00041ba0: 206d 6f64 650a 6d61 6e75 616c 6c79 3a0a mode.manually:. │ │ │ │ │ +00041bb0: 0a20 2020 2020 2320 496e 7370 6563 7420 . # Inspect │ │ │ │ │ +00041bc0: 7468 6520 6375 7272 656e 7420 7072 6566 the current pref │ │ │ │ │ +00041bd0: 6978 2028 616e 6420 6f74 6865 7220 7072 ix (and other pr │ │ │ │ │ +00041be0: 6573 6574 2076 6172 6961 626c 6573 293a eset variables): │ │ │ │ │ +00041bf0: 0a20 2020 2020 7365 740a 2020 2020 2023 . set. # │ │ │ │ │ +00041c00: 2046 696e 6420 6f75 7420 7768 6963 6820 Find out which │ │ │ │ │ +00041c10: 6465 7669 6365 7320 6172 6520 6176 6169 devices are avai │ │ │ │ │ +00041c20: 6c61 626c 653a 0a20 2020 2020 6c73 0a20 lable:. ls. │ │ │ │ │ +00041c30: 2020 2020 2320 5365 7420 746f 2074 6865 # Set to the │ │ │ │ │ +00041c40: 2063 6f72 7265 6374 2076 616c 7565 2c20 correct value, │ │ │ │ │ +00041c50: 7768 6963 6820 6d69 6768 7420 6265 2073 which might be s │ │ │ │ │ +00041c60: 6f6d 6574 6869 6e67 206c 696b 6520 7468 omething like th │ │ │ │ │ +00041c70: 6973 3a0a 2020 2020 2073 6574 2070 7265 is:. set pre │ │ │ │ │ +00041c80: 6669 783d 2868 6430 2c31 292f 6772 7562 fix=(hd0,1)/grub │ │ │ │ │ +00041c90: 0a20 2020 2020 7365 7420 726f 6f74 3d28 . set root=( │ │ │ │ │ +00041ca0: 6864 302c 3129 0a20 2020 2020 696e 736d hd0,1). insm │ │ │ │ │ +00041cb0: 6f64 206e 6f72 6d61 6c0a 2020 2020 206e od normal. n │ │ │ │ │ +00041cc0: 6f72 6d61 6c0a 0a20 2020 486f 7765 7665 ormal.. Howeve │ │ │ │ │ +00041cd0: 722c 2061 6e79 2070 726f 626c 656d 2074 r, any problem t │ │ │ │ │ +00041ce0: 6861 7420 6c65 6176 6573 2079 6f75 2069 hat leaves you i │ │ │ │ │ +00041cf0: 6e20 7468 6520 7265 7363 7565 2073 6865 n the rescue she │ │ │ │ │ +00041d00: 6c6c 2070 726f 6261 626c 790a 6d65 616e ll probably.mean │ │ │ │ │ +00041d10: 7320 7468 6174 2047 5255 4220 7761 7320 s that GRUB was │ │ │ │ │ +00041d20: 6e6f 7420 636f 7272 6563 746c 7920 696e not correctly in │ │ │ │ │ +00041d30: 7374 616c 6c65 642e 2020 4974 206d 6179 stalled. It may │ │ │ │ │ +00041d40: 2062 6520 6d6f 7265 2075 7365 6675 6c20 be more useful │ │ │ │ │ +00041d50: 746f 0a74 7279 2074 6f20 7265 696e 7374 to.try to reinst │ │ │ │ │ +00041d60: 616c 6c20 6974 2070 726f 7065 726c 7920 all it properly │ │ │ │ │ +00041d70: 7573 696e 6720 2767 7275 622d 696e 7374 using 'grub-inst │ │ │ │ │ +00041d80: 616c 6c20 4445 5649 4345 2720 282a 6e6f all DEVICE' (*no │ │ │ │ │ +00041d90: 7465 2049 6e76 6f6b 696e 670a 6772 7562 te Invoking.grub │ │ │ │ │ +00041da0: 2d69 6e73 7461 6c6c 3a3a 292e 2020 5768 -install::). Wh │ │ │ │ │ +00041db0: 656e 2064 6f69 6e67 2074 6869 732c 2074 en doing this, t │ │ │ │ │ +00041dc0: 6865 7265 2061 7265 2061 2066 6577 2074 here are a few t │ │ │ │ │ +00041dd0: 6869 6e67 7320 746f 2072 656d 656d 6265 hings to remembe │ │ │ │ │ +00041de0: 723a 0a0a 2020 202a 2044 7269 7665 206f r:.. * Drive o │ │ │ │ │ +00041df0: 7264 6572 696e 6720 696e 2079 6f75 7220 rdering in your │ │ │ │ │ +00041e00: 6f70 6572 6174 696e 6720 7379 7374 656d operating system │ │ │ │ │ +00041e10: 206d 6179 206e 6f74 2062 6520 7468 6520 may not be the │ │ │ │ │ +00041e20: 7361 6d65 2061 7320 7468 650a 2020 2020 same as the. │ │ │ │ │ +00041e30: 2062 6f6f 7420 6472 6976 6520 6f72 6465 boot drive orde │ │ │ │ │ +00041e40: 7269 6e67 2075 7365 6420 6279 2079 6f75 ring used by you │ │ │ │ │ +00041e50: 7220 6669 726d 7761 7265 2e20 2044 6f20 r firmware. Do │ │ │ │ │ +00041e60: 6e6f 7420 6173 7375 6d65 2074 6861 7420 not assume that │ │ │ │ │ +00041e70: 796f 7572 0a20 2020 2020 6669 7273 7420 your. first │ │ │ │ │ +00041e80: 6861 7264 2064 7269 7665 2028 652e 672e hard drive (e.g. │ │ │ │ │ +00041e90: 2020 272f 6465 762f 7364 6127 2920 6973 '/dev/sda') is │ │ │ │ │ +00041ea0: 2074 6865 206f 6e65 2074 6861 7420 796f the one that yo │ │ │ │ │ +00041eb0: 7572 2066 6972 6d77 6172 650a 2020 2020 ur firmware. │ │ │ │ │ +00041ec0: 2077 696c 6c20 626f 6f74 2066 726f 6d2e will boot from. │ │ │ │ │ +00041ed0: 2020 2764 6576 6963 652e 6d61 7027 2028 'device.map' ( │ │ │ │ │ +00041ee0: 2a6e 6f74 6520 4465 7669 6365 206d 6170 *note Device map │ │ │ │ │ +00041ef0: 3a3a 2920 6361 6e20 6265 2075 7365 6420 ::) can be used │ │ │ │ │ +00041f00: 746f 0a20 2020 2020 6f76 6572 7269 6465 to. override │ │ │ │ │ +00041f10: 2074 6869 732c 2062 7574 2069 7420 6973 this, but it is │ │ │ │ │ +00041f20: 2075 7375 616c 6c79 2062 6574 7465 7220 usually better │ │ │ │ │ +00041f30: 746f 2075 7365 2055 5549 4473 206f 7220 to use UUIDs or │ │ │ │ │ +00041f40: 6669 6c65 2073 7973 7465 6d0a 2020 2020 file system. │ │ │ │ │ +00041f50: 206c 6162 656c 7320 616e 6420 6176 6f69 labels and avoi │ │ │ │ │ +00041f60: 6420 6465 7065 6e64 696e 6720 6f6e 2064 d depending on d │ │ │ │ │ +00041f70: 7269 7665 206f 7264 6572 696e 6720 656e rive ordering en │ │ │ │ │ +00041f80: 7469 7265 6c79 2e0a 0a20 2020 2a20 4174 tirely... * At │ │ │ │ │ +00041f90: 206c 6561 7374 206f 6e20 4249 4f53 2073 least on BIOS s │ │ │ │ │ +00041fa0: 7973 7465 6d73 2c20 6966 2079 6f75 2074 ystems, if you t │ │ │ │ │ +00041fb0: 656c 6c20 2767 7275 622d 696e 7374 616c ell 'grub-instal │ │ │ │ │ +00041fc0: 6c27 2074 6f20 696e 7374 616c 6c0a 2020 l' to install. │ │ │ │ │ +00041fd0: 2020 2047 5255 4220 746f 2061 2070 6172 GRUB to a par │ │ │ │ │ +00041fe0: 7469 7469 6f6e 2062 7574 2047 5255 4220 tition but GRUB │ │ │ │ │ +00041ff0: 6861 7320 616c 7265 6164 7920 6265 656e has already been │ │ │ │ │ +00042000: 2069 6e73 7461 6c6c 6564 2069 6e20 7468 installed in th │ │ │ │ │ +00042010: 650a 2020 2020 206d 6173 7465 7220 626f e. master bo │ │ │ │ │ +00042020: 6f74 2072 6563 6f72 642c 2074 6865 6e20 ot record, then │ │ │ │ │ +00042030: 7468 6520 4752 5542 2069 6e73 7461 6c6c the GRUB install │ │ │ │ │ +00042040: 6174 696f 6e20 696e 2074 6865 2070 6172 ation in the par │ │ │ │ │ +00042050: 7469 7469 6f6e 0a20 2020 2020 7769 6c6c tition. will │ │ │ │ │ +00042060: 2062 6520 6967 6e6f 7265 642e 0a0a 2020 be ignored... │ │ │ │ │ +00042070: 202a 2049 6620 706f 7373 6962 6c65 2c20 * If possible, │ │ │ │ │ +00042080: 6974 2069 7320 6765 6e65 7261 6c6c 7920 it is generally │ │ │ │ │ +00042090: 6265 7374 2074 6f20 6176 6f69 6420 696e best to avoid in │ │ │ │ │ +000420a0: 7374 616c 6c69 6e67 2047 5255 4220 746f stalling GRUB to │ │ │ │ │ +000420b0: 2061 0a20 2020 2020 7061 7274 6974 696f a. partitio │ │ │ │ │ +000420c0: 6e20 2875 6e6c 6573 7320 6974 2069 7320 n (unless it is │ │ │ │ │ +000420d0: 6120 7370 6563 6961 6c20 7061 7274 6974 a special partit │ │ │ │ │ +000420e0: 696f 6e20 666f 7220 7468 6520 7573 6520 ion for the use │ │ │ │ │ +000420f0: 6f66 2047 5255 420a 2020 2020 2061 6c6f of GRUB. alo │ │ │ │ │ +00042100: 6e65 2c20 7375 6368 2061 7320 7468 6520 ne, such as the │ │ │ │ │ +00042110: 4249 4f53 2042 6f6f 7420 5061 7274 6974 BIOS Boot Partit │ │ │ │ │ +00042120: 696f 6e20 7573 6564 206f 6e20 4750 5429 ion used on GPT) │ │ │ │ │ +00042130: 2e20 446f 696e 6720 7468 6973 0a20 2020 . Doing this. │ │ │ │ │ +00042140: 2020 6d65 616e 7320 7468 6174 2047 5255 means that GRU │ │ │ │ │ +00042150: 4220 6d61 7920 7374 6f70 2062 6569 6e67 B may stop being │ │ │ │ │ +00042160: 2061 626c 6520 746f 2072 6561 6420 6974 able to read it │ │ │ │ │ +00042170: 7320 636f 7265 2069 6d61 6765 2064 7565 s core image due │ │ │ │ │ +00042180: 2074 6f20 610a 2020 2020 2066 696c 6520 to a. file │ │ │ │ │ +00042190: 7379 7374 656d 206d 6f76 696e 6720 626c system moving bl │ │ │ │ │ +000421a0: 6f63 6b73 2061 726f 756e 642c 2073 7563 ocks around, suc │ │ │ │ │ +000421b0: 6820 6173 2077 6869 6c65 2064 6566 7261 h as while defra │ │ │ │ │ +000421c0: 676d 656e 7469 6e67 2c0a 2020 2020 2072 gmenting,. r │ │ │ │ │ +000421d0: 756e 6e69 6e67 2063 6865 636b 732c 206f unning checks, o │ │ │ │ │ +000421e0: 7220 6576 656e 2064 7572 696e 6720 6e6f r even during no │ │ │ │ │ +000421f0: 726d 616c 206f 7065 7261 7469 6f6e 2e20 rmal operation. │ │ │ │ │ +00042200: 2049 6e73 7461 6c6c 696e 6720 746f 2074 Installing to t │ │ │ │ │ +00042210: 6865 0a20 2020 2020 7768 6f6c 6520 6469 he. whole di │ │ │ │ │ +00042220: 736b 2064 6576 6963 6520 6973 206e 6f72 sk device is nor │ │ │ │ │ +00042230: 6d61 6c6c 7920 6d6f 7265 2072 6f62 7573 mally more robus │ │ │ │ │ +00042240: 742e 0a0a 2020 202a 2043 6865 636b 2074 t... * Check t │ │ │ │ │ +00042250: 6861 7420 4752 5542 2061 6374 7561 6c6c hat GRUB actuall │ │ │ │ │ +00042260: 7920 6b6e 6f77 7320 686f 7720 746f 2072 y knows how to r │ │ │ │ │ +00042270: 6561 6420 6672 6f6d 2074 6865 2064 6576 ead from the dev │ │ │ │ │ +00042280: 6963 6520 616e 6420 6669 6c65 0a20 2020 ice and file. │ │ │ │ │ +00042290: 2020 7379 7374 656d 2063 6f6e 7461 696e system contain │ │ │ │ │ +000422a0: 696e 6720 272f 626f 6f74 2f67 7275 6227 ing '/boot/grub' │ │ │ │ │ +000422b0: 2e20 2049 7420 7769 6c6c 206e 6f74 2062 . It will not b │ │ │ │ │ +000422c0: 6520 6162 6c65 2074 6f20 7265 6164 2066 e able to read f │ │ │ │ │ +000422d0: 726f 6d0a 2020 2020 2065 6e63 7279 7074 rom. encrypt │ │ │ │ │ +000422e0: 6564 2064 6576 6963 6573 2077 6974 6820 ed devices with │ │ │ │ │ +000422f0: 756e 7375 7070 6f72 7465 6420 656e 6372 unsupported encr │ │ │ │ │ +00042300: 7970 7469 6f6e 2073 6368 656d 652c 206e yption scheme, n │ │ │ │ │ +00042310: 6f72 2066 726f 6d20 6669 6c65 0a20 2020 or from file. │ │ │ │ │ +00042320: 2020 7379 7374 656d 7320 666f 7220 7768 systems for wh │ │ │ │ │ +00042330: 6963 6820 7375 7070 6f72 7420 6861 7320 ich support has │ │ │ │ │ +00042340: 6e6f 7420 7965 7420 6265 656e 2061 6464 not yet been add │ │ │ │ │ +00042350: 6564 2074 6f20 4752 5542 2e0a 0a1f 0a46 ed to GRUB.....F │ │ │ │ │ +00042360: 696c 653a 2067 7275 622e 696e 666f 2c20 ile: grub.info, │ │ │ │ │ +00042370: 204e 6f64 653a 2046 6972 6d77 6172 6520 Node: Firmware │ │ │ │ │ +00042380: 7374 616c 6c73 2069 6e73 7465 6164 206f stalls instead o │ │ │ │ │ +00042390: 6620 626f 6f74 696e 6720 4752 5542 2c20 f booting GRUB, │ │ │ │ │ +000423a0: 2050 7265 763a 2047 5255 4220 6f6e 6c79 Prev: GRUB only │ │ │ │ │ +000423b0: 206f 6666 6572 7320 6120 7265 7363 7565 offers a rescue │ │ │ │ │ +000423c0: 2073 6865 6c6c 2c20 2055 703a 2054 726f shell, Up: Tro │ │ │ │ │ +000423d0: 7562 6c65 7368 6f6f 7469 6e67 0a0a 3232 ubleshooting..22 │ │ │ │ │ +000423e0: 2e32 2046 6972 6d77 6172 6520 7374 616c .2 Firmware stal │ │ │ │ │ +000423f0: 6c73 2069 6e73 7465 6164 206f 6620 626f ls instead of bo │ │ │ │ │ +00042400: 6f74 696e 6720 4752 5542 0a3d 3d3d 3d3d oting GRUB.===== │ │ │ │ │ 00042410: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ 00042420: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00042430: 3d3d 3d3d 3d0a 0a54 6865 2045 4649 2069 =====..The EFI i │ │ │ │ │ -00042440: 6d70 6c65 6d65 6e74 6174 696f 6e20 6f66 mplementation of │ │ │ │ │ -00042450: 2073 6f6d 6520 6f6c 6465 7220 4d61 6342 some older MacB │ │ │ │ │ -00042460: 6f6f 6b20 6c61 7074 6f70 7320 7374 616c ook laptops stal │ │ │ │ │ -00042470: 6c73 2077 6865 6e20 6974 2067 6574 730a ls when it gets. │ │ │ │ │ -00042480: 7072 6573 656e 7465 6420 6120 6772 7562 presented a grub │ │ │ │ │ -00042490: 2d6d 6b72 6573 6375 6520 4953 4f20 696d -mkrescue ISO im │ │ │ │ │ -000424a0: 6167 6520 666f 7220 7838 365f 3634 2d65 age for x86_64-e │ │ │ │ │ -000424b0: 6669 2074 6172 6765 7420 6f6e 2061 6e20 fi target on an │ │ │ │ │ -000424c0: 5553 420a 7374 6963 6b2e 2020 4166 6665 USB.stick. Affe │ │ │ │ │ -000424d0: 6374 6564 2061 7265 206d 6f64 656c 7320 cted are models │ │ │ │ │ -000424e0: 6f66 2079 6561 7220 3230 3130 206f 7220 of year 2010 or │ │ │ │ │ -000424f0: 6561 726c 6965 722e 2020 576f 726b 6172 earlier. Workar │ │ │ │ │ -00042500: 6f75 6e64 2069 7320 746f 0a7a 6572 6f69 ound is to.zeroi │ │ │ │ │ -00042510: 7a65 2074 6865 2062 7974 6573 2034 3436 ze the bytes 446 │ │ │ │ │ -00042520: 2074 6f20 3436 3120 6f66 2074 6865 2045 to 461 of the E │ │ │ │ │ -00042530: 4649 2070 6172 7469 7469 6f6e 2c20 7768 FI partition, wh │ │ │ │ │ -00042540: 6572 6520 6d66 6f72 6d61 7420 6861 7320 ere mformat has │ │ │ │ │ -00042550: 7075 740a 6120 7061 7274 6974 696f 6e20 put.a partition │ │ │ │ │ -00042560: 7461 626c 6520 656e 7472 7920 7768 6963 table entry whic │ │ │ │ │ -00042570: 6820 636c 6169 6d73 2070 6172 7469 7469 h claims partiti │ │ │ │ │ -00042580: 6f6e 2073 7461 7274 2061 7420 626c 6f63 on start at bloc │ │ │ │ │ -00042590: 6b20 302e 2020 5468 6973 0a63 6861 6e67 k 0. This.chang │ │ │ │ │ -000425a0: 6520 7769 6c6c 206e 6f74 2068 616d 7065 e will not hampe │ │ │ │ │ -000425b0: 7220 626f 6f74 6162 696c 6974 7920 6f6e r bootability on │ │ │ │ │ -000425c0: 206f 7468 6572 206d 6163 6869 6e65 732e other machines. │ │ │ │ │ -000425d0: 0a0a 1f0a 4669 6c65 3a20 6772 7562 2e69 ....File: grub.i │ │ │ │ │ -000425e0: 6e66 6f2c 2020 4e6f 6465 3a20 496e 766f nfo, Node: Invo │ │ │ │ │ -000425f0: 6b69 6e67 2067 7275 622d 696e 7374 616c king grub-instal │ │ │ │ │ -00042600: 6c2c 2020 4e65 7874 3a20 496e 766f 6b69 l, Next: Invoki │ │ │ │ │ -00042610: 6e67 2067 7275 622d 6d6b 636f 6e66 6967 ng grub-mkconfig │ │ │ │ │ -00042620: 2c20 2050 7265 763a 2054 726f 7562 6c65 , Prev: Trouble │ │ │ │ │ -00042630: 7368 6f6f 7469 6e67 2c20 2055 703a 2054 shooting, Up: T │ │ │ │ │ -00042640: 6f70 0a0a 3233 2049 6e76 6f6b 696e 6720 op..23 Invoking │ │ │ │ │ -00042650: 6772 7562 2d69 6e73 7461 6c6c 0a2a 2a2a grub-install.*** │ │ │ │ │ +00042430: 3d3d 3d3d 3d3d 3d0a 0a54 6865 2045 4649 =======..The EFI │ │ │ │ │ +00042440: 2069 6d70 6c65 6d65 6e74 6174 696f 6e20 implementation │ │ │ │ │ +00042450: 6f66 2073 6f6d 6520 6f6c 6465 7220 4d61 of some older Ma │ │ │ │ │ +00042460: 6342 6f6f 6b20 6c61 7074 6f70 7320 7374 cBook laptops st │ │ │ │ │ +00042470: 616c 6c73 2077 6865 6e20 6974 2067 6574 alls when it get │ │ │ │ │ +00042480: 730a 7072 6573 656e 7465 6420 6120 6772 s.presented a gr │ │ │ │ │ +00042490: 7562 2d6d 6b72 6573 6375 6520 4953 4f20 ub-mkrescue ISO │ │ │ │ │ +000424a0: 696d 6167 6520 666f 7220 7838 365f 3634 image for x86_64 │ │ │ │ │ +000424b0: 2d65 6669 2074 6172 6765 7420 6f6e 2061 -efi target on a │ │ │ │ │ +000424c0: 6e20 5553 420a 7374 6963 6b2e 2020 4166 n USB.stick. Af │ │ │ │ │ +000424d0: 6665 6374 6564 2061 7265 206d 6f64 656c fected are model │ │ │ │ │ +000424e0: 7320 6f66 2079 6561 7220 3230 3130 206f s of year 2010 o │ │ │ │ │ +000424f0: 7220 6561 726c 6965 722e 2020 576f 726b r earlier. Work │ │ │ │ │ +00042500: 6172 6f75 6e64 2069 7320 746f 0a7a 6572 around is to.zer │ │ │ │ │ +00042510: 6f69 7a65 2074 6865 2062 7974 6573 2034 oize the bytes 4 │ │ │ │ │ +00042520: 3436 2074 6f20 3436 3120 6f66 2074 6865 46 to 461 of the │ │ │ │ │ +00042530: 2045 4649 2070 6172 7469 7469 6f6e 2c20 EFI partition, │ │ │ │ │ +00042540: 7768 6572 6520 6d66 6f72 6d61 7420 6861 where mformat ha │ │ │ │ │ +00042550: 7320 7075 740a 6120 7061 7274 6974 696f s put.a partitio │ │ │ │ │ +00042560: 6e20 7461 626c 6520 656e 7472 7920 7768 n table entry wh │ │ │ │ │ +00042570: 6963 6820 636c 6169 6d73 2070 6172 7469 ich claims parti │ │ │ │ │ +00042580: 7469 6f6e 2073 7461 7274 2061 7420 626c tion start at bl │ │ │ │ │ +00042590: 6f63 6b20 302e 2020 5468 6973 0a63 6861 ock 0. This.cha │ │ │ │ │ +000425a0: 6e67 6520 7769 6c6c 206e 6f74 2068 616d nge will not ham │ │ │ │ │ +000425b0: 7065 7220 626f 6f74 6162 696c 6974 7920 per bootability │ │ │ │ │ +000425c0: 6f6e 206f 7468 6572 206d 6163 6869 6e65 on other machine │ │ │ │ │ +000425d0: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ +000425e0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 496e .info, Node: In │ │ │ │ │ +000425f0: 766f 6b69 6e67 2067 7275 622d 696e 7374 voking grub-inst │ │ │ │ │ +00042600: 616c 6c2c 2020 4e65 7874 3a20 496e 766f all, Next: Invo │ │ │ │ │ +00042610: 6b69 6e67 2067 7275 622d 6d6b 636f 6e66 king grub-mkconf │ │ │ │ │ +00042620: 6967 2c20 2050 7265 763a 2054 726f 7562 ig, Prev: Troub │ │ │ │ │ +00042630: 6c65 7368 6f6f 7469 6e67 2c20 2055 703a leshooting, Up: │ │ │ │ │ +00042640: 2054 6f70 0a0a 3233 2049 6e76 6f6b 696e Top..23 Invokin │ │ │ │ │ +00042650: 6720 6772 7562 2d69 6e73 7461 6c6c 0a2a g grub-install.* │ │ │ │ │ 00042660: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00042670: 2a2a 2a2a 2a0a 0a54 6865 2070 726f 6772 *****..The progr │ │ │ │ │ -00042680: 616d 2027 6772 7562 2d69 6e73 7461 6c6c am 'grub-install │ │ │ │ │ -00042690: 2720 6765 6e65 7261 7465 7320 6120 4752 ' generates a GR │ │ │ │ │ -000426a0: 5542 2063 6f72 6520 696d 6167 6520 7573 UB core image us │ │ │ │ │ -000426b0: 696e 670a 2767 7275 622d 6d6b 696d 6167 ing.'grub-mkimag │ │ │ │ │ -000426c0: 6527 2061 6e64 2069 6e73 7461 6c6c 7320 e' and installs │ │ │ │ │ -000426d0: 6974 206f 6e20 796f 7572 2073 7973 7465 it on your syste │ │ │ │ │ -000426e0: 6d2e 2020 596f 7520 6d75 7374 2073 7065 m. You must spe │ │ │ │ │ -000426f0: 6369 6679 2074 6865 0a64 6576 6963 6520 cify the.device │ │ │ │ │ -00042700: 6e61 6d65 206f 6e20 7768 6963 6820 796f name on which yo │ │ │ │ │ -00042710: 7520 7761 6e74 2074 6f20 696e 7374 616c u want to instal │ │ │ │ │ -00042720: 6c20 4752 5542 2c20 6c69 6b65 2074 6869 l GRUB, like thi │ │ │ │ │ -00042730: 733a 0a0a 2020 2020 2067 7275 622d 696e s:.. grub-in │ │ │ │ │ -00042740: 7374 616c 6c20 494e 5354 414c 4c5f 4445 stall INSTALL_DE │ │ │ │ │ -00042750: 5649 4345 0a0a 2020 2054 6865 2064 6576 VICE.. The dev │ │ │ │ │ -00042760: 6963 6520 6e61 6d65 2049 4e53 5441 4c4c ice name INSTALL │ │ │ │ │ -00042770: 5f44 4556 4943 4520 6973 2061 6e20 4f53 _DEVICE is an OS │ │ │ │ │ -00042780: 2064 6576 6963 6520 6e61 6d65 206f 7220 device name or │ │ │ │ │ -00042790: 6120 4752 5542 2064 6576 6963 650a 6e61 a GRUB device.na │ │ │ │ │ -000427a0: 6d65 2e0a 0a20 2020 2767 7275 622d 696e me... 'grub-in │ │ │ │ │ -000427b0: 7374 616c 6c27 2061 6363 6570 7473 2074 stall' accepts t │ │ │ │ │ -000427c0: 6865 2066 6f6c 6c6f 7769 6e67 206f 7074 he following opt │ │ │ │ │ -000427d0: 696f 6e73 3a0a 0a27 2d2d 6865 6c70 270a ions:..'--help'. │ │ │ │ │ -000427e0: 2020 2020 2050 7269 6e74 2061 2073 756d Print a sum │ │ │ │ │ -000427f0: 6d61 7279 206f 6620 7468 6520 636f 6d6d mary of the comm │ │ │ │ │ -00042800: 616e 642d 6c69 6e65 206f 7074 696f 6e73 and-line options │ │ │ │ │ -00042810: 2061 6e64 2065 7869 742e 0a0a 272d 2d76 and exit...'--v │ │ │ │ │ -00042820: 6572 7369 6f6e 270a 2020 2020 2050 7269 ersion'. Pri │ │ │ │ │ -00042830: 6e74 2074 6865 2076 6572 7369 6f6e 206e nt the version n │ │ │ │ │ -00042840: 756d 6265 7220 6f66 2047 5255 4220 616e umber of GRUB an │ │ │ │ │ -00042850: 6420 6578 6974 2e0a 0a27 2d2d 626f 6f74 d exit...'--boot │ │ │ │ │ -00042860: 2d64 6972 6563 746f 7279 3d44 4952 270a -directory=DIR'. │ │ │ │ │ -00042870: 2020 2020 2049 6e73 7461 6c6c 2047 5255 Install GRU │ │ │ │ │ -00042880: 4220 696d 6167 6573 2075 6e64 6572 2074 B images under t │ │ │ │ │ -00042890: 6865 2064 6972 6563 746f 7279 2027 4449 he directory 'DI │ │ │ │ │ -000428a0: 522f 6772 7562 2f27 2054 6869 7320 6f70 R/grub/' This op │ │ │ │ │ -000428b0: 7469 6f6e 2069 730a 2020 2020 2075 7365 tion is. use │ │ │ │ │ -000428c0: 6675 6c20 7768 656e 2079 6f75 2077 616e ful when you wan │ │ │ │ │ -000428d0: 7420 746f 2069 6e73 7461 6c6c 2047 5255 t to install GRU │ │ │ │ │ -000428e0: 4220 696e 746f 2061 2073 6570 6172 6174 B into a separat │ │ │ │ │ -000428f0: 6520 7061 7274 6974 696f 6e20 6f72 2061 e partition or a │ │ │ │ │ -00042900: 0a20 2020 2020 7265 6d6f 7661 626c 6520 . removable │ │ │ │ │ -00042910: 6469 736b 2e20 2049 6620 7468 6973 206f disk. If this o │ │ │ │ │ -00042920: 7074 696f 6e20 6973 206e 6f74 2073 7065 ption is not spe │ │ │ │ │ -00042930: 6369 6669 6564 2074 6865 6e20 6974 2064 cified then it d │ │ │ │ │ -00042940: 6566 6175 6c74 730a 2020 2020 2074 6f20 efaults. to │ │ │ │ │ -00042950: 272f 626f 6f74 272c 2073 6f0a 0a20 2020 '/boot', so.. │ │ │ │ │ -00042960: 2020 2020 2020 2067 7275 622d 696e 7374 grub-inst │ │ │ │ │ -00042970: 616c 6c20 2f64 6576 2f73 6461 0a0a 2020 all /dev/sda.. │ │ │ │ │ -00042980: 2020 2069 7320 6571 7569 7661 6c65 6e74 is equivalent │ │ │ │ │ -00042990: 2074 6f0a 0a20 2020 2020 2020 2020 2067 to.. g │ │ │ │ │ -000429a0: 7275 622d 696e 7374 616c 6c20 2d2d 626f rub-install --bo │ │ │ │ │ -000429b0: 6f74 2d64 6972 6563 746f 7279 3d2f 626f ot-directory=/bo │ │ │ │ │ -000429c0: 6f74 2f20 2f64 6576 2f73 6461 0a0a 2020 ot/ /dev/sda.. │ │ │ │ │ -000429d0: 2020 2048 6572 6520 6973 2061 6e20 6578 Here is an ex │ │ │ │ │ -000429e0: 616d 706c 6520 696e 2077 6869 6368 2079 ample in which y │ │ │ │ │ -000429f0: 6f75 2068 6176 6520 6120 7365 7061 7261 ou have a separa │ │ │ │ │ -00042a00: 7465 2022 626f 6f74 2220 7061 7274 6974 te "boot" partit │ │ │ │ │ -00042a10: 696f 6e0a 2020 2020 2077 6869 6368 2069 ion. which i │ │ │ │ │ -00042a20: 7320 6d6f 756e 7465 6420 6f6e 2027 2f6d s mounted on '/m │ │ │ │ │ -00042a30: 6e74 2f62 6f6f 7427 3a0a 0a20 2020 2020 nt/boot':.. │ │ │ │ │ -00042a40: 2020 2020 2067 7275 622d 696e 7374 616c grub-instal │ │ │ │ │ -00042a50: 6c20 2d2d 626f 6f74 2d64 6972 6563 746f l --boot-directo │ │ │ │ │ -00042a60: 7279 3d2f 6d6e 742f 626f 6f74 202f 6465 ry=/mnt/boot /de │ │ │ │ │ -00042a70: 762f 7364 620a 0a27 2d2d 7265 6368 6563 v/sdb..'--rechec │ │ │ │ │ -00042a80: 6b27 0a20 2020 2020 5265 6368 6563 6b20 k'. Recheck │ │ │ │ │ -00042a90: 7468 6520 6465 7669 6365 206d 6170 2c20 the device map, │ │ │ │ │ -00042aa0: 6576 656e 2069 6620 272f 626f 6f74 2f67 even if '/boot/g │ │ │ │ │ -00042ab0: 7275 622f 6465 7669 6365 2e6d 6170 2720 rub/device.map' │ │ │ │ │ -00042ac0: 616c 7265 6164 790a 2020 2020 2065 7869 already. exi │ │ │ │ │ -00042ad0: 7374 732e 2020 596f 7520 7368 6f75 6c64 sts. You should │ │ │ │ │ -00042ae0: 2075 7365 2074 6869 7320 6f70 7469 6f6e use this option │ │ │ │ │ -00042af0: 2077 6865 6e65 7665 7220 796f 7520 6164 whenever you ad │ │ │ │ │ -00042b00: 642f 7265 6d6f 7665 2061 2064 6973 6b0a d/remove a disk. │ │ │ │ │ -00042b10: 2020 2020 2069 6e74 6f2f 6672 6f6d 2079 into/from y │ │ │ │ │ -00042b20: 6f75 7220 636f 6d70 7574 6572 2e0a 0a27 our computer...' │ │ │ │ │ -00042b30: 2d2d 6e6f 2d72 732d 636f 6465 7327 0a20 --no-rs-codes'. │ │ │ │ │ -00042b40: 2020 2020 4279 2064 6566 6175 6c74 206f By default o │ │ │ │ │ -00042b50: 6e20 7838 3620 4249 4f53 2073 7973 7465 n x86 BIOS syste │ │ │ │ │ -00042b60: 6d73 2c20 2767 7275 622d 696e 7374 616c ms, 'grub-instal │ │ │ │ │ -00042b70: 6c27 2077 696c 6c20 7573 6520 736f 6d65 l' will use some │ │ │ │ │ -00042b80: 2065 7874 7261 0a20 2020 2020 7370 6163 extra. spac │ │ │ │ │ -00042b90: 6520 696e 2074 6865 2062 6f6f 746c 6f61 e in the bootloa │ │ │ │ │ -00042ba0: 6465 7220 656d 6265 6464 696e 6720 6172 der embedding ar │ │ │ │ │ -00042bb0: 6561 2066 6f72 2052 6565 642d 536f 6c6f ea for Reed-Solo │ │ │ │ │ -00042bc0: 6d6f 6e0a 2020 2020 2065 7272 6f72 2d63 mon. error-c │ │ │ │ │ -00042bd0: 6f72 7265 6374 696e 6720 636f 6465 732e orrecting codes. │ │ │ │ │ -00042be0: 2020 5468 6973 2065 6e61 626c 6573 2047 This enables G │ │ │ │ │ -00042bf0: 5255 4220 746f 2073 7469 6c6c 2062 6f6f RUB to still boo │ │ │ │ │ -00042c00: 740a 2020 2020 2073 7563 6365 7373 6675 t. successfu │ │ │ │ │ -00042c10: 6c6c 7920 6966 2073 6f6d 6520 626c 6f63 lly if some bloc │ │ │ │ │ -00042c20: 6b73 2061 7265 2063 6f72 7275 7074 6564 ks are corrupted │ │ │ │ │ -00042c30: 2e20 2054 6865 2065 7861 6374 2061 6d6f . The exact amo │ │ │ │ │ -00042c40: 756e 7420 6f66 0a20 2020 2020 7072 6f74 unt of. prot │ │ │ │ │ -00042c50: 6563 7469 6f6e 206f 6666 6572 6564 2069 ection offered i │ │ │ │ │ -00042c60: 7320 6465 7065 6e64 656e 7420 6f6e 2061 s dependent on a │ │ │ │ │ -00042c70: 7661 696c 6162 6c65 2073 7061 6365 2069 vailable space i │ │ │ │ │ -00042c80: 6e20 7468 6520 656d 6265 6464 696e 670a n the embedding. │ │ │ │ │ -00042c90: 2020 2020 2061 7265 612e 2020 5220 7365 area. R se │ │ │ │ │ -00042ca0: 6374 6f72 7320 6f66 2072 6564 756e 6461 ctors of redunda │ │ │ │ │ -00042cb0: 6e63 7920 6361 6e20 746f 6c65 7261 7465 ncy can tolerate │ │ │ │ │ -00042cc0: 2075 7020 746f 2052 2f32 2063 6f72 7275 up to R/2 corru │ │ │ │ │ -00042cd0: 7074 6564 0a20 2020 2020 7365 6374 6f72 pted. sector │ │ │ │ │ -00042ce0: 732e 2020 5468 6973 2072 6564 756e 6461 s. This redunda │ │ │ │ │ -00042cf0: 6e63 7920 6d61 7920 6265 2063 756d 6265 ncy may be cumbe │ │ │ │ │ -00042d00: 7273 6f6d 6520 6966 2061 7474 656d 7074 rsome if attempt │ │ │ │ │ -00042d10: 696e 6720 746f 0a20 2020 2020 6372 7970 ing to. cryp │ │ │ │ │ -00042d20: 746f 6772 6170 6869 6361 6c6c 7920 7661 tographically va │ │ │ │ │ -00042d30: 6c69 6461 7465 2074 6865 2063 6f6e 7465 lidate the conte │ │ │ │ │ -00042d40: 6e74 7320 6f66 2074 6865 2062 6f6f 746c nts of the bootl │ │ │ │ │ -00042d50: 6f61 6465 7220 656d 6265 6464 696e 670a oader embedding. │ │ │ │ │ -00042d60: 2020 2020 2061 7265 612c 206f 7220 696e area, or in │ │ │ │ │ -00042d70: 206d 6f72 6520 6d6f 6465 726e 2073 7973 more modern sys │ │ │ │ │ -00042d80: 7465 6d73 2077 6974 6820 4750 542d 7374 tems with GPT-st │ │ │ │ │ -00042d90: 796c 6520 7061 7274 6974 696f 6e20 7461 yle partition ta │ │ │ │ │ -00042da0: 626c 6573 0a20 2020 2020 282a 6e6f 7465 bles. (*note │ │ │ │ │ -00042db0: 2042 494f 5320 696e 7374 616c 6c61 7469 BIOS installati │ │ │ │ │ -00042dc0: 6f6e 3a3a 2920 7768 6572 6520 4752 5542 on::) where GRUB │ │ │ │ │ -00042dd0: 2064 6f65 7320 6e6f 7420 7265 7369 6465 does not reside │ │ │ │ │ -00042de0: 2069 6e20 616e 790a 2020 2020 2075 6e70 in any. unp │ │ │ │ │ -00042df0: 6172 7469 7469 6f6e 6564 2073 7061 6365 artitioned space │ │ │ │ │ -00042e00: 206f 7574 7369 6465 206f 6620 7468 6520 outside of the │ │ │ │ │ -00042e10: 4d42 522e 2044 6973 6162 6c65 2074 6865 MBR. Disable the │ │ │ │ │ -00042e20: 2052 6565 642d 536f 6c6f 6d6f 6e0a 2020 Reed-Solomon. │ │ │ │ │ -00042e30: 2020 2063 6f64 6573 2077 6974 6820 7468 codes with th │ │ │ │ │ -00042e40: 6973 206f 7074 696f 6e2e 0a0a 1f0a 4669 is option.....Fi │ │ │ │ │ -00042e50: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00042e60: 4e6f 6465 3a20 496e 766f 6b69 6e67 2067 Node: Invoking g │ │ │ │ │ -00042e70: 7275 622d 6d6b 636f 6e66 6967 2c20 204e rub-mkconfig, N │ │ │ │ │ -00042e80: 6578 743a 2049 6e76 6f6b 696e 6720 6772 ext: Invoking gr │ │ │ │ │ -00042e90: 7562 2d6d 6b70 6173 7377 642d 7062 6b64 ub-mkpasswd-pbkd │ │ │ │ │ -00042ea0: 6632 2c20 2050 7265 763a 2049 6e76 6f6b f2, Prev: Invok │ │ │ │ │ -00042eb0: 696e 6720 6772 7562 2d69 6e73 7461 6c6c ing grub-install │ │ │ │ │ -00042ec0: 2c20 2055 703a 2054 6f70 0a0a 3234 2049 , Up: Top..24 I │ │ │ │ │ -00042ed0: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b63 nvoking grub-mkc │ │ │ │ │ -00042ee0: 6f6e 6669 670a 2a2a 2a2a 2a2a 2a2a 2a2a onfig.********** │ │ │ │ │ -00042ef0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a0a ***************. │ │ │ │ │ -00042f00: 0a54 6865 2070 726f 6772 616d 2027 6772 .The program 'gr │ │ │ │ │ -00042f10: 7562 2d6d 6b63 6f6e 6669 6727 2067 656e ub-mkconfig' gen │ │ │ │ │ -00042f20: 6572 6174 6573 2061 2063 6f6e 6669 6775 erates a configu │ │ │ │ │ -00042f30: 7261 7469 6f6e 2066 696c 6520 666f 7220 ration file for │ │ │ │ │ -00042f40: 4752 5542 0a28 2a6e 6f74 6520 5369 6d70 GRUB.(*note Simp │ │ │ │ │ -00042f50: 6c65 2063 6f6e 6669 6775 7261 7469 6f6e le configuration │ │ │ │ │ -00042f60: 3a3a 292e 0a0a 2020 2020 2067 7275 622d ::)... grub- │ │ │ │ │ -00042f70: 6d6b 636f 6e66 6967 202d 6f20 2f62 6f6f mkconfig -o /boo │ │ │ │ │ -00042f80: 742f 6772 7562 2f67 7275 622e 6366 670a t/grub/grub.cfg. │ │ │ │ │ -00042f90: 0a20 2020 2767 7275 622d 6d6b 636f 6e66 . 'grub-mkconf │ │ │ │ │ -00042fa0: 6967 2720 6163 6365 7074 7320 7468 6520 ig' accepts the │ │ │ │ │ -00042fb0: 666f 6c6c 6f77 696e 6720 6f70 7469 6f6e following option │ │ │ │ │ -00042fc0: 733a 0a0a 272d 2d68 656c 7027 0a20 2020 s:..'--help'. │ │ │ │ │ -00042fd0: 2020 5072 696e 7420 6120 7375 6d6d 6172 Print a summar │ │ │ │ │ -00042fe0: 7920 6f66 2074 6865 2063 6f6d 6d61 6e64 y of the command │ │ │ │ │ -00042ff0: 2d6c 696e 6520 6f70 7469 6f6e 7320 616e -line options an │ │ │ │ │ -00043000: 6420 6578 6974 2e0a 0a27 2d2d 7665 7273 d exit...'--vers │ │ │ │ │ -00043010: 696f 6e27 0a20 2020 2020 5072 696e 7420 ion'. Print │ │ │ │ │ -00043020: 7468 6520 7665 7273 696f 6e20 6e75 6d62 the version numb │ │ │ │ │ -00043030: 6572 206f 6620 4752 5542 2061 6e64 2065 er of GRUB and e │ │ │ │ │ -00043040: 7869 742e 0a0a 272d 6f20 4649 4c45 270a xit...'-o FILE'. │ │ │ │ │ -00043050: 272d 2d6f 7574 7075 743d 4649 4c45 270a '--output=FILE'. │ │ │ │ │ -00043060: 2020 2020 2053 656e 6420 7468 6520 6765 Send the ge │ │ │ │ │ -00043070: 6e65 7261 7465 6420 636f 6e66 6967 7572 nerated configur │ │ │ │ │ -00043080: 6174 696f 6e20 6669 6c65 2074 6f20 4649 ation file to FI │ │ │ │ │ -00043090: 4c45 2e20 2054 6865 2064 6566 6175 6c74 LE. The default │ │ │ │ │ -000430a0: 2069 7320 746f 0a20 2020 2020 7365 6e64 is to. send │ │ │ │ │ -000430b0: 2069 7420 746f 2073 7461 6e64 6172 6420 it to standard │ │ │ │ │ -000430c0: 6f75 7470 7574 2e0a 0a1f 0a46 696c 653a output.....File: │ │ │ │ │ -000430d0: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -000430e0: 653a 2049 6e76 6f6b 696e 6720 6772 7562 e: Invoking grub │ │ │ │ │ -000430f0: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ │ -00043100: 2c20 204e 6578 743a 2049 6e76 6f6b 696e , Next: Invokin │ │ │ │ │ -00043110: 6720 6772 7562 2d6d 6b72 656c 7061 7468 g grub-mkrelpath │ │ │ │ │ -00043120: 2c20 2050 7265 763a 2049 6e76 6f6b 696e , Prev: Invokin │ │ │ │ │ -00043130: 6720 6772 7562 2d6d 6b63 6f6e 6669 672c g grub-mkconfig, │ │ │ │ │ -00043140: 2020 5570 3a20 546f 700a 0a32 3520 496e Up: Top..25 In │ │ │ │ │ -00043150: 766f 6b69 6e67 2067 7275 622d 6d6b 7061 voking grub-mkpa │ │ │ │ │ -00043160: 7373 7764 2d70 626b 6466 320a 2a2a 2a2a sswd-pbkdf2.**** │ │ │ │ │ +00042670: 2a2a 2a2a 2a2a 2a0a 0a54 6865 2070 726f *******..The pro │ │ │ │ │ +00042680: 6772 616d 2027 6772 7562 2d69 6e73 7461 gram 'grub-insta │ │ │ │ │ +00042690: 6c6c 2720 6765 6e65 7261 7465 7320 6120 ll' generates a │ │ │ │ │ +000426a0: 4752 5542 2063 6f72 6520 696d 6167 6520 GRUB core image │ │ │ │ │ +000426b0: 7573 696e 670a 2767 7275 622d 6d6b 696d using.'grub-mkim │ │ │ │ │ +000426c0: 6167 6527 2061 6e64 2069 6e73 7461 6c6c age' and install │ │ │ │ │ +000426d0: 7320 6974 206f 6e20 796f 7572 2073 7973 s it on your sys │ │ │ │ │ +000426e0: 7465 6d2e 2020 596f 7520 6d75 7374 2073 tem. You must s │ │ │ │ │ +000426f0: 7065 6369 6679 2074 6865 0a64 6576 6963 pecify the.devic │ │ │ │ │ +00042700: 6520 6e61 6d65 206f 6e20 7768 6963 6820 e name on which │ │ │ │ │ +00042710: 796f 7520 7761 6e74 2074 6f20 696e 7374 you want to inst │ │ │ │ │ +00042720: 616c 6c20 4752 5542 2c20 6c69 6b65 2074 all GRUB, like t │ │ │ │ │ +00042730: 6869 733a 0a0a 2020 2020 2067 7275 622d his:.. grub- │ │ │ │ │ +00042740: 696e 7374 616c 6c20 494e 5354 414c 4c5f install INSTALL_ │ │ │ │ │ +00042750: 4445 5649 4345 0a0a 2020 2054 6865 2064 DEVICE.. The d │ │ │ │ │ +00042760: 6576 6963 6520 6e61 6d65 2049 4e53 5441 evice name INSTA │ │ │ │ │ +00042770: 4c4c 5f44 4556 4943 4520 6973 2061 6e20 LL_DEVICE is an │ │ │ │ │ +00042780: 4f53 2064 6576 6963 6520 6e61 6d65 206f OS device name o │ │ │ │ │ +00042790: 7220 6120 4752 5542 2064 6576 6963 650a r a GRUB device. │ │ │ │ │ +000427a0: 6e61 6d65 2e0a 0a20 2020 2767 7275 622d name... 'grub- │ │ │ │ │ +000427b0: 696e 7374 616c 6c27 2061 6363 6570 7473 install' accepts │ │ │ │ │ +000427c0: 2074 6865 2066 6f6c 6c6f 7769 6e67 206f the following o │ │ │ │ │ +000427d0: 7074 696f 6e73 3a0a 0a27 2d2d 6865 6c70 ptions:..'--help │ │ │ │ │ +000427e0: 270a 2020 2020 2050 7269 6e74 2061 2073 '. Print a s │ │ │ │ │ +000427f0: 756d 6d61 7279 206f 6620 7468 6520 636f ummary of the co │ │ │ │ │ +00042800: 6d6d 616e 642d 6c69 6e65 206f 7074 696f mmand-line optio │ │ │ │ │ +00042810: 6e73 2061 6e64 2065 7869 742e 0a0a 272d ns and exit...'- │ │ │ │ │ +00042820: 2d76 6572 7369 6f6e 270a 2020 2020 2050 -version'. P │ │ │ │ │ +00042830: 7269 6e74 2074 6865 2076 6572 7369 6f6e rint the version │ │ │ │ │ +00042840: 206e 756d 6265 7220 6f66 2047 5255 4220 number of GRUB │ │ │ │ │ +00042850: 616e 6420 6578 6974 2e0a 0a27 2d2d 626f and exit...'--bo │ │ │ │ │ +00042860: 6f74 2d64 6972 6563 746f 7279 3d44 4952 ot-directory=DIR │ │ │ │ │ +00042870: 270a 2020 2020 2049 6e73 7461 6c6c 2047 '. Install G │ │ │ │ │ +00042880: 5255 4220 696d 6167 6573 2075 6e64 6572 RUB images under │ │ │ │ │ +00042890: 2074 6865 2064 6972 6563 746f 7279 2027 the directory ' │ │ │ │ │ +000428a0: 4449 522f 6772 7562 2f27 2054 6869 7320 DIR/grub/' This │ │ │ │ │ +000428b0: 6f70 7469 6f6e 2069 730a 2020 2020 2075 option is. u │ │ │ │ │ +000428c0: 7365 6675 6c20 7768 656e 2079 6f75 2077 seful when you w │ │ │ │ │ +000428d0: 616e 7420 746f 2069 6e73 7461 6c6c 2047 ant to install G │ │ │ │ │ +000428e0: 5255 4220 696e 746f 2061 2073 6570 6172 RUB into a separ │ │ │ │ │ +000428f0: 6174 6520 7061 7274 6974 696f 6e20 6f72 ate partition or │ │ │ │ │ +00042900: 2061 0a20 2020 2020 7265 6d6f 7661 626c a. removabl │ │ │ │ │ +00042910: 6520 6469 736b 2e20 2049 6620 7468 6973 e disk. If this │ │ │ │ │ +00042920: 206f 7074 696f 6e20 6973 206e 6f74 2073 option is not s │ │ │ │ │ +00042930: 7065 6369 6669 6564 2074 6865 6e20 6974 pecified then it │ │ │ │ │ +00042940: 2064 6566 6175 6c74 730a 2020 2020 2074 defaults. t │ │ │ │ │ +00042950: 6f20 272f 626f 6f74 272c 2073 6f0a 0a20 o '/boot', so.. │ │ │ │ │ +00042960: 2020 2020 2020 2020 2067 7275 622d 696e grub-in │ │ │ │ │ +00042970: 7374 616c 6c20 2f64 6576 2f73 6461 0a0a stall /dev/sda.. │ │ │ │ │ +00042980: 2020 2020 2069 7320 6571 7569 7661 6c65 is equivale │ │ │ │ │ +00042990: 6e74 2074 6f0a 0a20 2020 2020 2020 2020 nt to.. │ │ │ │ │ +000429a0: 2067 7275 622d 696e 7374 616c 6c20 2d2d grub-install -- │ │ │ │ │ +000429b0: 626f 6f74 2d64 6972 6563 746f 7279 3d2f boot-directory=/ │ │ │ │ │ +000429c0: 626f 6f74 2f20 2f64 6576 2f73 6461 0a0a boot/ /dev/sda.. │ │ │ │ │ +000429d0: 2020 2020 2048 6572 6520 6973 2061 6e20 Here is an │ │ │ │ │ +000429e0: 6578 616d 706c 6520 696e 2077 6869 6368 example in which │ │ │ │ │ +000429f0: 2079 6f75 2068 6176 6520 6120 7365 7061 you have a sepa │ │ │ │ │ +00042a00: 7261 7465 2022 626f 6f74 2220 7061 7274 rate "boot" part │ │ │ │ │ +00042a10: 6974 696f 6e0a 2020 2020 2077 6869 6368 ition. which │ │ │ │ │ +00042a20: 2069 7320 6d6f 756e 7465 6420 6f6e 2027 is mounted on ' │ │ │ │ │ +00042a30: 2f6d 6e74 2f62 6f6f 7427 3a0a 0a20 2020 /mnt/boot':.. │ │ │ │ │ +00042a40: 2020 2020 2020 2067 7275 622d 696e 7374 grub-inst │ │ │ │ │ +00042a50: 616c 6c20 2d2d 626f 6f74 2d64 6972 6563 all --boot-direc │ │ │ │ │ +00042a60: 746f 7279 3d2f 6d6e 742f 626f 6f74 202f tory=/mnt/boot / │ │ │ │ │ +00042a70: 6465 762f 7364 620a 0a27 2d2d 7265 6368 dev/sdb..'--rech │ │ │ │ │ +00042a80: 6563 6b27 0a20 2020 2020 5265 6368 6563 eck'. Rechec │ │ │ │ │ +00042a90: 6b20 7468 6520 6465 7669 6365 206d 6170 k the device map │ │ │ │ │ +00042aa0: 2c20 6576 656e 2069 6620 272f 626f 6f74 , even if '/boot │ │ │ │ │ +00042ab0: 2f67 7275 622f 6465 7669 6365 2e6d 6170 /grub/device.map │ │ │ │ │ +00042ac0: 2720 616c 7265 6164 790a 2020 2020 2065 ' already. e │ │ │ │ │ +00042ad0: 7869 7374 732e 2020 596f 7520 7368 6f75 xists. You shou │ │ │ │ │ +00042ae0: 6c64 2075 7365 2074 6869 7320 6f70 7469 ld use this opti │ │ │ │ │ +00042af0: 6f6e 2077 6865 6e65 7665 7220 796f 7520 on whenever you │ │ │ │ │ +00042b00: 6164 642f 7265 6d6f 7665 2061 2064 6973 add/remove a dis │ │ │ │ │ +00042b10: 6b0a 2020 2020 2069 6e74 6f2f 6672 6f6d k. into/from │ │ │ │ │ +00042b20: 2079 6f75 7220 636f 6d70 7574 6572 2e0a your computer.. │ │ │ │ │ +00042b30: 0a27 2d2d 6e6f 2d72 732d 636f 6465 7327 .'--no-rs-codes' │ │ │ │ │ +00042b40: 0a20 2020 2020 4279 2064 6566 6175 6c74 . By default │ │ │ │ │ +00042b50: 206f 6e20 7838 3620 4249 4f53 2073 7973 on x86 BIOS sys │ │ │ │ │ +00042b60: 7465 6d73 2c20 2767 7275 622d 696e 7374 tems, 'grub-inst │ │ │ │ │ +00042b70: 616c 6c27 2077 696c 6c20 7573 6520 736f all' will use so │ │ │ │ │ +00042b80: 6d65 2065 7874 7261 0a20 2020 2020 7370 me extra. sp │ │ │ │ │ +00042b90: 6163 6520 696e 2074 6865 2062 6f6f 746c ace in the bootl │ │ │ │ │ +00042ba0: 6f61 6465 7220 656d 6265 6464 696e 6720 oader embedding │ │ │ │ │ +00042bb0: 6172 6561 2066 6f72 2052 6565 642d 536f area for Reed-So │ │ │ │ │ +00042bc0: 6c6f 6d6f 6e0a 2020 2020 2065 7272 6f72 lomon. error │ │ │ │ │ +00042bd0: 2d63 6f72 7265 6374 696e 6720 636f 6465 -correcting code │ │ │ │ │ +00042be0: 732e 2020 5468 6973 2065 6e61 626c 6573 s. This enables │ │ │ │ │ +00042bf0: 2047 5255 4220 746f 2073 7469 6c6c 2062 GRUB to still b │ │ │ │ │ +00042c00: 6f6f 740a 2020 2020 2073 7563 6365 7373 oot. success │ │ │ │ │ +00042c10: 6675 6c6c 7920 6966 2073 6f6d 6520 626c fully if some bl │ │ │ │ │ +00042c20: 6f63 6b73 2061 7265 2063 6f72 7275 7074 ocks are corrupt │ │ │ │ │ +00042c30: 6564 2e20 2054 6865 2065 7861 6374 2061 ed. The exact a │ │ │ │ │ +00042c40: 6d6f 756e 7420 6f66 0a20 2020 2020 7072 mount of. pr │ │ │ │ │ +00042c50: 6f74 6563 7469 6f6e 206f 6666 6572 6564 otection offered │ │ │ │ │ +00042c60: 2069 7320 6465 7065 6e64 656e 7420 6f6e is dependent on │ │ │ │ │ +00042c70: 2061 7661 696c 6162 6c65 2073 7061 6365 available space │ │ │ │ │ +00042c80: 2069 6e20 7468 6520 656d 6265 6464 696e in the embeddin │ │ │ │ │ +00042c90: 670a 2020 2020 2061 7265 612e 2020 5220 g. area. R │ │ │ │ │ +00042ca0: 7365 6374 6f72 7320 6f66 2072 6564 756e sectors of redun │ │ │ │ │ +00042cb0: 6461 6e63 7920 6361 6e20 746f 6c65 7261 dancy can tolera │ │ │ │ │ +00042cc0: 7465 2075 7020 746f 2052 2f32 2063 6f72 te up to R/2 cor │ │ │ │ │ +00042cd0: 7275 7074 6564 0a20 2020 2020 7365 6374 rupted. sect │ │ │ │ │ +00042ce0: 6f72 732e 2020 5468 6973 2072 6564 756e ors. This redun │ │ │ │ │ +00042cf0: 6461 6e63 7920 6d61 7920 6265 2063 756d dancy may be cum │ │ │ │ │ +00042d00: 6265 7273 6f6d 6520 6966 2061 7474 656d bersome if attem │ │ │ │ │ +00042d10: 7074 696e 6720 746f 0a20 2020 2020 6372 pting to. cr │ │ │ │ │ +00042d20: 7970 746f 6772 6170 6869 6361 6c6c 7920 yptographically │ │ │ │ │ +00042d30: 7661 6c69 6461 7465 2074 6865 2063 6f6e validate the con │ │ │ │ │ +00042d40: 7465 6e74 7320 6f66 2074 6865 2062 6f6f tents of the boo │ │ │ │ │ +00042d50: 746c 6f61 6465 7220 656d 6265 6464 696e tloader embeddin │ │ │ │ │ +00042d60: 670a 2020 2020 2061 7265 612c 206f 7220 g. area, or │ │ │ │ │ +00042d70: 696e 206d 6f72 6520 6d6f 6465 726e 2073 in more modern s │ │ │ │ │ +00042d80: 7973 7465 6d73 2077 6974 6820 4750 542d ystems with GPT- │ │ │ │ │ +00042d90: 7374 796c 6520 7061 7274 6974 696f 6e20 style partition │ │ │ │ │ +00042da0: 7461 626c 6573 0a20 2020 2020 282a 6e6f tables. (*no │ │ │ │ │ +00042db0: 7465 2042 494f 5320 696e 7374 616c 6c61 te BIOS installa │ │ │ │ │ +00042dc0: 7469 6f6e 3a3a 2920 7768 6572 6520 4752 tion::) where GR │ │ │ │ │ +00042dd0: 5542 2064 6f65 7320 6e6f 7420 7265 7369 UB does not resi │ │ │ │ │ +00042de0: 6465 2069 6e20 616e 790a 2020 2020 2075 de in any. u │ │ │ │ │ +00042df0: 6e70 6172 7469 7469 6f6e 6564 2073 7061 npartitioned spa │ │ │ │ │ +00042e00: 6365 206f 7574 7369 6465 206f 6620 7468 ce outside of th │ │ │ │ │ +00042e10: 6520 4d42 522e 2044 6973 6162 6c65 2074 e MBR. Disable t │ │ │ │ │ +00042e20: 6865 2052 6565 642d 536f 6c6f 6d6f 6e0a he Reed-Solomon. │ │ │ │ │ +00042e30: 2020 2020 2063 6f64 6573 2077 6974 6820 codes with │ │ │ │ │ +00042e40: 7468 6973 206f 7074 696f 6e2e 0a0a 1f0a this option..... │ │ │ │ │ +00042e50: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00042e60: 2020 4e6f 6465 3a20 496e 766f 6b69 6e67 Node: Invoking │ │ │ │ │ +00042e70: 2067 7275 622d 6d6b 636f 6e66 6967 2c20 grub-mkconfig, │ │ │ │ │ +00042e80: 204e 6578 743a 2049 6e76 6f6b 696e 6720 Next: Invoking │ │ │ │ │ +00042e90: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ +00042ea0: 6b64 6632 2c20 2050 7265 763a 2049 6e76 kdf2, Prev: Inv │ │ │ │ │ +00042eb0: 6f6b 696e 6720 6772 7562 2d69 6e73 7461 oking grub-insta │ │ │ │ │ +00042ec0: 6c6c 2c20 2055 703a 2054 6f70 0a0a 3234 ll, Up: Top..24 │ │ │ │ │ +00042ed0: 2049 6e76 6f6b 696e 6720 6772 7562 2d6d Invoking grub-m │ │ │ │ │ +00042ee0: 6b63 6f6e 6669 670a 2a2a 2a2a 2a2a 2a2a kconfig.******** │ │ │ │ │ +00042ef0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +00042f00: 2a0a 0a54 6865 2070 726f 6772 616d 2027 *..The program ' │ │ │ │ │ +00042f10: 6772 7562 2d6d 6b63 6f6e 6669 6727 2067 grub-mkconfig' g │ │ │ │ │ +00042f20: 656e 6572 6174 6573 2061 2063 6f6e 6669 enerates a confi │ │ │ │ │ +00042f30: 6775 7261 7469 6f6e 2066 696c 6520 666f guration file fo │ │ │ │ │ +00042f40: 7220 4752 5542 0a28 2a6e 6f74 6520 5369 r GRUB.(*note Si │ │ │ │ │ +00042f50: 6d70 6c65 2063 6f6e 6669 6775 7261 7469 mple configurati │ │ │ │ │ +00042f60: 6f6e 3a3a 292e 0a0a 2020 2020 2067 7275 on::)... gru │ │ │ │ │ +00042f70: 622d 6d6b 636f 6e66 6967 202d 6f20 2f62 b-mkconfig -o /b │ │ │ │ │ +00042f80: 6f6f 742f 6772 7562 2f67 7275 622e 6366 oot/grub/grub.cf │ │ │ │ │ +00042f90: 670a 0a20 2020 2767 7275 622d 6d6b 636f g.. 'grub-mkco │ │ │ │ │ +00042fa0: 6e66 6967 2720 6163 6365 7074 7320 7468 nfig' accepts th │ │ │ │ │ +00042fb0: 6520 666f 6c6c 6f77 696e 6720 6f70 7469 e following opti │ │ │ │ │ +00042fc0: 6f6e 733a 0a0a 272d 2d68 656c 7027 0a20 ons:..'--help'. │ │ │ │ │ +00042fd0: 2020 2020 5072 696e 7420 6120 7375 6d6d Print a summ │ │ │ │ │ +00042fe0: 6172 7920 6f66 2074 6865 2063 6f6d 6d61 ary of the comma │ │ │ │ │ +00042ff0: 6e64 2d6c 696e 6520 6f70 7469 6f6e 7320 nd-line options │ │ │ │ │ +00043000: 616e 6420 6578 6974 2e0a 0a27 2d2d 7665 and exit...'--ve │ │ │ │ │ +00043010: 7273 696f 6e27 0a20 2020 2020 5072 696e rsion'. Prin │ │ │ │ │ +00043020: 7420 7468 6520 7665 7273 696f 6e20 6e75 t the version nu │ │ │ │ │ +00043030: 6d62 6572 206f 6620 4752 5542 2061 6e64 mber of GRUB and │ │ │ │ │ +00043040: 2065 7869 742e 0a0a 272d 6f20 4649 4c45 exit...'-o FILE │ │ │ │ │ +00043050: 270a 272d 2d6f 7574 7075 743d 4649 4c45 '.'--output=FILE │ │ │ │ │ +00043060: 270a 2020 2020 2053 656e 6420 7468 6520 '. Send the │ │ │ │ │ +00043070: 6765 6e65 7261 7465 6420 636f 6e66 6967 generated config │ │ │ │ │ +00043080: 7572 6174 696f 6e20 6669 6c65 2074 6f20 uration file to │ │ │ │ │ +00043090: 4649 4c45 2e20 2054 6865 2064 6566 6175 FILE. The defau │ │ │ │ │ +000430a0: 6c74 2069 7320 746f 0a20 2020 2020 7365 lt is to. se │ │ │ │ │ +000430b0: 6e64 2069 7420 746f 2073 7461 6e64 6172 nd it to standar │ │ │ │ │ +000430c0: 6420 6f75 7470 7574 2e0a 0a1f 0a46 696c d output.....Fil │ │ │ │ │ +000430d0: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +000430e0: 6f64 653a 2049 6e76 6f6b 696e 6720 6772 ode: Invoking gr │ │ │ │ │ +000430f0: 7562 2d6d 6b70 6173 7377 642d 7062 6b64 ub-mkpasswd-pbkd │ │ │ │ │ +00043100: 6632 2c20 204e 6578 743a 2049 6e76 6f6b f2, Next: Invok │ │ │ │ │ +00043110: 696e 6720 6772 7562 2d6d 6b72 656c 7061 ing grub-mkrelpa │ │ │ │ │ +00043120: 7468 2c20 2050 7265 763a 2049 6e76 6f6b th, Prev: Invok │ │ │ │ │ +00043130: 696e 6720 6772 7562 2d6d 6b63 6f6e 6669 ing grub-mkconfi │ │ │ │ │ +00043140: 672c 2020 5570 3a20 546f 700a 0a32 3520 g, Up: Top..25 │ │ │ │ │ +00043150: 496e 766f 6b69 6e67 2067 7275 622d 6d6b Invoking grub-mk │ │ │ │ │ +00043160: 7061 7373 7764 2d70 626b 6466 320a 2a2a passwd-pbkdf2.** │ │ │ │ │ 00043170: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00043180: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5468 ************..Th │ │ │ │ │ -00043190: 6520 7072 6f67 7261 6d20 2767 7275 622d e program 'grub- │ │ │ │ │ -000431a0: 6d6b 7061 7373 7764 2d70 626b 6466 3227 mkpasswd-pbkdf2' │ │ │ │ │ -000431b0: 2067 656e 6572 6174 6573 2070 6173 7377 generates passw │ │ │ │ │ -000431c0: 6f72 6420 6861 7368 6573 2066 6f72 2047 ord hashes for G │ │ │ │ │ -000431d0: 5255 420a 282a 6e6f 7465 2053 6563 7572 RUB.(*note Secur │ │ │ │ │ -000431e0: 6974 793a 3a29 2e0a 0a20 2020 2020 6772 ity::)... gr │ │ │ │ │ -000431f0: 7562 2d6d 6b70 6173 7377 642d 7062 6b64 ub-mkpasswd-pbkd │ │ │ │ │ -00043200: 6632 0a0a 2020 2027 6772 7562 2d6d 6b70 f2.. 'grub-mkp │ │ │ │ │ -00043210: 6173 7377 642d 7062 6b64 6632 2720 6163 asswd-pbkdf2' ac │ │ │ │ │ -00043220: 6365 7074 7320 7468 6520 666f 6c6c 6f77 cepts the follow │ │ │ │ │ -00043230: 696e 6720 6f70 7469 6f6e 733a 0a0a 272d ing options:..'- │ │ │ │ │ -00043240: 6320 4e55 4d42 4552 270a 272d 2d69 7465 c NUMBER'.'--ite │ │ │ │ │ -00043250: 7261 7469 6f6e 2d63 6f75 6e74 3d4e 554d ration-count=NUM │ │ │ │ │ -00043260: 4245 5227 0a20 2020 2020 4e75 6d62 6572 BER'. Number │ │ │ │ │ -00043270: 206f 6620 6974 6572 6174 696f 6e73 206f of iterations o │ │ │ │ │ -00043280: 6620 7468 6520 756e 6465 726c 7969 6e67 f the underlying │ │ │ │ │ -00043290: 2070 7365 7564 6f2d 7261 6e64 6f6d 2066 pseudo-random f │ │ │ │ │ -000432a0: 756e 6374 696f 6e2e 0a20 2020 2020 4465 unction.. De │ │ │ │ │ -000432b0: 6661 756c 7473 2074 6f20 3130 3030 302e faults to 10000. │ │ │ │ │ -000432c0: 0a0a 272d 6c20 4e55 4d42 4552 270a 272d ..'-l NUMBER'.'- │ │ │ │ │ -000432d0: 2d62 7566 6c65 6e3d 4e55 4d42 4552 270a -buflen=NUMBER'. │ │ │ │ │ -000432e0: 2020 2020 204c 656e 6774 6820 6f66 2074 Length of t │ │ │ │ │ -000432f0: 6865 2067 656e 6572 6174 6564 2068 6173 he generated has │ │ │ │ │ -00043300: 682e 2020 4465 6661 756c 7473 2074 6f20 h. Defaults to │ │ │ │ │ -00043310: 3634 2e0a 0a27 2d73 204e 554d 4245 5227 64...'-s NUMBER' │ │ │ │ │ -00043320: 0a27 2d2d 7361 6c74 3d4e 554d 4245 5227 .'--salt=NUMBER' │ │ │ │ │ -00043330: 0a20 2020 2020 4c65 6e67 7468 206f 6620 . Length of │ │ │ │ │ -00043340: 7468 6520 7361 6c74 2e20 2044 6566 6175 the salt. Defau │ │ │ │ │ -00043350: 6c74 7320 746f 2036 342e 0a0a 1f0a 4669 lts to 64.....Fi │ │ │ │ │ -00043360: 6c65 3a20 6772 7562 2e69 6e66 6f2c 2020 le: grub.info, │ │ │ │ │ -00043370: 4e6f 6465 3a20 496e 766f 6b69 6e67 2067 Node: Invoking g │ │ │ │ │ -00043380: 7275 622d 6d6b 7265 6c70 6174 682c 2020 rub-mkrelpath, │ │ │ │ │ -00043390: 4e65 7874 3a20 496e 766f 6b69 6e67 2067 Next: Invoking g │ │ │ │ │ -000433a0: 7275 622d 6d6b 7265 7363 7565 2c20 2050 rub-mkrescue, P │ │ │ │ │ -000433b0: 7265 763a 2049 6e76 6f6b 696e 6720 6772 rev: Invoking gr │ │ │ │ │ -000433c0: 7562 2d6d 6b70 6173 7377 642d 7062 6b64 ub-mkpasswd-pbkd │ │ │ │ │ -000433d0: 6632 2c20 2055 703a 2054 6f70 0a0a 3236 f2, Up: Top..26 │ │ │ │ │ -000433e0: 2049 6e76 6f6b 696e 6720 6772 7562 2d6d Invoking grub-m │ │ │ │ │ -000433f0: 6b72 656c 7061 7468 0a2a 2a2a 2a2a 2a2a krelpath.******* │ │ │ │ │ +00043180: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ +00043190: 5468 6520 7072 6f67 7261 6d20 2767 7275 The program 'gru │ │ │ │ │ +000431a0: 622d 6d6b 7061 7373 7764 2d70 626b 6466 b-mkpasswd-pbkdf │ │ │ │ │ +000431b0: 3227 2067 656e 6572 6174 6573 2070 6173 2' generates pas │ │ │ │ │ +000431c0: 7377 6f72 6420 6861 7368 6573 2066 6f72 sword hashes for │ │ │ │ │ +000431d0: 2047 5255 420a 282a 6e6f 7465 2053 6563 GRUB.(*note Sec │ │ │ │ │ +000431e0: 7572 6974 793a 3a29 2e0a 0a20 2020 2020 urity::)... │ │ │ │ │ +000431f0: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ +00043200: 6b64 6632 0a0a 2020 2027 6772 7562 2d6d kdf2.. 'grub-m │ │ │ │ │ +00043210: 6b70 6173 7377 642d 7062 6b64 6632 2720 kpasswd-pbkdf2' │ │ │ │ │ +00043220: 6163 6365 7074 7320 7468 6520 666f 6c6c accepts the foll │ │ │ │ │ +00043230: 6f77 696e 6720 6f70 7469 6f6e 733a 0a0a owing options:.. │ │ │ │ │ +00043240: 272d 6320 4e55 4d42 4552 270a 272d 2d69 '-c NUMBER'.'--i │ │ │ │ │ +00043250: 7465 7261 7469 6f6e 2d63 6f75 6e74 3d4e teration-count=N │ │ │ │ │ +00043260: 554d 4245 5227 0a20 2020 2020 4e75 6d62 UMBER'. Numb │ │ │ │ │ +00043270: 6572 206f 6620 6974 6572 6174 696f 6e73 er of iterations │ │ │ │ │ +00043280: 206f 6620 7468 6520 756e 6465 726c 7969 of the underlyi │ │ │ │ │ +00043290: 6e67 2070 7365 7564 6f2d 7261 6e64 6f6d ng pseudo-random │ │ │ │ │ +000432a0: 2066 756e 6374 696f 6e2e 0a20 2020 2020 function.. │ │ │ │ │ +000432b0: 4465 6661 756c 7473 2074 6f20 3130 3030 Defaults to 1000 │ │ │ │ │ +000432c0: 302e 0a0a 272d 6c20 4e55 4d42 4552 270a 0...'-l NUMBER'. │ │ │ │ │ +000432d0: 272d 2d62 7566 6c65 6e3d 4e55 4d42 4552 '--buflen=NUMBER │ │ │ │ │ +000432e0: 270a 2020 2020 204c 656e 6774 6820 6f66 '. Length of │ │ │ │ │ +000432f0: 2074 6865 2067 656e 6572 6174 6564 2068 the generated h │ │ │ │ │ +00043300: 6173 682e 2020 4465 6661 756c 7473 2074 ash. Defaults t │ │ │ │ │ +00043310: 6f20 3634 2e0a 0a27 2d73 204e 554d 4245 o 64...'-s NUMBE │ │ │ │ │ +00043320: 5227 0a27 2d2d 7361 6c74 3d4e 554d 4245 R'.'--salt=NUMBE │ │ │ │ │ +00043330: 5227 0a20 2020 2020 4c65 6e67 7468 206f R'. Length o │ │ │ │ │ +00043340: 6620 7468 6520 7361 6c74 2e20 2044 6566 f the salt. Def │ │ │ │ │ +00043350: 6175 6c74 7320 746f 2036 342e 0a0a 1f0a aults to 64..... │ │ │ │ │ +00043360: 4669 6c65 3a20 6772 7562 2e69 6e66 6f2c File: grub.info, │ │ │ │ │ +00043370: 2020 4e6f 6465 3a20 496e 766f 6b69 6e67 Node: Invoking │ │ │ │ │ +00043380: 2067 7275 622d 6d6b 7265 6c70 6174 682c grub-mkrelpath, │ │ │ │ │ +00043390: 2020 4e65 7874 3a20 496e 766f 6b69 6e67 Next: Invoking │ │ │ │ │ +000433a0: 2067 7275 622d 6d6b 7265 7363 7565 2c20 grub-mkrescue, │ │ │ │ │ +000433b0: 2050 7265 763a 2049 6e76 6f6b 696e 6720 Prev: Invoking │ │ │ │ │ +000433c0: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ +000433d0: 6b64 6632 2c20 2055 703a 2054 6f70 0a0a kdf2, Up: Top.. │ │ │ │ │ +000433e0: 3236 2049 6e76 6f6b 696e 6720 6772 7562 26 Invoking grub │ │ │ │ │ +000433f0: 2d6d 6b72 656c 7061 7468 0a2a 2a2a 2a2a -mkrelpath.***** │ │ │ │ │ 00043400: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00043410: 2a2a 2a0a 0a54 6865 2070 726f 6772 616d ***..The program │ │ │ │ │ -00043420: 2027 6772 7562 2d6d 6b72 656c 7061 7468 'grub-mkrelpath │ │ │ │ │ -00043430: 2720 6d61 6b65 7320 6120 6669 6c65 2073 ' makes a file s │ │ │ │ │ -00043440: 7973 7465 6d20 7061 7468 2072 656c 6174 ystem path relat │ │ │ │ │ -00043450: 6976 6520 746f 2074 6865 0a72 6f6f 7420 ive to the.root │ │ │ │ │ -00043460: 6f66 2069 7473 2063 6f6e 7461 696e 696e of its containin │ │ │ │ │ -00043470: 6720 6669 6c65 2073 7973 7465 6d2e 2020 g file system. │ │ │ │ │ -00043480: 466f 7220 696e 7374 616e 6365 2c20 6966 For instance, if │ │ │ │ │ -00043490: 2027 2f75 7372 2720 6973 2061 206d 6f75 '/usr' is a mou │ │ │ │ │ -000434a0: 6e74 0a70 6f69 6e74 2c20 7468 656e 3a0a nt.point, then:. │ │ │ │ │ -000434b0: 0a20 2020 2020 2420 6772 7562 2d6d 6b72 . $ grub-mkr │ │ │ │ │ -000434c0: 656c 7061 7468 202f 7573 722f 7368 6172 elpath /usr/shar │ │ │ │ │ -000434d0: 652f 6772 7562 2f75 6e69 636f 6465 2e70 e/grub/unicode.p │ │ │ │ │ -000434e0: 6632 0a20 2020 2020 272f 7368 6172 652f f2. '/share/ │ │ │ │ │ -000434f0: 6772 7562 2f75 6e69 636f 6465 2e70 6632 grub/unicode.pf2 │ │ │ │ │ -00043500: 270a 0a20 2020 5468 6973 2069 7320 6d61 '.. This is ma │ │ │ │ │ -00043510: 696e 6c79 2075 7365 6420 696e 7465 726e inly used intern │ │ │ │ │ -00043520: 616c 6c79 2062 7920 6f74 6865 7220 4752 ally by other GR │ │ │ │ │ -00043530: 5542 2075 7469 6c69 7469 6573 2073 7563 UB utilities suc │ │ │ │ │ -00043540: 6820 6173 0a27 6772 7562 2d6d 6b63 6f6e h as.'grub-mkcon │ │ │ │ │ -00043550: 6669 6727 2028 2a6e 6f74 6520 496e 766f fig' (*note Invo │ │ │ │ │ -00043560: 6b69 6e67 2067 7275 622d 6d6b 636f 6e66 king grub-mkconf │ │ │ │ │ -00043570: 6967 3a3a 292c 2062 7574 206d 6179 206f ig::), but may o │ │ │ │ │ -00043580: 6363 6173 696f 6e61 6c6c 790a 616c 736f ccasionally.also │ │ │ │ │ -00043590: 2062 6520 7573 6566 756c 2066 6f72 2064 be useful for d │ │ │ │ │ -000435a0: 6562 7567 6769 6e67 2e0a 0a20 2020 2767 ebugging... 'g │ │ │ │ │ -000435b0: 7275 622d 6d6b 7265 6c70 6174 6827 2061 rub-mkrelpath' a │ │ │ │ │ -000435c0: 6363 6570 7473 2074 6865 2066 6f6c 6c6f ccepts the follo │ │ │ │ │ -000435d0: 7769 6e67 206f 7074 696f 6e73 3a0a 0a27 wing options:..' │ │ │ │ │ -000435e0: 2d2d 6865 6c70 270a 2020 2020 2050 7269 --help'. Pri │ │ │ │ │ -000435f0: 6e74 2061 2073 756d 6d61 7279 206f 6620 nt a summary of │ │ │ │ │ -00043600: 7468 6520 636f 6d6d 616e 642d 6c69 6e65 the command-line │ │ │ │ │ -00043610: 206f 7074 696f 6e73 2061 6e64 2065 7869 options and exi │ │ │ │ │ -00043620: 742e 0a0a 272d 2d76 6572 7369 6f6e 270a t...'--version'. │ │ │ │ │ -00043630: 2020 2020 2050 7269 6e74 2074 6865 2076 Print the v │ │ │ │ │ -00043640: 6572 7369 6f6e 206e 756d 6265 7220 6f66 ersion number of │ │ │ │ │ -00043650: 2047 5255 4220 616e 6420 6578 6974 2e0a GRUB and exit.. │ │ │ │ │ -00043660: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00043670: 666f 2c20 204e 6f64 653a 2049 6e76 6f6b fo, Node: Invok │ │ │ │ │ -00043680: 696e 6720 6772 7562 2d6d 6b72 6573 6375 ing grub-mkrescu │ │ │ │ │ -00043690: 652c 2020 4e65 7874 3a20 496e 766f 6b69 e, Next: Invoki │ │ │ │ │ -000436a0: 6e67 2067 7275 622d 6d6f 756e 742c 2020 ng grub-mount, │ │ │ │ │ -000436b0: 5072 6576 3a20 496e 766f 6b69 6e67 2067 Prev: Invoking g │ │ │ │ │ -000436c0: 7275 622d 6d6b 7265 6c70 6174 682c 2020 rub-mkrelpath, │ │ │ │ │ -000436d0: 5570 3a20 546f 700a 0a32 3720 496e 766f Up: Top..27 Invo │ │ │ │ │ -000436e0: 6b69 6e67 2067 7275 622d 6d6b 7265 7363 king grub-mkresc │ │ │ │ │ -000436f0: 7565 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a ue.************* │ │ │ │ │ -00043700: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5468 ************..Th │ │ │ │ │ -00043710: 6520 7072 6f67 7261 6d20 2767 7275 622d e program 'grub- │ │ │ │ │ -00043720: 6d6b 7265 7363 7565 2720 6765 6e65 7261 mkrescue' genera │ │ │ │ │ -00043730: 7465 7320 6120 626f 6f74 6162 6c65 2047 tes a bootable G │ │ │ │ │ -00043740: 5255 4220 7265 7363 7565 2069 6d61 6765 RUB rescue image │ │ │ │ │ -00043750: 0a28 2a6e 6f74 6520 4d61 6b69 6e67 2061 .(*note Making a │ │ │ │ │ -00043760: 2047 5255 4220 626f 6f74 6162 6c65 2043 GRUB bootable C │ │ │ │ │ -00043770: 442d 524f 4d3a 3a29 2e0a 0a20 2020 2020 D-ROM::)... │ │ │ │ │ -00043780: 6772 7562 2d6d 6b72 6573 6375 6520 2d6f grub-mkrescue -o │ │ │ │ │ -00043790: 2067 7275 622e 6973 6f0a 0a20 2020 416c grub.iso.. Al │ │ │ │ │ -000437a0: 6c20 6172 6775 6d65 6e74 7320 6e6f 7420 l arguments not │ │ │ │ │ -000437b0: 6578 706c 6963 6974 6c79 206c 6973 7465 explicitly liste │ │ │ │ │ -000437c0: 6420 6173 2027 6772 7562 2d6d 6b72 6573 d as 'grub-mkres │ │ │ │ │ -000437d0: 6375 6527 206f 7074 696f 6e73 2061 7265 cue' options are │ │ │ │ │ -000437e0: 0a70 6173 7365 6420 6f6e 2064 6972 6563 .passed on direc │ │ │ │ │ -000437f0: 746c 7920 746f 2027 786f 7272 6973 6f27 tly to 'xorriso' │ │ │ │ │ -00043800: 2069 6e20 276d 6b69 736f 6673 2720 656d in 'mkisofs' em │ │ │ │ │ -00043810: 756c 6174 696f 6e20 6d6f 6465 2e20 204f ulation mode. O │ │ │ │ │ -00043820: 7074 696f 6e73 0a70 6173 7365 6420 746f ptions.passed to │ │ │ │ │ -00043830: 2027 786f 7272 6973 6f27 2077 696c 6c20 'xorriso' will │ │ │ │ │ -00043840: 6e6f 726d 616c 6c79 2062 6520 696e 7465 normally be inte │ │ │ │ │ -00043850: 7270 7265 7465 6420 6173 2027 6d6b 6973 rpreted as 'mkis │ │ │ │ │ -00043860: 6f66 7327 206f 7074 696f 6e73 3b0a 6966 ofs' options;.if │ │ │ │ │ -00043870: 2074 6865 206f 7074 696f 6e20 272d 2d27 the option '--' │ │ │ │ │ -00043880: 2069 7320 7573 6564 2c20 7468 656e 2061 is used, then a │ │ │ │ │ -00043890: 6e79 7468 696e 6720 6166 7465 7220 7468 nything after th │ │ │ │ │ -000438a0: 6174 2077 696c 6c20 6265 2069 6e74 6572 at will be inter │ │ │ │ │ -000438b0: 7072 6574 6564 0a61 7320 6e61 7469 7665 preted.as native │ │ │ │ │ -000438c0: 2027 786f 7272 6973 6f27 206f 7074 696f 'xorriso' optio │ │ │ │ │ -000438d0: 6e73 2e0a 0a20 2020 4e6f 6e2d 6f70 7469 ns... Non-opti │ │ │ │ │ -000438e0: 6f6e 2061 7267 756d 656e 7473 2073 7065 on arguments spe │ │ │ │ │ -000438f0: 6369 6679 2061 6464 6974 696f 6e61 6c20 cify additional │ │ │ │ │ -00043900: 736f 7572 6365 2064 6972 6563 746f 7269 source directori │ │ │ │ │ -00043910: 6573 2e20 2054 6869 7320 6973 0a63 6f6d es. This is.com │ │ │ │ │ -00043920: 6d6f 6e6c 7920 7573 6564 2074 6f20 6164 monly used to ad │ │ │ │ │ -00043930: 6420 6578 7472 6120 6669 6c65 7320 746f d extra files to │ │ │ │ │ -00043940: 2074 6865 2069 6d61 6765 3a0a 0a20 2020 the image:.. │ │ │ │ │ -00043950: 2020 6d6b 6469 7220 2d70 2064 6973 6b2f mkdir -p disk/ │ │ │ │ │ -00043960: 626f 6f74 2f67 7275 620a 2020 2020 2028 boot/grub. ( │ │ │ │ │ -00043970: 6164 6420 6578 7472 6120 6669 6c65 7320 add extra files │ │ │ │ │ -00043980: 746f 2027 6469 736b 2f62 6f6f 742f 6772 to 'disk/boot/gr │ │ │ │ │ -00043990: 7562 2729 0a20 2020 2020 6772 7562 2d6d ub'). grub-m │ │ │ │ │ -000439a0: 6b72 6573 6375 6520 2d6f 2067 7275 622e krescue -o grub. │ │ │ │ │ -000439b0: 6973 6f20 6469 736b 0a0a 2020 2027 6772 iso disk.. 'gr │ │ │ │ │ -000439c0: 7562 2d6d 6b72 6573 6375 6527 2061 6363 ub-mkrescue' acc │ │ │ │ │ -000439d0: 6570 7473 2074 6865 2066 6f6c 6c6f 7769 epts the followi │ │ │ │ │ -000439e0: 6e67 206f 7074 696f 6e73 3a0a 0a27 2d2d ng options:..'-- │ │ │ │ │ -000439f0: 6865 6c70 270a 2020 2020 2050 7269 6e74 help'. Print │ │ │ │ │ -00043a00: 2061 2073 756d 6d61 7279 206f 6620 7468 a summary of th │ │ │ │ │ -00043a10: 6520 636f 6d6d 616e 642d 6c69 6e65 206f e command-line o │ │ │ │ │ -00043a20: 7074 696f 6e73 2061 6e64 2065 7869 742e ptions and exit. │ │ │ │ │ -00043a30: 0a0a 272d 2d76 6572 7369 6f6e 270a 2020 ..'--version'. │ │ │ │ │ -00043a40: 2020 2050 7269 6e74 2074 6865 2076 6572 Print the ver │ │ │ │ │ -00043a50: 7369 6f6e 206e 756d 6265 7220 6f66 2047 sion number of G │ │ │ │ │ -00043a60: 5255 4220 616e 6420 6578 6974 2e0a 0a27 RUB and exit...' │ │ │ │ │ -00043a70: 2d6f 2046 494c 4527 0a27 2d2d 6f75 7470 -o FILE'.'--outp │ │ │ │ │ -00043a80: 7574 3d46 494c 4527 0a20 2020 2020 5361 ut=FILE'. Sa │ │ │ │ │ -00043a90: 7665 206f 7574 7075 7420 696e 2046 494c ve output in FIL │ │ │ │ │ -00043aa0: 452e 2020 5468 6973 2022 6f70 7469 6f6e E. This "option │ │ │ │ │ -00043ab0: 2220 6973 2072 6571 7569 7265 642e 0a0a " is required... │ │ │ │ │ -00043ac0: 272d 2d6d 6f64 756c 6573 3d4d 4f44 554c '--modules=MODUL │ │ │ │ │ -00043ad0: 4553 270a 2020 2020 2050 7265 2d6c 6f61 ES'. Pre-loa │ │ │ │ │ -00043ae0: 6420 7468 6520 6e61 6d65 6420 4752 5542 d the named GRUB │ │ │ │ │ -00043af0: 206d 6f64 756c 6573 2069 6e20 7468 6520 modules in the │ │ │ │ │ -00043b00: 696d 6167 652e 2020 4d75 6c74 6970 6c65 image. Multiple │ │ │ │ │ -00043b10: 2065 6e74 7269 6573 2069 6e0a 2020 2020 entries in. │ │ │ │ │ -00043b20: 204d 4f44 554c 4553 2073 686f 756c 6420 MODULES should │ │ │ │ │ -00043b30: 6265 2073 6570 6172 6174 6564 2062 7920 be separated by │ │ │ │ │ -00043b40: 7768 6974 6573 7061 6365 2028 736f 2079 whitespace (so y │ │ │ │ │ -00043b50: 6f75 2077 696c 6c20 7072 6f62 6162 6c79 ou will probably │ │ │ │ │ -00043b60: 0a20 2020 2020 6e65 6564 2074 6f20 7175 . need to qu │ │ │ │ │ -00043b70: 6f74 6520 7468 6973 2066 6f72 2079 6f75 ote this for you │ │ │ │ │ -00043b80: 7220 7368 656c 6c29 2e0a 0a27 2d2d 726f r shell)...'--ro │ │ │ │ │ -00043b90: 6d2d 6469 7265 6374 6f72 793d 4449 5227 m-directory=DIR' │ │ │ │ │ -00043ba0: 0a20 2020 2020 4966 2067 656e 6572 6174 . If generat │ │ │ │ │ -00043bb0: 696e 6720 696d 6167 6573 2066 6f72 2074 ing images for t │ │ │ │ │ -00043bc0: 6865 2051 454d 5520 6f72 2043 6f72 6562 he QEMU or Coreb │ │ │ │ │ -00043bd0: 6f6f 7420 706c 6174 666f 726d 732c 2063 oot platforms, c │ │ │ │ │ -00043be0: 6f70 7920 7468 650a 2020 2020 2072 6573 opy the. res │ │ │ │ │ -00043bf0: 756c 7469 6e67 2027 7165 6d75 2e69 6d67 ulting 'qemu.img │ │ │ │ │ -00043c00: 2720 6f72 2027 636f 7265 626f 6f74 2e65 ' or 'coreboot.e │ │ │ │ │ -00043c10: 6c66 2720 6669 6c65 7320 7265 7370 6563 lf' files respec │ │ │ │ │ -00043c20: 7469 7665 6c79 2074 6f20 7468 650a 2020 tively to the. │ │ │ │ │ -00043c30: 2020 2044 4952 2064 6972 6563 746f 7279 DIR directory │ │ │ │ │ -00043c40: 2061 7320 7765 6c6c 2061 7320 696e 636c as well as incl │ │ │ │ │ -00043c50: 7564 696e 6720 7468 656d 2069 6e20 7468 uding them in th │ │ │ │ │ -00043c60: 6520 696d 6167 652e 0a0a 272d 2d78 6f72 e image...'--xor │ │ │ │ │ -00043c70: 7269 736f 3d46 494c 4527 0a20 2020 2020 riso=FILE'. │ │ │ │ │ -00043c80: 5573 6520 4649 4c45 2061 7320 7468 6520 Use FILE as the │ │ │ │ │ -00043c90: 2778 6f72 7269 736f 2720 7072 6f67 7261 'xorriso' progra │ │ │ │ │ -00043ca0: 6d2c 2072 6174 6865 7220 7468 616e 2074 m, rather than t │ │ │ │ │ -00043cb0: 6865 2062 7569 6c74 2d69 6e0a 2020 2020 he built-in. │ │ │ │ │ -00043cc0: 2064 6566 6175 6c74 2e0a 0a27 2d2d 6772 default...'--gr │ │ │ │ │ -00043cd0: 7562 2d6d 6b69 6d61 6765 3d46 494c 4527 ub-mkimage=FILE' │ │ │ │ │ -00043ce0: 0a20 2020 2020 5573 6520 4649 4c45 2061 . Use FILE a │ │ │ │ │ -00043cf0: 7320 7468 6520 2767 7275 622d 6d6b 696d s the 'grub-mkim │ │ │ │ │ -00043d00: 6167 6527 2070 726f 6772 616d 2c20 7261 age' program, ra │ │ │ │ │ -00043d10: 7468 6572 2074 6861 6e20 7468 6520 6275 ther than the bu │ │ │ │ │ -00043d20: 696c 742d 696e 0a20 2020 2020 6465 6661 ilt-in. defa │ │ │ │ │ -00043d30: 756c 742e 0a0a 1f0a 4669 6c65 3a20 6772 ult.....File: gr │ │ │ │ │ -00043d40: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ -00043d50: 496e 766f 6b69 6e67 2067 7275 622d 6d6f Invoking grub-mo │ │ │ │ │ -00043d60: 756e 742c 2020 4e65 7874 3a20 496e 766f unt, Next: Invo │ │ │ │ │ -00043d70: 6b69 6e67 2067 7275 622d 7072 6f62 652c king grub-probe, │ │ │ │ │ -00043d80: 2020 5072 6576 3a20 496e 766f 6b69 6e67 Prev: Invoking │ │ │ │ │ -00043d90: 2067 7275 622d 6d6b 7265 7363 7565 2c20 grub-mkrescue, │ │ │ │ │ -00043da0: 2055 703a 2054 6f70 0a0a 3238 2049 6e76 Up: Top..28 Inv │ │ │ │ │ -00043db0: 6f6b 696e 6720 6772 7562 2d6d 6f75 6e74 oking grub-mount │ │ │ │ │ -00043dc0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ -00043dd0: 2a2a 2a2a 2a2a 2a0a 0a54 6865 2070 726f *******..The pro │ │ │ │ │ -00043de0: 6772 616d 2027 6772 7562 2d6d 6f75 6e74 gram 'grub-mount │ │ │ │ │ -00043df0: 2720 7065 7266 6f72 6d73 2061 2072 6561 ' performs a rea │ │ │ │ │ -00043e00: 642d 6f6e 6c79 206d 6f75 6e74 206f 6620 d-only mount of │ │ │ │ │ -00043e10: 616e 7920 6669 6c65 2073 7973 7465 6d0a any file system. │ │ │ │ │ -00043e20: 6f72 2066 696c 6520 7379 7374 656d 2069 or file system i │ │ │ │ │ -00043e30: 6d61 6765 2074 6861 7420 4752 5542 2075 mage that GRUB u │ │ │ │ │ -00043e40: 6e64 6572 7374 616e 6473 2c20 7573 696e nderstands, usin │ │ │ │ │ -00043e50: 6720 4752 5542 2773 2066 696c 6520 7379 g GRUB's file sy │ │ │ │ │ -00043e60: 7374 656d 0a64 7269 7665 7273 2076 6961 stem.drivers via │ │ │ │ │ -00043e70: 2046 5553 452e 2028 4974 2069 7320 6f6e FUSE. (It is on │ │ │ │ │ -00043e80: 6c79 2061 7661 696c 6162 6c65 2069 6620 ly available if │ │ │ │ │ -00043e90: 4655 5345 2064 6576 656c 6f70 6d65 6e74 FUSE development │ │ │ │ │ -00043ea0: 2066 696c 6573 2077 6572 650a 7072 6573 files were.pres │ │ │ │ │ -00043eb0: 656e 7420 7768 656e 2047 5255 4220 7761 ent when GRUB wa │ │ │ │ │ -00043ec0: 7320 6275 696c 742e 2920 2054 6869 7320 s built.) This │ │ │ │ │ -00043ed0: 6861 7320 6120 6e75 6d62 6572 206f 6620 has a number of │ │ │ │ │ -00043ee0: 7573 6573 3a0a 0a20 2020 2a20 4974 2070 uses:.. * It p │ │ │ │ │ -00043ef0: 726f 7669 6465 7320 6120 636f 6e76 656e rovides a conven │ │ │ │ │ -00043f00: 6965 6e74 2077 6179 2074 6f20 6368 6563 ient way to chec │ │ │ │ │ -00043f10: 6b20 686f 7720 4752 5542 2077 696c 6c20 k how GRUB will │ │ │ │ │ -00043f20: 7669 6577 2061 2066 696c 650a 2020 2020 view a file. │ │ │ │ │ -00043f30: 2073 7973 7465 6d20 6174 2062 6f6f 7420 system at boot │ │ │ │ │ -00043f40: 7469 6d65 2e20 2059 6f75 2063 616e 2075 time. You can u │ │ │ │ │ -00043f50: 7365 206e 6f72 6d61 6c20 636f 6d6d 616e se normal comman │ │ │ │ │ -00043f60: 642d 6c69 6e65 2074 6f6f 6c73 2074 6f0a d-line tools to. │ │ │ │ │ -00043f70: 2020 2020 2063 6f6d 7061 7265 2074 6861 compare tha │ │ │ │ │ -00043f80: 7420 7669 6577 2077 6974 6820 7468 6174 t view with that │ │ │ │ │ -00043f90: 206f 6620 796f 7572 206f 7065 7261 7469 of your operati │ │ │ │ │ -00043fa0: 6e67 2073 7973 7465 6d2c 206d 616b 696e ng system, makin │ │ │ │ │ -00043fb0: 6720 6974 0a20 2020 2020 6561 7379 2074 g it. easy t │ │ │ │ │ -00043fc0: 6f20 6669 6e64 2062 7567 732e 0a0a 2020 o find bugs... │ │ │ │ │ -00043fd0: 202a 2049 7420 6f66 6665 7273 2074 7275 * It offers tru │ │ │ │ │ -00043fe0: 6520 7265 6164 2d6f 6e6c 7920 6d6f 756e e read-only moun │ │ │ │ │ -00043ff0: 7473 2e20 204c 696e 7578 2064 6f65 7320 ts. Linux does │ │ │ │ │ -00044000: 6e6f 7420 6861 7665 2074 6865 7365 2066 not have these f │ │ │ │ │ -00044010: 6f72 0a20 2020 2020 6a6f 7572 6e61 6c6c or. journall │ │ │ │ │ -00044020: 696e 6720 6669 6c65 2073 7973 7465 6d73 ing file systems │ │ │ │ │ -00044030: 2c20 6265 6361 7573 6520 6974 2077 696c , because it wil │ │ │ │ │ -00044040: 6c20 616c 7761 7973 2061 7474 656d 7074 l always attempt │ │ │ │ │ -00044050: 2074 6f20 7265 706c 6179 0a20 2020 2020 to replay. │ │ │ │ │ -00044060: 7468 6520 6a6f 7572 6e61 6c20 6174 206d the journal at m │ │ │ │ │ -00044070: 6f75 6e74 2074 696d 653b 2077 6869 6c65 ount time; while │ │ │ │ │ -00044080: 2079 6f75 2063 616e 2074 656d 706f 7261 you can tempora │ │ │ │ │ -00044090: 7269 6c79 206d 6172 6b20 7468 6520 626c rily mark the bl │ │ │ │ │ -000440a0: 6f63 6b0a 2020 2020 2064 6576 6963 6520 ock. device │ │ │ │ │ -000440b0: 7265 6164 2d6f 6e6c 7920 746f 2061 766f read-only to avo │ │ │ │ │ -000440c0: 6964 2074 6869 732c 2074 6861 7420 6361 id this, that ca │ │ │ │ │ -000440d0: 7573 6573 2074 6865 206d 6f75 6e74 2074 uses the mount t │ │ │ │ │ -000440e0: 6f20 6661 696c 2e0a 2020 2020 2053 696e o fail.. Sin │ │ │ │ │ -000440f0: 6365 2047 5255 4220 696e 7465 6e74 696f ce GRUB intentio │ │ │ │ │ -00044100: 6e61 6c6c 7920 636f 6e74 6169 6e73 206e nally contains n │ │ │ │ │ -00044110: 6f20 636f 6465 2066 6f72 2077 7269 7469 o code for writi │ │ │ │ │ -00044120: 6e67 2074 6f20 6669 6c65 0a20 2020 2020 ng to file. │ │ │ │ │ -00044130: 7379 7374 656d 732c 2069 7420 6361 6e20 systems, it can │ │ │ │ │ -00044140: 6561 7369 6c79 2070 726f 7669 6465 2061 easily provide a │ │ │ │ │ -00044150: 2067 7561 7261 6e74 6565 6420 7265 6164 guaranteed read │ │ │ │ │ -00044160: 2d6f 6e6c 7920 6d6f 756e 740a 2020 2020 -only mount. │ │ │ │ │ -00044170: 206d 6563 6861 6e69 736d 2e0a 0a20 2020 mechanism... │ │ │ │ │ -00044180: 2a20 4974 2061 6c6c 6f77 7320 796f 7520 * It allows you │ │ │ │ │ -00044190: 746f 2065 7861 6d69 6e65 2061 6e79 2066 to examine any f │ │ │ │ │ -000441a0: 696c 6520 7379 7374 656d 2074 6861 7420 ile system that │ │ │ │ │ -000441b0: 4752 5542 2075 6e64 6572 7374 616e 6473 GRUB understands │ │ │ │ │ -000441c0: 0a20 2020 2020 7769 7468 6f75 7420 6e65 . without ne │ │ │ │ │ -000441d0: 6564 696e 6720 746f 206c 6f61 6420 6164 eding to load ad │ │ │ │ │ -000441e0: 6469 7469 6f6e 616c 206d 6f64 756c 6573 ditional modules │ │ │ │ │ -000441f0: 2069 6e74 6f20 796f 7572 2072 756e 6e69 into your runni │ │ │ │ │ -00044200: 6e67 0a20 2020 2020 6b65 726e 656c 2c20 ng. kernel, │ │ │ │ │ -00044210: 7768 6963 6820 6d61 7920 6265 2075 7365 which may be use │ │ │ │ │ -00044220: 6675 6c20 696e 2063 6f6e 7374 7261 696e ful in constrain │ │ │ │ │ -00044230: 6564 2065 6e76 6972 6f6e 6d65 6e74 7320 ed environments │ │ │ │ │ -00044240: 7375 6368 2061 730a 2020 2020 2069 6e73 such as. ins │ │ │ │ │ -00044250: 7461 6c6c 6572 732e 0a0a 2020 202a 2053 tallers... * S │ │ │ │ │ -00044260: 696e 6365 2069 7420 6361 6e20 6578 616d ince it can exam │ │ │ │ │ -00044270: 696e 6520 6669 6c65 2073 7973 7465 6d20 ine file system │ │ │ │ │ -00044280: 696d 6167 6573 2028 636f 6e74 6169 6e65 images (containe │ │ │ │ │ -00044290: 6420 696e 2072 6567 756c 6172 0a20 2020 d in regular. │ │ │ │ │ -000442a0: 2020 6669 6c65 7329 206a 7573 7420 6173 files) just as │ │ │ │ │ -000442b0: 2065 6173 696c 7920 6173 2066 696c 6520 easily as file │ │ │ │ │ -000442c0: 7379 7374 656d 7320 6f6e 2062 6c6f 636b systems on block │ │ │ │ │ -000442d0: 2064 6576 6963 6573 2c20 796f 7520 6361 devices, you ca │ │ │ │ │ -000442e0: 6e20 7573 650a 2020 2020 2069 7420 746f n use. it to │ │ │ │ │ -000442f0: 2069 6e73 7065 6374 2061 6e79 2066 696c inspect any fil │ │ │ │ │ -00044300: 6520 7379 7374 656d 2069 6d61 6765 2074 e system image t │ │ │ │ │ -00044310: 6861 7420 4752 5542 2075 6e64 6572 7374 hat GRUB underst │ │ │ │ │ -00044320: 616e 6473 2077 6974 6820 6f6e 6c79 0a20 ands with only. │ │ │ │ │ -00044330: 2020 2020 656e 6f75 6768 2070 7269 7669 enough privi │ │ │ │ │ -00044340: 6c65 6765 7320 746f 2075 7365 2046 5553 leges to use FUS │ │ │ │ │ -00044350: 452c 2065 7665 6e20 6966 206e 6f62 6f64 E, even if nobod │ │ │ │ │ -00044360: 7920 6861 7320 7965 7420 7772 6974 7465 y has yet writte │ │ │ │ │ -00044370: 6e20 610a 2020 2020 2046 5553 4520 6d6f n a. FUSE mo │ │ │ │ │ -00044380: 6475 6c65 2073 7065 6369 6669 6361 6c6c dule specificall │ │ │ │ │ -00044390: 7920 666f 7220 7468 6174 2066 696c 6520 y for that file │ │ │ │ │ -000443a0: 7379 7374 656d 2074 7970 652e 0a0a 2020 system type... │ │ │ │ │ -000443b0: 2055 7369 6e67 2027 6772 7562 2d6d 6f75 Using 'grub-mou │ │ │ │ │ -000443c0: 6e74 2720 6973 206e 6f72 6d61 6c6c 7920 nt' is normally │ │ │ │ │ -000443d0: 6173 2073 696d 706c 6520 6173 3a0a 0a20 as simple as:.. │ │ │ │ │ -000443e0: 2020 2020 6772 7562 2d6d 6f75 6e74 202f grub-mount / │ │ │ │ │ -000443f0: 6465 762f 7364 6131 202f 6d6e 740a 0a20 dev/sda1 /mnt.. │ │ │ │ │ -00044400: 2020 2767 7275 622d 6d6f 756e 7427 206d 'grub-mount' m │ │ │ │ │ -00044410: 7573 7420 6265 2067 6976 656e 206f 6e65 ust be given one │ │ │ │ │ -00044420: 206f 7220 6d6f 7265 2069 6d61 6765 7320 or more images │ │ │ │ │ -00044430: 616e 6420 6120 6d6f 756e 7420 706f 696e and a mount poin │ │ │ │ │ -00044440: 7420 6173 0a6e 6f6e 2d6f 7074 696f 6e20 t as.non-option │ │ │ │ │ -00044450: 6172 6775 6d65 6e74 7320 2869 6620 6974 arguments (if it │ │ │ │ │ -00044460: 2069 7320 6769 7665 6e20 6d6f 7265 2074 is given more t │ │ │ │ │ -00044470: 6861 6e20 6f6e 6520 696d 6167 652c 2069 han one image, i │ │ │ │ │ -00044480: 7420 7769 6c6c 2074 7265 6174 0a74 6865 t will treat.the │ │ │ │ │ -00044490: 6d20 6173 2061 2052 4149 4420 7365 7429 m as a RAID set) │ │ │ │ │ -000444a0: 2c20 616e 6420 616c 736f 2061 6363 6570 , and also accep │ │ │ │ │ -000444b0: 7473 2074 6865 2066 6f6c 6c6f 7769 6e67 ts the following │ │ │ │ │ -000444c0: 206f 7074 696f 6e73 3a0a 0a27 2d2d 6865 options:..'--he │ │ │ │ │ -000444d0: 6c70 270a 2020 2020 2050 7269 6e74 2061 lp'. Print a │ │ │ │ │ -000444e0: 2073 756d 6d61 7279 206f 6620 7468 6520 summary of the │ │ │ │ │ -000444f0: 636f 6d6d 616e 642d 6c69 6e65 206f 7074 command-line opt │ │ │ │ │ -00044500: 696f 6e73 2061 6e64 2065 7869 742e 0a0a ions and exit... │ │ │ │ │ -00044510: 272d 2d76 6572 7369 6f6e 270a 2020 2020 '--version'. │ │ │ │ │ -00044520: 2050 7269 6e74 2074 6865 2076 6572 7369 Print the versi │ │ │ │ │ -00044530: 6f6e 206e 756d 6265 7220 6f66 2047 5255 on number of GRU │ │ │ │ │ -00044540: 4220 616e 6420 6578 6974 2e0a 0a27 2d43 B and exit...'-C │ │ │ │ │ -00044550: 270a 272d 2d63 7279 7074 6f27 0a20 2020 '.'--crypto'. │ │ │ │ │ -00044560: 2020 4d6f 756e 7420 656e 6372 7970 7465 Mount encrypte │ │ │ │ │ -00044570: 6420 6465 7669 6365 732c 2070 726f 6d70 d devices, promp │ │ │ │ │ -00044580: 7469 6e67 2066 6f72 2061 2070 6173 7370 ting for a passp │ │ │ │ │ -00044590: 6872 6173 6520 6966 206e 6563 6573 7361 hrase if necessa │ │ │ │ │ -000445a0: 7279 2e0a 0a27 2d64 2053 5452 494e 4727 ry...'-d STRING' │ │ │ │ │ -000445b0: 0a27 2d2d 6465 6275 673d 5354 5249 4e47 .'--debug=STRING │ │ │ │ │ -000445c0: 270a 2020 2020 2053 686f 7720 6465 6275 '. Show debu │ │ │ │ │ -000445d0: 6767 696e 6720 6f75 7470 7574 2066 6f72 gging output for │ │ │ │ │ -000445e0: 2063 6f6e 6469 7469 6f6e 7320 6d61 7463 conditions matc │ │ │ │ │ -000445f0: 6869 6e67 2053 5452 494e 472e 0a0a 272d hing STRING...'- │ │ │ │ │ -00044600: 4b20 7072 6f6d 7074 7c46 494c 4527 0a27 K prompt|FILE'.' │ │ │ │ │ -00044610: 2d2d 7a66 732d 6b65 793d 7072 6f6d 7074 --zfs-key=prompt │ │ │ │ │ -00044620: 7c46 494c 4527 0a20 2020 2020 4c6f 6164 |FILE'. Load │ │ │ │ │ -00044630: 2061 205a 4653 2065 6e63 7279 7074 696f a ZFS encryptio │ │ │ │ │ -00044640: 6e20 6b65 792e 2020 4966 2079 6f75 2075 n key. If you u │ │ │ │ │ -00044650: 7365 2027 7072 6f6d 7074 2720 6173 2074 se 'prompt' as t │ │ │ │ │ -00044660: 6865 2061 7267 756d 656e 742c 0a20 2020 he argument,. │ │ │ │ │ -00044670: 2020 2767 7275 622d 6d6f 756e 7427 2077 'grub-mount' w │ │ │ │ │ -00044680: 696c 6c20 7265 6164 2061 2070 6173 7370 ill read a passp │ │ │ │ │ -00044690: 6872 6173 6520 6672 6f6d 2074 6865 2074 hrase from the t │ │ │ │ │ -000446a0: 6572 6d69 6e61 6c3b 206f 7468 6572 7769 erminal; otherwi │ │ │ │ │ -000446b0: 7365 2c0a 2020 2020 2069 7420 7769 6c6c se,. it will │ │ │ │ │ -000446c0: 2072 6561 6420 6b65 7920 6d61 7465 7269 read key materi │ │ │ │ │ -000446d0: 616c 2066 726f 6d20 7468 6520 7370 6563 al from the spec │ │ │ │ │ -000446e0: 6966 6965 6420 6669 6c65 2e0a 0a27 2d72 ified file...'-r │ │ │ │ │ -000446f0: 2044 4556 4943 4527 0a27 2d2d 726f 6f74 DEVICE'.'--root │ │ │ │ │ -00044700: 3d44 4556 4943 4527 0a20 2020 2020 5365 =DEVICE'. Se │ │ │ │ │ -00044710: 7420 7468 6520 4752 5542 2072 6f6f 7420 t the GRUB root │ │ │ │ │ -00044720: 6465 7669 6365 2074 6f20 4445 5649 4345 device to DEVICE │ │ │ │ │ -00044730: 2e20 2059 6f75 2064 6f20 6e6f 7420 6e6f . You do not no │ │ │ │ │ -00044740: 726d 616c 6c79 206e 6565 6420 746f 0a20 rmally need to. │ │ │ │ │ -00044750: 2020 2020 7365 7420 7468 6973 3b20 2767 set this; 'g │ │ │ │ │ -00044760: 7275 622d 6d6f 756e 7427 2077 696c 6c20 rub-mount' will │ │ │ │ │ -00044770: 6175 746f 6d61 7469 6361 6c6c 7920 7365 automatically se │ │ │ │ │ -00044780: 7420 7468 6520 726f 6f74 2064 6576 6963 t the root devic │ │ │ │ │ -00044790: 6520 746f 0a20 2020 2020 7468 6520 726f e to. the ro │ │ │ │ │ -000447a0: 6f74 206f 6620 7468 6520 7375 7070 6c69 ot of the suppli │ │ │ │ │ -000447b0: 6564 2066 696c 6520 7379 7374 656d 2e0a ed file system.. │ │ │ │ │ -000447c0: 0a20 2020 2020 4966 2044 4556 4943 4520 . If DEVICE │ │ │ │ │ -000447d0: 6973 206a 7573 7420 6120 6e75 6d62 6572 is just a number │ │ │ │ │ -000447e0: 2c20 7468 656e 2069 7420 7769 6c6c 2062 , then it will b │ │ │ │ │ -000447f0: 6520 7472 6561 7465 6420 6173 2061 2070 e treated as a p │ │ │ │ │ -00044800: 6172 7469 7469 6f6e 0a20 2020 2020 6e75 artition. nu │ │ │ │ │ -00044810: 6d62 6572 2077 6974 6869 6e20 7468 6520 mber within the │ │ │ │ │ -00044820: 7375 7070 6c69 6564 2069 6d61 6765 2e20 supplied image. │ │ │ │ │ -00044830: 2054 6869 7320 6d65 616e 7320 7468 6174 This means that │ │ │ │ │ -00044840: 2c20 6966 2079 6f75 2068 6176 6520 616e , if you have an │ │ │ │ │ -00044850: 0a20 2020 2020 696d 6167 6520 6f66 2061 . image of a │ │ │ │ │ -00044860: 6e20 656e 7469 7265 2064 6973 6b20 696e n entire disk in │ │ │ │ │ -00044870: 2027 6469 736b 2e69 6d67 272c 2074 6865 'disk.img', the │ │ │ │ │ -00044880: 6e20 796f 7520 6361 6e20 7573 6520 7468 n you can use th │ │ │ │ │ -00044890: 6973 0a20 2020 2020 636f 6d6d 616e 6420 is. command │ │ │ │ │ -000448a0: 746f 206d 6f75 6e74 2069 7473 2073 6563 to mount its sec │ │ │ │ │ -000448b0: 6f6e 6420 7061 7274 6974 696f 6e3a 0a0a ond partition:.. │ │ │ │ │ -000448c0: 2020 2020 2020 2020 2020 6772 7562 2d6d grub-m │ │ │ │ │ -000448d0: 6f75 6e74 202d 7220 3220 6469 736b 2e69 ount -r 2 disk.i │ │ │ │ │ -000448e0: 6d67 206d 6f75 6e74 2d70 6f69 6e74 0a0a mg mount-point.. │ │ │ │ │ -000448f0: 272d 7627 0a27 2d2d 7665 7262 6f73 6527 '-v'.'--verbose' │ │ │ │ │ -00044900: 0a20 2020 2020 5072 696e 7420 7665 7262 . Print verb │ │ │ │ │ -00044910: 6f73 6520 6d65 7373 6167 6573 2e0a 0a1f ose messages.... │ │ │ │ │ -00044920: 0a46 696c 653a 2067 7275 622e 696e 666f .File: grub.info │ │ │ │ │ -00044930: 2c20 204e 6f64 653a 2049 6e76 6f6b 696e , Node: Invokin │ │ │ │ │ -00044940: 6720 6772 7562 2d70 726f 6265 2c20 204e g grub-probe, N │ │ │ │ │ -00044950: 6578 743a 2049 6e76 6f6b 696e 6720 6772 ext: Invoking gr │ │ │ │ │ -00044960: 7562 2d73 6372 6970 742d 6368 6563 6b2c ub-script-check, │ │ │ │ │ -00044970: 2020 5072 6576 3a20 496e 766f 6b69 6e67 Prev: Invoking │ │ │ │ │ -00044980: 2067 7275 622d 6d6f 756e 742c 2020 5570 grub-mount, Up │ │ │ │ │ -00044990: 3a20 546f 700a 0a32 3920 496e 766f 6b69 : Top..29 Invoki │ │ │ │ │ -000449a0: 6e67 2067 7275 622d 7072 6f62 650a 2a2a ng grub-probe.** │ │ │ │ │ +00043410: 2a2a 2a2a 2a0a 0a54 6865 2070 726f 6772 *****..The progr │ │ │ │ │ +00043420: 616d 2027 6772 7562 2d6d 6b72 656c 7061 am 'grub-mkrelpa │ │ │ │ │ +00043430: 7468 2720 6d61 6b65 7320 6120 6669 6c65 th' makes a file │ │ │ │ │ +00043440: 2073 7973 7465 6d20 7061 7468 2072 656c system path rel │ │ │ │ │ +00043450: 6174 6976 6520 746f 2074 6865 0a72 6f6f ative to the.roo │ │ │ │ │ +00043460: 7420 6f66 2069 7473 2063 6f6e 7461 696e t of its contain │ │ │ │ │ +00043470: 696e 6720 6669 6c65 2073 7973 7465 6d2e ing file system. │ │ │ │ │ +00043480: 2020 466f 7220 696e 7374 616e 6365 2c20 For instance, │ │ │ │ │ +00043490: 6966 2027 2f75 7372 2720 6973 2061 206d if '/usr' is a m │ │ │ │ │ +000434a0: 6f75 6e74 0a70 6f69 6e74 2c20 7468 656e ount.point, then │ │ │ │ │ +000434b0: 3a0a 0a20 2020 2020 2420 6772 7562 2d6d :.. $ grub-m │ │ │ │ │ +000434c0: 6b72 656c 7061 7468 202f 7573 722f 7368 krelpath /usr/sh │ │ │ │ │ +000434d0: 6172 652f 6772 7562 2f75 6e69 636f 6465 are/grub/unicode │ │ │ │ │ +000434e0: 2e70 6632 0a20 2020 2020 272f 7368 6172 .pf2. '/shar │ │ │ │ │ +000434f0: 652f 6772 7562 2f75 6e69 636f 6465 2e70 e/grub/unicode.p │ │ │ │ │ +00043500: 6632 270a 0a20 2020 5468 6973 2069 7320 f2'.. This is │ │ │ │ │ +00043510: 6d61 696e 6c79 2075 7365 6420 696e 7465 mainly used inte │ │ │ │ │ +00043520: 726e 616c 6c79 2062 7920 6f74 6865 7220 rnally by other │ │ │ │ │ +00043530: 4752 5542 2075 7469 6c69 7469 6573 2073 GRUB utilities s │ │ │ │ │ +00043540: 7563 6820 6173 0a27 6772 7562 2d6d 6b63 uch as.'grub-mkc │ │ │ │ │ +00043550: 6f6e 6669 6727 2028 2a6e 6f74 6520 496e onfig' (*note In │ │ │ │ │ +00043560: 766f 6b69 6e67 2067 7275 622d 6d6b 636f voking grub-mkco │ │ │ │ │ +00043570: 6e66 6967 3a3a 292c 2062 7574 206d 6179 nfig::), but may │ │ │ │ │ +00043580: 206f 6363 6173 696f 6e61 6c6c 790a 616c occasionally.al │ │ │ │ │ +00043590: 736f 2062 6520 7573 6566 756c 2066 6f72 so be useful for │ │ │ │ │ +000435a0: 2064 6562 7567 6769 6e67 2e0a 0a20 2020 debugging... │ │ │ │ │ +000435b0: 2767 7275 622d 6d6b 7265 6c70 6174 6827 'grub-mkrelpath' │ │ │ │ │ +000435c0: 2061 6363 6570 7473 2074 6865 2066 6f6c accepts the fol │ │ │ │ │ +000435d0: 6c6f 7769 6e67 206f 7074 696f 6e73 3a0a lowing options:. │ │ │ │ │ +000435e0: 0a27 2d2d 6865 6c70 270a 2020 2020 2050 .'--help'. P │ │ │ │ │ +000435f0: 7269 6e74 2061 2073 756d 6d61 7279 206f rint a summary o │ │ │ │ │ +00043600: 6620 7468 6520 636f 6d6d 616e 642d 6c69 f the command-li │ │ │ │ │ +00043610: 6e65 206f 7074 696f 6e73 2061 6e64 2065 ne options and e │ │ │ │ │ +00043620: 7869 742e 0a0a 272d 2d76 6572 7369 6f6e xit...'--version │ │ │ │ │ +00043630: 270a 2020 2020 2050 7269 6e74 2074 6865 '. Print the │ │ │ │ │ +00043640: 2076 6572 7369 6f6e 206e 756d 6265 7220 version number │ │ │ │ │ +00043650: 6f66 2047 5255 4220 616e 6420 6578 6974 of GRUB and exit │ │ │ │ │ +00043660: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00043670: 696e 666f 2c20 204e 6f64 653a 2049 6e76 info, Node: Inv │ │ │ │ │ +00043680: 6f6b 696e 6720 6772 7562 2d6d 6b72 6573 oking grub-mkres │ │ │ │ │ +00043690: 6375 652c 2020 4e65 7874 3a20 496e 766f cue, Next: Invo │ │ │ │ │ +000436a0: 6b69 6e67 2067 7275 622d 6d6f 756e 742c king grub-mount, │ │ │ │ │ +000436b0: 2020 5072 6576 3a20 496e 766f 6b69 6e67 Prev: Invoking │ │ │ │ │ +000436c0: 2067 7275 622d 6d6b 7265 6c70 6174 682c grub-mkrelpath, │ │ │ │ │ +000436d0: 2020 5570 3a20 546f 700a 0a32 3720 496e Up: Top..27 In │ │ │ │ │ +000436e0: 766f 6b69 6e67 2067 7275 622d 6d6b 7265 voking grub-mkre │ │ │ │ │ +000436f0: 7363 7565 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a scue.*********** │ │ │ │ │ +00043700: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ +00043710: 5468 6520 7072 6f67 7261 6d20 2767 7275 The program 'gru │ │ │ │ │ +00043720: 622d 6d6b 7265 7363 7565 2720 6765 6e65 b-mkrescue' gene │ │ │ │ │ +00043730: 7261 7465 7320 6120 626f 6f74 6162 6c65 rates a bootable │ │ │ │ │ +00043740: 2047 5255 4220 7265 7363 7565 2069 6d61 GRUB rescue ima │ │ │ │ │ +00043750: 6765 0a28 2a6e 6f74 6520 4d61 6b69 6e67 ge.(*note Making │ │ │ │ │ +00043760: 2061 2047 5255 4220 626f 6f74 6162 6c65 a GRUB bootable │ │ │ │ │ +00043770: 2043 442d 524f 4d3a 3a29 2e0a 0a20 2020 CD-ROM::)... │ │ │ │ │ +00043780: 2020 6772 7562 2d6d 6b72 6573 6375 6520 grub-mkrescue │ │ │ │ │ +00043790: 2d6f 2067 7275 622e 6973 6f0a 0a20 2020 -o grub.iso.. │ │ │ │ │ +000437a0: 416c 6c20 6172 6775 6d65 6e74 7320 6e6f All arguments no │ │ │ │ │ +000437b0: 7420 6578 706c 6963 6974 6c79 206c 6973 t explicitly lis │ │ │ │ │ +000437c0: 7465 6420 6173 2027 6772 7562 2d6d 6b72 ted as 'grub-mkr │ │ │ │ │ +000437d0: 6573 6375 6527 206f 7074 696f 6e73 2061 escue' options a │ │ │ │ │ +000437e0: 7265 0a70 6173 7365 6420 6f6e 2064 6972 re.passed on dir │ │ │ │ │ +000437f0: 6563 746c 7920 746f 2027 786f 7272 6973 ectly to 'xorris │ │ │ │ │ +00043800: 6f27 2069 6e20 276d 6b69 736f 6673 2720 o' in 'mkisofs' │ │ │ │ │ +00043810: 656d 756c 6174 696f 6e20 6d6f 6465 2e20 emulation mode. │ │ │ │ │ +00043820: 204f 7074 696f 6e73 0a70 6173 7365 6420 Options.passed │ │ │ │ │ +00043830: 746f 2027 786f 7272 6973 6f27 2077 696c to 'xorriso' wil │ │ │ │ │ +00043840: 6c20 6e6f 726d 616c 6c79 2062 6520 696e l normally be in │ │ │ │ │ +00043850: 7465 7270 7265 7465 6420 6173 2027 6d6b terpreted as 'mk │ │ │ │ │ +00043860: 6973 6f66 7327 206f 7074 696f 6e73 3b0a isofs' options;. │ │ │ │ │ +00043870: 6966 2074 6865 206f 7074 696f 6e20 272d if the option '- │ │ │ │ │ +00043880: 2d27 2069 7320 7573 6564 2c20 7468 656e -' is used, then │ │ │ │ │ +00043890: 2061 6e79 7468 696e 6720 6166 7465 7220 anything after │ │ │ │ │ +000438a0: 7468 6174 2077 696c 6c20 6265 2069 6e74 that will be int │ │ │ │ │ +000438b0: 6572 7072 6574 6564 0a61 7320 6e61 7469 erpreted.as nati │ │ │ │ │ +000438c0: 7665 2027 786f 7272 6973 6f27 206f 7074 ve 'xorriso' opt │ │ │ │ │ +000438d0: 696f 6e73 2e0a 0a20 2020 4e6f 6e2d 6f70 ions... Non-op │ │ │ │ │ +000438e0: 7469 6f6e 2061 7267 756d 656e 7473 2073 tion arguments s │ │ │ │ │ +000438f0: 7065 6369 6679 2061 6464 6974 696f 6e61 pecify additiona │ │ │ │ │ +00043900: 6c20 736f 7572 6365 2064 6972 6563 746f l source directo │ │ │ │ │ +00043910: 7269 6573 2e20 2054 6869 7320 6973 0a63 ries. This is.c │ │ │ │ │ +00043920: 6f6d 6d6f 6e6c 7920 7573 6564 2074 6f20 ommonly used to │ │ │ │ │ +00043930: 6164 6420 6578 7472 6120 6669 6c65 7320 add extra files │ │ │ │ │ +00043940: 746f 2074 6865 2069 6d61 6765 3a0a 0a20 to the image:.. │ │ │ │ │ +00043950: 2020 2020 6d6b 6469 7220 2d70 2064 6973 mkdir -p dis │ │ │ │ │ +00043960: 6b2f 626f 6f74 2f67 7275 620a 2020 2020 k/boot/grub. │ │ │ │ │ +00043970: 2028 6164 6420 6578 7472 6120 6669 6c65 (add extra file │ │ │ │ │ +00043980: 7320 746f 2027 6469 736b 2f62 6f6f 742f s to 'disk/boot/ │ │ │ │ │ +00043990: 6772 7562 2729 0a20 2020 2020 6772 7562 grub'). grub │ │ │ │ │ +000439a0: 2d6d 6b72 6573 6375 6520 2d6f 2067 7275 -mkrescue -o gru │ │ │ │ │ +000439b0: 622e 6973 6f20 6469 736b 0a0a 2020 2027 b.iso disk.. ' │ │ │ │ │ +000439c0: 6772 7562 2d6d 6b72 6573 6375 6527 2061 grub-mkrescue' a │ │ │ │ │ +000439d0: 6363 6570 7473 2074 6865 2066 6f6c 6c6f ccepts the follo │ │ │ │ │ +000439e0: 7769 6e67 206f 7074 696f 6e73 3a0a 0a27 wing options:..' │ │ │ │ │ +000439f0: 2d2d 6865 6c70 270a 2020 2020 2050 7269 --help'. Pri │ │ │ │ │ +00043a00: 6e74 2061 2073 756d 6d61 7279 206f 6620 nt a summary of │ │ │ │ │ +00043a10: 7468 6520 636f 6d6d 616e 642d 6c69 6e65 the command-line │ │ │ │ │ +00043a20: 206f 7074 696f 6e73 2061 6e64 2065 7869 options and exi │ │ │ │ │ +00043a30: 742e 0a0a 272d 2d76 6572 7369 6f6e 270a t...'--version'. │ │ │ │ │ +00043a40: 2020 2020 2050 7269 6e74 2074 6865 2076 Print the v │ │ │ │ │ +00043a50: 6572 7369 6f6e 206e 756d 6265 7220 6f66 ersion number of │ │ │ │ │ +00043a60: 2047 5255 4220 616e 6420 6578 6974 2e0a GRUB and exit.. │ │ │ │ │ +00043a70: 0a27 2d6f 2046 494c 4527 0a27 2d2d 6f75 .'-o FILE'.'--ou │ │ │ │ │ +00043a80: 7470 7574 3d46 494c 4527 0a20 2020 2020 tput=FILE'. │ │ │ │ │ +00043a90: 5361 7665 206f 7574 7075 7420 696e 2046 Save output in F │ │ │ │ │ +00043aa0: 494c 452e 2020 5468 6973 2022 6f70 7469 ILE. This "opti │ │ │ │ │ +00043ab0: 6f6e 2220 6973 2072 6571 7569 7265 642e on" is required. │ │ │ │ │ +00043ac0: 0a0a 272d 2d6d 6f64 756c 6573 3d4d 4f44 ..'--modules=MOD │ │ │ │ │ +00043ad0: 554c 4553 270a 2020 2020 2050 7265 2d6c ULES'. Pre-l │ │ │ │ │ +00043ae0: 6f61 6420 7468 6520 6e61 6d65 6420 4752 oad the named GR │ │ │ │ │ +00043af0: 5542 206d 6f64 756c 6573 2069 6e20 7468 UB modules in th │ │ │ │ │ +00043b00: 6520 696d 6167 652e 2020 4d75 6c74 6970 e image. Multip │ │ │ │ │ +00043b10: 6c65 2065 6e74 7269 6573 2069 6e0a 2020 le entries in. │ │ │ │ │ +00043b20: 2020 204d 4f44 554c 4553 2073 686f 756c MODULES shoul │ │ │ │ │ +00043b30: 6420 6265 2073 6570 6172 6174 6564 2062 d be separated b │ │ │ │ │ +00043b40: 7920 7768 6974 6573 7061 6365 2028 736f y whitespace (so │ │ │ │ │ +00043b50: 2079 6f75 2077 696c 6c20 7072 6f62 6162 you will probab │ │ │ │ │ +00043b60: 6c79 0a20 2020 2020 6e65 6564 2074 6f20 ly. need to │ │ │ │ │ +00043b70: 7175 6f74 6520 7468 6973 2066 6f72 2079 quote this for y │ │ │ │ │ +00043b80: 6f75 7220 7368 656c 6c29 2e0a 0a27 2d2d our shell)...'-- │ │ │ │ │ +00043b90: 726f 6d2d 6469 7265 6374 6f72 793d 4449 rom-directory=DI │ │ │ │ │ +00043ba0: 5227 0a20 2020 2020 4966 2067 656e 6572 R'. If gener │ │ │ │ │ +00043bb0: 6174 696e 6720 696d 6167 6573 2066 6f72 ating images for │ │ │ │ │ +00043bc0: 2074 6865 2051 454d 5520 6f72 2043 6f72 the QEMU or Cor │ │ │ │ │ +00043bd0: 6562 6f6f 7420 706c 6174 666f 726d 732c eboot platforms, │ │ │ │ │ +00043be0: 2063 6f70 7920 7468 650a 2020 2020 2072 copy the. r │ │ │ │ │ +00043bf0: 6573 756c 7469 6e67 2027 7165 6d75 2e69 esulting 'qemu.i │ │ │ │ │ +00043c00: 6d67 2720 6f72 2027 636f 7265 626f 6f74 mg' or 'coreboot │ │ │ │ │ +00043c10: 2e65 6c66 2720 6669 6c65 7320 7265 7370 .elf' files resp │ │ │ │ │ +00043c20: 6563 7469 7665 6c79 2074 6f20 7468 650a ectively to the. │ │ │ │ │ +00043c30: 2020 2020 2044 4952 2064 6972 6563 746f DIR directo │ │ │ │ │ +00043c40: 7279 2061 7320 7765 6c6c 2061 7320 696e ry as well as in │ │ │ │ │ +00043c50: 636c 7564 696e 6720 7468 656d 2069 6e20 cluding them in │ │ │ │ │ +00043c60: 7468 6520 696d 6167 652e 0a0a 272d 2d78 the image...'--x │ │ │ │ │ +00043c70: 6f72 7269 736f 3d46 494c 4527 0a20 2020 orriso=FILE'. │ │ │ │ │ +00043c80: 2020 5573 6520 4649 4c45 2061 7320 7468 Use FILE as th │ │ │ │ │ +00043c90: 6520 2778 6f72 7269 736f 2720 7072 6f67 e 'xorriso' prog │ │ │ │ │ +00043ca0: 7261 6d2c 2072 6174 6865 7220 7468 616e ram, rather than │ │ │ │ │ +00043cb0: 2074 6865 2062 7569 6c74 2d69 6e0a 2020 the built-in. │ │ │ │ │ +00043cc0: 2020 2064 6566 6175 6c74 2e0a 0a27 2d2d default...'-- │ │ │ │ │ +00043cd0: 6772 7562 2d6d 6b69 6d61 6765 3d46 494c grub-mkimage=FIL │ │ │ │ │ +00043ce0: 4527 0a20 2020 2020 5573 6520 4649 4c45 E'. Use FILE │ │ │ │ │ +00043cf0: 2061 7320 7468 6520 2767 7275 622d 6d6b as the 'grub-mk │ │ │ │ │ +00043d00: 696d 6167 6527 2070 726f 6772 616d 2c20 image' program, │ │ │ │ │ +00043d10: 7261 7468 6572 2074 6861 6e20 7468 6520 rather than the │ │ │ │ │ +00043d20: 6275 696c 742d 696e 0a20 2020 2020 6465 built-in. de │ │ │ │ │ +00043d30: 6661 756c 742e 0a0a 1f0a 4669 6c65 3a20 fault.....File: │ │ │ │ │ +00043d40: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ +00043d50: 3a20 496e 766f 6b69 6e67 2067 7275 622d : Invoking grub- │ │ │ │ │ +00043d60: 6d6f 756e 742c 2020 4e65 7874 3a20 496e mount, Next: In │ │ │ │ │ +00043d70: 766f 6b69 6e67 2067 7275 622d 7072 6f62 voking grub-prob │ │ │ │ │ +00043d80: 652c 2020 5072 6576 3a20 496e 766f 6b69 e, Prev: Invoki │ │ │ │ │ +00043d90: 6e67 2067 7275 622d 6d6b 7265 7363 7565 ng grub-mkrescue │ │ │ │ │ +00043da0: 2c20 2055 703a 2054 6f70 0a0a 3238 2049 , Up: Top..28 I │ │ │ │ │ +00043db0: 6e76 6f6b 696e 6720 6772 7562 2d6d 6f75 nvoking grub-mou │ │ │ │ │ +00043dc0: 6e74 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a nt.************* │ │ │ │ │ +00043dd0: 2a2a 2a2a 2a2a 2a2a 2a0a 0a54 6865 2070 *********..The p │ │ │ │ │ +00043de0: 726f 6772 616d 2027 6772 7562 2d6d 6f75 rogram 'grub-mou │ │ │ │ │ +00043df0: 6e74 2720 7065 7266 6f72 6d73 2061 2072 nt' performs a r │ │ │ │ │ +00043e00: 6561 642d 6f6e 6c79 206d 6f75 6e74 206f ead-only mount o │ │ │ │ │ +00043e10: 6620 616e 7920 6669 6c65 2073 7973 7465 f any file syste │ │ │ │ │ +00043e20: 6d0a 6f72 2066 696c 6520 7379 7374 656d m.or file system │ │ │ │ │ +00043e30: 2069 6d61 6765 2074 6861 7420 4752 5542 image that GRUB │ │ │ │ │ +00043e40: 2075 6e64 6572 7374 616e 6473 2c20 7573 understands, us │ │ │ │ │ +00043e50: 696e 6720 4752 5542 2773 2066 696c 6520 ing GRUB's file │ │ │ │ │ +00043e60: 7379 7374 656d 0a64 7269 7665 7273 2076 system.drivers v │ │ │ │ │ +00043e70: 6961 2046 5553 452e 2028 4974 2069 7320 ia FUSE. (It is │ │ │ │ │ +00043e80: 6f6e 6c79 2061 7661 696c 6162 6c65 2069 only available i │ │ │ │ │ +00043e90: 6620 4655 5345 2064 6576 656c 6f70 6d65 f FUSE developme │ │ │ │ │ +00043ea0: 6e74 2066 696c 6573 2077 6572 650a 7072 nt files were.pr │ │ │ │ │ +00043eb0: 6573 656e 7420 7768 656e 2047 5255 4220 esent when GRUB │ │ │ │ │ +00043ec0: 7761 7320 6275 696c 742e 2920 2054 6869 was built.) Thi │ │ │ │ │ +00043ed0: 7320 6861 7320 6120 6e75 6d62 6572 206f s has a number o │ │ │ │ │ +00043ee0: 6620 7573 6573 3a0a 0a20 2020 2a20 4974 f uses:.. * It │ │ │ │ │ +00043ef0: 2070 726f 7669 6465 7320 6120 636f 6e76 provides a conv │ │ │ │ │ +00043f00: 656e 6965 6e74 2077 6179 2074 6f20 6368 enient way to ch │ │ │ │ │ +00043f10: 6563 6b20 686f 7720 4752 5542 2077 696c eck how GRUB wil │ │ │ │ │ +00043f20: 6c20 7669 6577 2061 2066 696c 650a 2020 l view a file. │ │ │ │ │ +00043f30: 2020 2073 7973 7465 6d20 6174 2062 6f6f system at boo │ │ │ │ │ +00043f40: 7420 7469 6d65 2e20 2059 6f75 2063 616e t time. You can │ │ │ │ │ +00043f50: 2075 7365 206e 6f72 6d61 6c20 636f 6d6d use normal comm │ │ │ │ │ +00043f60: 616e 642d 6c69 6e65 2074 6f6f 6c73 2074 and-line tools t │ │ │ │ │ +00043f70: 6f0a 2020 2020 2063 6f6d 7061 7265 2074 o. compare t │ │ │ │ │ +00043f80: 6861 7420 7669 6577 2077 6974 6820 7468 hat view with th │ │ │ │ │ +00043f90: 6174 206f 6620 796f 7572 206f 7065 7261 at of your opera │ │ │ │ │ +00043fa0: 7469 6e67 2073 7973 7465 6d2c 206d 616b ting system, mak │ │ │ │ │ +00043fb0: 696e 6720 6974 0a20 2020 2020 6561 7379 ing it. easy │ │ │ │ │ +00043fc0: 2074 6f20 6669 6e64 2062 7567 732e 0a0a to find bugs... │ │ │ │ │ +00043fd0: 2020 202a 2049 7420 6f66 6665 7273 2074 * It offers t │ │ │ │ │ +00043fe0: 7275 6520 7265 6164 2d6f 6e6c 7920 6d6f rue read-only mo │ │ │ │ │ +00043ff0: 756e 7473 2e20 204c 696e 7578 2064 6f65 unts. Linux doe │ │ │ │ │ +00044000: 7320 6e6f 7420 6861 7665 2074 6865 7365 s not have these │ │ │ │ │ +00044010: 2066 6f72 0a20 2020 2020 6a6f 7572 6e61 for. journa │ │ │ │ │ +00044020: 6c6c 696e 6720 6669 6c65 2073 7973 7465 lling file syste │ │ │ │ │ +00044030: 6d73 2c20 6265 6361 7573 6520 6974 2077 ms, because it w │ │ │ │ │ +00044040: 696c 6c20 616c 7761 7973 2061 7474 656d ill always attem │ │ │ │ │ +00044050: 7074 2074 6f20 7265 706c 6179 0a20 2020 pt to replay. │ │ │ │ │ +00044060: 2020 7468 6520 6a6f 7572 6e61 6c20 6174 the journal at │ │ │ │ │ +00044070: 206d 6f75 6e74 2074 696d 653b 2077 6869 mount time; whi │ │ │ │ │ +00044080: 6c65 2079 6f75 2063 616e 2074 656d 706f le you can tempo │ │ │ │ │ +00044090: 7261 7269 6c79 206d 6172 6b20 7468 6520 rarily mark the │ │ │ │ │ +000440a0: 626c 6f63 6b0a 2020 2020 2064 6576 6963 block. devic │ │ │ │ │ +000440b0: 6520 7265 6164 2d6f 6e6c 7920 746f 2061 e read-only to a │ │ │ │ │ +000440c0: 766f 6964 2074 6869 732c 2074 6861 7420 void this, that │ │ │ │ │ +000440d0: 6361 7573 6573 2074 6865 206d 6f75 6e74 causes the mount │ │ │ │ │ +000440e0: 2074 6f20 6661 696c 2e0a 2020 2020 2053 to fail.. S │ │ │ │ │ +000440f0: 696e 6365 2047 5255 4220 696e 7465 6e74 ince GRUB intent │ │ │ │ │ +00044100: 696f 6e61 6c6c 7920 636f 6e74 6169 6e73 ionally contains │ │ │ │ │ +00044110: 206e 6f20 636f 6465 2066 6f72 2077 7269 no code for wri │ │ │ │ │ +00044120: 7469 6e67 2074 6f20 6669 6c65 0a20 2020 ting to file. │ │ │ │ │ +00044130: 2020 7379 7374 656d 732c 2069 7420 6361 systems, it ca │ │ │ │ │ +00044140: 6e20 6561 7369 6c79 2070 726f 7669 6465 n easily provide │ │ │ │ │ +00044150: 2061 2067 7561 7261 6e74 6565 6420 7265 a guaranteed re │ │ │ │ │ +00044160: 6164 2d6f 6e6c 7920 6d6f 756e 740a 2020 ad-only mount. │ │ │ │ │ +00044170: 2020 206d 6563 6861 6e69 736d 2e0a 0a20 mechanism... │ │ │ │ │ +00044180: 2020 2a20 4974 2061 6c6c 6f77 7320 796f * It allows yo │ │ │ │ │ +00044190: 7520 746f 2065 7861 6d69 6e65 2061 6e79 u to examine any │ │ │ │ │ +000441a0: 2066 696c 6520 7379 7374 656d 2074 6861 file system tha │ │ │ │ │ +000441b0: 7420 4752 5542 2075 6e64 6572 7374 616e t GRUB understan │ │ │ │ │ +000441c0: 6473 0a20 2020 2020 7769 7468 6f75 7420 ds. without │ │ │ │ │ +000441d0: 6e65 6564 696e 6720 746f 206c 6f61 6420 needing to load │ │ │ │ │ +000441e0: 6164 6469 7469 6f6e 616c 206d 6f64 756c additional modul │ │ │ │ │ +000441f0: 6573 2069 6e74 6f20 796f 7572 2072 756e es into your run │ │ │ │ │ +00044200: 6e69 6e67 0a20 2020 2020 6b65 726e 656c ning. kernel │ │ │ │ │ +00044210: 2c20 7768 6963 6820 6d61 7920 6265 2075 , which may be u │ │ │ │ │ +00044220: 7365 6675 6c20 696e 2063 6f6e 7374 7261 seful in constra │ │ │ │ │ +00044230: 696e 6564 2065 6e76 6972 6f6e 6d65 6e74 ined environment │ │ │ │ │ +00044240: 7320 7375 6368 2061 730a 2020 2020 2069 s such as. i │ │ │ │ │ +00044250: 6e73 7461 6c6c 6572 732e 0a0a 2020 202a nstallers... * │ │ │ │ │ +00044260: 2053 696e 6365 2069 7420 6361 6e20 6578 Since it can ex │ │ │ │ │ +00044270: 616d 696e 6520 6669 6c65 2073 7973 7465 amine file syste │ │ │ │ │ +00044280: 6d20 696d 6167 6573 2028 636f 6e74 6169 m images (contai │ │ │ │ │ +00044290: 6e65 6420 696e 2072 6567 756c 6172 0a20 ned in regular. │ │ │ │ │ +000442a0: 2020 2020 6669 6c65 7329 206a 7573 7420 files) just │ │ │ │ │ +000442b0: 6173 2065 6173 696c 7920 6173 2066 696c as easily as fil │ │ │ │ │ +000442c0: 6520 7379 7374 656d 7320 6f6e 2062 6c6f e systems on blo │ │ │ │ │ +000442d0: 636b 2064 6576 6963 6573 2c20 796f 7520 ck devices, you │ │ │ │ │ +000442e0: 6361 6e20 7573 650a 2020 2020 2069 7420 can use. it │ │ │ │ │ +000442f0: 746f 2069 6e73 7065 6374 2061 6e79 2066 to inspect any f │ │ │ │ │ +00044300: 696c 6520 7379 7374 656d 2069 6d61 6765 ile system image │ │ │ │ │ +00044310: 2074 6861 7420 4752 5542 2075 6e64 6572 that GRUB under │ │ │ │ │ +00044320: 7374 616e 6473 2077 6974 6820 6f6e 6c79 stands with only │ │ │ │ │ +00044330: 0a20 2020 2020 656e 6f75 6768 2070 7269 . enough pri │ │ │ │ │ +00044340: 7669 6c65 6765 7320 746f 2075 7365 2046 vileges to use F │ │ │ │ │ +00044350: 5553 452c 2065 7665 6e20 6966 206e 6f62 USE, even if nob │ │ │ │ │ +00044360: 6f64 7920 6861 7320 7965 7420 7772 6974 ody has yet writ │ │ │ │ │ +00044370: 7465 6e20 610a 2020 2020 2046 5553 4520 ten a. FUSE │ │ │ │ │ +00044380: 6d6f 6475 6c65 2073 7065 6369 6669 6361 module specifica │ │ │ │ │ +00044390: 6c6c 7920 666f 7220 7468 6174 2066 696c lly for that fil │ │ │ │ │ +000443a0: 6520 7379 7374 656d 2074 7970 652e 0a0a e system type... │ │ │ │ │ +000443b0: 2020 2055 7369 6e67 2027 6772 7562 2d6d Using 'grub-m │ │ │ │ │ +000443c0: 6f75 6e74 2720 6973 206e 6f72 6d61 6c6c ount' is normall │ │ │ │ │ +000443d0: 7920 6173 2073 696d 706c 6520 6173 3a0a y as simple as:. │ │ │ │ │ +000443e0: 0a20 2020 2020 6772 7562 2d6d 6f75 6e74 . grub-mount │ │ │ │ │ +000443f0: 202f 6465 762f 7364 6131 202f 6d6e 740a /dev/sda1 /mnt. │ │ │ │ │ +00044400: 0a20 2020 2767 7275 622d 6d6f 756e 7427 . 'grub-mount' │ │ │ │ │ +00044410: 206d 7573 7420 6265 2067 6976 656e 206f must be given o │ │ │ │ │ +00044420: 6e65 206f 7220 6d6f 7265 2069 6d61 6765 ne or more image │ │ │ │ │ +00044430: 7320 616e 6420 6120 6d6f 756e 7420 706f s and a mount po │ │ │ │ │ +00044440: 696e 7420 6173 0a6e 6f6e 2d6f 7074 696f int as.non-optio │ │ │ │ │ +00044450: 6e20 6172 6775 6d65 6e74 7320 2869 6620 n arguments (if │ │ │ │ │ +00044460: 6974 2069 7320 6769 7665 6e20 6d6f 7265 it is given more │ │ │ │ │ +00044470: 2074 6861 6e20 6f6e 6520 696d 6167 652c than one image, │ │ │ │ │ +00044480: 2069 7420 7769 6c6c 2074 7265 6174 0a74 it will treat.t │ │ │ │ │ +00044490: 6865 6d20 6173 2061 2052 4149 4420 7365 hem as a RAID se │ │ │ │ │ +000444a0: 7429 2c20 616e 6420 616c 736f 2061 6363 t), and also acc │ │ │ │ │ +000444b0: 6570 7473 2074 6865 2066 6f6c 6c6f 7769 epts the followi │ │ │ │ │ +000444c0: 6e67 206f 7074 696f 6e73 3a0a 0a27 2d2d ng options:..'-- │ │ │ │ │ +000444d0: 6865 6c70 270a 2020 2020 2050 7269 6e74 help'. Print │ │ │ │ │ +000444e0: 2061 2073 756d 6d61 7279 206f 6620 7468 a summary of th │ │ │ │ │ +000444f0: 6520 636f 6d6d 616e 642d 6c69 6e65 206f e command-line o │ │ │ │ │ +00044500: 7074 696f 6e73 2061 6e64 2065 7869 742e ptions and exit. │ │ │ │ │ +00044510: 0a0a 272d 2d76 6572 7369 6f6e 270a 2020 ..'--version'. │ │ │ │ │ +00044520: 2020 2050 7269 6e74 2074 6865 2076 6572 Print the ver │ │ │ │ │ +00044530: 7369 6f6e 206e 756d 6265 7220 6f66 2047 sion number of G │ │ │ │ │ +00044540: 5255 4220 616e 6420 6578 6974 2e0a 0a27 RUB and exit...' │ │ │ │ │ +00044550: 2d43 270a 272d 2d63 7279 7074 6f27 0a20 -C'.'--crypto'. │ │ │ │ │ +00044560: 2020 2020 4d6f 756e 7420 656e 6372 7970 Mount encryp │ │ │ │ │ +00044570: 7465 6420 6465 7669 6365 732c 2070 726f ted devices, pro │ │ │ │ │ +00044580: 6d70 7469 6e67 2066 6f72 2061 2070 6173 mpting for a pas │ │ │ │ │ +00044590: 7370 6872 6173 6520 6966 206e 6563 6573 sphrase if neces │ │ │ │ │ +000445a0: 7361 7279 2e0a 0a27 2d64 2053 5452 494e sary...'-d STRIN │ │ │ │ │ +000445b0: 4727 0a27 2d2d 6465 6275 673d 5354 5249 G'.'--debug=STRI │ │ │ │ │ +000445c0: 4e47 270a 2020 2020 2053 686f 7720 6465 NG'. Show de │ │ │ │ │ +000445d0: 6275 6767 696e 6720 6f75 7470 7574 2066 bugging output f │ │ │ │ │ +000445e0: 6f72 2063 6f6e 6469 7469 6f6e 7320 6d61 or conditions ma │ │ │ │ │ +000445f0: 7463 6869 6e67 2053 5452 494e 472e 0a0a tching STRING... │ │ │ │ │ +00044600: 272d 4b20 7072 6f6d 7074 7c46 494c 4527 '-K prompt|FILE' │ │ │ │ │ +00044610: 0a27 2d2d 7a66 732d 6b65 793d 7072 6f6d .'--zfs-key=prom │ │ │ │ │ +00044620: 7074 7c46 494c 4527 0a20 2020 2020 4c6f pt|FILE'. Lo │ │ │ │ │ +00044630: 6164 2061 205a 4653 2065 6e63 7279 7074 ad a ZFS encrypt │ │ │ │ │ +00044640: 696f 6e20 6b65 792e 2020 4966 2079 6f75 ion key. If you │ │ │ │ │ +00044650: 2075 7365 2027 7072 6f6d 7074 2720 6173 use 'prompt' as │ │ │ │ │ +00044660: 2074 6865 2061 7267 756d 656e 742c 0a20 the argument,. │ │ │ │ │ +00044670: 2020 2020 2767 7275 622d 6d6f 756e 7427 'grub-mount' │ │ │ │ │ +00044680: 2077 696c 6c20 7265 6164 2061 2070 6173 will read a pas │ │ │ │ │ +00044690: 7370 6872 6173 6520 6672 6f6d 2074 6865 sphrase from the │ │ │ │ │ +000446a0: 2074 6572 6d69 6e61 6c3b 206f 7468 6572 terminal; other │ │ │ │ │ +000446b0: 7769 7365 2c0a 2020 2020 2069 7420 7769 wise,. it wi │ │ │ │ │ +000446c0: 6c6c 2072 6561 6420 6b65 7920 6d61 7465 ll read key mate │ │ │ │ │ +000446d0: 7269 616c 2066 726f 6d20 7468 6520 7370 rial from the sp │ │ │ │ │ +000446e0: 6563 6966 6965 6420 6669 6c65 2e0a 0a27 ecified file...' │ │ │ │ │ +000446f0: 2d72 2044 4556 4943 4527 0a27 2d2d 726f -r DEVICE'.'--ro │ │ │ │ │ +00044700: 6f74 3d44 4556 4943 4527 0a20 2020 2020 ot=DEVICE'. │ │ │ │ │ +00044710: 5365 7420 7468 6520 4752 5542 2072 6f6f Set the GRUB roo │ │ │ │ │ +00044720: 7420 6465 7669 6365 2074 6f20 4445 5649 t device to DEVI │ │ │ │ │ +00044730: 4345 2e20 2059 6f75 2064 6f20 6e6f 7420 CE. You do not │ │ │ │ │ +00044740: 6e6f 726d 616c 6c79 206e 6565 6420 746f normally need to │ │ │ │ │ +00044750: 0a20 2020 2020 7365 7420 7468 6973 3b20 . set this; │ │ │ │ │ +00044760: 2767 7275 622d 6d6f 756e 7427 2077 696c 'grub-mount' wil │ │ │ │ │ +00044770: 6c20 6175 746f 6d61 7469 6361 6c6c 7920 l automatically │ │ │ │ │ +00044780: 7365 7420 7468 6520 726f 6f74 2064 6576 set the root dev │ │ │ │ │ +00044790: 6963 6520 746f 0a20 2020 2020 7468 6520 ice to. the │ │ │ │ │ +000447a0: 726f 6f74 206f 6620 7468 6520 7375 7070 root of the supp │ │ │ │ │ +000447b0: 6c69 6564 2066 696c 6520 7379 7374 656d lied file system │ │ │ │ │ +000447c0: 2e0a 0a20 2020 2020 4966 2044 4556 4943 ... If DEVIC │ │ │ │ │ +000447d0: 4520 6973 206a 7573 7420 6120 6e75 6d62 E is just a numb │ │ │ │ │ +000447e0: 6572 2c20 7468 656e 2069 7420 7769 6c6c er, then it will │ │ │ │ │ +000447f0: 2062 6520 7472 6561 7465 6420 6173 2061 be treated as a │ │ │ │ │ +00044800: 2070 6172 7469 7469 6f6e 0a20 2020 2020 partition. │ │ │ │ │ +00044810: 6e75 6d62 6572 2077 6974 6869 6e20 7468 number within th │ │ │ │ │ +00044820: 6520 7375 7070 6c69 6564 2069 6d61 6765 e supplied image │ │ │ │ │ +00044830: 2e20 2054 6869 7320 6d65 616e 7320 7468 . This means th │ │ │ │ │ +00044840: 6174 2c20 6966 2079 6f75 2068 6176 6520 at, if you have │ │ │ │ │ +00044850: 616e 0a20 2020 2020 696d 6167 6520 6f66 an. image of │ │ │ │ │ +00044860: 2061 6e20 656e 7469 7265 2064 6973 6b20 an entire disk │ │ │ │ │ +00044870: 696e 2027 6469 736b 2e69 6d67 272c 2074 in 'disk.img', t │ │ │ │ │ +00044880: 6865 6e20 796f 7520 6361 6e20 7573 6520 hen you can use │ │ │ │ │ +00044890: 7468 6973 0a20 2020 2020 636f 6d6d 616e this. comman │ │ │ │ │ +000448a0: 6420 746f 206d 6f75 6e74 2069 7473 2073 d to mount its s │ │ │ │ │ +000448b0: 6563 6f6e 6420 7061 7274 6974 696f 6e3a econd partition: │ │ │ │ │ +000448c0: 0a0a 2020 2020 2020 2020 2020 6772 7562 .. grub │ │ │ │ │ +000448d0: 2d6d 6f75 6e74 202d 7220 3220 6469 736b -mount -r 2 disk │ │ │ │ │ +000448e0: 2e69 6d67 206d 6f75 6e74 2d70 6f69 6e74 .img mount-point │ │ │ │ │ +000448f0: 0a0a 272d 7627 0a27 2d2d 7665 7262 6f73 ..'-v'.'--verbos │ │ │ │ │ +00044900: 6527 0a20 2020 2020 5072 696e 7420 7665 e'. Print ve │ │ │ │ │ +00044910: 7262 6f73 6520 6d65 7373 6167 6573 2e0a rbose messages.. │ │ │ │ │ +00044920: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ +00044930: 666f 2c20 204e 6f64 653a 2049 6e76 6f6b fo, Node: Invok │ │ │ │ │ +00044940: 696e 6720 6772 7562 2d70 726f 6265 2c20 ing grub-probe, │ │ │ │ │ +00044950: 204e 6578 743a 2049 6e76 6f6b 696e 6720 Next: Invoking │ │ │ │ │ +00044960: 6772 7562 2d73 6372 6970 742d 6368 6563 grub-script-chec │ │ │ │ │ +00044970: 6b2c 2020 5072 6576 3a20 496e 766f 6b69 k, Prev: Invoki │ │ │ │ │ +00044980: 6e67 2067 7275 622d 6d6f 756e 742c 2020 ng grub-mount, │ │ │ │ │ +00044990: 5570 3a20 546f 700a 0a32 3920 496e 766f Up: Top..29 Invo │ │ │ │ │ +000449a0: 6b69 6e67 2067 7275 622d 7072 6f62 650a king grub-probe. │ │ │ │ │ 000449b0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000449c0: 2a2a 2a2a 0a0a 5468 6520 7072 6f67 7261 ****..The progra │ │ │ │ │ -000449d0: 6d20 2767 7275 622d 7072 6f62 6527 2070 m 'grub-probe' p │ │ │ │ │ -000449e0: 726f 6265 7320 6465 7669 6365 2069 6e66 robes device inf │ │ │ │ │ -000449f0: 6f72 6d61 7469 6f6e 2066 6f72 2061 2067 ormation for a g │ │ │ │ │ -00044a00: 6976 656e 2070 6174 6820 6f72 0a64 6576 iven path or.dev │ │ │ │ │ -00044a10: 6963 652e 0a0a 2020 2020 2067 7275 622d ice... grub- │ │ │ │ │ -00044a20: 7072 6f62 6520 2d2d 7461 7267 6574 3d66 probe --target=f │ │ │ │ │ -00044a30: 7320 2f62 6f6f 742f 6772 7562 0a20 2020 s /boot/grub. │ │ │ │ │ -00044a40: 2020 6772 7562 2d70 726f 6265 202d 2d74 grub-probe --t │ │ │ │ │ -00044a50: 6172 6765 743d 6472 6976 6520 2d2d 6465 arget=drive --de │ │ │ │ │ -00044a60: 7669 6365 202f 6465 762f 7364 6131 0a0a vice /dev/sda1.. │ │ │ │ │ -00044a70: 2020 2027 6772 7562 2d70 726f 6265 2720 'grub-probe' │ │ │ │ │ -00044a80: 6d75 7374 2062 6520 6769 7665 6e20 6120 must be given a │ │ │ │ │ -00044a90: 7061 7468 206f 7220 6465 7669 6365 2061 path or device a │ │ │ │ │ -00044aa0: 7320 6120 6e6f 6e2d 6f70 7469 6f6e 2061 s a non-option a │ │ │ │ │ -00044ab0: 7267 756d 656e 742c 0a61 6e64 2061 6c73 rgument,.and als │ │ │ │ │ -00044ac0: 6f20 6163 6365 7074 7320 7468 6520 666f o accepts the fo │ │ │ │ │ -00044ad0: 6c6c 6f77 696e 6720 6f70 7469 6f6e 733a llowing options: │ │ │ │ │ -00044ae0: 0a0a 272d 2d68 656c 7027 0a20 2020 2020 ..'--help'. │ │ │ │ │ -00044af0: 5072 696e 7420 6120 7375 6d6d 6172 7920 Print a summary │ │ │ │ │ -00044b00: 6f66 2074 6865 2063 6f6d 6d61 6e64 2d6c of the command-l │ │ │ │ │ -00044b10: 696e 6520 6f70 7469 6f6e 7320 616e 6420 ine options and │ │ │ │ │ -00044b20: 6578 6974 2e0a 0a27 2d2d 7665 7273 696f exit...'--versio │ │ │ │ │ -00044b30: 6e27 0a20 2020 2020 5072 696e 7420 7468 n'. Print th │ │ │ │ │ -00044b40: 6520 7665 7273 696f 6e20 6e75 6d62 6572 e version number │ │ │ │ │ -00044b50: 206f 6620 4752 5542 2061 6e64 2065 7869 of GRUB and exi │ │ │ │ │ -00044b60: 742e 0a0a 272d 6427 0a27 2d2d 6465 7669 t...'-d'.'--devi │ │ │ │ │ -00044b70: 6365 270a 2020 2020 2049 6620 7468 6973 ce'. If this │ │ │ │ │ -00044b80: 206f 7074 696f 6e20 6973 2067 6976 656e option is given │ │ │ │ │ -00044b90: 2c20 7468 656e 2074 6865 206e 6f6e 2d6f , then the non-o │ │ │ │ │ -00044ba0: 7074 696f 6e20 6172 6775 6d65 6e74 2069 ption argument i │ │ │ │ │ -00044bb0: 7320 6120 7379 7374 656d 0a20 2020 2020 s a system. │ │ │ │ │ -00044bc0: 6465 7669 6365 206e 616d 6520 2873 7563 device name (suc │ │ │ │ │ -00044bd0: 6820 6173 2027 2f64 6576 2f73 6461 3127 h as '/dev/sda1' │ │ │ │ │ -00044be0: 292c 2061 6e64 2027 6772 7562 2d70 726f ), and 'grub-pro │ │ │ │ │ -00044bf0: 6265 2720 7769 6c6c 2070 7269 6e74 0a20 be' will print. │ │ │ │ │ -00044c00: 2020 2020 696e 666f 726d 6174 696f 6e20 information │ │ │ │ │ -00044c10: 6162 6f75 7420 7468 6174 2064 6576 6963 about that devic │ │ │ │ │ -00044c20: 652e 2020 4966 2069 7420 6973 206e 6f74 e. If it is not │ │ │ │ │ -00044c30: 2067 6976 656e 2c20 7468 656e 2074 6865 given, then the │ │ │ │ │ -00044c40: 0a20 2020 2020 6e6f 6e2d 6f70 7469 6f6e . non-option │ │ │ │ │ -00044c50: 2061 7267 756d 656e 7420 6973 2061 2066 argument is a f │ │ │ │ │ -00044c60: 696c 6573 7973 7465 6d20 7061 7468 2028 ilesystem path ( │ │ │ │ │ -00044c70: 7375 6368 2061 7320 272f 626f 6f74 2f67 such as '/boot/g │ │ │ │ │ -00044c80: 7275 6227 292c 0a20 2020 2020 616e 6420 rub'),. and │ │ │ │ │ -00044c90: 2767 7275 622d 7072 6f62 6527 2077 696c 'grub-probe' wil │ │ │ │ │ -00044ca0: 6c20 7072 696e 7420 696e 666f 726d 6174 l print informat │ │ │ │ │ -00044cb0: 696f 6e20 6162 6f75 7420 7468 6520 6465 ion about the de │ │ │ │ │ -00044cc0: 7669 6365 2063 6f6e 7461 696e 696e 670a vice containing. │ │ │ │ │ -00044cd0: 2020 2020 2074 6861 7420 7061 7274 206f that part o │ │ │ │ │ -00044ce0: 6620 7468 6520 6669 6c65 7379 7374 656d f the filesystem │ │ │ │ │ -00044cf0: 2e0a 0a27 2d6d 2046 494c 4527 0a27 2d2d ...'-m FILE'.'-- │ │ │ │ │ -00044d00: 6465 7669 6365 2d6d 6170 3d46 494c 4527 device-map=FILE' │ │ │ │ │ -00044d10: 0a20 2020 2020 5573 6520 4649 4c45 2061 . Use FILE a │ │ │ │ │ -00044d20: 7320 7468 6520 6465 7669 6365 206d 6170 s the device map │ │ │ │ │ -00044d30: 2028 2a6e 6f74 6520 4465 7669 6365 206d (*note Device m │ │ │ │ │ -00044d40: 6170 3a3a 2920 7261 7468 6572 2074 6861 ap::) rather tha │ │ │ │ │ -00044d50: 6e20 7468 650a 2020 2020 2064 6566 6175 n the. defau │ │ │ │ │ -00044d60: 6c74 2c20 7573 7561 6c6c 7920 272f 626f lt, usually '/bo │ │ │ │ │ -00044d70: 6f74 2f67 7275 622f 6465 7669 6365 2e6d ot/grub/device.m │ │ │ │ │ -00044d80: 6170 272e 0a0a 272d 7420 5441 5247 4554 ap'...'-t TARGET │ │ │ │ │ -00044d90: 270a 272d 2d74 6172 6765 743d 5441 5247 '.'--target=TARG │ │ │ │ │ -00044da0: 4554 270a 2020 2020 2050 7269 6e74 2069 ET'. Print i │ │ │ │ │ -00044db0: 6e66 6f72 6d61 7469 6f6e 2061 626f 7574 nformation about │ │ │ │ │ -00044dc0: 2074 6865 2067 6976 656e 2070 6174 6820 the given path │ │ │ │ │ -00044dd0: 6f72 2064 6576 6963 6520 6173 2064 6566 or device as def │ │ │ │ │ -00044de0: 696e 6564 2062 790a 2020 2020 2054 4152 ined by. TAR │ │ │ │ │ -00044df0: 4745 542e 2020 5468 6520 6176 6169 6c61 GET. The availa │ │ │ │ │ -00044e00: 626c 6520 7461 7267 6574 7320 616e 6420 ble targets and │ │ │ │ │ -00044e10: 7468 6569 7220 6d65 616e 696e 6773 2061 their meanings a │ │ │ │ │ -00044e20: 7265 3a0a 0a20 2020 2020 2766 7327 0a20 re:.. 'fs'. │ │ │ │ │ -00044e30: 2020 2020 2020 2020 2047 5255 4220 6669 GRUB fi │ │ │ │ │ -00044e40: 6c65 7379 7374 656d 206d 6f64 756c 652e lesystem module. │ │ │ │ │ -00044e50: 0a20 2020 2020 2766 735f 7575 6964 270a . 'fs_uuid'. │ │ │ │ │ -00044e60: 2020 2020 2020 2020 2020 4669 6c65 7379 Filesy │ │ │ │ │ -00044e70: 7374 656d 2055 6e69 7665 7273 616c 6c79 stem Universally │ │ │ │ │ -00044e80: 2055 6e69 7175 6520 4964 656e 7469 6669 Unique Identifi │ │ │ │ │ -00044e90: 6572 2028 5555 4944 292e 0a20 2020 2020 er (UUID).. │ │ │ │ │ -00044ea0: 2766 735f 6c61 6265 6c27 0a20 2020 2020 'fs_label'. │ │ │ │ │ -00044eb0: 2020 2020 2046 696c 6573 7973 7465 6d20 Filesystem │ │ │ │ │ -00044ec0: 6c61 6265 6c2e 0a20 2020 2020 2764 7269 label.. 'dri │ │ │ │ │ -00044ed0: 7665 270a 2020 2020 2020 2020 2020 4752 ve'. GR │ │ │ │ │ -00044ee0: 5542 2064 6576 6963 6520 6e61 6d65 2e0a UB device name.. │ │ │ │ │ -00044ef0: 2020 2020 2027 6465 7669 6365 270a 2020 'device'. │ │ │ │ │ -00044f00: 2020 2020 2020 2020 5379 7374 656d 2064 System d │ │ │ │ │ -00044f10: 6576 6963 6520 6e61 6d65 2e0a 2020 2020 evice name.. │ │ │ │ │ -00044f20: 2027 7061 7274 6d61 7027 0a20 2020 2020 'partmap'. │ │ │ │ │ -00044f30: 2020 2020 2047 5255 4220 7061 7274 6974 GRUB partit │ │ │ │ │ -00044f40: 696f 6e20 6d61 7020 6d6f 6475 6c65 2e0a ion map module.. │ │ │ │ │ -00044f50: 2020 2020 2027 6162 7374 7261 6374 696f 'abstractio │ │ │ │ │ -00044f60: 6e27 0a20 2020 2020 2020 2020 2047 5255 n'. GRU │ │ │ │ │ -00044f70: 4220 6162 7374 7261 6374 696f 6e20 6d6f B abstraction mo │ │ │ │ │ -00044f80: 6475 6c65 2028 652e 672e 2020 276c 766d dule (e.g. 'lvm │ │ │ │ │ -00044f90: 2729 2e0a 2020 2020 2027 6372 7970 746f ').. 'crypto │ │ │ │ │ -00044fa0: 6469 736b 5f75 7569 6427 0a20 2020 2020 disk_uuid'. │ │ │ │ │ -00044fb0: 2020 2020 2043 7279 7074 6f20 6465 7669 Crypto devi │ │ │ │ │ -00044fc0: 6365 2055 5549 442e 0a20 2020 2020 276d ce UUID.. 'm │ │ │ │ │ -00044fd0: 7364 6f73 5f70 6172 7474 7970 6527 0a20 sdos_parttype'. │ │ │ │ │ -00044fe0: 2020 2020 2020 2020 204d 4252 2070 6172 MBR par │ │ │ │ │ -00044ff0: 7469 7469 6f6e 2074 7970 6520 636f 6465 tition type code │ │ │ │ │ -00045000: 2028 7477 6f20 6865 7861 6465 6369 6d61 (two hexadecima │ │ │ │ │ -00045010: 6c20 6469 6769 7473 292e 0a20 2020 2020 l digits).. │ │ │ │ │ -00045020: 2768 696e 7473 5f73 7472 696e 6727 0a20 'hints_string'. │ │ │ │ │ -00045030: 2020 2020 2020 2020 2041 2073 7472 696e A strin │ │ │ │ │ -00045040: 6720 6f66 2070 6c61 7466 6f72 6d20 7365 g of platform se │ │ │ │ │ -00045050: 6172 6368 2068 696e 7473 2073 7569 7461 arch hints suita │ │ │ │ │ -00045060: 626c 6520 666f 7220 7061 7373 696e 6720 ble for passing │ │ │ │ │ -00045070: 746f 2074 6865 0a20 2020 2020 2020 2020 to the. │ │ │ │ │ -00045080: 2027 7365 6172 6368 2720 636f 6d6d 616e 'search' comman │ │ │ │ │ -00045090: 6420 282a 6e6f 7465 2073 6561 7263 683a d (*note search: │ │ │ │ │ -000450a0: 3a29 2e0a 2020 2020 2027 6269 6f73 5f68 :).. 'bios_h │ │ │ │ │ -000450b0: 696e 7473 270a 2020 2020 2020 2020 2020 ints'. │ │ │ │ │ -000450c0: 5365 6172 6368 2068 696e 7473 2066 6f72 Search hints for │ │ │ │ │ -000450d0: 2074 6865 2050 4320 4249 4f53 2070 6c61 the PC BIOS pla │ │ │ │ │ -000450e0: 7466 6f72 6d2e 0a20 2020 2020 2769 6565 tform.. 'iee │ │ │ │ │ -000450f0: 6531 3237 355f 6869 6e74 7327 0a20 2020 e1275_hints'. │ │ │ │ │ -00045100: 2020 2020 2020 2053 6561 7263 6820 6869 Search hi │ │ │ │ │ -00045110: 6e74 7320 666f 7220 7468 6520 4945 4545 nts for the IEEE │ │ │ │ │ -00045120: 3132 3735 2070 6c61 7466 6f72 6d2e 0a20 1275 platform.. │ │ │ │ │ -00045130: 2020 2020 2762 6172 656d 6574 616c 5f68 'baremetal_h │ │ │ │ │ -00045140: 696e 7473 270a 2020 2020 2020 2020 2020 ints'. │ │ │ │ │ -00045150: 5365 6172 6368 2068 696e 7473 2066 6f72 Search hints for │ │ │ │ │ -00045160: 2070 6c61 7466 6f72 6d73 2077 6865 7265 platforms where │ │ │ │ │ -00045170: 2064 6973 6b73 2061 7265 2061 6464 7265 disks are addre │ │ │ │ │ -00045180: 7373 6564 2064 6972 6563 746c 790a 2020 ssed directly. │ │ │ │ │ -00045190: 2020 2020 2020 2020 7261 7468 6572 2074 rather t │ │ │ │ │ -000451a0: 6861 6e20 7669 6120 6669 726d 7761 7265 han via firmware │ │ │ │ │ -000451b0: 2e0a 2020 2020 2027 6566 695f 6869 6e74 .. 'efi_hint │ │ │ │ │ -000451c0: 7327 0a20 2020 2020 2020 2020 2053 6561 s'. Sea │ │ │ │ │ -000451d0: 7263 6820 6869 6e74 7320 666f 7220 7468 rch hints for th │ │ │ │ │ -000451e0: 6520 4546 4920 706c 6174 666f 726d 2e0a e EFI platform.. │ │ │ │ │ -000451f0: 2020 2020 2027 6172 635f 6869 6e74 7327 'arc_hints' │ │ │ │ │ -00045200: 0a20 2020 2020 2020 2020 2053 6561 7263 . Searc │ │ │ │ │ -00045210: 6820 6869 6e74 7320 666f 7220 7468 6520 h hints for the │ │ │ │ │ -00045220: 4152 4320 706c 6174 666f 726d 2e0a 2020 ARC platform.. │ │ │ │ │ -00045230: 2020 2027 636f 6d70 6174 6962 696c 6974 'compatibilit │ │ │ │ │ -00045240: 795f 6869 6e74 270a 2020 2020 2020 2020 y_hint'. │ │ │ │ │ -00045250: 2020 4120 6775 6573 7320 6174 2061 2072 A guess at a r │ │ │ │ │ -00045260: 6561 736f 6e61 626c 6520 4752 5542 2064 easonable GRUB d │ │ │ │ │ -00045270: 7269 7665 206e 616d 6520 666f 7220 7468 rive name for th │ │ │ │ │ -00045280: 6973 2064 6576 6963 652c 2077 6869 6368 is device, which │ │ │ │ │ -00045290: 0a20 2020 2020 2020 2020 206d 6179 2062 . may b │ │ │ │ │ -000452a0: 6520 7573 6564 2061 7320 6120 6661 6c6c e used as a fall │ │ │ │ │ -000452b0: 6261 636b 2069 6620 7468 6520 2773 6561 back if the 'sea │ │ │ │ │ -000452c0: 7263 6827 2063 6f6d 6d61 6e64 2066 6169 rch' command fai │ │ │ │ │ -000452d0: 6c73 2e0a 2020 2020 2027 6469 736b 270a ls.. 'disk'. │ │ │ │ │ -000452e0: 2020 2020 2020 2020 2020 5379 7374 656d System │ │ │ │ │ -000452f0: 2064 6576 6963 6520 6e61 6d65 2066 6f72 device name for │ │ │ │ │ -00045300: 2074 6865 2077 686f 6c65 2064 6973 6b2e the whole disk. │ │ │ │ │ -00045310: 0a0a 272d 7627 0a27 2d2d 7665 7262 6f73 ..'-v'.'--verbos │ │ │ │ │ -00045320: 6527 0a20 2020 2020 5072 696e 7420 7665 e'. Print ve │ │ │ │ │ -00045330: 7262 6f73 6520 6d65 7373 6167 6573 2e0a rbose messages.. │ │ │ │ │ -00045340: 0a1f 0a46 696c 653a 2067 7275 622e 696e ...File: grub.in │ │ │ │ │ -00045350: 666f 2c20 204e 6f64 653a 2049 6e76 6f6b fo, Node: Invok │ │ │ │ │ -00045360: 696e 6720 6772 7562 2d73 6372 6970 742d ing grub-script- │ │ │ │ │ -00045370: 6368 6563 6b2c 2020 4e65 7874 3a20 4f62 check, Next: Ob │ │ │ │ │ -00045380: 7461 696e 696e 6720 616e 6420 4275 696c taining and Buil │ │ │ │ │ -00045390: 6469 6e67 2047 5255 422c 2020 5072 6576 ding GRUB, Prev │ │ │ │ │ -000453a0: 3a20 496e 766f 6b69 6e67 2067 7275 622d : Invoking grub- │ │ │ │ │ -000453b0: 7072 6f62 652c 2020 5570 3a20 546f 700a probe, Up: Top. │ │ │ │ │ -000453c0: 0a33 3020 496e 766f 6b69 6e67 2067 7275 .30 Invoking gru │ │ │ │ │ -000453d0: 622d 7363 7269 7074 2d63 6865 636b 0a2a b-script-check.* │ │ │ │ │ -000453e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000453f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a 5468 ************..Th │ │ │ │ │ -00045400: 6520 7072 6f67 7261 6d20 2767 7275 622d e program 'grub- │ │ │ │ │ -00045410: 7363 7269 7074 2d63 6865 636b 2720 7461 script-check' ta │ │ │ │ │ -00045420: 6b65 7320 6120 4752 5542 2073 6372 6970 kes a GRUB scrip │ │ │ │ │ -00045430: 7420 6669 6c65 2028 2a6e 6f74 650a 5368 t file (*note.Sh │ │ │ │ │ -00045440: 656c 6c2d 6c69 6b65 2073 6372 6970 7469 ell-like scripti │ │ │ │ │ -00045450: 6e67 3a3a 2920 616e 6420 6368 6563 6b73 ng::) and checks │ │ │ │ │ -00045460: 2069 7420 666f 7220 7379 6e74 6178 2065 it for syntax e │ │ │ │ │ -00045470: 7272 6f72 732c 2073 696d 696c 6172 2074 rrors, similar t │ │ │ │ │ -00045480: 6f0a 636f 6d6d 616e 6473 2073 7563 6820 o.commands such │ │ │ │ │ -00045490: 6173 2027 7368 202d 6e27 2e20 2049 7420 as 'sh -n'. It │ │ │ │ │ -000454a0: 6d61 7920 7461 6b65 2061 2050 4154 4820 may take a PATH │ │ │ │ │ -000454b0: 6173 2061 206e 6f6e 2d6f 7074 696f 6e20 as a non-option │ │ │ │ │ -000454c0: 6172 6775 6d65 6e74 3b0a 6966 206e 6f6e argument;.if non │ │ │ │ │ -000454d0: 6520 6973 2073 7570 706c 6965 642c 2069 e is supplied, i │ │ │ │ │ -000454e0: 7420 7769 6c6c 2072 6561 6420 6672 6f6d t will read from │ │ │ │ │ -000454f0: 2073 7461 6e64 6172 6420 696e 7075 742e standard input. │ │ │ │ │ -00045500: 0a0a 2020 2020 2067 7275 622d 7363 7269 .. grub-scri │ │ │ │ │ -00045510: 7074 2d63 6865 636b 202f 626f 6f74 2f67 pt-check /boot/g │ │ │ │ │ -00045520: 7275 622f 6772 7562 2e63 6667 0a0a 2020 rub/grub.cfg.. │ │ │ │ │ -00045530: 2027 6772 7562 2d73 6372 6970 742d 6368 'grub-script-ch │ │ │ │ │ -00045540: 6563 6b27 2061 6363 6570 7473 2074 6865 eck' accepts the │ │ │ │ │ -00045550: 2066 6f6c 6c6f 7769 6e67 206f 7074 696f following optio │ │ │ │ │ -00045560: 6e73 3a0a 0a27 2d2d 6865 6c70 270a 2020 ns:..'--help'. │ │ │ │ │ -00045570: 2020 2050 7269 6e74 2061 2073 756d 6d61 Print a summa │ │ │ │ │ -00045580: 7279 206f 6620 7468 6520 636f 6d6d 616e ry of the comman │ │ │ │ │ -00045590: 642d 6c69 6e65 206f 7074 696f 6e73 2061 d-line options a │ │ │ │ │ -000455a0: 6e64 2065 7869 742e 0a0a 272d 2d76 6572 nd exit...'--ver │ │ │ │ │ -000455b0: 7369 6f6e 270a 2020 2020 2050 7269 6e74 sion'. Print │ │ │ │ │ -000455c0: 2074 6865 2076 6572 7369 6f6e 206e 756d the version num │ │ │ │ │ -000455d0: 6265 7220 6f66 2047 5255 4220 616e 6420 ber of GRUB and │ │ │ │ │ -000455e0: 6578 6974 2e0a 0a27 2d76 270a 272d 2d76 exit...'-v'.'--v │ │ │ │ │ -000455f0: 6572 626f 7365 270a 2020 2020 2050 7269 erbose'. Pri │ │ │ │ │ -00045600: 6e74 2065 6163 6820 6c69 6e65 206f 6620 nt each line of │ │ │ │ │ -00045610: 696e 7075 7420 6166 7465 7220 7265 6164 input after read │ │ │ │ │ -00045620: 696e 6720 6974 2e0a 0a1f 0a46 696c 653a ing it.....File: │ │ │ │ │ -00045630: 2067 7275 622e 696e 666f 2c20 204e 6f64 grub.info, Nod │ │ │ │ │ -00045640: 653a 204f 6274 6169 6e69 6e67 2061 6e64 e: Obtaining and │ │ │ │ │ -00045650: 2042 7569 6c64 696e 6720 4752 5542 2c20 Building GRUB, │ │ │ │ │ -00045660: 204e 6578 743a 2052 6570 6f72 7469 6e67 Next: Reporting │ │ │ │ │ -00045670: 2062 7567 732c 2020 5072 6576 3a20 496e bugs, Prev: In │ │ │ │ │ -00045680: 766f 6b69 6e67 2067 7275 622d 7363 7269 voking grub-scri │ │ │ │ │ -00045690: 7074 2d63 6865 636b 2c20 2055 703a 2054 pt-check, Up: T │ │ │ │ │ -000456a0: 6f70 0a0a 4170 7065 6e64 6978 2041 2048 op..Appendix A H │ │ │ │ │ -000456b0: 6f77 2074 6f20 6f62 7461 696e 2061 6e64 ow to obtain and │ │ │ │ │ -000456c0: 2062 7569 6c64 2047 5255 420a 2a2a 2a2a build GRUB.**** │ │ │ │ │ +000449c0: 2a2a 2a2a 2a2a 0a0a 5468 6520 7072 6f67 ******..The prog │ │ │ │ │ +000449d0: 7261 6d20 2767 7275 622d 7072 6f62 6527 ram 'grub-probe' │ │ │ │ │ +000449e0: 2070 726f 6265 7320 6465 7669 6365 2069 probes device i │ │ │ │ │ +000449f0: 6e66 6f72 6d61 7469 6f6e 2066 6f72 2061 nformation for a │ │ │ │ │ +00044a00: 2067 6976 656e 2070 6174 6820 6f72 0a64 given path or.d │ │ │ │ │ +00044a10: 6576 6963 652e 0a0a 2020 2020 2067 7275 evice... gru │ │ │ │ │ +00044a20: 622d 7072 6f62 6520 2d2d 7461 7267 6574 b-probe --target │ │ │ │ │ +00044a30: 3d66 7320 2f62 6f6f 742f 6772 7562 0a20 =fs /boot/grub. │ │ │ │ │ +00044a40: 2020 2020 6772 7562 2d70 726f 6265 202d grub-probe - │ │ │ │ │ +00044a50: 2d74 6172 6765 743d 6472 6976 6520 2d2d -target=drive -- │ │ │ │ │ +00044a60: 6465 7669 6365 202f 6465 762f 7364 6131 device /dev/sda1 │ │ │ │ │ +00044a70: 0a0a 2020 2027 6772 7562 2d70 726f 6265 .. 'grub-probe │ │ │ │ │ +00044a80: 2720 6d75 7374 2062 6520 6769 7665 6e20 ' must be given │ │ │ │ │ +00044a90: 6120 7061 7468 206f 7220 6465 7669 6365 a path or device │ │ │ │ │ +00044aa0: 2061 7320 6120 6e6f 6e2d 6f70 7469 6f6e as a non-option │ │ │ │ │ +00044ab0: 2061 7267 756d 656e 742c 0a61 6e64 2061 argument,.and a │ │ │ │ │ +00044ac0: 6c73 6f20 6163 6365 7074 7320 7468 6520 lso accepts the │ │ │ │ │ +00044ad0: 666f 6c6c 6f77 696e 6720 6f70 7469 6f6e following option │ │ │ │ │ +00044ae0: 733a 0a0a 272d 2d68 656c 7027 0a20 2020 s:..'--help'. │ │ │ │ │ +00044af0: 2020 5072 696e 7420 6120 7375 6d6d 6172 Print a summar │ │ │ │ │ +00044b00: 7920 6f66 2074 6865 2063 6f6d 6d61 6e64 y of the command │ │ │ │ │ +00044b10: 2d6c 696e 6520 6f70 7469 6f6e 7320 616e -line options an │ │ │ │ │ +00044b20: 6420 6578 6974 2e0a 0a27 2d2d 7665 7273 d exit...'--vers │ │ │ │ │ +00044b30: 696f 6e27 0a20 2020 2020 5072 696e 7420 ion'. Print │ │ │ │ │ +00044b40: 7468 6520 7665 7273 696f 6e20 6e75 6d62 the version numb │ │ │ │ │ +00044b50: 6572 206f 6620 4752 5542 2061 6e64 2065 er of GRUB and e │ │ │ │ │ +00044b60: 7869 742e 0a0a 272d 6427 0a27 2d2d 6465 xit...'-d'.'--de │ │ │ │ │ +00044b70: 7669 6365 270a 2020 2020 2049 6620 7468 vice'. If th │ │ │ │ │ +00044b80: 6973 206f 7074 696f 6e20 6973 2067 6976 is option is giv │ │ │ │ │ +00044b90: 656e 2c20 7468 656e 2074 6865 206e 6f6e en, then the non │ │ │ │ │ +00044ba0: 2d6f 7074 696f 6e20 6172 6775 6d65 6e74 -option argument │ │ │ │ │ +00044bb0: 2069 7320 6120 7379 7374 656d 0a20 2020 is a system. │ │ │ │ │ +00044bc0: 2020 6465 7669 6365 206e 616d 6520 2873 device name (s │ │ │ │ │ +00044bd0: 7563 6820 6173 2027 2f64 6576 2f73 6461 uch as '/dev/sda │ │ │ │ │ +00044be0: 3127 292c 2061 6e64 2027 6772 7562 2d70 1'), and 'grub-p │ │ │ │ │ +00044bf0: 726f 6265 2720 7769 6c6c 2070 7269 6e74 robe' will print │ │ │ │ │ +00044c00: 0a20 2020 2020 696e 666f 726d 6174 696f . informatio │ │ │ │ │ +00044c10: 6e20 6162 6f75 7420 7468 6174 2064 6576 n about that dev │ │ │ │ │ +00044c20: 6963 652e 2020 4966 2069 7420 6973 206e ice. If it is n │ │ │ │ │ +00044c30: 6f74 2067 6976 656e 2c20 7468 656e 2074 ot given, then t │ │ │ │ │ +00044c40: 6865 0a20 2020 2020 6e6f 6e2d 6f70 7469 he. non-opti │ │ │ │ │ +00044c50: 6f6e 2061 7267 756d 656e 7420 6973 2061 on argument is a │ │ │ │ │ +00044c60: 2066 696c 6573 7973 7465 6d20 7061 7468 filesystem path │ │ │ │ │ +00044c70: 2028 7375 6368 2061 7320 272f 626f 6f74 (such as '/boot │ │ │ │ │ +00044c80: 2f67 7275 6227 292c 0a20 2020 2020 616e /grub'),. an │ │ │ │ │ +00044c90: 6420 2767 7275 622d 7072 6f62 6527 2077 d 'grub-probe' w │ │ │ │ │ +00044ca0: 696c 6c20 7072 696e 7420 696e 666f 726d ill print inform │ │ │ │ │ +00044cb0: 6174 696f 6e20 6162 6f75 7420 7468 6520 ation about the │ │ │ │ │ +00044cc0: 6465 7669 6365 2063 6f6e 7461 696e 696e device containin │ │ │ │ │ +00044cd0: 670a 2020 2020 2074 6861 7420 7061 7274 g. that part │ │ │ │ │ +00044ce0: 206f 6620 7468 6520 6669 6c65 7379 7374 of the filesyst │ │ │ │ │ +00044cf0: 656d 2e0a 0a27 2d6d 2046 494c 4527 0a27 em...'-m FILE'.' │ │ │ │ │ +00044d00: 2d2d 6465 7669 6365 2d6d 6170 3d46 494c --device-map=FIL │ │ │ │ │ +00044d10: 4527 0a20 2020 2020 5573 6520 4649 4c45 E'. Use FILE │ │ │ │ │ +00044d20: 2061 7320 7468 6520 6465 7669 6365 206d as the device m │ │ │ │ │ +00044d30: 6170 2028 2a6e 6f74 6520 4465 7669 6365 ap (*note Device │ │ │ │ │ +00044d40: 206d 6170 3a3a 2920 7261 7468 6572 2074 map::) rather t │ │ │ │ │ +00044d50: 6861 6e20 7468 650a 2020 2020 2064 6566 han the. def │ │ │ │ │ +00044d60: 6175 6c74 2c20 7573 7561 6c6c 7920 272f ault, usually '/ │ │ │ │ │ +00044d70: 626f 6f74 2f67 7275 622f 6465 7669 6365 boot/grub/device │ │ │ │ │ +00044d80: 2e6d 6170 272e 0a0a 272d 7420 5441 5247 .map'...'-t TARG │ │ │ │ │ +00044d90: 4554 270a 272d 2d74 6172 6765 743d 5441 ET'.'--target=TA │ │ │ │ │ +00044da0: 5247 4554 270a 2020 2020 2050 7269 6e74 RGET'. Print │ │ │ │ │ +00044db0: 2069 6e66 6f72 6d61 7469 6f6e 2061 626f information abo │ │ │ │ │ +00044dc0: 7574 2074 6865 2067 6976 656e 2070 6174 ut the given pat │ │ │ │ │ +00044dd0: 6820 6f72 2064 6576 6963 6520 6173 2064 h or device as d │ │ │ │ │ +00044de0: 6566 696e 6564 2062 790a 2020 2020 2054 efined by. T │ │ │ │ │ +00044df0: 4152 4745 542e 2020 5468 6520 6176 6169 ARGET. The avai │ │ │ │ │ +00044e00: 6c61 626c 6520 7461 7267 6574 7320 616e lable targets an │ │ │ │ │ +00044e10: 6420 7468 6569 7220 6d65 616e 696e 6773 d their meanings │ │ │ │ │ +00044e20: 2061 7265 3a0a 0a20 2020 2020 2766 7327 are:.. 'fs' │ │ │ │ │ +00044e30: 0a20 2020 2020 2020 2020 2047 5255 4220 . GRUB │ │ │ │ │ +00044e40: 6669 6c65 7379 7374 656d 206d 6f64 756c filesystem modul │ │ │ │ │ +00044e50: 652e 0a20 2020 2020 2766 735f 7575 6964 e.. 'fs_uuid │ │ │ │ │ +00044e60: 270a 2020 2020 2020 2020 2020 4669 6c65 '. File │ │ │ │ │ +00044e70: 7379 7374 656d 2055 6e69 7665 7273 616c system Universal │ │ │ │ │ +00044e80: 6c79 2055 6e69 7175 6520 4964 656e 7469 ly Unique Identi │ │ │ │ │ +00044e90: 6669 6572 2028 5555 4944 292e 0a20 2020 fier (UUID).. │ │ │ │ │ +00044ea0: 2020 2766 735f 6c61 6265 6c27 0a20 2020 'fs_label'. │ │ │ │ │ +00044eb0: 2020 2020 2020 2046 696c 6573 7973 7465 Filesyste │ │ │ │ │ +00044ec0: 6d20 6c61 6265 6c2e 0a20 2020 2020 2764 m label.. 'd │ │ │ │ │ +00044ed0: 7269 7665 270a 2020 2020 2020 2020 2020 rive'. │ │ │ │ │ +00044ee0: 4752 5542 2064 6576 6963 6520 6e61 6d65 GRUB device name │ │ │ │ │ +00044ef0: 2e0a 2020 2020 2027 6465 7669 6365 270a .. 'device'. │ │ │ │ │ +00044f00: 2020 2020 2020 2020 2020 5379 7374 656d System │ │ │ │ │ +00044f10: 2064 6576 6963 6520 6e61 6d65 2e0a 2020 device name.. │ │ │ │ │ +00044f20: 2020 2027 7061 7274 6d61 7027 0a20 2020 'partmap'. │ │ │ │ │ +00044f30: 2020 2020 2020 2047 5255 4220 7061 7274 GRUB part │ │ │ │ │ +00044f40: 6974 696f 6e20 6d61 7020 6d6f 6475 6c65 ition map module │ │ │ │ │ +00044f50: 2e0a 2020 2020 2027 6162 7374 7261 6374 .. 'abstract │ │ │ │ │ +00044f60: 696f 6e27 0a20 2020 2020 2020 2020 2047 ion'. G │ │ │ │ │ +00044f70: 5255 4220 6162 7374 7261 6374 696f 6e20 RUB abstraction │ │ │ │ │ +00044f80: 6d6f 6475 6c65 2028 652e 672e 2020 276c module (e.g. 'l │ │ │ │ │ +00044f90: 766d 2729 2e0a 2020 2020 2027 6372 7970 vm').. 'cryp │ │ │ │ │ +00044fa0: 746f 6469 736b 5f75 7569 6427 0a20 2020 todisk_uuid'. │ │ │ │ │ +00044fb0: 2020 2020 2020 2043 7279 7074 6f20 6465 Crypto de │ │ │ │ │ +00044fc0: 7669 6365 2055 5549 442e 0a20 2020 2020 vice UUID.. │ │ │ │ │ +00044fd0: 276d 7364 6f73 5f70 6172 7474 7970 6527 'msdos_parttype' │ │ │ │ │ +00044fe0: 0a20 2020 2020 2020 2020 204d 4252 2070 . MBR p │ │ │ │ │ +00044ff0: 6172 7469 7469 6f6e 2074 7970 6520 636f artition type co │ │ │ │ │ +00045000: 6465 2028 7477 6f20 6865 7861 6465 6369 de (two hexadeci │ │ │ │ │ +00045010: 6d61 6c20 6469 6769 7473 292e 0a20 2020 mal digits).. │ │ │ │ │ +00045020: 2020 2768 696e 7473 5f73 7472 696e 6727 'hints_string' │ │ │ │ │ +00045030: 0a20 2020 2020 2020 2020 2041 2073 7472 . A str │ │ │ │ │ +00045040: 696e 6720 6f66 2070 6c61 7466 6f72 6d20 ing of platform │ │ │ │ │ +00045050: 7365 6172 6368 2068 696e 7473 2073 7569 search hints sui │ │ │ │ │ +00045060: 7461 626c 6520 666f 7220 7061 7373 696e table for passin │ │ │ │ │ +00045070: 6720 746f 2074 6865 0a20 2020 2020 2020 g to the. │ │ │ │ │ +00045080: 2020 2027 7365 6172 6368 2720 636f 6d6d 'search' comm │ │ │ │ │ +00045090: 616e 6420 282a 6e6f 7465 2073 6561 7263 and (*note searc │ │ │ │ │ +000450a0: 683a 3a29 2e0a 2020 2020 2027 6269 6f73 h::).. 'bios │ │ │ │ │ +000450b0: 5f68 696e 7473 270a 2020 2020 2020 2020 _hints'. │ │ │ │ │ +000450c0: 2020 5365 6172 6368 2068 696e 7473 2066 Search hints f │ │ │ │ │ +000450d0: 6f72 2074 6865 2050 4320 4249 4f53 2070 or the PC BIOS p │ │ │ │ │ +000450e0: 6c61 7466 6f72 6d2e 0a20 2020 2020 2769 latform.. 'i │ │ │ │ │ +000450f0: 6565 6531 3237 355f 6869 6e74 7327 0a20 eee1275_hints'. │ │ │ │ │ +00045100: 2020 2020 2020 2020 2053 6561 7263 6820 Search │ │ │ │ │ +00045110: 6869 6e74 7320 666f 7220 7468 6520 4945 hints for the IE │ │ │ │ │ +00045120: 4545 3132 3735 2070 6c61 7466 6f72 6d2e EE1275 platform. │ │ │ │ │ +00045130: 0a20 2020 2020 2762 6172 656d 6574 616c . 'baremetal │ │ │ │ │ +00045140: 5f68 696e 7473 270a 2020 2020 2020 2020 _hints'. │ │ │ │ │ +00045150: 2020 5365 6172 6368 2068 696e 7473 2066 Search hints f │ │ │ │ │ +00045160: 6f72 2070 6c61 7466 6f72 6d73 2077 6865 or platforms whe │ │ │ │ │ +00045170: 7265 2064 6973 6b73 2061 7265 2061 6464 re disks are add │ │ │ │ │ +00045180: 7265 7373 6564 2064 6972 6563 746c 790a ressed directly. │ │ │ │ │ +00045190: 2020 2020 2020 2020 2020 7261 7468 6572 rather │ │ │ │ │ +000451a0: 2074 6861 6e20 7669 6120 6669 726d 7761 than via firmwa │ │ │ │ │ +000451b0: 7265 2e0a 2020 2020 2027 6566 695f 6869 re.. 'efi_hi │ │ │ │ │ +000451c0: 6e74 7327 0a20 2020 2020 2020 2020 2053 nts'. S │ │ │ │ │ +000451d0: 6561 7263 6820 6869 6e74 7320 666f 7220 earch hints for │ │ │ │ │ +000451e0: 7468 6520 4546 4920 706c 6174 666f 726d the EFI platform │ │ │ │ │ +000451f0: 2e0a 2020 2020 2027 6172 635f 6869 6e74 .. 'arc_hint │ │ │ │ │ +00045200: 7327 0a20 2020 2020 2020 2020 2053 6561 s'. Sea │ │ │ │ │ +00045210: 7263 6820 6869 6e74 7320 666f 7220 7468 rch hints for th │ │ │ │ │ +00045220: 6520 4152 4320 706c 6174 666f 726d 2e0a e ARC platform.. │ │ │ │ │ +00045230: 2020 2020 2027 636f 6d70 6174 6962 696c 'compatibil │ │ │ │ │ +00045240: 6974 795f 6869 6e74 270a 2020 2020 2020 ity_hint'. │ │ │ │ │ +00045250: 2020 2020 4120 6775 6573 7320 6174 2061 A guess at a │ │ │ │ │ +00045260: 2072 6561 736f 6e61 626c 6520 4752 5542 reasonable GRUB │ │ │ │ │ +00045270: 2064 7269 7665 206e 616d 6520 666f 7220 drive name for │ │ │ │ │ +00045280: 7468 6973 2064 6576 6963 652c 2077 6869 this device, whi │ │ │ │ │ +00045290: 6368 0a20 2020 2020 2020 2020 206d 6179 ch. may │ │ │ │ │ +000452a0: 2062 6520 7573 6564 2061 7320 6120 6661 be used as a fa │ │ │ │ │ +000452b0: 6c6c 6261 636b 2069 6620 7468 6520 2773 llback if the 's │ │ │ │ │ +000452c0: 6561 7263 6827 2063 6f6d 6d61 6e64 2066 earch' command f │ │ │ │ │ +000452d0: 6169 6c73 2e0a 2020 2020 2027 6469 736b ails.. 'disk │ │ │ │ │ +000452e0: 270a 2020 2020 2020 2020 2020 5379 7374 '. Syst │ │ │ │ │ +000452f0: 656d 2064 6576 6963 6520 6e61 6d65 2066 em device name f │ │ │ │ │ +00045300: 6f72 2074 6865 2077 686f 6c65 2064 6973 or the whole dis │ │ │ │ │ +00045310: 6b2e 0a0a 272d 7627 0a27 2d2d 7665 7262 k...'-v'.'--verb │ │ │ │ │ +00045320: 6f73 6527 0a20 2020 2020 5072 696e 7420 ose'. Print │ │ │ │ │ +00045330: 7665 7262 6f73 6520 6d65 7373 6167 6573 verbose messages │ │ │ │ │ +00045340: 2e0a 0a1f 0a46 696c 653a 2067 7275 622e .....File: grub. │ │ │ │ │ +00045350: 696e 666f 2c20 204e 6f64 653a 2049 6e76 info, Node: Inv │ │ │ │ │ +00045360: 6f6b 696e 6720 6772 7562 2d73 6372 6970 oking grub-scrip │ │ │ │ │ +00045370: 742d 6368 6563 6b2c 2020 4e65 7874 3a20 t-check, Next: │ │ │ │ │ +00045380: 4f62 7461 696e 696e 6720 616e 6420 4275 Obtaining and Bu │ │ │ │ │ +00045390: 696c 6469 6e67 2047 5255 422c 2020 5072 ilding GRUB, Pr │ │ │ │ │ +000453a0: 6576 3a20 496e 766f 6b69 6e67 2067 7275 ev: Invoking gru │ │ │ │ │ +000453b0: 622d 7072 6f62 652c 2020 5570 3a20 546f b-probe, Up: To │ │ │ │ │ +000453c0: 700a 0a33 3020 496e 766f 6b69 6e67 2067 p..30 Invoking g │ │ │ │ │ +000453d0: 7275 622d 7363 7269 7074 2d63 6865 636b rub-script-check │ │ │ │ │ +000453e0: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ +000453f0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ +00045400: 5468 6520 7072 6f67 7261 6d20 2767 7275 The program 'gru │ │ │ │ │ +00045410: 622d 7363 7269 7074 2d63 6865 636b 2720 b-script-check' │ │ │ │ │ +00045420: 7461 6b65 7320 6120 4752 5542 2073 6372 takes a GRUB scr │ │ │ │ │ +00045430: 6970 7420 6669 6c65 2028 2a6e 6f74 650a ipt file (*note. │ │ │ │ │ +00045440: 5368 656c 6c2d 6c69 6b65 2073 6372 6970 Shell-like scrip │ │ │ │ │ +00045450: 7469 6e67 3a3a 2920 616e 6420 6368 6563 ting::) and chec │ │ │ │ │ +00045460: 6b73 2069 7420 666f 7220 7379 6e74 6178 ks it for syntax │ │ │ │ │ +00045470: 2065 7272 6f72 732c 2073 696d 696c 6172 errors, similar │ │ │ │ │ +00045480: 2074 6f0a 636f 6d6d 616e 6473 2073 7563 to.commands suc │ │ │ │ │ +00045490: 6820 6173 2027 7368 202d 6e27 2e20 2049 h as 'sh -n'. I │ │ │ │ │ +000454a0: 7420 6d61 7920 7461 6b65 2061 2050 4154 t may take a PAT │ │ │ │ │ +000454b0: 4820 6173 2061 206e 6f6e 2d6f 7074 696f H as a non-optio │ │ │ │ │ +000454c0: 6e20 6172 6775 6d65 6e74 3b0a 6966 206e n argument;.if n │ │ │ │ │ +000454d0: 6f6e 6520 6973 2073 7570 706c 6965 642c one is supplied, │ │ │ │ │ +000454e0: 2069 7420 7769 6c6c 2072 6561 6420 6672 it will read fr │ │ │ │ │ +000454f0: 6f6d 2073 7461 6e64 6172 6420 696e 7075 om standard inpu │ │ │ │ │ +00045500: 742e 0a0a 2020 2020 2067 7275 622d 7363 t... grub-sc │ │ │ │ │ +00045510: 7269 7074 2d63 6865 636b 202f 626f 6f74 ript-check /boot │ │ │ │ │ +00045520: 2f67 7275 622f 6772 7562 2e63 6667 0a0a /grub/grub.cfg.. │ │ │ │ │ +00045530: 2020 2027 6772 7562 2d73 6372 6970 742d 'grub-script- │ │ │ │ │ +00045540: 6368 6563 6b27 2061 6363 6570 7473 2074 check' accepts t │ │ │ │ │ +00045550: 6865 2066 6f6c 6c6f 7769 6e67 206f 7074 he following opt │ │ │ │ │ +00045560: 696f 6e73 3a0a 0a27 2d2d 6865 6c70 270a ions:..'--help'. │ │ │ │ │ +00045570: 2020 2020 2050 7269 6e74 2061 2073 756d Print a sum │ │ │ │ │ +00045580: 6d61 7279 206f 6620 7468 6520 636f 6d6d mary of the comm │ │ │ │ │ +00045590: 616e 642d 6c69 6e65 206f 7074 696f 6e73 and-line options │ │ │ │ │ +000455a0: 2061 6e64 2065 7869 742e 0a0a 272d 2d76 and exit...'--v │ │ │ │ │ +000455b0: 6572 7369 6f6e 270a 2020 2020 2050 7269 ersion'. Pri │ │ │ │ │ +000455c0: 6e74 2074 6865 2076 6572 7369 6f6e 206e nt the version n │ │ │ │ │ +000455d0: 756d 6265 7220 6f66 2047 5255 4220 616e umber of GRUB an │ │ │ │ │ +000455e0: 6420 6578 6974 2e0a 0a27 2d76 270a 272d d exit...'-v'.'- │ │ │ │ │ +000455f0: 2d76 6572 626f 7365 270a 2020 2020 2050 -verbose'. P │ │ │ │ │ +00045600: 7269 6e74 2065 6163 6820 6c69 6e65 206f rint each line o │ │ │ │ │ +00045610: 6620 696e 7075 7420 6166 7465 7220 7265 f input after re │ │ │ │ │ +00045620: 6164 696e 6720 6974 2e0a 0a1f 0a46 696c ading it.....Fil │ │ │ │ │ +00045630: 653a 2067 7275 622e 696e 666f 2c20 204e e: grub.info, N │ │ │ │ │ +00045640: 6f64 653a 204f 6274 6169 6e69 6e67 2061 ode: Obtaining a │ │ │ │ │ +00045650: 6e64 2042 7569 6c64 696e 6720 4752 5542 nd Building GRUB │ │ │ │ │ +00045660: 2c20 204e 6578 743a 2052 6570 6f72 7469 , Next: Reporti │ │ │ │ │ +00045670: 6e67 2062 7567 732c 2020 5072 6576 3a20 ng bugs, Prev: │ │ │ │ │ +00045680: 496e 766f 6b69 6e67 2067 7275 622d 7363 Invoking grub-sc │ │ │ │ │ +00045690: 7269 7074 2d63 6865 636b 2c20 2055 703a ript-check, Up: │ │ │ │ │ +000456a0: 2054 6f70 0a0a 4170 7065 6e64 6978 2041 Top..Appendix A │ │ │ │ │ +000456b0: 2048 6f77 2074 6f20 6f62 7461 696e 2061 How to obtain a │ │ │ │ │ +000456c0: 6e64 2062 7569 6c64 2047 5255 420a 2a2a nd build GRUB.** │ │ │ │ │ 000456d0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ 000456e0: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -000456f0: 2a2a 2a0a 0a20 2020 2020 2a43 6175 7469 ***.. *Cauti │ │ │ │ │ -00045700: 6f6e 3a2a 2047 5255 4220 7265 7175 6972 on:* GRUB requir │ │ │ │ │ -00045710: 6573 2062 696e 7574 696c 732d 322e 392e es binutils-2.9. │ │ │ │ │ -00045720: 312e 302e 3233 206f 7220 6c61 7465 7220 1.0.23 or later │ │ │ │ │ -00045730: 6265 6361 7573 6520 7468 650a 2020 2020 because the. │ │ │ │ │ -00045740: 2047 4e55 2061 7373 656d 626c 6572 2068 GNU assembler h │ │ │ │ │ -00045750: 6173 2062 6565 6e20 6368 616e 6765 6420 as been changed │ │ │ │ │ -00045760: 736f 2074 6861 7420 6974 2063 616e 2070 so that it can p │ │ │ │ │ -00045770: 726f 6475 6365 2072 6561 6c20 3136 6269 roduce real 16bi │ │ │ │ │ -00045780: 7473 0a20 2020 2020 6d61 6368 696e 6520 ts. machine │ │ │ │ │ -00045790: 636f 6465 2062 6574 7765 656e 2032 2e39 code between 2.9 │ │ │ │ │ -000457a0: 2e31 2061 6e64 2032 2e39 2e31 2e30 2e78 .1 and 2.9.1.0.x │ │ │ │ │ -000457b0: 2e20 2053 6565 0a20 2020 2020 3c68 7474 . See. , to obtain inf │ │ │ │ │ -000457f0: 6f72 6d61 7469 6f6e 206f 6e20 686f 770a ormation on how. │ │ │ │ │ -00045800: 2020 2020 2074 6f20 6765 7420 7468 6520 to get the │ │ │ │ │ -00045810: 6c61 7465 7374 2076 6572 7369 6f6e 2e0a latest version.. │ │ │ │ │ -00045820: 0a20 2020 4752 5542 2069 7320 6176 6169 . GRUB is avai │ │ │ │ │ -00045830: 6c61 626c 6520 6672 6f6d 2074 6865 2047 lable from the G │ │ │ │ │ -00045840: 4e55 2061 6c70 6861 2061 7263 6869 7665 NU alpha archive │ │ │ │ │ -00045850: 2073 6974 650a 3c66 7470 3a2f 2f66 7470 site. or any of its │ │ │ │ │ -00045880: 206d 6972 726f 7273 2e20 2054 6865 2066 mirrors. The f │ │ │ │ │ -00045890: 696c 6520 7769 6c6c 2062 650a 6e61 6d65 ile will be.name │ │ │ │ │ -000458a0: 6420 6772 7562 2d76 6572 7369 6f6e 2e74 d grub-version.t │ │ │ │ │ -000458b0: 6172 2e67 7a2e 2020 5468 6520 6375 7272 ar.gz. The curr │ │ │ │ │ -000458c0: 656e 7420 7665 7273 696f 6e20 6973 2032 ent version is 2 │ │ │ │ │ -000458d0: 2e30 362c 2073 6f20 7468 6520 6669 6c65 .06, so the file │ │ │ │ │ -000458e0: 2079 6f75 0a73 686f 756c 6420 6772 6162 you.should grab │ │ │ │ │ -000458f0: 2069 733a 0a0a 2020 203c 6674 703a 2f2f is:.. .. To un │ │ │ │ │ -00045930: 6275 6e64 6c65 2047 5255 4220 7573 6520 bundle GRUB use │ │ │ │ │ -00045940: 7468 6520 696e 7374 7275 6374 696f 6e3a the instruction: │ │ │ │ │ -00045950: 0a0a 2020 2020 207a 6361 7420 6772 7562 .. zcat grub │ │ │ │ │ -00045960: 2d32 2e30 362e 7461 722e 677a 207c 2074 -2.06.tar.gz | t │ │ │ │ │ -00045970: 6172 2078 7666 202d 0a0a 2020 2077 6869 ar xvf -.. whi │ │ │ │ │ -00045980: 6368 2077 696c 6c20 6372 6561 7465 2061 ch will create a │ │ │ │ │ -00045990: 2064 6972 6563 746f 7279 2063 616c 6c65 directory calle │ │ │ │ │ -000459a0: 6420 2767 7275 622d 322e 3036 2720 7769 d 'grub-2.06' wi │ │ │ │ │ -000459b0: 7468 2061 6c6c 2074 6865 0a73 6f75 7263 th all the.sourc │ │ │ │ │ -000459c0: 6573 2e20 2059 6f75 2063 616e 206c 6f6f es. You can loo │ │ │ │ │ -000459d0: 6b20 6174 2074 6865 2066 696c 6520 2749 k at the file 'I │ │ │ │ │ -000459e0: 4e53 5441 4c4c 2720 666f 7220 6465 7461 NSTALL' for deta │ │ │ │ │ -000459f0: 696c 6564 2069 6e73 7472 7563 7469 6f6e iled instruction │ │ │ │ │ -00045a00: 730a 6f6e 2068 6f77 2074 6f20 6275 696c s.on how to buil │ │ │ │ │ -00045a10: 6420 616e 6420 696e 7374 616c 6c20 4752 d and install GR │ │ │ │ │ -00045a20: 5542 2c20 6275 7420 796f 7520 7368 6f75 UB, but you shou │ │ │ │ │ -00045a30: 6c64 2062 6520 6162 6c65 2074 6f20 6a75 ld be able to ju │ │ │ │ │ -00045a40: 7374 2064 6f3a 0a0a 2020 2020 2063 6420 st do:.. cd │ │ │ │ │ -00045a50: 6772 7562 2d32 2e30 360a 2020 2020 202e grub-2.06. . │ │ │ │ │ -00045a60: 2f63 6f6e 6669 6775 7265 0a20 2020 2020 /configure. │ │ │ │ │ -00045a70: 6d61 6b65 2069 6e73 7461 6c6c 0a0a 2020 make install.. │ │ │ │ │ -00045a80: 2041 6c73 6f2c 2074 6865 206c 6174 6573 Also, the lates │ │ │ │ │ -00045a90: 7420 7665 7273 696f 6e20 6973 2061 7661 t version is ava │ │ │ │ │ -00045aa0: 696c 6162 6c65 2075 7369 6e67 2047 6974 ilable using Git │ │ │ │ │ -00045ab0: 2e20 2053 6565 0a3c 6874 7470 3a2f 2f77 . See. for │ │ │ │ │ -00045af0: 206d 6f72 650a 696e 666f 726d 6174 696f more.informatio │ │ │ │ │ -00045b00: 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 7562 n.....File: grub │ │ │ │ │ -00045b10: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 5265 .info, Node: Re │ │ │ │ │ -00045b20: 706f 7274 696e 6720 6275 6773 2c20 204e porting bugs, N │ │ │ │ │ -00045b30: 6578 743a 2046 7574 7572 652c 2020 5072 ext: Future, Pr │ │ │ │ │ -00045b40: 6576 3a20 4f62 7461 696e 696e 6720 616e ev: Obtaining an │ │ │ │ │ -00045b50: 6420 4275 696c 6469 6e67 2047 5255 422c d Building GRUB, │ │ │ │ │ -00045b60: 2020 5570 3a20 546f 700a 0a41 7070 656e Up: Top..Appen │ │ │ │ │ -00045b70: 6469 7820 4220 5265 706f 7274 696e 6720 dix B Reporting │ │ │ │ │ -00045b80: 6275 6773 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a bugs.*********** │ │ │ │ │ -00045b90: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ -00045ba0: 5468 6573 6520 6172 6520 7468 6520 6775 These are the gu │ │ │ │ │ -00045bb0: 6964 656c 696e 6520 666f 7220 686f 7720 ideline for how │ │ │ │ │ -00045bc0: 746f 2072 6570 6f72 7420 6275 6773 2e20 to report bugs. │ │ │ │ │ -00045bd0: 2054 616b 6520 6120 6c6f 6f6b 2061 7420 Take a look at │ │ │ │ │ -00045be0: 7468 6973 0a6c 6973 7420 6265 6c6f 7720 this.list below │ │ │ │ │ -00045bf0: 6265 666f 7265 2079 6f75 2073 7562 6d69 before you submi │ │ │ │ │ -00045c00: 7420 6275 6773 3a0a 0a20 2031 2e20 4265 t bugs:.. 1. Be │ │ │ │ │ -00045c10: 666f 7265 2067 6574 7469 6e67 2075 6e73 fore getting uns │ │ │ │ │ -00045c20: 6574 746c 6564 2c20 7265 6164 2074 6869 ettled, read thi │ │ │ │ │ -00045c30: 7320 6d61 6e75 616c 2074 6872 6f75 6768 s manual through │ │ │ │ │ -00045c40: 2061 6e64 2074 6872 6f75 6768 2e0a 2020 and through.. │ │ │ │ │ -00045c50: 2020 2041 6c73 6f2c 2073 6565 2074 6865 Also, see the │ │ │ │ │ -00045c60: 2047 4e55 2047 5255 4220 4641 510a 2020 GNU GRUB FAQ. │ │ │ │ │ -00045c70: 2020 2028 6874 7470 3a2f 2f77 7777 2e67 (http://www.g │ │ │ │ │ -00045c80: 6e75 2e6f 7267 2f73 6f66 7477 6172 652f nu.org/software/ │ │ │ │ │ -00045c90: 6772 7562 2f67 7275 622d 6661 712e 6874 grub/grub-faq.ht │ │ │ │ │ -00045ca0: 6d6c 292e 0a0a 2020 322e 2041 6c77 6179 ml)... 2. Alway │ │ │ │ │ -00045cb0: 7320 6d65 6e74 696f 6e20 7468 6520 696e s mention the in │ │ │ │ │ -00045cc0: 666f 726d 6174 696f 6e20 6f6e 2079 6f75 formation on you │ │ │ │ │ -00045cd0: 7220 4752 5542 2e20 5468 6520 7665 7273 r GRUB. The vers │ │ │ │ │ -00045ce0: 696f 6e20 6e75 6d62 6572 2061 6e64 0a20 ion number and. │ │ │ │ │ -00045cf0: 2020 2020 7468 6520 636f 6e66 6967 7572 the configur │ │ │ │ │ -00045d00: 6174 696f 6e20 6172 6520 7175 6974 6520 ation are quite │ │ │ │ │ -00045d10: 696d 706f 7274 616e 742e 2020 4966 2079 important. If y │ │ │ │ │ -00045d20: 6f75 2062 7569 6c64 2069 7420 796f 7572 ou build it your │ │ │ │ │ -00045d30: 7365 6c66 2c0a 2020 2020 2077 7269 7465 self,. write │ │ │ │ │ -00045d40: 2074 6865 206f 7074 696f 6e73 2073 7065 the options spe │ │ │ │ │ -00045d50: 6369 6669 6564 2074 6f20 7468 6520 636f cified to the co │ │ │ │ │ -00045d60: 6e66 6967 7572 6520 7363 7269 7074 2061 nfigure script a │ │ │ │ │ -00045d70: 6e64 2079 6f75 720a 2020 2020 206f 7065 nd your. ope │ │ │ │ │ -00045d80: 7261 7469 6e67 2073 7973 7465 6d2c 2069 rating system, i │ │ │ │ │ -00045d90: 6e63 6c75 6469 6e67 2074 6865 2076 6572 ncluding the ver │ │ │ │ │ -00045da0: 7369 6f6e 7320 6f66 2067 6363 2061 6e64 sions of gcc and │ │ │ │ │ -00045db0: 2062 696e 7574 696c 732e 0a0a 2020 332e binutils... 3. │ │ │ │ │ -00045dc0: 2049 6620 796f 7520 6861 7665 2074 726f If you have tro │ │ │ │ │ -00045dd0: 7562 6c65 2077 6974 6820 7468 6520 696e uble with the in │ │ │ │ │ -00045de0: 7374 616c 6c61 7469 6f6e 2c20 696e 666f stallation, info │ │ │ │ │ -00045df0: 726d 2075 7320 6f66 2068 6f77 2079 6f75 rm us of how you │ │ │ │ │ -00045e00: 0a20 2020 2020 696e 7374 616c 6c65 6420 . installed │ │ │ │ │ -00045e10: 4752 5542 2e20 446f 6e27 7420 6f6d 6974 GRUB. Don't omit │ │ │ │ │ -00045e20: 2065 7272 6f72 206d 6573 7361 6765 732c error messages, │ │ │ │ │ -00045e30: 2069 6620 616e 792e 2020 4a75 7374 2027 if any. Just ' │ │ │ │ │ -00045e40: 4752 5542 0a20 2020 2020 6861 6e67 7320 GRUB. hangs │ │ │ │ │ -00045e50: 7570 2077 6865 6e20 6974 2062 6f6f 7473 up when it boots │ │ │ │ │ -00045e60: 2720 6973 206e 6f74 2065 6e6f 7567 682e ' is not enough. │ │ │ │ │ -00045e70: 0a0a 2020 2020 2054 6865 2069 6e66 6f72 .. The infor │ │ │ │ │ -00045e80: 6d61 7469 6f6e 206f 6e20 796f 7572 2068 mation on your h │ │ │ │ │ -00045e90: 6172 6477 6172 6520 6973 2061 6c73 6f20 ardware is also │ │ │ │ │ -00045ea0: 6573 7365 6e74 6961 6c2e 2020 5468 6573 essential. Thes │ │ │ │ │ -00045eb0: 6520 6172 650a 2020 2020 2065 7370 6563 e are. espec │ │ │ │ │ -00045ec0: 6961 6c6c 7920 696d 706f 7274 616e 743a ially important: │ │ │ │ │ -00045ed0: 2074 6865 2067 656f 6d65 7472 6965 7320 the geometries │ │ │ │ │ -00045ee0: 616e 6420 7468 6520 7061 7274 6974 696f and the partitio │ │ │ │ │ -00045ef0: 6e20 7461 626c 6573 206f 660a 2020 2020 n tables of. │ │ │ │ │ -00045f00: 2079 6f75 7220 6861 7264 2064 6973 6b20 your hard disk │ │ │ │ │ -00045f10: 6472 6976 6573 2061 6e64 2079 6f75 7220 drives and your │ │ │ │ │ -00045f20: 4249 4f53 2e0a 0a20 2034 2e20 4966 2047 BIOS... 4. If G │ │ │ │ │ -00045f30: 5255 4220 6361 6e6e 6f74 2062 6f6f 7420 RUB cannot boot │ │ │ │ │ -00045f40: 796f 7572 206f 7065 7261 7469 6e67 2073 your operating s │ │ │ │ │ -00045f50: 7973 7465 6d2c 2077 7269 7465 2064 6f77 ystem, write dow │ │ │ │ │ -00045f60: 6e20 5f65 7665 7279 7468 696e 675f 0a20 n _everything_. │ │ │ │ │ -00045f70: 2020 2020 796f 7520 7365 6520 6f6e 2074 you see on t │ │ │ │ │ -00045f80: 6865 2073 6372 6565 6e2e 2020 446f 6e27 he screen. Don' │ │ │ │ │ -00045f90: 7420 7061 7261 7068 7261 7365 2074 6865 t paraphrase the │ │ │ │ │ -00045fa0: 6d2c 206c 696b 6520 2754 6865 2066 6f6f m, like 'The foo │ │ │ │ │ -00045fb0: 204f 530a 2020 2020 2063 7261 7368 6573 OS. crashes │ │ │ │ │ -00045fc0: 2077 6974 6820 4752 5542 2c20 6576 656e with GRUB, even │ │ │ │ │ -00045fd0: 2074 686f 7567 6820 6974 2063 616e 2062 though it can b │ │ │ │ │ -00045fe0: 6f6f 7420 7769 7468 2074 6865 2062 6172 oot with the bar │ │ │ │ │ -00045ff0: 2062 6f6f 7420 6c6f 6164 6572 0a20 2020 boot loader. │ │ │ │ │ -00046000: 2020 6a75 7374 2066 696e 6527 2e20 204d just fine'. M │ │ │ │ │ -00046010: 656e 7469 6f6e 2074 6865 2063 6f6d 6d61 ention the comma │ │ │ │ │ -00046020: 6e64 7320 796f 7520 6578 6563 7574 6564 nds you executed │ │ │ │ │ -00046030: 2c20 7468 6520 6d65 7373 6167 6573 0a20 , the messages. │ │ │ │ │ -00046040: 2020 2020 7072 696e 7465 6420 6279 2074 printed by t │ │ │ │ │ -00046050: 6865 6d2c 2061 6e64 2069 6e66 6f72 6d61 hem, and informa │ │ │ │ │ -00046060: 7469 6f6e 206f 6e20 796f 7572 206f 7065 tion on your ope │ │ │ │ │ -00046070: 7261 7469 6e67 2073 7973 7465 6d20 696e rating system in │ │ │ │ │ -00046080: 636c 7564 696e 670a 2020 2020 2074 6865 cluding. the │ │ │ │ │ -00046090: 2076 6572 7369 6f6e 206e 756d 6265 722e version number. │ │ │ │ │ -000460a0: 0a0a 2020 352e 2045 7870 6c61 696e 2077 .. 5. Explain w │ │ │ │ │ -000460b0: 6861 7420 796f 7520 7761 6e74 6564 2074 hat you wanted t │ │ │ │ │ -000460c0: 6f20 646f 2e20 2049 7420 6973 2076 6572 o do. It is ver │ │ │ │ │ -000460d0: 7920 7573 6566 756c 2074 6f20 6b6e 6f77 y useful to know │ │ │ │ │ -000460e0: 2079 6f75 720a 2020 2020 2070 7572 706f your. purpo │ │ │ │ │ -000460f0: 7365 2061 6e64 2079 6f75 7220 7769 7368 se and your wish │ │ │ │ │ -00046100: 2c20 616e 6420 686f 7720 4752 5542 2064 , and how GRUB d │ │ │ │ │ -00046110: 6964 6e27 7420 7361 7469 7366 7920 796f idn't satisfy yo │ │ │ │ │ -00046120: 752e 0a0a 2020 362e 2049 6620 796f 7520 u... 6. If you │ │ │ │ │ -00046130: 6361 6e20 696e 7665 7374 6967 6174 6520 can investigate │ │ │ │ │ -00046140: 7468 6520 7072 6f62 6c65 6d20 796f 7572 the problem your │ │ │ │ │ -00046150: 7365 6c66 2c20 706c 6561 7365 2064 6f2e self, please do. │ │ │ │ │ -00046160: 2020 5468 6174 2077 696c 6c0a 2020 2020 That will. │ │ │ │ │ -00046170: 2067 6976 6520 796f 7520 616e 6420 7573 give you and us │ │ │ │ │ -00046180: 206d 7563 6820 6d6f 7265 2069 6e66 6f72 much more infor │ │ │ │ │ -00046190: 6d61 7469 6f6e 206f 6e20 7468 6520 7072 mation on the pr │ │ │ │ │ -000461a0: 6f62 6c65 6d2e 2020 4174 7461 6368 696e oblem. Attachin │ │ │ │ │ -000461b0: 6720 610a 2020 2020 2070 6174 6368 2069 g a. patch i │ │ │ │ │ -000461c0: 7320 6576 656e 2062 6574 7465 722e 0a0a s even better... │ │ │ │ │ -000461d0: 2020 2020 2057 6865 6e20 796f 7520 6174 When you at │ │ │ │ │ -000461e0: 7461 6368 2061 2070 6174 6368 2c20 6d61 tach a patch, ma │ │ │ │ │ -000461f0: 6b65 2074 6865 2070 6174 6368 2069 6e20 ke the patch in │ │ │ │ │ -00046200: 756e 6966 6965 6420 6469 6666 2066 6f72 unified diff for │ │ │ │ │ -00046210: 6d61 742c 2061 6e64 0a20 2020 2020 7772 mat, and. wr │ │ │ │ │ -00046220: 6974 6520 4368 616e 6765 4c6f 6720 656e ite ChangeLog en │ │ │ │ │ -00046230: 7472 6965 732e 2020 4275 742c 2065 7665 tries. But, eve │ │ │ │ │ -00046240: 6e20 7768 656e 2079 6f75 206d 616b 6520 n when you make │ │ │ │ │ -00046250: 6120 7061 7463 682c 2064 6f6e 2774 0a20 a patch, don't. │ │ │ │ │ -00046260: 2020 2020 666f 7267 6574 2074 6f20 6578 forget to ex │ │ │ │ │ -00046270: 706c 6169 6e20 7468 6520 7072 6f62 6c65 plain the proble │ │ │ │ │ -00046280: 6d2c 2073 6f20 7468 6174 2077 6520 6361 m, so that we ca │ │ │ │ │ -00046290: 6e20 756e 6465 7273 7461 6e64 2077 6861 n understand wha │ │ │ │ │ -000462a0: 7420 796f 7572 0a20 2020 2020 7061 7463 t your. patc │ │ │ │ │ -000462b0: 6820 6973 2066 6f72 2e0a 0a20 2037 2e20 h is for... 7. │ │ │ │ │ -000462c0: 5772 6974 6520 646f 776e 2061 6e79 7468 Write down anyth │ │ │ │ │ -000462d0: 696e 6720 7468 6174 2079 6f75 2074 6869 ing that you thi │ │ │ │ │ -000462e0: 6e6b 206d 6967 6874 2062 6520 7265 6c61 nk might be rela │ │ │ │ │ -000462f0: 7465 642e 2020 506c 6561 7365 0a20 2020 ted. Please. │ │ │ │ │ -00046300: 2020 756e 6465 7273 7461 6e64 2074 6861 understand tha │ │ │ │ │ -00046310: 7420 7765 206f 6674 656e 206e 6565 6420 t we often need │ │ │ │ │ -00046320: 746f 2072 6570 726f 6475 6365 2074 6865 to reproduce the │ │ │ │ │ -00046330: 2073 616d 6520 7072 6f62 6c65 6d20 796f same problem yo │ │ │ │ │ -00046340: 750a 2020 2020 2065 6e63 6f75 6e74 6572 u. encounter │ │ │ │ │ -00046350: 6564 2069 6e20 6f75 7220 656e 7669 726f ed in our enviro │ │ │ │ │ -00046360: 6e6d 656e 742e 2020 536f 2079 6f75 7220 nment. So your │ │ │ │ │ -00046370: 696e 666f 726d 6174 696f 6e20 7368 6f75 information shou │ │ │ │ │ -00046380: 6c64 2062 650a 2020 2020 2073 7566 6669 ld be. suffi │ │ │ │ │ -00046390: 6369 656e 7420 666f 7220 7573 2074 6f20 cient for us to │ │ │ │ │ -000463a0: 646f 2074 6865 2073 616d 6520 7468 696e do the same thin │ │ │ │ │ -000463b0: 672d 2d44 6f6e 2774 2066 6f72 6765 7420 g--Don't forget │ │ │ │ │ -000463c0: 7468 6174 2077 6520 6361 6e6e 6f74 0a20 that we cannot. │ │ │ │ │ -000463d0: 2020 2020 7365 6520 796f 7572 2063 6f6d see your com │ │ │ │ │ -000463e0: 7075 7465 7220 6469 7265 6374 6c79 2e20 puter directly. │ │ │ │ │ -000463f0: 2049 6620 796f 7520 6172 6520 6e6f 7420 If you are not │ │ │ │ │ -00046400: 7375 7265 2077 6865 7468 6572 2074 6f20 sure whether to │ │ │ │ │ -00046410: 7374 6174 6520 610a 2020 2020 2066 6163 state a. fac │ │ │ │ │ -00046420: 7420 6f72 206c 6561 7665 2069 7420 6f75 t or leave it ou │ │ │ │ │ -00046430: 742c 2073 7461 7465 2069 7421 2020 5265 t, state it! Re │ │ │ │ │ -00046440: 706f 7274 696e 6720 746f 6f20 6d61 6e79 porting too many │ │ │ │ │ -00046450: 2074 6869 6e67 7320 6973 206d 7563 680a things is much. │ │ │ │ │ -00046460: 2020 2020 2062 6574 7465 7220 7468 616e better than │ │ │ │ │ -00046470: 206f 6d69 7474 696e 6720 736f 6d65 7468 omitting someth │ │ │ │ │ -00046480: 696e 6720 696d 706f 7274 616e 742e 0a0a ing important... │ │ │ │ │ -00046490: 2020 2049 6620 796f 7520 666f 6c6c 6f77 If you follow │ │ │ │ │ -000464a0: 2074 6865 2067 7569 6465 6c69 6e65 2061 the guideline a │ │ │ │ │ -000464b0: 626f 7665 2c20 7375 626d 6974 2061 2072 bove, submit a r │ │ │ │ │ -000464c0: 6570 6f72 7420 746f 2074 6865 2042 7567 eport to the Bug │ │ │ │ │ -000464d0: 0a54 7261 636b 696e 6720 5379 7374 656d .Tracking System │ │ │ │ │ -000464e0: 2028 6874 7470 3a2f 2f73 6176 616e 6e61 (http://savanna │ │ │ │ │ -000464f0: 682e 676e 752e 6f72 672f 6275 6773 2f3f h.gnu.org/bugs/? │ │ │ │ │ -00046500: 6772 6f75 703d 6772 7562 292e 0a41 6c74 group=grub)..Alt │ │ │ │ │ -00046510: 6572 6e61 7469 7665 6c79 2c20 796f 7520 ernatively, you │ │ │ │ │ -00046520: 6361 6e20 7375 626d 6974 2061 2072 6570 can submit a rep │ │ │ │ │ -00046530: 6f72 7420 7669 6120 656c 6563 7472 6f6e ort via electron │ │ │ │ │ -00046540: 6963 206d 6169 6c20 746f 0a3c 6275 672d ic mail to., b │ │ │ │ │ -00046560: 7574 2077 6520 7374 726f 6e67 6c79 2072 ut we strongly r │ │ │ │ │ -00046570: 6563 6f6d 6d65 6e64 2074 6861 7420 796f ecommend that yo │ │ │ │ │ -00046580: 7520 7573 6520 7468 6520 4275 670a 5472 u use the Bug.Tr │ │ │ │ │ -00046590: 6163 6b69 6e67 2053 7973 7465 6d2c 2062 acking System, b │ │ │ │ │ -000465a0: 6563 6175 7365 2065 2d6d 6169 6c20 6361 ecause e-mail ca │ │ │ │ │ -000465b0: 6e20 6265 2070 6173 7365 6420 6f76 6572 n be passed over │ │ │ │ │ -000465c0: 2065 6173 696c 792e 0a0a 2020 204f 6e63 easily... Onc │ │ │ │ │ -000465d0: 6520 7765 2067 6574 2079 6f75 7220 7265 e we get your re │ │ │ │ │ -000465e0: 706f 7274 2c20 7765 2077 696c 6c20 7472 port, we will tr │ │ │ │ │ -000465f0: 7920 746f 2066 6978 2074 6865 2062 7567 y to fix the bug │ │ │ │ │ -00046600: 732e 0a0a 1f0a 4669 6c65 3a20 6772 7562 s.....File: grub │ │ │ │ │ -00046610: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 4675 .info, Node: Fu │ │ │ │ │ -00046620: 7475 7265 2c20 204e 6578 743a 2043 6f70 ture, Next: Cop │ │ │ │ │ -00046630: 7969 6e67 2054 6869 7320 4d61 6e75 616c ying This Manual │ │ │ │ │ -00046640: 2c20 2050 7265 763a 2052 6570 6f72 7469 , Prev: Reporti │ │ │ │ │ -00046650: 6e67 2062 7567 732c 2020 5570 3a20 546f ng bugs, Up: To │ │ │ │ │ -00046660: 700a 0a41 7070 656e 6469 7820 4320 5768 p..Appendix C Wh │ │ │ │ │ -00046670: 6572 6520 4752 5542 2077 696c 6c20 676f ere GRUB will go │ │ │ │ │ -00046680: 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a .*************** │ │ │ │ │ -00046690: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 0a0a **************.. │ │ │ │ │ -000466a0: 4752 5542 2032 2069 7320 6e6f 7720 7175 GRUB 2 is now qu │ │ │ │ │ -000466b0: 6974 6520 7374 6162 6c65 2061 6e64 2075 ite stable and u │ │ │ │ │ -000466c0: 7365 6420 696e 206d 616e 7920 7072 6f64 sed in many prod │ │ │ │ │ -000466d0: 7563 7469 6f6e 2073 7973 7465 6d73 2e20 uction systems. │ │ │ │ │ -000466e0: 2057 6520 6172 650a 6375 7272 656e 746c We are.currentl │ │ │ │ │ -000466f0: 7920 776f 726b 696e 6720 746f 7761 7264 y working toward │ │ │ │ │ -00046700: 7320 6120 322e 3020 7265 6c65 6173 652e s a 2.0 release. │ │ │ │ │ -00046710: 0a0a 2020 2049 6620 796f 7520 6172 6520 .. If you are │ │ │ │ │ -00046720: 696e 7465 7265 7374 6564 2069 6e20 7468 interested in th │ │ │ │ │ -00046730: 6520 6465 7665 6c6f 706d 656e 7420 6f66 e development of │ │ │ │ │ -00046740: 2047 5255 4220 322c 2074 616b 6520 6120 GRUB 2, take a │ │ │ │ │ -00046750: 6c6f 6f6b 2061 740a 7468 6520 686f 6d65 look at.the home │ │ │ │ │ -00046760: 7061 6765 2028 6874 7470 3a2f 2f77 7777 page (http://www │ │ │ │ │ -00046770: 2e67 6e75 2e6f 7267 2f73 6f66 7477 6172 .gnu.org/softwar │ │ │ │ │ -00046780: 652f 6772 7562 2f67 7275 622e 6874 6d6c e/grub/grub.html │ │ │ │ │ -00046790: 292e 0a0a 1f0a 4669 6c65 3a20 6772 7562 ).....File: grub │ │ │ │ │ -000467a0: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 436f .info, Node: Co │ │ │ │ │ -000467b0: 7079 696e 6720 5468 6973 204d 616e 7561 pying This Manua │ │ │ │ │ -000467c0: 6c2c 2020 4e65 7874 3a20 496e 6465 782c l, Next: Index, │ │ │ │ │ -000467d0: 2020 5072 6576 3a20 4675 7475 7265 2c20 Prev: Future, │ │ │ │ │ -000467e0: 2055 703a 2054 6f70 0a0a 4170 7065 6e64 Up: Top..Append │ │ │ │ │ -000467f0: 6978 2044 2043 6f70 7969 6e67 2054 6869 ix D Copying Thi │ │ │ │ │ -00046800: 7320 4d61 6e75 616c 0a2a 2a2a 2a2a 2a2a s Manual.******* │ │ │ │ │ +000456f0: 2a2a 2a2a 2a0a 0a20 2020 2020 2a43 6175 *****.. *Cau │ │ │ │ │ +00045700: 7469 6f6e 3a2a 2047 5255 4220 7265 7175 tion:* GRUB requ │ │ │ │ │ +00045710: 6972 6573 2062 696e 7574 696c 732d 322e ires binutils-2. │ │ │ │ │ +00045720: 392e 312e 302e 3233 206f 7220 6c61 7465 9.1.0.23 or late │ │ │ │ │ +00045730: 7220 6265 6361 7573 6520 7468 650a 2020 r because the. │ │ │ │ │ +00045740: 2020 2047 4e55 2061 7373 656d 626c 6572 GNU assembler │ │ │ │ │ +00045750: 2068 6173 2062 6565 6e20 6368 616e 6765 has been change │ │ │ │ │ +00045760: 6420 736f 2074 6861 7420 6974 2063 616e d so that it can │ │ │ │ │ +00045770: 2070 726f 6475 6365 2072 6561 6c20 3136 produce real 16 │ │ │ │ │ +00045780: 6269 7473 0a20 2020 2020 6d61 6368 696e bits. machin │ │ │ │ │ +00045790: 6520 636f 6465 2062 6574 7765 656e 2032 e code between 2 │ │ │ │ │ +000457a0: 2e39 2e31 2061 6e64 2032 2e39 2e31 2e30 .9.1 and 2.9.1.0 │ │ │ │ │ +000457b0: 2e78 2e20 2053 6565 0a20 2020 2020 3c68 .x. See. , to obtain i │ │ │ │ │ +000457f0: 6e66 6f72 6d61 7469 6f6e 206f 6e20 686f nformation on ho │ │ │ │ │ +00045800: 770a 2020 2020 2074 6f20 6765 7420 7468 w. to get th │ │ │ │ │ +00045810: 6520 6c61 7465 7374 2076 6572 7369 6f6e e latest version │ │ │ │ │ +00045820: 2e0a 0a20 2020 4752 5542 2069 7320 6176 ... GRUB is av │ │ │ │ │ +00045830: 6169 6c61 626c 6520 6672 6f6d 2074 6865 ailable from the │ │ │ │ │ +00045840: 2047 4e55 2061 6c70 6861 2061 7263 6869 GNU alpha archi │ │ │ │ │ +00045850: 7665 2073 6974 650a 3c66 7470 3a2f 2f66 ve site. or any of i │ │ │ │ │ +00045880: 7473 206d 6972 726f 7273 2e20 2054 6865 ts mirrors. The │ │ │ │ │ +00045890: 2066 696c 6520 7769 6c6c 2062 650a 6e61 file will be.na │ │ │ │ │ +000458a0: 6d65 6420 6772 7562 2d76 6572 7369 6f6e med grub-version │ │ │ │ │ +000458b0: 2e74 6172 2e67 7a2e 2020 5468 6520 6375 .tar.gz. The cu │ │ │ │ │ +000458c0: 7272 656e 7420 7665 7273 696f 6e20 6973 rrent version is │ │ │ │ │ +000458d0: 2032 2e30 362c 2073 6f20 7468 6520 6669 2.06, so the fi │ │ │ │ │ +000458e0: 6c65 2079 6f75 0a73 686f 756c 6420 6772 le you.should gr │ │ │ │ │ +000458f0: 6162 2069 733a 0a0a 2020 203c 6674 703a ab is:.. .. To │ │ │ │ │ +00045930: 756e 6275 6e64 6c65 2047 5255 4220 7573 unbundle GRUB us │ │ │ │ │ +00045940: 6520 7468 6520 696e 7374 7275 6374 696f e the instructio │ │ │ │ │ +00045950: 6e3a 0a0a 2020 2020 207a 6361 7420 6772 n:.. zcat gr │ │ │ │ │ +00045960: 7562 2d32 2e30 362e 7461 722e 677a 207c ub-2.06.tar.gz | │ │ │ │ │ +00045970: 2074 6172 2078 7666 202d 0a0a 2020 2077 tar xvf -.. w │ │ │ │ │ +00045980: 6869 6368 2077 696c 6c20 6372 6561 7465 hich will create │ │ │ │ │ +00045990: 2061 2064 6972 6563 746f 7279 2063 616c a directory cal │ │ │ │ │ +000459a0: 6c65 6420 2767 7275 622d 322e 3036 2720 led 'grub-2.06' │ │ │ │ │ +000459b0: 7769 7468 2061 6c6c 2074 6865 0a73 6f75 with all the.sou │ │ │ │ │ +000459c0: 7263 6573 2e20 2059 6f75 2063 616e 206c rces. You can l │ │ │ │ │ +000459d0: 6f6f 6b20 6174 2074 6865 2066 696c 6520 ook at the file │ │ │ │ │ +000459e0: 2749 4e53 5441 4c4c 2720 666f 7220 6465 'INSTALL' for de │ │ │ │ │ +000459f0: 7461 696c 6564 2069 6e73 7472 7563 7469 tailed instructi │ │ │ │ │ +00045a00: 6f6e 730a 6f6e 2068 6f77 2074 6f20 6275 ons.on how to bu │ │ │ │ │ +00045a10: 696c 6420 616e 6420 696e 7374 616c 6c20 ild and install │ │ │ │ │ +00045a20: 4752 5542 2c20 6275 7420 796f 7520 7368 GRUB, but you sh │ │ │ │ │ +00045a30: 6f75 6c64 2062 6520 6162 6c65 2074 6f20 ould be able to │ │ │ │ │ +00045a40: 6a75 7374 2064 6f3a 0a0a 2020 2020 2063 just do:.. c │ │ │ │ │ +00045a50: 6420 6772 7562 2d32 2e30 360a 2020 2020 d grub-2.06. │ │ │ │ │ +00045a60: 202e 2f63 6f6e 6669 6775 7265 0a20 2020 ./configure. │ │ │ │ │ +00045a70: 2020 6d61 6b65 2069 6e73 7461 6c6c 0a0a make install.. │ │ │ │ │ +00045a80: 2020 2041 6c73 6f2c 2074 6865 206c 6174 Also, the lat │ │ │ │ │ +00045a90: 6573 7420 7665 7273 696f 6e20 6973 2061 est version is a │ │ │ │ │ +00045aa0: 7661 696c 6162 6c65 2075 7369 6e67 2047 vailable using G │ │ │ │ │ +00045ab0: 6974 2e20 2053 6565 0a3c 6874 7470 3a2f it. See. f │ │ │ │ │ +00045af0: 6f72 206d 6f72 650a 696e 666f 726d 6174 or more.informat │ │ │ │ │ +00045b00: 696f 6e2e 0a0a 1f0a 4669 6c65 3a20 6772 ion.....File: gr │ │ │ │ │ +00045b10: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00045b20: 5265 706f 7274 696e 6720 6275 6773 2c20 Reporting bugs, │ │ │ │ │ +00045b30: 204e 6578 743a 2046 7574 7572 652c 2020 Next: Future, │ │ │ │ │ +00045b40: 5072 6576 3a20 4f62 7461 696e 696e 6720 Prev: Obtaining │ │ │ │ │ +00045b50: 616e 6420 4275 696c 6469 6e67 2047 5255 and Building GRU │ │ │ │ │ +00045b60: 422c 2020 5570 3a20 546f 700a 0a41 7070 B, Up: Top..App │ │ │ │ │ +00045b70: 656e 6469 7820 4220 5265 706f 7274 696e endix B Reportin │ │ │ │ │ +00045b80: 6720 6275 6773 0a2a 2a2a 2a2a 2a2a 2a2a g bugs.********* │ │ │ │ │ +00045b90: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +00045ba0: 0a0a 5468 6573 6520 6172 6520 7468 6520 ..These are the │ │ │ │ │ +00045bb0: 6775 6964 656c 696e 6520 666f 7220 686f guideline for ho │ │ │ │ │ +00045bc0: 7720 746f 2072 6570 6f72 7420 6275 6773 w to report bugs │ │ │ │ │ +00045bd0: 2e20 2054 616b 6520 6120 6c6f 6f6b 2061 . Take a look a │ │ │ │ │ +00045be0: 7420 7468 6973 0a6c 6973 7420 6265 6c6f t this.list belo │ │ │ │ │ +00045bf0: 7720 6265 666f 7265 2079 6f75 2073 7562 w before you sub │ │ │ │ │ +00045c00: 6d69 7420 6275 6773 3a0a 0a20 2031 2e20 mit bugs:.. 1. │ │ │ │ │ +00045c10: 4265 666f 7265 2067 6574 7469 6e67 2075 Before getting u │ │ │ │ │ +00045c20: 6e73 6574 746c 6564 2c20 7265 6164 2074 nsettled, read t │ │ │ │ │ +00045c30: 6869 7320 6d61 6e75 616c 2074 6872 6f75 his manual throu │ │ │ │ │ +00045c40: 6768 2061 6e64 2074 6872 6f75 6768 2e0a gh and through.. │ │ │ │ │ +00045c50: 2020 2020 2041 6c73 6f2c 2073 6565 2074 Also, see t │ │ │ │ │ +00045c60: 6865 2047 4e55 2047 5255 4220 4641 510a he GNU GRUB FAQ. │ │ │ │ │ +00045c70: 2020 2020 2028 6874 7470 3a2f 2f77 7777 (http://www │ │ │ │ │ +00045c80: 2e67 6e75 2e6f 7267 2f73 6f66 7477 6172 .gnu.org/softwar │ │ │ │ │ +00045c90: 652f 6772 7562 2f67 7275 622d 6661 712e e/grub/grub-faq. │ │ │ │ │ +00045ca0: 6874 6d6c 292e 0a0a 2020 322e 2041 6c77 html)... 2. Alw │ │ │ │ │ +00045cb0: 6179 7320 6d65 6e74 696f 6e20 7468 6520 ays mention the │ │ │ │ │ +00045cc0: 696e 666f 726d 6174 696f 6e20 6f6e 2079 information on y │ │ │ │ │ +00045cd0: 6f75 7220 4752 5542 2e20 5468 6520 7665 our GRUB. The ve │ │ │ │ │ +00045ce0: 7273 696f 6e20 6e75 6d62 6572 2061 6e64 rsion number and │ │ │ │ │ +00045cf0: 0a20 2020 2020 7468 6520 636f 6e66 6967 . the config │ │ │ │ │ +00045d00: 7572 6174 696f 6e20 6172 6520 7175 6974 uration are quit │ │ │ │ │ +00045d10: 6520 696d 706f 7274 616e 742e 2020 4966 e important. If │ │ │ │ │ +00045d20: 2079 6f75 2062 7569 6c64 2069 7420 796f you build it yo │ │ │ │ │ +00045d30: 7572 7365 6c66 2c0a 2020 2020 2077 7269 urself,. wri │ │ │ │ │ +00045d40: 7465 2074 6865 206f 7074 696f 6e73 2073 te the options s │ │ │ │ │ +00045d50: 7065 6369 6669 6564 2074 6f20 7468 6520 pecified to the │ │ │ │ │ +00045d60: 636f 6e66 6967 7572 6520 7363 7269 7074 configure script │ │ │ │ │ +00045d70: 2061 6e64 2079 6f75 720a 2020 2020 206f and your. o │ │ │ │ │ +00045d80: 7065 7261 7469 6e67 2073 7973 7465 6d2c perating system, │ │ │ │ │ +00045d90: 2069 6e63 6c75 6469 6e67 2074 6865 2076 including the v │ │ │ │ │ +00045da0: 6572 7369 6f6e 7320 6f66 2067 6363 2061 ersions of gcc a │ │ │ │ │ +00045db0: 6e64 2062 696e 7574 696c 732e 0a0a 2020 nd binutils... │ │ │ │ │ +00045dc0: 332e 2049 6620 796f 7520 6861 7665 2074 3. If you have t │ │ │ │ │ +00045dd0: 726f 7562 6c65 2077 6974 6820 7468 6520 rouble with the │ │ │ │ │ +00045de0: 696e 7374 616c 6c61 7469 6f6e 2c20 696e installation, in │ │ │ │ │ +00045df0: 666f 726d 2075 7320 6f66 2068 6f77 2079 form us of how y │ │ │ │ │ +00045e00: 6f75 0a20 2020 2020 696e 7374 616c 6c65 ou. installe │ │ │ │ │ +00045e10: 6420 4752 5542 2e20 446f 6e27 7420 6f6d d GRUB. Don't om │ │ │ │ │ +00045e20: 6974 2065 7272 6f72 206d 6573 7361 6765 it error message │ │ │ │ │ +00045e30: 732c 2069 6620 616e 792e 2020 4a75 7374 s, if any. Just │ │ │ │ │ +00045e40: 2027 4752 5542 0a20 2020 2020 6861 6e67 'GRUB. hang │ │ │ │ │ +00045e50: 7320 7570 2077 6865 6e20 6974 2062 6f6f s up when it boo │ │ │ │ │ +00045e60: 7473 2720 6973 206e 6f74 2065 6e6f 7567 ts' is not enoug │ │ │ │ │ +00045e70: 682e 0a0a 2020 2020 2054 6865 2069 6e66 h... The inf │ │ │ │ │ +00045e80: 6f72 6d61 7469 6f6e 206f 6e20 796f 7572 ormation on your │ │ │ │ │ +00045e90: 2068 6172 6477 6172 6520 6973 2061 6c73 hardware is als │ │ │ │ │ +00045ea0: 6f20 6573 7365 6e74 6961 6c2e 2020 5468 o essential. Th │ │ │ │ │ +00045eb0: 6573 6520 6172 650a 2020 2020 2065 7370 ese are. esp │ │ │ │ │ +00045ec0: 6563 6961 6c6c 7920 696d 706f 7274 616e ecially importan │ │ │ │ │ +00045ed0: 743a 2074 6865 2067 656f 6d65 7472 6965 t: the geometrie │ │ │ │ │ +00045ee0: 7320 616e 6420 7468 6520 7061 7274 6974 s and the partit │ │ │ │ │ +00045ef0: 696f 6e20 7461 626c 6573 206f 660a 2020 ion tables of. │ │ │ │ │ +00045f00: 2020 2079 6f75 7220 6861 7264 2064 6973 your hard dis │ │ │ │ │ +00045f10: 6b20 6472 6976 6573 2061 6e64 2079 6f75 k drives and you │ │ │ │ │ +00045f20: 7220 4249 4f53 2e0a 0a20 2034 2e20 4966 r BIOS... 4. If │ │ │ │ │ +00045f30: 2047 5255 4220 6361 6e6e 6f74 2062 6f6f GRUB cannot boo │ │ │ │ │ +00045f40: 7420 796f 7572 206f 7065 7261 7469 6e67 t your operating │ │ │ │ │ +00045f50: 2073 7973 7465 6d2c 2077 7269 7465 2064 system, write d │ │ │ │ │ +00045f60: 6f77 6e20 5f65 7665 7279 7468 696e 675f own _everything_ │ │ │ │ │ +00045f70: 0a20 2020 2020 796f 7520 7365 6520 6f6e . you see on │ │ │ │ │ +00045f80: 2074 6865 2073 6372 6565 6e2e 2020 446f the screen. Do │ │ │ │ │ +00045f90: 6e27 7420 7061 7261 7068 7261 7365 2074 n't paraphrase t │ │ │ │ │ +00045fa0: 6865 6d2c 206c 696b 6520 2754 6865 2066 hem, like 'The f │ │ │ │ │ +00045fb0: 6f6f 204f 530a 2020 2020 2063 7261 7368 oo OS. crash │ │ │ │ │ +00045fc0: 6573 2077 6974 6820 4752 5542 2c20 6576 es with GRUB, ev │ │ │ │ │ +00045fd0: 656e 2074 686f 7567 6820 6974 2063 616e en though it can │ │ │ │ │ +00045fe0: 2062 6f6f 7420 7769 7468 2074 6865 2062 boot with the b │ │ │ │ │ +00045ff0: 6172 2062 6f6f 7420 6c6f 6164 6572 0a20 ar boot loader. │ │ │ │ │ +00046000: 2020 2020 6a75 7374 2066 696e 6527 2e20 just fine'. │ │ │ │ │ +00046010: 204d 656e 7469 6f6e 2074 6865 2063 6f6d Mention the com │ │ │ │ │ +00046020: 6d61 6e64 7320 796f 7520 6578 6563 7574 mands you execut │ │ │ │ │ +00046030: 6564 2c20 7468 6520 6d65 7373 6167 6573 ed, the messages │ │ │ │ │ +00046040: 0a20 2020 2020 7072 696e 7465 6420 6279 . printed by │ │ │ │ │ +00046050: 2074 6865 6d2c 2061 6e64 2069 6e66 6f72 them, and infor │ │ │ │ │ +00046060: 6d61 7469 6f6e 206f 6e20 796f 7572 206f mation on your o │ │ │ │ │ +00046070: 7065 7261 7469 6e67 2073 7973 7465 6d20 perating system │ │ │ │ │ +00046080: 696e 636c 7564 696e 670a 2020 2020 2074 including. t │ │ │ │ │ +00046090: 6865 2076 6572 7369 6f6e 206e 756d 6265 he version numbe │ │ │ │ │ +000460a0: 722e 0a0a 2020 352e 2045 7870 6c61 696e r... 5. Explain │ │ │ │ │ +000460b0: 2077 6861 7420 796f 7520 7761 6e74 6564 what you wanted │ │ │ │ │ +000460c0: 2074 6f20 646f 2e20 2049 7420 6973 2076 to do. It is v │ │ │ │ │ +000460d0: 6572 7920 7573 6566 756c 2074 6f20 6b6e ery useful to kn │ │ │ │ │ +000460e0: 6f77 2079 6f75 720a 2020 2020 2070 7572 ow your. pur │ │ │ │ │ +000460f0: 706f 7365 2061 6e64 2079 6f75 7220 7769 pose and your wi │ │ │ │ │ +00046100: 7368 2c20 616e 6420 686f 7720 4752 5542 sh, and how GRUB │ │ │ │ │ +00046110: 2064 6964 6e27 7420 7361 7469 7366 7920 didn't satisfy │ │ │ │ │ +00046120: 796f 752e 0a0a 2020 362e 2049 6620 796f you... 6. If yo │ │ │ │ │ +00046130: 7520 6361 6e20 696e 7665 7374 6967 6174 u can investigat │ │ │ │ │ +00046140: 6520 7468 6520 7072 6f62 6c65 6d20 796f e the problem yo │ │ │ │ │ +00046150: 7572 7365 6c66 2c20 706c 6561 7365 2064 urself, please d │ │ │ │ │ +00046160: 6f2e 2020 5468 6174 2077 696c 6c0a 2020 o. That will. │ │ │ │ │ +00046170: 2020 2067 6976 6520 796f 7520 616e 6420 give you and │ │ │ │ │ +00046180: 7573 206d 7563 6820 6d6f 7265 2069 6e66 us much more inf │ │ │ │ │ +00046190: 6f72 6d61 7469 6f6e 206f 6e20 7468 6520 ormation on the │ │ │ │ │ +000461a0: 7072 6f62 6c65 6d2e 2020 4174 7461 6368 problem. Attach │ │ │ │ │ +000461b0: 696e 6720 610a 2020 2020 2070 6174 6368 ing a. patch │ │ │ │ │ +000461c0: 2069 7320 6576 656e 2062 6574 7465 722e is even better. │ │ │ │ │ +000461d0: 0a0a 2020 2020 2057 6865 6e20 796f 7520 .. When you │ │ │ │ │ +000461e0: 6174 7461 6368 2061 2070 6174 6368 2c20 attach a patch, │ │ │ │ │ +000461f0: 6d61 6b65 2074 6865 2070 6174 6368 2069 make the patch i │ │ │ │ │ +00046200: 6e20 756e 6966 6965 6420 6469 6666 2066 n unified diff f │ │ │ │ │ +00046210: 6f72 6d61 742c 2061 6e64 0a20 2020 2020 ormat, and. │ │ │ │ │ +00046220: 7772 6974 6520 4368 616e 6765 4c6f 6720 write ChangeLog │ │ │ │ │ +00046230: 656e 7472 6965 732e 2020 4275 742c 2065 entries. But, e │ │ │ │ │ +00046240: 7665 6e20 7768 656e 2079 6f75 206d 616b ven when you mak │ │ │ │ │ +00046250: 6520 6120 7061 7463 682c 2064 6f6e 2774 e a patch, don't │ │ │ │ │ +00046260: 0a20 2020 2020 666f 7267 6574 2074 6f20 . forget to │ │ │ │ │ +00046270: 6578 706c 6169 6e20 7468 6520 7072 6f62 explain the prob │ │ │ │ │ +00046280: 6c65 6d2c 2073 6f20 7468 6174 2077 6520 lem, so that we │ │ │ │ │ +00046290: 6361 6e20 756e 6465 7273 7461 6e64 2077 can understand w │ │ │ │ │ +000462a0: 6861 7420 796f 7572 0a20 2020 2020 7061 hat your. pa │ │ │ │ │ +000462b0: 7463 6820 6973 2066 6f72 2e0a 0a20 2037 tch is for... 7 │ │ │ │ │ +000462c0: 2e20 5772 6974 6520 646f 776e 2061 6e79 . Write down any │ │ │ │ │ +000462d0: 7468 696e 6720 7468 6174 2079 6f75 2074 thing that you t │ │ │ │ │ +000462e0: 6869 6e6b 206d 6967 6874 2062 6520 7265 hink might be re │ │ │ │ │ +000462f0: 6c61 7465 642e 2020 506c 6561 7365 0a20 lated. Please. │ │ │ │ │ +00046300: 2020 2020 756e 6465 7273 7461 6e64 2074 understand t │ │ │ │ │ +00046310: 6861 7420 7765 206f 6674 656e 206e 6565 hat we often nee │ │ │ │ │ +00046320: 6420 746f 2072 6570 726f 6475 6365 2074 d to reproduce t │ │ │ │ │ +00046330: 6865 2073 616d 6520 7072 6f62 6c65 6d20 he same problem │ │ │ │ │ +00046340: 796f 750a 2020 2020 2065 6e63 6f75 6e74 you. encount │ │ │ │ │ +00046350: 6572 6564 2069 6e20 6f75 7220 656e 7669 ered in our envi │ │ │ │ │ +00046360: 726f 6e6d 656e 742e 2020 536f 2079 6f75 ronment. So you │ │ │ │ │ +00046370: 7220 696e 666f 726d 6174 696f 6e20 7368 r information sh │ │ │ │ │ +00046380: 6f75 6c64 2062 650a 2020 2020 2073 7566 ould be. suf │ │ │ │ │ +00046390: 6669 6369 656e 7420 666f 7220 7573 2074 ficient for us t │ │ │ │ │ +000463a0: 6f20 646f 2074 6865 2073 616d 6520 7468 o do the same th │ │ │ │ │ +000463b0: 696e 672d 2d44 6f6e 2774 2066 6f72 6765 ing--Don't forge │ │ │ │ │ +000463c0: 7420 7468 6174 2077 6520 6361 6e6e 6f74 t that we cannot │ │ │ │ │ +000463d0: 0a20 2020 2020 7365 6520 796f 7572 2063 . see your c │ │ │ │ │ +000463e0: 6f6d 7075 7465 7220 6469 7265 6374 6c79 omputer directly │ │ │ │ │ +000463f0: 2e20 2049 6620 796f 7520 6172 6520 6e6f . If you are no │ │ │ │ │ +00046400: 7420 7375 7265 2077 6865 7468 6572 2074 t sure whether t │ │ │ │ │ +00046410: 6f20 7374 6174 6520 610a 2020 2020 2066 o state a. f │ │ │ │ │ +00046420: 6163 7420 6f72 206c 6561 7665 2069 7420 act or leave it │ │ │ │ │ +00046430: 6f75 742c 2073 7461 7465 2069 7421 2020 out, state it! │ │ │ │ │ +00046440: 5265 706f 7274 696e 6720 746f 6f20 6d61 Reporting too ma │ │ │ │ │ +00046450: 6e79 2074 6869 6e67 7320 6973 206d 7563 ny things is muc │ │ │ │ │ +00046460: 680a 2020 2020 2062 6574 7465 7220 7468 h. better th │ │ │ │ │ +00046470: 616e 206f 6d69 7474 696e 6720 736f 6d65 an omitting some │ │ │ │ │ +00046480: 7468 696e 6720 696d 706f 7274 616e 742e thing important. │ │ │ │ │ +00046490: 0a0a 2020 2049 6620 796f 7520 666f 6c6c .. If you foll │ │ │ │ │ +000464a0: 6f77 2074 6865 2067 7569 6465 6c69 6e65 ow the guideline │ │ │ │ │ +000464b0: 2061 626f 7665 2c20 7375 626d 6974 2061 above, submit a │ │ │ │ │ +000464c0: 2072 6570 6f72 7420 746f 2074 6865 2042 report to the B │ │ │ │ │ +000464d0: 7567 0a54 7261 636b 696e 6720 5379 7374 ug.Tracking Syst │ │ │ │ │ +000464e0: 656d 2028 6874 7470 3a2f 2f73 6176 616e em (http://savan │ │ │ │ │ +000464f0: 6e61 682e 676e 752e 6f72 672f 6275 6773 nah.gnu.org/bugs │ │ │ │ │ +00046500: 2f3f 6772 6f75 703d 6772 7562 292e 0a41 /?group=grub)..A │ │ │ │ │ +00046510: 6c74 6572 6e61 7469 7665 6c79 2c20 796f lternatively, yo │ │ │ │ │ +00046520: 7520 6361 6e20 7375 626d 6974 2061 2072 u can submit a r │ │ │ │ │ +00046530: 6570 6f72 7420 7669 6120 656c 6563 7472 eport via electr │ │ │ │ │ +00046540: 6f6e 6963 206d 6169 6c20 746f 0a3c 6275 onic mail to., │ │ │ │ │ +00046560: 2062 7574 2077 6520 7374 726f 6e67 6c79 but we strongly │ │ │ │ │ +00046570: 2072 6563 6f6d 6d65 6e64 2074 6861 7420 recommend that │ │ │ │ │ +00046580: 796f 7520 7573 6520 7468 6520 4275 670a you use the Bug. │ │ │ │ │ +00046590: 5472 6163 6b69 6e67 2053 7973 7465 6d2c Tracking System, │ │ │ │ │ +000465a0: 2062 6563 6175 7365 2065 2d6d 6169 6c20 because e-mail │ │ │ │ │ +000465b0: 6361 6e20 6265 2070 6173 7365 6420 6f76 can be passed ov │ │ │ │ │ +000465c0: 6572 2065 6173 696c 792e 0a0a 2020 204f er easily... O │ │ │ │ │ +000465d0: 6e63 6520 7765 2067 6574 2079 6f75 7220 nce we get your │ │ │ │ │ +000465e0: 7265 706f 7274 2c20 7765 2077 696c 6c20 report, we will │ │ │ │ │ +000465f0: 7472 7920 746f 2066 6978 2074 6865 2062 try to fix the b │ │ │ │ │ +00046600: 7567 732e 0a0a 1f0a 4669 6c65 3a20 6772 ugs.....File: gr │ │ │ │ │ +00046610: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +00046620: 4675 7475 7265 2c20 204e 6578 743a 2043 Future, Next: C │ │ │ │ │ +00046630: 6f70 7969 6e67 2054 6869 7320 4d61 6e75 opying This Manu │ │ │ │ │ +00046640: 616c 2c20 2050 7265 763a 2052 6570 6f72 al, Prev: Repor │ │ │ │ │ +00046650: 7469 6e67 2062 7567 732c 2020 5570 3a20 ting bugs, Up: │ │ │ │ │ +00046660: 546f 700a 0a41 7070 656e 6469 7820 4320 Top..Appendix C │ │ │ │ │ +00046670: 5768 6572 6520 4752 5542 2077 696c 6c20 Where GRUB will │ │ │ │ │ +00046680: 676f 0a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a go.************* │ │ │ │ │ +00046690: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ +000466a0: 0a0a 4752 5542 2032 2069 7320 6e6f 7720 ..GRUB 2 is now │ │ │ │ │ +000466b0: 7175 6974 6520 7374 6162 6c65 2061 6e64 quite stable and │ │ │ │ │ +000466c0: 2075 7365 6420 696e 206d 616e 7920 7072 used in many pr │ │ │ │ │ +000466d0: 6f64 7563 7469 6f6e 2073 7973 7465 6d73 oduction systems │ │ │ │ │ +000466e0: 2e20 2057 6520 6172 650a 6375 7272 656e . We are.curren │ │ │ │ │ +000466f0: 746c 7920 776f 726b 696e 6720 746f 7761 tly working towa │ │ │ │ │ +00046700: 7264 7320 6120 322e 3020 7265 6c65 6173 rds a 2.0 releas │ │ │ │ │ +00046710: 652e 0a0a 2020 2049 6620 796f 7520 6172 e... If you ar │ │ │ │ │ +00046720: 6520 696e 7465 7265 7374 6564 2069 6e20 e interested in │ │ │ │ │ +00046730: 7468 6520 6465 7665 6c6f 706d 656e 7420 the development │ │ │ │ │ +00046740: 6f66 2047 5255 4220 322c 2074 616b 6520 of GRUB 2, take │ │ │ │ │ +00046750: 6120 6c6f 6f6b 2061 740a 7468 6520 686f a look at.the ho │ │ │ │ │ +00046760: 6d65 7061 6765 2028 6874 7470 3a2f 2f77 mepage (http://w │ │ │ │ │ +00046770: 7777 2e67 6e75 2e6f 7267 2f73 6f66 7477 ww.gnu.org/softw │ │ │ │ │ +00046780: 6172 652f 6772 7562 2f67 7275 622e 6874 are/grub/grub.ht │ │ │ │ │ +00046790: 6d6c 292e 0a0a 1f0a 4669 6c65 3a20 6772 ml).....File: gr │ │ │ │ │ +000467a0: 7562 2e69 6e66 6f2c 2020 4e6f 6465 3a20 ub.info, Node: │ │ │ │ │ +000467b0: 436f 7079 696e 6720 5468 6973 204d 616e Copying This Man │ │ │ │ │ +000467c0: 7561 6c2c 2020 4e65 7874 3a20 496e 6465 ual, Next: Inde │ │ │ │ │ +000467d0: 782c 2020 5072 6576 3a20 4675 7475 7265 x, Prev: Future │ │ │ │ │ +000467e0: 2c20 2055 703a 2054 6f70 0a0a 4170 7065 , Up: Top..Appe │ │ │ │ │ +000467f0: 6e64 6978 2044 2043 6f70 7969 6e67 2054 ndix D Copying T │ │ │ │ │ +00046800: 6869 7320 4d61 6e75 616c 0a2a 2a2a 2a2a his Manual.***** │ │ │ │ │ 00046810: 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a 2a2a **************** │ │ │ │ │ -00046820: 2a2a 2a2a 2a2a 2a0a 0a2a 204d 656e 753a *******..* Menu: │ │ │ │ │ -00046830: 0a0a 2a20 474e 5520 4672 6565 2044 6f63 ..* GNU Free Doc │ │ │ │ │ -00046840: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ -00046850: 7365 3a3a 2020 4c69 6365 6e73 6520 666f se:: License fo │ │ │ │ │ -00046860: 7220 636f 7079 696e 6720 7468 6973 206d r copying this m │ │ │ │ │ -00046870: 616e 7561 6c2e 0a0a 1f0a 4669 6c65 3a20 anual.....File: │ │ │ │ │ -00046880: 6772 7562 2e69 6e66 6f2c 2020 4e6f 6465 grub.info, Node │ │ │ │ │ -00046890: 3a20 474e 5520 4672 6565 2044 6f63 756d : GNU Free Docum │ │ │ │ │ -000468a0: 656e 7461 7469 6f6e 204c 6963 656e 7365 entation License │ │ │ │ │ -000468b0: 2c20 2055 703a 2043 6f70 7969 6e67 2054 , Up: Copying T │ │ │ │ │ -000468c0: 6869 7320 4d61 6e75 616c 0a0a 442e 3120 his Manual..D.1 │ │ │ │ │ -000468d0: 474e 5520 4672 6565 2044 6f63 756d 656e GNU Free Documen │ │ │ │ │ -000468e0: 7461 7469 6f6e 204c 6963 656e 7365 0a3d tation License.= │ │ │ │ │ -000468f0: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ +00046820: 2a2a 2a2a 2a2a 2a2a 2a0a 0a2a 204d 656e *********..* Men │ │ │ │ │ +00046830: 753a 0a0a 2a20 474e 5520 4672 6565 2044 u:..* GNU Free D │ │ │ │ │ +00046840: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ +00046850: 656e 7365 3a3a 2020 4c69 6365 6e73 6520 ense:: License │ │ │ │ │ +00046860: 666f 7220 636f 7079 696e 6720 7468 6973 for copying this │ │ │ │ │ +00046870: 206d 616e 7561 6c2e 0a0a 1f0a 4669 6c65 manual.....File │ │ │ │ │ +00046880: 3a20 6772 7562 2e69 6e66 6f2c 2020 4e6f : grub.info, No │ │ │ │ │ +00046890: 6465 3a20 474e 5520 4672 6565 2044 6f63 de: GNU Free Doc │ │ │ │ │ +000468a0: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ +000468b0: 7365 2c20 2055 703a 2043 6f70 7969 6e67 se, Up: Copying │ │ │ │ │ +000468c0: 2054 6869 7320 4d61 6e75 616c 0a0a 442e This Manual..D. │ │ │ │ │ +000468d0: 3120 474e 5520 4672 6565 2044 6f63 756d 1 GNU Free Docum │ │ │ │ │ +000468e0: 656e 7461 7469 6f6e 204c 6963 656e 7365 entation License │ │ │ │ │ +000468f0: 0a3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d .=============== │ │ │ │ │ 00046900: 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d 3d3d ================ │ │ │ │ │ -00046910: 3d0a 0a20 2020 2020 2020 2020 2020 2020 =.. │ │ │ │ │ -00046920: 2020 2020 2020 2020 2056 6572 7369 6f6e Version │ │ │ │ │ -00046930: 2031 2e32 2c20 4e6f 7665 6d62 6572 2032 1.2, November 2 │ │ │ │ │ -00046940: 3030 320a 0a20 2020 2020 436f 7079 7269 002.. Copyri │ │ │ │ │ -00046950: 6768 7420 2843 2920 3230 3030 2c32 3030 ght (C) 2000,200 │ │ │ │ │ -00046960: 312c 3230 3032 2046 7265 6520 536f 6674 1,2002 Free Soft │ │ │ │ │ -00046970: 7761 7265 2046 6f75 6e64 6174 696f 6e2c ware Foundation, │ │ │ │ │ -00046980: 2049 6e63 2e0a 2020 2020 2035 3120 4672 Inc.. 51 Fr │ │ │ │ │ -00046990: 616e 6b6c 696e 2053 742c 2046 6966 7468 anklin St, Fifth │ │ │ │ │ -000469a0: 2046 6c6f 6f72 2c20 426f 7374 6f6e 2c20 Floor, Boston, │ │ │ │ │ -000469b0: 4d41 2020 3032 3131 302d 3133 3031 2c20 MA 02110-1301, │ │ │ │ │ -000469c0: 5553 410a 0a20 2020 2020 4576 6572 796f USA.. Everyo │ │ │ │ │ -000469d0: 6e65 2069 7320 7065 726d 6974 7465 6420 ne is permitted │ │ │ │ │ -000469e0: 746f 2063 6f70 7920 616e 6420 6469 7374 to copy and dist │ │ │ │ │ -000469f0: 7269 6275 7465 2076 6572 6261 7469 6d20 ribute verbatim │ │ │ │ │ -00046a00: 636f 7069 6573 0a20 2020 2020 6f66 2074 copies. of t │ │ │ │ │ -00046a10: 6869 7320 6c69 6365 6e73 6520 646f 6375 his license docu │ │ │ │ │ -00046a20: 6d65 6e74 2c20 6275 7420 6368 616e 6769 ment, but changi │ │ │ │ │ -00046a30: 6e67 2069 7420 6973 206e 6f74 2061 6c6c ng it is not all │ │ │ │ │ -00046a40: 6f77 6564 2e0a 0a20 2030 2e20 5052 4541 owed... 0. PREA │ │ │ │ │ -00046a50: 4d42 4c45 0a0a 2020 2020 2054 6865 2070 MBLE.. The p │ │ │ │ │ -00046a60: 7572 706f 7365 206f 6620 7468 6973 204c urpose of this L │ │ │ │ │ -00046a70: 6963 656e 7365 2069 7320 746f 206d 616b icense is to mak │ │ │ │ │ -00046a80: 6520 6120 6d61 6e75 616c 2c20 7465 7874 e a manual, text │ │ │ │ │ -00046a90: 626f 6f6b 2c20 6f72 206f 7468 6572 0a20 book, or other. │ │ │ │ │ -00046aa0: 2020 2020 6675 6e63 7469 6f6e 616c 2061 functional a │ │ │ │ │ -00046ab0: 6e64 2075 7365 6675 6c20 646f 6375 6d65 nd useful docume │ │ │ │ │ -00046ac0: 6e74 2022 6672 6565 2220 696e 2074 6865 nt "free" in the │ │ │ │ │ -00046ad0: 2073 656e 7365 206f 6620 6672 6565 646f sense of freedo │ │ │ │ │ -00046ae0: 6d3a 2074 6f0a 2020 2020 2061 7373 7572 m: to. assur │ │ │ │ │ -00046af0: 6520 6576 6572 796f 6e65 2074 6865 2065 e everyone the e │ │ │ │ │ -00046b00: 6666 6563 7469 7665 2066 7265 6564 6f6d ffective freedom │ │ │ │ │ -00046b10: 2074 6f20 636f 7079 2061 6e64 2072 6564 to copy and red │ │ │ │ │ -00046b20: 6973 7472 6962 7574 6520 6974 2c0a 2020 istribute it,. │ │ │ │ │ -00046b30: 2020 2077 6974 6820 6f72 2077 6974 686f with or witho │ │ │ │ │ -00046b40: 7574 206d 6f64 6966 7969 6e67 2069 742c ut modifying it, │ │ │ │ │ -00046b50: 2065 6974 6865 7220 636f 6d6d 6572 6369 either commerci │ │ │ │ │ -00046b60: 616c 6c79 206f 720a 2020 2020 206e 6f6e ally or. non │ │ │ │ │ -00046b70: 636f 6d6d 6572 6369 616c 6c79 2e20 2053 commercially. S │ │ │ │ │ -00046b80: 6563 6f6e 6461 7269 6c79 2c20 7468 6973 econdarily, this │ │ │ │ │ -00046b90: 204c 6963 656e 7365 2070 7265 7365 7276 License preserv │ │ │ │ │ -00046ba0: 6573 2066 6f72 2074 6865 0a20 2020 2020 es for the. │ │ │ │ │ -00046bb0: 6175 7468 6f72 2061 6e64 2070 7562 6c69 author and publi │ │ │ │ │ -00046bc0: 7368 6572 2061 2077 6179 2074 6f20 6765 sher a way to ge │ │ │ │ │ -00046bd0: 7420 6372 6564 6974 2066 6f72 2074 6865 t credit for the │ │ │ │ │ -00046be0: 6972 2077 6f72 6b2c 2077 6869 6c65 206e ir work, while n │ │ │ │ │ -00046bf0: 6f74 0a20 2020 2020 6265 696e 6720 636f ot. being co │ │ │ │ │ -00046c00: 6e73 6964 6572 6564 2072 6573 706f 6e73 nsidered respons │ │ │ │ │ -00046c10: 6962 6c65 2066 6f72 206d 6f64 6966 6963 ible for modific │ │ │ │ │ -00046c20: 6174 696f 6e73 206d 6164 6520 6279 206f ations made by o │ │ │ │ │ -00046c30: 7468 6572 732e 0a0a 2020 2020 2054 6869 thers... Thi │ │ │ │ │ -00046c40: 7320 4c69 6365 6e73 6520 6973 2061 206b s License is a k │ │ │ │ │ -00046c50: 696e 6420 6f66 2022 636f 7079 6c65 6674 ind of "copyleft │ │ │ │ │ -00046c60: 222c 2077 6869 6368 206d 6561 6e73 2074 ", which means t │ │ │ │ │ -00046c70: 6861 7420 6465 7269 7661 7469 7665 0a20 hat derivative. │ │ │ │ │ -00046c80: 2020 2020 776f 726b 7320 6f66 2074 6865 works of the │ │ │ │ │ -00046c90: 2064 6f63 756d 656e 7420 6d75 7374 2074 document must t │ │ │ │ │ -00046ca0: 6865 6d73 656c 7665 7320 6265 2066 7265 hemselves be fre │ │ │ │ │ -00046cb0: 6520 696e 2074 6865 2073 616d 6520 7365 e in the same se │ │ │ │ │ -00046cc0: 6e73 652e 0a20 2020 2020 4974 2063 6f6d nse.. It com │ │ │ │ │ -00046cd0: 706c 656d 656e 7473 2074 6865 2047 4e55 plements the GNU │ │ │ │ │ -00046ce0: 2047 656e 6572 616c 2050 7562 6c69 6320 General Public │ │ │ │ │ -00046cf0: 4c69 6365 6e73 652c 2077 6869 6368 2069 License, which i │ │ │ │ │ -00046d00: 7320 6120 636f 7079 6c65 6674 0a20 2020 s a copyleft. │ │ │ │ │ -00046d10: 2020 6c69 6365 6e73 6520 6465 7369 676e license design │ │ │ │ │ -00046d20: 6564 2066 6f72 2066 7265 6520 736f 6674 ed for free soft │ │ │ │ │ -00046d30: 7761 7265 2e0a 0a20 2020 2020 5765 2068 ware... We h │ │ │ │ │ -00046d40: 6176 6520 6465 7369 676e 6564 2074 6869 ave designed thi │ │ │ │ │ -00046d50: 7320 4c69 6365 6e73 6520 696e 206f 7264 s License in ord │ │ │ │ │ -00046d60: 6572 2074 6f20 7573 6520 6974 2066 6f72 er to use it for │ │ │ │ │ -00046d70: 206d 616e 7561 6c73 2066 6f72 0a20 2020 manuals for. │ │ │ │ │ -00046d80: 2020 6672 6565 2073 6f66 7477 6172 652c free software, │ │ │ │ │ -00046d90: 2062 6563 6175 7365 2066 7265 6520 736f because free so │ │ │ │ │ -00046da0: 6674 7761 7265 206e 6565 6473 2066 7265 ftware needs fre │ │ │ │ │ -00046db0: 6520 646f 6375 6d65 6e74 6174 696f 6e3a e documentation: │ │ │ │ │ -00046dc0: 2061 0a20 2020 2020 6672 6565 2070 726f a. free pro │ │ │ │ │ -00046dd0: 6772 616d 2073 686f 756c 6420 636f 6d65 gram should come │ │ │ │ │ -00046de0: 2077 6974 6820 6d61 6e75 616c 7320 7072 with manuals pr │ │ │ │ │ -00046df0: 6f76 6964 696e 6720 7468 6520 7361 6d65 oviding the same │ │ │ │ │ -00046e00: 2066 7265 6564 6f6d 730a 2020 2020 2074 freedoms. t │ │ │ │ │ -00046e10: 6861 7420 7468 6520 736f 6674 7761 7265 hat the software │ │ │ │ │ -00046e20: 2064 6f65 732e 2020 4275 7420 7468 6973 does. But this │ │ │ │ │ -00046e30: 204c 6963 656e 7365 2069 7320 6e6f 7420 License is not │ │ │ │ │ -00046e40: 6c69 6d69 7465 6420 746f 0a20 2020 2020 limited to. │ │ │ │ │ -00046e50: 736f 6674 7761 7265 206d 616e 7561 6c73 software manuals │ │ │ │ │ -00046e60: 3b20 6974 2063 616e 2062 6520 7573 6564 ; it can be used │ │ │ │ │ -00046e70: 2066 6f72 2061 6e79 2074 6578 7475 616c for any textual │ │ │ │ │ -00046e80: 2077 6f72 6b2c 2072 6567 6172 646c 6573 work, regardles │ │ │ │ │ -00046e90: 730a 2020 2020 206f 6620 7375 626a 6563 s. of subjec │ │ │ │ │ -00046ea0: 7420 6d61 7474 6572 206f 7220 7768 6574 t matter or whet │ │ │ │ │ -00046eb0: 6865 7220 6974 2069 7320 7075 626c 6973 her it is publis │ │ │ │ │ -00046ec0: 6865 6420 6173 2061 2070 7269 6e74 6564 hed as a printed │ │ │ │ │ -00046ed0: 2062 6f6f 6b2e 2020 5765 0a20 2020 2020 book. We. │ │ │ │ │ -00046ee0: 7265 636f 6d6d 656e 6420 7468 6973 204c recommend this L │ │ │ │ │ -00046ef0: 6963 656e 7365 2070 7269 6e63 6970 616c icense principal │ │ │ │ │ -00046f00: 6c79 2066 6f72 2077 6f72 6b73 2077 686f ly for works who │ │ │ │ │ -00046f10: 7365 2070 7572 706f 7365 2069 730a 2020 se purpose is. │ │ │ │ │ -00046f20: 2020 2069 6e73 7472 7563 7469 6f6e 206f instruction o │ │ │ │ │ -00046f30: 7220 7265 6665 7265 6e63 652e 0a0a 2020 r reference... │ │ │ │ │ -00046f40: 312e 2041 5050 4c49 4341 4249 4c49 5459 1. APPLICABILITY │ │ │ │ │ -00046f50: 2041 4e44 2044 4546 494e 4954 494f 4e53 AND DEFINITIONS │ │ │ │ │ -00046f60: 0a0a 2020 2020 2054 6869 7320 4c69 6365 .. This Lice │ │ │ │ │ -00046f70: 6e73 6520 6170 706c 6965 7320 746f 2061 nse applies to a │ │ │ │ │ -00046f80: 6e79 206d 616e 7561 6c20 6f72 206f 7468 ny manual or oth │ │ │ │ │ -00046f90: 6572 2077 6f72 6b2c 2069 6e20 616e 7920 er work, in any │ │ │ │ │ -00046fa0: 6d65 6469 756d 2c0a 2020 2020 2074 6861 medium,. tha │ │ │ │ │ -00046fb0: 7420 636f 6e74 6169 6e73 2061 206e 6f74 t contains a not │ │ │ │ │ -00046fc0: 6963 6520 706c 6163 6564 2062 7920 7468 ice placed by th │ │ │ │ │ -00046fd0: 6520 636f 7079 7269 6768 7420 686f 6c64 e copyright hold │ │ │ │ │ -00046fe0: 6572 2073 6179 696e 6720 6974 2063 616e er saying it can │ │ │ │ │ -00046ff0: 0a20 2020 2020 6265 2064 6973 7472 6962 . be distrib │ │ │ │ │ -00047000: 7574 6564 2075 6e64 6572 2074 6865 2074 uted under the t │ │ │ │ │ -00047010: 6572 6d73 206f 6620 7468 6973 204c 6963 erms of this Lic │ │ │ │ │ -00047020: 656e 7365 2e20 2053 7563 6820 6120 6e6f ense. Such a no │ │ │ │ │ -00047030: 7469 6365 0a20 2020 2020 6772 616e 7473 tice. grants │ │ │ │ │ -00047040: 2061 2077 6f72 6c64 2d77 6964 652c 2072 a world-wide, r │ │ │ │ │ -00047050: 6f79 616c 7479 2d66 7265 6520 6c69 6365 oyalty-free lice │ │ │ │ │ -00047060: 6e73 652c 2075 6e6c 696d 6974 6564 2069 nse, unlimited i │ │ │ │ │ -00047070: 6e20 6475 7261 7469 6f6e 2c0a 2020 2020 n duration,. │ │ │ │ │ -00047080: 2074 6f20 7573 6520 7468 6174 2077 6f72 to use that wor │ │ │ │ │ -00047090: 6b20 756e 6465 7220 7468 6520 636f 6e64 k under the cond │ │ │ │ │ -000470a0: 6974 696f 6e73 2073 7461 7465 6420 6865 itions stated he │ │ │ │ │ -000470b0: 7265 696e 2e20 2054 6865 0a20 2020 2020 rein. The. │ │ │ │ │ -000470c0: 2244 6f63 756d 656e 7422 2c20 6265 6c6f "Document", belo │ │ │ │ │ -000470d0: 772c 2072 6566 6572 7320 746f 2061 6e79 w, refers to any │ │ │ │ │ -000470e0: 2073 7563 6820 6d61 6e75 616c 206f 7220 such manual or │ │ │ │ │ -000470f0: 776f 726b 2e20 2041 6e79 206d 656d 6265 work. Any membe │ │ │ │ │ -00047100: 720a 2020 2020 206f 6620 7468 6520 7075 r. of the pu │ │ │ │ │ -00047110: 626c 6963 2069 7320 6120 6c69 6365 6e73 blic is a licens │ │ │ │ │ -00047120: 6565 2c20 616e 6420 6973 2061 6464 7265 ee, and is addre │ │ │ │ │ -00047130: 7373 6564 2061 7320 2279 6f75 222e 2020 ssed as "you". │ │ │ │ │ -00047140: 596f 7520 6163 6365 7074 0a20 2020 2020 You accept. │ │ │ │ │ -00047150: 7468 6520 6c69 6365 6e73 6520 6966 2079 the license if y │ │ │ │ │ -00047160: 6f75 2063 6f70 792c 206d 6f64 6966 7920 ou copy, modify │ │ │ │ │ -00047170: 6f72 2064 6973 7472 6962 7574 6520 7468 or distribute th │ │ │ │ │ -00047180: 6520 776f 726b 2069 6e20 6120 7761 790a e work in a way. │ │ │ │ │ -00047190: 2020 2020 2072 6571 7569 7269 6e67 2070 requiring p │ │ │ │ │ -000471a0: 6572 6d69 7373 696f 6e20 756e 6465 7220 ermission under │ │ │ │ │ -000471b0: 636f 7079 7269 6768 7420 6c61 772e 0a0a copyright law... │ │ │ │ │ -000471c0: 2020 2020 2041 2022 4d6f 6469 6669 6564 A "Modified │ │ │ │ │ -000471d0: 2056 6572 7369 6f6e 2220 6f66 2074 6865 Version" of the │ │ │ │ │ -000471e0: 2044 6f63 756d 656e 7420 6d65 616e 7320 Document means │ │ │ │ │ -000471f0: 616e 7920 776f 726b 2063 6f6e 7461 696e any work contain │ │ │ │ │ -00047200: 696e 6720 7468 650a 2020 2020 2044 6f63 ing the. Doc │ │ │ │ │ -00047210: 756d 656e 7420 6f72 2061 2070 6f72 7469 ument or a porti │ │ │ │ │ -00047220: 6f6e 206f 6620 6974 2c20 6569 7468 6572 on of it, either │ │ │ │ │ -00047230: 2063 6f70 6965 6420 7665 7262 6174 696d copied verbatim │ │ │ │ │ -00047240: 2c20 6f72 2077 6974 680a 2020 2020 206d , or with. m │ │ │ │ │ -00047250: 6f64 6966 6963 6174 696f 6e73 2061 6e64 odifications and │ │ │ │ │ -00047260: 2f6f 7220 7472 616e 736c 6174 6564 2069 /or translated i │ │ │ │ │ -00047270: 6e74 6f20 616e 6f74 6865 7220 6c61 6e67 nto another lang │ │ │ │ │ -00047280: 7561 6765 2e0a 0a20 2020 2020 4120 2253 uage... A "S │ │ │ │ │ -00047290: 6563 6f6e 6461 7279 2053 6563 7469 6f6e econdary Section │ │ │ │ │ -000472a0: 2220 6973 2061 206e 616d 6564 2061 7070 " is a named app │ │ │ │ │ -000472b0: 656e 6469 7820 6f72 2061 2066 726f 6e74 endix or a front │ │ │ │ │ -000472c0: 2d6d 6174 7465 7220 7365 6374 696f 6e0a -matter section. │ │ │ │ │ -000472d0: 2020 2020 206f 6620 7468 6520 446f 6375 of the Docu │ │ │ │ │ -000472e0: 6d65 6e74 2074 6861 7420 6465 616c 7320 ment that deals │ │ │ │ │ -000472f0: 6578 636c 7573 6976 656c 7920 7769 7468 exclusively with │ │ │ │ │ -00047300: 2074 6865 2072 656c 6174 696f 6e73 6869 the relationshi │ │ │ │ │ -00047310: 7020 6f66 2074 6865 0a20 2020 2020 7075 p of the. pu │ │ │ │ │ -00047320: 626c 6973 6865 7273 206f 7220 6175 7468 blishers or auth │ │ │ │ │ -00047330: 6f72 7320 6f66 2074 6865 2044 6f63 756d ors of the Docum │ │ │ │ │ -00047340: 656e 7420 746f 2074 6865 2044 6f63 756d ent to the Docum │ │ │ │ │ -00047350: 656e 7427 7320 6f76 6572 616c 6c0a 2020 ent's overall. │ │ │ │ │ -00047360: 2020 2073 7562 6a65 6374 2028 6f72 2074 subject (or t │ │ │ │ │ -00047370: 6f20 7265 6c61 7465 6420 6d61 7474 6572 o related matter │ │ │ │ │ -00047380: 7329 2061 6e64 2063 6f6e 7461 696e 7320 s) and contains │ │ │ │ │ -00047390: 6e6f 7468 696e 6720 7468 6174 2063 6f75 nothing that cou │ │ │ │ │ -000473a0: 6c64 0a20 2020 2020 6661 6c6c 2064 6972 ld. fall dir │ │ │ │ │ -000473b0: 6563 746c 7920 7769 7468 696e 2074 6861 ectly within tha │ │ │ │ │ -000473c0: 7420 6f76 6572 616c 6c20 7375 626a 6563 t overall subjec │ │ │ │ │ -000473d0: 742e 2020 2854 6875 732c 2069 6620 7468 t. (Thus, if th │ │ │ │ │ -000473e0: 6520 446f 6375 6d65 6e74 0a20 2020 2020 e Document. │ │ │ │ │ -000473f0: 6973 2069 6e20 7061 7274 2061 2074 6578 is in part a tex │ │ │ │ │ -00047400: 7462 6f6f 6b20 6f66 206d 6174 6865 6d61 tbook of mathema │ │ │ │ │ -00047410: 7469 6373 2c20 6120 5365 636f 6e64 6172 tics, a Secondar │ │ │ │ │ -00047420: 7920 5365 6374 696f 6e20 6d61 7920 6e6f y Section may no │ │ │ │ │ -00047430: 740a 2020 2020 2065 7870 6c61 696e 2061 t. explain a │ │ │ │ │ -00047440: 6e79 206d 6174 6865 6d61 7469 6373 2e29 ny mathematics.) │ │ │ │ │ -00047450: 2020 5468 6520 7265 6c61 7469 6f6e 7368 The relationsh │ │ │ │ │ -00047460: 6970 2063 6f75 6c64 2062 6520 6120 6d61 ip could be a ma │ │ │ │ │ -00047470: 7474 6572 206f 660a 2020 2020 2068 6973 tter of. his │ │ │ │ │ -00047480: 746f 7269 6361 6c20 636f 6e6e 6563 7469 torical connecti │ │ │ │ │ -00047490: 6f6e 2077 6974 6820 7468 6520 7375 626a on with the subj │ │ │ │ │ -000474a0: 6563 7420 6f72 2077 6974 6820 7265 6c61 ect or with rela │ │ │ │ │ -000474b0: 7465 6420 6d61 7474 6572 732c 206f 720a ted matters, or. │ │ │ │ │ -000474c0: 2020 2020 206f 6620 6c65 6761 6c2c 2063 of legal, c │ │ │ │ │ -000474d0: 6f6d 6d65 7263 6961 6c2c 2070 6869 6c6f ommercial, philo │ │ │ │ │ -000474e0: 736f 7068 6963 616c 2c20 6574 6869 6361 sophical, ethica │ │ │ │ │ -000474f0: 6c20 6f72 2070 6f6c 6974 6963 616c 2070 l or political p │ │ │ │ │ -00047500: 6f73 6974 696f 6e0a 2020 2020 2072 6567 osition. reg │ │ │ │ │ -00047510: 6172 6469 6e67 2074 6865 6d2e 0a0a 2020 arding them... │ │ │ │ │ -00047520: 2020 2054 6865 2022 496e 7661 7269 616e The "Invarian │ │ │ │ │ -00047530: 7420 5365 6374 696f 6e73 2220 6172 6520 t Sections" are │ │ │ │ │ -00047540: 6365 7274 6169 6e20 5365 636f 6e64 6172 certain Secondar │ │ │ │ │ -00047550: 7920 5365 6374 696f 6e73 2077 686f 7365 y Sections whose │ │ │ │ │ -00047560: 0a20 2020 2020 7469 746c 6573 2061 7265 . titles are │ │ │ │ │ -00047570: 2064 6573 6967 6e61 7465 642c 2061 7320 designated, as │ │ │ │ │ -00047580: 6265 696e 6720 7468 6f73 6520 6f66 2049 being those of I │ │ │ │ │ -00047590: 6e76 6172 6961 6e74 2053 6563 7469 6f6e nvariant Section │ │ │ │ │ -000475a0: 732c 2069 6e20 7468 650a 2020 2020 206e s, in the. n │ │ │ │ │ -000475b0: 6f74 6963 6520 7468 6174 2073 6179 7320 otice that says │ │ │ │ │ -000475c0: 7468 6174 2074 6865 2044 6f63 756d 656e that the Documen │ │ │ │ │ -000475d0: 7420 6973 2072 656c 6561 7365 6420 756e t is released un │ │ │ │ │ -000475e0: 6465 7220 7468 6973 204c 6963 656e 7365 der this License │ │ │ │ │ -000475f0: 2e0a 2020 2020 2049 6620 6120 7365 6374 .. If a sect │ │ │ │ │ -00047600: 696f 6e20 646f 6573 206e 6f74 2066 6974 ion does not fit │ │ │ │ │ -00047610: 2074 6865 2061 626f 7665 2064 6566 696e the above defin │ │ │ │ │ -00047620: 6974 696f 6e20 6f66 2053 6563 6f6e 6461 ition of Seconda │ │ │ │ │ -00047630: 7279 2074 6865 6e20 6974 0a20 2020 2020 ry then it. │ │ │ │ │ -00047640: 6973 206e 6f74 2061 6c6c 6f77 6564 2074 is not allowed t │ │ │ │ │ -00047650: 6f20 6265 2064 6573 6967 6e61 7465 6420 o be designated │ │ │ │ │ -00047660: 6173 2049 6e76 6172 6961 6e74 2e20 2054 as Invariant. T │ │ │ │ │ -00047670: 6865 2044 6f63 756d 656e 7420 6d61 790a he Document may. │ │ │ │ │ -00047680: 2020 2020 2063 6f6e 7461 696e 207a 6572 contain zer │ │ │ │ │ -00047690: 6f20 496e 7661 7269 616e 7420 5365 6374 o Invariant Sect │ │ │ │ │ -000476a0: 696f 6e73 2e20 2049 6620 7468 6520 446f ions. If the Do │ │ │ │ │ -000476b0: 6375 6d65 6e74 2064 6f65 7320 6e6f 7420 cument does not │ │ │ │ │ -000476c0: 6964 656e 7469 6679 0a20 2020 2020 616e identify. an │ │ │ │ │ -000476d0: 7920 496e 7661 7269 616e 7420 5365 6374 y Invariant Sect │ │ │ │ │ -000476e0: 696f 6e73 2074 6865 6e20 7468 6572 6520 ions then there │ │ │ │ │ -000476f0: 6172 6520 6e6f 6e65 2e0a 0a20 2020 2020 are none... │ │ │ │ │ -00047700: 5468 6520 2243 6f76 6572 2054 6578 7473 The "Cover Texts │ │ │ │ │ -00047710: 2220 6172 6520 6365 7274 6169 6e20 7368 " are certain sh │ │ │ │ │ -00047720: 6f72 7420 7061 7373 6167 6573 206f 6620 ort passages of │ │ │ │ │ -00047730: 7465 7874 2074 6861 7420 6172 650a 2020 text that are. │ │ │ │ │ -00047740: 2020 206c 6973 7465 642c 2061 7320 4672 listed, as Fr │ │ │ │ │ -00047750: 6f6e 742d 436f 7665 7220 5465 7874 7320 ont-Cover Texts │ │ │ │ │ -00047760: 6f72 2042 6163 6b2d 436f 7665 7220 5465 or Back-Cover Te │ │ │ │ │ -00047770: 7874 732c 2069 6e20 7468 6520 6e6f 7469 xts, in the noti │ │ │ │ │ -00047780: 6365 0a20 2020 2020 7468 6174 2073 6179 ce. that say │ │ │ │ │ -00047790: 7320 7468 6174 2074 6865 2044 6f63 756d s that the Docum │ │ │ │ │ -000477a0: 656e 7420 6973 2072 656c 6561 7365 6420 ent is released │ │ │ │ │ -000477b0: 756e 6465 7220 7468 6973 204c 6963 656e under this Licen │ │ │ │ │ -000477c0: 7365 2e20 2041 0a20 2020 2020 4672 6f6e se. A. Fron │ │ │ │ │ -000477d0: 742d 436f 7665 7220 5465 7874 206d 6179 t-Cover Text may │ │ │ │ │ -000477e0: 2062 6520 6174 206d 6f73 7420 3520 776f be at most 5 wo │ │ │ │ │ -000477f0: 7264 732c 2061 6e64 2061 2042 6163 6b2d rds, and a Back- │ │ │ │ │ -00047800: 436f 7665 7220 5465 7874 206d 6179 0a20 Cover Text may. │ │ │ │ │ -00047810: 2020 2020 6265 2061 7420 6d6f 7374 2032 be at most 2 │ │ │ │ │ -00047820: 3520 776f 7264 732e 0a0a 2020 2020 2041 5 words... A │ │ │ │ │ -00047830: 2022 5472 616e 7370 6172 656e 7422 2063 "Transparent" c │ │ │ │ │ -00047840: 6f70 7920 6f66 2074 6865 2044 6f63 756d opy of the Docum │ │ │ │ │ -00047850: 656e 7420 6d65 616e 7320 6120 6d61 6368 ent means a mach │ │ │ │ │ -00047860: 696e 652d 7265 6164 6162 6c65 2063 6f70 ine-readable cop │ │ │ │ │ -00047870: 792c 0a20 2020 2020 7265 7072 6573 656e y,. represen │ │ │ │ │ -00047880: 7465 6420 696e 2061 2066 6f72 6d61 7420 ted in a format │ │ │ │ │ -00047890: 7768 6f73 6520 7370 6563 6966 6963 6174 whose specificat │ │ │ │ │ -000478a0: 696f 6e20 6973 2061 7661 696c 6162 6c65 ion is available │ │ │ │ │ -000478b0: 2074 6f20 7468 650a 2020 2020 2067 656e to the. gen │ │ │ │ │ -000478c0: 6572 616c 2070 7562 6c69 632c 2074 6861 eral public, tha │ │ │ │ │ -000478d0: 7420 6973 2073 7569 7461 626c 6520 666f t is suitable fo │ │ │ │ │ -000478e0: 7220 7265 7669 7369 6e67 2074 6865 2064 r revising the d │ │ │ │ │ -000478f0: 6f63 756d 656e 740a 2020 2020 2073 7472 ocument. str │ │ │ │ │ -00047900: 6169 6768 7466 6f72 7761 7264 6c79 2077 aightforwardly w │ │ │ │ │ -00047910: 6974 6820 6765 6e65 7269 6320 7465 7874 ith generic text │ │ │ │ │ -00047920: 2065 6469 746f 7273 206f 7220 2866 6f72 editors or (for │ │ │ │ │ -00047930: 2069 6d61 6765 7320 636f 6d70 6f73 6564 images composed │ │ │ │ │ -00047940: 0a20 2020 2020 6f66 2070 6978 656c 7329 . of pixels) │ │ │ │ │ -00047950: 2067 656e 6572 6963 2070 6169 6e74 2070 generic paint p │ │ │ │ │ -00047960: 726f 6772 616d 7320 6f72 2028 666f 7220 rograms or (for │ │ │ │ │ -00047970: 6472 6177 696e 6773 2920 736f 6d65 2077 drawings) some w │ │ │ │ │ -00047980: 6964 656c 790a 2020 2020 2061 7661 696c idely. avail │ │ │ │ │ -00047990: 6162 6c65 2064 7261 7769 6e67 2065 6469 able drawing edi │ │ │ │ │ -000479a0: 746f 722c 2061 6e64 2074 6861 7420 6973 tor, and that is │ │ │ │ │ -000479b0: 2073 7569 7461 626c 6520 666f 7220 696e suitable for in │ │ │ │ │ -000479c0: 7075 7420 746f 2074 6578 740a 2020 2020 put to text. │ │ │ │ │ -000479d0: 2066 6f72 6d61 7474 6572 7320 6f72 2066 formatters or f │ │ │ │ │ -000479e0: 6f72 2061 7574 6f6d 6174 6963 2074 7261 or automatic tra │ │ │ │ │ -000479f0: 6e73 6c61 7469 6f6e 2074 6f20 6120 7661 nslation to a va │ │ │ │ │ -00047a00: 7269 6574 7920 6f66 2066 6f72 6d61 7473 riety of formats │ │ │ │ │ -00047a10: 0a20 2020 2020 7375 6974 6162 6c65 2066 . suitable f │ │ │ │ │ -00047a20: 6f72 2069 6e70 7574 2074 6f20 7465 7874 or input to text │ │ │ │ │ -00047a30: 2066 6f72 6d61 7474 6572 732e 2020 4120 formatters. A │ │ │ │ │ -00047a40: 636f 7079 206d 6164 6520 696e 2061 6e20 copy made in an │ │ │ │ │ -00047a50: 6f74 6865 7277 6973 650a 2020 2020 2054 otherwise. T │ │ │ │ │ -00047a60: 7261 6e73 7061 7265 6e74 2066 696c 6520 ransparent file │ │ │ │ │ -00047a70: 666f 726d 6174 2077 686f 7365 206d 6172 format whose mar │ │ │ │ │ -00047a80: 6b75 702c 206f 7220 6162 7365 6e63 6520 kup, or absence │ │ │ │ │ -00047a90: 6f66 206d 6172 6b75 702c 2068 6173 0a20 of markup, has. │ │ │ │ │ -00047aa0: 2020 2020 6265 656e 2061 7272 616e 6765 been arrange │ │ │ │ │ -00047ab0: 6420 746f 2074 6877 6172 7420 6f72 2064 d to thwart or d │ │ │ │ │ -00047ac0: 6973 636f 7572 6167 6520 7375 6273 6571 iscourage subseq │ │ │ │ │ -00047ad0: 7565 6e74 206d 6f64 6966 6963 6174 696f uent modificatio │ │ │ │ │ -00047ae0: 6e20 6279 0a20 2020 2020 7265 6164 6572 n by. reader │ │ │ │ │ -00047af0: 7320 6973 206e 6f74 2054 7261 6e73 7061 s is not Transpa │ │ │ │ │ -00047b00: 7265 6e74 2e20 2041 6e20 696d 6167 6520 rent. An image │ │ │ │ │ -00047b10: 666f 726d 6174 2069 7320 6e6f 7420 5472 format is not Tr │ │ │ │ │ -00047b20: 616e 7370 6172 656e 7420 6966 0a20 2020 ansparent if. │ │ │ │ │ -00047b30: 2020 7573 6564 2066 6f72 2061 6e79 2073 used for any s │ │ │ │ │ -00047b40: 7562 7374 616e 7469 616c 2061 6d6f 756e ubstantial amoun │ │ │ │ │ -00047b50: 7420 6f66 2074 6578 742e 2020 4120 636f t of text. A co │ │ │ │ │ -00047b60: 7079 2074 6861 7420 6973 206e 6f74 0a20 py that is not. │ │ │ │ │ -00047b70: 2020 2020 2254 7261 6e73 7061 7265 6e74 "Transparent │ │ │ │ │ -00047b80: 2220 6973 2063 616c 6c65 6420 224f 7061 " is called "Opa │ │ │ │ │ -00047b90: 7175 6522 2e0a 0a20 2020 2020 4578 616d que"... Exam │ │ │ │ │ -00047ba0: 706c 6573 206f 6620 7375 6974 6162 6c65 ples of suitable │ │ │ │ │ -00047bb0: 2066 6f72 6d61 7473 2066 6f72 2054 7261 formats for Tra │ │ │ │ │ -00047bc0: 6e73 7061 7265 6e74 2063 6f70 6965 7320 nsparent copies │ │ │ │ │ -00047bd0: 696e 636c 7564 6520 706c 6169 6e0a 2020 include plain. │ │ │ │ │ -00047be0: 2020 2041 5343 4949 2077 6974 686f 7574 ASCII without │ │ │ │ │ -00047bf0: 206d 6172 6b75 702c 2054 6578 696e 666f markup, Texinfo │ │ │ │ │ -00047c00: 2069 6e70 7574 2066 6f72 6d61 742c 204c input format, L │ │ │ │ │ -00047c10: 6154 6558 2069 6e70 7574 2066 6f72 6d61 aTeX input forma │ │ │ │ │ -00047c20: 742c 0a20 2020 2020 5347 4d4c 206f 7220 t,. SGML or │ │ │ │ │ -00047c30: 584d 4c20 7573 696e 6720 6120 7075 626c XML using a publ │ │ │ │ │ -00047c40: 6963 6c79 2061 7661 696c 6162 6c65 2044 icly available D │ │ │ │ │ -00047c50: 5444 2c20 616e 6420 7374 616e 6461 7264 TD, and standard │ │ │ │ │ -00047c60: 2d63 6f6e 666f 726d 696e 670a 2020 2020 -conforming. │ │ │ │ │ -00047c70: 2073 696d 706c 6520 4854 4d4c 2c20 506f simple HTML, Po │ │ │ │ │ -00047c80: 7374 5363 7269 7074 206f 7220 5044 4620 stScript or PDF │ │ │ │ │ -00047c90: 6465 7369 676e 6564 2066 6f72 2068 756d designed for hum │ │ │ │ │ -00047ca0: 616e 206d 6f64 6966 6963 6174 696f 6e2e an modification. │ │ │ │ │ -00047cb0: 0a20 2020 2020 4578 616d 706c 6573 206f . Examples o │ │ │ │ │ -00047cc0: 6620 7472 616e 7370 6172 656e 7420 696d f transparent im │ │ │ │ │ -00047cd0: 6167 6520 666f 726d 6174 7320 696e 636c age formats incl │ │ │ │ │ -00047ce0: 7564 6520 504e 472c 2058 4346 2061 6e64 ude PNG, XCF and │ │ │ │ │ -00047cf0: 204a 5047 2e0a 2020 2020 204f 7061 7175 JPG.. Opaqu │ │ │ │ │ -00047d00: 6520 666f 726d 6174 7320 696e 636c 7564 e formats includ │ │ │ │ │ -00047d10: 6520 7072 6f70 7269 6574 6172 7920 666f e proprietary fo │ │ │ │ │ -00047d20: 726d 6174 7320 7468 6174 2063 616e 2062 rmats that can b │ │ │ │ │ -00047d30: 6520 7265 6164 2061 6e64 0a20 2020 2020 e read and. │ │ │ │ │ -00047d40: 6564 6974 6564 206f 6e6c 7920 6279 2070 edited only by p │ │ │ │ │ -00047d50: 726f 7072 6965 7461 7279 2077 6f72 6420 roprietary word │ │ │ │ │ -00047d60: 7072 6f63 6573 736f 7273 2c20 5347 4d4c processors, SGML │ │ │ │ │ -00047d70: 206f 7220 584d 4c20 666f 7220 7768 6963 or XML for whic │ │ │ │ │ -00047d80: 680a 2020 2020 2074 6865 2044 5444 2061 h. the DTD a │ │ │ │ │ -00047d90: 6e64 2f6f 7220 7072 6f63 6573 7369 6e67 nd/or processing │ │ │ │ │ -00047da0: 2074 6f6f 6c73 2061 7265 206e 6f74 2067 tools are not g │ │ │ │ │ -00047db0: 656e 6572 616c 6c79 2061 7661 696c 6162 enerally availab │ │ │ │ │ -00047dc0: 6c65 2c20 616e 640a 2020 2020 2074 6865 le, and. the │ │ │ │ │ -00047dd0: 206d 6163 6869 6e65 2d67 656e 6572 6174 machine-generat │ │ │ │ │ -00047de0: 6564 2048 544d 4c2c 2050 6f73 7453 6372 ed HTML, PostScr │ │ │ │ │ -00047df0: 6970 7420 6f72 2050 4446 2070 726f 6475 ipt or PDF produ │ │ │ │ │ -00047e00: 6365 6420 6279 2073 6f6d 6520 776f 7264 ced by some word │ │ │ │ │ -00047e10: 0a20 2020 2020 7072 6f63 6573 736f 7273 . processors │ │ │ │ │ -00047e20: 2066 6f72 206f 7574 7075 7420 7075 7270 for output purp │ │ │ │ │ -00047e30: 6f73 6573 206f 6e6c 792e 0a0a 2020 2020 oses only... │ │ │ │ │ -00047e40: 2054 6865 2022 5469 746c 6520 5061 6765 The "Title Page │ │ │ │ │ -00047e50: 2220 6d65 616e 732c 2066 6f72 2061 2070 " means, for a p │ │ │ │ │ -00047e60: 7269 6e74 6564 2062 6f6f 6b2c 2074 6865 rinted book, the │ │ │ │ │ -00047e70: 2074 6974 6c65 2070 6167 6520 6974 7365 title page itse │ │ │ │ │ -00047e80: 6c66 2c0a 2020 2020 2070 6c75 7320 7375 lf,. plus su │ │ │ │ │ -00047e90: 6368 2066 6f6c 6c6f 7769 6e67 2070 6167 ch following pag │ │ │ │ │ -00047ea0: 6573 2061 7320 6172 6520 6e65 6564 6564 es as are needed │ │ │ │ │ -00047eb0: 2074 6f20 686f 6c64 2c20 6c65 6769 626c to hold, legibl │ │ │ │ │ -00047ec0: 792c 2074 6865 0a20 2020 2020 6d61 7465 y, the. mate │ │ │ │ │ -00047ed0: 7269 616c 2074 6869 7320 4c69 6365 6e73 rial this Licens │ │ │ │ │ -00047ee0: 6520 7265 7175 6972 6573 2074 6f20 6170 e requires to ap │ │ │ │ │ -00047ef0: 7065 6172 2069 6e20 7468 6520 7469 746c pear in the titl │ │ │ │ │ -00047f00: 6520 7061 6765 2e20 2046 6f72 0a20 2020 e page. For. │ │ │ │ │ -00047f10: 2020 776f 726b 7320 696e 2066 6f72 6d61 works in forma │ │ │ │ │ -00047f20: 7473 2077 6869 6368 2064 6f20 6e6f 7420 ts which do not │ │ │ │ │ -00047f30: 6861 7665 2061 6e79 2074 6974 6c65 2070 have any title p │ │ │ │ │ -00047f40: 6167 6520 6173 2073 7563 682c 2022 5469 age as such, "Ti │ │ │ │ │ -00047f50: 746c 650a 2020 2020 2050 6167 6522 206d tle. Page" m │ │ │ │ │ -00047f60: 6561 6e73 2074 6865 2074 6578 7420 6e65 eans the text ne │ │ │ │ │ -00047f70: 6172 2074 6865 206d 6f73 7420 7072 6f6d ar the most prom │ │ │ │ │ -00047f80: 696e 656e 7420 6170 7065 6172 616e 6365 inent appearance │ │ │ │ │ -00047f90: 206f 6620 7468 650a 2020 2020 2077 6f72 of the. wor │ │ │ │ │ -00047fa0: 6b27 7320 7469 746c 652c 2070 7265 6365 k's title, prece │ │ │ │ │ -00047fb0: 6469 6e67 2074 6865 2062 6567 696e 6e69 ding the beginni │ │ │ │ │ -00047fc0: 6e67 206f 6620 7468 6520 626f 6479 206f ng of the body o │ │ │ │ │ -00047fd0: 6620 7468 6520 7465 7874 2e0a 0a20 2020 f the text... │ │ │ │ │ -00047fe0: 2020 4120 7365 6374 696f 6e20 2245 6e74 A section "Ent │ │ │ │ │ -00047ff0: 6974 6c65 6420 5859 5a22 206d 6561 6e73 itled XYZ" means │ │ │ │ │ -00048000: 2061 206e 616d 6564 2073 7562 756e 6974 a named subunit │ │ │ │ │ -00048010: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -00048020: 0a20 2020 2020 7768 6f73 6520 7469 746c . whose titl │ │ │ │ │ -00048030: 6520 6569 7468 6572 2069 7320 7072 6563 e either is prec │ │ │ │ │ -00048040: 6973 656c 7920 5859 5a20 6f72 2063 6f6e isely XYZ or con │ │ │ │ │ -00048050: 7461 696e 7320 5859 5a20 696e 2070 6172 tains XYZ in par │ │ │ │ │ -00048060: 656e 7468 6573 6573 0a20 2020 2020 666f entheses. fo │ │ │ │ │ -00048070: 6c6c 6f77 696e 6720 7465 7874 2074 6861 llowing text tha │ │ │ │ │ -00048080: 7420 7472 616e 736c 6174 6573 2058 595a t translates XYZ │ │ │ │ │ -00048090: 2069 6e20 616e 6f74 6865 7220 6c61 6e67 in another lang │ │ │ │ │ -000480a0: 7561 6765 2e20 2028 4865 7265 2058 595a uage. (Here XYZ │ │ │ │ │ -000480b0: 0a20 2020 2020 7374 616e 6473 2066 6f72 . stands for │ │ │ │ │ -000480c0: 2061 2073 7065 6369 6669 6320 7365 6374 a specific sect │ │ │ │ │ -000480d0: 696f 6e20 6e61 6d65 206d 656e 7469 6f6e ion name mention │ │ │ │ │ -000480e0: 6564 2062 656c 6f77 2c20 7375 6368 2061 ed below, such a │ │ │ │ │ -000480f0: 730a 2020 2020 2022 4163 6b6e 6f77 6c65 s. "Acknowle │ │ │ │ │ -00048100: 6467 656d 656e 7473 222c 2022 4465 6469 dgements", "Dedi │ │ │ │ │ -00048110: 6361 7469 6f6e 7322 2c20 2245 6e64 6f72 cations", "Endor │ │ │ │ │ -00048120: 7365 6d65 6e74 7322 2c20 6f72 2022 4869 sements", or "Hi │ │ │ │ │ -00048130: 7374 6f72 7922 2e29 0a20 2020 2020 546f story".). To │ │ │ │ │ -00048140: 2022 5072 6573 6572 7665 2074 6865 2054 "Preserve the T │ │ │ │ │ -00048150: 6974 6c65 2220 6f66 2073 7563 6820 6120 itle" of such a │ │ │ │ │ -00048160: 7365 6374 696f 6e20 7768 656e 2079 6f75 section when you │ │ │ │ │ -00048170: 206d 6f64 6966 7920 7468 650a 2020 2020 modify the. │ │ │ │ │ -00048180: 2044 6f63 756d 656e 7420 6d65 616e 7320 Document means │ │ │ │ │ -00048190: 7468 6174 2069 7420 7265 6d61 696e 7320 that it remains │ │ │ │ │ -000481a0: 6120 7365 6374 696f 6e20 2245 6e74 6974 a section "Entit │ │ │ │ │ -000481b0: 6c65 6420 5859 5a22 2061 6363 6f72 6469 led XYZ" accordi │ │ │ │ │ -000481c0: 6e67 0a20 2020 2020 746f 2074 6869 7320 ng. to this │ │ │ │ │ -000481d0: 6465 6669 6e69 7469 6f6e 2e0a 0a20 2020 definition... │ │ │ │ │ -000481e0: 2020 5468 6520 446f 6375 6d65 6e74 206d The Document m │ │ │ │ │ -000481f0: 6179 2069 6e63 6c75 6465 2057 6172 7261 ay include Warra │ │ │ │ │ -00048200: 6e74 7920 4469 7363 6c61 696d 6572 7320 nty Disclaimers │ │ │ │ │ -00048210: 6e65 7874 2074 6f20 7468 6520 6e6f 7469 next to the noti │ │ │ │ │ -00048220: 6365 0a20 2020 2020 7768 6963 6820 7374 ce. which st │ │ │ │ │ -00048230: 6174 6573 2074 6861 7420 7468 6973 204c ates that this L │ │ │ │ │ -00048240: 6963 656e 7365 2061 7070 6c69 6573 2074 icense applies t │ │ │ │ │ -00048250: 6f20 7468 6520 446f 6375 6d65 6e74 2e20 o the Document. │ │ │ │ │ -00048260: 2054 6865 7365 0a20 2020 2020 5761 7272 These. Warr │ │ │ │ │ -00048270: 616e 7479 2044 6973 636c 6169 6d65 7273 anty Disclaimers │ │ │ │ │ -00048280: 2061 7265 2063 6f6e 7369 6465 7265 6420 are considered │ │ │ │ │ -00048290: 746f 2062 6520 696e 636c 7564 6564 2062 to be included b │ │ │ │ │ -000482a0: 7920 7265 6665 7265 6e63 6520 696e 0a20 y reference in. │ │ │ │ │ -000482b0: 2020 2020 7468 6973 204c 6963 656e 7365 this License │ │ │ │ │ -000482c0: 2c20 6275 7420 6f6e 6c79 2061 7320 7265 , but only as re │ │ │ │ │ -000482d0: 6761 7264 7320 6469 7363 6c61 696d 696e gards disclaimin │ │ │ │ │ -000482e0: 6720 7761 7272 616e 7469 6573 3a20 616e g warranties: an │ │ │ │ │ -000482f0: 7920 6f74 6865 720a 2020 2020 2069 6d70 y other. imp │ │ │ │ │ -00048300: 6c69 6361 7469 6f6e 2074 6861 7420 7468 lication that th │ │ │ │ │ -00048310: 6573 6520 5761 7272 616e 7479 2044 6973 ese Warranty Dis │ │ │ │ │ -00048320: 636c 6169 6d65 7273 206d 6179 2068 6176 claimers may hav │ │ │ │ │ -00048330: 6520 6973 2076 6f69 6420 616e 640a 2020 e is void and. │ │ │ │ │ -00048340: 2020 2068 6173 206e 6f20 6566 6665 6374 has no effect │ │ │ │ │ -00048350: 206f 6e20 7468 6520 6d65 616e 696e 6720 on the meaning │ │ │ │ │ -00048360: 6f66 2074 6869 7320 4c69 6365 6e73 652e of this License. │ │ │ │ │ -00048370: 0a0a 2020 322e 2056 4552 4241 5449 4d20 .. 2. VERBATIM │ │ │ │ │ -00048380: 434f 5059 494e 470a 0a20 2020 2020 596f COPYING.. Yo │ │ │ │ │ -00048390: 7520 6d61 7920 636f 7079 2061 6e64 2064 u may copy and d │ │ │ │ │ -000483a0: 6973 7472 6962 7574 6520 7468 6520 446f istribute the Do │ │ │ │ │ -000483b0: 6375 6d65 6e74 2069 6e20 616e 7920 6d65 cument in any me │ │ │ │ │ -000483c0: 6469 756d 2c20 6569 7468 6572 0a20 2020 dium, either. │ │ │ │ │ -000483d0: 2020 636f 6d6d 6572 6369 616c 6c79 206f commercially o │ │ │ │ │ -000483e0: 7220 6e6f 6e63 6f6d 6d65 7263 6961 6c6c r noncommerciall │ │ │ │ │ -000483f0: 792c 2070 726f 7669 6465 6420 7468 6174 y, provided that │ │ │ │ │ -00048400: 2074 6869 7320 4c69 6365 6e73 652c 2074 this License, t │ │ │ │ │ -00048410: 6865 0a20 2020 2020 636f 7079 7269 6768 he. copyrigh │ │ │ │ │ -00048420: 7420 6e6f 7469 6365 732c 2061 6e64 2074 t notices, and t │ │ │ │ │ -00048430: 6865 206c 6963 656e 7365 206e 6f74 6963 he license notic │ │ │ │ │ -00048440: 6520 7361 7969 6e67 2074 6869 7320 4c69 e saying this Li │ │ │ │ │ -00048450: 6365 6e73 650a 2020 2020 2061 7070 6c69 cense. appli │ │ │ │ │ -00048460: 6573 2074 6f20 7468 6520 446f 6375 6d65 es to the Docume │ │ │ │ │ -00048470: 6e74 2061 7265 2072 6570 726f 6475 6365 nt are reproduce │ │ │ │ │ -00048480: 6420 696e 2061 6c6c 2063 6f70 6965 732c d in all copies, │ │ │ │ │ -00048490: 2061 6e64 2074 6861 7420 796f 750a 2020 and that you. │ │ │ │ │ -000484a0: 2020 2061 6464 206e 6f20 6f74 6865 7220 add no other │ │ │ │ │ -000484b0: 636f 6e64 6974 696f 6e73 2077 6861 7473 conditions whats │ │ │ │ │ -000484c0: 6f65 7665 7220 746f 2074 686f 7365 206f oever to those o │ │ │ │ │ -000484d0: 6620 7468 6973 204c 6963 656e 7365 2e20 f this License. │ │ │ │ │ -000484e0: 2059 6f75 0a20 2020 2020 6d61 7920 6e6f You. may no │ │ │ │ │ -000484f0: 7420 7573 6520 7465 6368 6e69 6361 6c20 t use technical │ │ │ │ │ -00048500: 6d65 6173 7572 6573 2074 6f20 6f62 7374 measures to obst │ │ │ │ │ -00048510: 7275 6374 206f 7220 636f 6e74 726f 6c20 ruct or control │ │ │ │ │ -00048520: 7468 6520 7265 6164 696e 670a 2020 2020 the reading. │ │ │ │ │ -00048530: 206f 7220 6675 7274 6865 7220 636f 7079 or further copy │ │ │ │ │ -00048540: 696e 6720 6f66 2074 6865 2063 6f70 6965 ing of the copie │ │ │ │ │ -00048550: 7320 796f 7520 6d61 6b65 206f 7220 6469 s you make or di │ │ │ │ │ -00048560: 7374 7269 6275 7465 2e20 2048 6f77 6576 stribute. Howev │ │ │ │ │ -00048570: 6572 2c0a 2020 2020 2079 6f75 206d 6179 er,. you may │ │ │ │ │ -00048580: 2061 6363 6570 7420 636f 6d70 656e 7361 accept compensa │ │ │ │ │ -00048590: 7469 6f6e 2069 6e20 6578 6368 616e 6765 tion in exchange │ │ │ │ │ -000485a0: 2066 6f72 2063 6f70 6965 732e 2020 4966 for copies. If │ │ │ │ │ -000485b0: 2079 6f75 0a20 2020 2020 6469 7374 7269 you. distri │ │ │ │ │ -000485c0: 6275 7465 2061 206c 6172 6765 2065 6e6f bute a large eno │ │ │ │ │ -000485d0: 7567 6820 6e75 6d62 6572 206f 6620 636f ugh number of co │ │ │ │ │ -000485e0: 7069 6573 2079 6f75 206d 7573 7420 616c pies you must al │ │ │ │ │ -000485f0: 736f 2066 6f6c 6c6f 7720 7468 650a 2020 so follow the. │ │ │ │ │ -00048600: 2020 2063 6f6e 6469 7469 6f6e 7320 696e conditions in │ │ │ │ │ -00048610: 2073 6563 7469 6f6e 2033 2e0a 0a20 2020 section 3... │ │ │ │ │ -00048620: 2020 596f 7520 6d61 7920 616c 736f 206c You may also l │ │ │ │ │ -00048630: 656e 6420 636f 7069 6573 2c20 756e 6465 end copies, unde │ │ │ │ │ -00048640: 7220 7468 6520 7361 6d65 2063 6f6e 6469 r the same condi │ │ │ │ │ -00048650: 7469 6f6e 7320 7374 6174 6564 2061 626f tions stated abo │ │ │ │ │ -00048660: 7665 2c0a 2020 2020 2061 6e64 2079 6f75 ve,. and you │ │ │ │ │ -00048670: 206d 6179 2070 7562 6c69 636c 7920 6469 may publicly di │ │ │ │ │ -00048680: 7370 6c61 7920 636f 7069 6573 2e0a 0a20 splay copies... │ │ │ │ │ -00048690: 2033 2e20 434f 5059 494e 4720 494e 2051 3. COPYING IN Q │ │ │ │ │ -000486a0: 5541 4e54 4954 590a 0a20 2020 2020 4966 UANTITY.. If │ │ │ │ │ -000486b0: 2079 6f75 2070 7562 6c69 7368 2070 7269 you publish pri │ │ │ │ │ -000486c0: 6e74 6564 2063 6f70 6965 7320 286f 7220 nted copies (or │ │ │ │ │ -000486d0: 636f 7069 6573 2069 6e20 6d65 6469 6120 copies in media │ │ │ │ │ -000486e0: 7468 6174 2063 6f6d 6d6f 6e6c 790a 2020 that commonly. │ │ │ │ │ -000486f0: 2020 2068 6176 6520 7072 696e 7465 6420 have printed │ │ │ │ │ -00048700: 636f 7665 7273 2920 6f66 2074 6865 2044 covers) of the D │ │ │ │ │ -00048710: 6f63 756d 656e 742c 206e 756d 6265 7269 ocument, numberi │ │ │ │ │ -00048720: 6e67 206d 6f72 6520 7468 616e 2031 3030 ng more than 100 │ │ │ │ │ -00048730: 2c20 616e 640a 2020 2020 2074 6865 2044 , and. the D │ │ │ │ │ -00048740: 6f63 756d 656e 7427 7320 6c69 6365 6e73 ocument's licens │ │ │ │ │ -00048750: 6520 6e6f 7469 6365 2072 6571 7569 7265 e notice require │ │ │ │ │ -00048760: 7320 436f 7665 7220 5465 7874 732c 2079 s Cover Texts, y │ │ │ │ │ -00048770: 6f75 206d 7573 740a 2020 2020 2065 6e63 ou must. enc │ │ │ │ │ -00048780: 6c6f 7365 2074 6865 2063 6f70 6965 7320 lose the copies │ │ │ │ │ -00048790: 696e 2063 6f76 6572 7320 7468 6174 2063 in covers that c │ │ │ │ │ -000487a0: 6172 7279 2c20 636c 6561 726c 7920 616e arry, clearly an │ │ │ │ │ -000487b0: 6420 6c65 6769 626c 792c 2061 6c6c 0a20 d legibly, all. │ │ │ │ │ -000487c0: 2020 2020 7468 6573 6520 436f 7665 7220 these Cover │ │ │ │ │ -000487d0: 5465 7874 733a 2046 726f 6e74 2d43 6f76 Texts: Front-Cov │ │ │ │ │ -000487e0: 6572 2054 6578 7473 206f 6e20 7468 6520 er Texts on the │ │ │ │ │ -000487f0: 6672 6f6e 7420 636f 7665 722c 2061 6e64 front cover, and │ │ │ │ │ -00048800: 0a20 2020 2020 4261 636b 2d43 6f76 6572 . Back-Cover │ │ │ │ │ -00048810: 2054 6578 7473 206f 6e20 7468 6520 6261 Texts on the ba │ │ │ │ │ -00048820: 636b 2063 6f76 6572 2e20 2042 6f74 6820 ck cover. Both │ │ │ │ │ -00048830: 636f 7665 7273 206d 7573 7420 616c 736f covers must also │ │ │ │ │ -00048840: 2063 6c65 6172 6c79 0a20 2020 2020 616e clearly. an │ │ │ │ │ -00048850: 6420 6c65 6769 626c 7920 6964 656e 7469 d legibly identi │ │ │ │ │ -00048860: 6679 2079 6f75 2061 7320 7468 6520 7075 fy you as the pu │ │ │ │ │ -00048870: 626c 6973 6865 7220 6f66 2074 6865 7365 blisher of these │ │ │ │ │ -00048880: 2063 6f70 6965 732e 2020 5468 650a 2020 copies. The. │ │ │ │ │ -00048890: 2020 2066 726f 6e74 2063 6f76 6572 206d front cover m │ │ │ │ │ -000488a0: 7573 7420 7072 6573 656e 7420 7468 6520 ust present the │ │ │ │ │ -000488b0: 6675 6c6c 2074 6974 6c65 2077 6974 6820 full title with │ │ │ │ │ -000488c0: 616c 6c20 776f 7264 7320 6f66 2074 6865 all words of the │ │ │ │ │ -000488d0: 2074 6974 6c65 0a20 2020 2020 6571 7561 title. equa │ │ │ │ │ -000488e0: 6c6c 7920 7072 6f6d 696e 656e 7420 616e lly prominent an │ │ │ │ │ -000488f0: 6420 7669 7369 626c 652e 2020 596f 7520 d visible. You │ │ │ │ │ -00048900: 6d61 7920 6164 6420 6f74 6865 7220 6d61 may add other ma │ │ │ │ │ -00048910: 7465 7269 616c 206f 6e20 7468 650a 2020 terial on the. │ │ │ │ │ -00048920: 2020 2063 6f76 6572 7320 696e 2061 6464 covers in add │ │ │ │ │ -00048930: 6974 696f 6e2e 2020 436f 7079 696e 6720 ition. Copying │ │ │ │ │ -00048940: 7769 7468 2063 6861 6e67 6573 206c 696d with changes lim │ │ │ │ │ -00048950: 6974 6564 2074 6f20 7468 6520 636f 7665 ited to the cove │ │ │ │ │ -00048960: 7273 2c20 6173 0a20 2020 2020 6c6f 6e67 rs, as. long │ │ │ │ │ -00048970: 2061 7320 7468 6579 2070 7265 7365 7276 as they preserv │ │ │ │ │ -00048980: 6520 7468 6520 7469 746c 6520 6f66 2074 e the title of t │ │ │ │ │ -00048990: 6865 2044 6f63 756d 656e 7420 616e 6420 he Document and │ │ │ │ │ -000489a0: 7361 7469 7366 7920 7468 6573 650a 2020 satisfy these. │ │ │ │ │ -000489b0: 2020 2063 6f6e 6469 7469 6f6e 732c 2063 conditions, c │ │ │ │ │ -000489c0: 616e 2062 6520 7472 6561 7465 6420 6173 an be treated as │ │ │ │ │ -000489d0: 2076 6572 6261 7469 6d20 636f 7079 696e verbatim copyin │ │ │ │ │ -000489e0: 6720 696e 206f 7468 6572 2072 6573 7065 g in other respe │ │ │ │ │ -000489f0: 6374 732e 0a0a 2020 2020 2049 6620 7468 cts... If th │ │ │ │ │ -00048a00: 6520 7265 7175 6972 6564 2074 6578 7473 e required texts │ │ │ │ │ -00048a10: 2066 6f72 2065 6974 6865 7220 636f 7665 for either cove │ │ │ │ │ -00048a20: 7220 6172 6520 746f 6f20 766f 6c75 6d69 r are too volumi │ │ │ │ │ -00048a30: 6e6f 7573 2074 6f20 6669 740a 2020 2020 nous to fit. │ │ │ │ │ -00048a40: 206c 6567 6962 6c79 2c20 796f 7520 7368 legibly, you sh │ │ │ │ │ -00048a50: 6f75 6c64 2070 7574 2074 6865 2066 6972 ould put the fir │ │ │ │ │ -00048a60: 7374 206f 6e65 7320 6c69 7374 6564 2028 st ones listed ( │ │ │ │ │ -00048a70: 6173 206d 616e 7920 6173 2066 6974 0a20 as many as fit. │ │ │ │ │ -00048a80: 2020 2020 7265 6173 6f6e 6162 6c79 2920 reasonably) │ │ │ │ │ -00048a90: 6f6e 2074 6865 2061 6374 7561 6c20 636f on the actual co │ │ │ │ │ -00048aa0: 7665 722c 2061 6e64 2063 6f6e 7469 6e75 ver, and continu │ │ │ │ │ -00048ab0: 6520 7468 6520 7265 7374 206f 6e74 6f0a e the rest onto. │ │ │ │ │ -00048ac0: 2020 2020 2061 646a 6163 656e 7420 7061 adjacent pa │ │ │ │ │ -00048ad0: 6765 732e 0a0a 2020 2020 2049 6620 796f ges... If yo │ │ │ │ │ -00048ae0: 7520 7075 626c 6973 6820 6f72 2064 6973 u publish or dis │ │ │ │ │ -00048af0: 7472 6962 7574 6520 4f70 6171 7565 2063 tribute Opaque c │ │ │ │ │ -00048b00: 6f70 6965 7320 6f66 2074 6865 2044 6f63 opies of the Doc │ │ │ │ │ -00048b10: 756d 656e 740a 2020 2020 206e 756d 6265 ument. numbe │ │ │ │ │ -00048b20: 7269 6e67 206d 6f72 6520 7468 616e 2031 ring more than 1 │ │ │ │ │ -00048b30: 3030 2c20 796f 7520 6d75 7374 2065 6974 00, you must eit │ │ │ │ │ -00048b40: 6865 7220 696e 636c 7564 6520 6120 6d61 her include a ma │ │ │ │ │ -00048b50: 6368 696e 652d 7265 6164 6162 6c65 0a20 chine-readable. │ │ │ │ │ -00048b60: 2020 2020 5472 616e 7370 6172 656e 7420 Transparent │ │ │ │ │ -00048b70: 636f 7079 2061 6c6f 6e67 2077 6974 6820 copy along with │ │ │ │ │ -00048b80: 6561 6368 204f 7061 7175 6520 636f 7079 each Opaque copy │ │ │ │ │ -00048b90: 2c20 6f72 2073 7461 7465 2069 6e20 6f72 , or state in or │ │ │ │ │ -00048ba0: 2077 6974 680a 2020 2020 2065 6163 6820 with. each │ │ │ │ │ -00048bb0: 4f70 6171 7565 2063 6f70 7920 6120 636f Opaque copy a co │ │ │ │ │ -00048bc0: 6d70 7574 6572 2d6e 6574 776f 726b 206c mputer-network l │ │ │ │ │ -00048bd0: 6f63 6174 696f 6e20 6672 6f6d 2077 6869 ocation from whi │ │ │ │ │ -00048be0: 6368 2074 6865 2067 656e 6572 616c 0a20 ch the general. │ │ │ │ │ -00048bf0: 2020 2020 6e65 7477 6f72 6b2d 7573 696e network-usin │ │ │ │ │ -00048c00: 6720 7075 626c 6963 2068 6173 2061 6363 g public has acc │ │ │ │ │ -00048c10: 6573 7320 746f 2064 6f77 6e6c 6f61 6420 ess to download │ │ │ │ │ -00048c20: 7573 696e 6720 7075 626c 6963 2d73 7461 using public-sta │ │ │ │ │ -00048c30: 6e64 6172 640a 2020 2020 206e 6574 776f ndard. netwo │ │ │ │ │ -00048c40: 726b 2070 726f 746f 636f 6c73 2061 2063 rk protocols a c │ │ │ │ │ -00048c50: 6f6d 706c 6574 6520 5472 616e 7370 6172 omplete Transpar │ │ │ │ │ -00048c60: 656e 7420 636f 7079 206f 6620 7468 6520 ent copy of the │ │ │ │ │ -00048c70: 446f 6375 6d65 6e74 2c20 6672 6565 0a20 Document, free. │ │ │ │ │ -00048c80: 2020 2020 6f66 2061 6464 6564 206d 6174 of added mat │ │ │ │ │ -00048c90: 6572 6961 6c2e 2020 4966 2079 6f75 2075 erial. If you u │ │ │ │ │ -00048ca0: 7365 2074 6865 206c 6174 7465 7220 6f70 se the latter op │ │ │ │ │ -00048cb0: 7469 6f6e 2c20 796f 7520 6d75 7374 2074 tion, you must t │ │ │ │ │ -00048cc0: 616b 650a 2020 2020 2072 6561 736f 6e61 ake. reasona │ │ │ │ │ -00048cd0: 626c 7920 7072 7564 656e 7420 7374 6570 bly prudent step │ │ │ │ │ -00048ce0: 732c 2077 6865 6e20 796f 7520 6265 6769 s, when you begi │ │ │ │ │ -00048cf0: 6e20 6469 7374 7269 6275 7469 6f6e 206f n distribution o │ │ │ │ │ -00048d00: 6620 4f70 6171 7565 0a20 2020 2020 636f f Opaque. co │ │ │ │ │ -00048d10: 7069 6573 2069 6e20 7175 616e 7469 7479 pies in quantity │ │ │ │ │ -00048d20: 2c20 746f 2065 6e73 7572 6520 7468 6174 , to ensure that │ │ │ │ │ -00048d30: 2074 6869 7320 5472 616e 7370 6172 656e this Transparen │ │ │ │ │ -00048d40: 7420 636f 7079 2077 696c 6c0a 2020 2020 t copy will. │ │ │ │ │ -00048d50: 2072 656d 6169 6e20 7468 7573 2061 6363 remain thus acc │ │ │ │ │ -00048d60: 6573 7369 626c 6520 6174 2074 6865 2073 essible at the s │ │ │ │ │ -00048d70: 7461 7465 6420 6c6f 6361 7469 6f6e 2075 tated location u │ │ │ │ │ -00048d80: 6e74 696c 2061 7420 6c65 6173 7420 6f6e ntil at least on │ │ │ │ │ -00048d90: 650a 2020 2020 2079 6561 7220 6166 7465 e. year afte │ │ │ │ │ -00048da0: 7220 7468 6520 6c61 7374 2074 696d 6520 r the last time │ │ │ │ │ -00048db0: 796f 7520 6469 7374 7269 6275 7465 2061 you distribute a │ │ │ │ │ -00048dc0: 6e20 4f70 6171 7565 2063 6f70 7920 2864 n Opaque copy (d │ │ │ │ │ -00048dd0: 6972 6563 746c 7920 6f72 0a20 2020 2020 irectly or. │ │ │ │ │ -00048de0: 7468 726f 7567 6820 796f 7572 2061 6765 through your age │ │ │ │ │ -00048df0: 6e74 7320 6f72 2072 6574 6169 6c65 7273 nts or retailers │ │ │ │ │ -00048e00: 2920 6f66 2074 6861 7420 6564 6974 696f ) of that editio │ │ │ │ │ -00048e10: 6e20 746f 2074 6865 2070 7562 6c69 632e n to the public. │ │ │ │ │ -00048e20: 0a0a 2020 2020 2049 7420 6973 2072 6571 .. It is req │ │ │ │ │ -00048e30: 7565 7374 6564 2c20 6275 7420 6e6f 7420 uested, but not │ │ │ │ │ -00048e40: 7265 7175 6972 6564 2c20 7468 6174 2079 required, that y │ │ │ │ │ -00048e50: 6f75 2063 6f6e 7461 6374 2074 6865 2061 ou contact the a │ │ │ │ │ -00048e60: 7574 686f 7273 206f 660a 2020 2020 2074 uthors of. t │ │ │ │ │ -00048e70: 6865 2044 6f63 756d 656e 7420 7765 6c6c he Document well │ │ │ │ │ -00048e80: 2062 6566 6f72 6520 7265 6469 7374 7269 before redistri │ │ │ │ │ -00048e90: 6275 7469 6e67 2061 6e79 206c 6172 6765 buting any large │ │ │ │ │ -00048ea0: 206e 756d 6265 7220 6f66 2063 6f70 6965 number of copie │ │ │ │ │ -00048eb0: 732c 0a20 2020 2020 746f 2067 6976 6520 s,. to give │ │ │ │ │ -00048ec0: 7468 656d 2061 2063 6861 6e63 6520 746f them a chance to │ │ │ │ │ -00048ed0: 2070 726f 7669 6465 2079 6f75 2077 6974 provide you wit │ │ │ │ │ -00048ee0: 6820 616e 2075 7064 6174 6564 2076 6572 h an updated ver │ │ │ │ │ -00048ef0: 7369 6f6e 206f 6620 7468 650a 2020 2020 sion of the. │ │ │ │ │ -00048f00: 2044 6f63 756d 656e 742e 0a0a 2020 342e Document... 4. │ │ │ │ │ -00048f10: 204d 4f44 4946 4943 4154 494f 4e53 0a0a MODIFICATIONS.. │ │ │ │ │ -00048f20: 2020 2020 2059 6f75 206d 6179 2063 6f70 You may cop │ │ │ │ │ -00048f30: 7920 616e 6420 6469 7374 7269 6275 7465 y and distribute │ │ │ │ │ -00048f40: 2061 204d 6f64 6966 6965 6420 5665 7273 a Modified Vers │ │ │ │ │ -00048f50: 696f 6e20 6f66 2074 6865 2044 6f63 756d ion of the Docum │ │ │ │ │ -00048f60: 656e 740a 2020 2020 2075 6e64 6572 2074 ent. under t │ │ │ │ │ -00048f70: 6865 2063 6f6e 6469 7469 6f6e 7320 6f66 he conditions of │ │ │ │ │ -00048f80: 2073 6563 7469 6f6e 7320 3220 616e 6420 sections 2 and │ │ │ │ │ -00048f90: 3320 6162 6f76 652c 2070 726f 7669 6465 3 above, provide │ │ │ │ │ -00048fa0: 6420 7468 6174 2079 6f75 0a20 2020 2020 d that you. │ │ │ │ │ -00048fb0: 7265 6c65 6173 6520 7468 6520 4d6f 6469 release the Modi │ │ │ │ │ -00048fc0: 6669 6564 2056 6572 7369 6f6e 2075 6e64 fied Version und │ │ │ │ │ -00048fd0: 6572 2070 7265 6369 7365 6c79 2074 6869 er precisely thi │ │ │ │ │ -00048fe0: 7320 4c69 6365 6e73 652c 2077 6974 6820 s License, with │ │ │ │ │ -00048ff0: 7468 650a 2020 2020 204d 6f64 6966 6965 the. Modifie │ │ │ │ │ -00049000: 6420 5665 7273 696f 6e20 6669 6c6c 696e d Version fillin │ │ │ │ │ -00049010: 6720 7468 6520 726f 6c65 206f 6620 7468 g the role of th │ │ │ │ │ -00049020: 6520 446f 6375 6d65 6e74 2c20 7468 7573 e Document, thus │ │ │ │ │ -00049030: 206c 6963 656e 7369 6e67 0a20 2020 2020 licensing. │ │ │ │ │ -00049040: 6469 7374 7269 6275 7469 6f6e 2061 6e64 distribution and │ │ │ │ │ -00049050: 206d 6f64 6966 6963 6174 696f 6e20 6f66 modification of │ │ │ │ │ -00049060: 2074 6865 204d 6f64 6966 6965 6420 5665 the Modified Ve │ │ │ │ │ -00049070: 7273 696f 6e20 746f 2077 686f 6576 6572 rsion to whoever │ │ │ │ │ -00049080: 0a20 2020 2020 706f 7373 6573 7365 7320 . possesses │ │ │ │ │ -00049090: 6120 636f 7079 206f 6620 6974 2e20 2049 a copy of it. I │ │ │ │ │ -000490a0: 6e20 6164 6469 7469 6f6e 2c20 796f 7520 n addition, you │ │ │ │ │ -000490b0: 6d75 7374 2064 6f20 7468 6573 6520 7468 must do these th │ │ │ │ │ -000490c0: 696e 6773 2069 6e0a 2020 2020 2074 6865 ings in. the │ │ │ │ │ -000490d0: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ │ -000490e0: 6e3a 0a0a 2020 2020 2020 2041 2e20 5573 n:.. A. Us │ │ │ │ │ -000490f0: 6520 696e 2074 6865 2054 6974 6c65 2050 e in the Title P │ │ │ │ │ -00049100: 6167 6520 2861 6e64 206f 6e20 7468 6520 age (and on the │ │ │ │ │ -00049110: 636f 7665 7273 2c20 6966 2061 6e79 2920 covers, if any) │ │ │ │ │ -00049120: 6120 7469 746c 650a 2020 2020 2020 2020 a title. │ │ │ │ │ -00049130: 2020 6469 7374 696e 6374 2066 726f 6d20 distinct from │ │ │ │ │ -00049140: 7468 6174 206f 6620 7468 6520 446f 6375 that of the Docu │ │ │ │ │ -00049150: 6d65 6e74 2c20 616e 6420 6672 6f6d 2074 ment, and from t │ │ │ │ │ -00049160: 686f 7365 206f 6620 7072 6576 696f 7573 hose of previous │ │ │ │ │ -00049170: 0a20 2020 2020 2020 2020 2076 6572 7369 . versi │ │ │ │ │ -00049180: 6f6e 7320 2877 6869 6368 2073 686f 756c ons (which shoul │ │ │ │ │ -00049190: 642c 2069 6620 7468 6572 6520 7765 7265 d, if there were │ │ │ │ │ -000491a0: 2061 6e79 2c20 6265 206c 6973 7465 6420 any, be listed │ │ │ │ │ -000491b0: 696e 2074 6865 0a20 2020 2020 2020 2020 in the. │ │ │ │ │ -000491c0: 2048 6973 746f 7279 2073 6563 7469 6f6e History section │ │ │ │ │ -000491d0: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -000491e0: 292e 2020 596f 7520 6d61 7920 7573 6520 ). You may use │ │ │ │ │ -000491f0: 7468 6520 7361 6d65 2074 6974 6c65 0a20 the same title. │ │ │ │ │ -00049200: 2020 2020 2020 2020 2061 7320 6120 7072 as a pr │ │ │ │ │ -00049210: 6576 696f 7573 2076 6572 7369 6f6e 2069 evious version i │ │ │ │ │ -00049220: 6620 7468 6520 6f72 6967 696e 616c 2070 f the original p │ │ │ │ │ -00049230: 7562 6c69 7368 6572 206f 6620 7468 6174 ublisher of that │ │ │ │ │ -00049240: 0a20 2020 2020 2020 2020 2076 6572 7369 . versi │ │ │ │ │ -00049250: 6f6e 2067 6976 6573 2070 6572 6d69 7373 on gives permiss │ │ │ │ │ -00049260: 696f 6e2e 0a0a 2020 2020 2020 2042 2e20 ion... B. │ │ │ │ │ -00049270: 4c69 7374 206f 6e20 7468 6520 5469 746c List on the Titl │ │ │ │ │ -00049280: 6520 5061 6765 2c20 6173 2061 7574 686f e Page, as autho │ │ │ │ │ -00049290: 7273 2c20 6f6e 6520 6f72 206d 6f72 6520 rs, one or more │ │ │ │ │ -000492a0: 7065 7273 6f6e 7320 6f72 0a20 2020 2020 persons or. │ │ │ │ │ -000492b0: 2020 2020 2065 6e74 6974 6965 7320 7265 entities re │ │ │ │ │ -000492c0: 7370 6f6e 7369 626c 6520 666f 7220 6175 sponsible for au │ │ │ │ │ -000492d0: 7468 6f72 7368 6970 206f 6620 7468 6520 thorship of the │ │ │ │ │ -000492e0: 6d6f 6469 6669 6361 7469 6f6e 7320 696e modifications in │ │ │ │ │ -000492f0: 0a20 2020 2020 2020 2020 2074 6865 204d . the M │ │ │ │ │ -00049300: 6f64 6966 6965 6420 5665 7273 696f 6e2c odified Version, │ │ │ │ │ -00049310: 2074 6f67 6574 6865 7220 7769 7468 2061 together with a │ │ │ │ │ -00049320: 7420 6c65 6173 7420 6669 7665 206f 6620 t least five of │ │ │ │ │ -00049330: 7468 650a 2020 2020 2020 2020 2020 7072 the. pr │ │ │ │ │ -00049340: 696e 6369 7061 6c20 6175 7468 6f72 7320 incipal authors │ │ │ │ │ -00049350: 6f66 2074 6865 2044 6f63 756d 656e 7420 of the Document │ │ │ │ │ -00049360: 2861 6c6c 206f 6620 6974 7320 7072 696e (all of its prin │ │ │ │ │ -00049370: 6369 7061 6c0a 2020 2020 2020 2020 2020 cipal. │ │ │ │ │ -00049380: 6175 7468 6f72 732c 2069 6620 6974 2068 authors, if it h │ │ │ │ │ -00049390: 6173 2066 6577 6572 2074 6861 6e20 6669 as fewer than fi │ │ │ │ │ -000493a0: 7665 292c 2075 6e6c 6573 7320 7468 6579 ve), unless they │ │ │ │ │ -000493b0: 2072 656c 6561 7365 2079 6f75 0a20 2020 release you. │ │ │ │ │ -000493c0: 2020 2020 2020 2066 726f 6d20 7468 6973 from this │ │ │ │ │ -000493d0: 2072 6571 7569 7265 6d65 6e74 2e0a 0a20 requirement... │ │ │ │ │ -000493e0: 2020 2020 2020 432e 2053 7461 7465 206f C. State o │ │ │ │ │ -000493f0: 6e20 7468 6520 5469 746c 6520 7061 6765 n the Title page │ │ │ │ │ -00049400: 2074 6865 206e 616d 6520 6f66 2074 6865 the name of the │ │ │ │ │ -00049410: 2070 7562 6c69 7368 6572 206f 6620 7468 publisher of th │ │ │ │ │ -00049420: 650a 2020 2020 2020 2020 2020 4d6f 6469 e. Modi │ │ │ │ │ -00049430: 6669 6564 2056 6572 7369 6f6e 2c20 6173 fied Version, as │ │ │ │ │ -00049440: 2074 6865 2070 7562 6c69 7368 6572 2e0a the publisher.. │ │ │ │ │ -00049450: 0a20 2020 2020 2020 442e 2050 7265 7365 . D. Prese │ │ │ │ │ -00049460: 7276 6520 616c 6c20 7468 6520 636f 7079 rve all the copy │ │ │ │ │ -00049470: 7269 6768 7420 6e6f 7469 6365 7320 6f66 right notices of │ │ │ │ │ -00049480: 2074 6865 2044 6f63 756d 656e 742e 0a0a the Document... │ │ │ │ │ -00049490: 2020 2020 2020 2045 2e20 4164 6420 616e E. Add an │ │ │ │ │ -000494a0: 2061 7070 726f 7072 6961 7465 2063 6f70 appropriate cop │ │ │ │ │ -000494b0: 7972 6967 6874 206e 6f74 6963 6520 666f yright notice fo │ │ │ │ │ -000494c0: 7220 796f 7572 206d 6f64 6966 6963 6174 r your modificat │ │ │ │ │ -000494d0: 696f 6e73 0a20 2020 2020 2020 2020 2061 ions. a │ │ │ │ │ -000494e0: 646a 6163 656e 7420 746f 2074 6865 206f djacent to the o │ │ │ │ │ -000494f0: 7468 6572 2063 6f70 7972 6967 6874 206e ther copyright n │ │ │ │ │ -00049500: 6f74 6963 6573 2e0a 0a20 2020 2020 2020 otices... │ │ │ │ │ -00049510: 462e 2049 6e63 6c75 6465 2c20 696d 6d65 F. Include, imme │ │ │ │ │ -00049520: 6469 6174 656c 7920 6166 7465 7220 7468 diately after th │ │ │ │ │ -00049530: 6520 636f 7079 7269 6768 7420 6e6f 7469 e copyright noti │ │ │ │ │ -00049540: 6365 732c 2061 206c 6963 656e 7365 0a20 ces, a license. │ │ │ │ │ -00049550: 2020 2020 2020 2020 206e 6f74 6963 6520 notice │ │ │ │ │ -00049560: 6769 7669 6e67 2074 6865 2070 7562 6c69 giving the publi │ │ │ │ │ -00049570: 6320 7065 726d 6973 7369 6f6e 2074 6f20 c permission to │ │ │ │ │ -00049580: 7573 6520 7468 6520 4d6f 6469 6669 6564 use the Modified │ │ │ │ │ -00049590: 0a20 2020 2020 2020 2020 2056 6572 7369 . Versi │ │ │ │ │ -000495a0: 6f6e 2075 6e64 6572 2074 6865 2074 6572 on under the ter │ │ │ │ │ -000495b0: 6d73 206f 6620 7468 6973 204c 6963 656e ms of this Licen │ │ │ │ │ -000495c0: 7365 2c20 696e 2074 6865 2066 6f72 6d20 se, in the form │ │ │ │ │ -000495d0: 7368 6f77 6e20 696e 0a20 2020 2020 2020 shown in. │ │ │ │ │ -000495e0: 2020 2074 6865 2041 6464 656e 6475 6d20 the Addendum │ │ │ │ │ -000495f0: 6265 6c6f 772e 0a0a 2020 2020 2020 2047 below... G │ │ │ │ │ -00049600: 2e20 5072 6573 6572 7665 2069 6e20 7468 . Preserve in th │ │ │ │ │ -00049610: 6174 206c 6963 656e 7365 206e 6f74 6963 at license notic │ │ │ │ │ -00049620: 6520 7468 6520 6675 6c6c 206c 6973 7473 e the full lists │ │ │ │ │ -00049630: 206f 6620 496e 7661 7269 616e 740a 2020 of Invariant. │ │ │ │ │ -00049640: 2020 2020 2020 2020 5365 6374 696f 6e73 Sections │ │ │ │ │ -00049650: 2061 6e64 2072 6571 7569 7265 6420 436f and required Co │ │ │ │ │ -00049660: 7665 7220 5465 7874 7320 6769 7665 6e20 ver Texts given │ │ │ │ │ -00049670: 696e 2074 6865 2044 6f63 756d 656e 7427 in the Document' │ │ │ │ │ -00049680: 730a 2020 2020 2020 2020 2020 6c69 6365 s. lice │ │ │ │ │ -00049690: 6e73 6520 6e6f 7469 6365 2e0a 0a20 2020 nse notice... │ │ │ │ │ -000496a0: 2020 2020 482e 2049 6e63 6c75 6465 2061 H. Include a │ │ │ │ │ -000496b0: 6e20 756e 616c 7465 7265 6420 636f 7079 n unaltered copy │ │ │ │ │ -000496c0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ -000496d0: 2e0a 0a20 2020 2020 2020 492e 2050 7265 ... I. Pre │ │ │ │ │ -000496e0: 7365 7276 6520 7468 6520 7365 6374 696f serve the sectio │ │ │ │ │ -000496f0: 6e20 456e 7469 746c 6564 2022 4869 7374 n Entitled "Hist │ │ │ │ │ -00049700: 6f72 7922 2c20 5072 6573 6572 7665 2069 ory", Preserve i │ │ │ │ │ -00049710: 7473 2054 6974 6c65 2c0a 2020 2020 2020 ts Title,. │ │ │ │ │ -00049720: 2020 2020 616e 6420 6164 6420 746f 2069 and add to i │ │ │ │ │ -00049730: 7420 616e 2069 7465 6d20 7374 6174 696e t an item statin │ │ │ │ │ -00049740: 6720 6174 206c 6561 7374 2074 6865 2074 g at least the t │ │ │ │ │ -00049750: 6974 6c65 2c20 7965 6172 2c20 6e65 770a itle, year, new. │ │ │ │ │ -00049760: 2020 2020 2020 2020 2020 6175 7468 6f72 author │ │ │ │ │ -00049770: 732c 2061 6e64 2070 7562 6c69 7368 6572 s, and publisher │ │ │ │ │ -00049780: 206f 6620 7468 6520 4d6f 6469 6669 6564 of the Modified │ │ │ │ │ -00049790: 2056 6572 7369 6f6e 2061 7320 6769 7665 Version as give │ │ │ │ │ -000497a0: 6e20 6f6e 2074 6865 0a20 2020 2020 2020 n on the. │ │ │ │ │ -000497b0: 2020 2054 6974 6c65 2050 6167 652e 2020 Title Page. │ │ │ │ │ -000497c0: 4966 2074 6865 7265 2069 7320 6e6f 2073 If there is no s │ │ │ │ │ -000497d0: 6563 7469 6f6e 2045 6e74 6974 6c65 6420 ection Entitled │ │ │ │ │ -000497e0: 2248 6973 746f 7279 2220 696e 2074 6865 "History" in the │ │ │ │ │ -000497f0: 0a20 2020 2020 2020 2020 2044 6f63 756d . Docum │ │ │ │ │ -00049800: 656e 742c 2063 7265 6174 6520 6f6e 6520 ent, create one │ │ │ │ │ -00049810: 7374 6174 696e 6720 7468 6520 7469 746c stating the titl │ │ │ │ │ -00049820: 652c 2079 6561 722c 2061 7574 686f 7273 e, year, authors │ │ │ │ │ -00049830: 2c20 616e 640a 2020 2020 2020 2020 2020 , and. │ │ │ │ │ -00049840: 7075 626c 6973 6865 7220 6f66 2074 6865 publisher of the │ │ │ │ │ -00049850: 2044 6f63 756d 656e 7420 6173 2067 6976 Document as giv │ │ │ │ │ -00049860: 656e 206f 6e20 6974 7320 5469 746c 6520 en on its Title │ │ │ │ │ -00049870: 5061 6765 2c20 7468 656e 2061 6464 0a20 Page, then add. │ │ │ │ │ -00049880: 2020 2020 2020 2020 2061 6e20 6974 656d an item │ │ │ │ │ -00049890: 2064 6573 6372 6962 696e 6720 7468 6520 describing the │ │ │ │ │ -000498a0: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ │ -000498b0: 2061 7320 7374 6174 6564 2069 6e20 7468 as stated in th │ │ │ │ │ -000498c0: 650a 2020 2020 2020 2020 2020 7072 6576 e. prev │ │ │ │ │ -000498d0: 696f 7573 2073 656e 7465 6e63 652e 0a0a ious sentence... │ │ │ │ │ -000498e0: 2020 2020 2020 204a 2e20 5072 6573 6572 J. Preser │ │ │ │ │ -000498f0: 7665 2074 6865 206e 6574 776f 726b 206c ve the network l │ │ │ │ │ -00049900: 6f63 6174 696f 6e2c 2069 6620 616e 792c ocation, if any, │ │ │ │ │ -00049910: 2067 6976 656e 2069 6e20 7468 6520 446f given in the Do │ │ │ │ │ -00049920: 6375 6d65 6e74 0a20 2020 2020 2020 2020 cument. │ │ │ │ │ -00049930: 2066 6f72 2070 7562 6c69 6320 6163 6365 for public acce │ │ │ │ │ -00049940: 7373 2074 6f20 6120 5472 616e 7370 6172 ss to a Transpar │ │ │ │ │ -00049950: 656e 7420 636f 7079 206f 6620 7468 6520 ent copy of the │ │ │ │ │ -00049960: 446f 6375 6d65 6e74 2c20 616e 640a 2020 Document, and. │ │ │ │ │ -00049970: 2020 2020 2020 2020 6c69 6b65 7769 7365 likewise │ │ │ │ │ -00049980: 2074 6865 206e 6574 776f 726b 206c 6f63 the network loc │ │ │ │ │ -00049990: 6174 696f 6e73 2067 6976 656e 2069 6e20 ations given in │ │ │ │ │ -000499a0: 7468 6520 446f 6375 6d65 6e74 2066 6f72 the Document for │ │ │ │ │ -000499b0: 0a20 2020 2020 2020 2020 2070 7265 7669 . previ │ │ │ │ │ -000499c0: 6f75 7320 7665 7273 696f 6e73 2069 7420 ous versions it │ │ │ │ │ -000499d0: 7761 7320 6261 7365 6420 6f6e 2e20 2054 was based on. T │ │ │ │ │ -000499e0: 6865 7365 206d 6179 2062 6520 706c 6163 hese may be plac │ │ │ │ │ -000499f0: 6564 2069 6e20 7468 650a 2020 2020 2020 ed in the. │ │ │ │ │ -00049a00: 2020 2020 2248 6973 746f 7279 2220 7365 "History" se │ │ │ │ │ -00049a10: 6374 696f 6e2e 2020 596f 7520 6d61 7920 ction. You may │ │ │ │ │ -00049a20: 6f6d 6974 2061 206e 6574 776f 726b 206c omit a network l │ │ │ │ │ -00049a30: 6f63 6174 696f 6e20 666f 7220 6120 776f ocation for a wo │ │ │ │ │ -00049a40: 726b 0a20 2020 2020 2020 2020 2074 6861 rk. tha │ │ │ │ │ -00049a50: 7420 7761 7320 7075 626c 6973 6865 6420 t was published │ │ │ │ │ -00049a60: 6174 206c 6561 7374 2066 6f75 7220 7965 at least four ye │ │ │ │ │ -00049a70: 6172 7320 6265 666f 7265 2074 6865 2044 ars before the D │ │ │ │ │ -00049a80: 6f63 756d 656e 740a 2020 2020 2020 2020 ocument. │ │ │ │ │ -00049a90: 2020 6974 7365 6c66 2c20 6f72 2069 6620 itself, or if │ │ │ │ │ -00049aa0: 7468 6520 6f72 6967 696e 616c 2070 7562 the original pub │ │ │ │ │ -00049ab0: 6c69 7368 6572 206f 6620 7468 6520 7665 lisher of the ve │ │ │ │ │ -00049ac0: 7273 696f 6e20 6974 2072 6566 6572 730a rsion it refers. │ │ │ │ │ -00049ad0: 2020 2020 2020 2020 2020 746f 2067 6976 to giv │ │ │ │ │ -00049ae0: 6573 2070 6572 6d69 7373 696f 6e2e 0a0a es permission... │ │ │ │ │ -00049af0: 2020 2020 2020 204b 2e20 466f 7220 616e K. For an │ │ │ │ │ -00049b00: 7920 7365 6374 696f 6e20 456e 7469 746c y section Entitl │ │ │ │ │ -00049b10: 6564 2022 4163 6b6e 6f77 6c65 6467 656d ed "Acknowledgem │ │ │ │ │ -00049b20: 656e 7473 2220 6f72 2022 4465 6469 6361 ents" or "Dedica │ │ │ │ │ -00049b30: 7469 6f6e 7322 2c0a 2020 2020 2020 2020 tions",. │ │ │ │ │ -00049b40: 2020 5072 6573 6572 7665 2074 6865 2054 Preserve the T │ │ │ │ │ -00049b50: 6974 6c65 206f 6620 7468 6520 7365 6374 itle of the sect │ │ │ │ │ -00049b60: 696f 6e2c 2061 6e64 2070 7265 7365 7276 ion, and preserv │ │ │ │ │ -00049b70: 6520 696e 2074 6865 2073 6563 7469 6f6e e in the section │ │ │ │ │ -00049b80: 0a20 2020 2020 2020 2020 2061 6c6c 2074 . all t │ │ │ │ │ -00049b90: 6865 2073 7562 7374 616e 6365 2061 6e64 he substance and │ │ │ │ │ -00049ba0: 2074 6f6e 6520 6f66 2065 6163 6820 6f66 tone of each of │ │ │ │ │ -00049bb0: 2074 6865 2063 6f6e 7472 6962 7574 6f72 the contributor │ │ │ │ │ -00049bc0: 0a20 2020 2020 2020 2020 2061 636b 6e6f . ackno │ │ │ │ │ -00049bd0: 776c 6564 6765 6d65 6e74 7320 616e 642f wledgements and/ │ │ │ │ │ -00049be0: 6f72 2064 6564 6963 6174 696f 6e73 2067 or dedications g │ │ │ │ │ -00049bf0: 6976 656e 2074 6865 7265 696e 2e0a 0a20 iven therein... │ │ │ │ │ -00049c00: 2020 2020 2020 4c2e 2050 7265 7365 7276 L. Preserv │ │ │ │ │ -00049c10: 6520 616c 6c20 7468 6520 496e 7661 7269 e all the Invari │ │ │ │ │ -00049c20: 616e 7420 5365 6374 696f 6e73 206f 6620 ant Sections of │ │ │ │ │ -00049c30: 7468 6520 446f 6375 6d65 6e74 2c20 756e the Document, un │ │ │ │ │ -00049c40: 616c 7465 7265 640a 2020 2020 2020 2020 altered. │ │ │ │ │ -00049c50: 2020 696e 2074 6865 6972 2074 6578 7420 in their text │ │ │ │ │ -00049c60: 616e 6420 696e 2074 6865 6972 2074 6974 and in their tit │ │ │ │ │ -00049c70: 6c65 732e 2020 5365 6374 696f 6e20 6e75 les. Section nu │ │ │ │ │ -00049c80: 6d62 6572 7320 6f72 2074 6865 0a20 2020 mbers or the. │ │ │ │ │ -00049c90: 2020 2020 2020 2065 7175 6976 616c 656e equivalen │ │ │ │ │ -00049ca0: 7420 6172 6520 6e6f 7420 636f 6e73 6964 t are not consid │ │ │ │ │ -00049cb0: 6572 6564 2070 6172 7420 6f66 2074 6865 ered part of the │ │ │ │ │ -00049cc0: 2073 6563 7469 6f6e 2074 6974 6c65 732e section titles. │ │ │ │ │ -00049cd0: 0a0a 2020 2020 2020 204d 2e20 4465 6c65 .. M. Dele │ │ │ │ │ -00049ce0: 7465 2061 6e79 2073 6563 7469 6f6e 2045 te any section E │ │ │ │ │ -00049cf0: 6e74 6974 6c65 6420 2245 6e64 6f72 7365 ntitled "Endorse │ │ │ │ │ -00049d00: 6d65 6e74 7322 2e20 2053 7563 6820 6120 ments". Such a │ │ │ │ │ -00049d10: 7365 6374 696f 6e0a 2020 2020 2020 2020 section. │ │ │ │ │ -00049d20: 2020 6d61 7920 6e6f 7420 6265 2069 6e63 may not be inc │ │ │ │ │ -00049d30: 6c75 6465 6420 696e 2074 6865 204d 6f64 luded in the Mod │ │ │ │ │ -00049d40: 6966 6965 6420 5665 7273 696f 6e2e 0a0a ified Version... │ │ │ │ │ -00049d50: 2020 2020 2020 204e 2e20 446f 206e 6f74 N. Do not │ │ │ │ │ -00049d60: 2072 6574 6974 6c65 2061 6e79 2065 7869 retitle any exi │ │ │ │ │ -00049d70: 7374 696e 6720 7365 6374 696f 6e20 746f sting section to │ │ │ │ │ -00049d80: 2062 6520 456e 7469 746c 6564 0a20 2020 be Entitled. │ │ │ │ │ -00049d90: 2020 2020 2020 2022 456e 646f 7273 656d "Endorsem │ │ │ │ │ -00049da0: 656e 7473 2220 6f72 2074 6f20 636f 6e66 ents" or to conf │ │ │ │ │ -00049db0: 6c69 6374 2069 6e20 7469 746c 6520 7769 lict in title wi │ │ │ │ │ -00049dc0: 7468 2061 6e79 2049 6e76 6172 6961 6e74 th any Invariant │ │ │ │ │ -00049dd0: 0a20 2020 2020 2020 2020 2053 6563 7469 . Secti │ │ │ │ │ -00049de0: 6f6e 2e0a 0a20 2020 2020 2020 4f2e 2050 on... O. P │ │ │ │ │ -00049df0: 7265 7365 7276 6520 616e 7920 5761 7272 reserve any Warr │ │ │ │ │ -00049e00: 616e 7479 2044 6973 636c 6169 6d65 7273 anty Disclaimers │ │ │ │ │ -00049e10: 2e0a 0a20 2020 2020 4966 2074 6865 204d ... If the M │ │ │ │ │ -00049e20: 6f64 6966 6965 6420 5665 7273 696f 6e20 odified Version │ │ │ │ │ -00049e30: 696e 636c 7564 6573 206e 6577 2066 726f includes new fro │ │ │ │ │ -00049e40: 6e74 2d6d 6174 7465 7220 7365 6374 696f nt-matter sectio │ │ │ │ │ -00049e50: 6e73 206f 720a 2020 2020 2061 7070 656e ns or. appen │ │ │ │ │ -00049e60: 6469 6365 7320 7468 6174 2071 7561 6c69 dices that quali │ │ │ │ │ -00049e70: 6679 2061 7320 5365 636f 6e64 6172 7920 fy as Secondary │ │ │ │ │ -00049e80: 5365 6374 696f 6e73 2061 6e64 2063 6f6e Sections and con │ │ │ │ │ -00049e90: 7461 696e 206e 6f0a 2020 2020 206d 6174 tain no. mat │ │ │ │ │ -00049ea0: 6572 6961 6c20 636f 7069 6564 2066 726f erial copied fro │ │ │ │ │ -00049eb0: 6d20 7468 6520 446f 6375 6d65 6e74 2c20 m the Document, │ │ │ │ │ -00049ec0: 796f 7520 6d61 7920 6174 2079 6f75 7220 you may at your │ │ │ │ │ -00049ed0: 6f70 7469 6f6e 2064 6573 6967 6e61 7465 option designate │ │ │ │ │ -00049ee0: 0a20 2020 2020 736f 6d65 206f 7220 616c . some or al │ │ │ │ │ -00049ef0: 6c20 6f66 2074 6865 7365 2073 6563 7469 l of these secti │ │ │ │ │ -00049f00: 6f6e 7320 6173 2069 6e76 6172 6961 6e74 ons as invariant │ │ │ │ │ -00049f10: 2e20 2054 6f20 646f 2074 6869 732c 2061 . To do this, a │ │ │ │ │ -00049f20: 6464 2074 6865 6972 0a20 2020 2020 7469 dd their. ti │ │ │ │ │ -00049f30: 746c 6573 2074 6f20 7468 6520 6c69 7374 tles to the list │ │ │ │ │ -00049f40: 206f 6620 496e 7661 7269 616e 7420 5365 of Invariant Se │ │ │ │ │ -00049f50: 6374 696f 6e73 2069 6e20 7468 6520 4d6f ctions in the Mo │ │ │ │ │ -00049f60: 6469 6669 6564 2056 6572 7369 6f6e 2773 dified Version's │ │ │ │ │ -00049f70: 0a20 2020 2020 6c69 6365 6e73 6520 6e6f . license no │ │ │ │ │ -00049f80: 7469 6365 2e20 2054 6865 7365 2074 6974 tice. These tit │ │ │ │ │ -00049f90: 6c65 7320 6d75 7374 2062 6520 6469 7374 les must be dist │ │ │ │ │ -00049fa0: 696e 6374 2066 726f 6d20 616e 7920 6f74 inct from any ot │ │ │ │ │ -00049fb0: 6865 720a 2020 2020 2073 6563 7469 6f6e her. section │ │ │ │ │ -00049fc0: 2074 6974 6c65 732e 0a0a 2020 2020 2059 titles... Y │ │ │ │ │ -00049fd0: 6f75 206d 6179 2061 6464 2061 2073 6563 ou may add a sec │ │ │ │ │ -00049fe0: 7469 6f6e 2045 6e74 6974 6c65 6420 2245 tion Entitled "E │ │ │ │ │ -00049ff0: 6e64 6f72 7365 6d65 6e74 7322 2c20 7072 ndorsements", pr │ │ │ │ │ -0004a000: 6f76 6964 6564 2069 7420 636f 6e74 6169 ovided it contai │ │ │ │ │ -0004a010: 6e73 0a20 2020 2020 6e6f 7468 696e 6720 ns. nothing │ │ │ │ │ -0004a020: 6275 7420 656e 646f 7273 656d 656e 7473 but endorsements │ │ │ │ │ -0004a030: 206f 6620 796f 7572 204d 6f64 6966 6965 of your Modifie │ │ │ │ │ -0004a040: 6420 5665 7273 696f 6e20 6279 2076 6172 d Version by var │ │ │ │ │ -0004a050: 696f 7573 0a20 2020 2020 7061 7274 6965 ious. partie │ │ │ │ │ -0004a060: 732d 2d66 6f72 2065 7861 6d70 6c65 2c20 s--for example, │ │ │ │ │ -0004a070: 7374 6174 656d 656e 7473 206f 6620 7065 statements of pe │ │ │ │ │ -0004a080: 6572 2072 6576 6965 7720 6f72 2074 6861 er review or tha │ │ │ │ │ -0004a090: 7420 7468 6520 7465 7874 0a20 2020 2020 t the text. │ │ │ │ │ -0004a0a0: 6861 7320 6265 656e 2061 7070 726f 7665 has been approve │ │ │ │ │ -0004a0b0: 6420 6279 2061 6e20 6f72 6761 6e69 7a61 d by an organiza │ │ │ │ │ -0004a0c0: 7469 6f6e 2061 7320 7468 6520 6175 7468 tion as the auth │ │ │ │ │ -0004a0d0: 6f72 6974 6174 6976 650a 2020 2020 2064 oritative. d │ │ │ │ │ -0004a0e0: 6566 696e 6974 696f 6e20 6f66 2061 2073 efinition of a s │ │ │ │ │ -0004a0f0: 7461 6e64 6172 642e 0a0a 2020 2020 2059 tandard... Y │ │ │ │ │ -0004a100: 6f75 206d 6179 2061 6464 2061 2070 6173 ou may add a pas │ │ │ │ │ -0004a110: 7361 6765 206f 6620 7570 2074 6f20 6669 sage of up to fi │ │ │ │ │ -0004a120: 7665 2077 6f72 6473 2061 7320 6120 4672 ve words as a Fr │ │ │ │ │ -0004a130: 6f6e 742d 436f 7665 7220 5465 7874 2c0a ont-Cover Text,. │ │ │ │ │ -0004a140: 2020 2020 2061 6e64 2061 2070 6173 7361 and a passa │ │ │ │ │ -0004a150: 6765 206f 6620 7570 2074 6f20 3235 2077 ge of up to 25 w │ │ │ │ │ -0004a160: 6f72 6473 2061 7320 6120 4261 636b 2d43 ords as a Back-C │ │ │ │ │ -0004a170: 6f76 6572 2054 6578 742c 2074 6f20 7468 over Text, to th │ │ │ │ │ -0004a180: 6520 656e 6420 6f66 0a20 2020 2020 7468 e end of. th │ │ │ │ │ -0004a190: 6520 6c69 7374 206f 6620 436f 7665 7220 e list of Cover │ │ │ │ │ -0004a1a0: 5465 7874 7320 696e 2074 6865 204d 6f64 Texts in the Mod │ │ │ │ │ -0004a1b0: 6966 6965 6420 5665 7273 696f 6e2e 2020 ified Version. │ │ │ │ │ -0004a1c0: 4f6e 6c79 206f 6e65 2070 6173 7361 6765 Only one passage │ │ │ │ │ -0004a1d0: 0a20 2020 2020 6f66 2046 726f 6e74 2d43 . of Front-C │ │ │ │ │ -0004a1e0: 6f76 6572 2054 6578 7420 616e 6420 6f6e over Text and on │ │ │ │ │ -0004a1f0: 6520 6f66 2042 6163 6b2d 436f 7665 7220 e of Back-Cover │ │ │ │ │ -0004a200: 5465 7874 206d 6179 2062 6520 6164 6465 Text may be adde │ │ │ │ │ -0004a210: 6420 6279 2028 6f72 0a20 2020 2020 7468 d by (or. th │ │ │ │ │ -0004a220: 726f 7567 6820 6172 7261 6e67 656d 656e rough arrangemen │ │ │ │ │ -0004a230: 7473 206d 6164 6520 6279 2920 616e 7920 ts made by) any │ │ │ │ │ -0004a240: 6f6e 6520 656e 7469 7479 2e20 2049 6620 one entity. If │ │ │ │ │ -0004a250: 7468 6520 446f 6375 6d65 6e74 0a20 2020 the Document. │ │ │ │ │ -0004a260: 2020 616c 7265 6164 7920 696e 636c 7564 already includ │ │ │ │ │ -0004a270: 6573 2061 2063 6f76 6572 2074 6578 7420 es a cover text │ │ │ │ │ -0004a280: 666f 7220 7468 6520 7361 6d65 2063 6f76 for the same cov │ │ │ │ │ -0004a290: 6572 2c20 7072 6576 696f 7573 6c79 2061 er, previously a │ │ │ │ │ -0004a2a0: 6464 6564 0a20 2020 2020 6279 2079 6f75 dded. by you │ │ │ │ │ -0004a2b0: 206f 7220 6279 2061 7272 616e 6765 6d65 or by arrangeme │ │ │ │ │ -0004a2c0: 6e74 206d 6164 6520 6279 2074 6865 2073 nt made by the s │ │ │ │ │ -0004a2d0: 616d 6520 656e 7469 7479 2079 6f75 2061 ame entity you a │ │ │ │ │ -0004a2e0: 7265 2061 6374 696e 6720 6f6e 0a20 2020 re acting on. │ │ │ │ │ -0004a2f0: 2020 6265 6861 6c66 206f 662c 2079 6f75 behalf of, you │ │ │ │ │ -0004a300: 206d 6179 206e 6f74 2061 6464 2061 6e6f may not add ano │ │ │ │ │ -0004a310: 7468 6572 3b20 6275 7420 796f 7520 6d61 ther; but you ma │ │ │ │ │ -0004a320: 7920 7265 706c 6163 6520 7468 6520 6f6c y replace the ol │ │ │ │ │ -0004a330: 640a 2020 2020 206f 6e65 2c20 6f6e 2065 d. one, on e │ │ │ │ │ -0004a340: 7870 6c69 6369 7420 7065 726d 6973 7369 xplicit permissi │ │ │ │ │ -0004a350: 6f6e 2066 726f 6d20 7468 6520 7072 6576 on from the prev │ │ │ │ │ -0004a360: 696f 7573 2070 7562 6c69 7368 6572 2074 ious publisher t │ │ │ │ │ -0004a370: 6861 7420 6164 6465 640a 2020 2020 2074 hat added. t │ │ │ │ │ -0004a380: 6865 206f 6c64 206f 6e65 2e0a 0a20 2020 he old one... │ │ │ │ │ -0004a390: 2020 5468 6520 6175 7468 6f72 2873 2920 The author(s) │ │ │ │ │ -0004a3a0: 616e 6420 7075 626c 6973 6865 7228 7329 and publisher(s) │ │ │ │ │ -0004a3b0: 206f 6620 7468 6520 446f 6375 6d65 6e74 of the Document │ │ │ │ │ -0004a3c0: 2064 6f20 6e6f 7420 6279 2074 6869 730a do not by this. │ │ │ │ │ -0004a3d0: 2020 2020 204c 6963 656e 7365 2067 6976 License giv │ │ │ │ │ -0004a3e0: 6520 7065 726d 6973 7369 6f6e 2074 6f20 e permission to │ │ │ │ │ -0004a3f0: 7573 6520 7468 6569 7220 6e61 6d65 7320 use their names │ │ │ │ │ -0004a400: 666f 7220 7075 626c 6963 6974 7920 666f for publicity fo │ │ │ │ │ -0004a410: 7220 6f72 2074 6f0a 2020 2020 2061 7373 r or to. ass │ │ │ │ │ -0004a420: 6572 7420 6f72 2069 6d70 6c79 2065 6e64 ert or imply end │ │ │ │ │ -0004a430: 6f72 7365 6d65 6e74 206f 6620 616e 7920 orsement of any │ │ │ │ │ -0004a440: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ │ -0004a450: 2e0a 0a20 2035 2e20 434f 4d42 494e 494e ... 5. COMBININ │ │ │ │ │ -0004a460: 4720 444f 4355 4d45 4e54 530a 0a20 2020 G DOCUMENTS.. │ │ │ │ │ -0004a470: 2020 596f 7520 6d61 7920 636f 6d62 696e You may combin │ │ │ │ │ -0004a480: 6520 7468 6520 446f 6375 6d65 6e74 2077 e the Document w │ │ │ │ │ -0004a490: 6974 6820 6f74 6865 7220 646f 6375 6d65 ith other docume │ │ │ │ │ -0004a4a0: 6e74 7320 7265 6c65 6173 6564 2075 6e64 nts released und │ │ │ │ │ -0004a4b0: 6572 0a20 2020 2020 7468 6973 204c 6963 er. this Lic │ │ │ │ │ -0004a4c0: 656e 7365 2c20 756e 6465 7220 7468 6520 ense, under the │ │ │ │ │ -0004a4d0: 7465 726d 7320 6465 6669 6e65 6420 696e terms defined in │ │ │ │ │ -0004a4e0: 2073 6563 7469 6f6e 2034 2061 626f 7665 section 4 above │ │ │ │ │ -0004a4f0: 2066 6f72 0a20 2020 2020 6d6f 6469 6669 for. modifi │ │ │ │ │ -0004a500: 6564 2076 6572 7369 6f6e 732c 2070 726f ed versions, pro │ │ │ │ │ -0004a510: 7669 6465 6420 7468 6174 2079 6f75 2069 vided that you i │ │ │ │ │ -0004a520: 6e63 6c75 6465 2069 6e20 7468 6520 636f nclude in the co │ │ │ │ │ -0004a530: 6d62 696e 6174 696f 6e20 616c 6c0a 2020 mbination all. │ │ │ │ │ -0004a540: 2020 206f 6620 7468 6520 496e 7661 7269 of the Invari │ │ │ │ │ -0004a550: 616e 7420 5365 6374 696f 6e73 206f 6620 ant Sections of │ │ │ │ │ -0004a560: 616c 6c20 6f66 2074 6865 206f 7269 6769 all of the origi │ │ │ │ │ -0004a570: 6e61 6c20 646f 6375 6d65 6e74 732c 0a20 nal documents,. │ │ │ │ │ -0004a580: 2020 2020 756e 6d6f 6469 6669 6564 2c20 unmodified, │ │ │ │ │ -0004a590: 616e 6420 6c69 7374 2074 6865 6d20 616c and list them al │ │ │ │ │ -0004a5a0: 6c20 6173 2049 6e76 6172 6961 6e74 2053 l as Invariant S │ │ │ │ │ -0004a5b0: 6563 7469 6f6e 7320 6f66 2079 6f75 720a ections of your. │ │ │ │ │ -0004a5c0: 2020 2020 2063 6f6d 6269 6e65 6420 776f combined wo │ │ │ │ │ -0004a5d0: 726b 2069 6e20 6974 7320 6c69 6365 6e73 rk in its licens │ │ │ │ │ -0004a5e0: 6520 6e6f 7469 6365 2c20 616e 6420 7468 e notice, and th │ │ │ │ │ -0004a5f0: 6174 2079 6f75 2070 7265 7365 7276 6520 at you preserve │ │ │ │ │ -0004a600: 616c 6c0a 2020 2020 2074 6865 6972 2057 all. their W │ │ │ │ │ -0004a610: 6172 7261 6e74 7920 4469 7363 6c61 696d arranty Disclaim │ │ │ │ │ -0004a620: 6572 732e 0a0a 2020 2020 2054 6865 2063 ers... The c │ │ │ │ │ -0004a630: 6f6d 6269 6e65 6420 776f 726b 206e 6565 ombined work nee │ │ │ │ │ -0004a640: 6420 6f6e 6c79 2063 6f6e 7461 696e 206f d only contain o │ │ │ │ │ -0004a650: 6e65 2063 6f70 7920 6f66 2074 6869 7320 ne copy of this │ │ │ │ │ -0004a660: 4c69 6365 6e73 652c 2061 6e64 0a20 2020 License, and. │ │ │ │ │ -0004a670: 2020 6d75 6c74 6970 6c65 2069 6465 6e74 multiple ident │ │ │ │ │ -0004a680: 6963 616c 2049 6e76 6172 6961 6e74 2053 ical Invariant S │ │ │ │ │ -0004a690: 6563 7469 6f6e 7320 6d61 7920 6265 2072 ections may be r │ │ │ │ │ -0004a6a0: 6570 6c61 6365 6420 7769 7468 2061 2073 eplaced with a s │ │ │ │ │ -0004a6b0: 696e 676c 650a 2020 2020 2063 6f70 792e ingle. copy. │ │ │ │ │ -0004a6c0: 2020 4966 2074 6865 7265 2061 7265 206d If there are m │ │ │ │ │ -0004a6d0: 756c 7469 706c 6520 496e 7661 7269 616e ultiple Invarian │ │ │ │ │ -0004a6e0: 7420 5365 6374 696f 6e73 2077 6974 6820 t Sections with │ │ │ │ │ -0004a6f0: 7468 6520 7361 6d65 206e 616d 650a 2020 the same name. │ │ │ │ │ -0004a700: 2020 2062 7574 2064 6966 6665 7265 6e74 but different │ │ │ │ │ -0004a710: 2063 6f6e 7465 6e74 732c 206d 616b 6520 contents, make │ │ │ │ │ -0004a720: 7468 6520 7469 746c 6520 6f66 2065 6163 the title of eac │ │ │ │ │ -0004a730: 6820 7375 6368 2073 6563 7469 6f6e 2075 h such section u │ │ │ │ │ -0004a740: 6e69 7175 650a 2020 2020 2062 7920 6164 nique. by ad │ │ │ │ │ -0004a750: 6469 6e67 2061 7420 7468 6520 656e 6420 ding at the end │ │ │ │ │ -0004a760: 6f66 2069 742c 2069 6e20 7061 7265 6e74 of it, in parent │ │ │ │ │ -0004a770: 6865 7365 732c 2074 6865 206e 616d 6520 heses, the name │ │ │ │ │ -0004a780: 6f66 2074 6865 0a20 2020 2020 6f72 6967 of the. orig │ │ │ │ │ -0004a790: 696e 616c 2061 7574 686f 7220 6f72 2070 inal author or p │ │ │ │ │ -0004a7a0: 7562 6c69 7368 6572 206f 6620 7468 6174 ublisher of that │ │ │ │ │ -0004a7b0: 2073 6563 7469 6f6e 2069 6620 6b6e 6f77 section if know │ │ │ │ │ -0004a7c0: 6e2c 206f 7220 656c 7365 2061 0a20 2020 n, or else a. │ │ │ │ │ -0004a7d0: 2020 756e 6971 7565 206e 756d 6265 722e unique number. │ │ │ │ │ -0004a7e0: 2020 4d61 6b65 2074 6865 2073 616d 6520 Make the same │ │ │ │ │ -0004a7f0: 6164 6a75 7374 6d65 6e74 2074 6f20 7468 adjustment to th │ │ │ │ │ -0004a800: 6520 7365 6374 696f 6e20 7469 746c 6573 e section titles │ │ │ │ │ -0004a810: 2069 6e0a 2020 2020 2074 6865 206c 6973 in. the lis │ │ │ │ │ -0004a820: 7420 6f66 2049 6e76 6172 6961 6e74 2053 t of Invariant S │ │ │ │ │ -0004a830: 6563 7469 6f6e 7320 696e 2074 6865 206c ections in the l │ │ │ │ │ -0004a840: 6963 656e 7365 206e 6f74 6963 6520 6f66 icense notice of │ │ │ │ │ -0004a850: 2074 6865 0a20 2020 2020 636f 6d62 696e the. combin │ │ │ │ │ -0004a860: 6564 2077 6f72 6b2e 0a0a 2020 2020 2049 ed work... I │ │ │ │ │ -0004a870: 6e20 7468 6520 636f 6d62 696e 6174 696f n the combinatio │ │ │ │ │ -0004a880: 6e2c 2079 6f75 206d 7573 7420 636f 6d62 n, you must comb │ │ │ │ │ -0004a890: 696e 6520 616e 7920 7365 6374 696f 6e73 ine any sections │ │ │ │ │ -0004a8a0: 2045 6e74 6974 6c65 640a 2020 2020 2022 Entitled. " │ │ │ │ │ -0004a8b0: 4869 7374 6f72 7922 2069 6e20 7468 6520 History" in the │ │ │ │ │ -0004a8c0: 7661 7269 6f75 7320 6f72 6967 696e 616c various original │ │ │ │ │ -0004a8d0: 2064 6f63 756d 656e 7473 2c20 666f 726d documents, form │ │ │ │ │ -0004a8e0: 696e 6720 6f6e 6520 7365 6374 696f 6e0a ing one section. │ │ │ │ │ -0004a8f0: 2020 2020 2045 6e74 6974 6c65 6420 2248 Entitled "H │ │ │ │ │ -0004a900: 6973 746f 7279 223b 206c 696b 6577 6973 istory"; likewis │ │ │ │ │ -0004a910: 6520 636f 6d62 696e 6520 616e 7920 7365 e combine any se │ │ │ │ │ -0004a920: 6374 696f 6e73 2045 6e74 6974 6c65 640a ctions Entitled. │ │ │ │ │ -0004a930: 2020 2020 2022 4163 6b6e 6f77 6c65 6467 "Acknowledg │ │ │ │ │ -0004a940: 656d 656e 7473 222c 2061 6e64 2061 6e79 ements", and any │ │ │ │ │ -0004a950: 2073 6563 7469 6f6e 7320 456e 7469 746c sections Entitl │ │ │ │ │ -0004a960: 6564 2022 4465 6469 6361 7469 6f6e 7322 ed "Dedications" │ │ │ │ │ -0004a970: 2e20 2059 6f75 0a20 2020 2020 6d75 7374 . You. must │ │ │ │ │ -0004a980: 2064 656c 6574 6520 616c 6c20 7365 6374 delete all sect │ │ │ │ │ -0004a990: 696f 6e73 2045 6e74 6974 6c65 6420 2245 ions Entitled "E │ │ │ │ │ -0004a9a0: 6e64 6f72 7365 6d65 6e74 732e 220a 0a20 ndorsements.".. │ │ │ │ │ -0004a9b0: 2036 2e20 434f 4c4c 4543 5449 4f4e 5320 6. COLLECTIONS │ │ │ │ │ -0004a9c0: 4f46 2044 4f43 554d 454e 5453 0a0a 2020 OF DOCUMENTS.. │ │ │ │ │ -0004a9d0: 2020 2059 6f75 206d 6179 206d 616b 6520 You may make │ │ │ │ │ -0004a9e0: 6120 636f 6c6c 6563 7469 6f6e 2063 6f6e a collection con │ │ │ │ │ -0004a9f0: 7369 7374 696e 6720 6f66 2074 6865 2044 sisting of the D │ │ │ │ │ -0004aa00: 6f63 756d 656e 7420 616e 6420 6f74 6865 ocument and othe │ │ │ │ │ -0004aa10: 720a 2020 2020 2064 6f63 756d 656e 7473 r. documents │ │ │ │ │ -0004aa20: 2072 656c 6561 7365 6420 756e 6465 7220 released under │ │ │ │ │ -0004aa30: 7468 6973 204c 6963 656e 7365 2c20 616e this License, an │ │ │ │ │ -0004aa40: 6420 7265 706c 6163 6520 7468 6520 696e d replace the in │ │ │ │ │ -0004aa50: 6469 7669 6475 616c 0a20 2020 2020 636f dividual. co │ │ │ │ │ -0004aa60: 7069 6573 206f 6620 7468 6973 204c 6963 pies of this Lic │ │ │ │ │ -0004aa70: 656e 7365 2069 6e20 7468 6520 7661 7269 ense in the vari │ │ │ │ │ -0004aa80: 6f75 7320 646f 6375 6d65 6e74 7320 7769 ous documents wi │ │ │ │ │ -0004aa90: 7468 2061 2073 696e 676c 6520 636f 7079 th a single copy │ │ │ │ │ -0004aaa0: 0a20 2020 2020 7468 6174 2069 7320 696e . that is in │ │ │ │ │ -0004aab0: 636c 7564 6564 2069 6e20 7468 6520 636f cluded in the co │ │ │ │ │ -0004aac0: 6c6c 6563 7469 6f6e 2c20 7072 6f76 6964 llection, provid │ │ │ │ │ -0004aad0: 6564 2074 6861 7420 796f 7520 666f 6c6c ed that you foll │ │ │ │ │ -0004aae0: 6f77 2074 6865 0a20 2020 2020 7275 6c65 ow the. rule │ │ │ │ │ -0004aaf0: 7320 6f66 2074 6869 7320 4c69 6365 6e73 s of this Licens │ │ │ │ │ -0004ab00: 6520 666f 7220 7665 7262 6174 696d 2063 e for verbatim c │ │ │ │ │ -0004ab10: 6f70 7969 6e67 206f 6620 6561 6368 206f opying of each o │ │ │ │ │ -0004ab20: 6620 7468 6520 646f 6375 6d65 6e74 730a f the documents. │ │ │ │ │ -0004ab30: 2020 2020 2069 6e20 616c 6c20 6f74 6865 in all othe │ │ │ │ │ -0004ab40: 7220 7265 7370 6563 7473 2e0a 0a20 2020 r respects... │ │ │ │ │ -0004ab50: 2020 596f 7520 6d61 7920 6578 7472 6163 You may extrac │ │ │ │ │ -0004ab60: 7420 6120 7369 6e67 6c65 2064 6f63 756d t a single docum │ │ │ │ │ -0004ab70: 656e 7420 6672 6f6d 2073 7563 6820 6120 ent from such a │ │ │ │ │ -0004ab80: 636f 6c6c 6563 7469 6f6e 2c20 616e 640a collection, and. │ │ │ │ │ -0004ab90: 2020 2020 2064 6973 7472 6962 7574 6520 distribute │ │ │ │ │ -0004aba0: 6974 2069 6e64 6976 6964 7561 6c6c 7920 it individually │ │ │ │ │ -0004abb0: 756e 6465 7220 7468 6973 204c 6963 656e under this Licen │ │ │ │ │ -0004abc0: 7365 2c20 7072 6f76 6964 6564 2079 6f75 se, provided you │ │ │ │ │ -0004abd0: 2069 6e73 6572 740a 2020 2020 2061 2063 insert. a c │ │ │ │ │ -0004abe0: 6f70 7920 6f66 2074 6869 7320 4c69 6365 opy of this Lice │ │ │ │ │ -0004abf0: 6e73 6520 696e 746f 2074 6865 2065 7874 nse into the ext │ │ │ │ │ -0004ac00: 7261 6374 6564 2064 6f63 756d 656e 742c racted document, │ │ │ │ │ -0004ac10: 2061 6e64 2066 6f6c 6c6f 7720 7468 6973 and follow this │ │ │ │ │ -0004ac20: 0a20 2020 2020 4c69 6365 6e73 6520 696e . License in │ │ │ │ │ -0004ac30: 2061 6c6c 206f 7468 6572 2072 6573 7065 all other respe │ │ │ │ │ -0004ac40: 6374 7320 7265 6761 7264 696e 6720 7665 cts regarding ve │ │ │ │ │ -0004ac50: 7262 6174 696d 2063 6f70 7969 6e67 206f rbatim copying o │ │ │ │ │ -0004ac60: 6620 7468 6174 0a20 2020 2020 646f 6375 f that. docu │ │ │ │ │ -0004ac70: 6d65 6e74 2e0a 0a20 2037 2e20 4147 4752 ment... 7. AGGR │ │ │ │ │ -0004ac80: 4547 4154 494f 4e20 5749 5448 2049 4e44 EGATION WITH IND │ │ │ │ │ -0004ac90: 4550 454e 4445 4e54 2057 4f52 4b53 0a0a EPENDENT WORKS.. │ │ │ │ │ -0004aca0: 2020 2020 2041 2063 6f6d 7069 6c61 7469 A compilati │ │ │ │ │ -0004acb0: 6f6e 206f 6620 7468 6520 446f 6375 6d65 on of the Docume │ │ │ │ │ -0004acc0: 6e74 206f 7220 6974 7320 6465 7269 7661 nt or its deriva │ │ │ │ │ -0004acd0: 7469 7665 7320 7769 7468 206f 7468 6572 tives with other │ │ │ │ │ -0004ace0: 0a20 2020 2020 7365 7061 7261 7465 2061 . separate a │ │ │ │ │ -0004acf0: 6e64 2069 6e64 6570 656e 6465 6e74 2064 nd independent d │ │ │ │ │ -0004ad00: 6f63 756d 656e 7473 206f 7220 776f 726b ocuments or work │ │ │ │ │ -0004ad10: 732c 2069 6e20 6f72 206f 6e20 6120 766f s, in or on a vo │ │ │ │ │ -0004ad20: 6c75 6d65 206f 6620 610a 2020 2020 2073 lume of a. s │ │ │ │ │ -0004ad30: 746f 7261 6765 206f 7220 6469 7374 7269 torage or distri │ │ │ │ │ -0004ad40: 6275 7469 6f6e 206d 6564 6975 6d2c 2069 bution medium, i │ │ │ │ │ -0004ad50: 7320 6361 6c6c 6564 2061 6e20 2261 6767 s called an "agg │ │ │ │ │ -0004ad60: 7265 6761 7465 2220 6966 2074 6865 0a20 regate" if the. │ │ │ │ │ -0004ad70: 2020 2020 636f 7079 7269 6768 7420 7265 copyright re │ │ │ │ │ -0004ad80: 7375 6c74 696e 6720 6672 6f6d 2074 6865 sulting from the │ │ │ │ │ -0004ad90: 2063 6f6d 7069 6c61 7469 6f6e 2069 7320 compilation is │ │ │ │ │ -0004ada0: 6e6f 7420 7573 6564 2074 6f20 6c69 6d69 not used to limi │ │ │ │ │ -0004adb0: 7420 7468 650a 2020 2020 206c 6567 616c t the. legal │ │ │ │ │ -0004adc0: 2072 6967 6874 7320 6f66 2074 6865 2063 rights of the c │ │ │ │ │ -0004add0: 6f6d 7069 6c61 7469 6f6e 2773 2075 7365 ompilation's use │ │ │ │ │ -0004ade0: 7273 2062 6579 6f6e 6420 7768 6174 2074 rs beyond what t │ │ │ │ │ -0004adf0: 6865 2069 6e64 6976 6964 7561 6c0a 2020 he individual. │ │ │ │ │ -0004ae00: 2020 2077 6f72 6b73 2070 6572 6d69 742e works permit. │ │ │ │ │ -0004ae10: 2020 5768 656e 2074 6865 2044 6f63 756d When the Docum │ │ │ │ │ -0004ae20: 656e 7420 6973 2069 6e63 6c75 6465 6420 ent is included │ │ │ │ │ -0004ae30: 696e 2061 6e20 6167 6772 6567 6174 652c in an aggregate, │ │ │ │ │ -0004ae40: 2074 6869 730a 2020 2020 204c 6963 656e this. Licen │ │ │ │ │ -0004ae50: 7365 2064 6f65 7320 6e6f 7420 6170 706c se does not appl │ │ │ │ │ -0004ae60: 7920 746f 2074 6865 206f 7468 6572 2077 y to the other w │ │ │ │ │ -0004ae70: 6f72 6b73 2069 6e20 7468 6520 6167 6772 orks in the aggr │ │ │ │ │ -0004ae80: 6567 6174 6520 7768 6963 680a 2020 2020 egate which. │ │ │ │ │ -0004ae90: 2061 7265 206e 6f74 2074 6865 6d73 656c are not themsel │ │ │ │ │ -0004aea0: 7665 7320 6465 7269 7661 7469 7665 2077 ves derivative w │ │ │ │ │ -0004aeb0: 6f72 6b73 206f 6620 7468 6520 446f 6375 orks of the Docu │ │ │ │ │ -0004aec0: 6d65 6e74 2e0a 0a20 2020 2020 4966 2074 ment... If t │ │ │ │ │ -0004aed0: 6865 2043 6f76 6572 2054 6578 7420 7265 he Cover Text re │ │ │ │ │ -0004aee0: 7175 6972 656d 656e 7420 6f66 2073 6563 quirement of sec │ │ │ │ │ -0004aef0: 7469 6f6e 2033 2069 7320 6170 706c 6963 tion 3 is applic │ │ │ │ │ -0004af00: 6162 6c65 2074 6f20 7468 6573 650a 2020 able to these. │ │ │ │ │ -0004af10: 2020 2063 6f70 6965 7320 6f66 2074 6865 copies of the │ │ │ │ │ -0004af20: 2044 6f63 756d 656e 742c 2074 6865 6e20 Document, then │ │ │ │ │ -0004af30: 6966 2074 6865 2044 6f63 756d 656e 7420 if the Document │ │ │ │ │ -0004af40: 6973 206c 6573 7320 7468 616e 206f 6e65 is less than one │ │ │ │ │ -0004af50: 2068 616c 660a 2020 2020 206f 6620 7468 half. of th │ │ │ │ │ -0004af60: 6520 656e 7469 7265 2061 6767 7265 6761 e entire aggrega │ │ │ │ │ -0004af70: 7465 2c20 7468 6520 446f 6375 6d65 6e74 te, the Document │ │ │ │ │ -0004af80: 2773 2043 6f76 6572 2054 6578 7473 206d 's Cover Texts m │ │ │ │ │ -0004af90: 6179 2062 6520 706c 6163 6564 0a20 2020 ay be placed. │ │ │ │ │ -0004afa0: 2020 6f6e 2063 6f76 6572 7320 7468 6174 on covers that │ │ │ │ │ -0004afb0: 2062 7261 636b 6574 2074 6865 2044 6f63 bracket the Doc │ │ │ │ │ -0004afc0: 756d 656e 7420 7769 7468 696e 2074 6865 ument within the │ │ │ │ │ -0004afd0: 2061 6767 7265 6761 7465 2c20 6f72 2074 aggregate, or t │ │ │ │ │ -0004afe0: 6865 0a20 2020 2020 656c 6563 7472 6f6e he. electron │ │ │ │ │ -0004aff0: 6963 2065 7175 6976 616c 656e 7420 6f66 ic equivalent of │ │ │ │ │ -0004b000: 2063 6f76 6572 7320 6966 2074 6865 2044 covers if the D │ │ │ │ │ -0004b010: 6f63 756d 656e 7420 6973 2069 6e20 656c ocument is in el │ │ │ │ │ -0004b020: 6563 7472 6f6e 6963 0a20 2020 2020 666f ectronic. fo │ │ │ │ │ -0004b030: 726d 2e20 204f 7468 6572 7769 7365 2074 rm. Otherwise t │ │ │ │ │ -0004b040: 6865 7920 6d75 7374 2061 7070 6561 7220 hey must appear │ │ │ │ │ -0004b050: 6f6e 2070 7269 6e74 6564 2063 6f76 6572 on printed cover │ │ │ │ │ -0004b060: 7320 7468 6174 2062 7261 636b 6574 0a20 s that bracket. │ │ │ │ │ -0004b070: 2020 2020 7468 6520 7768 6f6c 6520 6167 the whole ag │ │ │ │ │ -0004b080: 6772 6567 6174 652e 0a0a 2020 382e 2054 gregate... 8. T │ │ │ │ │ -0004b090: 5241 4e53 4c41 5449 4f4e 0a0a 2020 2020 RANSLATION.. │ │ │ │ │ -0004b0a0: 2054 7261 6e73 6c61 7469 6f6e 2069 7320 Translation is │ │ │ │ │ -0004b0b0: 636f 6e73 6964 6572 6564 2061 206b 696e considered a kin │ │ │ │ │ -0004b0c0: 6420 6f66 206d 6f64 6966 6963 6174 696f d of modificatio │ │ │ │ │ -0004b0d0: 6e2c 2073 6f20 796f 7520 6d61 790a 2020 n, so you may. │ │ │ │ │ -0004b0e0: 2020 2064 6973 7472 6962 7574 6520 7472 distribute tr │ │ │ │ │ -0004b0f0: 616e 736c 6174 696f 6e73 206f 6620 7468 anslations of th │ │ │ │ │ -0004b100: 6520 446f 6375 6d65 6e74 2075 6e64 6572 e Document under │ │ │ │ │ -0004b110: 2074 6865 2074 6572 6d73 206f 6620 7365 the terms of se │ │ │ │ │ -0004b120: 6374 696f 6e0a 2020 2020 2034 2e20 2052 ction. 4. R │ │ │ │ │ -0004b130: 6570 6c61 6369 6e67 2049 6e76 6172 6961 eplacing Invaria │ │ │ │ │ -0004b140: 6e74 2053 6563 7469 6f6e 7320 7769 7468 nt Sections with │ │ │ │ │ -0004b150: 2074 7261 6e73 6c61 7469 6f6e 7320 7265 translations re │ │ │ │ │ -0004b160: 7175 6972 6573 2073 7065 6369 616c 0a20 quires special. │ │ │ │ │ -0004b170: 2020 2020 7065 726d 6973 7369 6f6e 2066 permission f │ │ │ │ │ -0004b180: 726f 6d20 7468 6569 7220 636f 7079 7269 rom their copyri │ │ │ │ │ -0004b190: 6768 7420 686f 6c64 6572 732c 2062 7574 ght holders, but │ │ │ │ │ -0004b1a0: 2079 6f75 206d 6179 2069 6e63 6c75 6465 you may include │ │ │ │ │ -0004b1b0: 0a20 2020 2020 7472 616e 736c 6174 696f . translatio │ │ │ │ │ -0004b1c0: 6e73 206f 6620 736f 6d65 206f 7220 616c ns of some or al │ │ │ │ │ -0004b1d0: 6c20 496e 7661 7269 616e 7420 5365 6374 l Invariant Sect │ │ │ │ │ -0004b1e0: 696f 6e73 2069 6e20 6164 6469 7469 6f6e ions in addition │ │ │ │ │ -0004b1f0: 2074 6f20 7468 650a 2020 2020 206f 7269 to the. ori │ │ │ │ │ -0004b200: 6769 6e61 6c20 7665 7273 696f 6e73 206f ginal versions o │ │ │ │ │ -0004b210: 6620 7468 6573 6520 496e 7661 7269 616e f these Invarian │ │ │ │ │ -0004b220: 7420 5365 6374 696f 6e73 2e20 2059 6f75 t Sections. You │ │ │ │ │ -0004b230: 206d 6179 2069 6e63 6c75 6465 2061 0a20 may include a. │ │ │ │ │ -0004b240: 2020 2020 7472 616e 736c 6174 696f 6e20 translation │ │ │ │ │ -0004b250: 6f66 2074 6869 7320 4c69 6365 6e73 652c of this License, │ │ │ │ │ -0004b260: 2061 6e64 2061 6c6c 2074 6865 206c 6963 and all the lic │ │ │ │ │ -0004b270: 656e 7365 206e 6f74 6963 6573 2069 6e20 ense notices in │ │ │ │ │ -0004b280: 7468 650a 2020 2020 2044 6f63 756d 656e the. Documen │ │ │ │ │ -0004b290: 742c 2061 6e64 2061 6e79 2057 6172 7261 t, and any Warra │ │ │ │ │ -0004b2a0: 6e74 7920 4469 7363 6c61 696d 6572 732c nty Disclaimers, │ │ │ │ │ -0004b2b0: 2070 726f 7669 6465 6420 7468 6174 2079 provided that y │ │ │ │ │ -0004b2c0: 6f75 2061 6c73 6f0a 2020 2020 2069 6e63 ou also. inc │ │ │ │ │ -0004b2d0: 6c75 6465 2074 6865 206f 7269 6769 6e61 lude the origina │ │ │ │ │ -0004b2e0: 6c20 456e 676c 6973 6820 7665 7273 696f l English versio │ │ │ │ │ -0004b2f0: 6e20 6f66 2074 6869 7320 4c69 6365 6e73 n of this Licens │ │ │ │ │ -0004b300: 6520 616e 6420 7468 650a 2020 2020 206f e and the. o │ │ │ │ │ -0004b310: 7269 6769 6e61 6c20 7665 7273 696f 6e73 riginal versions │ │ │ │ │ -0004b320: 206f 6620 7468 6f73 6520 6e6f 7469 6365 of those notice │ │ │ │ │ -0004b330: 7320 616e 6420 6469 7363 6c61 696d 6572 s and disclaimer │ │ │ │ │ -0004b340: 732e 2020 496e 2063 6173 6520 6f66 2061 s. In case of a │ │ │ │ │ -0004b350: 0a20 2020 2020 6469 7361 6772 6565 6d65 . disagreeme │ │ │ │ │ -0004b360: 6e74 2062 6574 7765 656e 2074 6865 2074 nt between the t │ │ │ │ │ -0004b370: 7261 6e73 6c61 7469 6f6e 2061 6e64 2074 ranslation and t │ │ │ │ │ -0004b380: 6865 206f 7269 6769 6e61 6c20 7665 7273 he original vers │ │ │ │ │ -0004b390: 696f 6e20 6f66 0a20 2020 2020 7468 6973 ion of. this │ │ │ │ │ -0004b3a0: 204c 6963 656e 7365 206f 7220 6120 6e6f License or a no │ │ │ │ │ -0004b3b0: 7469 6365 206f 7220 6469 7363 6c61 696d tice or disclaim │ │ │ │ │ -0004b3c0: 6572 2c20 7468 6520 6f72 6967 696e 616c er, the original │ │ │ │ │ -0004b3d0: 2076 6572 7369 6f6e 2077 696c 6c0a 2020 version will. │ │ │ │ │ -0004b3e0: 2020 2070 7265 7661 696c 2e0a 0a20 2020 prevail... │ │ │ │ │ -0004b3f0: 2020 4966 2061 2073 6563 7469 6f6e 2069 If a section i │ │ │ │ │ -0004b400: 6e20 7468 6520 446f 6375 6d65 6e74 2069 n the Document i │ │ │ │ │ -0004b410: 7320 456e 7469 746c 6564 2022 4163 6b6e s Entitled "Ackn │ │ │ │ │ -0004b420: 6f77 6c65 6467 656d 656e 7473 222c 0a20 owledgements",. │ │ │ │ │ -0004b430: 2020 2020 2244 6564 6963 6174 696f 6e73 "Dedications │ │ │ │ │ -0004b440: 222c 206f 7220 2248 6973 746f 7279 222c ", or "History", │ │ │ │ │ -0004b450: 2074 6865 2072 6571 7569 7265 6d65 6e74 the requirement │ │ │ │ │ -0004b460: 2028 7365 6374 696f 6e20 3429 2074 6f0a (section 4) to. │ │ │ │ │ -0004b470: 2020 2020 2050 7265 7365 7276 6520 6974 Preserve it │ │ │ │ │ -0004b480: 7320 5469 746c 6520 2873 6563 7469 6f6e s Title (section │ │ │ │ │ -0004b490: 2031 2920 7769 6c6c 2074 7970 6963 616c 1) will typical │ │ │ │ │ -0004b4a0: 6c79 2072 6571 7569 7265 2063 6861 6e67 ly require chang │ │ │ │ │ -0004b4b0: 696e 6720 7468 650a 2020 2020 2061 6374 ing the. act │ │ │ │ │ -0004b4c0: 7561 6c20 7469 746c 652e 0a0a 2020 392e ual title... 9. │ │ │ │ │ -0004b4d0: 2054 4552 4d49 4e41 5449 4f4e 0a0a 2020 TERMINATION.. │ │ │ │ │ -0004b4e0: 2020 2059 6f75 206d 6179 206e 6f74 2063 You may not c │ │ │ │ │ -0004b4f0: 6f70 792c 206d 6f64 6966 792c 2073 7562 opy, modify, sub │ │ │ │ │ -0004b500: 6c69 6365 6e73 652c 206f 7220 6469 7374 license, or dist │ │ │ │ │ -0004b510: 7269 6275 7465 2074 6865 2044 6f63 756d ribute the Docum │ │ │ │ │ -0004b520: 656e 740a 2020 2020 2065 7863 6570 7420 ent. except │ │ │ │ │ -0004b530: 6173 2065 7870 7265 7373 6c79 2070 726f as expressly pro │ │ │ │ │ -0004b540: 7669 6465 6420 666f 7220 756e 6465 7220 vided for under │ │ │ │ │ -0004b550: 7468 6973 204c 6963 656e 7365 2e20 2041 this License. A │ │ │ │ │ -0004b560: 6e79 206f 7468 6572 0a20 2020 2020 6174 ny other. at │ │ │ │ │ -0004b570: 7465 6d70 7420 746f 2063 6f70 792c 206d tempt to copy, m │ │ │ │ │ -0004b580: 6f64 6966 792c 2073 7562 6c69 6365 6e73 odify, sublicens │ │ │ │ │ -0004b590: 6520 6f72 2064 6973 7472 6962 7574 6520 e or distribute │ │ │ │ │ -0004b5a0: 7468 6520 446f 6375 6d65 6e74 2069 730a the Document is. │ │ │ │ │ -0004b5b0: 2020 2020 2076 6f69 642c 2061 6e64 2077 void, and w │ │ │ │ │ -0004b5c0: 696c 6c20 6175 746f 6d61 7469 6361 6c6c ill automaticall │ │ │ │ │ -0004b5d0: 7920 7465 726d 696e 6174 6520 796f 7572 y terminate your │ │ │ │ │ -0004b5e0: 2072 6967 6874 7320 756e 6465 7220 7468 rights under th │ │ │ │ │ -0004b5f0: 6973 0a20 2020 2020 4c69 6365 6e73 652e is. License. │ │ │ │ │ -0004b600: 2020 486f 7765 7665 722c 2070 6172 7469 However, parti │ │ │ │ │ -0004b610: 6573 2077 686f 2068 6176 6520 7265 6365 es who have rece │ │ │ │ │ -0004b620: 6976 6564 2063 6f70 6965 732c 206f 7220 ived copies, or │ │ │ │ │ -0004b630: 7269 6768 7473 2c0a 2020 2020 2066 726f rights,. fro │ │ │ │ │ -0004b640: 6d20 796f 7520 756e 6465 7220 7468 6973 m you under this │ │ │ │ │ -0004b650: 204c 6963 656e 7365 2077 696c 6c20 6e6f License will no │ │ │ │ │ -0004b660: 7420 6861 7665 2074 6865 6972 206c 6963 t have their lic │ │ │ │ │ -0004b670: 656e 7365 7320 7465 726d 696e 6174 6564 enses terminated │ │ │ │ │ -0004b680: 0a20 2020 2020 736f 206c 6f6e 6720 6173 . so long as │ │ │ │ │ -0004b690: 2073 7563 6820 7061 7274 6965 7320 7265 such parties re │ │ │ │ │ -0004b6a0: 6d61 696e 2069 6e20 6675 6c6c 2063 6f6d main in full com │ │ │ │ │ -0004b6b0: 706c 6961 6e63 652e 0a0a 2020 3130 2e20 pliance... 10. │ │ │ │ │ -0004b6c0: 4655 5455 5245 2052 4556 4953 494f 4e53 FUTURE REVISIONS │ │ │ │ │ -0004b6d0: 204f 4620 5448 4953 204c 4943 454e 5345 OF THIS LICENSE │ │ │ │ │ -0004b6e0: 0a0a 2020 2020 2054 6865 2046 7265 6520 .. The Free │ │ │ │ │ -0004b6f0: 536f 6674 7761 7265 2046 6f75 6e64 6174 Software Foundat │ │ │ │ │ -0004b700: 696f 6e20 6d61 7920 7075 626c 6973 6820 ion may publish │ │ │ │ │ -0004b710: 6e65 772c 2072 6576 6973 6564 2076 6572 new, revised ver │ │ │ │ │ -0004b720: 7369 6f6e 7320 6f66 0a20 2020 2020 7468 sions of. th │ │ │ │ │ -0004b730: 6520 474e 5520 4672 6565 2044 6f63 756d e GNU Free Docum │ │ │ │ │ -0004b740: 656e 7461 7469 6f6e 204c 6963 656e 7365 entation License │ │ │ │ │ -0004b750: 2066 726f 6d20 7469 6d65 2074 6f20 7469 from time to ti │ │ │ │ │ -0004b760: 6d65 2e20 2053 7563 6820 6e65 770a 2020 me. Such new. │ │ │ │ │ -0004b770: 2020 2076 6572 7369 6f6e 7320 7769 6c6c versions will │ │ │ │ │ -0004b780: 2062 6520 7369 6d69 6c61 7220 696e 2073 be similar in s │ │ │ │ │ -0004b790: 7069 7269 7420 746f 2074 6865 2070 7265 pirit to the pre │ │ │ │ │ -0004b7a0: 7365 6e74 2076 6572 7369 6f6e 2c20 6275 sent version, bu │ │ │ │ │ -0004b7b0: 7420 6d61 790a 2020 2020 2064 6966 6665 t may. diffe │ │ │ │ │ -0004b7c0: 7220 696e 2064 6574 6169 6c20 746f 2061 r in detail to a │ │ │ │ │ -0004b7d0: 6464 7265 7373 206e 6577 2070 726f 626c ddress new probl │ │ │ │ │ -0004b7e0: 656d 7320 6f72 2063 6f6e 6365 726e 732e ems or concerns. │ │ │ │ │ -0004b7f0: 2020 5365 650a 2020 2020 203c 6874 7470 See. ... │ │ │ │ │ -0004b820: 2045 6163 6820 7665 7273 696f 6e20 6f66 Each version of │ │ │ │ │ -0004b830: 2074 6865 204c 6963 656e 7365 2069 7320 the License is │ │ │ │ │ -0004b840: 6769 7665 6e20 6120 6469 7374 696e 6775 given a distingu │ │ │ │ │ -0004b850: 6973 6869 6e67 2076 6572 7369 6f6e 0a20 ishing version. │ │ │ │ │ -0004b860: 2020 2020 6e75 6d62 6572 2e20 2049 6620 number. If │ │ │ │ │ -0004b870: 7468 6520 446f 6375 6d65 6e74 2073 7065 the Document spe │ │ │ │ │ -0004b880: 6369 6669 6573 2074 6861 7420 6120 7061 cifies that a pa │ │ │ │ │ -0004b890: 7274 6963 756c 6172 206e 756d 6265 7265 rticular numbere │ │ │ │ │ -0004b8a0: 640a 2020 2020 2076 6572 7369 6f6e 206f d. version o │ │ │ │ │ -0004b8b0: 6620 7468 6973 204c 6963 656e 7365 2022 f this License " │ │ │ │ │ -0004b8c0: 6f72 2061 6e79 206c 6174 6572 2076 6572 or any later ver │ │ │ │ │ -0004b8d0: 7369 6f6e 2220 6170 706c 6965 7320 746f sion" applies to │ │ │ │ │ -0004b8e0: 2069 742c 2079 6f75 0a20 2020 2020 6861 it, you. ha │ │ │ │ │ -0004b8f0: 7665 2074 6865 206f 7074 696f 6e20 6f66 ve the option of │ │ │ │ │ -0004b900: 2066 6f6c 6c6f 7769 6e67 2074 6865 2074 following the t │ │ │ │ │ -0004b910: 6572 6d73 2061 6e64 2063 6f6e 6469 7469 erms and conditi │ │ │ │ │ -0004b920: 6f6e 7320 6569 7468 6572 206f 660a 2020 ons either of. │ │ │ │ │ -0004b930: 2020 2074 6861 7420 7370 6563 6966 6965 that specifie │ │ │ │ │ -0004b940: 6420 7665 7273 696f 6e20 6f72 206f 6620 d version or of │ │ │ │ │ -0004b950: 616e 7920 6c61 7465 7220 7665 7273 696f any later versio │ │ │ │ │ -0004b960: 6e20 7468 6174 2068 6173 2062 6565 6e0a n that has been. │ │ │ │ │ -0004b970: 2020 2020 2070 7562 6c69 7368 6564 2028 published ( │ │ │ │ │ -0004b980: 6e6f 7420 6173 2061 2064 7261 6674 2920 not as a draft) │ │ │ │ │ -0004b990: 6279 2074 6865 2046 7265 6520 536f 6674 by the Free Soft │ │ │ │ │ -0004b9a0: 7761 7265 2046 6f75 6e64 6174 696f 6e2e ware Foundation. │ │ │ │ │ -0004b9b0: 2020 4966 2074 6865 0a20 2020 2020 446f If the. Do │ │ │ │ │ -0004b9c0: 6375 6d65 6e74 2064 6f65 7320 6e6f 7420 cument does not │ │ │ │ │ -0004b9d0: 7370 6563 6966 7920 6120 7665 7273 696f specify a versio │ │ │ │ │ -0004b9e0: 6e20 6e75 6d62 6572 206f 6620 7468 6973 n number of this │ │ │ │ │ -0004b9f0: 204c 6963 656e 7365 2c20 796f 7520 6d61 License, you ma │ │ │ │ │ -0004ba00: 790a 2020 2020 2063 686f 6f73 6520 616e y. choose an │ │ │ │ │ -0004ba10: 7920 7665 7273 696f 6e20 6576 6572 2070 y version ever p │ │ │ │ │ -0004ba20: 7562 6c69 7368 6564 2028 6e6f 7420 6173 ublished (not as │ │ │ │ │ -0004ba30: 2061 2064 7261 6674 2920 6279 2074 6865 a draft) by the │ │ │ │ │ -0004ba40: 2046 7265 650a 2020 2020 2053 6f66 7477 Free. Softw │ │ │ │ │ -0004ba50: 6172 6520 466f 756e 6461 7469 6f6e 2e0a are Foundation.. │ │ │ │ │ -0004ba60: 0a44 2e31 2e31 2041 4444 454e 4455 4d3a .D.1.1 ADDENDUM: │ │ │ │ │ -0004ba70: 2048 6f77 2074 6f20 7573 6520 7468 6973 How to use this │ │ │ │ │ -0004ba80: 204c 6963 656e 7365 2066 6f72 2079 6f75 License for you │ │ │ │ │ -0004ba90: 7220 646f 6375 6d65 6e74 730a 2d2d 2d2d r documents.---- │ │ │ │ │ +00046910: 3d3d 3d0a 0a20 2020 2020 2020 2020 2020 ===.. │ │ │ │ │ +00046920: 2020 2020 2020 2020 2020 2056 6572 7369 Versi │ │ │ │ │ +00046930: 6f6e 2031 2e32 2c20 4e6f 7665 6d62 6572 on 1.2, November │ │ │ │ │ +00046940: 2032 3030 320a 0a20 2020 2020 436f 7079 2002.. Copy │ │ │ │ │ +00046950: 7269 6768 7420 2843 2920 3230 3030 2c32 right (C) 2000,2 │ │ │ │ │ +00046960: 3030 312c 3230 3032 2046 7265 6520 536f 001,2002 Free So │ │ │ │ │ +00046970: 6674 7761 7265 2046 6f75 6e64 6174 696f ftware Foundatio │ │ │ │ │ +00046980: 6e2c 2049 6e63 2e0a 2020 2020 2035 3120 n, Inc.. 51 │ │ │ │ │ +00046990: 4672 616e 6b6c 696e 2053 742c 2046 6966 Franklin St, Fif │ │ │ │ │ +000469a0: 7468 2046 6c6f 6f72 2c20 426f 7374 6f6e th Floor, Boston │ │ │ │ │ +000469b0: 2c20 4d41 2020 3032 3131 302d 3133 3031 , MA 02110-1301 │ │ │ │ │ +000469c0: 2c20 5553 410a 0a20 2020 2020 4576 6572 , USA.. Ever │ │ │ │ │ +000469d0: 796f 6e65 2069 7320 7065 726d 6974 7465 yone is permitte │ │ │ │ │ +000469e0: 6420 746f 2063 6f70 7920 616e 6420 6469 d to copy and di │ │ │ │ │ +000469f0: 7374 7269 6275 7465 2076 6572 6261 7469 stribute verbati │ │ │ │ │ +00046a00: 6d20 636f 7069 6573 0a20 2020 2020 6f66 m copies. of │ │ │ │ │ +00046a10: 2074 6869 7320 6c69 6365 6e73 6520 646f this license do │ │ │ │ │ +00046a20: 6375 6d65 6e74 2c20 6275 7420 6368 616e cument, but chan │ │ │ │ │ +00046a30: 6769 6e67 2069 7420 6973 206e 6f74 2061 ging it is not a │ │ │ │ │ +00046a40: 6c6c 6f77 6564 2e0a 0a20 2030 2e20 5052 llowed... 0. PR │ │ │ │ │ +00046a50: 4541 4d42 4c45 0a0a 2020 2020 2054 6865 EAMBLE.. The │ │ │ │ │ +00046a60: 2070 7572 706f 7365 206f 6620 7468 6973 purpose of this │ │ │ │ │ +00046a70: 204c 6963 656e 7365 2069 7320 746f 206d License is to m │ │ │ │ │ +00046a80: 616b 6520 6120 6d61 6e75 616c 2c20 7465 ake a manual, te │ │ │ │ │ +00046a90: 7874 626f 6f6b 2c20 6f72 206f 7468 6572 xtbook, or other │ │ │ │ │ +00046aa0: 0a20 2020 2020 6675 6e63 7469 6f6e 616c . functional │ │ │ │ │ +00046ab0: 2061 6e64 2075 7365 6675 6c20 646f 6375 and useful docu │ │ │ │ │ +00046ac0: 6d65 6e74 2022 6672 6565 2220 696e 2074 ment "free" in t │ │ │ │ │ +00046ad0: 6865 2073 656e 7365 206f 6620 6672 6565 he sense of free │ │ │ │ │ +00046ae0: 646f 6d3a 2074 6f0a 2020 2020 2061 7373 dom: to. ass │ │ │ │ │ +00046af0: 7572 6520 6576 6572 796f 6e65 2074 6865 ure everyone the │ │ │ │ │ +00046b00: 2065 6666 6563 7469 7665 2066 7265 6564 effective freed │ │ │ │ │ +00046b10: 6f6d 2074 6f20 636f 7079 2061 6e64 2072 om to copy and r │ │ │ │ │ +00046b20: 6564 6973 7472 6962 7574 6520 6974 2c0a edistribute it,. │ │ │ │ │ +00046b30: 2020 2020 2077 6974 6820 6f72 2077 6974 with or wit │ │ │ │ │ +00046b40: 686f 7574 206d 6f64 6966 7969 6e67 2069 hout modifying i │ │ │ │ │ +00046b50: 742c 2065 6974 6865 7220 636f 6d6d 6572 t, either commer │ │ │ │ │ +00046b60: 6369 616c 6c79 206f 720a 2020 2020 206e cially or. n │ │ │ │ │ +00046b70: 6f6e 636f 6d6d 6572 6369 616c 6c79 2e20 oncommercially. │ │ │ │ │ +00046b80: 2053 6563 6f6e 6461 7269 6c79 2c20 7468 Secondarily, th │ │ │ │ │ +00046b90: 6973 204c 6963 656e 7365 2070 7265 7365 is License prese │ │ │ │ │ +00046ba0: 7276 6573 2066 6f72 2074 6865 0a20 2020 rves for the. │ │ │ │ │ +00046bb0: 2020 6175 7468 6f72 2061 6e64 2070 7562 author and pub │ │ │ │ │ +00046bc0: 6c69 7368 6572 2061 2077 6179 2074 6f20 lisher a way to │ │ │ │ │ +00046bd0: 6765 7420 6372 6564 6974 2066 6f72 2074 get credit for t │ │ │ │ │ +00046be0: 6865 6972 2077 6f72 6b2c 2077 6869 6c65 heir work, while │ │ │ │ │ +00046bf0: 206e 6f74 0a20 2020 2020 6265 696e 6720 not. being │ │ │ │ │ +00046c00: 636f 6e73 6964 6572 6564 2072 6573 706f considered respo │ │ │ │ │ +00046c10: 6e73 6962 6c65 2066 6f72 206d 6f64 6966 nsible for modif │ │ │ │ │ +00046c20: 6963 6174 696f 6e73 206d 6164 6520 6279 ications made by │ │ │ │ │ +00046c30: 206f 7468 6572 732e 0a0a 2020 2020 2054 others... T │ │ │ │ │ +00046c40: 6869 7320 4c69 6365 6e73 6520 6973 2061 his License is a │ │ │ │ │ +00046c50: 206b 696e 6420 6f66 2022 636f 7079 6c65 kind of "copyle │ │ │ │ │ +00046c60: 6674 222c 2077 6869 6368 206d 6561 6e73 ft", which means │ │ │ │ │ +00046c70: 2074 6861 7420 6465 7269 7661 7469 7665 that derivative │ │ │ │ │ +00046c80: 0a20 2020 2020 776f 726b 7320 6f66 2074 . works of t │ │ │ │ │ +00046c90: 6865 2064 6f63 756d 656e 7420 6d75 7374 he document must │ │ │ │ │ +00046ca0: 2074 6865 6d73 656c 7665 7320 6265 2066 themselves be f │ │ │ │ │ +00046cb0: 7265 6520 696e 2074 6865 2073 616d 6520 ree in the same │ │ │ │ │ +00046cc0: 7365 6e73 652e 0a20 2020 2020 4974 2063 sense.. It c │ │ │ │ │ +00046cd0: 6f6d 706c 656d 656e 7473 2074 6865 2047 omplements the G │ │ │ │ │ +00046ce0: 4e55 2047 656e 6572 616c 2050 7562 6c69 NU General Publi │ │ │ │ │ +00046cf0: 6320 4c69 6365 6e73 652c 2077 6869 6368 c License, which │ │ │ │ │ +00046d00: 2069 7320 6120 636f 7079 6c65 6674 0a20 is a copyleft. │ │ │ │ │ +00046d10: 2020 2020 6c69 6365 6e73 6520 6465 7369 license desi │ │ │ │ │ +00046d20: 676e 6564 2066 6f72 2066 7265 6520 736f gned for free so │ │ │ │ │ +00046d30: 6674 7761 7265 2e0a 0a20 2020 2020 5765 ftware... We │ │ │ │ │ +00046d40: 2068 6176 6520 6465 7369 676e 6564 2074 have designed t │ │ │ │ │ +00046d50: 6869 7320 4c69 6365 6e73 6520 696e 206f his License in o │ │ │ │ │ +00046d60: 7264 6572 2074 6f20 7573 6520 6974 2066 rder to use it f │ │ │ │ │ +00046d70: 6f72 206d 616e 7561 6c73 2066 6f72 0a20 or manuals for. │ │ │ │ │ +00046d80: 2020 2020 6672 6565 2073 6f66 7477 6172 free softwar │ │ │ │ │ +00046d90: 652c 2062 6563 6175 7365 2066 7265 6520 e, because free │ │ │ │ │ +00046da0: 736f 6674 7761 7265 206e 6565 6473 2066 software needs f │ │ │ │ │ +00046db0: 7265 6520 646f 6375 6d65 6e74 6174 696f ree documentatio │ │ │ │ │ +00046dc0: 6e3a 2061 0a20 2020 2020 6672 6565 2070 n: a. free p │ │ │ │ │ +00046dd0: 726f 6772 616d 2073 686f 756c 6420 636f rogram should co │ │ │ │ │ +00046de0: 6d65 2077 6974 6820 6d61 6e75 616c 7320 me with manuals │ │ │ │ │ +00046df0: 7072 6f76 6964 696e 6720 7468 6520 7361 providing the sa │ │ │ │ │ +00046e00: 6d65 2066 7265 6564 6f6d 730a 2020 2020 me freedoms. │ │ │ │ │ +00046e10: 2074 6861 7420 7468 6520 736f 6674 7761 that the softwa │ │ │ │ │ +00046e20: 7265 2064 6f65 732e 2020 4275 7420 7468 re does. But th │ │ │ │ │ +00046e30: 6973 204c 6963 656e 7365 2069 7320 6e6f is License is no │ │ │ │ │ +00046e40: 7420 6c69 6d69 7465 6420 746f 0a20 2020 t limited to. │ │ │ │ │ +00046e50: 2020 736f 6674 7761 7265 206d 616e 7561 software manua │ │ │ │ │ +00046e60: 6c73 3b20 6974 2063 616e 2062 6520 7573 ls; it can be us │ │ │ │ │ +00046e70: 6564 2066 6f72 2061 6e79 2074 6578 7475 ed for any textu │ │ │ │ │ +00046e80: 616c 2077 6f72 6b2c 2072 6567 6172 646c al work, regardl │ │ │ │ │ +00046e90: 6573 730a 2020 2020 206f 6620 7375 626a ess. of subj │ │ │ │ │ +00046ea0: 6563 7420 6d61 7474 6572 206f 7220 7768 ect matter or wh │ │ │ │ │ +00046eb0: 6574 6865 7220 6974 2069 7320 7075 626c ether it is publ │ │ │ │ │ +00046ec0: 6973 6865 6420 6173 2061 2070 7269 6e74 ished as a print │ │ │ │ │ +00046ed0: 6564 2062 6f6f 6b2e 2020 5765 0a20 2020 ed book. We. │ │ │ │ │ +00046ee0: 2020 7265 636f 6d6d 656e 6420 7468 6973 recommend this │ │ │ │ │ +00046ef0: 204c 6963 656e 7365 2070 7269 6e63 6970 License princip │ │ │ │ │ +00046f00: 616c 6c79 2066 6f72 2077 6f72 6b73 2077 ally for works w │ │ │ │ │ +00046f10: 686f 7365 2070 7572 706f 7365 2069 730a hose purpose is. │ │ │ │ │ +00046f20: 2020 2020 2069 6e73 7472 7563 7469 6f6e instruction │ │ │ │ │ +00046f30: 206f 7220 7265 6665 7265 6e63 652e 0a0a or reference... │ │ │ │ │ +00046f40: 2020 312e 2041 5050 4c49 4341 4249 4c49 1. APPLICABILI │ │ │ │ │ +00046f50: 5459 2041 4e44 2044 4546 494e 4954 494f TY AND DEFINITIO │ │ │ │ │ +00046f60: 4e53 0a0a 2020 2020 2054 6869 7320 4c69 NS.. This Li │ │ │ │ │ +00046f70: 6365 6e73 6520 6170 706c 6965 7320 746f cense applies to │ │ │ │ │ +00046f80: 2061 6e79 206d 616e 7561 6c20 6f72 206f any manual or o │ │ │ │ │ +00046f90: 7468 6572 2077 6f72 6b2c 2069 6e20 616e ther work, in an │ │ │ │ │ +00046fa0: 7920 6d65 6469 756d 2c0a 2020 2020 2074 y medium,. t │ │ │ │ │ +00046fb0: 6861 7420 636f 6e74 6169 6e73 2061 206e hat contains a n │ │ │ │ │ +00046fc0: 6f74 6963 6520 706c 6163 6564 2062 7920 otice placed by │ │ │ │ │ +00046fd0: 7468 6520 636f 7079 7269 6768 7420 686f the copyright ho │ │ │ │ │ +00046fe0: 6c64 6572 2073 6179 696e 6720 6974 2063 lder saying it c │ │ │ │ │ +00046ff0: 616e 0a20 2020 2020 6265 2064 6973 7472 an. be distr │ │ │ │ │ +00047000: 6962 7574 6564 2075 6e64 6572 2074 6865 ibuted under the │ │ │ │ │ +00047010: 2074 6572 6d73 206f 6620 7468 6973 204c terms of this L │ │ │ │ │ +00047020: 6963 656e 7365 2e20 2053 7563 6820 6120 icense. Such a │ │ │ │ │ +00047030: 6e6f 7469 6365 0a20 2020 2020 6772 616e notice. gran │ │ │ │ │ +00047040: 7473 2061 2077 6f72 6c64 2d77 6964 652c ts a world-wide, │ │ │ │ │ +00047050: 2072 6f79 616c 7479 2d66 7265 6520 6c69 royalty-free li │ │ │ │ │ +00047060: 6365 6e73 652c 2075 6e6c 696d 6974 6564 cense, unlimited │ │ │ │ │ +00047070: 2069 6e20 6475 7261 7469 6f6e 2c0a 2020 in duration,. │ │ │ │ │ +00047080: 2020 2074 6f20 7573 6520 7468 6174 2077 to use that w │ │ │ │ │ +00047090: 6f72 6b20 756e 6465 7220 7468 6520 636f ork under the co │ │ │ │ │ +000470a0: 6e64 6974 696f 6e73 2073 7461 7465 6420 nditions stated │ │ │ │ │ +000470b0: 6865 7265 696e 2e20 2054 6865 0a20 2020 herein. The. │ │ │ │ │ +000470c0: 2020 2244 6f63 756d 656e 7422 2c20 6265 "Document", be │ │ │ │ │ +000470d0: 6c6f 772c 2072 6566 6572 7320 746f 2061 low, refers to a │ │ │ │ │ +000470e0: 6e79 2073 7563 6820 6d61 6e75 616c 206f ny such manual o │ │ │ │ │ +000470f0: 7220 776f 726b 2e20 2041 6e79 206d 656d r work. Any mem │ │ │ │ │ +00047100: 6265 720a 2020 2020 206f 6620 7468 6520 ber. of the │ │ │ │ │ +00047110: 7075 626c 6963 2069 7320 6120 6c69 6365 public is a lice │ │ │ │ │ +00047120: 6e73 6565 2c20 616e 6420 6973 2061 6464 nsee, and is add │ │ │ │ │ +00047130: 7265 7373 6564 2061 7320 2279 6f75 222e ressed as "you". │ │ │ │ │ +00047140: 2020 596f 7520 6163 6365 7074 0a20 2020 You accept. │ │ │ │ │ +00047150: 2020 7468 6520 6c69 6365 6e73 6520 6966 the license if │ │ │ │ │ +00047160: 2079 6f75 2063 6f70 792c 206d 6f64 6966 you copy, modif │ │ │ │ │ +00047170: 7920 6f72 2064 6973 7472 6962 7574 6520 y or distribute │ │ │ │ │ +00047180: 7468 6520 776f 726b 2069 6e20 6120 7761 the work in a wa │ │ │ │ │ +00047190: 790a 2020 2020 2072 6571 7569 7269 6e67 y. requiring │ │ │ │ │ +000471a0: 2070 6572 6d69 7373 696f 6e20 756e 6465 permission unde │ │ │ │ │ +000471b0: 7220 636f 7079 7269 6768 7420 6c61 772e r copyright law. │ │ │ │ │ +000471c0: 0a0a 2020 2020 2041 2022 4d6f 6469 6669 .. A "Modifi │ │ │ │ │ +000471d0: 6564 2056 6572 7369 6f6e 2220 6f66 2074 ed Version" of t │ │ │ │ │ +000471e0: 6865 2044 6f63 756d 656e 7420 6d65 616e he Document mean │ │ │ │ │ +000471f0: 7320 616e 7920 776f 726b 2063 6f6e 7461 s any work conta │ │ │ │ │ +00047200: 696e 696e 6720 7468 650a 2020 2020 2044 ining the. D │ │ │ │ │ +00047210: 6f63 756d 656e 7420 6f72 2061 2070 6f72 ocument or a por │ │ │ │ │ +00047220: 7469 6f6e 206f 6620 6974 2c20 6569 7468 tion of it, eith │ │ │ │ │ +00047230: 6572 2063 6f70 6965 6420 7665 7262 6174 er copied verbat │ │ │ │ │ +00047240: 696d 2c20 6f72 2077 6974 680a 2020 2020 im, or with. │ │ │ │ │ +00047250: 206d 6f64 6966 6963 6174 696f 6e73 2061 modifications a │ │ │ │ │ +00047260: 6e64 2f6f 7220 7472 616e 736c 6174 6564 nd/or translated │ │ │ │ │ +00047270: 2069 6e74 6f20 616e 6f74 6865 7220 6c61 into another la │ │ │ │ │ +00047280: 6e67 7561 6765 2e0a 0a20 2020 2020 4120 nguage... A │ │ │ │ │ +00047290: 2253 6563 6f6e 6461 7279 2053 6563 7469 "Secondary Secti │ │ │ │ │ +000472a0: 6f6e 2220 6973 2061 206e 616d 6564 2061 on" is a named a │ │ │ │ │ +000472b0: 7070 656e 6469 7820 6f72 2061 2066 726f ppendix or a fro │ │ │ │ │ +000472c0: 6e74 2d6d 6174 7465 7220 7365 6374 696f nt-matter sectio │ │ │ │ │ +000472d0: 6e0a 2020 2020 206f 6620 7468 6520 446f n. of the Do │ │ │ │ │ +000472e0: 6375 6d65 6e74 2074 6861 7420 6465 616c cument that deal │ │ │ │ │ +000472f0: 7320 6578 636c 7573 6976 656c 7920 7769 s exclusively wi │ │ │ │ │ +00047300: 7468 2074 6865 2072 656c 6174 696f 6e73 th the relations │ │ │ │ │ +00047310: 6869 7020 6f66 2074 6865 0a20 2020 2020 hip of the. │ │ │ │ │ +00047320: 7075 626c 6973 6865 7273 206f 7220 6175 publishers or au │ │ │ │ │ +00047330: 7468 6f72 7320 6f66 2074 6865 2044 6f63 thors of the Doc │ │ │ │ │ +00047340: 756d 656e 7420 746f 2074 6865 2044 6f63 ument to the Doc │ │ │ │ │ +00047350: 756d 656e 7427 7320 6f76 6572 616c 6c0a ument's overall. │ │ │ │ │ +00047360: 2020 2020 2073 7562 6a65 6374 2028 6f72 subject (or │ │ │ │ │ +00047370: 2074 6f20 7265 6c61 7465 6420 6d61 7474 to related matt │ │ │ │ │ +00047380: 6572 7329 2061 6e64 2063 6f6e 7461 696e ers) and contain │ │ │ │ │ +00047390: 7320 6e6f 7468 696e 6720 7468 6174 2063 s nothing that c │ │ │ │ │ +000473a0: 6f75 6c64 0a20 2020 2020 6661 6c6c 2064 ould. fall d │ │ │ │ │ +000473b0: 6972 6563 746c 7920 7769 7468 696e 2074 irectly within t │ │ │ │ │ +000473c0: 6861 7420 6f76 6572 616c 6c20 7375 626a hat overall subj │ │ │ │ │ +000473d0: 6563 742e 2020 2854 6875 732c 2069 6620 ect. (Thus, if │ │ │ │ │ +000473e0: 7468 6520 446f 6375 6d65 6e74 0a20 2020 the Document. │ │ │ │ │ +000473f0: 2020 6973 2069 6e20 7061 7274 2061 2074 is in part a t │ │ │ │ │ +00047400: 6578 7462 6f6f 6b20 6f66 206d 6174 6865 extbook of mathe │ │ │ │ │ +00047410: 6d61 7469 6373 2c20 6120 5365 636f 6e64 matics, a Second │ │ │ │ │ +00047420: 6172 7920 5365 6374 696f 6e20 6d61 7920 ary Section may │ │ │ │ │ +00047430: 6e6f 740a 2020 2020 2065 7870 6c61 696e not. explain │ │ │ │ │ +00047440: 2061 6e79 206d 6174 6865 6d61 7469 6373 any mathematics │ │ │ │ │ +00047450: 2e29 2020 5468 6520 7265 6c61 7469 6f6e .) The relation │ │ │ │ │ +00047460: 7368 6970 2063 6f75 6c64 2062 6520 6120 ship could be a │ │ │ │ │ +00047470: 6d61 7474 6572 206f 660a 2020 2020 2068 matter of. h │ │ │ │ │ +00047480: 6973 746f 7269 6361 6c20 636f 6e6e 6563 istorical connec │ │ │ │ │ +00047490: 7469 6f6e 2077 6974 6820 7468 6520 7375 tion with the su │ │ │ │ │ +000474a0: 626a 6563 7420 6f72 2077 6974 6820 7265 bject or with re │ │ │ │ │ +000474b0: 6c61 7465 6420 6d61 7474 6572 732c 206f lated matters, o │ │ │ │ │ +000474c0: 720a 2020 2020 206f 6620 6c65 6761 6c2c r. of legal, │ │ │ │ │ +000474d0: 2063 6f6d 6d65 7263 6961 6c2c 2070 6869 commercial, phi │ │ │ │ │ +000474e0: 6c6f 736f 7068 6963 616c 2c20 6574 6869 losophical, ethi │ │ │ │ │ +000474f0: 6361 6c20 6f72 2070 6f6c 6974 6963 616c cal or political │ │ │ │ │ +00047500: 2070 6f73 6974 696f 6e0a 2020 2020 2072 position. r │ │ │ │ │ +00047510: 6567 6172 6469 6e67 2074 6865 6d2e 0a0a egarding them... │ │ │ │ │ +00047520: 2020 2020 2054 6865 2022 496e 7661 7269 The "Invari │ │ │ │ │ +00047530: 616e 7420 5365 6374 696f 6e73 2220 6172 ant Sections" ar │ │ │ │ │ +00047540: 6520 6365 7274 6169 6e20 5365 636f 6e64 e certain Second │ │ │ │ │ +00047550: 6172 7920 5365 6374 696f 6e73 2077 686f ary Sections who │ │ │ │ │ +00047560: 7365 0a20 2020 2020 7469 746c 6573 2061 se. titles a │ │ │ │ │ +00047570: 7265 2064 6573 6967 6e61 7465 642c 2061 re designated, a │ │ │ │ │ +00047580: 7320 6265 696e 6720 7468 6f73 6520 6f66 s being those of │ │ │ │ │ +00047590: 2049 6e76 6172 6961 6e74 2053 6563 7469 Invariant Secti │ │ │ │ │ +000475a0: 6f6e 732c 2069 6e20 7468 650a 2020 2020 ons, in the. │ │ │ │ │ +000475b0: 206e 6f74 6963 6520 7468 6174 2073 6179 notice that say │ │ │ │ │ +000475c0: 7320 7468 6174 2074 6865 2044 6f63 756d s that the Docum │ │ │ │ │ +000475d0: 656e 7420 6973 2072 656c 6561 7365 6420 ent is released │ │ │ │ │ +000475e0: 756e 6465 7220 7468 6973 204c 6963 656e under this Licen │ │ │ │ │ +000475f0: 7365 2e0a 2020 2020 2049 6620 6120 7365 se.. If a se │ │ │ │ │ +00047600: 6374 696f 6e20 646f 6573 206e 6f74 2066 ction does not f │ │ │ │ │ +00047610: 6974 2074 6865 2061 626f 7665 2064 6566 it the above def │ │ │ │ │ +00047620: 696e 6974 696f 6e20 6f66 2053 6563 6f6e inition of Secon │ │ │ │ │ +00047630: 6461 7279 2074 6865 6e20 6974 0a20 2020 dary then it. │ │ │ │ │ +00047640: 2020 6973 206e 6f74 2061 6c6c 6f77 6564 is not allowed │ │ │ │ │ +00047650: 2074 6f20 6265 2064 6573 6967 6e61 7465 to be designate │ │ │ │ │ +00047660: 6420 6173 2049 6e76 6172 6961 6e74 2e20 d as Invariant. │ │ │ │ │ +00047670: 2054 6865 2044 6f63 756d 656e 7420 6d61 The Document ma │ │ │ │ │ +00047680: 790a 2020 2020 2063 6f6e 7461 696e 207a y. contain z │ │ │ │ │ +00047690: 6572 6f20 496e 7661 7269 616e 7420 5365 ero Invariant Se │ │ │ │ │ +000476a0: 6374 696f 6e73 2e20 2049 6620 7468 6520 ctions. If the │ │ │ │ │ +000476b0: 446f 6375 6d65 6e74 2064 6f65 7320 6e6f Document does no │ │ │ │ │ +000476c0: 7420 6964 656e 7469 6679 0a20 2020 2020 t identify. │ │ │ │ │ +000476d0: 616e 7920 496e 7661 7269 616e 7420 5365 any Invariant Se │ │ │ │ │ +000476e0: 6374 696f 6e73 2074 6865 6e20 7468 6572 ctions then ther │ │ │ │ │ +000476f0: 6520 6172 6520 6e6f 6e65 2e0a 0a20 2020 e are none... │ │ │ │ │ +00047700: 2020 5468 6520 2243 6f76 6572 2054 6578 The "Cover Tex │ │ │ │ │ +00047710: 7473 2220 6172 6520 6365 7274 6169 6e20 ts" are certain │ │ │ │ │ +00047720: 7368 6f72 7420 7061 7373 6167 6573 206f short passages o │ │ │ │ │ +00047730: 6620 7465 7874 2074 6861 7420 6172 650a f text that are. │ │ │ │ │ +00047740: 2020 2020 206c 6973 7465 642c 2061 7320 listed, as │ │ │ │ │ +00047750: 4672 6f6e 742d 436f 7665 7220 5465 7874 Front-Cover Text │ │ │ │ │ +00047760: 7320 6f72 2042 6163 6b2d 436f 7665 7220 s or Back-Cover │ │ │ │ │ +00047770: 5465 7874 732c 2069 6e20 7468 6520 6e6f Texts, in the no │ │ │ │ │ +00047780: 7469 6365 0a20 2020 2020 7468 6174 2073 tice. that s │ │ │ │ │ +00047790: 6179 7320 7468 6174 2074 6865 2044 6f63 ays that the Doc │ │ │ │ │ +000477a0: 756d 656e 7420 6973 2072 656c 6561 7365 ument is release │ │ │ │ │ +000477b0: 6420 756e 6465 7220 7468 6973 204c 6963 d under this Lic │ │ │ │ │ +000477c0: 656e 7365 2e20 2041 0a20 2020 2020 4672 ense. A. Fr │ │ │ │ │ +000477d0: 6f6e 742d 436f 7665 7220 5465 7874 206d ont-Cover Text m │ │ │ │ │ +000477e0: 6179 2062 6520 6174 206d 6f73 7420 3520 ay be at most 5 │ │ │ │ │ +000477f0: 776f 7264 732c 2061 6e64 2061 2042 6163 words, and a Bac │ │ │ │ │ +00047800: 6b2d 436f 7665 7220 5465 7874 206d 6179 k-Cover Text may │ │ │ │ │ +00047810: 0a20 2020 2020 6265 2061 7420 6d6f 7374 . be at most │ │ │ │ │ +00047820: 2032 3520 776f 7264 732e 0a0a 2020 2020 25 words... │ │ │ │ │ +00047830: 2041 2022 5472 616e 7370 6172 656e 7422 A "Transparent" │ │ │ │ │ +00047840: 2063 6f70 7920 6f66 2074 6865 2044 6f63 copy of the Doc │ │ │ │ │ +00047850: 756d 656e 7420 6d65 616e 7320 6120 6d61 ument means a ma │ │ │ │ │ +00047860: 6368 696e 652d 7265 6164 6162 6c65 2063 chine-readable c │ │ │ │ │ +00047870: 6f70 792c 0a20 2020 2020 7265 7072 6573 opy,. repres │ │ │ │ │ +00047880: 656e 7465 6420 696e 2061 2066 6f72 6d61 ented in a forma │ │ │ │ │ +00047890: 7420 7768 6f73 6520 7370 6563 6966 6963 t whose specific │ │ │ │ │ +000478a0: 6174 696f 6e20 6973 2061 7661 696c 6162 ation is availab │ │ │ │ │ +000478b0: 6c65 2074 6f20 7468 650a 2020 2020 2067 le to the. g │ │ │ │ │ +000478c0: 656e 6572 616c 2070 7562 6c69 632c 2074 eneral public, t │ │ │ │ │ +000478d0: 6861 7420 6973 2073 7569 7461 626c 6520 hat is suitable │ │ │ │ │ +000478e0: 666f 7220 7265 7669 7369 6e67 2074 6865 for revising the │ │ │ │ │ +000478f0: 2064 6f63 756d 656e 740a 2020 2020 2073 document. s │ │ │ │ │ +00047900: 7472 6169 6768 7466 6f72 7761 7264 6c79 traightforwardly │ │ │ │ │ +00047910: 2077 6974 6820 6765 6e65 7269 6320 7465 with generic te │ │ │ │ │ +00047920: 7874 2065 6469 746f 7273 206f 7220 2866 xt editors or (f │ │ │ │ │ +00047930: 6f72 2069 6d61 6765 7320 636f 6d70 6f73 or images compos │ │ │ │ │ +00047940: 6564 0a20 2020 2020 6f66 2070 6978 656c ed. of pixel │ │ │ │ │ +00047950: 7329 2067 656e 6572 6963 2070 6169 6e74 s) generic paint │ │ │ │ │ +00047960: 2070 726f 6772 616d 7320 6f72 2028 666f programs or (fo │ │ │ │ │ +00047970: 7220 6472 6177 696e 6773 2920 736f 6d65 r drawings) some │ │ │ │ │ +00047980: 2077 6964 656c 790a 2020 2020 2061 7661 widely. ava │ │ │ │ │ +00047990: 696c 6162 6c65 2064 7261 7769 6e67 2065 ilable drawing e │ │ │ │ │ +000479a0: 6469 746f 722c 2061 6e64 2074 6861 7420 ditor, and that │ │ │ │ │ +000479b0: 6973 2073 7569 7461 626c 6520 666f 7220 is suitable for │ │ │ │ │ +000479c0: 696e 7075 7420 746f 2074 6578 740a 2020 input to text. │ │ │ │ │ +000479d0: 2020 2066 6f72 6d61 7474 6572 7320 6f72 formatters or │ │ │ │ │ +000479e0: 2066 6f72 2061 7574 6f6d 6174 6963 2074 for automatic t │ │ │ │ │ +000479f0: 7261 6e73 6c61 7469 6f6e 2074 6f20 6120 ranslation to a │ │ │ │ │ +00047a00: 7661 7269 6574 7920 6f66 2066 6f72 6d61 variety of forma │ │ │ │ │ +00047a10: 7473 0a20 2020 2020 7375 6974 6162 6c65 ts. suitable │ │ │ │ │ +00047a20: 2066 6f72 2069 6e70 7574 2074 6f20 7465 for input to te │ │ │ │ │ +00047a30: 7874 2066 6f72 6d61 7474 6572 732e 2020 xt formatters. │ │ │ │ │ +00047a40: 4120 636f 7079 206d 6164 6520 696e 2061 A copy made in a │ │ │ │ │ +00047a50: 6e20 6f74 6865 7277 6973 650a 2020 2020 n otherwise. │ │ │ │ │ +00047a60: 2054 7261 6e73 7061 7265 6e74 2066 696c Transparent fil │ │ │ │ │ +00047a70: 6520 666f 726d 6174 2077 686f 7365 206d e format whose m │ │ │ │ │ +00047a80: 6172 6b75 702c 206f 7220 6162 7365 6e63 arkup, or absenc │ │ │ │ │ +00047a90: 6520 6f66 206d 6172 6b75 702c 2068 6173 e of markup, has │ │ │ │ │ +00047aa0: 0a20 2020 2020 6265 656e 2061 7272 616e . been arran │ │ │ │ │ +00047ab0: 6765 6420 746f 2074 6877 6172 7420 6f72 ged to thwart or │ │ │ │ │ +00047ac0: 2064 6973 636f 7572 6167 6520 7375 6273 discourage subs │ │ │ │ │ +00047ad0: 6571 7565 6e74 206d 6f64 6966 6963 6174 equent modificat │ │ │ │ │ +00047ae0: 696f 6e20 6279 0a20 2020 2020 7265 6164 ion by. read │ │ │ │ │ +00047af0: 6572 7320 6973 206e 6f74 2054 7261 6e73 ers is not Trans │ │ │ │ │ +00047b00: 7061 7265 6e74 2e20 2041 6e20 696d 6167 parent. An imag │ │ │ │ │ +00047b10: 6520 666f 726d 6174 2069 7320 6e6f 7420 e format is not │ │ │ │ │ +00047b20: 5472 616e 7370 6172 656e 7420 6966 0a20 Transparent if. │ │ │ │ │ +00047b30: 2020 2020 7573 6564 2066 6f72 2061 6e79 used for any │ │ │ │ │ +00047b40: 2073 7562 7374 616e 7469 616c 2061 6d6f substantial amo │ │ │ │ │ +00047b50: 756e 7420 6f66 2074 6578 742e 2020 4120 unt of text. A │ │ │ │ │ +00047b60: 636f 7079 2074 6861 7420 6973 206e 6f74 copy that is not │ │ │ │ │ +00047b70: 0a20 2020 2020 2254 7261 6e73 7061 7265 . "Transpare │ │ │ │ │ +00047b80: 6e74 2220 6973 2063 616c 6c65 6420 224f nt" is called "O │ │ │ │ │ +00047b90: 7061 7175 6522 2e0a 0a20 2020 2020 4578 paque"... Ex │ │ │ │ │ +00047ba0: 616d 706c 6573 206f 6620 7375 6974 6162 amples of suitab │ │ │ │ │ +00047bb0: 6c65 2066 6f72 6d61 7473 2066 6f72 2054 le formats for T │ │ │ │ │ +00047bc0: 7261 6e73 7061 7265 6e74 2063 6f70 6965 ransparent copie │ │ │ │ │ +00047bd0: 7320 696e 636c 7564 6520 706c 6169 6e0a s include plain. │ │ │ │ │ +00047be0: 2020 2020 2041 5343 4949 2077 6974 686f ASCII witho │ │ │ │ │ +00047bf0: 7574 206d 6172 6b75 702c 2054 6578 696e ut markup, Texin │ │ │ │ │ +00047c00: 666f 2069 6e70 7574 2066 6f72 6d61 742c fo input format, │ │ │ │ │ +00047c10: 204c 6154 6558 2069 6e70 7574 2066 6f72 LaTeX input for │ │ │ │ │ +00047c20: 6d61 742c 0a20 2020 2020 5347 4d4c 206f mat,. SGML o │ │ │ │ │ +00047c30: 7220 584d 4c20 7573 696e 6720 6120 7075 r XML using a pu │ │ │ │ │ +00047c40: 626c 6963 6c79 2061 7661 696c 6162 6c65 blicly available │ │ │ │ │ +00047c50: 2044 5444 2c20 616e 6420 7374 616e 6461 DTD, and standa │ │ │ │ │ +00047c60: 7264 2d63 6f6e 666f 726d 696e 670a 2020 rd-conforming. │ │ │ │ │ +00047c70: 2020 2073 696d 706c 6520 4854 4d4c 2c20 simple HTML, │ │ │ │ │ +00047c80: 506f 7374 5363 7269 7074 206f 7220 5044 PostScript or PD │ │ │ │ │ +00047c90: 4620 6465 7369 676e 6564 2066 6f72 2068 F designed for h │ │ │ │ │ +00047ca0: 756d 616e 206d 6f64 6966 6963 6174 696f uman modificatio │ │ │ │ │ +00047cb0: 6e2e 0a20 2020 2020 4578 616d 706c 6573 n.. Examples │ │ │ │ │ +00047cc0: 206f 6620 7472 616e 7370 6172 656e 7420 of transparent │ │ │ │ │ +00047cd0: 696d 6167 6520 666f 726d 6174 7320 696e image formats in │ │ │ │ │ +00047ce0: 636c 7564 6520 504e 472c 2058 4346 2061 clude PNG, XCF a │ │ │ │ │ +00047cf0: 6e64 204a 5047 2e0a 2020 2020 204f 7061 nd JPG.. Opa │ │ │ │ │ +00047d00: 7175 6520 666f 726d 6174 7320 696e 636c que formats incl │ │ │ │ │ +00047d10: 7564 6520 7072 6f70 7269 6574 6172 7920 ude proprietary │ │ │ │ │ +00047d20: 666f 726d 6174 7320 7468 6174 2063 616e formats that can │ │ │ │ │ +00047d30: 2062 6520 7265 6164 2061 6e64 0a20 2020 be read and. │ │ │ │ │ +00047d40: 2020 6564 6974 6564 206f 6e6c 7920 6279 edited only by │ │ │ │ │ +00047d50: 2070 726f 7072 6965 7461 7279 2077 6f72 proprietary wor │ │ │ │ │ +00047d60: 6420 7072 6f63 6573 736f 7273 2c20 5347 d processors, SG │ │ │ │ │ +00047d70: 4d4c 206f 7220 584d 4c20 666f 7220 7768 ML or XML for wh │ │ │ │ │ +00047d80: 6963 680a 2020 2020 2074 6865 2044 5444 ich. the DTD │ │ │ │ │ +00047d90: 2061 6e64 2f6f 7220 7072 6f63 6573 7369 and/or processi │ │ │ │ │ +00047da0: 6e67 2074 6f6f 6c73 2061 7265 206e 6f74 ng tools are not │ │ │ │ │ +00047db0: 2067 656e 6572 616c 6c79 2061 7661 696c generally avail │ │ │ │ │ +00047dc0: 6162 6c65 2c20 616e 640a 2020 2020 2074 able, and. t │ │ │ │ │ +00047dd0: 6865 206d 6163 6869 6e65 2d67 656e 6572 he machine-gener │ │ │ │ │ +00047de0: 6174 6564 2048 544d 4c2c 2050 6f73 7453 ated HTML, PostS │ │ │ │ │ +00047df0: 6372 6970 7420 6f72 2050 4446 2070 726f cript or PDF pro │ │ │ │ │ +00047e00: 6475 6365 6420 6279 2073 6f6d 6520 776f duced by some wo │ │ │ │ │ +00047e10: 7264 0a20 2020 2020 7072 6f63 6573 736f rd. processo │ │ │ │ │ +00047e20: 7273 2066 6f72 206f 7574 7075 7420 7075 rs for output pu │ │ │ │ │ +00047e30: 7270 6f73 6573 206f 6e6c 792e 0a0a 2020 rposes only... │ │ │ │ │ +00047e40: 2020 2054 6865 2022 5469 746c 6520 5061 The "Title Pa │ │ │ │ │ +00047e50: 6765 2220 6d65 616e 732c 2066 6f72 2061 ge" means, for a │ │ │ │ │ +00047e60: 2070 7269 6e74 6564 2062 6f6f 6b2c 2074 printed book, t │ │ │ │ │ +00047e70: 6865 2074 6974 6c65 2070 6167 6520 6974 he title page it │ │ │ │ │ +00047e80: 7365 6c66 2c0a 2020 2020 2070 6c75 7320 self,. plus │ │ │ │ │ +00047e90: 7375 6368 2066 6f6c 6c6f 7769 6e67 2070 such following p │ │ │ │ │ +00047ea0: 6167 6573 2061 7320 6172 6520 6e65 6564 ages as are need │ │ │ │ │ +00047eb0: 6564 2074 6f20 686f 6c64 2c20 6c65 6769 ed to hold, legi │ │ │ │ │ +00047ec0: 626c 792c 2074 6865 0a20 2020 2020 6d61 bly, the. ma │ │ │ │ │ +00047ed0: 7465 7269 616c 2074 6869 7320 4c69 6365 terial this Lice │ │ │ │ │ +00047ee0: 6e73 6520 7265 7175 6972 6573 2074 6f20 nse requires to │ │ │ │ │ +00047ef0: 6170 7065 6172 2069 6e20 7468 6520 7469 appear in the ti │ │ │ │ │ +00047f00: 746c 6520 7061 6765 2e20 2046 6f72 0a20 tle page. For. │ │ │ │ │ +00047f10: 2020 2020 776f 726b 7320 696e 2066 6f72 works in for │ │ │ │ │ +00047f20: 6d61 7473 2077 6869 6368 2064 6f20 6e6f mats which do no │ │ │ │ │ +00047f30: 7420 6861 7665 2061 6e79 2074 6974 6c65 t have any title │ │ │ │ │ +00047f40: 2070 6167 6520 6173 2073 7563 682c 2022 page as such, " │ │ │ │ │ +00047f50: 5469 746c 650a 2020 2020 2050 6167 6522 Title. Page" │ │ │ │ │ +00047f60: 206d 6561 6e73 2074 6865 2074 6578 7420 means the text │ │ │ │ │ +00047f70: 6e65 6172 2074 6865 206d 6f73 7420 7072 near the most pr │ │ │ │ │ +00047f80: 6f6d 696e 656e 7420 6170 7065 6172 616e ominent appearan │ │ │ │ │ +00047f90: 6365 206f 6620 7468 650a 2020 2020 2077 ce of the. w │ │ │ │ │ +00047fa0: 6f72 6b27 7320 7469 746c 652c 2070 7265 ork's title, pre │ │ │ │ │ +00047fb0: 6365 6469 6e67 2074 6865 2062 6567 696e ceding the begin │ │ │ │ │ +00047fc0: 6e69 6e67 206f 6620 7468 6520 626f 6479 ning of the body │ │ │ │ │ +00047fd0: 206f 6620 7468 6520 7465 7874 2e0a 0a20 of the text... │ │ │ │ │ +00047fe0: 2020 2020 4120 7365 6374 696f 6e20 2245 A section "E │ │ │ │ │ +00047ff0: 6e74 6974 6c65 6420 5859 5a22 206d 6561 ntitled XYZ" mea │ │ │ │ │ +00048000: 6e73 2061 206e 616d 6564 2073 7562 756e ns a named subun │ │ │ │ │ +00048010: 6974 206f 6620 7468 6520 446f 6375 6d65 it of the Docume │ │ │ │ │ +00048020: 6e74 0a20 2020 2020 7768 6f73 6520 7469 nt. whose ti │ │ │ │ │ +00048030: 746c 6520 6569 7468 6572 2069 7320 7072 tle either is pr │ │ │ │ │ +00048040: 6563 6973 656c 7920 5859 5a20 6f72 2063 ecisely XYZ or c │ │ │ │ │ +00048050: 6f6e 7461 696e 7320 5859 5a20 696e 2070 ontains XYZ in p │ │ │ │ │ +00048060: 6172 656e 7468 6573 6573 0a20 2020 2020 arentheses. │ │ │ │ │ +00048070: 666f 6c6c 6f77 696e 6720 7465 7874 2074 following text t │ │ │ │ │ +00048080: 6861 7420 7472 616e 736c 6174 6573 2058 hat translates X │ │ │ │ │ +00048090: 595a 2069 6e20 616e 6f74 6865 7220 6c61 YZ in another la │ │ │ │ │ +000480a0: 6e67 7561 6765 2e20 2028 4865 7265 2058 nguage. (Here X │ │ │ │ │ +000480b0: 595a 0a20 2020 2020 7374 616e 6473 2066 YZ. stands f │ │ │ │ │ +000480c0: 6f72 2061 2073 7065 6369 6669 6320 7365 or a specific se │ │ │ │ │ +000480d0: 6374 696f 6e20 6e61 6d65 206d 656e 7469 ction name menti │ │ │ │ │ +000480e0: 6f6e 6564 2062 656c 6f77 2c20 7375 6368 oned below, such │ │ │ │ │ +000480f0: 2061 730a 2020 2020 2022 4163 6b6e 6f77 as. "Acknow │ │ │ │ │ +00048100: 6c65 6467 656d 656e 7473 222c 2022 4465 ledgements", "De │ │ │ │ │ +00048110: 6469 6361 7469 6f6e 7322 2c20 2245 6e64 dications", "End │ │ │ │ │ +00048120: 6f72 7365 6d65 6e74 7322 2c20 6f72 2022 orsements", or " │ │ │ │ │ +00048130: 4869 7374 6f72 7922 2e29 0a20 2020 2020 History".). │ │ │ │ │ +00048140: 546f 2022 5072 6573 6572 7665 2074 6865 To "Preserve the │ │ │ │ │ +00048150: 2054 6974 6c65 2220 6f66 2073 7563 6820 Title" of such │ │ │ │ │ +00048160: 6120 7365 6374 696f 6e20 7768 656e 2079 a section when y │ │ │ │ │ +00048170: 6f75 206d 6f64 6966 7920 7468 650a 2020 ou modify the. │ │ │ │ │ +00048180: 2020 2044 6f63 756d 656e 7420 6d65 616e Document mean │ │ │ │ │ +00048190: 7320 7468 6174 2069 7420 7265 6d61 696e s that it remain │ │ │ │ │ +000481a0: 7320 6120 7365 6374 696f 6e20 2245 6e74 s a section "Ent │ │ │ │ │ +000481b0: 6974 6c65 6420 5859 5a22 2061 6363 6f72 itled XYZ" accor │ │ │ │ │ +000481c0: 6469 6e67 0a20 2020 2020 746f 2074 6869 ding. to thi │ │ │ │ │ +000481d0: 7320 6465 6669 6e69 7469 6f6e 2e0a 0a20 s definition... │ │ │ │ │ +000481e0: 2020 2020 5468 6520 446f 6375 6d65 6e74 The Document │ │ │ │ │ +000481f0: 206d 6179 2069 6e63 6c75 6465 2057 6172 may include War │ │ │ │ │ +00048200: 7261 6e74 7920 4469 7363 6c61 696d 6572 ranty Disclaimer │ │ │ │ │ +00048210: 7320 6e65 7874 2074 6f20 7468 6520 6e6f s next to the no │ │ │ │ │ +00048220: 7469 6365 0a20 2020 2020 7768 6963 6820 tice. which │ │ │ │ │ +00048230: 7374 6174 6573 2074 6861 7420 7468 6973 states that this │ │ │ │ │ +00048240: 204c 6963 656e 7365 2061 7070 6c69 6573 License applies │ │ │ │ │ +00048250: 2074 6f20 7468 6520 446f 6375 6d65 6e74 to the Document │ │ │ │ │ +00048260: 2e20 2054 6865 7365 0a20 2020 2020 5761 . These. Wa │ │ │ │ │ +00048270: 7272 616e 7479 2044 6973 636c 6169 6d65 rranty Disclaime │ │ │ │ │ +00048280: 7273 2061 7265 2063 6f6e 7369 6465 7265 rs are considere │ │ │ │ │ +00048290: 6420 746f 2062 6520 696e 636c 7564 6564 d to be included │ │ │ │ │ +000482a0: 2062 7920 7265 6665 7265 6e63 6520 696e by reference in │ │ │ │ │ +000482b0: 0a20 2020 2020 7468 6973 204c 6963 656e . this Licen │ │ │ │ │ +000482c0: 7365 2c20 6275 7420 6f6e 6c79 2061 7320 se, but only as │ │ │ │ │ +000482d0: 7265 6761 7264 7320 6469 7363 6c61 696d regards disclaim │ │ │ │ │ +000482e0: 696e 6720 7761 7272 616e 7469 6573 3a20 ing warranties: │ │ │ │ │ +000482f0: 616e 7920 6f74 6865 720a 2020 2020 2069 any other. i │ │ │ │ │ +00048300: 6d70 6c69 6361 7469 6f6e 2074 6861 7420 mplication that │ │ │ │ │ +00048310: 7468 6573 6520 5761 7272 616e 7479 2044 these Warranty D │ │ │ │ │ +00048320: 6973 636c 6169 6d65 7273 206d 6179 2068 isclaimers may h │ │ │ │ │ +00048330: 6176 6520 6973 2076 6f69 6420 616e 640a ave is void and. │ │ │ │ │ +00048340: 2020 2020 2068 6173 206e 6f20 6566 6665 has no effe │ │ │ │ │ +00048350: 6374 206f 6e20 7468 6520 6d65 616e 696e ct on the meanin │ │ │ │ │ +00048360: 6720 6f66 2074 6869 7320 4c69 6365 6e73 g of this Licens │ │ │ │ │ +00048370: 652e 0a0a 2020 322e 2056 4552 4241 5449 e... 2. VERBATI │ │ │ │ │ +00048380: 4d20 434f 5059 494e 470a 0a20 2020 2020 M COPYING.. │ │ │ │ │ +00048390: 596f 7520 6d61 7920 636f 7079 2061 6e64 You may copy and │ │ │ │ │ +000483a0: 2064 6973 7472 6962 7574 6520 7468 6520 distribute the │ │ │ │ │ +000483b0: 446f 6375 6d65 6e74 2069 6e20 616e 7920 Document in any │ │ │ │ │ +000483c0: 6d65 6469 756d 2c20 6569 7468 6572 0a20 medium, either. │ │ │ │ │ +000483d0: 2020 2020 636f 6d6d 6572 6369 616c 6c79 commercially │ │ │ │ │ +000483e0: 206f 7220 6e6f 6e63 6f6d 6d65 7263 6961 or noncommercia │ │ │ │ │ +000483f0: 6c6c 792c 2070 726f 7669 6465 6420 7468 lly, provided th │ │ │ │ │ +00048400: 6174 2074 6869 7320 4c69 6365 6e73 652c at this License, │ │ │ │ │ +00048410: 2074 6865 0a20 2020 2020 636f 7079 7269 the. copyri │ │ │ │ │ +00048420: 6768 7420 6e6f 7469 6365 732c 2061 6e64 ght notices, and │ │ │ │ │ +00048430: 2074 6865 206c 6963 656e 7365 206e 6f74 the license not │ │ │ │ │ +00048440: 6963 6520 7361 7969 6e67 2074 6869 7320 ice saying this │ │ │ │ │ +00048450: 4c69 6365 6e73 650a 2020 2020 2061 7070 License. app │ │ │ │ │ +00048460: 6c69 6573 2074 6f20 7468 6520 446f 6375 lies to the Docu │ │ │ │ │ +00048470: 6d65 6e74 2061 7265 2072 6570 726f 6475 ment are reprodu │ │ │ │ │ +00048480: 6365 6420 696e 2061 6c6c 2063 6f70 6965 ced in all copie │ │ │ │ │ +00048490: 732c 2061 6e64 2074 6861 7420 796f 750a s, and that you. │ │ │ │ │ +000484a0: 2020 2020 2061 6464 206e 6f20 6f74 6865 add no othe │ │ │ │ │ +000484b0: 7220 636f 6e64 6974 696f 6e73 2077 6861 r conditions wha │ │ │ │ │ +000484c0: 7473 6f65 7665 7220 746f 2074 686f 7365 tsoever to those │ │ │ │ │ +000484d0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ +000484e0: 2e20 2059 6f75 0a20 2020 2020 6d61 7920 . You. may │ │ │ │ │ +000484f0: 6e6f 7420 7573 6520 7465 6368 6e69 6361 not use technica │ │ │ │ │ +00048500: 6c20 6d65 6173 7572 6573 2074 6f20 6f62 l measures to ob │ │ │ │ │ +00048510: 7374 7275 6374 206f 7220 636f 6e74 726f struct or contro │ │ │ │ │ +00048520: 6c20 7468 6520 7265 6164 696e 670a 2020 l the reading. │ │ │ │ │ +00048530: 2020 206f 7220 6675 7274 6865 7220 636f or further co │ │ │ │ │ +00048540: 7079 696e 6720 6f66 2074 6865 2063 6f70 pying of the cop │ │ │ │ │ +00048550: 6965 7320 796f 7520 6d61 6b65 206f 7220 ies you make or │ │ │ │ │ +00048560: 6469 7374 7269 6275 7465 2e20 2048 6f77 distribute. How │ │ │ │ │ +00048570: 6576 6572 2c0a 2020 2020 2079 6f75 206d ever,. you m │ │ │ │ │ +00048580: 6179 2061 6363 6570 7420 636f 6d70 656e ay accept compen │ │ │ │ │ +00048590: 7361 7469 6f6e 2069 6e20 6578 6368 616e sation in exchan │ │ │ │ │ +000485a0: 6765 2066 6f72 2063 6f70 6965 732e 2020 ge for copies. │ │ │ │ │ +000485b0: 4966 2079 6f75 0a20 2020 2020 6469 7374 If you. dist │ │ │ │ │ +000485c0: 7269 6275 7465 2061 206c 6172 6765 2065 ribute a large e │ │ │ │ │ +000485d0: 6e6f 7567 6820 6e75 6d62 6572 206f 6620 nough number of │ │ │ │ │ +000485e0: 636f 7069 6573 2079 6f75 206d 7573 7420 copies you must │ │ │ │ │ +000485f0: 616c 736f 2066 6f6c 6c6f 7720 7468 650a also follow the. │ │ │ │ │ +00048600: 2020 2020 2063 6f6e 6469 7469 6f6e 7320 conditions │ │ │ │ │ +00048610: 696e 2073 6563 7469 6f6e 2033 2e0a 0a20 in section 3... │ │ │ │ │ +00048620: 2020 2020 596f 7520 6d61 7920 616c 736f You may also │ │ │ │ │ +00048630: 206c 656e 6420 636f 7069 6573 2c20 756e lend copies, un │ │ │ │ │ +00048640: 6465 7220 7468 6520 7361 6d65 2063 6f6e der the same con │ │ │ │ │ +00048650: 6469 7469 6f6e 7320 7374 6174 6564 2061 ditions stated a │ │ │ │ │ +00048660: 626f 7665 2c0a 2020 2020 2061 6e64 2079 bove,. and y │ │ │ │ │ +00048670: 6f75 206d 6179 2070 7562 6c69 636c 7920 ou may publicly │ │ │ │ │ +00048680: 6469 7370 6c61 7920 636f 7069 6573 2e0a display copies.. │ │ │ │ │ +00048690: 0a20 2033 2e20 434f 5059 494e 4720 494e . 3. COPYING IN │ │ │ │ │ +000486a0: 2051 5541 4e54 4954 590a 0a20 2020 2020 QUANTITY.. │ │ │ │ │ +000486b0: 4966 2079 6f75 2070 7562 6c69 7368 2070 If you publish p │ │ │ │ │ +000486c0: 7269 6e74 6564 2063 6f70 6965 7320 286f rinted copies (o │ │ │ │ │ +000486d0: 7220 636f 7069 6573 2069 6e20 6d65 6469 r copies in medi │ │ │ │ │ +000486e0: 6120 7468 6174 2063 6f6d 6d6f 6e6c 790a a that commonly. │ │ │ │ │ +000486f0: 2020 2020 2068 6176 6520 7072 696e 7465 have printe │ │ │ │ │ +00048700: 6420 636f 7665 7273 2920 6f66 2074 6865 d covers) of the │ │ │ │ │ +00048710: 2044 6f63 756d 656e 742c 206e 756d 6265 Document, numbe │ │ │ │ │ +00048720: 7269 6e67 206d 6f72 6520 7468 616e 2031 ring more than 1 │ │ │ │ │ +00048730: 3030 2c20 616e 640a 2020 2020 2074 6865 00, and. the │ │ │ │ │ +00048740: 2044 6f63 756d 656e 7427 7320 6c69 6365 Document's lice │ │ │ │ │ +00048750: 6e73 6520 6e6f 7469 6365 2072 6571 7569 nse notice requi │ │ │ │ │ +00048760: 7265 7320 436f 7665 7220 5465 7874 732c res Cover Texts, │ │ │ │ │ +00048770: 2079 6f75 206d 7573 740a 2020 2020 2065 you must. e │ │ │ │ │ +00048780: 6e63 6c6f 7365 2074 6865 2063 6f70 6965 nclose the copie │ │ │ │ │ +00048790: 7320 696e 2063 6f76 6572 7320 7468 6174 s in covers that │ │ │ │ │ +000487a0: 2063 6172 7279 2c20 636c 6561 726c 7920 carry, clearly │ │ │ │ │ +000487b0: 616e 6420 6c65 6769 626c 792c 2061 6c6c and legibly, all │ │ │ │ │ +000487c0: 0a20 2020 2020 7468 6573 6520 436f 7665 . these Cove │ │ │ │ │ +000487d0: 7220 5465 7874 733a 2046 726f 6e74 2d43 r Texts: Front-C │ │ │ │ │ +000487e0: 6f76 6572 2054 6578 7473 206f 6e20 7468 over Texts on th │ │ │ │ │ +000487f0: 6520 6672 6f6e 7420 636f 7665 722c 2061 e front cover, a │ │ │ │ │ +00048800: 6e64 0a20 2020 2020 4261 636b 2d43 6f76 nd. Back-Cov │ │ │ │ │ +00048810: 6572 2054 6578 7473 206f 6e20 7468 6520 er Texts on the │ │ │ │ │ +00048820: 6261 636b 2063 6f76 6572 2e20 2042 6f74 back cover. Bot │ │ │ │ │ +00048830: 6820 636f 7665 7273 206d 7573 7420 616c h covers must al │ │ │ │ │ +00048840: 736f 2063 6c65 6172 6c79 0a20 2020 2020 so clearly. │ │ │ │ │ +00048850: 616e 6420 6c65 6769 626c 7920 6964 656e and legibly iden │ │ │ │ │ +00048860: 7469 6679 2079 6f75 2061 7320 7468 6520 tify you as the │ │ │ │ │ +00048870: 7075 626c 6973 6865 7220 6f66 2074 6865 publisher of the │ │ │ │ │ +00048880: 7365 2063 6f70 6965 732e 2020 5468 650a se copies. The. │ │ │ │ │ +00048890: 2020 2020 2066 726f 6e74 2063 6f76 6572 front cover │ │ │ │ │ +000488a0: 206d 7573 7420 7072 6573 656e 7420 7468 must present th │ │ │ │ │ +000488b0: 6520 6675 6c6c 2074 6974 6c65 2077 6974 e full title wit │ │ │ │ │ +000488c0: 6820 616c 6c20 776f 7264 7320 6f66 2074 h all words of t │ │ │ │ │ +000488d0: 6865 2074 6974 6c65 0a20 2020 2020 6571 he title. eq │ │ │ │ │ +000488e0: 7561 6c6c 7920 7072 6f6d 696e 656e 7420 ually prominent │ │ │ │ │ +000488f0: 616e 6420 7669 7369 626c 652e 2020 596f and visible. Yo │ │ │ │ │ +00048900: 7520 6d61 7920 6164 6420 6f74 6865 7220 u may add other │ │ │ │ │ +00048910: 6d61 7465 7269 616c 206f 6e20 7468 650a material on the. │ │ │ │ │ +00048920: 2020 2020 2063 6f76 6572 7320 696e 2061 covers in a │ │ │ │ │ +00048930: 6464 6974 696f 6e2e 2020 436f 7079 696e ddition. Copyin │ │ │ │ │ +00048940: 6720 7769 7468 2063 6861 6e67 6573 206c g with changes l │ │ │ │ │ +00048950: 696d 6974 6564 2074 6f20 7468 6520 636f imited to the co │ │ │ │ │ +00048960: 7665 7273 2c20 6173 0a20 2020 2020 6c6f vers, as. lo │ │ │ │ │ +00048970: 6e67 2061 7320 7468 6579 2070 7265 7365 ng as they prese │ │ │ │ │ +00048980: 7276 6520 7468 6520 7469 746c 6520 6f66 rve the title of │ │ │ │ │ +00048990: 2074 6865 2044 6f63 756d 656e 7420 616e the Document an │ │ │ │ │ +000489a0: 6420 7361 7469 7366 7920 7468 6573 650a d satisfy these. │ │ │ │ │ +000489b0: 2020 2020 2063 6f6e 6469 7469 6f6e 732c conditions, │ │ │ │ │ +000489c0: 2063 616e 2062 6520 7472 6561 7465 6420 can be treated │ │ │ │ │ +000489d0: 6173 2076 6572 6261 7469 6d20 636f 7079 as verbatim copy │ │ │ │ │ +000489e0: 696e 6720 696e 206f 7468 6572 2072 6573 ing in other res │ │ │ │ │ +000489f0: 7065 6374 732e 0a0a 2020 2020 2049 6620 pects... If │ │ │ │ │ +00048a00: 7468 6520 7265 7175 6972 6564 2074 6578 the required tex │ │ │ │ │ +00048a10: 7473 2066 6f72 2065 6974 6865 7220 636f ts for either co │ │ │ │ │ +00048a20: 7665 7220 6172 6520 746f 6f20 766f 6c75 ver are too volu │ │ │ │ │ +00048a30: 6d69 6e6f 7573 2074 6f20 6669 740a 2020 minous to fit. │ │ │ │ │ +00048a40: 2020 206c 6567 6962 6c79 2c20 796f 7520 legibly, you │ │ │ │ │ +00048a50: 7368 6f75 6c64 2070 7574 2074 6865 2066 should put the f │ │ │ │ │ +00048a60: 6972 7374 206f 6e65 7320 6c69 7374 6564 irst ones listed │ │ │ │ │ +00048a70: 2028 6173 206d 616e 7920 6173 2066 6974 (as many as fit │ │ │ │ │ +00048a80: 0a20 2020 2020 7265 6173 6f6e 6162 6c79 . reasonably │ │ │ │ │ +00048a90: 2920 6f6e 2074 6865 2061 6374 7561 6c20 ) on the actual │ │ │ │ │ +00048aa0: 636f 7665 722c 2061 6e64 2063 6f6e 7469 cover, and conti │ │ │ │ │ +00048ab0: 6e75 6520 7468 6520 7265 7374 206f 6e74 nue the rest ont │ │ │ │ │ +00048ac0: 6f0a 2020 2020 2061 646a 6163 656e 7420 o. adjacent │ │ │ │ │ +00048ad0: 7061 6765 732e 0a0a 2020 2020 2049 6620 pages... If │ │ │ │ │ +00048ae0: 796f 7520 7075 626c 6973 6820 6f72 2064 you publish or d │ │ │ │ │ +00048af0: 6973 7472 6962 7574 6520 4f70 6171 7565 istribute Opaque │ │ │ │ │ +00048b00: 2063 6f70 6965 7320 6f66 2074 6865 2044 copies of the D │ │ │ │ │ +00048b10: 6f63 756d 656e 740a 2020 2020 206e 756d ocument. num │ │ │ │ │ +00048b20: 6265 7269 6e67 206d 6f72 6520 7468 616e bering more than │ │ │ │ │ +00048b30: 2031 3030 2c20 796f 7520 6d75 7374 2065 100, you must e │ │ │ │ │ +00048b40: 6974 6865 7220 696e 636c 7564 6520 6120 ither include a │ │ │ │ │ +00048b50: 6d61 6368 696e 652d 7265 6164 6162 6c65 machine-readable │ │ │ │ │ +00048b60: 0a20 2020 2020 5472 616e 7370 6172 656e . Transparen │ │ │ │ │ +00048b70: 7420 636f 7079 2061 6c6f 6e67 2077 6974 t copy along wit │ │ │ │ │ +00048b80: 6820 6561 6368 204f 7061 7175 6520 636f h each Opaque co │ │ │ │ │ +00048b90: 7079 2c20 6f72 2073 7461 7465 2069 6e20 py, or state in │ │ │ │ │ +00048ba0: 6f72 2077 6974 680a 2020 2020 2065 6163 or with. eac │ │ │ │ │ +00048bb0: 6820 4f70 6171 7565 2063 6f70 7920 6120 h Opaque copy a │ │ │ │ │ +00048bc0: 636f 6d70 7574 6572 2d6e 6574 776f 726b computer-network │ │ │ │ │ +00048bd0: 206c 6f63 6174 696f 6e20 6672 6f6d 2077 location from w │ │ │ │ │ +00048be0: 6869 6368 2074 6865 2067 656e 6572 616c hich the general │ │ │ │ │ +00048bf0: 0a20 2020 2020 6e65 7477 6f72 6b2d 7573 . network-us │ │ │ │ │ +00048c00: 696e 6720 7075 626c 6963 2068 6173 2061 ing public has a │ │ │ │ │ +00048c10: 6363 6573 7320 746f 2064 6f77 6e6c 6f61 ccess to downloa │ │ │ │ │ +00048c20: 6420 7573 696e 6720 7075 626c 6963 2d73 d using public-s │ │ │ │ │ +00048c30: 7461 6e64 6172 640a 2020 2020 206e 6574 tandard. net │ │ │ │ │ +00048c40: 776f 726b 2070 726f 746f 636f 6c73 2061 work protocols a │ │ │ │ │ +00048c50: 2063 6f6d 706c 6574 6520 5472 616e 7370 complete Transp │ │ │ │ │ +00048c60: 6172 656e 7420 636f 7079 206f 6620 7468 arent copy of th │ │ │ │ │ +00048c70: 6520 446f 6375 6d65 6e74 2c20 6672 6565 e Document, free │ │ │ │ │ +00048c80: 0a20 2020 2020 6f66 2061 6464 6564 206d . of added m │ │ │ │ │ +00048c90: 6174 6572 6961 6c2e 2020 4966 2079 6f75 aterial. If you │ │ │ │ │ +00048ca0: 2075 7365 2074 6865 206c 6174 7465 7220 use the latter │ │ │ │ │ +00048cb0: 6f70 7469 6f6e 2c20 796f 7520 6d75 7374 option, you must │ │ │ │ │ +00048cc0: 2074 616b 650a 2020 2020 2072 6561 736f take. reaso │ │ │ │ │ +00048cd0: 6e61 626c 7920 7072 7564 656e 7420 7374 nably prudent st │ │ │ │ │ +00048ce0: 6570 732c 2077 6865 6e20 796f 7520 6265 eps, when you be │ │ │ │ │ +00048cf0: 6769 6e20 6469 7374 7269 6275 7469 6f6e gin distribution │ │ │ │ │ +00048d00: 206f 6620 4f70 6171 7565 0a20 2020 2020 of Opaque. │ │ │ │ │ +00048d10: 636f 7069 6573 2069 6e20 7175 616e 7469 copies in quanti │ │ │ │ │ +00048d20: 7479 2c20 746f 2065 6e73 7572 6520 7468 ty, to ensure th │ │ │ │ │ +00048d30: 6174 2074 6869 7320 5472 616e 7370 6172 at this Transpar │ │ │ │ │ +00048d40: 656e 7420 636f 7079 2077 696c 6c0a 2020 ent copy will. │ │ │ │ │ +00048d50: 2020 2072 656d 6169 6e20 7468 7573 2061 remain thus a │ │ │ │ │ +00048d60: 6363 6573 7369 626c 6520 6174 2074 6865 ccessible at the │ │ │ │ │ +00048d70: 2073 7461 7465 6420 6c6f 6361 7469 6f6e stated location │ │ │ │ │ +00048d80: 2075 6e74 696c 2061 7420 6c65 6173 7420 until at least │ │ │ │ │ +00048d90: 6f6e 650a 2020 2020 2079 6561 7220 6166 one. year af │ │ │ │ │ +00048da0: 7465 7220 7468 6520 6c61 7374 2074 696d ter the last tim │ │ │ │ │ +00048db0: 6520 796f 7520 6469 7374 7269 6275 7465 e you distribute │ │ │ │ │ +00048dc0: 2061 6e20 4f70 6171 7565 2063 6f70 7920 an Opaque copy │ │ │ │ │ +00048dd0: 2864 6972 6563 746c 7920 6f72 0a20 2020 (directly or. │ │ │ │ │ +00048de0: 2020 7468 726f 7567 6820 796f 7572 2061 through your a │ │ │ │ │ +00048df0: 6765 6e74 7320 6f72 2072 6574 6169 6c65 gents or retaile │ │ │ │ │ +00048e00: 7273 2920 6f66 2074 6861 7420 6564 6974 rs) of that edit │ │ │ │ │ +00048e10: 696f 6e20 746f 2074 6865 2070 7562 6c69 ion to the publi │ │ │ │ │ +00048e20: 632e 0a0a 2020 2020 2049 7420 6973 2072 c... It is r │ │ │ │ │ +00048e30: 6571 7565 7374 6564 2c20 6275 7420 6e6f equested, but no │ │ │ │ │ +00048e40: 7420 7265 7175 6972 6564 2c20 7468 6174 t required, that │ │ │ │ │ +00048e50: 2079 6f75 2063 6f6e 7461 6374 2074 6865 you contact the │ │ │ │ │ +00048e60: 2061 7574 686f 7273 206f 660a 2020 2020 authors of. │ │ │ │ │ +00048e70: 2074 6865 2044 6f63 756d 656e 7420 7765 the Document we │ │ │ │ │ +00048e80: 6c6c 2062 6566 6f72 6520 7265 6469 7374 ll before redist │ │ │ │ │ +00048e90: 7269 6275 7469 6e67 2061 6e79 206c 6172 ributing any lar │ │ │ │ │ +00048ea0: 6765 206e 756d 6265 7220 6f66 2063 6f70 ge number of cop │ │ │ │ │ +00048eb0: 6965 732c 0a20 2020 2020 746f 2067 6976 ies,. to giv │ │ │ │ │ +00048ec0: 6520 7468 656d 2061 2063 6861 6e63 6520 e them a chance │ │ │ │ │ +00048ed0: 746f 2070 726f 7669 6465 2079 6f75 2077 to provide you w │ │ │ │ │ +00048ee0: 6974 6820 616e 2075 7064 6174 6564 2076 ith an updated v │ │ │ │ │ +00048ef0: 6572 7369 6f6e 206f 6620 7468 650a 2020 ersion of the. │ │ │ │ │ +00048f00: 2020 2044 6f63 756d 656e 742e 0a0a 2020 Document... │ │ │ │ │ +00048f10: 342e 204d 4f44 4946 4943 4154 494f 4e53 4. MODIFICATIONS │ │ │ │ │ +00048f20: 0a0a 2020 2020 2059 6f75 206d 6179 2063 .. You may c │ │ │ │ │ +00048f30: 6f70 7920 616e 6420 6469 7374 7269 6275 opy and distribu │ │ │ │ │ +00048f40: 7465 2061 204d 6f64 6966 6965 6420 5665 te a Modified Ve │ │ │ │ │ +00048f50: 7273 696f 6e20 6f66 2074 6865 2044 6f63 rsion of the Doc │ │ │ │ │ +00048f60: 756d 656e 740a 2020 2020 2075 6e64 6572 ument. under │ │ │ │ │ +00048f70: 2074 6865 2063 6f6e 6469 7469 6f6e 7320 the conditions │ │ │ │ │ +00048f80: 6f66 2073 6563 7469 6f6e 7320 3220 616e of sections 2 an │ │ │ │ │ +00048f90: 6420 3320 6162 6f76 652c 2070 726f 7669 d 3 above, provi │ │ │ │ │ +00048fa0: 6465 6420 7468 6174 2079 6f75 0a20 2020 ded that you. │ │ │ │ │ +00048fb0: 2020 7265 6c65 6173 6520 7468 6520 4d6f release the Mo │ │ │ │ │ +00048fc0: 6469 6669 6564 2056 6572 7369 6f6e 2075 dified Version u │ │ │ │ │ +00048fd0: 6e64 6572 2070 7265 6369 7365 6c79 2074 nder precisely t │ │ │ │ │ +00048fe0: 6869 7320 4c69 6365 6e73 652c 2077 6974 his License, wit │ │ │ │ │ +00048ff0: 6820 7468 650a 2020 2020 204d 6f64 6966 h the. Modif │ │ │ │ │ +00049000: 6965 6420 5665 7273 696f 6e20 6669 6c6c ied Version fill │ │ │ │ │ +00049010: 696e 6720 7468 6520 726f 6c65 206f 6620 ing the role of │ │ │ │ │ +00049020: 7468 6520 446f 6375 6d65 6e74 2c20 7468 the Document, th │ │ │ │ │ +00049030: 7573 206c 6963 656e 7369 6e67 0a20 2020 us licensing. │ │ │ │ │ +00049040: 2020 6469 7374 7269 6275 7469 6f6e 2061 distribution a │ │ │ │ │ +00049050: 6e64 206d 6f64 6966 6963 6174 696f 6e20 nd modification │ │ │ │ │ +00049060: 6f66 2074 6865 204d 6f64 6966 6965 6420 of the Modified │ │ │ │ │ +00049070: 5665 7273 696f 6e20 746f 2077 686f 6576 Version to whoev │ │ │ │ │ +00049080: 6572 0a20 2020 2020 706f 7373 6573 7365 er. possesse │ │ │ │ │ +00049090: 7320 6120 636f 7079 206f 6620 6974 2e20 s a copy of it. │ │ │ │ │ +000490a0: 2049 6e20 6164 6469 7469 6f6e 2c20 796f In addition, yo │ │ │ │ │ +000490b0: 7520 6d75 7374 2064 6f20 7468 6573 6520 u must do these │ │ │ │ │ +000490c0: 7468 696e 6773 2069 6e0a 2020 2020 2074 things in. t │ │ │ │ │ +000490d0: 6865 204d 6f64 6966 6965 6420 5665 7273 he Modified Vers │ │ │ │ │ +000490e0: 696f 6e3a 0a0a 2020 2020 2020 2041 2e20 ion:.. A. │ │ │ │ │ +000490f0: 5573 6520 696e 2074 6865 2054 6974 6c65 Use in the Title │ │ │ │ │ +00049100: 2050 6167 6520 2861 6e64 206f 6e20 7468 Page (and on th │ │ │ │ │ +00049110: 6520 636f 7665 7273 2c20 6966 2061 6e79 e covers, if any │ │ │ │ │ +00049120: 2920 6120 7469 746c 650a 2020 2020 2020 ) a title. │ │ │ │ │ +00049130: 2020 2020 6469 7374 696e 6374 2066 726f distinct fro │ │ │ │ │ +00049140: 6d20 7468 6174 206f 6620 7468 6520 446f m that of the Do │ │ │ │ │ +00049150: 6375 6d65 6e74 2c20 616e 6420 6672 6f6d cument, and from │ │ │ │ │ +00049160: 2074 686f 7365 206f 6620 7072 6576 696f those of previo │ │ │ │ │ +00049170: 7573 0a20 2020 2020 2020 2020 2076 6572 us. ver │ │ │ │ │ +00049180: 7369 6f6e 7320 2877 6869 6368 2073 686f sions (which sho │ │ │ │ │ +00049190: 756c 642c 2069 6620 7468 6572 6520 7765 uld, if there we │ │ │ │ │ +000491a0: 7265 2061 6e79 2c20 6265 206c 6973 7465 re any, be liste │ │ │ │ │ +000491b0: 6420 696e 2074 6865 0a20 2020 2020 2020 d in the. │ │ │ │ │ +000491c0: 2020 2048 6973 746f 7279 2073 6563 7469 History secti │ │ │ │ │ +000491d0: 6f6e 206f 6620 7468 6520 446f 6375 6d65 on of the Docume │ │ │ │ │ +000491e0: 6e74 292e 2020 596f 7520 6d61 7920 7573 nt). You may us │ │ │ │ │ +000491f0: 6520 7468 6520 7361 6d65 2074 6974 6c65 e the same title │ │ │ │ │ +00049200: 0a20 2020 2020 2020 2020 2061 7320 6120 . as a │ │ │ │ │ +00049210: 7072 6576 696f 7573 2076 6572 7369 6f6e previous version │ │ │ │ │ +00049220: 2069 6620 7468 6520 6f72 6967 696e 616c if the original │ │ │ │ │ +00049230: 2070 7562 6c69 7368 6572 206f 6620 7468 publisher of th │ │ │ │ │ +00049240: 6174 0a20 2020 2020 2020 2020 2076 6572 at. ver │ │ │ │ │ +00049250: 7369 6f6e 2067 6976 6573 2070 6572 6d69 sion gives permi │ │ │ │ │ +00049260: 7373 696f 6e2e 0a0a 2020 2020 2020 2042 ssion... B │ │ │ │ │ +00049270: 2e20 4c69 7374 206f 6e20 7468 6520 5469 . List on the Ti │ │ │ │ │ +00049280: 746c 6520 5061 6765 2c20 6173 2061 7574 tle Page, as aut │ │ │ │ │ +00049290: 686f 7273 2c20 6f6e 6520 6f72 206d 6f72 hors, one or mor │ │ │ │ │ +000492a0: 6520 7065 7273 6f6e 7320 6f72 0a20 2020 e persons or. │ │ │ │ │ +000492b0: 2020 2020 2020 2065 6e74 6974 6965 7320 entities │ │ │ │ │ +000492c0: 7265 7370 6f6e 7369 626c 6520 666f 7220 responsible for │ │ │ │ │ +000492d0: 6175 7468 6f72 7368 6970 206f 6620 7468 authorship of th │ │ │ │ │ +000492e0: 6520 6d6f 6469 6669 6361 7469 6f6e 7320 e modifications │ │ │ │ │ +000492f0: 696e 0a20 2020 2020 2020 2020 2074 6865 in. the │ │ │ │ │ +00049300: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ │ +00049310: 6e2c 2074 6f67 6574 6865 7220 7769 7468 n, together with │ │ │ │ │ +00049320: 2061 7420 6c65 6173 7420 6669 7665 206f at least five o │ │ │ │ │ +00049330: 6620 7468 650a 2020 2020 2020 2020 2020 f the. │ │ │ │ │ +00049340: 7072 696e 6369 7061 6c20 6175 7468 6f72 principal author │ │ │ │ │ +00049350: 7320 6f66 2074 6865 2044 6f63 756d 656e s of the Documen │ │ │ │ │ +00049360: 7420 2861 6c6c 206f 6620 6974 7320 7072 t (all of its pr │ │ │ │ │ +00049370: 696e 6369 7061 6c0a 2020 2020 2020 2020 incipal. │ │ │ │ │ +00049380: 2020 6175 7468 6f72 732c 2069 6620 6974 authors, if it │ │ │ │ │ +00049390: 2068 6173 2066 6577 6572 2074 6861 6e20 has fewer than │ │ │ │ │ +000493a0: 6669 7665 292c 2075 6e6c 6573 7320 7468 five), unless th │ │ │ │ │ +000493b0: 6579 2072 656c 6561 7365 2079 6f75 0a20 ey release you. │ │ │ │ │ +000493c0: 2020 2020 2020 2020 2066 726f 6d20 7468 from th │ │ │ │ │ +000493d0: 6973 2072 6571 7569 7265 6d65 6e74 2e0a is requirement.. │ │ │ │ │ +000493e0: 0a20 2020 2020 2020 432e 2053 7461 7465 . C. State │ │ │ │ │ +000493f0: 206f 6e20 7468 6520 5469 746c 6520 7061 on the Title pa │ │ │ │ │ +00049400: 6765 2074 6865 206e 616d 6520 6f66 2074 ge the name of t │ │ │ │ │ +00049410: 6865 2070 7562 6c69 7368 6572 206f 6620 he publisher of │ │ │ │ │ +00049420: 7468 650a 2020 2020 2020 2020 2020 4d6f the. Mo │ │ │ │ │ +00049430: 6469 6669 6564 2056 6572 7369 6f6e 2c20 dified Version, │ │ │ │ │ +00049440: 6173 2074 6865 2070 7562 6c69 7368 6572 as the publisher │ │ │ │ │ +00049450: 2e0a 0a20 2020 2020 2020 442e 2050 7265 ... D. Pre │ │ │ │ │ +00049460: 7365 7276 6520 616c 6c20 7468 6520 636f serve all the co │ │ │ │ │ +00049470: 7079 7269 6768 7420 6e6f 7469 6365 7320 pyright notices │ │ │ │ │ +00049480: 6f66 2074 6865 2044 6f63 756d 656e 742e of the Document. │ │ │ │ │ +00049490: 0a0a 2020 2020 2020 2045 2e20 4164 6420 .. E. Add │ │ │ │ │ +000494a0: 616e 2061 7070 726f 7072 6961 7465 2063 an appropriate c │ │ │ │ │ +000494b0: 6f70 7972 6967 6874 206e 6f74 6963 6520 opyright notice │ │ │ │ │ +000494c0: 666f 7220 796f 7572 206d 6f64 6966 6963 for your modific │ │ │ │ │ +000494d0: 6174 696f 6e73 0a20 2020 2020 2020 2020 ations. │ │ │ │ │ +000494e0: 2061 646a 6163 656e 7420 746f 2074 6865 adjacent to the │ │ │ │ │ +000494f0: 206f 7468 6572 2063 6f70 7972 6967 6874 other copyright │ │ │ │ │ +00049500: 206e 6f74 6963 6573 2e0a 0a20 2020 2020 notices... │ │ │ │ │ +00049510: 2020 462e 2049 6e63 6c75 6465 2c20 696d F. Include, im │ │ │ │ │ +00049520: 6d65 6469 6174 656c 7920 6166 7465 7220 mediately after │ │ │ │ │ +00049530: 7468 6520 636f 7079 7269 6768 7420 6e6f the copyright no │ │ │ │ │ +00049540: 7469 6365 732c 2061 206c 6963 656e 7365 tices, a license │ │ │ │ │ +00049550: 0a20 2020 2020 2020 2020 206e 6f74 6963 . notic │ │ │ │ │ +00049560: 6520 6769 7669 6e67 2074 6865 2070 7562 e giving the pub │ │ │ │ │ +00049570: 6c69 6320 7065 726d 6973 7369 6f6e 2074 lic permission t │ │ │ │ │ +00049580: 6f20 7573 6520 7468 6520 4d6f 6469 6669 o use the Modifi │ │ │ │ │ +00049590: 6564 0a20 2020 2020 2020 2020 2056 6572 ed. Ver │ │ │ │ │ +000495a0: 7369 6f6e 2075 6e64 6572 2074 6865 2074 sion under the t │ │ │ │ │ +000495b0: 6572 6d73 206f 6620 7468 6973 204c 6963 erms of this Lic │ │ │ │ │ +000495c0: 656e 7365 2c20 696e 2074 6865 2066 6f72 ense, in the for │ │ │ │ │ +000495d0: 6d20 7368 6f77 6e20 696e 0a20 2020 2020 m shown in. │ │ │ │ │ +000495e0: 2020 2020 2074 6865 2041 6464 656e 6475 the Addendu │ │ │ │ │ +000495f0: 6d20 6265 6c6f 772e 0a0a 2020 2020 2020 m below... │ │ │ │ │ +00049600: 2047 2e20 5072 6573 6572 7665 2069 6e20 G. Preserve in │ │ │ │ │ +00049610: 7468 6174 206c 6963 656e 7365 206e 6f74 that license not │ │ │ │ │ +00049620: 6963 6520 7468 6520 6675 6c6c 206c 6973 ice the full lis │ │ │ │ │ +00049630: 7473 206f 6620 496e 7661 7269 616e 740a ts of Invariant. │ │ │ │ │ +00049640: 2020 2020 2020 2020 2020 5365 6374 696f Sectio │ │ │ │ │ +00049650: 6e73 2061 6e64 2072 6571 7569 7265 6420 ns and required │ │ │ │ │ +00049660: 436f 7665 7220 5465 7874 7320 6769 7665 Cover Texts give │ │ │ │ │ +00049670: 6e20 696e 2074 6865 2044 6f63 756d 656e n in the Documen │ │ │ │ │ +00049680: 7427 730a 2020 2020 2020 2020 2020 6c69 t's. li │ │ │ │ │ +00049690: 6365 6e73 6520 6e6f 7469 6365 2e0a 0a20 cense notice... │ │ │ │ │ +000496a0: 2020 2020 2020 482e 2049 6e63 6c75 6465 H. Include │ │ │ │ │ +000496b0: 2061 6e20 756e 616c 7465 7265 6420 636f an unaltered co │ │ │ │ │ +000496c0: 7079 206f 6620 7468 6973 204c 6963 656e py of this Licen │ │ │ │ │ +000496d0: 7365 2e0a 0a20 2020 2020 2020 492e 2050 se... I. P │ │ │ │ │ +000496e0: 7265 7365 7276 6520 7468 6520 7365 6374 reserve the sect │ │ │ │ │ +000496f0: 696f 6e20 456e 7469 746c 6564 2022 4869 ion Entitled "Hi │ │ │ │ │ +00049700: 7374 6f72 7922 2c20 5072 6573 6572 7665 story", Preserve │ │ │ │ │ +00049710: 2069 7473 2054 6974 6c65 2c0a 2020 2020 its Title,. │ │ │ │ │ +00049720: 2020 2020 2020 616e 6420 6164 6420 746f and add to │ │ │ │ │ +00049730: 2069 7420 616e 2069 7465 6d20 7374 6174 it an item stat │ │ │ │ │ +00049740: 696e 6720 6174 206c 6561 7374 2074 6865 ing at least the │ │ │ │ │ +00049750: 2074 6974 6c65 2c20 7965 6172 2c20 6e65 title, year, ne │ │ │ │ │ +00049760: 770a 2020 2020 2020 2020 2020 6175 7468 w. auth │ │ │ │ │ +00049770: 6f72 732c 2061 6e64 2070 7562 6c69 7368 ors, and publish │ │ │ │ │ +00049780: 6572 206f 6620 7468 6520 4d6f 6469 6669 er of the Modifi │ │ │ │ │ +00049790: 6564 2056 6572 7369 6f6e 2061 7320 6769 ed Version as gi │ │ │ │ │ +000497a0: 7665 6e20 6f6e 2074 6865 0a20 2020 2020 ven on the. │ │ │ │ │ +000497b0: 2020 2020 2054 6974 6c65 2050 6167 652e Title Page. │ │ │ │ │ +000497c0: 2020 4966 2074 6865 7265 2069 7320 6e6f If there is no │ │ │ │ │ +000497d0: 2073 6563 7469 6f6e 2045 6e74 6974 6c65 section Entitle │ │ │ │ │ +000497e0: 6420 2248 6973 746f 7279 2220 696e 2074 d "History" in t │ │ │ │ │ +000497f0: 6865 0a20 2020 2020 2020 2020 2044 6f63 he. Doc │ │ │ │ │ +00049800: 756d 656e 742c 2063 7265 6174 6520 6f6e ument, create on │ │ │ │ │ +00049810: 6520 7374 6174 696e 6720 7468 6520 7469 e stating the ti │ │ │ │ │ +00049820: 746c 652c 2079 6561 722c 2061 7574 686f tle, year, autho │ │ │ │ │ +00049830: 7273 2c20 616e 640a 2020 2020 2020 2020 rs, and. │ │ │ │ │ +00049840: 2020 7075 626c 6973 6865 7220 6f66 2074 publisher of t │ │ │ │ │ +00049850: 6865 2044 6f63 756d 656e 7420 6173 2067 he Document as g │ │ │ │ │ +00049860: 6976 656e 206f 6e20 6974 7320 5469 746c iven on its Titl │ │ │ │ │ +00049870: 6520 5061 6765 2c20 7468 656e 2061 6464 e Page, then add │ │ │ │ │ +00049880: 0a20 2020 2020 2020 2020 2061 6e20 6974 . an it │ │ │ │ │ +00049890: 656d 2064 6573 6372 6962 696e 6720 7468 em describing th │ │ │ │ │ +000498a0: 6520 4d6f 6469 6669 6564 2056 6572 7369 e Modified Versi │ │ │ │ │ +000498b0: 6f6e 2061 7320 7374 6174 6564 2069 6e20 on as stated in │ │ │ │ │ +000498c0: 7468 650a 2020 2020 2020 2020 2020 7072 the. pr │ │ │ │ │ +000498d0: 6576 696f 7573 2073 656e 7465 6e63 652e evious sentence. │ │ │ │ │ +000498e0: 0a0a 2020 2020 2020 204a 2e20 5072 6573 .. J. Pres │ │ │ │ │ +000498f0: 6572 7665 2074 6865 206e 6574 776f 726b erve the network │ │ │ │ │ +00049900: 206c 6f63 6174 696f 6e2c 2069 6620 616e location, if an │ │ │ │ │ +00049910: 792c 2067 6976 656e 2069 6e20 7468 6520 y, given in the │ │ │ │ │ +00049920: 446f 6375 6d65 6e74 0a20 2020 2020 2020 Document. │ │ │ │ │ +00049930: 2020 2066 6f72 2070 7562 6c69 6320 6163 for public ac │ │ │ │ │ +00049940: 6365 7373 2074 6f20 6120 5472 616e 7370 cess to a Transp │ │ │ │ │ +00049950: 6172 656e 7420 636f 7079 206f 6620 7468 arent copy of th │ │ │ │ │ +00049960: 6520 446f 6375 6d65 6e74 2c20 616e 640a e Document, and. │ │ │ │ │ +00049970: 2020 2020 2020 2020 2020 6c69 6b65 7769 likewi │ │ │ │ │ +00049980: 7365 2074 6865 206e 6574 776f 726b 206c se the network l │ │ │ │ │ +00049990: 6f63 6174 696f 6e73 2067 6976 656e 2069 ocations given i │ │ │ │ │ +000499a0: 6e20 7468 6520 446f 6375 6d65 6e74 2066 n the Document f │ │ │ │ │ +000499b0: 6f72 0a20 2020 2020 2020 2020 2070 7265 or. pre │ │ │ │ │ +000499c0: 7669 6f75 7320 7665 7273 696f 6e73 2069 vious versions i │ │ │ │ │ +000499d0: 7420 7761 7320 6261 7365 6420 6f6e 2e20 t was based on. │ │ │ │ │ +000499e0: 2054 6865 7365 206d 6179 2062 6520 706c These may be pl │ │ │ │ │ +000499f0: 6163 6564 2069 6e20 7468 650a 2020 2020 aced in the. │ │ │ │ │ +00049a00: 2020 2020 2020 2248 6973 746f 7279 2220 "History" │ │ │ │ │ +00049a10: 7365 6374 696f 6e2e 2020 596f 7520 6d61 section. You ma │ │ │ │ │ +00049a20: 7920 6f6d 6974 2061 206e 6574 776f 726b y omit a network │ │ │ │ │ +00049a30: 206c 6f63 6174 696f 6e20 666f 7220 6120 location for a │ │ │ │ │ +00049a40: 776f 726b 0a20 2020 2020 2020 2020 2074 work. t │ │ │ │ │ +00049a50: 6861 7420 7761 7320 7075 626c 6973 6865 hat was publishe │ │ │ │ │ +00049a60: 6420 6174 206c 6561 7374 2066 6f75 7220 d at least four │ │ │ │ │ +00049a70: 7965 6172 7320 6265 666f 7265 2074 6865 years before the │ │ │ │ │ +00049a80: 2044 6f63 756d 656e 740a 2020 2020 2020 Document. │ │ │ │ │ +00049a90: 2020 2020 6974 7365 6c66 2c20 6f72 2069 itself, or i │ │ │ │ │ +00049aa0: 6620 7468 6520 6f72 6967 696e 616c 2070 f the original p │ │ │ │ │ +00049ab0: 7562 6c69 7368 6572 206f 6620 7468 6520 ublisher of the │ │ │ │ │ +00049ac0: 7665 7273 696f 6e20 6974 2072 6566 6572 version it refer │ │ │ │ │ +00049ad0: 730a 2020 2020 2020 2020 2020 746f 2067 s. to g │ │ │ │ │ +00049ae0: 6976 6573 2070 6572 6d69 7373 696f 6e2e ives permission. │ │ │ │ │ +00049af0: 0a0a 2020 2020 2020 204b 2e20 466f 7220 .. K. For │ │ │ │ │ +00049b00: 616e 7920 7365 6374 696f 6e20 456e 7469 any section Enti │ │ │ │ │ +00049b10: 746c 6564 2022 4163 6b6e 6f77 6c65 6467 tled "Acknowledg │ │ │ │ │ +00049b20: 656d 656e 7473 2220 6f72 2022 4465 6469 ements" or "Dedi │ │ │ │ │ +00049b30: 6361 7469 6f6e 7322 2c0a 2020 2020 2020 cations",. │ │ │ │ │ +00049b40: 2020 2020 5072 6573 6572 7665 2074 6865 Preserve the │ │ │ │ │ +00049b50: 2054 6974 6c65 206f 6620 7468 6520 7365 Title of the se │ │ │ │ │ +00049b60: 6374 696f 6e2c 2061 6e64 2070 7265 7365 ction, and prese │ │ │ │ │ +00049b70: 7276 6520 696e 2074 6865 2073 6563 7469 rve in the secti │ │ │ │ │ +00049b80: 6f6e 0a20 2020 2020 2020 2020 2061 6c6c on. all │ │ │ │ │ +00049b90: 2074 6865 2073 7562 7374 616e 6365 2061 the substance a │ │ │ │ │ +00049ba0: 6e64 2074 6f6e 6520 6f66 2065 6163 6820 nd tone of each │ │ │ │ │ +00049bb0: 6f66 2074 6865 2063 6f6e 7472 6962 7574 of the contribut │ │ │ │ │ +00049bc0: 6f72 0a20 2020 2020 2020 2020 2061 636b or. ack │ │ │ │ │ +00049bd0: 6e6f 776c 6564 6765 6d65 6e74 7320 616e nowledgements an │ │ │ │ │ +00049be0: 642f 6f72 2064 6564 6963 6174 696f 6e73 d/or dedications │ │ │ │ │ +00049bf0: 2067 6976 656e 2074 6865 7265 696e 2e0a given therein.. │ │ │ │ │ +00049c00: 0a20 2020 2020 2020 4c2e 2050 7265 7365 . L. Prese │ │ │ │ │ +00049c10: 7276 6520 616c 6c20 7468 6520 496e 7661 rve all the Inva │ │ │ │ │ +00049c20: 7269 616e 7420 5365 6374 696f 6e73 206f riant Sections o │ │ │ │ │ +00049c30: 6620 7468 6520 446f 6375 6d65 6e74 2c20 f the Document, │ │ │ │ │ +00049c40: 756e 616c 7465 7265 640a 2020 2020 2020 unaltered. │ │ │ │ │ +00049c50: 2020 2020 696e 2074 6865 6972 2074 6578 in their tex │ │ │ │ │ +00049c60: 7420 616e 6420 696e 2074 6865 6972 2074 t and in their t │ │ │ │ │ +00049c70: 6974 6c65 732e 2020 5365 6374 696f 6e20 itles. Section │ │ │ │ │ +00049c80: 6e75 6d62 6572 7320 6f72 2074 6865 0a20 numbers or the. │ │ │ │ │ +00049c90: 2020 2020 2020 2020 2065 7175 6976 616c equival │ │ │ │ │ +00049ca0: 656e 7420 6172 6520 6e6f 7420 636f 6e73 ent are not cons │ │ │ │ │ +00049cb0: 6964 6572 6564 2070 6172 7420 6f66 2074 idered part of t │ │ │ │ │ +00049cc0: 6865 2073 6563 7469 6f6e 2074 6974 6c65 he section title │ │ │ │ │ +00049cd0: 732e 0a0a 2020 2020 2020 204d 2e20 4465 s... M. De │ │ │ │ │ +00049ce0: 6c65 7465 2061 6e79 2073 6563 7469 6f6e lete any section │ │ │ │ │ +00049cf0: 2045 6e74 6974 6c65 6420 2245 6e64 6f72 Entitled "Endor │ │ │ │ │ +00049d00: 7365 6d65 6e74 7322 2e20 2053 7563 6820 sements". Such │ │ │ │ │ +00049d10: 6120 7365 6374 696f 6e0a 2020 2020 2020 a section. │ │ │ │ │ +00049d20: 2020 2020 6d61 7920 6e6f 7420 6265 2069 may not be i │ │ │ │ │ +00049d30: 6e63 6c75 6465 6420 696e 2074 6865 204d ncluded in the M │ │ │ │ │ +00049d40: 6f64 6966 6965 6420 5665 7273 696f 6e2e odified Version. │ │ │ │ │ +00049d50: 0a0a 2020 2020 2020 204e 2e20 446f 206e .. N. Do n │ │ │ │ │ +00049d60: 6f74 2072 6574 6974 6c65 2061 6e79 2065 ot retitle any e │ │ │ │ │ +00049d70: 7869 7374 696e 6720 7365 6374 696f 6e20 xisting section │ │ │ │ │ +00049d80: 746f 2062 6520 456e 7469 746c 6564 0a20 to be Entitled. │ │ │ │ │ +00049d90: 2020 2020 2020 2020 2022 456e 646f 7273 "Endors │ │ │ │ │ +00049da0: 656d 656e 7473 2220 6f72 2074 6f20 636f ements" or to co │ │ │ │ │ +00049db0: 6e66 6c69 6374 2069 6e20 7469 746c 6520 nflict in title │ │ │ │ │ +00049dc0: 7769 7468 2061 6e79 2049 6e76 6172 6961 with any Invaria │ │ │ │ │ +00049dd0: 6e74 0a20 2020 2020 2020 2020 2053 6563 nt. Sec │ │ │ │ │ +00049de0: 7469 6f6e 2e0a 0a20 2020 2020 2020 4f2e tion... O. │ │ │ │ │ +00049df0: 2050 7265 7365 7276 6520 616e 7920 5761 Preserve any Wa │ │ │ │ │ +00049e00: 7272 616e 7479 2044 6973 636c 6169 6d65 rranty Disclaime │ │ │ │ │ +00049e10: 7273 2e0a 0a20 2020 2020 4966 2074 6865 rs... If the │ │ │ │ │ +00049e20: 204d 6f64 6966 6965 6420 5665 7273 696f Modified Versio │ │ │ │ │ +00049e30: 6e20 696e 636c 7564 6573 206e 6577 2066 n includes new f │ │ │ │ │ +00049e40: 726f 6e74 2d6d 6174 7465 7220 7365 6374 ront-matter sect │ │ │ │ │ +00049e50: 696f 6e73 206f 720a 2020 2020 2061 7070 ions or. app │ │ │ │ │ +00049e60: 656e 6469 6365 7320 7468 6174 2071 7561 endices that qua │ │ │ │ │ +00049e70: 6c69 6679 2061 7320 5365 636f 6e64 6172 lify as Secondar │ │ │ │ │ +00049e80: 7920 5365 6374 696f 6e73 2061 6e64 2063 y Sections and c │ │ │ │ │ +00049e90: 6f6e 7461 696e 206e 6f0a 2020 2020 206d ontain no. m │ │ │ │ │ +00049ea0: 6174 6572 6961 6c20 636f 7069 6564 2066 aterial copied f │ │ │ │ │ +00049eb0: 726f 6d20 7468 6520 446f 6375 6d65 6e74 rom the Document │ │ │ │ │ +00049ec0: 2c20 796f 7520 6d61 7920 6174 2079 6f75 , you may at you │ │ │ │ │ +00049ed0: 7220 6f70 7469 6f6e 2064 6573 6967 6e61 r option designa │ │ │ │ │ +00049ee0: 7465 0a20 2020 2020 736f 6d65 206f 7220 te. some or │ │ │ │ │ +00049ef0: 616c 6c20 6f66 2074 6865 7365 2073 6563 all of these sec │ │ │ │ │ +00049f00: 7469 6f6e 7320 6173 2069 6e76 6172 6961 tions as invaria │ │ │ │ │ +00049f10: 6e74 2e20 2054 6f20 646f 2074 6869 732c nt. To do this, │ │ │ │ │ +00049f20: 2061 6464 2074 6865 6972 0a20 2020 2020 add their. │ │ │ │ │ +00049f30: 7469 746c 6573 2074 6f20 7468 6520 6c69 titles to the li │ │ │ │ │ +00049f40: 7374 206f 6620 496e 7661 7269 616e 7420 st of Invariant │ │ │ │ │ +00049f50: 5365 6374 696f 6e73 2069 6e20 7468 6520 Sections in the │ │ │ │ │ +00049f60: 4d6f 6469 6669 6564 2056 6572 7369 6f6e Modified Version │ │ │ │ │ +00049f70: 2773 0a20 2020 2020 6c69 6365 6e73 6520 's. license │ │ │ │ │ +00049f80: 6e6f 7469 6365 2e20 2054 6865 7365 2074 notice. These t │ │ │ │ │ +00049f90: 6974 6c65 7320 6d75 7374 2062 6520 6469 itles must be di │ │ │ │ │ +00049fa0: 7374 696e 6374 2066 726f 6d20 616e 7920 stinct from any │ │ │ │ │ +00049fb0: 6f74 6865 720a 2020 2020 2073 6563 7469 other. secti │ │ │ │ │ +00049fc0: 6f6e 2074 6974 6c65 732e 0a0a 2020 2020 on titles... │ │ │ │ │ +00049fd0: 2059 6f75 206d 6179 2061 6464 2061 2073 You may add a s │ │ │ │ │ +00049fe0: 6563 7469 6f6e 2045 6e74 6974 6c65 6420 ection Entitled │ │ │ │ │ +00049ff0: 2245 6e64 6f72 7365 6d65 6e74 7322 2c20 "Endorsements", │ │ │ │ │ +0004a000: 7072 6f76 6964 6564 2069 7420 636f 6e74 provided it cont │ │ │ │ │ +0004a010: 6169 6e73 0a20 2020 2020 6e6f 7468 696e ains. nothin │ │ │ │ │ +0004a020: 6720 6275 7420 656e 646f 7273 656d 656e g but endorsemen │ │ │ │ │ +0004a030: 7473 206f 6620 796f 7572 204d 6f64 6966 ts of your Modif │ │ │ │ │ +0004a040: 6965 6420 5665 7273 696f 6e20 6279 2076 ied Version by v │ │ │ │ │ +0004a050: 6172 696f 7573 0a20 2020 2020 7061 7274 arious. part │ │ │ │ │ +0004a060: 6965 732d 2d66 6f72 2065 7861 6d70 6c65 ies--for example │ │ │ │ │ +0004a070: 2c20 7374 6174 656d 656e 7473 206f 6620 , statements of │ │ │ │ │ +0004a080: 7065 6572 2072 6576 6965 7720 6f72 2074 peer review or t │ │ │ │ │ +0004a090: 6861 7420 7468 6520 7465 7874 0a20 2020 hat the text. │ │ │ │ │ +0004a0a0: 2020 6861 7320 6265 656e 2061 7070 726f has been appro │ │ │ │ │ +0004a0b0: 7665 6420 6279 2061 6e20 6f72 6761 6e69 ved by an organi │ │ │ │ │ +0004a0c0: 7a61 7469 6f6e 2061 7320 7468 6520 6175 zation as the au │ │ │ │ │ +0004a0d0: 7468 6f72 6974 6174 6976 650a 2020 2020 thoritative. │ │ │ │ │ +0004a0e0: 2064 6566 696e 6974 696f 6e20 6f66 2061 definition of a │ │ │ │ │ +0004a0f0: 2073 7461 6e64 6172 642e 0a0a 2020 2020 standard... │ │ │ │ │ +0004a100: 2059 6f75 206d 6179 2061 6464 2061 2070 You may add a p │ │ │ │ │ +0004a110: 6173 7361 6765 206f 6620 7570 2074 6f20 assage of up to │ │ │ │ │ +0004a120: 6669 7665 2077 6f72 6473 2061 7320 6120 five words as a │ │ │ │ │ +0004a130: 4672 6f6e 742d 436f 7665 7220 5465 7874 Front-Cover Text │ │ │ │ │ +0004a140: 2c0a 2020 2020 2061 6e64 2061 2070 6173 ,. and a pas │ │ │ │ │ +0004a150: 7361 6765 206f 6620 7570 2074 6f20 3235 sage of up to 25 │ │ │ │ │ +0004a160: 2077 6f72 6473 2061 7320 6120 4261 636b words as a Back │ │ │ │ │ +0004a170: 2d43 6f76 6572 2054 6578 742c 2074 6f20 -Cover Text, to │ │ │ │ │ +0004a180: 7468 6520 656e 6420 6f66 0a20 2020 2020 the end of. │ │ │ │ │ +0004a190: 7468 6520 6c69 7374 206f 6620 436f 7665 the list of Cove │ │ │ │ │ +0004a1a0: 7220 5465 7874 7320 696e 2074 6865 204d r Texts in the M │ │ │ │ │ +0004a1b0: 6f64 6966 6965 6420 5665 7273 696f 6e2e odified Version. │ │ │ │ │ +0004a1c0: 2020 4f6e 6c79 206f 6e65 2070 6173 7361 Only one passa │ │ │ │ │ +0004a1d0: 6765 0a20 2020 2020 6f66 2046 726f 6e74 ge. of Front │ │ │ │ │ +0004a1e0: 2d43 6f76 6572 2054 6578 7420 616e 6420 -Cover Text and │ │ │ │ │ +0004a1f0: 6f6e 6520 6f66 2042 6163 6b2d 436f 7665 one of Back-Cove │ │ │ │ │ +0004a200: 7220 5465 7874 206d 6179 2062 6520 6164 r Text may be ad │ │ │ │ │ +0004a210: 6465 6420 6279 2028 6f72 0a20 2020 2020 ded by (or. │ │ │ │ │ +0004a220: 7468 726f 7567 6820 6172 7261 6e67 656d through arrangem │ │ │ │ │ +0004a230: 656e 7473 206d 6164 6520 6279 2920 616e ents made by) an │ │ │ │ │ +0004a240: 7920 6f6e 6520 656e 7469 7479 2e20 2049 y one entity. I │ │ │ │ │ +0004a250: 6620 7468 6520 446f 6375 6d65 6e74 0a20 f the Document. │ │ │ │ │ +0004a260: 2020 2020 616c 7265 6164 7920 696e 636c already incl │ │ │ │ │ +0004a270: 7564 6573 2061 2063 6f76 6572 2074 6578 udes a cover tex │ │ │ │ │ +0004a280: 7420 666f 7220 7468 6520 7361 6d65 2063 t for the same c │ │ │ │ │ +0004a290: 6f76 6572 2c20 7072 6576 696f 7573 6c79 over, previously │ │ │ │ │ +0004a2a0: 2061 6464 6564 0a20 2020 2020 6279 2079 added. by y │ │ │ │ │ +0004a2b0: 6f75 206f 7220 6279 2061 7272 616e 6765 ou or by arrange │ │ │ │ │ +0004a2c0: 6d65 6e74 206d 6164 6520 6279 2074 6865 ment made by the │ │ │ │ │ +0004a2d0: 2073 616d 6520 656e 7469 7479 2079 6f75 same entity you │ │ │ │ │ +0004a2e0: 2061 7265 2061 6374 696e 6720 6f6e 0a20 are acting on. │ │ │ │ │ +0004a2f0: 2020 2020 6265 6861 6c66 206f 662c 2079 behalf of, y │ │ │ │ │ +0004a300: 6f75 206d 6179 206e 6f74 2061 6464 2061 ou may not add a │ │ │ │ │ +0004a310: 6e6f 7468 6572 3b20 6275 7420 796f 7520 nother; but you │ │ │ │ │ +0004a320: 6d61 7920 7265 706c 6163 6520 7468 6520 may replace the │ │ │ │ │ +0004a330: 6f6c 640a 2020 2020 206f 6e65 2c20 6f6e old. one, on │ │ │ │ │ +0004a340: 2065 7870 6c69 6369 7420 7065 726d 6973 explicit permis │ │ │ │ │ +0004a350: 7369 6f6e 2066 726f 6d20 7468 6520 7072 sion from the pr │ │ │ │ │ +0004a360: 6576 696f 7573 2070 7562 6c69 7368 6572 evious publisher │ │ │ │ │ +0004a370: 2074 6861 7420 6164 6465 640a 2020 2020 that added. │ │ │ │ │ +0004a380: 2074 6865 206f 6c64 206f 6e65 2e0a 0a20 the old one... │ │ │ │ │ +0004a390: 2020 2020 5468 6520 6175 7468 6f72 2873 The author(s │ │ │ │ │ +0004a3a0: 2920 616e 6420 7075 626c 6973 6865 7228 ) and publisher( │ │ │ │ │ +0004a3b0: 7329 206f 6620 7468 6520 446f 6375 6d65 s) of the Docume │ │ │ │ │ +0004a3c0: 6e74 2064 6f20 6e6f 7420 6279 2074 6869 nt do not by thi │ │ │ │ │ +0004a3d0: 730a 2020 2020 204c 6963 656e 7365 2067 s. License g │ │ │ │ │ +0004a3e0: 6976 6520 7065 726d 6973 7369 6f6e 2074 ive permission t │ │ │ │ │ +0004a3f0: 6f20 7573 6520 7468 6569 7220 6e61 6d65 o use their name │ │ │ │ │ +0004a400: 7320 666f 7220 7075 626c 6963 6974 7920 s for publicity │ │ │ │ │ +0004a410: 666f 7220 6f72 2074 6f0a 2020 2020 2061 for or to. a │ │ │ │ │ +0004a420: 7373 6572 7420 6f72 2069 6d70 6c79 2065 ssert or imply e │ │ │ │ │ +0004a430: 6e64 6f72 7365 6d65 6e74 206f 6620 616e ndorsement of an │ │ │ │ │ +0004a440: 7920 4d6f 6469 6669 6564 2056 6572 7369 y Modified Versi │ │ │ │ │ +0004a450: 6f6e 2e0a 0a20 2035 2e20 434f 4d42 494e on... 5. COMBIN │ │ │ │ │ +0004a460: 494e 4720 444f 4355 4d45 4e54 530a 0a20 ING DOCUMENTS.. │ │ │ │ │ +0004a470: 2020 2020 596f 7520 6d61 7920 636f 6d62 You may comb │ │ │ │ │ +0004a480: 696e 6520 7468 6520 446f 6375 6d65 6e74 ine the Document │ │ │ │ │ +0004a490: 2077 6974 6820 6f74 6865 7220 646f 6375 with other docu │ │ │ │ │ +0004a4a0: 6d65 6e74 7320 7265 6c65 6173 6564 2075 ments released u │ │ │ │ │ +0004a4b0: 6e64 6572 0a20 2020 2020 7468 6973 204c nder. this L │ │ │ │ │ +0004a4c0: 6963 656e 7365 2c20 756e 6465 7220 7468 icense, under th │ │ │ │ │ +0004a4d0: 6520 7465 726d 7320 6465 6669 6e65 6420 e terms defined │ │ │ │ │ +0004a4e0: 696e 2073 6563 7469 6f6e 2034 2061 626f in section 4 abo │ │ │ │ │ +0004a4f0: 7665 2066 6f72 0a20 2020 2020 6d6f 6469 ve for. modi │ │ │ │ │ +0004a500: 6669 6564 2076 6572 7369 6f6e 732c 2070 fied versions, p │ │ │ │ │ +0004a510: 726f 7669 6465 6420 7468 6174 2079 6f75 rovided that you │ │ │ │ │ +0004a520: 2069 6e63 6c75 6465 2069 6e20 7468 6520 include in the │ │ │ │ │ +0004a530: 636f 6d62 696e 6174 696f 6e20 616c 6c0a combination all. │ │ │ │ │ +0004a540: 2020 2020 206f 6620 7468 6520 496e 7661 of the Inva │ │ │ │ │ +0004a550: 7269 616e 7420 5365 6374 696f 6e73 206f riant Sections o │ │ │ │ │ +0004a560: 6620 616c 6c20 6f66 2074 6865 206f 7269 f all of the ori │ │ │ │ │ +0004a570: 6769 6e61 6c20 646f 6375 6d65 6e74 732c ginal documents, │ │ │ │ │ +0004a580: 0a20 2020 2020 756e 6d6f 6469 6669 6564 . unmodified │ │ │ │ │ +0004a590: 2c20 616e 6420 6c69 7374 2074 6865 6d20 , and list them │ │ │ │ │ +0004a5a0: 616c 6c20 6173 2049 6e76 6172 6961 6e74 all as Invariant │ │ │ │ │ +0004a5b0: 2053 6563 7469 6f6e 7320 6f66 2079 6f75 Sections of you │ │ │ │ │ +0004a5c0: 720a 2020 2020 2063 6f6d 6269 6e65 6420 r. combined │ │ │ │ │ +0004a5d0: 776f 726b 2069 6e20 6974 7320 6c69 6365 work in its lice │ │ │ │ │ +0004a5e0: 6e73 6520 6e6f 7469 6365 2c20 616e 6420 nse notice, and │ │ │ │ │ +0004a5f0: 7468 6174 2079 6f75 2070 7265 7365 7276 that you preserv │ │ │ │ │ +0004a600: 6520 616c 6c0a 2020 2020 2074 6865 6972 e all. their │ │ │ │ │ +0004a610: 2057 6172 7261 6e74 7920 4469 7363 6c61 Warranty Discla │ │ │ │ │ +0004a620: 696d 6572 732e 0a0a 2020 2020 2054 6865 imers... The │ │ │ │ │ +0004a630: 2063 6f6d 6269 6e65 6420 776f 726b 206e combined work n │ │ │ │ │ +0004a640: 6565 6420 6f6e 6c79 2063 6f6e 7461 696e eed only contain │ │ │ │ │ +0004a650: 206f 6e65 2063 6f70 7920 6f66 2074 6869 one copy of thi │ │ │ │ │ +0004a660: 7320 4c69 6365 6e73 652c 2061 6e64 0a20 s License, and. │ │ │ │ │ +0004a670: 2020 2020 6d75 6c74 6970 6c65 2069 6465 multiple ide │ │ │ │ │ +0004a680: 6e74 6963 616c 2049 6e76 6172 6961 6e74 ntical Invariant │ │ │ │ │ +0004a690: 2053 6563 7469 6f6e 7320 6d61 7920 6265 Sections may be │ │ │ │ │ +0004a6a0: 2072 6570 6c61 6365 6420 7769 7468 2061 replaced with a │ │ │ │ │ +0004a6b0: 2073 696e 676c 650a 2020 2020 2063 6f70 single. cop │ │ │ │ │ +0004a6c0: 792e 2020 4966 2074 6865 7265 2061 7265 y. If there are │ │ │ │ │ +0004a6d0: 206d 756c 7469 706c 6520 496e 7661 7269 multiple Invari │ │ │ │ │ +0004a6e0: 616e 7420 5365 6374 696f 6e73 2077 6974 ant Sections wit │ │ │ │ │ +0004a6f0: 6820 7468 6520 7361 6d65 206e 616d 650a h the same name. │ │ │ │ │ +0004a700: 2020 2020 2062 7574 2064 6966 6665 7265 but differe │ │ │ │ │ +0004a710: 6e74 2063 6f6e 7465 6e74 732c 206d 616b nt contents, mak │ │ │ │ │ +0004a720: 6520 7468 6520 7469 746c 6520 6f66 2065 e the title of e │ │ │ │ │ +0004a730: 6163 6820 7375 6368 2073 6563 7469 6f6e ach such section │ │ │ │ │ +0004a740: 2075 6e69 7175 650a 2020 2020 2062 7920 unique. by │ │ │ │ │ +0004a750: 6164 6469 6e67 2061 7420 7468 6520 656e adding at the en │ │ │ │ │ +0004a760: 6420 6f66 2069 742c 2069 6e20 7061 7265 d of it, in pare │ │ │ │ │ +0004a770: 6e74 6865 7365 732c 2074 6865 206e 616d ntheses, the nam │ │ │ │ │ +0004a780: 6520 6f66 2074 6865 0a20 2020 2020 6f72 e of the. or │ │ │ │ │ +0004a790: 6967 696e 616c 2061 7574 686f 7220 6f72 iginal author or │ │ │ │ │ +0004a7a0: 2070 7562 6c69 7368 6572 206f 6620 7468 publisher of th │ │ │ │ │ +0004a7b0: 6174 2073 6563 7469 6f6e 2069 6620 6b6e at section if kn │ │ │ │ │ +0004a7c0: 6f77 6e2c 206f 7220 656c 7365 2061 0a20 own, or else a. │ │ │ │ │ +0004a7d0: 2020 2020 756e 6971 7565 206e 756d 6265 unique numbe │ │ │ │ │ +0004a7e0: 722e 2020 4d61 6b65 2074 6865 2073 616d r. Make the sam │ │ │ │ │ +0004a7f0: 6520 6164 6a75 7374 6d65 6e74 2074 6f20 e adjustment to │ │ │ │ │ +0004a800: 7468 6520 7365 6374 696f 6e20 7469 746c the section titl │ │ │ │ │ +0004a810: 6573 2069 6e0a 2020 2020 2074 6865 206c es in. the l │ │ │ │ │ +0004a820: 6973 7420 6f66 2049 6e76 6172 6961 6e74 ist of Invariant │ │ │ │ │ +0004a830: 2053 6563 7469 6f6e 7320 696e 2074 6865 Sections in the │ │ │ │ │ +0004a840: 206c 6963 656e 7365 206e 6f74 6963 6520 license notice │ │ │ │ │ +0004a850: 6f66 2074 6865 0a20 2020 2020 636f 6d62 of the. comb │ │ │ │ │ +0004a860: 696e 6564 2077 6f72 6b2e 0a0a 2020 2020 ined work... │ │ │ │ │ +0004a870: 2049 6e20 7468 6520 636f 6d62 696e 6174 In the combinat │ │ │ │ │ +0004a880: 696f 6e2c 2079 6f75 206d 7573 7420 636f ion, you must co │ │ │ │ │ +0004a890: 6d62 696e 6520 616e 7920 7365 6374 696f mbine any sectio │ │ │ │ │ +0004a8a0: 6e73 2045 6e74 6974 6c65 640a 2020 2020 ns Entitled. │ │ │ │ │ +0004a8b0: 2022 4869 7374 6f72 7922 2069 6e20 7468 "History" in th │ │ │ │ │ +0004a8c0: 6520 7661 7269 6f75 7320 6f72 6967 696e e various origin │ │ │ │ │ +0004a8d0: 616c 2064 6f63 756d 656e 7473 2c20 666f al documents, fo │ │ │ │ │ +0004a8e0: 726d 696e 6720 6f6e 6520 7365 6374 696f rming one sectio │ │ │ │ │ +0004a8f0: 6e0a 2020 2020 2045 6e74 6974 6c65 6420 n. Entitled │ │ │ │ │ +0004a900: 2248 6973 746f 7279 223b 206c 696b 6577 "History"; likew │ │ │ │ │ +0004a910: 6973 6520 636f 6d62 696e 6520 616e 7920 ise combine any │ │ │ │ │ +0004a920: 7365 6374 696f 6e73 2045 6e74 6974 6c65 sections Entitle │ │ │ │ │ +0004a930: 640a 2020 2020 2022 4163 6b6e 6f77 6c65 d. "Acknowle │ │ │ │ │ +0004a940: 6467 656d 656e 7473 222c 2061 6e64 2061 dgements", and a │ │ │ │ │ +0004a950: 6e79 2073 6563 7469 6f6e 7320 456e 7469 ny sections Enti │ │ │ │ │ +0004a960: 746c 6564 2022 4465 6469 6361 7469 6f6e tled "Dedication │ │ │ │ │ +0004a970: 7322 2e20 2059 6f75 0a20 2020 2020 6d75 s". You. mu │ │ │ │ │ +0004a980: 7374 2064 656c 6574 6520 616c 6c20 7365 st delete all se │ │ │ │ │ +0004a990: 6374 696f 6e73 2045 6e74 6974 6c65 6420 ctions Entitled │ │ │ │ │ +0004a9a0: 2245 6e64 6f72 7365 6d65 6e74 732e 220a "Endorsements.". │ │ │ │ │ +0004a9b0: 0a20 2036 2e20 434f 4c4c 4543 5449 4f4e . 6. COLLECTION │ │ │ │ │ +0004a9c0: 5320 4f46 2044 4f43 554d 454e 5453 0a0a S OF DOCUMENTS.. │ │ │ │ │ +0004a9d0: 2020 2020 2059 6f75 206d 6179 206d 616b You may mak │ │ │ │ │ +0004a9e0: 6520 6120 636f 6c6c 6563 7469 6f6e 2063 e a collection c │ │ │ │ │ +0004a9f0: 6f6e 7369 7374 696e 6720 6f66 2074 6865 onsisting of the │ │ │ │ │ +0004aa00: 2044 6f63 756d 656e 7420 616e 6420 6f74 Document and ot │ │ │ │ │ +0004aa10: 6865 720a 2020 2020 2064 6f63 756d 656e her. documen │ │ │ │ │ +0004aa20: 7473 2072 656c 6561 7365 6420 756e 6465 ts released unde │ │ │ │ │ +0004aa30: 7220 7468 6973 204c 6963 656e 7365 2c20 r this License, │ │ │ │ │ +0004aa40: 616e 6420 7265 706c 6163 6520 7468 6520 and replace the │ │ │ │ │ +0004aa50: 696e 6469 7669 6475 616c 0a20 2020 2020 individual. │ │ │ │ │ +0004aa60: 636f 7069 6573 206f 6620 7468 6973 204c copies of this L │ │ │ │ │ +0004aa70: 6963 656e 7365 2069 6e20 7468 6520 7661 icense in the va │ │ │ │ │ +0004aa80: 7269 6f75 7320 646f 6375 6d65 6e74 7320 rious documents │ │ │ │ │ +0004aa90: 7769 7468 2061 2073 696e 676c 6520 636f with a single co │ │ │ │ │ +0004aaa0: 7079 0a20 2020 2020 7468 6174 2069 7320 py. that is │ │ │ │ │ +0004aab0: 696e 636c 7564 6564 2069 6e20 7468 6520 included in the │ │ │ │ │ +0004aac0: 636f 6c6c 6563 7469 6f6e 2c20 7072 6f76 collection, prov │ │ │ │ │ +0004aad0: 6964 6564 2074 6861 7420 796f 7520 666f ided that you fo │ │ │ │ │ +0004aae0: 6c6c 6f77 2074 6865 0a20 2020 2020 7275 llow the. ru │ │ │ │ │ +0004aaf0: 6c65 7320 6f66 2074 6869 7320 4c69 6365 les of this Lice │ │ │ │ │ +0004ab00: 6e73 6520 666f 7220 7665 7262 6174 696d nse for verbatim │ │ │ │ │ +0004ab10: 2063 6f70 7969 6e67 206f 6620 6561 6368 copying of each │ │ │ │ │ +0004ab20: 206f 6620 7468 6520 646f 6375 6d65 6e74 of the document │ │ │ │ │ +0004ab30: 730a 2020 2020 2069 6e20 616c 6c20 6f74 s. in all ot │ │ │ │ │ +0004ab40: 6865 7220 7265 7370 6563 7473 2e0a 0a20 her respects... │ │ │ │ │ +0004ab50: 2020 2020 596f 7520 6d61 7920 6578 7472 You may extr │ │ │ │ │ +0004ab60: 6163 7420 6120 7369 6e67 6c65 2064 6f63 act a single doc │ │ │ │ │ +0004ab70: 756d 656e 7420 6672 6f6d 2073 7563 6820 ument from such │ │ │ │ │ +0004ab80: 6120 636f 6c6c 6563 7469 6f6e 2c20 616e a collection, an │ │ │ │ │ +0004ab90: 640a 2020 2020 2064 6973 7472 6962 7574 d. distribut │ │ │ │ │ +0004aba0: 6520 6974 2069 6e64 6976 6964 7561 6c6c e it individuall │ │ │ │ │ +0004abb0: 7920 756e 6465 7220 7468 6973 204c 6963 y under this Lic │ │ │ │ │ +0004abc0: 656e 7365 2c20 7072 6f76 6964 6564 2079 ense, provided y │ │ │ │ │ +0004abd0: 6f75 2069 6e73 6572 740a 2020 2020 2061 ou insert. a │ │ │ │ │ +0004abe0: 2063 6f70 7920 6f66 2074 6869 7320 4c69 copy of this Li │ │ │ │ │ +0004abf0: 6365 6e73 6520 696e 746f 2074 6865 2065 cense into the e │ │ │ │ │ +0004ac00: 7874 7261 6374 6564 2064 6f63 756d 656e xtracted documen │ │ │ │ │ +0004ac10: 742c 2061 6e64 2066 6f6c 6c6f 7720 7468 t, and follow th │ │ │ │ │ +0004ac20: 6973 0a20 2020 2020 4c69 6365 6e73 6520 is. License │ │ │ │ │ +0004ac30: 696e 2061 6c6c 206f 7468 6572 2072 6573 in all other res │ │ │ │ │ +0004ac40: 7065 6374 7320 7265 6761 7264 696e 6720 pects regarding │ │ │ │ │ +0004ac50: 7665 7262 6174 696d 2063 6f70 7969 6e67 verbatim copying │ │ │ │ │ +0004ac60: 206f 6620 7468 6174 0a20 2020 2020 646f of that. do │ │ │ │ │ +0004ac70: 6375 6d65 6e74 2e0a 0a20 2037 2e20 4147 cument... 7. AG │ │ │ │ │ +0004ac80: 4752 4547 4154 494f 4e20 5749 5448 2049 GREGATION WITH I │ │ │ │ │ +0004ac90: 4e44 4550 454e 4445 4e54 2057 4f52 4b53 NDEPENDENT WORKS │ │ │ │ │ +0004aca0: 0a0a 2020 2020 2041 2063 6f6d 7069 6c61 .. A compila │ │ │ │ │ +0004acb0: 7469 6f6e 206f 6620 7468 6520 446f 6375 tion of the Docu │ │ │ │ │ +0004acc0: 6d65 6e74 206f 7220 6974 7320 6465 7269 ment or its deri │ │ │ │ │ +0004acd0: 7661 7469 7665 7320 7769 7468 206f 7468 vatives with oth │ │ │ │ │ +0004ace0: 6572 0a20 2020 2020 7365 7061 7261 7465 er. separate │ │ │ │ │ +0004acf0: 2061 6e64 2069 6e64 6570 656e 6465 6e74 and independent │ │ │ │ │ +0004ad00: 2064 6f63 756d 656e 7473 206f 7220 776f documents or wo │ │ │ │ │ +0004ad10: 726b 732c 2069 6e20 6f72 206f 6e20 6120 rks, in or on a │ │ │ │ │ +0004ad20: 766f 6c75 6d65 206f 6620 610a 2020 2020 volume of a. │ │ │ │ │ +0004ad30: 2073 746f 7261 6765 206f 7220 6469 7374 storage or dist │ │ │ │ │ +0004ad40: 7269 6275 7469 6f6e 206d 6564 6975 6d2c ribution medium, │ │ │ │ │ +0004ad50: 2069 7320 6361 6c6c 6564 2061 6e20 2261 is called an "a │ │ │ │ │ +0004ad60: 6767 7265 6761 7465 2220 6966 2074 6865 ggregate" if the │ │ │ │ │ +0004ad70: 0a20 2020 2020 636f 7079 7269 6768 7420 . copyright │ │ │ │ │ +0004ad80: 7265 7375 6c74 696e 6720 6672 6f6d 2074 resulting from t │ │ │ │ │ +0004ad90: 6865 2063 6f6d 7069 6c61 7469 6f6e 2069 he compilation i │ │ │ │ │ +0004ada0: 7320 6e6f 7420 7573 6564 2074 6f20 6c69 s not used to li │ │ │ │ │ +0004adb0: 6d69 7420 7468 650a 2020 2020 206c 6567 mit the. leg │ │ │ │ │ +0004adc0: 616c 2072 6967 6874 7320 6f66 2074 6865 al rights of the │ │ │ │ │ +0004add0: 2063 6f6d 7069 6c61 7469 6f6e 2773 2075 compilation's u │ │ │ │ │ +0004ade0: 7365 7273 2062 6579 6f6e 6420 7768 6174 sers beyond what │ │ │ │ │ +0004adf0: 2074 6865 2069 6e64 6976 6964 7561 6c0a the individual. │ │ │ │ │ +0004ae00: 2020 2020 2077 6f72 6b73 2070 6572 6d69 works permi │ │ │ │ │ +0004ae10: 742e 2020 5768 656e 2074 6865 2044 6f63 t. When the Doc │ │ │ │ │ +0004ae20: 756d 656e 7420 6973 2069 6e63 6c75 6465 ument is include │ │ │ │ │ +0004ae30: 6420 696e 2061 6e20 6167 6772 6567 6174 d in an aggregat │ │ │ │ │ +0004ae40: 652c 2074 6869 730a 2020 2020 204c 6963 e, this. Lic │ │ │ │ │ +0004ae50: 656e 7365 2064 6f65 7320 6e6f 7420 6170 ense does not ap │ │ │ │ │ +0004ae60: 706c 7920 746f 2074 6865 206f 7468 6572 ply to the other │ │ │ │ │ +0004ae70: 2077 6f72 6b73 2069 6e20 7468 6520 6167 works in the ag │ │ │ │ │ +0004ae80: 6772 6567 6174 6520 7768 6963 680a 2020 gregate which. │ │ │ │ │ +0004ae90: 2020 2061 7265 206e 6f74 2074 6865 6d73 are not thems │ │ │ │ │ +0004aea0: 656c 7665 7320 6465 7269 7661 7469 7665 elves derivative │ │ │ │ │ +0004aeb0: 2077 6f72 6b73 206f 6620 7468 6520 446f works of the Do │ │ │ │ │ +0004aec0: 6375 6d65 6e74 2e0a 0a20 2020 2020 4966 cument... If │ │ │ │ │ +0004aed0: 2074 6865 2043 6f76 6572 2054 6578 7420 the Cover Text │ │ │ │ │ +0004aee0: 7265 7175 6972 656d 656e 7420 6f66 2073 requirement of s │ │ │ │ │ +0004aef0: 6563 7469 6f6e 2033 2069 7320 6170 706c ection 3 is appl │ │ │ │ │ +0004af00: 6963 6162 6c65 2074 6f20 7468 6573 650a icable to these. │ │ │ │ │ +0004af10: 2020 2020 2063 6f70 6965 7320 6f66 2074 copies of t │ │ │ │ │ +0004af20: 6865 2044 6f63 756d 656e 742c 2074 6865 he Document, the │ │ │ │ │ +0004af30: 6e20 6966 2074 6865 2044 6f63 756d 656e n if the Documen │ │ │ │ │ +0004af40: 7420 6973 206c 6573 7320 7468 616e 206f t is less than o │ │ │ │ │ +0004af50: 6e65 2068 616c 660a 2020 2020 206f 6620 ne half. of │ │ │ │ │ +0004af60: 7468 6520 656e 7469 7265 2061 6767 7265 the entire aggre │ │ │ │ │ +0004af70: 6761 7465 2c20 7468 6520 446f 6375 6d65 gate, the Docume │ │ │ │ │ +0004af80: 6e74 2773 2043 6f76 6572 2054 6578 7473 nt's Cover Texts │ │ │ │ │ +0004af90: 206d 6179 2062 6520 706c 6163 6564 0a20 may be placed. │ │ │ │ │ +0004afa0: 2020 2020 6f6e 2063 6f76 6572 7320 7468 on covers th │ │ │ │ │ +0004afb0: 6174 2062 7261 636b 6574 2074 6865 2044 at bracket the D │ │ │ │ │ +0004afc0: 6f63 756d 656e 7420 7769 7468 696e 2074 ocument within t │ │ │ │ │ +0004afd0: 6865 2061 6767 7265 6761 7465 2c20 6f72 he aggregate, or │ │ │ │ │ +0004afe0: 2074 6865 0a20 2020 2020 656c 6563 7472 the. electr │ │ │ │ │ +0004aff0: 6f6e 6963 2065 7175 6976 616c 656e 7420 onic equivalent │ │ │ │ │ +0004b000: 6f66 2063 6f76 6572 7320 6966 2074 6865 of covers if the │ │ │ │ │ +0004b010: 2044 6f63 756d 656e 7420 6973 2069 6e20 Document is in │ │ │ │ │ +0004b020: 656c 6563 7472 6f6e 6963 0a20 2020 2020 electronic. │ │ │ │ │ +0004b030: 666f 726d 2e20 204f 7468 6572 7769 7365 form. Otherwise │ │ │ │ │ +0004b040: 2074 6865 7920 6d75 7374 2061 7070 6561 they must appea │ │ │ │ │ +0004b050: 7220 6f6e 2070 7269 6e74 6564 2063 6f76 r on printed cov │ │ │ │ │ +0004b060: 6572 7320 7468 6174 2062 7261 636b 6574 ers that bracket │ │ │ │ │ +0004b070: 0a20 2020 2020 7468 6520 7768 6f6c 6520 . the whole │ │ │ │ │ +0004b080: 6167 6772 6567 6174 652e 0a0a 2020 382e aggregate... 8. │ │ │ │ │ +0004b090: 2054 5241 4e53 4c41 5449 4f4e 0a0a 2020 TRANSLATION.. │ │ │ │ │ +0004b0a0: 2020 2054 7261 6e73 6c61 7469 6f6e 2069 Translation i │ │ │ │ │ +0004b0b0: 7320 636f 6e73 6964 6572 6564 2061 206b s considered a k │ │ │ │ │ +0004b0c0: 696e 6420 6f66 206d 6f64 6966 6963 6174 ind of modificat │ │ │ │ │ +0004b0d0: 696f 6e2c 2073 6f20 796f 7520 6d61 790a ion, so you may. │ │ │ │ │ +0004b0e0: 2020 2020 2064 6973 7472 6962 7574 6520 distribute │ │ │ │ │ +0004b0f0: 7472 616e 736c 6174 696f 6e73 206f 6620 translations of │ │ │ │ │ +0004b100: 7468 6520 446f 6375 6d65 6e74 2075 6e64 the Document und │ │ │ │ │ +0004b110: 6572 2074 6865 2074 6572 6d73 206f 6620 er the terms of │ │ │ │ │ +0004b120: 7365 6374 696f 6e0a 2020 2020 2034 2e20 section. 4. │ │ │ │ │ +0004b130: 2052 6570 6c61 6369 6e67 2049 6e76 6172 Replacing Invar │ │ │ │ │ +0004b140: 6961 6e74 2053 6563 7469 6f6e 7320 7769 iant Sections wi │ │ │ │ │ +0004b150: 7468 2074 7261 6e73 6c61 7469 6f6e 7320 th translations │ │ │ │ │ +0004b160: 7265 7175 6972 6573 2073 7065 6369 616c requires special │ │ │ │ │ +0004b170: 0a20 2020 2020 7065 726d 6973 7369 6f6e . permission │ │ │ │ │ +0004b180: 2066 726f 6d20 7468 6569 7220 636f 7079 from their copy │ │ │ │ │ +0004b190: 7269 6768 7420 686f 6c64 6572 732c 2062 right holders, b │ │ │ │ │ +0004b1a0: 7574 2079 6f75 206d 6179 2069 6e63 6c75 ut you may inclu │ │ │ │ │ +0004b1b0: 6465 0a20 2020 2020 7472 616e 736c 6174 de. translat │ │ │ │ │ +0004b1c0: 696f 6e73 206f 6620 736f 6d65 206f 7220 ions of some or │ │ │ │ │ +0004b1d0: 616c 6c20 496e 7661 7269 616e 7420 5365 all Invariant Se │ │ │ │ │ +0004b1e0: 6374 696f 6e73 2069 6e20 6164 6469 7469 ctions in additi │ │ │ │ │ +0004b1f0: 6f6e 2074 6f20 7468 650a 2020 2020 206f on to the. o │ │ │ │ │ +0004b200: 7269 6769 6e61 6c20 7665 7273 696f 6e73 riginal versions │ │ │ │ │ +0004b210: 206f 6620 7468 6573 6520 496e 7661 7269 of these Invari │ │ │ │ │ +0004b220: 616e 7420 5365 6374 696f 6e73 2e20 2059 ant Sections. Y │ │ │ │ │ +0004b230: 6f75 206d 6179 2069 6e63 6c75 6465 2061 ou may include a │ │ │ │ │ +0004b240: 0a20 2020 2020 7472 616e 736c 6174 696f . translatio │ │ │ │ │ +0004b250: 6e20 6f66 2074 6869 7320 4c69 6365 6e73 n of this Licens │ │ │ │ │ +0004b260: 652c 2061 6e64 2061 6c6c 2074 6865 206c e, and all the l │ │ │ │ │ +0004b270: 6963 656e 7365 206e 6f74 6963 6573 2069 icense notices i │ │ │ │ │ +0004b280: 6e20 7468 650a 2020 2020 2044 6f63 756d n the. Docum │ │ │ │ │ +0004b290: 656e 742c 2061 6e64 2061 6e79 2057 6172 ent, and any War │ │ │ │ │ +0004b2a0: 7261 6e74 7920 4469 7363 6c61 696d 6572 ranty Disclaimer │ │ │ │ │ +0004b2b0: 732c 2070 726f 7669 6465 6420 7468 6174 s, provided that │ │ │ │ │ +0004b2c0: 2079 6f75 2061 6c73 6f0a 2020 2020 2069 you also. i │ │ │ │ │ +0004b2d0: 6e63 6c75 6465 2074 6865 206f 7269 6769 nclude the origi │ │ │ │ │ +0004b2e0: 6e61 6c20 456e 676c 6973 6820 7665 7273 nal English vers │ │ │ │ │ +0004b2f0: 696f 6e20 6f66 2074 6869 7320 4c69 6365 ion of this Lice │ │ │ │ │ +0004b300: 6e73 6520 616e 6420 7468 650a 2020 2020 nse and the. │ │ │ │ │ +0004b310: 206f 7269 6769 6e61 6c20 7665 7273 696f original versio │ │ │ │ │ +0004b320: 6e73 206f 6620 7468 6f73 6520 6e6f 7469 ns of those noti │ │ │ │ │ +0004b330: 6365 7320 616e 6420 6469 7363 6c61 696d ces and disclaim │ │ │ │ │ +0004b340: 6572 732e 2020 496e 2063 6173 6520 6f66 ers. In case of │ │ │ │ │ +0004b350: 2061 0a20 2020 2020 6469 7361 6772 6565 a. disagree │ │ │ │ │ +0004b360: 6d65 6e74 2062 6574 7765 656e 2074 6865 ment between the │ │ │ │ │ +0004b370: 2074 7261 6e73 6c61 7469 6f6e 2061 6e64 translation and │ │ │ │ │ +0004b380: 2074 6865 206f 7269 6769 6e61 6c20 7665 the original ve │ │ │ │ │ +0004b390: 7273 696f 6e20 6f66 0a20 2020 2020 7468 rsion of. th │ │ │ │ │ +0004b3a0: 6973 204c 6963 656e 7365 206f 7220 6120 is License or a │ │ │ │ │ +0004b3b0: 6e6f 7469 6365 206f 7220 6469 7363 6c61 notice or discla │ │ │ │ │ +0004b3c0: 696d 6572 2c20 7468 6520 6f72 6967 696e imer, the origin │ │ │ │ │ +0004b3d0: 616c 2076 6572 7369 6f6e 2077 696c 6c0a al version will. │ │ │ │ │ +0004b3e0: 2020 2020 2070 7265 7661 696c 2e0a 0a20 prevail... │ │ │ │ │ +0004b3f0: 2020 2020 4966 2061 2073 6563 7469 6f6e If a section │ │ │ │ │ +0004b400: 2069 6e20 7468 6520 446f 6375 6d65 6e74 in the Document │ │ │ │ │ +0004b410: 2069 7320 456e 7469 746c 6564 2022 4163 is Entitled "Ac │ │ │ │ │ +0004b420: 6b6e 6f77 6c65 6467 656d 656e 7473 222c knowledgements", │ │ │ │ │ +0004b430: 0a20 2020 2020 2244 6564 6963 6174 696f . "Dedicatio │ │ │ │ │ +0004b440: 6e73 222c 206f 7220 2248 6973 746f 7279 ns", or "History │ │ │ │ │ +0004b450: 222c 2074 6865 2072 6571 7569 7265 6d65 ", the requireme │ │ │ │ │ +0004b460: 6e74 2028 7365 6374 696f 6e20 3429 2074 nt (section 4) t │ │ │ │ │ +0004b470: 6f0a 2020 2020 2050 7265 7365 7276 6520 o. Preserve │ │ │ │ │ +0004b480: 6974 7320 5469 746c 6520 2873 6563 7469 its Title (secti │ │ │ │ │ +0004b490: 6f6e 2031 2920 7769 6c6c 2074 7970 6963 on 1) will typic │ │ │ │ │ +0004b4a0: 616c 6c79 2072 6571 7569 7265 2063 6861 ally require cha │ │ │ │ │ +0004b4b0: 6e67 696e 6720 7468 650a 2020 2020 2061 nging the. a │ │ │ │ │ +0004b4c0: 6374 7561 6c20 7469 746c 652e 0a0a 2020 ctual title... │ │ │ │ │ +0004b4d0: 392e 2054 4552 4d49 4e41 5449 4f4e 0a0a 9. TERMINATION.. │ │ │ │ │ +0004b4e0: 2020 2020 2059 6f75 206d 6179 206e 6f74 You may not │ │ │ │ │ +0004b4f0: 2063 6f70 792c 206d 6f64 6966 792c 2073 copy, modify, s │ │ │ │ │ +0004b500: 7562 6c69 6365 6e73 652c 206f 7220 6469 ublicense, or di │ │ │ │ │ +0004b510: 7374 7269 6275 7465 2074 6865 2044 6f63 stribute the Doc │ │ │ │ │ +0004b520: 756d 656e 740a 2020 2020 2065 7863 6570 ument. excep │ │ │ │ │ +0004b530: 7420 6173 2065 7870 7265 7373 6c79 2070 t as expressly p │ │ │ │ │ +0004b540: 726f 7669 6465 6420 666f 7220 756e 6465 rovided for unde │ │ │ │ │ +0004b550: 7220 7468 6973 204c 6963 656e 7365 2e20 r this License. │ │ │ │ │ +0004b560: 2041 6e79 206f 7468 6572 0a20 2020 2020 Any other. │ │ │ │ │ +0004b570: 6174 7465 6d70 7420 746f 2063 6f70 792c attempt to copy, │ │ │ │ │ +0004b580: 206d 6f64 6966 792c 2073 7562 6c69 6365 modify, sublice │ │ │ │ │ +0004b590: 6e73 6520 6f72 2064 6973 7472 6962 7574 nse or distribut │ │ │ │ │ +0004b5a0: 6520 7468 6520 446f 6375 6d65 6e74 2069 e the Document i │ │ │ │ │ +0004b5b0: 730a 2020 2020 2076 6f69 642c 2061 6e64 s. void, and │ │ │ │ │ +0004b5c0: 2077 696c 6c20 6175 746f 6d61 7469 6361 will automatica │ │ │ │ │ +0004b5d0: 6c6c 7920 7465 726d 696e 6174 6520 796f lly terminate yo │ │ │ │ │ +0004b5e0: 7572 2072 6967 6874 7320 756e 6465 7220 ur rights under │ │ │ │ │ +0004b5f0: 7468 6973 0a20 2020 2020 4c69 6365 6e73 this. Licens │ │ │ │ │ +0004b600: 652e 2020 486f 7765 7665 722c 2070 6172 e. However, par │ │ │ │ │ +0004b610: 7469 6573 2077 686f 2068 6176 6520 7265 ties who have re │ │ │ │ │ +0004b620: 6365 6976 6564 2063 6f70 6965 732c 206f ceived copies, o │ │ │ │ │ +0004b630: 7220 7269 6768 7473 2c0a 2020 2020 2066 r rights,. f │ │ │ │ │ +0004b640: 726f 6d20 796f 7520 756e 6465 7220 7468 rom you under th │ │ │ │ │ +0004b650: 6973 204c 6963 656e 7365 2077 696c 6c20 is License will │ │ │ │ │ +0004b660: 6e6f 7420 6861 7665 2074 6865 6972 206c not have their l │ │ │ │ │ +0004b670: 6963 656e 7365 7320 7465 726d 696e 6174 icenses terminat │ │ │ │ │ +0004b680: 6564 0a20 2020 2020 736f 206c 6f6e 6720 ed. so long │ │ │ │ │ +0004b690: 6173 2073 7563 6820 7061 7274 6965 7320 as such parties │ │ │ │ │ +0004b6a0: 7265 6d61 696e 2069 6e20 6675 6c6c 2063 remain in full c │ │ │ │ │ +0004b6b0: 6f6d 706c 6961 6e63 652e 0a0a 2020 3130 ompliance... 10 │ │ │ │ │ +0004b6c0: 2e20 4655 5455 5245 2052 4556 4953 494f . FUTURE REVISIO │ │ │ │ │ +0004b6d0: 4e53 204f 4620 5448 4953 204c 4943 454e NS OF THIS LICEN │ │ │ │ │ +0004b6e0: 5345 0a0a 2020 2020 2054 6865 2046 7265 SE.. The Fre │ │ │ │ │ +0004b6f0: 6520 536f 6674 7761 7265 2046 6f75 6e64 e Software Found │ │ │ │ │ +0004b700: 6174 696f 6e20 6d61 7920 7075 626c 6973 ation may publis │ │ │ │ │ +0004b710: 6820 6e65 772c 2072 6576 6973 6564 2076 h new, revised v │ │ │ │ │ +0004b720: 6572 7369 6f6e 7320 6f66 0a20 2020 2020 ersions of. │ │ │ │ │ +0004b730: 7468 6520 474e 5520 4672 6565 2044 6f63 the GNU Free Doc │ │ │ │ │ +0004b740: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ +0004b750: 7365 2066 726f 6d20 7469 6d65 2074 6f20 se from time to │ │ │ │ │ +0004b760: 7469 6d65 2e20 2053 7563 6820 6e65 770a time. Such new. │ │ │ │ │ +0004b770: 2020 2020 2076 6572 7369 6f6e 7320 7769 versions wi │ │ │ │ │ +0004b780: 6c6c 2062 6520 7369 6d69 6c61 7220 696e ll be similar in │ │ │ │ │ +0004b790: 2073 7069 7269 7420 746f 2074 6865 2070 spirit to the p │ │ │ │ │ +0004b7a0: 7265 7365 6e74 2076 6572 7369 6f6e 2c20 resent version, │ │ │ │ │ +0004b7b0: 6275 7420 6d61 790a 2020 2020 2064 6966 but may. dif │ │ │ │ │ +0004b7c0: 6665 7220 696e 2064 6574 6169 6c20 746f fer in detail to │ │ │ │ │ +0004b7d0: 2061 6464 7265 7373 206e 6577 2070 726f address new pro │ │ │ │ │ +0004b7e0: 626c 656d 7320 6f72 2063 6f6e 6365 726e blems or concern │ │ │ │ │ +0004b7f0: 732e 2020 5365 650a 2020 2020 203c 6874 s. See. ... │ │ │ │ │ +0004b820: 2020 2045 6163 6820 7665 7273 696f 6e20 Each version │ │ │ │ │ +0004b830: 6f66 2074 6865 204c 6963 656e 7365 2069 of the License i │ │ │ │ │ +0004b840: 7320 6769 7665 6e20 6120 6469 7374 696e s given a distin │ │ │ │ │ +0004b850: 6775 6973 6869 6e67 2076 6572 7369 6f6e guishing version │ │ │ │ │ +0004b860: 0a20 2020 2020 6e75 6d62 6572 2e20 2049 . number. I │ │ │ │ │ +0004b870: 6620 7468 6520 446f 6375 6d65 6e74 2073 f the Document s │ │ │ │ │ +0004b880: 7065 6369 6669 6573 2074 6861 7420 6120 pecifies that a │ │ │ │ │ +0004b890: 7061 7274 6963 756c 6172 206e 756d 6265 particular numbe │ │ │ │ │ +0004b8a0: 7265 640a 2020 2020 2076 6572 7369 6f6e red. version │ │ │ │ │ +0004b8b0: 206f 6620 7468 6973 204c 6963 656e 7365 of this License │ │ │ │ │ +0004b8c0: 2022 6f72 2061 6e79 206c 6174 6572 2076 "or any later v │ │ │ │ │ +0004b8d0: 6572 7369 6f6e 2220 6170 706c 6965 7320 ersion" applies │ │ │ │ │ +0004b8e0: 746f 2069 742c 2079 6f75 0a20 2020 2020 to it, you. │ │ │ │ │ +0004b8f0: 6861 7665 2074 6865 206f 7074 696f 6e20 have the option │ │ │ │ │ +0004b900: 6f66 2066 6f6c 6c6f 7769 6e67 2074 6865 of following the │ │ │ │ │ +0004b910: 2074 6572 6d73 2061 6e64 2063 6f6e 6469 terms and condi │ │ │ │ │ +0004b920: 7469 6f6e 7320 6569 7468 6572 206f 660a tions either of. │ │ │ │ │ +0004b930: 2020 2020 2074 6861 7420 7370 6563 6966 that specif │ │ │ │ │ +0004b940: 6965 6420 7665 7273 696f 6e20 6f72 206f ied version or o │ │ │ │ │ +0004b950: 6620 616e 7920 6c61 7465 7220 7665 7273 f any later vers │ │ │ │ │ +0004b960: 696f 6e20 7468 6174 2068 6173 2062 6565 ion that has bee │ │ │ │ │ +0004b970: 6e0a 2020 2020 2070 7562 6c69 7368 6564 n. published │ │ │ │ │ +0004b980: 2028 6e6f 7420 6173 2061 2064 7261 6674 (not as a draft │ │ │ │ │ +0004b990: 2920 6279 2074 6865 2046 7265 6520 536f ) by the Free So │ │ │ │ │ +0004b9a0: 6674 7761 7265 2046 6f75 6e64 6174 696f ftware Foundatio │ │ │ │ │ +0004b9b0: 6e2e 2020 4966 2074 6865 0a20 2020 2020 n. If the. │ │ │ │ │ +0004b9c0: 446f 6375 6d65 6e74 2064 6f65 7320 6e6f Document does no │ │ │ │ │ +0004b9d0: 7420 7370 6563 6966 7920 6120 7665 7273 t specify a vers │ │ │ │ │ +0004b9e0: 696f 6e20 6e75 6d62 6572 206f 6620 7468 ion number of th │ │ │ │ │ +0004b9f0: 6973 204c 6963 656e 7365 2c20 796f 7520 is License, you │ │ │ │ │ +0004ba00: 6d61 790a 2020 2020 2063 686f 6f73 6520 may. choose │ │ │ │ │ +0004ba10: 616e 7920 7665 7273 696f 6e20 6576 6572 any version ever │ │ │ │ │ +0004ba20: 2070 7562 6c69 7368 6564 2028 6e6f 7420 published (not │ │ │ │ │ +0004ba30: 6173 2061 2064 7261 6674 2920 6279 2074 as a draft) by t │ │ │ │ │ +0004ba40: 6865 2046 7265 650a 2020 2020 2053 6f66 he Free. Sof │ │ │ │ │ +0004ba50: 7477 6172 6520 466f 756e 6461 7469 6f6e tware Foundation │ │ │ │ │ +0004ba60: 2e0a 0a44 2e31 2e31 2041 4444 454e 4455 ...D.1.1 ADDENDU │ │ │ │ │ +0004ba70: 4d3a 2048 6f77 2074 6f20 7573 6520 7468 M: How to use th │ │ │ │ │ +0004ba80: 6973 204c 6963 656e 7365 2066 6f72 2079 is License for y │ │ │ │ │ +0004ba90: 6f75 7220 646f 6375 6d65 6e74 730a 2d2d our documents.-- │ │ │ │ │ 0004baa0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0004bab0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ 0004bac0: 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d 2d2d ---------------- │ │ │ │ │ -0004bad0: 2d2d 2d2d 2d2d 0a0a 546f 2075 7365 2074 ------..To use t │ │ │ │ │ -0004bae0: 6869 7320 4c69 6365 6e73 6520 696e 2061 his License in a │ │ │ │ │ -0004baf0: 2064 6f63 756d 656e 7420 796f 7520 6861 document you ha │ │ │ │ │ -0004bb00: 7665 2077 7269 7474 656e 2c20 696e 636c ve written, incl │ │ │ │ │ -0004bb10: 7564 6520 6120 636f 7079 206f 660a 7468 ude a copy of.th │ │ │ │ │ -0004bb20: 6520 4c69 6365 6e73 6520 696e 2074 6865 e License in the │ │ │ │ │ -0004bb30: 2064 6f63 756d 656e 7420 616e 6420 7075 document and pu │ │ │ │ │ -0004bb40: 7420 7468 6520 666f 6c6c 6f77 696e 6720 t the following │ │ │ │ │ -0004bb50: 636f 7079 7269 6768 7420 616e 6420 6c69 copyright and li │ │ │ │ │ -0004bb60: 6365 6e73 650a 6e6f 7469 6365 7320 6a75 cense.notices ju │ │ │ │ │ -0004bb70: 7374 2061 6674 6572 2074 6865 2074 6974 st after the tit │ │ │ │ │ -0004bb80: 6c65 2070 6167 653a 0a0a 2020 2020 2020 le page:.. │ │ │ │ │ -0004bb90: 2043 6f70 7972 6967 6874 2028 4329 2020 Copyright (C) │ │ │ │ │ -0004bba0: 5945 4152 2020 594f 5552 204e 414d 452e YEAR YOUR NAME. │ │ │ │ │ -0004bbb0: 0a20 2020 2020 2020 5065 726d 6973 7369 . Permissi │ │ │ │ │ -0004bbc0: 6f6e 2069 7320 6772 616e 7465 6420 746f on is granted to │ │ │ │ │ -0004bbd0: 2063 6f70 792c 2064 6973 7472 6962 7574 copy, distribut │ │ │ │ │ -0004bbe0: 6520 616e 642f 6f72 206d 6f64 6966 7920 e and/or modify │ │ │ │ │ -0004bbf0: 7468 6973 2064 6f63 756d 656e 740a 2020 this document. │ │ │ │ │ -0004bc00: 2020 2020 2075 6e64 6572 2074 6865 2074 under the t │ │ │ │ │ -0004bc10: 6572 6d73 206f 6620 7468 6520 474e 5520 erms of the GNU │ │ │ │ │ -0004bc20: 4672 6565 2044 6f63 756d 656e 7461 7469 Free Documentati │ │ │ │ │ -0004bc30: 6f6e 204c 6963 656e 7365 2c20 5665 7273 on License, Vers │ │ │ │ │ -0004bc40: 696f 6e20 312e 320a 2020 2020 2020 206f ion 1.2. o │ │ │ │ │ -0004bc50: 7220 616e 7920 6c61 7465 7220 7665 7273 r any later vers │ │ │ │ │ -0004bc60: 696f 6e20 7075 626c 6973 6865 6420 6279 ion published by │ │ │ │ │ -0004bc70: 2074 6865 2046 7265 6520 536f 6674 7761 the Free Softwa │ │ │ │ │ -0004bc80: 7265 2046 6f75 6e64 6174 696f 6e3b 0a20 re Foundation;. │ │ │ │ │ -0004bc90: 2020 2020 2020 7769 7468 206e 6f20 496e with no In │ │ │ │ │ -0004bca0: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -0004bcb0: 2c20 6e6f 2046 726f 6e74 2d43 6f76 6572 , no Front-Cover │ │ │ │ │ -0004bcc0: 2054 6578 7473 2c20 616e 6420 6e6f 2042 Texts, and no B │ │ │ │ │ -0004bcd0: 6163 6b2d 436f 7665 720a 2020 2020 2020 ack-Cover. │ │ │ │ │ -0004bce0: 2054 6578 7473 2e20 2041 2063 6f70 7920 Texts. A copy │ │ │ │ │ -0004bcf0: 6f66 2074 6865 206c 6963 656e 7365 2069 of the license i │ │ │ │ │ -0004bd00: 7320 696e 636c 7564 6564 2069 6e20 7468 s included in th │ │ │ │ │ -0004bd10: 6520 7365 6374 696f 6e20 656e 7469 746c e section entitl │ │ │ │ │ -0004bd20: 6564 2060 6047 4e55 0a20 2020 2020 2020 ed ``GNU. │ │ │ │ │ -0004bd30: 4672 6565 2044 6f63 756d 656e 7461 7469 Free Documentati │ │ │ │ │ -0004bd40: 6f6e 204c 6963 656e 7365 2727 2e0a 0a20 on License''... │ │ │ │ │ -0004bd50: 2020 4966 2079 6f75 2068 6176 6520 496e If you have In │ │ │ │ │ -0004bd60: 7661 7269 616e 7420 5365 6374 696f 6e73 variant Sections │ │ │ │ │ -0004bd70: 2c20 4672 6f6e 742d 436f 7665 7220 5465 , Front-Cover Te │ │ │ │ │ -0004bd80: 7874 7320 616e 6420 4261 636b 2d43 6f76 xts and Back-Cov │ │ │ │ │ -0004bd90: 6572 0a54 6578 7473 2c20 7265 706c 6163 er.Texts, replac │ │ │ │ │ -0004bda0: 6520 7468 6520 2277 6974 682e 2e2e 5465 e the "with...Te │ │ │ │ │ -0004bdb0: 7874 732e 2220 206c 696e 6520 7769 7468 xts." line with │ │ │ │ │ -0004bdc0: 2074 6869 733a 0a0a 2020 2020 2020 2020 this:.. │ │ │ │ │ -0004bdd0: 2077 6974 6820 7468 6520 496e 7661 7269 with the Invari │ │ │ │ │ -0004bde0: 616e 7420 5365 6374 696f 6e73 2062 6569 ant Sections bei │ │ │ │ │ -0004bdf0: 6e67 204c 4953 5420 5448 4549 5220 5449 ng LIST THEIR TI │ │ │ │ │ -0004be00: 544c 4553 2c20 7769 7468 0a20 2020 2020 TLES, with. │ │ │ │ │ -0004be10: 2020 2020 7468 6520 4672 6f6e 742d 436f the Front-Co │ │ │ │ │ -0004be20: 7665 7220 5465 7874 7320 6265 696e 6720 ver Texts being │ │ │ │ │ -0004be30: 4c49 5354 2c20 616e 6420 7769 7468 2074 LIST, and with t │ │ │ │ │ -0004be40: 6865 2042 6163 6b2d 436f 7665 7220 5465 he Back-Cover Te │ │ │ │ │ -0004be50: 7874 730a 2020 2020 2020 2020 2062 6569 xts. bei │ │ │ │ │ -0004be60: 6e67 204c 4953 542e 0a0a 2020 2049 6620 ng LIST... If │ │ │ │ │ -0004be70: 796f 7520 6861 7665 2049 6e76 6172 6961 you have Invaria │ │ │ │ │ -0004be80: 6e74 2053 6563 7469 6f6e 7320 7769 7468 nt Sections with │ │ │ │ │ -0004be90: 6f75 7420 436f 7665 7220 5465 7874 732c out Cover Texts, │ │ │ │ │ -0004bea0: 206f 7220 736f 6d65 206f 7468 6572 0a63 or some other.c │ │ │ │ │ -0004beb0: 6f6d 6269 6e61 7469 6f6e 206f 6620 7468 ombination of th │ │ │ │ │ -0004bec0: 6520 7468 7265 652c 206d 6572 6765 2074 e three, merge t │ │ │ │ │ -0004bed0: 686f 7365 2074 776f 2061 6c74 6572 6e61 hose two alterna │ │ │ │ │ -0004bee0: 7469 7665 7320 746f 2073 7569 7420 7468 tives to suit th │ │ │ │ │ -0004bef0: 650a 7369 7475 6174 696f 6e2e 0a0a 2020 e.situation... │ │ │ │ │ -0004bf00: 2049 6620 796f 7572 2064 6f63 756d 656e If your documen │ │ │ │ │ -0004bf10: 7420 636f 6e74 6169 6e73 206e 6f6e 7472 t contains nontr │ │ │ │ │ -0004bf20: 6976 6961 6c20 6578 616d 706c 6573 206f ivial examples o │ │ │ │ │ -0004bf30: 6620 7072 6f67 7261 6d20 636f 6465 2c20 f program code, │ │ │ │ │ -0004bf40: 7765 0a72 6563 6f6d 6d65 6e64 2072 656c we.recommend rel │ │ │ │ │ -0004bf50: 6561 7369 6e67 2074 6865 7365 2065 7861 easing these exa │ │ │ │ │ -0004bf60: 6d70 6c65 7320 696e 2070 6172 616c 6c65 mples in paralle │ │ │ │ │ -0004bf70: 6c20 756e 6465 7220 796f 7572 2063 686f l under your cho │ │ │ │ │ -0004bf80: 6963 6520 6f66 2066 7265 650a 736f 6674 ice of free.soft │ │ │ │ │ -0004bf90: 7761 7265 206c 6963 656e 7365 2c20 7375 ware license, su │ │ │ │ │ -0004bfa0: 6368 2061 7320 7468 6520 474e 5520 4765 ch as the GNU Ge │ │ │ │ │ -0004bfb0: 6e65 7261 6c20 5075 626c 6963 204c 6963 neral Public Lic │ │ │ │ │ -0004bfc0: 656e 7365 2c20 746f 2070 6572 6d69 740a ense, to permit. │ │ │ │ │ -0004bfd0: 7468 6569 7220 7573 6520 696e 2066 7265 their use in fre │ │ │ │ │ -0004bfe0: 6520 736f 6674 7761 7265 2e0a 0a e software... │ │ │ │ │ +0004bad0: 2d2d 2d2d 2d2d 2d2d 0a0a 546f 2075 7365 --------..To use │ │ │ │ │ +0004bae0: 2074 6869 7320 4c69 6365 6e73 6520 696e this License in │ │ │ │ │ +0004baf0: 2061 2064 6f63 756d 656e 7420 796f 7520 a document you │ │ │ │ │ +0004bb00: 6861 7665 2077 7269 7474 656e 2c20 696e have written, in │ │ │ │ │ +0004bb10: 636c 7564 6520 6120 636f 7079 206f 660a clude a copy of. │ │ │ │ │ +0004bb20: 7468 6520 4c69 6365 6e73 6520 696e 2074 the License in t │ │ │ │ │ +0004bb30: 6865 2064 6f63 756d 656e 7420 616e 6420 he document and │ │ │ │ │ +0004bb40: 7075 7420 7468 6520 666f 6c6c 6f77 696e put the followin │ │ │ │ │ +0004bb50: 6720 636f 7079 7269 6768 7420 616e 6420 g copyright and │ │ │ │ │ +0004bb60: 6c69 6365 6e73 650a 6e6f 7469 6365 7320 license.notices │ │ │ │ │ +0004bb70: 6a75 7374 2061 6674 6572 2074 6865 2074 just after the t │ │ │ │ │ +0004bb80: 6974 6c65 2070 6167 653a 0a0a 2020 2020 itle page:.. │ │ │ │ │ +0004bb90: 2020 2043 6f70 7972 6967 6874 2028 4329 Copyright (C) │ │ │ │ │ +0004bba0: 2020 5945 4152 2020 594f 5552 204e 414d YEAR YOUR NAM │ │ │ │ │ +0004bbb0: 452e 0a20 2020 2020 2020 5065 726d 6973 E.. Permis │ │ │ │ │ +0004bbc0: 7369 6f6e 2069 7320 6772 616e 7465 6420 sion is granted │ │ │ │ │ +0004bbd0: 746f 2063 6f70 792c 2064 6973 7472 6962 to copy, distrib │ │ │ │ │ +0004bbe0: 7574 6520 616e 642f 6f72 206d 6f64 6966 ute and/or modif │ │ │ │ │ +0004bbf0: 7920 7468 6973 2064 6f63 756d 656e 740a y this document. │ │ │ │ │ +0004bc00: 2020 2020 2020 2075 6e64 6572 2074 6865 under the │ │ │ │ │ +0004bc10: 2074 6572 6d73 206f 6620 7468 6520 474e terms of the GN │ │ │ │ │ +0004bc20: 5520 4672 6565 2044 6f63 756d 656e 7461 U Free Documenta │ │ │ │ │ +0004bc30: 7469 6f6e 204c 6963 656e 7365 2c20 5665 tion License, Ve │ │ │ │ │ +0004bc40: 7273 696f 6e20 312e 320a 2020 2020 2020 rsion 1.2. │ │ │ │ │ +0004bc50: 206f 7220 616e 7920 6c61 7465 7220 7665 or any later ve │ │ │ │ │ +0004bc60: 7273 696f 6e20 7075 626c 6973 6865 6420 rsion published │ │ │ │ │ +0004bc70: 6279 2074 6865 2046 7265 6520 536f 6674 by the Free Soft │ │ │ │ │ +0004bc80: 7761 7265 2046 6f75 6e64 6174 696f 6e3b ware Foundation; │ │ │ │ │ +0004bc90: 0a20 2020 2020 2020 7769 7468 206e 6f20 . with no │ │ │ │ │ +0004bca0: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ │ +0004bcb0: 6e73 2c20 6e6f 2046 726f 6e74 2d43 6f76 ns, no Front-Cov │ │ │ │ │ +0004bcc0: 6572 2054 6578 7473 2c20 616e 6420 6e6f er Texts, and no │ │ │ │ │ +0004bcd0: 2042 6163 6b2d 436f 7665 720a 2020 2020 Back-Cover. │ │ │ │ │ +0004bce0: 2020 2054 6578 7473 2e20 2041 2063 6f70 Texts. A cop │ │ │ │ │ +0004bcf0: 7920 6f66 2074 6865 206c 6963 656e 7365 y of the license │ │ │ │ │ +0004bd00: 2069 7320 696e 636c 7564 6564 2069 6e20 is included in │ │ │ │ │ +0004bd10: 7468 6520 7365 6374 696f 6e20 656e 7469 the section enti │ │ │ │ │ +0004bd20: 746c 6564 2060 6047 4e55 0a20 2020 2020 tled ``GNU. │ │ │ │ │ +0004bd30: 2020 4672 6565 2044 6f63 756d 656e 7461 Free Documenta │ │ │ │ │ +0004bd40: 7469 6f6e 204c 6963 656e 7365 2727 2e0a tion License''.. │ │ │ │ │ +0004bd50: 0a20 2020 4966 2079 6f75 2068 6176 6520 . If you have │ │ │ │ │ +0004bd60: 496e 7661 7269 616e 7420 5365 6374 696f Invariant Sectio │ │ │ │ │ +0004bd70: 6e73 2c20 4672 6f6e 742d 436f 7665 7220 ns, Front-Cover │ │ │ │ │ +0004bd80: 5465 7874 7320 616e 6420 4261 636b 2d43 Texts and Back-C │ │ │ │ │ +0004bd90: 6f76 6572 0a54 6578 7473 2c20 7265 706c over.Texts, repl │ │ │ │ │ +0004bda0: 6163 6520 7468 6520 2277 6974 682e 2e2e ace the "with... │ │ │ │ │ +0004bdb0: 5465 7874 732e 2220 206c 696e 6520 7769 Texts." line wi │ │ │ │ │ +0004bdc0: 7468 2074 6869 733a 0a0a 2020 2020 2020 th this:.. │ │ │ │ │ +0004bdd0: 2020 2077 6974 6820 7468 6520 496e 7661 with the Inva │ │ │ │ │ +0004bde0: 7269 616e 7420 5365 6374 696f 6e73 2062 riant Sections b │ │ │ │ │ +0004bdf0: 6569 6e67 204c 4953 5420 5448 4549 5220 eing LIST THEIR │ │ │ │ │ +0004be00: 5449 544c 4553 2c20 7769 7468 0a20 2020 TITLES, with. │ │ │ │ │ +0004be10: 2020 2020 2020 7468 6520 4672 6f6e 742d the Front- │ │ │ │ │ +0004be20: 436f 7665 7220 5465 7874 7320 6265 696e Cover Texts bein │ │ │ │ │ +0004be30: 6720 4c49 5354 2c20 616e 6420 7769 7468 g LIST, and with │ │ │ │ │ +0004be40: 2074 6865 2042 6163 6b2d 436f 7665 7220 the Back-Cover │ │ │ │ │ +0004be50: 5465 7874 730a 2020 2020 2020 2020 2062 Texts. b │ │ │ │ │ +0004be60: 6569 6e67 204c 4953 542e 0a0a 2020 2049 eing LIST... I │ │ │ │ │ +0004be70: 6620 796f 7520 6861 7665 2049 6e76 6172 f you have Invar │ │ │ │ │ +0004be80: 6961 6e74 2053 6563 7469 6f6e 7320 7769 iant Sections wi │ │ │ │ │ +0004be90: 7468 6f75 7420 436f 7665 7220 5465 7874 thout Cover Text │ │ │ │ │ +0004bea0: 732c 206f 7220 736f 6d65 206f 7468 6572 s, or some other │ │ │ │ │ +0004beb0: 0a63 6f6d 6269 6e61 7469 6f6e 206f 6620 .combination of │ │ │ │ │ +0004bec0: 7468 6520 7468 7265 652c 206d 6572 6765 the three, merge │ │ │ │ │ +0004bed0: 2074 686f 7365 2074 776f 2061 6c74 6572 those two alter │ │ │ │ │ +0004bee0: 6e61 7469 7665 7320 746f 2073 7569 7420 natives to suit │ │ │ │ │ +0004bef0: 7468 650a 7369 7475 6174 696f 6e2e 0a0a the.situation... │ │ │ │ │ +0004bf00: 2020 2049 6620 796f 7572 2064 6f63 756d If your docum │ │ │ │ │ +0004bf10: 656e 7420 636f 6e74 6169 6e73 206e 6f6e ent contains non │ │ │ │ │ +0004bf20: 7472 6976 6961 6c20 6578 616d 706c 6573 trivial examples │ │ │ │ │ +0004bf30: 206f 6620 7072 6f67 7261 6d20 636f 6465 of program code │ │ │ │ │ +0004bf40: 2c20 7765 0a72 6563 6f6d 6d65 6e64 2072 , we.recommend r │ │ │ │ │ +0004bf50: 656c 6561 7369 6e67 2074 6865 7365 2065 eleasing these e │ │ │ │ │ +0004bf60: 7861 6d70 6c65 7320 696e 2070 6172 616c xamples in paral │ │ │ │ │ +0004bf70: 6c65 6c20 756e 6465 7220 796f 7572 2063 lel under your c │ │ │ │ │ +0004bf80: 686f 6963 6520 6f66 2066 7265 650a 736f hoice of free.so │ │ │ │ │ +0004bf90: 6674 7761 7265 206c 6963 656e 7365 2c20 ftware license, │ │ │ │ │ +0004bfa0: 7375 6368 2061 7320 7468 6520 474e 5520 such as the GNU │ │ │ │ │ +0004bfb0: 4765 6e65 7261 6c20 5075 626c 6963 204c General Public L │ │ │ │ │ +0004bfc0: 6963 656e 7365 2c20 746f 2070 6572 6d69 icense, to permi │ │ │ │ │ +0004bfd0: 740a 7468 6569 7220 7573 6520 696e 2066 t.their use in f │ │ │ │ │ +0004bfe0: 7265 6520 736f 6674 7761 7265 2e0a 0a ree software... │ │ │ ├── ./usr/share/info/grub.info-2.gz │ │ │ │ ├── grub.info-2 │ │ │ │ │ @@ -1,558 +1,558 @@ │ │ │ │ │ 00000000: 5468 6973 2069 7320 6772 7562 2e69 6e66 This is grub.inf │ │ │ │ │ 00000010: 6f2c 2070 726f 6475 6365 6420 6279 206d o, produced by m │ │ │ │ │ 00000020: 616b 6569 6e66 6f20 7665 7273 696f 6e20 akeinfo version │ │ │ │ │ 00000030: 362e 3820 6672 6f6d 2067 7275 622e 7465 6.8 from grub.te │ │ │ │ │ 00000040: 7869 2e0a 0a54 6869 7320 6d61 6e75 616c xi...This manual │ │ │ │ │ 00000050: 2069 7320 666f 7220 474e 5520 4752 5542 is for GNU GRUB │ │ │ │ │ 00000060: 2028 7665 7273 696f 6e20 322e 3036 2c20 (version 2.06, │ │ │ │ │ -00000070: 3720 4a61 6e75 6172 7920 3230 3234 292e 7 January 2024). │ │ │ │ │ -00000080: 0a0a 2020 2043 6f70 7972 6967 6874 2028 .. Copyright ( │ │ │ │ │ -00000090: 4329 0a31 3939 392c 3230 3030 2c32 3030 C).1999,2000,200 │ │ │ │ │ -000000a0: 312c 3230 3032 2c32 3030 342c 3230 3036 1,2002,2004,2006 │ │ │ │ │ -000000b0: 2c32 3030 382c 3230 3039 2c32 3031 302c ,2008,2009,2010, │ │ │ │ │ -000000c0: 3230 3131 2c32 3031 322c 3230 3133 2046 2011,2012,2013 F │ │ │ │ │ -000000d0: 7265 650a 536f 6674 7761 7265 2046 6f75 ree.Software Fou │ │ │ │ │ -000000e0: 6e64 6174 696f 6e2c 2049 6e63 2e0a 0a20 ndation, Inc... │ │ │ │ │ -000000f0: 2020 2020 5065 726d 6973 7369 6f6e 2069 Permission i │ │ │ │ │ -00000100: 7320 6772 616e 7465 6420 746f 2063 6f70 s granted to cop │ │ │ │ │ -00000110: 792c 2064 6973 7472 6962 7574 6520 616e y, distribute an │ │ │ │ │ -00000120: 642f 6f72 206d 6f64 6966 7920 7468 6973 d/or modify this │ │ │ │ │ -00000130: 0a20 2020 2020 646f 6375 6d65 6e74 2075 . document u │ │ │ │ │ -00000140: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ -00000150: 6620 7468 6520 474e 5520 4672 6565 2044 f the GNU Free D │ │ │ │ │ -00000160: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ -00000170: 656e 7365 2c0a 2020 2020 2056 6572 7369 ense,. Versi │ │ │ │ │ -00000180: 6f6e 2031 2e32 206f 7220 616e 7920 6c61 on 1.2 or any la │ │ │ │ │ -00000190: 7465 7220 7665 7273 696f 6e20 7075 626c ter version publ │ │ │ │ │ -000001a0: 6973 6865 6420 6279 2074 6865 2046 7265 ished by the Fre │ │ │ │ │ -000001b0: 6520 536f 6674 7761 7265 0a20 2020 2020 e Software. │ │ │ │ │ -000001c0: 466f 756e 6461 7469 6f6e 3b20 7769 7468 Foundation; with │ │ │ │ │ -000001d0: 206e 6f20 496e 7661 7269 616e 7420 5365 no Invariant Se │ │ │ │ │ -000001e0: 6374 696f 6e73 2e0a 494e 464f 2d44 4952 ctions..INFO-DIR │ │ │ │ │ -000001f0: 2d53 4543 5449 4f4e 204b 6572 6e65 6c0a -SECTION Kernel. │ │ │ │ │ -00000200: 5354 4152 542d 494e 464f 2d44 4952 2d45 START-INFO-DIR-E │ │ │ │ │ -00000210: 4e54 5259 0a2a 2047 5255 423a 2028 6772 NTRY.* GRUB: (gr │ │ │ │ │ -00000220: 7562 292e 2020 2020 2020 2020 2020 2020 ub). │ │ │ │ │ -00000230: 2020 2020 2054 6865 2047 5261 6e64 2055 The GRand U │ │ │ │ │ -00000240: 6e69 6669 6564 2042 6f6f 746c 6f61 6465 nified Bootloade │ │ │ │ │ -00000250: 720a 2a20 6772 7562 2d69 6e73 7461 6c6c r.* grub-install │ │ │ │ │ -00000260: 3a20 2867 7275 6229 496e 766f 6b69 6e67 : (grub)Invoking │ │ │ │ │ -00000270: 2067 7275 622d 696e 7374 616c 6c2e 2020 grub-install. │ │ │ │ │ -00000280: 2020 496e 7374 616c 6c20 4752 5542 206f Install GRUB o │ │ │ │ │ -00000290: 6e20 796f 7572 2064 7269 7665 0a2a 2067 n your drive.* g │ │ │ │ │ -000002a0: 7275 622d 6d6b 636f 6e66 6967 3a20 2867 rub-mkconfig: (g │ │ │ │ │ -000002b0: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ -000002c0: 622d 6d6b 636f 6e66 6967 2e20 2047 656e b-mkconfig. Gen │ │ │ │ │ -000002d0: 6572 6174 6520 4752 5542 2063 6f6e 6669 erate GRUB confi │ │ │ │ │ -000002e0: 6775 7261 7469 6f6e 0a2a 2067 7275 622d guration.* grub- │ │ │ │ │ -000002f0: 6d6b 7061 7373 7764 2d70 626b 6466 323a mkpasswd-pbkdf2: │ │ │ │ │ -00000300: 2028 6772 7562 2949 6e76 6f6b 696e 6720 (grub)Invoking │ │ │ │ │ -00000310: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ -00000320: 6b64 6632 2e0a 2a20 6772 7562 2d6d 6b72 kdf2..* grub-mkr │ │ │ │ │ -00000330: 656c 7061 7468 3a20 2867 7275 6229 496e elpath: (grub)In │ │ │ │ │ -00000340: 766f 6b69 6e67 2067 7275 622d 6d6b 7265 voking grub-mkre │ │ │ │ │ -00000350: 6c70 6174 682e 0a2a 2067 7275 622d 6d6b lpath..* grub-mk │ │ │ │ │ -00000360: 7265 7363 7565 3a20 2867 7275 6229 496e rescue: (grub)In │ │ │ │ │ -00000370: 766f 6b69 6e67 2067 7275 622d 6d6b 7265 voking grub-mkre │ │ │ │ │ -00000380: 7363 7565 2e20 204d 616b 6520 6120 4752 scue. Make a GR │ │ │ │ │ -00000390: 5542 2072 6573 6375 6520 696d 6167 650a UB rescue image. │ │ │ │ │ -000003a0: 2a20 6772 7562 2d6d 6f75 6e74 3a20 2867 * grub-mount: (g │ │ │ │ │ -000003b0: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ -000003c0: 622d 6d6f 756e 742e 2020 2020 2020 2020 b-mount. │ │ │ │ │ -000003d0: 4d6f 756e 7420 6120 6669 6c65 2073 7973 Mount a file sys │ │ │ │ │ -000003e0: 7465 6d20 7573 696e 6720 4752 5542 0a2a tem using GRUB.* │ │ │ │ │ -000003f0: 2067 7275 622d 7072 6f62 653a 2028 6772 grub-probe: (gr │ │ │ │ │ -00000400: 7562 2949 6e76 6f6b 696e 6720 6772 7562 ub)Invoking grub │ │ │ │ │ -00000410: 2d70 726f 6265 2e20 2020 2020 2020 2050 -probe. P │ │ │ │ │ -00000420: 726f 6265 2064 6576 6963 6520 696e 666f robe device info │ │ │ │ │ -00000430: 726d 6174 696f 6e0a 2a20 6772 7562 2d73 rmation.* grub-s │ │ │ │ │ -00000440: 6372 6970 742d 6368 6563 6b3a 2028 6772 cript-check: (gr │ │ │ │ │ -00000450: 7562 2949 6e76 6f6b 696e 6720 6772 7562 ub)Invoking grub │ │ │ │ │ -00000460: 2d73 6372 6970 742d 6368 6563 6b2e 0a45 -script-check..E │ │ │ │ │ -00000470: 4e44 2d49 4e46 4f2d 4449 522d 454e 5452 ND-INFO-DIR-ENTR │ │ │ │ │ -00000480: 590a 0a1f 0a46 696c 653a 2067 7275 622e Y....File: grub. │ │ │ │ │ -00000490: 696e 666f 2c20 204e 6f64 653a 2049 6e64 info, Node: Ind │ │ │ │ │ -000004a0: 6578 2c20 2050 7265 763a 2043 6f70 7969 ex, Prev: Copyi │ │ │ │ │ -000004b0: 6e67 2054 6869 7320 4d61 6e75 616c 2c20 ng This Manual, │ │ │ │ │ -000004c0: 2055 703a 2054 6f70 0a0a 496e 6465 780a Up: Top..Index. │ │ │ │ │ -000004d0: 2a2a 2a2a 2a0a 0a00 085b 696e 6465 7800 *****....[index. │ │ │ │ │ -000004e0: 085d 0a2a 204d 656e 753a 0a0a 2a20 5b3a .].* Menu:..* [: │ │ │ │ │ -000004f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00000070: 3920 4665 6272 7561 7279 2032 3032 3529 9 February 2025) │ │ │ │ │ +00000080: 2e0a 0a20 2020 436f 7079 7269 6768 7420 ... Copyright │ │ │ │ │ +00000090: 2843 290a 3139 3939 2c32 3030 302c 3230 (C).1999,2000,20 │ │ │ │ │ +000000a0: 3031 2c32 3030 322c 3230 3034 2c32 3030 01,2002,2004,200 │ │ │ │ │ +000000b0: 362c 3230 3038 2c32 3030 392c 3230 3130 6,2008,2009,2010 │ │ │ │ │ +000000c0: 2c32 3031 312c 3230 3132 2c32 3031 3320 ,2011,2012,2013 │ │ │ │ │ +000000d0: 4672 6565 0a53 6f66 7477 6172 6520 466f Free.Software Fo │ │ │ │ │ +000000e0: 756e 6461 7469 6f6e 2c20 496e 632e 0a0a undation, Inc... │ │ │ │ │ +000000f0: 2020 2020 2050 6572 6d69 7373 696f 6e20 Permission │ │ │ │ │ +00000100: 6973 2067 7261 6e74 6564 2074 6f20 636f is granted to co │ │ │ │ │ +00000110: 7079 2c20 6469 7374 7269 6275 7465 2061 py, distribute a │ │ │ │ │ +00000120: 6e64 2f6f 7220 6d6f 6469 6679 2074 6869 nd/or modify thi │ │ │ │ │ +00000130: 730a 2020 2020 2064 6f63 756d 656e 7420 s. document │ │ │ │ │ +00000140: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ +00000150: 6f66 2074 6865 2047 4e55 2046 7265 6520 of the GNU Free │ │ │ │ │ +00000160: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ │ +00000170: 6365 6e73 652c 0a20 2020 2020 5665 7273 cense,. Vers │ │ │ │ │ +00000180: 696f 6e20 312e 3220 6f72 2061 6e79 206c ion 1.2 or any l │ │ │ │ │ +00000190: 6174 6572 2076 6572 7369 6f6e 2070 7562 ater version pub │ │ │ │ │ +000001a0: 6c69 7368 6564 2062 7920 7468 6520 4672 lished by the Fr │ │ │ │ │ +000001b0: 6565 2053 6f66 7477 6172 650a 2020 2020 ee Software. │ │ │ │ │ +000001c0: 2046 6f75 6e64 6174 696f 6e3b 2077 6974 Foundation; wit │ │ │ │ │ +000001d0: 6820 6e6f 2049 6e76 6172 6961 6e74 2053 h no Invariant S │ │ │ │ │ +000001e0: 6563 7469 6f6e 732e 0a49 4e46 4f2d 4449 ections..INFO-DI │ │ │ │ │ +000001f0: 522d 5345 4354 494f 4e20 4b65 726e 656c R-SECTION Kernel │ │ │ │ │ +00000200: 0a53 5441 5254 2d49 4e46 4f2d 4449 522d .START-INFO-DIR- │ │ │ │ │ +00000210: 454e 5452 590a 2a20 4752 5542 3a20 2867 ENTRY.* GRUB: (g │ │ │ │ │ +00000220: 7275 6229 2e20 2020 2020 2020 2020 2020 rub). │ │ │ │ │ +00000230: 2020 2020 2020 5468 6520 4752 616e 6420 The GRand │ │ │ │ │ +00000240: 556e 6966 6965 6420 426f 6f74 6c6f 6164 Unified Bootload │ │ │ │ │ +00000250: 6572 0a2a 2067 7275 622d 696e 7374 616c er.* grub-instal │ │ │ │ │ +00000260: 6c3a 2028 6772 7562 2949 6e76 6f6b 696e l: (grub)Invokin │ │ │ │ │ +00000270: 6720 6772 7562 2d69 6e73 7461 6c6c 2e20 g grub-install. │ │ │ │ │ +00000280: 2020 2049 6e73 7461 6c6c 2047 5255 4220 Install GRUB │ │ │ │ │ +00000290: 6f6e 2079 6f75 7220 6472 6976 650a 2a20 on your drive.* │ │ │ │ │ +000002a0: 6772 7562 2d6d 6b63 6f6e 6669 673a 2028 grub-mkconfig: ( │ │ │ │ │ +000002b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000002c0: 7562 2d6d 6b63 6f6e 6669 672e 2020 4765 ub-mkconfig. Ge │ │ │ │ │ +000002d0: 6e65 7261 7465 2047 5255 4220 636f 6e66 nerate GRUB conf │ │ │ │ │ +000002e0: 6967 7572 6174 696f 6e0a 2a20 6772 7562 iguration.* grub │ │ │ │ │ +000002f0: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ │ +00000300: 3a20 2867 7275 6229 496e 766f 6b69 6e67 : (grub)Invoking │ │ │ │ │ +00000310: 2067 7275 622d 6d6b 7061 7373 7764 2d70 grub-mkpasswd-p │ │ │ │ │ +00000320: 626b 6466 322e 0a2a 2067 7275 622d 6d6b bkdf2..* grub-mk │ │ │ │ │ +00000330: 7265 6c70 6174 683a 2028 6772 7562 2949 relpath: (grub)I │ │ │ │ │ +00000340: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000350: 656c 7061 7468 2e0a 2a20 6772 7562 2d6d elpath..* grub-m │ │ │ │ │ +00000360: 6b72 6573 6375 653a 2028 6772 7562 2949 krescue: (grub)I │ │ │ │ │ +00000370: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000380: 6573 6375 652e 2020 4d61 6b65 2061 2047 escue. Make a G │ │ │ │ │ +00000390: 5255 4220 7265 7363 7565 2069 6d61 6765 RUB rescue image │ │ │ │ │ +000003a0: 0a2a 2067 7275 622d 6d6f 756e 743a 2028 .* grub-mount: ( │ │ │ │ │ +000003b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000003c0: 7562 2d6d 6f75 6e74 2e20 2020 2020 2020 ub-mount. │ │ │ │ │ +000003d0: 204d 6f75 6e74 2061 2066 696c 6520 7379 Mount a file sy │ │ │ │ │ +000003e0: 7374 656d 2075 7369 6e67 2047 5255 420a stem using GRUB. │ │ │ │ │ +000003f0: 2a20 6772 7562 2d70 726f 6265 3a20 2867 * grub-probe: (g │ │ │ │ │ +00000400: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000410: 622d 7072 6f62 652e 2020 2020 2020 2020 b-probe. │ │ │ │ │ +00000420: 5072 6f62 6520 6465 7669 6365 2069 6e66 Probe device inf │ │ │ │ │ +00000430: 6f72 6d61 7469 6f6e 0a2a 2067 7275 622d ormation.* grub- │ │ │ │ │ +00000440: 7363 7269 7074 2d63 6865 636b 3a20 2867 script-check: (g │ │ │ │ │ +00000450: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000460: 622d 7363 7269 7074 2d63 6865 636b 2e0a b-script-check.. │ │ │ │ │ +00000470: 454e 442d 494e 464f 2d44 4952 2d45 4e54 END-INFO-DIR-ENT │ │ │ │ │ +00000480: 5259 0a0a 1f0a 4669 6c65 3a20 6772 7562 RY....File: grub │ │ │ │ │ +00000490: 2e69 6e66 6f2c 2020 4e6f 6465 3a20 496e .info, Node: In │ │ │ │ │ +000004a0: 6465 782c 2020 5072 6576 3a20 436f 7079 dex, Prev: Copy │ │ │ │ │ +000004b0: 696e 6720 5468 6973 204d 616e 7561 6c2c ing This Manual, │ │ │ │ │ +000004c0: 2020 5570 3a20 546f 700a 0a49 6e64 6578 Up: Top..Index │ │ │ │ │ +000004d0: 0a2a 2a2a 2a2a 0a0a 0008 5b69 6e64 6578 .*****....[index │ │ │ │ │ +000004e0: 0008 5d0a 2a20 4d65 6e75 3a0a 0a2a 205b ..].* Menu:..* [ │ │ │ │ │ +000004f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00000500: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000510: 2020 2020 205b 2e20 2020 2020 2020 2020 [. │ │ │ │ │ -00000520: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00000530: 6520 3629 0a2a 2061 6370 693a 2020 2020 e 6).* acpi: │ │ │ │ │ +00000510: 2020 2020 2020 5b2e 2020 2020 2020 2020 [. │ │ │ │ │ +00000520: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00000530: 6e65 2036 290a 2a20 6163 7069 3a20 2020 ne 6).* acpi: │ │ │ │ │ 00000540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000550: 2020 2020 2020 2020 2020 2020 2020 6163 ac │ │ │ │ │ -00000560: 7069 2e20 2020 2020 2020 2020 2020 2020 pi. │ │ │ │ │ -00000570: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -00000580: 6175 7468 656e 7469 6361 7465 3a20 2020 authenticate: │ │ │ │ │ +00000550: 2020 2020 2020 2020 2020 2020 2020 2061 a │ │ │ │ │ +00000560: 6370 692e 2020 2020 2020 2020 2020 2020 cpi. │ │ │ │ │ +00000570: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +00000580: 2061 7574 6865 6e74 6963 6174 653a 2020 authenticate: │ │ │ │ │ 00000590: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000005a0: 2020 2020 2020 2061 7574 6865 6e74 6963 authentic │ │ │ │ │ -000005b0: 6174 652e 2020 2020 2020 2020 2020 286c ate. (l │ │ │ │ │ -000005c0: 696e 6520 3629 0a2a 2062 6163 6b67 726f ine 6).* backgro │ │ │ │ │ -000005d0: 756e 645f 636f 6c6f 723a 2020 2020 2020 und_color: │ │ │ │ │ +000005a0: 2020 2020 2020 2020 6175 7468 656e 7469 authenti │ │ │ │ │ +000005b0: 6361 7465 2e20 2020 2020 2020 2020 2028 cate. ( │ │ │ │ │ +000005c0: 6c69 6e65 2036 290a 2a20 6261 636b 6772 line 6).* backgr │ │ │ │ │ +000005d0: 6f75 6e64 5f63 6f6c 6f72 3a20 2020 2020 ound_color: │ │ │ │ │ 000005e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000005f0: 6261 636b 6772 6f75 6e64 5f63 6f6c 6f72 background_color │ │ │ │ │ -00000600: 2e20 2020 2020 2028 6c69 6e65 2036 290a . (line 6). │ │ │ │ │ -00000610: 2a20 6261 636b 6772 6f75 6e64 5f69 6d61 * background_ima │ │ │ │ │ -00000620: 6765 3a20 2020 2020 2020 2020 2020 2020 ge: │ │ │ │ │ -00000630: 2020 2020 2020 2020 2062 6163 6b67 726f backgro │ │ │ │ │ -00000640: 756e 645f 696d 6167 652e 2020 2020 2020 und_image. │ │ │ │ │ -00000650: 286c 696e 6520 3629 0a2a 2062 6164 7261 (line 6).* badra │ │ │ │ │ -00000660: 6d3a 2020 2020 2020 2020 2020 2020 2020 m: │ │ │ │ │ +000005f0: 2062 6163 6b67 726f 756e 645f 636f 6c6f background_colo │ │ │ │ │ +00000600: 722e 2020 2020 2020 286c 696e 6520 3629 r. (line 6) │ │ │ │ │ +00000610: 0a2a 2062 6163 6b67 726f 756e 645f 696d .* background_im │ │ │ │ │ +00000620: 6167 653a 2020 2020 2020 2020 2020 2020 age: │ │ │ │ │ +00000630: 2020 2020 2020 2020 2020 6261 636b 6772 backgr │ │ │ │ │ +00000640: 6f75 6e64 5f69 6d61 6765 2e20 2020 2020 ound_image. │ │ │ │ │ +00000650: 2028 6c69 6e65 2036 290a 2a20 6261 6472 (line 6).* badr │ │ │ │ │ +00000660: 616d 3a20 2020 2020 2020 2020 2020 2020 am: │ │ │ │ │ 00000670: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000680: 2020 6261 6472 616d 2e20 2020 2020 2020 badram. │ │ │ │ │ -00000690: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -000006a0: 290a 2a20 626c 6f63 6b6c 6973 743a 2020 ).* blocklist: │ │ │ │ │ +00000680: 2020 2062 6164 7261 6d2e 2020 2020 2020 badram. │ │ │ │ │ +00000690: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000006a0: 3629 0a2a 2062 6c6f 636b 6c69 7374 3a20 6).* blocklist: │ │ │ │ │ 000006b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000006c0: 2020 2020 2020 2020 2020 2062 6c6f 636b block │ │ │ │ │ -000006d0: 6c69 7374 2e20 2020 2020 2020 2020 2020 list. │ │ │ │ │ -000006e0: 2020 286c 696e 6520 3629 0a2a 2062 6f6f (line 6).* boo │ │ │ │ │ -000006f0: 743a 2020 2020 2020 2020 2020 2020 2020 t: │ │ │ │ │ +000006c0: 2020 2020 2020 2020 2020 2020 626c 6f63 bloc │ │ │ │ │ +000006d0: 6b6c 6973 742e 2020 2020 2020 2020 2020 klist. │ │ │ │ │ +000006e0: 2020 2028 6c69 6e65 2036 290a 2a20 626f (line 6).* bo │ │ │ │ │ +000006f0: 6f74 3a20 2020 2020 2020 2020 2020 2020 ot: │ │ │ │ │ 00000700: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000710: 2020 2020 626f 6f74 2e20 2020 2020 2020 boot. │ │ │ │ │ -00000720: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00000730: 2036 290a 2a20 6361 743a 2020 2020 2020 6).* cat: │ │ │ │ │ +00000710: 2020 2020 2062 6f6f 742e 2020 2020 2020 boot. │ │ │ │ │ +00000720: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00000730: 6520 3629 0a2a 2063 6174 3a20 2020 2020 e 6).* cat: │ │ │ │ │ 00000740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000750: 2020 2020 2020 2020 2020 2020 2063 6174 cat │ │ │ │ │ -00000760: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00000770: 2020 2020 286c 696e 6520 3629 0a2a 2063 (line 6).* c │ │ │ │ │ -00000780: 6861 696e 6c6f 6164 6572 3a20 2020 2020 hainloader: │ │ │ │ │ +00000750: 2020 2020 2020 2020 2020 2020 2020 6361 ca │ │ │ │ │ +00000760: 742e 2020 2020 2020 2020 2020 2020 2020 t. │ │ │ │ │ +00000770: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +00000780: 6368 6169 6e6c 6f61 6465 723a 2020 2020 chainloader: │ │ │ │ │ 00000790: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000007a0: 2020 2020 2020 6368 6169 6e6c 6f61 6465 chainloade │ │ │ │ │ -000007b0: 722e 2020 2020 2020 2020 2020 2028 6c69 r. (li │ │ │ │ │ -000007c0: 6e65 2036 290a 2a20 636c 6561 723a 2020 ne 6).* clear: │ │ │ │ │ +000007a0: 2020 2020 2020 2063 6861 696e 6c6f 6164 chainload │ │ │ │ │ +000007b0: 6572 2e20 2020 2020 2020 2020 2020 286c er. (l │ │ │ │ │ +000007c0: 696e 6520 3629 0a2a 2063 6c65 6172 3a20 ine 6).* clear: │ │ │ │ │ 000007d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000007e0: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ │ -000007f0: 6c65 6172 2e20 2020 2020 2020 2020 2020 lear. │ │ │ │ │ -00000800: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -00000810: 2043 4d4f 533a 2020 2020 2020 2020 2020 CMOS: │ │ │ │ │ +000007e0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000007f0: 636c 6561 722e 2020 2020 2020 2020 2020 clear. │ │ │ │ │ +00000800: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +00000810: 2a20 434d 4f53 3a20 2020 2020 2020 2020 * CMOS: │ │ │ │ │ 00000820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000830: 2020 2020 2020 2020 636d 6f73 6475 6d70 cmosdump │ │ │ │ │ -00000840: 2e20 2020 2020 2020 2020 2020 2020 2028 . ( │ │ │ │ │ -00000850: 6c69 6e65 2036 290a 2a20 636d 6f73 636c line 6).* cmoscl │ │ │ │ │ -00000860: 6561 6e3a 2020 2020 2020 2020 2020 2020 ean: │ │ │ │ │ +00000830: 2020 2020 2020 2020 2063 6d6f 7364 756d cmosdum │ │ │ │ │ +00000840: 702e 2020 2020 2020 2020 2020 2020 2020 p. │ │ │ │ │ +00000850: 286c 696e 6520 3629 0a2a 2063 6d6f 7363 (line 6).* cmosc │ │ │ │ │ +00000860: 6c65 616e 3a20 2020 2020 2020 2020 2020 lean: │ │ │ │ │ 00000870: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000880: 2063 6d6f 7363 6c65 616e 2e20 2020 2020 cmosclean. │ │ │ │ │ -00000890: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ -000008a0: 0a2a 2063 6d6f 7374 6573 743a 2020 2020 .* cmostest: │ │ │ │ │ +00000880: 2020 636d 6f73 636c 6561 6e2e 2020 2020 cmosclean. │ │ │ │ │ +00000890: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ +000008a0: 290a 2a20 636d 6f73 7465 7374 3a20 2020 ).* cmostest: │ │ │ │ │ 000008b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000008c0: 2020 2020 2020 2020 2020 636d 6f73 7465 cmoste │ │ │ │ │ -000008d0: 7374 2e20 2020 2020 2020 2020 2020 2020 st. │ │ │ │ │ -000008e0: 2028 6c69 6e65 2036 290a 2a20 636d 703a (line 6).* cmp: │ │ │ │ │ -000008f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000008c0: 2020 2020 2020 2020 2020 2063 6d6f 7374 cmost │ │ │ │ │ +000008d0: 6573 742e 2020 2020 2020 2020 2020 2020 est. │ │ │ │ │ +000008e0: 2020 286c 696e 6520 3629 0a2a 2063 6d70 (line 6).* cmp │ │ │ │ │ +000008f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00000900: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000910: 2020 2063 6d70 2e20 2020 2020 2020 2020 cmp. │ │ │ │ │ -00000920: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00000930: 3629 0a2a 2063 6f6e 6669 6766 696c 653a 6).* configfile: │ │ │ │ │ -00000940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000950: 2020 2020 2020 2020 2020 2020 636f 6e66 conf │ │ │ │ │ -00000960: 6967 6669 6c65 2e20 2020 2020 2020 2020 igfile. │ │ │ │ │ -00000970: 2020 2028 6c69 6e65 2036 290a 2a20 6370 (line 6).* cp │ │ │ │ │ -00000980: 7569 643a 2020 2020 2020 2020 2020 2020 uid: │ │ │ │ │ +00000910: 2020 2020 636d 702e 2020 2020 2020 2020 cmp. │ │ │ │ │ +00000920: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00000930: 2036 290a 2a20 636f 6e66 6967 6669 6c65 6).* configfile │ │ │ │ │ +00000940: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00000950: 2020 2020 2020 2020 2020 2020 2063 6f6e con │ │ │ │ │ +00000960: 6669 6766 696c 652e 2020 2020 2020 2020 figfile. │ │ │ │ │ +00000970: 2020 2020 286c 696e 6520 3629 0a2a 2063 (line 6).* c │ │ │ │ │ +00000980: 7075 6964 3a20 2020 2020 2020 2020 2020 puid: │ │ │ │ │ 00000990: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000009a0: 2020 2020 2063 7075 6964 2e20 2020 2020 cpuid. │ │ │ │ │ -000009b0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -000009c0: 6520 3629 0a2a 2063 7263 3a20 2020 2020 e 6).* crc: │ │ │ │ │ +000009a0: 2020 2020 2020 6370 7569 642e 2020 2020 cpuid. │ │ │ │ │ +000009b0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +000009c0: 6e65 2036 290a 2a20 6372 633a 2020 2020 ne 6).* crc: │ │ │ │ │ 000009d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000009e0: 2020 2020 2020 2020 2020 2020 2020 6372 cr │ │ │ │ │ -000009f0: 632e 2020 2020 2020 2020 2020 2020 2020 c. │ │ │ │ │ -00000a00: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -00000a10: 6372 7970 746f 6d6f 756e 743a 2020 2020 cryptomount: │ │ │ │ │ +000009e0: 2020 2020 2020 2020 2020 2020 2020 2063 c │ │ │ │ │ +000009f0: 7263 2e20 2020 2020 2020 2020 2020 2020 rc. │ │ │ │ │ +00000a00: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +00000a10: 2063 7279 7074 6f6d 6f75 6e74 3a20 2020 cryptomount: │ │ │ │ │ 00000a20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000a30: 2020 2020 2020 2063 7279 7074 6f6d 6f75 cryptomou │ │ │ │ │ -00000a40: 6e74 2e20 2020 2020 2020 2020 2020 286c nt. (l │ │ │ │ │ -00000a50: 696e 6520 3629 0a2a 2063 7574 6d65 6d3a ine 6).* cutmem: │ │ │ │ │ -00000a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00000a30: 2020 2020 2020 2020 6372 7970 746f 6d6f cryptomo │ │ │ │ │ +00000a40: 756e 742e 2020 2020 2020 2020 2020 2028 unt. ( │ │ │ │ │ +00000a50: 6c69 6e65 2036 290a 2a20 6375 746d 656d line 6).* cutmem │ │ │ │ │ +00000a60: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00000a70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000a80: 6375 746d 656d 2e20 2020 2020 2020 2020 cutmem. │ │ │ │ │ -00000a90: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -00000aa0: 2a20 6461 7465 3a20 2020 2020 2020 2020 * date: │ │ │ │ │ +00000a80: 2063 7574 6d65 6d2e 2020 2020 2020 2020 cutmem. │ │ │ │ │ +00000a90: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +00000aa0: 0a2a 2064 6174 653a 2020 2020 2020 2020 .* date: │ │ │ │ │ 00000ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ac0: 2020 2020 2020 2020 2064 6174 652e 2020 date. │ │ │ │ │ +00000ac0: 2020 2020 2020 2020 2020 6461 7465 2e20 date. │ │ │ │ │ 00000ad0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ae0: 286c 696e 6520 3629 0a2a 2064 6576 6963 (line 6).* devic │ │ │ │ │ -00000af0: 6574 7265 653a 2020 2020 2020 2020 2020 etree: │ │ │ │ │ +00000ae0: 2028 6c69 6e65 2036 290a 2a20 6465 7669 (line 6).* devi │ │ │ │ │ +00000af0: 6365 7472 6565 3a20 2020 2020 2020 2020 cetree: │ │ │ │ │ 00000b00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000b10: 2020 6465 7669 6365 7472 6565 2e20 2020 devicetree. │ │ │ │ │ -00000b20: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -00000b30: 290a 2a20 6469 7374 7275 7374 3a20 2020 ).* distrust: │ │ │ │ │ +00000b10: 2020 2064 6576 6963 6574 7265 652e 2020 devicetree. │ │ │ │ │ +00000b20: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00000b30: 3629 0a2a 2064 6973 7472 7573 743a 2020 6).* distrust: │ │ │ │ │ 00000b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000b50: 2020 2020 2020 2020 2020 2064 6973 7472 distr │ │ │ │ │ -00000b60: 7573 742e 2020 2020 2020 2020 2020 2020 ust. │ │ │ │ │ -00000b70: 2020 286c 696e 6520 3629 0a2a 2064 7269 (line 6).* dri │ │ │ │ │ -00000b80: 7665 6d61 703a 2020 2020 2020 2020 2020 vemap: │ │ │ │ │ +00000b50: 2020 2020 2020 2020 2020 2020 6469 7374 dist │ │ │ │ │ +00000b60: 7275 7374 2e20 2020 2020 2020 2020 2020 rust. │ │ │ │ │ +00000b70: 2020 2028 6c69 6e65 2036 290a 2a20 6472 (line 6).* dr │ │ │ │ │ +00000b80: 6976 656d 6170 3a20 2020 2020 2020 2020 ivemap: │ │ │ │ │ 00000b90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ba0: 2020 2020 6472 6976 656d 6170 2e20 2020 drivemap. │ │ │ │ │ -00000bb0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00000bc0: 2036 290a 2a20 6563 686f 3a20 2020 2020 6).* echo: │ │ │ │ │ +00000ba0: 2020 2020 2064 7269 7665 6d61 702e 2020 drivemap. │ │ │ │ │ +00000bb0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00000bc0: 6520 3629 0a2a 2065 6368 6f3a 2020 2020 e 6).* echo: │ │ │ │ │ 00000bd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000be0: 2020 2020 2020 2020 2020 2020 2065 6368 ech │ │ │ │ │ -00000bf0: 6f2e 2020 2020 2020 2020 2020 2020 2020 o. │ │ │ │ │ -00000c00: 2020 2020 286c 696e 6520 3629 0a2a 2065 (line 6).* e │ │ │ │ │ -00000c10: 7661 6c3a 2020 2020 2020 2020 2020 2020 val: │ │ │ │ │ +00000be0: 2020 2020 2020 2020 2020 2020 2020 6563 ec │ │ │ │ │ +00000bf0: 686f 2e20 2020 2020 2020 2020 2020 2020 ho. │ │ │ │ │ +00000c00: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +00000c10: 6576 616c 3a20 2020 2020 2020 2020 2020 eval: │ │ │ │ │ 00000c20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000c30: 2020 2020 2020 6576 616c 2e20 2020 2020 eval. │ │ │ │ │ -00000c40: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00000c50: 6e65 2036 290a 2a20 6578 706f 7274 3a20 ne 6).* export: │ │ │ │ │ +00000c30: 2020 2020 2020 2065 7661 6c2e 2020 2020 eval. │ │ │ │ │ +00000c40: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00000c50: 696e 6520 3629 0a2a 2065 7870 6f72 743a ine 6).* export: │ │ │ │ │ 00000c60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000c70: 2020 2020 2020 2020 2020 2020 2020 2065 e │ │ │ │ │ -00000c80: 7870 6f72 742e 2020 2020 2020 2020 2020 xport. │ │ │ │ │ -00000c90: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -00000ca0: 2066 616c 7365 3a20 2020 2020 2020 2020 false: │ │ │ │ │ +00000c70: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00000c80: 6578 706f 7274 2e20 2020 2020 2020 2020 export. │ │ │ │ │ +00000c90: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +00000ca0: 2a20 6661 6c73 653a 2020 2020 2020 2020 * false: │ │ │ │ │ 00000cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000cc0: 2020 2020 2020 2020 6661 6c73 652e 2020 false. │ │ │ │ │ -00000cd0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -00000ce0: 6c69 6e65 2036 290a 2a20 4644 4c2c 2047 line 6).* FDL, G │ │ │ │ │ -00000cf0: 4e55 2046 7265 6520 446f 6375 6d65 6e74 NU Free Document │ │ │ │ │ -00000d00: 6174 696f 6e20 4c69 6365 6e73 653a 2020 ation License: │ │ │ │ │ -00000d10: 2047 4e55 2046 7265 6520 446f 6375 6d65 GNU Free Docume │ │ │ │ │ -00000d20: 6e74 6174 696f 6e20 4c69 6365 6e73 652e ntation License. │ │ │ │ │ -00000d30: 0a20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00000cc0: 2020 2020 2020 2020 2066 616c 7365 2e20 false. │ │ │ │ │ +00000cd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00000ce0: 286c 696e 6520 3629 0a2a 2046 444c 2c20 (line 6).* FDL, │ │ │ │ │ +00000cf0: 474e 5520 4672 6565 2044 6f63 756d 656e GNU Free Documen │ │ │ │ │ +00000d00: 7461 7469 6f6e 204c 6963 656e 7365 3a20 tation License: │ │ │ │ │ +00000d10: 2020 474e 5520 4672 6565 2044 6f63 756d GNU Free Docum │ │ │ │ │ +00000d20: 656e 7461 7469 6f6e 204c 6963 656e 7365 entation License │ │ │ │ │ +00000d30: 2e0a 2020 2020 2020 2020 2020 2020 2020 .. │ │ │ │ │ 00000d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00000d50: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00000d60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000d70: 2028 6c69 6e65 2036 290a 2a20 6765 7474 (line 6).* gett │ │ │ │ │ -00000d80: 6578 743a 2020 2020 2020 2020 2020 2020 ext: │ │ │ │ │ +00000d70: 2020 286c 696e 6520 3629 0a2a 2067 6574 (line 6).* get │ │ │ │ │ +00000d80: 7465 7874 3a20 2020 2020 2020 2020 2020 text: │ │ │ │ │ 00000d90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000da0: 2020 2067 6574 7465 7874 2e20 2020 2020 gettext. │ │ │ │ │ -00000db0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00000dc0: 3629 0a2a 2067 7074 7379 6e63 3a20 2020 6).* gptsync: │ │ │ │ │ +00000da0: 2020 2020 6765 7474 6578 742e 2020 2020 gettext. │ │ │ │ │ +00000db0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00000dc0: 2036 290a 2a20 6770 7473 796e 633a 2020 6).* gptsync: │ │ │ │ │ 00000dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000de0: 2020 2020 2020 2020 2020 2020 6770 7473 gpts │ │ │ │ │ -00000df0: 796e 632e 2020 2020 2020 2020 2020 2020 ync. │ │ │ │ │ -00000e00: 2020 2028 6c69 6e65 2036 290a 2a20 6861 (line 6).* ha │ │ │ │ │ -00000e10: 6c74 3a20 2020 2020 2020 2020 2020 2020 lt: │ │ │ │ │ +00000de0: 2020 2020 2020 2020 2020 2020 2067 7074 gpt │ │ │ │ │ +00000df0: 7379 6e63 2e20 2020 2020 2020 2020 2020 sync. │ │ │ │ │ +00000e00: 2020 2020 286c 696e 6520 3629 0a2a 2068 (line 6).* h │ │ │ │ │ +00000e10: 616c 743a 2020 2020 2020 2020 2020 2020 alt: │ │ │ │ │ 00000e20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000e30: 2020 2020 2068 616c 742e 2020 2020 2020 halt. │ │ │ │ │ -00000e40: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00000e50: 6520 3629 0a2a 2068 6173 6873 756d 3a20 e 6).* hashsum: │ │ │ │ │ +00000e30: 2020 2020 2020 6861 6c74 2e20 2020 2020 halt. │ │ │ │ │ +00000e40: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00000e50: 6e65 2036 290a 2a20 6861 7368 7375 6d3a ne 6).* hashsum: │ │ │ │ │ 00000e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000e70: 2020 2020 2020 2020 2020 2020 2020 6861 ha │ │ │ │ │ -00000e80: 7368 7375 6d2e 2020 2020 2020 2020 2020 shsum. │ │ │ │ │ -00000e90: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -00000ea0: 6865 6c70 3a20 2020 2020 2020 2020 2020 help: │ │ │ │ │ +00000e70: 2020 2020 2020 2020 2020 2020 2020 2068 h │ │ │ │ │ +00000e80: 6173 6873 756d 2e20 2020 2020 2020 2020 ashsum. │ │ │ │ │ +00000e90: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +00000ea0: 2068 656c 703a 2020 2020 2020 2020 2020 help: │ │ │ │ │ 00000eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000ec0: 2020 2020 2020 2068 656c 702e 2020 2020 help. │ │ │ │ │ -00000ed0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00000ee0: 696e 6520 3629 0a2a 2069 6e69 7472 643a ine 6).* initrd: │ │ │ │ │ -00000ef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00000ec0: 2020 2020 2020 2020 6865 6c70 2e20 2020 help. │ │ │ │ │ +00000ed0: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00000ee0: 6c69 6e65 2036 290a 2a20 696e 6974 7264 line 6).* initrd │ │ │ │ │ +00000ef0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00000f00: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000f10: 696e 6974 7264 2e20 2020 2020 2020 2020 initrd. │ │ │ │ │ -00000f20: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -00000f30: 2a20 696e 6974 7264 3136 3a20 2020 2020 * initrd16: │ │ │ │ │ +00000f10: 2069 6e69 7472 642e 2020 2020 2020 2020 initrd. │ │ │ │ │ +00000f20: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +00000f30: 0a2a 2069 6e69 7472 6431 363a 2020 2020 .* initrd16: │ │ │ │ │ 00000f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000f50: 2020 2020 2020 2020 2069 6e69 7472 6431 initrd1 │ │ │ │ │ -00000f60: 362e 2020 2020 2020 2020 2020 2020 2020 6. │ │ │ │ │ -00000f70: 286c 696e 6520 3629 0a2a 2069 6e73 6d6f (line 6).* insmo │ │ │ │ │ -00000f80: 643a 2020 2020 2020 2020 2020 2020 2020 d: │ │ │ │ │ +00000f50: 2020 2020 2020 2020 2020 696e 6974 7264 initrd │ │ │ │ │ +00000f60: 3136 2e20 2020 2020 2020 2020 2020 2020 16. │ │ │ │ │ +00000f70: 2028 6c69 6e65 2036 290a 2a20 696e 736d (line 6).* insm │ │ │ │ │ +00000f80: 6f64 3a20 2020 2020 2020 2020 2020 2020 od: │ │ │ │ │ 00000f90: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000fa0: 2020 696e 736d 6f64 2e20 2020 2020 2020 insmod. │ │ │ │ │ -00000fb0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -00000fc0: 290a 2a20 6b65 7973 7461 7475 733a 2020 ).* keystatus: │ │ │ │ │ +00000fa0: 2020 2069 6e73 6d6f 642e 2020 2020 2020 insmod. │ │ │ │ │ +00000fb0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00000fc0: 3629 0a2a 206b 6579 7374 6174 7573 3a20 6).* keystatus: │ │ │ │ │ 00000fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00000fe0: 2020 2020 2020 2020 2020 206b 6579 7374 keyst │ │ │ │ │ -00000ff0: 6174 7573 2e20 2020 2020 2020 2020 2020 atus. │ │ │ │ │ -00001000: 2020 286c 696e 6520 3629 0a2a 206c 696e (line 6).* lin │ │ │ │ │ -00001010: 7578 3a20 2020 2020 2020 2020 2020 2020 ux: │ │ │ │ │ +00000fe0: 2020 2020 2020 2020 2020 2020 6b65 7973 keys │ │ │ │ │ +00000ff0: 7461 7475 732e 2020 2020 2020 2020 2020 tatus. │ │ │ │ │ +00001000: 2020 2028 6c69 6e65 2036 290a 2a20 6c69 (line 6).* li │ │ │ │ │ +00001010: 6e75 783a 2020 2020 2020 2020 2020 2020 nux: │ │ │ │ │ 00001020: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001030: 2020 2020 6c69 6e75 782e 2020 2020 2020 linux. │ │ │ │ │ -00001040: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00001050: 2036 290a 2a20 6c69 6e75 7831 363a 2020 6).* linux16: │ │ │ │ │ +00001030: 2020 2020 206c 696e 7578 2e20 2020 2020 linux. │ │ │ │ │ +00001040: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00001050: 6520 3629 0a2a 206c 696e 7578 3136 3a20 e 6).* linux16: │ │ │ │ │ 00001060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001070: 2020 2020 2020 2020 2020 2020 206c 696e lin │ │ │ │ │ -00001080: 7578 3136 2e20 2020 2020 2020 2020 2020 ux16. │ │ │ │ │ -00001090: 2020 2020 286c 696e 6520 3629 0a2a 206c (line 6).* l │ │ │ │ │ -000010a0: 6973 745f 656e 763a 2020 2020 2020 2020 ist_env: │ │ │ │ │ +00001070: 2020 2020 2020 2020 2020 2020 2020 6c69 li │ │ │ │ │ +00001080: 6e75 7831 362e 2020 2020 2020 2020 2020 nux16. │ │ │ │ │ +00001090: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +000010a0: 6c69 7374 5f65 6e76 3a20 2020 2020 2020 list_env: │ │ │ │ │ 000010b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000010c0: 2020 2020 2020 6c69 7374 5f65 6e76 2e20 list_env. │ │ │ │ │ -000010d0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -000010e0: 6e65 2036 290a 2a20 6c69 7374 5f74 7275 ne 6).* list_tru │ │ │ │ │ -000010f0: 7374 6564 3a20 2020 2020 2020 2020 2020 sted: │ │ │ │ │ -00001100: 2020 2020 2020 2020 2020 2020 2020 206c l │ │ │ │ │ -00001110: 6973 745f 7472 7573 7465 642e 2020 2020 ist_trusted. │ │ │ │ │ -00001120: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -00001130: 206c 6f61 6466 6f6e 743a 2020 2020 2020 loadfont: │ │ │ │ │ +000010c0: 2020 2020 2020 206c 6973 745f 656e 762e list_env. │ │ │ │ │ +000010d0: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +000010e0: 696e 6520 3629 0a2a 206c 6973 745f 7472 ine 6).* list_tr │ │ │ │ │ +000010f0: 7573 7465 643a 2020 2020 2020 2020 2020 usted: │ │ │ │ │ +00001100: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001110: 6c69 7374 5f74 7275 7374 6564 2e20 2020 list_trusted. │ │ │ │ │ +00001120: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +00001130: 2a20 6c6f 6164 666f 6e74 3a20 2020 2020 * loadfont: │ │ │ │ │ 00001140: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001150: 2020 2020 2020 2020 6c6f 6164 666f 6e74 loadfont │ │ │ │ │ -00001160: 2e20 2020 2020 2020 2020 2020 2020 2028 . ( │ │ │ │ │ -00001170: 6c69 6e65 2036 290a 2a20 6c6f 6164 5f65 line 6).* load_e │ │ │ │ │ -00001180: 6e76 3a20 2020 2020 2020 2020 2020 2020 nv: │ │ │ │ │ +00001150: 2020 2020 2020 2020 206c 6f61 6466 6f6e loadfon │ │ │ │ │ +00001160: 742e 2020 2020 2020 2020 2020 2020 2020 t. │ │ │ │ │ +00001170: 286c 696e 6520 3629 0a2a 206c 6f61 645f (line 6).* load_ │ │ │ │ │ +00001180: 656e 763a 2020 2020 2020 2020 2020 2020 env: │ │ │ │ │ 00001190: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000011a0: 206c 6f61 645f 656e 762e 2020 2020 2020 load_env. │ │ │ │ │ -000011b0: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ -000011c0: 0a2a 206c 6f6f 7062 6163 6b3a 2020 2020 .* loopback: │ │ │ │ │ +000011a0: 2020 6c6f 6164 5f65 6e76 2e20 2020 2020 load_env. │ │ │ │ │ +000011b0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ +000011c0: 290a 2a20 6c6f 6f70 6261 636b 3a20 2020 ).* loopback: │ │ │ │ │ 000011d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000011e0: 2020 2020 2020 2020 2020 6c6f 6f70 6261 loopba │ │ │ │ │ -000011f0: 636b 2e20 2020 2020 2020 2020 2020 2020 ck. │ │ │ │ │ -00001200: 2028 6c69 6e65 2036 290a 2a20 6c73 3a20 (line 6).* ls: │ │ │ │ │ +000011e0: 2020 2020 2020 2020 2020 206c 6f6f 7062 loopb │ │ │ │ │ +000011f0: 6163 6b2e 2020 2020 2020 2020 2020 2020 ack. │ │ │ │ │ +00001200: 2020 286c 696e 6520 3629 0a2a 206c 733a (line 6).* ls: │ │ │ │ │ 00001210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00001220: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001230: 2020 206c 732e 2020 2020 2020 2020 2020 ls. │ │ │ │ │ -00001240: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00001250: 3629 0a2a 206c 7366 6f6e 7473 3a20 2020 6).* lsfonts: │ │ │ │ │ +00001230: 2020 2020 6c73 2e20 2020 2020 2020 2020 ls. │ │ │ │ │ +00001240: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00001250: 2036 290a 2a20 6c73 666f 6e74 733a 2020 6).* lsfonts: │ │ │ │ │ 00001260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001270: 2020 2020 2020 2020 2020 2020 6c73 666f lsfo │ │ │ │ │ -00001280: 6e74 732e 2020 2020 2020 2020 2020 2020 nts. │ │ │ │ │ -00001290: 2020 2028 6c69 6e65 2036 290a 2a20 6c73 (line 6).* ls │ │ │ │ │ -000012a0: 6d6f 643a 2020 2020 2020 2020 2020 2020 mod: │ │ │ │ │ +00001270: 2020 2020 2020 2020 2020 2020 206c 7366 lsf │ │ │ │ │ +00001280: 6f6e 7473 2e20 2020 2020 2020 2020 2020 onts. │ │ │ │ │ +00001290: 2020 2020 286c 696e 6520 3629 0a2a 206c (line 6).* l │ │ │ │ │ +000012a0: 736d 6f64 3a20 2020 2020 2020 2020 2020 smod: │ │ │ │ │ 000012b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000012c0: 2020 2020 206c 736d 6f64 2e20 2020 2020 lsmod. │ │ │ │ │ -000012d0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -000012e0: 6520 3629 0a2a 206d 6435 7375 6d3a 2020 e 6).* md5sum: │ │ │ │ │ +000012c0: 2020 2020 2020 6c73 6d6f 642e 2020 2020 lsmod. │ │ │ │ │ +000012d0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +000012e0: 6e65 2036 290a 2a20 6d64 3573 756d 3a20 ne 6).* md5sum: │ │ │ │ │ 000012f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001300: 2020 2020 2020 2020 2020 2020 2020 6d64 md │ │ │ │ │ -00001310: 3573 756d 2e20 2020 2020 2020 2020 2020 5sum. │ │ │ │ │ -00001320: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -00001330: 6d65 6e75 656e 7472 793a 2020 2020 2020 menuentry: │ │ │ │ │ +00001300: 2020 2020 2020 2020 2020 2020 2020 206d m │ │ │ │ │ +00001310: 6435 7375 6d2e 2020 2020 2020 2020 2020 d5sum. │ │ │ │ │ +00001320: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +00001330: 206d 656e 7565 6e74 7279 3a20 2020 2020 menuentry: │ │ │ │ │ 00001340: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001350: 2020 2020 2020 206d 656e 7565 6e74 7279 menuentry │ │ │ │ │ -00001360: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ -00001370: 696e 6520 3629 0a2a 206d 6f64 756c 653a ine 6).* module: │ │ │ │ │ -00001380: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001350: 2020 2020 2020 2020 6d65 6e75 656e 7472 menuentr │ │ │ │ │ +00001360: 792e 2020 2020 2020 2020 2020 2020 2028 y. ( │ │ │ │ │ +00001370: 6c69 6e65 2036 290a 2a20 6d6f 6475 6c65 line 6).* module │ │ │ │ │ +00001380: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00001390: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000013a0: 6d6f 6475 6c65 2e20 2020 2020 2020 2020 module. │ │ │ │ │ -000013b0: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -000013c0: 2a20 6d75 6c74 6962 6f6f 743a 2020 2020 * multiboot: │ │ │ │ │ +000013a0: 206d 6f64 756c 652e 2020 2020 2020 2020 module. │ │ │ │ │ +000013b0: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +000013c0: 0a2a 206d 756c 7469 626f 6f74 3a20 2020 .* multiboot: │ │ │ │ │ 000013d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000013e0: 2020 2020 2020 2020 206d 756c 7469 626f multibo │ │ │ │ │ -000013f0: 6f74 2e20 2020 2020 2020 2020 2020 2020 ot. │ │ │ │ │ -00001400: 286c 696e 6520 3629 0a2a 206e 6174 6976 (line 6).* nativ │ │ │ │ │ -00001410: 6564 6973 6b3a 2020 2020 2020 2020 2020 edisk: │ │ │ │ │ +000013e0: 2020 2020 2020 2020 2020 6d75 6c74 6962 multib │ │ │ │ │ +000013f0: 6f6f 742e 2020 2020 2020 2020 2020 2020 oot. │ │ │ │ │ +00001400: 2028 6c69 6e65 2036 290a 2a20 6e61 7469 (line 6).* nati │ │ │ │ │ +00001410: 7665 6469 736b 3a20 2020 2020 2020 2020 vedisk: │ │ │ │ │ 00001420: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001430: 2020 6e61 7469 7665 6469 736b 2e20 2020 nativedisk. │ │ │ │ │ -00001440: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -00001450: 290a 2a20 6e65 745f 6164 645f 6164 6472 ).* net_add_addr │ │ │ │ │ -00001460: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -00001470: 2020 2020 2020 2020 2020 206e 6574 5f61 net_a │ │ │ │ │ -00001480: 6464 5f61 6464 722e 2020 2020 2020 2020 dd_addr. │ │ │ │ │ -00001490: 2020 286c 696e 6520 3629 0a2a 206e 6574 (line 6).* net │ │ │ │ │ -000014a0: 5f61 6464 5f64 6e73 3a20 2020 2020 2020 _add_dns: │ │ │ │ │ +00001430: 2020 206e 6174 6976 6564 6973 6b2e 2020 nativedisk. │ │ │ │ │ +00001440: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00001450: 3629 0a2a 206e 6574 5f61 6464 5f61 6464 6).* net_add_add │ │ │ │ │ +00001460: 723a 2020 2020 2020 2020 2020 2020 2020 r: │ │ │ │ │ +00001470: 2020 2020 2020 2020 2020 2020 6e65 745f net_ │ │ │ │ │ +00001480: 6164 645f 6164 6472 2e20 2020 2020 2020 add_addr. │ │ │ │ │ +00001490: 2020 2028 6c69 6e65 2036 290a 2a20 6e65 (line 6).* ne │ │ │ │ │ +000014a0: 745f 6164 645f 646e 733a 2020 2020 2020 t_add_dns: │ │ │ │ │ 000014b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000014c0: 2020 2020 6e65 745f 6164 645f 646e 732e net_add_dns. │ │ │ │ │ -000014d0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -000014e0: 2036 290a 2a20 6e65 745f 6164 645f 726f 6).* net_add_ro │ │ │ │ │ -000014f0: 7574 653a 2020 2020 2020 2020 2020 2020 ute: │ │ │ │ │ -00001500: 2020 2020 2020 2020 2020 2020 206e 6574 net │ │ │ │ │ -00001510: 5f61 6464 5f72 6f75 7465 2e20 2020 2020 _add_route. │ │ │ │ │ -00001520: 2020 2020 286c 696e 6520 3629 0a2a 206e (line 6).* n │ │ │ │ │ -00001530: 6574 5f62 6f6f 7470 3a20 2020 2020 2020 et_bootp: │ │ │ │ │ +000014c0: 2020 2020 206e 6574 5f61 6464 5f64 6e73 net_add_dns │ │ │ │ │ +000014d0: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ +000014e0: 6520 3629 0a2a 206e 6574 5f61 6464 5f72 e 6).* net_add_r │ │ │ │ │ +000014f0: 6f75 7465 3a20 2020 2020 2020 2020 2020 oute: │ │ │ │ │ +00001500: 2020 2020 2020 2020 2020 2020 2020 6e65 ne │ │ │ │ │ +00001510: 745f 6164 645f 726f 7574 652e 2020 2020 t_add_route. │ │ │ │ │ +00001520: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +00001530: 6e65 745f 626f 6f74 703a 2020 2020 2020 net_bootp: │ │ │ │ │ 00001540: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001550: 2020 2020 2020 6e65 745f 626f 6f74 702e net_bootp. │ │ │ │ │ -00001560: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00001570: 6e65 2036 290a 2a20 6e65 745f 6465 6c5f ne 6).* net_del_ │ │ │ │ │ -00001580: 6164 6472 3a20 2020 2020 2020 2020 2020 addr: │ │ │ │ │ -00001590: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ │ -000015a0: 6574 5f64 656c 5f61 6464 722e 2020 2020 et_del_addr. │ │ │ │ │ -000015b0: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -000015c0: 206e 6574 5f64 656c 5f64 6e73 3a20 2020 net_del_dns: │ │ │ │ │ +00001550: 2020 2020 2020 206e 6574 5f62 6f6f 7470 net_bootp │ │ │ │ │ +00001560: 2e20 2020 2020 2020 2020 2020 2020 286c . (l │ │ │ │ │ +00001570: 696e 6520 3629 0a2a 206e 6574 5f64 656c ine 6).* net_del │ │ │ │ │ +00001580: 5f61 6464 723a 2020 2020 2020 2020 2020 _addr: │ │ │ │ │ +00001590: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +000015a0: 6e65 745f 6465 6c5f 6164 6472 2e20 2020 net_del_addr. │ │ │ │ │ +000015b0: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +000015c0: 2a20 6e65 745f 6465 6c5f 646e 733a 2020 * net_del_dns: │ │ │ │ │ 000015d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000015e0: 2020 2020 2020 2020 6e65 745f 6465 6c5f net_del_ │ │ │ │ │ -000015f0: 646e 732e 2020 2020 2020 2020 2020 2028 dns. ( │ │ │ │ │ -00001600: 6c69 6e65 2036 290a 2a20 6e65 745f 6465 line 6).* net_de │ │ │ │ │ -00001610: 6c5f 726f 7574 653a 2020 2020 2020 2020 l_route: │ │ │ │ │ +000015e0: 2020 2020 2020 2020 206e 6574 5f64 656c net_del │ │ │ │ │ +000015f0: 5f64 6e73 2e20 2020 2020 2020 2020 2020 _dns. │ │ │ │ │ +00001600: 286c 696e 6520 3629 0a2a 206e 6574 5f64 (line 6).* net_d │ │ │ │ │ +00001610: 656c 5f72 6f75 7465 3a20 2020 2020 2020 el_route: │ │ │ │ │ 00001620: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001630: 206e 6574 5f64 656c 5f72 6f75 7465 2e20 net_del_route. │ │ │ │ │ -00001640: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ -00001650: 0a2a 206e 6574 5f64 6863 703a 2020 2020 .* net_dhcp: │ │ │ │ │ +00001630: 2020 6e65 745f 6465 6c5f 726f 7574 652e net_del_route. │ │ │ │ │ +00001640: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ +00001650: 290a 2a20 6e65 745f 6468 6370 3a20 2020 ).* net_dhcp: │ │ │ │ │ 00001660: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001670: 2020 2020 2020 2020 2020 6e65 745f 6468 net_dh │ │ │ │ │ -00001680: 6370 2e20 2020 2020 2020 2020 2020 2020 cp. │ │ │ │ │ -00001690: 2028 6c69 6e65 2036 290a 2a20 6e65 745f (line 6).* net_ │ │ │ │ │ -000016a0: 6765 745f 6468 6370 5f6f 7074 696f 6e3a get_dhcp_option: │ │ │ │ │ -000016b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000016c0: 2020 206e 6574 5f67 6574 5f64 6863 705f net_get_dhcp_ │ │ │ │ │ -000016d0: 6f70 7469 6f6e 2e20 2020 286c 696e 6520 option. (line │ │ │ │ │ -000016e0: 3629 0a2a 206e 6574 5f69 7076 365f 6175 6).* net_ipv6_au │ │ │ │ │ -000016f0: 746f 636f 6e66 3a20 2020 2020 2020 2020 toconf: │ │ │ │ │ -00001700: 2020 2020 2020 2020 2020 2020 6e65 745f net_ │ │ │ │ │ -00001710: 6970 7636 5f61 7574 6f63 6f6e 662e 2020 ipv6_autoconf. │ │ │ │ │ -00001720: 2020 2028 6c69 6e65 2036 290a 2a20 6e65 (line 6).* ne │ │ │ │ │ -00001730: 745f 6c73 5f61 6464 723a 2020 2020 2020 t_ls_addr: │ │ │ │ │ +00001670: 2020 2020 2020 2020 2020 206e 6574 5f64 net_d │ │ │ │ │ +00001680: 6863 702e 2020 2020 2020 2020 2020 2020 hcp. │ │ │ │ │ +00001690: 2020 286c 696e 6520 3629 0a2a 206e 6574 (line 6).* net │ │ │ │ │ +000016a0: 5f67 6574 5f64 6863 705f 6f70 7469 6f6e _get_dhcp_option │ │ │ │ │ +000016b0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +000016c0: 2020 2020 6e65 745f 6765 745f 6468 6370 net_get_dhcp │ │ │ │ │ +000016d0: 5f6f 7074 696f 6e2e 2020 2028 6c69 6e65 _option. (line │ │ │ │ │ +000016e0: 2036 290a 2a20 6e65 745f 6970 7636 5f61 6).* net_ipv6_a │ │ │ │ │ +000016f0: 7574 6f63 6f6e 663a 2020 2020 2020 2020 utoconf: │ │ │ │ │ +00001700: 2020 2020 2020 2020 2020 2020 206e 6574 net │ │ │ │ │ +00001710: 5f69 7076 365f 6175 746f 636f 6e66 2e20 _ipv6_autoconf. │ │ │ │ │ +00001720: 2020 2020 286c 696e 6520 3629 0a2a 206e (line 6).* n │ │ │ │ │ +00001730: 6574 5f6c 735f 6164 6472 3a20 2020 2020 et_ls_addr: │ │ │ │ │ 00001740: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001750: 2020 2020 206e 6574 5f6c 735f 6164 6472 net_ls_addr │ │ │ │ │ -00001760: 2e20 2020 2020 2020 2020 2020 286c 696e . (lin │ │ │ │ │ -00001770: 6520 3629 0a2a 206e 6574 5f6c 735f 6361 e 6).* net_ls_ca │ │ │ │ │ -00001780: 7264 733a 2020 2020 2020 2020 2020 2020 rds: │ │ │ │ │ -00001790: 2020 2020 2020 2020 2020 2020 2020 6e65 ne │ │ │ │ │ -000017a0: 745f 6c73 5f63 6172 6473 2e20 2020 2020 t_ls_cards. │ │ │ │ │ -000017b0: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -000017c0: 6e65 745f 6c73 5f64 6e73 3a20 2020 2020 net_ls_dns: │ │ │ │ │ +00001750: 2020 2020 2020 6e65 745f 6c73 5f61 6464 net_ls_add │ │ │ │ │ +00001760: 722e 2020 2020 2020 2020 2020 2028 6c69 r. (li │ │ │ │ │ +00001770: 6e65 2036 290a 2a20 6e65 745f 6c73 5f63 ne 6).* net_ls_c │ │ │ │ │ +00001780: 6172 6473 3a20 2020 2020 2020 2020 2020 ards: │ │ │ │ │ +00001790: 2020 2020 2020 2020 2020 2020 2020 206e n │ │ │ │ │ +000017a0: 6574 5f6c 735f 6361 7264 732e 2020 2020 et_ls_cards. │ │ │ │ │ +000017b0: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +000017c0: 206e 6574 5f6c 735f 646e 733a 2020 2020 net_ls_dns: │ │ │ │ │ 000017d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000017e0: 2020 2020 2020 206e 6574 5f6c 735f 646e net_ls_dn │ │ │ │ │ -000017f0: 732e 2020 2020 2020 2020 2020 2020 286c s. (l │ │ │ │ │ -00001800: 696e 6520 3629 0a2a 206e 6574 5f6c 735f ine 6).* net_ls_ │ │ │ │ │ -00001810: 726f 7574 6573 3a20 2020 2020 2020 2020 routes: │ │ │ │ │ +000017e0: 2020 2020 2020 2020 6e65 745f 6c73 5f64 net_ls_d │ │ │ │ │ +000017f0: 6e73 2e20 2020 2020 2020 2020 2020 2028 ns. ( │ │ │ │ │ +00001800: 6c69 6e65 2036 290a 2a20 6e65 745f 6c73 line 6).* net_ls │ │ │ │ │ +00001810: 5f72 6f75 7465 733a 2020 2020 2020 2020 _routes: │ │ │ │ │ 00001820: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001830: 6e65 745f 6c73 5f72 6f75 7465 732e 2020 net_ls_routes. │ │ │ │ │ -00001840: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -00001850: 2a20 6e65 745f 6e73 6c6f 6f6b 7570 3a20 * net_nslookup: │ │ │ │ │ +00001830: 206e 6574 5f6c 735f 726f 7574 6573 2e20 net_ls_routes. │ │ │ │ │ +00001840: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +00001850: 0a2a 206e 6574 5f6e 736c 6f6f 6b75 703a .* net_nslookup: │ │ │ │ │ 00001860: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001870: 2020 2020 2020 2020 206e 6574 5f6e 736c net_nsl │ │ │ │ │ -00001880: 6f6f 6b75 702e 2020 2020 2020 2020 2020 ookup. │ │ │ │ │ -00001890: 286c 696e 6520 3629 0a2a 206e 6f72 6d61 (line 6).* norma │ │ │ │ │ -000018a0: 6c3a 2020 2020 2020 2020 2020 2020 2020 l: │ │ │ │ │ +00001870: 2020 2020 2020 2020 2020 6e65 745f 6e73 net_ns │ │ │ │ │ +00001880: 6c6f 6f6b 7570 2e20 2020 2020 2020 2020 lookup. │ │ │ │ │ +00001890: 2028 6c69 6e65 2036 290a 2a20 6e6f 726d (line 6).* norm │ │ │ │ │ +000018a0: 616c 3a20 2020 2020 2020 2020 2020 2020 al: │ │ │ │ │ 000018b0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000018c0: 2020 6e6f 726d 616c 2e20 2020 2020 2020 normal. │ │ │ │ │ -000018d0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -000018e0: 290a 2a20 6e6f 726d 616c 5f65 7869 743a ).* normal_exit: │ │ │ │ │ -000018f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001900: 2020 2020 2020 2020 2020 206e 6f72 6d61 norma │ │ │ │ │ -00001910: 6c5f 6578 6974 2e20 2020 2020 2020 2020 l_exit. │ │ │ │ │ -00001920: 2020 286c 696e 6520 3629 0a2a 2070 6172 (line 6).* par │ │ │ │ │ -00001930: 7474 6f6f 6c3a 2020 2020 2020 2020 2020 ttool: │ │ │ │ │ +000018c0: 2020 206e 6f72 6d61 6c2e 2020 2020 2020 normal. │ │ │ │ │ +000018d0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +000018e0: 3629 0a2a 206e 6f72 6d61 6c5f 6578 6974 6).* normal_exit │ │ │ │ │ +000018f0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001900: 2020 2020 2020 2020 2020 2020 6e6f 726d norm │ │ │ │ │ +00001910: 616c 5f65 7869 742e 2020 2020 2020 2020 al_exit. │ │ │ │ │ +00001920: 2020 2028 6c69 6e65 2036 290a 2a20 7061 (line 6).* pa │ │ │ │ │ +00001930: 7274 746f 6f6c 3a20 2020 2020 2020 2020 rttool: │ │ │ │ │ 00001940: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001950: 2020 2020 7061 7274 746f 6f6c 2e20 2020 parttool. │ │ │ │ │ -00001960: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00001970: 2036 290a 2a20 7061 7373 776f 7264 3a20 6).* password: │ │ │ │ │ +00001950: 2020 2020 2070 6172 7474 6f6f 6c2e 2020 parttool. │ │ │ │ │ +00001960: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00001970: 6520 3629 0a2a 2070 6173 7377 6f72 643a e 6).* password: │ │ │ │ │ 00001980: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001990: 2020 2020 2020 2020 2020 2020 2070 6173 pas │ │ │ │ │ -000019a0: 7377 6f72 642e 2020 2020 2020 2020 2020 sword. │ │ │ │ │ -000019b0: 2020 2020 286c 696e 6520 3629 0a2a 2070 (line 6).* p │ │ │ │ │ -000019c0: 6173 7377 6f72 645f 7062 6b64 6632 3a20 assword_pbkdf2: │ │ │ │ │ +00001990: 2020 2020 2020 2020 2020 2020 2020 7061 pa │ │ │ │ │ +000019a0: 7373 776f 7264 2e20 2020 2020 2020 2020 ssword. │ │ │ │ │ +000019b0: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +000019c0: 7061 7373 776f 7264 5f70 626b 6466 323a password_pbkdf2: │ │ │ │ │ 000019d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000019e0: 2020 2020 2020 7061 7373 776f 7264 5f70 password_p │ │ │ │ │ -000019f0: 626b 6466 322e 2020 2020 2020 2028 6c69 bkdf2. (li │ │ │ │ │ -00001a00: 6e65 2036 290a 2a20 706c 6179 3a20 2020 ne 6).* play: │ │ │ │ │ +000019e0: 2020 2020 2020 2070 6173 7377 6f72 645f password_ │ │ │ │ │ +000019f0: 7062 6b64 6632 2e20 2020 2020 2020 286c pbkdf2. (l │ │ │ │ │ +00001a00: 696e 6520 3629 0a2a 2070 6c61 793a 2020 ine 6).* play: │ │ │ │ │ 00001a10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001a20: 2020 2020 2020 2020 2020 2020 2020 2070 p │ │ │ │ │ -00001a30: 6c61 792e 2020 2020 2020 2020 2020 2020 lay. │ │ │ │ │ -00001a40: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -00001a50: 2070 726f 6265 3a20 2020 2020 2020 2020 probe: │ │ │ │ │ +00001a20: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001a30: 706c 6179 2e20 2020 2020 2020 2020 2020 play. │ │ │ │ │ +00001a40: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +00001a50: 2a20 7072 6f62 653a 2020 2020 2020 2020 * probe: │ │ │ │ │ 00001a60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001a70: 2020 2020 2020 2020 7072 6f62 652e 2020 probe. │ │ │ │ │ -00001a80: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -00001a90: 6c69 6e65 2036 290a 2a20 7264 6d73 723a line 6).* rdmsr: │ │ │ │ │ -00001aa0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001a70: 2020 2020 2020 2020 2070 726f 6265 2e20 probe. │ │ │ │ │ +00001a80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001a90: 286c 696e 6520 3629 0a2a 2072 646d 7372 (line 6).* rdmsr │ │ │ │ │ +00001aa0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ 00001ab0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001ac0: 2072 646d 7372 2e20 2020 2020 2020 2020 rdmsr. │ │ │ │ │ -00001ad0: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ -00001ae0: 0a2a 2072 6561 643a 2020 2020 2020 2020 .* read: │ │ │ │ │ +00001ac0: 2020 7264 6d73 722e 2020 2020 2020 2020 rdmsr. │ │ │ │ │ +00001ad0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ +00001ae0: 290a 2a20 7265 6164 3a20 2020 2020 2020 ).* read: │ │ │ │ │ 00001af0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001b00: 2020 2020 2020 2020 2020 7265 6164 2e20 read. │ │ │ │ │ +00001b00: 2020 2020 2020 2020 2020 2072 6561 642e read. │ │ │ │ │ 00001b10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001b20: 2028 6c69 6e65 2036 290a 2a20 7265 626f (line 6).* rebo │ │ │ │ │ -00001b30: 6f74 3a20 2020 2020 2020 2020 2020 2020 ot: │ │ │ │ │ +00001b20: 2020 286c 696e 6520 3629 0a2a 2072 6562 (line 6).* reb │ │ │ │ │ +00001b30: 6f6f 743a 2020 2020 2020 2020 2020 2020 oot: │ │ │ │ │ 00001b40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001b50: 2020 2072 6562 6f6f 742e 2020 2020 2020 reboot. │ │ │ │ │ -00001b60: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ -00001b70: 3629 0a2a 2072 6567 6578 703a 2020 2020 6).* regexp: │ │ │ │ │ +00001b50: 2020 2020 7265 626f 6f74 2e20 2020 2020 reboot. │ │ │ │ │ +00001b60: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ +00001b70: 2036 290a 2a20 7265 6765 7870 3a20 2020 6).* regexp: │ │ │ │ │ 00001b80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001b90: 2020 2020 2020 2020 2020 2020 7265 6765 rege │ │ │ │ │ -00001ba0: 7870 2e20 2020 2020 2020 2020 2020 2020 xp. │ │ │ │ │ -00001bb0: 2020 2028 6c69 6e65 2036 290a 2a20 726d (line 6).* rm │ │ │ │ │ -00001bc0: 6d6f 643a 2020 2020 2020 2020 2020 2020 mod: │ │ │ │ │ +00001b90: 2020 2020 2020 2020 2020 2020 2072 6567 reg │ │ │ │ │ +00001ba0: 6578 702e 2020 2020 2020 2020 2020 2020 exp. │ │ │ │ │ +00001bb0: 2020 2020 286c 696e 6520 3629 0a2a 2072 (line 6).* r │ │ │ │ │ +00001bc0: 6d6d 6f64 3a20 2020 2020 2020 2020 2020 mmod: │ │ │ │ │ 00001bd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001be0: 2020 2020 2072 6d6d 6f64 2e20 2020 2020 rmmod. │ │ │ │ │ -00001bf0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00001c00: 6520 3629 0a2a 2073 6176 655f 656e 763a e 6).* save_env: │ │ │ │ │ -00001c10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001c20: 2020 2020 2020 2020 2020 2020 2020 7361 sa │ │ │ │ │ -00001c30: 7665 5f65 6e76 2e20 2020 2020 2020 2020 ve_env. │ │ │ │ │ -00001c40: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -00001c50: 7365 6172 6368 3a20 2020 2020 2020 2020 search: │ │ │ │ │ +00001be0: 2020 2020 2020 726d 6d6f 642e 2020 2020 rmmod. │ │ │ │ │ +00001bf0: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00001c00: 6e65 2036 290a 2a20 7361 7665 5f65 6e76 ne 6).* save_env │ │ │ │ │ +00001c10: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001c20: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ +00001c30: 6176 655f 656e 762e 2020 2020 2020 2020 ave_env. │ │ │ │ │ +00001c40: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +00001c50: 2073 6561 7263 683a 2020 2020 2020 2020 search: │ │ │ │ │ 00001c60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001c70: 2020 2020 2020 2073 6561 7263 682e 2020 search. │ │ │ │ │ -00001c80: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00001c90: 696e 6520 3629 0a2a 2073 656e 646b 6579 ine 6).* sendkey │ │ │ │ │ -00001ca0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001c70: 2020 2020 2020 2020 7365 6172 6368 2e20 search. │ │ │ │ │ +00001c80: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00001c90: 6c69 6e65 2036 290a 2a20 7365 6e64 6b65 line 6).* sendke │ │ │ │ │ +00001ca0: 793a 2020 2020 2020 2020 2020 2020 2020 y: │ │ │ │ │ 00001cb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001cc0: 7365 6e64 6b65 792e 2020 2020 2020 2020 sendkey. │ │ │ │ │ -00001cd0: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -00001ce0: 2a20 7365 7269 616c 3a20 2020 2020 2020 * serial: │ │ │ │ │ +00001cc0: 2073 656e 646b 6579 2e20 2020 2020 2020 sendkey. │ │ │ │ │ +00001cd0: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +00001ce0: 0a2a 2073 6572 6961 6c3a 2020 2020 2020 .* serial: │ │ │ │ │ 00001cf0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001d00: 2020 2020 2020 2020 2073 6572 6961 6c2e serial. │ │ │ │ │ -00001d10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001d20: 286c 696e 6520 3629 0a2a 2073 6574 3a20 (line 6).* set: │ │ │ │ │ +00001d00: 2020 2020 2020 2020 2020 7365 7269 616c serial │ │ │ │ │ +00001d10: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ +00001d20: 2028 6c69 6e65 2036 290a 2a20 7365 743a (line 6).* set: │ │ │ │ │ 00001d30: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00001d40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001d50: 2020 7365 742e 2020 2020 2020 2020 2020 set. │ │ │ │ │ -00001d60: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -00001d70: 290a 2a20 7368 6131 7375 6d3a 2020 2020 ).* sha1sum: │ │ │ │ │ +00001d50: 2020 2073 6574 2e20 2020 2020 2020 2020 set. │ │ │ │ │ +00001d60: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00001d70: 3629 0a2a 2073 6861 3173 756d 3a20 2020 6).* sha1sum: │ │ │ │ │ 00001d80: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001d90: 2020 2020 2020 2020 2020 2073 6861 3173 sha1s │ │ │ │ │ -00001da0: 756d 2e20 2020 2020 2020 2020 2020 2020 um. │ │ │ │ │ -00001db0: 2020 286c 696e 6520 3629 0a2a 2073 6861 (line 6).* sha │ │ │ │ │ -00001dc0: 3235 3673 756d 3a20 2020 2020 2020 2020 256sum: │ │ │ │ │ +00001d90: 2020 2020 2020 2020 2020 2020 7368 6131 sha1 │ │ │ │ │ +00001da0: 7375 6d2e 2020 2020 2020 2020 2020 2020 sum. │ │ │ │ │ +00001db0: 2020 2028 6c69 6e65 2036 290a 2a20 7368 (line 6).* sh │ │ │ │ │ +00001dc0: 6132 3536 7375 6d3a 2020 2020 2020 2020 a256sum: │ │ │ │ │ 00001dd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001de0: 2020 2020 7368 6132 3536 7375 6d2e 2020 sha256sum. │ │ │ │ │ -00001df0: 2020 2020 2020 2020 2020 2028 6c69 6e65 (line │ │ │ │ │ -00001e00: 2036 290a 2a20 7368 6135 3132 7375 6d3a 6).* sha512sum: │ │ │ │ │ -00001e10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001e20: 2020 2020 2020 2020 2020 2020 2073 6861 sha │ │ │ │ │ -00001e30: 3531 3273 756d 2e20 2020 2020 2020 2020 512sum. │ │ │ │ │ -00001e40: 2020 2020 286c 696e 6520 3629 0a2a 2073 (line 6).* s │ │ │ │ │ -00001e50: 6c65 6570 3a20 2020 2020 2020 2020 2020 leep: │ │ │ │ │ +00001de0: 2020 2020 2073 6861 3235 3673 756d 2e20 sha256sum. │ │ │ │ │ +00001df0: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ +00001e00: 6520 3629 0a2a 2073 6861 3531 3273 756d e 6).* sha512sum │ │ │ │ │ +00001e10: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ +00001e20: 2020 2020 2020 2020 2020 2020 2020 7368 sh │ │ │ │ │ +00001e30: 6135 3132 7375 6d2e 2020 2020 2020 2020 a512sum. │ │ │ │ │ +00001e40: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ +00001e50: 736c 6565 703a 2020 2020 2020 2020 2020 sleep: │ │ │ │ │ 00001e60: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001e70: 2020 2020 2020 736c 6565 702e 2020 2020 sleep. │ │ │ │ │ -00001e80: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ -00001e90: 6e65 2036 290a 2a20 736d 6269 6f73 3a20 ne 6).* smbios: │ │ │ │ │ +00001e70: 2020 2020 2020 2073 6c65 6570 2e20 2020 sleep. │ │ │ │ │ +00001e80: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ +00001e90: 696e 6520 3629 0a2a 2073 6d62 696f 733a ine 6).* smbios: │ │ │ │ │ 00001ea0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001eb0: 2020 2020 2020 2020 2020 2020 2020 2073 s │ │ │ │ │ -00001ec0: 6d62 696f 732e 2020 2020 2020 2020 2020 mbios. │ │ │ │ │ -00001ed0: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ -00001ee0: 2073 6f75 7263 653a 2020 2020 2020 2020 source: │ │ │ │ │ +00001eb0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001ec0: 736d 6269 6f73 2e20 2020 2020 2020 2020 smbios. │ │ │ │ │ +00001ed0: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ +00001ee0: 2a20 736f 7572 6365 3a20 2020 2020 2020 * source: │ │ │ │ │ 00001ef0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001f00: 2020 2020 2020 2020 736f 7572 6365 2e20 source. │ │ │ │ │ -00001f10: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ -00001f20: 6c69 6e65 2036 290a 2a20 7375 626d 656e line 6).* submen │ │ │ │ │ -00001f30: 753a 2020 2020 2020 2020 2020 2020 2020 u: │ │ │ │ │ +00001f00: 2020 2020 2020 2020 2073 6f75 7263 652e source. │ │ │ │ │ +00001f10: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ +00001f20: 286c 696e 6520 3629 0a2a 2073 7562 6d65 (line 6).* subme │ │ │ │ │ +00001f30: 6e75 3a20 2020 2020 2020 2020 2020 2020 nu: │ │ │ │ │ 00001f40: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001f50: 2073 7562 6d65 6e75 2e20 2020 2020 2020 submenu. │ │ │ │ │ -00001f60: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ -00001f70: 0a2a 2074 6572 6d69 6e61 6c5f 696e 7075 .* terminal_inpu │ │ │ │ │ -00001f80: 743a 2020 2020 2020 2020 2020 2020 2020 t: │ │ │ │ │ -00001f90: 2020 2020 2020 2020 2020 7465 726d 696e termin │ │ │ │ │ -00001fa0: 616c 5f69 6e70 7574 2e20 2020 2020 2020 al_input. │ │ │ │ │ -00001fb0: 2028 6c69 6e65 2036 290a 2a20 7465 726d (line 6).* term │ │ │ │ │ -00001fc0: 696e 616c 5f6f 7574 7075 743a 2020 2020 inal_output: │ │ │ │ │ +00001f50: 2020 7375 626d 656e 752e 2020 2020 2020 submenu. │ │ │ │ │ +00001f60: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ +00001f70: 290a 2a20 7465 726d 696e 616c 5f69 6e70 ).* terminal_inp │ │ │ │ │ +00001f80: 7574 3a20 2020 2020 2020 2020 2020 2020 ut: │ │ │ │ │ +00001f90: 2020 2020 2020 2020 2020 2074 6572 6d69 termi │ │ │ │ │ +00001fa0: 6e61 6c5f 696e 7075 742e 2020 2020 2020 nal_input. │ │ │ │ │ +00001fb0: 2020 286c 696e 6520 3629 0a2a 2074 6572 (line 6).* ter │ │ │ │ │ +00001fc0: 6d69 6e61 6c5f 6f75 7470 7574 3a20 2020 minal_output: │ │ │ │ │ 00001fd0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00001fe0: 2020 2074 6572 6d69 6e61 6c5f 6f75 7470 terminal_outp │ │ │ │ │ -00001ff0: 7574 2e20 2020 2020 2020 286c 696e 6520 ut. (line │ │ │ │ │ -00002000: 3629 0a2a 2074 6572 6d69 6e66 6f3a 2020 6).* terminfo: │ │ │ │ │ +00001fe0: 2020 2020 7465 726d 696e 616c 5f6f 7574 terminal_out │ │ │ │ │ +00001ff0: 7075 742e 2020 2020 2020 2028 6c69 6e65 put. (line │ │ │ │ │ +00002000: 2036 290a 2a20 7465 726d 696e 666f 3a20 6).* terminfo: │ │ │ │ │ 00002010: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002020: 2020 2020 2020 2020 2020 2020 7465 726d term │ │ │ │ │ -00002030: 696e 666f 2e20 2020 2020 2020 2020 2020 info. │ │ │ │ │ -00002040: 2020 2028 6c69 6e65 2036 290a 2a20 7465 (line 6).* te │ │ │ │ │ -00002050: 7374 3a20 2020 2020 2020 2020 2020 2020 st: │ │ │ │ │ +00002020: 2020 2020 2020 2020 2020 2020 2074 6572 ter │ │ │ │ │ +00002030: 6d69 6e66 6f2e 2020 2020 2020 2020 2020 minfo. │ │ │ │ │ +00002040: 2020 2020 286c 696e 6520 3629 0a2a 2074 (line 6).* t │ │ │ │ │ +00002050: 6573 743a 2020 2020 2020 2020 2020 2020 est: │ │ │ │ │ 00002060: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002070: 2020 2020 2074 6573 742e 2020 2020 2020 test. │ │ │ │ │ -00002080: 2020 2020 2020 2020 2020 2020 286c 696e (lin │ │ │ │ │ -00002090: 6520 3629 0a2a 2074 7275 653a 2020 2020 e 6).* true: │ │ │ │ │ +00002070: 2020 2020 2020 7465 7374 2e20 2020 2020 test. │ │ │ │ │ +00002080: 2020 2020 2020 2020 2020 2020 2028 6c69 (li │ │ │ │ │ +00002090: 6e65 2036 290a 2a20 7472 7565 3a20 2020 ne 6).* true: │ │ │ │ │ 000020a0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000020b0: 2020 2020 2020 2020 2020 2020 2020 7472 tr │ │ │ │ │ -000020c0: 7565 2e20 2020 2020 2020 2020 2020 2020 ue. │ │ │ │ │ -000020d0: 2020 2020 2028 6c69 6e65 2036 290a 2a20 (line 6).* │ │ │ │ │ -000020e0: 7472 7573 743a 2020 2020 2020 2020 2020 trust: │ │ │ │ │ +000020b0: 2020 2020 2020 2020 2020 2020 2020 2074 t │ │ │ │ │ +000020c0: 7275 652e 2020 2020 2020 2020 2020 2020 rue. │ │ │ │ │ +000020d0: 2020 2020 2020 286c 696e 6520 3629 0a2a (line 6).* │ │ │ │ │ +000020e0: 2074 7275 7374 3a20 2020 2020 2020 2020 trust: │ │ │ │ │ 000020f0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002100: 2020 2020 2020 2074 7275 7374 2e20 2020 trust. │ │ │ │ │ -00002110: 2020 2020 2020 2020 2020 2020 2020 286c (l │ │ │ │ │ -00002120: 696e 6520 3629 0a2a 2075 6e73 6574 3a20 ine 6).* unset: │ │ │ │ │ +00002100: 2020 2020 2020 2020 7472 7573 742e 2020 trust. │ │ │ │ │ +00002110: 2020 2020 2020 2020 2020 2020 2020 2028 ( │ │ │ │ │ +00002120: 6c69 6e65 2036 290a 2a20 756e 7365 743a line 6).* unset: │ │ │ │ │ 00002130: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ 00002140: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002150: 756e 7365 742e 2020 2020 2020 2020 2020 unset. │ │ │ │ │ -00002160: 2020 2020 2020 2028 6c69 6e65 2036 290a (line 6). │ │ │ │ │ -00002170: 2a20 7665 7269 6679 5f64 6574 6163 6865 * verify_detache │ │ │ │ │ -00002180: 643a 2020 2020 2020 2020 2020 2020 2020 d: │ │ │ │ │ -00002190: 2020 2020 2020 2020 2076 6572 6966 795f verify_ │ │ │ │ │ -000021a0: 6465 7461 6368 6564 2e20 2020 2020 2020 detached. │ │ │ │ │ -000021b0: 286c 696e 6520 3629 0a2a 2076 6964 656f (line 6).* video │ │ │ │ │ -000021c0: 696e 666f 3a20 2020 2020 2020 2020 2020 info: │ │ │ │ │ +00002150: 2075 6e73 6574 2e20 2020 2020 2020 2020 unset. │ │ │ │ │ +00002160: 2020 2020 2020 2020 286c 696e 6520 3629 (line 6) │ │ │ │ │ +00002170: 0a2a 2076 6572 6966 795f 6465 7461 6368 .* verify_detach │ │ │ │ │ +00002180: 6564 3a20 2020 2020 2020 2020 2020 2020 ed: │ │ │ │ │ +00002190: 2020 2020 2020 2020 2020 7665 7269 6679 verify │ │ │ │ │ +000021a0: 5f64 6574 6163 6865 642e 2020 2020 2020 _detached. │ │ │ │ │ +000021b0: 2028 6c69 6e65 2036 290a 2a20 7669 6465 (line 6).* vide │ │ │ │ │ +000021c0: 6f69 6e66 6f3a 2020 2020 2020 2020 2020 oinfo: │ │ │ │ │ 000021d0: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -000021e0: 2020 7669 6465 6f69 6e66 6f2e 2020 2020 videoinfo. │ │ │ │ │ -000021f0: 2020 2020 2020 2020 2028 6c69 6e65 2036 (line 6 │ │ │ │ │ -00002200: 290a 2a20 7772 6d73 723a 2020 2020 2020 ).* wrmsr: │ │ │ │ │ +000021e0: 2020 2076 6964 656f 696e 666f 2e20 2020 videoinfo. │ │ │ │ │ +000021f0: 2020 2020 2020 2020 2020 286c 696e 6520 (line │ │ │ │ │ +00002200: 3629 0a2a 2077 726d 7372 3a20 2020 2020 6).* wrmsr: │ │ │ │ │ 00002210: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002220: 2020 2020 2020 2020 2020 2077 726d 7372 wrmsr │ │ │ │ │ -00002230: 2e20 2020 2020 2020 2020 2020 2020 2020 . │ │ │ │ │ -00002240: 2020 286c 696e 6520 3629 0a2a 2078 656e (line 6).* xen │ │ │ │ │ -00002250: 5f68 7970 6572 7669 736f 723a 2020 2020 _hypervisor: │ │ │ │ │ +00002220: 2020 2020 2020 2020 2020 2020 7772 6d73 wrms │ │ │ │ │ +00002230: 722e 2020 2020 2020 2020 2020 2020 2020 r. │ │ │ │ │ +00002240: 2020 2028 6c69 6e65 2036 290a 2a20 7865 (line 6).* xe │ │ │ │ │ +00002250: 6e5f 6879 7065 7276 6973 6f72 3a20 2020 n_hypervisor: │ │ │ │ │ 00002260: 2020 2020 2020 2020 2020 2020 2020 2020 │ │ │ │ │ -00002270: 2020 2020 7865 6e5f 6879 7065 7276 6973 xen_hypervis │ │ │ │ │ -00002280: 6f72 2e20 2020 2020 2020 2028 6c69 6e65 or. (line │ │ │ │ │ -00002290: 2036 290a 2a20 7865 6e5f 6d6f 6475 6c65 6).* xen_module │ │ │ │ │ -000022a0: 3a20 2020 2020 2020 2020 2020 2020 2020 : │ │ │ │ │ -000022b0: 2020 2020 2020 2020 2020 2020 2078 656e xen │ │ │ │ │ -000022c0: 5f6d 6f64 756c 652e 2020 2020 2020 2020 _module. │ │ │ │ │ -000022d0: 2020 2020 286c 696e 6520 3629 0a0a (line 6).. │ │ │ │ │ +00002270: 2020 2020 2078 656e 5f68 7970 6572 7669 xen_hypervi │ │ │ │ │ +00002280: 736f 722e 2020 2020 2020 2020 286c 696e sor. (lin │ │ │ │ │ +00002290: 6520 3629 0a2a 2078 656e 5f6d 6f64 756c e 6).* xen_modul │ │ │ │ │ +000022a0: 653a 2020 2020 2020 2020 2020 2020 2020 e: │ │ │ │ │ +000022b0: 2020 2020 2020 2020 2020 2020 2020 7865 xe │ │ │ │ │ +000022c0: 6e5f 6d6f 6475 6c65 2e20 2020 2020 2020 n_module. │ │ │ │ │ +000022d0: 2020 2020 2028 6c69 6e65 2036 290a 0a (line 6).. │ │ │ ├── ./usr/share/info/grub.info.gz │ │ │ │ ├── grub.info │ │ │ │ │ @@ -1,510 +1,510 @@ │ │ │ │ │ 00000000: 5468 6973 2069 7320 6772 7562 2e69 6e66 This is grub.inf │ │ │ │ │ 00000010: 6f2c 2070 726f 6475 6365 6420 6279 206d o, produced by m │ │ │ │ │ 00000020: 616b 6569 6e66 6f20 7665 7273 696f 6e20 akeinfo version │ │ │ │ │ 00000030: 362e 3820 6672 6f6d 2067 7275 622e 7465 6.8 from grub.te │ │ │ │ │ 00000040: 7869 2e0a 0a54 6869 7320 6d61 6e75 616c xi...This manual │ │ │ │ │ 00000050: 2069 7320 666f 7220 474e 5520 4752 5542 is for GNU GRUB │ │ │ │ │ 00000060: 2028 7665 7273 696f 6e20 322e 3036 2c20 (version 2.06, │ │ │ │ │ -00000070: 3720 4a61 6e75 6172 7920 3230 3234 292e 7 January 2024). │ │ │ │ │ -00000080: 0a0a 2020 2043 6f70 7972 6967 6874 2028 .. Copyright ( │ │ │ │ │ -00000090: 4329 0a31 3939 392c 3230 3030 2c32 3030 C).1999,2000,200 │ │ │ │ │ -000000a0: 312c 3230 3032 2c32 3030 342c 3230 3036 1,2002,2004,2006 │ │ │ │ │ -000000b0: 2c32 3030 382c 3230 3039 2c32 3031 302c ,2008,2009,2010, │ │ │ │ │ -000000c0: 3230 3131 2c32 3031 322c 3230 3133 2046 2011,2012,2013 F │ │ │ │ │ -000000d0: 7265 650a 536f 6674 7761 7265 2046 6f75 ree.Software Fou │ │ │ │ │ -000000e0: 6e64 6174 696f 6e2c 2049 6e63 2e0a 0a20 ndation, Inc... │ │ │ │ │ -000000f0: 2020 2020 5065 726d 6973 7369 6f6e 2069 Permission i │ │ │ │ │ -00000100: 7320 6772 616e 7465 6420 746f 2063 6f70 s granted to cop │ │ │ │ │ -00000110: 792c 2064 6973 7472 6962 7574 6520 616e y, distribute an │ │ │ │ │ -00000120: 642f 6f72 206d 6f64 6966 7920 7468 6973 d/or modify this │ │ │ │ │ -00000130: 0a20 2020 2020 646f 6375 6d65 6e74 2075 . document u │ │ │ │ │ -00000140: 6e64 6572 2074 6865 2074 6572 6d73 206f nder the terms o │ │ │ │ │ -00000150: 6620 7468 6520 474e 5520 4672 6565 2044 f the GNU Free D │ │ │ │ │ -00000160: 6f63 756d 656e 7461 7469 6f6e 204c 6963 ocumentation Lic │ │ │ │ │ -00000170: 656e 7365 2c0a 2020 2020 2056 6572 7369 ense,. Versi │ │ │ │ │ -00000180: 6f6e 2031 2e32 206f 7220 616e 7920 6c61 on 1.2 or any la │ │ │ │ │ -00000190: 7465 7220 7665 7273 696f 6e20 7075 626c ter version publ │ │ │ │ │ -000001a0: 6973 6865 6420 6279 2074 6865 2046 7265 ished by the Fre │ │ │ │ │ -000001b0: 6520 536f 6674 7761 7265 0a20 2020 2020 e Software. │ │ │ │ │ -000001c0: 466f 756e 6461 7469 6f6e 3b20 7769 7468 Foundation; with │ │ │ │ │ -000001d0: 206e 6f20 496e 7661 7269 616e 7420 5365 no Invariant Se │ │ │ │ │ -000001e0: 6374 696f 6e73 2e0a 494e 464f 2d44 4952 ctions..INFO-DIR │ │ │ │ │ -000001f0: 2d53 4543 5449 4f4e 204b 6572 6e65 6c0a -SECTION Kernel. │ │ │ │ │ -00000200: 5354 4152 542d 494e 464f 2d44 4952 2d45 START-INFO-DIR-E │ │ │ │ │ -00000210: 4e54 5259 0a2a 2047 5255 423a 2028 6772 NTRY.* GRUB: (gr │ │ │ │ │ -00000220: 7562 292e 2020 2020 2020 2020 2020 2020 ub). │ │ │ │ │ -00000230: 2020 2020 2054 6865 2047 5261 6e64 2055 The GRand U │ │ │ │ │ -00000240: 6e69 6669 6564 2042 6f6f 746c 6f61 6465 nified Bootloade │ │ │ │ │ -00000250: 720a 2a20 6772 7562 2d69 6e73 7461 6c6c r.* grub-install │ │ │ │ │ -00000260: 3a20 2867 7275 6229 496e 766f 6b69 6e67 : (grub)Invoking │ │ │ │ │ -00000270: 2067 7275 622d 696e 7374 616c 6c2e 2020 grub-install. │ │ │ │ │ -00000280: 2020 496e 7374 616c 6c20 4752 5542 206f Install GRUB o │ │ │ │ │ -00000290: 6e20 796f 7572 2064 7269 7665 0a2a 2067 n your drive.* g │ │ │ │ │ -000002a0: 7275 622d 6d6b 636f 6e66 6967 3a20 2867 rub-mkconfig: (g │ │ │ │ │ -000002b0: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ -000002c0: 622d 6d6b 636f 6e66 6967 2e20 2047 656e b-mkconfig. Gen │ │ │ │ │ -000002d0: 6572 6174 6520 4752 5542 2063 6f6e 6669 erate GRUB confi │ │ │ │ │ -000002e0: 6775 7261 7469 6f6e 0a2a 2067 7275 622d guration.* grub- │ │ │ │ │ -000002f0: 6d6b 7061 7373 7764 2d70 626b 6466 323a mkpasswd-pbkdf2: │ │ │ │ │ -00000300: 2028 6772 7562 2949 6e76 6f6b 696e 6720 (grub)Invoking │ │ │ │ │ -00000310: 6772 7562 2d6d 6b70 6173 7377 642d 7062 grub-mkpasswd-pb │ │ │ │ │ -00000320: 6b64 6632 2e0a 2a20 6772 7562 2d6d 6b72 kdf2..* grub-mkr │ │ │ │ │ -00000330: 656c 7061 7468 3a20 2867 7275 6229 496e elpath: (grub)In │ │ │ │ │ -00000340: 766f 6b69 6e67 2067 7275 622d 6d6b 7265 voking grub-mkre │ │ │ │ │ -00000350: 6c70 6174 682e 0a2a 2067 7275 622d 6d6b lpath..* grub-mk │ │ │ │ │ -00000360: 7265 7363 7565 3a20 2867 7275 6229 496e rescue: (grub)In │ │ │ │ │ -00000370: 766f 6b69 6e67 2067 7275 622d 6d6b 7265 voking grub-mkre │ │ │ │ │ -00000380: 7363 7565 2e20 204d 616b 6520 6120 4752 scue. Make a GR │ │ │ │ │ -00000390: 5542 2072 6573 6375 6520 696d 6167 650a UB rescue image. │ │ │ │ │ -000003a0: 2a20 6772 7562 2d6d 6f75 6e74 3a20 2867 * grub-mount: (g │ │ │ │ │ -000003b0: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ -000003c0: 622d 6d6f 756e 742e 2020 2020 2020 2020 b-mount. │ │ │ │ │ -000003d0: 4d6f 756e 7420 6120 6669 6c65 2073 7973 Mount a file sys │ │ │ │ │ -000003e0: 7465 6d20 7573 696e 6720 4752 5542 0a2a tem using GRUB.* │ │ │ │ │ -000003f0: 2067 7275 622d 7072 6f62 653a 2028 6772 grub-probe: (gr │ │ │ │ │ -00000400: 7562 2949 6e76 6f6b 696e 6720 6772 7562 ub)Invoking grub │ │ │ │ │ -00000410: 2d70 726f 6265 2e20 2020 2020 2020 2050 -probe. P │ │ │ │ │ -00000420: 726f 6265 2064 6576 6963 6520 696e 666f robe device info │ │ │ │ │ -00000430: 726d 6174 696f 6e0a 2a20 6772 7562 2d73 rmation.* grub-s │ │ │ │ │ -00000440: 6372 6970 742d 6368 6563 6b3a 2028 6772 cript-check: (gr │ │ │ │ │ -00000450: 7562 2949 6e76 6f6b 696e 6720 6772 7562 ub)Invoking grub │ │ │ │ │ -00000460: 2d73 6372 6970 742d 6368 6563 6b2e 0a45 -script-check..E │ │ │ │ │ -00000470: 4e44 2d49 4e46 4f2d 4449 522d 454e 5452 ND-INFO-DIR-ENTR │ │ │ │ │ -00000480: 590a 0a1f 0a49 6e64 6972 6563 743a 0a67 Y....Indirect:.g │ │ │ │ │ -00000490: 7275 622e 696e 666f 2d31 3a20 3131 3535 rub.info-1: 1155 │ │ │ │ │ -000004a0: 0a67 7275 622e 696e 666f 2d32 3a20 3331 .grub.info-2: 31 │ │ │ │ │ -000004b0: 3234 3332 0a1f 0a54 6167 2054 6162 6c65 2432...Tag Table │ │ │ │ │ -000004c0: 3a0a 2849 6e64 6972 6563 7429 0a4e 6f64 :.(Indirect).Nod │ │ │ │ │ -000004d0: 653a 2054 6f70 7f31 3135 350a 4e6f 6465 e: Top.1155.Node │ │ │ │ │ -000004e0: 3a20 496e 7472 6f64 7563 7469 6f6e 7f34 : Introduction.4 │ │ │ │ │ -000004f0: 3230 350a 4e6f 6465 3a20 4f76 6572 7669 205.Node: Overvi │ │ │ │ │ -00000500: 6577 7f34 3634 390a 4e6f 6465 3a20 4f76 ew.4649.Node: Ov │ │ │ │ │ -00000510: 6572 7669 6577 2d46 6f6f 746e 6f74 6573 erview-Footnotes │ │ │ │ │ -00000520: 7f36 3633 390a 5265 663a 204f 7665 7276 .6639.Ref: Overv │ │ │ │ │ -00000530: 6965 772d 466f 6f74 6e6f 7465 2d31 7f36 iew-Footnote-1.6 │ │ │ │ │ -00000540: 3730 300a 4e6f 6465 3a20 4869 7374 6f72 700.Node: Histor │ │ │ │ │ -00000550: 797f 3638 3632 0a4e 6f64 653a 2043 6861 y.6862.Node: Cha │ │ │ │ │ -00000560: 6e67 6573 2066 726f 6d20 4752 5542 204c nges from GRUB L │ │ │ │ │ -00000570: 6567 6163 797f 3839 3532 0a4e 6f64 653a egacy.8952.Node: │ │ │ │ │ -00000580: 2046 6561 7475 7265 737f 3131 3432 380a Features.11428. │ │ │ │ │ -00000590: 4e6f 6465 3a20 4665 6174 7572 6573 2d46 Node: Features-F │ │ │ │ │ -000005a0: 6f6f 746e 6f74 6573 7f31 3738 3535 0a52 ootnotes.17855.R │ │ │ │ │ -000005b0: 6566 3a20 4665 6174 7572 6573 2d46 6f6f ef: Features-Foo │ │ │ │ │ -000005c0: 746e 6f74 652d 317f 3137 3931 360a 5265 tnote-1.17916.Re │ │ │ │ │ -000005d0: 663a 2046 6561 7475 7265 732d 466f 6f74 f: Features-Foot │ │ │ │ │ -000005e0: 6e6f 7465 2d32 7f31 3830 3132 0a52 6566 note-2.18012.Ref │ │ │ │ │ -000005f0: 3a20 4665 6174 7572 6573 2d46 6f6f 746e : Features-Footn │ │ │ │ │ -00000600: 6f74 652d 337f 3138 3135 390a 4e6f 6465 ote-3.18159.Node │ │ │ │ │ -00000610: 3a20 526f 6c65 206f 6620 6120 626f 6f74 : Role of a boot │ │ │ │ │ -00000620: 206c 6f61 6465 727f 3138 3330 340a 4e6f loader.18304.No │ │ │ │ │ -00000630: 6465 3a20 526f 6c65 206f 6620 6120 626f de: Role of a bo │ │ │ │ │ -00000640: 6f74 206c 6f61 6465 722d 466f 6f74 6e6f ot loader-Footno │ │ │ │ │ -00000650: 7465 737f 3139 3634 330a 5265 663a 2052 tes.19643.Ref: R │ │ │ │ │ -00000660: 6f6c 6520 6f66 2061 2062 6f6f 7420 6c6f ole of a boot lo │ │ │ │ │ -00000670: 6164 6572 2d46 6f6f 746e 6f74 652d 317f ader-Footnote-1. │ │ │ │ │ -00000680: 3139 3733 300a 4e6f 6465 3a20 4e61 6d69 19730.Node: Nami │ │ │ │ │ -00000690: 6e67 2063 6f6e 7665 6e74 696f 6e7f 3139 ng convention.19 │ │ │ │ │ -000006a0: 3830 390a 4e6f 6465 3a20 4f53 2d73 7065 809.Node: OS-spe │ │ │ │ │ -000006b0: 6369 6669 6320 6e6f 7465 7320 6162 6f75 cific notes abou │ │ │ │ │ -000006c0: 7420 6772 7562 2074 6f6f 6c73 7f32 3237 t grub tools.227 │ │ │ │ │ -000006d0: 3230 0a4e 6f64 653a 2049 6e73 7461 6c6c 20.Node: Install │ │ │ │ │ -000006e0: 6174 696f 6e7f 3233 3735 360a 4e6f 6465 ation.23756.Node │ │ │ │ │ -000006f0: 3a20 496e 7374 616c 6c69 6e67 2047 5255 : Installing GRU │ │ │ │ │ -00000700: 4220 7573 696e 6720 6772 7562 2d69 6e73 B using grub-ins │ │ │ │ │ -00000710: 7461 6c6c 7f32 3438 3738 0a4e 6f64 653a tall.24878.Node: │ │ │ │ │ -00000720: 204d 616b 696e 6720 6120 4752 5542 2062 Making a GRUB b │ │ │ │ │ -00000730: 6f6f 7461 626c 6520 4344 2d52 4f4d 7f32 ootable CD-ROM.2 │ │ │ │ │ -00000740: 3731 3933 0a4e 6f64 653a 204d 616b 696e 7193.Node: Makin │ │ │ │ │ -00000750: 6720 6120 4752 5542 2062 6f6f 7461 626c g a GRUB bootabl │ │ │ │ │ -00000760: 6520 4344 2d52 4f4d 2d46 6f6f 746e 6f74 e CD-ROM-Footnot │ │ │ │ │ -00000770: 6573 7f32 3930 3532 0a52 6566 3a20 4d61 es.29052.Ref: Ma │ │ │ │ │ -00000780: 6b69 6e67 2061 2047 5255 4220 626f 6f74 king a GRUB boot │ │ │ │ │ -00000790: 6162 6c65 2043 442d 524f 4d2d 466f 6f74 able CD-ROM-Foot │ │ │ │ │ -000007a0: 6e6f 7465 2d31 7f32 3931 3535 0a4e 6f64 note-1.29155.Nod │ │ │ │ │ -000007b0: 653a 2044 6576 6963 6520 6d61 707f 3239 e: Device map.29 │ │ │ │ │ -000007c0: 3233 300a 4e6f 6465 3a20 4249 4f53 2069 230.Node: BIOS i │ │ │ │ │ -000007d0: 6e73 7461 6c6c 6174 696f 6e7f 3331 3139 nstallation.3119 │ │ │ │ │ -000007e0: 370a 4e6f 6465 3a20 426f 6f74 696e 677f 7.Node: Booting. │ │ │ │ │ -000007f0: 3335 3634 380a 4e6f 6465 3a20 4765 6e65 35648.Node: Gene │ │ │ │ │ -00000800: 7261 6c20 626f 6f74 206d 6574 686f 6473 ral boot methods │ │ │ │ │ -00000810: 7f33 3631 3833 0a4e 6f64 653a 204c 6f61 .36183.Node: Loa │ │ │ │ │ -00000820: 6469 6e67 2061 6e20 6f70 6572 6174 696e ding an operatin │ │ │ │ │ -00000830: 6720 7379 7374 656d 2064 6972 6563 746c g system directl │ │ │ │ │ -00000840: 797f 3336 3932 360a 4e6f 6465 3a20 4368 y.36926.Node: Ch │ │ │ │ │ -00000850: 6169 6e2d 6c6f 6164 696e 677f 3337 3635 ain-loading.3765 │ │ │ │ │ -00000860: 370a 4e6f 6465 3a20 4c6f 6f70 6261 636b 7.Node: Loopback │ │ │ │ │ -00000870: 2062 6f6f 7469 6e67 7f33 3836 3238 0a4e booting.38628.N │ │ │ │ │ -00000880: 6f64 653a 204c 564d 2063 6163 6865 2062 ode: LVM cache b │ │ │ │ │ -00000890: 6f6f 7469 6e67 7f34 3033 3032 0a4e 6f64 ooting.40302.Nod │ │ │ │ │ -000008a0: 653a 204f 532d 7370 6563 6966 6963 206e e: OS-specific n │ │ │ │ │ -000008b0: 6f74 6573 7f34 3135 3638 0a4e 6f64 653a otes.41568.Node: │ │ │ │ │ -000008c0: 2047 4e55 2f48 7572 647f 3431 3835 380a GNU/Hurd.41858. │ │ │ │ │ -000008d0: 4e6f 6465 3a20 474e 552f 4c69 6e75 787f Node: GNU/Linux. │ │ │ │ │ -000008e0: 3432 3938 310a 4e6f 6465 3a20 4e65 7442 42981.Node: NetB │ │ │ │ │ -000008f0: 5344 7f34 3432 3939 0a4e 6f64 653a 2044 SD.44299.Node: D │ │ │ │ │ -00000900: 4f53 2f57 696e 646f 7773 7f34 3537 3733 OS/Windows.45773 │ │ │ │ │ -00000910: 0a4e 6f64 653a 2043 6f6e 6669 6775 7261 .Node: Configura │ │ │ │ │ -00000920: 7469 6f6e 7f34 3735 3531 0a4e 6f64 653a tion.47551.Node: │ │ │ │ │ -00000930: 2053 696d 706c 6520 636f 6e66 6967 7572 Simple configur │ │ │ │ │ -00000940: 6174 696f 6e7f 3438 3236 330a 4e6f 6465 ation.48263.Node │ │ │ │ │ -00000950: 3a20 526f 6f74 2049 6465 6e74 6966 6361 : Root Identifca │ │ │ │ │ -00000960: 7469 6f6e 2048 6575 7269 7374 6963 737f tion Heuristics. │ │ │ │ │ -00000970: 3635 3731 330a 4e6f 6465 3a20 5368 656c 65713.Node: Shel │ │ │ │ │ -00000980: 6c2d 6c69 6b65 2073 6372 6970 7469 6e67 l-like scripting │ │ │ │ │ -00000990: 7f36 3837 3237 0a4e 6f64 653a 2053 6865 .68727.Node: She │ │ │ │ │ -000009a0: 6c6c 2d6c 696b 6520 7363 7269 7074 696e ll-like scriptin │ │ │ │ │ -000009b0: 672d 466f 6f74 6e6f 7465 737f 3736 3739 g-Footnotes.7679 │ │ │ │ │ -000009c0: 300a 5265 663a 2053 6865 6c6c 2d6c 696b 0.Ref: Shell-lik │ │ │ │ │ -000009d0: 6520 7363 7269 7074 696e 672d 466f 6f74 e scripting-Foot │ │ │ │ │ -000009e0: 6e6f 7465 2d31 7f37 3638 3735 0a4e 6f64 note-1.76875.Nod │ │ │ │ │ -000009f0: 653a 204d 756c 7469 2d62 6f6f 7420 6d61 e: Multi-boot ma │ │ │ │ │ -00000a00: 6e75 616c 2063 6f6e 6669 677f 3737 3030 nual config.7700 │ │ │ │ │ -00000a10: 320a 4e6f 6465 3a20 456d 6265 6464 6564 2.Node: Embedded │ │ │ │ │ -00000a20: 2063 6f6e 6669 6775 7261 7469 6f6e 7f38 configuration.8 │ │ │ │ │ -00000a30: 3036 3131 0a4e 6f64 653a 2054 6865 6d65 0611.Node: Theme │ │ │ │ │ -00000a40: 2066 696c 6520 666f 726d 6174 7f38 3334 file format.834 │ │ │ │ │ -00000a50: 3437 0a52 6566 3a20 5069 786d 6170 2d73 47.Ref: Pixmap-s │ │ │ │ │ -00000a60: 7479 6c65 6420 7072 6f67 7265 7373 2062 tyled progress b │ │ │ │ │ -00000a70: 6172 7f38 3439 3036 0a52 6566 3a20 506c ar.84906.Ref: Pl │ │ │ │ │ -00000a80: 6169 6e20 7072 6f67 7265 7373 2062 6172 ain progress bar │ │ │ │ │ -00000a90: 2c20 6472 6177 6e20 7769 7468 2073 6f6c , drawn with sol │ │ │ │ │ -00000aa0: 6964 2063 6f6c 6f72 2e7f 3834 3931 380a id color..84918. │ │ │ │ │ -00000ab0: 5265 663a 2041 6e20 6578 616d 706c 6520 Ref: An example │ │ │ │ │ -00000ac0: 6f66 2074 6865 2073 6c69 6365 7320 2869 of the slices (i │ │ │ │ │ -00000ad0: 6e20 7265 6429 2075 7365 6420 666f 7220 n red) used for │ │ │ │ │ -00000ae0: 6120 7465 726d 696e 616c 2077 696e 646f a terminal windo │ │ │ │ │ -00000af0: 772e 2054 6869 7320 6472 6177 696e 6720 w. This drawing │ │ │ │ │ -00000b00: 7761 7320 6372 6561 7465 6420 616e 6420 was created and │ │ │ │ │ -00000b10: 736c 6963 6564 2069 6e20 496e 6b73 6361 sliced in Inksca │ │ │ │ │ -00000b20: 7065 5f2c 2061 7320 7468 6520 6e65 7874 pe_, as the next │ │ │ │ │ -00000b30: 2073 6563 7469 6f6e 2065 7870 6c61 696e section explain │ │ │ │ │ -00000b40: 732e 7f38 3834 3130 0a4e 6f64 653a 204e s..88410.Node: N │ │ │ │ │ -00000b50: 6574 776f 726b 7f31 3038 3832 320a 4e6f etwork.108822.No │ │ │ │ │ -00000b60: 6465 3a20 5365 7269 616c 2074 6572 6d69 de: Serial termi │ │ │ │ │ -00000b70: 6e61 6c7f 3131 3331 3336 0a4e 6f64 653a nal.113136.Node: │ │ │ │ │ -00000b80: 2056 656e 646f 7220 706f 7765 722d 6f6e Vendor power-on │ │ │ │ │ -00000b90: 206b 6579 737f 3131 3533 3733 0a4e 6f64 keys.115373.Nod │ │ │ │ │ -00000ba0: 653a 2049 6d61 6765 737f 3131 3733 3038 e: Images.117308 │ │ │ │ │ -00000bb0: 0a4e 6f64 653a 2043 6f72 6520 696d 6167 .Node: Core imag │ │ │ │ │ -00000bc0: 6520 7369 7a65 206c 696d 6974 6174 696f e size limitatio │ │ │ │ │ -00000bd0: 6e7f 3132 3232 3833 0a4e 6f64 653a 2046 n.122283.Node: F │ │ │ │ │ -00000be0: 696c 6573 7973 7465 6d7f 3132 3438 3437 ilesystem.124847 │ │ │ │ │ -00000bf0: 0a4e 6f64 653a 2044 6576 6963 6520 7379 .Node: Device sy │ │ │ │ │ -00000c00: 6e74 6178 7f31 3235 3535 360a 4e6f 6465 ntax.125556.Node │ │ │ │ │ -00000c10: 3a20 4669 6c65 206e 616d 6520 7379 6e74 : File name synt │ │ │ │ │ -00000c20: 6178 7f31 3238 3235 370a 4e6f 6465 3a20 ax.128257.Node: │ │ │ │ │ -00000c30: 426c 6f63 6b20 6c69 7374 2073 796e 7461 Block list synta │ │ │ │ │ -00000c40: 787f 3132 3933 3033 0a4e 6f64 653a 2049 x.129303.Node: I │ │ │ │ │ -00000c50: 6e74 6572 6661 6365 7f31 3330 3033 370a nterface.130037. │ │ │ │ │ -00000c60: 4e6f 6465 3a20 436f 6d6d 616e 642d 6c69 Node: Command-li │ │ │ │ │ -00000c70: 6e65 2069 6e74 6572 6661 6365 7f31 3330 ne interface.130 │ │ │ │ │ -00000c80: 3836 310a 4e6f 6465 3a20 436f 6d6d 616e 861.Node: Comman │ │ │ │ │ -00000c90: 642d 6c69 6e65 2069 6e74 6572 6661 6365 d-line interface │ │ │ │ │ -00000ca0: 2d46 6f6f 746e 6f74 6573 7f31 3332 3830 -Footnotes.13280 │ │ │ │ │ -00000cb0: 350a 5265 663a 2043 6f6d 6d61 6e64 2d6c 5.Ref: Command-l │ │ │ │ │ -00000cc0: 696e 6520 696e 7465 7266 6163 652d 466f ine interface-Fo │ │ │ │ │ -00000cd0: 6f74 6e6f 7465 2d31 7f31 3332 3839 340a otnote-1.132894. │ │ │ │ │ -00000ce0: 4e6f 6465 3a20 4d65 6e75 2069 6e74 6572 Node: Menu inter │ │ │ │ │ -00000cf0: 6661 6365 7f31 3332 3938 390a 4e6f 6465 face.132989.Node │ │ │ │ │ -00000d00: 3a20 4d65 6e75 2065 6e74 7279 2065 6469 : Menu entry edi │ │ │ │ │ -00000d10: 746f 727f 3133 3430 3031 0a4e 6f64 653a tor.134001.Node: │ │ │ │ │ -00000d20: 2045 6e76 6972 6f6e 6d65 6e74 7f31 3334 Environment.134 │ │ │ │ │ -00000d30: 3733 390a 4e6f 6465 3a20 5370 6563 6961 739.Node: Specia │ │ │ │ │ -00000d40: 6c20 656e 7669 726f 6e6d 656e 7420 7661 l environment va │ │ │ │ │ -00000d50: 7269 6162 6c65 737f 3133 3534 3432 0a4e riables.135442.N │ │ │ │ │ -00000d60: 6f64 653a 2062 696f 736e 756d 7f31 3336 ode: biosnum.136 │ │ │ │ │ -00000d70: 3439 360a 4e6f 6465 3a20 6368 6563 6b5f 496.Node: check_ │ │ │ │ │ -00000d80: 7369 676e 6174 7572 6573 7f31 3337 3032 signatures.13702 │ │ │ │ │ -00000d90: 300a 4e6f 6465 3a20 6368 6f73 656e 7f31 0.Node: chosen.1 │ │ │ │ │ -00000da0: 3337 3330 370a 4e6f 6465 3a20 636d 6470 37307.Node: cmdp │ │ │ │ │ -00000db0: 6174 687f 3133 3737 3530 0a4e 6f64 653a ath.137750.Node: │ │ │ │ │ -00000dc0: 2063 6f6c 6f72 5f68 6967 686c 6967 6874 color_highlight │ │ │ │ │ -00000dd0: 7f31 3338 3137 370a 4e6f 6465 3a20 636f .138177.Node: co │ │ │ │ │ -00000de0: 6c6f 725f 6e6f 726d 616c 7f31 3338 3538 lor_normal.13858 │ │ │ │ │ -00000df0: 390a 4e6f 6465 3a20 636f 6e66 6967 5f64 9.Node: config_d │ │ │ │ │ -00000e00: 6972 6563 746f 7279 7f31 3430 3235 320a irectory.140252. │ │ │ │ │ -00000e10: 4e6f 6465 3a20 636f 6e66 6967 5f66 696c Node: config_fil │ │ │ │ │ -00000e20: 657f 3134 3035 3436 0a4e 6f64 653a 2064 e.140546.Node: d │ │ │ │ │ -00000e30: 6562 7567 7f31 3430 3933 390a 4e6f 6465 ebug.140939.Node │ │ │ │ │ -00000e40: 3a20 6465 6661 756c 747f 3134 3133 3738 : default.141378 │ │ │ │ │ -00000e50: 0a4e 6f64 653a 2066 616c 6c62 6163 6b7f .Node: fallback. │ │ │ │ │ -00000e60: 3134 3238 3036 0a4e 6f64 653a 2067 6678 142806.Node: gfx │ │ │ │ │ -00000e70: 6d6f 6465 7f31 3433 3133 390a 4e6f 6465 mode.143139.Node │ │ │ │ │ -00000e80: 3a20 6766 7870 6179 6c6f 6164 7f31 3433 : gfxpayload.143 │ │ │ │ │ -00000e90: 3933 370a 4e6f 6465 3a20 6766 7874 6572 937.Node: gfxter │ │ │ │ │ -00000ea0: 6d5f 666f 6e74 7f31 3435 3039 310a 4e6f m_font.145091.No │ │ │ │ │ -00000eb0: 6465 3a20 6772 7562 5f63 7075 7f31 3435 de: grub_cpu.145 │ │ │ │ │ -00000ec0: 3339 310a 4e6f 6465 3a20 6772 7562 5f70 391.Node: grub_p │ │ │ │ │ -00000ed0: 6c61 7466 6f72 6d7f 3134 3536 3739 0a4e latform.145679.N │ │ │ │ │ -00000ee0: 6f64 653a 2069 636f 6e64 6972 7f31 3435 ode: icondir.145 │ │ │ │ │ -00000ef0: 3937 310a 4e6f 6465 3a20 6c61 6e67 7f31 971.Node: lang.1 │ │ │ │ │ -00000f00: 3436 3238 380a 4e6f 6465 3a20 6c6f 6361 46288.Node: loca │ │ │ │ │ -00000f10: 6c65 5f64 6972 7f31 3436 3735 370a 4e6f le_dir.146757.No │ │ │ │ │ -00000f20: 6465 3a20 6d65 6e75 5f63 6f6c 6f72 5f68 de: menu_color_h │ │ │ │ │ -00000f30: 6967 686c 6967 6874 7f31 3437 3236 360a ighlight.147266. │ │ │ │ │ -00000f40: 4e6f 6465 3a20 6d65 6e75 5f63 6f6c 6f72 Node: menu_color │ │ │ │ │ -00000f50: 5f6e 6f72 6d61 6c7f 3134 3737 3632 0a4e _normal.147762.N │ │ │ │ │ -00000f60: 6f64 653a 206e 6574 5f3c 494e 5445 5246 ode: net__boot_file.1 │ │ │ │ │ -00000f80: 3438 3236 330a 4e6f 6465 3a20 6e65 745f 48263.Node: net_ │ │ │ │ │ -00000f90: 3c49 4e54 4552 4641 4345 3e5f 6468 6370 _dhcp │ │ │ │ │ -00000fa0: 5f73 6572 7665 725f 6e61 6d65 7f31 3438 _server_name.148 │ │ │ │ │ -00000fb0: 3530 360a 4e6f 6465 3a20 6e65 745f 3c49 506.Node: net__domain │ │ │ │ │ -00000fd0: 7f31 3438 3736 380a 4e6f 6465 3a20 6e65 .148768.Node: ne │ │ │ │ │ -00000fe0: 745f 3c49 4e54 4552 4641 4345 3e5f 6578 t__ex │ │ │ │ │ -00000ff0: 7465 6e73 696f 6e73 7061 7468 7f31 3439 tensionspath.149 │ │ │ │ │ -00001000: 3031 350a 4e6f 6465 3a20 6e65 745f 3c49 015.Node: net__hostna │ │ │ │ │ -00001020: 6d65 7f31 3439 3237 300a 4e6f 6465 3a20 me.149270.Node: │ │ │ │ │ -00001030: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -00001040: 6970 7f31 3439 3530 390a 4e6f 6465 3a20 ip.149509.Node: │ │ │ │ │ -00001050: 6e65 745f 3c49 4e54 4552 4641 4345 3e5f net__ │ │ │ │ │ -00001060: 6d61 637f 3134 3937 3235 0a4e 6f64 653a mac.149725.Node: │ │ │ │ │ -00001070: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ -00001080: 5f6e 6578 745f 7365 7276 6572 7f31 3439 _next_server.149 │ │ │ │ │ -00001090: 3934 360a 4e6f 6465 3a20 6e65 745f 3c49 946.Node: net__rootpa │ │ │ │ │ -000010b0: 7468 7f31 3530 3138 390a 4e6f 6465 3a20 th.150189.Node: │ │ │ │ │ -000010c0: 6e65 745f 6465 6661 756c 745f 696e 7465 net_default_inte │ │ │ │ │ -000010d0: 7266 6163 657f 3135 3034 3238 0a4e 6f64 rface.150428.Nod │ │ │ │ │ -000010e0: 653a 206e 6574 5f64 6566 6175 6c74 5f69 e: net_default_i │ │ │ │ │ -000010f0: 707f 3135 3036 3438 0a4e 6f64 653a 206e p.150648.Node: n │ │ │ │ │ -00001100: 6574 5f64 6566 6175 6c74 5f6d 6163 7f31 et_default_mac.1 │ │ │ │ │ -00001110: 3530 3834 350a 4e6f 6465 3a20 6e65 745f 50845.Node: net_ │ │ │ │ │ -00001120: 6465 6661 756c 745f 7365 7276 6572 7f31 default_server.1 │ │ │ │ │ -00001130: 3531 3034 310a 4e6f 6465 3a20 7061 6765 51041.Node: page │ │ │ │ │ -00001140: 727f 3135 3132 3334 0a4e 6f64 653a 2070 r.151234.Node: p │ │ │ │ │ -00001150: 7265 6669 787f 3135 3134 3930 0a4e 6f64 refix.151490.Nod │ │ │ │ │ -00001160: 653a 2070 7865 5f62 6c6b 7369 7a65 7f31 e: pxe_blksize.1 │ │ │ │ │ -00001170: 3531 3933 390a 4e6f 6465 3a20 7078 655f 51939.Node: pxe_ │ │ │ │ │ -00001180: 6465 6661 756c 745f 6761 7465 7761 797f default_gateway. │ │ │ │ │ -00001190: 3135 3231 3136 0a4e 6f64 653a 2070 7865 152116.Node: pxe │ │ │ │ │ -000011a0: 5f64 6566 6175 6c74 5f73 6572 7665 727f _default_server. │ │ │ │ │ -000011b0: 3135 3233 3231 0a4e 6f64 653a 2072 6f6f 152321.Node: roo │ │ │ │ │ -000011c0: 747f 3135 3235 3137 0a4e 6f64 653a 2073 t.152517.Node: s │ │ │ │ │ -000011d0: 7570 6572 7573 6572 737f 3135 3330 3538 uperusers.153058 │ │ │ │ │ -000011e0: 0a4e 6f64 653a 2074 6865 6d65 7f31 3533 .Node: theme.153 │ │ │ │ │ -000011f0: 3330 360a 4e6f 6465 3a20 7469 6d65 6f75 306.Node: timeou │ │ │ │ │ -00001200: 747f 3135 3336 3237 0a4e 6f64 653a 2074 t.153627.Node: t │ │ │ │ │ -00001210: 696d 656f 7574 5f73 7479 6c65 7f31 3534 imeout_style.154 │ │ │ │ │ -00001220: 3236 340a 4e6f 6465 3a20 456e 7669 726f 264.Node: Enviro │ │ │ │ │ -00001230: 6e6d 656e 7420 626c 6f63 6b7f 3135 3436 nment block.1546 │ │ │ │ │ -00001240: 3439 0a4e 6f64 653a 2043 6f6d 6d61 6e64 49.Node: Command │ │ │ │ │ -00001250: 737f 3135 3630 3831 0a4e 6f64 653a 204d s.156081.Node: M │ │ │ │ │ -00001260: 656e 752d 7370 6563 6966 6963 2063 6f6d enu-specific com │ │ │ │ │ -00001270: 6d61 6e64 737f 3135 3639 3531 0a4e 6f64 mands.156951.Nod │ │ │ │ │ -00001280: 653a 206d 656e 7565 6e74 7279 7f31 3537 e: menuentry.157 │ │ │ │ │ -00001290: 3637 390a 4e6f 6465 3a20 7375 626d 656e 679.Node: submen │ │ │ │ │ -000012a0: 757f 3135 3932 3230 0a4e 6f64 653a 2047 u.159220.Node: G │ │ │ │ │ -000012b0: 656e 6572 616c 2063 6f6d 6d61 6e64 737f eneral commands. │ │ │ │ │ -000012c0: 3135 3937 3439 0a4e 6f64 653a 2073 6572 159749.Node: ser │ │ │ │ │ -000012d0: 6961 6c7f 3136 3032 3435 0a4e 6f64 653a ial.160245.Node: │ │ │ │ │ -000012e0: 2074 6572 6d69 6e61 6c5f 696e 7075 747f terminal_input. │ │ │ │ │ -000012f0: 3136 3132 3834 0a4e 6f64 653a 2074 6572 161284.Node: ter │ │ │ │ │ -00001300: 6d69 6e61 6c5f 6f75 7470 7574 7f31 3631 minal_output.161 │ │ │ │ │ -00001310: 3934 360a 4e6f 6465 3a20 7465 726d 696e 946.Node: termin │ │ │ │ │ -00001320: 666f 7f31 3632 3630 390a 4e6f 6465 3a20 fo.162609.Node: │ │ │ │ │ -00001330: 436f 6d6d 616e 642d 6c69 6e65 2061 6e64 Command-line and │ │ │ │ │ -00001340: 206d 656e 7520 656e 7472 7920 636f 6d6d menu entry comm │ │ │ │ │ -00001350: 616e 6473 7f31 3633 3833 320a 4e6f 6465 ands.163832.Node │ │ │ │ │ -00001360: 3a20 5b7f 3136 3931 3534 0a4e 6f64 653a : [.169154.Node: │ │ │ │ │ -00001370: 2061 6370 697f 3136 3933 3336 0a4e 6f64 acpi.169336.Nod │ │ │ │ │ -00001380: 653a 2061 7574 6865 6e74 6963 6174 657f e: authenticate. │ │ │ │ │ -00001390: 3137 3036 3139 0a4e 6f64 653a 2062 6163 170619.Node: bac │ │ │ │ │ -000013a0: 6b67 726f 756e 645f 636f 6c6f 727f 3137 kground_color.17 │ │ │ │ │ -000013b0: 3130 3436 0a4e 6f64 653a 2062 6163 6b67 1046.Node: backg │ │ │ │ │ -000013c0: 726f 756e 645f 696d 6167 657f 3137 3137 round_image.1717 │ │ │ │ │ -000013d0: 3139 0a4e 6f64 653a 2062 6164 7261 6d7f 19.Node: badram. │ │ │ │ │ -000013e0: 3137 3232 3633 0a4e 6f64 653a 2062 6c6f 172263.Node: blo │ │ │ │ │ -000013f0: 636b 6c69 7374 7f31 3733 3634 380a 4e6f cklist.173648.No │ │ │ │ │ -00001400: 6465 3a20 626f 6f74 7f31 3733 3838 320a de: boot.173882. │ │ │ │ │ -00001410: 4e6f 6465 3a20 6361 747f 3137 3432 3034 Node: cat.174204 │ │ │ │ │ -00001420: 0a4e 6f64 653a 2063 6861 696e 6c6f 6164 .Node: chainload │ │ │ │ │ -00001430: 6572 7f31 3734 3833 380a 4e6f 6465 3a20 er.174838.Node: │ │ │ │ │ -00001440: 636c 6561 727f 3137 3534 3634 0a4e 6f64 clear.175464.Nod │ │ │ │ │ -00001450: 653a 2063 6d6f 7363 6c65 616e 7f31 3735 e: cmosclean.175 │ │ │ │ │ -00001460: 3635 300a 4e6f 6465 3a20 636d 6f73 6475 650.Node: cmosdu │ │ │ │ │ -00001470: 6d70 7f31 3735 3935 340a 4e6f 6465 3a20 mp.175954.Node: │ │ │ │ │ -00001480: 636d 6f73 7465 7374 7f31 3736 3234 390a cmostest.176249. │ │ │ │ │ -00001490: 4e6f 6465 3a20 636d 707f 3137 3636 3037 Node: cmp.176607 │ │ │ │ │ -000014a0: 0a4e 6f64 653a 2063 6f6e 6669 6766 696c .Node: configfil │ │ │ │ │ -000014b0: 657f 3137 3731 3538 0a4e 6f64 653a 2063 e.177158.Node: c │ │ │ │ │ -000014c0: 7075 6964 7f31 3737 3538 330a 4e6f 6465 puid.177583.Node │ │ │ │ │ -000014d0: 3a20 6372 637f 3137 3831 3534 0a4e 6f64 : crc.178154.Nod │ │ │ │ │ -000014e0: 653a 2063 7279 7074 6f6d 6f75 6e74 7f31 e: cryptomount.1 │ │ │ │ │ -000014f0: 3738 3432 380a 4e6f 6465 3a20 6375 746d 78428.Node: cutm │ │ │ │ │ -00001500: 656d 7f31 3739 3431 360a 4e6f 6465 3a20 em.179416.Node: │ │ │ │ │ -00001510: 6461 7465 7f31 3830 3239 350a 4e6f 6465 date.180295.Node │ │ │ │ │ -00001520: 3a20 6465 7669 6365 7472 6565 7f31 3830 : devicetree.180 │ │ │ │ │ -00001530: 3833 390a 4e6f 6465 3a20 6469 7374 7275 839.Node: distru │ │ │ │ │ -00001540: 7374 7f31 3831 3338 310a 4e6f 6465 3a20 st.181381.Node: │ │ │ │ │ -00001550: 6472 6976 656d 6170 7f31 3832 3136 320a drivemap.182162. │ │ │ │ │ -00001560: 4e6f 6465 3a20 6563 686f 7f31 3832 3936 Node: echo.18296 │ │ │ │ │ -00001570: 330a 4e6f 6465 3a20 6576 616c 7f31 3833 3.Node: eval.183 │ │ │ │ │ -00001580: 3930 320a 4e6f 6465 3a20 6578 706f 7274 902.Node: export │ │ │ │ │ -00001590: 7f31 3834 3138 350a 4e6f 6465 3a20 6661 .184185.Node: fa │ │ │ │ │ -000015a0: 6c73 657f 3138 3434 3936 0a4e 6f64 653a lse.184496.Node: │ │ │ │ │ -000015b0: 2067 6574 7465 7874 7f31 3834 3739 320a gettext.184792. │ │ │ │ │ -000015c0: 4e6f 6465 3a20 6770 7473 796e 637f 3138 Node: gptsync.18 │ │ │ │ │ -000015d0: 3532 3339 0a4e 6f64 653a 2068 616c 747f 5239.Node: halt. │ │ │ │ │ -000015e0: 3138 3631 3834 0a4e 6f64 653a 2068 6173 186184.Node: has │ │ │ │ │ -000015f0: 6873 756d 7f31 3836 3531 330a 4e6f 6465 hsum.186513.Node │ │ │ │ │ -00001600: 3a20 6865 6c70 7f31 3837 3732 390a 4e6f : help.187729.No │ │ │ │ │ -00001610: 6465 3a20 696e 6974 7264 7f31 3838 3139 de: initrd.18819 │ │ │ │ │ -00001620: 360a 4e6f 6465 3a20 696e 6974 7264 3136 6.Node: initrd16 │ │ │ │ │ -00001630: 7f31 3838 3633 310a 4e6f 6465 3a20 696e .188631.Node: in │ │ │ │ │ -00001640: 736d 6f64 7f31 3839 3136 350a 4e6f 6465 smod.189165.Node │ │ │ │ │ -00001650: 3a20 6b65 7973 7461 7475 737f 3138 3933 : keystatus.1893 │ │ │ │ │ -00001660: 3837 0a4e 6f64 653a 206c 696e 7578 7f31 87.Node: linux.1 │ │ │ │ │ -00001670: 3930 3032 300a 4e6f 6465 3a20 6c69 6e75 90020.Node: linu │ │ │ │ │ -00001680: 7831 367f 3139 3039 3233 0a4e 6f64 653a x16.190923.Node: │ │ │ │ │ -00001690: 206c 6973 745f 656e 767f 3139 3136 3337 list_env.191637 │ │ │ │ │ -000016a0: 0a4e 6f64 653a 206c 6973 745f 7472 7573 .Node: list_trus │ │ │ │ │ -000016b0: 7465 647f 3139 3230 3031 0a4e 6f64 653a ted.192001.Node: │ │ │ │ │ -000016c0: 206c 6f61 645f 656e 767f 3139 3235 3834 load_env.192584 │ │ │ │ │ -000016d0: 0a4e 6f64 653a 206c 6f61 6466 6f6e 747f .Node: loadfont. │ │ │ │ │ -000016e0: 3139 3432 3533 0a4e 6f64 653a 206c 6f6f 194253.Node: loo │ │ │ │ │ -000016f0: 7062 6163 6b7f 3139 3436 3234 0a4e 6f64 pback.194624.Nod │ │ │ │ │ -00001700: 653a 206c 737f 3139 3530 3730 0a4e 6f64 e: ls.195070.Nod │ │ │ │ │ -00001710: 653a 206c 7366 6f6e 7473 7f31 3935 3631 e: lsfonts.19561 │ │ │ │ │ -00001720: 320a 4e6f 6465 3a20 6c73 6d6f 647f 3139 2.Node: lsmod.19 │ │ │ │ │ -00001730: 3537 3934 0a4e 6f64 653a 206d 6435 7375 5794.Node: md5su │ │ │ │ │ -00001740: 6d7f 3139 3539 3834 0a4e 6f64 653a 206d m.195984.Node: m │ │ │ │ │ -00001750: 6f64 756c 657f 3139 3632 3633 0a4e 6f64 odule.196263.Nod │ │ │ │ │ -00001760: 653a 206d 756c 7469 626f 6f74 7f31 3936 e: multiboot.196 │ │ │ │ │ -00001770: 3537 350a 4e6f 6465 3a20 6e61 7469 7665 575.Node: native │ │ │ │ │ -00001780: 6469 736b 7f31 3937 3638 340a 4e6f 6465 disk.197684.Node │ │ │ │ │ -00001790: 3a20 6e6f 726d 616c 7f31 3938 3038 330a : normal.198083. │ │ │ │ │ -000017a0: 4e6f 6465 3a20 6e6f 726d 616c 5f65 7869 Node: normal_exi │ │ │ │ │ -000017b0: 747f 3139 3838 3530 0a4e 6f64 653a 2070 t.198850.Node: p │ │ │ │ │ -000017c0: 6172 7474 6f6f 6c7f 3139 3931 3732 0a4e arttool.199172.N │ │ │ │ │ -000017d0: 6f64 653a 2070 6173 7377 6f72 647f 3230 ode: password.20 │ │ │ │ │ -000017e0: 3036 3738 0a4e 6f64 653a 2070 6173 7377 0678.Node: passw │ │ │ │ │ -000017f0: 6f72 645f 7062 6b64 6632 7f32 3030 3936 ord_pbkdf2.20096 │ │ │ │ │ -00001800: 300a 4e6f 6465 3a20 706c 6179 7f32 3031 0.Node: play.201 │ │ │ │ │ -00001810: 3336 380a 4e6f 6465 3a20 7072 6f62 657f 368.Node: probe. │ │ │ │ │ -00001820: 3230 3231 3136 0a4e 6f64 653a 2072 646d 202116.Node: rdm │ │ │ │ │ -00001830: 7372 7f32 3032 3539 340a 4e6f 6465 3a20 sr.202594.Node: │ │ │ │ │ -00001840: 7265 6164 7f32 3033 3337 370a 4e6f 6465 read.203377.Node │ │ │ │ │ -00001850: 3a20 7265 626f 6f74 7f32 3033 3732 310a : reboot.203721. │ │ │ │ │ -00001860: 4e6f 6465 3a20 7265 6765 7870 7f32 3033 Node: regexp.203 │ │ │ │ │ -00001870: 3930 340a 4e6f 6465 3a20 726d 6d6f 647f 904.Node: rmmod. │ │ │ │ │ -00001880: 3230 3434 3339 0a4e 6f64 653a 2073 6176 204439.Node: sav │ │ │ │ │ -00001890: 655f 656e 767f 3230 3436 3332 0a4e 6f64 e_env.204632.Nod │ │ │ │ │ -000018a0: 653a 2073 6561 7263 687f 3230 3536 3532 e: search.205652 │ │ │ │ │ -000018b0: 0a4e 6f64 653a 2073 656e 646b 6579 7f32 .Node: sendkey.2 │ │ │ │ │ -000018c0: 3036 3432 300a 4e6f 6465 3a20 7365 747f 06420.Node: set. │ │ │ │ │ -000018d0: 3231 3238 3038 0a4e 6f64 653a 2073 6861 212808.Node: sha │ │ │ │ │ -000018e0: 3173 756d 7f32 3133 3131 300a 4e6f 6465 1sum.213110.Node │ │ │ │ │ -000018f0: 3a20 7368 6132 3536 7375 6d7f 3231 3333 : sha256sum.2133 │ │ │ │ │ -00001900: 3935 0a4e 6f64 653a 2073 6861 3531 3273 95.Node: sha512s │ │ │ │ │ -00001910: 756d 7f32 3133 3639 340a 4e6f 6465 3a20 um.213694.Node: │ │ │ │ │ -00001920: 736c 6565 707f 3231 3339 3931 0a4e 6f64 sleep.213991.Nod │ │ │ │ │ -00001930: 653a 2073 6d62 696f 737f 3231 3435 3131 e: smbios.214511 │ │ │ │ │ -00001940: 0a4e 6f64 653a 2073 6f75 7263 657f 3231 .Node: source.21 │ │ │ │ │ -00001950: 3735 3234 0a4e 6f64 653a 2074 6573 747f 7524.Node: test. │ │ │ │ │ -00001960: 3231 3830 3737 0a4e 6f64 653a 2074 7275 218077.Node: tru │ │ │ │ │ -00001970: 657f 3232 3038 3436 0a4e 6f64 653a 2074 e.220846.Node: t │ │ │ │ │ -00001980: 7275 7374 7f32 3231 3133 320a 4e6f 6465 rust.221132.Node │ │ │ │ │ -00001990: 3a20 756e 7365 747f 3232 3139 3232 0a4e : unset.221922.N │ │ │ │ │ -000019a0: 6f64 653a 2076 6572 6966 795f 6465 7461 ode: verify_deta │ │ │ │ │ -000019b0: 6368 6564 7f32 3232 3133 360a 4e6f 6465 ched.222136.Node │ │ │ │ │ -000019c0: 3a20 7669 6465 6f69 6e66 6f7f 3232 3331 : videoinfo.2231 │ │ │ │ │ -000019d0: 3739 0a4e 6f64 653a 2077 726d 7372 7f32 79.Node: wrmsr.2 │ │ │ │ │ -000019e0: 3233 3435 370a 4e6f 6465 3a20 7865 6e5f 23457.Node: xen_ │ │ │ │ │ -000019f0: 6879 7065 7276 6973 6f72 7f32 3234 3237 hypervisor.22427 │ │ │ │ │ -00001a00: 310a 4e6f 6465 3a20 7865 6e5f 6d6f 6475 1.Node: xen_modu │ │ │ │ │ -00001a10: 6c65 7f32 3234 3733 320a 4e6f 6465 3a20 le.224732.Node: │ │ │ │ │ -00001a20: 4e65 7477 6f72 6b69 6e67 2063 6f6d 6d61 Networking comma │ │ │ │ │ -00001a30: 6e64 737f 3232 3532 3536 0a4e 6f64 653a nds.225256.Node: │ │ │ │ │ -00001a40: 206e 6574 5f61 6464 5f61 6464 727f 3232 net_add_addr.22 │ │ │ │ │ -00001a50: 3632 3738 0a4e 6f64 653a 206e 6574 5f61 6278.Node: net_a │ │ │ │ │ -00001a60: 6464 5f64 6e73 7f32 3236 3739 380a 4e6f dd_dns.226798.No │ │ │ │ │ -00001a70: 6465 3a20 6e65 745f 6164 645f 726f 7574 de: net_add_rout │ │ │ │ │ -00001a80: 657f 3232 3730 3734 0a4e 6f64 653a 206e e.227074.Node: n │ │ │ │ │ -00001a90: 6574 5f62 6f6f 7470 7f32 3237 3630 320a et_bootp.227602. │ │ │ │ │ -00001aa0: 4e6f 6465 3a20 6e65 745f 6465 6c5f 6164 Node: net_del_ad │ │ │ │ │ -00001ab0: 6472 7f32 3237 3936 370a 4e6f 6465 3a20 dr.227967.Node: │ │ │ │ │ -00001ac0: 6e65 745f 6465 6c5f 646e 737f 3232 3832 net_del_dns.2282 │ │ │ │ │ -00001ad0: 3037 0a4e 6f64 653a 206e 6574 5f64 656c 07.Node: net_del │ │ │ │ │ -00001ae0: 5f72 6f75 7465 7f32 3238 3435 340a 4e6f _route.228454.No │ │ │ │ │ -00001af0: 6465 3a20 6e65 745f 6468 6370 7f32 3238 de: net_dhcp.228 │ │ │ │ │ -00001b00: 3638 380a 4e6f 6465 3a20 6e65 745f 6765 688.Node: net_ge │ │ │ │ │ -00001b10: 745f 6468 6370 5f6f 7074 696f 6e7f 3233 t_dhcp_option.23 │ │ │ │ │ -00001b20: 3036 3637 0a4e 6f64 653a 206e 6574 5f69 0667.Node: net_i │ │ │ │ │ -00001b30: 7076 365f 6175 746f 636f 6e66 7f32 3331 pv6_autoconf.231 │ │ │ │ │ -00001b40: 3134 380a 4e6f 6465 3a20 6e65 745f 6c73 148.Node: net_ls │ │ │ │ │ -00001b50: 5f61 6464 727f 3233 3135 3639 0a4e 6f64 _addr.231569.Nod │ │ │ │ │ -00001b60: 653a 206e 6574 5f6c 735f 6361 7264 737f e: net_ls_cards. │ │ │ │ │ -00001b70: 3233 3138 3137 0a4e 6f64 653a 206e 6574 231817.Node: net │ │ │ │ │ -00001b80: 5f6c 735f 646e 737f 3233 3230 3533 0a4e _ls_dns.232053.N │ │ │ │ │ -00001b90: 6f64 653a 206e 6574 5f6c 735f 726f 7574 ode: net_ls_rout │ │ │ │ │ -00001ba0: 6573 7f32 3332 3238 340a 4e6f 6465 3a20 es.232284.Node: │ │ │ │ │ -00001bb0: 6e65 745f 6e73 6c6f 6f6b 7570 7f32 3332 net_nslookup.232 │ │ │ │ │ -00001bc0: 3439 310a 4e6f 6465 3a20 496e 7465 726e 491.Node: Intern │ │ │ │ │ -00001bd0: 6174 696f 6e61 6c69 7361 7469 6f6e 7f32 ationalisation.2 │ │ │ │ │ -00001be0: 3332 3737 350a 4e6f 6465 3a20 5365 6375 32775.Node: Secu │ │ │ │ │ -00001bf0: 7269 7479 7f32 3339 3630 370a 4e6f 6465 rity.239607.Node │ │ │ │ │ -00001c00: 3a20 4175 7468 656e 7469 6361 7469 6f6e : Authentication │ │ │ │ │ -00001c10: 2061 6e64 2061 7574 686f 7269 7361 7469 and authorisati │ │ │ │ │ -00001c20: 6f6e 7f32 3430 3138 330a 4e6f 6465 3a20 on.240183.Node: │ │ │ │ │ -00001c30: 5573 696e 6720 6469 6769 7461 6c20 7369 Using digital si │ │ │ │ │ -00001c40: 676e 6174 7572 6573 7f32 3433 3239 390a gnatures.243299. │ │ │ │ │ -00001c50: 4e6f 6465 3a20 5545 4649 2073 6563 7572 Node: UEFI secur │ │ │ │ │ -00001c60: 6520 626f 6f74 2061 6e64 2073 6869 6d7f e boot and shim. │ │ │ │ │ -00001c70: 3234 3635 3639 0a4e 6f64 653a 2053 6563 246569.Node: Sec │ │ │ │ │ -00001c80: 7572 6520 426f 6f74 2041 6476 616e 6365 ure Boot Advance │ │ │ │ │ -00001c90: 6420 5461 7267 6574 696e 677f 3234 3737 d Targeting.2477 │ │ │ │ │ -00001ca0: 3136 0a4e 6f64 653a 204d 6561 7375 7265 16.Node: Measure │ │ │ │ │ -00001cb0: 6420 426f 6f74 7f32 3438 3734 370a 4e6f d Boot.248747.No │ │ │ │ │ -00001cc0: 6465 3a20 4c6f 636b 646f 776e 7f32 3530 de: Lockdown.250 │ │ │ │ │ -00001cd0: 3731 320a 4e6f 6465 3a20 506c 6174 666f 712.Node: Platfo │ │ │ │ │ -00001ce0: 726d 206c 696d 6974 6174 696f 6e73 7f32 rm limitations.2 │ │ │ │ │ -00001cf0: 3531 3230 350a 4e6f 6465 3a20 506c 6174 51205.Node: Plat │ │ │ │ │ -00001d00: 666f 726d 2d73 7065 6369 6669 6320 6f70 form-specific op │ │ │ │ │ -00001d10: 6572 6174 696f 6e73 7f32 3539 3231 340a erations.259214. │ │ │ │ │ -00001d20: 4e6f 6465 3a20 5375 7070 6f72 7465 6420 Node: Supported │ │ │ │ │ -00001d30: 6b65 726e 656c 737f 3236 3032 3739 0a4e kernels.260279.N │ │ │ │ │ -00001d40: 6f64 653a 2054 726f 7562 6c65 7368 6f6f ode: Troubleshoo │ │ │ │ │ -00001d50: 7469 6e67 7f32 3637 3931 360a 4e6f 6465 ting.267916.Node │ │ │ │ │ -00001d60: 3a20 4752 5542 206f 6e6c 7920 6f66 6665 : GRUB only offe │ │ │ │ │ -00001d70: 7273 2061 2072 6573 6375 6520 7368 656c rs a rescue shel │ │ │ │ │ -00001d80: 6c7f 3236 3831 3836 0a4e 6f64 653a 2046 l.268186.Node: F │ │ │ │ │ -00001d90: 6972 6d77 6172 6520 7374 616c 6c73 2069 irmware stalls i │ │ │ │ │ -00001da0: 6e73 7465 6164 206f 6620 626f 6f74 696e nstead of bootin │ │ │ │ │ -00001db0: 6720 4752 5542 7f32 3731 3139 350a 4e6f g GRUB.271195.No │ │ │ │ │ -00001dc0: 6465 3a20 496e 766f 6b69 6e67 2067 7275 de: Invoking gru │ │ │ │ │ -00001dd0: 622d 696e 7374 616c 6c7f 3237 3138 3236 b-install.271826 │ │ │ │ │ -00001de0: 0a4e 6f64 653a 2049 6e76 6f6b 696e 6720 .Node: Invoking │ │ │ │ │ -00001df0: 6772 7562 2d6d 6b63 6f6e 6669 677f 3237 grub-mkconfig.27 │ │ │ │ │ -00001e00: 3339 3936 0a4e 6f64 653a 2049 6e76 6f6b 3996.Node: Invok │ │ │ │ │ -00001e10: 696e 6720 6772 7562 2d6d 6b70 6173 7377 ing grub-mkpassw │ │ │ │ │ -00001e20: 642d 7062 6b64 6632 7f32 3734 3633 330a d-pbkdf2.274633. │ │ │ │ │ -00001e30: 4e6f 6465 3a20 496e 766f 6b69 6e67 2067 Node: Invoking g │ │ │ │ │ -00001e40: 7275 622d 6d6b 7265 6c70 6174 687f 3237 rub-mkrelpath.27 │ │ │ │ │ -00001e50: 3532 3932 0a4e 6f64 653a 2049 6e76 6f6b 5292.Node: Invok │ │ │ │ │ -00001e60: 696e 6720 6772 7562 2d6d 6b72 6573 6375 ing grub-mkrescu │ │ │ │ │ -00001e70: 657f 3237 3630 3635 0a4e 6f64 653a 2049 e.276065.Node: I │ │ │ │ │ -00001e80: 6e76 6f6b 696e 6720 6772 7562 2d6d 6f75 nvoking grub-mou │ │ │ │ │ -00001e90: 6e74 7f32 3737 3831 340a 4e6f 6465 3a20 nt.277814.Node: │ │ │ │ │ -00001ea0: 496e 766f 6b69 6e67 2067 7275 622d 7072 Invoking grub-pr │ │ │ │ │ -00001eb0: 6f62 657f 3238 3038 3633 0a4e 6f64 653a obe.280863.Node: │ │ │ │ │ -00001ec0: 2049 6e76 6f6b 696e 6720 6772 7562 2d73 Invoking grub-s │ │ │ │ │ -00001ed0: 6372 6970 742d 6368 6563 6b7f 3238 3334 cript-check.2834 │ │ │ │ │ -00001ee0: 3537 0a4e 6f64 653a 204f 6274 6169 6e69 57.Node: Obtaini │ │ │ │ │ -00001ef0: 6e67 2061 6e64 2042 7569 6c64 696e 6720 ng and Building │ │ │ │ │ -00001f00: 4752 5542 7f32 3834 3230 310a 4e6f 6465 GRUB.284201.Node │ │ │ │ │ -00001f10: 3a20 5265 706f 7274 696e 6720 6275 6773 : Reporting bugs │ │ │ │ │ -00001f20: 7f32 3835 3434 340a 4e6f 6465 3a20 4675 .285444.Node: Fu │ │ │ │ │ -00001f30: 7475 7265 7f32 3838 3236 300a 4e6f 6465 ture.288260.Node │ │ │ │ │ -00001f40: 3a20 436f 7079 696e 6720 5468 6973 204d : Copying This M │ │ │ │ │ -00001f50: 616e 7561 6c7f 3238 3836 3630 0a4e 6f64 anual.288660.Nod │ │ │ │ │ -00001f60: 653a 2047 4e55 2046 7265 6520 446f 6375 e: GNU Free Docu │ │ │ │ │ -00001f70: 6d65 6e74 6174 696f 6e20 4c69 6365 6e73 mentation Licens │ │ │ │ │ -00001f80: 657f 3238 3838 3838 0a4e 6f64 653a 2049 e.288888.Node: I │ │ │ │ │ -00001f90: 6e64 6578 7f33 3132 3433 320a 1f0a 456e ndex.312432...En │ │ │ │ │ -00001fa0: 6420 5461 6720 5461 626c 650a 0a1f 0a4c d Tag Table....L │ │ │ │ │ -00001fb0: 6f63 616c 2056 6172 6961 626c 6573 3a0a ocal Variables:. │ │ │ │ │ -00001fc0: 636f 6469 6e67 3a20 7574 662d 380a 456e coding: utf-8.En │ │ │ │ │ -00001fd0: 643a 0a d:. │ │ │ │ │ +00000070: 3920 4665 6272 7561 7279 2032 3032 3529 9 February 2025) │ │ │ │ │ +00000080: 2e0a 0a20 2020 436f 7079 7269 6768 7420 ... Copyright │ │ │ │ │ +00000090: 2843 290a 3139 3939 2c32 3030 302c 3230 (C).1999,2000,20 │ │ │ │ │ +000000a0: 3031 2c32 3030 322c 3230 3034 2c32 3030 01,2002,2004,200 │ │ │ │ │ +000000b0: 362c 3230 3038 2c32 3030 392c 3230 3130 6,2008,2009,2010 │ │ │ │ │ +000000c0: 2c32 3031 312c 3230 3132 2c32 3031 3320 ,2011,2012,2013 │ │ │ │ │ +000000d0: 4672 6565 0a53 6f66 7477 6172 6520 466f Free.Software Fo │ │ │ │ │ +000000e0: 756e 6461 7469 6f6e 2c20 496e 632e 0a0a undation, Inc... │ │ │ │ │ +000000f0: 2020 2020 2050 6572 6d69 7373 696f 6e20 Permission │ │ │ │ │ +00000100: 6973 2067 7261 6e74 6564 2074 6f20 636f is granted to co │ │ │ │ │ +00000110: 7079 2c20 6469 7374 7269 6275 7465 2061 py, distribute a │ │ │ │ │ +00000120: 6e64 2f6f 7220 6d6f 6469 6679 2074 6869 nd/or modify thi │ │ │ │ │ +00000130: 730a 2020 2020 2064 6f63 756d 656e 7420 s. document │ │ │ │ │ +00000140: 756e 6465 7220 7468 6520 7465 726d 7320 under the terms │ │ │ │ │ +00000150: 6f66 2074 6865 2047 4e55 2046 7265 6520 of the GNU Free │ │ │ │ │ +00000160: 446f 6375 6d65 6e74 6174 696f 6e20 4c69 Documentation Li │ │ │ │ │ +00000170: 6365 6e73 652c 0a20 2020 2020 5665 7273 cense,. Vers │ │ │ │ │ +00000180: 696f 6e20 312e 3220 6f72 2061 6e79 206c ion 1.2 or any l │ │ │ │ │ +00000190: 6174 6572 2076 6572 7369 6f6e 2070 7562 ater version pub │ │ │ │ │ +000001a0: 6c69 7368 6564 2062 7920 7468 6520 4672 lished by the Fr │ │ │ │ │ +000001b0: 6565 2053 6f66 7477 6172 650a 2020 2020 ee Software. │ │ │ │ │ +000001c0: 2046 6f75 6e64 6174 696f 6e3b 2077 6974 Foundation; wit │ │ │ │ │ +000001d0: 6820 6e6f 2049 6e76 6172 6961 6e74 2053 h no Invariant S │ │ │ │ │ +000001e0: 6563 7469 6f6e 732e 0a49 4e46 4f2d 4449 ections..INFO-DI │ │ │ │ │ +000001f0: 522d 5345 4354 494f 4e20 4b65 726e 656c R-SECTION Kernel │ │ │ │ │ +00000200: 0a53 5441 5254 2d49 4e46 4f2d 4449 522d .START-INFO-DIR- │ │ │ │ │ +00000210: 454e 5452 590a 2a20 4752 5542 3a20 2867 ENTRY.* GRUB: (g │ │ │ │ │ +00000220: 7275 6229 2e20 2020 2020 2020 2020 2020 rub). │ │ │ │ │ +00000230: 2020 2020 2020 5468 6520 4752 616e 6420 The GRand │ │ │ │ │ +00000240: 556e 6966 6965 6420 426f 6f74 6c6f 6164 Unified Bootload │ │ │ │ │ +00000250: 6572 0a2a 2067 7275 622d 696e 7374 616c er.* grub-instal │ │ │ │ │ +00000260: 6c3a 2028 6772 7562 2949 6e76 6f6b 696e l: (grub)Invokin │ │ │ │ │ +00000270: 6720 6772 7562 2d69 6e73 7461 6c6c 2e20 g grub-install. │ │ │ │ │ +00000280: 2020 2049 6e73 7461 6c6c 2047 5255 4220 Install GRUB │ │ │ │ │ +00000290: 6f6e 2079 6f75 7220 6472 6976 650a 2a20 on your drive.* │ │ │ │ │ +000002a0: 6772 7562 2d6d 6b63 6f6e 6669 673a 2028 grub-mkconfig: ( │ │ │ │ │ +000002b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000002c0: 7562 2d6d 6b63 6f6e 6669 672e 2020 4765 ub-mkconfig. Ge │ │ │ │ │ +000002d0: 6e65 7261 7465 2047 5255 4220 636f 6e66 nerate GRUB conf │ │ │ │ │ +000002e0: 6967 7572 6174 696f 6e0a 2a20 6772 7562 iguration.* grub │ │ │ │ │ +000002f0: 2d6d 6b70 6173 7377 642d 7062 6b64 6632 -mkpasswd-pbkdf2 │ │ │ │ │ +00000300: 3a20 2867 7275 6229 496e 766f 6b69 6e67 : (grub)Invoking │ │ │ │ │ +00000310: 2067 7275 622d 6d6b 7061 7373 7764 2d70 grub-mkpasswd-p │ │ │ │ │ +00000320: 626b 6466 322e 0a2a 2067 7275 622d 6d6b bkdf2..* grub-mk │ │ │ │ │ +00000330: 7265 6c70 6174 683a 2028 6772 7562 2949 relpath: (grub)I │ │ │ │ │ +00000340: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000350: 656c 7061 7468 2e0a 2a20 6772 7562 2d6d elpath..* grub-m │ │ │ │ │ +00000360: 6b72 6573 6375 653a 2028 6772 7562 2949 krescue: (grub)I │ │ │ │ │ +00000370: 6e76 6f6b 696e 6720 6772 7562 2d6d 6b72 nvoking grub-mkr │ │ │ │ │ +00000380: 6573 6375 652e 2020 4d61 6b65 2061 2047 escue. Make a G │ │ │ │ │ +00000390: 5255 4220 7265 7363 7565 2069 6d61 6765 RUB rescue image │ │ │ │ │ +000003a0: 0a2a 2067 7275 622d 6d6f 756e 743a 2028 .* grub-mount: ( │ │ │ │ │ +000003b0: 6772 7562 2949 6e76 6f6b 696e 6720 6772 grub)Invoking gr │ │ │ │ │ +000003c0: 7562 2d6d 6f75 6e74 2e20 2020 2020 2020 ub-mount. │ │ │ │ │ +000003d0: 204d 6f75 6e74 2061 2066 696c 6520 7379 Mount a file sy │ │ │ │ │ +000003e0: 7374 656d 2075 7369 6e67 2047 5255 420a stem using GRUB. │ │ │ │ │ +000003f0: 2a20 6772 7562 2d70 726f 6265 3a20 2867 * grub-probe: (g │ │ │ │ │ +00000400: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000410: 622d 7072 6f62 652e 2020 2020 2020 2020 b-probe. │ │ │ │ │ +00000420: 5072 6f62 6520 6465 7669 6365 2069 6e66 Probe device inf │ │ │ │ │ +00000430: 6f72 6d61 7469 6f6e 0a2a 2067 7275 622d ormation.* grub- │ │ │ │ │ +00000440: 7363 7269 7074 2d63 6865 636b 3a20 2867 script-check: (g │ │ │ │ │ +00000450: 7275 6229 496e 766f 6b69 6e67 2067 7275 rub)Invoking gru │ │ │ │ │ +00000460: 622d 7363 7269 7074 2d63 6865 636b 2e0a b-script-check.. │ │ │ │ │ +00000470: 454e 442d 494e 464f 2d44 4952 2d45 4e54 END-INFO-DIR-ENT │ │ │ │ │ +00000480: 5259 0a0a 1f0a 496e 6469 7265 6374 3a0a RY....Indirect:. │ │ │ │ │ +00000490: 6772 7562 2e69 6e66 6f2d 313a 2031 3135 grub.info-1: 115 │ │ │ │ │ +000004a0: 360a 6772 7562 2e69 6e66 6f2d 323a 2033 6.grub.info-2: 3 │ │ │ │ │ +000004b0: 3132 3433 350a 1f0a 5461 6720 5461 626c 12435...Tag Tabl │ │ │ │ │ +000004c0: 653a 0a28 496e 6469 7265 6374 290a 4e6f e:.(Indirect).No │ │ │ │ │ +000004d0: 6465 3a20 546f 707f 3131 3536 0a4e 6f64 de: Top.1156.Nod │ │ │ │ │ +000004e0: 653a 2049 6e74 726f 6475 6374 696f 6e7f e: Introduction. │ │ │ │ │ +000004f0: 3432 3037 0a4e 6f64 653a 204f 7665 7276 4207.Node: Overv │ │ │ │ │ +00000500: 6965 777f 3436 3531 0a4e 6f64 653a 204f iew.4651.Node: O │ │ │ │ │ +00000510: 7665 7276 6965 772d 466f 6f74 6e6f 7465 verview-Footnote │ │ │ │ │ +00000520: 737f 3636 3431 0a52 6566 3a20 4f76 6572 s.6641.Ref: Over │ │ │ │ │ +00000530: 7669 6577 2d46 6f6f 746e 6f74 652d 317f view-Footnote-1. │ │ │ │ │ +00000540: 3637 3032 0a4e 6f64 653a 2048 6973 746f 6702.Node: Histo │ │ │ │ │ +00000550: 7279 7f36 3836 340a 4e6f 6465 3a20 4368 ry.6864.Node: Ch │ │ │ │ │ +00000560: 616e 6765 7320 6672 6f6d 2047 5255 4220 anges from GRUB │ │ │ │ │ +00000570: 4c65 6761 6379 7f38 3935 340a 4e6f 6465 Legacy.8954.Node │ │ │ │ │ +00000580: 3a20 4665 6174 7572 6573 7f31 3134 3330 : Features.11430 │ │ │ │ │ +00000590: 0a4e 6f64 653a 2046 6561 7475 7265 732d .Node: Features- │ │ │ │ │ +000005a0: 466f 6f74 6e6f 7465 737f 3137 3835 370a Footnotes.17857. │ │ │ │ │ +000005b0: 5265 663a 2046 6561 7475 7265 732d 466f Ref: Features-Fo │ │ │ │ │ +000005c0: 6f74 6e6f 7465 2d31 7f31 3739 3138 0a52 otnote-1.17918.R │ │ │ │ │ +000005d0: 6566 3a20 4665 6174 7572 6573 2d46 6f6f ef: Features-Foo │ │ │ │ │ +000005e0: 746e 6f74 652d 327f 3138 3031 340a 5265 tnote-2.18014.Re │ │ │ │ │ +000005f0: 663a 2046 6561 7475 7265 732d 466f 6f74 f: Features-Foot │ │ │ │ │ +00000600: 6e6f 7465 2d33 7f31 3831 3631 0a4e 6f64 note-3.18161.Nod │ │ │ │ │ +00000610: 653a 2052 6f6c 6520 6f66 2061 2062 6f6f e: Role of a boo │ │ │ │ │ +00000620: 7420 6c6f 6164 6572 7f31 3833 3036 0a4e t loader.18306.N │ │ │ │ │ +00000630: 6f64 653a 2052 6f6c 6520 6f66 2061 2062 ode: Role of a b │ │ │ │ │ +00000640: 6f6f 7420 6c6f 6164 6572 2d46 6f6f 746e oot loader-Footn │ │ │ │ │ +00000650: 6f74 6573 7f31 3936 3435 0a52 6566 3a20 otes.19645.Ref: │ │ │ │ │ +00000660: 526f 6c65 206f 6620 6120 626f 6f74 206c Role of a boot l │ │ │ │ │ +00000670: 6f61 6465 722d 466f 6f74 6e6f 7465 2d31 oader-Footnote-1 │ │ │ │ │ +00000680: 7f31 3937 3332 0a4e 6f64 653a 204e 616d .19732.Node: Nam │ │ │ │ │ +00000690: 696e 6720 636f 6e76 656e 7469 6f6e 7f31 ing convention.1 │ │ │ │ │ +000006a0: 3938 3131 0a4e 6f64 653a 204f 532d 7370 9811.Node: OS-sp │ │ │ │ │ +000006b0: 6563 6966 6963 206e 6f74 6573 2061 626f ecific notes abo │ │ │ │ │ +000006c0: 7574 2067 7275 6220 746f 6f6c 737f 3232 ut grub tools.22 │ │ │ │ │ +000006d0: 3732 320a 4e6f 6465 3a20 496e 7374 616c 722.Node: Instal │ │ │ │ │ +000006e0: 6c61 7469 6f6e 7f32 3337 3538 0a4e 6f64 lation.23758.Nod │ │ │ │ │ +000006f0: 653a 2049 6e73 7461 6c6c 696e 6720 4752 e: Installing GR │ │ │ │ │ +00000700: 5542 2075 7369 6e67 2067 7275 622d 696e UB using grub-in │ │ │ │ │ +00000710: 7374 616c 6c7f 3234 3838 300a 4e6f 6465 stall.24880.Node │ │ │ │ │ +00000720: 3a20 4d61 6b69 6e67 2061 2047 5255 4220 : Making a GRUB │ │ │ │ │ +00000730: 626f 6f74 6162 6c65 2043 442d 524f 4d7f bootable CD-ROM. │ │ │ │ │ +00000740: 3237 3139 350a 4e6f 6465 3a20 4d61 6b69 27195.Node: Maki │ │ │ │ │ +00000750: 6e67 2061 2047 5255 4220 626f 6f74 6162 ng a GRUB bootab │ │ │ │ │ +00000760: 6c65 2043 442d 524f 4d2d 466f 6f74 6e6f le CD-ROM-Footno │ │ │ │ │ +00000770: 7465 737f 3239 3035 340a 5265 663a 204d tes.29054.Ref: M │ │ │ │ │ +00000780: 616b 696e 6720 6120 4752 5542 2062 6f6f aking a GRUB boo │ │ │ │ │ +00000790: 7461 626c 6520 4344 2d52 4f4d 2d46 6f6f table CD-ROM-Foo │ │ │ │ │ +000007a0: 746e 6f74 652d 317f 3239 3135 370a 4e6f tnote-1.29157.No │ │ │ │ │ +000007b0: 6465 3a20 4465 7669 6365 206d 6170 7f32 de: Device map.2 │ │ │ │ │ +000007c0: 3932 3332 0a4e 6f64 653a 2042 494f 5320 9232.Node: BIOS │ │ │ │ │ +000007d0: 696e 7374 616c 6c61 7469 6f6e 7f33 3131 installation.311 │ │ │ │ │ +000007e0: 3939 0a4e 6f64 653a 2042 6f6f 7469 6e67 99.Node: Booting │ │ │ │ │ +000007f0: 7f33 3536 3530 0a4e 6f64 653a 2047 656e .35650.Node: Gen │ │ │ │ │ +00000800: 6572 616c 2062 6f6f 7420 6d65 7468 6f64 eral boot method │ │ │ │ │ +00000810: 737f 3336 3138 350a 4e6f 6465 3a20 4c6f s.36185.Node: Lo │ │ │ │ │ +00000820: 6164 696e 6720 616e 206f 7065 7261 7469 ading an operati │ │ │ │ │ +00000830: 6e67 2073 7973 7465 6d20 6469 7265 6374 ng system direct │ │ │ │ │ +00000840: 6c79 7f33 3639 3238 0a4e 6f64 653a 2043 ly.36928.Node: C │ │ │ │ │ +00000850: 6861 696e 2d6c 6f61 6469 6e67 7f33 3736 hain-loading.376 │ │ │ │ │ +00000860: 3539 0a4e 6f64 653a 204c 6f6f 7062 6163 59.Node: Loopbac │ │ │ │ │ +00000870: 6b20 626f 6f74 696e 677f 3338 3633 300a k booting.38630. │ │ │ │ │ +00000880: 4e6f 6465 3a20 4c56 4d20 6361 6368 6520 Node: LVM cache │ │ │ │ │ +00000890: 626f 6f74 696e 677f 3430 3330 340a 4e6f booting.40304.No │ │ │ │ │ +000008a0: 6465 3a20 4f53 2d73 7065 6369 6669 6320 de: OS-specific │ │ │ │ │ +000008b0: 6e6f 7465 737f 3431 3537 300a 4e6f 6465 notes.41570.Node │ │ │ │ │ +000008c0: 3a20 474e 552f 4875 7264 7f34 3138 3630 : GNU/Hurd.41860 │ │ │ │ │ +000008d0: 0a4e 6f64 653a 2047 4e55 2f4c 696e 7578 .Node: GNU/Linux │ │ │ │ │ +000008e0: 7f34 3239 3833 0a4e 6f64 653a 204e 6574 .42983.Node: Net │ │ │ │ │ +000008f0: 4253 447f 3434 3330 310a 4e6f 6465 3a20 BSD.44301.Node: │ │ │ │ │ +00000900: 444f 532f 5769 6e64 6f77 737f 3435 3737 DOS/Windows.4577 │ │ │ │ │ +00000910: 350a 4e6f 6465 3a20 436f 6e66 6967 7572 5.Node: Configur │ │ │ │ │ +00000920: 6174 696f 6e7f 3437 3535 330a 4e6f 6465 ation.47553.Node │ │ │ │ │ +00000930: 3a20 5369 6d70 6c65 2063 6f6e 6669 6775 : Simple configu │ │ │ │ │ +00000940: 7261 7469 6f6e 7f34 3832 3635 0a4e 6f64 ration.48265.Nod │ │ │ │ │ +00000950: 653a 2052 6f6f 7420 4964 656e 7469 6663 e: Root Identifc │ │ │ │ │ +00000960: 6174 696f 6e20 4865 7572 6973 7469 6373 ation Heuristics │ │ │ │ │ +00000970: 7f36 3537 3135 0a4e 6f64 653a 2053 6865 .65715.Node: She │ │ │ │ │ +00000980: 6c6c 2d6c 696b 6520 7363 7269 7074 696e ll-like scriptin │ │ │ │ │ +00000990: 677f 3638 3732 390a 4e6f 6465 3a20 5368 g.68729.Node: Sh │ │ │ │ │ +000009a0: 656c 6c2d 6c69 6b65 2073 6372 6970 7469 ell-like scripti │ │ │ │ │ +000009b0: 6e67 2d46 6f6f 746e 6f74 6573 7f37 3637 ng-Footnotes.767 │ │ │ │ │ +000009c0: 3932 0a52 6566 3a20 5368 656c 6c2d 6c69 92.Ref: Shell-li │ │ │ │ │ +000009d0: 6b65 2073 6372 6970 7469 6e67 2d46 6f6f ke scripting-Foo │ │ │ │ │ +000009e0: 746e 6f74 652d 317f 3736 3837 370a 4e6f tnote-1.76877.No │ │ │ │ │ +000009f0: 6465 3a20 4d75 6c74 692d 626f 6f74 206d de: Multi-boot m │ │ │ │ │ +00000a00: 616e 7561 6c20 636f 6e66 6967 7f37 3730 anual config.770 │ │ │ │ │ +00000a10: 3034 0a4e 6f64 653a 2045 6d62 6564 6465 04.Node: Embedde │ │ │ │ │ +00000a20: 6420 636f 6e66 6967 7572 6174 696f 6e7f d configuration. │ │ │ │ │ +00000a30: 3830 3631 330a 4e6f 6465 3a20 5468 656d 80613.Node: Them │ │ │ │ │ +00000a40: 6520 6669 6c65 2066 6f72 6d61 747f 3833 e file format.83 │ │ │ │ │ +00000a50: 3434 390a 5265 663a 2050 6978 6d61 702d 449.Ref: Pixmap- │ │ │ │ │ +00000a60: 7374 796c 6564 2070 726f 6772 6573 7320 styled progress │ │ │ │ │ +00000a70: 6261 727f 3834 3930 380a 5265 663a 2050 bar.84908.Ref: P │ │ │ │ │ +00000a80: 6c61 696e 2070 726f 6772 6573 7320 6261 lain progress ba │ │ │ │ │ +00000a90: 722c 2064 7261 776e 2077 6974 6820 736f r, drawn with so │ │ │ │ │ +00000aa0: 6c69 6420 636f 6c6f 722e 7f38 3439 3230 lid color..84920 │ │ │ │ │ +00000ab0: 0a52 6566 3a20 416e 2065 7861 6d70 6c65 .Ref: An example │ │ │ │ │ +00000ac0: 206f 6620 7468 6520 736c 6963 6573 2028 of the slices ( │ │ │ │ │ +00000ad0: 696e 2072 6564 2920 7573 6564 2066 6f72 in red) used for │ │ │ │ │ +00000ae0: 2061 2074 6572 6d69 6e61 6c20 7769 6e64 a terminal wind │ │ │ │ │ +00000af0: 6f77 2e20 5468 6973 2064 7261 7769 6e67 ow. This drawing │ │ │ │ │ +00000b00: 2077 6173 2063 7265 6174 6564 2061 6e64 was created and │ │ │ │ │ +00000b10: 2073 6c69 6365 6420 696e 2049 6e6b 7363 sliced in Inksc │ │ │ │ │ +00000b20: 6170 655f 2c20 6173 2074 6865 206e 6578 ape_, as the nex │ │ │ │ │ +00000b30: 7420 7365 6374 696f 6e20 6578 706c 6169 t section explai │ │ │ │ │ +00000b40: 6e73 2e7f 3838 3431 320a 4e6f 6465 3a20 ns..88412.Node: │ │ │ │ │ +00000b50: 4e65 7477 6f72 6b7f 3130 3838 3234 0a4e Network.108824.N │ │ │ │ │ +00000b60: 6f64 653a 2053 6572 6961 6c20 7465 726d ode: Serial term │ │ │ │ │ +00000b70: 696e 616c 7f31 3133 3133 380a 4e6f 6465 inal.113138.Node │ │ │ │ │ +00000b80: 3a20 5665 6e64 6f72 2070 6f77 6572 2d6f : Vendor power-o │ │ │ │ │ +00000b90: 6e20 6b65 7973 7f31 3135 3337 350a 4e6f n keys.115375.No │ │ │ │ │ +00000ba0: 6465 3a20 496d 6167 6573 7f31 3137 3331 de: Images.11731 │ │ │ │ │ +00000bb0: 300a 4e6f 6465 3a20 436f 7265 2069 6d61 0.Node: Core ima │ │ │ │ │ +00000bc0: 6765 2073 697a 6520 6c69 6d69 7461 7469 ge size limitati │ │ │ │ │ +00000bd0: 6f6e 7f31 3232 3238 350a 4e6f 6465 3a20 on.122285.Node: │ │ │ │ │ +00000be0: 4669 6c65 7379 7374 656d 7f31 3234 3834 Filesystem.12484 │ │ │ │ │ +00000bf0: 390a 4e6f 6465 3a20 4465 7669 6365 2073 9.Node: Device s │ │ │ │ │ +00000c00: 796e 7461 787f 3132 3535 3538 0a4e 6f64 yntax.125558.Nod │ │ │ │ │ +00000c10: 653a 2046 696c 6520 6e61 6d65 2073 796e e: File name syn │ │ │ │ │ +00000c20: 7461 787f 3132 3832 3539 0a4e 6f64 653a tax.128259.Node: │ │ │ │ │ +00000c30: 2042 6c6f 636b 206c 6973 7420 7379 6e74 Block list synt │ │ │ │ │ +00000c40: 6178 7f31 3239 3330 350a 4e6f 6465 3a20 ax.129305.Node: │ │ │ │ │ +00000c50: 496e 7465 7266 6163 657f 3133 3030 3339 Interface.130039 │ │ │ │ │ +00000c60: 0a4e 6f64 653a 2043 6f6d 6d61 6e64 2d6c .Node: Command-l │ │ │ │ │ +00000c70: 696e 6520 696e 7465 7266 6163 657f 3133 ine interface.13 │ │ │ │ │ +00000c80: 3038 3633 0a4e 6f64 653a 2043 6f6d 6d61 0863.Node: Comma │ │ │ │ │ +00000c90: 6e64 2d6c 696e 6520 696e 7465 7266 6163 nd-line interfac │ │ │ │ │ +00000ca0: 652d 466f 6f74 6e6f 7465 737f 3133 3238 e-Footnotes.1328 │ │ │ │ │ +00000cb0: 3037 0a52 6566 3a20 436f 6d6d 616e 642d 07.Ref: Command- │ │ │ │ │ +00000cc0: 6c69 6e65 2069 6e74 6572 6661 6365 2d46 line interface-F │ │ │ │ │ +00000cd0: 6f6f 746e 6f74 652d 317f 3133 3238 3936 ootnote-1.132896 │ │ │ │ │ +00000ce0: 0a4e 6f64 653a 204d 656e 7520 696e 7465 .Node: Menu inte │ │ │ │ │ +00000cf0: 7266 6163 657f 3133 3239 3931 0a4e 6f64 rface.132991.Nod │ │ │ │ │ +00000d00: 653a 204d 656e 7520 656e 7472 7920 6564 e: Menu entry ed │ │ │ │ │ +00000d10: 6974 6f72 7f31 3334 3030 330a 4e6f 6465 itor.134003.Node │ │ │ │ │ +00000d20: 3a20 456e 7669 726f 6e6d 656e 747f 3133 : Environment.13 │ │ │ │ │ +00000d30: 3437 3431 0a4e 6f64 653a 2053 7065 6369 4741.Node: Speci │ │ │ │ │ +00000d40: 616c 2065 6e76 6972 6f6e 6d65 6e74 2076 al environment v │ │ │ │ │ +00000d50: 6172 6961 626c 6573 7f31 3335 3434 340a ariables.135444. │ │ │ │ │ +00000d60: 4e6f 6465 3a20 6269 6f73 6e75 6d7f 3133 Node: biosnum.13 │ │ │ │ │ +00000d70: 3634 3938 0a4e 6f64 653a 2063 6865 636b 6498.Node: check │ │ │ │ │ +00000d80: 5f73 6967 6e61 7475 7265 737f 3133 3730 _signatures.1370 │ │ │ │ │ +00000d90: 3232 0a4e 6f64 653a 2063 686f 7365 6e7f 22.Node: chosen. │ │ │ │ │ +00000da0: 3133 3733 3039 0a4e 6f64 653a 2063 6d64 137309.Node: cmd │ │ │ │ │ +00000db0: 7061 7468 7f31 3337 3735 320a 4e6f 6465 path.137752.Node │ │ │ │ │ +00000dc0: 3a20 636f 6c6f 725f 6869 6768 6c69 6768 : color_highligh │ │ │ │ │ +00000dd0: 747f 3133 3831 3739 0a4e 6f64 653a 2063 t.138179.Node: c │ │ │ │ │ +00000de0: 6f6c 6f72 5f6e 6f72 6d61 6c7f 3133 3835 olor_normal.1385 │ │ │ │ │ +00000df0: 3931 0a4e 6f64 653a 2063 6f6e 6669 675f 91.Node: config_ │ │ │ │ │ +00000e00: 6469 7265 6374 6f72 797f 3134 3032 3534 directory.140254 │ │ │ │ │ +00000e10: 0a4e 6f64 653a 2063 6f6e 6669 675f 6669 .Node: config_fi │ │ │ │ │ +00000e20: 6c65 7f31 3430 3534 380a 4e6f 6465 3a20 le.140548.Node: │ │ │ │ │ +00000e30: 6465 6275 677f 3134 3039 3431 0a4e 6f64 debug.140941.Nod │ │ │ │ │ +00000e40: 653a 2064 6566 6175 6c74 7f31 3431 3338 e: default.14138 │ │ │ │ │ +00000e50: 300a 4e6f 6465 3a20 6661 6c6c 6261 636b 0.Node: fallback │ │ │ │ │ +00000e60: 7f31 3432 3830 380a 4e6f 6465 3a20 6766 .142808.Node: gf │ │ │ │ │ +00000e70: 786d 6f64 657f 3134 3331 3431 0a4e 6f64 xmode.143141.Nod │ │ │ │ │ +00000e80: 653a 2067 6678 7061 796c 6f61 647f 3134 e: gfxpayload.14 │ │ │ │ │ +00000e90: 3339 3339 0a4e 6f64 653a 2067 6678 7465 3939.Node: gfxte │ │ │ │ │ +00000ea0: 726d 5f66 6f6e 747f 3134 3530 3933 0a4e rm_font.145093.N │ │ │ │ │ +00000eb0: 6f64 653a 2067 7275 625f 6370 757f 3134 ode: grub_cpu.14 │ │ │ │ │ +00000ec0: 3533 3933 0a4e 6f64 653a 2067 7275 625f 5393.Node: grub_ │ │ │ │ │ +00000ed0: 706c 6174 666f 726d 7f31 3435 3638 310a platform.145681. │ │ │ │ │ +00000ee0: 4e6f 6465 3a20 6963 6f6e 6469 727f 3134 Node: icondir.14 │ │ │ │ │ +00000ef0: 3539 3733 0a4e 6f64 653a 206c 616e 677f 5973.Node: lang. │ │ │ │ │ +00000f00: 3134 3632 3930 0a4e 6f64 653a 206c 6f63 146290.Node: loc │ │ │ │ │ +00000f10: 616c 655f 6469 727f 3134 3637 3539 0a4e ale_dir.146759.N │ │ │ │ │ +00000f20: 6f64 653a 206d 656e 755f 636f 6c6f 725f ode: menu_color_ │ │ │ │ │ +00000f30: 6869 6768 6c69 6768 747f 3134 3732 3638 highlight.147268 │ │ │ │ │ +00000f40: 0a4e 6f64 653a 206d 656e 755f 636f 6c6f .Node: menu_colo │ │ │ │ │ +00000f50: 725f 6e6f 726d 616c 7f31 3437 3736 340a r_normal.147764. │ │ │ │ │ +00000f60: 4e6f 6465 3a20 6e65 745f 3c49 4e54 4552 Node: net__boot_file. │ │ │ │ │ +00000f80: 3134 3832 3635 0a4e 6f64 653a 206e 6574 148265.Node: net │ │ │ │ │ +00000f90: 5f3c 494e 5445 5246 4143 453e 5f64 6863 __dhc │ │ │ │ │ +00000fa0: 705f 7365 7276 6572 5f6e 616d 657f 3134 p_server_name.14 │ │ │ │ │ +00000fb0: 3835 3038 0a4e 6f64 653a 206e 6574 5f3c 8508.Node: net_< │ │ │ │ │ +00000fc0: 494e 5445 5246 4143 453e 5f64 6f6d 6169 INTERFACE>_domai │ │ │ │ │ +00000fd0: 6e7f 3134 3837 3730 0a4e 6f64 653a 206e n.148770.Node: n │ │ │ │ │ +00000fe0: 6574 5f3c 494e 5445 5246 4143 453e 5f65 et__e │ │ │ │ │ +00000ff0: 7874 656e 7369 6f6e 7370 6174 687f 3134 xtensionspath.14 │ │ │ │ │ +00001000: 3930 3137 0a4e 6f64 653a 206e 6574 5f3c 9017.Node: net_< │ │ │ │ │ +00001010: 494e 5445 5246 4143 453e 5f68 6f73 746e INTERFACE>_hostn │ │ │ │ │ +00001020: 616d 657f 3134 3932 3732 0a4e 6f64 653a ame.149272.Node: │ │ │ │ │ +00001030: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ +00001040: 5f69 707f 3134 3935 3131 0a4e 6f64 653a _ip.149511.Node: │ │ │ │ │ +00001050: 206e 6574 5f3c 494e 5445 5246 4143 453e net_ │ │ │ │ │ +00001060: 5f6d 6163 7f31 3439 3732 370a 4e6f 6465 _mac.149727.Node │ │ │ │ │ +00001070: 3a20 6e65 745f 3c49 4e54 4552 4641 4345 : net__next_server.14 │ │ │ │ │ +00001090: 3939 3438 0a4e 6f64 653a 206e 6574 5f3c 9948.Node: net_< │ │ │ │ │ +000010a0: 494e 5445 5246 4143 453e 5f72 6f6f 7470 INTERFACE>_rootp │ │ │ │ │ +000010b0: 6174 687f 3135 3031 3931 0a4e 6f64 653a ath.150191.Node: │ │ │ │ │ +000010c0: 206e 6574 5f64 6566 6175 6c74 5f69 6e74 net_default_int │ │ │ │ │ +000010d0: 6572 6661 6365 7f31 3530 3433 300a 4e6f erface.150430.No │ │ │ │ │ +000010e0: 6465 3a20 6e65 745f 6465 6661 756c 745f de: net_default_ │ │ │ │ │ +000010f0: 6970 7f31 3530 3635 300a 4e6f 6465 3a20 ip.150650.Node: │ │ │ │ │ +00001100: 6e65 745f 6465 6661 756c 745f 6d61 637f net_default_mac. │ │ │ │ │ +00001110: 3135 3038 3437 0a4e 6f64 653a 206e 6574 150847.Node: net │ │ │ │ │ +00001120: 5f64 6566 6175 6c74 5f73 6572 7665 727f _default_server. │ │ │ │ │ +00001130: 3135 3130 3433 0a4e 6f64 653a 2070 6167 151043.Node: pag │ │ │ │ │ +00001140: 6572 7f31 3531 3233 360a 4e6f 6465 3a20 er.151236.Node: │ │ │ │ │ +00001150: 7072 6566 6978 7f31 3531 3439 320a 4e6f prefix.151492.No │ │ │ │ │ +00001160: 6465 3a20 7078 655f 626c 6b73 697a 657f de: pxe_blksize. │ │ │ │ │ +00001170: 3135 3139 3431 0a4e 6f64 653a 2070 7865 151941.Node: pxe │ │ │ │ │ +00001180: 5f64 6566 6175 6c74 5f67 6174 6577 6179 _default_gateway │ │ │ │ │ +00001190: 7f31 3532 3131 380a 4e6f 6465 3a20 7078 .152118.Node: px │ │ │ │ │ +000011a0: 655f 6465 6661 756c 745f 7365 7276 6572 e_default_server │ │ │ │ │ +000011b0: 7f31 3532 3332 330a 4e6f 6465 3a20 726f .152323.Node: ro │ │ │ │ │ +000011c0: 6f74 7f31 3532 3531 390a 4e6f 6465 3a20 ot.152519.Node: │ │ │ │ │ +000011d0: 7375 7065 7275 7365 7273 7f31 3533 3036 superusers.15306 │ │ │ │ │ +000011e0: 300a 4e6f 6465 3a20 7468 656d 657f 3135 0.Node: theme.15 │ │ │ │ │ +000011f0: 3333 3038 0a4e 6f64 653a 2074 696d 656f 3308.Node: timeo │ │ │ │ │ +00001200: 7574 7f31 3533 3632 390a 4e6f 6465 3a20 ut.153629.Node: │ │ │ │ │ +00001210: 7469 6d65 6f75 745f 7374 796c 657f 3135 timeout_style.15 │ │ │ │ │ +00001220: 3432 3636 0a4e 6f64 653a 2045 6e76 6972 4266.Node: Envir │ │ │ │ │ +00001230: 6f6e 6d65 6e74 2062 6c6f 636b 7f31 3534 onment block.154 │ │ │ │ │ +00001240: 3635 310a 4e6f 6465 3a20 436f 6d6d 616e 651.Node: Comman │ │ │ │ │ +00001250: 6473 7f31 3536 3038 330a 4e6f 6465 3a20 ds.156083.Node: │ │ │ │ │ +00001260: 4d65 6e75 2d73 7065 6369 6669 6320 636f Menu-specific co │ │ │ │ │ +00001270: 6d6d 616e 6473 7f31 3536 3935 330a 4e6f mmands.156953.No │ │ │ │ │ +00001280: 6465 3a20 6d65 6e75 656e 7472 797f 3135 de: menuentry.15 │ │ │ │ │ +00001290: 3736 3831 0a4e 6f64 653a 2073 7562 6d65 7681.Node: subme │ │ │ │ │ +000012a0: 6e75 7f31 3539 3232 320a 4e6f 6465 3a20 nu.159222.Node: │ │ │ │ │ +000012b0: 4765 6e65 7261 6c20 636f 6d6d 616e 6473 General commands │ │ │ │ │ +000012c0: 7f31 3539 3735 310a 4e6f 6465 3a20 7365 .159751.Node: se │ │ │ │ │ +000012d0: 7269 616c 7f31 3630 3234 370a 4e6f 6465 rial.160247.Node │ │ │ │ │ +000012e0: 3a20 7465 726d 696e 616c 5f69 6e70 7574 : terminal_input │ │ │ │ │ +000012f0: 7f31 3631 3238 360a 4e6f 6465 3a20 7465 .161286.Node: te │ │ │ │ │ +00001300: 726d 696e 616c 5f6f 7574 7075 747f 3136 rminal_output.16 │ │ │ │ │ +00001310: 3139 3438 0a4e 6f64 653a 2074 6572 6d69 1948.Node: termi │ │ │ │ │ +00001320: 6e66 6f7f 3136 3236 3131 0a4e 6f64 653a nfo.162611.Node: │ │ │ │ │ +00001330: 2043 6f6d 6d61 6e64 2d6c 696e 6520 616e Command-line an │ │ │ │ │ +00001340: 6420 6d65 6e75 2065 6e74 7279 2063 6f6d d menu entry com │ │ │ │ │ +00001350: 6d61 6e64 737f 3136 3338 3334 0a4e 6f64 mands.163834.Nod │ │ │ │ │ +00001360: 653a 205b 7f31 3639 3135 360a 4e6f 6465 e: [.169156.Node │ │ │ │ │ +00001370: 3a20 6163 7069 7f31 3639 3333 380a 4e6f : acpi.169338.No │ │ │ │ │ +00001380: 6465 3a20 6175 7468 656e 7469 6361 7465 de: authenticate │ │ │ │ │ +00001390: 7f31 3730 3632 310a 4e6f 6465 3a20 6261 .170621.Node: ba │ │ │ │ │ +000013a0: 636b 6772 6f75 6e64 5f63 6f6c 6f72 7f31 ckground_color.1 │ │ │ │ │ +000013b0: 3731 3034 380a 4e6f 6465 3a20 6261 636b 71048.Node: back │ │ │ │ │ +000013c0: 6772 6f75 6e64 5f69 6d61 6765 7f31 3731 ground_image.171 │ │ │ │ │ +000013d0: 3732 310a 4e6f 6465 3a20 6261 6472 616d 721.Node: badram │ │ │ │ │ +000013e0: 7f31 3732 3236 350a 4e6f 6465 3a20 626c .172265.Node: bl │ │ │ │ │ +000013f0: 6f63 6b6c 6973 747f 3137 3336 3530 0a4e ocklist.173650.N │ │ │ │ │ +00001400: 6f64 653a 2062 6f6f 747f 3137 3338 3834 ode: boot.173884 │ │ │ │ │ +00001410: 0a4e 6f64 653a 2063 6174 7f31 3734 3230 .Node: cat.17420 │ │ │ │ │ +00001420: 360a 4e6f 6465 3a20 6368 6169 6e6c 6f61 6.Node: chainloa │ │ │ │ │ +00001430: 6465 727f 3137 3438 3430 0a4e 6f64 653a der.174840.Node: │ │ │ │ │ +00001440: 2063 6c65 6172 7f31 3735 3436 360a 4e6f clear.175466.No │ │ │ │ │ +00001450: 6465 3a20 636d 6f73 636c 6561 6e7f 3137 de: cmosclean.17 │ │ │ │ │ +00001460: 3536 3532 0a4e 6f64 653a 2063 6d6f 7364 5652.Node: cmosd │ │ │ │ │ +00001470: 756d 707f 3137 3539 3536 0a4e 6f64 653a ump.175956.Node: │ │ │ │ │ +00001480: 2063 6d6f 7374 6573 747f 3137 3632 3531 cmostest.176251 │ │ │ │ │ +00001490: 0a4e 6f64 653a 2063 6d70 7f31 3736 3630 .Node: cmp.17660 │ │ │ │ │ +000014a0: 390a 4e6f 6465 3a20 636f 6e66 6967 6669 9.Node: configfi │ │ │ │ │ +000014b0: 6c65 7f31 3737 3136 300a 4e6f 6465 3a20 le.177160.Node: │ │ │ │ │ +000014c0: 6370 7569 647f 3137 3735 3835 0a4e 6f64 cpuid.177585.Nod │ │ │ │ │ +000014d0: 653a 2063 7263 7f31 3738 3135 360a 4e6f e: crc.178156.No │ │ │ │ │ +000014e0: 6465 3a20 6372 7970 746f 6d6f 756e 747f de: cryptomount. │ │ │ │ │ +000014f0: 3137 3834 3330 0a4e 6f64 653a 2063 7574 178430.Node: cut │ │ │ │ │ +00001500: 6d65 6d7f 3137 3934 3138 0a4e 6f64 653a mem.179418.Node: │ │ │ │ │ +00001510: 2064 6174 657f 3138 3032 3937 0a4e 6f64 date.180297.Nod │ │ │ │ │ +00001520: 653a 2064 6576 6963 6574 7265 657f 3138 e: devicetree.18 │ │ │ │ │ +00001530: 3038 3431 0a4e 6f64 653a 2064 6973 7472 0841.Node: distr │ │ │ │ │ +00001540: 7573 747f 3138 3133 3833 0a4e 6f64 653a ust.181383.Node: │ │ │ │ │ +00001550: 2064 7269 7665 6d61 707f 3138 3231 3634 drivemap.182164 │ │ │ │ │ +00001560: 0a4e 6f64 653a 2065 6368 6f7f 3138 3239 .Node: echo.1829 │ │ │ │ │ +00001570: 3635 0a4e 6f64 653a 2065 7661 6c7f 3138 65.Node: eval.18 │ │ │ │ │ +00001580: 3339 3034 0a4e 6f64 653a 2065 7870 6f72 3904.Node: expor │ │ │ │ │ +00001590: 747f 3138 3431 3837 0a4e 6f64 653a 2066 t.184187.Node: f │ │ │ │ │ +000015a0: 616c 7365 7f31 3834 3439 380a 4e6f 6465 alse.184498.Node │ │ │ │ │ +000015b0: 3a20 6765 7474 6578 747f 3138 3437 3934 : gettext.184794 │ │ │ │ │ +000015c0: 0a4e 6f64 653a 2067 7074 7379 6e63 7f31 .Node: gptsync.1 │ │ │ │ │ +000015d0: 3835 3234 310a 4e6f 6465 3a20 6861 6c74 85241.Node: halt │ │ │ │ │ +000015e0: 7f31 3836 3138 360a 4e6f 6465 3a20 6861 .186186.Node: ha │ │ │ │ │ +000015f0: 7368 7375 6d7f 3138 3635 3135 0a4e 6f64 shsum.186515.Nod │ │ │ │ │ +00001600: 653a 2068 656c 707f 3138 3737 3331 0a4e e: help.187731.N │ │ │ │ │ +00001610: 6f64 653a 2069 6e69 7472 647f 3138 3831 ode: initrd.1881 │ │ │ │ │ +00001620: 3938 0a4e 6f64 653a 2069 6e69 7472 6431 98.Node: initrd1 │ │ │ │ │ +00001630: 367f 3138 3836 3333 0a4e 6f64 653a 2069 6.188633.Node: i │ │ │ │ │ +00001640: 6e73 6d6f 647f 3138 3931 3637 0a4e 6f64 nsmod.189167.Nod │ │ │ │ │ +00001650: 653a 206b 6579 7374 6174 7573 7f31 3839 e: keystatus.189 │ │ │ │ │ +00001660: 3338 390a 4e6f 6465 3a20 6c69 6e75 787f 389.Node: linux. │ │ │ │ │ +00001670: 3139 3030 3232 0a4e 6f64 653a 206c 696e 190022.Node: lin │ │ │ │ │ +00001680: 7578 3136 7f31 3930 3932 350a 4e6f 6465 ux16.190925.Node │ │ │ │ │ +00001690: 3a20 6c69 7374 5f65 6e76 7f31 3931 3633 : list_env.19163 │ │ │ │ │ +000016a0: 390a 4e6f 6465 3a20 6c69 7374 5f74 7275 9.Node: list_tru │ │ │ │ │ +000016b0: 7374 6564 7f31 3932 3030 330a 4e6f 6465 sted.192003.Node │ │ │ │ │ +000016c0: 3a20 6c6f 6164 5f65 6e76 7f31 3932 3538 : load_env.19258 │ │ │ │ │ +000016d0: 360a 4e6f 6465 3a20 6c6f 6164 666f 6e74 6.Node: loadfont │ │ │ │ │ +000016e0: 7f31 3934 3235 350a 4e6f 6465 3a20 6c6f .194255.Node: lo │ │ │ │ │ +000016f0: 6f70 6261 636b 7f31 3934 3632 360a 4e6f opback.194626.No │ │ │ │ │ +00001700: 6465 3a20 6c73 7f31 3935 3037 320a 4e6f de: ls.195072.No │ │ │ │ │ +00001710: 6465 3a20 6c73 666f 6e74 737f 3139 3536 de: lsfonts.1956 │ │ │ │ │ +00001720: 3134 0a4e 6f64 653a 206c 736d 6f64 7f31 14.Node: lsmod.1 │ │ │ │ │ +00001730: 3935 3739 360a 4e6f 6465 3a20 6d64 3573 95796.Node: md5s │ │ │ │ │ +00001740: 756d 7f31 3935 3938 360a 4e6f 6465 3a20 um.195986.Node: │ │ │ │ │ +00001750: 6d6f 6475 6c65 7f31 3936 3236 350a 4e6f module.196265.No │ │ │ │ │ +00001760: 6465 3a20 6d75 6c74 6962 6f6f 747f 3139 de: multiboot.19 │ │ │ │ │ +00001770: 3635 3737 0a4e 6f64 653a 206e 6174 6976 6577.Node: nativ │ │ │ │ │ +00001780: 6564 6973 6b7f 3139 3736 3836 0a4e 6f64 edisk.197686.Nod │ │ │ │ │ +00001790: 653a 206e 6f72 6d61 6c7f 3139 3830 3835 e: normal.198085 │ │ │ │ │ +000017a0: 0a4e 6f64 653a 206e 6f72 6d61 6c5f 6578 .Node: normal_ex │ │ │ │ │ +000017b0: 6974 7f31 3938 3835 320a 4e6f 6465 3a20 it.198852.Node: │ │ │ │ │ +000017c0: 7061 7274 746f 6f6c 7f31 3939 3137 340a parttool.199174. │ │ │ │ │ +000017d0: 4e6f 6465 3a20 7061 7373 776f 7264 7f32 Node: password.2 │ │ │ │ │ +000017e0: 3030 3638 300a 4e6f 6465 3a20 7061 7373 00680.Node: pass │ │ │ │ │ +000017f0: 776f 7264 5f70 626b 6466 327f 3230 3039 word_pbkdf2.2009 │ │ │ │ │ +00001800: 3632 0a4e 6f64 653a 2070 6c61 797f 3230 62.Node: play.20 │ │ │ │ │ +00001810: 3133 3730 0a4e 6f64 653a 2070 726f 6265 1370.Node: probe │ │ │ │ │ +00001820: 7f32 3032 3131 380a 4e6f 6465 3a20 7264 .202118.Node: rd │ │ │ │ │ +00001830: 6d73 727f 3230 3235 3936 0a4e 6f64 653a msr.202596.Node: │ │ │ │ │ +00001840: 2072 6561 647f 3230 3333 3739 0a4e 6f64 read.203379.Nod │ │ │ │ │ +00001850: 653a 2072 6562 6f6f 747f 3230 3337 3233 e: reboot.203723 │ │ │ │ │ +00001860: 0a4e 6f64 653a 2072 6567 6578 707f 3230 .Node: regexp.20 │ │ │ │ │ +00001870: 3339 3036 0a4e 6f64 653a 2072 6d6d 6f64 3906.Node: rmmod │ │ │ │ │ +00001880: 7f32 3034 3434 310a 4e6f 6465 3a20 7361 .204441.Node: sa │ │ │ │ │ +00001890: 7665 5f65 6e76 7f32 3034 3633 340a 4e6f ve_env.204634.No │ │ │ │ │ +000018a0: 6465 3a20 7365 6172 6368 7f32 3035 3635 de: search.20565 │ │ │ │ │ +000018b0: 340a 4e6f 6465 3a20 7365 6e64 6b65 797f 4.Node: sendkey. │ │ │ │ │ +000018c0: 3230 3634 3232 0a4e 6f64 653a 2073 6574 206422.Node: set │ │ │ │ │ +000018d0: 7f32 3132 3831 300a 4e6f 6465 3a20 7368 .212810.Node: sh │ │ │ │ │ +000018e0: 6131 7375 6d7f 3231 3331 3132 0a4e 6f64 a1sum.213112.Nod │ │ │ │ │ +000018f0: 653a 2073 6861 3235 3673 756d 7f32 3133 e: sha256sum.213 │ │ │ │ │ +00001900: 3339 370a 4e6f 6465 3a20 7368 6135 3132 397.Node: sha512 │ │ │ │ │ +00001910: 7375 6d7f 3231 3336 3936 0a4e 6f64 653a sum.213696.Node: │ │ │ │ │ +00001920: 2073 6c65 6570 7f32 3133 3939 330a 4e6f sleep.213993.No │ │ │ │ │ +00001930: 6465 3a20 736d 6269 6f73 7f32 3134 3531 de: smbios.21451 │ │ │ │ │ +00001940: 330a 4e6f 6465 3a20 736f 7572 6365 7f32 3.Node: source.2 │ │ │ │ │ +00001950: 3137 3532 360a 4e6f 6465 3a20 7465 7374 17526.Node: test │ │ │ │ │ +00001960: 7f32 3138 3037 390a 4e6f 6465 3a20 7472 .218079.Node: tr │ │ │ │ │ +00001970: 7565 7f32 3230 3834 380a 4e6f 6465 3a20 ue.220848.Node: │ │ │ │ │ +00001980: 7472 7573 747f 3232 3131 3334 0a4e 6f64 trust.221134.Nod │ │ │ │ │ +00001990: 653a 2075 6e73 6574 7f32 3231 3932 340a e: unset.221924. │ │ │ │ │ +000019a0: 4e6f 6465 3a20 7665 7269 6679 5f64 6574 Node: verify_det │ │ │ │ │ +000019b0: 6163 6865 647f 3232 3231 3338 0a4e 6f64 ached.222138.Nod │ │ │ │ │ +000019c0: 653a 2076 6964 656f 696e 666f 7f32 3233 e: videoinfo.223 │ │ │ │ │ +000019d0: 3138 310a 4e6f 6465 3a20 7772 6d73 727f 181.Node: wrmsr. │ │ │ │ │ +000019e0: 3232 3334 3539 0a4e 6f64 653a 2078 656e 223459.Node: xen │ │ │ │ │ +000019f0: 5f68 7970 6572 7669 736f 727f 3232 3432 _hypervisor.2242 │ │ │ │ │ +00001a00: 3733 0a4e 6f64 653a 2078 656e 5f6d 6f64 73.Node: xen_mod │ │ │ │ │ +00001a10: 756c 657f 3232 3437 3334 0a4e 6f64 653a ule.224734.Node: │ │ │ │ │ +00001a20: 204e 6574 776f 726b 696e 6720 636f 6d6d Networking comm │ │ │ │ │ +00001a30: 616e 6473 7f32 3235 3235 380a 4e6f 6465 ands.225258.Node │ │ │ │ │ +00001a40: 3a20 6e65 745f 6164 645f 6164 6472 7f32 : net_add_addr.2 │ │ │ │ │ +00001a50: 3236 3238 300a 4e6f 6465 3a20 6e65 745f 26280.Node: net_ │ │ │ │ │ +00001a60: 6164 645f 646e 737f 3232 3638 3030 0a4e add_dns.226800.N │ │ │ │ │ +00001a70: 6f64 653a 206e 6574 5f61 6464 5f72 6f75 ode: net_add_rou │ │ │ │ │ +00001a80: 7465 7f32 3237 3037 360a 4e6f 6465 3a20 te.227076.Node: │ │ │ │ │ +00001a90: 6e65 745f 626f 6f74 707f 3232 3736 3034 net_bootp.227604 │ │ │ │ │ +00001aa0: 0a4e 6f64 653a 206e 6574 5f64 656c 5f61 .Node: net_del_a │ │ │ │ │ +00001ab0: 6464 727f 3232 3739 3639 0a4e 6f64 653a ddr.227969.Node: │ │ │ │ │ +00001ac0: 206e 6574 5f64 656c 5f64 6e73 7f32 3238 net_del_dns.228 │ │ │ │ │ +00001ad0: 3230 390a 4e6f 6465 3a20 6e65 745f 6465 209.Node: net_de │ │ │ │ │ +00001ae0: 6c5f 726f 7574 657f 3232 3834 3536 0a4e l_route.228456.N │ │ │ │ │ +00001af0: 6f64 653a 206e 6574 5f64 6863 707f 3232 ode: net_dhcp.22 │ │ │ │ │ +00001b00: 3836 3930 0a4e 6f64 653a 206e 6574 5f67 8690.Node: net_g │ │ │ │ │ +00001b10: 6574 5f64 6863 705f 6f70 7469 6f6e 7f32 et_dhcp_option.2 │ │ │ │ │ +00001b20: 3330 3636 390a 4e6f 6465 3a20 6e65 745f 30669.Node: net_ │ │ │ │ │ +00001b30: 6970 7636 5f61 7574 6f63 6f6e 667f 3233 ipv6_autoconf.23 │ │ │ │ │ +00001b40: 3131 3530 0a4e 6f64 653a 206e 6574 5f6c 1150.Node: net_l │ │ │ │ │ +00001b50: 735f 6164 6472 7f32 3331 3537 310a 4e6f s_addr.231571.No │ │ │ │ │ +00001b60: 6465 3a20 6e65 745f 6c73 5f63 6172 6473 de: net_ls_cards │ │ │ │ │ +00001b70: 7f32 3331 3831 390a 4e6f 6465 3a20 6e65 .231819.Node: ne │ │ │ │ │ +00001b80: 745f 6c73 5f64 6e73 7f32 3332 3035 350a t_ls_dns.232055. │ │ │ │ │ +00001b90: 4e6f 6465 3a20 6e65 745f 6c73 5f72 6f75 Node: net_ls_rou │ │ │ │ │ +00001ba0: 7465 737f 3233 3232 3836 0a4e 6f64 653a tes.232286.Node: │ │ │ │ │ +00001bb0: 206e 6574 5f6e 736c 6f6f 6b75 707f 3233 net_nslookup.23 │ │ │ │ │ +00001bc0: 3234 3933 0a4e 6f64 653a 2049 6e74 6572 2493.Node: Inter │ │ │ │ │ +00001bd0: 6e61 7469 6f6e 616c 6973 6174 696f 6e7f nationalisation. │ │ │ │ │ +00001be0: 3233 3237 3737 0a4e 6f64 653a 2053 6563 232777.Node: Sec │ │ │ │ │ +00001bf0: 7572 6974 797f 3233 3936 3039 0a4e 6f64 urity.239609.Nod │ │ │ │ │ +00001c00: 653a 2041 7574 6865 6e74 6963 6174 696f e: Authenticatio │ │ │ │ │ +00001c10: 6e20 616e 6420 6175 7468 6f72 6973 6174 n and authorisat │ │ │ │ │ +00001c20: 696f 6e7f 3234 3031 3835 0a4e 6f64 653a ion.240185.Node: │ │ │ │ │ +00001c30: 2055 7369 6e67 2064 6967 6974 616c 2073 Using digital s │ │ │ │ │ +00001c40: 6967 6e61 7475 7265 737f 3234 3333 3031 ignatures.243301 │ │ │ │ │ +00001c50: 0a4e 6f64 653a 2055 4546 4920 7365 6375 .Node: UEFI secu │ │ │ │ │ +00001c60: 7265 2062 6f6f 7420 616e 6420 7368 696d re boot and shim │ │ │ │ │ +00001c70: 7f32 3436 3537 310a 4e6f 6465 3a20 5365 .246571.Node: Se │ │ │ │ │ +00001c80: 6375 7265 2042 6f6f 7420 4164 7661 6e63 cure Boot Advanc │ │ │ │ │ +00001c90: 6564 2054 6172 6765 7469 6e67 7f32 3437 ed Targeting.247 │ │ │ │ │ +00001ca0: 3731 380a 4e6f 6465 3a20 4d65 6173 7572 718.Node: Measur │ │ │ │ │ +00001cb0: 6564 2042 6f6f 747f 3234 3837 3439 0a4e ed Boot.248749.N │ │ │ │ │ +00001cc0: 6f64 653a 204c 6f63 6b64 6f77 6e7f 3235 ode: Lockdown.25 │ │ │ │ │ +00001cd0: 3037 3134 0a4e 6f64 653a 2050 6c61 7466 0714.Node: Platf │ │ │ │ │ +00001ce0: 6f72 6d20 6c69 6d69 7461 7469 6f6e 737f orm limitations. │ │ │ │ │ +00001cf0: 3235 3132 3037 0a4e 6f64 653a 2050 6c61 251207.Node: Pla │ │ │ │ │ +00001d00: 7466 6f72 6d2d 7370 6563 6966 6963 206f tform-specific o │ │ │ │ │ +00001d10: 7065 7261 7469 6f6e 737f 3235 3932 3136 perations.259216 │ │ │ │ │ +00001d20: 0a4e 6f64 653a 2053 7570 706f 7274 6564 .Node: Supported │ │ │ │ │ +00001d30: 206b 6572 6e65 6c73 7f32 3630 3238 310a kernels.260281. │ │ │ │ │ +00001d40: 4e6f 6465 3a20 5472 6f75 626c 6573 686f Node: Troublesho │ │ │ │ │ +00001d50: 6f74 696e 677f 3236 3739 3138 0a4e 6f64 oting.267918.Nod │ │ │ │ │ +00001d60: 653a 2047 5255 4220 6f6e 6c79 206f 6666 e: GRUB only off │ │ │ │ │ +00001d70: 6572 7320 6120 7265 7363 7565 2073 6865 ers a rescue she │ │ │ │ │ +00001d80: 6c6c 7f32 3638 3138 380a 4e6f 6465 3a20 ll.268188.Node: │ │ │ │ │ +00001d90: 4669 726d 7761 7265 2073 7461 6c6c 7320 Firmware stalls │ │ │ │ │ +00001da0: 696e 7374 6561 6420 6f66 2062 6f6f 7469 instead of booti │ │ │ │ │ +00001db0: 6e67 2047 5255 427f 3237 3131 3937 0a4e ng GRUB.271197.N │ │ │ │ │ +00001dc0: 6f64 653a 2049 6e76 6f6b 696e 6720 6772 ode: Invoking gr │ │ │ │ │ +00001dd0: 7562 2d69 6e73 7461 6c6c 7f32 3731 3832 ub-install.27182 │ │ │ │ │ +00001de0: 380a 4e6f 6465 3a20 496e 766f 6b69 6e67 8.Node: Invoking │ │ │ │ │ +00001df0: 2067 7275 622d 6d6b 636f 6e66 6967 7f32 grub-mkconfig.2 │ │ │ │ │ +00001e00: 3733 3939 380a 4e6f 6465 3a20 496e 766f 73998.Node: Invo │ │ │ │ │ +00001e10: 6b69 6e67 2067 7275 622d 6d6b 7061 7373 king grub-mkpass │ │ │ │ │ +00001e20: 7764 2d70 626b 6466 327f 3237 3436 3335 wd-pbkdf2.274635 │ │ │ │ │ +00001e30: 0a4e 6f64 653a 2049 6e76 6f6b 696e 6720 .Node: Invoking │ │ │ │ │ +00001e40: 6772 7562 2d6d 6b72 656c 7061 7468 7f32 grub-mkrelpath.2 │ │ │ │ │ +00001e50: 3735 3239 340a 4e6f 6465 3a20 496e 766f 75294.Node: Invo │ │ │ │ │ +00001e60: 6b69 6e67 2067 7275 622d 6d6b 7265 7363 king grub-mkresc │ │ │ │ │ +00001e70: 7565 7f32 3736 3036 370a 4e6f 6465 3a20 ue.276067.Node: │ │ │ │ │ +00001e80: 496e 766f 6b69 6e67 2067 7275 622d 6d6f Invoking grub-mo │ │ │ │ │ +00001e90: 756e 747f 3237 3738 3136 0a4e 6f64 653a unt.277816.Node: │ │ │ │ │ +00001ea0: 2049 6e76 6f6b 696e 6720 6772 7562 2d70 Invoking grub-p │ │ │ │ │ +00001eb0: 726f 6265 7f32 3830 3836 350a 4e6f 6465 robe.280865.Node │ │ │ │ │ +00001ec0: 3a20 496e 766f 6b69 6e67 2067 7275 622d : Invoking grub- │ │ │ │ │ +00001ed0: 7363 7269 7074 2d63 6865 636b 7f32 3833 script-check.283 │ │ │ │ │ +00001ee0: 3435 390a 4e6f 6465 3a20 4f62 7461 696e 459.Node: Obtain │ │ │ │ │ +00001ef0: 696e 6720 616e 6420 4275 696c 6469 6e67 ing and Building │ │ │ │ │ +00001f00: 2047 5255 427f 3238 3432 3033 0a4e 6f64 GRUB.284203.Nod │ │ │ │ │ +00001f10: 653a 2052 6570 6f72 7469 6e67 2062 7567 e: Reporting bug │ │ │ │ │ +00001f20: 737f 3238 3534 3436 0a4e 6f64 653a 2046 s.285446.Node: F │ │ │ │ │ +00001f30: 7574 7572 657f 3238 3832 3632 0a4e 6f64 uture.288262.Nod │ │ │ │ │ +00001f40: 653a 2043 6f70 7969 6e67 2054 6869 7320 e: Copying This │ │ │ │ │ +00001f50: 4d61 6e75 616c 7f32 3838 3636 320a 4e6f Manual.288662.No │ │ │ │ │ +00001f60: 6465 3a20 474e 5520 4672 6565 2044 6f63 de: GNU Free Doc │ │ │ │ │ +00001f70: 756d 656e 7461 7469 6f6e 204c 6963 656e umentation Licen │ │ │ │ │ +00001f80: 7365 7f32 3838 3839 300a 4e6f 6465 3a20 se.288890.Node: │ │ │ │ │ +00001f90: 496e 6465 787f 3331 3234 3335 0a1f 0a45 Index.312435...E │ │ │ │ │ +00001fa0: 6e64 2054 6167 2054 6162 6c65 0a0a 1f0a nd Tag Table.... │ │ │ │ │ +00001fb0: 4c6f 6361 6c20 5661 7269 6162 6c65 733a Local Variables: │ │ │ │ │ +00001fc0: 0a63 6f64 696e 673a 2075 7466 2d38 0a45 .coding: utf-8.E │ │ │ │ │ +00001fd0: 6e64 3a0a nd:.